@xopcai/xopc 0.0.253 → 0.0.255

package/dist/src/share/hosted-static-site-publication.js

@@ -0,0 +1,108 @@
+import { isPathUnderWorkspace } from "../gateway/workspace-editor-path.js";
+import { resolveMimeType } from "./share-store.js";
+import { basename, dirname, extname, posix, relative, resolve } from "node:path";
+import { createReadStream } from "node:fs";
+import { createHash } from "node:crypto";
+import { lstat, readdir, realpath, stat } from "node:fs/promises";
+//#region src/share/hosted-static-site-publication.ts
+const MAX_FILES = 2e3;
+const MAX_FILE_BYTES = 64 * 1024 * 1024;
+const MAX_TOTAL_BYTES = 512 * 1024 * 1024;
+var HostedStaticSitePublicationBuilder = class {
+	async build(workspaceRoot, input) {
+		const realSource = await realpath(resolve(workspaceRoot, normalizeInputPath(input.path)));
+		if (!isPathUnderWorkspace(workspaceRoot, realSource)) throw new Error("Static site path is outside the workspace");
+		const sourceStat = await stat(realSource);
+		const singleHtml = sourceStat.isFile();
+		if (singleHtml && resolveMimeType(realSource) !== "text/html") throw new Error("Static site file must be an HTML document");
+		if (!singleHtml && !sourceStat.isDirectory()) throw new Error("Static site source must be an HTML file or directory");
+		const rootDir = singleHtml ? dirname(realSource) : realSource;
+		const entries = singleHtml ? [{
+			path: "index.html",
+			absolutePath: realSource
+		}] : (await collectFiles(rootDir)).map((path) => ({
+			path,
+			absolutePath: resolve(rootDir, path)
+		}));
+		if (!singleHtml && !entries.some((entry) => entry.path === "index.html")) throw new Error("Static site must contain index.html");
+		const assets = [];
+		const files = [];
+		let totalBytes = 0;
+		for (const entry of entries) {
+			const filePath = entry.path;
+			const absolutePath = entry.absolutePath;
+			const fileStat = await stat(absolutePath);
+			if (fileStat.size > MAX_FILE_BYTES) throw new Error(`Static site file exceeds publishing limit: ${filePath}`);
+			totalBytes += fileStat.size;
+			if (totalBytes > MAX_TOTAL_BYTES) throw new Error("Static site exceeds total publishing limit");
+			const id = createHash("sha256").update(filePath).digest("hex").slice(0, 40);
+			assets.push({
+				id,
+				path: absolutePath,
+				size: fileStat.size
+			});
+			files.push({
+				id,
+				path: filePath,
+				mimeType: resolveMimeType(filePath),
+				size: fileStat.size,
+				sha256: await sha256File(absolutePath)
+			});
+		}
+		const defaultTitle = singleHtml ? basename(realSource, extname(realSource)) : basename(realSource);
+		const title = input.title?.trim() || defaultTitle || "Published site";
+		return {
+			kind: "static_site",
+			rootDir,
+			title,
+			fileCount: files.length,
+			totalBytes,
+			assets,
+			manifest: {
+				schemaVersion: 1,
+				kind: "static_site",
+				title,
+				snapshotAt: (/* @__PURE__ */ new Date()).toISOString(),
+				...input.description?.trim() ? { description: input.description.trim() } : {},
+				entrypoint: "index.html",
+				spaFallback: input.spaFallback ?? true,
+				files
+			}
+		};
+	}
+};
+async function collectFiles(rootDir) {
+	const files = [];
+	const visit = async (directory) => {
+		const entries = await readdir(directory, { withFileTypes: true });
+		entries.sort((left, right) => left.name.localeCompare(right.name));
+		for (const entry of entries) {
+			const absolutePath = resolve(directory, entry.name);
+			const details = await lstat(absolutePath);
+			if (details.isSymbolicLink()) throw new Error(`Static site cannot contain symbolic links: ${entry.name}`);
+			if (details.isDirectory()) {
+				await visit(absolutePath);
+				continue;
+			}
+			if (!details.isFile()) throw new Error(`Unsupported static site entry: ${entry.name}`);
+			const filePath = relative(rootDir, absolutePath).split("\\").join("/");
+			if (filePath.split("/").some((part) => !part || part === "." || part === "..")) throw new Error("Invalid static site path");
+			files.push(posix.normalize(filePath));
+			if (files.length > MAX_FILES) throw new Error(`Static site has more than ${MAX_FILES} files`);
+		}
+	};
+	await visit(rootDir);
+	return files;
+}
+function normalizeInputPath(value) {
+	const normalized = value.trim().replace(/\\/g, "/").replace(/^\/+/, "");
+	if (!normalized || normalized.includes("\0") || normalized.split("/").some((part) => part === "..")) throw new Error("Invalid static site path");
+	return normalized;
+}
+async function sha256File(filePath) {
+	const hash = createHash("sha256");
+	for await (const chunk of createReadStream(filePath)) hash.update(chunk);
+	return hash.digest("hex");
+}
+//#endregion
+export { HostedStaticSitePublicationBuilder };

