@xopcai/xopc 0.0.423 → 0.0.424

package/dist/src/gateway/service/session-input-coordinator.js

@@ -4,10 +4,10 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
 import { SessionInstanceChangedError, cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, findSessionInputByRunId, finishSessionInputRun, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "../../storage/sqlite/session-input-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
-import { consumeClarificationResume, getActiveClarification, supersedeActiveClarification } from "../../storage/sqlite/clarification-wait-repository.js";
-import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "../../storage/sqlite/session-turn-replace-repository.js";
 import { cancelConnectionObjective, consumeConnectionResume, getActiveConnectionWait, getConnectionWait, hasPendingConnectionMessages, init_connection_wait_repository, interruptedConnectionMessage, publishConnectionWait, reconcileConnectionWaits } from "../../storage/sqlite/connection-wait-repository.js";
 import { appendTranscriptEntry } from "../../storage/sqlite/transcript-repository.js";
+import { consumeClarificationResume, getActiveClarification, supersedeActiveClarification } from "../../storage/sqlite/clarification-wait-repository.js";
+import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "../../storage/sqlite/session-turn-replace-repository.js";
 import "../../storage/sqlite/index.js";
 import { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
 import { consumePhoneAssistance, finishPhoneAssistance, phoneAssistance, queuePhoneAssistance, reconcilePhoneAssistance } from "../../phone/assistance.js";
@@ -50,9 +50,10 @@ function connectionInputPayload(wait, control) {
 	};
 }
 function sameAppContext(input, existing) {
-	const identity = (sources) => sources?.filter((source) => source.kind === "app_context").map((source) => ({
+	const identity = (sources) => sources?.filter((source) => source.kind === "app_context" || source.kind === "device_context").map((source) => ({
 		snapshot: source.appContext,
-		principal: source.appContextGrant?.principal.principalId
+		principal: source.appContextGrant?.principal.principalId,
+		interactionCapabilities: source.interactionCapabilities
 	})) ?? [];
 	return isDeepStrictEqual(input.origin, existing.origin) && isDeepStrictEqual(identity(input.sourceContexts), identity(existing.contextSnapshots));
 }

package/dist/src/gateway/service.js

@@ -85,8 +85,8 @@ import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
 import { ChatPreviewService } from "../chat-previews/service.js";
 import "../chat-previews/index.js";
-import "../config/index.js";
 import { configureGatewayHttpProxy } from "../infra/http-proxy-env.js";
+import "../config/index.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
@@ -94,18 +94,14 @@ import { PersonalReplyComposer } from "../personal-agent/reply-composer.js";
 import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
-import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
-import "../endpoint-tools/index.js";
 import { DiscussionService } from "../discussions/service.js";
 import { DiscussionOrganizer } from "../discussions/organizer.js";
 import { DiscussionLiveWorker } from "../discussions/live-worker.js";
 import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
 import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
-import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
-import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
-import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
+import "../endpoint-tools/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { deliverAutomationCompletion } from "./automation-completion-delivery.js";
@@ -167,6 +163,10 @@ import { TaskMainUpdateDecisionService } from "../tasks/task-main-update-decisio
 import { selectTaskMainUpdateAttempt, submitAndConfirmTaskMainUpdate } from "../tasks/task-main-update-input.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
+import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
+import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import crypto from "node:crypto";
 //#region src/gateway/service.ts
 init_session_repository();

package/dist/src/gateway/xopc-cloud-capability-setup.js

@@ -1,7 +1,6 @@
 import "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { init_model_policy, isComputerModel, isDedicatedComputerProfile } from "../computer/model-policy.js";
 import { voiceSupportsMode } from "../../packages/realtime-protocol/src/voice-catalog.js";
@@ -9,6 +8,7 @@ import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
 import { phoneModelProfile } from "../phone/model-adapter.js";
 import { compareCatalogModels } from "../providers/model-catalog-ranking.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
 init_voice();

package/dist/src/home-intelligence/host.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { HomeAdviceBudgetExceededError, isHomeProseLocalized } from "./generator.js";
 import { homePatternKey } from "./strategy.js";
+import { HomeAdvicePolicy } from "./policy.js";
 import { HomeIntelligenceRepository } from "./repository.js";
 import { HomeOpportunityApplicationService } from "./application-service.js";
-import { HomeAdvicePolicy } from "./policy.js";
-import { HomeAdviceBudgetExceededError, isHomeProseLocalized } from "./generator.js";
 import { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts

package/dist/src/imports/importService.js

@@ -11,8 +11,8 @@ import { scanLocal } from "./scanner.js";
 import { dirname, join } from "node:path";
 import { existsSync, lstatSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
-import yaml from "js-yaml";
 import lockfile from "proper-lockfile";
+import yaml from "js-yaml";
 //#region src/imports/importService.ts
 init_write_file_atomic();
 init_logger();

package/dist/src/local-apps/service.js

@@ -5,9 +5,9 @@ import { init_logger } from "../utils/logger.js";
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { slugifyProjectName } from "../projects/project-store.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { LocalAppStore } from "./store.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";

package/dist/src/personal-agent/service.js

@@ -2,13 +2,13 @@ import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js
 import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { setSessionConfig } from "../storage/sqlite/config-repository.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
 import { getAvailableModels, init_providers } from "../providers/index.js";
 import { getPersonalAgent, personalAgentId } from "./repository.js";
 import { PERSONAL_MAIN_TOOL_IDS, PERSONAL_READ_TOOL_ALIASES } from "./policy.js";
 import { getModelThinking } from "../providers/model-thinking.js";
 import { personalInstructions } from "./prompts.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { completePersonalOnboarding } from "./onboarding.js";
 import { z } from "zod";
 //#region src/personal-agent/service.ts

package/dist/src/phone/assistance.js

@@ -251,6 +251,9 @@ function phoneAssistanceReport(wait) {
 	return {
 		...wait.checkpoint.report,
 		assistanceId: wait.id,
+		assistanceVersion: wait.version,
+		transcriptId: wait.transcriptId,
+		hasPendingTask: true,
 		reconnectRequired: true,
 		mock: false,
 		mode: "control",

package/dist/src/phone/contracts.d.ts

@@ -376,6 +376,10 @@ export type PhoneReading = {
 };
 export type PhoneReport = {
     assistanceId?: string;
+    assistanceVersion?: number;
+    transcriptId?: string;
+    revision?: number;
+    hasPendingTask?: boolean;
     reconnectRequired?: boolean;
     sessionId: string;
     deviceId: string;

package/dist/src/phone/runtime.d.ts

@@ -92,6 +92,10 @@ export declare class PhoneRuntime {
         report: {
             nextExecutionMode: "collaborative" | "direct";
             assistanceId?: string;
+            assistanceVersion?: number;
+            transcriptId?: string;
+            revision?: number;
+            hasPendingTask?: boolean;
             reconnectRequired?: boolean;
             sessionId: string;
             deviceId: string;
@@ -159,7 +163,9 @@ export declare class PhoneRuntime {
     };
     liveVideo(owner: string, id: string, context: ExecutionContext): Promise<PhoneInteractiveSession>;
     private openLiveVideo;
-    disconnectVideo(owner: string, id: string, client: string, epoch?: number): Promise<void>;
+    disconnectVideo(owner: string, id: string, _client: string, _epoch?: number): Promise<void>;
+    private clearExpiredHuman;
+    private expireHuman;
     liveFrame(owner: string, id: string, context: ExecutionContext, signal: AbortSignal): Promise<{
         frame: Buffer<ArrayBuffer>;
         height: number;

package/dist/src/phone/runtime.js

@@ -330,6 +330,8 @@ var PhoneRuntime = class {
 			modelRequests: session.report.modelRequests - session.segmentUsage.modelRequests,
 			activeDurationMs: session.segmentUsage.activeDurationMs + (session.budget?.elapsedMs ?? 0)
 		}, session.report.feedback);
+		session.report.revision = (session.report.revision ?? 0) + 1;
+		session.report.hasPendingTask = Boolean(session.taskPending);
 		session.report.updatedAt = Date.now();
 		if (session.report.task) updatePhoneCheckpoint(session.report.owner, this.checkpoint(session));
 		this.repository.report(session.report);
@@ -1665,15 +1667,7 @@ var PhoneRuntime = class {
 						this.stopDevice(session.device.id);
 						continue;
 					}
-					if (session.human && Date.now() > (session.humanExpiresAt ?? 0)) {
-						session.human = void 0;
-						session.report.controlOwner = "none";
-						session.report.controlEpoch++;
-						session.report.status = "paused";
-						session.report.stopReason = "control_disconnected";
-						this.publish(session);
-						session.stream?.revoke().catch(() => this.stop(session.report.owner, "cancel"));
-					}
+					if (session.human && Date.now() > (session.humanExpiresAt ?? 0)) this.expireHuman(session).catch(() => this.stop(session.report.owner, "cancel"));
 					if (Date.now() - session.viewedAt > 3e4) session.frames.clear();
 				} catch {
 					session.frames.clear();
@@ -1776,28 +1770,39 @@ var PhoneRuntime = class {
 			throw error;
 		}
 	}
-	async disconnectVideo(owner, id, client, epoch) {
+	async disconnectVideo(owner, id, _client, _epoch) {
 		const session = this.sessions.get(owner);
 		if (!session || session.report.sessionId !== id) return;
-		if (session.human === client && (epoch === void 0 || session.report.controlEpoch === epoch)) {
-			session.human = void 0;
-			session.report.controlOwner = "none";
-			session.report.controlEpoch++;
-			session.report.status = "paused";
-			session.report.stopReason = "control_disconnected";
-			this.publish(session);
-			try {
-				await session.stream?.revoke();
-			} catch {
-				await this.stop(owner, "cancel");
-			}
-		}
 		if (session.stream?.viewerCount === 0) {
 			const stream = session.stream;
 			session.stream = void 0;
 			await stream.close();
 		}
 	}
+	async clearExpiredHuman(session) {
+		if (!session.human || Date.now() <= (session.humanExpiresAt ?? 0)) return;
+		session.human = void 0;
+		session.report.controlOwner = "none";
+		session.report.controlEpoch++;
+		session.report.status = "paused";
+		session.report.stopReason = "control_disconnected";
+		session.report.handoff = "acquiring";
+		this.publish(session);
+		try {
+			await session.stream?.revoke();
+		} catch (error) {
+			await this.stop(session.report.owner, "cancel");
+			throw error;
+		} finally {
+			session.report.handoff = "idle";
+			this.publish(session);
+		}
+	}
+	expireHuman(session) {
+		const work = session.commands.catch(() => {}).then(() => this.clearExpiredHuman(session));
+		session.commands = work.catch(() => {});
+		return work;
+	}
 	async liveFrame(owner, id, context, signal) {
 		const session = this.liveSession(owner, id, context);
 		if (terminal.has(session.report.status)) {
@@ -1857,6 +1862,7 @@ var PhoneRuntime = class {
 			if (terminal.has(session.report.status)) throw new PhoneError("PHONE_OPEN_REQUIRED", "Phone session ended", 409);
 			this.guard(session, context, input.op === "handback");
 			if (session.switching) throw new PhoneError("PHONE_SESSION_BUSY", "Phone execution mode is changing", 409);
+			await this.clearExpiredHuman(session);
 			if (input.epoch !== session.report.controlEpoch) throw new PhoneError("PHONE_CONTROL_CHANGED", "Control changed. Refresh before trying again.", 409);
 			if (session.human && session.human !== client) throw new PhoneError("PHONE_CONTROL_BUSY", "Another browser window controls this phone", 409);
 			if (input.op === "cancel") {
@@ -1992,7 +1998,8 @@ var PhoneRuntime = class {
 		if (!session) throw new PhoneError("PHONE_OPEN_REQUIRED", "Reconnect the phone before continuing", 409);
 		this.guard(session, context);
 		if (session.report.controlOwner === "agent" && session.report.status === "ready") return;
-		await this.liveControl(owner, session.report.sessionId, context, session.human ?? `phone-user:${owner}`, {
+		if (session.human) throw new PhoneError("PHONE_CONTROL_BUSY", "Another client is operating the phone. End manual control before continuing.", 409);
+		await this.liveControl(owner, session.report.sessionId, context, `phone-user:${owner}`, {
 			op: "handback",
 			epoch: session.report.controlEpoch,
 			operationId: randomUUID()

package/dist/src/routing/agent-session-key.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { validateConversationId } from "../../packages/gateway-contract/src/conversation-identity.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
 import { DEFAULT_ACCOUNT_ID, init_account_id, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
 import { init_conversation_repository, requireConversation, resolveRoutedConversation } from "../storage/sqlite/conversation-repository.js";
-import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
 //#region src/routing/agent-session-key.ts
 function normalizeMainKey(value) {
 	return normalizeLowercaseStringOrEmpty(value) || "main";

package/dist/src/runtime-tools/archive.js

@@ -1,8 +1,8 @@
 import { RuntimeError } from "./errors.js";
 import { isAbsolute, join, posix, relative, resolve } from "node:path";
 import { spawn } from "node:child_process";
-import { lstat, mkdir, readdir, readlink, rename, rm, stat } from "node:fs/promises";
 import AdmZip from "adm-zip";
+import { lstat, mkdir, readdir, readlink, rename, rm, stat } from "node:fs/promises";
 //#region src/runtime-tools/archive.ts
 const MAX_ARCHIVE_ENTRIES = 5e4;
 const MAX_TAR_OUTPUT_BYTES = 16 * 1024 * 1024;

package/dist/src/session/session-context-for-llm.js

@@ -298,6 +298,7 @@ function buildSessionContextForLlm(rows) {
 			continue;
 		}
 		if (isTranscriptCustomMessageEntry(r)) {
+			if (r.customType === "clarification_answers") continue;
 			if (r.customType === "task_allocation_status" && isRoutineTaskAllocationStatus(r.details)) continue;
 			if (r.customType === "personal_request_status" || r.customType === "connection_control_status") continue;
 			if (r.customType === "personal_proactive_message") {

package/dist/src/session/session-title.js

@@ -1,12 +1,12 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { isCronConversationId } from "../routing/agent-session-key.js";
 import { init_session_key } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
-import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 //#region src/session/session-title.ts
 init_session_key();
 init_providers();

package/dist/src/storage/sqlite/clarification-wait-repository.js

@@ -5,6 +5,8 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "./session-instance-repository.js";
 import { bumpSessionInputRevision, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput } from "./session-input-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
+import { appendTranscriptEntry } from "./transcript-repository.js";
+import { estimateTextTokens } from "../../agent/memory/context-budget.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/clarification-wait-repository.ts
 init_src();
@@ -16,7 +18,8 @@ init_transaction();
 const APPROVAL_TTL_MS = 10 * 6e4;
 const STALE_CONTEXT_MS = 1440 * 6e4;
 function rowToWait(row) {
-	return JSON.parse(row.data_json);
+	const wait = JSON.parse(row.data_json);
+	return wait.schemaVersion === 2 ? normalizeClarificationQuestion(wait) : wait;
 }
 function getRow(id) {
 	return getSqliteDatabase().prepare(`SELECT id, conversation_id, transcript_id, status, version, data_json
@@ -176,6 +179,8 @@ function createClarificationWait(input) {
 			kind: input.kind,
 			status: "open",
 			question: input.question.trim(),
+			schemaVersion: input.schemaVersion,
+			questions: input.questions,
 			interactionMode: input.interactionMode,
 			choiceDetails: input.choiceDetails,
 			recommendedChoiceId: input.recommendedChoiceId,
@@ -232,10 +237,12 @@ function resolveClarification(input) {
 		let normalized;
 		try {
 			if (input.action === "answer") normalized = normalizeClarificationSubmission(wait, {
+				schemaVersion: input.schemaVersion,
+				answers: input.answers,
 				response: input.response,
 				decision: input.decision
 			});
-			else if (input.response !== void 0 || input.decision !== void 0) return {
+			else if (input.response !== void 0 || input.decision !== void 0 || input.answers !== void 0) return {
 				ok: false,
 				code: "INVALID"
 			};
@@ -245,13 +252,28 @@ function resolveClarification(input) {
 				code: "INVALID"
 			};
 		}
+		if (wait.schemaVersion === 2 && normalized && estimateTextTokens(normalized.answer) > 2e3) return {
+			ok: false,
+			code: "INVALID"
+		};
+		if (wait.schemaVersion === 2 !== (input.schemaVersion === 2)) return {
+			ok: false,
+			code: "INVALID"
+		};
+		const responseIdentity = JSON.stringify({
+			schemaVersion: wait.schemaVersion ?? 1,
+			action: input.action,
+			answers: normalized?.answers,
+			response: normalized?.response,
+			decision: normalized?.decision
+		});
 		if (input.action === "agent_decide" && wait.kind === "approval") return {
 			ok: false,
 			code: "INVALID"
 		};
 		const resolution = input.action === "answer" ? "answered" : input.action === "agent_decide" ? "agent_decide" : "cancelled";
 		if (wait.responseIdempotencyKey === input.idempotencyKey) {
-			if (wait.resolution !== resolution || normalized && wait.answer !== normalized.answer) return {
+			if (wait.resolution !== resolution || (wait.schemaVersion === 2 ? wait.responseIdentity !== responseIdentity : normalized && wait.answer !== normalized.answer)) return {
 				ok: false,
 				code: "CONFLICT",
 				clarification: wait
@@ -279,6 +301,7 @@ function resolveClarification(input) {
 				status: "cancelled",
 				resolution,
 				responseIdempotencyKey: input.idempotencyKey,
+				responseIdentity,
 				resolvedAt: now,
 				updatedAt: now
 			}, wait.version);
@@ -298,10 +321,14 @@ function resolveClarification(input) {
 			};
 		}
 		const answer = input.action === "agent_decide" ? "Use your best judgment and continue without additional user input." : normalized.answer;
+		const resumeInputId = randomUUID();
 		const queued = writeWait({
 			...wait,
 			status: "queued",
 			response: normalized?.response,
+			answers: normalized?.answers,
+			responseIdentity,
+			resumeInputId,
 			decision: normalized?.decision,
 			answer,
 			resolution,
@@ -324,7 +351,7 @@ function resolveClarification(input) {
 		].filter(Boolean).join("\n");
 		const origin = getSessionInputById(wait.conversationId, wait.originInputId);
 		insertSessionInput({
-			id: randomUUID(),
+			id: resumeInputId,
 			conversationId: wait.conversationId,
 			expectedTranscriptId: wait.transcriptId,
 			clientMessageId: input.idempotencyKey,
@@ -347,6 +374,20 @@ function resolveClarification(input) {
 				source: "internal"
 			}
 		});
+		if (wait.schemaVersion === 2) appendTranscriptEntry(wait.conversationId, {
+			role: "custom",
+			customType: "clarification_answers",
+			display: true,
+			content: answer,
+			details: {
+				waitId: wait.id,
+				schemaVersion: 2,
+				questions: wait.questions,
+				answers: normalized?.answers,
+				resolution
+			},
+			timestamp: now
+		}, { transcriptId: wait.transcriptId });
 		return {
 			ok: true,
 			clarification: queued,

package/dist/src/storage/sqlite/index.js

@@ -15,9 +15,14 @@ import { createCollaborationRule, getCollaborationRule, listCollaborationRules,
 import { createContextEvidence } from "./context-evidence-repository.js";
 import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
 import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput, listActiveSessionInputExecutions, listActiveSessionInputRuns, listTaskUpdateRunIds, listTaskUpdateTriggers, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
-import { consumeClarificationApproval, consumeClarificationResume, createClarificationWait, getActiveClarification, getClarification, getClarificationResumeInput, getClarificationSnapshot, isClarificationSuspended, resolveClarification, supersedeActiveClarification } from "./clarification-wait-repository.js";
 import { buildDefaultSessionMetadata, init_session_metadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, init_row_mappers, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
+import { getConnectorAccount, init_connector_account_repository, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
+import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, init_connector_repository, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-repository.js";
+import { getSessionMetadata } from "./session-read-repository.js";
+import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getCurrentTranscriptId, getGlobalSessionStats, incrementSessionStatsOnAppend, init_session_repository, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
+import { appendCompactionBoundaryIfUnchanged, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, findLatestAssistantTranscriptEntryId, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";
+import { consumeClarificationApproval, consumeClarificationResume, createClarificationWait, getActiveClarification, getClarification, getClarificationResumeInput, getClarificationSnapshot, isClarificationSuspended, resolveClarification, supersedeActiveClarification } from "./clarification-wait-repository.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "./session-turn-replace-repository.js";
 import { acknowledgeHomeAttention, isHomeAttentionAcknowledged } from "./home-attention-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "./connector-learning-repository.js";
@@ -25,13 +30,8 @@ import { COMPOSER_INPUT_HISTORY_LIMIT, appendComposerInputHistory, clearComposer
 import { bindEndpointPrincipal, createEndpointPrincipal, getEndpointPrincipal, listEndpointPrincipals, revokeEndpointPrincipal, touchEndpointPrincipal } from "./endpoint-principal-repository.js";
 import { finishEndpointToolInvocationAudit, listEndpointToolInvocationAuditPage, startEndpointToolInvocationAudit } from "./endpoint-tool-invocation-repository.js";
 import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
-import { getConnectorAccount, init_connector_account_repository, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
-import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, init_connector_repository, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-repository.js";
-import { getSessionMetadata } from "./session-read-repository.js";
-import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getCurrentTranscriptId, getGlobalSessionStats, incrementSessionStatsOnAppend, init_session_repository, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "./session-task-plan-repository.js";
 import { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout } from "./sidebar-layout-repository.js";
-import { appendCompactionBoundaryIfUnchanged, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, findLatestAssistantTranscriptEntryId, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, countKnowledgeSourceItems, deleteKnowledgeSourceItems, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, pruneBoundedKnowledgeSourceItems, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";

package/dist/src/storage/sqlite/session-creation-repository.js

@@ -2,10 +2,10 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { sessionCommandIdentity } from "../../../packages/gateway-contract/src/session-input-command.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_input_repository, insertSessionInput } from "./session-input-repository.js";
-import { supersedeActiveClarification } from "./clarification-wait-repository.js";
 import { cancelConnectionObjective, init_connection_wait_repository } from "./connection-wait-repository.js";
 import { getSessionMetadata } from "./session-read-repository.js";
 import { init_session_repository } from "./session-repository.js";
+import { supersedeActiveClarification } from "./clarification-wait-repository.js";
 import { setSessionConfig } from "./config-repository.js";
 import { createConversation, init_conversation_repository } from "./conversation-repository.js";
 import { createHash, randomUUID } from "node:crypto";

package/dist/src/storage/sqlite/session-repository.js

@@ -3,10 +3,10 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { validateConversationId, validateTranscriptId } from "../../../packages/gateway-contract/src/conversation-identity.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "./session-instance-repository.js";
-import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { buildDefaultSessionMetadata, init_session_metadata } from "./session-metadata.js";
 import { init_timestamps, optionalTimestampToMs } from "./timestamps.js";
 import { buildGlobalSessionStats, init_row_mappers, metadataToSessionInsert, sessionRowToMetadata } from "./row-mappers.js";
+import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { cancelConnectionObjective, init_connection_wait_repository } from "./connection-wait-repository.js";
 import { init_changes, notifyUserContextChange } from "../../user-context/changes.js";
 import { SESSION_PURPOSE_SQL, SESSION_SOURCE_SQL, init_session_identity_sql } from "./session-identity-sql.js";

package/dist/src/tasks/capabilities/read.js

@@ -2,10 +2,10 @@ import { ProductReadContracts } from "../../../packages/gateway-contract/src/cap
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { TaskRepository, init_task_repository } from "../task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../task-run-repository.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
 import { TaskReadModelProjector } from "../task-read-model-projector.js";
 import { TaskConversationRepository } from "../task-conversation-repository.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
+import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
 import { TaskContextRepository } from "../task-context-repository.js";
 import { TaskDependencyService } from "../task-dependency-service.js";
 import { TaskCriterionReviewRepository } from "../task-criterion-review-repository.js";

package/dist/src/tasks/capabilities/write.js

@@ -2,9 +2,9 @@ import { TaskCommandRequestSchema, TaskCreateRequestSchema, TaskDetailResponseSc
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { TaskRepository, init_task_repository } from "../task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../task-run-repository.js";
+import { resolveTaskLocale } from "../task-language.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
-import { resolveTaskLocale } from "../task-language.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import { resolveResponseLanguageForSession } from "../../agent/prompt/response-language.js";
 import { TaskApplicationService } from "../task-application-service.js";

package/dist/src/tasks/home-query-service.js

@@ -1,7 +1,7 @@
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { isHomeAttentionAcknowledged } from "../storage/sqlite/home-attention-repository.js";
 import { listConnectorApprovals } from "../storage/sqlite/connector-repository.js";
+import { isHomeAttentionAcknowledged } from "../storage/sqlite/home-attention-repository.js";
 import "../storage/sqlite/index.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import "../automations/domain/defaults.js";

package/dist/src/tasks/task-allocation-repository.js

@@ -1,6 +1,6 @@
 import { afterSqliteCommit, getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { enqueueTaskChangedEvent, init_task_change_events } from "./task-change-events.js";
 import { init_task_allocation_status, isRoutineTaskAllocationStatus } from "../session/task-allocation-status.js";
+import { enqueueTaskChangedEvent, init_task_change_events } from "./task-change-events.js";
 import { appendTranscriptEntry } from "../storage/sqlite/transcript-repository.js";
 import { emitSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { resolveTaskLocale } from "./task-language.js";

package/dist/src/tui/backends/embedded-backend.js

@@ -5,12 +5,11 @@ import { openXopcDatabase } from "../../storage/sqlite/connection.js";
 import { canonicalSessionCommand, sessionInputCommandSchema } from "../../../packages/gateway-contract/src/session-input-command.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { cancelQueuedSessionInput, claimNextSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, init_session_input_repository, setSessionInputStatus } from "../../storage/sqlite/session-input-repository.js";
-import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
+import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import "../../storage/sqlite/index.js";
 import { normalizeAgentId } from "../../agent-catalog/id.js";
 import { init_agent_scope, listAgentEntries } from "../../agent/agent-scope.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { init_paths } from "../../config/paths.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { resolveEffectiveAgentProfile } from "../../config/agent-profile.js";
@@ -23,6 +22,7 @@ import { buildSessionTimeline } from "../../session/transcript-outline.js";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
 import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
 import { evictEmbeddedSessionRunner } from "../../agent/embedded/session-runner.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { SessionIndex } from "../../session/manager.js";
 import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";

package/dist/src/voice/realtime/persona-context.js

@@ -1,6 +1,6 @@
 import { init_agent_scope, resolveAgentProfileDir } from "../../agent/agent-scope.js";
-import { DEFAULT_SOUL_FILENAME } from "../../agent/context/workspace.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { DEFAULT_SOUL_FILENAME } from "../../agent/context/workspace.js";
 import { loadProfileBootstrapFiles } from "../../agent/bootstrap/load-bootstrap-files.js";
 import { join } from "node:path";
 import { statSync } from "node:fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.423",
+  "version": "0.0.424",
   "description": "Local-first personal AI with Ada, task delegation, files, projects and automations. Use cloud or local models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -230,6 +230,7 @@
     "test:plugins:store:e2e": "cross-env XOPC_LOG_LEVEL=fatal tsx scripts/verify-store-plugin-e2e.mts",
     "test:plugins:fixtures": "tsx scripts/build-store-plugin-lab.mts",
     "test:plugins:browser": "cross-env XOPC_LOG_LEVEL=fatal tsx scripts/verify-plugin-setup-browser.mts",
+    "test:web:clarification:e2e": "pnpm run build:node && pnpm run build:web && tsx scripts/verify-clarification-browser.mts",
     "test:web:onboarding-visual": "node scripts/test-onboarding-visual.mjs",
     "test:web:onboarding-visual:update": "node scripts/test-onboarding-visual.mjs --update",
     "test:quick-understanding": "XOPC_LOG_LEVEL=fatal vitest run src/work-discovery/__tests__/evaluation.test.ts src/user-context/sources/__tests__/activity-clustering.test.ts src/knowledge/__tests__/quick-understanding.e2e.test.ts src/connectors/__tests__/content-enrichment.test.ts src/connectors/__tests__/connected-source-ingestion.test.ts",