@axiom-lattice/react-sdk 2.1.104 → 2.1.106

package/dist/index.d.mts

@@ -4,11 +4,11 @@ export * from '@axiom-lattice/protocols';
 import * as React$1 from 'react';
 import React__default, { ReactNode, Component } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { SlotConfigType } from '@ant-design/x/es/sender/interface';
 import { Client, Assistant, CreateAssistantOptions, UpdateAssistantOptions } from '@axiom-lattice/client-sdk';
 import { Prompts } from '@ant-design/x';
 import { GetProp, ThemeConfig } from 'antd';
 export { ThemeConfig } from 'antd';
-import { SlotConfigType } from '@ant-design/x/es/sender/interface';
 import { NodeProps, Node } from '@xyflow/react';
 
 /**
@@ -490,1649 +490,1696 @@ declare function useAgentGraph(assistantId: string): {
 declare function useApi(options?: UseApiOptions): UseApiReturn;
 
 /**
- * Fetches and manages evaluation projects.
- *
- * @returns Project list, loading state, error, and CRUD operations
- *
- * @example
- * ```tsx
- * const { projects, loading, create, update, remove, refresh } = useEvalProjects();
- *
- * await create({ name: "My Project" });
- * ```
- */
-declare function useEvalProjects(): {
-    projects: unknown[];
-    loading: boolean;
-    error: Error | null;
-    create: (data: Record<string, unknown>) => Promise<unknown>;
-    update: (id: string, patch: Record<string, unknown>) => Promise<void>;
-    remove: (id: string) => Promise<void>;
-    refresh: () => Promise<void>;
-};
-
-/**
- * Fetches and manages evaluation suites within a project.
- *
- * @param projectId - The project ID to fetch suites for
- * @returns Suite list, loading state, error, and CRUD operations
- *
- * @example
- * ```tsx
- * const { suites, loading, create, remove } = useEvalSuites("proj-123");
- *
- * await create("proj-123", { name: "Accuracy Suite" });
- * ```
+ * Quick prompt item for quick prompt components
  */
-declare function useEvalSuites(projectId: string): {
-    suites: unknown[];
-    loading: boolean;
-    error: Error | null;
-    create: (pid: string, data: Record<string, unknown>) => Promise<unknown>;
-    update: (pid: string, id: string, patch: Record<string, unknown>) => Promise<void>;
-    remove: (pid: string, id: string) => Promise<void>;
-    refresh: () => Promise<void>;
-};
-
+interface QuickPromptItem {
+    key: string;
+    icon?: ReactNode;
+    label: string;
+    description?: string;
+    content: SlotConfigType[];
+}
 /**
- * Fetches and manages evaluation cases within a suite.
- *
- * @param projectId - The project ID the suite belongs to
- * @param suiteId - The suite ID to fetch cases for
- * @returns Case list, loading state, error, and CRUD operations
- *
- * @example
- * ```tsx
- * const { cases, loading, create } = useEvalCases("proj-123", "suite-456");
- *
- * await create("proj-123", "suite-456", { question: "What is 2+2?", answer: "4" });
- * ```
+ * Quick prompt category for organizing prompt items
  */
-declare function useEvalCases(projectId: string, suiteId: string): {
-    cases: unknown[];
-    loading: boolean;
-    error: Error | null;
-    create: (pid: string, sid: string, data: Record<string, unknown>) => Promise<unknown>;
-    update: (pid: string, sid: string, id: string, patch: Record<string, unknown>) => Promise<void>;
-    remove: (pid: string, sid: string, id: string) => Promise<void>;
-    refresh: () => Promise<void>;
-};
-
+interface QuickPromptCategory {
+    key: string;
+    title: string;
+    icon?: ReactNode;
+    color?: string;
+    items: QuickPromptItem[];
+}
 /**
- * Fetches and manages evaluation runs, optionally scoped to a project.
- *
- * @param projectId - Optional project ID to filter runs by project
- * @returns Run list, loading state, error, and operations (start, abort, remove)
- *
- * @example
- * ```tsx
- * const { runs, loading, start, abort } = useEvalRuns("proj-123");
- *
- * const result = await start("proj-123");
- * ```
+ * Middleware tool definition
  */
-declare function useEvalRuns(projectId?: string): {
-    runs: unknown[];
-    loading: boolean;
-    error: Error | null;
-    start: (pid: string) => Promise<{
-        run_id: string;
-    }>;
-    abort: (runId: string) => Promise<void>;
-    remove: (runId: string) => Promise<void>;
-    refresh: () => Promise<void>;
-};
-
+interface MiddlewareToolDefinition {
+    id: string;
+    name: string;
+    description: string;
+}
 /**
- * Streams real-time progress of an evaluation run via SSE.
- *
- * @param runId - The evaluation run ID to stream, or `null` to disable streaming
- * @returns Status, progress counters, connection state, and a stop function
- *
- * @example
- * ```tsx
- * const { status, progress, connected, stopStreaming } = useEvalRunStream("run-789");
- * // progress: { completed: 5, total: 10, passed: 4, failed: 1 }
- * ```
+ * JSON Schema property definition for middleware config
  */
