@parallelworks/ui 0.75.0 → 0.76.0

package/README.md

@@ -924,6 +924,19 @@ OpenAI-compatible transport sends them as the `X-Platform-Tools` header
 (`TOOLS_HEADER`), comma-separated and empty when every tool is off. A request
 without a tool choice sends no header.
 
+A tool that changes something sets `asksFirst`, which the menu shows, and its
+calls wait for the reader. The gateway streams the call, then a `toolApproval`
+chunk (`toolCallId`, optional `expiresAt`) in place of a result, and ends the
+reply there. Chat shows a confirm under the call with Allow, Deny and Deny
+with feedback, which expires at `expiresAt`. The answer goes back through
+`useChat().answerToolApproval` as a request with no new user turn:
+`StreamRequest.resume` (`messageId`, `toolCallId`, `allowed`, optional
+`feedback`), sent as `resume` in the body. The gateway's `toolResult` for the
+call lands on the reply that paused, and the model's answer streams as a new
+reply under it. In a shared conversation only the person whose message
+started the turn may answer; others see whom it waits on, and a turn someone
+else started says whose access its tools ran with.
+
 Tailwind v4 consumers add the chat rules (markdown rendering, streaming
 animations) and streamdown's classes next to the theme contract:
 

package/dist/ai/adapter/openai/createOpenAIStream.js

@@ -24,6 +24,7 @@ function createOpenAICompatibleStream(config) {
 			messages: req.messages,
 			stream: true
 		};
+		if (req.resume && !useResponses) body["resume"] = req.resume;
 		const res = await (config.fetch ?? globalThis.fetch.bind(globalThis))(url, {
 			method: "POST",
 			headers: requestHeaders(config.buildHeaders?.(req), req.tools),

package/dist/ai/adapter/openai/sse.d.ts

@@ -1,6 +1,6 @@
 import type { ToolCall, ToolCallDelta } from '../../types.js';
 import type { PartDelta } from '../types.js';
-import type { ToolResultChunk } from './wire.js';
+import type { ToolApprovalChunk, ToolResultChunk } from './wire.js';
 export type ParsedSSELine = {
     id?: string | undefined;
     messageId?: string | undefined;
@@ -8,6 +8,7 @@ export type ParsedSSELine = {
     reasoningContent?: string | undefined;
     toolCalls?: ToolCallDelta[] | undefined;
     toolResult?: ToolResultChunk | undefined;
+    toolApproval?: ToolApprovalChunk | undefined;
     finishReason?: string | null | undefined;
     model?: string | undefined;
     error?: string | undefined;

package/dist/ai/adapter/openai/sse.js

@@ -15,6 +15,7 @@ function parseSSELine(line) {
 			reasoningContent: choice?.delta?.reasoning_content,
 			toolCalls: choice?.delta?.tool_calls ?? void 0,
 			toolResult: chunk.toolResult,
+			toolApproval: chunk.toolApproval,
 			finishReason: choice?.finish_reason,
 			model: chunk.model
 		};
@@ -108,6 +109,25 @@ async function processSSEStream(reader, onContent, onToolCall, onError, onReason
 						...parsed.toolResult.isError ? { isError: true } : {}
 					});
 				}
+				if (parsed.toolApproval) {
+					const { toolCallId, expiresAt } = parsed.toolApproval;
+					answeredToolCalls.add(toolCallId);
+					onPart?.({
+						type: "tool_wait",
+						id: toolCallId
+					});
+					onPart?.({
+						type: "approval_request",
+						approval: {
+							kind: "approval",
+							id: toolCallId,
+							approvalKind: "confirm",
+							subject: "call",
+							canAllowDirectory: false,
+							...expiresAt ? { expiresAt } : {}
+						}
+					});
+				}
 			}
 		}
 	}

package/dist/ai/adapter/openai/wire.d.ts

@@ -31,9 +31,14 @@ export interface CompletionChunk {
     created?: number;
     messageId?: string;
     toolResult?: ToolResultChunk;
+    toolApproval?: ToolApprovalChunk;
     choices?: CompletionChunkChoice[] | null;
     usage?: TokenUsage;
 }
