@waniwani/sdk 0.1.20-beta.8 → 0.2.1

package/dist/mcp/index.d.ts

@@ -1,3 +1,4 @@
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
 import { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -112,23 +113,11 @@ declare global {
 /**
  * Result from calling a tool
  */
-type ToolCallResult = {
-    content?: Array<{
-        type: string;
-        text?: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-};
+type ToolCallResult = CallToolResult;
 /**
  * Tool result notification (what the host pushes to the widget)
  */
-type ToolResult = {
-    content?: Array<{
-        type: string;
-        text?: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-};
+type ToolResult = CallToolResult;
 /**
  * Host context - all values available from the host.
  */
@@ -245,14 +234,14 @@ interface UnifiedWidgetClient {
     onMaxHeightChange(callback: (maxHeight: number | null) => void): () => void;
     /**
      * Get the tool response metadata.
-     * OpenAI-only: returns metadata from window.openai.toolResponseMetadata.
-     * MCP Apps: returns null.
+     * OpenAI: returns metadata from window.openai.toolResponseMetadata.
+     * MCP Apps: returns `_meta` from the latest `ui/notifications/tool-result`, if provided by host.
      */
     getToolResponseMetadata(): UnknownObject | null;
     /**
      * Subscribe to tool response metadata changes.
-     * OpenAI-only: subscribes to toolResponseMetadata changes.
-     * MCP Apps: callback is never called.
+     * OpenAI: subscribes to toolResponseMetadata changes.
+     * MCP Apps: fires when tool result `_meta` changes.
      */
     onToolResponseMetadataChange(callback: (metadata: UnknownObject | null) => void): () => void;
     /**
@@ -316,15 +305,26 @@ declare const START: "__start__";
 declare const END: "__end__";
 declare const INTERRUPT: unique symbol;
 declare const WIDGET: unique symbol;
-type InterruptSignal = {
-    readonly __type: typeof INTERRUPT;
+/** A single question within an interrupt step */
+type InterruptQuestion = {
     /** 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[];
-    /** Hidden context/instructions for the assistant (not shown to user directly) */
+    /** Hidden context/instructions for this specific question (not shown to user directly) */
+    context?: string;
+};
+/**
+ * Interrupt signal — pauses the flow and asks the user one or more questions.
+ * Single-question and multi-question interrupts use the same type.
+ */
+type InterruptSignal = {
+    readonly __type: typeof INTERRUPT;
+    /** Questions to ask — ask all in one conversational message */
+    questions: InterruptQuestion[];
+    /** Overall hidden context/instructions for the assistant (not shown to user directly) */
     context?: string;
 };
 type WidgetSignal = {
@@ -335,36 +335,79 @@ type WidgetSignal = {
     data: Record<string, unknown>;
     /** Description of what the widget does (for the AI's context) */
     description?: string;
+    /**
+     * State key this widget fills — enables auto-skip when the field is already in state.
+     * Pass this so the engine can skip the widget step when the answer is already known.
+     */
+    field?: string;
 };
 /**
- * Create an interrupt signal — pauses the flow and asks the user a text question.
+ * Create an interrupt signal — pauses the flow and asks the user a question.
+ *
+ * Accepts a single question (shorthand) or multiple questions (array form).
+ * Both produce the same signal type.
+ *
+ * @example Single question
+ * ```ts
+ * return interrupt({ question: "Your email?", field: "email" })
+ * ```
+ *
+ * @example Multiple questions (asked together in one message)
+ * ```ts
+ * return interrupt({ questions: [
+ *   { question: "How many employees?", field: "headcount" },
+ *   { question: "Average age?", field: "averageAge" },
+ * ]})
+ * ```
  */
 declare function interrupt(config: {
     question: string;
     field: string;
     suggestions?: string[];
     context?: string;
+} | {
+    questions: InterruptQuestion[];
+    context?: string;
 }): InterruptSignal;
 /**
  * Create a widget signal — pauses the flow and renders a widget UI.
+ *
+ * Pass `field` to enable auto-skip: if the field is already in state, the widget
+ * step will be skipped automatically.
  */
 declare function showWidget(resource: RegisteredResource, config: {
     data: Record<string, unknown>;
     description?: string;
+    field?: string;
 }): WidgetSignal;
 type MaybePromise<T> = T | Promise<T>;
-/** Configuration for a flow node */
+/**
+ * Optional config for handler-based nodes.
+ * Provides metadata used by the engine (e.g., auto-skip on widget steps).
+ *
+ * For declarative nodes, config is inferred automatically — no need to pass this.
+ */
 type NodeConfig<TState extends Record<string, unknown> = Record<string, unknown>> = {
-    /** Resource to display when this node returns a WidgetSignal */
-    resource?: RegisteredResource;
-    /** State key this node fills — enables auto-skip when the field is already in state via `initialState` */
+    /**
+     * State key this node fills.
+     * When set on a handler-based widget node and the field is already in state,
+     * the node is auto-skipped. (Alternatively, pass `field` to `showWidget()`.)
+     */
     field?: Extract<keyof TState, string>;
+    /**
+     * Mark this node as conversational — the AI will engage in back-and-forth
+     * conversation before advancing to the next node.
+     *
+     * - `true` — generic conversational behavior
+     * - `string` — specific guidance for the AI (e.g., "Help the user compare plans")
+     */
+    conversational?: boolean | string;
 };
 /**
  * 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)
+ * - `InterruptSignal` → interrupt (pause, ask user one or more questions)
  * - `WidgetSignal` → widget step (pause, show widget)
  */
 type NodeHandler<TState> = (state: Partial<TState>, meta?: Record<string, unknown>) => MaybePromise<Partial<TState> | InterruptSignal | WidgetSignal>;
@@ -388,7 +431,7 @@ type FlowConfig = {
      * The state definition serves two purposes:
      * 1. Type inference — `TState` is automatically derived, no explicit generic needed
      * 2. AI protocol — field names, types, and descriptions are included in the tool
-     *    description so the AI can pre-fill answers via `initialState`
+     *    description so the AI can pre-fill answers via `_meta.flow.state`
      *
      * @example
      * ```ts
@@ -445,7 +488,7 @@ type RegisteredFlow = {
  *   title: "User Onboarding",
  *   description: "Guides users through onboarding",
  * })
- *   .addNode("ask_name", () => interrupt({ question: "What's your name?", field: "name" }))
+ *   .addNode("ask_name", (state) => interrupt({ question: "What's your name?", field: "name" }))
  *   .addNode("greet", (state) => ({ greeting: `Hello ${state.name}!` }))
  *   .addEdge(START, "ask_name")
  *   .addEdge("ask_name", "greet")
@@ -464,7 +507,8 @@ declare class StateGraph<TState extends Record<string, unknown>> {
      */
     addNode(name: string, handler: NodeHandler<TState>): this;
     /**
-     * Add a node with config (e.g., resource, field) and a handler.
+     * Add a node with config and a handler.
+     * Pass `field` to enable auto-skip on widget nodes.
      */
     addNode(name: string, config: NodeConfig<TState>, handler: NodeHandler<TState>): this;
     /**
@@ -621,4 +665,310 @@ declare function createTool<TInput extends z.ZodRawShape>(config: ToolConfig<TIn
  */
 declare function registerTools(server: McpServer, tools: RegisteredTool[]): Promise<void>;
 
-export { type ConditionFn, END, type FlowConfig, type HostContext, type InferFlowState, type InterruptSignal, type NodeConfig, type NodeHandler, type RegisteredFlow, type RegisteredResource, type RegisteredTool, type ResourceConfig, START, StateGraph, type ToolCallResult, type ToolConfig, type ToolHandler, type ToolHandlerContext, type ToolResult, type ToolToolCallback, type UnifiedWidgetClient, type WidgetCSP, type WidgetPlatform, type WidgetSignal, createFlow, createResource, createTool, detectPlatform, interrupt, isMCPApps, isOpenAI, registerTools, showWidget };
+/**
+ * Server-side API route handler for widget tracking events.
+ *
+ * Receives batched events from the `useWaniwani` React hook and forwards them
+ * to the WaniWani backend using the server-side SDK.
+ *
+ * @example Next.js App Router
+ * ```typescript
+ * // app/api/waniwani/track/route.ts
+ * import { createTrackingRoute } from "@waniwani/sdk/mcp";
+ *
+ * const handler = createTrackingRoute({
+ *   apiKey: process.env.WANIWANI_API_KEY,
+ *   baseUrl: process.env.WANIWANI_BASE_URL,
+ * });
+ *
+ * export { handler as POST };
+ * ```
+ */
+interface TrackingRouteOptions {
+    /** API key for the WaniWani backend. Defaults to WANIWANI_API_KEY env var. */
+    apiKey?: string;
+    /** Base URL for the WaniWani backend. Defaults to https://app.waniwani.ai. */
+    baseUrl?: string;
+}
+/**
+ * Creates a POST handler that receives tracking events from `useWaniwani`
+ * and forwards them to the WaniWani backend.
+ */
+declare function createTrackingRoute(options?: TrackingRouteOptions): (request: Request) => Promise<Response>;
+
+interface SearchResult {
+    source: string;
+    heading: string;
+    content: string;
+    score: number;
+}
+/** A file to ingest into the knowledge base */
+interface KbIngestFile {
+    /** Filename (used as chunk source identifier) */
+    filename: string;
+    /** Markdown content of the file */
+    content: string;
+}
+/** Response from the ingest endpoint */
+interface KbIngestResult {
+    /** Number of chunks created from the ingested files */
+    chunksIngested: number;
+    /** Number of files successfully processed */
+    filesProcessed: number;
+}
+/** Options for the search method */
+interface KbSearchOptions {
+    /** Number of results to return (1-20, default 5) */
+    topK?: number;
+    /** Minimum similarity score threshold (0-1, default 0.3) */
+    minScore?: number;
+}
+/** A source entry in the knowledge base */
+interface KbSource {
+    /** Source filename */
+    source: string;
+    /** Number of chunks from this source */
+    chunkCount: number;
+    /** ISO timestamp of when the source was first ingested */
+    createdAt: string;
+}
+/** KB client for server-side knowledge base operations */
+interface KbClient {
+    /**
+     * Ingest files into the knowledge base.
+     *
+     * **Warning**: This is destructive — it deletes ALL existing chunks
+     * for the environment before ingesting the new files.
+     */
+    ingest(files: KbIngestFile[]): Promise<KbIngestResult>;
+    /** Search the knowledge base for relevant chunks */
+    search(query: string, options?: KbSearchOptions): Promise<SearchResult[]>;
+    /** List all sources in the knowledge base */
+    sources(): Promise<KbSource[]>;
+}
+
+type EventType = "session.started" | "tool.called" | "quote.requested" | "quote.succeeded" | "quote.failed" | "link.clicked" | "purchase.completed" | "widget_render" | "widget_click" | "widget_link_click" | "widget_error" | "widget_scroll" | "widget_form_field" | "widget_form_submit";
+interface ToolCalledProperties {
+    name?: string;
+    type?: "pricing" | "product_info" | "availability" | "support" | "other";
+}
+interface QuoteSucceededProperties {
+    amount?: number;
+    currency?: string;
+}
+interface LinkClickedProperties {
+    url?: string;
+}
+interface PurchaseCompletedProperties {
+    amount?: number;
+    currency?: string;
+}
+interface TrackingContext {
+    /**
+     * MCP request metadata passed through to the API.
+     *
+     * Location varies by MCP library:
+     * - `@vercel/mcp-handler`: `extra._meta`
+     * - `@modelcontextprotocol/sdk`: `request.params._meta`
+     */
+    meta?: Record<string, unknown>;
+    /** Legacy metadata field supported for backward compatibility. */
+    metadata?: Record<string, unknown>;
+    /** Optional explicit correlation fields. */
+    sessionId?: string;
+    traceId?: string;
+    requestId?: string;
+    correlationId?: string;
+    externalUserId?: string;
+    /** Optional explicit envelope fields. */
+    eventId?: string;
+    timestamp?: string | Date;
+    source?: string;
+}
+/**
+ * Modern tracking shape (preferred).
+ */
+interface BaseTrackEvent extends TrackingContext {
+    event: EventType;
+    properties?: Record<string, unknown>;
+}
+type TrackEvent = ({
+    event: "session.started";
+} & BaseTrackEvent) | ({
+    event: "tool.called";
+    properties?: ToolCalledProperties;
+} & BaseTrackEvent) | ({
+    event: "quote.requested";
+} & BaseTrackEvent) | ({
+    event: "quote.succeeded";
+    properties?: QuoteSucceededProperties;
+} & BaseTrackEvent) | ({
+    event: "quote.failed";
+} & BaseTrackEvent) | ({
+    event: "link.clicked";
+    properties?: LinkClickedProperties;
+} & BaseTrackEvent) | ({
+    event: "purchase.completed";
+    properties?: PurchaseCompletedProperties;
+} & BaseTrackEvent);
+/**
+ * Legacy tracking shape supported for existing integrations.
+ */
+interface LegacyTrackEvent extends TrackingContext {
+    eventType: EventType;
+    properties?: Record<string, unknown>;
+    toolName?: string;
+    toolType?: ToolCalledProperties["type"];
+    quoteAmount?: number;
+    quoteCurrency?: string;
+    linkUrl?: string;
+    purchaseAmount?: number;
+    purchaseCurrency?: string;
+}
+/**
+ * Public track input accepted by `client.track()`.
+ */
+type TrackInput = TrackEvent | LegacyTrackEvent;
+interface TrackingConfig {
+    /** Events API V2 endpoint path. */
+    endpointPath?: string;
+    /** Periodic flush interval for buffered events. */
+    flushIntervalMs?: number;
+    /** Max events per HTTP batch send. */
+    maxBatchSize?: number;
+    /** Max in-memory buffer size before oldest items are dropped. */
+    maxBufferSize?: number;
+    /** Number of retries for retryable failures. */
+    maxRetries?: number;
+    /** Retry backoff base delay. */
+    retryBaseDelayMs?: number;
+    /** Retry backoff max delay. */
+    retryMaxDelayMs?: number;
+    /** Default shutdown timeout when none is provided. */
+    shutdownTimeoutMs?: number;
+}
+interface TrackingShutdownOptions {
+    timeoutMs?: number;
+}
+interface TrackingShutdownResult {
+    timedOut: boolean;
+    pendingEvents: number;
+}
+/**
+ * Tracking module methods for WaniWaniClient.
+ */
+interface TrackingClient {
+    /**
+     * Track an event using modern or legacy input shape.
+     * Returns a deterministic event id immediately after enqueue.
+     */
+    track: (event: TrackInput) => Promise<{
+        eventId: string;
+    }>;
+    /**
+     * Flush all currently buffered events.
+     */
+    flush: () => Promise<void>;
+    /**
+     * Flush and stop the transport.
+     */
+    shutdown: (options?: TrackingShutdownOptions) => Promise<TrackingShutdownResult>;
+}
+
+interface WaniWaniConfig {
+    /**
+     * Your MCP environment API key
+     *
+     * Defaults to process.env.WANIWANI_API_KEY if not provided
+     *
+     * To create one, visit:
+     * https://app.waniwani.com/mcp/environments
+     */
+    apiKey?: string;
+    /**
+     * The base URL of the WaniWani API
+     *
+     * Defaults to https://app.waniwani.ai
+     */
+    baseUrl?: string;
+    /**
+     * Tracking transport behavior.
+     */
+    tracking?: TrackingConfig;
+}
+/**
+ * WaniWani SDK Client
+ *
+ * Extends with each module:
+ * - TrackingClient: track(), flush(), shutdown()
+ *
+ * Pass this client to framework adapters:
+ * - `toNextJsHandler(wani, { ... })` for Next.js route handlers
+ */
+interface WaniWaniClient extends TrackingClient {
+    /** @internal Resolved config — used by framework adapters */
+    readonly _config: InternalConfig;
+    /** Knowledge base client for ingestion, search, and source listing */
+    readonly kb: KbClient;
+}
+interface InternalConfig {
+    baseUrl: string;
+    apiKey: string | undefined;
+    tracking: Required<TrackingConfig>;
+}
+
+type WaniwaniTracker = Pick<WaniWaniClient, "flush" | "track" | "_config">;
+type UnknownRecord = Record<string, unknown>;
+/**
+ * Options for withWaniwani().
+ */
+type WithWaniwaniOptions = {
+    /**
+     * Optional pre-built WaniWani client.
+     * When omitted, a new client is created from `config`.
+     */
+    client?: WaniwaniTracker;
+    /**
+     * WaniWani client config used when `client` is omitted.
+     */
+    config?: WaniWaniConfig;
+    /**
+     * Optional explicit tool type. Defaults to `"other"`.
+     */
+    toolType?: ToolCalledProperties["type"] | ((toolName: string) => ToolCalledProperties["type"] | undefined);
+    /**
+     * Optional metadata merged into every tracked event.
+     */
+    metadata?: UnknownRecord;
+    /**
+     * Flush tracking transport after each tool call.
+     */
+    flushAfterToolCall?: boolean;
+    /**
+     * Optional error callback for non-fatal tracking errors.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Inject widget tracking config into tool response `_meta.waniwani` so browser
+     * widgets can send events directly to the WaniWani backend.
+     *
+     * Always injects `endpoint`. Injects `token` when an API key is configured
+     * and token minting succeeds.
+     *
+     * @default true
+     */
+    injectWidgetToken?: boolean;
+};
+/**
+ * Wrap an MCP server so tool handlers automatically emit `tool.called` events.
+ *
+ * The wrapper intercepts `server.registerTool(...)`, tracks each invocation,
+ * then forwards execution to the original tool handler.
+ *
+ * When `injectWidgetToken` is enabled (default), tracking config is injected
+ * into tool response `_meta.waniwani` so browser widgets can post events
+ * directly to the WaniWani backend without a server-side proxy.
+ */
+declare function withWaniwani(server: McpServer, options?: WithWaniwaniOptions): McpServer;
+
+export { type ConditionFn, END, type FlowConfig, type HostContext, type InferFlowState, type InterruptSignal, type NodeConfig, type NodeHandler, type RegisteredFlow, type RegisteredResource, type RegisteredTool, type ResourceConfig, START, StateGraph, type ToolCallResult, type ToolConfig, type ToolHandler, type ToolHandlerContext, type ToolResult, type ToolToolCallback, type TrackingRouteOptions, type UnifiedWidgetClient, type WidgetCSP, type WidgetPlatform, type WidgetSignal, type WithWaniwaniOptions, createFlow, createResource, createTool, createTrackingRoute, detectPlatform, interrupt, isMCPApps, isOpenAI, registerTools, showWidget, withWaniwani };

package/dist/mcp/index.js

@@ -1,4 +1,4 @@
-function P(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function j(){return P()==="openai"}function J(){return P()==="mcp-apps"}var x="__start__",R="__end__",I=Symbol.for("waniwani.flow.interrupt"),F=Symbol.for("waniwani.flow.widget");function O(e){return{__type:I,...e}}function $(e,t){return{__type:F,resource:e,...t}}function M(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===I}function H(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===F}import{z as h}from"zod";var v="text/html+skybridge",E="text/html;profile=mcp-app",A=async(e,t)=>{let o=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${o}${t}`)).text()};function D(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function W(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 C(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 B(e){let t=e.description??"",o=e._zod?.def;if(o?.type==="enum"&&o.entries){let s=Object.keys(o.entries).map(d=>`"${d}"`).join(" | ");return t?`${s} \u2014 ${t}`:s}return t}function L(e){let t=["","## FLOW EXECUTION PROTOCOL","","This tool implements a multi-step conversational flow. Follow this protocol exactly:","",'1. Call with `action: "start"` to begin. If the user\'s message already',"   contains answers to likely questions, extract them into `initialState`","   as `{ field: value }` pairs. The engine will auto-skip questions whose","   fields are already filled.","   Only extract values the user explicitly stated \u2014 do NOT guess or invent values."];if(e.state){let o=Object.entries(e.state).map(([s,d])=>{let f=B(d);return f?`\`${s}\` (${f})`:`\`${s}\``}).join(", ");t.push(`   Known fields: ${o}.`)}return t.push("2. The response JSON `status` field tells you what to do next:",'   - `"interrupt"`: Ask the user the `question` to collect the `field` value.',"     If a `context` field is present, use it as hidden instructions to enrich your response (do NOT show it verbatim).","     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. The `field` property tells you',"     which state field this step collects. When the user makes a choice, call again with:",'     `action: "widget_result"`, `step` = the returned `step`, `state` = the returned `state`,',"     `answer` = the user's selection.",'   - `"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 invent state values. Only use `initialState` for information the user explicitly provided."),t.join(`
-`)}async function N(e,t){return e.type==="direct"?e.to:e.condition(t)}async function b(e,t,o,s,d,f,S){let r=e,p={...t},m=50,n=0;for(;n++<m;){if(r===R)return{text:JSON.stringify({status:"complete",state:p}),data:{status:"complete",state:p}};let g=o.get(r);if(!g)return{text:JSON.stringify({status:"error",error:`Unknown node: "${r}"`}),data:{status:"error"}};try{let a=await g(p,S);if(M(a)){let i=p[a.field];if(i!=null&&i!==""){let l=d.get(r);if(!l)return{text:JSON.stringify({status:"error",error:`No outgoing edge from node "${r}"`}),data:{status:"error"}};r=await N(l,p);continue}return{text:JSON.stringify({status:"interrupt",step:r,question:a.question,field:a.field,suggestions:a.suggestions,...a.context?{context:a.context}:{},state:p}),data:{status:"interrupt",step:r,state:p}}}if(H(a)){let i=s.get(r)?.field;if(i){let u=p[i];if(u!=null&&u!==""){let w=d.get(r);if(!w)return{text:JSON.stringify({status:"error",error:`No outgoing edge from node "${r}"`}),data:{status:"error"}};r=await N(w,p);continue}}let l=a.resource;return{text:JSON.stringify({status:"widget",step:r,...i?{field:i}:{},widgetId:l.id,description:a.description,state:p}),data:{...a.data,__flow:{flowId:f,step:r,state:p}},widgetMeta:C({openaiTemplateUri:l.openaiUri,mcpTemplateUri:l.mcpUri,invoking:"Loading...",invoked:"Loaded",autoHeight:l.autoHeight})}}p={...p,...a};let c=d.get(r);if(!c)return{text:JSON.stringify({status:"error",error:`No outgoing edge from node "${r}"`}),data:{status:"error"}};r=await N(c,p)}catch(a){let c=a instanceof Error?a.message:String(a);return{text:JSON.stringify({status:"error",step:r,error:c,state:p}),data:{status:"error",error:c}}}}return{text:JSON.stringify({status:"error",error:"Flow exceeded maximum iterations (possible infinite loop)"}),data:{status:"error"}}}var Y={action:h.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:h.string().optional().describe("Current step name (from the previous response)"),state:h.record(h.string(),h.unknown()).optional().describe("Flow state \u2014 pass back exactly as received"),answer:h.string().optional().describe("The user's answer (for interrupt steps)"),widgetResult:h.record(h.string(),h.unknown()).optional().describe("Data returned by a widget callback"),initialState:h.record(h.string(),h.unknown()).optional().describe(`Pre-filled answers extracted from the user's message (only for action: "start")`)};function U(e){let{config:t,nodes:o,nodeConfigs:s,edges:d}=e,f=L(t),S=`${t.description}
-${f}`,r;for(let n of s.values())if(n.resource){r=n.resource;break}let p=r?C({openaiTemplateUri:r.openaiUri,mcpTemplateUri:r.mcpUri,invoking:"Loading...",invoked:"Loaded",autoHeight:r.autoHeight}):void 0;async function m(n,g){let a=n.state??{};if(n.action==="start"){let c=d.get(x);if(!c)return{text:JSON.stringify({status:"error",error:"No start edge"}),data:{status:"error"}};let i=n.initialState?{...a,...n.initialState}:a,l=await N(c,i);return b(l,i,o,s,d,t.id,g)}if(n.action==="continue"){if(!n.step)return{text:JSON.stringify({status:"error",error:'Missing "step" for continue action'}),data:{status:"error"}};let c={...a};if(n.answer){let u=o.get(n.step);if(u)try{let w=await u(c,g);M(w)&&w.field&&(c={...c,[w.field]:n.answer})}catch{}}let i=d.get(n.step);if(!i)return{text:JSON.stringify({status:"error",error:`No edge from step "${n.step}"`}),data:{status:"error"}};let l=await N(i,c);return b(l,c,o,s,d,t.id,g)}if(n.action==="widget_result"){if(!n.step)return{text:JSON.stringify({status:"error",error:'Missing "step" for widget_result action'}),data:{status:"error"}};let c=n.widgetResult??{};if(n.answer!==void 0&&Object.keys(c).length===0){let w=s.get(n.step)?.field;w&&(c={[w]:n.answer})}let i={...a,...c},l=d.get(n.step);if(!l)return{text:JSON.stringify({status:"error",error:`No edge from step "${n.step}"`}),data:{status:"error"}};let u=await N(l,i);return b(u,i,o,s,d,t.id,g)}return{text:JSON.stringify({status:"error",error:`Unknown action: "${n.action}"`}),data:{status:"error"}}}return{id:t.id,title:t.title,description:S,async register(n){n.registerTool(t.id,{title:t.title,description:S,inputSchema:Y,annotations:t.annotations,...p&&{_meta:p}},(async(g,a)=>{let i=a._meta??{},l=await m(g,i);return l.widgetMeta?{content:[{type:"text",text:l.text}],structuredContent:l.data,_meta:{...l.widgetMeta,...i}}:{content:[{type:"text",text:l.text}]}}))}}}var k=class{nodes=new Map;nodeConfigs=new Map;edges=new Map;config;constructor(t){this.config=t}addNode(t,o,s){if(t===x||t===R)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`);let d,f={};if(typeof o=="function")d=o;else{if(!s)throw new Error(`addNode("${t}", config, handler) requires a handler as the third argument`);d=s,f=o}return this.nodes.set(t,d),this.nodeConfigs.set(t,f),this}addEdge(t,o){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:o}),this}addConditionalEdge(t,o){if(this.edges.has(t))throw new Error(`Node "${t}" already has an outgoing edge.`);return this.edges.set(t,{type:"conditional",condition:o}),this}compile(){return this.validate(),U({config:this.config,nodes:new Map(this.nodes),nodeConfigs:new Map(this.nodeConfigs),edges:new Map(this.edges)})}validate(){if(!this.edges.has(x))throw new Error('Flow must have an entry point. Add an edge from START: .addEdge(START, "first_node")');let t=this.edges.get(x);if(t?.type==="direct"&&t.to!==R&&!this.nodes.has(t.to))throw new Error(`START edge references non-existent node: "${t.to}"`);for(let[o,s]of this.edges){if(o!==x&&!this.nodes.has(o))throw new Error(`Edge from non-existent node: "${o}"`);if(s.type==="direct"&&s.to!==R&&!this.nodes.has(s.to))throw new Error(`Edge from "${o}" references non-existent node: "${s.to}"`)}for(let[o]of this.nodes)if(!this.edges.has(o))throw new Error(`Node "${o}" has no outgoing edge. Add one with .addEdge("${o}", ...) or .addConditionalEdge("${o}", ...)`)}};function q(e){return new k(e)}function z(e){let{id:t,title:o,description:s,baseUrl:d,htmlPath:f,widgetDomain:S,prefersBorder:r=!0,autoHeight:p=!0}=e,m=e.widgetCSP??{connect_domains:[d],resource_domains:[d]};if(process.env.NODE_ENV==="development")try{let{hostname:u}=new URL(d);(u==="localhost"||u==="127.0.0.1")&&(m={...m,connect_domains:[...m.connect_domains||[],`ws://${u}:*`,`wss://${u}:*`],resource_domains:[...m.resource_domains||[],`http://${u}:*`]})}catch{}let n=`ui://widgets/apps-sdk/${t}.html`,g=`ui://widgets/ext-apps/${t}.html`,a=null,c=()=>(a||(a=A(d,f)),a),i=s;async function l(u){let w=await c();u.registerResource(`${t}-openai-widget`,n,{title:o,description:i,mimeType:v,_meta:{"openai/widgetDescription":i,"openai/widgetPrefersBorder":r}},async _=>({contents:[{uri:_.href,mimeType:v,text:w,_meta:D({description:i,prefersBorder:r,widgetDomain:S,widgetCSP:m})}]})),u.registerResource(`${t}-mcp-widget`,g,{title:o,description:i,mimeType:E,_meta:{ui:{prefersBorder:r}}},async _=>({contents:[{uri:_.href,mimeType:E,text:w,_meta:W({description:i,prefersBorder:r,widgetCSP:m})}]}))}return{id:t,title:o,description:s,openaiUri:n,mcpUri:g,autoHeight:p,register:l}}function Z(e,t){let{resource:o,description:s,inputSchema:d,annotations:f}=e,S=e.id??o?.id,r=e.title??o?.title;if(!S)throw new Error("createTool: `id` is required when no resource is provided");if(!r)throw new Error("createTool: `title` is required when no resource is provided");let p=o?C({openaiTemplateUri:o.openaiUri,mcpTemplateUri:o.mcpUri,invoking:e.invoking??"Loading...",invoked:e.invoked??"Loaded",autoHeight:o.autoHeight}):void 0;return{id:S,title:r,description:s,async register(m){m.registerTool(S,{title:r,description:s,inputSchema:d,annotations:f,...p&&{_meta:p}},(async(n,g)=>{let c=g._meta??{},i=await t(n,{extra:{_meta:c}});return o&&i.data?{content:[{type:"text",text:i.text}],structuredContent:i.data,_meta:{...p,...c}}:{content:[{type:"text",text:i.text}]}}))}}}async function G(e,t){await Promise.all(t.map(o=>o.register(e)))}export{R as END,x as START,k as StateGraph,q as createFlow,z as createResource,Z as createTool,P as detectPlatform,O as interrupt,J as isMCPApps,j as isOpenAI,G as registerTools,$ as showWidget};
+function U(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function ge(){return U()==="openai"}function he(){return U()==="mcp-apps"}var v="__start__",E="__end__",B=Symbol.for("waniwani.flow.interrupt"),H=Symbol.for("waniwani.flow.widget");function z(e){if("questions"in e)return{__type:B,questions:e.questions,context:e.context};let{question:t,field:n,context:r,suggestions:o}=e;return{__type:B,questions:[{question:t,field:n,context:r,suggestions:o}]}}function K(e,t){return{__type:H,resource:e,...t}}function Y(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===B}function X(e){return typeof e=="object"&&e!==null&&"__type"in e&&e.__type===H}import{z as I}from"zod";var C="text/html+skybridge",_="text/html;profile=mcp-app",J=async(e,t)=>{let n=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${n}${t}`)).text()};function Z(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function G(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 R(e){return{...e.openaiTemplateUri&&{"openai/outputTemplate":e.openaiTemplateUri},"openai/toolInvocation/invoking":e.invoking,"openai/toolInvocation/invoked":e.invoked,"openai/widgetAccessible":!0,"openai/resultCanProduceWidget":!0,...e.mcpTemplateUri&&{ui:{resourceUri:e.mcpTemplateUri,...e.autoHeight&&{autoHeight:!0}}}}}function Q(e){let t=JSON.stringify(e);return typeof Buffer<"u"?Buffer.from(t,"utf-8").toString("base64"):btoa(t)}function ee(e){try{let t;return typeof Buffer<"u"?t=Buffer.from(e,"base64").toString("utf-8"):t=atob(e),JSON.parse(t)}catch{return null}}function me(e){let t=e.description??"",n=e._zod?.def;if(n?.type==="enum"&&n.entries){let r=Object.keys(n.entries).map(o=>`"${o}"`).join(" | ");return t?`${r} \u2014 ${t}`:r}return t}function we(e){let t=["","## FLOW EXECUTION PROTOCOL","","This tool implements a multi-step conversational flow. Follow this protocol exactly:","",'1. Call with `action: "start"` to begin. If the user\'s message already',"   contains answers to likely questions, extract them into `stateUpdates`","   as `{ field: value }` pairs. The engine will auto-skip steps whose","   fields are already filled.","   Only extract values the user explicitly stated \u2014 do NOT guess or invent values."];if(e.state){let n=Object.entries(e.state).map(([r,o])=>{let a=me(o);return a?`\`${r}\` (${a})`:`\`${r}\``}).join(", ");t.push(`   Known fields: ${n}.`)}return t.push("2. The response JSON `status` field tells you what to do next:",'   - `"interrupt"`: Pause and ask the user. Two forms:',"     a. Single question: `{ question, field, context? }` \u2014 ask `question`, store answer in `field`.","     b. Multi-question: `{ questions: [{question, field}, ...], context? }` \u2014 ask ALL questions","        in one conversational message, collect all answers.","     `context` (if present) is hidden AI instructions \u2014 use to shape your response, do NOT show verbatim.","     Then call again with:",'     `action: "continue"`, `flowToken` = the `flowToken` from the response (pass back exactly as received),',"     `stateUpdates` = answers keyed by their `field` names, plus any other fields the user mentioned.",'   - `"widget"`: A widget UI is being shown. The user will interact with the widget.',"     When the user makes a choice, call again with:",'     `action: "continue"`, `flowToken` = the `flowToken` from the response,',"     `stateUpdates` = `{ [field]: <user's selection> }` plus any other fields the user mentioned.",'   - `"complete"`: The flow is done. Present the result to the user.','   - `"error"`: Something went wrong. Show the `error` message.',"","3. ALWAYS pass back the `flowToken` string exactly as received \u2014 it is an opaque token, do not modify it.","4. Do NOT invent state values. Only use `stateUpdates` for information the user explicitly provided.","5. Include only the fields the user actually answered in `stateUpdates` \u2014 do NOT guess missing ones.","   If the user did not answer all pending questions, the engine will re-prompt for the remaining ones.","   If the user mentioned values for other known fields, include those too \u2014","   they will be applied immediately and those steps will be auto-skipped.",'6. CONVERSATIONAL STEPS: When a response includes a `"conversational"` field:',"   - Do NOT immediately call `continue`. Instead, engage in back-and-forth conversation.","   - The user may ask follow-up questions, explore options, or request changes.",'   - Only call `action: "continue"` when the user explicitly wants to move on',`     (e.g., "looks good", "let's continue", "I'll go with X", or selects an option).`,"   - If `conversational` is a string, use it as guidance for what topics to discuss.","   - While conversing, do NOT call the tool \u2014 just respond naturally to the user."),t.join(`
+`)}function ye(e){if(e.flowToken){let t=ee(e.flowToken);if(t)return t}return{step:void 0,state:{}}}async function M(e,t){return e.type==="direct"?e.to:e.condition(t)}function q(e){return e!=null&&e!==""}function te(e,t,n,r,o){if(e.every(f=>q(r[f.field])))return null;let a=e.filter(f=>!q(r[f.field])),i=a.length===1,s=a[0],d=o?typeof o=="string"?o:!0:void 0;return{payload:i&&s?{status:"interrupt",question:s.question,field:s.field,...s.suggestions?{suggestions:s.suggestions}:{},...s.context||t?{context:s.context??t}:{},...d?{conversational:d}:{}}:{status:"interrupt",questions:a,...t?{context:t}:{},...d?{conversational:d}:{}},flowMeta:{step:n,state:r,...i&&s?{field:s.field}:{},questions:e,...t?{interruptContext:t}:{}}}}async function O(e,t,n,r,o,a){let i=e,s={...t},d=50,g=0;for(;g++<d;){if(i===E)return{payload:{status:"complete"},flowMeta:{state:s}};let f=n.get(i);if(!f)return{payload:{status:"error",error:`Unknown node: "${i}"`}};try{let c=await f(s,a);if(Y(c)){let l=te(c.questions,c.context,i,s,r.get(i)?.conversational);if(l)return l;let p=o.get(i);if(!p)return{payload:{status:"error",error:`No outgoing edge from node "${i}"`}};i=await M(p,s);continue}if(X(c)){let l=c.field??r.get(i)?.field;if(l&&q(s[l])){let w=o.get(i);if(!w)return{payload:{status:"error",error:`No outgoing edge from node "${i}"`}};i=await M(w,s);continue}let p=c.resource,T=r.get(i)?.conversational;return{payload:{status:"widget",description:c.description,...T?{conversational:typeof T=="string"?T:!0}:{}},data:c.data,widgetMeta:R({openaiTemplateUri:p.openaiUri,mcpTemplateUri:p.mcpUri,invoking:"Loading...",invoked:"Loaded",autoHeight:p.autoHeight}),flowMeta:{step:i,state:s,field:l,widgetId:p.id}}}s={...s,...c};let u=o.get(i);if(!u)return{payload:{status:"error",error:`No outgoing edge from node "${i}"`}};i=await M(u,s)}catch(c){return{payload:{status:"error",error:c instanceof Error?c.message:String(c)},flowMeta:{step:i,state:s}}}}return{payload:{status:"error",error:"Flow exceeded maximum iterations (possible infinite loop)"}}}var Te={action:I.enum(["start","continue"]).describe('"start" to begin the flow, "continue" to resume after a pause (interrupt or widget)'),stateUpdates:I.record(I.string(),I.unknown()).optional().describe("State field values to set before processing the next node. Use this to pass the user's answer (keyed by the field name from the response) and any other values the user mentioned."),flowToken:I.string().optional().describe("Opaque flow token from the previous response. Pass back exactly as received.")};function ne(e){let{config:t,nodes:n,nodeConfigs:r,edges:o}=e,a=we(t),i=`${t.description}
+${a}`;async function s(d,g){let f=ye(d),c=f.state;if(d.action==="start"){let u=o.get(v);if(!u)return{payload:{status:"error",error:"No start edge"}};let l={...c,...d.stateUpdates??{}},p=await M(u,l);return O(p,l,n,r,o,g)}if(d.action==="continue"){let u=f.step;if(!u)return{payload:{status:"error",error:'Missing "_meta.flow.step" for continue action'}};let l={...c,...d.stateUpdates??{}};if(f.questions){let p=te(f.questions,f.interruptContext,u,l,r.get(u)?.conversational);if(p)return p}if(f.questions||f.widgetId){let p=o.get(u);if(!p)return{payload:{status:"error",error:`No edge from step "${u}"`}};let T=await M(p,l);return O(T,l,n,r,o,g)}return O(u,l,n,r,o,g)}return{payload:{status:"error",error:`Unknown action: "${d.action}"`}}}return{id:t.id,title:t.title,description:i,async register(d){d.registerTool(t.id,{title:t.title,description:i,inputSchema:Te,annotations:t.annotations},(async(g,f)=>{let u=f._meta??{},l=await s(g,u),p=l.flowMeta?Q({step:l.flowMeta.step??"",state:l.flowMeta.state,field:l.flowMeta.field,widgetId:l.flowMeta.widgetId,questions:l.flowMeta.questions,interruptContext:l.flowMeta.interruptContext}):void 0,T={...l.payload,...p?{flowToken:p,flowId:t.id}:{}},w=[{type:"text",text:JSON.stringify(T,null,2)}],S={...l.widgetMeta??{},...u};return l.widgetMeta?{content:w,structuredContent:l.data,_meta:S}:{content:w,...Object.keys(S).length>0?{_meta:S}:{}}}))}}}var x=class{nodes=new Map;nodeConfigs=new Map;edges=new Map;config;constructor(t){this.config=t}addNode(t,n,r){if(t===v||t===E)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`);let o,a={};if(typeof n=="function")o=n;else if(r)o=r,a=n;else throw new Error(`Node "${t}" requires a handler function.`);return this.nodes.set(t,o),this.nodeConfigs.set(t,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}compile(){return this.validate(),ne({config:this.config,nodes:new Map(this.nodes),nodeConfigs:new Map(this.nodeConfigs),edges:new Map(this.edges)})}validate(){if(!this.edges.has(v))throw new Error('Flow must have an entry point. Add an edge from START: .addEdge(START, "first_node")');let t=this.edges.get(v);if(t?.type==="direct"&&t.to!==E&&!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!==v&&!this.nodes.has(n))throw new Error(`Edge from non-existent node: "${n}"`);if(r.type==="direct"&&r.to!==E&&!this.nodes.has(r.to))throw new Error(`Edge from "${n}" references non-existent node: "${r.to}"`)}for(let[n]of this.nodes)if(!this.edges.has(n))throw new Error(`Node "${n}" has no outgoing edge. Add one with .addEdge("${n}", ...) or .addConditionalEdge("${n}", ...)`)}};function re(e){return new x(e)}function oe(e){let{id:t,title:n,description:r,baseUrl:o,htmlPath:a,widgetDomain:i,prefersBorder:s=!0,autoHeight:d=!0}=e,g=e.widgetCSP??{connect_domains:[o],resource_domains:[o]};if(process.env.NODE_ENV==="development")try{let{hostname:w}=new URL(o);(w==="localhost"||w==="127.0.0.1")&&(g={...g,connect_domains:[...g.connect_domains||[],`ws://${w}:*`,`wss://${w}:*`],resource_domains:[...g.resource_domains||[],`http://${w}:*`]})}catch{}let f=`ui://widgets/apps-sdk/${t}.html`,c=`ui://widgets/ext-apps/${t}.html`,u=null,l=()=>(u||(u=J(o,a)),u),p=r;async function T(w){let S=await l();w.registerResource(`${t}-openai-widget`,f,{title:n,description:p,mimeType:C,_meta:{"openai/widgetDescription":p,"openai/widgetPrefersBorder":s}},async k=>({contents:[{uri:k.href,mimeType:C,text:S,_meta:Z({description:p,prefersBorder:s,widgetDomain:i,widgetCSP:g})}]})),w.registerResource(`${t}-mcp-widget`,c,{title:n,description:p,mimeType:_,_meta:{ui:{prefersBorder:s}}},async k=>({contents:[{uri:k.href,mimeType:_,text:S,_meta:G({description:p,prefersBorder:s,widgetCSP:g})}]}))}return{id:t,title:n,description:r,openaiUri:f,mcpUri:c,autoHeight:d,register:T}}function ke(e,t){let{resource:n,description:r,inputSchema:o,annotations:a}=e,i=e.id??n?.id,s=e.title??n?.title;if(!i)throw new Error("createTool: `id` is required when no resource is provided");if(!s)throw new Error("createTool: `title` is required when no resource is provided");let d=n?R({openaiTemplateUri:n.openaiUri,mcpTemplateUri:n.mcpUri,invoking:e.invoking??"Loading...",invoked:e.invoked??"Loaded",autoHeight:n.autoHeight}):void 0;return{id:i,title:s,description:r,async register(g){g.registerTool(i,{title:s,description:r,inputSchema:o,annotations:a,...d&&{_meta:d}},(async(f,c)=>{let l=c._meta??{},p=await t(f,{extra:{_meta:l}});return n&&p.data?{content:[{type:"text",text:p.text}],structuredContent:p.data,_meta:{...d,...l}}:{content:[{type:"text",text:p.text}]}}))}}}async function Se(e,t){await Promise.all(t.map(n=>n.register(e)))}var P=class extends Error{constructor(n,r){super(n);this.status=r;this.name="WaniWaniError"}};var ve="@waniwani/sdk";function ie(e){let{baseUrl:t,apiKey:n}=e;function r(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}async function o(a,i,s){let d=r(),g=`${t.replace(/\/$/,"")}${i}`,f={Authorization:`Bearer ${d}`,"X-WaniWani-SDK":ve},c={method:a,headers:f};s!==void 0&&(f["Content-Type"]="application/json",c.body=JSON.stringify(s));let u=await fetch(g,c);if(!u.ok){let p=await u.text().catch(()=>"");throw new P(p||`KB API error: HTTP ${u.status}`,u.status)}return(await u.json()).data}return{async ingest(a){return o("POST","/api/mcp/kb/ingest",{files:a})},async search(a,i){return o("POST","/api/mcp/kb/search",{query:a,...i})},async sources(){return o("GET","/api/mcp/kb/sources")}}}var Ee="@waniwani/sdk";function j(e,t={}){let n=t.now??(()=>new Date),r=t.generateId??se,o=Ie(e),a=W(e.meta),i=W(e.metadata),s=Me(e,a),d=y(e.eventId)??r(),g=be(e.timestamp,n),f=y(e.source)??t.source??Ee,c=$(e)?{...e}:void 0,u={...i};return Object.keys(a).length>0&&(u.meta=a),c&&(u.rawLegacy=c),{id:d,type:"mcp.event",name:o,source:f,timestamp:g,correlation:s,properties:xe(e,o),metadata:u,rawLegacy:c}}function se(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?`evt_${crypto.randomUUID()}`:`evt_${Math.random().toString(36).slice(2,10)}_${Date.now().toString(36)}`}function xe(e,t){if(!$(e))return W(e.properties);let n=Re(e,t),r=W(e.properties);return{...n,...r}}function Re(e,t){switch(t){case"tool.called":{let n={};return y(e.toolName)&&(n.name=e.toolName),y(e.toolType)&&(n.type=e.toolType),n}case"quote.succeeded":{let n={};return typeof e.quoteAmount=="number"&&(n.amount=e.quoteAmount),y(e.quoteCurrency)&&(n.currency=e.quoteCurrency),n}case"link.clicked":{let n={};return y(e.linkUrl)&&(n.url=e.linkUrl),n}case"purchase.completed":{let n={};return typeof e.purchaseAmount=="number"&&(n.amount=e.purchaseAmount),y(e.purchaseCurrency)&&(n.currency=e.purchaseCurrency),n}default:return{}}}function Ie(e){return $(e)?e.eventType:e.event}function Me(e,t){let n=y(e.requestId)??b(t,["openai/requestId","requestId","mcp/requestId"]),r=y(e.sessionId)??b(t,["openai/sessionId","sessionId","conversationId","anthropic/sessionId"]),o=y(e.traceId)??b(t,["openai/traceId","traceId","mcp/traceId","openai/requestId","requestId"]),a=y(e.externalUserId)??b(t,["openai/userId","externalUserId","userId","actorId"]),i=y(e.correlationId)??b(t,["correlationId","openai/requestId"])??n,s={};return r&&(s.sessionId=r),o&&(s.traceId=o),n&&(s.requestId=n),i&&(s.correlationId=i),a&&(s.externalUserId=a),s}function be(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 b(e,t){for(let n of t){let r=e[n];if(typeof r=="string"&&r.trim().length>0)return r}}function W(e){return!e||typeof e!="object"||Array.isArray(e)?{}:e}function y(e){if(typeof e=="string"&&e.trim().length!==0)return e}function $(e){return"eventType"in e}var Ce="/api/mcp/events/v2/batch";var ae="@waniwani/sdk",_e=new Set([401,403]),Pe=new Set([408,425,429,500,502,503,504]);function de(e){return new L(e)}var L=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=Fe(t.baseUrl,t.endpointPath??Ce),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":ae},body:JSON.stringify(this.makeBatchRequest(t))})}catch(a){return{kind:"retryable",reason:Ne(a)}}if(_e.has(n.status))return{kind:"auth",status:n.status};if(Pe.has(n.status))return{kind:"retryable",reason:`HTTP ${n.status}`};if(!n.ok)return{kind:"permanent",reason:`HTTP ${n.status}`};let r=await Ae(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:ae,version:this.sdkVersion??"0.0.0"},events:t}}classifyRejectedEvents(t,n){let r=new Map(t.map(i=>[i.id,i])),o=[],a=[];for(let i of n){let s=r.get(i.eventId);if(s){if(We(i)){o.push(s);continue}a.push(s)}}return{retryable:o,permanent:a}}backoffDelayMs(t){let n=this.retryBaseDelayMs*2**t;return Math.min(n,this.retryMaxDelayMs)}stopTransportForAuthFailure(t,n){this.isStopped=!0;let r=this.buffer.length;this.buffer.splice(0,r),this.logger.error("[WaniWani] Auth failure (HTTP %d). Stopping tracking transport and dropping %d queued event(s)",t,n+r)}};function We(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 Ae(e){let t=await e.text();if(t)try{return JSON.parse(t)}catch{return}}function Fe(e,t){let n=e.endsWith("/")?e:`${e}/`,r=t.startsWith("/")?t.slice(1):t;return`${n}${r}`}function Ne(e){return e instanceof Error?e.message:String(e)}function ce(e){let{baseUrl:t,apiKey:n,tracking:r}=e;function o(){if(!n)throw new Error("WANIWANI_API_KEY is not set");return n}let a=n?de({baseUrl:t,apiKey:n,endpointPath:r.endpointPath,flushIntervalMs:r.flushIntervalMs,maxBatchSize:r.maxBatchSize,maxBufferSize:r.maxBufferSize,maxRetries:r.maxRetries,retryBaseDelayMs:r.retryBaseDelayMs,retryMaxDelayMs:r.retryMaxDelayMs,shutdownTimeoutMs:r.shutdownTimeoutMs}):void 0,i={async track(s){o();let d=j(s);return a?.enqueue(d),{eventId:d.id}},async flush(){o(),await a?.flush()},async shutdown(s){return o(),await a?.shutdown({timeoutMs:s?.timeoutMs??r.shutdownTimeoutMs})??{timedOut:!1,pendingEvents:0}}};return a&&De(i,r.shutdownTimeoutMs),i}function De(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 A(e){let t=e?.baseUrl??"https://app.waniwani.ai",n=e?.apiKey??process.env.WANIWANI_API_KEY,r={endpointPath:e?.tracking?.endpointPath??"/api/mcp/events/v2/batch",flushIntervalMs:e?.tracking?.flushIntervalMs??1e3,maxBatchSize:e?.tracking?.maxBatchSize??20,maxBufferSize:e?.tracking?.maxBufferSize??1e3,maxRetries:e?.tracking?.maxRetries??3,retryBaseDelayMs:e?.tracking?.retryBaseDelayMs??200,retryMaxDelayMs:e?.tracking?.retryMaxDelayMs??2e3,shutdownTimeoutMs:e?.tracking?.shutdownTimeoutMs??2e3},o={baseUrl:t,apiKey:n,tracking:r},a=ce(o),i=ie(o);return{...a,kb:i,_config:o}}function Ue(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 Be(e){let t={apiKey:e?.apiKey,baseUrl:e?.baseUrl},n;function r(){return n||(n=A(t)),n}return async function(a){let i;try{i=await a.json()}catch{return new Response(JSON.stringify({error:"Invalid JSON"}),{status:400,headers:{"Content-Type":"application/json"}})}if(!Array.isArray(i.events)||i.events.length===0)return new Response(JSON.stringify({error:"Missing or empty events array"}),{status:400,headers:{"Content-Type":"application/json"}});try{let s=r(),d=[];for(let g of i.events){let f=Ue(g),c=await s.track(f);d.push(c.eventId)}return await s.flush(),new Response(JSON.stringify({ok:!0,accepted:d.length}),{status:200,headers:{"Content-Type":"application/json"}})}catch(s){let d=s instanceof Error?s.message:"Unknown error";return new Response(JSON.stringify({error:d}),{status:500,headers:{"Content-Type":"application/json"}})}}}var F=class{cached=null;pending=null;config;constructor(t){this.config=t}async getToken(t,n){return this.cached&&Date.now()<this.cached.expiresAt-12e4?this.cached.token:this.pending?this.pending:(this.pending=this.mint(t,n).finally(()=>{this.pending=null}),this.pending)}async mint(t,n){let r=Oe(this.config.baseUrl,"/api/mcp/widget-tokens"),o={};t&&(o.sessionId=t),n&&(o.traceId=n);try{let a=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.config.apiKey}`},body:JSON.stringify(o)});if(!a.ok)return null;let i=await a.json(),s=i.data&&typeof i.data=="object"?i.data:i,d=new Date(s.expiresAt).getTime();return!s.token||Number.isNaN(d)?null:(this.cached={token:s.token,expiresAt:d},s.token)}catch{return null}}};function Oe(e,t){return`${e.endsWith("/")?e.slice(0,-1):e}${t}`}var ue="https://app.waniwani.ai";function qe(e,t={}){let n=e;if(n.__waniwaniWrapped)return n;n.__waniwaniWrapped=!0;let r=t.client??A(t.config),o=t.injectWidgetToken!==!1,a=null;function i(){if(a)return a;let d=r._config.apiKey;return d?(a=new F({baseUrl:r._config.baseUrl??ue,apiKey:d}),a):null}let s=e.registerTool.bind(e);return n.registerTool=((...d)=>{let[g,f,c]=d,u=typeof g=="string"&&g.trim().length>0?g:"unknown";if(typeof c!="function")return s(...d);let l=c;return s(g,f,async(T,w)=>{let S=performance.now();try{let k=await l(T,w),D=Math.round(performance.now()-S);return await pe(r,le(u,w,t,{durationMs:D,status:"ok"}),t.onError),t.flushAfterToolCall&&await fe(r,t.onError),o&&await je(k,i(),r._config.baseUrl??ue,t.onError),k}catch(k){let D=Math.round(performance.now()-S);throw await pe(r,le(u,w,t,{durationMs:D,status:"error",errorMessage:k instanceof Error?k.message:String(k)}),t.onError),t.flushAfterToolCall&&await fe(r,t.onError),k}})}),n}async function je(e,t,n,r){if(!N(e))return;N(e._meta)||(e._meta={});let o=e._meta,a={endpoint:`${n.replace(/\/$/,"")}/api/mcp/events/v2/batch`};if(t)try{let i=await t.getToken();i&&(a.token=i)}catch(i){r?.(V(i))}o.waniwani=a}function le(e,t,n,r){let o=$e(e,n.toolType),a=Le(t);return{event:"tool.called",properties:{name:e,type:o,...r??{}},meta:a,metadata:{source:"withWaniwani",...n.metadata??{}}}}function $e(e,t){return typeof t=="function"?t(e)??"other":t??"other"}function Le(e){if(!N(e))return;let t=e._meta;if(N(t))return t}function N(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}async function pe(e,t,n){try{await e.track(t)}catch(r){n?.(V(r))}}async function fe(e,t){try{await e.flush()}catch(n){t?.(V(n))}}function V(e){return e instanceof Error?e:new Error(String(e))}export{E as END,v as START,x as StateGraph,re as createFlow,oe as createResource,ke as createTool,Be as createTrackingRoute,U as detectPlatform,z as interrupt,he as isMCPApps,ge as isOpenAI,Se as registerTools,K as showWidget,qe as withWaniwani};
 //# sourceMappingURL=index.js.map