@leanmcp/ui 0.3.0 → 0.3.2

package/README.md

@@ -1,6 +1,42 @@
-# @leanmcp/ui
-
-**MCP-Native UI SDK for React** - Build rich, interactive MCP Apps with first-class tool integration.
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.svg"
+    alt="LeanMCP Logo"
+    width="400"
+  />
+</p>
+
+<p align="center">
+  <strong>@leanmcp/ui</strong><br/>
+  MCP-Native UI SDK for React — Build rich, interactive MCP Apps with first-class tool integration.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@leanmcp/ui">
+    <img src="https://img.shields.io/npm/v/@leanmcp/ui" alt="npm version" />
+  </a>
+  <a href="https://www.npmjs.com/package/@leanmcp/ui">
+    <img src="https://img.shields.io/npm/dm/@leanmcp/ui" alt="npm downloads" />
+  </a>
+  <a href="https://docs.leanmcp.com/sdk/ui">
+    <img src="https://img.shields.io/badge/Docs-leanmcp-0A66C2?" />
+  </a>
+  <a href="https://discord.com/invite/DsRcA3GwPy">
+    <img src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white" />
+  </a>
+  <a href="https://x.com/LeanMcp">
+    <img src="https://img.shields.io/badge/@LeanMCP-f5f5f5?logo=x&logoColor=000000" />
+  </a>
+</p>
+
+## Features
+
+- **MCP-Native Components** — ToolButton, ToolSelect, ToolForm, ToolDataGrid, and more
+- **First-Class Tool Integration** — Components that natively call MCP tools
+- **ChatGPT Apps Support** — Build apps that work inside ChatGPT with `@GPTApp`
+- **Streaming Support** — Handle partial/streaming tool responses
+- **Theming** — Automatic host theme adaptation (light/dark)
+- **Testing Utilities** — `MockAppProvider` for unit testing
 
 ## Installation
 
