@xopcai/xopc 0.0.8 → 0.0.11

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

@@ -1 +1 @@
-{"version":3,"file":"tools.js","names":[],"sources":["../../../../../src/agent/tools/browser/tools.ts"],"sourcesContent":["import type { Static } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport type { Locator, Page } from 'playwright-core';\n\nimport type { Config } from '../../../config/schema.js';\nimport { describeImages } from '../../image/understanding/runtime.js';\nimport { buildImageToolTextResult } from '../../image/image-helpers.js';\nimport { runWithImageModelFallback } from '../../image/image-model-fallback.js';\nimport { resolveImageModelConfigForTool } from '../image-tool.js';\nimport type { BrowserManager } from './manager.js';\nimport {\n  BrowserClickSchema,\n  BrowserNavigateSchema,\n  BrowserScreenshotSchema,\n  BrowserScrollSchema,\n  BrowserSnapshotSchema,\n  BrowserTypeSchema,\n} from './schemas.js';\nimport { assertBrowserUrlAllowed } from './url-policy.js';\n\nconst DEFAULT_SNAPSHOT_MAX = 30_000;\nconst NAV_TIMEOUT_MS = 30_000;\nconst MAX_SCREENSHOT_BYTES = 6 * 1024 * 1024;\n\nexport interface CreateBrowserToolsDeps {\n  getManager: () => BrowserManager;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n}\n\nfunction resolveClickLocator(page: Page, params: Static<typeof BrowserClickSchema>): Locator {\n  const hasSel = Boolean(params.selector?.trim());\n  const hasText = Boolean(params.text?.trim());\n  const hasRole = Boolean(params.role?.trim());\n  const n = (hasSel ? 1 : 0) + (hasText ? 1 : 0) + (hasRole ? 1 : 0);\n  if (n !== 1) {\n    throw new Error('Provide exactly one of: selector, text, role');\n  }\n  if (hasSel) {\n    return page.locator(params.selector!.trim()).first();\n  }\n  if (hasText) {\n    return page.getByText(params.text!.trim(), { exact: false }).first();\n  }\n  const raw = params.role!.trim();\n  const idx = raw.indexOf(':');\n  const role = (idx >= 0 ? raw.slice(0, idx) : raw).trim();\n  const name = idx >= 0 ? raw.slice(idx + 1).trim() : '';\n  if (!role) {\n    throw new Error('Invalid role: empty ARIA role');\n  }\n  // Playwright typings list roles as a union; the model may pass any valid ARIA role string.\n  return page.getByRole(role as never, name ? { name } : undefined).first();\n}\n\nfunction resolveTypeLocator(page: Page, params: Static<typeof BrowserTypeSchema>): Locator {\n  const hasSel = Boolean(params.selector?.trim());\n  const hasLab = Boolean(params.label?.trim());\n  if (hasSel === hasLab) {\n    throw new Error('Provide exactly one of: selector, label');\n  }\n  if (hasSel) {\n    return page.locator(params.selector!.trim()).first();\n  }\n  return page.getByLabel(params.label!.trim()).first();\n}\n\nasync function ariaSnapshotFor(\n  page: Page,\n  selector: string | undefined,\n  maxLength: number,\n): Promise<string> {\n  const loc = selector?.trim() ? page.locator(selector.trim()).first() : page.locator('body');\n  await loc.waitFor({ state: 'attached', timeout: 15_000 });\n  let text = await loc.ariaSnapshot({ mode: 'ai', timeout: 15_000 });\n  if (!text || !text.trim()) {\n    text = '(empty snapshot)';\n  }\n  if (text.length > maxLength) {\n    text = `${text.slice(0, maxLength)}\\n... (truncated)`;\n  }\n  return text;\n}\n\nexport function createBrowserTools(deps: CreateBrowserToolsDeps): AgentTool<any, any>[] {\n  const pageFor = () => deps.getManager().getPage(deps.getTaskId());\n\n  const navigate: AgentTool<typeof BrowserNavigateSchema, { url: string; title: string }> = {\n    name: 'browser_navigate',\n    label: '🌐 Browser Navigate',\n    description:\n      'Navigate the headless browser to a URL. The page persists for this chat session.\\n' +\n      'Call `browser_snapshot` after navigation to inspect the UI. Only http(s) public URLs; private IPs and localhost are blocked.',\n    parameters: BrowserNavigateSchema,\n\n    async execute(_id, params, signal) {\n      assertBrowserUrlAllowed(params.url);\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const waitUntil = params.waitFor ?? 'domcontentloaded';\n      await page.goto(params.url, {\n        waitUntil,\n        timeout: NAV_TIMEOUT_MS,\n      });\n      const title = await page.title();\n      const url = page.url();\n      return {\n        content: [{ type: 'text', text: `Navigated to: ${title}\\nURL: ${url}` }],\n        details: { url, title },\n      };\n    },\n  };\n\n  const snapshot: AgentTool<typeof BrowserSnapshotSchema, { length: number }> = {\n    name: 'browser_snapshot',\n    label: '📸 Browser Snapshot',\n    description:\n      'Capture an AI-oriented ARIA snapshot of the current page (YAML-like tree with element refs).\\n' +\n      'Use after `browser_navigate` to see interactive elements before `browser_click` / `browser_type`.',\n    parameters: BrowserSnapshotSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const maxLength = params.maxLength ?? DEFAULT_SNAPSHOT_MAX;\n      try {\n        const text = await ariaSnapshotFor(page, params.selector, maxLength);\n        return {\n          content: [{ type: 'text', text }],\n          details: { length: text.length },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Snapshot failed: ${msg}` }],\n          details: { length: 0 },\n        };\n      }\n    },\n  };\n\n  const click: AgentTool<typeof BrowserClickSchema, { ok: boolean }> = {\n    name: 'browser_click',\n    label: '🖱️ Browser Click',\n    description:\n      'Click an element. Provide exactly one targeting mode: `selector` (CSS), `text` (visible text), or `role` (e.g. `button:Submit`).',\n    parameters: BrowserClickSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      try {\n        const loc = resolveClickLocator(page, params);\n        await loc.click({ timeout: 15_000 });\n        return {\n          content: [{ type: 'text', text: 'Click succeeded.' }],\n          details: { ok: true },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Click failed: ${msg}` }],\n          details: { ok: false },\n        };\n      }\n    },\n  };\n\n  const typeTool: AgentTool<typeof BrowserTypeSchema, { ok: boolean }> = {\n    name: 'browser_type',\n    label: '⌨️ Browser Type',\n    description:\n      'Type into an input. Provide exactly one of `selector` or `label` (associated label text). Optional `pressEnter` to submit.',\n    parameters: BrowserTypeSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      try {\n        const loc = resolveTypeLocator(page, params);\n        await loc.clear({ timeout: 5000 }).catch(() => {});\n        await loc.fill(params.text, { timeout: 15_000 });\n        if (params.pressEnter) {\n          await page.keyboard.press('Enter');\n        }\n        return {\n          content: [{ type: 'text', text: 'Typed into field.' }],\n          details: { ok: true },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Type failed: ${msg}` }],\n          details: { ok: false },\n        };\n      }\n    },\n  };\n\n  const scroll: AgentTool<typeof BrowserScrollSchema, { ok: boolean }> = {\n    name: 'browser_scroll',\n    label: '📜 Browser Scroll',\n    description: 'Scroll the page up or down by a pixel amount (default 500).',\n    parameters: BrowserScrollSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const amount = params.amount ?? 500;\n      const dy = params.direction === 'down' ? amount : -amount;\n      await page.evaluate(\n        ({ deltaY }) => {\n          (globalThis as unknown as { scrollBy: (x: number, y: number) => void }).scrollBy(0, deltaY);\n        },\n        { deltaY: dy },\n      );\n      return {\n        content: [{ type: 'text', text: `Scrolled ${params.direction} by ${amount}px.` }],\n        details: { ok: true },\n      };\n    },\n  };\n\n  const screenshot: AgentTool<typeof BrowserScreenshotSchema, Record<string, unknown>> = {\n    name: 'browser_screenshot',\n    label: '🖼️ Browser Screenshot',\n    description:\n      'Take a PNG screenshot of the viewport or a CSS selector. When `agents.defaults.imageModel` is configured, runs vision on the image using `description` as the prompt (default: short UI summary).',\n    parameters: BrowserScreenshotSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const cfg = deps.getConfig();\n      let buf: Buffer;\n      try {\n        if (params.selector?.trim()) {\n          const loc = page.locator(params.selector.trim()).first();\n          await loc.waitFor({ state: 'visible', timeout: 15_000 });\n          buf = await loc.screenshot({ type: 'png', timeout: 15_000 });\n        } else {\n          buf = await page.screenshot({ type: 'png', fullPage: false, timeout: 15_000 });\n        }\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Screenshot failed: ${msg}` }],\n          details: { error: msg },\n        };\n      }\n\n      if (buf.length > MAX_SCREENSHOT_BYTES) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Screenshot too large (${buf.length} bytes, max ${MAX_SCREENSHOT_BYTES}). Try a narrower selector.`,\n            },\n          ],\n          details: { error: 'too_large', bytes: buf.length },\n        };\n      }\n\n      const imageModelConfig = resolveImageModelConfigForTool({ cfg });\n      const prompt =\n        params.description?.trim() ||\n        'Describe this browser screenshot briefly. Focus on visible text, controls, and actionable UI state.';\n\n      if (!imageModelConfig) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text:\n                `Captured PNG screenshot (${buf.length} bytes). Configure agents.defaults.imageModel for automatic visual description.`,\n            },\n          ],\n          details: { bytes: buf.length, vision: false },\n        };\n      }\n\n      try {\n        const runResult = await runWithImageModelFallback({\n          toolConfig: imageModelConfig,\n          modelOverride: undefined,\n          run: async (modelRef) => {\n            const { text, provider, model } = await describeImages({\n              modelRef,\n              prompt,\n              images: [{ buffer: buf, mimeType: 'image/png' }],\n              timeoutMs: 60_000,\n              signal,\n            });\n            return { text, provider, model };\n          },\n        });\n        const { result: inner, attempts } = runResult;\n        return buildImageToolTextResult(\n          { text: inner.text, provider: inner.provider, model: inner.model, attempts },\n          { bytes: buf.length, vision: true },\n        );\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Screenshot captured (${buf.length} bytes) but vision failed: ${msg}`,\n            },\n          ],\n          details: { bytes: buf.length, visionError: msg },\n        };\n      }\n    },\n  };\n\n  return [navigate, snapshot, click, typeTool, scroll, screenshot];\n}\n"],"mappings":"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"}
+{"version":3,"file":"tools.js","names":[],"sources":["../../../../../src/agent/tools/browser/tools.ts"],"sourcesContent":["import type { Static } from '@sinclair/typebox';\nimport type { AgentTool } from '@mariozechner/pi-agent-core';\nimport type { Locator, Page } from 'playwright-core';\n\nimport type { Config } from '../../../config/schema.js';\nimport { describeImages } from '../../image/understanding/runtime.js';\nimport { buildImageToolTextResult } from '../../image/image-helpers.js';\nimport { runWithImageModelFallback } from '../../image/image-model-fallback.js';\nimport { resolveImageModelConfigForTool } from '../image-tool.js';\nimport type { BrowserManager } from './manager.js';\nimport {\n  BrowserClickSchema,\n  BrowserNavigateSchema,\n  BrowserScreenshotSchema,\n  BrowserScrollSchema,\n  BrowserSnapshotSchema,\n  BrowserTypeSchema,\n} from './schemas.js';\nimport { assertBrowserUrlAllowed } from './url-policy.js';\n\nconst DEFAULT_SNAPSHOT_MAX = 30_000;\nconst NAV_TIMEOUT_MS = 30_000;\nconst MAX_SCREENSHOT_BYTES = 6 * 1024 * 1024;\n\nexport interface CreateBrowserToolsDeps {\n  getManager: () => BrowserManager;\n  getTaskId: () => string;\n  getConfig: () => Config | undefined;\n}\n\nfunction resolveClickLocator(page: Page, params: Static<typeof BrowserClickSchema>): Locator {\n  const hasSel = Boolean(params.selector?.trim());\n  const hasText = Boolean(params.text?.trim());\n  const hasRole = Boolean(params.role?.trim());\n  const n = (hasSel ? 1 : 0) + (hasText ? 1 : 0) + (hasRole ? 1 : 0);\n  if (n !== 1) {\n    throw new Error('Provide exactly one of: selector, text, role');\n  }\n  if (hasSel) {\n    return page.locator(params.selector!.trim()).first();\n  }\n  if (hasText) {\n    return page.getByText(params.text!.trim(), { exact: false }).first();\n  }\n  const raw = params.role!.trim();\n  const idx = raw.indexOf(':');\n  const role = (idx >= 0 ? raw.slice(0, idx) : raw).trim();\n  const name = idx >= 0 ? raw.slice(idx + 1).trim() : '';\n  if (!role) {\n    throw new Error('Invalid role: empty ARIA role');\n  }\n  // Playwright typings list roles as a union; the model may pass any valid ARIA role string.\n  return page.getByRole(role as never, name ? { name } : undefined).first();\n}\n\nfunction resolveTypeLocator(page: Page, params: Static<typeof BrowserTypeSchema>): Locator {\n  const hasSel = Boolean(params.selector?.trim());\n  const hasLab = Boolean(params.label?.trim());\n  if (hasSel === hasLab) {\n    throw new Error('Provide exactly one of: selector, label');\n  }\n  if (hasSel) {\n    return page.locator(params.selector!.trim()).first();\n  }\n  return page.getByLabel(params.label!.trim()).first();\n}\n\nasync function ariaSnapshotFor(\n  page: Page,\n  selector: string | undefined,\n  maxLength: number,\n): Promise<string> {\n  const loc = selector?.trim() ? page.locator(selector.trim()).first() : page.locator('body');\n  await loc.waitFor({ state: 'attached', timeout: 15_000 });\n  let text = await loc.ariaSnapshot({ mode: 'ai', timeout: 15_000 });\n  if (!text || !text.trim()) {\n    text = '(empty snapshot)';\n  }\n  if (text.length > maxLength) {\n    text = `${text.slice(0, maxLength)}\\n... (truncated)`;\n  }\n  return text;\n}\n\nexport function createBrowserTools(deps: CreateBrowserToolsDeps): AgentTool<any, any>[] {\n  const pageFor = () => deps.getManager().getPage(deps.getTaskId());\n\n  const navigate: AgentTool<typeof BrowserNavigateSchema, { url: string; title: string }> = {\n    name: 'browser_navigate',\n    label: '🌐 Browser Navigate',\n    description:\n      'Navigate the headless browser to a URL. The page persists for this chat session.\\n' +\n      'Call `browser_snapshot` after navigation to inspect the UI. Only http(s) public URLs; private IPs and localhost are blocked.',\n    parameters: BrowserNavigateSchema,\n\n    async execute(_id, params, signal) {\n      assertBrowserUrlAllowed(params.url);\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const waitUntil = params.waitFor ?? 'domcontentloaded';\n      await page.goto(params.url, {\n        waitUntil,\n        timeout: NAV_TIMEOUT_MS,\n      });\n      const title = await page.title();\n      const url = page.url();\n      return {\n        content: [{ type: 'text', text: `Navigated to: ${title}\\nURL: ${url}` }],\n        details: { url, title },\n      };\n    },\n  };\n\n  const snapshot: AgentTool<typeof BrowserSnapshotSchema, { length: number }> = {\n    name: 'browser_snapshot',\n    label: '📸 Browser Snapshot',\n    description:\n      'Capture an AI-oriented ARIA snapshot of the current page (YAML-like tree with element refs).\\n' +\n      'Use after `browser_navigate` to see interactive elements before `browser_click` / `browser_type`.',\n    parameters: BrowserSnapshotSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const maxLength = params.maxLength ?? DEFAULT_SNAPSHOT_MAX;\n      try {\n        const text = await ariaSnapshotFor(page, params.selector, maxLength);\n        return {\n          content: [{ type: 'text', text }],\n          details: { length: text.length },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Snapshot failed: ${msg}` }],\n          details: { length: 0 },\n        };\n      }\n    },\n  };\n\n  const click: AgentTool<typeof BrowserClickSchema, { ok: boolean }> = {\n    name: 'browser_click',\n    label: '🖱️ Browser Click',\n    description:\n      'Click an element. Provide exactly one targeting mode: `selector` (CSS), `text` (visible text), or `role` (e.g. `button:Submit`).',\n    parameters: BrowserClickSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      try {\n        const loc = resolveClickLocator(page, params);\n        await loc.click({ timeout: 15_000 });\n        return {\n          content: [{ type: 'text', text: 'Click succeeded.' }],\n          details: { ok: true },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Click failed: ${msg}` }],\n          details: { ok: false },\n        };\n      }\n    },\n  };\n\n  const typeTool: AgentTool<typeof BrowserTypeSchema, { ok: boolean }> = {\n    name: 'browser_type',\n    label: '⌨️ Browser Type',\n    description:\n      'Type into an input. Provide exactly one of `selector` or `label` (associated label text). Optional `pressEnter` to submit.',\n    parameters: BrowserTypeSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      try {\n        const loc = resolveTypeLocator(page, params);\n        await loc.clear({ timeout: 5000 }).catch(() => {});\n        await loc.fill(params.text, { timeout: 15_000 });\n        if (params.pressEnter) {\n          await page.keyboard.press('Enter');\n        }\n        return {\n          content: [{ type: 'text', text: 'Typed into field.' }],\n          details: { ok: true },\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Type failed: ${msg}` }],\n          details: { ok: false },\n        };\n      }\n    },\n  };\n\n  const scroll: AgentTool<typeof BrowserScrollSchema, { ok: boolean }> = {\n    name: 'browser_scroll',\n    label: '📜 Browser Scroll',\n    description: 'Scroll the page up or down by a pixel amount (default 500).',\n    parameters: BrowserScrollSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const amount = params.amount ?? 500;\n      const dy = params.direction === 'down' ? amount : -amount;\n      await page.evaluate(\n        ({ deltaY }) => {\n          (globalThis as unknown as { scrollBy: (x: number, y: number) => void }).scrollBy(0, deltaY);\n        },\n        { deltaY: dy },\n      );\n      return {\n        content: [{ type: 'text', text: `Scrolled ${params.direction} by ${amount}px.` }],\n        details: { ok: true },\n      };\n    },\n  };\n\n  const screenshot: AgentTool<typeof BrowserScreenshotSchema, Record<string, unknown>> = {\n    name: 'browser_screenshot',\n    label: '🖼️ Browser Screenshot',\n    description:\n      'Take a PNG screenshot of the viewport or a CSS selector. When `agents.defaults.imageModel` is configured, runs vision on the image using `description` as the prompt (default: short UI summary).',\n    parameters: BrowserScreenshotSchema,\n\n    async execute(_id, params, signal) {\n      if (signal?.aborted) {\n        throw new Error('aborted');\n      }\n      const page = await pageFor();\n      const cfg = deps.getConfig();\n      let buf: Buffer;\n      try {\n        if (params.selector?.trim()) {\n          const loc = page.locator(params.selector.trim()).first();\n          await loc.waitFor({ state: 'visible', timeout: 15_000 });\n          buf = await loc.screenshot({ type: 'png', timeout: 15_000 });\n        } else {\n          buf = await page.screenshot({ type: 'png', fullPage: false, timeout: 15_000 });\n        }\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [{ type: 'text', text: `Screenshot failed: ${msg}` }],\n          details: { error: msg },\n        };\n      }\n\n      if (buf.length > MAX_SCREENSHOT_BYTES) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Screenshot too large (${buf.length} bytes, max ${MAX_SCREENSHOT_BYTES}). Try a narrower selector.`,\n            },\n          ],\n          details: { error: 'too_large', bytes: buf.length },\n        };\n      }\n\n      const imageModelConfig = resolveImageModelConfigForTool({ cfg });\n      const prompt =\n        params.description?.trim() ||\n        'Describe this browser screenshot briefly. Focus on visible text, controls, and actionable UI state.';\n\n      if (!imageModelConfig) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text:\n                `Captured PNG screenshot (${buf.length} bytes). Configure agents.defaults.imageModel for automatic visual description.`,\n            },\n          ],\n          details: { bytes: buf.length, vision: false },\n        };\n      }\n\n      try {\n        const runResult = await runWithImageModelFallback({\n          toolConfig: imageModelConfig,\n          modelOverride: undefined,\n          run: async (modelRef) => {\n            const { text, provider, model } = await describeImages({\n              modelRef,\n              prompt,\n              images: [{ buffer: buf, mimeType: 'image/png' }],\n              timeoutMs: 60_000,\n              signal,\n            });\n            return { text, provider, model };\n          },\n        });\n        const { result: inner, attempts } = runResult;\n        return buildImageToolTextResult(\n          { text: inner.text, provider: inner.provider, model: inner.model, attempts },\n          { bytes: buf.length, vision: true },\n        );\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Screenshot captured (${buf.length} bytes) but vision failed: ${msg}`,\n            },\n          ],\n          details: { bytes: buf.length, visionError: msg },\n        };\n      }\n    },\n  };\n\n  return [navigate, snapshot, click, typeTool, scroll, screenshot];\n}\n"],"mappings":"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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"image-tool.js","names":[],"sources":["../../../../src/agent/tools/image-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { describeImages } from '../image/understanding/runtime.js';\nimport { buildImageToolTextResult, resolvePromptAndModelOverride } from '../image/image-helpers.js';\nimport { runWithImageModelFallback } from '../image/image-model-fallback.js';\nimport { loadImageForToolInput } from '../image/load-image-media.js';\nimport {\n  resolveImageModelConfigForTool,\n  type ToolModelConfig,\n} from '../image/tool-model-config.js';\n\nconst DEFAULT_PROMPT = 'Describe the image.';\nconst DEFAULT_MAX_IMAGES = 20;\n\nexport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nfunction pickMaxBytes(cfg?: Config, maxBytesMb?: number): number {\n  if (typeof maxBytesMb === 'number' && Number.isFinite(maxBytesMb) && maxBytesMb > 0) {\n    return Math.floor(maxBytesMb * 1024 * 1024);\n  }\n  const configured = cfg?.agents?.defaults?.mediaMaxMb;\n  if (typeof configured === 'number' && Number.isFinite(configured) && configured > 0) {\n    return Math.floor(configured * 1024 * 1024);\n  }\n  return 20 * 1024 * 1024;\n}\n\nexport function createImageTool(options: {\n  config?: Config;\n  workspace: string;\n  /** When true, session model already receives images in the user message. */\n  modelHasVision?: boolean;\n}): AgentTool<any, Record<string, unknown>> | null {\n  const imageModelConfig = resolveImageModelConfigForTool({ cfg: options.config });\n  if (!imageModelConfig) {\n    return null;\n  }\n\n  const description = options.modelHasVision\n    ? 'Analyze one or more images with a vision model. Use `image` for a single path/URL, or `images` for multiple (up to 20). Only use when images were NOT already in the user message.'\n    : 'Analyze one or more images using the configured image model (agents.defaults.imageModel). Use `image` or `images` for paths/URLs; optional `prompt` for what to extract.';\n\n  const localRoots = [options.workspace];\n\n  return {\n    name: 'image',\n    label: 'Image',\n    description,\n    parameters: Type.Object({\n      prompt: Type.Optional(Type.String()),\n      image: Type.Optional(Type.String({ description: 'Single image path or URL.' })),\n      images: Type.Optional(\n        Type.Array(Type.String(), {\n          description: 'Multiple image paths or URLs (up to maxImages, default 20).',\n        }),\n      ),\n      model: Type.Optional(Type.String({ description: 'Optional provider/model override.' })),\n      maxBytesMb: Type.Optional(Type.Number()),\n      maxImages: Type.Optional(Type.Number()),\n    }),\n    async execute(\n      _toolCallId: string,\n      args: Record<string, unknown>,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const record = args && typeof args === 'object' ? args : {};\n\n      const imageCandidates: string[] = [];\n      if (typeof record.image === 'string') {\n        imageCandidates.push(record.image);\n      }\n      if (Array.isArray(record.images)) {\n        imageCandidates.push(...record.images.filter((v): v is string => typeof v === 'string'));\n      }\n\n      const seenImages = new Set<string>();\n      const imageInputs: string[] = [];\n      for (const candidate of imageCandidates) {\n        const trimmedCandidate = candidate.trim();\n        const normalizedForDedupe = trimmedCandidate.startsWith('@')\n          ? trimmedCandidate.slice(1).trim()\n          : trimmedCandidate;\n        if (!normalizedForDedupe || seenImages.has(normalizedForDedupe)) {\n          continue;\n        }\n        seenImages.add(normalizedForDedupe);\n        imageInputs.push(trimmedCandidate);\n      }\n\n      if (imageInputs.length === 0) {\n        return {\n          content: [{ type: 'text', text: 'Error: provide `image` or `images`.' }],\n          details: { error: 'missing_image' },\n        };\n      }\n\n      const maxImagesRaw = typeof record.maxImages === 'number' ? record.maxImages : undefined;\n      const maxImages =\n        typeof maxImagesRaw === 'number' && Number.isFinite(maxImagesRaw) && maxImagesRaw > 0\n          ? Math.floor(maxImagesRaw)\n          : DEFAULT_MAX_IMAGES;\n      if (imageInputs.length > maxImages) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Too many images: ${imageInputs.length} (max ${maxImages}).`,\n            },\n          ],\n          details: { error: 'too_many_images', count: imageInputs.length, max: maxImages },\n        };\n      }\n\n      const { prompt: promptRaw, modelOverride } = resolvePromptAndModelOverride(\n        record,\n        DEFAULT_PROMPT,\n      );\n      const maxBytesMb = typeof record.maxBytesMb === 'number' ? record.maxBytesMb : undefined;\n      const maxBytes = pickMaxBytes(options.config, maxBytesMb);\n\n      const loadedImages: Array<{ buffer: Buffer; mimeType: string; resolvedImage: string }> = [];\n\n      for (const imageRawInput of imageInputs) {\n        const trimmed = imageRawInput.trim();\n        const imageRaw = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n        if (!imageRaw) {\n          return {\n            content: [{ type: 'text', text: 'Error: empty image entry.' }],\n            details: { error: 'empty_image' },\n          };\n        }\n\n        const looksLikeWindowsDrivePath = /^[a-zA-Z]:[\\\\/]/.test(imageRaw);\n        const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(imageRaw);\n        const isFileUrl = /^file:/i.test(imageRaw);\n        const isHttpUrl = /^https?:\\/\\//i.test(imageRaw);\n        const isDataUrl = /^data:/i.test(imageRaw);\n        if (hasScheme && !looksLikeWindowsDrivePath && !isFileUrl && !isHttpUrl && !isDataUrl) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Unsupported image reference: ${imageRawInput}. Use a path, file://, data:, or http(s) URL.`,\n              },\n            ],\n            details: { error: 'unsupported_image_reference', image: imageRawInput },\n          };\n        }\n\n        try {\n          const media = await loadImageForToolInput(imageRaw, {\n            maxBytes,\n            workspace: options.workspace,\n            localRoots,\n          });\n          loadedImages.push({\n            buffer: media.buffer,\n            mimeType: media.mimeType,\n            resolvedImage: imageRaw,\n          });\n        } catch (e) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Failed to load image (${imageRawInput}): ${e instanceof Error ? e.message : String(e)}`,\n              },\n            ],\n            details: { error: 'load_failed', image: imageRawInput },\n          };\n        }\n      }\n\n      const runResult = await runWithImageModelFallback({\n        toolConfig: imageModelConfig,\n        modelOverride,\n        run: async (modelRef) => {\n          const { text, provider, model } = await describeImages({\n            modelRef,\n            prompt: promptRaw,\n            images: loadedImages.map((img) => ({ buffer: img.buffer, mimeType: img.mimeType })),\n            timeoutMs: 60_000,\n          });\n          return { text, provider, model };\n        },\n      });\n\n      const { result: inner, attempts } = runResult;\n      const result = {\n        text: inner.text,\n        provider: inner.provider,\n        model: inner.model,\n        attempts,\n      };\n\n      const imageDetails =\n        loadedImages.length === 1\n          ? { image: loadedImages[0].resolvedImage }\n          : {\n              images: loadedImages.map((img) => ({ image: img.resolvedImage })),\n            };\n\n      return buildImageToolTextResult(result, imageDetails);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"image-tool.js","names":[],"sources":["../../../../src/agent/tools/image-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport type { Config } from '../../config/schema.js';\nimport { describeImages } from '../image/understanding/runtime.js';\nimport { buildImageToolTextResult, resolvePromptAndModelOverride } from '../image/image-helpers.js';\nimport { runWithImageModelFallback } from '../image/image-model-fallback.js';\nimport { loadImageForToolInput } from '../image/load-image-media.js';\nimport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nconst DEFAULT_PROMPT = 'Describe the image.';\nconst DEFAULT_MAX_IMAGES = 20;\n\nexport { resolveImageModelConfigForTool } from '../image/tool-model-config.js';\n\nfunction pickMaxBytes(cfg?: Config, maxBytesMb?: number): number {\n  if (typeof maxBytesMb === 'number' && Number.isFinite(maxBytesMb) && maxBytesMb > 0) {\n    return Math.floor(maxBytesMb * 1024 * 1024);\n  }\n  const configured = cfg?.agents?.defaults?.mediaMaxMb;\n  if (typeof configured === 'number' && Number.isFinite(configured) && configured > 0) {\n    return Math.floor(configured * 1024 * 1024);\n  }\n  return 20 * 1024 * 1024;\n}\n\nexport function createImageTool(options: {\n  config?: Config;\n  workspace: string;\n  /** When true, session model already receives images in the user message. */\n  modelHasVision?: boolean;\n}): AgentTool<any, Record<string, unknown>> | null {\n  const imageModelConfig = resolveImageModelConfigForTool({ cfg: options.config });\n  if (!imageModelConfig) {\n    return null;\n  }\n\n  const description = options.modelHasVision\n    ? 'Analyze one or more images with a vision model. Use `image` for a single path/URL, or `images` for multiple (up to 20). Only use when images were NOT already in the user message.'\n    : 'Analyze one or more images using the configured image model (agents.defaults.imageModel). Use `image` or `images` for paths/URLs; optional `prompt` for what to extract.';\n\n  const localRoots = [options.workspace];\n\n  return {\n    name: 'image',\n    label: 'Image',\n    description,\n    parameters: Type.Object({\n      prompt: Type.Optional(Type.String()),\n      image: Type.Optional(Type.String({ description: 'Single image path or URL.' })),\n      images: Type.Optional(\n        Type.Array(Type.String(), {\n          description: 'Multiple image paths or URLs (up to maxImages, default 20).',\n        }),\n      ),\n      model: Type.Optional(Type.String({ description: 'Optional provider/model override.' })),\n      maxBytesMb: Type.Optional(Type.Number()),\n      maxImages: Type.Optional(Type.Number()),\n    }),\n    async execute(\n      _toolCallId: string,\n      args: Record<string, unknown>,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const record = args && typeof args === 'object' ? args : {};\n\n      const imageCandidates: string[] = [];\n      if (typeof record.image === 'string') {\n        imageCandidates.push(record.image);\n      }\n      if (Array.isArray(record.images)) {\n        imageCandidates.push(...record.images.filter((v): v is string => typeof v === 'string'));\n      }\n\n      const seenImages = new Set<string>();\n      const imageInputs: string[] = [];\n      for (const candidate of imageCandidates) {\n        const trimmedCandidate = candidate.trim();\n        const normalizedForDedupe = trimmedCandidate.startsWith('@')\n          ? trimmedCandidate.slice(1).trim()\n          : trimmedCandidate;\n        if (!normalizedForDedupe || seenImages.has(normalizedForDedupe)) {\n          continue;\n        }\n        seenImages.add(normalizedForDedupe);\n        imageInputs.push(trimmedCandidate);\n      }\n\n      if (imageInputs.length === 0) {\n        return {\n          content: [{ type: 'text', text: 'Error: provide `image` or `images`.' }],\n          details: { error: 'missing_image' },\n        };\n      }\n\n      const maxImagesRaw = typeof record.maxImages === 'number' ? record.maxImages : undefined;\n      const maxImages =\n        typeof maxImagesRaw === 'number' && Number.isFinite(maxImagesRaw) && maxImagesRaw > 0\n          ? Math.floor(maxImagesRaw)\n          : DEFAULT_MAX_IMAGES;\n      if (imageInputs.length > maxImages) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Too many images: ${imageInputs.length} (max ${maxImages}).`,\n            },\n          ],\n          details: { error: 'too_many_images', count: imageInputs.length, max: maxImages },\n        };\n      }\n\n      const { prompt: promptRaw, modelOverride } = resolvePromptAndModelOverride(\n        record,\n        DEFAULT_PROMPT,\n      );\n      const maxBytesMb = typeof record.maxBytesMb === 'number' ? record.maxBytesMb : undefined;\n      const maxBytes = pickMaxBytes(options.config, maxBytesMb);\n\n      const loadedImages: Array<{ buffer: Buffer; mimeType: string; resolvedImage: string }> = [];\n\n      for (const imageRawInput of imageInputs) {\n        const trimmed = imageRawInput.trim();\n        const imageRaw = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n        if (!imageRaw) {\n          return {\n            content: [{ type: 'text', text: 'Error: empty image entry.' }],\n            details: { error: 'empty_image' },\n          };\n        }\n\n        const looksLikeWindowsDrivePath = /^[a-zA-Z]:[\\\\/]/.test(imageRaw);\n        const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(imageRaw);\n        const isFileUrl = /^file:/i.test(imageRaw);\n        const isHttpUrl = /^https?:\\/\\//i.test(imageRaw);\n        const isDataUrl = /^data:/i.test(imageRaw);\n        if (hasScheme && !looksLikeWindowsDrivePath && !isFileUrl && !isHttpUrl && !isDataUrl) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Unsupported image reference: ${imageRawInput}. Use a path, file://, data:, or http(s) URL.`,\n              },\n            ],\n            details: { error: 'unsupported_image_reference', image: imageRawInput },\n          };\n        }\n\n        try {\n          const media = await loadImageForToolInput(imageRaw, {\n            maxBytes,\n            workspace: options.workspace,\n            localRoots,\n          });\n          loadedImages.push({\n            buffer: media.buffer,\n            mimeType: media.mimeType,\n            resolvedImage: imageRaw,\n          });\n        } catch (e) {\n          return {\n            content: [\n              {\n                type: 'text',\n                text: `Failed to load image (${imageRawInput}): ${e instanceof Error ? e.message : String(e)}`,\n              },\n            ],\n            details: { error: 'load_failed', image: imageRawInput },\n          };\n        }\n      }\n\n      const runResult = await runWithImageModelFallback({\n        toolConfig: imageModelConfig,\n        modelOverride,\n        run: async (modelRef) => {\n          const { text, provider, model } = await describeImages({\n            modelRef,\n            prompt: promptRaw,\n            images: loadedImages.map((img) => ({ buffer: img.buffer, mimeType: img.mimeType })),\n            timeoutMs: 60_000,\n          });\n          return { text, provider, model };\n        },\n      });\n\n      const { result: inner, attempts } = runResult;\n      const result = {\n        text: inner.text,\n        provider: inner.provider,\n        model: inner.model,\n        attempts,\n      };\n\n      const imageDetails =\n        loadedImages.length === 1\n          ? { image: loadedImages[0].resolvedImage }\n          : {\n              images: loadedImages.map((img) => ({ image: img.resolvedImage })),\n            };\n\n      return buildImageToolTextResult(result, imageDetails);\n    },\n  };\n}\n"],"mappings":"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"}

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 { basename } from "node:path";
 import { readFile } from "fs/promises";
+import { basename } from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
 const SendMediaSchema = Type.Object({

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/write.js

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

package/dist/src/auth/credentials.js

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

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/channels/attachments/inbound-persist.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { join, resolve } from "path";
 import { mkdir, writeFile } from "fs/promises";
+import { join, resolve } from "path";
 import { randomBytes } from "crypto";
 //#region src/channels/attachments/inbound-persist.ts
 /**

package/dist/src/channels/attachments/outbound-tts-persist.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { join, resolve } from "path";
 import { mkdir, writeFile } from "fs/promises";
+import { join, resolve } from "path";
 import { randomBytes } from "crypto";
 //#region src/channels/attachments/outbound-tts-persist.ts
 /**

package/dist/src/channels/index.d.ts

@@ -8,7 +8,7 @@ export { CHAT_CHANNEL_ORDER, getChatChannelMeta, isChatChannelId, listChatChanne
 export { getChannelDock, getDockForBuiltinChannel, type ChannelDock } from './dock.js';
 export type { ChannelPlugin, ChannelPluginDefaults, ChannelPluginInitOptions, ChannelPluginSessionModelHooks, ChannelPluginReloadMeta, ChannelPluginStartOptions, ChannelOutboundContext, ChannelOutboundPayloadContext, OutboundDeliveryResult, ChannelStreamHandle, ChannelStatusAdapter, ChannelSecurityAdapter, ChannelConfigAdapter, ChannelStreamingAdapter, ChannelCapabilities, ChannelMeta, ChannelAccountSnapshot, StreamMode, ChannelOutboundMediaType, } from './plugin-types.js';
 export { compileAllowlist, resolveAllowlistMatch, resolveAllowlistMatchSimple, evaluateAccess, resolveDmPolicy, resolveGroupPolicy, hasBotMention, removeBotMention, } from './security.js';
-export { MessagePipeline, createPipeline, createFilterSelfHandler, createFilterEmptyHandler, createFilterCommandsHandler, standardPreflightHandlers, standardProcessHandlers, type PipelineMessageContext, type PipelineMediaRef, type PreflightHandler, type ProcessHandler, type DeliveryHandler, type AgentResponse, } from './pipeline.js';
+export { MessagePipeline, createPipeline, createEnvelopeTimestampHandler, createFilterSelfHandler, createFilterEmptyHandler, createFilterCommandsHandler, standardPreflightHandlers, standardProcessHandlers, type PipelineMessageContext, type PipelineMediaRef, type PreflightHandler, type ProcessHandler, type DeliveryHandler, type AgentResponse, } from './pipeline.js';
 export { ChannelManager, createChannelManager, type OutboundChannelHooks } from './manager.js';
 export { collectSetupWizardChannels } from './setup-wizard-discovery.js';
 export { listChannelPlugins, getChannelPlugin, getChannelRegistryVersion, syncChannelPluginsFromManager, } from './plugins/registry.js';

package/dist/src/channels/index.js

@@ -11,8 +11,8 @@ import { bundledChannelPlugins } from "../generated/bundled-channel-plugins.js";
 import "./plugins/bundled.js";
 import { getChannelDock, getDockForBuiltinChannel } from "./dock.js";
 import "./format.js";
-import { MessagePipeline, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createPipeline, standardPreflightHandlers, standardProcessHandlers } from "./pipeline.js";
+import { MessagePipeline, createEnvelopeTimestampHandler, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createPipeline, standardPreflightHandlers, standardProcessHandlers } from "./pipeline.js";
 import { getChannelPlugin, getChannelRegistryVersion, listChannelPlugins, syncChannelPluginsFromManager } from "./plugins/registry.js";
 import { ChannelManager, createChannelManager } from "./manager.js";
 import { collectSetupWizardChannels } from "./setup-wizard-discovery.js";
-export { CHAT_CHANNEL_ORDER, ChannelManager, MessagePipeline, buildCodeSpanIndex, bundledChannelPlugins, chunkMarkdownIR, chunkText, collectSetupWizardChannels, compileAllowlist, convertMarkdownTables, createChannelManager, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createInlineCodeState, createPipeline, evaluateAccess, findFenceSpanAt, getChannelDock, getChannelPlugin, getChannelRegistryVersion, getChatChannelMeta, getDockForBuiltinChannel, hasBotMention, isChatChannelId, isSafeFenceBreak, listChannelPlugins, listChatChannelMeta, markdownToIR, markdownToIRWithMeta, parseFenceSpans, parseFrontmatterBlock, removeBotMention, renderMarkdownWithMarkers, resolveAllowlistMatch, resolveAllowlistMatchSimple, resolveDmPolicy, resolveGroupPolicy, standardPreflightHandlers, standardProcessHandlers, syncChannelPluginsFromManager };
+export { CHAT_CHANNEL_ORDER, ChannelManager, MessagePipeline, buildCodeSpanIndex, bundledChannelPlugins, chunkMarkdownIR, chunkText, collectSetupWizardChannels, compileAllowlist, convertMarkdownTables, createChannelManager, createEnvelopeTimestampHandler, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createInlineCodeState, createPipeline, evaluateAccess, findFenceSpanAt, getChannelDock, getChannelPlugin, getChannelRegistryVersion, getChatChannelMeta, getDockForBuiltinChannel, hasBotMention, isChatChannelId, isSafeFenceBreak, listChannelPlugins, listChatChannelMeta, markdownToIR, markdownToIRWithMeta, parseFenceSpans, parseFrontmatterBlock, removeBotMention, renderMarkdownWithMarkers, resolveAllowlistMatch, resolveAllowlistMatchSimple, resolveDmPolicy, resolveGroupPolicy, standardPreflightHandlers, standardProcessHandlers, syncChannelPluginsFromManager };

package/dist/src/channels/pipeline.d.ts

@@ -101,15 +101,22 @@ export declare function createFilterCommandsHandler(commands: string[]): Preflig
  * Create standard preflight handlers
  */
 export declare function standardPreflightHandlers(botId: string): PreflightHandler[];
+/**
+ * Prepends a per-turn `[YYYY-MM-DD HH:MM TZ]` prefix to inbound text so the model has
+ * a stable "now" without changing the system prompt (prompt-cache friendly).
+ */
+export declare function createEnvelopeTimestampHandler(timezone?: string): ProcessHandler;
 /**
  * Create standard process handlers
  */
-export declare function standardProcessHandlers(): ProcessHandler[];
+export declare function standardProcessHandlers(timezone?: string): ProcessHandler[];
 export interface CreatePipelineParams {
     channel: string;
     botId: string;
     agentInvoke: PipelineOptions['agentInvoke'];
     onError?: PipelineOptions['onError'];
+    /** IANA timezone — matches userTimezone from agent config / USER.md */
+    timezone?: string;
 }
 /**
  * Create message processing pipeline

package/dist/src/channels/pipeline.js

@@ -196,11 +196,56 @@ function standardPreflightHandlers(botId) {
 		])
 	];
 }
+function formatEnvelopeTimestamp(timezone) {
+	const now = /* @__PURE__ */ new Date();
+	try {
+		const resolvedTimezone = timezone?.trim() || Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+		const parts = new Intl.DateTimeFormat("en-US", {
+			timeZone: resolvedTimezone,
+			year: "numeric",
+			month: "2-digit",
+			day: "2-digit",
+			hour: "2-digit",
+			minute: "2-digit",
+			hour12: false,
+			timeZoneName: "short"
+		}).formatToParts(now);
+		const map = {};
+		for (const part of parts) if (part.type !== "literal") map[part.type] = part.value;
+		const year = map.year ?? "";
+		const month = map.month ?? "";
+		const day = map.day ?? "";
+		const hour = map.hour ?? "";
+		const minute = map.minute ?? "";
+		const tzName = map.timeZoneName ?? "";
+		if (!year || !month || !day || !hour || !minute) return `${now.toISOString().slice(0, 16).replace("T", " ")} UTC`;
+		return `${year}-${month}-${day} ${hour}:${minute}${tzName ? ` ${tzName}` : ""}`;
+	} catch {
+		return `${now.toISOString().slice(0, 16).replace("T", " ")} UTC`;
+	}
+}
+/**
+* Prepends a per-turn `[YYYY-MM-DD HH:MM TZ]` prefix to inbound text so the model has
+* a stable "now" without changing the system prompt (prompt-cache friendly).
+*/
+function createEnvelopeTimestampHandler(timezone) {
+	return {
+		name: "envelopeTimestamp",
+		process: async (ctx) => {
+			if (!ctx.content?.trim()) return ctx;
+			const timestamp = formatEnvelopeTimestamp(timezone);
+			return {
+				...ctx,
+				content: `[${timestamp}] ${ctx.content}`
+			};
+		}
+	};
+}
 /**
 * Create standard process handlers
 */
-function standardProcessHandlers() {
-	return [];
+function standardProcessHandlers(timezone) {
+	return [createEnvelopeTimestampHandler(timezone)];
 }
 /**
 * Create message processing pipeline
@@ -209,12 +254,12 @@ function createPipeline(params) {
 	return new MessagePipeline({
 		channel: params.channel,
 		preflightHandlers: standardPreflightHandlers(params.botId),
-		processHandlers: standardProcessHandlers(),
+		processHandlers: standardProcessHandlers(params.timezone),
 		agentInvoke: params.agentInvoke,
 		onError: params.onError
 	});
 }
 //#endregion
-export { MessagePipeline, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createPipeline, standardPreflightHandlers, standardProcessHandlers };
+export { MessagePipeline, createEnvelopeTimestampHandler, createFilterCommandsHandler, createFilterEmptyHandler, createFilterSelfHandler, createPipeline, standardPreflightHandlers, standardProcessHandlers };
 
 //# sourceMappingURL=pipeline.js.map

package/dist/src/channels/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","names":[],"sources":["../../../src/channels/pipeline.ts"],"sourcesContent":["/**\n * Message Processing Pipeline\n * \n * Three-stage pipeline:\n * - Preflight: Filter empty messages, self-messages, detect commands\n * - Process: Transform format, extract metadata\n * - Delivery: Send to Agent\n */\n\nimport { randomUUID } from 'node:crypto';\n\nimport { createLogger, runWithLogContext, updateAsyncLogContext } from '../utils/logger.js';\nimport type { AgentResponse } from './plugin-types.js';\n\n// Re-export for convenience\nexport type { AgentResponse } from './plugin-types.js';\n\nconst log = createLogger('Pipeline');\n\nfunction pipelineLogRequestId(ctx: PipelineMessageContext): string {\n  const raw = ctx.metadata?.requestId;\n  if (typeof raw === 'string' && raw.trim().length > 0) {\n    return raw.trim();\n  }\n  return randomUUID();\n}\n\nfunction pipelineLogSessionId(ctx: PipelineMessageContext): string {\n  const sk = ctx.metadata?.sessionKey;\n  if (typeof sk === 'string' && sk.trim().length > 0) {\n    return sk.trim();\n  }\n  return `${ctx.channel}:${ctx.chatId}`;\n}\n\n// ============================================\n// Types\n// ============================================\n\nexport interface PipelineMessageContext {\n  /** Channel identifier */\n  channel: string;\n  /** Account ID */\n  accountId: string;\n  /** Chat ID */\n  chatId: string;\n  /** Sender ID */\n  senderId: string;\n  /** Message content */\n  content: string;\n  /** Original message metadata */\n  metadata: Record<string, unknown>;\n  /** Is group chat */\n  isGroup: boolean;\n  /** Is direct message */\n  isDm: boolean;\n  /** Thread ID (optional) */\n  threadId?: string;\n  /** Message ID (optional) */\n  messageId?: string;\n}\n\nexport interface PipelineMediaRef {\n  type: 'photo' | 'video' | 'audio' | 'document' | 'voice';\n  fileId: string;\n  mimeType?: string;\n  fileName?: string;\n  url?: string;\n}\n\n// ============================================\n// Handler Interfaces\n// ============================================\n\nexport interface PreflightHandler {\n  /** Handler name */\n  name: string;\n  /** Preflight - return null to skip message */\n  preflight?(ctx: PipelineMessageContext): Promise<PipelineMessageContext | null>;\n}\n\nexport interface ProcessHandler {\n  /** Handler name */\n  name: string;\n  /** Process message - transform and extract */\n  process(ctx: PipelineMessageContext): Promise<PipelineMessageContext>;\n}\n\nexport interface DeliveryHandler {\n  /** Handler name */\n  name: string;\n  /** Deliver message to Agent */\n  deliver(ctx: PipelineMessageContext, response: AgentResponse): Promise<void>;\n}\n\n// ============================================\n// Pipeline Options\n// ============================================\n\nexport interface PipelineOptions {\n  /** Channel name */\n  channel: string;\n  /** Preflight handlers */\n  preflightHandlers?: PreflightHandler[];\n  /** Process handlers */\n  processHandlers?: ProcessHandler[];\n  /** Delivery handlers */\n  deliveryHandlers?: DeliveryHandler[];\n  /** Agent callback */\n  agentInvoke?: (ctx: PipelineMessageContext) => Promise<AgentResponse>;\n  /** Error handler */\n  onError?: (err: unknown, ctx: PipelineMessageContext) => void;\n}\n\n// ============================================\n// Pipeline Implementation\n// ============================================\n\nexport class MessagePipeline {\n  private channel: string;\n  private preflightHandlers: PreflightHandler[];\n  private processHandlers: ProcessHandler[];\n  private deliveryHandlers: DeliveryHandler[];\n  private agentInvoke?: PipelineOptions['agentInvoke'];\n  private onError?: PipelineOptions['onError'];\n\n  constructor(options: PipelineOptions) {\n    this.channel = options.channel;\n    this.preflightHandlers = options.preflightHandlers ?? [];\n    this.processHandlers = options.processHandlers ?? [];\n    this.deliveryHandlers = options.deliveryHandlers ?? [];\n    this.agentInvoke = options.agentInvoke;\n    this.onError = options.onError;\n  }\n\n  /**\n   * Handle inbound message\n   */\n  async handleMessage(ctx: PipelineMessageContext): Promise<void> {\n    const channel = this.channel;\n    const requestId = pipelineLogRequestId(ctx);\n\n    await runWithLogContext(\n      {\n        requestId,\n        sessionId: pipelineLogSessionId(ctx),\n      },\n      async () => {\n        // 1. Preflight stage\n        let processedCtx = await this.runPreflight(ctx);\n        if (!processedCtx) {\n          log.debug({ channel, chatId: ctx.chatId }, 'Message filtered in preflight');\n          return;\n        }\n\n        // 2. Process stage\n        try {\n          processedCtx = await this.runProcess(processedCtx);\n        } catch (err) {\n          log.error({ channel, err }, 'Process handler error');\n          this.onError?.(err, processedCtx);\n          return;\n        }\n\n        const resolvedSk = processedCtx.metadata?.sessionKey;\n        if (typeof resolvedSk === 'string' && resolvedSk.trim().length > 0) {\n          updateAsyncLogContext({ sessionId: resolvedSk.trim() });\n        }\n\n        // 3. Deliver to Agent\n        if (!this.agentInvoke) {\n          log.warn({ channel }, 'No agentInvoke configured');\n          return;\n        }\n\n        let response: AgentResponse;\n        try {\n          response = await this.agentInvoke(processedCtx);\n        } catch (err) {\n          log.error({ channel, err }, 'Agent invocation error');\n          this.onError?.(err, processedCtx);\n          return;\n        }\n\n        // 4. Delivery stage\n        try {\n          await this.runDelivery(processedCtx, response);\n        } catch (err) {\n          log.error({ channel, err }, 'Delivery handler error');\n          this.onError?.(err, processedCtx);\n        }\n      },\n    );\n  }\n\n  private async runPreflight(ctx: PipelineMessageContext): Promise<PipelineMessageContext | null> {\n    for (const handler of this.preflightHandlers) {\n      try {\n        const result = await handler.preflight?.(ctx);\n        if (!result) {\n          log.debug({ channel: this.channel, handler: handler.name }, 'Preflight filtered message');\n          return null;\n        }\n        ctx = result;\n      } catch (err) {\n        log.error({ channel: this.channel, handler: handler.name, err }, 'Preflight handler error');\n        return null;\n      }\n    }\n    return ctx;\n  }\n\n  private async runProcess(ctx: PipelineMessageContext): Promise<PipelineMessageContext> {\n    for (const handler of this.processHandlers) {\n      try {\n        ctx = await handler.process(ctx);\n      } catch (err) {\n        log.error({ channel: this.channel, handler: handler.name, err }, 'Process handler error');\n        throw err;\n      }\n    }\n    return ctx;\n  }\n\n  private async runDelivery(ctx: PipelineMessageContext, response: AgentResponse): Promise<void> {\n    for (const handler of this.deliveryHandlers) {\n      try {\n        await handler.deliver(ctx, response);\n      } catch (err) {\n        log.error({ channel: this.channel, handler: handler.name, err }, 'Delivery handler error');\n        throw err;\n      }\n    }\n  }\n}\n\n// ============================================\n// Standard Handlers\n// ============================================\n\n/**\n * Create filter-self handler\n */\nexport function createFilterSelfHandler(currentBotId: string): PreflightHandler {\n  return {\n    name: 'filterSelf',\n    preflight: async (ctx) => {\n      if (ctx.senderId === currentBotId) {\n        return null;\n      }\n      return ctx;\n    },\n  };\n}\n\n/**\n * Create filter-empty handler\n */\nexport function createFilterEmptyHandler(): PreflightHandler {\n  return {\n    name: 'filterEmpty',\n    preflight: async (ctx) => {\n      const content = ctx.content?.trim() ?? '';\n      if (!content && (!ctx.metadata.media || (ctx.metadata.media as PipelineMediaRef[]).length === 0)) {\n        return null;\n      }\n      return ctx;\n    },\n  };\n}\n\n/**\n * Create filter-commands handler\n */\nexport function createFilterCommandsHandler(commands: string[]): PreflightHandler {\n  const commandSet = new Set(commands.map(c => c.toLowerCase()));\n  return {\n    name: 'filterCommands',\n    preflight: async (ctx) => {\n      const firstWord = ctx.content?.split(/\\s/)[0]?.toLowerCase() ?? '';\n      if (firstWord.startsWith('/') && commandSet.has(firstWord.slice(1))) {\n        ctx.metadata.isCommand = true;\n        ctx.metadata.command = firstWord.slice(1);\n      }\n      return ctx;\n    },\n  };\n}\n\n/**\n * Create standard preflight handlers\n */\nexport function standardPreflightHandlers(botId: string): PreflightHandler[] {\n  return [\n    createFilterSelfHandler(botId),\n    createFilterEmptyHandler(),\n    createFilterCommandsHandler(['start', 'help', 'status', 'stop']),\n  ];\n}\n\n/**\n * Create standard process handlers\n */\nexport function standardProcessHandlers(): ProcessHandler[] {\n  return [];\n}\n\n// ============================================\n// Factory\n// ============================================\n\nexport interface CreatePipelineParams {\n  channel: string;\n  botId: string;\n  agentInvoke: PipelineOptions['agentInvoke'];\n  onError?: PipelineOptions['onError'];\n}\n\n/**\n * Create message processing pipeline\n */\nexport function createPipeline(params: CreatePipelineParams): MessagePipeline {\n  return new MessagePipeline({\n    channel: params.channel,\n    preflightHandlers: standardPreflightHandlers(params.botId),\n    processHandlers: standardProcessHandlers(),\n    agentInvoke: params.agentInvoke,\n    onError: params.onError,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"pipeline.js","names":[],"sources":["../../../src/channels/pipeline.ts"],"sourcesContent":["/**\n * Message Processing Pipeline\n * \n * Three-stage pipeline:\n * - Preflight: Filter empty messages, self-messages, detect commands\n * - Process: Transform format, extract metadata\n * - Delivery: Send to Agent\n */\n\nimport { randomUUID } from 'node:crypto';\n\nimport { createLogger, runWithLogContext, updateAsyncLogContext } from '../utils/logger.js';\nimport type { AgentResponse } from './plugin-types.js';\n\n// Re-export for convenience\nexport type { AgentResponse } from './plugin-types.js';\n\nconst log = createLogger('Pipeline');\n\nfunction pipelineLogRequestId(ctx: PipelineMessageContext): string {\n  const raw = ctx.metadata?.requestId;\n  if (typeof raw === 'string' && raw.trim().length > 0) {\n    return raw.trim();\n  }\n  return randomUUID();\n}\n\nfunction pipelineLogSessionId(ctx: PipelineMessageContext): string {\n  const sk = ctx.metadata?.sessionKey;\n  if (typeof sk === 'string' && sk.trim().length > 0) {\n    return sk.trim();\n  }\n  return `${ctx.channel}:${ctx.chatId}`;\n}\n\n// ============================================\n// Types\n// ============================================\n\nexport interface PipelineMessageContext {\n  /** Channel identifier */\n  channel: string;\n  /** Account ID */\n  accountId: string;\n  /** Chat ID */\n  chatId: string;\n  /** Sender ID */\n  senderId: string;\n  /** Message content */\n  content: string;\n  /** Original message metadata */\n  metadata: Record<string, unknown>;\n  /** Is group chat */\n  isGroup: boolean;\n  /** Is direct message */\n  isDm: boolean;\n  /** Thread ID (optional) */\n  threadId?: string;\n  /** Message ID (optional) */\n  messageId?: string;\n}\n\nexport interface PipelineMediaRef {\n  type: 'photo' | 'video' | 'audio' | 'document' | 'voice';\n  fileId: string;\n  mimeType?: string;\n  fileName?: string;\n  url?: string;\n}\n\n// ============================================\n// Handler Interfaces\n// ============================================\n\nexport interface PreflightHandler {\n  /** Handler name */\n  name: string;\n  /** Preflight - return null to skip message */\n  preflight?(ctx: PipelineMessageContext): Promise<PipelineMessageContext | null>;\n}\n\nexport interface ProcessHandler {\n  /** Handler name */\n  name: string;\n  /** Process message - transform and extract */\n  process(ctx: PipelineMessageContext): Promise<PipelineMessageContext>;\n}\n\nexport interface DeliveryHandler {\n  /** Handler name */\n  name: string;\n  /** Deliver message to Agent */\n  deliver(ctx: PipelineMessageContext, response: AgentResponse): Promise<void>;\n}\n\n// ============================================\n// Pipeline Options\n// ============================================\n\nexport interface PipelineOptions {\n  /** Channel name */\n  channel: string;\n  /** Preflight handlers */\n  preflightHandlers?: PreflightHandler[];\n  /** Process handlers */\n  processHandlers?: ProcessHandler[];\n  /** Delivery handlers */\n  deliveryHandlers?: DeliveryHandler[];\n  /** Agent callback */\n  agentInvoke?: (ctx: PipelineMessageContext) => Promise<AgentResponse>;\n  /** Error handler */\n  onError?: (err: unknown, ctx: PipelineMessageContext) => void;\n}\n\n// ============================================\n// Pipeline Implementation\n// ============================================\n\nexport class MessagePipeline {\n  private channel: string;\n  private preflightHandlers: PreflightHandler[];\n  private processHandlers: ProcessHandler[];\n  private deliveryHandlers: DeliveryHandler[];\n  private agentInvoke?: PipelineOptions['agentInvoke'];\n  private onError?: PipelineOptions['onError'];\n\n  constructor(options: PipelineOptions) {\n    this.channel = options.channel;\n    this.preflightHandlers = options.preflightHandlers ?? [];\n    this.processHandlers = options.processHandlers ?? [];\n    this.deliveryHandlers = options.deliveryHandlers ?? [];\n    this.agentInvoke = options.agentInvoke;\n    this.onError = options.onError;\n  }\n\n  /**\n   * Handle inbound message\n   */\n  async handleMessage(ctx: PipelineMessageContext): Promise<void> {\n    const channel = this.channel;\n    const requestId = pipelineLogRequestId(ctx);\n\n    await runWithLogContext(\n      {\n        requestId,\n        sessionId: pipelineLogSessionId(ctx),\n      },\n      async () => {\n        // 1. Preflight stage\n        let processedCtx = await this.runPreflight(ctx);\n        if (!processedCtx) {\n          log.debug({ channel, chatId: ctx.chatId }, 'Message filtered in preflight');\n          return;\n        }\n\n        // 2. Process stage\n        try {\n          processedCtx = await this.runProcess(processedCtx);\n        } catch (err) {\n          log.error({ channel, err }, 'Process handler error');\n          this.onError?.(err, processedCtx);\n          return;\n        }\n\n        const resolvedSk = processedCtx.metadata?.sessionKey;\n        if (typeof resolvedSk === 'string' && resolvedSk.trim().length > 0) {\n          updateAsyncLogContext({ sessionId: resolvedSk.trim() });\n        }\n\n        // 3. Deliver to Agent\n        if (!this.agentInvoke) {\n          log.warn({ channel }, 'No agentInvoke configured');\n          return;\n        }\n\n        let response: AgentResponse;\n        try {\n          response = await this.agentInvoke(processedCtx);\n        } catch (err) {\n          log.error({ channel, err }, 'Agent invocation error');\n          this.onError?.(err, processedCtx);\n          return;\n        }\n\n        // 4. Delivery stage\n        try {\n          await this.runDelivery(processedCtx, response);\n        } catch (err) {\n          log.error({ channel, err }, 'Delivery handler error');\n          this.onError?.(err, processedCtx);\n        }\n      },\n    );\n  }\n\n  private async runPreflight(ctx: PipelineMessageContext): Promise<PipelineMessageContext | null> {\n    for (const handler of this.preflightHandlers) {\n      try {\n        const result = await handler.preflight?.(ctx);\n        if (!result) {\n          log.debug({ channel: this.channel, handler: handler.name }, 'Preflight filtered message');\n          return null;\n        }\n        ctx = result;\n      } catch (err) {\n        log.error({ channel: this.channel, handler: handler.name, err }, 'Preflight handler error');\n        return null;\n      }\n    }\n    return ctx;\n  }\n\n  private async runProcess(ctx: PipelineMessageContext): Promise<PipelineMessageContext> {\n    for (const handler of this.processHandlers) {\n      try {\n        ctx = await handler.process(ctx);\n      } catch (err) {\n        log.error({ channel: this.channel, handler: handler.name, err }, 'Process handler error');\n        throw err;\n      }\n    }\n    return ctx;\n  }\n\n  private async runDelivery(ctx: PipelineMessageContext, response: AgentResponse): Promise<void> {\n    for (const handler of this.deliveryHandlers) {\n      try {\n        await handler.deliver(ctx, response);\n      } catch (err) {\n        log.error({ channel: this.channel, handler: handler.name, err }, 'Delivery handler error');\n        throw err;\n      }\n    }\n  }\n}\n\n// ============================================\n// Standard Handlers\n// ============================================\n\n/**\n * Create filter-self handler\n */\nexport function createFilterSelfHandler(currentBotId: string): PreflightHandler {\n  return {\n    name: 'filterSelf',\n    preflight: async (ctx) => {\n      if (ctx.senderId === currentBotId) {\n        return null;\n      }\n      return ctx;\n    },\n  };\n}\n\n/**\n * Create filter-empty handler\n */\nexport function createFilterEmptyHandler(): PreflightHandler {\n  return {\n    name: 'filterEmpty',\n    preflight: async (ctx) => {\n      const content = ctx.content?.trim() ?? '';\n      if (!content && (!ctx.metadata.media || (ctx.metadata.media as PipelineMediaRef[]).length === 0)) {\n        return null;\n      }\n      return ctx;\n    },\n  };\n}\n\n/**\n * Create filter-commands handler\n */\nexport function createFilterCommandsHandler(commands: string[]): PreflightHandler {\n  const commandSet = new Set(commands.map(c => c.toLowerCase()));\n  return {\n    name: 'filterCommands',\n    preflight: async (ctx) => {\n      const firstWord = ctx.content?.split(/\\s/)[0]?.toLowerCase() ?? '';\n      if (firstWord.startsWith('/') && commandSet.has(firstWord.slice(1))) {\n        ctx.metadata.isCommand = true;\n        ctx.metadata.command = firstWord.slice(1);\n      }\n      return ctx;\n    },\n  };\n}\n\n/**\n * Create standard preflight handlers\n */\nexport function standardPreflightHandlers(botId: string): PreflightHandler[] {\n  return [\n    createFilterSelfHandler(botId),\n    createFilterEmptyHandler(),\n    createFilterCommandsHandler(['start', 'help', 'status', 'stop']),\n  ];\n}\n\nfunction formatEnvelopeTimestamp(timezone?: string): string {\n  const now = new Date();\n  try {\n    const resolvedTimezone =\n      timezone?.trim() || Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';\n    const parts = new Intl.DateTimeFormat('en-US', {\n      timeZone: resolvedTimezone,\n      year: 'numeric',\n      month: '2-digit',\n      day: '2-digit',\n      hour: '2-digit',\n      minute: '2-digit',\n      hour12: false,\n      timeZoneName: 'short',\n    }).formatToParts(now);\n\n    const map: Record<string, string> = {};\n    for (const part of parts) {\n      if (part.type !== 'literal') {\n        map[part.type] = part.value;\n      }\n    }\n\n    const year = map.year ?? '';\n    const month = map.month ?? '';\n    const day = map.day ?? '';\n    const hour = map.hour ?? '';\n    const minute = map.minute ?? '';\n    const tzName = map.timeZoneName ?? '';\n\n    if (!year || !month || !day || !hour || !minute) {\n      return `${now.toISOString().slice(0, 16).replace('T', ' ')} UTC`;\n    }\n\n    return `${year}-${month}-${day} ${hour}:${minute}${tzName ? ` ${tzName}` : ''}`;\n  } catch {\n    return `${now.toISOString().slice(0, 16).replace('T', ' ')} UTC`;\n  }\n}\n\n/**\n * Prepends a per-turn `[YYYY-MM-DD HH:MM TZ]` prefix to inbound text so the model has\n * a stable \"now\" without changing the system prompt (prompt-cache friendly).\n */\nexport function createEnvelopeTimestampHandler(timezone?: string): ProcessHandler {\n  return {\n    name: 'envelopeTimestamp',\n    process: async (ctx) => {\n      const text = ctx.content?.trim();\n      if (!text) {\n        return ctx;\n      }\n      const timestamp = formatEnvelopeTimestamp(timezone);\n      return { ...ctx, content: `[${timestamp}] ${ctx.content}` };\n    },\n  };\n}\n\n/**\n * Create standard process handlers\n */\nexport function standardProcessHandlers(timezone?: string): ProcessHandler[] {\n  return [createEnvelopeTimestampHandler(timezone)];\n}\n\n// ============================================\n// Factory\n// ============================================\n\nexport interface CreatePipelineParams {\n  channel: string;\n  botId: string;\n  agentInvoke: PipelineOptions['agentInvoke'];\n  onError?: PipelineOptions['onError'];\n  /** IANA timezone — matches userTimezone from agent config / USER.md */\n  timezone?: string;\n}\n\n/**\n * Create message processing pipeline\n */\nexport function createPipeline(params: CreatePipelineParams): MessagePipeline {\n  return new MessagePipeline({\n    channel: params.channel,\n    preflightHandlers: standardPreflightHandlers(params.botId),\n    processHandlers: standardProcessHandlers(params.timezone),\n    agentInvoke: params.agentInvoke,\n    onError: params.onError,\n  });\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/builtins/config.d.ts

@@ -0,0 +1,4 @@
+/**
+ * /config — read and write persistent config (~/.xopc/xopc.json) from chat.
+ */
+export declare function registerConfigCommand(): void;