@xopcai/xopc 0.0.24 → 0.0.26

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

@@ -0,0 +1,102 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
+import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
+import { resolveDreamingConfig } from "../memory/dreaming/config.js";
+import path from "node:path";
+import { Type } from "@sinclair/typebox";
+import fs from "node:fs/promises";
+//#region src/agent/tools/dreaming-tool.ts
+init_logger();
+const log = createLogger("DreamingTool");
+const DreamingSchema = Type.Object({ action: Type.Union([
+	Type.Literal("status"),
+	Type.Literal("reset_store"),
+	Type.Literal("clear_lock")
+]) });
+function textResult(text) {
+	return {
+		content: [{
+			type: "text",
+			text
+		}],
+		details: {}
+	};
+}
+function safeStatMs(ms) {
+	if (typeof ms !== "number" || !Number.isFinite(ms) || ms <= 0) return null;
+	return Math.floor(ms);
+}
+function isoDay(isoLike) {
+	if (!isoLike) return null;
+	return isoLike.match(/^(\d{4}-\d{2}-\d{2})/)?.[1] ?? null;
+}
+function createDreamingTool(deps) {
+	return {
+		name: "dreaming",
+		label: "💤 Dreaming",
+		description: "Inspect and maintain the dreaming promotion state.\n\nActions:\n- status: show config gates and short-term store stats\n- reset_store: clear short-term recall store (memory/.dreams/short-term-recall.json)\n- clear_lock: remove a stale promotion lock file (memory/.dreams/short-term-promotion.lock)",
+		parameters: DreamingSchema,
+		async execute(_toolCallId, params) {
+			const action = params.action;
+			const workspaceDir = deps.getWorkspace();
+			const resolved = resolveDreamingConfig(deps.getConfig());
+			const storePath = path.join(workspaceDir, SHORT_TERM_RECALL_STORE_RELATIVE);
+			const lockPath = path.join(workspaceDir, SHORT_TERM_PROMOTION_LOCK_RELATIVE);
+			if (action === "status") {
+				const { store } = await loadDreamingStore({ workspaceDir });
+				const entries = Object.values(store.entries ?? {});
+				const total = entries.length;
+				const promoted = entries.filter((e) => Boolean(e.promotedAt)).length;
+				const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+				const promotedToday = entries.filter((e) => isoDay(e.promotedAt) === today).length;
+				const lastPromotedAt = entries.map((e) => e.promotedAt).filter((x) => typeof x === "string" && x.length > 0).sort().at(-1);
+				const lockStat = await fs.stat(lockPath).catch(() => null);
+				const lockAgeMs = lockStat && safeStatMs(lockStat.mtimeMs) ? Date.now() - Math.floor(lockStat.mtimeMs) : null;
+				return textResult([
+					"Dreaming status",
+					"",
+					`enabled: ${resolved.enabled ? "true" : "false"}`,
+					`deep.enabled: ${resolved.deep.enabled ? "true" : "false"}`,
+					`cron.frequency: ${resolved.frequency}`,
+					`cron.timezone: ${resolved.timezone ?? "(default)"}`,
+					`deep.minScore: ${resolved.deep.minScore}`,
+					`deep.minRecallCount: ${resolved.deep.minRecallCount}`,
+					`deep.limit: ${resolved.deep.limit}`,
+					"",
+					`storePath: ${SHORT_TERM_RECALL_STORE_RELATIVE}`,
+					`entryCount: ${total}`,
+					`promotedCount: ${promoted}`,
+					`promotedToday: ${promotedToday}`,
+					`lastPromotedAt: ${lastPromotedAt ?? "(none)"}`,
+					"",
+					`lockPath: ${SHORT_TERM_PROMOTION_LOCK_RELATIVE}`,
+					`lockPresent: ${lockStat ? "true" : "false"}`,
+					`lockAgeMs: ${lockAgeMs ?? "(n/a)"}`
+				].join("\n"));
+			}
+			if (action === "reset_store") {
+				const { store } = await loadDreamingStore({ workspaceDir });
+				const before = Object.keys(store.entries ?? {}).length;
+				const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+				store.entries = {};
+				store.updatedAt = nowIso;
+				await saveDreamingStore({
+					workspaceDir,
+					store
+				});
+				log.info({
+					workspaceDir,
+					before
+				}, "Dreaming store reset");
+				return textResult(`Reset short-term store. Removed ${before} entr${before === 1 ? "y" : "ies"}. Path: ${storePath}`);
+			}
+			await fs.unlink(lockPath).catch(() => {});
+			return textResult(`Cleared lock (if present). Path: ${lockPath}`);
+		}
+	};
+}
+//#endregion
+export { createDreamingTool };
+
+//# sourceMappingURL=dreaming-tool.js.map

package/dist/src/agent/tools/dreaming-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreaming-tool.js","names":[],"sources":["../../../../src/agent/tools/dreaming-tool.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\nimport {\n  SHORT_TERM_PROMOTION_LOCK_RELATIVE,\n  SHORT_TERM_RECALL_STORE_RELATIVE,\n} from '../memory/dreaming/constants.js';\nimport { loadDreamingStore, saveDreamingStore } from '../memory/dreaming/short-term-store.js';\n\nconst log = createLogger('DreamingTool');\n\nconst DreamingSchema = Type.Object({\n  action: Type.Union([Type.Literal('status'), Type.Literal('reset_store'), Type.Literal('clear_lock')]),\n});\n\ntype DreamingParams = {\n  action: 'status' | 'reset_store' | 'clear_lock';\n};\n\nexport interface DreamingToolDeps {\n  getWorkspace: () => string;\n  getConfig: () => Config | undefined;\n}\n\nfunction textResult(text: string): AgentToolResult<{}> {\n  return { content: [{ type: 'text', text }], details: {} };\n}\n\nfunction safeStatMs(ms: number | undefined): number | null {\n  if (typeof ms !== 'number' || !Number.isFinite(ms) || ms <= 0) return null;\n  return Math.floor(ms);\n}\n\nfunction isoDay(isoLike: string | undefined): string | null {\n  if (!isoLike) return null;\n  const m = isoLike.match(/^(\\d{4}-\\d{2}-\\d{2})/);\n  return m?.[1] ?? null;\n}\n\nexport function createDreamingTool(deps: DreamingToolDeps): AgentTool {\n  return {\n    name: 'dreaming',\n    label: '💤 Dreaming',\n    description:\n      'Inspect and maintain the dreaming promotion state.\\n\\n' +\n      'Actions:\\n' +\n      '- status: show config gates and short-term store stats\\n' +\n      '- reset_store: clear short-term recall store (memory/.dreams/short-term-recall.json)\\n' +\n      '- clear_lock: remove a stale promotion lock file (memory/.dreams/short-term-promotion.lock)',\n    parameters: DreamingSchema,\n    async execute(_toolCallId, params: any): Promise<AgentToolResult<{}>> {\n      const action = (params as DreamingParams).action;\n      const workspaceDir = deps.getWorkspace();\n      const cfg = deps.getConfig();\n      const resolved = resolveDreamingConfig(cfg);\n\n      const storePath = path.join(workspaceDir, SHORT_TERM_RECALL_STORE_RELATIVE);\n      const lockPath = path.join(workspaceDir, SHORT_TERM_PROMOTION_LOCK_RELATIVE);\n\n      if (action === 'status') {\n        const { store } = await loadDreamingStore({ workspaceDir });\n        const entries = Object.values(store.entries ?? {});\n        const total = entries.length;\n        const promoted = entries.filter((e) => Boolean(e.promotedAt)).length;\n        const today = new Date().toISOString().slice(0, 10);\n        const promotedToday = entries.filter((e) => isoDay(e.promotedAt) === today).length;\n        const lastPromotedAt = entries\n          .map((e) => e.promotedAt)\n          .filter((x): x is string => typeof x === 'string' && x.length > 0)\n          .sort()\n          .at(-1);\n\n        const lockStat = await fs.stat(lockPath).catch(() => null);\n        const lockAgeMs =\n          lockStat && safeStatMs(lockStat.mtimeMs) ? Date.now() - Math.floor(lockStat.mtimeMs) : null;\n\n        const lines = [\n          'Dreaming status',\n          '',\n          `enabled: ${resolved.enabled ? 'true' : 'false'}`,\n          `deep.enabled: ${resolved.deep.enabled ? 'true' : 'false'}`,\n          `cron.frequency: ${resolved.frequency}`,\n          `cron.timezone: ${resolved.timezone ?? '(default)'}`,\n          `deep.minScore: ${resolved.deep.minScore}`,\n          `deep.minRecallCount: ${resolved.deep.minRecallCount}`,\n          `deep.limit: ${resolved.deep.limit}`,\n          '',\n          `storePath: ${SHORT_TERM_RECALL_STORE_RELATIVE}`,\n          `entryCount: ${total}`,\n          `promotedCount: ${promoted}`,\n          `promotedToday: ${promotedToday}`,\n          `lastPromotedAt: ${lastPromotedAt ?? '(none)'}`,\n          '',\n          `lockPath: ${SHORT_TERM_PROMOTION_LOCK_RELATIVE}`,\n          `lockPresent: ${lockStat ? 'true' : 'false'}`,\n          `lockAgeMs: ${lockAgeMs ?? '(n/a)'}`,\n        ];\n        return textResult(lines.join('\\n'));\n      }\n\n      if (action === 'reset_store') {\n        const { store } = await loadDreamingStore({ workspaceDir });\n        const before = Object.keys(store.entries ?? {}).length;\n        const nowIso = new Date().toISOString();\n        store.entries = {};\n        store.updatedAt = nowIso;\n        await saveDreamingStore({ workspaceDir, store });\n        log.info({ workspaceDir, before }, 'Dreaming store reset');\n        return textResult(\n          `Reset short-term store. Removed ${before} entr${before === 1 ? 'y' : 'ies'}. Path: ${storePath}`,\n        );\n      }\n\n      await fs.unlink(lockPath).catch(() => {});\n      return textResult(`Cleared lock (if present). Path: ${lockPath}`);\n    },\n  } as any;\n}\n\n"],"mappings":";;;;;;;;;aAOqD;AAQrD,MAAM,MAAM,aAAa,eAAe;AAExC,MAAM,iBAAiB,KAAK,OAAO,EACjC,QAAQ,KAAK,MAAM;CAAC,KAAK,QAAQ,SAAS;CAAE,KAAK,QAAQ,cAAc;CAAE,KAAK,QAAQ,aAAa;CAAC,CAAC,EACtG,CAAC;AAWF,SAAS,WAAW,MAAmC;AACrD,QAAO;EAAE,SAAS,CAAC;GAAE,MAAM;GAAQ;GAAM,CAAC;EAAE,SAAS,EAAE;EAAE;;AAG3D,SAAS,WAAW,IAAuC;AACzD,KAAI,OAAO,OAAO,YAAY,CAAC,OAAO,SAAS,GAAG,IAAI,MAAM,EAAG,QAAO;AACtE,QAAO,KAAK,MAAM,GAAG;;AAGvB,SAAS,OAAO,SAA4C;AAC1D,KAAI,CAAC,QAAS,QAAO;AAErB,QADU,QAAQ,MAAM,uBAChB,GAAG,MAAM;;AAGnB,SAAgB,mBAAmB,MAAmC;AACpE,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EAKF,YAAY;EACZ,MAAM,QAAQ,aAAa,QAA2C;GACpE,MAAM,SAAU,OAA0B;GAC1C,MAAM,eAAe,KAAK,cAAc;GAExC,MAAM,WAAW,sBADL,KAAK,WACyB,CAAC;GAE3C,MAAM,YAAY,KAAK,KAAK,cAAc,iCAAiC;GAC3E,MAAM,WAAW,KAAK,KAAK,cAAc,mCAAmC;AAE5E,OAAI,WAAW,UAAU;IACvB,MAAM,EAAE,UAAU,MAAM,kBAAkB,EAAE,cAAc,CAAC;IAC3D,MAAM,UAAU,OAAO,OAAO,MAAM,WAAW,EAAE,CAAC;IAClD,MAAM,QAAQ,QAAQ;IACtB,MAAM,WAAW,QAAQ,QAAQ,MAAM,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,yBAAQ,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,GAAG,GAAG;IACnD,MAAM,gBAAgB,QAAQ,QAAQ,MAAM,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC;IAC5E,MAAM,iBAAiB,QACpB,KAAK,MAAM,EAAE,WAAW,CACxB,QAAQ,MAAmB,OAAO,MAAM,YAAY,EAAE,SAAS,EAAE,CACjE,MAAM,CACN,GAAG,GAAG;IAET,MAAM,WAAW,MAAM,GAAG,KAAK,SAAS,CAAC,YAAY,KAAK;IAC1D,MAAM,YACJ,YAAY,WAAW,SAAS,QAAQ,GAAG,KAAK,KAAK,GAAG,KAAK,MAAM,SAAS,QAAQ,GAAG;AAuBzF,WAAO,WAAW;KApBhB;KACA;KACA,YAAY,SAAS,UAAU,SAAS;KACxC,iBAAiB,SAAS,KAAK,UAAU,SAAS;KAClD,mBAAmB,SAAS;KAC5B,kBAAkB,SAAS,YAAY;KACvC,kBAAkB,SAAS,KAAK;KAChC,wBAAwB,SAAS,KAAK;KACtC,eAAe,SAAS,KAAK;KAC7B;KACA,cAAc;KACd,eAAe;KACf,kBAAkB;KAClB,kBAAkB;KAClB,mBAAmB,kBAAkB;KACrC;KACA,aAAa;KACb,gBAAgB,WAAW,SAAS;KACpC,cAAc,aAAa;KAEN,CAAC,KAAK,KAAK,CAAC;;AAGrC,OAAI,WAAW,eAAe;IAC5B,MAAM,EAAE,UAAU,MAAM,kBAAkB,EAAE,cAAc,CAAC;IAC3D,MAAM,SAAS,OAAO,KAAK,MAAM,WAAW,EAAE,CAAC,CAAC;IAChD,MAAM,0BAAS,IAAI,MAAM,EAAC,aAAa;AACvC,UAAM,UAAU,EAAE;AAClB,UAAM,YAAY;AAClB,UAAM,kBAAkB;KAAE;KAAc;KAAO,CAAC;AAChD,QAAI,KAAK;KAAE;KAAc;KAAQ,EAAE,uBAAuB;AAC1D,WAAO,WACL,mCAAmC,OAAO,OAAO,WAAW,IAAI,MAAM,MAAM,UAAU,YACvF;;AAGH,SAAM,GAAG,OAAO,SAAS,CAAC,YAAY,GAAG;AACzC,UAAO,WAAW,oCAAoC,WAAW;;EAEpE"}

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

