"""LangSmith integration for Harbor DeepAgents."""
import hashlib import uuid
def create_example_id_from_instruction(instruction: str, seed: int = 42) -> str: """Create a deterministic UUID from an instruction string.
Normalizes the instruction by stripping whitespace and creating a
SHA-256 hash, then converting to a UUID for LangSmith compatibility.
Args:
instruction: The task instruction string to hash
seed: Integer seed to avoid collisions with existing examples
Returns:
A UUID string generated from the hash of the normalized instruction
"""
# Normalize the instruction: strip leading/trailing whitespace
normalized = instruction.strip()
# Prepend seed as bytes to the instruction for hashing
seeded_data = seed.to_bytes(8, byteorder="big") + normalized.encode("utf-8")
# Create SHA-256 hash of the seeded instruction
hash_bytes = hashlib.sha256(seeded_data).digest()
# Use first 16 bytes to create a UUID
example_uuid = uuid.UUID(bytes=hash_bytes[:16])
return str(example_uuid)