@xopcai/xopc 0.0.86 → 0.0.88

package/dist/src/agent/child-agent-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"child-agent-factory.js","names":[],"sources":["../../../src/agent/child-agent-factory.ts"],"sourcesContent":["import { Agent, type ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport { resolveProviderApiKeySync } from '../auth/sync-provider-auth.js';\nimport { getApiKeySync } from '../providers/index.js';\nimport { createExtensionAwareStreamFn } from '../providers/extension-stream-bridge.js';\nimport { createLogger } from '../utils/logger.js';\n\nimport { extractTextContent } from './context/workspace.js';\nimport {\n  resolveAgentTurnTimeoutMs,\n  runAgentTurnWithTimeout,\n} from './orchestration/run-agent-turn-with-timeout.js';\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolExecutorConfig } from './tools/executor.js';\n// `AgentToolsFactory` is NOT imported here on purpose — `tools/factory.js`\n// constructs the delegate tool, which would create a factory ↔ delegate-tool\n// ↔ child-agent-factory cycle. Instead, the caller supplies a\n// `buildChildTools()` callback that produces the already-constructed child\n// tool set (see `DelegateChildHandleOptions.buildChildTools`).\n\nconst log = createLogger('delegate-child');\n\nexport function buildChildSystemPrompt(goal: string, context?: string, workspace?: string): string {\n  const parts = [\n    'You are a focused sub-agent working on a specific delegated task.',\n    '',\n    `YOUR TASK:\\n${goal}`,\n  ];\n\n  if (context?.trim()) {\n    parts.push(`\\nCONTEXT:\\n${context.trim()}`);\n  }\n\n  if (workspace?.trim()) {\n    parts.push(`\\nWORKSPACE: ${workspace.trim()}`);\n  }\n\n  parts.push(\n    '\\nComplete this task using only the tools available to you. ' +\n      'When finished, reply with a clear, concise summary covering:\\n' +\n      '- What you did\\n' +\n      '- What you found or accomplished\\n' +\n      '- Files created or modified\\n' +\n      '- Issues encountered\\n\\n' +\n      'Your final reply is returned to the parent agent — be thorough but compact.',\n  );\n\n  return parts.join('\\n');\n}\n\nexport interface BuildChildToolsOptions {\n  workspace: string;\n  bus: MessageBus;\n  model: Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n}\n\nexport interface DelegateChildHandleOptions {\n  workspace: string;\n  goal: string;\n  context?: string;\n  allowedToolNames: string[];\n  maxIterations: number;\n  model: Model<Api>;\n  bus: MessageBus;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Construct the child agent's tool set. Injected by the caller (delegate-tool)\n   * so this module does not import `tools/factory.js` (which would form a\n   * factory ↔ delegate-tool ↔ child-agent-factory cycle).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport interface DelegateChildRunResult {\n  summary: string;\n  toolIterations: number;\n}\n\nexport interface DelegateChildHandle {\n  run(): Promise<DelegateChildRunResult>;\n  abort(): void;\n}\n\n/**\n * Build an isolated tool factory (no extensions, no session memory hooks) and a child {@link Agent}.\n */\nexport function createDelegateChildHandle(options: DelegateChildHandleOptions): DelegateChildHandle {\n  const allTools = options.buildChildTools({\n    workspace: options.workspace,\n    bus: options.bus,\n    model: options.model,\n    getConfig: options.getConfig,\n    toolExecutorConfig: options.toolExecutorConfig,\n  });\n\n  const allow = new Set(options.allowedToolNames);\n  const filteredTools = allTools.filter((t) => allow.has(t.name));\n\n  if (filteredTools.length === 0) {\n    return {\n      async run() {\n        return {\n          summary: 'No tools matched the allowlist after factory registration.',\n          toolIterations: 0,\n        };\n      },\n      abort() {},\n    };\n  }\n\n  let toolIterations = 0;\n  let aborted = false;\n\n  const agent = new Agent({\n    initialState: {\n      systemPrompt: buildChildSystemPrompt(options.goal, options.context, options.workspace),\n      model: options.model,\n      thinkingLevel: 'low' as ThinkingLevel,\n      tools: filteredTools,\n      messages: [],\n    },\n    streamFn: createExtensionAwareStreamFn(),\n    getApiKey: (provider: string) =>\n      resolveProviderApiKeySync(provider) ?? getApiKeySync(provider) ?? '',\n    beforeToolCall: async () => {\n      if (aborted) {\n        return { block: true, reason: 'Sub-agent aborted.' };\n      }\n      if (toolIterations >= options.maxIterations) {\n        return {\n          block: true,\n          reason: `Sub-agent reached max tool iterations (${options.maxIterations}).`,\n        };\n      }\n      return undefined;\n    },\n    afterToolCall: async () => {\n      toolIterations += 1;\n      return undefined;\n    },\n  });\n\n  const userText = options.context?.trim()\n    ? `${options.goal}\\n\\nAdditional context:\\n${options.context.trim()}`\n    : options.goal;\n\n  return {\n    async run(): Promise<DelegateChildRunResult> {\n      toolIterations = 0;\n      aborted = false;\n      try {\n        await runAgentTurnWithTimeout(\n          agent,\n          async () => {\n            await agent.prompt(userText);\n            await agent.waitForIdle();\n          },\n          resolveAgentTurnTimeoutMs(options.getConfig()),\n        );\n\n        const messages = agent.state.messages;\n        for (let i = messages.length - 1; i >= 0; i--) {\n          const msg = messages[i];\n          if (msg.role === 'assistant') {\n            const content: unknown = msg.content;\n            if (typeof content === 'string') {\n              return { summary: content.trim() || '(empty assistant message)', toolIterations };\n            }\n            if (Array.isArray(content)) {\n              const text = extractTextContent(content as Array<{ type: string; text?: string }>);\n              return {\n                summary: text.trim() || '(empty assistant message)',\n                toolIterations,\n              };\n            }\n          }\n        }\n\n        return {\n          summary: aborted\n            ? 'Sub-agent was aborted before producing a result.'\n            : 'Sub-agent completed but produced no assistant text.',\n          toolIterations,\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        const m = options.model as { model?: string; id?: string };\n        const modelId = m?.model ?? m?.id;\n        log.warn(\n          {\n            err: e,\n            errorMessage: msg,\n            goalPreview: options.goal.slice(0, 120),\n            maxIterations: options.maxIterations,\n            allowedToolCount: options.allowedToolNames.length,\n            modelId,\n          },\n          `Delegate child run failed: ${msg}`,\n        );\n        return {\n          summary: `Sub-agent error: ${msg}`,\n          toolIterations,\n        };\n      }\n    },\n\n    abort(): void {\n      aborted = true;\n      agent.abort();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;yBAK0E;gBACpB;aAEJ;AAelD,MAAM,MAAM,aAAa,iBAAiB;AAE1C,SAAgB,uBAAuB,MAAc,SAAkB,WAA4B;CACjG,MAAM,QAAQ;EACZ;EACA;EACA,eAAe;EAChB;AAED,KAAI,SAAS,MAAM,CACjB,OAAM,KAAK,eAAe,QAAQ,MAAM,GAAG;AAG7C,KAAI,WAAW,MAAM,CACnB,OAAM,KAAK,gBAAgB,UAAU,MAAM,GAAG;AAGhD,OAAM,KACJ,+SAOD;AAED,QAAO,MAAM,KAAK,KAAK;;;;;AA0CzB,SAAgB,0BAA0B,SAA0D;CAClG,MAAM,WAAW,QAAQ,gBAAgB;EACvC,WAAW,QAAQ;EACnB,KAAK,QAAQ;EACb,OAAO,QAAQ;EACf,WAAW,QAAQ;EACnB,oBAAoB,QAAQ;EAC7B,CAAC;CAEF,MAAM,QAAQ,IAAI,IAAI,QAAQ,iBAAiB;CAC/C,MAAM,gBAAgB,SAAS,QAAQ,MAAM,MAAM,IAAI,EAAE,KAAK,CAAC;AAE/D,KAAI,cAAc,WAAW,EAC3B,QAAO;EACL,MAAM,MAAM;AACV,UAAO;IACL,SAAS;IACT,gBAAgB;IACjB;;EAEH,QAAQ;EACT;CAGH,IAAI,iBAAiB;CACrB,IAAI,UAAU;CAEd,MAAM,QAAQ,IAAI,MAAM;EACtB,cAAc;GACZ,cAAc,uBAAuB,QAAQ,MAAM,QAAQ,SAAS,QAAQ,UAAU;GACtF,OAAO,QAAQ;GACf,eAAe;GACf,OAAO;GACP,UAAU,EAAE;GACb;EACD,UAAU,8BAA8B;EACxC,YAAY,aACV,0BAA0B,SAAS,IAAI,cAAc,SAAS,IAAI;EACpE,gBAAgB,YAAY;AAC1B,OAAI,QACF,QAAO;IAAE,OAAO;IAAM,QAAQ;IAAsB;AAEtD,OAAI,kBAAkB,QAAQ,cAC5B,QAAO;IACL,OAAO;IACP,QAAQ,0CAA0C,QAAQ,cAAc;IACzE;;EAIL,eAAe,YAAY;AACzB,qBAAkB;;EAGrB,CAAC;CAEF,MAAM,WAAW,QAAQ,SAAS,MAAM,GACpC,GAAG,QAAQ,KAAK,2BAA2B,QAAQ,QAAQ,MAAM,KACjE,QAAQ;AAEZ,QAAO;EACL,MAAM,MAAuC;AAC3C,oBAAiB;AACjB,aAAU;AACV,OAAI;AACF,UAAM,wBACJ,OACA,YAAY;AACV,WAAM,MAAM,OAAO,SAAS;AAC5B,WAAM,MAAM,aAAa;OAE3B,0BAA0B,QAAQ,WAAW,CAAC,CAC/C;IAED,MAAM,WAAW,MAAM,MAAM;AAC7B,SAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;KAC7C,MAAM,MAAM,SAAS;AACrB,SAAI,IAAI,SAAS,aAAa;MAC5B,MAAM,UAAmB,IAAI;AAC7B,UAAI,OAAO,YAAY,SACrB,QAAO;OAAE,SAAS,QAAQ,MAAM,IAAI;OAA6B;OAAgB;AAEnF,UAAI,MAAM,QAAQ,QAAQ,CAExB,QAAO;OACL,SAFW,mBAAmB,QAEjB,CAAC,MAAM,IAAI;OACxB;OACD;;;AAKP,WAAO;KACL,SAAS,UACL,qDACA;KACJ;KACD;YACM,GAAG;IACV,MAAM,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;IACtD,MAAM,IAAI,QAAQ;IAClB,MAAM,UAAU,GAAG,SAAS,GAAG;AAC/B,QAAI,KACF;KACE,KAAK;KACL,cAAc;KACd,aAAa,QAAQ,KAAK,MAAM,GAAG,IAAI;KACvC,eAAe,QAAQ;KACvB,kBAAkB,QAAQ,iBAAiB;KAC3C;KACD,EACD,8BAA8B,MAC/B;AACD,WAAO;KACL,SAAS,oBAAoB;KAC7B;KACD;;;EAIL,QAAc;AACZ,aAAU;AACV,SAAM,OAAO;;EAEhB"}
+{"version":3,"file":"child-agent-factory.js","names":["u"],"sources":["../../../src/agent/child-agent-factory.ts"],"sourcesContent":["import { Agent, type AgentEvent, type ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../config/schema.js';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport { resolveProviderApiKeySync } from '../auth/sync-provider-auth.js';\nimport { getApiKeySync } from '../providers/index.js';\nimport { createExtensionAwareStreamFn } from '../providers/extension-stream-bridge.js';\nimport { createLogger } from '../utils/logger.js';\n\nimport { extractTextContent } from './context/workspace.js';\nimport {\n  resolveAgentTurnTimeoutMs,\n  runAgentTurnWithTimeout,\n} from './orchestration/run-agent-turn-with-timeout.js';\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolExecutorConfig } from './tools/executor.js';\n// `AgentToolsFactory` is NOT imported here on purpose — `tools/factory.js`\n// constructs the delegate tool, which would create a factory ↔ delegate-tool\n// ↔ child-agent-factory cycle. Instead, the caller supplies a\n// `buildChildTools()` callback that produces the already-constructed child\n// tool set (see `DelegateChildHandleOptions.buildChildTools`).\n\nconst log = createLogger('delegate-child');\n\nexport function buildChildSystemPrompt(goal: string, context?: string, workspace?: string): string {\n  const parts = [\n    'You are a focused sub-agent working on a specific delegated task.',\n    '',\n    `YOUR TASK:\\n${goal}`,\n  ];\n\n  if (context?.trim()) {\n    parts.push(`\\nCONTEXT:\\n${context.trim()}`);\n  }\n\n  if (workspace?.trim()) {\n    parts.push(`\\nWORKSPACE: ${workspace.trim()}`);\n  }\n\n  parts.push(\n    '\\nComplete this task using only the tools available to you. ' +\n      'When finished, reply with a clear, concise summary covering:\\n' +\n      '- What you did\\n' +\n      '- What you found or accomplished\\n' +\n      '- Files created or modified\\n' +\n      '- Issues encountered\\n\\n' +\n      'Your final reply is returned to the parent agent — be thorough but compact.',\n  );\n\n  return parts.join('\\n');\n}\n\nexport interface BuildChildToolsOptions {\n  workspace: string;\n  bus: MessageBus;\n  model: Model<Api>;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n}\n\nexport interface DelegateChildProgressHooks {\n  mode: 'steps' | 'full';\n  onProgress: (event: {\n    type: 'tool_start' | 'tool_end' | 'iteration' | 'text_delta' | 'thinking_delta';\n    toolCallId?: string;\n    toolName?: string;\n    args?: Record<string, unknown>;\n    isError?: boolean;\n    count?: number;\n    max?: number;\n    delta?: string;\n  }) => void;\n}\n\nexport interface DelegateChildHandleOptions {\n  workspace: string;\n  goal: string;\n  context?: string;\n  allowedToolNames: string[];\n  maxIterations: number;\n  model: Model<Api>;\n  bus: MessageBus;\n  getConfig: () => Config | undefined;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /**\n   * Construct the child agent's tool set. Injected by the caller (delegate-tool)\n   * so this module does not import `tools/factory.js` (which would form a\n   * factory ↔ delegate-tool ↔ child-agent-factory cycle).\n   */\n  buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];\n  /** Optional live progress for workflow subagents. */\n  progressHooks?: DelegateChildProgressHooks;\n}\n\nexport interface DelegateChildRunResult {\n  summary: string;\n  toolIterations: number;\n}\n\nexport interface DelegateChildHandle {\n  run(): Promise<DelegateChildRunResult>;\n  abort(): void;\n}\n\n/**\n * Build an isolated tool factory (no extensions, no session memory hooks) and a child {@link Agent}.\n */\nexport function createDelegateChildHandle(options: DelegateChildHandleOptions): DelegateChildHandle {\n  const allTools = options.buildChildTools({\n    workspace: options.workspace,\n    bus: options.bus,\n    model: options.model,\n    getConfig: options.getConfig,\n    toolExecutorConfig: options.toolExecutorConfig,\n  });\n\n  const allow = new Set(options.allowedToolNames);\n  const filteredTools = allTools.filter((t) => allow.has(t.name));\n\n  if (filteredTools.length === 0) {\n    return {\n      async run() {\n        return {\n          summary: 'No tools matched the allowlist after factory registration.',\n          toolIterations: 0,\n        };\n      },\n      abort() {},\n    };\n  }\n\n  let toolIterations = 0;\n  let aborted = false;\n  const progress = options.progressHooks;\n\n  const agent = new Agent({\n    initialState: {\n      systemPrompt: buildChildSystemPrompt(options.goal, options.context, options.workspace),\n      model: options.model,\n      thinkingLevel: 'low' as ThinkingLevel,\n      tools: filteredTools,\n      messages: [],\n    },\n    streamFn: createExtensionAwareStreamFn(),\n    getApiKey: (provider: string) =>\n      resolveProviderApiKeySync(provider) ?? getApiKeySync(provider) ?? '',\n    beforeToolCall: async ({ toolCall, args }) => {\n      if (aborted) {\n        return { block: true, reason: 'Sub-agent aborted.' };\n      }\n      if (toolIterations >= options.maxIterations) {\n        return {\n          block: true,\n          reason: `Sub-agent reached max tool iterations (${options.maxIterations}).`,\n        };\n      }\n      progress?.onProgress({\n        type: 'tool_start',\n        toolCallId: toolCall.id,\n        toolName: toolCall.name,\n        args: (args ?? {}) as Record<string, unknown>,\n      });\n      return undefined;\n    },\n    afterToolCall: async ({ toolCall, isError }) => {\n      toolIterations += 1;\n      progress?.onProgress({\n        type: 'iteration',\n        count: toolIterations,\n        max: options.maxIterations,\n      });\n      progress?.onProgress({\n        type: 'tool_end',\n        toolCallId: toolCall.id,\n        toolName: toolCall.name,\n        isError: Boolean(isError),\n      });\n      return undefined;\n    },\n  });\n\n  const userText = options.context?.trim()\n    ? `${options.goal}\\n\\nAdditional context:\\n${options.context.trim()}`\n    : options.goal;\n\n  return {\n    async run(): Promise<DelegateChildRunResult> {\n      toolIterations = 0;\n      aborted = false;\n      const unsub =\n        progress?.mode === 'full'\n          ? agent.subscribe((ev: AgentEvent) => {\n              if (ev.type === 'message_update') {\n                const u = ev as Extract<AgentEvent, { type: 'message_update' }>;\n                const delta = u.assistantMessageEvent;\n                if (delta?.type === 'text_delta' && typeof delta.delta === 'string' && delta.delta) {\n                  progress.onProgress({ type: 'text_delta', delta: delta.delta });\n                }\n                if (delta?.type === 'thinking_delta' && typeof delta.delta === 'string' && delta.delta) {\n                  progress.onProgress({ type: 'thinking_delta', delta: delta.delta });\n                }\n              }\n            })\n          : undefined;\n      try {\n        await runAgentTurnWithTimeout(\n          agent,\n          async () => {\n            await agent.prompt(userText);\n            await agent.waitForIdle();\n          },\n          resolveAgentTurnTimeoutMs(options.getConfig()),\n        );\n\n        const messages = agent.state.messages;\n        for (let i = messages.length - 1; i >= 0; i--) {\n          const msg = messages[i];\n          if (msg.role === 'assistant') {\n            const content: unknown = msg.content;\n            if (typeof content === 'string') {\n              return { summary: content.trim() || '(empty assistant message)', toolIterations };\n            }\n            if (Array.isArray(content)) {\n              const text = extractTextContent(content as Array<{ type: string; text?: string }>);\n              return {\n                summary: text.trim() || '(empty assistant message)',\n                toolIterations,\n              };\n            }\n          }\n        }\n\n        return {\n          summary: aborted\n            ? 'Sub-agent was aborted before producing a result.'\n            : 'Sub-agent completed but produced no assistant text.',\n          toolIterations,\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        const m = options.model as { model?: string; id?: string };\n        const modelId = m?.model ?? m?.id;\n        log.warn(\n          {\n            err: e,\n            errorMessage: msg,\n            goalPreview: options.goal.slice(0, 120),\n            maxIterations: options.maxIterations,\n            allowedToolCount: options.allowedToolNames.length,\n            modelId,\n          },\n          `Delegate child run failed: ${msg}`,\n        );\n        return {\n          summary: `Sub-agent error: ${msg}`,\n          toolIterations,\n        };\n      } finally {\n        unsub?.();\n      }\n    },\n\n    abort(): void {\n      aborted = true;\n      agent.abort();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/agent/client-error-format.d.ts

@@ -0,0 +1,20 @@
+export type AgentRunErrorKind = 'provider_setup_required' | 'provider_auth_invalid' | 'rate_limit' | 'timeout' | 'billing' | 'unknown';
+export type AgentRunErrorPayload = {
+    kind: AgentRunErrorKind;
+    code: string;
+    provider?: string;
+    modelRef?: string;
+    deepLink?: string;
+    message: string;
+};
+/**
+ * Map a raw agent/LLM error into a structured JSON payload the web UI can render
+ * as an actionable, i18n-friendly card. Falls back to plain `Error: <raw>` when
+ * the input is already a legacy gateway string.
+ */
+export declare function formatAgentRunErrorForClient(rawError: string, context?: {
+    provider?: string;
+    modelRef?: string;
+}): string;
+/** Human-readable text for TUI/CLI when SSE carries structured JSON. */
+export declare function formatAgentRunErrorForDisplay(content: string): string;

package/dist/src/agent/client-error-format.js

@@ -0,0 +1,97 @@
+import { classifyFailoverReason, isAuthErrorMessage } from "./fallback/reason.js";
+//#region src/agent/client-error-format.ts
+const API_KEY_MISSING_RE = /^No API key found for (\S+)/i;
+function reasonToKind(reason) {
+	switch (reason) {
+		case "auth": return "provider_auth_invalid";
+		case "rate_limit": return "rate_limit";
+		case "timeout": return "timeout";
+		case "billing": return "billing";
+		default: return "unknown";
+	}
+}
+function reasonToCode(reason) {
+	switch (reason) {
+		case "auth": return "provider_auth_invalid";
+		case "rate_limit": return "rate_limit";
+		case "timeout": return "timeout";
+		case "billing": return "billing";
+		case "format": return "format";
+		default: return "unknown";
+	}
+}
+function providerDeepLink(kind) {
+	if (kind === "provider_setup_required" || kind === "provider_auth_invalid") return "/settings/credentials";
+}
+function tryParseStructuredPayload(text) {
+	if (!text.startsWith("{")) return null;
+	try {
+		const parsed = JSON.parse(text);
+		if (typeof parsed.kind !== "string" || typeof parsed.message !== "string") return null;
+		return {
+			kind: parsed.kind,
+			code: typeof parsed.code === "string" ? parsed.code : parsed.kind,
+			provider: typeof parsed.provider === "string" ? parsed.provider : void 0,
+			modelRef: typeof parsed.modelRef === "string" ? parsed.modelRef : void 0,
+			deepLink: typeof parsed.deepLink === "string" ? parsed.deepLink : void 0,
+			message: parsed.message
+		};
+	} catch {
+		return null;
+	}
+}
+/**
+* Map a raw agent/LLM error into a structured JSON payload the web UI can render
+* as an actionable, i18n-friendly card. Falls back to plain `Error: <raw>` when
+* the input is already a legacy gateway string.
+*/
+function formatAgentRunErrorForClient(rawError, context) {
+	const trimmed = rawError.trim();
+	if (!trimmed) return JSON.stringify({
+		kind: "unknown",
+		code: "unknown",
+		message: "Assistant turn failed"
+	});
+	const existing = tryParseStructuredPayload(trimmed);
+	if (existing) return JSON.stringify(existing);
+	const missingMatch = API_KEY_MISSING_RE.exec(trimmed);
+	if (missingMatch) {
+		const provider = missingMatch[1].replace(/\.$/, "");
+		return JSON.stringify({
+			kind: "provider_setup_required",
+			code: "provider_setup_required",
+			provider,
+			deepLink: "/settings/credentials",
+			message: trimmed
+		});
+	}
+	const reason = classifyFailoverReason(trimmed);
+	const kind = reasonToKind(reason);
+	const payload = {
+		kind,
+		code: reasonToCode(reason),
+		message: trimmed,
+		...context?.provider ? { provider: context.provider } : {},
+		...context?.modelRef ? { modelRef: context.modelRef } : {}
+	};
+	const deepLink = providerDeepLink(kind);
+	if (deepLink) payload.deepLink = deepLink;
+	if (kind === "unknown" && isAuthErrorMessage(trimmed)) {
+		payload.kind = "provider_auth_invalid";
+		payload.code = "provider_auth_invalid";
+		payload.deepLink = "/settings/credentials";
+	}
+	return JSON.stringify(payload);
+}
+/** Human-readable text for TUI/CLI when SSE carries structured JSON. */
+function formatAgentRunErrorForDisplay(content) {
+	const trimmed = content.trim();
+	if (trimmed.startsWith("Error: ")) return trimmed.slice(7);
+	const parsed = tryParseStructuredPayload(trimmed);
+	if (parsed?.message) return parsed.message;
+	return trimmed;
+}
+//#endregion
+export { formatAgentRunErrorForClient, formatAgentRunErrorForDisplay };
+
+//# sourceMappingURL=client-error-format.js.map

package/dist/src/agent/client-error-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-error-format.js","names":[],"sources":["../../../src/agent/client-error-format.ts"],"sourcesContent":["import {\n  classifyFailoverReason,\n  isAuthErrorMessage,\n  type FailoverReason,\n} from './fallback/reason.js';\n\nexport type AgentRunErrorKind =\n  | 'provider_setup_required'\n  | 'provider_auth_invalid'\n  | 'rate_limit'\n  | 'timeout'\n  | 'billing'\n  | 'unknown';\n\nexport type AgentRunErrorPayload = {\n  kind: AgentRunErrorKind;\n  code: string;\n  provider?: string;\n  modelRef?: string;\n  deepLink?: string;\n  message: string;\n};\n\nconst API_KEY_MISSING_RE = /^No API key found for (\\S+)/i;\n\nfunction reasonToKind(reason: FailoverReason): AgentRunErrorKind {\n  switch (reason) {\n    case 'auth':\n      return 'provider_auth_invalid';\n    case 'rate_limit':\n      return 'rate_limit';\n    case 'timeout':\n      return 'timeout';\n    case 'billing':\n      return 'billing';\n    default:\n      return 'unknown';\n  }\n}\n\nfunction reasonToCode(reason: FailoverReason): string {\n  switch (reason) {\n    case 'auth':\n      return 'provider_auth_invalid';\n    case 'rate_limit':\n      return 'rate_limit';\n    case 'timeout':\n      return 'timeout';\n    case 'billing':\n      return 'billing';\n    case 'format':\n      return 'format';\n    default:\n      return 'unknown';\n  }\n}\n\nfunction providerDeepLink(kind: AgentRunErrorKind): string | undefined {\n  if (kind === 'provider_setup_required' || kind === 'provider_auth_invalid') {\n    return '/settings/credentials';\n  }\n  return undefined;\n}\n\nfunction tryParseStructuredPayload(text: string): AgentRunErrorPayload | null {\n  if (!text.startsWith('{')) return null;\n  try {\n    const parsed = JSON.parse(text) as Record<string, unknown>;\n    if (typeof parsed.kind !== 'string' || typeof parsed.message !== 'string') return null;\n    return {\n      kind: parsed.kind as AgentRunErrorKind,\n      code: typeof parsed.code === 'string' ? parsed.code : parsed.kind,\n      provider: typeof parsed.provider === 'string' ? parsed.provider : undefined,\n      modelRef: typeof parsed.modelRef === 'string' ? parsed.modelRef : undefined,\n      deepLink: typeof parsed.deepLink === 'string' ? parsed.deepLink : undefined,\n      message: parsed.message,\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Map a raw agent/LLM error into a structured JSON payload the web UI can render\n * as an actionable, i18n-friendly card. Falls back to plain `Error: <raw>` when\n * the input is already a legacy gateway string.\n */\nexport function formatAgentRunErrorForClient(\n  rawError: string,\n  context?: { provider?: string; modelRef?: string },\n): string {\n  const trimmed = rawError.trim();\n  if (!trimmed) {\n    return JSON.stringify({\n      kind: 'unknown',\n      code: 'unknown',\n      message: 'Assistant turn failed',\n    } satisfies AgentRunErrorPayload);\n  }\n\n  const existing = tryParseStructuredPayload(trimmed);\n  if (existing) return JSON.stringify(existing);\n\n  const missingMatch = API_KEY_MISSING_RE.exec(trimmed);\n  if (missingMatch) {\n    const provider = missingMatch[1].replace(/\\.$/, '');\n    return JSON.stringify({\n      kind: 'provider_setup_required',\n      code: 'provider_setup_required',\n      provider,\n      deepLink: '/settings/credentials',\n      message: trimmed,\n    } satisfies AgentRunErrorPayload);\n  }\n\n  const reason = classifyFailoverReason(trimmed);\n  const kind = reasonToKind(reason);\n  const payload: AgentRunErrorPayload = {\n    kind,\n    code: reasonToCode(reason),\n    message: trimmed,\n    ...(context?.provider ? { provider: context.provider } : {}),\n    ...(context?.modelRef ? { modelRef: context.modelRef } : {}),\n  };\n\n  const deepLink = providerDeepLink(kind);\n  if (deepLink) payload.deepLink = deepLink;\n\n  // Auth heuristics that classifyFailoverReason may miss (e.g. \"Authentication Fails\")\n  if (kind === 'unknown' && isAuthErrorMessage(trimmed)) {\n    payload.kind = 'provider_auth_invalid';\n    payload.code = 'provider_auth_invalid';\n    payload.deepLink = '/settings/credentials';\n  }\n\n  return JSON.stringify(payload);\n}\n\n/** Human-readable text for TUI/CLI when SSE carries structured JSON. */\nexport function formatAgentRunErrorForDisplay(content: string): string {\n  const trimmed = content.trim();\n  if (trimmed.startsWith('Error: ')) return trimmed.slice('Error: '.length);\n\n  const parsed = tryParseStructuredPayload(trimmed);\n  if (parsed?.message) return parsed.message;\n\n  return trimmed;\n}\n"],"mappings":";;AAuBA,MAAM,qBAAqB;AAE3B,SAAS,aAAa,QAA2C;AAC/D,SAAQ,QAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAS,aAAa,QAAgC;AACpD,SAAQ,QAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAS,iBAAiB,MAA6C;AACrE,KAAI,SAAS,6BAA6B,SAAS,wBACjD,QAAO;;AAKX,SAAS,0BAA0B,MAA2C;AAC5E,KAAI,CAAC,KAAK,WAAW,IAAI,CAAE,QAAO;AAClC,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,MAAI,OAAO,OAAO,SAAS,YAAY,OAAO,OAAO,YAAY,SAAU,QAAO;AAClF,SAAO;GACL,MAAM,OAAO;GACb,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO,OAAO;GAC7D,UAAU,OAAO,OAAO,aAAa,WAAW,OAAO,WAAW,KAAA;GAClE,UAAU,OAAO,OAAO,aAAa,WAAW,OAAO,WAAW,KAAA;GAClE,UAAU,OAAO,OAAO,aAAa,WAAW,OAAO,WAAW,KAAA;GAClE,SAAS,OAAO;GACjB;SACK;AACN,SAAO;;;;;;;;AASX,SAAgB,6BACd,UACA,SACQ;CACR,MAAM,UAAU,SAAS,MAAM;AAC/B,KAAI,CAAC,QACH,QAAO,KAAK,UAAU;EACpB,MAAM;EACN,MAAM;EACN,SAAS;EACV,CAAgC;CAGnC,MAAM,WAAW,0BAA0B,QAAQ;AACnD,KAAI,SAAU,QAAO,KAAK,UAAU,SAAS;CAE7C,MAAM,eAAe,mBAAmB,KAAK,QAAQ;AACrD,KAAI,cAAc;EAChB,MAAM,WAAW,aAAa,GAAG,QAAQ,OAAO,GAAG;AACnD,SAAO,KAAK,UAAU;GACpB,MAAM;GACN,MAAM;GACN;GACA,UAAU;GACV,SAAS;GACV,CAAgC;;CAGnC,MAAM,SAAS,uBAAuB,QAAQ;CAC9C,MAAM,OAAO,aAAa,OAAO;CACjC,MAAM,UAAgC;EACpC;EACA,MAAM,aAAa,OAAO;EAC1B,SAAS;EACT,GAAI,SAAS,WAAW,EAAE,UAAU,QAAQ,UAAU,GAAG,EAAE;EAC3D,GAAI,SAAS,WAAW,EAAE,UAAU,QAAQ,UAAU,GAAG,EAAE;EAC5D;CAED,MAAM,WAAW,iBAAiB,KAAK;AACvC,KAAI,SAAU,SAAQ,WAAW;AAGjC,KAAI,SAAS,aAAa,mBAAmB,QAAQ,EAAE;AACrD,UAAQ,OAAO;AACf,UAAQ,OAAO;AACf,UAAQ,WAAW;;AAGrB,QAAO,KAAK,UAAU,QAAQ;;;AAIhC,SAAgB,8BAA8B,SAAyB;CACrE,MAAM,UAAU,QAAQ,MAAM;AAC9B,KAAI,QAAQ,WAAW,UAAU,CAAE,QAAO,QAAQ,MAAM,EAAiB;CAEzE,MAAM,SAAS,0BAA0B,QAAQ;AACjD,KAAI,QAAQ,QAAS,QAAO,OAAO;AAEnC,QAAO"}

package/dist/src/agent/context/workspace-seed.js

@@ -1,10 +1,10 @@
-import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "../agent-scope.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { DEFAULT_AGENT_ID, init_agent_scope, resolveAgentProfileDir, resolveAgentWorkspaceDir } from "../agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../../config/paths.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "./workspace.js";
-import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 //#region src/agent/context/workspace-seed.ts

package/dist/src/agent/embedded/run-turn.js

@@ -3,7 +3,7 @@ import { init_logger } from "../../utils/logger.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { wrapStreamFnForXopcExtensions } from "./xopc-stream-bridge.js";
 import { acquireEmbeddedSessionRunner, resolveEmbeddedTranscriptInputs } from "./session-runner.js";
-import { isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";
+import { getAssistantTurnErrorMessage, isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";
 import { abortEmbeddedRun, queueEmbeddedSteer, registerEmbeddedRun, unregisterEmbeddedRun } from "./runs.js";
 import { lastAssistantPlainText, subscribeEmbeddedSessionEvents } from "./subscribe-session.js";
 import { detectToolLoops } from "../orchestration/loop-guard.js";
@@ -50,9 +50,27 @@ function requireEmbeddedModel(model, modelRef) {
 function userMessageToPromptText(message) {
 	const content = message.content;
 	if (typeof content === "string") return content;
-	if (Array.isArray(content)) return content.filter((b) => !!b && typeof b === "object" && b.type === "text").map((b) => b.text).join("");
+	if (Array.isArray(content)) return content.filter((block) => {
+		return !!block && typeof block === "object" && block.type === "text";
+	}).map((block) => block.text).join("");
 	return "";
 }
+function userMessageToPromptImages(message) {
+	const content = message.content;
+	if (!Array.isArray(content)) return [];
+	const images = [];
+	for (const block of content) {
+		if (!block || typeof block !== "object") continue;
+		const typedBlock = block;
+		if (typedBlock.type !== "image" || typeof typedBlock.data !== "string" || typedBlock.data.length === 0) continue;
+		images.push({
+			type: "image",
+			data: typedBlock.data,
+			mimeType: typeof typedBlock.mimeType === "string" ? typedBlock.mimeType : "image/png"
+		});
+	}
+	return images;
+}
 async function runXopcEmbeddedTurn(params) {
 	const { sessionKey, runId, userMessage, model, tools, systemPrompt, thinkingLevel, workspaceDir, sessionStore, onEvent } = params;
 	const timeoutMs = params.timeoutMs || resolveAgentTurnTimeoutMs();
@@ -134,7 +152,8 @@ async function runXopcEmbeddedTurn(params) {
 		try {
 			await runAgentTurnWithTimeout(session.agent, async () => {
 				const text = userMessageToPromptText(userMessage);
-				await session.prompt(text, params.images?.length ? { images: params.images } : void 0);
+				const images = [...params.images ?? [], ...userMessageToPromptImages(userMessage)];
+				await session.prompt(text, images.length > 0 ? { images } : void 0);
 				await session.agent.waitForIdle();
 				await maybeRetryTurnAfterTransientLlmFailure(session.agent, {
 					sessionKey,
@@ -147,7 +166,7 @@ async function runXopcEmbeddedTurn(params) {
 			};
 			if (isAssistantTurnFailed(session.agent)) return {
 				ok: false,
-				errorMessage: "Assistant turn failed",
+				errorMessage: getAssistantTurnErrorMessage(session.agent) ?? "Assistant turn failed",
 				lastAssistantText: lastAssistantPlainText(session)
 			};
 			return {

package/dist/src/agent/embedded/run-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-turn.js","names":[],"sources":["../../../../src/agent/embedded/run-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\n\nimport { createLogger } from '../../utils/logger.js';\nimport { registerEmbeddedRun, unregisterEmbeddedRun } from './runs.js';\nimport { subscribeEmbeddedSessionEvents, lastAssistantPlainText } from './subscribe-session.js';\nimport type { RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport {\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n  maybeRetryTurnAfterTransientLlmFailure,\n} from '../orchestration/llm-turn-retry.js';\nimport { runAgentTurnWithTimeout, resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { detectToolLoops, type RecentToolCall } from '../orchestration/loop-guard.js';\nimport {\n  acquireEmbeddedSessionRunner,\n  resolveEmbeddedTranscriptInputs,\n} from './session-runner.js';\nimport { wrapStreamFnForXopcExtensions } from './xopc-stream-bridge.js';\n\nconst log = createLogger('EmbeddedRun');\nconst LOG_PREVIEW_MAX_CHARS = 300;\n\nfunction truncateForLog(value: string, maxChars = LOG_PREVIEW_MAX_CHARS): string {\n  return value.length > maxChars ? `${value.slice(0, maxChars)}…` : value;\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  return content\n    .filter((block): block is { type: string; text: string } => {\n      return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n    })\n    .map((block) => block.text)\n    .join('');\n}\n\nfunction extractRecentToolCalls(messages: readonly { role?: string; content?: unknown }[]): RecentToolCall[] {\n  const calls: RecentToolCall[] = [];\n  for (const message of messages) {\n    if (message.role !== 'assistant' || !Array.isArray(message.content)) continue;\n    for (const block of message.content) {\n      if (block && typeof block === 'object' && (block as { type?: string }).type === 'toolCall') {\n        const toolCall = block as { name: string; arguments: unknown };\n        calls.push({ name: toolCall.name, params: toolCall.arguments });\n      }\n    }\n  }\n  return calls;\n}\n\nfunction getLastUserMessagePreview(messages: readonly { role?: string; content?: unknown }[]): string | undefined {\n  for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex--) {\n    const message = messages[messageIndex];\n    if (message?.role !== 'user') {\n      continue;\n    }\n    const text = extractTextFromContent(message.content).trim();\n    return text ? truncateForLog(text) : undefined;\n  }\n  return undefined;\n}\n\nfunction requireEmbeddedModel(model: Model<Api> | undefined, modelRef: string): Model<Api> {\n  if (!model?.id || !model?.provider) {\n    throw new Error(`Invalid model for embedded run: ${modelRef}`);\n  }\n  return model;\n}\n\nfunction userMessageToPromptText(message: AgentMessage): string {\n  const content = (message as { content?: unknown }).content;\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (Array.isArray(content)) {\n    return content\n      .filter((b): b is { type: 'text'; text: string } => !!b && typeof b === 'object' && (b as { type?: string }).type === 'text')\n      .map((b) => b.text)\n      .join('');\n  }\n  return '';\n}\n\nexport async function runXopcEmbeddedTurn(params: RunXopcEmbeddedTurnParams): Promise<RunXopcEmbeddedTurnResult> {\n  const {\n    sessionKey,\n    runId,\n    userMessage,\n    model,\n    tools,\n    systemPrompt,\n    thinkingLevel,\n    workspaceDir,\n    sessionStore,\n    onEvent,\n  } = params;\n\n  const timeoutMs = params.timeoutMs || resolveAgentTurnTimeoutMs();\n  const resolvedModel = requireEmbeddedModel(model, params.modelRef);\n  const transcript = await resolveEmbeddedTranscriptInputs(sessionStore, sessionKey);\n\n  let runner: Awaited<ReturnType<typeof acquireEmbeddedSessionRunner>> | undefined;\n  let unsubscribe: (() => void) | undefined;\n\n  try {\n    runner = await acquireEmbeddedSessionRunner({\n      sessionKey,\n      sessionId: transcript.sessionId,\n      sessionFile: transcript.sessionFile,\n      sessionsDir: transcript.sessionsDir,\n      hadSessionFile: transcript.hadSessionFile,\n      workspaceDir,\n      model: resolvedModel,\n      modelRef: params.modelRef,\n      tools,\n      systemPrompt,\n      thinkingLevel: thinkingLevel ?? 'medium',\n    });\n\n    const { session, reused } = runner;\n\n    const streamFnWithXopcExtensions = wrapStreamFnForXopcExtensions(session.agent.streamFn);\n    const loggingStreamFn: typeof session.agent.streamFn = (streamModel, context, options) => {\n      const recentToolCalls = extractRecentToolCalls(context.messages);\n      const loopGuard = detectToolLoops(recentToolCalls);\n\n      let effectiveContext = context;\n      if (loopGuard.injection || loopGuard.hiddenTools.size > 0) {\n        const messages = loopGuard.injection\n          ? [...context.messages, { role: 'user' as const, content: loopGuard.injection, timestamp: Date.now() }]\n          : context.messages;\n\n        const contextTools = loopGuard.hiddenTools.size > 0 && context.tools\n          ? context.tools.filter((t) => !loopGuard.hiddenTools.has(t.name))\n          : context.tools;\n\n        effectiveContext = { ...context, messages, tools: contextTools };\n      }\n\n      log.debug(\n        {\n          sessionKey,\n          runId,\n          reusedRunner: reused,\n          modelRef: `${streamModel.provider}/${streamModel.id}`,\n          systemPromptLength: effectiveContext.systemPrompt?.length ?? 0,\n          messageCount: effectiveContext.messages.length,\n          toolCount: effectiveContext.tools?.length ?? 0,\n          lastUserMessagePreview: getLastUserMessagePreview(effectiveContext.messages),\n          loopWarningInjected: !!loopGuard.injection,\n          hiddenToolCount: loopGuard.hiddenTools.size,\n        },\n        'Sending messages to AI',\n      );\n      return streamFnWithXopcExtensions(streamModel, effectiveContext, options);\n    };\n    session.agent.streamFn = loggingStreamFn;\n\n    if (onEvent) {\n      unsubscribe = subscribeEmbeddedSessionEvents(session, onEvent);\n    }\n\n    const handle = {\n      sessionKey,\n      sessionId: transcript.sessionId,\n      runId,\n      session,\n      abort: async () => {\n        await session.abort();\n      },\n    };\n    registerEmbeddedRun(handle);\n\n    const abortListener = () => {\n      void session.abort();\n    };\n    if (params.abortSignal) {\n      if (params.abortSignal.aborted) {\n        await session.abort();\n        return { ok: false, errorMessage: 'aborted' };\n      }\n      params.abortSignal.addEventListener('abort', abortListener, { once: true });\n    }\n\n    try {\n      await runAgentTurnWithTimeout(\n        session.agent,\n        async () => {\n          const text = userMessageToPromptText(userMessage);\n          await session.prompt(text, params.images?.length ? { images: params.images } : undefined);\n          await session.agent.waitForIdle();\n          await maybeRetryTurnAfterTransientLlmFailure(session.agent, { sessionKey, log });\n        },\n        timeoutMs,\n      );\n\n      if (isAssistantTurnAborted(session.agent)) {\n        return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n      }\n      if (isAssistantTurnFailed(session.agent)) {\n        return {\n          ok: false,\n          errorMessage: 'Assistant turn failed',\n          lastAssistantText: lastAssistantPlainText(session),\n        };\n      }\n\n      return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n    } finally {\n      params.abortSignal?.removeEventListener('abort', abortListener);\n      unregisterEmbeddedRun(handle);\n    }\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    log.error({ err, sessionKey, runId }, `Embedded run failed: ${em}`);\n    onEvent?.({ type: 'error', content: em });\n    return { ok: false, errorMessage: em };\n  } finally {\n    unsubscribe?.();\n    try {\n      runner?.piSm.flushPendingToolResults?.();\n    } catch {\n      /* ignore */\n    }\n    runner?.release();\n  }\n}\n\nexport { abortEmbeddedRun, queueEmbeddedSteer } from './runs.js';\n"],"mappings":"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"}
+{"version":3,"file":"run-turn.js","names":[],"sources":["../../../../src/agent/embedded/run-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { ImageContent, Model, Api } from '@earendil-works/pi-ai';\n\nimport { createLogger } from '../../utils/logger.js';\nimport { registerEmbeddedRun, unregisterEmbeddedRun } from './runs.js';\nimport { subscribeEmbeddedSessionEvents, lastAssistantPlainText } from './subscribe-session.js';\nimport type { RunXopcEmbeddedTurnParams, RunXopcEmbeddedTurnResult } from './types.js';\nimport {\n  getAssistantTurnErrorMessage,\n  isAssistantTurnAborted,\n  isAssistantTurnFailed,\n  maybeRetryTurnAfterTransientLlmFailure,\n} from '../orchestration/llm-turn-retry.js';\nimport { runAgentTurnWithTimeout, resolveAgentTurnTimeoutMs } from '../orchestration/run-agent-turn-with-timeout.js';\nimport { detectToolLoops, type RecentToolCall } from '../orchestration/loop-guard.js';\nimport {\n  acquireEmbeddedSessionRunner,\n  resolveEmbeddedTranscriptInputs,\n} from './session-runner.js';\nimport { wrapStreamFnForXopcExtensions } from './xopc-stream-bridge.js';\n\nconst log = createLogger('EmbeddedRun');\nconst LOG_PREVIEW_MAX_CHARS = 300;\n\nfunction truncateForLog(value: string, maxChars = LOG_PREVIEW_MAX_CHARS): string {\n  return value.length > maxChars ? `${value.slice(0, maxChars)}…` : value;\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  return content\n    .filter((block): block is { type: string; text: string } => {\n      return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n    })\n    .map((block) => block.text)\n    .join('');\n}\n\nfunction extractRecentToolCalls(messages: readonly { role?: string; content?: unknown }[]): RecentToolCall[] {\n  const calls: RecentToolCall[] = [];\n  for (const message of messages) {\n    if (message.role !== 'assistant' || !Array.isArray(message.content)) continue;\n    for (const block of message.content) {\n      if (block && typeof block === 'object' && (block as { type?: string }).type === 'toolCall') {\n        const toolCall = block as { name: string; arguments: unknown };\n        calls.push({ name: toolCall.name, params: toolCall.arguments });\n      }\n    }\n  }\n  return calls;\n}\n\nfunction getLastUserMessagePreview(messages: readonly { role?: string; content?: unknown }[]): string | undefined {\n  for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex--) {\n    const message = messages[messageIndex];\n    if (message?.role !== 'user') {\n      continue;\n    }\n    const text = extractTextFromContent(message.content).trim();\n    return text ? truncateForLog(text) : undefined;\n  }\n  return undefined;\n}\n\nfunction requireEmbeddedModel(model: Model<Api> | undefined, modelRef: string): Model<Api> {\n  if (!model?.id || !model?.provider) {\n    throw new Error(`Invalid model for embedded run: ${modelRef}`);\n  }\n  return model;\n}\n\nfunction userMessageToPromptText(message: AgentMessage): string {\n  const content = (message as { content?: unknown }).content;\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (Array.isArray(content)) {\n    return content\n      .filter((block): block is { type: 'text'; text: string } => {\n        return !!block && typeof block === 'object' && (block as { type?: string }).type === 'text';\n      })\n      .map((block) => block.text)\n      .join('');\n  }\n  return '';\n}\n\nfunction userMessageToPromptImages(message: AgentMessage): ImageContent[] {\n  const content = (message as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return [];\n  }\n\n  const images: ImageContent[] = [];\n  for (const block of content) {\n    if (!block || typeof block !== 'object') {\n      continue;\n    }\n    const typedBlock = block as { type?: string; data?: unknown; mimeType?: unknown };\n    if (typedBlock.type !== 'image' || typeof typedBlock.data !== 'string' || typedBlock.data.length === 0) {\n      continue;\n    }\n    images.push({\n      type: 'image',\n      data: typedBlock.data,\n      mimeType: typeof typedBlock.mimeType === 'string' ? typedBlock.mimeType : 'image/png',\n    });\n  }\n  return images;\n}\n\nexport async function runXopcEmbeddedTurn(params: RunXopcEmbeddedTurnParams): Promise<RunXopcEmbeddedTurnResult> {\n  const {\n    sessionKey,\n    runId,\n    userMessage,\n    model,\n    tools,\n    systemPrompt,\n    thinkingLevel,\n    workspaceDir,\n    sessionStore,\n    onEvent,\n  } = params;\n\n  const timeoutMs = params.timeoutMs || resolveAgentTurnTimeoutMs();\n  const resolvedModel = requireEmbeddedModel(model, params.modelRef);\n  const transcript = await resolveEmbeddedTranscriptInputs(sessionStore, sessionKey);\n\n  let runner: Awaited<ReturnType<typeof acquireEmbeddedSessionRunner>> | undefined;\n  let unsubscribe: (() => void) | undefined;\n\n  try {\n    runner = await acquireEmbeddedSessionRunner({\n      sessionKey,\n      sessionId: transcript.sessionId,\n      sessionFile: transcript.sessionFile,\n      sessionsDir: transcript.sessionsDir,\n      hadSessionFile: transcript.hadSessionFile,\n      workspaceDir,\n      model: resolvedModel,\n      modelRef: params.modelRef,\n      tools,\n      systemPrompt,\n      thinkingLevel: thinkingLevel ?? 'medium',\n    });\n\n    const { session, reused } = runner;\n\n    const streamFnWithXopcExtensions = wrapStreamFnForXopcExtensions(session.agent.streamFn);\n    const loggingStreamFn: typeof session.agent.streamFn = (streamModel, context, options) => {\n      const recentToolCalls = extractRecentToolCalls(context.messages);\n      const loopGuard = detectToolLoops(recentToolCalls);\n\n      let effectiveContext = context;\n      if (loopGuard.injection || loopGuard.hiddenTools.size > 0) {\n        const messages = loopGuard.injection\n          ? [...context.messages, { role: 'user' as const, content: loopGuard.injection, timestamp: Date.now() }]\n          : context.messages;\n\n        const contextTools = loopGuard.hiddenTools.size > 0 && context.tools\n          ? context.tools.filter((t) => !loopGuard.hiddenTools.has(t.name))\n          : context.tools;\n\n        effectiveContext = { ...context, messages, tools: contextTools };\n      }\n\n      log.debug(\n        {\n          sessionKey,\n          runId,\n          reusedRunner: reused,\n          modelRef: `${streamModel.provider}/${streamModel.id}`,\n          systemPromptLength: effectiveContext.systemPrompt?.length ?? 0,\n          messageCount: effectiveContext.messages.length,\n          toolCount: effectiveContext.tools?.length ?? 0,\n          lastUserMessagePreview: getLastUserMessagePreview(effectiveContext.messages),\n          loopWarningInjected: !!loopGuard.injection,\n          hiddenToolCount: loopGuard.hiddenTools.size,\n        },\n        'Sending messages to AI',\n      );\n      return streamFnWithXopcExtensions(streamModel, effectiveContext, options);\n    };\n    session.agent.streamFn = loggingStreamFn;\n\n    if (onEvent) {\n      unsubscribe = subscribeEmbeddedSessionEvents(session, onEvent);\n    }\n\n    const handle = {\n      sessionKey,\n      sessionId: transcript.sessionId,\n      runId,\n      session,\n      abort: async () => {\n        await session.abort();\n      },\n    };\n    registerEmbeddedRun(handle);\n\n    const abortListener = () => {\n      void session.abort();\n    };\n    if (params.abortSignal) {\n      if (params.abortSignal.aborted) {\n        await session.abort();\n        return { ok: false, errorMessage: 'aborted' };\n      }\n      params.abortSignal.addEventListener('abort', abortListener, { once: true });\n    }\n\n    try {\n      await runAgentTurnWithTimeout(\n        session.agent,\n        async () => {\n          const text = userMessageToPromptText(userMessage);\n          const images = [...(params.images ?? []), ...userMessageToPromptImages(userMessage)];\n          await session.prompt(text, images.length > 0 ? { images } : undefined);\n          await session.agent.waitForIdle();\n          await maybeRetryTurnAfterTransientLlmFailure(session.agent, { sessionKey, log });\n        },\n        timeoutMs,\n      );\n\n      if (isAssistantTurnAborted(session.agent)) {\n        return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n      }\n      if (isAssistantTurnFailed(session.agent)) {\n        return {\n          ok: false,\n          errorMessage: getAssistantTurnErrorMessage(session.agent) ?? 'Assistant turn failed',\n          lastAssistantText: lastAssistantPlainText(session),\n        };\n      }\n\n      return { ok: true, lastAssistantText: lastAssistantPlainText(session) };\n    } finally {\n      params.abortSignal?.removeEventListener('abort', abortListener);\n      unregisterEmbeddedRun(handle);\n    }\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    log.error({ err, sessionKey, runId }, `Embedded run failed: ${em}`);\n    onEvent?.({ type: 'error', content: em });\n    return { ok: false, errorMessage: em };\n  } finally {\n    unsubscribe?.();\n    try {\n      runner?.piSm.flushPendingToolResults?.();\n    } catch {\n      /* ignore */\n    }\n    runner?.release();\n  }\n}\n\nexport { abortEmbeddedRun, queueEmbeddedSteer } from './runs.js';\n"],"mappings":"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"}

package/dist/src/agent/embedded/session-tool-result-guard.js

@@ -1,4 +1,4 @@
-import { normalizeOptionalString } from "../../utils/string-coerce.js";
+import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
 import { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
 import { boundedJsonUtf8Bytes, firstEnumerableOwnKeys, jsonUtf8BytesOrInfinity } from "../../infra/json-utf8-bytes.js";
 import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
@@ -6,6 +6,7 @@ import { resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool
 import { extractToolCallsFromAssistant, extractToolResultId } from "../transcript/tool-call-id.js";
 import { makeMissingToolResult, sanitizeToolCallInputs } from "../transcript/session-transcript-repair.js";
 //#region src/agent/embedded/session-tool-result-guard.ts
+init_string_coerce();
 /**
 * Install the guard on a SessionManager and return its control API.
 * Subsequent assistant/toolResult writes by pi-coding-agent flow through the

package/dist/src/agent/embedded/session-tool-result-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-tool-result-guard.js","names":[],"sources":["../../../../src/agent/embedded/session-tool-result-guard.ts"],"sourcesContent":["/**\n * Session tool-result guard — wraps a pi `SessionManager.appendMessage` to:\n *   1. cap oversized tool-result text + details so they cannot blow up the next\n *      LLM request (size + persistence limits).\n *   2. track pending tool-call IDs so missing tool results can be synthesised\n *      (some providers refuse a turn that has an orphan tool_use block).\n *   3. drop assistant `toolCall` blocks whose tool name is not in the allowlist\n *      (these would also trigger provider 400s).\n *   4. broadcast `xopc:transcript-row` updates so the gateway UI can stream them.\n *\n * Previously this module shipped with three sibling files\n * (`session-tool-result-state.ts`, `session-raw-append-message.ts`,\n * `session-tool-result-guard-wrapper.ts`). They are now consolidated here as\n * private constructs around the `ToolResultGuard` class. Pi-coding-agent owns\n * the `SessionManager` instance and calls `appendMessage` from inside the\n * runtime, so we still need to monkey-patch that method — but the patched\n * implementation is just `guard.guardedAppend.bind(guard)` and all state lives\n * on the class.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { SessionManager } from '@earendil-works/pi-coding-agent';\n\nimport type { Config } from '../../config/schema.js';\nimport {\n  boundedJsonUtf8Bytes,\n  firstEnumerableOwnKeys,\n  jsonUtf8BytesOrInfinity,\n  type BoundedJsonUtf8Bytes,\n} from '../../infra/json-utf8-bytes.js';\nimport { emitSessionTranscriptUpdate } from '../../session/transcript-events.js';\nimport { normalizeOptionalString } from '../../utils/string-coerce.js';\nimport { formatContextLimitTruncationNotice } from './tool-result-context-guard.js';\nimport {\n  DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS,\n  resolveLiveToolResultMaxChars,\n  truncateToolResultMessage,\n} from './tool-result-truncation.js';\nimport {\n  makeMissingToolResult,\n  sanitizeToolCallInputs,\n} from '../transcript/session-transcript-repair.js';\nimport {\n  extractToolCallsFromAssistant,\n  extractToolResultId,\n} from '../transcript/tool-call-id.js';\n\n// ── Public surface ──────────────────────────────────────────────────────────\n\nexport type BeforeMessageWriteHookEvent = { message: AgentMessage };\nexport type BeforeMessageWriteHookResult =\n  | { block?: boolean; message?: AgentMessage }\n  | undefined;\n\nexport interface ToolResultGuardOptions {\n  /** Optional session key for transcript update broadcasts. */\n  sessionKey?: string;\n  /** Optional transform applied to any message before persistence. */\n  transformMessageForPersistence?: (message: AgentMessage) => AgentMessage;\n  /**\n   * Optional, synchronous transform applied to toolResult messages *before* they are\n   * persisted to the session transcript.\n   */\n  transformToolResultForPersistence?: (\n    message: AgentMessage,\n    meta: { toolCallId?: string; toolName?: string; isSynthetic?: boolean },\n  ) => AgentMessage;\n  /**\n   * Whether to synthesize missing tool results to satisfy strict providers.\n   * Defaults to true.\n   */\n  allowSyntheticToolResults?: boolean;\n  missingToolResultText?: string;\n  /**\n   * Optional set/list of tool names accepted for assistant toolCall/toolUse blocks.\n   * When set, tool calls with unknown names are dropped before persistence.\n   */\n  allowedToolNames?: Iterable<string>;\n  /**\n   * Synchronous hook invoked before any message is written to the session JSONL.\n   * If the hook returns { block: true }, the message is silently dropped.\n   * If it returns { message }, the modified message is written instead.\n   */\n  beforeMessageWriteHook?: (event: BeforeMessageWriteHookEvent) => BeforeMessageWriteHookResult;\n  maxToolResultChars?: number;\n}\n\nexport interface InstallSessionToolResultGuardResult {\n  flushPendingToolResults: () => void;\n  clearPendingToolResults: () => void;\n  getPendingIds: () => string[];\n}\n\n/** Idempotent wrapper that also adds the helper methods consumers expect. */\nexport type GuardedPiTranscriptManager = SessionManager & {\n  flushPendingToolResults?: () => void;\n  clearPendingToolResults?: () => void;\n};\n\n/**\n * Install the guard on a SessionManager and return its control API.\n * Subsequent assistant/toolResult writes by pi-coding-agent flow through the\n * guard transparently.\n */\nexport function installSessionToolResultGuard(\n  sessionManager: SessionManager,\n  opts: ToolResultGuardOptions = {},\n): InstallSessionToolResultGuardResult {\n  const guard = new ToolResultGuard(sessionManager, opts);\n  guard.attach();\n  return {\n    flushPendingToolResults: () => guard.flushPending(),\n    clearPendingToolResults: () => guard.clearPending(),\n    getPendingIds: () => guard.getPendingIds(),\n  };\n}\n\n/**\n * Convenience wrapper used by the embedded runner pool: install the guard\n * (idempotent), pin the size cap from the model context window, and expose\n * `flushPendingToolResults` / `clearPendingToolResults` directly on the\n * SessionManager instance so callers do not need to keep the install result.\n */\nexport function guardSessionManager(\n  sessionManager: SessionManager,\n  opts?: {\n    agentId?: string;\n    sessionKey?: string;\n    config?: Config;\n    contextWindowTokens?: number;\n    allowSyntheticToolResults?: boolean;\n    missingToolResultText?: string;\n    allowedToolNames?: Iterable<string>;\n  },\n): GuardedPiTranscriptManager {\n  if (typeof (sessionManager as GuardedPiTranscriptManager).flushPendingToolResults === 'function') {\n    return sessionManager as GuardedPiTranscriptManager;\n  }\n\n  const result = installSessionToolResultGuard(sessionManager, {\n    sessionKey: opts?.sessionKey,\n    allowSyntheticToolResults: opts?.allowSyntheticToolResults,\n    missingToolResultText: opts?.missingToolResultText,\n    allowedToolNames: opts?.allowedToolNames,\n    maxToolResultChars:\n      typeof opts?.contextWindowTokens === 'number'\n        ? resolveLiveToolResultMaxChars({\n            contextWindowTokens: opts.contextWindowTokens,\n            cfg: opts?.config,\n            agentId: opts?.agentId,\n          })\n        : undefined,\n  });\n  const tagged = sessionManager as GuardedPiTranscriptManager;\n  tagged.flushPendingToolResults = result.flushPendingToolResults;\n  tagged.clearPendingToolResults = result.clearPendingToolResults;\n  return tagged;\n}\n\n/**\n * Recover the original (un-guarded) appendMessage for a session manager.\n * Useful for callers that need a low-level \"bypass the guard\" write path.\n */\nexport function getRawSessionAppendMessage(\n  sessionManager: SessionManager,\n): SessionManager['appendMessage'] {\n  const stored = (sessionManager as SessionManagerWithRawAppend)[RAW_APPEND_MESSAGE];\n  return stored ?? sessionManager.appendMessage.bind(sessionManager);\n}\n\n// ── Internal: persistence + truncation helpers ──────────────────────────────\n\nfunction resolveMaxToolResultChars(opts: { maxToolResultChars?: number }): number {\n  return Math.max(1, opts.maxToolResultChars ?? DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS);\n}\n\nfunction capToolResultSize(msg: AgentMessage, maxChars: number): AgentMessage {\n  if ((msg as { role?: string }).role !== 'toolResult') {\n    return msg;\n  }\n  return truncateToolResultMessage(msg, maxChars, {\n    suffix: (truncatedChars) => formatContextLimitTruncationNotice(truncatedChars),\n    minKeepChars: 2_000,\n  });\n}\n\n// `details` is runtime/UI metadata, not model-visible tool output. Keep the\n// session JSONL useful for debugging without letting metadata blobs dominate\n// disk, replay repair, transcript broadcasts, or future tooling that reads raw\n// sessions. Model-visible text belongs in tool result `content`.\nconst MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES = 8_192;\nconst MAX_PERSISTED_DETAIL_STRING_CHARS = 2_000;\nconst MAX_PERSISTED_DETAIL_SESSION_COUNT = 10;\nconst MAX_PERSISTED_DETAIL_FALLBACK_STRING_CHARS = 200;\n\nfunction originalDetailsSizeFields(size: BoundedJsonUtf8Bytes): Record<string, number> {\n  return size.complete\n    ? { originalDetailsBytes: size.bytes }\n    : { originalDetailsBytesAtLeast: size.bytes };\n}\n\nfunction truncatePersistedDetailString(\n  value: string,\n  maxChars = MAX_PERSISTED_DETAIL_STRING_CHARS,\n): string {\n  if (value.length <= maxChars) {\n    return value;\n  }\n  return `${value.slice(0, maxChars)}\\n\\n[xopc persisted detail truncated: ${\n    value.length - maxChars\n  } chars omitted]`;\n}\n\nfunction sanitizePersistedSessionDetail(value: unknown): unknown {\n  if (!value || typeof value !== 'object') {\n    return value;\n  }\n  const src = value as Record<string, unknown>;\n  const out: Record<string, unknown> = {};\n  for (const key of [\n    'sessionId',\n    'status',\n    'pid',\n    'startedAt',\n    'endedAt',\n    'runtimeMs',\n    'cwd',\n    'name',\n    'truncated',\n    'exitCode',\n    'exitSignal',\n  ]) {\n    const field = src[key];\n    if (field !== undefined) {\n      out[key] = typeof field === 'string' ? truncatePersistedDetailString(field, 500) : field;\n    }\n  }\n  if (typeof src.command === 'string') {\n    out.command = truncatePersistedDetailString(src.command, 500);\n  }\n  return out;\n}\n\nfunction buildPersistedDetailsFallback(\n  src: Record<string, unknown> | undefined,\n  originalSize: BoundedJsonUtf8Bytes,\n  sanitizedBytes?: number,\n): Record<string, unknown> {\n  const fallback: Record<string, unknown> = {\n    persistedDetailsTruncated: true,\n    finalDetailsTruncated: true,\n    ...originalDetailsSizeFields(originalSize),\n  };\n  if (sanitizedBytes !== undefined) {\n    fallback.sanitizedDetailsBytes = sanitizedBytes;\n  }\n  if (src) {\n    fallback.originalDetailKeys = firstEnumerableOwnKeys(src, 40);\n    for (const key of ['status', 'sessionId', 'pid', 'exitCode', 'exitSignal', 'truncated']) {\n      const field = src[key];\n      if (field !== undefined) {\n        fallback[key] =\n          typeof field === 'string'\n            ? truncatePersistedDetailString(field, MAX_PERSISTED_DETAIL_FALLBACK_STRING_CHARS)\n            : field;\n      }\n    }\n  }\n  return fallback;\n}\n\nfunction enforcePersistedDetailsByteCap(\n  value: Record<string, unknown>,\n  src: Record<string, unknown> | undefined,\n  originalSize: BoundedJsonUtf8Bytes,\n): Record<string, unknown> {\n  const sanitizedBytes = jsonUtf8BytesOrInfinity(value);\n  if (sanitizedBytes <= MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES) {\n    return value;\n  }\n  const fallback = buildPersistedDetailsFallback(src, originalSize, sanitizedBytes);\n  if (jsonUtf8BytesOrInfinity(fallback) <= MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES) {\n    return fallback;\n  }\n  return {\n    persistedDetailsTruncated: true,\n    finalDetailsTruncated: true,\n    ...originalDetailsSizeFields(originalSize),\n    sanitizedDetailsBytes: sanitizedBytes,\n  };\n}\n\nfunction sanitizeToolResultDetailsForPersistence(details: unknown): unknown {\n  if (details === undefined || details === null) {\n    return details;\n  }\n  const originalSize = boundedJsonUtf8Bytes(details, MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES);\n  if (originalSize.complete && originalSize.bytes <= MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES) {\n    return details;\n  }\n  if (typeof details !== 'object') {\n    return enforcePersistedDetailsByteCap(\n      {\n        persistedDetailsTruncated: true,\n        ...originalDetailsSizeFields(originalSize),\n        valueType: typeof details,\n      },\n      undefined,\n      originalSize,\n    );\n  }\n  const src = details as Record<string, unknown>;\n  const out: Record<string, unknown> = {\n    persistedDetailsTruncated: true,\n    ...originalDetailsSizeFields(originalSize),\n    originalDetailKeys: firstEnumerableOwnKeys(src, 40),\n  };\n  for (const key of [\n    'status',\n    'sessionId',\n    'pid',\n    'startedAt',\n    'endedAt',\n    'cwd',\n    'name',\n    'exitCode',\n    'exitSignal',\n    'retryInMs',\n    'total',\n    'totalLines',\n    'totalChars',\n    'truncated',\n    'fullOutputPath',\n    'truncation',\n  ]) {\n    const field = src[key];\n    if (field !== undefined) {\n      out[key] = typeof field === 'string' ? truncatePersistedDetailString(field) : field;\n    }\n  }\n  if (typeof src.tail === 'string') {\n    out.tail = truncatePersistedDetailString(src.tail);\n  }\n  if (Array.isArray(src.sessions)) {\n    out.sessions = src.sessions\n      .slice(0, MAX_PERSISTED_DETAIL_SESSION_COUNT)\n      .map(sanitizePersistedSessionDetail);\n    if (src.sessions.length > MAX_PERSISTED_DETAIL_SESSION_COUNT) {\n      out.sessionsTruncated = src.sessions.length - MAX_PERSISTED_DETAIL_SESSION_COUNT;\n    }\n  }\n  return enforcePersistedDetailsByteCap(out, src, originalSize);\n}\n\nfunction capToolResultDetails(msg: AgentMessage): AgentMessage {\n  if ((msg as { role?: string }).role !== 'toolResult') {\n    return msg;\n  }\n  const details = (msg as { details?: unknown }).details;\n  const sanitizedDetails = sanitizeToolResultDetailsForPersistence(details);\n  if (sanitizedDetails === details) {\n    return msg;\n  }\n  const next = { ...msg } as AgentMessage & { details?: unknown };\n  next.details = sanitizedDetails;\n  return next;\n}\n\nfunction capToolResultForPersistence(msg: AgentMessage, maxChars: number): AgentMessage {\n  return capToolResultDetails(capToolResultSize(msg, maxChars));\n}\n\nfunction normalizePersistedToolResultName(\n  message: AgentMessage,\n  fallbackName?: string,\n): AgentMessage {\n  if ((message as { role?: unknown }).role !== 'toolResult') {\n    return message;\n  }\n  const toolResult = message as Extract<AgentMessage, { role: 'toolResult' }>;\n  const rawToolName = (toolResult as { toolName?: unknown }).toolName;\n  const normalizedToolName = normalizeOptionalString(rawToolName);\n  if (normalizedToolName) {\n    if (rawToolName === normalizedToolName) {\n      return toolResult;\n    }\n    return { ...toolResult, toolName: normalizedToolName };\n  }\n\n  const normalizedFallback = normalizeOptionalString(fallbackName);\n  if (normalizedFallback) {\n    return { ...toolResult, toolName: normalizedFallback };\n  }\n\n  if (typeof rawToolName === 'string') {\n    return { ...toolResult, toolName: 'unknown' };\n  }\n  return toolResult;\n}\n\n// ── Internal: raw-append symbol storage ─────────────────────────────────────\n\nconst RAW_APPEND_MESSAGE = Symbol('xopc.session.rawAppendMessage');\n\ntype SessionManagerWithRawAppend = SessionManager & {\n  [RAW_APPEND_MESSAGE]?: SessionManager['appendMessage'];\n};\n\nfunction rememberOriginalAppend(\n  sessionManager: SessionManager,\n): SessionManager['appendMessage'] {\n  const tagged = sessionManager as SessionManagerWithRawAppend;\n  const stored = tagged[RAW_APPEND_MESSAGE];\n  if (stored) {\n    return stored;\n  }\n  const original = sessionManager.appendMessage.bind(sessionManager);\n  tagged[RAW_APPEND_MESSAGE] = original;\n  return original;\n}\n\n// ── Internal: pending tool-call state ──────────────────────────────────────\n\ntype PendingToolCall = { id: string; name?: string };\n\nclass PendingToolCallTracker {\n  private readonly pending = new Map<string, string | undefined>();\n\n  size(): number {\n    return this.pending.size;\n  }\n\n  getToolName(id: string): string | undefined {\n    return this.pending.get(id);\n  }\n\n  delete(id: string): void {\n    this.pending.delete(id);\n  }\n\n  clear(): void {\n    this.pending.clear();\n  }\n\n  trackToolCalls(calls: readonly PendingToolCall[]): void {\n    for (const call of calls) {\n      this.pending.set(call.id, call.name);\n    }\n  }\n\n  entries(): IterableIterator<[string, string | undefined]> {\n    return this.pending.entries();\n  }\n\n  getPendingIds(): string[] {\n    return Array.from(this.pending.keys());\n  }\n\n  shouldFlushForSanitizedDrop(): boolean {\n    return this.pending.size > 0;\n  }\n\n  shouldFlushBeforeNonToolResult(nextRole: unknown, toolCallCount: number): boolean {\n    return this.pending.size > 0 && (toolCallCount === 0 || nextRole !== 'assistant');\n  }\n\n  shouldFlushBeforeNewToolCalls(toolCallCount: number): boolean {\n    return this.pending.size > 0 && toolCallCount > 0;\n  }\n}\n\n// ── ToolResultGuard class ──────────────────────────────────────────────────\n\nclass ToolResultGuard {\n  private readonly sessionManager: SessionManager;\n  private readonly opts: ToolResultGuardOptions;\n  private readonly pending = new PendingToolCallTracker();\n  private readonly originalAppend: SessionManager['appendMessage'];\n  private readonly allowSyntheticToolResults: boolean;\n  private readonly maxToolResultChars: number;\n\n  constructor(sessionManager: SessionManager, opts: ToolResultGuardOptions) {\n    this.sessionManager = sessionManager;\n    this.opts = opts;\n    this.originalAppend = rememberOriginalAppend(sessionManager);\n    this.allowSyntheticToolResults = opts.allowSyntheticToolResults ?? true;\n    this.maxToolResultChars = resolveMaxToolResultChars(opts);\n  }\n\n  /** Monkey-patch the session manager so pi-coding-agent's internal appendMessage flows through us. */\n  attach(): void {\n    const bound = this.guardedAppend.bind(this);\n    this.sessionManager.appendMessage = bound as SessionManager['appendMessage'];\n  }\n\n  flushPending(): void {\n    if (this.pending.size() === 0) {\n      return;\n    }\n    if (this.allowSyntheticToolResults) {\n      for (const [id, name] of this.pending.entries()) {\n        const synthetic = makeMissingToolResult({\n          toolCallId: id,\n          toolName: name,\n          text: this.opts.missingToolResultText,\n        });\n        const flushed = this.applyBeforeWriteHook(\n          this.persistToolResult(this.persistMessage(synthetic), {\n            toolCallId: id,\n            toolName: name,\n            isSynthetic: true,\n          }),\n        );\n        if (flushed) {\n          this.originalAppend(capToolResultForPersistence(flushed, this.maxToolResultChars) as never);\n        }\n      }\n    }\n    this.pending.clear();\n  }\n\n  clearPending(): void {\n    this.pending.clear();\n  }\n\n  getPendingIds(): string[] {\n    return this.pending.getPendingIds();\n  }\n\n  private persistMessage(message: AgentMessage): AgentMessage {\n    const transformer = this.opts.transformMessageForPersistence;\n    return transformer ? transformer(message) : message;\n  }\n\n  private persistToolResult(\n    message: AgentMessage,\n    meta: { toolCallId?: string; toolName?: string; isSynthetic?: boolean },\n  ): AgentMessage {\n    const transformer = this.opts.transformToolResultForPersistence;\n    return transformer ? transformer(message, meta) : message;\n  }\n\n  /**\n   * Run the before_message_write hook. Returns the (possibly modified) message,\n   * or null if the message should be blocked.\n   */\n  private applyBeforeWriteHook(msg: AgentMessage): AgentMessage | null {\n    const beforeWrite = this.opts.beforeMessageWriteHook;\n    if (!beforeWrite) {\n      return msg;\n    }\n    const result = beforeWrite({ message: msg });\n    if (result?.block) {\n      return null;\n    }\n    if (result?.message) {\n      return result.message;\n    }\n    return msg;\n  }\n\n  private guardedAppend(message: AgentMessage): unknown {\n    let nextMessage = message;\n    const role = (message as { role?: unknown }).role;\n    if (role === 'assistant') {\n      const sanitized = sanitizeToolCallInputs([message], {\n        allowedToolNames: this.opts.allowedToolNames,\n      });\n      if (sanitized.length === 0) {\n        if (this.pending.shouldFlushForSanitizedDrop()) {\n          this.flushPending();\n        }\n        return undefined;\n      }\n      nextMessage = sanitized[0];\n    }\n    const nextRole = (nextMessage as { role?: unknown }).role;\n\n    if (nextRole === 'toolResult') {\n      const id = extractToolResultId(nextMessage as Extract<AgentMessage, { role: 'toolResult' }>);\n      const toolName = id ? this.pending.getToolName(id) : undefined;\n      if (id) {\n        this.pending.delete(id);\n      }\n      const normalizedToolResult = normalizePersistedToolResultName(nextMessage, toolName);\n      // Apply hard size cap before persistence to prevent oversized tool results\n      // from consuming the entire context window on subsequent LLM calls.\n      const capped = capToolResultForPersistence(\n        this.persistMessage(normalizedToolResult),\n        this.maxToolResultChars,\n      );\n      const persisted = this.applyBeforeWriteHook(\n        this.persistToolResult(capped, {\n          toolCallId: id ?? undefined,\n          toolName,\n          isSynthetic: false,\n        }),\n      );\n      if (!persisted) {\n        return undefined;\n      }\n      return this.originalAppend(capToolResultForPersistence(persisted, this.maxToolResultChars) as never);\n    }\n\n    // Skip tool call extraction for aborted/errored assistant messages.\n    // When stopReason is \"error\" or \"aborted\", the tool_use blocks may be incomplete\n    // and should not have synthetic tool_results created. Creating synthetic results\n    // for incomplete tool calls causes API 400 errors:\n    // \"unexpected tool_use_id found in tool_result blocks\"\n    // This matches the behavior in repairToolUseResultPairing (session-transcript-repair.ts)\n    const stopReason = (nextMessage as { stopReason?: string }).stopReason;\n    const toolCalls =\n      nextRole === 'assistant' && stopReason !== 'aborted' && stopReason !== 'error'\n        ? extractToolCallsFromAssistant(nextMessage as Extract<AgentMessage, { role: 'assistant' }>)\n        : [];\n\n    // Always clear pending tool call state before appending non-tool-result messages.\n    // flushPendingToolResults() only inserts synthetic results when allowSyntheticToolResults\n    // is true; it always clears the pending map. Without this, providers that disable\n    // synthetic results (e.g. OpenAI) accumulate stale pending state when a user message\n    // interrupts in-flight tool calls, leaving orphaned tool_use blocks in the transcript\n    // that cause API 400 errors on subsequent requests.\n    if (this.pending.shouldFlushBeforeNonToolResult(nextRole, toolCalls.length)) {\n      this.flushPending();\n    }\n    // If new tool calls arrive while older ones are pending, flush the old ones first.\n    if (this.pending.shouldFlushBeforeNewToolCalls(toolCalls.length)) {\n      this.flushPending();\n    }\n\n    const finalMessage = this.applyBeforeWriteHook(this.persistMessage(nextMessage));\n    if (!finalMessage) {\n      return undefined;\n    }\n    const result = this.originalAppend(finalMessage as never);\n\n    const sessionFile = (\n      this.sessionManager as { getSessionFile?: () => string | null }\n    ).getSessionFile?.();\n    if (sessionFile) {\n      emitSessionTranscriptUpdate({\n        sessionFile,\n        sessionKey: this.opts.sessionKey,\n        message: finalMessage,\n        messageId: typeof result === 'string' ? result : undefined,\n      });\n    }\n\n    if (toolCalls.length > 0) {\n      this.pending.trackToolCalls(toolCalls);\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-tool-result-guard.js","names":[],"sources":["../../../../src/agent/embedded/session-tool-result-guard.ts"],"sourcesContent":["/**\n * Session tool-result guard — wraps a pi `SessionManager.appendMessage` to:\n *   1. cap oversized tool-result text + details so they cannot blow up the next\n *      LLM request (size + persistence limits).\n *   2. track pending tool-call IDs so missing tool results can be synthesised\n *      (some providers refuse a turn that has an orphan tool_use block).\n *   3. drop assistant `toolCall` blocks whose tool name is not in the allowlist\n *      (these would also trigger provider 400s).\n *   4. broadcast `xopc:transcript-row` updates so the gateway UI can stream them.\n *\n * Previously this module shipped with three sibling files\n * (`session-tool-result-state.ts`, `session-raw-append-message.ts`,\n * `session-tool-result-guard-wrapper.ts`). They are now consolidated here as\n * private constructs around the `ToolResultGuard` class. Pi-coding-agent owns\n * the `SessionManager` instance and calls `appendMessage` from inside the\n * runtime, so we still need to monkey-patch that method — but the patched\n * implementation is just `guard.guardedAppend.bind(guard)` and all state lives\n * on the class.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { SessionManager } from '@earendil-works/pi-coding-agent';\n\nimport type { Config } from '../../config/schema.js';\nimport {\n  boundedJsonUtf8Bytes,\n  firstEnumerableOwnKeys,\n  jsonUtf8BytesOrInfinity,\n  type BoundedJsonUtf8Bytes,\n} from '../../infra/json-utf8-bytes.js';\nimport { emitSessionTranscriptUpdate } from '../../session/transcript-events.js';\nimport { normalizeOptionalString } from '../../utils/string-coerce.js';\nimport { formatContextLimitTruncationNotice } from './tool-result-context-guard.js';\nimport {\n  DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS,\n  resolveLiveToolResultMaxChars,\n  truncateToolResultMessage,\n} from './tool-result-truncation.js';\nimport {\n  makeMissingToolResult,\n  sanitizeToolCallInputs,\n} from '../transcript/session-transcript-repair.js';\nimport {\n  extractToolCallsFromAssistant,\n  extractToolResultId,\n} from '../transcript/tool-call-id.js';\n\n// ── Public surface ──────────────────────────────────────────────────────────\n\nexport type BeforeMessageWriteHookEvent = { message: AgentMessage };\nexport type BeforeMessageWriteHookResult =\n  | { block?: boolean; message?: AgentMessage }\n  | undefined;\n\nexport interface ToolResultGuardOptions {\n  /** Optional session key for transcript update broadcasts. */\n  sessionKey?: string;\n  /** Optional transform applied to any message before persistence. */\n  transformMessageForPersistence?: (message: AgentMessage) => AgentMessage;\n  /**\n   * Optional, synchronous transform applied to toolResult messages *before* they are\n   * persisted to the session transcript.\n   */\n  transformToolResultForPersistence?: (\n    message: AgentMessage,\n    meta: { toolCallId?: string; toolName?: string; isSynthetic?: boolean },\n  ) => AgentMessage;\n  /**\n   * Whether to synthesize missing tool results to satisfy strict providers.\n   * Defaults to true.\n   */\n  allowSyntheticToolResults?: boolean;\n  missingToolResultText?: string;\n  /**\n   * Optional set/list of tool names accepted for assistant toolCall/toolUse blocks.\n   * When set, tool calls with unknown names are dropped before persistence.\n   */\n  allowedToolNames?: Iterable<string>;\n  /**\n   * Synchronous hook invoked before any message is written to the session JSONL.\n   * If the hook returns { block: true }, the message is silently dropped.\n   * If it returns { message }, the modified message is written instead.\n   */\n  beforeMessageWriteHook?: (event: BeforeMessageWriteHookEvent) => BeforeMessageWriteHookResult;\n  maxToolResultChars?: number;\n}\n\nexport interface InstallSessionToolResultGuardResult {\n  flushPendingToolResults: () => void;\n  clearPendingToolResults: () => void;\n  getPendingIds: () => string[];\n}\n\n/** Idempotent wrapper that also adds the helper methods consumers expect. */\nexport type GuardedPiTranscriptManager = SessionManager & {\n  flushPendingToolResults?: () => void;\n  clearPendingToolResults?: () => void;\n};\n\n/**\n * Install the guard on a SessionManager and return its control API.\n * Subsequent assistant/toolResult writes by pi-coding-agent flow through the\n * guard transparently.\n */\nexport function installSessionToolResultGuard(\n  sessionManager: SessionManager,\n  opts: ToolResultGuardOptions = {},\n): InstallSessionToolResultGuardResult {\n  const guard = new ToolResultGuard(sessionManager, opts);\n  guard.attach();\n  return {\n    flushPendingToolResults: () => guard.flushPending(),\n    clearPendingToolResults: () => guard.clearPending(),\n    getPendingIds: () => guard.getPendingIds(),\n  };\n}\n\n/**\n * Convenience wrapper used by the embedded runner pool: install the guard\n * (idempotent), pin the size cap from the model context window, and expose\n * `flushPendingToolResults` / `clearPendingToolResults` directly on the\n * SessionManager instance so callers do not need to keep the install result.\n */\nexport function guardSessionManager(\n  sessionManager: SessionManager,\n  opts?: {\n    agentId?: string;\n    sessionKey?: string;\n    config?: Config;\n    contextWindowTokens?: number;\n    allowSyntheticToolResults?: boolean;\n    missingToolResultText?: string;\n    allowedToolNames?: Iterable<string>;\n  },\n): GuardedPiTranscriptManager {\n  if (typeof (sessionManager as GuardedPiTranscriptManager).flushPendingToolResults === 'function') {\n    return sessionManager as GuardedPiTranscriptManager;\n  }\n\n  const result = installSessionToolResultGuard(sessionManager, {\n    sessionKey: opts?.sessionKey,\n    allowSyntheticToolResults: opts?.allowSyntheticToolResults,\n    missingToolResultText: opts?.missingToolResultText,\n    allowedToolNames: opts?.allowedToolNames,\n    maxToolResultChars:\n      typeof opts?.contextWindowTokens === 'number'\n        ? resolveLiveToolResultMaxChars({\n            contextWindowTokens: opts.contextWindowTokens,\n            cfg: opts?.config,\n            agentId: opts?.agentId,\n          })\n        : undefined,\n  });\n  const tagged = sessionManager as GuardedPiTranscriptManager;\n  tagged.flushPendingToolResults = result.flushPendingToolResults;\n  tagged.clearPendingToolResults = result.clearPendingToolResults;\n  return tagged;\n}\n\n/**\n * Recover the original (un-guarded) appendMessage for a session manager.\n * Useful for callers that need a low-level \"bypass the guard\" write path.\n */\nexport function getRawSessionAppendMessage(\n  sessionManager: SessionManager,\n): SessionManager['appendMessage'] {\n  const stored = (sessionManager as SessionManagerWithRawAppend)[RAW_APPEND_MESSAGE];\n  return stored ?? sessionManager.appendMessage.bind(sessionManager);\n}\n\n// ── Internal: persistence + truncation helpers ──────────────────────────────\n\nfunction resolveMaxToolResultChars(opts: { maxToolResultChars?: number }): number {\n  return Math.max(1, opts.maxToolResultChars ?? DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS);\n}\n\nfunction capToolResultSize(msg: AgentMessage, maxChars: number): AgentMessage {\n  if ((msg as { role?: string }).role !== 'toolResult') {\n    return msg;\n  }\n  return truncateToolResultMessage(msg, maxChars, {\n    suffix: (truncatedChars) => formatContextLimitTruncationNotice(truncatedChars),\n    minKeepChars: 2_000,\n  });\n}\n\n// `details` is runtime/UI metadata, not model-visible tool output. Keep the\n// session JSONL useful for debugging without letting metadata blobs dominate\n// disk, replay repair, transcript broadcasts, or future tooling that reads raw\n// sessions. Model-visible text belongs in tool result `content`.\nconst MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES = 8_192;\nconst MAX_PERSISTED_DETAIL_STRING_CHARS = 2_000;\nconst MAX_PERSISTED_DETAIL_SESSION_COUNT = 10;\nconst MAX_PERSISTED_DETAIL_FALLBACK_STRING_CHARS = 200;\n\nfunction originalDetailsSizeFields(size: BoundedJsonUtf8Bytes): Record<string, number> {\n  return size.complete\n    ? { originalDetailsBytes: size.bytes }\n    : { originalDetailsBytesAtLeast: size.bytes };\n}\n\nfunction truncatePersistedDetailString(\n  value: string,\n  maxChars = MAX_PERSISTED_DETAIL_STRING_CHARS,\n): string {\n  if (value.length <= maxChars) {\n    return value;\n  }\n  return `${value.slice(0, maxChars)}\\n\\n[xopc persisted detail truncated: ${\n    value.length - maxChars\n  } chars omitted]`;\n}\n\nfunction sanitizePersistedSessionDetail(value: unknown): unknown {\n  if (!value || typeof value !== 'object') {\n    return value;\n  }\n  const src = value as Record<string, unknown>;\n  const out: Record<string, unknown> = {};\n  for (const key of [\n    'sessionId',\n    'status',\n    'pid',\n    'startedAt',\n    'endedAt',\n    'runtimeMs',\n    'cwd',\n    'name',\n    'truncated',\n    'exitCode',\n    'exitSignal',\n  ]) {\n    const field = src[key];\n    if (field !== undefined) {\n      out[key] = typeof field === 'string' ? truncatePersistedDetailString(field, 500) : field;\n    }\n  }\n  if (typeof src.command === 'string') {\n    out.command = truncatePersistedDetailString(src.command, 500);\n  }\n  return out;\n}\n\nfunction buildPersistedDetailsFallback(\n  src: Record<string, unknown> | undefined,\n  originalSize: BoundedJsonUtf8Bytes,\n  sanitizedBytes?: number,\n): Record<string, unknown> {\n  const fallback: Record<string, unknown> = {\n    persistedDetailsTruncated: true,\n    finalDetailsTruncated: true,\n    ...originalDetailsSizeFields(originalSize),\n  };\n  if (sanitizedBytes !== undefined) {\n    fallback.sanitizedDetailsBytes = sanitizedBytes;\n  }\n  if (src) {\n    fallback.originalDetailKeys = firstEnumerableOwnKeys(src, 40);\n    for (const key of ['status', 'sessionId', 'pid', 'exitCode', 'exitSignal', 'truncated']) {\n      const field = src[key];\n      if (field !== undefined) {\n        fallback[key] =\n          typeof field === 'string'\n            ? truncatePersistedDetailString(field, MAX_PERSISTED_DETAIL_FALLBACK_STRING_CHARS)\n            : field;\n      }\n    }\n  }\n  return fallback;\n}\n\nfunction enforcePersistedDetailsByteCap(\n  value: Record<string, unknown>,\n  src: Record<string, unknown> | undefined,\n  originalSize: BoundedJsonUtf8Bytes,\n): Record<string, unknown> {\n  const sanitizedBytes = jsonUtf8BytesOrInfinity(value);\n  if (sanitizedBytes <= MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES) {\n    return value;\n  }\n  const fallback = buildPersistedDetailsFallback(src, originalSize, sanitizedBytes);\n  if (jsonUtf8BytesOrInfinity(fallback) <= MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES) {\n    return fallback;\n  }\n  return {\n    persistedDetailsTruncated: true,\n    finalDetailsTruncated: true,\n    ...originalDetailsSizeFields(originalSize),\n    sanitizedDetailsBytes: sanitizedBytes,\n  };\n}\n\nfunction sanitizeToolResultDetailsForPersistence(details: unknown): unknown {\n  if (details === undefined || details === null) {\n    return details;\n  }\n  const originalSize = boundedJsonUtf8Bytes(details, MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES);\n  if (originalSize.complete && originalSize.bytes <= MAX_PERSISTED_TOOL_RESULT_DETAILS_BYTES) {\n    return details;\n  }\n  if (typeof details !== 'object') {\n    return enforcePersistedDetailsByteCap(\n      {\n        persistedDetailsTruncated: true,\n        ...originalDetailsSizeFields(originalSize),\n        valueType: typeof details,\n      },\n      undefined,\n      originalSize,\n    );\n  }\n  const src = details as Record<string, unknown>;\n  const out: Record<string, unknown> = {\n    persistedDetailsTruncated: true,\n    ...originalDetailsSizeFields(originalSize),\n    originalDetailKeys: firstEnumerableOwnKeys(src, 40),\n  };\n  for (const key of [\n    'status',\n    'sessionId',\n    'pid',\n    'startedAt',\n    'endedAt',\n    'cwd',\n    'name',\n    'exitCode',\n    'exitSignal',\n    'retryInMs',\n    'total',\n    'totalLines',\n    'totalChars',\n    'truncated',\n    'fullOutputPath',\n    'truncation',\n  ]) {\n    const field = src[key];\n    if (field !== undefined) {\n      out[key] = typeof field === 'string' ? truncatePersistedDetailString(field) : field;\n    }\n  }\n  if (typeof src.tail === 'string') {\n    out.tail = truncatePersistedDetailString(src.tail);\n  }\n  if (Array.isArray(src.sessions)) {\n    out.sessions = src.sessions\n      .slice(0, MAX_PERSISTED_DETAIL_SESSION_COUNT)\n      .map(sanitizePersistedSessionDetail);\n    if (src.sessions.length > MAX_PERSISTED_DETAIL_SESSION_COUNT) {\n      out.sessionsTruncated = src.sessions.length - MAX_PERSISTED_DETAIL_SESSION_COUNT;\n    }\n  }\n  return enforcePersistedDetailsByteCap(out, src, originalSize);\n}\n\nfunction capToolResultDetails(msg: AgentMessage): AgentMessage {\n  if ((msg as { role?: string }).role !== 'toolResult') {\n    return msg;\n  }\n  const details = (msg as { details?: unknown }).details;\n  const sanitizedDetails = sanitizeToolResultDetailsForPersistence(details);\n  if (sanitizedDetails === details) {\n    return msg;\n  }\n  const next = { ...msg } as AgentMessage & { details?: unknown };\n  next.details = sanitizedDetails;\n  return next;\n}\n\nfunction capToolResultForPersistence(msg: AgentMessage, maxChars: number): AgentMessage {\n  return capToolResultDetails(capToolResultSize(msg, maxChars));\n}\n\nfunction normalizePersistedToolResultName(\n  message: AgentMessage,\n  fallbackName?: string,\n): AgentMessage {\n  if ((message as { role?: unknown }).role !== 'toolResult') {\n    return message;\n  }\n  const toolResult = message as Extract<AgentMessage, { role: 'toolResult' }>;\n  const rawToolName = (toolResult as { toolName?: unknown }).toolName;\n  const normalizedToolName = normalizeOptionalString(rawToolName);\n  if (normalizedToolName) {\n    if (rawToolName === normalizedToolName) {\n      return toolResult;\n    }\n    return { ...toolResult, toolName: normalizedToolName };\n  }\n\n  const normalizedFallback = normalizeOptionalString(fallbackName);\n  if (normalizedFallback) {\n    return { ...toolResult, toolName: normalizedFallback };\n  }\n\n  if (typeof rawToolName === 'string') {\n    return { ...toolResult, toolName: 'unknown' };\n  }\n  return toolResult;\n}\n\n// ── Internal: raw-append symbol storage ─────────────────────────────────────\n\nconst RAW_APPEND_MESSAGE = Symbol('xopc.session.rawAppendMessage');\n\ntype SessionManagerWithRawAppend = SessionManager & {\n  [RAW_APPEND_MESSAGE]?: SessionManager['appendMessage'];\n};\n\nfunction rememberOriginalAppend(\n  sessionManager: SessionManager,\n): SessionManager['appendMessage'] {\n  const tagged = sessionManager as SessionManagerWithRawAppend;\n  const stored = tagged[RAW_APPEND_MESSAGE];\n  if (stored) {\n    return stored;\n  }\n  const original = sessionManager.appendMessage.bind(sessionManager);\n  tagged[RAW_APPEND_MESSAGE] = original;\n  return original;\n}\n\n// ── Internal: pending tool-call state ──────────────────────────────────────\n\ntype PendingToolCall = { id: string; name?: string };\n\nclass PendingToolCallTracker {\n  private readonly pending = new Map<string, string | undefined>();\n\n  size(): number {\n    return this.pending.size;\n  }\n\n  getToolName(id: string): string | undefined {\n    return this.pending.get(id);\n  }\n\n  delete(id: string): void {\n    this.pending.delete(id);\n  }\n\n  clear(): void {\n    this.pending.clear();\n  }\n\n  trackToolCalls(calls: readonly PendingToolCall[]): void {\n    for (const call of calls) {\n      this.pending.set(call.id, call.name);\n    }\n  }\n\n  entries(): IterableIterator<[string, string | undefined]> {\n    return this.pending.entries();\n  }\n\n  getPendingIds(): string[] {\n    return Array.from(this.pending.keys());\n  }\n\n  shouldFlushForSanitizedDrop(): boolean {\n    return this.pending.size > 0;\n  }\n\n  shouldFlushBeforeNonToolResult(nextRole: unknown, toolCallCount: number): boolean {\n    return this.pending.size > 0 && (toolCallCount === 0 || nextRole !== 'assistant');\n  }\n\n  shouldFlushBeforeNewToolCalls(toolCallCount: number): boolean {\n    return this.pending.size > 0 && toolCallCount > 0;\n  }\n}\n\n// ── ToolResultGuard class ──────────────────────────────────────────────────\n\nclass ToolResultGuard {\n  private readonly sessionManager: SessionManager;\n  private readonly opts: ToolResultGuardOptions;\n  private readonly pending = new PendingToolCallTracker();\n  private readonly originalAppend: SessionManager['appendMessage'];\n  private readonly allowSyntheticToolResults: boolean;\n  private readonly maxToolResultChars: number;\n\n  constructor(sessionManager: SessionManager, opts: ToolResultGuardOptions) {\n    this.sessionManager = sessionManager;\n    this.opts = opts;\n    this.originalAppend = rememberOriginalAppend(sessionManager);\n    this.allowSyntheticToolResults = opts.allowSyntheticToolResults ?? true;\n    this.maxToolResultChars = resolveMaxToolResultChars(opts);\n  }\n\n  /** Monkey-patch the session manager so pi-coding-agent's internal appendMessage flows through us. */\n  attach(): void {\n    const bound = this.guardedAppend.bind(this);\n    this.sessionManager.appendMessage = bound as SessionManager['appendMessage'];\n  }\n\n  flushPending(): void {\n    if (this.pending.size() === 0) {\n      return;\n    }\n    if (this.allowSyntheticToolResults) {\n      for (const [id, name] of this.pending.entries()) {\n        const synthetic = makeMissingToolResult({\n          toolCallId: id,\n          toolName: name,\n          text: this.opts.missingToolResultText,\n        });\n        const flushed = this.applyBeforeWriteHook(\n          this.persistToolResult(this.persistMessage(synthetic), {\n            toolCallId: id,\n            toolName: name,\n            isSynthetic: true,\n          }),\n        );\n        if (flushed) {\n          this.originalAppend(capToolResultForPersistence(flushed, this.maxToolResultChars) as never);\n        }\n      }\n    }\n    this.pending.clear();\n  }\n\n  clearPending(): void {\n    this.pending.clear();\n  }\n\n  getPendingIds(): string[] {\n    return this.pending.getPendingIds();\n  }\n\n  private persistMessage(message: AgentMessage): AgentMessage {\n    const transformer = this.opts.transformMessageForPersistence;\n    return transformer ? transformer(message) : message;\n  }\n\n  private persistToolResult(\n    message: AgentMessage,\n    meta: { toolCallId?: string; toolName?: string; isSynthetic?: boolean },\n  ): AgentMessage {\n    const transformer = this.opts.transformToolResultForPersistence;\n    return transformer ? transformer(message, meta) : message;\n  }\n\n  /**\n   * Run the before_message_write hook. Returns the (possibly modified) message,\n   * or null if the message should be blocked.\n   */\n  private applyBeforeWriteHook(msg: AgentMessage): AgentMessage | null {\n    const beforeWrite = this.opts.beforeMessageWriteHook;\n    if (!beforeWrite) {\n      return msg;\n    }\n    const result = beforeWrite({ message: msg });\n    if (result?.block) {\n      return null;\n    }\n    if (result?.message) {\n      return result.message;\n    }\n    return msg;\n  }\n\n  private guardedAppend(message: AgentMessage): unknown {\n    let nextMessage = message;\n    const role = (message as { role?: unknown }).role;\n    if (role === 'assistant') {\n      const sanitized = sanitizeToolCallInputs([message], {\n        allowedToolNames: this.opts.allowedToolNames,\n      });\n      if (sanitized.length === 0) {\n        if (this.pending.shouldFlushForSanitizedDrop()) {\n          this.flushPending();\n        }\n        return undefined;\n      }\n      nextMessage = sanitized[0];\n    }\n    const nextRole = (nextMessage as { role?: unknown }).role;\n\n    if (nextRole === 'toolResult') {\n      const id = extractToolResultId(nextMessage as Extract<AgentMessage, { role: 'toolResult' }>);\n      const toolName = id ? this.pending.getToolName(id) : undefined;\n      if (id) {\n        this.pending.delete(id);\n      }\n      const normalizedToolResult = normalizePersistedToolResultName(nextMessage, toolName);\n      // Apply hard size cap before persistence to prevent oversized tool results\n      // from consuming the entire context window on subsequent LLM calls.\n      const capped = capToolResultForPersistence(\n        this.persistMessage(normalizedToolResult),\n        this.maxToolResultChars,\n      );\n      const persisted = this.applyBeforeWriteHook(\n        this.persistToolResult(capped, {\n          toolCallId: id ?? undefined,\n          toolName,\n          isSynthetic: false,\n        }),\n      );\n      if (!persisted) {\n        return undefined;\n      }\n      return this.originalAppend(capToolResultForPersistence(persisted, this.maxToolResultChars) as never);\n    }\n\n    // Skip tool call extraction for aborted/errored assistant messages.\n    // When stopReason is \"error\" or \"aborted\", the tool_use blocks may be incomplete\n    // and should not have synthetic tool_results created. Creating synthetic results\n    // for incomplete tool calls causes API 400 errors:\n    // \"unexpected tool_use_id found in tool_result blocks\"\n    // This matches the behavior in repairToolUseResultPairing (session-transcript-repair.ts)\n    const stopReason = (nextMessage as { stopReason?: string }).stopReason;\n    const toolCalls =\n      nextRole === 'assistant' && stopReason !== 'aborted' && stopReason !== 'error'\n        ? extractToolCallsFromAssistant(nextMessage as Extract<AgentMessage, { role: 'assistant' }>)\n        : [];\n\n    // Always clear pending tool call state before appending non-tool-result messages.\n    // flushPendingToolResults() only inserts synthetic results when allowSyntheticToolResults\n    // is true; it always clears the pending map. Without this, providers that disable\n    // synthetic results (e.g. OpenAI) accumulate stale pending state when a user message\n    // interrupts in-flight tool calls, leaving orphaned tool_use blocks in the transcript\n    // that cause API 400 errors on subsequent requests.\n    if (this.pending.shouldFlushBeforeNonToolResult(nextRole, toolCalls.length)) {\n      this.flushPending();\n    }\n    // If new tool calls arrive while older ones are pending, flush the old ones first.\n    if (this.pending.shouldFlushBeforeNewToolCalls(toolCalls.length)) {\n      this.flushPending();\n    }\n\n    const finalMessage = this.applyBeforeWriteHook(this.persistMessage(nextMessage));\n    if (!finalMessage) {\n      return undefined;\n    }\n    const result = this.originalAppend(finalMessage as never);\n\n    const sessionFile = (\n      this.sessionManager as { getSessionFile?: () => string | null }\n    ).getSessionFile?.();\n    if (sessionFile) {\n      emitSessionTranscriptUpdate({\n        sessionFile,\n        sessionKey: this.opts.sessionKey,\n        message: finalMessage,\n        messageId: typeof result === 'string' ? result : undefined,\n      });\n    }\n\n    if (toolCalls.length > 0) {\n      this.pending.trackToolCalls(toolCalls);\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/embedded/tool-result-truncation.js

@@ -1,6 +1,7 @@
-import { normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
+import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
 import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
 //#region src/agent/embedded/tool-result-truncation.ts
+init_string_coerce();
 const MAX_TOOL_RESULT_CONTEXT_SHARE = .3;
 const DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS = 16e3;
 const HARD_MAX_TOOL_RESULT_CHARS = DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS;

package/dist/src/agent/embedded/tool-result-truncation.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-result-truncation.js","names":[],"sources":["../../../../src/agent/embedded/tool-result-truncation.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { TextContent } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { normalizeLowercaseStringOrEmpty } from '../../utils/string-coerce.js';\nimport { formatContextLimitTruncationNotice } from './tool-result-context-guard.js';\n\nconst MAX_TOOL_RESULT_CONTEXT_SHARE = 0.3;\n\nexport const DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS = 16_000;\nexport const HARD_MAX_TOOL_RESULT_CHARS = DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS;\n\nconst MIN_KEEP_CHARS = 2_000;\n\ntype ToolResultTruncationOptions = {\n  suffix?: string | ((truncatedChars: number) => string);\n  minKeepChars?: number;\n};\n\nconst DEFAULT_SUFFIX = (truncatedChars: number) => formatContextLimitTruncationNotice(truncatedChars);\n\nfunction resolveSuffixFactory(\n  suffix: ToolResultTruncationOptions['suffix'],\n): (truncatedChars: number) => string {\n  if (typeof suffix === 'function') {\n    return suffix;\n  }\n  if (typeof suffix === 'string') {\n    return () => suffix;\n  }\n  return DEFAULT_SUFFIX;\n}\n\nfunction resolveEffectiveMinKeepChars(params: {\n  maxChars: number;\n  minKeepChars: number;\n  suffixFactory: (truncatedChars: number) => string;\n}): number {\n  const suffixFloor = params.suffixFactory(1).length;\n  return Math.max(0, Math.min(params.minKeepChars, Math.max(0, params.maxChars - suffixFloor)));\n}\n\nfunction appendBoundedTruncationSuffix(params: {\n  keptText: string;\n  originalTextLength: number;\n  maxChars: number;\n  suffixFactory: (truncatedChars: number) => string;\n}): string {\n  const build = (keptText: string) =>\n    keptText + params.suffixFactory(Math.max(1, params.originalTextLength - keptText.length));\n\n  let keptText = params.keptText;\n  while (true) {\n    const finalText = build(keptText);\n    if (finalText.length <= params.maxChars) {\n      return finalText;\n    }\n    if (keptText.length === 0) {\n      return finalText.slice(0, params.maxChars);\n    }\n    const overflow = finalText.length - params.maxChars;\n    const nextKeptText = keptText.slice(0, Math.max(0, keptText.length - overflow));\n    keptText = nextKeptText.length < keptText.length ? nextKeptText : keptText.slice(0, -1);\n  }\n}\n\nconst MIDDLE_OMISSION_MARKER =\n  '\\n\\n[... middle content omitted — showing head and tail ...]\\n\\n';\n\nfunction hasImportantTail(text: string): boolean {\n  const tail = normalizeLowercaseStringOrEmpty(text.slice(-2000));\n  return (\n    /\\b(error|exception|failed|fatal|traceback|panic|stack trace|errno|exit code)\\b/.test(tail) ||\n    /\\}\\s*$/.test(tail.trim()) ||\n    /\\b(total|summary|result|complete|finished|done)\\b/.test(tail)\n  );\n}\n\nexport function truncateToolResultText(\n  text: string,\n  maxChars: number,\n  options: ToolResultTruncationOptions = {},\n): string {\n  const suffixFactory = resolveSuffixFactory(options.suffix);\n  const minKeepChars = resolveEffectiveMinKeepChars({\n    maxChars,\n    minKeepChars: options.minKeepChars ?? MIN_KEEP_CHARS,\n    suffixFactory,\n  });\n  if (text.length <= maxChars) {\n    return text;\n  }\n  const defaultSuffix = suffixFactory(Math.max(1, text.length - maxChars));\n  const budget = Math.max(minKeepChars, maxChars - defaultSuffix.length);\n\n  if (hasImportantTail(text) && budget > minKeepChars * 2) {\n    const tailBudget = Math.min(Math.floor(budget * 0.3), 4_000);\n    const headBudget = budget - tailBudget - MIDDLE_OMISSION_MARKER.length;\n\n    if (headBudget > minKeepChars) {\n      let headCut = headBudget;\n      const headNewline = text.lastIndexOf('\\n', headBudget);\n      if (headNewline > headBudget * 0.8) {\n        headCut = headNewline;\n      }\n\n      let tailStart = text.length - tailBudget;\n      const tailNewline = text.indexOf('\\n', tailStart);\n      if (tailNewline !== -1 && tailNewline < tailStart + tailBudget * 0.2) {\n        tailStart = tailNewline + 1;\n      }\n\n      const keptText = text.slice(0, headCut) + MIDDLE_OMISSION_MARKER + text.slice(tailStart);\n      return appendBoundedTruncationSuffix({\n        keptText,\n        originalTextLength: text.length,\n        maxChars,\n        suffixFactory,\n      });\n    }\n  }\n\n  let cutPoint = budget;\n  const lastNewline = text.lastIndexOf('\\n', budget);\n  if (lastNewline > budget * 0.8) {\n    cutPoint = lastNewline;\n  }\n  const keptText = text.slice(0, cutPoint);\n  return appendBoundedTruncationSuffix({\n    keptText,\n    originalTextLength: text.length,\n    maxChars,\n    suffixFactory,\n  });\n}\n\nexport function calculateMaxToolResultCharsWithCap(\n  contextWindowTokens: number,\n  hardCapChars: number,\n): number {\n  const maxTokens = Math.floor(contextWindowTokens * MAX_TOOL_RESULT_CONTEXT_SHARE);\n  const maxChars = maxTokens * 4;\n  return Math.min(maxChars, Math.max(1, hardCapChars));\n}\n\nexport function resolveLiveToolResultMaxChars(params: {\n  contextWindowTokens: number;\n  cfg?: Config;\n  agentId?: string | null;\n}): number {\n  const configuredCap = DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS;\n  return calculateMaxToolResultCharsWithCap(params.contextWindowTokens, configuredCap);\n}\n\nexport function getToolResultTextLength(msg: AgentMessage): number {\n  if (!msg || (msg as { role?: string }).role !== 'toolResult') {\n    return 0;\n  }\n  const content = (msg as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return 0;\n  }\n  let totalLength = 0;\n  for (const block of content) {\n    if (block && typeof block === 'object' && (block as { type?: string }).type === 'text') {\n      const text = (block as TextContent).text;\n      if (typeof text === 'string') {\n        totalLength += text.length;\n      }\n    }\n  }\n  return totalLength;\n}\n\nexport function truncateToolResultMessage(\n  msg: AgentMessage,\n  maxChars: number,\n  options: ToolResultTruncationOptions = {},\n): AgentMessage {\n  const suffixFactory = resolveSuffixFactory(options.suffix);\n  const minKeepChars = resolveEffectiveMinKeepChars({\n    maxChars,\n    minKeepChars: options.minKeepChars ?? MIN_KEEP_CHARS,\n    suffixFactory,\n  });\n  const content = (msg as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return msg;\n  }\n\n  const totalTextChars = getToolResultTextLength(msg);\n  if (totalTextChars <= maxChars) {\n    return msg;\n  }\n\n  const newContent = content.map((block: unknown) => {\n    if (!block || typeof block !== 'object' || (block as { type?: string }).type !== 'text') {\n      return block;\n    }\n    const textBlock = block as TextContent;\n    if (typeof textBlock.text !== 'string') {\n      return block;\n    }\n    const blockShare = textBlock.text.length / totalTextChars;\n    const defaultSuffix = suffixFactory(\n      Math.max(1, textBlock.text.length - Math.floor(maxChars * blockShare)),\n    );\n    const proportionalBudget = Math.floor(maxChars * blockShare);\n    const blockBudget = Math.max(\n      1,\n      Math.min(maxChars, Math.max(minKeepChars + defaultSuffix.length, proportionalBudget)),\n    );\n    return Object.assign({}, textBlock, {\n      text: truncateToolResultText(textBlock.text, blockBudget, {\n        suffix: suffixFactory,\n        minKeepChars,\n      }),\n    });\n  });\n\n  return { ...msg, content: newContent } as AgentMessage;\n}\n"],"mappings":"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"}
+{"version":3,"file":"tool-result-truncation.js","names":[],"sources":["../../../../src/agent/embedded/tool-result-truncation.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { TextContent } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { normalizeLowercaseStringOrEmpty } from '../../utils/string-coerce.js';\nimport { formatContextLimitTruncationNotice } from './tool-result-context-guard.js';\n\nconst MAX_TOOL_RESULT_CONTEXT_SHARE = 0.3;\n\nexport const DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS = 16_000;\nexport const HARD_MAX_TOOL_RESULT_CHARS = DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS;\n\nconst MIN_KEEP_CHARS = 2_000;\n\ntype ToolResultTruncationOptions = {\n  suffix?: string | ((truncatedChars: number) => string);\n  minKeepChars?: number;\n};\n\nconst DEFAULT_SUFFIX = (truncatedChars: number) => formatContextLimitTruncationNotice(truncatedChars);\n\nfunction resolveSuffixFactory(\n  suffix: ToolResultTruncationOptions['suffix'],\n): (truncatedChars: number) => string {\n  if (typeof suffix === 'function') {\n    return suffix;\n  }\n  if (typeof suffix === 'string') {\n    return () => suffix;\n  }\n  return DEFAULT_SUFFIX;\n}\n\nfunction resolveEffectiveMinKeepChars(params: {\n  maxChars: number;\n  minKeepChars: number;\n  suffixFactory: (truncatedChars: number) => string;\n}): number {\n  const suffixFloor = params.suffixFactory(1).length;\n  return Math.max(0, Math.min(params.minKeepChars, Math.max(0, params.maxChars - suffixFloor)));\n}\n\nfunction appendBoundedTruncationSuffix(params: {\n  keptText: string;\n  originalTextLength: number;\n  maxChars: number;\n  suffixFactory: (truncatedChars: number) => string;\n}): string {\n  const build = (keptText: string) =>\n    keptText + params.suffixFactory(Math.max(1, params.originalTextLength - keptText.length));\n\n  let keptText = params.keptText;\n  while (true) {\n    const finalText = build(keptText);\n    if (finalText.length <= params.maxChars) {\n      return finalText;\n    }\n    if (keptText.length === 0) {\n      return finalText.slice(0, params.maxChars);\n    }\n    const overflow = finalText.length - params.maxChars;\n    const nextKeptText = keptText.slice(0, Math.max(0, keptText.length - overflow));\n    keptText = nextKeptText.length < keptText.length ? nextKeptText : keptText.slice(0, -1);\n  }\n}\n\nconst MIDDLE_OMISSION_MARKER =\n  '\\n\\n[... middle content omitted — showing head and tail ...]\\n\\n';\n\nfunction hasImportantTail(text: string): boolean {\n  const tail = normalizeLowercaseStringOrEmpty(text.slice(-2000));\n  return (\n    /\\b(error|exception|failed|fatal|traceback|panic|stack trace|errno|exit code)\\b/.test(tail) ||\n    /\\}\\s*$/.test(tail.trim()) ||\n    /\\b(total|summary|result|complete|finished|done)\\b/.test(tail)\n  );\n}\n\nexport function truncateToolResultText(\n  text: string,\n  maxChars: number,\n  options: ToolResultTruncationOptions = {},\n): string {\n  const suffixFactory = resolveSuffixFactory(options.suffix);\n  const minKeepChars = resolveEffectiveMinKeepChars({\n    maxChars,\n    minKeepChars: options.minKeepChars ?? MIN_KEEP_CHARS,\n    suffixFactory,\n  });\n  if (text.length <= maxChars) {\n    return text;\n  }\n  const defaultSuffix = suffixFactory(Math.max(1, text.length - maxChars));\n  const budget = Math.max(minKeepChars, maxChars - defaultSuffix.length);\n\n  if (hasImportantTail(text) && budget > minKeepChars * 2) {\n    const tailBudget = Math.min(Math.floor(budget * 0.3), 4_000);\n    const headBudget = budget - tailBudget - MIDDLE_OMISSION_MARKER.length;\n\n    if (headBudget > minKeepChars) {\n      let headCut = headBudget;\n      const headNewline = text.lastIndexOf('\\n', headBudget);\n      if (headNewline > headBudget * 0.8) {\n        headCut = headNewline;\n      }\n\n      let tailStart = text.length - tailBudget;\n      const tailNewline = text.indexOf('\\n', tailStart);\n      if (tailNewline !== -1 && tailNewline < tailStart + tailBudget * 0.2) {\n        tailStart = tailNewline + 1;\n      }\n\n      const keptText = text.slice(0, headCut) + MIDDLE_OMISSION_MARKER + text.slice(tailStart);\n      return appendBoundedTruncationSuffix({\n        keptText,\n        originalTextLength: text.length,\n        maxChars,\n        suffixFactory,\n      });\n    }\n  }\n\n  let cutPoint = budget;\n  const lastNewline = text.lastIndexOf('\\n', budget);\n  if (lastNewline > budget * 0.8) {\n    cutPoint = lastNewline;\n  }\n  const keptText = text.slice(0, cutPoint);\n  return appendBoundedTruncationSuffix({\n    keptText,\n    originalTextLength: text.length,\n    maxChars,\n    suffixFactory,\n  });\n}\n\nexport function calculateMaxToolResultCharsWithCap(\n  contextWindowTokens: number,\n  hardCapChars: number,\n): number {\n  const maxTokens = Math.floor(contextWindowTokens * MAX_TOOL_RESULT_CONTEXT_SHARE);\n  const maxChars = maxTokens * 4;\n  return Math.min(maxChars, Math.max(1, hardCapChars));\n}\n\nexport function resolveLiveToolResultMaxChars(params: {\n  contextWindowTokens: number;\n  cfg?: Config;\n  agentId?: string | null;\n}): number {\n  const configuredCap = DEFAULT_MAX_LIVE_TOOL_RESULT_CHARS;\n  return calculateMaxToolResultCharsWithCap(params.contextWindowTokens, configuredCap);\n}\n\nexport function getToolResultTextLength(msg: AgentMessage): number {\n  if (!msg || (msg as { role?: string }).role !== 'toolResult') {\n    return 0;\n  }\n  const content = (msg as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return 0;\n  }\n  let totalLength = 0;\n  for (const block of content) {\n    if (block && typeof block === 'object' && (block as { type?: string }).type === 'text') {\n      const text = (block as TextContent).text;\n      if (typeof text === 'string') {\n        totalLength += text.length;\n      }\n    }\n  }\n  return totalLength;\n}\n\nexport function truncateToolResultMessage(\n  msg: AgentMessage,\n  maxChars: number,\n  options: ToolResultTruncationOptions = {},\n): AgentMessage {\n  const suffixFactory = resolveSuffixFactory(options.suffix);\n  const minKeepChars = resolveEffectiveMinKeepChars({\n    maxChars,\n    minKeepChars: options.minKeepChars ?? MIN_KEEP_CHARS,\n    suffixFactory,\n  });\n  const content = (msg as { content?: unknown }).content;\n  if (!Array.isArray(content)) {\n    return msg;\n  }\n\n  const totalTextChars = getToolResultTextLength(msg);\n  if (totalTextChars <= maxChars) {\n    return msg;\n  }\n\n  const newContent = content.map((block: unknown) => {\n    if (!block || typeof block !== 'object' || (block as { type?: string }).type !== 'text') {\n      return block;\n    }\n    const textBlock = block as TextContent;\n    if (typeof textBlock.text !== 'string') {\n      return block;\n    }\n    const blockShare = textBlock.text.length / totalTextChars;\n    const defaultSuffix = suffixFactory(\n      Math.max(1, textBlock.text.length - Math.floor(maxChars * blockShare)),\n    );\n    const proportionalBudget = Math.floor(maxChars * blockShare);\n    const blockBudget = Math.max(\n      1,\n      Math.min(maxChars, Math.max(minKeepChars + defaultSuffix.length, proportionalBudget)),\n    );\n    return Object.assign({}, textBlock, {\n      text: truncateToolResultText(textBlock.text, blockBudget, {\n        suffix: suffixFactory,\n        minKeepChars,\n      }),\n    });\n  });\n\n  return { ...msg, content: newContent } as AgentMessage;\n}\n"],"mappings":"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"}

package/dist/src/agent/fallback/candidates.js

@@ -24,8 +24,8 @@ function parseModelRef(raw, defaultProvider) {
 function resolveFallbackCandidates(params) {
 	const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;
 	const modelConfig = cfg?.agents?.defaults?.model;
-	const primaryRef = typeof modelConfig === "string" ? modelConfig : modelConfig?.primary;
-	const fallbacks = fallbacksOverride ?? (typeof modelConfig === "object" ? modelConfig.fallbacks : void 0);
+	const primaryRef = modelConfig?.primary;
+	const fallbacks = fallbacksOverride ?? modelConfig?.fallbacks;
 	const defaultParts = getDefaultModelParts(cfg);
 	const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));
 	const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;

package/dist/src/agent/fallback/candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"candidates.js","names":["parseModelRefUtil"],"sources":["../../../../src/agent/fallback/candidates.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { parseModelRef as parseModelRefUtil, normalizeProviderId } from '../models/selection.js';\n\nexport interface ModelCandidate {\n  provider: string;\n  model: string;\n}\n\nexport interface FallbackAttempt {\n  provider: string;\n  model: string;\n  error: string;\n  reason?: string;\n  status?: number;\n  code?: string;\n}\n\n// Get default model dynamically\nfunction getDefaultModelParts(config?: Config): { provider: string; model: string } {\n  const defaultModel = getDefaultModelSync(config);\n  const parts = defaultModel.split('/');\n  return {\n    provider: parts[0] || 'anthropic',\n    model: parts[1] || 'claude-sonnet-4-5',\n  };\n}\n\n/**\n * Parse model reference string into provider/model parts.\n * Uses the unified implementation from selection.ts.\n */\nfunction parseModelRef(raw: string, defaultProvider?: string): ModelCandidate | null {\n  const result = parseModelRefUtil(raw, defaultProvider);\n  if (!result) return null;\n  return {\n    provider: normalizeProviderId(result.provider),\n    model: result.model,\n  };\n}\n\nexport function resolveFallbackCandidates(params: {\n  cfg: Config | undefined;\n  provider: string;\n  model: string;\n  fallbacksOverride?: string[];\n}): ModelCandidate[] {\n  const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;\n\n  const modelConfig = cfg?.agents?.defaults?.model;\n  const primaryRef = typeof modelConfig === 'string' ? modelConfig : modelConfig?.primary;\n  const fallbacks = fallbacksOverride ?? (typeof modelConfig === 'object' ? modelConfig.fallbacks : undefined);\n\n  const defaultParts = getDefaultModelParts(cfg);\n  const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));\n  const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;\n  const model = inputModel.trim() || primaryResolved?.model || defaultParts.model;\n\n  const candidates: ModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const addCandidate = (c: ModelCandidate) => {\n    const key = `${c.provider}/${c.model}`.toLowerCase();\n    if (seen.has(key)) return;\n    // Skip providers that are not configured (no API key)\n    if (!isProviderConfiguredSync(c.provider)) return;\n    seen.add(key);\n    candidates.push(c);\n  };\n\n  addCandidate({ provider, model });\n\n  if (fallbacks) {\n    for (const fb of fallbacks) {\n      const resolved = parseModelRef(fb, provider);\n      if (resolved) addCandidate(resolved);\n    }\n  }\n\n  if (!fallbacksOverride && primaryResolved) {\n    addCandidate(primaryResolved);\n  }\n\n  return candidates;\n}\n"],"mappings":";;;gBACoE;AAmBpE,SAAS,qBAAqB,QAAsD;CAElF,MAAM,QADe,oBAAoB,OACf,CAAC,MAAM,IAAI;AACrC,QAAO;EACL,UAAU,MAAM,MAAM;EACtB,OAAO,MAAM,MAAM;EACpB;;;;;;AAOH,SAAS,cAAc,KAAa,iBAAiD;CACnF,MAAM,SAASA,gBAAkB,KAAK,gBAAgB;AACtD,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO;EACL,UAAU,oBAAoB,OAAO,SAAS;EAC9C,OAAO,OAAO;EACf;;AAGH,SAAgB,0BAA0B,QAKrB;CACnB,MAAM,EAAE,KAAK,UAAU,eAAe,OAAO,YAAY,sBAAsB;CAE/E,MAAM,cAAc,KAAK,QAAQ,UAAU;CAC3C,MAAM,aAAa,OAAO,gBAAgB,WAAW,cAAc,aAAa;CAChF,MAAM,YAAY,sBAAsB,OAAO,gBAAgB,WAAW,YAAY,YAAY,KAAA;CAElG,MAAM,eAAe,qBAAqB,IAAI;CAC9C,MAAM,kBAAkB,cAAc,cAAc,oBAAoB,IAAI,CAAC;CAC7E,MAAM,WAAW,cAAc,MAAM,IAAI,iBAAiB,YAAY,aAAa;CACnF,MAAM,QAAQ,WAAW,MAAM,IAAI,iBAAiB,SAAS,aAAa;CAE1E,MAAM,aAA+B,EAAE;CACvC,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,gBAAgB,MAAsB;EAC1C,MAAM,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,aAAa;AACpD,MAAI,KAAK,IAAI,IAAI,CAAE;AAEnB,MAAI,CAAC,yBAAyB,EAAE,SAAS,CAAE;AAC3C,OAAK,IAAI,IAAI;AACb,aAAW,KAAK,EAAE;;AAGpB,cAAa;EAAE;EAAU;EAAO,CAAC;AAEjC,KAAI,UACF,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,WAAW,cAAc,IAAI,SAAS;AAC5C,MAAI,SAAU,cAAa,SAAS;;AAIxC,KAAI,CAAC,qBAAqB,gBACxB,cAAa,gBAAgB;AAG/B,QAAO"}
+{"version":3,"file":"candidates.js","names":["parseModelRefUtil"],"sources":["../../../../src/agent/fallback/candidates.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { isProviderConfiguredSync } from '../../providers/index.js';\nimport { getDefaultModelSync } from '../../providers/index.js';\nimport { parseModelRef as parseModelRefUtil, normalizeProviderId } from '../models/selection.js';\n\nexport interface ModelCandidate {\n  provider: string;\n  model: string;\n}\n\nexport interface FallbackAttempt {\n  provider: string;\n  model: string;\n  error: string;\n  reason?: string;\n  status?: number;\n  code?: string;\n}\n\n// Get default model dynamically\nfunction getDefaultModelParts(config?: Config): { provider: string; model: string } {\n  const defaultModel = getDefaultModelSync(config);\n  const parts = defaultModel.split('/');\n  return {\n    provider: parts[0] || 'anthropic',\n    model: parts[1] || 'claude-sonnet-4-5',\n  };\n}\n\n/**\n * Parse model reference string into provider/model parts.\n * Uses the unified implementation from selection.ts.\n */\nfunction parseModelRef(raw: string, defaultProvider?: string): ModelCandidate | null {\n  const result = parseModelRefUtil(raw, defaultProvider);\n  if (!result) return null;\n  return {\n    provider: normalizeProviderId(result.provider),\n    model: result.model,\n  };\n}\n\nexport function resolveFallbackCandidates(params: {\n  cfg: Config | undefined;\n  provider: string;\n  model: string;\n  fallbacksOverride?: string[];\n}): ModelCandidate[] {\n  const { cfg, provider: inputProvider, model: inputModel, fallbacksOverride } = params;\n\n  const modelConfig = cfg?.agents?.defaults?.model;\n  const primaryRef = modelConfig?.primary;\n  const fallbacks = fallbacksOverride ?? modelConfig?.fallbacks;\n\n  const defaultParts = getDefaultModelParts(cfg);\n  const primaryResolved = parseModelRef(primaryRef || getDefaultModelSync(cfg));\n  const provider = inputProvider.trim() || primaryResolved?.provider || defaultParts.provider;\n  const model = inputModel.trim() || primaryResolved?.model || defaultParts.model;\n\n  const candidates: ModelCandidate[] = [];\n  const seen = new Set<string>();\n\n  const addCandidate = (c: ModelCandidate) => {\n    const key = `${c.provider}/${c.model}`.toLowerCase();\n    if (seen.has(key)) return;\n    // Skip providers that are not configured (no API key)\n    if (!isProviderConfiguredSync(c.provider)) return;\n    seen.add(key);\n    candidates.push(c);\n  };\n\n  addCandidate({ provider, model });\n\n  if (fallbacks) {\n    for (const fb of fallbacks) {\n      const resolved = parseModelRef(fb, provider);\n      if (resolved) addCandidate(resolved);\n    }\n  }\n\n  if (!fallbacksOverride && primaryResolved) {\n    addCandidate(primaryResolved);\n  }\n\n  return candidates;\n}\n"],"mappings":";;;gBACoE;AAmBpE,SAAS,qBAAqB,QAAsD;CAElF,MAAM,QADe,oBAAoB,OACf,CAAC,MAAM,IAAI;AACrC,QAAO;EACL,UAAU,MAAM,MAAM;EACtB,OAAO,MAAM,MAAM;EACpB;;;;;;AAOH,SAAS,cAAc,KAAa,iBAAiD;CACnF,MAAM,SAASA,gBAAkB,KAAK,gBAAgB;AACtD,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO;EACL,UAAU,oBAAoB,OAAO,SAAS;EAC9C,OAAO,OAAO;EACf;;AAGH,SAAgB,0BAA0B,QAKrB;CACnB,MAAM,EAAE,KAAK,UAAU,eAAe,OAAO,YAAY,sBAAsB;CAE/E,MAAM,cAAc,KAAK,QAAQ,UAAU;CAC3C,MAAM,aAAa,aAAa;CAChC,MAAM,YAAY,qBAAqB,aAAa;CAEpD,MAAM,eAAe,qBAAqB,IAAI;CAC9C,MAAM,kBAAkB,cAAc,cAAc,oBAAoB,IAAI,CAAC;CAC7E,MAAM,WAAW,cAAc,MAAM,IAAI,iBAAiB,YAAY,aAAa;CACnF,MAAM,QAAQ,WAAW,MAAM,IAAI,iBAAiB,SAAS,aAAa;CAE1E,MAAM,aAA+B,EAAE;CACvC,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,gBAAgB,MAAsB;EAC1C,MAAM,MAAM,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,aAAa;AACpD,MAAI,KAAK,IAAI,IAAI,CAAE;AAEnB,MAAI,CAAC,yBAAyB,EAAE,SAAS,CAAE;AAC3C,OAAK,IAAI,IAAI;AACb,aAAW,KAAK,EAAE;;AAGpB,cAAa;EAAE;EAAU;EAAO,CAAC;AAEjC,KAAI,UACF,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,WAAW,cAAc,IAAI,SAAS;AAC5C,MAAI,SAAU,cAAa,SAAS;;AAIxC,KAAI,CAAC,qBAAqB,gBACxB,cAAa,gBAAgB;AAG/B,QAAO"}

package/dist/src/agent/goals/goal-locale.d.ts

@@ -3,7 +3,7 @@ import { goalsEvaluateCopy, JUDGE_REASON_EN, type JudgeReasonId } from '../../i1
 import { normalizeServerLocale, type ServerLocale, serverLocaleOrFallback, isServerLocale } from '../../i18n/locale.js';
 export declare const GOAL_UI_LOCALES: readonly ["en", "zh"];
 export type GoalUiLocale = ServerLocale;
-export declare const DEFAULT_GOAL_UI_LOCALE: "zh" | "en";
+export declare const DEFAULT_GOAL_UI_LOCALE: "en" | "zh";
 export declare const isGoalUiLocale: typeof isServerLocale;
 export declare const normalizeGoalUiLocale: typeof normalizeServerLocale;
 export declare const goalUiLocaleOrFallback: typeof serverLocaleOrFallback;