@axiom-lattice/react-sdk 2.0.3 → 2.1.0

package/README.md

@@ -333,6 +333,33 @@ function AgentGraph() {
 }
 ```
 
+### File Explorer Component
+
+Use the `FileExplorer` component to display and explore files from the agent state:
+
+```tsx
+import { FileExplorer, useChat } from "@axiom-lattice/react-sdk";
+
+function AgentFiles({ threadId }) {
+  // Ensure enableReturnStateWhenStreamCompleted is true to get the agent state
+  const { agentState } = useChat(threadId, {
+    streaming: true,
+    enableReturnStateWhenStreamCompleted: true,
+  });
+
+  // Extract files from agent state values
+  // Assuming agent returns files in agentState.values.files
+  const files = agentState?.values?.files || [];
+
+  return (
+    <div style={{ height: "500px" }}>
+      <h3>Agent Files</h3>
+      <FileExplorer files={files} />
+    </div>
+  );
+}
+```
+
 ## Complete Example
 
 See the `examples` directory for a complete example of a chat application using the React SDK.

package/dist/index.d.mts

@@ -72,6 +72,10 @@ interface AgentState {
  * Chat hook state
  */
 interface ChatState {
+    todos?: Array<{
+        content: string;
+        status: "pending" | "in_progress" | "completed";
+    }>;
     /**
      * Array of messages in the chat
      */
@@ -344,16 +348,28 @@ type ElementProps<T = any> = {
     interactive?: boolean;
     default_open_in_side_app?: boolean;
 };
-
 interface ElementMeta {
     card_view: React.FC<ElementProps>;
     side_app_view?: React.FC<ElementProps>;
     action?: (data: any) => void;
 }
-declare const elements: Record<string, ElementMeta>;
+interface ToolCallData {
+    id: string;
+    name: string;
+    args: Record<string, any>;
+    type: "tool_call";
+    response?: string;
+    status?: "success" | "pending" | "error";
+}
+
 declare const getElement: (language: string | undefined) => ElementMeta | null;
 declare const regsiterElement: (language: string, ElementMeta: ElementMeta) => ElementMeta;
 
+interface TodoItem {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+}
+
 interface ChatingProps {
     name?: string;
     description?: string;
@@ -378,6 +394,8 @@ interface ChatingProps {
     extraMeta?: Array<{
         id: string;
     }>;
+    files?: any;
+    todos?: TodoItem[];
 }
 declare const Chating: React__default.FC<ChatingProps>;
 
@@ -424,4 +442,19 @@ declare const chatContext: React$1.Context<{
     eventHandler: (component_key: string, data: any, message: string) => void;
 }>;
 
-export { type AgentState, type AttachFile, AxiomLatticeProvider, type AxiomLatticeProviderProps, type ChatResponse, type ChatState, type ChatStateWithAgent, Chating, type ClientConfig, type ElementEventHandler, type ElementProps, MDMermaid, MDResponse, MDViewFormItem, SideAppViewBrowser, type StreamEventHandlerOptions, ThinkingChain, ThinkingChainGroup, type Thread, type ThreadState, type UIMessage, type UseAgentStateOptions, type UseAgentStateReturn, type UseChatOptions, chatContext, elements, getElement, regsiterElement, useAgentGraph, useAgentState, useAxiomLattice, useChat, useThread };
+interface ExplorerFile {
+    name: string;
+    content: string[];
+    language?: string;
+    created_at?: string;
+    modified_at?: string;
+}
+interface FileExplorerProps {
+    files?: Record<string, ExplorerFile>;
+    className?: string;
+    style?: React__default.CSSProperties;
+    title?: string;
+}
+declare const FileExplorer: React__default.FC<ElementProps>;
+
+export { type AgentState, type AttachFile, AxiomLatticeProvider, type AxiomLatticeProviderProps, type ChatResponse, type ChatState, type ChatStateWithAgent, Chating, type ClientConfig, type ElementEventHandler, type ElementMeta, type ElementProps, type ExplorerFile, FileExplorer, type FileExplorerProps, MDMermaid, MDResponse, MDViewFormItem, SideAppViewBrowser, type StreamEventHandlerOptions, ThinkingChain, ThinkingChainGroup, type Thread, type ThreadState, type ToolCallData, type UIMessage, type UseAgentStateOptions, type UseAgentStateReturn, type UseChatOptions, chatContext, getElement, regsiterElement, useAgentGraph, useAgentState, useAxiomLattice, useChat, useThread };

package/dist/index.d.ts

@@ -72,6 +72,10 @@ interface AgentState {
  * Chat hook state
  */
 interface ChatState {
+    todos?: Array<{
+        content: string;
+        status: "pending" | "in_progress" | "completed";
+    }>;
     /**
      * Array of messages in the chat
      */
@@ -344,16 +348,28 @@ type ElementProps<T = any> = {
     interactive?: boolean;
     default_open_in_side_app?: boolean;
 };
-
 interface ElementMeta {
     card_view: React.FC<ElementProps>;
     side_app_view?: React.FC<ElementProps>;
     action?: (data: any) => void;
 }
-declare const elements: Record<string, ElementMeta>;
+interface ToolCallData {
+    id: string;
+    name: string;
+    args: Record<string, any>;
+    type: "tool_call";
+    response?: string;
+    status?: "success" | "pending" | "error";
+}
+
 declare const getElement: (language: string | undefined) => ElementMeta | null;
 declare const regsiterElement: (language: string, ElementMeta: ElementMeta) => ElementMeta;
 
+interface TodoItem {
+    content: string;
+    status: "completed" | "in_progress" | "pending";
+}
+
 interface ChatingProps {
     name?: string;
     description?: string;
@@ -378,6 +394,8 @@ interface ChatingProps {
     extraMeta?: Array<{
         id: string;
     }>;
+    files?: any;
+    todos?: TodoItem[];
 }
 declare const Chating: React__default.FC<ChatingProps>;
 
@@ -424,4 +442,19 @@ declare const chatContext: React$1.Context<{
     eventHandler: (component_key: string, data: any, message: string) => void;
 }>;
 
-export { type AgentState, type AttachFile, AxiomLatticeProvider, type AxiomLatticeProviderProps, type ChatResponse, type ChatState, type ChatStateWithAgent, Chating, type ClientConfig, type ElementEventHandler, type ElementProps, MDMermaid, MDResponse, MDViewFormItem, SideAppViewBrowser, type StreamEventHandlerOptions, ThinkingChain, ThinkingChainGroup, type Thread, type ThreadState, type UIMessage, type UseAgentStateOptions, type UseAgentStateReturn, type UseChatOptions, chatContext, elements, getElement, regsiterElement, useAgentGraph, useAgentState, useAxiomLattice, useChat, useThread };
+interface ExplorerFile {
+    name: string;
+    content: string[];
+    language?: string;
+    created_at?: string;
+    modified_at?: string;
+}
+interface FileExplorerProps {
+    files?: Record<string, ExplorerFile>;
+    className?: string;
+    style?: React__default.CSSProperties;
+    title?: string;
+}
+declare const FileExplorer: React__default.FC<ElementProps>;
+
+export { type AgentState, type AttachFile, AxiomLatticeProvider, type AxiomLatticeProviderProps, type ChatResponse, type ChatState, type ChatStateWithAgent, Chating, type ClientConfig, type ElementEventHandler, type ElementMeta, type ElementProps, type ExplorerFile, FileExplorer, type FileExplorerProps, MDMermaid, MDResponse, MDViewFormItem, SideAppViewBrowser, type StreamEventHandlerOptions, ThinkingChain, ThinkingChainGroup, type Thread, type ThreadState, type ToolCallData, type UIMessage, type UseAgentStateOptions, type UseAgentStateReturn, type UseChatOptions, chatContext, getElement, regsiterElement, useAgentGraph, useAgentState, useAxiomLattice, useChat, useThread };