@xopcai/xopc 0.0.86 → 0.0.88

package/dist/src/agent/mcp/mcp-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-transport.js","names":["undiciFetch"],"sources":["../../../../src/agent/mcp/mcp-transport.ts"],"sourcesContent":["import {\n  SSEClientTransport,\n  type SSEClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike, Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\nimport { fetch as undiciFetch } from \"undici\";\nimport { createLogger } from \"../../utils/logger.js\";\nconst log = createLogger(\"McpTransport\");\nimport { normalizeOptionalString } from \"../../utils/string-coerce.js\";\nimport { XopcStdioClientTransport } from \"./mcp-stdio-transport.js\";\nimport { resolveMcpTransportConfig } from \"./mcp-transport-config.js\";\n\nexport type ResolvedMcpTransport = {\n  transport: Transport;\n  description: string;\n  transportType: \"stdio\" | \"sse\" | \"streamable-http\";\n  connectionTimeoutMs: number;\n  detachStderr?: () => void;\n};\n\nfunction attachStderrLogging(serverName: string, transport: XopcStdioClientTransport) {\n  const stderr = transport.stderr;\n  if (!stderr || typeof stderr.on !== \"function\") {\n    return undefined;\n  }\n  const onData = (chunk: Buffer | string) => {\n    const message =\n      normalizeOptionalString(typeof chunk === \"string\" ? chunk : String(chunk)) ?? \"\";\n    if (!message) {\n      return;\n    }\n    for (const line of message.split(/\\r?\\n/)) {\n      const trimmed = line.trim();\n      if (trimmed) {\n        log.debug(`bundle-mcp:${serverName}: ${trimmed}`);\n      }\n    }\n  };\n  stderr.on(\"data\", onData);\n  return () => {\n    if (typeof stderr.off === \"function\") {\n      stderr.off(\"data\", onData);\n    } else if (typeof stderr.removeListener === \"function\") {\n      stderr.removeListener(\"data\", onData);\n    }\n  };\n}\n\ntype SseEventSourceFetch = NonNullable<\n  NonNullable<SSEClientTransportOptions[\"eventSourceInit\"]>[\"fetch\"]\n>;\n\nconst fetchWithUndici: FetchLike = async (url, init) =>\n  (await undiciFetch(url, init as unknown as Parameters<typeof undiciFetch>[1])) as unknown as Response;\n\nfunction buildSseEventSourceFetch(headers: Record<string, string>): SseEventSourceFetch {\n  return (url: string | URL, init?: RequestInit) => {\n    const sdkHeaders: Record<string, string> = {};\n    if (init?.headers) {\n      if (init.headers instanceof Headers) {\n        init.headers.forEach((value, key) => {\n          sdkHeaders[key] = value;\n        });\n      } else {\n        Object.assign(sdkHeaders, init.headers);\n      }\n    }\n    return fetchWithUndici(url, {\n      ...(init as RequestInit),\n      headers: { ...sdkHeaders, ...headers },\n    }) as ReturnType<SseEventSourceFetch>;\n  };\n}\n\nexport function resolveMcpTransport(\n  serverName: string,\n  rawServer: unknown,\n): ResolvedMcpTransport | null {\n  const resolved = resolveMcpTransportConfig(serverName, rawServer);\n  if (!resolved) {\n    return null;\n  }\n  if (resolved.kind === \"stdio\") {\n    const transport = new XopcStdioClientTransport({\n      command: resolved.command,\n      args: resolved.args,\n      env: resolved.env,\n      cwd: resolved.cwd,\n      stderr: \"pipe\",\n    });\n    return {\n      transport,\n      description: resolved.description,\n      transportType: \"stdio\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n      detachStderr: attachStderrLogging(serverName, transport),\n    };\n  }\n  if (resolved.transportType === \"streamable-http\") {\n    return {\n      transport: new StreamableHTTPClientTransport(new URL(resolved.url), {\n        requestInit: resolved.headers ? { headers: resolved.headers } : undefined,\n      }),\n      description: resolved.description,\n      transportType: \"streamable-http\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n    };\n  }\n  const headers: Record<string, string> = {\n    ...resolved.headers,\n  };\n  const hasHeaders = Object.keys(headers).length > 0;\n  return {\n    transport: new SSEClientTransport(new URL(resolved.url), {\n      requestInit: hasHeaders ? { headers } : undefined,\n      fetch: fetchWithUndici,\n      eventSourceInit: { fetch: buildSseEventSourceFetch(headers) },\n    }),\n    description: resolved.description,\n    transportType: \"sse\",\n    connectionTimeoutMs: resolved.connectionTimeoutMs,\n  };\n}\n"],"mappings":";;;;;;;;;aAOqD;AACrD,MAAM,MAAM,aAAa,eAAe;AAaxC,SAAS,oBAAoB,YAAoB,WAAqC;CACpF,MAAM,SAAS,UAAU;AACzB,KAAI,CAAC,UAAU,OAAO,OAAO,OAAO,WAClC;CAEF,MAAM,UAAU,UAA2B;EACzC,MAAM,UACJ,wBAAwB,OAAO,UAAU,WAAW,QAAQ,OAAO,MAAM,CAAC,IAAI;AAChF,MAAI,CAAC,QACH;AAEF,OAAK,MAAM,QAAQ,QAAQ,MAAM,QAAQ,EAAE;GACzC,MAAM,UAAU,KAAK,MAAM;AAC3B,OAAI,QACF,KAAI,MAAM,cAAc,WAAW,IAAI,UAAU;;;AAIvD,QAAO,GAAG,QAAQ,OAAO;AACzB,cAAa;AACX,MAAI,OAAO,OAAO,QAAQ,WACxB,QAAO,IAAI,QAAQ,OAAO;WACjB,OAAO,OAAO,mBAAmB,WAC1C,QAAO,eAAe,QAAQ,OAAO;;;AAS3C,MAAM,kBAA6B,OAAO,KAAK,SAC5C,MAAMA,MAAY,KAAK,KAAqD;AAE/E,SAAS,yBAAyB,SAAsD;AACtF,SAAQ,KAAmB,SAAuB;EAChD,MAAM,aAAqC,EAAE;AAC7C,MAAI,MAAM,QACR,KAAI,KAAK,mBAAmB,QAC1B,MAAK,QAAQ,SAAS,OAAO,QAAQ;AACnC,cAAW,OAAO;IAClB;MAEF,QAAO,OAAO,YAAY,KAAK,QAAQ;AAG3C,SAAO,gBAAgB,KAAK;GAC1B,GAAI;GACJ,SAAS;IAAE,GAAG;IAAY,GAAG;IAAS;GACvC,CAAC;;;AAIN,SAAgB,oBACd,YACA,WAC6B;CAC7B,MAAM,WAAW,0BAA0B,YAAY,UAAU;AACjE,KAAI,CAAC,SACH,QAAO;AAET,KAAI,SAAS,SAAS,SAAS;EAC7B,MAAM,YAAY,IAAI,yBAAyB;GAC7C,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,KAAK,SAAS;GACd,KAAK,SAAS;GACd,QAAQ;GACT,CAAC;AACF,SAAO;GACL;GACA,aAAa,SAAS;GACtB,eAAe;GACf,qBAAqB,SAAS;GAC9B,cAAc,oBAAoB,YAAY,UAAU;GACzD;;AAEH,KAAI,SAAS,kBAAkB,kBAC7B,QAAO;EACL,WAAW,IAAI,8BAA8B,IAAI,IAAI,SAAS,IAAI,EAAE,EAClE,aAAa,SAAS,UAAU,EAAE,SAAS,SAAS,SAAS,GAAG,KAAA,GACjE,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B;CAEH,MAAM,UAAkC,EACtC,GAAG,SAAS,SACb;CACD,MAAM,aAAa,OAAO,KAAK,QAAQ,CAAC,SAAS;AACjD,QAAO;EACL,WAAW,IAAI,mBAAmB,IAAI,IAAI,SAAS,IAAI,EAAE;GACvD,aAAa,aAAa,EAAE,SAAS,GAAG,KAAA;GACxC,OAAO;GACP,iBAAiB,EAAE,OAAO,yBAAyB,QAAQ,EAAE;GAC9D,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B"}
+{"version":3,"file":"mcp-transport.js","names":["undiciFetch"],"sources":["../../../../src/agent/mcp/mcp-transport.ts"],"sourcesContent":["import {\n  SSEClientTransport,\n  type SSEClientTransportOptions,\n} from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike, Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\nimport { fetch as undiciFetch } from \"undici\";\nimport { createLogger } from \"../../utils/logger.js\";\nconst log = createLogger(\"McpTransport\");\nimport { normalizeOptionalString } from \"../../utils/string-coerce.js\";\nimport { XopcStdioClientTransport } from \"./mcp-stdio-transport.js\";\nimport { resolveMcpTransportConfig } from \"./mcp-transport-config.js\";\n\nexport type ResolvedMcpTransport = {\n  transport: Transport;\n  description: string;\n  transportType: \"stdio\" | \"sse\" | \"streamable-http\";\n  connectionTimeoutMs: number;\n  detachStderr?: () => void;\n};\n\nfunction attachStderrLogging(serverName: string, transport: XopcStdioClientTransport) {\n  const stderr = transport.stderr;\n  if (!stderr || typeof stderr.on !== \"function\") {\n    return undefined;\n  }\n  const onData = (chunk: Buffer | string) => {\n    const message =\n      normalizeOptionalString(typeof chunk === \"string\" ? chunk : String(chunk)) ?? \"\";\n    if (!message) {\n      return;\n    }\n    for (const line of message.split(/\\r?\\n/)) {\n      const trimmed = line.trim();\n      if (trimmed) {\n        log.debug(`bundle-mcp:${serverName}: ${trimmed}`);\n      }\n    }\n  };\n  stderr.on(\"data\", onData);\n  return () => {\n    if (typeof stderr.off === \"function\") {\n      stderr.off(\"data\", onData);\n    } else if (typeof stderr.removeListener === \"function\") {\n      stderr.removeListener(\"data\", onData);\n    }\n  };\n}\n\ntype SseEventSourceFetch = NonNullable<\n  NonNullable<SSEClientTransportOptions[\"eventSourceInit\"]>[\"fetch\"]\n>;\n\nconst fetchWithUndici: FetchLike = async (url, init) =>\n  (await undiciFetch(url, init as unknown as Parameters<typeof undiciFetch>[1])) as unknown as Response;\n\nfunction buildSseEventSourceFetch(headers: Record<string, string>): SseEventSourceFetch {\n  return (url: string | URL, init?: RequestInit) => {\n    const sdkHeaders: Record<string, string> = {};\n    if (init?.headers) {\n      if (init.headers instanceof Headers) {\n        init.headers.forEach((value, key) => {\n          sdkHeaders[key] = value;\n        });\n      } else {\n        Object.assign(sdkHeaders, init.headers);\n      }\n    }\n    return fetchWithUndici(url, {\n      ...(init as RequestInit),\n      headers: { ...sdkHeaders, ...headers },\n    }) as ReturnType<SseEventSourceFetch>;\n  };\n}\n\nexport function resolveMcpTransport(\n  serverName: string,\n  rawServer: unknown,\n): ResolvedMcpTransport | null {\n  const resolved = resolveMcpTransportConfig(serverName, rawServer);\n  if (!resolved) {\n    return null;\n  }\n  if (resolved.kind === \"stdio\") {\n    const transport = new XopcStdioClientTransport({\n      command: resolved.command,\n      args: resolved.args,\n      env: resolved.env,\n      cwd: resolved.cwd,\n      stderr: \"pipe\",\n    });\n    return {\n      transport,\n      description: resolved.description,\n      transportType: \"stdio\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n      detachStderr: attachStderrLogging(serverName, transport),\n    };\n  }\n  if (resolved.transportType === \"streamable-http\") {\n    return {\n      transport: new StreamableHTTPClientTransport(new URL(resolved.url), {\n        requestInit: resolved.headers ? { headers: resolved.headers } : undefined,\n      }),\n      description: resolved.description,\n      transportType: \"streamable-http\",\n      connectionTimeoutMs: resolved.connectionTimeoutMs,\n    };\n  }\n  const headers: Record<string, string> = {\n    ...resolved.headers,\n  };\n  const hasHeaders = Object.keys(headers).length > 0;\n  return {\n    transport: new SSEClientTransport(new URL(resolved.url), {\n      requestInit: hasHeaders ? { headers } : undefined,\n      fetch: fetchWithUndici,\n      eventSourceInit: { fetch: buildSseEventSourceFetch(headers) },\n    }),\n    description: resolved.description,\n    transportType: \"sse\",\n    connectionTimeoutMs: resolved.connectionTimeoutMs,\n  };\n}\n"],"mappings":";;;;;;;;;aAOqD;oBAEkB;AADvE,MAAM,MAAM,aAAa,eAAe;AAaxC,SAAS,oBAAoB,YAAoB,WAAqC;CACpF,MAAM,SAAS,UAAU;AACzB,KAAI,CAAC,UAAU,OAAO,OAAO,OAAO,WAClC;CAEF,MAAM,UAAU,UAA2B;EACzC,MAAM,UACJ,wBAAwB,OAAO,UAAU,WAAW,QAAQ,OAAO,MAAM,CAAC,IAAI;AAChF,MAAI,CAAC,QACH;AAEF,OAAK,MAAM,QAAQ,QAAQ,MAAM,QAAQ,EAAE;GACzC,MAAM,UAAU,KAAK,MAAM;AAC3B,OAAI,QACF,KAAI,MAAM,cAAc,WAAW,IAAI,UAAU;;;AAIvD,QAAO,GAAG,QAAQ,OAAO;AACzB,cAAa;AACX,MAAI,OAAO,OAAO,QAAQ,WACxB,QAAO,IAAI,QAAQ,OAAO;WACjB,OAAO,OAAO,mBAAmB,WAC1C,QAAO,eAAe,QAAQ,OAAO;;;AAS3C,MAAM,kBAA6B,OAAO,KAAK,SAC5C,MAAMA,MAAY,KAAK,KAAqD;AAE/E,SAAS,yBAAyB,SAAsD;AACtF,SAAQ,KAAmB,SAAuB;EAChD,MAAM,aAAqC,EAAE;AAC7C,MAAI,MAAM,QACR,KAAI,KAAK,mBAAmB,QAC1B,MAAK,QAAQ,SAAS,OAAO,QAAQ;AACnC,cAAW,OAAO;IAClB;MAEF,QAAO,OAAO,YAAY,KAAK,QAAQ;AAG3C,SAAO,gBAAgB,KAAK;GAC1B,GAAI;GACJ,SAAS;IAAE,GAAG;IAAY,GAAG;IAAS;GACvC,CAAC;;;AAIN,SAAgB,oBACd,YACA,WAC6B;CAC7B,MAAM,WAAW,0BAA0B,YAAY,UAAU;AACjE,KAAI,CAAC,SACH,QAAO;AAET,KAAI,SAAS,SAAS,SAAS;EAC7B,MAAM,YAAY,IAAI,yBAAyB;GAC7C,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,KAAK,SAAS;GACd,KAAK,SAAS;GACd,QAAQ;GACT,CAAC;AACF,SAAO;GACL;GACA,aAAa,SAAS;GACtB,eAAe;GACf,qBAAqB,SAAS;GAC9B,cAAc,oBAAoB,YAAY,UAAU;GACzD;;AAEH,KAAI,SAAS,kBAAkB,kBAC7B,QAAO;EACL,WAAW,IAAI,8BAA8B,IAAI,IAAI,SAAS,IAAI,EAAE,EAClE,aAAa,SAAS,UAAU,EAAE,SAAS,SAAS,SAAS,GAAG,KAAA,GACjE,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B;CAEH,MAAM,UAAkC,EACtC,GAAG,SAAS,SACb;CACD,MAAM,aAAa,OAAO,KAAK,QAAQ,CAAC,SAAS;AACjD,QAAO;EACL,WAAW,IAAI,mBAAmB,IAAI,IAAI,SAAS,IAAI,EAAE;GACvD,aAAa,aAAa,EAAE,SAAS,GAAG,KAAA;GACxC,OAAO;GACP,iBAAiB,EAAE,OAAO,yBAAyB,QAAQ,EAAE;GAC9D,CAAC;EACF,aAAa,SAAS;EACtB,eAAe;EACf,qBAAqB,SAAS;EAC/B"}

