Interface: ToolOverride

Defined in: observability/src/prod-control.ts:21

Production agent control surface. Devtools (#35) is dev-only; this is the auth-gated production counterpart that lets ops:

pause an agent loop
step a paused loop one iteration
inject tool overrides for the next call to a tool
snapshot the current state for support tickets
replay from a previously-captured snapshot

Designed as a transport-agnostic engine — the same ControlSurface sits behind an HTTP endpoint, an MCP server, or in-process tests. httpHandler() ships a bearer-token-gated REST surface so a default deployment is one createServer(handler) call.

Closes issue #784.

#Properties

#reason?

optional reason?: string

Defined in: observability/src/prod-control.ts:33

Audit note included in the snapshot + audit log.

#result

result: string

Defined in: observability/src/prod-control.ts:29

Forced result. The runtime should return this verbatim instead of running the tool's execute(). Single-shot — consumed by the first matching tool call after injection.

#status?

optional status?: "error" | "complete"

Defined in: observability/src/prod-control.ts:31

Optional: also mark the call status. Defaults to 'complete'.

#tool

tool: string

Defined in: observability/src/prod-control.ts:23

Tool to override on the next call.

Explore nearby

✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

ToolOverride