@leanmcp/ui 0.3.1 → 0.3.3

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <img
-    src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.svg"
+    src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.png"
     alt="LeanMCP Logo"
     width="400"
   />
@@ -93,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
@@ -198,6 +210,34 @@ export class SlackService {
 }
 ```
 
+### 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:

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,120 @@ interface UseToolSubscriptionResult<T = unknown> {
  */
 declare function useToolSubscription<T = unknown>(toolName: string, options?: UseToolSubscriptionOptions): UseToolSubscriptionResult<T>;
 
+/**
+ * useAuth - Authentication hook for GPT Apps
+ *
+ * Provides auth status and triggers ChatGPT's OAuth linking UI
+ * when tools return _meta["mcp/www_authenticate"].
+ */
+/**
+ * Authenticated user info
+ */
+interface AuthUser {
+    /** User ID (subject) */
+    id: string;
+    /** Display name */
+    name?: string;
+    /** Email address */
+    email?: string;
+    /** Profile picture URL */
+    picture?: string;
+}
+/**
+ * Return type for useAuth hook
+ */
+interface UseAuthReturn {
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** Currently authenticated user (if any) */
+    user: AuthUser | null;
+    /** Loading state */
+    loading: boolean;
+    /** Authentication error (if any) */
+    error: Error | null;
+    /** Trigger an auth-required tool to initiate OAuth flow */
+    triggerAuth: () => Promise<void>;
+    /** Clear auth state (for sign-out UI) */
+    clearAuth: () => void;
+}
+/**
+ * Authentication hook for GPT Apps
+ *
+ * In ChatGPT, authentication is triggered automatically when a tool
+ * returns `_meta["mcp/www_authenticate"]`. Use this hook to:
+ *
+ * 1. Check if the user is authenticated
+ * 2. Show loading state during auth
+ * 3. Display user info after auth
+ * 4. Manually trigger auth by calling an auth-required tool
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isAuthenticated, user, triggerAuth, loading } = useAuth();
+ *
+ *   if (loading) return <div>Authenticating...</div>;
+ *
+ *   if (!isAuthenticated) {
+ *     return (
+ *       <Button onClick={triggerAuth}>
+ *         Sign in with GitHub
+ *       </Button>
+ *     );
+ *   }
+ *
+ *   return <div>Welcome, {user?.name}!</div>;
+ * }
+ * ```
+ */
+declare function useAuth(): UseAuthReturn;
+
+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 +1770,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, type AuthUser, 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 UseAuthReturn, 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, useAuth, 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,120 @@ interface UseToolSubscriptionResult<T = unknown> {
  */
 declare function useToolSubscription<T = unknown>(toolName: string, options?: UseToolSubscriptionOptions): UseToolSubscriptionResult<T>;
 
+/**
+ * useAuth - Authentication hook for GPT Apps
+ *
+ * Provides auth status and triggers ChatGPT's OAuth linking UI
+ * when tools return _meta["mcp/www_authenticate"].
+ */
+/**
+ * Authenticated user info
+ */
+interface AuthUser {
+    /** User ID (subject) */
+    id: string;
+    /** Display name */
+    name?: string;
+    /** Email address */
+    email?: string;
+    /** Profile picture URL */
+    picture?: string;
+}
+/**
+ * Return type for useAuth hook
+ */
+interface UseAuthReturn {
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** Currently authenticated user (if any) */
+    user: AuthUser | null;
+    /** Loading state */
+    loading: boolean;
+    /** Authentication error (if any) */
+    error: Error | null;
+    /** Trigger an auth-required tool to initiate OAuth flow */
+    triggerAuth: () => Promise<void>;
+    /** Clear auth state (for sign-out UI) */
+    clearAuth: () => void;
+}
+/**
+ * Authentication hook for GPT Apps
+ *
+ * In ChatGPT, authentication is triggered automatically when a tool
+ * returns `_meta["mcp/www_authenticate"]`. Use this hook to:
+ *
+ * 1. Check if the user is authenticated
+ * 2. Show loading state during auth
+ * 3. Display user info after auth
+ * 4. Manually trigger auth by calling an auth-required tool
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isAuthenticated, user, triggerAuth, loading } = useAuth();
+ *
+ *   if (loading) return <div>Authenticating...</div>;
+ *
+ *   if (!isAuthenticated) {
+ *     return (
+ *       <Button onClick={triggerAuth}>
+ *         Sign in with GitHub
+ *       </Button>
+ *     );
+ *   }
+ *
+ *   return <div>Welcome, {user?.name}!</div>;
+ * }
+ * ```
+ */
+declare function useAuth(): UseAuthReturn;
+
+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 +1770,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, type AuthUser, 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 UseAuthReturn, 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, useAuth, 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

@@ -2666,6 +2666,134 @@ function useToolSubscription(toolName, options = {}) {
   };
 }
 chunk2HRO6CFU_js.__name(useToolSubscription, "useToolSubscription");
+function useAuth() {
+  const { callTool, isConnected } = useGptApp();
+  const [isAuthenticated, setIsAuthenticated] = React26.useState(false);
+  const [user, setUser] = React26.useState(null);
+  const [loading, setLoading] = React26.useState(false);
+  const [error, setError] = React26.useState(null);
+  const checkAuthStatus = React26.useCallback(async () => {
+    if (!isConnected) return;
+    try {
+      const result = await callTool("getAuthStatus", {});
+      if (result && result.user) {
+        setIsAuthenticated(true);
+        setUser(result.user);
+      } else {
+        setIsAuthenticated(false);
+        setUser(null);
+      }
+    } catch (err) {
+      setIsAuthenticated(false);
+      setUser(null);
+    }
+  }, [
+    callTool,
+    isConnected
+  ]);
+  const triggerAuth = React26.useCallback(async () => {
+    if (!isConnected) {
+      setError(new Error("Not connected to ChatGPT"));
+      return;
+    }
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await callTool("checkAuth", {});
+      if (result && result.user) {
+        setIsAuthenticated(true);
+        setUser(result.user);
+      } else if (result && result.success) {
+        setIsAuthenticated(true);
+        await checkAuthStatus();
+      }
+    } catch (err) {
+      setError(err);
+    } finally {
+      setLoading(false);
+    }
+  }, [
+    callTool,
+    isConnected,
+    checkAuthStatus
+  ]);
+  const clearAuth = React26.useCallback(() => {
+    setIsAuthenticated(false);
+    setUser(null);
+    setError(null);
+  }, []);
+  React26.useEffect(() => {
+    if (isConnected) {
+      checkAuthStatus().catch(() => {
+      });
+    }
+  }, [
+    isConnected,
+    checkAuthStatus
+  ]);
+  return {
+    isAuthenticated,
+    user,
+    loading,
+    error,
+    triggerAuth,
+    clearAuth
+  };
+}
+chunk2HRO6CFU_js.__name(useAuth, "useAuth");
+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,19 +3727,25 @@ exports.badgeVariants = badgeVariants;
 exports.buttonVariants = buttonVariants;
 exports.cn = cn;
 exports.normalizeToolBinding = normalizeToolBinding;
+exports.useAuth = useAuth;
 exports.useFormField = useFormField;
 exports.useGptApp = useGptApp;
 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