Skip to content

<!-- CODE GENERATED BY cmd/harbor-gen-protocol-docs. DO NOT EDIT. -->

Protocol events ​

The 148 canonical event types a Harbor Runtime can publish, read from the live event-type registry (internal/events) as the production driver set populates it. Subscribe via GET /v1/events (SSE) — see methods.md and the streaming semantics guide.

How payloads reach a subscriber ​

Every SSE frame's data: line is one JSON object: type, sequence (the reconnect cursor), occurred_at, the flat identity (tenant / user / session / run), and payload. Two payload classes exist:

  • Safe payloads — types the declaring subsystem marked as carrying no secret-shaped data. The bus skips the audit redactor; the subscriber receives the typed shape below verbatim. Field keys are whatever encoding/json emits: most payloads carry no struct tags, so their keys are the Go field names (e.g. TaskID, capital T); a payload whose fields ARE tagged uses the tag name. The Wire key column below is authoritative per payload — read it, don't assume the casing.
  • Redacted payloads — everything else is walked by the audit redactor on publish; the subscriber receives a redacted key/value map derived from the declared shape.

agent.config.reverted ​

Payload ConfigRevertedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
RevisionIDstring
FromRevisionIDstring
OccurredAttime.Time

agent.config.revised ​

Payload ConfigRevisedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
RevisionIDstring
ParentRevisionIDstring
ContentHashstring
OccurredAttime.Time

agent.deregistered ​

Payload AgentDeregisteredPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
RegistrationKeystring
DeregisteredAtint64

agent.drained ​

Payload AgentControlPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
Commandstring
Reasonstring
IssuedAtint64

agent.force_stopped ​

Payload AgentControlPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
Commandstring
Reasonstring
IssuedAtint64

agent.health ​

Payload AgentHealthPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
Healthstring
ReportedAtint64

agent.paused ​

Payload AgentControlPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
Commandstring
Reasonstring
IssuedAtint64

agent.registered ​

Payload AgentRegisteredPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
RegistrationKeystring
Incarnationuint64
VersionHashstring
Hostingstring
RegisteredAtint64

agent.restart_requested ​

Payload AgentControlPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
Commandstring
Reasonstring
IssuedAtint64

agent.restarted ​

Payload AgentRestartedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
RegistrationKeystring
Incarnationuint64
VersionHashstring
VersionHashChangedbool
RestartedAtint64

agent_config.llm_provider.installed ​

Payload LLMProviderSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ProviderNamestring
Providerstring
InferenceBrokerstring
OccurredAttime.Time

agent_config.oauth_provider.installed ​

Payload OAuthProviderSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ProviderNamestring
CredentialBrokerstring
RevisionIDstring
OccurredAttime.Time

agent_config.oauth_provider.removed ​

Payload OAuthProviderSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ProviderNamestring
CredentialBrokerstring
RevisionIDstring
OccurredAttime.Time

agent_config.retirement.completed ​

Payload RetirementEventPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
OperationHashstring
Stagestring
classstringoptional (omitempty)
Completedint
Totalint
Generationuint64
OccurredAttime.Time

agent_config.retirement.progress ​

Payload RetirementEventPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
OperationHashstring
Stagestring
classstringoptional (omitempty)
Completedint
Totalint
Generationuint64
OccurredAttime.Time

agent_config.retirement.started ​

Payload RetirementEventPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
AgentIDstring
OperationHashstring
Stagestring
classstringoptional (omitempty)
Completedint
Totalint
Generationuint64
OccurredAttime.Time

artifacts.deleted ​

Payload ArtifactDeletedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
artifact_idstring

artifacts.uploaded ​

Payload ArtifactUploadedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
artifact_idstring
mime_typestringoptional (omitempty)
size_bytesint64
sourcestringoptional (omitempty)
namespacestringoptional (omitempty)

audit.admin_scope_used ​

