@scottwalker/claude-connector 0.3.0 → 0.4.1

package/README.md

@@ -1,9 +1,9 @@
 <p align="center">
-  <img src="etc/logo-rounded.svg" alt="Claude Code — In Your Code" width="350" />
+  <picture>
+    <img src="landing/assets/origin.png" alt="Claude Connector" width="250" style="border-radius: 16px" />
+  </picture>
 </p>
 
-<h1 align="center">Claude Connector</h1>
-
 Programmatic Node.js interface for [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) CLI.
 
 Use Claude Code from your application code — no terminal required. Works with your existing Max/Team/Enterprise subscription.
@@ -299,6 +299,177 @@ const claude = new Claude({
 })
 ```
 
+### Programmatic Permissions
+
+Control tool approval with a callback instead of static permission modes:
+
+```typescript
+import { Claude } from '@scottwalker/claude-connector'
+
+const claude = new Claude({
+  canUseTool: (tool, args) => {
+    if (tool === 'Bash' && args.command?.includes('rm ')) return false
+    if (tool === 'Edit') return true
+    return 'ask' // fall back to default behavior
+  },
+})
+```
+
+### In-Process MCP Tools
+
+Define custom tools that run in-process — no external MCP server required:
+
+```typescript
+import { Claude, createSdkMcpServer, sdkTool } from '@scottwalker/claude-connector'
+
+const server = createSdkMcpServer({
+  tools: {
+    getUser: sdkTool({ id: { type: 'string' } }, async ({ id }) => {
+      return { name: 'Alice', role: 'admin' }
+    }),
+  },
+})
+const claude = new Claude({ mcpServers: { myTools: server } })
+```
+
+### JS Hook Callbacks
+
+Subscribe to all 21 hook events with native JS callbacks (no shell commands):
+
+```typescript
+import { Claude } from '@scottwalker/claude-connector'
+
+const claude = new Claude({
+  hookCallbacks: {
+    PreToolUse: ({ toolName, args }) => {
+      if (toolName === 'Bash' && args.command?.includes('sudo')) return 'deny'
+    },
+    PostToolUse: ({ toolName, result }) => console.log(`${toolName} done`),
+    Notification: ({ message }) => sendSlack(message),
+  },
+})
+```
+
+### Thinking Config
+
+Control Claude's reasoning behavior:
+
+```typescript
+import { Claude } from '@scottwalker/claude-connector'
+
+const claude = new Claude({ thinking: { type: 'enabled' } })
+// 'adaptive' — Claude decides | 'enabled' — always think | 'disabled' — no thinking
+```
+
+### Runtime Control
+
+Change model or permission mode during a session:
+
+```typescript
+import { Claude, PERMISSION_PLAN } from '@scottwalker/claude-connector'
+
+const claude = new Claude({ model: 'sonnet' })
+claude.setModel('opus')                       // switch to a more capable model
+claude.setPermissionMode(PERMISSION_PLAN)     // tighten permissions mid-session
+```
+
+### Dynamic MCP
+
+Add, reconnect, or toggle MCP servers at runtime:
+
+```typescript
+const claude = new Claude()
+claude.setMcpServers({ db: { command: 'npx', args: ['@db/mcp'] } })
+await claude.reconnectMcpServer('db')   // restart after config change
+claude.toggleMcpServer('db', false)     // temporarily disable
+```
+
+### File Checkpointing
+
+Snapshot and restore files modified by Claude:
+
+```typescript
+const claude = new Claude({ enableFileCheckpointing: true })
+const result = await claude.query('Refactor the auth module')
+// Something went wrong? Roll back all file changes:
+await claude.rewindFiles(result.sessionId!)
+```
+
+### Account & Model Info
+
+Query your subscription info and available models:
+
+```typescript
+const claude = new Claude()
+const account = await claude.accountInfo()       // { plan, usage, limits }
+const models = await claude.supportedModels()    // ['opus', 'sonnet', ...]
+const agents = await claude.supportedAgents()    // available agent types
+```
+
+### Per-Query Abort
+
+Cancel individual queries with standard `AbortSignal`:
+
+```typescript
+const controller = new AbortController()
+setTimeout(() => controller.abort(), 30_000)     // 30s timeout
+
+const result = await claude.query('Long analysis task', {
+  signal: controller.signal,
+})
+```
+
+### Subagent Control
+
+Monitor and stop spawned subagent tasks:
+
+```typescript
+const handle = claude.stream('Run a full analysis')
+  .on('task_started', (e) => console.log(`Subagent: ${e.taskId}`))
+  .on('task_progress', (e) => console.log(`Progress: ${e.status}`))
+  .on('task_notification', (e) => console.log(e.message))
+
+// Stop a specific subagent
+await claude.stopTask(taskId)
+```
+
+### Settings & Plugins
+
+Provide CLAUDE.md instructions, settings overrides, and plugins programmatically:
+
+```typescript
+const claude = new Claude({
+  settingSources: ['./project/CLAUDE.md', './team/CLAUDE.md'],
+  settings: { preferredLanguage: 'TypeScript', maxFileSize: 10_000 },
+  plugins: ['@claude/eslint-plugin', '@claude/prettier-plugin'],
+})
+```
+
+### Custom Process Spawn
+
+Override how Claude Code processes are created — useful for VMs, containers, or remote execution:
+
+```typescript
+import { Claude } from '@scottwalker/claude-connector'
+
+const claude = new Claude({
+  spawnClaudeCodeProcess: (args, env) => {
+    // Run inside a Docker container instead of locally
+    return spawn('docker', ['exec', 'my-sandbox', 'claude', ...args], { env })
+  },
+})
+```
+
+### Session Utilities
+
+List and inspect past sessions:
+
+```typescript
+const claude = new Claude()
+const sessions = await claude.listSessions()          // all session IDs + metadata
+const messages = await claude.getSessionMessages(id)  // full message history
+```
+
 ### Full Configuration
 
 All Claude Code CLI capabilities in one place:

package/dist/client/claude.d.ts

@@ -1,4 +1,4 @@
-import type { ClientOptions, QueryOptions, QueryResult } from '../types/index.js';
+import type { ClientOptions, QueryOptions, QueryResult, AccountInfo, ModelInfo, SlashCommand, AgentInfo, McpServerStatus, McpSetServersResult, RewindFilesResult, McpServerConfig, McpSdkServerConfig, PermissionMode } from '../types/index.js';
 import type { SessionOptions } from '../types/session.js';
 import type { IExecutor } from '../executor/interface.js';
 import { type InitStage } from '../executor/sdk-executor.js';
@@ -54,37 +54,11 @@ export declare class Claude {
      * Execute a query with streaming response.
      * Returns a {@link StreamHandle} with fluent callbacks, Node.js stream support,
      * and backward-compatible async iteration.
-     *
-     * ```ts
-     * // Fluent
-     * await claude.stream('Fix bugs').on('text', t => process.stdout.write(t)).done()
-     *
-     * // Collect text
-     * const text = await claude.stream('Summarize').text()
-     *
-     * // Pipe
-     * const result = await claude.stream('Explain').pipe(process.stdout)
-     *
-     * // Node.js Readable
-     * claude.stream('Generate').toReadable().pipe(createWriteStream('out.txt'))
-     *
-     * // Raw iteration (backward compat)
-     * for await (const event of claude.stream('Analyze')) { ... }
-     * ```
      */
     stream(prompt: string, options?: QueryOptions): StreamHandle;
     /**
      * Open a bidirectional chat — a persistent CLI process for real-time conversation.
      * Uses `--input-format stream-json` for multi-turn dialogue over a single process.
-     *
-     * ```ts
-     * const chat = claude.chat()
-     *   .on('text', (t) => process.stdout.write(t))
-     *
-     * await chat.send('What files are in src?')
-     * await chat.send('Now fix the bugs')
-     * chat.end()
-     * ```
      */
     chat(options?: QueryOptions): ChatHandle;
     /**
@@ -114,5 +88,74 @@ export declare class Claude {
      * Access the underlying executor (for advanced use / testing).
      */
     getExecutor(): IExecutor;
+    /**
+     * Change the model for subsequent responses.
+     * SDK mode only — throws in CLI mode.
+     */
+    setModel(model?: string): Promise<void>;
+    /**
+     * Change the permission mode for the session.
+     * SDK mode only — throws in CLI mode.
+     */
+    setPermissionMode(mode: PermissionMode): Promise<void>;
+    /**
+     * Rewind files to their state at a specific user message.
+     * Requires `enableFileCheckpointing: true`.
+     * SDK mode only — throws in CLI mode.
+     */
+    rewindFiles(userMessageId: string, options?: {
+        dryRun?: boolean;
+    }): Promise<RewindFilesResult>;
+    /**
+     * Stop a running subagent task.
+     * SDK mode only — throws in CLI mode.
+     */
+    stopTask(taskId: string): Promise<void>;
+    /**
+     * Dynamically set MCP servers for this session.
+     * SDK mode only — throws in CLI mode.
+     */
+    setMcpServers(servers: Record<string, McpServerConfig | McpSdkServerConfig>): Promise<McpSetServersResult>;
+    /**
+     * Reconnect a disconnected MCP server.
+     * SDK mode only — throws in CLI mode.
+     */
+    reconnectMcpServer(serverName: string): Promise<void>;
+    /**
+     * Enable or disable an MCP server.
+     * SDK mode only — throws in CLI mode.
+     */
+    toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;
+    /**
+     * Get account information (email, org, subscription).
+     * SDK mode only — throws in CLI mode.
+     */
+    accountInfo(): Promise<AccountInfo>;
+    /**
+     * Get available models with their capabilities.
+     * SDK mode only — throws in CLI mode.
+     */
+    supportedModels(): Promise<ModelInfo[]>;
+    /**
+     * Get available slash commands.
+     * SDK mode only — throws in CLI mode.
+     */
+    supportedCommands(): Promise<SlashCommand[]>;
+    /**
+     * Get available subagents.
+     * SDK mode only — throws in CLI mode.
+     */
+    supportedAgents(): Promise<AgentInfo[]>;
+    /**
+     * Get MCP server connection statuses.
+     * SDK mode only — throws in CLI mode.
+     */
+    mcpServerStatus(): Promise<McpServerStatus[]>;
+    /**
+     * Interrupt the current query execution.
+     * SDK mode only — throws in CLI mode.
+     */
+    interrupt(): Promise<void>;
+    private requireSdk;
 }
 //# sourceMappingURL=claude.d.ts.map

package/dist/client/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/client/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAe,MAAM,mBAAmB,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAe,KAAK,SAAS,EAA2B,MAAM,6BAA6B,CAAC;AAGnG,OAAO,EAIL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;gBAE5C,OAAO,GAAE,aAAkB,EAAE,QAAQ,CAAC,EAAE,SAAS;IA2B7D;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,mFAAmF;IACnF,IAAI,KAAK,IAAI,OAAO,CAGnB;IAED;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAC/F,EAAE,CAAC,KAAK,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAC9D,EAAE,CAAC,KAAK,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAC1E,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,IAAI;IAQ7D;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBzE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY;IAsB5D;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU;IAwBxC;;OAEG;IACH,OAAO,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO;IAIjD;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY;IAKrF;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE,EAAE,GAC7D,OAAO,CAAC,WAAW,EAAE,CAAC;IAMzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,WAAW,IAAI,SAAS;CAGzB"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/client/claude.ts"],"names":[],"mappings":"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"}

package/dist/client/claude.js

@@ -42,6 +42,7 @@ export class Claude {
             const sdkOpts = {
                 model: options.model,
                 pathToClaudeCodeExecutable: options.executable,
+                cwd: options.cwd,
                 permissionMode: options.permissionMode,
                 allowedTools: options.allowedTools ? [...options.allowedTools] : undefined,
                 disallowedTools: options.disallowedTools ? [...options.disallowedTools] : undefined,
@@ -49,6 +50,35 @@ export class Claude {
                 systemPrompt: options.systemPrompt,
                 appendSystemPrompt: options.appendSystemPrompt,
                 maxTurns: options.maxTurns,
+                maxBudget: options.maxBudget,
+                effortLevel: options.effortLevel,
+                fallbackModel: options.fallbackModel,
+                // New SDK-level options
+                canUseTool: options.canUseTool,
+                thinking: options.thinking,
+                enableFileCheckpointing: options.enableFileCheckpointing,
+                onElicitation: options.onElicitation,
+                hookCallbacks: options.hookCallbacks,
+                mcpServers: options.mcpServers,
+                agents: options.agents,
+                agent: options.agent,
+                tools: options.tools ? [...options.tools] : undefined,
+                additionalDirs: options.additionalDirs ? [...options.additionalDirs] : undefined,
+                noSessionPersistence: options.noSessionPersistence,
+                strictMcpConfig: options.strictMcpConfig,
+                betas: options.betas ? [...options.betas] : undefined,
+                includePartialMessages: options.includePartialMessages,
+                promptSuggestions: options.promptSuggestions,
+                agentProgressSummaries: options.agentProgressSummaries,
+                debug: options.debug,
+                debugFile: options.debugFile,
+                // New passthrough options
+                stderr: options.stderr,
+                allowDangerouslySkipPermissions: options.allowDangerouslySkipPermissions,
+                settingSources: options.settingSources,
+                settings: options.settings,
+                plugins: options.plugins,
+                spawnClaudeCodeProcess: options.spawnClaudeCodeProcess,
             };
             this.sdkExecutor = new SdkExecutor(sdkOpts);
             this.executor = this.sdkExecutor;
@@ -96,29 +126,13 @@ export class Claude {
             env,
             input: options?.input,
             systemPrompt: resolved.systemPrompt,
+            signal: options?.signal,
         });
     }
     /**
      * Execute a query with streaming response.
      * Returns a {@link StreamHandle} with fluent callbacks, Node.js stream support,
      * and backward-compatible async iteration.
-     *
-     * ```ts
-     * // Fluent
-     * await claude.stream('Fix bugs').on('text', t => process.stdout.write(t)).done()
-     *
-     * // Collect text
-     * const text = await claude.stream('Summarize').text()
-     *
-     * // Pipe
-     * const result = await claude.stream('Explain').pipe(process.stdout)
-     *
-     * // Node.js Readable
-     * claude.stream('Generate').toReadable().pipe(createWriteStream('out.txt'))
-     *
-     * // Raw iteration (backward compat)
-     * for await (const event of claude.stream('Analyze')) { ... }
-     * ```
      */
     stream(prompt, options) {
         validatePrompt(prompt);
@@ -136,21 +150,13 @@ export class Claude {
             env,
             input: options?.input,
             systemPrompt: resolved.systemPrompt,
+            signal: options?.signal,
         };
         return new StreamHandle(() => executor.stream(args, execOpts));
     }
     /**
      * Open a bidirectional chat — a persistent CLI process for real-time conversation.
      * Uses `--input-format stream-json` for multi-turn dialogue over a single process.
-     *
-     * ```ts
-     * const chat = claude.chat()
-     *   .on('text', (t) => process.stdout.write(t))
-     *
-     * await chat.send('What files are in src?')
-     * await chat.send('Now fix the bugs')
-     * chat.end()
-     * ```
      */
     chat(options) {
         if (options)
@@ -211,5 +217,118 @@ export class Claude {
     getExecutor() {
         return this.executor;
     }
+    // ── SDK Control Methods ─────────────────────────────────────────
+    // These methods delegate to the underlying SdkExecutor.
+    // In CLI mode they throw an error.
+    /**
+     * Change the model for subsequent responses.
+     * SDK mode only — throws in CLI mode.
+     */
+    async setModel(model) {
+        this.requireSdk('setModel');
+        await this.sdkExecutor.setModel(model);
+    }
+    /**
+     * Change the permission mode for the session.
+     * SDK mode only — throws in CLI mode.
+     */
+    async setPermissionMode(mode) {
+        this.requireSdk('setPermissionMode');
+        await this.sdkExecutor.setPermissionMode(mode);
+    }
+    /**
+     * Rewind files to their state at a specific user message.
+     * Requires `enableFileCheckpointing: true`.
+     * SDK mode only — throws in CLI mode.
+     */
+    async rewindFiles(userMessageId, options) {
+        this.requireSdk('rewindFiles');
+        return this.sdkExecutor.rewindFiles(userMessageId, options);
+    }
+    /**
+     * Stop a running subagent task.
+     * SDK mode only — throws in CLI mode.
+     */
+    async stopTask(taskId) {
+        this.requireSdk('stopTask');
+        await this.sdkExecutor.stopTask(taskId);
+    }
+    /**
+     * Dynamically set MCP servers for this session.
+     * SDK mode only — throws in CLI mode.
+     */
+    async setMcpServers(servers) {
+        this.requireSdk('setMcpServers');
+        return this.sdkExecutor.setMcpServers(servers);
+    }
+    /**
+     * Reconnect a disconnected MCP server.
+     * SDK mode only — throws in CLI mode.
+     */
+    async reconnectMcpServer(serverName) {
+        this.requireSdk('reconnectMcpServer');
+        await this.sdkExecutor.reconnectMcpServer(serverName);
+    }
+    /**
+     * Enable or disable an MCP server.
+     * SDK mode only — throws in CLI mode.
+     */
+    async toggleMcpServer(serverName, enabled) {
+        this.requireSdk('toggleMcpServer');
+        await this.sdkExecutor.toggleMcpServer(serverName, enabled);
+    }
+    /**
+     * Get account information (email, org, subscription).
+     * SDK mode only — throws in CLI mode.
+     */
+    async accountInfo() {
+        this.requireSdk('accountInfo');
+        return this.sdkExecutor.accountInfo();
+    }
+    /**
+     * Get available models with their capabilities.
+     * SDK mode only — throws in CLI mode.
+     */
+    async supportedModels() {
+        this.requireSdk('supportedModels');
+        return this.sdkExecutor.supportedModels();
+    }
+    /**
+     * Get available slash commands.
+     * SDK mode only — throws in CLI mode.
+     */
+    async supportedCommands() {
+        this.requireSdk('supportedCommands');
+        return this.sdkExecutor.supportedCommands();
+    }
+    /**
+     * Get available subagents.
+     * SDK mode only — throws in CLI mode.
+     */
+    async supportedAgents() {
+        this.requireSdk('supportedAgents');
+        return this.sdkExecutor.supportedAgents();
+    }
+    /**
+     * Get MCP server connection statuses.
+     * SDK mode only — throws in CLI mode.
+     */
+    async mcpServerStatus() {
+        this.requireSdk('mcpServerStatus');
+        return this.sdkExecutor.mcpServerStatus();
+    }
+    /**
+     * Interrupt the current query execution.
+     * SDK mode only — throws in CLI mode.
+     */
+    async interrupt() {
+        this.requireSdk('interrupt');
+        await this.sdkExecutor.interrupt();
+    }
+    requireSdk(method) {
+        if (!this.sdkExecutor) {
+            throw new Error(`${method}() is only available in SDK mode. Set useSdk: true (default) to use this method.`);
+        }
+    }
 }
 //# sourceMappingURL=claude.js.map

package/dist/client/claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/client/claude.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/client/claude.ts"],"names":[],"mappings":"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"}

package/dist/client/stream-handle.d.ts

@@ -1,11 +1,14 @@
 import { Readable } from 'node:stream';
-import { EVENT_TEXT, EVENT_TOOL_USE, EVENT_RESULT, EVENT_ERROR, EVENT_SYSTEM } from '../constants.js';
-import type { StreamEvent, StreamToolUseEvent, StreamResultEvent, StreamErrorEvent, StreamSystemEvent } from '../types/index.js';
+import { EVENT_TEXT, EVENT_TOOL_USE, EVENT_RESULT, EVENT_ERROR, EVENT_SYSTEM, EVENT_TASK_STARTED, EVENT_TASK_PROGRESS, EVENT_TASK_NOTIFICATION } from '../constants.js';
+import type { StreamEvent, StreamToolUseEvent, StreamResultEvent, StreamErrorEvent, StreamSystemEvent, StreamTaskStartedEvent, StreamTaskProgressEvent, StreamTaskNotificationEvent } from '../types/index.js';
 type TextCallback = (text: string) => void;
 type ToolUseCallback = (event: StreamToolUseEvent) => void;
 type ResultCallback = (event: StreamResultEvent) => void;
 type ErrorCallback = (event: StreamErrorEvent) => void;
 type SystemCallback = (event: StreamSystemEvent) => void;
+type TaskStartedCallback = (event: StreamTaskStartedEvent) => void;
+type TaskProgressCallback = (event: StreamTaskProgressEvent) => void;
+type TaskNotificationCallback = (event: StreamTaskNotificationEvent) => void;
 /**
  * A streaming response handle with fluent callback API and Node.js stream support.
  *
@@ -15,6 +18,7 @@ type SystemCallback = (event: StreamSystemEvent) => void;
  * await claude.stream('Refactor auth')
  *   .on('text', (text) => process.stdout.write(text))
  *   .on('tool_use', (event) => console.log(event.toolName))
+ *   .on('task_started', (event) => console.log(`Task: ${event.description}`))
  *   .done()
  * ```
  *
