@xopcai/xopc 0.0.232 → 0.0.234

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

@@ -6,6 +6,7 @@ import "../../../storage/sqlite/index.js";
 import { listUserFocuses, updateUserFocus } from "../../../user-context/sources/repository.js";
 import { canonicalUnderstandingKey, findDuplicateUnderstanding } from "../../../user-context/understanding.js";
 import { listContextObjects } from "../../../user-context/context-objects.js";
+import { deleteUserAvatar, readUserAvatar, writeUserAvatar } from "../../../user-context/user-avatar.js";
 import { repairExtractedContext } from "../../../user-context/extraction/repair.js";
 import { getUserRelationship, listUserRelationships, mergeUserRelationships, patchUserRelationship } from "../../../user-context/relationships/service.js";
 import { USER_PERSON_KINDS } from "../../../user-context/relationships/types.js";
@@ -95,6 +96,29 @@ function machineCallName() {
 }
 function registerYouRoutes(authenticated, deps) {
 	const write = deps.strictRateLimitMiddleware;
+	authenticated.get("/api/you/avatar", async (c) => {
+		const result = await readUserAvatar();
+		if (result.ok === false) return c.json({ error: result.error }, result.status);
+		return new Response(result.data.buffer, {
+			status: 200,
+			headers: {
+				"Content-Type": result.data.contentType,
+				"Cache-Control": "private, no-store"
+			}
+		});
+	});
+	authenticated.put("/api/you/avatar", write, async (c) => {
+		const body = await readBody(c);
+		if (!body) return c.json({ error: "Invalid JSON" }, 400);
+		const result = await writeUserAvatar(typeof body.base64 === "string" ? body.base64 : "", typeof body.mimeType === "string" ? body.mimeType : "");
+		if (result.ok === false) return c.json({ error: result.error }, result.status);
+		return c.json({ ok: true });
+	});
+	authenticated.delete("/api/you/avatar", write, async (c) => {
+		const result = await deleteUserAvatar();
+		if (result.ok === false) return c.json({ error: result.error }, result.status);
+		return c.json({ ok: true });
+	});
 	authenticated.get("/api/you", (c) => c.json({
 		profile: getUserProfile(),
 		understandings: listUnderstandings(),

package/dist/src/gateway/service/config-coordinator.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getModelRegistry } from "../../providers/model-registry.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { init_providers } from "../../providers/index.js";
 import { disposeAllSessionMcpRuntimes } from "../../agent/mcp/bundle-mcp-runtime.js";
 import { reloadImageGenerationProviders } from "../../agent/image/generation/provider-registry.js";

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

@@ -13,7 +13,6 @@ import { ChatStreamMapper } from "../chat-stream/mapper.js";
 import { resolveWebchatSessionKey } from "../resolve-webchat-session-key.js";
 import { recordExplicitRelationshipFollowUp } from "../../user-context/relationship-continuity.js";
 import { coalesceThinkingDeltas } from "../chat-stream/thinking-delta-coalescer.js";
-import { TurnOutcomeCollector } from "../chat-stream/turn-outcome-collector.js";
 import crypto from "crypto";
 //#region src/gateway/service/run-gateway-agent.ts
 init_logger();
@@ -39,7 +38,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 	let webchatSessionKey;
 	let webchatSessionId;
 	let webchatMetadata;
-	let outcomeEnvironment = "workspace";
 	if (channel === "webchat") {
 		const resolved = resolveWebchatSessionKey({ sessionKey: chatId });
 		if (resolved.ok === false) throw new Error(resolved.error);
@@ -68,8 +66,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 			channel,
 			metadata: webchatMetadata
 		});
-		if (/remote/i.test(executionContext.strategy ?? "")) outcomeEnvironment = "remote_runtime";
-		else if (/worktree/i.test(executionContext.strategy ?? "")) outcomeEnvironment = "worktree";
 		taskRun = TaskRunCoordinator.start({
 			runId,
 			context: executionContext,
@@ -81,11 +77,8 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 		sessionKey: streamSessionKey,
 		channel
 	});
-	const outcomeCollector = new TurnOutcomeCollector(runId, outcomeEnvironment);
-	let outcomeFinalized = false;
 	let registeredActiveWebchatRun = false;
 	const captureTaskEvent = (event) => {
-		outcomeCollector.capture(event);
 		if (event.type === "task_plan_updated") {
 			taskRun?.capturePlan(event.payload.items);
 			return;
@@ -110,30 +103,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 			yield event;
 		}
 	};
-	const finalizeOutcome = async (status, summary) => {
-		if (outcomeFinalized) return [];
-		outcomeFinalized = true;
-		const outcome = outcomeCollector.finalize(status, summary);
-		if (webchatSessionKey) try {
-			await sessionIndex.appendTranscriptCustomEntry(webchatSessionKey, {
-				customType: "turn_outcome",
-				data: outcome
-			});
-		} catch (err) {
-			log.warn({
-				err,
-				runId,
-				sessionKey: webchatSessionKey
-			}, `Turn outcome persistence failed: ${err instanceof Error ? err.message : String(err)}`);
-		}
-		return [{
-			type: "turn_outcome",
-			runId,
-			sessionKey: streamSessionKey,
-			timestamp: Date.now(),
-			payload: outcome
-		}];
-	};
 	try {
 		yield* emitAndYield(mapper.start());
 		if (channel === "webchat" && webchatSessionKey) {
@@ -173,7 +142,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 				taskRunStatus = mergedSignal.aborted ? "cancelled" : "succeeded";
 				terminalStatus = endStatus;
 				taskRunSummary = endSummary;
-				yield* emitAndYield(await finalizeOutcome(endStatus, endSummary));
 				yield* emitAndYield(mapper.end(endStatus, endSummary));
 				completeRealtimeTopic(`run:${runId}`);
 				runTopicCompleted = true;
@@ -197,7 +165,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 				taskRunSummary = em;
 				const errorContent = formatAgentRunErrorForClient(streamError);
 				yield* emitAndYield(mapper.error(errorContent));
-				yield* emitAndYield(await finalizeOutcome("error", streamError));
 				yield* emitAndYield(mapper.end("error", streamError));
 				completeRealtimeTopic(`run:${runId}`);
 				runTopicCompleted = true;
@@ -283,7 +250,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 				presentation: "answer"
 			}
 		}]);
