@xopcai/xopc 0.0.87 → 0.0.88

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":"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"}
+{"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;
     };

package/dist/src/agent/service/webchat-tts.js

@@ -16,7 +16,7 @@ async function maybeEmitWebchatTts(deps, sessionKey, hadInboundVoice) {
 	const ttsConfig = mergeTtsConfigFromAppConfig(deps.config?.messages?.tts);
 	if (!isTTSAvailable(ttsConfig)) return null;
 	if (!shouldUseTTS(ttsConfig, hadInboundVoice).useTTS) return null;
-	const text = deps.agentManager.getLastAssistantContent(sessionKey)?.trim();
+	const text = deps.getLastAssistantPlainText(sessionKey).trim();
 	if (!text) return null;
 	try {
 		const webOut = getChannelOutputFormat("webchat");

package/dist/src/agent/service/webchat-tts.js.map

@@ -1 +1 @@
-{"version":3,"file":"webchat-tts.js","names":[],"sources":["../../../../src/agent/service/webchat-tts.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { persistOutboundTtsAudio } from '../../channels/attachments/outbound-tts-persist.js';\nimport { compressAudio } from '../../voice/tts/audio.js';\nimport { speak } from '../../voice/tts/index.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { shouldUseTTS, getChannelOutputFormat } from '../../voice/tts/service.js';\nimport { isTTSAvailable } from '../../voice/tts/factory.js';\nimport { resolveAgentHomeDir } from '../agent-scope.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nexport type WebchatTtsResult = {\n  type: 'tts_audio';\n  workspaceRelativePath: string;\n  mimeType: string;\n  name: string;\n};\n\nexport type WebchatTtsDeps = {\n  config: Config | undefined;\n  agentManager: AgentInstanceGateway;\n  sessionStore: SessionStore;\n  log: { warn: (obj: Record<string, unknown>, msg: string) => void };\n};\n\n/**\n * Generate TTS for webchat when config allows; persist under agent home `tts/`.\n */\nexport async function maybeEmitWebchatTts(\n  deps: WebchatTtsDeps,\n  sessionKey: string,\n  hadInboundVoice: boolean,\n): Promise<WebchatTtsResult | null> {\n  const ttsConfig = mergeTtsConfigFromAppConfig(deps.config?.messages?.tts);\n  if (!isTTSAvailable(ttsConfig)) {\n    return null;\n  }\n  const decision = shouldUseTTS(ttsConfig, hadInboundVoice);\n  if (!decision.useTTS) {\n    return null;\n  }\n  const text = deps.agentManager.getLastAssistantContent(sessionKey)?.trim();\n  if (!text) {\n    return null;\n  }\n  try {\n    const webOut = getChannelOutputFormat('webchat');\n    const fmt = webOut.format as 'opus' | 'mp3' | 'wav';\n    const ttsResult = await speak(text, ttsConfig, {\n      appConfig: deps.config,\n      tts: { format: fmt },\n    });\n    const { buffer, format } = await compressAudio(\n      Buffer.from(ttsResult.audio),\n      ttsResult.format,\n      webOut.format === 'mp3' ? 'mp3' : 'opus',\n    );\n    const normalizedMime =\n      format === 'opus' || format === 'ogg'\n        ? 'audio/ogg'\n        : format === 'mp3' || format === 'mpeg'\n          ? 'audio/mpeg'\n          : format === 'wav'\n            ? 'audio/wav'\n            : `audio/${format}`;\n    const cfg = deps.config!;\n    const persisted = await persistOutboundTtsAudio(\n      resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg)),\n      sessionKey,\n      buffer,\n      format,\n    );\n    await appendAttachmentToLastAssistant(deps.sessionStore, sessionKey, {\n      type: 'audio',\n      mimeType: normalizedMime,\n      name: persisted.name,\n      size: persisted.size,\n      workspaceRelativePath: persisted.workspaceRelativePath,\n    });\n    return {\n      type: 'tts_audio',\n      workspaceRelativePath: persisted.workspaceRelativePath,\n      mimeType: normalizedMime,\n      name: persisted.name,\n    };\n  } catch (err) {\n    deps.log.warn({ err, sessionKey }, 'Webchat TTS failed');\n    return null;\n  }\n}\n\nexport async function appendAttachmentToLastAssistant(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  att: {\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    workspaceRelativePath: string;\n  },\n): Promise<void> {\n  const loaded = await sessionStore.load(sessionKey);\n  for (let i = loaded.length - 1; i >= 0; i--) {\n    const m = loaded[i] as { role?: string; attachments?: unknown[] };\n    if (m.role === 'assistant') {\n      const prev = (m.attachments ?? []) as Array<{ workspaceRelativePath?: string }>;\n      if (prev.some((x) => x.workspaceRelativePath === att.workspaceRelativePath)) {\n        return;\n      }\n      const next = [...prev, att];\n      loaded[i] = { ...m, attachments: next } as unknown as AgentMessage;\n      await sessionStore.saveMessages(sessionKey, loaded);\n      return;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;kBAOwD;;;;AAuBxD,eAAsB,oBACpB,MACA,YACA,iBACkC;CAClC,MAAM,YAAY,4BAA4B,KAAK,QAAQ,UAAU,IAAI;AACzE,KAAI,CAAC,eAAe,UAAU,CAC5B,QAAO;AAGT,KAAI,CADa,aAAa,WAAW,gBAC5B,CAAC,OACZ,QAAO;CAET,MAAM,OAAO,KAAK,aAAa,wBAAwB,WAAW,EAAE,MAAM;AAC1E,KAAI,CAAC,KACH,QAAO;AAET,KAAI;EACF,MAAM,SAAS,uBAAuB,UAAU;EAChD,MAAM,MAAM,OAAO;EACnB,MAAM,YAAY,MAAM,MAAM,MAAM,WAAW;GAC7C,WAAW,KAAK;GAChB,KAAK,EAAE,QAAQ,KAAK;GACrB,CAAC;EACF,MAAM,EAAE,QAAQ,WAAW,MAAM,cAC/B,OAAO,KAAK,UAAU,MAAM,EAC5B,UAAU,QACV,OAAO,WAAW,QAAQ,QAAQ,OACnC;EACD,MAAM,iBACJ,WAAW,UAAU,WAAW,QAC5B,cACA,WAAW,SAAS,WAAW,SAC7B,eACA,WAAW,QACT,cACA,SAAS;EACnB,MAAM,MAAM,KAAK;EACjB,MAAM,YAAY,MAAM,wBACtB,oBAAoB,KAAK,sBAAsB,YAAY,IAAI,CAAC,EAChE,YACA,QACA,OACD;AACD,QAAM,gCAAgC,KAAK,cAAc,YAAY;GACnE,MAAM;GACN,UAAU;GACV,MAAM,UAAU;GAChB,MAAM,UAAU;GAChB,uBAAuB,UAAU;GAClC,CAAC;AACF,SAAO;GACL,MAAM;GACN,uBAAuB,UAAU;GACjC,UAAU;GACV,MAAM,UAAU;GACjB;UACM,KAAK;AACZ,OAAK,IAAI,KAAK;GAAE;GAAK;GAAY,EAAE,qBAAqB;AACxD,SAAO;;;AAIX,eAAsB,gCACpB,cACA,YACA,KAOe;CACf,MAAM,SAAS,MAAM,aAAa,KAAK,WAAW;AAClD,MAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;EAC3C,MAAM,IAAI,OAAO;AACjB,MAAI,EAAE,SAAS,aAAa;GAC1B,MAAM,OAAQ,EAAE,eAAe,EAAE;AACjC,OAAI,KAAK,MAAM,MAAM,EAAE,0BAA0B,IAAI,sBAAsB,CACzE;GAEF,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI;AAC3B,UAAO,KAAK;IAAE,GAAG;IAAG,aAAa;IAAM;AACvC,SAAM,aAAa,aAAa,YAAY,OAAO;AACnD"}
+{"version":3,"file":"webchat-tts.js","names":[],"sources":["../../../../src/agent/service/webchat-tts.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { persistOutboundTtsAudio } from '../../channels/attachments/outbound-tts-persist.js';\nimport { compressAudio } from '../../voice/tts/audio.js';\nimport { speak } from '../../voice/tts/index.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\nimport { shouldUseTTS, getChannelOutputFormat } from '../../voice/tts/service.js';\nimport { isTTSAvailable } from '../../voice/tts/factory.js';\nimport { resolveAgentHomeDir } from '../agent-scope.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nexport type WebchatTtsResult = {\n  type: 'tts_audio';\n  workspaceRelativePath: string;\n  mimeType: string;\n  name: string;\n};\n\nexport type WebchatTtsDeps = {\n  config: Config | undefined;\n  sessionStore: SessionStore;\n  getLastAssistantPlainText: (sessionKey: string) => string;\n  log: { warn: (obj: Record<string, unknown>, msg: string) => void };\n};\n\n/**\n * Generate TTS for webchat when config allows; persist under agent home `tts/`.\n */\nexport async function maybeEmitWebchatTts(\n  deps: WebchatTtsDeps,\n  sessionKey: string,\n  hadInboundVoice: boolean,\n): Promise<WebchatTtsResult | null> {\n  const ttsConfig = mergeTtsConfigFromAppConfig(deps.config?.messages?.tts);\n  if (!isTTSAvailable(ttsConfig)) {\n    return null;\n  }\n  const decision = shouldUseTTS(ttsConfig, hadInboundVoice);\n  if (!decision.useTTS) {\n    return null;\n  }\n  const text = deps.getLastAssistantPlainText(sessionKey).trim();\n  if (!text) {\n    return null;\n  }\n  try {\n    const webOut = getChannelOutputFormat('webchat');\n    const fmt = webOut.format as 'opus' | 'mp3' | 'wav';\n    const ttsResult = await speak(text, ttsConfig, {\n      appConfig: deps.config,\n      tts: { format: fmt },\n    });\n    const { buffer, format } = await compressAudio(\n      Buffer.from(ttsResult.audio),\n      ttsResult.format,\n      webOut.format === 'mp3' ? 'mp3' : 'opus',\n    );\n    const normalizedMime =\n      format === 'opus' || format === 'ogg'\n        ? 'audio/ogg'\n        : format === 'mp3' || format === 'mpeg'\n          ? 'audio/mpeg'\n          : format === 'wav'\n            ? 'audio/wav'\n            : `audio/${format}`;\n    const cfg = deps.config!;\n    const persisted = await persistOutboundTtsAudio(\n      resolveAgentHomeDir(cfg, extractProfileAgentId(sessionKey, cfg)),\n      sessionKey,\n      buffer,\n      format,\n    );\n    await appendAttachmentToLastAssistant(deps.sessionStore, sessionKey, {\n      type: 'audio',\n      mimeType: normalizedMime,\n      name: persisted.name,\n      size: persisted.size,\n      workspaceRelativePath: persisted.workspaceRelativePath,\n    });\n    return {\n      type: 'tts_audio',\n      workspaceRelativePath: persisted.workspaceRelativePath,\n      mimeType: normalizedMime,\n      name: persisted.name,\n    };\n  } catch (err) {\n    deps.log.warn({ err, sessionKey }, 'Webchat TTS failed');\n    return null;\n  }\n}\n\nexport async function appendAttachmentToLastAssistant(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  att: {\n    type: string;\n    mimeType: string;\n    name: string;\n    size: number;\n    workspaceRelativePath: string;\n  },\n): Promise<void> {\n  const loaded = await sessionStore.load(sessionKey);\n  for (let i = loaded.length - 1; i >= 0; i--) {\n    const m = loaded[i] as { role?: string; attachments?: unknown[] };\n    if (m.role === 'assistant') {\n      const prev = (m.attachments ?? []) as Array<{ workspaceRelativePath?: string }>;\n      if (prev.some((x) => x.workspaceRelativePath === att.workspaceRelativePath)) {\n        return;\n      }\n      const next = [...prev, att];\n      loaded[i] = { ...m, attachments: next } as unknown as AgentMessage;\n      await sessionStore.saveMessages(sessionKey, loaded);\n      return;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;kBAOwD;;;;AAsBxD,eAAsB,oBACpB,MACA,YACA,iBACkC;CAClC,MAAM,YAAY,4BAA4B,KAAK,QAAQ,UAAU,IAAI;AACzE,KAAI,CAAC,eAAe,UAAU,CAC5B,QAAO;AAGT,KAAI,CADa,aAAa,WAAW,gBAC5B,CAAC,OACZ,QAAO;CAET,MAAM,OAAO,KAAK,0BAA0B,WAAW,CAAC,MAAM;AAC9D,KAAI,CAAC,KACH,QAAO;AAET,KAAI;EACF,MAAM,SAAS,uBAAuB,UAAU;EAChD,MAAM,MAAM,OAAO;EACnB,MAAM,YAAY,MAAM,MAAM,MAAM,WAAW;GAC7C,WAAW,KAAK;GAChB,KAAK,EAAE,QAAQ,KAAK;GACrB,CAAC;EACF,MAAM,EAAE,QAAQ,WAAW,MAAM,cAC/B,OAAO,KAAK,UAAU,MAAM,EAC5B,UAAU,QACV,OAAO,WAAW,QAAQ,QAAQ,OACnC;EACD,MAAM,iBACJ,WAAW,UAAU,WAAW,QAC5B,cACA,WAAW,SAAS,WAAW,SAC7B,eACA,WAAW,QACT,cACA,SAAS;EACnB,MAAM,MAAM,KAAK;EACjB,MAAM,YAAY,MAAM,wBACtB,oBAAoB,KAAK,sBAAsB,YAAY,IAAI,CAAC,EAChE,YACA,QACA,OACD;AACD,QAAM,gCAAgC,KAAK,cAAc,YAAY;GACnE,MAAM;GACN,UAAU;GACV,MAAM,UAAU;GAChB,MAAM,UAAU;GAChB,uBAAuB,UAAU;GAClC,CAAC;AACF,SAAO;GACL,MAAM;GACN,uBAAuB,UAAU;GACjC,UAAU;GACV,MAAM,UAAU;GACjB;UACM,KAAK;AACZ,OAAK,IAAI,KAAK;GAAE;GAAK;GAAY,EAAE,qBAAqB;AACxD,SAAO;;;AAIX,eAAsB,gCACpB,cACA,YACA,KAOe;CACf,MAAM,SAAS,MAAM,aAAa,KAAK,WAAW;AAClD,MAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;EAC3C,MAAM,IAAI,OAAO;AACjB,MAAI,EAAE,SAAS,aAAa;GAC1B,MAAM,OAAQ,EAAE,eAAe,EAAE;AACjC,OAAI,KAAK,MAAM,MAAM,EAAE,0BAA0B,IAAI,sBAAsB,CACzE;GAEF,MAAM,OAAO,CAAC,GAAG,MAAM,IAAI;AAC3B,UAAO,KAAK;IAAE,GAAG;IAAG,aAAa;IAAM;AACvC,SAAM,aAAa,aAAa,YAAY,OAAO;AACnD"}

package/dist/src/agent/service.js

@@ -1,9 +1,9 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_agent_scope, resolveAgentHomeDir, resolveAgentProfileDir, resolveDefaultAgentId } from "./agent-scope.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { applyConfigOverrides } from "../config/runtime-overrides.js";
-import { init_agent_scope, resolveAgentHomeDir, resolveAgentProfileDir, resolveDefaultAgentId } from "./agent-scope.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
 import { extractTextContent } from "./context/workspace.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { getWorkflowProgressBroker } from "./workflow/progress-broker.js";
@@ -59,8 +59,8 @@ import { reconcileManagedDreamingCronJobs } from "./service/reconcile-dreaming-c
 import { parseOutboundSessionKey } from "./service/parse-outbound-session-key.js";
 import { cleanTrailingErrors } from "./memory/message-sanitizer.js";
 import { tryApplySessionTranscriptHygiene } from "./transcript/transcript-hygiene.js";
-import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 //#region src/agent/service.ts
 init_schema();
 init_logger();

package/dist/src/agent/session/session-inspector.js

@@ -1,6 +1,6 @@
-import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { effectiveWorkspacePathForSession } from "../../session/session-workspace.js";
 import "../../session/index.js";

package/dist/src/agent/skills/config.js

@@ -1,7 +1,7 @@
 import { __toCommonJS } from "../../../_virtual/_rolldown/runtime.js";
+import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
 import { init_installer, installer_exports } from "./installer.js";
 import { join } from "path";
 import { existsSync, readFileSync } from "fs";

package/dist/src/agent/skills/hub-hash.js

@@ -1,6 +1,6 @@
-import { join, relative } from "node:path";
-import { createReadStream, existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
+import { createReadStream, existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
 //#region src/agent/skills/hub-hash.ts
 /**
 * Deterministic content hash for a skill directory (for hub lock / drift detection).

package/dist/src/agent/skills/hub-lock.js

@@ -1,5 +1,5 @@
-import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
+import { init_paths, resolveSkillsLockPath } from "../../config/paths.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/skills/hub-lock.ts
 /**

package/dist/src/agent/skills/hub-pull.js

@@ -4,9 +4,9 @@ import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { getSkillsLockEntry, recordSkillsHubInstall } from "./hub-lock.js";
 import { installSkillFromZip, isValidSkillId } from "./managed-store.js";
 import { computeSkillTreeHashSync } from "./hub-hash.js";
-import { tmpdir } from "node:os";
-import { basename, join, normalize, resolve, sep } from "node:path";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { basename, join, normalize, resolve, sep } from "node:path";
+import { tmpdir } from "node:os";
 import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { fetch } from "undici";

package/dist/src/agent/skills/index.js

@@ -1,6 +1,6 @@
-import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { findInstallSpec, getDefaultInstallerPreferences, hasBinary, init_installer, installSkill } from "./installer.js";

package/dist/src/agent/skills/managed-store.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { loadSkillsLock } from "./hub-lock.js";
-import { dirname, join, resolve, sep } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
 import AdmZip from "adm-zip";
 //#region src/agent/skills/managed-store.ts
 /**

package/dist/src/agent/skills/scanner.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { join } from "path";
 import { readFile, readdir } from "fs/promises";
+import { join } from "path";
 //#region src/agent/skills/scanner.ts
 /**
 * Skill security scanner — scans skill directories for potentially dangerous code patterns.

package/dist/src/agent/skills/skill-manage-ops.js

@@ -2,9 +2,9 @@ import { init_paths, resolveSkillsDir } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
+import { mkdir, writeFile } from "fs/promises";
 import { join, resolve, sep } from "path";
 import { existsSync, realpathSync } from "fs";
-import { mkdir, writeFile } from "fs/promises";
 //#region src/agent/skills/skill-manage-ops.ts
 /**
 * Shared logic for the skill_manage agent tool (create / edit / patch / delete / write_file / remove_file).

package/dist/src/agent/skills/skill-manager.js

@@ -1,6 +1,6 @@
-import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths, resolveBundledSkillsDir } from "../../config/paths.js";
 import { createSkillConfigManager, isSkillEnabled } from "./config.js";
 import { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from "./format-skills-prompt.js";

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

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

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

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

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

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

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

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

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

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

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

@@ -1,12 +1,15 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { applySubagentProgress } from "../workflow/agent-progress.js";
 import { parseWorkflowScript } from "../workflow/parser.js";
 import { getLastWorkflowMemory } from "../workflow/last-run-memory.js";
-import { previewValue, recomputeCounts, renderWorkflowText } from "../workflow/snapshot.js";
 import { runWorkflow } from "../workflow/runtime.js";
+import { previewValue, recomputeCounts, renderWorkflowText } from "../workflow/snapshot.js";
 import { DelegateSubagentRunner } from "../workflow/subagent-runner.js";
 import "../workflow/index.js";
+import { resolveModelRef } from "../../config/agent-typed-models.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/workflow-tool.ts
 /**
@@ -30,6 +33,7 @@ const DEFAULT_TIMEOUT_SEC = 1800;
 const MAX_TIMEOUT_SEC = 14400;
 const DEFAULT_MAX_CONCURRENCY = 16;
 const DEFAULT_MAX_SUBAGENTS = 1e3;
+const PUSH_UPDATE_THROTTLE_MS = 300;
 const WorkflowToolSchema = Type.Object({
 	name: Type.Optional(Type.String({ description: "Name of a saved workflow to run. Either `name` or `script` is required. Use `name` whenever the user references a known workflow (built-in or in ~/.xopc/workflows/)." })),
 	script: Type.Optional(Type.String({ description: [
@@ -100,7 +104,7 @@ function createWorkflowTool(deps) {
 			const snapshot = {
 				name: meta.name,
 				description: meta.description,
-				phases: [],
+				phases: meta.phases?.map((p) => p.title) ?? [],
 				logs: [],
 				agents: [],
 				agentCount: 0,
@@ -109,16 +113,33 @@ function createWorkflowTool(deps) {
 				errorCount: 0,
 				skippedCount: 0
 			};
-			const pushUpdate = (completed = false) => {
+			let lastUpdatePushedAtMs = Number.NEGATIVE_INFINITY;
+			let liveUpdatesDisabled = false;
+			const pushUpdate = (completed = false, immediate = false) => {
+				if (liveUpdatesDisabled) return;
 				recomputeCounts(snapshot);
-				onUpdate?.({
-					content: [{
-						type: "text",
-						text: renderWorkflowText(snapshot, completed, { showResultPreviews: false })
-					}],
-					details: snapshot
-				});
+				const nowMs = Date.now();
+				if (!(completed || immediate || nowMs - lastUpdatePushedAtMs >= PUSH_UPDATE_THROTTLE_MS)) return;
+				lastUpdatePushedAtMs = nowMs;
+				try {
+					onUpdate?.({
+						content: [{
+							type: "text",
+							text: renderWorkflowText(snapshot, completed, { showResultPreviews: false })
+						}],
+						details: snapshot
+					});
+				} catch (e) {
+					liveUpdatesDisabled = true;
+					const message = e instanceof Error ? e.message : String(e);
+					log.warn({
+						err: e,
+						errorMessage: message,
+						workflow: meta.name
+					}, `workflow live progress disabled: ${message}`);
+				}
 			};
+			const subagentStream = wfCfg?.subagentStream ?? "steps";
 			const runner = new DelegateSubagentRunner({
 				workspace: deps.workspace,
 				bus: deps.bus,
@@ -127,7 +148,12 @@ function createWorkflowTool(deps) {
 				toolExecutorConfig: deps.toolExecutorConfig,
 				buildChildTools: deps.buildChildTools
 			});
-			const resolveModelId = (modelId) => resolveModel(modelId);
+			const resolveModelId = (modelRef) => {
+				const config = deps.getConfig();
+				if (!config) throw new Error("workflow model resolution requires config");
+				const sessionKey = deps.getCurrentSessionKey?.();
+				return resolveModel(resolveModelRef(config, extractProfileAgentId(sessionKey, config), modelRef));
+			};
 			const controller = new AbortController();
 			const onParentAbort = () => controller.abort();
 			signal?.addEventListener("abort", onParentAbort, { once: true });
@@ -152,24 +178,46 @@ function createWorkflowTool(deps) {
 						if (!snapshot.phases.includes(title)) snapshot.phases.push(title);
 						pushUpdate();
 					},
-					onAgentStart: (event) => {
+					onAgentQueued: (event) => {
 						snapshot.agents.push({
 							id: event.id,
 							label: event.label,
 							phase: event.phase,
 							prompt: event.prompt,
-							status: "running"
+							status: "queued"
 						});
-						pushUpdate();
+						pushUpdate(false, true);
+					},
+					onAgentStart: (event) => {
+						const agent = findAgentById(snapshot.agents, event.id);
+						if (agent) {
+							agent.status = "running";
+							agent.startedAtMs = Date.now();
+						} else snapshot.agents.push({
+							id: event.id,
+							label: event.label,
+							phase: event.phase,
+							prompt: event.prompt,
+							status: "running",
+							startedAtMs: Date.now()
+						});
+						pushUpdate(false, true);
 					},
 					onAgentEnd: (event) => {
 						const agent = findAgentById(snapshot.agents, event.id);
 						if (agent) {
 							agent.status = event.status;
 							agent.resultPreview = previewValue(event.result);
+							if (agent.startedAtMs != null) agent.durationMs = Date.now() - agent.startedAtMs;
+							agent.currentStep = void 0;
 						}
-						pushUpdate();
-					}
+						pushUpdate(false, true);
+					},
+					enhanceSubagentRun: subagentStream === "off" ? void 0 : ({ id }) => ({ onProgress: (event) => {
+						const agent = findAgentById(snapshot.agents, id);
+						if (!agent) return;
+						if (applySubagentProgress(agent, event)) pushUpdate();
+					} })
 				});
 				if (result.agentCount === 0) {
 					const reason = "workflow scripts must call agent() at least once; this workflow declared phases but never ran a subagent.";