@xopcai/xopc 0.0.303 → 0.0.307

package/dist/src/tui/xopc-tui-keybindings.d.ts

@@ -1,5 +1,5 @@
 /** App-level bindings wired by xopc TUI (subset of pi coding-agent). */
-export type XopcTuiAppKeybinding = 'app.interrupt' | 'app.clear' | 'app.exit' | 'app.suspend' | 'app.thinking.cycle' | 'app.model.cycleForward' | 'app.model.cycleBackward' | 'app.model.select' | 'app.tools.expand' | 'app.thinking.toggle' | 'app.session.resume' | 'app.session.tree' | 'app.session.fork' | 'app.session.togglePath' | 'app.session.toggleSort' | 'app.session.toggleNamedFilter' | 'app.session.rename' | 'app.session.delete' | 'app.session.deleteNoninvasive' | 'app.tree.foldOrUp' | 'app.tree.unfoldOrDown' | 'app.tree.filter.default' | 'app.tree.filter.noTools' | 'app.tree.filter.userOnly' | 'app.tree.filter.labeledOnly' | 'app.tree.filter.all' | 'app.tree.filter.cycleForward' | 'app.tree.filter.cycleBackward' | 'app.tree.editLabel' | 'app.tree.toggleLabelTimestamp' | 'app.editor.external' | 'app.clipboard.pasteImage' | 'app.message.followUp' | 'app.models.save' | 'app.models.enableAll' | 'app.models.clearAll' | 'app.models.toggleProvider' | 'app.models.reorderUp' | 'app.models.reorderDown';
+export type XopcTuiAppKeybinding = 'app.interrupt' | 'app.clear' | 'app.exit' | 'app.suspend' | 'app.thinking.cycle' | 'app.model.cycleForward' | 'app.model.cycleBackward' | 'app.model.select' | 'app.tools.expand' | 'app.thinking.toggle' | 'app.transcript.open' | 'app.transcript.raw' | 'app.session.resume' | 'app.session.tree' | 'app.session.fork' | 'app.session.togglePath' | 'app.session.toggleSort' | 'app.session.toggleNamedFilter' | 'app.session.rename' | 'app.session.delete' | 'app.session.deleteNoninvasive' | 'app.tree.foldOrUp' | 'app.tree.unfoldOrDown' | 'app.tree.filter.default' | 'app.tree.filter.noTools' | 'app.tree.filter.userOnly' | 'app.tree.filter.labeledOnly' | 'app.tree.filter.all' | 'app.tree.filter.cycleForward' | 'app.tree.filter.cycleBackward' | 'app.tree.editLabel' | 'app.tree.toggleLabelTimestamp' | 'app.editor.external' | 'app.clipboard.pasteImage' | 'app.message.followUp' | 'app.message.editQueued' | 'app.message.deleteQueued' | 'app.models.save' | 'app.models.enableAll' | 'app.models.clearAll' | 'app.models.toggleProvider' | 'app.models.reorderUp' | 'app.models.reorderDown';
 declare module '@earendil-works/pi-tui' {
     interface Keybindings {
         'app.interrupt': true;
@@ -12,6 +12,8 @@ declare module '@earendil-works/pi-tui' {
         'app.model.select': true;
         'app.tools.expand': true;
         'app.thinking.toggle': true;
+        'app.transcript.open': true;
+        'app.transcript.raw': true;
         'app.session.resume': true;
         'app.session.tree': true;
         'app.session.fork': true;
@@ -35,6 +37,8 @@ declare module '@earendil-works/pi-tui' {
         'app.editor.external': true;
         'app.clipboard.pasteImage': true;
         'app.message.followUp': true;
+        'app.message.editQueued': true;
+        'app.message.deleteQueued': true;
         'app.models.save': true;
         'app.models.enableAll': true;
         'app.models.clearAll': true;
@@ -81,9 +85,17 @@ export declare const XOPC_TUI_KEYBINDINGS: {
         readonly description: "Toggle tool output";
     };
     readonly 'app.thinking.toggle': {
-        readonly defaultKeys: "ctrl+t";
+        readonly defaultKeys: [];
         readonly description: "Toggle thinking block display";
     };
+    readonly 'app.transcript.open': {
+        readonly defaultKeys: "ctrl+t";
+        readonly description: "Open transcript view";
+    };
+    readonly 'app.transcript.raw': {
+        readonly defaultKeys: "alt+r";
+        readonly description: "Open raw transcript view";
+    };
     readonly 'app.session.resume': {
         readonly defaultKeys: "ctrl+shift+p";
         readonly description: "Session picker";
@@ -173,9 +185,17 @@ export declare const XOPC_TUI_KEYBINDINGS: {
         readonly description: "Paste image from clipboard";
     };
     readonly 'app.message.followUp': {
-        readonly defaultKeys: "alt+enter";
+        readonly defaultKeys: "tab";
         readonly description: "Queue message while busy (or submit when idle)";
     };
+    readonly 'app.message.editQueued': {
+        readonly defaultKeys: "up";
+        readonly description: "Edit the last queued message when the composer is empty";
+    };
+    readonly 'app.message.deleteQueued': {
+        readonly defaultKeys: "ctrl+x";
+        readonly description: "Delete the last queued message";
+    };
     readonly 'app.models.save': {
         readonly defaultKeys: "ctrl+s";
         readonly description: "Save scoped model selection";

package/dist/src/tui/xopc-tui-keybindings.js

@@ -39,9 +39,17 @@ const XOPC_TUI_KEYBINDINGS = {
 		description: "Toggle tool output"
 	},
 	"app.thinking.toggle": {
-		defaultKeys: "ctrl+t",
+		defaultKeys: [],
 		description: "Toggle thinking block display"
 	},
+	"app.transcript.open": {
+		defaultKeys: "ctrl+t",
+		description: "Open transcript view"
+	},
+	"app.transcript.raw": {
+		defaultKeys: "alt+r",
+		description: "Open raw transcript view"
+	},
 	"app.session.resume": {
 		defaultKeys: "ctrl+shift+p",
 		description: "Session picker"
@@ -131,9 +139,17 @@ const XOPC_TUI_KEYBINDINGS = {
 		description: "Paste image from clipboard"
 	},
 	"app.message.followUp": {
-		defaultKeys: "alt+enter",
+		defaultKeys: "tab",
 		description: "Queue message while busy (or submit when idle)"
 	},
+	"app.message.editQueued": {
+		defaultKeys: "up",
+		description: "Edit the last queued message when the composer is empty"
+	},
+	"app.message.deleteQueued": {
+		defaultKeys: "ctrl+x",
+		description: "Delete the last queued message"
+	},
 	"app.models.save": {
 		defaultKeys: "ctrl+s",
 		description: "Save scoped model selection"
@@ -191,9 +207,13 @@ const XOPC_TUI_HOTKEY_ORDER = [
 	"app.tree.toggleLabelTimestamp",
 	"app.tools.expand",
 	"app.thinking.toggle",
+	"app.transcript.open",
+	"app.transcript.raw",
 	"app.editor.external",
 	"app.clipboard.pasteImage",
 	"app.message.followUp",
+	"app.message.editQueued",
+	"app.message.deleteQueued",
 	"app.models.save",
 	"app.models.enableAll",
 	"app.models.clearAll",

package/dist/src/user-context/access-policy.d.ts

@@ -1,11 +1,11 @@
 import type { Config } from '../config/schema.js';
-import type { KnowledgeSource } from '../knowledge-memory/index.js';
+import type { KnowledgeReadPolicy } from '../knowledge-memory/index.js';
 export interface UserContextSessionAccess {
     enabled: boolean;
     userModel: boolean;
     knowledge: boolean;
     crossSessionHistory: boolean;
-    knowledgeSources: readonly KnowledgeSource[];
+    knowledgePolicy: KnowledgeReadPolicy;
 }
 /** One policy boundary for every shared-context read and write path. */
 export declare function resolveUserContextSessionAccess(config: Config | undefined, conversationId: string | undefined): UserContextSessionAccess;

package/dist/src/user-context/access-policy.js

@@ -1,7 +1,9 @@
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
+import { init_config, resolveKnowledgeReadPolicy } from "./config.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { init_session_key } from "../routing/session-key.js";
 //#region src/user-context/access-policy.ts
+init_config();
 init_session_key();
 /** One policy boundary for every shared-context read and write path. */
 function resolveUserContextSessionAccess(config, conversationId) {
@@ -10,7 +12,10 @@ function resolveUserContextSessionAccess(config, conversationId) {
 		userModel: false,
 		knowledge: false,
 		crossSessionHistory: false,
-		knowledgeSources: []
+		knowledgePolicy: {
+			scopes: [],
+			contentSources: []
+		}
 	};
 	const session = getConversationRouting(conversationId);
 	const mode = getSessionConfig(conversationId)?.userContextMode ?? "enabled";
@@ -20,7 +25,10 @@ function resolveUserContextSessionAccess(config, conversationId) {
 		userModel: enabled && config.userContext.userModel.enabled,
 		knowledge: enabled && config.userContext.knowledgeMemory.enabled,
 		crossSessionHistory: enabled,
-		knowledgeSources: enabled && config.userContext.knowledgeMemory.enabled ? config.userContext.knowledgeMemory.sources : []
+		knowledgePolicy: enabled && config.userContext.knowledgeMemory.enabled ? resolveKnowledgeReadPolicy(config.userContext.knowledgeMemory) : {
+			scopes: [],
+			contentSources: []
+		}
 	};
 }
 //#endregion

package/dist/src/user-context/config.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { KnowledgeReadPolicy } from '../knowledge-memory/domain.js';
 export declare const DEFAULT_CONTEXT_COMPACTION_POLICY: {
     enabled: boolean;
     triggerThreshold: number;
@@ -75,18 +76,25 @@ export declare const UserModelConfigSchema: z.ZodDefault<z.ZodObject<{
         staleRetentionDays: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>>;
-export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
+export declare function normalizeKnowledgeMemoryConfigInput(input: unknown): unknown;
+export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodPreprocess<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     writePolicy: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
         confirm: "confirm";
         deny: "deny";
     }>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    readScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         project: "project";
         session: "session";
+        agent: "agent";
         workspace: "workspace";
+        global: "global";
+    }>>>;
+    contentSources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        memory: "memory";
         connector: "connector";
+        local_import: "local_import";
     }>>>;
     searchStrategy: z.ZodDefault<z.ZodEnum<{
         "local-first": "local-first";
@@ -95,6 +103,7 @@ export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
         "local-only": "local-only";
         "external-only": "external-only";
     }>>;
+    searchTimeoutMs: z.ZodDefault<z.ZodNumber>;
     writeStrategy: z.ZodDefault<z.ZodEnum<{
         "local-first": "local-first";
         "external-first": "external-first";
@@ -105,7 +114,7 @@ export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
     allowExternalWrites: z.ZodDefault<z.ZodBoolean>;
     allowedProviderIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     autoWriteKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strict>>;
+}, z.core.$strict>>>;
 export declare const ContextPlanningConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     maxAssertions: z.ZodDefault<z.ZodNumber>;
@@ -180,18 +189,24 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
             staleRetentionDays: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    knowledgeMemory: z.ZodDefault<z.ZodObject<{
+    knowledgeMemory: z.ZodDefault<z.ZodPreprocess<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         writePolicy: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
             confirm: "confirm";
             deny: "deny";
         }>>;
-        sources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        readScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             project: "project";
             session: "session";
+            agent: "agent";
             workspace: "workspace";
+            global: "global";
+        }>>>;
+        contentSources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            memory: "memory";
             connector: "connector";
+            local_import: "local_import";
         }>>>;
         searchStrategy: z.ZodDefault<z.ZodEnum<{
             "local-first": "local-first";
@@ -200,6 +215,7 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
             "local-only": "local-only";
             "external-only": "external-only";
         }>>;
+        searchTimeoutMs: z.ZodDefault<z.ZodNumber>;
         writeStrategy: z.ZodDefault<z.ZodEnum<{
             "local-first": "local-first";
             "external-first": "external-first";
@@ -210,7 +226,7 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
         allowExternalWrites: z.ZodDefault<z.ZodBoolean>;
         allowedProviderIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         autoWriteKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     contextPlanning: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxAssertions: z.ZodDefault<z.ZodNumber>;
@@ -240,3 +256,4 @@ export type UserContextConfig = z.infer<typeof UserContextConfigSchema>;
 export type UserModelConfig = z.infer<typeof UserModelConfigSchema>;
 export type KnowledgeMemoryConfig = z.infer<typeof KnowledgeMemoryConfigSchema>;
 export type ContextPlanningConfig = z.infer<typeof ContextPlanningConfigSchema>;
+export declare function resolveKnowledgeReadPolicy(config: KnowledgeMemoryConfig): KnowledgeReadPolicy;

package/dist/src/user-context/config.js

@@ -10,6 +10,32 @@ function isValidTimeZone(value) {
 		return false;
 	}
 }
+function normalizeKnowledgeMemoryConfigInput(input) {
+	if (!input || typeof input !== "object" || Array.isArray(input)) return input;
+	const memory = input;
+	if (!Array.isArray(memory.sources)) return input;
+	const oldSources = memory.sources.filter((source) => typeof source === "string");
+	const visibilityScopes = new Set([
+		"session",
+		"workspace",
+		"project"
+	]);
+	const normalized = { ...memory };
+	if (!Array.isArray(normalized.readScopes)) normalized.readScopes = oldSources.filter((source) => visibilityScopes.has(source));
+	if (!Array.isArray(normalized.contentSources)) normalized.contentSources = [
+		...oldSources.some((source) => visibilityScopes.has(source)) ? ["memory"] : [],
+		...oldSources.includes("workspace") ? ["local_import"] : [],
+		...oldSources.includes("connector") ? ["connector"] : []
+	];
+	delete normalized.sources;
+	return normalized;
+}
+function resolveKnowledgeReadPolicy(config) {
+	return {
+		scopes: config.readScopes,
+		contentSources: config.contentSources
+	};
+}
 var DEFAULT_CONTEXT_COMPACTION_POLICY, ContextCompactionPolicySchema, WritePolicySchema, MaintenanceTimeSchema, UserModelConfigSchema, KnowledgeMemoryConfigSchema, ContextPlanningConfigSchema, UserContextConfigSchema;
 var init_config = __esmMin((() => {
 	init_response_language();
@@ -117,15 +143,27 @@ var init_config = __esmMin((() => {
 			staleRetentionDays: 30
 		}
 	});
-	KnowledgeMemoryConfigSchema = z.object({
+	KnowledgeMemoryConfigSchema = z.preprocess(normalizeKnowledgeMemoryConfigInput, z.object({
 		enabled: z.boolean().default(true),
 		writePolicy: WritePolicySchema.default("confirm"),
-		sources: z.array(z.enum([
-			"session",
+		readScopes: z.array(z.enum([
+			"global",
+			"agent",
 			"workspace",
 			"project",
+			"session"
+		])).default([
+			"global",
+			"agent",
+			"workspace",
+			"project",
+			"session"
+		]),
+		contentSources: z.array(z.enum([
+			"memory",
+			"local_import",
 			"connector"
-		])).default(["session", "workspace"]),
+		])).default(["memory", "local_import"]),
 		searchStrategy: z.enum([
 			"local-first",
 			"external-first",
@@ -133,6 +171,7 @@ var init_config = __esmMin((() => {
 			"local-only",
 			"external-only"
 		]).default("fanout"),
+		searchTimeoutMs: z.number().int().min(100).max(3e4).default(2e3),
 		writeStrategy: z.enum([
 			"local-first",
 			"external-first",
@@ -143,11 +182,19 @@ var init_config = __esmMin((() => {
 		allowExternalWrites: z.boolean().default(false),
 		allowedProviderIds: z.array(z.string().min(1)).optional(),
 		autoWriteKinds: z.array(z.string().min(1)).optional()
-	}).strict().default({
+	}).strict()).default({
 		enabled: true,
 		writePolicy: "confirm",
-		sources: ["session", "workspace"],
+		readScopes: [
+			"global",
+			"agent",
+			"workspace",
+			"project",
+			"session"
+		],
+		contentSources: ["memory", "local_import"],
 		searchStrategy: "fanout",
+		searchTimeoutMs: 2e3,
 		writeStrategy: "local-first",
 		allowExternalWrites: false
 	});
@@ -180,4 +227,4 @@ var init_config = __esmMin((() => {
 }));
 //#endregion
 init_config();
-export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config };
+export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config, normalizeKnowledgeMemoryConfigInput, resolveKnowledgeReadPolicy };

package/dist/src/voice/platform-streams.js

@@ -46,6 +46,12 @@ function connect(url, token, signal, onEvent, onFailure) {
 		socket,
 		close,
 		fail,
+		pause: () => {
+			if (!ended && socket.readyState === WebSocket.OPEN) socket.pause();
+		},
+		resume: () => {
+			if (!ended && socket.readyState === WebSocket.OPEN) socket.resume();
+		},
 		send: (value) => {
 			if (ended || socket.readyState !== WebSocket.OPEN) throw new Error("Platform voice is not connected");
 			if (socket.bufferedAmount > MAX_BUFFERED_BYTES) throw new Error("Platform voice backpressure limit exceeded");
@@ -180,6 +186,9 @@ async function openPlatformTts(request) {
 		start(value) {
 			controller = value;
 		},
+		pull(value) {
+			if ((value.desiredSize ?? 0) > 0) connection.resume();
+		},
 		cancel() {
 			ended = true;
 			clearTimeout(timer);
@@ -206,8 +215,9 @@ async function openPlatformTts(request) {
 		} else if (event.type === "response.audio.delta") {
 			if (!ready || typeof event.delta !== "string" || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(event.delta)) throw new Error("Invalid platform audio");
 			const bytes = Buffer.from(event.delta, "base64");
-			if (bytes.length % 2 || (controller.desiredSize ?? 0) < bytes.length) throw new Error("Platform TTS audio buffer exceeded");
+			if (bytes.length % 2 || bytes.length > MAX_BUFFERED_BYTES) throw new Error("Invalid platform audio");
 			controller.enqueue(bytes);
+			if ((controller.desiredSize ?? 0) <= 0) connection.pause();
 		} else if (event.type === "session.finished") {
 			ended = true;
 			clearTimeout(timer);

package/dist/src/voice/realtime/omniEngine.js

@@ -11,10 +11,12 @@ const log = createLogger("Voice:Omni");
 const MAX_QUEUED_AUDIO_BYTES = 24e3 * 2 * 60;
 const MAX_PENDING_INPUT_BYTES = 64 * 1024;
 const UPLOAD_TIMEOUT_MS = 1e4;
+const RESPONSE_START_TIMEOUT_MS = 3e4;
 const FAILURE_MESSAGES = {
 	OMNI_UPLOAD_TIMEOUT: "The connection to the voice service stopped uploading audio. Check the network to your configured endpoint and reconnect.",
 	OMNI_INPUT_RESET_TIMEOUT: "The voice service did not acknowledge clearing microphone input. Reconnect to continue.",
 	OMNI_START_TIMEOUT: "The voice service did not become ready in time.",
+	OMNI_RESPONSE_START_TIMEOUT: "Your speech was transcribed, but the voice model did not start a reply within 30 seconds. Reconnect or select another realtime voice model.",
 	OMNI_CONNECTION_FAILED: "Could not connect to the voice service. Check network and service availability.",
 	OMNI_CONNECTION_REJECTED: "The voice service rejected the connection. Check account access, quota and route configuration.",
 	OMNI_CONNECTION_CLOSED: "The voice service closed the connection.",
@@ -50,6 +52,7 @@ function createOmniVoiceEngine(options) {
 	let uploadingBytes = 0;
 	let uploadTimer;
 	let turnSettled = false;
+	let responseStartTimer;
 	const speaking = /* @__PURE__ */ new Set();
 	const turn = new TurnCoordinator(options.silenceDurationMs, (_text, decision, turnId) => {
 		if (closed || failed || muted || inputBlocked) return;
@@ -63,6 +66,10 @@ function createOmniVoiceEngine(options) {
 		options.send("turn.committed", { turnId });
 		turnSettled = true;
 		if (active) publish(active);
+		else {
+			clearTimeout(responseStartTimer);
+			responseStartTimer = setTimeout(() => fail("OMNI_RESPONSE_START_TIMEOUT"), RESPONSE_START_TIMEOUT_MS);
+		}
 	});
 	function publish(response) {
 		if (response.published || active !== response) return;
@@ -207,6 +214,7 @@ function createOmniVoiceEngine(options) {
 	function fail(code, details = {}) {
 		if (closed || failed) return;
 		failed = true;
+		clearTimeout(responseStartTimer);
 		turn.reset();
 		log.warn({
 			sessionId: options.callId,
@@ -230,6 +238,7 @@ function createOmniVoiceEngine(options) {
 		options.onClose("omni_error", true);
 	}
 	function discardInput() {
+		clearTimeout(responseStartTimer);
 		turn.reset();
 		speaking.clear();
 		turnSettled = false;
@@ -327,6 +336,7 @@ function createOmniVoiceEngine(options) {
 							if (recorded.has(String(event.item_id)) || pendingInputs.has(String(event.item_id))) return;
 							inputBlocked = false;
 							pendingInputs.add(String(event.item_id));
+							clearTimeout(responseStartTimer);
 							turnSettled = false;
 							speaking.add(String(event.item_id));
 							turn.start(String(event.item_id));
@@ -366,7 +376,8 @@ function createOmniVoiceEngine(options) {
 								recoverable: true
 							});
 						} else if (event.type === "response.created") {
-							if (muted || inputBlocked || speaking.size > 0) {
+							clearTimeout(responseStartTimer);
+							if (muted || inputBlocked) {
 								cancellationPending = true;
 								send("response.cancel");
 								return;
@@ -513,6 +524,7 @@ function createOmniVoiceEngine(options) {
 			clearTimeout(timer);
 			clearTimeout(clearTimer);
 			clearTimeout(uploadTimer);
+			clearTimeout(responseStartTimer);
 			turn.reset();
 			speaking.clear();
 			inputQueue = [];

package/dist/src/voice/realtime/runtime.js

@@ -397,7 +397,6 @@ var VoiceRealtimeRuntime = class {
 			unsubscribeSession?.();
 			clearTimeout(startTimer);
 			clearInterval(lifecycleTimer);
-			abortController.abort(reason);
 			try {
 				await engine?.close();
 			} catch (err) {
@@ -405,6 +404,8 @@ var VoiceRealtimeRuntime = class {
 					err,
 					sessionId: claim?.sessionId
 				}, "Voice cleanup failed");
+			} finally {
+				abortController.abort(reason);
 			}
 			if (notify) send("session.closed", { reason });
 			detachPrincipal();

package/dist/src/voice/tts/audio.js

@@ -2,8 +2,8 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { join } from "path";
 import { unlink, writeFile } from "fs/promises";
-import { spawn } from "child_process";
 import { tmpdir } from "os";
+import { spawn } from "child_process";
 //#region src/voice/tts/audio.ts
 /**
 * Audio Compression Utilities

package/dist/src/voice/tts/speech-registry.js

@@ -20,6 +20,7 @@ function indexProvider(provider) {
 */
 function registerSpeechProvider(provider) {
 	const keys = indexProvider(provider);
+	const previous = new Map(keys.map((key) => [key, registry.get(key)]));
 	const conflicts = [];
 	for (const key of keys) if (registry.has(key)) conflicts.push(key);
 	if (conflicts.length > 0) log.warn({
@@ -28,7 +29,11 @@ function registerSpeechProvider(provider) {
 	}, `Speech provider "${provider.id}" overrides existing registration(s): ${conflicts.join(", ")}`);
 	for (const key of keys) registry.set(key, provider);
 	return () => {
-		for (const key of keys) if (registry.get(key) === provider) registry.delete(key);
+		for (const key of keys) if (registry.get(key) === provider) {
+			const prior = previous.get(key);
+			if (prior) registry.set(key, prior);
+			else registry.delete(key);
+		}
 	};
 }
 /**

package/dist/src/workflows/domain/definition.d.ts

@@ -110,6 +110,7 @@ export interface WorkflowDefinitionManifest {
 }
 export interface WorkflowConnectorRequirement {
     connectorId: string;
+    accountIds?: string[];
     scope?: 'read' | 'write' | 'admin';
     connectionRequired?: boolean;
     optional?: boolean;

package/dist/src/workflows/domain/validation.js

@@ -121,7 +121,7 @@ function validateManifest(value, errors) {
 			field: "manifest.resources"
 		});
 	}
-	if (value.connectors !== void 0 && (!Array.isArray(value.connectors) || value.connectors.some((connector) => !isRecord(connector) || typeof connector.connectorId !== "string" || connector.scope !== void 0 && ![
+	if (value.connectors !== void 0 && (!Array.isArray(value.connectors) || value.connectors.some((connector) => !isRecord(connector) || typeof connector.connectorId !== "string" || connector.accountIds !== void 0 && (!Array.isArray(connector.accountIds) || connector.accountIds.length === 0 || connector.accountIds.some((id) => typeof id !== "string" || !id.trim()) || new Set(connector.accountIds).size !== connector.accountIds.length) || connector.scope !== void 0 && ![
 		"read",
 		"write",
 		"admin"

package/dist/src/workflows/service/workflow-run-service.js

@@ -195,6 +195,7 @@ var WorkflowRunService = class {
 			agentId: params.agentId,
 			definitionId: params.definitionId,
 			definitionTitle: definition.title,
+			connectorAccounts: connectorPreflight.accounts,
 			triggerSource: params.source.kind,
 			goal,
 			parentConversationId: params.parentConversationId,
@@ -386,8 +387,21 @@ var WorkflowRunService = class {
 				httpStatus: 400
 			};
 		}
+		const replayConnectors = preflightWorkflowConnectors({
+			definition,
+			config: this.options.service.currentConfig,
+			agentId: params.agentId
+		});
+		if (!replayConnectors.ok) return {
+			ok: false,
+			code: "connector_preflight_failed",
+			message: replayConnectors.issues.map((issue) => issue.message).join(" "),
+			httpStatus: 409,
+			details: replayConnectors
+		};
 		const { conversationId } = await this.options.sessionBridge.prepareRunSession({
 			runId: replayRunId,
+			connectorAccounts: replayConnectors.accounts,
 			agentId: params.agentId,
 			definitionId: existing.run.definitionId,
 			definitionTitle: `${definition.title} replay`,

package/dist/src/workflows/service/workflow-session-bridge.d.ts

@@ -11,6 +11,7 @@ export interface PrepareWorkflowRunSessionParams {
     parentConversationId?: string;
     projectId?: string;
     triggerSource?: string;
+    connectorAccounts?: Record<string, string[]>;
 }
 export interface PrepareWorkflowRunSessionResult {
     conversationId: string;

package/dist/src/workflows/service/workflow-session-bridge.js

@@ -48,6 +48,7 @@ var WorkflowSessionBridge = class {
 				workflowRunId: params.runId,
 				workflowDefinitionId: params.definitionId,
 				workflowGoal: params.goal,
+				connectorAccounts: params.connectorAccounts ?? {},
 				deferVisibilityUntilOutput: true,
 				...params.triggerSource ? { triggerSource: params.triggerSource } : {},
 				...params.parentConversationId ? { parentConversationId: params.parentConversationId } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.303",
+  "version": "0.0.307",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -78,7 +78,7 @@
     "@sinclair/typebox": "^0.34.49",
     "@vscode/ripgrep": "^1.18.0",
     "abort-controller": "^3.0.0",
-    "adm-zip": "^0.6.0",
+    "adm-zip": "^0.6.1",
     "ajv": "^8.20.0",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
@@ -166,8 +166,8 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/browser-control-contract": "0.1.0",
+    "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
@@ -206,6 +206,8 @@
     "dev:gateway": "sh -c 'mkdir -p \"$HOME/.xopc-dev\" && XOPC_STATE_DIR=\"$HOME/.xopc-dev\" XOPC_CONFIG_PATH=\"$HOME/.xopc-dev/xopc.json\" XOPC_CONFIG=\"$HOME/.xopc-dev/xopc.json\" XOPC_LOG_DIR=\"$HOME/.xopc-dev/logs\" XOPC_LOG_LEVEL=info tsx src/cli/bin.ts gateway \"$@\"' --",
     "start": "node dist/src/cli/bin.js",
     "test": "vitest run src extensions/telegram/src extensions/feishu/src extensions/weixin/src",
+    "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",
     "test:skills": "vitest run src/agent/skills/__tests__",
     "test:skills:regression": "./scripts/test-skills.sh",