Graphorin API reference v0.15.1

Graphorin API reference / @graphorin/core / / ToolApproval

Interface: ToolApproval

Defined in: packages/core/src/types/tool.ts:297

Stable

Pending approval bookkeeping: a tool that needed human confirmation before execution. Stored on RunState.pendingApprovals until the caller resumes the run with a granted/denied decision.

Properties

Property	Modifier	Type	Description	Defined in
`args`	`readonly`	`unknown`	-	packages/core/src/types/tool.ts:300
`mode?`	`readonly`	`"ask"` \| `"defer"`	Which permission verdict parked this approval. `'ask'` wants an interactive human decision now; `'defer'` is parked for asynchronous resolution (e.g. a workflow awakeable with a durable-timer auto-deny) - the harness routes the two differently. Absent on approvals raised by a plain `needsApproval` gate (semantically `'ask'`).	packages/core/src/types/tool.ts:311
`reason?`	`readonly`	`string`	-	packages/core/src/types/tool.ts:301
`requestedAt`	`readonly`	`string`	-	packages/core/src/types/tool.ts:302
`subRunToolCallId?`	`readonly`	`string`	Set when this approval belongs to a PARKED sub-agent run. It is the PARENT's toolCallId of the parked handoff / sub-agent call (the `RunState.pendingSubRuns` key), never a child-local id. Operators echo it back on the matching `ApprovalDecision` so resume decisions match on the composite (toolCallId, subRunToolCallId) key - child-local toolCallIds of two different children may collide.	packages/core/src/types/tool.ts:321
`toolCallId`	`readonly`	`string`	-	packages/core/src/types/tool.ts:298
`toolName`	`readonly`	`string`	-	packages/core/src/types/tool.ts:299