Skip to content

CanonicalRequestIdentity

Defined in: src/idempotency/key.ts:48

The authoritative logical-request identity. The harness supplies these; the SDK does not invent them.

Properties

conversationId

readonly conversationId: string

Defined in: src/idempotency/key.ts:50

Stable per agent run / session. The cross-process dedup anchor.


intent?

readonly optional intent?: string

Defined in: src/idempotency/key.ts:59

Optional human-meaningful label, folded in (normalized) for debuggability.


namespace?

readonly optional namespace?: string

Defined in: src/idempotency/key.ts:61

Optional partition for parallel sub-agents / orchestrators.


stepId

readonly stepId: string

Defined in: src/idempotency/key.ts:57

Reasoning-step ordinal/identifier, stable for “the same logical step”. The same step retried / replayed must carry the same stepId, or it is treated as a new payment. The harness owns numbering (see createIdempotencyKeyBuilder).