@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/voice/tts/speak-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"speak-core.js","names":[],"sources":["../../../../src/voice/tts/speak-core.ts"],"sourcesContent":["/**\n * speak-core — orchestrates per-call TTS synthesis through the SpeechProviderPlugin chain.\n *\n * Provider invocation goes through `plugin.synthesize` / `plugin.synthesizeStream`.\n * Streaming consumers (Telegram draft etc.) use `speakStream`; providers without\n * `synthesizeStream` automatically fall back to `synthesize` wrapped as a\n * single-chunk ReadableStream (see wrapBufferAsStream).\n *\n * Directive overrides are routed via per-provider buckets (`overrides.openai`,\n * `overrides.minimax`, …). The bucket whose key matches the currently active\n * provider id wins; cross-provider keys are ignored.\n *\n * `cfg: Config` is threaded through `SpeakOptions.appConfig`. The orchestrator\n * does NOT auto-summarize / preprocess for `speakStream` beyond the same path\n * as `speak`; streaming is a transport optimization, not a different semantic.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { parseTtsDirectives } from './directives.js';\nimport { resolveSpeechProviderChain, resolveSpeechProvider, type ResolvedSpeechProvider } from './factory.js';\nimport { preprocessText, type PreprocessOptions, type PreprocessResult } from './preprocess.js';\nimport type {\n  SpeechProviderOverrides,\n  SpeechSynthesisRequest,\n  SpeechSynthesisResult,\n  SpeechSynthesisStreamRequest,\n  SpeechSynthesisStreamResult,\n} from './speech-provider-types.js';\nimport { summarizeForTts } from './summarize.js';\nimport type {\n  ProviderAttempt,\n  ProviderFailureReason,\n  TTSConfig,\n  TTSModelOverrideConfig,\n  TTSOptions,\n  TTSProvider,\n  TTSResultWithTracking,\n  TtsDirectiveOverrides,\n} from './types.js';\n\nconst log = createLogger('TTS');\n\nexport interface SpeakOptions {\n  tts?: TTSOptions;\n  preprocess?: PreprocessOptions;\n  parseDirectives?: boolean;\n  modelOverrides?: TTSModelOverrideConfig;\n  appConfig?: Config;\n  /** Optional caller-supplied AbortSignal (currently passed through to providers via timeoutMs guard only). */\n  signal?: AbortSignal;\n}\n\n/** Pulls the override bucket for a given provider id from the directive overrides. */\nfunction pickProviderOverrides(\n  overrides: TtsDirectiveOverrides | undefined,\n  providerId: TTSProvider,\n): SpeechProviderOverrides | undefined {\n  if (!overrides) return undefined;\n  const bucket = (overrides as Record<string, unknown>)[providerId];\n  if (bucket && typeof bucket === 'object') {\n    return bucket as SpeechProviderOverrides;\n  }\n  return undefined;\n}\n\n/** Merges TTSOptions (caller-supplied) with directive bucket. Directive wins on overlap. */\nfunction mergeOverrides(\n  ttsOptions: TTSOptions | undefined,\n  directiveBucket: SpeechProviderOverrides | undefined,\n): SpeechProviderOverrides | undefined {\n  const merged: Record<string, unknown> = {};\n  if (ttsOptions?.voice) merged.voice = ttsOptions.voice;\n  if (ttsOptions?.model) merged.model = ttsOptions.model;\n  if (ttsOptions?.speed) merged.speed = ttsOptions.speed;\n  if (directiveBucket) {\n    Object.assign(merged, directiveBucket);\n  }\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nfunction classifyError(error: unknown): ProviderFailureReason {\n  if (error instanceof Error) {\n    const message = error.message.toLowerCase();\n    if (message.includes('not configured') || message.includes('api key')) {\n      return 'not_configured';\n    }\n    if (message.includes('timeout') || message.includes('timed out') || message.includes('aborted')) {\n      return 'timeout';\n    }\n    if (message.includes('too long') || message.includes('text length') || message.includes('exceeds')) {\n      return 'text_too_long';\n    }\n    return 'provider_error';\n  }\n  return 'unknown';\n}\n\n/** Common pre-flight: directive parse → preprocess → optional summarize. */\nasync function prepareTextForSynthesis(\n  text: string,\n  config: TTSConfig,\n  options: SpeakOptions | undefined,\n): Promise<{\n  text: string;\n  wasPreprocessed: boolean;\n  wasSummarized: boolean;\n  ttsOptions: TTSOptions | undefined;\n  directiveOverrides: TtsDirectiveOverrides | undefined;\n  selectedProvider: TTSProvider;\n}> {\n  let ttsText = text;\n  let ttsOptions = options?.tts;\n  let directiveOverrides: TtsDirectiveOverrides | undefined;\n  let selectedProvider: TTSProvider = config.provider;\n\n  if (options?.parseDirectives !== false && config.modelOverrides?.enabled) {\n    const directiveResult = parseTtsDirectives(text, config.modelOverrides);\n    ttsText = directiveResult.ttsText || directiveResult.cleanedText;\n    directiveOverrides = directiveResult.overrides;\n    if (directiveResult.overrides?.provider) {\n      selectedProvider = directiveResult.overrides.provider;\n    }\n  }\n\n  const maxLength = config.maxTextLength || 4096;\n  const preprocessOptions: PreprocessOptions = {\n    maxLength,\n    stripMarkdown: true,\n    normalizeWhitespace: true,\n    ...options?.preprocess,\n  };\n\n  let preprocessResult: PreprocessResult = preprocessText(ttsText, preprocessOptions);\n  const wasPreprocessed =\n    preprocessResult.wasTruncated || preprocessResult.originalLength !== preprocessResult.finalLength;\n\n  let wasSummarized = false;\n  const sumCfg = config.summarization;\n  const threshold = sumCfg?.threshold ?? maxLength;\n  if (sumCfg?.enabled !== false && preprocessResult.text.length > threshold) {\n    const summarizeResult = await summarizeForTts({\n      text: preprocessResult.text,\n      targetLength: sumCfg?.targetLength ?? maxLength,\n      config: options?.appConfig,\n      modelRef: sumCfg?.model,\n    });\n    if (summarizeResult.wasSummarized) {\n      preprocessResult = {\n        ...preprocessResult,\n        text: summarizeResult.summary,\n        finalLength: summarizeResult.summaryLength,\n        wasTruncated: false,\n      };\n      wasSummarized = true;\n      log.info(\n        {\n          originalLength: summarizeResult.originalLength,\n          summaryLength: summarizeResult.summaryLength,\n        },\n        'Text summarized before TTS',\n      );\n    }\n  }\n\n  return {\n    text: preprocessResult.text,\n    wasPreprocessed,\n    wasSummarized,\n    ttsOptions,\n    directiveOverrides,\n    selectedProvider,\n  };\n}\n\n/** Build the SpeechSynthesisRequest from a resolved provider + prepared text. */\nfunction buildSynthesisRequest(\n  resolved: ResolvedSpeechProvider,\n  preparedText: string,\n  ttsOptions: TTSOptions | undefined,\n  directiveOverrides: TtsDirectiveOverrides | undefined,\n  appConfig: Config | undefined,\n  target: 'audio-file' | 'voice-note',\n): SpeechSynthesisRequest {\n  const directiveBucket = pickProviderOverrides(directiveOverrides, resolved.providerId);\n  const providerOverrides = mergeOverrides(ttsOptions, directiveBucket);\n  const callTimeoutMs = ttsOptions?.timeoutMs ?? resolved.timeoutMs;\n  return {\n    text: preparedText,\n    cfg: appConfig as Config,\n    providerConfig: resolved.providerConfig,\n    target,\n    timeoutMs: callTimeoutMs,\n    ...(providerOverrides ? { providerOverrides } : {}),\n  };\n}\n\n/** Convert SpeechSynthesisResult → TTSResult shape (audio/format/provider). */\nfunction toLegacyResult(\n  resolved: ResolvedSpeechProvider,\n  result: SpeechSynthesisResult,\n  durationSeconds: number | undefined,\n): { audio: Buffer; format: string; provider: string; duration?: number } {\n  return {\n    audio: result.audioBuffer,\n    format: result.outputFormat,\n    provider: resolved.providerId,\n    ...(durationSeconds !== undefined ? { duration: durationSeconds } : {}),\n  };\n}\n\n// ---- Public API ---------------------------------------------------------\n\n/**\n * Run the TTS chain (primary → fallback) and return the first successful result.\n */\nexport async function speak(\n  text: string,\n  config: TTSConfig,\n  options?: SpeakOptions,\n): Promise<TTSResultWithTracking> {\n  if (!config.enabled) {\n    throw new Error('TTS is not enabled');\n  }\n  if (config.trigger === 'tagged' && !/\\[\\[tts/.test(text)) {\n    throw new Error('TTS trigger is tagged but no [[tts]] directive found');\n  }\n\n  const prepared = await prepareTextForSynthesis(text, config, options);\n  const chain = resolveSpeechProviderChain(config);\n\n  // Reorder so the directive-selected provider (if registered + configured) goes first.\n  const orderedChain = (() => {\n    const idx = chain.findIndex((c) => c.providerId === prepared.selectedProvider);\n    if (idx <= 0) return chain;\n    const reordered = [...chain];\n    const [picked] = reordered.splice(idx, 1);\n    if (picked) {\n      reordered.unshift(picked);\n    }\n    return reordered;\n  })();\n\n  const attempts: ProviderAttempt[] = [];\n  const attemptedProviders: string[] = [];\n  let lastError: Error | undefined;\n\n  for (const resolved of orderedChain) {\n    const startTime = Date.now();\n    attemptedProviders.push(resolved.providerId);\n\n    if (typeof resolved.plugin.synthesize !== 'function') {\n      attempts.push({\n        provider: resolved.providerId,\n        outcome: 'skipped',\n        reasonCode: 'not_configured',\n        latencyMs: Date.now() - startTime,\n        error: `Provider \"${resolved.providerId}\" does not implement synthesize()`,\n      });\n      continue;\n    }\n\n    try {\n      log.debug(\n        { textLength: prepared.text.length, provider: resolved.providerId },\n        'Converting text to speech',\n      );\n      const request = buildSynthesisRequest(\n        resolved,\n        prepared.text,\n        prepared.ttsOptions,\n        prepared.directiveOverrides,\n        options?.appConfig,\n        'audio-file',\n      );\n      const result = await resolved.plugin.synthesize(request);\n      const durationSeconds = (Date.now() - startTime) / 1000;\n      attempts.push({\n        provider: resolved.providerId,\n        outcome: 'success',\n        reasonCode: 'success',\n        latencyMs: Date.now() - startTime,\n      });\n\n      const primaryProvider = orderedChain[0]!.providerId;\n      const fallbackFrom = resolved.providerId !== primaryProvider ? primaryProvider : undefined;\n      if (fallbackFrom) {\n        log.info(\n          { primaryProvider: fallbackFrom, actualProvider: resolved.providerId, attempts },\n          'TTS used fallback provider',\n        );\n      } else {\n        log.info(\n          { provider: resolved.providerId, format: result.outputFormat, size: result.audioBuffer.length },\n          'TTS succeeded',\n        );\n      }\n\n      return {\n        ...toLegacyResult(resolved, result, durationSeconds),\n        attempts,\n        ...(fallbackFrom ? { fallbackFrom } : {}),\n        attemptedProviders,\n        wasPreprocessed: prepared.wasPreprocessed,\n        ttsText: prepared.text,\n        wasSummarized: prepared.wasSummarized,\n      };\n    } catch (error) {\n      const latencyMs = Date.now() - startTime;\n      const reasonCode = classifyError(error);\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      attempts.push({\n        provider: resolved.providerId,\n        outcome: 'failed',\n        reasonCode,\n        latencyMs,\n        error: errorMsg,\n      });\n      lastError = error instanceof Error ? error : new Error(String(error));\n      log.warn(\n        { provider: resolved.providerId, errorMessage: errorMsg, reasonCode, latencyMs },\n        'TTS provider failed, trying next',\n      );\n    }\n  }\n\n  log.error({ attempts, attemptedProviders }, 'All TTS providers failed');\n  throw (\n    lastError ?? new Error(`All TTS providers failed: ${attempts.map((a) => a.error).join('; ')}`)\n  );\n}\n\n/** Single-provider variant; bypasses the fallback chain. */\nexport async function speakWithProvider(\n  text: string,\n  config: TTSConfig,\n  providerName: TTSProvider,\n  options?: SpeakOptions,\n): Promise<TTSResultWithTracking> {\n  if (!config.enabled) {\n    throw new Error('TTS is not enabled');\n  }\n  const resolved = resolveSpeechProvider(providerName, config);\n  if (!resolved) {\n    throw new Error(`Provider '${providerName}' is not available`);\n  }\n  if (typeof resolved.plugin.synthesize !== 'function') {\n    throw new Error(`Provider '${providerName}' does not implement synthesize()`);\n  }\n\n  const prepared = await prepareTextForSynthesis(text, config, options);\n  const startTime = Date.now();\n  const request = buildSynthesisRequest(\n    resolved,\n    prepared.text,\n    prepared.ttsOptions,\n    prepared.directiveOverrides,\n    options?.appConfig,\n    'audio-file',\n  );\n  const result = await resolved.plugin.synthesize(request);\n  const durationSeconds = (Date.now() - startTime) / 1000;\n\n  return {\n    ...toLegacyResult(resolved, result, durationSeconds),\n    attempts: [\n      {\n        provider: providerName,\n        outcome: 'success',\n        reasonCode: 'success',\n        latencyMs: Date.now() - startTime,\n      },\n    ],\n    attemptedProviders: [providerName],\n    wasPreprocessed: prepared.wasPreprocessed,\n    ttsText: prepared.text,\n    wasSummarized: prepared.wasSummarized,\n  };\n}\n\n// ---- Streaming surface --------------------------------------------------\n\nexport interface SpeakStreamResult {\n  /** Audio chunks. Caller is responsible for consuming the stream. */\n  audioStream: ReadableStream<Uint8Array>;\n  outputFormat: string;\n  fileExtension: string;\n  voiceCompatible: boolean;\n  /** Provider id that produced this stream. */\n  provider: TTSProvider;\n  /** Cleanup hook (close sockets etc.). Always defined; no-op when nothing to release. */\n  release: () => Promise<void>;\n  /** Pre-flight metadata (after directive parse / preprocess / summarize). */\n  ttsText: string;\n  wasPreprocessed: boolean;\n  wasSummarized: boolean;\n}\n\n/**\n * Streaming TTS — tries the chain and returns the first provider's stream.\n * Providers without `synthesizeStream` are wrapped via wrapBufferAsStream.\n */\nexport async function speakStream(\n  text: string,\n  config: TTSConfig,\n  options?: SpeakOptions,\n): Promise<SpeakStreamResult> {\n  if (!config.enabled) {\n    throw new Error('TTS is not enabled');\n  }\n  if (config.trigger === 'tagged' && !/\\[\\[tts/.test(text)) {\n    throw new Error('TTS trigger is tagged but no [[tts]] directive found');\n  }\n\n  const prepared = await prepareTextForSynthesis(text, config, options);\n  const chain = resolveSpeechProviderChain(config);\n\n  let lastError: Error | undefined;\n  for (const resolved of chain) {\n    try {\n      const baseRequest: SpeechSynthesisStreamRequest = buildSynthesisRequest(\n        resolved,\n        prepared.text,\n        prepared.ttsOptions,\n        prepared.directiveOverrides,\n        options?.appConfig,\n        'voice-note',\n      );\n\n      let streamResult: SpeechSynthesisStreamResult;\n      if (typeof resolved.plugin.synthesizeStream === 'function') {\n        streamResult = await resolved.plugin.synthesizeStream(baseRequest);\n      } else if (typeof resolved.plugin.synthesize === 'function') {\n        // Fallback: buffer-then-wrap. Documented behavior: callers see a\n        // single-chunk stream with the same outputFormat.\n        const bufferResult = await resolved.plugin.synthesize(baseRequest);\n        streamResult = wrapBufferAsStream(bufferResult);\n      } else {\n        throw new Error(\n          `Provider \"${resolved.providerId}\" implements neither synthesize nor synthesizeStream`,\n        );\n      }\n\n      log.info(\n        {\n          provider: resolved.providerId,\n          outputFormat: streamResult.outputFormat,\n          voiceCompatible: streamResult.voiceCompatible,\n          streamed: typeof resolved.plugin.synthesizeStream === 'function',\n        },\n        'TTS stream ready',\n      );\n\n      const release = streamResult.release ?? (async () => {});\n      return {\n        audioStream: streamResult.audioStream,\n        outputFormat: streamResult.outputFormat,\n        fileExtension: streamResult.fileExtension,\n        voiceCompatible: streamResult.voiceCompatible,\n        provider: resolved.providerId,\n        release,\n        ttsText: prepared.text,\n        wasPreprocessed: prepared.wasPreprocessed,\n        wasSummarized: prepared.wasSummarized,\n      };\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n      log.warn(\n        { err: lastError, provider: resolved.providerId },\n        `TTS stream provider \"${resolved.providerId}\" failed, trying next`,\n      );\n    }\n  }\n  throw lastError ?? new Error('All TTS providers failed (streaming)');\n}\n\n/** Wrap a one-shot synthesis result into a single-chunk stream (no-op release). */\nfunction wrapBufferAsStream(result: SpeechSynthesisResult): SpeechSynthesisStreamResult {\n  const { audioBuffer } = result;\n  const audioStream = new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.enqueue(new Uint8Array(audioBuffer));\n      controller.close();\n    },\n  });\n  return {\n    audioStream,\n    outputFormat: result.outputFormat,\n    fileExtension: result.fileExtension,\n    voiceCompatible: result.voiceCompatible,\n  };\n}\n"],"mappings":";;;;;;;aAkBqD;AAwBrD,MAAM,MAAM,aAAa,MAAM;;AAa/B,SAAS,sBACP,WACA,YACqC;AACrC,KAAI,CAAC,UAAW,QAAO,KAAA;CACvB,MAAM,SAAU,UAAsC;AACtD,KAAI,UAAU,OAAO,WAAW,SAC9B,QAAO;;;AAMX,SAAS,eACP,YACA,iBACqC;CACrC,MAAM,SAAkC,EAAE;AAC1C,KAAI,YAAY,MAAO,QAAO,QAAQ,WAAW;AACjD,KAAI,YAAY,MAAO,QAAO,QAAQ,WAAW;AACjD,KAAI,YAAY,MAAO,QAAO,QAAQ,WAAW;AACjD,KAAI,gBACF,QAAO,OAAO,QAAQ,gBAAgB;AAExC,QAAO,OAAO,KAAK,OAAO,CAAC,SAAS,IAAI,SAAS,KAAA;;AAGnD,SAAS,cAAc,OAAuC;AAC5D,KAAI,iBAAiB,OAAO;EAC1B,MAAM,UAAU,MAAM,QAAQ,aAAa;AAC3C,MAAI,QAAQ,SAAS,iBAAiB,IAAI,QAAQ,SAAS,UAAU,CACnE,QAAO;AAET,MAAI,QAAQ,SAAS,UAAU,IAAI,QAAQ,SAAS,YAAY,IAAI,QAAQ,SAAS,UAAU,CAC7F,QAAO;AAET,MAAI,QAAQ,SAAS,WAAW,IAAI,QAAQ,SAAS,cAAc,IAAI,QAAQ,SAAS,UAAU,CAChG,QAAO;AAET,SAAO;;AAET,QAAO;;;AAIT,eAAe,wBACb,MACA,QACA,SAQC;CACD,IAAI,UAAU;CACd,IAAI,aAAa,SAAS;CAC1B,IAAI;CACJ,IAAI,mBAAgC,OAAO;AAE3C,KAAI,SAAS,oBAAoB,SAAS,OAAO,gBAAgB,SAAS;EACxE,MAAM,kBAAkB,mBAAmB,MAAM,OAAO,eAAe;AACvE,YAAU,gBAAgB,WAAW,gBAAgB;AACrD,uBAAqB,gBAAgB;AACrC,MAAI,gBAAgB,WAAW,SAC7B,oBAAmB,gBAAgB,UAAU;;CAIjD,MAAM,YAAY,OAAO,iBAAiB;CAC1C,MAAM,oBAAuC;EAC3C;EACA,eAAe;EACf,qBAAqB;EACrB,GAAG,SAAS;EACb;CAED,IAAI,mBAAqC,eAAe,SAAS,kBAAkB;CACnF,MAAM,kBACJ,iBAAiB,gBAAgB,iBAAiB,mBAAmB,iBAAiB;CAExF,IAAI,gBAAgB;CACpB,MAAM,SAAS,OAAO;CACtB,MAAM,YAAY,QAAQ,aAAa;AACvC,KAAI,QAAQ,YAAY,SAAS,iBAAiB,KAAK,SAAS,WAAW;EACzE,MAAM,kBAAkB,MAAM,gBAAgB;GAC5C,MAAM,iBAAiB;GACvB,cAAc,QAAQ,gBAAgB;GACtC,QAAQ,SAAS;GACjB,UAAU,QAAQ;GACnB,CAAC;AACF,MAAI,gBAAgB,eAAe;AACjC,sBAAmB;IACjB,GAAG;IACH,MAAM,gBAAgB;IACtB,aAAa,gBAAgB;IAC7B,cAAc;IACf;AACD,mBAAgB;AAChB,OAAI,KACF;IACE,gBAAgB,gBAAgB;IAChC,eAAe,gBAAgB;IAChC,EACD,6BACD;;;AAIL,QAAO;EACL,MAAM,iBAAiB;EACvB;EACA;EACA;EACA;EACA;EACD;;;AAIH,SAAS,sBACP,UACA,cACA,YACA,oBACA,WACA,QACwB;CAExB,MAAM,oBAAoB,eAAe,YADjB,sBAAsB,oBAAoB,SAAS,WACP,CAAC;CACrE,MAAM,gBAAgB,YAAY,aAAa,SAAS;AACxD,QAAO;EACL,MAAM;EACN,KAAK;EACL,gBAAgB,SAAS;EACzB;EACA,WAAW;EACX,GAAI,oBAAoB,EAAE,mBAAmB,GAAG,EAAE;EACnD;;;AAIH,SAAS,eACP,UACA,QACA,iBACwE;AACxE,QAAO;EACL,OAAO,OAAO;EACd,QAAQ,OAAO;EACf,UAAU,SAAS;EACnB,GAAI,oBAAoB,KAAA,IAAY,EAAE,UAAU,iBAAiB,GAAG,EAAE;EACvE;;;;;AAQH,eAAsB,MACpB,MACA,QACA,SACgC;AAChC,KAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,qBAAqB;AAEvC,KAAI,OAAO,YAAY,YAAY,CAAC,UAAU,KAAK,KAAK,CACtD,OAAM,IAAI,MAAM,uDAAuD;CAGzE,MAAM,WAAW,MAAM,wBAAwB,MAAM,QAAQ,QAAQ;CACrE,MAAM,QAAQ,2BAA2B,OAAO;CAGhD,MAAM,sBAAsB;EAC1B,MAAM,MAAM,MAAM,WAAW,MAAM,EAAE,eAAe,SAAS,iBAAiB;AAC9E,MAAI,OAAO,EAAG,QAAO;EACrB,MAAM,YAAY,CAAC,GAAG,MAAM;EAC5B,MAAM,CAAC,UAAU,UAAU,OAAO,KAAK,EAAE;AACzC,MAAI,OACF,WAAU,QAAQ,OAAO;AAE3B,SAAO;KACL;CAEJ,MAAM,WAA8B,EAAE;CACtC,MAAM,qBAA+B,EAAE;CACvC,IAAI;AAEJ,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,YAAY,KAAK,KAAK;AAC5B,qBAAmB,KAAK,SAAS,WAAW;AAE5C,MAAI,OAAO,SAAS,OAAO,eAAe,YAAY;AACpD,YAAS,KAAK;IACZ,UAAU,SAAS;IACnB,SAAS;IACT,YAAY;IACZ,WAAW,KAAK,KAAK,GAAG;IACxB,OAAO,aAAa,SAAS,WAAW;IACzC,CAAC;AACF;;AAGF,MAAI;AACF,OAAI,MACF;IAAE,YAAY,SAAS,KAAK;IAAQ,UAAU,SAAS;IAAY,EACnE,4BACD;GACD,MAAM,UAAU,sBACd,UACA,SAAS,MACT,SAAS,YACT,SAAS,oBACT,SAAS,WACT,aACD;GACD,MAAM,SAAS,MAAM,SAAS,OAAO,WAAW,QAAQ;GACxD,MAAM,mBAAmB,KAAK,KAAK,GAAG,aAAa;AACnD,YAAS,KAAK;IACZ,UAAU,SAAS;IACnB,SAAS;IACT,YAAY;IACZ,WAAW,KAAK,KAAK,GAAG;IACzB,CAAC;GAEF,MAAM,kBAAkB,aAAa,GAAI;GACzC,MAAM,eAAe,SAAS,eAAe,kBAAkB,kBAAkB,KAAA;AACjF,OAAI,aACF,KAAI,KACF;IAAE,iBAAiB;IAAc,gBAAgB,SAAS;IAAY;IAAU,EAChF,6BACD;OAED,KAAI,KACF;IAAE,UAAU,SAAS;IAAY,QAAQ,OAAO;IAAc,MAAM,OAAO,YAAY;IAAQ,EAC/F,gBACD;AAGH,UAAO;IACL,GAAG,eAAe,UAAU,QAAQ,gBAAgB;IACpD;IACA,GAAI,eAAe,EAAE,cAAc,GAAG,EAAE;IACxC;IACA,iBAAiB,SAAS;IAC1B,SAAS,SAAS;IAClB,eAAe,SAAS;IACzB;WACM,OAAO;GACd,MAAM,YAAY,KAAK,KAAK,GAAG;GAC/B,MAAM,aAAa,cAAc,MAAM;GACvC,MAAM,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACvE,YAAS,KAAK;IACZ,UAAU,SAAS;IACnB,SAAS;IACT;IACA;IACA,OAAO;IACR,CAAC;AACF,eAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,OAAI,KACF;IAAE,UAAU,SAAS;IAAY,cAAc;IAAU;IAAY;IAAW,EAChF,mCACD;;;AAIL,KAAI,MAAM;EAAE;EAAU;EAAoB,EAAE,2BAA2B;AACvE,OACE,6BAAa,IAAI,MAAM,6BAA6B,SAAS,KAAK,MAAM,EAAE,MAAM,CAAC,KAAK,KAAK,GAAG;;;AAKlG,eAAsB,kBACpB,MACA,QACA,cACA,SACgC;AAChC,KAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,qBAAqB;CAEvC,MAAM,WAAW,sBAAsB,cAAc,OAAO;AAC5D,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,aAAa,aAAa,oBAAoB;AAEhE,KAAI,OAAO,SAAS,OAAO,eAAe,WACxC,OAAM,IAAI,MAAM,aAAa,aAAa,mCAAmC;CAG/E,MAAM,WAAW,MAAM,wBAAwB,MAAM,QAAQ,QAAQ;CACrE,MAAM,YAAY,KAAK,KAAK;CAC5B,MAAM,UAAU,sBACd,UACA,SAAS,MACT,SAAS,YACT,SAAS,oBACT,SAAS,WACT,aACD;AAID,QAAO;EACL,GAAG,eAAe,UAAU,MAJT,SAAS,OAAO,WAAW,QAAQ,GAC/B,KAAK,KAAK,GAAG,aAAa,IAGG;EACpD,UAAU,CACR;GACE,UAAU;GACV,SAAS;GACT,YAAY;GACZ,WAAW,KAAK,KAAK,GAAG;GACzB,CACF;EACD,oBAAoB,CAAC,aAAa;EAClC,iBAAiB,SAAS;EAC1B,SAAS,SAAS;EAClB,eAAe,SAAS;EACzB;;;;;;AAyBH,eAAsB,YACpB,MACA,QACA,SAC4B;AAC5B,KAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,qBAAqB;AAEvC,KAAI,OAAO,YAAY,YAAY,CAAC,UAAU,KAAK,KAAK,CACtD,OAAM,IAAI,MAAM,uDAAuD;CAGzE,MAAM,WAAW,MAAM,wBAAwB,MAAM,QAAQ,QAAQ;CACrE,MAAM,QAAQ,2BAA2B,OAAO;CAEhD,IAAI;AACJ,MAAK,MAAM,YAAY,MACrB,KAAI;EACF,MAAM,cAA4C,sBAChD,UACA,SAAS,MACT,SAAS,YACT,SAAS,oBACT,SAAS,WACT,aACD;EAED,IAAI;AACJ,MAAI,OAAO,SAAS,OAAO,qBAAqB,WAC9C,gBAAe,MAAM,SAAS,OAAO,iBAAiB,YAAY;WACzD,OAAO,SAAS,OAAO,eAAe,WAI/C,gBAAe,mBAAmB,MADP,SAAS,OAAO,WAAW,YAAY,CACnB;MAE/C,OAAM,IAAI,MACR,aAAa,SAAS,WAAW,sDAClC;AAGH,MAAI,KACF;GACE,UAAU,SAAS;GACnB,cAAc,aAAa;GAC3B,iBAAiB,aAAa;GAC9B,UAAU,OAAO,SAAS,OAAO,qBAAqB;GACvD,EACD,mBACD;EAED,MAAM,UAAU,aAAa,YAAY,YAAY;AACrD,SAAO;GACL,aAAa,aAAa;GAC1B,cAAc,aAAa;GAC3B,eAAe,aAAa;GAC5B,iBAAiB,aAAa;GAC9B,UAAU,SAAS;GACnB;GACA,SAAS,SAAS;GAClB,iBAAiB,SAAS;GAC1B,eAAe,SAAS;GACzB;UACM,OAAO;AACd,cAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,MAAI,KACF;GAAE,KAAK;GAAW,UAAU,SAAS;GAAY,EACjD,wBAAwB,SAAS,WAAW,uBAC7C;;AAGL,OAAM,6BAAa,IAAI,MAAM,uCAAuC;;;AAItE,SAAS,mBAAmB,QAA4D;CACtF,MAAM,EAAE,gBAAgB;AAOxB,QAAO;EACL,aAAA,IAPsB,eAA2B,EACjD,MAAM,YAAY;AAChB,cAAW,QAAQ,IAAI,WAAW,YAAY,CAAC;AAC/C,cAAW,OAAO;KAErB,CAEY;EACX,cAAc,OAAO;EACrB,eAAe,OAAO;EACtB,iBAAiB,OAAO;EACzB"}
+{"version":3,"file":"speak-core.js","names":[],"sources":["../../../../src/voice/tts/speak-core.ts"],"sourcesContent":["/**\n * speak-core — orchestrates per-call TTS synthesis through the SpeechProviderPlugin chain.\n *\n * Provider invocation goes through `plugin.synthesize` / `plugin.synthesizeStream`.\n * Streaming consumers (Telegram draft etc.) use `speakStream`; providers without\n * `synthesizeStream` automatically fall back to `synthesize` wrapped as a\n * single-chunk ReadableStream (see wrapBufferAsStream).\n *\n * Directive overrides are routed via per-provider buckets (`overrides.openai`,\n * `overrides.minimax`, …). The bucket whose key matches the currently active\n * provider id wins; cross-provider keys are ignored.\n *\n * `cfg: Config` is threaded through `SpeakOptions.appConfig`. The orchestrator\n * does NOT auto-summarize / preprocess for `speakStream` beyond the same path\n * as `speak`; streaming is a transport optimization, not a different semantic.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { parseTtsDirectives } from './directives.js';\nimport { resolveSpeechProviderChain, resolveSpeechProvider, type ResolvedSpeechProvider } from './factory.js';\nimport { preprocessText, type PreprocessOptions, type PreprocessResult } from './preprocess.js';\nimport type {\n  SpeechProviderOverrides,\n  SpeechSynthesisRequest,\n  SpeechSynthesisResult,\n  SpeechSynthesisStreamRequest,\n  SpeechSynthesisStreamResult,\n} from './speech-provider-types.js';\nimport { summarizeForTts } from './summarize.js';\nimport type {\n  ProviderAttempt,\n  ProviderFailureReason,\n  TTSConfig,\n  TTSModelOverrideConfig,\n  TTSOptions,\n  TTSProvider,\n  TTSResultWithTracking,\n  TtsDirectiveOverrides,\n} from './types.js';\n\nconst log = createLogger('TTS');\n\nexport interface SpeakOptions {\n  tts?: TTSOptions;\n  preprocess?: PreprocessOptions;\n  parseDirectives?: boolean;\n  modelOverrides?: TTSModelOverrideConfig;\n  appConfig?: Config;\n  /** Optional caller-supplied AbortSignal (currently passed through to providers via timeoutMs guard only). */\n  signal?: AbortSignal;\n}\n\n/** Pulls the override bucket for a given provider id from the directive overrides. */\nfunction pickProviderOverrides(\n  overrides: TtsDirectiveOverrides | undefined,\n  providerId: TTSProvider,\n): SpeechProviderOverrides | undefined {\n  if (!overrides) return undefined;\n  const bucket = (overrides as Record<string, unknown>)[providerId];\n  if (bucket && typeof bucket === 'object') {\n    return bucket as SpeechProviderOverrides;\n  }\n  return undefined;\n}\n\n/** Merges TTSOptions (caller-supplied) with directive bucket. Directive wins on overlap. */\nfunction mergeOverrides(\n  ttsOptions: TTSOptions | undefined,\n  directiveBucket: SpeechProviderOverrides | undefined,\n): SpeechProviderOverrides | undefined {\n  const merged: Record<string, unknown> = {};\n  if (ttsOptions?.voice) merged.voice = ttsOptions.voice;\n  if (ttsOptions?.model) merged.model = ttsOptions.model;\n  if (ttsOptions?.speed) merged.speed = ttsOptions.speed;\n  if (directiveBucket) {\n    Object.assign(merged, directiveBucket);\n  }\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nfunction classifyError(error: unknown): ProviderFailureReason {\n  if (error instanceof Error) {\n    const message = error.message.toLowerCase();\n    if (message.includes('not configured') || message.includes('api key')) {\n      return 'not_configured';\n    }\n    if (message.includes('timeout') || message.includes('timed out') || message.includes('aborted')) {\n      return 'timeout';\n    }\n    if (message.includes('too long') || message.includes('text length') || message.includes('exceeds')) {\n      return 'text_too_long';\n    }\n    return 'provider_error';\n  }\n  return 'unknown';\n}\n\n/** Common pre-flight: directive parse → preprocess → optional summarize. */\nasync function prepareTextForSynthesis(\n  text: string,\n  config: TTSConfig,\n  options: SpeakOptions | undefined,\n): Promise<{\n  text: string;\n  wasPreprocessed: boolean;\n  wasSummarized: boolean;\n  ttsOptions: TTSOptions | undefined;\n  directiveOverrides: TtsDirectiveOverrides | undefined;\n  selectedProvider: TTSProvider;\n}> {\n  let ttsText = text;\n  let ttsOptions = options?.tts;\n  let directiveOverrides: TtsDirectiveOverrides | undefined;\n  let selectedProvider: TTSProvider = config.provider;\n\n  if (options?.parseDirectives !== false && config.modelOverrides?.enabled) {\n    const directiveResult = parseTtsDirectives(text, config.modelOverrides);\n    ttsText = directiveResult.ttsText || directiveResult.cleanedText;\n    directiveOverrides = directiveResult.overrides;\n    if (directiveResult.overrides?.provider) {\n      selectedProvider = directiveResult.overrides.provider;\n    }\n  }\n\n  const maxLength = config.maxTextLength || 4096;\n  const preprocessOptions: PreprocessOptions = {\n    maxLength,\n    stripMarkdown: true,\n    normalizeWhitespace: true,\n    ...options?.preprocess,\n  };\n\n  let preprocessResult: PreprocessResult = preprocessText(ttsText, preprocessOptions);\n  const wasPreprocessed =\n    preprocessResult.wasTruncated || preprocessResult.originalLength !== preprocessResult.finalLength;\n\n  let wasSummarized = false;\n  const sumCfg = config.summarization;\n  const threshold = sumCfg?.threshold ?? maxLength;\n  if (sumCfg?.enabled !== false && preprocessResult.text.length > threshold) {\n    const summarizeResult = await summarizeForTts({\n      text: preprocessResult.text,\n      targetLength: sumCfg?.targetLength ?? maxLength,\n      config: options?.appConfig,\n      modelRef: sumCfg?.model,\n    });\n    if (summarizeResult.wasSummarized) {\n      preprocessResult = {\n        ...preprocessResult,\n        text: summarizeResult.summary,\n        finalLength: summarizeResult.summaryLength,\n        wasTruncated: false,\n      };\n      wasSummarized = true;\n      log.info(\n        {\n          originalLength: summarizeResult.originalLength,\n          summaryLength: summarizeResult.summaryLength,\n        },\n        'Text summarized before TTS',\n      );\n    }\n  }\n\n  return {\n    text: preprocessResult.text,\n    wasPreprocessed,\n    wasSummarized,\n    ttsOptions,\n    directiveOverrides,\n    selectedProvider,\n  };\n}\n\n/** Build the SpeechSynthesisRequest from a resolved provider + prepared text. */\nfunction buildSynthesisRequest(\n  resolved: ResolvedSpeechProvider,\n  preparedText: string,\n  ttsOptions: TTSOptions | undefined,\n  directiveOverrides: TtsDirectiveOverrides | undefined,\n  appConfig: Config | undefined,\n  target: 'audio-file' | 'voice-note',\n): SpeechSynthesisRequest {\n  const directiveBucket = pickProviderOverrides(directiveOverrides, resolved.providerId);\n  const providerOverrides = mergeOverrides(ttsOptions, directiveBucket);\n  const callTimeoutMs = ttsOptions?.timeoutMs ?? resolved.timeoutMs;\n  return {\n    text: preparedText,\n    cfg: appConfig as Config,\n    providerConfig: resolved.providerConfig,\n    target,\n    timeoutMs: callTimeoutMs,\n    ...(providerOverrides ? { providerOverrides } : {}),\n  };\n}\n\n/** Convert SpeechSynthesisResult → TTSResult shape (audio/format/provider). */\nfunction toTtsResult(\n  resolved: ResolvedSpeechProvider,\n  result: SpeechSynthesisResult,\n  durationSeconds: number | undefined,\n): { audio: Buffer; format: string; provider: string; duration?: number } {\n  return {\n    audio: result.audioBuffer,\n    format: result.outputFormat,\n    provider: resolved.providerId,\n    ...(durationSeconds !== undefined ? { duration: durationSeconds } : {}),\n  };\n}\n\n// ---- Public API ---------------------------------------------------------\n\n/**\n * Run the TTS chain (primary → fallback) and return the first successful result.\n */\nexport async function speak(\n  text: string,\n  config: TTSConfig,\n  options?: SpeakOptions,\n): Promise<TTSResultWithTracking> {\n  if (!config.enabled) {\n    throw new Error('TTS is not enabled');\n  }\n  if (config.trigger === 'tagged' && !/\\[\\[tts/.test(text)) {\n    throw new Error('TTS trigger is tagged but no [[tts]] directive found');\n  }\n\n  const prepared = await prepareTextForSynthesis(text, config, options);\n  const chain = resolveSpeechProviderChain(config);\n\n  // Reorder so the directive-selected provider (if registered + configured) goes first.\n  const orderedChain = (() => {\n    const idx = chain.findIndex((c) => c.providerId === prepared.selectedProvider);\n    if (idx <= 0) return chain;\n    const reordered = [...chain];\n    const [picked] = reordered.splice(idx, 1);\n    if (picked) {\n      reordered.unshift(picked);\n    }\n    return reordered;\n  })();\n\n  const attempts: ProviderAttempt[] = [];\n  const attemptedProviders: string[] = [];\n  let lastError: Error | undefined;\n\n  for (const resolved of orderedChain) {\n    const startTime = Date.now();\n    attemptedProviders.push(resolved.providerId);\n\n    if (typeof resolved.plugin.synthesize !== 'function') {\n      attempts.push({\n        provider: resolved.providerId,\n        outcome: 'skipped',\n        reasonCode: 'not_configured',\n        latencyMs: Date.now() - startTime,\n        error: `Provider \"${resolved.providerId}\" does not implement synthesize()`,\n      });\n      continue;\n    }\n\n    try {\n      log.debug(\n        { textLength: prepared.text.length, provider: resolved.providerId },\n        'Converting text to speech',\n      );\n      const request = buildSynthesisRequest(\n        resolved,\n        prepared.text,\n        prepared.ttsOptions,\n        prepared.directiveOverrides,\n        options?.appConfig,\n        'audio-file',\n      );\n      const result = await resolved.plugin.synthesize(request);\n      const durationSeconds = (Date.now() - startTime) / 1000;\n      attempts.push({\n        provider: resolved.providerId,\n        outcome: 'success',\n        reasonCode: 'success',\n        latencyMs: Date.now() - startTime,\n      });\n\n      const primaryProvider = orderedChain[0]!.providerId;\n      const fallbackFrom = resolved.providerId !== primaryProvider ? primaryProvider : undefined;\n      if (fallbackFrom) {\n        log.info(\n          { primaryProvider: fallbackFrom, actualProvider: resolved.providerId, attempts },\n          'TTS used fallback provider',\n        );\n      } else {\n        log.info(\n          { provider: resolved.providerId, format: result.outputFormat, size: result.audioBuffer.length },\n          'TTS succeeded',\n        );\n      }\n\n      return {\n        ...toTtsResult(resolved, result, durationSeconds),\n        attempts,\n        ...(fallbackFrom ? { fallbackFrom } : {}),\n        attemptedProviders,\n        wasPreprocessed: prepared.wasPreprocessed,\n        ttsText: prepared.text,\n        wasSummarized: prepared.wasSummarized,\n      };\n    } catch (error) {\n      const latencyMs = Date.now() - startTime;\n      const reasonCode = classifyError(error);\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      attempts.push({\n        provider: resolved.providerId,\n        outcome: 'failed',\n        reasonCode,\n        latencyMs,\n        error: errorMsg,\n      });\n      lastError = error instanceof Error ? error : new Error(String(error));\n      log.warn(\n        { provider: resolved.providerId, errorMessage: errorMsg, reasonCode, latencyMs },\n        'TTS provider failed, trying next',\n      );\n    }\n  }\n\n  log.error({ attempts, attemptedProviders }, 'All TTS providers failed');\n  throw (\n    lastError ?? new Error(`All TTS providers failed: ${attempts.map((a) => a.error).join('; ')}`)\n  );\n}\n\n/** Single-provider variant; bypasses the fallback chain. */\nexport async function speakWithProvider(\n  text: string,\n  config: TTSConfig,\n  providerName: TTSProvider,\n  options?: SpeakOptions,\n): Promise<TTSResultWithTracking> {\n  if (!config.enabled) {\n    throw new Error('TTS is not enabled');\n  }\n  const resolved = resolveSpeechProvider(providerName, config);\n  if (!resolved) {\n    throw new Error(`Provider '${providerName}' is not available`);\n  }\n  if (typeof resolved.plugin.synthesize !== 'function') {\n    throw new Error(`Provider '${providerName}' does not implement synthesize()`);\n  }\n\n  const prepared = await prepareTextForSynthesis(text, config, options);\n  const startTime = Date.now();\n  const request = buildSynthesisRequest(\n    resolved,\n    prepared.text,\n    prepared.ttsOptions,\n    prepared.directiveOverrides,\n    options?.appConfig,\n    'audio-file',\n  );\n  const result = await resolved.plugin.synthesize(request);\n  const durationSeconds = (Date.now() - startTime) / 1000;\n\n  return {\n    ...toTtsResult(resolved, result, durationSeconds),\n    attempts: [\n      {\n        provider: providerName,\n        outcome: 'success',\n        reasonCode: 'success',\n        latencyMs: Date.now() - startTime,\n      },\n    ],\n    attemptedProviders: [providerName],\n    wasPreprocessed: prepared.wasPreprocessed,\n    ttsText: prepared.text,\n    wasSummarized: prepared.wasSummarized,\n  };\n}\n\n// ---- Streaming surface --------------------------------------------------\n\nexport interface SpeakStreamResult {\n  /** Audio chunks. Caller is responsible for consuming the stream. */\n  audioStream: ReadableStream<Uint8Array>;\n  outputFormat: string;\n  fileExtension: string;\n  voiceCompatible: boolean;\n  /** Provider id that produced this stream. */\n  provider: TTSProvider;\n  /** Cleanup hook (close sockets etc.). Always defined; no-op when nothing to release. */\n  release: () => Promise<void>;\n  /** Pre-flight metadata (after directive parse / preprocess / summarize). */\n  ttsText: string;\n  wasPreprocessed: boolean;\n  wasSummarized: boolean;\n}\n\n/**\n * Streaming TTS — tries the chain and returns the first provider's stream.\n * Providers without `synthesizeStream` are wrapped via wrapBufferAsStream.\n */\nexport async function speakStream(\n  text: string,\n  config: TTSConfig,\n  options?: SpeakOptions,\n): Promise<SpeakStreamResult> {\n  if (!config.enabled) {\n    throw new Error('TTS is not enabled');\n  }\n  if (config.trigger === 'tagged' && !/\\[\\[tts/.test(text)) {\n    throw new Error('TTS trigger is tagged but no [[tts]] directive found');\n  }\n\n  const prepared = await prepareTextForSynthesis(text, config, options);\n  const chain = resolveSpeechProviderChain(config);\n\n  let lastError: Error | undefined;\n  for (const resolved of chain) {\n    try {\n      const baseRequest: SpeechSynthesisStreamRequest = buildSynthesisRequest(\n        resolved,\n        prepared.text,\n        prepared.ttsOptions,\n        prepared.directiveOverrides,\n        options?.appConfig,\n        'voice-note',\n      );\n\n      let streamResult: SpeechSynthesisStreamResult;\n      if (typeof resolved.plugin.synthesizeStream === 'function') {\n        streamResult = await resolved.plugin.synthesizeStream(baseRequest);\n      } else if (typeof resolved.plugin.synthesize === 'function') {\n        // Fallback: buffer-then-wrap. Documented behavior: callers see a\n        // single-chunk stream with the same outputFormat.\n        const bufferResult = await resolved.plugin.synthesize(baseRequest);\n        streamResult = wrapBufferAsStream(bufferResult);\n      } else {\n        throw new Error(\n          `Provider \"${resolved.providerId}\" implements neither synthesize nor synthesizeStream`,\n        );\n      }\n\n      log.info(\n        {\n          provider: resolved.providerId,\n          outputFormat: streamResult.outputFormat,\n          voiceCompatible: streamResult.voiceCompatible,\n          streamed: typeof resolved.plugin.synthesizeStream === 'function',\n        },\n        'TTS stream ready',\n      );\n\n      const release = streamResult.release ?? (async () => {});\n      return {\n        audioStream: streamResult.audioStream,\n        outputFormat: streamResult.outputFormat,\n        fileExtension: streamResult.fileExtension,\n        voiceCompatible: streamResult.voiceCompatible,\n        provider: resolved.providerId,\n        release,\n        ttsText: prepared.text,\n        wasPreprocessed: prepared.wasPreprocessed,\n        wasSummarized: prepared.wasSummarized,\n      };\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n      log.warn(\n        { err: lastError, provider: resolved.providerId },\n        `TTS stream provider \"${resolved.providerId}\" failed, trying next`,\n      );\n    }\n  }\n  throw lastError ?? new Error('All TTS providers failed (streaming)');\n}\n\n/** Wrap a one-shot synthesis result into a single-chunk stream (no-op release). */\nfunction wrapBufferAsStream(result: SpeechSynthesisResult): SpeechSynthesisStreamResult {\n  const { audioBuffer } = result;\n  const audioStream = new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.enqueue(new Uint8Array(audioBuffer));\n      controller.close();\n    },\n  });\n  return {\n    audioStream,\n    outputFormat: result.outputFormat,\n    fileExtension: result.fileExtension,\n    voiceCompatible: result.voiceCompatible,\n  };\n}\n"],"mappings":"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"}

package/dist/src/voice/tts/speech-provider-types.d.ts

@@ -128,8 +128,8 @@ export interface SpeechProviderPlugin {
     /** Canonical provider id. Must be unique within the registry. */
     id: SpeechProviderId;
     /**
-     * Optional aliases (e.g. `["openai-tts"]` for back-compat with old config keys).
-     * Aliases participate in lookup but `id` is the canonical persisted name.
+     * Optional aliases for provider lookup. Aliases participate in lookup but
+     * `id` is the canonical persisted name.
      */
     aliases?: readonly string[];
     /**

package/dist/src/voice/tts/types.js

@@ -1,7 +1,7 @@
 //#region src/voice/tts/types.ts
 const DEFAULT_TTS_CONFIG = {
 	enabled: false,
-	provider: "openai",
+	provider: "edge",
 	trigger: "always",
 	fallback: {
 		enabled: true,

package/dist/src/voice/tts/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../../src/voice/tts/types.ts"],"sourcesContent":["/**\n * TTS (Text-to-Speech) Types\n */\n\n/** Built-in provider ids shipped in core. Extensions add more at runtime. */\nexport type BuiltinTTSProvider = 'openai' | 'alibaba' | 'edge' | 'minimax' | 'tts-local-cli';\n\n/** Any registered SpeechProviderPlugin id (built-in or extension). */\nexport type TTSProvider = string;\n\nexport type TTSAutoMode = 'off' | 'always' | 'inbound' | 'tagged';\n\nexport interface TTSOptions {\n  /** Voice ID */\n  voice?: string;\n  /** Speed (0.25 - 4.0) */\n  speed?: number;\n  /** Output format */\n  format?: 'opus' | 'mp3' | 'wav';\n  /** Model ID (for provider-specific model selection) */\n  model?: string;\n  /** Request timeout in milliseconds */\n  timeoutMs?: number;\n}\n\nexport interface TTSResult {\n  /** Audio buffer */\n  audio: Buffer;\n  /** Format */\n  format: string;\n  /** Duration in seconds (if available) */\n  duration?: number;\n  /** Provider that generated the speech */\n  provider: string;\n}\n\nexport interface TTSProviderInterface {\n  /** Provider name */\n  name: string;\n  /** Convert text to speech */\n  speak(text: string, options?: TTSOptions): Promise<TTSResult>;\n  /** Check if provider is configured */\n  isConfigured(): boolean;\n}\n\nexport interface TTSModelOverrideConfig {\n  /** Enable model-provided overrides for TTS */\n  enabled?: boolean;\n  /** Allow model-provided TTS text blocks */\n  allowText?: boolean;\n  /** Allow model-provided provider override (default: false) */\n  allowProvider?: boolean;\n  /** Allow model-provided voice/voiceId override */\n  allowVoice?: boolean;\n  /** Allow model-provided modelId override */\n  allowModelId?: boolean;\n  /** Allow model-provided voice settings override */\n  allowVoiceSettings?: boolean;\n  /** Allow model-provided normalization or language overrides */\n  allowNormalization?: boolean;\n  /** Allow model-provided seed override */\n  allowSeed?: boolean;\n}\n\nexport interface TTSConfig {\n  enabled: boolean;\n  provider: TTSProvider;\n  /** Trigger mode: auto = reply with voice when user sends voice */\n  trigger: TTSAutoMode;\n  /** Fallback configuration */\n  fallback?: {\n    enabled: boolean;\n    order: TTSProvider[];\n  };\n  /** Maximum text length for TTS */\n  maxTextLength?: number;\n  /** API request timeout (ms) */\n  timeoutMs?: number;\n  /** Long-text summarization before TTS */\n  summarization?: TTSSummarizationConfig;\n  /** Allow model to override TTS parameters */\n  modelOverrides?: TTSModelOverrideConfig;\n  /** Provider settings map (`messages.tts.providers.<id>`). */\n  providers?: Record<string, Record<string, unknown>>;\n}\n\nexport interface TTSSummarizationConfig {\n  /** When true (default), long text is summarized via LLM before TTS */\n  enabled?: boolean;\n  targetLength?: number;\n  threshold?: number;\n  model?: string;\n}\n\nexport const DEFAULT_TTS_CONFIG: TTSConfig = {\n  enabled: false,\n  provider: 'openai',\n  trigger: 'always',\n  fallback: {\n    enabled: true,\n    order: ['openai', 'alibaba', 'minimax', 'edge'],\n  },\n  maxTextLength: 512, // Conservative default to accommodate all providers (Alibaba limit is 512)\n  timeoutMs: 30000,\n  summarization: {\n    enabled: true,\n  },\n  modelOverrides: {\n    enabled: true,\n    allowText: true,\n    allowProvider: false,\n    allowVoice: true,\n    allowModelId: true,\n    allowVoiceSettings: false,\n    allowNormalization: false,\n    allowSeed: false,\n  },\n  providers: {\n    alibaba: { model: 'qwen-tts', voice: 'Cherry' },\n    openai: { model: 'tts-1', voice: 'alloy' },\n    edge: {\n      enabled: true,\n      voice: 'en-US-MichelleNeural',\n      lang: 'en-US',\n      outputFormat: 'audio-24khz-48kbitrate-mono-mp3',\n    },\n    minimax: { model: 'speech-2.8-hd', voice: 'male-qn-qingse' },\n  },\n};\n\n/** TTS directive parse result */\nexport interface TtsDirectiveParseResult {\n  cleanedText: string;\n  ttsText?: string;\n  hasDirective: boolean;\n  overrides: TtsDirectiveOverrides;\n  warnings: string[];\n}\n\n/** TTS directive overrides */\nexport interface TtsDirectiveOverrides {\n  ttsText?: string;\n  provider?: TTSProvider;\n  openai?: {\n    voice?: string;\n    model?: string;\n  };\n  alibaba?: {\n    voice?: string;\n    model?: string;\n  };\n  edge?: {\n    voice?: string;\n  };\n  minimax?: {\n    voice?: string;\n    model?: string;\n  };\n}\n\n/** Provider attempt result (TTS fallback chain) */\nexport type ProviderAttemptOutcome = 'success' | 'skipped' | 'failed';\n\n/** Provider failure reason classification */\nexport type ProviderFailureReason =\n  | 'success'\n  | 'not_configured'\n  | 'timeout'\n  | 'provider_error'\n  | 'text_too_long'\n  | 'unknown';\n\n/** Single provider attempt in a TTS fallback chain */\nexport interface ProviderAttempt {\n  provider: string;\n  outcome: ProviderAttemptOutcome;\n  reasonCode: ProviderFailureReason;\n  latencyMs: number;\n  error?: string;\n}\n\n/** TTS result including fallback / preprocessing metadata */\nexport interface TTSResultWithTracking extends TTSResult {\n  attempts: ProviderAttempt[];\n  fallbackFrom?: string;\n  attemptedProviders: string[];\n  wasPreprocessed?: boolean;\n  ttsText?: string;\n  wasSummarized?: boolean;\n}\n\n/** Last TTS call diagnostics (memory-only) */\nexport interface TtsStatusEntry {\n  timestamp: number;\n  success: boolean;\n  provider?: string;\n  latencyMs?: number;\n  error?: string;\n  textLength?: number;\n  audioSize?: number;\n  audioFormat?: string;\n  usedFallback?: boolean;\n  wasSummarized?: boolean;\n}\n\nexport interface TtsRuntimeStatus {\n  lastAttempt?: TtsStatusEntry;\n  recentSuccessRate?: number;\n  totalCalls: number;\n  totalSuccesses: number;\n  totalFailures: number;\n}\n"],"mappings":";AA8FA,MAAa,qBAAgC;CAC3C,SAAS;CACT,UAAU;CACV,SAAS;CACT,UAAU;EACR,SAAS;EACT,OAAO;GAAC;GAAU;GAAW;GAAW;GAAO;EAChD;CACD,eAAe;CACf,WAAW;CACX,eAAe,EACb,SAAS,MACV;CACD,gBAAgB;EACd,SAAS;EACT,WAAW;EACX,eAAe;EACf,YAAY;EACZ,cAAc;EACd,oBAAoB;EACpB,oBAAoB;EACpB,WAAW;EACZ;CACD,WAAW;EACT,SAAS;GAAE,OAAO;GAAY,OAAO;GAAU;EAC/C,QAAQ;GAAE,OAAO;GAAS,OAAO;GAAS;EAC1C,MAAM;GACJ,SAAS;GACT,OAAO;GACP,MAAM;GACN,cAAc;GACf;EACD,SAAS;GAAE,OAAO;GAAiB,OAAO;GAAkB;EAC7D;CACF"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/voice/tts/types.ts"],"sourcesContent":["/**\n * TTS (Text-to-Speech) Types\n */\n\n/** Built-in provider ids shipped in core. Extensions add more at runtime. */\nexport type BuiltinTTSProvider = 'openai' | 'alibaba' | 'edge' | 'minimax' | 'tts-local-cli';\n\n/** Any registered SpeechProviderPlugin id (built-in or extension). */\nexport type TTSProvider = string;\n\nexport type TTSAutoMode = 'off' | 'always' | 'inbound' | 'tagged';\n\nexport interface TTSOptions {\n  /** Voice ID */\n  voice?: string;\n  /** Speed (0.25 - 4.0) */\n  speed?: number;\n  /** Output format */\n  format?: 'opus' | 'mp3' | 'wav';\n  /** Model ID (for provider-specific model selection) */\n  model?: string;\n  /** Request timeout in milliseconds */\n  timeoutMs?: number;\n}\n\nexport interface TTSResult {\n  /** Audio buffer */\n  audio: Buffer;\n  /** Format */\n  format: string;\n  /** Duration in seconds (if available) */\n  duration?: number;\n  /** Provider that generated the speech */\n  provider: string;\n}\n\nexport interface TTSProviderInterface {\n  /** Provider name */\n  name: string;\n  /** Convert text to speech */\n  speak(text: string, options?: TTSOptions): Promise<TTSResult>;\n  /** Check if provider is configured */\n  isConfigured(): boolean;\n}\n\nexport interface TTSModelOverrideConfig {\n  /** Enable model-provided overrides for TTS */\n  enabled?: boolean;\n  /** Allow model-provided TTS text blocks */\n  allowText?: boolean;\n  /** Allow model-provided provider override (default: false) */\n  allowProvider?: boolean;\n  /** Allow model-provided voice/voiceId override */\n  allowVoice?: boolean;\n  /** Allow model-provided modelId override */\n  allowModelId?: boolean;\n  /** Allow model-provided voice settings override */\n  allowVoiceSettings?: boolean;\n  /** Allow model-provided normalization or language overrides */\n  allowNormalization?: boolean;\n  /** Allow model-provided seed override */\n  allowSeed?: boolean;\n}\n\nexport interface TTSConfig {\n  enabled: boolean;\n  provider: TTSProvider;\n  /** Trigger mode: auto = reply with voice when user sends voice */\n  trigger: TTSAutoMode;\n  /** Fallback configuration */\n  fallback?: {\n    enabled: boolean;\n    order: TTSProvider[];\n  };\n  /** Maximum text length for TTS */\n  maxTextLength?: number;\n  /** API request timeout (ms) */\n  timeoutMs?: number;\n  /** Long-text summarization before TTS */\n  summarization?: TTSSummarizationConfig;\n  /** Allow model to override TTS parameters */\n  modelOverrides?: TTSModelOverrideConfig;\n  /** Provider settings map (`messages.tts.providers.<id>`). */\n  providers?: Record<string, Record<string, unknown>>;\n}\n\nexport interface TTSSummarizationConfig {\n  /** When true (default), long text is summarized via LLM before TTS */\n  enabled?: boolean;\n  targetLength?: number;\n  threshold?: number;\n  model?: string;\n}\n\nexport const DEFAULT_TTS_CONFIG: TTSConfig = {\n  enabled: false,\n  provider: 'edge',\n  trigger: 'always',\n  fallback: {\n    enabled: true,\n    order: ['openai', 'alibaba', 'minimax', 'edge'],\n  },\n  maxTextLength: 512, // Conservative default to accommodate all providers (Alibaba limit is 512)\n  timeoutMs: 30000,\n  summarization: {\n    enabled: true,\n  },\n  modelOverrides: {\n    enabled: true,\n    allowText: true,\n    allowProvider: false,\n    allowVoice: true,\n    allowModelId: true,\n    allowVoiceSettings: false,\n    allowNormalization: false,\n    allowSeed: false,\n  },\n  providers: {\n    alibaba: { model: 'qwen-tts', voice: 'Cherry' },\n    openai: { model: 'tts-1', voice: 'alloy' },\n    edge: {\n      enabled: true,\n      voice: 'en-US-MichelleNeural',\n      lang: 'en-US',\n      outputFormat: 'audio-24khz-48kbitrate-mono-mp3',\n    },\n    minimax: { model: 'speech-2.8-hd', voice: 'male-qn-qingse' },\n  },\n};\n\n/** TTS directive parse result */\nexport interface TtsDirectiveParseResult {\n  cleanedText: string;\n  ttsText?: string;\n  hasDirective: boolean;\n  overrides: TtsDirectiveOverrides;\n  warnings: string[];\n}\n\n/** TTS directive overrides */\nexport interface TtsDirectiveOverrides {\n  ttsText?: string;\n  provider?: TTSProvider;\n  openai?: {\n    voice?: string;\n    model?: string;\n  };\n  alibaba?: {\n    voice?: string;\n    model?: string;\n  };\n  edge?: {\n    voice?: string;\n  };\n  minimax?: {\n    voice?: string;\n    model?: string;\n  };\n}\n\n/** Provider attempt result (TTS fallback chain) */\nexport type ProviderAttemptOutcome = 'success' | 'skipped' | 'failed';\n\n/** Provider failure reason classification */\nexport type ProviderFailureReason =\n  | 'success'\n  | 'not_configured'\n  | 'timeout'\n  | 'provider_error'\n  | 'text_too_long'\n  | 'unknown';\n\n/** Single provider attempt in a TTS fallback chain */\nexport interface ProviderAttempt {\n  provider: string;\n  outcome: ProviderAttemptOutcome;\n  reasonCode: ProviderFailureReason;\n  latencyMs: number;\n  error?: string;\n}\n\n/** TTS result including fallback / preprocessing metadata */\nexport interface TTSResultWithTracking extends TTSResult {\n  attempts: ProviderAttempt[];\n  fallbackFrom?: string;\n  attemptedProviders: string[];\n  wasPreprocessed?: boolean;\n  ttsText?: string;\n  wasSummarized?: boolean;\n}\n\n/** Last TTS call diagnostics (memory-only) */\nexport interface TtsStatusEntry {\n  timestamp: number;\n  success: boolean;\n  provider?: string;\n  latencyMs?: number;\n  error?: string;\n  textLength?: number;\n  audioSize?: number;\n  audioFormat?: string;\n  usedFallback?: boolean;\n  wasSummarized?: boolean;\n}\n\nexport interface TtsRuntimeStatus {\n  lastAttempt?: TtsStatusEntry;\n  recentSuccessRate?: number;\n  totalCalls: number;\n  totalSuccesses: number;\n  totalFailures: number;\n}\n"],"mappings":";AA8FA,MAAa,qBAAgC;CAC3C,SAAS;CACT,UAAU;CACV,SAAS;CACT,UAAU;EACR,SAAS;EACT,OAAO;GAAC;GAAU;GAAW;GAAW;GAAO;EAChD;CACD,eAAe;CACf,WAAW;CACX,eAAe,EACb,SAAS,MACV;CACD,gBAAgB;EACd,SAAS;EACT,WAAW;EACX,eAAe;EACf,YAAY;EACZ,cAAc;EACd,oBAAoB;EACpB,oBAAoB;EACpB,WAAW;EACZ;CACD,WAAW;EACT,SAAS;GAAE,OAAO;GAAY,OAAO;GAAU;EAC/C,QAAQ;GAAE,OAAO;GAAS,OAAO;GAAS;EAC1C,MAAM;GACJ,SAAS;GACT,OAAO;GACP,MAAM;GACN,cAAc;GACf;EACD,SAAS;GAAE,OAAO;GAAiB,OAAO;GAAkB;EAC7D;CACF"}

package/dist/src/workflows/domain/result.d.ts

@@ -6,7 +6,6 @@ export interface WorkflowResultEnvelope {
     artifacts?: WorkflowArtifactRef[];
     followUps?: WorkflowFollowUp[];
     structuredOutput?: unknown;
-    raw?: unknown;
 }
 /** Product-level outcome contract for reusable workflow deliverables. */
 export interface WorkflowOutcome {

package/dist/src/workflows/engine/workflow-engine.js

@@ -156,8 +156,9 @@ var WorkflowEngine = class {
 			}), options.timeoutSec ?? definition.defaults.timeoutSec);
 			await eventQueue;
 			if (currentPhaseId) await appendEvent("phase_completed", { phaseId: currentPhaseId });
-			assertWorkflowOutput(definition, runtimeResult.result);
-			await appendEvent("run_completed", { result: toWorkflowResultEnvelope(runtimeResult.result) });
+			const result = requireWorkflowResultEnvelope(runtimeResult.result);
+			assertWorkflowOutput(definition, result);
+			await appendEvent("run_completed", { result });
 			await this.callHooks((hook) => hook.afterRun?.({
 				runId,
 				status: "succeeded"
@@ -659,27 +660,6 @@ function truncate(value, maxLength) {
 	if (trimmed.length <= maxLength) return trimmed;
 	return `${trimmed.slice(0, maxLength - 1)}…`;
 }
-function toWorkflowResultEnvelope(value) {
-	if (isWorkflowResultEnvelope(value)) return value;
-	if (typeof value === "string") return {
-		summary: truncate(value, 800),
-		sections: [{
-			kind: "text",
-			title: "Result",
-			content: value
-		}],
-		raw: value
-	};
-	return {
-		summary: "Workflow completed.",
-		sections: [{
-			kind: "json",
-			title: "Result",
-			value
-		}],
-		raw: value
-	};
-}
 function assertWorkflowOutput(definition, value) {
 	const validation = validateWorkflowJsonSchema(definition.outputSchema, value);
 	if (validation.ok) return;
@@ -690,6 +670,10 @@ function isWorkflowResultEnvelope(value) {
 	const record = value;
 	return typeof record.summary === "string" && Array.isArray(record.sections);
 }
+function requireWorkflowResultEnvelope(value) {
+	if (isWorkflowResultEnvelope(value)) return value;
+	throw new WorkflowEngineRunError("result_validation_failed", "Workflow scripts must return a WorkflowResultEnvelope with summary and sections.", false);
+}
 function toWorkflowRunError(err, wasAborted, abortReason) {
 	if (err instanceof WorkflowEngineRunError) return {
 		code: err.code,

package/dist/src/workflows/engine/workflow-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-engine.js","names":[],"sources":["../../../../src/workflows/engine/workflow-engine.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { WorkflowDefinition } from '../domain/definition.js';\nimport type { WorkflowEventEnvelope, WorkflowEventPayload, WorkflowEventType } from '../domain/event.js';\nimport type { WorkflowAgentStatus, WorkflowRun, WorkflowRunError, WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';\nimport type { WorkflowResultEnvelope } from '../domain/result.js';\nimport { validateWorkflowJsonSchema } from '../domain/schema-validation.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport { createScriptWorkflowRuntime } from '../runtime/script-workflow-runtime.js';\nimport type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport { workflowStepLabel } from '../../agent/workflow/step-labels.js';\nimport type { SubagentProgressEvent } from '../../agent/workflow/types.js';\nimport type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';\nimport type { WorkflowAgentInvocationSnapshot } from '../domain/index.js';\n\nexport interface WorkflowEngineOptions {\n  cwd: string;\n  eventStore: WorkflowEventStore;\n  runStore: WorkflowRunStore;\n  runner: WorkflowScriptSubagentRunner;\n  runtime?: WorkflowRuntime;\n  hooks?: WorkflowEngineHook[];\n  subagentSessionKeyFactory?: (ctx: { runId: string; agentId: string }) => string;\n  parentSessionKey?: string;\n  onEventAppended?: (event: WorkflowEventEnvelope) => void;\n  onRunViewUpdated?: (view: WorkflowRunView) => void;\n  resolveModelId?: (modelId: string) => Model<Api>;\n}\n\nexport interface WorkflowEngineHook {\n  beforeRun?(ctx: WorkflowRunHookContext): Promise<void> | void;\n  beforeAgent?(ctx: WorkflowAgentHookContext): Promise<void> | void;\n  afterAgent?(ctx: WorkflowAgentCompletedHookContext): Promise<void> | void;\n  afterRun?(ctx: WorkflowRunCompletedHookContext): Promise<void> | void;\n}\n\nexport interface WorkflowRunHookContext {\n  definition: WorkflowDefinition;\n  run: WorkflowRun;\n}\n\nexport interface WorkflowAgentHookContext {\n  runId: string;\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  prompt: string;\n}\n\nexport interface WorkflowAgentCompletedHookContext {\n  runId: string;\n  agentId: string;\n  status: 'done' | 'error' | 'skipped';\n  resultPreview?: string;\n}\n\nexport interface WorkflowRunCompletedHookContext {\n  runId: string;\n  status: 'succeeded' | 'failed' | 'cancelled';\n}\n\nexport interface StartWorkflowRunOptions {\n  input?: unknown;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  goal?: string;\n  runId?: string;\n  signal?: AbortSignal;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n  timeoutSec?: number;\n}\n\nexport interface WorkflowReplayAgentTarget {\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  phaseTitle?: string;\n  prompt: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n}\n\nexport interface StartWorkflowReplayRunOptions extends StartWorkflowRunOptions {\n  sourceRunId: string;\n  replayScope: 'failed_agents' | 'failed_phases';\n  targets: WorkflowReplayAgentTarget[];\n}\n\nexport class WorkflowEngine {\n  constructor(private readonly options: WorkflowEngineOptions) {}\n\n  async startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView> {\n    const runId = options.runId ?? randomUUID();\n    const createdAtMs = Date.now();\n    const phaseTitleToId = buildPhaseTitleToId(definition);\n    let currentPhaseId: string | undefined;\n    let eventQueue = Promise.resolve();\n    const progressRecorders = new Map<number, AgentProgressRecorder>();\n    const runtimeAgentStatuses = new Map<number, WorkflowAgentStatus | 'queued'>();\n    const subagentSessionKeys = new Map<number, string>();\n\n    const run: WorkflowRun = {\n      id: runId,\n      definitionId: definition.id,\n      definitionVersion: definition.version,\n      title: definition.title,\n      goal: options.goal ?? definition.description,\n      input: options.input ?? {},\n      status: 'queued',\n      source: options.source,\n      metadata: options.metadata,\n      metrics: {\n        agentCount: 0,\n        doneAgentCount: 0,\n        errorAgentCount: 0,\n        skippedAgentCount: 0,\n        artifactCount: 0,\n      },\n      createdAtMs,\n    };\n\n    const appendEvent = (type: WorkflowEventType, payload: WorkflowEventPayload, createdAtMsOverride?: number) => {\n      eventQueue = eventQueue\n        .then(() =>\n          this.options.eventStore.append({\n            runId,\n            type,\n            payload,\n            createdAtMs: createdAtMsOverride,\n          }),\n        )\n        .then(async (event) => {\n          this.options.onEventAppended?.(event);\n          const view = await this.options.runStore.rebuildRunView(runId);\n          if (view) {\n            this.options.onRunViewUpdated?.(view);\n          }\n        });\n      return eventQueue;\n    };\n\n    await appendEvent('run_queued', { run }, createdAtMs);\n    await this.callHooks((hook) => hook.beforeRun?.({ definition, run }));\n    await appendEvent('run_started', { startedAtMs: Date.now() });\n\n    try {\n      const runtime = this.options.runtime ?? createScriptWorkflowRuntime();\n      const runtimeResult = await withWorkflowTimeout(\n        runtime.run<unknown>(\n          definition.runtime.source,\n          {\n            runner: this.options.runner,\n            resolveModelId: this.options.resolveModelId,\n          },\n          {\n            cwd: this.options.cwd,\n            args: options.input,\n            signal: options.signal,\n            concurrency: options.concurrency ?? definition.defaults.concurrency,\n            maxSubagents: options.maxSubagents ?? definition.defaults.maxSubagents,\n            tokenBudget: options.tokenBudget,\n            onPhase: (title) => {\n              const nextPhaseId = phaseTitleToId.get(title) ?? normalizePhaseId(title);\n              if (currentPhaseId && currentPhaseId !== nextPhaseId) {\n                void appendEvent('phase_completed', { phaseId: currentPhaseId });\n              }\n              currentPhaseId = nextPhaseId;\n              void appendEvent('phase_started', { phaseId: nextPhaseId, title });\n            },\n            onLog: (message) => {\n              void appendEvent('log_appended', { message });\n            },\n            onAgentQueued: (event) => {\n              const agentId = formatRuntimeAgentId(event.id);\n              const subagentSessionKey = this.options.subagentSessionKeyFactory?.({ runId, agentId }) ?? defaultSubagentSessionKey(runId, agentId);\n              subagentSessionKeys.set(event.id, subagentSessionKey);\n              runtimeAgentStatuses.set(event.id, 'queued');\n              const phaseId = event.phase ? (phaseTitleToId.get(event.phase) ?? normalizePhaseId(event.phase)) : currentPhaseId;\n              void this.callHooks((hook) => hook.beforeAgent?.({\n                runId,\n                agentId,\n                label: event.label,\n                phaseId,\n                prompt: event.prompt,\n              }));\n              void appendEvent('agent_queued', {\n                agentId,\n                label: event.label,\n                phaseId,\n                prompt: event.prompt,\n                sessionKey: subagentSessionKey,\n                invocation: event.invocation,\n              });\n            },\n            onAgentStart: (event) => {\n              const currentStatus = runtimeAgentStatuses.get(event.id);\n              if (currentStatus && currentStatus !== 'queued' && currentStatus !== 'running') {\n                return;\n              }\n              runtimeAgentStatuses.set(event.id, 'running');\n              void appendEvent('agent_started', { agentId: formatRuntimeAgentId(event.id) });\n            },\n            onAgentEnd: (event) => {\n              const currentStatus = runtimeAgentStatuses.get(event.id);\n              if (currentStatus && currentStatus !== 'queued' && currentStatus !== 'running') {\n                return;\n              }\n              const agentId = formatRuntimeAgentId(event.id);\n              const completedStatus = normalizeCompletedAgentStatus(event.status);\n              runtimeAgentStatuses.set(event.id, completedStatus);\n              const resultPreview = previewWorkflowValue(event.result);\n              progressRecorders.get(event.id)?.completeOpenSteps(completedStatus === 'done' ? 'done' : 'error');\n              progressRecorders.delete(event.id);\n              void appendEvent('agent_completed', {\n                agentId,\n                status: completedStatus,\n                resultPreview,\n                error: completedStatus === 'error' ? 'Subagent failed' : undefined,\n              }).then(() => this.callHooks((hook) => hook.afterAgent?.({\n                runId,\n                agentId,\n                status: completedStatus,\n                resultPreview,\n              })).catch(() => undefined));\n            },\n            enhanceSubagentRun: (ctx) => {\n              const recorder = new AgentProgressRecorder({\n                agentId: formatRuntimeAgentId(ctx.id),\n                appendEvent,\n              });\n              progressRecorders.set(ctx.id, recorder);\n              const agentId = formatRuntimeAgentId(ctx.id);\n              const sessionKey = subagentSessionKeys.get(ctx.id)\n                ?? this.options.subagentSessionKeyFactory?.({ runId, agentId })\n                ?? defaultSubagentSessionKey(runId, agentId);\n              subagentSessionKeys.set(ctx.id, sessionKey);\n              return {\n                sessionKey,\n                sessionMetadata: {\n                  parentSessionKey: this.options.parentSessionKey,\n                  workflowRunId: runId,\n                  workflowDefinitionId: definition.id,\n                  workflowAgentId: agentId,\n                  workflowAgentLabel: ctx.label,\n                },\n                onProgress: (event) => recorder.onProgress(event),\n              };\n            },\n          },\n        ),\n        options.timeoutSec ?? definition.defaults.timeoutSec,\n      );\n\n      await eventQueue;\n      if (currentPhaseId) {\n        await appendEvent('phase_completed', { phaseId: currentPhaseId });\n      }\n      assertWorkflowOutput(definition, runtimeResult.result);\n      await appendEvent('run_completed', { result: toWorkflowResultEnvelope(runtimeResult.result) });\n      await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'succeeded' }));\n    } catch (err) {\n      await eventQueue;\n      const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);\n      const terminalAgentStatus: WorkflowAgentStatus = error.code === 'cancelled' || error.code === 'timeout' ? 'skipped' : 'error';\n      await this.completeOutstandingRuntimeAgents({\n        runId,\n        statuses: runtimeAgentStatuses,\n        progressRecorders,\n        appendEvent,\n        status: terminalAgentStatus,\n        error: terminalAgentStatus === 'error' ? error.message : undefined,\n      });\n      if (error.code === 'cancelled') {\n        await appendEvent('run_cancelled', { reason: error.message });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'cancelled' }));\n      } else {\n        await appendEvent('run_failed', { error });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      }\n    }\n\n    const view = await this.options.runStore.readRunView(runId);\n    if (!view) {\n      throw new Error(`workflow run view was not created for ${runId}`);\n    }\n    return view;\n  }\n\n  async startReplayRun(definition: WorkflowDefinition, options: StartWorkflowReplayRunOptions): Promise<WorkflowRunView> {\n    const runId = options.runId ?? randomUUID();\n    const createdAtMs = Date.now();\n    let eventQueue = Promise.resolve();\n    const progressRecorders = new Map<string, AgentProgressRecorder>();\n\n    const run: WorkflowRun = {\n      id: runId,\n      definitionId: definition.id,\n      definitionVersion: definition.version,\n      title: `${definition.title} replay`,\n      goal: options.goal ?? definition.description,\n      input: options.input ?? {},\n      status: 'queued',\n      source: options.source,\n      metadata: options.metadata,\n      metrics: {\n        agentCount: 0,\n        doneAgentCount: 0,\n        errorAgentCount: 0,\n        skippedAgentCount: 0,\n        artifactCount: 0,\n      },\n      createdAtMs,\n    };\n\n    const appendEvent = (type: WorkflowEventType, payload: WorkflowEventPayload, createdAtMsOverride?: number) => {\n      eventQueue = eventQueue\n        .then(() =>\n          this.options.eventStore.append({\n            runId,\n            type,\n            payload,\n            createdAtMs: createdAtMsOverride,\n          }),\n        )\n        .then(async (event) => {\n          this.options.onEventAppended?.(event);\n          const view = await this.options.runStore.rebuildRunView(runId);\n          if (view) {\n            this.options.onRunViewUpdated?.(view);\n          }\n        });\n      return eventQueue;\n    };\n\n    await appendEvent('run_queued', { run }, createdAtMs);\n    await this.callHooks((hook) => hook.beforeRun?.({ definition, run }));\n    await appendEvent('run_started', { startedAtMs: Date.now() });\n\n    try {\n      const result = await withWorkflowTimeout(\n        this.runReplayTargets({\n          definition,\n          runId,\n          targets: options.targets,\n          signal: options.signal,\n          appendEvent,\n          progressRecorders,\n        }),\n        options.timeoutSec ?? definition.defaults.timeoutSec,\n      );\n\n      await eventQueue;\n      if (result.errors.length > 0) {\n        await appendEvent('run_failed', {\n          error: {\n            code: 'runtime_error',\n            message: `Replay completed with ${result.errors.length} failed target${result.errors.length === 1 ? '' : 's'}.`,\n            detail: result.errors.join('\\n'),\n            recoverable: true,\n          },\n        });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      } else {\n        await appendEvent('run_completed', { result: buildReplayResultEnvelope(options, result.results) });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'succeeded' }));\n      }\n    } catch (err) {\n      await eventQueue;\n      const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);\n      if (error.code === 'cancelled') {\n        await appendEvent('run_cancelled', { reason: error.message });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'cancelled' }));\n      } else {\n        await appendEvent('run_failed', { error });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      }\n    }\n\n    const view = await this.options.runStore.readRunView(runId);\n    if (!view) {\n      throw new Error(`workflow replay run view was not created for ${runId}`);\n    }\n    return view;\n  }\n\n  private async runReplayTargets(params: {\n    definition: WorkflowDefinition;\n    runId: string;\n    targets: WorkflowReplayAgentTarget[];\n    signal?: AbortSignal;\n    appendEvent: AppendWorkflowEvent;\n    progressRecorders: Map<string, AgentProgressRecorder>;\n  }): Promise<{ results: WorkflowReplayTargetResult[]; errors: string[] }> {\n    const results: WorkflowReplayTargetResult[] = [];\n    const errors: string[] = [];\n    const targetsByPhase = groupReplayTargetsByPhase(params.targets);\n\n    for (const group of targetsByPhase) {\n      throwIfSignalAborted(params.signal);\n      if (group.phaseId && group.phaseTitle) {\n        await params.appendEvent('phase_started', { phaseId: group.phaseId, title: group.phaseTitle });\n      }\n\n      const phaseResults = await Promise.all(\n        group.targets.map((target) => this.runReplayTarget({ ...params, target })),\n      );\n      results.push(...phaseResults);\n      errors.push(...phaseResults.filter((item) => item.status === 'error').map((item) => `${item.label}: ${item.error ?? 'failed'}`));\n\n      if (group.phaseId && phaseResults.every((item) => item.status === 'done')) {\n        await params.appendEvent('phase_completed', { phaseId: group.phaseId });\n      }\n    }\n\n    return { results, errors };\n  }\n\n  private async runReplayTarget(params: {\n    definition: WorkflowDefinition;\n    runId: string;\n    target: WorkflowReplayAgentTarget;\n    signal?: AbortSignal;\n    appendEvent: AppendWorkflowEvent;\n    progressRecorders: Map<string, AgentProgressRecorder>;\n  }): Promise<WorkflowReplayTargetResult> {\n    const { target } = params;\n    const invocation = normalizeReplayInvocation(target);\n    const sessionKey = this.options.subagentSessionKeyFactory?.({ runId: params.runId, agentId: target.agentId })\n      ?? defaultSubagentSessionKey(params.runId, target.agentId);\n    await this.callHooks((hook) => hook.beforeAgent?.({\n      runId: params.runId,\n      agentId: target.agentId,\n      label: invocation.label,\n      phaseId: target.phaseId,\n      prompt: invocation.prompt,\n    }));\n    await params.appendEvent('agent_queued', {\n      agentId: target.agentId,\n      label: invocation.label,\n      phaseId: target.phaseId,\n      prompt: invocation.prompt,\n      sessionKey,\n      invocation,\n    });\n    await params.appendEvent('agent_started', { agentId: target.agentId });\n\n    const recorder = new AgentProgressRecorder({\n      agentId: target.agentId,\n      appendEvent: params.appendEvent,\n    });\n    params.progressRecorders.set(target.agentId, recorder);\n\n    try {\n      throwIfSignalAborted(params.signal);\n      const model = resolveReplayModel(invocation, this.options.resolveModelId);\n      const result = await this.options.runner.run<unknown>(invocation.prompt, {\n        label: invocation.label,\n        schema: invocation.schema as never,\n        allowedToolNames: invocation.toolset,\n        maxIterations: invocation.maxIterations,\n        phase: invocation.phase ?? target.phaseTitle,\n        signal: params.signal,\n        model,\n        sessionKey,\n        sessionMetadata: {\n          parentSessionKey: this.options.parentSessionKey,\n          workflowRunId: params.runId,\n          workflowDefinitionId: params.definition.id,\n          workflowAgentId: target.agentId,\n          workflowAgentLabel: invocation.label,\n        },\n        onProgress: (event) => recorder.onProgress(event),\n      });\n      throwIfSignalAborted(params.signal);\n      const status = result === null ? 'error' : 'done';\n      const resultPreview = previewWorkflowValue(result);\n      recorder.completeOpenSteps(status === 'done' ? 'done' : 'error');\n      await params.appendEvent('agent_completed', {\n        agentId: target.agentId,\n        status,\n        resultPreview,\n        error: status === 'error' ? 'Replay target failed' : undefined,\n      });\n      await this.callHooks((hook) => hook.afterAgent?.({\n        runId: params.runId,\n        agentId: target.agentId,\n        status,\n        resultPreview,\n      }));\n      return { agentId: target.agentId, label: invocation.label, phaseId: target.phaseId, status, resultPreview };\n    } catch (err) {\n      if (params.signal?.aborted) throw err;\n      const message = err instanceof Error ? err.message : String(err);\n      recorder.completeOpenSteps('error');\n      await params.appendEvent('agent_completed', {\n        agentId: target.agentId,\n        status: 'error',\n        error: message,\n      });\n      await this.callHooks((hook) => hook.afterAgent?.({\n        runId: params.runId,\n        agentId: target.agentId,\n        status: 'error',\n      }));\n      return { agentId: target.agentId, label: invocation.label, phaseId: target.phaseId, status: 'error', error: message };\n    } finally {\n      params.progressRecorders.delete(target.agentId);\n    }\n  }\n\n  private async completeOutstandingRuntimeAgents(params: {\n    runId: string;\n    statuses: Map<number, WorkflowAgentStatus | 'queued'>;\n    progressRecorders: Map<number, AgentProgressRecorder>;\n    appendEvent: AppendWorkflowEvent;\n    status: Extract<WorkflowAgentStatus, 'done' | 'error' | 'skipped'>;\n    error?: string;\n  }): Promise<void> {\n    for (const [id, currentStatus] of params.statuses) {\n      if (currentStatus !== 'queued' && currentStatus !== 'running') {\n        continue;\n      }\n      params.statuses.set(id, params.status);\n      const recorder = params.progressRecorders.get(id);\n      recorder?.completeOpenSteps(params.status === 'done' ? 'done' : 'error');\n      params.progressRecorders.delete(id);\n      const agentId = formatRuntimeAgentId(id);\n      await params.appendEvent('agent_completed', {\n        agentId,\n        status: params.status,\n        error: params.error,\n      });\n      await this.callHooks((hook) => hook.afterAgent?.({\n        runId: params.runId,\n        agentId,\n        status: params.status,\n      }));\n    }\n  }\n\n  private async callHooks(call: (hook: WorkflowEngineHook) => Promise<void> | void | undefined): Promise<void> {\n    for (const hook of this.options.hooks ?? []) {\n      try {\n        await call(hook);\n      } catch {\n        // Hooks are extension points; workflow execution remains authoritative.\n      }\n    }\n  }\n}\n\ninterface WorkflowReplayTargetResult {\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  status: 'done' | 'error';\n  resultPreview?: string;\n  error?: string;\n}\n\nclass WorkflowEngineRunError extends Error {\n  constructor(\n    readonly code: WorkflowRunError['code'],\n    message: string,\n    readonly recoverable: boolean,\n    readonly detail?: string,\n  ) {\n    super(message);\n    this.name = 'WorkflowEngineRunError';\n  }\n}\n\ntype AppendWorkflowEvent = (\n  type: WorkflowEventType,\n  payload: WorkflowEventPayload,\n  createdAtMsOverride?: number,\n) => Promise<void>;\n\nclass AgentProgressRecorder {\n  private readonly activeToolStepIds = new Map<string, string>();\n  private activeIterationStepId: string | null = null;\n  private activeThinkingStepId: string | null = null;\n  private activeLlmStepId: string | null = null;\n  private sequence = 0;\n\n  constructor(\n    private readonly options: {\n      agentId: string;\n      appendEvent: AppendWorkflowEvent;\n    },\n  ) {}\n\n  onProgress(event: SubagentProgressEvent): void {\n    switch (event.type) {\n      case 'tool_start':\n        this.startToolStep(event);\n        return;\n      case 'tool_end':\n        this.completeToolStep(event);\n        return;\n      case 'iteration':\n        this.replaceSingletonStep('iteration', this.buildIterationLabel(event.count, event.max), 'llm');\n        return;\n      case 'thinking_delta':\n        this.ensureSingletonStep('thinking', 'Thinking', 'thinking');\n        return;\n      case 'text_delta':\n        this.ensureSingletonStep('llm', 'Writing response', 'llm');\n        return;\n      default:\n        return;\n    }\n  }\n\n  completeOpenSteps(status: 'done' | 'error'): void {\n    for (const stepId of this.activeToolStepIds.values()) {\n      void this.options.appendEvent('agent_step_completed', {\n        agentId: this.options.agentId,\n        stepId,\n        status,\n      });\n    }\n    this.activeToolStepIds.clear();\n    this.completeSingletonStep('iteration', status);\n    this.completeSingletonStep('thinking', status);\n    this.completeSingletonStep('llm', status);\n  }\n\n  private startToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_start' }>): void {\n    const stepId = this.nextStepId('tool');\n    const { label, detail } = workflowStepLabel(event.toolName, event.args);\n    this.activeToolStepIds.set(event.toolCallId, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind: 'tool',\n      toolName: event.toolName,\n      detail: detail ?? previewWorkflowValue(event.args),\n    });\n  }\n\n  private completeToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_end' }>): void {\n    const stepId = this.activeToolStepIds.get(event.toolCallId);\n    if (!stepId) return;\n    this.activeToolStepIds.delete(event.toolCallId);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status: event.isError ? 'error' : 'done',\n      resultPreview: event.resultPreview,\n      error: event.error,\n    });\n  }\n\n  private replaceSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    this.completeSingletonStep(slot, 'done');\n    this.ensureSingletonStep(slot, label, kind);\n  }\n\n  private ensureSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    if (this.getSingletonStepId(slot)) return;\n    const stepId = this.nextStepId(slot);\n    this.setSingletonStepId(slot, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind,\n    });\n  }\n\n  private completeSingletonStep(slot: 'iteration' | 'thinking' | 'llm', status: 'done' | 'error'): void {\n    const stepId = this.getSingletonStepId(slot);\n    if (!stepId) return;\n    this.setSingletonStepId(slot, null);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status,\n    });\n  }\n\n  private getSingletonStepId(slot: 'iteration' | 'thinking' | 'llm'): string | null {\n    if (slot === 'iteration') return this.activeIterationStepId;\n    if (slot === 'thinking') return this.activeThinkingStepId;\n    return this.activeLlmStepId;\n  }\n\n  private setSingletonStepId(slot: 'iteration' | 'thinking' | 'llm', stepId: string | null): void {\n    if (slot === 'iteration') {\n      this.activeIterationStepId = stepId;\n      return;\n    }\n    if (slot === 'thinking') {\n      this.activeThinkingStepId = stepId;\n      return;\n    }\n    this.activeLlmStepId = stepId;\n  }\n\n  private buildIterationLabel(count: number, max: number): string {\n    if (max > 0) return `Iteration ${count}/${max}`;\n    return `Iteration ${count}`;\n  }\n\n  private nextStepId(kind: string): string {\n    this.sequence += 1;\n    return `${this.options.agentId}-${kind}-${this.sequence}`;\n  }\n}\n\nfunction buildPhaseTitleToId(definition: WorkflowDefinition): Map<string, string> {\n  const phaseTitleToId = new Map<string, string>();\n  for (const phase of definition.phases) {\n    phaseTitleToId.set(phase.title, phase.id);\n  }\n  return phaseTitleToId;\n}\n\nfunction normalizePhaseId(title: string): string {\n  const normalized = title\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n  return normalized || 'phase';\n}\n\nfunction withWorkflowTimeout<T>(promise: Promise<T>, timeoutSec: number | undefined): Promise<T> {\n  if (typeof timeoutSec !== 'number' || !Number.isFinite(timeoutSec) || timeoutSec <= 0) {\n    return promise;\n  }\n\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  const timeoutPromise = new Promise<never>((_resolve, reject) => {\n    timeout = setTimeout(() => {\n      reject(new Error(`workflow timed out after ${timeoutSec}s`));\n    }, timeoutSec * 1000);\n  });\n\n  return Promise.race([promise, timeoutPromise]).finally(() => {\n    if (timeout) clearTimeout(timeout);\n  });\n}\n\nfunction throwIfSignalAborted(signal: AbortSignal | undefined): void {\n  if (!signal?.aborted) return;\n  const reason = signal.reason;\n  if (reason instanceof Error) throw reason;\n  if (reason) throw new Error(String(reason));\n  throw new Error('workflow aborted');\n}\n\nfunction groupReplayTargetsByPhase(targets: WorkflowReplayAgentTarget[]): Array<{\n  phaseId?: string;\n  phaseTitle?: string;\n  targets: WorkflowReplayAgentTarget[];\n}> {\n  const groups: Array<{\n    key: string;\n    phaseId?: string;\n    phaseTitle?: string;\n    targets: WorkflowReplayAgentTarget[];\n  }> = [];\n\n  for (const target of targets) {\n    const key = target.phaseId ?? '';\n    let group = groups.find((item) => item.key === key);\n    if (!group) {\n      group = {\n        key,\n        phaseId: target.phaseId,\n        phaseTitle: target.phaseTitle,\n        targets: [],\n      };\n      groups.push(group);\n    }\n    group.targets.push(target);\n  }\n\n  return groups.map(({ key: _key, ...group }) => group);\n}\n\nfunction buildReplayResultEnvelope(\n  options: StartWorkflowReplayRunOptions,\n  results: WorkflowReplayTargetResult[],\n): WorkflowResultEnvelope {\n  const done = results.filter((item) => item.status === 'done').length;\n  return {\n    summary: `Replay completed for ${done}/${results.length} target${results.length === 1 ? '' : 's'}.`,\n    sections: [\n      {\n        kind: 'json',\n        title: 'Replay targets',\n        value: {\n          sourceRunId: options.sourceRunId,\n          scope: options.replayScope,\n          targets: results,\n        },\n      },\n    ],\n    structuredOutput: {\n      replay: {\n        sourceRunId: options.sourceRunId,\n        scope: options.replayScope,\n        targets: results,\n      },\n    },\n  };\n}\n\nfunction normalizeReplayInvocation(target: WorkflowReplayAgentTarget): WorkflowAgentInvocationSnapshot {\n  return {\n    prompt: target.invocation?.prompt ?? target.prompt,\n    label: target.invocation?.label ?? target.label,\n    phase: target.invocation?.phase ?? target.phaseTitle,\n    modelRef: target.invocation?.modelRef,\n    resolvedModelRef: target.invocation?.resolvedModelRef,\n    schema: target.invocation?.schema,\n    toolset: target.invocation?.toolset ? [...target.invocation.toolset] : undefined,\n    maxIterations: target.invocation?.maxIterations,\n  };\n}\n\nfunction resolveReplayModel(\n  invocation: WorkflowAgentInvocationSnapshot,\n  resolveModelId: ((modelId: string) => Model<Api>) | undefined,\n): Model<Api> | undefined {\n  const modelRef = invocation.resolvedModelRef ?? invocation.modelRef;\n  if (!modelRef) return undefined;\n  if (!resolveModelId) {\n    throw new Error(`workflow replay missing resolveModelId; cannot resolve model '${modelRef}'`);\n  }\n  return resolveModelId(modelRef);\n}\n\nfunction formatRuntimeAgentId(id: number): string {\n  return `agent-${id}`;\n}\n\nfunction defaultSubagentSessionKey(runId: string, agentId: string): string {\n  return `workflow:${runId}:subagent:${agentId}`;\n}\n\nfunction normalizeCompletedAgentStatus(status: string): 'done' | 'error' | 'skipped' {\n  if (status === 'done' || status === 'error' || status === 'skipped') {\n    return status;\n  }\n  return 'error';\n}\n\nfunction previewWorkflowValue(value: unknown): string | undefined {\n  if (value === null || value === undefined) {\n    return undefined;\n  }\n  if (typeof value === 'string') {\n    return truncate(value, 300);\n  }\n  try {\n    return truncate(JSON.stringify(value), 300);\n  } catch {\n    return truncate(String(value), 300);\n  }\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  const trimmed = value.trim();\n  if (trimmed.length <= maxLength) {\n    return trimmed;\n  }\n  return `${trimmed.slice(0, maxLength - 1)}…`;\n}\n\nfunction toWorkflowResultEnvelope(value: unknown): WorkflowResultEnvelope {\n  if (isWorkflowResultEnvelope(value)) {\n    return value;\n  }\n  if (typeof value === 'string') {\n    return {\n      summary: truncate(value, 800),\n      sections: [{ kind: 'text', title: 'Result', content: value }],\n      raw: value,\n    };\n  }\n  return {\n    summary: 'Workflow completed.',\n    sections: [{ kind: 'json', title: 'Result', value }],\n    raw: value,\n  };\n}\n\nfunction assertWorkflowOutput(definition: WorkflowDefinition, value: unknown): void {\n  const validation = validateWorkflowJsonSchema(definition.outputSchema, value);\n  if (validation.ok) return;\n  throw new WorkflowEngineRunError(\n    'result_validation_failed',\n    validation.message ?? 'Workflow result did not match output schema',\n    false,\n    JSON.stringify(validation.errors ?? []),\n  );\n}\n\nfunction isWorkflowResultEnvelope(value: unknown): value is WorkflowResultEnvelope {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Partial<WorkflowResultEnvelope>;\n  return typeof record.summary === 'string' && Array.isArray(record.sections);\n}\n\nfunction toWorkflowRunError(err: unknown, wasAborted: boolean, abortReason?: unknown): WorkflowRunError {\n  if (err instanceof WorkflowEngineRunError) {\n    return {\n      code: err.code,\n      message: err.message,\n      detail: err.detail,\n      recoverable: err.recoverable,\n    };\n  }\n  const abortMessage = abortReason instanceof Error ? abortReason.message : abortReason ? String(abortReason) : '';\n  const message = abortMessage || (err instanceof Error ? err.message : String(err));\n  if (/timeout|timed out/i.test(message)) {\n    return {\n      code: 'timeout',\n      message,\n      recoverable: true,\n    };\n  }\n  if (wasAborted || /aborted|cancelled/i.test(message)) {\n    return {\n      code: 'cancelled',\n      message: message || 'Workflow run cancelled',\n      recoverable: true,\n    };\n  }\n  if (/quota/i.test(message)) {\n    return {\n      code: 'agent_quota_exceeded',\n      message,\n      recoverable: true,\n    };\n  }\n  return {\n    code: 'runtime_error',\n    message,\n    recoverable: false,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"workflow-engine.js","names":[],"sources":["../../../../src/workflows/engine/workflow-engine.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { WorkflowDefinition } from '../domain/definition.js';\nimport type { WorkflowEventEnvelope, WorkflowEventPayload, WorkflowEventType } from '../domain/event.js';\nimport type { WorkflowAgentStatus, WorkflowRun, WorkflowRunError, WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';\nimport type { WorkflowResultEnvelope } from '../domain/result.js';\nimport { validateWorkflowJsonSchema } from '../domain/schema-validation.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport { createScriptWorkflowRuntime } from '../runtime/script-workflow-runtime.js';\nimport type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport { workflowStepLabel } from '../../agent/workflow/step-labels.js';\nimport type { SubagentProgressEvent } from '../../agent/workflow/types.js';\nimport type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';\nimport type { WorkflowAgentInvocationSnapshot } from '../domain/index.js';\n\nexport interface WorkflowEngineOptions {\n  cwd: string;\n  eventStore: WorkflowEventStore;\n  runStore: WorkflowRunStore;\n  runner: WorkflowScriptSubagentRunner;\n  runtime?: WorkflowRuntime;\n  hooks?: WorkflowEngineHook[];\n  subagentSessionKeyFactory?: (ctx: { runId: string; agentId: string }) => string;\n  parentSessionKey?: string;\n  onEventAppended?: (event: WorkflowEventEnvelope) => void;\n  onRunViewUpdated?: (view: WorkflowRunView) => void;\n  resolveModelId?: (modelId: string) => Model<Api>;\n}\n\nexport interface WorkflowEngineHook {\n  beforeRun?(ctx: WorkflowRunHookContext): Promise<void> | void;\n  beforeAgent?(ctx: WorkflowAgentHookContext): Promise<void> | void;\n  afterAgent?(ctx: WorkflowAgentCompletedHookContext): Promise<void> | void;\n  afterRun?(ctx: WorkflowRunCompletedHookContext): Promise<void> | void;\n}\n\nexport interface WorkflowRunHookContext {\n  definition: WorkflowDefinition;\n  run: WorkflowRun;\n}\n\nexport interface WorkflowAgentHookContext {\n  runId: string;\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  prompt: string;\n}\n\nexport interface WorkflowAgentCompletedHookContext {\n  runId: string;\n  agentId: string;\n  status: 'done' | 'error' | 'skipped';\n  resultPreview?: string;\n}\n\nexport interface WorkflowRunCompletedHookContext {\n  runId: string;\n  status: 'succeeded' | 'failed' | 'cancelled';\n}\n\nexport interface StartWorkflowRunOptions {\n  input?: unknown;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  goal?: string;\n  runId?: string;\n  signal?: AbortSignal;\n  concurrency?: number;\n  maxSubagents?: number;\n  tokenBudget?: number | null;\n  timeoutSec?: number;\n}\n\nexport interface WorkflowReplayAgentTarget {\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  phaseTitle?: string;\n  prompt: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n}\n\nexport interface StartWorkflowReplayRunOptions extends StartWorkflowRunOptions {\n  sourceRunId: string;\n  replayScope: 'failed_agents' | 'failed_phases';\n  targets: WorkflowReplayAgentTarget[];\n}\n\nexport class WorkflowEngine {\n  constructor(private readonly options: WorkflowEngineOptions) {}\n\n  async startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView> {\n    const runId = options.runId ?? randomUUID();\n    const createdAtMs = Date.now();\n    const phaseTitleToId = buildPhaseTitleToId(definition);\n    let currentPhaseId: string | undefined;\n    let eventQueue = Promise.resolve();\n    const progressRecorders = new Map<number, AgentProgressRecorder>();\n    const runtimeAgentStatuses = new Map<number, WorkflowAgentStatus | 'queued'>();\n    const subagentSessionKeys = new Map<number, string>();\n\n    const run: WorkflowRun = {\n      id: runId,\n      definitionId: definition.id,\n      definitionVersion: definition.version,\n      title: definition.title,\n      goal: options.goal ?? definition.description,\n      input: options.input ?? {},\n      status: 'queued',\n      source: options.source,\n      metadata: options.metadata,\n      metrics: {\n        agentCount: 0,\n        doneAgentCount: 0,\n        errorAgentCount: 0,\n        skippedAgentCount: 0,\n        artifactCount: 0,\n      },\n      createdAtMs,\n    };\n\n    const appendEvent = (type: WorkflowEventType, payload: WorkflowEventPayload, createdAtMsOverride?: number) => {\n      eventQueue = eventQueue\n        .then(() =>\n          this.options.eventStore.append({\n            runId,\n            type,\n            payload,\n            createdAtMs: createdAtMsOverride,\n          }),\n        )\n        .then(async (event) => {\n          this.options.onEventAppended?.(event);\n          const view = await this.options.runStore.rebuildRunView(runId);\n          if (view) {\n            this.options.onRunViewUpdated?.(view);\n          }\n        });\n      return eventQueue;\n    };\n\n    await appendEvent('run_queued', { run }, createdAtMs);\n    await this.callHooks((hook) => hook.beforeRun?.({ definition, run }));\n    await appendEvent('run_started', { startedAtMs: Date.now() });\n\n    try {\n      const runtime = this.options.runtime ?? createScriptWorkflowRuntime();\n      const runtimeResult = await withWorkflowTimeout(\n        runtime.run<unknown>(\n          definition.runtime.source,\n          {\n            runner: this.options.runner,\n            resolveModelId: this.options.resolveModelId,\n          },\n          {\n            cwd: this.options.cwd,\n            args: options.input,\n            signal: options.signal,\n            concurrency: options.concurrency ?? definition.defaults.concurrency,\n            maxSubagents: options.maxSubagents ?? definition.defaults.maxSubagents,\n            tokenBudget: options.tokenBudget,\n            onPhase: (title) => {\n              const nextPhaseId = phaseTitleToId.get(title) ?? normalizePhaseId(title);\n              if (currentPhaseId && currentPhaseId !== nextPhaseId) {\n                void appendEvent('phase_completed', { phaseId: currentPhaseId });\n              }\n              currentPhaseId = nextPhaseId;\n              void appendEvent('phase_started', { phaseId: nextPhaseId, title });\n            },\n            onLog: (message) => {\n              void appendEvent('log_appended', { message });\n            },\n            onAgentQueued: (event) => {\n              const agentId = formatRuntimeAgentId(event.id);\n              const subagentSessionKey = this.options.subagentSessionKeyFactory?.({ runId, agentId }) ?? defaultSubagentSessionKey(runId, agentId);\n              subagentSessionKeys.set(event.id, subagentSessionKey);\n              runtimeAgentStatuses.set(event.id, 'queued');\n              const phaseId = event.phase ? (phaseTitleToId.get(event.phase) ?? normalizePhaseId(event.phase)) : currentPhaseId;\n              void this.callHooks((hook) => hook.beforeAgent?.({\n                runId,\n                agentId,\n                label: event.label,\n                phaseId,\n                prompt: event.prompt,\n              }));\n              void appendEvent('agent_queued', {\n                agentId,\n                label: event.label,\n                phaseId,\n                prompt: event.prompt,\n                sessionKey: subagentSessionKey,\n                invocation: event.invocation,\n              });\n            },\n            onAgentStart: (event) => {\n              const currentStatus = runtimeAgentStatuses.get(event.id);\n              if (currentStatus && currentStatus !== 'queued' && currentStatus !== 'running') {\n                return;\n              }\n              runtimeAgentStatuses.set(event.id, 'running');\n              void appendEvent('agent_started', { agentId: formatRuntimeAgentId(event.id) });\n            },\n            onAgentEnd: (event) => {\n              const currentStatus = runtimeAgentStatuses.get(event.id);\n              if (currentStatus && currentStatus !== 'queued' && currentStatus !== 'running') {\n                return;\n              }\n              const agentId = formatRuntimeAgentId(event.id);\n              const completedStatus = normalizeCompletedAgentStatus(event.status);\n              runtimeAgentStatuses.set(event.id, completedStatus);\n              const resultPreview = previewWorkflowValue(event.result);\n              progressRecorders.get(event.id)?.completeOpenSteps(completedStatus === 'done' ? 'done' : 'error');\n              progressRecorders.delete(event.id);\n              void appendEvent('agent_completed', {\n                agentId,\n                status: completedStatus,\n                resultPreview,\n                error: completedStatus === 'error' ? 'Subagent failed' : undefined,\n              }).then(() => this.callHooks((hook) => hook.afterAgent?.({\n                runId,\n                agentId,\n                status: completedStatus,\n                resultPreview,\n              })).catch(() => undefined));\n            },\n            enhanceSubagentRun: (ctx) => {\n              const recorder = new AgentProgressRecorder({\n                agentId: formatRuntimeAgentId(ctx.id),\n                appendEvent,\n              });\n              progressRecorders.set(ctx.id, recorder);\n              const agentId = formatRuntimeAgentId(ctx.id);\n              const sessionKey = subagentSessionKeys.get(ctx.id)\n                ?? this.options.subagentSessionKeyFactory?.({ runId, agentId })\n                ?? defaultSubagentSessionKey(runId, agentId);\n              subagentSessionKeys.set(ctx.id, sessionKey);\n              return {\n                sessionKey,\n                sessionMetadata: {\n                  parentSessionKey: this.options.parentSessionKey,\n                  workflowRunId: runId,\n                  workflowDefinitionId: definition.id,\n                  workflowAgentId: agentId,\n                  workflowAgentLabel: ctx.label,\n                },\n                onProgress: (event) => recorder.onProgress(event),\n              };\n            },\n          },\n        ),\n        options.timeoutSec ?? definition.defaults.timeoutSec,\n      );\n\n      await eventQueue;\n      if (currentPhaseId) {\n        await appendEvent('phase_completed', { phaseId: currentPhaseId });\n      }\n      const result = requireWorkflowResultEnvelope(runtimeResult.result);\n      assertWorkflowOutput(definition, result);\n      await appendEvent('run_completed', { result });\n      await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'succeeded' }));\n    } catch (err) {\n      await eventQueue;\n      const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);\n      const terminalAgentStatus: WorkflowAgentStatus = error.code === 'cancelled' || error.code === 'timeout' ? 'skipped' : 'error';\n      await this.completeOutstandingRuntimeAgents({\n        runId,\n        statuses: runtimeAgentStatuses,\n        progressRecorders,\n        appendEvent,\n        status: terminalAgentStatus,\n        error: terminalAgentStatus === 'error' ? error.message : undefined,\n      });\n      if (error.code === 'cancelled') {\n        await appendEvent('run_cancelled', { reason: error.message });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'cancelled' }));\n      } else {\n        await appendEvent('run_failed', { error });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      }\n    }\n\n    const view = await this.options.runStore.readRunView(runId);\n    if (!view) {\n      throw new Error(`workflow run view was not created for ${runId}`);\n    }\n    return view;\n  }\n\n  async startReplayRun(definition: WorkflowDefinition, options: StartWorkflowReplayRunOptions): Promise<WorkflowRunView> {\n    const runId = options.runId ?? randomUUID();\n    const createdAtMs = Date.now();\n    let eventQueue = Promise.resolve();\n    const progressRecorders = new Map<string, AgentProgressRecorder>();\n\n    const run: WorkflowRun = {\n      id: runId,\n      definitionId: definition.id,\n      definitionVersion: definition.version,\n      title: `${definition.title} replay`,\n      goal: options.goal ?? definition.description,\n      input: options.input ?? {},\n      status: 'queued',\n      source: options.source,\n      metadata: options.metadata,\n      metrics: {\n        agentCount: 0,\n        doneAgentCount: 0,\n        errorAgentCount: 0,\n        skippedAgentCount: 0,\n        artifactCount: 0,\n      },\n      createdAtMs,\n    };\n\n    const appendEvent = (type: WorkflowEventType, payload: WorkflowEventPayload, createdAtMsOverride?: number) => {\n      eventQueue = eventQueue\n        .then(() =>\n          this.options.eventStore.append({\n            runId,\n            type,\n            payload,\n            createdAtMs: createdAtMsOverride,\n          }),\n        )\n        .then(async (event) => {\n          this.options.onEventAppended?.(event);\n          const view = await this.options.runStore.rebuildRunView(runId);\n          if (view) {\n            this.options.onRunViewUpdated?.(view);\n          }\n        });\n      return eventQueue;\n    };\n\n    await appendEvent('run_queued', { run }, createdAtMs);\n    await this.callHooks((hook) => hook.beforeRun?.({ definition, run }));\n    await appendEvent('run_started', { startedAtMs: Date.now() });\n\n    try {\n      const result = await withWorkflowTimeout(\n        this.runReplayTargets({\n          definition,\n          runId,\n          targets: options.targets,\n          signal: options.signal,\n          appendEvent,\n          progressRecorders,\n        }),\n        options.timeoutSec ?? definition.defaults.timeoutSec,\n      );\n\n      await eventQueue;\n      if (result.errors.length > 0) {\n        await appendEvent('run_failed', {\n          error: {\n            code: 'runtime_error',\n            message: `Replay completed with ${result.errors.length} failed target${result.errors.length === 1 ? '' : 's'}.`,\n            detail: result.errors.join('\\n'),\n            recoverable: true,\n          },\n        });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      } else {\n        await appendEvent('run_completed', { result: buildReplayResultEnvelope(options, result.results) });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'succeeded' }));\n      }\n    } catch (err) {\n      await eventQueue;\n      const error = toWorkflowRunError(err, options.signal?.aborted === true, options.signal?.reason);\n      if (error.code === 'cancelled') {\n        await appendEvent('run_cancelled', { reason: error.message });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'cancelled' }));\n      } else {\n        await appendEvent('run_failed', { error });\n        await this.callHooks((hook) => hook.afterRun?.({ runId, status: 'failed' }));\n      }\n    }\n\n    const view = await this.options.runStore.readRunView(runId);\n    if (!view) {\n      throw new Error(`workflow replay run view was not created for ${runId}`);\n    }\n    return view;\n  }\n\n  private async runReplayTargets(params: {\n    definition: WorkflowDefinition;\n    runId: string;\n    targets: WorkflowReplayAgentTarget[];\n    signal?: AbortSignal;\n    appendEvent: AppendWorkflowEvent;\n    progressRecorders: Map<string, AgentProgressRecorder>;\n  }): Promise<{ results: WorkflowReplayTargetResult[]; errors: string[] }> {\n    const results: WorkflowReplayTargetResult[] = [];\n    const errors: string[] = [];\n    const targetsByPhase = groupReplayTargetsByPhase(params.targets);\n\n    for (const group of targetsByPhase) {\n      throwIfSignalAborted(params.signal);\n      if (group.phaseId && group.phaseTitle) {\n        await params.appendEvent('phase_started', { phaseId: group.phaseId, title: group.phaseTitle });\n      }\n\n      const phaseResults = await Promise.all(\n        group.targets.map((target) => this.runReplayTarget({ ...params, target })),\n      );\n      results.push(...phaseResults);\n      errors.push(...phaseResults.filter((item) => item.status === 'error').map((item) => `${item.label}: ${item.error ?? 'failed'}`));\n\n      if (group.phaseId && phaseResults.every((item) => item.status === 'done')) {\n        await params.appendEvent('phase_completed', { phaseId: group.phaseId });\n      }\n    }\n\n    return { results, errors };\n  }\n\n  private async runReplayTarget(params: {\n    definition: WorkflowDefinition;\n    runId: string;\n    target: WorkflowReplayAgentTarget;\n    signal?: AbortSignal;\n    appendEvent: AppendWorkflowEvent;\n    progressRecorders: Map<string, AgentProgressRecorder>;\n  }): Promise<WorkflowReplayTargetResult> {\n    const { target } = params;\n    const invocation = normalizeReplayInvocation(target);\n    const sessionKey = this.options.subagentSessionKeyFactory?.({ runId: params.runId, agentId: target.agentId })\n      ?? defaultSubagentSessionKey(params.runId, target.agentId);\n    await this.callHooks((hook) => hook.beforeAgent?.({\n      runId: params.runId,\n      agentId: target.agentId,\n      label: invocation.label,\n      phaseId: target.phaseId,\n      prompt: invocation.prompt,\n    }));\n    await params.appendEvent('agent_queued', {\n      agentId: target.agentId,\n      label: invocation.label,\n      phaseId: target.phaseId,\n      prompt: invocation.prompt,\n      sessionKey,\n      invocation,\n    });\n    await params.appendEvent('agent_started', { agentId: target.agentId });\n\n    const recorder = new AgentProgressRecorder({\n      agentId: target.agentId,\n      appendEvent: params.appendEvent,\n    });\n    params.progressRecorders.set(target.agentId, recorder);\n\n    try {\n      throwIfSignalAborted(params.signal);\n      const model = resolveReplayModel(invocation, this.options.resolveModelId);\n      const result = await this.options.runner.run<unknown>(invocation.prompt, {\n        label: invocation.label,\n        schema: invocation.schema as never,\n        allowedToolNames: invocation.toolset,\n        maxIterations: invocation.maxIterations,\n        phase: invocation.phase ?? target.phaseTitle,\n        signal: params.signal,\n        model,\n        sessionKey,\n        sessionMetadata: {\n          parentSessionKey: this.options.parentSessionKey,\n          workflowRunId: params.runId,\n          workflowDefinitionId: params.definition.id,\n          workflowAgentId: target.agentId,\n          workflowAgentLabel: invocation.label,\n        },\n        onProgress: (event) => recorder.onProgress(event),\n      });\n      throwIfSignalAborted(params.signal);\n      const status = result === null ? 'error' : 'done';\n      const resultPreview = previewWorkflowValue(result);\n      recorder.completeOpenSteps(status === 'done' ? 'done' : 'error');\n      await params.appendEvent('agent_completed', {\n        agentId: target.agentId,\n        status,\n        resultPreview,\n        error: status === 'error' ? 'Replay target failed' : undefined,\n      });\n      await this.callHooks((hook) => hook.afterAgent?.({\n        runId: params.runId,\n        agentId: target.agentId,\n        status,\n        resultPreview,\n      }));\n      return { agentId: target.agentId, label: invocation.label, phaseId: target.phaseId, status, resultPreview };\n    } catch (err) {\n      if (params.signal?.aborted) throw err;\n      const message = err instanceof Error ? err.message : String(err);\n      recorder.completeOpenSteps('error');\n      await params.appendEvent('agent_completed', {\n        agentId: target.agentId,\n        status: 'error',\n        error: message,\n      });\n      await this.callHooks((hook) => hook.afterAgent?.({\n        runId: params.runId,\n        agentId: target.agentId,\n        status: 'error',\n      }));\n      return { agentId: target.agentId, label: invocation.label, phaseId: target.phaseId, status: 'error', error: message };\n    } finally {\n      params.progressRecorders.delete(target.agentId);\n    }\n  }\n\n  private async completeOutstandingRuntimeAgents(params: {\n    runId: string;\n    statuses: Map<number, WorkflowAgentStatus | 'queued'>;\n    progressRecorders: Map<number, AgentProgressRecorder>;\n    appendEvent: AppendWorkflowEvent;\n    status: Extract<WorkflowAgentStatus, 'done' | 'error' | 'skipped'>;\n    error?: string;\n  }): Promise<void> {\n    for (const [id, currentStatus] of params.statuses) {\n      if (currentStatus !== 'queued' && currentStatus !== 'running') {\n        continue;\n      }\n      params.statuses.set(id, params.status);\n      const recorder = params.progressRecorders.get(id);\n      recorder?.completeOpenSteps(params.status === 'done' ? 'done' : 'error');\n      params.progressRecorders.delete(id);\n      const agentId = formatRuntimeAgentId(id);\n      await params.appendEvent('agent_completed', {\n        agentId,\n        status: params.status,\n        error: params.error,\n      });\n      await this.callHooks((hook) => hook.afterAgent?.({\n        runId: params.runId,\n        agentId,\n        status: params.status,\n      }));\n    }\n  }\n\n  private async callHooks(call: (hook: WorkflowEngineHook) => Promise<void> | void | undefined): Promise<void> {\n    for (const hook of this.options.hooks ?? []) {\n      try {\n        await call(hook);\n      } catch {\n        // Hooks are extension points; workflow execution remains authoritative.\n      }\n    }\n  }\n}\n\ninterface WorkflowReplayTargetResult {\n  agentId: string;\n  label: string;\n  phaseId?: string;\n  status: 'done' | 'error';\n  resultPreview?: string;\n  error?: string;\n}\n\nclass WorkflowEngineRunError extends Error {\n  constructor(\n    readonly code: WorkflowRunError['code'],\n    message: string,\n    readonly recoverable: boolean,\n    readonly detail?: string,\n  ) {\n    super(message);\n    this.name = 'WorkflowEngineRunError';\n  }\n}\n\ntype AppendWorkflowEvent = (\n  type: WorkflowEventType,\n  payload: WorkflowEventPayload,\n  createdAtMsOverride?: number,\n) => Promise<void>;\n\nclass AgentProgressRecorder {\n  private readonly activeToolStepIds = new Map<string, string>();\n  private activeIterationStepId: string | null = null;\n  private activeThinkingStepId: string | null = null;\n  private activeLlmStepId: string | null = null;\n  private sequence = 0;\n\n  constructor(\n    private readonly options: {\n      agentId: string;\n      appendEvent: AppendWorkflowEvent;\n    },\n  ) {}\n\n  onProgress(event: SubagentProgressEvent): void {\n    switch (event.type) {\n      case 'tool_start':\n        this.startToolStep(event);\n        return;\n      case 'tool_end':\n        this.completeToolStep(event);\n        return;\n      case 'iteration':\n        this.replaceSingletonStep('iteration', this.buildIterationLabel(event.count, event.max), 'llm');\n        return;\n      case 'thinking_delta':\n        this.ensureSingletonStep('thinking', 'Thinking', 'thinking');\n        return;\n      case 'text_delta':\n        this.ensureSingletonStep('llm', 'Writing response', 'llm');\n        return;\n      default:\n        return;\n    }\n  }\n\n  completeOpenSteps(status: 'done' | 'error'): void {\n    for (const stepId of this.activeToolStepIds.values()) {\n      void this.options.appendEvent('agent_step_completed', {\n        agentId: this.options.agentId,\n        stepId,\n        status,\n      });\n    }\n    this.activeToolStepIds.clear();\n    this.completeSingletonStep('iteration', status);\n    this.completeSingletonStep('thinking', status);\n    this.completeSingletonStep('llm', status);\n  }\n\n  private startToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_start' }>): void {\n    const stepId = this.nextStepId('tool');\n    const { label, detail } = workflowStepLabel(event.toolName, event.args);\n    this.activeToolStepIds.set(event.toolCallId, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind: 'tool',\n      toolName: event.toolName,\n      detail: detail ?? previewWorkflowValue(event.args),\n    });\n  }\n\n  private completeToolStep(event: Extract<SubagentProgressEvent, { type: 'tool_end' }>): void {\n    const stepId = this.activeToolStepIds.get(event.toolCallId);\n    if (!stepId) return;\n    this.activeToolStepIds.delete(event.toolCallId);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status: event.isError ? 'error' : 'done',\n      resultPreview: event.resultPreview,\n      error: event.error,\n    });\n  }\n\n  private replaceSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    this.completeSingletonStep(slot, 'done');\n    this.ensureSingletonStep(slot, label, kind);\n  }\n\n  private ensureSingletonStep(\n    slot: 'iteration' | 'thinking' | 'llm',\n    label: string,\n    kind: 'tool' | 'llm' | 'thinking',\n  ): void {\n    if (this.getSingletonStepId(slot)) return;\n    const stepId = this.nextStepId(slot);\n    this.setSingletonStepId(slot, stepId);\n    void this.options.appendEvent('agent_step_started', {\n      agentId: this.options.agentId,\n      stepId,\n      label,\n      kind,\n    });\n  }\n\n  private completeSingletonStep(slot: 'iteration' | 'thinking' | 'llm', status: 'done' | 'error'): void {\n    const stepId = this.getSingletonStepId(slot);\n    if (!stepId) return;\n    this.setSingletonStepId(slot, null);\n    void this.options.appendEvent('agent_step_completed', {\n      agentId: this.options.agentId,\n      stepId,\n      status,\n    });\n  }\n\n  private getSingletonStepId(slot: 'iteration' | 'thinking' | 'llm'): string | null {\n    if (slot === 'iteration') return this.activeIterationStepId;\n    if (slot === 'thinking') return this.activeThinkingStepId;\n    return this.activeLlmStepId;\n  }\n\n  private setSingletonStepId(slot: 'iteration' | 'thinking' | 'llm', stepId: string | null): void {\n    if (slot === 'iteration') {\n      this.activeIterationStepId = stepId;\n      return;\n    }\n    if (slot === 'thinking') {\n      this.activeThinkingStepId = stepId;\n      return;\n    }\n    this.activeLlmStepId = stepId;\n  }\n\n  private buildIterationLabel(count: number, max: number): string {\n    if (max > 0) return `Iteration ${count}/${max}`;\n    return `Iteration ${count}`;\n  }\n\n  private nextStepId(kind: string): string {\n    this.sequence += 1;\n    return `${this.options.agentId}-${kind}-${this.sequence}`;\n  }\n}\n\nfunction buildPhaseTitleToId(definition: WorkflowDefinition): Map<string, string> {\n  const phaseTitleToId = new Map<string, string>();\n  for (const phase of definition.phases) {\n    phaseTitleToId.set(phase.title, phase.id);\n  }\n  return phaseTitleToId;\n}\n\nfunction normalizePhaseId(title: string): string {\n  const normalized = title\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n  return normalized || 'phase';\n}\n\nfunction withWorkflowTimeout<T>(promise: Promise<T>, timeoutSec: number | undefined): Promise<T> {\n  if (typeof timeoutSec !== 'number' || !Number.isFinite(timeoutSec) || timeoutSec <= 0) {\n    return promise;\n  }\n\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  const timeoutPromise = new Promise<never>((_resolve, reject) => {\n    timeout = setTimeout(() => {\n      reject(new Error(`workflow timed out after ${timeoutSec}s`));\n    }, timeoutSec * 1000);\n  });\n\n  return Promise.race([promise, timeoutPromise]).finally(() => {\n    if (timeout) clearTimeout(timeout);\n  });\n}\n\nfunction throwIfSignalAborted(signal: AbortSignal | undefined): void {\n  if (!signal?.aborted) return;\n  const reason = signal.reason;\n  if (reason instanceof Error) throw reason;\n  if (reason) throw new Error(String(reason));\n  throw new Error('workflow aborted');\n}\n\nfunction groupReplayTargetsByPhase(targets: WorkflowReplayAgentTarget[]): Array<{\n  phaseId?: string;\n  phaseTitle?: string;\n  targets: WorkflowReplayAgentTarget[];\n}> {\n  const groups: Array<{\n    key: string;\n    phaseId?: string;\n    phaseTitle?: string;\n    targets: WorkflowReplayAgentTarget[];\n  }> = [];\n\n  for (const target of targets) {\n    const key = target.phaseId ?? '';\n    let group = groups.find((item) => item.key === key);\n    if (!group) {\n      group = {\n        key,\n        phaseId: target.phaseId,\n        phaseTitle: target.phaseTitle,\n        targets: [],\n      };\n      groups.push(group);\n    }\n    group.targets.push(target);\n  }\n\n  return groups.map(({ key: _key, ...group }) => group);\n}\n\nfunction buildReplayResultEnvelope(\n  options: StartWorkflowReplayRunOptions,\n  results: WorkflowReplayTargetResult[],\n): WorkflowResultEnvelope {\n  const done = results.filter((item) => item.status === 'done').length;\n  return {\n    summary: `Replay completed for ${done}/${results.length} target${results.length === 1 ? '' : 's'}.`,\n    sections: [\n      {\n        kind: 'json',\n        title: 'Replay targets',\n        value: {\n          sourceRunId: options.sourceRunId,\n          scope: options.replayScope,\n          targets: results,\n        },\n      },\n    ],\n    structuredOutput: {\n      replay: {\n        sourceRunId: options.sourceRunId,\n        scope: options.replayScope,\n        targets: results,\n      },\n    },\n  };\n}\n\nfunction normalizeReplayInvocation(target: WorkflowReplayAgentTarget): WorkflowAgentInvocationSnapshot {\n  return {\n    prompt: target.invocation?.prompt ?? target.prompt,\n    label: target.invocation?.label ?? target.label,\n    phase: target.invocation?.phase ?? target.phaseTitle,\n    modelRef: target.invocation?.modelRef,\n    resolvedModelRef: target.invocation?.resolvedModelRef,\n    schema: target.invocation?.schema,\n    toolset: target.invocation?.toolset ? [...target.invocation.toolset] : undefined,\n    maxIterations: target.invocation?.maxIterations,\n  };\n}\n\nfunction resolveReplayModel(\n  invocation: WorkflowAgentInvocationSnapshot,\n  resolveModelId: ((modelId: string) => Model<Api>) | undefined,\n): Model<Api> | undefined {\n  const modelRef = invocation.resolvedModelRef ?? invocation.modelRef;\n  if (!modelRef) return undefined;\n  if (!resolveModelId) {\n    throw new Error(`workflow replay missing resolveModelId; cannot resolve model '${modelRef}'`);\n  }\n  return resolveModelId(modelRef);\n}\n\nfunction formatRuntimeAgentId(id: number): string {\n  return `agent-${id}`;\n}\n\nfunction defaultSubagentSessionKey(runId: string, agentId: string): string {\n  return `workflow:${runId}:subagent:${agentId}`;\n}\n\nfunction normalizeCompletedAgentStatus(status: string): 'done' | 'error' | 'skipped' {\n  if (status === 'done' || status === 'error' || status === 'skipped') {\n    return status;\n  }\n  return 'error';\n}\n\nfunction previewWorkflowValue(value: unknown): string | undefined {\n  if (value === null || value === undefined) {\n    return undefined;\n  }\n  if (typeof value === 'string') {\n    return truncate(value, 300);\n  }\n  try {\n    return truncate(JSON.stringify(value), 300);\n  } catch {\n    return truncate(String(value), 300);\n  }\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  const trimmed = value.trim();\n  if (trimmed.length <= maxLength) {\n    return trimmed;\n  }\n  return `${trimmed.slice(0, maxLength - 1)}…`;\n}\n\nfunction assertWorkflowOutput(definition: WorkflowDefinition, value: unknown): void {\n  const validation = validateWorkflowJsonSchema(definition.outputSchema, value);\n  if (validation.ok) return;\n  throw new WorkflowEngineRunError(\n    'result_validation_failed',\n    validation.message ?? 'Workflow result did not match output schema',\n    false,\n    JSON.stringify(validation.errors ?? []),\n  );\n}\n\nfunction isWorkflowResultEnvelope(value: unknown): value is WorkflowResultEnvelope {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n  const record = value as Partial<WorkflowResultEnvelope>;\n  return typeof record.summary === 'string' && Array.isArray(record.sections);\n}\n\nfunction requireWorkflowResultEnvelope(value: unknown): WorkflowResultEnvelope {\n  if (isWorkflowResultEnvelope(value)) {\n    return value;\n  }\n  throw new WorkflowEngineRunError(\n    'result_validation_failed',\n    'Workflow scripts must return a WorkflowResultEnvelope with summary and sections.',\n    false,\n  );\n}\n\nfunction toWorkflowRunError(err: unknown, wasAborted: boolean, abortReason?: unknown): WorkflowRunError {\n  if (err instanceof WorkflowEngineRunError) {\n    return {\n      code: err.code,\n      message: err.message,\n      detail: err.detail,\n      recoverable: err.recoverable,\n    };\n  }\n  const abortMessage = abortReason instanceof Error ? abortReason.message : abortReason ? String(abortReason) : '';\n  const message = abortMessage || (err instanceof Error ? err.message : String(err));\n  if (/timeout|timed out/i.test(message)) {\n    return {\n      code: 'timeout',\n      message,\n      recoverable: true,\n    };\n  }\n  if (wasAborted || /aborted|cancelled/i.test(message)) {\n    return {\n      code: 'cancelled',\n      message: message || 'Workflow run cancelled',\n      recoverable: true,\n    };\n  }\n  if (/quota/i.test(message)) {\n    return {\n      code: 'agent_quota_exceeded',\n      message,\n      recoverable: true,\n    };\n  }\n  return {\n    code: 'runtime_error',\n    message,\n    recoverable: false,\n  };\n}\n"],"mappings":"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"}

package/dist/src/workflows/service/workflow-run-service.js

@@ -444,10 +444,9 @@ function buildWorkflowRunDefinitionSnapshot(definition) {
 	return snapshot;
 }
 function resolveWorkflowRunLimits(params) {
-	const cfg = params.config.agents?.defaults?.workflow;
-	const configuredMaxConcurrency = normalizePositiveInt(cfg?.maxConcurrency, params.definition.defaults.concurrency);
-	const configuredMaxSubagents = normalizePositiveInt(cfg?.maxSubagents, params.definition.defaults.maxSubagents);
-	const configuredTimeoutSec = normalizePositiveInt(cfg?.defaultTimeoutSec, params.definition.defaults.timeoutSec);
+	const configuredMaxConcurrency = normalizePositiveInt(void 0, params.definition.defaults.concurrency);
+	const configuredMaxSubagents = normalizePositiveInt(void 0, params.definition.defaults.maxSubagents);
+	const configuredTimeoutSec = normalizePositiveInt(void 0, params.definition.defaults.timeoutSec);
 	return {
 		concurrency: Math.max(1, Math.min(normalizePositiveInt(params.concurrency, params.definition.defaults.concurrency), configuredMaxConcurrency)),
 		maxSubagents: Math.max(1, Math.min(normalizePositiveInt(params.maxSubagents, params.definition.defaults.maxSubagents), configuredMaxSubagents)),