@frontmcp/uipack 0.6.1 → 0.6.2

package/utils/index.js

@@ -23,6 +23,8 @@ __export(utils_exports, {
   escapeHtml: () => escapeHtml,
   escapeHtmlAttr: () => escapeHtmlAttr,
   escapeJsString: () => escapeJsString,
+  escapeScriptClose: () => escapeScriptClose,
+  safeJsonForScript: () => safeJsonForScript,
   safeStringify: () => safeStringify
 });
 module.exports = __toCommonJS(utils_exports);
@@ -61,10 +63,34 @@ function escapeHtmlAttr(str) {
 function escapeJsString(str) {
   return str.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
+function escapeScriptClose(jsonString) {
+  return jsonString.replace(/<\//g, "<\\/");
+}
+function safeJsonForScript(value) {
+  if (value === void 0) {
+    return "null";
+  }
+  try {
+    const jsonString = JSON.stringify(value, (_key, val) => {
+      if (typeof val === "bigint") {
+        return val.toString();
+      }
+      return val;
+    });
+    if (jsonString === void 0) {
+      return "null";
+    }
+    return escapeScriptClose(jsonString);
+  } catch {
+    return '{"error":"Value could not be serialized"}';
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   escapeHtml,
   escapeHtmlAttr,
   escapeJsString,
+  escapeScriptClose,
+  safeJsonForScript,
   safeStringify
 });

package/validation/index.js

@@ -282,7 +282,6 @@ var PATH_REGEX = /\b(output|input|structuredContent)(\.[a-zA-Z_$][a-zA-Z0-9_$]*|
 var KEYWORDS = /* @__PURE__ */ new Set(["this", "else", "@index", "@key", "@first", "@last", "@root"]);
 function extractExpressions(template) {
   const expressions = [];
-  const lines = template.split("\n");
   const positionMap = buildPositionMap(template);
   let match;
   EXPRESSION_REGEX.lastIndex = 0;

package/validation/template-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-validator.d.ts","sourceRoot":"","sources":["../../src/validation/template-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,kDAAkD;IAClD,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,CAAC,UAAU,EAC1B,OAAO,GAAE,uBAA4B,GACpC,wBAAwB,CAsG1B;AA4HD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0CnG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK9F;AAMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOxG;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAGrF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,CAGvF"}
+{"version":3,"file":"template-validator.d.ts","sourceRoot":"","sources":["../../src/validation/template-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB;IACjB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,kDAAkD;IAClD,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,CAAC,UAAU,EAC1B,OAAO,GAAE,uBAA4B,GACpC,wBAAwB,CAsG1B;AA4HD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0CnG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK9F;AAMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOxG;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAGrF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,CAGvF"}

package/esm/adapters/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * @frontmcp/ui Adapters
- *
- * Platform-specific adapters for building UI metadata.
- * These adapters are SDK-independent and can be used by external systems
- * like AgentLink without requiring @frontmcp/sdk.
- *
- * @packageDocumentation
- */
-export { type AIPlatformType, type UIMetadata, type BuildUIMetaOptions, type BuildToolDiscoveryMetaOptions, buildUIMeta, buildToolDiscoveryMeta, buildOpenAICSP, } from './platform-meta';
-export { type ResolvedServingMode, type ResolveServingModeOptions, resolveServingMode, isPlatformModeSupported, getDefaultServingMode, platformUsesStructuredContent, platformSupportsWidgets, } from './serving-mode';
-export { type TextContentBlock, type BuildToolResponseOptions, type ToolResponseContent, buildToolResponseContent, } from './response-builder';
-//# sourceMappingURL=index.d.ts.map

package/esm/adapters/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAElC,WAAW,EACX,sBAAsB,EACtB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAE9B,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EAExB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/esm/adapters/platform-meta.d.ts

@@ -1,166 +0,0 @@
-/**
- * Platform Metadata Adapters
- *
- * Build platform-specific _meta fields for tool UI responses.
- * Adapts the UI configuration to the format expected by each
- * AI platform (OpenAI, Claude, Gemini, etc.).
- *
- * This module is SDK-independent and can be used by external systems
- * like AgentLink without requiring @frontmcp/sdk.
- *
- * @packageDocumentation
- */
-import type { UITemplateConfig, UIContentSecurityPolicy } from '../types';
-/**
- * Supported AI platform types.
- * Used to determine which metadata format to generate.
- */
-export type AIPlatformType = 'openai' | 'claude' | 'gemini' | 'cursor' | 'continue' | 'cody' | 'generic-mcp' | 'ext-apps' | 'unknown';
-/**
- * UI metadata to include in tool response _meta field.
- * Contains both universal fields and platform-specific annotations.
- */
-export interface UIMetadata {
-    /** Inline rendered HTML (universal) */
-    'ui/html'?: string;
-    /** MIME type for the HTML content */
-    'ui/mimeType'?: string;
-    /** Widget token for authenticated operations */
-    'ui/widgetToken'?: string;
-    /** Direct URL to widget (for direct-url serving mode) */
-    'ui/directUrl'?: string;
-    /** Renderer type for the widget (html, react, mdx, markdown, auto) */
-    'ui/type'?: string;
-    /** Manifest URI for accessing widget configuration */
-    'ui/manifestUri'?: string;
-    /** Hash of the widget content for cache validation */
-    'ui/contentHash'?: string;
-    /** Required renderer assets for lazy loading */
-    'ui/requiredRenderers'?: string[];
-    /** OpenAI: Resource URI for widget template */
-    'openai/outputTemplate'?: string;
-    /** OpenAI: Whether widget can invoke tools */
-    'openai/widgetAccessible'?: boolean;
-    /** OpenAI: Whether tool result can produce a widget (CRITICAL for ChatGPT) */
-    'openai/resultCanProduceWidget'?: boolean;
-    /** OpenAI: CSP configuration */
-    'openai/widgetCSP'?: {
-        connect_domains?: string[];
-        resource_domains?: string[];
-    };
-    /** OpenAI: Display mode preference */
-    'openai/displayMode'?: string;
-    /** OpenAI: Widget description */
-    'openai/widgetDescription'?: string;
-    /** OpenAI: Status text while tool is executing */
-    'openai/toolInvocation/invoking'?: string;
-    /** OpenAI: Status text after tool execution completes */
-    'openai/toolInvocation/invoked'?: string;
-    /** Claude: Widget description */
-    'claude/widgetDescription'?: string;
-    /** Gemini: Widget description */
-    'gemini/widgetDescription'?: string;
-    /** IDE: Resource URI for widget template */
-    'ide/outputTemplate'?: string;
-    /** IDE: Widget description */
-    'ide/widgetDescription'?: string;
-    /** MCP Apps: Resource URI for UI template */
-    'ui/resourceUri'?: string;
-    /** MCP Apps: CSP configuration */
-    'ui/csp'?: {
-        connectDomains?: string[];
-        resourceDomains?: string[];
-    };
-    /** MCP Apps: Dedicated sandbox domain */
-    'ui/domain'?: string;
-    /** MCP Apps: Whether to show border around UI */
-    'ui/prefersBorder'?: boolean;
-    /** MCP Apps: Display mode */
-    'ui/displayMode'?: 'inline' | 'fullscreen' | 'pip';
-    /** Allow additional platform-specific fields */
-    [key: string]: unknown;
-}
-/**
- * Options for building UI metadata.
- */
-export interface BuildUIMetaOptions<In = unknown, Out = unknown> {
-    /** Tool UI configuration */
-    uiConfig: UITemplateConfig<In, Out>;
-    /** Detected platform type */
-    platformType: AIPlatformType;
-    /** Rendered HTML content */
-    html: string;
-    /** Widget access token */
-    token?: string;
-    /** Direct URL for widget serving */
-    directUrl?: string;
-    /** Renderer type for the widget (html, react, mdx, markdown, auto) */
-    rendererType?: string;
-    /** Hash of the widget content for cache validation */
-    contentHash?: string;
-    /** Manifest URI for accessing widget configuration */
-    manifestUri?: string;
-}
-/**
- * Build platform-specific UI metadata for tool response.
- *
- * For inline serving mode (default), HTML is embedded directly in `_meta['ui/html']`.
- * For static mode, the static widget URI is provided in tools/list
- * and the tool response contains only structured data.
- *
- * @example
- * ```typescript
- * import { buildUIMeta } from '@frontmcp/ui/adapters';
- *
- * const meta = buildUIMeta({
- *   uiConfig: { template: (ctx) => `<div>${ctx.output.value}</div>` },
- *   platformType: 'openai',
- *   html: '<div>Hello World</div>',
- * });
- * ```
- */
-export declare function buildUIMeta<In = unknown, Out = unknown>(options: BuildUIMetaOptions<In, Out>): UIMetadata;
-/**
- * Build OpenAI CSP format.
- */
-export declare function buildOpenAICSP(csp: UIContentSecurityPolicy): {
-    connect_domains?: string[];
-    resource_domains?: string[];
-};
-/**
- * Build metadata for tool discovery (tools/list response).
- * This includes fields that should be present at discovery time,
- * not in individual tool call responses.
- *
- * @example
- * ```typescript
- * import { buildToolDiscoveryMeta } from '@frontmcp/ui/adapters';
- *
- * const toolMeta = buildToolDiscoveryMeta({
- *   uiConfig: { template: MyWidget, widgetAccessible: true },
- *   platformType: 'openai',
- *   staticWidgetUri: 'ui://widget/my_tool.html',
- * });
- *
- * // Use in tools/list response
- * const tool = {
- *   name: 'my_tool',
- *   description: '...',
- *   inputSchema: {...},
- *   _meta: toolMeta,
- * };
- * ```
- */
-export interface BuildToolDiscoveryMetaOptions<In = unknown, Out = unknown> {
-    /** Tool UI configuration */
-    uiConfig: UITemplateConfig<In, Out>;
-    /** Detected platform type */
-    platformType: AIPlatformType;
-    /** Static widget URI (e.g., ui://widget/my_tool.html) */
-    staticWidgetUri: string;
-}
-/**
- * Build tool discovery metadata (for tools/list response).
- */
-export declare function buildToolDiscoveryMeta<In = unknown, Out = unknown>(options: BuildToolDiscoveryMetaOptions<In, Out>): UIMetadata;
-//# sourceMappingURL=platform-meta.d.ts.map

package/esm/adapters/platform-meta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform-meta.d.ts","sourceRoot":"","sources":["../../../src/adapters/platform-meta.ts"],"names":[],"mappings":"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"}

package/esm/adapters/response-builder.d.ts

@@ -1,108 +0,0 @@
-/**
- * @file response-builder.ts
- * @description Tool response content builder for different serving modes and platforms.
- *
- * This module consolidates all the content formatting logic for tool responses,
- * handling the various output formats based on serving mode and platform capabilities.
- *
- * For platforms with useStructuredContent=true (all widget-supporting platforms):
- * - content: [{ type: 'text', text: '<!DOCTYPE html>...' }]  (single block with raw HTML)
- * - structuredContent: raw tool output (set by SDK, not this module)
- */
-import type { WidgetServingMode } from '../types';
-import type { AIPlatformType } from './platform-meta';
-/**
- * Text content block for MCP responses.
- */
-export interface TextContentBlock {
-    type: 'text';
-    text: string;
-}
-/**
- * Options for building tool response content.
- */
-export interface BuildToolResponseOptions {
-    /**
-     * The raw output from the tool execution.
-     */
-    rawOutput: unknown;
-    /**
-     * Rendered HTML content (for inline mode).
-     */
-    htmlContent?: string;
-    /**
-     * The effective serving mode (after resolution from 'auto').
-     */
-    servingMode: Exclude<WidgetServingMode, 'auto'>;
-    /**
-     * Whether to use structuredContent format.
-     * When true, raw HTML is returned in content and rawOutput goes to structuredContent.
-     */
-    useStructuredContent: boolean;
-    /**
-     * The detected platform type.
-     */
-    platformType: AIPlatformType;
-}
-/**
- * Result of building tool response content.
- */
-export interface ToolResponseContent {
-    /**
-     * The content blocks to include in the response.
-     * For structuredContent format: single TextContent with raw HTML.
-     * For widget format: empty (widget reads from _meta).
-     */
-    content: TextContentBlock[];
-    /**
-     * Structured content containing raw tool output.
-     * Set when useStructuredContent is true.
-     */
-    structuredContent?: unknown;
-    /**
-     * Metadata to merge into result._meta.
-     */
-    meta?: Record<string, unknown>;
-    /**
-     * Whether the content was cleared (widget platform handles display).
-     */
-    contentCleared: boolean;
-    /**
-     * Format used for the response.
-     */
-    format: 'structured-content' | 'widget' | 'markdown' | 'json-only';
-}
-/**
- * Build the content blocks for a tool response based on serving mode and platform.
- *
- * This function consolidates the content formatting logic that was previously
- * spread across the call-tool.flow.ts finalize stage.
- *
- * @example
- * ```typescript
- * // Platform with structuredContent (all widget-supporting platforms)
- * const result = buildToolResponseContent({
- *   rawOutput: { temperature: 72 },
- *   htmlContent: '<!DOCTYPE html>...',
- *   servingMode: 'inline',
- *   useStructuredContent: true,
- *   platformType: 'claude',
- * });
- * // result.content = [{ type: 'text', text: '<!DOCTYPE html>...' }]
- * // result.structuredContent = { temperature: 72 }
- * // result.format = 'structured-content'
- *
- * // Platform without widget support (gemini, unknown)
- * const geminiResult = buildToolResponseContent({
- *   rawOutput: { temperature: 72 },
- *   htmlContent: '<!DOCTYPE html>...',
- *   servingMode: 'inline',
- *   useStructuredContent: false,
- *   platformType: 'gemini',
- * });
- * // result.content = [{ type: 'text', text: '{"temperature":72}' }]
- * // result.format = 'json-only'
- * ```
- */
-export declare function buildToolResponseContent(options: BuildToolResponseOptions): ToolResponseContent;
-//# sourceMappingURL=response-builder.d.ts.map

package/esm/adapters/response-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../../src/adapters/response-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAEhD;;;OAGG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;CACpE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,mBAAmB,CAkF/F"}

package/esm/adapters/serving-mode.d.ts

@@ -1,107 +0,0 @@
-/**
- * @file serving-mode.ts
- * @description Serving mode resolution for auto-detection based on client capabilities.
- *
- * The `'auto'` serving mode automatically selects the appropriate delivery mechanism
- * based on the MCP client's capabilities:
- *
- * - **OpenAI/ext-apps**: Use `'inline'` mode with `_meta['ui/html']`
- * - **Claude**: Use `'inline'` mode with structuredContent (raw HTML + raw output)
- * - **Gemini/unsupported**: Skip UI entirely (return JSON only)
- *
- * When a specific mode is forced (not 'auto'), but the client doesn't support it,
- * the UI is skipped to prevent broken experiences.
- */
-import type { WidgetServingMode } from '../types';
-import type { AIPlatformType } from './platform-meta';
-/**
- * Result of serving mode resolution.
- */
-export interface ResolvedServingMode {
-    /**
-     * The effective serving mode to use.
-     * `null` means UI should be skipped entirely.
-     */
-    effectiveMode: Exclude<WidgetServingMode, 'auto'> | null;
-    /**
-     * Whether the client supports widget UI.
-     */
-    supportsUI: boolean;
-    /**
-     * Whether structuredContent should be used (Claude).
-     * When true, the response includes raw tool output in structuredContent
-     * and raw HTML in a single content block.
-     */
-    useStructuredContent: boolean;
-    /**
-     * Reason for the decision (useful for logging/debugging).
-     */
-    reason: string;
-}
-/**
- * Options for resolving serving mode.
- */
-export interface ResolveServingModeOptions {
-    /**
-     * The configured serving mode (from UITemplateConfig).
-     * Defaults to 'auto'.
-     */
-    configuredMode?: WidgetServingMode;
-    /**
-     * The detected platform type.
-     */
-    platformType: AIPlatformType;
-}
-/**
- * Resolve the effective serving mode based on configuration and client capabilities.
- *
- * This function implements the 'auto' serving mode logic:
- * 1. If `configuredMode` is 'auto', select the best mode for the platform
- * 2. If a specific mode is forced, check if the platform supports it
- * 3. If the platform doesn't support the mode, return `null` (skip UI)
- *
- * @example
- * ```typescript
- * const result = resolveServingMode({
- *   configuredMode: 'auto',
- *   platformType: 'openai',
- * });
- * // { effectiveMode: 'inline', useStructuredContent: true, supportsUI: true, ... }
- *
- * const claudeResult = resolveServingMode({
- *   configuredMode: 'auto',
- *   platformType: 'claude',
- * });
- * // { effectiveMode: 'inline', useStructuredContent: true, supportsUI: true, ... }
- *
- * const geminiResult = resolveServingMode({
- *   configuredMode: 'auto',
- *   platformType: 'gemini',
- * });
- * // { effectiveMode: null, useStructuredContent: false, supportsUI: false, ... }
- * ```
- */
-export declare function resolveServingMode(options: ResolveServingModeOptions): ResolvedServingMode;
-/**
- * Check if a platform supports a specific serving mode.
- */
-export declare function isPlatformModeSupported(platformType: AIPlatformType, mode: WidgetServingMode): boolean;
-/**
- * Get the default serving mode for a platform.
- */
-export declare function getDefaultServingMode(platformType: AIPlatformType): Exclude<WidgetServingMode, 'auto'> | null;
-/**
- * Check if a platform uses structuredContent format.
- * When true, responses include raw tool output in structuredContent
- * and raw HTML in a single content block.
- */
-export declare function platformUsesStructuredContent(platformType: AIPlatformType): boolean;
-/**
- * Check if a platform supports widget UI via _meta.
- *
- * These platforms can read HTML from _meta['ui/html'] and render it
- * in a sandboxed iframe. They don't need the content blocks filled with
- * formatted data since the widget handles display.
- */
-export declare function platformSupportsWidgets(platformType: AIPlatformType): boolean;
-//# sourceMappingURL=serving-mode.d.ts.map

package/esm/adapters/serving-mode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serving-mode.d.ts","sourceRoot":"","sources":["../../../src/adapters/serving-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAEnC;;OAEG;IACH,YAAY,EAAE,cAAc,CAAC;CAC9B;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,mBAAmB,CA2C1F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAQtG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,IAAI,CAG7G;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAGnF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAG7E"}

package/esm/base-template/bridge.d.ts

@@ -1,90 +0,0 @@
-/**
- * Platform Bridge - Reactive Data Store for Tool UI
- *
- * Provides a reactive interface for tool output data that works across:
- * - React (via useSyncExternalStore)
- * - HTMX (via custom events)
- * - Vanilla JS (via subscribe callbacks)
- *
- * Uses Object.defineProperty to intercept when platforms inject data,
- * automatically detecting and notifying subscribers when data changes.
- *
- * @example React integration
- * ```tsx
- * import { useSyncExternalStore } from 'react';
- *
- * function useToolOutput() {
- *   return useSyncExternalStore(
- *     window.__frontmcp.bridge.subscribe,
- *     window.__frontmcp.bridge.getSnapshot,
- *     window.__frontmcp.bridge.getServerSnapshot
- *   );
- * }
- * ```
- *
- * @example Vanilla JS
- * ```javascript
- * const unsubscribe = window.__frontmcp.bridge.subscribe(() => {
- *   const state = window.__frontmcp.bridge.getState();
- *   if (!state.loading) {
- *     renderWidget(state.data);
- *   }
- * });
- * ```
- *
- * @example HTMX
- * ```html
- * <div hx-trigger="frontmcp:change from:document" hx-get="/render">
- *   Loading...
- * </div>
- * ```
- */
-/**
- * Bridge state containing data, loading status, and error information.
- */
-export interface BridgeState<T = unknown> {
-    /** Current data (null when loading or no data) */
-    data: T | null;
-    /** Whether the bridge is waiting for data */
-    loading: boolean;
-    /** Error message if data loading failed */
-    error: string | null;
-}
-/**
- * Platform Bridge interface for reactive data access.
- */
-export interface PlatformBridge<T = unknown> {
-    /** Get current state snapshot */
-    getState(): BridgeState<T>;
-    /** Subscribe to state changes */
-    subscribe(callback: () => void): () => void;
-    /** React useSyncExternalStore compatible getSnapshot */
-    getSnapshot(): BridgeState<T>;
-    /** React SSR compatible getServerSnapshot */
-    getServerSnapshot(): BridgeState<T>;
-    /** Check if bridge has received data */
-    hasData(): boolean;
-    /** Manually set data (for testing or custom injection) */
-    setData(data: T): void;
-    /** Manually set error */
-    setError(error: string): void;
-    /** Reset to loading state */
-    reset(): void;
-}
-/**
- * Render the Platform Bridge inline script.
- *
- * This script creates a reactive data store that:
- * 1. Installs interceptors on window.openai to detect data injection
- * 2. Provides subscribe/getState API for React/HTMX/vanilla integration
- * 3. Dispatches custom events for HTMX compatibility
- * 4. Handles the race condition between iframe load and data injection
- *
- * @returns Script tag with bridge implementation
- */
-export declare function renderBridgeScript(): string;
-/**
- * Generate TypeScript types for the bridge (for documentation/IDE support).
- */
-export declare const BRIDGE_TYPES = "\ninterface BridgeState<T = unknown> {\n  data: T | null;\n  loading: boolean;\n  error: string | null;\n}\n\ninterface PlatformBridge<T = unknown> {\n  getState(): BridgeState<T>;\n  subscribe(callback: () => void): () => void;\n  getSnapshot(): BridgeState<T>;\n  getServerSnapshot(): BridgeState<T>;\n  hasData(): boolean;\n  setData(data: T): void;\n  setError(error: string): void;\n  reset(): void;\n}\n\ndeclare global {\n  interface Window {\n    __frontmcp: {\n      bridge: PlatformBridge;\n      // ... other __frontmcp methods\n    };\n  }\n}\n";
-//# sourceMappingURL=bridge.d.ts.map

package/esm/base-template/bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/base-template/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,kDAAkD;IAClD,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,iCAAiC;IACjC,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IAC3B,iCAAiC;IACjC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,wDAAwD;IACxD,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,iBAAiB,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACpC,wCAAwC;IACxC,OAAO,IAAI,OAAO,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6BAA6B;IAC7B,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA4W3C;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,ijBA0BxB,CAAC"}

package/esm/base-template/default-base-template.d.ts

@@ -1,92 +0,0 @@
-/**
- * Default Base Template for Tool UI
- *
- * Provides a generic HTML wrapper for tool output widgets that:
- * 1. Includes theming (Tailwind CSS with @theme)
- * 2. Includes platform polyfills (callTool, detectMcpSession)
- * 3. Polls for toolOutput from window.openai or window.__frontmcp
- * 4. Renders content via window.__frontmcp.renderContent or default JSON renderer
- *
- * This template is platform-agnostic and works with:
- * - OpenAI Apps SDK (window.openai.toolOutput)
- * - Claude Artifacts
- * - Custom hosts using MCP protocol
- * - ngrok/iframe scenarios
- */
-import { type ThemeConfig } from '../theme';
-import { type McpSession } from './polyfills';
-/**
- * Options for creating a default base template.
- */
-export interface BaseTemplateOptions {
-    /** Tool name for identification */
-    toolName: string;
-    /** Theme configuration */
-    theme?: ThemeConfig;
-    /** MCP session info for callTool polyfill fallback */
-    mcpSession?: McpSession;
-    /** Include HTMX (default: false) */
-    htmx?: boolean;
-    /** Include Alpine.js (default: false) */
-    alpine?: boolean;
-    /** Include fonts (default: true) */
-    fonts?: boolean;
-    /** Use inline scripts (for blocked network platforms) */
-    inline?: boolean;
-    /**
-     * Additional head content (scripts, meta tags).
-     * @warning This content is injected WITHOUT escaping. Only use with trusted content.
-     */
-    headContent?: string;
-    /** Custom body classes */
-    bodyClass?: string;
-    /** Custom widget container classes */
-    containerClass?: string;
-}
-/**
- * Create a default base template for tool UI widgets.
- *
- * This generates a complete HTML document that:
- * 1. Loads Tailwind CSS with theme configuration
- * 2. Injects platform polyfills (callTool, detectMcpSession, getToolOutput)
- * 3. Waits for toolOutput to be injected
- * 4. Renders content using window.__frontmcp.renderContent or default JSON renderer
- *
- * @param options - Base template configuration
- * @returns Complete HTML document string
- *
- * @example Basic usage
- * ```typescript
- * const html = createDefaultBaseTemplate({ toolName: 'get_weather' });
- * ```
- *
- * @example With custom theme and MCP session
- * ```typescript
- * const html = createDefaultBaseTemplate({
- *   toolName: 'get_weather',
- *   theme: customTheme,
- *   mcpSession: { mcpUrl: 'https://mcp.example.com', sessionId: 'abc123' },
- * });
- * ```
- *
- * @example For Claude Artifacts (inline scripts)
- * ```typescript
- * await fetchAndCacheScriptsFromTheme(theme);
- * const html = createDefaultBaseTemplate({
- *   toolName: 'get_weather',
- *   inline: true,
- * });
- * ```
- */
-export declare function createDefaultBaseTemplate(options: BaseTemplateOptions): string;
-/**
- * Create a minimal base template without fonts.
- *
- * Use this for lightweight widgets or when fonts are loaded elsewhere.
- *
- * @param toolName - Tool name for identification
- * @param mcpSession - Optional MCP session info
- * @returns Complete HTML document string
- */
-export declare function createMinimalBaseTemplate(toolName: string, mcpSession?: McpSession): string;
-//# sourceMappingURL=default-base-template.d.ts.map