@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/agent/memory/manager.d.ts

@@ -1,9 +1,31 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
+import type { MemoryDeleteRequest, MemoryListRequest, MemoryReadRequest, MemoryReadResult, MemorySearchRequest, MemorySearchResult, MemoryUpdateRequest, MemoryWriteRequest, MemoryWriteResult, MemoryRecord, MemorySignal, MemoryKind } from './types.js';
+export type MemorySearchStrategy = 'local-first' | 'external-first' | 'fanout' | 'local-only' | 'external-only';
+export type MemoryWriteStrategy = 'local-first' | 'external-first' | 'write-through' | 'local-only' | 'external-only';
+export interface MemoryRoutingOptions {
+    searchStrategy?: MemorySearchStrategy;
+    writeStrategy?: MemoryWriteStrategy;
+    replicateTo?: string[];
+}
+export interface MemoryManagerOptions extends MemoryRoutingOptions {
+    loadProviders?: () => Promise<MemoryProvider[]>;
+    writePolicy?: MemoryWritePolicy;
+}
+export interface MemoryWritePolicy {
+    allowExternalWrites?: boolean;
+    allowedProviderIds?: string[];
+    autoWriteKinds?: MemoryKind[];
+    requireUserProfileApproval?: boolean;
+}
 export declare class MemoryManager {
     private providers;
     private toolToProvider;
-    private hasExternal;
+    private readonly routing;
+    private readonly loadProviders?;
+    private readonly writePolicy;
+    private pluginProvidersLoaded;
+    constructor(options?: MemoryManagerOptions);
     addProvider(provider: MemoryProvider): void;
     get providersList(): MemoryProvider[];
     /**
@@ -18,10 +40,25 @@ export declare class MemoryManager {
     }): void;
     syncAll(userContent: string, assistantContent: string, options?: {
         sessionId?: string;
-    }): void;
+    }): Promise<void>;
+    private proposeCandidatesFromTurn;
     getAdditionalTools(): AgentTool[];
     handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string>;
+    search(request: MemorySearchRequest): Promise<MemorySearchResult[]>;
+    read(request: MemoryReadRequest): Promise<MemoryReadResult | null>;
+    get(id: string): Promise<MemoryRecord | null>;
+    list(request: MemoryListRequest): Promise<MemoryRecord[]>;
+    write(request: MemoryWriteRequest): Promise<MemoryWriteResult>;
+    update(request: MemoryUpdateRequest): Promise<MemoryWriteResult>;
+    delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult>;
     onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void;
+    recordSignal(signal: MemorySignal): void;
     initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void>;
+    private loadPluginProvidersOnce;
     shutdownAll(): Promise<void>;
+    private providersForSearch;
+    private providersForWrite;
+    private writeWithStrategy;
+    private providerAllowedForWrite;
+    private trace;
 }

package/dist/src/agent/memory/manager.js

@@ -1,38 +1,48 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { appendMemoryTraceEvent } from "../../storage/sqlite/memory-records-repository.js";
+import "../../storage/sqlite/index.js";
+import { proposeMemoryCandidatesFromTurn } from "./candidate-extractor.js";
 //#region src/agent/memory/manager.ts
 init_logger();
 const log = createLogger("MemoryManager");
 var MemoryManager = class {
 	providers = [];
 	toolToProvider = /* @__PURE__ */ new Map();
-	hasExternal = false;
+	routing;
+	loadProviders;
+	writePolicy;
+	pluginProvidersLoaded = false;
+	constructor(options = {}) {
+		this.routing = {
+			searchStrategy: options.searchStrategy ?? "fanout",
+			writeStrategy: options.writeStrategy ?? "local-first",
+			replicateTo: options.replicateTo ?? []
+		};
+		this.loadProviders = options.loadProviders;
+		this.writePolicy = {
+			allowExternalWrites: options.writePolicy?.allowExternalWrites ?? false,
+			requireUserProfileApproval: options.writePolicy?.requireUserProfileApproval ?? false,
+			allowedProviderIds: options.writePolicy?.allowedProviderIds,
+			autoWriteKinds: options.writePolicy?.autoWriteKinds
+		};
+	}
 	addProvider(provider) {
-		if (!(provider.name === "builtin")) {
-			if (this.hasExternal) {
-				const existing = this.providers.find((p) => p.name !== "builtin")?.name ?? "unknown";
-				log.warn({
-					rejected: provider.name,
-					existing
-				}, "Rejected memory provider — only one external provider allowed");
-				return;
-			}
-			this.hasExternal = true;
-		}
 		this.providers.push(provider);
-		for (const schema of provider.getToolSchemas()) {
+		for (const schema of provider.getToolSchemas?.() ?? []) {
 			const toolName = schema.name;
 			if (!toolName) continue;
 			if (!this.toolToProvider.has(toolName)) this.toolToProvider.set(toolName, provider);
 			else log.warn({
 				toolName,
-				existing: this.toolToProvider.get(toolName)?.name,
-				ignored: provider.name
+				existing: this.toolToProvider.get(toolName)?.id,
+				ignored: provider.id
 			}, "Memory tool name conflict");
 		}
 		log.info({
-			name: provider.name,
-			toolCount: provider.getToolSchemas().length
+			id: provider.id,
+			toolCount: provider.getToolSchemas?.().length ?? 0,
+			capabilities: provider.capabilities
 		}, "Memory provider registered");
 	}
 	get providersList() {
@@ -44,14 +54,14 @@ var MemoryManager = class {
 	buildExternalSystemPrompt() {
 		const blocks = [];
 		for (const p of this.providers) {
-			if (p.name === "builtin") continue;
+			if (p.capabilities.local) continue;
 			try {
-				const block = p.systemPromptBlock();
+				const block = p.systemPromptBlock?.();
 				if (block?.trim()) blocks.push(block.trim());
 			} catch (err) {
 				log.warn({
 					err,
-					name: p.name
+					id: p.id
 				}, "systemPromptBlock failed");
 			}
 		}
@@ -60,50 +70,91 @@ var MemoryManager = class {
 	async prefetchAll(query, options) {
 		const parts = [];
 		for (const p of this.providers) try {
-			const v = await p.prefetch(query, options);
+			const v = await p.prefetch?.(query, options);
 			if (v?.trim()) parts.push(v.trim());
 		} catch (err) {
 			log.debug({
 				err,
-				name: p.name
+				id: p.id
 			}, "prefetch failed (non-fatal)");
 		}
 		return parts.join("\n\n");
 	}
 	queuePrefetchAll(query, options) {
 		for (const p of this.providers) try {
-			p.queuePrefetch(query, options);
+			p.queuePrefetch?.(query, options);
 		} catch (err) {
 			log.debug({
 				err,
-				name: p.name
+				id: p.id
 			}, "queuePrefetch failed (non-fatal)");
 		}
 	}
-	syncAll(userContent, assistantContent, options) {
-		for (const p of this.providers) try {
-			p.syncTurn(userContent, assistantContent, options);
+	async syncAll(userContent, assistantContent, options) {
+		const event = {
+			type: "turn",
+			userContent,
+			assistantContent,
+			sessionId: options?.sessionId
+		};
+		await this.proposeCandidatesFromTurn(event);
+		for (const p of this.providers) {
+			const started = Date.now();
+			try {
+				await p.sync?.(event);
+				this.trace("sync", p.id, event, {
+					resultCount: 1,
+					durationMs: Date.now() - started,
+					sessionKey: options?.sessionId
+				});
+			} catch (err) {
+				this.trace("sync", p.id, event, {
+					error: err instanceof Error ? err.message : String(err),
+					durationMs: Date.now() - started,
+					sessionKey: options?.sessionId
+				});
+				log.warn({
+					err,
+					id: p.id
+				}, "memory sync failed");
+			}
+		}
+	}
+	async proposeCandidatesFromTurn(event) {
+		const candidates = proposeMemoryCandidatesFromTurn({
+			userContent: event.userContent,
+			assistantContent: event.assistantContent,
+			sessionKey: event.sessionId
+		});
+		for (const candidate of candidates) try {
+			await this.write({
+				...candidate,
+				scope: {
+					...candidate.scope ?? {},
+					...event.sessionId ? { sessionKey: event.sessionId } : {}
+				}
+			});
 		} catch (err) {
-			log.warn({
+			log.debug({
 				err,
-				name: p.name
-			}, "syncTurn failed");
+				sessionKey: event.sessionId
+			}, "memory candidate proposal failed");
 		}
 	}
 	getAdditionalTools() {
 		const out = [];
 		const seen = /* @__PURE__ */ new Set();
 		for (const p of this.providers) {
-			if (p.name === "builtin") continue;
+			if (p.capabilities.local) continue;
 			try {
-				for (const t of p.getToolSchemas()) if (t.name && !seen.has(t.name)) {
+				for (const t of p.getToolSchemas?.() ?? []) if (t.name && !seen.has(t.name)) {
 					seen.add(t.name);
 					out.push(t);
 				}
 			} catch (err) {
 				log.warn({
 					err,
-					name: p.name
+					id: p.id
 				}, "getToolSchemas failed");
 			}
 		}
@@ -112,42 +163,307 @@ var MemoryManager = class {
 	async handleToolCall(toolName, args) {
 		const provider = this.toolToProvider.get(toolName);
 		if (!provider) throw new Error(`No memory provider handles tool '${toolName}'`);
+		if (!provider.handleToolCall) throw new Error(`Memory provider '${provider.id}' does not handle tool calls`);
 		return provider.handleToolCall(toolName, args);
 	}
+	async search(request) {
+		const providers = this.providersForSearch();
+		const results = [];
+		for (const p of providers) {
+			if (!p.capabilities.search || !p.search) continue;
+			const started = Date.now();
+			try {
+				const providerResults = await p.search(request);
+				this.trace("search", p.id, request, {
+					resultCount: providerResults.length,
+					selectedRecordIds: providerResults.map((result) => result.record.id),
+					durationMs: Date.now() - started,
+					sessionKey: request.scope?.sessionKey
+				});
+				results.push(...providerResults);
+				if (providerResults.length > 0 && this.routing.searchStrategy !== "fanout") break;
+			} catch (err) {
+				this.trace("search", p.id, request, {
+					error: err instanceof Error ? err.message : String(err),
+					durationMs: Date.now() - started,
+					sessionKey: request.scope?.sessionKey
+				});
+				log.warn({
+					err,
+					id: p.id
+				}, "memory search failed");
+			}
+		}
+		const seen = /* @__PURE__ */ new Set();
+		return results.sort((a, b) => b.score - a.score).filter((result) => {
+			const key = `${result.citation.providerId}:${result.citation.recordId}`;
+			if (seen.has(key)) return false;
+			seen.add(key);
+			return true;
+		}).slice(0, request.maxResults ?? 5);
+	}
+	async read(request) {
+		for (const p of this.providersForSearch()) {
+			if (!p.capabilities.read || !p.read) continue;
+			const started = Date.now();
+			try {
+				const result = await p.read(request);
+				this.trace("read", p.id, request, {
+					resultCount: result ? 1 : 0,
+					selectedRecordIds: result ? [result.record.id] : [],
+					durationMs: Date.now() - started,
+					sessionKey: request.scope?.sessionKey
+				});
+				if (result) return result;
+			} catch (err) {
+				this.trace("read", p.id, request, {
+					error: err instanceof Error ? err.message : String(err),
+					durationMs: Date.now() - started,
+					sessionKey: request.scope?.sessionKey
+				});
+				log.warn({
+					err,
+					id: p.id
+				}, "memory read failed");
+			}
+		}
+		return null;
+	}
+	async get(id) {
+		for (const p of this.providers) {
+			if (!p.capabilities.read) continue;
+			try {
+				const direct = await p.get?.(id);
+				if (direct) return direct;
+			} catch (err) {
+				log.warn({
+					err,
+					id: p.id,
+					recordId: id
+				}, "memory get failed");
+			}
+		}
+		return null;
+	}
+	async list(request) {
+		const out = [];
+		for (const p of this.providersForSearch()) {
+			if (!p.capabilities.read || !p.list) continue;
+			try {
+				out.push(...await p.list(request));
+			} catch (err) {
+				log.warn({
+					err,
+					id: p.id
+				}, "memory list failed");
+			}
+		}
+		return out;
+	}
+	async write(request) {
+		return this.writeWithStrategy("write", request);
+	}
+	async update(request) {
+		return this.writeWithStrategy("update", request);
+	}
+	async delete(request) {
+		return this.writeWithStrategy("delete", request);
+	}
 	onMemoryWrite(action, target, content) {
 		for (const p of this.providers) {
-			if (p.name === "builtin") continue;
+			if (p.capabilities.local) continue;
 			try {
-				p.onMemoryWrite?.(action, target, content);
+				p.sync?.({
+					type: "write",
+					action,
+					target,
+					content
+				});
 			} catch (err) {
 				log.debug({
 					err,
-					name: p.name
-				}, "onMemoryWrite failed");
+					id: p.id
+				}, "memory write sync failed");
+			}
+		}
+	}
+	recordSignal(signal) {
+		for (const p of this.providers) {
+			const started = Date.now();
+			try {
+				p.sync?.({
+					type: "signal",
+					signal
+				});
+				this.trace("sync", p.id, {
+					type: "signal",
+					signal
+				}, {
+					resultCount: 1,
+					durationMs: Date.now() - started
+				});
+			} catch (err) {
+				this.trace("sync", p.id, {
+					type: "signal",
+					signal
+				}, {
+					error: err instanceof Error ? err.message : String(err),
+					durationMs: Date.now() - started
+				});
+				log.debug({
+					err,
+					id: p.id,
+					source: signal.source
+				}, "memory signal sync failed");
 			}
 		}
 	}
 	async initializeAll(sessionId, options) {
+		await this.loadPluginProvidersOnce();
 		for (const p of this.providers) try {
 			await p.initialize(sessionId, options);
 		} catch (err) {
 			log.warn({
 				err,
-				name: p.name
+				id: p.id
 			}, "initialize failed");
 		}
 	}
+	async loadPluginProvidersOnce() {
+		if (this.pluginProvidersLoaded || !this.loadProviders) return;
+		this.pluginProvidersLoaded = true;
+		try {
+			const providers = await this.loadProviders();
+			const existingIds = new Set(this.providers.map((p) => p.id));
+			for (const provider of providers) {
+				if (existingIds.has(provider.id)) {
+					log.warn({ id: provider.id }, "Skipped duplicate memory provider");
+					continue;
+				}
+				this.addProvider(provider);
+				existingIds.add(provider.id);
+			}
+		} catch (err) {
+			log.warn({ err }, "Memory provider plugin loading failed");
+		}
+	}
 	async shutdownAll() {
 		for (const p of [...this.providers].reverse()) try {
 			await p.shutdown();
 		} catch (err) {
 			log.warn({
 				err,
-				name: p.name
+				id: p.id
 			}, "shutdown failed");
 		}
 	}
+	providersForSearch() {
+		const locals = this.providers.filter((p) => p.capabilities.local);
+		const externals = this.providers.filter((p) => !p.capabilities.local);
+		switch (this.routing.searchStrategy) {
+			case "local-only": return locals;
+			case "external-only": return externals;
+			case "external-first": return [...externals, ...locals];
+			default: return [...locals, ...externals];
+		}
+	}
+	providersForWrite() {
+		const locals = this.providers.filter((p) => p.capabilities.local);
+		const externals = this.providers.filter((p) => !p.capabilities.local);
+		switch (this.routing.writeStrategy) {
+			case "local-only": return locals;
+			case "external-only": return externals;
+			case "external-first": return [...externals, ...locals];
+			default: return [...locals, ...externals];
+		}
+	}
+	async writeWithStrategy(operation, request) {
+		const providers = operation === "write" && request.status === "candidate" ? this.providers.filter((provider) => provider.capabilities.local) : this.providersForWrite();
+		const errors = [];
+		let firstSuccess = null;
+		for (const p of providers) {
+			const fn = p[operation];
+			if (!this.providerAllowedForWrite(p, operation, request)) {
+				this.trace(operation, p.id, request, {
+					skippedReason: "policy",
+					sessionKey: request.scope?.sessionKey
+				});
+				continue;
+			}
+			if (!(operation === "write" && p.capabilities.write || operation === "update" && p.capabilities.update || operation === "delete" && p.capabilities.delete) || !fn) continue;
+			const started = Date.now();
+			try {
+				const result = await fn.call(p, request);
+				this.trace(operation, p.id, request, {
+					resultCount: result.record ? 1 : 0,
+					selectedRecordIds: result.record ? [result.record.id] : [],
+					error: result.success ? void 0 : result.error,
+					durationMs: Date.now() - started,
+					sessionKey: request.scope?.sessionKey
+				});
+				if (result.success) {
+					firstSuccess ??= result;
+					if (this.routing.writeStrategy !== "write-through") return result;
+				} else if (result.error) errors.push(`${p.id}: ${result.error}`);
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				this.trace(operation, p.id, request, {
+					error: message,
+					durationMs: Date.now() - started,
+					sessionKey: request.scope?.sessionKey
+				});
+				errors.push(`${p.id}: ${message}`);
+				log.warn({
+					err,
+					id: p.id,
+					operation
+				}, "memory write operation failed");
+			}
+		}
+		if (firstSuccess) return firstSuccess;
+		return {
+			success: false,
+			error: errors.join("; ") || `No provider supports memory ${operation}`
+		};
+	}
+	providerAllowedForWrite(provider, operation, request) {
+		if (!provider.capabilities.local && !this.writePolicy.allowExternalWrites) return false;
+		if (!provider.capabilities.local && this.writePolicy.allowedProviderIds && this.writePolicy.allowedProviderIds.length > 0 && !this.writePolicy.allowedProviderIds.includes(provider.id)) return false;
+		if (operation === "write") {
+			const writeRequest = request;
+			if (writeRequest.status === "candidate" && !provider.capabilities.local) return false;
+			if (this.writePolicy.autoWriteKinds && this.writePolicy.autoWriteKinds.length > 0 && !this.writePolicy.autoWriteKinds.includes(writeRequest.kind)) return false;
+			if (this.writePolicy.requireUserProfileApproval && writeRequest.kind === "user_profile" && !writeRequest.approved) return false;
+		}
+		if (operation === "update" && this.writePolicy.requireUserProfileApproval) {
+			const updateRequest = request;
+			if (updateRequest.target === "user" && !updateRequest.approved) return false;
+		}
+		return true;
+	}
+	trace(phase, providerId, request, meta = {}) {
+		try {
+			appendMemoryTraceEvent({
+				phase,
+				providerId,
+				request: sanitizeTraceRequest(request),
+				...meta
+			});
+		} catch (err) {
+			log.debug({
+				err,
+				providerId,
+				phase
+			}, "memory trace append failed");
+		}
+	}
 };
+function sanitizeTraceRequest(request) {
+	if (!request || typeof request !== "object") return request;
+	const copy = { ...request };
+	if (typeof copy.content === "string" && copy.content.length > 500) copy.content = `${copy.content.slice(0, 500)}…`;
+	return copy;
+}
 //#endregion
 export { MemoryManager };
 

package/dist/src/agent/memory/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":[],"sources":["../../../../src/agent/memory/manager.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../utils/logger.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\n\nconst log = createLogger('MemoryManager');\n\nexport class MemoryManager {\n  private providers: MemoryProvider[] = [];\n  private toolToProvider = new Map<string, MemoryProvider>();\n  private hasExternal = false;\n\n  addProvider(provider: MemoryProvider): void {\n    const isBuiltin = provider.name === 'builtin';\n\n    if (!isBuiltin) {\n      if (this.hasExternal) {\n        const existing = this.providers.find((p) => p.name !== 'builtin')?.name ?? 'unknown';\n        log.warn(\n          { rejected: provider.name, existing },\n          'Rejected memory provider — only one external provider allowed',\n        );\n        return;\n      }\n      this.hasExternal = true;\n    }\n\n    this.providers.push(provider);\n\n    for (const schema of provider.getToolSchemas()) {\n      const toolName = schema.name;\n      if (!toolName) {\n        continue;\n      }\n      if (!this.toolToProvider.has(toolName)) {\n        this.toolToProvider.set(toolName, provider);\n      } else {\n        log.warn(\n          { toolName, existing: this.toolToProvider.get(toolName)?.name, ignored: provider.name },\n          'Memory tool name conflict',\n        );\n      }\n    }\n\n    log.info({ name: provider.name, toolCount: provider.getToolSchemas().length }, 'Memory provider registered');\n  }\n\n  get providersList(): MemoryProvider[] {\n    return [...this.providers];\n  }\n\n  /**\n   * Non-builtin static instructions (builtin uses curated snapshot in system prompt builder).\n   */\n  buildExternalSystemPrompt(): string {\n    const blocks: string[] = [];\n    for (const p of this.providers) {\n      if (p.name === 'builtin') {\n        continue;\n      }\n      try {\n        const block = p.systemPromptBlock();\n        if (block?.trim()) {\n          blocks.push(block.trim());\n        }\n      } catch (err) {\n        log.warn({ err, name: p.name }, 'systemPromptBlock failed');\n      }\n    }\n    return blocks.join('\\n\\n');\n  }\n\n  async prefetchAll(query: string, options?: { sessionId?: string }): Promise<string> {\n    const parts: string[] = [];\n    for (const p of this.providers) {\n      try {\n        const v = await p.prefetch(query, options);\n        if (v?.trim()) {\n          parts.push(v.trim());\n        }\n      } catch (err) {\n        log.debug({ err, name: p.name }, 'prefetch failed (non-fatal)');\n      }\n    }\n    return parts.join('\\n\\n');\n  }\n\n  queuePrefetchAll(query: string, options?: { sessionId?: string }): void {\n    for (const p of this.providers) {\n      try {\n        p.queuePrefetch(query, options);\n      } catch (err) {\n        log.debug({ err, name: p.name }, 'queuePrefetch failed (non-fatal)');\n      }\n    }\n  }\n\n  syncAll(userContent: string, assistantContent: string, options?: { sessionId?: string }): void {\n    for (const p of this.providers) {\n      try {\n        p.syncTurn(userContent, assistantContent, options);\n      } catch (err) {\n        log.warn({ err, name: p.name }, 'syncTurn failed');\n      }\n    }\n  }\n\n  getAdditionalTools(): AgentTool[] {\n    const out: AgentTool[] = [];\n    const seen = new Set<string>();\n    for (const p of this.providers) {\n      if (p.name === 'builtin') {\n        continue;\n      }\n      try {\n        for (const t of p.getToolSchemas()) {\n          if (t.name && !seen.has(t.name)) {\n            seen.add(t.name);\n            out.push(t);\n          }\n        }\n      } catch (err) {\n        log.warn({ err, name: p.name }, 'getToolSchemas failed');\n      }\n    }\n    return out;\n  }\n\n  async handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string> {\n    const provider = this.toolToProvider.get(toolName);\n    if (!provider) {\n      throw new Error(`No memory provider handles tool '${toolName}'`);\n    }\n    return provider.handleToolCall(toolName, args);\n  }\n\n  onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void {\n    for (const p of this.providers) {\n      if (p.name === 'builtin') {\n        continue;\n      }\n      try {\n        p.onMemoryWrite?.(action, target, content);\n      } catch (err) {\n        log.debug({ err, name: p.name }, 'onMemoryWrite failed');\n      }\n    }\n  }\n\n  async initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    for (const p of this.providers) {\n      try {\n        await p.initialize(sessionId, options);\n      } catch (err) {\n        log.warn({ err, name: p.name }, 'initialize failed');\n      }\n    }\n  }\n\n  async shutdownAll(): Promise<void> {\n    for (const p of [...this.providers].reverse()) {\n      try {\n        await p.shutdown();\n      } catch (err) {\n        log.warn({ err, name: p.name }, 'shutdown failed');\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":[],"sources":["../../../../src/agent/memory/manager.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { appendMemoryTraceEvent } from '../../storage/sqlite/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { proposeMemoryCandidatesFromTurn } from './candidate-extractor.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\nimport type {\n  MemoryDeleteRequest,\n  MemoryListRequest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemorySyncEvent,\n  MemoryUpdateRequest,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n  MemoryRecord,\n  MemorySignal,\n  MemoryKind,\n} from './types.js';\n\nconst log = createLogger('MemoryManager');\n\nexport type MemorySearchStrategy = 'local-first' | 'external-first' | 'fanout' | 'local-only' | 'external-only';\nexport type MemoryWriteStrategy = 'local-first' | 'external-first' | 'write-through' | 'local-only' | 'external-only';\n\nexport interface MemoryRoutingOptions {\n  searchStrategy?: MemorySearchStrategy;\n  writeStrategy?: MemoryWriteStrategy;\n  replicateTo?: string[];\n}\n\nexport interface MemoryManagerOptions extends MemoryRoutingOptions {\n  loadProviders?: () => Promise<MemoryProvider[]>;\n  writePolicy?: MemoryWritePolicy;\n}\n\nexport interface MemoryWritePolicy {\n  allowExternalWrites?: boolean;\n  allowedProviderIds?: string[];\n  autoWriteKinds?: MemoryKind[];\n  requireUserProfileApproval?: boolean;\n}\n\nexport class MemoryManager {\n  private providers: MemoryProvider[] = [];\n  private toolToProvider = new Map<string, MemoryProvider>();\n  private readonly routing: Required<MemoryRoutingOptions>;\n  private readonly loadProviders?: () => Promise<MemoryProvider[]>;\n  private readonly writePolicy: Required<Pick<MemoryWritePolicy, 'allowExternalWrites' | 'requireUserProfileApproval'>> &\n    Omit<MemoryWritePolicy, 'allowExternalWrites' | 'requireUserProfileApproval'>;\n  private pluginProvidersLoaded = false;\n\n  constructor(options: MemoryManagerOptions = {}) {\n    this.routing = {\n      searchStrategy: options.searchStrategy ?? 'fanout',\n      writeStrategy: options.writeStrategy ?? 'local-first',\n      replicateTo: options.replicateTo ?? [],\n    };\n    this.loadProviders = options.loadProviders;\n    this.writePolicy = {\n      allowExternalWrites: options.writePolicy?.allowExternalWrites ?? false,\n      requireUserProfileApproval: options.writePolicy?.requireUserProfileApproval ?? false,\n      allowedProviderIds: options.writePolicy?.allowedProviderIds,\n      autoWriteKinds: options.writePolicy?.autoWriteKinds,\n    };\n  }\n\n  addProvider(provider: MemoryProvider): void {\n    this.providers.push(provider);\n\n    for (const schema of provider.getToolSchemas?.() ?? []) {\n      const toolName = schema.name;\n      if (!toolName) {\n        continue;\n      }\n      if (!this.toolToProvider.has(toolName)) {\n        this.toolToProvider.set(toolName, provider);\n      } else {\n        log.warn(\n          { toolName, existing: this.toolToProvider.get(toolName)?.id, ignored: provider.id },\n          'Memory tool name conflict',\n        );\n      }\n    }\n\n    log.info(\n      { id: provider.id, toolCount: provider.getToolSchemas?.().length ?? 0, capabilities: provider.capabilities },\n      'Memory provider registered',\n    );\n  }\n\n  get providersList(): MemoryProvider[] {\n    return [...this.providers];\n  }\n\n  /**\n   * Non-builtin static instructions (builtin uses curated snapshot in system prompt builder).\n   */\n  buildExternalSystemPrompt(): string {\n    const blocks: string[] = [];\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        const block = p.systemPromptBlock?.();\n        if (block?.trim()) {\n          blocks.push(block.trim());\n        }\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'systemPromptBlock failed');\n      }\n    }\n    return blocks.join('\\n\\n');\n  }\n\n  async prefetchAll(query: string, options?: { sessionId?: string }): Promise<string> {\n    const parts: string[] = [];\n    for (const p of this.providers) {\n      try {\n        const v = await p.prefetch?.(query, options);\n        if (v?.trim()) {\n          parts.push(v.trim());\n        }\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'prefetch failed (non-fatal)');\n      }\n    }\n    return parts.join('\\n\\n');\n  }\n\n  queuePrefetchAll(query: string, options?: { sessionId?: string }): void {\n    for (const p of this.providers) {\n      try {\n        p.queuePrefetch?.(query, options);\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'queuePrefetch failed (non-fatal)');\n      }\n    }\n  }\n\n  async syncAll(userContent: string, assistantContent: string, options?: { sessionId?: string }): Promise<void> {\n    const event: MemorySyncEvent = {\n      type: 'turn',\n      userContent,\n      assistantContent,\n      sessionId: options?.sessionId,\n    };\n    await this.proposeCandidatesFromTurn(event);\n    for (const p of this.providers) {\n      const started = Date.now();\n      try {\n        await p.sync?.(event);\n        this.trace('sync', p.id, event, {\n          resultCount: 1,\n          durationMs: Date.now() - started,\n          sessionKey: options?.sessionId,\n        });\n      } catch (err) {\n        this.trace('sync', p.id, event, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: options?.sessionId,\n        });\n        log.warn({ err, id: p.id }, 'memory sync failed');\n      }\n    }\n  }\n\n  private async proposeCandidatesFromTurn(event: Extract<MemorySyncEvent, { type: 'turn' }>): Promise<void> {\n    const candidates = proposeMemoryCandidatesFromTurn({\n      userContent: event.userContent,\n      assistantContent: event.assistantContent,\n      sessionKey: event.sessionId,\n    });\n    for (const candidate of candidates) {\n      try {\n        await this.write({\n          ...candidate,\n          scope: {\n            ...(candidate.scope ?? {}),\n            ...(event.sessionId ? { sessionKey: event.sessionId } : {}),\n          },\n        });\n      } catch (err) {\n        log.debug({ err, sessionKey: event.sessionId }, 'memory candidate proposal failed');\n      }\n    }\n  }\n\n  getAdditionalTools(): AgentTool[] {\n    const out: AgentTool[] = [];\n    const seen = new Set<string>();\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        for (const t of p.getToolSchemas?.() ?? []) {\n          if (t.name && !seen.has(t.name)) {\n            seen.add(t.name);\n            out.push(t);\n          }\n        }\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'getToolSchemas failed');\n      }\n    }\n    return out;\n  }\n\n  async handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string> {\n    const provider = this.toolToProvider.get(toolName);\n    if (!provider) {\n      throw new Error(`No memory provider handles tool '${toolName}'`);\n    }\n    if (!provider.handleToolCall) {\n      throw new Error(`Memory provider '${provider.id}' does not handle tool calls`);\n    }\n    return provider.handleToolCall(toolName, args);\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const providers = this.providersForSearch();\n    const results: MemorySearchResult[] = [];\n\n    for (const p of providers) {\n      if (!p.capabilities.search || !p.search) continue;\n      const started = Date.now();\n      try {\n        const providerResults = await p.search(request);\n        this.trace('search', p.id, request, {\n          resultCount: providerResults.length,\n          selectedRecordIds: providerResults.map((result) => result.record.id),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        results.push(...providerResults);\n        if (providerResults.length > 0 && this.routing.searchStrategy !== 'fanout') {\n          break;\n        }\n      } catch (err) {\n        this.trace('search', p.id, request, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        log.warn({ err, id: p.id }, 'memory search failed');\n      }\n    }\n\n    const seen = new Set<string>();\n    return results\n      .sort((a, b) => b.score - a.score)\n      .filter((result) => {\n        const key = `${result.citation.providerId}:${result.citation.recordId}`;\n        if (seen.has(key)) return false;\n        seen.add(key);\n        return true;\n      })\n      .slice(0, request.maxResults ?? 5);\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    for (const p of this.providersForSearch()) {\n      if (!p.capabilities.read || !p.read) continue;\n      const started = Date.now();\n      try {\n        const result = await p.read(request);\n        this.trace('read', p.id, request, {\n          resultCount: result ? 1 : 0,\n          selectedRecordIds: result ? [result.record.id] : [],\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        if (result) return result;\n      } catch (err) {\n        this.trace('read', p.id, request, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        log.warn({ err, id: p.id }, 'memory read failed');\n      }\n    }\n    return null;\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    for (const p of this.providers) {\n      if (!p.capabilities.read) continue;\n      try {\n        const direct = await p.get?.(id);\n        if (direct) return direct;\n      } catch (err) {\n        log.warn({ err, id: p.id, recordId: id }, 'memory get failed');\n      }\n    }\n    return null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    const out: MemoryRecord[] = [];\n    for (const p of this.providersForSearch()) {\n      if (!p.capabilities.read || !p.list) continue;\n      try {\n        out.push(...await p.list(request));\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'memory list failed');\n      }\n    }\n    return out;\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    return this.writeWithStrategy('write', request);\n  }\n\n  async update(request: MemoryUpdateRequest): Promise<MemoryWriteResult> {\n    return this.writeWithStrategy('update', request);\n  }\n\n  async delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult> {\n    return this.writeWithStrategy('delete', request);\n  }\n\n  onMemoryWrite(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void {\n    for (const p of this.providers) {\n      if (p.capabilities.local) {\n        continue;\n      }\n      try {\n        p.sync?.({ type: 'write', action, target, content });\n      } catch (err) {\n        log.debug({ err, id: p.id }, 'memory write sync failed');\n      }\n    }\n  }\n\n  recordSignal(signal: MemorySignal): void {\n    for (const p of this.providers) {\n      const started = Date.now();\n      try {\n        p.sync?.({ type: 'signal', signal });\n        this.trace('sync', p.id, { type: 'signal', signal }, {\n          resultCount: 1,\n          durationMs: Date.now() - started,\n        });\n      } catch (err) {\n        this.trace('sync', p.id, { type: 'signal', signal }, {\n          error: err instanceof Error ? err.message : String(err),\n          durationMs: Date.now() - started,\n        });\n        log.debug({ err, id: p.id, source: signal.source }, 'memory signal sync failed');\n      }\n    }\n  }\n\n  async initializeAll(sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    await this.loadPluginProvidersOnce();\n    for (const p of this.providers) {\n      try {\n        await p.initialize(sessionId, options);\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'initialize failed');\n      }\n    }\n  }\n\n  private async loadPluginProvidersOnce(): Promise<void> {\n    if (this.pluginProvidersLoaded || !this.loadProviders) return;\n    this.pluginProvidersLoaded = true;\n    try {\n      const providers = await this.loadProviders();\n      const existingIds = new Set(this.providers.map((p) => p.id));\n      for (const provider of providers) {\n        if (existingIds.has(provider.id)) {\n          log.warn({ id: provider.id }, 'Skipped duplicate memory provider');\n          continue;\n        }\n        this.addProvider(provider);\n        existingIds.add(provider.id);\n      }\n    } catch (err) {\n      log.warn({ err }, 'Memory provider plugin loading failed');\n    }\n  }\n\n  async shutdownAll(): Promise<void> {\n    for (const p of [...this.providers].reverse()) {\n      try {\n        await p.shutdown();\n      } catch (err) {\n        log.warn({ err, id: p.id }, 'shutdown failed');\n      }\n    }\n  }\n\n  private providersForSearch(): MemoryProvider[] {\n    const locals = this.providers.filter((p) => p.capabilities.local);\n    const externals = this.providers.filter((p) => !p.capabilities.local);\n    switch (this.routing.searchStrategy) {\n      case 'local-only':\n        return locals;\n      case 'external-only':\n        return externals;\n      case 'external-first':\n        return [...externals, ...locals];\n      case 'local-first':\n      case 'fanout':\n      default:\n        return [...locals, ...externals];\n    }\n  }\n\n  private providersForWrite(): MemoryProvider[] {\n    const locals = this.providers.filter((p) => p.capabilities.local);\n    const externals = this.providers.filter((p) => !p.capabilities.local);\n    switch (this.routing.writeStrategy) {\n      case 'local-only':\n        return locals;\n      case 'external-only':\n        return externals;\n      case 'external-first':\n        return [...externals, ...locals];\n      case 'write-through':\n      case 'local-first':\n      default:\n        return [...locals, ...externals];\n    }\n  }\n\n  private async writeWithStrategy(\n    operation: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): Promise<MemoryWriteResult> {\n    const providers =\n      operation === 'write' && (request as MemoryWriteRequest).status === 'candidate'\n        ? this.providers.filter((provider) => provider.capabilities.local)\n        : this.providersForWrite();\n    const errors: string[] = [];\n    let firstSuccess: MemoryWriteResult | null = null;\n\n    for (const p of providers) {\n      const fn = p[operation];\n      if (!this.providerAllowedForWrite(p, operation, request)) {\n        this.trace(operation, p.id, request, {\n          skippedReason: 'policy',\n          sessionKey: request.scope?.sessionKey,\n        });\n        continue;\n      }\n      const canWrite =\n        (operation === 'write' && p.capabilities.write) ||\n        (operation === 'update' && p.capabilities.update) ||\n        (operation === 'delete' && p.capabilities.delete);\n      if (!canWrite || !fn) continue;\n      const started = Date.now();\n      try {\n        const result = await fn.call(p, request as never);\n        this.trace(operation, p.id, request, {\n          resultCount: result.record ? 1 : 0,\n          selectedRecordIds: result.record ? [result.record.id] : [],\n          error: result.success ? undefined : result.error,\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        if (result.success) {\n          firstSuccess ??= result;\n          if (this.routing.writeStrategy !== 'write-through') {\n            return result;\n          }\n        } else if (result.error) {\n          errors.push(`${p.id}: ${result.error}`);\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        this.trace(operation, p.id, request, {\n          error: message,\n          durationMs: Date.now() - started,\n          sessionKey: request.scope?.sessionKey,\n        });\n        errors.push(`${p.id}: ${message}`);\n        log.warn({ err, id: p.id, operation }, 'memory write operation failed');\n      }\n    }\n\n    if (firstSuccess) return firstSuccess;\n    return { success: false, error: errors.join('; ') || `No provider supports memory ${operation}` };\n  }\n\n  private providerAllowedForWrite(\n    provider: MemoryProvider,\n    operation: 'write' | 'update' | 'delete',\n    request: MemoryWriteRequest | MemoryUpdateRequest | MemoryDeleteRequest,\n  ): boolean {\n    if (!provider.capabilities.local && !this.writePolicy.allowExternalWrites) {\n      return false;\n    }\n    if (\n      !provider.capabilities.local &&\n      this.writePolicy.allowedProviderIds &&\n      this.writePolicy.allowedProviderIds.length > 0 &&\n      !this.writePolicy.allowedProviderIds.includes(provider.id)\n    ) {\n      return false;\n    }\n    if (operation === 'write') {\n      const writeRequest = request as MemoryWriteRequest;\n      if (writeRequest.status === 'candidate' && !provider.capabilities.local) {\n        return false;\n      }\n      if (\n        this.writePolicy.autoWriteKinds &&\n        this.writePolicy.autoWriteKinds.length > 0 &&\n        !this.writePolicy.autoWriteKinds.includes(writeRequest.kind)\n      ) {\n        return false;\n      }\n      if (\n        this.writePolicy.requireUserProfileApproval &&\n        writeRequest.kind === 'user_profile' &&\n        !writeRequest.approved\n      ) {\n        return false;\n      }\n    }\n    if (operation === 'update' && this.writePolicy.requireUserProfileApproval) {\n      const updateRequest = request as MemoryUpdateRequest;\n      if (updateRequest.target === 'user' && !updateRequest.approved) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  private trace(\n    phase: 'search' | 'read' | 'write' | 'update' | 'delete' | 'sync' | 'inject' | 'test',\n    providerId: string,\n    request: unknown,\n    meta: {\n      sessionKey?: string;\n      resultCount?: number;\n      selectedRecordIds?: string[];\n      skippedReason?: string;\n      error?: string;\n      durationMs?: number;\n    } = {},\n  ): void {\n    try {\n      appendMemoryTraceEvent({\n        phase,\n        providerId,\n        request: sanitizeTraceRequest(request),\n        ...meta,\n      });\n    } catch (err) {\n      log.debug({ err, providerId, phase }, 'memory trace append failed');\n    }\n  }\n}\n\nfunction sanitizeTraceRequest(request: unknown): unknown {\n  if (!request || typeof request !== 'object') return request;\n  const copy = { ...(request as Record<string, unknown>) };\n  if (typeof copy.content === 'string' && copy.content.length > 500) {\n    copy.content = `${copy.content.slice(0, 500)}…`;\n  }\n  return copy;\n}\n"],"mappings":"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"}