@leanmcp/ui 0.3.4 → 0.3.5

package/dist/chunk-57VDL5UC.js

@@ -0,0 +1,138 @@
+'use strict';
+
+require('reflect-metadata');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var UI_APP_COMPONENT_KEY = "ui:app:component";
+var UI_APP_URI_KEY = "ui:app:uri";
+var UI_APP_OPTIONS_KEY = "ui:app:options";
+function UIApp(options) {
+  return (target, propertyKey, descriptor) => {
+    const methodName = String(propertyKey);
+    const className = target.constructor.name.toLowerCase().replace("service", "");
+    const uri = options.uri ?? `ui://${className}/${methodName}`;
+    Reflect.defineMetadata(UI_APP_COMPONENT_KEY, options.component, descriptor.value);
+    Reflect.defineMetadata(UI_APP_URI_KEY, uri, descriptor.value);
+    Reflect.defineMetadata(UI_APP_OPTIONS_KEY, options, descriptor.value);
+    const existingMeta = Reflect.getMetadata("tool:meta", descriptor.value) || {};
+    Reflect.defineMetadata("tool:meta", {
+      ...existingMeta,
+      // New nested format (preferred by ext-apps 0.2.2)
+      ui: {
+        resourceUri: uri
+      },
+      // Legacy flat format (for backwards compatibility)
+      "ui/resourceUri": uri
+    }, descriptor.value);
+    return descriptor;
+  };
+}
+__name(UIApp, "UIApp");
+function getUIAppMetadata(target) {
+  const component = Reflect.getMetadata(UI_APP_COMPONENT_KEY, target);
+  if (!component) return void 0;
+  return {
+    component,
+    uri: Reflect.getMetadata(UI_APP_URI_KEY, target),
+    ...Reflect.getMetadata(UI_APP_OPTIONS_KEY, target)
+  };
+}
+__name(getUIAppMetadata, "getUIAppMetadata");
+function getUIAppUri(target) {
+  return Reflect.getMetadata(UI_APP_URI_KEY, target);
+}
+__name(getUIAppUri, "getUIAppUri");
+var GPT_APP_COMPONENT_KEY = "gptapp:component";
+var GPT_APP_URI_KEY = "gptapp:uri";
+var GPT_APP_OPTIONS_KEY = "gptapp:options";
+function GPTApp(options) {
+  return (target, propertyKey, descriptor) => {
+    const methodName = String(propertyKey);
+    const className = target.constructor.name.toLowerCase().replace("service", "");
+    const uri = options.uri ?? `ui://${className}/${methodName}`;
+    Reflect.defineMetadata(GPT_APP_COMPONENT_KEY, options.component, descriptor.value);
+    Reflect.defineMetadata(GPT_APP_URI_KEY, uri, descriptor.value);
+    Reflect.defineMetadata(GPT_APP_OPTIONS_KEY, options, descriptor.value);
+    const existingMeta = Reflect.getMetadata("tool:meta", descriptor.value) || {};
+    const uiMeta = {
+      resourceUri: uri
+    };
+    if (options.visibility) {
+      uiMeta.visibility = options.visibility === "private" ? [
+        "app"
+      ] : [
+        "model",
+        "app"
+      ];
+    }
+    const openAiMeta = {
+      // New nested format (preferred by ext-apps 0.2.2)
+      ui: uiMeta,
+      // Legacy flat format (for backwards compatibility)
+      "ui/resourceUri": uri,
+      "openai/outputTemplate": uri
+    };
+    if (options.widgetAccessible !== void 0) {
+      openAiMeta["openai/widgetAccessible"] = options.widgetAccessible;
+    }
+    if (options.visibility) {
+      openAiMeta["openai/visibility"] = options.visibility;
+    }
+    if (options.prefersBorder !== void 0) {
+      openAiMeta["openai/widgetPrefersBorder"] = options.prefersBorder;
+    }
+    if (options.widgetDomain) {
+      openAiMeta["openai/widgetDomain"] = options.widgetDomain;
+    }
+    if (options.widgetDescription) {
+      openAiMeta["openai/widgetDescription"] = options.widgetDescription;
+    }
+    if (options.csp) {
+      openAiMeta["openai/widgetCSP"] = options.csp;
+    }
+    if (options.fileParams) {
+      openAiMeta["openai/fileParams"] = options.fileParams;
+    }
+    if (options.invocation) {
+      if (options.invocation.invoking) openAiMeta["openai/toolInvocation/invoking"] = options.invocation.invoking;
+      if (options.invocation.invoked) openAiMeta["openai/toolInvocation/invoked"] = options.invocation.invoked;
+    }
+    Reflect.defineMetadata("tool:meta", {
+      ...existingMeta,
+      ...openAiMeta
+    }, descriptor.value);
+    return descriptor;
+  };
+}
+__name(GPTApp, "GPTApp");
+function getGPTAppMetadata(target) {
+  const component = Reflect.getMetadata(GPT_APP_COMPONENT_KEY, target);
+  if (!component) return void 0;
+  return {
+    component,
+    uri: Reflect.getMetadata(GPT_APP_URI_KEY, target),
+    ...Reflect.getMetadata(GPT_APP_OPTIONS_KEY, target)
+  };
+}
+__name(getGPTAppMetadata, "getGPTAppMetadata");
+function getGPTAppUri(target) {
+  return Reflect.getMetadata(GPT_APP_URI_KEY, target);
+}
+__name(getGPTAppUri, "getGPTAppUri");
+
+exports.GPTApp = GPTApp;
+exports.GPT_APP_COMPONENT_KEY = GPT_APP_COMPONENT_KEY;
+exports.GPT_APP_OPTIONS_KEY = GPT_APP_OPTIONS_KEY;
+exports.GPT_APP_URI_KEY = GPT_APP_URI_KEY;
+exports.UIApp = UIApp;
+exports.UI_APP_COMPONENT_KEY = UI_APP_COMPONENT_KEY;
+exports.UI_APP_OPTIONS_KEY = UI_APP_OPTIONS_KEY;
+exports.UI_APP_URI_KEY = UI_APP_URI_KEY;
+exports.__name = __name;
+exports.getGPTAppMetadata = getGPTAppMetadata;
+exports.getGPTAppUri = getGPTAppUri;
+exports.getUIAppMetadata = getUIAppMetadata;
+exports.getUIAppUri = getUIAppUri;
+//# sourceMappingURL=chunk-57VDL5UC.js.map
+//# sourceMappingURL=chunk-57VDL5UC.js.map

