@leo000001/claude-code-mcp 1.7.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/CHANGELOG.md +1 -0
  2. package/README.md +110 -110
  3. package/dist/index.js +95 -147
  4. package/dist/index.js.map +1 -1
  5. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -10,6 +10,7 @@
10
10
  - `claude_code`: 22 low-frequency params moved into `advanced` object (e.g. `effort` → `advanced.effort`, `tools` → `advanced.tools`, `agents` → `advanced.agents`, `env` → `advanced.env`)
11
11
  - `claude_code_reply`: 28 disk-resume params moved into `diskResumeConfig` object (e.g. `resumeToken` → `diskResumeConfig.resumeToken`, `cwd` → `diskResumeConfig.cwd`)
12
12
  - `claude_code_check`: 9 poll control params moved into `pollOptions` object (e.g. `includeTools` → `pollOptions.includeTools`); 2 permission response params moved into `permissionOptions` object (e.g. `updatedInput` → `permissionOptions.updatedInput`)
13
+ - Schema descriptions for nested object fields have been compacted (self-explanatory fields no longer carry `.describe()` text; object-level descriptions enhanced as summaries) to reduce token overhead for calling models
13
14
 
14
15
  ### Features
15
16
  - New module: `src/tools/query-consumer.ts` — shared background query consumer (`consumeQuery`) for start, resume, and disk-resume code paths
package/README.md CHANGED
@@ -88,45 +88,45 @@ npm start
88
88
 
89
89
  Start a new Claude Code session. The agent autonomously performs coding tasks: reading/writing files, running shell commands, searching code, managing git, and interacting with APIs.
90
90
 
91
- | Parameter | Type | Required | Description |
92
- | ---------------------------- | ------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
93
- | `prompt` | string | Yes | Task or question for Claude Code |
94
- | `cwd` | string | No | Working directory (defaults to server cwd) |
95
- | `allowedTools` | string[] | No | Auto-approved tool names. Default: `[]` (none). Tools not in `allowedTools`/`disallowedTools` may surface permission requests via `claude_code_check`. Example: `["Bash", "Read", "Write", "Edit"]` |
96
- | `disallowedTools` | string[] | No | Forbidden tool names. Default: `[]` (none). SDK behavior: disallowed tools are removed from the model's context. Takes precedence over `allowedTools` and will be denied even if later approved interactively |
97
- | `maxTurns` | number | No | Maximum number of agent reasoning steps. Each step may involve one or more tool calls. Default: SDK/Claude Code default |
98
- | `model` | string | No | Model to use (e.g. `"claude-sonnet-4-5-20250929"`). Default: SDK/Claude Code default |
99
- | `systemPrompt` | string \| object | No | Override the agent's system prompt. Default: SDK/Claude Code default. Pass a string for full replacement, or `{ type: "preset", preset: "claude_code", append?: "..." }` to extend the default prompt |
100
- | `permissionRequestTimeoutMs` | number | No | Timeout in milliseconds waiting for permission decisions. Default: `60000` |
101
- | `advanced` | object | No | Advanced/low-frequency parameters (see below) |
91
+ | Parameter | Type | Required | Description |
92
+ | ---------------------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
93
+ | `prompt` | string | Yes | Task or question for Claude Code |
94
+ | `cwd` | string | No | Working directory (defaults to server cwd) |
95
+ | `allowedTools` | string[] | No | Auto-approved tool names. Default: `[]` (none). Tools not in `allowedTools`/`disallowedTools` may surface permission requests via `claude_code_check`. Example: `["Bash", "Read", "Write", "Edit"]` |
96
+ | `disallowedTools` | string[] | No | Forbidden tool names. Default: `[]` (none). SDK behavior: disallowed tools are removed from the model's context. Takes precedence over `allowedTools` and will be denied even if later approved interactively |
97
+ | `maxTurns` | number | No | Maximum number of agent reasoning steps. Each step may involve one or more tool calls. Default: SDK/Claude Code default |
98
+ | `model` | string | No | Model to use (e.g. `"claude-sonnet-4-5-20250929"`). Default: SDK/Claude Code default |
99
+ | `systemPrompt` | string \| object | No | Override the agent's system prompt. Default: SDK/Claude Code default. Pass a string for full replacement, or `{ type: "preset", preset: "claude_code", append?: "..." }` to extend the default prompt |
100
+ | `permissionRequestTimeoutMs` | number | No | Timeout in milliseconds waiting for permission decisions. Default: `60000` |
101
+ | `advanced` | object | No | Advanced/low-frequency parameters (see below) |
102
102
 
