@anthropic-ai/claude-agent-sdk 0.2.12 → 0.2.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.12",
+  "version": "0.2.15",
   "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.12"
+  "claudeCodeVersion": "2.1.15"
 }

package/sdk-tools.d.ts

@@ -138,6 +138,10 @@ export interface ExitPlanModeInput {
    * The remote session URL if pushed to remote
    */
   remoteSessionUrl?: string;
+  /**
+   * The remote session title if pushed to remote
+   */
+  remoteSessionTitle?: string;
   [k: string]: unknown;
 }
 export interface FileEditInput {

package/sdk.d.ts

@@ -168,6 +168,7 @@ declare namespace coreTypes {
         ModelInfo,
         ModelUsage,
         NotificationHookInput,
+        NotificationHookSpecificOutput,
         OutputFormat,
         OutputFormatType,
         PermissionBehavior,
@@ -191,6 +192,7 @@ declare namespace coreTypes {
         SDKAuthStatusMessage,
         SDKCompactBoundaryMessage,
         SDKHookResponseMessage,
+        SDKHookStartedMessage,
         SDKMessage,
         SDKPartialAssistantMessage,
         SDKPermissionDenial,
@@ -399,6 +401,11 @@ export declare type NotificationHookInput = BaseHookInput & {
     notification_type: string;
 };
 
+export declare type NotificationHookSpecificOutput = {
+    hookEventName: 'Notification';
+    additionalContext?: string;
+};
+
 /**
  * Options for the query function.
  * Contains callbacks and other non-serializable fields.
@@ -982,6 +989,15 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
      * @param stream - Async iterable of user messages to send
      */
     streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;
+    /**
+     * Close the query and terminate the underlying process.
+     * This forcefully ends the query, cleaning up all resources including
+     * pending requests, MCP transports, and the CLI subprocess.
+     *
+     * Use this when you need to abort a query that is still running.
+     * After calling close(), no further messages will be received.
+     */
+    close(): void;
 }
 
 export declare function query(_params: {
@@ -1103,6 +1119,11 @@ declare type SDKControlMcpMessageRequest = {
     message: JSONRPCMessage;
 };
 
+declare type SDKControlMcpReconnectRequest = {
+    subtype: 'mcp_reconnect';
+    serverName: string;
+};
+
 declare type SDKControlMcpSetServersRequest = {
     subtype: 'mcp_set_servers';
     servers: Record<string, coreTypes.McpServerConfigForProcessTransport>;
@@ -1112,6 +1133,12 @@ declare type SDKControlMcpStatusRequest = {
     subtype: 'mcp_status';
 };
 
+declare type SDKControlMcpToggleRequest = {
+    subtype: 'mcp_toggle';
+    serverName: string;
+    enabled: boolean;
+};
+
 declare type SDKControlPermissionRequest = {
     subtype: 'can_use_tool';
     tool_name: string;
@@ -1129,7 +1156,7 @@ declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest;
 
 declare type SDKControlResponse = {
     type: 'control_response';
@@ -1179,11 +1206,24 @@ declare type SDKHookCallbackRequest = {
 export declare type SDKHookResponseMessage = {
     type: 'system';
     subtype: 'hook_response';
+    hook_id: string;
     hook_name: string;
     hook_event: string;
+    output: string;
     stdout: string;
     stderr: string;
     exit_code?: number;
+    outcome: 'success' | 'error' | 'cancelled';
+    uuid: UUID;
+    session_id: string;
+};
+
+export declare type SDKHookStartedMessage = {
+    type: 'system';
+    subtype: 'hook_started';
+    hook_id: string;
+    hook_name: string;
+    hook_event: string;
     uuid: UUID;
     session_id: string;
 };
@@ -1207,7 +1247,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 | SDKTaskNotificationMessage;
+export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKHookStartedMessage | SDKHookResponseMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage;
 
 export declare type SDKPartialAssistantMessage = {
     type: 'stream_event';
@@ -1569,7 +1609,7 @@ export declare type SyncHookJSONOutput = {
     decision?: 'approve' | 'block';
     systemMessage?: string;
     reason?: string;
-    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionRequestHookSpecificOutput;
+    hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput;
 };
 
 export declare function tool<Schema extends AnyZodRawShape>(_name: string, _description: string, _inputSchema: Schema, _handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>): SdkMcpToolDefinition<Schema>;