@cogitator-ai/next 0.5.0 → 0.6.0

package/README.md

@@ -159,11 +159,12 @@ Response format:
     "totalTokens": 650
   },
   "toolCalls": [...],
-  "trace": { "traceId": "trace-xyz", "spans": [...] }
+  "trace": { "traceId": "trace-xyz", "spans": [...] },
+  "status": "completed"
 }
 ```
 
-A failed run answers `{ "error": message, "code": code }` with the status of its `CogitatorError` (for example `429 LLM_RATE_LIMITED`), and `500` for anything else.
+A run waiting for [approvals](#approvals) answers `"status": "paused"` with its `pendingApprovals`. A failed run answers `{ "error": message, "code": code }` with the status of its `CogitatorError` (for example `429 LLM_RATE_LIMITED`), and `500` for anything else.
 
 ### Multiple users
 
@@ -181,6 +182,69 @@ export const POST = createChatHandler(cogitator, agent, {
 
 A `threadId` that belongs to another user is refused before the model is called: `createAgentHandler` answers `403` with `code: "THREAD_ACCESS_DENIED"`, and `createChatHandler` ends the stream with an `error` event carrying that code. Without a `userId`, a caller can use only threads that have no owner.
 
+### Approvals
+
+A tool with `requiresApproval` pauses the run before it executes. The runtime keeps the run's checkpoint on the server, per thread; clients only see what waits for a decision:
+
+- `createAgentHandler` answers with `"status": "paused"` and `pendingApprovals` (`toolCallId`, `toolName`, `arguments`, `description`, `sideEffects`).
+- `createChatHandler` sends `{"type":"approval-required","threadId":"…","approvals":[…]}` right before `finish`.
+
+`createResumeHandler` continues the run. It takes `{ threadId, decisions?, defaultDecision? }`, where a decision is `{ approved: true }` or `{ approved: false, reason? }` by tool call id. Approved calls run, declined ones answer the model with the reason, and calls left undecided pause the run again. Return the caller's `userId` from `beforeRun` as for the other handlers: only the user the run belongs to may resume it.
+
+```typescript
+// app/api/chat/resume/route.ts
+import { createResumeHandler } from '@cogitator-ai/next';
+
+export const POST = createResumeHandler(cogitator, agent, {
+  stream: true,
+  beforeRun: async (req) => ({ userId: (await getSession(req)).id }),
+});
+```
+
+By default it answers like `createAgentHandler`; with `stream: true` it streams the rest of the run like `createChatHandler`, which is what `useCogitatorChat` wants. Another user's run answers `403 THREAD_ACCESS_DENIED`, a thread without a paused run `409 RUN_NOT_PAUSED` (an `error` event when streaming).
+
+On the client, `useCogitatorChat({ api, resumeApi })` exposes `pendingApprovals` and continues the run into a new assistant message:
+
+```tsx
+'use client';
+
+import { useCogitatorChat } from '@cogitator-ai/next/client';
+
+export function Chat() {
+  const { messages, pendingApprovals, approve, deny, isLoading } = useCogitatorChat({
+    api: '/api/chat',
+    resumeApi: '/api/chat/resume',
+  });
+
+  return (
+    <div>
+      {messages.map((m) => (
+        <p key={m.id}>{m.content}</p>
+      ))}
+      {pendingApprovals.length > 0 && (
+        <div>
+          {pendingApprovals.map((call) => (
+            <p key={call.toolCallId}>
+              {call.toolName}: {JSON.stringify(call.arguments)}
+            </p>
+          ))}
+          <button disabled={isLoading} onClick={() => approve()}>
+            Approve
+          </button>
+          <button disabled={isLoading} onClick={() => deny('Not approved')}>
+            Deny
+          </button>
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+For one decision per call, use `resume({ decisions: { [toolCallId]: { approved: true } }, defaultDecision: { approved: false } })`.
+
+`approve()` and `deny(reason?)` answer every pending call. The approvals clear once the resume is accepted, when the server has nothing paused anymore (`409`), or when the user sends a new message instead, which declines the waiting calls on the server. A JSON `resumeApi` works too: its answer is appended as one assistant message. `useCogitatorAgent({ api, resumeApi })` exposes `pendingApprovals` of the last result and `resume(decisions)`.
+
 ## Client Hooks
 
 ### `useCogitatorChat`
@@ -207,6 +271,12 @@ const {
   appendMessage, // (message: ChatMessage) => void
   clearMessages, // () => void
   setMessages, // (messages: ChatMessage[]) => void
+
+  // Approvals (see "Approvals")
+  pendingApprovals, // PendingApproval[]
+  resume, // (decisions: ResumeDecisions) => Promise<void>
+  approve, // () => Promise<void>
+  deny, // (reason?: string) => Promise<void>
 } = useCogitatorChat({
   api: '/api/chat',
   threadId: 'optional-thread-id',
@@ -218,6 +288,11 @@ const {
   onFinish: (message) => console.log('Done:', message),
   onToolCall: (toolCall) => console.log('Tool called:', toolCall.name),
   onToolResult: (result) => console.log('Tool result:', result),
+  onReasoning: (delta) => console.log('Thinking:', delta),
+  onApprovalRequired: (approvals) => console.log('Waiting for approval:', approvals),
+
+  // Endpoint of a createResumeHandler, for resume/approve/deny
+  resumeApi: '/api/chat/resume',
 
   // Retry configuration
   retry: {
@@ -270,11 +345,15 @@ Hook for non-streaming batch requests (research, analysis, etc).
 const {
   run, // (input: AgentInput) => Promise<void>
   result, // AgentResponse | null
+  reasoning, // string | undefined — result?.reasoning
+  pendingApprovals, // PendingApproval[] — result?.pendingApprovals
+  resume, // (decisions: ResumeDecisions) => Promise<void>
   isLoading, // boolean
   error, // Error | null
   reset, // () => void
 } = useCogitatorAgent({
   api: '/api/research',
+  resumeApi: '/api/research/resume',
   headers: { Authorization: 'Bearer token' },
 
   onError: (error) => console.error(error),
@@ -327,7 +406,11 @@ data: {"type":"finish","messageId":"msg-1","usage":{...},"threadId":"thread-abc"
 data: [DONE]
 ```
 
-If the run fails, the open text block is closed and an `{"type":"error","message":"..."}` event is sent instead of `finish`.
+An agent with `reasoning: { summary: true }` also streams its reasoning summary as `reasoning-start`, `reasoning-delta` and `reasoning-end` events. A text or reasoning block opens with its first delta and is closed before a block of the other kind, a tool call or `finish`, so blocks never overlap. `useCogitatorChat` collects the deltas into `message.reasoning` (and calls `onReasoning` with each one), and `createAgentHandler` returns the summary as `reasoning` next to `usage.reasoningTokens`, `usage.cachedInputTokens` and `usage.cacheWriteTokens` when the provider reports them.
+
+A run that pauses for [approvals](#approvals) sends `{"type":"approval-required","threadId":"…","approvals":[…]}` after the open block is closed and before `finish`.
+
+If the run fails, the open text or reasoning block is closed and an `{"type":"error","message":"..."}` event is sent instead of `finish`.
 
 The server-side building blocks are exported for custom handlers:
 
@@ -364,6 +447,22 @@ interface AgentResponse {
   };
   toolCalls: ToolCall[];
   trace?: { traceId: string; spans: unknown[] };
+  reasoning?: string;
+  status?: 'completed' | 'paused';
+  pendingApprovals?: PendingApproval[];
+}
+
+interface PendingApproval {
+  toolCallId: string;
+  toolName: string;
+  arguments: Record<string, unknown>;
+  description: string;
+  sideEffects?: string[];
+}
+
+interface ResumeDecisions {
+  decisions?: Record<string, { approved: true } | { approved: false; reason?: string }>;
+  defaultDecision?: { approved: true } | { approved: false; reason?: string };
 }
 
 interface RetryConfig {

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
 export { useCogitatorChat } from './use-chat.js';
 export { useCogitatorAgent } from './use-agent.js';
 export { HttpError } from './http-error.js';
-export type { ChatMessage, ToolCall, UseChatOptions, UseChatReturn, AgentInput, AgentResponse, UseAgentOptions, UseAgentReturn, RetryConfig, ToolResultEvent, } from '../types.js';
+export type { ChatMessage, ToolCall, UseChatOptions, UseChatReturn, AgentInput, AgentResponse, UseAgentOptions, UseAgentReturn, RetryConfig, ToolResultEvent, PendingApproval, ResumeDecisions, ToolApprovalDecision, } from '../types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/client/use-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-agent.d.ts","sourceRoot":"","sources":["../../src/client/use-agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA6B,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA+E1E"}
+{"version":3,"file":"use-agent.d.ts","sourceRoot":"","sources":["../../src/client/use-agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAMrB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAyG1E"}

package/dist/client/use-agent.js

@@ -2,32 +2,34 @@
 import { useState, useCallback, useEffect, useRef } from 'react';
 import { withRetry } from './retry.js';
 import { toHttpError } from './http-error.js';
+const NO_APPROVALS = [];
 export function useCogitatorAgent(options) {
-    const { api, headers, onError, onSuccess, retry } = options;
+    const { api, resumeApi, headers, onError, onSuccess, retry } = options;
     const [result, setResult] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
     const activeRequestRef = useRef(null);
+    const resultRef = useRef(null);
     useEffect(() => {
         return () => {
             activeRequestRef.current?.abort();
             activeRequestRef.current = null;
         };
     }, []);
-    const run = useCallback(async (input) => {
+    const request = useCallback(async (url, body) => {
         activeRequestRef.current?.abort();
         const controller = new AbortController();
         activeRequestRef.current = controller;
         setIsLoading(true);
         setError(null);
         const executeRequest = async () => {
-            const response = await fetch(api, {
+            const response = await fetch(url, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
                     ...headers,
                 },
-                body: JSON.stringify(input),
+                body: JSON.stringify(body),
                 signal: controller.signal,
             });
             if (!response.ok) {
@@ -39,6 +41,7 @@ export function useCogitatorAgent(options) {
             const data = await withRetry(executeRequest, retry, controller.signal);
             if (activeRequestRef.current !== controller)
                 return;
+            resultRef.current = data;
             setResult(data);
             onSuccess?.(data);
         }
@@ -57,10 +60,24 @@ export function useCogitatorAgent(options) {
                 setIsLoading(false);
             }
         }
-    }, [api, headers, onError, onSuccess, retry]);
+    }, [headers, onError, onSuccess, retry]);
+    const run = useCallback((input) => request(api, input), [api, request]);
+    const resume = useCallback(async (decisions) => {
+        const threadId = resultRef.current?.threadId;
+        if (!resumeApi || !threadId) {
+            const e = new Error(resumeApi
+                ? 'There is no result with a paused run to resume'
+                : 'useCogitatorAgent needs resumeApi to resume a paused run');
+            setError(e);
+            onError?.(e);
+            return;
+        }
+        await request(resumeApi, { threadId, ...decisions });
+    }, [onError, request, resumeApi]);
     const reset = useCallback(() => {
         activeRequestRef.current?.abort();
         activeRequestRef.current = null;
+        resultRef.current = null;
         setResult(null);
         setError(null);
         setIsLoading(false);
@@ -68,6 +85,9 @@ export function useCogitatorAgent(options) {
     return {
         run,
         result,
+        reasoning: result?.reasoning,
+        pendingApprovals: result?.pendingApprovals ?? NO_APPROVALS,
+        resume,
         isLoading,
         error,
         reset,

package/dist/client/use-agent.js.map

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

package/dist/client/use-chat-state.d.ts

@@ -1,4 +1,4 @@
-import type { ChatMessage, ToolCall } from '../types.js';
+import type { ChatMessage, PendingApproval, ToolCall } from '../types.js';
 export interface ChatState {
     messages: ChatMessage[];
     input: string;
@@ -7,7 +7,9 @@ export interface ChatState {
     threadId: string | undefined;
     currentMessageId: string | null;
     currentContent: string;
+    currentReasoning: string;
     currentToolCalls: ToolCall[];
+    pendingApprovals: PendingApproval[];
 }
 export type ChatAction = {
     type: 'SET_INPUT';
@@ -34,11 +36,17 @@ export type ChatAction = {
 } | {
     type: 'APPEND_CONTENT';
     payload: string;
+} | {
+    type: 'APPEND_REASONING';
+    payload: string;
 } | {
     type: 'ADD_TOOL_CALL';
     payload: ToolCall;
 } | {
     type: 'FINISH_ASSISTANT_MESSAGE';
+} | {
+    type: 'SET_PENDING_APPROVALS';
+    payload: PendingApproval[];
 } | {
     type: 'SET_MESSAGES';
     payload: ChatMessage[];

package/dist/client/use-chat-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat-state.d.ts","sourceRoot":"","sources":["../../src/client/use-chat-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAkE3E;AAED,wBAAgB,kBAAkB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAWhG"}
+{"version":3,"file":"use-chat-state.d.ts","sourceRoot":"","sources":["../../src/client/use-chat-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CA4E3E;AAED,wBAAgB,kBAAkB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAahG"}

package/dist/client/use-chat-state.js

@@ -19,10 +19,13 @@ export function chatReducer(state, action) {
                 ...state,
                 currentMessageId: action.payload,
                 currentContent: '',
+                currentReasoning: '',
                 currentToolCalls: [],
             };
         case 'APPEND_CONTENT':
             return { ...state, currentContent: state.currentContent + action.payload };
+        case 'APPEND_REASONING':
+            return { ...state, currentReasoning: state.currentReasoning + action.payload };
         case 'ADD_TOOL_CALL':
             return { ...state, currentToolCalls: [...state.currentToolCalls, action.payload] };
         case 'FINISH_ASSISTANT_MESSAGE': {
@@ -32,6 +35,7 @@ export function chatReducer(state, action) {
                 id: state.currentMessageId,
                 role: 'assistant',
                 content: state.currentContent,
+                ...(state.currentReasoning && { reasoning: state.currentReasoning }),
                 toolCalls: state.currentToolCalls.length > 0 ? state.currentToolCalls : undefined,
                 createdAt: new Date(),
             };
@@ -40,9 +44,14 @@ export function chatReducer(state, action) {
                 messages: [...state.messages, assistantMessage],
                 currentMessageId: null,
                 currentContent: '',
+                currentReasoning: '',
                 currentToolCalls: [],
             };
         }
+        case 'SET_PENDING_APPROVALS':
+            if (action.payload.length === 0 && state.pendingApprovals.length === 0)
+                return state;
+            return { ...state, pendingApprovals: action.payload };
         case 'SET_MESSAGES':
             return { ...state, messages: action.payload };
         case 'CLEAR_MESSAGES':
@@ -60,7 +69,9 @@ export function createInitialState(initialMessages, threadId) {
         threadId,
         currentMessageId: null,
         currentContent: '',
+        currentReasoning: '',
         currentToolCalls: [],
+        pendingApprovals: [],
     };
 }
 //# sourceMappingURL=use-chat-state.js.map

package/dist/client/use-chat-state.js.map

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

package/dist/client/use-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../src/client/use-chat.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAId,MAAM,aAAa,CAAC;AAyCrB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAiSvE"}
+{"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../src/client/use-chat.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EAMd,MAAM,aAAa,CAAC;AAgDrB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAkavE"}

package/dist/client/use-chat.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useReducer, useRef } from 'react';
 import { parseSSEStream } from './sse-parser.js';
 import { chatReducer, createInitialState, } from './use-chat-state.js';
 import { withRetry } from './retry.js';
-import { toHttpError } from './http-error.js';
+import { HttpError, toHttpError } from './http-error.js';
 let idCounter = 0;
 function generateClientId() {
     return `msg_${Date.now().toString(36)}_${(idCounter++).toString(36)}`;
@@ -21,6 +21,9 @@ function parseToolArguments(raw) {
     catch { }
     return {};
 }
+function isEventStream(response) {
+    return response.headers.get('Content-Type')?.includes('text/event-stream') ?? false;
+}
 function pendingAssistantMessage(state) {
     if (!state.currentMessageId)
         return null;
@@ -28,11 +31,12 @@ function pendingAssistantMessage(state) {
         id: state.currentMessageId,
         role: 'assistant',
         content: state.currentContent,
+        ...(state.currentReasoning && { reasoning: state.currentReasoning }),
         toolCalls: state.currentToolCalls.length > 0 ? state.currentToolCalls : undefined,
     };
 }
 export function useCogitatorChat(options) {
-    const { api, initialMessages, headers, onError, onFinish, onToolCall, onToolResult, retry } = options;
+    const { api, initialMessages, headers, onError, onFinish, onToolCall, onToolResult, onReasoning, onApprovalRequired, resumeApi, retry, } = options;
     const [state, dispatch] = useReducer(chatReducer, createInitialState(initialMessages, options.threadId));
     const stateRef = useRef(state);
     const activeRequestRef = useRef(null);
@@ -55,6 +59,13 @@ export function useCogitatorChat(options) {
         apply({ type: 'FINISH_ASSISTANT_MESSAGE' });
         apply({ type: 'STOP_LOADING' });
     }, [apply]);
+    const requireApproval = useCallback((approvals, threadId) => {
+        if (threadId && threadId !== stateRef.current.threadId) {
+            apply({ type: 'SET_THREAD_ID', payload: threadId });
+        }
+        apply({ type: 'SET_PENDING_APPROVALS', payload: approvals });
+        onApprovalRequired?.(approvals);
+    }, [apply, onApprovalRequired]);
     const handleStreamEvent = useCallback((event, toolCalls) => {
         switch (event.type) {
             case 'start':
@@ -63,6 +74,10 @@ export function useCogitatorChat(options) {
             case 'text-delta':
                 apply({ type: 'APPEND_CONTENT', payload: event.delta });
                 return false;
+            case 'reasoning-delta':
+                apply({ type: 'APPEND_REASONING', payload: event.delta });
+                onReasoning?.(event.delta);
+                return false;
             case 'tool-call-start':
                 toolCalls.set(event.id, { name: event.toolName, args: '' });
                 return false;
@@ -95,6 +110,9 @@ export function useCogitatorChat(options) {
                 onToolResult?.(toolResult);
                 return false;
             }
+            case 'approval-required':
+                requireApproval(event.approvals, event.threadId);
+                return false;
             case 'finish':
                 if (event.threadId && event.threadId !== stateRef.current.threadId) {
                     apply({ type: 'SET_THREAD_ID', payload: event.threadId });
@@ -109,7 +127,7 @@ export function useCogitatorChat(options) {
             default:
                 return false;
         }
-    }, [apply, onError, onToolCall, onToolResult]);
+    }, [apply, onError, onReasoning, onToolCall, onToolResult, requireApproval]);
     const processStream = useCallback(async (response, controller) => {
         if (!response.body) {
             throw new Error('Response body is null');
@@ -138,27 +156,41 @@ export function useCogitatorChat(options) {
             onFinish?.(finished);
         }
     }, [apply, handleStreamEvent, onFinish]);
-    const sendWithMessages = useCallback(async (messages, threadId, metadata) => {
+    const processResult = useCallback(async (response, controller) => {
+        const result = (await response.json());
+        if (activeRequestRef.current !== controller)
+            return;
+        activeRequestRef.current = null;
+        const message = {
+            id: generateClientId(),
+            role: 'assistant',
+            content: result.output,
+            ...(result.reasoning && { reasoning: result.reasoning }),
+            toolCalls: result.toolCalls.length > 0 ? result.toolCalls : undefined,
+            createdAt: new Date(),
+        };
+        apply({ type: 'APPEND_MESSAGE', payload: message });
+        if (result.status === 'paused') {
+            requireApproval(result.pendingApprovals ?? [], result.threadId);
+        }
+        else if (result.threadId && result.threadId !== stateRef.current.threadId) {
+            apply({ type: 'SET_THREAD_ID', payload: result.threadId });
+        }
+        apply({ type: 'STOP_LOADING' });
+        onFinish?.(message);
+    }, [apply, onFinish, requireApproval]);
+    const request = useCallback(async (url, body, handle, onFailure) => {
         const controller = new AbortController();
         activeRequestRef.current = controller;
         apply({ type: 'START_LOADING' });
         const doFetch = async () => {
-            const response = await fetch(api, {
+            const response = await fetch(url, {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
                     ...headers,
                 },
-                body: JSON.stringify({
-                    messages: messages.map((m) => ({
-                        id: m.id,
-                        role: m.role,
-                        content: m.content,
-                        metadata: m.metadata,
-                    })),
-                    threadId,
-                    metadata,
-                }),
+                body: JSON.stringify(body),
                 signal: controller.signal,
             });
             if (!response.ok) {
@@ -168,7 +200,7 @@ export function useCogitatorChat(options) {
         };
         try {
             const response = await withRetry(doFetch, retry, controller.signal);
-            await processStream(response, controller);
+            await handle(response, controller);
         }
         catch (err) {
             if (activeRequestRef.current !== controller)
@@ -180,10 +212,24 @@ export function useCogitatorChat(options) {
                 return;
             }
             const error = err instanceof Error ? err : new Error('Unknown error');
+            onFailure?.(error);
             apply({ type: 'SET_ERROR', payload: error });
             onError?.(error);
         }
-    }, [api, apply, headers, onError, processStream, retry]);
+    }, [apply, headers, onError, retry]);
+    const sendWithMessages = useCallback(async (messages, threadId, metadata) => {
+        apply({ type: 'SET_PENDING_APPROVALS', payload: [] });
+        await request(api, {
+            messages: messages.map((m) => ({
+                id: m.id,
+                role: m.role,
+                content: m.content,
+                metadata: m.metadata,
+            })),
+            threadId,
+            metadata,
+        }, processStream);
+    }, [api, apply, processStream, request]);
     const send = useCallback(async (inputOverride, metadata) => {
         const messageContent = inputOverride ?? stateRef.current.input;
         if (!messageContent.trim())
@@ -221,6 +267,35 @@ export function useCogitatorChat(options) {
         apply({ type: 'SET_MESSAGES', payload: messages });
         await sendWithMessages(messages, current.threadId, lastUserMessage.metadata);
     }, [apply, interrupt, sendWithMessages]);
+    const fail = useCallback((message) => {
+        const error = new Error(message);
+        apply({ type: 'SET_ERROR', payload: error });
+        onError?.(error);
+    }, [apply, onError]);
+    const resume = useCallback(async (decisions) => {
+        const { threadId } = stateRef.current;
+        if (!resumeApi) {
+            fail('useCogitatorChat needs resumeApi to resume a paused run');
+            return;
+        }
+        if (!threadId) {
+            fail('There is no thread with a paused run to resume');
+            return;
+        }
+        interrupt();
+        await request(resumeApi, { threadId, ...decisions }, async (response, controller) => {
+            apply({ type: 'SET_PENDING_APPROVALS', payload: [] });
+            await (isEventStream(response) ? processStream : processResult)(response, controller);
+        }, (error) => {
+            if (error instanceof HttpError && error.status === 409) {
+                apply({ type: 'SET_PENDING_APPROVALS', payload: [] });
+            }
+        });
+    }, [apply, fail, interrupt, processResult, processStream, request, resumeApi]);
+    const approve = useCallback(() => resume({ defaultDecision: { approved: true } }), [resume]);
+    const deny = useCallback((reason) => resume({
+        defaultDecision: reason === undefined ? { approved: false } : { approved: false, reason },
+    }), [resume]);
     const setInput = useCallback((value) => {
         apply({ type: 'SET_INPUT', payload: value });
     }, [apply]);
@@ -252,6 +327,10 @@ export function useCogitatorChat(options) {
         appendMessage,
         clearMessages,
         setMessages,
+        pendingApprovals: state.pendingApprovals,
+        resume,
+        approve,
+        deny,
     };
 }
 //# sourceMappingURL=use-chat.js.map