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

package/manifest.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.74",
-  "buildDate": "2026-03-11T23:35:46Z",
+  "version": "2.1.75",
+  "buildDate": "2026-03-13T15:55:01Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude",
-      "checksum": "48a07e2887cd4879219d319e48ac5cc6e2098238c7c0abe01c57a35430941cb7",
-      "size": 190412928
+      "checksum": "8c541a5e924eda2070eaf1702a48047af671c4dff6a11a5e762076614a082675",
+      "size": 190611072
     },
     "darwin-x64": {
       "binary": "claude",
-      "checksum": "31fa7ebd424719406cb123f95781c5e795f7a9899611ff1a9213092458d346eb",
-      "size": 196493184
+      "checksum": "82c90b91a0a18f60191f817b9b42304d8b17dbed75795b715c41f4fdfe4c782d",
+      "size": 196691328
     },
     "linux-arm64": {
       "binary": "claude",
-      "checksum": "bfa883897a26433c5132a641b32d1fce00e1eff04a61bf52cd9ab85aeac2ea95",
-      "size": 232315636
+      "checksum": "ec8f4f7f7bb50611dae70c109a76ee1da6a3ab45511c65f117df215848ecc905",
+      "size": 232510985
     },
     "linux-x64": {
       "binary": "claude",
-      "checksum": "e5613610deee76cd32bc9b8e9e364da074fcd880705f837a4c9ee1ec38f9b73b",
-      "size": 235079569
+      "checksum": "328b0a429c05a04f911157d886be5123cf1824a19ba8ca1f9d594c004eac32c9",
+      "size": 235274982
     },
     "linux-arm64-musl": {
       "binary": "claude",
-      "checksum": "72f4bc8e016357111229e9a026b4ff322dd5fa5b2782f59368bd788f78e9af75",
-      "size": 222834724
+      "checksum": "7a2fac946817aec1565d7d31bc553984dbae65f7024b7af1b621a01bd620a41b",
+      "size": 223030073
     },
     "linux-x64-musl": {
       "binary": "claude",
-      "checksum": "08fbc3f3f6d95a5817bff74ef02145196e2d0e5947bd6cc52fd3ea8a8b47a51c",
-      "size": 225677057
+      "checksum": "ba25f78e7b337dd31479fda1203205b20821c69f439f08759710d74db263cde9",
+      "size": 225872470
     },
     "win32-x64": {
       "binary": "claude.exe",
-      "checksum": "f84f832c0661157b38262595f3228353079d8d44c3f24cefe2d67b6d56fd9042",
-      "size": 238872736
+      "checksum": "f1a4f5eafcb702607bc01acb6e80d60013e3e3e164b24196e29f616aa5b58b68",
+      "size": 239061152
     },
     "win32-arm64": {
       "binary": "claude.exe",
-      "checksum": "ee6523a7a53256c0000853f032e185cbe3f9e611c2e9fa0c4285c6c6a9869da4",
-      "size": 233458848
+      "checksum": "6ea22ee1275efdf8bdd0ac1e5e73002a21bf4db6e3d238bfdab7b21fe7ba5078",
+      "size": 233647776
     }
   }
 }

package/manifest.zst.json

@@ -1,46 +1,46 @@
 {
-  "version": "2.1.74",
-  "buildDate": "2026-03-11T23:35:47Z",
+  "version": "2.1.75",
+  "buildDate": "2026-03-13T15:55:02Z",
   "platforms": {
     "darwin-arm64": {
       "binary": "claude.zst",
-      "checksum": "50c27b1f3a01925e48b04bfd3e503a1012de8a78bd132dda6049a936f049b334",
-      "size": 40487878
+      "checksum": "391ef143a82ceaa6f59d380b6e8ead40dfcf5bc35db5fd5751c760298afdbbde",
+      "size": 40566832
     },
     "darwin-x64": {
       "binary": "claude.zst",
-      "checksum": "49a834f737e6bc10595323d601d826397c3057784791e5606d2b4af3058252b1",
-      "size": 42912089
+      "checksum": "d6ce3efaae428548b2730c24eec168b0b9b244c15b6a7f4c80289e8ccd550e9c",
+      "size": 42978259
     },
     "linux-arm64": {
       "binary": "claude.zst",
-      "checksum": "a8125293b6a4b287cb4bdb3d12b05934a52e4ae041a9e96b0c26cf47021b7192",
-      "size": 52381195
+      "checksum": "9e2f4fed48dd190806fd1203f5232ae712c15a782133364323e157d889bc8e4e",
+      "size": 52459272
     },
     "linux-x64": {
       "binary": "claude.zst",
-      "checksum": "0cf4a7438018c0fabbf7c30b5f37d52655ad07949189ea15aaecdd4307eda9e8",
-      "size": 53129648
+      "checksum": "9ca39181bd31367fa9ca92e6cfab7267ab96caf26eb405957f9109f024426b2f",
+      "size": 53213745
     },
     "linux-arm64-musl": {
       "binary": "claude.zst",
-      "checksum": "1db57ebe9c6b1f1d6e40754e232eb1a5aa4b825597365e25ad93a2894735683f",
-      "size": 50360579
+      "checksum": "91026e00e6f8af75ee199f27dfb0d4320b386699a7c176afff9fd5ba075e3e03",
+      "size": 50426167
     },
     "linux-x64-musl": {
       "binary": "claude.zst",
-      "checksum": "9a6b36a8868b2d7edf81fd8b8536d305970543c7921f7a302fe8ea3d93d55822",
-      "size": 51139139
+      "checksum": "c7298eb29275f048cf64d8dad5afed60062e95a6e224902f89bc553723040ae9",
+      "size": 51209611
     },
     "win32-x64": {
       "binary": "claude.exe.zst",
-      "checksum": "420fce72a88bb0d06e21b608e9628d0c0a327080c7c1d4a215d845bd91db3ace",
-      "size": 53630454
+      "checksum": "741a84b1b9ba083ec36d63e1600b445efe738ca9a12eeba2f8c8e751784718d0",
+      "size": 53695392
     },
     "win32-arm64": {
       "binary": "claude.exe.zst",
-      "checksum": "60c7e19a47a2aed64f02e5b8e3d507d9074be70e67adfd24d2e733662c4b17c8",
-      "size": 51698053
+      "checksum": "d1ad85da558e2d9e4fb81e284bf462977e97a193e3b61f43d40a1d76cb49d277",
+      "size": 51783581
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/claude-agent-sdk",
-  "version": "0.2.74",
+  "version": "0.2.75",
   "main": "sdk.mjs",
   "types": "sdk.d.ts",
   "exports": {
@@ -54,5 +54,5 @@
     "@img/sharp-win32-arm64": "^0.34.2",
     "@img/sharp-win32-x64": "^0.34.2"
   },
-  "claudeCodeVersion": "2.1.74"
+  "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;
   /**

package/sdk.d.ts

@@ -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`.
@@ -2020,7 +2050,7 @@ export declare interface SDKSession {
 }
 
 /**
- * Session metadata returned by listSessions.
+ * Session metadata returned by listSessions and getSessionInfo.
  */
 export declare type SDKSessionInfo = {
     /**
@@ -2036,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.
      */
@@ -2055,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;
 };
 
 /**
@@ -3028,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[];
+            };
         };
     };
     /**
@@ -3099,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/**"
@@ -3249,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;