npm - @xopcai/xopc - Versions diffs - 0.0.252 → 0.0.254 - Mend

@xopcai/xopc 0.0.252 → 0.0.254

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (220) hide show

package/dist/gateway/static/root/index.html CHANGED Viewed

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260713-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260713-1" />
     <title>XOPC — Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-D4Ykja-U.js"></script>
+    <script type="module" crossorigin src="/assets/index-BBlJYVxR.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -25,13 +25,13 @@
     <link rel="modulepreload" crossorigin href="/assets/download-Dk-ZjtO6.js">
     <link rel="modulepreload" crossorigin href="/assets/plus-Q2yW6OE7.js">
     <link rel="modulepreload" crossorigin href="/assets/x-B_N4OPjy.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-DaIwVWar.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-BfZGZKSs.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-ChSTFZR5.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-B2v8mNJw.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-BHS7bo06.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-CV4pDOtG.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DjiwT28p.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DBWu9d_n.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-DLmwHyAh.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
@@ -48,15 +48,15 @@
     <link rel="modulepreload" crossorigin href="/assets/files-BArWTfr7.js">
     <link rel="modulepreload" crossorigin href="/assets/tool-activity-R8V9l6nk.js">
     <link rel="modulepreload" crossorigin href="/assets/button-CtTvuElV.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-DRCPXONr.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-Bpy8XX-5.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-C9ynH6VV.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-B9OZUdwC.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-9HidFZUd.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-Chsr5wGH.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-DH5wF8X8.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-w3eq3YpP.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-CISSxU1c.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-Ci5Rxmi_.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-CubltMKm.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-view-Y68dCxuc.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-zIJ3AXgR.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-_I0dD2LN.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js CHANGED Viewed

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.252";
+var version = "0.0.254";
 //#endregion
 export { version };

package/dist/packages/realtime-protocol/src/voice.js CHANGED Viewed

