跳转到内容

ak.schema.agent_sidecar_exchange_control.v1

← Schemas

Arkret Agent Sidecar Exchange Control
ak.schema.agent_sidecar_exchange_control.v1 · file: schemas/agent-sidecar-exchange-control.schema.json

Closed plaintext encrypted inside the payload of ak.agent.sidecar.exchange.control. Only the Sidecar controller may author this durable private-Strand Event. It is the sole source of coordinator reassignment and terminal exchange state.

* $ · object
Closed plaintext encrypted inside the payload of ak.agent.sidecar.exchange.control. Only the Sidecar controller may author this durable private-Strand Event. It is the sole source of coordinator reassignment and terminal exchange state.
allOf · allOf[0] · ?
allOf · allOf[1] · ?
allOf · allOf[2] · ?
* schema · const "ak.schema.agent_sidecar_exchange_control.v1"
enum: "ak.schema.agent_sidecar_exchange_control.v1"
* exchange_id · string
pattern: ^[A-Za-z0-9._~=-]{22,128}$
* request_event_id · string · $ref #/$defs/event_id
pattern: ^ak:event:[A-Za-z0-9_-]{44}$
* basis_event_ids · array<$ref #/$defs/event_id>
Canonical UTF-8 byte-order sorted maximal causal heads of exchange facts observed when this control was authored. The outer Event refs MUST contain role=after for every id, and the request Event must be causally covered.
items · string · $ref #/$defs/event_id
pattern: ^ak:event:[A-Za-z0-9_-]{44}$
* action · string (enum)
enum: "close" "cancel" "fail" "reassign_coordinator"
response_event_ids · array<$ref #/$defs/event_id>
Exact canonical set of validated user-facing response Event ids causally covered by basis_event_ids. Required for every terminal action, including an empty array.
items · string · $ref #/$defs/event_id
pattern: ^ak:event:[A-Za-z0-9_-]{44}$
failure_reason_code · string
Required only for action=fail. close/cancel derive empty-response failure codes controller_closed_empty/controller_cancelled.
pattern: ^[a-z][a-z0-9_]{0,63}$
expected_coordinator_agent_id · string · $ref ./common-ids.schema.json#/$defs/did_core_id
Canonical stable DID-derived identity core. The lowercase DID method name follows ak:did_core:, and the remaining method-adapter-defined core is opaque to generic consumers. The did:web v1 adapter uses the complete canonical method-specific-id, never a digest or truncated host. Principal-core and service-core equality is byte-for-byte equality of the complete did_core_id. Event actor and Realm membership equality instead use the complete closed ActorId, and account-scoped equality uses the complete AccountId; neither may be reduced to a principal core. A did_core_id is not a DID and cannot be resolved without a did or AuthenticatedServiceResolution.
pattern: ^ak:did_core:[a-z0-9]+:[^\s/?#]+$
coordinator_agent_id · string · $ref ./common-ids.schema.json#/$defs/did_core_id
Canonical stable DID-derived identity core. The lowercase DID method name follows ak:did_core:, and the remaining method-adapter-defined core is opaque to generic consumers. The did:web v1 adapter uses the complete canonical method-specific-id, never a digest or truncated host. Principal-core and service-core equality is byte-for-byte equality of the complete did_core_id. Event actor and Realm membership equality instead use the complete closed ActorId, and account-scoped equality uses the complete AccountId; neither may be reduced to a principal core. A did_core_id is not a DID and cannot be resolved without a did or AuthenticatedServiceResolution.
pattern: ^ak:did_core:[a-z0-9]+:[^\s/?#]+$

Source