@anthropic-ai/claude-agent-sdk 0.2.73 → 0.2.75

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.73",
-  "buildDate": "2026-03-11T15:05:33Z",
+  "version": "2.1.75",
+  "buildDate": "2026-03-13T15:55:01Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "5d402f804dde699c3824e93fefc198d81a52947a43e578286ea01cea9c029a73",
-      "size": 189851520
+      "checksum": "8c541a5e924eda2070eaf1702a48047af671c4dff6a11a5e762076614a082675",
+      "size": 190611072
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "3b03e15e3e809ada49e5a4125eb36508585b6d5adcd715b23d1ca3bedeb2a4e9",
-      "size": 195931776
+      "checksum": "82c90b91a0a18f60191f817b9b42304d8b17dbed75795b715c41f4fdfe4c782d",
+      "size": 196691328
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "7a9d6851c57df4af7ac2800817a81970cf17c388e02d3749610d2fe199c2d0f0",
-      "size": 231753229
+      "checksum": "ec8f4f7f7bb50611dae70c109a76ee1da6a3ab45511c65f117df215848ecc905",
+      "size": 232510985
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "960cd0d71a225f3b946bb49dd5c19624c558077d9cf3da4eb570380b43135b7d",
-      "size": 234516204
+      "checksum": "328b0a429c05a04f911157d886be5123cf1824a19ba8ca1f9d594c004eac32c9",
+      "size": 235274982
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "e8fb09d172884ef29148bf8959a0d31d3497ac567ca8f3efc83535a0b77e6d3e",
-      "size": 222272317
+      "checksum": "7a2fac946817aec1565d7d31bc553984dbae65f7024b7af1b621a01bd620a41b",
+      "size": 223030073
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "60eb9a5a683f103c845917afddd352c92e72bea367cf942c04a959aa56264e5d",
-      "size": 225113692
+      "checksum": "ba25f78e7b337dd31479fda1203205b20821c69f439f08759710d74db263cde9",
+      "size": 225872470
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "8e0312e20fdd4735f309f8cc1d277cd7171823ffb3c4e722e04d741a553f38e0",
-      "size": 238328480
+      "checksum": "f1a4f5eafcb702607bc01acb6e80d60013e3e3e164b24196e29f616aa5b58b68",
+      "size": 239061152
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "151830ad8cedccbd8b1c053ea495a5b63b878379a3004c393a2394cecddf1164",
-      "size": 232914592
+      "checksum": "6ea22ee1275efdf8bdd0ac1e5e73002a21bf4db6e3d238bfdab7b21fe7ba5078",
+      "size": 233647776
     }
   }
 }