Two emit sites publish distinct shapes: the bus's admin-filter Subscribe emit (first shape) and the Protocol-edge admin/impersonation audit emit (second shape).

Payload AdminScopeUsedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Tenantstring
Userstring
Sessionstring
SubscriberIDuint64

Payload AdminScopeUsedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actorauth.IdentityTriple
Requesterauth.IdentityTriple
Impersonatingauth.IdentityTriple
Reasonstring
Methodstring

audit.redaction_failed ​

Payload AuditRedactionFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
OriginalTypeevents.EventType
Reasonstring

auth.rejected ​

Payload AuthRejectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Reasonstring
KIDstring
Issuerstring
Subjectstring

bus.dropped ​

Payload BusDroppedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
FromSequint64
ToSequint64
DroppedCountuint64
SubscriberIDuint64

bus.subscription_idle_closed ​

Payload SubscriptionIdleClosedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SubscriberIDuint64
IdleSecondsfloat64

control.applied ​

Payload ControlLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Typestring
Outcomestring
Errstring

control.received ​

Payload ControlLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Typestring
Outcomestring
Errstring

control.rejected ​

Payload ControlRejectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Typestring
Reasonstring
CallerScopestring

dev.draft.created ​

Payload DraftCreatedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
DraftIDstring
Templatestring
FileCountint

dev.draft.discarded ​

Payload DraftDiscardedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
DraftIDstring

dev.draft.previewed ​

Payload DraftPreviewedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
DraftIDstring
OKbool

dev.draft.saved ​

Payload DraftSavedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
DraftIDstring
OutputDirstring
FileCountint

dev.draft.updated ​

Payload DraftUpdatedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
DraftIDstring
Pathstring
Sizeint

distributed.bus_envelope ​

Payload BusEnvelopePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Envelopedistributed.BusEnvelope

flow.budget_exceeded ​

Payload BudgetExceededPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
FlowNamestring
Axisstring

flows.page_viewed ​

Payload FlowsPageViewedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Methodstring
FlowIDstring
AdminScopedbool

flows.run_invoked ​

Payload FlowsRunInvokedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
FlowIDstring
RunIDstring

governance.budget_exceeded ​

Payload BudgetExceededPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Tierstring
Modelstring
TotalCostfloat64
Ceilingfloat64
Currencystring
OccurredAttime.Time

governance.failover ​

Payload GovernanceFailoverPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
FromProviderstring
ToProviderstring
HopIndexint
AccumCostUSDfloat64
Reasonstring

governance.key_rotated ​

Payload KeyRotatedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
Providerstring
Fingerprintstring
OccurredAttime.Time

governance.maxtokens_exceeded ​

Payload MaxTokensExceededPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Tierstring
Modelstring
Requestedint
Capint
OccurredAttime.Time

governance.posture_read_admin ​

Payload PostureReadAdminPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
RequestedTenantstring
OccurredAttime.Time

governance.posture_set ​

Payload GovernancePostureSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
DefaultTierBeforestring
DefaultTierAfterstring
TierCountBeforeint
TierCountAfterint
TiersBefore[]string
TiersAfter[]string
OccurredAttime.Time

governance.rate_limited ​

Payload RateLimitedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Tierstring
Modelstring
Requestedint
Availableint
Capacityint
RefillTokensint
RefillEverytime.Duration
OccurredAttime.Time

governance.tenant_overrides_set ​

Payload TenantOverridesSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
Tenantstring
Modelstring
SetModelbool
SetExtraInstructionsbool
SetTemperaturebool
SetMaxTokensbool
SetReasoningEffortbool
OccurredAttime.Time

llm.completion.chunk ​

Payload CompletionChunkPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
TaskIDstring
RunIDstring
Deltastring
Donebool
Kindstring
OccurredAttime.Time

llm.context.prepared ​

Payload ContextPreparedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
OccurredAttime.Time
Sectionsllm.RequestTokenSections
EstimatedTokensint
ContextWindowTokensint
InputLimitExclusiveint
OutputReservedint
OutputLimitKnownbool
CapacityExceededbool
MessageCountint
ToolCountint
WorkingInputTargetint
PlannerStepint
Attemptint
Retryint
Downgradeint
FallbackHopint
AttemptKnownbool
MaintenanceOrdinalint
History*llm.ContextHistoryoptional (omitempty)

llm.context_leak ​

Payload ContextLeakPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Modelstring
LeakSitestring
SizeBytesint64
Thresholdint
OccurredAttime.Time

llm.context_window_exceeded ​

Payload ContextWindowExceededPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Modelstring
EstimatedTokensint
ContextWindowTokensint
ContextWindowReservefloat64
OccurredAttime.Time

llm.cost.recorded ​

Payload CostRecordedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Modelstring
Costllm.Cost
Usagellm.Usage
ContextWindowTokensint
OccurredAttime.Time

llm.image.materialized ​

Payload ImageMaterializedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Modelstring
ArtifactRefstring
MIMEstring
SizeBytesint64
OccurredAttime.Time

llm.mode_downgraded ​

Payload ModeDowngradedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Modelstring
FromModellm.OutputMode
ToModellm.OutputMode
Fromllm.ResponseFormatKind
Tollm.ResponseFormatKind
Reasonstring
OccurredAttime.Time

llm.posture_read_admin ​

Payload PostureReadAdminPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
RequestedTenantstring

llm.provider_credential_fetched ​

Payload LLMProviderCredentialFetchedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
RuntimePrincipalstring
Brokerstring
Providerstring
KeyFingerprintstring
Phasestring
Outcomestring
OccurredAttime.Time

llm.provider_file.uploaded ​

Payload ProviderFileUploadedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Providerstring
Modelstring
ArtifactRefstring
MIMEstring
Modalitystring
FileIDstring
SizeBytesint64
OccurredAttime.Time

llm.retry_with_feedback ​

Payload RetryWithFeedbackPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Modelstring
Attemptint
MaxRetriesint
Reasonstring
OccurredAttime.Time

mcp.app_available ​

Payload AppAvailablePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
AgentIDstring
Bindingstring
ServerIDtools.ToolSourceID
ToolCallIDstring
ToolNamestring
ResourceURIstring
DisplayModestring
RawHTMLTrustedbool
OccurredAttime.Time

mcp.artifact_egressed ​

Payload ArtifactEgressedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ServerIDtools.ToolSourceID
ToolNamestring
Records[]artifactegress.Record
OccurredAttime.Time

mcp.connection.added ​

Payload MCPConnectionLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
Transportstring
Statestring
RevisionIDstring
PauseTokenstring
Reasonstring
OccurredAttime.Time

mcp.connection.auth_required ​

Payload MCPConnectionLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
Transportstring
Statestring
RevisionIDstring
PauseTokenstring
Reasonstring
OccurredAttime.Time

mcp.connection.discovery_origins_set ​

Payload MCPDiscoveryOriginsSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
RevisionIDstring
Granted[]string
Revoked[]string
OccurredAttime.Time

mcp.connection.failed ​

Payload MCPConnectionLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
Transportstring
Statestring
RevisionIDstring
PauseTokenstring
Reasonstring
OccurredAttime.Time

mcp.connection.paused ​

Payload MCPConnectionPausedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
RevisionIDstring
OccurredAttime.Time

mcp.connection.pending ​

Payload MCPConnectionLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
Transportstring
Statestring
RevisionIDstring
PauseTokenstring
Reasonstring
OccurredAttime.Time

mcp.connection.reattach_failed ​

Payload MCPConnectionLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
Transportstring
Statestring
RevisionIDstring
PauseTokenstring
Reasonstring
OccurredAttime.Time

mcp.connection.reattached ​

Payload MCPConnectionLifecyclePayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
Transportstring
Statestring
RevisionIDstring
PauseTokenstring
Reasonstring
OccurredAttime.Time

