@parallelworks/ui 0.75.0 → 0.76.0

package/dist/ai/core/ChatProvider.js

@@ -44,6 +44,20 @@ function heldSendArgs(held) {
 		preceding.length > 0 ? preceding : void 0
 	];
 }
+/** The wire history for the messages shown, oldest first. */
+function historyMessages(messages, selectedProvider) {
+	return messages.filter((m) => m.content || m.toolCalls?.length || m.parts?.length).flatMap((m) => {
+		const msg = {
+			role: m.role,
+			content: m.content || null
+		};
+		if (m.role === "assistant" && m.reasoning) msg.reasoning_content = m.reasoning;
+		if (m.role === "assistant" && m.toolCalls?.length) msg.tool_calls = m.toolCalls;
+		if (m.role === "assistant" && m.responsesOutput?.length && m.model === selectedProvider) msg.responses_output = m.responsesOutput;
+		if (m.role === "tool" && m.toolCallId) msg.tool_call_id = m.toolCallId;
+		return m.role === "assistant" ? toolTurnMessages(m.parts, msg) : [msg];
+	});
+}
 var NO_TOOLS = [];
 var ChatContext = createContext(void 0);
 var ChatStreamContext = createContext(void 0);
@@ -291,6 +305,124 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 		state.currentConversation,
 		navigation
 	]);
