<!-- CODE GENERATED BY cmd/harbor-gen-protocol-docs. DO NOT EDIT. -->
Protocol events
The 108 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 the Go field names (e.g.
TaskID, capitalT). - 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.deregistered
Payload AgentDeregisteredPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
RegistrationKey | string | |
DeregisteredAt | int64 |
agent.drained
Payload AgentControlPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
Command | string | |
Reason | string | |
IssuedAt | int64 |
agent.force_stopped
Payload AgentControlPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
Command | string | |
Reason | string | |
IssuedAt | int64 |
agent.health
Payload AgentHealthPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
Health | string | |
ReportedAt | int64 |
agent.paused
Payload AgentControlPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
Command | string | |
Reason | string | |
IssuedAt | int64 |
agent.registered
Payload AgentRegisteredPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
RegistrationKey | string | |
Incarnation | uint64 | |
VersionHash | string | |
Hosting | string | |
RegisteredAt | int64 |
agent.restart_requested
Payload AgentControlPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
Command | string | |
Reason | string | |
IssuedAt | int64 |
agent.restarted
Payload AgentRestartedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
AgentID | string | |
RegistrationKey | string | |
Incarnation | uint64 | |
VersionHash | string | |
VersionHashChanged | bool | |
RestartedAt | int64 |
artifacts.deleted
Payload ArtifactDeletedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
ArtifactID | string |
artifacts.uploaded
Payload ArtifactUploadedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
ArtifactID | string | |
MimeType | string | |
SizeBytes | int64 | |
Source | string | |
Namespace | string |
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 key | Go type | Notes |
|---|---|---|
Tenant | string | |
User | string | |
Session | string | |
SubscriberID | uint64 |
Payload AdminScopeUsedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Actor | auth.IdentityTriple | |
Requester | auth.IdentityTriple | |
Impersonating | auth.IdentityTriple | |
Reason | string | |
Method | string |
audit.redaction_failed
Payload AuditRedactionFailedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
OriginalType | events.EventType | |
Reason | string |
auth.rejected
Payload AuthRejectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Reason | string | |
KID | string | |
Issuer | string | |
Subject | string |
bus.dropped
Payload BusDroppedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
FromSeq | uint64 | |
ToSeq | uint64 | |
DroppedCount | uint64 | |
SubscriberID | uint64 |
bus.subscription_idle_closed
Payload SubscriptionIdleClosedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
SubscriberID | uint64 | |
IdleSeconds | float64 |
control.applied
Payload ControlLifecyclePayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Type | string | |
Outcome | string | |
Err | string |
control.received
Payload ControlLifecyclePayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Type | string | |
Outcome | string | |
Err | string |
control.rejected
Payload ControlRejectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Type | string | |
Reason | string | |
CallerScope | string |
dev.draft.created
Payload DraftCreatedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
DraftID | string | |
Template | string | |
FileCount | int |
dev.draft.discarded
Payload DraftDiscardedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
DraftID | string |
dev.draft.previewed
Payload DraftPreviewedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
DraftID | string | |
OK | bool |
dev.draft.saved
Payload DraftSavedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
DraftID | string | |
OutputDir | string | |
FileCount | int |
dev.draft.updated
Payload DraftUpdatedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
DraftID | string | |
Path | string | |
Size | int |
distributed.bus_envelope
Payload BusEnvelopePayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Envelope | distributed.BusEnvelope |
flow.budget_exceeded
Payload BudgetExceededPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
FlowName | string | |
Axis | string |
flows.page_viewed
Payload FlowsPageViewedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Method | string | |
FlowID | string | |
AdminScoped | bool |
flows.run_invoked
Payload FlowsRunInvokedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
FlowID | string | |
RunID | string |
governance.budget_exceeded
Payload BudgetExceededPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Tier | string | |
Model | string | |
TotalCost | float64 | |
Ceiling | float64 | |
Currency | string | |
OccurredAt | time.Time |
governance.maxtokens_exceeded
Payload MaxTokensExceededPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Tier | string | |
Model | string | |
Requested | int | |
Cap | int | |
OccurredAt | time.Time |
governance.posture_read_admin
Payload PostureReadAdminPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Actor | identity.Quadruple | |
RequestedTenant | string | |
OccurredAt | time.Time |
governance.rate_limited
Payload RateLimitedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Tier | string | |
Model | string | |
Requested | int | |
Available | int | |
Capacity | int | |
RefillTokens | int | |
RefillEvery | time.Duration | |
OccurredAt | time.Time |
llm.completion.chunk
Payload CompletionChunkPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
TaskID | string | |
RunID | string | |
Delta | string | |
Done | bool | |
Kind | string | |
OccurredAt | time.Time |
llm.context_leak
Payload ContextLeakPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Model | string | |
LeakSite | string | |
SizeBytes | int64 | |
Threshold | int | |
OccurredAt | time.Time |
llm.context_window_exceeded
Payload ContextWindowExceededPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Model | string | |
EstimatedTokens | int | |
ContextWindowTokens | int | |
ContextWindowReserve | float64 | |
OccurredAt | time.Time |
llm.cost.recorded
Payload CostRecordedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Model | string | |
Cost | llm.Cost | |
Usage | llm.Usage | |
ContextWindowTokens | int | |
OccurredAt | time.Time |
llm.image.materialized
Payload ImageMaterializedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Model | string | |
ArtifactRef | string | |
MIME | string | |
SizeBytes | int64 | |
OccurredAt | time.Time |
llm.mode_downgraded
Payload ModeDowngradedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Model | string | |
FromMode | llm.OutputMode | |
ToMode | llm.OutputMode | |
From | llm.ResponseFormatKind | |
To | llm.ResponseFormatKind | |
Reason | string | |
OccurredAt | time.Time |
llm.posture_read_admin
Payload PostureReadAdminPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Actor | identity.Quadruple | |
RequestedTenant | string |
llm.provider_file.uploaded
Payload ProviderFileUploadedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Provider | string | |
Model | string | |
ArtifactRef | string | |
MIME | string | |
Modality | string | |
FileID | string | |
SizeBytes | int64 | |
OccurredAt | time.Time |
llm.retry_with_feedback
Payload RetryWithFeedbackPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Model | string | |
Attempt | int | |
MaxRetries | int | |
Reason | string | |
OccurredAt | time.Time |
mcp.app_available
Payload AppAvailablePayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ServerID | tools.ToolSourceID | |
ToolCallID | string | |
ToolName | string | |
ResourceURI | string | |
DisplayMode | string | |
RawHTMLTrusted | bool | |
OccurredAt | time.Time |
mcp.raw_html_trust_toggled
Payload MCPRawHTMLTrustToggledPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Actor | identity.Quadruple | |
ServerName | string | |
Trusted | bool | |
OccurredAt | time.Time |
mcp.resource_offloaded
Payload ResourceOffloadedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ArtifactID | string | |
Source | string | |
SizeBytes | int64 | |
OccurredAt | time.Time |
mcp.resource_updated
Payload ResourceUpdatedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Source | tools.ToolSourceID | |
URI | string | |
OccurredAt | time.Time |
memory.health_changed
Payload HealthChangedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
PriorHealth | memory.Health | |
NewHealth | memory.Health | |
Reason | string |
memory.identity_rejected
Payload MemoryIdentityRejectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Operation | string | |
Reason | string |
memory.item_deleted
Payload MemoryMutationPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Operation | string | |
Key | string |
memory.item_put
Payload MemoryMutationPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Operation | string | |
Key | string |
memory.recovery_dropped
Payload RecoveryDroppedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Reason | string |
notification.auth_required
Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Class | events.EventType | |
Severity | notifications.Severity | |
Summary | string | |
DeepLink | string | |
OriginEventType | events.EventType | |
OriginEventSequence | uint64 |
notification.governance_budget_exceeded
Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Class | events.EventType | |
Severity | notifications.Severity | |
Summary | string | |
DeepLink | string | |
OriginEventType | events.EventType | |
OriginEventSequence | uint64 |
notification.identity_rejected
Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Class | events.EventType | |
Severity | notifications.Severity | |
Summary | string | |
DeepLink | string | |
OriginEventType | events.EventType | |
OriginEventSequence | uint64 |
notification.pause_requested
Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Class | events.EventType | |
Severity | notifications.Severity | |
Summary | string | |
DeepLink | string | |
OriginEventType | events.EventType | |
OriginEventSequence | uint64 |
notification.task_failed
Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Class | events.EventType | |
Severity | notifications.Severity | |
Summary | string | |
DeepLink | string | |
OriginEventType | events.EventType | |
OriginEventSequence | uint64 |
notification.tool_approval_requested
Payload NotificationPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Class | events.EventType | |
Severity | notifications.Severity | |
Summary | string | |
DeepLink | string | |
OriginEventType | events.EventType | |
OriginEventSequence | uint64 |
pause.payload_artifact_routed
Payload PausePayloadArtifactRoutedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Token | string | |
ArtifactID | string | |
PayloadBytes | int | |
ThresholdBytes | int |
pause.requested
Payload PauseRequestedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Token | string | |
Reason | string |
pause.resumed
Payload PauseResumedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Token | string | |
Reason | string | |
Decision | pauseresume.Decision |
planner.action_extra_field_dropped
Payload ActionExtraFieldDroppedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Field | string | |
OccurredAt | time.Time |
planner.decision
Payload DecisionPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
DecisionKind | string | |
Tool | string | |
ReasoningChars | int | |
ReasoningTrace | string | |
OccurredAt | time.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 key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
MaxSteps | int | |
StepsObserved | int | |
LastTool | string | |
OccurredAt | time.Time |
planner.repair_exhausted
Payload RepairExhaustedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Attempts | int | |
ConsecutiveArgFailures | int | |
Reasons | []string | |
OccurredAt | time.Time |
planner.repair_guidance_injected
Payload RepairGuidanceInjectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
Tier | string | |
Counter | string | |
Count | int | |
OccurredAt | time.Time |
runs.overrides_set
Payload RunOverridesSetPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Actor | identity.Quadruple | |
SessionID | string | |
SetReasoningEffort | bool | |
SetTemperature | bool | |
SetMaxTokens | bool | |
SetSystemPrompt | bool | |
OccurredAt | time.Time |
runtime.error
Payload RuntimeErrorPayload — redacted on the wire (audit-redactor walk; subscribers receive a redacted map).
| Wire key | Go type | Notes |
|---|---|---|
Message | string | |
Fields | map[string]any |
runtime.run_cancelled
Payload RunCancelledPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
RunID | string | |
CancelledAt | int64 | |
DroppedEnvelopeCount | int64 |
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 key | Go type | Notes |
|---|---|---|
SessionID | string | |
ClosedAt | int64 | |
Reason | string |
session.gc_reaped
Payload SessionGCReapedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
SessionID | string | |
ReapedAt | int64 | |
Reason | string |
session.opened
Payload SessionOpenedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
SessionID | string | |
OpenedAt | int64 |
session.touched
Payload SessionTouchedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
SessionID | string | |
LastSeen | int64 |
skill.deleted
Payload SkillDeletedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Name | string |
skill.identity_rejected
Payload SkillIdentityRejectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Operation | string | |
Reason | string |
skill.pack_overwrite_refused
Payload SkillPackOverwriteRefusedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Name | string | |
ExistingOrigin | skills.Origin | |
IncomingOrigin | skills.Origin |
skill.proposed
Payload SkillProposedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Name | string | |
Origin | skills.Origin | |
Scope | skills.Scope | |
OriginRef | string | |
ContentHash | string | |
Result | string | |
Reason | string | |
RedactedTitleExcerpt | string | |
RedactedTriggerExcerpt | string | |
Promotion | bool |
skill.search_executed
Payload SkillSearchExecutedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
QueryHash | string | |
Path | string | |
Limit | int | |
ResultN | int |
skill.upserted
Payload SkillUpsertedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Name | string | |
Origin | skills.Origin | |
Scope | skills.Scope | |
ContentHash | string | |
Idempotent | bool |
task.background_acknowledged
Payload TaskBackgroundAcknowledgedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID |
task.cancelled
Payload TaskCancelledPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID | |
Reason | string | |
Cascaded | bool |
task.completed
Payload TaskCompletedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID |
task.failed
Payload TaskFailedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID | |
ErrorCode | string |
task.group_cancelled
Payload TaskGroupCancelledPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Completion | tasks.GroupCompletion |
task.group_created
Payload TaskGroupCreatedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
GroupID | tasks.TaskGroupID | |
OwnerTaskID | tasks.TaskID | |
RetainTurn | bool | |
FailFast | bool | |
Description | string |
task.group_resolved
Payload TaskGroupResolvedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Completion | tasks.GroupCompletion |
task.group_sealed
Payload TaskGroupSealedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
GroupID | tasks.TaskGroupID | |
Members | []tasks.TaskID | |
SealedAt | int64 |
task.input_disposition.resolved
Payload InputDispositionResolvedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
TaskID | string | |
ArtifactID | string | |
MIME | string | |
Disposition | string | |
Layer | string | |
Degraded | bool | |
DegradedFrom | string | |
DegradationReason | string | |
Tool | string | |
OccurredAt | time.Time |
task.patch_applied
Payload TaskPatchAppliedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
PatchID | string |
task.patch_rejected
Payload TaskPatchRejectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
PatchID | string |
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 key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID |
task.prioritised
Payload TaskPrioritisedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID | |
PriorPriority | int | |
NewPriority | int |
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 key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID |
task.spawned
Payload TaskSpawnedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID | |
Kind | tasks.TaskKind | |
ParentTaskID | tasks.TaskID | |
Priority | int | |
IdempotencyKey | string |
task.started
Payload TaskStartedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
TaskID | tasks.TaskID | |
PriorState | tasks.TaskStatus |
tool.approval_requested
Payload ToolApprovalRequestedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Tool | string | |
PauseToken | string | |
Reason | string | |
Tags | []string | |
ArgsSummary | any |
tool.approved
Payload ToolApprovedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Tool | string | |
PauseToken | string | |
ApproverReason | string |
tool.auth_completed
Payload ToolAuthCompletedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Source | string | |
BindingScope | string | |
State | string | |
PauseToken | string |
tool.auth_required
Payload ToolAuthRequiredPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Source | string | |
SourceName | string | |
BindingScope | string | |
AuthorizeURL | string | |
State | string | |
PauseToken | string | |
Scopes | []string |
tool.completed
Payload ToolCompletedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ToolName | string | |
Transport | tools.TransportKind | |
Attempts | int | |
DurationMS | int64 |
tool.failed
Payload ToolFailedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ToolName | string | |
Transport | tools.TransportKind | |
Attempts | int | |
ErrorClass | tools.ErrorClass | |
ErrorMessage | string |
tool.invalid_args
Payload ToolInvalidArgsPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ToolName | string | |
Transport | tools.TransportKind | |
ValidationError | string |
tool.invoked
Payload ToolInvokedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ToolName | string | |
Transport | tools.TransportKind | |
StartedAt | time.Time |
tool.policy_exhausted
Payload ToolPolicyExhaustedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
ToolName | string | |
Transport | tools.TransportKind | |
Attempts | int | |
LastClass | tools.ErrorClass | |
LastError | string |
tool.rejected
Payload ToolRejectedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Tool | string | |
PauseToken | string | |
Reason | string |
topology.changed
Payload TopologyChangedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Projection | types.TopologyProjection — see TopologyProjection |
trajectory.compressed
Payload TrajectoryCompressedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
StepsBefore | int | |
StepsAfter | int | |
TokenEstimate | int | |
OccurredAt | time.Time |
trajectory.compression_failed
Payload TrajectoryCompressionFailedPayload — safe payload (delivered typed, verbatim).
| Wire key | Go type | Notes |
|---|---|---|
Identity | identity.Quadruple | |
StepsObserved | int | |
TokenEstimate | int | |
ErrorCode | string | |
ErrorMessage | string | |
OccurredAt | time.Time |