@creature-ai/sdk 0.1.1 → 0.1.3

package/dist/react/index.d.ts

@@ -1,8 +1,7 @@
-import { ChannelStatus, AppSession } from '../core/index.js';
-export { ChannelClient, ChannelClientConfig, ChatGPTHostClient, McpHostClient, createChannel, createHost, detectEnvironment } from '../core/index.js';
-import { T as ToolResult, W as WidgetState, E as Environment, H as HostClient, a as AppSessionState } from '../types-DcoqlK46.js';
-export { b as AppSessionListener, A as AppSessionOptions, d as HostClientConfig, f as HostClientEvents, e as HostClientState, c as HostContext, L as LogLevel, S as StructuredWidgetState } from '../types-DcoqlK46.js';
+import { ToolResult, WidgetState, Environment, DisplayMode, WebSocketStatus } from '../core/index.js';
+export { ChatGptAppHostClient, HostClient, HostClientConfig, HostClientEvents, HostClientState, HostContext, LogLevel, McpAppHostClient, StructuredWidgetState, WebSocketClient, WebSocketClientConfig, createHost, createWebSocket, detectEnvironment } from '../core/index.js';
 import * as react from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { applyDocumentTheme, applyHostFonts, applyHostStyleVariables, getDocumentTheme } from '@modelcontextprotocol/ext-apps';
 
 interface UseHostConfig {
@@ -56,6 +55,11 @@ interface UseHostReturn {
     environment: Environment;
     widgetState: WidgetState | null;
     setWidgetState: (state: WidgetState | null) => void;
+    requestDisplayMode: (params: {
+        mode: DisplayMode;
+    }) => Promise<{
+        mode: DisplayMode;
+    }>;
     /**
      * Logger for sending messages to the host's DevConsole.
      *
@@ -79,6 +83,45 @@ interface UseHostReturn {
      */
     log: Logger;
 }
+interface UseToolResultReturn<T> {
+    /** Structured data from tool result */
+    data: T | null;
+    /** Instance ID for this widget */
+    instanceId: string | null;
+    /** Title for PIP tab */
+    title: string | null;
+    /** Whether this is an error result */
+    isError: boolean;
+    /** Text content for AI context */
+    text: string | null;
+    /** Callback to handle tool result */
+    onToolResult: (result: ToolResult) => void;
+    /** Reset all state */
+    reset: () => void;
+}
+interface UseWebSocketConfig<TReceive = unknown> {
+    onMessage?: (message: TReceive) => void;
+    enabled?: boolean;
+}
+interface UseWebSocketReturn<TSend = unknown> {
+    status: WebSocketStatus;
+    error: string | undefined;
+    send: (message: TSend) => void;
+}
+interface CreatureIconProps {
+    /** Whether the app is in dark mode */
+    isDarkMode: boolean;
+    /** Whether to show the eyes (default: true) */
+    showEyes?: boolean;
+    /** Whether to enable eye blinking animation (default: false) */
+    enableBlink?: boolean;
+    /** Width of the icon in pixels */
+    width?: number;
+    /** Height of the icon in pixels */
+    height?: number;
+    /** Optional className for additional styling */
+    className?: string;
+}
 
 /**
  * React hook for connecting to an MCP Apps host.
@@ -106,14 +149,10 @@ interface UseHostReturn {
  */
 declare function useHost(config: UseHostConfig): UseHostReturn;
 
-interface UseToolResultReturn<T> {
-    data: T | null;
-    title: string | null;
-    isError: boolean;
-    text: string | null;
-    onToolResult: (result: ToolResult) => void;
-    reset: () => void;
-}
+/**
+ * Hook to access tool result data.
+ * Extracts data, instanceId, title, and error state from tool results.
+ */
 declare function useToolResult<T = Record<string, unknown>>(): UseToolResultReturn<T>;
 
 type SetStateAction<T> = T | ((prev: T) => T);
@@ -124,29 +163,15 @@ interface WidgetStateContextValue {
 declare const WidgetStateContext: react.Context<WidgetStateContextValue | null>;
 declare function useWidgetState<T extends WidgetState>(initialState?: T | (() => T | null) | null): readonly [T | null, (state: SetStateAction<T | null>) => void];
 
-interface UseChannelConfig<TReceive = unknown> {
-    onMessage?: (message: TReceive) => void;
-    enabled?: boolean;
-}
-interface UseChannelReturn<TSend = unknown> {
-    status: ChannelStatus;
-    error: string | undefined;
-    send: (message: TSend) => void;
-}
-declare function useChannel<TSend = unknown, TReceive = unknown>(url: string | undefined, config?: UseChannelConfig<TReceive>): UseChannelReturn<TSend>;
+declare function useWebSocket<TSend = unknown, TReceive = unknown>(url: string | undefined, config?: UseWebSocketConfig<TReceive>): UseWebSocketReturn<TSend>;
 
-interface UseAppSessionConfig<TInternal extends Record<string, unknown> = Record<string, unknown>, TBackend extends Record<string, unknown> = Record<string, unknown>, TUi extends WidgetState | null = WidgetState | null> {
-    hostClient?: HostClient;
-    initialState?: Partial<AppSessionState<TInternal, TBackend, TUi>>;
-    id?: string;
-}
-interface UseAppSessionReturn<TInternal extends Record<string, unknown> = Record<string, unknown>, TBackend extends Record<string, unknown> = Record<string, unknown>, TUi extends WidgetState | null = WidgetState | null> {
-    session: AppSession<TInternal, TBackend, TUi>;
-    state: AppSessionState<TInternal, TBackend, TUi>;
-    ui: TUi;
-    setUi: (ui: TUi) => void;
-    updateUi: (partial: TUi extends null ? never : Partial<NonNullable<TUi>>) => void;
-}
-declare function useAppSession<TInternal extends Record<string, unknown> = Record<string, unknown>, TBackend extends Record<string, unknown> = Record<string, unknown>, TUi extends WidgetState | null = WidgetState | null>(config?: UseAppSessionConfig<TInternal, TBackend, TUi>): UseAppSessionReturn<TInternal, TBackend, TUi>;
+/**
+ * CreatureIcon Component
+ *
+ * The Creature mascot icon with theme-aware colors.
+ * Uses the main creature shape with optional eyes, adapting colors for dark/light mode.
+ * Supports optional eye blinking animation at random intervals.
+ */
+declare function CreatureIcon({ isDarkMode, showEyes, enableBlink, width, height, className, }: CreatureIconProps): react_jsx_runtime.JSX.Element;
 
-export { AppSession, AppSessionState, ChannelStatus, Environment, HostClient, type Logger, ToolResult, type UseAppSessionConfig, type UseAppSessionReturn, type UseChannelConfig, type UseChannelReturn, type UseHostConfig, type UseHostReturn, type UseToolResultReturn, WidgetState, WidgetStateContext, useAppSession, useChannel, useHost, useToolResult, useWidgetState };
+export { CreatureIcon, type CreatureIconProps, DisplayMode, Environment, type Logger, ToolResult, type UseHostConfig, type UseHostReturn, type UseToolResultReturn, type UseWebSocketConfig, type UseWebSocketReturn, WebSocketStatus, WidgetState, WidgetStateContext, useHost, useToolResult, useWebSocket, useWidgetState };