package/dist/chunk-57VDL5UC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/decorator/UIApp.ts","../src/decorator/GPTApp.ts"],"names":["UI_APP_COMPONENT_KEY","UI_APP_URI_KEY","UI_APP_OPTIONS_KEY","UIApp","options","target","propertyKey","descriptor","methodName","String","className","name","toLowerCase","replace","uri","Reflect","defineMetadata","component","value","existingMeta","getMetadata","ui","resourceUri","getUIAppMetadata","undefined","getUIAppUri","GPT_APP_COMPONENT_KEY","GPT_APP_URI_KEY","GPT_APP_OPTIONS_KEY","GPTApp","uiMeta","visibility","openAiMeta","widgetAccessible","prefersBorder","widgetDomain","widgetDescription","csp","fileParams","invocation","invoking","invoked","getGPTAppMetadata","getGPTAppUri"],"mappings":"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","file":"chunk-57VDL5UC.js","sourcesContent":["/**\n * @UIApp Decorator\n * \n * Links an MCP tool to a React UI component.\n * When applied to a tool method, it:\n * 1. Adds _meta.ui/resourceUri to the tool definition\n * 2. Auto-registers a resource that renders the component to HTML\n * \n * This decorator is designed to work with @leanmcp/core decorators.\n */\nimport 'reflect-metadata';\nimport type React from 'react';\n\n// Metadata keys\nexport const UI_APP_COMPONENT_KEY = 'ui:app:component';\nexport const UI_APP_URI_KEY = 'ui:app:uri';\nexport const UI_APP_OPTIONS_KEY = 'ui:app:options';\n\n/**\n * Options for @UIApp decorator\n */\nexport interface UIAppOptions {\n    /** \n     * React component or path to component file (relative to service file).\n     * - Use path string (e.g., './WeatherCard') for CLI build - avoids importing browser code in server\n     * - Use component reference for direct SSR rendering\n     */\n    component: React.ComponentType<any> | string;\n    /** Custom resource URI (auto-generated if not provided) */\n    uri?: string;\n    /** HTML document title */\n    title?: string;\n    /** Additional CSS styles */\n    styles?: string;\n}\n\n\n/**\n * Decorator that links a tool to a UI component.\n * \n * When the tool is called, the host will fetch the UI resource\n * which returns the component rendered as HTML.\n * \n * @example\n * ```typescript\n * import { Tool } from '@leanmcp/core';\n * import { UIApp } from '@leanmcp/ui';\n * import { WeatherCard } from './WeatherCard';\n * \n * class WeatherService {\n *   @Tool({ description: 'Get weather for a city' })\n *   @UIApp({ component: WeatherCard })\n *   async getWeather(args: { city: string }) {\n *     return { city: args.city, temp: 22 };\n *   }\n * }\n * ```\n */\nexport function UIApp(options: UIAppOptions): MethodDecorator {\n    return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n        const methodName = String(propertyKey);\n        // Use same pattern as @Resource in @leanmcp/core: className without 'service' suffix\n        const className = target.constructor.name.toLowerCase().replace('service', '');\n\n        // Generate URI using ui:// scheme (required by ext-apps hosts)\n        const uri = options.uri ?? `ui://${className}/${methodName}`;\n\n        // Store metadata on the method\n        Reflect.defineMetadata(UI_APP_COMPONENT_KEY, options.component, descriptor.value!);\n        Reflect.defineMetadata(UI_APP_URI_KEY, uri, descriptor.value!);\n        Reflect.defineMetadata(UI_APP_OPTIONS_KEY, options, descriptor.value!);\n\n        // Also store the resource URI for the @Tool decorator to pick up\n        // The @Tool decorator in @leanmcp/core should check for this\n        const existingMeta = Reflect.getMetadata('tool:meta', descriptor.value) || {};\n        Reflect.defineMetadata('tool:meta', {\n            ...existingMeta,\n            // New nested format (preferred by ext-apps 0.2.2)\n            ui: {\n                resourceUri: uri,\n            },\n            // Legacy flat format (for backwards compatibility)\n            'ui/resourceUri': uri,\n        }, descriptor.value!);\n\n        return descriptor;\n    };\n}\n\n/**\n * Helper to get UIApp metadata from a method\n */\nexport function getUIAppMetadata(target: Function): UIAppOptions | undefined {\n    const component = Reflect.getMetadata(UI_APP_COMPONENT_KEY, target);\n    if (!component) return undefined;\n\n    return {\n        component,\n        uri: Reflect.getMetadata(UI_APP_URI_KEY, target),\n        ...Reflect.getMetadata(UI_APP_OPTIONS_KEY, target),\n    };\n}\n\n/**\n * Helper to get the resource URI from a method\n */\nexport function getUIAppUri(target: Function): string | undefined {\n    return Reflect.getMetadata(UI_APP_URI_KEY, target);\n}\n","/**\n * @GPTApp Decorator\n * \n * Links an MCP tool to a React UI component compliant with ChatGPT Apps SDK.\n * \n * When applied to a tool method, it:\n * 1. Adds _meta.ui/resourceUri to the tool definition\n * 2. Adds OpenAI-specific metadata (widgetAccessible, outputTemplate, etc.)\n * 3. Auto-registers a resource that renders the component to HTML with 'text/html+skybridge' mimeType\n */\nimport 'reflect-metadata';\nimport type React from 'react';\n\n// Metadata keys\nexport const GPT_APP_COMPONENT_KEY = 'gptapp:component';\nexport const GPT_APP_URI_KEY = 'gptapp:uri';\nexport const GPT_APP_OPTIONS_KEY = 'gptapp:options';\n\n/**\n * Options for @GPTApp decorator\n */\nexport interface GPTAppOptions {\n    /** \n     * React component or path to component file (relative to service file).\n     * - Use path string (e.g., './WeatherCard') for CLI build - avoids importing browser code in server\n     * - Use component reference for direct SSR rendering\n     */\n    component: React.ComponentType<any> | string;\n\n    /** Custom resource URI (auto-generated ui://... if not provided) */\n    uri?: string;\n\n    /** HTML document title */\n    title?: string;\n\n    /** Additional CSS styles */\n    styles?: string;\n\n    // ========== GPT-specific options ==========\n\n    /** \n     * Allow widget to call tools via window.openai.callTool.\n     * Maps to _meta[\"openai/widgetAccessible\"]\n     */\n    widgetAccessible?: boolean;\n\n    /** \n     * Tool visibility: 'public' (default) or 'private'.\n     * 'private' hides the tool from the model but keeps it callable by the widget.\n     * Maps to _meta[\"openai/visibility\"]\n     */\n    visibility?: 'public' | 'private';\n\n    /** \n     * Widget prefers border around iframe.\n     * Maps to _meta[\"openai/widgetPrefersBorder\"]\n     */\n    prefersBorder?: boolean;\n\n    /** \n     * Widget domain for API allowlists.\n     * Maps to _meta[\"openai/widgetDomain\"]\n     */\n    widgetDomain?: string;\n\n    /** \n     * Widget description for the model.\n     * Maps to _meta[\"openai/widgetDescription\"]\n     */\n    widgetDescription?: string;\n\n    /** \n     * Content Security Policy configuration.\n     * Maps to _meta[\"openai/widgetCSP\"]\n     */\n    csp?: {\n        connect_domains?: string[];\n        resource_domains?: string[];\n        redirect_domains?: string[];\n        frame_domains?: string[];\n    };\n\n    /** \n     * File parameters (fields treated as file uploads).\n     * Maps to _meta[\"openai/fileParams\"]\n     */\n    fileParams?: string[];\n\n    /** \n     * Invocation messages shown during tool call.\n     * Maps to _meta[\"openai/toolInvocation\"]\n     */\n    invocation?: {\n        invoking?: string;  // e.g., \"Preparing the board…\"\n        invoked?: string;   // e.g., \"Board ready.\"\n    };\n}\n\n\n/**\n * Decorator that links a tool to a UI component for ChatGPT Apps.\n * \n * When the tool is called, the host will fetch the UI resource\n * which returns the component rendered as HTML with 'text/html+skybridge'.\n * \n * @example\n * ```typescript\n * import { Tool } from '@leanmcp/core';\n * import { GPTApp } from '@leanmcp/ui';\n * import { KanbanBoard } from './KanbanBoard';\n * \n * class KanbanService {\n *   @Tool({ description: 'Show Kanban Board' })\n *   @GPTApp({ \n *     component: KanbanBoard,\n *     widgetAccessible: true,\n *     invocation: { invoking: 'Loading board...' }\n *   })\n *   async showBoard() { ... }\n * }\n * ```\n */\nexport function GPTApp(options: GPTAppOptions): MethodDecorator {\n    return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n        const methodName = String(propertyKey);\n        // Use same pattern as @Resource in @leanmcp/core: className without 'service' suffix\n        const className = target.constructor.name.toLowerCase().replace('service', '');\n\n        // Generate URI using ui:// scheme (required by ext-apps hosts)\n        const uri = options.uri ?? `ui://${className}/${methodName}`;\n\n        // Store metadata on the method\n        Reflect.defineMetadata(GPT_APP_COMPONENT_KEY, options.component, descriptor.value!);\n        Reflect.defineMetadata(GPT_APP_URI_KEY, uri, descriptor.value!);\n        Reflect.defineMetadata(GPT_APP_OPTIONS_KEY, options, descriptor.value!);\n\n        // Also store the resource URI and OpenAI-specific metadata for the @Tool decorator to pick up\n        const existingMeta = Reflect.getMetadata('tool:meta', descriptor.value) || {};\n\n        // Build nested ui metadata (preferred by ext-apps 0.2.2)\n        const uiMeta: Record<string, any> = {\n            resourceUri: uri,\n        };\n\n        // Map visibility to ext-apps format\n        if (options.visibility) {\n            uiMeta.visibility = options.visibility === 'private' ? ['app'] : ['model', 'app'];\n        }\n\n        const openAiMeta: Record<string, any> = {\n            // New nested format (preferred by ext-apps 0.2.2)\n            ui: uiMeta,\n            // Legacy flat format (for backwards compatibility)\n            'ui/resourceUri': uri,\n            'openai/outputTemplate': uri,\n        };\n\n        if (options.widgetAccessible !== undefined) {\n            openAiMeta['openai/widgetAccessible'] = options.widgetAccessible;\n        }\n\n        if (options.visibility) {\n            openAiMeta['openai/visibility'] = options.visibility;\n        }\n\n        if (options.prefersBorder !== undefined) {\n            openAiMeta['openai/widgetPrefersBorder'] = options.prefersBorder;\n        }\n\n        if (options.widgetDomain) {\n            openAiMeta['openai/widgetDomain'] = options.widgetDomain;\n        }\n\n        if (options.widgetDescription) {\n            openAiMeta['openai/widgetDescription'] = options.widgetDescription;\n        }\n\n        if (options.csp) {\n            openAiMeta['openai/widgetCSP'] = options.csp;\n        }\n\n        if (options.fileParams) {\n            openAiMeta['openai/fileParams'] = options.fileParams;\n        }\n\n        if (options.invocation) {\n            if (options.invocation.invoking) openAiMeta['openai/toolInvocation/invoking'] = options.invocation.invoking;\n            if (options.invocation.invoked) openAiMeta['openai/toolInvocation/invoked'] = options.invocation.invoked;\n        }\n\n        Reflect.defineMetadata('tool:meta', {\n            ...existingMeta,\n            ...openAiMeta,\n        }, descriptor.value!);\n\n        return descriptor;\n    };\n}\n\n/**\n * Helper to get GPTApp metadata from a method\n */\nexport function getGPTAppMetadata(target: Function): GPTAppOptions | undefined {\n    const component = Reflect.getMetadata(GPT_APP_COMPONENT_KEY, target);\n    if (!component) return undefined;\n\n    return {\n        component,\n        uri: Reflect.getMetadata(GPT_APP_URI_KEY, target),\n        ...Reflect.getMetadata(GPT_APP_OPTIONS_KEY, target),\n    };\n}\n\n/**\n * Helper to get the resource URI from a method\n */\nexport function getGPTAppUri(target: Function): string | undefined {\n    return Reflect.getMetadata(GPT_APP_URI_KEY, target);\n}\n"]}

