@xopcai/xopc 0.0.244 → 0.0.246

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -106,6 +106,13 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                 allowed?: string[];
             };
             runtime: {
+                commandIsolation?: {
+                    mode: "host";
+                } | {
+                    mode: "docker";
+                    image: string;
+                    network: boolean;
+                };
                 maxTurns?: number;
                 timeoutMs?: number;
                 maxToolFailuresPerTurn?: number;

package/dist/src/gateway/hono/routes/sessions.js

@@ -2,8 +2,8 @@ import { buildSessionKey, init_session_key } from "../../../routing/session-key.
 import { resolveProjectAgentId } from "../../../projects/project-agent.js";
 import "../../../projects/index.js";
 import { evictEmbeddedSessionRunner } from "../../../agent/embedded/session-runner.js";
-import { messagesToClientHistory } from "../../../session/client-history.js";
 import { SessionEnvironmentService } from "../../../execution-environments/session-environment-service.js";
+import { messagesToClientHistory } from "../../../session/client-history.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../../media/session-references.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { createGatewayRouteLogger, logRouteError } from "../lib/route-logger.js";

package/dist/src/gateway/media-access.js

@@ -1,8 +1,8 @@
 import { TaskRepository } from "../tasks/task-repository.js";
 import { FileServiceError } from "../files/file-service.js";
 import { resolveMediaReference } from "../media/media-reference.js";
-import { TaskContextRepository } from "../tasks/task-context-repository.js";
 import { pendingTranscriptReferencesMediaUri } from "../agent/inbound/attachment-pipeline.js";
+import { TaskContextRepository } from "../tasks/task-context-repository.js";
 import { messagesReferenceMediaUri } from "../media/session-references.js";
 //#region src/gateway/media-access.ts
 /** Resolve media only when the supplied session or task references it. */

package/dist/src/gateway/run-loop.js

@@ -1,6 +1,6 @@
 import { loadConfig } from "../config/loader.js";
-import { isRestartEnabled } from "../config/commands.flags.js";
 import "../config/index.js";
+import { isRestartEnabled } from "../config/commands.flags.js";
 import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { restartGatewayProcessWithFreshPid } from "./respawn.js";
 import { acquireGatewayLock } from "./lock.js";

package/dist/src/gateway/service/run-gateway-agent.js

@@ -90,11 +90,14 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 			})));
 			return;
 		}
+		if (event.type === "turn_outcome") {
+			taskRun?.captureOutcome(event.payload);
+			return;
+		}
 		if (event.type === "patch_applied") {
 			taskRun?.capturePatch(event.payload.added, event.payload.removed);
 			return;
 		}
-		if (event.type === "command_completed" && event.payload.exitCode === 0 && /(^|\s)(test|vitest|jest|pytest|lint|typecheck|build)(\s|$|:)/i.test(event.payload.command)) taskRun?.captureCommand(event.payload.command, event.payload.durationMs);
 	};
 	const emitAndYield = function* (events) {
 		for (const event of events) {

package/dist/src/gateway/service.js

@@ -28,6 +28,7 @@ import { ProjectService } from "../projects/project-service.js";
 import { resolveProjectAgentId } from "../projects/project-agent.js";
 import "../projects/index.js";
 import { resolveEffectiveGatewayPort } from "./host.js";
+import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { AutomationService } from "../automations/service/automation-service.js";
 import { onAutomationProductEvent, publishAutomationProductEvent } from "../automations/product-events.js";
 import "../automations/index.js";
@@ -38,7 +39,6 @@ import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
 import { TaskSignalService } from "../tasks/task-signal-service.js";
 import "../tasks/index.js";
 import "../agent/mcp/bundle-mcp-tools.js";
-import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { SessionIndex } from "../session/manager.js";
 import "../session/index.js";
 import { ExtensionLoader } from "../extensions/loader.js";
@@ -59,14 +59,14 @@ import "../knowledge/index.js";
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { ConnectedSourceChangePublisher } from "../connectors/source-change-publisher.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 { 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 { stopTailscaleExposure } from "./tailscale-lifecycle.js";

package/dist/src/gateway/session-reset-service.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { retireSessionMcpRuntimeForSessionKey } from "../agent/mcp/bundle-mcp-runtime.js";
-import "../agent/mcp/bundle-mcp-tools.js";
 import { abortEmbeddedRun } from "../agent/embedded/runs.js";
+import "../agent/mcp/bundle-mcp-tools.js";
 //#region src/gateway/session-reset-service.ts
 init_logger();
 const log = createLogger("SessionReset");

package/dist/src/gateway/workspace-ripgrep.d.ts

@@ -1,9 +1,3 @@
-/** Ripgrep binaries inside `app.asar` are not executable (spawn throws ENOTDIR). */
-export declare function isAsarBundledPath(filePath: string): boolean;
-/** True when `filePath` is a real on-disk executable candidate (not inside asar). */
-export declare function isRunnableRipgrepPath(filePath: string): boolean;
-/** @internal Test-only — clears memoized ripgrep path between cases. */
-export declare function resetRipgrepBinaryCacheForTests(): void;
 export interface WorkspaceSearchHit {
     filePath: string;
     lineNumber: number;

package/dist/src/gateway/workspace-ripgrep.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { existsSync } from "node:fs";
+import { resolveRipgrepBinary } from "../infra/ripgrep.js";
 import { spawn } from "node:child_process";
 //#region src/gateway/workspace-ripgrep.ts
 init_logger();
@@ -8,44 +8,6 @@ const log = createLogger("WorkspaceRipgrep");
 function isEnoent(err) {
 	return err !== null && typeof err === "object" && err.code === "ENOENT";
 }
-/** Ripgrep binaries inside `app.asar` are not executable (spawn throws ENOTDIR). */
-function isAsarBundledPath(filePath) {
-	return filePath.includes(".asar");
-}
-/** True when `filePath` is a real on-disk executable candidate (not inside asar). */
-function isRunnableRipgrepPath(filePath) {
-	const trimmed = filePath.trim();
-	if (!trimmed || isAsarBundledPath(trimmed)) return false;
-	return existsSync(trimmed);
-}
-let cachedRipgrepBin;
-/** @internal Test-only — clears memoized ripgrep path between cases. */
-function resetRipgrepBinaryCacheForTests() {
-	cachedRipgrepBin = void 0;
-}
-/**
-* Resolve ripgrep binary:
-* 1. `XOPC_RIPGREP_BIN` (Electron extraResources `bin/rg`)
-* 2. `@vscode/ripgrep` postinstall path (dev / CLI)
-* 3. `rg` on PATH
-*/
-async function resolveRipgrepBinary() {
-	if (cachedRipgrepBin) return cachedRipgrepBin;
-	const envBin = process.env.XOPC_RIPGREP_BIN?.trim();
-	if (envBin && isRunnableRipgrepPath(envBin)) {
-		cachedRipgrepBin = envBin;
-		return envBin;
-	}
-	let bin = "rg";
-	try {
-		const { rgPath } = await import("@vscode/ripgrep");
-		if (typeof rgPath === "string" && rgPath.length > 0) if (isRunnableRipgrepPath(rgPath)) bin = rgPath;
-		else if (isAsarBundledPath(rgPath)) log.debug({ rgPath }, "@vscode/ripgrep path is inside app.asar; will try rg on PATH or XOPC_RIPGREP_BIN");
-		else log.debug({ rgPath }, "@vscode/ripgrep binary not on disk; will try rg on PATH");
-	} catch {}
-	cachedRipgrepBin = bin;
-	return bin;
-}
 function spawnRipgrep(executable, args, options, context) {
 	try {
 		return spawn(executable, args, {
@@ -192,4 +154,4 @@ function runRipgrepListFiles(dirAbsPath) {
 	})();
 }
 //#endregion
-export { isAsarBundledPath, isRunnableRipgrepPath, resetRipgrepBinaryCacheForTests, runRipgrepInDirectory, runRipgrepListFiles };
+export { runRipgrepInDirectory, runRipgrepListFiles };

package/dist/src/infra/ripgrep.d.ts

@@ -0,0 +1,13 @@
+/** Ripgrep binaries inside `app.asar` are not executable (spawn throws ENOTDIR). */
+export declare function isAsarBundledPath(filePath: string): boolean;
+/** True when `filePath` is a real on-disk executable candidate (not inside asar). */
+export declare function isRunnableRipgrepPath(filePath: string): boolean;
+/** @internal Test-only — clears memoized ripgrep path between cases. */
+export declare function resetRipgrepBinaryCacheForTests(): void;
+/**
+ * Resolve ripgrep binary:
+ * 1. `XOPC_RIPGREP_BIN` (Electron extraResources `bin/rg`)
+ * 2. `@vscode/ripgrep` postinstall path (dev / CLI)
+ * 3. `rg` on PATH
+ */
+export declare function resolveRipgrepBinary(): Promise<string>;

package/dist/src/infra/ripgrep.js

@@ -0,0 +1,46 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { existsSync } from "node:fs";
+//#region src/infra/ripgrep.ts
+init_logger();
+const log = createLogger("WorkspaceRipgrep");
+/** Ripgrep binaries inside `app.asar` are not executable (spawn throws ENOTDIR). */
+function isAsarBundledPath(filePath) {
+	return filePath.includes(".asar");
+}
+/** True when `filePath` is a real on-disk executable candidate (not inside asar). */
+function isRunnableRipgrepPath(filePath) {
+	const trimmed = filePath.trim();
+	if (!trimmed || isAsarBundledPath(trimmed)) return false;
+	return existsSync(trimmed);
+}
+let cachedRipgrepBin;
+/** @internal Test-only — clears memoized ripgrep path between cases. */
+function resetRipgrepBinaryCacheForTests() {
+	cachedRipgrepBin = void 0;
+}
+/**
+* Resolve ripgrep binary:
+* 1. `XOPC_RIPGREP_BIN` (Electron extraResources `bin/rg`)
+* 2. `@vscode/ripgrep` postinstall path (dev / CLI)
+* 3. `rg` on PATH
+*/
+async function resolveRipgrepBinary() {
+	if (cachedRipgrepBin) return cachedRipgrepBin;
+	const envBin = process.env.XOPC_RIPGREP_BIN?.trim();
+	if (envBin && isRunnableRipgrepPath(envBin)) {
+		cachedRipgrepBin = envBin;
+		return envBin;
+	}
+	let bin = "rg";
+	try {
+		const { rgPath } = await import("@vscode/ripgrep");
+		if (typeof rgPath === "string" && rgPath.length > 0) if (isRunnableRipgrepPath(rgPath)) bin = rgPath;
+		else if (isAsarBundledPath(rgPath)) log.debug({ rgPath }, "@vscode/ripgrep path is inside app.asar; will try rg on PATH or XOPC_RIPGREP_BIN");
+		else log.debug({ rgPath }, "@vscode/ripgrep binary not on disk; will try rg on PATH");
+	} catch {}
+	cachedRipgrepBin = bin;
+	return bin;
+}
+//#endregion
+export { isAsarBundledPath, isRunnableRipgrepPath, resetRipgrepBinaryCacheForTests, resolveRipgrepBinary };

package/dist/src/proactive/execution/agent-executor.js

@@ -1,8 +1,8 @@
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
-import { runAgentTurnWithTimeout } from "../../agent/orchestration/run-agent-turn-with-timeout.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../../agent/orchestration/llm-turn-retry.js";
+import { runAgentTurnWithTimeout } from "../../agent/orchestration/run-agent-turn-with-timeout.js";
 import { Agent } from "@earendil-works/pi-agent-core";
 import { Type } from "@sinclair/typebox";
 //#region src/proactive/execution/agent-executor.ts

package/dist/src/session/store.js

@@ -12,8 +12,8 @@ import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompact
 import { getSessionConfig, setSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
 import { SessionCompactor } from "../agent/memory/compaction.js";
+import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
 import { resolveCompactionPolicy } from "../agent/memory/compaction-policy.js";
 import { promoteCompactionLedger } from "../agent/memory/compaction-promotion.js";
 import { SlidingWindow } from "../agent/memory/window.js";

package/dist/src/session/turn-outcome-projector.js

@@ -2,7 +2,6 @@ import { TurnOutcomeDeliverableSchema, fileResourceArtifactUri, mergeTurnOutcome
 import { parseProductDeliveryEnvelope } from "../../packages/gateway-contract/src/product-delivery.js";
 import { parseFileResourceId } from "../files/file-service.js";
 //#region src/session/turn-outcome-projector.ts
-const VERIFICATION_COMMAND = /(^|[\s:/_-])(test|vitest|jest|pytest|lint|typecheck|type-check|build)([\s:/_-]|$)/i;
 const MAX_OUTCOME_DIFF_CHARS = 2e5;
 function record(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -75,14 +74,16 @@ function projectTurnOutcome(params) {
 	let removed = 0;
 	let failedToolCount = 0;
 	let createdAtMs = 0;
+	let verificationSummary = null;
 	for (const source of params.rows) {
 		const row = source;
 		if (row.turnId !== params.turnId) continue;
+		if (row.type === "custom" && row.customType === "coding_verification") verificationSummary = record(row.data);
 		const timestamp = typeof row.timestamp === "number" ? row.timestamp : Date.parse(typeof row.timestamp === "string" ? row.timestamp : "");
 		if (Number.isFinite(timestamp)) createdAtMs = Math.max(createdAtMs, timestamp);
 		if (row.role !== "toolResult" && row.role !== "tool") continue;
-		if (row.isError === true) failedToolCount += 1;
 		const details = record(row.details) ?? {};
+		if (row.isError === true && record(details.verification)?.kind !== "check") failedToolCount += 1;
 		const explicit = Array.isArray(details.artifacts) ? details.artifacts.flatMap((value) => {
 			const parsed = TurnOutcomeDeliverableSchema.safeParse(value);
 			return parsed.success ? [parsed.data] : [];
@@ -111,23 +112,42 @@ function projectTurnOutcome(params) {
 			if (typeof details.added === "number") added += Math.max(0, details.added);
 			if (typeof details.removed === "number") removed += Math.max(0, details.removed);
 		}
-		if (row.toolName === "exec_command" && VERIFICATION_COMMAND.test(text(details.command) ?? "")) {
+		const verification = record(details.verification);
+		if (verification?.kind === "check" && text(verification.command)) {
 			const toolCallId = text(row.toolCallId) ?? `check-${evidence.size + 1}`;
-			const command = text(details.command);
+			const command = text(verification.command);
 			evidence.set(toolCallId, {
 				evidenceId: `${params.turnId}:${toolCallId}:check`,
 				kind: "check",
 				label: command,
-				status: details.exitCode === 0 && details.timedOut !== true ? "passed" : "failed",
+				status: verification.status === "failed" ? "failed" : "warning",
 				command,
 				...typeof details.durationMs === "number" ? { durationMs: Math.max(0, details.durationMs) } : {}
 			});
 		}
 	}
+	if (verificationSummary) {
+		evidence.clear();
+		for (const raw of Array.isArray(verificationSummary.evidence) ? verificationSummary.evidence : []) {
+			const item = record(raw);
+			if (item?.kind !== "check" || !text(item.command) || !text(item.toolCallId)) continue;
+			const id = `${params.turnId}:${item.toolCallId}:check`;
+			evidence.set(id, {
+				evidenceId: id,
+				kind: "check",
+				label: String(item.command),
+				command: String(item.command),
+				status: item.status === "passed" ? "passed" : item.status === "failed" ? "failed" : "warning",
+				...text(item.revision) ? { revision: text(item.revision) } : {},
+				...text(item.logPath) ? { logPath: text(item.logPath) } : {},
+				...typeof item.durationMs === "number" ? { durationMs: Math.max(0, item.durationMs) } : {}
+			});
+		}
+	}
 	const evidenceItems = [...evidence.values()];
 	const collectedArtifacts = [...deliverables.values()];
 	const artifactItems = mergeTurnOutcomeDeliverables(collectedArtifacts);
-	const partial = failedToolCount > 0 || evidenceItems.some((item) => item.status === "failed") || collectedArtifacts.some((item) => item.availability !== "available");
+	const partial = !verificationSummary && failedToolCount > 0 || evidenceItems.some((item) => item.status !== "passed") || verificationSummary?.required === true && verificationSummary.changed === true && !evidenceItems.some((item) => item.status === "passed") || collectedArtifacts.some((item) => item.availability !== "available");
 	const diff = diffs.join("\n");
 	const diffTruncated = diff.length > MAX_OUTCOME_DIFF_CHARS;
 	const createdAt = new Date(createdAtMs || Date.now()).toISOString();

package/dist/src/tasks/task-run-coordinator.d.ts

@@ -1,4 +1,4 @@
-import type { TaskEvidence, TaskRunReceipt } from '@xopcai/gateway-contract';
+import type { TaskEvidence, TaskRunReceipt, TurnOutcome } from '@xopcai/gateway-contract';
 import type { ExecutionContext } from './execution-context.js';
 export declare class TaskRunCoordinator {
     #private;
@@ -14,8 +14,8 @@ export declare class TaskRunCoordinator {
         title: string;
         status: string;
     }>): void;
+    captureOutcome(outcome: TurnOutcome): void;
     capturePatch(added: number, removed: number): void;
-    captureCommand(command: string, durationMs?: number): void;
     finalize(input: {
         status: TaskRunReceipt['status'];
         summary: string;

package/dist/src/tasks/task-run-coordinator.js

@@ -75,6 +75,19 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 			});
 		}
 	}
+	captureOutcome(outcome) {
+		for (const item of outcome.evidence) {
+			if (item.kind !== "check") continue;
+			this.addEvidence({
+				kind: "test",
+				title: item.label,
+				summary: `Final workspace check: ${item.status}`,
+				provenance: "tool",
+				strength: item.status === "passed" ? "verified" : "observed",
+				observedAt: Date.now()
+			});
+		}
+	}
 	capturePatch(added, removed) {
 		this.addEvidence({
 			kind: "state",
@@ -85,17 +98,6 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 			observedAt: Date.now()
 		});
 	}
-	captureCommand(command, durationMs) {
-		if (!/(^|\s)(test|vitest|jest|pytest|lint|typecheck|build)(\s|$|:)/i.test(command)) return;
-		this.addEvidence({
-			kind: "test",
-			title: command.slice(0, 120),
-			summary: durationMs === void 0 ? "Command completed successfully" : `Command completed successfully in ${durationMs} ms`,
-			provenance: "tool",
-			strength: "verified",
-			observedAt: Date.now()
-		});
-	}
 	finalize(input) {
 		const run = this.#runs.get(this.runId);
 		if (!run || ![
@@ -118,7 +120,7 @@ var TaskRunCoordinator = class TaskRunCoordinator {
 				},
 				remainingWork: [],
 				needsUser: false,
-				completionVerdict: input.status === "succeeded" ? "achieved" : "not_achieved",
+				completionVerdict: input.status === "succeeded" ? "partial" : "not_achieved",
 				...input.status === "failed" ? { failure: {
 					code: "agent_run_failed",
 					phase: "execution",

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

@@ -13,8 +13,8 @@ import { ProjectService } from "../../projects/project-service.js";
 import { inferSuggestedProjectDefaultAgentId } from "../../projects/project-agent-suggestion.js";
 import "../../projects/index.js";
 import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
-import { setTuiDefaultAgentConfig } from "../../commands/agents.config.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";

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

@@ -1,4 +1,4 @@
-import type { VoiceTicketClaim, VoiceRealtimeRuntimeOptions } from './runtime.js';
+import type { VoiceTicketClaim, VoiceRealtimeRuntimeOptions } from './runtime.types.js';
 import type { VoiceEngine, VoiceEventSink } from './engine.js';
 export declare function createAgentVoiceEngine(options: {
     claim: VoiceTicketClaim;

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

@@ -1,79 +1,15 @@
 import type { IncomingMessage } from 'node:http';
 import type { Socket } from 'node:net';
-import { type CreateVoiceSessionRequest, type CreateVoiceSessionResponse, type VoiceProviderRoute } from '@xopcai/realtime-protocol/voice';
+import { type CreateVoiceSessionRequest, type CreateVoiceSessionResponse } from '@xopcai/realtime-protocol/voice';
 import type { Config } from '../../config/schema.js';
-import type { MediaUnderstandingProvider } from '../../media-understanding/types.js';
-import { type ResolvedSpeechProvider } from '../tts/factory.js';
-import type { TTSConfig } from '../tts/types.js';
-import { type VoiceConversationContext } from './conversation-context.js';
-import { type OmniRoute } from './omniRoute.js';
-import { type OmniTranscript } from './omniEngine.js';
-interface ResolvedStreamingStt {
-    plugin: MediaUnderstandingProvider & Required<Pick<MediaUnderstandingProvider, 'openAudioStream' | 'streamingAudio'>>;
-    model: string;
-    apiKey?: string;
-    baseUrl?: string;
-    headers?: Record<string, string>;
-    language?: string;
-    prompt?: string;
-    route: VoiceProviderRoute;
-}
-export interface VoiceTicketClaim {
-    sessionId: string;
-    principalId: string;
-    request: CreateVoiceSessionRequest;
-    inputMode: 'server_vad';
-    idleTimeoutMs: number;
-    maxSessionMs: number;
-    silenceDurationMs: number;
-    stt?: ResolvedStreamingStt;
-    omni?: OmniRoute;
-    conversationSessionId?: string;
-    tts?: ResolvedStreamingTts;
-    config: Config;
-    createdAt: number;
-    expiresAt: number;
-}
-interface ResolvedStreamingTts {
-    provider: ResolvedSpeechProvider;
-    config: TTSConfig;
-    route: VoiceProviderRoute;
-}
+import type { ResolvedStreamingStt, ResolvedStreamingTts, VoiceRealtimeRuntimeOptions } from './runtime.types.js';
+export type { VoiceTicketClaim, VoiceRealtimeRuntimeOptions } from './runtime.types.js';
 export type VoiceSessionCreationErrorCode = 'VOICE_DISABLED' | 'SESSION_NOT_FOUND' | 'SESSION_CONFLICT' | 'SESSION_LIMIT' | 'PROVIDER_UNAVAILABLE';
 export declare class VoiceSessionCreationError extends Error {
     readonly code: VoiceSessionCreationErrorCode;
     readonly status: 404 | 409 | 429 | 503;
     constructor(code: VoiceSessionCreationErrorCode, message: string, status: 404 | 409 | 429 | 503);
 }
-interface VoiceAgentEvent {
-    type: string;
-    payload?: {
-        delta?: unknown;
-        message?: unknown;
-        status?: unknown;
-        toolCallId?: unknown;
-        toolName?: unknown;
-        requestId?: unknown;
-        question?: unknown;
-        choices?: unknown;
-    };
-}
-export interface VoiceRealtimeRuntimeOptions {
-    recordOmniTranscript?: (sessionKey: string, callId: string, entry: OmniTranscript, expectedSessionId: string) => Promise<void>;
-    getConversationContext?: (sessionKey: string, expectedSessionId: string) => Promise<VoiceConversationContext>;
-    getSessionIdentity?: (sessionKey: string) => Promise<string | undefined>;
-    getConfig: () => Config;
-    sessionExists: (sessionKey: string) => Promise<boolean>;
-    sessionBusy: (sessionKey: string) => boolean;
-    runAgent: (text: string, sessionKey: string, signal: AbortSignal) => AsyncIterable<VoiceAgentEvent>;
-    recordInterruption: (entry: {
-        sessionKey: string;
-        responseId: string;
-        reason: 'barge_in' | 'client_cancelled';
-        generatedCharacters: number;
-        interruptedDuring: 'thinking' | 'speaking';
-    }) => Promise<void>;
-}
 export declare function resolveStreamingStt(config: Config, language?: string): ResolvedStreamingStt | undefined;
 export declare function resolveStreamingTts(config: Config): ResolvedStreamingTts | undefined;
 export declare class VoiceRealtimeRuntime {
@@ -96,4 +32,3 @@ export declare class VoiceRealtimeRuntime {
     private pruneTickets;
     private handleConnection;
 }
-export {};

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

@@ -0,0 +1,69 @@
+import type { CreateVoiceSessionRequest, VoiceProviderRoute } from '@xopcai/realtime-protocol/voice';
+import type { Config } from '../../config/schema.js';
+import type { MediaUnderstandingProvider } from '../../media-understanding/types.js';
+import type { ResolvedSpeechProvider } from '../tts/factory.js';
+import type { TTSConfig } from '../tts/types.js';
+import type { VoiceConversationContext } from './conversation-context.js';
+import type { OmniTranscript } from './omniEngine.js';
+import type { OmniRoute } from './omniRoute.js';
+export interface ResolvedStreamingStt {
+    plugin: MediaUnderstandingProvider & Required<Pick<MediaUnderstandingProvider, 'openAudioStream' | 'streamingAudio'>>;
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    language?: string;
+    prompt?: string;
+    route: VoiceProviderRoute;
+}
+export interface VoiceTicketClaim {
+    sessionId: string;
+    principalId: string;
+    request: CreateVoiceSessionRequest;
+    inputMode: 'server_vad';
+    idleTimeoutMs: number;
+    maxSessionMs: number;
+    silenceDurationMs: number;
+    stt?: ResolvedStreamingStt;
+    omni?: OmniRoute;
+    conversationSessionId?: string;
+    tts?: ResolvedStreamingTts;
+    config: Config;
+    createdAt: number;
+    expiresAt: number;
+}
+export interface ResolvedStreamingTts {
+    provider: ResolvedSpeechProvider;
+    config: TTSConfig;
+    route: VoiceProviderRoute;
+}
+interface VoiceAgentEvent {
+    type: string;
+    payload?: {
+        delta?: unknown;
+        message?: unknown;
+        status?: unknown;
+        toolCallId?: unknown;
+        toolName?: unknown;
+        requestId?: unknown;
+        question?: unknown;
+        choices?: unknown;
+    };
+}
+export interface VoiceRealtimeRuntimeOptions {
+    recordOmniTranscript?: (sessionKey: string, callId: string, entry: OmniTranscript, expectedSessionId: string) => Promise<void>;
+    getConversationContext?: (sessionKey: string, expectedSessionId: string) => Promise<VoiceConversationContext>;
+    getSessionIdentity?: (sessionKey: string) => Promise<string | undefined>;
+    getConfig: () => Config;
+    sessionExists: (sessionKey: string) => Promise<boolean>;
+    sessionBusy: (sessionKey: string) => boolean;
+    runAgent: (text: string, sessionKey: string, signal: AbortSignal) => AsyncIterable<VoiceAgentEvent>;
+    recordInterruption: (entry: {
+        sessionKey: string;
+        responseId: string;
+        reason: 'barge_in' | 'client_cancelled';
+        generatedCharacters: number;
+        interruptedDuring: 'thinking' | 'speaking';
+    }) => Promise<void>;
+}
+export {};

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

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.244",
+  "version": "0.0.246",
   "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",
@@ -164,9 +164,9 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0",
     "@xopcai/realtime-client": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0"
+    "@xopcai/gateway-contract": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",