@leo000001/claude-code-mcp 2.0.0 → 2.0.1

package/dist/index.js

@@ -1797,7 +1797,7 @@ function executeClaudeCodeSession(input, sessionManager) {
 }
 
 // src/server.ts
-var SERVER_VERSION = true ? "2.0.0" : "0.0.0-dev";
+var SERVER_VERSION = true ? "2.0.1" : "0.0.0-dev";
 function createServer(serverCwd) {
   const sessionManager = new SessionManager();
   const toolCache = new ToolDiscoveryCache();
@@ -1821,7 +1821,7 @@ function createServer(serverCwd) {
     z.object({
       type: z.literal("preset"),
       preset: z.literal("claude_code"),
-      append: z.string().optional().describe("Additional instructions to append to the preset")
+      append: z.string().optional().describe("Appended to preset prompt")
     })
   ]);
   const toolsConfigSchema = z.union([
@@ -1835,66 +1835,50 @@ function createServer(serverCwd) {
     z.object({ type: z.literal("adaptive") }),
     z.object({
       type: z.literal("enabled"),
-      budgetTokens: z.number().int().positive().describe("Token budget for thinking")
+      budgetTokens: z.number().int().positive()
     }),
     z.object({ type: z.literal("disabled") })
   ]);
   const outputFormatSchema = z.object({
     type: z.literal("json_schema"),
-    schema: z.record(z.string(), z.unknown()).describe("JSON Schema for structured output")
+    schema: z.record(z.string(), z.unknown())
   });
   const advancedOptionsSchema = z.object({
-    tools: toolsConfigSchema.optional().describe(
-      "Define the base tool set visible to the agent. Default: omitted (SDK/Claude Code default). Pass an array of tool names, or {type: 'preset', preset: 'claude_code'} for the default set."
-    ),
-    persistSession: z.boolean().optional().describe("Persist session history to disk (~/.claude/projects). Default: true."),
-    sessionInitTimeoutMs: z.number().int().positive().optional().describe("How long to wait (in ms) for the agent process to initialize. Default: 10000."),
-    agents: z.record(z.string(), agentDefinitionSchema).optional().describe(
-      "Define custom sub-agents the main agent can delegate tasks to. Each key is the agent name."
-    ),
-    agent: z.string().optional().describe("Name of a custom agent (defined in 'agents') to use as the primary agent."),
-    maxBudgetUsd: z.number().positive().optional().describe("Maximum budget in USD for this session."),
-    effort: z.enum(EFFORT_LEVELS).optional().describe("Effort level: 'low' | 'medium' | 'high' | 'max'."),
-    betas: z.array(z.string()).optional().describe("Beta features to enable."),
-    additionalDirectories: z.array(z.string()).optional().describe("Additional directories the agent can access beyond cwd."),
-    outputFormat: outputFormatSchema.optional().describe("Structured output format with JSON Schema."),
-    thinking: thinkingSchema.optional().describe("Thinking mode: 'adaptive' | 'enabled' (with budget) | 'disabled'."),
-    pathToClaudeCodeExecutable: z.string().optional().describe("Path to the Claude Code executable. Default: SDK-bundled."),
-    mcpServers: z.record(z.string(), z.record(z.string(), z.unknown())).optional().describe("MCP server configurations (key: server name, value: server config)."),
-    sandbox: z.record(z.string(), z.unknown()).optional().describe("Sandbox configuration for isolating shell command execution."),
-    fallbackModel: z.string().optional().describe("Fallback model if the primary model fails or is unavailable."),
-    enableFileCheckpointing: z.boolean().optional().describe("Enable file checkpointing to track file changes. Default: false."),
-    includePartialMessages: z.boolean().optional().describe("Include intermediate messages as events in claude_code_check. Default: false."),
-    strictMcpConfig: z.boolean().optional().describe("Enforce strict validation of MCP server configurations. Default: false."),
-    settingSources: z.array(z.enum(["user", "project", "local"])).optional().describe(
-      "Which local config files to load. Default: ['user', 'project', 'local']. Pass [] to disable all."
-    ),
-    debug: z.boolean().optional().describe("Enable debug mode. Default: false."),
-    debugFile: z.string().optional().describe("Write debug logs to a file path (implicitly enables debug mode)."),
-    env: z.record(z.string(), z.string().optional()).optional().describe("Environment variables to merge with process.env.")
-  }).optional().describe(
-    "Low-frequency SDK options. All fields are optional with sensible defaults. Most callers can omit this entirely."
-  );
+    tools: toolsConfigSchema.optional().describe("Visible tool set. Default: SDK"),
+    persistSession: z.boolean().optional().describe("Default: true"),
+    sessionInitTimeoutMs: z.number().int().positive().optional().describe("Default: 10000"),
+    agents: z.record(z.string(), agentDefinitionSchema).optional().describe("Sub-agent definitions. Default: none"),
+    agent: z.string().optional().describe("Primary agent name (from 'agents'). Default: none"),
+    maxBudgetUsd: z.number().positive().optional().describe("Default: none"),
+    effort: z.enum(EFFORT_LEVELS).optional().describe("Default: SDK"),
+    betas: z.array(z.string()).optional().describe("Default: none"),
+    additionalDirectories: z.array(z.string()).optional().describe("Default: none"),
+    outputFormat: outputFormatSchema.optional().describe("Default: none (plain text)"),
+    thinking: thinkingSchema.optional().describe("Default: SDK"),
+    pathToClaudeCodeExecutable: z.string().optional().describe("Default: SDK-bundled"),
+    mcpServers: z.record(z.string(), z.record(z.string(), z.unknown())).optional().describe("Default: none"),
+    sandbox: z.record(z.string(), z.unknown()).optional().describe("Default: none"),
+    fallbackModel: z.string().optional().describe("Default: none"),
+    enableFileCheckpointing: z.boolean().optional().describe("Default: false"),
+    includePartialMessages: z.boolean().optional().describe("Stream events to claude_code_check. Default: false"),
+    strictMcpConfig: z.boolean().optional().describe("Default: false"),
+    settingSources: z.array(z.enum(["user", "project", "local"])).optional().describe("Default: ['user','project','local']. [] = isolation mode"),
+    debug: z.boolean().optional().describe("Default: false"),
+    debugFile: z.string().optional().describe("Enables debug. Default: none"),
+    env: z.record(z.string(), z.string().optional()).optional().describe("Merged with process.env. Default: none")
+  }).optional().describe("Low-frequency SDK options (all optional)");
   server.tool(
     "claude_code",
     buildInternalToolsDescription(toolCache.getTools()),
     {
-      prompt: z.string().describe("The task or question for Claude Code"),
-      cwd: z.string().optional().describe("Working directory. Default: server cwd."),
-      allowedTools: z.array(z.string()).optional().describe(
-        "Tools the agent can use without asking for permission. Default: [] (no auto-approvals). Example: ['Bash', 'Read', 'Write', 'Edit']. Tools not listed here or in disallowedTools will trigger a permission request via claude_code_check."
-      ),
-      disallowedTools: z.array(z.string()).optional().describe(
-        "Tools the agent is forbidden from using. Default: [] (none). Takes priority over allowedTools."
-      ),
-      maxTurns: z.number().int().positive().optional().describe("Maximum number of reasoning steps the agent can take."),
-      model: z.string().optional().describe("Model to use, e.g. 'claude-sonnet-4-5-20250929'."),
-      systemPrompt: systemPromptSchema.optional().describe(
-        "Override the agent's system prompt. Pass a string for full replacement, or use {type: 'preset', preset: 'claude_code', append: '...'} to extend the default."
-      ),
-      permissionRequestTimeoutMs: z.number().int().positive().optional().describe(
-        "How long to wait (in ms) for a permission decision via claude_code_check before auto-denying. Default: 60000."
-      ),
+      prompt: z.string().describe("Task or question"),
+      cwd: z.string().optional().describe("Working directory. Default: server cwd"),
+      allowedTools: z.array(z.string()).optional().describe("Auto-approved tools, e.g. ['Bash','Read','Write','Edit']. Default: []"),
+      disallowedTools: z.array(z.string()).optional().describe("Forbidden tools (priority over allowedTools). Default: []"),
+      maxTurns: z.number().int().positive().optional().describe("Default: SDK"),
+      model: z.string().optional().describe("e.g. 'opus'. Default: SDK"),
+      systemPrompt: systemPromptSchema.optional().describe("Default: SDK"),
+      permissionRequestTimeoutMs: z.number().int().positive().optional().describe("Auto-deny timeout (ms). Default: 60000"),
       advanced: advancedOptionsSchema
     },
     async (args, extra) => {
@@ -1946,49 +1930,43 @@ Defaults:
 
 Disk resume: If the server restarted and the session is no longer in memory, set CLAUDE_CODE_MCP_ALLOW_DISK_RESUME=1 to let the agent resume from its on-disk transcript. Pass diskResumeConfig with resumeToken and session parameters.`,
     {
-      sessionId: z.string().describe("The session ID to continue (from a previous claude_code call)"),
-      prompt: z.string().describe("Follow-up prompt or instruction"),
-      forkSession: z.boolean().optional().describe(
-        "Branch this session into a new copy that diverges from the current point. The original session remains unchanged. Default: false."
-      ),
-      sessionInitTimeoutMs: z.number().int().positive().optional().describe("How long to wait (in ms) for a forked session to initialize. Default: 10000."),
-      permissionRequestTimeoutMs: z.number().int().positive().optional().describe(
-        "How long to wait (in ms) for a permission decision via claude_code_check before auto-denying. Default: 60000."
-      ),
+      sessionId: z.string().describe("Session ID from claude_code"),
+      prompt: z.string().describe("Follow-up message"),
+      forkSession: z.boolean().optional().describe("Branch into new session copy. Default: false"),
+      sessionInitTimeoutMs: z.number().int().positive().optional().describe("Fork init timeout (ms). Default: 10000"),
+      permissionRequestTimeoutMs: z.number().int().positive().optional().describe("Auto-deny timeout (ms). Default: 60000"),
       diskResumeConfig: z.object({
-        resumeToken: z.string().optional().describe(
-          "Resume token returned by claude_code / claude_code_reply. Required for disk resume."
-        ),
-        cwd: z.string().optional().describe("Working directory. Required for disk resume."),
-        allowedTools: z.array(z.string()).optional().describe("Tools the agent can use without permission."),
-        disallowedTools: z.array(z.string()).optional().describe("Tools the agent is forbidden from using."),
-        tools: toolsConfigSchema.optional().describe("Which tools the agent can see."),
-        persistSession: z.boolean().optional().describe("Persist session history to disk. Default: true."),
-        maxTurns: z.number().int().positive().optional().describe("Maximum reasoning steps."),
-        model: z.string().optional().describe("Model to use."),
-        systemPrompt: systemPromptSchema.optional().describe("Override the agent's system prompt."),
-        agents: z.record(z.string(), agentDefinitionSchema).optional().describe("Define custom sub-agents."),
-        agent: z.string().optional().describe("Name of a custom agent to use as primary."),
-        maxBudgetUsd: z.number().positive().optional().describe("Maximum budget in USD."),
-        effort: z.enum(EFFORT_LEVELS).optional().describe("Effort level."),
-        betas: z.array(z.string()).optional().describe("Beta features to enable."),
-        additionalDirectories: z.array(z.string()).optional().describe("Additional accessible directories."),
-        outputFormat: outputFormatSchema.optional().describe("Structured output format."),
-        thinking: thinkingSchema.optional().describe("Thinking mode configuration."),
-        resumeSessionAt: z.string().optional().describe("Resume only up to a specific message UUID."),
-        pathToClaudeCodeExecutable: z.string().optional().describe("Path to the Claude Code executable."),
-        mcpServers: z.record(z.string(), z.record(z.string(), z.unknown())).optional().describe("MCP server configurations."),
-        sandbox: z.record(z.string(), z.unknown()).optional().describe("Sandbox configuration."),
-        fallbackModel: z.string().optional().describe("Fallback model."),
-        enableFileCheckpointing: z.boolean().optional().describe("Enable file checkpointing. Default: false."),
-        includePartialMessages: z.boolean().optional().describe("Include intermediate messages as events. Default: false."),
-        strictMcpConfig: z.boolean().optional().describe("Enforce strict MCP validation. Default: false."),
-        settingSources: z.array(z.enum(["user", "project", "local"])).optional().describe("Which local config files to load."),
-        debug: z.boolean().optional().describe("Enable debug mode. Default: false."),
-        debugFile: z.string().optional().describe("Write debug logs to a file path."),
-        env: z.record(z.string(), z.string().optional()).optional().describe("Environment variables to merge with process.env.")
+        resumeToken: z.string().optional().describe("Required"),
+        cwd: z.string().optional().describe("Required"),
+        allowedTools: z.array(z.string()).optional().describe("Default: []"),
+        disallowedTools: z.array(z.string()).optional().describe("Default: []"),
+        tools: toolsConfigSchema.optional().describe("Default: SDK"),
+        persistSession: z.boolean().optional().describe("Default: true"),
+        maxTurns: z.number().int().positive().optional().describe("Default: SDK"),
+        model: z.string().optional().describe("Default: SDK"),
+        systemPrompt: systemPromptSchema.optional().describe("Default: SDK"),
+        agents: z.record(z.string(), agentDefinitionSchema).optional().describe("Default: none"),
+        agent: z.string().optional().describe("Default: none"),
+        maxBudgetUsd: z.number().positive().optional().describe("Default: none"),
+        effort: z.enum(EFFORT_LEVELS).optional().describe("Default: SDK"),
+        betas: z.array(z.string()).optional().describe("Default: none"),
+        additionalDirectories: z.array(z.string()).optional().describe("Default: none"),
+        outputFormat: outputFormatSchema.optional().describe("Default: none"),
+        thinking: thinkingSchema.optional().describe("Default: SDK"),
+        resumeSessionAt: z.string().optional().describe("Resume to specific message UUID. Default: none"),
+        pathToClaudeCodeExecutable: z.string().optional().describe("Default: SDK-bundled"),
+        mcpServers: z.record(z.string(), z.record(z.string(), z.unknown())).optional().describe("Default: none"),
+        sandbox: z.record(z.string(), z.unknown()).optional().describe("Default: none"),
+        fallbackModel: z.string().optional().describe("Default: none"),
+        enableFileCheckpointing: z.boolean().optional().describe("Default: false"),
+        includePartialMessages: z.boolean().optional().describe("Stream events to claude_code_check. Default: false"),
+        strictMcpConfig: z.boolean().optional().describe("Default: false"),
+        settingSources: z.array(z.enum(["user", "project", "local"])).optional().describe("Default: ['user','project','local']. [] = isolation mode"),
+        debug: z.boolean().optional().describe("Default: false"),
+        debugFile: z.string().optional().describe("Enables debug. Default: none"),
+        env: z.record(z.string(), z.string().optional()).optional().describe("Default: none")
       }).optional().describe(
-        "Disk resume fallback configuration. Only needed when CLAUDE_CODE_MCP_ALLOW_DISK_RESUME=1 and the in-memory session is missing. Contains resumeToken + all session config overrides."
+        "Disk resume config (needs CLAUDE_CODE_MCP_ALLOW_DISK_RESUME=1). Requires resumeToken + cwd."
       )
     },
     async (args, extra) => {
@@ -2026,11 +2004,9 @@ Disk resume: If the server restarted and the session is no longer in memory, set
 - action="get": Get full details for one session (pass sessionId). Add includeSensitive=true to also see cwd, systemPrompt, agents, and additionalDirectories.
 - action="cancel": Stop a running session immediately (pass sessionId).`,
     {
-      action: z.enum(SESSION_ACTIONS).describe("Action to perform: 'list', 'get', or 'cancel'"),
-      sessionId: z.string().optional().describe("Session ID (required for 'get' and 'cancel')"),
-      includeSensitive: z.boolean().optional().describe(
-        "When true, includes sensitive fields (cwd, systemPrompt, agents, additionalDirectories) in the response. Default: false."
-      )
+      action: z.enum(SESSION_ACTIONS),
+      sessionId: z.string().optional().describe("Required for 'get' and 'cancel'"),
+      includeSensitive: z.boolean().optional().describe("Include cwd/systemPrompt/agents/additionalDirectories. Default: false")
     },
     async (args) => {
       const result = executeClaudeCodeSession(args, sessionManager);
@@ -2066,58 +2042,30 @@ action="respond_permission" \u2014 Approve or deny a pending permission request.
   Approving resumes agent execution. Denying (with optional interrupt=true) can halt the entire session.
   The response also includes the latest poll state (events, status, etc.), so a separate poll call is not needed.`,
     {
-      action: z.enum(CHECK_ACTIONS).describe('Action to perform: "poll" or "respond_permission"'),
-      sessionId: z.string().describe("Session ID to check"),
-      cursor: z.number().int().nonnegative().optional().describe(
-        "Event cursor for incremental polling. Pass nextCursor from the previous poll response."
-      ),
-      responseMode: z.enum(CHECK_RESPONSE_MODES).optional().describe("Response shaping preset. 'minimal' reduces payload size. Default: 'minimal'."),
-      maxEvents: z.number().int().positive().optional().describe(
-        "Max number of events to return per poll (pagination via nextCursor). Default: 200 in minimal mode."
-      ),
-      requestId: z.string().optional().describe(
-        "The permission request ID to respond to (from the actions array). Required for respond_permission."
-      ),
-      decision: z.enum(["allow", "deny"]).optional().describe(
-        "Whether to approve or reject the permission request. Required for respond_permission."
-      ),
-      denyMessage: z.string().optional().describe(
-        "Reason for denying, shown to the agent. Only used with decision='deny'. Default: 'Permission denied by caller'."
-      ),
-      interrupt: z.boolean().optional().describe(
-        "When true with decision='deny', stops the entire agent session. Default: false."
-      ),
+      action: z.enum(CHECK_ACTIONS),
+      sessionId: z.string().describe("Target session ID"),
+      cursor: z.number().int().nonnegative().optional().describe("Event offset for incremental poll. Default: 0"),
+      responseMode: z.enum(CHECK_RESPONSE_MODES).optional().describe("Default: 'minimal'"),
+      maxEvents: z.number().int().positive().optional().describe("Events per poll. Default: 200 (minimal)"),
+      requestId: z.string().optional().describe("Permission request ID (from actions[])"),
+      decision: z.enum(["allow", "deny"]).optional().describe("For respond_permission"),
+      denyMessage: z.string().optional().describe("Reason shown to agent on deny. Default: 'Permission denied by caller'"),
+      interrupt: z.boolean().optional().describe("Stop session on deny. Default: false"),
       pollOptions: z.object({
-        includeTools: z.boolean().optional().describe("Include availableTools array from session init. Default: false."),
-        includeEvents: z.boolean().optional().describe(
-          "When false, omits the events array (nextCursor still advances). Default: true."
-        ),
-        includeActions: z.boolean().optional().describe("When false, omits actions[] even if waiting_permission. Default: true."),
-        includeResult: z.boolean().optional().describe("When false, omits the top-level result when idle/error. Default: true."),
-        includeUsage: z.boolean().optional().describe("Include AgentResult.usage. Default: true in full mode, false in minimal."),
-        includeModelUsage: z.boolean().optional().describe(
-          "Include AgentResult.modelUsage. Default: true in full mode, false in minimal."
-        ),
-        includeStructuredOutput: z.boolean().optional().describe(
-          "Include AgentResult.structuredOutput. Default: true in full mode, false in minimal."
-        ),
-        includeTerminalEvents: z.boolean().optional().describe(
-          "Include terminal result/error events in events stream. Default: true in full, false in minimal."
-        ),
-        includeProgressEvents: z.boolean().optional().describe(
-          "Include progress events (tool_progress, auth_status). Default: true in full, false in minimal."
-        )
-      }).optional().describe(
-        "Fine-grained poll control. Overrides responseMode defaults for individual fields. Most callers can omit this."
-      ),
+        includeTools: z.boolean().optional().describe("Default: false"),
+        includeEvents: z.boolean().optional().describe("Default: true"),
+        includeActions: z.boolean().optional().describe("Default: true"),
+        includeResult: z.boolean().optional().describe("Default: true"),
+        includeUsage: z.boolean().optional().describe("Default: full=true, minimal=false"),
+        includeModelUsage: z.boolean().optional().describe("Default: full=true, minimal=false"),
+        includeStructuredOutput: z.boolean().optional().describe("Default: full=true, minimal=false"),
+        includeTerminalEvents: z.boolean().optional().describe("Default: full=true, minimal=false"),
+        includeProgressEvents: z.boolean().optional().describe("Default: full=true, minimal=false")
+      }).optional().describe("Override responseMode defaults"),
       permissionOptions: z.object({
-        updatedInput: z.record(z.string(), z.unknown()).optional().describe(
-          "Modified tool input to use instead of the original. Only with decision='allow'."
-        ),
-        updatedPermissions: z.array(z.record(z.string(), z.unknown())).optional().describe("Permission rule updates to apply. Only with decision='allow'.")
-      }).optional().describe(
-        "Advanced permission response options. Only used with respond_permission + decision='allow'."
-      )
+        updatedInput: z.record(z.string(), z.unknown()).optional().describe("Replace tool input on allow. Default: none"),
+        updatedPermissions: z.array(z.record(z.string(), z.unknown())).optional().describe("Update permission rules on allow. Default: none")
+      }).optional().describe("Allow-only: modify tool input or update rules")
     },
     async (args) => {
       const result = executeClaudeCodeCheck(args, sessionManager, toolCache);