package/manifest.zst.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.73",
-  "buildDate": "2026-03-11T15:05:34Z",
+  "version": "2.1.75",
+  "buildDate": "2026-03-13T15:55:02Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "207d2762e9b55d6386bc95422f7be9873a413d5855f89fed342fb58812f87851",
-      "size": 40370522
+      "checksum": "391ef143a82ceaa6f59d380b6e8ead40dfcf5bc35db5fd5751c760298afdbbde",
+      "size": 40566832
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "32b4e987208334516c38f54267e81964a1ca06aeea6b04b02ca272d13ecb5155",
-      "size": 42799457
+      "checksum": "d6ce3efaae428548b2730c24eec168b0b9b244c15b6a7f4c80289e8ccd550e9c",
+      "size": 42978259
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "e3324cae62b5e2b079d0a4219434582e1a00334672f76e15eaa898c0f12ffb95",
-      "size": 52289295
+      "checksum": "9e2f4fed48dd190806fd1203f5232ae712c15a782133364323e157d889bc8e4e",
+      "size": 52459272
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "d4367d1a03f819d8f886e53f537e28765aefcd6212782d87ca99c07c4e8c316b",
-      "size": 53026759
+      "checksum": "9ca39181bd31367fa9ca92e6cfab7267ab96caf26eb405957f9109f024426b2f",
+      "size": 53213745
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "965383f4de337844468245f7658ab8226bbec0747c5c53b5d4091e0571863b24",
-      "size": 50287213
+      "checksum": "91026e00e6f8af75ee199f27dfb0d4320b386699a7c176afff9fd5ba075e3e03",
+      "size": 50426167
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "c4da0de9748bd9058399250f7a1759c71232246991588ec572650647eeee2c3b",
-      "size": 51008966
+      "checksum": "c7298eb29275f048cf64d8dad5afed60062e95a6e224902f89bc553723040ae9",
+      "size": 51209611
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "9ccf960da33e05bc30244ff1b0f3115fcb4f47e5f329647f9013d9551a306c6a",
-      "size": 53513749
+      "checksum": "741a84b1b9ba083ec36d63e1600b445efe738ca9a12eeba2f8c8e751784718d0",
+      "size": 53695392
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "22d58f8b568ef4fc5118fc61f9ef99d957cbfc7aa485761d5e875f374f336a64",
-      "size": 51586350
+      "checksum": "d1ad85da558e2d9e4fb81e284bf462977e97a193e3b61f43d40a1d76cb49d277",
+      "size": 51783581
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.73",
+  "version": "0.2.75",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -11,6 +11,12 @@
     "./embed": {
       "types": "./embed.d.ts",
       "default": "./embed.js"
+    },
+    "./sdk-tools": {
+      "types": "./sdk-tools.d.ts"
+    },
+    "./sdk-tools.js": {
+      "types": "./sdk-tools.d.ts"
     }
   },
   "engines": {
@@ -48,5 +54,5 @@
     "@img/sharp-win32-arm64": "^0.34.2",
     "@img/sharp-win32-x64": "^0.34.2"
   },
-  "claudeCodeVersion": "2.1.73"
+  "claudeCodeVersion": "2.1.75"
 }

package/sdk-tools.d.ts

@@ -110,6 +110,17 @@ export type AgentOutput =
        * Whether the calling agent has Read/Bash tools to check progress
        */
       canReadOutputFile?: boolean;
