--- url: >- https://adk.nht.io/api/@nhtio/adk/batteries/llm/claude_code_cli/wire/interfaces/WrapperRunCommand.md description: >- The one command `adapter.ts` sends per dispatch iteration, immediately after the wrapper's `ready` event arrives. Exactly one `run` command is accepted per wrapper process lifetime — the wrapper is spawned fresh per dispatch iteration, so there is no multi-run session. --- # Interface: WrapperRunCommand Defined in: [src/batteries/llm/claude\_code\_cli/wire.ts:56](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L56) The one command `adapter.ts` sends per dispatch iteration, immediately after the wrapper's `ready` event arrives. Exactly one `run` command is accepted per wrapper process lifetime — the wrapper is spawned fresh per dispatch iteration, so there is no multi-run session. ## Properties | Property | Type | Description | Defined in | | --------------------------------------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `addDir?` | `string`\[] | Additional directories to allow tool access to, forwarded to `--add-dir`. | [src/batteries/llm/claude\_code\_cli/wire.ts:68](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L68) | | `allowedTools` | `string`\[] | The exact MCP-bridged tool names the grandchild is allowed to call, ALREADY filtered by the adapter to exclude `disallowedTools`. Always sent, never omitted at this layer — the wrapper itself decides whether to emit `--allowedTools` (omitted entirely when this array is empty, since the flag is variadic and a bare `--allowedTools` with nothing after it would swallow the next argv token). | [src/batteries/llm/claude\_code\_cli/wire.ts:76](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L76) | | `appendSystemPrompt?` | `string` | Forwarded verbatim to `--append-system-prompt`, when set. | [src/batteries/llm/claude\_code\_cli/wire.ts:62](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L62) | | `auth?` | [`WrapperAuth`](WrapperAuth.md) | Explicit auth credential(s) for the grandchild's environment. | [src/batteries/llm/claude\_code\_cli/wire.ts:84](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L84) | | `bridgedTools` | [`WrapperBridgedTool`](WrapperBridgedTool.md)\[] | The JSON-Schema-rendered subset of `ctx.tools.visible()` the wrapper exposes over MCP, already pre-filtered to exclude `disallowedTools`. | [src/batteries/llm/claude\_code\_cli/wire.ts:104](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L104) | | `claudeBin` | `string` | Path to the `claude` binary to spawn. | [src/batteries/llm/claude\_code\_cli/wire.ts:94](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L94) | | `cwd?` | `string` | Working directory for the grandchild, forwarded to `--cwd`-equivalent spawn option. | [src/batteries/llm/claude\_code\_cli/wire.ts:66](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L66) | | `disableErrorReporting?` | `boolean` | Mapped to `DISABLE_ERROR_REPORTING` on the grandchild's env, never a CLI flag. | [src/batteries/llm/claude\_code\_cli/wire.ts:88](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L88) | | `disableNonessentialTraffic?` | `boolean` | Mapped to `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` on the grandchild's env, never a CLI flag. | [src/batteries/llm/claude\_code\_cli/wire.ts:90](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L90) | | `disableTelemetry?` | `boolean` | Mapped to `DISABLE_TELEMETRY` on the grandchild's env, never a CLI flag. | [src/batteries/llm/claude\_code\_cli/wire.ts:86](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L86) | | `extraArgs?` | [`ClaudeCodeCliExtraArg`](ClaudeCodeCliExtraArg.md)\[] | Pre-validated additional argv entries, appended after every constructed flag and before the `--` prompt separator. | [src/batteries/llm/claude\_code\_cli/wire.ts:106](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L106) | | `fallbackModel?` | `string`\[] | Forwarded to `--fallback-model` as one comma-joined value, never as separate argv tokens. | [src/batteries/llm/claude\_code\_cli/wire.ts:82](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L82) | | `forwardSubagentText?` | `boolean` | Forwarded to `--forward-subagent-text` when true. | [src/batteries/llm/claude\_code\_cli/wire.ts:96](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L96) | | `maxBudgetUsd?` | `number` | Forwarded to `--max-budget-usd`. | [src/batteries/llm/claude\_code\_cli/wire.ts:80](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L80) | | `maxTurns?` | `number` | Included only if a prior capability probe confirmed the running CLI supports `--max-turns`. | [src/batteries/llm/claude\_code\_cli/wire.ts:78](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L78) | | `mcpToolIdleTimeoutMs?` | `number` | Mapped to `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` on the grandchild's env, never a CLI flag. | [src/batteries/llm/claude\_code\_cli/wire.ts:92](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L92) | | `model?` | `string` | The model identifier, forwarded to `--model`. | [src/batteries/llm/claude\_code\_cli/wire.ts:64](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L64) | | `prompt` | `string` | The fully-rendered history, as one `-p` positional prompt string. | [src/batteries/llm/claude\_code\_cli/wire.ts:60](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L60) | | `type` | `"run"` | Discriminant for the [WrapperCommand](../type-aliases/WrapperCommand.md) union. | [src/batteries/llm/claude\_code\_cli/wire.ts:58](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L58) | | `unsupportedResultMediaPolicy` | `string` | Governs how the adapter rendered an ADK tool-result's unsupported `Media` kind (or oversized inline `SpooledArtifact`) into the outbound `WrapperToolCallResponseCommand` — informational only, since the adapter has already applied the policy before this command is sent. | [src/batteries/llm/claude\_code\_cli/wire.ts:102](https://github.com/NHTIO/ADK/blob/v1.20260827.0/src/src/batteries/llm/claude_code_cli/wire.ts#L102) |