@xopcai/xopc 0.0.217 → 0.0.219

package/dist/src/gateway/service/session-input-coordinator.js

@@ -1,14 +1,22 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "../../storage/sqlite/session-input-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "../../storage/sqlite/session-input-repository.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "../../storage/sqlite/session-turn-replace-repository.js";
 import "../../storage/sqlite/index.js";
+import { summarizeSourceContext } from "../../agent/source-context/types.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../media/session-references.js";
 import crypto from "node:crypto";
 //#region src/gateway/service/session-input-coordinator.ts
 init_logger();
 const log = createLogger("SessionInputCoordinator");
 const MAX_PENDING_INPUTS = 10;
+function contextRefsMatchFrozenSnapshot(requested, frozen) {
+	if (requested.length !== (frozen?.length ?? 0)) return false;
+	return requested.every((ref, index) => {
+		const snapshot = frozen?.[index];
+		return snapshot?.kind === ref.kind && snapshot.sourceId === ref.sourceId && ref.expectedVersion === snapshot.version;
+	});
+}
 var SessionInputCoordinator = class {
 	draining = /* @__PURE__ */ new Set();
 	submissionTails = /* @__PURE__ */ new Map();
@@ -69,12 +77,27 @@ var SessionInputCoordinator = class {
 			if (target.ok === false) return target;
 			await beforeReplace();
 			const attachments = await this.deps.prepareAttachments(sessionKey, input.attachments);
+			let sourceContexts;
+			try {
+				sourceContexts = await this.deps.prepareContexts(input.contextRefs);
+			} catch (err) {
+				log.warn({
+					err,
+					sessionKey
+				}, "Session input context preparation failed");
+				return {
+					ok: false,
+					code: "CONTEXT_UNAVAILABLE"
+				};
+			}
 			const result = replaceLatestSessionTurnAndQueueInput({
 				sessionKey,
 				targetTurnId,
 				clientMessageId,
 				content,
 				attachments,
+				contextRefs: sourceContexts?.map(summarizeSourceContext),
+				contextSnapshots: sourceContexts,
 				thinking: input.thinking,
 				origin: input.origin
 			});
@@ -121,8 +144,21 @@ var SessionInputCoordinator = class {
 			code: "QUEUE_FULL"
 		};
 		const attachments = await this.deps.prepareAttachments(sessionKey, input.attachments);
+		let sourceContexts;
+		try {
+			sourceContexts = await this.deps.prepareContexts(input.contextRefs);
+		} catch (err) {
+			log.warn({
+				err,
+				sessionKey
+			}, "Session input context preparation failed");
+			return {
+				ok: false,
+				code: "CONTEXT_UNAVAILABLE"
+			};
+		}
 		const runtime = this.snapshot(sessionKey);
-		const canSteer = input.origin.type !== "endpoint" && input.delivery === "steer" && runtime.activeRunId !== void 0 && !attachments?.length;
+		const canSteer = input.origin.type !== "endpoint" && input.delivery === "steer" && runtime.activeRunId !== void 0 && !attachments?.length && !sourceContexts?.length;
 		const effectiveDelivery = canSteer ? "steer" : "next";
 		const row = insertSessionInput({
 			id: crypto.randomUUID(),
@@ -133,6 +169,8 @@ var SessionInputCoordinator = class {
 			status: canSteer ? "injecting" : "queued",
 			content,
 			attachments,
+			contextRefs: sourceContexts?.map(summarizeSourceContext),
+			contextSnapshots: sourceContexts,
 			thinking: input.thinking,
 			origin: input.origin,
 			targetRunId: canSteer ? runtime.activeRunId : void 0
@@ -179,6 +217,7 @@ var SessionInputCoordinator = class {
 						sessionKey,
 						content: input.content,
 						attachments: input.attachments,
+						sourceContexts: input.contextSnapshots,
 						thinking: input.thinking,
 						origin: input.origin
 					});
@@ -204,11 +243,31 @@ var SessionInputCoordinator = class {
 	}
 	async update(sessionKey, id, body) {
 		const attachments = body.attachments === void 0 ? void 0 : await this.deps.prepareAttachments(sessionKey, body.attachments);
+		let sourceContexts;
+		if (body.contextRefs !== void 0) {
+			const existing = getSessionInputById(sessionKey, id);
+			if (!contextRefsMatchFrozenSnapshot(body.contextRefs, existing?.contextRefs)) try {
+				sourceContexts = await this.deps.prepareContexts(body.contextRefs) ?? [];
+			} catch (err) {
+				log.warn({
+					err,
+					sessionKey,
+					inputId: id
+				}, "Queued input context preparation failed");
+				return {
+					ok: false,
+					contextUnavailable: true,
+					state: this.snapshot(sessionKey)
+				};
+			}
+		}
 		const ok = mutateQueuedSessionInput({
 			sessionKey,
 			id,
 			...body,
-			attachments
+			attachments,
+			contextRefs: sourceContexts?.map(summarizeSourceContext),
+			contextSnapshots: sourceContexts
 		});
 		return {
 			ok,

package/dist/src/gateway/service/sessions-api.d.ts

@@ -93,6 +93,7 @@ export declare class GatewaySessionsApi {
         verboseLevel?: string;
         workingDirectory?: string;
         responseLanguage?: string | null;
+        userContextMode?: 'enabled' | 'off' | 'temporary';
     }): Promise<import("../../agent/session/session-config-service.js").PatchSessionAgentConfigResult>;
     listCompactionBoundaries(key: string): Promise<import("../../session/types.js").CompactionBoundarySummary[]>;
     restoreBeforeCompactionBoundary(key: string, compactionId: string): Promise<void>;

package/dist/src/gateway/service.d.ts

@@ -139,7 +139,7 @@ export declare class GatewayService {
         state: import("../storage/sqlite/session-input-repository.js").SessionInputState;
     } | {
         ok: false;
-        code: "BAD_REQUEST" | "QUEUE_FULL";
+        code: "BAD_REQUEST" | "QUEUE_FULL" | "CONTEXT_UNAVAILABLE";
     }>;
     replaceLatestSessionTurn(...args: Parameters<GatewayAgentRunner['replaceLatestSessionTurn']>): Promise<{
         ok: true;
@@ -147,12 +147,13 @@ export declare class GatewayService {
         state: import("../storage/sqlite/session-input-repository.js").SessionInputState;
     } | {
         ok: false;
-        code: "BAD_REQUEST" | "TARGET_NOT_FOUND" | "NOT_LATEST" | "SESSION_BUSY";
+        code: "BAD_REQUEST" | "TARGET_NOT_FOUND" | "NOT_LATEST" | "SESSION_BUSY" | "CONTEXT_UNAVAILABLE";
     }>;
     getSessionInputState(...args: Parameters<GatewayAgentRunner['getSessionInputState']>): import("../storage/sqlite/session-input-repository.js").SessionInputState;
     updateSessionInput(...args: Parameters<GatewayAgentRunner['updateSessionInput']>): Promise<{
         ok: boolean;
         state: import("../storage/sqlite/session-input-repository.js").SessionInputState;
+        contextUnavailable?: boolean;
     }>;
     removeSessionInput(...args: Parameters<GatewayAgentRunner['removeSessionInput']>): {
         ok: boolean;

package/dist/src/gateway/service.js

@@ -369,6 +369,18 @@ var GatewayService = class {
 			getAgentService: () => this.ensureAgentService(),
 			getChannelManager: () => this.channelManager,
 			getConfig: () => this.config,
+			resolveTurnContext: async (ref) => {
+				if (ref.kind !== "note") return null;
+				const note = await this.notesService.getNote(ref.sourceId);
+				if (!note || note.status === "trashed") return null;
+				if (ref.expectedVersion && ref.expectedVersion !== String(note.updatedAt)) return null;
+				const { images: _images, ...snapshot } = await buildNoteAgentContext({
+					note,
+					notesService: this.notesService,
+					config: this.config
+				});
+				return snapshot;
+			},
 			emit: (type, payload) => this.emit(type, payload),
 			publishRealtime: (topic, event, data) => {
 				this.realtime.broker.publish(topic, event, data);
@@ -1161,8 +1173,9 @@ var GatewayService = class {
 	* PATCH saves update config in memory without re-running gateway startup, so this must run on save too.
 	*/
 	async reconcileBrowserExtensionServer() {
-		const { shouldRunExtensionBridgeServer } = await import("../browser/backend-from-config.js");
-		if (!shouldRunExtensionBridgeServer(this.config)) {
+		const { resolveExtensionBridgeServerConfig } = await import("../browser/backend-from-config.js");
+		const bridgeConfig = resolveExtensionBridgeServerConfig(this.config);
+		if (!bridgeConfig) {
 			if (this.browserExtensionRelease) {
 				await this.browserExtensionRelease();
 				this.browserExtensionRelease = null;
@@ -1172,10 +1185,7 @@ var GatewayService = class {
 			}
 			return;
 		}
-		const port = 19820;
-		const host = "127.0.0.1";
-		const connectionTimeout = void 0;
-		const commandTimeout = void 0;
+		const { port, host, connectionTimeout, commandTimeout } = bridgeConfig;
 		const bindKey = `${host}:${port}`;
 		if (this.browserExtensionRelease && this.browserExtensionBindKey === bindKey) return;
 		if (this.browserExtensionRelease) {

package/dist/src/gateway/user-turn-input.d.ts

@@ -1,4 +1,5 @@
 import type { MediaRef } from '../media/types.js';
+import type { TurnContextRef } from '../agent/source-context/types.js';
 export interface UserTurnAttachment {
     id?: string;
     type: string;
@@ -13,5 +14,6 @@ export interface UserTurnAttachment {
 export interface UserTurnInput {
     text: string;
     attachments?: UserTurnAttachment[];
+    contextRefs?: TurnContextRef[];
 }
 export declare function mediaRefsToUserTurnAttachments(media: MediaRef[] | undefined): UserTurnAttachment[] | undefined;

package/dist/src/gateway/xopc-cloud-capability-setup.d.ts

@@ -1,7 +1,8 @@
 import type { Config } from '../config/schema.js';
 import type { CatalogSource } from '../providers/model-catalog-store.js';
-type CloudCapability = 'vision' | 'image-generation' | 'stt' | 'tts';
+type CloudCapability = 'chat' | 'vision' | 'image-generation' | 'stt' | 'tts';
 export interface XopcCloudCapabilitySelection {
+    chat: string;
     vision: string;
     imageGeneration: string;
     stt: string;
@@ -29,7 +30,7 @@ export declare function selectXopcCloudCapabilities(source: CatalogSource): {
     selection?: XopcCloudCapabilitySelection;
     missing: CloudCapability[];
 };
-/** Build one atomic config update for every managed XOPC Cloud media capability. */
+/** Build one atomic config update for the managed XOPC Cloud chat and media capabilities. */
 export declare function prepareXopcCloudCapabilitySetup(config: Config, source: CatalogSource): PrepareXopcCloudCapabilitySetupResult;
 export declare function applyXopcCloudCapabilitySetup(service: {
     currentConfig: Config;

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

@@ -5,29 +5,33 @@ import { ensureGlobalDefaultsConfig, prepareUpdateGlobalDefaults } from "./globa
 init_model_catalog_store();
 function supportsCapability(model, capability) {
 	if (model.availability !== "available") return false;
+	if (capability === "chat") return model.kind === "language" && (model.operations.includes("chat.completions") || model.operations.includes("responses"));
 	if (capability === "vision") return model.kind === "language" && model.input.includes("image");
 	if (capability === "image-generation") return model.kind === "image" && model.operations.includes("images.generate");
 	if (capability === "stt") return model.kind === "stt" && model.operations.includes("audio.transcription");
 	return model.kind === "tts" && model.operations.includes("audio.speech") && Boolean(model.tts?.defaultVoice);
 }
 function recommendedModel(source, capability) {
-	const recommendation = source.recommended?.[capability];
+	const recommendation = capability === "chat" ? source.recommendedModel ?? void 0 : source.recommended?.[capability];
 	return source.models.filter((model) => supportsCapability(model, capability)).sort((left, right) => compareCatalogModels(left, right, recommendation))[0];
 }
 function selectXopcCloudCapabilities(source) {
+	const chat = recommendedModel(source, "chat");
 	const vision = recommendedModel(source, "vision");
 	const imageGeneration = recommendedModel(source, "image-generation");
 	const stt = recommendedModel(source, "stt");
 	const tts = recommendedModel(source, "tts");
 	const missing = [];
+	if (!chat) missing.push("chat");
 	if (!vision) missing.push("vision");
 	if (!imageGeneration) missing.push("image-generation");
 	if (!stt) missing.push("stt");
 	if (!tts) missing.push("tts");
-	if (!vision || !imageGeneration || !stt || !tts || !tts.tts?.defaultVoice) return { missing };
+	if (!chat || !vision || !imageGeneration || !stt || !tts || !tts.tts?.defaultVoice) return { missing };
 	return {
 		missing,
 		selection: {
+			chat: chat.id,
 			vision: vision.id,
 			imageGeneration: imageGeneration.id,
 			stt: stt.id,
@@ -36,7 +40,7 @@ function selectXopcCloudCapabilities(source) {
 		}
 	};
 }
-/** Build one atomic config update for every managed XOPC Cloud media capability. */
+/** Build one atomic config update for the managed XOPC Cloud chat and media capabilities. */
 function prepareXopcCloudCapabilitySetup(config, source) {
 	const selected = selectXopcCloudCapabilities(source);
 	if (!selected.selection) return {
@@ -48,8 +52,17 @@ function prepareXopcCloudCapabilitySetup(config, source) {
 	const normalized = ensureGlobalDefaultsConfig(config);
 	const presetId = normalized.agents.defaultPreset;
 	const currentModels = normalized.agents.capabilityPresets[presetId]?.models;
+	const defaultRole = currentModels?.defaultRole ?? "deep";
 	const defaultsUpdate = prepareUpdateGlobalDefaults(normalized, { models: {
 		...currentModels,
+		defaultRole,
+		roles: {
+			...currentModels?.roles ?? {},
+			[defaultRole]: {
+				...currentModels?.roles?.[defaultRole],
+				model: `xopc-cloud/${selection.chat}`
+			}
+		},
 		imageModel: {
 			...currentModels?.imageModel,
 			primary: `xopc-cloud/${selection.vision}`

package/dist/src/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

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

@@ -1,4 +1,3 @@
-import { runPostUpdateExtensionSync } from "../extensions/update.js";
 import "./update-channels.js";
 import { compareSemver, resolveNpmChannelTag } from "./update-check.js";
 import { readPackageName, readPackageVersion } from "./package-json.js";
@@ -8,6 +7,7 @@ import { runGlobalPackageUpdateSteps } from "./package-update-steps.js";
 import { resolveStableNodePath } from "./stable-node-path.js";
 import { trimLogTail } from "./update-log.js";
 import { maybeRestartGatewayAfterUpdate } from "./update-restart.js";
+import { runPostUpdateExtensionSync } from "../extensions/update.js";
 import path from "node:path";
 import fs from "node:fs/promises";
 //#region src/infra/update-runner.ts

package/dist/src/knowledge/connected-understanding-pipeline.d.ts

@@ -13,5 +13,5 @@ export declare function renderConnectedObservation(observation: ClaimObservation
 export declare class ConnectedUnderstandingPipeline {
     private readonly memoryManager;
     constructor(memoryManager: MemoryManager);
-    process(agentId: string): Promise<UnderstandingReviewResult>;
+    process(agentId: string, extractionRunId: string): Promise<UnderstandingReviewResult>;
 }

package/dist/src/knowledge/connected-understanding-pipeline.js

@@ -226,7 +226,7 @@ var ConnectedUnderstandingPipeline = class {
 	constructor(memoryManager) {
 		this.memoryManager = memoryManager;
 	}
-	async process(agentId) {
+	async process(agentId, extractionRunId) {
 		const observations = deriveConnectedClaimObservations(listKnowledgeSourceItems({
 			agentId,
 			includeDeleted: false,
@@ -253,12 +253,14 @@ var ConnectedUnderstandingPipeline = class {
 					provider: "connected-sources",
 					...sourceInstanceIds.length === 1 ? { sourceInstanceId: sourceInstanceIds[0] } : {}
 				},
-				reviewSource: "background"
+				reviewSource: "background",
+				extractionRunId
 			});
 			totals.created += result.created;
 			totals.deduplicated += result.deduplicated;
 			totals.rejected += result.rejected;
 			totals.createdRecords.push(...result.createdRecords);
+			totals.writeOutputs = [...totals.writeOutputs ?? [], ...result.writeOutputs ?? []];
 		}
 		return totals;
 	}

package/dist/src/retrieval/queryProfile.d.ts

@@ -6,6 +6,7 @@ export interface RetrievalScope {
 }
 export interface RetrievalQueryProfile {
     normalized: string;
+    expanded: string;
     terms: string[];
     cjkBigrams: string[];
     identifiers: string[];

package/dist/src/retrieval/queryProfile.js

@@ -48,17 +48,25 @@ const TIME_RULES = [
 		pattern: /\b(?:future|next|later|upcoming)\b|未来|下次|之后|即将/i
 	}
 ];
+const TIME_EXPANSIONS = {
+	current: "now current active today 现在 当前 今天",
+	recent: "recent recently latest 近期 最近 最新",
+	historical: "previous before history past 之前 以前 历史 上次",
+	future: "future next later upcoming 未来 下次 之后 即将"
+};
 function buildRetrievalQueryProfile(query, scope = {}) {
 	const normalized = normalizeRetrievalText(query);
 	const intentKinds = INTENT_RULES.filter((rule) => rule.pattern.test(normalized)).flatMap((rule) => rule.kinds);
 	const timeHints = TIME_RULES.filter((rule) => rule.pattern.test(normalized)).map((rule) => rule.hint);
+	const uniqueTimeHints = [...new Set(timeHints)];
 	return {
 		normalized,
+		expanded: [normalized, ...uniqueTimeHints.map((hint) => TIME_EXPANSIONS[hint])].join(" ").trim(),
 		terms: extractLexicalTerms(normalized),
 		cjkBigrams: extractCjkBigrams(normalized),
 		identifiers: extractRetrievalIdentifiers(normalized),
 		intentKinds: [...new Set(intentKinds)],
-		timeHints: [...new Set(timeHints)],
+		timeHints: uniqueTimeHints,
 		scope: { ...scope }
 	};
 }

package/dist/src/session/client-history.d.ts

@@ -11,6 +11,17 @@ export interface ClientHistoryMessage {
     /** Persisted inbound attachment metadata used by chat clients to reload media. */
     media?: Message['media'];
     timestamp?: number;
+    /** Whitelisted display metadata; never includes source snapshot text. */
+    metadata?: {
+        sourceContexts: Array<{
+            kind: 'note';
+            sourceId: string;
+            version: string;
+            title: string;
+            tokenEstimate?: number;
+            truncated?: boolean;
+        }>;
+    };
     kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';
     tokensBefore?: number;
     tokensAfter?: number;

package/dist/src/session/client-history.js

@@ -1,5 +1,25 @@
+import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
 //#region src/session/client-history.ts
+function sourceContextDisplayMetadata(metadata) {
+	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return void 0;
+	const rows = metadata.sourceContexts;
+	if (!Array.isArray(rows)) return void 0;
+	const sourceContexts = rows.flatMap((value) => {
+		if (!value || typeof value !== "object" || Array.isArray(value)) return [];
+		const row = value;
+		if (row.kind !== "note" || typeof row.sourceId !== "string" || typeof row.version !== "string" || typeof row.title !== "string") return [];
+		return [{
+			kind: "note",
+			sourceId: row.sourceId,
+			version: row.version,
+			title: row.title,
+			...typeof row.tokenEstimate === "number" ? { tokenEstimate: row.tokenEstimate } : {},
+			...row.truncated === true ? { truncated: true } : {}
+		}];
+	});
+	return sourceContexts.length ? { sourceContexts } : void 0;
+}
 function flattenMessageContent(content) {
 	if (typeof content === "string") return content;
 	if (!Array.isArray(content)) return "";
@@ -111,8 +131,9 @@ function messagesToClientHistory(messages, opts) {
 			out.push({
 				role: m.role,
 				...typeof m.turnId === "string" ? { turnId: m.turnId } : {},
-				content: text,
+				content: m.role === "user" ? stripRuntimeContextFromUserMessage(text) : text,
 				...m.media?.length ? { media: m.media } : {},
+				...sourceContextDisplayMetadata(m.metadata) ? { metadata: sourceContextDisplayMetadata(m.metadata) } : {},
 				timestamp: parseTimestamp(m.timestamp)
 			});
 			continue;
@@ -413,8 +434,9 @@ function transcriptRowsToClientHistory(rows, opts) {
 				...messageRow.turnId ? { turnId: messageRow.turnId } : {},
 				role: messageRow.role,
 				kind: "message",
-				content: flattenMessageContent(messageRow.content ?? ""),
+				content: messageRow.role === "user" ? stripRuntimeContextFromUserMessage(flattenMessageContent(messageRow.content ?? "")) : flattenMessageContent(messageRow.content ?? ""),
 				...messageRow.media?.length ? { media: messageRow.media } : {},
+				...sourceContextDisplayMetadata(messageRow.metadata) ? { metadata: sourceContextDisplayMetadata(messageRow.metadata) } : {},
 				...displayIndex !== void 0 ? { displayIndex } : {},
 				timestamp: parseTimestampValue(messageRow.timestamp)
 			});

package/dist/src/session/config-types.d.ts

@@ -13,6 +13,6 @@ export interface SessionAgentConfig {
     providerOverride?: string;
     workingDirectoryOverride?: string;
     responseLanguage?: ResponseLanguage;
-    userContextMode?: 'enabled' | 'off';
+    userContextMode?: 'enabled' | 'off' | 'temporary';
     updatedAt?: number;
 }

package/dist/src/session/session-title.js

@@ -5,8 +5,7 @@ import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
-import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
-import { stripEnvelopeTimestampPrefix } from "../channels/envelope-timestamp.js";
+import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 //#region src/session/session-title.ts
 init_session_key();
 init_providers();
@@ -56,7 +55,7 @@ function stripSkillCommandForTitle(text) {
 	return match[2]?.trim() || match[1]?.trim() || text;
 }
 function normalizeUserTextForTitle(raw) {
-	return stripSkillCommandForTitle(stripExpandedSkillBlockForTitle(stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw))))).trim();
+	return stripSkillCommandForTitle(stripExpandedSkillBlockForTitle(stripMediaClaimChecks(stripRuntimeContextFromUserMessage(raw)))).trim();
 }
 /** First assistant message that has visible text (skips tool-only assistant rows). */
 function firstAssistantText(messages) {

package/dist/src/session/store.js

@@ -725,6 +725,7 @@ var SessionStore = class {
 				name: m.name
 			};
 			if (Array.isArray(m.media) && m.media.length > 0) row.media = m.media;
+			if (m.metadata && typeof m.metadata === "object") row.metadata = m.metadata;
 			const rawUsage = m.usage;
 			if (rawUsage && typeof rawUsage === "object") {
 				const inputTokens = typeof rawUsage.input === "number" ? rawUsage.input : void 0;

package/dist/src/session/transcript-outline.js

@@ -1,4 +1,5 @@
 import { isTranscriptBashExecutionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry } from "./session-context-for-llm.js";
+import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 //#region src/session/transcript-outline.ts
 function asRecord(value) {
 	return value && typeof value === "object" ? value : null;
@@ -170,7 +171,8 @@ function rowPreview(row) {
 	}
 	const record = asRecord(row);
 	if (record?.type === "compaction") return truncateText(stringValue(record.summary) ?? "compaction checkpoint");
-	const preview = contentPreview(record?.content);
+	const content = contentText(record?.content);
+	const preview = truncateText(record?.role === "user" ? stripRuntimeContextFromUserMessage(content) : content);
 	if (record?.role === "assistant" && !preview) {
 		if (record.stopReason === "aborted") return "(aborted)";
 		const errorMessage = stringValue(record.errorMessage);
@@ -194,7 +196,8 @@ function rowContentText(row) {
 	if (isTranscriptSummaryMessageEntry(row)) return row.summary;
 	const record = asRecord(row);
 	if (record?.type === "compaction") return stringValue(record.summary);
-	const text = contentText(record?.content).trim();
+	const rawText = contentText(record?.content);
+	const text = (record?.role === "user" ? stripRuntimeContextFromUserMessage(rawText) : rawText).trim();
 	return text ? text : void 0;
 }
 function roleForTimeline(role) {

package/dist/src/session/types.d.ts

@@ -38,6 +38,7 @@ export interface Message {
         uri: string;
         path: string;
     }>;
+    metadata?: unknown;
 }
 /** Session status enum */
 export declare enum SessionStatus {

package/dist/src/session/user-message-display.d.ts

@@ -0,0 +1,4 @@
+/** Client-facing form of a persisted model-facing user message. */
+export declare function stripRuntimeContextFromUserMessage(text: string): string;
+/** Preserve structured content while cleaning every user text block. */
+export declare function stripRuntimeContextFromUserContent(content: string | unknown[]): string | unknown[];

package/dist/src/session/user-message-display.js

@@ -0,0 +1,22 @@
+import { stripRuntimeUserMessageEnvelope } from "../../packages/gateway-contract/src/user-message-display.js";
+import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
+//#region src/session/user-message-display.ts
+/** Client-facing form of a persisted model-facing user message. */
+function stripRuntimeContextFromUserMessage(text) {
+	return stripRuntimeUserMessageEnvelope(stripSessionStartupContextFromUserText(text));
+}
+/** Preserve structured content while cleaning every user text block. */
+function stripRuntimeContextFromUserContent(content) {
+	if (typeof content === "string") return stripRuntimeContextFromUserMessage(content);
+	return content.map((block) => {
+		if (!block || typeof block !== "object") return block;
+		const row = block;
+		if (row.type !== "text" || typeof row.text !== "string") return block;
+		return {
+			...row,
+			text: stripRuntimeContextFromUserMessage(row.text)
+		};
+	});
+}
+//#endregion
+export { stripRuntimeContextFromUserContent, stripRuntimeContextFromUserMessage };

package/dist/src/storage/sqlite/context-extraction-repository.d.ts

@@ -0,0 +1,57 @@
+export type ContextExtractionStatus = 'running' | 'completed' | 'skipped' | 'failed';
+export type ContextObjectType = 'profile' | 'rule' | 'focus' | 'understanding';
+export type ContextExtractionRun = {
+    id: string;
+    principalId: string;
+    sourceRef: string;
+    extractorId: string;
+    extractorVersion: string;
+    processingPolicy: 'local_only' | 'remote_allowed';
+    destination: 'deterministic' | 'local_model' | 'remote_model';
+    inputHash: string;
+    status: ContextExtractionStatus;
+    errorCode?: string;
+    startedAt: number;
+    completedAt?: number;
+};
+export type ContextExtractionOutput = {
+    id: string;
+    runId: string;
+    ordinal: number;
+    candidateKey: string;
+    objectType?: ContextObjectType;
+    objectId?: string;
+    versionId?: string;
+    outcome: 'created' | 'deduplicated' | 'rejected';
+    createdAt: number;
+};
+export declare function claimContextExtractionRun(input: {
+    sourceRef: string;
+    extractorId: string;
+    extractorVersion: string;
+    processingPolicy: ContextExtractionRun['processingPolicy'];
+    destination: ContextExtractionRun['destination'];
+    inputHash: string;
+    principalId?: string;
+    nowMs?: number;
+}): {
+    run: ContextExtractionRun;
+    shouldExecute: boolean;
+};
+export declare function finishContextExtractionRun(input: {
+    runId: string;
+    status: Exclude<ContextExtractionStatus, 'running'>;
+    errorCode?: string;
+    outputs?: Array<Omit<ContextExtractionOutput, 'id' | 'runId' | 'ordinal' | 'createdAt'>>;
+    nowMs?: number;
+}): ContextExtractionRun | null;
+export declare function listContextExtractionRuns(filter?: {
+    sourceRef?: string;
+    extractorId?: string;
+    extractorVersion?: string;
+    status?: ContextExtractionStatus;
+    limit?: number;
+}): ContextExtractionRun[];
+export declare function getContextExtractionRun(id: string): ContextExtractionRun | null;
+export declare function listContextExtractionOutputs(runId: string): ContextExtractionOutput[];
+export declare function hasIndependentExtractionOutput(runIds: string[], objectType: ContextObjectType, objectId: string): boolean;