@creature-ai/sdk 0.1.1

package/dist/types-DcoqlK46.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Core types for the MCP SDK.
+ * These are framework-agnostic and shared between vanilla JS and React.
+ */
+/**
+ * Environment types for host detection.
+ */
+type Environment = "chatgpt" | "mcp-apps" | "standalone";
+/**
+ * Log severity levels matching MCP protocol LoggingLevel.
+ * These are displayed in the host's DevConsole with appropriate colors.
+ */
+type LogLevel = "debug" | "info" | "notice" | "warning" | "error";
+/**
+ * Structured widget state format (ChatGPT-compatible).
+ * Allows separating model-visible content from private UI state.
+ */
+interface StructuredWidgetState {
+    /** Content visible to the AI model on follow-up turns */
+    modelContent?: string | Record<string, unknown> | null;
+    /** UI-only state, hidden from model */
+    privateContent?: Record<string, unknown> | null;
+    /** File IDs for images the model can see */
+    imageIds?: string[];
+}
+/**
+ * Widget state can be structured (with modelContent/privateContent)
+ * or a simple key-value object.
+ */
+type WidgetState = StructuredWidgetState | Record<string, unknown>;
+/**
+ * Unified state shape for AppSession.
+ * Provides a consistent state model across MCP Apps and ChatGPT Apps.
+ *
+ * - `internal`: Private to AppSession implementation (not synced anywhere)
+ * - `backend`: Available in the backend server (not mirrored to UI)
+ * - `ui`: Maps to widgetState on the frontend (synced via host binding)
+ */
+interface AppSessionState<TInternal extends Record<string, unknown> = Record<string, unknown>, TBackend extends Record<string, unknown> = Record<string, unknown>, TUi extends WidgetState | null = WidgetState | null> {
+    internal: TInternal;
+    backend: TBackend;
+    ui: TUi;
+}
+/**
+ * Options for creating an AppSession.
+ */
+interface AppSessionOptions {
+    /** Optional AppSession ID (auto-generated if not provided) */
+    id?: string;
+    /** Enable WebSocket channel for this AppSession (server-side only) */
+    websockets?: boolean;
+}
+/**
+ * Listener for AppSession state changes.
+ */
+type AppSessionListener<TState extends AppSessionState = AppSessionState> = (state: TState, prevState: TState) => void;
+/**
+ * Tool call result structure.
+ */
+interface ToolResult<T = Record<string, unknown>> {
+    content?: Array<{
+        type: string;
+        text: string;
+    }>;
+    structuredContent?: T;
+    isError?: boolean;
+    source?: "agent" | "ui";
+}
+/**
+ * Host context sent from MCP Apps host.
+ * Follows MCP Apps spec with Creature extensions via [key: string]: unknown.
+ */
+interface HostContext {
+    theme?: "light" | "dark";
+    styles?: {
+        variables?: Record<string, string>;
+    };
+    displayMode?: "pip" | "inline";
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    platform?: string;
+    /**
+     * Widget state restored from previous widget instance.
+     * Creature extension - passed via hostContext on ui/initialize.
+     */
+    widgetState?: WidgetState;
+}
+/**
+ * Configuration for creating a host client.
+ */
+interface HostClientConfig {
+    /** Name of the client (for protocol handshake) */
+    name: string;
+    /** Version of the client */
+    version: string;
+}
+/**
+ * State managed by the host client.
+ */
+interface HostClientState {
+    /** Whether the host connection is ready */
+    isReady: boolean;
+    /** The detected environment */
+    environment: Environment;
+    /** Current widget state */
+    widgetState: WidgetState | null;
+}
+/**
+ * Event handlers that can be registered on the host client.
+ */
+interface HostClientEvents {
+    /** Called when tool input is received (before execution) */
+    "tool-input": (args: Record<string, unknown>) => void;
+    /** Called when tool result is received */
+    "tool-result": (result: ToolResult) => void;
+    /** Called when theme changes (MCP Apps only) */
+    "theme-change": (theme: "light" | "dark") => void;
+    /** Called when host requests teardown (MCP Apps only) */
+    teardown: () => Promise<void> | void;
+    /** Called when widget state changes (restored or updated) */
+    "widget-state-change": (widgetState: WidgetState | null) => void;
+}
+/**
+ * Listener for state changes.
+ */
+type StateListener = (state: HostClientState, prevState: HostClientState) => void;
+/**
+ * Host client interface.
+ * Implemented by McpHostClient and ChatGPTHostClient.
+ */
+interface HostClient {
+    /** Get current state */
+    getState(): HostClientState;
+    /** Subscribe to state changes. Returns unsubscribe function. */
+    subscribe(listener: StateListener): () => void;
+    /** Call a tool on the MCP server */
+    callTool<T = Record<string, unknown>>(toolName: string, args: Record<string, unknown>): Promise<ToolResult<T>>;
+    /** Send a notification to the host (MCP Apps only, no-op on ChatGPT) */
+    sendNotification(method: string, params: unknown): void;
+    /** Set widget state */
+    setWidgetState(state: WidgetState | null): void;
+    /**
+     * Send a log message to the host's DevConsole.
+     *
+     * Logs are sent via the MCP protocol's `notifications/message` notification
+     * and displayed in the host's unified log viewer alongside server logs.
+     *
+     * @param level - Log severity level
+     * @param message - Log message
+     * @param data - Optional structured data to include
+     */
+    log(level: LogLevel, message: string, data?: Record<string, unknown>): void;
+    /** Register an event handler. Returns unsubscribe function. */
+    on<K extends keyof HostClientEvents>(event: K, handler: HostClientEvents[K]): () => void;
+    /** Start listening for host messages */
+    connect(): void;
+    /** Stop listening for host messages */
+    disconnect(): void;
+}
+
+export type { AppSessionOptions as A, Environment as E, HostClient as H, LogLevel as L, StructuredWidgetState as S, ToolResult as T, WidgetState as W, AppSessionState as a, AppSessionListener as b, HostContext as c, HostClientConfig as d, HostClientState as e, HostClientEvents as f, StateListener as g };