@@ -45,6 +49,9 @@ export declare class StreamHandle implements AsyncIterable<StreamEvent> {
     private readonly resultCallbacks;
     private readonly errorCallbacks;
     private readonly systemCallbacks;
+    private readonly taskStartedCallbacks;
+    private readonly taskProgressCallbacks;
+    private readonly taskNotificationCallbacks;
     constructor(source: () => AsyncIterable<StreamEvent>);
     /**
      * Register a callback for a specific event type. Returns `this` for chaining.
@@ -56,6 +63,9 @@ export declare class StreamHandle implements AsyncIterable<StreamEvent> {
     on(type: typeof EVENT_RESULT, callback: ResultCallback): this;
     on(type: typeof EVENT_ERROR, callback: ErrorCallback): this;
     on(type: typeof EVENT_SYSTEM, callback: SystemCallback): this;
+    on(type: typeof EVENT_TASK_STARTED, callback: TaskStartedCallback): this;
+    on(type: typeof EVENT_TASK_PROGRESS, callback: TaskProgressCallback): this;
+    on(type: typeof EVENT_TASK_NOTIFICATION, callback: TaskNotificationCallback): this;
     /**
      * Consume the stream, fire all registered callbacks, return the final result.
      */
@@ -77,16 +87,6 @@ export declare class StreamHandle implements AsyncIterable<StreamEvent> {
     /**
      * Get a Node.js Readable that emits text chunks.
      * Use for `pipeline()`, standard `.pipe()` chaining, HTTP responses, etc.
-     *
-     * ```ts
-     * claude.stream('Generate').toReadable().pipe(res)
-     *
-     * await pipeline(
-     *   claude.stream('Report').toReadable(),
-     *   createGzip(),
-     *   createWriteStream('report.gz'),
-     * )
-     * ```
      */
     toReadable(): Readable;
     /**

package/dist/client/stream-handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-handle.d.ts","sourceRoot":"","sources":["../../src/client/stream-handle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAC3C,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAC3D,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AACzD,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AACvD,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,YAAa,YAAW,aAAa,CAAC,WAAW,CAAC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;gBAE5C,MAAM,EAAE,MAAM,aAAa,CAAC,WAAW,CAAC;IAIpD;;;;OAIG;IACH,EAAE,CAAC,IAAI,EAAE,OAAO,UAAU,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IACzD,EAAE,CAAC,IAAI,EAAE,OAAO,cAAc,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAChE,EAAE,CAAC,IAAI,EAAE,OAAO,YAAY,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAC7D,EAAE,CAAC,IAAI,EAAE,OAAO,WAAW,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAC3D,EAAE,CAAC,IAAI,EAAE,OAAO,YAAY,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAY7D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAcxC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAW7B;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKnF;;;;;;;;;;;;;OAaG;IACH,UAAU,IAAI,QAAQ;IAUtB;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC;IAI3D,OAAO,CAAC,QAAQ;CAmBjB"}
+{"version":3,"file":"stream-handle.d.ts","sourceRoot":"","sources":["../../src/client/stream-handle.ts"],"names":[],"mappings":"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"}