@anthropic-ai/claude-agent-sdk 0.2.108 → 0.2.110

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.108",
-  "buildDate": "2026-04-14T17:24:14Z",
+  "version": "2.1.110",
+  "buildDate": "2026-04-15T19:43:17Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "8d66163313976b0045b829e37eb3fcccb10ce6fd7e04a6db85d2c3915ff8aaec",
-      "size": 201725936
+      "checksum": "f45cb1b0765f9fc592d36d7153f6c1ff0ecfc3ae9cbc997eaff2b0cd25bff9f6",
+      "size": 202932416
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "9e19adaae3709ce5917d8bf2faa669f560459bf240a2054de4e5e89babd0546a",
-      "size": 203207552
+      "checksum": "d4896277920c253c2bda5e0ae02a3e39486fa203603c2b25cc236533d68518fd",
+      "size": 204376928
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "7bef1f7dcf64a221fc66571a176ca6206088bec48613a46cb4fa6328169c0bd1",
-      "size": 234097216
+      "checksum": "ff5bf0372d1700cfb4d232021c6e0d417205c16392492da0fabc6b509eeee92a",
+      "size": 235145792
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "1f641676eb086ceafd76a5f51ffb260b948fa1f6d77991d8cd6e480267dfff37",
-      "size": 233777792
+      "checksum": "7ecdde57b002d5927e704dcbce04eaafb923644d315259ba2e6ac6f0712163a4",
+      "size": 234871424
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "400758c8de78ad7df94a31011a227e6518ee3bda2a70e73e6860b14250f7de83",
-      "size": 227150272
+      "checksum": "d6878d6c32668ffda513218fe2775f6bdfb718575139ac8e6731b6b4cd485d8a",
+      "size": 227805632
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "02c6aa80ef659404cbb00847fb04c1fda10482ed79cccee1be8d5c88f504685e",
-      "size": 228092352
+      "checksum": "aaaf37cc68acd7a83351f5e788d6a5cede0654b05c6b616ae0c9b6fbacbc1b78",
+      "size": 229120448
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "a375ca41d9d44720d8ecde46fc69285ee7919b496b9a81bbe29b14615d345a1b",
-      "size": 243360416
+      "checksum": "6d267d4bc70b98436d4e55c0c3a6cd310b2e97bb42d215abb646093fce9ea3bd",
+      "size": 244445344
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "b3a1830564168224279e579456a5c43ae65f0bc243bb9f59e45dfb4437f7853e",
-      "size": 240060576
+      "checksum": "e1d4914eead2dddb36e84c15bc1dc9655ae92f0b43a1c7964a7c99900b515bf8",
+      "size": 241153696
     }
   }
 }

package/manifest.zst.json

