@anthropic-ai/claude-agent-sdk 0.1.26 → 0.1.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "engines": {

package/sdk-tools.d.ts

@@ -40,6 +40,14 @@ export interface AgentInput {
    * The type of specialized agent to use for this task
    */
   subagent_type: string;
+  /**
+   * Optional model to use for this agent. If not specified, inherits from parent. Prefer haiku for quick, straightforward tasks to minimize cost and latency.
+   */
+  model?: "sonnet" | "opus" | "haiku";
+  /**
+   * Optional agent ID to resume from. If provided, the agent will continue from the previous execution transcript.
+   */
+  resume?: string;
 }
 export interface BashInput {
   /**

package/sdk.d.ts

@@ -129,6 +129,11 @@ export type CanUseTool = (toolName: string, input: Record<string, unknown>, opti
      * `updatedPermissions` in the PermissionResult.
      */
     suggestions?: PermissionUpdate[];
+    /**
+     * Unique identifier for this specific tool call within the assistant message.
+     * Multiple tool calls in the same assistant message will have different toolUseIDs.
+     */
+    toolUseID: string;
 }) => Promise<PermissionResult>;
 export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStop", "PreCompact"];
 export type HookEvent = (typeof HOOK_EVENTS)[number];
@@ -324,6 +329,10 @@ export type SDKSystemMessage = SDKMessageBase & {
     slash_commands: string[];
     output_style: string;
     skills: string[];
+    plugins: {
+        name: string;
+        path: string;
+    }[];
 };
 export type SDKPartialAssistantMessage = SDKMessageBase & {
     type: 'stream_event';
@@ -387,6 +396,8 @@ type CreateSdkMcpServerOptions = {
 /**
  * Creates an MCP server instance that can be used with the SDK transport.
  * This allows SDK users to define custom tools that run in the same process.
+ *
+ * If your SDK MCP calls will run longer than 60s, override CLAUDE_CODE_STREAM_CLOSE_TIMEOUT
  */
 export declare function createSdkMcpServer(_options: CreateSdkMcpServerOptions): McpSdkServerConfigWithInstance;
 export declare class AbortError extends Error {
@@ -398,6 +409,10 @@ export type AgentDefinition = {
     model?: 'sonnet' | 'opus' | 'haiku' | 'inherit';
 };
 export type SettingSource = 'user' | 'project' | 'local';
+export type SdkPluginConfig = {
+    type: 'local';
+    path: string;
+};
 export type Options = {
     abortController?: AbortController;
     additionalDirectories?: string[];
@@ -429,6 +444,21 @@ export type Options = {
     permissionMode?: PermissionMode;
     allowDangerouslySkipPermissions?: boolean;
     permissionPromptToolName?: string;
+    /**
+     * Load plugins for this session. Plugins provide custom commands, agents,
+     * skills, and hooks that extend Claude Code's capabilities.
+     *
+     * Currently only local plugins are supported via the 'local' type.
+     *
+     * @example
+     * ```typescript
+     * plugins: [
+     *   { type: 'local', path: './my-plugin' },
+     *   { type: 'local', path: '/absolute/path/to/plugin' }
+     * ]
+     * ```
+     */
+    plugins?: SdkPluginConfig[];
     resume?: string;
     /**
      * When resuming, only resume messages up to and including the assistant

package/sdk.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // (c) Anthropic PBC. All rights reserved. Use is subject to the Legal Agreements outlined here: https://docs.claude.com/en/docs/claude-code/legal-and-compliance.
 
-// Version: 0.1.26
+// Version: 0.1.28
 
 // Want to see the unminified source? We're hiring!
 // https://job-boards.greenhouse.io/anthropic/jobs/4816199008
@@ -6400,7 +6400,8 @@ class ProcessTransport {
         mcpServers,
         strictMcpConfig,
         canUseTool,
-        includePartialMessages
+        includePartialMessages,
+        plugins
       } = this.options;
       const args = [
         "--output-format",
@@ -6470,6 +6471,15 @@ class ProcessTransport {
       for (const dir of additionalDirectories) {
         args.push("--add-dir", dir);
       }
+      if (plugins && plugins.length > 0) {
+        for (const plugin of plugins) {
+          if (plugin.type === "local") {
+            args.push("--plugin-dir", plugin.path);
+          } else {
+            throw new Error(`Unsupported plugin type: ${plugin.type}`);
+          }
+        }
+      }
       if (this.options.forkSession) {
         args.push("--fork-session");
       }
@@ -7291,6 +7301,7 @@ import { dirname, join as join2 } from "path";
 
 // ../src/bootstrap/state.ts
 import { cwd } from "process";
+import { realpathSync as realpathSync2 } from "fs";
 import { randomUUID } from "crypto";
 
 // ../src/bootstrap/envValidators.ts
@@ -7352,8 +7363,9 @@ var maxOutputTokensValidator = {
 
 // ../src/bootstrap/state.ts
 function getInitialState() {
+  const resolvedCwd = realpathSync2(cwd());
   return {
-    originalCwd: cwd(),
+    originalCwd: resolvedCwd,
     totalCostUSD: 0,
     totalAPIDuration: 0,
     totalAPIDurationWithoutRetries: 0,
@@ -7363,7 +7375,7 @@ function getInitialState() {
     totalLinesAdded: 0,
     totalLinesRemoved: 0,
     hasUnknownModelCost: false,
-    cwd: cwd(),
+    cwd: resolvedCwd,
     modelUsage: {},
     mainLoopModelOverride: undefined,
     maxRateLimitFallbackActive: false,
@@ -7495,12 +7507,14 @@ class Query {
   pendingMcpResponses = new Map;
   firstResultReceivedPromise;
   firstResultReceivedResolve;
+  streamCloseTimeout;
   constructor(transport, isSingleUserTurn, canUseTool, hooks, abortController, sdkMcpServers = new Map) {
     this.transport = transport;
     this.isSingleUserTurn = isSingleUserTurn;
     this.canUseTool = canUseTool;
     this.hooks = hooks;
     this.abortController = abortController;
+    this.streamCloseTimeout = parseInt(process.env.CLAUDE_CODE_STREAM_CLOSE_TIMEOUT || "") || 60000;
     for (const [name, server] of sdkMcpServers) {
       const sdkTransport = new SdkControlServerTransport((message) => this.sendMcpServerMessageToCli(name, message));
       this.sdkMcpTransports.set(name, sdkTransport);
@@ -7626,7 +7640,8 @@ class Query {
       }
       return this.canUseTool(request.request.tool_name, request.request.input, {
         signal,
-        suggestions: request.request.permission_suggestions
+        suggestions: request.request.permission_suggestions,
+        toolUseID: request.request.tool_use_id
       });
     } else if (request.request.subtype === "hook_callback") {
       const result = await this.handleHookCallbacks(request.request.callback_id, request.request.input, request.request.tool_use_id, signal);
@@ -7707,6 +7722,13 @@ class Query {
       max_thinking_tokens: maxThinkingTokens
     });
   }
+  async processPendingPermissionRequests(pendingPermissionRequests) {
+    for (const request of pendingPermissionRequests) {
+      if (request.request.subtype === "can_use_tool") {
+        this.handleControlRequest(request).catch(() => {});
+      }
+    }
+  }
   request(request) {
     const requestId = Math.random().toString(36).substring(2, 15);
     const sdkRequest = {
@@ -7720,6 +7742,9 @@ class Query {
           resolve(response);
         } else {
           reject(new Error(response.error));
+          if (response.pending_permission_requests) {
+            this.processPendingPermissionRequests(response.pending_permission_requests);
+          }
         }
       });
       Promise.resolve(this.transport.write(JSON.stringify(sdkRequest) + `
@@ -7759,7 +7784,6 @@ class Query {
       logForDebugging(`[Query.streamInput] About to check MCP servers. this.sdkMcpTransports.size = ${this.sdkMcpTransports.size}`);
       if (this.sdkMcpTransports.size > 0 && this.firstResultReceivedPromise) {
         logForDebugging(`[Query.streamInput] Entering Promise.race to wait for result`);
-        const STREAM_CLOSE_TIMEOUT = 1e4;
         let timeoutId;
         await Promise.race([
           this.firstResultReceivedPromise.then(() => {
@@ -7772,7 +7796,7 @@ class Query {
             timeoutId = setTimeout(() => {
               logForDebugging(`[Query.streamInput] Timed out waiting for first result, closing input stream`);
               resolve();
-            }, STREAM_CLOSE_TIMEOUT);
+            }, this.streamCloseTimeout);
           })
         ]);
         if (timeoutId) {
@@ -7812,11 +7836,7 @@ class Query {
     const messageId = "id" in mcpRequest.message ? mcpRequest.message.id : null;
     const key = `${serverName}:${messageId}`;
     return new Promise((resolve, reject) => {
-      let timeoutId = null;
       const cleanup = () => {
-        if (timeoutId) {
-          clearTimeout(timeoutId);
-        }
         this.pendingMcpResponses.delete(key);
       };
       const resolveAndCleanup = (response) => {
@@ -7838,12 +7858,6 @@ class Query {
         reject(new Error("No message handler registered"));
         return;
       }
-      timeoutId = setTimeout(() => {
-        if (this.pendingMcpResponses.has(key)) {
-          cleanup();
-          reject(new Error("Request timeout"));
-        }
-      }, 30000);
     });
   }
 }
@@ -14749,7 +14763,7 @@ function query({
     const dirname2 = join3(filename, "..");
     pathToClaudeCodeExecutable = join3(dirname2, "cli.js");
   }
-  process.env.CLAUDE_AGENT_SDK_VERSION = "0.1.26";
+  process.env.CLAUDE_AGENT_SDK_VERSION = "0.1.28";
   const {
     abortController = createAbortController(),
     additionalDirectories = [],
@@ -14774,6 +14788,7 @@ function query({
     permissionMode = "default",
     allowDangerouslySkipPermissions = false,
     permissionPromptToolName,
+    plugins,
     resume,
     resumeSessionAt,
     stderr,
@@ -14836,7 +14851,8 @@ function query({
     strictMcpConfig,
     canUseTool: !!canUseTool,
     hooks: !!hooks,
-    includePartialMessages
+    includePartialMessages,
+    plugins
   });
   const queryInstance = new Query(transport, isSingleUserTurn, canUseTool, hooks, abortController, sdkMcpServers);
   if (typeof prompt === "string") {