@anthropic-ai/claude-agent-sdk 0.2.9 → 0.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "engines": {
@@ -37,5 +37,5 @@
     "@img/sharp-linuxmusl-x64": "^0.33.5",
     "@img/sharp-win32-x64": "^0.33.5"
   },
-  "claudeCodeVersion": "2.1.9"
+  "claudeCodeVersion": "2.1.10"
 }

package/sdk-tools.d.ts

@@ -126,6 +126,18 @@ export interface ExitPlanModeInput {
      */
     prompt: string;
   }[];
+  /**
+   * Whether to push the plan to a remote Claude.ai session
+   */
+  pushToRemote?: boolean;
+  /**
+   * The remote session ID if pushed to remote
+   */
+  remoteSessionId?: string;
+  /**
+   * The remote session URL if pushed to remote
+   */
+  remoteSessionUrl?: string;
   [k: string]: unknown;
 }
 export interface FileEditInput {

package/sdk.d.ts

@@ -55,6 +55,14 @@ export declare type AgentDefinition = {
      * Experimental: Critical reminder added to system prompt
      */
     criticalSystemReminder_EXPERIMENTAL?: string;
+    /**
+     * Array of skill names to preload into the agent context
+     */
+    skills?: string[];
+    /**
+     * Maximum number of agentic turns (API round-trips) before stopping
+     */
+    maxTurns?: number;
 };
 
 export declare type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;
@@ -192,6 +200,7 @@ declare namespace coreTypes {
         SDKStatusMessage,
         SDKStatus,
         SDKSystemMessage,
+        SDKTaskNotificationMessage,
         SDKToolProgressMessage,
         SDKUserMessageReplay,
         SDKUserMessage,
@@ -201,6 +210,8 @@ declare namespace coreTypes {
         SessionStartHookInput,
         SessionStartHookSpecificOutput,
         SettingSource,
+        SetupHookInput,
+        SetupHookSpecificOutput,
         SlashCommand,
         StopHookInput,
         SubagentStartHookInput,
@@ -230,7 +241,7 @@ export declare const EXIT_REASONS: readonly ["clear", "logout", "prompt_input_ex
 
 export declare type ExitReason = 'clear' | 'logout' | 'prompt_input_exit' | 'other' | 'bypass_permissions_disabled';
 
-export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest"];
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest", "Setup"];
 
 /**
  * Hook callback function for responding to events during execution.
@@ -249,9 +260,9 @@ export declare interface HookCallbackMatcher {
     timeout?: number;
 }
 
-export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PermissionRequest';
+export declare type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PermissionRequest' | 'Setup';
 
-export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PermissionRequestHookInput;
+export declare type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | SubagentStartHookInput | SubagentStopHookInput | PreCompactHookInput | PermissionRequestHookInput | SetupHookInput;
 
 export declare type HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput;
 
@@ -1196,7 +1207,7 @@ export declare type SdkMcpToolDefinition<Schema extends AnyZodRawShape = AnyZodR
     handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>;
 };
 
-export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage;
+export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage;
 
 export declare type SDKPartialAssistantMessage = {
     type: 'stream_event';
@@ -1373,6 +1384,17 @@ export declare type SDKSystemMessage = {
     session_id: string;
 };
 
+export declare type SDKTaskNotificationMessage = {
+    type: 'system';
+    subtype: 'task_notification';
+    task_id: string;
+    status: 'completed' | 'failed' | 'stopped';
+    output_file: string;
+    summary: string;
+    uuid: UUID;
+    session_id: string;
+};
+
 export declare type SDKToolProgressMessage = {
     type: 'tool_progress';
     tool_use_id: string;
@@ -1426,6 +1448,16 @@ export declare type SessionStartHookSpecificOutput = {
  */
 export declare type SettingSource = 'user' | 'project' | 'local';
 
+export declare type SetupHookInput = BaseHookInput & {
+    hook_event_name: 'Setup';
+    trigger: 'init' | 'maintenance';
+};
+
+export declare type SetupHookSpecificOutput = {
+    hookEventName: 'Setup';
+    additionalContext?: string;
+};
+
 /**
  * Information about an available skill (invoked via /command syntax).
  */
@@ -1537,7 +1569,7 @@ export declare type SyncHookJSONOutput = {
     decision?: 'approve' | 'block';
     systemMessage?: string;
     reason?: string;
-    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionRequestHookSpecificOutput;
+    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionRequestHookSpecificOutput;
 };
 
 export declare function tool<Schema extends AnyZodRawShape>(_name: string, _description: string, _inputSchema: Schema, _handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>): SdkMcpToolDefinition<Schema>;

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://code.claude.com/docs/en/legal-and-compliance.
 
-// Version: 0.2.9
+// Version: 0.2.10
 
 // Want to see the unminified source? We're hiring!
 // https://job-boards.greenhouse.io/anthropic/jobs/4816199008
@@ -7499,7 +7499,8 @@ var HOOK_EVENTS = [
   "SubagentStart",
   "SubagentStop",
   "PreCompact",
-  "PermissionRequest"
+  "PermissionRequest",
+  "Setup"
 ];
 var EXIT_REASONS = [
   "clear",
@@ -21324,7 +21325,7 @@ function query({
     const dirname2 = join5(filename, "..");
     pathToClaudeCodeExecutable = join5(dirname2, "cli.js");
   }
-  process.env.CLAUDE_AGENT_SDK_VERSION = "0.2.9";
+  process.env.CLAUDE_AGENT_SDK_VERSION = "0.2.10";
   const {
     abortController = createAbortController(),
     additionalDirectories = [],