package/dist/chunk-5RGEQPF3.mjs

@@ -0,0 +1,124 @@
+import 'reflect-metadata';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var UI_APP_COMPONENT_KEY = "ui:app:component";
+var UI_APP_URI_KEY = "ui:app:uri";
+var UI_APP_OPTIONS_KEY = "ui:app:options";
+function UIApp(options) {
+  return (target, propertyKey, descriptor) => {
+    const methodName = String(propertyKey);
+    const className = target.constructor.name.toLowerCase().replace("service", "");
+    const uri = options.uri ?? `ui://${className}/${methodName}`;
+    Reflect.defineMetadata(UI_APP_COMPONENT_KEY, options.component, descriptor.value);
+    Reflect.defineMetadata(UI_APP_URI_KEY, uri, descriptor.value);
+    Reflect.defineMetadata(UI_APP_OPTIONS_KEY, options, descriptor.value);
+    const existingMeta = Reflect.getMetadata("tool:meta", descriptor.value) || {};
+    Reflect.defineMetadata("tool:meta", {
+      ...existingMeta,
+      // New nested format (preferred by ext-apps 0.2.2)
+      ui: {
+        resourceUri: uri
+      },
+      // Legacy flat format (for backwards compatibility)
+      "ui/resourceUri": uri
+    }, descriptor.value);
+    return descriptor;
+  };
+}
+__name(UIApp, "UIApp");
+function getUIAppMetadata(target) {
+  const component = Reflect.getMetadata(UI_APP_COMPONENT_KEY, target);
+  if (!component) return void 0;
+  return {
+    component,
+    uri: Reflect.getMetadata(UI_APP_URI_KEY, target),
+    ...Reflect.getMetadata(UI_APP_OPTIONS_KEY, target)
+  };
+}
+__name(getUIAppMetadata, "getUIAppMetadata");
+function getUIAppUri(target) {
+  return Reflect.getMetadata(UI_APP_URI_KEY, target);
+}
+__name(getUIAppUri, "getUIAppUri");
+var GPT_APP_COMPONENT_KEY = "gptapp:component";
+var GPT_APP_URI_KEY = "gptapp:uri";
+var GPT_APP_OPTIONS_KEY = "gptapp:options";
+function GPTApp(options) {
+  return (target, propertyKey, descriptor) => {
+    const methodName = String(propertyKey);
+    const className = target.constructor.name.toLowerCase().replace("service", "");
+    const uri = options.uri ?? `ui://${className}/${methodName}`;
+    Reflect.defineMetadata(GPT_APP_COMPONENT_KEY, options.component, descriptor.value);
+    Reflect.defineMetadata(GPT_APP_URI_KEY, uri, descriptor.value);
+    Reflect.defineMetadata(GPT_APP_OPTIONS_KEY, options, descriptor.value);
+    const existingMeta = Reflect.getMetadata("tool:meta", descriptor.value) || {};
+    const uiMeta = {
+      resourceUri: uri
+    };
+    if (options.visibility) {
+      uiMeta.visibility = options.visibility === "private" ? [
+        "app"
+      ] : [
+        "model",
+        "app"
+      ];
+    }
+    const openAiMeta = {
+      // New nested format (preferred by ext-apps 0.2.2)
+      ui: uiMeta,
+      // Legacy flat format (for backwards compatibility)
+      "ui/resourceUri": uri,
+      "openai/outputTemplate": uri
+    };
+    if (options.widgetAccessible !== void 0) {
+      openAiMeta["openai/widgetAccessible"] = options.widgetAccessible;
+    }
+    if (options.visibility) {
+      openAiMeta["openai/visibility"] = options.visibility;
+    }
+    if (options.prefersBorder !== void 0) {
+      openAiMeta["openai/widgetPrefersBorder"] = options.prefersBorder;
+    }
+    if (options.widgetDomain) {
+      openAiMeta["openai/widgetDomain"] = options.widgetDomain;
+    }
+    if (options.widgetDescription) {
+      openAiMeta["openai/widgetDescription"] = options.widgetDescription;
+    }
+    if (options.csp) {
+      openAiMeta["openai/widgetCSP"] = options.csp;
+    }
+    if (options.fileParams) {
+      openAiMeta["openai/fileParams"] = options.fileParams;
+    }
+    if (options.invocation) {
+      if (options.invocation.invoking) openAiMeta["openai/toolInvocation/invoking"] = options.invocation.invoking;
+      if (options.invocation.invoked) openAiMeta["openai/toolInvocation/invoked"] = options.invocation.invoked;
+    }
+    Reflect.defineMetadata("tool:meta", {
+      ...existingMeta,
+      ...openAiMeta
+    }, descriptor.value);
+    return descriptor;
+  };
+}
+__name(GPTApp, "GPTApp");
+function getGPTAppMetadata(target) {
+  const component = Reflect.getMetadata(GPT_APP_COMPONENT_KEY, target);
+  if (!component) return void 0;
+  return {
+    component,
+    uri: Reflect.getMetadata(GPT_APP_URI_KEY, target),
+    ...Reflect.getMetadata(GPT_APP_OPTIONS_KEY, target)
+  };
+}
+__name(getGPTAppMetadata, "getGPTAppMetadata");
+function getGPTAppUri(target) {
+  return Reflect.getMetadata(GPT_APP_URI_KEY, target);
+}
+__name(getGPTAppUri, "getGPTAppUri");
+
+export { GPTApp, GPT_APP_COMPONENT_KEY, GPT_APP_OPTIONS_KEY, GPT_APP_URI_KEY, UIApp, UI_APP_COMPONENT_KEY, UI_APP_OPTIONS_KEY, UI_APP_URI_KEY, __name, getGPTAppMetadata, getGPTAppUri, getUIAppMetadata, getUIAppUri };
+//# sourceMappingURL=chunk-5RGEQPF3.mjs.map
+//# sourceMappingURL=chunk-5RGEQPF3.mjs.map

