@anthropic-ai/claude-code 1.0.84 → 1.0.86

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-code",
-  "version": "1.0.84",
+  "version": "1.0.86",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "bin": {

package/sdk-tools.d.ts

@@ -67,6 +67,10 @@ export interface BashInput {
    * Output: Creates directory 'foo'
    */
   description?: string;
+  /**
+   * Set to true to run this command in the background. Use BashOutput to read the output later.
+   */
+  run_in_background?: boolean;
   /**
    * whether to run this command in sandboxed mode: command run in this mode may not write to the filesystem or use the network, but they can read files, analyze data, and report back to you.  When possible, run commands (e.g. grep) in this mode to present a smoother experience for the human, who isn't prompted to approve commands run in sandbox mode. If you run a command in sandbox mode and it looks like it fails because it needs write access after all, try again in non-sandbox mode
    */
@@ -299,7 +303,6 @@ export interface TodoWriteInput {
   todos: {
     content: string;
     status: "pending" | "in_progress" | "completed";
-    id: string;
   }[];
 }
 export interface WebFetchInput {

package/sdk.d.ts

@@ -1,4 +1,5 @@
 import type { Message as APIAssistantMessage, MessageParam as APIUserMessage, Usage } from '@anthropic-ai/sdk/resources/index.mjs';
+import type { UUID } from 'crypto';
 export type NonNullableUsage = {
     [K in keyof Usage]: NonNullable<Usage[K]>;
 };
@@ -31,6 +32,87 @@ export type PermissionResult = {
 export type CanUseTool = (toolName: string, input: Record<string, unknown>, options: {
     signal: AbortSignal;
 }) => Promise<PermissionResult>;
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStop", "PreCompact"];
+export type HookEvent = (typeof HOOK_EVENTS)[number];
+export type HookCallback = (input: HookInput, toolUseID: string | undefined, options: {
+    signal: AbortSignal;
+}) => Promise<HookJSONOutput>;
+export interface HookCallbackMatcher {
+    matcher?: string;
+    hooks: HookCallback[];
+}
+export type BaseHookInput = {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+};
+export type PreToolUseHookInput = BaseHookInput & {
+    hook_event_name: 'PreToolUse';
+    tool_name: string;
+    tool_input: unknown;
+};
+export type PostToolUseHookInput = BaseHookInput & {
+    hook_event_name: 'PostToolUse';
+    tool_name: string;
+    tool_input: unknown;
+    tool_response: unknown;
+};
+export type NotificationHookInput = BaseHookInput & {
+    hook_event_name: 'Notification';
+    message: string;
+    title?: string;
+};
+export type UserPromptSubmitHookInput = BaseHookInput & {
+    hook_event_name: 'UserPromptSubmit';
+    prompt: string;
+};
+export type SessionStartHookInput = BaseHookInput & {
+    hook_event_name: 'SessionStart';
+    source: 'startup' | 'resume' | 'clear' | 'compact';
+};
+export type StopHookInput = BaseHookInput & {
+    hook_event_name: 'Stop';
+    stop_hook_active: boolean;
+};
+export type SubagentStopHookInput = BaseHookInput & {
+    hook_event_name: 'SubagentStop';
+    stop_hook_active: boolean;
+};
+export type PreCompactHookInput = BaseHookInput & {
+    hook_event_name: 'PreCompact';
+    trigger: 'manual' | 'auto';
+    custom_instructions: string | null;
+};
+export declare const EXIT_REASONS: string[];
+export type ExitReason = (typeof EXIT_REASONS)[number];
+export type SessionEndHookInput = BaseHookInput & {
+    hook_event_name: 'SessionEnd';
+    reason: ExitReason;
+};
+export type HookInput = PreToolUseHookInput | PostToolUseHookInput | NotificationHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | SubagentStopHookInput | PreCompactHookInput;
+export interface HookJSONOutput {
+    continue?: boolean;
+    suppressOutput?: boolean;
+    stopReason?: string;
+    decision?: 'approve' | 'block';
+    systemMessage?: string;
+    permissionDecision?: 'allow' | 'deny' | 'ask';
+    reason?: string;
+    hookSpecificOutput?: {
+        hookEventName: 'PreToolUse';
+        permissionDecision?: 'allow' | 'deny' | 'ask';
+        permissionDecisionReason?: string;
+    } | {
+        hookEventName: 'UserPromptSubmit';
+        additionalContext?: string;
+    } | {
+        hookEventName: 'SessionStart';
+        additionalContext?: string;
+    } | {
+        hookEventName: 'PostToolUse';
+        additionalContext?: string;
+    };
+}
 export type Options = {
     abortController?: AbortController;
     additionalDirectories?: string[];
@@ -45,6 +127,7 @@ export type Options = {
     executable?: 'bun' | 'deno' | 'node';
     executableArgs?: string[];
     fallbackModel?: string;
+    hooks?: Partial<Record<HookEvent, HookCallbackMatcher[]>>;
     maxThinkingTokens?: number;
     maxTurns?: number;
     mcpServers?: Record<string, McpServerConfig>;
@@ -57,24 +140,31 @@ export type Options = {
     strictMcpConfig?: boolean;
 };
 export type PermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan';
-export type SDKUserMessage = {
+type SDKMessageBase = {
+    uuid: UUID;
+    session_id: string;
+};
+type SDKUserMessageContent = {
     type: 'user';
     message: APIUserMessage;
     parent_tool_use_id: string | null;
+};
+export type SDKUserMessage = SDKUserMessageContent & {
+    uuid?: UUID;
     session_id: string;
 };
-export type SDKAssistantMessage = {
+export type SDKUserMessageReplay = SDKMessageBase & SDKUserMessageContent;
+export type SDKAssistantMessage = SDKMessageBase & {
     type: 'assistant';
     message: APIAssistantMessage;
     parent_tool_use_id: string | null;
-    session_id: string;
 };
 export type SDKPermissionDenial = {
     tool_name: string;
     tool_use_id: string;
     tool_input: Record<string, unknown>;
 };
-export type SDKResultMessage = {
+export type SDKResultMessage = (SDKMessageBase & {
     type: 'result';
     subtype: 'success';
     duration_ms: number;
@@ -82,28 +172,25 @@ export type SDKResultMessage = {
     is_error: boolean;
     num_turns: number;
     result: string;
-    session_id: string;
     total_cost_usd: number;
     usage: NonNullableUsage;
     permission_denials: SDKPermissionDenial[];
-} | {
+}) | (SDKMessageBase & {
     type: 'result';
     subtype: 'error_max_turns' | 'error_during_execution';
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
     num_turns: number;
-    session_id: string;
     total_cost_usd: number;
     usage: NonNullableUsage;
     permission_denials: SDKPermissionDenial[];
-};
-export type SDKSystemMessage = {
+});
+export type SDKSystemMessage = SDKMessageBase & {
     type: 'system';
     subtype: 'init';
     apiKeySource: ApiKeySource;
     cwd: string;
-    session_id: string;
     tools: string[];
     mcp_servers: {
         name: string;
@@ -112,14 +199,20 @@ export type SDKSystemMessage = {
     model: string;
     permissionMode: PermissionMode;
     slash_commands: string[];
+    output_style: string;
 };
-export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKResultMessage | SDKSystemMessage;
+export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage;
 export interface Query extends AsyncGenerator<SDKMessage, void> {
     /**
      * Interrupt the query.
      * Only supported when streaming input is used.
      */
     interrupt(): Promise<void>;
+    /**
+     * Sets the permission mode.
+     * Only supported when streaming input is used.
+     */
+    setPermissionMode(mode: PermissionMode): Promise<void>;
 }
 /**
  * Query Claude Code
@@ -142,3 +235,4 @@ export declare function query({ prompt, options, }: {
 }): Query;
 export declare class AbortError extends Error {
 }
+export {};