package/dist/vite/index.d.ts

@@ -0,0 +1,51 @@
+import { Plugin } from 'vite';
+
+/**
+ * HMR Client Script
+ *
+ * This script is injected into MCP App HTML during development mode.
+ * It connects to Vite's HMR WebSocket and notifies the parent frame
+ * when a full reload is needed.
+ *
+ * The parent frame (Creature host) will then:
+ * 1. Save current widget state
+ * 2. Re-fetch fresh HTML from the MCP server
+ * 3. Reload the iframe with new content
+ * 4. Restore widget state
+ */
+/**
+ * Generate the HMR client script as a string.
+ * The port is injected at generation time.
+ */
+declare function generateHmrClientScript(port: number): string;
+/**
+ * Generate a script tag with the HMR client code.
+ */
+declare function generateHmrClientScriptTag(port: number): string;
+
+interface CreaturePluginOptions {
+    uiDir?: string;
+    outDir?: string;
+    hmrPort?: number;
+}
+interface HmrConfig {
+    port: number;
+}
+/**
+ * Vite plugin for Creature MCP Apps.
+ *
+ * Just write page.tsx files - no HTML or entry files needed.
+ *
+ * ```
+ * src/ui/
+ * ├── page.tsx         → dist/ui/main.html
+ * ├── inline/page.tsx  → dist/ui/inline.html
+ * └── _components/     → ignored
+ * ```
+ *
+ * When using vite-plugin-singlefile, multiple pages are built automatically
+ * via sequential builds (singlefile requires single entry per build).
+ */
+declare function creature(options?: CreaturePluginOptions): Plugin;
+
+export { type CreaturePluginOptions, type HmrConfig, creature, creature as default, generateHmrClientScript, generateHmrClientScriptTag };

package/dist/vite/index.js