package/dist/src/share/hosted-static-site-publish.d.ts

@@ -0,0 +1,23 @@
+import { HostedPublicationPublisher, HostedShareBindingStore, type HostedShareBinding } from './hosted-session-share.js';
+import { HostedStaticSitePublicationBuilder, type HostedStaticSitePublicationSnapshot } from './hosted-static-site-publication.js';
+export interface PublishHostedStaticSiteInput {
+    workspaceRoot: string;
+    path: string;
+    title?: string;
+    description?: string;
+    spaFallback?: boolean;
+    ttlMs: number;
+    maxViews: number | null;
+    sessionKey?: string;
+    agentId?: string;
+}
+export interface PublishHostedStaticSiteResult {
+    binding: HostedShareBinding;
+    snapshot: HostedStaticSitePublicationSnapshot;
+}
+/** Build, upload, activate, and locally bind one immutable static-site snapshot. */
+export declare function publishHostedStaticSite(input: PublishHostedStaticSiteInput, deps?: {
+    builder?: HostedStaticSitePublicationBuilder;
+    publisher?: HostedPublicationPublisher;
+    bindings?: HostedShareBindingStore;
+}): Promise<PublishHostedStaticSiteResult>;

package/dist/src/share/hosted-static-site-publish.js

@@ -0,0 +1,53 @@
+import { HostedPublicationPublisher, HostedShareBindingStore } from "./hosted-session-share.js";
+import { HostedStaticSitePublicationBuilder } from "./hosted-static-site-publication.js";
+//#region src/share/hosted-static-site-publish.ts
+/** Build, upload, activate, and locally bind one immutable static-site snapshot. */
+async function publishHostedStaticSite(input, deps = {}) {
+	const builder = deps.builder ?? new HostedStaticSitePublicationBuilder();
+	const publisher = deps.publisher ?? new HostedPublicationPublisher();
+	const bindings = deps.bindings ?? new HostedShareBindingStore();
+	const snapshot = await builder.build(input.workspaceRoot, {
+		path: input.path,
+		title: input.title,
+		description: input.description,
+		spaFallback: input.spaFallback
+	});
+	const result = await publisher.createPublication(snapshot, {
+		ttlMs: input.ttlMs,
+		maxViews: input.maxViews
+	});
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const binding = {
+		...result,
+		kind: "static_site",
+		source: {
+			kind: "static_site",
+			id: input.path,
+			version: now
+		},
+		revisionSources: { [String(result.snapshotRevision)]: {
+			kind: "static_site",
+			id: input.path,
+			version: now
+		} },
+		workspaceContext: {
+			workspaceRoot: input.workspaceRoot,
+			...input.sessionKey ? { sessionKey: input.sessionKey } : {},
+			...input.agentId ? { agentId: input.agentId } : {}
+		},
+		title: snapshot.title,
+		description: input.description?.trim() || null,
+		attachmentCount: snapshot.fileCount,
+		attachmentIds: snapshot.assets.map((asset) => asset.id),
+		createdAt: now,
+		updatedAt: now,
+		revoked: false
+	};
+	await bindings.upsert(binding);
+	return {
+		binding,
+		snapshot
+	};
+}
+//#endregion
+export { publishHostedStaticSite };

package/dist/src/share/note-share-service.d.ts

@@ -65,3 +65,4 @@ export declare class NoteShareService {
     private artifactRelativePath;
     private artifactDir;
 }
+export declare function projectPublicNoteMarkdown(note: Note, selected: Set<string>): string;

