npm - @creature-ai/sdk - Versions diffs - 0.1.7 → 0.1.8 - Mend

@creature-ai/sdk 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/server/index.d.ts CHANGED Viewed

@@ -100,15 +100,27 @@ interface ResourceConfig {
     displayModes: DisplayMode[];
     /**
      * HTML content for the resource.
-     * Can be a string path (resolved relative to the server file's directory),
-     * or a function that returns the HTML content.
+     *
+     * Accepts three formats:
+     * 1. **File path** (local development): `"ui/main.html"` - loaded from filesystem
+     * 2. **Raw HTML** (serverless-safe): `"<!DOCTYPE html>..."` - used directly
+     * 3. **Function** (lazy loading): `() => htmlContent` - called when needed
+     *
+     * The SDK auto-detects HTML content (starts with `<`) vs file paths.
+     * For serverless (Vercel, Lambda), use raw HTML or a function.
      *
      * @example
-     * // Simple path (recommended)
+     * // Local development - file path
      * html: "ui/main.html"
      *
-     * // Function for dynamic content
-     * html: () => loadHtml("./ui/main.html")
+     * @example
+     * // Serverless - bundled HTML (import at build time)
+     * import { BUNDLED_HTML } from "./ui-bundle.js";
+     * html: BUNDLED_HTML
+     *
+     * @example
+     * // Serverless - function (lazy)
+     * html: () => fs.readFileSync("./dist/ui/main.html", "utf-8")
      */
     html: string | (() => string | Promise<string>);
     /** Optional icon for pips */
@@ -607,10 +619,29 @@ declare function svgToDataUri(svg: string): string;
  */
 declare function loadHtml(filePath: string, basePath?: string): string;
 /**
- * Create an HTML loader function for a file path.
- * Useful for defining resources with lazy-loaded HTML.
+ * Check if a string is HTML content (vs a file path).
+ *
+ * HTML content detection:
+ * - Starts with `<` (with optional whitespace/BOM)
+ * - Starts with `<!DOCTYPE` (case-insensitive)
+ *
+ * This enables serverless deployments where HTML is bundled at build time
+ * and passed directly as a string, rather than loaded from the filesystem.
+ */
+declare function isHtmlContent(str: string): boolean;
+/**
+ * Create an HTML loader function for a file path or HTML content.
+ *
+ * For serverless environments (Vercel, Lambda), developers can:
+ * 1. Pass HTML content directly: `html: "<!DOCTYPE html>..."`
+ * 2. Use a function: `html: () => BUNDLED_HTML`
+ * 3. Import bundled HTML: `html: await import("./ui-bundle.js").then(m => m.HTML)`
+ *
+ * The SDK automatically detects whether the string is:
+ * - HTML content (starts with `<`) → returns as-is
+ * - File path → loads via filesystem (local dev only)
  */
-declare function htmlLoader(filePath: string, basePath?: string): () => string;
+declare function htmlLoader(htmlOrPath: string, basePath?: string): () => string;
 /**
  * Middleware for adding cross-platform compatibility to the official MCP SDK.
@@ -784,4 +815,4 @@ interface VerifyConfig {
  */
 declare const verifyCreatureToken: (tokenOrHeader: string | undefined | null, config?: VerifyConfig) => Promise<CreatureIdentity>;
-export { type AdapterOptions, App, type AppConfig, type AwsLambdaOptions, type CreatureIdentity, type CreatureOrganization, type CreatureProject, type CreatureSession, CreatureTokenError, type CreatureUser, type DisplayMode, type IconConfig, type InstanceDestroyContext, MIME_TYPES, type RealtimeAdapter, type ResourceConfig, type StateAdapter, type ToolConfig, type ToolContext, type ToolHandler, type ToolResult, type ToolVisibility, type TransportSessionInfo, type TransportType, type VercelMcpOptions, type WebSocketConnection, createApp, htmlLoader, loadHtml, svgToDataUri, verifyCreatureToken, wrapServer };
+export { type AdapterOptions, App, type AppConfig, type AwsLambdaOptions, type CreatureIdentity, type CreatureOrganization, type CreatureProject, type CreatureSession, CreatureTokenError, type CreatureUser, type DisplayMode, type IconConfig, type InstanceDestroyContext, MIME_TYPES, type RealtimeAdapter, type ResourceConfig, type StateAdapter, type ToolConfig, type ToolContext, type ToolHandler, type ToolResult, type ToolVisibility, type TransportSessionInfo, type TransportType, type VercelMcpOptions, type WebSocketConnection, createApp, htmlLoader, isHtmlContent, loadHtml, svgToDataUri, verifyCreatureToken, wrapServer };

package/dist/server/index.js CHANGED Viewed

@@ -13401,7 +13401,7 @@ import path from "path";
 // src/vite/index.ts
 import { resolve, join, relative } from "path";
-import { readdirSync, statSync, existsSync, writeFileSync, mkdirSync, rmSync } from "fs";
+import { readdirSync, statSync, existsSync, writeFileSync, mkdirSync, rmSync, readFileSync } from "fs";
 import { createServer as createNetServer } from "net";
 import { createServer as createHttpServer } from "http";
 import { createHash } from "crypto";
@@ -13554,8 +13554,15 @@ function loadHtml(filePath, basePath) {
 <p>Run <code>npm run build</code> to build the UI.</p>
 </body></html>`;
 }
-function htmlLoader(filePath, basePath) {
-  return () => loadHtml(filePath, basePath);
+function isHtmlContent(str) {
+  const trimmed = str.trimStart();
+  return trimmed.startsWith("<") || trimmed.toLowerCase().startsWith("<!doctype");
+}
+function htmlLoader(htmlOrPath, basePath) {
+  if (isHtmlContent(htmlOrPath)) {
+    return () => htmlOrPath;
+  }
+  return () => loadHtml(htmlOrPath, basePath);
 }
 function isInitializeRequest2(body) {
   if (typeof body !== "object" || body === null) return false;
@@ -14856,6 +14863,7 @@ export {
   MIME_TYPES,
   createApp,
   htmlLoader,
+  isHtmlContent,
   loadHtml,
   svgToDataUri,
   verifyCreatureToken,