@@ -0,0 +1,332 @@
+// src/vite/index.ts
+import { resolve, join, relative } from "path";
+import { readdirSync, statSync, existsSync, writeFileSync, mkdirSync, rmSync } from "fs";
+import { createServer as createNetServer } from "net";
+import { createServer as createHttpServer } from "http";
+import { createHash } from "crypto";
+import { spawnSync } from "child_process";
+
+// src/vite/hmr-client.ts
+function generateHmrClientScript(port) {
+  return `
+(function() {
+  if (window.parent === window) {
+    console.log('[Creature HMR] Not in iframe, skipping HMR client');
+    return;
+  }
+  if (window.__CREATURE_HMR_CONNECTED__) {
+    console.log('[Creature HMR] Already connected, skipping');
+    return;
+  }
+  window.__CREATURE_HMR_CONNECTED__ = true;
+
+  var HMR_PORT = ${port};
+  var reconnectAttempts = 0;
+  var maxReconnectAttempts = 10;
+  var reconnectDelay = 1000;
+
+  console.log('[Creature HMR] Initializing HMR client, will connect to port ' + HMR_PORT);
+
+  function connect() {
+    if (reconnectAttempts >= maxReconnectAttempts) {
+      console.log('[Creature HMR] Max reconnection attempts reached, giving up');
+      return;
+    }
+
+    console.log('[Creature HMR] Attempting to connect to ws://localhost:' + HMR_PORT + ' (attempt ' + (reconnectAttempts + 1) + ')');
+    var ws = new WebSocket('ws://localhost:' + HMR_PORT);
+
+    ws.onopen = function() {
+      console.log('[Creature HMR] Connected to HMR server on port ' + HMR_PORT);
+      reconnectAttempts = 0;
+    };
+
+    ws.onmessage = function(event) {
+      console.log('[Creature HMR] Received message:', event.data);
+      try {
+        var data = JSON.parse(event.data);
+        
+        if (data.type === 'full-reload') {
+          console.log('[Creature HMR] Full reload triggered, notifying parent');
+          notifyParent();
+        } else if (data.type === 'update') {
+          console.log('[Creature HMR] Update detected, notifying parent');
+          notifyParent();
+        } else if (data.type === 'connected') {
+          console.log('[Creature HMR] Server acknowledged connection');
+        }
+      } catch (e) {
+        console.log('[Creature HMR] Failed to parse message:', e);
+      }
+    };
+
+    ws.onclose = function() {
+      console.log('[Creature HMR] Disconnected, reconnecting in ' + reconnectDelay + 'ms...');
+      reconnectAttempts++;
+      setTimeout(connect, reconnectDelay);
+    };
+
+    ws.onerror = function(err) {
+      console.log('[Creature HMR] WebSocket error:', err);
+    };
+  }
+
+  function notifyParent() {
+    console.log('[Creature HMR] Sending hmr-reload to parent frame');
+    window.parent.postMessage({
+      jsonrpc: '2.0',
+      method: 'ui/notifications/hmr-reload',
+      params: {}
+    }, '*');
+  }
+
+  // Start connection
+  connect();
+})();
+`.trim();
+}
+function generateHmrClientScriptTag(port) {
+  return `<script>${generateHmrClientScript(port)}</script>`;
+}
+
+// src/vite/index.ts
+function findAvailablePort(startPort) {
+  return new Promise((resolve2) => {
+    const server = createNetServer();
+    server.listen(startPort, () => {
+      const port = server.address().port;
+      server.close(() => resolve2(port));
+    });
+    server.on("error", () => {
+      resolve2(findAvailablePort(startPort + 1));
+    });
+  });
+}
+function findPages(dir, baseDir) {
+  const entries = [];
+  if (!existsSync(dir)) return entries;
+  const items = readdirSync(dir);
+  if (items.includes("page.tsx")) {
+    const relativePath = dir.slice(baseDir.length + 1);
+    entries.push({
+      name: relativePath || "main",
+      pagePath: join(dir, "page.tsx")
+    });
+  }
+  for (const item of items) {
+    const fullPath = join(dir, item);
+    if (statSync(fullPath).isDirectory() && !item.startsWith("_") && item !== "node_modules") {
+      entries.push(...findPages(fullPath, baseDir));
+    }
+  }
+  return entries;
+}
+var hmrServer = null;
+var hmrClients = /* @__PURE__ */ new Set();
+function sendWebSocketFrame(socket, data) {
+  const payload = Buffer.from(data);
+  const length = payload.length;
+  let frame;
+  if (length < 126) {
+    frame = Buffer.alloc(2 + length);
+    frame[0] = 129;
+    frame[1] = length;
+    payload.copy(frame, 2);
+  } else if (length < 65536) {
+    frame = Buffer.alloc(4 + length);
+    frame[0] = 129;
+    frame[1] = 126;
+    frame.writeUInt16BE(length, 2);
+    payload.copy(frame, 4);
+  } else {
+    frame = Buffer.alloc(10 + length);
+    frame[0] = 129;
+    frame[1] = 127;
+    frame.writeBigUInt64BE(BigInt(length), 2);
+    payload.copy(frame, 10);
+  }
+  socket.write(frame);
+}
+function startHmrServer(port) {
+  if (hmrServer) return;
+  hmrServer = createHttpServer((_req, res) => {
+    res.writeHead(200);
+    res.end("Creature HMR Server");
+  });
+  hmrServer.on("upgrade", (req, socket, head) => {
+    const key = req.headers["sec-websocket-key"];
+    if (!key) {
+      socket.destroy();
+      return;
+    }
+    const acceptKey = createHash("sha1").update(key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").digest("base64");
+    socket.write(
+      `HTTP/1.1 101 Switching Protocols\r
+Upgrade: websocket\r
+Connection: Upgrade\r
+Sec-WebSocket-Accept: ${acceptKey}\r
+\r
+`
+    );
+    hmrClients.add(socket);
+    sendWebSocketFrame(socket, JSON.stringify({ type: "connected" }));
+    socket.on("close", () => {
+      hmrClients.delete(socket);
+    });
+    socket.on("error", () => {
+      hmrClients.delete(socket);
+    });
+  });
+  hmrServer.listen(port);
+}
+function notifyHmrClients() {
+  const message = JSON.stringify({ type: "full-reload" });
+  const toRemove = [];
+  for (const client of hmrClients) {
+    try {
+      if (!client.destroyed) {
+        sendWebSocketFrame(client, message);
+      } else {
+        toRemove.push(client);
+      }
+    } catch {
+      toRemove.push(client);
+    }
+  }
+  for (const client of toRemove) {
+    hmrClients.delete(client);
+  }
+  if (hmrClients.size > 0) {
+    console.log("App UI reloaded");
+  }
+}
+function creature(options = {}) {
+  const uiDir = options.uiDir || "src/ui";
+  const outDir = options.outDir || "dist/ui";
+  const preferredHmrPort = options.hmrPort || 5899;
+  let root;
+  let tempDir;
+  let entries = [];
+  let hasSingleFilePlugin = false;
+  let hmrPort = null;
+  let isWatchMode = false;
+  let remainingPages = [];
+  return {
+    name: "creature",
+    async config(config) {
+      root = config.root || process.cwd();
+      const uiPath = resolve(root, uiDir);
+      entries = findPages(uiPath, uiPath);
+      if (entries.length === 0) {
+        return;
+      }
+      const plugins = config.plugins?.flat() || [];
+      hasSingleFilePlugin = plugins.some((p) => p && typeof p === "object" && "name" in p && p.name === "vite:singlefile");
+      tempDir = resolve(root, "node_modules/.creature");
+      const selectedPage = process.env.CREATURE_PAGE;
+      if (!selectedPage) {
+        rmSync(tempDir, { recursive: true, force: true });
+      }
+      mkdirSync(tempDir, { recursive: true });
+      for (const entry of entries) {
+        const relativePagePath = relative(tempDir, entry.pagePath).replace(/\\/g, "/");
+        writeFileSync(
+          join(tempDir, `${entry.name}.entry.tsx`),
+          `import { createElement } from "react";
+import { createRoot } from "react-dom/client";
+import Page from "${relativePagePath.replace(/\.tsx$/, "")}";
+createRoot(document.getElementById("root")!).render(createElement(Page));
+`
+        );
+        writeFileSync(
+          join(tempDir, `${entry.name}.html`),
+          `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>${entry.name}</title>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="./${entry.name}.entry.tsx"></script>
+</body>
+</html>`
+        );
+      }
+      let inputs;
+      if (hasSingleFilePlugin) {
+        const targetEntry = selectedPage ? entries.find((e) => e.name === selectedPage) : entries[0];
+        if (!targetEntry) {
+          console.error(`Page "${selectedPage}" not found`);
+          return;
+        }
+        inputs = { [targetEntry.name]: join(tempDir, `${targetEntry.name}.html`) };
+        if (!selectedPage && entries.length > 1) {
+          remainingPages = entries.slice(1).map((e) => e.name);
+        }
+      } else {
+        inputs = Object.fromEntries(
+          entries.map((e) => [e.name, join(tempDir, `${e.name}.html`)])
+        );
+      }
+      return {
+        root: tempDir,
+        publicDir: false,
+        logLevel: "silent",
+        build: {
+          outDir: resolve(root, outDir),
+          emptyOutDir: !selectedPage,
+          rollupOptions: { input: inputs },
+          reportCompressedSize: false
+        }
+      };
+    },
+    async buildStart() {
+      if (!tempDir) return;
+      isWatchMode = this.meta.watchMode === true;
+      if (isWatchMode && !hmrServer) {
+        hmrPort = await findAvailablePort(preferredHmrPort);
+        startHmrServer(hmrPort);
+        mkdirSync(tempDir, { recursive: true });
+        const hmrConfig = { port: hmrPort };
+        writeFileSync(
+          join(tempDir, "hmr.json"),
+          JSON.stringify(hmrConfig, null, 2)
+        );
+      }
+    },
+    writeBundle() {
+      if (!hasSingleFilePlugin || remainingPages.length === 0) {
+        if (isWatchMode) notifyHmrClients();
+        return;
+      }
+      for (const pageName of remainingPages) {
+        spawnSync("npx", ["vite", "build"], {
+          cwd: root,
+          env: { ...process.env, CREATURE_PAGE: pageName },
+          stdio: "inherit"
+        });
+      }
+      if (isWatchMode) {
+        notifyHmrClients();
+      } else {
+        remainingPages = [];
+      }
+    },
+    closeBundle() {
+      if (isWatchMode) return;
+      if (tempDir && existsSync(tempDir) && !process.env.CREATURE_PAGE) {
+        rmSync(tempDir, { recursive: true, force: true });
+      }
+    }
+  };
+}
+var vite_default = creature;
+export {
+  creature,
+  vite_default as default,
+  generateHmrClientScript,
+  generateHmrClientScriptTag
+};
+//# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vite/index.ts","../../src/vite/hmr-client.ts"],"sourcesContent":["import { resolve, join, relative } from \"node:path\";\nimport { readdirSync, statSync, existsSync, writeFileSync, mkdirSync, rmSync } from \"node:fs\";\nimport { createServer as createNetServer } from \"node:net\";\nimport { createServer as createHttpServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { createHash } from \"node:crypto\";\nimport { spawnSync } from \"node:child_process\";\nimport type { Duplex } from \"node:stream\";\nimport type { Plugin, UserConfig } from \"vite\";\n\nexport interface CreaturePluginOptions {\n  uiDir?: string;\n  outDir?: string;\n  hmrPort?: number;\n}\n\nexport interface HmrConfig {\n  port: number;\n}\n\nfunction findAvailablePort(startPort: number): Promise<number> {\n  return new Promise((resolve) => {\n    const server = createNetServer();\n    server.listen(startPort, () => {\n      const port = (server.address() as { port: number }).port;\n      server.close(() => resolve(port));\n    });\n    server.on(\"error\", () => {\n      resolve(findAvailablePort(startPort + 1));\n    });\n  });\n}\n\ninterface EntryPoint {\n  name: string;\n  pagePath: string;\n}\n\nfunction findPages(dir: string, baseDir: string): EntryPoint[] {\n  const entries: EntryPoint[] = [];\n  if (!existsSync(dir)) return entries;\n\n  const items = readdirSync(dir);\n\n  if (items.includes(\"page.tsx\")) {\n    const relativePath = dir.slice(baseDir.length + 1);\n    entries.push({\n      name: relativePath || \"main\",\n      pagePath: join(dir, \"page.tsx\"),\n    });\n  }\n\n  for (const item of items) {\n    const fullPath = join(dir, item);\n    if (statSync(fullPath).isDirectory() && !item.startsWith(\"_\") && item !== \"node_modules\") {\n      entries.push(...findPages(fullPath, baseDir));\n    }\n  }\n\n  return entries;\n}\n\nlet hmrServer: ReturnType<typeof createHttpServer> | null = null;\nlet hmrClients: Set<Duplex> = new Set();\n\nfunction sendWebSocketFrame(socket: Duplex, data: string): void {\n  const payload = Buffer.from(data);\n  const length = payload.length;\n  \n  let frame: Buffer;\n  if (length < 126) {\n    frame = Buffer.alloc(2 + length);\n    frame[0] = 0x81;\n    frame[1] = length;\n    payload.copy(frame, 2);\n  } else if (length < 65536) {\n    frame = Buffer.alloc(4 + length);\n    frame[0] = 0x81;\n    frame[1] = 126;\n    frame.writeUInt16BE(length, 2);\n    payload.copy(frame, 4);\n  } else {\n    frame = Buffer.alloc(10 + length);\n    frame[0] = 0x81;\n    frame[1] = 127;\n    frame.writeBigUInt64BE(BigInt(length), 2);\n    payload.copy(frame, 10);\n  }\n  \n  socket.write(frame);\n}\n\nfunction startHmrServer(port: number): void {\n  if (hmrServer) return;\n  \n  hmrServer = createHttpServer((_req: IncomingMessage, res: ServerResponse) => {\n    res.writeHead(200);\n    res.end(\"Creature HMR Server\");\n  });\n  \n  hmrServer.on(\"upgrade\", (req: IncomingMessage, socket: Duplex, head: Buffer) => {\n    const key = req.headers[\"sec-websocket-key\"];\n    if (!key) {\n      socket.destroy();\n      return;\n    }\n    \n    const acceptKey = createHash(\"sha1\")\n      .update(key + \"258EAFA5-E914-47DA-95CA-C5AB0DC85B11\")\n      .digest(\"base64\");\n    \n    socket.write(\n      \"HTTP/1.1 101 Switching Protocols\\r\\n\" +\n      \"Upgrade: websocket\\r\\n\" +\n      \"Connection: Upgrade\\r\\n\" +\n      `Sec-WebSocket-Accept: ${acceptKey}\\r\\n` +\n      \"\\r\\n\"\n    );\n    \n    hmrClients.add(socket);\n    sendWebSocketFrame(socket, JSON.stringify({ type: \"connected\" }));\n    \n    socket.on(\"close\", () => {\n      hmrClients.delete(socket);\n    });\n    \n    socket.on(\"error\", () => {\n      hmrClients.delete(socket);\n    });\n  });\n  \n  hmrServer.listen(port);\n}\n\nfunction notifyHmrClients(): void {\n  const message = JSON.stringify({ type: \"full-reload\" });\n  const toRemove: Duplex[] = [];\n  \n  for (const client of hmrClients) {\n    try {\n      if (!client.destroyed) {\n        sendWebSocketFrame(client, message);\n      } else {\n        toRemove.push(client);\n      }\n    } catch {\n      toRemove.push(client);\n    }\n  }\n  \n  for (const client of toRemove) {\n    hmrClients.delete(client);\n  }\n  \n  if (hmrClients.size > 0) {\n    console.log(\"App UI reloaded\");\n  }\n}\n\n/**\n * Vite plugin for Creature MCP Apps.\n * \n * Just write page.tsx files - no HTML or entry files needed.\n * \n * ```\n * src/ui/\n * ├── page.tsx         → dist/ui/main.html\n * ├── inline/page.tsx  → dist/ui/inline.html\n * └── _components/     → ignored\n * ```\n * \n * When using vite-plugin-singlefile, multiple pages are built automatically\n * via sequential builds (singlefile requires single entry per build).\n */\nexport function creature(options: CreaturePluginOptions = {}): Plugin {\n  const uiDir = options.uiDir || \"src/ui\";\n  const outDir = options.outDir || \"dist/ui\";\n  const preferredHmrPort = options.hmrPort || 5899;\n  \n  let root: string;\n  let tempDir: string;\n  let entries: EntryPoint[] = [];\n  let hasSingleFilePlugin = false;\n  let hmrPort: number | null = null;\n  let isWatchMode = false;\n  let remainingPages: string[] = [];\n\n  return {\n    name: \"creature\",\n    \n    async config(config) {\n      root = config.root || process.cwd();\n      const uiPath = resolve(root, uiDir);\n      entries = findPages(uiPath, uiPath);\n\n      if (entries.length === 0) {\n        return;\n      }\n\n      const plugins = config.plugins?.flat() || [];\n      hasSingleFilePlugin = plugins.some(p => p && typeof p === 'object' && 'name' in p && p.name === 'vite:singlefile');\n\n      tempDir = resolve(root, \"node_modules/.creature\");\n      \n      const selectedPage = process.env.CREATURE_PAGE;\n      \n      if (!selectedPage) {\n        rmSync(tempDir, { recursive: true, force: true });\n      }\n      mkdirSync(tempDir, { recursive: true });\n\n      for (const entry of entries) {\n        const relativePagePath = relative(tempDir, entry.pagePath).replace(/\\\\/g, \"/\");\n        writeFileSync(join(tempDir, `${entry.name}.entry.tsx`), \n`import { createElement } from \"react\";\nimport { createRoot } from \"react-dom/client\";\nimport Page from \"${relativePagePath.replace(/\\.tsx$/, \"\")}\";\ncreateRoot(document.getElementById(\"root\")!).render(createElement(Page));\n`);\n\n        writeFileSync(join(tempDir, `${entry.name}.html`),\n`<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\" />\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n  <title>${entry.name}</title>\n</head>\n<body>\n  <div id=\"root\"></div>\n  <script type=\"module\" src=\"./${entry.name}.entry.tsx\"></script>\n</body>\n</html>`);\n      }\n      \n      let inputs: Record<string, string>;\n      \n      if (hasSingleFilePlugin) {\n        const targetEntry = selectedPage \n          ? entries.find(e => e.name === selectedPage)\n          : entries[0];\n          \n        if (!targetEntry) {\n          console.error(`Page \"${selectedPage}\" not found`);\n          return;\n        }\n        \n        inputs = { [targetEntry.name]: join(tempDir, `${targetEntry.name}.html`) };\n        \n        if (!selectedPage && entries.length > 1) {\n          remainingPages = entries.slice(1).map(e => e.name);\n        }\n      } else {\n        inputs = Object.fromEntries(\n          entries.map(e => [e.name, join(tempDir, `${e.name}.html`)])\n        );\n      }\n\n      return {\n        root: tempDir,\n        publicDir: false,\n        logLevel: \"silent\" as const,\n        build: {\n          outDir: resolve(root, outDir),\n          emptyOutDir: !selectedPage,\n          rollupOptions: { input: inputs },\n          reportCompressedSize: false,\n        },\n      } satisfies UserConfig;\n    },\n\n    async buildStart() {\n      if (!tempDir) return;\n      \n      isWatchMode = this.meta.watchMode === true;\n      \n      if (isWatchMode && !hmrServer) {\n        hmrPort = await findAvailablePort(preferredHmrPort);\n        startHmrServer(hmrPort);\n        \n        mkdirSync(tempDir, { recursive: true });\n        const hmrConfig: HmrConfig = { port: hmrPort };\n        writeFileSync(\n          join(tempDir, \"hmr.json\"),\n          JSON.stringify(hmrConfig, null, 2)\n        );\n      }\n    },\n\n    writeBundle() {\n      if (!hasSingleFilePlugin || remainingPages.length === 0) {\n        if (isWatchMode) notifyHmrClients();\n        return;\n      }\n      \n      for (const pageName of remainingPages) {\n        spawnSync(\"npx\", [\"vite\", \"build\"], {\n          cwd: root,\n          env: { ...process.env, CREATURE_PAGE: pageName },\n          stdio: \"inherit\",\n        });\n      }\n      \n      if (isWatchMode) {\n        notifyHmrClients();\n      } else {\n        remainingPages = [];\n      }\n    },\n\n    closeBundle() {\n      if (isWatchMode) return;\n      \n      if (tempDir && existsSync(tempDir) && !process.env.CREATURE_PAGE) {\n        rmSync(tempDir, { recursive: true, force: true });\n      }\n    },\n  };\n}\n\nexport { generateHmrClientScript, generateHmrClientScriptTag } from \"./hmr-client.js\";\n\nexport default creature;\n","/**\n * HMR Client Script\n * \n * This script is injected into MCP App HTML during development mode.\n * It connects to Vite's HMR WebSocket and notifies the parent frame\n * when a full reload is needed.\n * \n * The parent frame (Creature host) will then:\n * 1. Save current widget state\n * 2. Re-fetch fresh HTML from the MCP server\n * 3. Reload the iframe with new content\n * 4. Restore widget state\n */\n\n/**\n * Generate the HMR client script as a string.\n * The port is injected at generation time.\n */\nexport function generateHmrClientScript(port: number): string {\n  return `\n(function() {\n  if (window.parent === window) {\n    console.log('[Creature HMR] Not in iframe, skipping HMR client');\n    return;\n  }\n  if (window.__CREATURE_HMR_CONNECTED__) {\n    console.log('[Creature HMR] Already connected, skipping');\n    return;\n  }\n  window.__CREATURE_HMR_CONNECTED__ = true;\n\n  var HMR_PORT = ${port};\n  var reconnectAttempts = 0;\n  var maxReconnectAttempts = 10;\n  var reconnectDelay = 1000;\n\n  console.log('[Creature HMR] Initializing HMR client, will connect to port ' + HMR_PORT);\n\n  function connect() {\n    if (reconnectAttempts >= maxReconnectAttempts) {\n      console.log('[Creature HMR] Max reconnection attempts reached, giving up');\n      return;\n    }\n\n    console.log('[Creature HMR] Attempting to connect to ws://localhost:' + HMR_PORT + ' (attempt ' + (reconnectAttempts + 1) + ')');\n    var ws = new WebSocket('ws://localhost:' + HMR_PORT);\n\n    ws.onopen = function() {\n      console.log('[Creature HMR] Connected to HMR server on port ' + HMR_PORT);\n      reconnectAttempts = 0;\n    };\n\n    ws.onmessage = function(event) {\n      console.log('[Creature HMR] Received message:', event.data);\n      try {\n        var data = JSON.parse(event.data);\n        \n        if (data.type === 'full-reload') {\n          console.log('[Creature HMR] Full reload triggered, notifying parent');\n          notifyParent();\n        } else if (data.type === 'update') {\n          console.log('[Creature HMR] Update detected, notifying parent');\n          notifyParent();\n        } else if (data.type === 'connected') {\n          console.log('[Creature HMR] Server acknowledged connection');\n        }\n      } catch (e) {\n        console.log('[Creature HMR] Failed to parse message:', e);\n      }\n    };\n\n    ws.onclose = function() {\n      console.log('[Creature HMR] Disconnected, reconnecting in ' + reconnectDelay + 'ms...');\n      reconnectAttempts++;\n      setTimeout(connect, reconnectDelay);\n    };\n\n    ws.onerror = function(err) {\n      console.log('[Creature HMR] WebSocket error:', err);\n    };\n  }\n\n  function notifyParent() {\n    console.log('[Creature HMR] Sending hmr-reload to parent frame');\n    window.parent.postMessage({\n      jsonrpc: '2.0',\n      method: 'ui/notifications/hmr-reload',\n      params: {}\n    }, '*');\n  }\n\n  // Start connection\n  connect();\n})();\n`.trim();\n}\n\n/**\n * Generate a script tag with the HMR client code.\n */\nexport function generateHmrClientScriptTag(port: number): string {\n  return `<script>${generateHmrClientScript(port)}</script>`;\n}\n"],"mappings":"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","names":["resolve"]}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@creature-ai/sdk",
+  "version": "0.1.1",
+  "description": "SDK for building MCP Apps that work on both Creature and ChatGPT",
+  "type": "module",
+  "exports": {
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js",
+      "require": "./dist/vite/index.js",
+      "default": "./dist/vite/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^0.2.2",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "express": "^5.1.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.2",
+    "@types/node": "^22.15.21",
+    "@types/react": "^19.1.6",
+    "@types/ws": "^8.5.13",
+    "cac": "^6.7.14",
+    "react": "^19.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "chatgpt",
+    "creature",
+    "claude",
+    "ai-tools"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/serverlessinc/creature.git",
+    "directory": "desktop/sdk"
+  }
+}