Skip to main content

Crate gate4agent_c2_protocol

Crate gate4agent_c2_protocol

Expand description

Stable, serde-only inventory and control contract for Gate4Agent C2.

Structs§

AdapterContractRevision
AdapterId: Stable identifier for one provider adapter implementation.
AgentId: Stable, extensible identifier for an agent CLI.
AgentProgressAttentionV1
AgentProgressUsageV1
AgentProgressV1
ArchitectureId
C2ClientAuthentication
C2ClientHello
C2ControlCompatibilitySupport
C2ControlEvent
C2GitSnapshot
C2GitWorktreeSnapshot
C2Hello
C2ManagedSessionRecord
C2NodeEventEnvelope
C2NodeFailure
C2NodeSnapshot
C2RelayFailure
C2ReplyEnvelope
C2RequestEnvelope
C2RequestId
C2ServerChallenge
C2SessionSnapshot
C2Topology
C2TopologyNode
C2WorkspaceInspection
C2WorkspaceSnapshot
CapabilityId
ClientCompatibilityOffer
ContextPackBytesRead
ContextPackLineageReceipt
DeliveryBlobChunkHexV1
DeliveryBlobDigestV1
DeliveryBlobReceiptV1
DeliveryBundleManifestV2
DeliveryCommitReceiptV1
DeliveryManifestDigestV2
DeliveryStageId
GitDiff
GitHistoryPage
HarnessMcpActivationDigest
HarnessMcpCallId
HarnessMcpOpaquePayloadV1: An opaque harness-MCP payload.
HarnessMcpReplyChunkHexV1
HarnessMcpReservationId
HealthResponse
HistoryCandidateSummary
HostDescriptor
HostDirectoryEntry
HostDirectoryListing
LaunchInventory
ManagedWorktreeGitScope
ManagedWorktreeLeaseId
ManagedWorktreeLeaseSnapshot
ManagedWorktreeProfileSummary
ManagedWorktreeSpawnReceipt
ManagedWorktreeSpawnRequest
ManagedWorktreeSpawnRequestV2
NativeSessionCatalogEntry
NativeSessionCatalogPage
NativeSessionCatalogRoute
NativeSessionCatalogSummary
NativeSessionExternalGroup
NativeSessionSelection
NegotiatedC2ControlCompatibility
NodeCursor
NodeFailure
NodeGap
NodeId
NodeIncarnationId
NodeRoute
ObservedNode
OpaqueHostPath
OperatingSystemId
PathSemantics
ProtocolRange
ProviderAdapterContractSupport
ProviderContractRevision
ProviderContractSupport
ProviderRuntimeContractId
ProviderRuntimeStatus
ProviderRuntimeStatuses
ProviderRuntimeVersion
ReadyResponse
RepositoryPath
ResolvedBundleReceipt
ResolvedContextPackReceipt
ResolvedEnvironmentProfileReceipt: Resolved environment-profile identity echoed on spawn receipts.
ResolvedHarnessMcpProxyReceiptV1
ResolvedSpawnReceipt
ResolvedSpawnSpec
RoutedNodeEvent
RoutedNodeRequest
RoutedNodeResponse
SanitizedError
SessionAgentProgress
SessionRecordPreview
SessionTaskBindingV1
SlimManagedSessionRecord
SlimNodeInventory
SlimSession
SlimWorkspace
SpawnBrowserProfileId: Opaque dig2browser station browserProfile id under node-local profiles_root.
SpawnBundleDigest
SpawnBundleId
SpawnBundleRevision
SpawnContextDigest
SpawnContextId
SpawnDeadlineMs
SpawnEnvironmentProfileId
SpawnEnvironmentProfileRevision
SpawnIdempotencyKey
SpawnNetworkAllowlistId: Opaque node-local network allowlist policy id (station axis).
SpawnOverrides: Spawn-time overrides for an accepted SpawnSpec.
SpawnProfileDefaults
SpawnProfileId
SpawnProfileRevision
SpawnProfileSummary
SpawnPrompt
SpawnPromptMetadata
SpawnRequiredCapabilities
SpawnResolutionProvenance
SpawnSpec
SpawnTarget
StatusResponse
TaskId
WorkspaceFileRead
WorktreeProfileId
WorktreeProfileInventory
WorktreeProfileRevision

Enums§

Constants§