-declare function useEvalRunStream(runId: string | null): {
-    status: string;
-    progress: {
-        completed: number;
-        total: number;
-        passed: number;
-        failed: number;
+interface MiddlewareConfigSchemaProperty {
+    type: "string" | "number" | "integer" | "boolean" | "object" | "array";
+    title?: string;
+    description?: string;
+    default?: any;
+    enum?: string[];
+    enumLabels?: Record<string, string>;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    widget?: "input" | "textarea" | "select" | "segmented" | "switch" | "numberInput" | "skillSelect" | "databaseSelect" | "metricsSelect" | "topologyEdgeBuilder" | "collectionSelect" | "connectionSelect";
+    items?: {
+        type: string;
     };
-    connected: boolean;
-    stopStreaming: () => void;
-};
-
+}
 /**
- * Provider component for the Axiom Lattice client
- * @param props - Provider props
- * @returns Provider component
+ * JSON Schema for middleware configuration
  */
-declare function AxiomLatticeProvider({ config, onUnauthorized, children, }: AxiomLatticeProviderProps): react_jsx_runtime.JSX.Element;
-interface UseAxiomLatticeOptions {
-    assistantId?: string | null;
+interface MiddlewareConfigSchema {
+    type: "object";
+    title?: string;
+    description?: string;
+    required?: string[];
+    properties: Record<string, MiddlewareConfigSchemaProperty>;
 }
 /**
- * Hook to get a client for a specific assistant
- * @param assistantId - The assistant ID
- * @returns Client instance for the assistant
- * @throws Error if used outside of AxiomLatticeProvider
+ * Middleware type definition
  */
-declare function useClient(assistantId: string): Client;
+interface MiddlewareTypeDefinition {
+    type: string;
+    name: string;
+    description: string;
+    icon?: ReactNode;
+    schema?: MiddlewareConfigSchema;
+    defaultConfig?: Record<string, any>;
+    tools?: MiddlewareToolDefinition[];
+    connectionSchema?: {
+        fields: Record<string, unknown>;
+        hasTest?: boolean;
+        hasDiscover?: boolean;
+        resourceLabel?: string;
+    };
+}
 /**
- * Hook to access the Axiom Lattice client
- * @returns The Axiom Lattice client
- * @throws Error if used outside of AxiomLatticeProvider
- * @deprecated Use useClient(assistantId) instead
+ * Middleware type for configuration
  */
-declare function useAxiomLattice({ assistantId, }?: UseAxiomLatticeOptions): Client;
-
+interface MiddlewareConfigDefinition {
+    id: string;
+    type: string;
+    name: string;
+    description: string;
+    enabled: boolean;
+    config: Record<string, any>;
+    /** 可选：限制该中间件暴露的工具列表。不配置则默认暴露所有工具 */
+    allowedTools?: string[];
+    tools?: MiddlewareToolDefinition[];
+}
 /**
- * Context value for AgentThreadContext
+ * Sidebar menu item type
  */
-interface AgentThreadContextValue<T extends UseChatOptions> {
-    state: ChatStateWithAgent;
-    sendMessage: (data: {
-        input?: {
-            message: string;
-            files?: {
-                name: string;
-                id: string;
-            }[];
-        };
-        command?: {
-            resume?: {
-                action: string;
-                data: Record<string, any> & {
-                    config?: {
-                        thread_id?: string;
-                        work_log_id?: string;
-                    };
-                };
-                message: string;
-            };
-            update?: any;
-            send?: {
-                node: string;
-                input: any;
-            };
-        };
-        streaming?: boolean;
-        mode?: 'collect' | 'followup' | 'steer';
-    }) => Promise<void>;
-    stopStreaming: () => void;
-    resumeStream: (messageId?: string) => () => void;
-    loadMessages: (limit?: number) => Promise<void>;
-    clearMessages: () => void;
-    clearError: () => void;
-    customRunConfig: Record<string, any>;
-    updateCustomRunConfig: (config: Record<string, any>) => void;
-    removePendingMessage: (messageId: string) => Promise<boolean>;
-    abortAgent: () => Promise<void>;
+type SideMenuItemType = "drawer" | "route" | "action";
+interface ResourceFolderConfig {
+    name: string;
+    displayName?: string;
+    allowUpload: boolean;
 }
 /**
- * Props for AgentThreadProvider
+ * Sidebar menu item configuration
  */
-interface AgentThreadProviderProps<T extends UseChatOptions> {
-    threadId: string | null;
-    assistantId?: string;
-    options?: T;
-    children: ReactNode;
-    onToolCompleted?: (toolName: string) => void;
-    onStreamCompleted?: () => void;
-}
 /**
- * Provider component for AgentThreadContext.
- * Manages all agent thread state and operations including message streaming, interrupts,
- * queue management, and agent state polling.
- *
- * @param props - {@link AgentThreadProviderProps}
- * @param props.threadId - The ID of the thread to manage. If `null`, the provider renders nothing.
- * @param props.assistantId - The assistant ID to associate with this thread. Falls back to the client's assistant ID if omitted.
- * @param props.options - Configuration options for chat behavior (streaming, resume stream polling, initial messages, etc.).
- * @param props.children - React children to render within the thread context.
- * @param props.onToolCompleted - Callback invoked each time a tool call completes, receiving the tool name.
- * @param props.onStreamCompleted - Callback invoked when the SSE stream completes for any message.
- *
- * @returns A React context provider wrapping children with {@link AgentThreadContext.Provider}, or `null` if no `threadId` is provided.
- */
-declare function AgentThreadProvider<T extends UseChatOptions>({ threadId, assistantId, options, children, onToolCompleted, onStreamCompleted, }: AgentThreadProviderProps<T>): react_jsx_runtime.JSX.Element | null;
-/**
- * Hook to access AgentThreadContext.
- *
- * @param T - The {@link UseChatOptions} type parameter, allowing typed access to options.
- * @returns Agent thread context value of type {@link AgentThreadContextValue}.
- * @throws {Error} If used outside of an {@link AgentThreadProvider}.
+ * Sidebar menu item configuration.
  *
- * @example
- * ```tsx
- * const { state, sendMessage, stopStreaming, abortAgent } = useAgentThreadContext();
+ * Three item types:
+ * - `"action"` — clickable button, set `builtin` for predefined behaviors
+ * - `"drawer"` — opens a slide-out panel, set `content` + `title`
+ * - `"route"` — opens a GenUI-registered component in the SideApp area
  *
- * await sendMessage({ input: { message: 'Hello!' } });
+ * When providing `sideMenuItems` or `workspaceMenuItems` to `LatticeChatShellConfig`,
+ * your array **completely replaces** the defaults. Import `DEFAULT_MENU_ITEMS` or
+ * `DEFAULT_WORKSPACE_MENU_ITEMS` to selectively include built-in items:
  * ```
- */
-declare function useAgentThreadContext<T extends UseChatOptions>(): AgentThreadContextValue<T>;
-
-interface UserTenantInfo {
-    tenantId: string;
-    role: string;
-    tenant?: Tenant;
-}
-interface PersonalAssistantInfo {
-    assistantId: string;
-    projectId: string;
-    workspaceId: string;
-    /** tenantId for debugging cross-tenant leakage */
-    tenantId?: string | null;
-}
-interface AuthContextValue {
-    user: User | null;
-    tenants: UserTenantInfo[];
-    currentTenant: Tenant | null;
-    personalAssistant: PersonalAssistantInfo | null;
-    setPersonalAssistant: (info: PersonalAssistantInfo | null) => void;
-    isAuthenticated: boolean;
-    isLoading: boolean;
-    error: string | null;
-    login: (email: string, password: string) => Promise<{
-        requiresTenantSelection: boolean;
-        hasTenants: boolean;
-    }>;
-    register: (email: string, password: string, name: string) => Promise<{
-        message: string;
-        token?: string;
-    }>;
-    logout: () => void;
-    selectTenant: (tenantId: string) => Promise<void>;
-    fetchUserTenants: () => Promise<void>;
-    refreshUser: () => Promise<void>;
-    clearError: () => void;
-    changePassword: (currentPassword: string, newPassword: string) => Promise<void>;
-}
-/**
- * Hook to access authentication context. Must be used within an {@link AuthProvider}.
- *
- * @description
- * Provides the full auth state and all auth operations (login, register, logout, tenant selection, etc.).
- * Throws an error if no {@link AuthProvider} is found in the component tree. For optional auth,
- * use {@link useAuthOptional} instead.
- *
- * @returns The current {@link AuthContextValue} containing user, tenants, auth state, and auth actions.
- *
- * @throws {Error} If used outside of an {@link AuthProvider}.
- *
- * @example
- * ```tsx
- * const { user, isAuthenticated, login, logout } = useAuth();
- *
- * const handleLogin = async () => {
- *   const result = await login('user@example.com', 'password');
- *   if (result.requiresTenantSelection) {
- *     // Show tenant picker
- *   }
- * };
+ * sideMenuItems: DEFAULT_MENU_ITEMS.filter(i => i.id === "thread-history")
  * ```
  */
-declare const useAuth: () => AuthContextValue;
-/**
- * Optional version of useAuth that returns null instead of throwing when AuthProvider is not present.
- * Use this when authentication is optional for the component.
- *
- * @example
- * // For required auth - throws if no provider
- * const { user } = useAuth();
- *
- * // For optional auth - returns null if no provider
- * const user = useAuthOptional()?.user;
- */
-declare const useAuthOptional: () => AuthContextValue | null;
-/**
- * Props for {@link AuthProvider}.
- */
-interface AuthProviderProps {
-    /** Child components that will have access to the auth context. */
-    children: ReactNode;
-    /** Base URL of the gateway API (e.g., `http://localhost:3000`). */
-    baseURL: string;
-    /** Called after a successful login with the user and their tenant memberships. */
-    onLoginSuccess?: (user: User, tenants: UserTenantInfo[]) => void;
-    /** Called after a tenant is successfully selected, passing the selected tenant. */
-    onTenantSelected?: (tenant: Tenant) => void;
-    /** Called after the user logs out. */
-    onLogout?: () => void;
+interface SideMenuItemConfig {
+    /** Unique identifier for the menu item */
+    id: string;
+    /** Type of the menu item - drawer or route (SideApp) */
+    type: SideMenuItemType;
+    /** Display name of the menu item */
+    name: string;
+    /** Icon component for the menu item */
+    icon?: ReactNode;
+    /** Order for sorting menu items (lower values first) */
+    order?: number;
+    /** Whether this is a builtin menu item (new-analysis, thread-history, assistants, skill, skills, tools, workspace, settings, database, metrics, mcp, projects, logout, switch-tenant) */
+    builtin?: "new-analysis" | "thread-history" | "assistants" | "skill" | "skills" | "tools" | "workspace" | "settings" | "database" | "metrics" | "mcp" | "projects" | "logout" | "switch-tenant" | "connections";
+    /**
+     * Menu group for organizing items
+     */
+    group?: string;
+    /**
+     * Whether the menu item is enabled (can be toggled)
+     * Defaults to true
+     */
+    enabled?: boolean;
+    /** Content config from DB (for custom menu items) */
+    contentConfig?: Record<string, unknown>;
+    /** Content to display inside the drawer (for drawer type) */
+    content?: ReactNode;
+    /** Drawer title (for drawer type) */
+    title?: string;
+    /** Drawer width in pixels or percentage (for drawer type) */
+    width?: string | number;
+    /**
+     * Whether to display drawer content inline in expanded sidebar mode
+     * When true, content shows below the menu item instead of in a drawer
+     * Defaults to false, but true for "workspace" builtin
+     */
+    inline?: boolean;
+    /**
+     * Maximum height for inline drawer content in pixels
+     * Only applies when inline is true
+     * Defaults to 400
+     */
+    inlineMaxHeight?: number;
+    /**
+     * Whether inline drawer is expanded by default
+     * Only applies when inline is true
+     * Defaults to false
+     */
+    inlineDefaultExpanded?: boolean;
+    /** Component to render in SideApp (for route type) */
+    sideAppComponent?: ReactNode;
 }
 /**
- * Authentication context provider. Wraps the application to provide auth state and operations
- * to all descendant components via {@link useAuth} and {@link useAuthOptional}.
- *
- * @description
- * Manages the full authentication lifecycle including:
- * - **Login / Register**: Sends credentials to the gateway API and stores the returned user, tenants, and token in `sessionStorage`.
- * - **Session restoration**: On mount, reads previously stored user data from `sessionStorage` and also refreshes the tenant list to catch any admin-side role assignments.
- * - **Tenant selection**: Calls the gateway API to select a tenant and stores the tenant data.
- * - **Logout**: Clears all auth state and `sessionStorage`.
- * - **Change password**: Proxies to the gateway password change endpoint.
- * - **Token expiration**: Automatically logs out when the gateway returns a 401 with an expired token message.
- *
- * @param props - {@link AuthProviderProps}
- * @param props.children - React children to render within the auth context.
- * @param props.baseURL - Base URL of the gateway API.
- * @param props.onLoginSuccess - Optional callback invoked after a successful login.
- * @param props.onTenantSelected - Optional callback invoked after tenant selection.
- * @param props.onLogout - Optional callback invoked on logout.
- *
- * @returns A React context provider wrapping children with {@link AuthContext.Provider}.
- *
- * @example
- * ```tsx
- * <AuthProvider
- *   baseURL="http://localhost:3000"
- *   onLoginSuccess={(user) => console.log('Logged in:', user.email)}
- *   onLogout={() => window.location.reload()}
- * >
- *   <App />
- * </AuthProvider>
- * ```
- */
-declare const AuthProvider: React__default.FC<AuthProviderProps>;
-
-/**
- * Login Form Components
- * Uses base styles from design system
+ * Lattice Chat Shell configuration interface
  */
-
-interface LoginFormProps {
-    onSuccess?: () => void;
-    onCancel?: () => void;
-    logo?: React__default.ReactNode;
-    title?: string;
-    subtitle?: string;
-    footer?: React__default.ReactNode;
-    className?: string;
-}
-declare const LoginForm: React__default.FC<LoginFormProps>;
-declare const LoginPage: React__default.FC<any>;
-interface RegisterFormProps {
-    onSuccess?: () => void;
-    onCancel?: () => void;
-    logo?: React__default.ReactNode;
-    title?: string;
-    subtitle?: string;
-    footer?: React__default.ReactNode;
-    className?: string;
+interface LatticeChatShellConfig {
+    /**
+     * Base URL for the API
+     */
+    baseURL: string;
+    /**
+     * API key for authentication (optional)
+     */
+    apiKey?: string;
+    /**
+     * Transport method (Server-Sent Events or WebSocket)
+     */
+    transport?: "sse" | "ws";
+    /**
+     * Request timeout in milliseconds (optional)
+     */
+    timeout?: number;
+    /**
+     * Additional headers to include in requests (optional)
+     */
+    headers?: Record<string, string>;
+    /**
+     * Whether users can create new threads from the UI
+     * Defaults to true
+     */
+    enableThreadCreation?: boolean;
+    /**
+     * Whether users can view the thread list in the sidebar
+     * Defaults to true
+     */
+    enableThreadList?: boolean;
+    assistantId?: string;
+    showSideMenu?: boolean;
+    /**
+     * URL of the global shared sandbox, this is used to access the global shared sandbox
+     * if not provided, sandbox will be created in the agent's sandbox
+      */
+    globalSharedSandboxURL?: string;
+    /**
+      * Available middleware types that can be configured for agents
+      * Each middleware type defines its name, description, and default configuration
+      * If not provided, default middleware types will be used
+      */
+    availableMiddlewareTypes?: MiddlewareTypeDefinition[];
+    /**
+     * Whether users can create new assistants
+     * Defaults to true
+     */
+    enableAssistantCreation?: boolean;
+    /**
+      * Whether users can edit existing assistants
+      * Defaults to true
+      */
+    enableAssistantEditing?: boolean;
+    /**
+     * Whether to enable workspace and project management
+     * When enabled, shows workspace selector in header and file browser
+     * Defaults to false
+     */
+    enableWorkspace?: boolean;
+    /**
+     * Whether to load custom menu items from the database (API /api/menu-items).
+     * When enabled, WorkspaceResourceManager fetches per-tenant custom menu items
+     * and merges them with built-in defaults.
+     * Defaults to true.
+     */
+    enableCustomMenu?: boolean;
+    /**
+     * Resource folders configuration for workspace
+     * Each folder represents a section in the workspace assets panel
+     * If not provided, defaults to a single root folder with upload enabled
+     */
+    resourceFolders?: ResourceFolderConfig[];
+    /**
+       * Chat sidebar menu items. When provided, completely replaces the
+       * default built-in items (New Analysis, History).
+       *
+       * To selectively include built-in items, import and filter `DEFAULT_MENU_ITEMS`:
+       * ```
+       * sideMenuItems: DEFAULT_MENU_ITEMS.filter(i => i.id === "thread-history")
+       * ```
+       * Omit this field to use all defaults.
+       */
+    sideMenuItems?: SideMenuItemConfig[];
+    /**
+     * Workspace menu items. When provided, completely replaces the
+     * default workspace items (Projects, Metrics, Database, etc.).
+     *
+     * To selectively include built-in items, import and filter `DEFAULT_WORKSPACE_MENU_ITEMS`:
+     * ```
+     * workspaceMenuItems: DEFAULT_WORKSPACE_MENU_ITEMS.filter(
+     *   i => ["workspace_projects", "assistants"].includes(i.id)
+     * )
+     * ```
+     * Omit this field to use all defaults.
+     */
+    workspaceMenuItems?: SideMenuItemConfig[];
+    /**
+       * Whether to enable the database picker slot in the chat sender
+     * When enabled, shows a database selection button in the sender footer
+     * Defaults to true
+     */
+    enableDatabaseSlot?: boolean;
+    /**
+     * Whether to enable the skill picker slot in the chat sender
+     * When enabled, shows a skill selection button in the sender footer
+     * Defaults to true
+     */
+    enableSkillSlot?: boolean;
+    /**
+     * Whether to enable the agent picker slot in the chat sender
+     * When enabled, shows an agent selection button in the sender footer
+     * Defaults to true
+     */
+    enableAgentSlot?: boolean;
+    /**
+     * Whether to enable the metrics datasource picker slot in the chat sender
+     * When enabled, shows a metrics datasource selection button in the sender footer
+     * Defaults to true
+     */
+    enableMetricsDataSourceSlot?: boolean;
+    /**
+     * Whether to enable the model selector in the chat sender
+     * When enabled, shows a model selection dropdown in the sender footer
+     * Defaults to false
+     */
+    enableModelSelector?: boolean;
+    /**
+     * Sidebar display mode
+    * - "icon": Show only icons (default)
+    * - "expanded": Show icons with labels and groups
+    * Defaults to "icon"
+    */
+    sidebarMode?: "icon" | "expanded";
+    /**
+     * Whether sidebar is expanded by default (only applies when sidebarMode is "expanded")
+     * Defaults to true
+     */
+    sidebarDefaultExpanded?: boolean;
+    /**
+     * Whether workspace menu is expanded by default
+     * Defaults to true
+     */
+    workspaceMenuDefaultExpanded?: boolean;
+    /**
+     * Whether to show the expand/collapse toggle button
+     * Defaults to true
+     */
+    sidebarShowToggle?: boolean;
+    /**
+      * Whether to show the "New Analysis" button in expanded sidebar
+      * Defaults to true
+      */
+    sidebarShowNewAnalysis?: boolean;
+    /**
+     * Endpoint for fetching middleware type definitions from API.
+     * Falls back to DEFAULT_MIDDLEWARE_TYPES on failure.
+     */
+    middlewareTypesEndpoint?: string;
+    /**
+     * Logo text displayed in expanded sidebar
+     * Defaults to "Lattice"
+     */
+    sidebarLogoText?: string;
+    /**
+     * Custom logo icon component
+     * If not provided, defaults to Cpu icon
+     */
+    sidebarLogoIcon?: React__default.ReactNode;
+    /**
+     * Custom quick prompts data for quick prompt components
+     * Allows registering custom prompt categories and items via shell config
+     * If not provided, default prompt data will be used
+     */
+    quickPromptsData?: QuickPromptCategory[];
 }
-declare const RegisterForm: React__default.FC<RegisterFormProps>;
-
 /**
- * User Profile Components
- * Using Axiom Theme with Ant Design
+ * Lattice Chat Shell context value interface
  */
-
-interface UserProfileProps {
-    /** Called when user clicks logout */
-    onLogout?: () => void;
-    /** Show tenant information */
-    showTenantSwitcher?: boolean;
-    /** Custom class name */
-    className?: string;
+interface LatticeChatShellContextValue {
+    /**
+     * Current configuration
+     */
+    config: LatticeChatShellConfig;
+    /**
+     * Update the entire configuration
+     */
+    updateConfig: (config: Partial<LatticeChatShellConfig>) => void;
+    /**
+     * Update a specific configuration value
+     */
+    updateConfigValue: <K extends keyof LatticeChatShellConfig>(key: K, value: LatticeChatShellConfig[K]) => void;
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig: () => void;
+    /**
+     * Whether the settings modal is open
+     */
+    settingsModalOpen: boolean;
+    /**
+     * Set the settings modal open state
+     */
+    setSettingsModalOpen: (open: boolean) => void;
 }
 /**
- * User Profile Component
+ * Default middleware type definitions with JSON Schema for configuration
  */
-declare const UserProfile: React__default.FC<UserProfileProps>;
-interface ProtectedRouteProps {
-    children: React__default.ReactNode;
-    /** Component to show when not authenticated */
-    fallback?: React__default.ReactNode;
-    /** Redirect URL (if using react-router) */
-    redirectTo?: string;
-}
+declare const DEFAULT_MIDDLEWARE_TYPES: MiddlewareTypeDefinition[];
 /**
- * Protected Route Component
- * Shows loading state, redirects, or fallback when not authenticated
+ * Lattice Chat Shell context
  */
-declare const ProtectedRoute: React__default.FC<ProtectedRouteProps>;
-
+declare const LatticeChatShellContext: React__default.Context<LatticeChatShellContextValue>;
 /**
- * Tenant Selector Components
- * Uses unified auth styles from design system
+ * Props for LatticeChatShellContextProvider
  */
-
-interface TenantSelectorProps {
-    tenants: Tenant[];
-    currentTenantId?: string | null;
-    onSelect: (tenant: Tenant) => void;
-    onLogout?: () => void;
-    isLoading?: boolean;
-    className?: string;
-    title?: string;
-    description?: string;
-}
-declare const TenantSelector: React__default.FC<TenantSelectorProps>;
-
-interface ChangePasswordModalProps {
-    open: boolean;
-    onClose: () => void;
-    onSuccess?: () => void;
+interface LatticeChatShellContextProviderProps {
+    /**
+     * Children components
+     */
+    children: ReactNode;
+    /**
+     * Initial configuration (optional)
+     */
+    initialConfig?: Partial<LatticeChatShellConfig>;
+    /**
+     * Whether to persist configuration to localStorage (optional, default: false)
+     */
+    persistToLocalStorage?: boolean;
+    /**
+     * LocalStorage key for persisting configuration (optional, default: "lattice_chat_shell_config")
+     */
+    localStorageKey?: string;
 }
-declare const ChangePasswordModal: React__default.FC<ChangePasswordModalProps>;
+/**
+ * Provider component for LatticeChatShellContext
+ * Manages Lattice Chat Shell configuration
+ */
+declare const LatticeChatShellContextProvider: ({ children, initialConfig, persistToLocalStorage, localStorageKey, }: LatticeChatShellContextProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access LatticeChatShellContext
+ * @returns Lattice Chat Shell context value
+ * @throws Error if used outside of LatticeChatShellContextProvider
+ */
+declare const useLatticeChatShellContext: () => LatticeChatShellContextValue;
 
-interface UseTenantsOptions {
-    baseURL: string;
-    token?: string;
-}
-interface UseTenantsReturn {
-    tenants: Tenant[];
+interface UseMiddlewareTypesResult {
+    middlewareTypes: MiddlewareTypeDefinition[];
     isLoading: boolean;
-    error: string | null;
-    refresh: () => Promise<void>;
-    getTenantById: (id: string) => Tenant | undefined;
+    isFallback: boolean;
 }
 /**
- * Fetches and manages a list of tenants from the API.
+ * Fetch middleware types from API, fallback to DEFAULT_MIDDLEWARE_TYPES on failure.
+ */
+declare function useMiddlewareTypes(endpoint?: string): UseMiddlewareTypesResult;
+
+/**
+ * Fetches and manages evaluation projects.
  *
- * @param options - Configuration options
- * @param options.baseURL - The base URL of the API gateway
- * @param options.token - Optional authentication token
- * @returns Tenant list, loading state, error, refresh function, and lookup helper
+ * @returns Project list, loading state, error, and CRUD operations
  *
  * @example
  * ```tsx
- * const { tenants, isLoading, error, refresh, getTenantById } = useTenants({
- *   baseURL: "https://api.example.com",
- *   token: "your-auth-token",
- * });
+ * const { projects, loading, create, update, remove, refresh } = useEvalProjects();
+ *
+ * await create({ name: "My Project" });
  * ```
  */
-declare function useTenants(options: UseTenantsOptions): UseTenantsReturn;
-interface UseUsersOptions {
-    baseURL: string;
-    tenantId: string;
-    token?: string;
-}
-interface UseUsersReturn {
-    users: _axiom_lattice_protocols.User[];
-    isLoading: boolean;
-    error: string | null;
+declare function useEvalProjects(): {
+    projects: unknown[];
+    loading: boolean;
+    error: Error | null;
+    create: (data: Record<string, unknown>) => Promise<unknown>;
+    update: (id: string, patch: Record<string, unknown>) => Promise<void>;
+    remove: (id: string) => Promise<void>;
     refresh: () => Promise<void>;
-    searchByEmail: (email: string) => Promise<_axiom_lattice_protocols.User | null>;
-}
+};
+
 /**
- * Fetches and manages a list of users within a tenant.
+ * Fetches and manages evaluation suites within a project.
  *
- * @param options - Configuration options
- * @param options.baseURL - The base URL of the API gateway
- * @param options.tenantId - The tenant ID to fetch users for
- * @param options.token - Optional authentication token
- * @returns User list, loading state, error, refresh function, and email search helper
+ * @param projectId - The project ID to fetch suites for
+ * @returns Suite list, loading state, error, and CRUD operations
  *
  * @example
  * ```tsx
- * const { users, isLoading, error, searchByEmail } = useUsers({
- *   baseURL: "https://api.example.com",
- *   tenantId: "tenant-123",
- * });
+ * const { suites, loading, create, remove } = useEvalSuites("proj-123");
  *
- * const user = await searchByEmail("user@example.com");
+ * await create("proj-123", { name: "Accuracy Suite" });
  * ```
  */
-declare function useUsers(options: UseUsersOptions): UseUsersReturn;
+declare function useEvalSuites(projectId: string): {
+    suites: unknown[];
+    loading: boolean;
+    error: Error | null;
+    create: (pid: string, data: Record<string, unknown>) => Promise<unknown>;
+    update: (pid: string, id: string, patch: Record<string, unknown>) => Promise<void>;
+    remove: (pid: string, id: string) => Promise<void>;
+    refresh: () => Promise<void>;
+};
 
-interface ChatErrorBoundaryProps {
-    /** Display name for this boundary (shown in error messages) */
-    name?: string;
-    children: React__default.ReactNode;
-    fallback?: React__default.ReactNode;
-    onError?: (error: Error, errorInfo: React__default.ErrorInfo) => void;
-}
-interface ChatErrorBoundaryState {
-    hasError: boolean;
+/**
+ * Fetches and manages evaluation cases within a suite.
+ *
+ * @param projectId - The project ID the suite belongs to
+ * @param suiteId - The suite ID to fetch cases for
+ * @returns Case list, loading state, error, and CRUD operations
+ *
+ * @example
+ * ```tsx
+ * const { cases, loading, create } = useEvalCases("proj-123", "suite-456");
+ *
+ * await create("proj-123", "suite-456", { question: "What is 2+2?", answer: "4" });
+ * ```
+ */
+declare function useEvalCases(projectId: string, suiteId: string): {
+    cases: unknown[];
+    loading: boolean;
     error: Error | null;
-    errorInfo: React__default.ErrorInfo | null;
-    retryKey: number;
-}
-declare class ChatErrorBoundary extends Component<ChatErrorBoundaryProps, ChatErrorBoundaryState> {
-    constructor(props: ChatErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): Partial<ChatErrorBoundaryState>;
-    componentDidCatch(error: Error, errorInfo: React__default.ErrorInfo): void;
-    handleRetry: () => void;
-    handleCopyError: () => void;
-    render(): React__default.ReactNode;
-}
+    create: (pid: string, sid: string, data: Record<string, unknown>) => Promise<unknown>;
+    update: (pid: string, sid: string, id: string, patch: Record<string, unknown>) => Promise<void>;
+    remove: (pid: string, sid: string, id: string) => Promise<void>;
+    refresh: () => Promise<void>;
+};
 
 /**
- * Props for the {@link Chating} component — the core chat interface.
+ * Fetches and manages evaluation runs, optionally scoped to a project.
  *
- * Controls appearance, sender behavior, empty-state customization, and
- * optional context injection for the agent.
+ * @param projectId - Optional project ID to filter runs by project
+ * @returns Run list, loading state, error, and operations (start, abort, remove)
+ *
+ * @example
+ * ```tsx
+ * const { runs, loading, start, abort } = useEvalRuns("proj-123");
+ *
+ * const result = await start("proj-123");
+ * ```
  */
-interface ChatingProps {
-    /** Agent display name shown in the header. */
-    name?: string;
-    /** Agent description shown in the header. */
-    description?: string;
-    /** Fallback message used when the user submits only attachments without text. */
-    default_submit_message?: string;
-    /** Avatar URL or component for the agent. */
-    avatar?: string;
-    /** Placeholder content rendered inside the attachment upload area. */
-    attachment_placeholder?: React__default.ReactNode;
-    /** Custom upload endpoint URL. Defaults to the workspace or thread sandbox upload endpoint. */
-    uploadAction?: string;
-    /** Quick prompt items displayed between messages. */
-    senderPromptsItems?: GetProp<typeof Prompts, "items">;
-    /** Extra content rendered in the header area. */
-    extra?: React__default.ReactNode;
-    /** Additional metadata items for the header. */
-    extraMeta?: Array<{
-        id: string;
+declare function useEvalRuns(projectId?: string): {
+    runs: unknown[];
+    loading: boolean;
+    error: Error | null;
+    start: (pid: string) => Promise<{
+        run_id: string;
     }>;
-    /** Whether to show the agent header bar. Default: true. */
-    showHeader?: boolean;
-    /** Whether to show the message sender input. Default: true. */
-    showSender?: boolean;
-    /** Whether to show the Human-in-the-Loop (HITL) container. Default: true. */
-    showHITL?: boolean;
-    /** Whether to show a refresh button in the header. */
-    showRefreshButton?: boolean;
-    /**
-     * Whether to show the model selector in the sender footer.
-     * When provided, overrides the shell config's enableModelSelector.
-     */
-    showModelSelector?: boolean;
-    /** Show database picker in sender footer. Overrides shell config enableDatabaseSlot. */
-    showDatabaseSlot?: boolean;
-    /** Show skill picker in sender footer. Overrides shell config enableSkillSlot. */
-    showSkillSlot?: boolean;
-    /** Show agent picker in sender footer. Overrides shell config enableAgentSlot. */
-    showAgentSlot?: boolean;
-    /** Show metrics data source picker in sender footer. Overrides shell config enableMetricsDataSourceSlot. */
-    showMetricsDataSourceSlot?: boolean;
-    /** Whether to show the greeting empty state when no messages exist. Default: true. */
-    showEmptyState?: boolean;
-    /** Custom greeting element displayed in the empty state. */
-    emptyStateGreeting?: React__default.ReactNode;
-    /** Empty state question line. Default: "Ready to turn..." */
-    emptyStateQuestion?: string;
-    /** Show skill category prompts in empty state. Default: true. */
-    showSkillPrompts?: boolean;
-    /** Show business analysis prompts in empty state. Default: true. */
-    showQuickAnalysis?: boolean;
-    /** Welcome prefix text (e.g., "Hey"). */
-    welcomePrefix?: string;
-    /** Context string injected before the first user message (e.g. workflow context). */
-    systemContext?: string;
-    /** Auto-send this message when agent becomes idle (thread ready, not loading). */
-    initialMessage?: string | null;
-    /** Called after initialMessage has been sent. */
-    onInitialMessageSent?: () => void;
+    abort: (runId: string) => Promise<void>;
+    remove: (runId: string) => Promise<void>;
+    refresh: () => Promise<void>;
+};
+
+/**
+ * Streams real-time progress of an evaluation run via SSE.
+ *
+ * @param runId - The evaluation run ID to stream, or `null` to disable streaming
+ * @returns Status, progress counters, connection state, and a stop function
+ *
+ * @example
+ * ```tsx
+ * const { status, progress, connected, stopStreaming } = useEvalRunStream("run-789");
+ * // progress: { completed: 5, total: 10, passed: 4, failed: 1 }
+ * ```
+ */
+declare function useEvalRunStream(runId: string | null): {
+    status: string;
+    progress: {
+        completed: number;
+        total: number;
+        passed: number;
+        failed: number;
+    };
+    connected: boolean;
+    stopStreaming: () => void;
+};
+
+/**
+ * Provider component for the Axiom Lattice client
+ * @param props - Provider props
+ * @returns Provider component
+ */
+declare function AxiomLatticeProvider({ config, onUnauthorized, children, }: AxiomLatticeProviderProps): react_jsx_runtime.JSX.Element;
+interface UseAxiomLatticeOptions {
+    assistantId?: string | null;
+}
+/**
+ * Hook to get a client for a specific assistant
+ * @param assistantId - The assistant ID
+ * @returns Client instance for the assistant
+ * @throws Error if used outside of AxiomLatticeProvider
+ */
+declare function useClient(assistantId: string): Client;
+/**
+ * Hook to access the Axiom Lattice client
+ * @returns The Axiom Lattice client
+ * @throws Error if used outside of AxiomLatticeProvider
+ * @deprecated Use useClient(assistantId) instead
+ */
+declare function useAxiomLattice({ assistantId, }?: UseAxiomLatticeOptions): Client;
+
+/**
+ * Context value for AgentThreadContext
+ */
+interface AgentThreadContextValue<T extends UseChatOptions> {
+    state: ChatStateWithAgent;
+    sendMessage: (data: {
+        input?: {
+            message: string;
+            files?: {
+                name: string;
+                id: string;
+            }[];
+        };
+        command?: {
+            resume?: {
+                action: string;
+                data: Record<string, any> & {
+                    config?: {
+                        thread_id?: string;
+                        work_log_id?: string;
+                    };
+                };
+                message: string;
+            };
+            update?: any;
+            send?: {
+                node: string;
+                input: any;
+            };
+        };
+        streaming?: boolean;
+        mode?: 'collect' | 'followup' | 'steer';
+    }) => Promise<void>;
+    stopStreaming: () => void;
+    resumeStream: (messageId?: string) => () => void;
+    loadMessages: (limit?: number) => Promise<void>;
+    clearMessages: () => void;
+    clearError: () => void;
+    customRunConfig: Record<string, any>;
+    updateCustomRunConfig: (config: Record<string, any>) => void;
+    removePendingMessage: (messageId: string) => Promise<boolean>;
+    abortAgent: () => Promise<void>;
 }
 /**
- * Core chat interface component — manages sender input, message display,
- * and agent-streaming state for a single assistant thread.
+ * Props for AgentThreadProvider
+ */
+interface AgentThreadProviderProps<T extends UseChatOptions> {
+    threadId: string | null;
+    assistantId?: string;
+    options?: T;
+    children: ReactNode;
+    onToolCompleted?: (toolName: string) => void;
+    onStreamCompleted?: () => void;
+}
+/**
+ * Provider component for AgentThreadContext.
+ * Manages all agent thread state and operations including message streaming, interrupts,
+ * queue management, and agent state polling.
  *
- * Features:
- * - Empty state with greeting and skill/analysis prompt categories
- * - Message sender with file attachment, skill/agent/database pickers, and model selector
- * - Typing cursor animation during streaming
- * - HITL interrupt handling and pending-message display
- * - Auto-send of {@link ChatingProps.systemContext} and {@link ChatingProps.initialMessage}
- * - Transition animations between empty and active states
+ * @param props - {@link AgentThreadProviderProps}
+ * @param props.threadId - The ID of the thread to manage. If `null`, the provider renders nothing.
+ * @param props.assistantId - The assistant ID to associate with this thread. Falls back to the client's assistant ID if omitted.
+ * @param props.options - Configuration options for chat behavior (streaming, resume stream polling, initial messages, etc.).
+ * @param props.children - React children to render within the thread context.
+ * @param props.onToolCompleted - Callback invoked each time a tool call completes, receiving the tool name.
+ * @param props.onStreamCompleted - Callback invoked when the SSE stream completes for any message.
  *
- * @param props - See {@link ChatingProps}.
- * @returns The full chat UI for the active thread.
+ * @returns A React context provider wrapping children with {@link AgentThreadContext.Provider}, or `null` if no `threadId` is provided.
+ */
+declare function AgentThreadProvider<T extends UseChatOptions>({ threadId, assistantId, options, children, onToolCompleted, onStreamCompleted, }: AgentThreadProviderProps<T>): react_jsx_runtime.JSX.Element | null;
+/**
+ * Hook to access AgentThreadContext.
+ *
+ * @param T - The {@link UseChatOptions} type parameter, allowing typed access to options.
+ * @returns Agent thread context value of type {@link AgentThreadContextValue}.
+ * @throws {Error} If used outside of an {@link AgentThreadProvider}.
  *
  * @example
  * ```tsx
- * import { Chating } from "@axiom-lattice/react-sdk";
+ * const { state, sendMessage, stopStreaming, abortAgent } = useAgentThreadContext();
  *
- * <Chating
- *   name="Data Analyst"
- *   showHeader
- *   showSender
- *   showModelSelector
- *   emptyStateQuestion="What data would you like to analyze?"
- *   systemContext="You are analyzing sales data from Q4 2024."
- * />
+ * await sendMessage({ input: { message: 'Hello!' } });
  * ```
- *
- * @remarks
- * - Requires the following ancestor context providers: {@link AgentThreadProvider},
- *   {@link ChatUIContextProvider}, {@link LatticeChatShellContextProvider},
- *   {@link ConversationContextProvider}, {@link AssistantContextProvider}.
- * - Prop-level feature toggles (e.g. `showModelSelector`) take priority over
- *   shell-config-level toggles.
- * - Uses {@link useAgentChat} for all agent communication.
  */
-declare const Chating: React__default.FC<ChatingProps>;
+declare function useAgentThreadContext<T extends UseChatOptions>(): AgentThreadContextValue<T>;
 
+interface UserTenantInfo {
+    tenantId: string;
+    role: string;
+    tenant?: Tenant;
+}
+interface PersonalAssistantInfo {
+    assistantId: string;
+    projectId: string;
+    workspaceId: string;
+    /** tenantId for debugging cross-tenant leakage */
+    tenantId?: string | null;
+}
+interface AuthContextValue {
+    user: User | null;
+    tenants: UserTenantInfo[];
+    currentTenant: Tenant | null;
+    personalAssistant: PersonalAssistantInfo | null;
+    setPersonalAssistant: (info: PersonalAssistantInfo | null) => void;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    error: string | null;
+    login: (email: string, password: string) => Promise<{
+        requiresTenantSelection: boolean;
+        hasTenants: boolean;
+    }>;
+    register: (email: string, password: string, name: string) => Promise<{
+        message: string;
+        token?: string;
+    }>;
+    logout: () => void;
+    selectTenant: (tenantId: string) => Promise<void>;
+    fetchUserTenants: () => Promise<void>;
+    refreshUser: () => Promise<void>;
+    clearError: () => void;
+    changePassword: (currentPassword: string, newPassword: string) => Promise<void>;
+}
 /**
- * Props for the {@link LatticeChat} component.
+ * Hook to access authentication context. Must be used within an {@link AuthProvider}.
  *
- * Extends {@link ChatingProps} with thread/assistant identification
- * and optional menu/header slots.
- */
-type AgentChatProps = {
-    /** The ID of the currently active thread. If absent, a placeholder is shown prompting users to create a conversation. */
-    thread_id?: string;
-    /** The assistant ID that backs the chat. Required — feeds the {@link AgentThreadProvider}. */
-    assistant_id: string;
-    /** Optional menu rendered in the left sidebar column. */
-    menu?: React__default.ReactNode;
-    /** Optional header rendered above the main chat area. */
-    header?: React__default.ReactNode;
-    /** Optional right-side header content. Replaces the default folder toggle button. Use {@link FilePanelToggle} to include it. */
-    headerRight?: React__default.ReactNode;
-    /** Show workspace project selector in header. Default true. */
-    showProjectSelector?: boolean;
-    /** Content shown when no thread is active. Default: "Please create a conversation first". */
-    emptyPlaceholder?: React__default.ReactNode;
-} & ChatingProps;
-/**
- * Top-level chat component for a single assistant thread.
+ * @description
+ * Provides the full auth state and all auth operations (login, register, logout, tenant selection, etc.).
+ * Throws an error if no {@link AuthProvider} is found in the component tree. For optional auth,
+ * use {@link useAuthOptional} instead.
  *
- * Wraps the chat UI in:
- * - {@link AgentThreadProvider} for thread state
- * - {@link ChatUIContextProvider} for UI panel toggles
- * - A responsive {@link ColumnLayout} with menu, main chat, detail panel, and tools panel
+ * @returns The current {@link AuthContextValue} containing user, tenants, auth state, and auth actions.
  *
- * When `thread_id` is empty, a prompt to create a conversation is displayed.
+ * @throws {Error} If used outside of an {@link AuthProvider}.
  *
  * @example
  * ```tsx
- * import { LatticeChat } from "@axiom-lattice/react-sdk";
+ * const { user, isAuthenticated, login, logout } = useAuth();
  *
- * <LatticeChat
- *   assistant_id="asst_abc123"
- *   thread_id="thread_xyz"
- *   showHeader
- *   showSender
- * />
+ * const handleLogin = async () => {
+ *   const result = await login('user@example.com', 'password');
+ *   if (result.requiresTenantSelection) {
+ *     // Show tenant picker
+ *   }
+ * };
  * ```
- *
- * @remarks
- * - Requires a parent `<LatticeChatShell>` for shell-level configuration (API URL, feature toggles).
- * - The `ChatingProps` are forwarded to the internal {@link Chating} component.
- */
-declare const LatticeChat: React__default.FC<AgentChatProps>;
-
-/**
- * Model runtime configuration passed to the agent when a model is selected.
  */
-interface ModelConfig {
-    /** The model key as registered on the server (e.g., "gpt-4o"). */
-    modelKey: string;
-    /** Sampling temperature (0-2). Higher values produce more random output. */
-    temperature?: number;
-    /** Maximum tokens in the generated response. */
-    maxTokens?: number;
-    /** Nucleus sampling parameter (0-1). */
-    topP?: number;
-    /** Penalty for repeating tokens (-2 to 2). */
-    frequencyPenalty?: number;
-    /** Penalty for introducing new topics (-2 to 2). */
-    presencePenalty?: number;
-}
+declare const useAuth: () => AuthContextValue;
 /**
- * Model metadata returned by the `/api/models` endpoint.
+ * Optional version of useAuth that returns null instead of throwing when AuthProvider is not present.
+ * Use this when authentication is optional for the component.
+ *
+ * @example
+ * // For required auth - throws if no provider
+ * const { user } = useAuth();
+ *
+ * // For optional auth - returns null if no provider
+ * const user = useAuthOptional()?.user;
  */
-interface ModelInfo {
-    /** Unique model key (used as the selection value). */
-    key: string;
-    /** Provider identifier (e.g., "openai", "azure"). */
-    provider: string;
-    /** Model name as known by the provider (e.g., "gpt-4o"). */
-    model: string;
-    /** Human-readable display name for the dropdown. */
-    displayName?: string;
-}
+declare const useAuthOptional: () => AuthContextValue | null;
 /**
- * Props for the {@link ModelSelector} component.
+ * Props for {@link AuthProvider}.
  */
-interface ModelSelectorProps {
-    /** Currently selected model configuration (controlled). */
-    value?: ModelConfig | null;
-    /** Called when the user selects a model. */
-    onChange?: (config: ModelConfig | null) => void;
-    /** Default model key used when the fetch response includes a matching model. */
-    defaultModelKey?: string;
-    /** Inline styles applied to the Select element. */
-    style?: React__default.CSSProperties;
+interface AuthProviderProps {
+    /** Child components that will have access to the auth context. */
+    children: ReactNode;
+    /** Base URL of the gateway API (e.g., `http://localhost:3000`). */
+    baseURL: string;
+    /** Called after a successful login with the user and their tenant memberships. */
+    onLoginSuccess?: (user: User, tenants: UserTenantInfo[]) => void;
+    /** Called after a tenant is successfully selected, passing the selected tenant. */
+    onTenantSelected?: (tenant: Tenant) => void;
+    /** Called after the user logs out. */
+    onLogout?: () => void;
 }
 /**
- * A borderless Ant Design `Select` dropdown for choosing the LLM model.
+ * Authentication context provider. Wraps the application to provide auth state and operations
+ * to all descendant components via {@link useAuth} and {@link useAuthOptional}.
  *
- * Fetches available models from `/api/models` on first render and caches the result.
- * When a default model key matches a model in the list, it is auto-selected.
- * The selection is reported via the {@link ModelSelectorProps.onChange} callback,
- * which typically feeds into `updateCustomRunConfig` in the {@link Chating} component.
+ * @description
+ * Manages the full authentication lifecycle including:
+ * - **Login / Register**: Sends credentials to the gateway API and stores the returned user, tenants, and token in `sessionStorage`.
+ * - **Session restoration**: On mount, reads previously stored user data from `sessionStorage` and also refreshes the tenant list to catch any admin-side role assignments.
+ * - **Tenant selection**: Calls the gateway API to select a tenant and stores the tenant data.
+ * - **Logout**: Clears all auth state and `sessionStorage`.
+ * - **Change password**: Proxies to the gateway password change endpoint.
+ * - **Token expiration**: Automatically logs out when the gateway returns a 401 with an expired token message.
  *
- * @param value - Currently selected model config (controlled).
- * @param onChange - Callback when the selection changes.
- * @param defaultModelKey - Model key to auto-select if found in the model list.
- * @param style - Inline styles for the Select wrapper.
- * @returns A compact model selector with hover-highlight background.
+ * @param props - {@link AuthProviderProps}
+ * @param props.children - React children to render within the auth context.
+ * @param props.baseURL - Base URL of the gateway API.
+ * @param props.onLoginSuccess - Optional callback invoked after a successful login.
+ * @param props.onTenantSelected - Optional callback invoked after tenant selection.
+ * @param props.onLogout - Optional callback invoked on logout.
+ *
+ * @returns A React context provider wrapping children with {@link AuthContext.Provider}.
  *
  * @example
  * ```tsx
- * import { ModelSelector } from "@axiom-lattice/react-sdk";
- *
- * <ModelSelector
- *   value={modelConfig}
- *   onChange={(config) => updateCustomRunConfig({ modelConfig: config })}
- *   defaultModelKey="gpt-4o"
- * />
+ * <AuthProvider
+ *   baseURL="http://localhost:3000"
+ *   onLoginSuccess={(user) => console.log('Logged in:', user.email)}
+ *   onLogout={() => window.location.reload()}
+ * >
+ *   <App />
+ * </AuthProvider>
  * ```
- *
- * @remarks
- * - Supports both controlled (`value` prop) and uncontrolled (internal state) usage.
- * - Fetch is performed only once per component mount via a ref guard.
- * - The dropdown is intentionally borderless to blend into the sender footer.
  */
-declare const ModelSelector: React__default.FC<ModelSelectorProps>;
-
-declare const MDResponse: React__default.MemoExoticComponent<({ content, context, embeddedLink, interactive, userData, noGenUI, }: {
-    context?: any;
-    content: string;
-    embeddedLink?: boolean;
-    interactive?: boolean;
-    userData?: any;
-    noGenUI?: boolean;
-}) => react_jsx_runtime.JSX.Element>;
-declare const MDViewFormItem: ({ value }: {
-    value?: string;
-}) => react_jsx_runtime.JSX.Element;
+declare const AuthProvider: React__default.FC<AuthProviderProps>;
 
 /**
- * Props passed to every GenUI element component.
- *
- * Each element registered in the GenUI element registry receives these props,
- * with the `data` field carrying the element-specific payload from the agent.
- *
- * @typeParam T - The shape of the element-specific data payload
+ * Login Form Components
+ * Uses base styles from design system
  */
-type ElementProps<T = any> = {
-    /** Key identifying which GenUI element component to render */
-    component_key: string;
-    /** Optional context for the current conversation */
-    context?: {
-        /** The thread ID associated with this element */
-        thread_id?: string;
-        /** The assistant ID associated with this element */
-        assistant_id?: string;
-    };
-    /** Element-specific data payload from the agent */
-    data: T;
-    /** Whether the element supports user interaction (defaults to false) */
-    interactive?: boolean;
-    /** Whether to open this element in the side app panel by default */
-    default_open_in_side_app?: boolean;
-};
+
+interface LoginFormProps {
+    onSuccess?: () => void;
+    onCancel?: () => void;
+    logo?: React__default.ReactNode;
+    title?: string;
+    subtitle?: string;
+    footer?: React__default.ReactNode;
+    className?: string;
+}
+declare const LoginForm: React__default.FC<LoginFormProps>;
+declare const LoginPage: React__default.FC<any>;
+interface RegisterFormProps {
+    onSuccess?: () => void;
+    onCancel?: () => void;
+    logo?: React__default.ReactNode;
+    title?: string;
+    subtitle?: string;
+    footer?: React__default.ReactNode;
+    className?: string;
+}
+declare const RegisterForm: React__default.FC<RegisterFormProps>;
+
 /**
- * Metadata for a registered GenUI element.
- *
- * Defines how an element is rendered and optionally what action to perform
- * when the user interacts with it.
+ * User Profile Components
+ * Using Axiom Theme with Ant Design
  */
-interface ElementMeta {
-    /** The main card-view React component for this element */
-    card_view: React.FC<ElementProps>;
-    /** Optional side-app panel React component for expanded viewing */
-    side_app_view?: React.FC<ElementProps>;
-    /** Optional action callback invoked when the user interacts with the element */
-    action?: (data: any) => void;
+
+interface UserProfileProps {
+    /** Called when user clicks logout */
+    onLogout?: () => void;
+    /** Show tenant information */
+    showTenantSwitcher?: boolean;
+    /** Custom class name */
+    className?: string;
 }
 /**
- * Data structure representing a tool call made by the agent.
- *
- * Rendered by GenUI tool card elements to display tool invocations,
- * their arguments, and their results.
+ * User Profile Component
  */
-interface ToolCallData {
-    /** Unique identifier for this tool call */
-    id: string;
-    /** Name of the tool being called */
-    name: string;
-    /** Arguments passed to the tool */
-    args: Record<string, any>;
-    /** Distinguishes tool calls from other message types */
-    type: "tool_call";
-    /** The tool's response, if available */
-    response?: string;
-    /** Execution status of the tool call */
-    status?: "success" | "pending" | "error";
+declare const UserProfile: React__default.FC<UserProfileProps>;
+interface ProtectedRouteProps {
+    children: React__default.ReactNode;
+    /** Component to show when not authenticated */
+    fallback?: React__default.ReactNode;
+    /** Redirect URL (if using react-router) */
+    redirectTo?: string;
 }
-
-declare const getElement: (language: string | undefined) => ElementMeta | null;
-declare const regsiterElement: (language: string, ElementMeta: ElementMeta) => ElementMeta;
+/**
+ * Protected Route Component
+ * Shows loading state, redirects, or fallback when not authenticated
+ */
+declare const ProtectedRoute: React__default.FC<ProtectedRouteProps>;
 
 /**
- * Tabbed side-app browser that renders GenUI components in the right panel.
- *
- * Manages a tab strip of registered side-app views. When a new component is
- * selected via {@link SideAppBrowserContext}, a tab is added (or activated if
- * it already exists). Tabs are closable and switchable. An "all tabs" dropdown
- * appears when there are 2+ tabs. Uses {@link ChatUIContext} to read/write the
- * active side-app card and open/close the panel.
- *
- * @param region - Which panel region this browser is attached to.
- *   `"side"` for the right detail panel (default), `"content"` for the main content area.
- * @returns The tabbed side-app viewer, or an empty state if no tabs are open.
- *
- * @example
- * ```tsx
- * import { SideAppViewBrowser } from "@axiom-lattice/react-sdk";
- *
- * <SideAppViewBrowser region="side" />
- * ```
- *
- * @remarks
- * - Internally renders {@link SideAppBrowserContext.Provider} so that child
- *   components can programmatically open new side-apps via `openApp()`.
- * - Component resolution uses {@link getElement} from the GenUI element registry.
- * - Designed to work with {@link ColumnLayout} as the `detail` panel.
+ * Tenant Selector Components
+ * Uses unified auth styles from design system
  */
-declare const SideAppViewBrowser: React__default.FC<{
-    region?: "side" | "content";
-}>;
 
-type PanelCardData = Record<string, unknown> & {
-    component?: ReactNode;
-    message?: string;
-};
-type PanelCard = {
-    component_key: string;
-    data: PanelCardData;
-    message?: string;
-    context?: {
-        thread_id?: string;
-        assistant_id?: string;
-    };
-};
-declare const ChatUIContext: React__default.Context<{
-    detailVisible: boolean;
-    setDetailVisible: (visible: boolean) => void;
-    detailSize: "small" | "middle" | "large" | "full";
-    setDetailSize: (size: "small" | "middle" | "large" | "full") => void;
-    detailSelectedCard: PanelCard | null;
-    setDetailSelectedCard: (card: PanelCard | null) => void;
-    openDetail: (card: PanelCard) => void;
-    closeDetail: () => void;
-    toolsVisible: boolean;
-    setToolsVisible: (visible: boolean) => void;
-    toggleTools: () => void;
-    toolSelectedCard: PanelCard | null;
-    setToolSelectedCard: (card: PanelCard | null) => void;
-    openTools: (card: PanelCard) => void;
-    closeTools: () => void;
-    sideAppVisible: boolean;
-    setSideAppVisible: (visible: boolean) => void;
-    sideAppSize: "small" | "middle" | "large" | "full";
-    setSideAppSize: (size: "small" | "middle" | "large" | "full") => void;
-    sideAppSelectedCard: PanelCard | null;
-    setSideAppSelectedCard: (card: PanelCard | null) => void;
-    openSideApp: (card: PanelCard) => void;
-    closeSideApp: () => void;
-    menuCollapsed: boolean | undefined;
-    setMenuCollapsed: (collapsed: boolean) => void;
-    openContentApp: (card: PanelCard) => void;
-    closeContentApp: () => void;
-    contentAppVisible: boolean;
-    setcontentAppVisible: (visible: boolean) => void;
-    contentAppSelectedCard: PanelCard | null;
-    setContentAppSelectedCard: (card: PanelCard | null) => void;
-}>;
+interface TenantSelectorProps {
+    tenants: Tenant[];
+    currentTenantId?: string | null;
+    onSelect: (tenant: Tenant) => void;
+    onLogout?: () => void;
+    isLoading?: boolean;
+    className?: string;
+    title?: string;
+    description?: string;
+}
+declare const TenantSelector: React__default.FC<TenantSelectorProps>;
+
+interface ChangePasswordModalProps {
+    open: boolean;
+    onClose: () => void;
+    onSuccess?: () => void;
+}
+declare const ChangePasswordModal: React__default.FC<ChangePasswordModalProps>;
+
+interface UseTenantsOptions {
+    baseURL: string;
+    token?: string;
+}
+interface UseTenantsReturn {
+    tenants: Tenant[];
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    getTenantById: (id: string) => Tenant | undefined;
+}
 /**
- * Chat UI context provider. Manages visibility and selected cards for chat panel areas
- * (detail, tools, side app, content app) and the sidebar menu collapsed state.
- *
- * @description
- * Tracks the open/closed state and the currently selected {@link PanelCard} for each panel:
- * - **Detail panel**: A slide-out detail view that displays a chosen card's content.
- * - **Tools panel**: A tools sidebar/drawer for tool-specific cards.
- * - **Side app**: Aliases to the detail panel (shared state).
- * - **Content app**: An inline content area for embedded app cards.
- * - **Menu collapsed**: Whether the sidebar navigation menu is collapsed.
- *
- * Provides action helpers (`openDetail`, `closeDetail`, `openTools`, `toggleTools`, etc.)
- * that set both visibility and selected card atomically.
- *
- * @param props - Provider props.
- * @param props.children - React children to render within the UI context.
+ * Fetches and manages a list of tenants from the API.
  *
- * @returns A React context provider wrapping children with {@link ChatUIContext.Provider}.
+ * @param options - Configuration options
+ * @param options.baseURL - The base URL of the API gateway
+ * @param options.token - Optional authentication token
+ * @returns Tenant list, loading state, error, refresh function, and lookup helper
  *
  * @example
  * ```tsx
- * <ChatUIContextProvider>
- *   <ChatLayout />
- * </ChatUIContextProvider>
+ * const { tenants, isLoading, error, refresh, getTenantById } = useTenants({
+ *   baseURL: "https://api.example.com",
+ *   token: "your-auth-token",
+ * });
  * ```
  */
-declare const ChatUIContextProvider: ({ children, }: {
-    children: React__default.ReactNode;
-}) => react_jsx_runtime.JSX.Element;
+declare function useTenants(options: UseTenantsOptions): UseTenantsReturn;
+interface UseUsersOptions {
+    baseURL: string;
+    tenantId: string;
+    token?: string;
+}
+interface UseUsersReturn {
+    users: _axiom_lattice_protocols.User[];
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+    searchByEmail: (email: string) => Promise<_axiom_lattice_protocols.User | null>;
+}
 /**
- * Hook to access the chat UI context. Must be used within a {@link ChatUIContextProvider}.
- *
- * @description
- * Returns panel visibility state, selected panel cards, and action functions for controlling
- * the chat interface panels (detail, tools, side app, content app) and menu collapsed state.
+ * Fetches and manages a list of users within a tenant.
  *
- * @returns The current chat UI context value containing panel state and control functions.
+ * @param options - Configuration options
+ * @param options.baseURL - The base URL of the API gateway
+ * @param options.tenantId - The tenant ID to fetch users for
+ * @param options.token - Optional authentication token
+ * @returns User list, loading state, error, refresh function, and email search helper
  *
  * @example
  * ```tsx
- * const { detailVisible, openDetail, closeDetail, toggleTools, menuCollapsed } = useChatUIContext();
+ * const { users, isLoading, error, searchByEmail } = useUsers({
+ *   baseURL: "https://api.example.com",
+ *   tenantId: "tenant-123",
+ * });
  *
- * const handleCardClick = (card: PanelCard) => {
- *   openDetail(card);
- * };
+ * const user = await searchByEmail("user@example.com");
  * ```
  */
-declare const useChatUIContext: () => {
-    detailVisible: boolean;
-    setDetailVisible: (visible: boolean) => void;
-    detailSize: "small" | "middle" | "large" | "full";
-    setDetailSize: (size: "small" | "middle" | "large" | "full") => void;
-    detailSelectedCard: PanelCard | null;
-    setDetailSelectedCard: (card: PanelCard | null) => void;
-    openDetail: (card: PanelCard) => void;
-    closeDetail: () => void;
-    toolsVisible: boolean;
-    setToolsVisible: (visible: boolean) => void;
-    toggleTools: () => void;
-    toolSelectedCard: PanelCard | null;
-    setToolSelectedCard: (card: PanelCard | null) => void;
-    openTools: (card: PanelCard) => void;
-    closeTools: () => void;
-    sideAppVisible: boolean;
-    setSideAppVisible: (visible: boolean) => void;
-    sideAppSize: "small" | "middle" | "large" | "full";
-    setSideAppSize: (size: "small" | "middle" | "large" | "full") => void;
-    sideAppSelectedCard: PanelCard | null;
-    setSideAppSelectedCard: (card: PanelCard | null) => void;
-    openSideApp: (card: PanelCard) => void;
-    closeSideApp: () => void;
-    menuCollapsed: boolean | undefined;
-    setMenuCollapsed: (collapsed: boolean) => void;
-    openContentApp: (card: PanelCard) => void;
-    closeContentApp: () => void;
-    contentAppVisible: boolean;
-    setcontentAppVisible: (visible: boolean) => void;
-    contentAppSelectedCard: PanelCard | null;
-    setContentAppSelectedCard: (card: PanelCard | null) => void;
-};
+declare function useUsers(options: UseUsersOptions): UseUsersReturn;
 
-interface SideAppBrowserContextValue {
-    openApp: (card: PanelCard) => void;
+interface ChatErrorBoundaryProps {
+    /** Display name for this boundary (shown in error messages) */
+    name?: string;
+    children: React__default.ReactNode;
+    fallback?: React__default.ReactNode;
+    onError?: (error: Error, errorInfo: React__default.ErrorInfo) => void;
 }
-declare const SideAppBrowserContext: React$1.Context<SideAppBrowserContextValue | null>;
-declare const useSideAppBrowser: () => SideAppBrowserContextValue | null;
-declare const useSideAppOpener: () => ((card: PanelCard) => void);
-
-/**
- * Thread information for a conversation
- */
-interface ConversationThread {
-    id: string;
-    label: string;
-    createdAt?: string;
-    updatedAt?: string;
+interface ChatErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+    errorInfo: React__default.ErrorInfo | null;
+    retryKey: number;
+}
+declare class ChatErrorBoundary extends Component<ChatErrorBoundaryProps, ChatErrorBoundaryState> {
+    constructor(props: ChatErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<ChatErrorBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: React__default.ErrorInfo): void;
+    handleRetry: () => void;
+    handleCopyError: () => void;
+    render(): React__default.ReactNode;
 }
+
 /**
- * Conversation context value
+ * Props for the {@link Chating} component — the core chat interface.
+ *
+ * Controls appearance, sender behavior, empty-state customization, and
+ * optional context injection for the agent.
  */
-interface ConversationContextValue {
-    /**
-     * Current assistant ID
-     */
-    assistantId: string | null;
-    /**
-     * Current thread for the assistant
-     */
-    thread: ConversationThread | null;
-    /**
-     * Current thread ID
-     */
-    threadId: string | null;
-    /**
-     * List of threads for the current assistant
-     */
-    threads: ConversationThread[];
-    /**
-     * Whether threads are being loaded
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: Error | null;
-    /**
-     * Set the current thread
-     */
-    setThread: (thread: ConversationThread | null) => void;
-    /**
-     * Select a thread by ID
-     */
-    selectThread: (threadId: string) => void;
-    /**
-     * Create a new thread for the current assistant
-     */
-    createThread: (label?: string) => Promise<ConversationThread>;
-    /**
-     * List all threads for the current assistant
-     */
-    listThreads: () => Promise<ConversationThread[]>;
-    /**
-     * Update thread for the current assistant
-     */
-    updateThread: (thread: ConversationThread) => Promise<void>;
-    /**
-     * Get thread by ID
-     */
-    getThreadById: (threadId: string) => ConversationThread | null;
-    /**
-     * Delete a thread by ID
-     */
-    deleteThread: (threadId: string) => Promise<void>;
-    /**
-     * Clear the current thread
-     */
-    clearThread: () => void;
-    /**
-     * Refresh threads for the current assistant
-     */
-    refresh: () => Promise<void>;
-    /**
-     * Custom run configuration (cross-thread, assistant-level)
-     * Used for metrics datasource and other assistant-wide settings
-     */
-    customRunConfig: Record<string, any>;
+interface ChatingProps {
+    /** Agent display name shown in the header. */
+    name?: string;
+    /** Agent description shown in the header. */
+    description?: string;
+    /** Fallback message used when the user submits only attachments without text. */
+    default_submit_message?: string;
+    /** Avatar URL or component for the agent. */
+    avatar?: string;
+    /** Placeholder content rendered inside the attachment upload area. */
+    attachment_placeholder?: React__default.ReactNode;
+    /** Custom upload endpoint URL. Defaults to the workspace or thread sandbox upload endpoint. */
+    uploadAction?: string;
+    /** Quick prompt items displayed between messages. */
+    senderPromptsItems?: GetProp<typeof Prompts, "items">;
+    /** Extra content rendered in the header area. */
+    extra?: React__default.ReactNode;
+    /** Additional metadata items for the header. */
+    extraMeta?: Array<{
+        id: string;
+    }>;
+    /** Whether to show the agent header bar. Default: true. */
+    showHeader?: boolean;
+    /** Whether to show the message sender input. Default: true. */
+    showSender?: boolean;
+    /** Whether to show the Human-in-the-Loop (HITL) container. Default: true. */
+    showHITL?: boolean;
+    /** Whether to show a refresh button in the header. */
+    showRefreshButton?: boolean;
     /**
-     * Update custom run configuration
+     * Whether to show the model selector in the sender footer.
+     * When provided, overrides the shell config's enableModelSelector.
      */
-    updateCustomRunConfig: (config: Record<string, any>) => void;
-}
-/**
- * Conversation context
- */
-declare const ConversationContext: React$1.Context<ConversationContextValue>;
-/**
- * Props for ConversationContextProvider
- */
-interface ConversationContextProviderProps {
-    children: React.ReactNode;
+    showModelSelector?: boolean;
+    /** Show database picker in sender footer. Overrides shell config enableDatabaseSlot. */
+    showDatabaseSlot?: boolean;
+    /** Show skill picker in sender footer. Overrides shell config enableSkillSlot. */
+    showSkillSlot?: boolean;
+    /** Show agent picker in sender footer. Overrides shell config enableAgentSlot. */
+    showAgentSlot?: boolean;
+    /** Show metrics data source picker in sender footer. Overrides shell config enableMetricsDataSourceSlot. */
+    showMetricsDataSourceSlot?: boolean;
+    /** Whether to show the greeting empty state when no messages exist. Default: true. */
+    showEmptyState?: boolean;
+    /** Custom greeting element displayed in the empty state. */
+    emptyStateGreeting?: React__default.ReactNode;
+    /** Empty state question line. Default: "Ready to turn..." */
+    emptyStateQuestion?: string;
+    /** Show skill category prompts in empty state. Default: true. */
+    showSkillPrompts?: boolean;
+    /** Show business analysis prompts in empty state. Default: true. */
+    showQuickAnalysis?: boolean;
+    /** Welcome prefix text (e.g., "Hey"). */
+    welcomePrefix?: string;
+    /** Context string injected before the first user message (e.g. workflow context). */
+    systemContext?: string;
+    /** Auto-send this message when agent becomes idle (thread ready, not loading). */
+    initialMessage?: string | null;
+    /** Called after initialMessage has been sent. */
+    onInitialMessageSent?: () => void;
 }
 /**
- * Generate a thread label from the first message content
- * Extracts first 15 characters of text content, excluding attachments
- */
-declare function generateLabelFromMessage(message: string): string;
-/**
- * Provider component for ConversationContext.
- * Manages conversation thread state for the currently selected assistant.
- *
- * @description
- * Coordinates with {@link AssistantContext} to load threads for the current assistant.
- * Key behaviors:
- * - **Thread loading**: Fetches threads from the API when the assistant changes. If no threads
- *   exist, a new thread is automatically created.
- * - **Auto-selection**: Selects the most recently updated thread as the active thread when loading.
- * - **Cross-thread config**: Maintains an assistant-level `customRunConfig` shared across all threads
- *   (useful for metrics datasource and other assistant-wide settings).
- * - **Thread operations**: Provides full CRUD operations (create, update, delete, list, select)
- *   backed by the client SDK.
- *
- * Requires {@link AssistantContextProvider} ancestor and {@link LatticeChatShellContextProvider}.
+ * Core chat interface component — manages sender input, message display,
+ * and agent-streaming state for a single assistant thread.
  *
- * @param props - {@link ConversationContextProviderProps}
- * @param props.children - React children to render within the conversation context.
+ * Features:
+ * - Empty state with greeting and skill/analysis prompt categories
+ * - Message sender with file attachment, skill/agent/database pickers, and model selector
+ * - Typing cursor animation during streaming
+ * - HITL interrupt handling and pending-message display
+ * - Auto-send of {@link ChatingProps.systemContext} and {@link ChatingProps.initialMessage}
+ * - Transition animations between empty and active states
  *
- * @returns A React context provider wrapping children with {@link ConversationContext.Provider}.
+ * @param props - See {@link ChatingProps}.
+ * @returns The full chat UI for the active thread.
  *
  * @example
  * ```tsx
- * <ConversationContextProvider>
- *   <ThreadList />
- * </ConversationContextProvider>
+ * import { Chating } from "@axiom-lattice/react-sdk";
+ *
+ * <Chating
+ *   name="Data Analyst"
+ *   showHeader
+ *   showSender
+ *   showModelSelector
+ *   emptyStateQuestion="What data would you like to analyze?"
+ *   systemContext="You are analyzing sales data from Q4 2024."
+ * />
  * ```
+ *
+ * @remarks
+ * - Requires the following ancestor context providers: {@link AgentThreadProvider},
+ *   {@link ChatUIContextProvider}, {@link LatticeChatShellContextProvider},
+ *   {@link ConversationContextProvider}, {@link AssistantContextProvider}.
+ * - Prop-level feature toggles (e.g. `showModelSelector`) take priority over
+ *   shell-config-level toggles.
+ * - Uses {@link useAgentChat} for all agent communication.
  */
-declare const ConversationContextProvider: ({ children, }: ConversationContextProviderProps) => react_jsx_runtime.JSX.Element;
-/**
- * Hook to access ConversationContext
- * @returns Conversation context value
- * @throws Error if used outside of ConversationContextProvider
- */
-declare const useConversationContext: () => ConversationContextValue;
+declare const Chating: React__default.FC<ChatingProps>;
 
 /**
- * Assistant state interface
- */
-interface AssistantState {
-    /**
-     * List of all assistants
-     */
-    assistants: Assistant[];
-    /**
-     * Currently selected assistant
-     */
-    currentAssistant: Assistant | null;
-    /**
-     * Whether data is being loaded
-     */
-    isLoading: boolean;
-    /**
-     * Error message if any
-     */
-    error: Error | null;
-}
-/**
- * Assistant context value interface
- */
-interface AssistantContextValue extends AssistantState {
-    /**
-     * List all assistants
-     */
-    listAssistants: () => Promise<void>;
-    /**
-     * Get a single assistant by ID
-     */
-    getAssistant: (id: string) => Promise<Assistant>;
-    /**
-     * Create a new assistant
-     */
-    createAssistant: (options: CreateAssistantOptions) => Promise<Assistant>;
-    /**
-     * Update an existing assistant
-     */
-    updateAssistant: (id: string, options: UpdateAssistantOptions) => Promise<Assistant>;
-    /**
-     * Delete an assistant
-     */
-    deleteAssistant: (id: string) => Promise<void>;
-    /**
-     * Select an assistant as current
-     */
-    selectAssistant: (id: string) => Promise<void>;
-    /**
-     * Clear the current assistant selection
-     */
-    clearCurrentAssistant: () => void;
-    /**
-     * Refresh the assistant list
-     */
-    refresh: () => Promise<void>;
-}
-/**
- * Assistant context
- */
-declare const AssistantContext: React$1.Context<AssistantContextValue>;
-/**
- * Props for AssistantContextProvider
+ * Props for the {@link LatticeChat} component.
+ *
+ * Extends {@link ChatingProps} with thread/assistant identification
+ * and optional menu/header slots.
  */
-interface AssistantContextProviderProps {
-    /**
-     * Children components
-     */
-    children: React.ReactNode;
-    /**
-     * Whether to automatically load assistants on mount
-     */
-    autoLoad?: boolean;
-    /**
-     * Initial assistant ID to select
-     */
-    initialAssistantId?: string | null;
-}
+type AgentChatProps = {
+    /** The ID of the currently active thread. If absent, a placeholder is shown prompting users to create a conversation. */
+    thread_id?: string;
+    /** The assistant ID that backs the chat. Required — feeds the {@link AgentThreadProvider}. */
+    assistant_id: string;
+    /** Optional menu rendered in the left sidebar column. */
+    menu?: React__default.ReactNode;
+    /** Optional header rendered above the main chat area. */
+    header?: React__default.ReactNode;
+    /** Optional right-side header content. Replaces the default folder toggle button. Use {@link FilePanelToggle} to include it. */
+    headerRight?: React__default.ReactNode;
+    /** Show workspace project selector in header. Default true. */
+    showProjectSelector?: boolean;
+    /** Content shown when no thread is active. Default: "Please create a conversation first". */
+    emptyPlaceholder?: React__default.ReactNode;
+} & ChatingProps;
 /**
- * Provider component for AssistantContext.
- * Manages assistant state and operations including CRUD, selection, and auto-loading.
- *
- * @description
- * Coordinates with the client SDK to provide assistant management:
- * - **Auto-load**: When `autoLoad` is `true` (default), fetches the assistant list on mount.
- * - **Auto-selection**: If `initialAssistantId` is provided, selects that assistant after loading.
- *   Otherwise, auto-selects the first available assistant.
- * - **Re-selection**: If the currently selected assistant is removed from the list (e.g., deleted),
- *   falls back to selecting the first available assistant.
- * - **CRUD operations**: Provides `createAssistant`, `updateAssistant`, `deleteAssistant`, and
- *   `getAssistant` backed by the SDK, keeping local state in sync.
- *
- * Requires an {@link AxiomLatticeProvider} ancestor for the API client.
+ * Top-level chat component for a single assistant thread.
  *
- * @param props - {@link AssistantContextProviderProps}
- * @param props.children - React children to render within the assistant context.
- * @param props.autoLoad - Whether to automatically load assistants on mount. Defaults to `true`.
- * @param props.initialAssistantId - Optional assistant ID to auto-select on load.
+ * Wraps the chat UI in:
+ * - {@link AgentThreadProvider} for thread state
+ * - {@link ChatUIContextProvider} for UI panel toggles
+ * - A responsive {@link ColumnLayout} with menu, main chat, detail panel, and tools panel
  *
- * @returns A React context provider wrapping children with {@link AssistantContext.Provider}.
+ * When `thread_id` is empty, a prompt to create a conversation is displayed.
  *
  * @example
  * ```tsx
- * <AssistantContextProvider initialAssistantId="asst_123">
- *   <AssistantSelector />
- * </AssistantContextProvider>
+ * import { LatticeChat } from "@axiom-lattice/react-sdk";
+ *
+ * <LatticeChat
+ *   assistant_id="asst_abc123"
+ *   thread_id="thread_xyz"
+ *   showHeader
+ *   showSender
+ * />
  * ```
+ *
+ * @remarks
+ * - Requires a parent `<LatticeChatShell>` for shell-level configuration (API URL, feature toggles).
+ * - The `ChatingProps` are forwarded to the internal {@link Chating} component.
  */
-declare const AssistantContextProvider: ({ children, autoLoad, initialAssistantId, }: AssistantContextProviderProps) => react_jsx_runtime.JSX.Element;
-/**
- * Hook to access AssistantContext
- * @returns Assistant context value
- * @throws Error if used outside of AssistantContextProvider
- */
-declare const useAssistantContext: () => AssistantContextValue;
+declare const LatticeChat: React__default.FC<AgentChatProps>;
 
-/**
- * Quick prompt item for quick prompt components
- */
-interface QuickPromptItem {
-    key: string;
-    icon?: ReactNode;
-    label: string;
-    description?: string;
-    content: SlotConfigType[];
+/**
+ * Model runtime configuration passed to the agent when a model is selected.
+ */
+interface ModelConfig {
+    /** The model key as registered on the server (e.g., "gpt-4o"). */
+    modelKey: string;
+    /** Sampling temperature (0-2). Higher values produce more random output. */
+    temperature?: number;
+    /** Maximum tokens in the generated response. */
+    maxTokens?: number;
+    /** Nucleus sampling parameter (0-1). */
+    topP?: number;
+    /** Penalty for repeating tokens (-2 to 2). */
+    frequencyPenalty?: number;
+    /** Penalty for introducing new topics (-2 to 2). */
+    presencePenalty?: number;
 }
 /**
- * Quick prompt category for organizing prompt items
+ * Model metadata returned by the `/api/models` endpoint.
  */
-interface QuickPromptCategory {
+interface ModelInfo {
+    /** Unique model key (used as the selection value). */
     key: string;
-    title: string;
-    icon?: ReactNode;
-    color?: string;
-    items: QuickPromptItem[];
+    /** Provider identifier (e.g., "openai", "azure"). */
+    provider: string;
+    /** Model name as known by the provider (e.g., "gpt-4o"). */
+    model: string;
+    /** Human-readable display name for the dropdown. */
+    displayName?: string;
 }
 /**
- * Middleware tool definition
+ * Props for the {@link ModelSelector} component.
  */
-interface MiddlewareToolDefinition {
-    id: string;
-    name: string;
-    description: string;
+interface ModelSelectorProps {
+    /** Currently selected model configuration (controlled). */
+    value?: ModelConfig | null;
+    /** Called when the user selects a model. */
+    onChange?: (config: ModelConfig | null) => void;
+    /** Default model key used when the fetch response includes a matching model. */
+    defaultModelKey?: string;
+    /** Inline styles applied to the Select element. */
+    style?: React__default.CSSProperties;
 }
 /**
- * JSON Schema property definition for middleware config
+ * A borderless Ant Design `Select` dropdown for choosing the LLM model.
+ *
+ * Fetches available models from `/api/models` on first render and caches the result.
+ * When a default model key matches a model in the list, it is auto-selected.
+ * The selection is reported via the {@link ModelSelectorProps.onChange} callback,
+ * which typically feeds into `updateCustomRunConfig` in the {@link Chating} component.
+ *
+ * @param value - Currently selected model config (controlled).
+ * @param onChange - Callback when the selection changes.
+ * @param defaultModelKey - Model key to auto-select if found in the model list.
+ * @param style - Inline styles for the Select wrapper.
+ * @returns A compact model selector with hover-highlight background.
+ *
+ * @example
+ * ```tsx
+ * import { ModelSelector } from "@axiom-lattice/react-sdk";
+ *
+ * <ModelSelector
+ *   value={modelConfig}
+ *   onChange={(config) => updateCustomRunConfig({ modelConfig: config })}
+ *   defaultModelKey="gpt-4o"
+ * />
+ * ```
+ *
+ * @remarks
+ * - Supports both controlled (`value` prop) and uncontrolled (internal state) usage.
+ * - Fetch is performed only once per component mount via a ref guard.
+ * - The dropdown is intentionally borderless to blend into the sender footer.
  */
-interface MiddlewareConfigSchemaProperty {
-    type: "string" | "number" | "integer" | "boolean" | "object" | "array";
-    title?: string;
-    description?: string;
-    default?: any;
-    enum?: string[];
-    enumLabels?: Record<string, string>;
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: string;
-    widget?: "input" | "textarea" | "select" | "segmented" | "switch" | "numberInput" | "skillSelect" | "databaseSelect" | "metricsSelect" | "topologyEdgeBuilder" | "collectionSelect";
-    items?: {
-        type: string;
-    };
-}
+declare const ModelSelector: React__default.FC<ModelSelectorProps>;
+
+declare const MDResponse: React__default.MemoExoticComponent<({ content, context, embeddedLink, interactive, userData, noGenUI, }: {
+    context?: any;
+    content: string;
+    embeddedLink?: boolean;
+    interactive?: boolean;
+    userData?: any;
+    noGenUI?: boolean;
+}) => react_jsx_runtime.JSX.Element>;
+declare const MDViewFormItem: ({ value }: {
+    value?: string;
+}) => react_jsx_runtime.JSX.Element;
+
 /**
- * JSON Schema for middleware configuration
+ * Props passed to every GenUI element component.
+ *
+ * Each element registered in the GenUI element registry receives these props,
+ * with the `data` field carrying the element-specific payload from the agent.
+ *
+ * @typeParam T - The shape of the element-specific data payload
  */
-interface MiddlewareConfigSchema {
-    type: "object";
-    title?: string;
-    description?: string;
-    required?: string[];
-    properties: Record<string, MiddlewareConfigSchemaProperty>;
-}
+type ElementProps<T = any> = {
+    /** Key identifying which GenUI element component to render */
+    component_key: string;
+    /** Optional context for the current conversation */
+    context?: {
+        /** The thread ID associated with this element */
+        thread_id?: string;
+        /** The assistant ID associated with this element */
+        assistant_id?: string;
+    };
+    /** Element-specific data payload from the agent */
+    data: T;
+    /** Whether the element supports user interaction (defaults to false) */
+    interactive?: boolean;
+    /** Whether to open this element in the side app panel by default */
+    default_open_in_side_app?: boolean;
+};
 /**
- * Middleware type definition
+ * Metadata for a registered GenUI element.
+ *
+ * Defines how an element is rendered and optionally what action to perform
+ * when the user interacts with it.
  */
-interface MiddlewareTypeDefinition {
-    type: string;
-    name: string;
-    description: string;
-    icon?: ReactNode;
-    schema?: MiddlewareConfigSchema;
-    defaultConfig?: Record<string, any>;
-    tools?: MiddlewareToolDefinition[];
+interface ElementMeta {
+    /** The main card-view React component for this element */
+    card_view: React.FC<ElementProps>;
+    /** Optional side-app panel React component for expanded viewing */
+    side_app_view?: React.FC<ElementProps>;
+    /** Optional action callback invoked when the user interacts with the element */
+    action?: (data: any) => void;
 }
 /**
- * Middleware type for configuration
+ * Data structure representing a tool call made by the agent.
+ *
+ * Rendered by GenUI tool card elements to display tool invocations,
+ * their arguments, and their results.
  */
-interface MiddlewareConfigDefinition {
+interface ToolCallData {
+    /** Unique identifier for this tool call */
     id: string;
-    type: string;
+    /** Name of the tool being called */
     name: string;
-    description: string;
-    enabled: boolean;
-    config: Record<string, any>;
-    /** 可选：限制该中间件暴露的工具列表。不配置则默认暴露所有工具 */
-    allowedTools?: string[];
-    tools?: MiddlewareToolDefinition[];
+    /** Arguments passed to the tool */
+    args: Record<string, any>;
+    /** Distinguishes tool calls from other message types */
+    type: "tool_call";
+    /** The tool's response, if available */
+    response?: string;
+    /** Execution status of the tool call */
+    status?: "success" | "pending" | "error";
 }
+
+declare const getElement: (language: string | undefined) => ElementMeta | null;
+declare const regsiterElement: (language: string, ElementMeta: ElementMeta) => ElementMeta;
+
 /**
- * Sidebar menu item type
+ * Tabbed side-app browser that renders GenUI components in the right panel.
+ *
+ * Manages a tab strip of registered side-app views. When a new component is
+ * selected via {@link SideAppBrowserContext}, a tab is added (or activated if
+ * it already exists). Tabs are closable and switchable. An "all tabs" dropdown
+ * appears when there are 2+ tabs. Uses {@link ChatUIContext} to read/write the
+ * active side-app card and open/close the panel.
+ *
+ * @param region - Which panel region this browser is attached to.
+ *   `"side"` for the right detail panel (default), `"content"` for the main content area.
+ * @returns The tabbed side-app viewer, or an empty state if no tabs are open.
+ *
+ * @example
+ * ```tsx
+ * import { SideAppViewBrowser } from "@axiom-lattice/react-sdk";
+ *
+ * <SideAppViewBrowser region="side" />
+ * ```
+ *
+ * @remarks
+ * - Internally renders {@link SideAppBrowserContext.Provider} so that child
+ *   components can programmatically open new side-apps via `openApp()`.
+ * - Component resolution uses {@link getElement} from the GenUI element registry.
+ * - Designed to work with {@link ColumnLayout} as the `detail` panel.
  */
-type SideMenuItemType = "drawer" | "route" | "action";
-interface ResourceFolderConfig {
-    name: string;
-    displayName?: string;
-    allowUpload: boolean;
-}
+declare const SideAppViewBrowser: React__default.FC<{
+    region?: "side" | "content";
+}>;
+
+type PanelCardData = Record<string, unknown> & {
+    component?: ReactNode;
+    message?: string;
+};
+type PanelCard = {
+    component_key: string;
+    data: PanelCardData;
+    message?: string;
+    context?: {
+        thread_id?: string;
+        assistant_id?: string;
+    };
+};
+declare const ChatUIContext: React__default.Context<{
+    detailVisible: boolean;
+    setDetailVisible: (visible: boolean) => void;
+    detailSize: "small" | "middle" | "large" | "full";
+    setDetailSize: (size: "small" | "middle" | "large" | "full") => void;
+    detailSelectedCard: PanelCard | null;
+    setDetailSelectedCard: (card: PanelCard | null) => void;
+    openDetail: (card: PanelCard) => void;
+    closeDetail: () => void;
+    toolsVisible: boolean;
+    setToolsVisible: (visible: boolean) => void;
+    toggleTools: () => void;
+    toolSelectedCard: PanelCard | null;
+    setToolSelectedCard: (card: PanelCard | null) => void;
+    openTools: (card: PanelCard) => void;
+    closeTools: () => void;
+    sideAppVisible: boolean;
+    setSideAppVisible: (visible: boolean) => void;
+    sideAppSize: "small" | "middle" | "large" | "full";
+    setSideAppSize: (size: "small" | "middle" | "large" | "full") => void;
+    sideAppSelectedCard: PanelCard | null;
+    setSideAppSelectedCard: (card: PanelCard | null) => void;
+    openSideApp: (card: PanelCard) => void;
+    closeSideApp: () => void;
+    menuCollapsed: boolean | undefined;
+    setMenuCollapsed: (collapsed: boolean) => void;
+    openContentApp: (card: PanelCard) => void;
+    closeContentApp: () => void;
+    contentAppVisible: boolean;
+    setcontentAppVisible: (visible: boolean) => void;
+    contentAppSelectedCard: PanelCard | null;
+    setContentAppSelectedCard: (card: PanelCard | null) => void;
+}>;
 /**
- * Sidebar menu item configuration
+ * Chat UI context provider. Manages visibility and selected cards for chat panel areas
+ * (detail, tools, side app, content app) and the sidebar menu collapsed state.
+ *
+ * @description
+ * Tracks the open/closed state and the currently selected {@link PanelCard} for each panel:
+ * - **Detail panel**: A slide-out detail view that displays a chosen card's content.
+ * - **Tools panel**: A tools sidebar/drawer for tool-specific cards.
+ * - **Side app**: Aliases to the detail panel (shared state).
+ * - **Content app**: An inline content area for embedded app cards.
+ * - **Menu collapsed**: Whether the sidebar navigation menu is collapsed.
+ *
+ * Provides action helpers (`openDetail`, `closeDetail`, `openTools`, `toggleTools`, etc.)
+ * that set both visibility and selected card atomically.
+ *
+ * @param props - Provider props.
+ * @param props.children - React children to render within the UI context.
+ *
+ * @returns A React context provider wrapping children with {@link ChatUIContext.Provider}.
+ *
+ * @example
+ * ```tsx
+ * <ChatUIContextProvider>
+ *   <ChatLayout />
+ * </ChatUIContextProvider>
+ * ```
  */
+declare const ChatUIContextProvider: ({ children, }: {
+    children: React__default.ReactNode;
+}) => react_jsx_runtime.JSX.Element;
 /**
- * Sidebar menu item configuration.
+ * Hook to access the chat UI context. Must be used within a {@link ChatUIContextProvider}.
  *
- * Three item types:
- * - `"action"` — clickable button, set `builtin` for predefined behaviors
- * - `"drawer"` — opens a slide-out panel, set `content` + `title`
- * - `"route"` — opens a GenUI-registered component in the SideApp area
+ * @description
+ * Returns panel visibility state, selected panel cards, and action functions for controlling
+ * the chat interface panels (detail, tools, side app, content app) and menu collapsed state.
  *
- * When providing `sideMenuItems` or `workspaceMenuItems` to `LatticeChatShellConfig`,
- * your array **completely replaces** the defaults. Import `DEFAULT_MENU_ITEMS` or
- * `DEFAULT_WORKSPACE_MENU_ITEMS` to selectively include built-in items:
- * ```
- * sideMenuItems: DEFAULT_MENU_ITEMS.filter(i => i.id === "thread-history")
+ * @returns The current chat UI context value containing panel state and control functions.
+ *
+ * @example
+ * ```tsx
+ * const { detailVisible, openDetail, closeDetail, toggleTools, menuCollapsed } = useChatUIContext();
+ *
+ * const handleCardClick = (card: PanelCard) => {
+ *   openDetail(card);
+ * };
  * ```
  */
-interface SideMenuItemConfig {
-    /** Unique identifier for the menu item */
+declare const useChatUIContext: () => {
+    detailVisible: boolean;
+    setDetailVisible: (visible: boolean) => void;
+    detailSize: "small" | "middle" | "large" | "full";
+    setDetailSize: (size: "small" | "middle" | "large" | "full") => void;
+    detailSelectedCard: PanelCard | null;
+    setDetailSelectedCard: (card: PanelCard | null) => void;
+    openDetail: (card: PanelCard) => void;
+    closeDetail: () => void;
+    toolsVisible: boolean;
+    setToolsVisible: (visible: boolean) => void;
+    toggleTools: () => void;
+    toolSelectedCard: PanelCard | null;
+    setToolSelectedCard: (card: PanelCard | null) => void;
+    openTools: (card: PanelCard) => void;
+    closeTools: () => void;
+    sideAppVisible: boolean;
+    setSideAppVisible: (visible: boolean) => void;
+    sideAppSize: "small" | "middle" | "large" | "full";
+    setSideAppSize: (size: "small" | "middle" | "large" | "full") => void;
+    sideAppSelectedCard: PanelCard | null;
+    setSideAppSelectedCard: (card: PanelCard | null) => void;
+    openSideApp: (card: PanelCard) => void;
+    closeSideApp: () => void;
+    menuCollapsed: boolean | undefined;
+    setMenuCollapsed: (collapsed: boolean) => void;
+    openContentApp: (card: PanelCard) => void;
+    closeContentApp: () => void;
+    contentAppVisible: boolean;
+    setcontentAppVisible: (visible: boolean) => void;
+    contentAppSelectedCard: PanelCard | null;
+    setContentAppSelectedCard: (card: PanelCard | null) => void;
+};
+
+interface SideAppBrowserContextValue {
+    openApp: (card: PanelCard) => void;
+}
+declare const SideAppBrowserContext: React$1.Context<SideAppBrowserContextValue | null>;
+declare const useSideAppBrowser: () => SideAppBrowserContextValue | null;
+declare const useSideAppOpener: () => ((card: PanelCard) => void);
+
+/**
+ * Thread information for a conversation
+ */
+interface ConversationThread {
     id: string;
-    /** Type of the menu item - drawer or route (SideApp) */
-    type: SideMenuItemType;
-    /** Display name of the menu item */
-    name: string;
-    /** Icon component for the menu item */
-    icon?: ReactNode;
-    /** Order for sorting menu items (lower values first) */
-    order?: number;
-    /** Whether this is a builtin menu item (new-analysis, thread-history, assistants, skill, skills, tools, workspace, settings, database, metrics, mcp, projects, logout, switch-tenant) */
-    builtin?: "new-analysis" | "thread-history" | "assistants" | "skill" | "skills" | "tools" | "workspace" | "settings" | "database" | "metrics" | "mcp" | "projects" | "logout" | "switch-tenant";
-    /**
-     * Menu group for organizing items
-     */
-    group?: string;
-    /**
-     * Whether the menu item is enabled (can be toggled)
-     * Defaults to true
-     */
-    enabled?: boolean;
-    /** Content config from DB (for custom menu items) */
-    contentConfig?: Record<string, unknown>;
-    /** Content to display inside the drawer (for drawer type) */
-    content?: ReactNode;
-    /** Drawer title (for drawer type) */
-    title?: string;
-    /** Drawer width in pixels or percentage (for drawer type) */
-    width?: string | number;
-    /**
-     * Whether to display drawer content inline in expanded sidebar mode
-     * When true, content shows below the menu item instead of in a drawer
-     * Defaults to false, but true for "workspace" builtin
-     */
-    inline?: boolean;
-    /**
-     * Maximum height for inline drawer content in pixels
-     * Only applies when inline is true
-     * Defaults to 400
-     */
-    inlineMaxHeight?: number;
-    /**
-     * Whether inline drawer is expanded by default
-     * Only applies when inline is true
-     * Defaults to false
-     */
-    inlineDefaultExpanded?: boolean;
-    /** Component to render in SideApp (for route type) */
-    sideAppComponent?: ReactNode;
+    label: string;
+    createdAt?: string;
+    updatedAt?: string;
 }
 /**
- * Lattice Chat Shell configuration interface
+ * Conversation context value
  */
-interface LatticeChatShellConfig {
-    /**
-     * Base URL for the API
-     */
-    baseURL: string;
-    /**
-     * API key for authentication (optional)
-     */
-    apiKey?: string;
-    /**
-     * Transport method (Server-Sent Events or WebSocket)
-     */
-    transport?: "sse" | "ws";
-    /**
-     * Request timeout in milliseconds (optional)
-     */
-    timeout?: number;
-    /**
-     * Additional headers to include in requests (optional)
-     */
-    headers?: Record<string, string>;
-    /**
-     * Whether users can create new threads from the UI
-     * Defaults to true
-     */
-    enableThreadCreation?: boolean;
+interface ConversationContextValue {
     /**
-     * Whether users can view the thread list in the sidebar
-     * Defaults to true
+     * Current assistant ID
      */
-    enableThreadList?: boolean;
-    assistantId?: string;
-    showSideMenu?: boolean;
-    /**
-     * URL of the global shared sandbox, this is used to access the global shared sandbox
-     * if not provided, sandbox will be created in the agent's sandbox
-      */
-    globalSharedSandboxURL?: string;
-    /**
-      * Available middleware types that can be configured for agents
-      * Each middleware type defines its name, description, and default configuration
-      * If not provided, default middleware types will be used
-      */
-    availableMiddlewareTypes?: MiddlewareTypeDefinition[];
+    assistantId: string | null;
     /**
-     * Whether users can create new assistants
-     * Defaults to true
+     * Current thread for the assistant
      */
-    enableAssistantCreation?: boolean;
-    /**
-      * Whether users can edit existing assistants
-      * Defaults to true
-      */
-    enableAssistantEditing?: boolean;
+    thread: ConversationThread | null;
     /**
-     * Whether to enable workspace and project management
-     * When enabled, shows workspace selector in header and file browser
-     * Defaults to false
+     * Current thread ID
      */
-    enableWorkspace?: boolean;
+    threadId: string | null;
     /**
-     * Whether to load custom menu items from the database (API /api/menu-items).
-     * When enabled, WorkspaceResourceManager fetches per-tenant custom menu items
-     * and merges them with built-in defaults.
-     * Defaults to true.
+     * List of threads for the current assistant
      */
-    enableCustomMenu?: boolean;
+    threads: ConversationThread[];
     /**
-     * Resource folders configuration for workspace
-     * Each folder represents a section in the workspace assets panel
-     * If not provided, defaults to a single root folder with upload enabled
+     * Whether threads are being loaded
      */
-    resourceFolders?: ResourceFolderConfig[];
-    /**
-       * Chat sidebar menu items. When provided, completely replaces the
-       * default built-in items (New Analysis, History).
-       *
-       * To selectively include built-in items, import and filter `DEFAULT_MENU_ITEMS`:
-       * ```
-       * sideMenuItems: DEFAULT_MENU_ITEMS.filter(i => i.id === "thread-history")
-       * ```
-       * Omit this field to use all defaults.
-       */
-    sideMenuItems?: SideMenuItemConfig[];
+    isLoading: boolean;
     /**
-     * Workspace menu items. When provided, completely replaces the
-     * default workspace items (Projects, Metrics, Database, etc.).
-     *
-     * To selectively include built-in items, import and filter `DEFAULT_WORKSPACE_MENU_ITEMS`:
-     * ```
-     * workspaceMenuItems: DEFAULT_WORKSPACE_MENU_ITEMS.filter(
-     *   i => ["workspace_projects", "assistants"].includes(i.id)
-     * )
-     * ```
-     * Omit this field to use all defaults.
+     * Error message if any
      */
-    workspaceMenuItems?: SideMenuItemConfig[];
+    error: Error | null;
     /**
-       * Whether to enable the database picker slot in the chat sender
-     * When enabled, shows a database selection button in the sender footer
-     * Defaults to true
+     * Set the current thread
      */
-    enableDatabaseSlot?: boolean;
+    setThread: (thread: ConversationThread | null) => void;
     /**
-     * Whether to enable the skill picker slot in the chat sender
-     * When enabled, shows a skill selection button in the sender footer
-     * Defaults to true
+     * Select a thread by ID
      */
-    enableSkillSlot?: boolean;
+    selectThread: (threadId: string) => void;
     /**
-     * Whether to enable the agent picker slot in the chat sender
-     * When enabled, shows an agent selection button in the sender footer
-     * Defaults to true
+     * Create a new thread for the current assistant
      */
-    enableAgentSlot?: boolean;
+    createThread: (label?: string) => Promise<ConversationThread>;
     /**
-     * Whether to enable the metrics datasource picker slot in the chat sender
-     * When enabled, shows a metrics datasource selection button in the sender footer
-     * Defaults to true
+     * List all threads for the current assistant
      */
-    enableMetricsDataSourceSlot?: boolean;
+    listThreads: () => Promise<ConversationThread[]>;
     /**
-     * Whether to enable the model selector in the chat sender
-     * When enabled, shows a model selection dropdown in the sender footer
-     * Defaults to false
+     * Update thread for the current assistant
      */
-    enableModelSelector?: boolean;
+    updateThread: (thread: ConversationThread) => Promise<void>;
     /**
-     * Sidebar display mode
-    * - "icon": Show only icons (default)
-    * - "expanded": Show icons with labels and groups
-    * Defaults to "icon"
-    */
-    sidebarMode?: "icon" | "expanded";
+     * Get thread by ID
+     */
+    getThreadById: (threadId: string) => ConversationThread | null;
     /**
-     * Whether sidebar is expanded by default (only applies when sidebarMode is "expanded")
-     * Defaults to true
+     * Delete a thread by ID
      */
-    sidebarDefaultExpanded?: boolean;
+    deleteThread: (threadId: string) => Promise<void>;
     /**
-     * Whether workspace menu is expanded by default
-     * Defaults to true
+     * Clear the current thread
      */
-    workspaceMenuDefaultExpanded?: boolean;
+    clearThread: () => void;
     /**
-     * Whether to show the expand/collapse toggle button
-     * Defaults to true
+     * Refresh threads for the current assistant
      */
-    sidebarShowToggle?: boolean;
+    refresh: () => Promise<void>;
     /**
-     * Whether to show the "New Analysis" button in expanded sidebar
-     * Defaults to true
+     * Custom run configuration (cross-thread, assistant-level)
+     * Used for metrics datasource and other assistant-wide settings
      */
-    sidebarShowNewAnalysis?: boolean;
+    customRunConfig: Record<string, any>;
     /**
-     * Logo text displayed in expanded sidebar
-     * Defaults to "Lattice"
+     * Update custom run configuration
      */
-    sidebarLogoText?: string;
+    updateCustomRunConfig: (config: Record<string, any>) => void;
+}
+/**
+ * Conversation context
+ */
+declare const ConversationContext: React$1.Context<ConversationContextValue>;
+/**
+ * Props for ConversationContextProvider
+ */
+interface ConversationContextProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * Generate a thread label from the first message content
+ * Extracts first 15 characters of text content, excluding attachments
+ */
+declare function generateLabelFromMessage(message: string): string;
+/**
+ * Provider component for ConversationContext.
+ * Manages conversation thread state for the currently selected assistant.
+ *
+ * @description
+ * Coordinates with {@link AssistantContext} to load threads for the current assistant.
+ * Key behaviors:
+ * - **Thread loading**: Fetches threads from the API when the assistant changes. If no threads
+ *   exist, a new thread is automatically created.
+ * - **Auto-selection**: Selects the most recently updated thread as the active thread when loading.
+ * - **Cross-thread config**: Maintains an assistant-level `customRunConfig` shared across all threads
+ *   (useful for metrics datasource and other assistant-wide settings).
+ * - **Thread operations**: Provides full CRUD operations (create, update, delete, list, select)
+ *   backed by the client SDK.
+ *
+ * Requires {@link AssistantContextProvider} ancestor and {@link LatticeChatShellContextProvider}.
+ *
+ * @param props - {@link ConversationContextProviderProps}
+ * @param props.children - React children to render within the conversation context.
+ *
+ * @returns A React context provider wrapping children with {@link ConversationContext.Provider}.
+ *
+ * @example
+ * ```tsx
+ * <ConversationContextProvider>
+ *   <ThreadList />
+ * </ConversationContextProvider>
+ * ```
+ */
+declare const ConversationContextProvider: ({ children, }: ConversationContextProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access ConversationContext
+ * @returns Conversation context value
+ * @throws Error if used outside of ConversationContextProvider
+ */
+declare const useConversationContext: () => ConversationContextValue;
+
+/**
+ * Assistant state interface
+ */
+interface AssistantState {
     /**
-     * Custom logo icon component
-     * If not provided, defaults to Cpu icon
+     * List of all assistants
      */
-    sidebarLogoIcon?: React__default.ReactNode;
+    assistants: Assistant[];
     /**
-     * Custom quick prompts data for quick prompt components
-     * Allows registering custom prompt categories and items via shell config
-     * If not provided, default prompt data will be used
+     * Currently selected assistant
      */
-    quickPromptsData?: QuickPromptCategory[];
+    currentAssistant: Assistant | null;
+    /**
+     * Whether data is being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Error message if any
+     */
+    error: Error | null;
 }
 /**
- * Lattice Chat Shell context value interface
+ * Assistant context value interface
  */
-interface LatticeChatShellContextValue {
+interface AssistantContextValue extends AssistantState {
     /**
-     * Current configuration
+     * List all assistants
      */
-    config: LatticeChatShellConfig;
+    listAssistants: () => Promise<void>;
     /**
-     * Update the entire configuration
+     * Get a single assistant by ID
      */
-    updateConfig: (config: Partial<LatticeChatShellConfig>) => void;
+    getAssistant: (id: string) => Promise<Assistant>;
     /**
-     * Update a specific configuration value
+     * Create a new assistant
      */
-    updateConfigValue: <K extends keyof LatticeChatShellConfig>(key: K, value: LatticeChatShellConfig[K]) => void;
+    createAssistant: (options: CreateAssistantOptions) => Promise<Assistant>;
     /**
-     * Reset configuration to defaults
+     * Update an existing assistant
      */
-    resetConfig: () => void;
+    updateAssistant: (id: string, options: UpdateAssistantOptions) => Promise<Assistant>;
     /**
-     * Whether the settings modal is open
+     * Delete an assistant
      */
-    settingsModalOpen: boolean;
+    deleteAssistant: (id: string) => Promise<void>;
     /**
-     * Set the settings modal open state
+     * Select an assistant as current
      */
-    setSettingsModalOpen: (open: boolean) => void;
+    selectAssistant: (id: string) => Promise<void>;
+    /**
+     * Clear the current assistant selection
+     */
+    clearCurrentAssistant: () => void;
+    /**
+     * Refresh the assistant list
+     */
+    refresh: () => Promise<void>;
 }
 /**
- * Default middleware type definitions with JSON Schema for configuration
- */
-declare const DEFAULT_MIDDLEWARE_TYPES: MiddlewareTypeDefinition[];
-/**
- * Lattice Chat Shell context
+ * Assistant context
  */
-declare const LatticeChatShellContext: React__default.Context<LatticeChatShellContextValue>;
+declare const AssistantContext: React$1.Context<AssistantContextValue>;
 /**
- * Props for LatticeChatShellContextProvider
+ * Props for AssistantContextProvider
  */
-interface LatticeChatShellContextProviderProps {
+interface AssistantContextProviderProps {
     /**
      * Children components
      */
-    children: ReactNode;
-    /**
-     * Initial configuration (optional)
-     */
-    initialConfig?: Partial<LatticeChatShellConfig>;
+    children: React.ReactNode;
     /**
-     * Whether to persist configuration to localStorage (optional, default: false)
+     * Whether to automatically load assistants on mount
      */
-    persistToLocalStorage?: boolean;
+    autoLoad?: boolean;
     /**
-     * LocalStorage key for persisting configuration (optional, default: "lattice_chat_shell_config")
+     * Initial assistant ID to select
      */
-    localStorageKey?: string;
+    initialAssistantId?: string | null;
 }
 /**
- * Provider component for LatticeChatShellContext
- * Manages Lattice Chat Shell configuration
+ * Provider component for AssistantContext.
+ * Manages assistant state and operations including CRUD, selection, and auto-loading.
+ *
+ * @description
+ * Coordinates with the client SDK to provide assistant management:
+ * - **Auto-load**: When `autoLoad` is `true` (default), fetches the assistant list on mount.
+ * - **Auto-selection**: If `initialAssistantId` is provided, selects that assistant after loading.
+ *   Otherwise, auto-selects the first available assistant.
+ * - **Re-selection**: If the currently selected assistant is removed from the list (e.g., deleted),
+ *   falls back to selecting the first available assistant.
+ * - **CRUD operations**: Provides `createAssistant`, `updateAssistant`, `deleteAssistant`, and
+ *   `getAssistant` backed by the SDK, keeping local state in sync.
+ *
+ * Requires an {@link AxiomLatticeProvider} ancestor for the API client.
+ *
+ * @param props - {@link AssistantContextProviderProps}
+ * @param props.children - React children to render within the assistant context.
+ * @param props.autoLoad - Whether to automatically load assistants on mount. Defaults to `true`.
+ * @param props.initialAssistantId - Optional assistant ID to auto-select on load.
+ *
+ * @returns A React context provider wrapping children with {@link AssistantContext.Provider}.
+ *
+ * @example
+ * ```tsx
+ * <AssistantContextProvider initialAssistantId="asst_123">
+ *   <AssistantSelector />
+ * </AssistantContextProvider>
+ * ```
  */
-declare const LatticeChatShellContextProvider: ({ children, initialConfig, persistToLocalStorage, localStorageKey, }: LatticeChatShellContextProviderProps) => react_jsx_runtime.JSX.Element;
+declare const AssistantContextProvider: ({ children, autoLoad, initialAssistantId, }: AssistantContextProviderProps) => react_jsx_runtime.JSX.Element;
 /**
- * Hook to access LatticeChatShellContext
- * @returns Lattice Chat Shell context value
- * @throws Error if used outside of LatticeChatShellContextProvider
+ * Hook to access AssistantContext
+ * @returns Assistant context value
+ * @throws Error if used outside of AssistantContextProvider
  */
-declare const useLatticeChatShellContext: () => LatticeChatShellContextValue;
+declare const useAssistantContext: () => AssistantContextValue;
+
+interface Props$1 {
+    connectionType: string;
+    value?: string[];
+    onChange: (keys: string[]) => void;
+}
+declare const ConnectionListField: React__default.FC<Props$1>;
+
+interface ConnectionConfigDrawerContentProps {
+    connectionType: string;
+    title?: string;
+    onBack?: () => void;
+}
+declare const ConnectionConfigDrawerContent: React__default.FC<ConnectionConfigDrawerContentProps>;
+
+/**
+ * Connections Hub
+ *
+ * Lists all available connection types (from /api/middleware-types filtered by connectionSchema)
+ * and delegates to ConnectionConfigDrawerContent for the selected type.
+ */
+
+interface ConnectionsHubProps {
+    tenantId?: string;
+}
+declare const ConnectionsHub: React__default.FC<ConnectionsHubProps>;
 
 /**
  * Represents a single message in the chat UI.
@@ -3417,4 +3464,4 @@ type IframeMessage = {
 };
 declare function generateIframeSrcdoc(): string;
 
-export { type AgentChatProps, AgentConversations, type AgentConversationsProps, type AgentState, AgentThreadProvider, type AgentThreadProviderProps, AssistantContext, AssistantContextProvider, type AssistantContextProviderProps, type AssistantContextValue, AssistantFlow, type AssistantFlowProps, AssistantNode, type AssistantNodeData, type AssistantState, type AttachFile, type AuthContextValue, AuthProvider, AxiomLatticeProvider, type AxiomLatticeProviderProps, type BalanceResult, ChangePasswordModal, type ChangePasswordModalProps, ChannelInstallationsDrawerContent, ChatErrorBoundary, type ChatErrorBoundaryProps, type ChatResponse, ChatSidebar, type ChatSidebarProps, type ChatState, type ChatStateWithAgent, ChatUIContext, ChatUIContextProvider, Chating, type ChatingProps, type ClientConfig, ColumnLayout, type ColumnLayoutProps, ConversationContext, ConversationContextProvider, type ConversationContextProviderProps, type ConversationContextValue, type ConversationThread, CreateAssistantModal, DEFAULT_MENU_ITEMS, DEFAULT_MIDDLEWARE_TYPES, DEFAULT_WORKSPACE_MENU_ITEMS, type ElementMeta, type ElementProps, type EntityAction, EntityCard, EntityCreateTrigger, EntityListShell, EntityListView, EntityRow, EvalPanel, EvalRunResults, EvalSuiteCardList, EvalSuiteDetail, type ExplorerFile, FileExplorer, type FileExplorerProps, FilePanelToggle, type IframeMessage, LatticeAgentWorkspace, LatticeChat, LatticeChatShell, type LatticeChatShellConfig, LatticeChatShellContext, LatticeChatShellContextProvider, type LatticeChatShellContextProviderProps, type LatticeChatShellContextValue, type LatticeChatShellProps, LoginForm, type LoginFormProps, LoginPage, MDResponse, MDViewFormItem, MetricsConfigDrawerContent, type MiddlewareConfigDefinition, type MiddlewareConfigSchema, type MiddlewareConfigSchemaProperty, type MiddlewareToolDefinition, type MiddlewareTypeDefinition, type ModelConfig, type ModelInfo, ModelSelector, type ModelSelectorProps, type PanelCard, type PendingMessage, PersonalAssistantChannelModal, PersonalAssistantPage, ProtectedRoute, type ProtectedRouteProps, type QuickPromptCategory, type QuickPromptItem, RegisterForm, type RegisterFormProps, type ResourceFolderConfig, type SanitizerConfig, ScheduleButton, type ScheduleButtonProps, SideAppBrowserContext, type SideAppBrowserContextValue, SideAppViewBrowser, type SideMenuItemConfig, type SideMenuItemType, SkillCategoryPrompts, type SkillCategoryPromptsProps, SkillFlow, type SkillFlowProps, SkillNode, type SkillNodeData, type StreamEventHandlerOptions, type StreamingError, StreamingHTMLRenderer, type StreamingHTMLRendererProps, TenantSelector, type TenantSelectorProps, type ThreadState, type ToolCallData, type UIMessage, type UseAgentStateOptions, type UseAgentStateReturn, type UseApiOptions, type UseApiReturn, type UseAxiomLatticeOptions, type UseChatOptions, type UseTenantsOptions, type UseTenantsReturn, type UseUsersOptions, type UseUsersReturn, UserProfile, type UserProfileProps, type UserTenantInfo, type ViewMode, ViewToggle, WorkflowAutomationView, WorkflowCanvas, type WorkflowCanvasProps, WorkflowNode, type WorkflowNodeData, WorkspaceResourceManager, type WorkspaceResourceManagerProps, WorkspaceResourceUIContext, animation, axiomAntdTheme, axiomAntdThemeDark, axiomTokens, colors, generateIframeSrcdoc, generateLabelFromMessage, getAxiomAntdTheme, getElement, radius, regsiterElement, shadows, spacing, typography, useAgentChat, useAgentGraph, useAgentState, useAgentThreadContext, useApi, useAssistantContext, useAuth, useAuthOptional, useAxiomLattice, useAxiomTheme, useChat, useChatUIContext, useClient, useConversationContext, useEvalCases, useEvalProjects, useEvalRunStream, useEvalRuns, useEvalSuites, useLatticeChatShellContext, useSideAppBrowser, useSideAppOpener, useTenants, useUsers };
+export { type AgentChatProps, AgentConversations, type AgentConversationsProps, type AgentState, AgentThreadProvider, type AgentThreadProviderProps, AssistantContext, AssistantContextProvider, type AssistantContextProviderProps, type AssistantContextValue, AssistantFlow, type AssistantFlowProps, AssistantNode, type AssistantNodeData, type AssistantState, type AttachFile, type AuthContextValue, AuthProvider, AxiomLatticeProvider, type AxiomLatticeProviderProps, type BalanceResult, ChangePasswordModal, type ChangePasswordModalProps, ChannelInstallationsDrawerContent, ChatErrorBoundary, type ChatErrorBoundaryProps, type ChatResponse, ChatSidebar, type ChatSidebarProps, type ChatState, type ChatStateWithAgent, ChatUIContext, ChatUIContextProvider, Chating, type ChatingProps, type ClientConfig, ColumnLayout, type ColumnLayoutProps, ConnectionConfigDrawerContent, ConnectionListField, ConnectionsHub, ConversationContext, ConversationContextProvider, type ConversationContextProviderProps, type ConversationContextValue, type ConversationThread, CreateAssistantModal, DEFAULT_MENU_ITEMS, DEFAULT_MIDDLEWARE_TYPES, DEFAULT_WORKSPACE_MENU_ITEMS, type ElementMeta, type ElementProps, type EntityAction, EntityCard, EntityCreateTrigger, EntityListShell, EntityListView, EntityRow, EvalPanel, EvalRunResults, EvalSuiteCardList, EvalSuiteDetail, type ExplorerFile, FileExplorer, type FileExplorerProps, FilePanelToggle, type IframeMessage, LatticeAgentWorkspace, LatticeChat, LatticeChatShell, type LatticeChatShellConfig, LatticeChatShellContext, LatticeChatShellContextProvider, type LatticeChatShellContextProviderProps, type LatticeChatShellContextValue, type LatticeChatShellProps, LoginForm, type LoginFormProps, LoginPage, MDResponse, MDViewFormItem, MetricsConfigDrawerContent, type MiddlewareConfigDefinition, type MiddlewareConfigSchema, type MiddlewareConfigSchemaProperty, type MiddlewareToolDefinition, type MiddlewareTypeDefinition, type ModelConfig, type ModelInfo, ModelSelector, type ModelSelectorProps, type PanelCard, type PendingMessage, PersonalAssistantChannelModal, PersonalAssistantPage, ProtectedRoute, type ProtectedRouteProps, type QuickPromptCategory, type QuickPromptItem, RegisterForm, type RegisterFormProps, type ResourceFolderConfig, type SanitizerConfig, ScheduleButton, type ScheduleButtonProps, SideAppBrowserContext, type SideAppBrowserContextValue, SideAppViewBrowser, type SideMenuItemConfig, type SideMenuItemType, SkillCategoryPrompts, type SkillCategoryPromptsProps, SkillFlow, type SkillFlowProps, SkillNode, type SkillNodeData, type StreamEventHandlerOptions, type StreamingError, StreamingHTMLRenderer, type StreamingHTMLRendererProps, TenantSelector, type TenantSelectorProps, type ThreadState, type ToolCallData, type UIMessage, type UseAgentStateOptions, type UseAgentStateReturn, type UseApiOptions, type UseApiReturn, type UseAxiomLatticeOptions, type UseChatOptions, type UseTenantsOptions, type UseTenantsReturn, type UseUsersOptions, type UseUsersReturn, UserProfile, type UserProfileProps, type UserTenantInfo, type ViewMode, ViewToggle, WorkflowAutomationView, WorkflowCanvas, type WorkflowCanvasProps, WorkflowNode, type WorkflowNodeData, WorkspaceResourceManager, type WorkspaceResourceManagerProps, WorkspaceResourceUIContext, animation, axiomAntdTheme, axiomAntdThemeDark, axiomTokens, colors, generateIframeSrcdoc, generateLabelFromMessage, getAxiomAntdTheme, getElement, radius, regsiterElement, shadows, spacing, typography, useAgentChat, useAgentGraph, useAgentState, useAgentThreadContext, useApi, useAssistantContext, useAuth, useAuthOptional, useAxiomLattice, useAxiomTheme, useChat, useChatUIContext, useClient, useConversationContext, useEvalCases, useEvalProjects, useEvalRunStream, useEvalRuns, useEvalSuites, useLatticeChatShellContext, useMiddlewareTypes, useSideAppBrowser, useSideAppOpener, useTenants, useUsers };