Module ids 

Public ids namespace. Use it for the documented ids API surface; prefer crate-root re-exports for common imports. Module items must preserve the core ownership and side-effect boundaries described in this file. Domain primitives for stable SDK vocabulary. Use these items for IDs, refs, policy, privacy, trust, and errors that cross crate or host boundaries. They are data-only and must not perform provider, filesystem, network, or UI side effects. This file contains the ids portion of that contract.

Structs

AgentId

Typed SDK identifier for AgentId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

AgentPoolId

Typed SDK identifier for AgentPoolId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ApprovalRequestId

Typed SDK identifier for ApprovalRequestId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ArchiveCursorId

Typed SDK identifier for ArchiveCursorId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ArtifactId

Typed SDK identifier for ArtifactId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ArtifactRef

Typed SDK identifier for ArtifactRef. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

AttemptId

Typed SDK identifier for AttemptId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ContentId

Typed SDK identifier for ContentId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ContentRef

Typed SDK identifier for ContentRef. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ContextItemId

Typed SDK identifier for ContextItemId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ContextProjectionId

Typed SDK identifier for ContextProjectionId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

CorrelationEntry

Defines the correlation entry SDK value. Construction records local state only; documented runtimes, executors, or ports own side effects.

CorrelationKey

Typed SDK identifier for CorrelationKey. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

CorrelationValue

Typed SDK identifier for CorrelationValue. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

DedupeKey

Typed SDK identifier for DedupeKey. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

EffectId

Typed SDK identifier for EffectId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

EventCursorId

Typed SDK identifier for EventCursorId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

EventId

Typed SDK identifier for EventId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

IdempotencyKey

Typed SDK identifier for IdempotencyKey. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

JournalCursor

Defines the journal cursor SDK value. Construction records local state only; documented runtimes, executors, or ports own side effects.

JournalCursorId

Typed SDK identifier for JournalCursorId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

LineageId

Typed SDK identifier for LineageId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

MessageId

Typed SDK identifier for MessageId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

OutputSchemaId

Typed SDK identifier for OutputSchemaId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

RepairAttemptId

Typed SDK identifier for RepairAttemptId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

RunId

Typed SDK identifier for RunId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

RuntimePackageId

Typed SDK identifier for RuntimePackageId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

SessionId

Typed SDK identifier for SessionId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

SpanId

Typed SDK identifier for SpanId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ToolCallId

Typed SDK identifier for ToolCallId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

TopicId

Typed SDK identifier for TopicId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

TraceId

Typed SDK identifier for TraceId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

TurnId

Typed SDK identifier for TurnId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ValidatedOutputId

Typed SDK identifier for ValidatedOutputId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

ValidationAttemptId

Typed SDK identifier for ValidationAttemptId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

WakeConditionId

Typed SDK identifier for WakeConditionId. Use this newtype at public boundaries instead of a raw string; constructing or cloning it is data-only and performs no side effects.

Enums

IdValidationError

Enumerates the finite id validation error cases. Serialized names are part of the SDK contract; update fixtures when variants change.

Constants

MAX_ID_LEN

Constant value for the domain::ids contract. Use it to keep SDK records and tests aligned on the same stable value.