+	const streamReply = useCallback(async (targetConversationId, request, parentId, onFailure, routePart) => {
+		backgroundStreamsRef.current.set(targetConversationId, {
+			content: "",
+			reasoning: "",
+			parts: [],
+			messageId: null,
+			isActive: true
+		});
+		dispatch({
+			type: "SET_STREAMING",
+			isStreaming: true,
+			conversationId: targetConversationId
+		});
+		dispatch({
+			type: "CLEAR_STREAMING_CONTENT",
+			conversationId: targetConversationId
+		});
+		const controller = new AbortController();
+		abortControllerRef.current = controller;
+		try {
+			let thinkingStart = null;
+			let thinkingEnd = null;
+			const markStreamStart = () => {
+				if (thinkingStart === null) thinkingStart = Date.now();
+			};
+			let liveParts = [];
+			const { content: assistantContent, messageId: assistantMessageId, toolCalls, model: resolvedModel, reasoning: assistantReasoning, responsesOutput } = await adapter.streamCompletion(request, {
+				onContent: (chunk) => {
+					markStreamStart();
+					onStreamingChunk(chunk);
+				},
+				onReasoning: (reasoning) => {
+					markStreamStart();
+					thinkingEnd = Date.now();
+					dispatch({
+						type: "APPEND_STREAMING_REASONING",
+						reasoning,
+						conversationId: targetConversationId
+					});
+					const bgStream = backgroundStreamsRef.current.get(targetConversationId);
+					if (bgStream) bgStream.reasoning += reasoning;
+				},
+				onMessageId: (messageId) => {
+					markStreamStart();
+					const bgStream = backgroundStreamsRef.current.get(targetConversationId);
+					if (bgStream) bgStream.messageId = messageId;
+				},
+				onPart: (delta) => {
+					markStreamStart();
+					if (routePart?.(delta)) return;
+					liveParts = applyPartDelta(liveParts, delta);
+					dispatch({
+						type: "APPLY_STREAMING_PART",
+						delta,
+						conversationId: targetConversationId
+					});
+					const bgStream = backgroundStreamsRef.current.get(targetConversationId);
+					if (bgStream) bgStream.parts = liveParts;
+				}
+			}, controller.signal);
+			const thinkingDuration = assistantReasoning && thinkingStart !== null ? (thinkingEnd ?? Date.now()) - thinkingStart : null;
+			const assistantMessage = {
+				id: assistantMessageId || crypto.randomUUID(),
+				parentId,
+				role: "assistant",
+				content: assistantContent || (toolCalls.length > 0 ? null : ""),
+				toolCalls: toolCalls.length > 0 ? toolCalls : void 0,
+				model: request.useResponses ? request.model : resolvedModel || request.model,
+				providerId: state.selectedProvider,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				reasoning: assistantReasoning || void 0,
+				reasoningDuration: thinkingDuration ?? void 0,
+				responsesOutput: responsesOutput.length ? responsesOutput : void 0,
+				...liveParts.length ? { parts: finalizeParts(liveParts) } : {}
+			};
+			dispatch({
+				type: "ADD_MESSAGE",
+				message: assistantMessage,
+				conversationId: targetConversationId
+			});
+			return "sent";
+		} catch (error) {
+			if (error instanceof DOMException && error.name === "AbortError") return "aborted";
+			console.error("Failed to send message:", error);
+			onFailure(errorText(error));
+			return "failed";
+		} finally {
+			abortControllerRef.current = null;
+			const { unrevealed } = stopAnimationLoop();
+			if (unrevealed) dispatch({
+				type: "APPEND_STREAMING_CONTENT",
+				content: unrevealed,
+				conversationId: targetConversationId
+			});
+			streamingConversationIdRef.current = null;
+			backgroundStreamsRef.current.delete(targetConversationId);
+			setTimeout(() => {
+				streamingToConversationRef.current = null;
+			}, 500);
+			dispatch({
+				type: "SET_STREAMING",
+				isStreaming: false,
+				conversationId: targetConversationId
+			});
+			dispatch({
+				type: "CLEAR_STREAMING_CONTENT",
+				conversationId: targetConversationId
+			});
+		}
+	}, [
+		adapter,
+		state.selectedProvider,
+		onStreamingChunk,
+		stopAnimationLoop,
+		streamingConversationIdRef,
+		backgroundStreamsRef,
+		abortControllerRef
+	]);
 	const sendMessage = useCallback(async (content, attachmentIds, parentId, attachmentMeta, precedingMessages) => {
 		if (isSendingRef.current) {
 			const convId = currentConversationIdRef.current;
@@ -405,13 +537,6 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 			message: userMessage,
 			conversationId: targetConversationId
 		});
-		backgroundStreamsRef.current.set(targetConversationId, {
-			content: "",
-			reasoning: "",
-			parts: [],
-			messageId: null,
-			isActive: true
-		});
 		const setMessageError = (errorMsg) => {
 			dispatch({
 				type: "UPDATE_MESSAGE",
@@ -421,17 +546,7 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 			});
 		};
 		const apiMessages = [
-			...(isNewConversation ? [] : state.currentConversation?.messages || []).filter((m) => m.content || m.toolCalls?.length || m.parts?.length).flatMap((m) => {
-				const msg = {
-					role: m.role,
-					content: m.content || null
-				};
-				if (m.role === "assistant" && m.reasoning) msg.reasoning_content = m.reasoning;
-				if (m.role === "assistant" && m.toolCalls?.length) msg.tool_calls = m.toolCalls;
-				if (m.role === "assistant" && m.responsesOutput?.length && m.model === state.selectedProvider) msg.responses_output = m.responsesOutput;
-				if (m.role === "tool" && m.toolCallId) msg.tool_call_id = m.toolCallId;
-				return m.role === "assistant" ? toolTurnMessages(m.parts, msg) : [msg];
-			}),
+			...historyMessages(isNewConversation ? [] : state.currentConversation?.messages || [], state.selectedProvider),
 			...precedingApiMessages,
 			{
 				role: "user",
@@ -439,28 +554,10 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 				attachment_ids: attachmentIds?.length ? attachmentIds : void 0
 			}
 		];
-		dispatch({
-			type: "SET_STREAMING",
-			isStreaming: true,
-			conversationId: targetConversationId
-		});
-		dispatch({
-			type: "CLEAR_STREAMING_CONTENT",
-			conversationId: targetConversationId
-		});
-		const controller = new AbortController();
-		abortControllerRef.current = controller;
-		let sendSucceeded = false;
-		let wasAborted = false;
+		const useResponses = state.models.find((m) => m.id === modelString)?.supports_responses === true;
+		let outcome = "failed";
 		try {
-			const useResponses = state.models.find((m) => m.id === modelString)?.supports_responses === true;
-			let thinkingStart = null;
-			let thinkingEnd = null;
-			const markStreamStart = () => {
-				if (thinkingStart === null) thinkingStart = Date.now();
-			};
-			let liveParts = [];
-			const { content: assistantContent, messageId: assistantMessageId, toolCalls, model: resolvedModel, reasoning: assistantReasoning, responsesOutput } = await adapter.streamCompletion({
+			outcome = await streamReply(targetConversationId, {
 				model: modelString,
 				messages: apiMessages,
 				conversationId,
@@ -469,94 +566,11 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 				allocation: state.selectedAllocation,
 				useResponses,
 				...tools ? { tools: enabledToolIds } : {}
-			}, {
-				onContent: (chunk) => {
-					markStreamStart();
-					onStreamingChunk(chunk);
-				},
-				onReasoning: (reasoning) => {
-					markStreamStart();
-					thinkingEnd = Date.now();
-					dispatch({
-						type: "APPEND_STREAMING_REASONING",
-						reasoning,
-						conversationId: targetConversationId
-					});
-					const bgStream = backgroundStreamsRef.current.get(targetConversationId);
-					if (bgStream) bgStream.reasoning += reasoning;
-				},
-				onMessageId: (messageId) => {
-					markStreamStart();
-					const bgStream = backgroundStreamsRef.current.get(targetConversationId);
-					if (bgStream) bgStream.messageId = messageId;
-				},
-				onPart: (delta) => {
-					markStreamStart();
-					liveParts = applyPartDelta(liveParts, delta);
-					dispatch({
-						type: "APPLY_STREAMING_PART",
-						delta,
-						conversationId: targetConversationId
-					});
-					const bgStream = backgroundStreamsRef.current.get(targetConversationId);
-					if (bgStream) bgStream.parts = liveParts;
-				}
-			}, controller.signal);
-			const thinkingDuration = assistantReasoning && thinkingStart !== null ? (thinkingEnd ?? Date.now()) - thinkingStart : null;
-			const assistantMessage = {
-				id: assistantMessageId || crypto.randomUUID(),
-				parentId: userMessageId,
-				role: "assistant",
-				content: assistantContent || (toolCalls.length > 0 ? null : ""),
-				toolCalls: toolCalls.length > 0 ? toolCalls : void 0,
-				model: useResponses ? modelString : resolvedModel || modelString,
-				providerId: state.selectedProvider,
-				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-				reasoning: assistantReasoning || void 0,
-				reasoningDuration: thinkingDuration ?? void 0,
-				responsesOutput: responsesOutput.length ? responsesOutput : void 0,
-				...liveParts.length ? { parts: finalizeParts(liveParts) } : {}
-			};
-			dispatch({
-				type: "ADD_MESSAGE",
-				message: assistantMessage,
-				conversationId: targetConversationId
-			});
-			if (isNewConversation) loadConversations();
-			sendSucceeded = true;
-			return true;
-		} catch (error) {
-			if (error instanceof DOMException && error.name === "AbortError") {
-				wasAborted = true;
-				return false;
-			}
-			console.error("Failed to send message:", error);
-			setMessageError(errorText(error));
-			return false;
+			}, userMessageId, setMessageError);
+			if (outcome === "sent" && isNewConversation) loadConversations();
+			return outcome === "sent";
 		} finally {
-			abortControllerRef.current = null;
-			const { unrevealed } = stopAnimationLoop();
-			if (unrevealed) dispatch({
-				type: "APPEND_STREAMING_CONTENT",
-				content: unrevealed,
-				conversationId: targetConversationId
-			});
-			streamingConversationIdRef.current = null;
-			backgroundStreamsRef.current.delete(targetConversationId);
-			setTimeout(() => {
-				streamingToConversationRef.current = null;
-			}, 500);
-			dispatch({
-				type: "SET_STREAMING",
-				isStreaming: false,
-				conversationId: targetConversationId
-			});
-			dispatch({
-				type: "CLEAR_STREAMING_CONTENT",
-				conversationId: targetConversationId
-			});
-			if (wasAborted) isSendingRef.current = false;
-			else if (sendSucceeded) {
+			if (outcome === "sent") {
 				const next = heldSendArgs(pendingQueueRef.current);
 				pendingQueueRef.current = [];
 				dispatch({ type: "CLEAR_QUEUED_MESSAGES" });
@@ -581,16 +595,84 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 		createConversation,
 		loadConversations,
 		navigation,
-		onStreamingChunk,
 		startStreaming,
-		stopAnimationLoop,
-		streamingConversationIdRef,
-		backgroundStreamsRef,
-		abortControllerRef
+		streamReply
 	]);
 	useEffect(() => {
 		sendMessageRef.current = sendMessage;
 	}, [sendMessage]);
+	const answerToolApproval = useCallback(async (approvalId, answer) => {
+		const conversation = state.currentConversation;
+		const modelString = state.selectedProvider;
+		if (answer.kind !== "confirm" || !conversation || !modelString || isSendingRef.current) return;
+		const pausedAt = conversation.messages.findIndex((m) => m.role === "assistant" && m.parts?.some((p) => p.kind === "approval" && p.id === approvalId && !p.resolved));
+		const paused = conversation.messages[pausedAt];
+		if (!paused) return;
+		isSendingRef.current = true;
+		const targetConversationId = conversation.id;
+		const t = resolvedConfig.strings.agentTranscript;
+		let pausedParts = paused.parts ?? [];
+		const updatePaused = (updates) => dispatch({
+			type: "UPDATE_MESSAGE",
+			messageId: paused.id,
+			updates,
+			conversationId: targetConversationId
+		});
+		const applyToPaused = (delta) => {
+			pausedParts = applyPartDelta(pausedParts, delta);
+			updatePaused({ parts: pausedParts });
+		};
+		applyToPaused({
+			type: "approval_resolved",
+			id: approvalId,
+			answer: answer.allowed ? t.approvalAllowed : t.approvalDenied
+		});
+		applyToPaused({
+			type: "tool_decision",
+			id: approvalId,
+			decision: {
+				status: answer.allowed ? "approved" : "denied",
+				by: "user",
+				name: currentUser.name || currentUser.username,
+				at: DateTime.now().toUTC().toISO()
+			}
+		});
+		streamingToConversationRef.current = targetConversationId;
+		startStreaming(targetConversationId);
+		try {
+			await streamReply(targetConversationId, {
+				model: modelString,
+				messages: historyMessages(conversation.messages.slice(0, pausedAt + 1), state.selectedProvider),
+				conversationId: targetConversationId,
+				parentMessageId: paused.id,
+				userMessageId: crypto.randomUUID(),
+				allocation: state.selectedAllocation,
+				...tools ? { tools: enabledToolIds } : {},
+				resume: {
+					messageId: paused.id,
+					toolCallId: approvalId,
+					allowed: answer.allowed,
+					...answer.denyMessage ? { feedback: answer.denyMessage } : {}
+				}
+			}, paused.id, (message) => updatePaused({ error: message }), (delta) => {
+				if (delta.type !== "tool_end" || delta.id !== approvalId) return false;
+				applyToPaused(delta);
+				return true;
+			});
+		} finally {
+			isSendingRef.current = false;
+		}
+	}, [
+		resolvedConfig,
+		state.currentConversation,
+		state.selectedProvider,
+		state.selectedAllocation,
+		tools,
+		enabledToolIds,
+		startStreaming,
+		streamReply,
+		currentUser
+	]);
 	const updateConversationTitle = useCallback(async (id, title) => {
 		try {
 			await adapter.conversations.rename(id, title);
@@ -807,6 +889,7 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 		deleteConversation,
 		sendMessage,
 		retryMessage,
+		answerToolApproval,
 		setSelectedProvider,
 		setSelectedAllocation,
 		setToolEnabled,
@@ -854,6 +937,7 @@ function ChatProvider({ adapter, currentUser, navigation, activeConversationId =
 		deleteConversation,
 		sendMessage,
 		retryMessage,
+		answerToolApproval,
 		setSelectedProvider,
 		setSelectedAllocation,
 		setToolEnabled,

package/dist/ai/core/parts.js

@@ -34,6 +34,10 @@ function applyPartDelta(parts, delta) {
 			...p,
 			args: p.args + delta.args
 		} : p);
+		case "tool_wait": return parts.map((p) => p.kind === "tool_call" && p.id === delta.id ? {
+			...p,
+			status: "waiting"
+		} : p);
 		case "tool_end": return parts.map((p) => p.kind === "tool_call" && p.id === delta.id ? {
 			...p,
 			status: delta.isError ? "error" : "ok",
@@ -99,7 +103,7 @@ function isStreamedText(part) {
 *  calls comes back as the answer alone. */
 function toolTurnMessages(parts, answer) {
 	const calls = (parts ?? []).filter((p) => p.kind === "tool_call" && p.status !== "running" && p.result !== void 0);
-	if (calls.length === 0) return [answer];
+	if (calls.length === 0) return answer.content || answer.tool_calls?.length ? [answer] : [];
 	return [
 		{
 			role: "assistant",

package/dist/ai/strings.d.ts

@@ -15,6 +15,8 @@ export interface ChatStrings {
         addGroups: string;
         info: ReactNode;
         shareButton: string;
+        /** Beside the share button in a shared conversation that can use tools. */
+        toolResultsShared: string;
     };
     blockedGroup: {
         title: (group: string) => string;
@@ -67,6 +69,8 @@ export interface ChatStrings {
         turnAllOff: string;
         /** Closes the tools modal; each switch takes effect as it is flipped. */
         done: string;
+        /** Marks a tool whose calls wait for the reader's approval. */
+        asksFirst: string;
     };
     allocationPicker: {
         choose: string;
@@ -121,6 +125,9 @@ export interface ChatStrings {
         activity: string;
         /** A finished turn's label when it ran tools without reasoning. */
         ranToolCalls: (count: number) => string;
+        /** The same, in a shared conversation, for a turn someone else started:
+         *  its tools ran with that person's access. */
+        ranToolCallsAs: (count: number, name: string) => string;
     };
     thread: {
         viewOnly: string;
@@ -243,6 +250,7 @@ export interface ChatStrings {
         deniedByReviewer: string;
         approvalExpired: string;
         approvalTimedOut: string;
+        reviewTimedOut: string;
         reviewFailed: string;
         writeOwnAnswer: string;
         subagent: string;
@@ -252,6 +260,13 @@ export interface ChatStrings {
         approvalOptions: string;
         /** Names a question the agent waits on that has no heading of its own. */
         approvalLabel: string;
+        /** A call the reader approved or declined. */
+        approvalAllowed: string;
+        approvalDenied: string;
+        /** A call nobody answered in time. */
+        approvalRequestExpired: string;
+        /** A call only the person who asked for it may answer. */
+        approvalWaitingOn: (name: string) => string;
         /** Names the field for the reason a request is denied. */
         feedbackLabel: string;
         /** Names the field for an answer of the reader's own. */

package/dist/ai/strings.js

@@ -20,7 +20,8 @@ var defaultChatStrings = {
 			/* @__PURE__ */ jsx("strong", { children: "Collaborate" }),
 			" permission allows adding messages."
 		] }),
-		shareButton: "Share conversation"
+		shareButton: "Share conversation",
+		toolResultsShared: "Tool results here are visible to the people it's shared with"
 	},
 	blockedGroup: {
 		title: (group) => `Billing group \u201c${group}\u201d is over its allocation`,
@@ -59,12 +60,13 @@ var defaultChatStrings = {
 		tools: "Tools",
 		someToolsOff: "Some tools are off",
 		toolsOn: (enabled, total) => `${enabled.toLocaleString()}/${total.toLocaleString()}`,
-		toolsDescription: "What the assistant may look up for you.",
+		toolsDescription: "What the assistant may look up or do for you.",
 		searchTools: "Search tools",
 		noToolsMatch: "No tools match",
 		turnAllOn: "Turn all on",
 		turnAllOff: "Turn all off",
-		done: "Done"
+		done: "Done",
+		asksFirst: "Asks first"
 	},
 	allocationPicker: {
 		choose: "Allocation",
@@ -150,7 +152,8 @@ var defaultChatStrings = {
 		thoughtFor: (duration) => `Thought for ${duration}`,
 		thoughtProcess: "Thought process",
 		activity: "Activity",
-		ranToolCalls: (count) => `Ran ${countOf(count, "tool call", "tool calls")}`
+		ranToolCalls: (count) => `Ran ${countOf(count, "tool call", "tool calls")}`,
+		ranToolCallsAs: (count, name) => `Ran ${countOf(count, "tool call", "tool calls")} as ${name}`
 	},
 	thread: {
 		viewOnly: "You have view only access",
@@ -260,8 +263,9 @@ var defaultChatStrings = {
 		allowedByReviewer: "Allowed by the auto-reviewer",
 		deniedByReviewer: "Denied by the auto-reviewer",
 		approvalExpired: "Expired without an answer",
-		approvalTimedOut: "No answer in time",
-		reviewFailed: "The auto-reviewer could not decide",
+		approvalTimedOut: "Denied: no answer in time",
+		reviewTimedOut: "Denied: the auto-reviewer timed out",
+		reviewFailed: "Denied: the auto-reviewer failed",
 		writeOwnAnswer: "Write my own answer…",
 		subagent: "Task",
 		tasks: "Tasks",
@@ -269,6 +273,10 @@ var defaultChatStrings = {
 		approvalPending: "Waiting for an answer in the terminal",
 		approvalOptions: "Offered choices",
 		approvalLabel: "Waiting for your answer",
+		approvalAllowed: "Allowed",
+		approvalDenied: "Declined",
+		approvalRequestExpired: "This request expired. Ask again to run it.",
+		approvalWaitingOn: (name) => `Waiting for ${name} to answer`,
 		feedbackLabel: "Feedback for the agent",
 		ownAnswerLabel: "Your answer",
 		todoPending: "To do",

package/dist/ai/types.d.ts

@@ -45,7 +45,7 @@ export interface TokenUsage {
     completion_tokens?: number;
     total_tokens?: number;
 }
-export type ToolCallStatus = 'running' | 'ok' | 'error';
+export type ToolCallStatus = 'running' | 'waiting' | 'ok' | 'error';
 export interface TextPart {
     kind: 'text';
     text: string;
@@ -65,6 +65,8 @@ export interface ToolDecision {
     /** ISO time of the answer. */
     at?: string;
     note?: string;
+    /** Why it was settled this way, such as the auto-reviewer's rationale. */
+    reason?: string;
 }
 export interface ToolCallPart {
     kind: 'tool_call';
@@ -120,6 +122,8 @@ export interface ApprovalPart {
     options?: ApprovalOption[];
     plan?: string;
     canAllowDirectory?: boolean;
+    expiresAt?: string;
+    waitingOn?: string;
     resolved?: boolean;
     answer?: string;
 }

package/dist/components/relativeTime.js

@@ -65,7 +65,7 @@ function useRelativeTime(value, format = "long") {
 		const unit = unitOf(age);
 		const key = `${format}:${at}:${unit}:${Math.trunc(age / unit)}`;
 		if (last.current?.key !== key) {
-			const label = format === "compact" ? compactLabel(age, t) : DateTime.fromMillis(at).toRelative({ base: DateTime.fromMillis(current) }) ?? "";
+			const label = format === "compact" ? compactLabel(age, t) : Math.abs(age) < SECOND ? t.now : DateTime.fromMillis(at).toRelative({ base: DateTime.fromMillis(current) }) ?? "";
 			last.current = {
 				key,
 				label