103
103
  <details>
104
104
  <summary><code>advanced</code> object parameters (22 low-frequency parameters)</summary>
105
105
 
106
- | Parameter | Type | Description |
107
- | ---------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
108
- | `advanced.tools` | string[] \| object | Define the base tool set. Default: SDK/Claude Code default toolset. Array of tool name strings, or `{ type: "preset", preset: "claude_code" }` for the default toolset. `allowedTools`/`disallowedTools` further filter on top of this |
109
- | `advanced.persistSession` | boolean | Persist session history to disk (`~/.claude/projects/`). Default: `true`. Set `false` to disable. |
110
- | `advanced.sessionInitTimeoutMs` | number | Timeout in milliseconds waiting for `system/init`. Default: `10000` |
111
- | `advanced.agents` | object | Define custom sub-agents the main agent can delegate tasks to. Default: none. SDK default: if a sub-agent omits `tools`, it inherits all tools from the parent. |
112
- | `advanced.agent` | string | Name of a custom agent (defined in `agents`) to use as the primary agent. Default: omitted |
113
- | `advanced.maxBudgetUsd` | number | Maximum budget in USD. Default: SDK/Claude Code default |
114
- | `advanced.effort` | string | Effort level: `"low"`, `"medium"`, `"high"`, `"max"`. Default: SDK/Claude Code default |
115
- | `advanced.betas` | string[] | Beta features (e.g. `["context-1m-2025-08-07"]`). Default: none |
116
- | `advanced.additionalDirectories` | string[] | Additional directories the agent can access beyond cwd. Default: none |
117
- | `advanced.outputFormat` | object | Structured output: `{ type: "json_schema", schema: {...} }`. Default: omitted (plain text) |
118
- | `advanced.thinking` | object | Thinking mode: `{ type: "adaptive" }`, `{ type: "enabled", budgetTokens: N }`, or `{ type: "disabled" }`. Default: SDK/Claude Code default |
119
- | `advanced.pathToClaudeCodeExecutable` | string | Path to the Claude Code executable. Default: SDK-bundled Claude Code (cli.js) |
120
- | `advanced.mcpServers` | object | MCP server configurations (key: server name, value: server config). Default: none |
121
- | `advanced.sandbox` | object | Sandbox configuration for isolating shell command execution (e.g., Docker container settings). Default: SDK/Claude Code default |
122
- | `advanced.fallbackModel` | string | Fallback model if the primary model fails or is unavailable. Default: none |
123
- | `advanced.enableFileCheckpointing` | boolean | Enable file checkpointing to track file changes during the session. Default: `false` |
124
- | `advanced.includePartialMessages` | boolean | When true, includes intermediate streaming messages in the response. Useful for real-time progress monitoring. Default: false |
125
- | `advanced.strictMcpConfig` | boolean | Enforce strict validation of MCP server configurations. Default: `false` |
126
- | `advanced.settingSources` | string[] | Which filesystem settings to load. Defaults to `["user", "project", "local"]` (loads all settings and CLAUDE.md). Pass `[]` for SDK isolation mode |
127
- | `advanced.debug` | boolean | Enable debug mode for verbose logging. Default: `false` |
128
- | `advanced.debugFile` | string | Write debug logs to a specific file path (implicitly enables debug mode). Default: omitted |
129
- | `advanced.env` | object | Environment variables to merge with process.env and pass to the Claude Code process (user values take precedence). Default: inherit process.env |
106
+ | Parameter | Type | Description |
107
+ | ------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
108
+ | `advanced.tools` | string[] \| object | Define the base tool set. Default: SDK/Claude Code default toolset. Array of tool name strings, or `{ type: "preset", preset: "claude_code" }` for the default toolset. `allowedTools`/`disallowedTools` further filter on top of this |
109
+ | `advanced.persistSession` | boolean | Persist session history to disk (`~/.claude/projects/`). Default: `true`. Set `false` to disable. |
110
+ | `advanced.sessionInitTimeoutMs` | number | Timeout in milliseconds waiting for `system/init`. Default: `10000` |
111
+ | `advanced.agents` | object | Define custom sub-agents the main agent can delegate tasks to. Default: none. SDK default: if a sub-agent omits `tools`, it inherits all tools from the parent. |
112
+ | `advanced.agent` | string | Name of a custom agent (defined in `agents`) to use as the primary agent. Default: omitted |
113
+ | `advanced.maxBudgetUsd` | number | Maximum budget in USD. Default: SDK/Claude Code default |
114
+ | `advanced.effort` | string | Effort level: `"low"`, `"medium"`, `"high"`, `"max"`. Default: SDK/Claude Code default |
115
+ | `advanced.betas` | string[] | Beta features (e.g. `["context-1m-2025-08-07"]`). Default: none |
116
+ | `advanced.additionalDirectories` | string[] | Additional directories the agent can access beyond cwd. Default: none |
117
+ | `advanced.outputFormat` | object | Structured output: `{ type: "json_schema", schema: {...} }`. Default: omitted (plain text) |
118
+ | `advanced.thinking` | object | Thinking mode: `{ type: "adaptive" }`, `{ type: "enabled", budgetTokens: N }`, or `{ type: "disabled" }`. Default: SDK/Claude Code default |
119
+ | `advanced.pathToClaudeCodeExecutable` | string | Path to the Claude Code executable. Default: SDK-bundled Claude Code (cli.js) |
120
+ | `advanced.mcpServers` | object | MCP server configurations (key: server name, value: server config). Default: none |
121
+ | `advanced.sandbox` | object | Sandbox configuration for isolating shell command execution (e.g., Docker container settings). Default: SDK/Claude Code default |
122
+ | `advanced.fallbackModel` | string | Fallback model if the primary model fails or is unavailable. Default: none |
123
+ | `advanced.enableFileCheckpointing` | boolean | Enable file checkpointing to track file changes during the session. Default: `false` |
124
+ | `advanced.includePartialMessages` | boolean | When true, includes intermediate streaming messages in the response. Useful for real-time progress monitoring. Default: false |
125
+ | `advanced.strictMcpConfig` | boolean | Enforce strict validation of MCP server configurations. Default: `false` |
126
+ | `advanced.settingSources` | string[] | Which filesystem settings to load. Defaults to `["user", "project", "local"]` (loads all settings and CLAUDE.md). Pass `[]` for SDK isolation mode |
127
+ | `advanced.debug` | boolean | Enable debug mode for verbose logging. Default: `false` |
128
+ | `advanced.debugFile` | string | Write debug logs to a specific file path (implicitly enables debug mode). Default: omitted |
129
+ | `advanced.env` | object | Environment variables to merge with process.env and pass to the Claude Code process (user values take precedence). Default: inherit process.env |
130
130
 