@@ -1,54 +1,54 @@
 {
-  "version": "2.1.108",
-  "buildDate": "2026-04-14T17:30:45Z",
+  "version": "2.1.110",
+  "buildDate": "2026-04-15T19:50:40Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "7c28a732de86eda4c577f9053d294576627b4d450d2f53d5b84f55c72ed44e5a",
-      "size": 41741470,
+      "checksum": "1fb5c689fdaa40b678a3795d309526ab23b84b2b2b38f205f8d7a9d2222aad01",
+      "size": 41942064,
       "bundle": {
-        "checksum": "2baf55e9593699e31d8b3dfcaaf79540d2973d0d75d2f009f0ee3a27b64df178",
-        "size": 41745569
+        "checksum": "06aadef14bbdbc13ed357be8448c5df15abeb1dbc111596eeea818d3b2f8e32d",
+        "size": 41946957
       }
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "f81eb88ea743b767300ba50693d6e088696c4bdba65f0657de065037429de5d6",
-      "size": 43402062,
+      "checksum": "de6801c997babd684378831681e0a06e57b4e746efeb68210f5358aeb6920b72",
+      "size": 43628781,
       "bundle": {
-        "checksum": "fa1b342ad58091df1af0ca021096766f2c3f6c5fb4b72b80767ae6d9693f3865",
-        "size": 43400123
+        "checksum": "b401f944c23c9d6ba3c4133fe778d7df39957ef326431cac95bae3a1341b50f1",
+        "size": 43630090
       }
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "f5eff301bf4740feccc162d1a168eb0490a18b50c2914b32444d346604ea1432",
-      "size": 51393944
+      "checksum": "cfbd59fc6711d25288500de133a9147e4fc748da0825109a60ab6af3d2c073f8",
+      "size": 51585905
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "63454052ee86e841666d9d372f4283311de90937baf1dae2d174d24d0571abf7",
-      "size": 51942081
+      "checksum": "d0da2a150be75b11f00a7ddc2af9060655f31a9b9b8eb4a8fa0a9d987c8d8285",
+      "size": 52158838
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "d295f68888392b826605dcc78b2bf953566909303afb640e50a2bcc33301bb00",
-      "size": 50065331
+      "checksum": "603a19ed0ac655df3a45152e9a1747551a49012162728df7ff4dba7fc2f6cedd",
+      "size": 50205097
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "a641a1373b2fb31feba1dcc6b6e38716f49d45d47a74350b59bd754b3afbd96a",
-      "size": 50646447
+      "checksum": "e09082eb2677bfbd953754f402e8d737c2e2df106fc2aee4c6dc0a9c9540e795",
+      "size": 50842631
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "0a6edc13e088db9751a800f489bacd979a3d3000b26215a561d40b48fe4c001b",
-      "size": 53617894
+      "checksum": "ed38429823c7751ff385d6cc6ff5ae7bce9a60238d3422f75f2a32963120c9de",
+      "size": 53814271
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "e4b21e60b101608f87a36d11dc9b24e33f6fff1fd07d967e4e11bd5a7fdbbaff",
-      "size": 51777108
+      "checksum": "392a074eca73534b056e3303665d93e1955ac688fdd621a7115b3864526460ad",
+      "size": 51977170
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.108",
+  "version": "0.2.110",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -90,5 +90,5 @@
     "vendor/ripgrep/",
     "vendor/audio-capture/"
   ],
-  "claudeCodeVersion": "2.1.108"
+  "claudeCodeVersion": "2.1.110"
 }

package/sdk-tools.d.ts

@@ -2346,6 +2346,10 @@ export interface FileWriteOutput {
      */
     repository?: string | null;
   };
