@pancake-apps/server 0.0.4 → 0.1.0

package/dist/chunk-CVG3DAN6.js

@@ -0,0 +1,172 @@
+// src/utils/metadata.ts
+function mapVisibilityToMcp(visibility) {
+  switch (visibility) {
+    case "model":
+      return ["model"];
+    case "app":
+      return ["app"];
+    case "both":
+    default:
+      return ["model", "app"];
+  }
+}
+function mapVisibilityToOpenAI(visibility) {
+  switch (visibility) {
+    case "model":
+      return { "openai/visibility": "public", "openai/widgetAccessible": false };
+    case "app":
+      return { "openai/visibility": "private", "openai/widgetAccessible": true };
+    case "both":
+    default:
+      return { "openai/visibility": "public", "openai/widgetAccessible": true };
+  }
+}
+function mapVisibilityToAudience(visibility) {
+  switch (visibility) {
+    case "model":
+      return ["assistant"];
+    case "app":
+      return ["user"];
+    case "both":
+    default:
+      return ["assistant", "user"];
+  }
+}
+
+// src/utils/csp.ts
+function generateMcpCSPMetadata(csp) {
+  const result = {};
+  if (csp.connectDomains && csp.connectDomains.length > 0) {
+    result.connectDomains = csp.connectDomains;
+  }
+  if (csp.resourceDomains && csp.resourceDomains.length > 0) {
+    result.resourceDomains = csp.resourceDomains;
+  }
+  if (csp.scriptDomains && csp.scriptDomains.length > 0) {
+    result.scriptDomains = csp.scriptDomains;
+  }
+  return result;
+}
+function generateOpenAICSPMetadata(csp) {
+  const result = {};
+  if (csp.connectDomains && csp.connectDomains.length > 0) {
+    result.connect_domains = csp.connectDomains;
+  }
+  if (csp.resourceDomains && csp.resourceDomains.length > 0) {
+    result.resource_domains = csp.resourceDomains;
+  }
+  if (csp.scriptDomains && csp.scriptDomains.length > 0) {
+    result.script_domains = csp.scriptDomains;
+  }
+  return result;
+}
+
+// src/adapters/mcp.ts
+var McpAdapter = class {
+  /**
+   * Build tool metadata for MCP protocol
+   */
+  buildToolMeta(tool, uiUri) {
+    const visibility = mapVisibilityToMcp(tool.visibility);
+    const uiMeta = {
+      visibility,
+      ...uiUri ? { resourceUri: uiUri } : {}
+    };
+    const annotations = {
+      audience: mapVisibilityToAudience(tool.visibility)
+    };
+    const meta = {
+      ui: uiMeta,
+      "ui/visibility": visibility,
+      ...uiUri ? { "ui/resourceUri": uiUri } : {}
+    };
+    return {
+      annotations,
+      _meta: meta
+    };
+  }
+  /**
+   * Build UI resource metadata for MCP protocol
+   */
+  buildUIResourceMeta(uiDef) {
+    const uiMeta = {};
+    if (uiDef.csp) {
+      const cspMetadata = generateMcpCSPMetadata(uiDef.csp);
+      if (Object.keys(cspMetadata).length > 0) {
+        uiMeta.csp = cspMetadata;
+      }
+    }
+    if (uiDef.prefersBorder !== void 0) {
+      uiMeta.prefersBorder = uiDef.prefersBorder;
+    }
+    if (uiDef.autoResize !== void 0) {
+      uiMeta.autoResize = uiDef.autoResize;
+    }
+    if (uiDef.domain) {
+      uiMeta.domain = uiDef.domain;
+    }
+    const result = {
+      mimeType: "text/html;profile=mcp-app"
+    };
+    if (Object.keys(uiMeta).length > 0) {
+      result._meta = { ui: uiMeta };
+    }
+    return result;
+  }
+};
+
+// src/adapters/openai.ts
+var OpenAIAdapter = class {
+  /**
+   * Build tool metadata for OpenAI protocol
+   */
+  buildToolMeta(tool, uiUri) {
+    const meta = {};
+    const visibilitySettings = mapVisibilityToOpenAI(tool.visibility);
+    Object.assign(meta, visibilitySettings);
+    if (uiUri) {
+      meta["openai/outputTemplate"] = uiUri;
+    }
+    const annotations = {
+      audience: mapVisibilityToAudience(tool.visibility)
+    };
+    return {
+      annotations,
+      _meta: Object.keys(meta).length > 0 ? meta : void 0
+    };
+  }
+  /**
+   * Build UI resource metadata for OpenAI protocol
+   */
+  buildUIResourceMeta(uiDef) {
+    const meta = {};
+    if (uiDef.csp) {
+      const cspMetadata = generateOpenAICSPMetadata(uiDef.csp);
+      if (Object.keys(cspMetadata).length > 0) {
+        meta["openai/widgetCSP"] = cspMetadata;
+      }
+    }
+    if (uiDef.prefersBorder !== void 0) {
+      meta["openai/widgetPrefersBorder"] = uiDef.prefersBorder;
+    }
+    if (uiDef.domain) {
+      meta["openai/widgetDomain"] = uiDef.domain;
+    }
+    const result = {
+      mimeType: "text/html+skybridge"
+    };
+    if (Object.keys(meta).length > 0) {
+      result._meta = meta;
+    }
+    return result;
+  }
+};
+
+// src/adapters/index.ts
+function createAdapter(protocol) {
+  return protocol === "openai" ? new OpenAIAdapter() : new McpAdapter();
+}
+
+export { createAdapter };
+//# sourceMappingURL=chunk-CVG3DAN6.js.map
+//# sourceMappingURL=chunk-CVG3DAN6.js.map