mcp.connection.removed ​

Payload MCPConnectionRemovedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
RevisionIDstring
OccurredAttime.Time

mcp.connection.resumed ​

Payload MCPConnectionResumedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Authoridentity.Quadruple
AgentIDstring
ServerIDstring
RevisionIDstring
OccurredAttime.Time

mcp.raw_html_trust_toggled ​

Payload MCPRawHTMLTrustToggledPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
ServerNamestring
Trustedbool
OccurredAttime.Time

mcp.resource_offloaded ​

Payload ResourceOffloadedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ArtifactIDstring
Sourcestring
SizeBytesint64
OccurredAttime.Time

mcp.resource_updated ​

Payload ResourceUpdatedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Sourcetools.ToolSourceID
URIstring
OccurredAttime.Time

memory.caller_block_admitted ​

Payload CallerBlockAdmittedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
bytesint
tierstring
keystring

memory.health_changed ​

Payload HealthChangedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
PriorHealthmemory.Health
NewHealthmemory.Health
Reasonstring

memory.identity_rejected ​

Payload MemoryIdentityRejectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Operationstring
Reasonstring

memory.item_deleted ​

Payload MemoryMutationPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Operationstring
Keystring

memory.item_put ​

Payload MemoryMutationPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Operationstring
Keystring

memory.recovery_dropped ​

Payload RecoveryDroppedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Reasonstring

notification.auth_required ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.governance_budget_exceeded ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.identity_rejected ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.pause_requested ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.task_completed ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.task_failed ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.task_group_cancelled ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.task_group_resolved ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

notification.tool_approval_requested ​

Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Classevents.EventType
Severitynotifications.Severity
Summarystring
DeepLinkstring
OriginEventTypeevents.EventType
OriginEventSequenceuint64
TaskIDstring
GroupIDstring
Members[]notifications.MemberOutcomeSummary
MembersTruncatedbool
MemberSucceededint
MemberFailedint
MemberCancelledint

pause.payload_artifact_routed ​

Payload PausePayloadArtifactRoutedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Tokenstring
ArtifactIDstring
PayloadBytesint
ThresholdBytesint

pause.requested ​

Payload PauseRequestedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Tokenstring
Reasonstring

pause.resumed ​

Payload PauseResumedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Tokenstring
Reasonstring
Decisionpauseresume.Decision

planner.action_extra_field_dropped ​

Payload ActionExtraFieldDroppedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Fieldstring
OccurredAttime.Time

planner.decision ​

Payload DecisionPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
DecisionKindstring
Toolstring
ReasoningCharsint
ReasoningTracestring
OccurredAttime.Time

planner.error ​

Registered anchor — no canonical emit path in this version (planner failures surface as task.failed).

planner.finish ​

Registered anchor — no canonical emit path in this version (a planner's terminal decision is observable via planner.decision with DecisionKind: Finish and the task.* lifecycle events).

planner.max_steps_exceeded ​

Payload MaxStepsExceededPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
MaxStepsint
StepsObservedint
LastToolstring
OccurredAttime.Time

planner.repair_exhausted ​

Payload RepairExhaustedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Attemptsint
ConsecutiveArgFailuresint
Reasons[]string
OccurredAttime.Time

planner.repair_guidance_injected ​

Payload RepairGuidanceInjectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
Tierstring
Counterstring
Countint
OccurredAttime.Time

planner.tool_declaration_collision ​

Payload ToolDeclarationCollisionPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
DeclaredNamestring
DeclaredToolstring
DroppedToolstring
OccurredAttime.Time

run.hook_dispatched ​

Payload RunHookDispatchedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Toolstring
Outcomestring
DurationMSint64
TranscriptBytesint
EntryCountint

run.hook_failed ​

Payload RunHookFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Toolstring
Outcomestring
ErrorClassstring

runs.overrides_set ​

Payload RunOverridesSetPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Actoridentity.Quadruple
SessionIDstring
SetReasoningEffortbool
SetTemperaturebool
SetMaxTokensbool
SetSystemPromptbool
SetExtraInstructionsbool
SetModelbool
OccurredAttime.Time

runtime.error ​

Payload RuntimeErrorPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).