+    }
+  | {
+      status: "queued_to_running";
+      /**
+       * The ID of the running agent
+       */
+      agentId: string;
+      /**
+       * The prompt that was queued
+       */
+      prompt: string;
     };
 export type FileReadOutput =
   | {
@@ -135,6 +146,10 @@ export type FileReadOutput =
          * Total number of lines in the file
          */
         totalLines: number;
+        /**
+         * True when output was clipped to the byte cap (partial content)
+         */
+        resultWasTruncated?: boolean;
       };
     }
   | {
@@ -279,7 +294,7 @@ export interface AgentInput {
    */
   run_in_background?: boolean;
   /**
-   * Name for the spawned agent
+   * Name for the spawned agent. Makes it addressable via SendMessage({to: name}) while running.
    */
   name?: string;
   /**
@@ -2262,6 +2277,10 @@ export interface BashOutput {
    * True if the user manually backgrounded the command with Ctrl+B
    */
   backgroundedByUser?: boolean;
+  /**
+   * True if assistant-mode auto-backgrounded a long-running blocking command
+   */
+  assistantAutoBackgrounded?: boolean;
   /**
    * Flag to indicate if sandbox mode was overridden
    */

package/sdk.d.ts

@@ -49,9 +49,9 @@ export declare type AgentDefinition = {
      */
     prompt: string;
     /**
-     * Model to use for this agent. If omitted or 'inherit', uses the main model
+     * Model alias (e.g. 'sonnet', 'opus', 'haiku') or full model ID (e.g. 'claude-opus-4-5'). If omitted or 'inherit', uses the main model
      */
-    model?: 'sonnet' | 'opus' | 'haiku' | 'inherit';
+    model?: string;
     mcpServers?: AgentMcpServerSpec[];
     /**
      * Experimental: Critical reminder added to system prompt
@@ -370,6 +370,28 @@ export declare type ExitReason = 'clear' | 'logout' | 'prompt_input_exit' | 'oth
  */
 export declare type FastModeState = 'off' | 'cooldown' | 'on';
 
+/**
+ * Reads metadata for a single session by ID. Unlike `listSessions`, this only
+ * reads the single session file rather than every session in the project.
+ * Returns undefined if the session file is not found, is a sidechain session,
+ * or has no extractable summary.
+ *
+ * @param sessionId - UUID of the session
+ * @param options - `{ dir?: string }` project path; omit to search all project directories
+ */
+export declare function getSessionInfo(_sessionId: string, _options?: GetSessionInfoOptions): Promise<SDKSessionInfo | undefined>;
+
+/**
+ * Options for getSessionInfo.
+ */
+export declare type GetSessionInfoOptions = {
+    /**
+     * Project directory path (same semantics as `listSessions({ dir })`).
+     * When omitted, all project directories are searched for the session file.
+     */
+    dir?: string;
+};
+
 /**
  * Reads a session's conversation messages from its JSONL transcript file.
  *
@@ -447,13 +469,16 @@ export declare type JsonSchemaOutputFormat = {
  * and its git worktrees. When omitted, returns sessions across all
  * projects.
  *
+ * Use `limit` and `offset` for pagination.
+ *
  * @example
  * ```typescript
  * // List sessions for a specific project
  * const sessions = await listSessions({ dir: '/path/to/project' })
  *
- * // List all sessions across all projects
- * const allSessions = await listSessions()
+ * // Paginate
+ * const page1 = await listSessions({ limit: 50 })
+ * const page2 = await listSessions({ limit: 50, offset: 50 })
  * ```
  */
 export declare function listSessions(_options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;
@@ -470,6 +495,11 @@ export declare type ListSessionsOptions = {
     dir?: string;
     /** Maximum number of sessions to return. */
     limit?: number;
+    /**
+     * Number of sessions to skip from the start of the sorted result set.
+     * Use with `limit` for pagination. Defaults to 0.
+     */
+    offset?: number;
     /**
      * When `dir` is provided and the directory is inside a git repository,
      * include sessions from all git worktree paths. Defaults to `true`.
@@ -1412,6 +1442,7 @@ export declare interface Query extends AsyncGenerator<SDKMessage, void> {
     }): Promise<RewindFilesResult>;
 
 
+
     /**
      * Reconnect an MCP server by name.
      * Throws on failure.
@@ -1474,6 +1505,14 @@ export declare function query(_params: {
     options?: Options;
 }): Query;
 
+/**
+ * Rename a session. Appends a custom-title entry to the session's JSONL file.
+ * @param sessionId - UUID of the session
+ * @param title - New title
+ * @param options - `{ dir?: string }` project path; omit to search all projects
+ */
+export declare function renameSession(_sessionId: string, _title: string, _options?: SessionMutationOptions): Promise<void>;
+
 /**
  * Result of a rewindFiles operation.
  */
@@ -1716,7 +1755,7 @@ declare type SDKControlRequest = {
     request: SDKControlRequestInner;
 };
 
-declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlRemoteControlRequest | SDKControlSetProactiveRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest;
+declare type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlEndSessionRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpClearAuthRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlRemoteControlRequest | SDKControlSetProactiveRequest | SDKControlGenerateSessionTitleRequest | SDKControlStopTaskRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest;
 
 declare type SDKControlResponse = {
     type: 'control_response';
@@ -2011,7 +2050,7 @@ export declare interface SDKSession {
 }
 
 /**
- * Session metadata returned by listSessions.
+ * Session metadata returned by listSessions and getSessionInfo.
  */
 export declare type SDKSessionInfo = {
     /**
@@ -2027,9 +2066,9 @@ export declare type SDKSessionInfo = {
      */
     lastModified: number;
     /**
-     * Session file size in bytes.
+     * File size in bytes. Only populated for local JSONL storage.
      */
-    fileSize: number;
+    fileSize?: number;
     /**
      * User-set session title via /rename.
      */
@@ -2046,6 +2085,14 @@ export declare type SDKSessionInfo = {
      * Working directory for the session.
      */
     cwd?: string;
+    /**
+     * User-set session tag.
+     */
+    tag?: string;
+    /**
+     * Creation time in milliseconds since epoch, extracted from the first entry's timestamp.
+     */
+    createdAt?: number;
 };
 
 /**
@@ -2247,6 +2294,18 @@ export declare type SessionMessage = {
     parent_tool_use_id: null;
 };
 
+/**
+ * Options shared by session mutation functions (renameSession, tagSession,
+ * deleteSession).
+ */
+export declare type SessionMutationOptions = {
+    /**
+     * Project directory path (same semantics as `listSessions({ dir })`).
+     * When omitted, all project directories are searched for the session file.
+     */
+    dir?: string;
+};
+
 export declare type SessionStartHookInput = BaseHookInput & {
     hook_event_name: 'SessionStart';
     source: 'startup' | 'resume' | 'clear' | 'compact';
@@ -2354,10 +2413,6 @@ export declare interface Settings {
          * Disable the ability to bypass permission prompts
          */
         disableBypassPermissionsMode?: 'disable';
-        /**
-         * Disable auto mode
-         */
-        disableAutoMode?: 'disable';
         /**
          * Additional directories to include in the permission scope
          */
@@ -3011,6 +3066,12 @@ export declare interface Settings {
                     [k: string]: string | number | boolean | string[];
                 };
             };
+            /**
+             * Non-sensitive option values from plugin manifest userConfig, keyed by option name. Sensitive values go to secure storage instead.
+             */
+            options?: {
+                [k: string]: string | number | boolean | string[];
+            };
         };
     };
     /**
@@ -3042,6 +3103,10 @@ export declare interface Settings {
      * Enable auto-memory for this project. When false, Claude will not read from or write to the auto-memory directory.
      */
     autoMemoryEnabled?: boolean;
+    /**
+     * Custom directory path for auto-memory storage. Supports ~/ prefix for home directory expansion. Ignored if set in projectSettings (checked-in .claude/settings.json) for security. When unset, defaults to ~/.claude/projects/<sanitized-cwd>/memory/.
+     */
+    autoMemoryDirectory?: string;
     /**
      * Show thinking summaries in the transcript view (ctrl+o). Default: false.
      */
@@ -3050,6 +3115,10 @@ export declare interface Settings {
      * Whether the user has accepted the bypass permissions mode dialog
      */
     skipDangerousModePermissionPrompt?: boolean;
+    /**
+     * Disable auto mode
+     */
+    disableAutoMode?: 'disable';
     /**
      * SSH connection configurations for remote environments. Typically set in managed settings by enterprise administrators to pre-configure SSH connections for team members.
      */
@@ -3074,6 +3143,10 @@ export declare interface Settings {
          * Path to SSH identity file (private key)
          */
         sshIdentityFile?: string;
+        /**
+         * Default working directory on the remote host. Supports tilde expansion (e.g. ~/projects). If not specified, defaults to the remote user home directory. Can be overridden by the [dir] positional argument in `claude ssh <config> [dir]`.
+         */
+        startDirectory?: string;
     }[];
     /**
      * Glob patterns or absolute paths of CLAUDE.md files to exclude from loading. Patterns are matched against absolute file paths using picomatch. Only applies to User, Project, and Local memory types (Managed/policy files cannot be excluded). Examples: "/home/user/monorepo/CLAUDE.md", "** /code/CLAUDE.md", "** /some-dir/.claude/rules/**"
@@ -3224,6 +3297,14 @@ export declare type SyncHookJSONOutput = {
     hookSpecificOutput?: PreToolUseHookSpecificOutput | UserPromptSubmitHookSpecificOutput | SessionStartHookSpecificOutput | SetupHookSpecificOutput | SubagentStartHookSpecificOutput | PostToolUseHookSpecificOutput | PostToolUseFailureHookSpecificOutput | NotificationHookSpecificOutput | PermissionRequestHookSpecificOutput | ElicitationHookSpecificOutput | ElicitationResultHookSpecificOutput;
 };
 
+/**
+ * Tag a session. Pass null to clear the tag.
+ * @param sessionId - UUID of the session
+ * @param tag - Tag string, or null to clear
+ * @param options - `{ dir?: string }` project path; omit to search all projects
+ */
+export declare function tagSession(_sessionId: string, _tag: string | null, _options?: SessionMutationOptions): Promise<void>;
+
 export declare type TaskCompletedHookInput = BaseHookInput & {
     hook_event_name: 'TaskCompleted';
     task_id: string;