Carrier Reference

Generated from carrier package declarations. Package docs explain intent; this page owns event, schema, settlement, authority, and material reference facts.

Carriers

Package	Prefix	Events	Roles
`@agent-os/decision-gate`	`decision_gate.`	3	`admitter`, `reader`
`@agent-os/deploy`	`deploy.`	5	`generator`, `resolver`, `reader`
`@agent-os/git-carrier`	`git.`	5	`generator`, `resolver`, `reader`
`@agent-os/image`	`image.`	0	`reader`
`@agent-os/resource-carrier`	`resource.`	5	`resolver`, `reader`
`@agent-os/staging-artifact`	`staging.`	2	`generator`, `resolver`, `reader`
`@agent-os/verification`	`verification.`	1	`generator`, `reader`
`@agent-os/workspace-job`	`workspace_job.`	9	`generator`, `reader`
`@agent-os/workspace-op`	`workspace_op.`	3	`generator`, `resolver`, `reader`
`@agent-os/workspace-session`	`workspace_session.`	6	`resolver`, `reader`

@agent-os/decision-gate

Export: decisionGateCarrier

Prefix: decision_gate.

Roles: admitter, reader

Event Kinds

Event kind	Claim	Payload fields
`decision_gate.consumed`	lived `claim`; anchors `ledger_event`	`gateRef`: string (required) `decisionRef`: string (required) `consumedBy`: string (required)
`decision_gate.decided`	none	`gateRef`: string (required) `decisionRef`: string (required) `decision`: enum(approved, rejected) (required) `decidedBy`: string (required) `reason`: string (optional) `rejectionRef`: object (optional)
`decision_gate.requested`	pre `claim`	`gateRef`: string (required) `subjectRef`: string (required) `policyRef`: string (optional) `summary`: string (optional)

Settlement Vocabulary

Settlement id: @agent-os/decision-gate

Anchor kinds: ledger_event

Rejection kinds: None.

Authority Requirements

None.

Material Requirements

None.

@agent-os/deploy

Export: deployCarrier

Prefix: deploy.

Roles: generator, resolver, reader

Event Kinds

Event kind	Claim	Payload fields
`deploy.failed`	rejected `claim`; rejections `provider_rejected`, `policy_denied`, `validation_failed`	`subjectRef`: string (required) `step`: enum(preview, promote, readback, rollback) (required) `proofRef`: string (required) `reason`: string (required)
`deploy.preview.recorded`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `previewRef`: string (required) `artifactRef`: string (required)
`deploy.production.promoted`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `deployRef`: string (required) `productionRef`: string (required) `rollbackRef`: string (optional)
`deploy.production.readback`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `productionRef`: string (required) `readbackRef`: string (required) `status`: enum(passed, failed) (required)
`deploy.rollback.recorded`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `rollbackRef`: string (required) `restoredDeployRef`: string (required)

Settlement Vocabulary

Settlement id: @agent-os/deploy

Anchor kinds: carrier_proof, external_receipt

Rejection kinds: provider_rejected, policy_denied, validation_failed

Authority Requirements

None.

Material Requirements

None.

@agent-os/git-carrier

Export: gitCarrier

Prefix: git.

Roles: generator, resolver, reader

Event Kinds

Event kind	Claim	Payload fields
`git.commit.recorded`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `commitRef`: string (required) `parentRef`: string (required) `diffRef`: string (required)
`git.merge.recorded`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `mergeCommitRef`: string (required) `targetRef`: string (required)
`git.revert.recorded`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `revertCommitRef`: string (required) `revertedRef`: string (required)
`git.workspace.cleaned`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `workspaceRef`: string (required)
`git.workspace.created`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `workspaceRef`: string (required) `baseRef`: string (required) `branchRef`: string (required)

Settlement Vocabulary

Settlement id: @agent-os/git-carrier

Anchor kinds: carrier_proof

Rejection kinds: None.

Authority Requirements

None.

Material Requirements

None.

@agent-os/image

Export: imageEventNamespace

Prefix: image.

Roles: reader

Event Kinds

None.

Settlement Vocabulary

None.

Authority Requirements

None.

Material Requirements

None.

@agent-os/resource-carrier

Export: resourceCarrierDefinition

Prefix: resource.

Roles: resolver, reader

Event Kinds

