{
  "tool": "claude-agent-sdk",
  "name": "Claude Agent SDK",
  "long_name": "Anthropic Claude Agent SDK (@anthropic-ai/claude-agent-sdk, claude-agent-sdk)",
  "aliases": [
    "claude-agent",
    "claude-agents",
    "claude-agents-sdk",
    "claude-agent-sdk-typescript",
    "claude-agent-sdk-python",
    "claude-code-sdk",
    "@anthropic-ai/claude-agent-sdk",
    "anthropic-agent-sdk",
    "anthropic-claude-agent-sdk"
  ],
  "homepage": "https://github.com/anthropics/claude-agent-sdk-typescript",
  "surface_kind": "library",
  "url": "https://insidetheloop.dev/tools/claude-agent-sdk",
  "markdown_url": "https://insidetheloop.dev/tools/claude-agent-sdk.md",
  "date_modified": "2026-10-10T12:09:04Z",
  "title": "Claude Agent SDK 0.3.296: latest version, API diff and gotchas",
  "description": "Claude Agent SDK v0.3.296 (2026-10-09 UTC): install commands, our API export diff against 0.3.295 and 0.2.141, and errors we reproduced in the sandbox.",
  "answer": "The latest Claude Agent SDK is 0.3.296 (`@anthropic-ai/claude-agent-sdk` on npm), released on 2026-10-09 at 19:28 UTC (npm published 16:59 UTC); install with `npm i @anthropic-ai/claude-agent-sdk@latest`. Python applications install `claude-agent-sdk` (`0.2.165` on PyPI, released 2026-10-08 18:18 UTC). Release 0.3.296 surfaces `claude_code_version` in the `initialize` control response, adds `autoCompactWindow` to `AgentDefinition` for subagent context compaction, merges sandbox options with inline settings, and raises upfront MCP tool description character limits from 2,048 to 4,096.",
  "latest": {
    "version": "0.3.296",
    "released_at": "2026-10-09T19:28:19Z",
    "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
  },
  "upgrade": [
    {
      "label": "TypeScript / JavaScript (Node.js 18 or later)",
      "command": "npm i @anthropic-ai/claude-agent-sdk@latest\nnpm ls @anthropic-ai/claude-agent-sdk   # @anthropic-ai/claude-agent-sdk@0.3.296"
    },
    {
      "label": "Python (Python 3.10 or later)",
      "command": "pip install -U claude-agent-sdk\npython3 -c \"import claude_agent_sdk; print(getattr(claude_agent_sdk, '__version__', 'installed'))\"   # 0.2.165"
    },
    {
      "label": "TypeScript compiler prerequisites (tsconfig.json)",
      "command": "npm i -D @types/node typescript@^5.6\n# In tsconfig.json, ensure \"lib\": [\"ES2022\", \"ESNext.Disposable\"] and \"moduleResolution\": \"NodeNext\""
    }
  ],
  "verified": {
    "date": "2026-10-10",
    "version": "0.3.296",
    "method": "Installed @anthropic-ai/claude-agent-sdk 0.2.141, 0.3.295 and 0.3.296 from npm in throwaway Linux sandboxes (Node.js 24.21.0, TypeScript 6.0.3) with no credentials. Listed every export across all package entry points with the TypeScript compiler API (357 symbols for 0.2.141, 741 symbols for 0.3.295 and 0.3.296) using bin/tool-snapshot and compared them with bin/tool-diff. Reproduced CLAUDE_SDK_CAN_USE_TOOL_SHADOWED runtime warning, authentication error results and compiler errors for removed exports in throwaway sandbox runs."
  },
  "updated_at": "2026-10-10T12:09:04Z",
  "key_facts": [
    "Dual ecosystem with bundled binary: The SDK runs Claude Code's agent loop programmatically in TypeScript (`@anthropic-ai/claude-agent-sdk` on npm, repo `anthropics/claude-agent-sdk-typescript`) and Python (`claude-agent-sdk` on PyPI, repo `anthropics/claude-agent-sdk-python`). Both packages bundle a native Claude Code CLI binary as platform-specific optional dependencies, running the agent loop over stdio.",
    "Latest releases: TypeScript SDK 0.3.296 (GitHub release 2026-10-09 19:28 UTC; npm published 16:59 UTC; parity with Claude Code 2.1.296). Python SDK 0.2.165 (GitHub release 2026-10-08 18:21 UTC; PyPI published 18:18 UTC).",
    "Download demand: npm recorded 11,982,584 downloads for `@anthropic-ai/claude-agent-sdk` from 2026-10-02 through 2026-10-08. GitHub repository `anthropics/claude-agent-sdk-typescript` has 1,796 stars.",
    "Runtime requirements: Node.js 18.0.0 or later for TypeScript; Python 3.10 or later for Python. Peer dependencies in npm: `zod ^4.0.0`, `@anthropic-ai/sdk >=0.93.0`, and `@modelcontextprotocol/sdk ^1.29.0`.",
    "Entry points: npm package exports `.` (`sdk.mjs`/`sdk.d.ts`), `./core` (`core.mjs`/`core.d.ts`), `./bridge` (`bridge.mjs`/`bridge.d.ts`), `./browser` (`browser-sdk.js`/`browser-sdk.d.ts`), `./extract` (`extractFromBunfs.js`/`extractFromBunfs.d.ts`), and `./sdk-tools` (`sdk-tools.d.ts`). The legacy `./assistant` subpath was removed from the package exports in 0.3.181.",
    "Subagent compaction: 0.3.296 added `autoCompactWindow` to `AgentDefinition`, letting subagents auto-compact earlier than the parent session's context window.",
    "Tool description expansion: 0.3.296 doubled the upfront MCP tool description limit and server instruction cap from 2,048 to 4,096 characters. 0.3.295 cut descriptions loaded via tool search at 16,384 characters."
  ],
  "releases": [
    {
      "version": "0.3.296",
      "released_at": "2026-10-09T19:28:19Z",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296",
      "changes": [
        {
          "text": "Added `claude_code_version` to the `initialize` control response so clients know the CLI version before the first turn.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
        },
        {
          "text": "Added `autoCompactWindow` to `AgentDefinition`, so a subagent can auto-compact earlier than the main conversation's window.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
        },
        {
          "text": "Fixed the `sandbox` option discarding an inline `settings.sandbox` block: the two now merge, option values win, and deny/credential lists combine.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
        },
        {
          "text": "Changed the default limit on MCP tool descriptions sent up front and on MCP server instructions from 2,048 to 4,096 characters.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
        },
        {
          "text": "Changed permission answers arriving after restart: over 4,096 `updatedPermissions` entries count as denial, and malformed lists are ignored as a whole.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
        }
      ]
    },
    {
      "version": "0.3.295",
      "released_at": "2026-10-08T19:48:40Z",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295",
      "changes": [
        {
          "text": "Added `overageEnabled` to `SDKRateLimitInfo` to indicate whether extra usage is enabled on usage-limit warnings.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295"
        },
        {
          "text": "Changed MCP tool descriptions loaded through tool search to be cut at 16,384 characters instead of 2,048.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295"
        },
        {
          "text": "Fixed assistant text blocks losing their `citations` in streamed responses.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295"
        },
        {
          "text": "Changed named option passing to Claude Code: named option values are now sent in the same argument as their flag (`--flag=value`).",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295"
        },
        {
          "text": "Capped MCP Apps `tool_use_result`: `structuredContent` or `_meta` over 8,388,608 JSON characters is omitted.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295"
        }
      ]
    },
    {
      "version": "0.3.294",
      "released_at": "2026-10-08T05:03:42Z",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.294",
      "changes": [
        {
          "text": "Updated to parity with Claude Code v2.1.294.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.294"
        }
      ]
    },
    {
      "version": "0.3.293",
      "released_at": "2026-10-07T18:10:38Z",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.293",
      "changes": [
        {
          "text": "Added an optional `subagent_type` to `background_tasks_changed` task entries, letting hosts inspect subagent types without pairing with `task_started`.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.293"
        },
        {
          "text": "Updated to parity with Claude Code v2.1.293.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.293"
        }
      ]
    },
    {
      "version": "0.3.292",
      "released_at": "2026-10-06T18:59:14Z",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.292",
      "changes": [
        {
          "text": "Added `agent_id` to subagent `assistant` and `user` messages, matching the subagent's `task_id` and persisting across resumes.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.292"
        },
        {
          "text": "Added `parent_task_id` to `task_started` events and `background_tasks_changed` entries, tracking the parent subagent.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.292"
        },
        {
          "text": "Added typed `sections` and `notes` to the `ListAgents` tool's `tool_use_result`, removing the need to parse text output.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.292"
        },
        {
          "text": "Fixed subagents with declared auto permission mode having tool calls evaluated by auto-mode classifier when auto mode is unavailable.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.292"
        }
      ]
    }
  ],
  "surface": [
    {
      "from": "0.3.295",
      "to": "0.3.296",
      "method": "`bin/tool-snapshot` installed both versions in a throwaway Linux sandbox and listed every export of every package entry point from the type declarations with the TypeScript compiler API (741 and 741 exported symbols), then `bin/tool-diff` compared them. In the tables, \"command\" is an exported symbol and \"flags\" are its public members (function parameters in parentheses).",
      "summary": "0 exports added, 0 removed, 7 exports with public members added or removed; 12 declarations changed in any way.",
      "exports_added": [],
      "exports_removed": [],
      "members": [
        {
          "export": "@anthropic-ai/claude-agent-sdk AgentDefinition",
          "added": [
            "autoCompactWindow"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk SDKControlInitializeResponse",
          "added": [
            "claude_code_version"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk/bridge AttachBridgeSessionOptions",
          "added": [
            "claudeCodeVersion"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk/core AgentDefinition",
          "added": [
            "autoCompactWindow"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk/core SDKControlInitializeResponse",
          "added": [
            "claude_code_version"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk/sdk-tools FileReadInput",
          "added": [
            "allow_large"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk/sdk-tools.js FileReadInput",
          "added": [
            "allow_large"
          ],
          "removed": []
        }
      ],
      "notes": [
        "Consecutive releases across 0.3.295 and 0.3.296. Total exported symbols remained steady at 741 across all 6 package entry points.",
        "`autoCompactWindow?: number` was added to `AgentDefinition` in both root and `./core` entry points, allowing subagents to trigger context compaction independently before the main session's window fills.",
        "`claude_code_version: string` was added to `SDKControlInitializeResponse` (and `claudeCodeVersion` to `AttachBridgeSessionOptions`), letting hosts inspect the bundled engine version on initialization before sending user turns.",
        "`FileReadInput.allow_large?: boolean` added in `./sdk-tools` declarations reflects Claude Code 2.1.296's Read tool option for reading large files past default chunk limits."
      ]
    },
    {
      "from": "0.2.141",
      "to": "0.3.296",
      "method": "`bin/tool-snapshot` installed both versions in a throwaway Linux sandbox and listed every export of every package entry point from the type declarations with the TypeScript compiler API (357 and 741 exported symbols), then `bin/tool-diff` compared them. In the tables, \"command\" is an exported symbol and \"flags\" are its public members (function parameters in parentheses).",
      "summary": "405 exports added, 21 removed, 108 exports with public members added or removed; 141 declarations changed in any way.",
      "exports_added": [
        "@anthropic-ai/claude-agent-sdk BackgroundTaskSummary",
        "@anthropic-ai/claude-agent-sdk ClaimOptions",
        "@anthropic-ai/claude-agent-sdk DirectoryAddedHookInput",
        "@anthropic-ai/claude-agent-sdk FastModeDisabledReason",
        "@anthropic-ai/claude-agent-sdk McpServerProvenance",
        "@anthropic-ai/claude-agent-sdk MessageDisplayHookInput",
        "@anthropic-ai/claude-agent-sdk MessageDisplayHookSpecificOutput",
        "@anthropic-ai/claude-agent-sdk SDKActiveGoalMessage",
        "@anthropic-ai/claude-agent-sdk SDKBackgroundTasksChangedMessage",
        "@anthropic-ai/claude-agent-sdk SDKCommandsChangedMessage"
      ],
      "exports_removed": [
        "@anthropic-ai/claude-agent-sdk unstable_v2_createSession",
        "@anthropic-ai/claude-agent-sdk unstable_v2_prompt",
        "@anthropic-ai/claude-agent-sdk unstable_v2_resumeSession",
        "@anthropic-ai/claude-agent-sdk SDKSession",
        "@anthropic-ai/claude-agent-sdk SDKSessionOptions",
        "@anthropic-ai/claude-agent-sdk/assistant AssistantSession"
      ],
      "members": [
        {
          "export": "@anthropic-ai/claude-agent-sdk AgentDefinition",
          "added": [
            "autoCompactWindow"
          ],
          "removed": []
        },
        {
          "export": "@anthropic-ai/claude-agent-sdk/sdk-tools FileReadInput",
          "added": [
            "allow_large"
          ],
          "removed": []
        }
      ],
      "notes": [
        "Major API evolution from the 0.2 line (0.2.141 on 2026-05-13) to the current 0.3 line (0.3.296 on 2026-10-09). Symbol count more than doubled from 357 to 741.",
        "Removed legacy experimental v2 session APIs (`unstable_v2_createSession`, `unstable_v2_prompt`, `unstable_v2_resumeSession`, `SDKSession`, `SDKSessionOptions`) and deleted the `./assistant` entry point in favor of the unified `query()` generator and `./core` architecture.",
        "Introduced comprehensive lifecycle hooks (`DirectoryAddedHook`, `MessageDisplayHook`, `PreModelSwitchHook`, `PostModelSwitchHook`), background task coordination events, and full subagent hierarchy support (`parent_task_id`, `agent_id`, `run_id`)."
      ]
    }
  ],
  "breaking": [
    {
      "version": "0.3.142",
      "change": "Removed deprecated v2 session API exports (`unstable_v2_createSession`, `unstable_v2_prompt`, `unstable_v2_resumeSession`, `SDKSession`, `SDKSessionOptions`).",
      "migrate": "Migrate all session management to `query()`. For multi-turn interactions, pass an `AsyncIterable<SDKUserMessage>`; to resume existing sessions, pass `options.resume` with the session ID.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.142"
    },
    {
      "version": "0.3.181",
      "change": "Removed the `@anthropic-ai/claude-agent-sdk/assistant` export subpath from the npm package exports.",
      "migrate": "Import supported APIs from `@anthropic-ai/claude-agent-sdk` or `@anthropic-ai/claude-agent-sdk/core`; do not import from `@anthropic-ai/claude-agent-sdk/assistant`.",
      "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk/0.3.181"
    },
    {
      "version": "0.3.142",
      "change": "MCP servers connect in the background by default on session startup; sessions start immediately without blocking for external MCP readiness, reporting `status: 'pending'` in `init`.",
      "migrate": "Set `MCP_CONNECTION_NONBLOCKING=0` to restore blocking connection behavior up to 5s before turn 1, or mark critical servers with `alwaysLoad: true` in your server configuration.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.142"
    },
    {
      "version": "0.3.142",
      "change": "Headless and SDK sessions replaced `TodoWrite` with dedicated Task tools (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`).",
      "migrate": "Update custom tool consumers and handlers to process incremental Task tool invocations by task ID rather than expecting monolithic todo snapshots.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.142"
    },
    {
      "version": "0.3.296",
      "change": "Permission answers arriving after process restart enforce strict parsing parity with live turns: answer lists with over 4,096 `updatedPermissions` entries are treated as explicit denials, and malformed update arrays are rejected as a unit.",
      "migrate": "Batch permission updates under 4,096 items and ensure permission serialization preserves valid rule schemas across host restarts.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
    }
  ],
  "gotchas": [
    {
      "title": "`canUseTool` callback is bypassed when tool names are in `allowedTools`",
      "version": "0.3.296",
      "command": "import { query } from \"@anthropic-ai/claude-agent-sdk\";\nconst q = query({ prompt: \"hello\", options: { allowedTools: [\"Read\"], canUseTool: async () => ({ allow: true }) } });\nfor await (const msg of q) {}",
      "output": "(node:3) [CLAUDE_SDK_CAN_USE_TOOL_SHADOWED] Warning: canUseTool will not be invoked for: Read. Bare allowedTools entries auto-approve the whole tool before the callback is consulted. To gate every tool call, use a PreToolUse hook; or remove the bare names from allowedTools so they fall through to canUseTool. Allow rules from settings files can also shadow the callback but are not visible here.",
      "fix": "Remove bare tool names from `allowedTools` to allow calls to be evaluated by `canUseTool`, or use a `PreToolUse` hook to enforce fine-grained inspection on all tool calls.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.198"
    },
    {
      "title": "`query()` fails immediately with `Not logged in` if credentials are not configured",
      "version": "0.3.296",
      "command": "import { query } from \"@anthropic-ai/claude-agent-sdk\";\nconst q = query({ prompt: \"hello\" });\nfor await (const msg of q) {}",
      "output": "caught: Error Claude Code returned an error result: Not logged in · Please run /login",
      "fix": "Set the `ANTHROPIC_API_KEY` environment variable in the process running the SDK, or run `claude /login` to configure OAuth credentials before initializing the query generator.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/blob/v0.3.296/README.md"
    },
    {
      "title": "Removed session and assistant imports fail to compile",
      "version": "0.3.296",
      "command": "import { unstable_v2_createSession } from \"@anthropic-ai/claude-agent-sdk\";\nimport { AssistantSession } from \"@anthropic-ai/claude-agent-sdk/assistant\";",
      "output": "probe.ts(1,10): error TS2305: Module '\"@anthropic-ai/claude-agent-sdk\"' has no exported member 'unstable_v2_createSession'.\nprobe.ts(2,34): error TS2307: Cannot find module '@anthropic-ai/claude-agent-sdk/assistant' or its corresponding type declarations.",
      "fix": "Replace `unstable_v2_createSession` with `query({ prompt, options })`, and import supported APIs from `@anthropic-ai/claude-agent-sdk` or `@anthropic-ai/claude-agent-sdk/core`.",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.142"
    }
  ],
  "monthly": [
    {
      "month": "2026-10",
      "count": 10,
      "from": "0.3.287",
      "to": "0.3.296",
      "highlights": [
        {
          "text": "0.3.296: Surfaced `claude_code_version` in initialize control response and added `autoCompactWindow` to `AgentDefinition`.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.296"
        },
        {
          "text": "0.3.295: Added `overageEnabled` to `SDKRateLimitInfo` and raised MCP tool search description limit to 16,384 characters.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.295"
        },
        {
          "text": "0.3.292: Added `agent_id`, `parent_task_id`, and `run_id` for tracking nested background subagent execution trees.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.292"
        }
      ]
    },
    {
      "month": "2026-09",
      "count": 27,
      "from": "0.3.257",
      "to": "0.3.286",
      "highlights": [
        {
          "text": "0.3.286: Added `sdk_mcp_manifests_parked` initialize response field and priority message turn joining.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.286"
        },
        {
          "text": "0.3.257: Added `thinkingTokens` to `ModelUsage` and `resourceLinks` on MCP tool result blocks.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.257"
        }
      ]
    },
    {
      "month": "2026-08",
      "count": 29,
      "from": "0.3.221",
      "to": "0.3.252",
      "highlights": [
        {
          "text": "0.3.221: Added strict skill option name validation and introduced `skills: 'all'` wildcard option.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.221"
        },
        {
          "text": "0.3.252: Updated to parity with Claude Code v2.1.252.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.252"
        }
      ]
    },
    {
      "month": "2026-07",
      "count": 23,
      "from": "0.3.198",
      "to": "0.3.220",
      "highlights": [
        {
          "text": "0.3.198: Added runtime warning when `canUseTool` is shadowed by `allowedTools` or `bypassPermissions`.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.198"
        },
        {
          "text": "0.3.220: Updated to parity with Claude Code v2.1.220.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.220"
        }
      ]
    },
    {
      "month": "2026-06",
      "count": 30,
      "from": "0.3.160",
      "to": "0.3.197",
      "highlights": [
        {
          "text": "0.3.160: Fixed SDK hook callbacks swallowing abort signals during `PostToolUse` execution.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.160"
        },
        {
          "text": "0.3.197: Updated to parity with Claude Code v2.1.197.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.197"
        }
      ]
    },
    {
      "month": "2026-05",
      "count": 27,
      "from": "0.2.128",
      "to": "0.3.159",
      "highlights": [
        {
          "text": "0.3.142: Removed the legacy v2 session API in favor of `query()` and switched sessions to Task tools.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.3.142"
        },
        {
          "text": "0.2.141: Added Task tool schema type exports to `sdk-tools` union types.",
          "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases/tag/v0.2.141"
        }
      ]
    }
  ],
  "sources": [
    {
      "title": "GitHub Releases: anthropics/claude-agent-sdk-typescript",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/releases",
      "read": "2026-10-10"
    },
    {
      "title": "CHANGELOG.md at v0.3.296",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript/blob/v0.3.296/CHANGELOG.md",
      "read": "2026-10-10"
    },
    {
      "title": "npm package: @anthropic-ai/claude-agent-sdk",
      "url": "https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk",
      "read": "2026-10-10"
    },
    {
      "title": "npm download statistics: @anthropic-ai/claude-agent-sdk",
      "url": "https://api.npmjs.org/downloads/point/last-week/@anthropic-ai/claude-agent-sdk",
      "read": "2026-10-10"
    },
    {
      "title": "PyPI package: claude-agent-sdk",
      "url": "https://pypi.org/project/claude-agent-sdk/",
      "read": "2026-10-10"
    },
    {
      "title": "GitHub repository: anthropics/claude-agent-sdk-typescript",
      "url": "https://github.com/anthropics/claude-agent-sdk-typescript",
      "read": "2026-10-10"
    },
    {
      "title": "Anthropic Claude Code SDK documentation",
      "url": "https://docs.anthropic.com/en/docs/claude-code/sdk",
      "read": "2026-10-10"
    },
    {
      "title": "npm package exports at v0.3.181",
      "url": "https://registry.npmjs.org/@anthropic-ai/claude-agent-sdk/0.3.181",
      "read": "2026-10-10"
    }
  ],
  "fixes": []
}