Wire keyGo typeNotes
Messagestring
Fieldsmap[string]any

runtime.run_cancelled ​

Payload RunCancelledPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
RunIDstring
CancelledAtint64
DroppedEnvelopeCountint64

runtime.warning ​

Reserved for future runtime-warn emits — registered, no production Runtime emit path in this version; published only by the Protocol conformance suite as a driver-certification fixture.

session.closed ​

Payload SessionClosedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
ClosedAtint64
Reasonstring

session.erased ​

Payload SessionErasedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
StateRecordsDeletedint
ArtifactsDeletedint
MemoryPurgedbool
ErasedAtint64

session.gc_reaped ​

Payload SessionGCReapedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
ReapedAtint64
Reasonstring

session.naming_failed ​

Payload SessionNamingFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
ErrorClassstring

session.opened ​

Payload SessionOpenedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
OpenedAtint64

session.reopened ​

Payload SessionReopenedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
ReopenedAtint64
PriorClosedReasonstring

session.title_changed ​

Payload SessionTitleChangedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
Sourcestring

session.touched ​

Payload SessionTouchedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
SessionIDstring
LastSeenint64

skill.deleted ​

Payload SkillDeletedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Namestring

skill.identity_rejected ​

Payload SkillIdentityRejectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Operationstring
Reasonstring

skill.pack_overwrite_refused ​

Payload SkillPackOverwriteRefusedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Namestring
ExistingOriginskills.Origin
IncomingOriginskills.Origin

skill.proposed ​

Payload SkillProposedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Namestring
Originskills.Origin
Scopeskills.Scope
OriginRefstring
ContentHashstring
Resultstring
Reasonstring
RedactedTitleExcerptstring
RedactedTriggerExcerptstring
Promotionbool

skill.search_executed ​

Payload SkillSearchExecutedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
QueryHashstring
Pathstring
Limitint
ResultNint

skill.upserted ​

Payload SkillUpsertedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Namestring
Originskills.Origin
Scopeskills.Scope
ContentHashstring
Idempotentbool

task.background_acknowledged ​

Payload TaskBackgroundAcknowledgedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID

task.cancelled ​

Payload TaskCancelledPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID
Reasonstring
Cascadedbool

task.completed ​

Payload TaskCompletedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID
NotifyOnCompletebool

task.failed ​

Payload TaskFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID
ErrorCodestring

task.group_cancelled ​

Payload TaskGroupCancelledPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Completiontasks.GroupCompletion
Origintasks.CancelOrigin

task.group_created ​

Payload TaskGroupCreatedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
GroupIDtasks.TaskGroupID
OwnerTaskIDtasks.TaskID
RetainTurnbool
FailFastbool
Descriptionstring

task.group_resolved ​

Payload TaskGroupResolvedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Completiontasks.GroupCompletion

task.group_sealed ​

Payload TaskGroupSealedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
GroupIDtasks.TaskGroupID
Members[]tasks.TaskID
SealedAtint64

task.input_disposition.resolved ​

Payload InputDispositionResolvedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
identityidentity.Quadruple
task_idstring
artifact_idstring
mimestring
dispositionstring
layerstring
degradedbool
degraded_fromstringoptional (omitempty)
degradation_reasonstringoptional (omitempty)
toolstringoptional (omitempty)
occurred_attime.Time

task.patch_applied ​

Payload TaskPatchAppliedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
PatchIDstring

task.patch_rejected ​

Payload TaskPatchRejectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
PatchIDstring

task.paused ​

Registry-driver scope: emitted by the task registry's MarkPaused transition, which no V1 production caller drives on the live pause path — a paused run stays running in the task projection and pause state travels on the pause.* events (see the pause model).

Payload TaskPausedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID

