Graphorin API reference v0.1.0
Graphorin API reference / @graphorin/tools / / ExecutorOptions
Interface: ExecutorOptions
Defined in: packages/tools/src/executor/executor.ts:90
Options accepted by createToolExecutor.
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
approvalGate? | readonly | ApprovalGate | Approval gate — invoked when a tool's needsApproval resolves to true. | packages/tools/src/executor/executor.ts:97 |
cancellationGraceMs? | readonly | number | Hard-kill grace window (ms) for tools that ignore ctx.signal. Default 50. | packages/tools/src/executor/executor.ts:112 |
emitAudit? | readonly | (event) => void | Audit emitter override. Defaults to the global registry. | packages/tools/src/executor/executor.ts:95 |
imperativePatterns? | readonly | readonly ImperativePattern[] | Pluggable imperative patterns override. | packages/tools/src/executor/executor.ts:114 |
maxParallelTools? | readonly | number | Cap on parallel tool calls per batch. Defaults to 8. | packages/tools/src/executor/executor.ts:93 |
memoryGuardFactory? | readonly | (tier) => | MemoryModificationGuard | null | Optional memory-modification guard factory. Returns a MemoryModificationGuard per the tool's memoryGuardTier. The agent runtime supplies the implementation (createGuard(...) from @graphorin/security/guard); when absent, the guard step is skipped (audit-only baseline). | packages/tools/src/executor/executor.ts:138 |
memoryRegionReader? | readonly | MemoryRegionReader | Optional memory-region reader the guard uses to hash the pre/post snapshots. The agent runtime supplies the implementation (backed by the @graphorin/memory tier APIs). | packages/tools/src/executor/executor.ts:146 |
registry | readonly | ToolRegistry | - | packages/tools/src/executor/executor.ts:91 |
repair? | readonly | ToolRepairHook | Tool repair hook (single-round). | packages/tools/src/executor/executor.ts:99 |
sandboxResolver? | readonly | (policy) => Sandbox | null | Optional sandbox-dispatch resolver. Returns the Sandbox implementation to use for a given resolved policy, OR null to run the tool inline (the default for kind: 'none' policies). Skill loaders / agent runtimes inject this when sandbox-bundled code (skills, MCP-derived tools) needs out-of-process execution. | packages/tools/src/executor/executor.ts:130 |
secretResolver? | readonly | SecretResolverHook | Secrets resolver injected from the agent runtime. | packages/tools/src/executor/executor.ts:107 |
spill? | readonly | SpillWriter | Optional spill writer for the 'spill-to-file' truncation strategy. | packages/tools/src/executor/executor.ts:105 |
streamingEventQueueDepth? | readonly | number | Default streaming queue depth. Default 256. | packages/tools/src/executor/executor.ts:122 |
streamingSink? | readonly | (event) => void | Sink for tool execution events; the agent runtime forwards these into agent.stream(...). Receives every tool.execute.* variant emitted by the executor (start, progress, partial, end, error). | packages/tools/src/executor/executor.ts:120 |
summarizer? | readonly | ResultSummarizer | Optional summarizer for the 'summarize' truncation strategy. | packages/tools/src/executor/executor.ts:103 |
tokenCounter? | readonly | TokenCounter | Per-provider token counter used by the truncation pipeline. | packages/tools/src/executor/executor.ts:101 |