@pancake-apps/server 0.0.3 → 0.1.0

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,16 +778,36 @@ async function createServer(config) {
       version: config.version,
       tools: config.tools,
       uiResources: config.uiResources,
-      executeTool
+      executeTool,
+      protocol: config.config?.protocol
     });
   }
   return new Promise((resolve3) => {
     const httpServer = app.listen(config.port, config.host, () => {
       if (config.config?.debug) {
-        console.log(`Pancake server "${config.name}" running on http://${config.host}:${config.port}`);
-        console.log(`  MCP endpoint: ${mcpRoute}`);
-        console.log(`  UI endpoint: /ui/:viewName`);
-        console.log(`  Tools registered: ${config.tools.size}`);
+        const baseUrl = `http://localhost:${config.port}`;
+        const viewNames = config.viewNames ?? [];
+        const actionNames = config.actionNames ?? [];
+        const dataNames = config.dataNames ?? [];
+        console.log("");
+        console.log(`  \x1B[1m\x1B[32m\u2713\x1B[0m \x1B[1m${config.name}\x1B[0m is running`);
+        console.log("");
+        console.log(`  \x1B[2m\u279C\x1B[0m  \x1B[1mServer:\x1B[0m   ${baseUrl}`);
+        console.log(`  \x1B[2m\u279C\x1B[0m  \x1B[1mMCP:\x1B[0m      ${baseUrl}${mcpRoute}`);
+        if (viewNames.length > 0) {
+          console.log(`  \x1B[2m\u279C\x1B[0m  \x1B[1mViews:\x1B[0m    ${viewNames.map((v) => `${baseUrl}/ui/${v}`).join("\n              ")}`);
+        }
+        console.log("");
+        console.log(`  \x1B[2mRegistered:\x1B[0m`);
+        console.log(`    ${viewNames.length} view${viewNames.length !== 1 ? "s" : ""}${viewNames.length > 0 ? ` (${viewNames.join(", ")})` : ""}`);
+        console.log(`    ${actionNames.length} action${actionNames.length !== 1 ? "s" : ""}${actionNames.length > 0 ? ` (${actionNames.join(", ")})` : ""}`);
+        console.log(`    ${dataNames.length} data fetcher${dataNames.length !== 1 ? "s" : ""}${dataNames.length > 0 ? ` (${dataNames.join(", ")})` : ""}`);
+        console.log("");
+        console.log(`  \x1B[2mNext steps:\x1B[0m`);
+        console.log(`    \x1B[36m1.\x1B[0m Open a view in your browser: ${baseUrl}/ui/${viewNames[0] || "yourView"}`);
+        console.log(`    \x1B[36m2.\x1B[0m Connect an MCP client to: ${baseUrl}${mcpRoute}`);
+        console.log(`    \x1B[36m3.\x1B[0m Or use Claude Desktop with this server URL`);
+        console.log("");
       }
       resolve3({
         close: () => new Promise((resolveClose) => {
@@ -598,7 +819,7 @@ async function createServer(config) {
 }
 var init_server = __esm({
   "src/server/index.ts"() {
-    init_mcp();
+    init_mcp2();
     init_routes();
     init_dev_proxy();
   }
@@ -838,7 +1059,10 @@ function createApp(config) {
         events,
         port,
         host,
-        transport
+        transport,
+        viewNames: Object.keys(config.views ?? {}),
+        actionNames: Object.keys(config.actions ?? {}),
+        dataNames: Object.keys(config.data ?? {})
       };
       if (config.config) {
         const cfg = {};
@@ -846,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);