@xopcai/xopc 0.0.375 → 0.0.376

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

@@ -1,8 +1,8 @@
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
 import { getAvailableModels, init_providers } from "../providers/index.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_repository();

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/infra/update-restart.d.ts

@@ -1,10 +1,12 @@
 /**
  * Gateway restart after xopc update — daemon, unmanaged, or in-process respawn.
  */
+import type { GatewayService } from '../daemon/types.js';
 export type UpdateRestartResult = {
     ok: boolean;
     mode: 'in-process' | 'daemon' | 'unmanaged' | 'skipped' | 'disabled' | 'failed';
     message?: string;
+    warning?: string;
 };
 export type InProcessRestartTrigger = () => {
     ok: boolean;
@@ -12,10 +14,13 @@ export type InProcessRestartTrigger = () => {
     message?: string;
 };
 export declare function isRunningInsideGatewayService(env?: Record<string, string | undefined>): boolean;
+/** Load platform modules before the installer replaces files used by this process. */
+export declare function prepareGatewayRestart(shouldRestart?: boolean): Promise<GatewayService | undefined>;
 export declare function maybeRestartGatewayAfterUpdate(params: {
     shouldRestart?: boolean;
     expectedVersion?: string;
     updatedPackageRoot?: string;
     configPath?: string;
     triggerInProcessRestart?: InProcessRestartTrigger;
+    preparedService?: GatewayService;
 }): Promise<UpdateRestartResult>;

package/dist/src/infra/update-restart.js

@@ -19,6 +19,11 @@ const DEFAULT_HEALTH_DELAY_MS = 500;
 function isRunningInsideGatewayService(env = process.env) {
 	return env.XOPC_SERVICE_MARKER?.trim() === "1";
 }
+/** Load platform modules before the installer replaces files used by this process. */
+async function prepareGatewayRestart(shouldRestart) {
+	if (shouldRestart === false || !isRestartEnabled(loadConfig(resolveConfigPath()))) return;
+	return resolveGatewayService();
+}
 function resolveGatewayPort(configPath) {
 	const config = loadConfig(configPath ?? resolveConfigPath());
 	return typeof config.gateway?.port === "number" ? config.gateway.port : 18790;
@@ -42,27 +47,31 @@ async function resolveRestartPort(service) {
 	return parsePortFromArgs((await service.readCommand(process.env).catch(() => null))?.programArguments) ?? resolveGatewayPort();
 }
 async function waitForGatewayHealth(port, expectedVersion) {
-	for (let attempt = 0; attempt < DEFAULT_HEALTH_ATTEMPTS; attempt += 1) try {
+	const config = loadConfig(resolveConfigPath());
+	const credential = process.env.XOPC_GATEWAY_TOKEN || process.env.XOPC_GATEWAY_PASSWORD || config.gateway?.auth?.token || config.gateway?.auth?.password;
+	for (let attempt = 0; attempt < DEFAULT_HEALTH_ATTEMPTS; attempt += 1) {
 		const controller = new AbortController();
 		const timeout = setTimeout(() => controller.abort(), 1500);
-		const response = await fetch(`http://127.0.0.1:${port}/api/health`, {
-			method: "GET",
-			signal: controller.signal
-		});
-		clearTimeout(timeout);
-		if (!response.ok) {
-			await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));
-			continue;
-		}
-		if (expectedVersion) {
-			const body = await response.json();
-			if (body.version && body.version !== expectedVersion) {
-				await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));
-				continue;
+		try {
+			const response = await fetch(`http://127.0.0.1:${port}/api/health`, {
+				method: "GET",
+				signal: controller.signal
+			});
+			if (!response.ok) throw new Error("Gateway health unavailable");
+			const health = await response.json();
+			if (health.ready !== true || health.status !== "ok") throw new Error("Gateway is still starting");
+			if (expectedVersion) {
+				const status = await fetch(`http://127.0.0.1:${port}/api/status`, {
+					headers: credential ? { Authorization: `Bearer ${credential}` } : void 0,
+					signal: controller.signal
+				});
+				if (!status.ok) throw new Error("Gateway version unavailable");
+				if ((await status.json()).version !== expectedVersion) throw new Error("Gateway version mismatch");
 			}
+			return true;
+		} catch {} finally {
+			clearTimeout(timeout);
 		}
-		return true;
-	} catch {
 		await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));
 	}
 	return false;