-		yield* emitAndYield(await finalizeOutcome("success", "Message processed"));
 		yield* emitAndYield(mapper.end("success", "Message processed"));
 		taskRunStatus = "succeeded";
 		taskRunSummary = "Message processed";
@@ -306,7 +272,6 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 		}, `Agent run failed: ${em}`);
 		if (channel === "webchat" && !runTopicCompleted) {
 			yield* emitAndYield(mapper.error(formatAgentRunErrorForClient(em)));
-			yield* emitAndYield(await finalizeOutcome("error", em));
 			yield* emitAndYield(mapper.end("error", em));
 			completeRealtimeTopic(`run:${runId}`);
 			runTopicCompleted = true;

package/dist/src/gateway/service.js

@@ -9,14 +9,14 @@ import { closeXopcDatabase, openXopcDatabase } from "../storage/sqlite/connectio
 import "../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentDir, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
 import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
 import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, init_channel_catalog_service } from "../channels/catalog/channel-catalog-service.js";
 import { loadConfig, saveConfig } from "../config/loader.js";
-import { prewarmModelRegistry } from "../providers/model-registry.js";
+import { buildSessionKey, init_session_key, sanitizeSegment } from "../routing/session-key.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";

package/dist/src/media/store.js

@@ -17,6 +17,15 @@ const MIME_BY_EXT = {
 	".svg": "image/svg+xml",
 	".svgz": "image/svg+xml",
 	".pdf": "application/pdf",
+	".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	".doc": "application/msword",
+	".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	".xls": "application/vnd.ms-excel",
+	".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+	".ppt": "application/vnd.ms-powerpoint",
+	".csv": "text/csv",
+	".tsv": "text/tab-separated-values",
+	".zip": "application/zip",
 	".txt": "text/plain",
 	".md": "text/markdown",
 	".json": "application/json",

package/dist/src/providers/auth-runtime/resolve-auth.js

@@ -1,5 +1,5 @@
-import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
+import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getDefaultAuthProfileStore } from "./auth-profile-store.js";
 //#region src/providers/auth-runtime/resolve-auth.ts
 init_env_keys();