BUILD_STAMP
C2_ACP_CONTROL_CAPABILITY: The four ACP control verbs – ResolveInteraction, SetSessionMode, SetSessionConfigOption, SetSessionModel – gated the same way every other capability-scoped path is: a peer that never negotiated it must never have its requests admitted.
C2_AGENT_PROGRESS_SNAPSHOT_CAPABILITY
C2_AGENT_STREAM_EVENTS_CAPABILITY: The outbound agent-content stream – C2NodeEvent::AgentStream – gated the same way C2_TERMINAL_FRAME_EVENTS_CAPABILITY gates C2NodeEvent::TerminalFrame: a peer that never negotiated it must never receive it.
C2_API_VERSION
C2_AUTH_NONCE_BYTES
C2_AUTH_PROOF_BYTES
C2_CHILD_ENVIRONMENT_PROFILE_CAPABILITY
C2_COMPATIBILITY_METADATA_CAPABILITY
C2_CONTROL_DETAIL_CAPABILITY: The sanitized control-event detail – C2ControlEvent::detail – gated the same way C2_AGENT_STREAM_EVENTS_CAPABILITY gates the agent stream: a peer that never negotiated it must never receive it. A C2-level capability, not a node one: the node always publishes its full control events and the C2 decides, per connection, what of them crosses.
C2_DELIVERY_BUNDLE_V2_STAGE_COMMIT_CAPABILITY
C2_GIT_READ_CAPABILITY
C2_HARNESS_MCP_READ_PROXY_CAPABILITY
C2_HISTORY_CONTEXT_PACK_CAPABILITY
C2_HOST_DIRECTORY_BROWSE_CAPABILITY
C2_MANAGED_WORKTREE_LIFECYCLE_CAPABILITY
C2_MANAGED_WORKTREE_SPAWN_V2_CAPABILITY
C2_NATIVE_SESSION_CATALOG_CAPABILITY
C2_NATIVE_SESSION_CATALOG_PAGING_CAPABILITY
C2_NATIVE_SESSION_INDEX_CAPABILITY
C2_NATIVE_SESSION_PREVIEW_CAPABILITY
C2_OPAQUE_UNIX_PATH_CAPABILITY
C2_PROVIDER_CONTRACT_MANIFEST_CAPABILITY
C2_PROVIDER_ID_OPEN_CAPABILITY
C2_PROVIDER_RUNTIME_STATUS_CAPABILITY
C2_PROVIDER_SESSION_REFERENCE_INDEX_CAPABILITY
C2_REPOSITORY_PATH_CAPABILITY
C2_SESSION_BUNDLE_MATERIALIZATION_CAPABILITY
C2_SESSION_RECORD_CONTEXT_EXPORT_CAPABILITY
C2_SESSION_TASK_CORRELATION_CAPABILITY
C2_SPAWN_PROFILE_REVISION_CAPABILITY
C2_SPAWN_SPEC_DEFAULTS_OVERRIDES_CAPABILITY
C2_STANDALONE_WORKSPACE_LIFECYCLE_CAPABILITY
C2_TERMINAL_FRAME_EVENTS_CAPABILITY
C2_WORKSPACE_ENTRY_CREATE_CAPABILITY
C2_WORKSPACE_FILE_READ_CAPABILITY
C2_WORKSPACE_FILE_WRITE_CAPABILITY
C2_WORKTREE_SELECTION_CAPABILITY
CAPABILITY_HOST_DIRECTORY_BROWSE_V1: Read-only, paged directory browsing using UTF-8 absolute host paths only. OpaqueHostPath::UnixBytes is outside this capability revision.
DEFAULT_C2_API_LISTEN
MAX_C2_AUTH_COMPATIBILITY_CAPABILITIES
MAX_C2_AUTH_FRAME_BYTES
MAX_C2_BOUND_AUTH_TRANSCRIPT_BYTES
MAX_C2_CLIENT_FRAME_BYTES
MAX_C2_ENDPOINT_BYTES
MAX_C2_GAPS_PER_NODE
MAX_C2_HELLO_FRAME_BYTES
MAX_C2_MANAGED_SESSIONS_PER_NODE
MAX_C2_MANAGED_WORKTREES_PER_NODE
MAX_C2_NODES
MAX_C2_RESPONSE_BYTES
MAX_C2_ROOT_BYTES
MAX_C2_SERVER_FRAME_BYTES
MAX_C2_SESSIONS_PER_NODE
MAX_C2_SESSION_DISPLAY_NAME_BYTES
MAX_C2_WORKSPACES_PER_NODE
NODE_ACP_CONTROL_CAPABILITY: The inbound ACP control verbs – ResolveInteraction, SetSessionMode, SetSessionConfigOption, SetSessionModel – that answer what NODE_AGENT_STREAM_EVENTS_CAPABILITY reports (same plan, §5).
NODE_AGENT_STREAM_EVENTS_CAPABILITY: The outbound content stream – NodeEvent::AgentStream – mirroring NODE_TERMINAL_FRAME_EVENTS_CAPABILITY’s own subscription/type split rather than folding content into a telemetry vocabulary (docs/gate4agent/plans/gate4agent-acp-control-plane-on-the-wire-2026-09-02.md §3-4).
NODE_CHILD_ENVIRONMENT_PROFILE_CAPABILITY
NODE_DELIVERY_BUNDLE_V2_STAGE_COMMIT_CAPABILITY
NODE_HARNESS_MCP_READ_PROXY_CAPABILITY
NODE_HISTORY_CONTEXT_PACK_CAPABILITY
NODE_MANAGED_WORKTREE_LIFECYCLE_CAPABILITY
NODE_MANAGED_WORKTREE_SPAWN_V2_CAPABILITY
NODE_NATIVE_SESSION_CATALOG_CAPABILITY
NODE_NATIVE_SESSION_CATALOG_PAGING_CAPABILITY
NODE_NATIVE_SESSION_INDEX_CAPABILITY
NODE_NATIVE_SESSION_PREVIEW_CAPABILITY
NODE_PROVIDER_ID_OPEN_CAPABILITY
NODE_PROVIDER_SESSION_REFERENCE_INDEX_CAPABILITY
NODE_SESSION_BUNDLE_MATERIALIZATION_CAPABILITY
NODE_SESSION_RECORD_CONTEXT_EXPORT_CAPABILITY
NODE_SESSION_TASK_CORRELATION_CAPABILITY
NODE_SPAWN_PROFILE_REVISION_CAPABILITY
NODE_SPAWN_SPEC_DEFAULTS_OVERRIDES_CAPABILITY
NODE_STANDALONE_WORKSPACE_LIFECYCLE_CAPABILITY
NODE_TERMINAL_FRAME_EVENTS_CAPABILITY
NODE_WORKSPACE_ENTRY_CREATE_CAPABILITY
NODE_WORKTREE_SELECTION_CAPABILITY

Functions§

c2_auth_transcript
c2_bound_auth_transcript
control_telemetry_detail: The telemetry view of event, or None when no telemetry derives from it (control-plane bookkeeping such as requests, completions and probes).
provider_id_is_legacy

Type Aliases§

NativeSessionPreview