131
131
  </details>
132
132
 
@@ -147,49 +147,49 @@ Use `claude_code_check` to poll events and obtain the final `result`.
147
147
 
148
148
  Continue an existing session by sending a follow-up message. The agent retains full context from previous turns including files read, code analysis, and conversation history.
149
149
 
150
- | Parameter | Type | Required | Description |
151
- | ---------------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
152
- | `sessionId` | string | Yes | Session ID from a previous `claude_code` call |
153
- | `prompt` | string | Yes | Follow-up prompt |
154
- | `forkSession` | boolean | No | Create a branched copy of this session. Default: `false` |
155
- | `permissionRequestTimeoutMs` | number | No | Timeout in milliseconds waiting for permission decisions. Default: `60000` |
156
- | `sessionInitTimeoutMs` | number | No | Timeout in milliseconds waiting for fork `system/init`. Default: `10000` |
150
+ | Parameter | Type | Required | Description |
151
+ | ---------------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
152
+ | `sessionId` | string | Yes | Session ID from a previous `claude_code` call |
153
+ | `prompt` | string | Yes | Follow-up prompt |
154
+ | `forkSession` | boolean | No | Create a branched copy of this session. Default: `false` |
155
+ | `permissionRequestTimeoutMs` | number | No | Timeout in milliseconds waiting for permission decisions. Default: `60000` |
156
+ | `sessionInitTimeoutMs` | number | No | Timeout in milliseconds waiting for fork `system/init`. Default: `10000` |
157
157
  | `diskResumeConfig` | object | No | Disk resume parameters (see below). Used when `CLAUDE_CODE_MCP_ALLOW_DISK_RESUME=1` and in-memory session is missing |