package/dist/src/share/note-share-service.js

@@ -2,8 +2,8 @@ import { resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths } from "../config/paths.js";
-import { collectReferencedAttachmentIds } from "../notes/note-attachment-sync.js";
 import { issueShareAssetTicket, verifyShareAssetTicket } from "./share-asset-ticket.js";
+import { collectReferencedAttachmentIds } from "../notes/note-attachment-sync.js";
 import { dirname, join } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { copyFile, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
@@ -155,7 +155,7 @@ var NoteShareService = class {
 		for (const id of referenced) if (!known.has(id)) throw new Error(`Referenced attachment is missing: ${id}`);
 		const selected = requestedAttachmentIds === void 0 ? [...referenced] : Array.from(new Set(requestedAttachmentIds));
 		for (const id of selected) if (!referenced.has(id)) throw new Error(`Attachment is not referenced by this Note: ${id}`);
-		const projectedMarkdown = projectPublicMarkdown(note, new Set(selected));
+		const projectedMarkdown = projectPublicNoteMarkdown(note, new Set(selected));
 		const markdownBytes = Buffer.byteLength(projectedMarkdown, "utf8");
 		if (markdownBytes > cfg.maxMarkdownBytes) throw new Error("Note Markdown exceeds sharing limit");
 		if (selected.length > cfg.maxAttachmentCount) throw new Error("Note has too many attachments to share");
@@ -235,7 +235,7 @@ var NoteShareService = class {
 		return join(resolveStateDir(), this.artifactRelativePath(shareId));
 	}
 };
-function projectPublicMarkdown(note, selected) {
+function projectPublicNoteMarkdown(note, selected) {
 	const canonicalTarget = "xopc-attachment://notes/([^/\\s)]+)/([^\\s)]+)";
 	const assertOwned = new RegExp(canonicalTarget, "gi");
 	note.markdown.replace(assertOwned, (_match, rawNoteId) => {
@@ -260,4 +260,4 @@ function projectPublicMarkdown(note, selected) {
 	return markdown;
 }
 //#endregion
-export { NoteShareService, NoteShareVersionConflictError };
+export { NoteShareService, NoteShareVersionConflictError, projectPublicNoteMarkdown };

package/dist/src/share/share-url.d.ts

@@ -33,7 +33,7 @@ export interface ResolvedSiteShareUrl {
 }
 /**
  * Resolve the URL pair for a site share. Priority mirrors `resolveShareUrl`:
- *  1. FRP tunnel → wildcard subdomain on `<publicHostSuffix>`.
+ *  1. FRP tunnel → gateway `/site/<token>/` subpath.
  *  2. Reverse-proxy `publicUrl` → `<publicUrl>/site/<token>/` subpath.
  *  3. Direct gateway bind → `http://<host>:<port>/site/<token>/`.
  */

package/dist/src/share/share-url.js

@@ -1,12 +1,12 @@
 import { enumerateLanGatewayCandidates } from "../gateway/host.js";
-import { loadTunnelState } from "../tunnel/tunnel-state.js";
+import { getTunnelService } from "../tunnel/tunnel-service.js";
 //#region src/share/share-url.ts
 function resolveShareUrl(token, ctx) {
-	const tunnelState = loadTunnelState();
+	const tunnelPublicUrl = activeTunnelPublicUrl();
 	const { gatewayHost, gatewayPort, reverseProxyPublicUrl } = ctx;
 	const path = `/s/${token}`;
-	if (tunnelState?.publicUrl) return {
-		shareUrl: `${tunnelState.publicUrl.replace(/\/+$/, "")}${path}`,
+	if (tunnelPublicUrl) return {
+		shareUrl: `${tunnelPublicUrl.replace(/\/+$/, "")}${path}`,
 		lanUrl: buildLanUrl(gatewayHost, gatewayPort, path),
 		reachability: "public",
 		reachabilityHint: null
@@ -40,22 +40,23 @@ function isLoopbackHost(host) {
 	return host === "127.0.0.1" || host === "localhost" || host === "::1";
 }
 function resolveReachabilityForList(ctx) {
-	if (loadTunnelState()?.publicUrl) return "public";
+	if (activeTunnelPublicUrl()) return "public";
 	if (ctx.reverseProxyPublicUrl?.trim()) return "public";
 	if (!isLoopbackHost(ctx.gatewayHost)) return "lan";
 	return "local-only";
 }
 /**
 * Resolve the URL pair for a site share. Priority mirrors `resolveShareUrl`:
-*  1. FRP tunnel → wildcard subdomain on `<publicHostSuffix>`.
+*  1. FRP tunnel → gateway `/site/<token>/` subpath.
 *  2. Reverse-proxy `publicUrl` → `<publicUrl>/site/<token>/` subpath.
 *  3. Direct gateway bind → `http://<host>:<port>/site/<token>/`.
 */
 function resolveSiteShareUrl(ctx) {
-	if (loadTunnelState()?.publicUrl) {
-		const root = `https://${ctx.subdomainLabel}.${ctx.publicHostSuffix}`;
+	const tunnelPublicUrl = activeTunnelPublicUrl();
+	if (tunnelPublicUrl) {
+		const root = tunnelPublicUrl.replace(/\/+$/, "");
 		return {
-			shareUrl: `${root}/`,
+			shareUrl: `${root}/site/${ctx.token}/`,
 			thumbnailUrl: `${root}/site/${ctx.token}/thumbnail`,
 			reachability: "public",
 			reachabilityHint: null
@@ -80,5 +81,9 @@ function resolveSiteShareUrl(ctx) {
 		reachabilityHint: loopback ? "当前仅本机可访问，开启远程隧道后对外可达" : "当前局域网内可访问，开启远程隧道后对外网可达"
 	};
 }
+function activeTunnelPublicUrl() {
+	const status = getTunnelService().getStatus();
+	return status.state === "connected" && status.publicUrl ? status.publicUrl : null;
+}
 //#endregion
 export { resolveReachabilityForList, resolveShareUrl, resolveSiteShareUrl };

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

@@ -2,10 +2,10 @@ import { isHomeAttentionAcknowledged } from "../storage/sqlite/home-attention-re
 import { getRelationshipSettings } from "../storage/sqlite/relationship-settings-repository.js";
 import { listConnectorApprovals } from "../storage/sqlite/connector-repository.js";
 import "../storage/sqlite/index.js";
-import { TaskRepository } from "./task-repository.js";
-import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import "../automations/domain/defaults.js";
 import "../automations/index.js";
+import { TaskRepository } from "./task-repository.js";
+import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { AttentionGovernor } from "./attention-governor.js";
 import { listGatewayAgents } from "../gateway/agents-admin.js";
 //#region src/tasks/home-query-service.ts

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

@@ -12,11 +12,11 @@ import { effectiveWorkspacePathForSession } from "../../session/session-workspac
 import { ProjectService } from "../../projects/project-service.js";
 import { inferSuggestedProjectDefaultAgentId } from "../../projects/project-agent-suggestion.js";
 import "../../projects/index.js";
+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 { setTuiDefaultAgentConfig } from "../../commands/agents.config.js";
-import { buildSessionTimeline } from "../../session/transcript-outline.js";
-import { transcriptRowsToClientHistory } from "../../session/client-history.js";
 import { SessionIndex } from "../../session/manager.js";
 import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";

package/dist/src/tui/tui-agent-events.js

@@ -1,5 +1,5 @@
-import { formatAgentRunErrorForDisplay } from "../agent/client-error-format.js";
 import { stripRuntimeContextFromUserContent } from "../session/user-message-display.js";
+import { formatAgentRunErrorForDisplay } from "../agent/client-error-format.js";
 import { createAssistantMessageFromText } from "./components/assistant-message.js";
 import { markRunEvent, markRunIdleAfterCompletion } from "./tui-run-state.js";
 //#region src/tui/tui-agent-events.ts

package/dist/src/tui/tui-startup-resources.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
 import { loadSkills } from "../agent/skills/index.js";

package/dist/src/tui/tui.js

@@ -2,10 +2,10 @@ import { version } from "../../package.js";
 import { resolveStateDir, resolveXopcDatabasePath } from "../config/paths-state.js";
 import { parseAgentSessionKey } from "../routing/session-key-utils.js";
 import { init_agent_session_key, normalizeAgentId } from "../routing/agent-session-key.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
 import { getAllModels, getAllProviders, getApiKey, init_providers, isProviderConfiguredSync } from "../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { renderWorkflowFinalSummary, renderWorkflowPanel } from "../agent/workflow/snapshot.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";

package/dist/src/tunnel/index.js

@@ -1,7 +1,7 @@
-import { loadTunnelState, resolveTunnelStatePath, saveTunnelState } from "./tunnel-state.js";
 import { TunnelBrokerClient, resolveBrokerApiBase } from "./broker-client.js";
 import { FRPC_VERSION, clearFrpcPathForProcess, ensureFrpcBinary, publishFrpcPathForProcess } from "./frpc-binary.js";
 import { TUNNEL_REGISTRATION_SECRET_REQUIRED_CODE, TunnelRegistrationSecretError, getTunnelRegistrationSecretMeta, isLocalDevelopmentTunnelBroker, isMaskedTunnelSecretPatchValue, resolveOptionalTunnelRegistrationSecret, resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret, tunnelRegistrationSecretRequiredMessage } from "./env.js";
+import { loadTunnelState, resolveTunnelStatePath, saveTunnelState } from "./tunnel-state.js";
 import { logTunnelAudit } from "./tunnel-audit.js";
 import { TunnelService, getTunnelService, hashGatewayToken } from "./tunnel-service.js";
 import { CURRENT_TUNNEL_CONSENT_VERSION, TUNNEL_CONSENT_REQUIRED_CODE, TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, getTunnelConsentState, hasValidTunnelConsent } from "./consent.js";

package/dist/src/tunnel/tunnel-service.js

@@ -1,13 +1,13 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { clearTunnelState, loadTunnelState, saveTunnelState, updateTunnelState } from "./tunnel-state.js";
 import { TunnelBrokerClient, resolveBrokerApiBase } from "./broker-client.js";
 import { clearFrpcPathForProcess, ensureFrpcBinary, publishFrpcPathForProcess } from "./frpc-binary.js";
 import { writeFrpcConfig } from "./frpc-config.js";
 import { spawnFrpcProcess } from "./frpc-process.js";
 import { TunnelRegistrationSecretError } from "./env.js";
 import { canResumePersistedTunnel, persistedFromRegistration, registrationFromPersisted } from "./tunnel-persist.js";
+import { clearTunnelState, loadTunnelState, saveTunnelState, updateTunnelState } from "./tunnel-state.js";
 import { logTunnelAudit } from "./tunnel-audit.js";
 import { createHash } from "node:crypto";
 import { EventEmitter } from "node:events";

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

@@ -3,6 +3,7 @@ import { init_logger } from "../../utils/logger.js";
 import { speakStream } from "../tts/speak-core.js";
 import { AudioPlaybackWindow } from "./audio-playback-window.js";
 import { ConversationTurn } from "./conversationTurn.js";
+import { isLikelyPlaybackEcho } from "./playback-echo.js";
 import { SpeakableSegmenter } from "./speakable-segmenter.js";
 import crypto from "node:crypto";
 //#region src/voice/realtime/agentEngine.ts
@@ -89,6 +90,7 @@ function createAgentVoiceEngine(options) {
 			signal: response.abortController.signal,
 			allowFallback: false
 		});
+		let phraseMarkedAudible = false;
 		try {
 			if (response.abortController.signal.aborted || activeResponse !== response || closed) return;
 			if (result.outputFormat !== "pcm") throw new Error(`Realtime TTS returned unsupported format: ${result.outputFormat}`);
@@ -97,6 +99,10 @@ function createAgentVoiceEngine(options) {
 				const item = await reader.read();
 				if (item.done) break;
 				if (response.abortController.signal.aborted || activeResponse !== response) return;
+				if (!phraseMarkedAudible && item.value.byteLength > 0) {
+					phraseMarkedAudible = true;
+					response.audibleText = `${response.audibleText} ${phrase}`.trim().slice(-8e3);
+				}
 				if (!response.audioStarted) {
 					response.audioStarted = true;
 					log.info({
@@ -153,6 +159,7 @@ function createAgentVoiceEngine(options) {
 			abortController: new AbortController(),
 			segmenter: new SpeakableSegmenter(),
 			text: "",
+			audibleText: "",
 			audioStarted: false,
 			speechTail: Promise.resolve(),
 			queuedSpeechCharacters: 0,
@@ -185,6 +192,7 @@ function createAgentVoiceEngine(options) {
 					});
 					queuePhrases(response, response.segmenter.push(event.payload.delta));
 				}
+				if (event.type === "tool_start") queuePhrases(response, response.segmenter.flush());
 				if ((event.type === "tool_start" || event.type === "tool_end") && typeof event.payload?.toolCallId === "string" && typeof event.payload?.toolName === "string") send("response.activity", {
 					responseId: response.id,
 					toolCallId: event.payload.toolCallId.slice(0, 160),
@@ -333,6 +341,15 @@ function createAgentVoiceEngine(options) {
 			}
 			finalizedUtterances.add(event.utteranceId);
 			finalCount += 1;
+			if (claim.request.purpose === "conversation" && activeResponse?.audioStarted && isLikelyPlaybackEcho(text, activeResponse.audibleText)) {
+				bufferFinal(event.utteranceId, "");
+				log.debug({
+					sessionId: claim.sessionId,
+					responseId: activeResponse.id,
+					transcriptCharacters: text.length
+				}, "Ignored finalized transcription matching active voice playback");
+				return;
+			}
 			send("input.transcript.final", {
 				utteranceId: event.utteranceId,
 				revision: event.revision,

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

@@ -8,8 +8,8 @@ import { getKnowledgeItem } from "../../knowledge-memory/repository.js";
 import "../../knowledge-memory/index.js";
 import { getUserAssertion } from "../../user-model/repository.js";
 import "../../user-model/index.js";
-import { buildExecutionContext } from "../../agent/context/execution-context.js";
 import { stripRuntimeContextFromUserMessage } from "../../session/user-message-display.js";
+import { buildExecutionContext } from "../../agent/context/execution-context.js";
 //#region src/voice/realtime/memory-context.ts
 init_session_key();
 init_logger();

package/dist/src/voice/realtime/playback-echo.d.ts

@@ -0,0 +1,2 @@
+/** Conservatively identifies finalized ASR that is already in audible assistant output. */
+export declare function isLikelyPlaybackEcho(transcript: string, assistantText: string): boolean;

package/dist/src/voice/realtime/playback-echo.js

@@ -0,0 +1,15 @@
+//#region src/voice/realtime/playback-echo.ts
+function normalizeSpeech(text) {
+	return text.toLocaleLowerCase().normalize("NFKC").replace(/[^\p{L}\p{N}]/gu, "");
+}
+/** Conservatively identifies finalized ASR that is already in audible assistant output. */
+function isLikelyPlaybackEcho(transcript, assistantText) {
+	const heard = normalizeSpeech(transcript);
+	const spoken = normalizeSpeech(assistantText);
+	if (!heard || !spoken) return false;
+	const containsCjk = /\p{Script=Han}/u.test(heard);
+	if (heard.length < (containsCjk ? 3 : 6)) return false;
+	return spoken.includes(heard);
+}
+//#endregion
+export { isLikelyPlaybackEcho };

package/dist/src/work-discovery/service.js

@@ -6,12 +6,12 @@ import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { isLocalModelBaseUrl } from "../providers/model-call.js";
 import { writeKnowledgeItem } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
 import { createPriorityWindow, createUserGoal } from "../user-model/goals.js";
 import { getAssertionSlot, getUserAssertion, linkAssertionEvidence, reconcileAssertion, setAssertionStatus } from "../user-model/repository.js";
 import "../user-model/index.js";
-import { isLocalModelBaseUrl } from "../providers/model-call.js";
 import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources, analyzeWorkContext, workDiscoveryResultMarkdown } from "./analyzer.js";
 import { createUnderstandingSourceRun, getUnderstandingSourceRun, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceGrantPolicies, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant } from "../user-context/sources/repository.js";

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

@@ -1,11 +1,11 @@
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { publishAutomationProductEvent } from "../../automations/product-events.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { getProjectWorkspacePathForSession } from "../../projects/workspace.js";
-import { publishAutomationProductEvent } from "../../automations/product-events.js";
 import { TaskContextRepository } from "../../tasks/task-context-repository.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { resolveModelSelector } from "../../config/agent-model-intents.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.253",
+  "version": "0.0.255",
   "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",
@@ -162,10 +162,10 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/browser-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-client": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/browser-control-contract": "0.1.0",
     "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {