@xopcai/xopc 0.0.140 → 0.0.142

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

@@ -1 +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 '@earendil-works/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  getDreamingRoot: () => string;\n  getConfig: () => Config | undefined;\n  getAgentId?: () => string | 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 this agent short-term recall store (.dreams/short-term-recall.json)\\n' +\n      '- clear_lock: remove this agent stale promotion lock file (.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 dreamingRoot = deps.getDreamingRoot();\n      const cfg = deps.getConfig();\n      const agentId = deps.getAgentId?.();\n      const resolved = resolveDreamingConfig(cfg, agentId);\n\n      const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);\n      const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);\n\n      if (action === 'status') {\n        const { store } = await loadDreamingStore({ dreamingRoot });\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          `agentId: ${agentId ?? '(unknown)'}`,\n          `storePath: ${storePath}`,\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({ dreamingRoot });\n        const before = Object.keys(store.entries ?? {}).length;\n        const nowIso = new Date().toISOString();\n        store.entries = {};\n        store.updatedAt = nowIso;\n        await saveDreamingStore({ dreamingRoot, store });\n        log.info({ dreamingRoot, 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"],"mappings":"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"}
+{"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 '@earendil-works/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 {\n  clearStaleDreamingLock,\n  loadDreamingStore,\n  resetDreamingStore,\n} 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  getDreamingRoot: () => string;\n  getConfig: () => Config | undefined;\n  getAgentId?: () => string | 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 this agent short-term recall store (.dreams/short-term-recall.json)\\n' +\n      '- clear_lock: remove this agent stale promotion lock file (.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 dreamingRoot = deps.getDreamingRoot();\n      const cfg = deps.getConfig();\n      const agentId = deps.getAgentId?.();\n      const resolved = resolveDreamingConfig(cfg, agentId);\n\n      const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);\n      const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);\n\n      if (action === 'status') {\n        const { store } = await loadDreamingStore({ dreamingRoot });\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          `agentId: ${agentId ?? '(unknown)'}`,\n          `storePath: ${storePath}`,\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 before = await resetDreamingStore({ dreamingRoot });\n        log.info({ dreamingRoot, 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      const cleared = await clearStaleDreamingLock(dreamingRoot);\n      return textResult(`${cleared ? 'Cleared stale lock.' : 'No lock present.'} Path: ${lockPath}`);\n    },\n  } as any;\n}\n"],"mappings":";;;;;;;;;aAOqD;AAYrD,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;AAaF,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,iBAAiB;GAC3C,MAAM,MAAM,KAAK,WAAW;GAC5B,MAAM,UAAU,KAAK,cAAc;GACnC,MAAM,WAAW,sBAAsB,KAAK,QAAQ;GAEpD,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;AAwBzF,WAAO,WAAW;KArBhB;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,YAAY,WAAW;KACvB,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,SAAS,MAAM,mBAAmB,EAAE,cAAc,CAAC;AACzD,QAAI,KAAK;KAAE;KAAc;KAAQ,EAAE,uBAAuB;AAC1D,WAAO,WACL,mCAAmC,OAAO,OAAO,WAAW,IAAI,MAAM,MAAM,UAAU,YACvF;;AAIH,UAAO,WAAW,GAAG,MADC,uBAAuB,aAAa,GAC3B,wBAAwB,mBAAmB,SAAS,WAAW;;EAEjG"}

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

@@ -20,6 +20,7 @@ import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool
 import { createTodoTool } from "./todo-tool.js";
 import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
+import { resolveDreamingConfig } from "../memory/dreaming/config.js";
 import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
 import { BrowserManager } from "../../browser/manager.js";
@@ -253,11 +254,22 @@ var AgentToolsFactory = class {
 			...getMemMgr ? [createMemorySearchTool({
 				workspaceDir: workspace,
 				dreamingRoot,
-				getMemoryManager: () => getMemMgr()
+				getMemoryManager: () => getMemMgr(),
+				getScope: () => ({
+					...options?.agentId ? { agentId: options.agentId } : {},
+					workspaceId: workspace,
+					...this.deps.getCurrentContext?.()?.sessionKey ? { sessionKey: this.deps.getCurrentContext().sessionKey } : {}
+				}),
+				shouldRecordDreamingRecalls: () => resolveDreamingConfig(this.deps.getConfig?.(), options?.agentId).enabled
 			}), createMemoryGetTool({
 				workspaceDir: workspace,
 				dreamingRoot,
-				getMemoryManager: () => getMemMgr()
+				getMemoryManager: () => getMemMgr(),
+				getScope: () => ({
+					...options?.agentId ? { agentId: options.agentId } : {},
+					workspaceId: workspace,
+					...this.deps.getCurrentContext?.()?.sessionKey ? { sessionKey: this.deps.getCurrentContext().sessionKey } : {}
+				})
 			})] : [],
 			...getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.()) ? [createCuratedMemoryTool(() => getMemMgr())] : [],
 			...getMemMgr?.().getAdditionalTools() ?? [],

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