158
158
 
159
159
  <details>
160
160
  <summary><code>diskResumeConfig</code> object parameters (28 disk-resume-only parameters)</summary>
161
161
 
162
- | Parameter | Type | Description |
163
- | -------------------------------------------- | ------------------ | --------------------------------------------------- |
164
- | `diskResumeConfig.resumeToken` | string | Resume token returned by `claude_code` / `claude_code_reply`. Required for disk resume fallback |
165
- | `diskResumeConfig.cwd` | string | Working directory. Required for disk resume. |
166
- | `diskResumeConfig.allowedTools` | string[] | Auto-approved tool names (see `claude_code`). Default: `[]` |
167
- | `diskResumeConfig.disallowedTools` | string[] | Forbidden tool names (see `claude_code`). Default: `[]` |
168
- | `diskResumeConfig.tools` | string[] \| object | Base tool set (see `claude_code`). Default: SDK/Claude Code default |
169
- | `diskResumeConfig.persistSession` | boolean | Persist session history to disk. Default: `true` |
170
- | `diskResumeConfig.maxTurns` | number | Maximum number of agent reasoning steps. Default: SDK/Claude Code default |
171
- | `diskResumeConfig.model` | string | Model to use. Default: SDK/Claude Code default |
172
- | `diskResumeConfig.systemPrompt` | string \| object | Override the agent's system prompt. Default: SDK/Claude Code default |
173
- | `diskResumeConfig.agents` | object | Custom sub-agent definitions (see `claude_code`). Default: none |
174
- | `diskResumeConfig.agent` | string | Primary agent name (see `claude_code` tool). Default: omitted |
175
- | `diskResumeConfig.maxBudgetUsd` | number | Maximum budget in USD. Default: SDK/Claude Code default |
176
- | `diskResumeConfig.effort` | string | Effort level. Default: SDK/Claude Code default |
177
- | `diskResumeConfig.betas` | string[] | Beta features. Default: none |
178
- | `diskResumeConfig.additionalDirectories` | string[] | Additional directories. Default: none |
179
- | `diskResumeConfig.outputFormat` | object | Structured output format. Default: omitted (plain text) |
180
- | `diskResumeConfig.thinking` | object | Thinking mode. Default: SDK/Claude Code default |
181
- | `diskResumeConfig.resumeSessionAt` | string | Resume only up to and including a specific message UUID. Default: omitted |
182
- | `diskResumeConfig.pathToClaudeCodeExecutable` | string | Path to Claude Code executable. Default: SDK-bundled Claude Code (cli.js) |
183
- | `diskResumeConfig.mcpServers` | object | MCP server configurations. Default: none |
184
- | `diskResumeConfig.sandbox` | object | Sandbox config for command isolation. Default: SDK/Claude Code default |
185
- | `diskResumeConfig.fallbackModel` | string | Fallback model. Default: none |
186
- | `diskResumeConfig.enableFileCheckpointing` | boolean | Enable file checkpointing. Default: `false` |
187
- | `diskResumeConfig.includePartialMessages` | boolean | Include intermediate streaming messages. Default: `false` |
188
- | `diskResumeConfig.strictMcpConfig` | boolean | Strict MCP config validation. Default: `false` |
189
- | `diskResumeConfig.settingSources` | string[] | Which filesystem settings to load. Default: `["user", "project", "local"]` |
190
- | `diskResumeConfig.debug` | boolean | Debug mode. Default: `false` |
191
- | `diskResumeConfig.debugFile` | string | Debug log file path. Default: omitted |
192
- | `diskResumeConfig.env` | object | Environment variables. Default: inherit process.env (user values override) |
162
+ | Parameter | Type | Description |
163
+ | --------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------- |
164
+ | `diskResumeConfig.resumeToken` | string | Resume token returned by `claude_code` / `claude_code_reply`. Required for disk resume fallback |
165
+ | `diskResumeConfig.cwd` | string | Working directory. Required for disk resume. |
166
+ | `diskResumeConfig.allowedTools` | string[] | Auto-approved tool names (see `claude_code`). Default: `[]` |
167
+ | `diskResumeConfig.disallowedTools` | string[] | Forbidden tool names (see `claude_code`). Default: `[]` |
168
+ | `diskResumeConfig.tools` | string[] \| object | Base tool set (see `claude_code`). Default: SDK/Claude Code default |
169
+ | `diskResumeConfig.persistSession` | boolean | Persist session history to disk. Default: `true` |
170
+ | `diskResumeConfig.maxTurns` | number | Maximum number of agent reasoning steps. Default: SDK/Claude Code default |
171
+ | `diskResumeConfig.model` | string | Model to use. Default: SDK/Claude Code default |
172
+ | `diskResumeConfig.systemPrompt` | string \| object | Override the agent's system prompt. Default: SDK/Claude Code default |
173
+ | `diskResumeConfig.agents` | object | Custom sub-agent definitions (see `claude_code`). Default: none |
174
+ | `diskResumeConfig.agent` | string | Primary agent name (see `claude_code` tool). Default: omitted |
175
+ | `diskResumeConfig.maxBudgetUsd` | number | Maximum budget in USD. Default: SDK/Claude Code default |
176
+ | `diskResumeConfig.effort` | string | Effort level. Default: SDK/Claude Code default |
177
+ | `diskResumeConfig.betas` | string[] | Beta features. Default: none |
178
+ | `diskResumeConfig.additionalDirectories` | string[] | Additional directories. Default: none |
179
+ | `diskResumeConfig.outputFormat` | object | Structured output format. Default: omitted (plain text) |
180
+ | `diskResumeConfig.thinking` | object | Thinking mode. Default: SDK/Claude Code default |
181
+ | `diskResumeConfig.resumeSessionAt` | string | Resume only up to and including a specific message UUID. Default: omitted |
182
+ | `diskResumeConfig.pathToClaudeCodeExecutable` | string | Path to Claude Code executable. Default: SDK-bundled Claude Code (cli.js) |
183
+ | `diskResumeConfig.mcpServers` | object | MCP server configurations. Default: none |
184
+ | `diskResumeConfig.sandbox` | object | Sandbox config for command isolation. Default: SDK/Claude Code default |
185
+ | `diskResumeConfig.fallbackModel` | string | Fallback model. Default: none |
186
+ | `diskResumeConfig.enableFileCheckpointing` | boolean | Enable file checkpointing. Default: `false` |
187
+ | `diskResumeConfig.includePartialMessages` | boolean | Include intermediate streaming messages. Default: `false` |
188
+ | `diskResumeConfig.strictMcpConfig` | boolean | Strict MCP config validation. Default: `false` |
189
+ | `diskResumeConfig.settingSources` | string[] | Which filesystem settings to load. Default: `["user", "project", "local"]` |
190
+ | `diskResumeConfig.debug` | boolean | Debug mode. Default: `false` |
191
+ | `diskResumeConfig.debugFile` | string | Debug log file path. Default: omitted |
192
+ | `diskResumeConfig.env` | object | Environment variables. Default: inherit process.env (user values override) |
193
193
 
