@creature-ai/sdk 0.1.2 → 0.1.3

package/package.json

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

package/dist/types-JBEuUzEi.d.ts

@@ -1,186 +0,0 @@
-/**
- * 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";
-/**
- * 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.
- */
-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?: DisplayMode;
-    availableDisplayModes?: DisplayMode[];
-    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;
-    /**
-     * 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.
-     *
-     * 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, 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 };