package/dist/chunk-5RGEQPF3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/decorator/UIApp.ts","../src/decorator/GPTApp.ts"],"names":["UI_APP_COMPONENT_KEY","UI_APP_URI_KEY","UI_APP_OPTIONS_KEY","UIApp","options","target","propertyKey","descriptor","methodName","String","className","name","toLowerCase","replace","uri","Reflect","defineMetadata","component","value","existingMeta","getMetadata","ui","resourceUri","getUIAppMetadata","undefined","getUIAppUri","GPT_APP_COMPONENT_KEY","GPT_APP_URI_KEY","GPT_APP_OPTIONS_KEY","GPTApp","uiMeta","visibility","openAiMeta","widgetAccessible","prefersBorder","widgetDomain","widgetDescription","csp","fileParams","invocation","invoking","invoked","getGPTAppMetadata","getGPTAppUri"],"mappings":"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","file":"chunk-5RGEQPF3.mjs","sourcesContent":["/**\n * @UIApp Decorator\n * \n * Links an MCP tool to a React UI component.\n * When applied to a tool method, it:\n * 1. Adds _meta.ui/resourceUri to the tool definition\n * 2. Auto-registers a resource that renders the component to HTML\n * \n * This decorator is designed to work with @leanmcp/core decorators.\n */\nimport 'reflect-metadata';\nimport type React from 'react';\n\n// Metadata keys\nexport const UI_APP_COMPONENT_KEY = 'ui:app:component';\nexport const UI_APP_URI_KEY = 'ui:app:uri';\nexport const UI_APP_OPTIONS_KEY = 'ui:app:options';\n\n/**\n * Options for @UIApp decorator\n */\nexport interface UIAppOptions {\n    /** \n     * React component or path to component file (relative to service file).\n     * - Use path string (e.g., './WeatherCard') for CLI build - avoids importing browser code in server\n     * - Use component reference for direct SSR rendering\n     */\n    component: React.ComponentType<any> | string;\n    /** Custom resource URI (auto-generated if not provided) */\n    uri?: string;\n    /** HTML document title */\n    title?: string;\n    /** Additional CSS styles */\n    styles?: string;\n}\n\n\n/**\n * Decorator that links a tool to a UI component.\n * \n * When the tool is called, the host will fetch the UI resource\n * which returns the component rendered as HTML.\n * \n * @example\n * ```typescript\n * import { Tool } from '@leanmcp/core';\n * import { UIApp } from '@leanmcp/ui';\n * import { WeatherCard } from './WeatherCard';\n * \n * class WeatherService {\n *   @Tool({ description: 'Get weather for a city' })\n *   @UIApp({ component: WeatherCard })\n *   async getWeather(args: { city: string }) {\n *     return { city: args.city, temp: 22 };\n *   }\n * }\n * ```\n */\nexport function UIApp(options: UIAppOptions): MethodDecorator {\n    return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n        const methodName = String(propertyKey);\n        // Use same pattern as @Resource in @leanmcp/core: className without 'service' suffix\n        const className = target.constructor.name.toLowerCase().replace('service', '');\n\n        // Generate URI using ui:// scheme (required by ext-apps hosts)\n        const uri = options.uri ?? `ui://${className}/${methodName}`;\n\n        // Store metadata on the method\n        Reflect.defineMetadata(UI_APP_COMPONENT_KEY, options.component, descriptor.value!);\n        Reflect.defineMetadata(UI_APP_URI_KEY, uri, descriptor.value!);\n        Reflect.defineMetadata(UI_APP_OPTIONS_KEY, options, descriptor.value!);\n\n        // Also store the resource URI for the @Tool decorator to pick up\n        // The @Tool decorator in @leanmcp/core should check for this\n        const existingMeta = Reflect.getMetadata('tool:meta', descriptor.value) || {};\n        Reflect.defineMetadata('tool:meta', {\n            ...existingMeta,\n            // New nested format (preferred by ext-apps 0.2.2)\n            ui: {\n                resourceUri: uri,\n            },\n            // Legacy flat format (for backwards compatibility)\n            'ui/resourceUri': uri,\n        }, descriptor.value!);\n\n        return descriptor;\n    };\n}\n\n/**\n * Helper to get UIApp metadata from a method\n */\nexport function getUIAppMetadata(target: Function): UIAppOptions | undefined {\n    const component = Reflect.getMetadata(UI_APP_COMPONENT_KEY, target);\n    if (!component) return undefined;\n\n    return {\n        component,\n        uri: Reflect.getMetadata(UI_APP_URI_KEY, target),\n        ...Reflect.getMetadata(UI_APP_OPTIONS_KEY, target),\n    };\n}\n\n/**\n * Helper to get the resource URI from a method\n */\nexport function getUIAppUri(target: Function): string | undefined {\n    return Reflect.getMetadata(UI_APP_URI_KEY, target);\n}\n","/**\n * @GPTApp Decorator\n * \n * Links an MCP tool to a React UI component compliant with ChatGPT Apps SDK.\n * \n * When applied to a tool method, it:\n * 1. Adds _meta.ui/resourceUri to the tool definition\n * 2. Adds OpenAI-specific metadata (widgetAccessible, outputTemplate, etc.)\n * 3. Auto-registers a resource that renders the component to HTML with 'text/html+skybridge' mimeType\n */\nimport 'reflect-metadata';\nimport type React from 'react';\n\n// Metadata keys\nexport const GPT_APP_COMPONENT_KEY = 'gptapp:component';\nexport const GPT_APP_URI_KEY = 'gptapp:uri';\nexport const GPT_APP_OPTIONS_KEY = 'gptapp:options';\n\n/**\n * Options for @GPTApp decorator\n */\nexport interface GPTAppOptions {\n    /** \n     * React component or path to component file (relative to service file).\n     * - Use path string (e.g., './WeatherCard') for CLI build - avoids importing browser code in server\n     * - Use component reference for direct SSR rendering\n     */\n    component: React.ComponentType<any> | string;\n\n    /** Custom resource URI (auto-generated ui://... if not provided) */\n    uri?: string;\n\n    /** HTML document title */\n    title?: string;\n\n    /** Additional CSS styles */\n    styles?: string;\n\n    // ========== GPT-specific options ==========\n\n    /** \n     * Allow widget to call tools via window.openai.callTool.\n     * Maps to _meta[\"openai/widgetAccessible\"]\n     */\n    widgetAccessible?: boolean;\n\n    /** \n     * Tool visibility: 'public' (default) or 'private'.\n     * 'private' hides the tool from the model but keeps it callable by the widget.\n     * Maps to _meta[\"openai/visibility\"]\n     */\n    visibility?: 'public' | 'private';\n\n    /** \n     * Widget prefers border around iframe.\n     * Maps to _meta[\"openai/widgetPrefersBorder\"]\n     */\n    prefersBorder?: boolean;\n\n    /** \n     * Widget domain for API allowlists.\n     * Maps to _meta[\"openai/widgetDomain\"]\n     */\n    widgetDomain?: string;\n\n    /** \n     * Widget description for the model.\n     * Maps to _meta[\"openai/widgetDescription\"]\n     */\n    widgetDescription?: string;\n\n    /** \n     * Content Security Policy configuration.\n     * Maps to _meta[\"openai/widgetCSP\"]\n     */\n    csp?: {\n        connect_domains?: string[];\n        resource_domains?: string[];\n        redirect_domains?: string[];\n        frame_domains?: string[];\n    };\n\n    /** \n     * File parameters (fields treated as file uploads).\n     * Maps to _meta[\"openai/fileParams\"]\n     */\n    fileParams?: string[];\n\n    /** \n     * Invocation messages shown during tool call.\n     * Maps to _meta[\"openai/toolInvocation\"]\n     */\n    invocation?: {\n        invoking?: string;  // e.g., \"Preparing the board…\"\n        invoked?: string;   // e.g., \"Board ready.\"\n    };\n}\n\n\n/**\n * Decorator that links a tool to a UI component for ChatGPT Apps.\n * \n * When the tool is called, the host will fetch the UI resource\n * which returns the component rendered as HTML with 'text/html+skybridge'.\n * \n * @example\n * ```typescript\n * import { Tool } from '@leanmcp/core';\n * import { GPTApp } from '@leanmcp/ui';\n * import { KanbanBoard } from './KanbanBoard';\n * \n * class KanbanService {\n *   @Tool({ description: 'Show Kanban Board' })\n *   @GPTApp({ \n *     component: KanbanBoard,\n *     widgetAccessible: true,\n *     invocation: { invoking: 'Loading board...' }\n *   })\n *   async showBoard() { ... }\n * }\n * ```\n */\nexport function GPTApp(options: GPTAppOptions): MethodDecorator {\n    return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n        const methodName = String(propertyKey);\n        // Use same pattern as @Resource in @leanmcp/core: className without 'service' suffix\n        const className = target.constructor.name.toLowerCase().replace('service', '');\n\n        // Generate URI using ui:// scheme (required by ext-apps hosts)\n        const uri = options.uri ?? `ui://${className}/${methodName}`;\n\n        // Store metadata on the method\n        Reflect.defineMetadata(GPT_APP_COMPONENT_KEY, options.component, descriptor.value!);\n        Reflect.defineMetadata(GPT_APP_URI_KEY, uri, descriptor.value!);\n        Reflect.defineMetadata(GPT_APP_OPTIONS_KEY, options, descriptor.value!);\n\n        // Also store the resource URI and OpenAI-specific metadata for the @Tool decorator to pick up\n        const existingMeta = Reflect.getMetadata('tool:meta', descriptor.value) || {};\n\n        // Build nested ui metadata (preferred by ext-apps 0.2.2)\n        const uiMeta: Record<string, any> = {\n            resourceUri: uri,\n        };\n\n        // Map visibility to ext-apps format\n        if (options.visibility) {\n            uiMeta.visibility = options.visibility === 'private' ? ['app'] : ['model', 'app'];\n        }\n\n        const openAiMeta: Record<string, any> = {\n            // New nested format (preferred by ext-apps 0.2.2)\n            ui: uiMeta,\n            // Legacy flat format (for backwards compatibility)\n            'ui/resourceUri': uri,\n            'openai/outputTemplate': uri,\n        };\n\n        if (options.widgetAccessible !== undefined) {\n            openAiMeta['openai/widgetAccessible'] = options.widgetAccessible;\n        }\n\n        if (options.visibility) {\n            openAiMeta['openai/visibility'] = options.visibility;\n        }\n\n        if (options.prefersBorder !== undefined) {\n            openAiMeta['openai/widgetPrefersBorder'] = options.prefersBorder;\n        }\n\n        if (options.widgetDomain) {\n            openAiMeta['openai/widgetDomain'] = options.widgetDomain;\n        }\n\n        if (options.widgetDescription) {\n            openAiMeta['openai/widgetDescription'] = options.widgetDescription;\n        }\n\n        if (options.csp) {\n            openAiMeta['openai/widgetCSP'] = options.csp;\n        }\n\n        if (options.fileParams) {\n            openAiMeta['openai/fileParams'] = options.fileParams;\n        }\n\n        if (options.invocation) {\n            if (options.invocation.invoking) openAiMeta['openai/toolInvocation/invoking'] = options.invocation.invoking;\n            if (options.invocation.invoked) openAiMeta['openai/toolInvocation/invoked'] = options.invocation.invoked;\n        }\n\n        Reflect.defineMetadata('tool:meta', {\n            ...existingMeta,\n            ...openAiMeta,\n        }, descriptor.value!);\n\n        return descriptor;\n    };\n}\n\n/**\n * Helper to get GPTApp metadata from a method\n */\nexport function getGPTAppMetadata(target: Function): GPTAppOptions | undefined {\n    const component = Reflect.getMetadata(GPT_APP_COMPONENT_KEY, target);\n    if (!component) return undefined;\n\n    return {\n        component,\n        uri: Reflect.getMetadata(GPT_APP_URI_KEY, target),\n        ...Reflect.getMetadata(GPT_APP_OPTIONS_KEY, target),\n    };\n}\n\n/**\n * Helper to get the resource URI from a method\n */\nexport function getGPTAppUri(target: Function): string | undefined {\n    return Reflect.getMetadata(GPT_APP_URI_KEY, target);\n}\n"]}