package/dist/chunk-CVG3DAN6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/metadata.ts","../src/utils/csp.ts","../src/adapters/mcp.ts","../src/adapters/openai.ts","../src/adapters/index.ts"],"names":[],"mappings":"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","file":"chunk-CVG3DAN6.js","sourcesContent":["/**\n * Protocol metadata utilities\n *\n * Provides utilities for mapping tool definitions to protocol-specific metadata\n * formats for MCP Apps and OpenAI/ChatGPT Apps.\n */\n\nimport type { Visibility } from '../types/protocol.js';\n\n// =============================================================================\n// MCP VISIBILITY MAPPING\n// =============================================================================\n\n/**\n * MCP visibility value\n * Array of who can invoke: \"model\", \"app\", or both\n */\nexport type McpVisibilityValue = ('model' | 'app')[];\n\n/**\n * Map visibility to MCP protocol format\n *\n * Visibility mappings:\n * - \"both\" (default): [\"model\", \"app\"] - Tool accessible to both model and UI\n * - \"model\": [\"model\"] - Tool only accessible to the model\n * - \"app\": [\"app\"] - Tool only accessible to the UI\n */\nexport function mapVisibilityToMcp(visibility?: Visibility): McpVisibilityValue {\n  switch (visibility) {\n    case 'model':\n      return ['model'];\n    case 'app':\n      return ['app'];\n    case 'both':\n    default:\n      return ['model', 'app'];\n  }\n}\n\n// =============================================================================\n// OPENAI VISIBILITY MAPPING\n// =============================================================================\n\n/**\n * OpenAI visibility settings with proper openai/ prefixed keys\n *\n * Settings:\n * - openai/visibility: \"public\" | \"private\" - Controls model access\n * - openai/widgetAccessible: boolean - Controls UI access\n */\nexport interface OpenAIVisibilitySettings {\n  'openai/visibility': 'public' | 'private';\n  'openai/widgetAccessible': boolean;\n}\n\n/**\n * Map visibility to OpenAI/ChatGPT protocol settings\n *\n * Visibility mappings:\n * - \"both\" (default): visibility=\"public\", widgetAccessible=true\n * - \"model\": visibility=\"public\", widgetAccessible=false\n * - \"app\": visibility=\"private\", widgetAccessible=true\n */\nexport function mapVisibilityToOpenAI(visibility?: Visibility): OpenAIVisibilitySettings {\n  switch (visibility) {\n    case 'model':\n      return { 'openai/visibility': 'public', 'openai/widgetAccessible': false };\n    case 'app':\n      return { 'openai/visibility': 'private', 'openai/widgetAccessible': true };\n    case 'both':\n    default:\n      return { 'openai/visibility': 'public', 'openai/widgetAccessible': true };\n  }\n}\n\n// =============================================================================\n// MCP AUDIENCE MAPPING (for annotations)\n// =============================================================================\n\n/**\n * Map visibility to MCP audience format for annotations\n *\n * Visibility mappings:\n * - \"both\" (default): [\"assistant\", \"user\"]\n * - \"model\": [\"assistant\"]\n * - \"app\": [\"user\"]\n */\nexport function mapVisibilityToAudience(visibility?: Visibility): string[] {\n  switch (visibility) {\n    case 'model':\n      return ['assistant'];\n    case 'app':\n      return ['user'];\n    case 'both':\n    default:\n      return ['assistant', 'user'];\n  }\n}\n","/**\n * CSP (Content Security Policy) utilities\n *\n * Provides utilities for mapping CSP configuration to protocol-specific formats\n * for MCP Apps and OpenAI/ChatGPT Apps.\n */\n\nimport type { ContentSecurityPolicy } from '../types/protocol.js';\n\n// =============================================================================\n// MCP CSP METADATA\n// =============================================================================\n\n/**\n * MCP CSP metadata format (camelCase)\n */\nexport interface McpCSPMetadata {\n  connectDomains?: string[];\n  resourceDomains?: string[];\n  scriptDomains?: string[];\n}\n\n/**\n * Generate CSP metadata for MCP Apps protocol\n *\n * MCP Apps use camelCase field names.\n */\nexport function generateMcpCSPMetadata(csp: ContentSecurityPolicy): McpCSPMetadata {\n  const result: McpCSPMetadata = {};\n\n  if (csp.connectDomains && csp.connectDomains.length > 0) {\n    result.connectDomains = csp.connectDomains;\n  }\n\n  if (csp.resourceDomains && csp.resourceDomains.length > 0) {\n    result.resourceDomains = csp.resourceDomains;\n  }\n\n  if (csp.scriptDomains && csp.scriptDomains.length > 0) {\n    result.scriptDomains = csp.scriptDomains;\n  }\n\n  return result;\n}\n\n// =============================================================================\n// OPENAI CSP METADATA\n// =============================================================================\n\n/**\n * OpenAI CSP metadata format (snake_case)\n */\nexport interface OpenAICSPMetadata {\n  connect_domains?: string[];\n  resource_domains?: string[];\n  script_domains?: string[];\n}\n\n/**\n * Generate CSP metadata for OpenAI/ChatGPT Apps protocol\n *\n * ChatGPT Apps use snake_case field names.\n */\nexport function generateOpenAICSPMetadata(csp: ContentSecurityPolicy): OpenAICSPMetadata {\n  const result: OpenAICSPMetadata = {};\n\n  if (csp.connectDomains && csp.connectDomains.length > 0) {\n    result.connect_domains = csp.connectDomains;\n  }\n\n  if (csp.resourceDomains && csp.resourceDomains.length > 0) {\n    result.resource_domains = csp.resourceDomains;\n  }\n\n  if (csp.scriptDomains && csp.scriptDomains.length > 0) {\n    result.script_domains = csp.scriptDomains;\n  }\n\n  return result;\n}\n","/**\n * MCP Protocol Adapter\n *\n * Handles metadata generation for MCP Apps protocol.\n * Uses camelCase naming and _meta.ui.* namespace.\n */\n\nimport type { InternalTool } from '../types/tool.js';\nimport type { UIDefinition } from '../types/protocol.js';\nimport type { ProtocolAdapter, ToolMetaResult, UIResourceMetaResult } from './types.js';\nimport { mapVisibilityToMcp, mapVisibilityToAudience } from '../utils/metadata.js';\nimport { generateMcpCSPMetadata } from '../utils/csp.js';\n\n// =============================================================================\n// MCP ADAPTER\n// =============================================================================\n\n/**\n * MCP protocol adapter implementation\n *\n * Generates metadata in MCP Apps format:\n * - Visibility as array: [\"model\"], [\"app\"], or [\"model\", \"app\"]\n * - Metadata under _meta.ui.* namespace\n * - MIME type: text/html;profile=mcp-app\n * - CSP with camelCase keys (connectDomains, resourceDomains)\n */\nexport class McpAdapter implements ProtocolAdapter {\n  /**\n   * Build tool metadata for MCP protocol\n   */\n  buildToolMeta(tool: InternalTool, uiUri?: string): ToolMetaResult {\n    const visibility = mapVisibilityToMcp(tool.visibility);\n    const uiMeta: Record<string, unknown> = {\n      visibility,\n      ...(uiUri ? { resourceUri: uiUri } : {}),\n    };\n\n    // Build annotations with audience\n    const annotations: Record<string, unknown> = {\n      audience: mapVisibilityToAudience(tool.visibility),\n    };\n\n    // Provide both nested and flat shapes for compatibility:\n    // - ext-apps / MCP Apps uses nested `_meta.ui.resourceUri`\n    // - Some inspectors use flat `_meta[\"ui/resourceUri\"]` key\n    const meta: Record<string, unknown> = {\n      ui: uiMeta,\n      'ui/visibility': visibility,\n      ...(uiUri ? { 'ui/resourceUri': uiUri } : {}),\n    };\n\n    return {\n      annotations,\n      _meta: meta,\n    };\n  }\n\n  /**\n   * Build UI resource metadata for MCP protocol\n   */\n  buildUIResourceMeta(uiDef: UIDefinition): UIResourceMetaResult {\n    const uiMeta: Record<string, unknown> = {};\n\n    // Add CSP metadata if specified\n    if (uiDef.csp) {\n      const cspMetadata = generateMcpCSPMetadata(uiDef.csp);\n      if (Object.keys(cspMetadata).length > 0) {\n        uiMeta.csp = cspMetadata;\n      }\n    }\n\n    // Add prefersBorder if specified\n    if (uiDef.prefersBorder !== undefined) {\n      uiMeta.prefersBorder = uiDef.prefersBorder;\n    }\n\n    // Add autoResize if specified\n    if (uiDef.autoResize !== undefined) {\n      uiMeta.autoResize = uiDef.autoResize;\n    }\n\n    // Add domain if specified\n    if (uiDef.domain) {\n      uiMeta.domain = uiDef.domain;\n    }\n\n    const result: UIResourceMetaResult = {\n      mimeType: 'text/html;profile=mcp-app',\n    };\n\n    if (Object.keys(uiMeta).length > 0) {\n      result._meta = { ui: uiMeta };\n    }\n\n    return result;\n  }\n}\n","/**\n * OpenAI Protocol Adapter\n *\n * Handles metadata generation for OpenAI/ChatGPT Apps protocol.\n * Uses snake_case naming and openai/* prefixed keys.\n */\n\nimport type { InternalTool } from '../types/tool.js';\nimport type { UIDefinition } from '../types/protocol.js';\nimport type { ProtocolAdapter, ToolMetaResult, UIResourceMetaResult } from './types.js';\nimport { mapVisibilityToOpenAI, mapVisibilityToAudience } from '../utils/metadata.js';\nimport { generateOpenAICSPMetadata } from '../utils/csp.js';\n\n// =============================================================================\n// OPENAI ADAPTER\n// =============================================================================\n\n/**\n * OpenAI protocol adapter implementation\n *\n * Generates metadata in OpenAI/ChatGPT Apps format:\n * - Visibility as openai/visibility (\"public\"/\"private\") + openai/widgetAccessible\n * - Metadata with openai/* prefixed keys\n * - MIME type: text/html+skybridge\n * - CSP with snake_case keys (connect_domains, resource_domains, etc.)\n */\nexport class OpenAIAdapter implements ProtocolAdapter {\n  /**\n   * Build tool metadata for OpenAI protocol\n   */\n  buildToolMeta(tool: InternalTool, uiUri?: string): ToolMetaResult {\n    const meta: Record<string, unknown> = {};\n\n    // Add visibility settings with openai/ prefixes\n    const visibilitySettings = mapVisibilityToOpenAI(tool.visibility);\n    Object.assign(meta, visibilitySettings);\n\n    // Add UI binding with OpenAI prefix\n    if (uiUri) {\n      meta['openai/outputTemplate'] = uiUri;\n    }\n\n    // Build annotations with audience (same as MCP)\n    const annotations: Record<string, unknown> = {\n      audience: mapVisibilityToAudience(tool.visibility),\n    };\n\n    return {\n      annotations,\n      _meta: Object.keys(meta).length > 0 ? meta : undefined,\n    };\n  }\n\n  /**\n   * Build UI resource metadata for OpenAI protocol\n   */\n  buildUIResourceMeta(uiDef: UIDefinition): UIResourceMetaResult {\n    const meta: Record<string, unknown> = {};\n\n    // Add CSP metadata with openai/ prefix\n    if (uiDef.csp) {\n      const cspMetadata = generateOpenAICSPMetadata(uiDef.csp);\n      if (Object.keys(cspMetadata).length > 0) {\n        meta['openai/widgetCSP'] = cspMetadata;\n      }\n    }\n\n    // Add prefersBorder with openai/ prefix\n    if (uiDef.prefersBorder !== undefined) {\n      meta['openai/widgetPrefersBorder'] = uiDef.prefersBorder;\n    }\n\n    // Add domain with openai/ prefix\n    if (uiDef.domain) {\n      meta['openai/widgetDomain'] = uiDef.domain;\n    }\n\n    const result: UIResourceMetaResult = {\n      mimeType: 'text/html+skybridge',\n    };\n\n    if (Object.keys(meta).length > 0) {\n      result._meta = meta;\n    }\n\n    return result;\n  }\n}\n","/**\n * Protocol adapters module\n *\n * Provides adapter factory and exports for protocol-specific metadata generation.\n */\n\nimport type { Protocol } from '../types/protocol.js';\nimport type { ProtocolAdapter } from './types.js';\nimport { McpAdapter } from './mcp.js';\nimport { OpenAIAdapter } from './openai.js';\n\n// =============================================================================\n// ADAPTER FACTORY\n// =============================================================================\n\n/**\n * Create a protocol adapter for the specified protocol\n *\n * @param protocol - Target protocol (\"mcp\" | \"openai\")\n * @returns Protocol-specific adapter instance\n *\n * @example\n * ```typescript\n * const adapter = createAdapter(\"openai\");\n * const toolMeta = adapter.buildToolMeta(tool, uiUri);\n * ```\n */\nexport function createAdapter(protocol: Protocol): ProtocolAdapter {\n  return protocol === 'openai' ? new OpenAIAdapter() : new McpAdapter();\n}\n\n// =============================================================================\n// EXPORTS\n// =============================================================================\n\nexport type { ProtocolAdapter, ToolMetaResult, UIResourceMetaResult } from './types.js';\nexport { McpAdapter } from './mcp.js';\nexport { OpenAIAdapter } from './openai.js';\n"]}