Event kind	Claim	Payload fields
`resource.bound`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `resourceRef`: object (required) `bindingRef`: object (required) `proofRef`: string (required)
`resource.destroyed`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `resourceRef`: anyOf (required) `proofRef`: string (required) `reason`: enum(replaced, expired, aborted, manual) (required)
`resource.failed`	rejected `claim`; rejections `unsupported`, `resource_denied`, `policy_denied`, `provider_rejected`	`subjectRef`: string (required) `step`: enum(provision, bind, mutate, destroy) (required) `proofRef`: string (optional) `reason`: string (required)
`resource.mutation.recorded`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `resourceRef`: anyOf (required) `mutationKind`: string (required) `mutationRef`: string (required) `proofRef`: string (required) `fingerprint`: string (optional)
`resource.provisioned`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `resourceKind`: string (required) `resourceRef`: object (required) `accountRef`: object (optional) `bindingRef`: object (optional) `proofRef`: string (required)

Settlement Vocabulary

Settlement id: @agent-os/resource-carrier

Anchor kinds: carrier_proof, external_receipt

Rejection kinds: unsupported, resource_denied, policy_denied, provider_rejected

Authority Requirements

Authority	Class	Required materials
`<unknown>`	unknown	`api_token`: required credential, purpose=resource_api `account`: required external_resource, resource=account
`<unknown>`	unknown	`api_token`: required credential, purpose=resource_api `account`: required external_resource, resource=account `binding`: required binding
`<unknown>`	unknown	`api_token`: required credential, purpose=resource_api `account`: required external_resource, resource=account `binding`: required binding
`<unknown>`	unknown	`api_token`: required credential, purpose=resource_api `account`: required external_resource, resource=account

Material Requirements

Slot	Kind	Required	Details
`api_token`	credential	yes	purpose=resource_api
`account`	external_resource	yes	resource=account
`binding`	binding	yes	-

@agent-os/staging-artifact

Export: stagingArtifactCarrier

Prefix: staging.

Roles: generator, resolver, reader

Event Kinds

Event kind	Claim	Payload fields
`staging.artifact.published`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `artifactRef`: string (required) `routeRef`: string (required) `digest`: string (required)
`staging.artifact.reaped`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `artifactRef`: string (required) `reason`: enum(published, discarded, expired) (required)

Settlement Vocabulary

Settlement id: @agent-os/staging-artifact

Anchor kinds: carrier_proof

Rejection kinds: None.

Authority Requirements

None.

Material Requirements

None.

@agent-os/verification

Export: verificationCarrier

Prefix: verification.

Roles: generator, reader

Event Kinds

Event kind	Claim	Payload fields
`verification.gate.recorded`	lived `claim`; anchors `carrier_proof`, `external_receipt`	`subjectRef`: string (required) `gate`: string (required) `status`: enum(passed, failed) (required) `proofRef`: string (required) `fingerprint`: string (required) `summary`: string (optional)

Settlement Vocabulary

Settlement id: @agent-os/verification

Anchor kinds: carrier_proof, external_receipt

Rejection kinds: None.

Authority Requirements

None.

Material Requirements

None.

@agent-os/workspace-job

Export: workspaceJobCarrier

Prefix: workspace_job.

Roles: generator, reader

Event Kinds