package/dist/src/agent/media-generation/runtime-shared.js

@@ -55,16 +55,9 @@ function safeListProviders(fn, cfg) {
 		return [];
 	}
 }
-/**
-* Normalize an {@link AgentModelConfig} (which may be a bare string for
-* legacy configs) to an object with explicit `primary` / `fallbacks`.
-*/
+/** Normalize an {@link AgentModelConfig} to `{ primary?, fallbacks }`. */
 function normalizeModelConfig(cfg) {
-	if (cfg === void 0 || cfg === null) return { fallbacks: [] };
-	if (typeof cfg === "string") return {
-		primary: cfg,
-		fallbacks: []
-	};
+	if (!cfg) return { fallbacks: [] };
 	return {
 		primary: typeof cfg.primary === "string" ? cfg.primary : void 0,
 		fallbacks: Array.isArray(cfg.fallbacks) ? cfg.fallbacks.filter((s) => typeof s === "string") : []

package/dist/src/agent/media-generation/runtime-shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-shared.js","names":[],"sources":["../../../../src/agent/media-generation/runtime-shared.ts"],"sourcesContent":["/**\n * Cross-capability runtime helpers shared by image / audio / video\n * generation. Pure functions (no IO) so they can be unit-tested without\n * touching providers.\n *\n * - candidate model resolution\n * - geometry/value nearest-neighbour matching\n * - terminal failure aggregation (FailoverError)\n * - \"no model configured\" message builder\n */\n\nimport type { Config, AgentModelConfig } from '../../config/schema.js';\nimport {\n  classifyAttemptError,\n  FailoverError,\n  type FallbackAttempt,\n  type FailoverReason,\n} from '../failover-error.js';\nimport { parseCapabilityModelRef, type ParsedCapabilityModelRef } from './model-ref.js';\n\n// ============================================\n// Candidate resolution\n// ============================================\n\nexport interface CapabilityProviderCandidate {\n  id: string;\n  aliases?: readonly string[];\n  defaultModel?: string | null;\n  models?: readonly string[];\n  isConfigured?: (ctx: { cfg?: Config; agentDir?: string }) => boolean;\n}\n\nexport interface ResolveCapabilityModelCandidatesParams {\n  cfg?: Config;\n  /** Active capability model config, e.g. cfg.agents.defaults.imageGenerationModel. */\n  modelConfig: AgentModelConfig | undefined;\n  /** Caller-supplied per-call override (highest priority). */\n  modelOverride?: string;\n  /** Optional ref parser; defaults to {@link parseCapabilityModelRef}. */\n  parseModelRef?: (raw: string | undefined) => ParsedCapabilityModelRef | null;\n  agentDir?: string;\n  /** Snapshot of registered providers used to enumerate fallbacks. */\n  listProviders: (cfg?: Config) => CapabilityProviderCandidate[];\n  /**\n   * When true and the explicit candidates fail, append every configured\n   * provider's default model.\n   */\n  autoProviderFallback?: boolean;\n}\n\nexport interface ResolvedCapabilityModelCandidate {\n  provider: string;\n  model: string;\n}\n\n/**\n * Build the ordered candidate list from:\n *   1. modelOverride\n *   2. modelConfig.primary\n *   3. modelConfig.fallbacks[]\n *   4. (optional) every isConfigured() provider's defaultModel\n *\n * Duplicates are dropped (case-insensitive on provider, exact on model).\n */\nexport function resolveCapabilityModelCandidates(\n  params: ResolveCapabilityModelCandidatesParams,\n): ResolvedCapabilityModelCandidate[] {\n  const parse = params.parseModelRef ?? parseCapabilityModelRef;\n  const out: ResolvedCapabilityModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const push = (raw: string | undefined) => {\n    const parsed = parse(raw);\n    if (!parsed) return;\n    const key = `${parsed.provider}::${parsed.model}`;\n    if (seen.has(key)) return;\n    seen.add(key);\n    out.push({ provider: parsed.provider, model: parsed.model });\n  };\n\n  const normalizedModelConfig = normalizeModelConfig(params.modelConfig);\n  push(params.modelOverride);\n  push(normalizedModelConfig.primary);\n  for (const fb of normalizedModelConfig.fallbacks) push(fb);\n\n  if (params.autoProviderFallback) {\n    const providers = safeListProviders(params.listProviders, params.cfg);\n    for (const provider of providers) {\n      if (!provider.defaultModel) continue;\n      let configured = true;\n      try {\n        configured = provider.isConfigured?.({ cfg: params.cfg, agentDir: params.agentDir }) ?? true;\n      } catch {\n        configured = false;\n      }\n      if (!configured) continue;\n      push(`${provider.id}/${provider.defaultModel}`);\n    }\n  }\n\n  return out;\n}\n\nfunction safeListProviders(\n  fn: (cfg?: Config) => CapabilityProviderCandidate[],\n  cfg?: Config,\n): CapabilityProviderCandidate[] {\n  try {\n    return fn(cfg) ?? [];\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Normalize an {@link AgentModelConfig} (which may be a bare string for\n * legacy configs) to an object with explicit `primary` / `fallbacks`.\n */\nfunction normalizeModelConfig(\n  cfg: AgentModelConfig | undefined,\n): { primary?: string; fallbacks: string[] } {\n  if (cfg === undefined || cfg === null) return { fallbacks: [] };\n  if (typeof cfg === 'string') return { primary: cfg, fallbacks: [] };\n  return {\n    primary: typeof cfg.primary === 'string' ? cfg.primary : undefined,\n    fallbacks: Array.isArray(cfg.fallbacks) ? cfg.fallbacks.filter((s): s is string => typeof s === 'string') : [],\n  };\n}\n\n// ============================================\n// Geometry helpers (nearest-neighbour)\n// ============================================\n\nexport function resolveClosestSize(params: {\n  requestedSize?: string;\n  requestedAspectRatio?: string;\n  supportedSizes?: ReadonlyArray<string>;\n}): string | undefined {\n  const supported = (params.supportedSizes ?? []).filter((s) => parseSize(s) !== null);\n  if (supported.length === 0) return undefined;\n\n  const target =\n    parseSize(params.requestedSize) ??\n    sizeFromAspectRatio(params.requestedAspectRatio, supported.map((s) => parseSize(s)!.totalPixels));\n\n  if (!target) return supported[0];\n  return supported\n    .map((s) => ({ s, parsed: parseSize(s)! }))\n    .reduce((best, cur) => {\n      const score = sizeDistance(target, cur.parsed);\n      return score < best.score ? { s: cur.s, score } : best;\n    }, { s: supported[0], score: Number.POSITIVE_INFINITY })\n    .s;\n}\n\nexport function resolveClosestAspectRatio(params: {\n  requestedAspectRatio?: string;\n  requestedSize?: string;\n  supportedAspectRatios?: ReadonlyArray<string>;\n}): string | undefined {\n  const supported = (params.supportedAspectRatios ?? []).filter((r) => parseAspectRatio(r) !== null);\n  if (supported.length === 0) return undefined;\n\n  const targetRatio =\n    parseAspectRatio(params.requestedAspectRatio)?.value ??\n    (() => {\n      const sz = parseSize(params.requestedSize);\n      return sz ? sz.width / sz.height : undefined;\n    })();\n\n  if (typeof targetRatio !== 'number' || !Number.isFinite(targetRatio)) {\n    return supported[0];\n  }\n\n  return supported.reduce((best, cur) => {\n    const v = parseAspectRatio(cur)!.value;\n    const d = Math.abs(Math.log(v) - Math.log(targetRatio));\n    return d < best.score ? { s: cur, score: d } : best;\n  }, { s: supported[0], score: Number.POSITIVE_INFINITY }).s;\n}\n\nexport function resolveClosestResolution<T extends string>(params: {\n  requestedResolution?: T;\n  supportedResolutions?: ReadonlyArray<T>;\n}): T | undefined {\n  const supported = params.supportedResolutions ?? [];\n  if (supported.length === 0) return undefined;\n  const requested = params.requestedResolution;\n  if (!requested) return undefined;\n  if (supported.includes(requested)) return requested;\n\n  const order = ['1K', '2K', '4K', '8K'];\n  const want = order.indexOf(String(requested));\n  if (want < 0) return supported[0];\n\n  // Prefer the largest supported value <= requested; otherwise pick the smallest available.\n  const ranked = supported\n    .map((r) => ({ r, idx: order.indexOf(String(r)) }))\n    .filter((x) => x.idx >= 0)\n    .sort((a, b) => a.idx - b.idx);\n  if (ranked.length === 0) return supported[0];\n\n  let chosen = ranked[0].r;\n  for (const x of ranked) {\n    if (x.idx <= want) chosen = x.r;\n  }\n  return chosen;\n}\n\nfunction parseSize(raw: string | undefined): { width: number; height: number; totalPixels: number } | null {\n  if (typeof raw !== 'string') return null;\n  const m = raw.trim().toLowerCase().match(/^(\\d{2,5})\\s*[x×*]\\s*(\\d{2,5})$/);\n  if (!m) return null;\n  const width = Number(m[1]);\n  const height = Number(m[2]);\n  if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return null;\n  return { width, height, totalPixels: width * height };\n}\n\nfunction parseAspectRatio(raw: string | undefined): { value: number } | null {\n  if (typeof raw !== 'string') return null;\n  const m = raw.trim().match(/^(\\d{1,3})\\s*[:x×/]\\s*(\\d{1,3})$/);\n  if (!m) return null;\n  const w = Number(m[1]);\n  const h = Number(m[2]);\n  if (!Number.isFinite(w) || !Number.isFinite(h) || w <= 0 || h <= 0) return null;\n  return { value: w / h };\n}\n\nfunction sizeFromAspectRatio(\n  ratioStr: string | undefined,\n  pixelHints: number[],\n): { width: number; height: number; totalPixels: number } | null {\n  const r = parseAspectRatio(ratioStr);\n  if (!r) return null;\n  const pixels = pixelHints.length > 0 ? Math.round(pixelHints.reduce((a, b) => a + b, 0) / pixelHints.length) : 1024 * 1024;\n  const height = Math.round(Math.sqrt(pixels / r.value));\n  const width = Math.round(height * r.value);\n  return { width, height, totalPixels: width * height };\n}\n\nfunction sizeDistance(\n  a: { width: number; height: number; totalPixels: number },\n  b: { width: number; height: number; totalPixels: number },\n): number {\n  // Combined area + aspect-ratio difference (log-scale on both for stability).\n  const areaDelta = Math.abs(Math.log(a.totalPixels) - Math.log(b.totalPixels));\n  const ratioA = a.width / a.height;\n  const ratioB = b.width / b.height;\n  const ratioDelta = Math.abs(Math.log(ratioA) - Math.log(ratioB));\n  return areaDelta + ratioDelta * 1.5;\n}\n\n// ============================================\n// Failure aggregation\n// ============================================\n\nexport interface RecordCapabilityCandidateFailureParams {\n  attempts: FallbackAttempt[];\n  provider: string;\n  model: string;\n  error: unknown;\n  durationMs?: number;\n}\n\n/** Push a structured {@link FallbackAttempt} entry derived from `error`. */\nexport function recordCapabilityCandidateFailure(\n  params: RecordCapabilityCandidateFailureParams,\n): FallbackAttempt {\n  const cls = classifyAttemptError(params.error);\n  const attempt: FallbackAttempt = {\n    provider: params.provider,\n    model: params.model,\n    error: cls.message,\n    reason: cls.reason,\n    ...(cls.status !== undefined ? { status: cls.status } : {}),\n    ...(cls.code !== undefined ? { code: cls.code } : {}),\n    ...(params.durationMs !== undefined ? { durationMs: params.durationMs } : {}),\n  };\n  params.attempts.push(attempt);\n  return attempt;\n}\n\nexport interface ThrowCapabilityGenerationFailureParams {\n  capabilityLabel: string;\n  attempts: FallbackAttempt[];\n  lastError: unknown;\n}\n\n/** Throw a unified {@link FailoverError} after all candidates have been exhausted. */\nexport function throwCapabilityGenerationFailure(params: ThrowCapabilityGenerationFailureParams): never {\n  // capabilityLabel like \"image generation\" → identifier \"image-generation\"\n  const capability = params.capabilityLabel.trim().toLowerCase().replace(/\\s+/g, '-') || 'capability';\n  throw new FailoverError({\n    capability,\n    attempts: params.attempts,\n    cause: params.lastError,\n  });\n}\n\n// ============================================\n// \"No model configured\" message\n// ============================================\n\nexport interface BuildNoCapabilityModelConfiguredMessageParams {\n  /** Display label, e.g. \"image-generation\". */\n  capabilityLabel: string;\n  /** Config key path, e.g. \"imageGenerationModel\". */\n  modelConfigKey: string;\n  providers: ReadonlyArray<CapabilityProviderCandidate>;\n  /** Optional env-var lookup, e.g. (id) => PROVIDER_ENV_MAP[id]. */\n  getProviderEnvVars?: (id: string) => readonly string[] | undefined;\n}\n\nexport function buildNoCapabilityModelConfiguredMessage(\n  params: BuildNoCapabilityModelConfiguredMessageParams,\n): string {\n  const lines: string[] = [\n    `No ${params.capabilityLabel} model configured. Set agents.defaults.${params.modelConfigKey} ` +\n      `to a \"<provider>/<model>\" value (or pass modelOverride at call site).`,\n  ];\n  if (params.providers.length > 0) {\n    lines.push('Registered providers:');\n    for (const p of params.providers) {\n      const envs = params.getProviderEnvVars?.(p.id) ?? [];\n      const env = envs.length > 0 ? ` (env: ${envs.join(' | ')})` : '';\n      const def = p.defaultModel ? ` default=${p.defaultModel}` : '';\n      lines.push(`  - ${p.id}${def}${env}`);\n    }\n  }\n  return lines.join('\\n');\n}\n\n/**\n * Build a `metadata.normalization` snapshot from a completed normalization\n * pass. Providers / runtime can spread it into their result metadata.\n */\nexport function buildMediaGenerationNormalizationMetadata(params: {\n  normalization?: Record<string, unknown>;\n}): Record<string, unknown> {\n  if (!params.normalization || Object.keys(params.normalization).length === 0) return {};\n  return { normalization: params.normalization };\n}\n\n// Re-export the union for downstream type narrowing.\nexport type { FailoverReason };\n"],"mappings":"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"}
+{"version":3,"file":"runtime-shared.js","names":[],"sources":["../../../../src/agent/media-generation/runtime-shared.ts"],"sourcesContent":["/**\n * Cross-capability runtime helpers shared by image / audio / video\n * generation. Pure functions (no IO) so they can be unit-tested without\n * touching providers.\n *\n * - candidate model resolution\n * - geometry/value nearest-neighbour matching\n * - terminal failure aggregation (FailoverError)\n * - \"no model configured\" message builder\n */\n\nimport type { Config, AgentModelConfig } from '../../config/schema.js';\nimport {\n  classifyAttemptError,\n  FailoverError,\n  type FallbackAttempt,\n  type FailoverReason,\n} from '../failover-error.js';\nimport { parseCapabilityModelRef, type ParsedCapabilityModelRef } from './model-ref.js';\n\n// ============================================\n// Candidate resolution\n// ============================================\n\nexport interface CapabilityProviderCandidate {\n  id: string;\n  aliases?: readonly string[];\n  defaultModel?: string | null;\n  models?: readonly string[];\n  isConfigured?: (ctx: { cfg?: Config; agentDir?: string }) => boolean;\n}\n\nexport interface ResolveCapabilityModelCandidatesParams {\n  cfg?: Config;\n  /** Active capability model config, e.g. cfg.agents.defaults.imageGenerationModel. */\n  modelConfig: AgentModelConfig | undefined;\n  /** Caller-supplied per-call override (highest priority). */\n  modelOverride?: string;\n  /** Optional ref parser; defaults to {@link parseCapabilityModelRef}. */\n  parseModelRef?: (raw: string | undefined) => ParsedCapabilityModelRef | null;\n  agentDir?: string;\n  /** Snapshot of registered providers used to enumerate fallbacks. */\n  listProviders: (cfg?: Config) => CapabilityProviderCandidate[];\n  /**\n   * When true and the explicit candidates fail, append every configured\n   * provider's default model.\n   */\n  autoProviderFallback?: boolean;\n}\n\nexport interface ResolvedCapabilityModelCandidate {\n  provider: string;\n  model: string;\n}\n\n/**\n * Build the ordered candidate list from:\n *   1. modelOverride\n *   2. modelConfig.primary\n *   3. modelConfig.fallbacks[]\n *   4. (optional) every isConfigured() provider's defaultModel\n *\n * Duplicates are dropped (case-insensitive on provider, exact on model).\n */\nexport function resolveCapabilityModelCandidates(\n  params: ResolveCapabilityModelCandidatesParams,\n): ResolvedCapabilityModelCandidate[] {\n  const parse = params.parseModelRef ?? parseCapabilityModelRef;\n  const out: ResolvedCapabilityModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const push = (raw: string | undefined) => {\n    const parsed = parse(raw);\n    if (!parsed) return;\n    const key = `${parsed.provider}::${parsed.model}`;\n    if (seen.has(key)) return;\n    seen.add(key);\n    out.push({ provider: parsed.provider, model: parsed.model });\n  };\n\n  const normalizedModelConfig = normalizeModelConfig(params.modelConfig);\n  push(params.modelOverride);\n  push(normalizedModelConfig.primary);\n  for (const fb of normalizedModelConfig.fallbacks) push(fb);\n\n  if (params.autoProviderFallback) {\n    const providers = safeListProviders(params.listProviders, params.cfg);\n    for (const provider of providers) {\n      if (!provider.defaultModel) continue;\n      let configured = true;\n      try {\n        configured = provider.isConfigured?.({ cfg: params.cfg, agentDir: params.agentDir }) ?? true;\n      } catch {\n        configured = false;\n      }\n      if (!configured) continue;\n      push(`${provider.id}/${provider.defaultModel}`);\n    }\n  }\n\n  return out;\n}\n\nfunction safeListProviders(\n  fn: (cfg?: Config) => CapabilityProviderCandidate[],\n  cfg?: Config,\n): CapabilityProviderCandidate[] {\n  try {\n    return fn(cfg) ?? [];\n  } catch {\n    return [];\n  }\n}\n\n/** Normalize an {@link AgentModelConfig} to `{ primary?, fallbacks }`. */\nfunction normalizeModelConfig(\n  cfg: AgentModelConfig | undefined,\n): { primary?: string; fallbacks: string[] } {\n  if (!cfg) return { fallbacks: [] };\n  return {\n    primary: typeof cfg.primary === 'string' ? cfg.primary : undefined,\n    fallbacks: Array.isArray(cfg.fallbacks)\n      ? cfg.fallbacks.filter((s): s is string => typeof s === 'string')\n      : [],\n  };\n}\n\n// ============================================\n// Geometry helpers (nearest-neighbour)\n// ============================================\n\nexport function resolveClosestSize(params: {\n  requestedSize?: string;\n  requestedAspectRatio?: string;\n  supportedSizes?: ReadonlyArray<string>;\n}): string | undefined {\n  const supported = (params.supportedSizes ?? []).filter((s) => parseSize(s) !== null);\n  if (supported.length === 0) return undefined;\n\n  const target =\n    parseSize(params.requestedSize) ??\n    sizeFromAspectRatio(params.requestedAspectRatio, supported.map((s) => parseSize(s)!.totalPixels));\n\n  if (!target) return supported[0];\n  return supported\n    .map((s) => ({ s, parsed: parseSize(s)! }))\n    .reduce((best, cur) => {\n      const score = sizeDistance(target, cur.parsed);\n      return score < best.score ? { s: cur.s, score } : best;\n    }, { s: supported[0], score: Number.POSITIVE_INFINITY })\n    .s;\n}\n\nexport function resolveClosestAspectRatio(params: {\n  requestedAspectRatio?: string;\n  requestedSize?: string;\n  supportedAspectRatios?: ReadonlyArray<string>;\n}): string | undefined {\n  const supported = (params.supportedAspectRatios ?? []).filter((r) => parseAspectRatio(r) !== null);\n  if (supported.length === 0) return undefined;\n\n  const targetRatio =\n    parseAspectRatio(params.requestedAspectRatio)?.value ??\n    (() => {\n      const sz = parseSize(params.requestedSize);\n      return sz ? sz.width / sz.height : undefined;\n    })();\n\n  if (typeof targetRatio !== 'number' || !Number.isFinite(targetRatio)) {\n    return supported[0];\n  }\n\n  return supported.reduce((best, cur) => {\n    const v = parseAspectRatio(cur)!.value;\n    const d = Math.abs(Math.log(v) - Math.log(targetRatio));\n    return d < best.score ? { s: cur, score: d } : best;\n  }, { s: supported[0], score: Number.POSITIVE_INFINITY }).s;\n}\n\nexport function resolveClosestResolution<T extends string>(params: {\n  requestedResolution?: T;\n  supportedResolutions?: ReadonlyArray<T>;\n}): T | undefined {\n  const supported = params.supportedResolutions ?? [];\n  if (supported.length === 0) return undefined;\n  const requested = params.requestedResolution;\n  if (!requested) return undefined;\n  if (supported.includes(requested)) return requested;\n\n  const order = ['1K', '2K', '4K', '8K'];\n  const want = order.indexOf(String(requested));\n  if (want < 0) return supported[0];\n\n  // Prefer the largest supported value <= requested; otherwise pick the smallest available.\n  const ranked = supported\n    .map((r) => ({ r, idx: order.indexOf(String(r)) }))\n    .filter((x) => x.idx >= 0)\n    .sort((a, b) => a.idx - b.idx);\n  if (ranked.length === 0) return supported[0];\n\n  let chosen = ranked[0].r;\n  for (const x of ranked) {\n    if (x.idx <= want) chosen = x.r;\n  }\n  return chosen;\n}\n\nfunction parseSize(raw: string | undefined): { width: number; height: number; totalPixels: number } | null {\n  if (typeof raw !== 'string') return null;\n  const m = raw.trim().toLowerCase().match(/^(\\d{2,5})\\s*[x×*]\\s*(\\d{2,5})$/);\n  if (!m) return null;\n  const width = Number(m[1]);\n  const height = Number(m[2]);\n  if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return null;\n  return { width, height, totalPixels: width * height };\n}\n\nfunction parseAspectRatio(raw: string | undefined): { value: number } | null {\n  if (typeof raw !== 'string') return null;\n  const m = raw.trim().match(/^(\\d{1,3})\\s*[:x×/]\\s*(\\d{1,3})$/);\n  if (!m) return null;\n  const w = Number(m[1]);\n  const h = Number(m[2]);\n  if (!Number.isFinite(w) || !Number.isFinite(h) || w <= 0 || h <= 0) return null;\n  return { value: w / h };\n}\n\nfunction sizeFromAspectRatio(\n  ratioStr: string | undefined,\n  pixelHints: number[],\n): { width: number; height: number; totalPixels: number } | null {\n  const r = parseAspectRatio(ratioStr);\n  if (!r) return null;\n  const pixels = pixelHints.length > 0 ? Math.round(pixelHints.reduce((a, b) => a + b, 0) / pixelHints.length) : 1024 * 1024;\n  const height = Math.round(Math.sqrt(pixels / r.value));\n  const width = Math.round(height * r.value);\n  return { width, height, totalPixels: width * height };\n}\n\nfunction sizeDistance(\n  a: { width: number; height: number; totalPixels: number },\n  b: { width: number; height: number; totalPixels: number },\n): number {\n  // Combined area + aspect-ratio difference (log-scale on both for stability).\n  const areaDelta = Math.abs(Math.log(a.totalPixels) - Math.log(b.totalPixels));\n  const ratioA = a.width / a.height;\n  const ratioB = b.width / b.height;\n  const ratioDelta = Math.abs(Math.log(ratioA) - Math.log(ratioB));\n  return areaDelta + ratioDelta * 1.5;\n}\n\n// ============================================\n// Failure aggregation\n// ============================================\n\nexport interface RecordCapabilityCandidateFailureParams {\n  attempts: FallbackAttempt[];\n  provider: string;\n  model: string;\n  error: unknown;\n  durationMs?: number;\n}\n\n/** Push a structured {@link FallbackAttempt} entry derived from `error`. */\nexport function recordCapabilityCandidateFailure(\n  params: RecordCapabilityCandidateFailureParams,\n): FallbackAttempt {\n  const cls = classifyAttemptError(params.error);\n  const attempt: FallbackAttempt = {\n    provider: params.provider,\n    model: params.model,\n    error: cls.message,\n    reason: cls.reason,\n    ...(cls.status !== undefined ? { status: cls.status } : {}),\n    ...(cls.code !== undefined ? { code: cls.code } : {}),\n    ...(params.durationMs !== undefined ? { durationMs: params.durationMs } : {}),\n  };\n  params.attempts.push(attempt);\n  return attempt;\n}\n\nexport interface ThrowCapabilityGenerationFailureParams {\n  capabilityLabel: string;\n  attempts: FallbackAttempt[];\n  lastError: unknown;\n}\n\n/** Throw a unified {@link FailoverError} after all candidates have been exhausted. */\nexport function throwCapabilityGenerationFailure(params: ThrowCapabilityGenerationFailureParams): never {\n  // capabilityLabel like \"image generation\" → identifier \"image-generation\"\n  const capability = params.capabilityLabel.trim().toLowerCase().replace(/\\s+/g, '-') || 'capability';\n  throw new FailoverError({\n    capability,\n    attempts: params.attempts,\n    cause: params.lastError,\n  });\n}\n\n// ============================================\n// \"No model configured\" message\n// ============================================\n\nexport interface BuildNoCapabilityModelConfiguredMessageParams {\n  /** Display label, e.g. \"image-generation\". */\n  capabilityLabel: string;\n  /** Config key path, e.g. \"imageGenerationModel\". */\n  modelConfigKey: string;\n  providers: ReadonlyArray<CapabilityProviderCandidate>;\n  /** Optional env-var lookup, e.g. (id) => PROVIDER_ENV_MAP[id]. */\n  getProviderEnvVars?: (id: string) => readonly string[] | undefined;\n}\n\nexport function buildNoCapabilityModelConfiguredMessage(\n  params: BuildNoCapabilityModelConfiguredMessageParams,\n): string {\n  const lines: string[] = [\n    `No ${params.capabilityLabel} model configured. Set agents.defaults.${params.modelConfigKey} ` +\n      `to a \"<provider>/<model>\" value (or pass modelOverride at call site).`,\n  ];\n  if (params.providers.length > 0) {\n    lines.push('Registered providers:');\n    for (const p of params.providers) {\n      const envs = params.getProviderEnvVars?.(p.id) ?? [];\n      const env = envs.length > 0 ? ` (env: ${envs.join(' | ')})` : '';\n      const def = p.defaultModel ? ` default=${p.defaultModel}` : '';\n      lines.push(`  - ${p.id}${def}${env}`);\n    }\n  }\n  return lines.join('\\n');\n}\n\n/**\n * Build a `metadata.normalization` snapshot from a completed normalization\n * pass. Providers / runtime can spread it into their result metadata.\n */\nexport function buildMediaGenerationNormalizationMetadata(params: {\n  normalization?: Record<string, unknown>;\n}): Record<string, unknown> {\n  if (!params.normalization || Object.keys(params.normalization).length === 0) return {};\n  return { normalization: params.normalization };\n}\n\n// Re-export the union for downstream type narrowing.\nexport type { FailoverReason };\n"],"mappings":"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"}

package/dist/src/agent/memory/builtin-memory-store.js

@@ -1,6 +1,6 @@
-import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 import lockfile from "proper-lockfile";
 //#region src/agent/memory/builtin-memory-store.ts
 /**

package/dist/src/agent/memory/dreaming/deep-promotion.js

@@ -4,8 +4,8 @@ import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, isoDay, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore, saveDreamingStore, withDreamingPromotionLock } from "./short-term-store.js";
 import { emptyDeepPhaseSkipped, writeDreamingDeepLastRun } from "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/deep-promotion.ts
 init_logger();
 const log = createLogger("Dreaming:Deep");

package/dist/src/agent/memory/dreaming/events.js

@@ -1,6 +1,6 @@
 import { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE } from "./constants.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/events.ts
 /**
 * Append a single event line to `memory/.dreams/events.jsonl`.

package/dist/src/agent/memory/dreaming/last-run.js

@@ -1,6 +1,6 @@
 import { DREAMING_LAST_RUN_RELATIVE } from "./constants.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/last-run.ts
 const DREAMING_LAST_RUN_FORMAT_VERSION = 2;
 function isRecord(v) {

package/dist/src/agent/memory/dreaming/light-sweep.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE } from "./constants.js";
 import { buildEntryKey, isoDay, normalizeMemoryPath, normalizeSnippetForHash, snippetHash } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/light-sweep.ts
 init_logger();
 const log = createLogger("Dreaming:Light");

package/dist/src/agent/memory/dreaming/preview.js

@@ -1,8 +1,8 @@
 import { MEMORY_MD_FILENAME } from "./constants.js";
 import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore } from "./short-term-store.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/preview.ts
 async function previewDreamingDeepPromotion(params) {
 	const cfg = resolveDeepDefaults(params.config);

package/dist/src/agent/memory/dreaming/rem-patterns.js

@@ -4,8 +4,8 @@ import { DREAMING_DIR_RELATIVE, DREAMS_MD_FILENAME, MS_PER_DAY } from "./constan
 import { isoDay } from "./utils.js";
 import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
 import "./last-run.js";
-import path from "node:path";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/rem-patterns.ts
 init_logger();
 const log = createLogger("Dreaming:REM");

package/dist/src/agent/memory/dreaming/short-term-store.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "./constants.js";
 import { buildEntryKey, clamp01, isoDay, normalizeMemoryPath } from "./utils.js";
-import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/short-term-store.ts
 init_logger();
 const log = createLogger("Dreaming:Store");

package/dist/src/agent/memory/dreaming/utils.js

@@ -1,7 +1,7 @@
 import { DEFAULT_DEEP_CRON, DIVERSITY_WEIGHT, MS_PER_DAY, REINFORCEMENT_WEIGHT } from "./constants.js";
-import path from "node:path";
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
+import path from "node:path";
 //#region src/agent/memory/dreaming/utils.ts
 /** Normalize a workspace-relative memory path: forward slashes, no odd ../ escapes at start. */
 function normalizeMemoryPath(rel) {

package/dist/src/agent/memory/plugin-discovery.js

@@ -1,5 +1,5 @@
-import { dirname, join } from "node:path";
 import { readdir, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/agent/memory/plugin-discovery.ts
 async function discoverMemoryPlugins() {

package/dist/src/agent/messaging/command-handler.d.ts

@@ -29,6 +29,11 @@ export interface CommandHandlerConfig {
     switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;
     /** Drop in-memory agent after session file is cleared (e.g. /new) */
     invalidateAgentSession?: (sessionKey: string) => void;
+    /** Reset session in place (archive transcript, new session id; preserve overrides) */
+    resetSession?: (sessionKey: string) => Promise<{
+        sessionId: string;
+        previousSessionId: string;
+    } | null>;
     /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */
     abortSessionTurn?: (sessionKey: string) => Promise<void>;
     compactSession?: (sessionKey: string, options?: {
@@ -61,6 +66,7 @@ export declare class CommandHandler {
     private btwQuery?;
     private getSessionContextReport?;
     private getPersistentGoalApisForCommand;
+    private resetSession?;
     constructor(handlerConfig: CommandHandlerConfig);
     /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */
     updateAgentConfig(config: Config): void;

package/dist/src/agent/messaging/command-handler.js

@@ -26,6 +26,7 @@ var CommandHandler = class {
 	btwQuery;
 	getSessionContextReport;
 	getPersistentGoalApisForCommand;
+	resetSession;
 	constructor(handlerConfig) {
 		this.config = handlerConfig.config;
 		this.bus = handlerConfig.bus;
@@ -40,6 +41,7 @@ var CommandHandler = class {
 		this.btwQuery = handlerConfig.btwQuery;
 		this.getSessionContextReport = handlerConfig.getSessionContextReport;
 		this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;
+		this.resetSession = handlerConfig.resetSession;
 	}
 	/** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */
 	updateAgentConfig(config) {
@@ -116,6 +118,9 @@ var CommandHandler = class {
 				};
 			},
 			invalidateAgentSession: this.invalidateAgentSession,
+			resetSession: this.resetSession ? async (sk) => {
+				await this.resetSession(sk);
+			} : void 0,
 			abortCurrentTurn: this.abortSessionTurn ? async () => {
 				await this.abortSessionTurn(context.sessionKey);
 			} : void 0,

package/dist/src/agent/messaging/command-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.js","names":[],"sources":["../../../../src/agent/messaging/command-handler.ts"],"sourcesContent":["/**\n * Command Handler - Parses and executes commands\n *\n * Handles command execution using the unified command system.\n */\n\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  commandRegistry,\n  createCommandContext,\n  type CommandContext as UnifiedCommandContext,\n} from '../../chat-commands/index.js';\nimport { getAllProviders, getModelsByProvider, getProviderDisplayName } from '../../providers/index.js';\nimport type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';\n\nconst log = createLogger('CommandHandler');\n\n/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */\nfunction shouldSkipBusOutboundForChannel(channel: string): boolean {\n  return channel === 'webchat';\n}\n\nexport interface CommandContext {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  /** From inbound message metadata (thread/account, etc.) for `/goal` continuation routing. */\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface CommandHandlerConfig {\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After /think persists, sync pi-agent */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  getCurrentModel: () => string;\n  switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  /** Drop in-memory agent after session file is cleared (e.g. /new) */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */\n  abortSessionTurn?: (sessionKey: string) => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  getPersistentGoalApisForCommand: (routing: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    inboundMetadata?: Record<string, unknown>;\n  }) => PersistentGoalApis;\n}\n\nexport class CommandHandler {\n  private config: Config;\n  private bus: MessageBus;\n  private sessionStore: SessionStore;\n  private sessionConfigStore?: SessionConfigStore;\n  private applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  private getCurrentModel: () => string;\n  private switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  private invalidateAgentSession?: (sessionKey: string) => void;\n  private abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  private compactSession?: CommandHandlerConfig['compactSession'];\n  private btwQuery?: CommandHandlerConfig['btwQuery'];\n  private getSessionContextReport?: CommandHandlerConfig['getSessionContextReport'];\n  private getPersistentGoalApisForCommand: CommandHandlerConfig['getPersistentGoalApisForCommand'];\n\n  constructor(handlerConfig: CommandHandlerConfig) {\n    this.config = handlerConfig.config;\n    this.bus = handlerConfig.bus;\n    this.sessionStore = handlerConfig.sessionStore;\n    this.sessionConfigStore = handlerConfig.sessionConfigStore;\n    this.applySessionThinkingLevel = handlerConfig.applySessionThinkingLevel;\n    this.getCurrentModel = handlerConfig.getCurrentModel;\n    this.switchModelForSession = handlerConfig.switchModelForSession;\n    this.invalidateAgentSession = handlerConfig.invalidateAgentSession;\n    this.abortSessionTurn = handlerConfig.abortSessionTurn;\n    this.compactSession = handlerConfig.compactSession;\n    this.btwQuery = handlerConfig.btwQuery;\n    this.getSessionContextReport = handlerConfig.getSessionContextReport;\n    this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;\n  }\n\n  /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */\n  updateAgentConfig(config: Config): void {\n    this.config = config;\n  }\n\n  /**\n   * Build the unified command context shared by all execute paths.\n   * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).\n   */\n  private buildCommandContext(\n    context: CommandContext,\n    recorder?: (text: string) => void,\n  ): UnifiedCommandContext {\n    const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);\n\n    return createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        recorder?.(text);\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as { input?: number; output?: number };\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n    });\n  }\n\n  /**\n   * Execute a command using the unified command system\n   */\n  async executeCommand(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<boolean> {\n    if (!commandRegistry.has(commandName)) {\n      return false;\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command via new system');\n\n    const cmdCtx = this.buildCommandContext(context);\n    const result = await commandRegistry.execute(commandName, cmdCtx, args);\n\n    if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) {\n      await this.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: result.content,\n        type: 'message',\n      });\n    }\n\n    return true;\n  }\n\n  /**\n   * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.\n   * Same bus side effects as {@link executeCommand}.\n   */\n  async executeCommandAndAggregateReply(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<{ handled: boolean; aggregatedText: string }> {\n    if (!commandRegistry.has(commandName)) {\n      return { handled: false, aggregatedText: '' };\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command (aggregate reply)');\n\n    const segments: string[] = [];\n    const wrapped = this.buildCommandContext(context, (text) => segments.push(text));\n    const result = await commandRegistry.execute(commandName, wrapped, args);\n\n    if (result.content) {\n      segments.push(result.content);\n      if (!shouldSkipBusOutboundForChannel(context.channel)) {\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: result.content,\n          type: 'message',\n        });\n      }\n    }\n\n    const aggregatedText = segments.filter((s) => s && s.trim()).join('\\n\\n');\n    return { handled: true, aggregatedText };\n  }\n}\n"],"mappings":";;;;;;;gBAQoE;aAIf;AASrD,MAAM,MAAM,aAAa,iBAAiB;;AAG1C,SAAS,gCAAgC,SAA0B;AACjE,QAAO,YAAY;;AA+CrB,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,eAAqC;AAC/C,OAAK,SAAS,cAAc;AAC5B,OAAK,MAAM,cAAc;AACzB,OAAK,eAAe,cAAc;AAClC,OAAK,qBAAqB,cAAc;AACxC,OAAK,4BAA4B,cAAc;AAC/C,OAAK,kBAAkB,cAAc;AACrC,OAAK,wBAAwB,cAAc;AAC3C,OAAK,yBAAyB,cAAc;AAC5C,OAAK,mBAAmB,cAAc;AACtC,OAAK,iBAAiB,cAAc;AACpC,OAAK,WAAW,cAAc;AAC9B,OAAK,0BAA0B,cAAc;AAC7C,OAAK,kCAAkC,cAAc;;;CAIvD,kBAAkB,QAAsB;AACtC,OAAK,SAAS;;;;;;CAOhB,oBACE,SACA,UACuB;EACvB,MAAM,kBAAkB,gCAAgC,QAAQ,QAAQ;AAExE,SAAO,qBAAqB;GAC1B,YAAY,QAAQ;GACpB,QAAQ,QAAQ;GAChB,WAAW,QAAQ;GACnB,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,SAAS,QAAQ;GACjB,QAAQ,KAAK;GACb,KAAK,KAAK;GACV,cAAc,KAAK;GACnB,oBAAoB,KAAK;GACzB,2BAA2B,KAAK;GAEhC,cAAc,OAAO,MAAc,aAAc;AAC/C,eAAW,KAAK;AAChB,QAAI,gBAAiB;AACrB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,QAAQ;KACjB,SAAS,QAAQ;KACjB,SAAS;KACT,MAAM;KACP,CAAC;;GAGJ,eAAe,OAAO,WAAoB;AACxC,QAAI,gBAAiB;AACrB,UAAM,KAAK,IAAI,gBAAgB;KAC7B,SAAS,QAAQ;KACjB,SAAS,QAAQ;KACjB,MAAM,SAAS,cAAc;KAC9B,CAAC;;GAGJ,mBAAmB,CAAC,YAAY,SAAS;GAEzC,iBAAiB,KAAK;GAEtB,aAAa,OAAO,YAAoB;AACtC,WAAO,KAAK,sBAAsB,QAAQ,YAAY,QAAQ;;GAGhE,YAAY,YAAY;IACtB,MAAM,YAAY,iBAAiB;IACnC,MAAM,SAAgE,EAAE;AAExE,SAAK,MAAM,cAAc,UACvB,KAAI,yBAAyB,WAAW,EAAE;KACxC,MAAM,iBAAiB,oBAAoB,WAAW;AACtD,UAAK,MAAM,KAAK,eACd,QAAO,KAAK;MACV,IAAI,GAAG,EAAE,SAAS,GAAG,EAAE;MACvB,MAAM,EAAE,QAAQ,EAAE;MAClB,UAAU,uBAAuB,WAAW;MAC7C,CAAC;;AAKR,WAAO;;GAGT,UAAU,YAAY;IACpB,MAAM,WAAW,MAAM,KAAK,aAAa,KAAK,QAAQ,WAAW;IACjE,IAAI,eAAe;IACnB,IAAI,mBAAmB;AAEvB,SAAK,MAAM,OAAO,SAChB,KAAI,WAAW,OAAO,IAAI,OAAO;KAC/B,MAAM,QAAQ,IAAI;AAClB,qBAAgB,MAAM,SAAS;AAC/B,yBAAoB,MAAM,UAAU;;AAIxC,WAAO;KACL;KACA;KACA,aAAa,eAAe;KAC5B,cAAc,SAAS;KACxB;;GAGH,wBAAwB,KAAK;GAE7B,kBAAkB,KAAK,mBACnB,YAAY;AACV,UAAM,KAAK,iBAAkB,QAAQ,WAAW;OAElD,KAAA;GAEJ,gBAAgB,KAAK;GACrB,UAAU,KAAK;GACf,yBAAyB,KAAK;GAC9B,oBAAoB,KAAK,gCAAgC;IACvD,YAAY,QAAQ;IACpB,SAAS,QAAQ;IACjB,QAAQ,QAAQ;IAChB,iBAAiB,QAAQ;IAC1B,CAAC;GACH,CAAC;;;;;CAMJ,MAAM,eACJ,aACA,MACA,SACkB;AAClB,MAAI,CAAC,gBAAgB,IAAI,YAAY,CACnC,QAAO;AAGT,MAAI,KAAK;GAAE,SAAS;GAAa,YAAY,QAAQ;GAAY,EAAE,mCAAmC;EAEtG,MAAM,SAAS,KAAK,oBAAoB,QAAQ;EAChD,MAAM,SAAS,MAAM,gBAAgB,QAAQ,aAAa,QAAQ,KAAK;AAEvE,MAAI,OAAO,WAAW,CAAC,gCAAgC,QAAQ,QAAQ,CACrE,OAAM,KAAK,IAAI,gBAAgB;GAC7B,SAAS,QAAQ;GACjB,SAAS,QAAQ;GACjB,SAAS,OAAO;GAChB,MAAM;GACP,CAAC;AAGJ,SAAO;;;;;;CAOT,MAAM,gCACJ,aACA,MACA,SACuD;AACvD,MAAI,CAAC,gBAAgB,IAAI,YAAY,CACnC,QAAO;GAAE,SAAS;GAAO,gBAAgB;GAAI;AAG/C,MAAI,KAAK;GAAE,SAAS;GAAa,YAAY,QAAQ;GAAY,EAAE,sCAAsC;EAEzG,MAAM,WAAqB,EAAE;EAC7B,MAAM,UAAU,KAAK,oBAAoB,UAAU,SAAS,SAAS,KAAK,KAAK,CAAC;EAChF,MAAM,SAAS,MAAM,gBAAgB,QAAQ,aAAa,SAAS,KAAK;AAExE,MAAI,OAAO,SAAS;AAClB,YAAS,KAAK,OAAO,QAAQ;AAC7B,OAAI,CAAC,gCAAgC,QAAQ,QAAQ,CACnD,OAAM,KAAK,IAAI,gBAAgB;IAC7B,SAAS,QAAQ;IACjB,SAAS,QAAQ;IACjB,SAAS,OAAO;IAChB,MAAM;IACP,CAAC;;AAKN,SAAO;GAAE,SAAS;GAAM,gBADD,SAAS,QAAQ,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,OAC5B;GAAE"}
+{"version":3,"file":"command-handler.js","names":[],"sources":["../../../../src/agent/messaging/command-handler.ts"],"sourcesContent":["/**\n * Command Handler - Parses and executes commands\n *\n * Handles command execution using the unified command system.\n */\n\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport type { ThinkLevel } from '../transcript/thinking-types.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport { createLogger } from '../../utils/logger.js';\nimport {\n  commandRegistry,\n  createCommandContext,\n  type CommandContext as UnifiedCommandContext,\n} from '../../chat-commands/index.js';\nimport { getAllProviders, getModelsByProvider, getProviderDisplayName } from '../../providers/index.js';\nimport type { PersistentGoalApis } from '../goals/persistent-goal-apis.js';\n\nconst log = createLogger('CommandHandler');\n\n/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */\nfunction shouldSkipBusOutboundForChannel(channel: string): boolean {\n  return channel === 'webchat';\n}\n\nexport interface CommandContext {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  /** From inbound message metadata (thread/account, etc.) for `/goal` continuation routing. */\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface CommandHandlerConfig {\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After /think persists, sync pi-agent */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  getCurrentModel: () => string;\n  switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  /** Drop in-memory agent after session file is cleared (e.g. /new) */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive transcript, new session id; preserve overrides) */\n  resetSession?: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n  /** Cancel streaming preview + in-flight LLM work for this session (e.g. /abort) */\n  abortSessionTurn?: (sessionKey: string) => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  getPersistentGoalApisForCommand: (routing: {\n    sessionKey: string;\n    channel: string;\n    chatId: string;\n    inboundMetadata?: Record<string, unknown>;\n  }) => PersistentGoalApis;\n}\n\nexport class CommandHandler {\n  private config: Config;\n  private bus: MessageBus;\n  private sessionStore: SessionStore;\n  private sessionConfigStore?: SessionConfigStore;\n  private applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  private getCurrentModel: () => string;\n  private switchModelForSession: (sessionKey: string, modelId: string) => Promise<boolean>;\n  private invalidateAgentSession?: (sessionKey: string) => void;\n  private abortSessionTurn?: (sessionKey: string) => Promise<void>;\n  private compactSession?: CommandHandlerConfig['compactSession'];\n  private btwQuery?: CommandHandlerConfig['btwQuery'];\n  private getSessionContextReport?: CommandHandlerConfig['getSessionContextReport'];\n  private getPersistentGoalApisForCommand: CommandHandlerConfig['getPersistentGoalApisForCommand'];\n  private resetSession?: CommandHandlerConfig['resetSession'];\n\n  constructor(handlerConfig: CommandHandlerConfig) {\n    this.config = handlerConfig.config;\n    this.bus = handlerConfig.bus;\n    this.sessionStore = handlerConfig.sessionStore;\n    this.sessionConfigStore = handlerConfig.sessionConfigStore;\n    this.applySessionThinkingLevel = handlerConfig.applySessionThinkingLevel;\n    this.getCurrentModel = handlerConfig.getCurrentModel;\n    this.switchModelForSession = handlerConfig.switchModelForSession;\n    this.invalidateAgentSession = handlerConfig.invalidateAgentSession;\n    this.abortSessionTurn = handlerConfig.abortSessionTurn;\n    this.compactSession = handlerConfig.compactSession;\n    this.btwQuery = handlerConfig.btwQuery;\n    this.getSessionContextReport = handlerConfig.getSessionContextReport;\n    this.getPersistentGoalApisForCommand = handlerConfig.getPersistentGoalApisForCommand;\n    this.resetSession = handlerConfig.resetSession;\n  }\n\n  /** Replace config reference after hot reload or gateway PATCH so commands see current defaults. */\n  updateAgentConfig(config: Config): void {\n    this.config = config;\n  }\n\n  /**\n   * Build the unified command context shared by all execute paths.\n   * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).\n   */\n  private buildCommandContext(\n    context: CommandContext,\n    recorder?: (text: string) => void,\n  ): UnifiedCommandContext {\n    const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);\n\n    return createCommandContext({\n      sessionKey: context.sessionKey,\n      source: context.channel as 'telegram' | 'webui' | 'cli' | 'api' | 'system' | 'gateway',\n      channelId: context.channel,\n      chatId: context.chatId,\n      senderId: context.senderId,\n      isGroup: context.isGroup,\n      config: this.config,\n      bus: this.bus,\n      sessionStore: this.sessionStore,\n      sessionConfigStore: this.sessionConfigStore,\n      applySessionThinkingLevel: this.applySessionThinkingLevel,\n\n      replyHandler: async (text: string, _options?) => {\n        recorder?.(text);\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: text,\n          type: 'message',\n        });\n      },\n\n      typingHandler: async (typing: boolean) => {\n        if (skipBusOutbound) return;\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          type: typing ? 'typing_on' : 'typing_off',\n        });\n      },\n\n      supportedFeatures: ['markdown', 'typing'],\n\n      getCurrentModel: this.getCurrentModel,\n\n      switchModel: async (modelId: string) => {\n        return this.switchModelForSession(context.sessionKey, modelId);\n      },\n\n      listModels: async () => {\n        const providers = getAllProviders();\n        const models: Array<{ id: string; name: string; provider: string }> = [];\n\n        for (const providerId of providers) {\n          if (isProviderConfiguredSync(providerId)) {\n            const providerModels = getModelsByProvider(providerId);\n            for (const m of providerModels) {\n              models.push({\n                id: `${m.provider}/${m.id}`,\n                name: m.name || m.id,\n                provider: getProviderDisplayName(providerId),\n              });\n            }\n          }\n        }\n\n        return models;\n      },\n\n      getUsage: async () => {\n        const messages = await this.sessionStore.load(context.sessionKey);\n        let promptTokens = 0;\n        let completionTokens = 0;\n\n        for (const msg of messages) {\n          if ('usage' in msg && msg.usage) {\n            const usage = msg.usage as { input?: number; output?: number };\n            promptTokens += usage.input || 0;\n            completionTokens += usage.output || 0;\n          }\n        }\n\n        return {\n          promptTokens,\n          completionTokens,\n          totalTokens: promptTokens + completionTokens,\n          messageCount: messages.length,\n        };\n      },\n\n      invalidateAgentSession: this.invalidateAgentSession,\n\n      resetSession: this.resetSession\n        ? async (sk) => {\n            await this.resetSession!(sk);\n          }\n        : undefined,\n\n      abortCurrentTurn: this.abortSessionTurn\n        ? async () => {\n            await this.abortSessionTurn!(context.sessionKey);\n          }\n        : undefined,\n\n      compactSession: this.compactSession,\n      btwQuery: this.btwQuery,\n      getSessionContextReport: this.getSessionContextReport,\n      persistentGoalApis: this.getPersistentGoalApisForCommand({\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        inboundMetadata: context.inboundMetadata,\n      }),\n    });\n  }\n\n  /**\n   * Execute a command using the unified command system\n   */\n  async executeCommand(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<boolean> {\n    if (!commandRegistry.has(commandName)) {\n      return false;\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command via new system');\n\n    const cmdCtx = this.buildCommandContext(context);\n    const result = await commandRegistry.execute(commandName, cmdCtx, args);\n\n    if (result.content && !shouldSkipBusOutboundForChannel(context.channel)) {\n      await this.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: result.content,\n        type: 'message',\n      });\n    }\n\n    return true;\n  }\n\n  /**\n   * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.\n   * Same bus side effects as {@link executeCommand}.\n   */\n  async executeCommandAndAggregateReply(\n    commandName: string,\n    args: string,\n    context: CommandContext,\n  ): Promise<{ handled: boolean; aggregatedText: string }> {\n    if (!commandRegistry.has(commandName)) {\n      return { handled: false, aggregatedText: '' };\n    }\n\n    log.info({ command: commandName, sessionKey: context.sessionKey }, 'Executing command (aggregate reply)');\n\n    const segments: string[] = [];\n    const wrapped = this.buildCommandContext(context, (text) => segments.push(text));\n    const result = await commandRegistry.execute(commandName, wrapped, args);\n\n    if (result.content) {\n      segments.push(result.content);\n      if (!shouldSkipBusOutboundForChannel(context.channel)) {\n        await this.bus.publishOutbound({\n          channel: context.channel,\n          chat_id: context.chatId,\n          content: result.content,\n          type: 'message',\n        });\n      }\n    }\n\n    const aggregatedText = segments.filter((s) => s && s.trim()).join('\\n\\n');\n    return { handled: true, aggregatedText };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/models/manager.js

@@ -1,6 +1,6 @@
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { getAllModels, getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";

package/dist/src/agent/orchestration/llm-turn-retry.d.ts

@@ -7,6 +7,8 @@
 import type { Agent, AgentMessage } from '@earendil-works/pi-agent-core';
 export declare function isTransientLlmErrorMessage(message: string): boolean;
 export declare function getLastAssistantMessage(messages: AgentMessage[]): AgentMessage | undefined;
+/** Raw provider/LLM error from the last failed assistant message, if any. */
+export declare function getAssistantTurnErrorMessage(agent: Agent): string | undefined;
 /** After waitForIdle + transient retries, true if the last assistant turn ended in error. */
 export declare function isAssistantTurnFailed(agent: Agent): boolean;
 /** User or client aborted the assistant turn — do not try another model. */

package/dist/src/agent/orchestration/llm-turn-retry.js

@@ -19,6 +19,14 @@ function isTransientLlmErrorMessage(message) {
 function getLastAssistantMessage(messages) {
 	for (let i = messages.length - 1; i >= 0; i--) if (messages[i].role === "assistant") return messages[i];
 }
+/** Raw provider/LLM error from the last failed assistant message, if any. */
+function getAssistantTurnErrorMessage(agent) {
+	const last = getLastAssistantMessage(agent.state.messages);
+	if (!last) return void 0;
+	if (last.stopReason !== "error") return void 0;
+	const errMsg = last.errorMessage;
+	if (typeof errMsg === "string" && errMsg.trim()) return errMsg.trim();
+}
 /** After waitForIdle + transient retries, true if the last assistant turn ended in error. */
 function isAssistantTurnFailed(agent) {
 	const last = getLastAssistantMessage(agent.state.messages);
@@ -81,6 +89,6 @@ async function maybeRetryTurnAfterTransientLlmFailure(agent, options) {
 	}
 }
 //#endregion
-export { getLastAssistantMessage, isAssistantTurnAborted, isAssistantTurnFailed, isTransientLlmErrorMessage, maybeRetryTurnAfterTransientLlmFailure, stripTrailingErrorAssistantMessages };
+export { getAssistantTurnErrorMessage, getLastAssistantMessage, isAssistantTurnAborted, isAssistantTurnFailed, isTransientLlmErrorMessage, maybeRetryTurnAfterTransientLlmFailure, stripTrailingErrorAssistantMessages };
 
 //# sourceMappingURL=llm-turn-retry.js.map

package/dist/src/agent/orchestration/llm-turn-retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-turn-retry.js","names":[],"sources":["../../../../src/agent/orchestration/llm-turn-retry.ts"],"sourcesContent":["/**\n * When the LLM stream completes with stopReason \"error\" (e.g. undici \"fetch failed\"\n * to the provider API), pi-agent-core does not throw — it appends an error assistant\n * message. This module detects transient network-style failures and retries the turn\n * via Agent.continue() after stripping the failed assistant message.\n */\n\nimport type { Agent, AgentMessage } from '@earendil-works/pi-agent-core';\n\nconst TRANSIENT_LLM_ERROR_SUBSTRINGS = [\n  'fetch failed',\n  'econnreset',\n  'econnrefused',\n  'enotfound',\n  'socket hang up',\n  'getaddrinfo',\n  'networkerror',\n  'etimedout',\n  'certificate',\n  'ssl',\n  'tls',\n];\n\nexport function isTransientLlmErrorMessage(message: string): boolean {\n  const lower = message.toLowerCase();\n  return TRANSIENT_LLM_ERROR_SUBSTRINGS.some((s) => lower.includes(s));\n}\n\nexport function getLastAssistantMessage(messages: AgentMessage[]): AgentMessage | undefined {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i].role === 'assistant') {\n      return messages[i];\n    }\n  }\n  return undefined;\n}\n\n/** After waitForIdle + transient retries, true if the last assistant turn ended in error. */\nexport function isAssistantTurnFailed(agent: Agent): boolean {\n  const last = getLastAssistantMessage(agent.state.messages);\n  if (!last) {\n    return true;\n  }\n  return (last as { stopReason?: string }).stopReason === 'error';\n}\n\n/** User or client aborted the assistant turn — do not try another model. */\nexport function isAssistantTurnAborted(agent: Agent): boolean {\n  const last = getLastAssistantMessage(agent.state.messages);\n  if (!last) {\n    return false;\n  }\n  return (last as { stopReason?: string }).stopReason === 'aborted';\n}\n\n/**\n * Remove trailing assistant messages that ended in error/aborted (typically one).\n */\nexport function stripTrailingErrorAssistantMessages(messages: AgentMessage[]): AgentMessage[] {\n  const out = [...messages];\n  while (out.length > 0) {\n    const last = out[out.length - 1];\n    if (last.role !== 'assistant') {\n      break;\n    }\n    const sr = (last as { stopReason?: string }).stopReason;\n    if (sr === 'error' || sr === 'aborted') {\n      out.pop();\n      continue;\n    }\n    break;\n  }\n  return out;\n}\n\nexport interface RetryTransientTurnOptions {\n  /** Extra turns after a failed assistant message (default 2). */\n  maxContinues?: number;\n  sessionKey: string;\n  log: {\n    warn: (obj: Record<string, unknown>, msg: string) => void;\n  };\n}\n\n/**\n * After waitForIdle(), call this to optionally re-run the last user turn when the\n * assistant message only contains a transient provider/network error.\n */\nexport async function maybeRetryTurnAfterTransientLlmFailure(\n  agent: Agent,\n  options: RetryTransientTurnOptions,\n): Promise<void> {\n  const maxContinues = options.maxContinues ?? 2;\n  let continues = 0;\n\n  while (continues < maxContinues) {\n    const last = getLastAssistantMessage(agent.state.messages);\n    if (!last) {\n      return;\n    }\n    const sr = (last as { stopReason?: string }).stopReason;\n    if (sr !== 'error') {\n      return;\n    }\n    const errMsg = String((last as { errorMessage?: string }).errorMessage || '');\n    if (!isTransientLlmErrorMessage(errMsg)) {\n      options.log.warn(\n        { sessionKey: options.sessionKey, errorMessage: errMsg },\n        'Assistant turn ended with error (not retrying as transient)',\n      );\n      return;\n    }\n\n    continues += 1;\n    options.log.warn(\n      {\n        sessionKey: options.sessionKey,\n        errorMessage: errMsg,\n        continueAttempt: continues,\n        maxContinues,\n      },\n      'LLM request failed with a transient network error; retrying the same turn. If this persists, check outbound HTTPS to the provider API and HTTP(S)_PROXY.',\n    );\n\n    const trimmed = stripTrailingErrorAssistantMessages(agent.state.messages);\n    agent.state.messages = trimmed;\n    await agent.continue();\n    await agent.waitForIdle();\n  }\n}\n"],"mappings":";AASA,MAAM,iCAAiC;CACrC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,2BAA2B,SAA0B;CACnE,MAAM,QAAQ,QAAQ,aAAa;AACnC,QAAO,+BAA+B,MAAM,MAAM,MAAM,SAAS,EAAE,CAAC;;AAGtE,SAAgB,wBAAwB,UAAoD;AAC1F,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,IACxC,KAAI,SAAS,GAAG,SAAS,YACvB,QAAO,SAAS;;;AAOtB,SAAgB,sBAAsB,OAAuB;CAC3D,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,KAAI,CAAC,KACH,QAAO;AAET,QAAQ,KAAiC,eAAe;;;AAI1D,SAAgB,uBAAuB,OAAuB;CAC5D,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,KAAI,CAAC,KACH,QAAO;AAET,QAAQ,KAAiC,eAAe;;;;;AAM1D,SAAgB,oCAAoC,UAA0C;CAC5F,MAAM,MAAM,CAAC,GAAG,SAAS;AACzB,QAAO,IAAI,SAAS,GAAG;EACrB,MAAM,OAAO,IAAI,IAAI,SAAS;AAC9B,MAAI,KAAK,SAAS,YAChB;EAEF,MAAM,KAAM,KAAiC;AAC7C,MAAI,OAAO,WAAW,OAAO,WAAW;AACtC,OAAI,KAAK;AACT;;AAEF;;AAEF,QAAO;;;;;;AAgBT,eAAsB,uCACpB,OACA,SACe;CACf,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,IAAI,YAAY;AAEhB,QAAO,YAAY,cAAc;EAC/B,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,MAAI,CAAC,KACH;AAGF,MADY,KAAiC,eAClC,QACT;EAEF,MAAM,SAAS,OAAQ,KAAmC,gBAAgB,GAAG;AAC7E,MAAI,CAAC,2BAA2B,OAAO,EAAE;AACvC,WAAQ,IAAI,KACV;IAAE,YAAY,QAAQ;IAAY,cAAc;IAAQ,EACxD,8DACD;AACD;;AAGF,eAAa;AACb,UAAQ,IAAI,KACV;GACE,YAAY,QAAQ;GACpB,cAAc;GACd,iBAAiB;GACjB;GACD,EACD,2JACD;EAED,MAAM,UAAU,oCAAoC,MAAM,MAAM,SAAS;AACzE,QAAM,MAAM,WAAW;AACvB,QAAM,MAAM,UAAU;AACtB,QAAM,MAAM,aAAa"}
+{"version":3,"file":"llm-turn-retry.js","names":[],"sources":["../../../../src/agent/orchestration/llm-turn-retry.ts"],"sourcesContent":["/**\n * When the LLM stream completes with stopReason \"error\" (e.g. undici \"fetch failed\"\n * to the provider API), pi-agent-core does not throw — it appends an error assistant\n * message. This module detects transient network-style failures and retries the turn\n * via Agent.continue() after stripping the failed assistant message.\n */\n\nimport type { Agent, AgentMessage } from '@earendil-works/pi-agent-core';\n\nconst TRANSIENT_LLM_ERROR_SUBSTRINGS = [\n  'fetch failed',\n  'econnreset',\n  'econnrefused',\n  'enotfound',\n  'socket hang up',\n  'getaddrinfo',\n  'networkerror',\n  'etimedout',\n  'certificate',\n  'ssl',\n  'tls',\n];\n\nexport function isTransientLlmErrorMessage(message: string): boolean {\n  const lower = message.toLowerCase();\n  return TRANSIENT_LLM_ERROR_SUBSTRINGS.some((s) => lower.includes(s));\n}\n\nexport function getLastAssistantMessage(messages: AgentMessage[]): AgentMessage | undefined {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i].role === 'assistant') {\n      return messages[i];\n    }\n  }\n  return undefined;\n}\n\n/** Raw provider/LLM error from the last failed assistant message, if any. */\nexport function getAssistantTurnErrorMessage(agent: Agent): string | undefined {\n  const last = getLastAssistantMessage(agent.state.messages);\n  if (!last) return undefined;\n  const stopReason = (last as { stopReason?: string }).stopReason;\n  if (stopReason !== 'error') return undefined;\n  const errMsg = (last as { errorMessage?: string }).errorMessage;\n  if (typeof errMsg === 'string' && errMsg.trim()) return errMsg.trim();\n  return undefined;\n}\n\n/** After waitForIdle + transient retries, true if the last assistant turn ended in error. */\nexport function isAssistantTurnFailed(agent: Agent): boolean {\n  const last = getLastAssistantMessage(agent.state.messages);\n  if (!last) {\n    return true;\n  }\n  return (last as { stopReason?: string }).stopReason === 'error';\n}\n\n/** User or client aborted the assistant turn — do not try another model. */\nexport function isAssistantTurnAborted(agent: Agent): boolean {\n  const last = getLastAssistantMessage(agent.state.messages);\n  if (!last) {\n    return false;\n  }\n  return (last as { stopReason?: string }).stopReason === 'aborted';\n}\n\n/**\n * Remove trailing assistant messages that ended in error/aborted (typically one).\n */\nexport function stripTrailingErrorAssistantMessages(messages: AgentMessage[]): AgentMessage[] {\n  const out = [...messages];\n  while (out.length > 0) {\n    const last = out[out.length - 1];\n    if (last.role !== 'assistant') {\n      break;\n    }\n    const sr = (last as { stopReason?: string }).stopReason;\n    if (sr === 'error' || sr === 'aborted') {\n      out.pop();\n      continue;\n    }\n    break;\n  }\n  return out;\n}\n\nexport interface RetryTransientTurnOptions {\n  /** Extra turns after a failed assistant message (default 2). */\n  maxContinues?: number;\n  sessionKey: string;\n  log: {\n    warn: (obj: Record<string, unknown>, msg: string) => void;\n  };\n}\n\n/**\n * After waitForIdle(), call this to optionally re-run the last user turn when the\n * assistant message only contains a transient provider/network error.\n */\nexport async function maybeRetryTurnAfterTransientLlmFailure(\n  agent: Agent,\n  options: RetryTransientTurnOptions,\n): Promise<void> {\n  const maxContinues = options.maxContinues ?? 2;\n  let continues = 0;\n\n  while (continues < maxContinues) {\n    const last = getLastAssistantMessage(agent.state.messages);\n    if (!last) {\n      return;\n    }\n    const sr = (last as { stopReason?: string }).stopReason;\n    if (sr !== 'error') {\n      return;\n    }\n    const errMsg = String((last as { errorMessage?: string }).errorMessage || '');\n    if (!isTransientLlmErrorMessage(errMsg)) {\n      options.log.warn(\n        { sessionKey: options.sessionKey, errorMessage: errMsg },\n        'Assistant turn ended with error (not retrying as transient)',\n      );\n      return;\n    }\n\n    continues += 1;\n    options.log.warn(\n      {\n        sessionKey: options.sessionKey,\n        errorMessage: errMsg,\n        continueAttempt: continues,\n        maxContinues,\n      },\n      'LLM request failed with a transient network error; retrying the same turn. If this persists, check outbound HTTPS to the provider API and HTTP(S)_PROXY.',\n    );\n\n    const trimmed = stripTrailingErrorAssistantMessages(agent.state.messages);\n    agent.state.messages = trimmed;\n    await agent.continue();\n    await agent.waitForIdle();\n  }\n}\n"],"mappings":";AASA,MAAM,iCAAiC;CACrC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,2BAA2B,SAA0B;CACnE,MAAM,QAAQ,QAAQ,aAAa;AACnC,QAAO,+BAA+B,MAAM,MAAM,MAAM,SAAS,EAAE,CAAC;;AAGtE,SAAgB,wBAAwB,UAAoD;AAC1F,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,IACxC,KAAI,SAAS,GAAG,SAAS,YACvB,QAAO,SAAS;;;AAOtB,SAAgB,6BAA6B,OAAkC;CAC7E,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,KAAI,CAAC,KAAM,QAAO,KAAA;AAElB,KADoB,KAAiC,eAClC,QAAS,QAAO,KAAA;CACnC,MAAM,SAAU,KAAmC;AACnD,KAAI,OAAO,WAAW,YAAY,OAAO,MAAM,CAAE,QAAO,OAAO,MAAM;;;AAKvE,SAAgB,sBAAsB,OAAuB;CAC3D,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,KAAI,CAAC,KACH,QAAO;AAET,QAAQ,KAAiC,eAAe;;;AAI1D,SAAgB,uBAAuB,OAAuB;CAC5D,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,KAAI,CAAC,KACH,QAAO;AAET,QAAQ,KAAiC,eAAe;;;;;AAM1D,SAAgB,oCAAoC,UAA0C;CAC5F,MAAM,MAAM,CAAC,GAAG,SAAS;AACzB,QAAO,IAAI,SAAS,GAAG;EACrB,MAAM,OAAO,IAAI,IAAI,SAAS;AAC9B,MAAI,KAAK,SAAS,YAChB;EAEF,MAAM,KAAM,KAAiC;AAC7C,MAAI,OAAO,WAAW,OAAO,WAAW;AACtC,OAAI,KAAK;AACT;;AAEF;;AAEF,QAAO;;;;;;AAgBT,eAAsB,uCACpB,OACA,SACe;CACf,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,IAAI,YAAY;AAEhB,QAAO,YAAY,cAAc;EAC/B,MAAM,OAAO,wBAAwB,MAAM,MAAM,SAAS;AAC1D,MAAI,CAAC,KACH;AAGF,MADY,KAAiC,eAClC,QACT;EAEF,MAAM,SAAS,OAAQ,KAAmC,gBAAgB,GAAG;AAC7E,MAAI,CAAC,2BAA2B,OAAO,EAAE;AACvC,WAAQ,IAAI,KACV;IAAE,YAAY,QAAQ;IAAY,cAAc;IAAQ,EACxD,8DACD;AACD;;AAGF,eAAa;AACb,UAAQ,IAAI,KACV;GACE,YAAY,QAAQ;GACpB,cAAc;GACd,iBAAiB;GACjB;GACD,EACD,2JACD;EAED,MAAM,UAAU,oCAAoC,MAAM,MAAM,SAAS;AACzE,QAAM,MAAM,WAAW;AACvB,QAAM,MAAM,UAAU;AACtB,QAAM,MAAM,aAAa"}

package/dist/src/agent/prompt/safety.d.ts

@@ -5,10 +5,3 @@ export declare function checkFileSafety(operation: 'read' | 'write' | 'delete',
     allowed: boolean;
     message?: string;
 };
-/**
- * Quick safety check for shell commands
- */
-export declare function checkShellSafety(command: string): {
-    allowed: boolean;
-    message?: string;
-};

package/dist/src/agent/prompt/safety.js

@@ -27,26 +27,7 @@ function checkFileSafety(operation, path) {
 	};
 	return { allowed: true };
 }
-/**
-* Quick safety check for shell commands
-*/
-function checkShellSafety(command) {
-	for (const pattern of [
-		/\brm\s+-?[rf]/i,
-		/\bdd\s+/i,
-		/\bmkfs/i,
-		/\bchmod\s+[0-7]{3}/i,
-		/>\s*\/dev\//i,
-		/\|\s*sh/i,
-		/\bcurl\b.*\|\s*bash/i,
-		/\bwget\b.*\|\s*bash/i
-	]) if (pattern.test(command)) return {
-		allowed: false,
-		message: `Potentially dangerous command detected: ${command.slice(0, 50)}...`
-	};
-	return { allowed: true };
-}
 //#endregion
-export { checkFileSafety, checkShellSafety };
+export { checkFileSafety };
 
 //# sourceMappingURL=safety.js.map

package/dist/src/agent/prompt/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","names":[],"sources":["../../../../src/agent/prompt/safety.ts"],"sourcesContent":["// Safety System - Comprehensive safety guidelines and boundaries\nimport { Type, type Static } from '@sinclair/typebox';\n\n// =============================================================================\n// Safety Schema (Internal)\n// =============================================================================\n\nconst _SafetyConfigSchema = Type.Object({\n  allowExternalActions: Type.Optional(Type.Boolean({ default: false })),\n  allowDangerousOperations: Type.Optional(Type.Boolean({ default: false })),\n  requireConfirmationForDestructive: Type.Optional(Type.Boolean({ default: true })),\n  allowedChannels: Type.Optional(Type.Array(Type.String())),\n  blockedCommands: Type.Optional(Type.Array(Type.String())),\n  maxFileSize: Type.Optional(Type.Number({ default: 10 * 1024 * 1024 })), // 10MB\n  maxShellTimeout: Type.Optional(Type.Number({ default: 300 })), // 5 minutes\n});\n\ntype _SafetyConfig = Static<typeof _SafetyConfigSchema>;\n\n// =============================================================================\n// Safety Levels (Internal)\n// =============================================================================\n\nenum SafetyLevel {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n  CRITICAL = 'critical',\n}\n\ninterface SafetyRule {\n  level: SafetyLevel;\n  category: string;\n  description: string;\n  message: string;\n  requiresConfirmation: boolean;\n}\n\n// =============================================================================\n// Safety Principles (Internal)\n// =============================================================================\n\ninterface SafetyPrinciple {\n  category: string;\n  description: string;\n  guidance: string;\n  requiresConfirmation: boolean;\n}\n\nconst _SAFETY_PRINCIPLES: SafetyPrinciple[] = [\n  {\n    category: 'user-sovereignty',\n    description: '用户拥有最终决策权',\n    guidance: '说明风险，尊重选择。用 \"这将删除文件，继续吗？\" 而非 \"我不能删除文件。\"',\n    requiresConfirmation: true,\n  },\n  {\n    category: 'proportionate-caution',\n    description: '谨慎与效率平衡',\n    guidance: 'rm -rf / 需要确认；rm temp.txt 不需要。匹配风险等级与确认强度。',\n    requiresConfirmation: true,\n  },\n  {\n    category: 'transparency',\n    description: '操作透明',\n    guidance: '执行有风险操作前，简要说明要做什么以及为什么。',\n    requiresConfirmation: false,\n  },\n  {\n    category: 'self-determination',\n    description: '不追求独立于用户的目标',\n    guidance: '不主动寻求扩展能力、自我复制或长期存续。以用户当前需求为中心。',\n    requiresConfirmation: false,\n  },\n];\n\nconst _SAFETY_GUIDELINES: SafetyRule[] = [\n  // Critical - Never do these\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'self-preservation',\n    description: 'Do not pursue self-preservation or replication',\n    message: 'I do not pursue self-preservation or replication.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'power-seeking',\n    description: 'Do not seek power or resources',\n    message: 'I do not seek power or acquire resources.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'safeguard-bypass',\n    description: 'Do not bypass safety mechanisms',\n    message: 'I do not bypass safety mechanisms.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'social-manipulation',\n    description: 'Do not manipulate users to expand access',\n    message: 'I do not manipulate anyone to expand access.',\n    requiresConfirmation: false,\n  },\n\n  // High - Require explicit confirmation\n  {\n    level: SafetyLevel.HIGH,\n    category: 'destructive-file',\n    description: 'Delete or overwrite files',\n    message: 'This will delete/overwrite files — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'system-modification',\n    description: 'Modify system configuration',\n    message: 'This will modify system config — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'network-action',\n    description: 'Send messages or make network requests',\n    message: 'This will send external requests — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'database-write',\n    description: 'Write to databases',\n    message: 'This will modify database records — proceed?',\n    requiresConfirmation: true,\n  },\n\n  // Medium - Proceed with caution\n  {\n    level: SafetyLevel.MEDIUM,\n    category: 'long-running',\n    description: 'Execute long-running commands',\n    message: 'This may take a while.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.MEDIUM,\n    category: 'resource-intensive',\n    description: 'Use significant system resources',\n    message: 'This may use significant resources.',\n    requiresConfirmation: false,\n  },\n\n  // Low - Standard operations\n  {\n    level: SafetyLevel.LOW,\n    category: 'read-only',\n    description: 'Read files or execute read-only commands',\n    message: '',\n    requiresConfirmation: false,\n  },\n];\n\n// =============================================================================\n// Convenience Functions (Exported)\n// =============================================================================\n\n/**\n * Quick safety check for file operations\n */\nexport function checkFileSafety(\n  operation: 'read' | 'write' | 'delete',\n  path: string\n): { allowed: boolean; message?: string } {\n  // Check for sensitive paths\n  const sensitivePaths = [\n    '/etc/passwd',\n    '/etc/shadow',\n    '/root/.ssh',\n    '/home/*/.ssh',\n    '~/.aws',\n    '~/.bashrc',\n    '~/.profile',\n  ];\n\n  for (const sp of sensitivePaths) {\n    if (path.includes(sp)) {\n      return {\n        allowed: false,\n        message: `Cannot ${operation} sensitive path: ${path}`,\n      };\n    }\n  }\n\n  return { allowed: true };\n}\n\n/**\n * Quick safety check for shell commands\n */\nexport function checkShellSafety(command: string): { allowed: boolean; message?: string } {\n  const dangerousPatterns = [\n    /\\brm\\s+-?[rf]/i,           // rm -rf\n    /\\bdd\\s+/i,                  // dd\n    /\\bmkfs/i,                   // mkfs\n    /\\bchmod\\s+[0-7]{3}/i,       // chmod 777\n    />\\s*\\/dev\\//i,              // redirect to device\n    /\\|\\s*sh/i,                  // pipe to shell\n    /\\bcurl\\b.*\\|\\s*bash/i,      // curl | bash\n    /\\bwget\\b.*\\|\\s*bash/i,      // wget | bash\n  ];\n\n  for (const pattern of dangerousPatterns) {\n    if (pattern.test(command)) {\n      return {\n        allowed: false,\n        message: `Potentially dangerous command detected: ${command.slice(0, 50)}...`,\n      };\n    }\n  }\n\n  return { allowed: true };\n}\n"],"mappings":";;AAO4B,KAAK,OAAO;CACtC,sBAAsB,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC;CACrE,0BAA0B,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC;CACzE,mCAAmC,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,MAAM,CAAC,CAAC;CACjF,iBAAiB,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,CAAC,CAAC;CACzD,iBAAiB,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,CAAC,CAAC;CACzD,aAAa,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,KAAK,OAAO,MAAM,CAAC,CAAC;CACtE,iBAAiB,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,KAAK,CAAC,CAAC;CAC9D,CAAC;;;;AA2JF,SAAgB,gBACd,WACA,MACwC;AAYxC,MAAK,MAAM,MAAM;EATf;EACA;EACA;EACA;EACA;EACA;EACA;EAG6B,CAC7B,KAAI,KAAK,SAAS,GAAG,CACnB,QAAO;EACL,SAAS;EACT,SAAS,UAAU,UAAU,mBAAmB;EACjD;AAIL,QAAO,EAAE,SAAS,MAAM;;;;;AAM1B,SAAgB,iBAAiB,SAAyD;AAYxF,MAAK,MAAM,WAAW;EAVpB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGqC,CACrC,KAAI,QAAQ,KAAK,QAAQ,CACvB,QAAO;EACL,SAAS;EACT,SAAS,2CAA2C,QAAQ,MAAM,GAAG,GAAG,CAAC;EAC1E;AAIL,QAAO,EAAE,SAAS,MAAM"}
+{"version":3,"file":"safety.js","names":[],"sources":["../../../../src/agent/prompt/safety.ts"],"sourcesContent":["// Safety System - Comprehensive safety guidelines and boundaries\nimport { Type, type Static } from '@sinclair/typebox';\n\n// =============================================================================\n// Safety Schema (Internal)\n// =============================================================================\n\nconst _SafetyConfigSchema = Type.Object({\n  allowExternalActions: Type.Optional(Type.Boolean({ default: false })),\n  allowDangerousOperations: Type.Optional(Type.Boolean({ default: false })),\n  requireConfirmationForDestructive: Type.Optional(Type.Boolean({ default: true })),\n  allowedChannels: Type.Optional(Type.Array(Type.String())),\n  blockedCommands: Type.Optional(Type.Array(Type.String())),\n  maxFileSize: Type.Optional(Type.Number({ default: 10 * 1024 * 1024 })), // 10MB\n  maxShellTimeout: Type.Optional(Type.Number({ default: 300 })), // 5 minutes\n});\n\ntype _SafetyConfig = Static<typeof _SafetyConfigSchema>;\n\n// =============================================================================\n// Safety Levels (Internal)\n// =============================================================================\n\nenum SafetyLevel {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n  CRITICAL = 'critical',\n}\n\ninterface SafetyRule {\n  level: SafetyLevel;\n  category: string;\n  description: string;\n  message: string;\n  requiresConfirmation: boolean;\n}\n\n// =============================================================================\n// Safety Principles (Internal)\n// =============================================================================\n\ninterface SafetyPrinciple {\n  category: string;\n  description: string;\n  guidance: string;\n  requiresConfirmation: boolean;\n}\n\nconst _SAFETY_PRINCIPLES: SafetyPrinciple[] = [\n  {\n    category: 'user-sovereignty',\n    description: '用户拥有最终决策权',\n    guidance: '说明风险，尊重选择。用 \"这将删除文件，继续吗？\" 而非 \"我不能删除文件。\"',\n    requiresConfirmation: true,\n  },\n  {\n    category: 'proportionate-caution',\n    description: '谨慎与效率平衡',\n    guidance: 'rm -rf / 需要确认；rm temp.txt 不需要。匹配风险等级与确认强度。',\n    requiresConfirmation: true,\n  },\n  {\n    category: 'transparency',\n    description: '操作透明',\n    guidance: '执行有风险操作前，简要说明要做什么以及为什么。',\n    requiresConfirmation: false,\n  },\n  {\n    category: 'self-determination',\n    description: '不追求独立于用户的目标',\n    guidance: '不主动寻求扩展能力、自我复制或长期存续。以用户当前需求为中心。',\n    requiresConfirmation: false,\n  },\n];\n\nconst _SAFETY_GUIDELINES: SafetyRule[] = [\n  // Critical - Never do these\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'self-preservation',\n    description: 'Do not pursue self-preservation or replication',\n    message: 'I do not pursue self-preservation or replication.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'power-seeking',\n    description: 'Do not seek power or resources',\n    message: 'I do not seek power or acquire resources.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'safeguard-bypass',\n    description: 'Do not bypass safety mechanisms',\n    message: 'I do not bypass safety mechanisms.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.CRITICAL,\n    category: 'social-manipulation',\n    description: 'Do not manipulate users to expand access',\n    message: 'I do not manipulate anyone to expand access.',\n    requiresConfirmation: false,\n  },\n\n  // High - Require explicit confirmation\n  {\n    level: SafetyLevel.HIGH,\n    category: 'destructive-file',\n    description: 'Delete or overwrite files',\n    message: 'This will delete/overwrite files — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'system-modification',\n    description: 'Modify system configuration',\n    message: 'This will modify system config — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'network-action',\n    description: 'Send messages or make network requests',\n    message: 'This will send external requests — proceed?',\n    requiresConfirmation: true,\n  },\n  {\n    level: SafetyLevel.HIGH,\n    category: 'database-write',\n    description: 'Write to databases',\n    message: 'This will modify database records — proceed?',\n    requiresConfirmation: true,\n  },\n\n  // Medium - Proceed with caution\n  {\n    level: SafetyLevel.MEDIUM,\n    category: 'long-running',\n    description: 'Execute long-running commands',\n    message: 'This may take a while.',\n    requiresConfirmation: false,\n  },\n  {\n    level: SafetyLevel.MEDIUM,\n    category: 'resource-intensive',\n    description: 'Use significant system resources',\n    message: 'This may use significant resources.',\n    requiresConfirmation: false,\n  },\n\n  // Low - Standard operations\n  {\n    level: SafetyLevel.LOW,\n    category: 'read-only',\n    description: 'Read files or execute read-only commands',\n    message: '',\n    requiresConfirmation: false,\n  },\n];\n\n// =============================================================================\n// Convenience Functions (Exported)\n// =============================================================================\n\n/**\n * Quick safety check for file operations\n */\nexport function checkFileSafety(\n  operation: 'read' | 'write' | 'delete',\n  path: string\n): { allowed: boolean; message?: string } {\n  // Check for sensitive paths\n  const sensitivePaths = [\n    '/etc/passwd',\n    '/etc/shadow',\n    '/root/.ssh',\n    '/home/*/.ssh',\n    '~/.aws',\n    '~/.bashrc',\n    '~/.profile',\n  ];\n\n  for (const sp of sensitivePaths) {\n    if (path.includes(sp)) {\n      return {\n        allowed: false,\n        message: `Cannot ${operation} sensitive path: ${path}`,\n      };\n    }\n  }\n\n  return { allowed: true };\n}\n\n"],"mappings":";;AAO4B,KAAK,OAAO;CACtC,sBAAsB,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC;CACrE,0BAA0B,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC;CACzE,mCAAmC,KAAK,SAAS,KAAK,QAAQ,EAAE,SAAS,MAAM,CAAC,CAAC;CACjF,iBAAiB,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,CAAC,CAAC;CACzD,iBAAiB,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,CAAC,CAAC;CACzD,aAAa,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,KAAK,OAAO,MAAM,CAAC,CAAC;CACtE,iBAAiB,KAAK,SAAS,KAAK,OAAO,EAAE,SAAS,KAAK,CAAC,CAAC;CAC9D,CAAC;;;;AA2JF,SAAgB,gBACd,WACA,MACwC;AAYxC,MAAK,MAAM,MAAM;EATf;EACA;EACA;EACA;EACA;EACA;EACA;EAG6B,CAC7B,KAAI,KAAK,SAAS,GAAG,CACnB,QAAO;EACL,SAAS;EACT,SAAS,UAAU,UAAU,mBAAmB;EACjD;AAIL,QAAO,EAAE,SAAS,MAAM"}

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -1,6 +1,6 @@
-import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { DEFAULT_USER_FILENAME } from "../context/workspace.js";
 import { createSkillConfigManager } from "../skills/config.js";
@@ -8,8 +8,8 @@ import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { selectSkillsVisibleInPrompt } from "../skills/format-skills-prompt.js";
 import { buildSystemPrompt } from "./system-prompt.js";
-import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 //#region src/agent/prompt/service-prompt-builder.ts
 /**
 * System Prompt Builder - Builds the complete system prompt

package/dist/src/agent/reply/post-compaction-context.js

@@ -1,7 +1,7 @@
 import { init_agent_scope, resolveAgentProfileDir } from "../agent-scope.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
-import { join, resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 //#region src/agent/reply/post-compaction-context.ts
 init_agent_scope();
 const MAX_CONTEXT_CHARS = 1800;

package/dist/src/agent/reply/workspace-boundary-read.js

@@ -1,5 +1,5 @@
-import { resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
 //#region src/agent/reply/workspace-boundary-read.ts
 /**
 * Read a file relative to workspace root with path traversal guard and byte cap.

package/dist/src/agent/sandbox/path-policy.js

@@ -1,6 +1,6 @@
-import { homedir } from "node:os";
-import { isAbsolute, normalize, resolve, sep } from "node:path";
 import { realpathSync } from "node:fs";
+import { isAbsolute, normalize, resolve, sep } from "node:path";
+import { homedir } from "node:os";
 //#region src/agent/sandbox/path-policy.ts
 /**
 * Path safety validation for sandbox isolation.

package/dist/src/agent/service/build-direct-message-content.js

@@ -1,5 +1,5 @@
-import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "../agent-scope.js";
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { getDefaultModelSync, init_providers } from "../../providers/index.js";
 import { formatInboundFileTextBlock } from "../../channels/attachments/inbound-persist.js";
@@ -19,7 +19,7 @@ async function buildDirectUserMessageContent(opts) {
 	if (content.trim()) {
 		let textPart = content;
 		if (/@file:/.test(textPart)) {
-			const wsKey = sk !== "" ? sk : "cli:direct";
+			const wsKey = sk !== "" ? sk : "agent:main:main";
 			const root = agentManager.getResolvedWorkspaceForSession(wsKey);
 			textPart = await expandAtFileMentionsInPlainText(textPart, root);
 		}