@apteva/apteva-kit 0.1.102 → 0.1.105

package/LICENSE

@@ -0,0 +1,38 @@
+Apteva Source Available License
+Version 1.0
+
+Copyright (c) 2024-present Apteva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use
+the Software for personal, educational, or commercial purposes, subject to
+the following conditions:
+
+1. USE: You may use, copy, and run the Software in its original or compiled
+   form as part of your own applications.
+
+2. NO MODIFICATIONS: You may not modify, adapt, alter, transform, or create
+   derivative works based on the Software. The Software must be used as
+   provided.
+
+3. NO REDISTRIBUTION OF SOURCE: You may not redistribute, publish, or share
+   the source code of the Software, in whole or in part, except as part of
+   a reference to this official repository.
+
+4. ATTRIBUTION: If you use the Software in a product or service, you must
+   include appropriate attribution to Apteva in your documentation or about
+   page.
+
+5. NO SUBLICENSING: You may not sublicense the Software or grant rights to
+   third parties beyond what is permitted here.
+
+6. NO WARRANTY: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+   IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+   CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+   TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+   SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries or to request permission for uses not covered by
+this license, please contact: legal@apteva.com

package/README.md

@@ -156,6 +156,23 @@ npm run dev
 npm run type-check
 ```
 
+## Configuration
+
+Before using the components with a live API, configure the client:
+
+```tsx
+import { aptevaClient } from '@apteva/apteva-kit';
+
+aptevaClient.configure({
+  apiUrl: 'https://your-api-url.com/agents',
+  apiKey: 'your-api-key'
+});
+```
+
+All components also support a `useMock` prop for development without an API.
+
 ## License
 
-MIT
+This project is licensed under the [Apteva Source Available License](LICENSE).
+
+You are free to use this software in your applications, but modification and redistribution of the source code is not permitted. See the [LICENSE](LICENSE) file for details.

package/dist/index.d.mts

@@ -279,6 +279,7 @@ interface ChatProps {
     placeholder?: string;
     showHeader?: boolean;
     headerTitle?: string;
+    onHeaderBack?: () => void;
     enableFileUpload?: boolean;
     enableMarkdown?: boolean;
     enableWidgets?: boolean;
@@ -429,17 +430,165 @@ interface ButtonProps {
 }
 declare function Button({ widget, onAction }: ButtonProps): react_jsx_runtime.JSX.Element;
 
+interface PageLayoutProps {
+    title?: string;
+    padding?: 'none' | 'sm' | 'md' | 'lg';
+    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+}
+interface RowLayoutProps {
+    columns?: number[];
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+    align?: 'start' | 'center' | 'end' | 'stretch';
+}
+interface ColumnsLayoutProps {
+    count?: number;
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+}
+interface StackLayoutProps {
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+    align?: 'left' | 'center' | 'right' | 'stretch';
+}
+interface SidebarLayoutProps {
+    side?: 'left' | 'right';
+    width?: string;
+    collapsible?: boolean;
+}
+interface TabsLayoutProps {
+    labels: string[];
+    defaultTab?: number;
+}
+type LayoutType = 'page' | 'row' | 'columns' | 'stack' | 'sidebar' | 'tabs';
+interface InterfaceNode {
+    type: 'layout' | string;
+    id: string;
+    layout?: LayoutType;
+    props: Record<string, any>;
+    children?: InterfaceNode[];
+    actions?: Action[];
+    metadata?: Record<string, any>;
+    isStreaming?: boolean;
+}
+interface InterfaceSpec {
+    version: 1;
+    root: InterfaceNode;
+}
+interface InterfaceUpdate {
+    op: 'replace' | 'update' | 'remove' | 'append' | 'prepend';
+    target: string;
+    node?: InterfaceNode;
+    props?: Record<string, any>;
+}
+interface KpiWidget extends Widget {
+    type: 'kpi';
+    props: {
+        label: string;
+        value: string | number;
+        change?: string;
+        trend?: 'up' | 'down' | 'flat';
+        icon?: string;
+    };
+}
+interface TextBlockWidget extends Widget {
+    type: 'text_block';
+    props: {
+        content: string;
+        variant?: 'heading' | 'body' | 'caption';
+    };
+}
+interface SpacerWidget extends Widget {
+    type: 'spacer';
+    props: {
+        height?: 'sm' | 'md' | 'lg';
+        variant?: 'line' | 'space';
+    };
+}
+interface AutoInterfaceProps {
+    agentId: string;
+    threadId?: string | null;
+    initialPrompt?: string;
+    initialInterface?: InterfaceSpec;
+    context?: string;
+    apiUrl?: string;
+    apiKey?: string;
+    onInterfaceChange?: (spec: InterfaceSpec) => void;
+    onAction?: (action: ActionEvent) => void;
+    onThreadChange?: (threadId: string) => void;
+    onError?: (error: Error) => void;
+    chatPosition?: 'right' | 'bottom';
+    chatWidth?: string;
+    chatCollapsible?: boolean;
+    chatPlaceholder?: string;
+    chatWelcomeTitle?: string;
+    useMock?: boolean;
+    theme?: 'light' | 'dark' | 'auto';
+    className?: string;
+}
+
+interface KpiProps {
+    widget: KpiWidget;
+    onAction?: (action: ActionEvent) => void;
+}
+declare function Kpi({ widget, onAction }: KpiProps): react_jsx_runtime.JSX.Element;
+
+interface TextBlockProps {
+    widget: TextBlockWidget;
+}
+declare function TextBlock({ widget }: TextBlockProps): react_jsx_runtime.JSX.Element;
+
+interface SpacerProps {
+    widget: SpacerWidget;
+}
+declare function Spacer({ widget }: SpacerProps): react_jsx_runtime.JSX.Element;
+
 declare function Threads({ threads, currentThreadId, onThreadSelect, onThreadDelete, onNewThread, variant, showSearch, showNewButton, groupBy, className, }: ThreadsProps): react_jsx_runtime.JSX.Element;
 
+declare function AutoInterface({ agentId, threadId, initialPrompt, initialInterface, context, apiUrl, apiKey, onInterfaceChange, onAction, onThreadChange, onError, chatPosition, chatWidth, chatCollapsible, chatPlaceholder, chatWelcomeTitle, useMock, theme, className, }: AutoInterfaceProps): react_jsx_runtime.JSX.Element;
+
+interface InterfaceRendererProps {
+    node: InterfaceNode;
+    onAction?: (action: ActionEvent) => void;
+}
+declare function InterfaceRenderer({ node, onAction }: InterfaceRendererProps): react_jsx_runtime.JSX.Element;
+
+interface LayoutRendererProps {
+    node: InterfaceNode;
+    onAction?: (action: ActionEvent) => void;
+    renderNode: (node: InterfaceNode) => React.ReactNode;
+}
+declare function LayoutRenderer({ node, onAction, renderNode }: LayoutRendererProps): react_jsx_runtime.JSX.Element;
+
+interface InterfaceSkeletonProps {
+    className?: string;
+}
+declare function InterfaceSkeleton({ className }: InterfaceSkeletonProps): react_jsx_runtime.JSX.Element;
+
 declare function getThemeScript(): string;
 
 interface AptevaClientConfig {
     apiUrl?: string;
     apiKey?: string;
 }
+interface ResolvedConfig {
+    apiUrl: string;
+    apiKey: string;
+}
 interface ChatMessage {
     role: 'user' | 'assistant' | 'system';
-    content: string;
+    content: string | Array<{
+        type: 'text' | 'tool_use' | 'tool_result';
+        text?: string;
+        id?: string;
+        name?: string;
+        input?: any;
+        tool_use_id?: string;
+        content?: string | Array<{
+            type: string;
+            text?: string;
+        }>;
+        is_error?: boolean;
+    }>;
+    id?: string;
+    created_at?: string;
 }
 interface ChatRequest {
     agent_id: string;
@@ -477,7 +626,7 @@ interface StreamChunk {
 }
 declare class AptevaClient {
     private config;
-    constructor();
+    constructor(config?: AptevaClientConfig);
     /**
      * Update client configuration (optional - users can override defaults)
      */
@@ -485,7 +634,7 @@ declare class AptevaClient {
     /**
      * Get current configuration
      */
-    getConfig(): AptevaClientConfig;
+    getConfig(): ResolvedConfig;
     /**
      * Send a chat message to an agent
      */
@@ -509,10 +658,115 @@ declare class AptevaClient {
 }
 declare const aptevaClient: AptevaClient;
 
+declare function useInterfaceState(initialSpec?: InterfaceSpec | null): {
+    spec: InterfaceSpec | null;
+    isStreaming: boolean;
+    setInterface: (newSpec: InterfaceSpec) => void;
+    clearInterface: () => void;
+    applyInterfaceUpdate: (update: InterfaceUpdate) => void;
+    applyInterfaceUpdates: (updates: InterfaceUpdate[]) => void;
+    setIsStreaming: react.Dispatch<react.SetStateAction<boolean>>;
+    getNode: (id: string) => InterfaceNode | null;
+};
+
+interface UseInterfaceAIOptions {
+    agentId: string;
+    apiUrl?: string;
+    apiKey?: string;
+    context?: string;
+    onInterface?: (spec: InterfaceSpec) => void;
+    onUpdates?: (updates: InterfaceUpdate[]) => void;
+    onError?: (error: Error) => void;
+    onStreamStart?: () => void;
+    onStreamEnd?: () => void;
+}
+declare function useInterfaceAI({ agentId, apiUrl, apiKey, context, onInterface, onUpdates, onError, onStreamStart, onStreamEnd, }: UseInterfaceAIOptions): {
+    sendMessage: (message: string) => Promise<void>;
+    threadId: string | null;
+};
+
 declare function cn(...inputs: ClassValue[]): string;
 
 declare const mockMessages: Message[];
 declare const mockThreads: Thread[];
 declare const mockWidgets: Widget[];
 
-export { type Action, type ActionEvent, AptevaClient, type AptevaClientConfig, type AptevaKitControl, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatHandle, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, Command, type CommandProps, type CommandResult, type FlowStep, type FlowWidget, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, List, type ListItem, type ListWidget, type MapWidget, type Message, Prompt, type PromptProps, type SendMessageParams, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, aptevaClient, cn, getThemeScript, mockMessages, mockThreads, mockWidgets };
+/**
+ * Parse a full interface spec from text containing @interface[{...}]
+ */
+declare function parseInterfaceFromText(text: string): InterfaceSpec | null;
+/**
+ * Parse update operations from text containing @update[{...}] or @update[[{...}, ...]]
+ */
+declare function parseUpdatesFromText(text: string): InterfaceUpdate[];
+/**
+ * Check if text contains interface syntax
+ */
+declare function containsInterface(text: string): boolean;
+/**
+ * Strip interface syntax from text, returning only plain text
+ */
+declare function stripInterface(text: string): string;
+
+/**
+ * Generate system prompt context for AutoInterface mode
+ * Tells the AI how to generate full interfaces with layouts and widgets
+ */
+declare function generateInterfaceContext(): string;
+/**
+ * Compact version for the initial prompt (separate API call)
+ */
+declare function generateCompactInterfaceContext(): string;
+
+/**
+ * Find a node by ID in the interface tree
+ */
+declare function findNode(root: InterfaceNode, id: string): InterfaceNode | null;
+/**
+ * Apply a single update operation to an InterfaceSpec
+ */
+declare function applyUpdate(spec: InterfaceSpec, update: InterfaceUpdate): InterfaceSpec;
+/**
+ * Apply multiple updates in sequence
+ */
+declare function applyUpdates(spec: InterfaceSpec, updates: InterfaceUpdate[]): InterfaceSpec;
+
+/**
+ * A content block from the API message format.
+ * API messages can have `content` as either a string or an array of these blocks.
+ */
+interface ApiContentBlock {
+    type: 'text' | 'tool_use' | 'tool_result';
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: any;
+    tool_use_id?: string;
+    content?: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+    is_error?: boolean;
+}
+/**
+ * An API message as returned by the thread messages endpoint.
+ */
+interface ApiMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string | ApiContentBlock[];
+    id?: string;
+    created_at?: string;
+    timestamp?: string;
+}
+/**
+ * Convert API messages (from thread history) to internal Message format.
+ *
+ * Key transformations:
+ * - Simple string content messages map directly
+ * - Assistant messages with tool_use blocks become content_segments
+ * - User messages with tool_result blocks are merged into the previous
+ *   assistant message's tool segments (not shown as separate user messages)
+ */
+declare function convertApiMessages(apiMessages: ApiMessage[]): Message[];
+
+export { type Action, type ActionEvent, type ApiContentBlock, type ApiMessage, AptevaClient, type AptevaClientConfig, type AptevaKitControl, AutoInterface, type AutoInterfaceProps, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatHandle, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, type ColumnsLayoutProps, Command, type CommandProps, type CommandResult, type FlowStep, type FlowWidget, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, type InterfaceNode, InterfaceRenderer, InterfaceSkeleton, type InterfaceSpec, type InterfaceUpdate, Kpi, type KpiWidget, LayoutRenderer, type LayoutType, List, type ListItem, type ListWidget, type MapWidget, type Message, type PageLayoutProps, Prompt, type PromptProps, type RowLayoutProps, type SendMessageParams, type SidebarLayoutProps, Spacer, type SpacerWidget, type StackLayoutProps, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type TabsLayoutProps, TextBlock, type TextBlockWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, applyUpdate, applyUpdates, aptevaClient, cn, containsInterface, convertApiMessages, findNode, generateCompactInterfaceContext, generateInterfaceContext, getThemeScript, mockMessages, mockThreads, mockWidgets, parseInterfaceFromText, parseUpdatesFromText, stripInterface, useInterfaceAI, useInterfaceState };

package/dist/index.d.ts

@@ -279,6 +279,7 @@ interface ChatProps {
     placeholder?: string;
     showHeader?: boolean;
     headerTitle?: string;
+    onHeaderBack?: () => void;
     enableFileUpload?: boolean;
     enableMarkdown?: boolean;
     enableWidgets?: boolean;
@@ -429,17 +430,165 @@ interface ButtonProps {
 }
 declare function Button({ widget, onAction }: ButtonProps): react_jsx_runtime.JSX.Element;
 
+interface PageLayoutProps {
+    title?: string;
+    padding?: 'none' | 'sm' | 'md' | 'lg';
+    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+}
+interface RowLayoutProps {
+    columns?: number[];
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+    align?: 'start' | 'center' | 'end' | 'stretch';
+}
+interface ColumnsLayoutProps {
+    count?: number;
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+}
+interface StackLayoutProps {
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+    align?: 'left' | 'center' | 'right' | 'stretch';
+}
+interface SidebarLayoutProps {
+    side?: 'left' | 'right';
+    width?: string;
+    collapsible?: boolean;
+}
+interface TabsLayoutProps {
+    labels: string[];
+    defaultTab?: number;
+}
+type LayoutType = 'page' | 'row' | 'columns' | 'stack' | 'sidebar' | 'tabs';
+interface InterfaceNode {
+    type: 'layout' | string;
+    id: string;
+    layout?: LayoutType;
+    props: Record<string, any>;
+    children?: InterfaceNode[];
+    actions?: Action[];
+    metadata?: Record<string, any>;
+    isStreaming?: boolean;
+}
+interface InterfaceSpec {
+    version: 1;
+    root: InterfaceNode;
+}
+interface InterfaceUpdate {
+    op: 'replace' | 'update' | 'remove' | 'append' | 'prepend';
+    target: string;
+    node?: InterfaceNode;
+    props?: Record<string, any>;
+}
+interface KpiWidget extends Widget {
+    type: 'kpi';
+    props: {
+        label: string;
+        value: string | number;
+        change?: string;
+        trend?: 'up' | 'down' | 'flat';
+        icon?: string;
+    };
+}
+interface TextBlockWidget extends Widget {
+    type: 'text_block';
+    props: {
+        content: string;
+        variant?: 'heading' | 'body' | 'caption';
+    };
+}
+interface SpacerWidget extends Widget {
+    type: 'spacer';
+    props: {
+        height?: 'sm' | 'md' | 'lg';
+        variant?: 'line' | 'space';
+    };
+}
+interface AutoInterfaceProps {
+    agentId: string;
+    threadId?: string | null;
+    initialPrompt?: string;
+    initialInterface?: InterfaceSpec;
+    context?: string;
+    apiUrl?: string;
+    apiKey?: string;
+    onInterfaceChange?: (spec: InterfaceSpec) => void;
+    onAction?: (action: ActionEvent) => void;
+    onThreadChange?: (threadId: string) => void;
+    onError?: (error: Error) => void;
+    chatPosition?: 'right' | 'bottom';
+    chatWidth?: string;
+    chatCollapsible?: boolean;
+    chatPlaceholder?: string;
+    chatWelcomeTitle?: string;
+    useMock?: boolean;
+    theme?: 'light' | 'dark' | 'auto';
+    className?: string;
+}
+
+interface KpiProps {
+    widget: KpiWidget;
+    onAction?: (action: ActionEvent) => void;
+}
+declare function Kpi({ widget, onAction }: KpiProps): react_jsx_runtime.JSX.Element;
+
+interface TextBlockProps {
+    widget: TextBlockWidget;
+}
+declare function TextBlock({ widget }: TextBlockProps): react_jsx_runtime.JSX.Element;
+
+interface SpacerProps {
+    widget: SpacerWidget;
+}
+declare function Spacer({ widget }: SpacerProps): react_jsx_runtime.JSX.Element;
+
 declare function Threads({ threads, currentThreadId, onThreadSelect, onThreadDelete, onNewThread, variant, showSearch, showNewButton, groupBy, className, }: ThreadsProps): react_jsx_runtime.JSX.Element;
 
+declare function AutoInterface({ agentId, threadId, initialPrompt, initialInterface, context, apiUrl, apiKey, onInterfaceChange, onAction, onThreadChange, onError, chatPosition, chatWidth, chatCollapsible, chatPlaceholder, chatWelcomeTitle, useMock, theme, className, }: AutoInterfaceProps): react_jsx_runtime.JSX.Element;
+
+interface InterfaceRendererProps {
+    node: InterfaceNode;
+    onAction?: (action: ActionEvent) => void;
+}
+declare function InterfaceRenderer({ node, onAction }: InterfaceRendererProps): react_jsx_runtime.JSX.Element;
+
+interface LayoutRendererProps {
+    node: InterfaceNode;
+    onAction?: (action: ActionEvent) => void;
+    renderNode: (node: InterfaceNode) => React.ReactNode;
+}
+declare function LayoutRenderer({ node, onAction, renderNode }: LayoutRendererProps): react_jsx_runtime.JSX.Element;
+
+interface InterfaceSkeletonProps {
+    className?: string;
+}
+declare function InterfaceSkeleton({ className }: InterfaceSkeletonProps): react_jsx_runtime.JSX.Element;
+
 declare function getThemeScript(): string;
 
 interface AptevaClientConfig {
     apiUrl?: string;
     apiKey?: string;
 }
+interface ResolvedConfig {
+    apiUrl: string;
+    apiKey: string;
+}
 interface ChatMessage {
     role: 'user' | 'assistant' | 'system';
-    content: string;
+    content: string | Array<{
+        type: 'text' | 'tool_use' | 'tool_result';
+        text?: string;
+        id?: string;
+        name?: string;
+        input?: any;
+        tool_use_id?: string;
+        content?: string | Array<{
+            type: string;
+            text?: string;
+        }>;
+        is_error?: boolean;
+    }>;
+    id?: string;
+    created_at?: string;
 }
 interface ChatRequest {
     agent_id: string;
@@ -477,7 +626,7 @@ interface StreamChunk {
 }
 declare class AptevaClient {
     private config;
-    constructor();
+    constructor(config?: AptevaClientConfig);
     /**
      * Update client configuration (optional - users can override defaults)
      */
@@ -485,7 +634,7 @@ declare class AptevaClient {
     /**
      * Get current configuration
      */
-    getConfig(): AptevaClientConfig;
+    getConfig(): ResolvedConfig;
     /**
      * Send a chat message to an agent
      */
@@ -509,10 +658,115 @@ declare class AptevaClient {
 }
 declare const aptevaClient: AptevaClient;
 
+declare function useInterfaceState(initialSpec?: InterfaceSpec | null): {
+    spec: InterfaceSpec | null;
+    isStreaming: boolean;
+    setInterface: (newSpec: InterfaceSpec) => void;
+    clearInterface: () => void;
+    applyInterfaceUpdate: (update: InterfaceUpdate) => void;
+    applyInterfaceUpdates: (updates: InterfaceUpdate[]) => void;
+    setIsStreaming: react.Dispatch<react.SetStateAction<boolean>>;
+    getNode: (id: string) => InterfaceNode | null;
+};
+
+interface UseInterfaceAIOptions {
+    agentId: string;
+    apiUrl?: string;
+    apiKey?: string;
+    context?: string;
+    onInterface?: (spec: InterfaceSpec) => void;
+    onUpdates?: (updates: InterfaceUpdate[]) => void;
+    onError?: (error: Error) => void;
+    onStreamStart?: () => void;
+    onStreamEnd?: () => void;
+}
+declare function useInterfaceAI({ agentId, apiUrl, apiKey, context, onInterface, onUpdates, onError, onStreamStart, onStreamEnd, }: UseInterfaceAIOptions): {
+    sendMessage: (message: string) => Promise<void>;
+    threadId: string | null;
+};
+
 declare function cn(...inputs: ClassValue[]): string;
 
 declare const mockMessages: Message[];
 declare const mockThreads: Thread[];
 declare const mockWidgets: Widget[];
 
-export { type Action, type ActionEvent, AptevaClient, type AptevaClientConfig, type AptevaKitControl, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatHandle, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, Command, type CommandProps, type CommandResult, type FlowStep, type FlowWidget, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, List, type ListItem, type ListWidget, type MapWidget, type Message, Prompt, type PromptProps, type SendMessageParams, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, aptevaClient, cn, getThemeScript, mockMessages, mockThreads, mockWidgets };
+/**
+ * Parse a full interface spec from text containing @interface[{...}]
+ */
+declare function parseInterfaceFromText(text: string): InterfaceSpec | null;
+/**
+ * Parse update operations from text containing @update[{...}] or @update[[{...}, ...]]
+ */
+declare function parseUpdatesFromText(text: string): InterfaceUpdate[];
+/**
+ * Check if text contains interface syntax
+ */
+declare function containsInterface(text: string): boolean;
+/**
+ * Strip interface syntax from text, returning only plain text
+ */
+declare function stripInterface(text: string): string;
+
+/**
+ * Generate system prompt context for AutoInterface mode
+ * Tells the AI how to generate full interfaces with layouts and widgets
+ */
+declare function generateInterfaceContext(): string;
+/**
+ * Compact version for the initial prompt (separate API call)
+ */
+declare function generateCompactInterfaceContext(): string;
+
+/**
+ * Find a node by ID in the interface tree
+ */
+declare function findNode(root: InterfaceNode, id: string): InterfaceNode | null;
+/**
+ * Apply a single update operation to an InterfaceSpec
+ */
+declare function applyUpdate(spec: InterfaceSpec, update: InterfaceUpdate): InterfaceSpec;
+/**
+ * Apply multiple updates in sequence
+ */
+declare function applyUpdates(spec: InterfaceSpec, updates: InterfaceUpdate[]): InterfaceSpec;
+
+/**
+ * A content block from the API message format.
+ * API messages can have `content` as either a string or an array of these blocks.
+ */
+interface ApiContentBlock {
+    type: 'text' | 'tool_use' | 'tool_result';
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: any;
+    tool_use_id?: string;
+    content?: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+    is_error?: boolean;
+}
+/**
+ * An API message as returned by the thread messages endpoint.
+ */
+interface ApiMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string | ApiContentBlock[];
+    id?: string;
+    created_at?: string;
+    timestamp?: string;
+}
+/**
+ * Convert API messages (from thread history) to internal Message format.
+ *
+ * Key transformations:
+ * - Simple string content messages map directly
+ * - Assistant messages with tool_use blocks become content_segments
+ * - User messages with tool_result blocks are merged into the previous
+ *   assistant message's tool segments (not shown as separate user messages)
+ */
+declare function convertApiMessages(apiMessages: ApiMessage[]): Message[];
+
+export { type Action, type ActionEvent, type ApiContentBlock, type ApiMessage, AptevaClient, type AptevaClientConfig, type AptevaKitControl, AutoInterface, type AutoInterfaceProps, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatHandle, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, type ColumnsLayoutProps, Command, type CommandProps, type CommandResult, type FlowStep, type FlowWidget, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, type InterfaceNode, InterfaceRenderer, InterfaceSkeleton, type InterfaceSpec, type InterfaceUpdate, Kpi, type KpiWidget, LayoutRenderer, type LayoutType, List, type ListItem, type ListWidget, type MapWidget, type Message, type PageLayoutProps, Prompt, type PromptProps, type RowLayoutProps, type SendMessageParams, type SidebarLayoutProps, Spacer, type SpacerWidget, type StackLayoutProps, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type TabsLayoutProps, TextBlock, type TextBlockWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, applyUpdate, applyUpdates, aptevaClient, cn, containsInterface, convertApiMessages, findNode, generateCompactInterfaceContext, generateInterfaceContext, getThemeScript, mockMessages, mockThreads, mockWidgets, parseInterfaceFromText, parseUpdatesFromText, stripInterface, useInterfaceAI, useInterfaceState };