package/dist/index.cjs

@@ -44,8 +44,30 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/server/mcp.ts
-function visibilityToAudience(visibility) {
+// src/utils/metadata.ts
+function mapVisibilityToMcp(visibility) {
+  switch (visibility) {
+    case "model":
+      return ["model"];
+    case "app":
+      return ["app"];
+    case "both":
+    default:
+      return ["model", "app"];
+  }
+}
+function mapVisibilityToOpenAI(visibility) {
+  switch (visibility) {
+    case "model":
+      return { "openai/visibility": "public", "openai/widgetAccessible": false };
+    case "app":
+      return { "openai/visibility": "private", "openai/widgetAccessible": true };
+    case "both":
+    default:
+      return { "openai/visibility": "public", "openai/widgetAccessible": true };
+  }
+}
+function mapVisibilityToAudience(visibility) {
   switch (visibility) {
     case "model":
       return ["assistant"];
@@ -56,6 +78,201 @@ function visibilityToAudience(visibility) {
       return ["assistant", "user"];
   }
 }
+var init_metadata = __esm({
+  "src/utils/metadata.ts"() {
+  }
+});
+
+// src/utils/csp.ts
+function generateMcpCSPMetadata(csp) {
+  const result = {};
+  if (csp.connectDomains && csp.connectDomains.length > 0) {
+    result.connectDomains = csp.connectDomains;
+  }
+  if (csp.resourceDomains && csp.resourceDomains.length > 0) {
+    result.resourceDomains = csp.resourceDomains;
+  }
+  if (csp.scriptDomains && csp.scriptDomains.length > 0) {
+    result.scriptDomains = csp.scriptDomains;
+  }
+  return result;
+}
+function generateOpenAICSPMetadata(csp) {
+  const result = {};
+  if (csp.connectDomains && csp.connectDomains.length > 0) {
+    result.connect_domains = csp.connectDomains;
+  }
+  if (csp.resourceDomains && csp.resourceDomains.length > 0) {
+    result.resource_domains = csp.resourceDomains;
+  }
+  if (csp.scriptDomains && csp.scriptDomains.length > 0) {
+    result.script_domains = csp.scriptDomains;
+  }
+  return result;
+}
+var init_csp = __esm({
+  "src/utils/csp.ts"() {
+  }
+});
+
+// src/adapters/mcp.ts
+var McpAdapter;
+var init_mcp = __esm({
+  "src/adapters/mcp.ts"() {
+    init_metadata();
+    init_csp();
+    McpAdapter = class {
+      /**
+       * Build tool metadata for MCP protocol
+       */
+      buildToolMeta(tool, uiUri) {
+        const visibility = mapVisibilityToMcp(tool.visibility);
+        const uiMeta = {
+          visibility,
+          ...uiUri ? { resourceUri: uiUri } : {}
+        };
+        const annotations = {
+          audience: mapVisibilityToAudience(tool.visibility)
+        };
+        const meta = {
+          ui: uiMeta,
+          "ui/visibility": visibility,
+          ...uiUri ? { "ui/resourceUri": uiUri } : {}
+        };
+        return {
+          annotations,
+          _meta: meta
+        };
+      }
+      /**
+       * Build UI resource metadata for MCP protocol
+       */
+      buildUIResourceMeta(uiDef) {
+        const uiMeta = {};
+        if (uiDef.csp) {
+          const cspMetadata = generateMcpCSPMetadata(uiDef.csp);
+          if (Object.keys(cspMetadata).length > 0) {
+            uiMeta.csp = cspMetadata;
+          }
+        }
+        if (uiDef.prefersBorder !== void 0) {
+          uiMeta.prefersBorder = uiDef.prefersBorder;
+        }
+        if (uiDef.autoResize !== void 0) {
+          uiMeta.autoResize = uiDef.autoResize;
+        }
+        if (uiDef.domain) {
+          uiMeta.domain = uiDef.domain;
+        }
+        const result = {
+          mimeType: "text/html;profile=mcp-app"
+        };
+        if (Object.keys(uiMeta).length > 0) {
+          result._meta = { ui: uiMeta };
+        }
+        return result;
+      }
+    };
+  }
+});
+
+// src/adapters/openai.ts
+var OpenAIAdapter;
+var init_openai = __esm({
+  "src/adapters/openai.ts"() {
+    init_metadata();
+    init_csp();
+    OpenAIAdapter = class {
+      /**
+       * Build tool metadata for OpenAI protocol
+       */
+      buildToolMeta(tool, uiUri) {
+        const meta = {};
+        const visibilitySettings = mapVisibilityToOpenAI(tool.visibility);
+        Object.assign(meta, visibilitySettings);
+        if (uiUri) {
+          meta["openai/outputTemplate"] = uiUri;
+        }
+        const annotations = {
+          audience: mapVisibilityToAudience(tool.visibility)
+        };
+        return {
+          annotations,
+          _meta: Object.keys(meta).length > 0 ? meta : void 0
+        };
+      }
+      /**
+       * Build UI resource metadata for OpenAI protocol
+       */
+      buildUIResourceMeta(uiDef) {
+        const meta = {};
+        if (uiDef.csp) {
+          const cspMetadata = generateOpenAICSPMetadata(uiDef.csp);
+          if (Object.keys(cspMetadata).length > 0) {
+            meta["openai/widgetCSP"] = cspMetadata;
+          }
+        }
+        if (uiDef.prefersBorder !== void 0) {
+          meta["openai/widgetPrefersBorder"] = uiDef.prefersBorder;
+        }
+        if (uiDef.domain) {
+          meta["openai/widgetDomain"] = uiDef.domain;
+        }
+        const result = {
+          mimeType: "text/html+skybridge"
+        };
+        if (Object.keys(meta).length > 0) {
+          result._meta = meta;
+        }
+        return result;
+      }
+    };
+  }
+});
+
+// src/adapters/index.ts
+function createAdapter(protocol) {
+  return protocol === "openai" ? new OpenAIAdapter() : new McpAdapter();
+}
+var init_adapters = __esm({
+  "src/adapters/index.ts"() {
+    init_mcp();
+    init_openai();
+    init_mcp();
+    init_openai();
+  }
+});
+
+// src/utils/detect-protocol.ts
+function detectProtocol(req, defaultProtocol = "mcp") {
+  const headers = req.headers;
+  const accept = getHeader(headers, "accept");
+  if (accept && accept.includes("text/html+skybridge")) {
+    return "openai";
+  }
+  const openaiHeader = getHeader(headers, "x-openai-client");
+  if (openaiHeader) {
+    return "openai";
+  }
+  const userAgent = getHeader(headers, "user-agent");
+  if (userAgent && (userAgent.includes("ChatGPT") || userAgent.includes("OpenAI"))) {
+    return "openai";
+  }
+  return defaultProtocol;
+}
+function getHeader(headers, name) {
+  const value = headers[name] || headers[name.toLowerCase()];
+  if (Array.isArray(value)) {
+    return value[0];
+  }
+  return value;
+}
+var init_detect_protocol = __esm({
+  "src/utils/detect-protocol.ts"() {
+  }
+});
+
+// src/server/mcp.ts
 function createMcpHandler(config) {
   return async (req, res) => {
     const request = req.body;
@@ -68,7 +285,9 @@ function createMcpHandler(config) {
       return;
     }
     try {
-      const result = await handleMethod(config, request.method, request.params ?? {});
+      const protocol = detectProtocol(req, config.defaultProtocol);
+      const adapter = createAdapter(protocol);
+      const result = await handleMethod(config, request.method, request.params ?? {}, adapter);
       const response = {
         jsonrpc: "2.0",
         id: request.id,
@@ -89,7 +308,7 @@ function createMcpHandler(config) {
     }
   };
 }
-async function handleMethod(config, method, params) {
+async function handleMethod(config, method, params, adapter) {
   switch (method) {
     case "initialize":
       return {
@@ -105,20 +324,17 @@ async function handleMethod(config, method, params) {
       };
     case "tools/list":
       return {
-        tools: Array.from(config.tools.values()).filter((tool) => tool.visibility !== "app").map((tool) => ({
-          name: tool.name,
-          description: tool.description,
-          inputSchema: tool.inputSchema,
-          annotations: {
-            audience: visibilityToAudience(tool.visibility)
-          },
-          _meta: tool.ui ? {
-            ui: {
-              visibility: visibilityToAudience(tool.visibility),
-              resourceUri: getUIResourceUri(tool.name, tool.category)
-            }
-          } : void 0
-        }))
+        tools: Array.from(config.tools.values()).filter((tool) => tool.visibility !== "app").map((tool) => {
+          const uiUri = tool.ui ? getUIResourceUri(tool.name, tool.category) : void 0;
+          const meta = adapter.buildToolMeta(tool, uiUri);
+          return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: meta.annotations,
+            _meta: tool.ui ? meta._meta : void 0
+          };
+        })
       };
     case "tools/call": {
       const toolName = params["name"];
@@ -136,18 +352,15 @@ async function handleMethod(config, method, params) {
     }
     case "resources/list":
       return {
-        resources: Array.from(config.uiResources.values()).map((resource) => ({
-          uri: resource.uri,
-          name: resource.name,
-          mimeType: "text/html;profile=mcp-app",
-          _meta: {
-            ui: {
-              prefersBorder: resource.definition.prefersBorder,
-              autoResize: resource.definition.autoResize,
-              csp: resource.definition.csp
-            }
-          }
-        }))
+        resources: Array.from(config.uiResources.values()).map((resource) => {
+          const meta = adapter.buildUIResourceMeta(resource.definition);
+          return {
+            uri: resource.uri,
+            name: resource.name,
+            mimeType: meta.mimeType,
+            _meta: meta._meta
+          };
+        })
       };
     case "resources/read": {
       const uri = params["uri"];
@@ -186,8 +399,10 @@ function getUIResourceUri(toolName, category) {
   const name = toolName.replace(/^(view|action|data|tool):/, "");
   return `pancake://ui/${category}/${name}`;
 }
-var init_mcp = __esm({
+var init_mcp2 = __esm({
   "src/server/mcp.ts"() {
+    init_adapters();
+    init_detect_protocol();
   }
 });
 
@@ -364,18 +579,8 @@ var stdio_exports = {};
 __export(stdio_exports, {
   startStdioServer: () => startStdioServer
 });
-function visibilityToAudience2(visibility) {
-  switch (visibility) {
-    case "model":
-      return ["assistant"];
-    case "app":
-      return ["user"];
-    case "both":
-    default:
-      return ["assistant", "user"];
-  }
-}
 async function startStdioServer(config) {
+  const adapter = createAdapter(config.protocol ?? "mcp");
   const server = new index_js.Server(
     {
       name: config.name,
@@ -392,20 +597,17 @@ async function startStdioServer(config) {
     types_js.ListToolsRequestSchema,
     async () => {
       return {
-        tools: Array.from(config.tools.values()).map((tool) => ({
-          name: tool.name,
-          description: tool.description,
-          inputSchema: tool.inputSchema,
-          annotations: {
-            audience: visibilityToAudience2(tool.visibility)
-          },
-          _meta: tool.ui ? {
-            ui: {
-              visibility: visibilityToAudience2(tool.visibility),
-              resourceUri: getUIResourceUri2(tool.name, tool.category)
-            }
-          } : void 0
-        }))
+        tools: Array.from(config.tools.values()).map((tool) => {
+          const uiUri = tool.ui ? getUIResourceUri2(tool.name, tool.category) : void 0;
+          const meta = adapter.buildToolMeta(tool, uiUri);
+          return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: meta.annotations,
+            _meta: tool.ui ? meta._meta : void 0
+          };
+        })
       };
     }
   );
@@ -429,18 +631,15 @@ async function startStdioServer(config) {
     types_js.ListResourcesRequestSchema,
     async () => {
       return {
-        resources: Array.from(config.uiResources.values()).map((resource) => ({
-          uri: resource.uri,
-          name: resource.name,
-          mimeType: "text/html;profile=mcp-app",
-          _meta: {
-            ui: {
-              prefersBorder: resource.definition.prefersBorder,
-              autoResize: resource.definition.autoResize,
-              csp: resource.definition.csp
-            }
-          }
-        }))
+        resources: Array.from(config.uiResources.values()).map((resource) => {
+          const meta = adapter.buildUIResourceMeta(resource.definition);
+          return {
+            uri: resource.uri,
+            name: resource.name,
+            mimeType: meta.mimeType,
+            _meta: meta._meta
+          };
+        })
       };
     }
   );
@@ -477,6 +676,7 @@ function getUIResourceUri2(toolName, category) {
 }
 var init_stdio = __esm({
   "src/server/stdio.ts"() {
+    init_adapters();
   }
 });
 
@@ -564,7 +764,8 @@ async function createServer(config) {
     version: config.version,
     tools: config.tools,
     uiResources: config.uiResources,
-    executeTool
+    executeTool,
+    defaultProtocol: config.config?.protocol
   });
   app.post(mcpRoute, mcpHandler);
   app.get("/health", (_req, res) => {
@@ -577,7 +778,8 @@ async function createServer(config) {
       version: config.version,
       tools: config.tools,
       uiResources: config.uiResources,
-      executeTool
+      executeTool,
+      protocol: config.config?.protocol
     });
   }
   return new Promise((resolve3) => {
@@ -617,7 +819,7 @@ async function createServer(config) {
 }
 var init_server = __esm({
   "src/server/index.ts"() {
-    init_mcp();
+    init_mcp2();
     init_routes();
     init_dev_proxy();
   }
@@ -868,6 +1070,7 @@ function createApp(config) {
         if (config.config.debug !== void 0) cfg.debug = config.config.debug;
         if (config.config.serverRoute !== void 0) cfg.serverRoute = config.config.serverRoute;
         if (config.config.devServer !== void 0) cfg.devServer = config.config.devServer;
+        if (config.config.protocol !== void 0) cfg.protocol = config.config.protocol;
         serverConfig.config = cfg;
       }
       server = await createServer2(serverConfig);