package/dist/src/providers/index.js

@@ -1,11 +1,11 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { getModelOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { init_model_ref, splitProviderModelRef } from "./model-ref.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
+import { getModelOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
 import { CredentialResolver, hasCredentials, init_credentials } from "../auth/credentials.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { EXTENSION_PROVIDER_BASE_URL, init_constants } from "./constants.js";
 import { applyOfficialModelMetadataCorrections, getSupplementalModels, init_model_supplements } from "./model-supplements.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";

package/dist/src/providers/model-registry.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../config/paths.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";

package/dist/src/providers/register-runtime-providers.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
+import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/session/store.js

@@ -19,6 +19,7 @@ import { promoteCompactionLedger } from "../agent/memory/compaction-promotion.js
 import { SlidingWindow } from "../agent/memory/window.js";
 import { isAppendOnlyLlmTranscriptMessage } from "./transcript-stats.js";
 import { transcriptRowsToClientHistory } from "./client-history.js";
+import { backfillStructuredTurnOutcomes } from "./turn-outcome-projector.js";
 import { computeTranscriptUserRoundDeleteRange } from "./user-round-delete.js";
 //#region src/session/store.ts
 init_paths_state();
@@ -604,7 +605,8 @@ var SessionStore = class {
 				routing: metadata.routing,
 				customData: metadata.customData
 			});
-			replaceTranscriptRows(targetKey, rows);
+			const normalizedRows = backfillStructuredTurnOutcomes(rows);
+			replaceTranscriptRows(targetKey, normalizedRows);
 			const sourceKey = typeof metadata.key === "string" ? metadata.key : void 0;
 			const sourceName = typeof metadata.name === "string" ? metadata.name.trim() : "";
 			patchSessionMetadata(targetKey, {
@@ -618,7 +620,7 @@ var SessionStore = class {
 			});
 			return {
 				sessionKey: targetKey,
-				rowCount: rows.length
+				rowCount: normalizedRows.length
 			};
 		});
 	}

package/dist/src/session/turn-outcome-projector.d.ts

@@ -0,0 +1,9 @@
+import { type TurnOutcome } from '@xopcai/gateway-contract';
+import type { TranscriptStoredRow } from './session-context-for-llm.js';
+export declare function projectTurnOutcome(params: {
+    rows: readonly TranscriptStoredRow[];
+    turnId: string;
+    runStatus?: 'success' | 'cancelled' | 'error';
+    summary?: string;
+}): TurnOutcome;
+export declare function backfillStructuredTurnOutcomes(rows: readonly TranscriptStoredRow[]): TranscriptStoredRow[];

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

