@creature-ai/sdk 0.1.1 → 0.1.2

package/dist/{types-DcoqlK46.d.ts → types-JBEuUzEi.d.ts}

@@ -6,6 +6,13 @@
  * Environment types for host detection.
  */
 type Environment = "chatgpt" | "mcp-apps" | "standalone";
+/**
+ * Display modes for UI resources.
+ * - "inline": Embedded within the conversation flow
+ * - "pip": Picture-in-picture floating panel
+ * - "fullscreen": Full-screen overlay
+ */
+type DisplayMode = "inline" | "pip" | "fullscreen";
 /**
  * Log severity levels matching MCP protocol LoggingLevel.
  * These are displayed in the host's DevConsole with appropriate colors.
@@ -75,7 +82,8 @@ interface HostContext {
     styles?: {
         variables?: Record<string, string>;
     };
-    displayMode?: "pip" | "inline";
+    displayMode?: DisplayMode;
+    availableDisplayModes?: DisplayMode[];
     viewport?: {
         width: number;
         height: number;
@@ -141,6 +149,21 @@ interface HostClient {
     sendNotification(method: string, params: unknown): void;
     /** Set widget state */
     setWidgetState(state: WidgetState | null): void;
+    /**
+     * Request a display mode change from the host.
+     *
+     * The host may refuse or coerce the request (e.g., "pip" → "fullscreen" on mobile).
+     * Always check `availableDisplayModes` in host context before calling, and handle
+     * the returned mode differing from the requested mode.
+     *
+     * @param params - Object containing the requested display mode
+     * @returns Promise resolving to the actual display mode granted by the host
+     */
+    requestDisplayMode(params: {
+        mode: DisplayMode;
+    }): Promise<{
+        mode: DisplayMode;
+    }>;
     /**
      * Send a log message to the host's DevConsole.
      *
@@ -160,4 +183,4 @@ interface HostClient {
     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 };
+export type { AppSessionOptions as A, DisplayMode as D, 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@creature-ai/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "SDK for building MCP Apps that work on both Creature and ChatGPT",
   "type": "module",
   "exports": {