@@ -159,8 +159,13 @@ z.discriminatedUnion("type", [
 	serverEnvelope("response.clarification", z.strictObject({
 		responseId: z.string().min(1).max(160),
 		requestId: z.string().min(1).max(160),
+		kind: z.enum(["input", "approval"]),
 		question: z.string().min(1).max(8e3),
-		choices: z.array(z.string().max(1e3)).max(20).optional()
+		choices: z.array(z.string().max(1e3)).max(20).optional(),
+		suggestedAnswer: z.string().max(1e3).optional(),
+		version: z.number().int().positive(),
+		createdAt: z.number().nonnegative(),
+		expiresAt: z.number().nonnegative().optional()
 	})),
 	serverEnvelope("response.text.delta", z.strictObject({
 		responseId: z.string().min(1).max(160),

package/dist/src/agent/agent-manager.js CHANGED Viewed

@@ -2,25 +2,27 @@ import { resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
+import { consumeClarificationApproval } from "../storage/sqlite/clarification-wait-repository.js";
 import { getInteractionState } from "../storage/sqlite/interaction-state-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, resolveAgentProfileDir } from "./agent-scope.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
-import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { buildExecutionScopeContextForPrompt } from "./context/execution-scope.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
 import { resolveBootstrapContextSync } from "./bootstrap/bootstrap-files.js";
 import { loadProjectAgentsContextFile } from "./bootstrap/project-agents-context.js";
+import { getEmbeddedExecutionRunId } from "./embedded/execution-context.js";
 import { parseExternalToolRef } from "./external-tools/refs.js";
 import { mcpToolPolicyId } from "./mcp/bundle-mcp-policy.js";
 import { disposeAllSessionMcpRuntimes, retireSessionMcpRuntimeForSessionKey } from "./mcp/bundle-mcp-runtime.js";
@@ -47,6 +49,7 @@ import { maybeRequestChannelExecApproval } from "../channels/exec-approval-runti
 import { SkillFilesystemWatcher } from "./skills/filesystem-watcher.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { basename, resolve, sep } from "node:path";
+import { createHash } from "node:crypto";
 import { Agent } from "@earendil-works/pi-agent-core";
 //#region src/agent/agent-manager.ts
 /**
@@ -1068,12 +1071,26 @@ var AgentManager = class {
 	async requestToolConfirmation(sessionKey, toolName, detail) {
 		const request = this.config.gatewayClarify?.requestClarification;
 		if (!request) return false;
-		return await request(sessionKey, {
+		const approvalKey = createHash("sha256").update(`${toolName}\0${detail}`).digest("hex");
+		const existing = consumeClarificationApproval(sessionKey, approvalKey);
+		if (existing) return existing === "approved";
+		const runId = getEmbeddedExecutionRunId();
+		if (!runId) return false;
+		const result = await request({
+			sessionKey,
+			runId,
+			toolCallId: `approval:${approvalKey}`
+		}, {
 			kind: "approval",
 			question: `Allow ${toolName} to run once?\n${detail.slice(0, 500)}`,
 			choices: ["Allow once", "Deny"],
-			default: "Deny"
-		}).catch(() => "Deny") === "Allow once";
+			suggestedAnswer: "Deny",
+			approvalKey
+		}).catch(() => ({
+			status: "answered",
+			answer: "Deny"
+		}));
+		return result.status === "answered" && result.answer === "Allow once";
 	}
 	refreshDynamicContextIfChanged(instance) {
 		const nextProjectContext = this.buildExecutionScopeContext(instance.sessionKey);

package/dist/src/agent/background-review/run-background-review.js CHANGED Viewed

@@ -4,10 +4,10 @@ import { finishContextExtractionRun } from "../../storage/sqlite/context-extract
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import { loadCompactionSourceSnapshot } from "../../storage/sqlite/transcript-repository.js";
 import "../../storage/sqlite/index.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers, resolveModel } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { extractTextContent } from "../context/workspace.js";
 import { listUserAssertions } from "../../user-model/repository.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";

package/dist/src/agent/embedded/execution-context.d.ts CHANGED Viewed

@@ -1,2 +1,3 @@
-export declare function runWithEmbeddedExecutionSession<T>(sessionKey: string, run: () => T): T;
+export declare function runWithEmbeddedExecutionSession<T>(sessionKey: string, run: () => T, runId?: string): T;
 export declare function getEmbeddedExecutionSession(): string | undefined;
+export declare function getEmbeddedExecutionRunId(): string | undefined;

package/dist/src/agent/embedded/execution-context.js CHANGED Viewed

@@ -1,11 +1,17 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/agent/embedded/execution-context.ts
 const executionSessionStorage = new AsyncLocalStorage();
-function runWithEmbeddedExecutionSession(sessionKey, run) {
-	return executionSessionStorage.run(sessionKey, run);
+function runWithEmbeddedExecutionSession(sessionKey, run, runId) {
+	return executionSessionStorage.run({
+		sessionKey,
+		runId
+	}, run);
 }
 function getEmbeddedExecutionSession() {
-	return executionSessionStorage.getStore();
+	return executionSessionStorage.getStore()?.sessionKey;
+}
+function getEmbeddedExecutionRunId() {
+	return executionSessionStorage.getStore()?.runId;
 }
 //#endregion
-export { getEmbeddedExecutionSession, runWithEmbeddedExecutionSession };
+export { getEmbeddedExecutionRunId, getEmbeddedExecutionSession, runWithEmbeddedExecutionSession };

package/dist/src/agent/embedded/index.d.ts CHANGED Viewed

@@ -4,7 +4,7 @@ export { installSessionToolResultGuard, guardSessionManager, getRawSessionAppend
 export { repairAssistantUsageInSessionManager } from './session-manager-init.js';
 export { openSqliteHydratingSessionManager } from './sqlite-hydrating-session-manager.js';
 export { createSqliteTranscriptRuntime, InMemoryTranscriptRuntime, type EmbeddedTranscriptRuntime, } from './transcript-runtime.js';
-export { getEmbeddedExecutionSession, runWithEmbeddedExecutionSession } from './execution-context.js';
+export { getEmbeddedExecutionRunId, getEmbeddedExecutionSession, runWithEmbeddedExecutionSession, } from './execution-context.js';
 export { acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, isEmbeddedSessionRunnerEnabled, resetEmbeddedSessionRunnerForTest, } from './session-runner.js';
 export { DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, resolveLiveToolResultMaxChars, truncateToolResultMessage, } from './tool-result-truncation.js';
 export { runXopcEmbeddedTurn, abortEmbeddedRun, queueEmbeddedSteer } from './run-turn.js';

package/dist/src/agent/embedded/index.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { getEmbeddedExecutionSession, runWithEmbeddedExecutionSession } from "./execution-context.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession, runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { abortEmbeddedRun, getEmbeddedRunBySessionKey, queueEmbeddedSteer } from "./runs.js";
 import { DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool-result-truncation.js";
 import { getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard } from "./session-tool-result-guard.js";
@@ -9,4 +9,4 @@ import { InMemoryTranscriptRuntime, createSqliteTranscriptRuntime } from "./tran
 import { runXopcEmbeddedTurn } from "./run-turn.js";
 import { runEmbeddedTurnForSession } from "./run-for-session.js";
 import { CURRENT_SESSION_VERSION, PiTranscriptManager } from "./pi-transcript.js";
-export { CURRENT_SESSION_VERSION, DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, InMemoryTranscriptRuntime, PiTranscriptManager, abortEmbeddedRun, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, createSqliteTranscriptRuntime, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedExecutionSession, getEmbeddedRunBySessionKey, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard, isEmbeddedSessionRunnerEnabled, openSqliteHydratingSessionManager, queueEmbeddedSteer, repairAssistantUsageInSessionManager, resetEmbeddedSessionRunnerForTest, resolveLiveToolResultMaxChars, runEmbeddedTurnForSession, runWithEmbeddedExecutionSession, runXopcEmbeddedTurn, truncateToolResultMessage };
+export { CURRENT_SESSION_VERSION, DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS, InMemoryTranscriptRuntime, PiTranscriptManager, abortEmbeddedRun, acquireEmbeddedSessionRunner, buildEmbeddedRunnerFingerprint, createSqliteTranscriptRuntime, evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner, getEmbeddedExecutionRunId, getEmbeddedExecutionSession, getEmbeddedRunBySessionKey, getEmbeddedSessionRunnerIdleTtlMs, getEmbeddedSessionRunnerStats, getRawSessionAppendMessage, guardSessionManager, installSessionToolResultGuard, isEmbeddedSessionRunnerEnabled, openSqliteHydratingSessionManager, queueEmbeddedSteer, repairAssistantUsageInSessionManager, resetEmbeddedSessionRunnerForTest, resolveLiveToolResultMaxChars, runEmbeddedTurnForSession, runWithEmbeddedExecutionSession, runXopcEmbeddedTurn, truncateToolResultMessage };

package/dist/src/agent/embedded/model-runtime.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { init_paths, resolveModelsJsonPath } from "../../config/paths.js";
-import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { XopcModelCredentialStore, init_model_credential_store } from "../../auth/model-credential-store.js";
 import { init_register_bundled_oauth_flows, registerBundledOAuthFlows } from "../../providers/register-bundled-oauth-flows.js";
 import { init_register_runtime_providers, registerRuntimeProviders } from "../../providers/register-runtime-providers.js";

package/dist/src/agent/embedded/run-for-session.js CHANGED Viewed

@@ -1,8 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseTurnOutcome } from "../../../packages/gateway-contract/src/turn-outcome.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
 import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
 import { evaluateContextBudget } from "../memory/context-budget.js";
@@ -27,7 +28,7 @@ async function runEmbeddedTurnForSession(params) {
 		parentSignal: params.abortSignal
 	});
 	const finish = async (result) => {
-		if (result.stopReason === "connection_required") return result;
+		if (result.stopReason === "connection_required" || result.stopReason === "clarification_required") return result;
 		try {
 			const rows = await sessionStore.loadTranscriptRows(sessionKey);
 			const hasTurn = rows.some((source) => {
@@ -180,7 +181,7 @@ async function runEmbeddedTurnForSession(params) {
 				total: resolvedCandidates.length
 			}, "Agent model fallback started");
 			try {
-				const turnResult = await runXopcEmbeddedTurn({
+				const turnResult = await runWithEmbeddedExecutionSession(sessionKey, () => runXopcEmbeddedTurn({
 					sessionKey,
 					runId,
 					userMessage: userMessageForTurn,
@@ -199,7 +200,7 @@ async function runEmbeddedTurnForSession(params) {
 					onEvent: params.onEvent,
 					onAgentEvent: (event) => agentManager.emitRuntimeEvent(sessionKey, event),
 					resumeLastUserMessage
-				});
+				}), runId);
 				if (turnResult.ok) {
 					if (isFallbackAttempt) log.info({
 						sessionKey,

package/dist/src/agent/embedded/run-turn.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { getClarificationResumeInput, isClarificationSuspended } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput, isConnectionSuspended } from "../../storage/sqlite/connection-wait-repository.js";
 import { EmbeddedRunConflictError, abortEmbeddedRun, acquireEmbeddedRunLease, queueEmbeddedSteer } from "./runs.js";
 import { lastAssistantPlainText, subscribeEmbeddedSessionEvents } from "./subscribe-session.js";
@@ -235,6 +236,7 @@ async function runXopcEmbeddedTurn(params) {
 		});
 		let policyStopped = false;
 		let connectionStopped = false;
+		let clarificationStopped = false;
 		params.turnPolicy?.reset();
 		session.agent.beforeToolCall = async (context, signal) => {
 			if (connectionStopped) return {
@@ -242,6 +244,11 @@ async function runXopcEmbeddedTurn(params) {
 				reason: "Waiting for the user to connect an app.",
 				terminate: true
 			};
+			if (clarificationStopped) return {
+				block: true,
+				reason: "Waiting for the user to answer.",
+				terminate: true
+			};
 			const decision = await params.turnPolicy?.beforeToolCall(context, signal);
 			if (decision?.block) {
 				policyStopped ||= decision.terminate === true;
@@ -259,6 +266,7 @@ async function runXopcEmbeddedTurn(params) {
 		};
 		session.agent.afterToolCall = async (context) => {
 			connectionStopped ||= isConnectionSuspended(sessionKey, runId);
+			clarificationStopped ||= isClarificationSuspended(sessionKey, runId);
 			const scoped = context.toolCall.name === "read_file" ? await instructions.forTool(context.toolCall.name, context.args) : "";
 			const checked = await verification.afterTool(context);
 			if (scoped) checked.result.content.unshift({
@@ -273,7 +281,7 @@ async function runXopcEmbeddedTurn(params) {
 		};
 		session.agent.shouldStopAfterTurn = (context) => {
 			policyStopped ||= params.turnPolicy?.shouldStopAfterTurn(context) ?? false;
-			return policyStopped || connectionStopped;
+			return policyStopped || connectionStopped || clarificationStopped;
 		};
 		unsubscribe = subscribeEmbeddedSessionEvents(session, (event) => {
 			if (event.type === "message_end" && event.message.role === "assistant") recordPromptCacheTouch(sessionKey, resolvedModel, event.message.usage);
@@ -290,11 +298,17 @@ async function runXopcEmbeddedTurn(params) {
 		try {
 			await runAgentTurnWithTimeout(session.agent, async () => {
 				const connectionResume = getConnectionResumeInput(sessionKey, runId);
+				const clarificationResume = getClarificationResumeInput(sessionKey, runId);
 				if (connectionResume) await session.sendCustomMessage({
 					customType: "connection_resume",
 					content: connectionResume.content,
 					display: false
 				}, { triggerTurn: true });
+				else if (clarificationResume) await session.sendCustomMessage({
+					customType: "clarification_resume",
+					content: clarificationResume.content,
+					display: false
+				}, { triggerTurn: true });
 				else if (params.resumeLastUserMessage) await session.agent.continue();
 				else {
 					const text = userMessageToPromptText(userMessage);
@@ -302,7 +316,8 @@ async function runXopcEmbeddedTurn(params) {
 					await session.prompt(text, images.length > 0 ? { images } : void 0);
 				}
 				await session.agent.waitForIdle();
-				if (connectionStopped) return;
+				clarificationStopped ||= isClarificationSuspended(sessionKey, runId);
+				if (connectionStopped || clarificationStopped) return;
 				await maybeRetryTurnAfterTransientLlmFailure(session.agent, {
 					sessionKey,
 					log,
@@ -330,6 +345,10 @@ async function runXopcEmbeddedTurn(params) {
 				runId,
 				sessionKey
 			});
+			if (clarificationStopped) runner.piSm.appendCustomEntry("clarification_required", {
+				runId,
+				sessionKey
+			});
 			runner.piSm.appendCustomEntry("coding_verification", {
 				runId,
 				workspace: workspaceDir,
@@ -356,7 +375,7 @@ async function runXopcEmbeddedTurn(params) {
 			});
 			return {
 				ok: true,
-				...connectionStopped ? { stopReason: "connection_required" } : {},
+				...connectionStopped ? { stopReason: "connection_required" } : clarificationStopped ? { stopReason: "clarification_required" } : {},
 				lastAssistantText: lastAssistantPlainText(session)
 			};
 		} finally {

package/dist/src/agent/embedded/types.d.ts CHANGED Viewed

@@ -89,7 +89,7 @@ export type RunXopcEmbeddedTurnParams = {
 };
 export type RunXopcEmbeddedTurnResult = {
     ok: boolean;
-    stopReason?: 'connection_required';
+    stopReason?: 'connection_required' | 'clarification_required';
     /** False for harness failures that must not trigger another model attempt. */
     retryable?: boolean;
     errorMessage?: string;

package/dist/src/agent/image/tool-model-config.js CHANGED Viewed

@@ -1,7 +1,7 @@
 import { getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "../../config/schema.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { getDefaultModelSync, getModelsByProvider, init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { resolveAgentModelFallbackValues, resolveAgentModelPrimaryValue } from "../../config/model-input.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";

package/dist/src/agent/mcp/oauth/mcp-oauth-store.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { init_paths, resolveMcpOAuthPath } from "../../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../../../infra/write-file-atomic.js";
+import { init_paths, resolveMcpOAuthPath } from "../../../config/paths.js";
 import { createHash } from "node:crypto";
 import { readFile, rm } from "node:fs/promises";
 //#region src/agent/mcp/oauth/mcp-oauth-store.ts

package/dist/src/agent/service/direct-turn-helpers.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { getClarificationResumeInput } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput } from "../../storage/sqlite/connection-wait-repository.js";
 import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
 import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
@@ -87,6 +88,8 @@ async function tryRunSlashCommand(deps, ctx, content, options) {
 async function runDirectAgentTurn(deps, input) {
 	const turnId = input.runId ?? crypto.randomUUID();
 	const isConnectionResume = Boolean(getConnectionResumeInput(input.sessionKey, turnId));
+	const isClarificationResume = Boolean(getClarificationResumeInput(input.sessionKey, turnId));
+	const isResume = isConnectionResume || isClarificationResume;
 	const userPlain = extractAgentUserPlainText(input.userMessage);
 	const userContext = await deps.agentManager.prepareUserTurnContext(input.userMessage, input.sessionKey, turnId);
 	const sourceContexts = input.sourceContexts ?? [];
@@ -111,11 +114,11 @@ async function runDirectAgentTurn(deps, input) {
 		getConfig: () => deps.config,
 		abortSignal: input.abortSignal,
 		deadlineAtMs: input.deadlineAtMs,
-		beforeTurn: isConnectionResume ? void 0 : () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey),
+		beforeTurn: isResume ? void 0 : () => deps.agentManager.beginBackgroundReviewUserTurn(input.sessionKey),
 		onEvent: input.onEvent
 	});
-	if (!isConnectionResume) await deps.agentManager.afterAgentTurn(input.sessionKey, userPlain, turnId);
-	if (!isConnectionResume && result.stopReason !== "connection_required") deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);
+	if (!isResume) await deps.agentManager.afterAgentTurn(input.sessionKey, userPlain, turnId);
+	if (!isResume && result.stopReason !== "connection_required" && result.stopReason !== "clarification_required") deps.agentManager.scheduleBackgroundReviewAfterUserTurn(input.sessionKey);
 	return result;
 }
 //#endregion

package/dist/src/agent/service/process-direct-streaming.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { getClarificationResumeInput } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput } from "../../storage/sqlite/connection-wait-repository.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
@@ -126,6 +127,8 @@ function pushAssistantReceipt(queue, text, runId, metadata) {
 async function* runProcessDirectStreaming(deps, input) {
 	const sessionKey = input.sessionKey ?? "agent:main:main";
 	const isConnectionResume = Boolean(input.runId && getConnectionResumeInput(sessionKey, input.runId));
+	const isClarificationResume = Boolean(input.runId && getClarificationResumeInput(sessionKey, input.runId));
+	const isInternalResume = isConnectionResume || isClarificationResume;
 	const { channel, chatId } = await deps.resolveSessionEndpoint(sessionKey);
 	const context = deps.initDirectStreamingSession(sessionKey, channel, chatId, input.origin);
 	const queue = new AsyncQueue({
@@ -276,7 +279,7 @@ async function* runProcessDirectStreaming(deps, input) {
 					if (sourceContext && !sourceContexts.some((context) => context.kind === sourceContext.kind && context.sourceId === sourceContext.sourceId)) sourceContexts.push(sourceContext);
 				}
 			}
-			if (channel === "webchat" && !isConnectionResume) {
+			if (channel === "webchat" && !isInternalResume) {
 				pushVisible({
 					type: "user_message",
 					timestamp: userMessage.timestamp ?? Date.now(),
@@ -287,7 +290,7 @@ async function* runProcessDirectStreaming(deps, input) {
 				if (textForAgent.trim()) deps.enqueueProvisionalSessionTitle?.(sessionKey, textForAgent);
 			}
 			const pendingUserMessage = sourceContexts.length > 0 ? injectSourceContextsIntoUserMessage(userMessage, sourceContexts) : userMessage;
-			if (!isConnectionResume) setPendingTranscriptUserMessage(sessionKey, pendingUserMessage);
+			if (!isInternalResume) setPendingTranscriptUserMessage(sessionKey, pendingUserMessage);
 			try {
 				const result = await deps.agentManager.withSkillCapabilities(sessionKey, skillTurn.activatedCapabilityNames, () => runDirectAgentTurn({
 					sessionStore: deps.sessionStore,
@@ -314,7 +317,7 @@ async function* runProcessDirectStreaming(deps, input) {
 					content: formatStreamError(result.errorMessage)
 				});
 			} finally {
-				if (!isConnectionResume) clearPendingTranscriptUserMessage(sessionKey, pendingUserMessage);
+				if (!isInternalResume) clearPendingTranscriptUserMessage(sessionKey, pendingUserMessage);
 			}
 		} catch (err) {
 			if (err instanceof AsyncQueueOverflowError) {

package/dist/src/agent/service.d.ts CHANGED Viewed

@@ -121,12 +121,14 @@ export declare class AgentService {
     refreshUserProfileContext(): void;
     getMemoryManager(): import("./memory/manager.js").MemoryManager;
     getModelForSession(sessionKey: string): string;
+    getThinkingLevelForSession(sessionKey: string): ThinkingLevel;
     /** Run a full tool-capable turn against a caller-owned, non-persistent transcript. */
     runEphemeralTurn(params: {
         executionSessionKey: string;
         parentSessionKey: string;
         runId: string;
         content: string;
+        attachments?: InboundAttachmentInput[];
         modelRef: string;
         thinkingLevel?: ThinkingLevel;
         transcriptRuntime: EmbeddedTranscriptRuntime;

package/dist/src/agent/service.js CHANGED Viewed

@@ -2,10 +2,10 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { extractProfileAgentId } from "../config/agent-profile.js";
 import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
@@ -19,6 +19,7 @@ import "../user-model/index.js";
 import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";
+import { buildTranscriptUserMessage, hydrateUserTurnForLlm } from "./inbound/attachment-pipeline.js";
 import { runXopcEmbeddedTurn } from "./embedded/run-turn.js";
 import { resolveResponseLanguageForSession } from "./prompt/response-language.js";
 import { normalizeSkillInstallTarget } from "./skills/install-target.js";
@@ -577,19 +578,31 @@ var AgentService = class {
 	getModelForSession(sessionKey) {
 		return this.modelManager.getModelForSession(sessionKey);
 	}
+	getThinkingLevelForSession(sessionKey) {
+		return this.agentManager.getOrCreateAgent(sessionKey).state.thinkingLevel ?? "medium";
+	}
 	/** Run a full tool-capable turn against a caller-owned, non-persistent transcript. */
 	async runEphemeralTurn(params) {
 		const agent = this.agentManager.getOrCreateAgent(params.parentSessionKey);
 		const workspaceDir = this.agentManager.getResolvedWorkspaceForSession(params.parentSessionKey);
 		const model = resolveModel(params.modelRef);
+		const prepared = await this.prepareInboundAttachments(params.executionSessionKey, params.attachments);
+		const userMessage = await buildTranscriptUserMessage({
+			text: params.content,
+			prepared,
+			sessionKey: params.parentSessionKey,
+			modelRef: params.modelRef,
+			config: this.effectiveAppConfig(),
+			agentManager: this.agentManager
+		});
+		const llmTurn = await hydrateUserTurnForLlm({
+			message: userMessage,
+			modelRef: params.modelRef
+		});
 		return runWithEmbeddedExecutionSession(params.executionSessionKey, () => runXopcEmbeddedTurn({
 			sessionKey: params.executionSessionKey,
 			runId: params.runId,
-			userMessage: {
-				role: "user",
-				content: params.content,
-				timestamp: Date.now()
-			},
+			userMessage,
 			model,
 			modelRef: params.modelRef,
 			tools: agent.state.tools,
@@ -600,8 +613,9 @@ var AgentService = class {
 			timeoutMs: resolveAgentTurnTimeoutMs(this.effectiveAppConfig(), params.parentSessionKey),
 			turnPolicy: this.agentManager.createAgentTurnPolicy(params.parentSessionKey),
 			abortSignal: params.abortSignal,
-			onEvent: params.onEvent
-		}));
+			onEvent: params.onEvent,
+			images: llmTurn.images
+		}), params.runId);
 	}
 	async switchModelForSession(sessionKey, modelId) {
 		if (!await this.modelManager.switchModelForSession(sessionKey, modelId)) return false;

package/dist/src/agent/session/session-inspector.js CHANGED Viewed

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "../../config/workspace-defaults.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getExecutionEnvironmentForSession } from "../../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession, projectWorkspacePath } from "../../session/session-workspace.js";
 import { getProjectForSession } from "../../projects/workspace.js";

package/dist/src/agent/skills/hub-lock.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/skills/hub-lock.ts
 /**

package/dist/src/agent/tasks/task-judge-service.js CHANGED Viewed

@@ -1,15 +1,15 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { readWorkspaceRevision } from "../coding/workspace-revision.js";
-import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
-import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";
 //#region src/agent/tasks/task-judge-service.ts
 init_schema();
 init_providers();

package/dist/src/agent/tools/browser/tool/browser-use-tool.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { formatBrowserObservation } from "../../../../browser/observation/format.js";
-import { BrowserUseSchema } from "./schemas.js";
+import { BrowserUseSchema, decodeBrowserUseInput } from "./schemas.js";
 //#region src/agent/tools/browser/tool/browser-use-tool.ts
 function createBrowserUseTool(deps) {
 	return {
@@ -8,6 +8,21 @@ function createBrowserUseTool(deps) {
 		description: "Control a persistent browser through typed semantic actions. Start with observe or navigate, then use only refs and revision values from the latest observation. Screenshots are attached only when requested or semantic observation is insufficient.",
 		parameters: BrowserUseSchema,
 		async execute(_toolCallId, params, signal) {
+			const input = decodeBrowserUseInput(params);
+			if (!input) return {
+				content: [{
+					type: "text",
+					text: `[INVALID_INPUT] Invalid parameters for browser action "${params.action}".`
+				}],
+				details: {
+					ok: false,
+					kind: "browser_error",
+					error: {
+						code: "INVALID_INPUT",
+						message: `Invalid parameters for browser action "${params.action}".`
+					}
+				}
+			};
 			const readiness = await deps.getReadiness?.();
 			if (readiness) return {
 				content: [{
@@ -20,7 +35,7 @@ function createBrowserUseTool(deps) {
 					hint: readiness.hint
 				}
 			};
-			return presentResult(await deps.getRuntime().execute(deps.getTaskId(), params, signal));
+			return presentResult(await deps.getRuntime().execute(deps.getTaskId(), input, signal));
 		}
 	};
 }