@waniwani/sdk 0.0.4 → 0.0.6

package/dist/chunk-OVQDB7QX.js

@@ -0,0 +1,3 @@
+"use client";
+var o="openai:set_globals",e=class extends CustomEvent{constructor(t){super(o,{detail:t})}};export{o as a,e as b};
+//# sourceMappingURL=chunk-OVQDB7QX.js.map

package/dist/chunk-OVQDB7QX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/hooks/@types.ts"],"sourcesContent":["/**\n * Source: https://github.com/openai/openai-apps-sdk-examples/tree/main/src\n */\n\nexport type OpenAIGlobals<\n\tToolInput = UnknownObject,\n\tToolOutput = UnknownObject,\n\tToolResponseMetadata = UnknownObject,\n\tWidgetState = UnknownObject,\n> = {\n\t// visuals\n\ttheme: Theme;\n\n\tuserAgent: UserAgent;\n\tlocale: string;\n\n\t// layout\n\tmaxHeight: number;\n\tdisplayMode: DisplayMode;\n\tsafeArea: SafeArea;\n\n\t// state\n\ttoolInput: ToolInput;\n\ttoolOutput: ToolOutput | null;\n\ttoolResponseMetadata: ToolResponseMetadata | null;\n\twidgetState: WidgetState | null;\n\tsetWidgetState: (state: WidgetState) => Promise<void>;\n};\n\ntype API = {\n\tcallTool: CallTool;\n\tsendFollowUpMessage: (args: { prompt: string }) => Promise<void>;\n\topenExternal(payload: { href: string }): void;\n\n\t// Layout controls\n\trequestDisplayMode: RequestDisplayMode;\n};\n\nexport type UnknownObject = Record<string, unknown>;\n\nexport type Theme = \"light\" | \"dark\";\n\nexport type SafeAreaInsets = {\n\ttop: number;\n\tbottom: number;\n\tleft: number;\n\tright: number;\n};\n\nexport type SafeArea = {\n\tinsets: SafeAreaInsets;\n};\n\nexport type DeviceType = \"mobile\" | \"tablet\" | \"desktop\" | \"unknown\";\n\nexport type UserAgent = {\n\tdevice: { type: DeviceType };\n\tcapabilities: {\n\t\thover: boolean;\n\t\ttouch: boolean;\n\t};\n};\n\n/** Display mode */\nexport type DisplayMode = \"pip\" | \"inline\" | \"fullscreen\";\nexport type RequestDisplayMode = (args: { mode: DisplayMode }) => Promise<{\n\t/**\n\t * The granted display mode. The host may reject the request.\n\t * For mobile, PiP is always coerced to fullscreen.\n\t */\n\tmode: DisplayMode;\n}>;\n\nexport type CallToolResponse = {\n\tresult: string;\n};\n\n/** Calling APIs */\nexport type CallTool = (\n\tname: string,\n\targs: Record<string, unknown>,\n) => Promise<CallToolResponse>;\n\n/** Extra events */\nexport const SET_GLOBALS_EVENT_TYPE = \"openai:set_globals\";\nexport class SetGlobalsEvent extends CustomEvent<{\n\tglobals: Partial<OpenAIGlobals>;\n}> {\n\tconstructor(detail: { globals: Partial<OpenAIGlobals> }) {\n\t\tsuper(SET_GLOBALS_EVENT_TYPE, { detail });\n\t}\n}\n\n/**\n * Global oai object injected by the web sandbox for communicating with chatgpt host page.\n */\ndeclare global {\n\tinterface Window {\n\t\topenai: API & OpenAIGlobals;\n\t\tinnerBaseUrl: string;\n\t}\n\n\tinterface WindowEventMap {\n\t\t[SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;\n\t}\n}\n"],"mappings":";AAoFO,IAAMA,EAAyB,qBACzBC,EAAN,cAA8B,WAElC,CACF,YAAYC,EAA6C,CACxD,MAAMF,EAAwB,CAAE,OAAAE,CAAO,CAAC,CACzC,CACD","names":["SET_GLOBALS_EVENT_TYPE","SetGlobalsEvent","detail"]}

package/dist/chunk-SCDEAZN4.js

@@ -0,0 +1,3 @@
+"use client";
+function e(){return typeof window<"u"&&"openai"in window?"openai":"mcp-apps"}function n(){return e()==="openai"}function p(){return e()==="mcp-apps"}export{e as a,n as b,p as c};
+//# sourceMappingURL=chunk-SCDEAZN4.js.map

package/dist/chunk-SCDEAZN4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/widgets/@utils/platform.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"],"mappings":";AAWO,SAASA,GAAiC,CAChD,OAAI,OAAO,OAAW,KAAe,WAAY,OACzC,SAED,UACR,CAKO,SAASC,GAAoB,CACnC,OAAOD,EAAe,IAAM,QAC7B,CAKO,SAASE,GAAqB,CACpC,OAAOF,EAAe,IAAM,UAC7B","names":["detectPlatform","isOpenAI","isMCPApps"]}

package/dist/index.d.ts

@@ -3,82 +3,71 @@ declare class WaniWaniError extends Error {
     constructor(message: string, status: number);
 }
 
-type MCPProvider = "openai" | "anthropic" | "unknown";
-/** OpenAI-specific MCP metadata structure */
-interface OpenAIMeta {
-    "openai/subject"?: string;
-    "openai/session"?: string;
-    "openai/userAgent"?: string;
-    "openai/locale"?: string;
-    "openai/userLocation"?: {
-        city?: string;
-        region?: string;
-        country?: string;
-        timezone?: string;
-        latitude?: string;
-        longitude?: string;
-    };
-    timezone_offset_minutes?: number;
+type EventType = "tool.called" | "quote.requested" | "quote.succeeded" | "quote.failed" | "link.clicked" | "purchase.completed";
+interface ToolCalledProperties {
+    name?: string;
+    type?: "pricing" | "product_info" | "availability" | "support" | "other";
 }
-/** Location information (provider-agnostic) */
-interface LocationInfo {
-    city?: string;
-    region?: string;
-    country?: string;
-    timezone?: string;
+interface QuoteSucceededProperties {
+    amount?: number;
+    currency?: string;
 }
-/** Normalized metadata extracted from any MCP provider */
-interface NormalizedMeta {
-    provider: MCPProvider;
-    sessionId?: string;
-    externalUserId?: string;
-    userAgent?: string;
-    locale?: string;
-    location?: LocationInfo;
+interface LinkClickedProperties {
+    url?: string;
+}
+interface PurchaseCompletedProperties {
+    amount?: number;
+    currency?: string;
 }
-type EventType = "session.started" | "tool.called" | "quote.requested" | "quote.succeeded" | "quote.failed" | "link.clicked" | "purchase.completed";
-type ToolType = "pricing" | "product_info" | "availability" | "support" | "other";
 interface BaseEvent {
     /**
-     * MCP request metadata. The SDK auto-extracts provider fields
-     * (sessionId, userId, location, etc.). Can also include custom fields.
+     * Event type.
      *
-     * Location varies by MCP library:
-     * - `@vercel/mcp-handler`: `extra._meta`
-     * - `@modelcontextprotocol/sdk`: `request.params._meta`
+     * @example
+     * ```typescript
+     * wani.track({
+     *   event: 'tool.called',
+     * });
+     * ```
+     */
+    event: EventType;
+    /**
+     * Event properties.
      *
      * @example
      * ```typescript
      * wani.track({
-     *   eventType: 'tool.called',
-     *   toolName: 'search',
-     *   meta: extra._meta,
+     *   event: 'tool.called',
+     *   properties: { name: 'search' },
      * });
      * ```
      */
+    properties?: Record<string, unknown>;
+    /**
+     * 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>;
 }
 type TrackEvent = ({
-    eventType: "session.started";
-} & BaseEvent) | ({
-    eventType: "tool.called";
-    toolName?: string;
-    toolType?: ToolType;
+    event: "tool.called";
+    properties: ToolCalledProperties;
 } & BaseEvent) | ({
-    eventType: "quote.requested";
+    event: "quote.requested";
 } & BaseEvent) | ({
-    eventType: "quote.succeeded";
-    quoteAmount?: number;
-    quoteCurrency?: string;
+    event: "quote.succeeded";
+    properties: QuoteSucceededProperties;
 } & BaseEvent) | ({
-    eventType: "quote.failed";
+    event: "quote.failed";
 } & BaseEvent) | ({
-    eventType: "link.clicked";
-    linkUrl?: string;
+    event: "link.clicked";
+    properties: LinkClickedProperties;
 } & BaseEvent) | ({
-    eventType: "purchase.completed";
-    purchaseAmount?: number;
-    purchaseCurrency?: string;
+    event: "purchase.completed";
+    properties: PurchaseCompletedProperties;
 } & BaseEvent);
 /**
  * Tracking module methods for WaniWaniClient
@@ -120,15 +109,6 @@ interface WaniWaniConfig {
 interface WaniWaniClient extends TrackingClient {
 }
 
-/**
- * Detect which MCP provider sent the request based on metadata keys
- */
-declare function detectProvider(meta: Record<string, unknown>): MCPProvider;
-/**
- * Extract normalized metadata from any MCP provider's metadata
- */
-declare function extractMetadata(meta: Record<string, unknown>): NormalizedMeta;
-
 /**
  * Create a WaniWani SDK client
  *
@@ -150,4 +130,4 @@ declare function extractMetadata(meta: Record<string, unknown>): NormalizedMeta;
  */
 declare function waniwani(config?: WaniWaniConfig): WaniWaniClient;
 
-export { type EventType, type LocationInfo, type MCPProvider, type NormalizedMeta, type OpenAIMeta, type ToolType, type TrackEvent, type WaniWaniClient, type WaniWaniConfig, WaniWaniError, detectProvider, extractMetadata, waniwani };
+export { type EventType, type LinkClickedProperties, type PurchaseCompletedProperties, type QuoteSucceededProperties, type ToolCalledProperties, type TrackEvent, type WaniWaniClient, type WaniWaniConfig, WaniWaniError, waniwani };

package/dist/index.js

@@ -1,2 +1,2 @@
-var r=class extends Error{constructor(t,p){super(t);this.status=p;this.name="WaniWaniError"}};function f(e){return e["openai/subject"]||e["openai/session"]?"openai":"unknown"}function c(e){switch(f(e)){case"openai":return m(e);case"anthropic":return y(e);default:return{provider:"unknown"}}}function m(e){let n=e["openai/userLocation"],t;return n&&(t={city:n.city,region:n.region,country:n.country,timezone:n.timezone}),{provider:"openai",sessionId:e["openai/session"],externalUserId:e["openai/subject"],userAgent:e["openai/userAgent"],locale:e["openai/locale"],location:t}}function y(e){return{provider:"anthropic"}}function l(e){let{baseUrl:n,apiKey:t}=e;function p(){if(!t)throw new Error("WANIWANI_API_KEY is not set")}return{async track(o){try{p();let i=o.meta?c(o.meta):{},d=await fetch(`${n}/api/mcp/events`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify({...o,...i})}),u=await d.json();if(!d.ok)throw new r(u.message??"Request failed",d.status);return{eventId:u.data.eventId}}catch(i){throw console.error("[WaniWani] Track error:",i),i}}}}function g(e){let n=e?.baseUrl??"https://app.waniwani.ai",t=e?.apiKey??process.env.WANIWANI_API_KEY;return{...l({baseUrl:n,apiKey:t})}}export{r as WaniWaniError,f as detectProvider,c as extractMetadata,g as waniwani};
+var n=class extends Error{constructor(e,o){super(e);this.status=o;this.name="WaniWaniError"}};function l(r){let{baseUrl:i,apiKey:e}=r;function o(){if(!e)throw new Error("WANIWANI_API_KEY is not set")}return{async track(p){try{o();let t=await fetch(`${i}/api/mcp/events`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e}`},body:JSON.stringify(p)}),c=await t.json();if(!t.ok)throw new n(c.message??"Request failed",t.status);return{eventId:c.data.eventId}}catch(t){throw console.error("[WaniWani] Track error:",t),t}}}}function f(r){let i=r?.baseUrl??"https://app.waniwani.ai",e=r?.apiKey??process.env.WANIWANI_API_KEY;return{...l({baseUrl:i,apiKey:e})}}export{n as WaniWaniError,f as waniwani};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/error.ts","../src/tracking/metadata.ts","../src/tracking/index.ts","../src/waniwani.ts"],"sourcesContent":["// WaniWani SDK - Errors\n\nexport class WaniWaniError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"WaniWaniError\";\n\t}\n}\n","// Metadata Extraction Module\n\nimport type {\n\tLocationInfo,\n\tMCPProvider,\n\tNormalizedMeta,\n\tOpenAIMeta,\n} from \"./@types.js\";\n\n/**\n * Detect which MCP provider sent the request based on metadata keys\n */\nexport function detectProvider(meta: Record<string, unknown>): MCPProvider {\n\tif (meta[\"openai/subject\"] || meta[\"openai/session\"]) {\n\t\treturn \"openai\";\n\t}\n\t// Add Anthropic detection when their MCP format is known\n\t// if (meta['anthropic/...']) return 'anthropic';\n\treturn \"unknown\";\n}\n\n/**\n * Extract normalized metadata from any MCP provider's metadata\n */\nexport function extractMetadata(meta: Record<string, unknown>): NormalizedMeta {\n\tconst provider = detectProvider(meta);\n\n\tswitch (provider) {\n\t\tcase \"openai\":\n\t\t\treturn extractOpenAIMeta(meta as unknown as OpenAIMeta);\n\t\tcase \"anthropic\":\n\t\t\treturn extractAnthropicMeta(meta);\n\t\tdefault:\n\t\t\treturn { provider: \"unknown\" };\n\t}\n}\n\nfunction extractOpenAIMeta(meta: OpenAIMeta): NormalizedMeta {\n\tconst rawLocation = meta[\"openai/userLocation\"];\n\tlet location: LocationInfo | undefined;\n\n\tif (rawLocation) {\n\t\tlocation = {\n\t\t\tcity: rawLocation.city,\n\t\t\tregion: rawLocation.region,\n\t\t\tcountry: rawLocation.country,\n\t\t\ttimezone: rawLocation.timezone,\n\t\t};\n\t}\n\n\treturn {\n\t\tprovider: \"openai\",\n\t\tsessionId: meta[\"openai/session\"],\n\t\texternalUserId: meta[\"openai/subject\"],\n\t\tuserAgent: meta[\"openai/userAgent\"],\n\t\tlocale: meta[\"openai/locale\"],\n\t\tlocation,\n\t};\n}\n\nfunction extractAnthropicMeta(_meta: Record<string, unknown>): NormalizedMeta {\n\t// Placeholder for Anthropic extraction logic\n\t// Will be implemented when Anthropic MCP metadata format is known\n\treturn { provider: \"anthropic\" };\n}\n","// Tracking Module\n\nimport { WaniWaniError } from \"../error.js\";\nimport type { InternalConfig } from \"../types.js\";\nimport type { TrackEvent, TrackingClient } from \"./@types.js\";\nimport { extractMetadata } from \"./metadata.js\";\n\n// Re-export types\nexport type {\n\tEventType,\n\tLocationInfo,\n\tMCPProvider,\n\tNormalizedMeta,\n\tOpenAIMeta,\n\tToolType,\n\tTrackEvent,\n\tTrackingClient,\n} from \"./@types.js\";\n\n// Re-export metadata utilities\nexport { detectProvider, extractMetadata } from \"./metadata.js\";\n\nexport function createTrackingClient(config: InternalConfig): TrackingClient {\n\tconst { baseUrl, apiKey } = config;\n\n\tfunction checkIfApiKeyIsSet() {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t}\n\n\treturn {\n\t\tasync track(event: TrackEvent): Promise<{ eventId: string }> {\n\t\t\ttry {\n\t\t\t\tcheckIfApiKeyIsSet();\n\n\t\t\t\t// Extract provider-specific fields from meta if present\n\t\t\t\tconst normalized = event.meta ? extractMetadata(event.meta) : {};\n\n\t\t\t\tconst response = await fetch(`${baseUrl}/api/mcp/events`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\theaders: {\n\t\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t\t},\n\t\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\t\t...event,\n\t\t\t\t\t\t...normalized,\n\t\t\t\t\t}),\n\t\t\t\t});\n\n\t\t\t\tconst data = await response.json();\n\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tthrow new WaniWaniError(\n\t\t\t\t\t\tdata.message ?? \"Request failed\",\n\t\t\t\t\t\tresponse.status,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn { eventId: data.data.eventId };\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"[WaniWani] Track error:\", error);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t};\n}\n","// WaniWani SDK - Main Entry\n\nimport { createTrackingClient } from \"./tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"./types.js\";\n\n/**\n * Create a WaniWani SDK client\n *\n * @param config - Configuration options\n * @returns A fully typed WaniWani client\n *\n * @example\n * ```typescript\n * import { waniwani } from \"@waniwani\";\n *\n * const client = waniwani({ apiKey: \"...\" });\n *\n * await client.track({\n *   eventType: \"tool.called\",\n *   sessionId: \"session-123\",\n *   toolName: \"pricing\"\n * });\n * ```\n */\nexport function waniwani(config?: WaniWaniConfig): WaniWaniClient {\n\tconst baseUrl = config?.baseUrl ?? \"https://app.waniwani.ai\";\n\tconst apiKey = config?.apiKey ?? process.env.WANIWANI_API_KEY;\n\n\tconst internalConfig = { baseUrl, apiKey };\n\n\t// Compose client from modules\n\tconst tracking = createTrackingClient(internalConfig);\n\n\treturn {\n\t\t...tracking,\n\t\t// Future modules will be spread here\n\t\t// ...tools,\n\t};\n}\n"],"mappings":"AAEO,IAAMA,EAAN,cAA4B,KAAM,CACxC,YACCC,EACOC,EACN,CACD,MAAMD,CAAO,EAFN,YAAAC,EAGP,KAAK,KAAO,eACb,CACD,ECEO,SAASC,EAAeC,EAA4C,CAC1E,OAAIA,EAAK,gBAAgB,GAAKA,EAAK,gBAAgB,EAC3C,SAID,SACR,CAKO,SAASC,EAAgBD,EAA+C,CAG9E,OAFiBD,EAAeC,CAAI,EAElB,CACjB,IAAK,SACJ,OAAOE,EAAkBF,CAA6B,EACvD,IAAK,YACJ,OAAOG,EAAqBH,CAAI,EACjC,QACC,MAAO,CAAE,SAAU,SAAU,CAC/B,CACD,CAEA,SAASE,EAAkBF,EAAkC,CAC5D,IAAMI,EAAcJ,EAAK,qBAAqB,EAC1CK,EAEJ,OAAID,IACHC,EAAW,CACV,KAAMD,EAAY,KAClB,OAAQA,EAAY,OACpB,QAASA,EAAY,QACrB,SAAUA,EAAY,QACvB,GAGM,CACN,SAAU,SACV,UAAWJ,EAAK,gBAAgB,EAChC,eAAgBA,EAAK,gBAAgB,EACrC,UAAWA,EAAK,kBAAkB,EAClC,OAAQA,EAAK,eAAe,EAC5B,SAAAK,CACD,CACD,CAEA,SAASF,EAAqBG,EAAgD,CAG7E,MAAO,CAAE,SAAU,WAAY,CAChC,CC1CO,SAASC,EAAqBC,EAAwC,CAC5E,GAAM,CAAE,QAAAC,EAAS,OAAAC,CAAO,EAAIF,EAE5B,SAASG,GAAqB,CAC7B,GAAI,CAACD,EACJ,MAAM,IAAI,MAAM,6BAA6B,CAE/C,CAEA,MAAO,CACN,MAAM,MAAME,EAAiD,CAC5D,GAAI,CACHD,EAAmB,EAGnB,IAAME,EAAaD,EAAM,KAAOE,EAAgBF,EAAM,IAAI,EAAI,CAAC,EAEzDG,EAAW,MAAM,MAAM,GAAGN,CAAO,kBAAmB,CACzD,OAAQ,OACR,QAAS,CACR,eAAgB,mBAChB,cAAe,UAAUC,CAAM,EAChC,EACA,KAAM,KAAK,UAAU,CACpB,GAAGE,EACH,GAAGC,CACJ,CAAC,CACF,CAAC,EAEKG,EAAO,MAAMD,EAAS,KAAK,EAEjC,GAAI,CAACA,EAAS,GACb,MAAM,IAAIE,EACTD,EAAK,SAAW,iBAChBD,EAAS,MACV,EAGD,MAAO,CAAE,QAASC,EAAK,KAAK,OAAQ,CACrC,OAASE,EAAO,CACf,cAAQ,MAAM,0BAA2BA,CAAK,EACxCA,CACP,CACD,CACD,CACD,CC3CO,SAASC,EAASC,EAAyC,CACjE,IAAMC,EAAUD,GAAQ,SAAW,0BAC7BE,EAASF,GAAQ,QAAU,QAAQ,IAAI,iBAO7C,MAAO,CACN,GAHgBG,EAHM,CAAE,QAAAF,EAAS,OAAAC,CAAO,CAGW,CAMpD,CACD","names":["WaniWaniError","message","status","detectProvider","meta","extractMetadata","extractOpenAIMeta","extractAnthropicMeta","rawLocation","location","_meta","createTrackingClient","config","baseUrl","apiKey","checkIfApiKeyIsSet","event","normalized","extractMetadata","response","data","WaniWaniError","error","waniwani","config","baseUrl","apiKey","createTrackingClient"]}
+{"version":3,"sources":["../src/error.ts","../src/tracking/index.ts","../src/waniwani.ts"],"sourcesContent":["// WaniWani SDK - Errors\n\nexport class WaniWaniError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"WaniWaniError\";\n\t}\n}\n","// Tracking Module\n\nimport { WaniWaniError } from \"../error.js\";\nimport type { InternalConfig } from \"../types.js\";\nimport type { TrackEvent, TrackingClient } from \"./@types.js\";\n\n// Re-export types\nexport type {\n\tEventType,\n\tLinkClickedProperties,\n\tPurchaseCompletedProperties,\n\tQuoteSucceededProperties,\n\tToolCalledProperties,\n\tTrackEvent,\n\tTrackingClient,\n} from \"./@types.js\";\n\nexport function createTrackingClient(config: InternalConfig): TrackingClient {\n\tconst { baseUrl, apiKey } = config;\n\n\tfunction checkIfApiKeyIsSet() {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t}\n\n\treturn {\n\t\tasync track(event: TrackEvent): Promise<{ eventId: string }> {\n\t\t\ttry {\n\t\t\t\tcheckIfApiKeyIsSet();\n\n\t\t\t\tconst response = await fetch(`${baseUrl}/api/mcp/events`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\theaders: {\n\t\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t\t},\n\t\t\t\t\tbody: JSON.stringify(event),\n\t\t\t\t});\n\n\t\t\t\tconst data = await response.json();\n\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tthrow new WaniWaniError(\n\t\t\t\t\t\tdata.message ?? \"Request failed\",\n\t\t\t\t\t\tresponse.status,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn { eventId: data.data.eventId };\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"[WaniWani] Track error:\", error);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t};\n}\n","// WaniWani SDK - Main Entry\n\nimport { createTrackingClient } from \"./tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"./types.js\";\n\n/**\n * Create a WaniWani SDK client\n *\n * @param config - Configuration options\n * @returns A fully typed WaniWani client\n *\n * @example\n * ```typescript\n * import { waniwani } from \"@waniwani\";\n *\n * const client = waniwani({ apiKey: \"...\" });\n *\n * await client.track({\n *   eventType: \"tool.called\",\n *   sessionId: \"session-123\",\n *   toolName: \"pricing\"\n * });\n * ```\n */\nexport function waniwani(config?: WaniWaniConfig): WaniWaniClient {\n\tconst baseUrl = config?.baseUrl ?? \"https://app.waniwani.ai\";\n\tconst apiKey = config?.apiKey ?? process.env.WANIWANI_API_KEY;\n\n\tconst internalConfig = { baseUrl, apiKey };\n\n\t// Compose client from modules\n\tconst tracking = createTrackingClient(internalConfig);\n\n\treturn {\n\t\t...tracking,\n\t\t// Future modules will be spread here\n\t\t// ...tools,\n\t};\n}\n"],"mappings":"AAEO,IAAMA,EAAN,cAA4B,KAAM,CACxC,YACCC,EACOC,EACN,CACD,MAAMD,CAAO,EAFN,YAAAC,EAGP,KAAK,KAAO,eACb,CACD,ECOO,SAASC,EAAqBC,EAAwC,CAC5E,GAAM,CAAE,QAAAC,EAAS,OAAAC,CAAO,EAAIF,EAE5B,SAASG,GAAqB,CAC7B,GAAI,CAACD,EACJ,MAAM,IAAI,MAAM,6BAA6B,CAE/C,CAEA,MAAO,CACN,MAAM,MAAME,EAAiD,CAC5D,GAAI,CACHD,EAAmB,EAEnB,IAAME,EAAW,MAAM,MAAM,GAAGJ,CAAO,kBAAmB,CACzD,OAAQ,OACR,QAAS,CACR,eAAgB,mBAChB,cAAe,UAAUC,CAAM,EAChC,EACA,KAAM,KAAK,UAAUE,CAAK,CAC3B,CAAC,EAEKE,EAAO,MAAMD,EAAS,KAAK,EAEjC,GAAI,CAACA,EAAS,GACb,MAAM,IAAIE,EACTD,EAAK,SAAW,iBAChBD,EAAS,MACV,EAGD,MAAO,CAAE,QAASC,EAAK,KAAK,OAAQ,CACrC,OAASE,EAAO,CACf,cAAQ,MAAM,0BAA2BA,CAAK,EACxCA,CACP,CACD,CACD,CACD,CChCO,SAASC,EAASC,EAAyC,CACjE,IAAMC,EAAUD,GAAQ,SAAW,0BAC7BE,EAASF,GAAQ,QAAU,QAAQ,IAAI,iBAO7C,MAAO,CACN,GAHgBG,EAHM,CAAE,QAAAF,EAAS,OAAAC,CAAO,CAGW,CAMpD,CACD","names":["WaniWaniError","message","status","createTrackingClient","config","baseUrl","apiKey","checkIfApiKeyIsSet","event","response","data","WaniWaniError","error","waniwani","config","baseUrl","apiKey","createTrackingClient"]}

package/dist/mcp/index.d.ts

@@ -0,0 +1,367 @@
+import { z } from 'zod';
+import { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+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;
+    /** 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
+ */
+type WidgetPlatform = "openai" | "mcp-apps";
+/**
+ * Detects which platform the widget is running on.
+ *
+ * OpenAI injects a global `window.openai` object.
+ * MCP Apps runs in a sandboxed iframe and uses postMessage.
+ */
+declare function detectPlatform(): WidgetPlatform;
+/**
+ * Check if running on OpenAI platform
+ */
+declare function isOpenAI(): boolean;
+/**
+ * Check if running on MCP Apps platform
+ */
+declare function isMCPApps(): boolean;
+
+/**
+ * Source: https://github.com/openai/openai-apps-sdk-examples/tree/main/src
+ */
+type OpenAIGlobals<ToolInput = UnknownObject, ToolOutput = UnknownObject, ToolResponseMetadata = UnknownObject, WidgetState = UnknownObject> = {
+    theme: Theme;
+    userAgent: UserAgent;
+    locale: string;
+    maxHeight: number;
+    displayMode: DisplayMode;
+    safeArea: SafeArea;
+    toolInput: ToolInput;
+    toolOutput: ToolOutput | null;
+    toolResponseMetadata: ToolResponseMetadata | null;
+    widgetState: WidgetState | null;
+    setWidgetState: (state: WidgetState) => Promise<void>;
+};
+type API = {
+    callTool: CallTool;
+    sendFollowUpMessage: (args: {
+        prompt: string;
+    }) => Promise<void>;
+    openExternal(payload: {
+        href: string;
+    }): void;
+    requestDisplayMode: RequestDisplayMode;
+};
+type UnknownObject = Record<string, unknown>;
+type Theme = "light" | "dark";
+type SafeAreaInsets = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+type SafeArea = {
+    insets: SafeAreaInsets;
+};
+type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
+type UserAgent = {
+    device: {
+        type: DeviceType;
+    };
+    capabilities: {
+        hover: boolean;
+        touch: boolean;
+    };
+};
+/** Display mode */
+type DisplayMode = "pip" | "inline" | "fullscreen";
+type RequestDisplayMode = (args: {
+    mode: DisplayMode;
+}) => Promise<{
+    /**
+     * The granted display mode. The host may reject the request.
+     * For mobile, PiP is always coerced to fullscreen.
+     */
+    mode: DisplayMode;
+}>;
+type CallToolResponse = {
+    result: string;
+};
+/** Calling APIs */
+type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
+/** Extra events */
+declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
+declare class SetGlobalsEvent extends CustomEvent<{
+    globals: Partial<OpenAIGlobals>;
+}> {
+    constructor(detail: {
+        globals: Partial<OpenAIGlobals>;
+    });
+}
+/**
+ * Global oai object injected by the web sandbox for communicating with chatgpt host page.
+ */
+declare global {
+    interface Window {
+        openai: API & OpenAIGlobals;
+        innerBaseUrl: string;
+    }
+    interface WindowEventMap {
+        [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
+    }
+}
+
+/**
+ * Result from calling a tool
+ */
+type ToolCallResult = {
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+};
+/**
+ * Tool result notification (what the host pushes to the widget)
+ */
+type ToolResult = {
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+};
+/**
+ * Host context - all values available from the host.
+ */
+type HostContext = {
+    theme: Theme;
+    locale: string;
+    displayMode: DisplayMode;
+    maxHeight: number | null;
+    safeArea: SafeArea | null;
+    toolOutput: UnknownObject | null;
+    toolResponseMetadata: UnknownObject | null;
+    widgetState: UnknownObject | null;
+};
+/**
+ * Unified widget client interface that works on both OpenAI and MCP Apps.
+ *
+ * Platform-specific behavior:
+ * - Display mode: OpenAI-only. MCP Apps returns "inline" and requestDisplayMode is a no-op.
+ * - Follow-up messages: Unified API, different underlying implementations.
+ */
+interface UnifiedWidgetClient {
+    /**
+     * Connect to the host. Must be called before using other methods.
+     * On OpenAI, this is a no-op (already connected via window.openai).
+     * On MCP Apps, this establishes the postMessage connection.
+     */
+    connect(): Promise<void>;
+    /**
+     * Get the tool output (structured content returned by the tool handler).
+     * This is the main data source for widget rendering.
+     */
+    getToolOutput<T = Record<string, unknown>>(): T | null;
+    /**
+     * Register a callback for when tool results are received.
+     * On OpenAI, this subscribes to toolOutput changes.
+     * On MCP Apps, this sets app.ontoolresult.
+     */
+    onToolResult(callback: (result: ToolResult) => void): () => void;
+    /**
+     * Call another tool on the server.
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<ToolCallResult>;
+    /**
+     * Open an external URL.
+     * On OpenAI: openai.openExternal({ href })
+     * On MCP Apps: app.sendOpenLink(url)
+     */
+    openExternal(url: string): void;
+    /**
+     * Send a follow-up message to the AI.
+     * On OpenAI: openai.sendFollowUpMessage({ prompt })
+     * On MCP Apps: app.sendMessages([{ role: 'user', content: { type: 'text', text: prompt } }])
+     */
+    sendFollowUp(prompt: string): void;
+    /**
+     * Get the current theme.
+     */
+    getTheme(): Theme;
+    /**
+     * Subscribe to theme changes.
+     */
+    onThemeChange(callback: (theme: Theme) => void): () => void;
+    /**
+     * Get the current locale.
+     */
+    getLocale(): string;
+    /**
+     * Get the current display mode.
+     * OpenAI-only: returns "pip" | "inline" | "fullscreen"
+     * MCP Apps: always returns "inline"
+     */
+    getDisplayMode(): DisplayMode;
+    /**
+     * Request a display mode change.
+     * OpenAI-only: requests the mode from the host.
+     * MCP Apps: no-op (returns current mode).
+     */
+    requestDisplayMode(mode: DisplayMode): Promise<DisplayMode>;
+    /**
+     * Subscribe to display mode changes.
+     * OpenAI-only: subscribes to displayMode changes.
+     * MCP Apps: callback is never called.
+     */
+    onDisplayModeChange(callback: (mode: DisplayMode) => void): () => void;
+    /**
+     * Get the safe area insets.
+     * OpenAI-only: returns insets from window.openai.safeArea.
+     * MCP Apps: returns null.
+     */
+    getSafeArea(): SafeArea | null;
+    /**
+     * Subscribe to safe area changes.
+     * OpenAI-only: subscribes to safeArea changes.
+     * MCP Apps: callback is never called.
+     */
+    onSafeAreaChange(callback: (safeArea: SafeArea | null) => void): () => void;
+    /**
+     * Get the max height constraint.
+     * OpenAI-only: returns maxHeight from window.openai.maxHeight.
+     * MCP Apps: returns null.
+     */
+    getMaxHeight(): number | null;
+    /**
+     * Subscribe to max height changes.
+     * OpenAI-only: subscribes to maxHeight changes.
+     * MCP Apps: callback is never called.
+     */
+    onMaxHeightChange(callback: (maxHeight: number | null) => void): () => void;
+    /**
+     * Get the tool response metadata.
+     * OpenAI-only: returns metadata from window.openai.toolResponseMetadata.
+     * MCP Apps: returns null.
+     */
+    getToolResponseMetadata(): UnknownObject | null;
+    /**
+     * Subscribe to tool response metadata changes.
+     * OpenAI-only: subscribes to toolResponseMetadata changes.
+     * MCP Apps: callback is never called.
+     */
+    onToolResponseMetadataChange(callback: (metadata: UnknownObject | null) => void): () => void;
+    /**
+     * Get the widget state.
+     * OpenAI-only: returns state from window.openai.widgetState.
+     * MCP Apps: returns null.
+     */
+    getWidgetState(): UnknownObject | null;
+    /**
+     * Subscribe to widget state changes.
+     * OpenAI-only: subscribes to widgetState changes.
+     * MCP Apps: callback is never called.
+     */
+    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 };

package/dist/mcp/index.js

@@ -0,0 +1,2 @@
+var P="text/html+skybridge",C="text/html;profile=mcp-app",h=async(e,i)=>{let t=e.endsWith("/")?e.slice(0,-1):e;return await(await fetch(`${t}${i}`)).text()};function I(e){return{"openai/widgetDescription":e.description,"openai/widgetPrefersBorder":e.prefersBorder,"openai/widgetDomain":e.widgetDomain,...e.widgetCSP&&{"openai/widgetCSP":e.widgetCSP}}}function b(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 A(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}}}function B(e,i){let{id:t,title:r,description:a,widgetDescription:y,baseUrl:W,htmlPath:T,inputSchema:k,invoking:M="Loading...",invoked:R="Loaded",widgetDomain:v,prefersBorder:s=!0,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 h(W,T),l=A({openaiTemplateUri:m,mcpTemplateUri:g,invoking:M,invoked:R});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:I({description:o,prefersBorder:s,widgetDomain:v,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:b({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 H(){return d()==="openai"}function O(){return d()==="mcp-apps"}export{B as createWidget,d as detectPlatform,O as isMCPApps,H as isOpenAI,E as registerWidgets};
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +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}) {\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},\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\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});\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","widgetCSP","annotations","uiDescription","openaiTemplateUri","mcpTemplateUri","server","html","toolMeta","uri","args","extra","_meta","result","registerWidgets","widgets","w","detectPlatform","isOpenAI","isMCPApps"]}