Skip to content

v0.14.0: Python SDK v0.1.51–0.1.56 Parity

Choose a tag to compare

View all tags
@ya-luotao ya-luotao released this 07 Apr 17:06
· 733 commits to main since this release
v0.14.0
1524657
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Python SDK v0.1.51–0.1.56 Parity

Type Completeness

  • AssistantMessage: message_id, stop_reason, session_id, uuid fields
  • AgentDefinition: disallowed_tools, max_turns, initial_prompt, background, effort, permission_mode fields
  • ToolPermissionContext: tool_use_id, agent_id fields
  • PERMISSION_MODES: added dontAsk and auto values

New Types and Options

  • SystemPromptFile class — loads system prompt from a file path via --system-prompt-file CLI flag
  • TaskBudget class — API-side token budget, passed as --task-budget CLI flag
  • ForkSessionResult class — returned by fork_session() with the new session ID
  • session_id and task_budget options on ClaudeAgentOptions

Session Management

  • ClaudeAgentSDK.delete_session(session_id:, directory:) — hard-deletes a session JSONL file
  • ClaudeAgentSDK.fork_session(session_id:, directory:, up_to_message_id:, title:) — filesystem-level fork with UUID remapping, sidechain filtering, content-replacement forwarding, and auto-generated titles
  • offset parameter on ClaudeAgentSDK.list_sessions for cursor-based pagination

Client Introspection

  • Client#get_context_usage / Query#get_context_usage — context window breakdown (tokens by category, model, MCP tools, memory files, etc.)

MCP Robustness

  • SdkMcpTool#meta field and _meta forwarding in tools/list responses — prevents silent truncation of large tool results (>50K chars)
  • create_tool auto-populates _meta from annotations[:maxResultSizeChars] when present
gem install claude-agent-sdk -v 0.14.0
Assets 3
Loading