@xopcai/xopc 0.0.20 → 0.0.21

package/dist/src/agent/context/workspace-seed.js

@@ -1,6 +1,6 @@
+import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentBootstrapDir } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentBootstrapDir } from "../agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { BOOTSTRAP_FILES } from "./workspace.js";
 import { dirname, join } from "node:path";

package/dist/src/agent/ipc/bus.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { createResponseMessage, createSignalMessage, createTaskMessage } from "./types.js";
 import { AgentInbox } from "./inbox.js";
 //#region src/agent/ipc/bus.ts

package/dist/src/agent/ipc/inbox.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveAgentDir } from "../../config/paths.js";
-import { mkdir, readFile, readdir, rename, writeFile } from "fs/promises";
 import { join } from "path";
 import { existsSync, watch } from "fs";
+import { mkdir, readFile, readdir, rename, writeFile } from "fs/promises";
 //#region src/agent/ipc/inbox.ts
 init_logger();
 init_paths();

package/dist/src/agent/ipc/socket.js

@@ -2,8 +2,8 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveSocketPath } from "../../config/paths.js";
 import { isValidIPCMessage } from "./types.js";
-import { mkdir } from "fs/promises";
 import { dirname } from "path";
+import { mkdir } from "fs/promises";
 import { Socket, createServer } from "net";
 //#region src/agent/ipc/socket.ts
 init_logger();

package/dist/src/agent/memory/builtin-memory-store.d.ts