+export interface ToolApprovalChunk {
+    toolCallId: string;
+    expiresAt?: string;
+}
 export interface ToolResultChunk {
     toolCallId: string;
     content: string;

package/dist/ai/adapter/types.d.ts

@@ -21,6 +21,13 @@ export interface StreamRequest {
     allocation?: string | null;
     useResponses?: boolean;
     tools?: string[];
+    resume?: ToolApprovalAnswer;
+}
+export interface ToolApprovalAnswer {
+    messageId: string;
+    toolCallId: string;
+    allowed: boolean;
+    feedback?: string;
 }
 export interface StreamHandlers {
     onContent: (content: string) => void;
@@ -43,6 +50,9 @@ export type PartDelta = {
     type: 'tool_update';
     id: string;
     args: string;
+} | {
+    type: 'tool_wait';
+    id: string;
 } | {
     type: 'tool_end';
     id: string;
@@ -133,6 +143,7 @@ export interface ChatToolOption {
     id: string;
     label: string;
     description?: string;
+    asksFirst?: boolean;
 }
 export interface ChatToolsAdapter {
     list(): Promise<ChatToolOption[]>;

package/dist/ai/components/ChatMessage.js

@@ -34,6 +34,11 @@ function ChatMessage({ message, allMessages, isStreaming = false, latest = false
 	const isTool = message.role === "tool";
 	const otherAuthor = isUser && showAuthor && message.author && currentUsername && message.author.username !== currentUsername ? message.author : void 0;
 	const isOtherUser = !!otherAuthor;
+	const asker = !isUser && showAuthor && currentUsername ? turnAuthor(message, allMessages) : void 0;
+	const otherAsker = asker && asker.username !== currentUsername ? asker : void 0;
+	const askerName = otherAsker ? otherAsker.name || otherAsker.username : void 0;
+	const partsMessage = askerName ? waitingOn(message, askerName) : message;
+	const approvalAnswer = askerName ? void 0 : onApprovalAnswer;
 	const isRightAligned = isUser && !isOtherUser;
 	const hasError = !!message.error;
 	const hasPastes = !!message.pastes?.length;
@@ -105,9 +110,9 @@ function ChatMessage({ message, allMessages, isStreaming = false, latest = false
 		return /* @__PURE__ */ jsxs("div", {
 			className: cx("group py-3 w-full", !flush && "px-4"),
 			children: [/* @__PURE__ */ jsx(AgentMessageParts, {
-				message,
+				message: partsMessage,
 				isStreaming,
-				onApprovalAnswer
+				onApprovalAnswer: approvalAnswer
 			}), !isUser && !isStreaming && (said || onRegenerate || meta) && /* @__PURE__ */ jsxs("div", {
 				className: "chat-actions -ml-1.5 mt-2 flex items-center gap-0.5",
 				children: [
@@ -185,15 +190,15 @@ function ChatMessage({ message, allMessages, isStreaming = false, latest = false
 						className: "mb-2",
 						children: /* @__PURE__ */ jsx("div", {
 							className: "flex items-center gap-x-1.5 text-sm theme-muted-text",
-							children: /* @__PURE__ */ jsx("span", { children: message.reasoningDuration ? tThinking.thoughtFor(formatDuration(message.reasoningDuration)) : tThinking.ranToolCalls(toolCallCount) })
+							children: /* @__PURE__ */ jsx("span", { children: message.reasoningDuration ? tThinking.thoughtFor(formatDuration(message.reasoningDuration)) : askerName ? tThinking.ranToolCallsAs(toolCallCount, askerName) : tThinking.ranToolCalls(toolCallCount) })
 						})
 					}),
 					!isUser && hasParts && /* @__PURE__ */ jsx("div", {
 						className: "mb-1",
 						children: /* @__PURE__ */ jsx(AgentMessageParts, {
-							message,
+							message: partsMessage,
 							isStreaming,
-							onApprovalAnswer
+							onApprovalAnswer: approvalAnswer
 						})
 					}),
 					otherAuthor && /* @__PURE__ */ jsx("span", {
@@ -294,5 +299,25 @@ function ChatMessage({ message, allMessages, isStreaming = false, latest = false
 	});
 }
 var ChatMessage_default = memo(ChatMessage);
+/** The author of the user message that started the turn a reply belongs to.
+*  A reply that resumes after an approval hangs under the reply it resumes. */
+function turnAuthor(message, allMessages) {
+	let parentId = message.parentId;
+	for (let hops = 0; parentId && hops < allMessages.length; hops++) {
+		const parent = allMessages.find((m) => m.id === parentId);
+		if (parent?.role !== "assistant") return parent?.role === "user" ? parent.author : void 0;
+		parentId = parent.parentId;
+	}
+}
+function waitingOn(message, name) {
+	if (!message.parts?.some((p) => p.kind === "approval")) return message;
+	return {
+		...message,
+		parts: message.parts.map((p) => p.kind === "approval" ? {
+			...p,
+			waitingOn: name
+		} : p)
+	};
+}
 //#endregion
 export { ChatMessage_default as default };

package/dist/ai/components/ChatThread.js

@@ -3,13 +3,13 @@ import { useChat } from "../core/ChatProvider.js";
 import BlockedGroupBanner from "./BlockedGroupBanner.js";
 import { ComposerControls, ComposerUsage, ConnectToolsLink } from "./ComposerChrome.js";
 import ProviderIssueBanner from "./ProviderIssueBanner.js";
-import { ShareButton } from "./ShareDialog.js";
+import { ShareButton, ToolResultsSharedNote } from "./ShareDialog.js";
 import SessionView from "./SessionView.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 //#region src/ai/components/ChatThread.tsx
 function ChatThread({ conversationId }) {
-	const { adapter, currentUser, currentConversation, loadConversation, loadProviders, sendMessage, retryMessage, isLoadingConversation, navigateToBranch, queuedMessages, removeQueuedMessage } = useChat();
+	const { adapter, currentUser, currentConversation, loadConversation, loadProviders, sendMessage, retryMessage, answerToolApproval, tools, isLoadingConversation, navigateToBranch, queuedMessages, removeQueuedMessage } = useChat();
 	const { slots, strings } = useChatConfig();
 	const requestedConversationIdRef = useRef(null);
 	useEffect(() => {
@@ -52,6 +52,7 @@ function ChatThread({ conversationId }) {
 			onRetry: (id) => void retryMessage(id)
 		} : {},
 		onNavigateBranch: navigateToBranch,
+		...canWrite ? { onApprovalAnswer: answerToolApproval } : {},
 		showAuthor,
 		currentUsername: currentUser.username,
 		loading: isLoadingConversation && !currentConversation,
@@ -60,7 +61,7 @@ function ChatThread({ conversationId }) {
 		composer: {
 			disabled: isLoadingConversation || !canWrite,
 			...canWrite ? {} : { placeholder: strings.thread.viewOnly },
-			settingsLeft: /* @__PURE__ */ jsxs(Fragment, { children: [currentConversation && currentConversation.isOwner !== false && /* @__PURE__ */ jsx(ShareButton, { conversationId }), /* @__PURE__ */ jsx(ConnectToolsLink, {})] }),
+			settingsLeft: /* @__PURE__ */ jsxs(Fragment, { children: [currentConversation && currentConversation.isOwner !== false ? /* @__PURE__ */ jsx(ShareButton, { conversationId }) : tools.length > 0 && /* @__PURE__ */ jsx(ToolResultsSharedNote, {}), /* @__PURE__ */ jsx(ConnectToolsLink, {})] }),
 			settingsRight: /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(ComposerUsage, { children: slots.composerUsage }), /* @__PURE__ */ jsx(ComposerControls, {})] })
 		}
 	});

package/dist/ai/components/ComposerAddMenu.js

@@ -46,12 +46,23 @@ function RowSwitch() {
 		children: /* @__PURE__ */ jsx("span", { className: "size-3 rounded-full bg-white shadow-sm transition-transform duration-150 group-data-checked:translate-x-3 rtl:group-data-checked:-translate-x-3 motion-reduce:transition-none" })
 	});
 }
+function AsksFirst({ tool }) {
+	const t = useChatConfig().strings.composerMenu;
+	if (!tool.asksFirst) return null;
+	return /* @__PURE__ */ jsx("span", {
+		className: "ml-1.5 shrink-0 text-xs theme-muted-text",
+		children: t.asksFirst
+	});
+}
 function ToolText({ tool, descriptionId }) {
 	return /* @__PURE__ */ jsxs("span", {
 		className: "min-w-0 flex-1",
-		children: [/* @__PURE__ */ jsx("span", {
-			className: "block truncate",
-			children: tool.label
+		children: [/* @__PURE__ */ jsxs("span", {
+			className: "flex min-w-0 items-baseline",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "truncate",
+				children: tool.label
+			}), /* @__PURE__ */ jsx(AsksFirst, { tool })]
 		}), tool.description && /* @__PURE__ */ jsx("span", {
 			id: descriptionId,
 			className: "block truncate text-xs theme-muted-text",
@@ -106,9 +117,9 @@ function ToolsModalRow({ tool, enabled, onChange }) {
 		className: "flex cursor-pointer items-center gap-3 rounded-md px-2 py-2 hover:bg-(--theme-hover)",
 		children: [/* @__PURE__ */ jsxs("span", {
 			className: "min-w-0 flex-1",
-			children: [/* @__PURE__ */ jsx("span", {
-				className: "block text-sm",
-				children: tool.label
+			children: [/* @__PURE__ */ jsxs("span", {
+				className: "flex items-baseline text-sm",
+				children: [tool.label, /* @__PURE__ */ jsx(AsksFirst, { tool })]
 			}), tool.description && /* @__PURE__ */ jsx("span", {
 				id: descriptionId,
 				className: "block text-xs theme-muted-text",

package/dist/ai/components/ShareDialog.d.ts

@@ -8,4 +8,7 @@ export declare function ShareButton({ conversationId, disabled, }: {
     conversationId: string;
     disabled?: boolean;
 }): import("react").JSX.Element | null;
+/** Says that tool results in a shared conversation are visible to the
+ *  people it is shared with. */
+export declare function ToolResultsSharedNote(): import("react").JSX.Element;
 export {};

package/dist/ai/components/ShareDialog.js

@@ -249,21 +249,57 @@ function ShareDialog({ conversationId, isOpen, onClose }) {
 }
 function ShareButton({ conversationId, disabled = false }) {
 	const { strings } = useChatConfig();
-	const { adapter } = useChat();
+	const { adapter, tools } = useChat();
 	const [isOpen, setIsOpen] = useState(false);
+	const shared = useShared(conversationId, tools.length > 0 && !isOpen);
 	if (!adapter.sharing) return null;
-	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("button", {
-		type: "button",
-		onClick: () => setIsOpen(true),
-		disabled,
-		className: "flex items-center gap-1 rounded-md px-1.5 py-0.5 text-[11px] theme-muted-text transition-colors hover:theme-muted-panel hover:theme-text disabled:opacity-50",
-		title: strings.shareConversation.shareButton,
-		children: [/* @__PURE__ */ jsx(ShareIcon, { className: "h-3 w-3" }), strings.shareConversation.shareButton]
-	}), /* @__PURE__ */ jsx(ShareDialog, {
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsxs("button", {
+			type: "button",
+			onClick: () => setIsOpen(true),
+			disabled,
+			className: "flex items-center gap-1 rounded-md px-1.5 py-0.5 text-[11px] theme-muted-text transition-colors hover:theme-muted-panel hover:theme-text disabled:opacity-50",
+			title: strings.shareConversation.shareButton,
+			children: [/* @__PURE__ */ jsx(ShareIcon, { className: "h-3 w-3" }), strings.shareConversation.shareButton]
+		}),
+		shared && /* @__PURE__ */ jsx(ToolResultsSharedNote, {}),
+		/* @__PURE__ */ jsx(ShareDialog, {
+			conversationId,
+			isOpen,
+			onClose: () => setIsOpen(false)
+		})
+	] });
+}
+/** Says that tool results in a shared conversation are visible to the
+*  people it is shared with. */
+function ToolResultsSharedNote() {
+	const { strings } = useChatConfig();
+	return /* @__PURE__ */ jsx("span", {
+		className: "text-[11px] theme-muted-text",
+		children: strings.shareConversation.toolResultsShared
+	});
+}
+/** Whether anyone else can read the conversation, checked while `check` is
+*  true: tool results in it are visible to them. */
+function useShared(conversationId, check) {
+	const { adapter } = useChat();
+	const sharing = adapter.sharing;
+	const [shared, setShared] = useState(false);
+	useEffect(() => {
+		if (!check || !sharing) return;
+		let current = true;
+		sharing.listPermissions(conversationId).then((permissions) => {
+			if (current) setShared(permissions.length > 0);
+		}, () => {});
+		return () => {
+			current = false;
+		};
+	}, [
 		conversationId,
-		isOpen,
-		onClose: () => setIsOpen(false)
-	})] });
+		check,
+		sharing
+	]);
+	return shared;
 }
 //#endregion
-export { ShareButton, ShareDialog as default };
+export { ShareButton, ToolResultsSharedNote, ShareDialog as default };

package/dist/ai/components/agent/AgentMessageParts.js

@@ -19,6 +19,7 @@ import { chatProseClasses } from "../../ui/prose.js";
 import { Reasoning, ReasoningBody } from "../Reasoning.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { memo, useEffect, useId, useMemo, useState } from "react";
+import { DateTime } from "luxon";
 //#region src/ai/components/agent/AgentMessageParts.tsx
 var COLLAPSED_RESULT_LINES = 12;
 function LineSpans({ text, tokens, emphasis }) {
@@ -207,6 +208,13 @@ function ToolStatusDot({ part }) {
 			color: "var(--theme-muted-text-color)"
 		})
 	});
+	if (part.status === "waiting") return /* @__PURE__ */ jsx(StatusMark, {
+		status: t.approvalLabel,
+		children: /* @__PURE__ */ jsx("span", {
+			className: "leading-none text-(--theme-accent)",
+			children: "●"
+		})
+	});
 	if (part.status === "error") return /* @__PURE__ */ jsx(StatusMark, {
 		status: t.failed,
 		children: /* @__PURE__ */ jsx("span", {
@@ -271,7 +279,7 @@ function ToolCallBlock({ part }) {
 					children: fullToolArgs(header.arg, part.args)
 				}), /* @__PURE__ */ jsx(ResultBody, { part })]
 			}),
-			!isDiff && !expanded && /* @__PURE__ */ jsx("div", {
+			!isDiff && !expanded && part.status !== "waiting" && /* @__PURE__ */ jsx("div", {
 				className: cx("ml-5 mt-0.5 truncate text-[13px]", part.status === "error" ? "text-(--theme-error-text)" : "theme-muted-text"),
 				children: summary
 			}),
@@ -292,32 +300,38 @@ function decisionLabel(d, t) {
 			if (d.by === "auto-reviewer") return t.deniedByReviewer;
 			return d.name ? t.deniedBy(d.name) : t.denied;
 		case "expired": return t.approvalExpired;
-		case "timed_out": return t.approvalTimedOut;
-		case "failed": return t.reviewFailed;
+		case "timed_out": return d.by === "auto-reviewer" ? t.reviewTimedOut : t.approvalTimedOut;
+		case "failed": return d.by === "auto-reviewer" ? t.reviewFailed : t.denied;
 	}
 }
 function DecisionLine({ decision }) {
 	const { strings } = useChatConfig();
 	return /* @__PURE__ */ jsxs("div", {
-		className: "ml-5 mt-0.5 flex min-w-0 flex-wrap items-baseline gap-x-1 text-xs theme-muted-text",
+		className: "ml-5 mt-0.5 text-xs theme-muted-text",
 		"data-testid": "tool-decision",
-		children: [
-			/* @__PURE__ */ jsx("span", { children: decisionLabel(decision, strings.agentTranscript) }),
-			decision.at && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
-				"aria-hidden": "true",
-				children: "·"
-			}), /* @__PURE__ */ jsx(RelativeTime, {
-				value: decision.at,
-				className: "shrink-0"
-			})] }),
-			decision.note && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
-				"aria-hidden": "true",
-				children: "·"
-			}), /* @__PURE__ */ jsx("span", {
-				className: "min-w-0 max-w-full truncate",
-				children: decision.note
-			})] })
-		]
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex min-w-0 flex-wrap items-baseline gap-x-1",
+			children: [
+				/* @__PURE__ */ jsx("span", { children: decisionLabel(decision, strings.agentTranscript) }),
+				decision.at && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
+					"aria-hidden": "true",
+					children: "·"
+				}), /* @__PURE__ */ jsx(RelativeTime, {
+					value: decision.at,
+					className: "shrink-0"
+				})] }),
+				decision.note && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
+					"aria-hidden": "true",
+					children: "·"
+				}), /* @__PURE__ */ jsx("span", {
+					className: "min-w-0 max-w-full truncate",
+					children: decision.note
+				})] })
+			]
+		}), decision.reason && /* @__PURE__ */ jsx("p", {
+			className: "mt-0.5 line-clamp-2",
+			children: decision.reason
+		})]
 	});
 }
 /** Drawn the way the TUI draws a delegated Task: a tool-shaped header
@@ -384,11 +398,31 @@ function SubagentCard({ part }) {
 		})]
 	});
 }
+/** Whether the ISO time has passed, turning true when it does. */
+function useExpired(expiresAt) {
+	const [expired, setExpired] = useState(() => !!expiresAt && DateTime.fromISO(expiresAt) <= DateTime.now());
+	useEffect(() => {
+		if (!expiresAt || expired) return;
+		let timer;
+		const arm = () => {
+			const left = DateTime.fromISO(expiresAt).diffNow().toMillis();
+			if (left <= 0) {
+				setExpired(true);
+				return;
+			}
+			timer = setTimeout(arm, Math.min(left, 864e5));
+		};
+		arm();
+		return () => clearTimeout(timer);
+	}, [expiresAt, expired]);
+	return expired;
+}
 function ConfirmApproval({ part, onAnswer }) {
 	const { strings } = useChatConfig();
 	const { common } = useStrings();
 	const t = strings.agentTranscript;
 	const [feedback, setFeedback] = useState(null);
+	const expired = useExpired(part.expiresAt);
 	const answer = (a) => onAnswer?.(part.id, a);
 	const [allowLabel, denyLabel] = {
 		command: [t.allowOnce, t.deny],
@@ -405,9 +439,12 @@ function ConfirmApproval({ part, onAnswer }) {
 			className: "text-xs theme-muted-text",
 			children: part.reason
 		}),
-		!onAnswer ? /* @__PURE__ */ jsx("div", {
+		expired ? /* @__PURE__ */ jsx("div", {
 			className: "text-xs theme-muted-text",
-			children: t.approvalPending
+			children: t.approvalRequestExpired
+		}) : !onAnswer ? /* @__PURE__ */ jsx("div", {
+			className: "text-xs theme-muted-text",
+			children: part.waitingOn ? t.approvalWaitingOn(part.waitingOn) : t.approvalPending
 		}) : feedback === null ? /* @__PURE__ */ jsxs("div", {
 			className: "flex flex-wrap gap-2",
 			children: [
@@ -787,7 +824,9 @@ function buildRenderItems(parts) {
 		emitThoughts(run.slice(end));
 		run = [];
 	};
+	const decided = new Set(parts.flatMap((p) => p.kind === "tool_call" && p.decision ? [p.id] : []));
 	parts.forEach((part, index) => {
+		if (part.kind === "approval" && part.resolved && decided.has(part.id)) return;
 		if (part.kind === "reasoning" || part.kind === "tool_call" && part.status === "ok" && !part.decision && isGroupableTool(part.name)) {
 			run.push({
 				part,

package/dist/ai/core/ChatProvider.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from 'react';
 import type { ChatAdapter, ChatToolOption } from '../adapter/types.js';
-import type { AttachmentMeta, ChatModel, ChatNavigation, ChatUser, Conversation, ConversationSummary, ChatMessage as Message, MessagePart, ProviderInfo, ProviderIssue, UnreachableSession } from '../types.js';
+import type { ApprovalAnswerValue, AttachmentMeta, ChatModel, ChatNavigation, ChatUser, Conversation, ConversationSummary, ChatMessage as Message, MessagePart, ProviderInfo, ProviderIssue, UnreachableSession } from '../types.js';
 import { type ChatUIConfig } from './config.js';
 import { type SidebarPresentation, type SidebarState } from './sidebarState.js';
 interface ChatContextValue {
@@ -41,6 +41,8 @@ interface ChatContextValue {
     deleteConversation: (id: string) => Promise<boolean>;
     sendMessage: (content: string, attachmentIds?: string[], parentId?: string, attachmentMeta?: AttachmentMeta) => Promise<boolean>;
     retryMessage: (messageId: string) => Promise<boolean>;
+    /** Answers a tool call waiting for approval, resuming the reply it paused. */
+    answerToolApproval: (approvalId: string, answer: ApprovalAnswerValue) => Promise<void>;
     setSelectedProvider: (providerId: string | null) => void;
     setSelectedAllocation: (allocation: string | null) => void;
     setToolEnabled: (id: string, enabled: boolean) => void;