claudestream Documentation https://smmh.dev/claudestream/ 2026-08-12T00:00:00Z claudestream._agent https://smmh.dev/claudestream/claudestream-_agent/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._async_session https://smmh.dev/claudestream/claudestream-_async_session/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._cli https://smmh.dev/claudestream/claudestream-_cli/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._color https://smmh.dev/claudestream/claudestream-_color/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._options https://smmh.dev/claudestream/claudestream-_options/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._process https://smmh.dev/claudestream/claudestream-_process/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._protocol https://smmh.dev/claudestream/claudestream-_protocol/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._sync_session https://smmh.dev/claudestream/claudestream-_sync_session/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream._tools https://smmh.dev/claudestream/claudestream-_tools/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream.messages https://smmh.dev/claudestream/claudestream-messages/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream.policy https://smmh.dev/claudestream/claudestream-policy/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> claudestream agent https://smmh.dev/claudestream/cli-agent/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream ask https://smmh.dev/claudestream/cli-ask/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream config https://smmh.dev/claudestream/cli-config/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream doctor https://smmh.dev/claudestream/cli-doctor/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream events https://smmh.dev/claudestream/cli-events/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream CLI Reference https://smmh.dev/claudestream/cli-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream repl https://smmh.dev/claudestream/cli-repl/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream send https://smmh.dev/claudestream/cli-send/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> claudestream stream https://smmh.dev/claudestream/cli-stream/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> API Reference https://smmh.dev/claudestream/gen-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> Agent Definition Guide https://smmh.dev/claudestream/agents-guide/ 2026-07-29T00:00:00Z Agents are reusable, self-contained session configurations stored as `.agent.json` files. An agent definition bundles a model, system prompt template, tool schemas, sandbox policy, budget constraints, MCP configuration, and stream options into a single file that can be invoked by name from the CLI or programmatically. claudestream.events https://smmh.dev/claudestream/claudestream-events/ 2026-07-29T00:00:00Z | Event Type | Description | | --- | --- | | `SystemInit` | First event in the stream. Contains session metadata. | | `ApiRetry` | Emitted before retrying a failed API call. | | `CompactBoundary` | Emitted when conversation history is compacted. | | `AssistantMessage` | Complete assistant response with content blocks. | | `ToolResultMessage` | Tool execution results returned to the model. | | `AssistantText` | Single text block from an assistant message. | | `ToolUse` | Single tool call from an assistant message. | | `Thinking` | Single thinking block from an assistant message. | | `ToolResult` | Single tool result. | | `FileWrite` | Derived event emitted when a Write tool succeeds. Contains absolute path and content length. | | `FileEdit` | Derived event emitted when an Edit or MultiEdit tool succeeds. Contains absolute path. | | `StreamDelta` | Partial streaming token. Wraps a raw API streaming event. | | `Result` | Final event in a turn. Contains cost and usage summary. | | `BudgetThreshold` | Fired when a budget threshold is crossed. Informational only -- does not stop the session. | | `RateLimit` | Rate limit status change. | | `PermissionRequest` | Permission request from Claude Code. Surfaced when sandbox doesn't auto-resolve. | | `UserDialogRequest` | Blocking user dialog the CLI asks the host to render (e.g. AskUserQuestion). Always surfaced to the consumer; never auto-handled by the sandbox. | | `McpRequest` | MCP tool call request from Claude Code. | | `HookEvent` | Hook lifecycle event from Claude Code (emitted when include_hook_events is True). | | `UnknownEvent` | Forward-compatible event for unrecognized event types. | | `ControlResponse` | Response to a control request (e.g. initialize, mcp_set_servers). | claudestream https://smmh.dev/claudestream/claudestream/ 2026-07-29T00:00:00Z A Python library and CLI for streaming Claude Code's JSON protocol, providing typed events, async/sync sessions, and tool registration. Architecture Guide https://smmh.dev/claudestream/guide/ 2026-07-29T00:00:00Z claudestream wraps the Claude Code CLI's stream-json protocol in a four-layer Python SDK. Each layer adds structure on top of the one below it: Process spawns the subprocess, Protocol decodes its output, Session manages conversation state, and CLI exposes it all as shell commands. claudestream https://smmh.dev/claudestream/ 2026-05-27T00:00:00Z A Python library and CLI for streaming Claude Code's JSON protocol.