@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/agent/memory/plugin-discovery.js

@@ -1,39 +1,105 @@
-import { dirname, join } from "node:path";
-import { readdir, stat } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
+import { discoverExtensionsFromDisk, init_discover_extensions } from "../../extensions/discover-extensions.js";
+import { isAbsolute, join } from "node:path";
+import { stat } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
 //#region src/agent/memory/plugin-discovery.ts
-async function discoverMemoryPlugins() {
-	const pluginsDir = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "plugins", "memory");
-	try {
-		const entries = await readdir(pluginsDir);
-		const plugins = [];
-		for (const entry of entries) {
-			const fullPath = join(pluginsDir, entry);
-			if (!(await stat(fullPath)).isDirectory() || entry.startsWith("_") || entry.startsWith(".")) continue;
-			const initPath = join(fullPath, "index.js");
-			try {
-				await stat(initPath);
-				const mod = await import(initPath);
-				const available = mod.isAvailable?.() ?? true;
-				plugins.push({
-					name: entry,
-					description: mod.description ?? `${entry} memory plugin`,
-					available
-				});
-			} catch {
-				plugins.push({
-					name: entry,
-					description: `${entry} memory plugin`,
-					available: false
-				});
-			}
+init_discover_extensions();
+async function discoverMemoryPlugins(config) {
+	const plugins = [];
+	for (const extension of discoverMemoryProviderExtensions(config)) for (const providerId of extension.manifest.contracts?.memoryProviders ?? []) plugins.push({
+		name: providerId,
+		description: extension.manifest.description ?? `${extension.manifest.name} memory provider`,
+		available: true,
+		manifest: {
+			type: "memory-provider",
+			id: providerId,
+			displayName: extension.manifest.name || providerId,
+			entry: extension.manifest.main,
+			capabilities: {}
 		}
-		return plugins.sort((a, b) => a.name.localeCompare(b.name));
+	});
+	return plugins.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function loadMemoryPluginProviders(params = {}) {
+	const providers = [];
+	for (const extension of discoverMemoryProviderExtensions(params.config)) {
+		const module = await loadMemoryProviderModule(extension);
+		if (!module?.createMemoryProvider) continue;
+		if (module.isAvailable?.() === false) continue;
+		const fallbackId = (extension.manifest.contracts?.memoryProviders ?? [])[0] ?? extension.id;
+		const manifest = normalizeMemoryProviderManifest(fallbackId, module.manifest) ?? {
+			type: "memory-provider",
+			id: fallbackId,
+			displayName: extension.manifest.name || fallbackId,
+			entry: extension.manifest.main,
+			capabilities: {}
+		};
+		const provider = await module.createMemoryProvider({
+			config: params.config,
+			manifest,
+			extension: {
+				id: extension.id,
+				path: extension.path,
+				source: extension.source,
+				config: extensionConfig(params.config, extension.id)
+			}
+		});
+		providers.push(provider);
+	}
+	return providers;
+}
+function discoverMemoryProviderExtensions(config) {
+	if (areExtensionsDisabled(config)) return [];
+	const disabled = new Set(extensionIds(config?.extensions?.disabled));
+	const enabled = config?.extensions?.enabled;
+	const enabledSet = Array.isArray(enabled) ? new Set(extensionIds(enabled)) : null;
+	return discoverExtensionsFromDisk({}, config).filter((extension) => (extension.manifest.contracts?.memoryProviders?.length ?? 0) > 0).filter((extension) => !disabled.has(extension.id)).filter((extension) => extension.manifest.enabledByDefault === true || enabledSet?.has(extension.id));
+}
+async function loadMemoryProviderModule(extension) {
+	if (!extension.manifest.main) return null;
+	const resolved = await resolveModuleEntry(isAbsolute(extension.manifest.main) ? extension.manifest.main : join(extension.path, extension.manifest.main));
+	try {
+		const mod = await import(pathToFileURL(resolved).href);
+		return "default" in mod && mod.default ? mod.default : mod;
 	} catch {
-		return [];
+		return null;
 	}
 }
+async function resolveModuleEntry(entryPath) {
+	for (const candidate of entryCandidates(entryPath)) try {
+		await stat(candidate);
+		return candidate;
+	} catch {}
+	return entryPath;
+}
+function entryCandidates(entryPath) {
+	const candidates = [entryPath];
+	if (entryPath.endsWith(".js")) candidates.push(`${entryPath.slice(0, -3)}.ts`);
+	return candidates;
+}
+function extensionIds(value) {
+	return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function areExtensionsDisabled(config) {
+	return config?.extensions?.enabled === false;
+}
+function extensionConfig(config, extensionId) {
+	const raw = config?.extensions?.[extensionId];
+	return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : void 0;
+}
+function normalizeMemoryProviderManifest(fallbackId, manifest) {
+	if (!manifest || manifest.type !== "memory-provider") return void 0;
+	const id = typeof manifest.id === "string" && manifest.id.trim() ? manifest.id.trim() : fallbackId;
+	return {
+		type: "memory-provider",
+		id,
+		displayName: typeof manifest.displayName === "string" && manifest.displayName.trim() ? manifest.displayName.trim() : id,
+		...manifest.entry ? { entry: manifest.entry } : {},
+		capabilities: manifest.capabilities ?? {},
+		...manifest.configSchema ? { configSchema: manifest.configSchema } : {}
+	};
+}
 //#endregion
-export { discoverMemoryPlugins };
+export { discoverMemoryPlugins, loadMemoryPluginProviders };
 
 //# sourceMappingURL=plugin-discovery.js.map

package/dist/src/agent/memory/plugin-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-discovery.js","names":[],"sources":["../../../../src/agent/memory/plugin-discovery.ts"],"sourcesContent":["import { readdir, stat } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Discover optional `plugins/memory/<name>/` packages (extension point).\n * Compiled layout: `dist/src/plugins/memory/...` relative to this module.\n */\nexport interface MemoryPluginMetadata {\n  name: string;\n  description: string;\n  available: boolean;\n}\n\nexport async function discoverMemoryPlugins(): Promise<MemoryPluginMetadata[]> {\n  const here = dirname(fileURLToPath(import.meta.url));\n  const pluginsDir = join(here, '..', '..', 'plugins', 'memory');\n\n  try {\n    const entries = await readdir(pluginsDir);\n    const plugins: MemoryPluginMetadata[] = [];\n\n    for (const entry of entries) {\n      const fullPath = join(pluginsDir, entry);\n      const stats = await stat(fullPath);\n      if (!stats.isDirectory() || entry.startsWith('_') || entry.startsWith('.')) {\n        continue;\n      }\n\n      const initPath = join(fullPath, 'index.js');\n      try {\n        await stat(initPath);\n        const mod = (await import(initPath)) as {\n          isAvailable?: () => boolean;\n          description?: string;\n        };\n        const available = mod.isAvailable?.() ?? true;\n        plugins.push({\n          name: entry,\n          description: mod.description ?? `${entry} memory plugin`,\n          available,\n        });\n      } catch {\n        plugins.push({\n          name: entry,\n          description: `${entry} memory plugin`,\n          available: false,\n        });\n      }\n    }\n\n    return plugins.sort((a, b) => a.name.localeCompare(b.name));\n  } catch {\n    return [];\n  }\n}\n"],"mappings":";;;;AAcA,eAAsB,wBAAyD;CAE7E,MAAM,aAAa,KADN,QAAQ,cAAc,OAAO,KAAK,IAAI,CACvB,EAAE,MAAM,MAAM,WAAW,SAAS;AAE9D,KAAI;EACF,MAAM,UAAU,MAAM,QAAQ,WAAW;EACzC,MAAM,UAAkC,EAAE;AAE1C,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,WAAW,KAAK,YAAY,MAAM;AAExC,OAAI,EAAC,MADe,KAAK,SAAS,EACvB,aAAa,IAAI,MAAM,WAAW,IAAI,IAAI,MAAM,WAAW,IAAI,CACxE;GAGF,MAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,OAAI;AACF,UAAM,KAAK,SAAS;IACpB,MAAM,MAAO,MAAM,OAAO;IAI1B,MAAM,YAAY,IAAI,eAAe,IAAI;AACzC,YAAQ,KAAK;KACX,MAAM;KACN,aAAa,IAAI,eAAe,GAAG,MAAM;KACzC;KACD,CAAC;WACI;AACN,YAAQ,KAAK;KACX,MAAM;KACN,aAAa,GAAG,MAAM;KACtB,WAAW;KACZ,CAAC;;;AAIN,SAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;SACrD;AACN,SAAO,EAAE"}
+{"version":3,"file":"plugin-discovery.js","names":[],"sources":["../../../../src/agent/memory/plugin-discovery.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { isAbsolute, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport type { Config } from '../../config/schema.js';\nimport { discoverExtensionsFromDisk } from '../../extensions/discover-extensions.js';\nimport type { DiscoveredExtension } from '../../extensions/types/loader.js';\nimport type { MemoryProvider } from './provider.js';\nimport type { MemoryProviderManifest } from './types.js';\n\nexport interface MemoryPluginMetadata {\n  name: string;\n  description: string;\n  available: boolean;\n  manifest?: MemoryProviderManifest;\n}\n\nexport interface MemoryPluginProviderContext {\n  config?: Config;\n  manifest?: MemoryProviderManifest;\n  extension?: {\n    id: string;\n    path: string;\n    source: DiscoveredExtension['source'];\n    config?: Record<string, unknown>;\n  };\n}\n\ntype MemoryPluginModule = {\n  isAvailable?: () => boolean;\n  description?: string;\n  manifest?: MemoryProviderManifest;\n  createMemoryProvider?: (\n    context: MemoryPluginProviderContext,\n  ) => MemoryProvider | Promise<MemoryProvider>;\n};\n\nexport async function discoverMemoryPlugins(config?: Config): Promise<MemoryPluginMetadata[]> {\n  const plugins: MemoryPluginMetadata[] = [];\n  for (const extension of discoverMemoryProviderExtensions(config)) {\n    for (const providerId of extension.manifest.contracts?.memoryProviders ?? []) {\n      plugins.push({\n        name: providerId,\n        description: extension.manifest.description ?? `${extension.manifest.name} memory provider`,\n        available: true,\n        manifest: {\n          type: 'memory-provider',\n          id: providerId,\n          displayName: extension.manifest.name || providerId,\n          entry: extension.manifest.main,\n          capabilities: {},\n        },\n      });\n    }\n  }\n  return plugins.sort((a, b) => a.name.localeCompare(b.name));\n}\n\nexport async function loadMemoryPluginProviders(params: {\n  config?: Config;\n} = {}): Promise<MemoryProvider[]> {\n  const providers: MemoryProvider[] = [];\n  for (const extension of discoverMemoryProviderExtensions(params.config)) {\n    const module = await loadMemoryProviderModule(extension);\n    if (!module?.createMemoryProvider) continue;\n    if (module.isAvailable?.() === false) continue;\n\n    const declaredProviderIds = extension.manifest.contracts?.memoryProviders ?? [];\n    const fallbackId = declaredProviderIds[0] ?? extension.id;\n    const manifest = normalizeMemoryProviderManifest(fallbackId, module.manifest) ?? {\n      type: 'memory-provider',\n      id: fallbackId,\n      displayName: extension.manifest.name || fallbackId,\n      entry: extension.manifest.main,\n      capabilities: {},\n    };\n\n    const provider = await module.createMemoryProvider({\n      config: params.config,\n      manifest,\n      extension: {\n        id: extension.id,\n        path: extension.path,\n        source: extension.source,\n        config: extensionConfig(params.config, extension.id),\n      },\n    });\n    providers.push(provider);\n  }\n  return providers;\n}\n\nfunction discoverMemoryProviderExtensions(config?: Config): DiscoveredExtension[] {\n  if (areExtensionsDisabled(config)) return [];\n  const disabled = new Set(extensionIds(config?.extensions?.disabled));\n  const enabled = config?.extensions?.enabled;\n  const enabledSet = Array.isArray(enabled) ? new Set(extensionIds(enabled)) : null;\n  return discoverExtensionsFromDisk({}, config as unknown as Record<string, unknown> | undefined)\n    .filter((extension) => (extension.manifest.contracts?.memoryProviders?.length ?? 0) > 0)\n    .filter((extension) => !disabled.has(extension.id))\n    .filter((extension) => extension.manifest.enabledByDefault === true || enabledSet?.has(extension.id));\n}\n\nasync function loadMemoryProviderModule(extension: DiscoveredExtension): Promise<MemoryPluginModule | null> {\n  if (!extension.manifest.main) return null;\n  const entryPath = isAbsolute(extension.manifest.main)\n    ? extension.manifest.main\n    : join(extension.path, extension.manifest.main);\n  const resolved = await resolveModuleEntry(entryPath);\n  try {\n    const mod = (await import(pathToFileURL(resolved).href)) as MemoryPluginModule | { default?: MemoryPluginModule };\n    return 'default' in mod && mod.default ? mod.default : (mod as MemoryPluginModule);\n  } catch {\n    return null;\n  }\n}\n\nasync function resolveModuleEntry(entryPath: string): Promise<string> {\n  for (const candidate of entryCandidates(entryPath)) {\n    try {\n      await stat(candidate);\n      return candidate;\n    } catch {\n      // Try the next candidate; source tests use .ts, builds use .js.\n    }\n  }\n  return entryPath;\n}\n\nfunction entryCandidates(entryPath: string): string[] {\n  const candidates = [entryPath];\n  if (entryPath.endsWith('.js')) {\n    candidates.push(`${entryPath.slice(0, -3)}.ts`);\n  }\n  return candidates;\n}\n\nfunction extensionIds(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string') : [];\n}\n\nfunction areExtensionsDisabled(config?: Config): boolean {\n  return config?.extensions?.enabled === false;\n}\n\nfunction extensionConfig(config: Config | undefined, extensionId: string): Record<string, unknown> | undefined {\n  const raw = config?.extensions?.[extensionId as keyof Config['extensions']];\n  return raw && typeof raw === 'object' && !Array.isArray(raw) ? (raw as Record<string, unknown>) : undefined;\n}\n\nfunction normalizeMemoryProviderManifest(\n  fallbackId: string,\n  manifest: MemoryProviderManifest | undefined,\n): MemoryProviderManifest | undefined {\n  if (!manifest || manifest.type !== 'memory-provider') return undefined;\n  const id = typeof manifest.id === 'string' && manifest.id.trim() ? manifest.id.trim() : fallbackId;\n  const displayName =\n    typeof manifest.displayName === 'string' && manifest.displayName.trim()\n      ? manifest.displayName.trim()\n      : id;\n  return {\n    type: 'memory-provider',\n    id,\n    displayName,\n    ...(manifest.entry ? { entry: manifest.entry } : {}),\n    capabilities: manifest.capabilities ?? {},\n    ...(manifest.configSchema ? { configSchema: manifest.configSchema } : {}),\n  };\n}\n"],"mappings":"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"}

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

@@ -1,35 +1,40 @@
-/**
- * Pluggable memory provider. Builtin curated files use `BuiltinMemoryStore` + `curated_memory`;
- * external providers add instructions, prefetch/sync, and optional tools.
- */
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { MemoryCapabilities, MemoryDeleteRequest, MemoryListRequest, MemoryProviderManifest, MemoryReadRequest, MemoryReadResult, MemorySearchRequest, MemorySearchResult, MemorySyncEvent, MemoryUpdateRequest, MemoryWriteRequest, MemoryWriteResult, MemoryRecord } from './types.js';
 export interface MemoryProviderInitOptions {
     workspace?: string;
     agentWorkspace?: string;
     sessionId?: string;
+    config?: Record<string, unknown>;
     [key: string]: unknown;
 }
 export interface MemoryProvider {
-    readonly name: string;
+    readonly id: string;
+    readonly displayName?: string;
+    readonly manifest?: MemoryProviderManifest;
+    readonly capabilities: MemoryCapabilities;
     isAvailable(): boolean;
     initialize(sessionId: string, options?: MemoryProviderInitOptions): Promise<void> | void;
-    /** Static text merged into system prompt (external providers only; builtin uses curated snapshot separately). */
-    systemPromptBlock(): string;
-    prefetch(query: string, options?: {
+    /** Static text merged into the system prompt. */
+    systemPromptBlock?(): string;
+    prefetch?(query: string, options?: {
         sessionId?: string;
     }): Promise<string>;
-    queuePrefetch(query: string, options?: {
+    queuePrefetch?(query: string, options?: {
         sessionId?: string;
     }): void;
-    syncTurn(userContent: string, assistantContent: string, options?: {
-        sessionId?: string;
-    }): void;
-    getToolSchemas(): AgentTool[];
+    sync?(event: MemorySyncEvent): Promise<void> | void;
+    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>;
+    getToolSchemas?(): AgentTool[];
     /** JSON string result for tool calls routed by name (when not using inline AgentTool.execute only). */
-    handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string>;
+    handleToolCall?(toolName: string, args: Record<string, unknown>): Promise<string>;
     shutdown(): Promise<void> | void;
     onTurnStart?(turnNumber: number, message: string, metadata?: Record<string, unknown>): void;
     onSessionEnd?(messages: unknown[]): void;
     onPreCompress?(messages: unknown[]): string;
-    onMemoryWrite?(action: 'add' | 'replace' | 'remove', target: 'memory' | 'user', content: string): void;
 }

package/dist/src/agent/memory/stub-memory-provider.d.ts

@@ -3,14 +3,29 @@ import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';
  * Placeholder external provider — enables wiring tests without cloud deps.
  */
 export declare class StubMemoryProvider implements MemoryProvider {
-    readonly name = "stub";
+    readonly id = "stub";
+    readonly displayName = "Stub Memory Provider";
+    readonly capabilities: {
+        search: boolean;
+        read: boolean;
+        write: boolean;
+        update: boolean;
+        delete: boolean;
+        keywordSearch: boolean;
+        semanticSearch: boolean;
+        hybridSearch: boolean;
+        citations: boolean;
+        sync: boolean;
+        local: boolean;
+    };
     isAvailable(): boolean;
     initialize(_sessionId: string, _options?: MemoryProviderInitOptions): Promise<void>;
     systemPromptBlock(): string;
     prefetch(query: string): Promise<string>;
     queuePrefetch(): void;
-    syncTurn(_user: string, _assistant: string): void;
+    sync(): void;
     getToolSchemas(): any[];
     handleToolCall(toolName: string): Promise<string>;
+    search(): Promise<[]>;
     shutdown(): Promise<void>;
 }

package/dist/src/agent/memory/stub-memory-provider.js

@@ -3,13 +3,27 @@
 * Placeholder external provider — enables wiring tests without cloud deps.
 */
 var StubMemoryProvider = class {
-	name = "stub";
+	id = "stub";
+	displayName = "Stub Memory Provider";
+	capabilities = {
+		search: true,
+		read: false,
+		write: false,
+		update: false,
+		delete: false,
+		keywordSearch: false,
+		semanticSearch: false,
+		hybridSearch: false,
+		citations: false,
+		sync: true,
+		local: false
+	};
 	isAvailable() {
 		return true;
 	}
 	async initialize(_sessionId, _options) {}
 	systemPromptBlock() {
-		return "External memory provider: stub (wiring only; no cloud backend). Set `agents.defaults.memory.provider` to `none` to hide.";
+		return "External memory provider: stub (wiring only; no cloud backend).";
 	}
 	async prefetch(query) {
 		const q = query.trim();
@@ -17,13 +31,16 @@ var StubMemoryProvider = class {
 		return `[stub prefetch] query length=${q.length}`;
 	}
 	queuePrefetch() {}
-	syncTurn(_user, _assistant) {}
+	sync() {}
 	getToolSchemas() {
 		return [];
 	}
 	async handleToolCall(toolName) {
 		return JSON.stringify({ error: `stub provider has no tools (${toolName})` });
 	}
+	async search() {
+		return [];
+	}
 	async shutdown() {}
 };
 //#endregion

package/dist/src/agent/memory/stub-memory-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"stub-memory-provider.js","names":[],"sources":["../../../../src/agent/memory/stub-memory-provider.ts"],"sourcesContent":["import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\n\n/**\n * Placeholder external provider — enables wiring tests without cloud deps.\n */\nexport class StubMemoryProvider implements MemoryProvider {\n  readonly name = 'stub';\n\n  isAvailable(): boolean {\n    return true;\n  }\n\n  async initialize(_sessionId: string, _options?: MemoryProviderInitOptions): Promise<void> {}\n\n  systemPromptBlock(): string {\n    return 'External memory provider: stub (wiring only; no cloud backend). Set `agents.defaults.memory.provider` to `none` to hide.';\n  }\n\n  async prefetch(query: string): Promise<string> {\n    const q = query.trim();\n    if (!q) {\n      return '';\n    }\n    return `[stub prefetch] query length=${q.length}`;\n  }\n\n  queuePrefetch(): void {}\n\n  syncTurn(_user: string, _assistant: string): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async handleToolCall(toolName: string): Promise<string> {\n    return JSON.stringify({ error: `stub provider has no tools (${toolName})` });\n  }\n\n  async shutdown(): Promise<void> {}\n}\n"],"mappings":";;;;AAKA,IAAa,qBAAb,MAA0D;CACxD,OAAgB;CAEhB,cAAuB;AACrB,SAAO;;CAGT,MAAM,WAAW,YAAoB,UAAqD;CAE1F,oBAA4B;AAC1B,SAAO;;CAGT,MAAM,SAAS,OAAgC;EAC7C,MAAM,IAAI,MAAM,MAAM;AACtB,MAAI,CAAC,EACH,QAAO;AAET,SAAO,gCAAgC,EAAE;;CAG3C,gBAAsB;CAEtB,SAAS,OAAe,YAA0B;CAElD,iBAAiB;AACf,SAAO,EAAE;;CAGX,MAAM,eAAe,UAAmC;AACtD,SAAO,KAAK,UAAU,EAAE,OAAO,+BAA+B,SAAS,IAAI,CAAC;;CAG9E,MAAM,WAA0B"}
+{"version":3,"file":"stub-memory-provider.js","names":[],"sources":["../../../../src/agent/memory/stub-memory-provider.ts"],"sourcesContent":["import type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\n\n/**\n * Placeholder external provider — enables wiring tests without cloud deps.\n */\nexport class StubMemoryProvider implements MemoryProvider {\n  readonly id = 'stub';\n  readonly displayName = 'Stub Memory Provider';\n  readonly capabilities = {\n    search: true,\n    read: false,\n    write: false,\n    update: false,\n    delete: false,\n    keywordSearch: false,\n    semanticSearch: false,\n    hybridSearch: false,\n    citations: false,\n    sync: true,\n    local: false,\n  };\n\n  isAvailable(): boolean {\n    return true;\n  }\n\n  async initialize(_sessionId: string, _options?: MemoryProviderInitOptions): Promise<void> {}\n\n  systemPromptBlock(): string {\n    return 'External memory provider: stub (wiring only; no cloud backend).';\n  }\n\n  async prefetch(query: string): Promise<string> {\n    const q = query.trim();\n    if (!q) {\n      return '';\n    }\n    return `[stub prefetch] query length=${q.length}`;\n  }\n\n  queuePrefetch(): void {}\n\n  sync(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async handleToolCall(toolName: string): Promise<string> {\n    return JSON.stringify({ error: `stub provider has no tools (${toolName})` });\n  }\n\n  async search(): Promise<[]> {\n    return [];\n  }\n\n  async shutdown(): Promise<void> {}\n}\n"],"mappings":";;;;AAKA,IAAa,qBAAb,MAA0D;CACxD,KAAc;CACd,cAAuB;CACvB,eAAwB;EACtB,QAAQ;EACR,MAAM;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,eAAe;EACf,gBAAgB;EAChB,cAAc;EACd,WAAW;EACX,MAAM;EACN,OAAO;EACR;CAED,cAAuB;AACrB,SAAO;;CAGT,MAAM,WAAW,YAAoB,UAAqD;CAE1F,oBAA4B;AAC1B,SAAO;;CAGT,MAAM,SAAS,OAAgC;EAC7C,MAAM,IAAI,MAAM,MAAM;AACtB,MAAI,CAAC,EACH,QAAO;AAET,SAAO,gCAAgC,EAAE;;CAG3C,gBAAsB;CAEtB,OAAa;CAEb,iBAAiB;AACf,SAAO,EAAE;;CAGX,MAAM,eAAe,UAAmC;AACtD,SAAO,KAAK,UAAU,EAAE,OAAO,+BAA+B,SAAS,IAAI,CAAC;;CAG9E,MAAM,SAAsB;AAC1B,SAAO,EAAE;;CAGX,MAAM,WAA0B"}

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

@@ -17,3 +17,139 @@ export interface MemorySnapshot {
     memory: string;
     user: string;
 }
+export type MemoryKind = 'user_profile' | 'agent_note' | 'workspace_fact' | 'daily_note' | 'session_summary' | 'derived_insight';
+export interface MemoryScope {
+    agentId: string;
+    workspaceId?: string;
+    sessionKey?: string;
+}
+export interface MemoryCitation {
+    providerId: string;
+    recordId: string;
+    title?: string;
+    uri?: string;
+    path?: string;
+    lineStart?: number;
+    lineEnd?: number;
+    createdAt?: string;
+}
+export interface MemoryRecord {
+    id: string;
+    kind: MemoryKind;
+    scope: MemoryScope;
+    content: string;
+    source: {
+        path?: string;
+        lineStart?: number;
+        lineEnd?: number;
+        sessionEntryId?: string;
+        provider?: string;
+    };
+    confidence?: number;
+    createdAt: string;
+    updatedAt: string;
+    tags?: string[];
+}
+export interface MemorySearchRequest {
+    query: string;
+    scope?: Partial<MemoryScope>;
+    kinds?: MemoryKind[];
+    maxResults?: number;
+    minScore?: number;
+}
+export interface MemorySearchResult {
+    record: MemoryRecord;
+    score: number;
+    snippet: string;
+    citation: MemoryCitation;
+}
+export interface MemoryReadRequest {
+    id?: string;
+    path?: string;
+    from?: number;
+    lines?: number;
+    scope?: Partial<MemoryScope>;
+}
+export interface MemoryReadResult {
+    record: MemoryRecord;
+    lineNumbers?: {
+        start: number;
+        end: number;
+    };
+}
+export interface MemoryListRequest {
+    kind?: MemoryKind;
+    target?: 'memory' | 'user';
+    scope?: Partial<MemoryScope>;
+}
+export interface MemoryWriteRequest {
+    kind: MemoryKind;
+    content: string;
+    scope?: Partial<MemoryScope>;
+    target?: 'memory' | 'user';
+    tags?: string[];
+    source?: MemoryRecord['source'];
+    approved?: boolean;
+}
+export interface MemoryUpdateRequest {
+    id?: string;
+    matchText?: string;
+    content: string;
+    scope?: Partial<MemoryScope>;
+    target?: 'memory' | 'user';
+    approved?: boolean;
+}
+export interface MemoryDeleteRequest {
+    id?: string;
+    matchText?: string;
+    scope?: Partial<MemoryScope>;
+    target?: 'memory' | 'user';
+}
+export interface MemoryWriteResult {
+    success: boolean;
+    message?: string;
+    error?: string;
+    record?: MemoryRecord;
+}
+export interface MemoryCapabilities {
+    search: boolean;
+    read: boolean;
+    write: boolean;
+    update: boolean;
+    delete: boolean;
+    keywordSearch?: boolean;
+    semanticSearch?: boolean;
+    hybridSearch?: boolean;
+    citations?: boolean;
+    sync?: boolean;
+    local?: boolean;
+}
+export interface MemoryProviderManifest {
+    type: 'memory-provider';
+    id: string;
+    displayName: string;
+    entry?: string;
+    capabilities: Partial<MemoryCapabilities>;
+    configSchema?: string;
+}
+export type MemorySyncEvent = {
+    type: 'turn';
+    userContent: string;
+    assistantContent: string;
+    sessionId?: string;
+} | {
+    type: 'write';
+    action: 'add' | 'replace' | 'remove';
+    target?: 'memory' | 'user';
+    content: string;
+} | {
+    type: 'signal';
+    signal: MemorySignal;
+};
+export interface MemorySignal {
+    source: 'search_recall' | 'session_summary' | 'explicit_remember' | 'background_review' | 'dreaming';
+    recordId?: string;
+    score?: number;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}

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

@@ -71,7 +71,7 @@ export declare class ModelManager {
      */
     applyModelForSession(agent: Agent, sessionKey: string): Promise<void>;
     /**
-     * Ordered model candidates for the session (primary + `agents.defaults.models.chat.fallbacks`).
+     * Ordered model candidates for the session.
      */
     getFallbackCandidatesForSession(sessionKey: string): ModelCandidate[];
     /**

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

@@ -148,7 +148,7 @@ var ModelManager = class {
 		}, "Applied model for session");
 	}
 	/**
-	* Ordered model candidates for the session (primary + `agents.defaults.models.chat.fallbacks`).
+	* Ordered model candidates for the session.
 	*/
 	getFallbackCandidatesForSession(sessionKey) {
 		const parsed = parseModelRef(this.getModelForSession(sessionKey));

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

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":["getAllModelsFromProviders"],"sources":["../../../../src/agent/models/manager.ts"],"sourcesContent":["/**\n * Model management module\n * \n * Handles model selection, switching, and automatic fallback\n * when a provider fails.\n */\n\nimport { Agent, type AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport { type Config, getAgentDefaultModelRef } from '../../config/schema.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveModel, getAllModels as getAllModelsFromProviders, getDefaultModelSync } from '../../providers/index.js';\nimport {\n  isFailoverError,\n  describeFailoverError,\n  resolveFallbackCandidates,\n  type ModelCandidate,\n} from '../fallback/index.js';\nimport { parseModelRef } from './selection.js';\nimport {\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n  maybeRetryTurnAfterTransientLlmFailure,\n} from '../orchestration/llm-turn-retry.js';\nimport {\n  resolveAgentTurnTimeoutMs,\n  runAgentTurnWithTimeout,\n} from '../orchestration/run-agent-turn-with-timeout.js';\n\nconst log = createLogger('ModelManager');\n\nexport interface ModelManagerConfig {\n  defaultModel?: string;\n  config?: Config;\n}\n\nexport interface RunResult {\n  content: string | null;\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\n/**\n * Get the last assistant content from agent messages\n */\nfunction getLastAssistantContent(agent: Agent): string | null {\n  const messages = agent.state.messages;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (msg.role === 'assistant') {\n      return msg.content\n        .filter((c) => c.type === 'text')\n        .map((c) => c.text || '')\n        .join('');\n    }\n  }\n  return null;\n}\n\nexport class ModelManager {\n  private defaultModel: string;\n  private config?: Config;\n  private currentModelName: string;\n  private currentProvider: string;\n  private sessionModels: Map<string, string> = new Map();\n  /** Baseline model from `agents.list` / defaults merge when the session agent is created. */\n  private sessionProfileDefaults: Map<string, string> = new Map();\n  private channelManager?: any;\n\n  constructor(config: ModelManagerConfig = {}) {\n    this.config = config.config;\n    this.defaultModel = config.defaultModel || getDefaultModelSync(config.config);\n    this.currentModelName = this.defaultModel;\n    this.currentProvider = this.defaultModel.split('/')[0] || 'anthropic';\n  }\n\n  /**\n   * Set channel manager reference for accessing session-specific settings\n   */\n  setChannelManager(channelManager: any): void {\n    this.channelManager = channelManager;\n  }\n\n  /**\n   * Apply updated config so default model and failover metadata match disk/runtime config.\n   */\n  updateFromConfig(config: Config): void {\n    this.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.defaultModel = ref ? ref : getDefaultModelSync(config);\n    this.sessionProfileDefaults.clear();\n  }\n\n  /**\n   * Set the config-derived default model for a session (from effective agent profile).\n   * Cleared by {@link updateFromConfig} or {@link clearSessionProfileDefault}.\n   */\n  setSessionProfileDefault(sessionKey: string, modelRef: string): void {\n    this.sessionProfileDefaults.set(sessionKey, modelRef);\n  }\n\n  clearSessionProfileDefault(sessionKey: string): void {\n    this.sessionProfileDefaults.delete(sessionKey);\n  }\n\n  /**\n   * Get current model name\n   */\n  getCurrentModel(): string {\n    return this.currentModelName;\n  }\n\n  /**\n   * Get current provider\n   */\n  getCurrentProvider(): string {\n    return this.currentProvider;\n  }\n\n  /**\n   * Switch model for a specific session\n   */\n  async switchModelForSession(sessionKey: string, modelId: string): Promise<boolean> {\n    try {\n      resolveModel(modelId);\n      this.sessionModels.set(sessionKey, modelId);\n      log.info({ sessionKey, modelId }, 'Model switched for session');\n      return true;\n    } catch (err) {\n      log.error({ err, sessionKey, modelId }, 'Failed to switch model');\n      return false;\n    }\n  }\n\n  /** Drop in-memory session override so the global default is used again. */\n  clearSessionModelOverride(sessionKey: string): void {\n    this.sessionModels.delete(sessionKey);\n  }\n\n  /**\n   * Resolved pi-ai model for session (for transcript policy, tools, etc.)\n   */\n  getResolvedModelForSession(sessionKey: string): Model<Api> {\n    return resolveModel(this.getModelForSession(sessionKey));\n  }\n\n  /**\n   * Get model for session, checking session override first\n   */\n  getModelForSession(sessionKey: string): string {\n    const sessionModel = this.sessionModels.get(sessionKey);\n    if (sessionModel) {\n      return sessionModel;\n    }\n\n    const profileDefault = this.sessionProfileDefaults.get(sessionKey);\n    if (profileDefault) {\n      return profileDefault;\n    }\n\n    return this.defaultModel;\n  }\n\n  /**\n   * Apply model to agent if different from current\n   */\n  async applyModelForSession(agent: Agent, sessionKey: string): Promise<void> {\n    const targetModelId = this.getModelForSession(sessionKey);\n\n    let found: Model<Api>;\n    try {\n      found = resolveModel(targetModelId);\n    } catch (err) {\n      log.error({ err, sessionKey, modelId: targetModelId }, 'Failed to apply model');\n      return;\n    }\n\n    const sm = agent.state.model as Model<Api> | undefined;\n    if (sm && sm.provider === found.provider && sm.id === found.id) {\n      this.currentModelName = targetModelId;\n      this.currentProvider = found.provider || 'unknown';\n      return;\n    }\n\n    agent.state.model = found;\n    this.currentModelName = targetModelId;\n    this.currentProvider = found.provider || 'unknown';\n\n    log.info({ sessionKey, modelId: targetModelId }, 'Applied model for session');\n  }\n\n  /**\n   * Ordered model candidates for the session (primary + `agents.defaults.models.chat.fallbacks`).\n   */\n  getFallbackCandidatesForSession(sessionKey: string): ModelCandidate[] {\n    const ref = this.getModelForSession(sessionKey);\n    const parsed = parseModelRef(ref);\n    if (!parsed) {\n      return [];\n    }\n    return resolveFallbackCandidates({\n      cfg: this.config,\n      provider: parsed.provider,\n      model: parsed.model,\n    });\n  }\n\n  /**\n   * Apply a resolved pi-ai model and sync {@link currentModelName} / {@link currentProvider}.\n   */\n  applyResolvedModel(agent: Agent, model: Model<Api>, modelRef: string): void {\n    agent.state.model = model;\n    this.currentModelName = modelRef;\n    this.currentProvider = model.provider || 'unknown';\n  }\n\n  /**\n   * Run the agent with automatic model fallback on failure.\n   */\n  async runWithFallback(\n    agent: Agent,\n    sessionKey: string,\n    userMessage: AgentMessage,\n    provider: string,\n    model: string\n  ): Promise<RunResult> {\n    const candidates = resolveFallbackCandidates({\n      cfg: this.config ?? undefined,\n      provider,\n      model,\n    });\n\n    let lastError: unknown;\n\n    for (let i = 0; i < candidates.length; i++) {\n      const candidate = candidates[i];\n      const modelRef = `${candidate.provider}/${candidate.model}`;\n\n      let candidateModel: Model<Api>;\n      try {\n        candidateModel = resolveModel(modelRef);\n      } catch {\n        log.warn({ provider: candidate.provider, model: candidate.model }, 'Fallback model not found');\n        continue;\n      }\n\n      log.info(\n        { attempt: i + 1, total: candidates.length, provider: candidate.provider, model: candidate.model },\n        'Attempting model',\n      );\n\n      const beforeLen = agent.state.messages.length;\n\n      try {\n        this.applyResolvedModel(agent, candidateModel, modelRef);\n\n        const runTurn = async () => {\n          await agent.prompt(userMessage);\n          await agent.waitForIdle();\n          await maybeRetryTurnAfterTransientLlmFailure(agent, { sessionKey, log });\n        };\n\n        await runAgentTurnWithTimeout(agent, runTurn, resolveAgentTurnTimeoutMs(this.config));\n\n        if (isAssistantTurnAborted(agent)) {\n          const usage = (agent.state as { lastUsage?: RunResult['usage'] }).lastUsage;\n          return { content: getLastAssistantContent(agent), usage };\n        }\n\n        if (!isAssistantTurnFailed(agent)) {\n          const usage = (agent.state as { lastUsage?: RunResult['usage'] }).lastUsage;\n          log.info(\n            { provider: candidate.provider, model: candidate.model, success: true },\n            'Model call completed',\n          );\n          return { content: getLastAssistantContent(agent), usage };\n        }\n\n        lastError = new Error(`Assistant turn failed: ${modelRef}`);\n        log.warn(\n          { attempt: i + 1, sessionKey, modelRef },\n          'Model turn failed after retries, trying fallback',\n        );\n      } catch (err) {\n        lastError = err;\n        if (err instanceof DOMException && err.name === 'AbortError') {\n          log.info({ sessionKey }, 'User aborted model call');\n          throw err;\n        }\n\n        const errorDetails = {\n          attempt: i + 1,\n          provider: candidate.provider,\n          model: candidate.model,\n          errorMessage: err instanceof Error ? err.message : String(err),\n        };\n\n        if (isFailoverError(err)) {\n          const described = describeFailoverError(err);\n          log.warn({ ...errorDetails, ...described }, 'Model call failed, trying fallback');\n        } else {\n          log.warn(errorDetails, 'Model call failed, trying fallback');\n        }\n      }\n\n      agent.state.messages = agent.state.messages.slice(0, beforeLen);\n    }\n\n    if (lastError) {\n      const em = lastError instanceof Error ? lastError.message : String(lastError);\n      const attemptedModelRefs = candidates.map((c) => `${c.provider}/${c.model}`);\n      log.error(\n        {\n          err: lastError instanceof Error ? lastError : undefined,\n          errorMessage: em,\n          attemptedCandidates: candidates.length,\n          attemptedModelRefs,\n          sessionKey,\n        },\n        `All model candidates failed (${candidates.length} refs): ${em}`,\n      );\n      throw lastError instanceof Error ? lastError : new Error(String(lastError));\n    }\n\n    return { content: null };\n  }\n\n  /**\n   * Find model by reference (provider/modelId)\n   */\n  findByRef(ref: string): Model<Api> | undefined {\n    try {\n      return resolveModel(ref);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Find model by provider and ID\n   */\n  find(provider: string, modelId: string): Model<Api> | undefined {\n    try {\n      return resolveModel(`${provider}/${modelId}`);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Get all available models\n   */\n  getAllModels(): readonly Model<Api>[] {\n    return getAllModelsFromProviders();\n  }\n\n  /**\n   * Get models grouped by provider\n   */\n  getModelsByProvider(): Map<string, Model<Api>[]> {\n    const all = this.getAllModels();\n    const grouped = new Map<string, Model<Api>[]>();\n    for (const model of all) {\n      const list = grouped.get(model.provider) ?? [];\n      list.push(model);\n      grouped.set(model.provider, list);\n    }\n    return grouped;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":["getAllModelsFromProviders"],"sources":["../../../../src/agent/models/manager.ts"],"sourcesContent":["/**\n * Model management module\n * \n * Handles model selection, switching, and automatic fallback\n * when a provider fails.\n */\n\nimport { Agent, type AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport { type Config, getAgentDefaultModelRef } from '../../config/schema.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveModel, getAllModels as getAllModelsFromProviders, getDefaultModelSync } from '../../providers/index.js';\nimport {\n  isFailoverError,\n  describeFailoverError,\n  resolveFallbackCandidates,\n  type ModelCandidate,\n} from '../fallback/index.js';\nimport { parseModelRef } from './selection.js';\nimport {\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n  maybeRetryTurnAfterTransientLlmFailure,\n} from '../orchestration/llm-turn-retry.js';\nimport {\n  resolveAgentTurnTimeoutMs,\n  runAgentTurnWithTimeout,\n} from '../orchestration/run-agent-turn-with-timeout.js';\n\nconst log = createLogger('ModelManager');\n\nexport interface ModelManagerConfig {\n  defaultModel?: string;\n  config?: Config;\n}\n\nexport interface RunResult {\n  content: string | null;\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\n/**\n * Get the last assistant content from agent messages\n */\nfunction getLastAssistantContent(agent: Agent): string | null {\n  const messages = agent.state.messages;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (msg.role === 'assistant') {\n      return msg.content\n        .filter((c) => c.type === 'text')\n        .map((c) => c.text || '')\n        .join('');\n    }\n  }\n  return null;\n}\n\nexport class ModelManager {\n  private defaultModel: string;\n  private config?: Config;\n  private currentModelName: string;\n  private currentProvider: string;\n  private sessionModels: Map<string, string> = new Map();\n  /** Baseline model from `agents.list` / defaults merge when the session agent is created. */\n  private sessionProfileDefaults: Map<string, string> = new Map();\n  private channelManager?: any;\n\n  constructor(config: ModelManagerConfig = {}) {\n    this.config = config.config;\n    this.defaultModel = config.defaultModel || getDefaultModelSync(config.config);\n    this.currentModelName = this.defaultModel;\n    this.currentProvider = this.defaultModel.split('/')[0] || 'anthropic';\n  }\n\n  /**\n   * Set channel manager reference for accessing session-specific settings\n   */\n  setChannelManager(channelManager: any): void {\n    this.channelManager = channelManager;\n  }\n\n  /**\n   * Apply updated config so default model and failover metadata match disk/runtime config.\n   */\n  updateFromConfig(config: Config): void {\n    this.config = config;\n    const ref = getAgentDefaultModelRef(config);\n    this.defaultModel = ref ? ref : getDefaultModelSync(config);\n    this.sessionProfileDefaults.clear();\n  }\n\n  /**\n   * Set the config-derived default model for a session (from effective agent profile).\n   * Cleared by {@link updateFromConfig} or {@link clearSessionProfileDefault}.\n   */\n  setSessionProfileDefault(sessionKey: string, modelRef: string): void {\n    this.sessionProfileDefaults.set(sessionKey, modelRef);\n  }\n\n  clearSessionProfileDefault(sessionKey: string): void {\n    this.sessionProfileDefaults.delete(sessionKey);\n  }\n\n  /**\n   * Get current model name\n   */\n  getCurrentModel(): string {\n    return this.currentModelName;\n  }\n\n  /**\n   * Get current provider\n   */\n  getCurrentProvider(): string {\n    return this.currentProvider;\n  }\n\n  /**\n   * Switch model for a specific session\n   */\n  async switchModelForSession(sessionKey: string, modelId: string): Promise<boolean> {\n    try {\n      resolveModel(modelId);\n      this.sessionModels.set(sessionKey, modelId);\n      log.info({ sessionKey, modelId }, 'Model switched for session');\n      return true;\n    } catch (err) {\n      log.error({ err, sessionKey, modelId }, 'Failed to switch model');\n      return false;\n    }\n  }\n\n  /** Drop in-memory session override so the global default is used again. */\n  clearSessionModelOverride(sessionKey: string): void {\n    this.sessionModels.delete(sessionKey);\n  }\n\n  /**\n   * Resolved pi-ai model for session (for transcript policy, tools, etc.)\n   */\n  getResolvedModelForSession(sessionKey: string): Model<Api> {\n    return resolveModel(this.getModelForSession(sessionKey));\n  }\n\n  /**\n   * Get model for session, checking session override first\n   */\n  getModelForSession(sessionKey: string): string {\n    const sessionModel = this.sessionModels.get(sessionKey);\n    if (sessionModel) {\n      return sessionModel;\n    }\n\n    const profileDefault = this.sessionProfileDefaults.get(sessionKey);\n    if (profileDefault) {\n      return profileDefault;\n    }\n\n    return this.defaultModel;\n  }\n\n  /**\n   * Apply model to agent if different from current\n   */\n  async applyModelForSession(agent: Agent, sessionKey: string): Promise<void> {\n    const targetModelId = this.getModelForSession(sessionKey);\n\n    let found: Model<Api>;\n    try {\n      found = resolveModel(targetModelId);\n    } catch (err) {\n      log.error({ err, sessionKey, modelId: targetModelId }, 'Failed to apply model');\n      return;\n    }\n\n    const sm = agent.state.model as Model<Api> | undefined;\n    if (sm && sm.provider === found.provider && sm.id === found.id) {\n      this.currentModelName = targetModelId;\n      this.currentProvider = found.provider || 'unknown';\n      return;\n    }\n\n    agent.state.model = found;\n    this.currentModelName = targetModelId;\n    this.currentProvider = found.provider || 'unknown';\n\n    log.info({ sessionKey, modelId: targetModelId }, 'Applied model for session');\n  }\n\n  /**\n   * Ordered model candidates for the session.\n   */\n  getFallbackCandidatesForSession(sessionKey: string): ModelCandidate[] {\n    const ref = this.getModelForSession(sessionKey);\n    const parsed = parseModelRef(ref);\n    if (!parsed) {\n      return [];\n    }\n    return resolveFallbackCandidates({\n      cfg: this.config,\n      provider: parsed.provider,\n      model: parsed.model,\n    });\n  }\n\n  /**\n   * Apply a resolved pi-ai model and sync {@link currentModelName} / {@link currentProvider}.\n   */\n  applyResolvedModel(agent: Agent, model: Model<Api>, modelRef: string): void {\n    agent.state.model = model;\n    this.currentModelName = modelRef;\n    this.currentProvider = model.provider || 'unknown';\n  }\n\n  /**\n   * Run the agent with automatic model fallback on failure.\n   */\n  async runWithFallback(\n    agent: Agent,\n    sessionKey: string,\n    userMessage: AgentMessage,\n    provider: string,\n    model: string\n  ): Promise<RunResult> {\n    const candidates = resolveFallbackCandidates({\n      cfg: this.config ?? undefined,\n      provider,\n      model,\n    });\n\n    let lastError: unknown;\n\n    for (let i = 0; i < candidates.length; i++) {\n      const candidate = candidates[i];\n      const modelRef = `${candidate.provider}/${candidate.model}`;\n\n      let candidateModel: Model<Api>;\n      try {\n        candidateModel = resolveModel(modelRef);\n      } catch {\n        log.warn({ provider: candidate.provider, model: candidate.model }, 'Fallback model not found');\n        continue;\n      }\n\n      log.info(\n        { attempt: i + 1, total: candidates.length, provider: candidate.provider, model: candidate.model },\n        'Attempting model',\n      );\n\n      const beforeLen = agent.state.messages.length;\n\n      try {\n        this.applyResolvedModel(agent, candidateModel, modelRef);\n\n        const runTurn = async () => {\n          await agent.prompt(userMessage);\n          await agent.waitForIdle();\n          await maybeRetryTurnAfterTransientLlmFailure(agent, { sessionKey, log });\n        };\n\n        await runAgentTurnWithTimeout(agent, runTurn, resolveAgentTurnTimeoutMs(this.config));\n\n        if (isAssistantTurnAborted(agent)) {\n          const usage = (agent.state as { lastUsage?: RunResult['usage'] }).lastUsage;\n          return { content: getLastAssistantContent(agent), usage };\n        }\n\n        if (!isAssistantTurnFailed(agent)) {\n          const usage = (agent.state as { lastUsage?: RunResult['usage'] }).lastUsage;\n          log.info(\n            { provider: candidate.provider, model: candidate.model, success: true },\n            'Model call completed',\n          );\n          return { content: getLastAssistantContent(agent), usage };\n        }\n\n        lastError = new Error(`Assistant turn failed: ${modelRef}`);\n        log.warn(\n          { attempt: i + 1, sessionKey, modelRef },\n          'Model turn failed after retries, trying fallback',\n        );\n      } catch (err) {\n        lastError = err;\n        if (err instanceof DOMException && err.name === 'AbortError') {\n          log.info({ sessionKey }, 'User aborted model call');\n          throw err;\n        }\n\n        const errorDetails = {\n          attempt: i + 1,\n          provider: candidate.provider,\n          model: candidate.model,\n          errorMessage: err instanceof Error ? err.message : String(err),\n        };\n\n        if (isFailoverError(err)) {\n          const described = describeFailoverError(err);\n          log.warn({ ...errorDetails, ...described }, 'Model call failed, trying fallback');\n        } else {\n          log.warn(errorDetails, 'Model call failed, trying fallback');\n        }\n      }\n\n      agent.state.messages = agent.state.messages.slice(0, beforeLen);\n    }\n\n    if (lastError) {\n      const em = lastError instanceof Error ? lastError.message : String(lastError);\n      const attemptedModelRefs = candidates.map((c) => `${c.provider}/${c.model}`);\n      log.error(\n        {\n          err: lastError instanceof Error ? lastError : undefined,\n          errorMessage: em,\n          attemptedCandidates: candidates.length,\n          attemptedModelRefs,\n          sessionKey,\n        },\n        `All model candidates failed (${candidates.length} refs): ${em}`,\n      );\n      throw lastError instanceof Error ? lastError : new Error(String(lastError));\n    }\n\n    return { content: null };\n  }\n\n  /**\n   * Find model by reference (provider/modelId)\n   */\n  findByRef(ref: string): Model<Api> | undefined {\n    try {\n      return resolveModel(ref);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Find model by provider and ID\n   */\n  find(provider: string, modelId: string): Model<Api> | undefined {\n    try {\n      return resolveModel(`${provider}/${modelId}`);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Get all available models\n   */\n  getAllModels(): readonly Model<Api>[] {\n    return getAllModelsFromProviders();\n  }\n\n  /**\n   * Get models grouped by provider\n   */\n  getModelsByProvider(): Map<string, Model<Api>[]> {\n    const all = this.getAllModels();\n    const grouped = new Map<string, Model<Api>[]>();\n    for (const model of all) {\n      const list = grouped.get(model.provider) ?? [];\n      list.push(model);\n      grouped.set(model.provider, list);\n    }\n    return grouped;\n  }\n}\n"],"mappings":";;;;;;;;;;;aAS8E;aACzB;gBACmE;AAkBxH,MAAM,MAAM,aAAa,eAAe;;;;AAmBxC,SAAS,wBAAwB,OAA6B;CAC5D,MAAM,WAAW,MAAM,MAAM;AAC7B,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;EAC7C,MAAM,MAAM,SAAS;AACrB,MAAI,IAAI,SAAS,YACf,QAAO,IAAI,QACR,QAAQ,MAAM,EAAE,SAAS,OAAO,CAChC,KAAK,MAAM,EAAE,QAAQ,GAAG,CACxB,KAAK,GAAG;;AAGf,QAAO;;AAGT,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CACA,gCAA6C,IAAI,KAAK;;CAEtD,yCAAsD,IAAI,KAAK;CAC/D;CAEA,YAAY,SAA6B,EAAE,EAAE;AAC3C,OAAK,SAAS,OAAO;AACrB,OAAK,eAAe,OAAO,gBAAgB,oBAAoB,OAAO,OAAO;AAC7E,OAAK,mBAAmB,KAAK;AAC7B,OAAK,kBAAkB,KAAK,aAAa,MAAM,IAAI,CAAC,MAAM;;;;;CAM5D,kBAAkB,gBAA2B;AAC3C,OAAK,iBAAiB;;;;;CAMxB,iBAAiB,QAAsB;AACrC,OAAK,SAAS;EACd,MAAM,MAAM,wBAAwB,OAAO;AAC3C,OAAK,eAAe,MAAM,MAAM,oBAAoB,OAAO;AAC3D,OAAK,uBAAuB,OAAO;;;;;;CAOrC,yBAAyB,YAAoB,UAAwB;AACnE,OAAK,uBAAuB,IAAI,YAAY,SAAS;;CAGvD,2BAA2B,YAA0B;AACnD,OAAK,uBAAuB,OAAO,WAAW;;;;;CAMhD,kBAA0B;AACxB,SAAO,KAAK;;;;;CAMd,qBAA6B;AAC3B,SAAO,KAAK;;;;;CAMd,MAAM,sBAAsB,YAAoB,SAAmC;AACjF,MAAI;AACF,gBAAa,QAAQ;AACrB,QAAK,cAAc,IAAI,YAAY,QAAQ;AAC3C,OAAI,KAAK;IAAE;IAAY;IAAS,EAAE,6BAA6B;AAC/D,UAAO;WACA,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAY;IAAS,EAAE,yBAAyB;AACjE,UAAO;;;;CAKX,0BAA0B,YAA0B;AAClD,OAAK,cAAc,OAAO,WAAW;;;;;CAMvC,2BAA2B,YAAgC;AACzD,SAAO,aAAa,KAAK,mBAAmB,WAAW,CAAC;;;;;CAM1D,mBAAmB,YAA4B;EAC7C,MAAM,eAAe,KAAK,cAAc,IAAI,WAAW;AACvD,MAAI,aACF,QAAO;EAGT,MAAM,iBAAiB,KAAK,uBAAuB,IAAI,WAAW;AAClE,MAAI,eACF,QAAO;AAGT,SAAO,KAAK;;;;;CAMd,MAAM,qBAAqB,OAAc,YAAmC;EAC1E,MAAM,gBAAgB,KAAK,mBAAmB,WAAW;EAEzD,IAAI;AACJ,MAAI;AACF,WAAQ,aAAa,cAAc;WAC5B,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAY,SAAS;IAAe,EAAE,wBAAwB;AAC/E;;EAGF,MAAM,KAAK,MAAM,MAAM;AACvB,MAAI,MAAM,GAAG,aAAa,MAAM,YAAY,GAAG,OAAO,MAAM,IAAI;AAC9D,QAAK,mBAAmB;AACxB,QAAK,kBAAkB,MAAM,YAAY;AACzC;;AAGF,QAAM,MAAM,QAAQ;AACpB,OAAK,mBAAmB;AACxB,OAAK,kBAAkB,MAAM,YAAY;AAEzC,MAAI,KAAK;GAAE;GAAY,SAAS;GAAe,EAAE,4BAA4B;;;;;CAM/E,gCAAgC,YAAsC;EAEpE,MAAM,SAAS,cADH,KAAK,mBAAmB,WACJ,CAAC;AACjC,MAAI,CAAC,OACH,QAAO,EAAE;AAEX,SAAO,0BAA0B;GAC/B,KAAK,KAAK;GACV,UAAU,OAAO;GACjB,OAAO,OAAO;GACf,CAAC;;;;;CAMJ,mBAAmB,OAAc,OAAmB,UAAwB;AAC1E,QAAM,MAAM,QAAQ;AACpB,OAAK,mBAAmB;AACxB,OAAK,kBAAkB,MAAM,YAAY;;;;;CAM3C,MAAM,gBACJ,OACA,YACA,aACA,UACA,OACoB;EACpB,MAAM,aAAa,0BAA0B;GAC3C,KAAK,KAAK,UAAU,KAAA;GACpB;GACA;GACD,CAAC;EAEF,IAAI;AAEJ,OAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;GAC1C,MAAM,YAAY,WAAW;GAC7B,MAAM,WAAW,GAAG,UAAU,SAAS,GAAG,UAAU;GAEpD,IAAI;AACJ,OAAI;AACF,qBAAiB,aAAa,SAAS;WACjC;AACN,QAAI,KAAK;KAAE,UAAU,UAAU;KAAU,OAAO,UAAU;KAAO,EAAE,2BAA2B;AAC9F;;AAGF,OAAI,KACF;IAAE,SAAS,IAAI;IAAG,OAAO,WAAW;IAAQ,UAAU,UAAU;IAAU,OAAO,UAAU;IAAO,EAClG,mBACD;GAED,MAAM,YAAY,MAAM,MAAM,SAAS;AAEvC,OAAI;AACF,SAAK,mBAAmB,OAAO,gBAAgB,SAAS;IAExD,MAAM,UAAU,YAAY;AAC1B,WAAM,MAAM,OAAO,YAAY;AAC/B,WAAM,MAAM,aAAa;AACzB,WAAM,uCAAuC,OAAO;MAAE;MAAY;MAAK,CAAC;;AAG1E,UAAM,wBAAwB,OAAO,SAAS,0BAA0B,KAAK,OAAO,CAAC;AAErF,QAAI,uBAAuB,MAAM,EAAE;KACjC,MAAM,QAAS,MAAM,MAA6C;AAClE,YAAO;MAAE,SAAS,wBAAwB,MAAM;MAAE;MAAO;;AAG3D,QAAI,CAAC,sBAAsB,MAAM,EAAE;KACjC,MAAM,QAAS,MAAM,MAA6C;AAClE,SAAI,KACF;MAAE,UAAU,UAAU;MAAU,OAAO,UAAU;MAAO,SAAS;MAAM,EACvE,uBACD;AACD,YAAO;MAAE,SAAS,wBAAwB,MAAM;MAAE;MAAO;;AAG3D,gCAAY,IAAI,MAAM,0BAA0B,WAAW;AAC3D,QAAI,KACF;KAAE,SAAS,IAAI;KAAG;KAAY;KAAU,EACxC,mDACD;YACM,KAAK;AACZ,gBAAY;AACZ,QAAI,eAAe,gBAAgB,IAAI,SAAS,cAAc;AAC5D,SAAI,KAAK,EAAE,YAAY,EAAE,0BAA0B;AACnD,WAAM;;IAGR,MAAM,eAAe;KACnB,SAAS,IAAI;KACb,UAAU,UAAU;KACpB,OAAO,UAAU;KACjB,cAAc,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;KAC/D;AAED,QAAI,gBAAgB,IAAI,EAAE;KACxB,MAAM,YAAY,sBAAsB,IAAI;AAC5C,SAAI,KAAK;MAAE,GAAG;MAAc,GAAG;MAAW,EAAE,qCAAqC;UAEjF,KAAI,KAAK,cAAc,qCAAqC;;AAIhE,SAAM,MAAM,WAAW,MAAM,MAAM,SAAS,MAAM,GAAG,UAAU;;AAGjE,MAAI,WAAW;GACb,MAAM,KAAK,qBAAqB,QAAQ,UAAU,UAAU,OAAO,UAAU;GAC7E,MAAM,qBAAqB,WAAW,KAAK,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ;AAC5E,OAAI,MACF;IACE,KAAK,qBAAqB,QAAQ,YAAY,KAAA;IAC9C,cAAc;IACd,qBAAqB,WAAW;IAChC;IACA;IACD,EACD,gCAAgC,WAAW,OAAO,UAAU,KAC7D;AACD,SAAM,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,UAAU,CAAC;;AAG7E,SAAO,EAAE,SAAS,MAAM;;;;;CAM1B,UAAU,KAAqC;AAC7C,MAAI;AACF,UAAO,aAAa,IAAI;UAClB;AACN;;;;;;CAOJ,KAAK,UAAkB,SAAyC;AAC9D,MAAI;AACF,UAAO,aAAa,GAAG,SAAS,GAAG,UAAU;UACvC;AACN;;;;;;CAOJ,eAAsC;AACpC,SAAOA,cAA2B;;;;;CAMpC,sBAAiD;EAC/C,MAAM,MAAM,KAAK,cAAc;EAC/B,MAAM,0BAAU,IAAI,KAA2B;AAC/C,OAAK,MAAM,SAAS,KAAK;GACvB,MAAM,OAAO,QAAQ,IAAI,MAAM,SAAS,IAAI,EAAE;AAC9C,QAAK,KAAK,MAAM;AAChB,WAAQ,IAAI,MAAM,UAAU,KAAK;;AAEnC,SAAO"}

package/dist/src/agent/orchestration/agent-orchestrator.d.ts

@@ -35,7 +35,7 @@ export interface AgentOrchestratorConfig {
     getAgentInternalStorageRootForSession?: (sessionKey: string) => string;
     /** Fire-and-forget after full session persist (e.g. LLM session title); not called from mid-turn snapshots. */
     enqueueAutoTitle?: (sessionKey: string) => void;
-    /** For per-turn timeout via `agents.defaults.maxTaskDurationMs`. */
+    /** For per-turn timeout. */
     getConfig?: () => Config | undefined;
     /** Channel streaming: token/tool events from pi embedded session. */
     onEmbeddedStreamEvent?: (sessionKey: string, event: EmbeddedStreamEvent) => void;

package/dist/src/agent/orchestration/agent-orchestrator.js

@@ -95,7 +95,8 @@ var AgentOrchestrator = class {
 				} else {
 					const result = await runDreamingDeepPromotion({
 						workspaceDir,
-						config: resolved.phases.deep
+						config: resolved.phases.deep,
+						memoryManager: this.agentManager.getMemoryManagerForSession(sessionKey)
 					});
 					await appendDreamingEvent(workspaceDir, {
 						timestamp: (/* @__PURE__ */ new Date()).toISOString(),