sunpeak 0.17.7 → 0.18.2

package/dist/mcp/production-server.d.ts

@@ -70,6 +70,13 @@ export interface ProductionServerConfig {
     resources: ProductionResource[];
     /** Auth function from server entry (populates extra.authInfo via req.auth) */
     auth?: AuthFunction;
+    /**
+     * Public URL of the MCP server (e.g. `'https://example.com/mcp'`).
+     * Used to auto-compute a default `_meta.ui.domain` for resources that
+     * don't specify one. Without this, resources without an explicit domain
+     * may trigger host warnings (e.g. ChatGPT's "Widget domain is not set").
+     */
+    serverUrl?: string;
 }
 /**
  * Configuration for creating a Web Standard MCP handler (serverless/edge).
@@ -87,6 +94,13 @@ export interface WebHandlerConfig {
     resources: ProductionResource[];
     /** Auth function for Web Standard Request objects */
     auth?: WebAuthFunction;
+    /**
+     * Public URL of the MCP server (e.g. `'https://example.com/mcp'`).
+     * Used to auto-compute a default `_meta.ui.domain` for resources that
+     * don't specify one. Without this, resources without an explicit domain
+     * may trigger host warnings (e.g. ChatGPT's "Widget domain is not set").
+     */
+    serverUrl?: string;
 }
 /**
  * Create an MCP server with production tool handlers and pre-built resources.

package/dist/mcp/resolve-domain.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Domain config: a single string (used for all hosts) or a map of
+ * host `clientInfo.name` → domain string. Use `'default'` as a fallback
+ * key for unmatched hosts.
+ */
+export type DomainConfig = string | Record<string, string>;
+/**
+ * Resolve a domain config to a single string for the given host.
+ *
+ * Lookup order: `map[clientName]` → `map['default']` → `undefined`.
+ * If `domain` is a plain string, it's returned as-is regardless of host.
+ */
+export declare function resolveDomain(domain: DomainConfig | undefined, clientName: string | undefined): string | undefined;
+/**
+ * Compute the Claude sandbox domain for a given MCP server URL.
+ *
+ * Claude uses the first 32 hex characters of a SHA-256 hash of the server URL
+ * as a subdomain of `claudemcpcontent.com`.
+ *
+ * @example
+ * ```ts
+ * computeClaudeDomain('https://example.com/mcp')
+ * // → 'a904794854a047f6b936c2d62d57a3c0.claudemcpcontent.com'
+ * ```
+ */
+export declare function computeClaudeDomain(serverUrl: string): string;
+/**
+ * Compute the ChatGPT sandbox domain for a given MCP server URL.
+ *
+ * ChatGPT derives a subdomain from the server URL by replacing non-alphanumeric
+ * characters with hyphens and appending `.oaiusercontent.com`.
+ *
+ * @example
+ * ```ts
+ * computeChatGPTDomain('https://www.example.com/mcp')
+ * // → 'www-example-com.oaiusercontent.com'
+ * ```
+ */
+export declare function computeChatGPTDomain(serverUrl: string): string;
+/**
+ * Inject a resolved domain into resource metadata.
+ *
+ * If the `_meta.ui.domain` field is a map (Record), it's resolved to a single
+ * string using `clientName`. If it's already a string or absent, the metadata
+ * is returned unchanged.
+ */
+export declare function injectResolvedDomain(meta: Record<string, unknown> | undefined, clientName: string | undefined): Record<string, unknown> | undefined;
+/**
+ * Auto-compute a default domain for the connecting host when the resource
+ * metadata has no domain set.
+ *
+ * Returns the metadata unchanged if `_meta.ui.domain` is already present.
+ * Otherwise, computes a host-appropriate domain from the server URL.
+ */
+export declare function injectDefaultDomain(meta: Record<string, unknown> | undefined, clientName: string | undefined, serverUrl: string): Record<string, unknown>;

package/dist/mcp/types.d.ts

@@ -83,7 +83,7 @@ export interface MCPServerHandle {
     /**
      * Notify non-local sessions that resources have changed.
      * Sends `notifications/resources/list_changed` so hosts re-fetch fresh content.
-     * Local sessions (ChatGPT, simulator) are skipped since they use Vite HMR.
+     * Local sessions (ChatGPT, inspector) are skipped since they use Vite HMR.
      */
     invalidateResources(): void;
 }

package/dist/style.css

@@ -2217,28 +2217,28 @@
   }
 }
 
-.sunpeak-simulator-root select, .sunpeak-simulator-root input:not([type="checkbox"]), .sunpeak-simulator-root textarea {
+.sunpeak-inspector-root select, .sunpeak-inspector-root input:not([type="checkbox"]), .sunpeak-inspector-root textarea {
   box-shadow: inset 0 0 0 1px var(--color-border-primary);
   border: 0;
   transition: box-shadow .15s, color .15s, background-color .15s;
 }
 
-.sunpeak-simulator-root select:hover, .sunpeak-simulator-root input:not([type="checkbox"]):hover, .sunpeak-simulator-root textarea:hover {
+.sunpeak-inspector-root select:hover, .sunpeak-inspector-root input:not([type="checkbox"]):hover, .sunpeak-inspector-root textarea:hover {
   box-shadow: inset 0 0 0 1px var(--color-border-secondary);
 }
 
-.sunpeak-simulator-root select:focus-visible, .sunpeak-simulator-root input:not([type="checkbox"]):focus-visible, .sunpeak-simulator-root textarea:focus-visible {
+.sunpeak-inspector-root select:focus-visible, .sunpeak-inspector-root input:not([type="checkbox"]):focus-visible, .sunpeak-inspector-root textarea:focus-visible {
   box-shadow: inset 0 0 0 1px var(--color-border-secondary);
   outline: 2px solid var(--color-ring-primary);
   outline-offset: -1px;
 }
 
-.sunpeak-simulator-root button:focus-visible {
+.sunpeak-inspector-root button:focus-visible {
   outline: 2px solid var(--color-ring-primary);
   outline-offset: -1px;
 }
 
-.sunpeak-simulator-root input[type="checkbox"] {
+.sunpeak-inspector-root input[type="checkbox"] {
   appearance: none;
   border: 1px solid var(--color-border-secondary);
   cursor: pointer;
@@ -2253,36 +2253,36 @@
   transition: border-color .15s, background-color .15s;
 }
 
-.sunpeak-simulator-root input[type="checkbox"]:hover {
+.sunpeak-inspector-root input[type="checkbox"]:hover {
   border-color: var(--color-text-tertiary);
 }
 
-.sunpeak-simulator-root input[type="checkbox"]:checked {
+.sunpeak-inspector-root input[type="checkbox"]:checked {
   border-color: var(--color-background-inverse);
   background-color: var(--color-background-inverse);
   background-image: url("data:image/svg+xml,%3csvg viewBox='0 0 10 10' fill='none' xmlns='http://www.w3.org/2000/svg'%3e%3cpath d='M2 5L4.25 7L8 3' stroke='white' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3e%3c/svg%3e");
 }
 
-[data-theme="dark"] .sunpeak-simulator-root input[type="checkbox"]:checked {
+[data-theme="dark"] .sunpeak-inspector-root input[type="checkbox"]:checked {
   background-image: url("data:image/svg+xml,%3csvg viewBox='0 0 10 10' fill='none' xmlns='http://www.w3.org/2000/svg'%3e%3cpath d='M2 5L4.25 7L8 3' stroke='%23111' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'/%3e%3c/svg%3e");
 }
 
-.sunpeak-simulator-root input[type="checkbox"]:focus-visible {
+.sunpeak-inspector-root input[type="checkbox"]:focus-visible {
   outline: 2px solid var(--color-ring-primary);
   outline-offset: 2px;
 }
 
-.sunpeak-simulator-root input[type="number"]::-webkit-inner-spin-button {
+.sunpeak-inspector-root input[type="number"]::-webkit-inner-spin-button {
   -webkit-appearance: none;
   margin: 0;
 }
 
-.sunpeak-simulator-root input[type="number"]::-webkit-outer-spin-button {
+.sunpeak-inspector-root input[type="number"]::-webkit-outer-spin-button {
   -webkit-appearance: none;
   margin: 0;
 }
 
-.sunpeak-simulator-root input[type="number"] {
+.sunpeak-inspector-root input[type="number"] {
   -moz-appearance: textfield;
 }
 

package/dist/types/resource-config.d.ts

@@ -1,5 +1,6 @@
 import { Resource } from '@modelcontextprotocol/sdk/types.js';
 import { McpUiResourceMeta } from '@modelcontextprotocol/ext-apps';
+import { DomainConfig } from '../mcp/resolve-domain.js';
 /**
  * Configuration for an MCP App resource, exported from resource .tsx files.
  *
@@ -13,7 +14,25 @@ export type ResourceConfig = Omit<Resource, 'uri' | 'name'> & {
     name?: string;
     title?: string;
     _meta?: {
-        ui?: McpUiResourceMeta;
+        ui?: Omit<McpUiResourceMeta, 'domain'> & {
+            /**
+             * Dedicated sandbox origin for this resource.
+             *
+             * Can be a single string (used for all hosts) or a map of
+             * `clientInfo.name` → domain string for host-specific values.
+             * Use `'default'` as a fallback key for unmatched hosts.
+             *
+             * @example
+             * ```ts
+             * domain: {
+             *   claude: computeClaudeDomain('https://my-server.com/mcp'),
+             *   'openai-mcp': computeChatGPTDomain('https://my-server.com/mcp'),
+             *   default: 'fallback.example.com',
+             * }
+             * ```
+             */
+            domain?: DomainConfig;
+        };
         [key: string]: unknown;
     };
 };

package/dist/types/simulation.d.ts

@@ -13,7 +13,7 @@ export type ServerToolMock = CallToolResult | Array<{
 }>;
 /**
  * A simulation packages a component with its example data and metadata.
- * Each simulation represents a complete tool experience in the simulator.
+ * Each simulation represents a complete tool experience in the inspector.
  *
  * Resource rendering options (mutually exclusive):
  * - `resourceUrl`: URL to an HTML page (dev mode with Vite HMR)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sunpeak",
-  "version": "0.17.7",
-  "description": "Local-first MCP Apps framework. Quickstart, build, test, and ship your Claude Connector or ChatGPT App!",
+  "version": "0.18.2",
+  "description": "Inspector, testing framework, and app framework for MCP Apps.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -17,10 +17,10 @@
         "default": "./dist/index.cjs"
       }
     },
-    "./simulator": {
+    "./inspector": {
       "import": {
-        "types": "./dist/simulator/index.d.ts",
-        "default": "./dist/simulator/index.js"
+        "types": "./dist/inspector/index.d.ts",
+        "default": "./dist/inspector/index.js"
       }
     },
     "./chatgpt": {
@@ -36,7 +36,6 @@
       }
     },
     "./style.css": "./dist/style.css",
-    "./chatgpt/globals.css": "./dist/chatgpt/globals.css",
     "./mcp": {
       "import": {
         "types": "./dist/mcp/index.d.ts",
@@ -55,18 +54,6 @@
         "default": "./dist/host/chatgpt/index.js"
       }
     },
-    "./platform": {
-      "import": {
-        "types": "./dist/host/index.d.ts",
-        "default": "./dist/host/index.js"
-      }
-    },
-    "./platform/chatgpt": {
-      "import": {
-        "types": "./dist/host/chatgpt/index.d.ts",
-        "default": "./dist/host/chatgpt/index.js"
-      }
-    },
     "./test": {
       "import": {
         "types": "./bin/lib/live/live-fixtures.d.mts",
@@ -119,9 +106,9 @@
     "chatgpt-app",
     "mcp-ui",
     "mcp",
-    "chatgpt-simulator",
+    "chatgpt-inspector",
     "claude",
-    "claude-simulator",
+    "claude-inspector",
     "testing",
     "multi-platform",
     "react",