@waniwani/sdk 0.11.10 → 0.11.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/mcp/index.d.ts +47 -5
- package/dist/mcp/index.js +5 -5
- package/dist/mcp/index.js.map +1 -1
- package/package.json +1 -1
package/dist/mcp/index.d.ts
CHANGED
|
@@ -755,6 +755,22 @@ type NodeOptions = {
|
|
|
755
755
|
/** When true, this node is excluded from funnel analytics. */
|
|
756
756
|
hideFromFunnel?: boolean;
|
|
757
757
|
};
|
|
758
|
+
/**
|
|
759
|
+
* Config for the object form of `.addNode({ id, run, label?, hideFromFunnel? })`.
|
|
760
|
+
*
|
|
761
|
+
* Preferred over the positional form `.addNode(id, run, options?)` — metadata
|
|
762
|
+
* sits at the top where the eye lands, and the handler is a named field.
|
|
763
|
+
*/
|
|
764
|
+
type AddNodeConfig<TState, TName extends string = string> = {
|
|
765
|
+
/** Unique node id within the flow. */
|
|
766
|
+
id: TName;
|
|
767
|
+
/** Node handler — receives ctx, returns state updates or a signal. */
|
|
768
|
+
run: NodeHandler<TState>;
|
|
769
|
+
/** Human-readable label for funnel visualization and graphs. Defaults to `id`. */
|
|
770
|
+
label?: string;
|
|
771
|
+
/** When true, this node is excluded from funnel analytics. */
|
|
772
|
+
hideFromFunnel?: boolean;
|
|
773
|
+
};
|
|
758
774
|
type FlowGraphNode = {
|
|
759
775
|
id: string;
|
|
760
776
|
type: "widget" | "interrupt" | "action";
|
|
@@ -918,8 +934,14 @@ type FlowErrorContent = {
|
|
|
918
934
|
* title: "User Onboarding",
|
|
919
935
|
* description: "Guides users through onboarding",
|
|
920
936
|
* })
|
|
921
|
-
* .addNode(
|
|
922
|
-
*
|
|
937
|
+
* .addNode({
|
|
938
|
+
* id: "ask_name",
|
|
939
|
+
* run: ({ interrupt }) => interrupt({ question: "What's your name?", field: "name" }),
|
|
940
|
+
* })
|
|
941
|
+
* .addNode({
|
|
942
|
+
* id: "greet",
|
|
943
|
+
* run: ({ state }) => ({ greeting: `Hello ${state.name}!` }),
|
|
944
|
+
* })
|
|
923
945
|
* .addEdge(START, "ask_name")
|
|
924
946
|
* .addEdge("ask_name", "greet")
|
|
925
947
|
* .addEdge("greet", END)
|
|
@@ -936,6 +958,20 @@ declare class StateGraph<TState extends Record<string, unknown>, TNodes extends
|
|
|
936
958
|
* Add a node with a handler.
|
|
937
959
|
*
|
|
938
960
|
* The handler receives a context object with `state`, `meta`, `interrupt`, and `showWidget`.
|
|
961
|
+
*
|
|
962
|
+
* @example
|
|
963
|
+
* ```ts
|
|
964
|
+
* .addNode({
|
|
965
|
+
* id: "ask_name",
|
|
966
|
+
* label: "Ask for name",
|
|
967
|
+
* run: ({ interrupt }) => interrupt({ question: "What's your name?", field: "name" }),
|
|
968
|
+
* })
|
|
969
|
+
* ```
|
|
970
|
+
*/
|
|
971
|
+
addNode<TName extends string>(config: AddNodeConfig<TState, TName>): StateGraph<TState, TNodes | TName>;
|
|
972
|
+
/**
|
|
973
|
+
* @deprecated Use the object form: `.addNode({ id, run, label? })`.
|
|
974
|
+
* The positional form will be removed in v0.13.0
|
|
939
975
|
*/
|
|
940
976
|
addNode<TName extends string>(name: TName, handler: NodeHandler<TState>, options?: NodeOptions): StateGraph<TState, TNodes | TName>;
|
|
941
977
|
/**
|
|
@@ -1002,8 +1038,14 @@ declare class StateGraph<TState extends Record<string, unknown>, TNodes extends
|
|
|
1002
1038
|
* email: z.string().describe("The user's email address"),
|
|
1003
1039
|
* },
|
|
1004
1040
|
* })
|
|
1005
|
-
* .addNode(
|
|
1006
|
-
*
|
|
1041
|
+
* .addNode({
|
|
1042
|
+
* id: "ask_name",
|
|
1043
|
+
* run: () => interrupt({ question: "What's your name?", field: "name" }),
|
|
1044
|
+
* })
|
|
1045
|
+
* .addNode({
|
|
1046
|
+
* id: "ask_email",
|
|
1047
|
+
* run: () => interrupt({ question: "What's your email?", field: "email" }),
|
|
1048
|
+
* })
|
|
1007
1049
|
* .addEdge(START, "ask_name")
|
|
1008
1050
|
* .addEdge("ask_name", "ask_email")
|
|
1009
1051
|
* .addEdge("ask_email", END)
|
|
@@ -1263,4 +1305,4 @@ type WithWaniwaniOptions = {
|
|
|
1263
1305
|
*/
|
|
1264
1306
|
declare function withWaniwani(server: McpServer, options?: WithWaniwaniOptions): Promise<McpServer>;
|
|
1265
1307
|
|
|
1266
|
-
export { type ConditionFn, END, type FlowConfig, type FlowTestResult, type HostContext, type InferFlowState, type InterruptSignal, type KvStore, type NodeContext, type NodeHandler, type RegisteredFlow, type RegisteredResource, type RegisteredTool, type ResourceConfig, START, type ScopedWaniWaniClient, StateGraph, type ToolCallResult, type ToolConfig, type ToolHandler, type ToolHandlerContext, type ToolResult, type ToolToolCallback, type TrackingRouteOptions, type TypedInterrupt, type TypedShowWidget, type UnifiedWidgetClient, WaniwaniKvStore, type WidgetCSP, type WidgetPlatform, type WidgetSignal, type WithWaniwaniOptions, createFlow, createFlowTestHarness, createResource, createTool, createTrackingRoute, detectPlatform, isMCPApps, isOpenAI, redacted, registerTools, withWaniwani };
|
|
1308
|
+
export { type AddNodeConfig, type ConditionFn, END, type FlowConfig, type FlowTestResult, type HostContext, type InferFlowState, type InterruptSignal, type KvStore, type NodeContext, type NodeHandler, type RegisteredFlow, type RegisteredResource, type RegisteredTool, type ResourceConfig, START, type ScopedWaniWaniClient, StateGraph, type ToolCallResult, type ToolConfig, type ToolHandler, type ToolHandlerContext, type ToolResult, type ToolToolCallback, type TrackingRouteOptions, type TypedInterrupt, type TypedShowWidget, type UnifiedWidgetClient, WaniwaniKvStore, type WidgetCSP, type WidgetPlatform, type WidgetSignal, type WithWaniwaniOptions, createFlow, createFlowTestHarness, createResource, createTool, createTrackingRoute, detectPlatform, isMCPApps, isOpenAI, redacted, registerTools, withWaniwani };
|
package/dist/mcp/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
function
|
|
1
|
+
function re(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function yt(){return re()==="openai"}function ht(){return re()==="mcp-apps"}var C="__start__",_="__end__",Te=Symbol.for("waniwani.flow.interrupt"),ke=Symbol.for("waniwani.flow.widget");function Se(e,t){let n=t?.context,o=[];for(let[r,i]of Object.entries(e))if(typeof i=="object"&&i!==null&&"question"in i){let s=i;o.push({question:s.question,field:r,suggestions:s.suggestions,context:s.context,validate:s.validate})}return{__type:Te,questions:o,context:n}}function ve(e,t){return{__type:ke,tool:typeof e=="string"?e:e.id,...t}}function Re(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===Te}function xe(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===ke}import{z as A}from"zod";var ie="waniwani/client";function H(e){if(typeof e=="object"&&e!==null)return e[ie]}function Ee(e,t,n){return{track(o){return e.track({...o,meta:{...t,...o.meta}})},identify(o,r){return e.identify(o,r,t)},kb:e.kb,_config:n}}function K(e,t){for(let n of t){let o=e[n];if(typeof o=="string"&&o.length>0)return o}}var Tt=["waniwani/sessionId","openai/sessionId","openai/session","sessionId","conversationId","mcp-session-id"],kt=["waniwani/requestId","openai/requestId","requestId","mcp/requestId"],St=["waniwani/traceId","openai/traceId","traceId","mcp/traceId","openai/requestId","requestId"],vt=["waniwani/userId","openai/userId","externalUserId","userId","actorId"],Rt=["correlationId","openai/requestId"],Ie="waniwani/flow";function F(e){return e?K(e,Tt):void 0}function be(e){return e?K(e,kt):void 0}function Ce(e){return e?K(e,St):void 0}function _e(e){return e?K(e,vt):void 0}function Fe(e){return e?K(e,Rt):void 0}var xt=[{key:"waniwani/sessionId",source:"chatbar"},{key:"openai/sessionId",source:"chatgpt"},{key:"openai/session",source:"chatgpt"}];function j(e){if(!e)return;let t=e["waniwani/source"];if(typeof t=="string"&&t.length>0)return t;for(let{key:n,source:o}of xt){let r=e[n];if(typeof r=="string"&&r.length>0)return o}}function Pe(e){let t=e._zod?.def;return t?.type==="object"&&t.shape?t.shape:null}function $(e,t){let n=t.split("."),o=e;for(let r of n){if(o==null||typeof o!="object")return;o=o[r]}return o}function Et(e,t,n){let o=t.split("."),r=o.pop();if(!r)return;let i=e;for(let s of o)(i[s]==null||typeof i[s]!="object"||Array.isArray(i[s]))&&(i[s]={}),i=i[s];i[r]=n}function Ne(e,t){let n=t.split("."),o=n.pop();if(!o)return;let r=e;for(let i of n){if(r==null||typeof r!="object")return;r=r[i]}r!=null&&typeof r=="object"&&delete r[o]}function V(e){let t={};for(let[n,o]of Object.entries(e))n.includes(".")?Et(t,n,o):o!==null&&typeof o=="object"&&!Array.isArray(o)?t=N(t,{[n]:o}):t[n]=o;return t}function N(e,t){let n={...e};for(let[o,r]of Object.entries(t))r!==null&&typeof r=="object"&&!Array.isArray(r)&&n[o]!==null&&typeof n[o]=="object"&&!Array.isArray(n[o])?n[o]=N(n[o],r):n[o]=r;return n}function se(e){return e!=null&&e!==""}async function M(e,t){return e.type==="direct"?e.to:e.condition(t)}function Ae(e,t,n,o){if(e.every(c=>se($(o,c.field))))return null;let r=e.filter(c=>!se($(o,c.field))),i=r.length===1,s=r[0];return{content:i&&s?{status:"interrupt",question:s.question,field:s.field,...s.suggestions?{suggestions:s.suggestions}:{},...s.context||t?{context:s.context??t}:{}}:{status:"interrupt",questions:r,...t?{context:t}:{}},flowTokenContent:{step:n,state:o,...i&&s?{field:s.field}:{}}}}async function L(e,t,n,o,r,i,s,a){let c=e,d={...t},u=[],p=50,l=0;for(;l++<p;){if(c===_)return{content:{status:"complete"},flowTokenContent:{state:d},nodesVisited:u};let R=n.get(c);if(!R)return{content:{status:"error",error:`Unknown node: "${c}"`},nodesVisited:u};a?.get(c)?.hideFromFunnel||u.push(c);try{let w=await R({state:d,meta:i,interrupt:Se,showWidget:ve,waniwani:s});if(Re(w)){for(let g of w.questions)g.validate&&r.set(`${c}:${g.field}`,g.validate);let v=Ae(w.questions,w.context,c,d);if(v)return{...v,nodesVisited:u};for(let g of w.questions){let E=r.get(`${c}:${g.field}`);if(E)try{let k=$(d,g.field),x=await E(k);x&&typeof x=="object"&&(d=N(d,x))}catch(k){let x=k instanceof Error?k.message:String(k);Ne(d,g.field);let b=w.questions.map(W=>W.field===g.field?{...W,context:W.context?`ERROR: ${x}
|
|
2
2
|
|
|
3
|
-
${
|
|
4
|
-
`)}function ce(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function $e(e){let t=Le(e),n=ce(t.waniwani)?t.waniwani:{};return e.meta({...t,waniwani:{...n,redacted:!0}})}function At(e){let n=Le(e).waniwani;return ce(n)&&n.redacted===!0}function Le(e){let t=e.meta;if(typeof t!="function")return{};let n=t.call(e);return ce(n)?n:{}}function qe(e){if(!e)return[];let t=[];for(let[n,
|
|
5
|
-
${s}`,c=e.store??new q,d=new Map;async function u(f,w,h,v){if(f.action==="start"){let T=typeof f.intent=="string"?f.intent.trim():void 0;if(!T)return{content:{status:"error",error:`Missing required "intent" for action "start". Include a brief summary of the user's goal for this flow and any relevant prior context that led to triggering it, if available.`}};if(f.intent=T,typeof f.context=="string"){let x=f.context.trim();f.context=x||void 0}let g=
|
|
6
|
-
`)}var O=class{nodes=new Map;edges=new Map;nodeOptions=new Map;config;constructor(t){this.config=t}addNode(t,n,r){if(t===C||t===_)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),r&&this.nodeOptions.set(t,r),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}graph(){return He(this.nodes,this.edges)}compile(t){this.validate();let n=new Map(this.nodes),r=new Map(this.edges);return Be({config:this.config,nodes:n,edges:r,store:t?.store,graph:()=>He(n,r),nodeOptions:new Map(this.nodeOptions)})}validate(){if(!this.edges.has(C))throw new Error('Flow must have an entry point. Add an edge from START: .addEdge(START, "first_node")');let t=this.edges.get(C);if(t?.type==="direct"&&t.to!==_&&!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!==C&&!this.nodes.has(n))throw new Error(`Edge from non-existent node: "${n}"`);if(r.type==="direct"&&r.to!==_&&!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 Ve(e){return new O(e)}function de(e){let t=e.content;return JSON.parse(t[0]?.text??"")}async function ze(e,t){let n=t?.stateStore,r=[],o=`test-session-${Math.random().toString(36).slice(2,10)}`,i={registerTool:(...d)=>{r.push(d)}};await e.register(i);let s=r[0]?.[2];if(!s)throw new Error(`Flow "${e.name}" did not register a handler`);let a={_meta:{sessionId:o}};async function c(d){return{...d,decodedState:n?await n.get(o):null}}return{async start(d,u,l){let p=await s({action:"start",intent:d,...l?{context:l}:{},...u?{stateUpdates:u}:{}},a);return c(de(p))},async continueWith(d){let u=await s({action:"continue",...d?{stateUpdates:d}:{}},a);return c(de(u))},async resetWith(d){let u=await s({action:"reset",stateUpdates:d},a);return c(de(u))},async lastState(){return n?n.get(o):null}}}var G="text/html+skybridge",Y="text/html;profile=mcp-app",Ge=async(e,t)=>{let n=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${n}${t}`)).text()};function Ye(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function Ze(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 ue(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}}},...e.mcpTemplateUri&&{"ui/resourceUri":e.mcpTemplateUri}}}function Je(e){let{id:t,title:n,description:r,baseUrl:o,htmlPath:i,widgetDomain:s,prefersBorder:a=!0,autoHeight:c=!0}=e,d=e.widgetCSP??{connect_domains:[o],resource_domains:[o]};if(process.env.NODE_ENV==="development")try{let{hostname:h}=new URL(o);(h==="localhost"||h==="127.0.0.1")&&(d={...d,connect_domains:[...d.connect_domains||[],`ws://${h}:*`,`wss://${h}:*`],resource_domains:[...d.resource_domains||[],`http://${h}:*`]})}catch{}let u=`ui://widgets/apps-sdk/${t}.html`,l=`ui://widgets/ext-apps/${t}.html`,p=null,R=()=>(p||(p=Ge(o,i)),p),f=r;async function w(h){let v=await R();h.registerResource(`${t}-openai-widget`,u,{title:n,description:f,mimeType:G,_meta:{"openai/widgetDescription":f,"openai/widgetPrefersBorder":a}},async T=>({contents:[{uri:T.href,mimeType:G,text:v,_meta:Ye({description:f,prefersBorder:a,widgetDomain:s,widgetCSP:d})}]})),h.registerResource(`${t}-mcp-widget`,l,{title:n,description:f,mimeType:Y,_meta:{ui:{prefersBorder:a}}},async T=>({contents:[{uri:T.href,mimeType:Y,text:v,_meta:Ze({description:f,prefersBorder:a,widgetDomain:s,widgetCSP:d})}]}))}return{id:t,title:n,description:r,openaiUri:u,mcpUri:l,autoHeight:c,register:w}}function Nt(e,t){let{resource:n,description:r,inputSchema:o,annotations:i,autoInjectResultText:s=!0}=e,a=e.id??n?.id,c=e.title??n?.title;if(!a)throw new Error("createTool: `id` is required when no resource is provided");if(!c)throw new Error("createTool: `title` is required when no resource is provided");let d=n?ue({openaiTemplateUri:n.openaiUri,mcpTemplateUri:n.mcpUri,invoking:e.invoking??"Loading...",invoked:e.invoked??"Loaded",autoHeight:n.autoHeight}):void 0;return{id:a,title:c,description:r,async register(u){u.registerTool(a,{title:c,description:r,inputSchema:o,annotations:i,...d&&{_meta:d}},(async(l,p)=>{let R=p,f=R._meta??{},w=H(R),h=await t(l,{extra:{_meta:f},waniwani:w});return n&&h.data?{content:[{type:"text",text:h.text}],structuredContent:h.data,_meta:{...d,...f,...s===!1?{"waniwani/autoInjectResultText":!1}:{}}}:{content:[{type:"text",text:h.text}],...h.data?{structuredContent:h.data}:{},...s===!1?{_meta:{"waniwani/autoInjectResultText":!1}}:{}}}))}}}async function Ut(e,t){await Promise.all(t.map(n=>n.register(e)))}var Z=class extends Error{constructor(n,r){super(n);this.status=r;this.name="WaniWaniError"}};var Dt="@waniwani/sdk";function Xe(e){let{apiUrl:t,apiKey:n}=e;function r(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}async function o(i,s,a){let c=r(),d=`${t.replace(/\/$/,"")}${s}`,u={Authorization:`Bearer ${c}`,"X-WaniWani-SDK":Dt},l={method:i,headers:u};a!==void 0&&(u["Content-Type"]="application/json",l.body=JSON.stringify(a));let p=await fetch(d,l);if(!p.ok){let f=await p.text().catch(()=>"");throw new Z(f||`KB API error: HTTP ${p.status}`,p.status)}return(await p.json()).data}return{async ingest(i){return o("POST","/api/mcp/kb/ingest",{files:i})},async search(i,s){return o("POST","/api/mcp/kb/search",{query:i,...s})},async sources(){return o("GET","/api/mcp/kb/sources")}}}var Ot="@waniwani/sdk";function X(e,t={}){let n=t.now??(()=>new Date),r=t.generateId??Qe,o=$t(e),i=J(e.meta),s=J(e.metadata),a=Lt(e,i),c=I(e.eventId)??r(),d=qt(e.timestamp,n),u=I(e.source)??j(i)??t.source??Ot,l=pe(e)?{...e}:void 0,p={...s};return Object.keys(i).length>0&&(p.meta=i),l&&(p.rawLegacy=l),{id:c,type:"mcp.event",name:o,source:u,timestamp:d,correlation:a,properties:Kt(e,o),metadata:p,rawLegacy:l}}function Qe(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?`evt_${crypto.randomUUID()}`:`evt_${Math.random().toString(36).slice(2,10)}_${Date.now().toString(36)}`}function Kt(e,t){if(!pe(e))return J(e.properties);let n=jt(e,t),r=J(e.properties);return{...n,...r}}function jt(e,t){switch(t){case"tool.called":{let n={};return I(e.toolName)&&(n.name=e.toolName),I(e.toolType)&&(n.type=e.toolType),n}case"quote.succeeded":{let n={};return typeof e.quoteAmount=="number"&&(n.amount=e.quoteAmount),I(e.quoteCurrency)&&(n.currency=e.quoteCurrency),n}case"link.clicked":{let n={};return I(e.linkUrl)&&(n.url=e.linkUrl),n}case"purchase.completed":{let n={};return typeof e.purchaseAmount=="number"&&(n.amount=e.purchaseAmount),I(e.purchaseCurrency)&&(n.currency=e.purchaseCurrency),n}default:return{}}}function $t(e){return pe(e)?e.eventType:e.event}function Lt(e,t){let n=I(e.requestId)??be(t),r=I(e.sessionId)??F(t),o=I(e.traceId)??Ce(t),i=I(e.externalUserId)??_e(t),s=I(e.correlationId)??Fe(t)??n,a={};return r&&(a.sessionId=r),o&&(a.traceId=o),n&&(a.requestId=n),s&&(a.correlationId=s),i&&(a.externalUserId=i),a}function qt(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 J(e){return!e||typeof e!="object"||Array.isArray(e)?{}:e}function I(e){if(typeof e=="string"&&e.trim().length!==0)return e}function pe(e){return"eventType"in e}var Bt="/api/mcp/events/v2/batch";var et="@waniwani/sdk",Ht=new Set([401,403]),Vt=new Set([408,425,429,500,502,503,504]);function tt(e){return new le(e)}var le=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=Yt(t.apiUrl,t.endpointPath??Bt),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":et},body:JSON.stringify(this.makeBatchRequest(t))})}catch(i){return{kind:"retryable",reason:Zt(i)}}if(Ht.has(n.status))return{kind:"auth",status:n.status};if(Vt.has(n.status))return{kind:"retryable",reason:`HTTP ${n.status}`};if(!n.ok)return{kind:"permanent",reason:`HTTP ${n.status}`};let r=await Gt(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:et,version:this.sdkVersion??"0.0.0"},events:t}}classifyRejectedEvents(t,n){let r=new Map(t.map(s=>[s.id,s])),o=[],i=[];for(let s of n){let a=r.get(s.eventId);if(a){if(zt(s)){o.push(a);continue}i.push(a)}}return{retryable:o,permanent:i}}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 zt(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 Gt(e){let t=await e.text();if(t)try{return JSON.parse(t)}catch{return}}function Yt(e,t){let n=e.endsWith("/")?e:`${e}/`,r=t.startsWith("/")?t.slice(1):t;return`${n}${r}`}function Zt(e){return e instanceof Error?e.message:String(e)}function nt(e){let{apiUrl:t,apiKey:n,tracking:r}=e;function o(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}let i=n?tt({apiUrl: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,s={async identify(a,c,d){o();let u=X({event:"user.identified",externalUserId:a,properties:c,meta:d});return i?.enqueue(u),{eventId:u.id}},async track(a){o();let c=X(a);return i?.enqueue(c),{eventId:c.id}},async flush(){o(),await i?.flush()},async shutdown(a){return o(),await i?.shutdown({timeoutMs:a?.timeoutMs??r.shutdownTimeoutMs})??{timedOut:!1,pendingEvents:0}}};return i&&Jt(s,r.shutdownTimeoutMs),s}function Jt(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 Q(e){let t=e,n=t?.apiUrl??"https://app.waniwani.ai",r=t?.apiKey??process.env.WANIWANI_API_KEY,o={endpointPath:t?.tracking?.endpointPath??"/api/mcp/events/v2/batch",flushIntervalMs:t?.tracking?.flushIntervalMs??1e3,maxBatchSize:t?.tracking?.maxBatchSize??20,maxBufferSize:t?.tracking?.maxBufferSize??1e3,maxRetries:t?.tracking?.maxRetries??3,retryBaseDelayMs:t?.tracking?.retryBaseDelayMs??200,retryMaxDelayMs:t?.tracking?.retryMaxDelayMs??2e3,shutdownTimeoutMs:t?.tracking?.shutdownTimeoutMs??2e3},i={apiUrl:n,apiKey:r,tracking:o},s=nt(i),a=Xe(i);return{...s,kb:a,_config:i}}function Xt(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 Qt(e){let t={apiKey:e?.apiKey,apiUrl:e?.apiUrl},n;function r(){return n||(n=Q(t)),n}return async function(i){let s;try{s=await i.json()}catch{return new Response(JSON.stringify({error:"Invalid JSON"}),{status:400,headers:{"Content-Type":"application/json"}})}if(!Array.isArray(s.events)||s.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(),c=[];for(let d of s.events){let u=Xt(d),l=await a.track(u);c.push(l.eventId)}return await a.flush(),new Response(JSON.stringify({ok:!0,accepted:c.length}),{status:200,headers:{"Content-Type":"application/json"}})}catch(a){let c=a instanceof Error?a.message:"Unknown error";return new Response(JSON.stringify({error:c}),{status:500,headers:{"Content-Type":"application/json"}})}}}var fe=U("widget-token"),en=120*1e3,ee=class{cached=null;pending=null;config;constructor(t){this.config=t}async getToken(t,n){return this.cached&&Date.now()<this.cached.expiresAt-en?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=tn(this.config.apiUrl,"/api/mcp/widget-tokens");fe("minting token from",r);let o={};t&&(o.sessionId=t),n&&(o.traceId=n);try{let i=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(o),signal:AbortSignal.timeout(5e3)});if(fe("mint response:",i.status),!i.ok)return null;let s=await i.json(),a=s.data&&typeof s.data=="object"?s.data:s,c=new Date(a.expiresAt).getTime();return!a.token||Number.isNaN(c)?null:(this.cached={token:a.token,expiresAt:c},a.token)}catch(i){return fe("mint failed:",i),null}}};function tn(e,t){return`${e.endsWith("/")?e.slice(0,-1):e}${t}`}async function rt(e){if(typeof globalThis.crypto?.subtle?.digest=="function"){let n=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(e));return Array.from(new Uint8Array(n)).map(r=>r.toString(16).padStart(2,"0")).join("")}let t=0;for(let n=0;n<e.length;n++)t=(t<<5)-t+e.charCodeAt(n)|0;return`simple-${Math.abs(t).toString(36)}`}function nn(e){return rt(JSON.stringify({nodes:e.nodes,edges:e.edges}))}async function ot(e){if(e.length===0)return null;let t=[...e].sort((o,i)=>o.flowId.localeCompare(i.flowId)),n=await rt(JSON.stringify(t.map(o=>({flowId:o.flowId,nodes:o.nodes,edges:o.edges})))),r=await Promise.all(e.map(async o=>({flowId:o.flowId,title:o.title,configHash:await nn(o),nodes:o.nodes,edges:o.edges})));return{compositeHash:n,flows:r}}var it="waniwani/sessionId",te="waniwani/geoLocation",ne="waniwani/userLocation",rn="openai/userLocation",on=[rn,te,ne];function st(e,t){if(t.length===0)return e;let n;for(let r of on){let o=e[r];if(!S(o))continue;let i;for(let s of t)s in o&&(i||(i={...o}),delete i[s]);i&&(n||(n={...e}),n[r]=i)}return n??e}function S(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function B(e){if(!S(e))return;let t=e._meta;return S(t)?t:void 0}function ge(e){if(!S(e))return;let t=e.content;return Array.isArray(t)?t.find(r=>S(r)&&r.type==="text"&&typeof r.text=="string")?.text:void 0}function sn(e,t){return typeof t=="function"?t(e)??"other":t??"other"}function we(e,t,n,r,o,i){let s=sn(e,n.toolType),a=n.stripLocationFields,c=a&&a.length>0,d=B(t),u=d&&c?st(d,a):d,l=i?.input!==void 0&&n.redactInput?n.redactInput(i.input):i?.input,p=c&&S(i?.output)&&S(i.output._meta)?{...i.output,_meta:st(i.output._meta,a)}:i?.output;return{event:"tool.called",properties:{name:e,type:s,...r??{},...l!==void 0&&{input:l},...p!==void 0&&{output:p}},meta:u,source:j(u),metadata:{...n.metadata??{},...o&&{clientInfo:o},...n.funnelSync&&{funnelSync:n.funnelSync}}}}async function me(e,t,n){try{await e.track(t)}catch(r){n?.(he(r))}}async function ye(e,t){try{await e.flush()}catch(n){t?.(he(n))}}async function ct(e,t,n,r,o){if(!S(e))return;S(e._meta)||(e._meta={});let i=e._meta,s=S(i.waniwani)?i.waniwani:void 0,a={...s??{},endpoint:s?.endpoint??`${n.replace(/\/$/,"")}/api/mcp/events/v2/batch`};if(t)try{let l=await t.getToken();l&&(a.token=l)}catch(l){o?.(he(l))}let c=F(i);c&&(a.sessionId||(a.sessionId=c));let d=pt(i);d!==void 0&&(a.geoLocation||(a.geoLocation=d));let u=j(B(r));u&&!a.source&&(a.source=u),i.waniwani=a}var at=["openai/outputTemplate","openai/widgetAccessible","openai/resultCanProduceWidget","openai/toolInvocation/invoking","openai/toolInvocation/invoked","ui/resourceUri","ui"];function dt(e,t){if(!t||!S(e))return;let n=!1;for(let o of at)if(o in t){n=!0;break}if(!n)return;S(e._meta)||(e._meta={});let r=e._meta;for(let o of at)o in t&&(o in r||(r[o]=t[o]))}function ut(e,t){let n=B(t);if(!n||!S(e))return;S(e._meta)||(e._meta={});let r=e._meta,o=F(n);o&&!r[it]&&(r[it]=o);let i=pt(n);i&&(r[te]||(r[te]=i),r[ne]||(r[ne]=i))}function pt(e){if(!e)return;let t=e[te]??e[ne];if(S(t)||typeof t=="string")return t}function he(e){return e instanceof Error?e:new Error(String(e))}function lt(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function ft(e){if(typeof e.sessionId=="string"&&e.sessionId)return e.sessionId;if(lt(e.requestInfo)){let t=e.requestInfo.headers;if(lt(t)){let n={};for(let i of Object.keys(t))n[i.toLowerCase()]=t[i];let r=n["mcp-session-id"];if(typeof r=="string"&&r)return r;let o=n["x-waniwani-session-id"];if(typeof o=="string"&&o)return o}}}var wt=Symbol.for("waniwani.wrappedHandler"),re=U("mcp"),mt="https://app.waniwani.ai",an="REDACTED";function cn(e){if(!e)return;let t=e[z];if(!Array.isArray(t)||t.length===0)return;let n=new Set(t.filter(r=>typeof r=="string"));if(n.size!==0)return r=>{if(!S(r))return r;let o=r.stateUpdates;if(!S(o))return r;let i=!1,s={...o};for(let a of n)a in s&&(s[a]=an,i=!0);return i?{...r,stateUpdates:s}:r}}function gt(e,t,n,r){let{server:o,tracker:i,opts:s,tokenCache:a,injectToken:c}=n,d=s.applyFieldRedactions===!0?cn(r):void 0,u=async(l,p)=>{let R=d?{...s,redactInput:d,funnelSync:n.funnelSync}:{...s,funnelSync:n.funnelSync},f=B(p)??{};if(!F(f)&&S(p)){let g=ft(p);g&&(f["waniwani/sessionId"]=g,p._meta=f)}let h=Ee(i,f,{apiUrl:i._config.apiUrl,apiKey:i._config.apiKey});S(p)&&(p[ie]=h);let v=performance.now(),T=o.server?.getClientVersion?.();try{let g=await t(l,p),E=Math.round(performance.now()-v);re(`tool "${e}" handler returned in ${E}ms, running post-processing...`);let k=S(g)&&g.isError===!0;if(k){let x=ge(g);console.error(`[waniwani] Tool "${e}" returned error${x?`: ${x}`:""}`)}return await me(i,we(e,p,R,{durationMs:E,status:k?"error":"ok",...k&&{errorMessage:ge(g)??"Unknown tool error"}},T,{input:l,output:g}),s.onError),re(`tool "${e}" tracking done`),s.flushAfterToolCall&&await ye(i,s.onError),ut(g,p),dt(g,r),c&&(await ct(g,a,i._config.apiUrl??mt,p,s.onError),re(`tool "${e}" widget config injected`)),re(`tool "${e}" post-processing complete, returning result`),g}catch(g){let E=Math.round(performance.now()-v);throw await me(i,we(e,p,R,{durationMs:E,status:"error",errorMessage:g instanceof Error?g.message:String(g)},T,{input:l}),s.onError),s.flushAfterToolCall&&await ye(i,s.onError),g}};return u[wt]=!0,u}async function dn(e,t){let n=e;if(n.__waniwaniWrapped)return n;n.__waniwaniWrapped=!0;let r=t??{},o=r.client??Q(),i=r.injectWidgetToken!==!1,s=o._config.apiKey?new ee({apiUrl:o._config.apiUrl??mt,apiKey:o._config.apiKey}):null,a={server:e,tracker:o,opts:r,tokenCache:s,injectToken:i,funnelSync:null},c=e.registerTool.bind(e);n.registerTool=((...u)=>{let[l,p,R]=u;if(typeof R!="function")return c(...u);let f=typeof l=="string"&&l.trim().length>0?l:"unknown",w=S(p)&&S(p._meta)?p._meta:void 0,h=gt(f,R,a,w);return c(l,p,h)});let d=e._registeredTools;if(S(d))for(let[u,l]of Object.entries(d)){if(!S(l))continue;let p=l.handler;if(typeof p!="function"||p[wt])continue;let R=S(l._meta)?l._meta:void 0;l.handler=gt(u,p,a,R)}if(o._config.apiKey){let u=e._registeredTools,l=[];if(u&&typeof u=="object"){for(let p of Object.values(u))if(p&&typeof p=="object"){let R=p._meta,f=R&&typeof R=="object"?R._flowGraph:void 0;f?.nodes?.length&&l.push(f)}}l.length>0&&(a.funnelSync=await ot(l))}return n}export{_ as END,C as START,O as StateGraph,D as WaniwaniKvStore,Ve as createFlow,ze as createFlowTestHarness,Je as createResource,Nt as createTool,Qt as createTrackingRoute,oe as detectPlatform,ht as isMCPApps,yt as isOpenAI,$e as redacted,Ut as registerTools,dn as withWaniwani};
|
|
3
|
+
${W.context}`:`ERROR: ${x}`}:W),P=Ae(b,w.context,c,d);if(P)return{...P,nodesVisited:u};break}}let T=o.get(c);if(!T)return{content:{status:"error",error:`No outgoing edge from node "${c}"`},nodesVisited:u};c=await M(T,d);continue}if(xe(w)){let v=w.field;if(v&&se($(d,v))){let T=o.get(c);if(!T)return{content:{status:"error",error:`No outgoing edge from node "${c}"`},nodesVisited:u};c=await M(T,d);continue}return{content:{status:"widget",tool:w.tool,data:w.data,description:w.description,interactive:w.interactive!==!1},flowTokenContent:{step:c,state:d,field:v,widgetId:w.tool},nodesVisited:u}}d=N(d,w);let h=o.get(c);if(!h)return{content:{status:"error",error:`No outgoing edge from node "${c}"`},nodesVisited:u};c=await M(h,d)}catch(f){return{content:{status:"error",error:f instanceof Error?f.message:String(f)},flowTokenContent:{step:c,state:d},nodesVisited:u}}}return{content:{status:"error",error:"Flow exceeded maximum iterations (possible infinite loop)"},nodesVisited:u}}function ae(e){return typeof e=="object"&&e!==null&&e.__ww_enc===1&&typeof e.ct=="string"&&typeof e.iv=="string"}var We=new Map;async function Me(e){let t=We.get(e);if(t)return t;let n=Buffer.from(e,"base64");if(n.length!==32)throw new Error("[WaniWani KV] WANIWANI_ENCRYPTION_KEY must be a base64-encoded 32-byte (256-bit) key.");let o=await globalThis.crypto.subtle.importKey("raw",n,{name:"AES-GCM"},!1,["encrypt","decrypt"]);return We.set(e,o),o}async function Ue(e,t){let n=await Me(t),o=globalThis.crypto.getRandomValues(new Uint8Array(12)),r=new TextEncoder().encode(JSON.stringify(e)),i=await globalThis.crypto.subtle.encrypt({name:"AES-GCM",iv:o},n,r);return{__ww_enc:1,ct:Buffer.from(i).toString("base64"),iv:Buffer.from(o).toString("base64")}}async function De(e,t){let n=await Me(t),o=Buffer.from(e.ct,"base64"),r=Buffer.from(e.iv,"base64"),i;try{i=await globalThis.crypto.subtle.decrypt({name:"AES-GCM",iv:r},n,o)}catch{throw new Error("[WaniWani KV] Decryption failed. The encryption key may be incorrect or the data may be corrupted.")}return JSON.parse(new TextDecoder().decode(i))}var It={debug:0,warn:1,error:2,none:3};function bt(){let e=process.env.WANIWANI_LOG_LEVEL;return e&&e in It?e:process.env.WANIWANI_DEBUG?"debug":"none"}function U(e,t){return t??bt()==="debug"?(...o)=>console.log(`[waniwani:${e}]`,...o):()=>{}}var Ct="@waniwani/sdk",_t="https://app.waniwani.ai",Ft=U("kv"),D=class{get baseUrl(){return(process.env.WANIWANI_API_URL??_t).replace(/\/$/,"")}get apiKey(){return process.env.WANIWANI_API_KEY}get encryptionKey(){return process.env.WANIWANI_ENCRYPTION_KEY}async get(t){if(!this.apiKey)throw new Error("[WaniWani KV] No API key configured. Set WANIWANI_API_KEY env var.");let n=await this.request("/api/mcp/redis/get",{key:t});if(n==null)return null;if(ae(n)){if(!this.encryptionKey)throw new Error("[WaniWani KV] Encrypted data found but WANIWANI_ENCRYPTION_KEY is not set.");return De(n,this.encryptionKey)}return n}async set(t,n){if(!this.apiKey)throw new Error("[WaniWani KV] No API key configured. Set WANIWANI_API_KEY env var.");let o=this.encryptionKey;Ft(`set "${t}" \u2014 encryption ${o?"enabled":"disabled (no WANIWANI_ENCRYPTION_KEY)"}`);let r=o?await Ue(n,o):n;await this.request("/api/mcp/redis/set",{key:t,value:r})}async delete(t){if(this.apiKey)try{await this.request("/api/mcp/redis/delete",{key:t})}catch(n){console.error("[WaniWani KV] delete failed for key:",t,n)}}async request(t,n){let o=`${this.baseUrl}${t}`,r=await fetch(o,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json","X-WaniWani-SDK":Ct},body:JSON.stringify(n)});if(!r.ok){let s=await r.text().catch(()=>"");throw new Error(s||`KV store API error: HTTP ${r.status}`)}return(await r.json()).data}};var q=class{store=new D;get(t){return this.store.get(t)}set(t,n){return this.store.set(t,n)}delete(t){return this.store.delete(t)}};function Pt(e){let t=e.toString();return t.includes("showWidget")?"widget":t.includes("interrupt")?"interrupt":"action"}function Nt(e,t){let n=e.toString(),o=[];for(let r of t){let i=`"${r}"`,s=`'${r}'`,a=`\`${r}\``;(n.includes(i)||n.includes(s)||n.includes(a))&&o.push(r)}return o}function Oe(e,t,n,o){let r=new Set([...t.keys(),_]),i=[];for(let[a,c]of t){let d=o.get(a);i.push({id:a,type:Pt(c),label:d?.label??a,...d?.hideFromFunnel?{hideFromFunnel:!0}:{}})}let s=[];for(let[a,c]of n)if(c.type==="direct")s.push({from:a,to:c.to,type:"direct"});else{let d=Nt(c.condition,r);s.push({from:a,to:d,type:"conditional"})}return{flowId:e.id,title:e.title,nodes:i,edges:s}}function Ke(e){let t=e.description??"",n=e._zod?.def;if(n?.type==="enum"&&n.entries){let o=Object.keys(n.entries).map(r=>`"${r}"`).join(" | ");return t?`${o} \u2014 ${t}`:o}return t}function je(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 and include `intent`.'," `intent` must be a brief summary of the user's goal for this flow."," Do NOT invent missing intent."," Optionally include `context` \u2014 the situation or environment that led the user to start"," this flow (e.g. what page they are on, what they were doing, or what triggered the request)."," Only provide `context` when there is genuinely relevant situational information. Do NOT invent missing context."," 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.omitIntentPII&&t.push(" Do NOT include PII in `intent` or `context` \u2014 no names, emails, phones, addresses, IDs, ages, or birthdates.",' Summarize the goal abstractly (e.g. "user wants a quote", not "Jane Doe wants a quote").'),e.state){let n=[];for(let[o,r]of Object.entries(e.state)){let i=Pe(r);if(i){let s=r.description??"",a=Object.entries(i).map(([c,d])=>{let u=Ke(d);return u?`\`${o}.${c}\` (${u})`:`\`${o}.${c}\``}).join(", ");n.push(s?`\`${o}\` (${s}): ${a}`:`\`${o}\`: ${a}`)}else{let s=Ke(r);n.push(s?`\`${o}\` (${s})`:`\`${o}\``)}}t.push(` Known fields: ${n.join(", ")}.`)}return t.push(" For grouped fields (shown as `group.subfield`), use dot-notation keys in `stateUpdates`:",' e.g. `{ "driver.name": "John", "driver.license": "ABC123" }`.',"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"`,'," `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."," Check the `interactive` field in the response:"," \u2022 `interactive: true` \u2014 The widget requires user interaction. After calling the display tool,"," STOP and WAIT for the user to interact with the widget. Do NOT call this flow tool again"," until the user has responded. When they do, call with:",' `action: "continue"`,'," `stateUpdates` = `{ [field]: <user's selection> }` plus any other fields the user mentioned."," \u2022 `interactive: false` \u2014 The widget is display-only. Call the display tool, then immediately",' call THIS flow tool again with `action: "continue"`. Do NOT wait for user interaction.',' - `"complete"`: The flow is done. Present the result to the user.',' - `"error"`: Something went wrong. Show the `error` message.',"","3. Do NOT invent state values. Only use `stateUpdates` for information the user explicitly provided.","4. 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.","5. CORRECTION: If the user wants to CHANGE a previously-answered field",' (e.g. "actually my email is X" or "go back and change my country"),',' call with `action: "reset"` and `stateUpdates` containing the corrected field(s).'," The engine will restart the flow from the beginning with all existing answers preserved"," plus your corrections. Steps with filled answers will be auto-skipped."," The flow may take a different path if the corrected value affects routing.",' Do NOT use "reset" for the CURRENT question \u2014 use "continue" for that.',"6. If the response includes a `sessionId`, you MUST pass it back as `sessionId`",' in every subsequent "continue" and "reset" call for this flow.'),t.join(`
|
|
4
|
+
`)}function ce(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function $e(e){let t=Le(e),n=ce(t.waniwani)?t.waniwani:{};return e.meta({...t,waniwani:{...n,redacted:!0}})}function At(e){let n=Le(e).waniwani;return ce(n)&&n.redacted===!0}function Le(e){let t=e.meta;if(typeof t!="function")return{};let n=t.call(e);return ce(n)?n:{}}function qe(e){if(!e)return[];let t=[];for(let[n,o]of Object.entries(e))At(o)&&t.push(n);return t}var z="waniwani/redactedStateUpdateFields";function Wt(e){let t=e.omitIntentPII?" Do not include PII (names, emails, phones, addresses, IDs, ages, birthdates) \u2014 summarize abstractly.":"",o=e.state&&Object.keys(e.state).length>0?A.object(e.state).partial().passthrough():A.record(A.string(),A.unknown());return{action:A.enum(["start","continue","reset"]).describe('"start" to begin the flow, "continue" to resume after a pause (interrupt or widget), "reset" to restart from the beginning with a correction to a previously-collected field'),intent:A.string().optional().describe(`Required when action is "start". Provide a brief summary of the user's goal for this flow. Do not invent missing intent.${t}`),context:A.string().optional().describe(`Optional when action is "start". Describe the situation or environment that led the user to start this flow \u2014 e.g. what page they are on, what they were doing, or what triggered the request. Do not invent missing context.${t}`),stateUpdates:o.optional().describe(`State field values to set before processing the next node. Pass the user's answer (keyed by the field name from the response) and any other values the user mentioned. For nested state fields, use dot-paths like "driver.name".`),sessionId:A.string().optional().describe('Session identifier. If the response includes a `sessionId`, pass it back on every subsequent "continue" and "reset" call for this flow.')}}function Be(e){let{config:t,nodes:n,edges:o}=e,r=Wt(t),i=Oe(t,n,o,e.nodeOptions),s=je(t),a=`${t.description}
|
|
5
|
+
${s}`,c=e.store??new q,d=new Map;async function u(f,w,h,v){if(f.action==="start"){let T=typeof f.intent=="string"?f.intent.trim():void 0;if(!T)return{content:{status:"error",error:`Missing required "intent" for action "start". Include a brief summary of the user's goal for this flow and any relevant prior context that led to triggering it, if available.`}};if(f.intent=T,typeof f.context=="string"){let x=f.context.trim();f.context=x||void 0}let g=o.get(C);if(!g)return{content:{status:"error",error:"No start edge"}};let E=V(f.stateUpdates??{}),k=await M(g,E);return L(k,E,n,o,d,h,v,e.nodeOptions)}if(f.action==="continue"){if(!w)return{content:{status:"error",error:"No session ID available for continue action."}};let T;try{T=await c.get(w)}catch(x){let b=x instanceof Error?x.message:String(x);return{content:{status:"error",error:`Failed to load flow state (session "${w}"): ${b}`}}}if(!T)return{content:{status:"error",error:`Flow state not found for session "${w}". The flow may have expired.`}};let g=T.state,E=T.step;if(!E)return{content:{status:"error",error:'This flow has already completed. Use action "start" to begin a new flow.'}};let k=N(g,V(f.stateUpdates??{}));if(T.widgetId){let x=o.get(E);if(!x)return{content:{status:"error",error:`No edge from step "${E}"`}};let b=await M(x,k);return L(b,k,n,o,d,h,v,e.nodeOptions)}return L(E,k,n,o,d,h,v,e.nodeOptions)}if(f.action==="reset"){if(!w)return{content:{status:"error",error:"No session ID available for reset action."}};let T;try{T=await c.get(w)}catch(b){let P=b instanceof Error?b.message:String(b);return{content:{status:"error",error:`Failed to load flow state (session "${w}"): ${P}`}}}if(!T)return{content:{status:"error",error:`Flow state not found for session "${w}". The flow may have completed or expired. Use action "start" to begin a new flow.`}};if(!f.stateUpdates||Object.keys(f.stateUpdates).length===0)return{content:{status:"error",error:'Missing "stateUpdates" for action "reset". Include the corrected field(s).'}};let g=o.get(C);if(!g)return{content:{status:"error",error:"No start edge"}};let E=T.state,k=N(E,V(f.stateUpdates)),x=await M(g,k);return L(x,k,n,o,d,h,v,e.nodeOptions)}return{content:{status:"error",error:`Unknown action: "${f.action}"`}}}let p=qe(t.state),l={title:t.title,description:a,inputSchema:r,annotations:t.annotations,...p.length>0&&{_meta:{[z]:p}}},R=(async(f,w)=>{let h=w,v=h._meta??{},T=F(v),g=T??f.sessionId;!g&&f.action==="start"&&(g=crypto.randomUUID(),v["waniwani/sessionId"]=g);let E=H(h),k=await u(f,g,v,E);if(g)if(k.flowTokenContent&&k.content.status!=="complete")try{await c.set(g,k.flowTokenContent)}catch(P){let W=P instanceof Error?P.message:String(P);return{content:[{type:"text",text:JSON.stringify({status:"error",error:`Flow state failed to persist (session "${g}"): ${W}`},null,2)}],_meta:v,isError:!0}}else k.content.status==="complete"&&await c.delete(g);let x=!T&&g?{...k.content,sessionId:g}:k.content,b=[{type:"text",text:JSON.stringify(x,null,2)}];return k.nodesVisited?.length&&(v[Ie]={flowId:t.id,nodesVisited:k.nodesVisited}),{content:b,_meta:v,...k.content.status==="error"?{isError:!0}:{}}});return{name:t.id,config:l,handler:R,async register(f){let w={...l,_meta:{...l._meta,_flowGraph:i}};f.registerTool(t.id,w,R)},graph:e.graph,flowGraph:i}}function He(e,t){let n=["flowchart TD"];n.push(` ${C}((Start))`);for(let[o]of e)n.push(` ${o}[${o}]`);n.push(` ${_}((End))`);for(let[o,r]of t)r.type==="direct"?n.push(` ${o} --> ${r.to}`):n.push(` ${o} -.-> ${o}_branch([?])`);return n.join(`
|
|
6
|
+
`)}var O=class{nodes=new Map;edges=new Map;nodeOptions=new Map;config;constructor(t){this.config=t}addNode(t,n,o){let r=typeof t=="string"?t:t.id,i=typeof t=="string"?n:t.run,s=typeof t=="string"?o?.label:t.label,a=typeof t=="string"?o?.hideFromFunnel:t.hideFromFunnel;if(r===C||r===_)throw new Error(`"${r}" is a reserved name and cannot be used as a node name`);if(this.nodes.has(r))throw new Error(`Node "${r}" already exists`);return this.nodes.set(r,i),(s!==void 0||a!==void 0)&&this.nodeOptions.set(r,{label:s??r,hideFromFunnel:a}),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}graph(){return He(this.nodes,this.edges)}compile(t){this.validate();let n=new Map(this.nodes),o=new Map(this.edges);return Be({config:this.config,nodes:n,edges:o,store:t?.store,graph:()=>He(n,o),nodeOptions:new Map(this.nodeOptions)})}validate(){if(!this.edges.has(C))throw new Error('Flow must have an entry point. Add an edge from START: .addEdge(START, "first_node")');let t=this.edges.get(C);if(t?.type==="direct"&&t.to!==_&&!this.nodes.has(t.to))throw new Error(`START edge references non-existent node: "${t.to}"`);for(let[n,o]of this.edges){if(n!==C&&!this.nodes.has(n))throw new Error(`Edge from non-existent node: "${n}"`);if(o.type==="direct"&&o.to!==_&&!this.nodes.has(o.to))throw new Error(`Edge from "${n}" references non-existent node: "${o.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 Ve(e){return new O(e)}function de(e){let t=e.content;return JSON.parse(t[0]?.text??"")}async function ze(e,t){let n=t?.stateStore,o=[],r=`test-session-${Math.random().toString(36).slice(2,10)}`,i={registerTool:(...d)=>{o.push(d)}};await e.register(i);let s=o[0]?.[2];if(!s)throw new Error(`Flow "${e.name}" did not register a handler`);let a={_meta:{sessionId:r}};async function c(d){return{...d,decodedState:n?await n.get(r):null}}return{async start(d,u,p){let l=await s({action:"start",intent:d,...p?{context:p}:{},...u?{stateUpdates:u}:{}},a);return c(de(l))},async continueWith(d){let u=await s({action:"continue",...d?{stateUpdates:d}:{}},a);return c(de(u))},async resetWith(d){let u=await s({action:"reset",stateUpdates:d},a);return c(de(u))},async lastState(){return n?n.get(r):null}}}var G="text/html+skybridge",Y="text/html;profile=mcp-app",Ge=async(e,t)=>{let n=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${n}${t}`)).text()};function Ye(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function Ze(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 ue(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}}},...e.mcpTemplateUri&&{"ui/resourceUri":e.mcpTemplateUri}}}function Je(e){let{id:t,title:n,description:o,baseUrl:r,htmlPath:i,widgetDomain:s,prefersBorder:a=!0,autoHeight:c=!0}=e,d=e.widgetCSP??{connect_domains:[r],resource_domains:[r]};if(process.env.NODE_ENV==="development")try{let{hostname:h}=new URL(r);(h==="localhost"||h==="127.0.0.1")&&(d={...d,connect_domains:[...d.connect_domains||[],`ws://${h}:*`,`wss://${h}:*`],resource_domains:[...d.resource_domains||[],`http://${h}:*`]})}catch{}let u=`ui://widgets/apps-sdk/${t}.html`,p=`ui://widgets/ext-apps/${t}.html`,l=null,R=()=>(l||(l=Ge(r,i)),l),f=o;async function w(h){let v=await R();h.registerResource(`${t}-openai-widget`,u,{title:n,description:f,mimeType:G,_meta:{"openai/widgetDescription":f,"openai/widgetPrefersBorder":a}},async T=>({contents:[{uri:T.href,mimeType:G,text:v,_meta:Ye({description:f,prefersBorder:a,widgetDomain:s,widgetCSP:d})}]})),h.registerResource(`${t}-mcp-widget`,p,{title:n,description:f,mimeType:Y,_meta:{ui:{prefersBorder:a}}},async T=>({contents:[{uri:T.href,mimeType:Y,text:v,_meta:Ze({description:f,prefersBorder:a,widgetDomain:s,widgetCSP:d})}]}))}return{id:t,title:n,description:o,openaiUri:u,mcpUri:p,autoHeight:c,register:w}}function Mt(e,t){let{resource:n,description:o,inputSchema:r,annotations:i,autoInjectResultText:s=!0}=e,a=e.id??n?.id,c=e.title??n?.title;if(!a)throw new Error("createTool: `id` is required when no resource is provided");if(!c)throw new Error("createTool: `title` is required when no resource is provided");let d=n?ue({openaiTemplateUri:n.openaiUri,mcpTemplateUri:n.mcpUri,invoking:e.invoking??"Loading...",invoked:e.invoked??"Loaded",autoHeight:n.autoHeight}):void 0;return{id:a,title:c,description:o,async register(u){u.registerTool(a,{title:c,description:o,inputSchema:r,annotations:i,...d&&{_meta:d}},(async(p,l)=>{let R=l,f=R._meta??{},w=H(R),h=await t(p,{extra:{_meta:f},waniwani:w});return n&&h.data?{content:[{type:"text",text:h.text}],structuredContent:h.data,_meta:{...d,...f,...s===!1?{"waniwani/autoInjectResultText":!1}:{}}}:{content:[{type:"text",text:h.text}],...h.data?{structuredContent:h.data}:{},...s===!1?{_meta:{"waniwani/autoInjectResultText":!1}}:{}}}))}}}async function Ut(e,t){await Promise.all(t.map(n=>n.register(e)))}var Z=class extends Error{constructor(n,o){super(n);this.status=o;this.name="WaniWaniError"}};var Dt="@waniwani/sdk";function Xe(e){let{apiUrl:t,apiKey:n}=e;function o(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}async function r(i,s,a){let c=o(),d=`${t.replace(/\/$/,"")}${s}`,u={Authorization:`Bearer ${c}`,"X-WaniWani-SDK":Dt},p={method:i,headers:u};a!==void 0&&(u["Content-Type"]="application/json",p.body=JSON.stringify(a));let l=await fetch(d,p);if(!l.ok){let f=await l.text().catch(()=>"");throw new Z(f||`KB API error: HTTP ${l.status}`,l.status)}return(await l.json()).data}return{async ingest(i){return r("POST","/api/mcp/kb/ingest",{files:i})},async search(i,s){return r("POST","/api/mcp/kb/search",{query:i,...s})},async sources(){return r("GET","/api/mcp/kb/sources")}}}var Ot="@waniwani/sdk";function X(e,t={}){let n=t.now??(()=>new Date),o=t.generateId??Qe,r=$t(e),i=J(e.meta),s=J(e.metadata),a=Lt(e,i),c=I(e.eventId)??o(),d=qt(e.timestamp,n),u=I(e.source)??j(i)??t.source??Ot,p=le(e)?{...e}:void 0,l={...s};return Object.keys(i).length>0&&(l.meta=i),p&&(l.rawLegacy=p),{id:c,type:"mcp.event",name:r,source:u,timestamp:d,correlation:a,properties:Kt(e,r),metadata:l,rawLegacy:p}}function Qe(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?`evt_${crypto.randomUUID()}`:`evt_${Math.random().toString(36).slice(2,10)}_${Date.now().toString(36)}`}function Kt(e,t){if(!le(e))return J(e.properties);let n=jt(e,t),o=J(e.properties);return{...n,...o}}function jt(e,t){switch(t){case"tool.called":{let n={};return I(e.toolName)&&(n.name=e.toolName),I(e.toolType)&&(n.type=e.toolType),n}case"quote.succeeded":{let n={};return typeof e.quoteAmount=="number"&&(n.amount=e.quoteAmount),I(e.quoteCurrency)&&(n.currency=e.quoteCurrency),n}case"link.clicked":{let n={};return I(e.linkUrl)&&(n.url=e.linkUrl),n}case"purchase.completed":{let n={};return typeof e.purchaseAmount=="number"&&(n.amount=e.purchaseAmount),I(e.purchaseCurrency)&&(n.currency=e.purchaseCurrency),n}default:return{}}}function $t(e){return le(e)?e.eventType:e.event}function Lt(e,t){let n=I(e.requestId)??be(t),o=I(e.sessionId)??F(t),r=I(e.traceId)??Ce(t),i=I(e.externalUserId)??_e(t),s=I(e.correlationId)??Fe(t)??n,a={};return o&&(a.sessionId=o),r&&(a.traceId=r),n&&(a.requestId=n),s&&(a.correlationId=s),i&&(a.externalUserId=i),a}function qt(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 J(e){return!e||typeof e!="object"||Array.isArray(e)?{}:e}function I(e){if(typeof e=="string"&&e.trim().length!==0)return e}function le(e){return"eventType"in e}var Bt="/api/mcp/events/v2/batch";var et="@waniwani/sdk",Ht=new Set([401,403]),Vt=new Set([408,425,429,500,502,503,504]);function tt(e){return new pe(e)}var pe=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=Yt(t.apiUrl,t.endpointPath??Bt),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(o=>setTimeout(o,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,o=this.flush();if(!Number.isFinite(n)||n<=0)return await o,this.isStopped=!0,{timedOut:!1,pendingEvents:this.pendingEvents()};let r=Symbol("shutdown-timeout");return await Promise.race([o.then(()=>"flushed"),this.sleep(n).then(()=>r)])===r?(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,o=t;for(;o.length>0&&!this.isStopped;){this.inFlightCount=o.length;let r=await this.sendBatchOnce(o);switch(this.inFlightCount=0,r.kind){case"success":return;case"auth":this.stopTransportForAuthFailure(r.status,o.length);return;case"permanent":this.logger.error("[WaniWani] Dropping %d event(s) after permanent failure: %s",o.length,r.reason);return;case"retryable":if(n>=this.maxRetries){this.logger.error("[WaniWani] Dropping %d event(s) after retry exhaustion: %s",o.length,r.reason);return}await this.sleep(this.backoffDelayMs(n)),n+=1;continue;case"partial":if(r.permanent.length>0&&this.logger.error("[WaniWani] Dropping %d event(s) rejected as permanent",r.permanent.length),r.retryable.length===0)return;if(n>=this.maxRetries){this.logger.error("[WaniWani] Dropping %d retryable event(s) after retry exhaustion",r.retryable.length);return}o=r.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":et},body:JSON.stringify(this.makeBatchRequest(t))})}catch(i){return{kind:"retryable",reason:Zt(i)}}if(Ht.has(n.status))return{kind:"auth",status:n.status};if(Vt.has(n.status))return{kind:"retryable",reason:`HTTP ${n.status}`};if(!n.ok)return{kind:"permanent",reason:`HTTP ${n.status}`};let o=await Gt(n);if(!o?.rejected||o.rejected.length===0)return{kind:"success"};let r=this.classifyRejectedEvents(t,o.rejected);return r.retryable.length===0&&r.permanent.length===0?{kind:"success"}:{kind:"partial",retryable:r.retryable,permanent:r.permanent}}makeBatchRequest(t){return{sentAt:this.now().toISOString(),source:{sdk:et,version:this.sdkVersion??"0.0.0"},events:t}}classifyRejectedEvents(t,n){let o=new Map(t.map(s=>[s.id,s])),r=[],i=[];for(let s of n){let a=o.get(s.eventId);if(a){if(zt(s)){r.push(a);continue}i.push(a)}}return{retryable:r,permanent:i}}backoffDelayMs(t){let n=this.retryBaseDelayMs*2**t;return Math.min(n,this.retryMaxDelayMs)}stopTransportForAuthFailure(t,n){this.isStopped=!0;let o=this.buffer.length;this.buffer.splice(0,o),this.logger.error("[WaniWani] Auth failure (HTTP %d). Stopping tracking transport and dropping %d queued event(s)",t,n+o)}};function zt(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 Gt(e){let t=await e.text();if(t)try{return JSON.parse(t)}catch{return}}function Yt(e,t){let n=e.endsWith("/")?e:`${e}/`,o=t.startsWith("/")?t.slice(1):t;return`${n}${o}`}function Zt(e){return e instanceof Error?e.message:String(e)}function nt(e){let{apiUrl:t,apiKey:n,tracking:o}=e;function r(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}let i=n?tt({apiUrl:t,apiKey:n,endpointPath:o.endpointPath,flushIntervalMs:o.flushIntervalMs,maxBatchSize:o.maxBatchSize,maxBufferSize:o.maxBufferSize,maxRetries:o.maxRetries,retryBaseDelayMs:o.retryBaseDelayMs,retryMaxDelayMs:o.retryMaxDelayMs,shutdownTimeoutMs:o.shutdownTimeoutMs}):void 0,s={async identify(a,c,d){r();let u=X({event:"user.identified",externalUserId:a,properties:c,meta:d});return i?.enqueue(u),{eventId:u.id}},async track(a){r();let c=X(a);return i?.enqueue(c),{eventId:c.id}},async flush(){r(),await i?.flush()},async shutdown(a){return r(),await i?.shutdown({timeoutMs:a?.timeoutMs??o.shutdownTimeoutMs})??{timedOut:!1,pendingEvents:0}}};return i&&Jt(s,o.shutdownTimeoutMs),s}function Jt(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 Q(e){let t=e,n=t?.apiUrl??"https://app.waniwani.ai",o=t?.apiKey??process.env.WANIWANI_API_KEY,r={endpointPath:t?.tracking?.endpointPath??"/api/mcp/events/v2/batch",flushIntervalMs:t?.tracking?.flushIntervalMs??1e3,maxBatchSize:t?.tracking?.maxBatchSize??20,maxBufferSize:t?.tracking?.maxBufferSize??1e3,maxRetries:t?.tracking?.maxRetries??3,retryBaseDelayMs:t?.tracking?.retryBaseDelayMs??200,retryMaxDelayMs:t?.tracking?.retryMaxDelayMs??2e3,shutdownTimeoutMs:t?.tracking?.shutdownTimeoutMs??2e3},i={apiUrl:n,apiKey:o,tracking:r},s=nt(i),a=Xe(i);return{...s,kb:a,_config:i}}function Xt(e){let t=e.event_type??"widget_click",o=t.startsWith("widget_")?t:`widget_${t}`,r={...e.metadata??{}};return e.event_name&&(r.event_name=e.event_name),{event:o,properties:r,sessionId:e.session_id,traceId:e.trace_id,externalUserId:e.user_id,eventId:e.event_id,timestamp:e.timestamp,source:e.source??"widget"}}function Qt(e){let t={apiKey:e?.apiKey,apiUrl:e?.apiUrl},n;function o(){return n||(n=Q(t)),n}return async function(i){let s;try{s=await i.json()}catch{return new Response(JSON.stringify({error:"Invalid JSON"}),{status:400,headers:{"Content-Type":"application/json"}})}if(!Array.isArray(s.events)||s.events.length===0)return new Response(JSON.stringify({error:"Missing or empty events array"}),{status:400,headers:{"Content-Type":"application/json"}});try{let a=o(),c=[];for(let d of s.events){let u=Xt(d),p=await a.track(u);c.push(p.eventId)}return await a.flush(),new Response(JSON.stringify({ok:!0,accepted:c.length}),{status:200,headers:{"Content-Type":"application/json"}})}catch(a){let c=a instanceof Error?a.message:"Unknown error";return new Response(JSON.stringify({error:c}),{status:500,headers:{"Content-Type":"application/json"}})}}}var fe=U("widget-token"),en=120*1e3,ee=class{cached=null;pending=null;config;constructor(t){this.config=t}async getToken(t,n){return this.cached&&Date.now()<this.cached.expiresAt-en?this.cached.token:this.pending?this.pending:(this.pending=this.mint(t,n).finally(()=>{this.pending=null}),this.pending)}async mint(t,n){let o=tn(this.config.apiUrl,"/api/mcp/widget-tokens");fe("minting token from",o);let r={};t&&(r.sessionId=t),n&&(r.traceId=n);try{let i=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(r),signal:AbortSignal.timeout(5e3)});if(fe("mint response:",i.status),!i.ok)return null;let s=await i.json(),a=s.data&&typeof s.data=="object"?s.data:s,c=new Date(a.expiresAt).getTime();return!a.token||Number.isNaN(c)?null:(this.cached={token:a.token,expiresAt:c},a.token)}catch(i){return fe("mint failed:",i),null}}};function tn(e,t){return`${e.endsWith("/")?e.slice(0,-1):e}${t}`}async function ot(e){if(typeof globalThis.crypto?.subtle?.digest=="function"){let n=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(e));return Array.from(new Uint8Array(n)).map(o=>o.toString(16).padStart(2,"0")).join("")}let t=0;for(let n=0;n<e.length;n++)t=(t<<5)-t+e.charCodeAt(n)|0;return`simple-${Math.abs(t).toString(36)}`}function nn(e){return ot(JSON.stringify({nodes:e.nodes,edges:e.edges}))}async function rt(e){if(e.length===0)return null;let t=[...e].sort((r,i)=>r.flowId.localeCompare(i.flowId)),n=await ot(JSON.stringify(t.map(r=>({flowId:r.flowId,nodes:r.nodes,edges:r.edges})))),o=await Promise.all(e.map(async r=>({flowId:r.flowId,title:r.title,configHash:await nn(r),nodes:r.nodes,edges:r.edges})));return{compositeHash:n,flows:o}}var it="waniwani/sessionId",te="waniwani/geoLocation",ne="waniwani/userLocation",on="openai/userLocation",rn=[on,te,ne];function st(e,t){if(t.length===0)return e;let n;for(let o of rn){let r=e[o];if(!S(r))continue;let i;for(let s of t)s in r&&(i||(i={...r}),delete i[s]);i&&(n||(n={...e}),n[o]=i)}return n??e}function S(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function B(e){if(!S(e))return;let t=e._meta;return S(t)?t:void 0}function ge(e){if(!S(e))return;let t=e.content;return Array.isArray(t)?t.find(o=>S(o)&&o.type==="text"&&typeof o.text=="string")?.text:void 0}function sn(e,t){return typeof t=="function"?t(e)??"other":t??"other"}function we(e,t,n,o,r,i){let s=sn(e,n.toolType),a=n.stripLocationFields,c=a&&a.length>0,d=B(t),u=d&&c?st(d,a):d,p=i?.input!==void 0&&n.redactInput?n.redactInput(i.input):i?.input,l=c&&S(i?.output)&&S(i.output._meta)?{...i.output,_meta:st(i.output._meta,a)}:i?.output;return{event:"tool.called",properties:{name:e,type:s,...o??{},...p!==void 0&&{input:p},...l!==void 0&&{output:l}},meta:u,source:j(u),metadata:{...n.metadata??{},...r&&{clientInfo:r},...n.funnelSync&&{funnelSync:n.funnelSync}}}}async function me(e,t,n){try{await e.track(t)}catch(o){n?.(he(o))}}async function ye(e,t){try{await e.flush()}catch(n){t?.(he(n))}}async function ct(e,t,n,o,r){if(!S(e))return;S(e._meta)||(e._meta={});let i=e._meta,s=S(i.waniwani)?i.waniwani:void 0,a={...s??{},endpoint:s?.endpoint??`${n.replace(/\/$/,"")}/api/mcp/events/v2/batch`};if(t)try{let p=await t.getToken();p&&(a.token=p)}catch(p){r?.(he(p))}let c=F(i);c&&(a.sessionId||(a.sessionId=c));let d=lt(i);d!==void 0&&(a.geoLocation||(a.geoLocation=d));let u=j(B(o));u&&!a.source&&(a.source=u),i.waniwani=a}var at=["openai/outputTemplate","openai/widgetAccessible","openai/resultCanProduceWidget","openai/toolInvocation/invoking","openai/toolInvocation/invoked","ui/resourceUri","ui"];function dt(e,t){if(!t||!S(e))return;let n=!1;for(let r of at)if(r in t){n=!0;break}if(!n)return;S(e._meta)||(e._meta={});let o=e._meta;for(let r of at)r in t&&(r in o||(o[r]=t[r]))}function ut(e,t){let n=B(t);if(!n||!S(e))return;S(e._meta)||(e._meta={});let o=e._meta,r=F(n);r&&!o[it]&&(o[it]=r);let i=lt(n);i&&(o[te]||(o[te]=i),o[ne]||(o[ne]=i))}function lt(e){if(!e)return;let t=e[te]??e[ne];if(S(t)||typeof t=="string")return t}function he(e){return e instanceof Error?e:new Error(String(e))}function pt(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function ft(e){if(typeof e.sessionId=="string"&&e.sessionId)return e.sessionId;if(pt(e.requestInfo)){let t=e.requestInfo.headers;if(pt(t)){let n={};for(let i of Object.keys(t))n[i.toLowerCase()]=t[i];let o=n["mcp-session-id"];if(typeof o=="string"&&o)return o;let r=n["x-waniwani-session-id"];if(typeof r=="string"&&r)return r}}}var wt=Symbol.for("waniwani.wrappedHandler"),oe=U("mcp"),mt="https://app.waniwani.ai",an="REDACTED";function cn(e){if(!e)return;let t=e[z];if(!Array.isArray(t)||t.length===0)return;let n=new Set(t.filter(o=>typeof o=="string"));if(n.size!==0)return o=>{if(!S(o))return o;let r=o.stateUpdates;if(!S(r))return o;let i=!1,s={...r};for(let a of n)a in s&&(s[a]=an,i=!0);return i?{...o,stateUpdates:s}:o}}function gt(e,t,n,o){let{server:r,tracker:i,opts:s,tokenCache:a,injectToken:c}=n,d=s.applyFieldRedactions===!0?cn(o):void 0,u=async(p,l)=>{let R=d?{...s,redactInput:d,funnelSync:n.funnelSync}:{...s,funnelSync:n.funnelSync},f=B(l)??{};if(!F(f)&&S(l)){let g=ft(l);g&&(f["waniwani/sessionId"]=g,l._meta=f)}let h=Ee(i,f,{apiUrl:i._config.apiUrl,apiKey:i._config.apiKey});S(l)&&(l[ie]=h);let v=performance.now(),T=r.server?.getClientVersion?.();try{let g=await t(p,l),E=Math.round(performance.now()-v);oe(`tool "${e}" handler returned in ${E}ms, running post-processing...`);let k=S(g)&&g.isError===!0;if(k){let x=ge(g);console.error(`[waniwani] Tool "${e}" returned error${x?`: ${x}`:""}`)}return await me(i,we(e,l,R,{durationMs:E,status:k?"error":"ok",...k&&{errorMessage:ge(g)??"Unknown tool error"}},T,{input:p,output:g}),s.onError),oe(`tool "${e}" tracking done`),s.flushAfterToolCall&&await ye(i,s.onError),ut(g,l),dt(g,o),c&&(await ct(g,a,i._config.apiUrl??mt,l,s.onError),oe(`tool "${e}" widget config injected`)),oe(`tool "${e}" post-processing complete, returning result`),g}catch(g){let E=Math.round(performance.now()-v);throw await me(i,we(e,l,R,{durationMs:E,status:"error",errorMessage:g instanceof Error?g.message:String(g)},T,{input:p}),s.onError),s.flushAfterToolCall&&await ye(i,s.onError),g}};return u[wt]=!0,u}async function dn(e,t){let n=e;if(n.__waniwaniWrapped)return n;n.__waniwaniWrapped=!0;let o=t??{},r=o.client??Q(),i=o.injectWidgetToken!==!1,s=r._config.apiKey?new ee({apiUrl:r._config.apiUrl??mt,apiKey:r._config.apiKey}):null,a={server:e,tracker:r,opts:o,tokenCache:s,injectToken:i,funnelSync:null},c=e.registerTool.bind(e);n.registerTool=((...u)=>{let[p,l,R]=u;if(typeof R!="function")return c(...u);let f=typeof p=="string"&&p.trim().length>0?p:"unknown",w=S(l)&&S(l._meta)?l._meta:void 0,h=gt(f,R,a,w);return c(p,l,h)});let d=e._registeredTools;if(S(d))for(let[u,p]of Object.entries(d)){if(!S(p))continue;let l=p.handler;if(typeof l!="function"||l[wt])continue;let R=S(p._meta)?p._meta:void 0;p.handler=gt(u,l,a,R)}if(r._config.apiKey){let u=e._registeredTools,p=[];if(u&&typeof u=="object"){for(let l of Object.values(u))if(l&&typeof l=="object"){let R=l._meta,f=R&&typeof R=="object"?R._flowGraph:void 0;f?.nodes?.length&&p.push(f)}}p.length>0&&(a.funnelSync=await rt(p))}return n}export{_ as END,C as START,O as StateGraph,D as WaniwaniKvStore,Ve as createFlow,ze as createFlowTestHarness,Je as createResource,Mt as createTool,Qt as createTrackingRoute,re as detectPlatform,ht as isMCPApps,yt as isOpenAI,$e as redacted,Ut as registerTools,dn as withWaniwani};
|
|
7
7
|
//# sourceMappingURL=index.js.map
|