@waniwani/sdk 0.0.12 → 0.0.13

package/dist/mcp/index.d.ts

@@ -1,112 +1,9 @@
-import { z } from 'zod';
 import { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
 import { ZodRawShapeCompat, ShapeOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js';
 export { ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
 
-/**
- * Context passed to widget handlers
- */
-type WidgetHandlerContext = {
-    /** Raw MCP request extra data (includes _meta for session extraction) */
-    extra?: {
-        _meta?: Record<string, unknown>;
-    };
-};
-type WidgetCSP = {
-    /** Domains permitted for fetch/XHR network requests */
-    connect_domains?: string[];
-    /** Domains for static assets (images, fonts, scripts, styles) */
-    resource_domains?: string[];
-    /** Origins allowed for iframe embeds (triggers stricter app review) */
-    frame_domains?: string[];
-    /** Origins that can receive openExternal redirects without safe-link modal */
-    redirect_domains?: string[];
-};
-type WidgetConfig<TInput extends ZodRawShapeCompat> = {
-    /** Unique identifier for the widget/tool */
-    id: string;
-    /** Display title */
-    title: string;
-    /** Action-oriented description for the tool (tells the model WHEN to use it) */
-    description: string;
-    /** UI component description (describes WHAT the widget displays). Falls back to description if not provided. */
-    widgetDescription?: string;
-    /** Base URL for fetching widget HTML */
-    baseUrl: string;
-    /** Path to fetch HTML from (relative to baseUrl) */
-    htmlPath: string;
-    /** Input schema using zod */
-    inputSchema: TInput;
-    /** Optional loading message (defaults to "Loading...") */
-    invoking?: string;
-    /** Optional loaded message (defaults to "Loaded") */
-    invoked?: string;
-    /** Optional widget domain for security context */
-    widgetDomain?: string;
-    /** Optional: whether widget prefers border (defaults to true) */
-    prefersBorder?: boolean;
-    /** Optional: when true, the iframe height auto-adapts to its content instead of using a fixed height */
-    autoHeight?: boolean;
-    /** Content Security Policy configuration (required for app submission) */
-    widgetCSP?: WidgetCSP;
-    /** Optional: Annotations describe the tool’s potential impact. ChatGPT uses these hints to classify tools and decide when to ask the user for confirmation (elicitation) before using the tool.
-     *
-     * Note: openWorldHint and destructiveHint are only considered for writes (i.e. when readOnlyHint=false).
-     */
-    annotations?: {
-        /** Optional: Set to true for tools that do not change state (search, lookups, previews). This won't require elicitation. */
-        readOnlyHint?: boolean;
-        /** Optional: Set to true for tools where calling multiple times with the same args has no additional effect. */
-        idempotentHint?: boolean;
-        /** Optional: Set to false for tools that only affect a bounded target (for example, "update a task by id" in your own product). Leave true for tools that can write to arbitrary URLs/files/resources. */
-        openWorldHint?: boolean;
-        /** Optional:  Set to true for tools that can delete, overwrite, or have irreversible side effects. */
-        destructiveHint?: boolean;
-    };
-};
-type WidgetHandler<TInput extends ZodRawShapeCompat> = (input: ShapeOutput<TInput>, context: WidgetHandlerContext) => Promise<{
-    /** Text content to return */
-    text: string;
-    /** Structured data to pass to the widget */
-    data: Record<string, unknown>;
-}>;
-type WidgetToolCallback<TInput extends ZodRawShapeCompat> = ToolCallback<TInput>;
-type RegisteredWidget = {
-    id: string;
-    title: string;
-    description: string;
-    register: (server: McpServer) => Promise<void>;
-};
-
-/**
- * Creates a widget with minimal boilerplate.
- *
- * @example
- * ```ts
- * const weatherWidget = createWidget({
- *   id: "show_weather",
- *   title: "Show Weather",
- *   description: "Displays weather information for a city",
- *   baseUrl: "https://my-app.com",
- *   htmlPath: "/weather",
- *   inputSchema: {
- *     city: z.string().describe("The city name"),
- *   },
- * }, async ({ city }) => ({
- *   text: `Weather for ${city}`,
- *   data: { city, temperature: 72 },
- * }));
- * ```
- */
-declare function createWidget<TInput extends z.ZodRawShape>(config: WidgetConfig<TInput> & {
-    widgetDomain: string;
-}, handler: WidgetHandler<TInput>): RegisteredWidget;
-/**
- * Registers multiple widgets on the server
- */
-declare function registerWidgets(server: McpServer, widgets: RegisteredWidget[]): Promise<void>;
-
 /**
  * Widget platform types
  */
@@ -366,4 +263,269 @@ interface UnifiedWidgetClient {
     onWidgetStateChange(callback: (state: UnknownObject | null) => void): () => void;
 }
 
-export { type HostContext, type RegisteredWidget, type ToolCallResult, type ToolResult, type UnifiedWidgetClient, type WidgetCSP, type WidgetConfig, type WidgetHandler, type WidgetHandlerContext, type WidgetPlatform, type WidgetToolCallback, createWidget, detectPlatform, isMCPApps, isOpenAI, registerWidgets };
+/**
+ * Context passed to widget handlers
+ */
+type WidgetHandlerContext = {
+    /** Raw MCP request extra data (includes _meta for session extraction) */
+    extra?: {
+        _meta?: Record<string, unknown>;
+    };
+};
+type WidgetCSP = {
+    /** Domains permitted for fetch/XHR network requests */
+    connect_domains?: string[];
+    /** Domains for static assets (images, fonts, scripts, styles) */
+    resource_domains?: string[];
+    /** Origins allowed for iframe embeds (triggers stricter app review) */
+    frame_domains?: string[];
+    /** Origins that can receive openExternal redirects without safe-link modal */
+    redirect_domains?: string[];
+};
+type WidgetConfig<TInput extends ZodRawShapeCompat> = {
+    /** Unique identifier for the widget/tool */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Action-oriented description for the tool (tells the model WHEN to use it) */
+    description: string;
+    /** UI component description (describes WHAT the widget displays). Falls back to description if not provided. */
+    widgetDescription?: string;
+    /** Base URL for fetching widget HTML */
+    baseUrl: string;
+    /** Path to fetch HTML from (relative to baseUrl) */
+    htmlPath: string;
+    /** Input schema using zod */
+    inputSchema: TInput;
+    /** Optional loading message (defaults to "Loading...") */
+    invoking?: string;
+    /** Optional loaded message (defaults to "Loaded") */
+    invoked?: string;
+    /** Optional widget domain for security context */
+    widgetDomain?: string;
+    /** Optional: whether widget prefers border (defaults to true) */
+    prefersBorder?: boolean;
+    /** Optional: when true, the iframe height auto-adapts to its content instead of using a fixed height */
+    autoHeight?: boolean;
+    /** Content Security Policy configuration (required for app submission) */
+    widgetCSP?: WidgetCSP;
+    /** Optional: Annotations describe the tool’s potential impact. ChatGPT uses these hints to classify tools and decide when to ask the user for confirmation (elicitation) before using the tool.
+     *
+     * Note: openWorldHint and destructiveHint are only considered for writes (i.e. when readOnlyHint=false).
+     */
+    annotations?: {
+        /** Optional: Set to true for tools that do not change state (search, lookups, previews). This won't require elicitation. */
+        readOnlyHint?: boolean;
+        /** Optional: Set to true for tools where calling multiple times with the same args has no additional effect. */
+        idempotentHint?: boolean;
+        /** Optional: Set to false for tools that only affect a bounded target (for example, "update a task by id" in your own product). Leave true for tools that can write to arbitrary URLs/files/resources. */
+        openWorldHint?: boolean;
+        /** Optional:  Set to true for tools that can delete, overwrite, or have irreversible side effects. */
+        destructiveHint?: boolean;
+    };
+};
+type WidgetHandler<TInput extends ZodRawShapeCompat> = (input: ShapeOutput<TInput>, context: WidgetHandlerContext) => Promise<{
+    /** Text content to return */
+    text: string;
+    /** Structured data to pass to the widget */
+    data: Record<string, unknown>;
+}>;
+type WidgetToolCallback<TInput extends ZodRawShapeCompat> = ToolCallback<TInput>;
+type RegisteredWidget = {
+    id: string;
+    title: string;
+    description: string;
+    register: (server: McpServer) => Promise<void>;
+};
+
+declare const START: "__start__";
+declare const END: "__end__";
+declare const INTERRUPT: unique symbol;
+declare const WIDGET: unique symbol;
+type InterruptSignal = {
+    readonly __type: typeof INTERRUPT;
+    /** Question to ask the user */
+    question: string;
+    /** State key where the answer will be stored */
+    field: string;
+    /** Optional suggestions to present as options */
+    suggestions?: string[];
+};
+type WidgetSignal = {
+    readonly __type: typeof WIDGET;
+    /** ID of a registered widget to display */
+    widgetId: string;
+    /** Data to pass to the widget as structuredContent */
+    data: Record<string, unknown>;
+    /** Description of what the widget does (for the AI's context) */
+    description?: string;
+};
+/**
+ * Create an interrupt signal — pauses the flow and asks the user a text question.
+ */
+declare function interrupt(config: {
+    question: string;
+    field: string;
+    suggestions?: string[];
+}): InterruptSignal;
+/**
+ * Create a widget signal — pauses the flow and renders a widget UI.
+ */
+declare function showWidget(config: {
+    widgetId: string;
+    data: Record<string, unknown>;
+    description?: string;
+}): WidgetSignal;
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Node handler — a single function type for all node kinds.
+ * The return value determines behavior:
+ * - `Partial<TState>` → action node (state merged, auto-advance)
+ * - `InterruptSignal` → interrupt (pause, ask user)
+ * - `WidgetSignal` → widget step (pause, show widget)
+ */
+type NodeHandler<TState> = (state: Partial<TState>, meta?: Record<string, unknown>) => MaybePromise<Partial<TState> | InterruptSignal | WidgetSignal>;
+/**
+ * Condition function for conditional edges.
+ * Receives current state, returns the name of the next node.
+ */
+type ConditionFn<TState> = (state: Partial<TState>) => string | Promise<string>;
+type FlowConfig = {
+    /** Unique identifier for the flow (becomes the MCP tool name) */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Description for the AI (explains when to use this flow) */
+    description: string;
+    /** Optional tool annotations */
+    annotations?: {
+        readOnlyHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+        destructiveHint?: boolean;
+    };
+};
+type CompileOptions = {
+    /** Map of widget IDs to their RegisteredWidget, for resolving widget resource URIs */
+    widgetRefs?: Record<string, {
+        id: string;
+    }>;
+};
+
+/**
+ * A compiled flow — compatible with RegisteredWidget for registration.
+ */
+type RegisteredFlow = {
+    id: string;
+    title: string;
+    description: string;
+    register: (server: McpServer) => Promise<void>;
+};
+
+/**
+ * A LangGraph-inspired state graph builder for MCP tools.
+ *
+ * @example
+ * ```ts
+ * const flow = new StateGraph<MyState>({
+ *   id: "onboarding",
+ *   title: "User Onboarding",
+ *   description: "Guides users through onboarding",
+ * })
+ *   .addNode("ask_name", () => interrupt({ question: "What's your name?", field: "name" }))
+ *   .addNode("greet", (state) => ({ greeting: `Hello ${state.name}!` }))
+ *   .addEdge(START, "ask_name")
+ *   .addEdge("ask_name", "greet")
+ *   .addEdge("greet", END)
+ *   .compile();
+ * ```
+ */
+declare class StateGraph<TState extends Record<string, unknown>> {
+    private nodes;
+    private edges;
+    private config;
+    constructor(config: FlowConfig);
+    /**
+     * Add a node to the graph.
+     *
+     * The handler's return value determines the node type:
+     * - Returns `Partial<TState>` → **action node**: state is merged, auto-advances to next node
+     * - Returns `interrupt(...)` → **interrupt node**: pauses flow, asks user a question
+     * - Returns `showWidget(...)` → **widget node**: pauses flow, renders a widget UI
+     */
+    addNode(name: string, handler: NodeHandler<TState>): this;
+    /**
+     * Add a direct edge between two nodes.
+     *
+     * Use `START` as `from` to set the entry point.
+     * Use `END` as `to` to mark a terminal node.
+     */
+    addEdge(from: string, to: string): this;
+    /**
+     * Add a conditional edge from a node.
+     *
+     * The condition function receives current state and returns the name of the next node.
+     */
+    addConditionalEdge(from: string, condition: ConditionFn<TState>): this;
+    /**
+     * Compile the graph into a RegisteredFlow that can be registered on an McpServer.
+     *
+     * Validates the graph structure and returns a registration-compatible object.
+     */
+    compile(options?: CompileOptions): RegisteredFlow;
+    private validate;
+}
+
+/**
+ * Create a new flow graph — convenience factory for `new StateGraph()`.
+ *
+ * @example
+ * ```ts
+ * import { createFlow, interrupt, START, END } from "@waniwani/sdk/mcp";
+ *
+ * type MyState = { name: string; email: string };
+ *
+ * const flow = createFlow<MyState>({
+ *   id: "onboarding",
+ *   title: "User Onboarding",
+ *   description: "Guides users through onboarding. Use when a user wants to get started.",
+ * })
+ *   .addNode("ask_name", () => interrupt({ question: "What's your name?", field: "name" }))
+ *   .addNode("ask_email", () => interrupt({ question: "What's your email?", field: "email" }))
+ *   .addEdge(START, "ask_name")
+ *   .addEdge("ask_name", "ask_email")
+ *   .addEdge("ask_email", END)
+ *   .compile();
+ * ```
+ */
+declare function createFlow<TState extends Record<string, unknown>>(config: FlowConfig): StateGraph<TState>;
+
+/**
+ * Creates a widget with minimal boilerplate.
+ *
+ * @example
+ * ```ts
+ * const weatherWidget = createWidget({
+ *   id: "show_weather",
+ *   title: "Show Weather",
+ *   description: "Displays weather information for a city",
+ *   baseUrl: "https://my-app.com",
+ *   htmlPath: "/weather",
+ *   inputSchema: {
+ *     city: z.string().describe("The city name"),
+ *   },
+ * }, async ({ city }) => ({
+ *   text: `Weather for ${city}`,
+ *   data: { city, temperature: 72 },
+ * }));
+ * ```
+ */
+declare function createWidget<TInput extends z.ZodRawShape>(config: WidgetConfig<TInput> & {
+    widgetDomain: string;
+}, handler: WidgetHandler<TInput>): RegisteredWidget;
+/**
+ * Registers multiple widgets on the server
+ */
+declare function registerWidgets(server: McpServer, widgets: RegisteredWidget[]): Promise<void>;
+
+export { type CompileOptions, type ConditionFn, END, type FlowConfig, type HostContext, type InterruptSignal, type NodeHandler, type RegisteredFlow, type RegisteredWidget, START, StateGraph, type ToolCallResult, type ToolResult, type UnifiedWidgetClient, type WidgetCSP, type WidgetConfig, type WidgetHandler, type WidgetHandlerContext, type WidgetPlatform, type WidgetSignal, type WidgetToolCallback, createFlow, createWidget, detectPlatform, interrupt, isMCPApps, isOpenAI, registerWidgets, showWidget };

package/dist/mcp/index.js

@@ -1,2 +1,4 @@
-var P="text/html+skybridge",C="text/html;profile=mcp-app",I=async(e,i)=>{let t=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${t}${i}`)).text()};function b(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function A(e){let i=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:{...i&&{csp:i},...e.prefersBorder!==void 0&&{prefersBorder:e.prefersBorder}}}}function B(e){return{"openai/outputTemplate":e.openaiTemplateUri,"openai/toolInvocation/invoking":e.invoking,"openai/toolInvocation/invoked":e.invoked,"openai/widgetAccessible":!0,"openai/resultCanProduceWidget":!0,ui:{resourceUri:e.mcpTemplateUri,...e.autoHeight&&{autoHeight:!0}}}}function H(e,i){let{id:t,title:r,description:a,widgetDescription:y,baseUrl:W,htmlPath:T,inputSchema:k,invoking:h="Loading...",invoked:M="Loaded",widgetDomain:R,prefersBorder:s=!0,autoHeight:v,widgetCSP:c,annotations:_}=e,o=y??a,m=`ui://widgets/apps-sdk/${t}.html`,g=`ui://widgets/ext-apps/${t}.html`;return{id:t,title:r,description:a,async register(p){let u=await I(W,T),l=B({openaiTemplateUri:m,mcpTemplateUri:g,invoking:h,invoked:M,autoHeight:v});p.registerResource(`${t}-openai-widget`,m,{title:r,description:o,mimeType:P,_meta:{"openai/widgetDescription":o,"openai/widgetPrefersBorder":s}},async n=>({contents:[{uri:n.href,mimeType:P,text:u,_meta:b({description:o,prefersBorder:s,widgetDomain:R,widgetCSP:c})}]})),p.registerResource(`${t}-mcp-widget`,g,{title:r,description:o,mimeType:C,_meta:{ui:{prefersBorder:s}}},async n=>({contents:[{uri:n.href,mimeType:C,text:u,_meta:A({description:o,prefersBorder:s,widgetCSP:c})}]})),p.registerTool(t,{title:r,description:a,inputSchema:k,annotations:_,_meta:l},(async(n,D)=>{let w=D._meta??{},f=await i(n,{extra:{_meta:w}});return{content:[{type:"text",text:f.text}],structuredContent:f.data,_meta:{...l,...w}}}))}}}async function E(e,i){await Promise.all(i.map(t=>t.register(e)))}function d(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function O(){return d()==="openai"}function U(){return d()==="mcp-apps"}export{H as createWidget,d as detectPlatform,U as isMCPApps,O as isOpenAI,E as registerWidgets};
+function _(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function z(){return _()==="openai"}function G(){return _()==="mcp-apps"}var c="__start__",u="__end__",F=Symbol.for("waniwani.flow.interrupt"),O=Symbol.for("waniwani.flow.widget");function D(t){return{__type:F,...t}}function A(t){return{__type:O,...t}}function P(t){return typeof t=="object"&&t!==null&&"__type"in t&&t.__type===F}function H(t){return typeof t=="object"&&t!==null&&"__type"in t&&t.__type===O}import{z as f}from"zod";function L(t){return["","## FLOW EXECUTION PROTOCOL","","This tool implements a multi-step conversational flow. Follow this protocol exactly:","",'1. Call with `action: "start"` to begin.',"2. The response JSON `status` field tells you what to do next:",'   - `"interrupt"`: Ask the user the `question`. Then call again with:','     `action: "continue"`, `step` = the returned `step`, `state` = the returned `state`,',"     `answer` = the user's answer.",'   - `"widget"`: A widget UI is being shown. Do NOT call this tool again \u2014 the widget handles the callback.','   - `"complete"`: The flow is done. Present the result to the user.','   - `"error"`: Something went wrong. Show the `error` message.',"","3. ALWAYS pass back the `state` object exactly as received.","4. Do NOT skip steps or invent state values."].join(`
+`)}async function C(t,e){return t.type==="direct"?t.to:t.condition(e)}function Y(t){let e=`ui://widgets/apps-sdk/${t}.html`,r=`ui://widgets/ext-apps/${t}.html`;return{"openai/outputTemplate":e,"openai/widgetAccessible":!0,"openai/resultCanProduceWidget":!0,ui:{resourceUri:r}}}async function E(t,e,r,i,l,S){let d=t,o={...e},p=50,g=0;for(;g++<p;){if(d===u)return{text:JSON.stringify({status:"complete",state:o}),data:{status:"complete",state:o}};let a=r.get(d);if(!a)return{text:JSON.stringify({status:"error",error:`Unknown node: "${d}"`}),data:{status:"error"}};try{let n=await a(o,S);if(P(n))return{text:JSON.stringify({status:"interrupt",step:d,question:n.question,field:n.field,suggestions:n.suggestions,state:o}),data:{status:"interrupt",step:d,state:o}};if(H(n))return{text:JSON.stringify({status:"widget",step:d,widgetId:n.widgetId,description:n.description,state:o}),data:{...n.data,__flow:{flowId:l,step:d,state:o}},widgetMeta:Y(n.widgetId)};o={...o,...n};let s=i.get(d);if(!s)return{text:JSON.stringify({status:"error",error:`No outgoing edge from node "${d}"`}),data:{status:"error"}};d=await C(s,o)}catch(n){let s=n instanceof Error?n.message:String(n);return{text:JSON.stringify({status:"error",step:d,error:s,state:o}),data:{status:"error",error:s}}}}return{text:JSON.stringify({status:"error",error:"Flow exceeded maximum iterations (possible infinite loop)"}),data:{status:"error"}}}var X={action:f.enum(["start","continue","widget_result"]).describe('"start" to begin the flow, "continue" after the user answers a question, "widget_result" when a widget returns data'),step:f.string().optional().describe("Current step name (from the previous response)"),state:f.record(f.unknown()).optional().describe("Flow state \u2014 pass back exactly as received"),answer:f.string().optional().describe("The user's answer (for interrupt steps)"),widgetResult:f.record(f.unknown()).optional().describe("Data returned by a widget callback")};function $(t){let{config:e,nodes:r,edges:i}=t,l=L(e),S=`${e.description}
+${l}`;async function d(o,p){let g=o.state??{};if(o.action==="start"){let a=i.get(c);if(!a)return{text:JSON.stringify({status:"error",error:"No start edge"}),data:{status:"error"}};let n=await C(a,g);return E(n,g,r,i,e.id,p)}if(o.action==="continue"){if(!o.step)return{text:JSON.stringify({status:"error",error:'Missing "step" for continue action'}),data:{status:"error"}};let a={...g};if(o.answer){let R=r.get(o.step);if(R)try{let h=await R(a,p);P(h)&&h.field&&(a={...a,[h.field]:o.answer})}catch{}}let n=i.get(o.step);if(!n)return{text:JSON.stringify({status:"error",error:`No edge from step "${o.step}"`}),data:{status:"error"}};let s=await C(n,a);return E(s,a,r,i,e.id,p)}if(o.action==="widget_result"){if(!o.step)return{text:JSON.stringify({status:"error",error:'Missing "step" for widget_result action'}),data:{status:"error"}};let a={...g,...o.widgetResult??{}},n=i.get(o.step);if(!n)return{text:JSON.stringify({status:"error",error:`No edge from step "${o.step}"`}),data:{status:"error"}};let s=await C(n,a);return E(s,a,r,i,e.id,p)}return{text:JSON.stringify({status:"error",error:`Unknown action: "${o.action}"`}),data:{status:"error"}}}return{id:e.id,title:e.title,description:S,async register(o){o.registerTool(e.id,{title:e.title,description:S,inputSchema:X,annotations:e.annotations},(async(p,g)=>{let n=g._meta??{},s=await d(p,n);return{content:[{type:"text",text:s.text}],structuredContent:s.data,_meta:{...s.widgetMeta??{},...n}}}))}}}var y=class{nodes=new Map;edges=new Map;config;constructor(e){this.config=e}addNode(e,r){if(e===c||e===u)throw new Error(`"${e}" is a reserved name and cannot be used as a node name`);if(this.nodes.has(e))throw new Error(`Node "${e}" already exists`);return this.nodes.set(e,r),this}addEdge(e,r){if(this.edges.has(e))throw new Error(`Node "${e}" already has an outgoing edge. Use addConditionalEdge for branching.`);return this.edges.set(e,{type:"direct",to:r}),this}addConditionalEdge(e,r){if(this.edges.has(e))throw new Error(`Node "${e}" already has an outgoing edge.`);return this.edges.set(e,{type:"conditional",condition:r}),this}compile(e){return this.validate(),$({config:this.config,nodes:new Map(this.nodes),edges:new Map(this.edges),widgetRefs:e?.widgetRefs})}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 e=this.edges.get(c);if(e?.type==="direct"&&e.to!==u&&!this.nodes.has(e.to))throw new Error(`START edge references non-existent node: "${e.to}"`);for(let[r,i]of this.edges){if(r!==c&&!this.nodes.has(r))throw new Error(`Edge from non-existent node: "${r}"`);if(i.type==="direct"&&i.to!==u&&!this.nodes.has(i.to))throw new Error(`Edge from "${r}" references non-existent node: "${i.to}"`)}for(let[r]of this.nodes)if(!this.edges.has(r))throw new Error(`Node "${r}" has no outgoing edge. Add one with .addEdge("${r}", ...) or .addConditionalEdge("${r}", ...)`)}};function q(t){return new y(t)}var U="text/html+skybridge",J="text/html;profile=mcp-app",Z=async(t,e)=>{let r=t.endsWith("/")?t.slice(0,-1):t;return await(await fetch(`${r}${e}`)).text()};function K(t){return{"openai/widgetDescription":t.description,"openai/widgetPrefersBorder":t.prefersBorder,"openai/widgetDomain":t.widgetDomain,...t.widgetCSP&&{"openai/widgetCSP":t.widgetCSP}}}function Q(t){let e=t.widgetCSP?{connectDomains:t.widgetCSP.connect_domains,resourceDomains:t.widgetCSP.resource_domains,frameDomains:t.widgetCSP.frame_domains,redirectDomains:t.widgetCSP.redirect_domains}:void 0;return{ui:{...e&&{csp:e},...t.prefersBorder!==void 0&&{prefersBorder:t.prefersBorder}}}}function V(t){return{"openai/outputTemplate":t.openaiTemplateUri,"openai/toolInvocation/invoking":t.invoking,"openai/toolInvocation/invoked":t.invoked,"openai/widgetAccessible":!0,"openai/resultCanProduceWidget":!0,ui:{resourceUri:t.mcpTemplateUri,...t.autoHeight&&{autoHeight:!0}}}}function tt(t,e){let{id:r,title:i,description:l,widgetDescription:S,baseUrl:d,htmlPath:o,inputSchema:p,invoking:g="Loading...",invoked:a="Loaded",widgetDomain:n,prefersBorder:s=!0,autoHeight:R,widgetCSP:h,annotations:B}=t,x=S??l,N=`ui://widgets/apps-sdk/${r}.html`,v=`ui://widgets/ext-apps/${r}.html`;return{id:r,title:i,description:l,async register(k){let W=await Z(d,o),b=V({openaiTemplateUri:N,mcpTemplateUri:v,invoking:g,invoked:a,autoHeight:R});k.registerResource(`${r}-openai-widget`,N,{title:i,description:x,mimeType:U,_meta:{"openai/widgetDescription":x,"openai/widgetPrefersBorder":s}},async T=>({contents:[{uri:T.href,mimeType:U,text:W,_meta:K({description:x,prefersBorder:s,widgetDomain:n,widgetCSP:h})}]})),k.registerResource(`${r}-mcp-widget`,v,{title:i,description:x,mimeType:J,_meta:{ui:{prefersBorder:s}}},async T=>({contents:[{uri:T.href,mimeType:J,text:W,_meta:Q({description:x,prefersBorder:s,widgetCSP:h})}]})),k.registerTool(r,{title:i,description:l,inputSchema:p,annotations:B,_meta:b},(async(T,j)=>{let M=j._meta??{},I=await e(T,{extra:{_meta:M}});return{content:[{type:"text",text:I.text}],structuredContent:I.data,_meta:{...b,...M}}}))}}}async function et(t,e){await Promise.all(e.map(r=>r.register(t)))}export{u as END,c as START,y as StateGraph,q as createFlow,tt as createWidget,_ as detectPlatform,D as interrupt,G as isMCPApps,z as isOpenAI,et as registerWidgets,A as showWidget};
 //# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/widgets/@utils/create-widget.ts","../../src/mcp/widgets/@utils/platform.ts"],"sourcesContent":["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 type {\n\tMcpServer,\n\tRegisteredWidget,\n\tWidgetConfig,\n\tWidgetHandler,\n} 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 */\nconst MIME_TYPE_OPENAI = \"text/html+skybridge\";\nconst MIME_TYPE_MCP = \"text/html;profile=mcp-app\";\n\ninterface WidgetCSP {\n\tconnect_domains?: string[];\n\tresource_domains?: string[];\n\tframe_domains?: string[];\n\tredirect_domains?: string[];\n}\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\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\nconst fetchHtml = async (baseUrl: string, path: string): 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/**\n * Build OpenAI-specific resource metadata\n */\nfunction 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/**\n * Build MCP Apps-specific resource metadata\n * Note: MCP Apps (Claude) doesn't use the domain field in the same way as OpenAI.\n * Claude computes it dynamically at request time in the format: {hash}.claudemcpcontent.com\n */\nfunction buildMcpAppsResourceMeta(config: {\n\tdescription?: string;\n\tprefersBorder?: boolean;\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.prefersBorder !== undefined && {\n\t\t\t\tprefersBorder: config.prefersBorder,\n\t\t\t}),\n\t\t},\n\t};\n}\n\n/**\n * Build tool metadata that references both OpenAI and MCP widget URIs\n */\nfunction 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\"openai/outputTemplate\": config.openaiTemplateUri,\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\tui: {\n\t\t\tresourceUri: config.mcpTemplateUri,\n\t\t\t...(config.autoHeight && { autoHeight: true }),\n\t\t},\n\t} as const;\n}\n\n/**\n * Creates a widget with minimal boilerplate.\n *\n * @example\n * ```ts\n * const weatherWidget = createWidget({\n *   id: \"show_weather\",\n *   title: \"Show Weather\",\n *   description: \"Displays weather information for a city\",\n *   baseUrl: \"https://my-app.com\",\n *   htmlPath: \"/weather\",\n *   inputSchema: {\n *     city: z.string().describe(\"The city name\"),\n *   },\n * }, async ({ city }) => ({\n *   text: `Weather for ${city}`,\n *   data: { city, temperature: 72 },\n * }));\n * ```\n */\nexport function createWidget<TInput extends z.ZodRawShape>(\n\tconfig: WidgetConfig<TInput> & { widgetDomain: string },\n\thandler: WidgetHandler<TInput>,\n): RegisteredWidget {\n\tconst {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\t\twidgetDescription,\n\t\tbaseUrl,\n\t\thtmlPath,\n\t\tinputSchema,\n\t\tinvoking = \"Loading...\",\n\t\tinvoked = \"Loaded\",\n\t\twidgetDomain,\n\t\tprefersBorder = true,\n\t\tautoHeight,\n\t\twidgetCSP,\n\t\tannotations,\n\t} = config;\n\n\t// Use widgetDescription for UI metadata, fall back to description\n\tconst uiDescription = widgetDescription ?? description;\n\n\t// Create URIs for both platforms\n\tconst openaiTemplateUri = `ui://widgets/apps-sdk/${id}.html`;\n\tconst mcpTemplateUri = `ui://widgets/ext-apps/${id}.html`;\n\n\treturn {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\n\t\tasync register(server: McpServer): Promise<void> {\n\t\t\tconst html = await fetchHtml(baseUrl, htmlPath);\n\n\t\t\t// Build tool metadata that references both widget URIs\n\t\t\tconst toolMeta = buildToolMeta({\n\t\t\t\topenaiTemplateUri,\n\t\t\t\tmcpTemplateUri,\n\t\t\t\tinvoking,\n\t\t\t\tinvoked,\n\t\t\t\tautoHeight,\n\t\t\t});\n\n\t\t\t// Register OpenAI Apps SDK resource\n\t\t\tserver.registerResource(\n\t\t\t\t`${id}-openai-widget`,\n\t\t\t\topenaiTemplateUri,\n\t\t\t\t{\n\t\t\t\t\ttitle,\n\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\"openai/widgetDescription\": uiDescription,\n\t\t\t\t\t\t\"openai/widgetPrefersBorder\": prefersBorder,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tasync (uri) => ({\n\t\t\t\t\tcontents: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t\t_meta: buildOpenAIResourceMeta({\n\t\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\t\twidgetDomain,\n\t\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t);\n\n\t\t\t// Register MCP Apps resource\n\t\t\tserver.registerResource(\n\t\t\t\t`${id}-mcp-widget`,\n\t\t\t\tmcpTemplateUri,\n\t\t\t\t{\n\t\t\t\t\ttitle,\n\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t\t_meta: {\n\t\t\t\t\t\tui: {\n\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tasync (uri) => ({\n\t\t\t\t\tcontents: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t\t_meta: buildMcpAppsResourceMeta({\n\t\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t);\n\n\t\t\t// Register the tool\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_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/**\n\t\t\t\t\t * This is a workaround to type the tool callback correctly.\n\t\t\t\t\t *\n\t\t\t\t\t * The types are correct but TS is not able to infer the type correctly.\n\t\t\t\t\t */\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: result.text }],\n\t\t\t\t\t\tstructuredContent: result.data,\n\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t...toolMeta,\n\t\t\t\t\t\t\t..._meta,\n\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 widgets on the server\n */\nexport async function registerWidgets(\n\tserver: McpServer,\n\twidgets: RegisteredWidget[],\n): Promise<void> {\n\tawait Promise.all(widgets.map((w) => w.register(server)));\n}\n","/**\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"],"mappings":"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","names":["MIME_TYPE_OPENAI","MIME_TYPE_MCP","fetchHtml","baseUrl","path","normalizedBase","buildOpenAIResourceMeta","config","buildMcpAppsResourceMeta","csp","buildToolMeta","createWidget","handler","id","title","description","widgetDescription","htmlPath","inputSchema","invoking","invoked","widgetDomain","prefersBorder","autoHeight","widgetCSP","annotations","uiDescription","openaiTemplateUri","mcpTemplateUri","server","html","toolMeta","uri","args","extra","_meta","result","registerWidgets","widgets","w","detectPlatform","isOpenAI","isMCPApps"]}
+{"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/state-graph.ts","../../src/mcp/server/flows/create-flow.ts","../../src/mcp/server/widgets/create-widget.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","// ============================================================================\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\nexport type InterruptSignal = {\n\treadonly __type: typeof INTERRUPT;\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};\n\nexport type WidgetSignal = {\n\treadonly __type: typeof WIDGET;\n\t/** ID of a registered widget to display */\n\twidgetId: string;\n\t/** Data to pass to the widget as structuredContent */\n\tdata: Record<string, unknown>;\n\t/** Description of what the widget does (for the AI's context) */\n\tdescription?: string;\n};\n\n/**\n * Create an interrupt signal — pauses the flow and asks the user a text question.\n */\nexport function interrupt(config: {\n\tquestion: string;\n\tfield: string;\n\tsuggestions?: string[];\n}): InterruptSignal {\n\treturn { __type: INTERRUPT, ...config };\n}\n\n/**\n * Create a widget signal — pauses the flow and renders a widget UI.\n */\nexport function showWidget(config: {\n\twidgetId: string;\n\tdata: Record<string, unknown>;\n\tdescription?: string;\n}): WidgetSignal {\n\treturn { __type: WIDGET, ...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 & edge definitions\n// ============================================================================\n\nexport type MaybePromise<T> = T | Promise<T>;\n\n/**\n * Node handler — a single function type for all node kinds.\n * The return value determines behavior:\n * - `Partial<TState>` → action node (state merged, auto-advance)\n * - `InterruptSignal` → interrupt (pause, ask user)\n * - `WidgetSignal` → widget step (pause, show widget)\n */\nexport type NodeHandler<TState> = (\n\tstate: Partial<TState>,\n\tmeta?: Record<string, unknown>,\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/** 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\nexport type CompileOptions = {\n\t/** Map of widget IDs to their RegisteredWidget, for resolving widget resource URIs */\n\twidgetRefs?: Record<string, { id: string }>;\n};\n\n// Re-export McpServer type from the widget types\nexport type {\n\tMcpServer,\n\tRegisteredWidget,\n} from \"../widgets/types\";\n\nimport type { McpServer } from \"../widgets/types\";\n\n/**\n * A compiled flow — compatible with RegisteredWidget for registration.\n */\nexport type RegisteredFlow = {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n\tregister: (server: McpServer) => Promise<void>;\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\tEdge,\n\tFlowConfig,\n\tMcpServer,\n\tNodeHandler,\n\tRegisteredFlow,\n} from \"./@types\";\nimport { END, isInterrupt, isWidget, START } from \"./@types\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\ninterface CompileInput<TState extends Record<string, unknown>> {\n\tconfig: FlowConfig;\n\tnodes: Map<string, NodeHandler<TState>>;\n\tedges: Map<string, Edge<TState>>;\n\twidgetRefs?: Record<string, { id: string }>;\n}\n\ntype FlowToolInput = {\n\taction: \"start\" | \"continue\" | \"widget_result\";\n\tstep?: string;\n\tstate?: Record<string, unknown>;\n\tanswer?: string;\n\twidgetResult?: Record<string, unknown>;\n};\n\ntype ExecutionResult = {\n\ttext: string;\n\tdata: Record<string, unknown>;\n\twidgetMeta?: Record<string, unknown>;\n};\n\n// ============================================================================\n// Flow protocol — embedded in tool description\n// ============================================================================\n\nfunction buildFlowProtocol(_config: FlowConfig): string {\n\treturn [\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.',\n\t\t\"2. The response JSON `status` field tells you what to do next:\",\n\t\t'   - `\"interrupt\"`: Ask the user the `question`. Then call again with:',\n\t\t'     `action: \"continue\"`, `step` = the returned `step`, `state` = the returned `state`,',\n\t\t\"     `answer` = the user's answer.\",\n\t\t'   - `\"widget\"`: A widget UI is being shown. Do NOT call this tool again — the widget handles the callback.',\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 `state` object exactly as received.\",\n\t\t\"4. Do NOT skip steps or invent state values.\",\n\t].join(\"\\n\");\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// Widget metadata\n// ============================================================================\n\nfunction buildWidgetMeta(widgetId: string): Record<string, unknown> {\n\tconst openaiTemplateUri = `ui://widgets/apps-sdk/${widgetId}.html`;\n\tconst mcpTemplateUri = `ui://widgets/ext-apps/${widgetId}.html`;\n\n\treturn {\n\t\t\"openai/outputTemplate\": openaiTemplateUri,\n\t\t\"openai/widgetAccessible\": true,\n\t\t\"openai/resultCanProduceWidget\": true,\n\t\tui: {\n\t\t\tresourceUri: mcpTemplateUri,\n\t\t},\n\t};\n}\n\n// ============================================================================\n// Execution engine\n// ============================================================================\n\nasync function executeFrom<TState extends Record<string, unknown>>(\n\tstartNodeName: string,\n\tinitialState: TState,\n\tnodes: Map<string, NodeHandler<TState>>,\n\tedges: Map<string, Edge<TState>>,\n\tflowId: string,\n\tmeta?: Record<string, unknown>,\n): Promise<ExecutionResult> {\n\tlet currentNode = startNodeName;\n\tlet state = { ...initialState };\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\ttext: JSON.stringify({\n\t\t\t\t\tstatus: \"complete\",\n\t\t\t\t\tstate,\n\t\t\t\t}),\n\t\t\t\tdata: { status: \"complete\", 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\ttext: JSON.stringify({\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\tdata: { status: \"error\" },\n\t\t\t};\n\t\t}\n\n\t\ttry {\n\t\t\tconst result = await handler(state, meta);\n\n\t\t\t// Interrupt signal — pause and ask the user\n\t\t\tif (isInterrupt(result)) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: JSON.stringify({\n\t\t\t\t\t\tstatus: \"interrupt\",\n\t\t\t\t\t\tstep: currentNode,\n\t\t\t\t\t\tquestion: result.question,\n\t\t\t\t\t\tfield: result.field,\n\t\t\t\t\t\tsuggestions: result.suggestions,\n\t\t\t\t\t\tstate,\n\t\t\t\t\t}),\n\t\t\t\t\tdata: { status: \"interrupt\", step: currentNode, state },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Widget signal — pause and show widget\n\t\t\tif (isWidget(result)) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: JSON.stringify({\n\t\t\t\t\t\tstatus: \"widget\",\n\t\t\t\t\t\tstep: currentNode,\n\t\t\t\t\t\twidgetId: result.widgetId,\n\t\t\t\t\t\tdescription: result.description,\n\t\t\t\t\t\tstate,\n\t\t\t\t\t}),\n\t\t\t\t\tdata: {\n\t\t\t\t\t\t...result.data,\n\t\t\t\t\t\t__flow: {\n\t\t\t\t\t\t\tflowId,\n\t\t\t\t\t\t\tstep: currentNode,\n\t\t\t\t\t\t\tstate,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\twidgetMeta: buildWidgetMeta(result.widgetId),\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\ttext: JSON.stringify({\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\tdata: { status: \"error\" },\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\ttext: JSON.stringify({\n\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\tstep: currentNode,\n\t\t\t\t\terror: message,\n\t\t\t\t\tstate,\n\t\t\t\t}),\n\t\t\t\tdata: { status: \"error\", error: message },\n\t\t\t};\n\t\t}\n\t}\n\n\treturn {\n\t\ttext: JSON.stringify({\n\t\t\tstatus: \"error\",\n\t\t\terror: \"Flow exceeded maximum iterations (possible infinite loop)\",\n\t\t}),\n\t\tdata: { status: \"error\" },\n\t};\n}\n\n// ============================================================================\n// Compile\n// ============================================================================\n\nconst inputSchema = {\n\taction: z\n\t\t.enum([\"start\", \"continue\", \"widget_result\"])\n\t\t.describe(\n\t\t\t'\"start\" to begin the flow, \"continue\" after the user answers a question, \"widget_result\" when a widget returns data',\n\t\t),\n\tstep: z\n\t\t.string()\n\t\t.optional()\n\t\t.describe(\"Current step name (from the previous response)\"),\n\tstate: z\n\t\t.record(z.unknown())\n\t\t.optional()\n\t\t.describe(\"Flow state — pass back exactly as received\"),\n\tanswer: z\n\t\t.string()\n\t\t.optional()\n\t\t.describe(\"The user's answer (for interrupt steps)\"),\n\twidgetResult: z\n\t\t.record(z.unknown())\n\t\t.optional()\n\t\t.describe(\"Data returned by a widget callback\"),\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\tasync function handleToolCall(\n\t\targs: FlowToolInput,\n\t\tmeta?: Record<string, unknown>,\n\t): Promise<ExecutionResult> {\n\t\tconst state = (args.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\ttext: JSON.stringify({ status: \"error\", error: \"No start edge\" }),\n\t\t\t\t\tdata: { status: \"error\" },\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst firstNode = await resolveNextNode(startEdge, state);\n\t\t\treturn executeFrom(firstNode, state, nodes, edges, config.id, meta);\n\t\t}\n\n\t\tif (args.action === \"continue\") {\n\t\t\tif (!args.step) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: JSON.stringify({\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: 'Missing \"step\" for continue action',\n\t\t\t\t\t}),\n\t\t\t\t\tdata: { status: \"error\" },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Apply user's answer to state using the field from the interrupt\n\t\t\tlet updatedState = { ...state };\n\t\t\tif (args.answer) {\n\t\t\t\tconst handler = nodes.get(args.step);\n\t\t\t\tif (handler) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst result = await handler(updatedState, meta);\n\t\t\t\t\t\tif (isInterrupt(result) && result.field) {\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[result.field]: args.answer,\n\t\t\t\t\t\t\t} as TState;\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// If re-running the handler fails, still proceed with the answer\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Advance to next node\n\t\t\tconst edge = edges.get(args.step);\n\t\t\tif (!edge) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: JSON.stringify({\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: `No edge from step \"${args.step}\"`,\n\t\t\t\t\t}),\n\t\t\t\t\tdata: { status: \"error\" },\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst nextNode = await resolveNextNode(edge, updatedState);\n\t\t\treturn executeFrom(nextNode, updatedState, nodes, edges, config.id, meta);\n\t\t}\n\n\t\tif (args.action === \"widget_result\") {\n\t\t\tif (!args.step) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: JSON.stringify({\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: 'Missing \"step\" for widget_result action',\n\t\t\t\t\t}),\n\t\t\t\t\tdata: { status: \"error\" },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\t// Merge widget result into state\n\t\t\tconst updatedState = {\n\t\t\t\t...state,\n\t\t\t\t...(args.widgetResult ?? {}),\n\t\t\t} as TState;\n\n\t\t\t// Advance to next node\n\t\t\tconst edge = edges.get(args.step);\n\t\t\tif (!edge) {\n\t\t\t\treturn {\n\t\t\t\t\ttext: JSON.stringify({\n\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\terror: `No edge from step \"${args.step}\"`,\n\t\t\t\t\t}),\n\t\t\t\t\tdata: { status: \"error\" },\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst nextNode = await resolveNextNode(edge, updatedState);\n\t\t\treturn executeFrom(nextNode, updatedState, nodes, edges, config.id, meta);\n\t\t}\n\n\t\treturn {\n\t\t\ttext: JSON.stringify({\n\t\t\t\tstatus: \"error\",\n\t\t\t\terror: `Unknown action: \"${args.action}\"`,\n\t\t\t}),\n\t\t\tdata: { status: \"error\" },\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\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: result.text }],\n\t\t\t\t\t\tstructuredContent: result.data,\n\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t...(result.widgetMeta ?? {}),\n\t\t\t\t\t\t\t..._meta,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\t}) as unknown as ToolCallback<typeof inputSchema>,\n\t\t\t);\n\t\t},\n\t};\n}\n","import type {\n\tCompileOptions,\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({ 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 to the graph.\n\t *\n\t * The handler's return value determines the node type:\n\t * - Returns `Partial<TState>` → **action node**: state is merged, auto-advances to next node\n\t * - Returns `interrupt(...)` → **interrupt node**: pauses flow, asks user a question\n\t * - Returns `showWidget(...)` → **widget node**: pauses flow, renders a widget UI\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\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(options?: CompileOptions): 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\twidgetRefs: options?.widgetRefs,\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 { FlowConfig } from \"./@types\";\nimport { StateGraph } from \"./state-graph\";\n\n/**\n * Create a new flow graph — convenience factory for `new StateGraph()`.\n *\n * @example\n * ```ts\n * import { createFlow, interrupt, START, END } from \"@waniwani/sdk/mcp\";\n *\n * type MyState = { name: string; email: string };\n *\n * const flow = createFlow<MyState>({\n *   id: \"onboarding\",\n *   title: \"User Onboarding\",\n *   description: \"Guides users through onboarding. Use when a user wants to get started.\",\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<TState extends Record<string, unknown>>(\n\tconfig: FlowConfig,\n): StateGraph<TState> {\n\treturn new StateGraph<TState>(config);\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 type {\n\tMcpServer,\n\tRegisteredWidget,\n\tWidgetConfig,\n\tWidgetHandler,\n} 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 */\nconst MIME_TYPE_OPENAI = \"text/html+skybridge\";\nconst MIME_TYPE_MCP = \"text/html;profile=mcp-app\";\n\ninterface WidgetCSP {\n\tconnect_domains?: string[];\n\tresource_domains?: string[];\n\tframe_domains?: string[];\n\tredirect_domains?: string[];\n}\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\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\nconst fetchHtml = async (baseUrl: string, path: string): 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/**\n * Build OpenAI-specific resource metadata\n */\nfunction 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/**\n * Build MCP Apps-specific resource metadata\n * Note: MCP Apps (Claude) doesn't use the domain field in the same way as OpenAI.\n * Claude computes it dynamically at request time in the format: {hash}.claudemcpcontent.com\n */\nfunction buildMcpAppsResourceMeta(config: {\n\tdescription?: string;\n\tprefersBorder?: boolean;\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.prefersBorder !== undefined && {\n\t\t\t\tprefersBorder: config.prefersBorder,\n\t\t\t}),\n\t\t},\n\t};\n}\n\n/**\n * Build tool metadata that references both OpenAI and MCP widget URIs\n */\nfunction 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\"openai/outputTemplate\": config.openaiTemplateUri,\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\tui: {\n\t\t\tresourceUri: config.mcpTemplateUri,\n\t\t\t...(config.autoHeight && { autoHeight: true }),\n\t\t},\n\t} as const;\n}\n\n/**\n * Creates a widget with minimal boilerplate.\n *\n * @example\n * ```ts\n * const weatherWidget = createWidget({\n *   id: \"show_weather\",\n *   title: \"Show Weather\",\n *   description: \"Displays weather information for a city\",\n *   baseUrl: \"https://my-app.com\",\n *   htmlPath: \"/weather\",\n *   inputSchema: {\n *     city: z.string().describe(\"The city name\"),\n *   },\n * }, async ({ city }) => ({\n *   text: `Weather for ${city}`,\n *   data: { city, temperature: 72 },\n * }));\n * ```\n */\nexport function createWidget<TInput extends z.ZodRawShape>(\n\tconfig: WidgetConfig<TInput> & { widgetDomain: string },\n\thandler: WidgetHandler<TInput>,\n): RegisteredWidget {\n\tconst {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\t\twidgetDescription,\n\t\tbaseUrl,\n\t\thtmlPath,\n\t\tinputSchema,\n\t\tinvoking = \"Loading...\",\n\t\tinvoked = \"Loaded\",\n\t\twidgetDomain,\n\t\tprefersBorder = true,\n\t\tautoHeight,\n\t\twidgetCSP,\n\t\tannotations,\n\t} = config;\n\n\t// Use widgetDescription for UI metadata, fall back to description\n\tconst uiDescription = widgetDescription ?? description;\n\n\t// Create URIs for both platforms\n\tconst openaiTemplateUri = `ui://widgets/apps-sdk/${id}.html`;\n\tconst mcpTemplateUri = `ui://widgets/ext-apps/${id}.html`;\n\n\treturn {\n\t\tid,\n\t\ttitle,\n\t\tdescription,\n\n\t\tasync register(server: McpServer): Promise<void> {\n\t\t\tconst html = await fetchHtml(baseUrl, htmlPath);\n\n\t\t\t// Build tool metadata that references both widget URIs\n\t\t\tconst toolMeta = buildToolMeta({\n\t\t\t\topenaiTemplateUri,\n\t\t\t\tmcpTemplateUri,\n\t\t\t\tinvoking,\n\t\t\t\tinvoked,\n\t\t\t\tautoHeight,\n\t\t\t});\n\n\t\t\t// Register OpenAI Apps SDK resource\n\t\t\tserver.registerResource(\n\t\t\t\t`${id}-openai-widget`,\n\t\t\t\topenaiTemplateUri,\n\t\t\t\t{\n\t\t\t\t\ttitle,\n\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\"openai/widgetDescription\": uiDescription,\n\t\t\t\t\t\t\"openai/widgetPrefersBorder\": prefersBorder,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tasync (uri) => ({\n\t\t\t\t\tcontents: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\t\tmimeType: MIME_TYPE_OPENAI,\n\t\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t\t_meta: buildOpenAIResourceMeta({\n\t\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\t\twidgetDomain,\n\t\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t);\n\n\t\t\t// Register MCP Apps resource\n\t\t\tserver.registerResource(\n\t\t\t\t`${id}-mcp-widget`,\n\t\t\t\tmcpTemplateUri,\n\t\t\t\t{\n\t\t\t\t\ttitle,\n\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t\t_meta: {\n\t\t\t\t\t\tui: {\n\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tasync (uri) => ({\n\t\t\t\t\tcontents: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\turi: uri.href,\n\t\t\t\t\t\t\tmimeType: MIME_TYPE_MCP,\n\t\t\t\t\t\t\ttext: html,\n\t\t\t\t\t\t\t_meta: buildMcpAppsResourceMeta({\n\t\t\t\t\t\t\t\tdescription: uiDescription,\n\t\t\t\t\t\t\t\tprefersBorder,\n\t\t\t\t\t\t\t\twidgetCSP,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t}),\n\t\t\t);\n\n\t\t\t// Register the tool\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_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/**\n\t\t\t\t\t * This is a workaround to type the tool callback correctly.\n\t\t\t\t\t *\n\t\t\t\t\t * The types are correct but TS is not able to infer the type correctly.\n\t\t\t\t\t */\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: result.text }],\n\t\t\t\t\t\tstructuredContent: result.data,\n\t\t\t\t\t\t_meta: {\n\t\t\t\t\t\t\t...toolMeta,\n\t\t\t\t\t\t\t..._meta,\n\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 widgets on the server\n */\nexport async function registerWidgets(\n\tserver: McpServer,\n\twidgets: RegisteredWidget[],\n): Promise<void> {\n\tawait Promise.all(widgets.map((w) => w.register(server)));\n}\n"],"mappings":"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","names":["detectPlatform","isOpenAI","isMCPApps","START","END","INTERRUPT","WIDGET","interrupt","config","showWidget","isInterrupt","value","isWidget","z","buildFlowProtocol","_config","resolveNextNode","edge","state","buildWidgetMeta","widgetId","openaiTemplateUri","mcpTemplateUri","executeFrom","startNodeName","initialState","nodes","edges","flowId","meta","currentNode","MAX_ITERATIONS","iterations","END","handler","result","isInterrupt","isWidget","error","message","inputSchema","z","compileFlow","input","config","protocol","fullDescription","handleToolCall","args","startEdge","START","firstNode","updatedState","nextNode","server","extra","_meta","StateGraph","config","name","handler","START","END","from","to","condition","options","compileFlow","startEdge","edge","createFlow","config","StateGraph","MIME_TYPE_OPENAI","MIME_TYPE_MCP","fetchHtml","baseUrl","path","normalizedBase","buildOpenAIResourceMeta","config","buildMcpAppsResourceMeta","csp","buildToolMeta","createWidget","handler","id","title","description","widgetDescription","htmlPath","inputSchema","invoking","invoked","widgetDomain","prefersBorder","autoHeight","widgetCSP","annotations","uiDescription","openaiTemplateUri","mcpTemplateUri","server","html","toolMeta","uri","args","extra","_meta","result","registerWidgets","widgets","w"]}