@xopcai/xopc 0.0.87 → 0.0.89

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/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":";;;;;;;;;;aAGqD;AAiBrD,MAAM,MAAM,aAAa,cAAc;AACvC,MAAM,wBAAwB;AAE9B,SAAS,eAAe,OAAe,WAAW,uBAA+B;AAC/E,QAAO,MAAM,SAAS,WAAW,GAAG,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK;;AAGpE,SAAS,uBAAuB,SAA0B;AACxD,KAAI,OAAO,YAAY,SACrB,QAAO;AAET,KAAI,CAAC,MAAM,QAAQ,QAAQ,CACzB,QAAO;AAET,QAAO,QACJ,QAAQ,UAAmD;AAC1D,SAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAa,MAA4B,SAAS;GACrF,CACD,KAAK,UAAU,MAAM,KAAK,CAC1B,KAAK,GAAG;;AAGb,SAAS,uBAAuB,UAA6E;CAC3G,MAAM,QAA0B,EAAE;AAClC,MAAK,MAAM,WAAW,UAAU;AAC9B,MAAI,QAAQ,SAAS,eAAe,CAAC,MAAM,QAAQ,QAAQ,QAAQ,CAAE;AACrE,OAAK,MAAM,SAAS,QAAQ,QAC1B,KAAI,SAAS,OAAO,UAAU,YAAa,MAA4B,SAAS,YAAY;GAC1F,MAAM,WAAW;AACjB,SAAM,KAAK;IAAE,MAAM,SAAS;IAAM,QAAQ,SAAS;IAAW,CAAC;;;AAIrE,QAAO;;AAGT,SAAS,0BAA0B,UAA+E;AAChH,MAAK,IAAI,eAAe,SAAS,SAAS,GAAG,gBAAgB,GAAG,gBAAgB;EAC9E,MAAM,UAAU,SAAS;AACzB,MAAI,SAAS,SAAS,OACpB;EAEF,MAAM,OAAO,uBAAuB,QAAQ,QAAQ,CAAC,MAAM;AAC3D,SAAO,OAAO,eAAe,KAAK,GAAG,KAAA;;;AAKzC,SAAS,qBAAqB,OAA+B,UAA8B;AACzF,KAAI,CAAC,OAAO,MAAM,CAAC,OAAO,SACxB,OAAM,IAAI,MAAM,mCAAmC,WAAW;AAEhE,QAAO;;AAGT,SAAS,wBAAwB,SAA+B;CAC9D,MAAM,UAAW,QAAkC;AACnD,KAAI,OAAO,YAAY,SACrB,QAAO;AAET,KAAI,MAAM,QAAQ,QAAQ,CACxB,QAAO,QACJ,QAAQ,MAA2C,CAAC,CAAC,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAAO,CAC5H,KAAK,MAAM,EAAE,KAAK,CAClB,KAAK,GAAG;AAEb,QAAO;;AAGT,eAAsB,oBAAoB,QAAuE;CAC/G,MAAM,EACJ,YACA,OACA,aACA,OACA,OACA,cACA,eACA,cACA,cACA,YACE;CAEJ,MAAM,YAAY,OAAO,aAAa,2BAA2B;CACjE,MAAM,gBAAgB,qBAAqB,OAAO,OAAO,SAAS;CAClE,MAAM,aAAa,MAAM,gCAAgC,cAAc,WAAW;CAElF,IAAI;CACJ,IAAI;AAEJ,KAAI;AACF,WAAS,MAAM,6BAA6B;GAC1C;GACA,WAAW,WAAW;GACtB,aAAa,WAAW;GACxB,aAAa,WAAW;GACxB,gBAAgB,WAAW;GAC3B;GACA,OAAO;GACP,UAAU,OAAO;GACjB;GACA;GACA,eAAe,iBAAiB;GACjC,CAAC;EAEF,MAAM,EAAE,SAAS,WAAW;EAE5B,MAAM,6BAA6B,8BAA8B,QAAQ,MAAM,SAAS;EACxF,MAAM,mBAAkD,aAAa,SAAS,YAAY;GAExF,MAAM,YAAY,gBADM,uBAAuB,QAAQ,SACN,CAAC;GAElD,IAAI,mBAAmB;AACvB,OAAI,UAAU,aAAa,UAAU,YAAY,OAAO,GAAG;IACzD,MAAM,WAAW,UAAU,YACvB,CAAC,GAAG,QAAQ,UAAU;KAAE,MAAM;KAAiB,SAAS,UAAU;KAAW,WAAW,KAAK,KAAK;KAAE,CAAC,GACrG,QAAQ;IAEZ,MAAM,eAAe,UAAU,YAAY,OAAO,KAAK,QAAQ,QAC3D,QAAQ,MAAM,QAAQ,MAAM,CAAC,UAAU,YAAY,IAAI,EAAE,KAAK,CAAC,GAC/D,QAAQ;AAEZ,uBAAmB;KAAE,GAAG;KAAS;KAAU,OAAO;KAAc;;AAGlE,OAAI,MACF;IACE;IACA;IACA,cAAc;IACd,UAAU,GAAG,YAAY,SAAS,GAAG,YAAY;IACjD,oBAAoB,iBAAiB,cAAc,UAAU;IAC7D,cAAc,iBAAiB,SAAS;IACxC,WAAW,iBAAiB,OAAO,UAAU;IAC7C,wBAAwB,0BAA0B,iBAAiB,SAAS;IAC5E,qBAAqB,CAAC,CAAC,UAAU;IACjC,iBAAiB,UAAU,YAAY;IACxC,EACD,yBACD;AACD,UAAO,2BAA2B,aAAa,kBAAkB,QAAQ;;AAE3E,UAAQ,MAAM,WAAW;AAEzB,MAAI,QACF,eAAc,+BAA+B,SAAS,QAAQ;EAGhE,MAAM,SAAS;GACb;GACA,WAAW,WAAW;GACtB;GACA;GACA,OAAO,YAAY;AACjB,UAAM,QAAQ,OAAO;;GAExB;AACD,sBAAoB,OAAO;EAE3B,MAAM,sBAAsB;AACrB,WAAQ,OAAO;;AAEtB,MAAI,OAAO,aAAa;AACtB,OAAI,OAAO,YAAY,SAAS;AAC9B,UAAM,QAAQ,OAAO;AACrB,WAAO;KAAE,IAAI;KAAO,cAAc;KAAW;;AAE/C,UAAO,YAAY,iBAAiB,SAAS,eAAe,EAAE,MAAM,MAAM,CAAC;;AAG7E,MAAI;AACF,SAAM,wBACJ,QAAQ,OACR,YAAY;IACV,MAAM,OAAO,wBAAwB,YAAY;AACjD,UAAM,QAAQ,OAAO,MAAM,OAAO,QAAQ,SAAS,EAAE,QAAQ,OAAO,QAAQ,GAAG,KAAA,EAAU;AACzF,UAAM,QAAQ,MAAM,aAAa;AACjC,UAAM,uCAAuC,QAAQ,OAAO;KAAE;KAAY;KAAK,CAAC;MAElF,UACD;AAED,OAAI,uBAAuB,QAAQ,MAAM,CACvC,QAAO;IAAE,IAAI;IAAM,mBAAmB,uBAAuB,QAAQ;IAAE;AAEzE,OAAI,sBAAsB,QAAQ,MAAM,CACtC,QAAO;IACL,IAAI;IACJ,cAAc;IACd,mBAAmB,uBAAuB,QAAQ;IACnD;AAGH,UAAO;IAAE,IAAI;IAAM,mBAAmB,uBAAuB,QAAQ;IAAE;YAC/D;AACR,UAAO,aAAa,oBAAoB,SAAS,cAAc;AAC/D,yBAAsB,OAAO;;UAExB,KAAK;EACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,MAAI,MAAM;GAAE;GAAK;GAAY;GAAO,EAAE,wBAAwB,KAAK;AACnE,YAAU;GAAE,MAAM;GAAS,SAAS;GAAI,CAAC;AACzC,SAAO;GAAE,IAAI;GAAO,cAAc;GAAI;WAC9B;AACR,iBAAe;AACf,MAAI;AACF,WAAQ,KAAK,2BAA2B;UAClC;AAGR,UAAQ,SAAS"}
+{"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/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;

package/dist/src/agent/inbound/turn-dispatcher.js

@@ -99,8 +99,8 @@ var TurnDispatcher = class {
 			},
 			maybeEmitWebchatTts: (sk, hadVoice) => maybeEmitWebchatTts({
 				config: c.getConfig(),
-				agentManager: c.agentManager,
 				sessionStore: c.sessionStore,
+				getLastAssistantPlainText: (sessionKey) => c.sessionState.getLastAssistantText(sessionKey) ?? c.agentManager.getLastAssistantContent(sessionKey) ?? "",
 				log: this.log
 			}, sk, hadVoice),
 			endDirectRequestContext: c.endDirectRequestContext,

package/dist/src/agent/inbound/turn-dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-dispatcher.js","names":[],"sources":["../../../../src/agent/inbound/turn-dispatcher.ts"],"sourcesContent":["/**\n * TurnDispatcher — single entry point for direct (non-bus) agent turns.\n *\n * Wraps the two existing direct-turn runners (one-shot and streaming) so the\n * parent `AgentService` no longer carries a pair of huge `createXxxDeps()`\n * factories. The public surface — `processDirect`, `processDirectStreaming`,\n * `steerWebchatSession`, `enqueueWebchatSseEvent`,\n * `notifyWebchatTranscriptAppend` — matches what `AgentService` exposed\n * previously, so callers (gateway, CLI) are unchanged.\n *\n * Like `OutboundCoordinator` and `InboundLoop`, this class accepts a wide\n * dependency bag in its constructor (the direct-turn pipeline touches almost\n * every other subsystem). The win is that AgentService becomes the only place\n * that wires those dependencies together; individual responsibilities now live\n * in their own classes and are unit-testable.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionConfigStore } from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type {\n  SessionContext,\n  SessionHydrator,\n  SessionStateBag,\n} from '../session/index.js';\nimport { queueEmbeddedSteer } from '../embedded/runs.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport {\n  buildDirectUserMessageContent,\n  type DirectInboundAttachment,\n} from '../service/build-direct-message-content.js';\nimport {\n  runProcessDirectStreaming,\n  type ProcessDirectStreamingDeps,\n  type ProcessDirectStreamingSseEvent,\n} from '../service/process-direct-streaming.js';\nimport {\n  runProcessDirect,\n  type RunProcessDirectDeps,\n} from '../service/process-direct-one-shot.js';\nimport { maybeEmitWebchatTts } from '../service/webchat-tts.js';\n\nexport interface TurnDispatcherConfig {\n  log: ContextualLogger;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionConfigStore: SessionConfigStore;\n  sessionState: SessionStateBag;\n  commandHandler: CommandHandler;\n  getConfig: () => Config | undefined;\n  /** Strict accessor — required for direct-turn paths that must have a config. */\n  requireConfig: () => Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  /** Establish per-session context (also creates the Agent + subscribes to events). */\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;\n  /** Per-session config hydration: workspace, model, thinking. */\n  sessionHydrator: SessionHydrator;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  endDirectRequestContext: () => void;\n  /** Gateway hook fired after assistant text lands on disk (UI refetch). */\n  onSessionTranscriptUpdated?: (sessionKey: string) => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n}\n\nexport type DirectAttachment = DirectInboundAttachment;\n\nexport class TurnDispatcher {\n  private readonly cfg: TurnDispatcherConfig;\n  private readonly log: ContextualLogger;\n\n  constructor(cfg: TurnDispatcherConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  /** One-shot direct turn (CLI / embedded TUI). */\n  processDirect(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n  ): Promise<string> {\n    return runProcessDirect(this.buildOneShotDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n    });\n  }\n\n  /** Streaming direct turn (webchat SSE / CLI streaming). */\n  async *processDirectStreaming(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n    options?: { signal?: AbortSignal },\n  ): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n    yield* runProcessDirectStreaming(this.buildStreamingDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n      signal: options?.signal,\n    });\n  }\n\n  /** Push an out-of-band event into the live webchat stream for a session. */\n  enqueueWebchatSseEvent(\n    sessionKey: string,\n    event: { type: string; [key: string]: unknown },\n  ): void {\n    const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);\n    if (pub) {\n      pub(event);\n    }\n  }\n\n  /** Stream assistant text to live webchat session + notify transcript listeners. */\n  notifyWebchatTranscriptAppend(sessionKey: string, assistantText: string): void {\n    const trimmed = assistantText.trim();\n    if (trimmed) {\n      this.enqueueWebchatSseEvent(sessionKey, { type: 'token', content: trimmed });\n    }\n    this.cfg.onSessionTranscriptUpdated?.(sessionKey);\n  }\n\n  /**\n   * Queue a steering user message into pi-agent's in-flight run (delivered\n   * after current tool work, before the next LLM call). See `Agent.steer`\n   * in `@earendil-works/pi-agent-core`.\n   */\n  async steerWebchatSession(sessionKey: string, text: string): Promise<boolean> {\n    const trimmed = text.trim();\n    if (!trimmed) return false;\n    try {\n      return await queueEmbeddedSteer(sessionKey, trimmed);\n    } catch (err) {\n      this.log.warn({ err, sessionKey }, 'steerWebchatSession failed');\n      return false;\n    }\n  }\n\n  private buildStreamingDeps(): ProcessDirectStreamingDeps {\n    const c = this.cfg;\n    return {\n      log: this.log,\n      parseSessionKey: c.parseSessionKey,\n      initDirectStreamingSession: c.initSessionContext,\n      registerWebchatSsePublisher: (sk, publisher) =>\n        c.sessionState.registerWebchatPublisher(sk, publisher),\n      unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),\n      agentManager: c.agentManager,\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      getConfig: c.getConfig,\n      sessionConfigStore: c.sessionConfigStore,\n      attachmentRootsForSession: c.attachmentRootsForSession,\n      commandHandler: c.commandHandler,\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      buildMessageContent: (text, prepared, sk) =>\n        buildDirectUserMessageContent({\n          content: text,\n          attachments: prepared,\n          sessionKey: sk,\n          config: c.requireConfig(),\n          agentManager: c.agentManager,\n          modelManager: c.modelManager,\n        }),\n      recordPersistentGoalStreamOutcome: (sk, o) =>\n        c.sessionState.recordPersistentGoalStreamOutcome(sk, o),\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      reloadWebchatTranscript: (sk) => {\n        c.onSessionTranscriptUpdated?.(sk);\n      },\n      maybeEmitWebchatTts: (sk, hadVoice) =>\n        maybeEmitWebchatTts(\n          {\n            config: c.getConfig(),\n            agentManager: c.agentManager,\n            sessionStore: c.sessionStore,\n            log: this.log,\n          },\n          sk,\n          hadVoice,\n        ),\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n\n  private buildOneShotDeps(): RunProcessDirectDeps {\n    const c = this.cfg;\n    const cfg = c.requireConfig();\n    return {\n      log: this.log,\n      config: cfg,\n      parseSessionKey: c.parseSessionKey,\n      initSessionContext: (sk, channel, chatId) => {\n        void c.initSessionContext(sk, channel, chatId);\n      },\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      agentManager: c.agentManager,\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      commandHandler: c.commandHandler,\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"turn-dispatcher.js","names":[],"sources":["../../../../src/agent/inbound/turn-dispatcher.ts"],"sourcesContent":["/**\n * TurnDispatcher — single entry point for direct (non-bus) agent turns.\n *\n * Wraps the two existing direct-turn runners (one-shot and streaming) so the\n * parent `AgentService` no longer carries a pair of huge `createXxxDeps()`\n * factories. The public surface — `processDirect`, `processDirectStreaming`,\n * `steerWebchatSession`, `enqueueWebchatSseEvent`,\n * `notifyWebchatTranscriptAppend` — matches what `AgentService` exposed\n * previously, so callers (gateway, CLI) are unchanged.\n *\n * Like `OutboundCoordinator` and `InboundLoop`, this class accepts a wide\n * dependency bag in its constructor (the direct-turn pipeline touches almost\n * every other subsystem). The win is that AgentService becomes the only place\n * that wires those dependencies together; individual responsibilities now live\n * in their own classes and are unit-testable.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionConfigStore } from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type {\n  SessionContext,\n  SessionHydrator,\n  SessionStateBag,\n} from '../session/index.js';\nimport { queueEmbeddedSteer } from '../embedded/runs.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport {\n  buildDirectUserMessageContent,\n  type DirectInboundAttachment,\n} from '../service/build-direct-message-content.js';\nimport {\n  runProcessDirectStreaming,\n  type ProcessDirectStreamingDeps,\n  type ProcessDirectStreamingSseEvent,\n} from '../service/process-direct-streaming.js';\nimport {\n  runProcessDirect,\n  type RunProcessDirectDeps,\n} from '../service/process-direct-one-shot.js';\nimport { maybeEmitWebchatTts } from '../service/webchat-tts.js';\n\nexport interface TurnDispatcherConfig {\n  log: ContextualLogger;\n  agentManager: AgentManager;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionConfigStore: SessionConfigStore;\n  sessionState: SessionStateBag;\n  commandHandler: CommandHandler;\n  getConfig: () => Config | undefined;\n  /** Strict accessor — required for direct-turn paths that must have a config. */\n  requireConfig: () => Config;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  /** Establish per-session context (also creates the Agent + subscribes to events). */\n  initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;\n  /** Per-session config hydration: workspace, model, thinking. */\n  sessionHydrator: SessionHydrator;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectInboundAttachment[],\n  ) => Promise<DirectInboundAttachment[] | undefined>;\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  endDirectRequestContext: () => void;\n  /** Gateway hook fired after assistant text lands on disk (UI refetch). */\n  onSessionTranscriptUpdated?: (sessionKey: string) => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n}\n\nexport type DirectAttachment = DirectInboundAttachment;\n\nexport class TurnDispatcher {\n  private readonly cfg: TurnDispatcherConfig;\n  private readonly log: ContextualLogger;\n\n  constructor(cfg: TurnDispatcherConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  /** One-shot direct turn (CLI / embedded TUI). */\n  processDirect(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n  ): Promise<string> {\n    return runProcessDirect(this.buildOneShotDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n    });\n  }\n\n  /** Streaming direct turn (webchat SSE / CLI streaming). */\n  async *processDirectStreaming(\n    content: string,\n    sessionKey = 'agent:main:main',\n    attachments?: DirectAttachment[],\n    thinking?: string,\n    options?: { signal?: AbortSignal },\n  ): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n    yield* runProcessDirectStreaming(this.buildStreamingDeps(), {\n      content,\n      sessionKey,\n      attachments,\n      thinking,\n      signal: options?.signal,\n    });\n  }\n\n  /** Push an out-of-band event into the live webchat stream for a session. */\n  enqueueWebchatSseEvent(\n    sessionKey: string,\n    event: { type: string; [key: string]: unknown },\n  ): void {\n    const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);\n    if (pub) {\n      pub(event);\n    }\n  }\n\n  /** Stream assistant text to live webchat session + notify transcript listeners. */\n  notifyWebchatTranscriptAppend(sessionKey: string, assistantText: string): void {\n    const trimmed = assistantText.trim();\n    if (trimmed) {\n      this.enqueueWebchatSseEvent(sessionKey, { type: 'token', content: trimmed });\n    }\n    this.cfg.onSessionTranscriptUpdated?.(sessionKey);\n  }\n\n  /**\n   * Queue a steering user message into pi-agent's in-flight run (delivered\n   * after current tool work, before the next LLM call). See `Agent.steer`\n   * in `@earendil-works/pi-agent-core`.\n   */\n  async steerWebchatSession(sessionKey: string, text: string): Promise<boolean> {\n    const trimmed = text.trim();\n    if (!trimmed) return false;\n    try {\n      return await queueEmbeddedSteer(sessionKey, trimmed);\n    } catch (err) {\n      this.log.warn({ err, sessionKey }, 'steerWebchatSession failed');\n      return false;\n    }\n  }\n\n  private buildStreamingDeps(): ProcessDirectStreamingDeps {\n    const c = this.cfg;\n    return {\n      log: this.log,\n      parseSessionKey: c.parseSessionKey,\n      initDirectStreamingSession: c.initSessionContext,\n      registerWebchatSsePublisher: (sk, publisher) =>\n        c.sessionState.registerWebchatPublisher(sk, publisher),\n      unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),\n      agentManager: c.agentManager,\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      getConfig: c.getConfig,\n      sessionConfigStore: c.sessionConfigStore,\n      attachmentRootsForSession: c.attachmentRootsForSession,\n      commandHandler: c.commandHandler,\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      buildMessageContent: (text, prepared, sk) =>\n        buildDirectUserMessageContent({\n          content: text,\n          attachments: prepared,\n          sessionKey: sk,\n          config: c.requireConfig(),\n          agentManager: c.agentManager,\n          modelManager: c.modelManager,\n        }),\n      recordPersistentGoalStreamOutcome: (sk, o) =>\n        c.sessionState.recordPersistentGoalStreamOutcome(sk, o),\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      reloadWebchatTranscript: (sk) => {\n        c.onSessionTranscriptUpdated?.(sk);\n      },\n      maybeEmitWebchatTts: (sk, hadVoice) =>\n        maybeEmitWebchatTts(\n          {\n            config: c.getConfig(),\n            sessionStore: c.sessionStore,\n            getLastAssistantPlainText: (sessionKey) =>\n              c.sessionState.getLastAssistantText(sessionKey) ??\n              c.agentManager.getLastAssistantContent(sessionKey) ??\n              '',\n            log: this.log,\n          },\n          sk,\n          hadVoice,\n        ),\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n\n  private buildOneShotDeps(): RunProcessDirectDeps {\n    const c = this.cfg;\n    const cfg = c.requireConfig();\n    return {\n      log: this.log,\n      config: cfg,\n      parseSessionKey: c.parseSessionKey,\n      initSessionContext: (sk, channel, chatId) => {\n        void c.initSessionContext(sk, channel, chatId);\n      },\n      hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),\n      hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),\n      agentManager: c.agentManager,\n      sessionStore: c.sessionStore,\n      modelManager: c.modelManager,\n      applyResolvedThinkingLevel: (sk, t) => c.sessionHydrator.thinking(sk, t),\n      prepareInboundAttachments: c.prepareInboundAttachments,\n      commandHandler: c.commandHandler,\n      onTurnComplete: (sk, text) => {\n        if (text) {\n          c.sessionState.setLastAssistantText(sk, text);\n        }\n        c.enqueueMaybeAutoTitleAfterPersist(sk);\n      },\n      endDirectRequestContext: c.endDirectRequestContext,\n      resetSession: c.resetSession,\n    };\n  }\n}\n"],"mappings":"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"}

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

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

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

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

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

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

package/dist/src/agent/service/process-direct-streaming.js

@@ -1,4 +1,5 @@
 import { appendPiTranscriptMessage } from "../../session/parity/jsonl-transcript-io.js";
+import { formatAgentRunErrorForClient } from "../client-error-format.js";
 import { resolveEffectiveReasoningLevel } from "../../session/thinking-resolve.js";
 import { initSessionTurn } from "../../session/init-session-turn.js";
 import "../../session/index.js";
@@ -19,6 +20,18 @@ async function* runProcessDirectStreaming(deps, input) {
 		const visible = applyReasoningVisibilityToSseEvent(event, reasoningLevel);
 		if (visible !== null) queue.push(visible);
 	};
+	const formatStreamError = (raw) => {
+		let provider;
+		let modelRef;
+		try {
+			provider = deps.modelManager.getResolvedModelForSession(sessionKey).provider;
+			modelRef = deps.modelManager.getModelForSession(sessionKey);
+		} catch {}
+		return formatAgentRunErrorForClient(raw, {
+			provider,
+			modelRef
+		});
+	};
 	if (channel === "webchat") deps.registerWebchatSsePublisher(sessionKey, pushVisible);
 	const signal = input.signal;
 	let userAborted = false;
@@ -149,18 +162,21 @@ async function* runProcessDirectStreaming(deps, input) {
 				abortSignal: signal,
 				onEvent: (embeddedEvent) => {
 					const mapped = mapEmbeddedEventToGatewaySse(embeddedEvent);
-					if (mapped) pushVisible(mapped);
+					if (mapped) {
+						if (mapped.type === "error" && typeof mapped.content === "string") mapped.content = formatStreamError(mapped.content);
+						pushVisible(mapped);
+					}
 				}
 			});
 			if (result.lastAssistantText) deps.onTurnComplete?.(sessionKey, result.lastAssistantText);
 			if (!result.ok && result.errorMessage && !abortHandled) pushVisible({
 				type: "error",
-				content: result.errorMessage
+				content: formatStreamError(result.errorMessage)
 			});
 		} catch (err) {
 			if (!abortHandled) pushVisible({
 				type: "error",
-				content: err instanceof Error ? err.message : String(err)
+				content: formatStreamError(err instanceof Error ? err.message : String(err))
 			});
 		} finally {
 			queue.close();

package/dist/src/agent/service/process-direct-streaming.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-direct-streaming.js","names":[],"sources":["../../../../src/agent/service/process-direct-streaming.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport {\n  isVoiceLikeAttachment,\n  mergeVoiceTranscriptsIntoUserText,\n  mergeSttConfigFromAppConfig,\n} from '../../channels/attachments/voice-stt-webchat.js';\nimport {\n  resolveEffectiveReasoningLevel,\n  initSessionTurn,\n  type SessionConfigStore,\n  type SessionStore,\n} from '../../session/index.js';\nimport { appendPiTranscriptMessage } from '../../session/parity/jsonl-transcript-io.js';\nimport type { SessionContext } from '../session/index.js';\nimport { applyReasoningVisibilityToSseEvent } from '../streaming/reasoning-visibility-sse.js';\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\nimport { abortEmbeddedRun } from '../embedded/runs.js';\nimport { mapEmbeddedEventToGatewaySse } from '../embedded/map-stream-events.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\n\nimport { AsyncQueue } from './async-queue.js';\nimport {\n  hydratePerTurnState,\n  runDirectAgentTurn,\n  tryRunSlashCommand,\n} from './direct-turn-helpers.js';\n\nexport type DirectStreamInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\nexport type ProcessDirectStreamLog = {\n  info: (obj: Record<string, unknown>, msg: string) => void;\n  warn: (obj: Record<string, unknown>, msg: string) => void;\n  debug?: (obj: Record<string, unknown>, msg: string) => void;\n};\n\nexport interface ProcessDirectStreamingDeps {\n  log: ProcessDirectStreamLog;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initDirectStreamingSession: (\n    sessionKey: string,\n    channel: string,\n    chatId: string,\n  ) => SessionContext;\n  registerWebchatSsePublisher: (\n    sessionKey: string,\n    publisher: (event: { type: string; [key: string]: unknown }) => void,\n  ) => void;\n  unregisterWebchatSsePublisher: (sessionKey: string) => void;\n  agentManager: AgentInstanceGateway;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  getConfig: () => Config | undefined;\n  sessionConfigStore: SessionConfigStore;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectStreamInboundAttachment[],\n  ) => Promise<DirectStreamInboundAttachment[] | undefined>;\n  buildMessageContent: (\n    content: string,\n    attachments: DirectStreamInboundAttachment[] | undefined,\n    sessionKey: string,\n  ) => Promise<Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>>;\n  recordPersistentGoalStreamOutcome?: (\n    sessionKey: string,\n    outcome: { skipPersistentGoalPostTurn: boolean },\n  ) => void;\n  onTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n  /** Disk-only transcript sync (slash receipt already streamed as tokens). */\n  reloadWebchatTranscript?: (sessionKey: string) => void;\n  maybeEmitWebchatTts: (\n    sessionKey: string,\n    hadInboundVoice: boolean,\n  ) => Promise<{ type: 'tts_audio'; workspaceRelativePath: string; mimeType: string; name: string } | null>;\n  endDirectRequestContext: () => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n}\n\nexport interface ProcessDirectStreamingInput {\n  content: string;\n  sessionKey?: string;\n  attachments?: DirectStreamInboundAttachment[];\n  thinking?: string;\n  signal?: AbortSignal;\n}\n\nexport type ProcessDirectStreamingSseEvent = { type: string; [key: string]: unknown };\n\nexport async function* runProcessDirectStreaming(\n  deps: ProcessDirectStreamingDeps,\n  input: ProcessDirectStreamingInput,\n): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n  const sessionKey = input.sessionKey ?? 'agent:main:main';\n  const { channel, chatId } = deps.parseSessionKey(sessionKey);\n  const context = deps.initDirectStreamingSession(sessionKey, channel, chatId);\n\n  const queue = new AsyncQueue<ProcessDirectStreamingSseEvent>();\n  let reasoningLevel: ReasoningLevel = 'stream';\n\n  const pushVisible = (event: ProcessDirectStreamingSseEvent) => {\n    const visible = applyReasoningVisibilityToSseEvent(event, reasoningLevel);\n    if (visible !== null) {\n      queue.push(visible);\n    }\n  };\n\n  if (channel === 'webchat') {\n    deps.registerWebchatSsePublisher(sessionKey, pushVisible);\n  }\n\n  const signal = input.signal;\n  let userAborted = false;\n  let abortHandled = false;\n  let inboundVoice = false;\n  let ranSlashCommand = false;\n  let mergedUserText = input.content;\n  let webchatSlashReceipt: string | undefined;\n\n  // Kick off the agent task in the background; events stream into `queue` as they happen\n  // and the generator below drains `queue` until the task closes it.\n  const taskPromise = (async () => {\n    try {\n      const cfg = deps.getConfig();\n      let turnBody = input.content;\n      let resetTriggeredAtInit = false;\n      if (cfg) {\n        const turn = await initSessionTurn({\n          cfg,\n          sessionKey,\n          body: input.content,\n          resetSession: deps.resetSession,\n        });\n        resetTriggeredAtInit = turn.resetTriggered;\n        if (turn.bareReset && turn.ackMessage) {\n          ranSlashCommand = true;\n          webchatSlashReceipt = turn.ackMessage;\n          pushVisible({ type: 'token', content: turn.ackMessage });\n          return;\n        }\n        turnBody = turn.bodyStripped;\n        if (turn.isNewSession) {\n          deps.log.debug(\n            {\n              sessionKey,\n              sessionId: turn.sessionId,\n              previousSessionId: turn.previousSessionId,\n              resetTriggered: turn.resetTriggered,\n              staleRollover: turn.staleRollover,\n            },\n            'Session reset boundary at direct turn start',\n          );\n        }\n      }\n\n      await hydratePerTurnState(deps, sessionKey, input.thinking);\n      {\n        const defReason = (deps.getConfig()?.agents?.defaults?.reasoningDefault ?? 'stream') as ReasoningLevel;\n        reasoningLevel = await resolveEffectiveReasoningLevel(deps.sessionConfigStore, sessionKey, defReason);\n      }\n\n      const prepared = await deps.prepareInboundAttachments(sessionKey, input.attachments);\n\n      const sttCfg = mergeSttConfigFromAppConfig(deps.getConfig()?.tools?.media?.audio, deps.getConfig()?.tools?.media);\n      const voiceMerge = await mergeVoiceTranscriptsIntoUserText(\n        deps.attachmentRootsForSession(sessionKey),\n        prepared,\n        turnBody,\n        sttCfg,\n      );\n      mergedUserText = voiceMerge.text;\n      inboundVoice = voiceMerge.inboundVoice;\n\n      if (inboundVoice) {\n        const transcriptParts = [\n          voiceMerge.voiceTranscripts.filter(Boolean).join('\\n'),\n          turnBody.trim(),\n        ].filter(Boolean);\n        const voiceAttachments = (prepared ?? []).filter(isVoiceLikeAttachment).map((att) => ({\n          workspaceRelativePath: att.workspaceRelativePath,\n          mimeType: att.mimeType,\n          name: att.name,\n        }));\n        pushVisible({\n          type: 'user_transcript',\n          text: transcriptParts.join('\\n\\n'),\n          attachments: voiceAttachments,\n        });\n      }\n\n      const armAbort = () => {\n        if (abortHandled) {\n          return;\n        }\n        abortHandled = true;\n        userAborted = true;\n        void abortEmbeddedRun(sessionKey);\n        queue.close();\n      };\n      if (signal) {\n        if (signal.aborted) {\n          armAbort();\n          return;\n        }\n        signal.addEventListener('abort', armAbort, { once: true });\n      }\n\n      const slash = await tryRunSlashCommand(\n        deps,\n        { sessionKey, channel, chatId, senderId: context.senderId, isGroup: context.isGroup },\n        mergedUserText,\n        { skipResetCommands: resetTriggeredAtInit },\n      );\n      if (slash.matched) {\n        ranSlashCommand = true;\n        const text = slash.aggregatedText.trim();\n        if (text) {\n          webchatSlashReceipt = text;\n          pushVisible({ type: 'token', content: text });\n        } else if (channel === 'webchat') {\n          webchatSlashReceipt =\n            'Command finished with no assistant text. If you used `/goal`, a follow-up turn may still be scheduled automatically.';\n          pushVisible({ type: 'token', content: webchatSlashReceipt });\n        }\n        return;\n      }\n\n      const textForAgent = mergedUserText.trimStart().startsWith('/skill:')\n        ? deps.agentManager.expandSkillUserText(mergedUserText)\n        : mergedUserText;\n      const messageContent = await deps.buildMessageContent(textForAgent, prepared, sessionKey);\n\n      const userMessage = {\n        role: 'user' as const,\n        content: messageContent,\n        timestamp: Date.now(),\n      };\n      if (channel === 'webchat') {\n        pushVisible({\n          type: 'user_message',\n          timestamp: userMessage.timestamp,\n          content: userMessage.content,\n          attachments: prepared?.map((att) => ({\n            type: att.type,\n            mimeType: att.mimeType,\n            name: att.name,\n            size: att.size,\n            workspaceRelativePath: att.workspaceRelativePath,\n          })),\n        });\n      }\n\n      const result = await runDirectAgentTurn(\n        {\n          sessionStore: deps.sessionStore,\n          agentManager: deps.agentManager,\n          modelManager: deps.modelManager,\n          config: deps.getConfig(),\n        },\n        {\n          sessionKey,\n          userMessage,\n          abortSignal: signal,\n          onEvent: (embeddedEvent) => {\n            const mapped = mapEmbeddedEventToGatewaySse(embeddedEvent);\n            if (mapped) {\n              pushVisible(mapped);\n            }\n          },\n        },\n      );\n\n      if (result.lastAssistantText) {\n        deps.onTurnComplete?.(sessionKey, result.lastAssistantText);\n      }\n      if (!result.ok && result.errorMessage && !abortHandled) {\n        pushVisible({ type: 'error', content: result.errorMessage });\n      }\n    } catch (err) {\n      if (!abortHandled) {\n        pushVisible({ type: 'error', content: err instanceof Error ? err.message : String(err) });\n      }\n    } finally {\n      queue.close();\n    }\n  })();\n\n  try {\n    for await (const event of queue) {\n      yield event;\n    }\n    await taskPromise; // surface unexpected throws\n\n    if (channel === 'webchat' && ranSlashCommand) {\n      try {\n        const { absPath } = await deps.sessionStore.resolveTranscriptPath(sessionKey);\n        const workspaceDir = deps.agentManager.getResolvedWorkspaceForSession(sessionKey);\n        const userMsg = {\n          role: 'user' as const,\n          content: [{ type: 'text' as const, text: mergedUserText }],\n          timestamp: Date.now(),\n        } as AgentMessage;\n        await appendPiTranscriptMessage({\n          absPath,\n          cwd: workspaceDir,\n          message: userMsg,\n          sessionKey,\n        });\n        if (webchatSlashReceipt?.trim()) {\n          const assistantMsg = {\n            role: 'assistant' as const,\n            content: [{ type: 'text' as const, text: webchatSlashReceipt.trim() }],\n            timestamp: Date.now(),\n          } as AgentMessage;\n          await appendPiTranscriptMessage({\n            absPath,\n            cwd: workspaceDir,\n            message: assistantMsg,\n            sessionKey,\n          });\n        }\n        deps.reloadWebchatTranscript?.(sessionKey);\n      } catch (err) {\n        deps.log.warn({ err, sessionKey }, 'Failed to persist webchat slash command receipt');\n      }\n    }\n\n    if (!userAborted) {\n      const ttsAudioEvent = await deps.maybeEmitWebchatTts(sessionKey, inboundVoice);\n      if (ttsAudioEvent) {\n        yield ttsAudioEvent;\n      }\n    }\n\n    deps.recordPersistentGoalStreamOutcome?.(sessionKey, { skipPersistentGoalPostTurn: ranSlashCommand });\n  } finally {\n    if (channel === 'webchat') {\n      deps.unregisterWebchatSsePublisher(sessionKey);\n    }\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":";;;;;;;;;;;AAwGA,gBAAuB,0BACrB,MACA,OAC+D;CAC/D,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,EAAE,SAAS,WAAW,KAAK,gBAAgB,WAAW;CAC5D,MAAM,UAAU,KAAK,2BAA2B,YAAY,SAAS,OAAO;CAE5E,MAAM,QAAQ,IAAI,YAA4C;CAC9D,IAAI,iBAAiC;CAErC,MAAM,eAAe,UAA0C;EAC7D,MAAM,UAAU,mCAAmC,OAAO,eAAe;AACzE,MAAI,YAAY,KACd,OAAM,KAAK,QAAQ;;AAIvB,KAAI,YAAY,UACd,MAAK,4BAA4B,YAAY,YAAY;CAG3D,MAAM,SAAS,MAAM;CACrB,IAAI,cAAc;CAClB,IAAI,eAAe;CACnB,IAAI,eAAe;CACnB,IAAI,kBAAkB;CACtB,IAAI,iBAAiB,MAAM;CAC3B,IAAI;CAIJ,MAAM,eAAe,YAAY;AAC/B,MAAI;GACF,MAAM,MAAM,KAAK,WAAW;GAC5B,IAAI,WAAW,MAAM;GACrB,IAAI,uBAAuB;AAC3B,OAAI,KAAK;IACP,MAAM,OAAO,MAAM,gBAAgB;KACjC;KACA;KACA,MAAM,MAAM;KACZ,cAAc,KAAK;KACpB,CAAC;AACF,2BAAuB,KAAK;AAC5B,QAAI,KAAK,aAAa,KAAK,YAAY;AACrC,uBAAkB;AAClB,2BAAsB,KAAK;AAC3B,iBAAY;MAAE,MAAM;MAAS,SAAS,KAAK;MAAY,CAAC;AACxD;;AAEF,eAAW,KAAK;AAChB,QAAI,KAAK,aACP,MAAK,IAAI,MACP;KACE;KACA,WAAW,KAAK;KAChB,mBAAmB,KAAK;KACxB,gBAAgB,KAAK;KACrB,eAAe,KAAK;KACrB,EACD,8CACD;;AAIL,SAAM,oBAAoB,MAAM,YAAY,MAAM,SAAS;GAC3D;IACE,MAAM,YAAa,KAAK,WAAW,EAAE,QAAQ,UAAU,oBAAoB;AAC3E,qBAAiB,MAAM,+BAA+B,KAAK,oBAAoB,YAAY,UAAU;;GAGvG,MAAM,WAAW,MAAM,KAAK,0BAA0B,YAAY,MAAM,YAAY;GAEpF,MAAM,SAAS,4BAA4B,KAAK,WAAW,EAAE,OAAO,OAAO,OAAO,KAAK,WAAW,EAAE,OAAO,MAAM;GACjH,MAAM,aAAa,MAAM,kCACvB,KAAK,0BAA0B,WAAW,EAC1C,UACA,UACA,OACD;AACD,oBAAiB,WAAW;AAC5B,kBAAe,WAAW;AAE1B,OAAI,cAAc;IAChB,MAAM,kBAAkB,CACtB,WAAW,iBAAiB,OAAO,QAAQ,CAAC,KAAK,KAAK,EACtD,SAAS,MAAM,CAChB,CAAC,OAAO,QAAQ;IACjB,MAAM,oBAAoB,YAAY,EAAE,EAAE,OAAO,sBAAsB,CAAC,KAAK,SAAS;KACpF,uBAAuB,IAAI;KAC3B,UAAU,IAAI;KACd,MAAM,IAAI;KACX,EAAE;AACH,gBAAY;KACV,MAAM;KACN,MAAM,gBAAgB,KAAK,OAAO;KAClC,aAAa;KACd,CAAC;;GAGJ,MAAM,iBAAiB;AACrB,QAAI,aACF;AAEF,mBAAe;AACf,kBAAc;AACT,qBAAiB,WAAW;AACjC,UAAM,OAAO;;AAEf,OAAI,QAAQ;AACV,QAAI,OAAO,SAAS;AAClB,eAAU;AACV;;AAEF,WAAO,iBAAiB,SAAS,UAAU,EAAE,MAAM,MAAM,CAAC;;GAG5D,MAAM,QAAQ,MAAM,mBAClB,MACA;IAAE;IAAY;IAAS;IAAQ,UAAU,QAAQ;IAAU,SAAS,QAAQ;IAAS,EACrF,gBACA,EAAE,mBAAmB,sBAAsB,CAC5C;AACD,OAAI,MAAM,SAAS;AACjB,sBAAkB;IAClB,MAAM,OAAO,MAAM,eAAe,MAAM;AACxC,QAAI,MAAM;AACR,2BAAsB;AACtB,iBAAY;MAAE,MAAM;MAAS,SAAS;MAAM,CAAC;eACpC,YAAY,WAAW;AAChC,2BACE;AACF,iBAAY;MAAE,MAAM;MAAS,SAAS;MAAqB,CAAC;;AAE9D;;GAGF,MAAM,eAAe,eAAe,WAAW,CAAC,WAAW,UAAU,GACjE,KAAK,aAAa,oBAAoB,eAAe,GACrD;GAGJ,MAAM,cAAc;IAClB,MAAM;IACN,SAAS,MAJkB,KAAK,oBAAoB,cAAc,UAAU,WAAW;IAKvF,WAAW,KAAK,KAAK;IACtB;AACD,OAAI,YAAY,UACd,aAAY;IACV,MAAM;IACN,WAAW,YAAY;IACvB,SAAS,YAAY;IACrB,aAAa,UAAU,KAAK,SAAS;KACnC,MAAM,IAAI;KACV,UAAU,IAAI;KACd,MAAM,IAAI;KACV,MAAM,IAAI;KACV,uBAAuB,IAAI;KAC5B,EAAE;IACJ,CAAC;GAGJ,MAAM,SAAS,MAAM,mBACnB;IACE,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,QAAQ,KAAK,WAAW;IACzB,EACD;IACE;IACA;IACA,aAAa;IACb,UAAU,kBAAkB;KAC1B,MAAM,SAAS,6BAA6B,cAAc;AAC1D,SAAI,OACF,aAAY,OAAO;;IAGxB,CACF;AAED,OAAI,OAAO,kBACT,MAAK,iBAAiB,YAAY,OAAO,kBAAkB;AAE7D,OAAI,CAAC,OAAO,MAAM,OAAO,gBAAgB,CAAC,aACxC,aAAY;IAAE,MAAM;IAAS,SAAS,OAAO;IAAc,CAAC;WAEvD,KAAK;AACZ,OAAI,CAAC,aACH,aAAY;IAAE,MAAM;IAAS,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;IAAE,CAAC;YAEnF;AACR,SAAM,OAAO;;KAEb;AAEJ,KAAI;AACF,aAAW,MAAM,SAAS,MACxB,OAAM;AAER,QAAM;AAEN,MAAI,YAAY,aAAa,gBAC3B,KAAI;GACF,MAAM,EAAE,YAAY,MAAM,KAAK,aAAa,sBAAsB,WAAW;GAC7E,MAAM,eAAe,KAAK,aAAa,+BAA+B,WAAW;AAMjF,SAAM,0BAA0B;IAC9B;IACA,KAAK;IACL,SAAS;KAPT,MAAM;KACN,SAAS,CAAC;MAAE,MAAM;MAAiB,MAAM;MAAgB,CAAC;KAC1D,WAAW,KAAK,KAAK;KAKL;IAChB;IACD,CAAC;AACF,OAAI,qBAAqB,MAAM,CAM7B,OAAM,0BAA0B;IAC9B;IACA,KAAK;IACL,SAAS;KAPT,MAAM;KACN,SAAS,CAAC;MAAE,MAAM;MAAiB,MAAM,oBAAoB,MAAM;MAAE,CAAC;KACtE,WAAW,KAAK,KAAK;KAKA;IACrB;IACD,CAAC;AAEJ,QAAK,0BAA0B,WAAW;WACnC,KAAK;AACZ,QAAK,IAAI,KAAK;IAAE;IAAK;IAAY,EAAE,kDAAkD;;AAIzF,MAAI,CAAC,aAAa;GAChB,MAAM,gBAAgB,MAAM,KAAK,oBAAoB,YAAY,aAAa;AAC9E,OAAI,cACF,OAAM;;AAIV,OAAK,oCAAoC,YAAY,EAAE,4BAA4B,iBAAiB,CAAC;WAC7F;AACR,MAAI,YAAY,UACd,MAAK,8BAA8B,WAAW;AAEhD,OAAK,yBAAyB"}
+{"version":3,"file":"process-direct-streaming.js","names":[],"sources":["../../../../src/agent/service/process-direct-streaming.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { InternalAttachmentRoots } from '../../channels/attachments/inbound-persist.js';\nimport {\n  isVoiceLikeAttachment,\n  mergeVoiceTranscriptsIntoUserText,\n  mergeSttConfigFromAppConfig,\n} from '../../channels/attachments/voice-stt-webchat.js';\nimport {\n  resolveEffectiveReasoningLevel,\n  initSessionTurn,\n  type SessionConfigStore,\n  type SessionStore,\n} from '../../session/index.js';\nimport { appendPiTranscriptMessage } from '../../session/parity/jsonl-transcript-io.js';\nimport type { SessionContext } from '../session/index.js';\nimport { applyReasoningVisibilityToSseEvent } from '../streaming/reasoning-visibility-sse.js';\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\nimport { formatAgentRunErrorForClient } from '../client-error-format.js';\nimport { abortEmbeddedRun } from '../embedded/runs.js';\nimport { mapEmbeddedEventToGatewaySse } from '../embedded/map-stream-events.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { CommandHandler } from '../messaging/command-handler.js';\nimport type { ModelManager } from '../models/index.js';\n\nimport { AsyncQueue } from './async-queue.js';\nimport {\n  hydratePerTurnState,\n  runDirectAgentTurn,\n  tryRunSlashCommand,\n} from './direct-turn-helpers.js';\n\nexport type DirectStreamInboundAttachment = {\n  type: string;\n  mimeType?: string;\n  data?: string;\n  name?: string;\n  size?: number;\n  workspaceRelativePath?: string;\n};\n\nexport type ProcessDirectStreamLog = {\n  info: (obj: Record<string, unknown>, msg: string) => void;\n  warn: (obj: Record<string, unknown>, msg: string) => void;\n  debug?: (obj: Record<string, unknown>, msg: string) => void;\n};\n\nexport interface ProcessDirectStreamingDeps {\n  log: ProcessDirectStreamLog;\n  parseSessionKey: (sessionKey: string) => { channel: string; chatId: string };\n  initDirectStreamingSession: (\n    sessionKey: string,\n    channel: string,\n    chatId: string,\n  ) => SessionContext;\n  registerWebchatSsePublisher: (\n    sessionKey: string,\n    publisher: (event: { type: string; [key: string]: unknown }) => void,\n  ) => void;\n  unregisterWebchatSsePublisher: (sessionKey: string) => void;\n  agentManager: AgentInstanceGateway;\n  hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;\n  hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  applyResolvedThinkingLevel: (sessionKey: string, thinking?: string | null) => Promise<void>;\n  getConfig: () => Config | undefined;\n  sessionConfigStore: SessionConfigStore;\n  attachmentRootsForSession: (sessionKey: string) => InternalAttachmentRoots;\n  commandHandler: Pick<CommandHandler, 'executeCommandAndAggregateReply'>;\n  prepareInboundAttachments: (\n    sessionKey: string,\n    attachments?: DirectStreamInboundAttachment[],\n  ) => Promise<DirectStreamInboundAttachment[] | undefined>;\n  buildMessageContent: (\n    content: string,\n    attachments: DirectStreamInboundAttachment[] | undefined,\n    sessionKey: string,\n  ) => Promise<Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>>;\n  recordPersistentGoalStreamOutcome?: (\n    sessionKey: string,\n    outcome: { skipPersistentGoalPostTurn: boolean },\n  ) => void;\n  onTurnComplete?: (sessionKey: string, lastAssistantText?: string) => void;\n  /** Disk-only transcript sync (slash receipt already streamed as tokens). */\n  reloadWebchatTranscript?: (sessionKey: string) => void;\n  maybeEmitWebchatTts: (\n    sessionKey: string,\n    hadInboundVoice: boolean,\n  ) => Promise<{ type: 'tts_audio'; workspaceRelativePath: string; mimeType: string; name: string } | null>;\n  endDirectRequestContext: () => void;\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n}\n\nexport interface ProcessDirectStreamingInput {\n  content: string;\n  sessionKey?: string;\n  attachments?: DirectStreamInboundAttachment[];\n  thinking?: string;\n  signal?: AbortSignal;\n}\n\nexport type ProcessDirectStreamingSseEvent = { type: string; [key: string]: unknown };\n\nexport async function* runProcessDirectStreaming(\n  deps: ProcessDirectStreamingDeps,\n  input: ProcessDirectStreamingInput,\n): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown> {\n  const sessionKey = input.sessionKey ?? 'agent:main:main';\n  const { channel, chatId } = deps.parseSessionKey(sessionKey);\n  const context = deps.initDirectStreamingSession(sessionKey, channel, chatId);\n\n  const queue = new AsyncQueue<ProcessDirectStreamingSseEvent>();\n  let reasoningLevel: ReasoningLevel = 'stream';\n\n  const pushVisible = (event: ProcessDirectStreamingSseEvent) => {\n    const visible = applyReasoningVisibilityToSseEvent(event, reasoningLevel);\n    if (visible !== null) {\n      queue.push(visible);\n    }\n  };\n\n  const formatStreamError = (raw: string): string => {\n    let provider: string | undefined;\n    let modelRef: string | undefined;\n    try {\n      const resolved = deps.modelManager.getResolvedModelForSession(sessionKey);\n      provider = resolved.provider;\n      modelRef = deps.modelManager.getModelForSession(sessionKey);\n    } catch {\n      /* ignore — format without provider context */\n    }\n    return formatAgentRunErrorForClient(raw, { provider, modelRef });\n  };\n\n  if (channel === 'webchat') {\n    deps.registerWebchatSsePublisher(sessionKey, pushVisible);\n  }\n\n  const signal = input.signal;\n  let userAborted = false;\n  let abortHandled = false;\n  let inboundVoice = false;\n  let ranSlashCommand = false;\n  let mergedUserText = input.content;\n  let webchatSlashReceipt: string | undefined;\n\n  // Kick off the agent task in the background; events stream into `queue` as they happen\n  // and the generator below drains `queue` until the task closes it.\n  const taskPromise = (async () => {\n    try {\n      const cfg = deps.getConfig();\n      let turnBody = input.content;\n      let resetTriggeredAtInit = false;\n      if (cfg) {\n        const turn = await initSessionTurn({\n          cfg,\n          sessionKey,\n          body: input.content,\n          resetSession: deps.resetSession,\n        });\n        resetTriggeredAtInit = turn.resetTriggered;\n        if (turn.bareReset && turn.ackMessage) {\n          ranSlashCommand = true;\n          webchatSlashReceipt = turn.ackMessage;\n          pushVisible({ type: 'token', content: turn.ackMessage });\n          return;\n        }\n        turnBody = turn.bodyStripped;\n        if (turn.isNewSession) {\n          deps.log.debug(\n            {\n              sessionKey,\n              sessionId: turn.sessionId,\n              previousSessionId: turn.previousSessionId,\n              resetTriggered: turn.resetTriggered,\n              staleRollover: turn.staleRollover,\n            },\n            'Session reset boundary at direct turn start',\n          );\n        }\n      }\n\n      await hydratePerTurnState(deps, sessionKey, input.thinking);\n      {\n        const defReason = (deps.getConfig()?.agents?.defaults?.reasoningDefault ?? 'stream') as ReasoningLevel;\n        reasoningLevel = await resolveEffectiveReasoningLevel(deps.sessionConfigStore, sessionKey, defReason);\n      }\n\n      const prepared = await deps.prepareInboundAttachments(sessionKey, input.attachments);\n\n      const sttCfg = mergeSttConfigFromAppConfig(deps.getConfig()?.tools?.media?.audio, deps.getConfig()?.tools?.media);\n      const voiceMerge = await mergeVoiceTranscriptsIntoUserText(\n        deps.attachmentRootsForSession(sessionKey),\n        prepared,\n        turnBody,\n        sttCfg,\n      );\n      mergedUserText = voiceMerge.text;\n      inboundVoice = voiceMerge.inboundVoice;\n\n      if (inboundVoice) {\n        const transcriptParts = [\n          voiceMerge.voiceTranscripts.filter(Boolean).join('\\n'),\n          turnBody.trim(),\n        ].filter(Boolean);\n        const voiceAttachments = (prepared ?? []).filter(isVoiceLikeAttachment).map((att) => ({\n          workspaceRelativePath: att.workspaceRelativePath,\n          mimeType: att.mimeType,\n          name: att.name,\n        }));\n        pushVisible({\n          type: 'user_transcript',\n          text: transcriptParts.join('\\n\\n'),\n          attachments: voiceAttachments,\n        });\n      }\n\n      const armAbort = () => {\n        if (abortHandled) {\n          return;\n        }\n        abortHandled = true;\n        userAborted = true;\n        void abortEmbeddedRun(sessionKey);\n        queue.close();\n      };\n      if (signal) {\n        if (signal.aborted) {\n          armAbort();\n          return;\n        }\n        signal.addEventListener('abort', armAbort, { once: true });\n      }\n\n      const slash = await tryRunSlashCommand(\n        deps,\n        { sessionKey, channel, chatId, senderId: context.senderId, isGroup: context.isGroup },\n        mergedUserText,\n        { skipResetCommands: resetTriggeredAtInit },\n      );\n      if (slash.matched) {\n        ranSlashCommand = true;\n        const text = slash.aggregatedText.trim();\n        if (text) {\n          webchatSlashReceipt = text;\n          pushVisible({ type: 'token', content: text });\n        } else if (channel === 'webchat') {\n          webchatSlashReceipt =\n            'Command finished with no assistant text. If you used `/goal`, a follow-up turn may still be scheduled automatically.';\n          pushVisible({ type: 'token', content: webchatSlashReceipt });\n        }\n        return;\n      }\n\n      const textForAgent = mergedUserText.trimStart().startsWith('/skill:')\n        ? deps.agentManager.expandSkillUserText(mergedUserText)\n        : mergedUserText;\n      const messageContent = await deps.buildMessageContent(textForAgent, prepared, sessionKey);\n\n      const userMessage = {\n        role: 'user' as const,\n        content: messageContent,\n        timestamp: Date.now(),\n      };\n      if (channel === 'webchat') {\n        pushVisible({\n          type: 'user_message',\n          timestamp: userMessage.timestamp,\n          content: userMessage.content,\n          attachments: prepared?.map((att) => ({\n            type: att.type,\n            mimeType: att.mimeType,\n            name: att.name,\n            size: att.size,\n            workspaceRelativePath: att.workspaceRelativePath,\n          })),\n        });\n      }\n\n      const result = await runDirectAgentTurn(\n        {\n          sessionStore: deps.sessionStore,\n          agentManager: deps.agentManager,\n          modelManager: deps.modelManager,\n          config: deps.getConfig(),\n        },\n        {\n          sessionKey,\n          userMessage,\n          abortSignal: signal,\n          onEvent: (embeddedEvent) => {\n            const mapped = mapEmbeddedEventToGatewaySse(embeddedEvent);\n            if (mapped) {\n              if (mapped.type === 'error' && typeof mapped.content === 'string') {\n                mapped.content = formatStreamError(mapped.content);\n              }\n              pushVisible(mapped);\n            }\n          },\n        },\n      );\n\n      if (result.lastAssistantText) {\n        deps.onTurnComplete?.(sessionKey, result.lastAssistantText);\n      }\n      if (!result.ok && result.errorMessage && !abortHandled) {\n        pushVisible({ type: 'error', content: formatStreamError(result.errorMessage) });\n      }\n    } catch (err) {\n      if (!abortHandled) {\n        const em = err instanceof Error ? err.message : String(err);\n        pushVisible({ type: 'error', content: formatStreamError(em) });\n      }\n    } finally {\n      queue.close();\n    }\n  })();\n\n  try {\n    for await (const event of queue) {\n      yield event;\n    }\n    await taskPromise; // surface unexpected throws\n\n    if (channel === 'webchat' && ranSlashCommand) {\n      try {\n        const { absPath } = await deps.sessionStore.resolveTranscriptPath(sessionKey);\n        const workspaceDir = deps.agentManager.getResolvedWorkspaceForSession(sessionKey);\n        const userMsg = {\n          role: 'user' as const,\n          content: [{ type: 'text' as const, text: mergedUserText }],\n          timestamp: Date.now(),\n        } as AgentMessage;\n        await appendPiTranscriptMessage({\n          absPath,\n          cwd: workspaceDir,\n          message: userMsg,\n          sessionKey,\n        });\n        if (webchatSlashReceipt?.trim()) {\n          const assistantMsg = {\n            role: 'assistant' as const,\n            content: [{ type: 'text' as const, text: webchatSlashReceipt.trim() }],\n            timestamp: Date.now(),\n          } as AgentMessage;\n          await appendPiTranscriptMessage({\n            absPath,\n            cwd: workspaceDir,\n            message: assistantMsg,\n            sessionKey,\n          });\n        }\n        deps.reloadWebchatTranscript?.(sessionKey);\n      } catch (err) {\n        deps.log.warn({ err, sessionKey }, 'Failed to persist webchat slash command receipt');\n      }\n    }\n\n    if (!userAborted) {\n      const ttsAudioEvent = await deps.maybeEmitWebchatTts(sessionKey, inboundVoice);\n      if (ttsAudioEvent) {\n        yield ttsAudioEvent;\n      }\n    }\n\n    deps.recordPersistentGoalStreamOutcome?.(sessionKey, { skipPersistentGoalPostTurn: ranSlashCommand });\n  } finally {\n    if (channel === 'webchat') {\n      deps.unregisterWebchatSsePublisher(sessionKey);\n    }\n    deps.endDirectRequestContext();\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/service/webchat-tts.d.ts

@@ -1,5 +1,4 @@
 import type { Config } from '../../config/schema.js';
-import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
 import type { SessionStore } from '../../session/index.js';
 export type WebchatTtsResult = {
     type: 'tts_audio';
@@ -9,8 +8,8 @@ export type WebchatTtsResult = {
 };
 export type WebchatTtsDeps = {
     config: Config | undefined;
-    agentManager: AgentInstanceGateway;
     sessionStore: SessionStore;
+    getLastAssistantPlainText: (sessionKey: string) => string;
     log: {
         warn: (obj: Record<string, unknown>, msg: string) => void;
     };