@anthropic-ai/claude-agent-sdk 0.1.63 → 0.1.65

package/entrypoints/sdkControlTypes.d.ts

@@ -0,0 +1,96 @@
+import { type AccountInfo, type PermissionMode, type SDKMessage, type SDKUserMessage, type HookInput, type HookEvent, type PermissionUpdate, type ModelInfo, type SlashCommand, type AgentDefinition } from './agentSdkTypes.js';
+import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+export type SDKControlInitializeRequest = {
+    subtype: 'initialize';
+    hooks?: Partial<Record<HookEvent, SDKHookCallbackMatcher[]>>;
+    sdkMcpServers?: string[];
+    jsonSchema?: Record<string, unknown>;
+    systemPrompt?: string;
+    appendSystemPrompt?: string;
+    agents?: Record<string, AgentDefinition>;
+};
+export type SDKControlInitializeResponse = {
+    commands: SlashCommand[];
+    output_style: string;
+    available_output_styles: string[];
+    models: ModelInfo[];
+    account: AccountInfo;
+};
+export type SDKControlInterruptRequest = {
+    subtype: 'interrupt';
+};
+export type SDKControlPermissionRequest = {
+    subtype: 'can_use_tool';
+    tool_name: string;
+    input: Record<string, unknown>;
+    permission_suggestions?: PermissionUpdate[];
+    blocked_path?: string;
+    decision_reason?: string;
+    tool_use_id: string;
+    agent_id?: string;
+};
+export type SDKControlSetPermissionModeRequest = {
+    subtype: 'set_permission_mode';
+    mode: PermissionMode;
+};
+export type SDKControlSetModelRequest = {
+    subtype: 'set_model';
+    model?: string;
+};
+export type SDKControlSetMaxThinkingTokensRequest = {
+    subtype: 'set_max_thinking_tokens';
+    max_thinking_tokens: number | null;
+};
+export type SDKControlMcpStatusRequest = {
+    subtype: 'mcp_status';
+};
+export type SDKControlRewindFilesRequest = {
+    subtype: 'rewind_files';
+    user_message_id: string;
+};
+export type SDKHookCallbackMatcher = {
+    matcher?: string;
+    hookCallbackIds: string[];
+    /** Timeout in seconds for all hooks in this matcher */
+    timeout?: number;
+};
+export type SDKHookCallbackRequest = {
+    subtype: 'hook_callback';
+    callback_id: string;
+    input: HookInput;
+    tool_use_id?: string;
+};
+export type SDKControlMcpMessageRequest = {
+    subtype: 'mcp_message';
+    server_name: string;
+    message: JSONRPCMessage;
+};
+export type SDKControlRequest = {
+    type: 'control_request';
+    request_id: string;
+    request: SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest;
+};
+export type SDKControlResponse = {
+    type: 'control_response';
+    response: ControlResponse | ControlErrorResponse;
+};
+export type ControlResponse = {
+    subtype: 'success';
+    request_id: string;
+    response?: Record<string, unknown>;
+};
+export type ControlErrorResponse = {
+    subtype: 'error';
+    request_id: string;
+    error: string;
+    pending_permission_requests?: SDKControlRequest[];
+};
+export type SDKControlCancelRequest = {
+    type: 'control_cancel_request';
+    request_id: string;
+};
+export type SDKKeepAliveMessage = {
+    type: 'keep_alive';
+};
+export type StdoutMessage = SDKMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;
+export type StdinMessage = SDKUserMessage | SDKControlRequest | SDKControlResponse | SDKKeepAliveMessage;

package/package.json

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

package/sdk-tools.d.ts

@@ -11,7 +11,7 @@
 export type ToolInputSchemas =
   | AgentInput
   | BashInput
-  | BashOutputInput
+  | TaskOutputInput
   | ExitPlanModeInput
   | FileEditInput
   | FileReadInput
@@ -26,8 +26,7 @@ export type ToolInputSchemas =
   | TodoWriteInput
   | WebFetchInput
   | WebSearchInput
-  | AskUserQuestionInput
-  | AgentOutputInput;
+  | AskUserQuestionInput;
 
 export interface AgentInput {
   /**
@@ -51,7 +50,7 @@ export interface AgentInput {
    */
   resume?: string;
   /**
-   * Set to true to run this agent in the background. Use AgentOutputTool to read the output later.
+   * Set to true to run this agent in the background. Use TaskOutput to read the output later.
    */
   run_in_background?: boolean;
 }
@@ -80,7 +79,7 @@ export interface BashInput {
    */
   description?: string;
   /**
-   * Set to true to run this command in the background. Use BashOutput to read the output later.
+   * Set to true to run this command in the background. Use TaskOutput to read the output later.
    */
   run_in_background?: boolean;
   /**
@@ -88,15 +87,19 @@ export interface BashInput {
    */
   dangerouslyDisableSandbox?: boolean;
 }
-export interface BashOutputInput {
+export interface TaskOutputInput {
   /**
-   * The ID of the background shell to retrieve output from
+   * The task ID to get output from
    */
-  bash_id: string;
+  task_id: string;
   /**
-   * Optional regular expression to filter the output lines. Only lines matching this regex will be included in the result. Any lines that do not match will no longer be available to read.
+   * Whether to wait for completion
    */
-  filter?: string;
+  block?: boolean;
+  /**
+   * Max wait time in ms
+   */
+  timeout?: number;
 }
 export interface ExitPlanModeInput {
   /**
@@ -203,7 +206,7 @@ export interface GrepInput {
    */
   type?: string;
   /**
-   * Limit output to first N lines/entries, equivalent to "| head -N". Works across all output modes: content (limits output lines), files_with_matches (limits file paths), count (limits count entries). Defaults based on "cap" experiment value: 0 (unlimited), 20, or 100.
+   * Limit output to first N lines/entries, equivalent to "| head -N". Works across all output modes: content (limits output lines), files_with_matches (limits file paths), count (limits count entries). Defaults to 0 (unlimited).
    */
   head_limit?: number;
   /**
@@ -1489,17 +1492,3 @@ export interface AskUserQuestionInput {
     [k: string]: string;
   };
 }
-export interface AgentOutputInput {
-  /**
-   * The agent ID to retrieve results for
-   */
-  agentId: string;
-  /**
-   * Whether to block until results are ready
-   */
-  block?: boolean;
-  /**
-   * Maximum time to wait in seconds
-   */
-  wait_up_to?: number;
-}