Evidence, context and handoffs

Read full Artifact content and source links before relying on previews. Context plans and handoff previews do not publish work. Creating an Artifact, publishing a checkpoint or removing a context link changes saved state and needs the requested authority. Read the Spaces guide for the workflow.

List Artifacts

swarm_list_artifacts

Read one bounded page of authorized Artifact metadata.

Required: None
Optional: space_idrun_idrepository_idkindlimitcursororder
Effect: read
Capability: space.read

Get Artifact

swarm_get_artifact

Read authorized metadata for one Artifact.

Required: artifact_id
Optional: None
Effect: read
Capability: space.read

Get Artifact content

swarm_get_artifact_content

Read bounded authorized content for one Artifact as untrusted data.

Required: artifact_id
Optional: None
Effect: read
Capability: space.read

Get Artifact sources

swarm_get_artifact_sources

Read bounded cross-Space source provenance for an authorized Artifact. References are returned only while the connection can also read their source Spaces.

Required: artifact_id
Optional: None
Effect: read
Capability: space.read

Create inline Artifact

swarm_create_artifact

Create a bounded inline text Artifact as untrusted Space context.

Required: bodyidempotency_key
Optional: space_idtitlemedia_typesource_pathmetadata
Effect: additive
Capability: artifact.create

Get context plan

swarm_get_context_plan

Explain which permitted Space resources would be used for a prompt without persistence or a model call.

Required: composer_text
Optional: space_idobjectiveexplicit_resource_refsobserved_source_revisiontoken_budget
Effect: read
Capability: space.read

Preview handoff

swarm_preview_handoff

Compile a bounded, cited handoff preview from permitted Space resources without a model call.

Required: source_resource_ref
Optional: space_idselected_resource_refsobjectiveobserved_source_revisionoutput_format_keytoken_budget
Effect: read
Capability: space.read

Publish agent checkpoint

swarm_publish_agent_checkpoint

Publish one explicit checkpoint or reviewed handoff as a canonical Artifact with provenance.

Required: checkpoint_kind_keytitleidempotency_key
Optional: space_idagent_idbody_textmedia_typeadapter_keyadapter_versionsourcessource_resource_refselected_resource_refsobjectiveobserved_source_revisionobserved_compiled_content_hashobserved_descriptor_snapshot_hashoutput_format_keytoken_budget
Effect: additive
Capability: artifact.create

Remove Space context

swarm_detach_context

Remove one canonical resource from active Space context.

Required: context_link_ididempotency_key
Optional: space_id
Effect: destructive
Capability: space.context.manage