Guides
Respond to an incident
Contain mutations, preserve evidence, recover, and close an incident.
Triage
- Assign an incident owner, severity, start time, affected business, and safe reason code.
- Correlate request, event, Run, State, effect, Integration, sandbox, model, and audit identifiers. Do not copy prompts, credentials, cookies, Tool arguments, or results into the incident record.
- Determine whether accepted durable work is safe to continue.
Contain
Use the deployment's durable kill-switch store to stop the narrowest affected mutation scope: Agent, Routine, Tool, provider, Integration, destination, model, data class, or all mutations. The effect dispatcher checks the switch before creating an attempt or calling an adapter. If switch state cannot be read, mutation dispatch fails closed.
Evidence: packages/tool-broker/src/effects/dispatch.test.ts
Do not bypass the Tool Broker, substitute another Credential, or fall back to unsandboxed execution. Preserve ambiguous effects for reconciliation.
Recover and close
- Verify the fault is removed and required capability checks pass.
- Reconcile ambiguous effects before retrying.
- Restore dispatch gradually and watch for recurrence.
- Verify the audit chain, record the recovery action, and perform a denied-access smoke check.
- Close with timeline, impact, evidence references, corrective actions, and an owner.
Evidence: packages/run-kernel/src/reconcile-state.test.ts