Event kind	Claim	Payload fields
`workspace_job.artifact_readback_verified`	lived `claim`; anchors `carrier_proof`	`requestedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `path`: string (required) `artifactRef`: string (required) `submitRunId`: number (required) `schemaId`: string (required) `bytes`: number (required) `sha256`: string (required)
`workspace_job.artifact_written`	lived `claim`; anchors `carrier_proof`	`requestedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `path`: string (required) `artifactRef`: string (required) `submitRunId`: number (required) `schemaId`: string (required) `bytes`: number (required) `sha256`: string (required)
`workspace_job.failed`	rejected `claim`; rejections `provider_rejected`, `validation_failed`, `resource_denied`	`requestedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `failure`: object (required) `submitRunId`: number (optional)
`workspace_job.requested`	pre `claim`	`runId`: string (required) `idempotencyKey`: string (required) `requestedBy`: string (required) `workspaceRef`: string (optional) `inputRef`: string (optional) `inputHash`: string (optional) `terminalSchemaId`: string (required)
`workspace_job.seed_written`	lived `claim`; anchors `carrier_proof`	`requestedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `seedPaths`: array (required)
`workspace_job.terminal_build_attempted`	lived `claim`; anchors `carrier_proof`	`requestedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `submitRunId`: number (required) `schemaId`: string (required) `bytes`: number (required) `sha256`: string (required)
`workspace_job.terminal_finalized`	lived `claim`; anchors `carrier_proof`	`requestedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `terminalArtifact`: object (required)
`workspace_job.verified`	lived `claim`; anchors `carrier_proof`	`requestedEventId`: number (required) `terminalFinalizedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `checks`: array
`workspace_job.verifier_rejected`	rejected `claim`; rejections `validation_failed`, `policy_denied`	`requestedEventId`: number (required) `terminalFinalizedEventId`: number (required) `runId`: string (required) `idempotencyKey`: string (required) `checks`: array

Settlement Vocabulary

Settlement id: @agent-os/workspace-job

Anchor kinds: carrier_proof

Rejection kinds: validation_failed, policy_denied, provider_rejected, resource_denied

Authority Requirements

None.

Material Requirements

None.

@agent-os/workspace-op

Export: workspaceOpCarrier

Prefix: workspace_op.

Roles: generator, resolver, reader

Event Kinds

Event kind	Claim	Payload fields
`workspace_op.completed`	lived `claim`; anchors `external_receipt`	`requestedEventId`: number (required) `operationRef`: string (required) `workspaceRef`: string (required) `toolCallId`: string (optional) `toolName`: enum(write_file, edit_file, delete_path, run_shell) (required) `idempotencyKey`: string (required) `resultHash`: string (required) `path`: string (optional) `bytesWritten`: number (optional) `deleted`: boolean (optional) `replacementCount`: number (optional) `exitCode`: number (optional) `command`: string (optional) `cwd`: string (optional) `stdoutPreview`: string (optional) `stderrPreview`: string (optional) `stdoutBytes`: number (optional) `stderrBytes`: number (optional) `stdoutTruncated`: boolean (optional) `stderrTruncated`: boolean (optional) `stdoutHash`: string (optional) `stderrHash`: string (optional) `durationMs`: number (optional)
`workspace_op.rejected`	rejected `claim`; rejections `provider_rejected`, `validation_failed`, `resource_denied`	`requestedEventId`: number (required) `operationRef`: string (required) `workspaceRef`: string (required) `toolCallId`: string (optional) `toolName`: enum(write_file, edit_file, delete_path, run_shell) (required) `idempotencyKey`: string (required) `reason`: string (required)
`workspace_op.requested`	pre `claim`	`requestedBy`: string (required) `workspaceRef`: string (required) `toolCallId`: string (optional) `toolName`: enum(write_file, edit_file, delete_path, run_shell) (required) `path`: string (optional) `content`: string (optional) `oldString`: string (optional) `newString`: string (optional) `expectCount`: number (optional) `recursive`: boolean (optional) `force`: boolean (optional) `command`: string (optional) `cwd`: string (optional) `timeoutMs`: number (optional) `envRefs`: array

Settlement Vocabulary

Settlement id: @agent-os/workspace-op

Anchor kinds: external_receipt

Rejection kinds: provider_rejected, validation_failed, resource_denied

Authority Requirements

None.

Material Requirements

None.

@agent-os/workspace-session

Export: workspaceSessionCarrier

Prefix: workspace_session.

Roles: resolver, reader

Event Kinds

Event kind	Claim	Payload fields
`workspace_session.backed_up`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `sessionRef`: string (required) `backupRef`: string (required) `expiresAt`: string (optional)
`workspace_session.destroyed`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `sessionRef`: string (required) `reason`: enum(completed, expired, aborted, manual) (required)
`workspace_session.failed`	rejected `claim`; rejections `unsupported`, `policy_denied`, `provider_rejected`, `resource_denied`	`subjectRef`: string (required) `step`: enum(start, restore, backup, preview, destroy) (required) `proofRef`: string (optional) `reason`: string (required)
`workspace_session.preview_allocated`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `sessionRef`: string (required) `previewRef`: string (required) `port`: number (required)
`workspace_session.restored`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `sessionRef`: string (required) `backupRef`: string (required) `workspaceRootRef`: string (required) `cleanupRef`: string (required) `retention`: object (optional)
`workspace_session.started`	lived `claim`; anchors `carrier_proof`	`subjectRef`: string (required) `sessionRef`: string (required) `workspaceRootRef`: string (required) `cleanupRef`: string (required) `retention`: object (optional)

Settlement Vocabulary

Settlement id: @agent-os/workspace-session

Anchor kinds: carrier_proof

Rejection kinds: unsupported, policy_denied, provider_rejected, resource_denied

Authority Requirements

None.

Material Requirements

None.