@@ -57,6 +93,18 @@ function MyApp() {
 | `useMessage` | Send messages to host chat |
 | `useHostContext` | Access host theme and viewport |
 
+### GPT Apps SDK Hooks
+
+These hooks provide access to the ChatGPT Apps SDK globals (compatible with OpenAI's `window.openai` API):
+
+| Hook | Description |
+|------|-------------|
+| `useToolOutput` | Access `structuredContent` from the tool response |
+| `useToolInput` | Access input arguments passed to the tool |
+| `useWidgetState` | Read/write persistent widget state across sessions |
+| `useToolResponseMetadata` | Access `_meta` from the tool response |
+| `useOpenAiGlobal` | Low-level hook to subscribe to any `window.openai` property |
+
 ## Examples
 
 ### ToolButton with Confirmation
@@ -126,6 +174,70 @@ function MyApp() {
 />
 ```
 
+## Server-Side Integration
+
+Use `@UIApp` decorator to register your React component as an MCP resource.
+
+> **Note:** Use a relative path string for the `component` property, not an imported component. This avoids importing React components on the server side.
+
+```typescript
+// mcp/dashboard/index.ts
+import { UIApp } from '@leanmcp/core';
+
+export class DashboardService {
+  @UIApp({
+    component: './Dashboard',  // Path relative to this file
+    name: 'dashboard',
+    title: 'Analytics Dashboard'
+  })
+  dashboard() {}
+}
+```
+
+## ChatGPT Integration
+
+Use `@GPTApp` for ChatGPT-specific apps:
+
+```typescript
+import { GPTApp } from '@leanmcp/ui';
+
+export class SlackService {
+  @GPTApp({
+    component: './SlackApp',  // Path relative to this file
+    name: 'slack-composer'
+  })
+  slackComposer() {}
+}
+```
+
+### GPT Apps SDK Hooks Usage
+
+Access tool output (structuredContent) without making additional API calls:
+
+```tsx
+import { useToolOutput, useWidgetState } from '@leanmcp/ui';
+
+function ChannelsView() {
+  // Access the structured data from the tool response
+  const toolOutput = useToolOutput<{ channels: Channel[] }>();
+  
+  // Persist state across the session
+  const [state, setState] = useWidgetState({ selectedChannel: null });
+  
+  if (!toolOutput?.channels) return <div>Loading...</div>;
+  
+  return (
+    <ul>
+      {toolOutput.channels.map(ch => (
+        <li key={ch.id} onClick={() => setState({ selectedChannel: ch.id })}>
+          {ch.name}
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
 ## Theming
 
 The SDK uses CSS variables compatible with MCP host theming. Import the styles:
@@ -155,6 +267,19 @@ test('renders tool result', () => {
 });
 ```
 
+## Documentation
+
+- [Full Documentation](https://docs.leanmcp.com/sdk/ui)
+- [Component Reference](https://docs.leanmcp.com/sdk/ui-components)
+- [Hooks Reference](https://docs.leanmcp.com/sdk/ui-hooks)
+- [ChatGPT Apps Guide](https://docs.leanmcp.com/sdk/ui-gpt-apps)
+
+## Related Packages
+
+- [@leanmcp/core](https://www.npmjs.com/package/@leanmcp/core) — Core MCP server functionality
+- [@leanmcp/cli](https://www.npmjs.com/package/@leanmcp/cli) — CLI for project scaffolding
+- [@leanmcp/auth](https://www.npmjs.com/package/@leanmcp/auth) — Authentication decorators
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -124,11 +124,35 @@ declare function useMcpApp(): McpAppContextValue;
 
 /**
  * ChatGPT's window.openai interface
- * Only includes properties that are confirmed to exist in the ChatGPT Apps SDK
+ * Based on: https://developers.openai.com/apps-sdk/build/chatgpt-ui#understand-the-windowopenai-api
  */
 interface OpenAISDK {
+    /** Input arguments for the tool */
+    toolInput?: Record<string, unknown>;
+    /** Structured content returned by the tool */
+    toolOutput?: any;
+    /** Metadata returned by the tool */
+    toolResponseMetadata?: Record<string, unknown>;
+    /** Persisted state for this widget instance */
+    widgetState?: Record<string, unknown>;
     /** Call a server tool */
     callTool: (name: string, args: Record<string, unknown>) => Promise<any>;
+    /** Send a follow-up message to chat */
+    sendFollowUpMessage?: (options: {
+        prompt: string;
+    }) => Promise<void>;
+    /** Upload a file */
+    uploadFile?: (file: File) => Promise<{
+        fileId: string;
+    }>;
+    /** Get download URL for a file */
+    getFileDownloadUrl?: (options: {
+        fileId: string;
+    }) => Promise<{
+        downloadUrl: string;
+    }>;
+    /** Persist widget state */
+    setWidgetState?: (state: Record<string, unknown>) => void;
     /** Current theme */
     theme?: 'light' | 'dark';
     /** Current locale */
@@ -137,6 +161,15 @@ interface OpenAISDK {
     displayMode?: 'inline' | 'modal' | 'fullscreen';
     /** Maximum height for the widget */
     maxHeight?: number;
+    /** Safe area insets */
+    safeArea?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** View type */
+    view?: 'desktop' | 'mobile';
 }
 declare global {
     interface Window {
@@ -1143,7 +1176,7 @@ interface UseToolInputReturn<T = Record<string, unknown>> {
  * }
  * ```
  */
-declare function useToolInput<T = Record<string, unknown>>(): UseToolInputReturn<T>;
+declare function useToolInput$1<T = Record<string, unknown>>(): UseToolInputReturn<T>;
 
 interface UseToolInputPartialReturn {
     /** Partial arguments currently available */
@@ -1216,6 +1249,52 @@ interface UseToolSubscriptionResult<T = unknown> {
  */
 declare function useToolSubscription<T = unknown>(toolName: string, options?: UseToolSubscriptionOptions): UseToolSubscriptionResult<T>;
 
+interface OpenAiGlobals {
+    toolInput: Record<string, unknown>;
+    toolOutput: any;
+    toolResponseMetadata: Record<string, unknown>;
+    widgetState: Record<string, unknown>;
+    theme: 'light' | 'dark';
+    displayMode: 'inline' | 'modal' | 'fullscreen';
+    maxHeight: number;
+    safeArea: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    view: 'desktop' | 'mobile';
+    locale: string;
+}
+/**
+ * React hook to subscribe to window.openai global values.
+ * Source: https://developers.openai.com/apps-sdk/build/chatgpt-ui#useopenaiglobal
+ */
+declare function useOpenAiGlobal<K extends keyof OpenAiGlobals>(key: K): OpenAiGlobals[K] | undefined;
+
+/**
+ * Access the structured content returned by the tool.
+ * Maps to 'structuredContent' in the tool response.
+ */
+declare function useToolOutput<T = any>(): T | undefined;
+/**
+ * Access metadata about the tool response.
+ * Maps to '_meta' in the tool response.
+ */
+declare function useToolResponseMetadata<T = any>(): T | undefined;
+/**
+ * Access the input arguments passed to the tool.
+ */
+declare function useToolInput<T = any>(): T | undefined;
+
+/**
+ * Hook to read and write widget state.
+ * Widget state persists across the session for this specific widget instance.
+ *
+ * @param initialState - Default state if none exists
+ */
+declare function useWidgetState<T extends Record<string, unknown>>(initialState: T | (() => T)): [T, (newState: T | ((prev: T) => T)) => void];
+
 declare function CardTitle({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function CardDescription({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
@@ -1623,4 +1702,4 @@ interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>
  */
 declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement>>;
 
-export { ActionButton, type ActionButtonProps, Alert, AlertDescription, AlertTitle, type AppInfo, type AppOptions, AppProvider, type AppProviderProps, AppShell, type AppShellProps, Badge, Button, type ButtonProps, Card, CardContent, type CardContentProps, CardDescription, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, Chart, type ChartProps, type ChartType, Checkbox, CodeBlock, type CodeBlockProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ConfirmConfig, DEFAULT_RESULT_CONFIG, DataGrid, type DataGridColumn, type DataGridProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GPTAppProvider, type GPTAppProviderProps, type GptAppContextValue, INITIAL_TOOL_STATE, Input, type InputProps, Label, type McpActionProps, type McpAppContextValue, Modal, type ModalProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RequireConnection, type RequireConnectionProps, type ResourceBinding, type ResourceMeta, ResourceView, type ResourceViewProps, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, Slider, StreamingContent, type StreamingContentProps, Switch, TabContent, type TabContentProps, type TabItem, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, type TabsProps, TabsTrigger, Textarea, Toaster, type ToolBinding, ToolButton, type ToolButtonProps, type ToolButtonState, type ToolCallState, type ToolContextValue, ToolDataGrid, type ToolDataGridColumn, type ToolDataGridProps, type ToolDataGridRowAction, ToolErrorBoundary, type ToolErrorBoundaryProps, ToolForm, type ToolFormField, type ToolFormProps, ToolInput, type ToolInputProps, type ToolInputSuggestion, ToolProvider, type ToolProviderProps, type ToolResultConfig, ToolSelect, type ToolSelectOption, type ToolSelectProps, type ToolState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseHostContextReturn, type UseMessageReturn, type UseResourceOptions, type UseResourceReturn, type UseToolInputPartialReturn, type UseToolInputReturn, type UseToolOptions, type UseToolResultReturn, type UseToolReturn, type UseToolStreamOptions, type UseToolStreamReturn, badgeVariants, buttonVariants, cn, normalizeToolBinding, useFormField, useGptApp, useGptTool, useHostContext, useMcpApp, useMessage, useResource, useTool, useToolContext, useToolInput, useToolInputPartial, useToolResult, useToolStream, useToolSubscription };
+export { ActionButton, type ActionButtonProps, Alert, AlertDescription, AlertTitle, type AppInfo, type AppOptions, AppProvider, type AppProviderProps, AppShell, type AppShellProps, Badge, Button, type ButtonProps, Card, CardContent, type CardContentProps, CardDescription, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, Chart, type ChartProps, type ChartType, Checkbox, CodeBlock, type CodeBlockProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ConfirmConfig, DEFAULT_RESULT_CONFIG, DataGrid, type DataGridColumn, type DataGridProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GPTAppProvider, type GPTAppProviderProps, type GptAppContextValue, INITIAL_TOOL_STATE, Input, type InputProps, Label, type McpActionProps, type McpAppContextValue, Modal, type ModalProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RequireConnection, type RequireConnectionProps, type ResourceBinding, type ResourceMeta, ResourceView, type ResourceViewProps, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, Slider, StreamingContent, type StreamingContentProps, Switch, TabContent, type TabContentProps, type TabItem, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, type TabsProps, TabsTrigger, Textarea, Toaster, type ToolBinding, ToolButton, type ToolButtonProps, type ToolButtonState, type ToolCallState, type ToolContextValue, ToolDataGrid, type ToolDataGridColumn, type ToolDataGridProps, type ToolDataGridRowAction, ToolErrorBoundary, type ToolErrorBoundaryProps, ToolForm, type ToolFormField, type ToolFormProps, ToolInput, type ToolInputProps, type ToolInputSuggestion, ToolProvider, type ToolProviderProps, type ToolResultConfig, ToolSelect, type ToolSelectOption, type ToolSelectProps, type ToolState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseHostContextReturn, type UseMessageReturn, type UseResourceOptions, type UseResourceReturn, type UseToolInputPartialReturn, type UseToolInputReturn, type UseToolOptions, type UseToolResultReturn, type UseToolReturn, type UseToolStreamOptions, type UseToolStreamReturn, badgeVariants, buttonVariants, cn, normalizeToolBinding, useFormField, useGptApp, useGptTool, useHostContext, useMcpApp, useMessage, useOpenAiGlobal, useResource, useTool, useToolContext, useToolInput$1 as useToolInput, useToolInputPartial, useToolInput as useToolInputSpec, useToolOutput, useToolResponseMetadata, useToolResult, useToolStream, useToolSubscription, useWidgetState };

package/dist/index.d.ts

@@ -124,11 +124,35 @@ declare function useMcpApp(): McpAppContextValue;
 
 /**
  * ChatGPT's window.openai interface
- * Only includes properties that are confirmed to exist in the ChatGPT Apps SDK
+ * Based on: https://developers.openai.com/apps-sdk/build/chatgpt-ui#understand-the-windowopenai-api
  */
 interface OpenAISDK {
+    /** Input arguments for the tool */
+    toolInput?: Record<string, unknown>;
+    /** Structured content returned by the tool */
+    toolOutput?: any;
+    /** Metadata returned by the tool */
+    toolResponseMetadata?: Record<string, unknown>;
+    /** Persisted state for this widget instance */
+    widgetState?: Record<string, unknown>;
     /** Call a server tool */
     callTool: (name: string, args: Record<string, unknown>) => Promise<any>;
+    /** Send a follow-up message to chat */
+    sendFollowUpMessage?: (options: {
+        prompt: string;
+    }) => Promise<void>;
+    /** Upload a file */
+    uploadFile?: (file: File) => Promise<{
+        fileId: string;
+    }>;
+    /** Get download URL for a file */
+    getFileDownloadUrl?: (options: {
+        fileId: string;
+    }) => Promise<{
+        downloadUrl: string;
+    }>;
+    /** Persist widget state */
+    setWidgetState?: (state: Record<string, unknown>) => void;
     /** Current theme */
     theme?: 'light' | 'dark';
     /** Current locale */
@@ -137,6 +161,15 @@ interface OpenAISDK {
     displayMode?: 'inline' | 'modal' | 'fullscreen';
     /** Maximum height for the widget */
     maxHeight?: number;
+    /** Safe area insets */
+    safeArea?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** View type */
+    view?: 'desktop' | 'mobile';
 }
 declare global {
     interface Window {
@@ -1143,7 +1176,7 @@ interface UseToolInputReturn<T = Record<string, unknown>> {
  * }
  * ```
  */
-declare function useToolInput<T = Record<string, unknown>>(): UseToolInputReturn<T>;
+declare function useToolInput$1<T = Record<string, unknown>>(): UseToolInputReturn<T>;
 
 interface UseToolInputPartialReturn {
     /** Partial arguments currently available */
@@ -1216,6 +1249,52 @@ interface UseToolSubscriptionResult<T = unknown> {
  */
 declare function useToolSubscription<T = unknown>(toolName: string, options?: UseToolSubscriptionOptions): UseToolSubscriptionResult<T>;
 
+interface OpenAiGlobals {
+    toolInput: Record<string, unknown>;
+    toolOutput: any;
+    toolResponseMetadata: Record<string, unknown>;
+    widgetState: Record<string, unknown>;
+    theme: 'light' | 'dark';
+    displayMode: 'inline' | 'modal' | 'fullscreen';
+    maxHeight: number;
+    safeArea: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    view: 'desktop' | 'mobile';
+    locale: string;
+}
+/**
+ * React hook to subscribe to window.openai global values.
+ * Source: https://developers.openai.com/apps-sdk/build/chatgpt-ui#useopenaiglobal
+ */
+declare function useOpenAiGlobal<K extends keyof OpenAiGlobals>(key: K): OpenAiGlobals[K] | undefined;
+
+/**
+ * Access the structured content returned by the tool.
+ * Maps to 'structuredContent' in the tool response.
+ */
+declare function useToolOutput<T = any>(): T | undefined;
+/**
+ * Access metadata about the tool response.
+ * Maps to '_meta' in the tool response.
+ */
+declare function useToolResponseMetadata<T = any>(): T | undefined;
+/**
+ * Access the input arguments passed to the tool.
+ */
+declare function useToolInput<T = any>(): T | undefined;
+
+/**
+ * Hook to read and write widget state.
+ * Widget state persists across the session for this specific widget instance.
+ *
+ * @param initialState - Default state if none exists
+ */
+declare function useWidgetState<T extends Record<string, unknown>>(initialState: T | (() => T)): [T, (newState: T | ((prev: T) => T)) => void];
+
 declare function CardTitle({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function CardDescription({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 
@@ -1623,4 +1702,4 @@ interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>
  */
 declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement>>;
 
-export { ActionButton, type ActionButtonProps, Alert, AlertDescription, AlertTitle, type AppInfo, type AppOptions, AppProvider, type AppProviderProps, AppShell, type AppShellProps, Badge, Button, type ButtonProps, Card, CardContent, type CardContentProps, CardDescription, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, Chart, type ChartProps, type ChartType, Checkbox, CodeBlock, type CodeBlockProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ConfirmConfig, DEFAULT_RESULT_CONFIG, DataGrid, type DataGridColumn, type DataGridProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GPTAppProvider, type GPTAppProviderProps, type GptAppContextValue, INITIAL_TOOL_STATE, Input, type InputProps, Label, type McpActionProps, type McpAppContextValue, Modal, type ModalProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RequireConnection, type RequireConnectionProps, type ResourceBinding, type ResourceMeta, ResourceView, type ResourceViewProps, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, Slider, StreamingContent, type StreamingContentProps, Switch, TabContent, type TabContentProps, type TabItem, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, type TabsProps, TabsTrigger, Textarea, Toaster, type ToolBinding, ToolButton, type ToolButtonProps, type ToolButtonState, type ToolCallState, type ToolContextValue, ToolDataGrid, type ToolDataGridColumn, type ToolDataGridProps, type ToolDataGridRowAction, ToolErrorBoundary, type ToolErrorBoundaryProps, ToolForm, type ToolFormField, type ToolFormProps, ToolInput, type ToolInputProps, type ToolInputSuggestion, ToolProvider, type ToolProviderProps, type ToolResultConfig, ToolSelect, type ToolSelectOption, type ToolSelectProps, type ToolState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseHostContextReturn, type UseMessageReturn, type UseResourceOptions, type UseResourceReturn, type UseToolInputPartialReturn, type UseToolInputReturn, type UseToolOptions, type UseToolResultReturn, type UseToolReturn, type UseToolStreamOptions, type UseToolStreamReturn, badgeVariants, buttonVariants, cn, normalizeToolBinding, useFormField, useGptApp, useGptTool, useHostContext, useMcpApp, useMessage, useResource, useTool, useToolContext, useToolInput, useToolInputPartial, useToolResult, useToolStream, useToolSubscription };
+export { ActionButton, type ActionButtonProps, Alert, AlertDescription, AlertTitle, type AppInfo, type AppOptions, AppProvider, type AppProviderProps, AppShell, type AppShellProps, Badge, Button, type ButtonProps, Card, CardContent, type CardContentProps, CardDescription, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, Chart, type ChartProps, type ChartType, Checkbox, CodeBlock, type CodeBlockProps, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ConfirmConfig, DEFAULT_RESULT_CONFIG, DataGrid, type DataGridColumn, type DataGridProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GPTAppProvider, type GPTAppProviderProps, type GptAppContextValue, INITIAL_TOOL_STATE, Input, type InputProps, Label, type McpActionProps, type McpAppContextValue, Modal, type ModalProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RequireConnection, type RequireConnectionProps, type ResourceBinding, type ResourceMeta, ResourceView, type ResourceViewProps, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, Slider, StreamingContent, type StreamingContentProps, Switch, TabContent, type TabContentProps, type TabItem, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, type TabsProps, TabsTrigger, Textarea, Toaster, type ToolBinding, ToolButton, type ToolButtonProps, type ToolButtonState, type ToolCallState, type ToolContextValue, ToolDataGrid, type ToolDataGridColumn, type ToolDataGridProps, type ToolDataGridRowAction, ToolErrorBoundary, type ToolErrorBoundaryProps, ToolForm, type ToolFormField, type ToolFormProps, ToolInput, type ToolInputProps, type ToolInputSuggestion, ToolProvider, type ToolProviderProps, type ToolResultConfig, ToolSelect, type ToolSelectOption, type ToolSelectProps, type ToolState, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseHostContextReturn, type UseMessageReturn, type UseResourceOptions, type UseResourceReturn, type UseToolInputPartialReturn, type UseToolInputReturn, type UseToolOptions, type UseToolResultReturn, type UseToolReturn, type UseToolStreamOptions, type UseToolStreamReturn, badgeVariants, buttonVariants, cn, normalizeToolBinding, useFormField, useGptApp, useGptTool, useHostContext, useMcpApp, useMessage, useOpenAiGlobal, useResource, useTool, useToolContext, useToolInput$1 as useToolInput, useToolInputPartial, useToolInput as useToolInputSpec, useToolOutput, useToolResponseMetadata, useToolResult, useToolStream, useToolSubscription, useWidgetState };

package/dist/index.js

@@ -1689,6 +1689,10 @@ function useResource(uri, options = {}) {
     fetchResource
   ]);
   React26.useEffect(() => {
+    if (intervalRef.current) {
+      clearInterval(intervalRef.current);
+      intervalRef.current = null;
+    }
     if (refreshInterval && refreshInterval > 0 && isConnected && !skip) {
       intervalRef.current = setInterval(() => {
         fetchResource().catch(() => {
@@ -2619,7 +2623,10 @@ function useToolSubscription(toolName, options = {}) {
     setIsPolling(false);
   }, []);
   const start = React26.useCallback(() => {
-    stop();
+    if (intervalRef.current) {
+      clearInterval(intervalRef.current);
+      intervalRef.current = null;
+    }
     setIsPolling(true);
     toolHook.call(args).catch(() => {
     });
@@ -2630,8 +2637,7 @@ function useToolSubscription(toolName, options = {}) {
   }, [
     toolHook.call,
     args,
-    interval,
-    stop
+    interval
   ]);
   const refresh = React26.useCallback(async () => {
     return toolHook.call(args);
@@ -2660,6 +2666,59 @@ function useToolSubscription(toolName, options = {}) {
   };
 }
 chunk2HRO6CFU_js.__name(useToolSubscription, "useToolSubscription");
+var SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
+function useOpenAiGlobal(key) {
+  return React26.useSyncExternalStore((onChange) => {
+    const handleSetGlobal = /* @__PURE__ */ chunk2HRO6CFU_js.__name((event) => {
+      const customEvent = event;
+      const value = customEvent.detail?.globals?.[key];
+      if (value !== void 0) {
+        onChange();
+      }
+    }, "handleSetGlobal");
+    window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {
+      passive: true
+    });
+    return () => {
+      window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);
+    };
+  }, () => window.openai?.[key]);
+}
+chunk2HRO6CFU_js.__name(useOpenAiGlobal, "useOpenAiGlobal");
+
+// src/mcp/useToolData.ts
+function useToolOutput() {
+  return useOpenAiGlobal("toolOutput");
+}
+chunk2HRO6CFU_js.__name(useToolOutput, "useToolOutput");
+function useToolResponseMetadata() {
+  return useOpenAiGlobal("toolResponseMetadata");
+}
+chunk2HRO6CFU_js.__name(useToolResponseMetadata, "useToolResponseMetadata");
+function useToolInput2() {
+  return useOpenAiGlobal("toolInput");
+}
+chunk2HRO6CFU_js.__name(useToolInput2, "useToolInput");
+function useWidgetState(initialState) {
+  const rawState = useOpenAiGlobal("widgetState");
+  const resolvedInitial = rawState ?? (typeof initialState === "function" ? initialState() : initialState);
+  const setWidgetState = React26.useCallback((newStateOrUpdater) => {
+    if (!window.openai?.setWidgetState) {
+      console.warn("window.openai.setWidgetState is not available");
+      return;
+    }
+    const current = window.openai.widgetState ?? resolvedInitial;
+    const next = typeof newStateOrUpdater === "function" ? newStateOrUpdater(current) : newStateOrUpdater;
+    window.openai.setWidgetState(next);
+  }, [
+    resolvedInitial
+  ]);
+  return [
+    resolvedInitial,
+    setWidgetState
+  ];
+}
+chunk2HRO6CFU_js.__name(useWidgetState, "useWidgetState");
 
 // src/types/mcp-types.ts
 function normalizeToolBinding(tool) {
@@ -3599,13 +3658,18 @@ exports.useGptTool = useGptTool;
 exports.useHostContext = useHostContext;
 exports.useMcpApp = useMcpApp;
 exports.useMessage = useMessage;
+exports.useOpenAiGlobal = useOpenAiGlobal;
 exports.useResource = useResource;
 exports.useTool = useTool;
 exports.useToolContext = useToolContext;
 exports.useToolInput = useToolInput;
 exports.useToolInputPartial = useToolInputPartial;
+exports.useToolInputSpec = useToolInput2;
+exports.useToolOutput = useToolOutput;
+exports.useToolResponseMetadata = useToolResponseMetadata;
 exports.useToolResult = useToolResult;
 exports.useToolStream = useToolStream;
 exports.useToolSubscription = useToolSubscription;
+exports.useWidgetState = useWidgetState;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map