@xopcai/xopc 0.0.93 → 0.0.95

package/dist/src/agent/tools/browser/tool/browser-use-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-use-tool.js","names":[],"sources":["../../../../../../src/agent/tools/browser/tool/browser-use-tool.ts"],"sourcesContent":["/**\n * browser_use — unified browser AgentTool.\n *\n * Modes: command | pipeline | inspect | close.\n * Replaces the 14 fine-grained browser_* tools with a single entry point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../../../utils/logger.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { BrowserManager } from '../../../../browser/manager.js';\nimport type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';\nimport type { Page } from 'playwright-core';\n\nimport { BrowserUseSchema } from './schemas.js';\nimport { createBrowserActionRegistry } from '../../../../browser/actions/registry.js';\nimport type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';\nimport { loadBrowserPipelineSource } from '../../../../browser/pipeline/source.js';\nimport type { BrowserNotReadyError, BrowserSetupHint } from '../../../../browser/readiness.js';\n\nconst log = createLogger('browser_use');\n\nexport interface CreateBrowserUseToolDeps {\n  getManager: () => BrowserManager;\n  getPageForTask: () => Promise<Page>;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n  getSupervisor?: () => CdpSupervisor | undefined;\n  notifyBrowserPageClosed?: (taskId: string) => void;\n  /**\n   * Preflight readiness check. Returns `null` when the configured backend is\n   * usable, otherwise a structured hint the chat surface renders as a setup\n   * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.\n   */\n  getReadiness?: () => Promise<BrowserNotReadyError | null>;\n  /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */\n  runPipeline?: (yaml: string, args: Record<string, unknown>, ctx: BrowserActionContext, dryRun: boolean) => Promise<BrowserActionResult>;\n}\n\nexport function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any> {\n  const registry = createBrowserActionRegistry();\n\n  function buildContext(page: Page, signal?: AbortSignal): BrowserActionContext {\n    return {\n      page,\n      manager: deps.getManager(),\n      config: deps.getConfig(),\n      taskId: deps.getTaskId(),\n      supervisor: deps.getSupervisor?.(),\n      signal,\n    };\n  }\n\n  /**\n   * Render a {@link BrowserSetupHint} as a tool result. The text body is a\n   * JSON envelope (`kind: 'browser_setup_required'`) so the chat surface can\n   * detect it and render a Setup card; the embedded `message` keeps the\n   * payload human-readable for the LLM so it stops the browser attempt and\n   * tells the user to finish setup.\n   */\n  function formatNotReady(hint: BrowserSetupHint): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    const message =\n      `⚠ Browser is not ready (backend=${hint.backend}, reason=${hint.reason}). ` +\n      `Do NOT retry. Tell the user to open Settings → Browser to finish setup, ` +\n      `then ask them to confirm before running any browser action again.`;\n    const payload = {\n      kind: 'browser_setup_required' as const,\n      backend: hint.backend,\n      reason: hint.reason,\n      deepLink: hint.deepLink,\n      detail: hint.detail,\n      message,\n    };\n    return {\n      content: [{ type: 'text', text: JSON.stringify(payload) }],\n      details: {\n        ok: false,\n        kind: 'browser_setup_required',\n        backend: hint.backend,\n        reason: hint.reason,\n        deepLink: hint.deepLink,\n      },\n    };\n  }\n\n  function formatResult(result: BrowserActionResult): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    if (result.ok) {\n      const parts: string[] = [];\n      if (result.text) parts.push(result.text);\n      if (result.data && !result.text) parts.push(JSON.stringify(result.data, null, 2));\n      return {\n        content: [{ type: 'text', text: parts.join('\\n') || 'OK' }],\n        details: { ok: true, action: result.action, ...(result.artifacts?.length ? { artifacts: result.artifacts.length } : {}) },\n      };\n    }\n    const parts: string[] = [];\n    if (result.error) parts.push(`[${result.error.code}] ${result.error.message}`);\n    if (result.diagnostics?.url) parts.push(`URL: ${result.diagnostics.url}`);\n    if (result.diagnostics?.snapshot) parts.push(`Snapshot: ${result.diagnostics.snapshot.slice(0, 2000)}`);\n    return {\n      content: [{ type: 'text', text: parts.join('\\n') || 'Failed' }],\n      details: { ok: false, action: result.action, error: result.error },\n    };\n  }\n\n  const tool: any = {\n    name: 'browser_use',\n    label: '🌐 Browser',\n    description:\n      'Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the \"browser\" skill first with skill_view.',\n    parameters: BrowserUseSchema,\n\n    async execute(_toolCallId, params: any, signal, _onUpdate) {\n      const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params as {\n        mode: string;\n        command?: string;\n        args?: Record<string, unknown>;\n        pipeline?: { yaml?: string; script?: string; path?: string; args?: Record<string, unknown>; dryRun?: boolean };\n        options?: { timeout?: number; headless?: boolean };\n      };\n\n      // ─── readiness preflight ────────────────────────────────────────────\n      // Probes the configured backend (doctor + WS bridge / CDP / cloud key)\n      // before any launch attempt. On failure we short-circuit with a setup\n      // hint the chat renders as a card — the agent should stop and ask the\n      // user to finish setup instead of looping on launch errors.\n      if (deps.getReadiness) {\n        try {\n          const notReady = await deps.getReadiness();\n          if (notReady) {\n            return formatNotReady(notReady.hint);\n          }\n        } catch (e) {\n          log.warn({ err: e }, 'Readiness preflight threw; continuing with launch attempt');\n        }\n      }\n\n      // ─── inspect ────────────────────────────────────────────────────────\n      if (mode === 'inspect') {\n        const mgr = deps.getManager();\n        await mgr.ensureConnected();\n        const ext = mgr.getExtensionProvider();\n        if (ext) {\n          const timeout = deps.getConfig?.()?.agents?.defaults?.browser?.commandTimeout;\n          const timeoutMs =\n            typeof timeout === 'number' && Number.isFinite(timeout) && timeout > 0\n              ? Math.floor(timeout * 1000)\n              : 30_000;\n          const urlRes = await ext.sendCommand('get_url', {}, { timeout: timeoutMs });\n          const titleRes = await ext.sendCommand('get_title', {}, { timeout: timeoutMs });\n          const snapRes = await ext.sendCommand('snapshot', {}, { timeout: timeoutMs });\n          const url = urlRes.ok && urlRes.data ? String((urlRes.data as { url?: string }).url ?? '') : '';\n          const title =\n            titleRes.ok && titleRes.data ? String((titleRes.data as { title?: string }).title ?? '') : '';\n          let snapText = '';\n          if (snapRes.ok && snapRes.data) {\n            const nodes = (snapRes.data as { nodes?: Array<{ role?: string; name?: string }> }).nodes ?? [];\n            snapText = nodes.map((n) => `${n.role ?? '?'}: ${n.name ?? ''}`).join('\\n');\n            if (snapText.length > 8000) snapText = `${snapText.slice(0, 8000)}\\n... (truncated)`;\n          }\n          const text = `URL: ${url}\\nTitle: ${title}\\n${snapText ? `--- Page Snapshot ---\\n${snapText}` : ''}`;\n          return {\n            content: [{ type: 'text', text }],\n            details: { ok: true, mode: 'inspect', url, title },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const result = await registry.execute('state', ctx, {});\n        // Augment with URL / title\n        const url = page.url();\n        const title = await page.title().catch(() => '');\n        const text = `URL: ${url}\\nTitle: ${title}\\n${result.text ?? ''}`;\n        return {\n          content: [{ type: 'text', text }],\n          details: { ok: true, mode: 'inspect', url, title },\n        };\n      }\n\n      // ─── close ──────────────────────────────────────────────────────────\n      if (mode === 'close') {\n        const taskId = deps.getTaskId();\n        await deps.getManager().ensureConnected();\n        await deps.getManager().closePage(taskId);\n        deps.notifyBrowserPageClosed?.(taskId);\n        return {\n          content: [{ type: 'text', text: 'Browser page closed.' }],\n          details: { ok: true, mode: 'close' },\n        };\n      }\n\n      // ─── command ────────────────────────────────────────────────────────\n      if (mode === 'command') {\n        if (!command) {\n          return {\n            content: [{ type: 'text', text: 'Missing `command` parameter for command mode.' }],\n            details: { ok: false, mode: 'command' },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const args = cmdArgs ?? {};\n        const result = await registry.execute(command, ctx, args);\n        return formatResult(result);\n      }\n\n      // ─── pipeline ──────────────────────────────────────────────────────\n      if (mode === 'pipeline') {\n        if (!pipelineParams) {\n          return {\n            content: [{ type: 'text', text: 'Missing `pipeline` parameter for pipeline mode.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        // Resolve YAML source\n        let yamlSource = pipelineParams.yaml ?? pipelineParams.script ?? '';\n\n        if (!yamlSource && pipelineParams.path) {\n          try {\n            yamlSource = (await loadBrowserPipelineSource(pipelineParams.path)).source;\n          } catch (e) {\n            const msg = e instanceof Error ? e.message : String(e);\n            return {\n              content: [{ type: 'text', text: `Failed to read pipeline source: ${msg}` }],\n              details: { ok: false, mode: 'pipeline', error: msg },\n            };\n          }\n        }\n\n        if (!yamlSource) {\n          return {\n            content: [{ type: 'text', text: 'Pipeline mode requires `yaml`, `script`, or `path`.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        const pipelineArgs = (pipelineParams.args as Record<string, unknown>) ?? {};\n        const dryRun = pipelineParams.dryRun === true;\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n\n        // Use injected runner or lazy-load\n        if (deps.runPipeline) {\n          const result = await deps.runPipeline(yamlSource, pipelineArgs, ctx, dryRun);\n          return formatResult(result);\n        }\n\n        // Lazy import pipeline runner\n        try {\n          const { runBrowserPipeline } = await import('../../../../browser/pipeline/runner.js');\n          const result = await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, dryRun);\n          return formatResult(result);\n        } catch (e) {\n          const msg = e instanceof Error ? e.message : String(e);\n          log.error({ err: e }, `Pipeline execution failed: ${msg}`);\n          return {\n            content: [{ type: 'text', text: `Pipeline failed: ${msg}` }],\n            details: { ok: false, mode: 'pipeline', error: msg },\n          };\n        }\n      }\n\n      return {\n        content: [{ type: 'text', text: `Unknown mode: ${mode}` }],\n        details: { ok: false },\n      };\n    },\n  };\n  return tool;\n}\n"],"mappings":"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"}
+{"version":3,"file":"browser-use-tool.js","names":[],"sources":["../../../../../../src/agent/tools/browser/tool/browser-use-tool.ts"],"sourcesContent":["/**\n * browser_use — unified browser AgentTool.\n *\n * Modes: command | pipeline | inspect | close.\n * Replaces the 14 fine-grained browser_* tools with a single entry point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../../../utils/logger.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { BrowserManager } from '../../../../browser/manager.js';\nimport type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';\nimport type { Page } from 'playwright-core';\n\nimport { BrowserUseSchema } from './schemas.js';\nimport { createBrowserActionRegistry } from '../../../../browser/actions/registry.js';\nimport type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';\nimport { loadBrowserPipelineSource } from '../../../../browser/pipeline/source.js';\nimport type { BrowserNotReadyError, BrowserSetupHint } from '../../../../browser/readiness.js';\n\nconst log = createLogger('Agent:BrowserUse');\n\nexport interface CreateBrowserUseToolDeps {\n  getManager: () => BrowserManager;\n  getPageForTask: () => Promise<Page>;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n  getSupervisor?: () => CdpSupervisor | undefined;\n  notifyBrowserPageClosed?: (taskId: string) => void;\n  /**\n   * Preflight readiness check. Returns `null` when the configured backend is\n   * usable, otherwise a structured hint the chat surface renders as a setup\n   * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.\n   */\n  getReadiness?: () => Promise<BrowserNotReadyError | null>;\n  /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */\n  runPipeline?: (yaml: string, args: Record<string, unknown>, ctx: BrowserActionContext, dryRun: boolean) => Promise<BrowserActionResult>;\n}\n\nexport function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any> {\n  const registry = createBrowserActionRegistry();\n\n  function buildContext(page: Page, signal?: AbortSignal): BrowserActionContext {\n    return {\n      page,\n      manager: deps.getManager(),\n      config: deps.getConfig(),\n      taskId: deps.getTaskId(),\n      supervisor: deps.getSupervisor?.(),\n      signal,\n    };\n  }\n\n  /**\n   * Render a {@link BrowserSetupHint} as a tool result. The text body is a\n   * JSON envelope (`kind: 'browser_setup_required'`) so the chat surface can\n   * detect it and render a Setup card; the embedded `message` keeps the\n   * payload human-readable for the LLM so it stops the browser attempt and\n   * tells the user to finish setup.\n   */\n  function formatNotReady(hint: BrowserSetupHint): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    const message =\n      `⚠ Browser is not ready (backend=${hint.backend}, reason=${hint.reason}). ` +\n      `Do NOT retry. Tell the user to open Settings → Browser to finish setup, ` +\n      `then ask them to confirm before running any browser action again.`;\n    const payload = {\n      kind: 'browser_setup_required' as const,\n      backend: hint.backend,\n      reason: hint.reason,\n      deepLink: hint.deepLink,\n      detail: hint.detail,\n      message,\n    };\n    return {\n      content: [{ type: 'text', text: JSON.stringify(payload) }],\n      details: {\n        ok: false,\n        kind: 'browser_setup_required',\n        backend: hint.backend,\n        reason: hint.reason,\n        deepLink: hint.deepLink,\n      },\n    };\n  }\n\n  function formatResult(result: BrowserActionResult): { content: { type: 'text'; text: string }[]; details: Record<string, unknown> } {\n    if (result.ok) {\n      const parts: string[] = [];\n      if (result.text) parts.push(result.text);\n      if (result.data && !result.text) parts.push(JSON.stringify(result.data, null, 2));\n      return {\n        content: [{ type: 'text', text: parts.join('\\n') || 'OK' }],\n        details: { ok: true, action: result.action, ...(result.artifacts?.length ? { artifacts: result.artifacts.length } : {}) },\n      };\n    }\n    const parts: string[] = [];\n    if (result.error) parts.push(`[${result.error.code}] ${result.error.message}`);\n    if (result.diagnostics?.url) parts.push(`URL: ${result.diagnostics.url}`);\n    if (result.diagnostics?.snapshot) parts.push(`Snapshot: ${result.diagnostics.snapshot.slice(0, 2000)}`);\n    return {\n      content: [{ type: 'text', text: parts.join('\\n') || 'Failed' }],\n      details: { ok: false, action: result.action, error: result.error },\n    };\n  }\n\n  const tool: any = {\n    name: 'browser_use',\n    label: '🌐 Browser',\n    description:\n      'Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the \"browser\" skill first with skill_view.',\n    parameters: BrowserUseSchema,\n\n    async execute(_toolCallId, params: any, signal, _onUpdate) {\n      const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params as {\n        mode: string;\n        command?: string;\n        args?: Record<string, unknown>;\n        pipeline?: { yaml?: string; script?: string; path?: string; args?: Record<string, unknown>; dryRun?: boolean };\n        options?: { timeout?: number; headless?: boolean };\n      };\n\n      // ─── readiness preflight ────────────────────────────────────────────\n      // Probes the configured backend (doctor + WS bridge / CDP / cloud key)\n      // before any launch attempt. On failure we short-circuit with a setup\n      // hint the chat renders as a card — the agent should stop and ask the\n      // user to finish setup instead of looping on launch errors.\n      if (deps.getReadiness) {\n        try {\n          const notReady = await deps.getReadiness();\n          if (notReady) {\n            return formatNotReady(notReady.hint);\n          }\n        } catch (e) {\n          log.warn({ err: e }, 'Readiness preflight threw; continuing with launch attempt');\n        }\n      }\n\n      // ─── inspect ────────────────────────────────────────────────────────\n      if (mode === 'inspect') {\n        const mgr = deps.getManager();\n        await mgr.ensureConnected();\n        const ext = mgr.getExtensionProvider();\n        if (ext) {\n          const timeout = deps.getConfig?.()?.agents?.defaults?.browser?.commandTimeout;\n          const timeoutMs =\n            typeof timeout === 'number' && Number.isFinite(timeout) && timeout > 0\n              ? Math.floor(timeout * 1000)\n              : 30_000;\n          const urlRes = await ext.sendCommand('get_url', {}, { timeout: timeoutMs });\n          const titleRes = await ext.sendCommand('get_title', {}, { timeout: timeoutMs });\n          const snapRes = await ext.sendCommand('snapshot', {}, { timeout: timeoutMs });\n          const url = urlRes.ok && urlRes.data ? String((urlRes.data as { url?: string }).url ?? '') : '';\n          const title =\n            titleRes.ok && titleRes.data ? String((titleRes.data as { title?: string }).title ?? '') : '';\n          let snapText = '';\n          if (snapRes.ok && snapRes.data) {\n            const nodes = (snapRes.data as { nodes?: Array<{ role?: string; name?: string }> }).nodes ?? [];\n            snapText = nodes.map((n) => `${n.role ?? '?'}: ${n.name ?? ''}`).join('\\n');\n            if (snapText.length > 8000) snapText = `${snapText.slice(0, 8000)}\\n... (truncated)`;\n          }\n          const text = `URL: ${url}\\nTitle: ${title}\\n${snapText ? `--- Page Snapshot ---\\n${snapText}` : ''}`;\n          return {\n            content: [{ type: 'text', text }],\n            details: { ok: true, mode: 'inspect', url, title },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const result = await registry.execute('state', ctx, {});\n        // Augment with URL / title\n        const url = page.url();\n        const title = await page.title().catch(() => '');\n        const text = `URL: ${url}\\nTitle: ${title}\\n${result.text ?? ''}`;\n        return {\n          content: [{ type: 'text', text }],\n          details: { ok: true, mode: 'inspect', url, title },\n        };\n      }\n\n      // ─── close ──────────────────────────────────────────────────────────\n      if (mode === 'close') {\n        const taskId = deps.getTaskId();\n        await deps.getManager().ensureConnected();\n        await deps.getManager().closePage(taskId);\n        deps.notifyBrowserPageClosed?.(taskId);\n        return {\n          content: [{ type: 'text', text: 'Browser page closed.' }],\n          details: { ok: true, mode: 'close' },\n        };\n      }\n\n      // ─── command ────────────────────────────────────────────────────────\n      if (mode === 'command') {\n        if (!command) {\n          return {\n            content: [{ type: 'text', text: 'Missing `command` parameter for command mode.' }],\n            details: { ok: false, mode: 'command' },\n          };\n        }\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n        const args = cmdArgs ?? {};\n        const result = await registry.execute(command, ctx, args);\n        return formatResult(result);\n      }\n\n      // ─── pipeline ──────────────────────────────────────────────────────\n      if (mode === 'pipeline') {\n        if (!pipelineParams) {\n          return {\n            content: [{ type: 'text', text: 'Missing `pipeline` parameter for pipeline mode.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        // Resolve YAML source\n        let yamlSource = pipelineParams.yaml ?? pipelineParams.script ?? '';\n\n        if (!yamlSource && pipelineParams.path) {\n          try {\n            yamlSource = (await loadBrowserPipelineSource(pipelineParams.path)).source;\n          } catch (e) {\n            const msg = e instanceof Error ? e.message : String(e);\n            return {\n              content: [{ type: 'text', text: `Failed to read pipeline source: ${msg}` }],\n              details: { ok: false, mode: 'pipeline', error: msg },\n            };\n          }\n        }\n\n        if (!yamlSource) {\n          return {\n            content: [{ type: 'text', text: 'Pipeline mode requires `yaml`, `script`, or `path`.' }],\n            details: { ok: false, mode: 'pipeline' },\n          };\n        }\n\n        const pipelineArgs = (pipelineParams.args as Record<string, unknown>) ?? {};\n        const dryRun = pipelineParams.dryRun === true;\n        const page = await deps.getPageForTask();\n        const ctx = buildContext(page, signal);\n\n        // Use injected runner or lazy-load\n        if (deps.runPipeline) {\n          const result = await deps.runPipeline(yamlSource, pipelineArgs, ctx, dryRun);\n          return formatResult(result);\n        }\n\n        // Lazy import pipeline runner\n        try {\n          const { runBrowserPipeline } = await import('../../../../browser/pipeline/runner.js');\n          const result = await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, dryRun);\n          return formatResult(result);\n        } catch (e) {\n          const msg = e instanceof Error ? e.message : String(e);\n          log.error({ err: e }, `Pipeline execution failed: ${msg}`);\n          return {\n            content: [{ type: 'text', text: `Pipeline failed: ${msg}` }],\n            details: { ok: false, mode: 'pipeline', error: msg },\n          };\n        }\n      }\n\n      return {\n        content: [{ type: 'text', text: `Unknown mode: ${mode}` }],\n        details: { ok: false },\n      };\n    },\n  };\n  return tool;\n}\n"],"mappings":"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"}

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

@@ -3,8 +3,8 @@ import { init_logger } from "../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
 import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
 init_logger();

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

@@ -1,6 +1,6 @@
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createEditFileTool } from "./edit.js";

package/dist/src/agent/tools/image-generate-tool.js

@@ -4,9 +4,9 @@ import { isFailoverError } from "../failover-error.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
 import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
+import path from "node:path";
 import { randomBytes } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/image-generate-tool.ts
 const DEFAULT_COUNT = 1;

package/dist/src/agent/tools/search/registry.js

@@ -8,7 +8,7 @@ import { DuckDuckGoHtmlProvider } from "./providers/duckduckgo-html.js";
 import { SearXNGProvider } from "./providers/searxng.js";
 //#region src/agent/tools/search/registry.ts
 init_logger();
-const log = createLogger("web-search");
+const log = createLogger("Agent:WebSearch");
 var SearchProviderRegistry = class {
 	providers;
 	fallbackProvider;

package/dist/src/agent/tools/search/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../../../../src/agent/tools/search/registry.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { ResolvedWebSearchConfig, SearchProvider, SearchResult } from './types.js';\nimport { BraveProvider } from './providers/brave.js';\nimport { TavilyProvider } from './providers/tavily.js';\nimport { BingApiProvider } from './providers/bing-api.js';\nimport { BingHtmlProvider } from './providers/bing-html.js';\nimport { DuckDuckGoHtmlProvider } from './providers/duckduckgo-html.js';\nimport { SearXNGProvider } from './providers/searxng.js';\n\nconst log = createLogger('web-search');\n\nexport class SearchProviderRegistry {\n  private readonly providers: SearchProvider[];\n  private readonly fallbackProvider: SearchProvider;\n\n  constructor(config: ResolvedWebSearchConfig) {\n    this.providers = this.buildProviders(config);\n    this.fallbackProvider =\n      config.region === 'cn' ? new BingHtmlProvider() : new DuckDuckGoHtmlProvider();\n    log.debug(\n      { region: config.region, configuredCount: this.providers.filter((p) => p.isAvailable()).length },\n      'Web search registry ready',\n    );\n  }\n\n  private buildProviders(config: ResolvedWebSearchConfig): SearchProvider[] {\n    const list: SearchProvider[] = [];\n\n    for (const p of config.providers) {\n      if (p.disabled) continue;\n      switch (p.type) {\n        case 'brave':\n          list.push(new BraveProvider(p.apiKey ?? ''));\n          break;\n        case 'tavily':\n          list.push(new TavilyProvider(p.apiKey ?? ''));\n          break;\n        case 'bing':\n          list.push(new BingApiProvider(p.apiKey ?? ''));\n          break;\n        case 'searxng':\n          list.push(new SearXNGProvider(p.url ?? ''));\n          break;\n        default:\n          break;\n      }\n    }\n\n    return list;\n  }\n\n  hasConfiguredApiProvider(): boolean {\n    return this.providers.some((p) => p.isAvailable());\n  }\n\n  async search(\n    query: string,\n    count: number,\n    signal?: AbortSignal,\n  ): Promise<{ results: SearchResult[]; provider: string }> {\n    for (const provider of this.providers) {\n      if (!provider.isAvailable()) continue;\n      try {\n        const results = await provider.search(query, count, signal);\n        return { results, provider: provider.name };\n      } catch (err) {\n        log.debug({ provider: provider.name, err }, 'Search provider failed, trying next');\n      }\n    }\n\n    try {\n      const results = await this.fallbackProvider.search(query, count, signal);\n      return { results, provider: this.fallbackProvider.name };\n    } catch (err) {\n      log.warn({ err }, 'HTML fallback search failed');\n      return { results: [], provider: 'none' };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;aAAwD;AASxD,MAAM,MAAM,aAAa,aAAa;AAEtC,IAAa,yBAAb,MAAoC;CAClC;CACA;CAEA,YAAY,QAAiC;AAC3C,OAAK,YAAY,KAAK,eAAe,OAAO;AAC5C,OAAK,mBACH,OAAO,WAAW,OAAO,IAAI,kBAAkB,GAAG,IAAI,wBAAwB;AAChF,MAAI,MACF;GAAE,QAAQ,OAAO;GAAQ,iBAAiB,KAAK,UAAU,QAAQ,MAAM,EAAE,aAAa,CAAC,CAAC;GAAQ,EAChG,4BACD;;CAGH,eAAuB,QAAmD;EACxE,MAAM,OAAyB,EAAE;AAEjC,OAAK,MAAM,KAAK,OAAO,WAAW;AAChC,OAAI,EAAE,SAAU;AAChB,WAAQ,EAAE,MAAV;IACE,KAAK;AACH,UAAK,KAAK,IAAI,cAAc,EAAE,UAAU,GAAG,CAAC;AAC5C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,eAAe,EAAE,UAAU,GAAG,CAAC;AAC7C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,UAAU,GAAG,CAAC;AAC9C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,OAAO,GAAG,CAAC;AAC3C;IACF,QACE;;;AAIN,SAAO;;CAGT,2BAAoC;AAClC,SAAO,KAAK,UAAU,MAAM,MAAM,EAAE,aAAa,CAAC;;CAGpD,MAAM,OACJ,OACA,OACA,QACwD;AACxD,OAAK,MAAM,YAAY,KAAK,WAAW;AACrC,OAAI,CAAC,SAAS,aAAa,CAAE;AAC7B,OAAI;AAEF,WAAO;KAAE,SAAA,MADa,SAAS,OAAO,OAAO,OAAO,OAAO;KACzC,UAAU,SAAS;KAAM;YACpC,KAAK;AACZ,QAAI,MAAM;KAAE,UAAU,SAAS;KAAM;KAAK,EAAE,sCAAsC;;;AAItF,MAAI;AAEF,UAAO;IAAE,SAAA,MADa,KAAK,iBAAiB,OAAO,OAAO,OAAO,OAAO;IACtD,UAAU,KAAK,iBAAiB;IAAM;WACjD,KAAK;AACZ,OAAI,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAChD,UAAO;IAAE,SAAS,EAAE;IAAE,UAAU;IAAQ"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../../src/agent/tools/search/registry.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { ResolvedWebSearchConfig, SearchProvider, SearchResult } from './types.js';\nimport { BraveProvider } from './providers/brave.js';\nimport { TavilyProvider } from './providers/tavily.js';\nimport { BingApiProvider } from './providers/bing-api.js';\nimport { BingHtmlProvider } from './providers/bing-html.js';\nimport { DuckDuckGoHtmlProvider } from './providers/duckduckgo-html.js';\nimport { SearXNGProvider } from './providers/searxng.js';\n\nconst log = createLogger('Agent:WebSearch');\n\nexport class SearchProviderRegistry {\n  private readonly providers: SearchProvider[];\n  private readonly fallbackProvider: SearchProvider;\n\n  constructor(config: ResolvedWebSearchConfig) {\n    this.providers = this.buildProviders(config);\n    this.fallbackProvider =\n      config.region === 'cn' ? new BingHtmlProvider() : new DuckDuckGoHtmlProvider();\n    log.debug(\n      { region: config.region, configuredCount: this.providers.filter((p) => p.isAvailable()).length },\n      'Web search registry ready',\n    );\n  }\n\n  private buildProviders(config: ResolvedWebSearchConfig): SearchProvider[] {\n    const list: SearchProvider[] = [];\n\n    for (const p of config.providers) {\n      if (p.disabled) continue;\n      switch (p.type) {\n        case 'brave':\n          list.push(new BraveProvider(p.apiKey ?? ''));\n          break;\n        case 'tavily':\n          list.push(new TavilyProvider(p.apiKey ?? ''));\n          break;\n        case 'bing':\n          list.push(new BingApiProvider(p.apiKey ?? ''));\n          break;\n        case 'searxng':\n          list.push(new SearXNGProvider(p.url ?? ''));\n          break;\n        default:\n          break;\n      }\n    }\n\n    return list;\n  }\n\n  hasConfiguredApiProvider(): boolean {\n    return this.providers.some((p) => p.isAvailable());\n  }\n\n  async search(\n    query: string,\n    count: number,\n    signal?: AbortSignal,\n  ): Promise<{ results: SearchResult[]; provider: string }> {\n    for (const provider of this.providers) {\n      if (!provider.isAvailable()) continue;\n      try {\n        const results = await provider.search(query, count, signal);\n        return { results, provider: provider.name };\n      } catch (err) {\n        log.debug({ provider: provider.name, err }, 'Search provider failed, trying next');\n      }\n    }\n\n    try {\n      const results = await this.fallbackProvider.search(query, count, signal);\n      return { results, provider: this.fallbackProvider.name };\n    } catch (err) {\n      log.warn({ err }, 'HTML fallback search failed');\n      return { results: [], provider: 'none' };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;aAAwD;AASxD,MAAM,MAAM,aAAa,kBAAkB;AAE3C,IAAa,yBAAb,MAAoC;CAClC;CACA;CAEA,YAAY,QAAiC;AAC3C,OAAK,YAAY,KAAK,eAAe,OAAO;AAC5C,OAAK,mBACH,OAAO,WAAW,OAAO,IAAI,kBAAkB,GAAG,IAAI,wBAAwB;AAChF,MAAI,MACF;GAAE,QAAQ,OAAO;GAAQ,iBAAiB,KAAK,UAAU,QAAQ,MAAM,EAAE,aAAa,CAAC,CAAC;GAAQ,EAChG,4BACD;;CAGH,eAAuB,QAAmD;EACxE,MAAM,OAAyB,EAAE;AAEjC,OAAK,MAAM,KAAK,OAAO,WAAW;AAChC,OAAI,EAAE,SAAU;AAChB,WAAQ,EAAE,MAAV;IACE,KAAK;AACH,UAAK,KAAK,IAAI,cAAc,EAAE,UAAU,GAAG,CAAC;AAC5C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,eAAe,EAAE,UAAU,GAAG,CAAC;AAC7C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,UAAU,GAAG,CAAC;AAC9C;IACF,KAAK;AACH,UAAK,KAAK,IAAI,gBAAgB,EAAE,OAAO,GAAG,CAAC;AAC3C;IACF,QACE;;;AAIN,SAAO;;CAGT,2BAAoC;AAClC,SAAO,KAAK,UAAU,MAAM,MAAM,EAAE,aAAa,CAAC;;CAGpD,MAAM,OACJ,OACA,OACA,QACwD;AACxD,OAAK,MAAM,YAAY,KAAK,WAAW;AACrC,OAAI,CAAC,SAAS,aAAa,CAAE;AAC7B,OAAI;AAEF,WAAO;KAAE,SAAA,MADa,SAAS,OAAO,OAAO,OAAO,OAAO;KACzC,UAAU,SAAS;KAAM;YACpC,KAAK;AACZ,QAAI,MAAM;KAAE,UAAU,SAAS;KAAM;KAAK,EAAE,sCAAsC;;;AAItF,MAAI;AAEF,UAAO;IAAE,SAAA,MADa,KAAK,iBAAiB,OAAO,OAAO,OAAO,OAAO;IACtD,UAAU,KAAK,iBAAiB;IAAM;WACjD,KAAK;AACZ,OAAI,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAChD,UAAO;IAAE,SAAS,EAAE;IAAE,UAAU;IAAQ"}

package/dist/src/agent/tools/send-media.js

@@ -1,7 +1,7 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { readFile } from "fs/promises";
 import { basename } from "node:path";
+import { readFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
 const SendMediaSchema = Type.Object({

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

@@ -8,7 +8,7 @@ import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/session-search-tool.ts
 init_providers();
 init_logger();
-const log = createLogger("session-search-tool");
+const log = createLogger("Agent:SessionSearch");
 const MAX_SUMMARY_CHARS = 2e4;
 function resolveSummaryModel(getConfig) {
 	const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();

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';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { getOrLoadSessionSearchIndex } from '../../session/search-index-cache.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('session-search-tool');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nexport { invalidateSessionSearchIndexCache } from '../../session/search-index-cache.js';\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const configRef = getConfig?.()?.agents?.defaults?.sessionSearch?.summaryModel?.trim();\n  const ref = envRef || configRef;\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 sessionsRoot = store.getSessionsRoot();\n        const index = await getOrLoadSessionSearchIndex(sessionsRoot);\n        let matches = index.search(query, 80);\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 = index.getSessionMessages(key);\n            if (messages.length === 0) {\n              messages = await store.load(key);\n            }\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { getOrLoadSessionSearchIndex } from '../../session/search-index-cache.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\nexport { invalidateSessionSearchIndexCache } from '../../session/search-index-cache.js';\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const configRef = getConfig?.()?.agents?.defaults?.sessionSearch?.summaryModel?.trim();\n  const ref = envRef || configRef;\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 sessionsRoot = store.getSessionsRoot();\n        const index = await getOrLoadSessionSearchIndex(sessionsRoot);\n        let matches = index.search(query, 80);\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 = index.getSessionMessages(key);\n            if (messages.length === 0) {\n              messages = await store.load(key);\n            }\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/skill-manage-tool.js

@@ -2,9 +2,9 @@ import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { createSkillConfigManager } from "../skills/config.js";
 import { applyPatchToContent, atomicWriteUtf8, effectiveAgentWritePolicy, ensureCategorySegment, isPathInsideDir, maxSkillMdChars, maxSupportFileBytes, mutatableSkillOrNull, resolveCreateSkillDir, scanSkillDirOrError, validateSkillMdContent, validateSkillNameSegment, validateSupportingRelativePath } from "../skills/skill-manage-ops.js";
-import { readFile, rm } from "fs/promises";
 import { join } from "path";
 import { existsSync, rmSync } from "fs";
+import { readFile, rm } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/skill-manage-tool.ts
 init_paths();

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

@@ -1,6 +1,6 @@
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 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";
@@ -9,7 +9,7 @@ import { Type } from "@sinclair/typebox";
 * `workflow` — starts a persisted workflow run in a dedicated chat session.
 */
 init_logger();
-const log = createLogger("workflow-tool");
+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(" ") })),

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('workflow-tool');\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});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  script?: string;\n  args?: unknown;\n  goal?: 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 source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          input: params.args,\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 { 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});\n\nexport type WorkflowToolInput = {\n  name?: string;\n  script?: string;\n  args?: unknown;\n  goal?: 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 source = parentSessionKey\n        ? ({ kind: 'chat' as const, sessionKey: parentSessionKey })\n        : ({ kind: 'api' as const });\n\n      try {\n        const result = await deps.startWorkflowRun({\n          agentId,\n          definitionId,\n          goal,\n          input: params.args,\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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"}

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

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
-import { mkdir, writeFile } from "fs/promises";
 import { dirname } from "path";
+import { mkdir, writeFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/write.ts
 const MAX_FILE_SIZE = 10 * 1024 * 1024;

package/dist/src/agent/workflow/catalog.js

@@ -1,8 +1,8 @@
 import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
 import { parseWorkflowScript } from "./parser.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 //#region src/agent/workflow/catalog.ts
 /**
 * Catalog for named workflows.

package/dist/src/agent/workflow/progress-broker.js

@@ -3,7 +3,7 @@ import { init_logger } from "../../utils/logger.js";
 import { renderWorkflowText } from "./snapshot.js";
 //#region src/agent/workflow/progress-broker.ts
 init_logger();
-const log = createLogger("workflow-progress-broker");
+const log = createLogger("Agent:WorkflowProgress");
 const WORKFLOW_TOOL_NAME = "workflow";
 const RENDER_MAX_AGENTS_PER_PHASE = 4;
 const RENDER_MAX_LOGS = 2;

package/dist/src/agent/workflow/progress-broker.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress-broker.js","names":[],"sources":["../../../../src/agent/workflow/progress-broker.ts"],"sourcesContent":["/**\n * WorkflowProgressBroker — the single seam that turns mid-run `workflow`\n * snapshots into IM messages (Telegram today, more channels later).\n *\n * Architecture:\n *\n *    pi-agent  ──tool_execution_update──▶  AgentEventHandler / SessionEventBus\n *                                                       │\n *                          attachTo(handler)            │\n *                                                       ▼\n *                                          WorkflowProgressBroker\n *                                                       │\n *                                  per-(sessionKey, toolCallId) state\n *                                                       │\n *                                   ┌───────────────────┼───────────────────┐\n *                                   ▼                   ▼                   ▼\n *                              Telegram cap         Feishu cap          WeChat cap\n *\n * Why broker + capability instead of \"each channel subscribes the bus\"?\n *   - DRY snapshot aggregation and key-event detection.\n *   - Per-channel throttling is enforced by the broker, so a slow / rate-limited\n *     channel can't block a fast one.\n *   - Adding a new channel = one capability + one register call. Broker code\n *     never grows.\n */\n\nimport type { AgentEvent } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../utils/logger.js';\nimport type { Config } from '../../config/schema.js';\n\nimport type {\n  ChannelProgressCapability,\n  WorkflowProgressMode,\n} from './channel-capability.js';\nimport { renderWorkflowText } from './snapshot.js';\nimport type { WorkflowAgentSnapshot, WorkflowSnapshot } from './types.js';\n\nconst log = createLogger('workflow-progress-broker');\n\nconst WORKFLOW_TOOL_NAME = 'workflow';\nconst RENDER_MAX_AGENTS_PER_PHASE = 4;\nconst RENDER_MAX_LOGS = 2;\n\n/** Per-channel resolved settings after applying config overrides on capability defaults. */\ninterface ChannelResolvedSettings {\n  enabled: boolean;\n  throttleMs: number;\n  mode: WorkflowProgressMode;\n}\n\n/** Per-(sessionKey, toolCallId) progress state. */\ninterface RunState {\n  /** Latest snapshot seen for this run. Always overwritten on update. */\n  snapshot: WorkflowSnapshot;\n  /** Previous snapshot used to detect \"key events\" (phase change, new errors). */\n  prevSnapshot?: WorkflowSnapshot;\n  /** Per-channel last-send bookkeeping. */\n  perChannel: Map<string, ChannelRunState>;\n}\n\ninterface ChannelRunState {\n  /** Server timestamp of the last successful postProgress. */\n  lastSentAt: number;\n  /** Returned messageId of the last successful postProgress — drives edit mode. */\n  lastMessageId?: string;\n  /** Pending timer id (Node `setTimeout`) when a throttled flush is scheduled. */\n  pendingTimer?: ReturnType<typeof setTimeout>;\n  /** Inflight `postProgress` promise; we serialise per-(state, channel) to avoid race. */\n  inflight?: Promise<void>;\n}\n\nexport interface BrokerListenerHandle {\n  /** Detach broker from the session bus and clear all in-flight state. */\n  dispose(): void;\n}\n\n/**\n * Tiny façade onto the AgentEventHandler. We don't import the concrete class to\n * keep this module test-friendly — a stub listener pump is fine for unit tests.\n */\nexport interface SessionBusLike {\n  registerListener(\n    type: AgentEvent['type'] | 'all',\n    listener: (event: AgentEvent, context: { sessionKey: string }) => void,\n  ): () => void;\n}\n\nexport class WorkflowProgressBroker {\n  private subscribers: ChannelProgressCapability[] = [];\n  private states = new Map<string, RunState>();\n  /** Now() factory — overridable in tests for deterministic time. */\n  private readonly now: () => number;\n  /** Cached resolved settings per (channelId), invalidated on registration. */\n  private resolved = new Map<string, ChannelResolvedSettings>();\n\n  constructor(\n    private readonly opts: {\n      getConfig?: () => Config | undefined;\n      now?: () => number;\n    } = {},\n  ) {\n    this.now = opts.now ?? (() => Date.now());\n  }\n\n  // ── Registration ────────────────────────────────────────────────────────────\n\n  registerChannel(cap: ChannelProgressCapability): () => void {\n    if (this.subscribers.some((s) => s.channelId === cap.channelId)) {\n      log.warn({ channelId: cap.channelId }, 'channel capability already registered; replacing');\n      this.subscribers = this.subscribers.filter((s) => s.channelId !== cap.channelId);\n    }\n    this.subscribers.push(cap);\n    this.resolved.delete(cap.channelId);\n    return () => {\n      this.subscribers = this.subscribers.filter((s) => s !== cap);\n      this.resolved.delete(cap.channelId);\n    };\n  }\n\n  attachTo(bus: SessionBusLike): BrokerListenerHandle {\n    const offUpdate = bus.registerListener('tool_execution_update', (event, ctx) => {\n      const e = event as Extract<AgentEvent, { type: 'tool_execution_update' }>;\n      if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n      const snap = extractWorkflowSnapshot(e.partialResult);\n      if (!snap) return;\n      this.onUpdate(ctx.sessionKey, e.toolCallId, snap);\n    });\n\n    const offEnd = bus.registerListener('tool_execution_end', (event, ctx) => {\n      const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n      if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n      // tool_end ships the final envelope in `result`; reach in for the\n      // authoritative snapshot (durationMs / result / final counts).\n      const snap = extractWorkflowSnapshot(e.result, { fromResultEnvelope: true });\n      this.onEnd(ctx.sessionKey, e.toolCallId, snap);\n    });\n\n    return {\n      dispose: () => {\n        offUpdate();\n        offEnd();\n        this.disposeAllPending();\n      },\n    };\n  }\n\n  // ── Core state machine ──────────────────────────────────────────────────────\n\n  /** Visible for tests — direct entry path bypassing the SessionBus glue. */\n  onUpdate(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot): void {\n    const key = stateKey(sessionKey, toolCallId);\n    const state = this.getOrCreateState(key, snapshot);\n    state.prevSnapshot = state.snapshot;\n    state.snapshot = snapshot;\n\n    const isKey = isKeyEvent(state.prevSnapshot, snapshot);\n    for (const cap of this.subscribers) {\n      this.dispatchToChannel(state, sessionKey, cap, { isFinal: false, isKey });\n    }\n  }\n\n  /** Visible for tests — direct entry path bypassing the SessionBus glue. */\n  onEnd(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot | null): void {\n    const key = stateKey(sessionKey, toolCallId);\n    const state = this.states.get(key);\n    if (!state) return;\n    if (snapshot) state.snapshot = snapshot;\n\n    for (const cap of this.subscribers) {\n      // Always flush the final message — bypass throttle and any pending timer.\n      this.cancelPending(state, cap.channelId);\n      this.dispatchToChannel(state, sessionKey, cap, { isFinal: true, isKey: true });\n    }\n    // State is GC'd lazily after a small grace period so any straggler\n    // `update` event arriving after `end` is silently dropped (instead of\n    // resurrecting the run).\n    setTimeout(() => this.states.delete(key), 2_000);\n  }\n\n  // ── Dispatch + throttle ─────────────────────────────────────────────────────\n\n  private dispatchToChannel(\n    state: RunState,\n    sessionKey: string,\n    cap: ChannelProgressCapability,\n    flags: { isFinal: boolean; isKey: boolean },\n  ): void {\n    const cfg = this.resolveChannelSettings(cap);\n    if (!cfg.enabled) return;\n    if (cfg.mode === 'final-only' && !flags.isFinal) return;\n\n    const chState = this.getOrCreateChannelState(state, cap.channelId);\n\n    // Key events and the final message bypass throttle.\n    if (flags.isFinal || flags.isKey) {\n      this.cancelPending(state, cap.channelId);\n      void this.sendNow(state, sessionKey, cap, cfg, flags.isFinal);\n      return;\n    }\n\n    const elapsed = this.now() - chState.lastSentAt;\n    const wait = Math.max(0, cfg.throttleMs - elapsed);\n    if (wait === 0) {\n      void this.sendNow(state, sessionKey, cap, cfg, false);\n      return;\n    }\n    if (chState.pendingTimer) return; // already scheduled; latest snapshot will be picked up\n    chState.pendingTimer = setTimeout(() => {\n      chState.pendingTimer = undefined;\n      void this.sendNow(state, sessionKey, cap, cfg, false);\n    }, wait);\n  }\n\n  private async sendNow(\n    state: RunState,\n    sessionKey: string,\n    cap: ChannelProgressCapability,\n    cfg: ChannelResolvedSettings,\n    isFinal: boolean,\n  ): Promise<void> {\n    const chState = this.getOrCreateChannelState(state, cap.channelId);\n    // Serialise per-channel sends so a slow editMessage call doesn't get\n    // overtaken by a faster one and leave the bubble out of order.\n    if (chState.inflight) await chState.inflight.catch(() => undefined);\n\n    const text = renderWorkflowText(state.snapshot, isFinal, {\n      maxAgentsPerPhase: RENDER_MAX_AGENTS_PER_PHASE,\n      maxLogs: RENDER_MAX_LOGS,\n      showResultPreviews: isFinal,\n    });\n\n    const previousMessageId = cfg.mode === 'edit' ? chState.lastMessageId : undefined;\n    const task = cap\n      .postProgress({ sessionKey, text, previousMessageId, isFinal, mode: cfg.mode })\n      .then((r) => {\n        chState.lastMessageId = r.messageId;\n        chState.lastSentAt = this.now();\n      })\n      .catch((err) => {\n        const msg = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: msg, channelId: cap.channelId, sessionKey },\n          `workflow progress postProgress failed: ${msg}`,\n        );\n      })\n      .finally(() => {\n        chState.inflight = undefined;\n      });\n\n    chState.inflight = task;\n    await task;\n  }\n\n  private cancelPending(state: RunState, channelId: string): void {\n    const chState = state.perChannel.get(channelId);\n    if (chState?.pendingTimer) {\n      clearTimeout(chState.pendingTimer);\n      chState.pendingTimer = undefined;\n    }\n  }\n\n  private disposeAllPending(): void {\n    for (const state of this.states.values()) {\n      for (const ch of state.perChannel.values()) {\n        if (ch.pendingTimer) clearTimeout(ch.pendingTimer);\n      }\n    }\n    this.states.clear();\n  }\n\n  // ── State helpers ───────────────────────────────────────────────────────────\n\n  private getOrCreateState(key: string, snapshot: WorkflowSnapshot): RunState {\n    let state = this.states.get(key);\n    if (!state) {\n      state = { snapshot, perChannel: new Map() };\n      this.states.set(key, state);\n    }\n    return state;\n  }\n\n  private getOrCreateChannelState(state: RunState, channelId: string): ChannelRunState {\n    let ch = state.perChannel.get(channelId);\n    if (!ch) {\n      ch = { lastSentAt: 0 };\n      state.perChannel.set(channelId, ch);\n    }\n    return ch;\n  }\n\n  /** Resolved (enabled / throttleMs / mode) for a channel, with config overrides. */\n  private resolveChannelSettings(cap: ChannelProgressCapability): ChannelResolvedSettings {\n    const cached = this.resolved.get(cap.channelId);\n    if (cached) return cached;\n    const override = readChannelConfig(this.opts.getConfig?.(), cap.channelId);\n    const resolved: ChannelResolvedSettings = {\n      enabled: override?.enabled ?? true,\n      throttleMs: override?.throttleMs ?? cap.defaultThrottleMs,\n      mode: override?.mode ?? cap.defaultMode,\n    };\n    this.resolved.set(cap.channelId, resolved);\n    return resolved;\n  }\n\n  /** Drop any cached config so the next dispatch re-reads. Call after config reload. */\n  invalidateConfigCache(): void {\n    this.resolved.clear();\n  }\n\n  // ── Test introspection ──────────────────────────────────────────────────────\n\n  /** @internal — for tests only. */\n  _stateCount(): number {\n    return this.states.size;\n  }\n}\n\n// ── Singleton ───────────────────────────────────────────────────────────────\n\nlet singleton: WorkflowProgressBroker | null = null;\n\n/**\n * Process-wide broker singleton. Channels register against this one; the\n * service wires it to the session bus during startup.\n */\nexport function getWorkflowProgressBroker(): WorkflowProgressBroker {\n  if (!singleton) singleton = new WorkflowProgressBroker();\n  return singleton;\n}\n\n/** Test-only — reset the singleton between cases. */\nexport function _resetWorkflowProgressBrokerForTests(): void {\n  singleton = null;\n}\n\n// ── Pure helpers ────────────────────────────────────────────────────────────\n\nfunction stateKey(sessionKey: string, toolCallId: string | undefined): string {\n  return `${sessionKey}\u0001${toolCallId ?? ''}`;\n}\n\n/**\n * Compare two snapshots and decide whether the new one is \"key\" — i.e. worth\n * bypassing the per-channel throttle. Anything visible to the user as a\n * progress milestone qualifies; counts ticking by alone do not.\n */\nfunction isKeyEvent(prev: WorkflowSnapshot | undefined, next: WorkflowSnapshot): boolean {\n  if (!prev) return true; // first update of the run\n  if (prev.currentPhase !== next.currentPhase) return true;\n  if (next.errorCount > prev.errorCount) return true;\n  if (next.skippedCount > prev.skippedCount) return true;\n  // New phase row in the rollup (declared via `phase(...)` mid-run)\n  if (prev.phases.length !== next.phases.length) return true;\n  if (hasNewFailedAgent(prev.agents, next.agents)) return true;\n  return false;\n}\n\nfunction hasNewFailedAgent(\n  prev: WorkflowAgentSnapshot[],\n  next: WorkflowAgentSnapshot[],\n): boolean {\n  const prevBad = new Set(\n    prev.filter((a) => a.status === 'error' || a.status === 'skipped').map((a) => a.id),\n  );\n  for (const a of next) {\n    if ((a.status === 'error' || a.status === 'skipped') && !prevBad.has(a.id)) return true;\n  }\n  return false;\n}\n\n/**\n * Pull a {@link WorkflowSnapshot} out of an AgentToolResult-shaped value.\n * Returns null when the payload is not snapshot-shaped (text-only updates,\n * non-workflow tools, etc.).\n *\n * `fromResultEnvelope = true` (used for `tool_end.result`) tolerates the\n * `{ content, details }` wrapper.\n */\nfunction extractWorkflowSnapshot(\n  payload: unknown,\n  opts: { fromResultEnvelope?: boolean } = {},\n): WorkflowSnapshot | null {\n  if (!payload || typeof payload !== 'object') return null;\n  const rec = payload as Record<string, unknown>;\n  if (opts.fromResultEnvelope) {\n    const details = rec.details;\n    if (details && typeof details === 'object') return coerce(details);\n    return null;\n  }\n  if ('details' in rec) {\n    const details = rec.details;\n    if (details && typeof details === 'object') return coerce(details);\n    return null;\n  }\n  return coerce(rec);\n}\n\nfunction coerce(value: unknown): WorkflowSnapshot | null {\n  if (!value || typeof value !== 'object') return null;\n  const rec = value as Record<string, unknown>;\n  if (typeof rec.name !== 'string') return null;\n  if (!Array.isArray(rec.agents)) return null;\n  return value as WorkflowSnapshot;\n}\n\nfunction readChannelConfig(\n  config: Config | undefined,\n  channelId: string,\n): { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode } | undefined {\n  const channels = config?.channels as Record<string, unknown> | undefined;\n  if (!channels) return undefined;\n  const cfg = channels[channelId];\n  if (!cfg || typeof cfg !== 'object') return undefined;\n  const wf = (cfg as { workflowProgress?: unknown }).workflowProgress;\n  if (!wf || typeof wf !== 'object') return undefined;\n  return wf as { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode };\n}\n"],"mappings":"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"}
+{"version":3,"file":"progress-broker.js","names":[],"sources":["../../../../src/agent/workflow/progress-broker.ts"],"sourcesContent":["/**\n * WorkflowProgressBroker — the single seam that turns mid-run `workflow`\n * snapshots into IM messages (Telegram today, more channels later).\n *\n * Architecture:\n *\n *    pi-agent  ──tool_execution_update──▶  AgentEventHandler / SessionEventBus\n *                                                       │\n *                          attachTo(handler)            │\n *                                                       ▼\n *                                          WorkflowProgressBroker\n *                                                       │\n *                                  per-(sessionKey, toolCallId) state\n *                                                       │\n *                                   ┌───────────────────┼───────────────────┐\n *                                   ▼                   ▼                   ▼\n *                              Telegram cap         Feishu cap          WeChat cap\n *\n * Why broker + capability instead of \"each channel subscribes the bus\"?\n *   - DRY snapshot aggregation and key-event detection.\n *   - Per-channel throttling is enforced by the broker, so a slow / rate-limited\n *     channel can't block a fast one.\n *   - Adding a new channel = one capability + one register call. Broker code\n *     never grows.\n */\n\nimport type { AgentEvent } from '@earendil-works/pi-agent-core';\n\nimport { createLogger } from '../../utils/logger.js';\nimport type { Config } from '../../config/schema.js';\n\nimport type {\n  ChannelProgressCapability,\n  WorkflowProgressMode,\n} from './channel-capability.js';\nimport { renderWorkflowText } from './snapshot.js';\nimport type { WorkflowAgentSnapshot, WorkflowSnapshot } from './types.js';\n\nconst log = createLogger('Agent:WorkflowProgress');\n\nconst WORKFLOW_TOOL_NAME = 'workflow';\nconst RENDER_MAX_AGENTS_PER_PHASE = 4;\nconst RENDER_MAX_LOGS = 2;\n\n/** Per-channel resolved settings after applying config overrides on capability defaults. */\ninterface ChannelResolvedSettings {\n  enabled: boolean;\n  throttleMs: number;\n  mode: WorkflowProgressMode;\n}\n\n/** Per-(sessionKey, toolCallId) progress state. */\ninterface RunState {\n  /** Latest snapshot seen for this run. Always overwritten on update. */\n  snapshot: WorkflowSnapshot;\n  /** Previous snapshot used to detect \"key events\" (phase change, new errors). */\n  prevSnapshot?: WorkflowSnapshot;\n  /** Per-channel last-send bookkeeping. */\n  perChannel: Map<string, ChannelRunState>;\n}\n\ninterface ChannelRunState {\n  /** Server timestamp of the last successful postProgress. */\n  lastSentAt: number;\n  /** Returned messageId of the last successful postProgress — drives edit mode. */\n  lastMessageId?: string;\n  /** Pending timer id (Node `setTimeout`) when a throttled flush is scheduled. */\n  pendingTimer?: ReturnType<typeof setTimeout>;\n  /** Inflight `postProgress` promise; we serialise per-(state, channel) to avoid race. */\n  inflight?: Promise<void>;\n}\n\nexport interface BrokerListenerHandle {\n  /** Detach broker from the session bus and clear all in-flight state. */\n  dispose(): void;\n}\n\n/**\n * Tiny façade onto the AgentEventHandler. We don't import the concrete class to\n * keep this module test-friendly — a stub listener pump is fine for unit tests.\n */\nexport interface SessionBusLike {\n  registerListener(\n    type: AgentEvent['type'] | 'all',\n    listener: (event: AgentEvent, context: { sessionKey: string }) => void,\n  ): () => void;\n}\n\nexport class WorkflowProgressBroker {\n  private subscribers: ChannelProgressCapability[] = [];\n  private states = new Map<string, RunState>();\n  /** Now() factory — overridable in tests for deterministic time. */\n  private readonly now: () => number;\n  /** Cached resolved settings per (channelId), invalidated on registration. */\n  private resolved = new Map<string, ChannelResolvedSettings>();\n\n  constructor(\n    private readonly opts: {\n      getConfig?: () => Config | undefined;\n      now?: () => number;\n    } = {},\n  ) {\n    this.now = opts.now ?? (() => Date.now());\n  }\n\n  // ── Registration ────────────────────────────────────────────────────────────\n\n  registerChannel(cap: ChannelProgressCapability): () => void {\n    if (this.subscribers.some((s) => s.channelId === cap.channelId)) {\n      log.warn({ channelId: cap.channelId }, 'channel capability already registered; replacing');\n      this.subscribers = this.subscribers.filter((s) => s.channelId !== cap.channelId);\n    }\n    this.subscribers.push(cap);\n    this.resolved.delete(cap.channelId);\n    return () => {\n      this.subscribers = this.subscribers.filter((s) => s !== cap);\n      this.resolved.delete(cap.channelId);\n    };\n  }\n\n  attachTo(bus: SessionBusLike): BrokerListenerHandle {\n    const offUpdate = bus.registerListener('tool_execution_update', (event, ctx) => {\n      const e = event as Extract<AgentEvent, { type: 'tool_execution_update' }>;\n      if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n      const snap = extractWorkflowSnapshot(e.partialResult);\n      if (!snap) return;\n      this.onUpdate(ctx.sessionKey, e.toolCallId, snap);\n    });\n\n    const offEnd = bus.registerListener('tool_execution_end', (event, ctx) => {\n      const e = event as Extract<AgentEvent, { type: 'tool_execution_end' }>;\n      if (e.toolName !== WORKFLOW_TOOL_NAME) return;\n      // tool_end ships the final envelope in `result`; reach in for the\n      // authoritative snapshot (durationMs / result / final counts).\n      const snap = extractWorkflowSnapshot(e.result, { fromResultEnvelope: true });\n      this.onEnd(ctx.sessionKey, e.toolCallId, snap);\n    });\n\n    return {\n      dispose: () => {\n        offUpdate();\n        offEnd();\n        this.disposeAllPending();\n      },\n    };\n  }\n\n  // ── Core state machine ──────────────────────────────────────────────────────\n\n  /** Visible for tests — direct entry path bypassing the SessionBus glue. */\n  onUpdate(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot): void {\n    const key = stateKey(sessionKey, toolCallId);\n    const state = this.getOrCreateState(key, snapshot);\n    state.prevSnapshot = state.snapshot;\n    state.snapshot = snapshot;\n\n    const isKey = isKeyEvent(state.prevSnapshot, snapshot);\n    for (const cap of this.subscribers) {\n      this.dispatchToChannel(state, sessionKey, cap, { isFinal: false, isKey });\n    }\n  }\n\n  /** Visible for tests — direct entry path bypassing the SessionBus glue. */\n  onEnd(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot | null): void {\n    const key = stateKey(sessionKey, toolCallId);\n    const state = this.states.get(key);\n    if (!state) return;\n    if (snapshot) state.snapshot = snapshot;\n\n    for (const cap of this.subscribers) {\n      // Always flush the final message — bypass throttle and any pending timer.\n      this.cancelPending(state, cap.channelId);\n      this.dispatchToChannel(state, sessionKey, cap, { isFinal: true, isKey: true });\n    }\n    // State is GC'd lazily after a small grace period so any straggler\n    // `update` event arriving after `end` is silently dropped (instead of\n    // resurrecting the run).\n    setTimeout(() => this.states.delete(key), 2_000);\n  }\n\n  // ── Dispatch + throttle ─────────────────────────────────────────────────────\n\n  private dispatchToChannel(\n    state: RunState,\n    sessionKey: string,\n    cap: ChannelProgressCapability,\n    flags: { isFinal: boolean; isKey: boolean },\n  ): void {\n    const cfg = this.resolveChannelSettings(cap);\n    if (!cfg.enabled) return;\n    if (cfg.mode === 'final-only' && !flags.isFinal) return;\n\n    const chState = this.getOrCreateChannelState(state, cap.channelId);\n\n    // Key events and the final message bypass throttle.\n    if (flags.isFinal || flags.isKey) {\n      this.cancelPending(state, cap.channelId);\n      void this.sendNow(state, sessionKey, cap, cfg, flags.isFinal);\n      return;\n    }\n\n    const elapsed = this.now() - chState.lastSentAt;\n    const wait = Math.max(0, cfg.throttleMs - elapsed);\n    if (wait === 0) {\n      void this.sendNow(state, sessionKey, cap, cfg, false);\n      return;\n    }\n    if (chState.pendingTimer) return; // already scheduled; latest snapshot will be picked up\n    chState.pendingTimer = setTimeout(() => {\n      chState.pendingTimer = undefined;\n      void this.sendNow(state, sessionKey, cap, cfg, false);\n    }, wait);\n  }\n\n  private async sendNow(\n    state: RunState,\n    sessionKey: string,\n    cap: ChannelProgressCapability,\n    cfg: ChannelResolvedSettings,\n    isFinal: boolean,\n  ): Promise<void> {\n    const chState = this.getOrCreateChannelState(state, cap.channelId);\n    // Serialise per-channel sends so a slow editMessage call doesn't get\n    // overtaken by a faster one and leave the bubble out of order.\n    if (chState.inflight) await chState.inflight.catch(() => undefined);\n\n    const text = renderWorkflowText(state.snapshot, isFinal, {\n      maxAgentsPerPhase: RENDER_MAX_AGENTS_PER_PHASE,\n      maxLogs: RENDER_MAX_LOGS,\n      showResultPreviews: isFinal,\n    });\n\n    const previousMessageId = cfg.mode === 'edit' ? chState.lastMessageId : undefined;\n    const task = cap\n      .postProgress({ sessionKey, text, previousMessageId, isFinal, mode: cfg.mode })\n      .then((r) => {\n        chState.lastMessageId = r.messageId;\n        chState.lastSentAt = this.now();\n      })\n      .catch((err) => {\n        const msg = err instanceof Error ? err.message : String(err);\n        log.warn(\n          { err, errorMessage: msg, channelId: cap.channelId, sessionKey },\n          `workflow progress postProgress failed: ${msg}`,\n        );\n      })\n      .finally(() => {\n        chState.inflight = undefined;\n      });\n\n    chState.inflight = task;\n    await task;\n  }\n\n  private cancelPending(state: RunState, channelId: string): void {\n    const chState = state.perChannel.get(channelId);\n    if (chState?.pendingTimer) {\n      clearTimeout(chState.pendingTimer);\n      chState.pendingTimer = undefined;\n    }\n  }\n\n  private disposeAllPending(): void {\n    for (const state of this.states.values()) {\n      for (const ch of state.perChannel.values()) {\n        if (ch.pendingTimer) clearTimeout(ch.pendingTimer);\n      }\n    }\n    this.states.clear();\n  }\n\n  // ── State helpers ───────────────────────────────────────────────────────────\n\n  private getOrCreateState(key: string, snapshot: WorkflowSnapshot): RunState {\n    let state = this.states.get(key);\n    if (!state) {\n      state = { snapshot, perChannel: new Map() };\n      this.states.set(key, state);\n    }\n    return state;\n  }\n\n  private getOrCreateChannelState(state: RunState, channelId: string): ChannelRunState {\n    let ch = state.perChannel.get(channelId);\n    if (!ch) {\n      ch = { lastSentAt: 0 };\n      state.perChannel.set(channelId, ch);\n    }\n    return ch;\n  }\n\n  /** Resolved (enabled / throttleMs / mode) for a channel, with config overrides. */\n  private resolveChannelSettings(cap: ChannelProgressCapability): ChannelResolvedSettings {\n    const cached = this.resolved.get(cap.channelId);\n    if (cached) return cached;\n    const override = readChannelConfig(this.opts.getConfig?.(), cap.channelId);\n    const resolved: ChannelResolvedSettings = {\n      enabled: override?.enabled ?? true,\n      throttleMs: override?.throttleMs ?? cap.defaultThrottleMs,\n      mode: override?.mode ?? cap.defaultMode,\n    };\n    this.resolved.set(cap.channelId, resolved);\n    return resolved;\n  }\n\n  /** Drop any cached config so the next dispatch re-reads. Call after config reload. */\n  invalidateConfigCache(): void {\n    this.resolved.clear();\n  }\n\n  // ── Test introspection ──────────────────────────────────────────────────────\n\n  /** @internal — for tests only. */\n  _stateCount(): number {\n    return this.states.size;\n  }\n}\n\n// ── Singleton ───────────────────────────────────────────────────────────────\n\nlet singleton: WorkflowProgressBroker | null = null;\n\n/**\n * Process-wide broker singleton. Channels register against this one; the\n * service wires it to the session bus during startup.\n */\nexport function getWorkflowProgressBroker(): WorkflowProgressBroker {\n  if (!singleton) singleton = new WorkflowProgressBroker();\n  return singleton;\n}\n\n/** Test-only — reset the singleton between cases. */\nexport function _resetWorkflowProgressBrokerForTests(): void {\n  singleton = null;\n}\n\n// ── Pure helpers ────────────────────────────────────────────────────────────\n\nfunction stateKey(sessionKey: string, toolCallId: string | undefined): string {\n  return `${sessionKey}\u0001${toolCallId ?? ''}`;\n}\n\n/**\n * Compare two snapshots and decide whether the new one is \"key\" — i.e. worth\n * bypassing the per-channel throttle. Anything visible to the user as a\n * progress milestone qualifies; counts ticking by alone do not.\n */\nfunction isKeyEvent(prev: WorkflowSnapshot | undefined, next: WorkflowSnapshot): boolean {\n  if (!prev) return true; // first update of the run\n  if (prev.currentPhase !== next.currentPhase) return true;\n  if (next.errorCount > prev.errorCount) return true;\n  if (next.skippedCount > prev.skippedCount) return true;\n  // New phase row in the rollup (declared via `phase(...)` mid-run)\n  if (prev.phases.length !== next.phases.length) return true;\n  if (hasNewFailedAgent(prev.agents, next.agents)) return true;\n  return false;\n}\n\nfunction hasNewFailedAgent(\n  prev: WorkflowAgentSnapshot[],\n  next: WorkflowAgentSnapshot[],\n): boolean {\n  const prevBad = new Set(\n    prev.filter((a) => a.status === 'error' || a.status === 'skipped').map((a) => a.id),\n  );\n  for (const a of next) {\n    if ((a.status === 'error' || a.status === 'skipped') && !prevBad.has(a.id)) return true;\n  }\n  return false;\n}\n\n/**\n * Pull a {@link WorkflowSnapshot} out of an AgentToolResult-shaped value.\n * Returns null when the payload is not snapshot-shaped (text-only updates,\n * non-workflow tools, etc.).\n *\n * `fromResultEnvelope = true` (used for `tool_end.result`) tolerates the\n * `{ content, details }` wrapper.\n */\nfunction extractWorkflowSnapshot(\n  payload: unknown,\n  opts: { fromResultEnvelope?: boolean } = {},\n): WorkflowSnapshot | null {\n  if (!payload || typeof payload !== 'object') return null;\n  const rec = payload as Record<string, unknown>;\n  if (opts.fromResultEnvelope) {\n    const details = rec.details;\n    if (details && typeof details === 'object') return coerce(details);\n    return null;\n  }\n  if ('details' in rec) {\n    const details = rec.details;\n    if (details && typeof details === 'object') return coerce(details);\n    return null;\n  }\n  return coerce(rec);\n}\n\nfunction coerce(value: unknown): WorkflowSnapshot | null {\n  if (!value || typeof value !== 'object') return null;\n  const rec = value as Record<string, unknown>;\n  if (typeof rec.name !== 'string') return null;\n  if (!Array.isArray(rec.agents)) return null;\n  return value as WorkflowSnapshot;\n}\n\nfunction readChannelConfig(\n  config: Config | undefined,\n  channelId: string,\n): { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode } | undefined {\n  const channels = config?.channels as Record<string, unknown> | undefined;\n  if (!channels) return undefined;\n  const cfg = channels[channelId];\n  if (!cfg || typeof cfg !== 'object') return undefined;\n  const wf = (cfg as { workflowProgress?: unknown }).workflowProgress;\n  if (!wf || typeof wf !== 'object') return undefined;\n  return wf as { enabled?: boolean; throttleMs?: number; mode?: WorkflowProgressMode };\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/subagent-runner.js

@@ -5,7 +5,7 @@ import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS } from "../tools/delegat
 import { STRUCTURED_OUTPUT_TOOL_NAME, createStructuredOutputTool } from "./structured-output-tool.js";
 //#region src/agent/workflow/subagent-runner.ts
 init_logger();
-const log = createLogger("workflow-subagent-runner");
+const log = createLogger("Agent:WorkflowSubagent");
 const DEFAULT_MAX_ITERATIONS = 30;
 var DelegateSubagentRunner = class {
 	constructor(deps) {

package/dist/src/agent/workflow/subagent-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('workflow-subagent-runner');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n    const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n      progressHooks:\n        opts.onProgress && streamMode !== 'off'\n          ? {\n              mode: streamMode === 'full' ? 'full' : 'steps',\n              onProgress: (event) => {\n                opts.onProgress?.(mapChildProgressEvent(event));\n              },\n            }\n          : undefined,\n    };\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary } = await handle.run();\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n\nfunction resolveSubagentStreamMode(\n  getConfig: () => Config | undefined,\n): 'off' | 'steps' | 'full' {\n  const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n  if (mode === 'off' || mode === 'steps' || mode === 'full') return mode;\n  return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n  type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n  toolCallId?: string;\n  toolName?: string;\n  args?: Record<string, unknown>;\n  isError?: boolean;\n  resultPreview?: string;\n  error?: string;\n  count?: number;\n  max?: number;\n  delta?: string;\n}): SubagentProgressEvent {\n  switch (event.type) {\n    case 'tool_start':\n      return {\n        type: 'tool_start',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        args: event.args ?? {},\n      };\n    case 'tool_end':\n      return {\n        type: 'tool_end',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        isError: Boolean(event.isError),\n        resultPreview: event.resultPreview,\n        error: event.error,\n      };\n    case 'iteration':\n      return {\n        type: 'iteration',\n        count: event.count ?? 0,\n        max: event.max ?? 0,\n      };\n    case 'text_delta':\n      return { type: 'text_delta', delta: event.delta ?? '' };\n    case 'thinking_delta':\n      return { type: 'thinking_delta', delta: event.delta ?? '' };\n    default:\n      return { type: 'text_delta', delta: '' };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagent-runner.js","names":[],"sources":["../../../../src/agent/workflow/subagent-runner.ts"],"sourcesContent":["/**\n * Adapter: spawns one isolated child agent per `agent()` call from a workflow.\n *\n * Wraps the existing `createDelegateChildHandle` so the workflow runtime stays\n * decoupled from the LLM stack (it sees only the `SubagentRunner` interface).\n *\n * Key behaviour:\n * - When `opts.schema` is provided, we inject `structured_output` into the child\n *   tool set and unwrap the captured value on success. If the subagent finishes\n *   without ever calling `structured_output`, we treat it as failure (`null`).\n * - Failures and aborts resolve to `null`. The workflow runtime continues — this\n *   matches the pi-dynamic-workflows contract and keeps fan-out pipelines robust.\n * - We do NOT mutate `createDelegateChildHandle` — we just leverage its\n *   `buildChildTools` injection point.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  type BuildChildToolsOptions,\n  createDelegateChildHandle,\n  type DelegateChildHandleOptions,\n} from '../child-agent-factory.js';\nimport {\n  DEFAULT_DELEGATE_TOOLS,\n  DELEGATE_BLOCKED_TOOLS,\n} from '../tools/delegate-tool.js';\nimport type { ToolExecutorConfig } from '../tools/executor.js';\n\nimport {\n  createStructuredOutputTool,\n  STRUCTURED_OUTPUT_TOOL_NAME,\n  type StructuredOutputCapture,\n} from './structured-output-tool.js';\nimport type { SubagentRunOptions, SubagentRunner, SubagentProgressEvent } from './types.js';\n\nconst log = createLogger('Agent:WorkflowSubagent');\n\nconst DEFAULT_MAX_ITERATIONS = 30;\n\nexport interface DelegateSubagentRunnerDeps {\n  workspace: string;\n  bus: MessageBus;\n  /** Resolves the default subagent model (typically the parent agent's primary model). */\n  getDefaultModel: () => Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Provided by the workflow tool from `AgentToolsFactory` — mirrors how\n   * `delegate-tool` is wired (avoids importing `tools/factory.ts` here and\n   * breaking the existing factory ↔ delegate-tool ↔ child-agent-factory\n   * dependency contract).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class DelegateSubagentRunner implements SubagentRunner {\n  constructor(private readonly deps: DelegateSubagentRunnerDeps) {}\n\n  async run<T = string>(prompt: string, opts: SubagentRunOptions<T>): Promise<T | null> {\n    if (opts.signal?.aborted) return null;\n\n    const capture: StructuredOutputCapture<T> = { called: false, value: undefined };\n    const wantStructured = Boolean(opts.schema);\n\n    const allowed = resolveAllowedToolNames(opts.allowedToolNames, wantStructured);\n    const model = opts.model ?? safeResolveDefaultModel(this.deps.getDefaultModel);\n    if (!model) {\n      log.warn({ label: opts.label }, 'subagent run skipped: no primary model resolved');\n      return null;\n    }\n\n    const fullPrompt = buildPrompt(prompt, opts, wantStructured);\n    const streamMode = resolveSubagentStreamMode(this.deps.getConfig);\n\n    const childOptions: DelegateChildHandleOptions = {\n      workspace: this.deps.workspace,\n      goal: fullPrompt,\n      allowedToolNames: allowed,\n      maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,\n      model,\n      bus: this.deps.bus,\n      getConfig: this.deps.getConfig,\n      toolExecutorConfig: this.deps.toolExecutorConfig,\n      buildChildTools: (childOpts) => {\n        const base = this.deps.buildChildTools(childOpts);\n        if (!wantStructured || !opts.schema) return base;\n        // Replace any existing tool with the same name so the per-run capture wins.\n        const filtered = base.filter((t) => t.name !== STRUCTURED_OUTPUT_TOOL_NAME);\n        return [\n          ...filtered,\n          createStructuredOutputTool({ schema: opts.schema, capture }) as unknown as AgentTool<any, any>,\n        ];\n      },\n      progressHooks:\n        opts.onProgress && streamMode !== 'off'\n          ? {\n              mode: streamMode === 'full' ? 'full' : 'steps',\n              onProgress: (event) => {\n                opts.onProgress?.(mapChildProgressEvent(event));\n              },\n            }\n          : undefined,\n    };\n\n    const handle = createDelegateChildHandle(childOptions);\n    const onAbort = () => handle.abort();\n    opts.signal?.addEventListener('abort', onAbort, { once: true });\n\n    try {\n      const { summary } = await handle.run();\n      if (opts.signal?.aborted) return null;\n\n      if (wantStructured) {\n        if (!capture.called) {\n          log.warn({ label: opts.label }, 'subagent finished without calling structured_output');\n          return null;\n        }\n        return capture.value as T;\n      }\n      return summary as unknown as T;\n    } catch (e) {\n      if (opts.rethrow) throw e;\n      const msg = e instanceof Error ? e.message : String(e);\n      log.warn({ err: e, label: opts.label, errorMessage: msg }, `subagent run failed: ${msg}`);\n      return null;\n    } finally {\n      opts.signal?.removeEventListener('abort', onAbort);\n    }\n  }\n}\n\nfunction resolveAllowedToolNames(\n  requested: string[] | undefined,\n  wantStructured: boolean,\n): string[] {\n  const base = requested && requested.length > 0 ? requested : [...DEFAULT_DELEGATE_TOOLS];\n  const filtered = base\n    .map((s) => String(s).trim())\n    .filter((s) => s.length > 0)\n    .filter((s) => !DELEGATE_BLOCKED_TOOLS.has(s));\n  if (wantStructured && !filtered.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {\n    filtered.push(STRUCTURED_OUTPUT_TOOL_NAME);\n  }\n  return [...new Set(filtered)];\n}\n\nfunction buildPrompt(prompt: string, opts: SubagentRunOptions<unknown>, structured: boolean): string {\n  const parts: string[] = [];\n  if (opts.instructions?.trim()) parts.push(opts.instructions.trim());\n  if (opts.label) parts.push(`Task label: ${opts.label}`);\n  if (opts.phase) parts.push(`Workflow phase: ${opts.phase}`);\n  parts.push(prompt);\n  if (structured) {\n    parts.push(\n      [\n        'Final output contract:',\n        '- Your final action MUST be a structured_output tool call.',\n        '- The structured_output arguments are the return value of this subagent.',\n        '- Do not emit a prose final answer instead of structured_output.',\n        '- If you need to inspect files or run commands first, do so, then call structured_output exactly once.',\n      ].join('\\n'),\n    );\n  }\n  return parts.join('\\n\\n');\n}\n\nfunction safeResolveDefaultModel(get: () => Model<Api>): Model<Api> | null {\n  try {\n    return get();\n  } catch (e) {\n    log.warn({ err: e }, 'failed to resolve default subagent model');\n    return null;\n  }\n}\n\nfunction resolveSubagentStreamMode(\n  getConfig: () => Config | undefined,\n): 'off' | 'steps' | 'full' {\n  const mode = getConfig()?.agents?.defaults?.workflow?.subagentStream;\n  if (mode === 'off' || mode === 'steps' || mode === 'full') return mode;\n  return 'steps';\n}\n\nfunction mapChildProgressEvent(event: {\n  type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n  toolCallId?: string;\n  toolName?: string;\n  args?: Record<string, unknown>;\n  isError?: boolean;\n  resultPreview?: string;\n  error?: string;\n  count?: number;\n  max?: number;\n  delta?: string;\n}): SubagentProgressEvent {\n  switch (event.type) {\n    case 'tool_start':\n      return {\n        type: 'tool_start',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        args: event.args ?? {},\n      };\n    case 'tool_end':\n      return {\n        type: 'tool_end',\n        toolCallId: event.toolCallId ?? '',\n        toolName: event.toolName ?? 'tool',\n        isError: Boolean(event.isError),\n        resultPreview: event.resultPreview,\n        error: event.error,\n      };\n    case 'iteration':\n      return {\n        type: 'iteration',\n        count: event.count ?? 0,\n        max: event.max ?? 0,\n      };\n    case 'text_delta':\n      return { type: 'text_delta', delta: event.delta ?? '' };\n    case 'thinking_delta':\n      return { type: 'thinking_delta', delta: event.delta ?? '' };\n    default:\n      return { type: 'text_delta', delta: '' };\n  }\n}\n"],"mappings":"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"}

package/dist/src/auth/credentials.js

@@ -1,11 +1,11 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
-import { mkdir, readFile, rm } from "fs/promises";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { dirname, join } from "path";
+import { mkdir, readFile, rm } from "fs/promises";
 //#region src/auth/credentials.ts
 function getCredentialResolver(options) {
 	return new CredentialResolver(options);

package/dist/src/auth/profiles/store.js

@@ -1,6 +1,6 @@
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
-import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { homedir } from "os";
 //#region src/auth/profiles/store.ts
 /**

package/dist/src/auth/sync-provider-auth.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/browser/cache-dir-policy.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { isAbsolute, relative, resolve, sep } from "node:path";
 import { homedir } from "node:os";
+import { isAbsolute, relative, resolve, sep } from "node:path";
 //#region src/browser/cache-dir-policy.ts
 function expandHome(input) {
 	if (input === "~") return homedir();

package/dist/src/browser/cdp-local-launcher.js

@@ -2,10 +2,10 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
 import { pickFreePort } from "./free-port.js";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
-import { join } from "node:path";
-import { homedir, platform } from "node:os";
 import { spawn } from "node:child_process";
 //#region src/browser/cdp-local-launcher.ts
 /**