juneau 0.3.2 → 0.3.4

package/README.md

@@ -236,7 +236,16 @@ Converts ai-sdk `fullStream` to Juneau wire SSE strings. Handles all ai-sdk v7 t
 
 #### `withToolRecovery(options)`
 
-Two-phase pattern for Gemini-style tool calls. Phase 1 streams with tools. Phase 2 triggers only when a tool failed **and** no text was produced — it calls the model without tools and injects the failure context to force a text response. Pass `debug: true` to log phase decisions and the `textProduced` / `hadFailure` state at each decision point.
+Multi-phase pattern for Gemini-style tool calls. Phase 1 streams with tools. Phase 2 triggers only when a tool failed **and** no text was produced — it calls the model without tools and injects the failure context to force a text response. Phase 3 (optional) handles the silent-success case — Gemini 2.5 Flash often treats a successful tool call as its complete response and never writes text. When the tool succeeded but no text was produced, `phase3` receives the full phase 1 message history (resolved from the ai-sdk result's `messages` promise — includes tool-call and tool-result turns, which Gemini requires to accept the history) so a second model call without tools can summarise the result. Errors thrown by phase 2/3 are emitted as wire `error` events instead of a silent `done`. Pass `debug: true` to log phase decisions, the resolved phase 3 history, and the `textProduced` / `hadFailure` state at each decision point.
+
+```ts
+yield* withToolRecovery({
+  phase1: () => streamText({ model, system, messages, tools: skillSet.tools, maxSteps: 2 }),
+  phase2: (ctx) => streamText({ model, system, messages: [...messages, { role: 'assistant', content: ctx }] }),
+  phase3: (fullMessages) => streamText({ model, system, messages: fullMessages }), // no tools — forced text
+  skillSet,
+});
+```
 
 ---
 

package/dist/server/index.cjs

@@ -1,12 +1,12 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function x(r){const s=r.map(e=>{const t=e.parts.filter(n=>n.type==="text").map(n=>n.text).join("");return{role:e.role,content:t}}),l=[];for(let e=0;e<s.length;e++){const t=s[e],n=l[l.length-1];t.role==="user"&&n?.role==="user"&&l.push({role:"assistant",content:"…"}),l.push(t)}return l.filter(e=>e.content.length>0)}function f(r){return`data: ${JSON.stringify(r)}
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function w(i){const n=i.map(o=>{const s=o.parts.filter(e=>e.type==="text").map(e=>e.text).join("");return{role:o.role,content:s}}),r=[];for(let o=0;o<n.length;o++){const s=n[o],e=r[r.length-1];s.role==="user"&&e?.role==="user"&&r.push({role:"assistant",content:"…"}),r.push(s)}return r.filter(o=>o.content.length>0)}function h(i){return`data: ${JSON.stringify(i)}
 
-`}function g(r,s){return r[s]??r.en}function T(r,s={}){const l=s.language??"en",e=s.debug??!1,t=[];let n=!1,o=null;const a={};for(const[i,u]of Object.entries(r))a[i]={description:u.description,parameters:u.input,execute:async h=>{e&&console.debug(`[juneau] skill "${i}" → executing, input:`,h);const y=e?Date.now():0;t.push(f({type:"activity",id:i,title:g(u.labels.running,l),status:"running",metadata:{skill:i}}));try{const c=await u.execute(h),d=e?Date.now()-y:0;return e&&console.debug(`[juneau] skill "${i}" → done in ${d}ms, result:`,c),t.push(f({type:"activity",id:i,title:g(u.labels.done,l),status:"done",metadata:{skill:i}})),c}catch(c){const d=e?Date.now()-y:0,m=c instanceof Error?c.message:String(c);e&&console.debug(`[juneau] skill "${i}" → FAILED in ${d}ms: "${m}"`);const v=u.labels.failed??{cs:"Nepodařilo se",en:"Failed"};throw t.push(f({type:"activity",id:i,title:g(v,l),status:"failed",metadata:{skill:i}})),n=!0,o=`Tool "${i}" failed: ${m}`,c}}};return{tools:a,drainActivities(){return t.splice(0,t.length)},get hadFailure(){return n},get failureContext(){return o}}}const b=new Set(["text-delta","text"]),$=new Set(["tool-call","tool-result","tool-input-start","tool-input-delta","tool-input-available","tool-output-available","step-start","finish-step","start","finish","response-metadata","stream-start"]);async function*p(r,s,l){const e=l?.debug??!1;for await(const t of r){const n=t,o=n.type;if(e)if(o&&b.has(o)){const a=n.text??n.textDelta;console.debug(`[juneau] streamToWire chunk: ${o} ${JSON.stringify(a??"")}`)}else o==="tool-call"?console.debug(`[juneau] streamToWire chunk: tool-call "${n.toolName??n.name??"?"}"`):o==="tool-result"?console.debug("[juneau] streamToWire chunk: tool-result (ignored)"):o&&($.has(o)?console.debug(`[juneau] streamToWire chunk: ${o} (ignored)`):console.debug(`[juneau] streamToWire chunk: ${o} (unknown)`));if(o&&b.has(o)){if(s){const i=s.drainActivities();e&&i.length>0&&console.debug(`[juneau] streamToWire → draining ${i.length} activities`);for(const u of i)yield u}const a=n.text??n.textDelta;a&&(e&&console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(a)}`),yield`data: ${JSON.stringify({type:"text",text:a})}
+`}function y(i,n){return i[n]??i.en}function j(i,n={}){const r=n.language??"en",o=n.debug??!1,s=[];let e=!1,a=null;const u={};for(const[t,l]of Object.entries(i))u[t]={description:l.description,parameters:l.input,execute:async d=>{o&&console.debug(`[juneau] skill "${t}" → executing, input:`,d);const p=o?Date.now():0;s.push(h({type:"activity",id:t,title:y(l.labels.running,r),status:"running",metadata:{skill:t}}));try{const c=await l.execute(d),g=o?Date.now()-p:0;return o&&console.debug(`[juneau] skill "${t}" → done in ${g}ms, result:`,c),s.push(h({type:"activity",id:t,title:y(l.labels.done,r),status:"done",metadata:{skill:t}})),c}catch(c){const g=o?Date.now()-p:0,m=c instanceof Error?c.message:String(c);o&&console.debug(`[juneau] skill "${t}" → FAILED in ${g}ms: "${m}"`);const T=l.labels.failed??{cs:"Nepodařilo se",en:"Failed"};throw s.push(h({type:"activity",id:t,title:y(T,r),status:"failed",metadata:{skill:t}})),e=!0,a=`Tool "${t}" failed: ${m}`,c}}};return{tools:u,drainActivities(){return s.splice(0,s.length)},get hadFailure(){return e},get failureContext(){return a}}}const b=new Set(["text-delta","text"]),x=new Set(["tool-call","tool-result","tool-input-start","tool-input-delta","tool-input-available","tool-output-available","step-start","finish-step","start","finish","response-metadata","stream-start"]);async function*f(i,n,r){const o=r?.debug??!1;for await(const s of i){const e=s,a=e.type;if(o)if(a&&b.has(a)){const u=e.text??e.textDelta;console.debug(`[juneau] streamToWire chunk: ${a} ${JSON.stringify(u??"")}`)}else a==="tool-call"?console.debug(`[juneau] streamToWire chunk: tool-call "${e.toolName??e.name??"?"}"`):a==="tool-result"?console.debug("[juneau] streamToWire chunk: tool-result (ignored)"):a&&(x.has(a)?console.debug(`[juneau] streamToWire chunk: ${a} (ignored)`):console.debug(`[juneau] streamToWire chunk: ${a} (unknown)`));if(a&&b.has(a)){if(n){const t=n.drainActivities();o&&t.length>0&&console.debug(`[juneau] streamToWire → draining ${t.length} activities`);for(const l of t)yield l}const u=e.text??e.textDelta;u&&(o&&console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(u)}`),yield`data: ${JSON.stringify({type:"text",text:u})}
 
-`)}}if(s){const t=s.drainActivities();e&&t.length>0&&console.debug(`[juneau] streamToWire → draining ${t.length} activities (end of stream)`);for(const n of t)yield n}e&&console.debug("[juneau] streamToWire → end of stream, emitting done"),yield`data: ${JSON.stringify({type:"done"})}
+`)}}if(n){const s=n.drainActivities();o&&s.length>0&&console.debug(`[juneau] streamToWire → draining ${s.length} activities (end of stream)`);for(const e of s)yield e}o&&console.debug("[juneau] streamToWire → end of stream, emitting done"),yield`data: ${JSON.stringify({type:"done"})}
 
-`}async function*j(r){const{phase1:s,phase2:l,skillSet:e,debug:t=!1}=r;t&&console.debug("[juneau] withToolRecovery → phase 1 start");let n=!1;const o=s();for await(const a of p(o.fullStream,e,{debug:t}))a.includes('"type":"text"')&&(n=!0),!a.includes('"type":"done"')&&(yield a);if(t&&console.debug(`[juneau] withToolRecovery → phase 1 complete, textProduced=${n}, hadFailure=${e.hadFailure}`),e.hadFailure&&!n&&e.failureContext){t&&console.debug("[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2");const a=l(e.failureContext);yield*p(a.fullStream,void 0,{debug:t}),t&&console.debug("[juneau] withToolRecovery → phase 2 complete")}else!n&&!e.hadFailure?(t&&console.debug("[juneau] withToolRecovery → no failure, no text — emitting done (possible Gemini silent response)"),yield`data: ${JSON.stringify({type:"done"})}
+`}function v(i){return`data: ${JSON.stringify({type:"error",message:i})}
 
-`):yield`data: ${JSON.stringify({type:"done"})}
+`}function $(){return`data: ${JSON.stringify({type:"done"})}
 
-`}exports.createSkillSet=T;exports.streamToWire=p;exports.toSdkMessages=x;exports.withToolRecovery=j;
+`}async function*S(i){const{phase1:n,phase2:r,phase3:o,skillSet:s,debug:e=!1}=i;e&&console.debug("[juneau] withToolRecovery → phase 1 start");let a=!1;const u=n();for await(const t of f(u.fullStream,s,{debug:e}))t.includes('"type":"text"')&&(a=!0),!t.includes('"type":"done"')&&(yield t);if(e&&console.debug(`[juneau] withToolRecovery → phase 1 complete, textProduced=${a}, hadFailure=${s.hadFailure}`),s.hadFailure&&!a&&s.failureContext){e&&console.debug("[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2");try{const t=r(s.failureContext);yield*f(t.fullStream,void 0,{debug:e}),e&&console.debug("[juneau] withToolRecovery → phase 2 complete")}catch(t){const l=t instanceof Error?t.message:String(t);e&&console.debug(`[juneau] withToolRecovery → phase 2 FAILED: "${l}"`),yield v(l)}return}if(!a&&!s.hadFailure&&o){const t=await k(u);if(t){e&&(console.debug(`[juneau] withToolRecovery → phase 3 messages resolved (${t.length}):`,JSON.stringify(t,null,2)),R(t)||console.debug("[juneau] withToolRecovery → WARNING: resolved history contains no tool-result turn — Gemini will likely reject it as an invalid conversation structure"),console.debug("[juneau] withToolRecovery → no failure, no text → triggering phase 3"));try{yield*f(o(t).fullStream,void 0,{debug:e}),e&&console.debug("[juneau] withToolRecovery → phase 3 complete")}catch(l){const d=l instanceof Error?l.message:String(l);e&&console.debug(`[juneau] withToolRecovery → phase 3 FAILED: "${d}"`),yield v(d)}return}e&&console.debug("[juneau] withToolRecovery → phase 3 configured but phase 1 result exposes no message history — emitting done")}else!a&&!s.hadFailure&&e&&console.debug("[juneau] withToolRecovery → no failure, no text, no phase3 — emitting done (Gemini silent response)");yield $()}async function k(i){if(i.messages){const n=await i.messages;if(Array.isArray(n)&&n.length>0)return n}if(i.response){const n=await i.response;if(Array.isArray(n?.messages)&&n.messages.length>0)return n.messages}return null}function R(i){return i.some(n=>{const r=n;return r.role==="tool"?!0:Array.isArray(r.content)?r.content.some(o=>o.type==="tool-result"):!1})}exports.createSkillSet=j;exports.streamToWire=f;exports.toSdkMessages=w;exports.withToolRecovery=S;
 //# sourceMappingURL=index.cjs.map

package/dist/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/server/toSdkMessages.ts","../../src/server/createSkillSet.ts","../../src/server/streamToWire.ts","../../src/server/withToolRecovery.ts"],"sourcesContent":["import type { AiMessage } from '../core/types';\r\nimport type { CoreMessage } from './types';\r\n\r\n/**\r\n * Converts Juneau's AiMessage[] to the CoreMessage[] format expected by\r\n * ai-sdk's generateText / streamText.\r\n *\r\n * - Extracts plain text from parts (joins all type: \"text\" parts)\r\n * - Replaces activity-only assistant messages with an empty assistant turn\r\n *   so conversation alternation stays valid\r\n * - Injects a placeholder assistant turn between consecutive user messages\r\n * - Filters out empty turns (unless they are a required alternation filler)\r\n */\r\nexport function toSdkMessages(messages: AiMessage[]): CoreMessage[] {\r\n  // First pass: map each AiMessage to a CoreMessage, replacing activity-only\r\n  // assistant messages with an empty-text assistant turn.\r\n  const mapped: CoreMessage[] = messages.map(msg => {\r\n    const text = msg.parts\r\n      .filter(p => p.type === 'text')\r\n      .map(p => (p as { type: 'text'; text: string }).text)\r\n      .join('');\r\n\r\n    return { role: msg.role as CoreMessage['role'], content: text };\r\n  });\r\n\r\n  // Second pass: inject a placeholder assistant turn between consecutive user\r\n  // messages as a safety net for history bugs that would cause model errors.\r\n  const result: CoreMessage[] = [];\r\n  for (let i = 0; i < mapped.length; i++) {\r\n    const current = mapped[i];\r\n    const prev = result[result.length - 1];\r\n\r\n    if (current.role === 'user' && prev?.role === 'user') {\r\n      result.push({ role: 'assistant', content: '…' });\r\n    }\r\n\r\n    result.push(current);\r\n  }\r\n\r\n  // Third pass: filter out empty turns, but keep assistant placeholders that\r\n  // serve as alternation fillers (they have content '…' set above, so they\r\n  // won't be filtered). Only drop genuinely empty content strings.\r\n  return result.filter(msg => msg.content.length > 0);\r\n}\r\n","import type { ZodType } from 'zod';\nimport type { SkillDefinition, SkillSet, SkillSetOptions } from './types';\n\ntype SkillMap = Record<string, SkillDefinition<ZodType>>;\n\nfunction formatActivityEvent(event: Record<string, unknown>): string {\n  return `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\nfunction pickLabel(labels: { cs: string; en: string }, language: string): string {\n  return (labels as Record<string, string>)[language] ?? labels.en;\n}\n\n/**\n * Takes a map of skill definitions and returns a SkillSet containing:\n * - tools: ready-made tool definitions for ai-sdk's streamText({ tools })\n * - drainActivities(): flush buffered activity wire SSE strings\n * - hadFailure / failureContext: for driving tool failure recovery\n */\nexport function createSkillSet(skills: SkillMap, options: SkillSetOptions = {}): SkillSet {\n  const language = options.language ?? 'en';\n  const debug = options.debug ?? false;\n  const activityBuffer: string[] = [];\n  let hadFailure = false;\n  let failureContext: string | null = null;\n\n  const tools: Record<string, unknown> = {};\n\n  for (const [name, skill] of Object.entries(skills)) {\n    tools[name] = {\n      description: skill.description,\n      parameters: skill.input,\n      execute: async (input: unknown) => {\n        if (debug) {\n          console.debug(`[juneau] skill \"${name}\" → executing, input:`, input);\n        }\n\n        const startMs = debug ? Date.now() : 0;\n\n        // Emit a \"running\" activity event into the buffer\n        activityBuffer.push(\n          formatActivityEvent({\n            type: 'activity',\n            id: name,\n            title: pickLabel(skill.labels.running, language),\n            status: 'running',\n            metadata: { skill: name },\n          })\n        );\n\n        try {\n          const result = await skill.execute(input as never);\n\n          const durationMs = debug ? Date.now() - startMs : 0;\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → done in ${durationMs}ms, result:`, result);\n          }\n\n          // Emit a \"done\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(skill.labels.done, language),\n              status: 'done',\n              metadata: { skill: name },\n            })\n          );\n\n          return result;\n        } catch (err) {\n          const durationMs = debug ? Date.now() - startMs : 0;\n          const message = err instanceof Error ? err.message : String(err);\n\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → FAILED in ${durationMs}ms: \"${message}\"`);\n          }\n\n          const failedLabels = skill.labels.failed ?? { cs: 'Nepodařilo se', en: 'Failed' };\n\n          // Emit a \"failed\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(failedLabels, language),\n              status: 'failed',\n              metadata: { skill: name },\n            })\n          );\n\n          hadFailure = true;\n          failureContext = `Tool \"${name}\" failed: ${message}`;\n\n          // Re-throw so ai-sdk knows the tool call failed\n          throw err;\n        }\n      },\n    };\n  }\n\n  return {\n    tools,\n\n    drainActivities(): string[] {\n      return activityBuffer.splice(0, activityBuffer.length);\n    },\n\n    get hadFailure() {\n      return hadFailure;\n    },\n\n    get failureContext() {\n      return failureContext;\n    },\n  };\n}\n","import type { SkillSet, StreamToWireOptions } from './types';\n\n// ai-sdk v7 chunk types that carry the model's text output.\n// - 'text-delta': standard streaming text (v6 + v7)\n// - 'text':       emitted by some v7 model/provider combos as a completed text chunk\n// Both may appear in the same stream; we handle either.\nconst TEXT_CHUNK_TYPES = new Set(['text-delta', 'text']);\n\n// Chunk types we recognise but intentionally ignore — activities are driven by\n// the SkillSet execute fn, not by these wire events.\nconst IGNORED_CHUNK_TYPES = new Set([\n  'tool-call',\n  'tool-result',\n  'tool-input-start',\n  'tool-input-delta',\n  'tool-input-available',\n  'tool-output-available',\n  'step-start',\n  'finish-step',\n  'start',\n  'finish',\n  'response-metadata',\n  'stream-start',\n]);\n\n/**\n * Converts ai-sdk's fullStream AsyncIterable into Juneau wire SSE strings.\n *\n * Handles:\n * - All text chunk types used by ai-sdk v7 (text-delta, text) incl. v6 textDelta fallback\n * - Flushing skillSet.drainActivities() before each text chunk so activities\n *   always appear before the text they precede\n * - A final drain after the loop ends (catches last-tool-call activities when\n *   no text follows the tool result — the Gemini silent-response scenario)\n * - Emitting the done event when the stream finishes\n * - Structured debug logging of every chunk when options.debug is true\n */\nexport async function* streamToWire(\n  fullStream: AsyncIterable<unknown>,\n  skillSet?: SkillSet,\n  options?: StreamToWireOptions\n): AsyncIterable<string> {\n  const debug = options?.debug ?? false;\n\n  for await (const chunk of fullStream) {\n    const c = chunk as Record<string, unknown>;\n    const type = c.type as string | undefined;\n\n    if (debug) {\n      if (type && TEXT_CHUNK_TYPES.has(type)) {\n        const text = (c.text ?? c.textDelta) as string | undefined;\n        console.debug(`[juneau] streamToWire chunk: ${type} ${JSON.stringify(text ?? '')}`);\n      } else if (type === 'tool-call') {\n        console.debug(`[juneau] streamToWire chunk: tool-call \"${c.toolName ?? c.name ?? '?'}\"`);\n      } else if (type === 'tool-result') {\n        console.debug(`[juneau] streamToWire chunk: tool-result (ignored)`);\n      } else if (type) {\n        if (IGNORED_CHUNK_TYPES.has(type)) {\n          console.debug(`[juneau] streamToWire chunk: ${type} (ignored)`);\n        } else {\n          console.debug(`[juneau] streamToWire chunk: ${type} (unknown)`);\n        }\n      }\n    }\n\n    if (type && TEXT_CHUNK_TYPES.has(type)) {\n      // Flush any buffered activity events before emitting text so the UI\n      // shows running/done indicators before the model's reply appears.\n      if (skillSet) {\n        const activities = skillSet.drainActivities();\n        if (debug && activities.length > 0) {\n          console.debug(`[juneau] streamToWire → draining ${activities.length} activities`);\n        }\n        for (const event of activities) {\n          yield event;\n        }\n      }\n\n      // ai-sdk v7 uses `text`, v6 used `textDelta` — support both\n      const text = (c.text ?? c.textDelta) as string | undefined;\n      if (text) {\n        if (debug) {\n          console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(text)}`);\n        }\n        yield `data: ${JSON.stringify({ type: 'text', text })}\\n\\n`;\n      }\n    }\n\n    // All other chunk types are intentionally silent — the SkillSet execute fn\n    // emits activity events into its buffer which we drain above.\n  }\n\n  // Final drain — catches activity events from the last tool call when no\n  // text-delta followed (Gemini sometimes calls a tool successfully but emits\n  // the reply text in a subsequent step that never arrives as text-delta here).\n  if (skillSet) {\n    const remaining = skillSet.drainActivities();\n    if (debug && remaining.length > 0) {\n      console.debug(`[juneau] streamToWire → draining ${remaining.length} activities (end of stream)`);\n    }\n    for (const event of remaining) {\n      yield event;\n    }\n  }\n\n  if (debug) {\n    console.debug('[juneau] streamToWire → end of stream, emitting done');\n  }\n\n  yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n}\n","import type { ToolRecoveryOptions } from './types';\nimport { streamToWire } from './streamToWire';\n\n/**\n * Encapsulates the two-phase streaming pattern needed for Gemini 2.5 Flash\n * tool call scenarios where the model either fails or silently succeeds without\n * emitting any text in the same stream pass.\n *\n * Phase 1: Stream with tools, maxSteps: 2 (or higher). Collect whether any\n *          text was produced and whether a tool failure occurred.\n *\n * Phase 2 triggers when a tool failed AND no text was produced:\n *   - Injects failureContext as an assistant message so the model is forced to\n *     write a recovery text response (no tools available in phase 2).\n *\n * Silent-success path (hadFailure=false, textProduced=false):\n *   - Gemini called the tool successfully but wrote nothing. This is a known\n *     Gemini 2.5 Flash behaviour when maxSteps > 1: the tool result and the\n *     model's reply text arrive as separate steps, and text-delta may not be\n *     emitted by the time phase 1's fullStream is exhausted. The debug logs\n *     will reveal the exact chunk sequence. In this state we still emit done\n *     cleanly — the consumer can decide whether to retry.\n *\n * @returns AsyncIterable<string> of Juneau wire SSE strings (activities + text + done)\n */\nexport async function* withToolRecovery(options: ToolRecoveryOptions): AsyncIterable<string> {\n  const { phase1, phase2, skillSet, debug = false } = options;\n\n  if (debug) {\n    console.debug('[juneau] withToolRecovery → phase 1 start');\n  }\n\n  let producedText = false;\n\n  const result1 = phase1();\n\n  for await (const chunk of streamToWire(result1.fullStream, skillSet, { debug })) {\n    // Track whether any text reached the wire (done event doesn't count)\n    if (chunk.includes('\"type\":\"text\"')) {\n      producedText = true;\n    }\n\n    // Hold back the done event — we may need to continue with phase 2\n    if (chunk.includes('\"type\":\"done\"')) {\n      continue;\n    }\n\n    yield chunk;\n  }\n\n  if (debug) {\n    console.debug(\n      `[juneau] withToolRecovery → phase 1 complete, textProduced=${producedText}, hadFailure=${skillSet.hadFailure}`\n    );\n  }\n\n  if (skillSet.hadFailure && !producedText && skillSet.failureContext) {\n    // Tool failed and model wrote nothing — run phase 2 to force a text response\n    if (debug) {\n      console.debug('[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2');\n    }\n\n    const result2 = phase2(skillSet.failureContext);\n\n    // Phase 2 has no skillSet — plain text response, no tool calls expected\n    yield* streamToWire(result2.fullStream, undefined, { debug });\n\n    if (debug) {\n      console.debug('[juneau] withToolRecovery → phase 2 complete');\n    }\n  } else if (!producedText && !skillSet.hadFailure) {\n    // Tool succeeded but model emitted no text — Gemini silent-response scenario.\n    // Log clearly so the consumer can see this in debug output and diagnose\n    // whether text arrived in a different chunk type or was simply not generated.\n    if (debug) {\n      console.debug(\n        '[juneau] withToolRecovery → no failure, no text — emitting done (possible Gemini silent response)'\n      );\n    }\n\n    yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n  } else {\n    // Normal success — text was produced, emit done\n    yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n  }\n}\n"],"names":["toSdkMessages","messages","mapped","msg","text","p","result","i","current","prev","formatActivityEvent","event","pickLabel","labels","language","createSkillSet","skills","options","debug","activityBuffer","hadFailure","failureContext","tools","name","skill","input","startMs","durationMs","err","message","failedLabels","TEXT_CHUNK_TYPES","IGNORED_CHUNK_TYPES","streamToWire","fullStream","skillSet","chunk","c","type","activities","remaining","withToolRecovery","phase1","phase2","producedText","result1","result2"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/server/toSdkMessages.ts","../../src/server/createSkillSet.ts","../../src/server/streamToWire.ts","../../src/server/withToolRecovery.ts"],"sourcesContent":["import type { AiMessage } from '../core/types';\r\nimport type { CoreMessage } from './types';\r\n\r\n/**\r\n * Converts Juneau's AiMessage[] to the CoreMessage[] format expected by\r\n * ai-sdk's generateText / streamText.\r\n *\r\n * - Extracts plain text from parts (joins all type: \"text\" parts)\r\n * - Replaces activity-only assistant messages with an empty assistant turn\r\n *   so conversation alternation stays valid\r\n * - Injects a placeholder assistant turn between consecutive user messages\r\n * - Filters out empty turns (unless they are a required alternation filler)\r\n */\r\nexport function toSdkMessages(messages: AiMessage[]): CoreMessage[] {\r\n  // First pass: map each AiMessage to a CoreMessage, replacing activity-only\r\n  // assistant messages with an empty-text assistant turn.\r\n  const mapped: CoreMessage[] = messages.map(msg => {\r\n    const text = msg.parts\r\n      .filter(p => p.type === 'text')\r\n      .map(p => (p as { type: 'text'; text: string }).text)\r\n      .join('');\r\n\r\n    return { role: msg.role as CoreMessage['role'], content: text };\r\n  });\r\n\r\n  // Second pass: inject a placeholder assistant turn between consecutive user\r\n  // messages as a safety net for history bugs that would cause model errors.\r\n  const result: CoreMessage[] = [];\r\n  for (let i = 0; i < mapped.length; i++) {\r\n    const current = mapped[i];\r\n    const prev = result[result.length - 1];\r\n\r\n    if (current.role === 'user' && prev?.role === 'user') {\r\n      result.push({ role: 'assistant', content: '…' });\r\n    }\r\n\r\n    result.push(current);\r\n  }\r\n\r\n  // Third pass: filter out empty turns, but keep assistant placeholders that\r\n  // serve as alternation fillers (they have content '…' set above, so they\r\n  // won't be filtered). Only drop genuinely empty content strings.\r\n  return result.filter(msg => msg.content.length > 0);\r\n}\r\n","import type { ZodType } from 'zod';\nimport type { SkillDefinition, SkillSet, SkillSetOptions } from './types';\n\ntype SkillMap = Record<string, SkillDefinition<ZodType>>;\n\nfunction formatActivityEvent(event: Record<string, unknown>): string {\n  return `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\nfunction pickLabel(labels: { cs: string; en: string }, language: string): string {\n  return (labels as Record<string, string>)[language] ?? labels.en;\n}\n\n/**\n * Takes a map of skill definitions and returns a SkillSet containing:\n * - tools: ready-made tool definitions for ai-sdk's streamText({ tools })\n * - drainActivities(): flush buffered activity wire SSE strings\n * - hadFailure / failureContext: for driving tool failure recovery\n */\nexport function createSkillSet(skills: SkillMap, options: SkillSetOptions = {}): SkillSet {\n  const language = options.language ?? 'en';\n  const debug = options.debug ?? false;\n  const activityBuffer: string[] = [];\n  let hadFailure = false;\n  let failureContext: string | null = null;\n\n  const tools: Record<string, unknown> = {};\n\n  for (const [name, skill] of Object.entries(skills)) {\n    tools[name] = {\n      description: skill.description,\n      parameters: skill.input,\n      execute: async (input: unknown) => {\n        if (debug) {\n          console.debug(`[juneau] skill \"${name}\" → executing, input:`, input);\n        }\n\n        const startMs = debug ? Date.now() : 0;\n\n        // Emit a \"running\" activity event into the buffer\n        activityBuffer.push(\n          formatActivityEvent({\n            type: 'activity',\n            id: name,\n            title: pickLabel(skill.labels.running, language),\n            status: 'running',\n            metadata: { skill: name },\n          })\n        );\n\n        try {\n          const result = await skill.execute(input as never);\n\n          const durationMs = debug ? Date.now() - startMs : 0;\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → done in ${durationMs}ms, result:`, result);\n          }\n\n          // Emit a \"done\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(skill.labels.done, language),\n              status: 'done',\n              metadata: { skill: name },\n            })\n          );\n\n          return result;\n        } catch (err) {\n          const durationMs = debug ? Date.now() - startMs : 0;\n          const message = err instanceof Error ? err.message : String(err);\n\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → FAILED in ${durationMs}ms: \"${message}\"`);\n          }\n\n          const failedLabels = skill.labels.failed ?? { cs: 'Nepodařilo se', en: 'Failed' };\n\n          // Emit a \"failed\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(failedLabels, language),\n              status: 'failed',\n              metadata: { skill: name },\n            })\n          );\n\n          hadFailure = true;\n          failureContext = `Tool \"${name}\" failed: ${message}`;\n\n          // Re-throw so ai-sdk knows the tool call failed\n          throw err;\n        }\n      },\n    };\n  }\n\n  return {\n    tools,\n\n    drainActivities(): string[] {\n      return activityBuffer.splice(0, activityBuffer.length);\n    },\n\n    get hadFailure() {\n      return hadFailure;\n    },\n\n    get failureContext() {\n      return failureContext;\n    },\n  };\n}\n","import type { SkillSet, StreamToWireOptions } from './types';\n\n// ai-sdk v7 chunk types that carry the model's text output.\n// - 'text-delta': standard streaming text (v6 + v7)\n// - 'text':       emitted by some v7 model/provider combos as a completed text chunk\n// Both may appear in the same stream; we handle either.\nconst TEXT_CHUNK_TYPES = new Set(['text-delta', 'text']);\n\n// Chunk types we recognise but intentionally ignore — activities are driven by\n// the SkillSet execute fn, not by these wire events.\nconst IGNORED_CHUNK_TYPES = new Set([\n  'tool-call',\n  'tool-result',\n  'tool-input-start',\n  'tool-input-delta',\n  'tool-input-available',\n  'tool-output-available',\n  'step-start',\n  'finish-step',\n  'start',\n  'finish',\n  'response-metadata',\n  'stream-start',\n]);\n\n/**\n * Converts ai-sdk's fullStream AsyncIterable into Juneau wire SSE strings.\n *\n * Handles:\n * - All text chunk types used by ai-sdk v7 (text-delta, text) incl. v6 textDelta fallback\n * - Flushing skillSet.drainActivities() before each text chunk so activities\n *   always appear before the text they precede\n * - A final drain after the loop ends (catches last-tool-call activities when\n *   no text follows the tool result — the Gemini silent-response scenario)\n * - Emitting the done event when the stream finishes\n * - Structured debug logging of every chunk when options.debug is true\n */\nexport async function* streamToWire(\n  fullStream: AsyncIterable<unknown>,\n  skillSet?: SkillSet,\n  options?: StreamToWireOptions\n): AsyncIterable<string> {\n  const debug = options?.debug ?? false;\n\n  for await (const chunk of fullStream) {\n    const c = chunk as Record<string, unknown>;\n    const type = c.type as string | undefined;\n\n    if (debug) {\n      if (type && TEXT_CHUNK_TYPES.has(type)) {\n        const text = (c.text ?? c.textDelta) as string | undefined;\n        console.debug(`[juneau] streamToWire chunk: ${type} ${JSON.stringify(text ?? '')}`);\n      } else if (type === 'tool-call') {\n        console.debug(`[juneau] streamToWire chunk: tool-call \"${c.toolName ?? c.name ?? '?'}\"`);\n      } else if (type === 'tool-result') {\n        console.debug(`[juneau] streamToWire chunk: tool-result (ignored)`);\n      } else if (type) {\n        if (IGNORED_CHUNK_TYPES.has(type)) {\n          console.debug(`[juneau] streamToWire chunk: ${type} (ignored)`);\n        } else {\n          console.debug(`[juneau] streamToWire chunk: ${type} (unknown)`);\n        }\n      }\n    }\n\n    if (type && TEXT_CHUNK_TYPES.has(type)) {\n      // Flush any buffered activity events before emitting text so the UI\n      // shows running/done indicators before the model's reply appears.\n      if (skillSet) {\n        const activities = skillSet.drainActivities();\n        if (debug && activities.length > 0) {\n          console.debug(`[juneau] streamToWire → draining ${activities.length} activities`);\n        }\n        for (const event of activities) {\n          yield event;\n        }\n      }\n\n      // ai-sdk v7 uses `text`, v6 used `textDelta` — support both\n      const text = (c.text ?? c.textDelta) as string | undefined;\n      if (text) {\n        if (debug) {\n          console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(text)}`);\n        }\n        yield `data: ${JSON.stringify({ type: 'text', text })}\\n\\n`;\n      }\n    }\n\n    // All other chunk types are intentionally silent — the SkillSet execute fn\n    // emits activity events into its buffer which we drain above.\n  }\n\n  // Final drain — catches activity events from the last tool call when no\n  // text-delta followed (Gemini sometimes calls a tool successfully but emits\n  // the reply text in a subsequent step that never arrives as text-delta here).\n  if (skillSet) {\n    const remaining = skillSet.drainActivities();\n    if (debug && remaining.length > 0) {\n      console.debug(`[juneau] streamToWire → draining ${remaining.length} activities (end of stream)`);\n    }\n    for (const event of remaining) {\n      yield event;\n    }\n  }\n\n  if (debug) {\n    console.debug('[juneau] streamToWire → end of stream, emitting done');\n  }\n\n  yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n}\n","import type { ToolRecoveryOptions } from './types';\nimport { streamToWire } from './streamToWire';\n\nfunction wireError(message: string): string {\n  return `data: ${JSON.stringify({ type: 'error', message })}\\n\\n`;\n}\n\nfunction wireDone(): string {\n  return `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n}\n\n/**\n * Encapsulates the multi-phase streaming pattern needed for Gemini 2.5 Flash\n * tool call scenarios where the model either fails or silently succeeds without\n * emitting any text in the same stream pass.\n *\n * Phase 1: Stream with tools. Collect whether any text was produced and whether\n *          a tool failure occurred.\n *\n * Phase 2 (failure recovery) — triggers when a tool failed AND no text was produced:\n *   - Injects failureContext as an assistant message so the model is forced to\n *     write a recovery text response (no tools available in phase 2).\n *\n * Phase 3 (silent-success recovery) — triggers when the tool succeeded but the\n * model wrote no text. Confirmed Gemini 2.5 Flash behaviour: the fullStream ends\n * with tool-call → tool-result → finish-step → finish and no text-delta ever\n * arrives — Gemini treats the tool call as its complete response. Phase 3 receives\n * the full phase 1 message history including tool-call AND tool-result turns —\n * Gemini rejects histories where a tool-call turn is not immediately followed by\n * a tool-result turn (\"function call turn must come immediately after a user turn\n * or after a function response turn\"). The history is resolved from the consumed\n * phase 1 result's `messages` promise (ai-sdk v7 — resolves to all turns after\n * the stream is consumed), with `response.messages` as fallback.\n * If phase3 is not provided, falls back to emitting done (previous behaviour).\n *\n * Errors thrown by phase 2 / phase 3 model calls are surfaced as wire error\n * events — never swallowed into a silent done.\n *\n * @returns AsyncIterable<string> of Juneau wire SSE strings (activities + text + done)\n */\nexport async function* withToolRecovery(options: ToolRecoveryOptions): AsyncIterable<string> {\n  const { phase1, phase2, phase3, skillSet, debug = false } = options;\n\n  if (debug) {\n    console.debug('[juneau] withToolRecovery → phase 1 start');\n  }\n\n  let producedText = false;\n\n  const result1 = phase1();\n\n  for await (const chunk of streamToWire(result1.fullStream, skillSet, { debug })) {\n    // Track whether any text reached the wire (done event doesn't count)\n    if (chunk.includes('\"type\":\"text\"')) {\n      producedText = true;\n    }\n\n    // Hold back the done event — we may need to continue with phase 2 or 3\n    if (chunk.includes('\"type\":\"done\"')) {\n      continue;\n    }\n\n    yield chunk;\n  }\n\n  if (debug) {\n    console.debug(\n      `[juneau] withToolRecovery → phase 1 complete, textProduced=${producedText}, hadFailure=${skillSet.hadFailure}`\n    );\n  }\n\n  if (skillSet.hadFailure && !producedText && skillSet.failureContext) {\n    // Tool failed and model wrote nothing — run phase 2 to force a text response\n    if (debug) {\n      console.debug('[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2');\n    }\n\n    try {\n      const result2 = phase2(skillSet.failureContext);\n\n      // Phase 2 has no skillSet — plain text response, no tool calls expected\n      yield* streamToWire(result2.fullStream, undefined, { debug });\n\n      if (debug) {\n        console.debug('[juneau] withToolRecovery → phase 2 complete');\n      }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      if (debug) {\n        console.debug(`[juneau] withToolRecovery → phase 2 FAILED: \"${message}\"`);\n      }\n      yield wireError(message);\n    }\n    return;\n  }\n\n  if (!producedText && !skillSet.hadFailure && phase3) {\n    // Tool succeeded but model emitted no text — Gemini silent-response scenario.\n    // Resolve the full message history from the consumed phase 1 result and let\n    // phase 3 call the model again (no tools) to summarise the tool result.\n    const fullMessages = await resolvePhase1Messages(result1);\n\n    if (fullMessages) {\n      if (debug) {\n        console.debug(\n          `[juneau] withToolRecovery → phase 3 messages resolved (${fullMessages.length}):`,\n          JSON.stringify(fullMessages, null, 2)\n        );\n        if (!containsToolResult(fullMessages)) {\n          console.debug(\n            '[juneau] withToolRecovery → WARNING: resolved history contains no tool-result turn — Gemini will likely reject it as an invalid conversation structure'\n          );\n        }\n        console.debug('[juneau] withToolRecovery → no failure, no text → triggering phase 3');\n      }\n\n      try {\n        yield* streamToWire(phase3(fullMessages).fullStream, undefined, { debug });\n\n        if (debug) {\n          console.debug('[juneau] withToolRecovery → phase 3 complete');\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        if (debug) {\n          console.debug(`[juneau] withToolRecovery → phase 3 FAILED: \"${message}\"`);\n        }\n        yield wireError(message);\n      }\n      return;\n    }\n\n    if (debug) {\n      console.debug(\n        '[juneau] withToolRecovery → phase 3 configured but phase 1 result exposes no message history — emitting done'\n      );\n    }\n  } else if (!producedText && !skillSet.hadFailure && debug) {\n    console.debug(\n      '[juneau] withToolRecovery → no failure, no text, no phase3 — emitting done (Gemini silent response)'\n    );\n  }\n\n  yield wireDone();\n}\n\n/**\n * Resolves the full message history (incl. tool-call/tool-result turns) from a\n * consumed ai-sdk StreamTextResult.\n *\n * ai-sdk v7: `result.messages` is the promise that resolves to ALL turns —\n * user, assistant(tool-call), tool(tool-result) — after the stream is consumed.\n * `result.response.messages` may resolve to an incomplete subset (observed:\n * tool-call turn without the following tool-result turn, which Gemini rejects),\n * so it is only used as a fallback when `messages` is unavailable.\n *\n * Both promises resolve only after the fullStream has been fully consumed,\n * which is guaranteed at the call site.\n */\nasync function resolvePhase1Messages(result: {\n  messages?: Promise<unknown[]>;\n  response?: Promise<{ messages?: unknown[] }>;\n}): Promise<unknown[] | null> {\n  if (result.messages) {\n    const messages = await result.messages;\n    if (Array.isArray(messages) && messages.length > 0) {\n      return messages;\n    }\n  }\n\n  if (result.response) {\n    const response = await result.response;\n    if (Array.isArray(response?.messages) && response.messages.length > 0) {\n      return response.messages;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Checks whether the resolved history contains a tool-result turn — either as\n * a `role: 'tool'` message or a content part with `type: 'tool-result'`.\n * Used only for the debug warning; the messages themselves are passed through opaquely.\n */\nfunction containsToolResult(messages: unknown[]): boolean {\n  return messages.some((m) => {\n    const msg = m as { role?: string; content?: unknown };\n    if (msg.role === 'tool') return true;\n    if (Array.isArray(msg.content)) {\n      return msg.content.some(\n        (part) => (part as { type?: string }).type === 'tool-result'\n      );\n    }\n    return false;\n  });\n}\n"],"names":["toSdkMessages","messages","mapped","msg","text","p","result","i","current","prev","formatActivityEvent","event","pickLabel","labels","language","createSkillSet","skills","options","debug","activityBuffer","hadFailure","failureContext","tools","name","skill","input","startMs","durationMs","err","message","failedLabels","TEXT_CHUNK_TYPES","IGNORED_CHUNK_TYPES","streamToWire","fullStream","skillSet","chunk","c","type","activities","remaining","wireError","wireDone","withToolRecovery","phase1","phase2","phase3","producedText","result1","result2","fullMessages","resolvePhase1Messages","containsToolResult","response","m","part"],"mappings":"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"}

package/dist/server/index.d.ts

@@ -2,5 +2,5 @@ export { toSdkMessages } from './toSdkMessages';
 export { createSkillSet } from './createSkillSet';
 export { streamToWire } from './streamToWire';
 export { withToolRecovery } from './withToolRecovery';
-export type { SkillSet, SkillDefinition, SkillSetOptions, ToolRecoveryOptions, StreamToWireOptions, CoreMessage } from './types';
+export type { SkillSet, SkillDefinition, SkillSetOptions, ToolRecoveryOptions, ToolRecoveryStreamResult, StreamToWireOptions, CoreMessage } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/server/index.js

@@ -1,83 +1,83 @@
-function $(r) {
-  const s = r.map((e) => {
-    const t = e.parts.filter((n) => n.type === "text").map((n) => n.text).join("");
-    return { role: e.role, content: t };
-  }), l = [];
-  for (let e = 0; e < s.length; e++) {
-    const t = s[e], n = l[l.length - 1];
-    t.role === "user" && n?.role === "user" && l.push({ role: "assistant", content: "…" }), l.push(t);
+function S(i) {
+  const o = i.map((n) => {
+    const s = n.parts.filter((e) => e.type === "text").map((e) => e.text).join("");
+    return { role: n.role, content: s };
+  }), r = [];
+  for (let n = 0; n < o.length; n++) {
+    const s = o[n], e = r[r.length - 1];
+    s.role === "user" && e?.role === "user" && r.push({ role: "assistant", content: "…" }), r.push(s);
   }
-  return l.filter((e) => e.content.length > 0);
+  return r.filter((n) => n.content.length > 0);
 }
-function f(r) {
-  return `data: ${JSON.stringify(r)}
+function g(i) {
+  return `data: ${JSON.stringify(i)}
 
 `;
 }
-function g(r, s) {
-  return r[s] ?? r.en;
+function h(i, o) {
+  return i[o] ?? i.en;
 }
-function T(r, s = {}) {
-  const l = s.language ?? "en", e = s.debug ?? !1, t = [];
-  let n = !1, o = null;
-  const a = {};
-  for (const [i, u] of Object.entries(r))
-    a[i] = {
-      description: u.description,
-      parameters: u.input,
-      execute: async (p) => {
-        e && console.debug(`[juneau] skill "${i}" → executing, input:`, p);
-        const h = e ? Date.now() : 0;
-        t.push(
-          f({
+function k(i, o = {}) {
+  const r = o.language ?? "en", n = o.debug ?? !1, s = [];
+  let e = !1, a = null;
+  const u = {};
+  for (const [t, l] of Object.entries(i))
+    u[t] = {
+      description: l.description,
+      parameters: l.input,
+      execute: async (d) => {
+        n && console.debug(`[juneau] skill "${t}" → executing, input:`, d);
+        const p = n ? Date.now() : 0;
+        s.push(
+          g({
             type: "activity",
-            id: i,
-            title: g(u.labels.running, l),
+            id: t,
+            title: h(l.labels.running, r),
             status: "running",
-            metadata: { skill: i }
+            metadata: { skill: t }
           })
         );
         try {
-          const c = await u.execute(p), d = e ? Date.now() - h : 0;
-          return e && console.debug(`[juneau] skill "${i}" → done in ${d}ms, result:`, c), t.push(
-            f({
+          const c = await l.execute(d), f = n ? Date.now() - p : 0;
+          return n && console.debug(`[juneau] skill "${t}" → done in ${f}ms, result:`, c), s.push(
+            g({
               type: "activity",
-              id: i,
-              title: g(u.labels.done, l),
+              id: t,
+              title: h(l.labels.done, r),
               status: "done",
-              metadata: { skill: i }
+              metadata: { skill: t }
             })
           ), c;
         } catch (c) {
-          const d = e ? Date.now() - h : 0, y = c instanceof Error ? c.message : String(c);
-          e && console.debug(`[juneau] skill "${i}" → FAILED in ${d}ms: "${y}"`);
-          const x = u.labels.failed ?? { cs: "Nepodařilo se", en: "Failed" };
-          throw t.push(
-            f({
+          const f = n ? Date.now() - p : 0, m = c instanceof Error ? c.message : String(c);
+          n && console.debug(`[juneau] skill "${t}" → FAILED in ${f}ms: "${m}"`);
+          const T = l.labels.failed ?? { cs: "Nepodařilo se", en: "Failed" };
+          throw s.push(
+            g({
               type: "activity",
-              id: i,
-              title: g(x, l),
+              id: t,
+              title: h(T, r),
               status: "failed",
-              metadata: { skill: i }
+              metadata: { skill: t }
             })
-          ), n = !0, o = `Tool "${i}" failed: ${y}`, c;
+          ), e = !0, a = `Tool "${t}" failed: ${m}`, c;
         }
       }
     };
   return {
-    tools: a,
+    tools: u,
     drainActivities() {
-      return t.splice(0, t.length);
+      return s.splice(0, s.length);
     },
     get hadFailure() {
-      return n;
+      return e;
     },
     get failureContext() {
-      return o;
+      return a;
     }
   };
 }
-const m = /* @__PURE__ */ new Set(["text-delta", "text"]), v = /* @__PURE__ */ new Set([
+const b = /* @__PURE__ */ new Set(["text-delta", "text"]), w = /* @__PURE__ */ new Set([
   "tool-call",
   "tool-result",
   "tool-input-start",
@@ -91,63 +91,118 @@ const m = /* @__PURE__ */ new Set(["text-delta", "text"]), v = /* @__PURE__ */ n
   "response-metadata",
   "stream-start"
 ]);
-async function* b(r, s, l) {
-  const e = l?.debug ?? !1;
-  for await (const t of r) {
-    const n = t, o = n.type;
-    if (e)
-      if (o && m.has(o)) {
-        const a = n.text ?? n.textDelta;
-        console.debug(`[juneau] streamToWire chunk: ${o} ${JSON.stringify(a ?? "")}`);
-      } else o === "tool-call" ? console.debug(`[juneau] streamToWire chunk: tool-call "${n.toolName ?? n.name ?? "?"}"`) : o === "tool-result" ? console.debug("[juneau] streamToWire chunk: tool-result (ignored)") : o && (v.has(o) ? console.debug(`[juneau] streamToWire chunk: ${o} (ignored)`) : console.debug(`[juneau] streamToWire chunk: ${o} (unknown)`));
-    if (o && m.has(o)) {
-      if (s) {
-        const i = s.drainActivities();
-        e && i.length > 0 && console.debug(`[juneau] streamToWire → draining ${i.length} activities`);
-        for (const u of i)
-          yield u;
+async function* y(i, o, r) {
+  const n = r?.debug ?? !1;
+  for await (const s of i) {
+    const e = s, a = e.type;
+    if (n)
+      if (a && b.has(a)) {
+        const u = e.text ?? e.textDelta;
+        console.debug(`[juneau] streamToWire chunk: ${a} ${JSON.stringify(u ?? "")}`);
+      } else a === "tool-call" ? console.debug(`[juneau] streamToWire chunk: tool-call "${e.toolName ?? e.name ?? "?"}"`) : a === "tool-result" ? console.debug("[juneau] streamToWire chunk: tool-result (ignored)") : a && (w.has(a) ? console.debug(`[juneau] streamToWire chunk: ${a} (ignored)`) : console.debug(`[juneau] streamToWire chunk: ${a} (unknown)`));
+    if (a && b.has(a)) {
+      if (o) {
+        const t = o.drainActivities();
+        n && t.length > 0 && console.debug(`[juneau] streamToWire → draining ${t.length} activities`);
+        for (const l of t)
+          yield l;
       }
-      const a = n.text ?? n.textDelta;
-      a && (e && console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(a)}`), yield `data: ${JSON.stringify({ type: "text", text: a })}
+      const u = e.text ?? e.textDelta;
+      u && (n && console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(u)}`), yield `data: ${JSON.stringify({ type: "text", text: u })}
 
 `);
     }
   }
-  if (s) {
-    const t = s.drainActivities();
-    e && t.length > 0 && console.debug(`[juneau] streamToWire → draining ${t.length} activities (end of stream)`);
-    for (const n of t)
-      yield n;
+  if (o) {
+    const s = o.drainActivities();
+    n && s.length > 0 && console.debug(`[juneau] streamToWire → draining ${s.length} activities (end of stream)`);
+    for (const e of s)
+      yield e;
   }
-  e && console.debug("[juneau] streamToWire → end of stream, emitting done"), yield `data: ${JSON.stringify({ type: "done" })}
+  n && console.debug("[juneau] streamToWire → end of stream, emitting done"), yield `data: ${JSON.stringify({ type: "done" })}
 
 `;
 }
-async function* j(r) {
-  const { phase1: s, phase2: l, skillSet: e, debug: t = !1 } = r;
-  t && console.debug("[juneau] withToolRecovery → phase 1 start");
-  let n = !1;
-  const o = s();
-  for await (const a of b(o.fullStream, e, { debug: t }))
-    a.includes('"type":"text"') && (n = !0), !a.includes('"type":"done"') && (yield a);
-  if (t && console.debug(
-    `[juneau] withToolRecovery → phase 1 complete, textProduced=${n}, hadFailure=${e.hadFailure}`
-  ), e.hadFailure && !n && e.failureContext) {
-    t && console.debug("[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2");
-    const a = l(e.failureContext);
-    yield* b(a.fullStream, void 0, { debug: t }), t && console.debug("[juneau] withToolRecovery → phase 2 complete");
-  } else !n && !e.hadFailure ? (t && console.debug(
-    "[juneau] withToolRecovery → no failure, no text — emitting done (possible Gemini silent response)"
-  ), yield `data: ${JSON.stringify({ type: "done" })}
+function v(i) {
+  return `data: ${JSON.stringify({ type: "error", message: i })}
 
-`) : yield `data: ${JSON.stringify({ type: "done" })}
+`;
+}
+function x() {
+  return `data: ${JSON.stringify({ type: "done" })}
 
 `;
 }
+async function* R(i) {
+  const { phase1: o, phase2: r, phase3: n, skillSet: s, debug: e = !1 } = i;
+  e && console.debug("[juneau] withToolRecovery → phase 1 start");
+  let a = !1;
+  const u = o();
+  for await (const t of y(u.fullStream, s, { debug: e }))
+    t.includes('"type":"text"') && (a = !0), !t.includes('"type":"done"') && (yield t);
+  if (e && console.debug(
+    `[juneau] withToolRecovery → phase 1 complete, textProduced=${a}, hadFailure=${s.hadFailure}`
+  ), s.hadFailure && !a && s.failureContext) {
+    e && console.debug("[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2");
+    try {
+      const t = r(s.failureContext);
+      yield* y(t.fullStream, void 0, { debug: e }), e && console.debug("[juneau] withToolRecovery → phase 2 complete");
+    } catch (t) {
+      const l = t instanceof Error ? t.message : String(t);
+      e && console.debug(`[juneau] withToolRecovery → phase 2 FAILED: "${l}"`), yield v(l);
+    }
+    return;
+  }
+  if (!a && !s.hadFailure && n) {
+    const t = await j(u);
+    if (t) {
+      e && (console.debug(
+        `[juneau] withToolRecovery → phase 3 messages resolved (${t.length}):`,
+        JSON.stringify(t, null, 2)
+      ), $(t) || console.debug(
+        "[juneau] withToolRecovery → WARNING: resolved history contains no tool-result turn — Gemini will likely reject it as an invalid conversation structure"
+      ), console.debug("[juneau] withToolRecovery → no failure, no text → triggering phase 3"));
+      try {
+        yield* y(n(t).fullStream, void 0, { debug: e }), e && console.debug("[juneau] withToolRecovery → phase 3 complete");
+      } catch (l) {
+        const d = l instanceof Error ? l.message : String(l);
+        e && console.debug(`[juneau] withToolRecovery → phase 3 FAILED: "${d}"`), yield v(d);
+      }
+      return;
+    }
+    e && console.debug(
+      "[juneau] withToolRecovery → phase 3 configured but phase 1 result exposes no message history — emitting done"
+    );
+  } else !a && !s.hadFailure && e && console.debug(
+    "[juneau] withToolRecovery → no failure, no text, no phase3 — emitting done (Gemini silent response)"
+  );
+  yield x();
+}
+async function j(i) {
+  if (i.messages) {
+    const o = await i.messages;
+    if (Array.isArray(o) && o.length > 0)
+      return o;
+  }
+  if (i.response) {
+    const o = await i.response;
+    if (Array.isArray(o?.messages) && o.messages.length > 0)
+      return o.messages;
+  }
+  return null;
+}
+function $(i) {
+  return i.some((o) => {
+    const r = o;
+    return r.role === "tool" ? !0 : Array.isArray(r.content) ? r.content.some(
+      (n) => n.type === "tool-result"
+    ) : !1;
+  });
+}
 export {
-  T as createSkillSet,
-  b as streamToWire,
-  $ as toSdkMessages,
-  j as withToolRecovery
+  k as createSkillSet,
+  y as streamToWire,
+  S as toSdkMessages,
+  R as withToolRecovery
 };
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/server/toSdkMessages.ts","../../src/server/createSkillSet.ts","../../src/server/streamToWire.ts","../../src/server/withToolRecovery.ts"],"sourcesContent":["import type { AiMessage } from '../core/types';\r\nimport type { CoreMessage } from './types';\r\n\r\n/**\r\n * Converts Juneau's AiMessage[] to the CoreMessage[] format expected by\r\n * ai-sdk's generateText / streamText.\r\n *\r\n * - Extracts plain text from parts (joins all type: \"text\" parts)\r\n * - Replaces activity-only assistant messages with an empty assistant turn\r\n *   so conversation alternation stays valid\r\n * - Injects a placeholder assistant turn between consecutive user messages\r\n * - Filters out empty turns (unless they are a required alternation filler)\r\n */\r\nexport function toSdkMessages(messages: AiMessage[]): CoreMessage[] {\r\n  // First pass: map each AiMessage to a CoreMessage, replacing activity-only\r\n  // assistant messages with an empty-text assistant turn.\r\n  const mapped: CoreMessage[] = messages.map(msg => {\r\n    const text = msg.parts\r\n      .filter(p => p.type === 'text')\r\n      .map(p => (p as { type: 'text'; text: string }).text)\r\n      .join('');\r\n\r\n    return { role: msg.role as CoreMessage['role'], content: text };\r\n  });\r\n\r\n  // Second pass: inject a placeholder assistant turn between consecutive user\r\n  // messages as a safety net for history bugs that would cause model errors.\r\n  const result: CoreMessage[] = [];\r\n  for (let i = 0; i < mapped.length; i++) {\r\n    const current = mapped[i];\r\n    const prev = result[result.length - 1];\r\n\r\n    if (current.role === 'user' && prev?.role === 'user') {\r\n      result.push({ role: 'assistant', content: '…' });\r\n    }\r\n\r\n    result.push(current);\r\n  }\r\n\r\n  // Third pass: filter out empty turns, but keep assistant placeholders that\r\n  // serve as alternation fillers (they have content '…' set above, so they\r\n  // won't be filtered). Only drop genuinely empty content strings.\r\n  return result.filter(msg => msg.content.length > 0);\r\n}\r\n","import type { ZodType } from 'zod';\nimport type { SkillDefinition, SkillSet, SkillSetOptions } from './types';\n\ntype SkillMap = Record<string, SkillDefinition<ZodType>>;\n\nfunction formatActivityEvent(event: Record<string, unknown>): string {\n  return `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\nfunction pickLabel(labels: { cs: string; en: string }, language: string): string {\n  return (labels as Record<string, string>)[language] ?? labels.en;\n}\n\n/**\n * Takes a map of skill definitions and returns a SkillSet containing:\n * - tools: ready-made tool definitions for ai-sdk's streamText({ tools })\n * - drainActivities(): flush buffered activity wire SSE strings\n * - hadFailure / failureContext: for driving tool failure recovery\n */\nexport function createSkillSet(skills: SkillMap, options: SkillSetOptions = {}): SkillSet {\n  const language = options.language ?? 'en';\n  const debug = options.debug ?? false;\n  const activityBuffer: string[] = [];\n  let hadFailure = false;\n  let failureContext: string | null = null;\n\n  const tools: Record<string, unknown> = {};\n\n  for (const [name, skill] of Object.entries(skills)) {\n    tools[name] = {\n      description: skill.description,\n      parameters: skill.input,\n      execute: async (input: unknown) => {\n        if (debug) {\n          console.debug(`[juneau] skill \"${name}\" → executing, input:`, input);\n        }\n\n        const startMs = debug ? Date.now() : 0;\n\n        // Emit a \"running\" activity event into the buffer\n        activityBuffer.push(\n          formatActivityEvent({\n            type: 'activity',\n            id: name,\n            title: pickLabel(skill.labels.running, language),\n            status: 'running',\n            metadata: { skill: name },\n          })\n        );\n\n        try {\n          const result = await skill.execute(input as never);\n\n          const durationMs = debug ? Date.now() - startMs : 0;\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → done in ${durationMs}ms, result:`, result);\n          }\n\n          // Emit a \"done\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(skill.labels.done, language),\n              status: 'done',\n              metadata: { skill: name },\n            })\n          );\n\n          return result;\n        } catch (err) {\n          const durationMs = debug ? Date.now() - startMs : 0;\n          const message = err instanceof Error ? err.message : String(err);\n\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → FAILED in ${durationMs}ms: \"${message}\"`);\n          }\n\n          const failedLabels = skill.labels.failed ?? { cs: 'Nepodařilo se', en: 'Failed' };\n\n          // Emit a \"failed\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(failedLabels, language),\n              status: 'failed',\n              metadata: { skill: name },\n            })\n          );\n\n          hadFailure = true;\n          failureContext = `Tool \"${name}\" failed: ${message}`;\n\n          // Re-throw so ai-sdk knows the tool call failed\n          throw err;\n        }\n      },\n    };\n  }\n\n  return {\n    tools,\n\n    drainActivities(): string[] {\n      return activityBuffer.splice(0, activityBuffer.length);\n    },\n\n    get hadFailure() {\n      return hadFailure;\n    },\n\n    get failureContext() {\n      return failureContext;\n    },\n  };\n}\n","import type { SkillSet, StreamToWireOptions } from './types';\n\n// ai-sdk v7 chunk types that carry the model's text output.\n// - 'text-delta': standard streaming text (v6 + v7)\n// - 'text':       emitted by some v7 model/provider combos as a completed text chunk\n// Both may appear in the same stream; we handle either.\nconst TEXT_CHUNK_TYPES = new Set(['text-delta', 'text']);\n\n// Chunk types we recognise but intentionally ignore — activities are driven by\n// the SkillSet execute fn, not by these wire events.\nconst IGNORED_CHUNK_TYPES = new Set([\n  'tool-call',\n  'tool-result',\n  'tool-input-start',\n  'tool-input-delta',\n  'tool-input-available',\n  'tool-output-available',\n  'step-start',\n  'finish-step',\n  'start',\n  'finish',\n  'response-metadata',\n  'stream-start',\n]);\n\n/**\n * Converts ai-sdk's fullStream AsyncIterable into Juneau wire SSE strings.\n *\n * Handles:\n * - All text chunk types used by ai-sdk v7 (text-delta, text) incl. v6 textDelta fallback\n * - Flushing skillSet.drainActivities() before each text chunk so activities\n *   always appear before the text they precede\n * - A final drain after the loop ends (catches last-tool-call activities when\n *   no text follows the tool result — the Gemini silent-response scenario)\n * - Emitting the done event when the stream finishes\n * - Structured debug logging of every chunk when options.debug is true\n */\nexport async function* streamToWire(\n  fullStream: AsyncIterable<unknown>,\n  skillSet?: SkillSet,\n  options?: StreamToWireOptions\n): AsyncIterable<string> {\n  const debug = options?.debug ?? false;\n\n  for await (const chunk of fullStream) {\n    const c = chunk as Record<string, unknown>;\n    const type = c.type as string | undefined;\n\n    if (debug) {\n      if (type && TEXT_CHUNK_TYPES.has(type)) {\n        const text = (c.text ?? c.textDelta) as string | undefined;\n        console.debug(`[juneau] streamToWire chunk: ${type} ${JSON.stringify(text ?? '')}`);\n      } else if (type === 'tool-call') {\n        console.debug(`[juneau] streamToWire chunk: tool-call \"${c.toolName ?? c.name ?? '?'}\"`);\n      } else if (type === 'tool-result') {\n        console.debug(`[juneau] streamToWire chunk: tool-result (ignored)`);\n      } else if (type) {\n        if (IGNORED_CHUNK_TYPES.has(type)) {\n          console.debug(`[juneau] streamToWire chunk: ${type} (ignored)`);\n        } else {\n          console.debug(`[juneau] streamToWire chunk: ${type} (unknown)`);\n        }\n      }\n    }\n\n    if (type && TEXT_CHUNK_TYPES.has(type)) {\n      // Flush any buffered activity events before emitting text so the UI\n      // shows running/done indicators before the model's reply appears.\n      if (skillSet) {\n        const activities = skillSet.drainActivities();\n        if (debug && activities.length > 0) {\n          console.debug(`[juneau] streamToWire → draining ${activities.length} activities`);\n        }\n        for (const event of activities) {\n          yield event;\n        }\n      }\n\n      // ai-sdk v7 uses `text`, v6 used `textDelta` — support both\n      const text = (c.text ?? c.textDelta) as string | undefined;\n      if (text) {\n        if (debug) {\n          console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(text)}`);\n        }\n        yield `data: ${JSON.stringify({ type: 'text', text })}\\n\\n`;\n      }\n    }\n\n    // All other chunk types are intentionally silent — the SkillSet execute fn\n    // emits activity events into its buffer which we drain above.\n  }\n\n  // Final drain — catches activity events from the last tool call when no\n  // text-delta followed (Gemini sometimes calls a tool successfully but emits\n  // the reply text in a subsequent step that never arrives as text-delta here).\n  if (skillSet) {\n    const remaining = skillSet.drainActivities();\n    if (debug && remaining.length > 0) {\n      console.debug(`[juneau] streamToWire → draining ${remaining.length} activities (end of stream)`);\n    }\n    for (const event of remaining) {\n      yield event;\n    }\n  }\n\n  if (debug) {\n    console.debug('[juneau] streamToWire → end of stream, emitting done');\n  }\n\n  yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n}\n","import type { ToolRecoveryOptions } from './types';\nimport { streamToWire } from './streamToWire';\n\n/**\n * Encapsulates the two-phase streaming pattern needed for Gemini 2.5 Flash\n * tool call scenarios where the model either fails or silently succeeds without\n * emitting any text in the same stream pass.\n *\n * Phase 1: Stream with tools, maxSteps: 2 (or higher). Collect whether any\n *          text was produced and whether a tool failure occurred.\n *\n * Phase 2 triggers when a tool failed AND no text was produced:\n *   - Injects failureContext as an assistant message so the model is forced to\n *     write a recovery text response (no tools available in phase 2).\n *\n * Silent-success path (hadFailure=false, textProduced=false):\n *   - Gemini called the tool successfully but wrote nothing. This is a known\n *     Gemini 2.5 Flash behaviour when maxSteps > 1: the tool result and the\n *     model's reply text arrive as separate steps, and text-delta may not be\n *     emitted by the time phase 1's fullStream is exhausted. The debug logs\n *     will reveal the exact chunk sequence. In this state we still emit done\n *     cleanly — the consumer can decide whether to retry.\n *\n * @returns AsyncIterable<string> of Juneau wire SSE strings (activities + text + done)\n */\nexport async function* withToolRecovery(options: ToolRecoveryOptions): AsyncIterable<string> {\n  const { phase1, phase2, skillSet, debug = false } = options;\n\n  if (debug) {\n    console.debug('[juneau] withToolRecovery → phase 1 start');\n  }\n\n  let producedText = false;\n\n  const result1 = phase1();\n\n  for await (const chunk of streamToWire(result1.fullStream, skillSet, { debug })) {\n    // Track whether any text reached the wire (done event doesn't count)\n    if (chunk.includes('\"type\":\"text\"')) {\n      producedText = true;\n    }\n\n    // Hold back the done event — we may need to continue with phase 2\n    if (chunk.includes('\"type\":\"done\"')) {\n      continue;\n    }\n\n    yield chunk;\n  }\n\n  if (debug) {\n    console.debug(\n      `[juneau] withToolRecovery → phase 1 complete, textProduced=${producedText}, hadFailure=${skillSet.hadFailure}`\n    );\n  }\n\n  if (skillSet.hadFailure && !producedText && skillSet.failureContext) {\n    // Tool failed and model wrote nothing — run phase 2 to force a text response\n    if (debug) {\n      console.debug('[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2');\n    }\n\n    const result2 = phase2(skillSet.failureContext);\n\n    // Phase 2 has no skillSet — plain text response, no tool calls expected\n    yield* streamToWire(result2.fullStream, undefined, { debug });\n\n    if (debug) {\n      console.debug('[juneau] withToolRecovery → phase 2 complete');\n    }\n  } else if (!producedText && !skillSet.hadFailure) {\n    // Tool succeeded but model emitted no text — Gemini silent-response scenario.\n    // Log clearly so the consumer can see this in debug output and diagnose\n    // whether text arrived in a different chunk type or was simply not generated.\n    if (debug) {\n      console.debug(\n        '[juneau] withToolRecovery → no failure, no text — emitting done (possible Gemini silent response)'\n      );\n    }\n\n    yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n  } else {\n    // Normal success — text was produced, emit done\n    yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n  }\n}\n"],"names":["toSdkMessages","messages","mapped","msg","text","p","result","i","current","prev","formatActivityEvent","event","pickLabel","labels","language","createSkillSet","skills","options","debug","activityBuffer","hadFailure","failureContext","tools","name","skill","input","startMs","durationMs","err","message","failedLabels","TEXT_CHUNK_TYPES","IGNORED_CHUNK_TYPES","streamToWire","fullStream","skillSet","chunk","c","type","activities","remaining","withToolRecovery","phase1","phase2","producedText","result1","result2"],"mappings":"AAaO,SAASA,EAAcC,GAAsC;AAGlE,QAAMC,IAAwBD,EAAS,IAAI,CAAAE,MAAO;AAChD,UAAMC,IAAOD,EAAI,MACd,OAAO,OAAKE,EAAE,SAAS,MAAM,EAC7B,IAAI,CAAAA,MAAMA,EAAqC,IAAI,EACnD,KAAK,EAAE;AAEV,WAAO,EAAE,MAAMF,EAAI,MAA6B,SAASC,EAAA;AAAA,EAC3D,CAAC,GAIKE,IAAwB,CAAA;AAC9B,WAASC,IAAI,GAAGA,IAAIL,EAAO,QAAQK,KAAK;AACtC,UAAMC,IAAUN,EAAOK,CAAC,GAClBE,IAAOH,EAAOA,EAAO,SAAS,CAAC;AAErC,IAAIE,EAAQ,SAAS,UAAUC,GAAM,SAAS,UAC5CH,EAAO,KAAK,EAAE,MAAM,aAAa,SAAS,KAAK,GAGjDA,EAAO,KAAKE,CAAO;AAAA,EACrB;AAKA,SAAOF,EAAO,OAAO,CAAAH,MAAOA,EAAI,QAAQ,SAAS,CAAC;AACpD;ACtCA,SAASO,EAAoBC,GAAwC;AACnE,SAAO,SAAS,KAAK,UAAUA,CAAK,CAAC;AAAA;AAAA;AACvC;AAEA,SAASC,EAAUC,GAAoCC,GAA0B;AAC/E,SAAQD,EAAkCC,CAAQ,KAAKD,EAAO;AAChE;AAQO,SAASE,EAAeC,GAAkBC,IAA2B,IAAc;AACxF,QAAMH,IAAWG,EAAQ,YAAY,MAC/BC,IAAQD,EAAQ,SAAS,IACzBE,IAA2B,CAAA;AACjC,MAAIC,IAAa,IACbC,IAAgC;AAEpC,QAAMC,IAAiC,CAAA;AAEvC,aAAW,CAACC,GAAMC,CAAK,KAAK,OAAO,QAAQR,CAAM;AAC/C,IAAAM,EAAMC,CAAI,IAAI;AAAA,MACZ,aAAaC,EAAM;AAAA,MACnB,YAAYA,EAAM;AAAA,MAClB,SAAS,OAAOC,MAAmB;AACjC,QAAIP,KACF,QAAQ,MAAM,mBAAmBK,CAAI,yBAAyBE,CAAK;AAGrE,cAAMC,IAAUR,IAAQ,KAAK,IAAA,IAAQ;AAGrC,QAAAC,EAAe;AAAA,UACbT,EAAoB;AAAA,YAClB,MAAM;AAAA,YACN,IAAIa;AAAA,YACJ,OAAOX,EAAUY,EAAM,OAAO,SAASV,CAAQ;AAAA,YAC/C,QAAQ;AAAA,YACR,UAAU,EAAE,OAAOS,EAAA;AAAA,UAAK,CACzB;AAAA,QAAA;AAGH,YAAI;AACF,gBAAMjB,IAAS,MAAMkB,EAAM,QAAQC,CAAc,GAE3CE,IAAaT,IAAQ,KAAK,IAAA,IAAQQ,IAAU;AAClD,iBAAIR,KACF,QAAQ,MAAM,mBAAmBK,CAAI,eAAeI,CAAU,eAAerB,CAAM,GAIrFa,EAAe;AAAA,YACbT,EAAoB;AAAA,cAClB,MAAM;AAAA,cACN,IAAIa;AAAA,cACJ,OAAOX,EAAUY,EAAM,OAAO,MAAMV,CAAQ;AAAA,cAC5C,QAAQ;AAAA,cACR,UAAU,EAAE,OAAOS,EAAA;AAAA,YAAK,CACzB;AAAA,UAAA,GAGIjB;AAAA,QACT,SAASsB,GAAK;AACZ,gBAAMD,IAAaT,IAAQ,KAAK,IAAA,IAAQQ,IAAU,GAC5CG,IAAUD,aAAe,QAAQA,EAAI,UAAU,OAAOA,CAAG;AAE/D,UAAIV,KACF,QAAQ,MAAM,mBAAmBK,CAAI,iBAAiBI,CAAU,QAAQE,CAAO,GAAG;AAGpF,gBAAMC,IAAeN,EAAM,OAAO,UAAU,EAAE,IAAI,iBAAiB,IAAI,SAAA;AAGvE,gBAAAL,EAAe;AAAA,YACbT,EAAoB;AAAA,cAClB,MAAM;AAAA,cACN,IAAIa;AAAA,cACJ,OAAOX,EAAUkB,GAAchB,CAAQ;AAAA,cACvC,QAAQ;AAAA,cACR,UAAU,EAAE,OAAOS,EAAA;AAAA,YAAK,CACzB;AAAA,UAAA,GAGHH,IAAa,IACbC,IAAiB,SAASE,CAAI,aAAaM,CAAO,IAG5CD;AAAA,QACR;AAAA,MACF;AAAA,IAAA;AAIJ,SAAO;AAAA,IACL,OAAAN;AAAA,IAEA,kBAA4B;AAC1B,aAAOH,EAAe,OAAO,GAAGA,EAAe,MAAM;AAAA,IACvD;AAAA,IAEA,IAAI,aAAa;AACf,aAAOC;AAAA,IACT;AAAA,IAEA,IAAI,iBAAiB;AACnB,aAAOC;AAAA,IACT;AAAA,EAAA;AAEJ;AC9GA,MAAMU,IAAmB,oBAAI,IAAI,CAAC,cAAc,MAAM,CAAC,GAIjDC,wBAA0B,IAAI;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAcD,gBAAuBC,EACrBC,GACAC,GACAlB,GACuB;AACvB,QAAMC,IAAQD,GAAS,SAAS;AAEhC,mBAAiBmB,KAASF,GAAY;AACpC,UAAMG,IAAID,GACJE,IAAOD,EAAE;AAEf,QAAInB;AACF,UAAIoB,KAAQP,EAAiB,IAAIO,CAAI,GAAG;AACtC,cAAMlC,IAAQiC,EAAE,QAAQA,EAAE;AAC1B,gBAAQ,MAAM,gCAAgCC,CAAI,IAAI,KAAK,UAAUlC,KAAQ,EAAE,CAAC,EAAE;AAAA,MACpF,MAAA,CAAWkC,MAAS,cAClB,QAAQ,MAAM,2CAA2CD,EAAE,YAAYA,EAAE,QAAQ,GAAG,GAAG,IAC9EC,MAAS,gBAClB,QAAQ,MAAM,oDAAoD,IACzDA,MACLN,EAAoB,IAAIM,CAAI,IAC9B,QAAQ,MAAM,gCAAgCA,CAAI,YAAY,IAE9D,QAAQ,MAAM,gCAAgCA,CAAI,YAAY;AAKpE,QAAIA,KAAQP,EAAiB,IAAIO,CAAI,GAAG;AAGtC,UAAIH,GAAU;AACZ,cAAMI,IAAaJ,EAAS,gBAAA;AAC5B,QAAIjB,KAASqB,EAAW,SAAS,KAC/B,QAAQ,MAAM,oCAAoCA,EAAW,MAAM,aAAa;AAElF,mBAAW5B,KAAS4B;AAClB,gBAAM5B;AAAA,MAEV;AAGA,YAAMP,IAAQiC,EAAE,QAAQA,EAAE;AAC1B,MAAIjC,MACEc,KACF,QAAQ,MAAM,yCAAyC,KAAK,UAAUd,CAAI,CAAC,EAAE,GAE/E,MAAM,SAAS,KAAK,UAAU,EAAE,MAAM,QAAQ,MAAAA,GAAM,CAAC;AAAA;AAAA;AAAA,IAEzD;AAAA,EAIF;AAKA,MAAI+B,GAAU;AACZ,UAAMK,IAAYL,EAAS,gBAAA;AAC3B,IAAIjB,KAASsB,EAAU,SAAS,KAC9B,QAAQ,MAAM,oCAAoCA,EAAU,MAAM,6BAA6B;AAEjG,eAAW7B,KAAS6B;AAClB,YAAM7B;AAAA,EAEV;AAEA,EAAIO,KACF,QAAQ,MAAM,sDAAsD,GAGtE,MAAM,SAAS,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAAA;AAAA;AACjD;ACrFA,gBAAuBuB,EAAiBxB,GAAqD;AAC3F,QAAM,EAAE,QAAAyB,GAAQ,QAAAC,GAAQ,UAAAR,GAAU,OAAAjB,IAAQ,OAAUD;AAEpD,EAAIC,KACF,QAAQ,MAAM,2CAA2C;AAG3D,MAAI0B,IAAe;AAEnB,QAAMC,IAAUH,EAAA;AAEhB,mBAAiBN,KAASH,EAAaY,EAAQ,YAAYV,GAAU,EAAE,OAAAjB,EAAA,CAAO;AAO5E,IALIkB,EAAM,SAAS,eAAe,MAChCQ,IAAe,KAIb,CAAAR,EAAM,SAAS,eAAe,MAIlC,MAAMA;AASR,MANIlB,KACF,QAAQ;AAAA,IACN,8DAA8D0B,CAAY,gBAAgBT,EAAS,UAAU;AAAA,EAAA,GAI7GA,EAAS,cAAc,CAACS,KAAgBT,EAAS,gBAAgB;AAEnE,IAAIjB,KACF,QAAQ,MAAM,sFAAsF;AAGtG,UAAM4B,IAAUH,EAAOR,EAAS,cAAc;AAG9C,WAAOF,EAAaa,EAAQ,YAAY,QAAW,EAAE,OAAA5B,GAAO,GAExDA,KACF,QAAQ,MAAM,8CAA8C;AAAA,EAEhE,MAAA,CAAW,CAAC0B,KAAgB,CAACT,EAAS,cAIhCjB,KACF,QAAQ;AAAA,IACN;AAAA,EAAA,GAIJ,MAAM,SAAS,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAAA;AAAA,KAG/C,MAAM,SAAS,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAAA;AAAA;AAEnD;"}
+{"version":3,"file":"index.js","sources":["../../src/server/toSdkMessages.ts","../../src/server/createSkillSet.ts","../../src/server/streamToWire.ts","../../src/server/withToolRecovery.ts"],"sourcesContent":["import type { AiMessage } from '../core/types';\r\nimport type { CoreMessage } from './types';\r\n\r\n/**\r\n * Converts Juneau's AiMessage[] to the CoreMessage[] format expected by\r\n * ai-sdk's generateText / streamText.\r\n *\r\n * - Extracts plain text from parts (joins all type: \"text\" parts)\r\n * - Replaces activity-only assistant messages with an empty assistant turn\r\n *   so conversation alternation stays valid\r\n * - Injects a placeholder assistant turn between consecutive user messages\r\n * - Filters out empty turns (unless they are a required alternation filler)\r\n */\r\nexport function toSdkMessages(messages: AiMessage[]): CoreMessage[] {\r\n  // First pass: map each AiMessage to a CoreMessage, replacing activity-only\r\n  // assistant messages with an empty-text assistant turn.\r\n  const mapped: CoreMessage[] = messages.map(msg => {\r\n    const text = msg.parts\r\n      .filter(p => p.type === 'text')\r\n      .map(p => (p as { type: 'text'; text: string }).text)\r\n      .join('');\r\n\r\n    return { role: msg.role as CoreMessage['role'], content: text };\r\n  });\r\n\r\n  // Second pass: inject a placeholder assistant turn between consecutive user\r\n  // messages as a safety net for history bugs that would cause model errors.\r\n  const result: CoreMessage[] = [];\r\n  for (let i = 0; i < mapped.length; i++) {\r\n    const current = mapped[i];\r\n    const prev = result[result.length - 1];\r\n\r\n    if (current.role === 'user' && prev?.role === 'user') {\r\n      result.push({ role: 'assistant', content: '…' });\r\n    }\r\n\r\n    result.push(current);\r\n  }\r\n\r\n  // Third pass: filter out empty turns, but keep assistant placeholders that\r\n  // serve as alternation fillers (they have content '…' set above, so they\r\n  // won't be filtered). Only drop genuinely empty content strings.\r\n  return result.filter(msg => msg.content.length > 0);\r\n}\r\n","import type { ZodType } from 'zod';\nimport type { SkillDefinition, SkillSet, SkillSetOptions } from './types';\n\ntype SkillMap = Record<string, SkillDefinition<ZodType>>;\n\nfunction formatActivityEvent(event: Record<string, unknown>): string {\n  return `data: ${JSON.stringify(event)}\\n\\n`;\n}\n\nfunction pickLabel(labels: { cs: string; en: string }, language: string): string {\n  return (labels as Record<string, string>)[language] ?? labels.en;\n}\n\n/**\n * Takes a map of skill definitions and returns a SkillSet containing:\n * - tools: ready-made tool definitions for ai-sdk's streamText({ tools })\n * - drainActivities(): flush buffered activity wire SSE strings\n * - hadFailure / failureContext: for driving tool failure recovery\n */\nexport function createSkillSet(skills: SkillMap, options: SkillSetOptions = {}): SkillSet {\n  const language = options.language ?? 'en';\n  const debug = options.debug ?? false;\n  const activityBuffer: string[] = [];\n  let hadFailure = false;\n  let failureContext: string | null = null;\n\n  const tools: Record<string, unknown> = {};\n\n  for (const [name, skill] of Object.entries(skills)) {\n    tools[name] = {\n      description: skill.description,\n      parameters: skill.input,\n      execute: async (input: unknown) => {\n        if (debug) {\n          console.debug(`[juneau] skill \"${name}\" → executing, input:`, input);\n        }\n\n        const startMs = debug ? Date.now() : 0;\n\n        // Emit a \"running\" activity event into the buffer\n        activityBuffer.push(\n          formatActivityEvent({\n            type: 'activity',\n            id: name,\n            title: pickLabel(skill.labels.running, language),\n            status: 'running',\n            metadata: { skill: name },\n          })\n        );\n\n        try {\n          const result = await skill.execute(input as never);\n\n          const durationMs = debug ? Date.now() - startMs : 0;\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → done in ${durationMs}ms, result:`, result);\n          }\n\n          // Emit a \"done\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(skill.labels.done, language),\n              status: 'done',\n              metadata: { skill: name },\n            })\n          );\n\n          return result;\n        } catch (err) {\n          const durationMs = debug ? Date.now() - startMs : 0;\n          const message = err instanceof Error ? err.message : String(err);\n\n          if (debug) {\n            console.debug(`[juneau] skill \"${name}\" → FAILED in ${durationMs}ms: \"${message}\"`);\n          }\n\n          const failedLabels = skill.labels.failed ?? { cs: 'Nepodařilo se', en: 'Failed' };\n\n          // Emit a \"failed\" activity event\n          activityBuffer.push(\n            formatActivityEvent({\n              type: 'activity',\n              id: name,\n              title: pickLabel(failedLabels, language),\n              status: 'failed',\n              metadata: { skill: name },\n            })\n          );\n\n          hadFailure = true;\n          failureContext = `Tool \"${name}\" failed: ${message}`;\n\n          // Re-throw so ai-sdk knows the tool call failed\n          throw err;\n        }\n      },\n    };\n  }\n\n  return {\n    tools,\n\n    drainActivities(): string[] {\n      return activityBuffer.splice(0, activityBuffer.length);\n    },\n\n    get hadFailure() {\n      return hadFailure;\n    },\n\n    get failureContext() {\n      return failureContext;\n    },\n  };\n}\n","import type { SkillSet, StreamToWireOptions } from './types';\n\n// ai-sdk v7 chunk types that carry the model's text output.\n// - 'text-delta': standard streaming text (v6 + v7)\n// - 'text':       emitted by some v7 model/provider combos as a completed text chunk\n// Both may appear in the same stream; we handle either.\nconst TEXT_CHUNK_TYPES = new Set(['text-delta', 'text']);\n\n// Chunk types we recognise but intentionally ignore — activities are driven by\n// the SkillSet execute fn, not by these wire events.\nconst IGNORED_CHUNK_TYPES = new Set([\n  'tool-call',\n  'tool-result',\n  'tool-input-start',\n  'tool-input-delta',\n  'tool-input-available',\n  'tool-output-available',\n  'step-start',\n  'finish-step',\n  'start',\n  'finish',\n  'response-metadata',\n  'stream-start',\n]);\n\n/**\n * Converts ai-sdk's fullStream AsyncIterable into Juneau wire SSE strings.\n *\n * Handles:\n * - All text chunk types used by ai-sdk v7 (text-delta, text) incl. v6 textDelta fallback\n * - Flushing skillSet.drainActivities() before each text chunk so activities\n *   always appear before the text they precede\n * - A final drain after the loop ends (catches last-tool-call activities when\n *   no text follows the tool result — the Gemini silent-response scenario)\n * - Emitting the done event when the stream finishes\n * - Structured debug logging of every chunk when options.debug is true\n */\nexport async function* streamToWire(\n  fullStream: AsyncIterable<unknown>,\n  skillSet?: SkillSet,\n  options?: StreamToWireOptions\n): AsyncIterable<string> {\n  const debug = options?.debug ?? false;\n\n  for await (const chunk of fullStream) {\n    const c = chunk as Record<string, unknown>;\n    const type = c.type as string | undefined;\n\n    if (debug) {\n      if (type && TEXT_CHUNK_TYPES.has(type)) {\n        const text = (c.text ?? c.textDelta) as string | undefined;\n        console.debug(`[juneau] streamToWire chunk: ${type} ${JSON.stringify(text ?? '')}`);\n      } else if (type === 'tool-call') {\n        console.debug(`[juneau] streamToWire chunk: tool-call \"${c.toolName ?? c.name ?? '?'}\"`);\n      } else if (type === 'tool-result') {\n        console.debug(`[juneau] streamToWire chunk: tool-result (ignored)`);\n      } else if (type) {\n        if (IGNORED_CHUNK_TYPES.has(type)) {\n          console.debug(`[juneau] streamToWire chunk: ${type} (ignored)`);\n        } else {\n          console.debug(`[juneau] streamToWire chunk: ${type} (unknown)`);\n        }\n      }\n    }\n\n    if (type && TEXT_CHUNK_TYPES.has(type)) {\n      // Flush any buffered activity events before emitting text so the UI\n      // shows running/done indicators before the model's reply appears.\n      if (skillSet) {\n        const activities = skillSet.drainActivities();\n        if (debug && activities.length > 0) {\n          console.debug(`[juneau] streamToWire → draining ${activities.length} activities`);\n        }\n        for (const event of activities) {\n          yield event;\n        }\n      }\n\n      // ai-sdk v7 uses `text`, v6 used `textDelta` — support both\n      const text = (c.text ?? c.textDelta) as string | undefined;\n      if (text) {\n        if (debug) {\n          console.debug(`[juneau] streamToWire → yielding text ${JSON.stringify(text)}`);\n        }\n        yield `data: ${JSON.stringify({ type: 'text', text })}\\n\\n`;\n      }\n    }\n\n    // All other chunk types are intentionally silent — the SkillSet execute fn\n    // emits activity events into its buffer which we drain above.\n  }\n\n  // Final drain — catches activity events from the last tool call when no\n  // text-delta followed (Gemini sometimes calls a tool successfully but emits\n  // the reply text in a subsequent step that never arrives as text-delta here).\n  if (skillSet) {\n    const remaining = skillSet.drainActivities();\n    if (debug && remaining.length > 0) {\n      console.debug(`[juneau] streamToWire → draining ${remaining.length} activities (end of stream)`);\n    }\n    for (const event of remaining) {\n      yield event;\n    }\n  }\n\n  if (debug) {\n    console.debug('[juneau] streamToWire → end of stream, emitting done');\n  }\n\n  yield `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n}\n","import type { ToolRecoveryOptions } from './types';\nimport { streamToWire } from './streamToWire';\n\nfunction wireError(message: string): string {\n  return `data: ${JSON.stringify({ type: 'error', message })}\\n\\n`;\n}\n\nfunction wireDone(): string {\n  return `data: ${JSON.stringify({ type: 'done' })}\\n\\n`;\n}\n\n/**\n * Encapsulates the multi-phase streaming pattern needed for Gemini 2.5 Flash\n * tool call scenarios where the model either fails or silently succeeds without\n * emitting any text in the same stream pass.\n *\n * Phase 1: Stream with tools. Collect whether any text was produced and whether\n *          a tool failure occurred.\n *\n * Phase 2 (failure recovery) — triggers when a tool failed AND no text was produced:\n *   - Injects failureContext as an assistant message so the model is forced to\n *     write a recovery text response (no tools available in phase 2).\n *\n * Phase 3 (silent-success recovery) — triggers when the tool succeeded but the\n * model wrote no text. Confirmed Gemini 2.5 Flash behaviour: the fullStream ends\n * with tool-call → tool-result → finish-step → finish and no text-delta ever\n * arrives — Gemini treats the tool call as its complete response. Phase 3 receives\n * the full phase 1 message history including tool-call AND tool-result turns —\n * Gemini rejects histories where a tool-call turn is not immediately followed by\n * a tool-result turn (\"function call turn must come immediately after a user turn\n * or after a function response turn\"). The history is resolved from the consumed\n * phase 1 result's `messages` promise (ai-sdk v7 — resolves to all turns after\n * the stream is consumed), with `response.messages` as fallback.\n * If phase3 is not provided, falls back to emitting done (previous behaviour).\n *\n * Errors thrown by phase 2 / phase 3 model calls are surfaced as wire error\n * events — never swallowed into a silent done.\n *\n * @returns AsyncIterable<string> of Juneau wire SSE strings (activities + text + done)\n */\nexport async function* withToolRecovery(options: ToolRecoveryOptions): AsyncIterable<string> {\n  const { phase1, phase2, phase3, skillSet, debug = false } = options;\n\n  if (debug) {\n    console.debug('[juneau] withToolRecovery → phase 1 start');\n  }\n\n  let producedText = false;\n\n  const result1 = phase1();\n\n  for await (const chunk of streamToWire(result1.fullStream, skillSet, { debug })) {\n    // Track whether any text reached the wire (done event doesn't count)\n    if (chunk.includes('\"type\":\"text\"')) {\n      producedText = true;\n    }\n\n    // Hold back the done event — we may need to continue with phase 2 or 3\n    if (chunk.includes('\"type\":\"done\"')) {\n      continue;\n    }\n\n    yield chunk;\n  }\n\n  if (debug) {\n    console.debug(\n      `[juneau] withToolRecovery → phase 1 complete, textProduced=${producedText}, hadFailure=${skillSet.hadFailure}`\n    );\n  }\n\n  if (skillSet.hadFailure && !producedText && skillSet.failureContext) {\n    // Tool failed and model wrote nothing — run phase 2 to force a text response\n    if (debug) {\n      console.debug('[juneau] withToolRecovery → hadFailure=true, textProduced=false → triggering phase 2');\n    }\n\n    try {\n      const result2 = phase2(skillSet.failureContext);\n\n      // Phase 2 has no skillSet — plain text response, no tool calls expected\n      yield* streamToWire(result2.fullStream, undefined, { debug });\n\n      if (debug) {\n        console.debug('[juneau] withToolRecovery → phase 2 complete');\n      }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      if (debug) {\n        console.debug(`[juneau] withToolRecovery → phase 2 FAILED: \"${message}\"`);\n      }\n      yield wireError(message);\n    }\n    return;\n  }\n\n  if (!producedText && !skillSet.hadFailure && phase3) {\n    // Tool succeeded but model emitted no text — Gemini silent-response scenario.\n    // Resolve the full message history from the consumed phase 1 result and let\n    // phase 3 call the model again (no tools) to summarise the tool result.\n    const fullMessages = await resolvePhase1Messages(result1);\n\n    if (fullMessages) {\n      if (debug) {\n        console.debug(\n          `[juneau] withToolRecovery → phase 3 messages resolved (${fullMessages.length}):`,\n          JSON.stringify(fullMessages, null, 2)\n        );\n        if (!containsToolResult(fullMessages)) {\n          console.debug(\n            '[juneau] withToolRecovery → WARNING: resolved history contains no tool-result turn — Gemini will likely reject it as an invalid conversation structure'\n          );\n        }\n        console.debug('[juneau] withToolRecovery → no failure, no text → triggering phase 3');\n      }\n\n      try {\n        yield* streamToWire(phase3(fullMessages).fullStream, undefined, { debug });\n\n        if (debug) {\n          console.debug('[juneau] withToolRecovery → phase 3 complete');\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        if (debug) {\n          console.debug(`[juneau] withToolRecovery → phase 3 FAILED: \"${message}\"`);\n        }\n        yield wireError(message);\n      }\n      return;\n    }\n\n    if (debug) {\n      console.debug(\n        '[juneau] withToolRecovery → phase 3 configured but phase 1 result exposes no message history — emitting done'\n      );\n    }\n  } else if (!producedText && !skillSet.hadFailure && debug) {\n    console.debug(\n      '[juneau] withToolRecovery → no failure, no text, no phase3 — emitting done (Gemini silent response)'\n    );\n  }\n\n  yield wireDone();\n}\n\n/**\n * Resolves the full message history (incl. tool-call/tool-result turns) from a\n * consumed ai-sdk StreamTextResult.\n *\n * ai-sdk v7: `result.messages` is the promise that resolves to ALL turns —\n * user, assistant(tool-call), tool(tool-result) — after the stream is consumed.\n * `result.response.messages` may resolve to an incomplete subset (observed:\n * tool-call turn without the following tool-result turn, which Gemini rejects),\n * so it is only used as a fallback when `messages` is unavailable.\n *\n * Both promises resolve only after the fullStream has been fully consumed,\n * which is guaranteed at the call site.\n */\nasync function resolvePhase1Messages(result: {\n  messages?: Promise<unknown[]>;\n  response?: Promise<{ messages?: unknown[] }>;\n}): Promise<unknown[] | null> {\n  if (result.messages) {\n    const messages = await result.messages;\n    if (Array.isArray(messages) && messages.length > 0) {\n      return messages;\n    }\n  }\n\n  if (result.response) {\n    const response = await result.response;\n    if (Array.isArray(response?.messages) && response.messages.length > 0) {\n      return response.messages;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Checks whether the resolved history contains a tool-result turn — either as\n * a `role: 'tool'` message or a content part with `type: 'tool-result'`.\n * Used only for the debug warning; the messages themselves are passed through opaquely.\n */\nfunction containsToolResult(messages: unknown[]): boolean {\n  return messages.some((m) => {\n    const msg = m as { role?: string; content?: unknown };\n    if (msg.role === 'tool') return true;\n    if (Array.isArray(msg.content)) {\n      return msg.content.some(\n        (part) => (part as { type?: string }).type === 'tool-result'\n      );\n    }\n    return false;\n  });\n}\n"],"names":["toSdkMessages","messages","mapped","msg","text","p","result","i","current","prev","formatActivityEvent","event","pickLabel","labels","language","createSkillSet","skills","options","debug","activityBuffer","hadFailure","failureContext","tools","name","skill","input","startMs","durationMs","err","message","failedLabels","TEXT_CHUNK_TYPES","IGNORED_CHUNK_TYPES","streamToWire","fullStream","skillSet","chunk","c","type","activities","remaining","wireError","wireDone","withToolRecovery","phase1","phase2","phase3","producedText","result1","result2","fullMessages","resolvePhase1Messages","containsToolResult","response","m","part"],"mappings":"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"}

package/dist/server/types.d.ts

@@ -49,11 +49,41 @@ export interface SkillSetOptions {
     /** Emit structured console.debug logs for each skill execution. Default: false */
     debug?: boolean;
 }
+/**
+ * Structural match for ai-sdk v7's StreamTextResult — only the members
+ * withToolRecovery needs. Juneau does not import ai-sdk; passing the result
+ * of streamText() satisfies this shape.
+ */
+export interface ToolRecoveryStreamResult {
+    fullStream: AsyncIterable<unknown>;
+    /**
+     * ai-sdk v7: resolves after the stream is consumed to the FULL message
+     * history — user, assistant(tool-call), and tool(tool-result) turns.
+     * Preferred source for phase 3; Gemini rejects histories where a tool-call
+     * turn is not followed by its tool-result turn.
+     */
+    messages?: Promise<unknown[]>;
+    /**
+     * Fallback only — may resolve to an incomplete subset of the history
+     * (observed: missing tool-result turns). Used when `messages` is unavailable.
+     */
+    response?: Promise<{
+        messages?: unknown[];
+    }>;
+}
 export interface ToolRecoveryOptions {
-    phase1: () => {
+    phase1: () => ToolRecoveryStreamResult;
+    phase2: (failureContext: string) => {
         fullStream: AsyncIterable<unknown>;
     };
-    phase2: (failureContext: string) => {
+    /**
+     * Silent-success recovery — called when a tool succeeded but the model wrote
+     * no text (observed with Gemini 2.5 Flash, which treats the tool call as its
+     * complete response). Receives the full phase 1 message history including
+     * tool-call and tool-result turns; call the model again without tools so it
+     * is forced to summarise the tool result as text.
+     */
+    phase3?: (messages: unknown[]) => {
         fullStream: AsyncIterable<unknown>;
     };
     skillSet: SkillSet;

package/dist/server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,OAAO,GAAG,OAAO;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,IAAI,EAAK;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;KACrC,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM;QAAE,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IACrD,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK;QAAE,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3E,QAAQ,EAAE,QAAQ,CAAC;IACnB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,OAAO,GAAG,OAAO;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,IAAI,EAAK;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACpC,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;KACrC,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,wBAAwB,CAAC;IACvC,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK;QAAE,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3E;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK;QAAE,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IACzE,QAAQ,EAAE,QAAQ,CAAC;IACnB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/server/withToolRecovery.d.ts

@@ -1,23 +1,30 @@
 import type { ToolRecoveryOptions } from './types';
 /**
- * Encapsulates the two-phase streaming pattern needed for Gemini 2.5 Flash
+ * Encapsulates the multi-phase streaming pattern needed for Gemini 2.5 Flash
  * tool call scenarios where the model either fails or silently succeeds without
  * emitting any text in the same stream pass.
  *
- * Phase 1: Stream with tools, maxSteps: 2 (or higher). Collect whether any
- *          text was produced and whether a tool failure occurred.
+ * Phase 1: Stream with tools. Collect whether any text was produced and whether
+ *          a tool failure occurred.
  *
- * Phase 2 triggers when a tool failed AND no text was produced:
+ * Phase 2 (failure recovery) — triggers when a tool failed AND no text was produced:
  *   - Injects failureContext as an assistant message so the model is forced to
  *     write a recovery text response (no tools available in phase 2).
  *
- * Silent-success path (hadFailure=false, textProduced=false):
- *   - Gemini called the tool successfully but wrote nothing. This is a known
- *     Gemini 2.5 Flash behaviour when maxSteps > 1: the tool result and the
- *     model's reply text arrive as separate steps, and text-delta may not be
- *     emitted by the time phase 1's fullStream is exhausted. The debug logs
- *     will reveal the exact chunk sequence. In this state we still emit done
- *     cleanly — the consumer can decide whether to retry.
+ * Phase 3 (silent-success recovery) — triggers when the tool succeeded but the
+ * model wrote no text. Confirmed Gemini 2.5 Flash behaviour: the fullStream ends
+ * with tool-call → tool-result → finish-step → finish and no text-delta ever
+ * arrives — Gemini treats the tool call as its complete response. Phase 3 receives
+ * the full phase 1 message history including tool-call AND tool-result turns —
+ * Gemini rejects histories where a tool-call turn is not immediately followed by
+ * a tool-result turn ("function call turn must come immediately after a user turn
+ * or after a function response turn"). The history is resolved from the consumed
+ * phase 1 result's `messages` promise (ai-sdk v7 — resolves to all turns after
+ * the stream is consumed), with `response.messages` as fallback.
+ * If phase3 is not provided, falls back to emitting done (previous behaviour).
+ *
+ * Errors thrown by phase 2 / phase 3 model calls are surfaced as wire error
+ * events — never swallowed into a silent done.
  *
  * @returns AsyncIterable<string> of Juneau wire SSE strings (activities + text + done)
  */

package/dist/server/withToolRecovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withToolRecovery.d.ts","sourceRoot":"","sources":["../../src/server/withToolRecovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAuB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CA4D3F"}
+{"version":3,"file":"withToolRecovery.d.ts","sourceRoot":"","sources":["../../src/server/withToolRecovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAWnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAuB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAwG3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juneau",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Open-source React/TypeScript library for AI chat UI components",
   "type": "module",
   "main": "./dist/index.cjs",