@@ -0,0 +1,209 @@
+import { TurnOutcomeDeliverableSchema, fileResourceArtifactUri, parseTurnOutcome, turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../packages/gateway-contract/src/turn-outcome.js";
+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;
+}
+function text(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function fileStatus(kind) {
+	if (kind === "add") return "added";
+	if (kind === "delete") return "deleted";
+	if (kind === "move") return "renamed";
+	if (kind === "update") return "modified";
+}
+function fileDeliverable(reference, failed) {
+	if (reference.kind !== "file") return null;
+	let workspaceRelativePath;
+	let managedFile = false;
+	try {
+		workspaceRelativePath = parseFileResourceId(reference.id).relativePath;
+		managedFile = true;
+	} catch {}
+	const mimeType = turnOutcomeMimeTypeFromFileName(reference.title);
+	const available = !failed && managedFile;
+	return {
+		artifactId: reference.id,
+		title: reference.title,
+		kind: turnOutcomeKindFromFileName(reference.title),
+		...mimeType ? { mimeType } : {},
+		availability: failed ? "failed" : available ? "available" : "missing",
+		location: managedFile ? "workspace" : "external_host",
+		capabilities: !available ? ["regenerate"] : [
+			...reference.capabilities.includes("preview") ? ["preview"] : [],
+			"download",
+			...reference.capabilities.includes("share") ? ["share"] : []
+		],
+		...available ? { uri: fileResourceArtifactUri(reference.id) } : {},
+		...workspaceRelativePath ? { workspaceRelativePath } : {}
+	};
+}
+function mediaDeliverables(details) {
+	if (!Array.isArray(details.media)) return [];
+	return details.media.flatMap((value) => {
+		const media = record(value);
+		const uri = text(media?.uri);
+		if (!uri) return [];
+		const artifactId = text(media?.id) ?? uri;
+		const title = text(media?.name) ?? "Generated file";
+		const rawType = text(media?.type);
+		const kind = rawType === "photo" || rawType === "image" ? "image" : rawType === "video" ? "video" : rawType === "audio" || rawType === "voice" ? "audio" : turnOutcomeKindFromFileName(title);
+		return [{
+			artifactId,
+			title,
+			kind,
+			...text(media?.mimeType) ? { mimeType: text(media?.mimeType) } : {},
+			...typeof media?.size === "number" && media.size >= 0 ? { sizeBytes: media.size } : {},
+			availability: "available",
+			location: "artifact_store",
+			capabilities: kind === "archive" || kind === "file" ? ["download"] : ["preview", "download"],
+			uri
+		}];
+	});
+}
+function projectTurnOutcome(params) {
+	const deliverables = /* @__PURE__ */ new Map();
+	const files = /* @__PURE__ */ new Map();
+	const evidence = /* @__PURE__ */ new Map();
+	const diffs = [];
+	let added = 0;
+	let removed = 0;
+	let failedToolCount = 0;
+	let createdAtMs = 0;
+	for (const source of params.rows) {
+		const row = source;
+		if (row.turnId !== params.turnId) continue;
+		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) ?? {};
+		const explicit = Array.isArray(details.artifacts) ? details.artifacts.flatMap((value) => {
+			const parsed = TurnOutcomeDeliverableSchema.safeParse(value);
+			return parsed.success ? [parsed.data] : [];
+		}) : [];
+		for (const item of explicit) deliverables.set(item.artifactId, item);
+		const delivery = parseProductDeliveryEnvelope(details.delivery);
+		if (delivery) for (const reference of [delivery.primary, ...delivery.related ?? []]) {
+			if (!reference) continue;
+			const item = fileDeliverable(reference, delivery.operation === "failed");
+			if (item) deliverables.set(item.artifactId, item);
+		}
+		for (const item of mediaDeliverables(details)) if (!deliverables.has(item.artifactId)) deliverables.set(item.artifactId, item);
+		if (row.toolName === "apply_patch") {
+			for (const value of Array.isArray(details.changes) ? details.changes : []) {
+				const change = record(value);
+				const path = text(change?.moveTo) ?? text(change?.path);
+				if (!path) continue;
+				files.set(path, {
+					path,
+					...fileStatus(change?.kind) ? { status: fileStatus(change?.kind) } : {},
+					...typeof change?.added === "number" ? { added: Math.max(0, change.added) } : {},
+					...typeof change?.removed === "number" ? { removed: Math.max(0, change.removed) } : {}
+				});
+			}
+			if (text(details.diff)) diffs.push(text(details.diff));
+			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 toolCallId = text(row.toolCallId) ?? `check-${evidence.size + 1}`;
+			const command = text(details.command);
+			evidence.set(toolCallId, {
+				evidenceId: `${params.turnId}:${toolCallId}:check`,
+				kind: "check",
+				label: command,
+				status: details.exitCode === 0 && details.timedOut !== true ? "passed" : "failed",
+				command,
+				...typeof details.durationMs === "number" ? { durationMs: Math.max(0, details.durationMs) } : {}
+			});
+		}
+	}
+	const evidenceItems = [...evidence.values()];
+	const artifactItems = [...deliverables.values()];
+	const partial = failedToolCount > 0 || evidenceItems.some((item) => item.status === "failed") || artifactItems.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();
+	return {
+		version: 1,
+		outcomeId: `${params.turnId}:outcome`,
+		runId: params.turnId,
+		turnId: params.turnId,
+		status: params.runStatus === "error" ? "failed" : params.runStatus === "cancelled" || partial ? "partial" : "succeeded",
+		...params.summary?.trim() ? { summary: params.summary.trim() } : {},
+		deliverables: artifactItems,
+		...files.size > 0 || diffs.length > 0 ? { changeSet: {
+			changeSetId: `${params.turnId}:changes`,
+			files: [...files.values()],
+			added,
+			removed,
+			diff: diffTruncated ? diff.slice(0, MAX_OUTCOME_DIFF_CHARS) : diff,
+			...diffTruncated ? { diffTruncated: true } : {},
+			environment: "workspace"
+		} } : {},
+		evidence: evidenceItems,
+		createdAt
+	};
+}
+function backfillStructuredTurnOutcomes(rows) {
+	const existing = /* @__PURE__ */ new Map();
+	const lastIndex = /* @__PURE__ */ new Map();
+	for (const [index, source] of rows.entries()) {
+		const row = source;
+		if (row.type === "custom" && row.customType === "turn_outcome") {
+			const outcome = parseTurnOutcome(row.data);
+			if (outcome) existing.set(outcome.turnId, outcome);
+		}
+		if (typeof row.turnId === "string" && row.turnId) lastIndex.set(row.turnId, index);
+	}
+	const projected = /* @__PURE__ */ new Map();
+	for (const turnId of lastIndex.keys()) {
+		const outcome = projectTurnOutcome({
+			rows,
+			turnId
+		});
+		if (outcome.deliverables.length > 0) projected.set(turnId, outcome);
+	}
+	if (projected.size === 0) return [...rows];
+	const result = [];
+	for (const [index, source] of rows.entries()) {
+		const row = source;
+		if (row.type === "custom" && row.customType === "turn_outcome") {
+			const outcome = parseTurnOutcome(row.data);
+			const candidate = outcome ? projected.get(outcome.turnId) : void 0;
+			if (outcome && candidate) {
+				const merged = new Map(outcome.deliverables.map((item) => [item.artifactId, item]));
+				for (const item of candidate.deliverables) merged.set(item.artifactId, item);
+				const deliverables = [...merged.values()];
+				result.push({
+					...row,
+					data: {
+						...outcome,
+						deliverables,
+						status: outcome.status === "failed" ? "failed" : deliverables.some((item) => item.availability !== "available") ? "partial" : outcome.status
+					}
+				});
+				continue;
+			}
+		}
+		result.push(source);
+		const turnId = typeof row.turnId === "string" ? row.turnId : void 0;
+		if (!turnId || lastIndex.get(turnId) !== index) continue;
+		const outcome = projected.get(turnId);
+		if (!outcome || existing.has(turnId)) continue;
+		result.push({
+			type: "custom",
+			customType: "turn_outcome",
+			data: outcome,
+			timestamp: outcome.createdAt
+		});
+	}
+	return result;
+}
+//#endregion
+export { backfillStructuredTurnOutcomes, projectTurnOutcome };