@@ -111,9 +120,9 @@ async function restartDaemonGateway(service, port, expectedVersion) {
 				expectedVersion
 			}, "Gateway restart completed but health check timed out");
 			return {
-				ok: true,
-				mode: "daemon",
-				message: "Gateway service restarted; health check timed out (gateway may still be starting)."
+				ok: false,
+				mode: "failed",
+				message: "Gateway service restarted, but readiness and installed version could not be verified."
 			};
 		}
 		return {
@@ -145,9 +154,10 @@ async function maybeRestartGatewayAfterUpdate(params) {
 		mode: "disabled",
 		message: "Gateway restart is disabled (commands.restart=false). Restart manually: xopc gateway restart"
 	};
-	if (isRunningInsideGatewayService() && params.triggerInProcessRestart) {
-		if (params.updatedPackageRoot && params.expectedVersion) try {
-			const service = await resolveGatewayService();
+	if (params.triggerInProcessRestart) {
+		let warning;
+		if (isRunningInsideGatewayService() && params.updatedPackageRoot && params.expectedVersion) try {
+			const service = params.preparedService ?? await resolveGatewayService();
 			if (await service.isLoaded({ env: process.env })) await refreshGatewayServiceAfterUpdate({
 				service,
 				packageRoot: params.updatedPackageRoot,
@@ -159,11 +169,7 @@ async function maybeRestartGatewayAfterUpdate(params) {
 				err,
 				expectedVersion: params.expectedVersion
 			}, `Gateway service refresh failed after update: ${message}`);
-			return {
-				ok: false,
-				mode: "failed",
-				message: `Installed ${params.expectedVersion}, but failed to refresh the gateway service: ${message}`
-			};
+			warning = `Installed ${params.expectedVersion}, but failed to refresh the gateway service: ${message}`;
 		}
 		const result = params.triggerInProcessRestart();
 		if (!result.ok) return {
@@ -175,11 +181,12 @@ async function maybeRestartGatewayAfterUpdate(params) {
 		return {
 			ok: true,
 			mode: "in-process",
-			message: result.message ?? "Gateway restart scheduled."
+			message: result.message ?? "Gateway restart scheduled.",
+			warning
 		};
 	}
-	const service = await resolveGatewayService();
+	const service = params.preparedService ?? await resolveGatewayService();
 	return restartDaemonGateway(service, await resolveRestartPort(service), params.expectedVersion);
 }
 //#endregion
-export { isRunningInsideGatewayService, maybeRestartGatewayAfterUpdate };
+export { isRunningInsideGatewayService, maybeRestartGatewayAfterUpdate, prepareGatewayRestart };

package/dist/src/infra/update-runner.d.ts

@@ -14,6 +14,7 @@ export type UpdateStepResult = {
 };
 export type UpdatePostUpdateResult = {
     extensions?: ExtensionPostUpdateResult;
+    extensionsError?: string;
     restart?: UpdateRestartResult;
 };
 export type UpdateRunResult = {

package/dist/src/infra/update-runner.js

@@ -1,3 +1,4 @@
+import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { runPostUpdateExtensionSync } from "../extensions/update.js";
 import "./update-channels.js";
 import { compareSemver, resolveNpmChannelTag } from "./update-check.js";
@@ -7,10 +8,11 @@ import { XOPC_PACKAGE_NAME, cleanupGlobalRenameDirs, createGlobalInstallEnv, det
 import { runGlobalPackageUpdateSteps } from "./package-update-steps.js";
 import { resolveStableNodePath } from "./stable-node-path.js";
 import { trimLogTail } from "./update-log.js";
-import { maybeRestartGatewayAfterUpdate } from "./update-restart.js";
+import { maybeRestartGatewayAfterUpdate, prepareGatewayRestart } from "./update-restart.js";
 import path from "node:path";
 import fs from "node:fs/promises";
 //#region src/infra/update-runner.ts
+init_package_version();
 const DEFAULT_TIMEOUT_MS = 2700 * 1e3;
 const MAX_LOG_CHARS = 8e3;
 const CORE_PACKAGE_NAMES = new Set([XOPC_PACKAGE_NAME]);
@@ -522,30 +524,55 @@ async function runGatewayUpdate(opts = {}) {
 }
 async function runGatewayUpdateWithPostSteps(opts = {}) {
 	const channel = opts.channel ?? "stable";
+	let preparedService;
+	try {
+		preparedService = await prepareGatewayRestart(opts.shouldRestart);
+	} catch (err) {
+		return {
+			status: "error",
+			mode: "unknown",
+			reason: "restart-preparation-failed",
+			steps: [],
+			durationMs: 0,
+			postUpdate: { restart: {
+				ok: false,
+				mode: "failed",
+				message: err instanceof Error ? err.message : String(err)
+			} }
+		};
+	}
 	const result = await runGatewayUpdate(opts);
-	if (result.status !== "ok") return result;
+	const needsRuntimeRestart = result.status === "skipped" && result.reason === "up-to-date" && Boolean(opts.triggerInProcessRestart) && Boolean(result.after?.version) && result.after.version !== PACKAGE_VERSION;
+	if (result.status !== "ok" && !needsRuntimeRestart) return result;
 	const postUpdate = {};
-	if (!opts.skipExtensionSync) {
-		const extensions = await runPostUpdateExtensionSync({
+	if (!opts.skipExtensionSync && !needsRuntimeRestart) try {
+		postUpdate.extensions = await runPostUpdateExtensionSync({
 			channel,
 			timeoutMs: opts.timeoutMs
 		});
-		postUpdate.extensions = extensions;
-		if (extensions.status === "error") return {
-			...result,
-			status: "error",
-			reason: "post-update-extensions",
-			postUpdate
+	} catch (err) {
+		postUpdate.extensionsError = err instanceof Error ? err.message : String(err);
+	}
+	try {
+		postUpdate.restart = await maybeRestartGatewayAfterUpdate({
+			shouldRestart: opts.shouldRestart,
+			expectedVersion: result.after?.version ?? void 0,
+			updatedPackageRoot: result.mode === "npm" || result.mode === "pnpm" ? result.root : void 0,
+			triggerInProcessRestart: opts.triggerInProcessRestart,
+			preparedService
+		});
+	} catch (err) {
+		postUpdate.restart = {
+			ok: false,
+			mode: "failed",
+			message: err instanceof Error ? err.message : String(err)
 		};
 	}
-	postUpdate.restart = await maybeRestartGatewayAfterUpdate({
-		shouldRestart: opts.shouldRestart,
-		expectedVersion: result.after?.version ?? void 0,
-		updatedPackageRoot: result.mode === "npm" || result.mode === "pnpm" ? result.root : void 0,
-		triggerInProcessRestart: opts.triggerInProcessRestart
-	});
+	const reason = !postUpdate.restart.ok ? "post-update-restart" : postUpdate.extensions?.status === "error" || postUpdate.extensionsError ? "post-update-extensions" : void 0;
 	return {
 		...result,
+		status: reason ? "error" : "ok",
+		reason,
 		postUpdate
 	};
 }
@@ -571,8 +598,10 @@ function formatUpdateApiResult(result, channel) {
 		status: "error",
 		reason: result.reason ?? "update-failed",
 		mode: result.mode,
-		message: failed?.stderrTail ?? failed?.stdoutTail ?? result.reason,
-		stderrTail: failed?.stderrTail ?? void 0
+		message: result.postUpdate?.restart?.ok === false ? result.postUpdate.restart.message : result.postUpdate?.extensionsError ?? failed?.stderrTail ?? failed?.stdoutTail ?? result.reason,
+		stderrTail: failed?.stderrTail ?? void 0,
+		installedVersion: result.after?.version ?? void 0,
+		postUpdate: result.postUpdate ?? void 0
 	};
 }
 async function runAutoUpdateCommand(params) {

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

@@ -5,10 +5,10 @@ import { currentOperationId, init_operation_context } from "../infra/operation-c
 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 { LocalAppStore } from "./store.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";

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

@@ -5,8 +5,8 @@ import { PersonalProactiveMessageSchema } from "../../../packages/gateway-contra
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
 import { appendTranscriptEntry, init_transcript_repository } from "../../storage/sqlite/transcript-repository.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";

package/dist/src/personal-agent/prompt-context.js

@@ -2,12 +2,12 @@ import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
-import { isKnowledgeCurrent, knowledgeItemAllowed, listKnowledgeItems } from "../knowledge-memory/repository.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
-import "../knowledge-memory/index.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { isKnowledgeCurrent, knowledgeItemAllowed, listKnowledgeItems } from "../knowledge-memory/repository.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
+import "../knowledge-memory/index.js";
 import { getActiveAssertionForSlot } from "../user-model/repository.js";
 import { getProjectForSession } from "../projects/workspace.js";
 import { canUseAssertion } from "../user-model/usage-policy.js";

package/dist/src/personal-agent/reply-composer.d.ts

@@ -17,6 +17,6 @@ export declare class PersonalReplyComposer {
     private readonly compose;
     private readonly timeoutMs;
     constructor(compose?: typeof completeReply, timeoutMs?: number);
-    drain(notify: (conversationId: string, deliveryId: string) => void, isAvailable?: (conversationId: string) => boolean): Promise<void>;
+    drain(notify: (conversationId: string, deliveryId: string) => void | Promise<void>, isAvailable?: (conversationId: string) => boolean): Promise<void>;
 }
 export {};

package/dist/src/personal-agent/reply-composer.js

@@ -286,7 +286,14 @@ var PersonalReplyComposer = class {
 					})) return;
 				}
 				emitSessionTranscriptUpdate({ conversationId: packet.delivery.conversationId });
-				notify(packet.delivery.conversationId, `reply:${packet.delivery.deliveryId}`);
+				const notificationLease = setInterval(() => {
+					db.prepare("UPDATE task_result_deliveries SET reply_lease_until = ? WHERE delivery_id = ? AND reply_lease_token = ?").run(Date.now() + this.timeoutMs + 5e3, row.delivery_id, row.lease_token);
+				}, 5e3);
+				try {
+					await notify(packet.delivery.conversationId, `reply:${packet.delivery.deliveryId}`);
+				} finally {
+					clearInterval(notificationLease);
+				}
 				db.prepare("UPDATE task_result_deliveries SET reply_notified_at = ?, reply_lease_until = 0 WHERE delivery_id = ?").run(Date.now(), row.delivery_id);
 				if (packet.requestId) db.prepare("UPDATE personal_requests SET notified_at = ? WHERE request_id = ?").run(Date.now(), packet.requestId);
 			} catch (err) {

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

@@ -1,15 +1,15 @@
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { init_config_repository, setSessionConfig } from "../storage/sqlite/config-repository.js";
-import { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
 import { ResponsePreferencesSchema } from "../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 { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
 import { getAvailableModels, init_providers } from "../providers/index.js";
 import { DEFAULT_PERSONAL_PREFERENCES, 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 { AgentCatalogService } from "../agent-catalog/service.js";
 import { personalInstructions, upgradePersonalInstructions } from "./prompts.js";
 import { completePersonalOnboarding } from "./onboarding.js";
 import { z } from "zod";

package/dist/src/providers/model-catalog-persistence.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveXopcCloudCatalogCachePath } from "../config/paths-state.js";
-import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { ImageGenerationCapabilitiesSchema, init_models_json } from "../config/models-json.js";
 import { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";

package/dist/src/routing/resolve-route.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
+import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { init_agent_session_key, resolveAgentPeerConversationId } from "./agent-session-key.js";
 import { init_session_key, resolveConversationId } from "./session-key.js";
-import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_bindings, parseBindingRules, resolveRoute as resolveRoute$1 } from "./bindings.js";
 //#region src/routing/resolve-route.ts
 /**

package/dist/src/routing/resolve-tui-session-key.js

@@ -1,8 +1,8 @@
 import { validateConversationId } from "../../packages/gateway-contract/src/conversation-identity.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { init_agent_session_key, normalizeAgentId } from "./agent-session-key.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_agent_session_key, normalizeAgentId } from "./agent-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
 init_src();

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 { TaskConversationRepository } from "../task-conversation-repository.js";
-import { TaskReadModelProjector } from "../task-read-model-projector.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
+import { TaskConversationRepository } from "../task-conversation-repository.js";
+import { TaskReadModelProjector } from "../task-read-model-projector.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/task-handoff-service.js

@@ -2,9 +2,9 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { TaskRepository, init_task_repository } from "./task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { init_agent_scope, listAgentEntries } from "../agent/agent-scope.js";
+import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { TaskConversationRepository } from "./task-conversation-repository.js";
 import { TaskContextRepository } from "./task-context-repository.js";
 //#region src/tasks/task-handoff-service.ts

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

@@ -8,9 +8,10 @@ import { cancelQueuedSessionInput, claimNextSessionInput, finishSessionInputRun,
 import { appendComposerInputHistory, listComposerInputHistory } from "../../storage/sqlite/composer-input-history-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.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_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
 import { resolveEffectiveAgentProfile } from "../../config/agent-profile.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_paths } from "../../config/paths.js";
@@ -23,7 +24,6 @@ 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/platform-streams.js

@@ -81,7 +81,7 @@ function connect(url, token, signal, onEvent, onFailure) {
 		response.once("aborted", reject);
 	});
 	socket.on("error", fail);
-	socket.on("close", () => fail(/* @__PURE__ */ new Error("Platform voice disconnected before completion")));
+	socket.on("close", (code, reason) => fail(new PlatformVoiceError(`Platform voice disconnected before completion (close ${code}${reason.length ? `: ${reason.toString("utf8").slice(0, 256)}` : ""})`, void 0, "provider_disconnected")));
 	return {
 		socket,
 		close,

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

@@ -43,6 +43,7 @@ function createAgentVoiceEngine(options) {
 	let pendingTurn;
 	let turnReceivedAtMs;
 	let taskUpdateQueued = false;
+	const deliveredReplies = /* @__PURE__ */ new Set();
 	let lastUserSpeechAt = 0;
 	let openingInputSeen = false;
 	const turn = new TurnCoordinator(claim.silenceDurationMs, (text, decision, turnId) => {
@@ -314,7 +315,7 @@ function createAgentVoiceEngine(options) {
 		if (response.speechWorker) prefetchNextSpeech(response);
 		else startSpeechWorker(response);
 	}
-	async function runAssistantTurn(text, turnId, updateClientMessageId, receivedAtMs = Date.now(), committedAtMs = receivedAtMs, opening) {
+	async function runAssistantTurn(text, turnId, updateClientMessageId, receivedAtMs = Date.now(), committedAtMs = receivedAtMs, opening, directReply = false) {
 		if (!claim.tts || !claim.request.conversationId || !text.trim() || closed) return false;
 		cancelActiveResponse("barge_in");
 		const response = {
@@ -337,7 +338,7 @@ function createAgentVoiceEngine(options) {
 			taskDone: false,
 			pcm: new PcmFrameBuffer()
 		};
-		const taskUpdateExposed = () => Boolean(updateClientMessageId && response.text.trim());
+		const taskUpdateExposed = () => directReply ? response.firstFrameSent : Boolean(updateClientMessageId && response.text.trim());
 		activeResponse = response;
 		send("response.created", { responseId: response.id });
 		if (opening) response.openingTimer = setTimeout(() => {
@@ -364,14 +365,14 @@ function createAgentVoiceEngine(options) {
 			}, (error) => ({ error }));
 			await interruptionWrites;
 			if (response.abortController.signal.aborted || closed) return taskUpdateExposed();
-			if (opening) {
+			if (opening || directReply) {
 				response.text = text;
 				response.firstTextAtMs = Date.now();
 				send("response.text.delta", {
 					responseId: response.id,
 					delta: text
 				});
-				queuePhrases(response, [text]);
+				queuePhrases(response, directReply ? response.segmenter.push(text) : [text]);
 			} else {
 				if (!claim.conversationSessionId) throw new Error("Conversation identity is unavailable");
 				const task = await options.runtime.agentBroker.delegate({
@@ -487,7 +488,7 @@ function createAgentVoiceEngine(options) {
 			});
 			if (opening) opening.result = response.audioStarted ? "completed" : "failed";
 			activeResponse = void 0;
-			return !updateClientMessageId || taskUpdateExposed();
+			return directReply ? response.firstFrameSent : !updateClientMessageId || taskUpdateExposed();
 		} catch (error) {
 			if (response.abortController.signal.aborted || closed) return taskUpdateExposed();
 			log.warn({
@@ -694,6 +695,21 @@ function createAgentVoiceEngine(options) {
 	}
 	return {
 		isConversationIdle,
+		offerReply(input) {
+			if (deliveredReplies.has(input.deliveryId)) return Promise.resolve(true);
+			if (taskUpdateQueued || !canOfferTaskUpdateInput() || !input.text.trim() || input.text.length > 32e3 || deliveredReplies.size >= 256) return Promise.resolve(false);
+			taskUpdateQueued = true;
+			const attempt = conversationTail.then(async () => {
+				if (!canOfferTaskUpdateInput() || options.runtime.sessionBusy(claim.request.conversationId)) return false;
+				const delivered = await runAssistantTurn(input.text, input.deliveryId, void 0, Date.now(), Date.now(), void 0, true);
+				if (delivered) deliveredReplies.add(input.deliveryId);
+				return delivered;
+			});
+			conversationTail = attempt.then(() => {}, () => {});
+			return attempt.finally(() => {
+				taskUpdateQueued = false;
+			});
+		},
 		async offerOpeningGreeting(input) {
 			if (openingInputSeen || !canOfferTaskUpdateInput() || options.runtime.sessionBusy(claim.request.conversationId)) return "skipped";
 			const opening = {

package/dist/src/voice/realtime/engine.d.ts

@@ -22,5 +22,9 @@ export interface VoiceEngine {
         clientMessageId: string;
         content: string;
     }): Promise<boolean>;
+    offerReply?(input: {
+        deliveryId: string;
+        text: string;
+    }): Promise<boolean>;
     close(): void | Promise<void>;
 }

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

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

package/dist/src/voice/realtime/runtime.d.ts

@@ -29,6 +29,11 @@ export declare class VoiceRealtimeRuntime {
     hasConversation(conversationId: string): boolean;
     canPublishReply(conversationId: string): boolean;
     canOfferTaskUpdate(conversationId: string): boolean;
+    offerReply(input: {
+        conversationId: string;
+        deliveryId: string;
+        text: string;
+    }): Promise<boolean>;
     offerTaskUpdate(input: {
         conversationId: string;
         clientMessageId: string;

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

@@ -333,6 +333,10 @@ var VoiceRealtimeRuntime = class {
 		const sessionId = this.conversationReservations.get(conversationId);
 		return (sessionId ? this.activeSessions.get(sessionId) : void 0)?.engine?.canOfferTaskUpdate?.() === true;
 	}
+	async offerReply(input) {
+		const sessionId = this.conversationReservations.get(input.conversationId);
+		return (sessionId ? this.activeSessions.get(sessionId) : void 0)?.engine?.offerReply?.(input) ?? false;
+	}
 	async offerTaskUpdate(input) {
 		const sessionId = this.conversationReservations.get(input.conversationId);
 		const session = sessionId ? this.activeSessions.get(sessionId) : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.375",
+  "version": "0.0.376",
   "description": "Local-first personal AI with Ada, task delegation, files, projects, workflows, and automations. Use cloud or local models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -166,11 +166,11 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@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/image-providers": "0.1.0",
+    "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/gateway-contract": "0.0.0",
-    "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/realtime-client": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0"
   },