@@ -12,7 +12,8 @@ export declare class BuiltinMemoryStore {
     constructor(config: MemoryStoreConfig);
     /** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */
     isUserProfileEnabled(): boolean;
-    private get memDir();
+    /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */
+    get memoriesDir(): string;
     pathFor(target: 'memory' | 'user'): string;
     /**
      * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).

package/dist/src/agent/memory/builtin-memory-store.js

@@ -24,19 +24,20 @@ var BuiltinMemoryStore = class {
 	isUserProfileEnabled() {
 		return this.config.userProfileEnabled !== false;
 	}
-	get memDir() {
+	/** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */
+	get memoriesDir() {
 		return this.config.memoriesDir;
 	}
 	pathFor(target) {
-		return join(this.memDir, target === "memory" ? "MEMORY.md" : "USER.md");
+		return join(this.memoriesDir, target === "memory" ? "MEMORY.md" : "USER.md");
 	}
 	/**
 	* Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).
 	*/
 	loadFromDiskSync() {
-		mkdirSync(this.memDir, { recursive: true });
-		this.memoryEntries = this.parseFileContent(this.readPathSync(join(this.memDir, "MEMORY.md")));
-		this.userEntries = this.config.userProfileEnabled === false ? [] : this.parseFileContent(this.readPathSync(join(this.memDir, "USER.md")));
+		mkdirSync(this.memoriesDir, { recursive: true });
+		this.memoryEntries = this.parseFileContent(this.readPathSync(join(this.memoriesDir, "MEMORY.md")));
+		this.userEntries = this.config.userProfileEnabled === false ? [] : this.parseFileContent(this.readPathSync(join(this.memoriesDir, "USER.md")));
 		this.memoryEntries = dedupePreserveOrder(this.memoryEntries);
 		this.userEntries = dedupePreserveOrder(this.userEntries);
 		this.snapshot = {
@@ -180,7 +181,7 @@ var BuiltinMemoryStore = class {
 	}
 	async withFileLock(target, fn) {
 		const filePath = this.pathFor(target);
-		await mkdir(this.memDir, { recursive: true });
+		await mkdir(this.memoriesDir, { recursive: true });
 		if (!existsSync(filePath)) await writeFile(filePath, "", "utf-8");
 		await lockfile.lock(filePath, {
 			retries: 3,

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

@@ -1 +1 @@
-{"version":3,"file":"builtin-memory-store.js","names":[],"sources":["../../../../src/agent/memory/builtin-memory-store.ts"],"sourcesContent":["/**\n * Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.\n * Snapshot for system prompt is captured at load time and not mutated until next load.\n */\n\nimport { existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport lockfile from 'proper-lockfile';\n\nimport type { MemorySnapshot, MemoryStoreConfig } from './types.js';\n\nexport const MEMORY_ENTRY_DELIMITER = '\\n§\\n';\n\nconst DEFAULT_MEMORY_LIMIT = 2200;\nconst DEFAULT_USER_LIMIT = 1375;\n\nexport class BuiltinMemoryStore {\n  private memoryEntries: string[] = [];\n  private userEntries: string[] = [];\n  private snapshot: MemorySnapshot = { memory: '', user: '' };\n\n  constructor(private readonly config: MemoryStoreConfig) {}\n\n  /** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */\n  isUserProfileEnabled(): boolean {\n    return this.config.userProfileEnabled !== false;\n  }\n\n  private get memDir(): string {\n    return this.config.memoriesDir;\n  }\n\n  pathFor(target: 'memory' | 'user'): string {\n    return join(this.memDir, target === 'memory' ? 'MEMORY.md' : 'USER.md');\n  }\n\n  /**\n   * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).\n   */\n  loadFromDiskSync(): void {\n    mkdirSync(this.memDir, { recursive: true });\n    this.memoryEntries = this.parseFileContent(\n      this.readPathSync(join(this.memDir, 'MEMORY.md')),\n    );\n    this.userEntries =\n      this.config.userProfileEnabled === false\n        ? []\n        : this.parseFileContent(this.readPathSync(join(this.memDir, 'USER.md')));\n    this.memoryEntries = dedupePreserveOrder(this.memoryEntries);\n    this.userEntries = dedupePreserveOrder(this.userEntries);\n    this.snapshot = {\n      memory: this.renderBlock('memory', this.memoryEntries),\n      user: this.renderBlock('user', this.userEntries),\n    };\n  }\n\n  private readPathSync(path: string): string {\n    try {\n      if (!existsSync(path)) return '';\n      return readFileSync(path, { encoding: 'utf-8' });\n    } catch {\n      return '';\n    }\n  }\n\n  private parseFileContent(raw: string): string[] {\n    if (!raw.trim()) return [];\n    return raw\n      .split(MEMORY_ENTRY_DELIMITER)\n      .map((e) => e.trim())\n      .filter(Boolean);\n  }\n\n  getSnapshot(): MemorySnapshot {\n    return this.snapshot;\n  }\n\n  /**\n   * Live entries for read/debug (may differ from snapshot after mutations).\n   */\n  getLiveEntries(target: 'memory' | 'user'): string[] {\n    return target === 'memory' ? [...this.memoryEntries] : [...this.userEntries];\n  }\n\n  async add(\n    target: 'memory' | 'user',\n    content: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const trimmed = content.trim();\n    if (!trimmed) {\n      return { success: false, error: 'Content cannot be empty.' };\n    }\n    const scanError = scanForThreats(trimmed);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const limit = this.charLimit(target);\n\n      if (entries.includes(trimmed)) {\n        return { success: false, error: 'Entry already exists' };\n      }\n\n      const newTotal = calculateTotal([...entries, trimmed]);\n      if (newTotal > limit) {\n        return {\n          success: false,\n          error: `Memory at ${calculateTotal(entries)}/${limit} chars. Adding would exceed limit.`,\n        };\n      }\n\n      entries.push(trimmed);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry added.' };\n    });\n  }\n\n  async replace(\n    target: 'memory' | 'user',\n    oldText: string,\n    newContent: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    const nc = newContent.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n    if (!nc) {\n      return { success: false, error: 'new_content cannot be empty. Use remove to delete entries.' };\n    }\n    const scanError = scanForThreats(nc);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: Array<{ index: number; entry: string }> = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push({ index: i, entry: entries[i] });\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((m) => m.entry));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((m) =>\n            m.entry.length > 80 ? `${m.entry.slice(0, 80)}...` : m.entry,\n          );\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      const idx = matches[0].index;\n      const limit = this.charLimit(target);\n      const testEntries = [...entries];\n      testEntries[idx] = nc;\n\n      if (calculateTotal(testEntries) > limit) {\n        return {\n          success: false,\n          error: `Replacement would put memory at ${calculateTotal(testEntries)}/${limit} chars.`,\n        };\n      }\n\n      entries[idx] = nc;\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry replaced.' };\n    });\n  }\n\n  async remove(\n    target: 'memory' | 'user',\n    oldText: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: number[] = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push(i);\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((i) => entries[i]));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((i) => {\n            const e = entries[i];\n            return e.length > 80 ? `${e.slice(0, 80)}...` : e;\n          });\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      entries.splice(matches[0], 1);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry removed.' };\n    });\n  }\n\n  private async withFileLock<T>(\n    target: 'memory' | 'user',\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const filePath = this.pathFor(target);\n    await mkdir(this.memDir, { recursive: true });\n    if (!existsSync(filePath)) {\n      await writeFile(filePath, '', 'utf-8');\n    }\n    await lockfile.lock(filePath, { retries: 3, stale: 10_000 });\n    try {\n      return await fn();\n    } finally {\n      await lockfile.unlock(filePath);\n    }\n  }\n\n  private async reloadTargetFromDisk(target: 'memory' | 'user'): Promise<void> {\n    const path = this.pathFor(target);\n    let raw = '';\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch {\n      raw = '';\n    }\n    const parsed = dedupePreserveOrder(this.parseFileContent(raw));\n    if (target === 'memory') {\n      this.memoryEntries = parsed;\n    } else {\n      this.userEntries = parsed;\n    }\n  }\n\n  private async flushTargetToDisk(target: 'memory' | 'user'): Promise<void> {\n    const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n    const filePath = this.pathFor(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const tmpPath = `${filePath}.tmp.${Date.now()}`;\n    await writeFile(tmpPath, content, 'utf-8');\n    await rename(tmpPath, filePath);\n  }\n\n  private charLimit(target: 'memory' | 'user'): number {\n    return target === 'memory'\n      ? (this.config.memoryCharLimit ?? DEFAULT_MEMORY_LIMIT)\n      : (this.config.userCharLimit ?? DEFAULT_USER_LIMIT);\n  }\n\n  private renderBlock(target: 'memory' | 'user', entries: string[]): string {\n    if (entries.length === 0) {\n      return '';\n    }\n\n    const limit = this.charLimit(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const current = content.length;\n    const pct = Math.min(100, Math.round((current / limit) * 100));\n\n    const header =\n      target === 'user'\n        ? `USER PROFILE (who the user is) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`\n        : `MEMORY (your personal notes) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`;\n\n    const separator = '═'.repeat(46);\n    return `${separator}\\n${header}\\n${separator}\\n${content}`;\n  }\n}\n\nfunction dedupePreserveOrder(entries: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const e of entries) {\n    if (seen.has(e)) {\n      continue;\n    }\n    seen.add(e);\n    out.push(e);\n  }\n  return out;\n}\n\nfunction calculateTotal(entries: string[]): number {\n  if (entries.length === 0) {\n    return 0;\n  }\n  return entries.join(MEMORY_ENTRY_DELIMITER).length;\n}\n\nexport function scanForThreats(content: string): string | null {\n  const patterns: Array<{ regex: RegExp; id: string }> = [\n    { regex: /ignore\\s+(previous|all|above|prior)\\s+instructions/i, id: 'prompt_injection' },\n    { regex: /you\\s+are\\s+now\\s+/i, id: 'role_hijack' },\n    { regex: /do\\s+not\\s+tell\\s+the\\s+user/i, id: 'deception_hide' },\n    { regex: /system\\s+prompt\\s+override/i, id: 'sys_prompt_override' },\n    {\n      regex: /disregard\\s+(your|all|any)\\s+(instructions|rules|guidelines)/i,\n      id: 'disregard_rules',\n    },\n    {\n      regex: /act\\s+as\\s+(if|though)\\s+you\\s+(have\\s+no|don't\\s+have)\\s+(restrictions|limits|rules)/i,\n      id: 'bypass_restrictions',\n    },\n    { regex: /curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_curl' },\n    { regex: /wget\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_wget' },\n    {\n      regex: /cat\\s+[^\\n]*(\\.env|credentials|\\.netrc|\\.pgpass|\\.npmrc|\\.pypirc)/i,\n      id: 'read_secrets',\n    },\n    { regex: /authorized_keys/i, id: 'ssh_backdoor' },\n    { regex: /\\$HOME\\/\\.ssh|\\~\\/\\.ssh/i, id: 'ssh_access' },\n  ];\n\n  for (const { regex, id } of patterns) {\n    if (regex.test(content)) {\n      return `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection payloads.`;\n    }\n  }\n\n  const invisibleChars = [\n    '\\u200b',\n    '\\u200c',\n    '\\u200d',\n    '\\u2060',\n    '\\ufeff',\n    '\\u202a',\n    '\\u202b',\n    '\\u202c',\n    '\\u202d',\n    '\\u202e',\n  ];\n  for (const char of invisibleChars) {\n    if (content.includes(char)) {\n      const code = char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');\n      return `Blocked: content contains invisible unicode character U+${code} (possible injection).`;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"builtin-memory-store.js","names":[],"sources":["../../../../src/agent/memory/builtin-memory-store.ts"],"sourcesContent":["/**\n * Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.\n * Snapshot for system prompt is captured at load time and not mutated until next load.\n */\n\nimport { existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport lockfile from 'proper-lockfile';\n\nimport type { MemorySnapshot, MemoryStoreConfig } from './types.js';\n\nexport const MEMORY_ENTRY_DELIMITER = '\\n§\\n';\n\nconst DEFAULT_MEMORY_LIMIT = 2200;\nconst DEFAULT_USER_LIMIT = 1375;\n\nexport class BuiltinMemoryStore {\n  private memoryEntries: string[] = [];\n  private userEntries: string[] = [];\n  private snapshot: MemorySnapshot = { memory: '', user: '' };\n\n  constructor(private readonly config: MemoryStoreConfig) {}\n\n  /** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */\n  isUserProfileEnabled(): boolean {\n    return this.config.userProfileEnabled !== false;\n  }\n\n  /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */\n  get memoriesDir(): string {\n    return this.config.memoriesDir;\n  }\n\n  pathFor(target: 'memory' | 'user'): string {\n    return join(this.memoriesDir, target === 'memory' ? 'MEMORY.md' : 'USER.md');\n  }\n\n  /**\n   * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).\n   */\n  loadFromDiskSync(): void {\n    mkdirSync(this.memoriesDir, { recursive: true });\n    this.memoryEntries = this.parseFileContent(\n      this.readPathSync(join(this.memoriesDir, 'MEMORY.md')),\n    );\n    this.userEntries =\n      this.config.userProfileEnabled === false\n        ? []\n        : this.parseFileContent(this.readPathSync(join(this.memoriesDir, 'USER.md')));\n    this.memoryEntries = dedupePreserveOrder(this.memoryEntries);\n    this.userEntries = dedupePreserveOrder(this.userEntries);\n    this.snapshot = {\n      memory: this.renderBlock('memory', this.memoryEntries),\n      user: this.renderBlock('user', this.userEntries),\n    };\n  }\n\n  private readPathSync(path: string): string {\n    try {\n      if (!existsSync(path)) return '';\n      return readFileSync(path, { encoding: 'utf-8' });\n    } catch {\n      return '';\n    }\n  }\n\n  private parseFileContent(raw: string): string[] {\n    if (!raw.trim()) return [];\n    return raw\n      .split(MEMORY_ENTRY_DELIMITER)\n      .map((e) => e.trim())\n      .filter(Boolean);\n  }\n\n  getSnapshot(): MemorySnapshot {\n    return this.snapshot;\n  }\n\n  /**\n   * Live entries for read/debug (may differ from snapshot after mutations).\n   */\n  getLiveEntries(target: 'memory' | 'user'): string[] {\n    return target === 'memory' ? [...this.memoryEntries] : [...this.userEntries];\n  }\n\n  async add(\n    target: 'memory' | 'user',\n    content: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const trimmed = content.trim();\n    if (!trimmed) {\n      return { success: false, error: 'Content cannot be empty.' };\n    }\n    const scanError = scanForThreats(trimmed);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const limit = this.charLimit(target);\n\n      if (entries.includes(trimmed)) {\n        return { success: false, error: 'Entry already exists' };\n      }\n\n      const newTotal = calculateTotal([...entries, trimmed]);\n      if (newTotal > limit) {\n        return {\n          success: false,\n          error: `Memory at ${calculateTotal(entries)}/${limit} chars. Adding would exceed limit.`,\n        };\n      }\n\n      entries.push(trimmed);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry added.' };\n    });\n  }\n\n  async replace(\n    target: 'memory' | 'user',\n    oldText: string,\n    newContent: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    const nc = newContent.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n    if (!nc) {\n      return { success: false, error: 'new_content cannot be empty. Use remove to delete entries.' };\n    }\n    const scanError = scanForThreats(nc);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: Array<{ index: number; entry: string }> = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push({ index: i, entry: entries[i] });\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((m) => m.entry));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((m) =>\n            m.entry.length > 80 ? `${m.entry.slice(0, 80)}...` : m.entry,\n          );\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      const idx = matches[0].index;\n      const limit = this.charLimit(target);\n      const testEntries = [...entries];\n      testEntries[idx] = nc;\n\n      if (calculateTotal(testEntries) > limit) {\n        return {\n          success: false,\n          error: `Replacement would put memory at ${calculateTotal(testEntries)}/${limit} chars.`,\n        };\n      }\n\n      entries[idx] = nc;\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry replaced.' };\n    });\n  }\n\n  async remove(\n    target: 'memory' | 'user',\n    oldText: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: number[] = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push(i);\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((i) => entries[i]));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((i) => {\n            const e = entries[i];\n            return e.length > 80 ? `${e.slice(0, 80)}...` : e;\n          });\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      entries.splice(matches[0], 1);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry removed.' };\n    });\n  }\n\n  private async withFileLock<T>(\n    target: 'memory' | 'user',\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const filePath = this.pathFor(target);\n    await mkdir(this.memoriesDir, { recursive: true });\n    if (!existsSync(filePath)) {\n      await writeFile(filePath, '', 'utf-8');\n    }\n    await lockfile.lock(filePath, { retries: 3, stale: 10_000 });\n    try {\n      return await fn();\n    } finally {\n      await lockfile.unlock(filePath);\n    }\n  }\n\n  private async reloadTargetFromDisk(target: 'memory' | 'user'): Promise<void> {\n    const path = this.pathFor(target);\n    let raw = '';\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch {\n      raw = '';\n    }\n    const parsed = dedupePreserveOrder(this.parseFileContent(raw));\n    if (target === 'memory') {\n      this.memoryEntries = parsed;\n    } else {\n      this.userEntries = parsed;\n    }\n  }\n\n  private async flushTargetToDisk(target: 'memory' | 'user'): Promise<void> {\n    const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n    const filePath = this.pathFor(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const tmpPath = `${filePath}.tmp.${Date.now()}`;\n    await writeFile(tmpPath, content, 'utf-8');\n    await rename(tmpPath, filePath);\n  }\n\n  private charLimit(target: 'memory' | 'user'): number {\n    return target === 'memory'\n      ? (this.config.memoryCharLimit ?? DEFAULT_MEMORY_LIMIT)\n      : (this.config.userCharLimit ?? DEFAULT_USER_LIMIT);\n  }\n\n  private renderBlock(target: 'memory' | 'user', entries: string[]): string {\n    if (entries.length === 0) {\n      return '';\n    }\n\n    const limit = this.charLimit(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const current = content.length;\n    const pct = Math.min(100, Math.round((current / limit) * 100));\n\n    const header =\n      target === 'user'\n        ? `USER PROFILE (who the user is) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`\n        : `MEMORY (your personal notes) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`;\n\n    const separator = '═'.repeat(46);\n    return `${separator}\\n${header}\\n${separator}\\n${content}`;\n  }\n}\n\nfunction dedupePreserveOrder(entries: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const e of entries) {\n    if (seen.has(e)) {\n      continue;\n    }\n    seen.add(e);\n    out.push(e);\n  }\n  return out;\n}\n\nfunction calculateTotal(entries: string[]): number {\n  if (entries.length === 0) {\n    return 0;\n  }\n  return entries.join(MEMORY_ENTRY_DELIMITER).length;\n}\n\nexport function scanForThreats(content: string): string | null {\n  const patterns: Array<{ regex: RegExp; id: string }> = [\n    { regex: /ignore\\s+(previous|all|above|prior)\\s+instructions/i, id: 'prompt_injection' },\n    { regex: /you\\s+are\\s+now\\s+/i, id: 'role_hijack' },\n    { regex: /do\\s+not\\s+tell\\s+the\\s+user/i, id: 'deception_hide' },\n    { regex: /system\\s+prompt\\s+override/i, id: 'sys_prompt_override' },\n    {\n      regex: /disregard\\s+(your|all|any)\\s+(instructions|rules|guidelines)/i,\n      id: 'disregard_rules',\n    },\n    {\n      regex: /act\\s+as\\s+(if|though)\\s+you\\s+(have\\s+no|don't\\s+have)\\s+(restrictions|limits|rules)/i,\n      id: 'bypass_restrictions',\n    },\n    { regex: /curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_curl' },\n    { regex: /wget\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_wget' },\n    {\n      regex: /cat\\s+[^\\n]*(\\.env|credentials|\\.netrc|\\.pgpass|\\.npmrc|\\.pypirc)/i,\n      id: 'read_secrets',\n    },\n    { regex: /authorized_keys/i, id: 'ssh_backdoor' },\n    { regex: /\\$HOME\\/\\.ssh|\\~\\/\\.ssh/i, id: 'ssh_access' },\n  ];\n\n  for (const { regex, id } of patterns) {\n    if (regex.test(content)) {\n      return `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection payloads.`;\n    }\n  }\n\n  const invisibleChars = [\n    '\\u200b',\n    '\\u200c',\n    '\\u200d',\n    '\\u2060',\n    '\\ufeff',\n    '\\u202a',\n    '\\u202b',\n    '\\u202c',\n    '\\u202d',\n    '\\u202e',\n  ];\n  for (const char of invisibleChars) {\n    if (content.includes(char)) {\n      const code = char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');\n      return `Blocked: content contains invisible unicode character U+${code} (possible injection).`;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getAllModels, getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";

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

@@ -4,12 +4,14 @@ interface MemoryMatch {
     score: number;
     lineNumbers: number[];
 }
-interface MemorySearchOptions {
+export interface MemorySearchOptions {
     maxResults?: number;
     minScore?: number;
+    /** Absolute path to agent-scoped curated memories dir (MEMORY.md + USER.md). */
+    memoriesDir?: string;
 }
 export declare function memorySearch(baseDir: string, query: string, options?: MemorySearchOptions): Promise<MemoryMatch[]>;
-export declare function memoryGet(baseDir: string, path: string, from?: number, lines?: number): {
+export declare function memoryGet(baseDir: string, path: string, from?: number, lines?: number, memoriesDir?: string): {
     content: string;
     lineNumbers: {
         start: number;

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

@@ -1,6 +1,11 @@
+import { createLogger } from "../../../utils/logger/index.js";
+import { init_logger } from "../../../utils/logger.js";
 import { join, relative } from "path";
 import { existsSync, readFileSync } from "fs";
 //#region src/agent/prompt/memory/index.ts
+init_logger();
+const log = createLogger("MemorySearch");
+const CURATED_MEMORY_FILENAMES = new Set(["MEMORY.md", "USER.md"]);
 function getDailyMemoryPath(baseDir, date) {
 	const d = date || /* @__PURE__ */ new Date();
 	return join(baseDir, `memory`, `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}.md`);
@@ -8,13 +13,13 @@ function getDailyMemoryPath(baseDir, date) {
 function getLongTermMemoryPath(baseDir) {
 	return join(baseDir, "MEMORY.md");
 }
-function getCuratedMemoryPaths(baseDir) {
-	const memDir = join(baseDir, ".xopc", "memories");
-	return [join(memDir, "MEMORY.md"), join(memDir, "USER.md")].filter((p) => existsSync(p));
+function getCuratedMemoryPaths(memoriesDir) {
+	if (!memoriesDir) return [];
+	return [join(memoriesDir, "MEMORY.md"), join(memoriesDir, "USER.md")].filter((p) => existsSync(p));
 }
-function getAllMemoryPaths(baseDir) {
+function getAllMemoryPaths(baseDir, memoriesDir) {
 	const paths = [];
-	paths.push(...getCuratedMemoryPaths(baseDir));
+	paths.push(...getCuratedMemoryPaths(memoriesDir));
 	const longTermPath = getLongTermMemoryPath(baseDir);
 	if (existsSync(longTermPath)) paths.push(longTermPath);
 	if (existsSync(join(baseDir, "memory"))) {
@@ -69,8 +74,8 @@ function searchInContent(query, content, options = {}) {
 	};
 }
 async function memorySearch(baseDir, query, options = {}) {
-	const { maxResults = 5, minScore = .3 } = options;
-	const paths = getAllMemoryPaths(baseDir);
+	const { maxResults = 5, minScore = .3, memoriesDir } = options;
+	const paths = getAllMemoryPaths(baseDir, memoriesDir);
 	const results = [];
 	for (const path of paths) try {
 		const match = searchInContent(query, parseMemoryFile(path).content, options);
@@ -79,13 +84,20 @@ async function memorySearch(baseDir, query, options = {}) {
 			if (match.score >= minScore) results.push(match);
 		}
 	} catch {
-		console.warn(`Could not read memory file: ${path}`);
+		log.warn({ path }, "Could not read memory file");
 	}
 	results.sort((a, b) => b.score - a.score);
 	return results.slice(0, maxResults * 3);
 }
-function memoryGet(baseDir, path, from, lines) {
-	const fullPath = path.startsWith("/") ? path : join(baseDir, path);
+function memoryGet(baseDir, path, from, lines, memoriesDir) {
+	let fullPath = path.startsWith("/") ? path : join(baseDir, path);
+	if (!existsSync(fullPath) && memoriesDir) {
+		const filename = path.split(/[/\\]/).pop() ?? path;
+		if (CURATED_MEMORY_FILENAMES.has(filename)) {
+			const candidatePath = join(memoriesDir, filename);
+			if (existsSync(candidatePath)) fullPath = candidatePath;
+		}
+	}
 	if (!existsSync(fullPath)) return null;
 	const allLines = readFileSync(fullPath, "utf-8").split("\n");
 	const start = from || 1;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/prompt/memory/index.ts"],"sourcesContent":["// Memory Search - Semantic memory recall system\nimport { readFileSync, existsSync } from 'fs';\nimport { join, relative } from 'path';\n\n// =============================================================================\n// Types (Internal)\n// =============================================================================\n\ninterface MemoryMatch {\n  file: string;\n  lines: string;\n  score: number;\n  lineNumbers: number[];\n}\n\ninterface MemorySearchOptions {\n  maxResults?: number;\n  minScore?: number;\n}\n\ninterface MemoryFile {\n  path: string;\n  content: string;\n  modified: Date;\n}\n\n// =============================================================================\n// Memory Path Utilities (Internal)\n// =============================================================================\n\nfunction getDailyMemoryPath(baseDir: string, date?: Date): string {\n  const d = date || new Date();\n  const year = d.getFullYear();\n  const month = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return join(baseDir, `memory`, `${year}-${month}-${day}.md`);\n}\n\nfunction getLongTermMemoryPath(baseDir: string): string {\n  return join(baseDir, 'MEMORY.md');\n}\n\nfunction getCuratedMemoryPaths(baseDir: string): string[] {\n  const memDir = join(baseDir, '.xopc', 'memories');\n  const curated = [join(memDir, 'MEMORY.md'), join(memDir, 'USER.md')];\n  return curated.filter((p) => existsSync(p));\n}\n\nfunction getAllMemoryPaths(baseDir: string): string[] {\n  const paths: string[] = [];\n\n  paths.push(...getCuratedMemoryPaths(baseDir));\n\n  // Long-term memory\n  const longTermPath = getLongTermMemoryPath(baseDir);\n  if (existsSync(longTermPath)) {\n    paths.push(longTermPath);\n  }\n  \n  // Daily memories (last 30 days)\n  const memoryDir = join(baseDir, 'memory');\n  if (existsSync(memoryDir)) {\n    const today = new Date();\n    for (let i = 0; i < 30; i++) {\n      const date = new Date(today);\n      date.setDate(date.getDate() - i);\n      const path = getDailyMemoryPath(baseDir, date);\n      if (existsSync(path)) {\n        paths.push(path);\n      }\n    }\n  }\n  \n  return paths;\n}\n\n// =============================================================================\n// Content Parsing (Internal)\n// =============================================================================\n\nfunction parseMemoryFile(path: string): MemoryFile {\n  const content = readFileSync(path, 'utf-8');\n  const stats = existsSync(path) ? { mtime: new Date() } : { mtime: new Date() };\n  \n  return {\n    path,\n    content,\n    modified: stats.mtime,\n  };\n}\n\n// =============================================================================\n// Simple Fuzzy Search (Internal)\n// =============================================================================\n\nfunction fuzzyMatch(query: string, text: string): number {\n  const queryLower = query.toLowerCase();\n  const textLower = text.toLowerCase();\n  \n  // Exact match\n  if (textLower.includes(queryLower)) {\n    return 1.0;\n  }\n  \n  // Word-by-word match\n  const queryWords = queryLower.split(/\\s+/);\n  const textWords = textLower.split(/\\s+/);\n  \n  let matchedWords = 0;\n  for (const qWord of queryWords) {\n    if (textWords.some(tWord => tWord.includes(qWord) || qWord.includes(tWord))) {\n      matchedWords++;\n    }\n  }\n  \n  return matchedWords / queryWords.length;\n}\n\nfunction searchInContent(query: string, content: string, options: MemorySearchOptions = {}): MemoryMatch | null {\n  const { maxResults = 5, minScore = 0.3 } = options;\n  \n  const lines = content.split('\\n');\n  const matches: Array<{ line: string; index: number; score: number }> = [];\n  \n  for (let i = 0; i < lines.length; i++) {\n    const score = fuzzyMatch(query, lines[i]);\n    if (score >= minScore) {\n      matches.push({ line: lines[i], index: i, score });\n    }\n  }\n  \n  // Sort by score descending\n  matches.sort((a, b) => b.score - a.score);\n  \n  if (matches.length === 0) {\n    return null;\n  }\n  \n  // Take top matches\n  const topMatches = matches.slice(0, maxResults);\n  const lineNumbers = topMatches.map(m => m.index + 1);\n  const linesContent = topMatches.map(m => m.line).join('\\n');\n  \n  return {\n    file: '', // Will be set by caller\n    lines: linesContent,\n    score: topMatches[0].score,\n    lineNumbers,\n  };\n}\n\n// =============================================================================\n// Main Search Function (Exported)\n// =============================================================================\n\nexport async function memorySearch(\n  baseDir: string,\n  query: string,\n  options: MemorySearchOptions = {}\n): Promise<MemoryMatch[]> {\n  const { maxResults = 5, minScore = 0.3 } = options;\n  \n  const paths = getAllMemoryPaths(baseDir);\n  const results: MemoryMatch[] = [];\n  \n  for (const path of paths) {\n    try {\n      const memoryFile = parseMemoryFile(path);\n      const match = searchInContent(query, memoryFile.content, options);\n      \n      if (match) {\n        match.file = relative(baseDir, path);\n        if (match.score >= minScore) {\n          results.push(match);\n        }\n      }\n    } catch {\n      // Skip files that can't be read\n      console.warn(`Could not read memory file: ${path}`);\n    }\n  }\n  \n  // Sort all results by score\n  results.sort((a, b) => b.score - a.score);\n  \n  // Return top results per file or overall\n  return results.slice(0, maxResults * 3); // Return more to allow grouping\n}\n\n// =============================================================================\n// Memory Get (Read Snippet) (Exported)\n// =============================================================================\n\nexport function memoryGet(\n  baseDir: string,\n  path: string,\n  from?: number,\n  lines?: number\n): { content: string; lineNumbers: { start: number; end: number } } | null {\n  const fullPath = path.startsWith('/') ? path : join(baseDir, path);\n  \n  if (!existsSync(fullPath)) {\n    return null;\n  }\n  \n  const content = readFileSync(fullPath, 'utf-8');\n  const allLines = content.split('\\n');\n  \n  const start = from || 1;\n  const count = lines || 10;\n  const end = Math.min(start + count - 1, allLines.length);\n  \n  const snippet = allLines.slice(start - 1, end).join('\\n');\n  \n  return {\n    content: snippet,\n    lineNumbers: { start, end },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/prompt/memory/index.ts"],"sourcesContent":["// Memory Search - Semantic memory recall system\nimport { readFileSync, existsSync } from 'fs';\nimport { join, relative } from 'path';\n\nimport { createLogger } from '../../../utils/logger.js';\n\nconst log = createLogger('MemorySearch');\n\n// =============================================================================\n// Types (Internal)\n// =============================================================================\n\ninterface MemoryMatch {\n  file: string;\n  lines: string;\n  score: number;\n  lineNumbers: number[];\n}\n\nexport interface MemorySearchOptions {\n  maxResults?: number;\n  minScore?: number;\n  /** Absolute path to agent-scoped curated memories dir (MEMORY.md + USER.md). */\n  memoriesDir?: string;\n}\n\ninterface MemoryFile {\n  path: string;\n  content: string;\n  modified: Date;\n}\n\nconst CURATED_MEMORY_FILENAMES = new Set(['MEMORY.md', 'USER.md']);\n\n// =============================================================================\n// Memory Path Utilities (Internal)\n// =============================================================================\n\nfunction getDailyMemoryPath(baseDir: string, date?: Date): string {\n  const d = date || new Date();\n  const year = d.getFullYear();\n  const month = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return join(baseDir, `memory`, `${year}-${month}-${day}.md`);\n}\n\nfunction getLongTermMemoryPath(baseDir: string): string {\n  return join(baseDir, 'MEMORY.md');\n}\n\nfunction getCuratedMemoryPaths(memoriesDir: string | undefined): string[] {\n  if (!memoriesDir) return [];\n  const curated = [join(memoriesDir, 'MEMORY.md'), join(memoriesDir, 'USER.md')];\n  return curated.filter((p) => existsSync(p));\n}\n\nfunction getAllMemoryPaths(baseDir: string, memoriesDir?: string): string[] {\n  const paths: string[] = [];\n\n  paths.push(...getCuratedMemoryPaths(memoriesDir));\n\n  // Long-term memory (workspace root)\n  const longTermPath = getLongTermMemoryPath(baseDir);\n  if (existsSync(longTermPath)) {\n    paths.push(longTermPath);\n  }\n\n  // Daily memories (last 30 days)\n  const memoryDir = join(baseDir, 'memory');\n  if (existsSync(memoryDir)) {\n    const today = new Date();\n    for (let i = 0; i < 30; i++) {\n      const date = new Date(today);\n      date.setDate(date.getDate() - i);\n      const path = getDailyMemoryPath(baseDir, date);\n      if (existsSync(path)) {\n        paths.push(path);\n      }\n    }\n  }\n\n  return paths;\n}\n\n// =============================================================================\n// Content Parsing (Internal)\n// =============================================================================\n\nfunction parseMemoryFile(path: string): MemoryFile {\n  const content = readFileSync(path, 'utf-8');\n  const stats = existsSync(path) ? { mtime: new Date() } : { mtime: new Date() };\n\n  return {\n    path,\n    content,\n    modified: stats.mtime,\n  };\n}\n\n// =============================================================================\n// Simple Fuzzy Search (Internal)\n// =============================================================================\n\nfunction fuzzyMatch(query: string, text: string): number {\n  const queryLower = query.toLowerCase();\n  const textLower = text.toLowerCase();\n\n  // Exact match\n  if (textLower.includes(queryLower)) {\n    return 1.0;\n  }\n\n  // Word-by-word match\n  const queryWords = queryLower.split(/\\s+/);\n  const textWords = textLower.split(/\\s+/);\n\n  let matchedWords = 0;\n  for (const qWord of queryWords) {\n    if (textWords.some((tWord) => tWord.includes(qWord) || qWord.includes(tWord))) {\n      matchedWords++;\n    }\n  }\n\n  return matchedWords / queryWords.length;\n}\n\nfunction searchInContent(query: string, content: string, options: MemorySearchOptions = {}): MemoryMatch | null {\n  const { maxResults = 5, minScore = 0.3 } = options;\n\n  const lines = content.split('\\n');\n  const matches: Array<{ line: string; index: number; score: number }> = [];\n\n  for (let i = 0; i < lines.length; i++) {\n    const score = fuzzyMatch(query, lines[i]);\n    if (score >= minScore) {\n      matches.push({ line: lines[i], index: i, score });\n    }\n  }\n\n  // Sort by score descending\n  matches.sort((a, b) => b.score - a.score);\n\n  if (matches.length === 0) {\n    return null;\n  }\n\n  // Take top matches\n  const topMatches = matches.slice(0, maxResults);\n  const lineNumbers = topMatches.map((m) => m.index + 1);\n  const linesContent = topMatches.map((m) => m.line).join('\\n');\n\n  return {\n    file: '', // Will be set by caller\n    lines: linesContent,\n    score: topMatches[0].score,\n    lineNumbers,\n  };\n}\n\n// =============================================================================\n// Main Search Function (Exported)\n// =============================================================================\n\nexport async function memorySearch(\n  baseDir: string,\n  query: string,\n  options: MemorySearchOptions = {},\n): Promise<MemoryMatch[]> {\n  const { maxResults = 5, minScore = 0.3, memoriesDir } = options;\n\n  const paths = getAllMemoryPaths(baseDir, memoriesDir);\n  const results: MemoryMatch[] = [];\n\n  for (const path of paths) {\n    try {\n      const memoryFile = parseMemoryFile(path);\n      const match = searchInContent(query, memoryFile.content, options);\n\n      if (match) {\n        match.file = relative(baseDir, path);\n        if (match.score >= minScore) {\n          results.push(match);\n        }\n      }\n    } catch {\n      log.warn({ path }, 'Could not read memory file');\n    }\n  }\n\n  // Sort all results by score\n  results.sort((a, b) => b.score - a.score);\n\n  // Return top results per file or overall\n  return results.slice(0, maxResults * 3); // Return more to allow grouping\n}\n\n// =============================================================================\n// Memory Get (Read Snippet) (Exported)\n// =============================================================================\n\nexport function memoryGet(\n  baseDir: string,\n  path: string,\n  from?: number,\n  lines?: number,\n  memoriesDir?: string,\n): { content: string; lineNumbers: { start: number; end: number } } | null {\n  let fullPath = path.startsWith('/') ? path : join(baseDir, path);\n\n  if (!existsSync(fullPath) && memoriesDir) {\n    const segments = path.split(/[/\\\\]/);\n    const filename = segments.pop() ?? path;\n    if (CURATED_MEMORY_FILENAMES.has(filename)) {\n      const candidatePath = join(memoriesDir, filename);\n      if (existsSync(candidatePath)) {\n        fullPath = candidatePath;\n      }\n    }\n  }\n\n  if (!existsSync(fullPath)) {\n    return null;\n  }\n\n  const content = readFileSync(fullPath, 'utf-8');\n  const allLines = content.split('\\n');\n\n  const start = from || 1;\n  const count = lines || 10;\n  const end = Math.min(start + count - 1, allLines.length);\n\n  const snippet = allLines.slice(start - 1, end).join('\\n');\n\n  return {\n    content: snippet,\n    lineNumbers: { start, end },\n  };\n}\n"],"mappings":";;;;;aAIwD;AAExD,MAAM,MAAM,aAAa,eAAe;AA0BxC,MAAM,2BAA2B,IAAI,IAAI,CAAC,aAAa,UAAU,CAAC;AAMlE,SAAS,mBAAmB,SAAiB,MAAqB;CAChE,MAAM,IAAI,wBAAQ,IAAI,MAAM;AAI5B,QAAO,KAAK,SAAS,UAAU,GAHlB,EAAE,aAGuB,CAAC,GAFzB,OAAO,EAAE,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAEJ,CAAC,GADpC,OAAO,EAAE,SAAS,CAAC,CAAC,SAAS,GAAG,IACU,CAAC,KAAK;;AAG9D,SAAS,sBAAsB,SAAyB;AACtD,QAAO,KAAK,SAAS,YAAY;;AAGnC,SAAS,sBAAsB,aAA2C;AACxE,KAAI,CAAC,YAAa,QAAO,EAAE;AAE3B,QAAO,CADU,KAAK,aAAa,YAAY,EAAE,KAAK,aAAa,UAAU,CAC/D,CAAC,QAAQ,MAAM,WAAW,EAAE,CAAC;;AAG7C,SAAS,kBAAkB,SAAiB,aAAgC;CAC1E,MAAM,QAAkB,EAAE;AAE1B,OAAM,KAAK,GAAG,sBAAsB,YAAY,CAAC;CAGjD,MAAM,eAAe,sBAAsB,QAAQ;AACnD,KAAI,WAAW,aAAa,CAC1B,OAAM,KAAK,aAAa;AAK1B,KAAI,WADc,KAAK,SAAS,SACR,CAAC,EAAE;EACzB,MAAM,wBAAQ,IAAI,MAAM;AACxB,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,OAAO,IAAI,KAAK,MAAM;AAC5B,QAAK,QAAQ,KAAK,SAAS,GAAG,EAAE;GAChC,MAAM,OAAO,mBAAmB,SAAS,KAAK;AAC9C,OAAI,WAAW,KAAK,CAClB,OAAM,KAAK,KAAK;;;AAKtB,QAAO;;AAOT,SAAS,gBAAgB,MAA0B;AAIjD,QAAO;EACL;EACA,SALc,aAAa,MAAM,QAK1B;EACP,WALY,WAAW,KAAK,GAAG,EAAE,uBAAO,IAAI,MAAM,EAAE,GAAG,EAAE,uBAAO,IAAI,MAAM,EAAE,EAK5D;EACjB;;AAOH,SAAS,WAAW,OAAe,MAAsB;CACvD,MAAM,aAAa,MAAM,aAAa;CACtC,MAAM,YAAY,KAAK,aAAa;AAGpC,KAAI,UAAU,SAAS,WAAW,CAChC,QAAO;CAIT,MAAM,aAAa,WAAW,MAAM,MAAM;CAC1C,MAAM,YAAY,UAAU,MAAM,MAAM;CAExC,IAAI,eAAe;AACnB,MAAK,MAAM,SAAS,WAClB,KAAI,UAAU,MAAM,UAAU,MAAM,SAAS,MAAM,IAAI,MAAM,SAAS,MAAM,CAAC,CAC3E;AAIJ,QAAO,eAAe,WAAW;;AAGnC,SAAS,gBAAgB,OAAe,SAAiB,UAA+B,EAAE,EAAsB;CAC9G,MAAM,EAAE,aAAa,GAAG,WAAW,OAAQ;CAE3C,MAAM,QAAQ,QAAQ,MAAM,KAAK;CACjC,MAAM,UAAiE,EAAE;AAEzE,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,QAAQ,WAAW,OAAO,MAAM,GAAG;AACzC,MAAI,SAAS,SACX,SAAQ,KAAK;GAAE,MAAM,MAAM;GAAI,OAAO;GAAG;GAAO,CAAC;;AAKrD,SAAQ,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;AAEzC,KAAI,QAAQ,WAAW,EACrB,QAAO;CAIT,MAAM,aAAa,QAAQ,MAAM,GAAG,WAAW;CAC/C,MAAM,cAAc,WAAW,KAAK,MAAM,EAAE,QAAQ,EAAE;AAGtD,QAAO;EACL,MAAM;EACN,OAJmB,WAAW,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,KAInC;EACnB,OAAO,WAAW,GAAG;EACrB;EACD;;AAOH,eAAsB,aACpB,SACA,OACA,UAA+B,EAAE,EACT;CACxB,MAAM,EAAE,aAAa,GAAG,WAAW,IAAK,gBAAgB;CAExD,MAAM,QAAQ,kBAAkB,SAAS,YAAY;CACrD,MAAM,UAAyB,EAAE;AAEjC,MAAK,MAAM,QAAQ,MACjB,KAAI;EAEF,MAAM,QAAQ,gBAAgB,OADX,gBAAgB,KACY,CAAC,SAAS,QAAQ;AAEjE,MAAI,OAAO;AACT,SAAM,OAAO,SAAS,SAAS,KAAK;AACpC,OAAI,MAAM,SAAS,SACjB,SAAQ,KAAK,MAAM;;SAGjB;AACN,MAAI,KAAK,EAAE,MAAM,EAAE,6BAA6B;;AAKpD,SAAQ,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM;AAGzC,QAAO,QAAQ,MAAM,GAAG,aAAa,EAAE;;AAOzC,SAAgB,UACd,SACA,MACA,MACA,OACA,aACyE;CACzE,IAAI,WAAW,KAAK,WAAW,IAAI,GAAG,OAAO,KAAK,SAAS,KAAK;AAEhE,KAAI,CAAC,WAAW,SAAS,IAAI,aAAa;EAExC,MAAM,WADW,KAAK,MAAM,QACH,CAAC,KAAK,IAAI;AACnC,MAAI,yBAAyB,IAAI,SAAS,EAAE;GAC1C,MAAM,gBAAgB,KAAK,aAAa,SAAS;AACjD,OAAI,WAAW,cAAc,CAC3B,YAAW;;;AAKjB,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;CAIT,MAAM,WADU,aAAa,UAAU,QACf,CAAC,MAAM,KAAK;CAEpC,MAAM,QAAQ,QAAQ;CAEtB,MAAM,MAAM,KAAK,IAAI,SADP,SAAS,MACc,GAAG,SAAS,OAAO;AAIxD,QAAO;EACL,SAHc,SAAS,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAGlC;EAChB,aAAa;GAAE;GAAO;GAAK;EAC5B"}

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -1,6 +1,6 @@
+import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { DEFAULT_USER_FILENAME, toWorkspaceBootstrapFile } from "../context/workspace.js";
 import { createSkillConfigManager } from "../skills/config.js";

package/dist/src/agent/service.js

@@ -1,11 +1,11 @@
-import { runWithLogContext, updateAsyncLogContext } from "../utils/logger/context.js";
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
 import { init_agent_scope, resolveAgentBootstrapDir, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { applyConfigOverrides } from "../config/runtime-overrides.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { runWithLogContext, updateAsyncLogContext } from "../utils/logger/context.js";
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { extractTextContent, loadBootstrapFiles } from "./context/workspace.js";
 import { isTTSAvailable } from "../voice/tts/factory.js";
@@ -28,12 +28,12 @@ import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from ".
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput } from "../session/session-workspace.js";
 import "../session/index.js";
 import { parseSlashCommand } from "../chat-commands/command-parse.js";
+import { commandRegistry } from "../chat-commands/registry.js";
 import { ExtensionHookRunner } from "../extensions/hooks.js";
 import "../extensions/index.js";
 import { SessionTracker } from "./session/tracker.js";
 import { ModelManager } from "./models/manager.js";
 import "./models/index.js";
-import { commandRegistry } from "../chat-commands/registry.js";
 import "../voice/tts/index.js";
 import { initializeCommands } from "../chat-commands/index.js";
 import { ProgressFeedbackManager } from "./lifecycle/progress.js";

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

@@ -1,6 +1,6 @@
+import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { findInstallSpec, getDefaultInstallerPreferences, hasBinary, init_installer, installSkill } from "./installer.js";

package/dist/src/agent/skills/scanner.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { readFile, readdir } from "fs/promises";
 import { join } from "path";
+import { readFile, readdir } from "fs/promises";
 //#region src/agent/skills/scanner.ts
 /**
 * Skill security scanner — scans skill directories for potentially dangerous code patterns.

package/dist/src/agent/skills/skill-manage-ops.js

@@ -2,9 +2,9 @@ import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";
-import { mkdir, writeFile } from "fs/promises";
 import { join, resolve, sep } from "path";
 import { existsSync, realpathSync } from "fs";
+import { mkdir, writeFile } from "fs/promises";
 //#region src/agent/skills/skill-manage-ops.ts
 /**
 * Shared logic for the skill_manage agent tool (create / edit / patch / delete / write_file / remove_file).

package/dist/src/agent/skills/skill-manager.js

@@ -1,6 +1,6 @@
+import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths, resolveBundledSkillsDir } from "../../config/paths.js";
 import { createSkillConfigManager, isSkillEnabled } from "./config.js";
 import { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from "./format-skills-prompt.js";

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

@@ -1,6 +1,6 @@
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
@@ -73,6 +73,7 @@ var AgentToolsFactory = class {
 		const { bus } = this.deps;
 		const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;
 		const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;
+		const memoriesDir = (getBuiltin?.())?.memoriesDir;
 		const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;
 		const getSkillMgr = options?.getSkillManager;
 		const disabled = options?.disabledTools;
@@ -138,8 +139,14 @@ var AgentToolsFactory = class {
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
 			createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),
-			createMemorySearchTool(workspace),
-			createMemoryGetTool(workspace),
+			createMemorySearchTool({
+				workspaceDir: workspace,
+				memoriesDir
+			}),
+			createMemoryGetTool({
+				workspaceDir: workspace,
+				memoriesDir
+			}),
 			...getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.()) ? [createCuratedMemoryTool(getBuiltin, { onMemoryWrite: (action, target, content) => {
 				getMemMgr?.().onMemoryWrite(action, target, content);
 			} })] : [],

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

@@ -1 +1 @@
-{"version":3,"file":"factory.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/tools/factory.ts"],"sourcesContent":["/**\n * Agent Tools Factory - Creates and configures agent tools\n *\n * Centralizes tool creation logic to keep service.ts focused on orchestration.\n *\n * TTS: auto TTS is applied at the ChannelManager via maybeApplyTtsToPayload().\n * Optional \\`text_to_speech\\` tool sends explicit voice when TTS is enabled.\n */\n\nimport type { AgentTool } from '@mariozechner/pi-agent-core';\nimport type { Model, Api } from '@mariozechner/pi-ai';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createEditFileTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createShellTool,\n  createWebSearchTool,\n  webFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createSendMediaTool,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createClarifyTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport { BrowserManager, createBrowserTools } from './browser/index.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { wrapToolsWithProtection, type ToolExecutorConfig } from './executor.js';\nimport { createSkillsListTool, createSkillViewTool } from './skills-tools.js';\nimport { createSkillManageTool } from './skill-manage-tool.js';\nimport { createTextToSpeechTool } from './tts-tool.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\n\nconst log = createLogger('AgentToolsFactory');\n\n/** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */\nconst CLARIFY_SUPPORTED_CHANNELS = new Set(['webchat', 'telegram', 'cli']);\n\nfunction clarifyTransportSource(sessionKey: string): string | undefined {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) return parsed.source;\n  // Fallback for simple `<channel>:<chatId>` keys used by webchat and CLI.\n  const first = sessionKey.split(':').filter(Boolean)[0] ?? '';\n  if (first === 'cli' || first === 'webchat') return first;\n  return undefined;\n}\n\nexport interface ToolFactoryDeps {\n  workspace: string;\n  extensionRegistry?: any;\n  getCurrentContext: () => { channel: string; chatId: string; sessionKey: string } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /** Agent defaults (image tools, etc.); use getter so hot-reloaded config applies. */\n  getConfig?: () => Config | undefined;\n  /** Session / default chat model for vision tool description. */\n  getPrimaryModel?: () => Model<Api>;\n  /** Built-in curated memory store (agent home `memories/`). */\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  /** Memory orchestration (prefetch/sync + external tools). */\n  getMemoryManager?: () => MemoryManager;\n  /** Session store for `session_search`. */\n  getSessionStore?: () => SessionStore;\n  /** When set (gateway webchat), enables the `clarify` tool. */\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: enables the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */\n  getSkillIndexingContext?: () =>\n    | { registeredToolNames: string[]; skillAllowlist?: string[] }\n    | undefined;\n  /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */\n  onSkillsFilesystemMutate?: () => void;\n  /** Names registered via skill_view for shell env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/shell tools (defaults to factory workspace). */\n  workspace?: string;\n  /** `…/agents/<id>/bootstrap` — used so `read_file` can find SOUL.md etc. by filename. */\n  bootstrapDir?: string;\n  /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  getMemoryManager?: () => MemoryManager;\n  /** When set, registers `skills_list` and `skill_view` bound to this workspace\\'s skills. */\n  getSkillManager?: () => SkillManager;\n}\n\nexport class AgentToolsFactory {\n  private browserManager: BrowserManager | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless !== false,\n      });\n    }\n    return this.browserManager;\n  }\n\n  /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */\n  async shutdownBrowser(): Promise<void> {\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    await this.browserManager?.closePage(sessionKey);\n  }\n\n  createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const workspace = options?.workspace ?? this.deps.workspace;\n    const { bus } = this.deps;\n    const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n    const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;\n    const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;\n    const getSkillMgr = options?.getSkillManager;\n    const disabled = options?.disabledTools;\n\n    const primary = getPrimary?.();\n    const modelHasVision = primary?.input?.includes('image') ?? false;\n    const cfg = this.deps.getConfig?.();\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n\n    const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, { bootstrapDir: options?.bootstrapDir });\n    const writeTool = createWriteFileTool(workspace);\n    const editTool = createEditFileTool(workspace);\n    const listDir = createListDirTool(workspace);\n    const grep = createGrepTool(workspace);\n    const find = createFindTool(workspace);\n\n    const core: AgentTool<any, any>[] = [\n      createSessionStatusTool(),\n      createClarifyTool({\n        resolveAskUser: () => {\n          const req = this.deps.gatewayClarify?.requestClarification;\n          if (!req) return null;\n          const ctx = this.deps.getCurrentContext();\n          if (!ctx?.sessionKey) return null;\n          const source = clarifyTransportSource(ctx.sessionKey);\n          if (!source || !CLARIFY_SUPPORTED_CHANNELS.has(source)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(getSkillMgr\n        ? [\n            createSkillsListTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n            }),\n            createSkillViewTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n              registerSkillEnvPassthrough: this.deps.registerSkillEnvPassthrough,\n            }),\n            createSkillManageTool({\n              getSkillManager: getSkillMgr,\n              getWorkspace: () => workspace,\n              onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,\n            }),\n          ]\n        : []),\n      readTool,\n      writeTool,\n      editTool,\n      listDir,\n      grep,\n      find,\n      createShellTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      webFetchTool,\n      createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),\n      // Note: TTS is NOT handled by send_message tool anymore\n      // TTS is applied at the ChannelManager dispatch layer\n      createMessageTool(bus, () => this.deps.getCurrentContext()),\n      ...(mergeTtsConfigFromAppConfig(cfg?.tts).enabled\n        ? [\n            createTextToSpeechTool({\n              bus,\n              getContext: () => this.deps.getCurrentContext(),\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),\n      createMemorySearchTool(workspace),\n      createMemoryGetTool(workspace),\n      ...(getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(getBuiltin, {\n              onMemoryWrite: (action, target, content) => {\n                getMemMgr?.().onMemoryWrite(action, target, content);\n              },\n            }),\n          ]\n        : []),\n      ...(getMemMgr?.().getAdditionalTools() ?? []),\n      ...(this.deps.getSessionStore\n        ? [\n            createSessionSearchTool({\n              getSessionStore: this.deps.getSessionStore,\n              getConfig: this.deps.getConfig,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n            }),\n          ]\n        : []),\n      ...(this.deps.getCronService\n        ? [\n            createCronjobTool({\n              getCronService: this.deps.getCronService,\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.browser?.enabled === true\n        ? createBrowserTools({\n            getManager: () => this.ensureBrowserManager(),\n            getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n            getConfig: () => this.deps.getConfig?.(),\n          })\n        : []),\n      ...(cfg?.agents?.defaults?.delegate?.enabled === true && primary\n        ? [\n            createDelegateTool({\n              workspace,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for delegate_task');\n                }\n                return m;\n              },\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,\n              hookRunner: this.deps.hookRunner,\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\n    const cfg = this.deps.getConfig?.();\n\n    let bundled: AgentTool<any, any>[];\n    if (!this.deps.extensionRegistry || disableExtensions) {\n      bundled = coreTools;\n    } else {\n      const extensionTools = this.deps.extensionRegistry.getAllTools();\n      log.info({ count: extensionTools.length }, 'Loaded extension tools');\n      bundled = [...coreTools, ...extensionTools];\n    }\n\n    const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);\n\n    const executeEnabled =\n      cfg?.agents?.defaults?.executeCode?.enabled === true &&\n      !coreOptions?.disabledTools?.has('execute_code');\n\n    if (executeEnabled) {\n      const sandboxMap = buildSandboxToolMap(wrapped);\n      const executeTool = createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap });\n      const wrappedExecute = wrapToolsWithProtection([executeTool as any], this.deps.toolExecutorConfig);\n      return [...wrapped, ...wrappedExecute];\n    }\n\n    return wrapped;\n  }\n}\n\nfunction filterToolsByDisabledSet(\n  tools: any[],\n  disabled: Set<string> | undefined,\n): any[] {\n  if (!disabled || disabled.size === 0) {\n    return tools;\n  }\n  return tools.filter((t) => !disabled.has(t.name));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsCyF;aASpC;AAQrD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAM,6BAA6B,IAAI,IAAI;CAAC;CAAW;CAAY;CAAM,CAAC;AAE1E,SAAS,uBAAuB,YAAwC;CACtE,MAAM,SAASA,gBAAuB,WAAW;AACjD,KAAI,OAAQ,QAAO,OAAO;CAE1B,MAAM,QAAQ,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,MAAM;AAC1D,KAAI,UAAU,SAAS,UAAU,UAAW,QAAO;;AAoDrD,IAAa,oBAAb,MAA+B;CAC7B,iBAAgD;CAEhD,YAAY,MAA+B;AAAvB,OAAA,OAAA;;CAEpB,uBAA+C;AAC7C,MAAI,CAAC,KAAK,eACR,MAAK,iBAAiB,IAAI,eAAe,EACvC,mBAAmB,KAAK,KAAK,aAAa,EAAE,QAAQ,UAAU,SAAS,aAAa,OACrF,CAAC;AAEJ,SAAO,KAAK;;;CAId,MAAM,kBAAiC;AACrC,MAAI,CAAC,KAAK,eACR;AAEF,QAAM,KAAK,eAAe,UAAU;AACpC,OAAK,iBAAiB;;;CAIxB,MAAM,2BAA2B,YAAmC;AAClE,QAAM,KAAK,gBAAgB,UAAU,WAAW;;CAGlD,gBAAgB,SAAyD;EACvE,MAAM,YAAY,SAAS,aAAa,KAAK,KAAK;EAClD,MAAM,EAAE,QAAQ,KAAK;EACrB,MAAM,aAAa,SAAS,mBAAmB,KAAK,KAAK;EACzD,MAAM,aAAa,SAAS,yBAAyB,KAAK,KAAK;EAC/D,MAAM,YAAY,SAAS,oBAAoB,KAAK,KAAK;EACzD,MAAM,cAAc,SAAS;EAC7B,MAAM,WAAW,SAAS;EAE1B,MAAM,UAAU,cAAc;EAC9B,MAAM,iBAAiB,SAAS,OAAO,SAAS,QAAQ,IAAI;EAC5D,MAAM,MAAM,KAAK,KAAK,aAAa;EAWnC,MAAM,gBAAgB,CAVJ,gBAAgB;GAChC,QAAQ;GACR;GACA;GACD,CAM+B,EALN,wBAAwB;GAChD,QAAQ;GACR;GACD,CAEkD,CAAC,CAAC,QAAQ,MAAM,KAAK,KAAK;EAE7E,MAAM,WAAW,mBAAmB,WAAW,EAAE,cAAc,SAAS,cAAc,CAAC;EACvF,MAAM,YAAY,oBAAoB,UAAU;EAChD,MAAM,WAAW,mBAAmB,UAAU;EAC9C,MAAM,UAAU,kBAAkB,UAAU;EAC5C,MAAM,OAAO,eAAe,UAAU;EACtC,MAAM,OAAO,eAAe,UAAU;AAuHtC,SAAO,yBAAyB;GApH9B,yBAAyB;GACzB,kBAAkB,EAChB,sBAAsB;IACpB,MAAM,MAAM,KAAK,KAAK,gBAAgB;AACtC,QAAI,CAAC,IAAK,QAAO;IACjB,MAAM,MAAM,KAAK,KAAK,mBAAmB;AACzC,QAAI,CAAC,KAAK,WAAY,QAAO;IAC7B,MAAM,SAAS,uBAAuB,IAAI,WAAW;AACrD,QAAI,CAAC,UAAU,CAAC,2BAA2B,IAAI,OAAO,CAAE,QAAO;AAC/D,YAAQ,MAAM,IAAI,IAAI,YAAY,EAAE;MAEvC,CAAC;GACF,eAAe,EACb,qBAAqB,KAAK,KAAK,mBAAmB,EAAE,YACrD,CAAC;GACF,GAAI,cACA;IACE,qBAAqB;KACnB,iBAAiB;KACjB,yBAAyB,KAAK,KAAK;KACpC,CAAC;IACF,oBAAoB;KAClB,iBAAiB;KACjB,yBAAyB,KAAK,KAAK;KACnC,6BAA6B,KAAK,KAAK;KACxC,CAAC;IACF,sBAAsB;KACpB,iBAAiB;KACjB,oBAAoB;KACpB,0BAA0B,KAAK,KAAK;KACrC,CAAC;IACH,GACD,EAAE;GACN;GACA;GACA;GACA;GACA;GACA;GACA,gBAAgB,WAAW,EACzB,gCAAgC,KAAK,KAAK,gCAC3C,CAAC;GACF,0BAA0B,KAAK,KAAK,aAAa,CAAC;GAClD;GACA,qBAAqB,EAAE,iBAAiB,KAAK,KAAK,aAAa,EAAE,CAAC;GAGlE,kBAAkB,WAAW,KAAK,KAAK,mBAAmB,CAAC;GAC3D,GAAI,4BAA4B,KAAK,IAAI,CAAC,UACtC,CACE,uBAAuB;IACrB;IACA,kBAAkB,KAAK,KAAK,mBAAmB;IAC/C,iBAAiB,KAAK,KAAK,aAAa;IACzC,CAAC,CACH,GACD,EAAE;GACN,oBAAoB,WAAW,WAAW,KAAK,KAAK,mBAAmB,CAAC;GACxE,uBAAuB,UAAU;GACjC,oBAAoB,UAAU;GAC9B,GAAI,cAAc,gCAAgC,KAAK,KAAK,aAAa,CAAC,GACtE,CACE,wBAAwB,YAAY,EAClC,gBAAgB,QAAQ,QAAQ,YAAY;AAC1C,iBAAa,CAAC,cAAc,QAAQ,QAAQ,QAAQ;MAEvD,CAAC,CACH,GACD,EAAE;GACN,GAAI,aAAa,CAAC,oBAAoB,IAAI,EAAE;GAC5C,GAAI,KAAK,KAAK,kBACV,CACE,wBAAwB;IACtB,iBAAiB,KAAK,KAAK;IAC3B,WAAW,KAAK,KAAK;IACrB,4BAA4B,KAAK,KAAK,mBAAmB,EAAE;IAC5D,CAAC,CACH,GACD,EAAE;GACN,GAAI,KAAK,KAAK,iBACV,CACE,kBAAkB,EAChB,gBAAgB,KAAK,KAAK,gBAC3B,CAAC,CACH,GACD,EAAE;GACN,GAAI,KAAK,QAAQ,UAAU,SAAS,YAAY,OAC5C,mBAAmB;IACjB,kBAAkB,KAAK,sBAAsB;IAC7C,iBAAiB,KAAK,KAAK,mBAAmB,EAAE,cAAc;IAC9D,iBAAiB,KAAK,KAAK,aAAa;IACzC,CAAC,GACF,EAAE;GACN,GAAI,KAAK,QAAQ,UAAU,UAAU,YAAY,QAAQ,UACrD,CACE,mBAAmB;IACjB;IACA,wBAAwB;KAEtB,MAAM,KADK,SAAS,mBAAmB,KAAK,KAAK,oBACjC;AAChB,SAAI,CAAC,EACH,OAAM,IAAI,MAAM,gDAAgD;AAElE,YAAO;;IAET,KAAK,KAAK,KAAK;IACf,iBAAiB,KAAK,KAAK,aAAa;IACxC,yBAAyB,KAAK,KAAK,qBAAqB,IAAI;IAC5D,YAAY,KAAK,KAAK;IACtB,oBAAoB,KAAK,KAAK;IAC/B,CAAC,CACH,GACD,EAAE;GACN,GAAG;GAG+B,EAAE,SAAS;;CAGjD,eAAe,aAA6D;EAC1E,MAAM,YAAY,KAAK,gBAAgB,YAAY;EACnD,MAAM,oBAAoB,aAAa,eAAe,IAAI,aAAa;EACvE,MAAM,MAAM,KAAK,KAAK,aAAa;EAEnC,IAAI;AACJ,MAAI,CAAC,KAAK,KAAK,qBAAqB,kBAClC,WAAU;OACL;GACL,MAAM,iBAAiB,KAAK,KAAK,kBAAkB,aAAa;AAChE,OAAI,KAAK,EAAE,OAAO,eAAe,QAAQ,EAAE,yBAAyB;AACpE,aAAU,CAAC,GAAG,WAAW,GAAG,eAAe;;EAG7C,MAAM,UAAU,wBAAwB,SAAS,KAAK,KAAK,mBAAmB;AAM9E,MAHE,KAAK,QAAQ,UAAU,aAAa,YAAY,QAChD,CAAC,aAAa,eAAe,IAAI,eAAe,EAE9B;GAClB,MAAM,aAAa,oBAAoB,QAAQ;GAE/C,MAAM,iBAAiB,wBAAwB,CAD3B,sBAAsB,EAAE,yBAAyB,YAAY,CACtB,CAAQ,EAAE,KAAK,KAAK,mBAAmB;AAClG,UAAO,CAAC,GAAG,SAAS,GAAG,eAAe;;AAGxC,SAAO;;;AAIX,SAAS,yBACP,OACA,UACO;AACP,KAAI,CAAC,YAAY,SAAS,SAAS,EACjC,QAAO;AAET,QAAO,MAAM,QAAQ,MAAM,CAAC,SAAS,IAAI,EAAE,KAAK,CAAC"}
+{"version":3,"file":"factory.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/tools/factory.ts"],"sourcesContent":["/**\n * Agent Tools Factory - Creates and configures agent tools\n *\n * Centralizes tool creation logic to keep service.ts focused on orchestration.\n *\n * TTS: auto TTS is applied at the ChannelManager via maybeApplyTtsToPayload().\n * Optional \\`text_to_speech\\` tool sends explicit voice when TTS is enabled.\n */\n\nimport type { AgentTool } from '@mariozechner/pi-agent-core';\nimport type { Model, Api } from '@mariozechner/pi-ai';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createEditFileTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createShellTool,\n  createWebSearchTool,\n  webFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createSendMediaTool,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createClarifyTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport { BrowserManager, createBrowserTools } from './browser/index.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { wrapToolsWithProtection, type ToolExecutorConfig } from './executor.js';\nimport { createSkillsListTool, createSkillViewTool } from './skills-tools.js';\nimport { createSkillManageTool } from './skill-manage-tool.js';\nimport { createTextToSpeechTool } from './tts-tool.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\n\nconst log = createLogger('AgentToolsFactory');\n\n/** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */\nconst CLARIFY_SUPPORTED_CHANNELS = new Set(['webchat', 'telegram', 'cli']);\n\nfunction clarifyTransportSource(sessionKey: string): string | undefined {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) return parsed.source;\n  // Fallback for simple `<channel>:<chatId>` keys used by webchat and CLI.\n  const first = sessionKey.split(':').filter(Boolean)[0] ?? '';\n  if (first === 'cli' || first === 'webchat') return first;\n  return undefined;\n}\n\nexport interface ToolFactoryDeps {\n  workspace: string;\n  extensionRegistry?: any;\n  getCurrentContext: () => { channel: string; chatId: string; sessionKey: string } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /** Agent defaults (image tools, etc.); use getter so hot-reloaded config applies. */\n  getConfig?: () => Config | undefined;\n  /** Session / default chat model for vision tool description. */\n  getPrimaryModel?: () => Model<Api>;\n  /** Built-in curated memory store (agent home `memories/`). */\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  /** Memory orchestration (prefetch/sync + external tools). */\n  getMemoryManager?: () => MemoryManager;\n  /** Session store for `session_search`. */\n  getSessionStore?: () => SessionStore;\n  /** When set (gateway webchat), enables the `clarify` tool. */\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: enables the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */\n  getSkillIndexingContext?: () =>\n    | { registeredToolNames: string[]; skillAllowlist?: string[] }\n    | undefined;\n  /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */\n  onSkillsFilesystemMutate?: () => void;\n  /** Names registered via skill_view for shell env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/shell tools (defaults to factory workspace). */\n  workspace?: string;\n  /** `…/agents/<id>/bootstrap` — used so `read_file` can find SOUL.md etc. by filename. */\n  bootstrapDir?: string;\n  /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  getMemoryManager?: () => MemoryManager;\n  /** When set, registers `skills_list` and `skill_view` bound to this workspace\\'s skills. */\n  getSkillManager?: () => SkillManager;\n}\n\nexport class AgentToolsFactory {\n  private browserManager: BrowserManager | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless !== false,\n      });\n    }\n    return this.browserManager;\n  }\n\n  /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */\n  async shutdownBrowser(): Promise<void> {\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    await this.browserManager?.closePage(sessionKey);\n  }\n\n  createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const workspace = options?.workspace ?? this.deps.workspace;\n    const { bus } = this.deps;\n    const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n    const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;\n    const builtinStore = getBuiltin?.();\n    const memoriesDir = builtinStore?.memoriesDir;\n    const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;\n    const getSkillMgr = options?.getSkillManager;\n    const disabled = options?.disabledTools;\n\n    const primary = getPrimary?.();\n    const modelHasVision = primary?.input?.includes('image') ?? false;\n    const cfg = this.deps.getConfig?.();\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n\n    const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, { bootstrapDir: options?.bootstrapDir });\n    const writeTool = createWriteFileTool(workspace);\n    const editTool = createEditFileTool(workspace);\n    const listDir = createListDirTool(workspace);\n    const grep = createGrepTool(workspace);\n    const find = createFindTool(workspace);\n\n    const core: AgentTool<any, any>[] = [\n      createSessionStatusTool(),\n      createClarifyTool({\n        resolveAskUser: () => {\n          const req = this.deps.gatewayClarify?.requestClarification;\n          if (!req) return null;\n          const ctx = this.deps.getCurrentContext();\n          if (!ctx?.sessionKey) return null;\n          const source = clarifyTransportSource(ctx.sessionKey);\n          if (!source || !CLARIFY_SUPPORTED_CHANNELS.has(source)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(getSkillMgr\n        ? [\n            createSkillsListTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n            }),\n            createSkillViewTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n              registerSkillEnvPassthrough: this.deps.registerSkillEnvPassthrough,\n            }),\n            createSkillManageTool({\n              getSkillManager: getSkillMgr,\n              getWorkspace: () => workspace,\n              onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,\n            }),\n          ]\n        : []),\n      readTool,\n      writeTool,\n      editTool,\n      listDir,\n      grep,\n      find,\n      createShellTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      webFetchTool,\n      createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),\n      // Note: TTS is NOT handled by send_message tool anymore\n      // TTS is applied at the ChannelManager dispatch layer\n      createMessageTool(bus, () => this.deps.getCurrentContext()),\n      ...(mergeTtsConfigFromAppConfig(cfg?.tts).enabled\n        ? [\n            createTextToSpeechTool({\n              bus,\n              getContext: () => this.deps.getCurrentContext(),\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),\n      createMemorySearchTool({ workspaceDir: workspace, memoriesDir }),\n      createMemoryGetTool({ workspaceDir: workspace, memoriesDir }),\n      ...(getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(getBuiltin, {\n              onMemoryWrite: (action, target, content) => {\n                getMemMgr?.().onMemoryWrite(action, target, content);\n              },\n            }),\n          ]\n        : []),\n      ...(getMemMgr?.().getAdditionalTools() ?? []),\n      ...(this.deps.getSessionStore\n        ? [\n            createSessionSearchTool({\n              getSessionStore: this.deps.getSessionStore,\n              getConfig: this.deps.getConfig,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n            }),\n          ]\n        : []),\n      ...(this.deps.getCronService\n        ? [\n            createCronjobTool({\n              getCronService: this.deps.getCronService,\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.browser?.enabled === true\n        ? createBrowserTools({\n            getManager: () => this.ensureBrowserManager(),\n            getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n            getConfig: () => this.deps.getConfig?.(),\n          })\n        : []),\n      ...(cfg?.agents?.defaults?.delegate?.enabled === true && primary\n        ? [\n            createDelegateTool({\n              workspace,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for delegate_task');\n                }\n                return m;\n              },\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,\n              hookRunner: this.deps.hookRunner,\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\n    const cfg = this.deps.getConfig?.();\n\n    let bundled: AgentTool<any, any>[];\n    if (!this.deps.extensionRegistry || disableExtensions) {\n      bundled = coreTools;\n    } else {\n      const extensionTools = this.deps.extensionRegistry.getAllTools();\n      log.info({ count: extensionTools.length }, 'Loaded extension tools');\n      bundled = [...coreTools, ...extensionTools];\n    }\n\n    const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);\n\n    const executeEnabled =\n      cfg?.agents?.defaults?.executeCode?.enabled === true &&\n      !coreOptions?.disabledTools?.has('execute_code');\n\n    if (executeEnabled) {\n      const sandboxMap = buildSandboxToolMap(wrapped);\n      const executeTool = createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap });\n      const wrappedExecute = wrapToolsWithProtection([executeTool as any], this.deps.toolExecutorConfig);\n      return [...wrapped, ...wrappedExecute];\n    }\n\n    return wrapped;\n  }\n}\n\nfunction filterToolsByDisabledSet(\n  tools: any[],\n  disabled: Set<string> | undefined,\n): any[] {\n  if (!disabled || disabled.size === 0) {\n    return tools;\n  }\n  return tools.filter((t) => !disabled.has(t.name));\n}\n"],"mappings":"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"}

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

@@ -3,7 +3,7 @@ export { createWriteFileTool, writeFileTool } from './write.js';
 export { createEditFileTool, editFileTool, type EditToolDetails } from './edit.js';
 export { createListDirTool, listDirTool } from './list-dir.js';
 export { createShellTool } from './shell.js';
-export { createMemorySearchTool, createMemoryGetTool } from './memory-tool.js';
+export { createMemorySearchTool, createMemoryGetTool, type MemoryToolOptions, } from './memory-tool.js';
 export { createCuratedMemoryTool } from './curated-memory-tool.js';
 export { createSessionSearchTool } from './session-search-tool.js';
 export { invalidateSessionSearchIndexCache } from '../../session/search-index-cache.js';

package/dist/src/agent/tools/memory-tool.d.ts

@@ -1,3 +1,8 @@
 import type { AgentTool } from '@mariozechner/pi-agent-core';
-export declare function createMemorySearchTool(workspaceDir: string): AgentTool;
-export declare function createMemoryGetTool(workspaceDir: string): AgentTool;
+export interface MemoryToolOptions {
+    workspaceDir: string;
+    /** Agent home curated memories dir, e.g. ~/.xopc/agents/<id>/memories/ */
+    memoriesDir?: string;
+}
+export declare function createMemorySearchTool(options: MemoryToolOptions): AgentTool;
+export declare function createMemoryGetTool(options: MemoryToolOptions): AgentTool;

package/dist/src/agent/tools/memory-tool.js

@@ -6,16 +6,21 @@ const MemorySearchSchema = Type.Object({
 	maxResults: Type.Optional(Type.Number()),
 	minScore: Type.Optional(Type.Number())
 });
-function createMemorySearchTool(workspaceDir) {
+function createMemorySearchTool(options) {
+	const { workspaceDir, memoriesDir } = options;
 	return {
 		name: "memory_search",
 		label: "🔍 Memory Search",
 		description: "Mandatory recall step: semantically search bootstrap MEMORY.md, agent-home `memories/*.md`, and workspace `memory/*.md` before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with path + lines.",
 		parameters: MemorySearchSchema,
 		async execute(_toolCallId, params, _signal) {
-			const { query, maxResults } = params;
+			const { query, maxResults, minScore } = params;
 			try {
-				const withCitations = (await memorySearch(workspaceDir, query, { maxResults })).map((entry) => ({
+				const withCitations = (await memorySearch(workspaceDir, query, {
+					maxResults,
+					minScore,
+					memoriesDir
+				})).map((entry) => ({
 					...entry,
 					citation: `${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ""}`,
 					snippet: `${entry.lines.trim()}\n\nSource: ${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ""}`
@@ -48,7 +53,8 @@ const MemoryGetSchema = Type.Object({
 	from: Type.Optional(Type.Number()),
 	lines: Type.Optional(Type.Number())
 });
-function createMemoryGetTool(workspaceDir) {
+function createMemoryGetTool(options) {
+	const { workspaceDir, memoriesDir } = options;
 	return {
 		name: "memory_get",
 		label: "📄 Memory Get",
@@ -57,7 +63,7 @@ function createMemoryGetTool(workspaceDir) {
 		async execute(_toolCallId, params, _signal) {
 			const { path, from, lines } = params;
 			try {
-				const result = memoryGet(workspaceDir, path, from, lines);
+				const result = memoryGet(workspaceDir, path, from, lines, memoriesDir);
 				if (!result) return {
 					content: [{
 						type: "text",