@xopcai/xopc 0.0.141 → 0.0.143

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 { 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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"}
+{"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  createComposioTools,\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 composioTools = createComposioTools({\n      getConfig: () => this.deps.getConfig?.(),\n      getCurrentContext: this.deps.getCurrentContext,\n      agentId,\n    });\n    const optionalTools = [imageTool, imageGenerateTool, ...composioTools].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/index.d.ts

@@ -13,7 +13,7 @@ export { findTool, createFindTool, type FindToolInput, type FindToolDetails, } f
 export { createWebSearchTool, createWebFetchTool } from './web.js';
 export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, } from './web-extract.js';
 export { createMessageTool } from './communication.js';
-export { createComposioExecuteTool } from './composio-tool.js';
+export { createComposioTools } from './composio-tool.js';
 export { createSendMediaTool } from './send-media.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';

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

@@ -15,7 +15,7 @@ import { createFindTool, findTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
-import { createComposioExecuteTool } from "./composio-tool.js";
+import { createComposioTools } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -42,4 +42,4 @@ import { createCodeIntelligenceTools } from "../code-intelligence/tools.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createClarifyTool, createCodeIntelligenceTools, createComposioExecuteTool, createCreateShareTool, createCuratedMemoryTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGoalTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createClarifyTool, createCodeIntelligenceTools, createComposioTools, createCreateShareTool, createCuratedMemoryTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGoalTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

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":";;;;;;;gBAM6E;aAGxB;AAErD,MAAM,MAAM,aAAa,sBAAsB;AAE/C,MAAM,oBAAoB;AAE1B,SAAS,oBAAoB,WAAsC;CAEjE,MAAM,MADS,QAAQ,IAAI,2BAA2B,MAAM;AAE5D,KAAI,IACF,KAAI;AACF,SAAO,aAAa,IAAI;UACjB,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK;GAAK,EAAE,+DAA+D;;AAG1F,KAAI;AACF,SAAO,aAAa,qBAAqB;SACnC;AAEN,SAAO,aADG,oBAAoB,aAAa,CACtB,CAAC;;;AAI1B,SAAS,uBAAuB,SAA0B;AACxD,KAAI,OAAO,YAAY,SACrB,QAAO;AAET,KAAI,CAAC,MAAM,QAAQ,QAAQ,CACzB,QAAO;CAET,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,QAAQ,SAAS;AAC1B,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,EAAE,UAAU,MAC3D;EAEF,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,UAAU,OAAO,EAAE,SAAS,SACzC,OAAM,KAAK,EAAE,KAAK;;AAGtB,QAAO,MAAM,KAAK,IAAI;;AAGxB,SAAS,yBAAyB,UAAkC;CAClE,MAAM,QAAkB,EAAE;CAC1B,IAAI,QAAQ;AACZ,MAAK,MAAM,OAAO,UAAU;EAG1B,MAAM,OAAO,GAFA,OAAO,IAAI,QAAQ,UAAU,CAAC,aAEvB,CAAC,IADR,uBAAuB,wBAAwB,IAAI,CACnC;AAC7B,MAAI,QAAQ,KAAK,SAAS,mBAAmB;AAC3C,SAAM,KAAK,gBAAgB;AAC3B;;AAEF,QAAM,KAAK,KAAK;AAChB,WAAS,KAAK,SAAS;;AAEzB,QAAO,MAAM,KAAK,OAAO;;AAG3B,eAAe,iBACb,UACA,OACA,WACA,QACA,SACiB;AACjB,KAAI,SAAS,WAAW,EACtB,QAAO;CAST,MAAM,UAAuB;EAAE,MAAM;EAAQ,SAAS,4DALqB,MAAM;;;EAD/D,yBAAyB,SAIlC;EAEqD,WAAW,KAAK,KAAK;EAAE;CACrF,MAAM,QAAQ,oBAAoB,UAAU;AAE5C,KAAI;EACF,MAAM,SAAS,MAAM,SACnB,OACA,EAAE,UAAU,CAAC,QAAQ,EAAE,EACvB;GACE,WAAW;GACX,aAAa;GACL;GACT,CACF;EAED,IAAI,OAAO;AACX,MAAI,MAAM,QAAQ,OAAO,QAAQ;QAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,SAAQ,OAAQ,EAAwB,QAAQ,GAAG;;AAIzD,SAAO,KAAK,MAAM,IAAI;UACf,KAAK;EACZ,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC5D,MAAI,KACF;GACE;GACA,uBAAuB,SAAS;GAChC,aAAa,MAAM;GACnB,cAAc,SAAS;GACxB,EACD,0CAA0C,SAAS,wBAAwB,aAAa,QAAQ,sBAAsB,KAAK,GAAG,IAAI,MACnI;AACD,SAAO,0BAA0B,IAAI;;;AAIzC,MAAM,sBAAsB,KAAK,OAAO;CACtC,OAAO,KAAK,SACV,KAAK,OAAO,EAAE,aAAa,oEAAoE,CAAC,CACjG;CACD,YAAY,KAAK,SACf,KAAK,MAAM;EACT,KAAK,QAAQ,OAAO;EACpB,KAAK,QAAQ,YAAY;EACzB,KAAK,QAAQ,SAAS;EACtB,KAAK,QAAQ,OAAO;EACpB,KAAK,QAAQ,aAAa;EAC3B,CAAC,CACH;CACD,OAAO,KAAK,SAAS,KAAK,OAAO;EAAE,SAAS;EAAG,SAAS;EAAI,CAAC,CAAC;CAC9D,mBAAmB,KAAK,SACtB,KAAK,OAAO,EAAE,aAAa,0EAA0E,CAAC,CACvG;CACF,CAAC;AAeF,SAAgB,wBAAwB,MAAwC;AAC9E,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,QAC8B;GAC9B,MAAM,IAAI;GACV,MAAM,QAAQ,KAAK,iBAAiB;GACpC,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,SAAS,EAAE,CAAC;GACrD,MAAM,QAAQ,EAAE,OAAO,MAAM,IAAI;AAEjC,OAAI;AACF,QAAI,CAAC,OAAO;KACV,MAAM,SAAS,MAAM,MAAM,KAAK;MAC9B,OAAO,QAAQ;MACf,QAAQ;MACR,WAAW;MACZ,CAAC;KACF,MAAM,QAAQ,OAAO,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO;MACrD,KAAK,EAAE;MACP,MAAM,EAAE;MACR,WAAW,EAAE;MACb,cAAc,EAAE;MAChB,eAAe,EAAE;MAClB,EAAE;AAEH,YAAO;MACL,SAAS,CACP;OACE,MAAM;OACN,MAAM,KAAK,UACT;QAAE,SAAS;QAAM,MAAM;QAAU,SAAS;QAAO,OAAO,OAAO;QAAO,EACtE,MACA,EACD;OACF,CACF;MACD,SAAS;OAAE,MAAM;OAAU;OAAO;MACnC;;IASH,IAAI,WAAU,MANO,MAAM,KAAK;KAC9B,QAAQ;KACR,OAAO,QAAQ;KACf,QAAQ;KACR,WAAW;KACZ,CAAC,EACmB,MAAM,KAAK,UAAU;KAAE,KAAK,KAAK;KAAK,OAAO;KAAG,EAAE;IAEvE,MAAM,UAAU,EAAE,mBAAmB,MAAM,IAAI,KAAK,wBAAwB,IAAI;AAChF,QAAI,QACF,WAAU,QAAQ,QAAQ,MAAM,EAAE,QAAQ,QAAQ;IAGpD,MAAM,MAAM,QAAQ,MAAM,GAAG,MAAM;IAEnC,MAAM,YAAY,MAAM,QAAQ,IAC9B,IAAI,IAAI,OAAO,EAAE,KAAK,YAAY;KAChC,IAAI,WAAW,MAAM,MAAM,KAAK,IAAI;AAEpC,SAAI,EAAE,WACJ,YAAW,SAAS,QAAQ,MAAM,EAAE,SAAS,EAAE,WAAW;AAM5D,YAAO;MAAE,YAAY;MAAK;MAAO,SAAA,MAHX,iBAAiB,UAAU,OAAO,KAAK,WAAW,QAAQ,EAC9E,uBAAuB,KACxB,CAAC;MACwC;MAC1C,CACH;AAED,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,KAAK,UACT;OACE,SAAS;OACT,MAAM;OACN;OACA,SAAS;OACT,OAAO,UAAU;OAClB,EACD,MACA,EACD;MACF,CACF;KACD,SAAS;MAAE;MAAO;MAAW;KAC9B;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,yBAAyB;MAAW,CAAC;KACrE,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN"}
+{"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":";;;;;;;gBAM6E;aAIxB;AAErD,MAAM,MAAM,aAAa,sBAAsB;AAE/C,MAAM,oBAAoB;AAE1B,SAAS,oBAAoB,WAAsC;CAEjE,MAAM,MADS,QAAQ,IAAI,2BAA2B,MAAM;AAE5D,KAAI,IACF,KAAI;AACF,SAAO,aAAa,IAAI;UACjB,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK;GAAK,EAAE,+DAA+D;;AAG1F,KAAI;AACF,SAAO,aAAa,qBAAqB;SACnC;AAEN,SAAO,aADG,oBAAoB,aAAa,CACtB,CAAC;;;AAI1B,SAAS,uBAAuB,SAA0B;AACxD,KAAI,OAAO,YAAY,SACrB,QAAO;AAET,KAAI,CAAC,MAAM,QAAQ,QAAQ,CACzB,QAAO;CAET,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,QAAQ,SAAS;AAC1B,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,EAAE,UAAU,MAC3D;EAEF,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,UAAU,OAAO,EAAE,SAAS,SACzC,OAAM,KAAK,EAAE,KAAK;;AAGtB,QAAO,MAAM,KAAK,IAAI;;AAGxB,SAAS,yBAAyB,UAAkC;CAClE,MAAM,QAAkB,EAAE;CAC1B,IAAI,QAAQ;AACZ,MAAK,MAAM,OAAO,UAAU;EAG1B,MAAM,OAAO,GAFA,OAAO,IAAI,QAAQ,UAAU,CAAC,aAEvB,CAAC,IADR,uBAAuB,wBAAwB,IAAI,CACnC;AAC7B,MAAI,QAAQ,KAAK,SAAS,mBAAmB;AAC3C,SAAM,KAAK,gBAAgB;AAC3B;;AAEF,QAAM,KAAK,KAAK;AAChB,WAAS,KAAK,SAAS;;AAEzB,QAAO,MAAM,KAAK,OAAO;;AAG3B,eAAe,iBACb,UACA,OACA,WACA,QACA,SACiB;AACjB,KAAI,SAAS,WAAW,EACtB,QAAO;CAST,MAAM,UAAuB;EAAE,MAAM;EAAQ,SAAS,4DALqB,MAAM;;;EAD/D,yBAAyB,SAIlC;EAEqD,WAAW,KAAK,KAAK;EAAE;CACrF,MAAM,QAAQ,oBAAoB,UAAU;AAE5C,KAAI;EACF,MAAM,SAAS,MAAM,gCACnB,OACA,EAAE,UAAU,CAAC,QAAQ,EAAE,EACvB;GACE,WAAW;GACX,aAAa;GACL;GACT,CACF;EAED,IAAI,OAAO;AACX,MAAI,MAAM,QAAQ,OAAO,QAAQ;QAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,SAAQ,OAAQ,EAAwB,QAAQ,GAAG;;AAIzD,SAAO,KAAK,MAAM,IAAI;UACf,KAAK;EACZ,MAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC5D,MAAI,KACF;GACE;GACA,uBAAuB,SAAS;GAChC,aAAa,MAAM;GACnB,cAAc,SAAS;GACxB,EACD,0CAA0C,SAAS,wBAAwB,aAAa,QAAQ,sBAAsB,KAAK,GAAG,IAAI,MACnI;AACD,SAAO,0BAA0B,IAAI;;;AAIzC,MAAM,sBAAsB,KAAK,OAAO;CACtC,OAAO,KAAK,SACV,KAAK,OAAO,EAAE,aAAa,oEAAoE,CAAC,CACjG;CACD,YAAY,KAAK,SACf,KAAK,MAAM;EACT,KAAK,QAAQ,OAAO;EACpB,KAAK,QAAQ,YAAY;EACzB,KAAK,QAAQ,SAAS;EACtB,KAAK,QAAQ,OAAO;EACpB,KAAK,QAAQ,aAAa;EAC3B,CAAC,CACH;CACD,OAAO,KAAK,SAAS,KAAK,OAAO;EAAE,SAAS;EAAG,SAAS;EAAI,CAAC,CAAC;CAC9D,mBAAmB,KAAK,SACtB,KAAK,OAAO,EAAE,aAAa,0EAA0E,CAAC,CACvG;CACF,CAAC;AAeF,SAAgB,wBAAwB,MAAwC;AAC9E,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,QAC8B;GAC9B,MAAM,IAAI;GACV,MAAM,QAAQ,KAAK,iBAAiB;GACpC,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,SAAS,EAAE,CAAC;GACrD,MAAM,QAAQ,EAAE,OAAO,MAAM,IAAI;AAEjC,OAAI;AACF,QAAI,CAAC,OAAO;KACV,MAAM,SAAS,MAAM,MAAM,KAAK;MAC9B,OAAO,QAAQ;MACf,QAAQ;MACR,WAAW;MACZ,CAAC;KACF,MAAM,QAAQ,OAAO,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO;MACrD,KAAK,EAAE;MACP,MAAM,EAAE;MACR,WAAW,EAAE;MACb,cAAc,EAAE;MAChB,eAAe,EAAE;MAClB,EAAE;AAEH,YAAO;MACL,SAAS,CACP;OACE,MAAM;OACN,MAAM,KAAK,UACT;QAAE,SAAS;QAAM,MAAM;QAAU,SAAS;QAAO,OAAO,OAAO;QAAO,EACtE,MACA,EACD;OACF,CACF;MACD,SAAS;OAAE,MAAM;OAAU;OAAO;MACnC;;IASH,IAAI,WAAU,MANO,MAAM,KAAK;KAC9B,QAAQ;KACR,OAAO,QAAQ;KACf,QAAQ;KACR,WAAW;KACZ,CAAC,EACmB,MAAM,KAAK,UAAU;KAAE,KAAK,KAAK;KAAK,OAAO;KAAG,EAAE;IAEvE,MAAM,UAAU,EAAE,mBAAmB,MAAM,IAAI,KAAK,wBAAwB,IAAI;AAChF,QAAI,QACF,WAAU,QAAQ,QAAQ,MAAM,EAAE,QAAQ,QAAQ;IAGpD,MAAM,MAAM,QAAQ,MAAM,GAAG,MAAM;IAEnC,MAAM,YAAY,MAAM,QAAQ,IAC9B,IAAI,IAAI,OAAO,EAAE,KAAK,YAAY;KAChC,IAAI,WAAW,MAAM,MAAM,KAAK,IAAI;AAEpC,SAAI,EAAE,WACJ,YAAW,SAAS,QAAQ,MAAM,EAAE,SAAS,EAAE,WAAW;AAM5D,YAAO;MAAE,YAAY;MAAK;MAAO,SAAA,MAHX,iBAAiB,UAAU,OAAO,KAAK,WAAW,QAAQ,EAC9E,uBAAuB,KACxB,CAAC;MACwC;MAC1C,CACH;AAED,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,KAAK,UACT;OACE,SAAS;OACT,MAAM;OACN;OACA,SAAS;OACT,OAAO,UAAU;OAClB,EACD,MACA,EACD;MACF,CACF;KACD,SAAS;MAAE;MAAO;MAAW;KAC9B;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,yBAAyB;MAAW,CAAC;KACrE,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN"}

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":";;;;;;;gBAK6E;aAExB;AAGrD,MAAM,MAAM,aAAa,cAAc;AAEvC,MAAa,iCAAiC;AAC9C,MAAa,qCAAqC;AAClD,MAAM,wBAAwB;AAG9B,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AACxB,MAAM,aAAa;AACnB,MAAM,kBAAkB;AAExB,MAAM,mBAAmB,KAAK,OAAO;CACnC,KAAK,KAAK,OAAO,EAAE,aAAa,+BAA+B,CAAC;CAChE,aAAa,KAAK,SAChB,KAAK,OAAO,EACV,aACE,wKAGH,CAAC,CACH;CACD,WAAW,KAAK,SACd,KAAK,OAAO,EACV,aAAa,+EACd,CAAC,CACH;CACF,CAAC;AAMF,eAAe,iBAAiB,KAAa,QAAuC;CAClF,MAAM,WAAW,MAAM,MAAM,KAAK;EAChC;EACA,SAAS;GACP,cAAc;GACd,QAAQ;GACT;EACD,UAAU;EACX,CAAC;AAEF,KAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,QAAQ,SAAS,OAAO,IAAI,SAAS,aAAa;AAIpE,MADoB,SAAS,QAAQ,IAAI,eAAe,IAAI,IAC5C,SAAS,mBAAmB,EAAE;EAC5C,MAAM,OAAgB,MAAM,SAAS,MAAM;AAC3C,SAAO,KAAK,UAAU,MAAM,MAAM,EAAE;;AAGtC,QAAO,MAAM,SAAS,MAAM;;AAG9B,SAAgB,qBACd,MACA,SAAS,oCACD;CACR,IAAI,UAAU,KACX,QAAQ,+BAA+B,GAAG,CAC1C,QAAQ,6BAA6B,GAAG,CACxC,QAAQ,yBAAyB,GAAG,CACpC,QAAQ,mCAAmC,GAAG,CAC9C,QAAQ,oBAAoB,GAAG;AAGlC,WAAU,kBAAkB,QAAQ;AACpC,WAAU,QAAQ,QAAQ,QAAQ,IAAI,CAAC,MAAM;AAE7C,KAAI,QAAQ,SAAS,OACnB,WAAU,QAAQ,MAAM,GAAG,OAAO,GAAG;AAGvC,QAAO;;AAGT,SAAS,uBAAuB,QAAiB;CAE/C,MAAM,MADS,QAAQ,IAAI,wBAAwB,MAAM;AAGzD,KAAI,IACF,KAAI;AACF,SAAO,aAAa,IAAI;SAClB;CAKV,MAAM,aAAa,oBAAoB,OAAO;AAC9C,KAAI,CAAC,WACH,OAAM,IAAI,MAAM,wDAAwD;AAG1E,QAAO,aAAa,WAAW;;AAGjC,SAAS,4BAA4B,WAA2B;AAC9D,QACE;;;;;;;sBAOuB,UAAU;;;AAUrC,SAAS,mBAAmB,QAA0D;CACpF,MAAM,gBACJ,OAAO,gBAAgB,eAAe,OAAO,YAAY,YAAY,aACjE,YAAY,QAAQ,sBAAsB,GAC1C,KAAA;AACN,KAAI,UAAU,iBAAiB,OAAO,YAAY,QAAQ,WACxD,QAAO,YAAY,IAAI,CAAC,QAAQ,cAAc,CAAC;AAEjD,QAAO,UAAU;;AAGnB,SAAS,0BAA0B,QAAuC;CACxE,IAAI,OAAO;AACX,KAAI,MAAM,QAAQ,OAAO,QAAQ;OAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,SAAQ,OAAQ,EAAwB,QAAQ,GAAG;;AAIzD,QAAO,KAAK,MAAM;;AAGpB,eAAe,kBACb,cACA,YACA,WACA,QACA,QACiB;AAkBjB,QAAO,0BAA0B,MAVZ,gCAPP,uBAAuB,OAQ9B,EACL,EAAE,UAAU,CAAC;EAPb,MAAM;EACN,SAAS,GAAG,aAAa,aAAa;EACtC,WAAW,KAAK,KAAK;EAKD,CAAC,EAAE,EACvB;EACE;EACA,aAAa;EACb,QAAQ,mBAAmB,OAAO;EACnC,CACF,CAEuC;;AAO1C,eAAe,eACb,YACA,KACA,aACA,WACA,QACA,QACiB;CACjB,MAAM,gBAAgB,WAAW;AAGjC,KAAI,gBAAgB,iBAElB,QACE,mCAFc,gBAAgB,KAAW,QAAQ,EAET,CAAC;AAM7C,KAAI,gBAAgB,iBAAiB;AACnC,MAAI,KACF;GAAE;GAAK;GAAe,WAAW;GAAY,EAC7C,oDACD;AACD,SAAO,4BAA4B,YAAY,KAAK,aAAa,WAAW,QAAQ,OAAO;;CAS7F,MAAM,OAAO,MAAM,kBALE,4BAA4B,UAMnC,EALD,cACT,2BAA2B,IAAI,eAAe,YAAY,aAAa,eACvE,4CAA4C,IAAI,eAAe,cAKjE,KAAK,IAAI,KAAK,KAAK,YAAY,EAAE,EAAE,IAAK,EACxC,QACA,OACD;AAED,KAAI,CAAC,KAAM,QAAO;CAElB,MAAM,YAAY,KAAK,IAAI,WAAW,gBAAgB;AACtD,KAAI,KAAK,SAAS,UAChB,QAAO,KAAK,MAAM,GAAG,UAAU,GAAG;AAGpC,KAAI,MACF;EAAE;EAAK,eAAe;EAAe,gBAAgB,KAAK;EAAQ,EAClE,kCACD;AACD,QAAO;;AAST,eAAe,4BACb,SACA,KACA,aACA,WACA,QACA,QACiB;CAEjB,MAAM,SAAmB,EAAE;AAC3B,MAAK,IAAI,SAAS,GAAG,SAAS,QAAQ,QAAQ,UAAU,WACtD,QAAO,KAAK,QAAQ,MAAM,QAAQ,SAAS,WAAW,CAAC;AAEzD,KAAI,KAAK;EAAE;EAAK,YAAY,OAAO;EAAQ,WAAW;EAAY,EAAE,oBAAoB;CAGxF,MAAM,gBAAgB,OAAO,IAAI,OAAO,OAAO,UAAU;EACvD,MAAM,aAAa,UAAU,QAAQ,EAAE,GAAG,OAAO,OAAO;AACxD,MAAI;GAgBF,MAAM,UAAU,MAAM,kBAAkB,seAAc,GAHjD,WAAW,gDAAgD,IAAI,GAFlD,cAAc,YAAY,YAAY,MAAM,GAG/C,MAAM,SAE6C,KAAM,QAAQ,OAAO;AACvF,OAAI,QACF,KAAI,MACF;IAAE;IAAK,OAAO,QAAQ;IAAG,eAAe,MAAM;IAAQ,cAAc,QAAQ;IAAQ,EACpF,mBACD;AAEH,UAAO;IAAE;IAAO,SAAS,WAAW;IAAM;WACnC,OAAO;GACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,OAAI,KAAK;IAAE;IAAK,OAAO,QAAQ;IAAG,OAAO;IAAS,EAAE,6BAA6B;AACjF,UAAO;IAAE;IAAO,SAAS;IAAM;;GAEjC;CAEF,MAAM,eAAe,MAAM,QAAQ,IAAI,cAAc;CAGrD,MAAM,YAAsB,EAAE;AAC9B,MAAK,MAAM,EAAE,OAAO,aAAa,aAAa,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAC7E,KAAI,QACF,WAAU,KAAK,cAAc,QAAQ,EAAE,IAAI,UAAU;AAIzD,KAAI,UAAU,WAAW,GAAG;EAE1B,MAAM,YAAY,KAAK,IAAI,WAAW,gBAAgB;AAEtD,SADkB,QAAQ,MAAM,GAAG,UACnB,GAAG;;AAGrB,KAAI,KACF;EAAE;EAAK,kBAAkB,UAAU;EAAQ,aAAa,OAAO;EAAQ,EACvE,0CACD;AAGD,KAAI,UAAU,WAAW,GAAG;EAC1B,MAAM,SAAS,UAAU;EACzB,MAAM,YAAY,KAAK,IAAI,WAAW,gBAAgB;AACtD,SAAO,OAAO,SAAS,YACnB,OAAO,MAAM,GAAG,UAAU,GAAG,uBAC7B;;AAIN,QAAO,yBAAyB,WAAW,KAAK,aAAa,WAAW,QAAQ,QAAQ,QAAQ,OAAO;;AAGzG,eAAe,yBACb,WACA,KACA,aACA,WACA,QACA,QACA,uBACiB;CACjB,MAAM,YAAY,KAAK,IAAI,WAAW,gBAAgB;CAEtD,MAAM,eACJ;CAMF,MAAM,aACJ,2CAA2C,IAAI,4CACrC,UAAU,eAJJ,cAAc,YAAY,YAAY,MAAM,GAIf,MAH9B,UAAU,KAAK,cAG6B;AAE7D,KAAI;EACF,MAAM,cAAc,MAAM,kBAAkB,cAAc,YAAY,KAAM,QAAQ,OAAO;AAE3F,MAAI,CAAC,aAAa;AAEhB,OAAI,KAAK,EAAE,KAAK,EAAE,0DAA0D;GAC5E,MAAM,WAAW,UAAU,KAAK,OAAO;AACvC,UAAO,SAAS,SAAS,YACrB,SAAS,MAAM,GAAG,UAAU,GAAG,uBAC/B;;EAGN,MAAM,cAAc,YAAY,SAAS,YACrC,YAAY,MAAM,GAAG,UAAU,GAAG,sDAClC;EAEJ,MAAM,mBAAmB,YAAY,SAAS;AAC9C,MAAI,KACF;GACE;GACA,eAAe;GACf,gBAAgB,YAAY;GAC5B,oBAAoB,IAAI,mBAAmB,KAAK,QAAQ,EAAE,CAAC;GAC5D,EACD,8BACD;AAED,SAAO;UACA,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,MAAI,KAAK;GAAE;GAAK,OAAO;GAAS,EAAE,kDAAkD;EACpF,MAAM,WAAW,UAAU,KAAK,OAAO;AACvC,SAAO,SAAS,SAAS,YACrB,SAAS,MAAM,GAAG,UAAU,GAAG,gDAC/B;;;AAMR,SAAS,6BAAqC;AAC5C,QAAO;;AAGT,SAAgB,qBAAqB,MAAiC;AACpE,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EAYF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,QACoE;GACpE,MAAM,EAAE,KAAK,gBAAgB;GAC7B,MAAM,MAAM,KAAK,WAAW;GAC5B,MAAM,YAAa,OAA4B,aAAa,4BAA4B;AAExF,OAAI;IAEF,MAAM,SAAS,eAAe,IAAI;AAClC,QAAI,CAAC,OAAO,KACV,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,YAAY,OAAO;MAAU,CAAC;KAC9D,SAAS;MAAE;MAAK,iBAAiB;MAAG;KACrC;IAIH,MAAM,UAAU,sBAAsB,KAAK,KAAK,OAAO,KAAK,UAAU;AACtE,QAAI,QACF,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,YAAY,QAAQ;MAAW,CAAC;KAChE,SAAS;MAAE;MAAK,iBAAiB;MAAG;KACrC;IAIH,MAAM,UAAU,qBAAqB,MADZ,iBAAiB,KAAK,OAAO,CACN;IAChD,MAAM,UAAU,QAAQ,MAAM;IAC9B,MAAM,kBAAkB,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,IAAI;AAC1E,QAAI,QAAQ,SAAS,OAAO,CAAC,gBAC3B,QAAO;KACL,SAAS,CACP;MAAE,MAAM;MAAQ,MAAM,WAAW,IAAI;MAA2C,CACjF;KACD,SAAS;MAAE;MAAK,iBAAiB;MAAG;KACrC;IAGH,MAAM,YAAY,MAAM,eACtB,SACA,KACA,aACA,WACA,KACA,OACD;AAED,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAW,CAAC;KAC5C,SAAS;MAAE;MAAK,iBAAiB,UAAU;MAAQ;KACpD;YACM,OAAO;IACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,QAAI,KAAK;KAAE;KAAK,OAAO;KAAS,EAAE,qBAAqB;AACvD,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,kCAAkC,IAAI,IAAI;MAAW,CAAC;KACtF,SAAS;MAAE;MAAK,iBAAiB;MAAG;KACrC;;;EAGN"}

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

@@ -6,7 +6,6 @@ import type { WorkflowCatalog } from '../workflow/catalog.js';
 import type { StartWorkflowRunServiceParams, WorkflowRunServiceResult } from '../../workflows/service/workflow-run-service.types.js';
 export type WorkflowToolInput = {
     name?: string;
-    script?: string;
     args?: unknown;
     goal?: string;
     goalId?: string;

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

@@ -1,8 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
-import { parseWorkflowScript } from "../workflow/parser.js";
-import "../workflow/index.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/workflow-tool.ts
 /**
@@ -11,8 +9,7 @@ import { Type } from "@sinclair/typebox";
 init_logger();
 const log = createLogger("Agent:WorkflowTool");
 const WorkflowToolSchema = Type.Object({
-	name: Type.Optional(Type.String({ description: "Name of a saved workflow to run. Either `name` or `script` is required. Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/)." })),
-	script: Type.Optional(Type.String({ description: ["Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.", "First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }."].join(" ") })),
+	name: Type.Optional(Type.String({ description: "Name of a saved visual workflow to run." })),
 	args: Type.Optional(Type.Any({ description: "Optional JSON value passed as workflow input payload." })),
 	goal: Type.Optional(Type.String({ description: "Optional goal or task description for this workflow run (defaults to user intent in chat)." })),
 	goalId: Type.Optional(Type.String({ description: "Optional durable Goal id. When set, terminal workflow output is archived to that Goal." }))
@@ -23,7 +20,7 @@ function createWorkflowTool(deps) {
 		label: "◆ Workflow",
 		description: [
 			"Start a multi-agent workflow run in its own chat session.",
-			"Use `name` for catalog workflows, or `script` for an inline workflow (saved under meta.name before run).",
+			"Use `name` for a workflow from the visual workflow catalog.",
 			"Returns immediately with runId + sessionKey — track progress in the linked chat session."
 		].join(" "),
 		parameters: WorkflowToolSchema,
@@ -115,17 +112,7 @@ function resolveDefinitionId(params, catalog) {
 		catalog.load(name);
 		return name;
 	}
-	if (!params.script?.trim()) throw new Error("either `name` or `script` is required.");
-	const script = normalizeScript(params.script);
-	const meta = parseWorkflowScript(script).meta;
-	catalog.save(meta.name, script);
-	return meta.name;
-}
-function normalizeScript(script) {
-	let text = script.trim();
-	const fence = text.match(/^```(?:js|javascript)?\s*\n([\s\S]*?)\n```$/i);
-	if (fence) text = fence[1].trim();
-	return text;
+	throw new Error("`name` is required. Create workflows in the visual workflow studio.");
 }
 //#endregion
 export { createWorkflowTool };

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

@@ -1 +1 @@
-{"version":3,"file":"workflow-tool.js","names":[],"sources":["../../../../src/agent/tools/workflow-tool.ts"],"sourcesContent":["/**\n * `workflow` — starts a persisted workflow run in a dedicated chat session.\n */\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseWorkflowScript } from '../workflow/index.js';\nimport type { WorkflowCatalog } from '../workflow/catalog.js';\nimport type {\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('Agent:WorkflowTool');\n\nconst WorkflowToolSchema = Type.Object({\n  name: Type.Optional(\n    Type.String({\n      description:\n        'Name of a saved workflow to run. Either `name` or `script` is required. ' +\n        'Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/).',\n    }),\n  ),\n  script: Type.Optional(\n    Type.String({\n      description: [\n        'Raw JavaScript workflow script (no Markdown fences, no TypeScript syntax). Ignored when `name` is set.',\n        \"First statement: export const meta = { name: 'snake_case', description: 'short, human-readable' }.\",\n      ].join(' '),\n    }),\n  ),\n  args: Type.Optional(\n    Type.Any({\n      description: 'Optional JSON value passed as workflow input payload.',\n    }),\n  ),\n  goal: Type.Optional(\n    Type.String({\n      description: 'Optional goal or task description for this workflow run (defaults to user intent in chat).',\n    }),\n  ),\n  goalId: Type.Optional(\n    Type.String({\n      description: 'Optional durable Goal id. When set, terminal workflow output is archived to that Goal.',\n    }),\n  ),\n});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  script?: string;\n  args?: unknown;\n  goal?: string;\n  goalId?: string;\n};\n\nexport interface WorkflowToolDeps {\n  catalog: WorkflowCatalog;\n  getCurrentSessionKey?: () => string | undefined;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;\n}\n\nexport function createWorkflowTool(deps: WorkflowToolDeps): AgentTool {\n  return {\n    name: 'workflow',\n    label: '◆ Workflow',\n    description: [\n      'Start a multi-agent workflow run in its own chat session.',\n      'Use `name` for catalog workflows, or `script` for an inline workflow (saved under meta.name before run).',\n      'Returns immediately with runId + sessionKey — track progress in the linked chat session.',\n    ].join(' '),\n    parameters: WorkflowToolSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: WorkflowToolInput,\n    ): Promise<AgentToolResult<{ runId: string; sessionKey: string } | { error: string }>> {\n      if (!deps.startWorkflowRun) {\n        return {\n          content: [{ type: 'text', text: 'workflow: gateway workflow runs are not available in this context' }],\n          details: { error: 'workflow_run_unavailable' },\n        };\n      }\n\n      let definitionId: string;\n      try {\n        definitionId = resolveDefinitionId(params, deps.catalog);\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n\n      const config = deps.getConfig();\n      const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();\n      const agentId = extractProfileAgentId(parentSessionKey, config);\n\n      const goal = params.goal?.trim() || '';\n      const goalId = params.goalId?.trim();\n      const source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n      const inputEnvelope = goalId\n        ? {\n            payload: params.args ?? {},\n            ...(goal ? { goal } : {}),\n          }\n        : undefined;\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          goalId,\n          input: inputEnvelope ? undefined : params.args,\n          inputEnvelope,\n          parentSessionKey,\n          source,\n        });\n\n        if (result.ok === false) {\n          return {\n            content: [{ type: 'text', text: `workflow: ${result.message}` }],\n            details: { error: result.message },\n          };\n        }\n\n        const summary = goal\n          ? `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open chat session to track progress and continue.`\n          : `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open the workflow chat session to track progress.`;\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `${summary}\\n\\nsessionKey: ${result.sessionKey}`,\n            },\n          ],\n          details: {\n            runId: result.runId,\n            sessionKey: result.sessionKey,\n            definitionId,\n            parentSessionKey: parentSessionKey ?? null,\n          } as { runId: string; sessionKey: string },\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        log.warn({ err: e, errorMessage: message, workflow: definitionId }, `workflow start failed: ${message}`);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as unknown as AgentTool;\n}\n\nfunction resolveDefinitionId(params: WorkflowToolInput, catalog: WorkflowCatalog): string {\n  const name = params.name?.trim();\n  if (name) {\n    catalog.load(name);\n    return name;\n  }\n  if (!params.script?.trim()) {\n    throw new Error('either `name` or `script` is required.');\n  }\n  const script = normalizeScript(params.script);\n  const meta = parseWorkflowScript(script).meta;\n  catalog.save(meta.name, script);\n  return meta.name;\n}\n\nfunction normalizeScript(script: string): string {\n  let text = script.trim();\n  const fence = text.match(/^```(?:js|javascript)?\\s*\\n([\\s\\S]*?)\\n```$/i);\n  if (fence) text = fence[1].trim();\n  return text;\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-tool.js","names":[],"sources":["../../../../src/agent/tools/workflow-tool.ts"],"sourcesContent":["/**\n * `workflow` — starts a persisted workflow run in a dedicated chat session.\n */\n\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { WorkflowCatalog } from '../workflow/catalog.js';\nimport type {\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from '../../workflows/service/workflow-run-service.types.js';\n\nconst log = createLogger('Agent:WorkflowTool');\n\nconst WorkflowToolSchema = Type.Object({\n  name: Type.Optional(\n    Type.String({\n      description:\n        'Name of a saved visual workflow to run.',\n    }),\n  ),\n  args: Type.Optional(\n    Type.Any({\n      description: 'Optional JSON value passed as workflow input payload.',\n    }),\n  ),\n  goal: Type.Optional(\n    Type.String({\n      description: 'Optional goal or task description for this workflow run (defaults to user intent in chat).',\n    }),\n  ),\n  goalId: Type.Optional(\n    Type.String({\n      description: 'Optional durable Goal id. When set, terminal workflow output is archived to that Goal.',\n    }),\n  ),\n});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  args?: unknown;\n  goal?: string;\n  goalId?: string;\n};\n\nexport interface WorkflowToolDeps {\n  catalog: WorkflowCatalog;\n  getCurrentSessionKey?: () => string | undefined;\n  getConfig: () => import('../../config/schema.js').Config | undefined;\n  startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;\n}\n\nexport function createWorkflowTool(deps: WorkflowToolDeps): AgentTool {\n  return {\n    name: 'workflow',\n    label: '◆ Workflow',\n    description: [\n      'Start a multi-agent workflow run in its own chat session.',\n      'Use `name` for a workflow from the visual workflow catalog.',\n      'Returns immediately with runId + sessionKey — track progress in the linked chat session.',\n    ].join(' '),\n    parameters: WorkflowToolSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: WorkflowToolInput,\n    ): Promise<AgentToolResult<{ runId: string; sessionKey: string } | { error: string }>> {\n      if (!deps.startWorkflowRun) {\n        return {\n          content: [{ type: 'text', text: 'workflow: gateway workflow runs are not available in this context' }],\n          details: { error: 'workflow_run_unavailable' },\n        };\n      }\n\n      let definitionId: string;\n      try {\n        definitionId = resolveDefinitionId(params, deps.catalog);\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n\n      const config = deps.getConfig();\n      const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();\n      const agentId = extractProfileAgentId(parentSessionKey, config);\n\n      const goal = params.goal?.trim() || '';\n      const goalId = params.goalId?.trim();\n      const source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n      const inputEnvelope = goalId\n        ? {\n            payload: params.args ?? {},\n            ...(goal ? { goal } : {}),\n          }\n        : undefined;\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          goalId,\n          input: inputEnvelope ? undefined : params.args,\n          inputEnvelope,\n          parentSessionKey,\n          source,\n        });\n\n        if (result.ok === false) {\n          return {\n            content: [{ type: 'text', text: `workflow: ${result.message}` }],\n            details: { error: result.message },\n          };\n        }\n\n        const summary = goal\n          ? `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open chat session to track progress and continue.`\n          : `Started workflow \\`${definitionId}\\` (run ${result.runId}). Open the workflow chat session to track progress.`;\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `${summary}\\n\\nsessionKey: ${result.sessionKey}`,\n            },\n          ],\n          details: {\n            runId: result.runId,\n            sessionKey: result.sessionKey,\n            definitionId,\n            parentSessionKey: parentSessionKey ?? null,\n          } as { runId: string; sessionKey: string },\n        };\n      } catch (e) {\n        const message = e instanceof Error ? e.message : String(e);\n        log.warn({ err: e, errorMessage: message, workflow: definitionId }, `workflow start failed: ${message}`);\n        return {\n          content: [{ type: 'text', text: `workflow: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as unknown as AgentTool;\n}\n\nfunction resolveDefinitionId(params: WorkflowToolInput, catalog: WorkflowCatalog): string {\n  const name = params.name?.trim();\n  if (name) {\n    catalog.load(name);\n    return name;\n  }\n  throw new Error('`name` is required. Create workflows in the visual workflow studio.');\n}\n"],"mappings":";;;;;;;;aAQqD;AAOrD,MAAM,MAAM,aAAa,qBAAqB;AAE9C,MAAM,qBAAqB,KAAK,OAAO;CACrC,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aACE,2CACH,CAAC,CACH;CACD,MAAM,KAAK,SACT,KAAK,IAAI,EACP,aAAa,yDACd,CAAC,CACH;CACD,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aAAa,8FACd,CAAC,CACH;CACD,QAAQ,KAAK,SACX,KAAK,OAAO,EACV,aAAa,0FACd,CAAC,CACH;CACF,CAAC;AAgBF,SAAgB,mBAAmB,MAAmC;AACpE,QAAO;EACL,MAAM;EACN,OAAO;EACP,aAAa;GACX;GACA;GACA;GACD,CAAC,KAAK,IAAI;EACX,YAAY;EAEZ,MAAM,QACJ,aACA,QACqF;AACrF,OAAI,CAAC,KAAK,iBACR,QAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM;KAAqE,CAAC;IACtG,SAAS,EAAE,OAAO,4BAA4B;IAC/C;GAGH,IAAI;AACJ,OAAI;AACF,mBAAe,oBAAoB,QAAQ,KAAK,QAAQ;YACjD,GAAG;IACV,MAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AAC1D,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,aAAa;MAAW,CAAC;KACzD,SAAS,EAAE,OAAO,SAAS;KAC5B;;GAGH,MAAM,SAAS,KAAK,WAAW;GAC/B,MAAM,mBAAmB,KAAK,wBAAwB,EAAE,MAAM;GAC9D,MAAM,UAAU,sBAAsB,kBAAkB,OAAO;GAE/D,MAAM,OAAO,OAAO,MAAM,MAAM,IAAI;GACpC,MAAM,SAAS,OAAO,QAAQ,MAAM;GACpC,MAAM,SAAS,mBACV;IAAE,MAAM;IAAiB,YAAY;IAAkB,GACvD,EAAE,MAAM,OAAgB;GAC7B,MAAM,gBAAgB,SAClB;IACE,SAAS,OAAO,QAAQ,EAAE;IAC1B,GAAI,OAAO,EAAE,MAAM,GAAG,EAAE;IACzB,GACD,KAAA;AAEJ,OAAI;IACF,MAAM,SAAS,MAAM,KAAK,iBAAiB;KACzC;KACA;KACA;KACA;KACA,OAAO,gBAAgB,KAAA,IAAY,OAAO;KAC1C;KACA;KACA;KACD,CAAC;AAEF,QAAI,OAAO,OAAO,MAChB,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,aAAa,OAAO;MAAW,CAAC;KAChE,SAAS,EAAE,OAAO,OAAO,SAAS;KACnC;AAOH,WAAO;KACL,SAAS,CACP;MACE,MAAM;MACN,MAAM,GARI,OACZ,sBAAsB,aAAa,UAAU,OAAO,MAAM,wDAC1D,sBAAsB,aAAa,UAAU,OAAO,MAAM,sDAMvC,kBAAkB,OAAO;MAC3C,CACF;KACD,SAAS;MACP,OAAO,OAAO;MACd,YAAY,OAAO;MACnB;MACA,kBAAkB,oBAAoB;MACvC;KACF;YACM,GAAG;IACV,MAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AAC1D,QAAI,KAAK;KAAE,KAAK;KAAG,cAAc;KAAS,UAAU;KAAc,EAAE,0BAA0B,UAAU;AACxG,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,aAAa;MAAW,CAAC;KACzD,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN;;AAGH,SAAS,oBAAoB,QAA2B,SAAkC;CACxF,MAAM,OAAO,OAAO,MAAM,MAAM;AAChC,KAAI,MAAM;AACR,UAAQ,KAAK,KAAK;AAClB,SAAO;;AAET,OAAM,IAAI,MAAM,sEAAsE"}

package/dist/src/agent/workflow/builtins/index.d.ts

@@ -1,28 +1,2 @@
-/**
- * Bundled workflow templates. These are shipped with xopc and discoverable
- * via the catalog alongside user workflows in `~/.xopc/workflows/`. A user
- * workflow with the same `name` always wins — built-ins are starting points,
- * not authority.
- */
-import { AUDIT_REPO_SCRIPT } from './audit-repo.js';
-import { CLIENT_PROPOSAL_SCRIPT } from './client-proposal.js';
-import { COMPETITOR_SCAN_SCRIPT } from './competitor-scan.js';
-import { CONTENT_DRAFT_SCRIPT } from './content-draft.js';
-import { CONTENT_REPURPOSE_SCRIPT } from './content-repurpose.js';
-import { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';
-import { DECISION_COMPARE_SCRIPT } from './decision-compare.js';
-import { IMPLEMENTATION_PLAN_SCRIPT } from './implementation-plan.js';
-import { INBOX_TRIAGE_SCRIPT } from './inbox-triage.js';
-import { MEETING_PREP_SCRIPT } from './meeting-prep.js';
-import { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';
-import { OFFER_DESIGN_SCRIPT } from './offer-design.js';
-import { PR_REVIEW_SCRIPT } from './pr-review.js';
-import { RELEASE_CHECK_SCRIPT } from './release-check.js';
-import { RESEARCH_SCRIPT } from './research.js';
-import { WEEKLY_REVIEW_SCRIPT } from './weekly-review.js';
-export interface BuiltinWorkflow {
-    name: string;
-    script: string;
-}
-export declare const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[];
-export { AUDIT_REPO_SCRIPT, CLIENT_PROPOSAL_SCRIPT, COMPETITOR_SCAN_SCRIPT, CONTENT_DRAFT_SCRIPT, CONTENT_REPURPOSE_SCRIPT, DEBUG_INCIDENT_SCRIPT, DECISION_COMPARE_SCRIPT, IMPLEMENTATION_PLAN_SCRIPT, INBOX_TRIAGE_SCRIPT, MEETING_PREP_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, OFFER_DESIGN_SCRIPT, PR_REVIEW_SCRIPT, RELEASE_CHECK_SCRIPT, RESEARCH_SCRIPT, WEEKLY_REVIEW_SCRIPT, };
+import type { WorkflowDefinition } from '../../../workflows/domain/definition.js';
+export declare const BUILTIN_WORKFLOWS: readonly WorkflowDefinition[];