194
194
  </details>
195
195
 
@@ -207,10 +207,10 @@ Use `claude_code_check` to poll events and obtain the final `result`.
207
207
 
208
208
  List, inspect, or cancel sessions.
209
209
 
210
- | Parameter | Type | Required | Description |
211
- | ------------------ | ------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
212
- | `action` | string | Yes | `"list"`, `"get"`, or `"cancel"` |
213
- | `sessionId` | string | For get/cancel | Target session ID |
210
+ | Parameter | Type | Required | Description |
211
+ | ------------------ | ------- | -------------- | ------------------------------------------------------------------------------ |
212
+ | `action` | string | Yes | `"list"`, `"get"`, or `"cancel"` |
213
+ | `sessionId` | string | For get/cancel | Target session ID |
214
214
  | `includeSensitive` | boolean | No | Include `cwd`/`systemPrompt`/`agents`/`additionalDirectories` (default: false) |
215
215
 
216
216
  **Returns:** `{ sessions, message?, isError? }`
@@ -219,44 +219,44 @@ List, inspect, or cancel sessions.
219
219
 
220
220
  Poll session events/results and approve/deny pending permission requests.
221
221
 
222
- | Parameter | Type | Required | Description |
223
- | ------------------------- | ------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
224
- | `action` | string | Yes | `"poll"` or `"respond_permission"` |
225
- | `sessionId` | string | Yes | Target session ID |
226
- | `cursor` | number | No | Event cursor for incremental polling (`poll` only). Default: omitted (starts from the beginning of the buffer) |
227
- | `responseMode` | string | No | `"minimal"` (default) or `"full"` — controls payload size and redaction behavior |
228
- | `maxEvents` | number | No | Max events per poll (pagination via `nextCursor`). Default: `200` in `"minimal"`; unlimited in `"full"` |
229
- | `requestId` | string | For respond_permission | Permission request ID |
230
- | `decision` | string | For respond_permission | `"allow"` or `"deny"` |
231
- | `denyMessage` | string | No | Deny reason shown to Claude (`deny` only). Default: `"Permission denied by caller"` |
232
- | `interrupt` | boolean | No | When true, denying also interrupts the whole agent (`deny` only). Default: `false` |
233
- | `pollOptions` | object | No | Fine-grained poll control options (see below) |
234
- | `permissionOptions` | object | No | Advanced permission response options (see below) |
222
+ | Parameter | Type | Required | Description |
223
+ | ------------------- | ------- | ---------------------- | -------------------------------------------------------------------------------------------------------------- |
224
+ | `action` | string | Yes | `"poll"` or `"respond_permission"` |
225
+ | `sessionId` | string | Yes | Target session ID |
226
+ | `cursor` | number | No | Event cursor for incremental polling (`poll` only). Default: omitted (starts from the beginning of the buffer) |
227
+ | `responseMode` | string | No | `"minimal"` (default) or `"full"` — controls payload size and redaction behavior |
228
+ | `maxEvents` | number | No | Max events per poll (pagination via `nextCursor`). Default: `200` in `"minimal"`; unlimited in `"full"` |
229
+ | `requestId` | string | For respond_permission | Permission request ID |
230
+ | `decision` | string | For respond_permission | `"allow"` or `"deny"` |
231
+ | `denyMessage` | string | No | Deny reason shown to Claude (`deny` only). Default: `"Permission denied by caller"` |
232
+ | `interrupt` | boolean | No | When true, denying also interrupts the whole agent (`deny` only). Default: `false` |
233
+ | `pollOptions` | object | No | Fine-grained poll control options (see below) |
234
+ | `permissionOptions` | object | No | Advanced permission response options (see below) |
235
235
 