package/dist/globals.css

@@ -0,0 +1,138 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/**
+ * MCP-Native UI SDK - Global Styles
+ * 
+ * CSS variables that integrate with MCP Host theming.
+ * MCP hosts provide variables like --color-background-primary, --color-text-primary, etc.
+ * We map these to shadcn-compatible variables for seamless theming.
+ */
+
+@layer base {
+    :root {
+        /* === Background colors === */
+        /* Map MCP host variables to shadcn variables, with fallbacks */
+        --background: var(--color-background-primary, 0 0% 100%);
+        --foreground: var(--color-text-primary, 222.2 84% 4.9%);
+
+        --card: var(--color-background-secondary, 0 0% 100%);
+        --card-foreground: var(--color-text-primary, 222.2 84% 4.9%);
+
+        --popover: 0 0% 100%;
+        --popover-foreground: 222.2 84% 4.9%;
+
+        /* === Brand colors === */
+        --primary: 222.2 47.4% 11.2%;
+        --primary-foreground: 210 40% 98%;
+
+        --secondary: var(--color-background-tertiary, 210 40% 96.1%);
+        --secondary-foreground: 222.2 47.4% 11.2%;
+
+        --muted: 210 40% 96.1%;
+        --muted-foreground: var(--color-text-secondary, 215.4 16.3% 46.9%);
+
+        --accent: 210 40% 96.1%;
+        --accent-foreground: 222.2 47.4% 11.2%;
+
+        /* === Semantic colors === */
+        --destructive: var(--color-background-danger, 0 84.2% 60.2%);
+        --destructive-foreground: 210 40% 98%;
+
+        --success: var(--color-background-success, 142 76% 36%);
+        --success-foreground: 0 0% 100%;
+
+        --warning: var(--color-background-warning, 38 92% 50%);
+        --warning-foreground: 0 0% 0%;
+
+        --info: var(--color-background-info, 199 89% 48%);
+        --info-foreground: 0 0% 100%;
+
+        /* === Border and focus === */
+        --border: var(--color-border-primary, 214.3 31.8% 91.4%);
+        --input: 214.3 31.8% 91.4%;
+        --ring: var(--color-ring-primary, 222.2 84% 4.9%);
+
+        /* === Geometry === */
+        --radius: var(--border-radius-md, 0.5rem);
+
+        /* === Typography === */
+        --font-sans: var(--font-sans, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif);
+        --font-mono: var(--font-mono, ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace);
+    }
+
+    /* Dark mode - activated by class or data attribute */
+    .dark,
+    [data-theme="dark"] {
+        --background: var(--color-background-primary, 222.2 84% 4.9%);
+        --foreground: var(--color-text-primary, 210 40% 98%);
+
+        --card: var(--color-background-secondary, 222.2 84% 4.9%);
+        --card-foreground: var(--color-text-primary, 210 40% 98%);
+
+        --popover: 222.2 84% 4.9%;
+        --popover-foreground: 210 40% 98%;
+
+        --primary: 210 40% 98%;
+        --primary-foreground: 222.2 47.4% 11.2%;
+
+        --secondary: var(--color-background-tertiary, 217.2 32.6% 17.5%);
+        --secondary-foreground: 210 40% 98%;
+
+        --muted: 217.2 32.6% 17.5%;
+        --muted-foreground: var(--color-text-secondary, 215 20.2% 65.1%);
+
+        --accent: 217.2 32.6% 17.5%;
+        --accent-foreground: 210 40% 98%;
+
+        --destructive: var(--color-background-danger, 0 62.8% 30.6%);
+        --destructive-foreground: 210 40% 98%;
+
+        --success: var(--color-background-success, 142 69% 58%);
+        --success-foreground: 0 0% 0%;
+
+        --warning: var(--color-background-warning, 38 92% 50%);
+        --warning-foreground: 0 0% 0%;
+
+        --info: var(--color-background-info, 199 89% 48%);
+        --info-foreground: 0 0% 0%;
+
+        --border: var(--color-border-primary, 217.2 32.6% 17.5%);
+        --input: 217.2 32.6% 17.5%;
+        --ring: var(--color-ring-primary, 212.7 26.8% 83.9%);
+    }
+}
+
+@layer base {
+    * {
+        @apply border-border;
+    }
+
+    body {
+        @apply bg-background text-foreground;
+        font-feature-settings: "rlig" 1, "calt" 1;
+    }
+
+    /* Focus visible styles for accessibility */
+    :focus-visible {
+        @apply outline-none ring-2 ring-ring ring-offset-2 ring-offset-background;
+    }
+}
+
+/* === MCP App Root Styles === */
+.lui-root {
+    @apply bg-background text-foreground min-h-full;
+    font-family: var(--font-sans);
+}
+
+/* === Loading spinner animation === */
+@keyframes lui-spinner {
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+.lui-spinner {
+    animation: lui-spinner 1s linear infinite;
+}