@xopcai/xopc 0.0.206 → 0.0.207

package/dist/src/agent/tools/factory.js

@@ -15,6 +15,7 @@ import { createExecCommandTool } from "./exec-command.js";
 import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
+import { createSessionRecallTool } from "./session-recall-tool.js";
 import { createGrepTool } from "./grep.js";
 import { createFindTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
@@ -299,6 +300,10 @@ var AgentToolsFactory = class {
 					...this.deps.getCurrentContext?.()?.sessionKey ? { sessionKey: this.deps.getCurrentContext().sessionKey } : {}
 				})
 			})] : [],
+			...this.deps.getSessionStore ? [createSessionRecallTool({
+				getSessionStore: this.deps.getSessionStore,
+				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey
+			})] : [],
 			...this.deps.getSessionStore && getPrimary ? [createSessionSearchTool({
 				getSessionStore: this.deps.getSessionStore,
 				getPrimaryModel: getPrimary,

package/dist/src/agent/tools/index.d.ts

@@ -7,6 +7,7 @@ export { createExecCommandTool, type ExecCommandDetails, type ExecCommandUpdateD
 export { createApplyPatchTool, type AppliedPatchChange, type ApplyPatchDetails, } from './apply-patch.js';
 export { createMemorySearchTool, createMemoryGetTool, type MemoryToolOptions, } from './memory-tool.js';
 export { createSessionSearchTool } from './session-search-tool.js';
+export { createSessionRecallTool, type SessionRecallToolDeps } from './session-recall-tool.js';
 export { grepTool, createGrepTool, type GrepToolInput, type GrepToolDetails, } from './grep.js';
 export { findTool, createFindTool, type FindToolInput, type FindToolDetails, } from './find.js';
 export { createWebSearchTool, createWebFetchTool } from './web.js';

package/dist/src/agent/tools/index.js

@@ -9,6 +9,7 @@ import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToL
 import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
+import { createSessionRecallTool } from "./session-recall-tool.js";
 import { createGrepTool, grepTool } from "./grep.js";
 import { createFindTool, findTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
@@ -41,4 +42,4 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/session-recall-tool.d.ts

@@ -0,0 +1,7 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { SessionStore } from '../../session/store.js';
+export interface SessionRecallToolDeps {
+    getSessionStore: () => SessionStore;
+    getCurrentSessionKey: () => string | undefined;
+}
+export declare function createSessionRecallTool(deps: SessionRecallToolDeps): AgentTool;

package/dist/src/agent/tools/session-recall-tool.js

@@ -0,0 +1,82 @@
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/session-recall-tool.ts
+const SessionRecallSchema = Type.Object({
+	query: Type.String({
+		minLength: 1,
+		maxLength: 500,
+		description: "Keywords, an exact phrase, path, URL, ID, date, or name to find in this session."
+	}),
+	limit: Type.Optional(Type.Integer({
+		minimum: 1,
+		maximum: 20,
+		default: 8
+	})),
+	beforeSeq: Type.Optional(Type.Integer({
+		minimum: 1,
+		description: "Return matches older than this transcript sequence number."
+	})),
+	maxCharsPerResult: Type.Optional(Type.Integer({
+		minimum: 500,
+		maximum: 2e4,
+		default: 6e3
+	}))
+});
+function excerpt(content, query, maxChars) {
+	if (content.length <= maxChars) return content;
+	const matchAt = content.toLowerCase().indexOf(query.toLowerCase());
+	const center = matchAt >= 0 ? matchAt + Math.floor(query.length / 2) : Math.floor(content.length / 2);
+	const start = Math.max(0, Math.min(content.length - maxChars, center - Math.floor(maxChars / 2)));
+	const end = Math.min(content.length, start + maxChars);
+	return `${start > 0 ? "…\n" : ""}${content.slice(start, end)}${end < content.length ? "\n…" : ""}`;
+}
+function createSessionRecallTool(deps) {
+	return {
+		name: "session_recall",
+		label: "Session recall",
+		description: "Search the authoritative raw transcript of the current session, including turns older than context compaction. Use when a continuation summary lacks an exact fact, quote, path, URL, ID, date, decision, or tool outcome. This tool cannot access other sessions.",
+		parameters: SessionRecallSchema,
+		supportsParallel: true,
+		idempotent: true,
+		async execute(_toolCallId, params) {
+			const input = params;
+			const sessionKey = deps.getCurrentSessionKey();
+			if (!sessionKey) return {
+				content: [{
+					type: "text",
+					text: "session_recall is unavailable outside an active session."
+				}],
+				details: { error: "missing_session" }
+			};
+			const query = input.query.trim();
+			const limit = Math.min(20, Math.max(1, input.limit ?? 8));
+			const maxChars = Math.min(2e4, Math.max(500, input.maxCharsPerResult ?? 6e3));
+			const results = deps.getSessionStore().recallSession(sessionKey, query, {
+				limit,
+				...input.beforeSeq ? { beforeSeq: input.beforeSeq } : {}
+			}).map((match) => ({
+				seq: match.seq,
+				entryId: match.entryId,
+				role: match.role,
+				createdAt: new Date(match.createdAt).toISOString(),
+				content: excerpt(match.content, query, maxChars)
+			}));
+			const nextBeforeSeq = results.length === limit ? Math.min(...results.map((result) => result.seq)) : void 0;
+			const payload = {
+				success: true,
+				query,
+				results,
+				count: results.length,
+				...nextBeforeSeq ? { nextBeforeSeq } : {}
+			};
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(payload, null, 2)
+				}],
+				details: payload
+			};
+		}
+	};
+}
+//#endregion
+export { createSessionRecallTool };

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v122).`,
+		message: `SQLite schema v${status.dbVersion} (current release v123).`,
 		hints: []
 	};
 }

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/config/schema.d.ts

@@ -1537,6 +1537,7 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                     summaryTimeoutMs: z.ZodDefault<z.ZodNumber>;
                     summaryRetries: z.ZodDefault<z.ZodNumber>;
                     qualityGuard: z.ZodDefault<z.ZodBoolean>;
+                    gapAudit: z.ZodDefault<z.ZodBoolean>;
                     model: z.ZodOptional<z.ZodString>;
                     minToolResultKeepChars: z.ZodDefault<z.ZodNumber>;
                     maxActiveTranscriptBytes: z.ZodDefault<z.ZodNumber>;

package/dist/src/gateway/agents-admin.js

@@ -1,5 +1,5 @@
-import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
+import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";

package/dist/src/gateway/heartbeat/service.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { shouldSilence, stripHeartbeatToken } from "../../heartbeat/tokens.js";
+import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { isWithinActiveHours } from "../../heartbeat/active-hours.js";
 import { isHeartbeatContentEmpty } from "../../heartbeat/content-check.js";
-import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { createHeartbeatWake } from "../../heartbeat/wake.js";
 import { resolveHeartbeatMdPath } from "../workspace-heartbeat-path.js";
 import { readFile } from "fs/promises";

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

@@ -320,6 +320,7 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                     summaryTimeoutMs: number;
                     summaryRetries: number;
                     qualityGuard: boolean;
+                    gapAudit: boolean;
                     minToolResultKeepChars: number;
                     maxActiveTranscriptBytes: number;
                     postCompactionSections: string[];

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

@@ -187,11 +187,11 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 						skipTaskReview: reviewHint?.skipTaskReview ?? false,
 						outboundMetadata: {}
 					});
-				} catch (goalErr) {
+				} catch (completionErr) {
 					log.warn({
-						err: goalErr,
+						err: completionErr,
 						sessionKey
-					}, `Session turn complete failed: ${goalErr instanceof Error ? goalErr.message : String(goalErr)}`);
+					}, `Session turn complete failed: ${completionErr instanceof Error ? completionErr.message : String(completionErr)}`);
 				}
 				agentService.endInboundTurn(sessionKey);
 			}

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/session/compaction-types.d.ts

@@ -0,0 +1,30 @@
+export declare const HANDOVER_ITEM_KINDS: readonly ["objective", "decision", "pending_user_ask", "todo", "constraint", "file_change", "tool_outcome", "failure", "current_state", "next_action"];
+export type HandoverItemKind = typeof HANDOVER_ITEM_KINDS[number];
+export type HandoverItemStatus = 'active' | 'completed' | 'superseded';
+export interface CompactionSourceRef {
+    entryId: string;
+    seq: number;
+}
+export interface CompactionHandoverItem {
+    id: string;
+    kind: HandoverItemKind;
+    text: string;
+    status: HandoverItemStatus;
+    sources: CompactionSourceRef[];
+    identifiers: string[];
+}
+export interface CompactionHandover {
+    version: 1;
+    sourceThroughSeq: number;
+    previousBoundaryId?: string;
+    items: CompactionHandoverItem[];
+}
+export interface CompactionAudit {
+    status: 'passed' | 'degraded' | 'disabled';
+    mode: 'structural' | 'risk' | 'full';
+    missingItemsFound: number;
+    repaired: boolean;
+    auditModelRef?: string;
+}
+export declare function isCompactionHandover(value: unknown): value is CompactionHandover;
+export declare function isCompactionAudit(value: unknown): value is CompactionAudit;

package/dist/src/session/compaction-types.js

@@ -0,0 +1,35 @@
+//#region src/session/compaction-types.ts
+const HANDOVER_ITEM_KINDS = [
+	"objective",
+	"decision",
+	"pending_user_ask",
+	"todo",
+	"constraint",
+	"file_change",
+	"tool_outcome",
+	"failure",
+	"current_state",
+	"next_action"
+];
+function isCompactionHandover(value) {
+	if (!value || typeof value !== "object") return false;
+	const handover = value;
+	const sourceThroughSeq = Number(handover.sourceThroughSeq);
+	if (handover.version !== 1 || !Number.isInteger(handover.sourceThroughSeq) || sourceThroughSeq < 0 || handover.previousBoundaryId !== void 0 && typeof handover.previousBoundaryId !== "string" || !Array.isArray(handover.items)) return false;
+	return handover.items.every((item) => {
+		if (!item || typeof item !== "object") return false;
+		const record = item;
+		return typeof record.id === "string" && record.id.length > 0 && HANDOVER_ITEM_KINDS.includes(record.kind) && typeof record.text === "string" && record.text.length > 0 && (record.status === "active" || record.status === "completed" || record.status === "superseded") && Array.isArray(record.sources) && record.sources.length > 0 && record.sources.every((source) => {
+			if (!source || typeof source !== "object") return false;
+			const ref = source;
+			return typeof ref.entryId === "string" && ref.entryId.length > 0 && Number.isInteger(ref.seq) && Number(ref.seq) > 0 && Number(ref.seq) <= sourceThroughSeq;
+		}) && Array.isArray(record.identifiers) && record.identifiers.every((identifier) => typeof identifier === "string");
+	});
+}
+function isCompactionAudit(value) {
+	if (!value || typeof value !== "object") return false;
+	const audit = value;
+	return (audit.status === "passed" || audit.status === "degraded" || audit.status === "disabled") && (audit.mode === "structural" || audit.mode === "risk" || audit.mode === "full") && Number.isInteger(audit.missingItemsFound) && typeof audit.repaired === "boolean" && (audit.auditModelRef === void 0 || typeof audit.auditModelRef === "string");
+}
+//#endregion
+export { HANDOVER_ITEM_KINDS, isCompactionAudit, isCompactionHandover };

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

@@ -185,6 +185,9 @@ export declare class SessionIndex extends EventEmitter {
         compactionCount: number;
         totalTokensBefore: number;
         totalTokensAfter: number;
+        auditPassedCount: number;
+        auditDegradedCount: number;
+        auditMissingItemsFound: number;
         lastCompactionAt: string;
     }>;
     listCompactionBoundaries(key: string): Promise<import("./types.js").CompactionBoundarySummary[]>;

package/dist/src/session/session-context-for-llm.d.ts

@@ -6,6 +6,7 @@
  * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).
  */
 import type { AgentMessage } from '@earendil-works/pi-agent-core';
+import { type CompactionAudit, type CompactionHandover } from './compaction-types.js';
 /** Persisted-only row: never sent to the model as a chat message. */
 export interface XopcTranscriptContextEntry {
     kind: 'context';
@@ -73,15 +74,16 @@ export interface XopcTranscriptCompactionEntry {
     type: 'compaction';
     at: string;
     baseSeq: number;
-    plannerVersion: number;
+    plannerVersion: 3;
     summaryModelRef: string;
     qualityAudit: 'passed' | 'disabled';
+    handover: CompactionHandover;
+    audit: CompactionAudit;
     summary: string;
     messages: AgentMessage[];
     firstKeptIndex: number;
     tokensBefore: number;
     tokensAfter: number;
-    restoredFromCompactionId?: string;
 }
 /** Persisted label change for a transcript entry. */
 export interface XopcTranscriptLabelEntry {

package/dist/src/session/session-context-for-llm.js

@@ -1,3 +1,4 @@
+import { isCompactionAudit, isCompactionHandover } from "./compaction-types.js";
 //#region src/session/session-context-for-llm.ts
 function isTranscriptContextEntry(x) {
 	if (!x || typeof x !== "object") return false;
@@ -24,7 +25,7 @@ function isTranscriptSummaryMessageEntry(x) {
 function isTranscriptCompactionEntry(x) {
 	if (!x || typeof x !== "object") return false;
 	const row = x;
-	return row.type === "compaction" && typeof row.at === "string" && typeof row.baseSeq === "number" && Number.isInteger(row.baseSeq) && typeof row.plannerVersion === "number" && Number.isInteger(row.plannerVersion) && typeof row.summaryModelRef === "string" && (row.qualityAudit === "passed" || row.qualityAudit === "disabled") && typeof row.summary === "string" && Array.isArray(row.messages) && typeof row.firstKeptIndex === "number" && typeof row.tokensBefore === "number" && typeof row.tokensAfter === "number";
+	return row.type === "compaction" && typeof row.at === "string" && typeof row.baseSeq === "number" && Number.isInteger(row.baseSeq) && row.plannerVersion === 3 && typeof row.summaryModelRef === "string" && (row.qualityAudit === "passed" || row.qualityAudit === "disabled") && typeof row.summary === "string" && isCompactionHandover(row.handover) && isCompactionAudit(row.audit) && Array.isArray(row.messages) && typeof row.firstKeptIndex === "number" && typeof row.tokensBefore === "number" && typeof row.tokensAfter === "number";
 }
 function isTranscriptLabelEntry(x) {
 	if (!x || typeof x !== "object") return false;

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

@@ -32,11 +32,13 @@ export declare class SessionStore {
     private window;
     private compactor;
     private compactionHooks;
+    private readonly compactionTails;
     constructor(options: SessionStoreOptions, windowConfig?: Partial<WindowConfig>, compactionConfig?: Partial<CompactionConfig>);
     setCompactionHooks(hooks: SessionCompactionHooks): void;
     private runCompactionHook;
     private resolveWorkspaceCwd;
     private runStoreMutation;
+    private runCompactionExclusive;
     initialize(): Promise<void>;
     getSessionsRoot(): string;
     resolveTranscriptPath(sessionKey: string, options?: {
@@ -142,12 +144,15 @@ export declare class SessionStore {
         tool: number;
         needsTrim: boolean;
     };
-    applyCompaction(key: string, messages: AgentMessage[], result: CompactionResult): Promise<AgentMessage[]>;
+    applyCompaction(key: string, result: CompactionResult, expectedSnapshot?: import("../storage/sqlite/transcript-repository.js").CompactionSourceSnapshot): Promise<AgentMessage[]>;
     compact(key: string, messages: AgentMessage[], model: Model<Api>, instructions?: string, force?: boolean, executionOptions?: CompactionExecutionOptions): Promise<CompactionResult>;
     getCompactionStats(key: string): Promise<{
         compactionCount: number;
         totalTokensBefore: number;
         totalTokensAfter: number;
+        auditPassedCount: number;
+        auditDegradedCount: number;
+        auditMissingItemsFound: number;
         lastCompactionAt: string;
     }>;
     listCompactionBoundaries(key: string): Promise<CompactionBoundarySummary[]>;
@@ -158,6 +163,10 @@ export declare class SessionStore {
     }): Promise<AgentMessage[]>;
     estimateTokenUsage(_key: string, messages: AgentMessage[]): Promise<number>;
     searchInSession(key: string, keyword: string): Promise<Message[]>;
+    recallSession(key: string, query: string, options?: {
+        limit?: number;
+        beforeSeq?: number;
+    }): import("../storage/sqlite/transcript-repository.js").SessionTranscriptRecallMatch[];
     exportSession(key: string, format: ExportFormat): Promise<string>;
     importSessionExport(targetKey: string, jsonContent: string): Promise<{
         sessionKey: string;

package/dist/src/session/store.js

@@ -6,7 +6,7 @@ import "./types.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
-import { appendCompactionBoundary, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary } from "../storage/sqlite/transcript-repository.js";
+import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "../storage/sqlite/transcript-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
@@ -35,6 +35,7 @@ var SessionStore = class {
 	window;
 	compactor;
 	compactionHooks = {};
+	compactionTails = /* @__PURE__ */ new Map();
 	constructor(options, windowConfig, compactionConfig) {
 		this.options = options;
 		this.window = new SlidingWindow(windowConfig);
@@ -64,6 +65,21 @@ var SessionStore = class {
 	async runStoreMutation(fn) {
 		return fn();
 	}
+	async runCompactionExclusive(sessionKey, fn) {
+		const previous = this.compactionTails.get(sessionKey) ?? Promise.resolve();
+		let release;
+		const current = new Promise((resolve) => {
+			release = resolve;
+		});
+		this.compactionTails.set(sessionKey, current);
+		await previous;
+		try {
+			return await fn();
+		} finally {
+			release();
+			if (this.compactionTails.get(sessionKey) === current) this.compactionTails.delete(sessionKey);
+		}
+	}
 	async initialize() {
 		requireXopcDatabase();
 		log.debug("Session store initialized (SQLite)");
@@ -297,12 +313,13 @@ var SessionStore = class {
 			plannerVersion: row.plannerVersion,
 			summaryModelRef: row.summaryModelRef,
 			qualityAudit: row.qualityAudit,
+			handover: row.handover,
+			audit: row.audit,
 			summary: row.summary,
 			messages: row.messages,
 			firstKeptIndex: row.firstKeptIndex,
 			tokensBefore: row.tokensBefore,
-			tokensAfter: row.tokensAfter,
-			restoredFromCompactionId: row.restoredFromCompactionId
+			tokensAfter: row.tokensAfter
 		});
 		return {
 			type: "xopc_session_transcript",
@@ -419,21 +436,25 @@ var SessionStore = class {
 	getWindowStats(messages) {
 		return this.window.getStats(messages);
 	}
-	async applyCompaction(key, messages, result) {
-		const compacted = this.compactor.applyCompaction(messages, result);
+	async applyCompaction(key, result, expectedSnapshot = loadCompactionSourceSnapshot(key)) {
+		if (!expectedSnapshot) throw new Error(`Session not found: ${key}`);
+		if (!result.compacted || !result.handover || !result.audit) throw new Error("Cannot persist an incomplete compaction result");
+		const compacted = result.messages;
 		return this.runStoreMutation(async () => {
-			appendCompactionBoundary(key, {
+			if (!appendCompactionBoundaryIfUnchanged(key, expectedSnapshot, {
 				type: "compaction",
 				at: (/* @__PURE__ */ new Date()).toISOString(),
-				plannerVersion: result.plannerVersion ?? 2,
+				plannerVersion: 3,
 				summaryModelRef: result.summaryModelRef ?? "unknown",
 				qualityAudit: result.qualityAudit ?? "disabled",
+				handover: result.handover,
+				audit: result.audit,
 				summary: result.summary,
 				messages: compacted,
 				firstKeptIndex: result.firstKeptIndex,
 				tokensBefore: result.tokensBefore,
 				tokensAfter: result.tokensAfter
-			});
+			})) throw new Error(`Session changed while compaction was running: ${key}`);
 			log.info({
 				key,
 				tokensBefore: result.tokensBefore,
@@ -445,23 +466,27 @@ var SessionStore = class {
 		});
 	}
 	async compact(key, messages, model, instructions, force, executionOptions) {
-		const tokenCount = this.estimateTokens(messages);
-		await this.runCompactionHook("before", {
-			sessionKey: key,
-			messageCount: messages.length,
-			tokenCount
-		});
-		const result = await this.compactor.compact(messages, model, instructions, force, executionOptions);
-		if (result.compacted) {
-			const compacted = await this.applyCompaction(key, messages, result);
-			await this.runCompactionHook("after", {
+		return this.runCompactionExclusive(key, async () => {
+			const snapshot = loadCompactionSourceSnapshot(key);
+			if (!snapshot) throw new Error(`Session not found: ${key}`);
+			const tokenCount = this.estimateTokens(messages);
+			await this.runCompactionHook("before", {
 				sessionKey: key,
-				messageCount: compacted.length,
-				tokenCount: result.tokensAfter,
-				compactedCount: Math.max(0, Math.min(messages.length, result.firstKeptIndex))
+				messageCount: messages.length,
+				tokenCount
 			});
-		}
-		return result;
+			const result = await this.compactor.compact(snapshot.entries, model, instructions, force, executionOptions);
+			if (result.compacted) {
+				const compacted = await this.applyCompaction(key, result, snapshot);
+				await this.runCompactionHook("after", {
+					sessionKey: key,
+					messageCount: compacted.length,
+					tokenCount: result.tokensAfter,
+					compactedCount: Math.max(0, Math.min(messages.length, result.firstKeptIndex))
+				});
+			}
+			return result;
+		});
 	}
 	async getCompactionStats(key) {
 		if (!await this.getMetadata(key)) return void 0;
@@ -470,6 +495,9 @@ var SessionStore = class {
 			compactionCount: boundaries.length,
 			totalTokensBefore: boundaries.reduce((sum, boundary) => sum + boundary.tokensBefore, 0),
 			totalTokensAfter: boundaries.reduce((sum, boundary) => sum + boundary.tokensAfter, 0),
+			auditPassedCount: boundaries.filter((boundary) => boundary.audit.status === "passed").length,
+			auditDegradedCount: boundaries.filter((boundary) => boundary.audit.status === "degraded").length,
+			auditMissingItemsFound: boundaries.reduce((sum, boundary) => sum + boundary.audit.missingItemsFound, 0),
 			lastCompactionAt: boundaries[0]?.createdAt
 		};
 	}
@@ -498,6 +526,10 @@ var SessionStore = class {
 		const q = keyword.toLowerCase();
 		return this.convertMessages(messages.filter((m) => this.extractTextContent(this.messageContent(m)).toLowerCase().includes(q)));
 	}
+	recallSession(key, query, options) {
+		requireXopcDatabase();
+		return searchSessionTranscript(key, query, options);
+	}
 	async exportSession(key, format) {
 		const metadata = await this.getMetadata(key);
 		if (!metadata) throw new Error(`Session not found: ${key}`);

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

@@ -1,3 +1,4 @@
+import type { CompactionAudit } from './compaction-types.js';
 import type { TranscriptStoredRow } from './session-context-for-llm.js';
 export interface Message {
     role: 'system' | 'user' | 'assistant' | 'tool' | 'toolResult';
@@ -174,7 +175,7 @@ export interface SessionExport {
     /** Full on-disk rows (LLM + `kind: 'context'`) for audit / round-trip. */
     transcriptRows: TranscriptStoredRow[];
 }
-/** Append-only context boundary produced by compaction or logical restoration. */
+/** Append-only context boundary produced by compaction. */
 export interface CompactionBoundarySummary {
     id: string;
     seq: number;
@@ -183,5 +184,5 @@ export interface CompactionBoundarySummary {
     tokensBefore: number;
     tokensAfter: number;
     summaryPreview: string;
-    restoredFromCompactionId?: string;
+    audit: CompactionAudit;
 }

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

@@ -20,7 +20,7 @@ export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAll
 export { buildDefaultSessionMetadata, type SessionMetadataSeed, } from './session-metadata.js';
 export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow, type SessionConfigRow, type SessionRow, type TranscriptEntryRow, } from './row-mappers.js';
 export { deleteSessionRecord, ensureSessionRecord, getCurrentSessionId, getGlobalSessionStats, findSessionKeyBySessionId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';
-export { appendCompactionBoundary, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, } from './transcript-repository.js';
+export { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, loadCompactionSourceSnapshot, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript, type CompactionSourceSnapshot, type SessionTranscriptRecallMatch, type TranscriptSourceEntry, } from './transcript-repository.js';
 export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } from './notes-repository.js';
 export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';
 export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryTurnFeedback, getMemoryRecord, hasUnresolvedMemoryConflict, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryRecordStatus, setMemoryProviderState, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemorySignalRowPayload, type MemoryFeedback, type MemoryFeedbackRating, type MemoryTraceEventPayload, type SearchMemoryRecordsOptions, type SetMemoryTurnFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';

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

@@ -21,7 +21,7 @@ import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages,
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getCurrentSessionId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "./session-task-plan-repository.js";
 import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
-import { appendCompactionBoundary, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary } from "./transcript-repository.js";
+import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
@@ -32,4 +32,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, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listUnderstandingEvidence, listUnderstandings, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+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, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listUnderstandingEvidence, listUnderstandings, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };