@talk2view/sdk 0.2.4 → 0.3.0

package/dist/react/useT2VChat.js

@@ -1,5 +1,11 @@
 /**
- * useT2VChat — React hook for chat interactions with streaming and auto tool handling.
+ * useT2VChat — React hook for chat interactions with streaming, auto tool handling,
+ * and human-in-the-loop approval support.
+ *
+ * Permission model (aligned with Claude Agent SDK):
+ * - Allow Once: execute this tool call
+ * - Allow Always: execute and auto-approve future calls to this tool for the session
+ * - Deny: reject with optional corrective feedback
  */
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { useT2V } from './T2VProvider';
@@ -14,13 +20,120 @@ export function useT2VChat(options) {
     const [error, setError] = useState(null);
     const [threadId, setThreadId] = useState(null);
     const [agentStatus, setAgentStatus] = useState(null);
-    const [todos, setTodos] = useState('');
+    const [pendingApproval, setPendingApproval] = useState(null);
+    const [alwaysAllowedTools, setAlwaysAllowedTools] = useState(new Set());
     const messagesRef = useRef([]);
     useEffect(() => { messagesRef.current = messages; }, [messages]);
+    // Ref to track the current assistant message ID for approval continuation
+    const activeAssistantIdRef = useRef(null);
+    // Session-scoped set of tools that are auto-approved
+    const alwaysAllowedRef = useRef(new Set());
+    // Queue for auto-approvals (set inside consumeStream, consumed by drainStream)
+    const pendingAutoApprovalRef = useRef(null);
+    // Track last user message for retry
+    const lastUserMessageRef = useRef(null);
+    /** Mark the current stream as finished (no pending approval). */
+    const finalizeStream = useCallback((assistantId) => {
+        setMessages((prev) => prev.map((m) => m.id === assistantId ? { ...m, isStreaming: false } : m));
+        setAgentStatus(null);
+        setIsLoading(false);
+    }, []);
+    /**
+     * Consume a ChatEvent stream and update state.
+     * Returns true if the stream paused for approval, false if it completed.
+     */
+    const consumeStream = useCallback(async (stream, assistantId) => {
+        let fullContent = '';
+        // Read current content from the message (may already have content from prior stream)
+        const existing = messagesRef.current.find((m) => m.id === assistantId);
+        if (existing)
+            fullContent = existing.content;
+        for await (const event of stream) {
+            switch (event.type) {
+                case 'text':
+                    fullContent += event.content;
+                    setAgentStatus(null);
+                    setMessages((prev) => prev.map((m) => m.id === assistantId ? { ...m, content: fullContent } : m));
+                    break;
+                case 'status':
+                    setAgentStatus({ status: event.status, message: event.message });
+                    break;
+                case 'todos':
+                    setMessages((prev) => prev.map((m) => m.id === assistantId ? { ...m, plan: event.content } : m));
+                    break;
+                case 'approval_required': {
+                    const info = {
+                        toolCallId: event.toolCallId,
+                        toolName: event.toolName,
+                        arguments: event.arguments,
+                        description: event.description,
+                    };
+                    if (alwaysAllowedRef.current.has(event.toolName)) {
+                        // Auto-approve: queue for drainStream to handle
+                        pendingAutoApprovalRef.current = info;
+                    }
+                    else {
+                        // Manual approval: show the card
+                        setPendingApproval(info);
+                    }
+                    return true; // Stream paused — either auto or manual approval needed
+                }
+                case 'tool_call':
+                    setMessages((prev) => prev.map((m) => m.id === assistantId
+                        ? { ...m, steps: [...(m.steps ?? []), { name: event.toolName, status: 'used' }] }
+                        : m));
+                    break;
+                case 'approval_result': {
+                    const step = {
+                        name: event.toolName,
+                        status: event.decision === 'deny' ? 'denied' : 'used',
+                    };
+                    setMessages((prev) => prev.map((m) => m.id === assistantId
+                        ? { ...m, steps: [...(m.steps ?? []), step] }
+                        : m));
+                    setPendingApproval(null);
+                    setAgentStatus({
+                        status: 'resuming',
+                        message: `Tool ${event.decision === 'deny' ? 'denied' : 'approved'}, continuing...`,
+                    });
+                    break;
+                }
+                case 'done':
+                    setThreadId(event.threadId);
+                    break;
+                case 'error':
+                    setError(event.message);
+                    break;
+            }
+        }
+        return false; // Stream completed normally
+    }, []);
+    /**
+     * Process a stream with auto-approval loop.
+     * Automatically approves tool calls for always-allowed tools without showing the card.
+     */
+    const drainStream = useCallback(async (stream, assistantId) => {
+        while (true) {
+            const paused = await consumeStream(stream, assistantId);
+            if (!paused) {
+                finalizeStream(assistantId);
+                return;
+            }
+            // Check if this is an auto-approval (always-allowed tool)
+            const auto = pendingAutoApprovalRef.current;
+            if (!auto)
+                return; // Manual approval needed — wait for user
+            pendingAutoApprovalRef.current = null;
+            setAgentStatus({ status: 'auto-approved', message: `Auto-approved ${auto.toolName}` });
+            // Resume with auto-approve and continue the loop
+            stream = t2v.respondToApproval(auto, { action: 'once' });
+        }
+    }, [consumeStream, finalizeStream, t2v]);
     const sendMessage = useCallback(async (content) => {
         setError(null);
         setIsLoading(true);
-        // Add user message
+        setPendingApproval(null);
+        lastUserMessageRef.current = content;
         const userMsg = {
             id: nextId(),
             role: 'user',
@@ -28,6 +141,7 @@ export function useT2VChat(options) {
             timestamp: new Date(),
         };
         const assistantId = nextId();
+        activeAssistantIdRef.current = assistantId;
         const assistantMsg = {
             id: assistantId,
             role: 'assistant',
@@ -36,58 +150,79 @@ export function useT2VChat(options) {
             isStreaming: true,
         };
         setMessages((prev) => [...prev, userMsg, assistantMsg]);
-        // Build conversation history from ref (avoids stale closure over messages state)
         const history = messagesRef.current.map((m) => ({
             role: m.role,
             content: m.content,
         }));
-        let fullContent = '';
         try {
-            for await (const event of t2v.chat(content, {
-                systemPrompt: options?.systemPrompt,
-                history,
-            })) {
-                switch (event.type) {
-                    case 'text':
-                        fullContent += event.content;
-                        setAgentStatus(null); // Agent is now responding
-                        setMessages((prev) => prev.map((m) => m.id === assistantId ? { ...m, content: fullContent } : m));
-                        break;
-                    case 'status':
-                        setAgentStatus({ status: event.status, message: event.message });
-                        break;
-                    case 'todos':
-                        setTodos(event.todos);
-                        break;
-                    case 'done':
-                        setThreadId(event.threadId);
-                        break;
-                    case 'error':
-                        setError(event.message);
-                        break;
-                }
-            }
+            await drainStream(t2v.chat(content, { systemPrompt: options?.systemPrompt, model: options?.model, history }), assistantId);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : 'An error occurred';
             setError(message);
+            finalizeStream(assistantId);
         }
-        finally {
-            // Mark streaming as done
-            setMessages((prev) => prev.map((m) => m.id === assistantId ? { ...m, isStreaming: false } : m));
-            setAgentStatus(null);
-            setIsLoading(false);
+    }, [t2v, options?.systemPrompt, options?.model, drainStream, finalizeStream]);
+    const approveToolCall = useCallback(async (decision) => {
+        const approval = pendingApproval;
+        if (!approval)
+            return;
+        const assistantId = activeAssistantIdRef.current;
+        if (!assistantId)
+            return;
+        // Handle "always" — remember for future calls in this session
+        if (decision.action === 'always') {
+            alwaysAllowedRef.current.add(approval.toolName);
+            setAlwaysAllowedTools(new Set(alwaysAllowedRef.current));
         }
-    }, [t2v, options?.systemPrompt]);
+        setPendingApproval(null);
+        setIsLoading(true);
+        try {
+            await drainStream(t2v.respondToApproval(approval, decision), assistantId);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'An error occurred';
+            setError(message);
+            finalizeStream(assistantId);
+        }
+    }, [t2v, drainStream, finalizeStream, pendingApproval]);
     const clearMessages = useCallback(() => {
         setMessages([]);
         setThreadId(null);
         setError(null);
-        setTodos('');
         setAgentStatus(null);
-        // Tell the SDK to drop the current session so the next message creates a fresh one
+        setPendingApproval(null);
+        alwaysAllowedRef.current.clear();
+        setAlwaysAllowedTools(new Set());
+        activeAssistantIdRef.current = null;
         t2v.clearSession();
     }, [t2v]);
+    const retryLastMessage = useCallback(async () => {
+        const lastMsg = lastUserMessageRef.current;
+        if (!lastMsg)
+            return;
+        // Remove the failed assistant message + user message
+        setMessages((prev) => {
+            const copy = [...prev];
+            // Remove trailing assistant (empty/error) and user message
+            while (copy.length > 0) {
+                const last = copy[copy.length - 1];
+                if (last.role === 'assistant' && !last.content) {
+                    copy.pop();
+                }
+                else if (last.role === 'user' && last.content === lastMsg) {
+                    copy.pop();
+                    break;
+                }
+                else {
+                    break;
+                }
+            }
+            return copy;
+        });
+        setError(null);
+        await sendMessage(lastMsg);
+    }, [sendMessage]);
     const clearError = useCallback(() => setError(null), []);
     return {
         messages,
@@ -95,8 +230,11 @@ export function useT2VChat(options) {
         error,
         threadId,
         agentStatus,
-        todos,
+        pendingApproval,
+        alwaysAllowedTools,
         sendMessage,
+        approveToolCall,
+        retryLastMessage,
         clearMessages,
         clearError,
     };

package/dist/react/useT2VChat.js.map

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

package/dist/react/useUserPreferences.js

@@ -30,8 +30,8 @@ export function useUserPreferences() {
         setPreferences((prev) => {
             const next = { ...prev, ...partial };
             setUserPreferences(JSON.stringify(next));
-            // Notify other hook instances
-            window.dispatchEvent(new Event(SYNC_EVENT));
+            // Notify other hook instances (deferred to avoid setState-during-render)
+            queueMicrotask(() => window.dispatchEvent(new Event(SYNC_EVENT)));
             return next;
         });
     }, []);

package/dist/react/useUserPreferences.js.map

@@ -1 +1 @@
-{"version":3,"file":"useUserPreferences.js","sourceRoot":"","sources":["../../src/react/useUserPreferences.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAEnD,SAAS,eAAe;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAOD,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAkB,eAAe,CAAC,CAAC;IAEjF,uEAAuE;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,OAAiC,EAAE,EAAE;QAC1E,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;YACrC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACzC,8BAA8B;YAC9B,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"useUserPreferences.js","sourceRoot":"","sources":["../../src/react/useUserPreferences.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAEnD,SAAS,eAAe;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAOD,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAkB,eAAe,CAAC,CAAC;IAEjF,uEAAuE;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,OAAiC,EAAE,EAAE;QAC1E,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;YACrC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACzC,yEAAyE;YACzE,cAAc,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AAC5C,CAAC"}

package/dist/sessions.d.ts

@@ -3,7 +3,7 @@
  */
 import type { T2VClient } from './client';
 import type { T2VTools } from './tools';
-import type { ChatEvent, ChatMessage, CreateSessionResponse, T2VConfig } from './types';
+import type { ChatEvent, ChatMessage, CreateSessionResponse, HumanDecision, PendingApproval, T2VConfig } from './types';
 export declare class T2VSession {
     private readonly client;
     private readonly tools;
@@ -20,12 +20,21 @@ export declare class T2VSession {
      */
     sendMessage(content: string, options?: {
         systemPrompt?: string;
+        model?: string;
         history?: ChatMessage[];
     }): AsyncGenerator<ChatEvent>;
     /**
      * Resume after a tool call (for manual tool handling).
      */
     resumeToolCall(toolCallId: string, result: string, isError?: boolean): AsyncGenerator<ChatEvent>;
+    /**
+     * Respond to a pending approval request (human-in-the-loop).
+     *
+     * - once: executes the tool with original args, resumes with result
+     * - always: same as once (session-level memory is handled by the hook layer)
+     * - deny: skips execution, resumes with corrective feedback
+     */
+    respondToApproval(approval: PendingApproval, decision: HumanDecision): AsyncGenerator<ChatEvent>;
     /**
      * Internal: process an SSE stream with automatic tool call handling.
      */

package/dist/sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,SAAS,EACV,MAAM,SAAS,CAAC;AAEjB,qBAAa,UAAU;IAOnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,qBAAqB,EACV,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,SAAS,YAAA;IAOrC;;;;;OAKG;IACI,WAAW,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE,GAC3D,cAAc,CAAC,SAAS,CAAC;IAiB5B;;OAEG;IACI,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,UAAQ,GACd,cAAc,CAAC,SAAS,CAAC;IAO5B;;OAEG;YACY,aAAa;CA+D7B"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAEjB,qBAAa,UAAU;IAOnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,qBAAqB,EACV,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,SAAS,YAAA;IAOrC;;;;;OAKG;IACI,WAAW,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE,GAC3E,cAAc,CAAC,SAAS,CAAC;IAiB5B;;OAEG;IACI,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,UAAQ,GACd,cAAc,CAAC,SAAS,CAAC;IAO5B;;;;;;OAMG;IACI,iBAAiB,CACtB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,aAAa,GACtB,cAAc,CAAC,SAAS,CAAC;IAyB5B;;OAEG;YACY,aAAa;CAoF7B"}

package/dist/sessions.js

@@ -31,7 +31,7 @@ export class T2VSession {
             messages.push(...options.history);
         }
         messages.push({ role: 'user', content });
-        yield* this.processStream(`/v1/sessions/${this.id}/messages`, { messages, stream: true, model: this.config?.model });
+        yield* this.processStream(`/v1/sessions/${this.id}/messages`, { messages, stream: true, model: options?.model ?? this.config?.model });
     }
     /**
      * Resume after a tool call (for manual tool handling).
@@ -39,6 +39,35 @@ export class T2VSession {
     async *resumeToolCall(toolCallId, result, isError = false) {
         yield* this.processStream(`/v1/sessions/${this.id}/resume`, { tool_call_id: toolCallId, result, is_error: isError });
     }
+    /**
+     * Respond to a pending approval request (human-in-the-loop).
+     *
+     * - once: executes the tool with original args, resumes with result
+     * - always: same as once (session-level memory is handled by the hook layer)
+     * - deny: skips execution, resumes with corrective feedback
+     */
+    async *respondToApproval(approval, decision) {
+        const { toolCallId, toolName } = approval;
+        const execArgs = decision.updatedInput ?? approval.arguments;
+        let result;
+        let isError = false;
+        switch (decision.action) {
+            case 'once':
+            case 'always': {
+                const outcome = await this.tools.executeToolCall(toolName, execArgs);
+                result = outcome.result;
+                isError = outcome.isError;
+                break;
+            }
+            case 'deny': {
+                result = `User denied this action. ${decision.feedback ?? ''}`.trim();
+                isError = true;
+                break;
+            }
+        }
+        yield { type: 'approval_result', toolName, decision: decision.action };
+        yield* this.resumeToolCall(toolCallId, result, isError);
+    }
     /**
      * Internal: process an SSE stream with automatic tool call handling.
      */
@@ -48,36 +77,53 @@ export class T2VSession {
             if (chunk.status) {
                 yield { type: 'status', status: chunk.status.type, message: chunk.status.message };
             }
-            // Todos update (non-terminal — stream continues)
+            // Todos (planning scratchpad) update
             if (chunk.todos) {
-                yield { type: 'todos', todos: chunk.todos };
+                yield { type: 'todos', content: chunk.todos };
             }
             // Check for tool call interrupt
             if (chunk.interrupt) {
                 const { tool_name, tool_call_id, arguments: args } = chunk.interrupt;
-                // If we have a handler, execute automatically and resume
-                if (this.tools.hasHandler(tool_name)) {
-                    // Emit tool_call event so the UI knows what's happening
-                    yield {
-                        type: 'tool_call',
-                        toolName: tool_name,
-                        toolCallId: tool_call_id,
-                        arguments: args,
-                    };
-                    // Execute the tool
-                    const { result, isError } = await this.tools.executeToolCall(tool_name, args);
-                    // Resume and continue streaming
-                    yield* this.processStream(`/v1/sessions/${this.id}/resume`, { tool_call_id, result, is_error: isError });
-                    return;
+                // Run permission check
+                const permResult = await this.tools.checkPermission(tool_name, args);
+                switch (permResult.action) {
+                    case 'require_approval':
+                        // Pause for human decision (approval card)
+                        yield {
+                            type: 'approval_required',
+                            toolName: tool_name,
+                            toolCallId: tool_call_id,
+                            arguments: args,
+                            description: this.tools.getDescription(tool_name),
+                        };
+                        return;
+                    case 'deny':
+                        // Programmatic denial — resume with error
+                        yield* this.resumeToolCall(tool_call_id, `Permission denied: ${permResult.message ?? 'Tool not allowed'}`, true);
+                        return;
+                    case 'allow': {
+                        const execArgs = permResult.updatedInput ?? args;
+                        if (this.tools.hasHandler(tool_name)) {
+                            yield {
+                                type: 'tool_call',
+                                toolName: tool_name,
+                                toolCallId: tool_call_id,
+                                arguments: execArgs,
+                            };
+                            const { result, isError } = await this.tools.executeToolCall(tool_name, execArgs);
+                            yield* this.resumeToolCall(tool_call_id, result, isError);
+                            return;
+                        }
+                        // No handler — emit for manual handling
+                        yield {
+                            type: 'tool_call',
+                            toolName: tool_name,
+                            toolCallId: tool_call_id,
+                            arguments: execArgs,
+                        };
+                        return;
+                    }
                 }
-                // No handler — emit the event for manual handling
-                yield {
-                    type: 'tool_call',
-                    toolName: tool_name,
-                    toolCallId: tool_call_id,
-                    arguments: args,
-                };
-                return;
             }
             // Text content
             const delta = chunk.choices[0]?.delta?.content;

package/dist/sessions.js.map

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

package/dist/tools.d.ts

@@ -2,11 +2,12 @@
  * Tools module — register client tools and handle tool call execution.
  */
 import type { T2VClient } from './client';
-import type { ClientTool, ClientToolSchema, RegisterToolsResponse, ToolHandler } from './types';
+import type { ClientTool, ClientToolSchema, PermissionCheckResult, RegisterToolsResponse, ToolHandler } from './types';
 export declare class T2VTools {
     private readonly client;
     private handlers;
     private schemas;
+    private permissions;
     constructor(client: T2VClient);
     /**
      * Validate tool arguments against the registered schema.
@@ -38,6 +39,18 @@ export declare class T2VTools {
      * Check if a handler is registered for a tool.
      */
     hasHandler(toolName: string): boolean;
+    /**
+     * Run permission check for a tool call.
+     *
+     * - No permission config → allow
+     * - `permission: true` → require_approval (show approval card)
+     * - `permission: callback` → delegate to callback
+     */
+    checkPermission(toolName: string, args: Record<string, unknown>): Promise<PermissionCheckResult>;
+    /**
+     * Get the description of a registered tool.
+     */
+    getDescription(toolName: string): string;
     /**
      * Get all registered tool schemas.
      */

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhG,qBAAa,QAAQ;IAIP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,OAAO,CAA0B;gBAEZ,MAAM,EAAE,SAAS;IAE9C;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,SAAS;IAkBjB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIpD;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,CAAC,gBAAgB,GAAG,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2BxF;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA0ChD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,aAAa,IAAI,gBAAgB,EAAE;CAGpC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EAEZ,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ;IAKP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAA4D;gBAElD,MAAM,EAAE,SAAS;IAE9C;;;OAGG;IACH,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,SAAS;IAkBjB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIpD;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,CAAC,gBAAgB,GAAG,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgCxF;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA0ChD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;OAMG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAgBjC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,aAAa,IAAI,gBAAgB,EAAE;CAGpC"}

package/dist/tools.js

@@ -5,6 +5,7 @@ export class T2VTools {
     client;
     handlers = new Map();
     schemas = [];
+    permissions = new Map();
     constructor(client) {
         this.client = client;
     }
@@ -86,6 +87,10 @@ export class T2VTools {
             if ('execute' in tool && typeof tool.execute === 'function') {
                 this.handlers.set(tool.name, tool.execute);
             }
+            // Track permission config
+            if (tool.permission !== undefined && tool.permission !== false) {
+                this.permissions.set(tool.name, tool.permission);
+            }
         }
         this.schemas = schemasToRegister;
         return this.client.request('/v1/tools/register', {
@@ -145,6 +150,34 @@ export class T2VTools {
     hasHandler(toolName) {
         return this.handlers.has(toolName);
     }
+    /**
+     * Run permission check for a tool call.
+     *
+     * - No permission config → allow
+     * - `permission: true` → require_approval (show approval card)
+     * - `permission: callback` → delegate to callback
+     */
+    async checkPermission(toolName, args) {
+        const perm = this.permissions.get(toolName);
+        if (perm === undefined || perm === false) {
+            return { action: 'allow' };
+        }
+        if (perm === true) {
+            return { action: 'require_approval' };
+        }
+        // Callback — programmatic decision
+        const result = await perm(toolName, args);
+        if (result.type === 'allow') {
+            return { action: 'allow', updatedInput: result.updatedInput };
+        }
+        return { action: 'deny', message: result.message };
+    }
+    /**
+     * Get the description of a registered tool.
+     */
+    getDescription(toolName) {
+        return this.schemas.find((s) => s.name === toolName)?.description ?? '';
+    }
     /**
      * Get all registered tool schemas.
      */

package/dist/tools.js.map

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