@xopcai/xopc 0.0.116 → 0.0.117

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

@@ -1 +1 @@
-{"version":3,"file":"builtin-provider.js","names":[],"sources":["../../../../src/agent/memory/builtin-provider.ts"],"sourcesContent":["import type { BuiltinMemoryStore } from './builtin-memory-store.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\n\n/**\n * Builtin curated store: snapshot is injected via {@link MemorySnapshot} in the system prompt builder.\n * This provider participates in prefetch/sync orchestration only as a no-op.\n */\nexport class BuiltinMemoryProvider implements MemoryProvider {\n  readonly name = 'builtin';\n\n  constructor(private readonly _store: BuiltinMemoryStore) {}\n\n  isAvailable(): boolean {\n    return true;\n  }\n\n  async initialize(_sessionId: string, _options?: MemoryProviderInitOptions): Promise<void> {\n    void this._store;\n  }\n\n  /** Curated blocks are injected separately as frozen snapshot; avoid duplicating in provider merge. */\n  systemPromptBlock(): string {\n    return '';\n  }\n\n  async prefetch(): Promise<string> {\n    return '';\n  }\n\n  queuePrefetch(): void {}\n\n  syncTurn(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async handleToolCall(): Promise<string> {\n    return JSON.stringify({ error: 'Built-in memory uses curated_memory tool' });\n  }\n\n  async shutdown(): Promise<void> {}\n}\n"],"mappings":";;;;;AAOA,IAAa,wBAAb,MAA6D;CAC3D,OAAgB;CAEhB,YAAY,QAA6C;AAA5B,OAAA,SAAA;;CAE7B,cAAuB;AACrB,SAAO;;CAGT,MAAM,WAAW,YAAoB,UAAqD;AACnF,OAAK;;;CAIZ,oBAA4B;AAC1B,SAAO;;CAGT,MAAM,WAA4B;AAChC,SAAO;;CAGT,gBAAsB;CAEtB,WAAiB;CAEjB,iBAAiB;AACf,SAAO,EAAE;;CAGX,MAAM,iBAAkC;AACtC,SAAO,KAAK,UAAU,EAAE,OAAO,4CAA4C,CAAC;;CAG9E,MAAM,WAA0B"}
+{"version":3,"file":"builtin-provider.js","names":[],"sources":["../../../../src/agent/memory/builtin-provider.ts"],"sourcesContent":["import type { BuiltinMemoryStore } from './builtin-memory-store.js';\nimport type { MemoryProvider, MemoryProviderInitOptions } from './provider.js';\nimport { memoryGet, memorySearch } from '../prompt/memory/index.js';\nimport {\n  appendMemorySignal,\n  deleteMemoryRecord,\n  getMemoryRecord,\n  listMemoryRecords,\n  searchMemoryRecords,\n  upsertMemoryRecord,\n} from '../../storage/sqlite/index.js';\nimport type {\n  MemoryDeleteRequest,\n  MemoryListRequest,\n  MemoryReadRequest,\n  MemoryReadResult,\n  MemoryRecord,\n  MemorySearchRequest,\n  MemorySearchResult,\n  MemoryUpdateRequest,\n  MemoryWriteRequest,\n  MemoryWriteResult,\n  MemorySyncEvent,\n} from './types.js';\n\n/**\n * Builtin local memory provider backed by agent-home curated files, workspace MEMORY.md,\n * daily notes, and the local SQLite FTS index.\n */\nexport class BuiltinMemoryProvider implements MemoryProvider {\n  readonly id = 'local';\n  readonly displayName = 'Local Markdown Memory';\n  readonly capabilities = {\n    search: true,\n    read: true,\n    write: true,\n    update: true,\n    delete: true,\n    keywordSearch: true,\n    semanticSearch: false,\n    hybridSearch: false,\n    citations: true,\n    sync: false,\n    local: true,\n  };\n\n  private workspaceDir = '';\n  private agentId = 'main';\n\n  constructor(private readonly store: BuiltinMemoryStore) {}\n\n  isAvailable(): boolean {\n    return true;\n  }\n\n  async initialize(_sessionId: string, options?: MemoryProviderInitOptions): Promise<void> {\n    this.workspaceDir = options?.workspace ?? options?.agentWorkspace ?? this.store.workspaceDir;\n    this.agentId = String(options?.agentId ?? this.agentId);\n  }\n\n  systemPromptBlock(): string {\n    return '';\n  }\n\n  async prefetch(): Promise<string> {\n    return '';\n  }\n\n  queuePrefetch(): void {}\n\n  getToolSchemas() {\n    return [];\n  }\n\n  async search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n    const agentId = request.scope?.agentId ?? this.agentId;\n    const workspaceId = request.scope?.workspaceId ?? this.workspaceDir;\n    const recordHits = searchMemoryRecords({\n      query: request.query,\n      agentId,\n      workspaceId,\n      providerId: this.id,\n      kinds: request.kinds,\n      maxResults: request.maxResults,\n      minScore: request.minScore,\n    });\n    if (recordHits.length > 0) {\n      return recordHits;\n    }\n\n    const results = await memorySearch(this.workspaceDir, request.query, {\n      maxResults: request.maxResults,\n      minScore: request.minScore,\n      memoriesDir: this.store.memoriesDir,\n      agentId,\n    });\n    return results.map((entry) => {\n      const start = entry.lineNumbers[0] ?? 1;\n      const end = entry.lineNumbers[entry.lineNumbers.length - 1] ?? start;\n      const id = `${entry.file}#L${start}-L${end}`;\n      const kind = inferKindFromPath(entry.file);\n      const record = upsertMemoryRecord({\n        id,\n        providerId: this.id,\n        kind,\n        agentId,\n        workspaceId,\n        content: entry.lines,\n        source: {\n          provider: this.id,\n          path: entry.file,\n          lineStart: start,\n          lineEnd: end,\n        },\n        confidence: entry.score,\n      });\n      return {\n        record,\n        score: entry.score,\n        snippet: entry.lines,\n        citation: {\n          providerId: this.id,\n          recordId: id,\n          path: entry.file,\n          lineStart: start,\n          lineEnd: end,\n        },\n      };\n    });\n  }\n\n  async read(request: MemoryReadRequest): Promise<MemoryReadResult | null> {\n    if (request.id && !request.path) {\n      const existing = getMemoryRecord(request.id);\n      if (existing) {\n        return { record: existing };\n      }\n    }\n    const result = memoryGet(\n      this.workspaceDir,\n      request.path ?? request.id ?? '',\n      request.from,\n      request.lines,\n      this.store.memoriesDir,\n    );\n    if (!result) return null;\n    const path = request.path ?? request.id ?? '';\n    const record = upsertMemoryRecord({\n      id: `${path}#L${result.lineNumbers.start}-L${result.lineNumbers.end}`,\n      providerId: this.id,\n      kind: inferKindFromPath(path),\n      agentId: request.scope?.agentId ?? this.agentId,\n      workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n      content: result.content,\n      source: {\n        provider: this.id,\n        path,\n        lineStart: result.lineNumbers.start,\n        lineEnd: result.lineNumbers.end,\n      },\n    });\n    return {\n      record,\n      lineNumbers: result.lineNumbers,\n    };\n  }\n\n  async get(id: string): Promise<MemoryRecord | null> {\n    const parsed = parseLineAddress(id);\n    const result = await this.read({\n      path: parsed.path,\n      from: parsed.lineStart,\n      lines: parsed.lineEnd != null ? parsed.lineEnd - parsed.lineStart + 1 : undefined,\n    });\n    return result?.record ?? null;\n  }\n\n  async list(request: MemoryListRequest): Promise<MemoryRecord[]> {\n    const records = listMemoryRecords({\n      providerId: this.id,\n      agentId: request.scope?.agentId ?? this.agentId,\n      workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n      kind: request.kind,\n      limit: 200,\n    });\n    if (records.length > 0 || request.kind) {\n      return request.target\n        ? records.filter((record) => targetForKind(record.kind) === request.target)\n        : records;\n    }\n\n    const target = request.target ?? (request.kind === 'user_profile' ? 'user' : 'memory');\n    return this.store.getLiveEntries(target).map((content, index) =>\n      upsertMemoryRecord({\n        id: `curated:${target}:${index + 1}`,\n        providerId: this.id,\n        kind: target === 'user' ? 'user_profile' : 'agent_note',\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        content,\n        source: {\n          provider: this.id,\n          path: target === 'user' ? 'USER.md' : 'MEMORY.md',\n        },\n      }),\n    );\n  }\n\n  async write(request: MemoryWriteRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? (request.kind === 'user_profile' ? 'user' : 'memory');\n    const result = await this.store.add(target, request.content);\n    if (!result.success) return { success: false, error: result.error };\n    return {\n      success: true,\n      message: result.message,\n      record: upsertMemoryRecord({\n        id: `curated:${target}:${Date.now()}`,\n        providerId: this.id,\n        kind: target === 'user' ? 'user_profile' : request.kind,\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: request.scope?.sessionKey,\n        content: request.content,\n        source: {\n          ...(request.source ?? {}),\n          provider: this.id,\n          path: target === 'user' ? 'USER.md' : 'MEMORY.md',\n        },\n        tags: request.tags,\n      }),\n    };\n  }\n\n  async update(request: MemoryUpdateRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? 'memory';\n    const result = await this.store.replace(target, request.matchText ?? request.id ?? '', request.content);\n    if (!result.success) return { success: false, error: result.error };\n    if (request.id) {\n      const existing = getMemoryRecord(request.id);\n      upsertMemoryRecord({\n        id: request.id,\n        providerId: this.id,\n        kind: existing?.kind ?? (target === 'user' ? 'user_profile' : 'agent_note'),\n        agentId: existing?.scope.agentId ?? request.scope?.agentId ?? this.agentId,\n        workspaceId: existing?.scope.workspaceId ?? request.scope?.workspaceId ?? this.workspaceDir,\n        sessionKey: existing?.scope.sessionKey ?? request.scope?.sessionKey,\n        content: request.content,\n        source: existing?.source ?? { provider: this.id, path: target === 'user' ? 'USER.md' : 'MEMORY.md' },\n        tags: existing?.tags,\n      });\n    } else if (request.matchText) {\n      for (const existing of listMemoryRecords({\n        providerId: this.id,\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        kind: target === 'user' ? 'user_profile' : 'agent_note',\n        limit: 200,\n      })) {\n        if (!existing.content.includes(request.matchText)) continue;\n        upsertMemoryRecord({\n          id: existing.id,\n          providerId: this.id,\n          kind: existing.kind,\n          agentId: existing.scope.agentId,\n          workspaceId: existing.scope.workspaceId,\n          sessionKey: existing.scope.sessionKey,\n          content: request.content,\n          source: existing.source,\n          tags: existing.tags,\n        });\n      }\n    }\n    return { success: true, message: result.message };\n  }\n\n  async delete(request: MemoryDeleteRequest): Promise<MemoryWriteResult> {\n    const target = request.target ?? 'memory';\n    const result = await this.store.remove(target, request.matchText ?? request.id ?? '');\n    if (!result.success) return { success: false, error: result.error };\n    if (request.id) {\n      deleteMemoryRecord(request.id);\n    } else if (request.matchText) {\n      for (const existing of listMemoryRecords({\n        providerId: this.id,\n        agentId: request.scope?.agentId ?? this.agentId,\n        workspaceId: request.scope?.workspaceId ?? this.workspaceDir,\n        kind: target === 'user' ? 'user_profile' : 'agent_note',\n        limit: 200,\n      })) {\n        if (existing.content.includes(request.matchText)) {\n          deleteMemoryRecord(existing.id);\n        }\n      }\n    }\n    return { success: true, message: result.message };\n  }\n\n  sync(event: MemorySyncEvent): void {\n    if (event.type !== 'signal') return;\n    appendMemorySignal({\n      signal: event.signal,\n      providerId: this.id,\n      agentId: this.agentId,\n      workspaceId: this.workspaceDir,\n      sessionKey:\n        typeof event.signal.metadata?.sessionKey === 'string'\n          ? event.signal.metadata.sessionKey\n          : undefined,\n    });\n  }\n\n  async shutdown(): Promise<void> {}\n}\n\nfunction inferKindFromPath(path: string): MemoryRecord['kind'] {\n  if (path.endsWith('USER.md')) return 'user_profile';\n  if (path.endsWith('MEMORY.md')) return 'agent_note';\n  if (/^memory\\/\\d{4}-\\d{2}-\\d{2}\\.md$/.test(path)) return 'daily_note';\n  return 'workspace_fact';\n}\n\nfunction targetForKind(kind: MemoryRecord['kind']): 'memory' | 'user' {\n  return kind === 'user_profile' ? 'user' : 'memory';\n}\n\nfunction parseLineAddress(id: string): { path: string; lineStart?: number; lineEnd?: number } {\n  const match = /^(.*)#L(\\d+)(?:-L(\\d+))?$/.exec(id);\n  if (!match) return { path: id };\n  const lineStart = Number.parseInt(match[2] ?? '1', 10);\n  const lineEnd = Number.parseInt(match[3] ?? match[2] ?? '1', 10);\n  return {\n    path: match[1] ?? id,\n    lineStart: Number.isFinite(lineStart) ? lineStart : undefined,\n    lineEnd: Number.isFinite(lineEnd) ? lineEnd : undefined,\n  };\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/context-assembler.d.ts

@@ -0,0 +1,10 @@
+import type { MemoryManager } from './manager.js';
+export interface MemoryContextAssemblerOptions {
+    memoryManager: MemoryManager;
+    sessionKey: string;
+    query: string;
+    maxSearchResults?: number;
+}
+export declare class MemoryContextAssembler {
+    assemble(options: MemoryContextAssemblerOptions): Promise<string>;
+}

package/dist/src/agent/memory/context-assembler.js

@@ -0,0 +1,26 @@
+import { buildMemoryContextBlock } from "./context-fence.js";
+//#region src/agent/memory/context-assembler.ts
+var MemoryContextAssembler = class {
+	async assemble(options) {
+		const query = options.query.trim();
+		if (!query) return "";
+		const [prefetch, searchResults] = await Promise.all([options.memoryManager.prefetchAll(query, { sessionId: options.sessionKey }), options.memoryManager.search({
+			query,
+			scope: { sessionKey: options.sessionKey },
+			maxResults: options.maxSearchResults ?? 3,
+			minScore: .2
+		}).catch(() => [])]);
+		const lines = [];
+		if (prefetch.trim()) lines.push(prefetch.trim());
+		for (const result of searchResults) {
+			const path = result.citation.path ?? result.record.id;
+			const range = result.citation.lineStart != null ? `#L${result.citation.lineStart}${result.citation.lineEnd && result.citation.lineEnd !== result.citation.lineStart ? `-L${result.citation.lineEnd}` : ""}` : "";
+			lines.push(`- ${result.snippet.trim()}\n  Source: ${path}${range}`);
+		}
+		return buildMemoryContextBlock(lines.join("\n\n"));
+	}
+};
+//#endregion
+export { MemoryContextAssembler };
+
+//# sourceMappingURL=context-assembler.js.map

package/dist/src/agent/memory/context-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.js","names":[],"sources":["../../../../src/agent/memory/context-assembler.ts"],"sourcesContent":["import { buildMemoryContextBlock } from './context-fence.js';\nimport type { MemoryManager } from './manager.js';\n\nexport interface MemoryContextAssemblerOptions {\n  memoryManager: MemoryManager;\n  sessionKey: string;\n  query: string;\n  maxSearchResults?: number;\n}\n\nexport class MemoryContextAssembler {\n  async assemble(options: MemoryContextAssemblerOptions): Promise<string> {\n    const query = options.query.trim();\n    if (!query) return '';\n\n    const [prefetch, searchResults] = await Promise.all([\n      options.memoryManager.prefetchAll(query, { sessionId: options.sessionKey }),\n      options.memoryManager.search({\n        query,\n        scope: { sessionKey: options.sessionKey },\n        maxResults: options.maxSearchResults ?? 3,\n        minScore: 0.2,\n      }).catch(() => []),\n    ]);\n\n    const lines: string[] = [];\n    if (prefetch.trim()) {\n      lines.push(prefetch.trim());\n    }\n    for (const result of searchResults) {\n      const path = result.citation.path ?? result.record.id;\n      const range =\n        result.citation.lineStart != null\n          ? `#L${result.citation.lineStart}${result.citation.lineEnd && result.citation.lineEnd !== result.citation.lineStart ? `-L${result.citation.lineEnd}` : ''}`\n          : '';\n      lines.push(`- ${result.snippet.trim()}\\n  Source: ${path}${range}`);\n    }\n\n    return buildMemoryContextBlock(lines.join('\\n\\n'));\n  }\n}\n"],"mappings":";;AAUA,IAAa,yBAAb,MAAoC;CAClC,MAAM,SAAS,SAAyD;EACtE,MAAM,QAAQ,QAAQ,MAAM,MAAM;AAClC,MAAI,CAAC,MAAO,QAAO;EAEnB,MAAM,CAAC,UAAU,iBAAiB,MAAM,QAAQ,IAAI,CAClD,QAAQ,cAAc,YAAY,OAAO,EAAE,WAAW,QAAQ,YAAY,CAAC,EAC3E,QAAQ,cAAc,OAAO;GAC3B;GACA,OAAO,EAAE,YAAY,QAAQ,YAAY;GACzC,YAAY,QAAQ,oBAAoB;GACxC,UAAU;GACX,CAAC,CAAC,YAAY,EAAE,CAAC,CACnB,CAAC;EAEF,MAAM,QAAkB,EAAE;AAC1B,MAAI,SAAS,MAAM,CACjB,OAAM,KAAK,SAAS,MAAM,CAAC;AAE7B,OAAK,MAAM,UAAU,eAAe;GAClC,MAAM,OAAO,OAAO,SAAS,QAAQ,OAAO,OAAO;GACnD,MAAM,QACJ,OAAO,SAAS,aAAa,OACzB,KAAK,OAAO,SAAS,YAAY,OAAO,SAAS,WAAW,OAAO,SAAS,YAAY,OAAO,SAAS,YAAY,KAAK,OAAO,SAAS,YAAY,OACrJ;AACN,SAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,CAAC,cAAc,OAAO,QAAQ;;AAGrE,SAAO,wBAAwB,MAAM,KAAK,OAAO,CAAC"}

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

@@ -1,18 +1,36 @@
+import { init_agent_scope, resolveAgentIdForWorkspacePath } from "../agent-scope.js";
+import { resolveEffectiveAgentManifestForAgent } from "../../config/agent-profile.js";
 import { isMemorySubsystemEnabled } from "./memory-config.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
-import { StubMemoryProvider } from "./stub-memory-provider.js";
+import { loadMemoryPluginProviders } from "./plugin-discovery.js";
 //#region src/agent/memory/create-memory-manager.ts
+init_agent_scope();
 function createMemoryManagerFromConfig(_workspaceDir, store, config) {
-	const mgr = new MemoryManager();
+	const routing = resolveMemoryManagerOptions(_workspaceDir, config);
+	const enabled = isMemorySubsystemEnabled(config);
+	const mgr = new MemoryManager({
+		...routing,
+		...enabled ? { loadProviders: () => loadMemoryPluginProviders({ config }) } : {}
+	});
 	mgr.addProvider(new BuiltinMemoryProvider(store));
-	if (!isMemorySubsystemEnabled(config)) return mgr;
-	if ((config?.agents?.defaults?.memory?.provider ?? "none") === "stub") {
-		const stub = new StubMemoryProvider();
-		if (stub.isAvailable()) mgr.addProvider(stub);
-	}
+	if (!enabled) return mgr;
 	return mgr;
 }
+function resolveMemoryManagerOptions(workspaceDir, config) {
+	if (!config) return {};
+	const providerRouting = resolveEffectiveAgentManifestForAgent(config, resolveAgentIdForWorkspacePath(config, workspaceDir)).memory.providerRouting;
+	if (!providerRouting) return {};
+	return {
+		searchStrategy: providerRouting.searchStrategy,
+		writeStrategy: providerRouting.writeStrategy,
+		writePolicy: {
+			allowExternalWrites: providerRouting.allowExternalWrites,
+			allowedProviderIds: providerRouting.allowedProviderIds,
+			autoWriteKinds: providerRouting.autoWriteKinds
+		}
+	};
+}
 //#endregion
 export { createMemoryManagerFromConfig };
 

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

@@ -1 +1 @@
-{"version":3,"file":"create-memory-manager.js","names":[],"sources":["../../../../src/agent/memory/create-memory-manager.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { BuiltinMemoryStore } from './builtin-memory-store.js';\nimport { BuiltinMemoryProvider } from './builtin-provider.js';\nimport { isMemorySubsystemEnabled } from './memory-config.js';\nimport { MemoryManager } from './manager.js';\nimport { StubMemoryProvider } from './stub-memory-provider.js';\n\nexport type MemoryProviderId = 'none' | 'stub';\n\nexport function createMemoryManagerFromConfig(\n  _workspaceDir: string,\n  store: BuiltinMemoryStore,\n  config: Config | undefined,\n): MemoryManager {\n  const mgr = new MemoryManager();\n  mgr.addProvider(new BuiltinMemoryProvider(store));\n\n  if (!isMemorySubsystemEnabled(config)) {\n    return mgr;\n  }\n\n  const id = (config?.agents?.defaults?.memory?.provider ?? 'none') as MemoryProviderId;\n  if (id === 'stub') {\n    const stub = new StubMemoryProvider();\n    if (stub.isAvailable()) {\n      mgr.addProvider(stub);\n    }\n  }\n\n  return mgr;\n}\n"],"mappings":";;;;;AASA,SAAgB,8BACd,eACA,OACA,QACe;CACf,MAAM,MAAM,IAAI,eAAe;AAC/B,KAAI,YAAY,IAAI,sBAAsB,MAAM,CAAC;AAEjD,KAAI,CAAC,yBAAyB,OAAO,CACnC,QAAO;AAIT,MADY,QAAQ,QAAQ,UAAU,QAAQ,YAAY,YAC/C,QAAQ;EACjB,MAAM,OAAO,IAAI,oBAAoB;AACrC,MAAI,KAAK,aAAa,CACpB,KAAI,YAAY,KAAK;;AAIzB,QAAO"}
+{"version":3,"file":"create-memory-manager.js","names":[],"sources":["../../../../src/agent/memory/create-memory-manager.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../config/agent-profile.js';\nimport { resolveAgentIdForWorkspacePath } from '../agent-scope.js';\nimport { BuiltinMemoryStore } from './builtin-memory-store.js';\nimport { BuiltinMemoryProvider } from './builtin-provider.js';\nimport { isMemorySubsystemEnabled } from './memory-config.js';\nimport { MemoryManager, type MemoryManagerOptions } from './manager.js';\nimport { loadMemoryPluginProviders } from './plugin-discovery.js';\n\nexport type MemoryProviderId = 'none' | 'stub';\n\nexport function createMemoryManagerFromConfig(\n  _workspaceDir: string,\n  store: BuiltinMemoryStore,\n  config: Config | undefined,\n): MemoryManager {\n  const routing = resolveMemoryManagerOptions(_workspaceDir, config);\n  const enabled = isMemorySubsystemEnabled(config);\n  const mgr = new MemoryManager({\n    ...routing,\n    ...(enabled ? { loadProviders: () => loadMemoryPluginProviders({ config }) } : {}),\n  });\n  mgr.addProvider(new BuiltinMemoryProvider(store));\n\n  if (!enabled) {\n    return mgr;\n  }\n\n  return mgr;\n}\n\nfunction resolveMemoryManagerOptions(\n  workspaceDir: string,\n  config: Config | undefined,\n): Omit<MemoryManagerOptions, 'loadProviders'> {\n  if (!config) return {};\n  const agentId = resolveAgentIdForWorkspacePath(config, workspaceDir);\n  const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);\n  const providerRouting = manifest.memory.providerRouting;\n  if (!providerRouting) return {};\n  return {\n    searchStrategy: providerRouting.searchStrategy,\n    writeStrategy: providerRouting.writeStrategy,\n    writePolicy: {\n      allowExternalWrites: providerRouting.allowExternalWrites,\n      allowedProviderIds: providerRouting.allowedProviderIds,\n      autoWriteKinds: providerRouting.autoWriteKinds,\n    },\n  };\n}\n"],"mappings":";;;;;;;kBAEmE;AASnE,SAAgB,8BACd,eACA,OACA,QACe;CACf,MAAM,UAAU,4BAA4B,eAAe,OAAO;CAClE,MAAM,UAAU,yBAAyB,OAAO;CAChD,MAAM,MAAM,IAAI,cAAc;EAC5B,GAAG;EACH,GAAI,UAAU,EAAE,qBAAqB,0BAA0B,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE;EAClF,CAAC;AACF,KAAI,YAAY,IAAI,sBAAsB,MAAM,CAAC;AAEjD,KAAI,CAAC,QACH,QAAO;AAGT,QAAO;;AAGT,SAAS,4BACP,cACA,QAC6C;AAC7C,KAAI,CAAC,OAAQ,QAAO,EAAE;CAGtB,MAAM,kBADW,sCAAsC,QADvC,+BAA+B,QAAQ,aACe,CACtC,CAAC,OAAO;AACxC,KAAI,CAAC,gBAAiB,QAAO,EAAE;AAC/B,QAAO;EACL,gBAAgB,gBAAgB;EAChC,eAAe,gBAAgB;EAC/B,aAAa;GACX,qBAAqB,gBAAgB;GACrC,oBAAoB,gBAAgB;GACpC,gBAAgB,gBAAgB;GACjC;EACF"}

package/dist/src/agent/memory/dreaming/config.d.ts

@@ -35,12 +35,7 @@ export type DreamingResolvedConfig = {
     };
     deep: DreamingDeepConfig;
 };
-/**
- * Resolve the full three-phase dreaming config from the app Config.
- *
- * Reads through `any` so it can ship independently of the schema evolution.
- * Expected shape: `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.{light,deep,rem}.* }`
- */
+/** Resolve the full three-phase dreaming config from the default agent manifest. */
 export declare function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig;
 /** Get the cron expression for a specific phase from resolved config. */
 export declare function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string;

package/dist/src/agent/memory/dreaming/config.js

@@ -1,5 +1,8 @@
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent-scope.js";
+import { resolveEffectiveAgentManifestForAgent } from "../../../config/agent-profile.js";
 import { DEFAULT_DEEP_CRON, DEFAULT_LIGHT_CRON, DEFAULT_REM_CRON } from "./constants.js";
 //#region src/agent/memory/dreaming/config.ts
+init_agent_scope();
 function clampScore(value, fallback) {
 	if (!Number.isFinite(value)) return fallback;
 	return Math.max(0, Math.min(1, value));
@@ -22,15 +25,12 @@ function trimmedStringOr(value, fallback) {
 function optionalTrimmedString(value) {
 	return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-/**
-* Resolve the full three-phase dreaming config from the app Config.
-*
-* Reads through `any` so it can ship independently of the schema evolution.
-* Expected shape: `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.{light,deep,rem}.* }`
-*/
+/** Resolve the full three-phase dreaming config from the default agent manifest. */
 function resolveDreamingConfig(cfg) {
-	const dreaming = cfg?.agents?.defaults?.memory?.dreaming;
-	const enabled = dreaming?.enabled === true;
+	const agentId = cfg ? resolveDefaultAgentId(cfg) : void 0;
+	const manifest = cfg && agentId ? resolveEffectiveAgentManifestForAgent(cfg, agentId) : void 0;
+	const dreaming = manifest?.memory.dreaming;
+	const enabled = dreaming?.enabled === true && manifest?.memory.mode !== "off";
 	const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);
 	const timezone = optionalTrimmedString(dreaming?.timezone);
 	const lightRaw = dreaming?.phases?.light ?? {};

package/dist/src/agent/memory/dreaming/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["anyCfg"],"sources":["../../../../../src/agent/memory/dreaming/config.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_LIGHT_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DEFAULT_REM_CRON,\n  type DreamingPhaseId,\n} from './constants.js';\n\n// ── Phase config types ─────────────────────────────────────────────────\n\nexport type DreamingLightConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  dedupeSimilarity: number;\n};\n\nexport type DreamingDeepConfig = {\n  enabled: boolean;\n  cron: string;\n  minScore: number;\n  minRecallCount: number;\n  minUniqueQueries: number;\n  limit: number;\n  recencyHalfLifeDays: number;\n  maxAgeDays: number;\n};\n\nexport type DreamingRemConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  minPatternStrength: number;\n};\n\nexport type DreamingResolvedConfig = {\n  enabled: boolean;\n  frequency: string;\n  timezone?: string;\n  phases: {\n    light: DreamingLightConfig;\n    deep: DreamingDeepConfig;\n    rem: DreamingRemConfig;\n  };\n  deep: DreamingDeepConfig;\n};\n\n// ── Helpers ────────────────────────────────────────────────────────────\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction trimmedStringOr(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\nfunction optionalTrimmedString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\n// ── Resolver ───────────────────────────────────────────────────────────\n\n/**\n * Resolve the full three-phase dreaming config from the app Config.\n *\n * Reads through `any` so it can ship independently of the schema evolution.\n * Expected shape: `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.{light,deep,rem}.* }`\n */\nexport function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig {\n  const anyCfg = cfg as any;\n  const dreaming = anyCfg?.agents?.defaults?.memory?.dreaming;\n  const enabled = dreaming?.enabled === true;\n\n  const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);\n  const timezone = optionalTrimmedString(dreaming?.timezone);\n\n  // ── Light phase ────────────────────────────────────────────────────\n  const lightRaw = dreaming?.phases?.light ?? {};\n  const light: DreamingLightConfig = {\n    enabled: enabled && lightRaw?.enabled !== false,\n    cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),\n    lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),\n    limit: toNonNegInt(lightRaw?.limit, 100),\n    dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), 0.9),\n  };\n\n  // ── Deep phase ─────────────────────────────────────────────────────\n  const deepRaw = dreaming?.phases?.deep ?? {};\n  const deep: DreamingDeepConfig = {\n    enabled: enabled && deepRaw?.enabled !== false,\n    cron: trimmedStringOr(deepRaw?.cron, frequency),\n    minScore: clampScore(Number(deepRaw?.minScore), 0.8),\n    minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),\n    limit: toNonNegInt(deepRaw?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(deepRaw?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(deepRaw?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n\n  // ── REM phase ──────────────────────────────────────────────────────\n  const remRaw = dreaming?.phases?.rem ?? {};\n  const rem: DreamingRemConfig = {\n    enabled: enabled && remRaw?.enabled !== false,\n    cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),\n    lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),\n    limit: toNonNegInt(remRaw?.limit, 10),\n    minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), 0.75),\n  };\n\n  return {\n    enabled,\n    frequency,\n    ...(timezone ? { timezone } : {}),\n    phases: { light, deep, rem },\n    deep,\n  };\n}\n\n/** Get the cron expression for a specific phase from resolved config. */\nexport function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string {\n  return config.phases[phase].cron;\n}\n\n/** Check if a specific phase is enabled (global + phase-level). */\nexport function isPhaseEnabled(config: DreamingResolvedConfig, phase: DreamingPhaseId): boolean {\n  return config.enabled && config.phases[phase].enabled;\n}\n\n"],"mappings":";;AAqDA,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;AAGjC,SAAS,YAAY,OAAgB,UAA0B;CAC7D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,WAAW,IAAI,UAAU;;AAGlC,SAAS,gBAAgB,OAAgB,UAA0B;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG;;AAGpE,SAAS,sBAAsB,OAAoC;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA;;;;;;;;AAWpE,SAAgB,sBAAsB,KAAiD;CAErF,MAAM,WAAWA,KAAQ,QAAQ,UAAU,QAAQ;CACnD,MAAM,UAAU,UAAU,YAAY;CAEtC,MAAM,YAAY,gBAAgB,UAAU,WAAW,kBAAkB;CACzE,MAAM,WAAW,sBAAsB,UAAU,SAAS;CAG1D,MAAM,WAAW,UAAU,QAAQ,SAAS,EAAE;CAC9C,MAAM,QAA6B;EACjC,SAAS,WAAW,UAAU,YAAY;EAC1C,MAAM,gBAAgB,UAAU,MAAM,mBAAmB;EACzD,cAAc,cAAc,UAAU,cAAc,EAAE;EACtD,OAAO,YAAY,UAAU,OAAO,IAAI;EACxC,kBAAkB,WAAW,OAAO,UAAU,iBAAiB,EAAE,GAAI;EACtE;CAGD,MAAM,UAAU,UAAU,QAAQ,QAAQ,EAAE;CAC5C,MAAM,OAA2B;EAC/B,SAAS,WAAW,SAAS,YAAY;EACzC,MAAM,gBAAgB,SAAS,MAAM,UAAU;EAC/C,UAAU,WAAW,OAAO,SAAS,SAAS,EAAE,GAAI;EACpD,gBAAgB,cAAc,SAAS,gBAAgB,EAAE;EACzD,kBAAkB,cAAc,SAAS,kBAAkB,EAAE;EAC7D,OAAO,YAAY,SAAS,OAAO,GAAG;EACtC,qBAAqB,cAAc,SAAS,qBAAA,GAAoD;EAChG,YAAY,cAAc,SAAS,YAAA,GAAiC;EACrE;CAGD,MAAM,SAAS,UAAU,QAAQ,OAAO,EAAE;CAC1C,MAAM,MAAyB;EAC7B,SAAS,WAAW,QAAQ,YAAY;EACxC,MAAM,gBAAgB,QAAQ,MAAM,iBAAiB;EACrD,cAAc,cAAc,QAAQ,cAAc,EAAE;EACpD,OAAO,YAAY,QAAQ,OAAO,GAAG;EACrC,oBAAoB,WAAW,OAAO,QAAQ,mBAAmB,EAAE,IAAK;EACzE;AAED,QAAO;EACL;EACA;EACA,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,QAAQ;GAAE;GAAO;GAAM;GAAK;EAC5B;EACD;;;AAIH,SAAgB,aAAa,QAAgC,OAAgC;AAC3F,QAAO,OAAO,OAAO,OAAO;;;AAI9B,SAAgB,eAAe,QAAgC,OAAiC;AAC9F,QAAO,OAAO,WAAW,OAAO,OAAO,OAAO"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/config.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport { resolveDefaultAgentId } from '../../agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_LIGHT_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DEFAULT_REM_CRON,\n  type DreamingPhaseId,\n} from './constants.js';\n\n// ── Phase config types ─────────────────────────────────────────────────\n\nexport type DreamingLightConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  dedupeSimilarity: number;\n};\n\nexport type DreamingDeepConfig = {\n  enabled: boolean;\n  cron: string;\n  minScore: number;\n  minRecallCount: number;\n  minUniqueQueries: number;\n  limit: number;\n  recencyHalfLifeDays: number;\n  maxAgeDays: number;\n};\n\nexport type DreamingRemConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  minPatternStrength: number;\n};\n\nexport type DreamingResolvedConfig = {\n  enabled: boolean;\n  frequency: string;\n  timezone?: string;\n  phases: {\n    light: DreamingLightConfig;\n    deep: DreamingDeepConfig;\n    rem: DreamingRemConfig;\n  };\n  deep: DreamingDeepConfig;\n};\n\n// ── Helpers ────────────────────────────────────────────────────────────\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction trimmedStringOr(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\nfunction optionalTrimmedString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\n// ── Resolver ───────────────────────────────────────────────────────────\n\n/** Resolve the full three-phase dreaming config from the default agent manifest. */\nexport function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig {\n  const agentId = cfg ? resolveDefaultAgentId(cfg) : undefined;\n  const manifest = cfg && agentId ? resolveEffectiveAgentManifestForAgent(cfg, agentId) : undefined;\n  const dreaming = manifest?.memory.dreaming;\n  const enabled = dreaming?.enabled === true && manifest?.memory.mode !== 'off';\n\n  const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);\n  const timezone = optionalTrimmedString(dreaming?.timezone);\n\n  // ── Light phase ────────────────────────────────────────────────────\n  const lightRaw = dreaming?.phases?.light ?? {};\n  const light: DreamingLightConfig = {\n    enabled: enabled && lightRaw?.enabled !== false,\n    cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),\n    lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),\n    limit: toNonNegInt(lightRaw?.limit, 100),\n    dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), 0.9),\n  };\n\n  // ── Deep phase ─────────────────────────────────────────────────────\n  const deepRaw = dreaming?.phases?.deep ?? {};\n  const deep: DreamingDeepConfig = {\n    enabled: enabled && deepRaw?.enabled !== false,\n    cron: trimmedStringOr(deepRaw?.cron, frequency),\n    minScore: clampScore(Number(deepRaw?.minScore), 0.8),\n    minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),\n    limit: toNonNegInt(deepRaw?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(deepRaw?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(deepRaw?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n\n  // ── REM phase ──────────────────────────────────────────────────────\n  const remRaw = dreaming?.phases?.rem ?? {};\n  const rem: DreamingRemConfig = {\n    enabled: enabled && remRaw?.enabled !== false,\n    cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),\n    lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),\n    limit: toNonNegInt(remRaw?.limit, 10),\n    minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), 0.75),\n  };\n\n  return {\n    enabled,\n    frequency,\n    ...(timezone ? { timezone } : {}),\n    phases: { light, deep, rem },\n    deep,\n  };\n}\n\n/** Get the cron expression for a specific phase from resolved config. */\nexport function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string {\n  return config.phases[phase].cron;\n}\n\n/** Check if a specific phase is enabled (global + phase-level). */\nexport function isPhaseEnabled(config: DreamingResolvedConfig, phase: DreamingPhaseId): boolean {\n  return config.enabled && config.phases[phase].enabled;\n}\n"],"mappings":";;;;kBAC6D;AAsD7D,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;AAGjC,SAAS,YAAY,OAAgB,UAA0B;CAC7D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,WAAW,IAAI,UAAU;;AAGlC,SAAS,gBAAgB,OAAgB,UAA0B;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG;;AAGpE,SAAS,sBAAsB,OAAoC;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA;;;AAMpE,SAAgB,sBAAsB,KAAiD;CACrF,MAAM,UAAU,MAAM,sBAAsB,IAAI,GAAG,KAAA;CACnD,MAAM,WAAW,OAAO,UAAU,sCAAsC,KAAK,QAAQ,GAAG,KAAA;CACxF,MAAM,WAAW,UAAU,OAAO;CAClC,MAAM,UAAU,UAAU,YAAY,QAAQ,UAAU,OAAO,SAAS;CAExE,MAAM,YAAY,gBAAgB,UAAU,WAAW,kBAAkB;CACzE,MAAM,WAAW,sBAAsB,UAAU,SAAS;CAG1D,MAAM,WAAW,UAAU,QAAQ,SAAS,EAAE;CAC9C,MAAM,QAA6B;EACjC,SAAS,WAAW,UAAU,YAAY;EAC1C,MAAM,gBAAgB,UAAU,MAAM,mBAAmB;EACzD,cAAc,cAAc,UAAU,cAAc,EAAE;EACtD,OAAO,YAAY,UAAU,OAAO,IAAI;EACxC,kBAAkB,WAAW,OAAO,UAAU,iBAAiB,EAAE,GAAI;EACtE;CAGD,MAAM,UAAU,UAAU,QAAQ,QAAQ,EAAE;CAC5C,MAAM,OAA2B;EAC/B,SAAS,WAAW,SAAS,YAAY;EACzC,MAAM,gBAAgB,SAAS,MAAM,UAAU;EAC/C,UAAU,WAAW,OAAO,SAAS,SAAS,EAAE,GAAI;EACpD,gBAAgB,cAAc,SAAS,gBAAgB,EAAE;EACzD,kBAAkB,cAAc,SAAS,kBAAkB,EAAE;EAC7D,OAAO,YAAY,SAAS,OAAO,GAAG;EACtC,qBAAqB,cAAc,SAAS,qBAAA,GAAoD;EAChG,YAAY,cAAc,SAAS,YAAA,GAAiC;EACrE;CAGD,MAAM,SAAS,UAAU,QAAQ,OAAO,EAAE;CAC1C,MAAM,MAAyB;EAC7B,SAAS,WAAW,QAAQ,YAAY;EACxC,MAAM,gBAAgB,QAAQ,MAAM,iBAAiB;EACrD,cAAc,cAAc,QAAQ,cAAc,EAAE;EACpD,OAAO,YAAY,QAAQ,OAAO,GAAG;EACrC,oBAAoB,WAAW,OAAO,QAAQ,mBAAmB,EAAE,IAAK;EACzE;AAED,QAAO;EACL;EACA;EACA,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,QAAQ;GAAE;GAAO;GAAM;GAAK;EAC5B;EACD;;;AAIH,SAAgB,aAAa,QAAgC,OAAgC;AAC3F,QAAO,OAAO,OAAO,OAAO;;;AAI9B,SAAgB,eAAe,QAAgC,OAAiC;AAC9F,QAAO,OAAO,WAAW,OAAO,OAAO,OAAO"}

package/dist/src/agent/memory/dreaming/deep-promotion.d.ts

@@ -1,5 +1,6 @@
 import { type DreamingStoreEntry } from './short-term-store.js';
 import type { DreamingDeepConfig } from './config.js';
+import type { MemoryManager } from '../manager.js';
 export type { DreamingDeepConfig } from './config.js';
 export type DreamingPromotionCandidate = DreamingStoreEntry & {
     avgScore: number;
@@ -11,6 +12,7 @@ export type DreamingPromotionCandidate = DreamingStoreEntry & {
 export declare function runDreamingDeepPromotion(params: {
     workspaceDir: string;
     config?: Partial<DreamingDeepConfig>;
+    memoryManager?: MemoryManager;
     now?: Date;
 }): Promise<{
     ok: boolean;

package/dist/src/agent/memory/dreaming/deep-promotion.js

@@ -4,8 +4,8 @@ import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, isoDay, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore, saveDreamingStore, withDreamingPromotionLock } from "./short-term-store.js";
 import { emptyDeepPhaseSkipped, writeDreamingDeepLastRun } from "./last-run.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/deep-promotion.ts
 init_logger();
 const log = createLogger("Dreaming:Deep");
@@ -184,6 +184,30 @@ async function runDreamingDeepPromotion(params) {
 			await fs.writeFile(memoryPath, next, "utf-8");
 			const nowIso = now.toISOString();
 			for (const c of appliedCandidates) {
+				const writeResult = await params.memoryManager?.write({
+					kind: "derived_insight",
+					content: c.snippet,
+					source: {
+						provider: "dreaming",
+						path: c.path,
+						lineStart: c.startLine,
+						lineEnd: c.endLine
+					},
+					tags: ["dreaming", "promoted"]
+				});
+				params.memoryManager?.recordSignal({
+					source: "dreaming",
+					recordId: writeResult?.record?.id,
+					score: c.score,
+					content: c.snippet,
+					metadata: {
+						path: c.path,
+						startLine: c.startLine,
+						endLine: c.endLine,
+						recallCount: c.recallCount,
+						avgScore: c.avgScore
+					}
+				});
 				const entry = store.entries[c.key];
 				if (entry) {
 					entry.promotedAt = nowIso;

package/dist/src/agent/memory/dreaming/deep-promotion.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-promotion.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/deep-promotion.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\nimport {\n  loadDreamingStore,\n  saveDreamingStore,\n  withDreamingPromotionLock,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  emptyDeepPhaseSkipped,\n  writeDreamingDeepLastRun,\n  type DreamingDeepLastRun,\n  type DreamingDeepPhaseSkipped,\n} from './last-run.js';\nimport type { DreamingDeepConfig } from './config.js';\nimport {\n  clamp01,\n  compareCandidatesByScore,\n  computeCandidateScore,\n  extractPromotionMarkers,\n  isContaminatedSnippet,\n  isExpiredEntry,\n  isoDay,\n  readFileLines,\n  resolveDeepDefaults,\n  sliceRange,\n  snippetHash,\n} from './utils.js';\n\nconst log = createLogger('Dreaming:Deep');\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingPromotionCandidate = DreamingStoreEntry & {\n  avgScore: number;\n  /** Time-decay-adjusted final score used for ranking. */\n  score: number;\n  /** Raw recency decay multiplier (0–1). */\n  recencyDecay: number;\n};\n\n\nfunction markerForPromotion(key: string, hash: string): string {\n  // Quote values to allow spaces/colons in key.\n  return `<!-- xopc-memory-promotion key=\"${key}\" hash=\"${hash}\" -->`;\n}\n\n\nasync function rehydrateSnippet(params: {\n  workspaceDir: string;\n  candidate: DreamingPromotionCandidate;\n}): Promise<{ snippet: string; startLine: number; endLine: number } | null> {\n  const fullPath = path.join(params.workspaceDir, params.candidate.path);\n  const lines = await readFileLines(fullPath);\n  if (!lines) return null;\n\n  const startLine = Math.max(1, Math.floor(params.candidate.startLine));\n  const endLine = Math.max(startLine, Math.floor(params.candidate.endLine));\n  const snippet = sliceRange(lines, startLine, endLine);\n  if (!snippet) return null;\n  return { snippet, startLine, endLine };\n}\n\n\nfunction buildDeepLastRun(base: {\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  t0: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: DreamingDeepLastRun['deep'];\n}): DreamingDeepLastRun {\n  const durationMs = Math.max(0, Date.now() - base.t0);\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: base.runId,\n    startedAt: base.startedAt,\n    finishedAt: base.finishedAt,\n    durationMs,\n    ok: base.ok,\n    reason: base.reason,\n    config: base.config,\n    memoryPath: base.memoryPath,\n    ...(base.errorMessage ? { errorMessage: base.errorMessage } : {}),\n    deep: base.deep,\n  };\n}\n\nexport async function runDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingDeepConfig>;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  candidates: number;\n  applied: number;\n  memoryPath: string;\n}> {\n  const cfg = resolveDeepDefaults(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;\n  const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);\n  const t0 = Date.now();\n\n  // Early exit for disabled or zero-limit configurations.\n  const earlyExitReason = !cfg.enabled ? 'dreaming disabled' : cfg.limit === 0 ? 'dreaming limit=0' : null;\n  if (earlyExitReason) {\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: true,\n        reason: earlyExitReason,\n        config: cfg,\n        memoryPath,\n        deep: { candidatesRanked: 0, applied: 0, skipped: empty },\n      }),\n    }).catch(() => undefined);\n    return { ok: true, reason: earlyExitReason, candidates: 0, applied: 0, memoryPath };\n  }\n\n  try {\n    const result = await withDreamingPromotionLock(params.workspaceDir, async () => {\n      const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n\n      const nowMs = now.getTime();\n\n      const all = Object.values(store.entries ?? {}).filter((e): e is DreamingStoreEntry => {\n        if (!e || typeof e !== 'object') return false;\n        if (e.promotedAt) return false;\n        if (!e.path || !e.path.startsWith('memory/')) return false;\n        if (e.recallCount < cfg.minRecallCount) return false;\n        // Require minimum unique queries to avoid single-query inflation.\n        if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;\n        // Expire entries older than maxAgeDays since last recall.\n        if (isExpiredEntry(e.lastRecalledAt, nowMs, cfg.maxAgeDays)) return false;\n        const avg = e.recallCount > 0 ? e.totalScore / e.recallCount : 0;\n        return clamp01(avg) >= cfg.minScore;\n      });\n\n      const ranked: DreamingPromotionCandidate[] = all\n        .map((e) => {\n          const { avgScore, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);\n          return { ...e, avgScore, score, recencyDecay };\n        })\n        .sort(compareCandidatesByScore)\n        .slice(0, cfg.limit);\n\n      if (ranked.length === 0) {\n        const z = emptyDeepPhaseSkipped();\n        return { ok: true, reason: 'no eligible candidates', candidates: 0, applied: 0, memoryPath, skipped: z };\n      }\n\n      const existing = await fs.readFile(memoryPath, 'utf-8').catch((err: unknown) => {\n        if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return '';\n        throw err;\n      });\n      const existingMarkers = extractPromotionMarkers(existing);\n\n      const appliedCandidates: Array<{\n        key: string;\n        hash: string;\n        snippet: string;\n        path: string;\n        startLine: number;\n        endLine: number;\n        score: number;\n        recallCount: number;\n        avgScore: number;\n      }> = [];\n\n      const skipped: DreamingDeepPhaseSkipped = emptyDeepPhaseSkipped();\n      for (const candidate of ranked) {\n        if (existingMarkers.keys.has(candidate.key)) {\n          skipped.alreadyPromotedKey += 1;\n          // Treat as already applied; mark promotedAt for idempotency and keep going.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        const rehydrated = await rehydrateSnippet({ workspaceDir: params.workspaceDir, candidate });\n        if (!rehydrated) {\n          skipped.rehydrateFailed += 1;\n          continue;\n        }\n        if (isContaminatedSnippet(rehydrated.snippet)) {\n          skipped.contaminated += 1;\n          continue;\n        }\n        const hash = snippetHash(rehydrated.snippet);\n        if (existingMarkers.hashes.has(hash)) {\n          skipped.hashDuplicate += 1;\n          // Already promoted (possibly from a different key/line range). Mark promoted for idempotency.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        appliedCandidates.push({\n          key: candidate.key,\n        hash,\n          snippet: rehydrated.snippet,\n          path: candidate.path,\n          startLine: rehydrated.startLine,\n          endLine: rehydrated.endLine,\n          score: candidate.score,\n          recallCount: candidate.recallCount,\n          avgScore: candidate.avgScore,\n        });\n      }\n\n      if (appliedCandidates.length === 0) {\n        await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n        return {\n          ok: true,\n          reason: 'candidates were stale or already applied',\n          candidates: ranked.length,\n          applied: 0,\n          memoryPath,\n          skipped,\n        };\n      }\n\n      const day = isoDay(now);\n      const header = existing.trim().length > 0 ? '' : '# Long-Term Memory\\n\\n';\n      const sectionLines: string[] = ['', `## Promoted From Short-Term Memory (${day})`, ''];\n      for (const c of appliedCandidates) {\n        const src = `${c.path}:${c.startLine}-${c.endLine}`;\n        sectionLines.push(markerForPromotion(c.key, c.hash));\n        sectionLines.push(\n          `- ${c.snippet} [score=${c.score.toFixed(3)} recalls=${c.recallCount} avg=${c.avgScore.toFixed(3)} source=${src}]`,\n        );\n      }\n      sectionLines.push('');\n\n      const next = `${header}${existing.endsWith('\\n') || existing.length === 0 ? existing : `${existing}\\n`}${sectionLines.join('\\n')}`;\n      await fs.writeFile(memoryPath, next, 'utf-8');\n\n      const nowIso = now.toISOString();\n      for (const c of appliedCandidates) {\n        const entry = store.entries[c.key];\n        if (entry) {\n          entry.promotedAt = nowIso;\n          entry.snippet = c.snippet;\n          entry.startLine = c.startLine;\n          entry.endLine = c.endLine;\n        }\n      }\n      store.updatedAt = nowIso;\n      await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n\n      log.info(\n        { workspaceDir: params.workspaceDir, candidates: ranked.length, applied: appliedCandidates.length },\n        'Dreaming deep promotion complete',\n      );\n\n      return {\n        ok: true,\n        reason: 'applied promotions',\n        candidates: ranked.length,\n        applied: appliedCandidates.length,\n        memoryPath,\n        skipped,\n      };\n    });\n\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    const resultSkipped = 'skipped' in result ? result.skipped : empty;\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: result.ok,\n        reason: result.reason,\n        config: cfg,\n        memoryPath: result.memoryPath,\n        deep: {\n          candidatesRanked: result.candidates,\n          applied: result.applied,\n          skipped: resultSkipped,\n        },\n      }),\n    }).catch(() => undefined);\n\n    return {\n      ok: result.ok,\n      reason: result.reason,\n      candidates: result.candidates,\n      applied: result.applied,\n      memoryPath: result.memoryPath,\n    };\n  } catch (err) {\n    const finishedAt = new Date().toISOString();\n    const em = err instanceof Error ? err.message : String(err);\n    const z = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: false,\n        reason: 'error',\n        config: cfg,\n        memoryPath,\n        errorMessage: em,\n        deep: { candidatesRanked: 0, applied: 0, skipped: z },\n      }),\n    }).catch(() => undefined);\n    throw err;\n  }\n}\n\n"],"mappings":"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"}
+{"version":3,"file":"deep-promotion.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/deep-promotion.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\nimport {\n  loadDreamingStore,\n  saveDreamingStore,\n  withDreamingPromotionLock,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  emptyDeepPhaseSkipped,\n  writeDreamingDeepLastRun,\n  type DreamingDeepLastRun,\n  type DreamingDeepPhaseSkipped,\n} from './last-run.js';\nimport type { DreamingDeepConfig } from './config.js';\nimport type { MemoryManager } from '../manager.js';\nimport {\n  clamp01,\n  compareCandidatesByScore,\n  computeCandidateScore,\n  extractPromotionMarkers,\n  isContaminatedSnippet,\n  isExpiredEntry,\n  isoDay,\n  readFileLines,\n  resolveDeepDefaults,\n  sliceRange,\n  snippetHash,\n} from './utils.js';\n\nconst log = createLogger('Dreaming:Deep');\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingPromotionCandidate = DreamingStoreEntry & {\n  avgScore: number;\n  /** Time-decay-adjusted final score used for ranking. */\n  score: number;\n  /** Raw recency decay multiplier (0–1). */\n  recencyDecay: number;\n};\n\n\nfunction markerForPromotion(key: string, hash: string): string {\n  // Quote values to allow spaces/colons in key.\n  return `<!-- xopc-memory-promotion key=\"${key}\" hash=\"${hash}\" -->`;\n}\n\n\nasync function rehydrateSnippet(params: {\n  workspaceDir: string;\n  candidate: DreamingPromotionCandidate;\n}): Promise<{ snippet: string; startLine: number; endLine: number } | null> {\n  const fullPath = path.join(params.workspaceDir, params.candidate.path);\n  const lines = await readFileLines(fullPath);\n  if (!lines) return null;\n\n  const startLine = Math.max(1, Math.floor(params.candidate.startLine));\n  const endLine = Math.max(startLine, Math.floor(params.candidate.endLine));\n  const snippet = sliceRange(lines, startLine, endLine);\n  if (!snippet) return null;\n  return { snippet, startLine, endLine };\n}\n\n\nfunction buildDeepLastRun(base: {\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  t0: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: DreamingDeepLastRun['deep'];\n}): DreamingDeepLastRun {\n  const durationMs = Math.max(0, Date.now() - base.t0);\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: base.runId,\n    startedAt: base.startedAt,\n    finishedAt: base.finishedAt,\n    durationMs,\n    ok: base.ok,\n    reason: base.reason,\n    config: base.config,\n    memoryPath: base.memoryPath,\n    ...(base.errorMessage ? { errorMessage: base.errorMessage } : {}),\n    deep: base.deep,\n  };\n}\n\nexport async function runDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingDeepConfig>;\n  memoryManager?: MemoryManager;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  candidates: number;\n  applied: number;\n  memoryPath: string;\n}> {\n  const cfg = resolveDeepDefaults(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;\n  const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);\n  const t0 = Date.now();\n\n  // Early exit for disabled or zero-limit configurations.\n  const earlyExitReason = !cfg.enabled ? 'dreaming disabled' : cfg.limit === 0 ? 'dreaming limit=0' : null;\n  if (earlyExitReason) {\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: true,\n        reason: earlyExitReason,\n        config: cfg,\n        memoryPath,\n        deep: { candidatesRanked: 0, applied: 0, skipped: empty },\n      }),\n    }).catch(() => undefined);\n    return { ok: true, reason: earlyExitReason, candidates: 0, applied: 0, memoryPath };\n  }\n\n  try {\n    const result = await withDreamingPromotionLock(params.workspaceDir, async () => {\n      const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n\n      const nowMs = now.getTime();\n\n      const all = Object.values(store.entries ?? {}).filter((e): e is DreamingStoreEntry => {\n        if (!e || typeof e !== 'object') return false;\n        if (e.promotedAt) return false;\n        if (!e.path || !e.path.startsWith('memory/')) return false;\n        if (e.recallCount < cfg.minRecallCount) return false;\n        // Require minimum unique queries to avoid single-query inflation.\n        if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;\n        // Expire entries older than maxAgeDays since last recall.\n        if (isExpiredEntry(e.lastRecalledAt, nowMs, cfg.maxAgeDays)) return false;\n        const avg = e.recallCount > 0 ? e.totalScore / e.recallCount : 0;\n        return clamp01(avg) >= cfg.minScore;\n      });\n\n      const ranked: DreamingPromotionCandidate[] = all\n        .map((e) => {\n          const { avgScore, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);\n          return { ...e, avgScore, score, recencyDecay };\n        })\n        .sort(compareCandidatesByScore)\n        .slice(0, cfg.limit);\n\n      if (ranked.length === 0) {\n        const z = emptyDeepPhaseSkipped();\n        return { ok: true, reason: 'no eligible candidates', candidates: 0, applied: 0, memoryPath, skipped: z };\n      }\n\n      const existing = await fs.readFile(memoryPath, 'utf-8').catch((err: unknown) => {\n        if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return '';\n        throw err;\n      });\n      const existingMarkers = extractPromotionMarkers(existing);\n\n      const appliedCandidates: Array<{\n        key: string;\n        hash: string;\n        snippet: string;\n        path: string;\n        startLine: number;\n        endLine: number;\n        score: number;\n        recallCount: number;\n        avgScore: number;\n      }> = [];\n\n      const skipped: DreamingDeepPhaseSkipped = emptyDeepPhaseSkipped();\n      for (const candidate of ranked) {\n        if (existingMarkers.keys.has(candidate.key)) {\n          skipped.alreadyPromotedKey += 1;\n          // Treat as already applied; mark promotedAt for idempotency and keep going.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        const rehydrated = await rehydrateSnippet({ workspaceDir: params.workspaceDir, candidate });\n        if (!rehydrated) {\n          skipped.rehydrateFailed += 1;\n          continue;\n        }\n        if (isContaminatedSnippet(rehydrated.snippet)) {\n          skipped.contaminated += 1;\n          continue;\n        }\n        const hash = snippetHash(rehydrated.snippet);\n        if (existingMarkers.hashes.has(hash)) {\n          skipped.hashDuplicate += 1;\n          // Already promoted (possibly from a different key/line range). Mark promoted for idempotency.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        appliedCandidates.push({\n          key: candidate.key,\n        hash,\n          snippet: rehydrated.snippet,\n          path: candidate.path,\n          startLine: rehydrated.startLine,\n          endLine: rehydrated.endLine,\n          score: candidate.score,\n          recallCount: candidate.recallCount,\n          avgScore: candidate.avgScore,\n        });\n      }\n\n      if (appliedCandidates.length === 0) {\n        await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n        return {\n          ok: true,\n          reason: 'candidates were stale or already applied',\n          candidates: ranked.length,\n          applied: 0,\n          memoryPath,\n          skipped,\n        };\n      }\n\n      const day = isoDay(now);\n      const header = existing.trim().length > 0 ? '' : '# Long-Term Memory\\n\\n';\n      const sectionLines: string[] = ['', `## Promoted From Short-Term Memory (${day})`, ''];\n      for (const c of appliedCandidates) {\n        const src = `${c.path}:${c.startLine}-${c.endLine}`;\n        sectionLines.push(markerForPromotion(c.key, c.hash));\n        sectionLines.push(\n          `- ${c.snippet} [score=${c.score.toFixed(3)} recalls=${c.recallCount} avg=${c.avgScore.toFixed(3)} source=${src}]`,\n        );\n      }\n      sectionLines.push('');\n\n      const next = `${header}${existing.endsWith('\\n') || existing.length === 0 ? existing : `${existing}\\n`}${sectionLines.join('\\n')}`;\n      await fs.writeFile(memoryPath, next, 'utf-8');\n\n      const nowIso = now.toISOString();\n      for (const c of appliedCandidates) {\n        const writeResult = await params.memoryManager?.write({\n          kind: 'derived_insight',\n          content: c.snippet,\n          source: {\n            provider: 'dreaming',\n            path: c.path,\n            lineStart: c.startLine,\n            lineEnd: c.endLine,\n          },\n          tags: ['dreaming', 'promoted'],\n        });\n        params.memoryManager?.recordSignal({\n          source: 'dreaming',\n          recordId: writeResult?.record?.id,\n          score: c.score,\n          content: c.snippet,\n          metadata: {\n            path: c.path,\n            startLine: c.startLine,\n            endLine: c.endLine,\n            recallCount: c.recallCount,\n            avgScore: c.avgScore,\n          },\n        });\n        const entry = store.entries[c.key];\n        if (entry) {\n          entry.promotedAt = nowIso;\n          entry.snippet = c.snippet;\n          entry.startLine = c.startLine;\n          entry.endLine = c.endLine;\n        }\n      }\n      store.updatedAt = nowIso;\n      await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n\n      log.info(\n        { workspaceDir: params.workspaceDir, candidates: ranked.length, applied: appliedCandidates.length },\n        'Dreaming deep promotion complete',\n      );\n\n      return {\n        ok: true,\n        reason: 'applied promotions',\n        candidates: ranked.length,\n        applied: appliedCandidates.length,\n        memoryPath,\n        skipped,\n      };\n    });\n\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    const resultSkipped = 'skipped' in result ? result.skipped : empty;\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: result.ok,\n        reason: result.reason,\n        config: cfg,\n        memoryPath: result.memoryPath,\n        deep: {\n          candidatesRanked: result.candidates,\n          applied: result.applied,\n          skipped: resultSkipped,\n        },\n      }),\n    }).catch(() => undefined);\n\n    return {\n      ok: result.ok,\n      reason: result.reason,\n      candidates: result.candidates,\n      applied: result.applied,\n      memoryPath: result.memoryPath,\n    };\n  } catch (err) {\n    const finishedAt = new Date().toISOString();\n    const em = err instanceof Error ? err.message : String(err);\n    const z = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: false,\n        reason: 'error',\n        config: cfg,\n        memoryPath,\n        errorMessage: em,\n        deep: { candidatesRanked: 0, applied: 0, skipped: z },\n      }),\n    }).catch(() => undefined);\n    throw err;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/dreaming/events.js

@@ -1,6 +1,6 @@
 import { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE } from "./constants.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/events.ts
 /**
 * Append a single event line to `memory/.dreams/events.jsonl`.

package/dist/src/agent/memory/dreaming/last-run.js

@@ -1,6 +1,6 @@
 import { DREAMING_LAST_RUN_RELATIVE } from "./constants.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/last-run.ts
 const DREAMING_LAST_RUN_FORMAT_VERSION = 2;
 function isRecord(v) {

package/dist/src/agent/memory/dreaming/light-sweep.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE } from "./constants.js";
 import { buildEntryKey, isoDay, normalizeMemoryPath, normalizeSnippetForHash, snippetHash } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/light-sweep.ts
 init_logger();
 const log = createLogger("Dreaming:Light");

package/dist/src/agent/memory/dreaming/preview.js

@@ -1,8 +1,8 @@
 import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore } from "./short-term-store.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/preview.ts
 async function previewDreamingDeepPromotion(params) {
 	const cfg = resolveDeepDefaults(params.config);

package/dist/src/agent/memory/dreaming/rem-patterns.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE, DREAMS_MD_FILENAME, MS_PER_DAY } from "./constan
 import { isoDay } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/rem-patterns.ts
 init_logger();
 const log = createLogger("Dreaming:REM");

package/dist/src/agent/memory/dreaming/short-term-store.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "./constants.js";
 import { buildEntryKey, clamp01, isoDay, normalizeMemoryPath } from "./utils.js";
+import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
-import path from "node:path";
 //#region src/agent/memory/dreaming/short-term-store.ts
 init_logger();
 const log = createLogger("Dreaming:Store");

package/dist/src/agent/memory/dreaming/utils.js

@@ -1,7 +1,7 @@
 import { DEFAULT_DEEP_CRON, DIVERSITY_WEIGHT, MS_PER_DAY, REINFORCEMENT_WEIGHT } from "./constants.js";
+import path from "node:path";
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
-import path from "node:path";
 //#region src/agent/memory/dreaming/utils.ts
 /** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
 function normalizeMemoryPath(rel) {

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

@@ -1,6 +1,7 @@
 export { BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, scanForThreats } from './builtin-memory-store.js';
 export { BuiltinMemoryProvider } from './builtin-provider.js';
 export { buildMemoryContextBlock, sanitizeMemoryContextFenceEscapes } from './context-fence.js';
+export { MemoryContextAssembler } from './context-assembler.js';
 export { createMemoryManagerFromConfig } from './create-memory-manager.js';
 export { injectPrefetchIntoUserMessage } from './inject-prefetch.js';
 export { isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool, } from './memory-config.js';

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

@@ -1,12 +1,13 @@
 import { isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool } from "./memory-config.js";
 import { extractAgentUserPlainText } from "./user-message-text.js";
 import { buildMemoryContextBlock, sanitizeMemoryContextFenceEscapes } from "./context-fence.js";
+import { MemoryContextAssembler } from "./context-assembler.js";
 import { injectPrefetchIntoUserMessage } from "./inject-prefetch.js";
 import { BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, scanForThreats } from "./builtin-memory-store.js";
 import { BuiltinMemoryProvider } from "./builtin-provider.js";
 import { MemoryManager } from "./manager.js";
-import { StubMemoryProvider } from "./stub-memory-provider.js";
+import { discoverMemoryPlugins } from "./plugin-discovery.js";
 import { createMemoryManagerFromConfig } from "./create-memory-manager.js";
 import { MemoryFlushService } from "./memory-flush.js";
-import { discoverMemoryPlugins } from "./plugin-discovery.js";
-export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryFlushService, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };
+import { StubMemoryProvider } from "./stub-memory-provider.js";
+export { BuiltinMemoryProvider, BuiltinMemoryStore, MEMORY_ENTRY_DELIMITER, MemoryContextAssembler, MemoryFlushService, MemoryManager, StubMemoryProvider, buildMemoryContextBlock, createMemoryManagerFromConfig, discoverMemoryPlugins, extractAgentUserPlainText, injectPrefetchIntoUserMessage, isCuratedMemoryInPrompt, isMemorySubsystemEnabled, resolveBuiltinMemoryStoreConfig, sanitizeMemoryContextFenceEscapes, scanForThreats, shouldInjectMemoryPrefetchThisTurn, shouldRegisterCuratedMemoryTool };

package/dist/src/agent/memory/inject-prefetch.js

@@ -1,5 +1,5 @@
 import { readAgentMessageContent } from "./agent-message-access.js";
-import { buildMemoryContextBlock } from "./context-fence.js";
+import { MemoryContextAssembler } from "./context-assembler.js";
 //#region src/agent/memory/inject-prefetch.ts
 /**
 * Prefix user message with fenced prefetched memory context (if any).
@@ -7,7 +7,11 @@ import { buildMemoryContextBlock } from "./context-fence.js";
 async function injectPrefetchIntoUserMessage(memoryManager, sessionKey, userMessage, queryText) {
 	const q = queryText.trim();
 	if (!q) return userMessage;
-	const block = buildMemoryContextBlock(await memoryManager.prefetchAll(q, { sessionId: sessionKey }));
+	const block = await new MemoryContextAssembler().assemble({
+		memoryManager,
+		sessionKey,
+		query: q
+	});
 	if (!block.trim()) return userMessage;
 	const prefix = `${block}\n\n`;
 	const c = readAgentMessageContent(userMessage);

package/dist/src/agent/memory/inject-prefetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-prefetch.js","names":[],"sources":["../../../../src/agent/memory/inject-prefetch.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { readAgentMessageContent } from './agent-message-access.js';\nimport { buildMemoryContextBlock } from './context-fence.js';\nimport type { MemoryManager } from './manager.js';\n\n/**\n * Prefix user message with fenced prefetched memory context (if any).\n */\nexport async function injectPrefetchIntoUserMessage(\n  memoryManager: MemoryManager,\n  sessionKey: string,\n  userMessage: AgentMessage,\n  queryText: string,\n): Promise<AgentMessage> {\n  const q = queryText.trim();\n  if (!q) {\n    return userMessage;\n  }\n\n  const raw = await memoryManager.prefetchAll(q, { sessionId: sessionKey });\n  const block = buildMemoryContextBlock(raw);\n  if (!block.trim()) {\n    return userMessage;\n  }\n\n  const prefix = `${block}\\n\\n`;\n  const c = readAgentMessageContent(userMessage);\n\n  if (typeof c === 'string') {\n    return { ...userMessage, content: prefix + c } as AgentMessage;\n  }\n\n  if (Array.isArray(c) && c.length > 0) {\n    const first = c[0] as { type?: string; text?: string };\n    if (first?.type === 'text' && typeof first.text === 'string') {\n      const copy = [...c];\n      copy[0] = { type: 'text', text: prefix + first.text };\n      return { ...userMessage, content: copy } as AgentMessage;\n    }\n    return {\n      ...userMessage,\n      content: [{ type: 'text' as const, text: prefix }, ...c],\n    } as AgentMessage;\n  }\n\n  return userMessage;\n}\n"],"mappings":";;;;;;AASA,eAAsB,8BACpB,eACA,YACA,aACA,WACuB;CACvB,MAAM,IAAI,UAAU,MAAM;AAC1B,KAAI,CAAC,EACH,QAAO;CAIT,MAAM,QAAQ,wBAAwB,MADpB,cAAc,YAAY,GAAG,EAAE,WAAW,YAAY,CAAC,CAC/B;AAC1C,KAAI,CAAC,MAAM,MAAM,CACf,QAAO;CAGT,MAAM,SAAS,GAAG,MAAM;CACxB,MAAM,IAAI,wBAAwB,YAAY;AAE9C,KAAI,OAAO,MAAM,SACf,QAAO;EAAE,GAAG;EAAa,SAAS,SAAS;EAAG;AAGhD,KAAI,MAAM,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG;EACpC,MAAM,QAAQ,EAAE;AAChB,MAAI,OAAO,SAAS,UAAU,OAAO,MAAM,SAAS,UAAU;GAC5D,MAAM,OAAO,CAAC,GAAG,EAAE;AACnB,QAAK,KAAK;IAAE,MAAM;IAAQ,MAAM,SAAS,MAAM;IAAM;AACrD,UAAO;IAAE,GAAG;IAAa,SAAS;IAAM;;AAE1C,SAAO;GACL,GAAG;GACH,SAAS,CAAC;IAAE,MAAM;IAAiB,MAAM;IAAQ,EAAE,GAAG,EAAE;GACzD;;AAGH,QAAO"}
+{"version":3,"file":"inject-prefetch.js","names":[],"sources":["../../../../src/agent/memory/inject-prefetch.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport { readAgentMessageContent } from './agent-message-access.js';\nimport { MemoryContextAssembler } from './context-assembler.js';\nimport type { MemoryManager } from './manager.js';\n\n/**\n * Prefix user message with fenced prefetched memory context (if any).\n */\nexport async function injectPrefetchIntoUserMessage(\n  memoryManager: MemoryManager,\n  sessionKey: string,\n  userMessage: AgentMessage,\n  queryText: string,\n): Promise<AgentMessage> {\n  const q = queryText.trim();\n  if (!q) {\n    return userMessage;\n  }\n\n  const block = await new MemoryContextAssembler().assemble({\n    memoryManager,\n    sessionKey,\n    query: q,\n  });\n  if (!block.trim()) {\n    return userMessage;\n  }\n\n  const prefix = `${block}\\n\\n`;\n  const c = readAgentMessageContent(userMessage);\n\n  if (typeof c === 'string') {\n    return { ...userMessage, content: prefix + c } as AgentMessage;\n  }\n\n  if (Array.isArray(c) && c.length > 0) {\n    const first = c[0] as { type?: string; text?: string };\n    if (first?.type === 'text' && typeof first.text === 'string') {\n      const copy = [...c];\n      copy[0] = { type: 'text', text: prefix + first.text };\n      return { ...userMessage, content: copy } as AgentMessage;\n    }\n    return {\n      ...userMessage,\n      content: [{ type: 'text' as const, text: prefix }, ...c],\n    } as AgentMessage;\n  }\n\n  return userMessage;\n}\n"],"mappings":";;;;;;AASA,eAAsB,8BACpB,eACA,YACA,aACA,WACuB;CACvB,MAAM,IAAI,UAAU,MAAM;AAC1B,KAAI,CAAC,EACH,QAAO;CAGT,MAAM,QAAQ,MAAM,IAAI,wBAAwB,CAAC,SAAS;EACxD;EACA;EACA,OAAO;EACR,CAAC;AACF,KAAI,CAAC,MAAM,MAAM,CACf,QAAO;CAGT,MAAM,SAAS,GAAG,MAAM;CACxB,MAAM,IAAI,wBAAwB,YAAY;AAE9C,KAAI,OAAO,MAAM,SACf,QAAO;EAAE,GAAG;EAAa,SAAS,SAAS;EAAG;AAGhD,KAAI,MAAM,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG;EACpC,MAAM,QAAQ,EAAE;AAChB,MAAI,OAAO,SAAS,UAAU,OAAO,MAAM,SAAS,UAAU;GAC5D,MAAM,OAAO,CAAC,GAAG,EAAE;AACnB,QAAK,KAAK;IAAE,MAAM;IAAQ,MAAM,SAAS,MAAM;IAAM;AACrD,UAAO;IAAE,GAAG;IAAa,SAAS;IAAM;;AAE1C,SAAO;GACL,GAAG;GACH,SAAS,CAAC;IAAE,MAAM;IAAiB,MAAM;IAAQ,EAAE,GAAG,EAAE;GACzD;;AAGH,QAAO"}

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[];
     /**
@@ -21,7 +43,21 @@ export declare class MemoryManager {
     }): void;
     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;
 }