@xopcai/xopc 0.0.219 → 0.0.221

package/dist/src/gateway/hono/routes/understanding-sources.js

@@ -1,4 +1,6 @@
 import { deleteUnderstanding, listUnderstandingEvidence, listUnderstandings, setUnderstandingStatus } from "../../../storage/sqlite/user-context-repository.js";
+import { countKnowledgeSourceItems, deleteKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
+import { countMemoryRecordsBySourceInstanceId, deleteMemoryRecordsBySourceInstanceId } from "../../../storage/sqlite/memory-records-repository.js";
 import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
 import "../../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
@@ -44,14 +46,33 @@ function sourceRevocationImpact(grantId) {
 		if ((focus.sourceRunId ? getUnderstandingSourceRun(focus.sourceRunId) : null)?.grantId !== grantId) return [];
 		return listUserFocusEvidence(focus.id).some((entry) => !belongs(entry)) ? [] : [focus];
 	});
+	const memoryRecordCount = sourceInstanceId ? countMemoryRecordsBySourceInstanceId(sourceInstanceId) : 0;
+	const boundedRawCount = sourceInstanceId ? countKnowledgeSourceItems(sourceInstanceId) : 0;
 	return {
 		grant,
+		sourceInstanceId,
 		understandingIds: understandings.map((item) => item.id),
 		focusIds: focuses.map((item) => item.id),
-		derivedCount: understandings.length + focuses.length,
+		derivedCount: understandings.length + focuses.length + memoryRecordCount,
 		understandingCount: understandings.length,
 		focusCount: focuses.length,
-		boundedRawCount: 0
+		memoryRecordCount,
+		boundedRawCount
+	};
+}
+function applySourceRevocationChoices(impact, options) {
+	let derivedDeleted = 0;
+	for (const id of impact.focusIds) if (options.derived === "delete") {
+		if (deleteUserFocus(id)) derivedDeleted += 1;
+	} else updateUserFocus(id, { status: "paused" });
+	for (const id of impact.understandingIds) if (options.derived === "delete") {
+		if (deleteUnderstanding(id)) derivedDeleted += 1;
+	} else setUnderstandingStatus(id, "needs_review");
+	if (options.derived === "delete" && impact.sourceInstanceId) derivedDeleted += deleteMemoryRecordsBySourceInstanceId(impact.sourceInstanceId);
+	const rawDeleted = options.raw === "delete" && impact.sourceInstanceId ? deleteKnowledgeSourceItems(impact.sourceInstanceId) : 0;
+	return {
+		derivedDeleted,
+		rawDeleted
 	};
 }
 function registerUnderstandingSourceRoutes(authenticated, deps) {
@@ -168,17 +189,18 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 		const connectionId = accountId ? getConnectorAccount(accountId)?.currentConnectionId : void 0;
 		if (connectionId) deps.service.setConnectorLearningPaused(connectionId, true);
 		const grant = revokeUnderstandingSourceGrant(grantId);
-		if (grant && impact) {
-			for (const id of impact.focusIds) if (derived === "delete") deleteUserFocus(id);
-			else updateUserFocus(id, { status: "paused" });
-			for (const id of impact.understandingIds) if (derived === "delete") deleteUnderstanding(id);
-			else setUnderstandingStatus(id, "needs_review");
-		}
+		const deleted = grant && impact ? applySourceRevocationChoices(impact, {
+			derived,
+			raw
+		}) : {
+			derivedDeleted: 0,
+			rawDeleted: 0
+		};
 		return grant ? c.json({
 			ok: true,
 			grant,
 			impact,
-			rawDeleted: 0
+			...deleted
 		}) : c.json({
 			ok: false,
 			error: "Source grant not found"
@@ -232,15 +254,21 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 		sources: service.listDirectorySources()
 	}));
 	authenticated.post("/api/understanding/sources/work-folders", limited, async (c) => {
-		const rootPath = stringField(await c.req.json().catch(() => null), "rootPath");
+		const body = await c.req.json().catch(() => null);
+		const rootPath = stringField(body, "rootPath");
+		const processingPolicy = stringField(body, "processingPolicy");
 		if (!rootPath) return c.json({
 			ok: false,
 			error: "Missing rootPath"
 		}, 400);
+		if (processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
+			ok: false,
+			error: "Explicit processingPolicy is required"
+		}, 400);
 		try {
 			return c.json({
 				ok: true,
-				source: await service.grantDirectorySource(rootPath)
+				source: await service.grantDirectorySource(rootPath, processingPolicy)
 			}, 201);
 		} catch (error) {
 			return c.json({
@@ -268,14 +296,19 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 	});
 	authenticated.post("/api/understanding/bootstrap", limited, async (c) => {
 		const body = await c.req.json().catch(() => null);
-		const items = body && typeof body === "object" && Array.isArray(body.items) ? body.items.slice(0, 150) : [];
+		const items = body && typeof body === "object" && Array.isArray(body.items) ? body.items.slice(0, 1200) : [];
+		const processingPolicy = stringField(body, "processingPolicy");
 		if (!items.length) return c.json({
 			ok: false,
 			error: "No understanding source items were provided"
 		}, 400);
+		if (processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
+			ok: false,
+			error: "Explicit processingPolicy is required"
+		}, 400);
 		try {
 			const checkpoints = body && typeof body === "object" && body.sourceCheckpoints && typeof body.sourceCheckpoints === "object" ? body.sourceCheckpoints : void 0;
-			const result = await service.importUnderstandingSources(items, c.req.raw.signal, stringField(body, "workDiscoveryRunId") || void 0, checkpoints);
+			const result = await service.importUnderstandingSources(items, processingPolicy, c.req.raw.signal, stringField(body, "workDiscoveryRunId") || void 0, checkpoints);
 			return c.json({
 				ok: true,
 				...result
@@ -348,4 +381,4 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 	});
 }
 //#endregion
-export { registerUnderstandingSourceRoutes, sourceRevocationImpact };
+export { applySourceRevocationChoices, registerUnderstandingSourceRoutes, sourceRevocationImpact };

package/dist/src/gateway/hono/routes/work-discovery.js

@@ -86,7 +86,8 @@ function registerWorkDiscoveryRoutes(authenticated, deps) {
 			const candidates = await service.discoverCandidates(c.req.raw.signal);
 			return c.json({
 				ok: true,
-				candidates
+				candidates,
+				processingTarget: service.getModelProcessingTarget()
 			});
 		} catch (error) {
 			return c.json({
@@ -100,13 +101,22 @@ function registerWorkDiscoveryRoutes(authenticated, deps) {
 			ok: false,
 			error: "Work discovery is disabled"
 		}, 404);
-		const idempotencyKey = stringField(await c.req.json().catch(() => null), "idempotencyKey");
+		const body = await c.req.json().catch(() => null);
+		const idempotencyKey = stringField(body, "idempotencyKey");
+		const processingPolicy = stringField(body, "processingPolicy");
 		if (!idempotencyKey) return c.json({
 			ok: false,
 			error: "Missing idempotencyKey"
 		}, 400);
+		if (processingPolicy !== "local_only" && processingPolicy !== "remote_allowed") return c.json({
+			ok: false,
+			error: "Explicit processingPolicy is required"
+		}, 400);
 		try {
-			const run = await service.startQuickRun({ idempotencyKey });
+			const run = await service.startQuickRun({
+				idempotencyKey,
+				processingPolicy
+			});
 			return c.json({
 				ok: true,
 				run

package/dist/src/gateway/service/agent-runner.d.ts

@@ -57,6 +57,10 @@ export declare class GatewayAgentRunner {
     /** True when a webchat agent run is currently in-flight for `sessionKey`. */
     hasActiveRun(sessionKey: string): boolean;
     getActiveRunId(sessionKey: string): string | undefined;
+    listActiveRuns(): Array<{
+        sessionKey: string;
+        runId: string;
+    }>;
     getClarifyBridge(): ClarifyBridge;
     /** Called from `GatewayService.stop()` so the bridge gets cleaned up. */
     disposeClarifyBridge(): void;

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

@@ -77,6 +77,12 @@ var GatewayAgentRunner = class {
 	getActiveRunId(sessionKey) {
 		return this.activeWebchatRunBySession.get(sessionKey);
 	}
+	listActiveRuns() {
+		return [...this.activeWebchatRunBySession.entries()].map(([sessionKey, runId]) => ({
+			sessionKey,
+			runId
+		}));
+	}
 	getClarifyBridge() {
 		return this.clarifyBridge;
 	}

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

@@ -1,15 +1,15 @@
 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";
 import "../../agent/mcp/bundle-mcp-tools.js";
 import { ConfigHotReloader } from "../../config/reload.js";
 import "../../config/index.js";
-import { sanitizeTunnelConfig } from "../../tunnel/tunnel-config.js";
 import { computeBundledExtensionExtensionsPatch } from "../../extensions/bundled-extension-activation.js";
+import { sanitizeTunnelConfig } from "../../tunnel/tunnel-config.js";
 //#region src/gateway/service/config-coordinator.ts
 init_providers();
 init_logger();

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

@@ -98,13 +98,7 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 	const emitAndYield = function* (events) {
 		for (const event of events) {
 			if (taskRun) captureTaskEvent(event);
-			if (channel === "webchat") {
-				publishRealtime(`run:${runId}`, event.type, event);
-				if (event.type === "run_start") publishRealtime("sessions", "run.started", {
-					sessionKey: streamSessionKey,
-					runId
-				});
-			}
+			if (channel === "webchat") publishRealtime(`run:${runId}`, event.type, event);
 			yield event;
 		}
 	};
@@ -126,6 +120,10 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 			if (!activeWebchatRunBySession.has(sessionKey)) {
 				activeWebchatRunBySession.set(sessionKey, runId);
 				registeredActiveWebchatRun = true;
+				publishRealtime("sessions", "run.started", {
+					sessionKey,
+					runId
+				});
 			}
 			let streamError;
 			try {
@@ -172,7 +170,14 @@ async function* runGatewayAgent(deps, message, channel, chatId, origin, attachme
 					summary: streamError
 				};
 			} finally {
-				if (registeredActiveWebchatRun && activeWebchatRunBySession.get(sessionKey) === runId) activeWebchatRunBySession.delete(sessionKey);
+				if (registeredActiveWebchatRun && activeWebchatRunBySession.get(sessionKey) === runId) {
+					activeWebchatRunBySession.delete(sessionKey);
+					publishRealtime("sessions", "run.completed", {
+						sessionKey,
+						runId,
+						status: terminalStatus
+					});
+				}
 				runAbortControllers.delete(runId);
 				const assistantPlainText = agentService.getLastAssistantPlainText(sessionKey);
 				const reviewHint = agentService.takeTaskReviewStreamHint(sessionKey);

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

@@ -22,6 +22,11 @@ export interface GatewaySessionsApiOptions {
     getAgentService: () => AgentService;
     /** Read-only view of in-flight webchat runs (per session key → run id). */
     getActiveWebchatRunId: (sessionKey: string) => string | undefined;
+    /** Snapshot of all in-flight webchat runs for workspace briefing surfaces. */
+    listActiveWebchatRuns: () => Array<{
+        sessionKey: string;
+        runId: string;
+    }>;
 }
 export declare class GatewaySessionsApi {
     private readonly opts;
@@ -47,6 +52,10 @@ export declare class GatewaySessionsApi {
         active: boolean;
         runId?: string;
     };
+    listActiveRuns(): Array<{
+        sessionKey: string;
+        runId: string;
+    }>;
     getMessagePage(key: string, options?: {
         offset?: number;
         limit?: number;

package/dist/src/gateway/service/sessions-api.js

@@ -48,6 +48,9 @@ var GatewaySessionsApi = class {
 			runId
 		};
 	}
+	listActiveRuns() {
+		return this.opts.listActiveWebchatRuns();
+	}
 	getMessagePage(key, options) {
 		return this.opts.sessionIndex.getSessionMessagePage(key, options);
 	}

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";
@@ -405,7 +405,8 @@ var GatewayService = class {
 		this.sessions = new GatewaySessionsApi({
 			sessionIndex: this.sessionIndex,
 			getAgentService: () => this.ensureAgentService(),
-			getActiveWebchatRunId: (sk) => this.agentRunner.getActiveRunId(sk)
+			getActiveWebchatRunId: (sk) => this.agentRunner.getActiveRunId(sk),
+			listActiveWebchatRuns: () => this.agentRunner.listActiveRuns()
 		});
 		this.marketplace = new GatewayMarketplaceService({
 			getConfig: () => this.config,

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

@@ -1,3 +1,4 @@
+import { runPostUpdateExtensionSync } from "../extensions/update.js";
 import "./update-channels.js";
 import { compareSemver, resolveNpmChannelTag } from "./update-check.js";
 import { readPackageName, readPackageVersion } from "./package-json.js";
@@ -7,7 +8,6 @@ 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-knowledge-pipeline.d.ts

@@ -11,11 +11,17 @@ export type KnowledgeSynthesisBatchResult = {
     failed: number;
     recordIds: string[];
 };
+export type ConnectedKnowledgePruneResult = {
+    rawDeleted: number;
+    derivedDeleted: number;
+};
 export declare class ConnectedKnowledgePipeline {
     private readonly options;
     private readonly workerId;
     private readonly batchSize;
     constructor(options: ConnectedKnowledgePipelineOptions);
     processPending(sourceInstanceId?: string): Promise<KnowledgeSynthesisBatchResult>;
+    /** Remove bounded raw items and every content-bearing memory derived only from them. */
+    pruneBoundedRetention(sourceInstanceId: string, olderThanMs: number): ConnectedKnowledgePruneResult;
     private rebuildDailySummary;
 }

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

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, listKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
-import { getMemoryRecord, upsertMemoryRecord } from "../storage/sqlite/memory-records-repository.js";
+import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, listKnowledgeSourceItems, pruneBoundedKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
+import { deleteMemoryRecord, getMemoryRecord, upsertMemoryRecord } from "../storage/sqlite/memory-records-repository.js";
 import "../storage/sqlite/index.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/knowledge/connected-knowledge-pipeline.ts
@@ -180,13 +180,43 @@ var ConnectedKnowledgePipeline = class {
 		}
 		return result;
 	}
-	rebuildDailySummary(sourceInstanceId, day) {
+	/** Remove bounded raw items and every content-bearing memory derived only from them. */
+	pruneBoundedRetention(sourceInstanceId, olderThanMs) {
+		const expired = [];
+		for (let offset = 0;; offset += 500) {
+			const page = listKnowledgeSourceItems({
+				sourceInstanceId,
+				retentionClass: "bounded",
+				retentionBeforeMs: olderThanMs,
+				includeDeleted: true,
+				limit: 500,
+				offset
+			});
+			expired.push(...page);
+			if (page.length < 500) break;
+		}
+		if (!expired.length) return {
+			rawDeleted: 0,
+			derivedDeleted: 0
+		};
+		const affectedDays = new Set(expired.map(dayFor));
+		let derivedDeleted = 0;
+		for (const item of expired) if (deleteMemoryRecord(knowledgeRecordId(item.id))) derivedDeleted += 1;
+		const rawDeleted = pruneBoundedKnowledgeSourceItems(sourceInstanceId, olderThanMs);
+		for (const day of affectedDays) if (this.rebuildDailySummary(sourceInstanceId, day, true)) derivedDeleted += 1;
+		return {
+			rawDeleted,
+			derivedDeleted
+		};
+	}
+	rebuildDailySummary(sourceInstanceId, day, deleteWhenEmpty = false) {
 		const items = listKnowledgeSourceItems({
 			sourceInstanceId,
 			limit: 500
 		}).filter((item) => dayFor(item) === day && item.synthesisStatus === "completed").slice(0, MAX_SUMMARY_ITEMS);
 		if (items.length === 0) {
 			const existing = getMemoryRecord(summaryRecordId(sourceInstanceId, day));
+			if (existing && deleteWhenEmpty) return deleteMemoryRecord(existing.id);
 			if (existing) upsertMemoryRecord({
 				id: existing.id,
 				providerId: "connected-knowledge",
@@ -210,7 +240,7 @@ var ConnectedKnowledgePipeline = class {
 				expiresAt: existing.expiresAt,
 				canonicalKey: existing.canonicalKey
 			});
-			return;
+			return false;
 		}
 		const sourceProvider = providerId(items[0]);
 		const lines = [`# ${sourceProvider} updates for ${day}`, ""];
@@ -263,6 +293,7 @@ var ConnectedKnowledgePipeline = class {
 			confidence: .72,
 			observedAt: item.occurredAt ?? item.sourceUpdatedAt
 		});
+		return false;
 	}
 };
 //#endregion

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 { getOAuthProviderIds, 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 { getOAuthProviderIds, 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/retrieval/queryProfile.d.ts

@@ -12,6 +12,8 @@ export interface RetrievalQueryProfile {
     identifiers: string[];
     intentKinds: string[];
     timeHints: RetrievalTimeHint[];
+    selfReview: boolean;
     scope: RetrievalScope;
 }
+export declare function isSelfReviewQuery(query: string): boolean;
 export declare function buildRetrievalQueryProfile(query: string, scope?: RetrievalScope): RetrievalQueryProfile;

package/dist/src/retrieval/queryProfile.js

@@ -1,5 +1,14 @@
 import { extractCjkBigrams, extractLexicalTerms, extractRetrievalIdentifiers, normalizeRetrievalText } from "./textFeatures.js";
 //#region src/retrieval/queryProfile.ts
+const SELF_REVIEW_PATTERNS = [
+	/(?:你|xopc).{0,10}(?:了解|知道|认识|记得).{0,8}(?:我|用户)/i,
+	/介绍.{0,8}(?:你.{0,6})?(?:了解|知道|认识|记得).{0,4}的?我/i,
+	/\bwhat\s+(?:do\s+)?you\s+(?:know|remember)\s+about\s+me\b/i,
+	/\b(?:describe|introduce)\s+me\s+(?:from|based on)\s+(?:what|everything)\s+you\s+(?:know|remember)\b/i
+];
+function isSelfReviewQuery(query) {
+	return SELF_REVIEW_PATTERNS.some((pattern) => pattern.test(query.normalize("NFKC")));
+}
 const INTENT_RULES = [
 	{
 		kinds: ["boundary"],
@@ -67,8 +76,9 @@ function buildRetrievalQueryProfile(query, scope = {}) {
 		identifiers: extractRetrievalIdentifiers(normalized),
 		intentKinds: [...new Set(intentKinds)],
 		timeHints: uniqueTimeHints,
+		selfReview: isSelfReviewQuery(normalized),
 		scope: { ...scope }
 	};
 }
 //#endregion
-export { buildRetrievalQueryProfile };
+export { buildRetrievalQueryProfile, isSelfReviewQuery };

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

@@ -26,8 +26,8 @@ export { deleteSessionRecord, ensureSessionRecord, getCurrentSessionId, getGloba
 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';
-export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeSourceItemSynthesisStatus, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
+export { appendMemorySignal, appendMemoryTraceEvent, countMemoryRecordsBySourceInstanceId, deleteMemoryRecordsBySourceInstanceId, 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';
+export { attachMemoryEvidence, claimKnowledgeSourceItems, countKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, deleteKnowledgeSourceItems, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeSourceItemSynthesisStatus, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
 export { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';
 export { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getConnectorConnection, getConnectorApproval, getConnectorInstallation, getCachedConnectorCatalogEntry, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, type CachedConnectorCatalogEntry, } from './connector-repository.js';

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

@@ -27,12 +27,12 @@ import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAll
 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";
-import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, hasUnresolvedMemoryConflict, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord } from "./memory-records-repository.js";
+import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, countKnowledgeSourceItems, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
+import { appendMemorySignal, appendMemoryTraceEvent, countMemoryRecordsBySourceInstanceId, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, hasUnresolvedMemoryConflict, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord } from "./memory-records-repository.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
 import { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "./activity-repository.js";
 import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-repository.js";
 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, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, 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, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, 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, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, 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, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, 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, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, 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, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/knowledge-repository.d.ts

@@ -1,5 +1,5 @@
 import type { DatabaseSync } from 'node:sqlite';
-import type { KnowledgeSourceChange, KnowledgeSourceItem, KnowledgeSourceItemInput, KnowledgeSyncRun, KnowledgeSyncRunStatus, KnowledgeSynthesisPipeline, KnowledgeSynthesisStatus } from '../../knowledge/types.js';
+import type { KnowledgeSourceChange, KnowledgeSourceItem, KnowledgeSourceItemInput, KnowledgeSyncRun, KnowledgeSyncRunStatus, KnowledgeSynthesisPipeline, KnowledgeSynthesisStatus, KnowledgeRetentionClass } from '../../knowledge/types.js';
 import type { MemoryEvidence, MemoryEvidenceRelation } from '../../agent/memory/types.js';
 export declare function startKnowledgeSyncRun(input: {
     sourceInstanceId: string;
@@ -44,6 +44,8 @@ export declare function listKnowledgeSourceItems(options?: {
     collectionScope?: string;
     itemType?: string;
     synthesisStatus?: KnowledgeSynthesisStatus;
+    retentionClass?: KnowledgeRetentionClass;
+    retentionBeforeMs?: number;
     occurredAfterMs?: number;
     occurredBeforeMs?: number;
     orderBy?: 'recency_desc' | 'occurred_asc';
@@ -51,6 +53,8 @@ export declare function listKnowledgeSourceItems(options?: {
     limit?: number;
     offset?: number;
 }): KnowledgeSourceItem[];
+export declare function countKnowledgeSourceItems(sourceInstanceId: string): number;
+export declare function deleteKnowledgeSourceItems(sourceInstanceId: string): number;
 export declare function pruneBoundedKnowledgeSourceItems(sourceInstanceId: string, olderThanMs: number): number;
 export declare function setKnowledgeSourceItemSynthesisStatus(itemIds: string[], status: KnowledgeSynthesisStatus, nowMs?: number): number;
 export declare function claimKnowledgeSourceItems(options: {

package/dist/src/storage/sqlite/knowledge-repository.js

@@ -256,6 +256,14 @@ function listKnowledgeSourceItems(options = {}) {
 		where.push("synthesis_status = ?");
 		params.push(options.synthesisStatus);
 	}
+	if (options.retentionClass) {
+		where.push("retention_class = ?");
+		params.push(options.retentionClass);
+	}
+	if (options.retentionBeforeMs !== void 0) {
+		where.push("COALESCE(source_updated_at, occurred_at, updated_at) < ?");
+		params.push(options.retentionBeforeMs);
+	}
 	if (options.occurredAfterMs !== void 0) {
 		where.push("occurred_at > ?");
 		params.push(options.occurredAfterMs);
@@ -272,6 +280,13 @@ function listKnowledgeSourceItems(options = {}) {
        ORDER BY ${options.orderBy === "occurred_asc" ? "occurred_at ASC, item_id ASC" : "COALESCE(source_updated_at, occurred_at, updated_at) DESC"}
        LIMIT ? OFFSET ?`).all(...params, limit, offset).map(sourceItemFromRow);
 }
+function countKnowledgeSourceItems(sourceInstanceId) {
+	const row = getSqliteDatabase().prepare("SELECT COUNT(*) AS count FROM knowledge_source_items WHERE source_instance_id = ?").get(sourceInstanceId);
+	return Number(row.count);
+}
+function deleteKnowledgeSourceItems(sourceInstanceId) {
+	return runSqliteWriteTransaction((db) => Number(db.prepare("DELETE FROM knowledge_source_items WHERE source_instance_id = ?").run(sourceInstanceId).changes));
+}
 function pruneBoundedKnowledgeSourceItems(sourceInstanceId, olderThanMs) {
 	return runSqliteWriteTransaction((db) => Number(db.prepare(`DELETE FROM knowledge_source_items
      WHERE source_instance_id = ? AND retention_class = 'bounded'
@@ -421,4 +436,4 @@ function listMemoryEvidenceForRecords(recordIds) {
 	return output;
 }
 //#endregion
-export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryEvidenceForRecords, pruneBoundedKnowledgeSourceItems, replaceMemoryEvidenceForRecord, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };
+export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, countKnowledgeSourceItems, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryEvidenceForRecords, pruneBoundedKnowledgeSourceItems, replaceMemoryEvidenceForRecord, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };

package/dist/src/storage/sqlite/memory-records-repository.d.ts

@@ -173,6 +173,8 @@ export declare function hasUnresolvedMemoryConflict(conflictGroupId: string): bo
 export declare function listMemoryRecords(options?: ListMemoryRecordsOptions): MemoryRecord[];
 export declare function searchMemoryRecords(options: SearchMemoryRecordsOptions): MemorySearchResult[];
 export declare function deleteMemoryRecord(recordId: string): boolean;
+export declare function countMemoryRecordsBySourceInstanceId(sourceInstanceId: string): number;
+export declare function deleteMemoryRecordsBySourceInstanceId(sourceInstanceId: string): number;
 /** Change lifecycle status without reconstructing or weakening the record's provenance. */
 export declare function setMemoryRecordStatus(recordId: string, status: MemoryStatus, nowMs?: number): boolean;
 export declare function markMemoryRecordsConflicted(recordIds: string[], conflictGroupId: string): number;