package/dist/src/share/hosted-session-share.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths } from "../config/paths.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { init_paths } from "../config/paths.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { resolveMediaReference } from "../media/media-reference.js";
 import { projectSessionShare } from "./session-share-projector.js";

package/dist/src/storage/sqlite/endpoint-session-binding-repository.d.ts

@@ -0,0 +1,8 @@
+export interface StoredEndpointSessionBinding {
+    sessionKey: string;
+    endpointId: string;
+    boundAt: number;
+}
+export declare function getEndpointSessionBinding(sessionKey: string): StoredEndpointSessionBinding | undefined;
+export declare function setEndpointSessionBinding(binding: StoredEndpointSessionBinding): StoredEndpointSessionBinding;
+export declare function deleteEndpointSessionBinding(sessionKey: string): boolean;

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

@@ -0,0 +1,32 @@
+import { getSqliteDatabase } from "./transaction.js";
+//#region src/storage/sqlite/endpoint-session-binding-repository.ts
+function fromRow(row) {
+	return {
+		sessionKey: row.session_key,
+		endpointId: row.endpoint_id,
+		boundAt: row.bound_at
+	};
+}
+function getEndpointSessionBinding(sessionKey) {
+	const row = getSqliteDatabase().prepare(`
+    SELECT session_key, endpoint_id, bound_at
+    FROM endpoint_session_bindings
+    WHERE session_key = ?
+  `).get(sessionKey);
+	return row ? fromRow(row) : void 0;
+}
+function setEndpointSessionBinding(binding) {
+	getSqliteDatabase().prepare(`
+    INSERT INTO endpoint_session_bindings (session_key, endpoint_id, bound_at)
+    VALUES (?, ?, ?)
+    ON CONFLICT(session_key) DO UPDATE SET
+      endpoint_id = excluded.endpoint_id,
+      bound_at = excluded.bound_at
+  `).run(binding.sessionKey, binding.endpointId, binding.boundAt);
+	return binding;
+}
+function deleteEndpointSessionBinding(sessionKey) {
+	return getSqliteDatabase().prepare("DELETE FROM endpoint_session_bindings WHERE session_key = ?").run(sessionKey).changes > 0;
+}
+//#endregion
+export { deleteEndpointSessionBinding, getEndpointSessionBinding, setEndpointSessionBinding };