236
236
  <details>
237
237
  <summary><code>pollOptions</code> object parameters (9 fine-grained poll controls)</summary>
238
238
 
239
- | Parameter | Type | Description |
240
- | ---------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
241
- | `pollOptions.includeTools` | boolean | When true, includes `availableTools` (`poll` only). Default: `false` (omitted until session init is received) |
242
- | `pollOptions.includeEvents` | boolean | When false, omits `events` (but `nextCursor` still advances). Default: `true` |
243
- | `pollOptions.includeActions` | boolean | When false, omits `actions[]` even if `waiting_permission`. Default: `true` |
244
- | `pollOptions.includeResult` | boolean | When false, omits top-level `result` even when `idle`/`error`. Default: `true` |
245
- | `pollOptions.includeUsage` | boolean | Include `result.usage` (default: true in full mode, false in minimal mode) |
246
- | `pollOptions.includeModelUsage` | boolean | Include `result.modelUsage` (default: true in full mode, false in minimal mode) |
247
- | `pollOptions.includeStructuredOutput` | boolean | Include `result.structuredOutput` (default: true in full mode, false in minimal mode) |
248
- | `pollOptions.includeTerminalEvents` | boolean | When true, keeps terminal `result`/`error` events in `events` even if top-level `result` is included. Default: `false` in `"minimal"`, `true` in `"full"` |
249
- | `pollOptions.includeProgressEvents` | boolean | When true, includes progress events (`tool_progress`, `auth_status`) in the events stream. Default: `false` in `"minimal"`, `true` in `"full"` |
239
+ | Parameter | Type | Description |
240
+ | ------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
241
+ | `pollOptions.includeTools` | boolean | When true, includes `availableTools` (`poll` only). Default: `false` (omitted until session init is received) |
242
+ | `pollOptions.includeEvents` | boolean | When false, omits `events` (but `nextCursor` still advances). Default: `true` |
243
+ | `pollOptions.includeActions` | boolean | When false, omits `actions[]` even if `waiting_permission`. Default: `true` |
244
+ | `pollOptions.includeResult` | boolean | When false, omits top-level `result` even when `idle`/`error`. Default: `true` |
245
+ | `pollOptions.includeUsage` | boolean | Include `result.usage` (default: true in full mode, false in minimal mode) |
246
+ | `pollOptions.includeModelUsage` | boolean | Include `result.modelUsage` (default: true in full mode, false in minimal mode) |
247
+ | `pollOptions.includeStructuredOutput` | boolean | Include `result.structuredOutput` (default: true in full mode, false in minimal mode) |
248
+ | `pollOptions.includeTerminalEvents` | boolean | When true, keeps terminal `result`/`error` events in `events` even if top-level `result` is included. Default: `false` in `"minimal"`, `true` in `"full"` |
249
+ | `pollOptions.includeProgressEvents` | boolean | When true, includes progress events (`tool_progress`, `auth_status`) in the events stream. Default: `false` in `"minimal"`, `true` in `"full"` |
250
250
 
251
251
  </details>
252
252
 
253
253
  <details>
254
254
  <summary><code>permissionOptions</code> object parameters (2 advanced permission response options)</summary>
255
255
 
256
- | Parameter | Type | Description |
257
- | ---------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
258
- | `permissionOptions.updatedInput` | object | Modified tool input to run (`allow` only). Default: none |
259
- | `permissionOptions.updatedPermissions` | array | Permission rule updates suggested/applied (`allow` only). Default: none |
256
+ | Parameter | Type | Description |
257
+ | -------------------------------------- | ------ | ----------------------------------------------------------------------- |
258
+ | `permissionOptions.updatedInput` | object | Modified tool input to run (`allow` only). Default: none |
259
+ | `permissionOptions.updatedPermissions` | array | Permission rule updates suggested/applied (`allow` only). Default: none |
260
260
 
261
261
  </details>
262
262
 
@@ -386,11 +386,11 @@ setx CLAUDE_CODE_GIT_BASH_PATH "C:\Program Files\Git\bin\bash.exe"
386
386
 
387
387
  All environment variables are optional. They are set on the MCP server process (not on the Claude Code child process — for that, use the `env` tool parameter).
388
388
 
389
- | Variable | Description | Default |
390
- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------ |
391
- | `CLAUDE_CODE_GIT_BASH_PATH` | Path to `bash.exe` on Windows (see [Windows Support](#windows-support)) | Auto-detected |
392
- | `CLAUDE_CODE_MCP_ALLOW_DISK_RESUME` | Set to `1` to allow `claude_code_reply` to resume from on-disk transcripts when the in-memory session is missing | `0` (disabled) |
393
- | `CLAUDE_CODE_MCP_RESUME_SECRET` | HMAC secret used to validate `resumeToken` for disk resume fallback (recommended if disk resume is enabled) | *(unset)* |
389
+ | Variable | Description | Default |
390
+ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -------------- |
391
+ | `CLAUDE_CODE_GIT_BASH_PATH` | Path to `bash.exe` on Windows (see [Windows Support](#windows-support)) | Auto-detected |
392
+ | `CLAUDE_CODE_MCP_ALLOW_DISK_RESUME` | Set to `1` to allow `claude_code_reply` to resume from on-disk transcripts when the in-memory session is missing | `0` (disabled) |
393
+ | `CLAUDE_CODE_MCP_RESUME_SECRET` | HMAC secret used to validate `resumeToken` for disk resume fallback (recommended if disk resume is enabled) | *(unset)* |
394
394
 
395
395
  ### How to configure
396
396