@@ -18,6 +18,7 @@ import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createTodoTool } from "./todo-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
+import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
 import { BrowserManager } from "./browser/manager.js";
 import { createImageTool } from "./image-tool.js";
@@ -96,6 +97,10 @@ var AgentToolsFactory = class {
 		const find = createFindTool(workspace);
 		return filterToolsByDisabledSet([
 			createSessionStatusTool(),
+			createDreamingTool({
+				getWorkspace: () => workspace,
+				getConfig: () => this.deps.getConfig?.()
+			}),
 			createClarifyTool({ resolveAskUser: () => {
 				const req = this.deps.gatewayClarify?.requestClarification;
 				if (!req) return null;

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 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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"}
+{"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  createDreamingTool,\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      createDreamingTool({\n        getWorkspace: () => workspace,\n        getConfig: () => this.deps.getConfig?.(),\n      }),\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

@@ -15,6 +15,7 @@ export { createMessageTool } from './communication.js';
 export { createSendMediaTool } from './send-media.js';
 export { createTodoTool, TodoStore, type TodoItem, type TodoStatus } from './todo-tool.js';
 export { createSessionStatusTool } from './session-status-tool.js';
+export { createDreamingTool, type DreamingToolDeps } from './dreaming-tool.js';
 export { createClarifyTool, type ClarifyRequestPayload, type GatewayClarifyRequestFn, } from './clarify-tool.js';
 export { createBrowserTools, BrowserManager, assertBrowserUrlAllowed, } from './browser/index.js';
 export { createDelegateTool, DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, } from './delegate-tool.js';

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

@@ -17,6 +17,7 @@ import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
 import { TodoStore, createTodoTool } from "./todo-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
+import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
 import { BrowserManager } from "./browser/manager.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
@@ -30,4 +31,4 @@ import { createCronjobTool, scanCronPrompt } from "./cronjob-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, assertBrowserUrlAllowed, buildSandboxToolMap, createBrowserTools, createClarifyTool, createCronjobTool, createCuratedMemoryTool, createDelegateTool, createEditFileTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createShellTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createWebExtractTool, createWebSearchTool, createWriteFileTool, editFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, grepTool, invalidateSessionSearchIndexCache, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, restoreLineEndings, scanCronPrompt, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, webFetchTool, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, assertBrowserUrlAllowed, buildSandboxToolMap, createBrowserTools, createClarifyTool, createCronjobTool, createCuratedMemoryTool, createDelegateTool, createDreamingTool, createEditFileTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createShellTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createWebExtractTool, createWebSearchTool, createWriteFileTool, editFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, grepTool, invalidateSessionSearchIndexCache, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, restoreLineEndings, scanCronPrompt, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, webFetchTool, writeFileTool };

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

@@ -1,4 +1,5 @@
 import { memoryGet, memorySearch } from "../prompt/memory/index.js";
+import { recordDreamingRecalls } from "../memory/dreaming/short-term-store.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/memory-tool.ts
 const MemorySearchSchema = Type.Object({
@@ -16,11 +17,17 @@ function createMemorySearchTool(options) {
 		async execute(_toolCallId, params, _signal) {
 			const { query, maxResults, minScore } = params;
 			try {
-				const withCitations = (await memorySearch(workspaceDir, query, {
+				const results = await memorySearch(workspaceDir, query, {
 					maxResults,
 					minScore,
 					memoriesDir
-				})).map((entry) => ({
+				});
+				recordDreamingRecalls({
+					workspaceDir,
+					query,
+					matches: results
+				}).catch(() => {});
+				const withCitations = results.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]}` : ""}`

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

@@ -1 +1 @@
-{"version":3,"file":"memory-tool.js","names":[],"sources":["../../../../src/agent/tools/memory-tool.ts"],"sourcesContent":["// Memory search tools for xopc agent\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport { memorySearch, memoryGet } from '../prompt/memory/index.js';\n\n// =============================================================================\n// Memory Search Tool\n// =============================================================================\nconst MemorySearchSchema = Type.Object({\n  query: Type.String(),\n  maxResults: Type.Optional(Type.Number()),\n  minScore: Type.Optional(Type.Number()),\n});\n\ntype MemorySearchParams = { query: string; maxResults?: number; minScore?: number };\n\nexport interface MemoryToolOptions {\n  workspaceDir: string;\n  /** Agent home curated memories dir, e.g. ~/.xopc/agents/<id>/memories/ */\n  memoriesDir?: string;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, memoriesDir } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      '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.',\n    parameters: MemorySearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { query, maxResults, minScore } = params as MemorySearchParams;\n\n      try {\n        const results = await memorySearch(workspaceDir, query, { maxResults, minScore, memoriesDir });\n        const withCitations = results.map((entry) => ({\n          ...entry,\n          citation: `${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,\n          snippet: `${entry.lines.trim()}\\n\\nSource: ${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'simple' }, null, 2) }],\n          details: { results: withCitations },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n\n// =============================================================================\n// Memory Get Tool\n// =============================================================================\nconst MemoryGetSchema = Type.Object({\n  path: Type.String(),\n  from: Type.Optional(Type.Number()),\n  lines: Type.Optional(Type.Number()),\n});\n\ntype MemoryGetParams = { path: string; from?: number; lines?: number };\n\nexport function createMemoryGetTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, memoriesDir } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from MEMORY.md or memory/*.md with optional from/lines; use after memory_search to pull only the needed lines and keep context small.',\n    parameters: MemoryGetSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { path, from, lines } = params as MemoryGetParams;\n\n      try {\n        const result = memoryGet(workspaceDir, path, from, lines, memoriesDir);\n        if (!result) {\n          return {\n            content: [{ type: 'text', text: `File not found: ${path}` }],\n            details: { path, text: '' },\n          };\n        }\n        return {\n          content: [{ type: 'text', text: result.content }],\n          details: { path, text: result.content, lineNumbers: result.lineNumbers },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Read error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":";;;AAQA,MAAM,qBAAqB,KAAK,OAAO;CACrC,OAAO,KAAK,QAAQ;CACpB,YAAY,KAAK,SAAS,KAAK,QAAQ,CAAC;CACxC,UAAU,KAAK,SAAS,KAAK,QAAQ,CAAC;CACvC,CAAC;AAUF,SAAgB,uBAAuB,SAAuC;CAC5E,MAAM,EAAE,cAAc,gBAAgB;AACtC,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;GAC9B,MAAM,EAAE,OAAO,YAAY,aAAa;AAExC,OAAI;IAEF,MAAM,iBAAgB,MADA,aAAa,cAAc,OAAO;KAAE;KAAY;KAAU;KAAa,CAAC,EAChE,KAAK,WAAW;KAC5C,GAAG;KACH,UAAU,GAAG,MAAM,KAAK,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,SAAS,IAAI,KAAK,MAAM,YAAY,MAAM,YAAY,SAAS,OAAO;KAC3I,SAAS,GAAG,MAAM,MAAM,MAAM,CAAC,cAAc,MAAM,KAAK,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,SAAS,IAAI,KAAK,MAAM,YAAY,MAAM,YAAY,SAAS,OAAO;KAC5K,EAAE;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,KAAK,UAAU;OAAE,SAAS;OAAe,UAAU;OAAU,EAAE,MAAM,EAAE;MAAE,CAAC;KAC1G,SAAS,EAAE,SAAS,eAAe;KACpC;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,iBAAiB;MAAW,CAAC;KAC7D,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN;;AAMH,MAAM,kBAAkB,KAAK,OAAO;CAClC,MAAM,KAAK,QAAQ;CACnB,MAAM,KAAK,SAAS,KAAK,QAAQ,CAAC;CAClC,OAAO,KAAK,SAAS,KAAK,QAAQ,CAAC;CACpC,CAAC;AAIF,SAAgB,oBAAoB,SAAuC;CACzE,MAAM,EAAE,cAAc,gBAAgB;AACtC,QAAO;EACL,MAAM;EACN,OAAO;EACP,aAAa;EACb,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;GAC9B,MAAM,EAAE,MAAM,MAAM,UAAU;AAE9B,OAAI;IACF,MAAM,SAAS,UAAU,cAAc,MAAM,MAAM,OAAO,YAAY;AACtE,QAAI,CAAC,OACH,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,mBAAmB;MAAQ,CAAC;KAC5D,SAAS;MAAE;MAAM,MAAM;MAAI;KAC5B;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,OAAO;MAAS,CAAC;KACjD,SAAS;MAAE;MAAM,MAAM,OAAO;MAAS,aAAa,OAAO;MAAa;KACzE;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,eAAe;MAAW,CAAC;KAC3D,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN"}
+{"version":3,"file":"memory-tool.js","names":[],"sources":["../../../../src/agent/tools/memory-tool.ts"],"sourcesContent":["// Memory search tools for xopc agent\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport { memorySearch, memoryGet } from '../prompt/memory/index.js';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\n\n// =============================================================================\n// Memory Search Tool\n// =============================================================================\nconst MemorySearchSchema = Type.Object({\n  query: Type.String(),\n  maxResults: Type.Optional(Type.Number()),\n  minScore: Type.Optional(Type.Number()),\n});\n\ntype MemorySearchParams = { query: string; maxResults?: number; minScore?: number };\n\nexport interface MemoryToolOptions {\n  workspaceDir: string;\n  /** Agent home curated memories dir, e.g. ~/.xopc/agents/<id>/memories/ */\n  memoriesDir?: string;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, memoriesDir } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      '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.',\n    parameters: MemorySearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { query, maxResults, minScore } = params as MemorySearchParams;\n\n      try {\n        const results = await memorySearch(workspaceDir, query, { maxResults, minScore, memoriesDir });\n        // Dreaming: record short-term recall evidence from memory_search.\n        // Only records workspace daily notes (`memory/YYYY-MM-DD.md`) and ignores curated/long-term files.\n        void recordDreamingRecalls({ workspaceDir, query, matches: results }).catch(() => {});\n        const withCitations = results.map((entry) => ({\n          ...entry,\n          citation: `${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,\n          snippet: `${entry.lines.trim()}\\n\\nSource: ${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'simple' }, null, 2) }],\n          details: { results: withCitations },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n\n// =============================================================================\n// Memory Get Tool\n// =============================================================================\nconst MemoryGetSchema = Type.Object({\n  path: Type.String(),\n  from: Type.Optional(Type.Number()),\n  lines: Type.Optional(Type.Number()),\n});\n\ntype MemoryGetParams = { path: string; from?: number; lines?: number };\n\nexport function createMemoryGetTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, memoriesDir } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from MEMORY.md or memory/*.md with optional from/lines; use after memory_search to pull only the needed lines and keep context small.',\n    parameters: MemoryGetSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { path, from, lines } = params as MemoryGetParams;\n\n      try {\n        const result = memoryGet(workspaceDir, path, from, lines, memoriesDir);\n        if (!result) {\n          return {\n            content: [{ type: 'text', text: `File not found: ${path}` }],\n            details: { path, text: '' },\n          };\n        }\n        return {\n          content: [{ type: 'text', text: result.content }],\n          details: { path, text: result.content, lineNumbers: result.lineNumbers },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Read error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":";;;;AASA,MAAM,qBAAqB,KAAK,OAAO;CACrC,OAAO,KAAK,QAAQ;CACpB,YAAY,KAAK,SAAS,KAAK,QAAQ,CAAC;CACxC,UAAU,KAAK,SAAS,KAAK,QAAQ,CAAC;CACvC,CAAC;AAUF,SAAgB,uBAAuB,SAAuC;CAC5E,MAAM,EAAE,cAAc,gBAAgB;AACtC,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;GAC9B,MAAM,EAAE,OAAO,YAAY,aAAa;AAExC,OAAI;IACF,MAAM,UAAU,MAAM,aAAa,cAAc,OAAO;KAAE;KAAY;KAAU;KAAa,CAAC;AAGzF,0BAAsB;KAAE;KAAc;KAAO,SAAS;KAAS,CAAC,CAAC,YAAY,GAAG;IACrF,MAAM,gBAAgB,QAAQ,KAAK,WAAW;KAC5C,GAAG;KACH,UAAU,GAAG,MAAM,KAAK,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,SAAS,IAAI,KAAK,MAAM,YAAY,MAAM,YAAY,SAAS,OAAO;KAC3I,SAAS,GAAG,MAAM,MAAM,MAAM,CAAC,cAAc,MAAM,KAAK,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,SAAS,IAAI,KAAK,MAAM,YAAY,MAAM,YAAY,SAAS,OAAO;KAC5K,EAAE;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,KAAK,UAAU;OAAE,SAAS;OAAe,UAAU;OAAU,EAAE,MAAM,EAAE;MAAE,CAAC;KAC1G,SAAS,EAAE,SAAS,eAAe;KACpC;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,iBAAiB;MAAW,CAAC;KAC7D,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN;;AAMH,MAAM,kBAAkB,KAAK,OAAO;CAClC,MAAM,KAAK,QAAQ;CACnB,MAAM,KAAK,SAAS,KAAK,QAAQ,CAAC;CAClC,OAAO,KAAK,SAAS,KAAK,QAAQ,CAAC;CACpC,CAAC;AAIF,SAAgB,oBAAoB,SAAuC;CACzE,MAAM,EAAE,cAAc,gBAAgB;AACtC,QAAO;EACL,MAAM;EACN,OAAO;EACP,aAAa;EACb,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;GAC9B,MAAM,EAAE,MAAM,MAAM,UAAU;AAE9B,OAAI;IACF,MAAM,SAAS,UAAU,cAAc,MAAM,MAAM,OAAO,YAAY;AACtE,QAAI,CAAC,OACH,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,mBAAmB;MAAQ,CAAC;KAC5D,SAAS;MAAE;MAAM,MAAM;MAAI;KAC5B;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,OAAO;MAAS,CAAC;KACjD,SAAS;MAAE;MAAM,MAAM,OAAO;MAAS,aAAa,OAAO;MAAa;KACzE;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,eAAe;MAAW,CAAC;KAC3D,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN"}

package/dist/src/config/schema.d.ts

@@ -79,6 +79,37 @@ export declare const AgentDefaultsSchema: z.ZodObject<{
         }>>;
         contextCadence: z.ZodOptional<z.ZodNumber>;
         dialecticCadence: z.ZodOptional<z.ZodNumber>;
+        dreaming: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            frequency: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodString>;
+            phases: z.ZodOptional<z.ZodObject<{
+                light: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    cron: z.ZodOptional<z.ZodString>;
+                    lookbackDays: z.ZodOptional<z.ZodNumber>;
+                    limit: z.ZodOptional<z.ZodNumber>;
+                    dedupeSimilarity: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                deep: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    cron: z.ZodOptional<z.ZodString>;
+                    minScore: z.ZodOptional<z.ZodNumber>;
+                    minRecallCount: z.ZodOptional<z.ZodNumber>;
+                    minUniqueQueries: z.ZodOptional<z.ZodNumber>;
+                    limit: z.ZodOptional<z.ZodNumber>;
+                    recencyHalfLifeDays: z.ZodOptional<z.ZodNumber>;
+                    maxAgeDays: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                rem: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    cron: z.ZodOptional<z.ZodString>;
+                    lookbackDays: z.ZodOptional<z.ZodNumber>;
+                    limit: z.ZodOptional<z.ZodNumber>;
+                    minPatternStrength: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     sessionSearch: z.ZodOptional<z.ZodObject<{
         summaryModel: z.ZodOptional<z.ZodString>;
@@ -227,6 +258,37 @@ export declare const AgentsConfigSchema: z.ZodDefault<z.ZodObject<{
             }>>;
             contextCadence: z.ZodOptional<z.ZodNumber>;
             dialecticCadence: z.ZodOptional<z.ZodNumber>;
+            dreaming: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                frequency: z.ZodOptional<z.ZodString>;
+                timezone: z.ZodOptional<z.ZodString>;
+                phases: z.ZodOptional<z.ZodObject<{
+                    light: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodOptional<z.ZodBoolean>;
+                        cron: z.ZodOptional<z.ZodString>;
+                        lookbackDays: z.ZodOptional<z.ZodNumber>;
+                        limit: z.ZodOptional<z.ZodNumber>;
+                        dedupeSimilarity: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    deep: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodOptional<z.ZodBoolean>;
+                        cron: z.ZodOptional<z.ZodString>;
+                        minScore: z.ZodOptional<z.ZodNumber>;
+                        minRecallCount: z.ZodOptional<z.ZodNumber>;
+                        minUniqueQueries: z.ZodOptional<z.ZodNumber>;
+                        limit: z.ZodOptional<z.ZodNumber>;
+                        recencyHalfLifeDays: z.ZodOptional<z.ZodNumber>;
+                        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                    rem: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodOptional<z.ZodBoolean>;
+                        cron: z.ZodOptional<z.ZodString>;
+                        lookbackDays: z.ZodOptional<z.ZodNumber>;
+                        limit: z.ZodOptional<z.ZodNumber>;
+                        minPatternStrength: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         sessionSearch: z.ZodOptional<z.ZodObject<{
             summaryModel: z.ZodOptional<z.ZodString>;
@@ -771,6 +833,37 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                 }>>;
                 contextCadence: z.ZodOptional<z.ZodNumber>;
                 dialecticCadence: z.ZodOptional<z.ZodNumber>;
+                dreaming: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    frequency: z.ZodOptional<z.ZodString>;
+                    timezone: z.ZodOptional<z.ZodString>;
+                    phases: z.ZodOptional<z.ZodObject<{
+                        light: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodOptional<z.ZodBoolean>;
+                            cron: z.ZodOptional<z.ZodString>;
+                            lookbackDays: z.ZodOptional<z.ZodNumber>;
+                            limit: z.ZodOptional<z.ZodNumber>;
+                            dedupeSimilarity: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>;
+                        deep: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodOptional<z.ZodBoolean>;
+                            cron: z.ZodOptional<z.ZodString>;
+                            minScore: z.ZodOptional<z.ZodNumber>;
+                            minRecallCount: z.ZodOptional<z.ZodNumber>;
+                            minUniqueQueries: z.ZodOptional<z.ZodNumber>;
+                            limit: z.ZodOptional<z.ZodNumber>;
+                            recencyHalfLifeDays: z.ZodOptional<z.ZodNumber>;
+                            maxAgeDays: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>;
+                        rem: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodOptional<z.ZodBoolean>;
+                            cron: z.ZodOptional<z.ZodString>;
+                            lookbackDays: z.ZodOptional<z.ZodNumber>;
+                            limit: z.ZodOptional<z.ZodNumber>;
+                            minPatternStrength: z.ZodOptional<z.ZodNumber>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>;
             sessionSearch: z.ZodOptional<z.ZodObject<{
                 summaryModel: z.ZodOptional<z.ZodString>;

package/dist/src/config/schema.js

@@ -114,7 +114,48 @@ var init_schema = __esmMin((() => {
 			/** Inject prefetch on turns 1, 1+N, 1+2N, … (only when injectionFrequency is every-turn). Min 1. */
 			contextCadence: z.number().int().min(1).optional(),
 			/** Reserved for future external “dialectic” sync cadence (not wired yet). */
-			dialecticCadence: z.number().int().min(1).optional()
+			dialecticCadence: z.number().int().min(1).optional(),
+			/**
+			* Background memory consolidation ("dreaming"): three-phase sleep model that
+			* promotes short-term recall signals into long-term memory (`MEMORY.md`).
+			*
+			* Phases:
+			* - **light** — fast, frequent sweep (default every 6 h): dedup + signal collection.
+			* - **deep**  — daily deep promotion (default 3 AM): score-gated write to MEMORY.md.
+			* - **rem**   — weekly pattern discovery (default Sun 5 AM): cross-session insight mining.
+			*/
+			dreaming: z.object({
+				enabled: z.boolean().optional(),
+				/** Legacy top-level cron; prefer per-phase `cron` instead. */
+				frequency: z.string().optional(),
+				timezone: z.string().optional(),
+				phases: z.object({
+					light: z.object({
+						enabled: z.boolean().optional(),
+						cron: z.string().optional(),
+						lookbackDays: z.number().int().min(1).optional(),
+						limit: z.number().int().min(0).optional(),
+						dedupeSimilarity: z.number().min(0).max(1).optional()
+					}).optional(),
+					deep: z.object({
+						enabled: z.boolean().optional(),
+						cron: z.string().optional(),
+						minScore: z.number().min(0).max(1).optional(),
+						minRecallCount: z.number().int().min(1).optional(),
+						minUniqueQueries: z.number().int().min(1).optional(),
+						limit: z.number().int().min(0).optional(),
+						recencyHalfLifeDays: z.number().min(1).optional(),
+						maxAgeDays: z.number().int().min(1).optional()
+					}).optional(),
+					rem: z.object({
+						enabled: z.boolean().optional(),
+						cron: z.string().optional(),
+						lookbackDays: z.number().int().min(1).optional(),
+						limit: z.number().int().min(0).optional(),
+						minPatternStrength: z.number().min(0).max(1).optional()
+					}).optional()
+				}).optional()
+			}).optional()
 		}).optional(),
 		/** Cross-session transcript search (`session_search` tool). */
 		sessionSearch: z.object({