package/dist/src/storage/sqlite/index.d.ts

@@ -5,6 +5,7 @@ export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './m
 export { discoverSqlMigrations, listRegisteredMigrationTargets } from './migrations/discover.js';
 export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest, type OpenXopcDatabaseOptions, type XopcDatabase, } from './connection.js';
 export { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';
+export { deleteEndpointSessionBinding, getEndpointSessionBinding, setEndpointSessionBinding, type StoredEndpointSessionBinding, } from './endpoint-session-binding-repository.js';
 export { authenticateDeviceAccessToken, buildRefreshProofMessage, createDevice, getDevice, issueDeviceTokenPair, listDevices, revokeDevice, rotateDeviceRefreshToken, type DeviceAccessIdentity, type DevicePlatform, type DevicePublicKeyJwk, type DeviceRecord, type DeviceTokenPair, } from './device-access-repository.js';
 export { clearGatewayIdentityForTest, getOrCreateGatewayIdentity, signGatewayPayload, type GatewayIdentity, } from './gateway-identity-repository.js';
 export { consumeDevicePairingToken, createDevicePairingSetup, isDevicePairingSetupActive, type DevicePairingSetup, type DeviceRoute, type PairingConsumeResult, } from './device-pairing-repository.js';

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

@@ -6,6 +6,7 @@ import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMi
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { deleteEndpointSessionBinding, getEndpointSessionBinding, setEndpointSessionBinding } from "./endpoint-session-binding-repository.js";
 import { authenticateDeviceAccessToken, buildRefreshProofMessage, createDevice, getDevice, issueDeviceTokenPair, listDevices, revokeDevice, rotateDeviceRefreshToken } from "./device-access-repository.js";
 import { clearGatewayIdentityForTest, getOrCreateGatewayIdentity, signGatewayPayload } from "./gateway-identity-repository.js";
 import { consumeDevicePairingToken, createDevicePairingSetup, isDevicePairingSetupActive } from "./device-pairing-repository.js";
@@ -39,4 +40,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getConnectorAccount, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy } from "./connector-sync-policy-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, consumeDevicePairingToken, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getDevice, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, linkUnderstandingEvidence, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandingStatusEvents, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, signGatewayPayload, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, consumeDevicePairingToken, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, linkUnderstandingEvidence, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandingStatusEvents, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, signGatewayPayload, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };