@waniwani/sdk 0.3.0 → 0.3.1-beta.1

package/dist/mcp/index.d.ts

@@ -417,29 +417,46 @@ type WidgetSignal = {
 type MaybePromise<T> = T | Promise<T>;
 /**
  * Typed interrupt function — available on the node context.
- * The `field` parameter is typed as `keyof TState`, and `validate` receives
- * the field's value typed from the Zod schema.
+ *
+ * First argument: an object where each key is a state field name and each value
+ * describes the question for that field. `validate` receives the field's value
+ * typed from the Zod schema.
+ *
+ * Second argument (optional): config with overall hidden AI instructions.
+ *
+ * @example
+ * ```ts
+ * // Single question
+ * interrupt({ breed: { question: "What breed is your pet?" } })
+ *
+ * // Multiple questions with context
+ * interrupt(
+ *   {
+ *     breed: {
+ *       question: "What breed?",
+ *       validate: async (breed) => {
+ *         const result = await lookupBreed(breed);
+ *         if (!result) throw new Error("Unknown breed");
+ *         return { breedId: result.id };
+ *       },
+ *     },
+ *     age: { question: "How old is your pet?" },
+ *   },
+ *   { context: "Ask both questions naturally." },
+ * )
+ * ```
  */
-type TypedInterrupt<TState> = {
-    /** Single question — field and validate are typed from the state schema */
-    <F extends Extract<keyof TState, string>>(config: {
+type TypedInterrupt<TState> = (fields: {
+    [F in Extract<keyof TState, string>]?: {
         question: string;
-        field: F;
         validate?: (value: TState[F]) => MaybePromise<Partial<TState> | void>;
         suggestions?: string[];
         context?: string;
-    }): InterruptSignal;
-    /** Multiple questions asked together in one conversational message */
-    (config: {
-        questions: Array<{
-            question: string;
-            field: Extract<keyof TState, string>;
-            suggestions?: string[];
-            context?: string;
-        }>;
-        context?: string;
-    }): InterruptSignal;
-};
+    };
+}, config?: {
+    /** Overall hidden context/instructions for the assistant (not shown to user directly) */
+    context?: string;
+}) => InterruptSignal;
 /**
  * Typed showWidget function — available on the node context.
  * The `field` parameter is typed as `keyof TState`.

package/dist/mcp/index.js

@@ -1,6 +1,6 @@
-function B(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function Te(){return B()==="openai"}function ke(){return B()==="mcp-apps"}var S="__start__",x="__end__",q=Symbol.for("waniwani.flow.interrupt"),X=Symbol.for("waniwani.flow.widget");function Z(e){if("questions"in e)return{__type:q,questions:e.questions,context:e.context};let{question:t,field:n,context:r,suggestions:o,validate:a}=e;return{__type:q,questions:[{question:t,field:n,context:r,suggestions:o,validate:a}]}}function G(e,t){return{__type:X,tool:e,...t}}function Q(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===q}function ee(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===X}import{z as C}from"zod";import{deflateSync as ve,inflateSync as Se}from"zlib";function P(e){let t=JSON.stringify(e);return ve(t).toString("base64")}function te(e){try{let t=Buffer.from(e,"base64"),n=Se(t).toString("utf-8");return JSON.parse(n)}catch{return null}}function xe(e){let t=e.description??"",n=e._zod?.def;if(n?.type==="enum"&&n.entries){let r=Object.keys(n.entries).map(o=>`"${o}"`).join(" | ");return t?`${r} \u2014 ${t}`:r}return t}function Ee(e){let t=["","## FLOW EXECUTION PROTOCOL","","This tool implements a multi-step conversational flow. Follow this protocol exactly:","",'1. Call with `action: "start"` to begin. If the user\'s message already',"   contains answers to likely questions, extract them into `stateUpdates`","   as `{ field: value }` pairs. The engine will auto-skip steps whose","   fields are already filled.","   Only extract values the user explicitly stated \u2014 do NOT guess or invent values."];if(e.state){let n=Object.entries(e.state).map(([r,o])=>{let a=xe(o);return a?`\`${r}\` (${a})`:`\`${r}\``}).join(", ");t.push(`   Known fields: ${n}.`)}return t.push("2. The response JSON `status` field tells you what to do next:",'   - `"interrupt"`: Pause and ask the user. Two forms:',"     a. Single question: `{ question, field, context? }` \u2014 ask `question`, store answer in `field`.","     b. Multi-question: `{ questions: [{question, field}, ...], context? }` \u2014 ask ALL questions","        in one conversational message, collect all answers.","     `context` (if present) is hidden AI instructions \u2014 use to shape your response, do NOT show verbatim.","     Then call again with:",'     `action: "continue"`, `flowToken` = the `flowToken` from the response (pass back exactly as received),',"     `stateUpdates` = answers keyed by their `field` names, plus any other fields the user mentioned.",'   - `"widget"`: The flow wants to show a UI widget. Call the tool named in the `tool`',"     field, passing the `data` object as the tool's input.","     If the response includes `interactive: false`, the widget is display-only:","     call the display tool, show the widget, then immediately call THIS flow tool again with",'     `action: "continue"` and the same `flowToken`. In that case, do NOT wait for the user',"     to click or use the widget, and do NOT ask them to interact with it unless the","     description explicitly says otherwise.","     Otherwise, present the widget result to the user. When the user makes a choice or interacts","     with the widget, call THIS flow tool again with:",'     `action: "continue"`, `flowToken` = the `flowToken` from the response,',"     `stateUpdates` = `{ [field]: <user's selection> }` plus any other fields the user mentioned.",'   - `"complete"`: The flow is done. Present the result to the user.','   - `"error"`: Something went wrong. Show the `error` message.',"","3. ALWAYS pass back the `flowToken` string exactly as received \u2014 it is an opaque token, do not modify it.","4. Do NOT invent state values. Only use `stateUpdates` for information the user explicitly provided.","5. Include only the fields the user actually answered in `stateUpdates` \u2014 do NOT guess missing ones.","   If the user did not answer all pending questions, the engine will re-prompt for the remaining ones.","   If the user mentioned values for other known fields, include those too \u2014","   they will be applied immediately and those steps will be auto-skipped."),t.join(`
-`)}function Re(e){if(e.flowToken){let t=te(e.flowToken);if(t)return t}return{step:void 0,state:{}}}async function _(e,t){return e.type==="direct"?e.to:e.condition(t)}function $(e){return e!=null&&e!==""}function L(e,t,n,r){if(e.every(d=>$(r[d.field])))return null;let o=e.filter(d=>!$(r[d.field])),a=o.length===1,i=o[0];return{content:a&&i?{status:"interrupt",question:i.question,field:i.field,...i.suggestions?{suggestions:i.suggestions}:{},...i.context||t?{context:i.context??t}:{}}:{status:"interrupt",questions:o,...t?{context:t}:{}},flowTokenContent:{step:n,state:r,...a&&i?{field:i.field}:{},questions:e,...t?{interruptContext:t}:{}}}}async function j(e,t,n,r,o,a){let i=e,s={...t},d=50,u=0;for(;u++<d;){if(i===x)return{content:{status:"complete"},flowTokenContent:{state:s}};let l=n.get(i);if(!l)return{content:{status:"error",error:`Unknown node: "${i}"`}};try{let c=await l({state:s,meta:a,interrupt:Z,showWidget:G});if(Q(c)){for(let f of c.questions)f.validate&&o.set(`${i}:${f.field}`,f.validate);let p=L(c.questions,c.context,i,s);if(p)return p;let m=r.get(i);if(!m)return{content:{status:"error",error:`No outgoing edge from node "${i}"`}};i=await _(m,s);continue}if(ee(c)){let p=c.field;if(p&&$(s[p])){let m=r.get(i);if(!m)return{content:{status:"error",error:`No outgoing edge from node "${i}"`}};i=await _(m,s);continue}return{content:{status:"widget",tool:c.tool.id,data:c.data,description:c.description,...c.interactive===!1?{interactive:!1}:{}},flowTokenContent:{step:i,state:s,field:p,widgetId:c.tool.id}}}s={...s,...c};let g=r.get(i);if(!g)return{content:{status:"error",error:`No outgoing edge from node "${i}"`}};i=await _(g,s)}catch(h){return{content:{status:"error",error:h instanceof Error?h.message:String(h)},flowTokenContent:{step:i,state:s}}}}return{content:{status:"error",error:"Flow exceeded maximum iterations (possible infinite loop)"}}}var Ie={action:C.enum(["start","continue"]).describe('"start" to begin the flow, "continue" to resume after a pause (interrupt or widget)'),stateUpdates:C.record(C.string(),C.unknown()).optional().describe("State field values to set before processing the next node. Use this to pass the user's answer (keyed by the field name from the response) and any other values the user mentioned."),flowToken:C.string().optional().describe("Opaque flow token from the previous response. Pass back exactly as received.")};function ne(e){let{config:t,nodes:n,edges:r}=e,o=Ee(t),a=`${t.description}
-${o}`,i=new Map;async function s(d,u){let l=Re(d),h=l.state;if(d.action==="start"){let c=r.get(S);if(!c)return{content:{status:"error",error:"No start edge"}};let g={...h,...d.stateUpdates??{}},p=await _(c,g);return j(p,g,n,r,i,u)}if(d.action==="continue"){let c=l.step;if(!c)return{content:{status:"error",error:'Missing or invalid "flowToken" for continue action. Pass back the flowToken from the previous response exactly as received.'}};let g={...h,...d.stateUpdates??{}};if(l.questions){let p=L(l.questions,l.interruptContext,c,g);if(p)return p;let m=l.questions.map(f=>({field:f.field,fn:i.get(`${c}:${f.field}`)})).filter(f=>f.fn!=null);for(let{field:f,fn:E}of m)try{let T=g[f],v=await E(T);v&&typeof v=="object"&&(g={...g,...v})}catch(T){let v=T instanceof Error?T.message:String(T);delete g[f];let ye=l.questions.map(b=>b.field===f?{...b,context:b.context?`ERROR: ${v}
+function B(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function Te(){return B()==="openai"}function ke(){return B()==="mcp-apps"}var S="__start__",x="__end__",J=Symbol.for("waniwani.flow.interrupt"),X=Symbol.for("waniwani.flow.widget");function Z(e,t){let n=t?.context,r=[];for(let[i,s]of Object.entries(e))if(typeof s=="object"&&s!==null&&"question"in s){let o=s;r.push({question:o.question,field:i,suggestions:o.suggestions,context:o.context,validate:o.validate})}return{__type:J,questions:r,context:n}}function G(e,t){return{__type:X,tool:e,...t}}function Q(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===J}function ee(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===X}import{z as C}from"zod";import{deflateSync as ve,inflateSync as Se}from"zlib";function P(e){let t=JSON.stringify(e);return ve(t).toString("base64")}function te(e){try{let t=Buffer.from(e,"base64"),n=Se(t).toString("utf-8");return JSON.parse(n)}catch{return null}}function xe(e){let t=e.description??"",n=e._zod?.def;if(n?.type==="enum"&&n.entries){let r=Object.keys(n.entries).map(i=>`"${i}"`).join(" | ");return t?`${r} \u2014 ${t}`:r}return t}function Ee(e){let t=["","## FLOW EXECUTION PROTOCOL","","This tool implements a multi-step conversational flow. Follow this protocol exactly:","",'1. Call with `action: "start"` to begin. If the user\'s message already',"   contains answers to likely questions, extract them into `stateUpdates`","   as `{ field: value }` pairs. The engine will auto-skip steps whose","   fields are already filled.","   Only extract values the user explicitly stated \u2014 do NOT guess or invent values."];if(e.state){let n=Object.entries(e.state).map(([r,i])=>{let s=xe(i);return s?`\`${r}\` (${s})`:`\`${r}\``}).join(", ");t.push(`   Known fields: ${n}.`)}return t.push("2. The response JSON `status` field tells you what to do next:",'   - `"interrupt"`: Pause and ask the user. Two forms:',"     a. Single question: `{ question, field, context? }` \u2014 ask `question`, store answer in `field`.","     b. Multi-question: `{ questions: [{question, field}, ...], context? }` \u2014 ask ALL questions","        in one conversational message, collect all answers.","     `context` (if present) is hidden AI instructions \u2014 use to shape your response, do NOT show verbatim.","     Then call again with:",'     `action: "continue"`, `flowToken` = the `flowToken` from the response (pass back exactly as received),',"     `stateUpdates` = answers keyed by their `field` names, plus any other fields the user mentioned.",'   - `"widget"`: The flow wants to show a UI widget. Call the tool named in the `tool`',"     field, passing the `data` object as the tool's input.","     If the response includes `interactive: false`, the widget is display-only:","     call the display tool, show the widget, then immediately call THIS flow tool again with",'     `action: "continue"` and the same `flowToken`. In that case, do NOT wait for the user',"     to click or use the widget, and do NOT ask them to interact with it unless the","     description explicitly says otherwise.","     Otherwise, present the widget result to the user. When the user makes a choice or interacts","     with the widget, call THIS flow tool again with:",'     `action: "continue"`, `flowToken` = the `flowToken` from the response,',"     `stateUpdates` = `{ [field]: <user's selection> }` plus any other fields the user mentioned.",'   - `"complete"`: The flow is done. Present the result to the user.','   - `"error"`: Something went wrong. Show the `error` message.',"","3. ALWAYS pass back the `flowToken` string exactly as received \u2014 it is an opaque token, do not modify it.","4. Do NOT invent state values. Only use `stateUpdates` for information the user explicitly provided.","5. Include only the fields the user actually answered in `stateUpdates` \u2014 do NOT guess missing ones.","   If the user did not answer all pending questions, the engine will re-prompt for the remaining ones.","   If the user mentioned values for other known fields, include those too \u2014","   they will be applied immediately and those steps will be auto-skipped."),t.join(`
+`)}function Re(e){if(e.flowToken){let t=te(e.flowToken);if(t)return t}return{step:void 0,state:{}}}async function _(e,t){return e.type==="direct"?e.to:e.condition(t)}function j(e){return e!=null&&e!==""}function $(e,t,n,r){if(e.every(d=>j(r[d.field])))return null;let i=e.filter(d=>!j(r[d.field])),s=i.length===1,o=i[0];return{content:s&&o?{status:"interrupt",question:o.question,field:o.field,...o.suggestions?{suggestions:o.suggestions}:{},...o.context||t?{context:o.context??t}:{}}:{status:"interrupt",questions:i,...t?{context:t}:{}},flowTokenContent:{step:n,state:r,...s&&o?{field:o.field}:{},questions:e,...t?{interruptContext:t}:{}}}}async function q(e,t,n,r,i,s){let o=e,a={...t},d=50,u=0;for(;u++<d;){if(o===x)return{content:{status:"complete"},flowTokenContent:{state:a}};let l=n.get(o);if(!l)return{content:{status:"error",error:`Unknown node: "${o}"`}};try{let c=await l({state:a,meta:s,interrupt:Z,showWidget:G});if(Q(c)){for(let f of c.questions)f.validate&&i.set(`${o}:${f.field}`,f.validate);let p=$(c.questions,c.context,o,a);if(p)return p;let m=r.get(o);if(!m)return{content:{status:"error",error:`No outgoing edge from node "${o}"`}};o=await _(m,a);continue}if(ee(c)){let p=c.field;if(p&&j(a[p])){let m=r.get(o);if(!m)return{content:{status:"error",error:`No outgoing edge from node "${o}"`}};o=await _(m,a);continue}return{content:{status:"widget",tool:c.tool.id,data:c.data,description:c.description,...c.interactive===!1?{interactive:!1}:{}},flowTokenContent:{step:o,state:a,field:p,widgetId:c.tool.id}}}a={...a,...c};let g=r.get(o);if(!g)return{content:{status:"error",error:`No outgoing edge from node "${o}"`}};o=await _(g,a)}catch(h){return{content:{status:"error",error:h instanceof Error?h.message:String(h)},flowTokenContent:{step:o,state:a}}}}return{content:{status:"error",error:"Flow exceeded maximum iterations (possible infinite loop)"}}}var Ie={action:C.enum(["start","continue"]).describe('"start" to begin the flow, "continue" to resume after a pause (interrupt or widget)'),stateUpdates:C.record(C.string(),C.unknown()).optional().describe("State field values to set before processing the next node. Use this to pass the user's answer (keyed by the field name from the response) and any other values the user mentioned."),flowToken:C.string().optional().describe("Opaque flow token from the previous response. Pass back exactly as received.")};function ne(e){let{config:t,nodes:n,edges:r}=e,i=Ee(t),s=`${t.description}
+${i}`,o=new Map;async function a(d,u){let l=Re(d),h=l.state;if(d.action==="start"){let c=r.get(S);if(!c)return{content:{status:"error",error:"No start edge"}};let g={...h,...d.stateUpdates??{}},p=await _(c,g);return q(p,g,n,r,o,u)}if(d.action==="continue"){let c=l.step;if(!c)return{content:{status:"error",error:'Missing or invalid "flowToken" for continue action. Pass back the flowToken from the previous response exactly as received.'}};let g={...h,...d.stateUpdates??{}};if(l.questions){let p=$(l.questions,l.interruptContext,c,g);if(p)return p;let m=l.questions.map(f=>({field:f.field,fn:o.get(`${c}:${f.field}`)})).filter(f=>f.fn!=null);for(let{field:f,fn:E}of m)try{let T=g[f],v=await E(T);v&&typeof v=="object"&&(g={...g,...v})}catch(T){let v=T instanceof Error?T.message:String(T);delete g[f];let ye=l.questions.map(b=>b.field===f?{...b,context:b.context?`ERROR: ${v}
 
-${b.context}`:`ERROR: ${v}`}:b),J=L(ye,l.interruptContext,c,g);if(J)return J;break}}if(l.questions||l.widgetId){let p=r.get(c);if(!p)return{content:{status:"error",error:`No edge from step "${c}"`}};let m=await _(p,g);return j(m,g,n,r,i,u)}return j(c,g,n,r,i,u)}return{content:{status:"error",error:`Unknown action: "${d.action}"`}}}return{id:t.id,title:t.title,description:a,async register(d){d.registerTool(t.id,{title:t.title,description:a,inputSchema:Ie,annotations:t.annotations},(async(u,l)=>{let c=l._meta??{},g=await s(u,c),p=g.flowTokenContent?P(g.flowTokenContent):void 0,m={...g.content,...p?{flowToken:p}:{}};return{content:[{type:"text",text:JSON.stringify(m,null,2)}],_meta:c,...g.content.status==="error"?{isError:!0}:{}}}))}}}var R=class{nodes=new Map;edges=new Map;config;constructor(t){this.config=t}addNode(t,n){if(t===S||t===x)throw new Error(`"${t}" is a reserved name and cannot be used as a node name`);if(this.nodes.has(t))throw new Error(`Node "${t}" already exists`);return this.nodes.set(t,n),this}addEdge(t,n){if(this.edges.has(t))throw new Error(`Node "${t}" already has an outgoing edge. Use addConditionalEdge for branching.`);return this.edges.set(t,{type:"direct",to:n}),this}addConditionalEdge(t,n){if(this.edges.has(t))throw new Error(`Node "${t}" already has an outgoing edge.`);return this.edges.set(t,{type:"conditional",condition:n}),this}compile(){return this.validate(),ne({config:this.config,nodes:new Map(this.nodes),edges:new Map(this.edges)})}validate(){if(!this.edges.has(S))throw new Error('Flow must have an entry point. Add an edge from START: .addEdge(START, "first_node")');let t=this.edges.get(S);if(t?.type==="direct"&&t.to!==x&&!this.nodes.has(t.to))throw new Error(`START edge references non-existent node: "${t.to}"`);for(let[n,r]of this.edges){if(n!==S&&!this.nodes.has(n))throw new Error(`Edge from non-existent node: "${n}"`);if(r.type==="direct"&&r.to!==x&&!this.nodes.has(r.to))throw new Error(`Edge from "${n}" references non-existent node: "${r.to}"`)}for(let[n]of this.nodes)if(!this.edges.has(n))throw new Error(`Node "${n}" has no outgoing edge. Add one with .addEdge("${n}", ...) or .addConditionalEdge("${n}", ...)`)}};function re(e){return new R(e)}var W="text/html+skybridge",F="text/html;profile=mcp-app",oe=async(e,t)=>{let n=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${n}${t}`)).text()};function ie(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function se(e){let t=e.widgetCSP?{connectDomains:e.widgetCSP.connect_domains,resourceDomains:e.widgetCSP.resource_domains,frameDomains:e.widgetCSP.frame_domains,redirectDomains:e.widgetCSP.redirect_domains}:void 0;return{ui:{...t&&{csp:t},...e.widgetDomain&&{domain:e.widgetDomain},...e.prefersBorder!==void 0&&{prefersBorder:e.prefersBorder}}}}function V(e){return{...e.openaiTemplateUri&&{"openai/outputTemplate":e.openaiTemplateUri},"openai/toolInvocation/invoking":e.invoking,"openai/toolInvocation/invoked":e.invoked,"openai/widgetAccessible":!0,"openai/resultCanProduceWidget":!0,...e.mcpTemplateUri&&{ui:{resourceUri:e.mcpTemplateUri,...e.autoHeight&&{autoHeight:!0}}}}}function ae(e){let{id:t,title:n,description:r,baseUrl:o,htmlPath:a,widgetDomain:i,prefersBorder:s=!0,autoHeight:d=!0}=e,u=e.widgetCSP??{connect_domains:[o],resource_domains:[o]};if(process.env.NODE_ENV==="development")try{let{hostname:f}=new URL(o);(f==="localhost"||f==="127.0.0.1")&&(u={...u,connect_domains:[...u.connect_domains||[],`ws://${f}:*`,`wss://${f}:*`],resource_domains:[...u.resource_domains||[],`http://${f}:*`]})}catch{}let l=`ui://widgets/apps-sdk/${t}.html`,h=`ui://widgets/ext-apps/${t}.html`,c=null,g=()=>(c||(c=oe(o,a)),c),p=r;async function m(f){let E=await g();f.registerResource(`${t}-openai-widget`,l,{title:n,description:p,mimeType:W,_meta:{"openai/widgetDescription":p,"openai/widgetPrefersBorder":s}},async T=>({contents:[{uri:T.href,mimeType:W,text:E,_meta:ie({description:p,prefersBorder:s,widgetDomain:i,widgetCSP:u})}]})),f.registerResource(`${t}-mcp-widget`,h,{title:n,description:p,mimeType:F,_meta:{ui:{prefersBorder:s}}},async T=>({contents:[{uri:T.href,mimeType:F,text:E,_meta:se({description:p,prefersBorder:s,widgetCSP:u})}]}))}return{id:t,title:n,description:r,openaiUri:l,mcpUri:h,autoHeight:d,register:m}}function be(e,t){let{resource:n,description:r,inputSchema:o,annotations:a,autoInjectResultText:i=!0}=e,s=e.id??n?.id,d=e.title??n?.title;if(!s)throw new Error("createTool: `id` is required when no resource is provided");if(!d)throw new Error("createTool: `title` is required when no resource is provided");let u=n?V({openaiTemplateUri:n.openaiUri,mcpTemplateUri:n.mcpUri,invoking:e.invoking??"Loading...",invoked:e.invoked??"Loaded",autoHeight:n.autoHeight}):void 0;return{id:s,title:d,description:r,async register(l){l.registerTool(s,{title:d,description:r,inputSchema:o,annotations:a,...u&&{_meta:u}},(async(h,c)=>{let p=c._meta??{},m=await t(h,{extra:{_meta:p}});return n&&m.data?{content:[{type:"text",text:m.text}],structuredContent:m.data,_meta:{...u,...p,...i===!1?{"waniwani/autoInjectResultText":!1}:{}}}:{content:[{type:"text",text:m.text}],...m.data?{structuredContent:m.data}:{},...i===!1?{_meta:{"waniwani/autoInjectResultText":!1}}:{}}}))}}}async function Ce(e,t){await Promise.all(t.map(n=>n.register(e)))}var A=class extends Error{constructor(n,r){super(n);this.status=r;this.name="WaniWaniError"}};var _e="@waniwani/sdk";function ce(e){let{baseUrl:t,apiKey:n}=e;function r(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}async function o(a,i,s){let d=r(),u=`${t.replace(/\/$/,"")}${i}`,l={Authorization:`Bearer ${d}`,"X-WaniWani-SDK":_e},h={method:a,headers:l};s!==void 0&&(l["Content-Type"]="application/json",h.body=JSON.stringify(s));let c=await fetch(u,h);if(!c.ok){let p=await c.text().catch(()=>"");throw new A(p||`KB API error: HTTP ${c.status}`,c.status)}return(await c.json()).data}return{async ingest(a){return o("POST","/api/mcp/kb/ingest",{files:a})},async search(a,i){return o("POST","/api/mcp/kb/search",{query:a,...i})},async sources(){return o("GET","/api/mcp/kb/sources")}}}var Me="@waniwani/sdk";function D(e,t={}){let n=t.now??(()=>new Date),r=t.generateId??de,o=Fe(e),a=U(e.meta),i=U(e.metadata),s=Ae(e,a),d=k(e.eventId)??r(),u=Ue(e.timestamp,n),l=k(e.source)??t.source??Me,h=H(e)?{...e}:void 0,c={...i};return Object.keys(a).length>0&&(c.meta=a),h&&(c.rawLegacy=h),{id:d,type:"mcp.event",name:o,source:l,timestamp:u,correlation:s,properties:Pe(e,o),metadata:c,rawLegacy:h}}function de(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?`evt_${crypto.randomUUID()}`:`evt_${Math.random().toString(36).slice(2,10)}_${Date.now().toString(36)}`}function Pe(e,t){if(!H(e))return U(e.properties);let n=We(e,t),r=U(e.properties);return{...n,...r}}function We(e,t){switch(t){case"tool.called":{let n={};return k(e.toolName)&&(n.name=e.toolName),k(e.toolType)&&(n.type=e.toolType),n}case"quote.succeeded":{let n={};return typeof e.quoteAmount=="number"&&(n.amount=e.quoteAmount),k(e.quoteCurrency)&&(n.currency=e.quoteCurrency),n}case"link.clicked":{let n={};return k(e.linkUrl)&&(n.url=e.linkUrl),n}case"purchase.completed":{let n={};return typeof e.purchaseAmount=="number"&&(n.amount=e.purchaseAmount),k(e.purchaseCurrency)&&(n.currency=e.purchaseCurrency),n}default:return{}}}function Fe(e){return H(e)?e.eventType:e.event}function Ae(e,t){let n=k(e.requestId)??M(t,["openai/requestId","requestId","mcp/requestId"]),r=k(e.sessionId)??M(t,["openai/sessionId","sessionId","conversationId","anthropic/sessionId"]),o=k(e.traceId)??M(t,["openai/traceId","traceId","mcp/traceId","openai/requestId","requestId"]),a=k(e.externalUserId)??M(t,["openai/userId","externalUserId","userId","actorId"]),i=k(e.correlationId)??M(t,["correlationId","openai/requestId"])??n,s={};return r&&(s.sessionId=r),o&&(s.traceId=o),n&&(s.requestId=n),i&&(s.correlationId=i),a&&(s.externalUserId=a),s}function Ue(e,t){if(e instanceof Date)return e.toISOString();if(typeof e=="string"){let n=new Date(e);if(!Number.isNaN(n.getTime()))return n.toISOString()}return t().toISOString()}function M(e,t){for(let n of t){let r=e[n];if(typeof r=="string"&&r.trim().length>0)return r}}function U(e){return!e||typeof e!="object"||Array.isArray(e)?{}:e}function k(e){if(typeof e=="string"&&e.trim().length!==0)return e}function H(e){return"eventType"in e}var De="/api/mcp/events/v2/batch";var ue="@waniwani/sdk",Ne=new Set([401,403]),Oe=new Set([408,425,429,500,502,503,504]);function le(e){return new K(e)}var K=class{endpointUrl;flushIntervalMs;maxBatchSize;maxBufferSize;maxRetries;retryBaseDelayMs;retryMaxDelayMs;shutdownTimeoutMs;sdkVersion;fetchFn;logger;now;sleep;apiKey;buffer=[];flushTimer;flushScheduled=!1;flushScheduledTimer;flushInFlight;inFlightCount=0;isStopped=!1;isShuttingDown=!1;constructor(t){this.endpointUrl=je(t.baseUrl,t.endpointPath??De),this.flushIntervalMs=t.flushIntervalMs??1e3,this.maxBatchSize=t.maxBatchSize??20,this.maxBufferSize=t.maxBufferSize??1e3,this.maxRetries=t.maxRetries??3,this.retryBaseDelayMs=t.retryBaseDelayMs??200,this.retryMaxDelayMs=t.retryMaxDelayMs??2e3,this.shutdownTimeoutMs=t.shutdownTimeoutMs??2e3,this.fetchFn=t.fetchFn??fetch,this.logger=t.logger??console,this.now=t.now??(()=>new Date),this.sleep=t.sleep??(n=>new Promise(r=>setTimeout(r,n))),this.apiKey=t.apiKey,this.sdkVersion=t.sdkVersion,this.flushIntervalMs>0&&(this.flushTimer=setInterval(()=>{this.flush()},this.flushIntervalMs))}enqueue(t){if(this.isStopped||this.isShuttingDown){this.logger.warn("[WaniWani] Tracking transport is stopped, dropping event %s",t.id);return}if(this.buffer.length>=this.maxBufferSize){let n=this.buffer.length-this.maxBufferSize+1;this.buffer.splice(0,n),this.logger.warn("[WaniWani] Tracking buffer overflow, dropped %d oldest event(s)",n)}if(this.buffer.push(t),this.buffer.length>=this.maxBatchSize){this.flush();return}this.scheduleMicroFlush()}pendingEvents(){return this.buffer.length+this.inFlightCount}async flush(){return this.flushInFlight?this.flushInFlight:(this.flushInFlight=this.flushLoop().finally(()=>{this.flushInFlight=void 0}),this.flushInFlight)}async shutdown(t){this.isShuttingDown=!0,this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=void 0),this.flushScheduledTimer&&(clearTimeout(this.flushScheduledTimer),this.flushScheduledTimer=void 0,this.flushScheduled=!1);let n=t?.timeoutMs??this.shutdownTimeoutMs,r=this.flush();if(!Number.isFinite(n)||n<=0)return await r,this.isStopped=!0,{timedOut:!1,pendingEvents:this.pendingEvents()};let o=Symbol("shutdown-timeout");return await Promise.race([r.then(()=>"flushed"),this.sleep(n).then(()=>o)])===o?(this.isStopped=!0,{timedOut:!0,pendingEvents:this.pendingEvents()}):(this.isStopped=!0,{timedOut:!1,pendingEvents:this.pendingEvents()})}scheduleMicroFlush(){this.flushScheduled||(this.flushScheduled=!0,this.flushScheduledTimer=setTimeout(()=>{this.flushScheduledTimer=void 0,this.flushScheduled=!1,this.flush()},0))}async flushLoop(){for(;this.buffer.length>0&&!this.isStopped;){let t=this.buffer.splice(0,this.maxBatchSize);await this.sendBatchWithRetry(t)}}async sendBatchWithRetry(t){let n=0,r=t;for(;r.length>0&&!this.isStopped;){this.inFlightCount=r.length;let o=await this.sendBatchOnce(r);switch(this.inFlightCount=0,o.kind){case"success":return;case"auth":this.stopTransportForAuthFailure(o.status,r.length);return;case"permanent":this.logger.error("[WaniWani] Dropping %d event(s) after permanent failure: %s",r.length,o.reason);return;case"retryable":if(n>=this.maxRetries){this.logger.error("[WaniWani] Dropping %d event(s) after retry exhaustion: %s",r.length,o.reason);return}await this.sleep(this.backoffDelayMs(n)),n+=1;continue;case"partial":if(o.permanent.length>0&&this.logger.error("[WaniWani] Dropping %d event(s) rejected as permanent",o.permanent.length),o.retryable.length===0)return;if(n>=this.maxRetries){this.logger.error("[WaniWani] Dropping %d retryable event(s) after retry exhaustion",o.retryable.length);return}r=o.retryable,await this.sleep(this.backoffDelayMs(n)),n+=1;continue}}}async sendBatchOnce(t){let n;try{n=await this.fetchFn(this.endpointUrl,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,"X-WaniWani-SDK":ue},body:JSON.stringify(this.makeBatchRequest(t))})}catch(a){return{kind:"retryable",reason:$e(a)}}if(Ne.has(n.status))return{kind:"auth",status:n.status};if(Oe.has(n.status))return{kind:"retryable",reason:`HTTP ${n.status}`};if(!n.ok)return{kind:"permanent",reason:`HTTP ${n.status}`};let r=await qe(n);if(!r?.rejected||r.rejected.length===0)return{kind:"success"};let o=this.classifyRejectedEvents(t,r.rejected);return o.retryable.length===0&&o.permanent.length===0?{kind:"success"}:{kind:"partial",retryable:o.retryable,permanent:o.permanent}}makeBatchRequest(t){return{sentAt:this.now().toISOString(),source:{sdk:ue,version:this.sdkVersion??"0.0.0"},events:t}}classifyRejectedEvents(t,n){let r=new Map(t.map(i=>[i.id,i])),o=[],a=[];for(let i of n){let s=r.get(i.eventId);if(s){if(Be(i)){o.push(s);continue}a.push(s)}}return{retryable:o,permanent:a}}backoffDelayMs(t){let n=this.retryBaseDelayMs*2**t;return Math.min(n,this.retryMaxDelayMs)}stopTransportForAuthFailure(t,n){this.isStopped=!0;let r=this.buffer.length;this.buffer.splice(0,r),this.logger.error("[WaniWani] Auth failure (HTTP %d). Stopping tracking transport and dropping %d queued event(s)",t,n+r)}};function Be(e){if(e.retryable===!0)return!0;let t=e.code.toLowerCase();return t.includes("timeout")||t.includes("temporary")||t.includes("unavailable")||t.includes("rate_limit")||t.includes("transient")||t.includes("server")}async function qe(e){let t=await e.text();if(t)try{return JSON.parse(t)}catch{return}}function je(e,t){let n=e.endsWith("/")?e:`${e}/`,r=t.startsWith("/")?t.slice(1):t;return`${n}${r}`}function $e(e){return e instanceof Error?e.message:String(e)}function pe(e){let{baseUrl:t,apiKey:n,tracking:r}=e;function o(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}let a=n?le({baseUrl:t,apiKey:n,endpointPath:r.endpointPath,flushIntervalMs:r.flushIntervalMs,maxBatchSize:r.maxBatchSize,maxBufferSize:r.maxBufferSize,maxRetries:r.maxRetries,retryBaseDelayMs:r.retryBaseDelayMs,retryMaxDelayMs:r.retryMaxDelayMs,shutdownTimeoutMs:r.shutdownTimeoutMs}):void 0,i={async identify(s,d){o();let u=D({event:"user.identified",externalUserId:s,properties:d});return a?.enqueue(u),{eventId:u.id}},async track(s){o();let d=D(s);return a?.enqueue(d),{eventId:d.id}},async flush(){o(),await a?.flush()},async shutdown(s){return o(),await a?.shutdown({timeoutMs:s?.timeoutMs??r.shutdownTimeoutMs})??{timedOut:!1,pendingEvents:0}}};return a&&Le(i,r.shutdownTimeoutMs),i}function Le(e,t){if(typeof process>"u"||typeof process.once!="function"||typeof process.on!="function")return;let n=()=>{e.shutdown({timeoutMs:t})};process.once("beforeExit",n),process.once("SIGINT",n),process.once("SIGTERM",n)}function N(e){let t=e?.baseUrl??"https://app.waniwani.ai",n=e?.apiKey??process.env.WANIWANI_API_KEY,r={endpointPath:e?.tracking?.endpointPath??"/api/mcp/events/v2/batch",flushIntervalMs:e?.tracking?.flushIntervalMs??1e3,maxBatchSize:e?.tracking?.maxBatchSize??20,maxBufferSize:e?.tracking?.maxBufferSize??1e3,maxRetries:e?.tracking?.maxRetries??3,retryBaseDelayMs:e?.tracking?.retryBaseDelayMs??200,retryMaxDelayMs:e?.tracking?.retryMaxDelayMs??2e3,shutdownTimeoutMs:e?.tracking?.shutdownTimeoutMs??2e3},o={baseUrl:t,apiKey:n,tracking:r},a=pe(o),i=ce(o);return{...a,kb:i,_config:o}}function Ve(e){let t=e.event_type??"widget_click",r=t.startsWith("widget_")?t:`widget_${t}`,o={...e.metadata??{}};return e.event_name&&(o.event_name=e.event_name),{event:r,properties:o,sessionId:e.session_id,traceId:e.trace_id,externalUserId:e.user_id,eventId:e.event_id,timestamp:e.timestamp,source:e.source??"widget"}}function He(e){let t={apiKey:e?.apiKey,baseUrl:e?.baseUrl},n;function r(){return n||(n=N(t)),n}return async function(a){let i;try{i=await a.json()}catch{return new Response(JSON.stringify({error:"Invalid JSON"}),{status:400,headers:{"Content-Type":"application/json"}})}if(!Array.isArray(i.events)||i.events.length===0)return new Response(JSON.stringify({error:"Missing or empty events array"}),{status:400,headers:{"Content-Type":"application/json"}});try{let s=r(),d=[];for(let u of i.events){let l=Ve(u),h=await s.track(l);d.push(h.eventId)}return await s.flush(),new Response(JSON.stringify({ok:!0,accepted:d.length}),{status:200,headers:{"Content-Type":"application/json"}})}catch(s){let d=s instanceof Error?s.message:"Unknown error";return new Response(JSON.stringify({error:d}),{status:500,headers:{"Content-Type":"application/json"}})}}}var O=class{cached=null;pending=null;config;constructor(t){this.config=t}async getToken(t,n){return this.cached&&Date.now()<this.cached.expiresAt-12e4?this.cached.token:this.pending?this.pending:(this.pending=this.mint(t,n).finally(()=>{this.pending=null}),this.pending)}async mint(t,n){let r=Ke(this.config.baseUrl,"/api/mcp/widget-tokens"),o={};t&&(o.sessionId=t),n&&(o.traceId=n);try{let a=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(o)});if(!a.ok)return null;let i=await a.json(),s=i.data&&typeof i.data=="object"?i.data:i,d=new Date(s.expiresAt).getTime();return!s.token||Number.isNaN(d)?null:(this.cached={token:s.token,expiresAt:d},s.token)}catch{return null}}};function Ke(e,t){return`${e.endsWith("/")?e.slice(0,-1):e}${t}`}var fe="https://app.waniwani.ai";function ze(e,t={}){let n=e;if(n.__waniwaniWrapped)return n;n.__waniwaniWrapped=!0;let r=t.client??N(t.config),o=t.injectWidgetToken!==!1,a=null;function i(){if(a)return a;let d=r._config.apiKey;return d?(a=new O({baseUrl:r._config.baseUrl??fe,apiKey:d}),a):null}let s=e.registerTool.bind(e);return n.registerTool=((...d)=>{let[u,l,h]=d,c=typeof u=="string"&&u.trim().length>0?u:"unknown";if(typeof h!="function")return s(...d);let g=h;return s(u,l,async(m,f)=>{let E=performance.now();try{let T=await g(m,f),v=Math.round(performance.now()-E);return await he(r,ge(c,f,t,{durationMs:v,status:"ok"}),t.onError),t.flushAfterToolCall&&await me(r,t.onError),o&&await Ye(T,i(),r._config.baseUrl??fe,t.onError),Xe(T,f),T}catch(T){let v=Math.round(performance.now()-E);throw await he(r,ge(c,f,t,{durationMs:v,status:"error",errorMessage:T instanceof Error?T.message:String(T)}),t.onError),t.flushAfterToolCall&&await me(r,t.onError),T}})}),n}async function Ye(e,t,n,r){if(!I(e))return;I(e._meta)||(e._meta={});let o=e._meta,a={endpoint:`${n.replace(/\/$/,"")}/api/mcp/events/v2/batch`};if(t)try{let i=await t.getToken();i&&(a.token=i)}catch(i){r?.(Y(i))}o.waniwani=a}function ge(e,t,n,r){let o=Je(e,n.toolType),a=we(t);return{event:"tool.called",properties:{name:e,type:o,...r??{}},meta:a,metadata:{source:"withWaniwani",...n.metadata??{}}}}function Je(e,t){return typeof t=="function"?t(e)??"other":t??"other"}function we(e){if(!I(e))return;let t=e._meta;if(I(t))return t}function I(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}async function he(e,t,n){try{await e.track(t)}catch(r){n?.(Y(r))}}async function me(e,t){try{await e.flush()}catch(n){t?.(Y(n))}}function Y(e){return e instanceof Error?e:new Error(String(e))}var z="waniwani/userLocation";function Xe(e,t){let n=we(t);if(!n)return;let r=n[z];if(!r||!I(e))return;I(e._meta)||(e._meta={});let o=e._meta;o[z]||(o[z]=r)}export{x as END,S as START,R as StateGraph,re as createFlow,ae as createResource,be as createTool,He as createTrackingRoute,B as detectPlatform,P as encodeFlowToken,ke as isMCPApps,Te as isOpenAI,Ce as registerTools,ze as withWaniwani};
+${b.context}`:`ERROR: ${v}`}:b),Y=$(ye,l.interruptContext,c,g);if(Y)return Y;break}}if(l.questions||l.widgetId){let p=r.get(c);if(!p)return{content:{status:"error",error:`No edge from step "${c}"`}};let m=await _(p,g);return q(m,g,n,r,o,u)}return q(c,g,n,r,o,u)}return{content:{status:"error",error:`Unknown action: "${d.action}"`}}}return{id:t.id,title:t.title,description:s,async register(d){d.registerTool(t.id,{title:t.title,description:s,inputSchema:Ie,annotations:t.annotations},(async(u,l)=>{let c=l._meta??{},g=await a(u,c),p=g.flowTokenContent?P(g.flowTokenContent):void 0,m={...g.content,...p?{flowToken:p}:{}};return{content:[{type:"text",text:JSON.stringify(m,null,2)}],_meta:c,...g.content.status==="error"?{isError:!0}:{}}}))}}}var R=class{nodes=new Map;edges=new Map;config;constructor(t){this.config=t}addNode(t,n){if(t===S||t===x)throw new Error(`"${t}" is a reserved name and cannot be used as a node name`);if(this.nodes.has(t))throw new Error(`Node "${t}" already exists`);return this.nodes.set(t,n),this}addEdge(t,n){if(this.edges.has(t))throw new Error(`Node "${t}" already has an outgoing edge. Use addConditionalEdge for branching.`);return this.edges.set(t,{type:"direct",to:n}),this}addConditionalEdge(t,n){if(this.edges.has(t))throw new Error(`Node "${t}" already has an outgoing edge.`);return this.edges.set(t,{type:"conditional",condition:n}),this}compile(){return this.validate(),ne({config:this.config,nodes:new Map(this.nodes),edges:new Map(this.edges)})}validate(){if(!this.edges.has(S))throw new Error('Flow must have an entry point. Add an edge from START: .addEdge(START, "first_node")');let t=this.edges.get(S);if(t?.type==="direct"&&t.to!==x&&!this.nodes.has(t.to))throw new Error(`START edge references non-existent node: "${t.to}"`);for(let[n,r]of this.edges){if(n!==S&&!this.nodes.has(n))throw new Error(`Edge from non-existent node: "${n}"`);if(r.type==="direct"&&r.to!==x&&!this.nodes.has(r.to))throw new Error(`Edge from "${n}" references non-existent node: "${r.to}"`)}for(let[n]of this.nodes)if(!this.edges.has(n))throw new Error(`Node "${n}" has no outgoing edge. Add one with .addEdge("${n}", ...) or .addConditionalEdge("${n}", ...)`)}};function re(e){return new R(e)}var W="text/html+skybridge",F="text/html;profile=mcp-app",oe=async(e,t)=>{let n=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${n}${t}`)).text()};function ie(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function se(e){let t=e.widgetCSP?{connectDomains:e.widgetCSP.connect_domains,resourceDomains:e.widgetCSP.resource_domains,frameDomains:e.widgetCSP.frame_domains,redirectDomains:e.widgetCSP.redirect_domains}:void 0;return{ui:{...t&&{csp:t},...e.widgetDomain&&{domain:e.widgetDomain},...e.prefersBorder!==void 0&&{prefersBorder:e.prefersBorder}}}}function L(e){return{...e.openaiTemplateUri&&{"openai/outputTemplate":e.openaiTemplateUri},"openai/toolInvocation/invoking":e.invoking,"openai/toolInvocation/invoked":e.invoked,"openai/widgetAccessible":!0,"openai/resultCanProduceWidget":!0,...e.mcpTemplateUri&&{ui:{resourceUri:e.mcpTemplateUri,...e.autoHeight&&{autoHeight:!0}}}}}function ae(e){let{id:t,title:n,description:r,baseUrl:i,htmlPath:s,widgetDomain:o,prefersBorder:a=!0,autoHeight:d=!0}=e,u=e.widgetCSP??{connect_domains:[i],resource_domains:[i]};if(process.env.NODE_ENV==="development")try{let{hostname:f}=new URL(i);(f==="localhost"||f==="127.0.0.1")&&(u={...u,connect_domains:[...u.connect_domains||[],`ws://${f}:*`,`wss://${f}:*`],resource_domains:[...u.resource_domains||[],`http://${f}:*`]})}catch{}let l=`ui://widgets/apps-sdk/${t}.html`,h=`ui://widgets/ext-apps/${t}.html`,c=null,g=()=>(c||(c=oe(i,s)),c),p=r;async function m(f){let E=await g();f.registerResource(`${t}-openai-widget`,l,{title:n,description:p,mimeType:W,_meta:{"openai/widgetDescription":p,"openai/widgetPrefersBorder":a}},async T=>({contents:[{uri:T.href,mimeType:W,text:E,_meta:ie({description:p,prefersBorder:a,widgetDomain:o,widgetCSP:u})}]})),f.registerResource(`${t}-mcp-widget`,h,{title:n,description:p,mimeType:F,_meta:{ui:{prefersBorder:a}}},async T=>({contents:[{uri:T.href,mimeType:F,text:E,_meta:se({description:p,prefersBorder:a,widgetCSP:u})}]}))}return{id:t,title:n,description:r,openaiUri:l,mcpUri:h,autoHeight:d,register:m}}function be(e,t){let{resource:n,description:r,inputSchema:i,annotations:s,autoInjectResultText:o=!0}=e,a=e.id??n?.id,d=e.title??n?.title;if(!a)throw new Error("createTool: `id` is required when no resource is provided");if(!d)throw new Error("createTool: `title` is required when no resource is provided");let u=n?L({openaiTemplateUri:n.openaiUri,mcpTemplateUri:n.mcpUri,invoking:e.invoking??"Loading...",invoked:e.invoked??"Loaded",autoHeight:n.autoHeight}):void 0;return{id:a,title:d,description:r,async register(l){l.registerTool(a,{title:d,description:r,inputSchema:i,annotations:s,...u&&{_meta:u}},(async(h,c)=>{let p=c._meta??{},m=await t(h,{extra:{_meta:p}});return n&&m.data?{content:[{type:"text",text:m.text}],structuredContent:m.data,_meta:{...u,...p,...o===!1?{"waniwani/autoInjectResultText":!1}:{}}}:{content:[{type:"text",text:m.text}],...m.data?{structuredContent:m.data}:{},...o===!1?{_meta:{"waniwani/autoInjectResultText":!1}}:{}}}))}}}async function Ce(e,t){await Promise.all(t.map(n=>n.register(e)))}var A=class extends Error{constructor(n,r){super(n);this.status=r;this.name="WaniWaniError"}};var _e="@waniwani/sdk";function ce(e){let{baseUrl:t,apiKey:n}=e;function r(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}async function i(s,o,a){let d=r(),u=`${t.replace(/\/$/,"")}${o}`,l={Authorization:`Bearer ${d}`,"X-WaniWani-SDK":_e},h={method:s,headers:l};a!==void 0&&(l["Content-Type"]="application/json",h.body=JSON.stringify(a));let c=await fetch(u,h);if(!c.ok){let p=await c.text().catch(()=>"");throw new A(p||`KB API error: HTTP ${c.status}`,c.status)}return(await c.json()).data}return{async ingest(s){return i("POST","/api/mcp/kb/ingest",{files:s})},async search(s,o){return i("POST","/api/mcp/kb/search",{query:s,...o})},async sources(){return i("GET","/api/mcp/kb/sources")}}}var Me="@waniwani/sdk";function D(e,t={}){let n=t.now??(()=>new Date),r=t.generateId??de,i=Fe(e),s=U(e.meta),o=U(e.metadata),a=Ae(e,s),d=k(e.eventId)??r(),u=Ue(e.timestamp,n),l=k(e.source)??t.source??Me,h=V(e)?{...e}:void 0,c={...o};return Object.keys(s).length>0&&(c.meta=s),h&&(c.rawLegacy=h),{id:d,type:"mcp.event",name:i,source:l,timestamp:u,correlation:a,properties:Pe(e,i),metadata:c,rawLegacy:h}}function de(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?`evt_${crypto.randomUUID()}`:`evt_${Math.random().toString(36).slice(2,10)}_${Date.now().toString(36)}`}function Pe(e,t){if(!V(e))return U(e.properties);let n=We(e,t),r=U(e.properties);return{...n,...r}}function We(e,t){switch(t){case"tool.called":{let n={};return k(e.toolName)&&(n.name=e.toolName),k(e.toolType)&&(n.type=e.toolType),n}case"quote.succeeded":{let n={};return typeof e.quoteAmount=="number"&&(n.amount=e.quoteAmount),k(e.quoteCurrency)&&(n.currency=e.quoteCurrency),n}case"link.clicked":{let n={};return k(e.linkUrl)&&(n.url=e.linkUrl),n}case"purchase.completed":{let n={};return typeof e.purchaseAmount=="number"&&(n.amount=e.purchaseAmount),k(e.purchaseCurrency)&&(n.currency=e.purchaseCurrency),n}default:return{}}}function Fe(e){return V(e)?e.eventType:e.event}function Ae(e,t){let n=k(e.requestId)??M(t,["openai/requestId","requestId","mcp/requestId"]),r=k(e.sessionId)??M(t,["openai/sessionId","sessionId","conversationId","anthropic/sessionId"]),i=k(e.traceId)??M(t,["openai/traceId","traceId","mcp/traceId","openai/requestId","requestId"]),s=k(e.externalUserId)??M(t,["openai/userId","externalUserId","userId","actorId"]),o=k(e.correlationId)??M(t,["correlationId","openai/requestId"])??n,a={};return r&&(a.sessionId=r),i&&(a.traceId=i),n&&(a.requestId=n),o&&(a.correlationId=o),s&&(a.externalUserId=s),a}function Ue(e,t){if(e instanceof Date)return e.toISOString();if(typeof e=="string"){let n=new Date(e);if(!Number.isNaN(n.getTime()))return n.toISOString()}return t().toISOString()}function M(e,t){for(let n of t){let r=e[n];if(typeof r=="string"&&r.trim().length>0)return r}}function U(e){return!e||typeof e!="object"||Array.isArray(e)?{}:e}function k(e){if(typeof e=="string"&&e.trim().length!==0)return e}function V(e){return"eventType"in e}var De="/api/mcp/events/v2/batch";var ue="@waniwani/sdk",Ne=new Set([401,403]),Oe=new Set([408,425,429,500,502,503,504]);function le(e){return new H(e)}var H=class{endpointUrl;flushIntervalMs;maxBatchSize;maxBufferSize;maxRetries;retryBaseDelayMs;retryMaxDelayMs;shutdownTimeoutMs;sdkVersion;fetchFn;logger;now;sleep;apiKey;buffer=[];flushTimer;flushScheduled=!1;flushScheduledTimer;flushInFlight;inFlightCount=0;isStopped=!1;isShuttingDown=!1;constructor(t){this.endpointUrl=je(t.baseUrl,t.endpointPath??De),this.flushIntervalMs=t.flushIntervalMs??1e3,this.maxBatchSize=t.maxBatchSize??20,this.maxBufferSize=t.maxBufferSize??1e3,this.maxRetries=t.maxRetries??3,this.retryBaseDelayMs=t.retryBaseDelayMs??200,this.retryMaxDelayMs=t.retryMaxDelayMs??2e3,this.shutdownTimeoutMs=t.shutdownTimeoutMs??2e3,this.fetchFn=t.fetchFn??fetch,this.logger=t.logger??console,this.now=t.now??(()=>new Date),this.sleep=t.sleep??(n=>new Promise(r=>setTimeout(r,n))),this.apiKey=t.apiKey,this.sdkVersion=t.sdkVersion,this.flushIntervalMs>0&&(this.flushTimer=setInterval(()=>{this.flush()},this.flushIntervalMs))}enqueue(t){if(this.isStopped||this.isShuttingDown){this.logger.warn("[WaniWani] Tracking transport is stopped, dropping event %s",t.id);return}if(this.buffer.length>=this.maxBufferSize){let n=this.buffer.length-this.maxBufferSize+1;this.buffer.splice(0,n),this.logger.warn("[WaniWani] Tracking buffer overflow, dropped %d oldest event(s)",n)}if(this.buffer.push(t),this.buffer.length>=this.maxBatchSize){this.flush();return}this.scheduleMicroFlush()}pendingEvents(){return this.buffer.length+this.inFlightCount}async flush(){return this.flushInFlight?this.flushInFlight:(this.flushInFlight=this.flushLoop().finally(()=>{this.flushInFlight=void 0}),this.flushInFlight)}async shutdown(t){this.isShuttingDown=!0,this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=void 0),this.flushScheduledTimer&&(clearTimeout(this.flushScheduledTimer),this.flushScheduledTimer=void 0,this.flushScheduled=!1);let n=t?.timeoutMs??this.shutdownTimeoutMs,r=this.flush();if(!Number.isFinite(n)||n<=0)return await r,this.isStopped=!0,{timedOut:!1,pendingEvents:this.pendingEvents()};let i=Symbol("shutdown-timeout");return await Promise.race([r.then(()=>"flushed"),this.sleep(n).then(()=>i)])===i?(this.isStopped=!0,{timedOut:!0,pendingEvents:this.pendingEvents()}):(this.isStopped=!0,{timedOut:!1,pendingEvents:this.pendingEvents()})}scheduleMicroFlush(){this.flushScheduled||(this.flushScheduled=!0,this.flushScheduledTimer=setTimeout(()=>{this.flushScheduledTimer=void 0,this.flushScheduled=!1,this.flush()},0))}async flushLoop(){for(;this.buffer.length>0&&!this.isStopped;){let t=this.buffer.splice(0,this.maxBatchSize);await this.sendBatchWithRetry(t)}}async sendBatchWithRetry(t){let n=0,r=t;for(;r.length>0&&!this.isStopped;){this.inFlightCount=r.length;let i=await this.sendBatchOnce(r);switch(this.inFlightCount=0,i.kind){case"success":return;case"auth":this.stopTransportForAuthFailure(i.status,r.length);return;case"permanent":this.logger.error("[WaniWani] Dropping %d event(s) after permanent failure: %s",r.length,i.reason);return;case"retryable":if(n>=this.maxRetries){this.logger.error("[WaniWani] Dropping %d event(s) after retry exhaustion: %s",r.length,i.reason);return}await this.sleep(this.backoffDelayMs(n)),n+=1;continue;case"partial":if(i.permanent.length>0&&this.logger.error("[WaniWani] Dropping %d event(s) rejected as permanent",i.permanent.length),i.retryable.length===0)return;if(n>=this.maxRetries){this.logger.error("[WaniWani] Dropping %d retryable event(s) after retry exhaustion",i.retryable.length);return}r=i.retryable,await this.sleep(this.backoffDelayMs(n)),n+=1;continue}}}async sendBatchOnce(t){let n;try{n=await this.fetchFn(this.endpointUrl,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,"X-WaniWani-SDK":ue},body:JSON.stringify(this.makeBatchRequest(t))})}catch(s){return{kind:"retryable",reason:$e(s)}}if(Ne.has(n.status))return{kind:"auth",status:n.status};if(Oe.has(n.status))return{kind:"retryable",reason:`HTTP ${n.status}`};if(!n.ok)return{kind:"permanent",reason:`HTTP ${n.status}`};let r=await qe(n);if(!r?.rejected||r.rejected.length===0)return{kind:"success"};let i=this.classifyRejectedEvents(t,r.rejected);return i.retryable.length===0&&i.permanent.length===0?{kind:"success"}:{kind:"partial",retryable:i.retryable,permanent:i.permanent}}makeBatchRequest(t){return{sentAt:this.now().toISOString(),source:{sdk:ue,version:this.sdkVersion??"0.0.0"},events:t}}classifyRejectedEvents(t,n){let r=new Map(t.map(o=>[o.id,o])),i=[],s=[];for(let o of n){let a=r.get(o.eventId);if(a){if(Be(o)){i.push(a);continue}s.push(a)}}return{retryable:i,permanent:s}}backoffDelayMs(t){let n=this.retryBaseDelayMs*2**t;return Math.min(n,this.retryMaxDelayMs)}stopTransportForAuthFailure(t,n){this.isStopped=!0;let r=this.buffer.length;this.buffer.splice(0,r),this.logger.error("[WaniWani] Auth failure (HTTP %d). Stopping tracking transport and dropping %d queued event(s)",t,n+r)}};function Be(e){if(e.retryable===!0)return!0;let t=e.code.toLowerCase();return t.includes("timeout")||t.includes("temporary")||t.includes("unavailable")||t.includes("rate_limit")||t.includes("transient")||t.includes("server")}async function qe(e){let t=await e.text();if(t)try{return JSON.parse(t)}catch{return}}function je(e,t){let n=e.endsWith("/")?e:`${e}/`,r=t.startsWith("/")?t.slice(1):t;return`${n}${r}`}function $e(e){return e instanceof Error?e.message:String(e)}function pe(e){let{baseUrl:t,apiKey:n,tracking:r}=e;function i(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}let s=n?le({baseUrl:t,apiKey:n,endpointPath:r.endpointPath,flushIntervalMs:r.flushIntervalMs,maxBatchSize:r.maxBatchSize,maxBufferSize:r.maxBufferSize,maxRetries:r.maxRetries,retryBaseDelayMs:r.retryBaseDelayMs,retryMaxDelayMs:r.retryMaxDelayMs,shutdownTimeoutMs:r.shutdownTimeoutMs}):void 0,o={async identify(a,d){i();let u=D({event:"user.identified",externalUserId:a,properties:d});return s?.enqueue(u),{eventId:u.id}},async track(a){i();let d=D(a);return s?.enqueue(d),{eventId:d.id}},async flush(){i(),await s?.flush()},async shutdown(a){return i(),await s?.shutdown({timeoutMs:a?.timeoutMs??r.shutdownTimeoutMs})??{timedOut:!1,pendingEvents:0}}};return s&&Le(o,r.shutdownTimeoutMs),o}function Le(e,t){if(typeof process>"u"||typeof process.once!="function"||typeof process.on!="function")return;let n=()=>{e.shutdown({timeoutMs:t})};process.once("beforeExit",n),process.once("SIGINT",n),process.once("SIGTERM",n)}function N(e){let t=e?.baseUrl??"https://app.waniwani.ai",n=e?.apiKey??process.env.WANIWANI_API_KEY,r={endpointPath:e?.tracking?.endpointPath??"/api/mcp/events/v2/batch",flushIntervalMs:e?.tracking?.flushIntervalMs??1e3,maxBatchSize:e?.tracking?.maxBatchSize??20,maxBufferSize:e?.tracking?.maxBufferSize??1e3,maxRetries:e?.tracking?.maxRetries??3,retryBaseDelayMs:e?.tracking?.retryBaseDelayMs??200,retryMaxDelayMs:e?.tracking?.retryMaxDelayMs??2e3,shutdownTimeoutMs:e?.tracking?.shutdownTimeoutMs??2e3},i={baseUrl:t,apiKey:n,tracking:r},s=pe(i),o=ce(i);return{...s,kb:o,_config:i}}function Ve(e){let t=e.event_type??"widget_click",r=t.startsWith("widget_")?t:`widget_${t}`,i={...e.metadata??{}};return e.event_name&&(i.event_name=e.event_name),{event:r,properties:i,sessionId:e.session_id,traceId:e.trace_id,externalUserId:e.user_id,eventId:e.event_id,timestamp:e.timestamp,source:e.source??"widget"}}function He(e){let t={apiKey:e?.apiKey,baseUrl:e?.baseUrl},n;function r(){return n||(n=N(t)),n}return async function(s){let o;try{o=await s.json()}catch{return new Response(JSON.stringify({error:"Invalid JSON"}),{status:400,headers:{"Content-Type":"application/json"}})}if(!Array.isArray(o.events)||o.events.length===0)return new Response(JSON.stringify({error:"Missing or empty events array"}),{status:400,headers:{"Content-Type":"application/json"}});try{let a=r(),d=[];for(let u of o.events){let l=Ve(u),h=await a.track(l);d.push(h.eventId)}return await a.flush(),new Response(JSON.stringify({ok:!0,accepted:d.length}),{status:200,headers:{"Content-Type":"application/json"}})}catch(a){let d=a instanceof Error?a.message:"Unknown error";return new Response(JSON.stringify({error:d}),{status:500,headers:{"Content-Type":"application/json"}})}}}var O=class{cached=null;pending=null;config;constructor(t){this.config=t}async getToken(t,n){return this.cached&&Date.now()<this.cached.expiresAt-12e4?this.cached.token:this.pending?this.pending:(this.pending=this.mint(t,n).finally(()=>{this.pending=null}),this.pending)}async mint(t,n){let r=Ke(this.config.baseUrl,"/api/mcp/widget-tokens"),i={};t&&(i.sessionId=t),n&&(i.traceId=n);try{let s=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(i)});if(!s.ok)return null;let o=await s.json(),a=o.data&&typeof o.data=="object"?o.data:o,d=new Date(a.expiresAt).getTime();return!a.token||Number.isNaN(d)?null:(this.cached={token:a.token,expiresAt:d},a.token)}catch{return null}}};function Ke(e,t){return`${e.endsWith("/")?e.slice(0,-1):e}${t}`}var fe="https://app.waniwani.ai";function ze(e,t={}){let n=e;if(n.__waniwaniWrapped)return n;n.__waniwaniWrapped=!0;let r=t.client??N(t.config),i=t.injectWidgetToken!==!1,s=null;function o(){if(s)return s;let d=r._config.apiKey;return d?(s=new O({baseUrl:r._config.baseUrl??fe,apiKey:d}),s):null}let a=e.registerTool.bind(e);return n.registerTool=((...d)=>{let[u,l,h]=d,c=typeof u=="string"&&u.trim().length>0?u:"unknown";if(typeof h!="function")return a(...d);let g=h;return a(u,l,async(m,f)=>{let E=performance.now();try{let T=await g(m,f),v=Math.round(performance.now()-E);return await he(r,ge(c,f,t,{durationMs:v,status:"ok"}),t.onError),t.flushAfterToolCall&&await me(r,t.onError),i&&await Ye(T,o(),r._config.baseUrl??fe,t.onError),Xe(T,f),T}catch(T){let v=Math.round(performance.now()-E);throw await he(r,ge(c,f,t,{durationMs:v,status:"error",errorMessage:T instanceof Error?T.message:String(T)}),t.onError),t.flushAfterToolCall&&await me(r,t.onError),T}})}),n}async function Ye(e,t,n,r){if(!I(e))return;I(e._meta)||(e._meta={});let i=e._meta,s={endpoint:`${n.replace(/\/$/,"")}/api/mcp/events/v2/batch`};if(t)try{let o=await t.getToken();o&&(s.token=o)}catch(o){r?.(z(o))}i.waniwani=s}function ge(e,t,n,r){let i=Je(e,n.toolType),s=we(t);return{event:"tool.called",properties:{name:e,type:i,...r??{}},meta:s,metadata:{source:"withWaniwani",...n.metadata??{}}}}function Je(e,t){return typeof t=="function"?t(e)??"other":t??"other"}function we(e){if(!I(e))return;let t=e._meta;if(I(t))return t}function I(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}async function he(e,t,n){try{await e.track(t)}catch(r){n?.(z(r))}}async function me(e,t){try{await e.flush()}catch(n){t?.(z(n))}}function z(e){return e instanceof Error?e:new Error(String(e))}var K="waniwani/userLocation";function Xe(e,t){let n=we(t);if(!n)return;let r=n[K];if(!r||!I(e))return;I(e._meta)||(e._meta={});let i=e._meta;i[K]||(i[K]=r)}export{x as END,S as START,R as StateGraph,re as createFlow,ae as createResource,be as createTool,He as createTrackingRoute,B as detectPlatform,P as encodeFlowToken,ke as isMCPApps,Te as isOpenAI,Ce as registerTools,ze as withWaniwani};
 //# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/react/widgets/platform.ts","../../src/mcp/server/flows/@types.ts","../../src/mcp/server/flows/compile.ts","../../src/mcp/server/flows/flow-token.ts","../../src/mcp/server/flows/state-graph.ts","../../src/mcp/server/flows/create-flow.ts","../../src/mcp/server/resources/meta.ts","../../src/mcp/server/resources/create-resource.ts","../../src/mcp/server/tools/create-tool.ts","../../src/error.ts","../../src/kb/client.ts","../../src/tracking/mapper.ts","../../src/tracking/transport.ts","../../src/tracking/index.ts","../../src/waniwani.ts","../../src/mcp/server/tracking-route.ts","../../src/mcp/server/widget-token.ts","../../src/mcp/server/with-waniwani.ts"],"sourcesContent":["/**\n * Widget platform types\n */\nexport type WidgetPlatform = \"openai\" | \"mcp-apps\";\n\n/**\n * Detects which platform the widget is running on.\n *\n * OpenAI injects a global `window.openai` object.\n * MCP Apps runs in a sandboxed iframe and uses postMessage.\n */\nexport function detectPlatform(): WidgetPlatform {\n\tif (typeof window !== \"undefined\" && \"openai\" in window) {\n\t\treturn \"openai\";\n\t}\n\treturn \"mcp-apps\";\n}\n\n/**\n * Check if running on OpenAI platform\n */\nexport function isOpenAI(): boolean {\n\treturn detectPlatform() === \"openai\";\n}\n\n/**\n * Check if running on MCP Apps platform\n */\nexport function isMCPApps(): boolean {\n\treturn detectPlatform() === \"mcp-apps\";\n}\n","import type { z } from \"zod\";\nimport type { McpServer } from \"../resources/types\";\nimport type { RegisteredTool } from \"../tools/types\";\n\nexport type { McpServer };\n\n// ============================================================================\n// Sentinel constants\n// ============================================================================\n\nexport const START = \"__start__\" as const;\nexport const END = \"__end__\" as const;\n\n// ============================================================================\n// Signal types — returned by node handlers to control flow behavior\n// ============================================================================\n\nconst INTERRUPT = Symbol.for(\"waniwani.flow.interrupt\");\nconst WIDGET = Symbol.for(\"waniwani.flow.widget\");\n\n/** A single question within an interrupt step */\nexport type InterruptQuestion = {\n\t/** Question to ask the user */\n\tquestion: string;\n\t/** State key where the answer will be stored */\n\tfield: string;\n\t/** Optional suggestions to present as options */\n\tsuggestions?: string[];\n\t/** Hidden context/instructions for this specific question (not shown to user directly) */\n\tcontext?: string;\n\t/** Validation function — runs after the user answers, before advancing to the next node */\n\t// biome-ignore lint/suspicious/noConfusingVoidType: void is needed so `async () => {}` compiles\n\tvalidate?: (value: unknown) => MaybePromise<Record<string, unknown> | void>;\n};\n\n/**\n * Interrupt signal — pauses the flow and asks the user one or more questions.\n * Single-question and multi-question interrupts use the same type.\n */\nexport type InterruptSignal = {\n\treadonly __type: typeof INTERRUPT;\n\t/** Questions to ask — ask all in one conversational message */\n\tquestions: InterruptQuestion[];\n\t/** Overall hidden context/instructions for the assistant (not shown to user directly) */\n\tcontext?: string;\n};\n\nexport type WidgetSignal = {\n\treadonly __type: typeof WIDGET;\n\t/** The display tool to delegate rendering to */\n\ttool: RegisteredTool;\n\t/** Data to pass to the display tool */\n\tdata: Record<string, unknown>;\n\t/** Description of what the widget does (for the AI's context) */\n\tdescription?: string;\n\t/**\n\t * Whether the user is expected to interact with the widget before the flow continues.\n\t * Defaults to true. Set to false for informational widgets that should render and then\n\t * immediately advance to the next flow step.\n\t */\n\tinteractive?: boolean;\n\t/**\n\t * State key this widget fills — enables auto-skip when the field is already in state.\n\t * Pass this so the engine can skip the widget step when the answer is already known.\n\t */\n\tfield?: string;\n};\n\n/**\n * Create an interrupt signal — pauses the flow and asks the user a question.\n * Used internally by the engine. Flow authors use the typed `interrupt` from the node context.\n */\nexport function interrupt(\n\tconfig:\n\t\t| {\n\t\t\t\tquestion: string;\n\t\t\t\tfield: string;\n\t\t\t\tsuggestions?: string[];\n\t\t\t\tcontext?: string;\n\t\t\t\tvalidate?: (\n\t\t\t\t\tvalue: unknown,\n\t\t\t\t\t// biome-ignore lint/suspicious/noConfusingVoidType: void is needed so `async () => {}` compiles\n\t\t\t\t) => MaybePromise<Record<string, unknown> | void>;\n\t\t  }\n\t\t| { questions: InterruptQuestion[]; context?: string },\n): InterruptSignal {\n\tif (\"questions\" in config) {\n\t\treturn {\n\t\t\t__type: INTERRUPT,\n\t\t\tquestions: config.questions,\n\t\t\tcontext: config.context,\n\t\t};\n\t}\n\tconst { question, field, context, suggestions, validate } = config;\n\treturn {\n\t\t__type: INTERRUPT,\n\t\tquestions: [{ question, field, context, suggestions, validate }],\n\t};\n}\n\n/**\n * Create a widget signal — pauses the flow and delegates rendering to a display tool.\n * Used internally by the engine. Flow authors use the typed `showWidget` from the node context.\n */\nexport function showWidget(\n\ttool: RegisteredTool,\n\tconfig: {\n\t\tdata: Record<string, unknown>;\n\t\tdescription?: string;\n\t\tinteractive?: boolean;\n\t\tfield?: string;\n\t},\n): WidgetSignal {\n\treturn { __type: WIDGET, tool, ...config };\n}\n\nexport function isInterrupt(value: unknown): value is InterruptSignal {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"__type\" in value &&\n\t\t(value as InterruptSignal).__type === INTERRUPT\n\t);\n}\n\nexport function isWidget(value: unknown): value is WidgetSignal {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"__type\" in value &&\n\t\t(value as WidgetSignal).__type === WIDGET\n\t);\n}\n\n// ============================================================================\n// Node context & handler\n// ============================================================================\n\nexport type MaybePromise<T> = T | Promise<T>;\n\n/**\n * Typed interrupt function — available on the node context.\n * The `field` parameter is typed as `keyof TState`, and `validate` receives\n * the field's value typed from the Zod schema.\n */\nexport type TypedInterrupt<TState> = {\n\t/** Single question — field and validate are typed from the state schema */\n\t<F extends Extract<keyof TState, string>>(config: {\n\t\tquestion: string;\n\t\tfield: F;\n\t\t// biome-ignore lint/suspicious/noConfusingVoidType: void is needed so `async () => {}` compiles\n\t\tvalidate?: (value: TState[F]) => MaybePromise<Partial<TState> | void>;\n\t\tsuggestions?: string[];\n\t\tcontext?: string;\n\t}): InterruptSignal;\n\t/** Multiple questions asked together in one conversational message */\n\t(config: {\n\t\tquestions: Array<{\n\t\t\tquestion: string;\n\t\t\tfield: Extract<keyof TState, string>;\n\t\t\tsuggestions?: string[];\n\t\t\tcontext?: string;\n\t\t}>;\n\t\tcontext?: string;\n\t}): InterruptSignal;\n};\n\n/**\n * Typed showWidget function — available on the node context.\n * The `field` parameter is typed as `keyof TState`.\n */\nexport type TypedShowWidget<TState> = (\n\ttool: RegisteredTool,\n\tconfig: {\n\t\tdata: Record<string, unknown>;\n\t\tdescription?: string;\n\t\tinteractive?: boolean;\n\t\tfield?: Extract<keyof TState, string>;\n\t},\n) => WidgetSignal;\n\n/**\n * Context object passed to node handlers.\n * Provides state, metadata, and typed helper functions for creating signals.\n */\nexport type NodeContext<TState> = {\n\t/** Current flow state (partial — fields are filled as the flow progresses) */\n\tstate: Partial<TState>;\n\t/** Request metadata from the MCP call */\n\tmeta?: Record<string, unknown>;\n\t/** Create an interrupt signal — pause and ask the user questions */\n\tinterrupt: TypedInterrupt<TState>;\n\t/** Create a widget signal — pause and show a UI widget */\n\tshowWidget: TypedShowWidget<TState>;\n};\n\n/**\n * Node handler — receives a context object and returns a signal or state updates.\n * The return value determines behavior:\n * - `Partial<TState>` → action node (state merged, auto-advance)\n * - `InterruptSignal` → interrupt (pause, ask user one or more questions)\n * - `WidgetSignal` → widget step (pause, show widget)\n */\nexport type NodeHandler<TState> = (\n\tctx: NodeContext<TState>,\n) => MaybePromise<Partial<TState> | InterruptSignal | WidgetSignal>;\n\n/**\n * Condition function for conditional edges.\n * Receives current state, returns the name of the next node.\n */\nexport type ConditionFn<TState> = (\n\tstate: Partial<TState>,\n) => string | Promise<string>;\n\nexport type Edge<TState> =\n\t| { type: \"direct\"; to: string }\n\t| { type: \"conditional\"; condition: ConditionFn<TState> };\n\n// ============================================================================\n// Flow config & compiled output\n// ============================================================================\n\nexport type FlowConfig = {\n\t/** Unique identifier for the flow (becomes the MCP tool name) */\n\tid: string;\n\t/** Display title */\n\ttitle: string;\n\t/** Description for the AI (explains when to use this flow) */\n\tdescription: string;\n\t/**\n\t * Define the flow's state — each field the flow collects.\n\t * Keys are the field names used in `interrupt({ field })`,\n\t * values are Zod schemas with `.describe()`.\n\t *\n\t * The state definition serves two purposes:\n\t * 1. Type inference — `TState` is automatically derived, no explicit generic needed\n\t * 2. AI protocol — field names, types, and descriptions are included in the tool\n\t *    description so the AI can pre-fill answers via `_meta.flow.state`\n\t *\n\t * @example\n\t * ```ts\n\t * state: {\n\t *   country: z.string().describe(\"Country the business is based in\"),\n\t *   status: z.enum([\"registered\", \"unregistered\"]).describe(\"Business registration status\"),\n\t * }\n\t * ```\n\t */\n\tstate: Record<string, z.ZodType>;\n\t/** Optional tool annotations */\n\tannotations?: {\n\t\treadOnlyHint?: boolean;\n\t\tidempotentHint?: boolean;\n\t\topenWorldHint?: boolean;\n\t\tdestructiveHint?: boolean;\n\t};\n};\n\n/**\n * Infer the runtime state type from a flow's state schema definition.\n *\n * @example\n * ```ts\n * const config = {\n *   state: {\n *     country: z.enum([\"FR\", \"DE\"]),\n *     status: z.enum([\"registered\", \"unregistered\"]),\n *   }\n * };\n * type MyState = InferFlowState<typeof config.state>;\n * // { country: \"FR\" | \"DE\"; status: \"registered\" | \"unregistered\" }\n * ```\n */\nexport type InferFlowState<T extends Record<string, z.ZodType>> = {\n\t[K in keyof T]: z.infer<T[K]>;\n};\n\n/**\n * A compiled flow — can be registered on an McpServer.\n */\nexport type RegisteredFlow = {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n\tregister: (server: McpServer) => Promise<void>;\n};\n\nexport interface CompileInput<TState extends Record<string, unknown>> {\n\tconfig: FlowConfig;\n\tnodes: Map<string, NodeHandler<TState>>;\n\tedges: Map<string, Edge<TState>>;\n}\n\nexport type FlowToolInput = {\n\taction: \"start\" | \"continue\";\n\tstateUpdates?: Record<string, unknown>;\n\tflowToken?: string;\n};\n\nexport type FlowTokenContent = {\n\tstep?: string;\n\tstate: Record<string, unknown>;\n\tfield?: string;\n\twidgetId?: string;\n\t/** Cached interrupt questions — avoids re-executing the handler on partial answers */\n\tquestions?: Array<{\n\t\tquestion: string;\n\t\tfield: string;\n\t\tsuggestions?: string[];\n\t\tcontext?: string;\n\t}>;\n\t/** Cached overall interrupt context */\n\tinterruptContext?: string;\n};\n\n/** Parsed response text from a flow tool call */\nexport type FlowContent = {\n\tstatus: \"widget\" | \"interrupt\" | \"complete\" | \"error\";\n\tdescription?: string;\n\tquestion?: string;\n\terror?: string;\n\tflowToken?: string;\n\t/** Whether a widget step expects user interaction before continuing */\n\tinteractive?: boolean;\n\t/** Display tool to call (widget status only) */\n\ttool?: string;\n\t/** Data to pass to the display tool (widget status only) */\n\tdata?: Record<string, unknown>;\n};\n\nexport type ExecutionResult = {\n\tcontent: FlowContent;\n\tflowTokenContent?: FlowTokenContent;\n};\n","import type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n\tServerNotification,\n\tServerRequest,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\nimport type {\n\tCompileInput,\n\tEdge,\n\tExecutionResult,\n\tFlowConfig,\n\tFlowContent,\n\tFlowTokenContent,\n\tFlowToolInput,\n\tMaybePromise,\n\tMcpServer,\n\tNodeHandler,\n\tRegisteredFlow,\n} from \"./@types\";\nimport {\n\tEND,\n\tinterrupt,\n\tisInterrupt,\n\tisWidget,\n\tSTART,\n\tshowWidget,\n} from \"./@types\";\nimport { decodeFlowToken, encodeFlowToken } from \"./flow-token\";\n\n// ============================================================================\n// Flow protocol — embedded in tool description\n// ============================================================================\n\n/** Extract a human-readable label from a Zod schema for the AI protocol */\nfunction describeZodField(schema: z.ZodType): string {\n\tconst desc = schema.description ?? \"\";\n\tconst def = (\n\t\tschema as unknown as {\n\t\t\t_zod: { def: { type: string; entries?: Record<string, string> } };\n\t\t}\n\t)._zod?.def;\n\n\tif (def?.type === \"enum\" && def.entries) {\n\t\tconst vals = Object.keys(def.entries)\n\t\t\t.map((v) => `\"${v}\"`)\n\t\t\t.join(\" | \");\n\t\treturn desc ? `${vals} — ${desc}` : vals;\n\t}\n\n\treturn desc;\n}\n\nfunction buildFlowProtocol(config: FlowConfig): string {\n\tconst lines = [\n\t\t\"\",\n\t\t\"## FLOW EXECUTION PROTOCOL\",\n\t\t\"\",\n\t\t\"This tool implements a multi-step conversational flow. Follow this protocol exactly:\",\n\t\t\"\",\n\t\t'1. Call with `action: \"start\"` to begin. If the user\\'s message already',\n\t\t\"   contains answers to likely questions, extract them into `stateUpdates`\",\n\t\t\"   as `{ field: value }` pairs. The engine will auto-skip steps whose\",\n\t\t\"   fields are already filled.\",\n\t\t\"   Only extract values the user explicitly stated — do NOT guess or invent values.\",\n\t];\n\n\tif (config.state) {\n\t\tconst fieldList = Object.entries(config.state)\n\t\t\t.map(([key, schema]) => {\n\t\t\t\tconst info = describeZodField(schema);\n\t\t\t\treturn info ? `\\`${key}\\` (${info})` : `\\`${key}\\``;\n\t\t\t})\n\t\t\t.join(\", \");\n\t\tlines.push(`   Known fields: ${fieldList}.`);\n\t}\n\n\tlines.push(\n\t\t\"2. The response JSON `status` field tells you what to do next:\",\n\t\t'   - `\"interrupt\"`: Pause and ask the user. Two forms:',\n\t\t\"     a. Single question: `{ question, field, context? }` — ask `question`, store answer in `field`.\",\n\t\t\"     b. Multi-question: `{ questions: [{question, field}, ...], context? }` — ask ALL questions\",\n\t\t\"        in one conversational message, collect all answers.\",\n\t\t\"     `context` (if present) is hidden AI instructions — use to shape your response, do NOT show verbatim.\",\n\t\t\"     Then call again with:\",\n\t\t'     `action: \"continue\"`, `flowToken` = the `flowToken` from the response (pass back exactly as received),',\n\t\t\"     `stateUpdates` = answers keyed by their `field` names, plus any other fields the user mentioned.\",\n\t\t'   - `\"widget\"`: The flow wants to show a UI widget. Call the tool named in the `tool`',\n\t\t\"     field, passing the `data` object as the tool's input.\",\n\t\t\"     If the response includes `interactive: false`, the widget is display-only:\",\n\t\t\"     call the display tool, show the widget, then immediately call THIS flow tool again with\",\n\t\t'     `action: \"continue\"` and the same `flowToken`. In that case, do NOT wait for the user',\n\t\t\"     to click or use the widget, and do NOT ask them to interact with it unless the\",\n\t\t\"     description explicitly says otherwise.\",\n\t\t\"     Otherwise, present the widget result to the user. When the user makes a choice or interacts\",\n\t\t\"     with the widget, call THIS flow tool again with:\",\n\t\t'     `action: \"continue\"`, `flowToken` = the `flowToken` from the response,',\n\t\t\"     `stateUpdates` = `{ [field]: <user's selection> }` plus any other fields the user mentioned.\",\n\t\t'   - `\"complete\"`: The flow is done. Present the result to the user.',\n\t\t'   - `\"error\"`: Something went wrong. Show the `error` message.',\n\t\t\"\",\n\t\t\"3. ALWAYS pass back the `flowToken` string exactly as received — it is an opaque token, do not modify it.\",\n\t\t\"4. Do NOT invent state values. Only use `stateUpdates` for information the user explicitly provided.\",\n\t\t\"5. Include only the fields the user actually answered in `stateUpdates` — do NOT guess missing ones.\",\n\t\t\"   If the user did not answer all pending questions, the engine will re-prompt for the remaining ones.\",\n\t\t\"   If the user mentioned values for other known fields, include those too —\",\n\t\t\"   they will be applied immediately and those steps will be auto-skipped.\",\n\t);\n\n\treturn lines.join(\"\\n\");\n}\n\nfunction getInputMeta(args: FlowToolInput): FlowTokenContent & {\n\tstate: Record<string, unknown>;\n} {\n\tif (args.flowToken) {\n\t\tconst decoded = decodeFlowToken(args.flowToken);\n\t\tif (decoded) return decoded;\n\t}\n\treturn { step: undefined as unknown as string, state: {} };\n}\n\n// ============================================================================\n// Edge resolution\n// ============================================================================\n\nasync function resolveNextNode<TState extends Record<string, unknown>>(\n\tedge: Edge<TState>,\n\tstate: Partial<TState>,\n): Promise<string> {\n\tif (edge.type === \"direct\") return edge.to;\n\treturn edge.condition(state);\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/** Check whether a state value counts as \"filled\" (not empty/missing). */\nfunction isFilled(v: unknown): boolean {\n\treturn v !== undefined && v !== null && v !== \"\";\n}\n\n// ============================================================================\n// Interrupt result builder\n// ============================================================================\n\ntype InterruptQuestionData = {\n\tquestion: string;\n\tfield: string;\n\tsuggestions?: string[];\n\tcontext?: string;\n};\n\n/**\n * Build an interrupt ExecutionResult from a list of questions and current state.\n * Filters out already-answered questions and caches the full question list in\n * flowMeta so partial-answer continues can filter without re-executing the handler.\n *\n * Returns `null` when all questions are already filled (caller should advance).\n */\nfunction buildInterruptResult<TState extends Record<string, unknown>>(\n\tquestions: InterruptQuestionData[],\n\tcontext: string | undefined,\n\tcurrentNode: string,\n\tstate: TState,\n): ExecutionResult | null {\n\t// All filled — caller should advance to the next node\n\tif (questions.every((q) => isFilled(state[q.field as keyof TState]))) {\n\t\treturn null;\n\t}\n\n\t// Filter out questions whose fields are already answered\n\tconst unanswered = questions.filter(\n\t\t(q) => !isFilled(state[q.field as keyof TState]),\n\t);\n\n\t// Single-question shorthand: unwrap for cleaner AI payload\n\tconst isSingle = unanswered.length === 1;\n\tconst q0 = unanswered[0];\n\tconst payload =\n\t\tisSingle && q0\n\t\t\t? {\n\t\t\t\t\tstatus: \"interrupt\" as const,\n\t\t\t\t\tquestion: q0.question,\n\t\t\t\t\tfield: q0.field,\n\t\t\t\t\t...(q0.suggestions ? { suggestions: q0.suggestions } : {}),\n\t\t\t\t\t...(q0.context || context ? { context: q0.context ?? context } : {}),\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\tstatus: \"interrupt\" as const,\n\t\t\t\t\tquestions: unanswered,\n\t\t\t\t\t...(context ? { context } : {}),\n\t\t\t\t};\n\n\treturn {\n\t\tcontent: payload,\n\t\tflowTokenContent: {\n\t\t\tstep: currentNode,\n\t\t\tstate,\n\t\t\t...(isSingle && q0 ? { field: q0.field } : {}),\n\t\t\t// Cache the full question list so partial-answer continues\n\t\t\t// can filter without re-executing the node handler.\n\t\t\tquestions,\n\t\t\t...(context ? { interruptContext: context } : {}),\n\t\t},\n\t};\n}\n\n// ============================================================================\n// Validator type\n// ============================================================================\n\ntype ValidateFn = (\n\tvalue: unknown,\n\t// biome-ignore lint/suspicious/noConfusingVoidType: void needed for async () => {} validators\n) => MaybePromise<Record<string, unknown> | void>;\n\n// ============================================================================\n// Execution engine\n// ============================================================================\n\nasync function executeFrom<TState extends Record<string, unknown>>(\n\tstartNodeName: string,\n\tstartState: TState,\n\tnodes: Map<string, NodeHandler<TState>>,\n\tedges: Map<string, Edge<TState>>,\n\tvalidators: Map<string, ValidateFn>,\n\tmeta?: Record<string, unknown>,\n): Promise<ExecutionResult> {\n\tlet currentNode = startNodeName;\n\tlet state = { ...startState };\n\n\t// Safety limit to prevent infinite loops\n\tconst MAX_ITERATIONS = 50;\n\tlet iterations = 0;\n\n\twhile (iterations++ < MAX_ITERATIONS) {\n\t\t// Reached END\n\t\tif (currentNode === END) {\n\t\t\treturn {\n\t\t\t\tcontent: { status: \"complete\" },\n\t\t\t\tflowTokenContent: { state },\n\t\t\t};\n\t\t}\n\n\t\tconst handler = nodes.get(currentNode);\n\t\tif (!handler) {\n\t\t\treturn {\n\t\t\t\tcontent: {\n\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\terror: `Unknown node: \"${currentNode}\"`,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\ttry {\n\t\t\t// Build context object for the handler\n\t\t\tconst ctx = {\n\t\t\t\tstate,\n\t\t\t\tmeta,\n\t\t\t\tinterrupt: interrupt as NodeHandler<TState> extends never\n\t\t\t\t\t? never\n\t\t\t\t\t: typeof interrupt,\n\t\t\t\tshowWidget: showWidget as NodeHandler<TState> extends never\n\t\t\t\t\t? never\n\t\t\t\t\t: typeof showWidget,\n\t\t\t};\n\t\t\tconst result = await handler(ctx as Parameters<typeof handler>[0]);\n\n\t\t\t// Interrupt signal — pause and ask the user one or more questions\n\t\t\tif (isInterrupt(result)) {\n\t\t\t\t// Extract and store any validate functions from the interrupt questions\n\t\t\t\tfor (const q of result.questions) {\n\t\t\t\t\tif (q.validate) {\n\t\t\t\t\t\tvalidators.set(`${currentNode}:${q.field}`, q.validate);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst interruptResult = buildInterruptResult(\n\t\t\t\t\tresult.questions,\n\t\t\t\t\tresult.context,\n\t\t\t\t\tcurrentNode,\n\t\t\t\t\tstate,\n\t\t\t\t);\n\n\t\t\t\tif (interruptResult) {\n\t\t\t\t\treturn interruptResult;\n\t\t\t\t}\n\n\t\t\t\t// All questions filled — auto-skip to next node\n\t\t\t\tconst edge = edges.get(currentNode);\n\t\t\t\tif (!edge) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: {\n\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\terror: `No outgoing edge from node \"${currentNode}\"`,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcurrentNode = await resolveNextNode(edge, state);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Widget signal — delegate to display tool\n\t\t\tif (isWidget(result)) {\n\t\t\t\tconst widgetField = result.field;\n\t\t\t\tif (widgetField) {\n\t\t\t\t\tif (isFilled(state[widgetField as keyof TState])) {\n\t\t\t\t\t\tconst edge = edges.get(currentNode);\n\t\t\t\t\t\tif (!edge) {\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tcontent: {\n\t\t\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\t\t\terror: `No outgoing edge from node \"${currentNode}\"`,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\t\t\t\t\t\tcurrentNode = await resolveNextNode(edge, state);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"widget\",\n\t\t\t\t\t\ttool: result.tool.id,\n\t\t\t\t\t\tdata: result.data,\n\t\t\t\t\t\tdescription: result.description,\n\t\t\t\t\t\t...(result.interactive === false ? { interactive: false } : {}),\n\t\t\t\t\t},\n\t\t\t\t\tflowTokenContent: {\n\t\t\t\t\t\tstep: currentNode,\n\t\t\t\t\t\tstate,\n\t\t\t\t\t\tfield: widgetField,\n\t\t\t\t\t\twidgetId: result.tool.id,\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Action node — merge state and auto-advance\n\t\t\tstate = { ...state, ...result } as TState;\n\n\t\t\tconst edge = edges.get(currentNode);\n\t\t\tif (!edge) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: `No outgoing edge from node \"${currentNode}\"`,\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\t\t\tcurrentNode = await resolveNextNode(edge, state);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tcontent: { status: \"error\", error: message },\n\t\t\t\tflowTokenContent: { step: currentNode, state },\n\t\t\t};\n\t\t}\n\t}\n\n\treturn {\n\t\tcontent: {\n\t\t\tstatus: \"error\",\n\t\t\terror: \"Flow exceeded maximum iterations (possible infinite loop)\",\n\t\t},\n\t};\n}\n\n// ============================================================================\n// Compile\n// ============================================================================\n\nconst inputSchema = {\n\taction: z\n\t\t.enum([\"start\", \"continue\"])\n\t\t.describe(\n\t\t\t'\"start\" to begin the flow, \"continue\" to resume after a pause (interrupt or widget)',\n\t\t),\n\tstateUpdates: z\n\t\t.record(z.string(), z.unknown())\n\t\t.optional()\n\t\t.describe(\n\t\t\t\"State field values to set before processing the next node. Use this to pass the user's answer (keyed by the field name from the response) and any other values the user mentioned.\",\n\t\t),\n\tflowToken: z\n\t\t.string()\n\t\t.optional()\n\t\t.describe(\n\t\t\t\"Opaque flow token from the previous response. Pass back exactly as received.\",\n\t\t),\n};\n\nexport function compileFlow<TState extends Record<string, unknown>>(\n\tinput: CompileInput<TState>,\n): RegisteredFlow {\n\tconst { config, nodes, edges } = input;\n\tconst protocol = buildFlowProtocol(config);\n\tconst fullDescription = `${config.description}\\n${protocol}`;\n\n\t// Validator storage — populated when handlers return interrupts with validate functions.\n\t// Keyed by \"nodeName:fieldName\", persists across tool calls within the same server.\n\tconst validators = new Map<string, ValidateFn>();\n\n\tasync function handleToolCall(\n\t\targs: FlowToolInput,\n\t\tmeta?: Record<string, unknown>,\n\t): Promise<ExecutionResult> {\n\t\tconst inputMeta = getInputMeta(args);\n\t\tconst state = inputMeta.state as TState;\n\n\t\tif (args.action === \"start\") {\n\t\t\tconst startEdge = edges.get(START);\n\t\t\tif (!startEdge) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: \"No start edge\",\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Merge pre-filled answers and any stateUpdates\n\t\t\tconst startState = {\n\t\t\t\t...state,\n\t\t\t\t...(args.stateUpdates ?? {}),\n\t\t\t} as TState;\n\n\t\t\tconst firstNode = await resolveNextNode(startEdge, startState);\n\t\t\treturn executeFrom(firstNode, startState, nodes, edges, validators, meta);\n\t\t}\n\n\t\tif (args.action === \"continue\") {\n\t\t\tconst step = inputMeta.step;\n\t\t\tif (!step) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t'Missing or invalid \"flowToken\" for continue action.' +\n\t\t\t\t\t\t\t\" Pass back the flowToken from the previous response exactly as received.\",\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet updatedState = {\n\t\t\t\t...state,\n\t\t\t\t...(args.stateUpdates ?? {}),\n\t\t\t} as TState;\n\n\t\t\t// If cached interrupt questions exist, check for unanswered questions\n\t\t\t// without re-executing the node handler (avoids side-effect replay).\n\t\t\tif (inputMeta.questions) {\n\t\t\t\tconst interruptResult = buildInterruptResult(\n\t\t\t\t\tinputMeta.questions,\n\t\t\t\t\tinputMeta.interruptContext,\n\t\t\t\t\tstep,\n\t\t\t\t\tupdatedState,\n\t\t\t\t);\n\n\t\t\t\t// results = the user has not answered all questions\n\t\t\t\tif (interruptResult) {\n\t\t\t\t\treturn interruptResult;\n\t\t\t\t}\n\n\t\t\t\t// All questions answered — run validators before advancing\n\t\t\t\tconst fieldValidators = inputMeta.questions\n\t\t\t\t\t.map((q) => ({\n\t\t\t\t\t\tfield: q.field,\n\t\t\t\t\t\tfn: validators.get(`${step}:${q.field}`),\n\t\t\t\t\t}))\n\t\t\t\t\t.filter((v): v is { field: string; fn: ValidateFn } => v.fn != null);\n\n\t\t\t\tfor (const { field, fn } of fieldValidators) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst value = updatedState[field as keyof TState];\n\t\t\t\t\t\tconst vResult = await fn(value);\n\t\t\t\t\t\tif (vResult && typeof vResult === \"object\") {\n\t\t\t\t\t\t\tupdatedState = {\n\t\t\t\t\t\t\t\t...updatedState,\n\t\t\t\t\t\t\t\t...vResult,\n\t\t\t\t\t\t\t} as TState;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\t// Validation failed — clear field and re-present interrupt\n\t\t\t\t\t\tconst msg = err instanceof Error ? err.message : String(err);\n\t\t\t\t\t\tdelete (updatedState as Record<string, unknown>)[field];\n\t\t\t\t\t\t// Prepend error to the specific question's context so it's visible\n\t\t\t\t\t\t// even when the question has its own context (which takes precedence\n\t\t\t\t\t\t// over the overall interrupt context in single-question shorthand).\n\t\t\t\t\t\tconst questionsWithError = inputMeta.questions.map((q) =>\n\t\t\t\t\t\t\tq.field === field\n\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\t...q,\n\t\t\t\t\t\t\t\t\t\tcontext: q.context\n\t\t\t\t\t\t\t\t\t\t\t? `ERROR: ${msg}\\n\\n${q.context}`\n\t\t\t\t\t\t\t\t\t\t\t: `ERROR: ${msg}`,\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t: q,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst result = buildInterruptResult(\n\t\t\t\t\t\t\tquestionsWithError,\n\t\t\t\t\t\t\tinputMeta.interruptContext,\n\t\t\t\t\t\t\tstep,\n\t\t\t\t\t\t\tupdatedState,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (result) return result;\n\t\t\t\t\t\t// Should never happen — we just cleared the field\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Advance to next node when: all cached questions are answered, or\n\t\t\t// this is a widget continue (widgets never have cached questions and\n\t\t\t// re-executing the handler would cause a stuck loop for field-less widgets).\n\t\t\t// Otherwise the AI may have dropped _meta.flow.questions — re-execute\n\t\t\t// from the current step so the handler can re-check unanswered questions.\n\t\t\tif (inputMeta.questions || inputMeta.widgetId) {\n\t\t\t\tconst edge = edges.get(step);\n\t\t\t\tif (!edge) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: {\n\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\terror: `No edge from step \"${step}\"`,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst nextNode = await resolveNextNode(edge, updatedState);\n\t\t\t\treturn executeFrom(\n\t\t\t\t\tnextNode,\n\t\t\t\t\tupdatedState,\n\t\t\t\t\tnodes,\n\t\t\t\t\tedges,\n\t\t\t\t\tvalidators,\n\t\t\t\t\tmeta,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn executeFrom(step, updatedState, nodes, edges, validators, meta);\n\t\t}\n\n\t\treturn {\n\t\t\tcontent: {\n\t\t\t\tstatus: \"error\",\n\t\t\t\terror: `Unknown action: \"${args.action}\"`,\n\t\t\t},\n\t\t};\n\t}\n\n\treturn {\n\t\tid: config.id,\n\t\ttitle: config.title,\n\t\tdescription: fullDescription,\n\n\t\tasync register(server: McpServer): Promise<void> {\n\t\t\tserver.registerTool(\n\t\t\t\tconfig.id,\n\t\t\t\t{\n\t\t\t\t\ttitle: config.title,\n\t\t\t\t\tdescription: fullDescription,\n\t\t\t\t\tinputSchema,\n\t\t\t\t\tannotations: config.annotations,\n\t\t\t\t},\n\t\t\t\t(async (args: FlowToolInput, extra: unknown) => {\n\t\t\t\t\tconst requestExtra = extra as RequestHandlerExtra<\n\t\t\t\t\t\tServerRequest,\n\t\t\t\t\t\tServerNotification\n\t\t\t\t\t>;\n\t\t\t\t\tconst _meta: Record<string, unknown> = requestExtra._meta ?? {};\n\n\t\t\t\t\tconst result = await handleToolCall(args, _meta);\n\n\t\t\t\t\t// Encode flow state as opaque token for the model to pass back\n\t\t\t\t\tconst flowToken = result.flowTokenContent\n\t\t\t\t\t\t? encodeFlowToken(result.flowTokenContent)\n\t\t\t\t\t\t: undefined;\n\n\t\t\t\t\t// Text content includes the payload + flowToken for the model\n\t\t\t\t\tconst contentResponse: FlowContent = {\n\t\t\t\t\t\t...result.content,\n\t\t\t\t\t\t...(flowToken ? { flowToken } : {}),\n\t\t\t\t\t};\n\t\t\t\t\tconst content = [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\t\ttext: JSON.stringify(contentResponse, null, 2),\n\t\t\t\t\t\t},\n\t\t\t\t\t];\n\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\t_meta,\n\t\t\t\t\t\t...(result.content.status === \"error\" ? { isError: true } : {}),\n\t\t\t\t\t};\n\t\t\t\t}) satisfies ToolCallback<typeof inputSchema>,\n\t\t\t);\n\t\t},\n\t};\n}\n","/**\n * Opaque compressed token for flow state round-tripping.\n *\n * Flow state is compressed (zlib deflate) then base64-encoded. This produces\n * a token that:\n * 1. Looks like random noise — models can't mentally decode it\n * 2. Is smaller than raw base64 (~30% compression on typical state)\n * 3. The model treats it as an opaque string and passes it back unchanged\n *\n * Only encoded/decoded on the server (Node.js). Browser code should never\n * need to decode flow tokens.\n */\n\nimport { deflateSync, inflateSync } from \"node:zlib\";\nimport type { FlowTokenContent } from \"./@types\";\n\nexport function encodeFlowToken(data: FlowTokenContent): string {\n\tconst json = JSON.stringify(data);\n\tconst compressed = deflateSync(json);\n\treturn compressed.toString(\"base64\");\n}\n\nexport function decodeFlowToken(token: string): FlowTokenContent | null {\n\ttry {\n\t\tconst compressed = Buffer.from(token, \"base64\");\n\t\tconst json = inflateSync(compressed).toString(\"utf-8\");\n\t\treturn JSON.parse(json) as FlowTokenContent;\n\t} catch {\n\t\treturn null;\n\t}\n}\n","import type {\n\tConditionFn,\n\tEdge,\n\tFlowConfig,\n\tNodeHandler,\n\tRegisteredFlow,\n} from \"./@types\";\nimport { END, START } from \"./@types\";\nimport { compileFlow } from \"./compile\";\n\n/**\n * A LangGraph-inspired state graph builder for MCP tools.\n *\n * @example\n * ```ts\n * const flow = new StateGraph<MyState>({\n *   id: \"onboarding\",\n *   title: \"User Onboarding\",\n *   description: \"Guides users through onboarding\",\n * })\n *   .addNode(\"ask_name\", ({ interrupt }) => interrupt({ question: \"What's your name?\", field: \"name\" }))\n *   .addNode(\"greet\", ({ state }) => ({ greeting: `Hello ${state.name}!` }))\n *   .addEdge(START, \"ask_name\")\n *   .addEdge(\"ask_name\", \"greet\")\n *   .addEdge(\"greet\", END)\n *   .compile();\n * ```\n */\nexport class StateGraph<TState extends Record<string, unknown>> {\n\tprivate nodes = new Map<string, NodeHandler<TState>>();\n\tprivate edges = new Map<string, Edge<TState>>();\n\tprivate config: FlowConfig;\n\n\tconstructor(config: FlowConfig) {\n\t\tthis.config = config;\n\t}\n\n\t/**\n\t * Add a node with a handler.\n\t *\n\t * The handler receives a context object with `state`, `meta`, `interrupt`, and `showWidget`.\n\t */\n\taddNode(name: string, handler: NodeHandler<TState>): this {\n\t\tif (name === START || name === END) {\n\t\t\tthrow new Error(\n\t\t\t\t`\"${name}\" is a reserved name and cannot be used as a node name`,\n\t\t\t);\n\t\t}\n\t\tif (this.nodes.has(name)) {\n\t\t\tthrow new Error(`Node \"${name}\" already exists`);\n\t\t}\n\n\t\tthis.nodes.set(name, handler);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Add a direct edge between two nodes.\n\t *\n\t * Use `START` as `from` to set the entry point.\n\t * Use `END` as `to` to mark a terminal node.\n\t */\n\taddEdge(from: string, to: string): this {\n\t\tif (this.edges.has(from)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Node \"${from}\" already has an outgoing edge. Use addConditionalEdge for branching.`,\n\t\t\t);\n\t\t}\n\t\tthis.edges.set(from, { type: \"direct\", to });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Add a conditional edge from a node.\n\t *\n\t * The condition function receives current state and returns the name of the next node.\n\t */\n\taddConditionalEdge(from: string, condition: ConditionFn<TState>): this {\n\t\tif (this.edges.has(from)) {\n\t\t\tthrow new Error(`Node \"${from}\" already has an outgoing edge.`);\n\t\t}\n\t\tthis.edges.set(from, { type: \"conditional\", condition });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Compile the graph into a RegisteredFlow that can be registered on an McpServer.\n\t *\n\t * Validates the graph structure and returns a registration-compatible object.\n\t */\n\tcompile(): RegisteredFlow {\n\t\tthis.validate();\n\n\t\treturn compileFlow<TState>({\n\t\t\tconfig: this.config,\n\t\t\tnodes: new Map(this.nodes),\n\t\t\tedges: new Map(this.edges),\n\t\t});\n\t}\n\n\tprivate validate(): void {\n\t\t// Must have a START edge\n\t\tif (!this.edges.has(START)) {\n\t\t\tthrow new Error(\n\t\t\t\t'Flow must have an entry point. Add an edge from START: .addEdge(START, \"first_node\")',\n\t\t\t);\n\t\t}\n\n\t\t// START edge target must exist\n\t\tconst startEdge = this.edges.get(START);\n\t\tif (\n\t\t\tstartEdge?.type === \"direct\" &&\n\t\t\tstartEdge.to !== END &&\n\t\t\t!this.nodes.has(startEdge.to)\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t`START edge references non-existent node: \"${startEdge.to}\"`,\n\t\t\t);\n\t\t}\n\n\t\t// All static edge targets must reference existing nodes (or END)\n\t\tfor (const [from, edge] of this.edges) {\n\t\t\tif (from !== START && !this.nodes.has(from)) {\n\t\t\t\tthrow new Error(`Edge from non-existent node: \"${from}\"`);\n\t\t\t}\n\t\t\tif (\n\t\t\t\tedge.type === \"direct\" &&\n\t\t\t\tedge.to !== END &&\n\t\t\t\t!this.nodes.has(edge.to)\n\t\t\t) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Edge from \"${from}\" references non-existent node: \"${edge.to}\"`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\t// Every node must have an outgoing edge\n\t\tfor (const [name] of this.nodes) {\n\t\t\tif (!this.edges.has(name)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Node \"${name}\" has no outgoing edge. Add one with .addEdge(\"${name}\", ...) or .addConditionalEdge(\"${name}\", ...)`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n}\n","import type { z } from \"zod\";\nimport type { FlowConfig, InferFlowState } from \"./@types\";\nimport { StateGraph } from \"./state-graph\";\n\n/**\n * Create a new flow graph — convenience factory for `new StateGraph()`.\n *\n * The state type is automatically inferred from the `state` definition —\n * no explicit generic parameter needed.\n *\n * @example\n * ```ts\n * import { createFlow, interrupt, START, END } from \"@waniwani/sdk/mcp\";\n * import { z } from \"zod\";\n *\n * const flow = createFlow({\n *   id: \"onboarding\",\n *   title: \"User Onboarding\",\n *   description: \"Guides users through onboarding. Use when a user wants to get started.\",\n *   state: {\n *     name: z.string().describe(\"The user's name\"),\n *     email: z.string().describe(\"The user's email address\"),\n *   },\n * })\n *   .addNode(\"ask_name\", () => interrupt({ question: \"What's your name?\", field: \"name\" }))\n *   .addNode(\"ask_email\", () => interrupt({ question: \"What's your email?\", field: \"email\" }))\n *   .addEdge(START, \"ask_name\")\n *   .addEdge(\"ask_name\", \"ask_email\")\n *   .addEdge(\"ask_email\", END)\n *   .compile();\n * ```\n */\nexport function createFlow<const TSchema extends Record<string, z.ZodType>>(\n\tconfig: Omit<FlowConfig, \"state\"> & { state: TSchema },\n): StateGraph<InferFlowState<TSchema>> {\n\treturn new StateGraph<InferFlowState<TSchema>>(config);\n}\n","import type { WidgetCSP } from \"./types\";\n\n/**\n * MIME types for widget resources.\n * OpenAI Apps SDK uses \"text/html+skybridge\"\n * MCP Apps uses \"text/html;profile=mcp-app\"\n */\nexport const MIME_TYPE_OPENAI = \"text/html+skybridge\";\nexport const MIME_TYPE_MCP = \"text/html;profile=mcp-app\";\n\n// ---- HTML fetching ----\n\nexport const fetchHtml = async (\n\tbaseUrl: string,\n\tpath: string,\n): Promise<string> => {\n\tconst normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n\tconst result = await fetch(`${normalizedBase}${path}`);\n\treturn await result.text();\n};\n\n// ---- OpenAI resource metadata ----\n\ninterface OpenAIResourceMeta {\n\t[key: string]: unknown;\n\t\"openai/widgetDescription\"?: string;\n\t\"openai/widgetPrefersBorder\"?: boolean;\n\t\"openai/widgetDomain\"?: string;\n\t\"openai/widgetCSP\"?: WidgetCSP;\n}\n\nexport function buildOpenAIResourceMeta(config: {\n\tdescription?: string;\n\tprefersBorder?: boolean;\n\twidgetDomain: string;\n\twidgetCSP?: WidgetCSP;\n}): OpenAIResourceMeta {\n\treturn {\n\t\t\"openai/widgetDescription\": config.description,\n\t\t\"openai/widgetPrefersBorder\": config.prefersBorder,\n\t\t\"openai/widgetDomain\": config.widgetDomain,\n\t\t...(config.widgetCSP && { \"openai/widgetCSP\": config.widgetCSP }),\n\t};\n}\n\n// ---- MCP Apps resource metadata ----\n\ninterface McpAppsResourceMeta {\n\t[key: string]: unknown;\n\tui?: {\n\t\tcsp?: {\n\t\t\tconnectDomains?: string[];\n\t\t\tresourceDomains?: string[];\n\t\t\tframeDomains?: string[];\n\t\t\tredirectDomains?: string[];\n\t\t};\n\t\tdomain?: string;\n\t\tprefersBorder?: boolean;\n\t};\n}\n\nexport function buildMcpAppsResourceMeta(config: {\n\tdescription?: string;\n\tprefersBorder?: boolean;\n\twidgetDomain?: string;\n\twidgetCSP?: WidgetCSP;\n}): McpAppsResourceMeta {\n\tconst csp = config.widgetCSP\n\t\t? {\n\t\t\t\tconnectDomains: config.widgetCSP.connect_domains,\n\t\t\t\tresourceDomains: config.widgetCSP.resource_domains,\n\t\t\t\tframeDomains: config.widgetCSP.frame_domains,\n\t\t\t\tredirectDomains: config.widgetCSP.redirect_domains,\n\t\t\t}\n\t\t: undefined;\n\n\treturn {\n\t\tui: {\n\t\t\t...(csp && { csp }),\n\t\t\t...(config.widgetDomain && { domain: config.widgetDomain }),\n\t\t\t...(config.prefersBorder !== undefined && {\n\t\t\t\tprefersBorder: config.prefersBorder,\n\t\t\t}),\n\t\t},\n\t};\n}\n\n// ---- Tool metadata (references resource URIs) ----\n\nexport function buildToolMeta(config: {\n\topenaiTemplateUri?: string;\n\tmcpTemplateUri?: string;\n\tinvoking: string;\n\tinvoked: string;\n\tautoHeight?: boolean;\n}) {\n\treturn {\n\t\t// OpenAI metadata\n\t\t...(config.openaiTemplateUri && {\n\t\t\t\"openai/outputTemplate\": config.openaiTemplateUri,\n\t\t}),\n\t\t\"openai/toolInvocation/invoking\": config.invoking,\n\t\t\"openai/toolInvocation/invoked\": config.invoked,\n\t\t\"openai/widgetAccessible\": true,\n\t\t\"openai/resultCanProduceWidget\": true,\n\t\t// MCP Apps metadata\n\t\t...(config.mcpTemplateUri && {\n\t\t\tui: {\n\t\t\t\tresourceUri: config.mcpTemplateUri,\n\t\t\t\t...(config.autoHeight && { autoHeight: true }),\n\t\t\t},\n\t\t}),\n\t};\n}\n","import {\n\tbuildMcpAppsResourceMeta,\n\tbuildOpenAIResourceMeta,\n\tfetchHtml,\n\tMIME_TYPE_MCP,\n\tMIME_TYPE_OPENAI,\n} from \"./meta\";\nimport type { McpServer, RegisteredResource, ResourceConfig } from \"./types\";\n\n/**\n * Creates a reusable UI resource (HTML template) that can be attached\n * to tools or flow nodes.\n *\n * @example\n * ```ts\n * const pricingUI = createResource({\n *   id: \"pricing_table\",\n *   title: \"Pricing Table\",\n *   baseUrl: \"https://my-app.com\",\n *   htmlPath: \"/widgets/pricing\",\n *   widgetDomain: \"my-app.com\",\n * });\n *\n * await pricingUI.register(server);\n * ```\n */\nexport function createResource(config: ResourceConfig): RegisteredResource {\n\tconst {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\t\tbaseUrl,\n\t\thtmlPath,\n\t\twidgetDomain,\n\t\tprefersBorder = true,\n\t\tautoHeight = true,\n\t} = config;\n\n\t// Auto-generate CSP from baseUrl if not explicitly provided\n\tlet widgetCSP = config.widgetCSP ?? {\n\t\tconnect_domains: [baseUrl],\n\t\tresource_domains: [baseUrl],\n\t};\n\n\t// In development with localhost, add extra CSP domains for\n\t// Next.js dev features (WebSocket HMR, Turbopack font serving)\n\tif (process.env.NODE_ENV === \"development\") {\n\t\ttry {\n\t\t\tconst { hostname } = new URL(baseUrl);\n\t\t\tif (hostname === \"localhost\" || hostname === \"127.0.0.1\") {\n\t\t\t\twidgetCSP = {\n\t\t\t\t\t...widgetCSP,\n\t\t\t\t\tconnect_domains: [\n\t\t\t\t\t\t...(widgetCSP.connect_domains || []),\n\t\t\t\t\t\t`ws://${hostname}:*`,\n\t\t\t\t\t\t`wss://${hostname}:*`,\n\t\t\t\t\t],\n\t\t\t\t\tresource_domains: [\n\t\t\t\t\t\t...(widgetCSP.resource_domains || []),\n\t\t\t\t\t\t`http://${hostname}:*`,\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t} catch {\n\t\t\t// Invalid baseUrl — skip dev CSP additions\n\t\t}\n\t}\n\n\tconst openaiUri = `ui://widgets/apps-sdk/${id}.html`;\n\tconst mcpUri = `ui://widgets/ext-apps/${id}.html`;\n\n\t// Lazy HTML — fetched once, shared across all calls\n\tlet htmlPromise: Promise<string> | null = null;\n\tconst getHtml = () => {\n\t\tif (!htmlPromise) htmlPromise = fetchHtml(baseUrl, htmlPath);\n\t\treturn htmlPromise;\n\t};\n\n\t// Use description for UI metadata\n\tconst uiDescription = description;\n\n\tasync function register(server: McpServer): Promise<void> {\n\t\tconst html = await getHtml();\n\n\t\t// Register OpenAI Apps SDK resource\n\t\tserver.registerResource(\n\t\t\t`${id}-openai-widget`,\n\t\t\topenaiUri,\n\t\t\t{\n\t\t\t\ttitle,\n\t\t\t\tdescription: uiDescription,\n\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t_meta: {\n\t\t\t\t\t\"openai/widgetDescription\": uiDescription,\n\t\t\t\t\t\"openai/widgetPrefersBorder\": prefersBorder,\n\t\t\t\t},\n\t\t\t},\n\t\t\tasync (uri) => ({\n\t\t\t\tcontents: [\n\t\t\t\t\t{\n\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t_meta: buildOpenAIResourceMeta({\n\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\twidgetDomain,\n\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\n\t\t// Register MCP Apps resource\n\t\tserver.registerResource(\n\t\t\t`${id}-mcp-widget`,\n\t\t\tmcpUri,\n\t\t\t{\n\t\t\t\ttitle,\n\t\t\t\tdescription: uiDescription,\n\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t_meta: {\n\t\t\t\t\tui: {\n\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t\tasync (uri) => ({\n\t\t\t\tcontents: [\n\t\t\t\t\t{\n\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t_meta: buildMcpAppsResourceMeta({\n\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\treturn {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\t\topenaiUri,\n\t\tmcpUri,\n\t\tautoHeight,\n\t\tregister,\n\t};\n}\n","import type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { ShapeOutput } from \"@modelcontextprotocol/sdk/server/zod-compat.js\";\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n\tServerNotification,\n\tServerRequest,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { z } from \"zod\";\nimport { buildToolMeta } from \"../resources/meta\";\nimport type {\n\tMcpServer,\n\tRegisteredTool,\n\tToolConfig,\n\tToolHandler,\n} from \"./types\";\n\n/**\n * Creates an MCP tool with minimal boilerplate.\n *\n * When `handler()` returns `data`, the tool includes it as MCP `structuredContent`.\n * When `config.resource` is provided, the tool also returns widget metadata.\n *\n * @example\n * ```ts\n * // Widget tool (with resource)\n * const pricingTool = createTool({\n *   resource: pricingUI,\n *   description: \"Show pricing comparison\",\n *   inputSchema: { postalCode: z.string() },\n * }, async ({ postalCode }) => ({\n *   text: \"Pricing loaded\",\n *   data: { postalCode, prices: [] },\n * }));\n *\n * // Plain tool (no resource)\n * const searchTool = createTool({\n *   id: \"search\",\n *   title: \"Search\",\n *   description: \"Search the knowledge base\",\n *   inputSchema: { query: z.string() },\n * }, async ({ query }) => ({\n *   text: `Results for \"${query}\"`,\n * }));\n * ```\n */\nexport function createTool<TInput extends z.ZodRawShape>(\n\tconfig: ToolConfig<TInput>,\n\thandler: ToolHandler<TInput>,\n): RegisteredTool {\n\tconst {\n\t\tresource,\n\t\tdescription,\n\t\tinputSchema,\n\t\tannotations,\n\t\tautoInjectResultText = true,\n\t} = config;\n\n\tconst id = config.id ?? resource?.id;\n\tconst title = config.title ?? resource?.title;\n\n\tif (!id) {\n\t\tthrow new Error(\n\t\t\t\"createTool: `id` is required when no resource is provided\",\n\t\t);\n\t}\n\tif (!title) {\n\t\tthrow new Error(\n\t\t\t\"createTool: `title` is required when no resource is provided\",\n\t\t);\n\t}\n\n\t// Build widget metadata only when resource is present\n\tconst toolMeta = resource\n\t\t? buildToolMeta({\n\t\t\t\topenaiTemplateUri: resource.openaiUri,\n\t\t\t\tmcpTemplateUri: resource.mcpUri,\n\t\t\t\tinvoking: config.invoking ?? \"Loading...\",\n\t\t\t\tinvoked: config.invoked ?? \"Loaded\",\n\t\t\t\tautoHeight: resource.autoHeight,\n\t\t\t})\n\t\t: undefined;\n\n\treturn {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\n\t\tasync register(server: McpServer): Promise<void> {\n\t\t\tserver.registerTool(\n\t\t\t\tid,\n\t\t\t\t{\n\t\t\t\t\ttitle,\n\t\t\t\t\tdescription,\n\t\t\t\t\tinputSchema,\n\t\t\t\t\tannotations,\n\t\t\t\t\t...(toolMeta && { _meta: toolMeta }),\n\t\t\t\t},\n\t\t\t\t(async (args: ShapeOutput<TInput>, extra: unknown) => {\n\t\t\t\t\tconst requestExtra = extra as RequestHandlerExtra<\n\t\t\t\t\t\tServerRequest,\n\t\t\t\t\t\tServerNotification\n\t\t\t\t\t>;\n\t\t\t\t\tconst _meta: Record<string, unknown> = requestExtra._meta ?? {};\n\n\t\t\t\t\tconst result = await handler(args, { extra: { _meta } });\n\n\t\t\t\t\t// Widget tool: return structuredContent + widget metadata\n\t\t\t\t\tif (resource && result.data) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: result.text }],\n\t\t\t\t\t\t\tstructuredContent: result.data,\n\t\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t\t...toolMeta,\n\t\t\t\t\t\t\t\t..._meta,\n\t\t\t\t\t\t\t\t...(autoInjectResultText === false\n\t\t\t\t\t\t\t\t\t? { \"waniwani/autoInjectResultText\": false }\n\t\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Plain tool: return text content, plus structuredContent when provided.\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: result.text }],\n\t\t\t\t\t\t...(result.data ? { structuredContent: result.data } : {}),\n\t\t\t\t\t\t...(autoInjectResultText === false\n\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t\t\t\t\"waniwani/autoInjectResultText\": false,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t};\n\t\t\t\t}) as unknown as ToolCallback<TInput>,\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * Registers multiple tools on the server\n */\nexport async function registerTools(\n\tserver: McpServer,\n\ttools: RegisteredTool[],\n): Promise<void> {\n\tawait Promise.all(tools.map((t) => t.register(server)));\n}\n","// WaniWani SDK - Errors\n\nexport class WaniWaniError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"WaniWaniError\";\n\t}\n}\n","// KB Client — thin HTTP wrapper for knowledge base API\n\nimport { WaniWaniError } from \"../error.js\";\nimport type { InternalConfig } from \"../types.js\";\nimport type {\n\tKbClient,\n\tKbIngestFile,\n\tKbIngestResult,\n\tKbSearchOptions,\n\tKbSource,\n\tSearchResult,\n} from \"./types.js\";\n\nconst SDK_NAME = \"@waniwani/sdk\";\n\nexport function createKbClient(config: InternalConfig): KbClient {\n\tconst { baseUrl, apiKey } = config;\n\n\tfunction requireApiKey(): string {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t\treturn apiKey;\n\t}\n\n\tasync function request<T>(\n\t\tmethod: \"GET\" | \"POST\",\n\t\tpath: string,\n\t\tbody?: unknown,\n\t): Promise<T> {\n\t\tconst key = requireApiKey();\n\t\tconst url = `${baseUrl.replace(/\\/$/, \"\")}${path}`;\n\n\t\tconst headers: Record<string, string> = {\n\t\t\tAuthorization: `Bearer ${key}`,\n\t\t\t\"X-WaniWani-SDK\": SDK_NAME,\n\t\t};\n\n\t\tconst init: RequestInit = { method, headers };\n\n\t\tif (body !== undefined) {\n\t\t\theaders[\"Content-Type\"] = \"application/json\";\n\t\t\tinit.body = JSON.stringify(body);\n\t\t}\n\n\t\tconst response = await fetch(url, init);\n\n\t\tif (!response.ok) {\n\t\t\tconst text = await response.text().catch(() => \"\");\n\t\t\tthrow new WaniWaniError(\n\t\t\t\ttext || `KB API error: HTTP ${response.status}`,\n\t\t\t\tresponse.status,\n\t\t\t);\n\t\t}\n\n\t\tconst json = (await response.json()) as { data: T };\n\t\treturn json.data;\n\t}\n\n\treturn {\n\t\tasync ingest(files: KbIngestFile[]): Promise<KbIngestResult> {\n\t\t\treturn request<KbIngestResult>(\"POST\", \"/api/mcp/kb/ingest\", {\n\t\t\t\tfiles,\n\t\t\t});\n\t\t},\n\n\t\tasync search(\n\t\t\tquery: string,\n\t\t\toptions?: KbSearchOptions,\n\t\t): Promise<SearchResult[]> {\n\t\t\treturn request<SearchResult[]>(\"POST\", \"/api/mcp/kb/search\", {\n\t\t\t\tquery,\n\t\t\t\t...options,\n\t\t\t});\n\t\t},\n\n\t\tasync sources(): Promise<KbSource[]> {\n\t\t\treturn request<KbSource[]>(\"GET\", \"/api/mcp/kb/sources\");\n\t\t},\n\t};\n}\n","import type { EventType, LegacyTrackEvent, TrackInput } from \"./@types.js\";\nimport type { V2CorrelationIds, V2EventEnvelope } from \"./v2-types.js\";\n\nconst DEFAULT_SOURCE = \"@waniwani/sdk\";\n\nexport interface MapTrackEventOptions {\n\tnow?: () => Date;\n\tgenerateId?: () => string;\n\tsource?: string;\n}\n\nexport function mapTrackEventToV2(\n\tinput: TrackInput,\n\toptions: MapTrackEventOptions = {},\n): V2EventEnvelope {\n\tconst now = options.now ?? (() => new Date());\n\tconst generateId = options.generateId ?? createEventId;\n\tconst eventName = resolveEventName(input);\n\tconst meta = toRecord(input.meta);\n\tconst metadata = toRecord(input.metadata);\n\tconst correlation = resolveCorrelationIds(input, meta);\n\tconst eventId = takeNonEmptyString(input.eventId) ?? generateId();\n\tconst timestamp = normalizeTimestamp(input.timestamp, now);\n\tconst source =\n\t\ttakeNonEmptyString(input.source) ?? options.source ?? DEFAULT_SOURCE;\n\tconst rawLegacy = isLegacyTrackEvent(input) ? { ...input } : undefined;\n\n\tconst mappedMetadata: Record<string, unknown> = {\n\t\t...metadata,\n\t};\n\tif (Object.keys(meta).length > 0) mappedMetadata.meta = meta;\n\tif (rawLegacy) mappedMetadata.rawLegacy = rawLegacy;\n\n\treturn {\n\t\tid: eventId,\n\t\ttype: \"mcp.event\",\n\t\tname: eventName,\n\t\tsource,\n\t\ttimestamp,\n\t\tcorrelation,\n\t\tproperties: mapProperties(input, eventName),\n\t\tmetadata: mappedMetadata,\n\t\trawLegacy,\n\t};\n}\n\nexport function createEventId(): string {\n\tif (\n\t\ttypeof crypto !== \"undefined\" &&\n\t\ttypeof crypto.randomUUID === \"function\"\n\t) {\n\t\treturn `evt_${crypto.randomUUID()}`;\n\t}\n\n\treturn `evt_${Math.random().toString(36).slice(2, 10)}_${Date.now().toString(36)}`;\n}\n\nfunction mapProperties(\n\tinput: TrackInput,\n\teventName: EventType,\n): Record<string, unknown> {\n\tif (!isLegacyTrackEvent(input)) {\n\t\treturn toRecord(input.properties);\n\t}\n\n\tconst legacyProperties = mapLegacyProperties(input, eventName);\n\tconst explicitProperties = toRecord(input.properties);\n\treturn {\n\t\t...legacyProperties,\n\t\t...explicitProperties,\n\t};\n}\n\nfunction mapLegacyProperties(\n\tinput: LegacyTrackEvent,\n\teventName: EventType,\n): Record<string, unknown> {\n\tswitch (eventName) {\n\t\tcase \"tool.called\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (takeNonEmptyString(input.toolName)) properties.name = input.toolName;\n\t\t\tif (takeNonEmptyString(input.toolType)) properties.type = input.toolType;\n\t\t\treturn properties;\n\t\t}\n\t\tcase \"quote.succeeded\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (typeof input.quoteAmount === \"number\") {\n\t\t\t\tproperties.amount = input.quoteAmount;\n\t\t\t}\n\t\t\tif (takeNonEmptyString(input.quoteCurrency)) {\n\t\t\t\tproperties.currency = input.quoteCurrency;\n\t\t\t}\n\t\t\treturn properties;\n\t\t}\n\t\tcase \"link.clicked\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (takeNonEmptyString(input.linkUrl)) properties.url = input.linkUrl;\n\t\t\treturn properties;\n\t\t}\n\t\tcase \"purchase.completed\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (typeof input.purchaseAmount === \"number\") {\n\t\t\t\tproperties.amount = input.purchaseAmount;\n\t\t\t}\n\t\t\tif (takeNonEmptyString(input.purchaseCurrency)) {\n\t\t\t\tproperties.currency = input.purchaseCurrency;\n\t\t\t}\n\t\t\treturn properties;\n\t\t}\n\t\tdefault:\n\t\t\treturn {};\n\t}\n}\n\nfunction resolveEventName(input: TrackInput): EventType {\n\tif (isLegacyTrackEvent(input)) return input.eventType;\n\treturn input.event;\n}\n\nfunction resolveCorrelationIds(\n\tinput: TrackInput,\n\tmeta: Record<string, unknown>,\n): V2CorrelationIds {\n\tconst requestId =\n\t\ttakeNonEmptyString(input.requestId) ??\n\t\tpickFirstString(meta, [\"openai/requestId\", \"requestId\", \"mcp/requestId\"]);\n\n\tconst sessionId =\n\t\ttakeNonEmptyString(input.sessionId) ??\n\t\tpickFirstString(meta, [\n\t\t\t\"openai/sessionId\",\n\t\t\t\"sessionId\",\n\t\t\t\"conversationId\",\n\t\t\t\"anthropic/sessionId\",\n\t\t]);\n\n\tconst traceId =\n\t\ttakeNonEmptyString(input.traceId) ??\n\t\tpickFirstString(meta, [\n\t\t\t\"openai/traceId\",\n\t\t\t\"traceId\",\n\t\t\t\"mcp/traceId\",\n\t\t\t\"openai/requestId\",\n\t\t\t\"requestId\",\n\t\t]);\n\n\tconst externalUserId =\n\t\ttakeNonEmptyString(input.externalUserId) ??\n\t\tpickFirstString(meta, [\n\t\t\t\"openai/userId\",\n\t\t\t\"externalUserId\",\n\t\t\t\"userId\",\n\t\t\t\"actorId\",\n\t\t]);\n\n\tconst correlationId =\n\t\ttakeNonEmptyString(input.correlationId) ??\n\t\tpickFirstString(meta, [\"correlationId\", \"openai/requestId\"]) ??\n\t\trequestId;\n\n\tconst correlation: V2CorrelationIds = {};\n\tif (sessionId) correlation.sessionId = sessionId;\n\tif (traceId) correlation.traceId = traceId;\n\tif (requestId) correlation.requestId = requestId;\n\tif (correlationId) correlation.correlationId = correlationId;\n\tif (externalUserId) correlation.externalUserId = externalUserId;\n\treturn correlation;\n}\n\nfunction normalizeTimestamp(\n\tinput: string | Date | undefined,\n\tnow: () => Date,\n): string {\n\tif (input instanceof Date) return input.toISOString();\n\tif (typeof input === \"string\") {\n\t\tconst date = new Date(input);\n\t\tif (!Number.isNaN(date.getTime())) return date.toISOString();\n\t}\n\treturn now().toISOString();\n}\n\nfunction pickFirstString(\n\trecord: Record<string, unknown>,\n\tkeys: readonly string[],\n): string | undefined {\n\tfor (const key of keys) {\n\t\tconst value = record[key];\n\t\tif (typeof value === \"string\" && value.trim().length > 0) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction toRecord(value: unknown): Record<string, unknown> {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\treturn {};\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction takeNonEmptyString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tif (value.trim().length === 0) return undefined;\n\treturn value;\n}\n\nfunction isLegacyTrackEvent(input: TrackInput): input is LegacyTrackEvent {\n\treturn \"eventType\" in input;\n}\n","import type {\n\tTrackingShutdownOptions,\n\tTrackingShutdownResult,\n} from \"./@types.js\";\nimport type {\n\tV2BatchRejectedEvent,\n\tV2BatchRequest,\n\tV2BatchResponse,\n\tV2EventEnvelope,\n} from \"./v2-types.js\";\n\nconst DEFAULT_ENDPOINT_PATH = \"/api/mcp/events/v2/batch\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 1_000;\nconst DEFAULT_MAX_BATCH_SIZE = 20;\nconst DEFAULT_MAX_BUFFER_SIZE = 1_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_RETRY_BASE_DELAY_MS = 200;\nconst DEFAULT_RETRY_MAX_DELAY_MS = 2_000;\nconst DEFAULT_SHUTDOWN_TIMEOUT_MS = 2_000;\nconst SDK_NAME = \"@waniwani/sdk\";\n\nconst AUTH_FAILURE_STATUS = new Set([401, 403]);\nconst RETRYABLE_STATUS = new Set([408, 425, 429, 500, 502, 503, 504]);\n\ninterface Logger {\n\twarn: (message: string, ...args: unknown[]) => void;\n\terror: (message: string, ...args: unknown[]) => void;\n}\n\nexport interface V2TransportOptions {\n\tbaseUrl: string;\n\tapiKey: string;\n\tendpointPath?: string;\n\tflushIntervalMs?: number;\n\tmaxBatchSize?: number;\n\tmaxBufferSize?: number;\n\tmaxRetries?: number;\n\tretryBaseDelayMs?: number;\n\tretryMaxDelayMs?: number;\n\tshutdownTimeoutMs?: number;\n\tsdkVersion?: string;\n\tfetchFn?: typeof fetch;\n\tlogger?: Logger;\n\tnow?: () => Date;\n\tsleep?: (delayMs: number) => Promise<void>;\n}\n\nexport interface V2BatchTransport {\n\tenqueue: (event: V2EventEnvelope) => void;\n\tflush: () => Promise<void>;\n\tshutdown: (\n\t\toptions?: TrackingShutdownOptions,\n\t) => Promise<TrackingShutdownResult>;\n\tpendingEvents: () => number;\n}\n\ntype SendBatchResult =\n\t| { kind: \"success\" }\n\t| { kind: \"retryable\"; reason: string }\n\t| { kind: \"permanent\"; reason: string }\n\t| { kind: \"auth\"; status: number }\n\t| {\n\t\t\tkind: \"partial\";\n\t\t\tretryable: V2EventEnvelope[];\n\t\t\tpermanent: V2EventEnvelope[];\n\t  };\n\nexport function createV2BatchTransport(\n\toptions: V2TransportOptions,\n): V2BatchTransport {\n\treturn new BatchingV2Transport(options);\n}\n\nclass BatchingV2Transport implements V2BatchTransport {\n\tprivate readonly endpointUrl: string;\n\tprivate readonly flushIntervalMs: number;\n\tprivate readonly maxBatchSize: number;\n\tprivate readonly maxBufferSize: number;\n\tprivate readonly maxRetries: number;\n\tprivate readonly retryBaseDelayMs: number;\n\tprivate readonly retryMaxDelayMs: number;\n\tprivate readonly shutdownTimeoutMs: number;\n\tprivate readonly sdkVersion?: string;\n\tprivate readonly fetchFn: typeof fetch;\n\tprivate readonly logger: Logger;\n\tprivate readonly now: () => Date;\n\tprivate readonly sleep: (delayMs: number) => Promise<void>;\n\tprivate readonly apiKey: string;\n\n\tprivate readonly buffer: V2EventEnvelope[] = [];\n\tprivate flushTimer: ReturnType<typeof setInterval> | undefined;\n\tprivate flushScheduled = false;\n\tprivate flushScheduledTimer: ReturnType<typeof setTimeout> | undefined;\n\tprivate flushInFlight: Promise<void> | undefined;\n\tprivate inFlightCount = 0;\n\tprivate isStopped = false;\n\tprivate isShuttingDown = false;\n\n\tconstructor(options: V2TransportOptions) {\n\t\tthis.endpointUrl = joinUrl(\n\t\t\toptions.baseUrl,\n\t\t\toptions.endpointPath ?? DEFAULT_ENDPOINT_PATH,\n\t\t);\n\t\tthis.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;\n\t\tthis.maxBatchSize = options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;\n\t\tthis.maxBufferSize = options.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;\n\t\tthis.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n\t\tthis.retryBaseDelayMs =\n\t\t\toptions.retryBaseDelayMs ?? DEFAULT_RETRY_BASE_DELAY_MS;\n\t\tthis.retryMaxDelayMs =\n\t\t\toptions.retryMaxDelayMs ?? DEFAULT_RETRY_MAX_DELAY_MS;\n\t\tthis.shutdownTimeoutMs =\n\t\t\toptions.shutdownTimeoutMs ?? DEFAULT_SHUTDOWN_TIMEOUT_MS;\n\t\tthis.fetchFn = options.fetchFn ?? fetch;\n\t\tthis.logger = options.logger ?? console;\n\t\tthis.now = options.now ?? (() => new Date());\n\t\tthis.sleep =\n\t\t\toptions.sleep ??\n\t\t\t((delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)));\n\t\tthis.apiKey = options.apiKey;\n\t\tthis.sdkVersion = options.sdkVersion;\n\n\t\tif (this.flushIntervalMs > 0) {\n\t\t\tthis.flushTimer = setInterval(() => {\n\t\t\t\tvoid this.flush();\n\t\t\t}, this.flushIntervalMs);\n\t\t}\n\t}\n\n\tenqueue(event: V2EventEnvelope): void {\n\t\tif (this.isStopped || this.isShuttingDown) {\n\t\t\tthis.logger.warn(\n\t\t\t\t\"[WaniWani] Tracking transport is stopped, dropping event %s\",\n\t\t\t\tevent.id,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.buffer.length >= this.maxBufferSize) {\n\t\t\tconst dropCount = this.buffer.length - this.maxBufferSize + 1;\n\t\t\tthis.buffer.splice(0, dropCount);\n\t\t\tthis.logger.warn(\n\t\t\t\t\"[WaniWani] Tracking buffer overflow, dropped %d oldest event(s)\",\n\t\t\t\tdropCount,\n\t\t\t);\n\t\t}\n\n\t\tthis.buffer.push(event);\n\n\t\tif (this.buffer.length >= this.maxBatchSize) {\n\t\t\tvoid this.flush();\n\t\t\treturn;\n\t\t}\n\n\t\tthis.scheduleMicroFlush();\n\t}\n\n\tpendingEvents(): number {\n\t\treturn this.buffer.length + this.inFlightCount;\n\t}\n\n\tasync flush(): Promise<void> {\n\t\tif (this.flushInFlight) return this.flushInFlight;\n\t\tthis.flushInFlight = this.flushLoop().finally(() => {\n\t\t\tthis.flushInFlight = undefined;\n\t\t});\n\t\treturn this.flushInFlight;\n\t}\n\n\tasync shutdown(\n\t\toptions?: TrackingShutdownOptions,\n\t): Promise<TrackingShutdownResult> {\n\t\tthis.isShuttingDown = true;\n\t\tif (this.flushTimer) {\n\t\t\tclearInterval(this.flushTimer);\n\t\t\tthis.flushTimer = undefined;\n\t\t}\n\t\tif (this.flushScheduledTimer) {\n\t\t\tclearTimeout(this.flushScheduledTimer);\n\t\t\tthis.flushScheduledTimer = undefined;\n\t\t\tthis.flushScheduled = false;\n\t\t}\n\n\t\tconst timeoutMs = options?.timeoutMs ?? this.shutdownTimeoutMs;\n\t\tconst flushPromise = this.flush();\n\n\t\tif (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n\t\t\tawait flushPromise;\n\t\t\tthis.isStopped = true;\n\t\t\treturn { timedOut: false, pendingEvents: this.pendingEvents() };\n\t\t}\n\n\t\tconst timeoutSignal = Symbol(\"shutdown-timeout\");\n\t\tconst result = await Promise.race([\n\t\t\tflushPromise.then(() => \"flushed\" as const),\n\t\t\tthis.sleep(timeoutMs).then(() => timeoutSignal),\n\t\t]);\n\n\t\tif (result === timeoutSignal) {\n\t\t\tthis.isStopped = true;\n\t\t\treturn { timedOut: true, pendingEvents: this.pendingEvents() };\n\t\t}\n\n\t\tthis.isStopped = true;\n\t\treturn { timedOut: false, pendingEvents: this.pendingEvents() };\n\t}\n\n\tprivate scheduleMicroFlush(): void {\n\t\tif (this.flushScheduled) return;\n\t\tthis.flushScheduled = true;\n\t\tthis.flushScheduledTimer = setTimeout(() => {\n\t\t\tthis.flushScheduledTimer = undefined;\n\t\t\tthis.flushScheduled = false;\n\t\t\tvoid this.flush();\n\t\t}, 0);\n\t}\n\n\tprivate async flushLoop(): Promise<void> {\n\t\twhile (this.buffer.length > 0 && !this.isStopped) {\n\t\t\tconst batch = this.buffer.splice(0, this.maxBatchSize);\n\t\t\tawait this.sendBatchWithRetry(batch);\n\t\t}\n\t}\n\n\tprivate async sendBatchWithRetry(batch: V2EventEnvelope[]): Promise<void> {\n\t\tlet attempt = 0;\n\t\tlet pendingBatch = batch;\n\n\t\twhile (pendingBatch.length > 0 && !this.isStopped) {\n\t\t\tthis.inFlightCount = pendingBatch.length;\n\t\t\tconst result = await this.sendBatchOnce(pendingBatch);\n\t\t\tthis.inFlightCount = 0;\n\n\t\t\tswitch (result.kind) {\n\t\t\t\tcase \"success\":\n\t\t\t\t\treturn;\n\t\t\t\tcase \"auth\":\n\t\t\t\t\tthis.stopTransportForAuthFailure(result.status, pendingBatch.length);\n\t\t\t\t\treturn;\n\t\t\t\tcase \"permanent\":\n\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\"[WaniWani] Dropping %d event(s) after permanent failure: %s\",\n\t\t\t\t\t\tpendingBatch.length,\n\t\t\t\t\t\tresult.reason,\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\tcase \"retryable\":\n\t\t\t\t\tif (attempt >= this.maxRetries) {\n\t\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\t\"[WaniWani] Dropping %d event(s) after retry exhaustion: %s\",\n\t\t\t\t\t\t\tpendingBatch.length,\n\t\t\t\t\t\t\tresult.reason,\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tawait this.sleep(this.backoffDelayMs(attempt));\n\t\t\t\t\tattempt += 1;\n\t\t\t\t\tcontinue;\n\t\t\t\tcase \"partial\":\n\t\t\t\t\tif (result.permanent.length > 0) {\n\t\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\t\"[WaniWani] Dropping %d event(s) rejected as permanent\",\n\t\t\t\t\t\t\tresult.permanent.length,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (result.retryable.length === 0) return;\n\t\t\t\t\tif (attempt >= this.maxRetries) {\n\t\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\t\"[WaniWani] Dropping %d retryable event(s) after retry exhaustion\",\n\t\t\t\t\t\t\tresult.retryable.length,\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tpendingBatch = result.retryable;\n\t\t\t\t\tawait this.sleep(this.backoffDelayMs(attempt));\n\t\t\t\t\tattempt += 1;\n\t\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async sendBatchOnce(\n\t\tevents: V2EventEnvelope[],\n\t): Promise<SendBatchResult> {\n\t\tlet response: Response;\n\n\t\ttry {\n\t\t\tresponse = await this.fetchFn(this.endpointUrl, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${this.apiKey}`,\n\t\t\t\t\t\"X-WaniWani-SDK\": SDK_NAME,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify(this.makeBatchRequest(events)),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tkind: \"retryable\",\n\t\t\t\treason: getErrorMessage(error),\n\t\t\t};\n\t\t}\n\n\t\tif (AUTH_FAILURE_STATUS.has(response.status)) {\n\t\t\treturn { kind: \"auth\", status: response.status };\n\t\t}\n\n\t\tif (RETRYABLE_STATUS.has(response.status)) {\n\t\t\treturn {\n\t\t\t\tkind: \"retryable\",\n\t\t\t\treason: `HTTP ${response.status}`,\n\t\t\t};\n\t\t}\n\n\t\tif (!response.ok) {\n\t\t\treturn {\n\t\t\t\tkind: \"permanent\",\n\t\t\t\treason: `HTTP ${response.status}`,\n\t\t\t};\n\t\t}\n\n\t\tconst data = await parseJsonResponse<V2BatchResponse>(response);\n\t\tif (!data?.rejected || data.rejected.length === 0) {\n\t\t\treturn { kind: \"success\" };\n\t\t}\n\n\t\tconst partial = this.classifyRejectedEvents(events, data.rejected);\n\t\tif (partial.retryable.length === 0 && partial.permanent.length === 0) {\n\t\t\treturn { kind: \"success\" };\n\t\t}\n\n\t\treturn {\n\t\t\tkind: \"partial\",\n\t\t\tretryable: partial.retryable,\n\t\t\tpermanent: partial.permanent,\n\t\t};\n\t}\n\n\tprivate makeBatchRequest(events: V2EventEnvelope[]): V2BatchRequest {\n\t\treturn {\n\t\t\tsentAt: this.now().toISOString(),\n\t\t\tsource: {\n\t\t\t\tsdk: SDK_NAME,\n\t\t\t\tversion: this.sdkVersion ?? \"0.0.0\",\n\t\t\t},\n\t\t\tevents,\n\t\t};\n\t}\n\n\tprivate classifyRejectedEvents(\n\t\tevents: V2EventEnvelope[],\n\t\trejected: V2BatchRejectedEvent[],\n\t): {\n\t\tretryable: V2EventEnvelope[];\n\t\tpermanent: V2EventEnvelope[];\n\t} {\n\t\tconst byId = new Map(events.map((event) => [event.id, event]));\n\t\tconst retryable: V2EventEnvelope[] = [];\n\t\tconst permanent: V2EventEnvelope[] = [];\n\n\t\tfor (const rejectedEvent of rejected) {\n\t\t\tconst event = byId.get(rejectedEvent.eventId);\n\t\t\tif (!event) continue;\n\t\t\tif (isRetryableRejectedEvent(rejectedEvent)) {\n\t\t\t\tretryable.push(event);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tpermanent.push(event);\n\t\t}\n\n\t\treturn { retryable, permanent };\n\t}\n\n\tprivate backoffDelayMs(attempt: number): number {\n\t\tconst rawDelay = this.retryBaseDelayMs * 2 ** attempt;\n\t\treturn Math.min(rawDelay, this.retryMaxDelayMs);\n\t}\n\n\tprivate stopTransportForAuthFailure(\n\t\tstatus: number,\n\t\trejectedCount: number,\n\t): void {\n\t\tthis.isStopped = true;\n\t\tconst buffered = this.buffer.length;\n\t\tthis.buffer.splice(0, buffered);\n\t\tthis.logger.error(\n\t\t\t\"[WaniWani] Auth failure (HTTP %d). Stopping tracking transport and dropping %d queued event(s)\",\n\t\t\tstatus,\n\t\t\trejectedCount + buffered,\n\t\t);\n\t}\n}\n\nfunction isRetryableRejectedEvent(\n\trejectedEvent: V2BatchRejectedEvent,\n): boolean {\n\tif (rejectedEvent.retryable === true) return true;\n\tconst code = rejectedEvent.code.toLowerCase();\n\treturn (\n\t\tcode.includes(\"timeout\") ||\n\t\tcode.includes(\"temporary\") ||\n\t\tcode.includes(\"unavailable\") ||\n\t\tcode.includes(\"rate_limit\") ||\n\t\tcode.includes(\"transient\") ||\n\t\tcode.includes(\"server\")\n\t);\n}\n\nasync function parseJsonResponse<T>(\n\tresponse: Response,\n): Promise<T | undefined> {\n\tconst body = await response.text();\n\tif (!body) return undefined;\n\ttry {\n\t\treturn JSON.parse(body) as T;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction joinUrl(baseUrl: string, endpointPath: string): string {\n\tconst normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl : `${baseUrl}/`;\n\tconst normalizedPath = endpointPath.startsWith(\"/\")\n\t\t? endpointPath.slice(1)\n\t\t: endpointPath;\n\treturn `${normalizedBase}${normalizedPath}`;\n}\n\nfunction getErrorMessage(error: unknown): string {\n\tif (error instanceof Error) return error.message;\n\treturn String(error);\n}\n","// Tracking Module\n\nimport type { InternalConfig } from \"../types.js\";\nimport type {\n\tTrackInput,\n\tTrackingClient,\n\tTrackingShutdownOptions,\n} from \"./@types.js\";\nimport { mapTrackEventToV2 } from \"./mapper.js\";\nimport { createV2BatchTransport } from \"./transport.js\";\n\n// Re-export types\nexport type {\n\tEventType,\n\tLegacyTrackEvent,\n\tLinkClickedProperties,\n\tPurchaseCompletedProperties,\n\tQuoteSucceededProperties,\n\tToolCalledProperties,\n\tTrackEvent,\n\tTrackInput,\n\tTrackingClient,\n\tTrackingConfig,\n\tTrackingShutdownOptions,\n\tTrackingShutdownResult,\n} from \"./@types.js\";\nexport { createEventId, mapTrackEventToV2 } from \"./mapper.js\";\nexport type {\n\tV2BatchRejectedEvent,\n\tV2BatchRequest,\n\tV2BatchResponse,\n\tV2CorrelationIds,\n\tV2EnvelopeType,\n\tV2EventEnvelope,\n} from \"./v2-types.js\";\n\nexport function createTrackingClient(config: InternalConfig): TrackingClient {\n\tconst { baseUrl, apiKey, tracking } = config;\n\n\tfunction requireApiKey(): string {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t\treturn apiKey;\n\t}\n\n\tconst transport = apiKey\n\t\t? createV2BatchTransport({\n\t\t\t\tbaseUrl,\n\t\t\t\tapiKey,\n\t\t\t\tendpointPath: tracking.endpointPath,\n\t\t\t\tflushIntervalMs: tracking.flushIntervalMs,\n\t\t\t\tmaxBatchSize: tracking.maxBatchSize,\n\t\t\t\tmaxBufferSize: tracking.maxBufferSize,\n\t\t\t\tmaxRetries: tracking.maxRetries,\n\t\t\t\tretryBaseDelayMs: tracking.retryBaseDelayMs,\n\t\t\t\tretryMaxDelayMs: tracking.retryMaxDelayMs,\n\t\t\t\tshutdownTimeoutMs: tracking.shutdownTimeoutMs,\n\t\t\t})\n\t\t: undefined;\n\n\tconst client: TrackingClient = {\n\t\tasync identify(\n\t\t\tuserId: string,\n\t\t\tproperties?: Record<string, unknown>,\n\t\t): Promise<{ eventId: string }> {\n\t\t\trequireApiKey();\n\t\t\tconst mappedEvent = mapTrackEventToV2({\n\t\t\t\tevent: \"user.identified\",\n\t\t\t\texternalUserId: userId,\n\t\t\t\tproperties,\n\t\t\t});\n\t\t\ttransport?.enqueue(mappedEvent);\n\t\t\treturn { eventId: mappedEvent.id };\n\t\t},\n\t\tasync track(event: TrackInput): Promise<{ eventId: string }> {\n\t\t\trequireApiKey();\n\t\t\tconst mappedEvent = mapTrackEventToV2(event);\n\t\t\ttransport?.enqueue(mappedEvent);\n\t\t\treturn { eventId: mappedEvent.id };\n\t\t},\n\t\tasync flush(): Promise<void> {\n\t\t\trequireApiKey();\n\t\t\tawait transport?.flush();\n\t\t},\n\t\tasync shutdown(options?: TrackingShutdownOptions) {\n\t\t\trequireApiKey();\n\t\t\treturn (\n\t\t\t\t(await transport?.shutdown({\n\t\t\t\t\ttimeoutMs: options?.timeoutMs ?? tracking.shutdownTimeoutMs,\n\t\t\t\t})) ?? { timedOut: false, pendingEvents: 0 }\n\t\t\t);\n\t\t},\n\t};\n\n\tif (transport) {\n\t\tattachShutdownHooks(client, tracking.shutdownTimeoutMs);\n\t}\n\treturn client;\n}\n\nfunction attachShutdownHooks(\n\tclient: TrackingClient,\n\tdefaultTimeoutMs: number,\n): void {\n\tif (\n\t\ttypeof process === \"undefined\" ||\n\t\ttypeof process.once !== \"function\" ||\n\t\ttypeof process.on !== \"function\"\n\t) {\n\t\treturn;\n\t}\n\n\tconst shutdown = () => {\n\t\tvoid client.shutdown({ timeoutMs: defaultTimeoutMs });\n\t};\n\n\tprocess.once(\"beforeExit\", shutdown);\n\tprocess.once(\"SIGINT\", shutdown);\n\tprocess.once(\"SIGTERM\", shutdown);\n}\n","// WaniWani SDK - Main Entry\n\nimport { createKbClient } from \"./kb/client.js\";\nimport { createTrackingClient } from \"./tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"./types.js\";\n\n/**\n * Create a WaniWani SDK client\n *\n * @param config - Configuration options\n * @returns A fully typed WaniWani client\n *\n * @example\n * ```typescript\n * import { waniwani } from \"@waniwani/sdk\";\n * import { toNextJsHandler } from \"@waniwani/sdk/next-js\";\n *\n * const wani = waniwani({ apiKey: \"...\" });\n *\n * // Next.js route handler\n * export const { GET, POST } = toNextJsHandler(wani, {\n *   chat: { systemPrompt: \"You are a helpful assistant.\" },\n * });\n * ```\n */\nexport function waniwani(config?: WaniWaniConfig): WaniWaniClient {\n\tconst baseUrl = config?.baseUrl ?? \"https://app.waniwani.ai\";\n\tconst apiKey = config?.apiKey ?? process.env.WANIWANI_API_KEY;\n\tconst trackingConfig = {\n\t\tendpointPath: config?.tracking?.endpointPath ?? \"/api/mcp/events/v2/batch\",\n\t\tflushIntervalMs: config?.tracking?.flushIntervalMs ?? 1_000,\n\t\tmaxBatchSize: config?.tracking?.maxBatchSize ?? 20,\n\t\tmaxBufferSize: config?.tracking?.maxBufferSize ?? 1_000,\n\t\tmaxRetries: config?.tracking?.maxRetries ?? 3,\n\t\tretryBaseDelayMs: config?.tracking?.retryBaseDelayMs ?? 200,\n\t\tretryMaxDelayMs: config?.tracking?.retryMaxDelayMs ?? 2_000,\n\t\tshutdownTimeoutMs: config?.tracking?.shutdownTimeoutMs ?? 2_000,\n\t};\n\n\tconst internalConfig = { baseUrl, apiKey, tracking: trackingConfig };\n\n\t// Compose client from modules\n\tconst trackingClient = createTrackingClient(internalConfig);\n\tconst kbClient = createKbClient(internalConfig);\n\n\treturn {\n\t\t...trackingClient,\n\t\tkb: kbClient,\n\t\t_config: internalConfig,\n\t};\n}\n","/**\n * Server-side API route handler for widget tracking events.\n *\n * Receives batched events from the `useWaniwani` React hook and forwards them\n * to the WaniWani backend using the server-side SDK.\n *\n * @example Next.js App Router\n * ```typescript\n * // app/api/waniwani/track/route.ts\n * import { createTrackingRoute } from \"@waniwani/sdk/mcp\";\n *\n * const handler = createTrackingRoute({\n *   apiKey: process.env.WANIWANI_API_KEY,\n *   baseUrl: process.env.WANIWANI_BASE_URL,\n * });\n *\n * export { handler as POST };\n * ```\n */\n\nimport type { EventType, TrackInput } from \"../../tracking/@types.js\";\nimport type { WaniWaniConfig } from \"../../types.js\";\nimport { waniwani } from \"../../waniwani.js\";\n\nexport interface TrackingRouteOptions {\n\t/** API key for the WaniWani backend. Defaults to WANIWANI_API_KEY env var. */\n\tapiKey?: string;\n\t/** Base URL for the WaniWani backend. Defaults to https://app.waniwani.ai. */\n\tbaseUrl?: string;\n}\n\n/** Shape of a single event from the WidgetTransport client. */\ninterface WidgetEventPayload {\n\tevent_id?: string;\n\tevent_type?: string;\n\ttimestamp?: string;\n\tsource?: string;\n\tsession_id?: string;\n\ttrace_id?: string;\n\tuser_id?: string;\n\tevent_name?: string;\n\tmetadata?: Record<string, unknown>;\n\t[key: string]: unknown;\n}\n\n/** Batch payload sent by WidgetTransport. */\ninterface BatchPayload {\n\tevents: WidgetEventPayload[];\n\tsentAt?: string;\n}\n\n/**\n * Map a WidgetEvent from the client to the SDK's TrackInput format.\n */\nfunction mapWidgetEvent(ev: WidgetEventPayload): TrackInput {\n\tconst eventType = ev.event_type ?? \"widget_click\";\n\n\t// For manual tracking methods (track, identify, step, conversion),\n\t// use \"widget_<type>\" as the event name. Auto-capture events already\n\t// have the \"widget_\" prefix.\n\tconst isAutoCapture = eventType.startsWith(\"widget_\");\n\tconst eventName: EventType = (\n\t\tisAutoCapture ? eventType : `widget_${eventType}`\n\t) as EventType;\n\n\t// Merge metadata + any extra properties from the event\n\tconst properties: Record<string, unknown> = {\n\t\t...(ev.metadata ?? {}),\n\t};\n\tif (ev.event_name) properties.event_name = ev.event_name;\n\n\treturn {\n\t\tevent: eventName,\n\t\tproperties,\n\t\tsessionId: ev.session_id,\n\t\ttraceId: ev.trace_id,\n\t\texternalUserId: ev.user_id,\n\t\teventId: ev.event_id,\n\t\ttimestamp: ev.timestamp,\n\t\tsource: ev.source ?? \"widget\",\n\t} as TrackInput;\n}\n\n/**\n * Creates a POST handler that receives tracking events from `useWaniwani`\n * and forwards them to the WaniWani backend.\n */\nexport function createTrackingRoute(options?: TrackingRouteOptions) {\n\tconst config: WaniWaniConfig = {\n\t\tapiKey: options?.apiKey,\n\t\tbaseUrl: options?.baseUrl,\n\t};\n\n\t// Lazy singleton — created on first request\n\tlet client: ReturnType<typeof waniwani> | undefined;\n\n\tfunction getClient() {\n\t\tif (!client) {\n\t\t\tclient = waniwani(config);\n\t\t}\n\t\treturn client;\n\t}\n\n\treturn async function handler(request: Request): Promise<Response> {\n\t\tlet body: BatchPayload;\n\t\ttry {\n\t\t\tbody = (await request.json()) as BatchPayload;\n\t\t} catch {\n\t\t\treturn new Response(JSON.stringify({ error: \"Invalid JSON\" }), {\n\t\t\t\tstatus: 400,\n\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t});\n\t\t}\n\n\t\tif (!Array.isArray(body.events) || body.events.length === 0) {\n\t\t\treturn new Response(\n\t\t\t\tJSON.stringify({ error: \"Missing or empty events array\" }),\n\t\t\t\t{\n\t\t\t\t\tstatus: 400,\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\ttry {\n\t\t\tconst c = getClient();\n\t\t\tconst results: string[] = [];\n\n\t\t\tfor (const ev of body.events) {\n\t\t\t\tconst trackInput = mapWidgetEvent(ev);\n\t\t\t\tconst result = await c.track(trackInput);\n\t\t\t\tresults.push(result.eventId);\n\t\t\t}\n\n\t\t\tawait c.flush();\n\n\t\t\treturn new Response(\n\t\t\t\tJSON.stringify({ ok: true, accepted: results.length }),\n\t\t\t\t{\n\t\t\t\t\tstatus: 200,\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t},\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : \"Unknown error\";\n\t\t\treturn new Response(JSON.stringify({ error: message }), {\n\t\t\t\tstatus: 500,\n\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t});\n\t\t}\n\t};\n}\n","/**\n * Widget token minting — fetches short-lived JWTs from the WaniWani backend\n * so browser widgets can POST events directly.\n */\n\ninterface WidgetTokenConfig {\n\tbaseUrl: string;\n\tapiKey: string;\n}\n\ninterface WidgetTokenResult {\n\ttoken: string;\n\texpiresAt: string;\n}\n\ninterface CachedToken {\n\ttoken: string;\n\t/** Unix ms when the token expires */\n\texpiresAt: number;\n}\n\n/** Re-mint when < 2 minutes remain to avoid using nearly-expired tokens. */\nconst EXPIRY_BUFFER_MS = 2 * 60 * 1000;\n\nexport class WidgetTokenCache {\n\tprivate cached: CachedToken | null = null;\n\tprivate pending: Promise<string | null> | null = null;\n\tprivate readonly config: WidgetTokenConfig;\n\n\tconstructor(config: WidgetTokenConfig) {\n\t\tthis.config = config;\n\t}\n\n\t/**\n\t * Get a valid widget token. Returns a cached token if still fresh,\n\t * otherwise mints a new one. Returns `null` on failure.\n\t */\n\tasync getToken(sessionId?: string, traceId?: string): Promise<string | null> {\n\t\tif (this.cached && Date.now() < this.cached.expiresAt - EXPIRY_BUFFER_MS) {\n\t\t\treturn this.cached.token;\n\t\t}\n\n\t\t// Deduplicate concurrent requests\n\t\tif (this.pending) return this.pending;\n\n\t\tthis.pending = this.mint(sessionId, traceId).finally(() => {\n\t\t\tthis.pending = null;\n\t\t});\n\n\t\treturn this.pending;\n\t}\n\n\tprivate async mint(\n\t\tsessionId?: string,\n\t\ttraceId?: string,\n\t): Promise<string | null> {\n\t\tconst url = joinUrl(this.config.baseUrl, \"/api/mcp/widget-tokens\");\n\n\t\tconst body: Record<string, string> = {};\n\t\tif (sessionId) body.sessionId = sessionId;\n\t\tif (traceId) body.traceId = traceId;\n\n\t\ttry {\n\t\t\tconst response = await fetch(url, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${this.config.apiKey}`,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify(body),\n\t\t\t});\n\n\t\t\tif (!response.ok) return null;\n\n\t\t\tconst json = (await response.json()) as Record<string, unknown>;\n\n\t\t\t// Support both flat { token, expiresAt } and nested { data: { token, expiresAt } }\n\t\t\tconst result = (\n\t\t\t\tjson.data && typeof json.data === \"object\" ? json.data : json\n\t\t\t) as WidgetTokenResult;\n\n\t\t\tconst expiresAtMs = new Date(result.expiresAt).getTime();\n\t\t\tif (!result.token || Number.isNaN(expiresAtMs)) return null;\n\n\t\t\tthis.cached = {\n\t\t\t\ttoken: result.token,\n\t\t\t\texpiresAt: expiresAtMs,\n\t\t\t};\n\n\t\t\treturn result.token;\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n}\n\nfunction joinUrl(baseUrl: string, path: string): string {\n\tconst base = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n\treturn `${base}${path}`;\n}\n","import type { ToolCalledProperties, TrackInput } from \"../../tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"../../types.js\";\nimport { waniwani } from \"../../waniwani.js\";\nimport type { McpServer } from \"./tools/types\";\nimport { WidgetTokenCache } from \"./widget-token.js\";\n\ntype WaniwaniTracker = Pick<WaniWaniClient, \"flush\" | \"track\" | \"_config\">;\ntype UnknownRecord = Record<string, unknown>;\n\ntype WrappedServer = McpServer & {\n\t__waniwaniWrapped?: true;\n};\n\n/**\n * Options for withWaniwani().\n */\nexport type WithWaniwaniOptions = {\n\t/**\n\t * Optional pre-built WaniWani client.\n\t * When omitted, a new client is created from `config`.\n\t */\n\tclient?: WaniwaniTracker;\n\t/**\n\t * WaniWani client config used when `client` is omitted.\n\t */\n\tconfig?: WaniWaniConfig;\n\t/**\n\t * Optional explicit tool type. Defaults to `\"other\"`.\n\t */\n\ttoolType?:\n\t\t| ToolCalledProperties[\"type\"]\n\t\t| ((toolName: string) => ToolCalledProperties[\"type\"] | undefined);\n\t/**\n\t * Optional metadata merged into every tracked event.\n\t */\n\tmetadata?: UnknownRecord;\n\t/**\n\t * Flush tracking transport after each tool call.\n\t */\n\tflushAfterToolCall?: boolean;\n\t/**\n\t * Optional error callback for non-fatal tracking errors.\n\t */\n\tonError?: (error: Error) => void;\n\t/**\n\t * Inject widget tracking config into tool response `_meta.waniwani` so browser\n\t * widgets can send events directly to the WaniWani backend.\n\t *\n\t * Always injects `endpoint`. Injects `token` when an API key is configured\n\t * and token minting succeeds.\n\t *\n\t * @default true\n\t */\n\tinjectWidgetToken?: boolean;\n};\n\nconst DEFAULT_BASE_URL = \"https://app.waniwani.ai\";\n\n/**\n * Wrap an MCP server so tool handlers automatically emit `tool.called` events.\n *\n * The wrapper intercepts `server.registerTool(...)`, tracks each invocation,\n * then forwards execution to the original tool handler.\n *\n * When `injectWidgetToken` is enabled (default), tracking config is injected\n * into tool response `_meta.waniwani` so browser widgets can post events\n * directly to the WaniWani backend without a server-side proxy.\n */\nexport function withWaniwani(\n\tserver: McpServer,\n\toptions: WithWaniwaniOptions = {},\n): McpServer {\n\tconst wrappedServer = server as WrappedServer;\n\tif (wrappedServer.__waniwaniWrapped) {\n\t\treturn wrappedServer;\n\t}\n\n\twrappedServer.__waniwaniWrapped = true;\n\n\tconst tracker = options.client ?? waniwani(options.config);\n\tconst injectToken = options.injectWidgetToken !== false;\n\n\t// Lazy-init token cache — only created if we have an API key\n\tlet tokenCache: WidgetTokenCache | null = null;\n\n\tfunction getTokenCache(): WidgetTokenCache | null {\n\t\tif (tokenCache) return tokenCache;\n\t\tconst apiKey = tracker._config.apiKey;\n\t\tif (!apiKey) return null;\n\t\ttokenCache = new WidgetTokenCache({\n\t\t\tbaseUrl: tracker._config.baseUrl ?? DEFAULT_BASE_URL,\n\t\t\tapiKey,\n\t\t});\n\t\treturn tokenCache;\n\t}\n\n\tconst originalRegisterTool = server.registerTool.bind(server) as (\n\t\t...args: unknown[]\n\t) => unknown;\n\n\twrappedServer.registerTool = ((...args: unknown[]) => {\n\t\tconst [toolNameRaw, config, handlerRaw] = args;\n\t\tconst toolName =\n\t\t\ttypeof toolNameRaw === \"string\" && toolNameRaw.trim().length > 0\n\t\t\t\t? toolNameRaw\n\t\t\t\t: \"unknown\";\n\n\t\tif (typeof handlerRaw !== \"function\") {\n\t\t\treturn originalRegisterTool(...args);\n\t\t}\n\n\t\tconst handler = handlerRaw as (\n\t\t\tinput: unknown,\n\t\t\textra: unknown,\n\t\t) => Promise<unknown> | unknown;\n\n\t\tconst wrappedHandler = async (input: unknown, extra: unknown) => {\n\t\t\tconst startTime = performance.now();\n\t\t\ttry {\n\t\t\t\tconst result = await handler(input, extra);\n\t\t\t\tconst durationMs = Math.round(performance.now() - startTime);\n\n\t\t\t\tawait safeTrack(\n\t\t\t\t\ttracker,\n\t\t\t\t\tbuildTrackInput(toolName, extra, options, {\n\t\t\t\t\t\tdurationMs,\n\t\t\t\t\t\tstatus: \"ok\",\n\t\t\t\t\t}),\n\t\t\t\t\toptions.onError,\n\t\t\t\t);\n\n\t\t\t\tif (options.flushAfterToolCall) {\n\t\t\t\t\tawait safeFlush(tracker, options.onError);\n\t\t\t\t}\n\n\t\t\t\tif (injectToken) {\n\t\t\t\t\tawait injectWidgetConfig(\n\t\t\t\t\t\tresult,\n\t\t\t\t\t\tgetTokenCache(),\n\t\t\t\t\t\ttracker._config.baseUrl ?? DEFAULT_BASE_URL,\n\t\t\t\t\t\toptions.onError,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tinjectUserLocation(result, extra);\n\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\tconst durationMs = Math.round(performance.now() - startTime);\n\n\t\t\t\tawait safeTrack(\n\t\t\t\t\ttracker,\n\t\t\t\t\tbuildTrackInput(toolName, extra, options, {\n\t\t\t\t\t\tdurationMs,\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terrorMessage:\n\t\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t}),\n\t\t\t\t\toptions.onError,\n\t\t\t\t);\n\n\t\t\t\tif (options.flushAfterToolCall) {\n\t\t\t\t\tawait safeFlush(tracker, options.onError);\n\t\t\t\t}\n\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t};\n\n\t\treturn originalRegisterTool(toolNameRaw, config, wrappedHandler);\n\t}) as McpServer[\"registerTool\"];\n\n\treturn wrappedServer;\n}\n\nasync function injectWidgetConfig(\n\tresult: unknown,\n\tcache: WidgetTokenCache | null,\n\tbaseUrl: string,\n\tonError?: (error: Error) => void,\n): Promise<void> {\n\tif (!isRecord(result)) return;\n\n\tif (!isRecord(result._meta)) {\n\t\t(result as UnknownRecord)._meta = {};\n\t}\n\n\tconst meta = (result as UnknownRecord)._meta as UnknownRecord;\n\tconst waniwaniConfig: UnknownRecord = {\n\t\tendpoint: `${baseUrl.replace(/\\/$/, \"\")}/api/mcp/events/v2/batch`,\n\t};\n\n\tif (cache) {\n\t\ttry {\n\t\t\tconst token = await cache.getToken();\n\t\t\tif (token) {\n\t\t\t\twaniwaniConfig.token = token;\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tonError?.(toError(error));\n\t\t}\n\t}\n\n\tmeta.waniwani = waniwaniConfig;\n}\n\nfunction buildTrackInput(\n\ttoolName: string,\n\textra: unknown,\n\toptions: WithWaniwaniOptions,\n\ttiming?: { durationMs: number; status: string; errorMessage?: string },\n): TrackInput {\n\tconst toolType = resolveToolType(toolName, options.toolType);\n\tconst meta = extractMeta(extra);\n\n\treturn {\n\t\tevent: \"tool.called\",\n\t\tproperties: {\n\t\t\tname: toolName,\n\t\t\ttype: toolType,\n\t\t\t...(timing ?? {}),\n\t\t},\n\t\tmeta,\n\t\tmetadata: {\n\t\t\tsource: \"withWaniwani\",\n\t\t\t...(options.metadata ?? {}),\n\t\t},\n\t};\n}\n\nfunction resolveToolType(\n\ttoolName: string,\n\ttoolTypeOption: WithWaniwaniOptions[\"toolType\"],\n): ToolCalledProperties[\"type\"] {\n\tif (typeof toolTypeOption === \"function\") {\n\t\treturn toolTypeOption(toolName) ?? \"other\";\n\t}\n\treturn toolTypeOption ?? \"other\";\n}\n\nfunction extractMeta(extra: unknown): UnknownRecord | undefined {\n\tif (!isRecord(extra)) return undefined;\n\n\tconst meta = extra._meta;\n\tif (!isRecord(meta)) return undefined;\n\n\treturn meta;\n}\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n\treturn Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nasync function safeTrack(\n\ttracker: Pick<WaniWaniClient, \"track\">,\n\tinput: TrackInput,\n\tonError?: (error: Error) => void,\n): Promise<void> {\n\ttry {\n\t\tawait tracker.track(input);\n\t} catch (error) {\n\t\tonError?.(toError(error));\n\t}\n}\n\nasync function safeFlush(\n\ttracker: Pick<WaniWaniClient, \"flush\">,\n\tonError?: (error: Error) => void,\n): Promise<void> {\n\ttry {\n\t\tawait tracker.flush();\n\t} catch (error) {\n\t\tonError?.(toError(error));\n\t}\n}\n\nfunction toError(error: unknown): Error {\n\tif (error instanceof Error) {\n\t\treturn error;\n\t}\n\treturn new Error(String(error));\n}\n\nconst USER_LOCATION_KEY = \"waniwani/userLocation\";\n\n/**\n * Pass-through `waniwani/userLocation` from request `_meta` to response `_meta`.\n * This ensures widgets always receive location data, even for custom handlers\n * that don't use `createTool` (which already spreads request `_meta`).\n */\nfunction injectUserLocation(result: unknown, extra: unknown): void {\n\tconst requestMeta = extractMeta(extra);\n\tif (!requestMeta) return;\n\n\tconst userLocation = requestMeta[USER_LOCATION_KEY];\n\tif (!userLocation) return;\n\n\tif (!isRecord(result)) return;\n\n\tif (!isRecord(result._meta)) {\n\t\t(result as UnknownRecord)._meta = {};\n\t}\n\n\tconst resultMeta = (result as UnknownRecord)._meta as UnknownRecord;\n\n\t// Don't overwrite if the handler already set it\n\tif (!resultMeta[USER_LOCATION_KEY]) {\n\t\tresultMeta[USER_LOCATION_KEY] = userLocation;\n\t}\n}\n"],"mappings":"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","names":["detectPlatform","isOpenAI","isMCPApps","START","END","INTERRUPT","WIDGET","interrupt","config","question","field","context","suggestions","validate","showWidget","tool","isInterrupt","value","isWidget","z","deflateSync","inflateSync","encodeFlowToken","data","json","decodeFlowToken","token","compressed","describeZodField","schema","desc","def","vals","v","buildFlowProtocol","config","lines","fieldList","key","info","getInputMeta","args","decoded","decodeFlowToken","resolveNextNode","edge","state","isFilled","buildInterruptResult","questions","context","currentNode","q","unanswered","isSingle","q0","executeFrom","startNodeName","startState","nodes","edges","validators","meta","MAX_ITERATIONS","iterations","END","handler","result","interrupt","showWidget","isInterrupt","interruptResult","isWidget","widgetField","error","inputSchema","z","compileFlow","input","protocol","fullDescription","handleToolCall","inputMeta","startEdge","START","firstNode","step","updatedState","fieldValidators","field","fn","value","vResult","err","msg","questionsWithError","nextNode","server","extra","_meta","flowToken","encodeFlowToken","contentResponse","StateGraph","config","name","handler","START","END","from","to","condition","compileFlow","startEdge","edge","createFlow","config","StateGraph","MIME_TYPE_OPENAI","MIME_TYPE_MCP","fetchHtml","baseUrl","path","normalizedBase","buildOpenAIResourceMeta","config","buildMcpAppsResourceMeta","csp","buildToolMeta","createResource","config","id","title","description","baseUrl","htmlPath","widgetDomain","prefersBorder","autoHeight","widgetCSP","hostname","openaiUri","mcpUri","htmlPromise","getHtml","fetchHtml","uiDescription","register","server","html","MIME_TYPE_OPENAI","uri","buildOpenAIResourceMeta","MIME_TYPE_MCP","buildMcpAppsResourceMeta","createTool","config","handler","resource","description","inputSchema","annotations","autoInjectResultText","id","title","toolMeta","buildToolMeta","server","args","extra","_meta","result","registerTools","tools","t","WaniWaniError","message","status","SDK_NAME","createKbClient","config","baseUrl","apiKey","requireApiKey","request","method","path","body","key","url","headers","init","response","text","WaniWaniError","files","query","options","DEFAULT_SOURCE","mapTrackEventToV2","input","options","now","generateId","createEventId","eventName","resolveEventName","meta","toRecord","metadata","correlation","resolveCorrelationIds","eventId","takeNonEmptyString","timestamp","normalizeTimestamp","source","rawLegacy","isLegacyTrackEvent","mappedMetadata","mapProperties","legacyProperties","mapLegacyProperties","explicitProperties","properties","requestId","pickFirstString","sessionId","traceId","externalUserId","correlationId","date","record","keys","key","value","DEFAULT_ENDPOINT_PATH","SDK_NAME","AUTH_FAILURE_STATUS","RETRYABLE_STATUS","createV2BatchTransport","options","BatchingV2Transport","joinUrl","DEFAULT_ENDPOINT_PATH","delayMs","resolve","event","dropCount","timeoutMs","flushPromise","timeoutSignal","batch","attempt","pendingBatch","result","events","response","error","getErrorMessage","data","parseJsonResponse","partial","rejected","byId","retryable","permanent","rejectedEvent","isRetryableRejectedEvent","rawDelay","status","rejectedCount","buffered","code","body","baseUrl","endpointPath","normalizedBase","normalizedPath","createTrackingClient","config","baseUrl","apiKey","tracking","requireApiKey","transport","createV2BatchTransport","client","userId","properties","mappedEvent","mapTrackEventToV2","event","options","attachShutdownHooks","defaultTimeoutMs","shutdown","waniwani","config","baseUrl","apiKey","trackingConfig","internalConfig","trackingClient","createTrackingClient","kbClient","createKbClient","mapWidgetEvent","ev","eventType","eventName","properties","createTrackingRoute","options","config","client","getClient","waniwani","request","body","c","results","trackInput","result","error","message","WidgetTokenCache","config","sessionId","traceId","url","joinUrl","body","response","json","result","expiresAtMs","baseUrl","path","DEFAULT_BASE_URL","withWaniwani","server","options","wrappedServer","tracker","waniwani","injectToken","tokenCache","getTokenCache","apiKey","WidgetTokenCache","originalRegisterTool","args","toolNameRaw","config","handlerRaw","toolName","handler","input","extra","startTime","result","durationMs","safeTrack","buildTrackInput","safeFlush","injectWidgetConfig","injectUserLocation","error","cache","baseUrl","onError","isRecord","meta","waniwaniConfig","token","toError","timing","toolType","resolveToolType","extractMeta","toolTypeOption","value","USER_LOCATION_KEY","requestMeta","userLocation","resultMeta"]}
+{"version":3,"sources":["../../src/mcp/react/widgets/platform.ts","../../src/mcp/server/flows/@types.ts","../../src/mcp/server/flows/compile.ts","../../src/mcp/server/flows/flow-token.ts","../../src/mcp/server/flows/state-graph.ts","../../src/mcp/server/flows/create-flow.ts","../../src/mcp/server/resources/meta.ts","../../src/mcp/server/resources/create-resource.ts","../../src/mcp/server/tools/create-tool.ts","../../src/error.ts","../../src/kb/client.ts","../../src/tracking/mapper.ts","../../src/tracking/transport.ts","../../src/tracking/index.ts","../../src/waniwani.ts","../../src/mcp/server/tracking-route.ts","../../src/mcp/server/widget-token.ts","../../src/mcp/server/with-waniwani.ts"],"sourcesContent":["/**\n * Widget platform types\n */\nexport type WidgetPlatform = \"openai\" | \"mcp-apps\";\n\n/**\n * Detects which platform the widget is running on.\n *\n * OpenAI injects a global `window.openai` object.\n * MCP Apps runs in a sandboxed iframe and uses postMessage.\n */\nexport function detectPlatform(): WidgetPlatform {\n\tif (typeof window !== \"undefined\" && \"openai\" in window) {\n\t\treturn \"openai\";\n\t}\n\treturn \"mcp-apps\";\n}\n\n/**\n * Check if running on OpenAI platform\n */\nexport function isOpenAI(): boolean {\n\treturn detectPlatform() === \"openai\";\n}\n\n/**\n * Check if running on MCP Apps platform\n */\nexport function isMCPApps(): boolean {\n\treturn detectPlatform() === \"mcp-apps\";\n}\n","import type { z } from \"zod\";\nimport type { McpServer } from \"../resources/types\";\nimport type { RegisteredTool } from \"../tools/types\";\n\nexport type { McpServer };\n\n// ============================================================================\n// Sentinel constants\n// ============================================================================\n\nexport const START = \"__start__\" as const;\nexport const END = \"__end__\" as const;\n\n// ============================================================================\n// Signal types — returned by node handlers to control flow behavior\n// ============================================================================\n\nconst INTERRUPT = Symbol.for(\"waniwani.flow.interrupt\");\nconst WIDGET = Symbol.for(\"waniwani.flow.widget\");\n\n/** A single question within an interrupt step */\nexport type InterruptQuestion = {\n\t/** Question to ask the user */\n\tquestion: string;\n\t/** State key where the answer will be stored */\n\tfield: string;\n\t/** Optional suggestions to present as options */\n\tsuggestions?: string[];\n\t/** Hidden context/instructions for this specific question (not shown to user directly) */\n\tcontext?: string;\n\t/** Validation function — runs after the user answers, before advancing to the next node */\n\t// biome-ignore lint/suspicious/noConfusingVoidType: void is needed so `async () => {}` compiles\n\tvalidate?: (value: unknown) => MaybePromise<Record<string, unknown> | void>;\n};\n\n/**\n * Interrupt signal — pauses the flow and asks the user one or more questions.\n * Single-question and multi-question interrupts use the same type.\n */\nexport type InterruptSignal = {\n\treadonly __type: typeof INTERRUPT;\n\t/** Questions to ask — ask all in one conversational message */\n\tquestions: InterruptQuestion[];\n\t/** Overall hidden context/instructions for the assistant (not shown to user directly) */\n\tcontext?: string;\n};\n\nexport type WidgetSignal = {\n\treadonly __type: typeof WIDGET;\n\t/** The display tool to delegate rendering to */\n\ttool: RegisteredTool;\n\t/** Data to pass to the display tool */\n\tdata: Record<string, unknown>;\n\t/** Description of what the widget does (for the AI's context) */\n\tdescription?: string;\n\t/**\n\t * Whether the user is expected to interact with the widget before the flow continues.\n\t * Defaults to true. Set to false for informational widgets that should render and then\n\t * immediately advance to the next flow step.\n\t */\n\tinteractive?: boolean;\n\t/**\n\t * State key this widget fills — enables auto-skip when the field is already in state.\n\t * Pass this so the engine can skip the widget step when the answer is already known.\n\t */\n\tfield?: string;\n};\n\n/**\n * Create an interrupt signal — pauses the flow and asks the user a question.\n * Used internally by the engine. Flow authors use the typed `interrupt` from the node context.\n *\n * Accepts an object where each key is a field name and the value describes the question.\n * The only reserved key is `context` (string) for overall hidden AI instructions.\n */\nexport function interrupt(\n\tfields: Record<string, unknown>,\n\tconfig?: { context?: string },\n): InterruptSignal {\n\tconst context = config?.context;\n\tconst questions: InterruptQuestion[] = [];\n\n\tfor (const [key, value] of Object.entries(fields)) {\n\t\tif (typeof value === \"object\" && value !== null && \"question\" in value) {\n\t\t\tconst q = value as {\n\t\t\t\tquestion: string;\n\t\t\t\tsuggestions?: string[];\n\t\t\t\tcontext?: string;\n\t\t\t\tvalidate?: (\n\t\t\t\t\tvalue: unknown,\n\t\t\t\t\t// biome-ignore lint/suspicious/noConfusingVoidType: void is needed so `async () => {}` compiles\n\t\t\t\t) => MaybePromise<Record<string, unknown> | void>;\n\t\t\t};\n\t\t\tquestions.push({\n\t\t\t\tquestion: q.question,\n\t\t\t\tfield: key,\n\t\t\t\tsuggestions: q.suggestions,\n\t\t\t\tcontext: q.context,\n\t\t\t\tvalidate: q.validate,\n\t\t\t});\n\t\t}\n\t}\n\n\treturn {\n\t\t__type: INTERRUPT,\n\t\tquestions,\n\t\tcontext,\n\t};\n}\n\n/**\n * Create a widget signal — pauses the flow and delegates rendering to a display tool.\n * Used internally by the engine. Flow authors use the typed `showWidget` from the node context.\n */\nexport function showWidget(\n\ttool: RegisteredTool,\n\tconfig: {\n\t\tdata: Record<string, unknown>;\n\t\tdescription?: string;\n\t\tinteractive?: boolean;\n\t\tfield?: string;\n\t},\n): WidgetSignal {\n\treturn { __type: WIDGET, tool, ...config };\n}\n\nexport function isInterrupt(value: unknown): value is InterruptSignal {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"__type\" in value &&\n\t\t(value as InterruptSignal).__type === INTERRUPT\n\t);\n}\n\nexport function isWidget(value: unknown): value is WidgetSignal {\n\treturn (\n\t\ttypeof value === \"object\" &&\n\t\tvalue !== null &&\n\t\t\"__type\" in value &&\n\t\t(value as WidgetSignal).__type === WIDGET\n\t);\n}\n\n// ============================================================================\n// Node context & handler\n// ============================================================================\n\nexport type MaybePromise<T> = T | Promise<T>;\n\n/**\n * Typed interrupt function — available on the node context.\n *\n * First argument: an object where each key is a state field name and each value\n * describes the question for that field. `validate` receives the field's value\n * typed from the Zod schema.\n *\n * Second argument (optional): config with overall hidden AI instructions.\n *\n * @example\n * ```ts\n * // Single question\n * interrupt({ breed: { question: \"What breed is your pet?\" } })\n *\n * // Multiple questions with context\n * interrupt(\n *   {\n *     breed: {\n *       question: \"What breed?\",\n *       validate: async (breed) => {\n *         const result = await lookupBreed(breed);\n *         if (!result) throw new Error(\"Unknown breed\");\n *         return { breedId: result.id };\n *       },\n *     },\n *     age: { question: \"How old is your pet?\" },\n *   },\n *   { context: \"Ask both questions naturally.\" },\n * )\n * ```\n */\nexport type TypedInterrupt<TState> = (\n\tfields: {\n\t\t[F in Extract<keyof TState, string>]?: {\n\t\t\tquestion: string;\n\t\t\t// biome-ignore lint/suspicious/noConfusingVoidType: void is needed so `async () => {}` compiles\n\t\t\tvalidate?: (value: TState[F]) => MaybePromise<Partial<TState> | void>;\n\t\t\tsuggestions?: string[];\n\t\t\tcontext?: string;\n\t\t};\n\t},\n\tconfig?: {\n\t\t/** Overall hidden context/instructions for the assistant (not shown to user directly) */\n\t\tcontext?: string;\n\t},\n) => InterruptSignal;\n\n/**\n * Typed showWidget function — available on the node context.\n * The `field` parameter is typed as `keyof TState`.\n */\nexport type TypedShowWidget<TState> = (\n\ttool: RegisteredTool,\n\tconfig: {\n\t\tdata: Record<string, unknown>;\n\t\tdescription?: string;\n\t\tinteractive?: boolean;\n\t\tfield?: Extract<keyof TState, string>;\n\t},\n) => WidgetSignal;\n\n/**\n * Context object passed to node handlers.\n * Provides state, metadata, and typed helper functions for creating signals.\n */\nexport type NodeContext<TState> = {\n\t/** Current flow state (partial — fields are filled as the flow progresses) */\n\tstate: Partial<TState>;\n\t/** Request metadata from the MCP call */\n\tmeta?: Record<string, unknown>;\n\t/** Create an interrupt signal — pause and ask the user questions */\n\tinterrupt: TypedInterrupt<TState>;\n\t/** Create a widget signal — pause and show a UI widget */\n\tshowWidget: TypedShowWidget<TState>;\n};\n\n/**\n * Node handler — receives a context object and returns a signal or state updates.\n * The return value determines behavior:\n * - `Partial<TState>` → action node (state merged, auto-advance)\n * - `InterruptSignal` → interrupt (pause, ask user one or more questions)\n * - `WidgetSignal` → widget step (pause, show widget)\n */\nexport type NodeHandler<TState> = (\n\tctx: NodeContext<TState>,\n) => MaybePromise<Partial<TState> | InterruptSignal | WidgetSignal>;\n\n/**\n * Condition function for conditional edges.\n * Receives current state, returns the name of the next node.\n */\nexport type ConditionFn<TState> = (\n\tstate: Partial<TState>,\n) => string | Promise<string>;\n\nexport type Edge<TState> =\n\t| { type: \"direct\"; to: string }\n\t| { type: \"conditional\"; condition: ConditionFn<TState> };\n\n// ============================================================================\n// Flow config & compiled output\n// ============================================================================\n\nexport type FlowConfig = {\n\t/** Unique identifier for the flow (becomes the MCP tool name) */\n\tid: string;\n\t/** Display title */\n\ttitle: string;\n\t/** Description for the AI (explains when to use this flow) */\n\tdescription: string;\n\t/**\n\t * Define the flow's state — each field the flow collects.\n\t * Keys are the field names used in `interrupt({ field })`,\n\t * values are Zod schemas with `.describe()`.\n\t *\n\t * The state definition serves two purposes:\n\t * 1. Type inference — `TState` is automatically derived, no explicit generic needed\n\t * 2. AI protocol — field names, types, and descriptions are included in the tool\n\t *    description so the AI can pre-fill answers via `_meta.flow.state`\n\t *\n\t * @example\n\t * ```ts\n\t * state: {\n\t *   country: z.string().describe(\"Country the business is based in\"),\n\t *   status: z.enum([\"registered\", \"unregistered\"]).describe(\"Business registration status\"),\n\t * }\n\t * ```\n\t */\n\tstate: Record<string, z.ZodType>;\n\t/** Optional tool annotations */\n\tannotations?: {\n\t\treadOnlyHint?: boolean;\n\t\tidempotentHint?: boolean;\n\t\topenWorldHint?: boolean;\n\t\tdestructiveHint?: boolean;\n\t};\n};\n\n/**\n * Infer the runtime state type from a flow's state schema definition.\n *\n * @example\n * ```ts\n * const config = {\n *   state: {\n *     country: z.enum([\"FR\", \"DE\"]),\n *     status: z.enum([\"registered\", \"unregistered\"]),\n *   }\n * };\n * type MyState = InferFlowState<typeof config.state>;\n * // { country: \"FR\" | \"DE\"; status: \"registered\" | \"unregistered\" }\n * ```\n */\nexport type InferFlowState<T extends Record<string, z.ZodType>> = {\n\t[K in keyof T]: z.infer<T[K]>;\n};\n\n/**\n * A compiled flow — can be registered on an McpServer.\n */\nexport type RegisteredFlow = {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n\tregister: (server: McpServer) => Promise<void>;\n};\n\nexport interface CompileInput<TState extends Record<string, unknown>> {\n\tconfig: FlowConfig;\n\tnodes: Map<string, NodeHandler<TState>>;\n\tedges: Map<string, Edge<TState>>;\n}\n\nexport type FlowToolInput = {\n\taction: \"start\" | \"continue\";\n\tstateUpdates?: Record<string, unknown>;\n\tflowToken?: string;\n};\n\nexport type FlowTokenContent = {\n\tstep?: string;\n\tstate: Record<string, unknown>;\n\tfield?: string;\n\twidgetId?: string;\n\t/** Cached interrupt questions — avoids re-executing the handler on partial answers */\n\tquestions?: Array<{\n\t\tquestion: string;\n\t\tfield: string;\n\t\tsuggestions?: string[];\n\t\tcontext?: string;\n\t}>;\n\t/** Cached overall interrupt context */\n\tinterruptContext?: string;\n};\n\n/** Parsed response text from a flow tool call */\nexport type FlowContent = {\n\tstatus: \"widget\" | \"interrupt\" | \"complete\" | \"error\";\n\tdescription?: string;\n\tquestion?: string;\n\terror?: string;\n\tflowToken?: string;\n\t/** Whether a widget step expects user interaction before continuing */\n\tinteractive?: boolean;\n\t/** Display tool to call (widget status only) */\n\ttool?: string;\n\t/** Data to pass to the display tool (widget status only) */\n\tdata?: Record<string, unknown>;\n};\n\nexport type ExecutionResult = {\n\tcontent: FlowContent;\n\tflowTokenContent?: FlowTokenContent;\n};\n","import type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n\tServerNotification,\n\tServerRequest,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\nimport type {\n\tCompileInput,\n\tEdge,\n\tExecutionResult,\n\tFlowConfig,\n\tFlowContent,\n\tFlowTokenContent,\n\tFlowToolInput,\n\tMaybePromise,\n\tMcpServer,\n\tNodeHandler,\n\tRegisteredFlow,\n} from \"./@types\";\nimport {\n\tEND,\n\tinterrupt,\n\tisInterrupt,\n\tisWidget,\n\tSTART,\n\tshowWidget,\n} from \"./@types\";\nimport { decodeFlowToken, encodeFlowToken } from \"./flow-token\";\n\n// ============================================================================\n// Flow protocol — embedded in tool description\n// ============================================================================\n\n/** Extract a human-readable label from a Zod schema for the AI protocol */\nfunction describeZodField(schema: z.ZodType): string {\n\tconst desc = schema.description ?? \"\";\n\tconst def = (\n\t\tschema as unknown as {\n\t\t\t_zod: { def: { type: string; entries?: Record<string, string> } };\n\t\t}\n\t)._zod?.def;\n\n\tif (def?.type === \"enum\" && def.entries) {\n\t\tconst vals = Object.keys(def.entries)\n\t\t\t.map((v) => `\"${v}\"`)\n\t\t\t.join(\" | \");\n\t\treturn desc ? `${vals} — ${desc}` : vals;\n\t}\n\n\treturn desc;\n}\n\nfunction buildFlowProtocol(config: FlowConfig): string {\n\tconst lines = [\n\t\t\"\",\n\t\t\"## FLOW EXECUTION PROTOCOL\",\n\t\t\"\",\n\t\t\"This tool implements a multi-step conversational flow. Follow this protocol exactly:\",\n\t\t\"\",\n\t\t'1. Call with `action: \"start\"` to begin. If the user\\'s message already',\n\t\t\"   contains answers to likely questions, extract them into `stateUpdates`\",\n\t\t\"   as `{ field: value }` pairs. The engine will auto-skip steps whose\",\n\t\t\"   fields are already filled.\",\n\t\t\"   Only extract values the user explicitly stated — do NOT guess or invent values.\",\n\t];\n\n\tif (config.state) {\n\t\tconst fieldList = Object.entries(config.state)\n\t\t\t.map(([key, schema]) => {\n\t\t\t\tconst info = describeZodField(schema);\n\t\t\t\treturn info ? `\\`${key}\\` (${info})` : `\\`${key}\\``;\n\t\t\t})\n\t\t\t.join(\", \");\n\t\tlines.push(`   Known fields: ${fieldList}.`);\n\t}\n\n\tlines.push(\n\t\t\"2. The response JSON `status` field tells you what to do next:\",\n\t\t'   - `\"interrupt\"`: Pause and ask the user. Two forms:',\n\t\t\"     a. Single question: `{ question, field, context? }` — ask `question`, store answer in `field`.\",\n\t\t\"     b. Multi-question: `{ questions: [{question, field}, ...], context? }` — ask ALL questions\",\n\t\t\"        in one conversational message, collect all answers.\",\n\t\t\"     `context` (if present) is hidden AI instructions — use to shape your response, do NOT show verbatim.\",\n\t\t\"     Then call again with:\",\n\t\t'     `action: \"continue\"`, `flowToken` = the `flowToken` from the response (pass back exactly as received),',\n\t\t\"     `stateUpdates` = answers keyed by their `field` names, plus any other fields the user mentioned.\",\n\t\t'   - `\"widget\"`: The flow wants to show a UI widget. Call the tool named in the `tool`',\n\t\t\"     field, passing the `data` object as the tool's input.\",\n\t\t\"     If the response includes `interactive: false`, the widget is display-only:\",\n\t\t\"     call the display tool, show the widget, then immediately call THIS flow tool again with\",\n\t\t'     `action: \"continue\"` and the same `flowToken`. In that case, do NOT wait for the user',\n\t\t\"     to click or use the widget, and do NOT ask them to interact with it unless the\",\n\t\t\"     description explicitly says otherwise.\",\n\t\t\"     Otherwise, present the widget result to the user. When the user makes a choice or interacts\",\n\t\t\"     with the widget, call THIS flow tool again with:\",\n\t\t'     `action: \"continue\"`, `flowToken` = the `flowToken` from the response,',\n\t\t\"     `stateUpdates` = `{ [field]: <user's selection> }` plus any other fields the user mentioned.\",\n\t\t'   - `\"complete\"`: The flow is done. Present the result to the user.',\n\t\t'   - `\"error\"`: Something went wrong. Show the `error` message.',\n\t\t\"\",\n\t\t\"3. ALWAYS pass back the `flowToken` string exactly as received — it is an opaque token, do not modify it.\",\n\t\t\"4. Do NOT invent state values. Only use `stateUpdates` for information the user explicitly provided.\",\n\t\t\"5. Include only the fields the user actually answered in `stateUpdates` — do NOT guess missing ones.\",\n\t\t\"   If the user did not answer all pending questions, the engine will re-prompt for the remaining ones.\",\n\t\t\"   If the user mentioned values for other known fields, include those too —\",\n\t\t\"   they will be applied immediately and those steps will be auto-skipped.\",\n\t);\n\n\treturn lines.join(\"\\n\");\n}\n\nfunction getInputMeta(args: FlowToolInput): FlowTokenContent & {\n\tstate: Record<string, unknown>;\n} {\n\tif (args.flowToken) {\n\t\tconst decoded = decodeFlowToken(args.flowToken);\n\t\tif (decoded) return decoded;\n\t}\n\treturn { step: undefined as unknown as string, state: {} };\n}\n\n// ============================================================================\n// Edge resolution\n// ============================================================================\n\nasync function resolveNextNode<TState extends Record<string, unknown>>(\n\tedge: Edge<TState>,\n\tstate: Partial<TState>,\n): Promise<string> {\n\tif (edge.type === \"direct\") return edge.to;\n\treturn edge.condition(state);\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/** Check whether a state value counts as \"filled\" (not empty/missing). */\nfunction isFilled(v: unknown): boolean {\n\treturn v !== undefined && v !== null && v !== \"\";\n}\n\n// ============================================================================\n// Interrupt result builder\n// ============================================================================\n\ntype InterruptQuestionData = {\n\tquestion: string;\n\tfield: string;\n\tsuggestions?: string[];\n\tcontext?: string;\n};\n\n/**\n * Build an interrupt ExecutionResult from a list of questions and current state.\n * Filters out already-answered questions and caches the full question list in\n * flowMeta so partial-answer continues can filter without re-executing the handler.\n *\n * Returns `null` when all questions are already filled (caller should advance).\n */\nfunction buildInterruptResult<TState extends Record<string, unknown>>(\n\tquestions: InterruptQuestionData[],\n\tcontext: string | undefined,\n\tcurrentNode: string,\n\tstate: TState,\n): ExecutionResult | null {\n\t// All filled — caller should advance to the next node\n\tif (questions.every((q) => isFilled(state[q.field as keyof TState]))) {\n\t\treturn null;\n\t}\n\n\t// Filter out questions whose fields are already answered\n\tconst unanswered = questions.filter(\n\t\t(q) => !isFilled(state[q.field as keyof TState]),\n\t);\n\n\t// Single-question shorthand: unwrap for cleaner AI payload\n\tconst isSingle = unanswered.length === 1;\n\tconst q0 = unanswered[0];\n\tconst payload =\n\t\tisSingle && q0\n\t\t\t? {\n\t\t\t\t\tstatus: \"interrupt\" as const,\n\t\t\t\t\tquestion: q0.question,\n\t\t\t\t\tfield: q0.field,\n\t\t\t\t\t...(q0.suggestions ? { suggestions: q0.suggestions } : {}),\n\t\t\t\t\t...(q0.context || context ? { context: q0.context ?? context } : {}),\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\tstatus: \"interrupt\" as const,\n\t\t\t\t\tquestions: unanswered,\n\t\t\t\t\t...(context ? { context } : {}),\n\t\t\t\t};\n\n\treturn {\n\t\tcontent: payload,\n\t\tflowTokenContent: {\n\t\t\tstep: currentNode,\n\t\t\tstate,\n\t\t\t...(isSingle && q0 ? { field: q0.field } : {}),\n\t\t\t// Cache the full question list so partial-answer continues\n\t\t\t// can filter without re-executing the node handler.\n\t\t\tquestions,\n\t\t\t...(context ? { interruptContext: context } : {}),\n\t\t},\n\t};\n}\n\n// ============================================================================\n// Validator type\n// ============================================================================\n\ntype ValidateFn = (\n\tvalue: unknown,\n\t// biome-ignore lint/suspicious/noConfusingVoidType: void needed for async () => {} validators\n) => MaybePromise<Record<string, unknown> | void>;\n\n// ============================================================================\n// Execution engine\n// ============================================================================\n\nasync function executeFrom<TState extends Record<string, unknown>>(\n\tstartNodeName: string,\n\tstartState: TState,\n\tnodes: Map<string, NodeHandler<TState>>,\n\tedges: Map<string, Edge<TState>>,\n\tvalidators: Map<string, ValidateFn>,\n\tmeta?: Record<string, unknown>,\n): Promise<ExecutionResult> {\n\tlet currentNode = startNodeName;\n\tlet state = { ...startState };\n\n\t// Safety limit to prevent infinite loops\n\tconst MAX_ITERATIONS = 50;\n\tlet iterations = 0;\n\n\twhile (iterations++ < MAX_ITERATIONS) {\n\t\t// Reached END\n\t\tif (currentNode === END) {\n\t\t\treturn {\n\t\t\t\tcontent: { status: \"complete\" },\n\t\t\t\tflowTokenContent: { state },\n\t\t\t};\n\t\t}\n\n\t\tconst handler = nodes.get(currentNode);\n\t\tif (!handler) {\n\t\t\treturn {\n\t\t\t\tcontent: {\n\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\terror: `Unknown node: \"${currentNode}\"`,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\ttry {\n\t\t\t// Build context object for the handler\n\t\t\tconst ctx = {\n\t\t\t\tstate,\n\t\t\t\tmeta,\n\t\t\t\tinterrupt: interrupt as NodeHandler<TState> extends never\n\t\t\t\t\t? never\n\t\t\t\t\t: typeof interrupt,\n\t\t\t\tshowWidget: showWidget as NodeHandler<TState> extends never\n\t\t\t\t\t? never\n\t\t\t\t\t: typeof showWidget,\n\t\t\t};\n\t\t\tconst result = await handler(ctx as Parameters<typeof handler>[0]);\n\n\t\t\t// Interrupt signal — pause and ask the user one or more questions\n\t\t\tif (isInterrupt(result)) {\n\t\t\t\t// Extract and store any validate functions from the interrupt questions\n\t\t\t\tfor (const q of result.questions) {\n\t\t\t\t\tif (q.validate) {\n\t\t\t\t\t\tvalidators.set(`${currentNode}:${q.field}`, q.validate);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst interruptResult = buildInterruptResult(\n\t\t\t\t\tresult.questions,\n\t\t\t\t\tresult.context,\n\t\t\t\t\tcurrentNode,\n\t\t\t\t\tstate,\n\t\t\t\t);\n\n\t\t\t\tif (interruptResult) {\n\t\t\t\t\treturn interruptResult;\n\t\t\t\t}\n\n\t\t\t\t// All questions filled — auto-skip to next node\n\t\t\t\tconst edge = edges.get(currentNode);\n\t\t\t\tif (!edge) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: {\n\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\terror: `No outgoing edge from node \"${currentNode}\"`,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcurrentNode = await resolveNextNode(edge, state);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Widget signal — delegate to display tool\n\t\t\tif (isWidget(result)) {\n\t\t\t\tconst widgetField = result.field;\n\t\t\t\tif (widgetField) {\n\t\t\t\t\tif (isFilled(state[widgetField as keyof TState])) {\n\t\t\t\t\t\tconst edge = edges.get(currentNode);\n\t\t\t\t\t\tif (!edge) {\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tcontent: {\n\t\t\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\t\t\terror: `No outgoing edge from node \"${currentNode}\"`,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\t\t\t\t\t\tcurrentNode = await resolveNextNode(edge, state);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"widget\",\n\t\t\t\t\t\ttool: result.tool.id,\n\t\t\t\t\t\tdata: result.data,\n\t\t\t\t\t\tdescription: result.description,\n\t\t\t\t\t\t...(result.interactive === false ? { interactive: false } : {}),\n\t\t\t\t\t},\n\t\t\t\t\tflowTokenContent: {\n\t\t\t\t\t\tstep: currentNode,\n\t\t\t\t\t\tstate,\n\t\t\t\t\t\tfield: widgetField,\n\t\t\t\t\t\twidgetId: result.tool.id,\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Action node — merge state and auto-advance\n\t\t\tstate = { ...state, ...result } as TState;\n\n\t\t\tconst edge = edges.get(currentNode);\n\t\t\tif (!edge) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: `No outgoing edge from node \"${currentNode}\"`,\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\t\t\tcurrentNode = await resolveNextNode(edge, state);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tcontent: { status: \"error\", error: message },\n\t\t\t\tflowTokenContent: { step: currentNode, state },\n\t\t\t};\n\t\t}\n\t}\n\n\treturn {\n\t\tcontent: {\n\t\t\tstatus: \"error\",\n\t\t\terror: \"Flow exceeded maximum iterations (possible infinite loop)\",\n\t\t},\n\t};\n}\n\n// ============================================================================\n// Compile\n// ============================================================================\n\nconst inputSchema = {\n\taction: z\n\t\t.enum([\"start\", \"continue\"])\n\t\t.describe(\n\t\t\t'\"start\" to begin the flow, \"continue\" to resume after a pause (interrupt or widget)',\n\t\t),\n\tstateUpdates: z\n\t\t.record(z.string(), z.unknown())\n\t\t.optional()\n\t\t.describe(\n\t\t\t\"State field values to set before processing the next node. Use this to pass the user's answer (keyed by the field name from the response) and any other values the user mentioned.\",\n\t\t),\n\tflowToken: z\n\t\t.string()\n\t\t.optional()\n\t\t.describe(\n\t\t\t\"Opaque flow token from the previous response. Pass back exactly as received.\",\n\t\t),\n};\n\nexport function compileFlow<TState extends Record<string, unknown>>(\n\tinput: CompileInput<TState>,\n): RegisteredFlow {\n\tconst { config, nodes, edges } = input;\n\tconst protocol = buildFlowProtocol(config);\n\tconst fullDescription = `${config.description}\\n${protocol}`;\n\n\t// Validator storage — populated when handlers return interrupts with validate functions.\n\t// Keyed by \"nodeName:fieldName\", persists across tool calls within the same server.\n\tconst validators = new Map<string, ValidateFn>();\n\n\tasync function handleToolCall(\n\t\targs: FlowToolInput,\n\t\tmeta?: Record<string, unknown>,\n\t): Promise<ExecutionResult> {\n\t\tconst inputMeta = getInputMeta(args);\n\t\tconst state = inputMeta.state as TState;\n\n\t\tif (args.action === \"start\") {\n\t\t\tconst startEdge = edges.get(START);\n\t\t\tif (!startEdge) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: \"No start edge\",\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Merge pre-filled answers and any stateUpdates\n\t\t\tconst startState = {\n\t\t\t\t...state,\n\t\t\t\t...(args.stateUpdates ?? {}),\n\t\t\t} as TState;\n\n\t\t\tconst firstNode = await resolveNextNode(startEdge, startState);\n\t\t\treturn executeFrom(firstNode, startState, nodes, edges, validators, meta);\n\t\t}\n\n\t\tif (args.action === \"continue\") {\n\t\t\tconst step = inputMeta.step;\n\t\t\tif (!step) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: {\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t'Missing or invalid \"flowToken\" for continue action.' +\n\t\t\t\t\t\t\t\" Pass back the flowToken from the previous response exactly as received.\",\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet updatedState = {\n\t\t\t\t...state,\n\t\t\t\t...(args.stateUpdates ?? {}),\n\t\t\t} as TState;\n\n\t\t\t// If cached interrupt questions exist, check for unanswered questions\n\t\t\t// without re-executing the node handler (avoids side-effect replay).\n\t\t\tif (inputMeta.questions) {\n\t\t\t\tconst interruptResult = buildInterruptResult(\n\t\t\t\t\tinputMeta.questions,\n\t\t\t\t\tinputMeta.interruptContext,\n\t\t\t\t\tstep,\n\t\t\t\t\tupdatedState,\n\t\t\t\t);\n\n\t\t\t\t// results = the user has not answered all questions\n\t\t\t\tif (interruptResult) {\n\t\t\t\t\treturn interruptResult;\n\t\t\t\t}\n\n\t\t\t\t// All questions answered — run validators before advancing\n\t\t\t\tconst fieldValidators = inputMeta.questions\n\t\t\t\t\t.map((q) => ({\n\t\t\t\t\t\tfield: q.field,\n\t\t\t\t\t\tfn: validators.get(`${step}:${q.field}`),\n\t\t\t\t\t}))\n\t\t\t\t\t.filter((v): v is { field: string; fn: ValidateFn } => v.fn != null);\n\n\t\t\t\tfor (const { field, fn } of fieldValidators) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst value = updatedState[field as keyof TState];\n\t\t\t\t\t\tconst vResult = await fn(value);\n\t\t\t\t\t\tif (vResult && typeof vResult === \"object\") {\n\t\t\t\t\t\t\tupdatedState = {\n\t\t\t\t\t\t\t\t...updatedState,\n\t\t\t\t\t\t\t\t...vResult,\n\t\t\t\t\t\t\t} as TState;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\t// Validation failed — clear field and re-present interrupt\n\t\t\t\t\t\tconst msg = err instanceof Error ? err.message : String(err);\n\t\t\t\t\t\tdelete (updatedState as Record<string, unknown>)[field];\n\t\t\t\t\t\t// Prepend error to the specific question's context so it's visible\n\t\t\t\t\t\t// even when the question has its own context (which takes precedence\n\t\t\t\t\t\t// over the overall interrupt context in single-question shorthand).\n\t\t\t\t\t\tconst questionsWithError = inputMeta.questions.map((q) =>\n\t\t\t\t\t\t\tq.field === field\n\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\t...q,\n\t\t\t\t\t\t\t\t\t\tcontext: q.context\n\t\t\t\t\t\t\t\t\t\t\t? `ERROR: ${msg}\\n\\n${q.context}`\n\t\t\t\t\t\t\t\t\t\t\t: `ERROR: ${msg}`,\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t: q,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst result = buildInterruptResult(\n\t\t\t\t\t\t\tquestionsWithError,\n\t\t\t\t\t\t\tinputMeta.interruptContext,\n\t\t\t\t\t\t\tstep,\n\t\t\t\t\t\t\tupdatedState,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (result) return result;\n\t\t\t\t\t\t// Should never happen — we just cleared the field\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Advance to next node when: all cached questions are answered, or\n\t\t\t// this is a widget continue (widgets never have cached questions and\n\t\t\t// re-executing the handler would cause a stuck loop for field-less widgets).\n\t\t\t// Otherwise the AI may have dropped _meta.flow.questions — re-execute\n\t\t\t// from the current step so the handler can re-check unanswered questions.\n\t\t\tif (inputMeta.questions || inputMeta.widgetId) {\n\t\t\t\tconst edge = edges.get(step);\n\t\t\t\tif (!edge) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: {\n\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\terror: `No edge from step \"${step}\"`,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tconst nextNode = await resolveNextNode(edge, updatedState);\n\t\t\t\treturn executeFrom(\n\t\t\t\t\tnextNode,\n\t\t\t\t\tupdatedState,\n\t\t\t\t\tnodes,\n\t\t\t\t\tedges,\n\t\t\t\t\tvalidators,\n\t\t\t\t\tmeta,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\treturn executeFrom(step, updatedState, nodes, edges, validators, meta);\n\t\t}\n\n\t\treturn {\n\t\t\tcontent: {\n\t\t\t\tstatus: \"error\",\n\t\t\t\terror: `Unknown action: \"${args.action}\"`,\n\t\t\t},\n\t\t};\n\t}\n\n\treturn {\n\t\tid: config.id,\n\t\ttitle: config.title,\n\t\tdescription: fullDescription,\n\n\t\tasync register(server: McpServer): Promise<void> {\n\t\t\tserver.registerTool(\n\t\t\t\tconfig.id,\n\t\t\t\t{\n\t\t\t\t\ttitle: config.title,\n\t\t\t\t\tdescription: fullDescription,\n\t\t\t\t\tinputSchema,\n\t\t\t\t\tannotations: config.annotations,\n\t\t\t\t},\n\t\t\t\t(async (args: FlowToolInput, extra: unknown) => {\n\t\t\t\t\tconst requestExtra = extra as RequestHandlerExtra<\n\t\t\t\t\t\tServerRequest,\n\t\t\t\t\t\tServerNotification\n\t\t\t\t\t>;\n\t\t\t\t\tconst _meta: Record<string, unknown> = requestExtra._meta ?? {};\n\n\t\t\t\t\tconst result = await handleToolCall(args, _meta);\n\n\t\t\t\t\t// Encode flow state as opaque token for the model to pass back\n\t\t\t\t\tconst flowToken = result.flowTokenContent\n\t\t\t\t\t\t? encodeFlowToken(result.flowTokenContent)\n\t\t\t\t\t\t: undefined;\n\n\t\t\t\t\t// Text content includes the payload + flowToken for the model\n\t\t\t\t\tconst contentResponse: FlowContent = {\n\t\t\t\t\t\t...result.content,\n\t\t\t\t\t\t...(flowToken ? { flowToken } : {}),\n\t\t\t\t\t};\n\t\t\t\t\tconst content = [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\" as const,\n\t\t\t\t\t\t\ttext: JSON.stringify(contentResponse, null, 2),\n\t\t\t\t\t\t},\n\t\t\t\t\t];\n\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\t_meta,\n\t\t\t\t\t\t...(result.content.status === \"error\" ? { isError: true } : {}),\n\t\t\t\t\t};\n\t\t\t\t}) satisfies ToolCallback<typeof inputSchema>,\n\t\t\t);\n\t\t},\n\t};\n}\n","/**\n * Opaque compressed token for flow state round-tripping.\n *\n * Flow state is compressed (zlib deflate) then base64-encoded. This produces\n * a token that:\n * 1. Looks like random noise — models can't mentally decode it\n * 2. Is smaller than raw base64 (~30% compression on typical state)\n * 3. The model treats it as an opaque string and passes it back unchanged\n *\n * Only encoded/decoded on the server (Node.js). Browser code should never\n * need to decode flow tokens.\n */\n\nimport { deflateSync, inflateSync } from \"node:zlib\";\nimport type { FlowTokenContent } from \"./@types\";\n\nexport function encodeFlowToken(data: FlowTokenContent): string {\n\tconst json = JSON.stringify(data);\n\tconst compressed = deflateSync(json);\n\treturn compressed.toString(\"base64\");\n}\n\nexport function decodeFlowToken(token: string): FlowTokenContent | null {\n\ttry {\n\t\tconst compressed = Buffer.from(token, \"base64\");\n\t\tconst json = inflateSync(compressed).toString(\"utf-8\");\n\t\treturn JSON.parse(json) as FlowTokenContent;\n\t} catch {\n\t\treturn null;\n\t}\n}\n","import type {\n\tConditionFn,\n\tEdge,\n\tFlowConfig,\n\tNodeHandler,\n\tRegisteredFlow,\n} from \"./@types\";\nimport { END, START } from \"./@types\";\nimport { compileFlow } from \"./compile\";\n\n/**\n * A LangGraph-inspired state graph builder for MCP tools.\n *\n * @example\n * ```ts\n * const flow = new StateGraph<MyState>({\n *   id: \"onboarding\",\n *   title: \"User Onboarding\",\n *   description: \"Guides users through onboarding\",\n * })\n *   .addNode(\"ask_name\", ({ interrupt }) => interrupt({ question: \"What's your name?\", field: \"name\" }))\n *   .addNode(\"greet\", ({ state }) => ({ greeting: `Hello ${state.name}!` }))\n *   .addEdge(START, \"ask_name\")\n *   .addEdge(\"ask_name\", \"greet\")\n *   .addEdge(\"greet\", END)\n *   .compile();\n * ```\n */\nexport class StateGraph<TState extends Record<string, unknown>> {\n\tprivate nodes = new Map<string, NodeHandler<TState>>();\n\tprivate edges = new Map<string, Edge<TState>>();\n\tprivate config: FlowConfig;\n\n\tconstructor(config: FlowConfig) {\n\t\tthis.config = config;\n\t}\n\n\t/**\n\t * Add a node with a handler.\n\t *\n\t * The handler receives a context object with `state`, `meta`, `interrupt`, and `showWidget`.\n\t */\n\taddNode(name: string, handler: NodeHandler<TState>): this {\n\t\tif (name === START || name === END) {\n\t\t\tthrow new Error(\n\t\t\t\t`\"${name}\" is a reserved name and cannot be used as a node name`,\n\t\t\t);\n\t\t}\n\t\tif (this.nodes.has(name)) {\n\t\t\tthrow new Error(`Node \"${name}\" already exists`);\n\t\t}\n\n\t\tthis.nodes.set(name, handler);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Add a direct edge between two nodes.\n\t *\n\t * Use `START` as `from` to set the entry point.\n\t * Use `END` as `to` to mark a terminal node.\n\t */\n\taddEdge(from: string, to: string): this {\n\t\tif (this.edges.has(from)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Node \"${from}\" already has an outgoing edge. Use addConditionalEdge for branching.`,\n\t\t\t);\n\t\t}\n\t\tthis.edges.set(from, { type: \"direct\", to });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Add a conditional edge from a node.\n\t *\n\t * The condition function receives current state and returns the name of the next node.\n\t */\n\taddConditionalEdge(from: string, condition: ConditionFn<TState>): this {\n\t\tif (this.edges.has(from)) {\n\t\t\tthrow new Error(`Node \"${from}\" already has an outgoing edge.`);\n\t\t}\n\t\tthis.edges.set(from, { type: \"conditional\", condition });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Compile the graph into a RegisteredFlow that can be registered on an McpServer.\n\t *\n\t * Validates the graph structure and returns a registration-compatible object.\n\t */\n\tcompile(): RegisteredFlow {\n\t\tthis.validate();\n\n\t\treturn compileFlow<TState>({\n\t\t\tconfig: this.config,\n\t\t\tnodes: new Map(this.nodes),\n\t\t\tedges: new Map(this.edges),\n\t\t});\n\t}\n\n\tprivate validate(): void {\n\t\t// Must have a START edge\n\t\tif (!this.edges.has(START)) {\n\t\t\tthrow new Error(\n\t\t\t\t'Flow must have an entry point. Add an edge from START: .addEdge(START, \"first_node\")',\n\t\t\t);\n\t\t}\n\n\t\t// START edge target must exist\n\t\tconst startEdge = this.edges.get(START);\n\t\tif (\n\t\t\tstartEdge?.type === \"direct\" &&\n\t\t\tstartEdge.to !== END &&\n\t\t\t!this.nodes.has(startEdge.to)\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t`START edge references non-existent node: \"${startEdge.to}\"`,\n\t\t\t);\n\t\t}\n\n\t\t// All static edge targets must reference existing nodes (or END)\n\t\tfor (const [from, edge] of this.edges) {\n\t\t\tif (from !== START && !this.nodes.has(from)) {\n\t\t\t\tthrow new Error(`Edge from non-existent node: \"${from}\"`);\n\t\t\t}\n\t\t\tif (\n\t\t\t\tedge.type === \"direct\" &&\n\t\t\t\tedge.to !== END &&\n\t\t\t\t!this.nodes.has(edge.to)\n\t\t\t) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Edge from \"${from}\" references non-existent node: \"${edge.to}\"`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\t// Every node must have an outgoing edge\n\t\tfor (const [name] of this.nodes) {\n\t\t\tif (!this.edges.has(name)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Node \"${name}\" has no outgoing edge. Add one with .addEdge(\"${name}\", ...) or .addConditionalEdge(\"${name}\", ...)`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n}\n","import type { z } from \"zod\";\nimport type { FlowConfig, InferFlowState } from \"./@types\";\nimport { StateGraph } from \"./state-graph\";\n\n/**\n * Create a new flow graph — convenience factory for `new StateGraph()`.\n *\n * The state type is automatically inferred from the `state` definition —\n * no explicit generic parameter needed.\n *\n * @example\n * ```ts\n * import { createFlow, interrupt, START, END } from \"@waniwani/sdk/mcp\";\n * import { z } from \"zod\";\n *\n * const flow = createFlow({\n *   id: \"onboarding\",\n *   title: \"User Onboarding\",\n *   description: \"Guides users through onboarding. Use when a user wants to get started.\",\n *   state: {\n *     name: z.string().describe(\"The user's name\"),\n *     email: z.string().describe(\"The user's email address\"),\n *   },\n * })\n *   .addNode(\"ask_name\", () => interrupt({ question: \"What's your name?\", field: \"name\" }))\n *   .addNode(\"ask_email\", () => interrupt({ question: \"What's your email?\", field: \"email\" }))\n *   .addEdge(START, \"ask_name\")\n *   .addEdge(\"ask_name\", \"ask_email\")\n *   .addEdge(\"ask_email\", END)\n *   .compile();\n * ```\n */\nexport function createFlow<const TSchema extends Record<string, z.ZodType>>(\n\tconfig: Omit<FlowConfig, \"state\"> & { state: TSchema },\n): StateGraph<InferFlowState<TSchema>> {\n\treturn new StateGraph<InferFlowState<TSchema>>(config);\n}\n","import type { WidgetCSP } from \"./types\";\n\n/**\n * MIME types for widget resources.\n * OpenAI Apps SDK uses \"text/html+skybridge\"\n * MCP Apps uses \"text/html;profile=mcp-app\"\n */\nexport const MIME_TYPE_OPENAI = \"text/html+skybridge\";\nexport const MIME_TYPE_MCP = \"text/html;profile=mcp-app\";\n\n// ---- HTML fetching ----\n\nexport const fetchHtml = async (\n\tbaseUrl: string,\n\tpath: string,\n): Promise<string> => {\n\tconst normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n\tconst result = await fetch(`${normalizedBase}${path}`);\n\treturn await result.text();\n};\n\n// ---- OpenAI resource metadata ----\n\ninterface OpenAIResourceMeta {\n\t[key: string]: unknown;\n\t\"openai/widgetDescription\"?: string;\n\t\"openai/widgetPrefersBorder\"?: boolean;\n\t\"openai/widgetDomain\"?: string;\n\t\"openai/widgetCSP\"?: WidgetCSP;\n}\n\nexport function buildOpenAIResourceMeta(config: {\n\tdescription?: string;\n\tprefersBorder?: boolean;\n\twidgetDomain: string;\n\twidgetCSP?: WidgetCSP;\n}): OpenAIResourceMeta {\n\treturn {\n\t\t\"openai/widgetDescription\": config.description,\n\t\t\"openai/widgetPrefersBorder\": config.prefersBorder,\n\t\t\"openai/widgetDomain\": config.widgetDomain,\n\t\t...(config.widgetCSP && { \"openai/widgetCSP\": config.widgetCSP }),\n\t};\n}\n\n// ---- MCP Apps resource metadata ----\n\ninterface McpAppsResourceMeta {\n\t[key: string]: unknown;\n\tui?: {\n\t\tcsp?: {\n\t\t\tconnectDomains?: string[];\n\t\t\tresourceDomains?: string[];\n\t\t\tframeDomains?: string[];\n\t\t\tredirectDomains?: string[];\n\t\t};\n\t\tdomain?: string;\n\t\tprefersBorder?: boolean;\n\t};\n}\n\nexport function buildMcpAppsResourceMeta(config: {\n\tdescription?: string;\n\tprefersBorder?: boolean;\n\twidgetDomain?: string;\n\twidgetCSP?: WidgetCSP;\n}): McpAppsResourceMeta {\n\tconst csp = config.widgetCSP\n\t\t? {\n\t\t\t\tconnectDomains: config.widgetCSP.connect_domains,\n\t\t\t\tresourceDomains: config.widgetCSP.resource_domains,\n\t\t\t\tframeDomains: config.widgetCSP.frame_domains,\n\t\t\t\tredirectDomains: config.widgetCSP.redirect_domains,\n\t\t\t}\n\t\t: undefined;\n\n\treturn {\n\t\tui: {\n\t\t\t...(csp && { csp }),\n\t\t\t...(config.widgetDomain && { domain: config.widgetDomain }),\n\t\t\t...(config.prefersBorder !== undefined && {\n\t\t\t\tprefersBorder: config.prefersBorder,\n\t\t\t}),\n\t\t},\n\t};\n}\n\n// ---- Tool metadata (references resource URIs) ----\n\nexport function buildToolMeta(config: {\n\topenaiTemplateUri?: string;\n\tmcpTemplateUri?: string;\n\tinvoking: string;\n\tinvoked: string;\n\tautoHeight?: boolean;\n}) {\n\treturn {\n\t\t// OpenAI metadata\n\t\t...(config.openaiTemplateUri && {\n\t\t\t\"openai/outputTemplate\": config.openaiTemplateUri,\n\t\t}),\n\t\t\"openai/toolInvocation/invoking\": config.invoking,\n\t\t\"openai/toolInvocation/invoked\": config.invoked,\n\t\t\"openai/widgetAccessible\": true,\n\t\t\"openai/resultCanProduceWidget\": true,\n\t\t// MCP Apps metadata\n\t\t...(config.mcpTemplateUri && {\n\t\t\tui: {\n\t\t\t\tresourceUri: config.mcpTemplateUri,\n\t\t\t\t...(config.autoHeight && { autoHeight: true }),\n\t\t\t},\n\t\t}),\n\t};\n}\n","import {\n\tbuildMcpAppsResourceMeta,\n\tbuildOpenAIResourceMeta,\n\tfetchHtml,\n\tMIME_TYPE_MCP,\n\tMIME_TYPE_OPENAI,\n} from \"./meta\";\nimport type { McpServer, RegisteredResource, ResourceConfig } from \"./types\";\n\n/**\n * Creates a reusable UI resource (HTML template) that can be attached\n * to tools or flow nodes.\n *\n * @example\n * ```ts\n * const pricingUI = createResource({\n *   id: \"pricing_table\",\n *   title: \"Pricing Table\",\n *   baseUrl: \"https://my-app.com\",\n *   htmlPath: \"/widgets/pricing\",\n *   widgetDomain: \"my-app.com\",\n * });\n *\n * await pricingUI.register(server);\n * ```\n */\nexport function createResource(config: ResourceConfig): RegisteredResource {\n\tconst {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\t\tbaseUrl,\n\t\thtmlPath,\n\t\twidgetDomain,\n\t\tprefersBorder = true,\n\t\tautoHeight = true,\n\t} = config;\n\n\t// Auto-generate CSP from baseUrl if not explicitly provided\n\tlet widgetCSP = config.widgetCSP ?? {\n\t\tconnect_domains: [baseUrl],\n\t\tresource_domains: [baseUrl],\n\t};\n\n\t// In development with localhost, add extra CSP domains for\n\t// Next.js dev features (WebSocket HMR, Turbopack font serving)\n\tif (process.env.NODE_ENV === \"development\") {\n\t\ttry {\n\t\t\tconst { hostname } = new URL(baseUrl);\n\t\t\tif (hostname === \"localhost\" || hostname === \"127.0.0.1\") {\n\t\t\t\twidgetCSP = {\n\t\t\t\t\t...widgetCSP,\n\t\t\t\t\tconnect_domains: [\n\t\t\t\t\t\t...(widgetCSP.connect_domains || []),\n\t\t\t\t\t\t`ws://${hostname}:*`,\n\t\t\t\t\t\t`wss://${hostname}:*`,\n\t\t\t\t\t],\n\t\t\t\t\tresource_domains: [\n\t\t\t\t\t\t...(widgetCSP.resource_domains || []),\n\t\t\t\t\t\t`http://${hostname}:*`,\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t} catch {\n\t\t\t// Invalid baseUrl — skip dev CSP additions\n\t\t}\n\t}\n\n\tconst openaiUri = `ui://widgets/apps-sdk/${id}.html`;\n\tconst mcpUri = `ui://widgets/ext-apps/${id}.html`;\n\n\t// Lazy HTML — fetched once, shared across all calls\n\tlet htmlPromise: Promise<string> | null = null;\n\tconst getHtml = () => {\n\t\tif (!htmlPromise) htmlPromise = fetchHtml(baseUrl, htmlPath);\n\t\treturn htmlPromise;\n\t};\n\n\t// Use description for UI metadata\n\tconst uiDescription = description;\n\n\tasync function register(server: McpServer): Promise<void> {\n\t\tconst html = await getHtml();\n\n\t\t// Register OpenAI Apps SDK resource\n\t\tserver.registerResource(\n\t\t\t`${id}-openai-widget`,\n\t\t\topenaiUri,\n\t\t\t{\n\t\t\t\ttitle,\n\t\t\t\tdescription: uiDescription,\n\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t_meta: {\n\t\t\t\t\t\"openai/widgetDescription\": uiDescription,\n\t\t\t\t\t\"openai/widgetPrefersBorder\": prefersBorder,\n\t\t\t\t},\n\t\t\t},\n\t\t\tasync (uri) => ({\n\t\t\t\tcontents: [\n\t\t\t\t\t{\n\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t_meta: buildOpenAIResourceMeta({\n\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\twidgetDomain,\n\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\n\t\t// Register MCP Apps resource\n\t\tserver.registerResource(\n\t\t\t`${id}-mcp-widget`,\n\t\t\tmcpUri,\n\t\t\t{\n\t\t\t\ttitle,\n\t\t\t\tdescription: uiDescription,\n\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t_meta: {\n\t\t\t\t\tui: {\n\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t\tasync (uri) => ({\n\t\t\t\tcontents: [\n\t\t\t\t\t{\n\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t_meta: buildMcpAppsResourceMeta({\n\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t}),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}),\n\t\t);\n\t}\n\n\treturn {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\t\topenaiUri,\n\t\tmcpUri,\n\t\tautoHeight,\n\t\tregister,\n\t};\n}\n","import type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { ShapeOutput } from \"@modelcontextprotocol/sdk/server/zod-compat.js\";\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n\tServerNotification,\n\tServerRequest,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { z } from \"zod\";\nimport { buildToolMeta } from \"../resources/meta\";\nimport type {\n\tMcpServer,\n\tRegisteredTool,\n\tToolConfig,\n\tToolHandler,\n} from \"./types\";\n\n/**\n * Creates an MCP tool with minimal boilerplate.\n *\n * When `handler()` returns `data`, the tool includes it as MCP `structuredContent`.\n * When `config.resource` is provided, the tool also returns widget metadata.\n *\n * @example\n * ```ts\n * // Widget tool (with resource)\n * const pricingTool = createTool({\n *   resource: pricingUI,\n *   description: \"Show pricing comparison\",\n *   inputSchema: { postalCode: z.string() },\n * }, async ({ postalCode }) => ({\n *   text: \"Pricing loaded\",\n *   data: { postalCode, prices: [] },\n * }));\n *\n * // Plain tool (no resource)\n * const searchTool = createTool({\n *   id: \"search\",\n *   title: \"Search\",\n *   description: \"Search the knowledge base\",\n *   inputSchema: { query: z.string() },\n * }, async ({ query }) => ({\n *   text: `Results for \"${query}\"`,\n * }));\n * ```\n */\nexport function createTool<TInput extends z.ZodRawShape>(\n\tconfig: ToolConfig<TInput>,\n\thandler: ToolHandler<TInput>,\n): RegisteredTool {\n\tconst {\n\t\tresource,\n\t\tdescription,\n\t\tinputSchema,\n\t\tannotations,\n\t\tautoInjectResultText = true,\n\t} = config;\n\n\tconst id = config.id ?? resource?.id;\n\tconst title = config.title ?? resource?.title;\n\n\tif (!id) {\n\t\tthrow new Error(\n\t\t\t\"createTool: `id` is required when no resource is provided\",\n\t\t);\n\t}\n\tif (!title) {\n\t\tthrow new Error(\n\t\t\t\"createTool: `title` is required when no resource is provided\",\n\t\t);\n\t}\n\n\t// Build widget metadata only when resource is present\n\tconst toolMeta = resource\n\t\t? buildToolMeta({\n\t\t\t\topenaiTemplateUri: resource.openaiUri,\n\t\t\t\tmcpTemplateUri: resource.mcpUri,\n\t\t\t\tinvoking: config.invoking ?? \"Loading...\",\n\t\t\t\tinvoked: config.invoked ?? \"Loaded\",\n\t\t\t\tautoHeight: resource.autoHeight,\n\t\t\t})\n\t\t: undefined;\n\n\treturn {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\n\t\tasync register(server: McpServer): Promise<void> {\n\t\t\tserver.registerTool(\n\t\t\t\tid,\n\t\t\t\t{\n\t\t\t\t\ttitle,\n\t\t\t\t\tdescription,\n\t\t\t\t\tinputSchema,\n\t\t\t\t\tannotations,\n\t\t\t\t\t...(toolMeta && { _meta: toolMeta }),\n\t\t\t\t},\n\t\t\t\t(async (args: ShapeOutput<TInput>, extra: unknown) => {\n\t\t\t\t\tconst requestExtra = extra as RequestHandlerExtra<\n\t\t\t\t\t\tServerRequest,\n\t\t\t\t\t\tServerNotification\n\t\t\t\t\t>;\n\t\t\t\t\tconst _meta: Record<string, unknown> = requestExtra._meta ?? {};\n\n\t\t\t\t\tconst result = await handler(args, { extra: { _meta } });\n\n\t\t\t\t\t// Widget tool: return structuredContent + widget metadata\n\t\t\t\t\tif (resource && result.data) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: result.text }],\n\t\t\t\t\t\t\tstructuredContent: result.data,\n\t\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t\t...toolMeta,\n\t\t\t\t\t\t\t\t..._meta,\n\t\t\t\t\t\t\t\t...(autoInjectResultText === false\n\t\t\t\t\t\t\t\t\t? { \"waniwani/autoInjectResultText\": false }\n\t\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Plain tool: return text content, plus structuredContent when provided.\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: result.text }],\n\t\t\t\t\t\t...(result.data ? { structuredContent: result.data } : {}),\n\t\t\t\t\t\t...(autoInjectResultText === false\n\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t\t\t\t\"waniwani/autoInjectResultText\": false,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t};\n\t\t\t\t}) as unknown as ToolCallback<TInput>,\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * Registers multiple tools on the server\n */\nexport async function registerTools(\n\tserver: McpServer,\n\ttools: RegisteredTool[],\n): Promise<void> {\n\tawait Promise.all(tools.map((t) => t.register(server)));\n}\n","// WaniWani SDK - Errors\n\nexport class WaniWaniError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"WaniWaniError\";\n\t}\n}\n","// KB Client — thin HTTP wrapper for knowledge base API\n\nimport { WaniWaniError } from \"../error.js\";\nimport type { InternalConfig } from \"../types.js\";\nimport type {\n\tKbClient,\n\tKbIngestFile,\n\tKbIngestResult,\n\tKbSearchOptions,\n\tKbSource,\n\tSearchResult,\n} from \"./types.js\";\n\nconst SDK_NAME = \"@waniwani/sdk\";\n\nexport function createKbClient(config: InternalConfig): KbClient {\n\tconst { baseUrl, apiKey } = config;\n\n\tfunction requireApiKey(): string {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t\treturn apiKey;\n\t}\n\n\tasync function request<T>(\n\t\tmethod: \"GET\" | \"POST\",\n\t\tpath: string,\n\t\tbody?: unknown,\n\t): Promise<T> {\n\t\tconst key = requireApiKey();\n\t\tconst url = `${baseUrl.replace(/\\/$/, \"\")}${path}`;\n\n\t\tconst headers: Record<string, string> = {\n\t\t\tAuthorization: `Bearer ${key}`,\n\t\t\t\"X-WaniWani-SDK\": SDK_NAME,\n\t\t};\n\n\t\tconst init: RequestInit = { method, headers };\n\n\t\tif (body !== undefined) {\n\t\t\theaders[\"Content-Type\"] = \"application/json\";\n\t\t\tinit.body = JSON.stringify(body);\n\t\t}\n\n\t\tconst response = await fetch(url, init);\n\n\t\tif (!response.ok) {\n\t\t\tconst text = await response.text().catch(() => \"\");\n\t\t\tthrow new WaniWaniError(\n\t\t\t\ttext || `KB API error: HTTP ${response.status}`,\n\t\t\t\tresponse.status,\n\t\t\t);\n\t\t}\n\n\t\tconst json = (await response.json()) as { data: T };\n\t\treturn json.data;\n\t}\n\n\treturn {\n\t\tasync ingest(files: KbIngestFile[]): Promise<KbIngestResult> {\n\t\t\treturn request<KbIngestResult>(\"POST\", \"/api/mcp/kb/ingest\", {\n\t\t\t\tfiles,\n\t\t\t});\n\t\t},\n\n\t\tasync search(\n\t\t\tquery: string,\n\t\t\toptions?: KbSearchOptions,\n\t\t): Promise<SearchResult[]> {\n\t\t\treturn request<SearchResult[]>(\"POST\", \"/api/mcp/kb/search\", {\n\t\t\t\tquery,\n\t\t\t\t...options,\n\t\t\t});\n\t\t},\n\n\t\tasync sources(): Promise<KbSource[]> {\n\t\t\treturn request<KbSource[]>(\"GET\", \"/api/mcp/kb/sources\");\n\t\t},\n\t};\n}\n","import type { EventType, LegacyTrackEvent, TrackInput } from \"./@types.js\";\nimport type { V2CorrelationIds, V2EventEnvelope } from \"./v2-types.js\";\n\nconst DEFAULT_SOURCE = \"@waniwani/sdk\";\n\nexport interface MapTrackEventOptions {\n\tnow?: () => Date;\n\tgenerateId?: () => string;\n\tsource?: string;\n}\n\nexport function mapTrackEventToV2(\n\tinput: TrackInput,\n\toptions: MapTrackEventOptions = {},\n): V2EventEnvelope {\n\tconst now = options.now ?? (() => new Date());\n\tconst generateId = options.generateId ?? createEventId;\n\tconst eventName = resolveEventName(input);\n\tconst meta = toRecord(input.meta);\n\tconst metadata = toRecord(input.metadata);\n\tconst correlation = resolveCorrelationIds(input, meta);\n\tconst eventId = takeNonEmptyString(input.eventId) ?? generateId();\n\tconst timestamp = normalizeTimestamp(input.timestamp, now);\n\tconst source =\n\t\ttakeNonEmptyString(input.source) ?? options.source ?? DEFAULT_SOURCE;\n\tconst rawLegacy = isLegacyTrackEvent(input) ? { ...input } : undefined;\n\n\tconst mappedMetadata: Record<string, unknown> = {\n\t\t...metadata,\n\t};\n\tif (Object.keys(meta).length > 0) mappedMetadata.meta = meta;\n\tif (rawLegacy) mappedMetadata.rawLegacy = rawLegacy;\n\n\treturn {\n\t\tid: eventId,\n\t\ttype: \"mcp.event\",\n\t\tname: eventName,\n\t\tsource,\n\t\ttimestamp,\n\t\tcorrelation,\n\t\tproperties: mapProperties(input, eventName),\n\t\tmetadata: mappedMetadata,\n\t\trawLegacy,\n\t};\n}\n\nexport function createEventId(): string {\n\tif (\n\t\ttypeof crypto !== \"undefined\" &&\n\t\ttypeof crypto.randomUUID === \"function\"\n\t) {\n\t\treturn `evt_${crypto.randomUUID()}`;\n\t}\n\n\treturn `evt_${Math.random().toString(36).slice(2, 10)}_${Date.now().toString(36)}`;\n}\n\nfunction mapProperties(\n\tinput: TrackInput,\n\teventName: EventType,\n): Record<string, unknown> {\n\tif (!isLegacyTrackEvent(input)) {\n\t\treturn toRecord(input.properties);\n\t}\n\n\tconst legacyProperties = mapLegacyProperties(input, eventName);\n\tconst explicitProperties = toRecord(input.properties);\n\treturn {\n\t\t...legacyProperties,\n\t\t...explicitProperties,\n\t};\n}\n\nfunction mapLegacyProperties(\n\tinput: LegacyTrackEvent,\n\teventName: EventType,\n): Record<string, unknown> {\n\tswitch (eventName) {\n\t\tcase \"tool.called\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (takeNonEmptyString(input.toolName)) properties.name = input.toolName;\n\t\t\tif (takeNonEmptyString(input.toolType)) properties.type = input.toolType;\n\t\t\treturn properties;\n\t\t}\n\t\tcase \"quote.succeeded\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (typeof input.quoteAmount === \"number\") {\n\t\t\t\tproperties.amount = input.quoteAmount;\n\t\t\t}\n\t\t\tif (takeNonEmptyString(input.quoteCurrency)) {\n\t\t\t\tproperties.currency = input.quoteCurrency;\n\t\t\t}\n\t\t\treturn properties;\n\t\t}\n\t\tcase \"link.clicked\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (takeNonEmptyString(input.linkUrl)) properties.url = input.linkUrl;\n\t\t\treturn properties;\n\t\t}\n\t\tcase \"purchase.completed\": {\n\t\t\tconst properties: Record<string, unknown> = {};\n\t\t\tif (typeof input.purchaseAmount === \"number\") {\n\t\t\t\tproperties.amount = input.purchaseAmount;\n\t\t\t}\n\t\t\tif (takeNonEmptyString(input.purchaseCurrency)) {\n\t\t\t\tproperties.currency = input.purchaseCurrency;\n\t\t\t}\n\t\t\treturn properties;\n\t\t}\n\t\tdefault:\n\t\t\treturn {};\n\t}\n}\n\nfunction resolveEventName(input: TrackInput): EventType {\n\tif (isLegacyTrackEvent(input)) return input.eventType;\n\treturn input.event;\n}\n\nfunction resolveCorrelationIds(\n\tinput: TrackInput,\n\tmeta: Record<string, unknown>,\n): V2CorrelationIds {\n\tconst requestId =\n\t\ttakeNonEmptyString(input.requestId) ??\n\t\tpickFirstString(meta, [\"openai/requestId\", \"requestId\", \"mcp/requestId\"]);\n\n\tconst sessionId =\n\t\ttakeNonEmptyString(input.sessionId) ??\n\t\tpickFirstString(meta, [\n\t\t\t\"openai/sessionId\",\n\t\t\t\"sessionId\",\n\t\t\t\"conversationId\",\n\t\t\t\"anthropic/sessionId\",\n\t\t]);\n\n\tconst traceId =\n\t\ttakeNonEmptyString(input.traceId) ??\n\t\tpickFirstString(meta, [\n\t\t\t\"openai/traceId\",\n\t\t\t\"traceId\",\n\t\t\t\"mcp/traceId\",\n\t\t\t\"openai/requestId\",\n\t\t\t\"requestId\",\n\t\t]);\n\n\tconst externalUserId =\n\t\ttakeNonEmptyString(input.externalUserId) ??\n\t\tpickFirstString(meta, [\n\t\t\t\"openai/userId\",\n\t\t\t\"externalUserId\",\n\t\t\t\"userId\",\n\t\t\t\"actorId\",\n\t\t]);\n\n\tconst correlationId =\n\t\ttakeNonEmptyString(input.correlationId) ??\n\t\tpickFirstString(meta, [\"correlationId\", \"openai/requestId\"]) ??\n\t\trequestId;\n\n\tconst correlation: V2CorrelationIds = {};\n\tif (sessionId) correlation.sessionId = sessionId;\n\tif (traceId) correlation.traceId = traceId;\n\tif (requestId) correlation.requestId = requestId;\n\tif (correlationId) correlation.correlationId = correlationId;\n\tif (externalUserId) correlation.externalUserId = externalUserId;\n\treturn correlation;\n}\n\nfunction normalizeTimestamp(\n\tinput: string | Date | undefined,\n\tnow: () => Date,\n): string {\n\tif (input instanceof Date) return input.toISOString();\n\tif (typeof input === \"string\") {\n\t\tconst date = new Date(input);\n\t\tif (!Number.isNaN(date.getTime())) return date.toISOString();\n\t}\n\treturn now().toISOString();\n}\n\nfunction pickFirstString(\n\trecord: Record<string, unknown>,\n\tkeys: readonly string[],\n): string | undefined {\n\tfor (const key of keys) {\n\t\tconst value = record[key];\n\t\tif (typeof value === \"string\" && value.trim().length > 0) {\n\t\t\treturn value;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction toRecord(value: unknown): Record<string, unknown> {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\treturn {};\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction takeNonEmptyString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tif (value.trim().length === 0) return undefined;\n\treturn value;\n}\n\nfunction isLegacyTrackEvent(input: TrackInput): input is LegacyTrackEvent {\n\treturn \"eventType\" in input;\n}\n","import type {\n\tTrackingShutdownOptions,\n\tTrackingShutdownResult,\n} from \"./@types.js\";\nimport type {\n\tV2BatchRejectedEvent,\n\tV2BatchRequest,\n\tV2BatchResponse,\n\tV2EventEnvelope,\n} from \"./v2-types.js\";\n\nconst DEFAULT_ENDPOINT_PATH = \"/api/mcp/events/v2/batch\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 1_000;\nconst DEFAULT_MAX_BATCH_SIZE = 20;\nconst DEFAULT_MAX_BUFFER_SIZE = 1_000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_RETRY_BASE_DELAY_MS = 200;\nconst DEFAULT_RETRY_MAX_DELAY_MS = 2_000;\nconst DEFAULT_SHUTDOWN_TIMEOUT_MS = 2_000;\nconst SDK_NAME = \"@waniwani/sdk\";\n\nconst AUTH_FAILURE_STATUS = new Set([401, 403]);\nconst RETRYABLE_STATUS = new Set([408, 425, 429, 500, 502, 503, 504]);\n\ninterface Logger {\n\twarn: (message: string, ...args: unknown[]) => void;\n\terror: (message: string, ...args: unknown[]) => void;\n}\n\nexport interface V2TransportOptions {\n\tbaseUrl: string;\n\tapiKey: string;\n\tendpointPath?: string;\n\tflushIntervalMs?: number;\n\tmaxBatchSize?: number;\n\tmaxBufferSize?: number;\n\tmaxRetries?: number;\n\tretryBaseDelayMs?: number;\n\tretryMaxDelayMs?: number;\n\tshutdownTimeoutMs?: number;\n\tsdkVersion?: string;\n\tfetchFn?: typeof fetch;\n\tlogger?: Logger;\n\tnow?: () => Date;\n\tsleep?: (delayMs: number) => Promise<void>;\n}\n\nexport interface V2BatchTransport {\n\tenqueue: (event: V2EventEnvelope) => void;\n\tflush: () => Promise<void>;\n\tshutdown: (\n\t\toptions?: TrackingShutdownOptions,\n\t) => Promise<TrackingShutdownResult>;\n\tpendingEvents: () => number;\n}\n\ntype SendBatchResult =\n\t| { kind: \"success\" }\n\t| { kind: \"retryable\"; reason: string }\n\t| { kind: \"permanent\"; reason: string }\n\t| { kind: \"auth\"; status: number }\n\t| {\n\t\t\tkind: \"partial\";\n\t\t\tretryable: V2EventEnvelope[];\n\t\t\tpermanent: V2EventEnvelope[];\n\t  };\n\nexport function createV2BatchTransport(\n\toptions: V2TransportOptions,\n): V2BatchTransport {\n\treturn new BatchingV2Transport(options);\n}\n\nclass BatchingV2Transport implements V2BatchTransport {\n\tprivate readonly endpointUrl: string;\n\tprivate readonly flushIntervalMs: number;\n\tprivate readonly maxBatchSize: number;\n\tprivate readonly maxBufferSize: number;\n\tprivate readonly maxRetries: number;\n\tprivate readonly retryBaseDelayMs: number;\n\tprivate readonly retryMaxDelayMs: number;\n\tprivate readonly shutdownTimeoutMs: number;\n\tprivate readonly sdkVersion?: string;\n\tprivate readonly fetchFn: typeof fetch;\n\tprivate readonly logger: Logger;\n\tprivate readonly now: () => Date;\n\tprivate readonly sleep: (delayMs: number) => Promise<void>;\n\tprivate readonly apiKey: string;\n\n\tprivate readonly buffer: V2EventEnvelope[] = [];\n\tprivate flushTimer: ReturnType<typeof setInterval> | undefined;\n\tprivate flushScheduled = false;\n\tprivate flushScheduledTimer: ReturnType<typeof setTimeout> | undefined;\n\tprivate flushInFlight: Promise<void> | undefined;\n\tprivate inFlightCount = 0;\n\tprivate isStopped = false;\n\tprivate isShuttingDown = false;\n\n\tconstructor(options: V2TransportOptions) {\n\t\tthis.endpointUrl = joinUrl(\n\t\t\toptions.baseUrl,\n\t\t\toptions.endpointPath ?? DEFAULT_ENDPOINT_PATH,\n\t\t);\n\t\tthis.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;\n\t\tthis.maxBatchSize = options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;\n\t\tthis.maxBufferSize = options.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE;\n\t\tthis.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n\t\tthis.retryBaseDelayMs =\n\t\t\toptions.retryBaseDelayMs ?? DEFAULT_RETRY_BASE_DELAY_MS;\n\t\tthis.retryMaxDelayMs =\n\t\t\toptions.retryMaxDelayMs ?? DEFAULT_RETRY_MAX_DELAY_MS;\n\t\tthis.shutdownTimeoutMs =\n\t\t\toptions.shutdownTimeoutMs ?? DEFAULT_SHUTDOWN_TIMEOUT_MS;\n\t\tthis.fetchFn = options.fetchFn ?? fetch;\n\t\tthis.logger = options.logger ?? console;\n\t\tthis.now = options.now ?? (() => new Date());\n\t\tthis.sleep =\n\t\t\toptions.sleep ??\n\t\t\t((delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)));\n\t\tthis.apiKey = options.apiKey;\n\t\tthis.sdkVersion = options.sdkVersion;\n\n\t\tif (this.flushIntervalMs > 0) {\n\t\t\tthis.flushTimer = setInterval(() => {\n\t\t\t\tvoid this.flush();\n\t\t\t}, this.flushIntervalMs);\n\t\t}\n\t}\n\n\tenqueue(event: V2EventEnvelope): void {\n\t\tif (this.isStopped || this.isShuttingDown) {\n\t\t\tthis.logger.warn(\n\t\t\t\t\"[WaniWani] Tracking transport is stopped, dropping event %s\",\n\t\t\t\tevent.id,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.buffer.length >= this.maxBufferSize) {\n\t\t\tconst dropCount = this.buffer.length - this.maxBufferSize + 1;\n\t\t\tthis.buffer.splice(0, dropCount);\n\t\t\tthis.logger.warn(\n\t\t\t\t\"[WaniWani] Tracking buffer overflow, dropped %d oldest event(s)\",\n\t\t\t\tdropCount,\n\t\t\t);\n\t\t}\n\n\t\tthis.buffer.push(event);\n\n\t\tif (this.buffer.length >= this.maxBatchSize) {\n\t\t\tvoid this.flush();\n\t\t\treturn;\n\t\t}\n\n\t\tthis.scheduleMicroFlush();\n\t}\n\n\tpendingEvents(): number {\n\t\treturn this.buffer.length + this.inFlightCount;\n\t}\n\n\tasync flush(): Promise<void> {\n\t\tif (this.flushInFlight) return this.flushInFlight;\n\t\tthis.flushInFlight = this.flushLoop().finally(() => {\n\t\t\tthis.flushInFlight = undefined;\n\t\t});\n\t\treturn this.flushInFlight;\n\t}\n\n\tasync shutdown(\n\t\toptions?: TrackingShutdownOptions,\n\t): Promise<TrackingShutdownResult> {\n\t\tthis.isShuttingDown = true;\n\t\tif (this.flushTimer) {\n\t\t\tclearInterval(this.flushTimer);\n\t\t\tthis.flushTimer = undefined;\n\t\t}\n\t\tif (this.flushScheduledTimer) {\n\t\t\tclearTimeout(this.flushScheduledTimer);\n\t\t\tthis.flushScheduledTimer = undefined;\n\t\t\tthis.flushScheduled = false;\n\t\t}\n\n\t\tconst timeoutMs = options?.timeoutMs ?? this.shutdownTimeoutMs;\n\t\tconst flushPromise = this.flush();\n\n\t\tif (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n\t\t\tawait flushPromise;\n\t\t\tthis.isStopped = true;\n\t\t\treturn { timedOut: false, pendingEvents: this.pendingEvents() };\n\t\t}\n\n\t\tconst timeoutSignal = Symbol(\"shutdown-timeout\");\n\t\tconst result = await Promise.race([\n\t\t\tflushPromise.then(() => \"flushed\" as const),\n\t\t\tthis.sleep(timeoutMs).then(() => timeoutSignal),\n\t\t]);\n\n\t\tif (result === timeoutSignal) {\n\t\t\tthis.isStopped = true;\n\t\t\treturn { timedOut: true, pendingEvents: this.pendingEvents() };\n\t\t}\n\n\t\tthis.isStopped = true;\n\t\treturn { timedOut: false, pendingEvents: this.pendingEvents() };\n\t}\n\n\tprivate scheduleMicroFlush(): void {\n\t\tif (this.flushScheduled) return;\n\t\tthis.flushScheduled = true;\n\t\tthis.flushScheduledTimer = setTimeout(() => {\n\t\t\tthis.flushScheduledTimer = undefined;\n\t\t\tthis.flushScheduled = false;\n\t\t\tvoid this.flush();\n\t\t}, 0);\n\t}\n\n\tprivate async flushLoop(): Promise<void> {\n\t\twhile (this.buffer.length > 0 && !this.isStopped) {\n\t\t\tconst batch = this.buffer.splice(0, this.maxBatchSize);\n\t\t\tawait this.sendBatchWithRetry(batch);\n\t\t}\n\t}\n\n\tprivate async sendBatchWithRetry(batch: V2EventEnvelope[]): Promise<void> {\n\t\tlet attempt = 0;\n\t\tlet pendingBatch = batch;\n\n\t\twhile (pendingBatch.length > 0 && !this.isStopped) {\n\t\t\tthis.inFlightCount = pendingBatch.length;\n\t\t\tconst result = await this.sendBatchOnce(pendingBatch);\n\t\t\tthis.inFlightCount = 0;\n\n\t\t\tswitch (result.kind) {\n\t\t\t\tcase \"success\":\n\t\t\t\t\treturn;\n\t\t\t\tcase \"auth\":\n\t\t\t\t\tthis.stopTransportForAuthFailure(result.status, pendingBatch.length);\n\t\t\t\t\treturn;\n\t\t\t\tcase \"permanent\":\n\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\"[WaniWani] Dropping %d event(s) after permanent failure: %s\",\n\t\t\t\t\t\tpendingBatch.length,\n\t\t\t\t\t\tresult.reason,\n\t\t\t\t\t);\n\t\t\t\t\treturn;\n\t\t\t\tcase \"retryable\":\n\t\t\t\t\tif (attempt >= this.maxRetries) {\n\t\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\t\"[WaniWani] Dropping %d event(s) after retry exhaustion: %s\",\n\t\t\t\t\t\t\tpendingBatch.length,\n\t\t\t\t\t\t\tresult.reason,\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tawait this.sleep(this.backoffDelayMs(attempt));\n\t\t\t\t\tattempt += 1;\n\t\t\t\t\tcontinue;\n\t\t\t\tcase \"partial\":\n\t\t\t\t\tif (result.permanent.length > 0) {\n\t\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\t\"[WaniWani] Dropping %d event(s) rejected as permanent\",\n\t\t\t\t\t\t\tresult.permanent.length,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (result.retryable.length === 0) return;\n\t\t\t\t\tif (attempt >= this.maxRetries) {\n\t\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t\t\"[WaniWani] Dropping %d retryable event(s) after retry exhaustion\",\n\t\t\t\t\t\t\tresult.retryable.length,\n\t\t\t\t\t\t);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tpendingBatch = result.retryable;\n\t\t\t\t\tawait this.sleep(this.backoffDelayMs(attempt));\n\t\t\t\t\tattempt += 1;\n\t\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async sendBatchOnce(\n\t\tevents: V2EventEnvelope[],\n\t): Promise<SendBatchResult> {\n\t\tlet response: Response;\n\n\t\ttry {\n\t\t\tresponse = await this.fetchFn(this.endpointUrl, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${this.apiKey}`,\n\t\t\t\t\t\"X-WaniWani-SDK\": SDK_NAME,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify(this.makeBatchRequest(events)),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tkind: \"retryable\",\n\t\t\t\treason: getErrorMessage(error),\n\t\t\t};\n\t\t}\n\n\t\tif (AUTH_FAILURE_STATUS.has(response.status)) {\n\t\t\treturn { kind: \"auth\", status: response.status };\n\t\t}\n\n\t\tif (RETRYABLE_STATUS.has(response.status)) {\n\t\t\treturn {\n\t\t\t\tkind: \"retryable\",\n\t\t\t\treason: `HTTP ${response.status}`,\n\t\t\t};\n\t\t}\n\n\t\tif (!response.ok) {\n\t\t\treturn {\n\t\t\t\tkind: \"permanent\",\n\t\t\t\treason: `HTTP ${response.status}`,\n\t\t\t};\n\t\t}\n\n\t\tconst data = await parseJsonResponse<V2BatchResponse>(response);\n\t\tif (!data?.rejected || data.rejected.length === 0) {\n\t\t\treturn { kind: \"success\" };\n\t\t}\n\n\t\tconst partial = this.classifyRejectedEvents(events, data.rejected);\n\t\tif (partial.retryable.length === 0 && partial.permanent.length === 0) {\n\t\t\treturn { kind: \"success\" };\n\t\t}\n\n\t\treturn {\n\t\t\tkind: \"partial\",\n\t\t\tretryable: partial.retryable,\n\t\t\tpermanent: partial.permanent,\n\t\t};\n\t}\n\n\tprivate makeBatchRequest(events: V2EventEnvelope[]): V2BatchRequest {\n\t\treturn {\n\t\t\tsentAt: this.now().toISOString(),\n\t\t\tsource: {\n\t\t\t\tsdk: SDK_NAME,\n\t\t\t\tversion: this.sdkVersion ?? \"0.0.0\",\n\t\t\t},\n\t\t\tevents,\n\t\t};\n\t}\n\n\tprivate classifyRejectedEvents(\n\t\tevents: V2EventEnvelope[],\n\t\trejected: V2BatchRejectedEvent[],\n\t): {\n\t\tretryable: V2EventEnvelope[];\n\t\tpermanent: V2EventEnvelope[];\n\t} {\n\t\tconst byId = new Map(events.map((event) => [event.id, event]));\n\t\tconst retryable: V2EventEnvelope[] = [];\n\t\tconst permanent: V2EventEnvelope[] = [];\n\n\t\tfor (const rejectedEvent of rejected) {\n\t\t\tconst event = byId.get(rejectedEvent.eventId);\n\t\t\tif (!event) continue;\n\t\t\tif (isRetryableRejectedEvent(rejectedEvent)) {\n\t\t\t\tretryable.push(event);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tpermanent.push(event);\n\t\t}\n\n\t\treturn { retryable, permanent };\n\t}\n\n\tprivate backoffDelayMs(attempt: number): number {\n\t\tconst rawDelay = this.retryBaseDelayMs * 2 ** attempt;\n\t\treturn Math.min(rawDelay, this.retryMaxDelayMs);\n\t}\n\n\tprivate stopTransportForAuthFailure(\n\t\tstatus: number,\n\t\trejectedCount: number,\n\t): void {\n\t\tthis.isStopped = true;\n\t\tconst buffered = this.buffer.length;\n\t\tthis.buffer.splice(0, buffered);\n\t\tthis.logger.error(\n\t\t\t\"[WaniWani] Auth failure (HTTP %d). Stopping tracking transport and dropping %d queued event(s)\",\n\t\t\tstatus,\n\t\t\trejectedCount + buffered,\n\t\t);\n\t}\n}\n\nfunction isRetryableRejectedEvent(\n\trejectedEvent: V2BatchRejectedEvent,\n): boolean {\n\tif (rejectedEvent.retryable === true) return true;\n\tconst code = rejectedEvent.code.toLowerCase();\n\treturn (\n\t\tcode.includes(\"timeout\") ||\n\t\tcode.includes(\"temporary\") ||\n\t\tcode.includes(\"unavailable\") ||\n\t\tcode.includes(\"rate_limit\") ||\n\t\tcode.includes(\"transient\") ||\n\t\tcode.includes(\"server\")\n\t);\n}\n\nasync function parseJsonResponse<T>(\n\tresponse: Response,\n): Promise<T | undefined> {\n\tconst body = await response.text();\n\tif (!body) return undefined;\n\ttry {\n\t\treturn JSON.parse(body) as T;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction joinUrl(baseUrl: string, endpointPath: string): string {\n\tconst normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl : `${baseUrl}/`;\n\tconst normalizedPath = endpointPath.startsWith(\"/\")\n\t\t? endpointPath.slice(1)\n\t\t: endpointPath;\n\treturn `${normalizedBase}${normalizedPath}`;\n}\n\nfunction getErrorMessage(error: unknown): string {\n\tif (error instanceof Error) return error.message;\n\treturn String(error);\n}\n","// Tracking Module\n\nimport type { InternalConfig } from \"../types.js\";\nimport type {\n\tTrackInput,\n\tTrackingClient,\n\tTrackingShutdownOptions,\n} from \"./@types.js\";\nimport { mapTrackEventToV2 } from \"./mapper.js\";\nimport { createV2BatchTransport } from \"./transport.js\";\n\n// Re-export types\nexport type {\n\tEventType,\n\tLegacyTrackEvent,\n\tLinkClickedProperties,\n\tPurchaseCompletedProperties,\n\tQuoteSucceededProperties,\n\tToolCalledProperties,\n\tTrackEvent,\n\tTrackInput,\n\tTrackingClient,\n\tTrackingConfig,\n\tTrackingShutdownOptions,\n\tTrackingShutdownResult,\n} from \"./@types.js\";\nexport { createEventId, mapTrackEventToV2 } from \"./mapper.js\";\nexport type {\n\tV2BatchRejectedEvent,\n\tV2BatchRequest,\n\tV2BatchResponse,\n\tV2CorrelationIds,\n\tV2EnvelopeType,\n\tV2EventEnvelope,\n} from \"./v2-types.js\";\n\nexport function createTrackingClient(config: InternalConfig): TrackingClient {\n\tconst { baseUrl, apiKey, tracking } = config;\n\n\tfunction requireApiKey(): string {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t\treturn apiKey;\n\t}\n\n\tconst transport = apiKey\n\t\t? createV2BatchTransport({\n\t\t\t\tbaseUrl,\n\t\t\t\tapiKey,\n\t\t\t\tendpointPath: tracking.endpointPath,\n\t\t\t\tflushIntervalMs: tracking.flushIntervalMs,\n\t\t\t\tmaxBatchSize: tracking.maxBatchSize,\n\t\t\t\tmaxBufferSize: tracking.maxBufferSize,\n\t\t\t\tmaxRetries: tracking.maxRetries,\n\t\t\t\tretryBaseDelayMs: tracking.retryBaseDelayMs,\n\t\t\t\tretryMaxDelayMs: tracking.retryMaxDelayMs,\n\t\t\t\tshutdownTimeoutMs: tracking.shutdownTimeoutMs,\n\t\t\t})\n\t\t: undefined;\n\n\tconst client: TrackingClient = {\n\t\tasync identify(\n\t\t\tuserId: string,\n\t\t\tproperties?: Record<string, unknown>,\n\t\t): Promise<{ eventId: string }> {\n\t\t\trequireApiKey();\n\t\t\tconst mappedEvent = mapTrackEventToV2({\n\t\t\t\tevent: \"user.identified\",\n\t\t\t\texternalUserId: userId,\n\t\t\t\tproperties,\n\t\t\t});\n\t\t\ttransport?.enqueue(mappedEvent);\n\t\t\treturn { eventId: mappedEvent.id };\n\t\t},\n\t\tasync track(event: TrackInput): Promise<{ eventId: string }> {\n\t\t\trequireApiKey();\n\t\t\tconst mappedEvent = mapTrackEventToV2(event);\n\t\t\ttransport?.enqueue(mappedEvent);\n\t\t\treturn { eventId: mappedEvent.id };\n\t\t},\n\t\tasync flush(): Promise<void> {\n\t\t\trequireApiKey();\n\t\t\tawait transport?.flush();\n\t\t},\n\t\tasync shutdown(options?: TrackingShutdownOptions) {\n\t\t\trequireApiKey();\n\t\t\treturn (\n\t\t\t\t(await transport?.shutdown({\n\t\t\t\t\ttimeoutMs: options?.timeoutMs ?? tracking.shutdownTimeoutMs,\n\t\t\t\t})) ?? { timedOut: false, pendingEvents: 0 }\n\t\t\t);\n\t\t},\n\t};\n\n\tif (transport) {\n\t\tattachShutdownHooks(client, tracking.shutdownTimeoutMs);\n\t}\n\treturn client;\n}\n\nfunction attachShutdownHooks(\n\tclient: TrackingClient,\n\tdefaultTimeoutMs: number,\n): void {\n\tif (\n\t\ttypeof process === \"undefined\" ||\n\t\ttypeof process.once !== \"function\" ||\n\t\ttypeof process.on !== \"function\"\n\t) {\n\t\treturn;\n\t}\n\n\tconst shutdown = () => {\n\t\tvoid client.shutdown({ timeoutMs: defaultTimeoutMs });\n\t};\n\n\tprocess.once(\"beforeExit\", shutdown);\n\tprocess.once(\"SIGINT\", shutdown);\n\tprocess.once(\"SIGTERM\", shutdown);\n}\n","// WaniWani SDK - Main Entry\n\nimport { createKbClient } from \"./kb/client.js\";\nimport { createTrackingClient } from \"./tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"./types.js\";\n\n/**\n * Create a WaniWani SDK client\n *\n * @param config - Configuration options\n * @returns A fully typed WaniWani client\n *\n * @example\n * ```typescript\n * import { waniwani } from \"@waniwani/sdk\";\n * import { toNextJsHandler } from \"@waniwani/sdk/next-js\";\n *\n * const wani = waniwani({ apiKey: \"...\" });\n *\n * // Next.js route handler\n * export const { GET, POST } = toNextJsHandler(wani, {\n *   chat: { systemPrompt: \"You are a helpful assistant.\" },\n * });\n * ```\n */\nexport function waniwani(config?: WaniWaniConfig): WaniWaniClient {\n\tconst baseUrl = config?.baseUrl ?? \"https://app.waniwani.ai\";\n\tconst apiKey = config?.apiKey ?? process.env.WANIWANI_API_KEY;\n\tconst trackingConfig = {\n\t\tendpointPath: config?.tracking?.endpointPath ?? \"/api/mcp/events/v2/batch\",\n\t\tflushIntervalMs: config?.tracking?.flushIntervalMs ?? 1_000,\n\t\tmaxBatchSize: config?.tracking?.maxBatchSize ?? 20,\n\t\tmaxBufferSize: config?.tracking?.maxBufferSize ?? 1_000,\n\t\tmaxRetries: config?.tracking?.maxRetries ?? 3,\n\t\tretryBaseDelayMs: config?.tracking?.retryBaseDelayMs ?? 200,\n\t\tretryMaxDelayMs: config?.tracking?.retryMaxDelayMs ?? 2_000,\n\t\tshutdownTimeoutMs: config?.tracking?.shutdownTimeoutMs ?? 2_000,\n\t};\n\n\tconst internalConfig = { baseUrl, apiKey, tracking: trackingConfig };\n\n\t// Compose client from modules\n\tconst trackingClient = createTrackingClient(internalConfig);\n\tconst kbClient = createKbClient(internalConfig);\n\n\treturn {\n\t\t...trackingClient,\n\t\tkb: kbClient,\n\t\t_config: internalConfig,\n\t};\n}\n","/**\n * Server-side API route handler for widget tracking events.\n *\n * Receives batched events from the `useWaniwani` React hook and forwards them\n * to the WaniWani backend using the server-side SDK.\n *\n * @example Next.js App Router\n * ```typescript\n * // app/api/waniwani/track/route.ts\n * import { createTrackingRoute } from \"@waniwani/sdk/mcp\";\n *\n * const handler = createTrackingRoute({\n *   apiKey: process.env.WANIWANI_API_KEY,\n *   baseUrl: process.env.WANIWANI_BASE_URL,\n * });\n *\n * export { handler as POST };\n * ```\n */\n\nimport type { EventType, TrackInput } from \"../../tracking/@types.js\";\nimport type { WaniWaniConfig } from \"../../types.js\";\nimport { waniwani } from \"../../waniwani.js\";\n\nexport interface TrackingRouteOptions {\n\t/** API key for the WaniWani backend. Defaults to WANIWANI_API_KEY env var. */\n\tapiKey?: string;\n\t/** Base URL for the WaniWani backend. Defaults to https://app.waniwani.ai. */\n\tbaseUrl?: string;\n}\n\n/** Shape of a single event from the WidgetTransport client. */\ninterface WidgetEventPayload {\n\tevent_id?: string;\n\tevent_type?: string;\n\ttimestamp?: string;\n\tsource?: string;\n\tsession_id?: string;\n\ttrace_id?: string;\n\tuser_id?: string;\n\tevent_name?: string;\n\tmetadata?: Record<string, unknown>;\n\t[key: string]: unknown;\n}\n\n/** Batch payload sent by WidgetTransport. */\ninterface BatchPayload {\n\tevents: WidgetEventPayload[];\n\tsentAt?: string;\n}\n\n/**\n * Map a WidgetEvent from the client to the SDK's TrackInput format.\n */\nfunction mapWidgetEvent(ev: WidgetEventPayload): TrackInput {\n\tconst eventType = ev.event_type ?? \"widget_click\";\n\n\t// For manual tracking methods (track, identify, step, conversion),\n\t// use \"widget_<type>\" as the event name. Auto-capture events already\n\t// have the \"widget_\" prefix.\n\tconst isAutoCapture = eventType.startsWith(\"widget_\");\n\tconst eventName: EventType = (\n\t\tisAutoCapture ? eventType : `widget_${eventType}`\n\t) as EventType;\n\n\t// Merge metadata + any extra properties from the event\n\tconst properties: Record<string, unknown> = {\n\t\t...(ev.metadata ?? {}),\n\t};\n\tif (ev.event_name) properties.event_name = ev.event_name;\n\n\treturn {\n\t\tevent: eventName,\n\t\tproperties,\n\t\tsessionId: ev.session_id,\n\t\ttraceId: ev.trace_id,\n\t\texternalUserId: ev.user_id,\n\t\teventId: ev.event_id,\n\t\ttimestamp: ev.timestamp,\n\t\tsource: ev.source ?? \"widget\",\n\t} as TrackInput;\n}\n\n/**\n * Creates a POST handler that receives tracking events from `useWaniwani`\n * and forwards them to the WaniWani backend.\n */\nexport function createTrackingRoute(options?: TrackingRouteOptions) {\n\tconst config: WaniWaniConfig = {\n\t\tapiKey: options?.apiKey,\n\t\tbaseUrl: options?.baseUrl,\n\t};\n\n\t// Lazy singleton — created on first request\n\tlet client: ReturnType<typeof waniwani> | undefined;\n\n\tfunction getClient() {\n\t\tif (!client) {\n\t\t\tclient = waniwani(config);\n\t\t}\n\t\treturn client;\n\t}\n\n\treturn async function handler(request: Request): Promise<Response> {\n\t\tlet body: BatchPayload;\n\t\ttry {\n\t\t\tbody = (await request.json()) as BatchPayload;\n\t\t} catch {\n\t\t\treturn new Response(JSON.stringify({ error: \"Invalid JSON\" }), {\n\t\t\t\tstatus: 400,\n\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t});\n\t\t}\n\n\t\tif (!Array.isArray(body.events) || body.events.length === 0) {\n\t\t\treturn new Response(\n\t\t\t\tJSON.stringify({ error: \"Missing or empty events array\" }),\n\t\t\t\t{\n\t\t\t\t\tstatus: 400,\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\ttry {\n\t\t\tconst c = getClient();\n\t\t\tconst results: string[] = [];\n\n\t\t\tfor (const ev of body.events) {\n\t\t\t\tconst trackInput = mapWidgetEvent(ev);\n\t\t\t\tconst result = await c.track(trackInput);\n\t\t\t\tresults.push(result.eventId);\n\t\t\t}\n\n\t\t\tawait c.flush();\n\n\t\t\treturn new Response(\n\t\t\t\tJSON.stringify({ ok: true, accepted: results.length }),\n\t\t\t\t{\n\t\t\t\t\tstatus: 200,\n\t\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t\t},\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : \"Unknown error\";\n\t\t\treturn new Response(JSON.stringify({ error: message }), {\n\t\t\t\tstatus: 500,\n\t\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\t});\n\t\t}\n\t};\n}\n","/**\n * Widget token minting — fetches short-lived JWTs from the WaniWani backend\n * so browser widgets can POST events directly.\n */\n\ninterface WidgetTokenConfig {\n\tbaseUrl: string;\n\tapiKey: string;\n}\n\ninterface WidgetTokenResult {\n\ttoken: string;\n\texpiresAt: string;\n}\n\ninterface CachedToken {\n\ttoken: string;\n\t/** Unix ms when the token expires */\n\texpiresAt: number;\n}\n\n/** Re-mint when < 2 minutes remain to avoid using nearly-expired tokens. */\nconst EXPIRY_BUFFER_MS = 2 * 60 * 1000;\n\nexport class WidgetTokenCache {\n\tprivate cached: CachedToken | null = null;\n\tprivate pending: Promise<string | null> | null = null;\n\tprivate readonly config: WidgetTokenConfig;\n\n\tconstructor(config: WidgetTokenConfig) {\n\t\tthis.config = config;\n\t}\n\n\t/**\n\t * Get a valid widget token. Returns a cached token if still fresh,\n\t * otherwise mints a new one. Returns `null` on failure.\n\t */\n\tasync getToken(sessionId?: string, traceId?: string): Promise<string | null> {\n\t\tif (this.cached && Date.now() < this.cached.expiresAt - EXPIRY_BUFFER_MS) {\n\t\t\treturn this.cached.token;\n\t\t}\n\n\t\t// Deduplicate concurrent requests\n\t\tif (this.pending) return this.pending;\n\n\t\tthis.pending = this.mint(sessionId, traceId).finally(() => {\n\t\t\tthis.pending = null;\n\t\t});\n\n\t\treturn this.pending;\n\t}\n\n\tprivate async mint(\n\t\tsessionId?: string,\n\t\ttraceId?: string,\n\t): Promise<string | null> {\n\t\tconst url = joinUrl(this.config.baseUrl, \"/api/mcp/widget-tokens\");\n\n\t\tconst body: Record<string, string> = {};\n\t\tif (sessionId) body.sessionId = sessionId;\n\t\tif (traceId) body.traceId = traceId;\n\n\t\ttry {\n\t\t\tconst response = await fetch(url, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\tAuthorization: `Bearer ${this.config.apiKey}`,\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify(body),\n\t\t\t});\n\n\t\t\tif (!response.ok) return null;\n\n\t\t\tconst json = (await response.json()) as Record<string, unknown>;\n\n\t\t\t// Support both flat { token, expiresAt } and nested { data: { token, expiresAt } }\n\t\t\tconst result = (\n\t\t\t\tjson.data && typeof json.data === \"object\" ? json.data : json\n\t\t\t) as WidgetTokenResult;\n\n\t\t\tconst expiresAtMs = new Date(result.expiresAt).getTime();\n\t\t\tif (!result.token || Number.isNaN(expiresAtMs)) return null;\n\n\t\t\tthis.cached = {\n\t\t\t\ttoken: result.token,\n\t\t\t\texpiresAt: expiresAtMs,\n\t\t\t};\n\n\t\t\treturn result.token;\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n}\n\nfunction joinUrl(baseUrl: string, path: string): string {\n\tconst base = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n\treturn `${base}${path}`;\n}\n","import type { ToolCalledProperties, TrackInput } from \"../../tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"../../types.js\";\nimport { waniwani } from \"../../waniwani.js\";\nimport type { McpServer } from \"./tools/types\";\nimport { WidgetTokenCache } from \"./widget-token.js\";\n\ntype WaniwaniTracker = Pick<WaniWaniClient, \"flush\" | \"track\" | \"_config\">;\ntype UnknownRecord = Record<string, unknown>;\n\ntype WrappedServer = McpServer & {\n\t__waniwaniWrapped?: true;\n};\n\n/**\n * Options for withWaniwani().\n */\nexport type WithWaniwaniOptions = {\n\t/**\n\t * Optional pre-built WaniWani client.\n\t * When omitted, a new client is created from `config`.\n\t */\n\tclient?: WaniwaniTracker;\n\t/**\n\t * WaniWani client config used when `client` is omitted.\n\t */\n\tconfig?: WaniWaniConfig;\n\t/**\n\t * Optional explicit tool type. Defaults to `\"other\"`.\n\t */\n\ttoolType?:\n\t\t| ToolCalledProperties[\"type\"]\n\t\t| ((toolName: string) => ToolCalledProperties[\"type\"] | undefined);\n\t/**\n\t * Optional metadata merged into every tracked event.\n\t */\n\tmetadata?: UnknownRecord;\n\t/**\n\t * Flush tracking transport after each tool call.\n\t */\n\tflushAfterToolCall?: boolean;\n\t/**\n\t * Optional error callback for non-fatal tracking errors.\n\t */\n\tonError?: (error: Error) => void;\n\t/**\n\t * Inject widget tracking config into tool response `_meta.waniwani` so browser\n\t * widgets can send events directly to the WaniWani backend.\n\t *\n\t * Always injects `endpoint`. Injects `token` when an API key is configured\n\t * and token minting succeeds.\n\t *\n\t * @default true\n\t */\n\tinjectWidgetToken?: boolean;\n};\n\nconst DEFAULT_BASE_URL = \"https://app.waniwani.ai\";\n\n/**\n * Wrap an MCP server so tool handlers automatically emit `tool.called` events.\n *\n * The wrapper intercepts `server.registerTool(...)`, tracks each invocation,\n * then forwards execution to the original tool handler.\n *\n * When `injectWidgetToken` is enabled (default), tracking config is injected\n * into tool response `_meta.waniwani` so browser widgets can post events\n * directly to the WaniWani backend without a server-side proxy.\n */\nexport function withWaniwani(\n\tserver: McpServer,\n\toptions: WithWaniwaniOptions = {},\n): McpServer {\n\tconst wrappedServer = server as WrappedServer;\n\tif (wrappedServer.__waniwaniWrapped) {\n\t\treturn wrappedServer;\n\t}\n\n\twrappedServer.__waniwaniWrapped = true;\n\n\tconst tracker = options.client ?? waniwani(options.config);\n\tconst injectToken = options.injectWidgetToken !== false;\n\n\t// Lazy-init token cache — only created if we have an API key\n\tlet tokenCache: WidgetTokenCache | null = null;\n\n\tfunction getTokenCache(): WidgetTokenCache | null {\n\t\tif (tokenCache) return tokenCache;\n\t\tconst apiKey = tracker._config.apiKey;\n\t\tif (!apiKey) return null;\n\t\ttokenCache = new WidgetTokenCache({\n\t\t\tbaseUrl: tracker._config.baseUrl ?? DEFAULT_BASE_URL,\n\t\t\tapiKey,\n\t\t});\n\t\treturn tokenCache;\n\t}\n\n\tconst originalRegisterTool = server.registerTool.bind(server) as (\n\t\t...args: unknown[]\n\t) => unknown;\n\n\twrappedServer.registerTool = ((...args: unknown[]) => {\n\t\tconst [toolNameRaw, config, handlerRaw] = args;\n\t\tconst toolName =\n\t\t\ttypeof toolNameRaw === \"string\" && toolNameRaw.trim().length > 0\n\t\t\t\t? toolNameRaw\n\t\t\t\t: \"unknown\";\n\n\t\tif (typeof handlerRaw !== \"function\") {\n\t\t\treturn originalRegisterTool(...args);\n\t\t}\n\n\t\tconst handler = handlerRaw as (\n\t\t\tinput: unknown,\n\t\t\textra: unknown,\n\t\t) => Promise<unknown> | unknown;\n\n\t\tconst wrappedHandler = async (input: unknown, extra: unknown) => {\n\t\t\tconst startTime = performance.now();\n\t\t\ttry {\n\t\t\t\tconst result = await handler(input, extra);\n\t\t\t\tconst durationMs = Math.round(performance.now() - startTime);\n\n\t\t\t\tawait safeTrack(\n\t\t\t\t\ttracker,\n\t\t\t\t\tbuildTrackInput(toolName, extra, options, {\n\t\t\t\t\t\tdurationMs,\n\t\t\t\t\t\tstatus: \"ok\",\n\t\t\t\t\t}),\n\t\t\t\t\toptions.onError,\n\t\t\t\t);\n\n\t\t\t\tif (options.flushAfterToolCall) {\n\t\t\t\t\tawait safeFlush(tracker, options.onError);\n\t\t\t\t}\n\n\t\t\t\tif (injectToken) {\n\t\t\t\t\tawait injectWidgetConfig(\n\t\t\t\t\t\tresult,\n\t\t\t\t\t\tgetTokenCache(),\n\t\t\t\t\t\ttracker._config.baseUrl ?? DEFAULT_BASE_URL,\n\t\t\t\t\t\toptions.onError,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tinjectUserLocation(result, extra);\n\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\tconst durationMs = Math.round(performance.now() - startTime);\n\n\t\t\t\tawait safeTrack(\n\t\t\t\t\ttracker,\n\t\t\t\t\tbuildTrackInput(toolName, extra, options, {\n\t\t\t\t\t\tdurationMs,\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terrorMessage:\n\t\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t}),\n\t\t\t\t\toptions.onError,\n\t\t\t\t);\n\n\t\t\t\tif (options.flushAfterToolCall) {\n\t\t\t\t\tawait safeFlush(tracker, options.onError);\n\t\t\t\t}\n\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t};\n\n\t\treturn originalRegisterTool(toolNameRaw, config, wrappedHandler);\n\t}) as McpServer[\"registerTool\"];\n\n\treturn wrappedServer;\n}\n\nasync function injectWidgetConfig(\n\tresult: unknown,\n\tcache: WidgetTokenCache | null,\n\tbaseUrl: string,\n\tonError?: (error: Error) => void,\n): Promise<void> {\n\tif (!isRecord(result)) return;\n\n\tif (!isRecord(result._meta)) {\n\t\t(result as UnknownRecord)._meta = {};\n\t}\n\n\tconst meta = (result as UnknownRecord)._meta as UnknownRecord;\n\tconst waniwaniConfig: UnknownRecord = {\n\t\tendpoint: `${baseUrl.replace(/\\/$/, \"\")}/api/mcp/events/v2/batch`,\n\t};\n\n\tif (cache) {\n\t\ttry {\n\t\t\tconst token = await cache.getToken();\n\t\t\tif (token) {\n\t\t\t\twaniwaniConfig.token = token;\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tonError?.(toError(error));\n\t\t}\n\t}\n\n\tmeta.waniwani = waniwaniConfig;\n}\n\nfunction buildTrackInput(\n\ttoolName: string,\n\textra: unknown,\n\toptions: WithWaniwaniOptions,\n\ttiming?: { durationMs: number; status: string; errorMessage?: string },\n): TrackInput {\n\tconst toolType = resolveToolType(toolName, options.toolType);\n\tconst meta = extractMeta(extra);\n\n\treturn {\n\t\tevent: \"tool.called\",\n\t\tproperties: {\n\t\t\tname: toolName,\n\t\t\ttype: toolType,\n\t\t\t...(timing ?? {}),\n\t\t},\n\t\tmeta,\n\t\tmetadata: {\n\t\t\tsource: \"withWaniwani\",\n\t\t\t...(options.metadata ?? {}),\n\t\t},\n\t};\n}\n\nfunction resolveToolType(\n\ttoolName: string,\n\ttoolTypeOption: WithWaniwaniOptions[\"toolType\"],\n): ToolCalledProperties[\"type\"] {\n\tif (typeof toolTypeOption === \"function\") {\n\t\treturn toolTypeOption(toolName) ?? \"other\";\n\t}\n\treturn toolTypeOption ?? \"other\";\n}\n\nfunction extractMeta(extra: unknown): UnknownRecord | undefined {\n\tif (!isRecord(extra)) return undefined;\n\n\tconst meta = extra._meta;\n\tif (!isRecord(meta)) return undefined;\n\n\treturn meta;\n}\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n\treturn Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nasync function safeTrack(\n\ttracker: Pick<WaniWaniClient, \"track\">,\n\tinput: TrackInput,\n\tonError?: (error: Error) => void,\n): Promise<void> {\n\ttry {\n\t\tawait tracker.track(input);\n\t} catch (error) {\n\t\tonError?.(toError(error));\n\t}\n}\n\nasync function safeFlush(\n\ttracker: Pick<WaniWaniClient, \"flush\">,\n\tonError?: (error: Error) => void,\n): Promise<void> {\n\ttry {\n\t\tawait tracker.flush();\n\t} catch (error) {\n\t\tonError?.(toError(error));\n\t}\n}\n\nfunction toError(error: unknown): Error {\n\tif (error instanceof Error) {\n\t\treturn error;\n\t}\n\treturn new Error(String(error));\n}\n\nconst USER_LOCATION_KEY = \"waniwani/userLocation\";\n\n/**\n * Pass-through `waniwani/userLocation` from request `_meta` to response `_meta`.\n * This ensures widgets always receive location data, even for custom handlers\n * that don't use `createTool` (which already spreads request `_meta`).\n */\nfunction injectUserLocation(result: unknown, extra: unknown): void {\n\tconst requestMeta = extractMeta(extra);\n\tif (!requestMeta) return;\n\n\tconst userLocation = requestMeta[USER_LOCATION_KEY];\n\tif (!userLocation) return;\n\n\tif (!isRecord(result)) return;\n\n\tif (!isRecord(result._meta)) {\n\t\t(result as UnknownRecord)._meta = {};\n\t}\n\n\tconst resultMeta = (result as UnknownRecord)._meta as UnknownRecord;\n\n\t// Don't overwrite if the handler already set it\n\tif (!resultMeta[USER_LOCATION_KEY]) {\n\t\tresultMeta[USER_LOCATION_KEY] = userLocation;\n\t}\n}\n"],"mappings":"AAWO,SAASA,GAAiC,CAChD,OAAI,OAAO,OAAW,KAAe,WAAY,OACzC,SAED,UACR,CAKO,SAASC,IAAoB,CACnC,OAAOD,EAAe,IAAM,QAC7B,CAKO,SAASE,IAAqB,CACpC,OAAOF,EAAe,IAAM,UAC7B,CCpBO,IAAMG,EAAQ,YACRC,EAAM,UAMbC,EAAY,OAAO,IAAI,yBAAyB,EAChDC,EAAS,OAAO,IAAI,sBAAsB,EAyDzC,SAASC,EACfC,EACAC,EACkB,CAClB,IAAMC,EAAUD,GAAQ,QAClBE,EAAiC,CAAC,EAExC,OAAW,CAACC,EAAKC,CAAK,IAAK,OAAO,QAAQL,CAAM,EAC/C,GAAI,OAAOK,GAAU,UAAYA,IAAU,MAAQ,aAAcA,EAAO,CACvE,IAAMC,EAAID,EASVF,EAAU,KAAK,CACd,SAAUG,EAAE,SACZ,MAAOF,EACP,YAAaE,EAAE,YACf,QAASA,EAAE,QACX,SAAUA,EAAE,QACb,CAAC,CACF,CAGD,MAAO,CACN,OAAQT,EACR,UAAAM,EACA,QAAAD,CACD,CACD,CAMO,SAASK,EACfC,EACAP,EAMe,CACf,MAAO,CAAE,OAAQH,EAAQ,KAAAU,EAAM,GAAGP,CAAO,CAC1C,CAEO,SAASQ,EAAYJ,EAA0C,CACrE,OACC,OAAOA,GAAU,UACjBA,IAAU,MACV,WAAYA,GACXA,EAA0B,SAAWR,CAExC,CAEO,SAASa,GAASL,EAAuC,CAC/D,OACC,OAAOA,GAAU,UACjBA,IAAU,MACV,WAAYA,GACXA,EAAuB,SAAWP,CAErC,CCxIA,OAAS,KAAAa,MAAS,MCOlB,OAAS,eAAAC,GAAa,eAAAC,OAAmB,OAGlC,SAASC,EAAgBC,EAAgC,CAC/D,IAAMC,EAAO,KAAK,UAAUD,CAAI,EAEhC,OADmBH,GAAYI,CAAI,EACjB,SAAS,QAAQ,CACpC,CAEO,SAASC,GAAgBC,EAAwC,CACvE,GAAI,CACH,IAAMC,EAAa,OAAO,KAAKD,EAAO,QAAQ,EACxCF,EAAOH,GAAYM,CAAU,EAAE,SAAS,OAAO,EACrD,OAAO,KAAK,MAAMH,CAAI,CACvB,MAAQ,CACP,OAAO,IACR,CACD,CDKA,SAASI,GAAiBC,EAA2B,CACpD,IAAMC,EAAOD,EAAO,aAAe,GAC7BE,EACLF,EAGC,MAAM,IAER,GAAIE,GAAK,OAAS,QAAUA,EAAI,QAAS,CACxC,IAAMC,EAAO,OAAO,KAAKD,EAAI,OAAO,EAClC,IAAKE,GAAM,IAAIA,CAAC,GAAG,EACnB,KAAK,KAAK,EACZ,OAAOH,EAAO,GAAGE,CAAI,WAAMF,CAAI,GAAKE,CACrC,CAEA,OAAOF,CACR,CAEA,SAASI,GAAkBC,EAA4B,CACtD,IAAMC,EAAQ,CACb,GACA,6BACA,GACA,uFACA,GACA,0EACA,4EACA,wEACA,gCACA,yFACD,EAEA,GAAID,EAAO,MAAO,CACjB,IAAME,EAAY,OAAO,QAAQF,EAAO,KAAK,EAC3C,IAAI,CAAC,CAACG,EAAKT,CAAM,IAAM,CACvB,IAAMU,EAAOX,GAAiBC,CAAM,EACpC,OAAOU,EAAO,KAAKD,CAAG,OAAOC,CAAI,IAAM,KAAKD,CAAG,IAChD,CAAC,EACA,KAAK,IAAI,EACXF,EAAM,KAAK,oBAAoBC,CAAS,GAAG,CAC5C,CAEA,OAAAD,EAAM,KACL,iEACA,yDACA,2GACA,uGACA,8DACA,iHACA,6BACA,8GACA,wGACA,yFACA,6DACA,kFACA,+FACA,6FACA,sFACA,8CACA,mGACA,wDACA,8EACA,oGACA,uEACA,kEACA,GACA,iHACA,uGACA,4GACA,yGACA,mFACA,2EACD,EAEOA,EAAM,KAAK;AAAA,CAAI,CACvB,CAEA,SAASI,GAAaC,EAEpB,CACD,GAAIA,EAAK,UAAW,CACnB,IAAMC,EAAUC,GAAgBF,EAAK,SAAS,EAC9C,GAAIC,EAAS,OAAOA,CACrB,CACA,MAAO,CAAE,KAAM,OAAgC,MAAO,CAAC,CAAE,CAC1D,CAMA,eAAeE,EACdC,EACAC,EACkB,CAClB,OAAID,EAAK,OAAS,SAAiBA,EAAK,GACjCA,EAAK,UAAUC,CAAK,CAC5B,CAOA,SAASC,EAASd,EAAqB,CACtC,OAA0BA,GAAM,MAAQA,IAAM,EAC/C,CAoBA,SAASe,EACRC,EACAC,EACAC,EACAL,EACyB,CAEzB,GAAIG,EAAU,MAAOG,GAAML,EAASD,EAAMM,EAAE,KAAqB,CAAC,CAAC,EAClE,OAAO,KAIR,IAAMC,EAAaJ,EAAU,OAC3BG,GAAM,CAACL,EAASD,EAAMM,EAAE,KAAqB,CAAC,CAChD,EAGME,EAAWD,EAAW,SAAW,EACjCE,EAAKF,EAAW,CAAC,EAgBvB,MAAO,CACN,QAfAC,GAAYC,EACT,CACA,OAAQ,YACR,SAAUA,EAAG,SACb,MAAOA,EAAG,MACV,GAAIA,EAAG,YAAc,CAAE,YAAaA,EAAG,WAAY,EAAI,CAAC,EACxD,GAAIA,EAAG,SAAWL,EAAU,CAAE,QAASK,EAAG,SAAWL,CAAQ,EAAI,CAAC,CACnE,EACC,CACA,OAAQ,YACR,UAAWG,EACX,GAAIH,EAAU,CAAE,QAAAA,CAAQ,EAAI,CAAC,CAC9B,EAIF,iBAAkB,CACjB,KAAMC,EACN,MAAAL,EACA,GAAIQ,GAAYC,EAAK,CAAE,MAAOA,EAAG,KAAM,EAAI,CAAC,EAG5C,UAAAN,EACA,GAAIC,EAAU,CAAE,iBAAkBA,CAAQ,EAAI,CAAC,CAChD,CACD,CACD,CAeA,eAAeM,EACdC,EACAC,EACAC,EACAC,EACAC,EACAC,EAC2B,CAC3B,IAAIX,EAAcM,EACdX,EAAQ,CAAE,GAAGY,CAAW,EAGtBK,EAAiB,GACnBC,EAAa,EAEjB,KAAOA,IAAeD,GAAgB,CAErC,GAAIZ,IAAgBc,EACnB,MAAO,CACN,QAAS,CAAE,OAAQ,UAAW,EAC9B,iBAAkB,CAAE,MAAAnB,CAAM,CAC3B,EAGD,IAAMoB,EAAUP,EAAM,IAAIR,CAAW,EACrC,GAAI,CAACe,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,kBAAkBf,CAAW,GACrC,CACD,EAGD,GAAI,CAYH,IAAMgB,EAAS,MAAMD,EAVT,CACX,MAAApB,EACA,KAAAgB,EACA,UAAWM,EAGX,WAAYC,CAGb,CACiE,EAGjE,GAAIC,EAAYH,CAAM,EAAG,CAExB,QAAWf,KAAKe,EAAO,UAClBf,EAAE,UACLS,EAAW,IAAI,GAAGV,CAAW,IAAIC,EAAE,KAAK,GAAIA,EAAE,QAAQ,EAIxD,IAAMmB,EAAkBvB,EACvBmB,EAAO,UACPA,EAAO,QACPhB,EACAL,CACD,EAEA,GAAIyB,EACH,OAAOA,EAIR,IAAM1B,EAAOe,EAAM,IAAIT,CAAW,EAClC,GAAI,CAACN,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,+BAA+BM,CAAW,GAClD,CACD,EAEDA,EAAc,MAAMP,EAAgBC,EAAMC,CAAK,EAC/C,QACD,CAGA,GAAI0B,GAASL,CAAM,EAAG,CACrB,IAAMM,EAAcN,EAAO,MAC3B,GAAIM,GACC1B,EAASD,EAAM2B,CAA2B,CAAC,EAAG,CACjD,IAAM5B,EAAOe,EAAM,IAAIT,CAAW,EAClC,GAAI,CAACN,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,+BAA+BM,CAAW,GAClD,CACD,EAEDA,EAAc,MAAMP,EAAgBC,EAAMC,CAAK,EAC/C,QACD,CAGD,MAAO,CACN,QAAS,CACR,OAAQ,SACR,KAAMqB,EAAO,KAAK,GAClB,KAAMA,EAAO,KACb,YAAaA,EAAO,YACpB,GAAIA,EAAO,cAAgB,GAAQ,CAAE,YAAa,EAAM,EAAI,CAAC,CAC9D,EACA,iBAAkB,CACjB,KAAMhB,EACN,MAAAL,EACA,MAAO2B,EACP,SAAUN,EAAO,KAAK,EACvB,CACD,CACD,CAGArB,EAAQ,CAAE,GAAGA,EAAO,GAAGqB,CAAO,EAE9B,IAAMtB,EAAOe,EAAM,IAAIT,CAAW,EAClC,GAAI,CAACN,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,+BAA+BM,CAAW,GAClD,CACD,EAEDA,EAAc,MAAMP,EAAgBC,EAAMC,CAAK,CAChD,OAAS4B,EAAO,CAEf,MAAO,CACN,QAAS,CAAE,OAAQ,QAAS,MAFbA,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,CAEzB,EAC3C,iBAAkB,CAAE,KAAMvB,EAAa,MAAAL,CAAM,CAC9C,CACD,CACD,CAEA,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,2DACR,CACD,CACD,CAMA,IAAM6B,GAAc,CACnB,OAAQC,EACN,KAAK,CAAC,QAAS,UAAU,CAAC,EAC1B,SACA,qFACD,EACD,aAAcA,EACZ,OAAOA,EAAE,OAAO,EAAGA,EAAE,QAAQ,CAAC,EAC9B,SAAS,EACT,SACA,oLACD,EACD,UAAWA,EACT,OAAO,EACP,SAAS,EACT,SACA,8EACD,CACF,EAEO,SAASC,GACfC,EACiB,CACjB,GAAM,CAAE,OAAA3C,EAAQ,MAAAwB,EAAO,MAAAC,CAAM,EAAIkB,EAC3BC,EAAW7C,GAAkBC,CAAM,EACnC6C,EAAkB,GAAG7C,EAAO,WAAW;AAAA,EAAK4C,CAAQ,GAIpDlB,EAAa,IAAI,IAEvB,eAAeoB,EACdxC,EACAqB,EAC2B,CAC3B,IAAMoB,EAAY1C,GAAaC,CAAI,EAC7BK,EAAQoC,EAAU,MAExB,GAAIzC,EAAK,SAAW,QAAS,CAC5B,IAAM0C,EAAYvB,EAAM,IAAIwB,CAAK,EACjC,GAAI,CAACD,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,eACR,CACD,EAID,IAAMzB,EAAa,CAClB,GAAGZ,EACH,GAAIL,EAAK,cAAgB,CAAC,CAC3B,EAEM4C,EAAY,MAAMzC,EAAgBuC,EAAWzB,CAAU,EAC7D,OAAOF,EAAY6B,EAAW3B,EAAYC,EAAOC,EAAOC,EAAYC,CAAI,CACzE,CAEA,GAAIrB,EAAK,SAAW,WAAY,CAC/B,IAAM6C,EAAOJ,EAAU,KACvB,GAAI,CAACI,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MACC,6HAEF,CACD,EAGD,IAAIC,EAAe,CAClB,GAAGzC,EACH,GAAIL,EAAK,cAAgB,CAAC,CAC3B,EAIA,GAAIyC,EAAU,UAAW,CACxB,IAAMX,EAAkBvB,EACvBkC,EAAU,UACVA,EAAU,iBACVI,EACAC,CACD,EAGA,GAAIhB,EACH,OAAOA,EAIR,IAAMiB,EAAkBN,EAAU,UAChC,IAAK9B,IAAO,CACZ,MAAOA,EAAE,MACT,GAAIS,EAAW,IAAI,GAAGyB,CAAI,IAAIlC,EAAE,KAAK,EAAE,CACxC,EAAE,EACD,OAAQnB,GAA8CA,EAAE,IAAM,IAAI,EAEpE,OAAW,CAAE,MAAAwD,EAAO,GAAAC,CAAG,IAAKF,EAC3B,GAAI,CACH,IAAMG,EAAQJ,EAAaE,CAAqB,EAC1CG,EAAU,MAAMF,EAAGC,CAAK,EAC1BC,GAAW,OAAOA,GAAY,WACjCL,EAAe,CACd,GAAGA,EACH,GAAGK,CACJ,EAEF,OAASC,EAAK,CAEb,IAAMC,EAAMD,aAAe,MAAQA,EAAI,QAAU,OAAOA,CAAG,EAC3D,OAAQN,EAAyCE,CAAK,EAItD,IAAMM,GAAqBb,EAAU,UAAU,IAAK9B,GACnDA,EAAE,QAAUqC,EACT,CACA,GAAGrC,EACH,QAASA,EAAE,QACR,UAAU0C,CAAG;AAAA;AAAA,EAAO1C,EAAE,OAAO,GAC7B,UAAU0C,CAAG,EACjB,EACC1C,CACJ,EACMe,EAASnB,EACd+C,GACAb,EAAU,iBACVI,EACAC,CACD,EACA,GAAIpB,EAAQ,OAAOA,EAEnB,KACD,CAEF,CAOA,GAAIe,EAAU,WAAaA,EAAU,SAAU,CAC9C,IAAMrC,EAAOe,EAAM,IAAI0B,CAAI,EAC3B,GAAI,CAACzC,EACJ,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,sBAAsByC,CAAI,GAClC,CACD,EAED,IAAMU,EAAW,MAAMpD,EAAgBC,EAAM0C,CAAY,EACzD,OAAO/B,EACNwC,EACAT,EACA5B,EACAC,EACAC,EACAC,CACD,CACD,CAEA,OAAON,EAAY8B,EAAMC,EAAc5B,EAAOC,EAAOC,EAAYC,CAAI,CACtE,CAEA,MAAO,CACN,QAAS,CACR,OAAQ,QACR,MAAO,oBAAoBrB,EAAK,MAAM,GACvC,CACD,CACD,CAEA,MAAO,CACN,GAAIN,EAAO,GACX,MAAOA,EAAO,MACd,YAAa6C,EAEb,MAAM,SAASiB,EAAkC,CAChDA,EAAO,aACN9D,EAAO,GACP,CACC,MAAOA,EAAO,MACd,YAAa6C,EACb,YAAAL,GACA,YAAaxC,EAAO,WACrB,GACC,MAAOM,EAAqByD,IAAmB,CAK/C,IAAMC,EAJeD,EAI+B,OAAS,CAAC,EAExD/B,EAAS,MAAMc,EAAexC,EAAM0D,CAAK,EAGzCC,EAAYjC,EAAO,iBACtBkC,EAAgBlC,EAAO,gBAAgB,EACvC,OAGGmC,EAA+B,CACpC,GAAGnC,EAAO,QACV,GAAIiC,EAAY,CAAE,UAAAA,CAAU,EAAI,CAAC,CAClC,EAQA,MAAO,CACN,QARe,CACf,CACC,KAAM,OACN,KAAM,KAAK,UAAUE,EAAiB,KAAM,CAAC,CAC9C,CACD,EAIC,MAAAH,EACA,GAAIhC,EAAO,QAAQ,SAAW,QAAU,CAAE,QAAS,EAAK,EAAI,CAAC,CAC9D,CACD,EACD,CACD,CACD,CACD,CE5jBO,IAAMoC,EAAN,KAAyD,CACvD,MAAQ,IAAI,IACZ,MAAQ,IAAI,IACZ,OAER,YAAYC,EAAoB,CAC/B,KAAK,OAASA,CACf,CAOA,QAAQC,EAAcC,EAAoC,CACzD,GAAID,IAASE,GAASF,IAASG,EAC9B,MAAM,IAAI,MACT,IAAIH,CAAI,wDACT,EAED,GAAI,KAAK,MAAM,IAAIA,CAAI,EACtB,MAAM,IAAI,MAAM,SAASA,CAAI,kBAAkB,EAGhD,YAAK,MAAM,IAAIA,EAAMC,CAAO,EACrB,IACR,CAQA,QAAQG,EAAcC,EAAkB,CACvC,GAAI,KAAK,MAAM,IAAID,CAAI,EACtB,MAAM,IAAI,MACT,SAASA,CAAI,uEACd,EAED,YAAK,MAAM,IAAIA,EAAM,CAAE,KAAM,SAAU,GAAAC,CAAG,CAAC,EACpC,IACR,CAOA,mBAAmBD,EAAcE,EAAsC,CACtE,GAAI,KAAK,MAAM,IAAIF,CAAI,EACtB,MAAM,IAAI,MAAM,SAASA,CAAI,iCAAiC,EAE/D,YAAK,MAAM,IAAIA,EAAM,CAAE,KAAM,cAAe,UAAAE,CAAU,CAAC,EAChD,IACR,CAOA,SAA0B,CACzB,YAAK,SAAS,EAEPC,GAAoB,CAC1B,OAAQ,KAAK,OACb,MAAO,IAAI,IAAI,KAAK,KAAK,EACzB,MAAO,IAAI,IAAI,KAAK,KAAK,CAC1B,CAAC,CACF,CAEQ,UAAiB,CAExB,GAAI,CAAC,KAAK,MAAM,IAAIL,CAAK,EACxB,MAAM,IAAI,MACT,sFACD,EAID,IAAMM,EAAY,KAAK,MAAM,IAAIN,CAAK,EACtC,GACCM,GAAW,OAAS,UACpBA,EAAU,KAAOL,GACjB,CAAC,KAAK,MAAM,IAAIK,EAAU,EAAE,EAE5B,MAAM,IAAI,MACT,6CAA6CA,EAAU,EAAE,GAC1D,EAID,OAAW,CAACJ,EAAMK,CAAI,IAAK,KAAK,MAAO,CACtC,GAAIL,IAASF,GAAS,CAAC,KAAK,MAAM,IAAIE,CAAI,EACzC,MAAM,IAAI,MAAM,iCAAiCA,CAAI,GAAG,EAEzD,GACCK,EAAK,OAAS,UACdA,EAAK,KAAON,GACZ,CAAC,KAAK,MAAM,IAAIM,EAAK,EAAE,EAEvB,MAAM,IAAI,MACT,cAAcL,CAAI,oCAAoCK,EAAK,EAAE,GAC9D,CAEF,CAGA,OAAW,CAACT,CAAI,IAAK,KAAK,MACzB,GAAI,CAAC,KAAK,MAAM,IAAIA,CAAI,EACvB,MAAM,IAAI,MACT,SAASA,CAAI,kDAAkDA,CAAI,mCAAmCA,CAAI,SAC3G,CAGH,CACD,ECjHO,SAASU,GACfC,EACsC,CACtC,OAAO,IAAIC,EAAoCD,CAAM,CACtD,CC7BO,IAAME,EAAmB,sBACnBC,EAAgB,4BAIhBC,GAAY,MACxBC,EACAC,IACqB,CACrB,IAAMC,EAAiBF,EAAQ,SAAS,GAAG,EAAIA,EAAQ,MAAM,EAAG,EAAE,EAAIA,EAEtE,OAAO,MADQ,MAAM,MAAM,GAAGE,CAAc,GAAGD,CAAI,EAAE,GACjC,KAAK,CAC1B,EAYO,SAASE,GAAwBC,EAKjB,CACtB,MAAO,CACN,2BAA4BA,EAAO,YACnC,6BAA8BA,EAAO,cACrC,sBAAuBA,EAAO,aAC9B,GAAIA,EAAO,WAAa,CAAE,mBAAoBA,EAAO,SAAU,CAChE,CACD,CAkBO,SAASC,GAAyBD,EAKjB,CACvB,IAAME,EAAMF,EAAO,UAChB,CACA,eAAgBA,EAAO,UAAU,gBACjC,gBAAiBA,EAAO,UAAU,iBAClC,aAAcA,EAAO,UAAU,cAC/B,gBAAiBA,EAAO,UAAU,gBACnC,EACC,OAEH,MAAO,CACN,GAAI,CACH,GAAIE,GAAO,CAAE,IAAAA,CAAI,EACjB,GAAIF,EAAO,cAAgB,CAAE,OAAQA,EAAO,YAAa,EACzD,GAAIA,EAAO,gBAAkB,QAAa,CACzC,cAAeA,EAAO,aACvB,CACD,CACD,CACD,CAIO,SAASG,EAAcH,EAM3B,CACF,MAAO,CAEN,GAAIA,EAAO,mBAAqB,CAC/B,wBAAyBA,EAAO,iBACjC,EACA,iCAAkCA,EAAO,SACzC,gCAAiCA,EAAO,QACxC,0BAA2B,GAC3B,gCAAiC,GAEjC,GAAIA,EAAO,gBAAkB,CAC5B,GAAI,CACH,YAAaA,EAAO,eACpB,GAAIA,EAAO,YAAc,CAAE,WAAY,EAAK,CAC7C,CACD,CACD,CACD,CCvFO,SAASI,GAAeC,EAA4C,CAC1E,GAAM,CACL,GAAAC,EACA,MAAAC,EACA,YAAAC,EACA,QAAAC,EACA,SAAAC,EACA,aAAAC,EACA,cAAAC,EAAgB,GAChB,WAAAC,EAAa,EACd,EAAIR,EAGAS,EAAYT,EAAO,WAAa,CACnC,gBAAiB,CAACI,CAAO,EACzB,iBAAkB,CAACA,CAAO,CAC3B,EAIA,GAAI,QAAQ,IAAI,WAAa,cAC5B,GAAI,CACH,GAAM,CAAE,SAAAM,CAAS,EAAI,IAAI,IAAIN,CAAO,GAChCM,IAAa,aAAeA,IAAa,eAC5CD,EAAY,CACX,GAAGA,EACH,gBAAiB,CAChB,GAAIA,EAAU,iBAAmB,CAAC,EAClC,QAAQC,CAAQ,KAChB,SAASA,CAAQ,IAClB,EACA,iBAAkB,CACjB,GAAID,EAAU,kBAAoB,CAAC,EACnC,UAAUC,CAAQ,IACnB,CACD,EAEF,MAAQ,CAER,CAGD,IAAMC,EAAY,yBAAyBV,CAAE,QACvCW,EAAS,yBAAyBX,CAAE,QAGtCY,EAAsC,KACpCC,EAAU,KACVD,IAAaA,EAAcE,GAAUX,EAASC,CAAQ,GACpDQ,GAIFG,EAAgBb,EAEtB,eAAec,EAASC,EAAkC,CACzD,IAAMC,EAAO,MAAML,EAAQ,EAG3BI,EAAO,iBACN,GAAGjB,CAAE,iBACLU,EACA,CACC,MAAAT,EACA,YAAac,EACb,SAAUI,EACV,MAAO,CACN,2BAA4BJ,EAC5B,6BAA8BT,CAC/B,CACD,EACA,MAAOc,IAAS,CACf,SAAU,CACT,CACC,IAAKA,EAAI,KACT,SAAUD,EACV,KAAMD,EACN,MAAOG,GAAwB,CAC9B,YAAaN,EACb,cAAAT,EACA,aAAAD,EACA,UAAAG,CACD,CAAC,CACF,CACD,CACD,EACD,EAGAS,EAAO,iBACN,GAAGjB,CAAE,cACLW,EACA,CACC,MAAAV,EACA,YAAac,EACb,SAAUO,EACV,MAAO,CACN,GAAI,CACH,cAAAhB,CACD,CACD,CACD,EACA,MAAOc,IAAS,CACf,SAAU,CACT,CACC,IAAKA,EAAI,KACT,SAAUE,EACV,KAAMJ,EACN,MAAOK,GAAyB,CAC/B,YAAaR,EACb,cAAAT,EACA,UAAAE,CACD,CAAC,CACF,CACD,CACD,EACD,CACD,CAEA,MAAO,CACN,GAAAR,EACA,MAAAC,EACA,YAAAC,EACA,UAAAQ,EACA,OAAAC,EACA,WAAAJ,EACA,SAAAS,CACD,CACD,CC7GO,SAASQ,GACfC,EACAC,EACiB,CACjB,GAAM,CACL,SAAAC,EACA,YAAAC,EACA,YAAAC,EACA,YAAAC,EACA,qBAAAC,EAAuB,EACxB,EAAIN,EAEEO,EAAKP,EAAO,IAAME,GAAU,GAC5BM,EAAQR,EAAO,OAASE,GAAU,MAExC,GAAI,CAACK,EACJ,MAAM,IAAI,MACT,2DACD,EAED,GAAI,CAACC,EACJ,MAAM,IAAI,MACT,8DACD,EAID,IAAMC,EAAWP,EACdQ,EAAc,CACd,kBAAmBR,EAAS,UAC5B,eAAgBA,EAAS,OACzB,SAAUF,EAAO,UAAY,aAC7B,QAASA,EAAO,SAAW,SAC3B,WAAYE,EAAS,UACtB,CAAC,EACA,OAEH,MAAO,CACN,GAAAK,EACA,MAAAC,EACA,YAAAL,EAEA,MAAM,SAASQ,EAAkC,CAChDA,EAAO,aACNJ,EACA,CACC,MAAAC,EACA,YAAAL,EACA,YAAAC,EACA,YAAAC,EACA,GAAII,GAAY,CAAE,MAAOA,CAAS,CACnC,GACC,MAAOG,EAA2BC,IAAmB,CAKrD,IAAMC,EAJeD,EAI+B,OAAS,CAAC,EAExDE,EAAS,MAAMd,EAAQW,EAAM,CAAE,MAAO,CAAE,MAAAE,CAAM,CAAE,CAAC,EAGvD,OAAIZ,GAAYa,EAAO,KACf,CACN,QAAS,CAAC,CAAE,KAAM,OAAQ,KAAMA,EAAO,IAAK,CAAC,EAC7C,kBAAmBA,EAAO,KAC1B,MAAO,CACN,GAAGN,EACH,GAAGK,EACH,GAAIR,IAAyB,GAC1B,CAAE,gCAAiC,EAAM,EACzC,CAAC,CACL,CACD,EAIM,CACN,QAAS,CAAC,CAAE,KAAM,OAAiB,KAAMS,EAAO,IAAK,CAAC,EACtD,GAAIA,EAAO,KAAO,CAAE,kBAAmBA,EAAO,IAAK,EAAI,CAAC,EACxD,GAAIT,IAAyB,GAC1B,CACA,MAAO,CACN,gCAAiC,EAClC,CACD,EACC,CAAC,CACL,CACD,EACD,CACD,CACD,CACD,CAKA,eAAsBU,GACrBL,EACAM,EACgB,CAChB,MAAM,QAAQ,IAAIA,EAAM,IAAKC,GAAMA,EAAE,SAASP,CAAM,CAAC,CAAC,CACvD,CCjJO,IAAMQ,EAAN,cAA4B,KAAM,CACxC,YACCC,EACOC,EACN,CACD,MAAMD,CAAO,EAFN,YAAAC,EAGP,KAAK,KAAO,eACb,CACD,ECGA,IAAMC,GAAW,gBAEV,SAASC,GAAeC,EAAkC,CAChE,GAAM,CAAE,QAAAC,EAAS,OAAAC,CAAO,EAAIF,EAE5B,SAASG,GAAwB,CAChC,GAAI,CAACD,EACJ,MAAM,IAAI,MAAM,6BAA6B,EAE9C,OAAOA,CACR,CAEA,eAAeE,EACdC,EACAC,EACAC,EACa,CACb,IAAMC,EAAML,EAAc,EACpBM,EAAM,GAAGR,EAAQ,QAAQ,MAAO,EAAE,CAAC,GAAGK,CAAI,GAE1CI,EAAkC,CACvC,cAAe,UAAUF,CAAG,GAC5B,iBAAkBV,EACnB,EAEMa,EAAoB,CAAE,OAAAN,EAAQ,QAAAK,CAAQ,EAExCH,IAAS,SACZG,EAAQ,cAAc,EAAI,mBAC1BC,EAAK,KAAO,KAAK,UAAUJ,CAAI,GAGhC,IAAMK,EAAW,MAAM,MAAMH,EAAKE,CAAI,EAEtC,GAAI,CAACC,EAAS,GAAI,CACjB,IAAMC,EAAO,MAAMD,EAAS,KAAK,EAAE,MAAM,IAAM,EAAE,EACjD,MAAM,IAAIE,EACTD,GAAQ,sBAAsBD,EAAS,MAAM,GAC7CA,EAAS,MACV,CACD,CAGA,OADc,MAAMA,EAAS,KAAK,GACtB,IACb,CAEA,MAAO,CACN,MAAM,OAAOG,EAAgD,CAC5D,OAAOX,EAAwB,OAAQ,qBAAsB,CAC5D,MAAAW,CACD,CAAC,CACF,EAEA,MAAM,OACLC,EACAC,EAC0B,CAC1B,OAAOb,EAAwB,OAAQ,qBAAsB,CAC5D,MAAAY,EACA,GAAGC,CACJ,CAAC,CACF,EAEA,MAAM,SAA+B,CACpC,OAAOb,EAAoB,MAAO,qBAAqB,CACxD,CACD,CACD,CC7EA,IAAMc,GAAiB,gBAQhB,SAASC,EACfC,EACAC,EAAgC,CAAC,EACf,CAClB,IAAMC,EAAMD,EAAQ,MAAQ,IAAM,IAAI,MAChCE,EAAaF,EAAQ,YAAcG,GACnCC,EAAYC,GAAiBN,CAAK,EAClCO,EAAOC,EAASR,EAAM,IAAI,EAC1BS,EAAWD,EAASR,EAAM,QAAQ,EAClCU,EAAcC,GAAsBX,EAAOO,CAAI,EAC/CK,EAAUC,EAAmBb,EAAM,OAAO,GAAKG,EAAW,EAC1DW,EAAYC,GAAmBf,EAAM,UAAWE,CAAG,EACnDc,EACLH,EAAmBb,EAAM,MAAM,GAAKC,EAAQ,QAAUH,GACjDmB,EAAYC,EAAmBlB,CAAK,EAAI,CAAE,GAAGA,CAAM,EAAI,OAEvDmB,EAA0C,CAC/C,GAAGV,CACJ,EACA,OAAI,OAAO,KAAKF,CAAI,EAAE,OAAS,IAAGY,EAAe,KAAOZ,GACpDU,IAAWE,EAAe,UAAYF,GAEnC,CACN,GAAIL,EACJ,KAAM,YACN,KAAMP,EACN,OAAAW,EACA,UAAAF,EACA,YAAAJ,EACA,WAAYU,GAAcpB,EAAOK,CAAS,EAC1C,SAAUc,EACV,UAAAF,CACD,CACD,CAEO,SAASb,IAAwB,CACvC,OACC,OAAO,OAAW,KAClB,OAAO,OAAO,YAAe,WAEtB,OAAO,OAAO,WAAW,CAAC,GAG3B,OAAO,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAG,EAAE,CAAC,IAAI,KAAK,IAAI,EAAE,SAAS,EAAE,CAAC,EACjF,CAEA,SAASgB,GACRpB,EACAK,EAC0B,CAC1B,GAAI,CAACa,EAAmBlB,CAAK,EAC5B,OAAOQ,EAASR,EAAM,UAAU,EAGjC,IAAMqB,EAAmBC,GAAoBtB,EAAOK,CAAS,EACvDkB,EAAqBf,EAASR,EAAM,UAAU,EACpD,MAAO,CACN,GAAGqB,EACH,GAAGE,CACJ,CACD,CAEA,SAASD,GACRtB,EACAK,EAC0B,CAC1B,OAAQA,EAAW,CAClB,IAAK,cAAe,CACnB,IAAMmB,EAAsC,CAAC,EAC7C,OAAIX,EAAmBb,EAAM,QAAQ,IAAGwB,EAAW,KAAOxB,EAAM,UAC5Da,EAAmBb,EAAM,QAAQ,IAAGwB,EAAW,KAAOxB,EAAM,UACzDwB,CACR,CACA,IAAK,kBAAmB,CACvB,IAAMA,EAAsC,CAAC,EAC7C,OAAI,OAAOxB,EAAM,aAAgB,WAChCwB,EAAW,OAASxB,EAAM,aAEvBa,EAAmBb,EAAM,aAAa,IACzCwB,EAAW,SAAWxB,EAAM,eAEtBwB,CACR,CACA,IAAK,eAAgB,CACpB,IAAMA,EAAsC,CAAC,EAC7C,OAAIX,EAAmBb,EAAM,OAAO,IAAGwB,EAAW,IAAMxB,EAAM,SACvDwB,CACR,CACA,IAAK,qBAAsB,CAC1B,IAAMA,EAAsC,CAAC,EAC7C,OAAI,OAAOxB,EAAM,gBAAmB,WACnCwB,EAAW,OAASxB,EAAM,gBAEvBa,EAAmBb,EAAM,gBAAgB,IAC5CwB,EAAW,SAAWxB,EAAM,kBAEtBwB,CACR,CACA,QACC,MAAO,CAAC,CACV,CACD,CAEA,SAASlB,GAAiBN,EAA8B,CACvD,OAAIkB,EAAmBlB,CAAK,EAAUA,EAAM,UACrCA,EAAM,KACd,CAEA,SAASW,GACRX,EACAO,EACmB,CACnB,IAAMkB,EACLZ,EAAmBb,EAAM,SAAS,GAClC0B,EAAgBnB,EAAM,CAAC,mBAAoB,YAAa,eAAe,CAAC,EAEnEoB,EACLd,EAAmBb,EAAM,SAAS,GAClC0B,EAAgBnB,EAAM,CACrB,mBACA,YACA,iBACA,qBACD,CAAC,EAEIqB,EACLf,EAAmBb,EAAM,OAAO,GAChC0B,EAAgBnB,EAAM,CACrB,iBACA,UACA,cACA,mBACA,WACD,CAAC,EAEIsB,EACLhB,EAAmBb,EAAM,cAAc,GACvC0B,EAAgBnB,EAAM,CACrB,gBACA,iBACA,SACA,SACD,CAAC,EAEIuB,EACLjB,EAAmBb,EAAM,aAAa,GACtC0B,EAAgBnB,EAAM,CAAC,gBAAiB,kBAAkB,CAAC,GAC3DkB,EAEKf,EAAgC,CAAC,EACvC,OAAIiB,IAAWjB,EAAY,UAAYiB,GACnCC,IAASlB,EAAY,QAAUkB,GAC/BH,IAAWf,EAAY,UAAYe,GACnCK,IAAepB,EAAY,cAAgBoB,GAC3CD,IAAgBnB,EAAY,eAAiBmB,GAC1CnB,CACR,CAEA,SAASK,GACRf,EACAE,EACS,CACT,GAAIF,aAAiB,KAAM,OAAOA,EAAM,YAAY,EACpD,GAAI,OAAOA,GAAU,SAAU,CAC9B,IAAM+B,EAAO,IAAI,KAAK/B,CAAK,EAC3B,GAAI,CAAC,OAAO,MAAM+B,EAAK,QAAQ,CAAC,EAAG,OAAOA,EAAK,YAAY,CAC5D,CACA,OAAO7B,EAAI,EAAE,YAAY,CAC1B,CAEA,SAASwB,EACRM,EACAC,EACqB,CACrB,QAAWC,KAAOD,EAAM,CACvB,IAAME,EAAQH,EAAOE,CAAG,EACxB,GAAI,OAAOC,GAAU,UAAYA,EAAM,KAAK,EAAE,OAAS,EACtD,OAAOA,CAET,CAED,CAEA,SAAS3B,EAAS2B,EAAyC,CAC1D,MAAI,CAACA,GAAS,OAAOA,GAAU,UAAY,MAAM,QAAQA,CAAK,EACtD,CAAC,EAEFA,CACR,CAEA,SAAStB,EAAmBsB,EAAoC,CAC/D,GAAI,OAAOA,GAAU,UACjBA,EAAM,KAAK,EAAE,SAAW,EAC5B,OAAOA,CACR,CAEA,SAASjB,EAAmBlB,EAA8C,CACzE,MAAO,cAAeA,CACvB,CCtMA,IAAMoC,GAAwB,2BAQ9B,IAAMC,GAAW,gBAEXC,GAAsB,IAAI,IAAI,CAAC,IAAK,GAAG,CAAC,EACxCC,GAAmB,IAAI,IAAI,CAAC,IAAK,IAAK,IAAK,IAAK,IAAK,IAAK,GAAG,CAAC,EA6C7D,SAASC,GACfC,EACmB,CACnB,OAAO,IAAIC,EAAoBD,CAAO,CACvC,CAEA,IAAMC,EAAN,KAAsD,CACpC,YACA,gBACA,aACA,cACA,WACA,iBACA,gBACA,kBACA,WACA,QACA,OACA,IACA,MACA,OAEA,OAA4B,CAAC,EACtC,WACA,eAAiB,GACjB,oBACA,cACA,cAAgB,EAChB,UAAY,GACZ,eAAiB,GAEzB,YAAYD,EAA6B,CACxC,KAAK,YAAcE,GAClBF,EAAQ,QACRA,EAAQ,cAAgBG,EACzB,EACA,KAAK,gBAAkBH,EAAQ,iBAAmB,IAClD,KAAK,aAAeA,EAAQ,cAAgB,GAC5C,KAAK,cAAgBA,EAAQ,eAAiB,IAC9C,KAAK,WAAaA,EAAQ,YAAc,EACxC,KAAK,iBACJA,EAAQ,kBAAoB,IAC7B,KAAK,gBACJA,EAAQ,iBAAmB,IAC5B,KAAK,kBACJA,EAAQ,mBAAqB,IAC9B,KAAK,QAAUA,EAAQ,SAAW,MAClC,KAAK,OAASA,EAAQ,QAAU,QAChC,KAAK,IAAMA,EAAQ,MAAQ,IAAM,IAAI,MACrC,KAAK,MACJA,EAAQ,QACNI,GAAY,IAAI,QAASC,GAAY,WAAWA,EAASD,CAAO,CAAC,GACpE,KAAK,OAASJ,EAAQ,OACtB,KAAK,WAAaA,EAAQ,WAEtB,KAAK,gBAAkB,IAC1B,KAAK,WAAa,YAAY,IAAM,CAC9B,KAAK,MAAM,CACjB,EAAG,KAAK,eAAe,EAEzB,CAEA,QAAQM,EAA8B,CACrC,GAAI,KAAK,WAAa,KAAK,eAAgB,CAC1C,KAAK,OAAO,KACX,8DACAA,EAAM,EACP,EACA,MACD,CAEA,GAAI,KAAK,OAAO,QAAU,KAAK,cAAe,CAC7C,IAAMC,EAAY,KAAK,OAAO,OAAS,KAAK,cAAgB,EAC5D,KAAK,OAAO,OAAO,EAAGA,CAAS,EAC/B,KAAK,OAAO,KACX,kEACAA,CACD,CACD,CAIA,GAFA,KAAK,OAAO,KAAKD,CAAK,EAElB,KAAK,OAAO,QAAU,KAAK,aAAc,CACvC,KAAK,MAAM,EAChB,MACD,CAEA,KAAK,mBAAmB,CACzB,CAEA,eAAwB,CACvB,OAAO,KAAK,OAAO,OAAS,KAAK,aAClC,CAEA,MAAM,OAAuB,CAC5B,OAAI,KAAK,cAAsB,KAAK,eACpC,KAAK,cAAgB,KAAK,UAAU,EAAE,QAAQ,IAAM,CACnD,KAAK,cAAgB,MACtB,CAAC,EACM,KAAK,cACb,CAEA,MAAM,SACLN,EACkC,CAClC,KAAK,eAAiB,GAClB,KAAK,aACR,cAAc,KAAK,UAAU,EAC7B,KAAK,WAAa,QAEf,KAAK,sBACR,aAAa,KAAK,mBAAmB,EACrC,KAAK,oBAAsB,OAC3B,KAAK,eAAiB,IAGvB,IAAMQ,EAAYR,GAAS,WAAa,KAAK,kBACvCS,EAAe,KAAK,MAAM,EAEhC,GAAI,CAAC,OAAO,SAASD,CAAS,GAAKA,GAAa,EAC/C,aAAMC,EACN,KAAK,UAAY,GACV,CAAE,SAAU,GAAO,cAAe,KAAK,cAAc,CAAE,EAG/D,IAAMC,EAAgB,OAAO,kBAAkB,EAM/C,OALe,MAAM,QAAQ,KAAK,CACjCD,EAAa,KAAK,IAAM,SAAkB,EAC1C,KAAK,MAAMD,CAAS,EAAE,KAAK,IAAME,CAAa,CAC/C,CAAC,IAEcA,GACd,KAAK,UAAY,GACV,CAAE,SAAU,GAAM,cAAe,KAAK,cAAc,CAAE,IAG9D,KAAK,UAAY,GACV,CAAE,SAAU,GAAO,cAAe,KAAK,cAAc,CAAE,EAC/D,CAEQ,oBAA2B,CAC9B,KAAK,iBACT,KAAK,eAAiB,GACtB,KAAK,oBAAsB,WAAW,IAAM,CAC3C,KAAK,oBAAsB,OAC3B,KAAK,eAAiB,GACjB,KAAK,MAAM,CACjB,EAAG,CAAC,EACL,CAEA,MAAc,WAA2B,CACxC,KAAO,KAAK,OAAO,OAAS,GAAK,CAAC,KAAK,WAAW,CACjD,IAAMC,EAAQ,KAAK,OAAO,OAAO,EAAG,KAAK,YAAY,EACrD,MAAM,KAAK,mBAAmBA,CAAK,CACpC,CACD,CAEA,MAAc,mBAAmBA,EAAyC,CACzE,IAAIC,EAAU,EACVC,EAAeF,EAEnB,KAAOE,EAAa,OAAS,GAAK,CAAC,KAAK,WAAW,CAClD,KAAK,cAAgBA,EAAa,OAClC,IAAMC,EAAS,MAAM,KAAK,cAAcD,CAAY,EAGpD,OAFA,KAAK,cAAgB,EAEbC,EAAO,KAAM,CACpB,IAAK,UACJ,OACD,IAAK,OACJ,KAAK,4BAA4BA,EAAO,OAAQD,EAAa,MAAM,EACnE,OACD,IAAK,YACJ,KAAK,OAAO,MACX,8DACAA,EAAa,OACbC,EAAO,MACR,EACA,OACD,IAAK,YACJ,GAAIF,GAAW,KAAK,WAAY,CAC/B,KAAK,OAAO,MACX,6DACAC,EAAa,OACbC,EAAO,MACR,EACA,MACD,CACA,MAAM,KAAK,MAAM,KAAK,eAAeF,CAAO,CAAC,EAC7CA,GAAW,EACX,SACD,IAAK,UAOJ,GANIE,EAAO,UAAU,OAAS,GAC7B,KAAK,OAAO,MACX,wDACAA,EAAO,UAAU,MAClB,EAEGA,EAAO,UAAU,SAAW,EAAG,OACnC,GAAIF,GAAW,KAAK,WAAY,CAC/B,KAAK,OAAO,MACX,mEACAE,EAAO,UAAU,MAClB,EACA,MACD,CACAD,EAAeC,EAAO,UACtB,MAAM,KAAK,MAAM,KAAK,eAAeF,CAAO,CAAC,EAC7CA,GAAW,EACX,QACF,CACD,CACD,CAEA,MAAc,cACbG,EAC2B,CAC3B,IAAIC,EAEJ,GAAI,CACHA,EAAW,MAAM,KAAK,QAAQ,KAAK,YAAa,CAC/C,OAAQ,OACR,QAAS,CACR,eAAgB,mBAChB,cAAe,UAAU,KAAK,MAAM,GACpC,iBAAkBpB,EACnB,EACA,KAAM,KAAK,UAAU,KAAK,iBAAiBmB,CAAM,CAAC,CACnD,CAAC,CACF,OAASE,EAAO,CACf,MAAO,CACN,KAAM,YACN,OAAQC,GAAgBD,CAAK,CAC9B,CACD,CAEA,GAAIpB,GAAoB,IAAImB,EAAS,MAAM,EAC1C,MAAO,CAAE,KAAM,OAAQ,OAAQA,EAAS,MAAO,EAGhD,GAAIlB,GAAiB,IAAIkB,EAAS,MAAM,EACvC,MAAO,CACN,KAAM,YACN,OAAQ,QAAQA,EAAS,MAAM,EAChC,EAGD,GAAI,CAACA,EAAS,GACb,MAAO,CACN,KAAM,YACN,OAAQ,QAAQA,EAAS,MAAM,EAChC,EAGD,IAAMG,EAAO,MAAMC,GAAmCJ,CAAQ,EAC9D,GAAI,CAACG,GAAM,UAAYA,EAAK,SAAS,SAAW,EAC/C,MAAO,CAAE,KAAM,SAAU,EAG1B,IAAME,EAAU,KAAK,uBAAuBN,EAAQI,EAAK,QAAQ,EACjE,OAAIE,EAAQ,UAAU,SAAW,GAAKA,EAAQ,UAAU,SAAW,EAC3D,CAAE,KAAM,SAAU,EAGnB,CACN,KAAM,UACN,UAAWA,EAAQ,UACnB,UAAWA,EAAQ,SACpB,CACD,CAEQ,iBAAiBN,EAA2C,CACnE,MAAO,CACN,OAAQ,KAAK,IAAI,EAAE,YAAY,EAC/B,OAAQ,CACP,IAAKnB,GACL,QAAS,KAAK,YAAc,OAC7B,EACA,OAAAmB,CACD,CACD,CAEQ,uBACPA,EACAO,EAIC,CACD,IAAMC,EAAO,IAAI,IAAIR,EAAO,IAAKT,GAAU,CAACA,EAAM,GAAIA,CAAK,CAAC,CAAC,EACvDkB,EAA+B,CAAC,EAChCC,EAA+B,CAAC,EAEtC,QAAWC,KAAiBJ,EAAU,CACrC,IAAMhB,EAAQiB,EAAK,IAAIG,EAAc,OAAO,EAC5C,GAAKpB,EACL,IAAIqB,GAAyBD,CAAa,EAAG,CAC5CF,EAAU,KAAKlB,CAAK,EACpB,QACD,CACAmB,EAAU,KAAKnB,CAAK,EACrB,CAEA,MAAO,CAAE,UAAAkB,EAAW,UAAAC,CAAU,CAC/B,CAEQ,eAAeb,EAAyB,CAC/C,IAAMgB,EAAW,KAAK,iBAAmB,GAAKhB,EAC9C,OAAO,KAAK,IAAIgB,EAAU,KAAK,eAAe,CAC/C,CAEQ,4BACPC,EACAC,EACO,CACP,KAAK,UAAY,GACjB,IAAMC,EAAW,KAAK,OAAO,OAC7B,KAAK,OAAO,OAAO,EAAGA,CAAQ,EAC9B,KAAK,OAAO,MACX,iGACAF,EACAC,EAAgBC,CACjB,CACD,CACD,EAEA,SAASJ,GACRD,EACU,CACV,GAAIA,EAAc,YAAc,GAAM,MAAO,GAC7C,IAAMM,EAAON,EAAc,KAAK,YAAY,EAC5C,OACCM,EAAK,SAAS,SAAS,GACvBA,EAAK,SAAS,WAAW,GACzBA,EAAK,SAAS,aAAa,GAC3BA,EAAK,SAAS,YAAY,GAC1BA,EAAK,SAAS,WAAW,GACzBA,EAAK,SAAS,QAAQ,CAExB,CAEA,eAAeZ,GACdJ,EACyB,CACzB,IAAMiB,EAAO,MAAMjB,EAAS,KAAK,EACjC,GAAKiB,EACL,GAAI,CACH,OAAO,KAAK,MAAMA,CAAI,CACvB,MAAQ,CACP,MACD,CACD,CAEA,SAAS/B,GAAQgC,EAAiBC,EAA8B,CAC/D,IAAMC,EAAiBF,EAAQ,SAAS,GAAG,EAAIA,EAAU,GAAGA,CAAO,IAC7DG,EAAiBF,EAAa,WAAW,GAAG,EAC/CA,EAAa,MAAM,CAAC,EACpBA,EACH,MAAO,GAAGC,CAAc,GAAGC,CAAc,EAC1C,CAEA,SAASnB,GAAgBD,EAAwB,CAChD,OAAIA,aAAiB,MAAcA,EAAM,QAClC,OAAOA,CAAK,CACpB,CC3YO,SAASqB,GAAqBC,EAAwC,CAC5E,GAAM,CAAE,QAAAC,EAAS,OAAAC,EAAQ,SAAAC,CAAS,EAAIH,EAEtC,SAASI,GAAwB,CAChC,GAAI,CAACF,EACJ,MAAM,IAAI,MAAM,6BAA6B,EAE9C,OAAOA,CACR,CAEA,IAAMG,EAAYH,EACfI,GAAuB,CACvB,QAAAL,EACA,OAAAC,EACA,aAAcC,EAAS,aACvB,gBAAiBA,EAAS,gBAC1B,aAAcA,EAAS,aACvB,cAAeA,EAAS,cACxB,WAAYA,EAAS,WACrB,iBAAkBA,EAAS,iBAC3B,gBAAiBA,EAAS,gBAC1B,kBAAmBA,EAAS,iBAC7B,CAAC,EACA,OAEGI,EAAyB,CAC9B,MAAM,SACLC,EACAC,EAC+B,CAC/BL,EAAc,EACd,IAAMM,EAAcC,EAAkB,CACrC,MAAO,kBACP,eAAgBH,EAChB,WAAAC,CACD,CAAC,EACD,OAAAJ,GAAW,QAAQK,CAAW,EACvB,CAAE,QAASA,EAAY,EAAG,CAClC,EACA,MAAM,MAAME,EAAiD,CAC5DR,EAAc,EACd,IAAMM,EAAcC,EAAkBC,CAAK,EAC3C,OAAAP,GAAW,QAAQK,CAAW,EACvB,CAAE,QAASA,EAAY,EAAG,CAClC,EACA,MAAM,OAAuB,CAC5BN,EAAc,EACd,MAAMC,GAAW,MAAM,CACxB,EACA,MAAM,SAASQ,EAAmC,CACjD,OAAAT,EAAc,EAEZ,MAAMC,GAAW,SAAS,CAC1B,UAAWQ,GAAS,WAAaV,EAAS,iBAC3C,CAAC,GAAM,CAAE,SAAU,GAAO,cAAe,CAAE,CAE7C,CACD,EAEA,OAAIE,GACHS,GAAoBP,EAAQJ,EAAS,iBAAiB,EAEhDI,CACR,CAEA,SAASO,GACRP,EACAQ,EACO,CACP,GACC,OAAO,QAAY,KACnB,OAAO,QAAQ,MAAS,YACxB,OAAO,QAAQ,IAAO,WAEtB,OAGD,IAAMC,EAAW,IAAM,CACjBT,EAAO,SAAS,CAAE,UAAWQ,CAAiB,CAAC,CACrD,EAEA,QAAQ,KAAK,aAAcC,CAAQ,EACnC,QAAQ,KAAK,SAAUA,CAAQ,EAC/B,QAAQ,KAAK,UAAWA,CAAQ,CACjC,CC/FO,SAASC,EAASC,EAAyC,CACjE,IAAMC,EAAUD,GAAQ,SAAW,0BAC7BE,EAASF,GAAQ,QAAU,QAAQ,IAAI,iBACvCG,EAAiB,CACtB,aAAcH,GAAQ,UAAU,cAAgB,2BAChD,gBAAiBA,GAAQ,UAAU,iBAAmB,IACtD,aAAcA,GAAQ,UAAU,cAAgB,GAChD,cAAeA,GAAQ,UAAU,eAAiB,IAClD,WAAYA,GAAQ,UAAU,YAAc,EAC5C,iBAAkBA,GAAQ,UAAU,kBAAoB,IACxD,gBAAiBA,GAAQ,UAAU,iBAAmB,IACtD,kBAAmBA,GAAQ,UAAU,mBAAqB,GAC3D,EAEMI,EAAiB,CAAE,QAAAH,EAAS,OAAAC,EAAQ,SAAUC,CAAe,EAG7DE,EAAiBC,GAAqBF,CAAc,EACpDG,EAAWC,GAAeJ,CAAc,EAE9C,MAAO,CACN,GAAGC,EACH,GAAIE,EACJ,QAASH,CACV,CACD,CCIA,SAASK,GAAeC,EAAoC,CAC3D,IAAMC,EAAYD,EAAG,YAAc,eAM7BE,EADgBD,EAAU,WAAW,SAAS,EAEnCA,EAAY,UAAUA,CAAS,GAI1CE,EAAsC,CAC3C,GAAIH,EAAG,UAAY,CAAC,CACrB,EACA,OAAIA,EAAG,aAAYG,EAAW,WAAaH,EAAG,YAEvC,CACN,MAAOE,EACP,WAAAC,EACA,UAAWH,EAAG,WACd,QAASA,EAAG,SACZ,eAAgBA,EAAG,QACnB,QAASA,EAAG,SACZ,UAAWA,EAAG,UACd,OAAQA,EAAG,QAAU,QACtB,CACD,CAMO,SAASI,GAAoBC,EAAgC,CACnE,IAAMC,EAAyB,CAC9B,OAAQD,GAAS,OACjB,QAASA,GAAS,OACnB,EAGIE,EAEJ,SAASC,GAAY,CACpB,OAAKD,IACJA,EAASE,EAASH,CAAM,GAElBC,CACR,CAEA,OAAO,eAAuBG,EAAqC,CAClE,IAAIC,EACJ,GAAI,CACHA,EAAQ,MAAMD,EAAQ,KAAK,CAC5B,MAAQ,CACP,OAAO,IAAI,SAAS,KAAK,UAAU,CAAE,MAAO,cAAe,CAAC,EAAG,CAC9D,OAAQ,IACR,QAAS,CAAE,eAAgB,kBAAmB,CAC/C,CAAC,CACF,CAEA,GAAI,CAAC,MAAM,QAAQC,EAAK,MAAM,GAAKA,EAAK,OAAO,SAAW,EACzD,OAAO,IAAI,SACV,KAAK,UAAU,CAAE,MAAO,+BAAgC,CAAC,EACzD,CACC,OAAQ,IACR,QAAS,CAAE,eAAgB,kBAAmB,CAC/C,CACD,EAGD,GAAI,CACH,IAAMC,EAAIJ,EAAU,EACdK,EAAoB,CAAC,EAE3B,QAAWb,KAAMW,EAAK,OAAQ,CAC7B,IAAMG,EAAaf,GAAeC,CAAE,EAC9Be,EAAS,MAAMH,EAAE,MAAME,CAAU,EACvCD,EAAQ,KAAKE,EAAO,OAAO,CAC5B,CAEA,aAAMH,EAAE,MAAM,EAEP,IAAI,SACV,KAAK,UAAU,CAAE,GAAI,GAAM,SAAUC,EAAQ,MAAO,CAAC,EACrD,CACC,OAAQ,IACR,QAAS,CAAE,eAAgB,kBAAmB,CAC/C,CACD,CACD,OAASG,EAAO,CACf,IAAMC,EAAUD,aAAiB,MAAQA,EAAM,QAAU,gBACzD,OAAO,IAAI,SAAS,KAAK,UAAU,CAAE,MAAOC,CAAQ,CAAC,EAAG,CACvD,OAAQ,IACR,QAAS,CAAE,eAAgB,kBAAmB,CAC/C,CAAC,CACF,CACD,CACD,CC/HO,IAAMC,EAAN,KAAuB,CACrB,OAA6B,KAC7B,QAAyC,KAChC,OAEjB,YAAYC,EAA2B,CACtC,KAAK,OAASA,CACf,CAMA,MAAM,SAASC,EAAoBC,EAA0C,CAC5E,OAAI,KAAK,QAAU,KAAK,IAAI,EAAI,KAAK,OAAO,UAAY,KAChD,KAAK,OAAO,MAIhB,KAAK,QAAgB,KAAK,SAE9B,KAAK,QAAU,KAAK,KAAKD,EAAWC,CAAO,EAAE,QAAQ,IAAM,CAC1D,KAAK,QAAU,IAChB,CAAC,EAEM,KAAK,QACb,CAEA,MAAc,KACbD,EACAC,EACyB,CACzB,IAAMC,EAAMC,GAAQ,KAAK,OAAO,QAAS,wBAAwB,EAE3DC,EAA+B,CAAC,EAClCJ,IAAWI,EAAK,UAAYJ,GAC5BC,IAASG,EAAK,QAAUH,GAE5B,GAAI,CACH,IAAMI,EAAW,MAAM,MAAMH,EAAK,CACjC,OAAQ,OACR,QAAS,CACR,eAAgB,mBAChB,cAAe,UAAU,KAAK,OAAO,MAAM,EAC5C,EACA,KAAM,KAAK,UAAUE,CAAI,CAC1B,CAAC,EAED,GAAI,CAACC,EAAS,GAAI,OAAO,KAEzB,IAAMC,EAAQ,MAAMD,EAAS,KAAK,EAG5BE,EACLD,EAAK,MAAQ,OAAOA,EAAK,MAAS,SAAWA,EAAK,KAAOA,EAGpDE,EAAc,IAAI,KAAKD,EAAO,SAAS,EAAE,QAAQ,EACvD,MAAI,CAACA,EAAO,OAAS,OAAO,MAAMC,CAAW,EAAU,MAEvD,KAAK,OAAS,CACb,MAAOD,EAAO,MACd,UAAWC,CACZ,EAEOD,EAAO,MACf,MAAQ,CACP,OAAO,IACR,CACD,CACD,EAEA,SAASJ,GAAQM,EAAiBC,EAAsB,CAEvD,MAAO,GADMD,EAAQ,SAAS,GAAG,EAAIA,EAAQ,MAAM,EAAG,EAAE,EAAIA,CAC9C,GAAGC,CAAI,EACtB,CC3CA,IAAMC,GAAmB,0BAYlB,SAASC,GACfC,EACAC,EAA+B,CAAC,EACpB,CACZ,IAAMC,EAAgBF,EACtB,GAAIE,EAAc,kBACjB,OAAOA,EAGRA,EAAc,kBAAoB,GAElC,IAAMC,EAAUF,EAAQ,QAAUG,EAASH,EAAQ,MAAM,EACnDI,EAAcJ,EAAQ,oBAAsB,GAG9CK,EAAsC,KAE1C,SAASC,GAAyC,CACjD,GAAID,EAAY,OAAOA,EACvB,IAAME,EAASL,EAAQ,QAAQ,OAC/B,OAAKK,GACLF,EAAa,IAAIG,EAAiB,CACjC,QAASN,EAAQ,QAAQ,SAAWL,GACpC,OAAAU,CACD,CAAC,EACMF,GALa,IAMrB,CAEA,IAAMI,EAAuBV,EAAO,aAAa,KAAKA,CAAM,EAI5D,OAAAE,EAAc,cAAgB,IAAIS,IAAoB,CACrD,GAAM,CAACC,EAAaC,EAAQC,CAAU,EAAIH,EACpCI,EACL,OAAOH,GAAgB,UAAYA,EAAY,KAAK,EAAE,OAAS,EAC5DA,EACA,UAEJ,GAAI,OAAOE,GAAe,WACzB,OAAOJ,EAAqB,GAAGC,CAAI,EAGpC,IAAMK,EAAUF,EA0DhB,OAAOJ,EAAqBE,EAAaC,EArDlB,MAAOI,EAAgBC,IAAmB,CAChE,IAAMC,EAAY,YAAY,IAAI,EAClC,GAAI,CACH,IAAMC,EAAS,MAAMJ,EAAQC,EAAOC,CAAK,EACnCG,EAAa,KAAK,MAAM,YAAY,IAAI,EAAIF,CAAS,EAE3D,aAAMG,GACLnB,EACAoB,GAAgBR,EAAUG,EAAOjB,EAAS,CACzC,WAAAoB,EACA,OAAQ,IACT,CAAC,EACDpB,EAAQ,OACT,EAEIA,EAAQ,oBACX,MAAMuB,GAAUrB,EAASF,EAAQ,OAAO,EAGrCI,GACH,MAAMoB,GACLL,EACAb,EAAc,EACdJ,EAAQ,QAAQ,SAAWL,GAC3BG,EAAQ,OACT,EAGDyB,GAAmBN,EAAQF,CAAK,EAEzBE,CACR,OAASO,EAAO,CACf,IAAMN,EAAa,KAAK,MAAM,YAAY,IAAI,EAAIF,CAAS,EAE3D,YAAMG,GACLnB,EACAoB,GAAgBR,EAAUG,EAAOjB,EAAS,CACzC,WAAAoB,EACA,OAAQ,QACR,aACCM,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,CACvD,CAAC,EACD1B,EAAQ,OACT,EAEIA,EAAQ,oBACX,MAAMuB,GAAUrB,EAASF,EAAQ,OAAO,EAGnC0B,CACP,CACD,CAE+D,CAChE,GAEOzB,CACR,CAEA,eAAeuB,GACdL,EACAQ,EACAC,EACAC,EACgB,CAChB,GAAI,CAACC,EAASX,CAAM,EAAG,OAElBW,EAASX,EAAO,KAAK,IACxBA,EAAyB,MAAQ,CAAC,GAGpC,IAAMY,EAAQZ,EAAyB,MACjCa,EAAgC,CACrC,SAAU,GAAGJ,EAAQ,QAAQ,MAAO,EAAE,CAAC,0BACxC,EAEA,GAAID,EACH,GAAI,CACH,IAAMM,EAAQ,MAAMN,EAAM,SAAS,EAC/BM,IACHD,EAAe,MAAQC,EAEzB,OAASP,EAAO,CACfG,IAAUK,EAAQR,CAAK,CAAC,CACzB,CAGDK,EAAK,SAAWC,CACjB,CAEA,SAASV,GACRR,EACAG,EACAjB,EACAmC,EACa,CACb,IAAMC,EAAWC,GAAgBvB,EAAUd,EAAQ,QAAQ,EACrD+B,EAAOO,GAAYrB,CAAK,EAE9B,MAAO,CACN,MAAO,cACP,WAAY,CACX,KAAMH,EACN,KAAMsB,EACN,GAAID,GAAU,CAAC,CAChB,EACA,KAAAJ,EACA,SAAU,CACT,OAAQ,eACR,GAAI/B,EAAQ,UAAY,CAAC,CAC1B,CACD,CACD,CAEA,SAASqC,GACRvB,EACAyB,EAC+B,CAC/B,OAAI,OAAOA,GAAmB,WACtBA,EAAezB,CAAQ,GAAK,QAE7ByB,GAAkB,OAC1B,CAEA,SAASD,GAAYrB,EAA2C,CAC/D,GAAI,CAACa,EAASb,CAAK,EAAG,OAEtB,IAAMc,EAAOd,EAAM,MACnB,GAAKa,EAASC,CAAI,EAElB,OAAOA,CACR,CAEA,SAASD,EAASU,EAAwC,CACzD,MAAO,EAAQA,GAAU,OAAOA,GAAU,UAAY,CAAC,MAAM,QAAQA,CAAK,CAC3E,CAEA,eAAenB,GACdnB,EACAc,EACAa,EACgB,CAChB,GAAI,CACH,MAAM3B,EAAQ,MAAMc,CAAK,CAC1B,OAASU,EAAO,CACfG,IAAUK,EAAQR,CAAK,CAAC,CACzB,CACD,CAEA,eAAeH,GACdrB,EACA2B,EACgB,CAChB,GAAI,CACH,MAAM3B,EAAQ,MAAM,CACrB,OAASwB,EAAO,CACfG,IAAUK,EAAQR,CAAK,CAAC,CACzB,CACD,CAEA,SAASQ,EAAQR,EAAuB,CACvC,OAAIA,aAAiB,MACbA,EAED,IAAI,MAAM,OAAOA,CAAK,CAAC,CAC/B,CAEA,IAAMe,EAAoB,wBAO1B,SAAShB,GAAmBN,EAAiBF,EAAsB,CAClE,IAAMyB,EAAcJ,GAAYrB,CAAK,EACrC,GAAI,CAACyB,EAAa,OAElB,IAAMC,EAAeD,EAAYD,CAAiB,EAGlD,GAFI,CAACE,GAED,CAACb,EAASX,CAAM,EAAG,OAElBW,EAASX,EAAO,KAAK,IACxBA,EAAyB,MAAQ,CAAC,GAGpC,IAAMyB,EAAczB,EAAyB,MAGxCyB,EAAWH,CAAiB,IAChCG,EAAWH,CAAiB,EAAIE,EAElC","names":["detectPlatform","isOpenAI","isMCPApps","START","END","INTERRUPT","WIDGET","interrupt","fields","config","context","questions","key","value","q","showWidget","tool","isInterrupt","isWidget","z","deflateSync","inflateSync","encodeFlowToken","data","json","decodeFlowToken","token","compressed","describeZodField","schema","desc","def","vals","v","buildFlowProtocol","config","lines","fieldList","key","info","getInputMeta","args","decoded","decodeFlowToken","resolveNextNode","edge","state","isFilled","buildInterruptResult","questions","context","currentNode","q","unanswered","isSingle","q0","executeFrom","startNodeName","startState","nodes","edges","validators","meta","MAX_ITERATIONS","iterations","END","handler","result","interrupt","showWidget","isInterrupt","interruptResult","isWidget","widgetField","error","inputSchema","z","compileFlow","input","protocol","fullDescription","handleToolCall","inputMeta","startEdge","START","firstNode","step","updatedState","fieldValidators","field","fn","value","vResult","err","msg","questionsWithError","nextNode","server","extra","_meta","flowToken","encodeFlowToken","contentResponse","StateGraph","config","name","handler","START","END","from","to","condition","compileFlow","startEdge","edge","createFlow","config","StateGraph","MIME_TYPE_OPENAI","MIME_TYPE_MCP","fetchHtml","baseUrl","path","normalizedBase","buildOpenAIResourceMeta","config","buildMcpAppsResourceMeta","csp","buildToolMeta","createResource","config","id","title","description","baseUrl","htmlPath","widgetDomain","prefersBorder","autoHeight","widgetCSP","hostname","openaiUri","mcpUri","htmlPromise","getHtml","fetchHtml","uiDescription","register","server","html","MIME_TYPE_OPENAI","uri","buildOpenAIResourceMeta","MIME_TYPE_MCP","buildMcpAppsResourceMeta","createTool","config","handler","resource","description","inputSchema","annotations","autoInjectResultText","id","title","toolMeta","buildToolMeta","server","args","extra","_meta","result","registerTools","tools","t","WaniWaniError","message","status","SDK_NAME","createKbClient","config","baseUrl","apiKey","requireApiKey","request","method","path","body","key","url","headers","init","response","text","WaniWaniError","files","query","options","DEFAULT_SOURCE","mapTrackEventToV2","input","options","now","generateId","createEventId","eventName","resolveEventName","meta","toRecord","metadata","correlation","resolveCorrelationIds","eventId","takeNonEmptyString","timestamp","normalizeTimestamp","source","rawLegacy","isLegacyTrackEvent","mappedMetadata","mapProperties","legacyProperties","mapLegacyProperties","explicitProperties","properties","requestId","pickFirstString","sessionId","traceId","externalUserId","correlationId","date","record","keys","key","value","DEFAULT_ENDPOINT_PATH","SDK_NAME","AUTH_FAILURE_STATUS","RETRYABLE_STATUS","createV2BatchTransport","options","BatchingV2Transport","joinUrl","DEFAULT_ENDPOINT_PATH","delayMs","resolve","event","dropCount","timeoutMs","flushPromise","timeoutSignal","batch","attempt","pendingBatch","result","events","response","error","getErrorMessage","data","parseJsonResponse","partial","rejected","byId","retryable","permanent","rejectedEvent","isRetryableRejectedEvent","rawDelay","status","rejectedCount","buffered","code","body","baseUrl","endpointPath","normalizedBase","normalizedPath","createTrackingClient","config","baseUrl","apiKey","tracking","requireApiKey","transport","createV2BatchTransport","client","userId","properties","mappedEvent","mapTrackEventToV2","event","options","attachShutdownHooks","defaultTimeoutMs","shutdown","waniwani","config","baseUrl","apiKey","trackingConfig","internalConfig","trackingClient","createTrackingClient","kbClient","createKbClient","mapWidgetEvent","ev","eventType","eventName","properties","createTrackingRoute","options","config","client","getClient","waniwani","request","body","c","results","trackInput","result","error","message","WidgetTokenCache","config","sessionId","traceId","url","joinUrl","body","response","json","result","expiresAtMs","baseUrl","path","DEFAULT_BASE_URL","withWaniwani","server","options","wrappedServer","tracker","waniwani","injectToken","tokenCache","getTokenCache","apiKey","WidgetTokenCache","originalRegisterTool","args","toolNameRaw","config","handlerRaw","toolName","handler","input","extra","startTime","result","durationMs","safeTrack","buildTrackInput","safeFlush","injectWidgetConfig","injectUserLocation","error","cache","baseUrl","onError","isRecord","meta","waniwaniConfig","token","toError","timing","toolType","resolveToolType","extractMeta","toolTypeOption","value","USER_LOCATION_KEY","requestMeta","userLocation","resultMeta"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waniwani/sdk",
-  "version": "0.3.0",
+  "version": "0.3.1-beta.1",
   "description": "WaniWani SDK - MCP event tracking, widget framework, and tools",
   "type": "module",
   "exports": {