task.prioritised ​

Payload TaskPrioritisedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID
PriorPriorityint
NewPriorityint

task.progress ​

Payload TaskProgressPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
update_idstring
TaskIDtasks.TaskID
ParentTaskIDtasks.TaskID
Fraction*float64
Phasestring
Messagestring
Tags[]string
ReportedAtint64

task.resumed ​

Registry-driver scope: emitted by the task registry's MarkResumed transition, which no V1 production caller drives on the live pause path — subscribe to pause.resumed for live resume signals (see the pause model).

Payload TaskResumedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID

task.spawned ​

Payload TaskSpawnedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID
Kindtasks.TaskKind
ParentTaskIDtasks.TaskID
Priorityint
IdempotencyKeystring

task.started ​

Payload TaskStartedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
TaskIDtasks.TaskID
PriorStatetasks.TaskStatus

tool.approval_requested ​

Payload ToolApprovalRequestedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Toolstring
PauseTokenstring
Reasonstring
Tags[]string
ArgsSummaryany

tool.approved ​

Payload ToolApprovedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Toolstring
PauseTokenstring
ApproverReasonstring

tool.auth_completed ​

Payload ToolAuthCompletedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Sourcestring
BindingScopestring
Statestring
PauseTokenstring

tool.auth_required ​

Payload ToolAuthRequiredPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Sourcestring
SourceNamestring
BindingScopestring
AuthorizeURLstring
Statestring
PauseTokenstring
Scopes[]string

tool.completed ​

Payload ToolCompletedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ToolNamestring
Transporttools.TransportKind
Attemptsint
DurationMSint64

tool.credential_exchanged ​

The AudienceVerified field is true only when the general tokenexchange path read a JWT aud claim and it included the declared RFC 8707 resource. Signed-capability exchanges prove the destination from the broker response and leave this field false.

Payload ToolCredentialExchangedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Sourcestring
BindingScopestring
SubjectKindstring
BrokerHoststring
GrantedScopes[]string
ExpiresAttime.Time
AudienceVerifiedbool
ActorAssertedbool

tool.failed ​

Payload ToolFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ToolNamestring
Transporttools.TransportKind
Attemptsint
ErrorClasstools.ErrorClass
ConfiguredBudgetintoptional (omitempty)
ErrorMessagestring
ScopeShortfall*tools.ScopeShortfallDetailoptional (omitempty)

tool.invalid_args ​

Payload ToolInvalidArgsPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ToolNamestring
Transporttools.TransportKind
ValidationErrorstring

tool.invoked ​

Payload ToolInvokedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ToolNamestring
Transporttools.TransportKind
StartedAttime.Time

tool.policy_exhausted ​

Payload ToolPolicyExhaustedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
ToolNamestring
Transporttools.TransportKind
Attemptsint
LastClasstools.ErrorClass
ConfiguredBudgetintoptional (omitempty)
LastErrorstring

tool.provider_credential_fetch_failed ​

Payload ProviderCredentialFetchFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Providerstring
Endpointstring
Reasonstring

tool.provider_credential_fetched ​

Payload ProviderCredentialFetchedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Providerstring
Endpointstring
FormatVersionint
ExpiresAttime.Time

tool.rejected ​

Payload ToolRejectedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Toolstring
PauseTokenstring
Reasonstring

topology.changed ​

Payload TopologyChangedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Projectiontypes.TopologyProjection — see TopologyProjection

trajectory.compressed ​

Payload TrajectoryCompressedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
StepsBeforeint
StepsAfterint
TokenEstimateint
OccurredAttime.Time

trajectory.compression_failed ​

Payload TrajectoryCompressionFailedPayload — safe payload (delivered typed, verbatim).

Wire keyGo typeNotes
Identityidentity.Quadruple
StepsObservedint
TokenEstimateint
ErrorCodestring
ErrorMessagestring
OccurredAttime.Time

Apache-2.0 licensed — see LICENSE.