+  /**
+   * True when the user edited the proposed content in the permission dialog before accepting
+   */
+  userModified?: boolean;
 }
 export interface GlobOutput {
   /**

package/sdk.d.ts

@@ -270,6 +270,7 @@ declare namespace coreTypes {
         NonNullableUsage,
         HOOK_EVENTS,
         EXIT_REASONS,
+        SYSTEM_PROMPT_DYNAMIC_BOUNDARY,
         AccountInfo,
         AgentDefinition,
         AgentInfo,
@@ -347,6 +348,7 @@ declare namespace coreTypes {
         SDKHookStartedMessage,
         SDKLocalCommandOutputMessage,
         SDKMemoryRecallMessage,
+        SDKMessageOrigin,
         SDKMessage,
         SDKNotificationMessage,
         SDKPartialAssistantMessage,
@@ -1433,6 +1435,11 @@ export declare type Options = {
     /**
      * System prompt configuration.
      * - `string` - Use a custom system prompt
+     * - `string[]` - Use a custom system prompt as an array of blocks; include
+     *   `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` as a standalone element to mark the
+     *   split between the static (globally-cacheable) prefix and the dynamic
+     *   (session-specific) suffix. Blocks before the marker are eligible for
+     *   cross-session prompt caching; blocks after it are not.
      * - `{ type: 'preset', preset: 'claude_code' }` - Use Claude Code's default system prompt
      * - `{ type: 'preset', preset: 'claude_code', append: '...' }` - Use default prompt with appended instructions
      * - `{ type: 'preset', preset: 'claude_code', excludeDynamicSections: true }` -
@@ -1454,6 +1461,16 @@ export declare type Options = {
      * systemPrompt: 'You are a helpful coding assistant.'
      * ```
      *
+     * @example Custom prompt with cache boundary
+     * ```typescript
+     * import { SYSTEM_PROMPT_DYNAMIC_BOUNDARY } from '@anthropic-ai/claude-code'
+     * systemPrompt: [
+     *   staticInstructions,
+     *   SYSTEM_PROMPT_DYNAMIC_BOUNDARY,
+     *   sessionContext,
+     * ]
+     * ```
+     *
      * @example Default with additions
      * ```typescript
      * systemPrompt: {
@@ -1472,7 +1489,7 @@ export declare type Options = {
      * }
      * ```
      */
-    systemPrompt?: string | {
+    systemPrompt?: string | string[] | {
         type: 'preset';
         preset: 'claude_code';
         append?: string;
@@ -2206,7 +2223,7 @@ declare type SDKControlInitializeRequest = {
     hooks?: Partial<Record<coreTypes.HookEvent, SDKHookCallbackMatcher[]>>;
     sdkMcpServers?: string[];
     jsonSchema?: Record<string, unknown>;
-    systemPrompt?: string;
+    systemPrompt?: string[];
     appendSystemPrompt?: string;
     /**
      * When true, omit per-user dynamic sections (working directory, auto-memory path) from the cached system prompt and re-inject them as the first user message. Lets cross-user prompt caching hit on a static system prompt prefix. Tradeoff: the model sees this context slightly later in the prompt, so steering on the working directory and memory location is marginally less authoritative. Has no effect when a custom (non-preset) system prompt is in use.
@@ -2321,13 +2338,21 @@ export declare type SDKControlReloadPluginsResponse = {
     error_count: number;
 };
 
+/**
+ * Sets the user-facing title for the current session.
+ */
+declare type SDKControlRenameSessionRequest = {
+    subtype: 'rename_session';
+    title: string;
+};
+
 export declare type SDKControlRequest = {
     type: 'control_request';
     request_id: string;
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlRenameSessionRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlChannelEnableRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlClaudeAuthenticateRequest | SDKControlClaudeOAuthCallbackRequest | SDKControlClaudeOAuthWaitForCompletionRequest | SDKControlRemoteControlRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlOAuthTokenRefreshRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlRequestUserDialogRequest;
 
 /**
  * Requests the SDK consumer to render a tool-driven blocking dialog and return the user choice. Used by tools that previously rendered Ink JSX via setToolJSX with an onDone callback.
@@ -2554,6 +2579,24 @@ export declare type SDKMemoryRecallMessage = {
 
 export declare type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKLocalCommandOutputMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPluginInstallMessage | SDKToolProgressMessage | SDKAuthStatusMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskUpdatedMessage | SDKTaskProgressMessage | SDKSessionStateChangedMessage | SDKNotificationMessage | SDKFilesPersistedEvent | SDKToolUseSummaryMessage | SDKMemoryRecallMessage | SDKRateLimitEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage;
 
+/**
+ * Provenance of a user-role message (peer session, team lead, channel). Absent or `human` means keyboard input from the user.
+ */
+export declare type SDKMessageOrigin = {
+    kind: 'human';
+} | {
+    kind: 'channel';
+    server: string;
+} | {
+    kind: 'peer';
+    from: string;
+    name?: string;
+} | {
+    kind: 'task-notification';
+} | {
+    kind: 'coordinator';
+};
+
 /**
  * Loop-side text notification. Mirrors the interactive REPL notification queue (key/priority/timeout). JSX notifications are not emitted on this channel.
  */
@@ -2676,6 +2719,7 @@ export declare type SDKResultSuccess = {
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
+    api_error_status?: number | null;
     num_turns: number;
     result: string;
     stop_reason: string | null;
@@ -2784,6 +2828,21 @@ export declare type SDKSessionOptions = {
     env?: {
         [envVar: string]: string | undefined;
     };
+    /**
+     * Working directory for the Claude Code process. Defaults to the current
+     * process's working directory.
+     */
+    cwd?: string;
+    /**
+     * Which settings sources to load (CLAUDE.md, `.claude/settings.json`).
+     * Defaults to `[]` — no project/user settings are loaded unless specified.
+     */
+    settingSources?: SettingSource[];
+    /**
+     * Must be set to `true` when using `permissionMode: 'bypassPermissions'`.
+     * This is a safety measure to ensure intentional bypassing of permissions.
+     */
+    allowDangerouslySkipPermissions?: boolean;
     /**
      * List of tool names that are auto-allowed without prompting for permission.
      * These tools will execute automatically without asking the user for approval.
@@ -2807,6 +2866,7 @@ export declare type SDKSessionOptions = {
      * Permission mode for the session.
      * - `'default'` - Standard permission behavior, prompts for dangerous operations
      * - `'acceptEdits'` - Auto-accept file edit operations
+     * - `'bypassPermissions'` - Bypass all permission checks (requires `allowDangerouslySkipPermissions`)
      * - `'plan'` - Planning mode, no execution of tools
      * - `'dontAsk'` - Don't prompt for permissions, deny if not pre-approved
      */
@@ -2988,6 +3048,11 @@ export declare type SDKUserMessage = {
     isSynthetic?: boolean;
     tool_use_result?: unknown;
     priority?: 'now' | 'next' | 'later';
+    origin?: SDKMessageOrigin;
+    /**
+     * When false, the message is appended to the transcript without triggering an assistant turn. It will be merged into the next user message that does query.
+     */
+    shouldQuery?: boolean;
     /**
      * ISO timestamp when the message was created on the originating process. Older emitters omit it; consumers should fall back to receive time.
      */
@@ -3003,6 +3068,11 @@ export declare type SDKUserMessageReplay = {
     isSynthetic?: boolean;
     tool_use_result?: unknown;
     priority?: 'now' | 'next' | 'later';
+    origin?: SDKMessageOrigin;
+    /**
+     * When false, the message is appended to the transcript without triggering an assistant turn. It will be merged into the next user message that does query.
+     */
+    shouldQuery?: boolean;
     /**
      * ISO timestamp when the message was created on the originating process. Older emitters omit it; consumers should fall back to receive time.
      */
@@ -4268,6 +4338,10 @@ export declare interface Settings {
      * Custom directory for plan files, relative to project root. If not set, defaults to ~/.claude/plans/
      */
     plansDirectory?: string;
+    /**
+     * Terminal UI renderer. "fullscreen" uses the flicker-free alt-screen renderer with virtualized scrollback (equivalent to CLAUDE_CODE_NO_FLICKER=1). "default" uses the classic main-screen renderer.
+     */
+    tui?: 'default' | 'fullscreen';
 
     /**
      * Teams/Enterprise opt-in for channel notifications (MCP servers with the claude/channel capability pushing inbound messages). Default off. Set true to allow; users then select servers via --channels.
@@ -4498,6 +4572,16 @@ export declare type SyncHookJSONOutput = {
     hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | PermissionDeniedHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput | CwdChangedHookSpecificOutput | FileChangedHookSpecificOutput | WorktreeCreateHookSpecificOutput;
 };
 
+/**
+ * Marker string that splits a custom `systemPrompt` into a static prefix
+ * (eligible for cross-session prompt caching) and a dynamic suffix
+ * (session-specific, not globally cached). Include this literal as a
+ * standalone element of a `string[]` `systemPrompt` to opt in; blocks
+ * before it get global cache scope, blocks after do not. See
+ * `splitSysPromptPrefix` in `src/utils/api.ts`.
+ */
+export declare const SYSTEM_PROMPT_DYNAMIC_BOUNDARY = "__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__";
+
 /**
  * Tag a session. Pass null to clear the tag.
  * @param sessionId - UUID of the session