@@ -1 +1 @@
-{"version":3,"file":"factory.js","names":[],"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 '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { Page } from 'playwright-core';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createApplyPatchTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createExecCommandTool,\n  createWebSearchTool,\n  createWebFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createComposioExecuteTool,\n  createSendMediaTool,\n  createReadMediaTool,\n  createCreateShareTool,\n  isShareToolAvailable,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createUpdatePlanTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n  createToolManualTool,\n  createGoalTool,\n  createAutomationTool,\n  createXopcUseTool,\n  createDesktopPetTool,\n  createSkillInstallTool,\n  createCodeIntelligenceTools,\n  type SkillInstallToolOptions,\n  type SkillInstallToolResult,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport {\n  BrowserManager,\n  BrowserNotReadyError,\n  CdpSupervisor,\n  checkBrowserReadiness,\n  resolveBrowserBackendFromConfig,\n} from '../../browser/index.js';\nimport { createBrowserUseTool } from './browser/tool/browser-use-tool.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { createWorkflowTool } from './workflow-tool.js';\nimport { createWorkflowCatalog } from '../workflow/catalog.js';\nimport { resolveDreamingRootForAgent } from '../memory/dreaming/scope.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport type { AutomationService } from '../../automations/index.js';\nimport type { NotesService } from '../../notes/index.js';\nimport type { ProjectService } from '../../projects/index.js';\nimport type { WorkItemService } from '../../work-items/index.js';\nimport type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.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';\nimport { createGoalEvidenceRecorder } from './goal-evidence-recorder.js';\nimport { getAgentCapabilityToolNames } from '../capabilities/index.js';\nimport type { CodeIntelligenceRuntimeLike } from '../code-intelligence/index.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\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  /** 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 `automation` tool. */\n  getAutomationService?: () => AutomationService | undefined;\n  /** Gateway: enables the `xopc_use` product-object tool. */\n  getNotesService?: () => NotesService | undefined;\n  getProjectService?: () => ProjectService | undefined;\n  getWorkItemService?: () => WorkItemService | undefined;\n  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => WorkflowRunServiceLike | 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 command env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n  /** Install managed skills from explicit sources when a capability/tool enables it. */\n  installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;\n  /** Workspace-scoped structural code intelligence runtime. */\n  getCodeIntelligenceRuntime?: (workspace: string) => CodeIntelligenceRuntimeLike;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/command tools (defaults to factory workspace). */\n  workspace?: string;\n  /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */\n  profileMarkdownRoot?: string;\n  /** Tool `name` values to omit (e.g. `exec_command`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getMemoryManager?: () => MemoryManager;\n  /** Agent-scoped memories directory used for dreaming state (`agents/<id>/memories`). */\n  dreamingRoot?: string;\n  agentId?: string;\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  /** One dialog/console supervisor per chat session (browser tab). */\n  private readonly browserTaskSupervisors = new Map<string, CdpSupervisor>();\n  /** Cached readiness probe — keyed by backend mode + extension host:port. */\n  private browserReadinessCache: {\n    key: string;\n    expiresAt: number;\n    inflight?: Promise<BrowserNotReadyError | null>;\n    result?: BrowserNotReadyError | null;\n  } | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private browserReadinessKey(): string {\n    const cfg = this.deps.getConfig?.();\n    const backend = resolveBrowserBackendFromConfig(cfg);\n    const host = '127.0.0.1';\n    const port = 19820;\n    const cdpUrl = backend.mode === 'cdp' ? backend.config.wsEndpoint : '';\n    const cloudKind = backend.mode === 'cloud' ? backend.config.type : '';\n    return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;\n  }\n\n  private async checkBrowserReadinessCached(): Promise<BrowserNotReadyError | null> {\n    const key = this.browserReadinessKey();\n    const now = Date.now();\n    const cached = this.browserReadinessCache;\n    if (cached && cached.key === key && cached.expiresAt > now && cached.inflight === undefined) {\n      return cached.result ?? null;\n    }\n    if (cached && cached.key === key && cached.inflight) {\n      return cached.inflight;\n    }\n    const inflight = checkBrowserReadiness(this.deps.getConfig?.());\n    this.browserReadinessCache = { key, expiresAt: now + 30_000, inflight };\n    try {\n      const result = await inflight;\n      this.browserReadinessCache = { key, expiresAt: Date.now() + 30_000, result };\n      return result;\n    } catch (e) {\n      // Probe should never throw, but if it does we just bypass the cache.\n      this.browserReadinessCache = null;\n      log.warn({ err: e }, 'browserReadiness probe failed');\n      return null;\n    }\n  }\n\n  /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */\n  invalidateBrowserReadinessCache(): void {\n    this.browserReadinessCache = null;\n  }\n\n  private browserSupervisorForTask(taskId: string): CdpSupervisor {\n    let s = this.browserTaskSupervisors.get(taskId);\n    if (!s) {\n      s = new CdpSupervisor({ dialogPolicy: 'auto_dismiss', dialogTimeoutSeconds: 300 });\n      this.browserTaskSupervisors.set(taskId, s);\n    }\n    return s;\n  }\n\n  private async acquireBrowserPage(): Promise<Page> {\n    const taskId = this.deps.getCurrentContext()?.sessionKey ?? 'default';\n    const mgr = this.ensureBrowserManager();\n    await mgr.ensureConnected();\n    if (mgr.getExtensionProvider()) {\n      return null as unknown as Page;\n    }\n    const page = await mgr.getPage(taskId);\n    this.browserSupervisorForTask(taskId).attach(page);\n    return page;\n  }\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => false,\n        getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.()),\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    this.browserReadinessCache = null;\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n    this.browserTaskSupervisors.clear();\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    this.browserTaskSupervisors.delete(sessionKey);\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 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 dreamingRoot = options?.dreamingRoot ?? (cfg ? resolveDreamingRootForAgent(cfg, options?.agentId) : workspace);\n    const browserEnabled = cfg?.browser?.enabled !== false;\n    const recordGoalEvidence = createGoalEvidenceRecorder({\n      getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n    });\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n      agentId: options?.agentId,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n    const codeIntelligenceConfig = cfg?.codeIntelligence;\n    const agentId = options?.agentId;\n    const codeIntelligenceEnabled =\n      codeIntelligenceConfig?.enabled === true &&\n      agentId !== undefined &&\n      codeIntelligenceConfig.agentIds.includes(agentId);\n    const codeIntelligenceTools = codeIntelligenceEnabled && this.deps.getCodeIntelligenceRuntime\n      ? createCodeIntelligenceTools({\n          getRuntime: () => this.deps.getCodeIntelligenceRuntime!(workspace),\n        })\n      : [];\n\n    const composioTool = createComposioExecuteTool(() => this.deps.getConfig?.());\n    const optionalTools = [imageTool, imageGenerateTool, composioTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n      recordGoalEvidence,\n    });\n    const applyPatchTool = createApplyPatchTool(workspace, { recordGoalEvidence });\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        getDreamingRoot: () => dreamingRoot,\n        getConfig: () => this.deps.getConfig?.(),\n        getAgentId: () => options?.agentId,\n      }),\n      createToolManualTool(),\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          if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      createUpdatePlanTool(),\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      ...codeIntelligenceTools,\n      writeTool,\n      applyPatchTool,\n      listDir,\n      grep,\n      find,\n      createExecCommandTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n        recordGoalEvidence,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      createWebFetchTool(() => this.deps.getConfig?.()),\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?.messages?.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      createReadMediaTool(),\n      ...(isShareToolAvailable(cfg)\n        ? [\n            createCreateShareTool({\n              workspace,\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      ...(getMemMgr\n        ? [\n            createMemorySearchTool({ workspaceDir: workspace, dreamingRoot, getMemoryManager: () => getMemMgr() }),\n            createMemoryGetTool({ workspaceDir: workspace, dreamingRoot, getMemoryManager: () => getMemMgr() }),\n          ]\n        : []),\n      ...(getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(() => getMemMgr()),\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.getAutomationService\n        ? [\n            createAutomationTool({\n              getAutomationService: this.deps.getAutomationService,\n            }),\n          ]\n        : []),\n      ...(this.deps.getProjectService || this.deps.getNotesService || this.deps.getWorkItemService\n        ? [\n            createXopcUseTool({\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentAgentId: () => options.agentId,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getNotesService: this.deps.getNotesService,\n              getProjectService: this.deps.getProjectService,\n              getWorkItemService: this.deps.getWorkItemService,\n            }),\n          ]\n        : []),\n      createGoalTool({\n        getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(browserEnabled\n        ? [\n            createBrowserUseTool({\n              getManager: () => this.ensureBrowserManager(),\n              getPageForTask: () => this.acquireBrowserPage(),\n              getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n              getConfig: () => this.deps.getConfig?.(),\n              getReadiness: () => this.checkBrowserReadinessCached(),\n              getSupervisor: () =>\n                this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? 'default'),\n              notifyBrowserPageClosed: (taskId) => {\n                this.browserTaskSupervisors.delete(taskId);\n              },\n            }),\n          ]\n        : []),\n      ...(primary\n        ? [\n            createWorkflowTool({\n              catalog: createWorkflowCatalog(),\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getConfig: () => this.deps.getConfig?.(),\n              startWorkflowRun: this.deps.getWorkflowRunService\n                ? (params) => this.deps.getWorkflowRunService!().startWorkflowRun(params)\n                : undefined,\n            }),\n          ]\n        : []),\n      ...(false && 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              // Injected so `child-agent-factory.ts` does not need to import\n              // `AgentToolsFactory` directly (which would form a cycle).\n              buildChildTools: (childOpts) => {\n                const childFactory = new AgentToolsFactory({\n                  workspace: childOpts.workspace,\n                  bus: childOpts.bus,\n                  getCurrentContext: () => null,\n                  getConfig: childOpts.getConfig,\n                  getPrimaryModel: () => childOpts.model,\n                  toolExecutorConfig: childOpts.toolExecutorConfig,\n                });\n                return childFactory.createAllTools({\n                  workspace: childOpts.workspace,\n                  getPrimaryModel: () => childOpts.model,\n                  agentId: options?.agentId ?? childOpts.agentId,\n                  dreamingRoot: options?.dreamingRoot,\n                  disabledTools: new Set(['extensions']),\n                });\n              },\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createCapabilityTools(\n    capabilityNames: readonly string[],\n    options?: Pick<CreateCoreToolsOptions, 'disabledTools'>,\n  ): AgentTool<any, any>[] {\n    const disabled = options?.disabledTools;\n    const raw: AgentTool<any, any>[] = [];\n    const toolNames = new Set<string>();\n    for (const toolName of getAgentCapabilityToolNames(capabilityNames)) {\n      if (disabled?.has(toolName) || toolNames.has(toolName)) continue;\n      toolNames.add(toolName);\n      if (toolName === 'create_desktop_pet') raw.push(createDesktopPetTool() as AgentTool<any, any>);\n      if (toolName === 'skill_install') {\n        raw.push(createSkillInstallTool({\n          installSkillFromSource: this.deps.installSkillFromSource,\n          getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n        }) as AgentTool<any, any>);\n      }\n    }\n    return wrapToolsWithProtection(raw, this.deps.toolExecutorConfig);\n  }\n\n  getLazyCapabilityToolNames(): string[] {\n    return [\n      'create_desktop_pet',\n      ...(this.deps.installSkillFromSource ? ['skill_install'] : []),\n    ];\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\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 = false && !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":[],"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 '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { Page } from 'playwright-core';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createApplyPatchTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createExecCommandTool,\n  createWebSearchTool,\n  createWebFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createComposioExecuteTool,\n  createSendMediaTool,\n  createReadMediaTool,\n  createCreateShareTool,\n  isShareToolAvailable,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createUpdatePlanTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n  createToolManualTool,\n  createGoalTool,\n  createAutomationTool,\n  createXopcUseTool,\n  createDesktopPetTool,\n  createSkillInstallTool,\n  createCodeIntelligenceTools,\n  type SkillInstallToolOptions,\n  type SkillInstallToolResult,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport {\n  BrowserManager,\n  BrowserNotReadyError,\n  CdpSupervisor,\n  checkBrowserReadiness,\n  resolveBrowserBackendFromConfig,\n} from '../../browser/index.js';\nimport { createBrowserUseTool } from './browser/tool/browser-use-tool.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { createWorkflowTool } from './workflow-tool.js';\nimport { createWorkflowCatalog } from '../workflow/catalog.js';\nimport { resolveDreamingRootForAgent } from '../memory/dreaming/scope.js';\nimport { resolveDreamingConfig } from '../memory/dreaming/config.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport type { AutomationService } from '../../automations/index.js';\nimport type { NotesService } from '../../notes/index.js';\nimport type { ProjectService } from '../../projects/index.js';\nimport type { WorkItemService } from '../../work-items/index.js';\nimport type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.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';\nimport { createGoalEvidenceRecorder } from './goal-evidence-recorder.js';\nimport { getAgentCapabilityToolNames } from '../capabilities/index.js';\nimport type { CodeIntelligenceRuntimeLike } from '../code-intelligence/index.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\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  /** 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 `automation` tool. */\n  getAutomationService?: () => AutomationService | undefined;\n  /** Gateway: enables the `xopc_use` product-object tool. */\n  getNotesService?: () => NotesService | undefined;\n  getProjectService?: () => ProjectService | undefined;\n  getWorkItemService?: () => WorkItemService | undefined;\n  /** Gateway: starts persisted workflow runs (dedicated chat session per run). */\n  getWorkflowRunService?: () => WorkflowRunServiceLike | 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 command env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n  /** Install managed skills from explicit sources when a capability/tool enables it. */\n  installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;\n  /** Workspace-scoped structural code intelligence runtime. */\n  getCodeIntelligenceRuntime?: (workspace: string) => CodeIntelligenceRuntimeLike;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/command tools (defaults to factory workspace). */\n  workspace?: string;\n  /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */\n  profileMarkdownRoot?: string;\n  /** Tool `name` values to omit (e.g. `exec_command`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getMemoryManager?: () => MemoryManager;\n  /** Agent-scoped memories directory used for dreaming state (`agents/<id>/memories`). */\n  dreamingRoot?: string;\n  agentId?: string;\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  /** One dialog/console supervisor per chat session (browser tab). */\n  private readonly browserTaskSupervisors = new Map<string, CdpSupervisor>();\n  /** Cached readiness probe — keyed by backend mode + extension host:port. */\n  private browserReadinessCache: {\n    key: string;\n    expiresAt: number;\n    inflight?: Promise<BrowserNotReadyError | null>;\n    result?: BrowserNotReadyError | null;\n  } | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private browserReadinessKey(): string {\n    const cfg = this.deps.getConfig?.();\n    const backend = resolveBrowserBackendFromConfig(cfg);\n    const host = '127.0.0.1';\n    const port = 19820;\n    const cdpUrl = backend.mode === 'cdp' ? backend.config.wsEndpoint : '';\n    const cloudKind = backend.mode === 'cloud' ? backend.config.type : '';\n    return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;\n  }\n\n  private async checkBrowserReadinessCached(): Promise<BrowserNotReadyError | null> {\n    const key = this.browserReadinessKey();\n    const now = Date.now();\n    const cached = this.browserReadinessCache;\n    if (cached && cached.key === key && cached.expiresAt > now && cached.inflight === undefined) {\n      return cached.result ?? null;\n    }\n    if (cached && cached.key === key && cached.inflight) {\n      return cached.inflight;\n    }\n    const inflight = checkBrowserReadiness(this.deps.getConfig?.());\n    this.browserReadinessCache = { key, expiresAt: now + 30_000, inflight };\n    try {\n      const result = await inflight;\n      this.browserReadinessCache = { key, expiresAt: Date.now() + 30_000, result };\n      return result;\n    } catch (e) {\n      // Probe should never throw, but if it does we just bypass the cache.\n      this.browserReadinessCache = null;\n      log.warn({ err: e }, 'browserReadiness probe failed');\n      return null;\n    }\n  }\n\n  /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */\n  invalidateBrowserReadinessCache(): void {\n    this.browserReadinessCache = null;\n  }\n\n  private browserSupervisorForTask(taskId: string): CdpSupervisor {\n    let s = this.browserTaskSupervisors.get(taskId);\n    if (!s) {\n      s = new CdpSupervisor({ dialogPolicy: 'auto_dismiss', dialogTimeoutSeconds: 300 });\n      this.browserTaskSupervisors.set(taskId, s);\n    }\n    return s;\n  }\n\n  private async acquireBrowserPage(): Promise<Page> {\n    const taskId = this.deps.getCurrentContext()?.sessionKey ?? 'default';\n    const mgr = this.ensureBrowserManager();\n    await mgr.ensureConnected();\n    if (mgr.getExtensionProvider()) {\n      return null as unknown as Page;\n    }\n    const page = await mgr.getPage(taskId);\n    this.browserSupervisorForTask(taskId).attach(page);\n    return page;\n  }\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => false,\n        getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.()),\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    this.browserReadinessCache = null;\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n    this.browserTaskSupervisors.clear();\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    this.browserTaskSupervisors.delete(sessionKey);\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 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 dreamingRoot = options?.dreamingRoot ?? (cfg ? resolveDreamingRootForAgent(cfg, options?.agentId) : workspace);\n    const browserEnabled = cfg?.browser?.enabled !== false;\n    const recordGoalEvidence = createGoalEvidenceRecorder({\n      getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n    });\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n      agentId: options?.agentId,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n    const codeIntelligenceConfig = cfg?.codeIntelligence;\n    const agentId = options?.agentId;\n    const codeIntelligenceEnabled =\n      codeIntelligenceConfig?.enabled === true &&\n      agentId !== undefined &&\n      codeIntelligenceConfig.agentIds.includes(agentId);\n    const codeIntelligenceTools = codeIntelligenceEnabled && this.deps.getCodeIntelligenceRuntime\n      ? createCodeIntelligenceTools({\n          getRuntime: () => this.deps.getCodeIntelligenceRuntime!(workspace),\n        })\n      : [];\n\n    const composioTool = createComposioExecuteTool(() => this.deps.getConfig?.());\n    const optionalTools = [imageTool, imageGenerateTool, composioTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n      recordGoalEvidence,\n    });\n    const applyPatchTool = createApplyPatchTool(workspace, { recordGoalEvidence });\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        getDreamingRoot: () => dreamingRoot,\n        getConfig: () => this.deps.getConfig?.(),\n        getAgentId: () => options?.agentId,\n      }),\n      createToolManualTool(),\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          if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      createUpdatePlanTool(),\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      ...codeIntelligenceTools,\n      writeTool,\n      applyPatchTool,\n      listDir,\n      grep,\n      find,\n      createExecCommandTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n        recordGoalEvidence,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      createWebFetchTool(() => this.deps.getConfig?.()),\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?.messages?.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      createReadMediaTool(),\n      ...(isShareToolAvailable(cfg)\n        ? [\n            createCreateShareTool({\n              workspace,\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      ...(getMemMgr\n        ? [\n            createMemorySearchTool({\n              workspaceDir: workspace,\n              dreamingRoot,\n              getMemoryManager: () => getMemMgr(),\n              getScope: () => ({\n                ...(options?.agentId ? { agentId: options.agentId } : {}),\n                workspaceId: workspace,\n                ...(this.deps.getCurrentContext?.()?.sessionKey\n                  ? { sessionKey: this.deps.getCurrentContext!()!.sessionKey }\n                  : {}),\n              }),\n              shouldRecordDreamingRecalls: () =>\n                resolveDreamingConfig(this.deps.getConfig?.(), options?.agentId).enabled,\n            }),\n            createMemoryGetTool({\n              workspaceDir: workspace,\n              dreamingRoot,\n              getMemoryManager: () => getMemMgr(),\n              getScope: () => ({\n                ...(options?.agentId ? { agentId: options.agentId } : {}),\n                workspaceId: workspace,\n                ...(this.deps.getCurrentContext?.()?.sessionKey\n                  ? { sessionKey: this.deps.getCurrentContext!()!.sessionKey }\n                  : {}),\n              }),\n            }),\n          ]\n        : []),\n      ...(getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(() => getMemMgr()),\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.getAutomationService\n        ? [\n            createAutomationTool({\n              getAutomationService: this.deps.getAutomationService,\n            }),\n          ]\n        : []),\n      ...(this.deps.getProjectService || this.deps.getNotesService || this.deps.getWorkItemService\n        ? [\n            createXopcUseTool({\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentAgentId: () => options.agentId,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getNotesService: this.deps.getNotesService,\n              getProjectService: this.deps.getProjectService,\n              getWorkItemService: this.deps.getWorkItemService,\n            }),\n          ]\n        : []),\n      createGoalTool({\n        getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(browserEnabled\n        ? [\n            createBrowserUseTool({\n              getManager: () => this.ensureBrowserManager(),\n              getPageForTask: () => this.acquireBrowserPage(),\n              getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n              getConfig: () => this.deps.getConfig?.(),\n              getReadiness: () => this.checkBrowserReadinessCached(),\n              getSupervisor: () =>\n                this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? 'default'),\n              notifyBrowserPageClosed: (taskId) => {\n                this.browserTaskSupervisors.delete(taskId);\n              },\n            }),\n          ]\n        : []),\n      ...(primary\n        ? [\n            createWorkflowTool({\n              catalog: createWorkflowCatalog(),\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getConfig: () => this.deps.getConfig?.(),\n              startWorkflowRun: this.deps.getWorkflowRunService\n                ? (params) => this.deps.getWorkflowRunService!().startWorkflowRun(params)\n                : undefined,\n            }),\n          ]\n        : []),\n      ...(false && 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              // Injected so `child-agent-factory.ts` does not need to import\n              // `AgentToolsFactory` directly (which would form a cycle).\n              buildChildTools: (childOpts) => {\n                const childFactory = new AgentToolsFactory({\n                  workspace: childOpts.workspace,\n                  bus: childOpts.bus,\n                  getCurrentContext: () => null,\n                  getConfig: childOpts.getConfig,\n                  getPrimaryModel: () => childOpts.model,\n                  toolExecutorConfig: childOpts.toolExecutorConfig,\n                });\n                return childFactory.createAllTools({\n                  workspace: childOpts.workspace,\n                  getPrimaryModel: () => childOpts.model,\n                  agentId: options?.agentId ?? childOpts.agentId,\n                  dreamingRoot: options?.dreamingRoot,\n                  disabledTools: new Set(['extensions']),\n                });\n              },\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createCapabilityTools(\n    capabilityNames: readonly string[],\n    options?: Pick<CreateCoreToolsOptions, 'disabledTools'>,\n  ): AgentTool<any, any>[] {\n    const disabled = options?.disabledTools;\n    const raw: AgentTool<any, any>[] = [];\n    const toolNames = new Set<string>();\n    for (const toolName of getAgentCapabilityToolNames(capabilityNames)) {\n      if (disabled?.has(toolName) || toolNames.has(toolName)) continue;\n      toolNames.add(toolName);\n      if (toolName === 'create_desktop_pet') raw.push(createDesktopPetTool() as AgentTool<any, any>);\n      if (toolName === 'skill_install') {\n        raw.push(createSkillInstallTool({\n          installSkillFromSource: this.deps.installSkillFromSource,\n          getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n        }) as AgentTool<any, any>);\n      }\n    }\n    return wrapToolsWithProtection(raw, this.deps.toolExecutorConfig);\n  }\n\n  getLazyCapabilityToolNames(): string[] {\n    return [\n      'create_desktop_pet',\n      ...(this.deps.installSkillFromSource ? ['skill_install'] : []),\n    ];\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\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 = false && !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/memory-tool.d.ts

@@ -1,9 +1,12 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { MemoryManager } from '../memory/manager.js';
+import type { MemoryScope } from '../memory/types.js';
 export interface MemoryToolOptions {
     workspaceDir: string;
     dreamingRoot: string;
     getMemoryManager: () => MemoryManager;
+    getScope?: () => Partial<MemoryScope>;
+    shouldRecordDreamingRecalls?: () => boolean;
 }
 export declare function createMemorySearchTool(options: MemoryToolOptions): AgentTool;
 export declare function createMemoryGetTool(options: MemoryToolOptions): AgentTool;

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

@@ -19,7 +19,8 @@ function createMemorySearchTool(options) {
 				const results = await getMemoryManager().search({
 					query,
 					maxResults,
-					minScore
+					minScore,
+					scope: options.getScope?.()
 				});
 				for (const result of results) getMemoryManager().recordSignal({
 					source: "search_recall",
@@ -33,7 +34,7 @@ function createMemorySearchTool(options) {
 						lineEnd: result.citation.lineEnd
 					}
 				});
-				recordDreamingRecalls({
+				if (options.shouldRecordDreamingRecalls?.() !== false) recordDreamingRecalls({
 					dreamingRoot,
 					query,
 					matches: results.map((entry) => ({
@@ -45,6 +46,7 @@ function createMemorySearchTool(options) {
 				}).catch(() => {});
 				const withCitations = results.map((entry) => ({
 					id: entry.record.id,
+					ownerAgentId: entry.record.scope.agentId,
 					kind: entry.record.kind,
 					file: entry.citation.path ?? entry.record.source.path,
 					lines: entry.snippet,
@@ -94,7 +96,8 @@ function createMemoryGetTool(options) {
 				const result = await getMemoryManager().read({
 					path,
 					from,
-					lines
+					lines,
+					scope: options.getScope?.()
 				});
 				if (!result) return {
 					content: [{

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 '@earendil-works/pi-agent-core';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\nimport type { MemoryManager } from '../memory/manager.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  dreamingRoot: string;\n  getMemoryManager: () => MemoryManager;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { dreamingRoot, getMemoryManager } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      'Mandatory recall step: search indexed profile, curated, and session memory sources before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with source 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 getMemoryManager().search({ query, maxResults, minScore });\n        for (const result of results) {\n          getMemoryManager().recordSignal({\n            source: 'search_recall',\n            recordId: result.record.id,\n            score: result.score,\n            content: result.snippet,\n            metadata: {\n              providerId: result.citation.providerId,\n              path: result.citation.path,\n              lineStart: result.citation.lineStart,\n              lineEnd: result.citation.lineEnd,\n            },\n          });\n        }\n        // Dreaming: record short-term recall evidence from memory_search.\n        void recordDreamingRecalls({\n          dreamingRoot,\n          query,\n          matches: results.map((entry) => ({\n            file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,\n            lines: entry.snippet,\n            score: entry.score,\n            lineNumbers:\n              entry.citation.lineStart != null\n                ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n                : [],\n          })),\n        }).catch(() => {});\n        const withCitations = results.map((entry) => ({\n          id: entry.record.id,\n          kind: entry.record.kind,\n          file: entry.citation.path ?? entry.record.source.path,\n          lines: entry.snippet,\n          score: entry.score,\n          lineNumbers:\n            entry.citation.lineStart != null\n              ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n              : [],\n          citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n          snippet: `${entry.snippet.trim()}\\n\\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'memory-manager' }, 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 { getMemoryManager } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from a source path returned by memory_search, with optional from/lines; 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 = await getMemoryManager().read({ path, from, lines });\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.record.content }],\n          details: { path, text: result.record.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":"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"}
+{"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 '@earendil-works/pi-agent-core';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport type { MemoryScope } from '../memory/types.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  dreamingRoot: string;\n  getMemoryManager: () => MemoryManager;\n  getScope?: () => Partial<MemoryScope>;\n  shouldRecordDreamingRecalls?: () => boolean;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { dreamingRoot, getMemoryManager } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      'Mandatory recall step: search indexed profile, curated, and session memory sources before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with source 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 getMemoryManager().search({\n          query,\n          maxResults,\n          minScore,\n          scope: options.getScope?.(),\n        });\n        for (const result of results) {\n          getMemoryManager().recordSignal({\n            source: 'search_recall',\n            recordId: result.record.id,\n            score: result.score,\n            content: result.snippet,\n            metadata: {\n              providerId: result.citation.providerId,\n              path: result.citation.path,\n              lineStart: result.citation.lineStart,\n              lineEnd: result.citation.lineEnd,\n            },\n          });\n        }\n        // Dreaming: record short-term recall evidence from memory_search.\n        if (options.shouldRecordDreamingRecalls?.() !== false) {\n          void recordDreamingRecalls({\n            dreamingRoot,\n            query,\n            matches: results.map((entry) => ({\n              file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,\n              lines: entry.snippet,\n              score: entry.score,\n              lineNumbers:\n                entry.citation.lineStart != null\n                  ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n                  : [],\n            })),\n          }).catch(() => {});\n        }\n        const withCitations = results.map((entry) => ({\n          id: entry.record.id,\n          ownerAgentId: entry.record.scope.agentId,\n          kind: entry.record.kind,\n          file: entry.citation.path ?? entry.record.source.path,\n          lines: entry.snippet,\n          score: entry.score,\n          lineNumbers:\n            entry.citation.lineStart != null\n              ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n              : [],\n          citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n          snippet: `${entry.snippet.trim()}\\n\\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'memory-manager' }, 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 { getMemoryManager } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from a source path returned by memory_search, with optional from/lines; 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 = await getMemoryManager().read({\n          path,\n          from,\n          lines,\n          scope: options.getScope?.(),\n        });\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.record.content }],\n          details: { path, text: result.record.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":"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"}

package/dist/src/agent/tools/session-search-tool.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/session-search-tool.ts
 init_providers();
@@ -62,7 +62,7 @@ ${formatMessagesForSummary(messages)}`,
 	};
 	const model = resolveSummaryModel(getConfig);
 	try {
-		const result = await complete(model, { messages: [userMsg] }, {
+		const result = await completeWithResolvedCredentials(model, { messages: [userMsg] }, {
 			maxTokens: 400,
 			temperature: .15,
 			signal

package/dist/src/agent/tools/session-search-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('Agent:SessionSearch');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const ref = envRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch (err) {\n      log.warn({ err, ref }, 'session_search: summary model resolve failed, using fallback');\n    }\n  }\n  try {\n    return resolveModel('openai/gpt-4o-mini');\n  } catch {\n    const d = getDefaultModelSync(getConfig?.());\n    return resolveModel(d);\n  }\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const item of content) {\n    if (typeof item !== 'object' || item === null || !('type' in item)) {\n      continue;\n    }\n    const c = item as { type?: string; text?: string };\n    if (c.type === 'text' && typeof c.text === 'string') {\n      parts.push(c.text);\n    }\n  }\n  return parts.join(' ');\n}\n\nfunction formatMessagesForSummary(messages: AgentMessage[]): string {\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages) {\n    const role = String(msg.role || 'unknown').toUpperCase();\n    const text = extractTextFromContent(readAgentMessageContent(msg));\n    const line = `${role}: ${text}`;\n    if (total + line.length > MAX_SUMMARY_CHARS) {\n      lines.push('… [truncated]');\n      break;\n    }\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n\\n');\n}\n\nasync function summarizeSession(\n  messages: AgentMessage[],\n  query: string,\n  getConfig: (() => Config | undefined) | undefined,\n  signal: AbortSignal | undefined,\n  logMeta?: { summarizingSessionKey: string },\n): Promise<string> {\n  if (messages.length === 0) {\n    return 'No messages in session.';\n  }\n\n  const formatted = formatMessagesForSummary(messages);\n  const prompt = `Summarize this conversation for someone searching with: \"${query}\". Focus on facts, decisions, and names. Max 200 words. Use the same language as the conversation when possible.\n\nConversation:\n${formatted}`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const model = resolveSummaryModel(getConfig);\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 400,\n        temperature: 0.15,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n    return text.trim() || '[Empty summary]';\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    log.warn(\n      {\n        err,\n        summarizingSessionKey: logMeta?.summarizingSessionKey,\n        queryLength: query.length,\n        messageCount: messages.length,\n      },\n      `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ''}: ${msg}`,\n    );\n    return `[Summarization failed: ${msg}]`;\n  }\n}\n\nconst SessionSearchSchema = Type.Object({\n  query: Type.Optional(\n    Type.String({ description: 'Keyword search over past sessions. Omit to list recent sessions.' }),\n  ),\n  roleFilter: Type.Optional(\n    Type.Union([\n      Type.Literal('user'),\n      Type.Literal('assistant'),\n      Type.Literal('system'),\n      Type.Literal('tool'),\n      Type.Literal('toolResult'),\n    ]),\n  ),\n  limit: Type.Optional(Type.Number({ minimum: 1, maximum: 15 })),\n  excludeSessionKey: Type.Optional(\n    Type.String({ description: 'Exclude this session key from keyword results (default: current chat).' }),\n  ),\n});\n\nexport interface SessionSearchToolDeps {\n  getSessionStore: () => SessionStore;\n  getConfig?: () => Config | undefined;\n  getCurrentSessionKey?: () => string | undefined;\n}\n\ntype SessionSearchParams = {\n  query?: string;\n  roleFilter?: 'user' | 'assistant' | 'system' | 'tool' | 'toolResult';\n  limit?: number;\n  excludeSessionKey?: string;\n};\n\nexport function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool {\n  return {\n    name: 'session_search',\n    label: 'Session search',\n    description:\n      'Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.',\n    parameters: SessionSearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const p = params as SessionSearchParams;\n      const store = deps.getSessionStore();\n      const limit = Math.min(15, Math.max(1, p.limit ?? 5));\n      const query = p.query?.trim() ?? '';\n\n      try {\n        if (!query) {\n          const listed = await store.list({\n            limit: limit + 5,\n            sortBy: 'updatedAt',\n            sortOrder: 'desc',\n          });\n          const items = listed.items.slice(0, limit).map((s) => ({\n            key: s.key,\n            name: s.name,\n            updatedAt: s.updatedAt,\n            messageCount: s.messageCount,\n            sourceChannel: s.sourceChannel,\n          }));\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  { success: true, mode: 'recent', results: items, total: listed.total },\n                  null,\n                  2,\n                ),\n              },\n            ],\n            details: { mode: 'recent', items },\n          };\n        }\n\n        const listed = await store.list({\n          search: query,\n          limit: limit + 10,\n          sortBy: 'updatedAt',\n          sortOrder: 'desc',\n        });\n        let matches = listed.items.map((item) => ({ key: item.key, score: 1 }));\n\n        const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || '';\n        if (exclude) {\n          matches = matches.filter((m) => m.key !== exclude);\n        }\n\n        const top = matches.slice(0, limit);\n\n        const summaries = await Promise.all(\n          top.map(async ({ key, score }) => {\n            let messages = await store.load(key);\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../providers/model-call.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('Agent:SessionSearch');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const ref = envRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch (err) {\n      log.warn({ err, ref }, 'session_search: summary model resolve failed, using fallback');\n    }\n  }\n  try {\n    return resolveModel('openai/gpt-4o-mini');\n  } catch {\n    const d = getDefaultModelSync(getConfig?.());\n    return resolveModel(d);\n  }\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const item of content) {\n    if (typeof item !== 'object' || item === null || !('type' in item)) {\n      continue;\n    }\n    const c = item as { type?: string; text?: string };\n    if (c.type === 'text' && typeof c.text === 'string') {\n      parts.push(c.text);\n    }\n  }\n  return parts.join(' ');\n}\n\nfunction formatMessagesForSummary(messages: AgentMessage[]): string {\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages) {\n    const role = String(msg.role || 'unknown').toUpperCase();\n    const text = extractTextFromContent(readAgentMessageContent(msg));\n    const line = `${role}: ${text}`;\n    if (total + line.length > MAX_SUMMARY_CHARS) {\n      lines.push('… [truncated]');\n      break;\n    }\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n\\n');\n}\n\nasync function summarizeSession(\n  messages: AgentMessage[],\n  query: string,\n  getConfig: (() => Config | undefined) | undefined,\n  signal: AbortSignal | undefined,\n  logMeta?: { summarizingSessionKey: string },\n): Promise<string> {\n  if (messages.length === 0) {\n    return 'No messages in session.';\n  }\n\n  const formatted = formatMessagesForSummary(messages);\n  const prompt = `Summarize this conversation for someone searching with: \"${query}\". Focus on facts, decisions, and names. Max 200 words. Use the same language as the conversation when possible.\n\nConversation:\n${formatted}`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const model = resolveSummaryModel(getConfig);\n\n  try {\n    const result = await completeWithResolvedCredentials(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 400,\n        temperature: 0.15,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n    return text.trim() || '[Empty summary]';\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    log.warn(\n      {\n        err,\n        summarizingSessionKey: logMeta?.summarizingSessionKey,\n        queryLength: query.length,\n        messageCount: messages.length,\n      },\n      `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ''}: ${msg}`,\n    );\n    return `[Summarization failed: ${msg}]`;\n  }\n}\n\nconst SessionSearchSchema = Type.Object({\n  query: Type.Optional(\n    Type.String({ description: 'Keyword search over past sessions. Omit to list recent sessions.' }),\n  ),\n  roleFilter: Type.Optional(\n    Type.Union([\n      Type.Literal('user'),\n      Type.Literal('assistant'),\n      Type.Literal('system'),\n      Type.Literal('tool'),\n      Type.Literal('toolResult'),\n    ]),\n  ),\n  limit: Type.Optional(Type.Number({ minimum: 1, maximum: 15 })),\n  excludeSessionKey: Type.Optional(\n    Type.String({ description: 'Exclude this session key from keyword results (default: current chat).' }),\n  ),\n});\n\nexport interface SessionSearchToolDeps {\n  getSessionStore: () => SessionStore;\n  getConfig?: () => Config | undefined;\n  getCurrentSessionKey?: () => string | undefined;\n}\n\ntype SessionSearchParams = {\n  query?: string;\n  roleFilter?: 'user' | 'assistant' | 'system' | 'tool' | 'toolResult';\n  limit?: number;\n  excludeSessionKey?: string;\n};\n\nexport function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool {\n  return {\n    name: 'session_search',\n    label: 'Session search',\n    description:\n      'Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.',\n    parameters: SessionSearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const p = params as SessionSearchParams;\n      const store = deps.getSessionStore();\n      const limit = Math.min(15, Math.max(1, p.limit ?? 5));\n      const query = p.query?.trim() ?? '';\n\n      try {\n        if (!query) {\n          const listed = await store.list({\n            limit: limit + 5,\n            sortBy: 'updatedAt',\n            sortOrder: 'desc',\n          });\n          const items = listed.items.slice(0, limit).map((s) => ({\n            key: s.key,\n            name: s.name,\n            updatedAt: s.updatedAt,\n            messageCount: s.messageCount,\n            sourceChannel: s.sourceChannel,\n          }));\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  { success: true, mode: 'recent', results: items, total: listed.total },\n                  null,\n                  2,\n                ),\n              },\n            ],\n            details: { mode: 'recent', items },\n          };\n        }\n\n        const listed = await store.list({\n          search: query,\n          limit: limit + 10,\n          sortBy: 'updatedAt',\n          sortOrder: 'desc',\n        });\n        let matches = listed.items.map((item) => ({ key: item.key, score: 1 }));\n\n        const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || '';\n        if (exclude) {\n          matches = matches.filter((m) => m.key !== exclude);\n        }\n\n        const top = matches.slice(0, limit);\n\n        const summaries = await Promise.all(\n          top.map(async ({ key, score }) => {\n            let messages = await store.load(key);\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/web-extract.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from "./url-safety.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/web-extract.ts
 init_providers();
@@ -76,7 +76,7 @@ function extractTextFromCompletion(result) {
 	return text.trim();
 }
 async function callExtractionLlm(systemPrompt, userPrompt, maxTokens, config, signal) {
-	return extractTextFromCompletion(await complete(resolveExtractionModel(config), { messages: [{
+	return extractTextFromCompletion(await completeWithResolvedCredentials(resolveExtractionModel(config), { messages: [{
 		role: "user",
 		content: `${systemPrompt}\n\n---\n\n${userPrompt}`,
 		timestamp: Date.now()

package/dist/src/agent/tools/web-extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-extract.js","names":[],"sources":["../../../../src/agent/tools/web-extract.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from './url-safety.js';\n\nconst log = createLogger('web-extract');\n\nexport const DEFAULT_WEB_EXTRACT_MAX_LENGTH = 15_000;\nexport const MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT = 200_000;\nconst EXTRACTION_TIMEOUT_MS = 30_000;\n\n// Large-document chunked processing thresholds (inspired by hermes-agent)\nconst MAX_CONTENT_SIZE = 2_000_000;   // 2M chars — refuse entirely above this\nconst CHUNK_THRESHOLD = 500_000;      // 500k chars — use chunked processing above this\nconst CHUNK_SIZE = 100_000;           // 100k chars per chunk\nconst MAX_OUTPUT_SIZE = 15_000;       // Hard cap on final output size\n\nconst WebExtractSchema = Type.Object({\n  url: Type.String({ description: 'URL to extract content from' }),\n  instruction: Type.Optional(\n    Type.String({\n      description:\n        'What to extract or focus on. Examples: \"main article text\", ' +\n        '\"pricing table\", \"API documentation for the auth endpoint\". ' +\n        'If omitted, extracts the main content.',\n    }),\n  ),\n  maxLength: Type.Optional(\n    Type.Number({\n      description: 'Maximum characters in the extracted content (default: from config or 15000)',\n    }),\n  ),\n});\n\nexport interface WebExtractDeps {\n  getConfig: () => Config | undefined;\n}\n\nasync function fetchPageContent(url: string, signal?: AbortSignal): Promise<string> {\n  const response = await fetch(url, {\n    signal,\n    headers: {\n      'User-Agent': 'Mozilla/5.0 (compatible; xopc/1.0)',\n      Accept: 'text/html,application/xhtml+xml,text/plain,application/json',\n    },\n    redirect: 'follow',\n  });\n\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n  }\n\n  const contentType = response.headers.get('content-type') ?? '';\n  if (contentType.includes('application/json')) {\n    const json: unknown = await response.json();\n    return JSON.stringify(json, null, 2);\n  }\n\n  return await response.text();\n}\n\nexport function stripHtmlBoilerplate(\n  html: string,\n  maxRaw = MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT,\n): string {\n  let cleaned = html\n    .replace(/<script[\\s\\S]*?<\\/script>/gi, '')\n    .replace(/<style[\\s\\S]*?<\\/style>/gi, '')\n    .replace(/<svg[\\s\\S]*?<\\/svg>/gi, '')\n    .replace(/<noscript[\\s\\S]*?<\\/noscript>/gi, '')\n    .replace(/<!--[\\s\\S]*?-->/g, '');\n\n  // Remove base64 images early to avoid wasting characters on them\n  cleaned = cleanBase64Images(cleaned);\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  if (cleaned.length > maxRaw) {\n    cleaned = cleaned.slice(0, maxRaw) + '\\n\\n[...truncated]';\n  }\n\n  return cleaned;\n}\n\nfunction resolveExtractionModel(config?: Config) {\n  const envRef = process.env.XOPC_WEB_EXTRACT_MODEL?.trim();\n  const ref = envRef;\n\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch {\n      /* fall through */\n    }\n  }\n\n  const defaultRef = getDefaultModelSync(config);\n  if (!defaultRef) {\n    throw new Error('No global default model configured for web extraction');\n  }\n\n  return resolveModel(defaultRef);\n}\n\nfunction buildExtractionSystemPrompt(maxLength: number): string {\n  return (\n    'You are a web content extractor. Given raw HTML/text from a web page, ' +\n    'extract the relevant content as clean, well-structured markdown.\\n\\n' +\n    'Rules:\\n' +\n    '- Remove navigation, headers, footers, ads, cookie banners, sidebars\\n' +\n    '- Preserve the main content structure (headings, lists, tables, code blocks)\\n' +\n    '- Keep URLs for important links\\n' +\n    '- If the page has structured data (tables, specs), preserve the structure\\n' +\n    `- Keep output under ${maxLength} characters\\n` +\n    '- If content is truncated, note what was cut\\n' +\n    '- Output ONLY the extracted content, no meta-commentary'\n  );\n}\n\n// ---------------------------------------------------------------------------\n// LLM call helper — shared by single-pass and chunked extraction\n// ---------------------------------------------------------------------------\n\nfunction buildTimeoutSignal(signal: AbortSignal | undefined): AbortSignal | undefined {\n  const timeoutSignal =\n    typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n      ? AbortSignal.timeout(EXTRACTION_TIMEOUT_MS)\n      : undefined;\n  if (signal && timeoutSignal && typeof AbortSignal.any === 'function') {\n    return AbortSignal.any([signal, timeoutSignal]);\n  }\n  return signal ?? timeoutSignal;\n}\n\nfunction extractTextFromCompletion(result: { content?: unknown }): string {\n  let text = '';\n  if (Array.isArray(result.content)) {\n    for (const c of result.content) {\n      if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n        text += String((c as { text?: string }).text || '');\n      }\n    }\n  }\n  return text.trim();\n}\n\nasync function callExtractionLlm(\n  systemPrompt: string,\n  userPrompt: string,\n  maxTokens: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const model = resolveExtractionModel(config);\n  const userMsg: UserMessage = {\n    role: 'user',\n    content: `${systemPrompt}\\n\\n---\\n\\n${userPrompt}`,\n    timestamp: Date.now(),\n  };\n\n  const result = await complete(\n    model,\n    { messages: [userMsg] },\n    {\n      maxTokens,\n      temperature: 0.2,\n      signal: buildTimeoutSignal(signal) as AbortSignal,\n    },\n  );\n\n  return extractTextFromCompletion(result);\n}\n\n// ---------------------------------------------------------------------------\n// Single-pass extraction (content < CHUNK_THRESHOLD)\n// ---------------------------------------------------------------------------\n\nasync function extractWithLlm(\n  rawContent: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const contentLength = rawContent.length;\n\n  // Refuse absurdly large content\n  if (contentLength > MAX_CONTENT_SIZE) {\n    const sizeMb = (contentLength / 1_000_000).toFixed(1);\n    return (\n      `[Content too large to process: ${sizeMb}MB. ` +\n      'Try using web_fetch for raw text, or search for a more focused source.]'\n    );\n  }\n\n  // Route to chunked processing for large documents\n  if (contentLength > CHUNK_THRESHOLD) {\n    log.info(\n      { url, contentLength, chunkSize: CHUNK_SIZE },\n      'Large document detected, using chunked extraction',\n    );\n    return extractLargeDocumentChunked(rawContent, url, instruction, maxLength, config, signal);\n  }\n\n  // Standard single-pass extraction\n  const systemPrompt = buildExtractionSystemPrompt(maxLength);\n  const body = instruction\n    ? `Extract from this page (${url}):\\n\\nFOCUS: ${instruction}\\n\\n---\\n\\n${rawContent}`\n    : `Extract the main content from this page (${url}):\\n\\n---\\n\\n${rawContent}`;\n\n  const text = await callExtractionLlm(\n    systemPrompt,\n    body,\n    Math.min(Math.ceil(maxLength / 3), 8000),\n    config,\n    signal,\n  );\n\n  if (!text) return 'No content could be extracted.';\n\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n  if (text.length > outputCap) {\n    return text.slice(0, outputCap) + '\\n\\n[...output truncated to maxLength]';\n  }\n\n  log.debug(\n    { url, originalChars: contentLength, extractedChars: text.length },\n    'Single-pass extraction complete',\n  );\n  return text;\n}\n\n// ---------------------------------------------------------------------------\n// Chunked extraction for large documents (inspired by hermes-agent)\n//\n// Flow: split → parallel chunk summaries → synthesis pass\n// ---------------------------------------------------------------------------\n\nasync function extractLargeDocumentChunked(\n  content: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  // Split content into chunks\n  const chunks: string[] = [];\n  for (let offset = 0; offset < content.length; offset += CHUNK_SIZE) {\n    chunks.push(content.slice(offset, offset + CHUNK_SIZE));\n  }\n  log.info({ url, chunkCount: chunks.length, chunkSize: CHUNK_SIZE }, 'Split into chunks');\n\n  // Summarize each chunk in parallel\n  const chunkPromises = chunks.map(async (chunk, index) => {\n    const chunkLabel = `[Chunk ${index + 1}/${chunks.length}]`;\n    try {\n      const systemPrompt =\n        'You are an expert content analyst processing a SECTION of a larger document. ' +\n        'Extract and summarize the key information from THIS SECTION ONLY.\\n\\n' +\n        'Guidelines:\\n' +\n        '- Do NOT write introductions or conclusions — this is a partial document\\n' +\n        '- Extract ALL key facts, figures, data points, and insights\\n' +\n        '- Preserve important quotes, code snippets, and specific details verbatim\\n' +\n        '- Use bullet points and structured formatting\\n' +\n        '- Note references to other sections without trying to resolve them';\n\n      const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n      const userPrompt =\n        `${chunkLabel} Extract key information from this section of ${url}:` +\n        `${focusLine}\\n\\n${chunk}`;\n\n      const summary = await callExtractionLlm(systemPrompt, userPrompt, 6000, config, signal);\n      if (summary) {\n        log.debug(\n          { url, chunk: index + 1, originalChars: chunk.length, summaryChars: summary.length },\n          'Chunk summarized',\n        );\n      }\n      return { index, summary: summary || null };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      log.warn({ url, chunk: index + 1, error: message }, 'Chunk summarization failed');\n      return { index, summary: null };\n    }\n  });\n\n  const chunkResults = await Promise.all(chunkPromises);\n\n  // Collect successful summaries in order\n  const summaries: string[] = [];\n  for (const { index, summary } of chunkResults.sort((a, b) => a.index - b.index)) {\n    if (summary) {\n      summaries.push(`## Section ${index + 1}\\n${summary}`);\n    }\n  }\n\n  if (summaries.length === 0) {\n    // All chunks failed — fall back to truncated raw content\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    const truncated = content.slice(0, outputCap);\n    return truncated + '\\n\\n[...all chunk summaries failed; showing truncated raw content]';\n  }\n\n  log.info(\n    { url, successfulChunks: summaries.length, totalChunks: chunks.length },\n    'Chunk summaries collected, synthesizing',\n  );\n\n  // Single chunk — return directly\n  if (summaries.length === 1) {\n    const result = summaries[0];\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    return result.length > outputCap\n      ? result.slice(0, outputCap) + '\\n\\n[...truncated]'\n      : result;\n  }\n\n  // Synthesize multiple chunk summaries into one cohesive summary\n  return synthesizeChunkSummaries(summaries, url, instruction, maxLength, config, signal, content.length);\n}\n\nasync function synthesizeChunkSummaries(\n  summaries: string[],\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n  originalContentLength: number,\n): Promise<string> {\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n\n  const systemPrompt =\n    'You synthesize multiple section summaries into one cohesive, comprehensive summary. ' +\n    'Remove redundancy, preserve all key facts and actionable information, ' +\n    'and organize with clear markdown structure.';\n\n  const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n  const combined = summaries.join('\\n\\n---\\n\\n');\n  const userPrompt =\n    `Synthesize these section summaries from ${url} into ONE unified markdown summary ` +\n    `(under ${outputCap} characters):${focusLine}\\n\\n${combined}`;\n\n  try {\n    const synthesized = await callExtractionLlm(systemPrompt, userPrompt, 8000, config, signal);\n\n    if (!synthesized) {\n      // Synthesis LLM returned empty — fall back to concatenation\n      log.warn({ url }, 'Synthesis returned empty, concatenating chunk summaries');\n      const fallback = summaries.join('\\n\\n');\n      return fallback.length > outputCap\n        ? fallback.slice(0, outputCap) + '\\n\\n[...truncated]'\n        : fallback;\n    }\n\n    const finalOutput = synthesized.length > outputCap\n      ? synthesized.slice(0, outputCap) + '\\n\\n[...summary truncated for context management]'\n      : synthesized;\n\n    const compressionRatio = finalOutput.length / originalContentLength;\n    log.info(\n      {\n        url,\n        originalChars: originalContentLength,\n        extractedChars: finalOutput.length,\n        compressionPercent: `${(compressionRatio * 100).toFixed(1)}%`,\n      },\n      'Chunked extraction complete',\n    );\n\n    return finalOutput;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    log.warn({ url, error: message }, 'Synthesis failed, concatenating chunk summaries');\n    const fallback = summaries.join('\\n\\n');\n    return fallback.length > outputCap\n      ? fallback.slice(0, outputCap) + '\\n\\n[...truncated due to synthesis failure]'\n      : fallback;\n  }\n}\n\ntype WebExtractParams = { url: string; instruction?: string; maxLength?: number };\n\nfunction resolveConfiguredMaxLength(): number {\n  return DEFAULT_WEB_EXTRACT_MAX_LENGTH;\n}\n\nexport function createWebExtractTool(deps: WebExtractDeps): AgentTool {\n  return {\n    name: 'web_extract',\n    label: '📄 Web Extract',\n    description:\n      'Extract and summarize content from a web page using LLM-powered extraction.\\n\\n' +\n      'Unlike web_fetch (which returns cleaned plain text from HTML), this tool uses a ' +\n      'dedicated model pass to produce focused markdown. Use when you need semantic extraction ' +\n      'or a specific focus (instruction), not just a single readability pass.\\n\\n' +\n      'WHEN TO USE:\\n' +\n      '- Reading articles, blog posts, documentation\\n' +\n      '- Extracting specific data (pricing, specs, API docs)\\n' +\n      '- Summarizing long pages to save context\\n\\n' +\n      'WHEN TO USE web_fetch INSTEAD:\\n' +\n      '- Inspecting raw-ish page text quickly without an extra LLM call\\n' +\n      '- Downloading JSON/API responses\\n' +\n      '- Debugging page rendering issues',\n    parameters: WebExtractSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{ url: string; extractedLength: number }>> {\n      const { url, instruction } = params as WebExtractParams;\n      const cfg = deps.getConfig();\n      const maxLength = (params as WebExtractParams).maxLength ?? resolveConfiguredMaxLength();\n\n      try {\n        // SSRF protection\n        const safety = checkUrlSafety(url);\n        if (!safety.safe) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${safety.reason}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        // Website blocklist check\n        const blocked = checkWebsiteBlocklist(url, cfg?.tools?.web?.blocklist);\n        if (blocked) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${blocked.message}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const rawContent = await fetchPageContent(url, signal);\n        const cleaned = stripHtmlBoilerplate(rawContent);\n        const trimmed = cleaned.trim();\n        const looksStructured = trimmed.startsWith('{') || trimmed.startsWith('[');\n        if (trimmed.length < 100 && !looksStructured) {\n          return {\n            content: [\n              { type: 'text', text: `Page at ${url} appears to have no extractable content.` },\n            ],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const extracted = await extractWithLlm(\n          cleaned,\n          url,\n          instruction,\n          maxLength,\n          cfg,\n          signal,\n        );\n\n        return {\n          content: [{ type: 'text', text: extracted }],\n          details: { url, extractedLength: extracted.length },\n        };\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        log.warn({ url, error: message }, 'web_extract failed');\n        return {\n          content: [{ type: 'text', text: `Failed to extract content from ${url}: ${message}` }],\n          details: { url, extractedLength: 0 },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"web-extract.js","names":[],"sources":["../../../../src/agent/tools/web-extract.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../providers/model-call.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from './url-safety.js';\n\nconst log = createLogger('web-extract');\n\nexport const DEFAULT_WEB_EXTRACT_MAX_LENGTH = 15_000;\nexport const MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT = 200_000;\nconst EXTRACTION_TIMEOUT_MS = 30_000;\n\n// Large-document chunked processing thresholds (inspired by hermes-agent)\nconst MAX_CONTENT_SIZE = 2_000_000;   // 2M chars — refuse entirely above this\nconst CHUNK_THRESHOLD = 500_000;      // 500k chars — use chunked processing above this\nconst CHUNK_SIZE = 100_000;           // 100k chars per chunk\nconst MAX_OUTPUT_SIZE = 15_000;       // Hard cap on final output size\n\nconst WebExtractSchema = Type.Object({\n  url: Type.String({ description: 'URL to extract content from' }),\n  instruction: Type.Optional(\n    Type.String({\n      description:\n        'What to extract or focus on. Examples: \"main article text\", ' +\n        '\"pricing table\", \"API documentation for the auth endpoint\". ' +\n        'If omitted, extracts the main content.',\n    }),\n  ),\n  maxLength: Type.Optional(\n    Type.Number({\n      description: 'Maximum characters in the extracted content (default: from config or 15000)',\n    }),\n  ),\n});\n\nexport interface WebExtractDeps {\n  getConfig: () => Config | undefined;\n}\n\nasync function fetchPageContent(url: string, signal?: AbortSignal): Promise<string> {\n  const response = await fetch(url, {\n    signal,\n    headers: {\n      'User-Agent': 'Mozilla/5.0 (compatible; xopc/1.0)',\n      Accept: 'text/html,application/xhtml+xml,text/plain,application/json',\n    },\n    redirect: 'follow',\n  });\n\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n  }\n\n  const contentType = response.headers.get('content-type') ?? '';\n  if (contentType.includes('application/json')) {\n    const json: unknown = await response.json();\n    return JSON.stringify(json, null, 2);\n  }\n\n  return await response.text();\n}\n\nexport function stripHtmlBoilerplate(\n  html: string,\n  maxRaw = MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT,\n): string {\n  let cleaned = html\n    .replace(/<script[\\s\\S]*?<\\/script>/gi, '')\n    .replace(/<style[\\s\\S]*?<\\/style>/gi, '')\n    .replace(/<svg[\\s\\S]*?<\\/svg>/gi, '')\n    .replace(/<noscript[\\s\\S]*?<\\/noscript>/gi, '')\n    .replace(/<!--[\\s\\S]*?-->/g, '');\n\n  // Remove base64 images early to avoid wasting characters on them\n  cleaned = cleanBase64Images(cleaned);\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  if (cleaned.length > maxRaw) {\n    cleaned = cleaned.slice(0, maxRaw) + '\\n\\n[...truncated]';\n  }\n\n  return cleaned;\n}\n\nfunction resolveExtractionModel(config?: Config) {\n  const envRef = process.env.XOPC_WEB_EXTRACT_MODEL?.trim();\n  const ref = envRef;\n\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch {\n      /* fall through */\n    }\n  }\n\n  const defaultRef = getDefaultModelSync(config);\n  if (!defaultRef) {\n    throw new Error('No global default model configured for web extraction');\n  }\n\n  return resolveModel(defaultRef);\n}\n\nfunction buildExtractionSystemPrompt(maxLength: number): string {\n  return (\n    'You are a web content extractor. Given raw HTML/text from a web page, ' +\n    'extract the relevant content as clean, well-structured markdown.\\n\\n' +\n    'Rules:\\n' +\n    '- Remove navigation, headers, footers, ads, cookie banners, sidebars\\n' +\n    '- Preserve the main content structure (headings, lists, tables, code blocks)\\n' +\n    '- Keep URLs for important links\\n' +\n    '- If the page has structured data (tables, specs), preserve the structure\\n' +\n    `- Keep output under ${maxLength} characters\\n` +\n    '- If content is truncated, note what was cut\\n' +\n    '- Output ONLY the extracted content, no meta-commentary'\n  );\n}\n\n// ---------------------------------------------------------------------------\n// LLM call helper — shared by single-pass and chunked extraction\n// ---------------------------------------------------------------------------\n\nfunction buildTimeoutSignal(signal: AbortSignal | undefined): AbortSignal | undefined {\n  const timeoutSignal =\n    typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n      ? AbortSignal.timeout(EXTRACTION_TIMEOUT_MS)\n      : undefined;\n  if (signal && timeoutSignal && typeof AbortSignal.any === 'function') {\n    return AbortSignal.any([signal, timeoutSignal]);\n  }\n  return signal ?? timeoutSignal;\n}\n\nfunction extractTextFromCompletion(result: { content?: unknown }): string {\n  let text = '';\n  if (Array.isArray(result.content)) {\n    for (const c of result.content) {\n      if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n        text += String((c as { text?: string }).text || '');\n      }\n    }\n  }\n  return text.trim();\n}\n\nasync function callExtractionLlm(\n  systemPrompt: string,\n  userPrompt: string,\n  maxTokens: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const model = resolveExtractionModel(config);\n  const userMsg: UserMessage = {\n    role: 'user',\n    content: `${systemPrompt}\\n\\n---\\n\\n${userPrompt}`,\n    timestamp: Date.now(),\n  };\n\n  const result = await completeWithResolvedCredentials(\n    model,\n    { messages: [userMsg] },\n    {\n      maxTokens,\n      temperature: 0.2,\n      signal: buildTimeoutSignal(signal) as AbortSignal,\n    },\n  );\n\n  return extractTextFromCompletion(result);\n}\n\n// ---------------------------------------------------------------------------\n// Single-pass extraction (content < CHUNK_THRESHOLD)\n// ---------------------------------------------------------------------------\n\nasync function extractWithLlm(\n  rawContent: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const contentLength = rawContent.length;\n\n  // Refuse absurdly large content\n  if (contentLength > MAX_CONTENT_SIZE) {\n    const sizeMb = (contentLength / 1_000_000).toFixed(1);\n    return (\n      `[Content too large to process: ${sizeMb}MB. ` +\n      'Try using web_fetch for raw text, or search for a more focused source.]'\n    );\n  }\n\n  // Route to chunked processing for large documents\n  if (contentLength > CHUNK_THRESHOLD) {\n    log.info(\n      { url, contentLength, chunkSize: CHUNK_SIZE },\n      'Large document detected, using chunked extraction',\n    );\n    return extractLargeDocumentChunked(rawContent, url, instruction, maxLength, config, signal);\n  }\n\n  // Standard single-pass extraction\n  const systemPrompt = buildExtractionSystemPrompt(maxLength);\n  const body = instruction\n    ? `Extract from this page (${url}):\\n\\nFOCUS: ${instruction}\\n\\n---\\n\\n${rawContent}`\n    : `Extract the main content from this page (${url}):\\n\\n---\\n\\n${rawContent}`;\n\n  const text = await callExtractionLlm(\n    systemPrompt,\n    body,\n    Math.min(Math.ceil(maxLength / 3), 8000),\n    config,\n    signal,\n  );\n\n  if (!text) return 'No content could be extracted.';\n\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n  if (text.length > outputCap) {\n    return text.slice(0, outputCap) + '\\n\\n[...output truncated to maxLength]';\n  }\n\n  log.debug(\n    { url, originalChars: contentLength, extractedChars: text.length },\n    'Single-pass extraction complete',\n  );\n  return text;\n}\n\n// ---------------------------------------------------------------------------\n// Chunked extraction for large documents (inspired by hermes-agent)\n//\n// Flow: split → parallel chunk summaries → synthesis pass\n// ---------------------------------------------------------------------------\n\nasync function extractLargeDocumentChunked(\n  content: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  // Split content into chunks\n  const chunks: string[] = [];\n  for (let offset = 0; offset < content.length; offset += CHUNK_SIZE) {\n    chunks.push(content.slice(offset, offset + CHUNK_SIZE));\n  }\n  log.info({ url, chunkCount: chunks.length, chunkSize: CHUNK_SIZE }, 'Split into chunks');\n\n  // Summarize each chunk in parallel\n  const chunkPromises = chunks.map(async (chunk, index) => {\n    const chunkLabel = `[Chunk ${index + 1}/${chunks.length}]`;\n    try {\n      const systemPrompt =\n        'You are an expert content analyst processing a SECTION of a larger document. ' +\n        'Extract and summarize the key information from THIS SECTION ONLY.\\n\\n' +\n        'Guidelines:\\n' +\n        '- Do NOT write introductions or conclusions — this is a partial document\\n' +\n        '- Extract ALL key facts, figures, data points, and insights\\n' +\n        '- Preserve important quotes, code snippets, and specific details verbatim\\n' +\n        '- Use bullet points and structured formatting\\n' +\n        '- Note references to other sections without trying to resolve them';\n\n      const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n      const userPrompt =\n        `${chunkLabel} Extract key information from this section of ${url}:` +\n        `${focusLine}\\n\\n${chunk}`;\n\n      const summary = await callExtractionLlm(systemPrompt, userPrompt, 6000, config, signal);\n      if (summary) {\n        log.debug(\n          { url, chunk: index + 1, originalChars: chunk.length, summaryChars: summary.length },\n          'Chunk summarized',\n        );\n      }\n      return { index, summary: summary || null };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      log.warn({ url, chunk: index + 1, error: message }, 'Chunk summarization failed');\n      return { index, summary: null };\n    }\n  });\n\n  const chunkResults = await Promise.all(chunkPromises);\n\n  // Collect successful summaries in order\n  const summaries: string[] = [];\n  for (const { index, summary } of chunkResults.sort((a, b) => a.index - b.index)) {\n    if (summary) {\n      summaries.push(`## Section ${index + 1}\\n${summary}`);\n    }\n  }\n\n  if (summaries.length === 0) {\n    // All chunks failed — fall back to truncated raw content\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    const truncated = content.slice(0, outputCap);\n    return truncated + '\\n\\n[...all chunk summaries failed; showing truncated raw content]';\n  }\n\n  log.info(\n    { url, successfulChunks: summaries.length, totalChunks: chunks.length },\n    'Chunk summaries collected, synthesizing',\n  );\n\n  // Single chunk — return directly\n  if (summaries.length === 1) {\n    const result = summaries[0];\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    return result.length > outputCap\n      ? result.slice(0, outputCap) + '\\n\\n[...truncated]'\n      : result;\n  }\n\n  // Synthesize multiple chunk summaries into one cohesive summary\n  return synthesizeChunkSummaries(summaries, url, instruction, maxLength, config, signal, content.length);\n}\n\nasync function synthesizeChunkSummaries(\n  summaries: string[],\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n  originalContentLength: number,\n): Promise<string> {\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n\n  const systemPrompt =\n    'You synthesize multiple section summaries into one cohesive, comprehensive summary. ' +\n    'Remove redundancy, preserve all key facts and actionable information, ' +\n    'and organize with clear markdown structure.';\n\n  const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n  const combined = summaries.join('\\n\\n---\\n\\n');\n  const userPrompt =\n    `Synthesize these section summaries from ${url} into ONE unified markdown summary ` +\n    `(under ${outputCap} characters):${focusLine}\\n\\n${combined}`;\n\n  try {\n    const synthesized = await callExtractionLlm(systemPrompt, userPrompt, 8000, config, signal);\n\n    if (!synthesized) {\n      // Synthesis LLM returned empty — fall back to concatenation\n      log.warn({ url }, 'Synthesis returned empty, concatenating chunk summaries');\n      const fallback = summaries.join('\\n\\n');\n      return fallback.length > outputCap\n        ? fallback.slice(0, outputCap) + '\\n\\n[...truncated]'\n        : fallback;\n    }\n\n    const finalOutput = synthesized.length > outputCap\n      ? synthesized.slice(0, outputCap) + '\\n\\n[...summary truncated for context management]'\n      : synthesized;\n\n    const compressionRatio = finalOutput.length / originalContentLength;\n    log.info(\n      {\n        url,\n        originalChars: originalContentLength,\n        extractedChars: finalOutput.length,\n        compressionPercent: `${(compressionRatio * 100).toFixed(1)}%`,\n      },\n      'Chunked extraction complete',\n    );\n\n    return finalOutput;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    log.warn({ url, error: message }, 'Synthesis failed, concatenating chunk summaries');\n    const fallback = summaries.join('\\n\\n');\n    return fallback.length > outputCap\n      ? fallback.slice(0, outputCap) + '\\n\\n[...truncated due to synthesis failure]'\n      : fallback;\n  }\n}\n\ntype WebExtractParams = { url: string; instruction?: string; maxLength?: number };\n\nfunction resolveConfiguredMaxLength(): number {\n  return DEFAULT_WEB_EXTRACT_MAX_LENGTH;\n}\n\nexport function createWebExtractTool(deps: WebExtractDeps): AgentTool {\n  return {\n    name: 'web_extract',\n    label: '📄 Web Extract',\n    description:\n      'Extract and summarize content from a web page using LLM-powered extraction.\\n\\n' +\n      'Unlike web_fetch (which returns cleaned plain text from HTML), this tool uses a ' +\n      'dedicated model pass to produce focused markdown. Use when you need semantic extraction ' +\n      'or a specific focus (instruction), not just a single readability pass.\\n\\n' +\n      'WHEN TO USE:\\n' +\n      '- Reading articles, blog posts, documentation\\n' +\n      '- Extracting specific data (pricing, specs, API docs)\\n' +\n      '- Summarizing long pages to save context\\n\\n' +\n      'WHEN TO USE web_fetch INSTEAD:\\n' +\n      '- Inspecting raw-ish page text quickly without an extra LLM call\\n' +\n      '- Downloading JSON/API responses\\n' +\n      '- Debugging page rendering issues',\n    parameters: WebExtractSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{ url: string; extractedLength: number }>> {\n      const { url, instruction } = params as WebExtractParams;\n      const cfg = deps.getConfig();\n      const maxLength = (params as WebExtractParams).maxLength ?? resolveConfiguredMaxLength();\n\n      try {\n        // SSRF protection\n        const safety = checkUrlSafety(url);\n        if (!safety.safe) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${safety.reason}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        // Website blocklist check\n        const blocked = checkWebsiteBlocklist(url, cfg?.tools?.web?.blocklist);\n        if (blocked) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${blocked.message}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const rawContent = await fetchPageContent(url, signal);\n        const cleaned = stripHtmlBoilerplate(rawContent);\n        const trimmed = cleaned.trim();\n        const looksStructured = trimmed.startsWith('{') || trimmed.startsWith('[');\n        if (trimmed.length < 100 && !looksStructured) {\n          return {\n            content: [\n              { type: 'text', text: `Page at ${url} appears to have no extractable content.` },\n            ],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const extracted = await extractWithLlm(\n          cleaned,\n          url,\n          instruction,\n          maxLength,\n          cfg,\n          signal,\n        );\n\n        return {\n          content: [{ type: 'text', text: extracted }],\n          details: { url, extractedLength: extracted.length },\n        };\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        log.warn({ url, error: message }, 'web_extract failed');\n        return {\n          content: [{ type: 'text', text: `Failed to extract content from ${url}: ${message}` }],\n          details: { url, extractedLength: 0 },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/workspace-runtime/registry.d.ts

@@ -4,8 +4,9 @@
  * Previously these four collaborators (`SkillManager`, `SystemPromptBuilder`,
  * `BuiltinMemoryStore`, `MemoryManager`) were created inline inside
  * `AgentManager.getWorkspaceRuntime` and cached in a private Map. They live
- * outside `AgentInstance` because multiple session keys may share a workspace
- * (the runtime is keyed by **resolved workspace path**, not session key).
+ * outside `AgentInstance` because multiple session keys for the same agent may
+ * share a workspace. Memory ownership is agent-scoped, so runtimes are keyed by
+ * both the effective agent id and resolved workspace path.
  *
  * Extracted so:
  *   - `AgentManager` no longer juggles four sibling caches.
@@ -37,16 +38,15 @@ export interface WorkspaceRuntimeRegistryOptions {
 }
 export declare class WorkspaceRuntimeRegistry {
     private readonly runtimes;
+    private readonly notifiedWorkspacePaths;
     private readonly getConfig;
     private readonly bundledSkillsDir;
     private readonly onRuntimeCreated?;
     constructor(opts: WorkspaceRuntimeRegistryOptions);
-    /** Lazily construct (and cache) the runtime for a resolved workspace path. */
-    getOrCreate(resolvedPath: string): WorkspaceRuntime;
+    /** Lazily construct and cache an agent-scoped runtime for a workspace. */
+    getOrCreate(resolvedPath: string, requestedAgentId?: string): WorkspaceRuntime;
     /** Iterate every live workspace runtime (used by skill / config hot-reload). */
     values(): IterableIterator<WorkspaceRuntime>;
-    /** Iterate live workspace runtime entries keyed by resolved workspace path. */
-    entries(): IterableIterator<[string, WorkspaceRuntime]>;
     /**
      * Tear down every runtime (shutdown memory providers) and forget the cache.
      * Used by `AgentManager.updateAgentDefaults` and `AgentManager.dispose`.