@teodorruskvi/chat-core 0.1.2

package/dist/lib/core.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Core (UI-agnostic) exports.
+ * Keep this entry free of UI component dependencies.
+ */
+export * from "./utils";
+export * from "../shared/utils/jsonUtils";
+export type * from "../types";
+export { getToolCalls, getToolCallArtifacts } from "../shared/core/utils/toolCallUtils";
+export { useFilePreview, useParsedMessageContent, useToolPayload, useChatController, useChatSession, } from "../features/conversation/hooks";
+export { useMessageContent, useStreamingMarkdownBuffer } from "../features/conversation/messages/hooks";
+export { useStream } from "../features/streaming";
+export * from "../features/streaming/utils";
+export * from "../features/thread/hooks/useThreadsState";
+export * from "../features/thread/hooks/useThreadHistoryState";
+export { ThreadsProvider, useThreads } from "../features/conversation/contexts/ThreadsProvider";
+export { ThreadStateProvider, useThreadState, useThreadStateUpdater, } from "../features/conversation/contexts/ThreadStateProvider";
+export { getMessageAttemptInfo } from "../features/persistence/checkpoints/utils/checkpointIndex";
+export { hydrateHistorySnapshots, type HistoryHydrationResult, } from "../features/persistence/checkpoints/utils/historyUtils";
+export * from "../features/conversation/messages/utils/messageUtils";
+export * from "../shared/core/utils/metaUtils";
+export { ChatProviders, type ChatProvidersProps } from "../shared/core/contexts";
+export { useApi } from "../shared/core/hooks";
+export type { EditMeta } from "../features/persistence/checkpoints/types";
+export { getChatToken, setChatToken, onChatTokenChanged } from "../shared/core/api/utils";
+export type { ToolRendererMap, ToolArtifactRendererMap, ToolRenderer, ToolArtifactRenderer, ToolRendererContext, ToolConfig, BuildToolConfigOptions, } from "../features/conversation/messages/renderers/tooling/ToolContent";
+export type { ThreadStateValues } from "../types";

package/dist/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/shared/core/api/clients/authClient.d.ts

@@ -0,0 +1,13 @@
+import type { ApiConfig } from "@/types/core/context";
+import type { User } from "@/types/api";
+export declare class AuthApi {
+    private _authBaseUrl;
+    get baseUrl(): string;
+    updateConfig(config: ApiConfig): void;
+    getAuthToken(): string | null;
+    setAuthToken(token: string | null): void;
+    onTokenChange(callback: (token: string | null) => void): () => void;
+    listUsers(): Promise<User[]>;
+}
+export declare const authApiClient: AuthApi;
+export default authApiClient;

package/dist/shared/core/api/clients/chatClient.d.ts

@@ -0,0 +1,50 @@
+import type { AgentDetail, AgentSchemaInfo, AgentSummary } from "@/types/api";
+import type { TokenListener } from "@/types/core/models";
+import type { ApiConfig } from "@/types/core/context";
+import type { HistoryPayload, SharedThreadSummary, CheckpointSnapshot, ThreadSummary } from "@/types/api";
+import type { ThreadInfo, ThreadShareResponse } from "@/types/api";
+import { getChatToken, onChatTokenChanged, setChatToken } from "../utils";
+export declare class ChatApi {
+    get baseUrl(): string;
+    updateConfig(config: ApiConfig): void;
+    getAuthToken(): string | null;
+    setAuthToken(token: string | null): void;
+    onTokenChange(callback: TokenListener): () => void;
+    listThreads(): Promise<ThreadSummary[]>;
+    listSharedThreads(): Promise<SharedThreadSummary[]>;
+    createThread(title?: string, project?: {
+        id: string;
+        name: string;
+    }): Promise<ThreadInfo>;
+    updateThread(threadId: string, title: string): Promise<ThreadInfo>;
+    deleteThread(threadId: string): Promise<{
+        ok: boolean;
+        threadId: string;
+    }>;
+    shareThread(threadId: string, sharedWithUserId: string): Promise<ThreadShareResponse>;
+    threadInfo(threadId: string): Promise<ThreadInfo>;
+    listAgents(): Promise<AgentSummary[]>;
+    getAgent(agentId: string): Promise<AgentDetail>;
+    getAgentSchema(agentId: string): Promise<AgentSchemaInfo>;
+    getState(params: {
+        threadId: string;
+        checkpointId?: string;
+        checkpointNs?: string;
+    }): Promise<CheckpointSnapshot>;
+    getStateHistory(params: {
+        threadId: string;
+        checkpointId?: string;
+        checkpointNs?: string;
+        signal?: AbortSignal;
+    }): Promise<HistoryPayload>;
+    cancelRun(threadId: string): Promise<{
+        status: string;
+    }>;
+    unshareThread(threadId: string, shareId: string): Promise<{
+        ok: boolean;
+        shareId: string;
+    }>;
+}
+export declare const chatApiClient: ChatApi;
+export default chatApiClient;
+export { getChatToken, onChatTokenChanged, setChatToken };

package/dist/shared/core/api/clients/fileClient.d.ts

@@ -0,0 +1,12 @@
+export declare class FileApi {
+    fetchFileBlob(path: string, onProgress?: (p: number) => void): Promise<Blob>;
+    viewFileById(fileId: number | string, onProgress?: (p: number) => void): Promise<void>;
+    getFileBlob(fileId: number | string, onProgress?: (p: number) => void): Promise<Blob>;
+    getFileContent(fileId: number | string, onProgress?: (p: number) => void): Promise<string>;
+    downloadFileById(fileId: number | string, onProgress?: (p: number) => void): Promise<void>;
+    getFileInfo(fileId: number | string): Promise<any>;
+    listFiles(threadId?: string | null, limit?: number, offset?: number): Promise<any[]>;
+    uploadFile(file: File, threadId?: string | null, onProgress?: (p: number) => void): Promise<any>;
+}
+export declare const fileApiClient: FileApi;
+export default fileApiClient;

package/dist/shared/core/api/clients/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./chatClient";
+export * from "./fileClient";

package/dist/shared/core/api/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./clients";
+export * from "./utils";

package/dist/shared/core/api/utils/http.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Chat-only API Client
+ *
+ * This client only handles chat-related operations. Authentication is handled
+ * by the host application which passes tokens via apiConfig.
+ */
+import type { TokenListener } from "@/types/core/models";
+import { AxiosInstance, AxiosRequestConfig } from "axios";
+export declare function getChatToken(): string | null;
+export declare function setChatToken(token: string | null): void;
+export declare function onChatTokenChanged(callback: TokenListener): () => void;
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const HISTORY_TIMEOUT_MS = 90000;
+declare const httpClient: AxiosInstance;
+export declare function get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+export declare function post<T = unknown, B = unknown>(url: string, body?: B, config?: AxiosRequestConfig): Promise<T>;
+export declare function put<T = unknown, B = unknown>(url: string, body?: B, config?: AxiosRequestConfig): Promise<T>;
+export declare function del<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<T>;
+export declare function unwrap<T>(response: unknown): T;
+export { httpClient };

package/dist/shared/core/api/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./http";

package/dist/shared/core/constants/env.d.ts

@@ -0,0 +1,39 @@
+import type { ApiConfig } from "@/types/core";
+/**
+ * Get the default API configuration from runtime globals (if provided)
+ */
+export declare function getDefaultApiConfig(): ApiConfig;
+/**
+ * Default settings that integrate with the API client
+ */
+export interface ChatConfig {
+    apiBaseUrl: string;
+    apiKey: string;
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    layoutSize: 'phone' | 'tablet' | 'desktop' | 'half-screen';
+    showThreads: boolean;
+    autoScrollMessages: boolean;
+    darkMode: boolean;
+    enableSound: boolean;
+    messageHistory: number;
+}
+/**
+ * Create default settings using environment and API client state
+ */
+export declare function getDefaultChatSettings(): ChatConfig;
+/**
+ * Settings persistence utilities
+ */
+export declare const SETTINGS_STORAGE_KEY: string;
+export declare function loadStoredSettings(): Partial<ChatConfig>;
+export declare function saveSettings(settings: ChatConfig): void;
+/**
+ * Get merged settings (defaults + stored + current API state)
+ */
+export declare function getCurrentSettings(): ChatConfig;
+/**
+ * Apply settings to the API client and save to storage
+ */
+export declare function applySettings(settings: ChatConfig): void;

package/dist/shared/core/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./env";
+export * from "./storage";

package/dist/shared/core/constants/storage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Centralized localStorage keys for the chat UI.
+ * Keep all key names and builders in one place to avoid drift.
+ */
+export declare const STORAGE_KEYS: {
+    authToken: string;
+    authTokenExpiresAt: string;
+    authSessionId: string;
+    chatSettings: string;
+    threadManagerView: string;
+    playgroundSettings: string;
+    debugLogs: string;
+};
+export declare function draftKey(threadId: string): string;

package/dist/shared/core/contexts/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Public API entry point for shared contexts.
+ */
+export { ApiProvider, ChatProviders, useHasChatSession, useStream, useThreadState, useThreads, type ChatProvidersProps } from './providers';

package/dist/shared/core/contexts/providers/ApiProvider.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ApiProvider - Lowest level context providing API client and auth token
+ */
+import type { ApiConfig, ApiContextValue } from '@/types/core';
+import { type ReactNode } from 'react';
+export declare const ApiContext: import("react").Context<ApiContextValue | null>;
+export interface ApiProviderProps {
+    children: ReactNode;
+    apiConfig?: ApiConfig;
+}
+export declare function ApiProvider({ children, apiConfig }: ApiProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/shared/core/contexts/providers/ChatProviders.d.ts

@@ -0,0 +1,25 @@
+import type { ApiConfig } from '@/types/core';
+import type { ToolEndEvent } from '@/features/streaming';
+import type { StreamEvent, StreamFinishInfo } from '@/types/domain/streaming';
+import { type ReactNode } from 'react';
+export interface ChatProvidersProps {
+    children: ReactNode;
+    apiConfig?: ApiConfig;
+    initialThreadId?: string | null;
+    initialCheckpointId?: string | null;
+    initialCheckpointNs?: string | null;
+    autoLoadInitial?: boolean;
+    onConnectionError?: (error: string) => void;
+    onError?: (error: string) => void;
+    onAuthError?: (error: string) => void;
+    onThreadChange?: (threadId: string | null) => void;
+    onToolEnd?: (event: ToolEndEvent) => void;
+    onUpdateEvent?: (event: StreamEvent) => void;
+    onCustomEvent?: (event: StreamEvent) => void;
+    onMetadataEvent?: (event: StreamEvent) => void;
+    onFinish?: (info: StreamFinishInfo) => void;
+}
+export declare function ChatProviders({ children, apiConfig, initialThreadId, initialCheckpointId, initialCheckpointNs, autoLoadInitial, onConnectionError, onError, onAuthError, onThreadChange, onToolEnd, onUpdateEvent, onCustomEvent, onMetadataEvent, onFinish, }: ChatProvidersProps): import("react/jsx-runtime").JSX.Element;
+export { useApi } from '@/shared/core/hooks';
+export { useStream, useHasChatSession } from '@/features/streaming';
+export { useThreads, useThreadState } from '@/features/conversation/contexts';

package/dist/shared/core/contexts/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { ApiContext, ApiProvider } from "./ApiProvider";
+export { ChatProviders, useHasChatSession, useStream, useThreadState, useThreads, type ChatProvidersProps } from "./ChatProviders";

package/dist/shared/core/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useApi } from './useApi';
+export { useShallowStableValue } from './useShallowStableValue';

package/dist/shared/core/hooks/useApi.d.ts

@@ -0,0 +1 @@
+export declare function useApi(): import("..").ApiContextValue;

package/dist/shared/core/hooks/useShallowStableValue.d.ts

@@ -0,0 +1 @@
+export declare function useShallowStableValue<T>(value: T): T;

package/dist/shared/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./api";
+export * from "./contexts";
+export * from "./hooks";
+export * from "./types";
+export * from "./utils";
+export * from "./constants";

package/dist/shared/core/types/index.d.ts

@@ -0,0 +1 @@
+export * from "@/types/core";

package/dist/shared/core/utils/caseUtils.d.ts

@@ -0,0 +1 @@
+export declare function toCamel(value: string): string;

package/dist/shared/core/utils/chatUtils.d.ts

@@ -0,0 +1,10 @@
+import type { MessagePart } from "@/types";
+export declare function fileToBase64(file: File): Promise<string>;
+export declare function processAttachments(files?: File[]): Promise<{
+    contentParts: MessagePart[];
+    filesInfo: Array<{
+        filename: string;
+        data: string;
+        mime_type: string;
+    }>;
+}>;

package/dist/shared/core/utils/guards.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessage, MessagePart, TextPart, ImagePart, FilePart } from "@/types";
+export declare function isHumanMessage(msg: ChatMessage): boolean;
+export declare function isAIMessage(msg: ChatMessage): boolean;
+export declare function isSystemMessage(msg: ChatMessage): boolean;
+export declare function isToolMessage(msg: ChatMessage): boolean;
+export declare function isTextPart(part: MessagePart): part is TextPart;
+export declare function isImagePart(part: MessagePart): part is ImagePart;
+export declare function isFilePart(part: MessagePart): part is FilePart;

package/dist/shared/core/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./chatUtils";
+export * from "./toolFormatting";
+export * from "./normalizationUtils";
+export * from "./caseUtils";
+export * from "./guards";
+export * from "./parsers";
+export * from "./metaUtils";
+export * from "./toolCallUtils";

package/dist/shared/core/utils/messageFactory.d.ts

@@ -0,0 +1,14 @@
+import type { ChatMessage, MessagePart, Role } from "@/types";
+/**
+ * Creates a standard ChatMessage object with a generated ID and timestamp.
+ */
+export declare function createMessage(role: Role, content: string | MessagePart[], options?: Partial<Omit<ChatMessage, "id" | "role" | "content" | "createdAt">>): ChatMessage;
+/**
+ * Normalizes input content into a standard MessagePart array.
+ */
+export declare function normalizeContent(content: string | MessagePart[]): MessagePart[];
+/**
+ * Normalizes a potential message input (string or partial object) into a full ChatMessage.
+ * useful for polymorphic APIs that accept string | ChatMessage.
+ */
+export declare function normalizeMessage(input: string | ChatMessage, role?: Role): ChatMessage;

package/dist/shared/core/utils/metaUtils.d.ts

@@ -0,0 +1,22 @@
+import type { ChatMessage, MessagePart, ToolMeta } from "@/types";
+/**
+ * Collect all text parts into a single string
+ */
+export declare function collectText(parts: MessagePart[]): string;
+/**
+ * Normalize interrupt ID strings
+ */
+export declare function normalizeInterruptId(id: unknown): string | null;
+/**
+ * Extract tool metadata (ID and name) from a message.
+ * Standardized to camelCase.
+ */
+export declare function extractToolMeta(message: ChatMessage): ToolMeta;
+/**
+ * Extract agent name from message metadata
+ */
+export declare function getAgentNameFromMessage(m: ChatMessage): string | null;
+/**
+ * Create a unique signature for a message for stable rendering
+ */
+export declare function messageSignature(message: ChatMessage): string;

package/dist/shared/core/utils/normalizationUtils.d.ts

@@ -0,0 +1,20 @@
+import type { ChatMessage, ToolCall } from "@/types";
+import type { StreamEvent } from "@/types/domain/streaming";
+/**
+ * Recursively normalizes object keys to camelCase.
+ * Useful for normalizing entire snapshots or metadata blobs from the API.
+ */
+export declare function normalizeKeysRecursive(obj: any): any;
+/**
+ * Standardizes a message object, ensuring consistent field names (camelCase)
+ * and resolving role/content variations.
+ */
+export declare function normalizeChatMessage(entry: any): ChatMessage | null;
+/**
+ * Normalizes a streaming event, ensuring consistent field names.
+ */
+export declare function normalizeStreamEvent(ev: any): StreamEvent;
+/**
+ * Normalizes an individual tool call object.
+ */
+export declare function normalizeToolCall(call: any): ToolCall;

package/dist/shared/core/utils/parsers.d.ts

@@ -0,0 +1,22 @@
+import type { ChatMessage, ImagePart, FilePart, ToolCall } from "@/types";
+/**
+ * Extracts all text content from a message as a single string.
+ */
+export declare function extractTextContent(message: ChatMessage): string;
+/**
+ * Extracts all images from a message.
+ */
+export declare function extractImageParts(message: ChatMessage): ImagePart[];
+/**
+ * Extracts all files from a message.
+ */
+export declare function extractFileParts(message: ChatMessage): FilePart[];
+/**
+ * Extracts all tool calls from an AI message.
+ */
+export declare function extractToolCalls(message: ChatMessage): ToolCall[];
+/**
+ * Extracts all artifacts from a message list for gallery display.
+ * Includes top-level artifacts from Tool messages and part-level artifacts from Tool Calls.
+ */
+export declare function extractAllArtifacts(messages: ChatMessage[]): any[];

package/dist/shared/core/utils/toolCallUtils.d.ts

@@ -0,0 +1,14 @@
+import type { ChatMessage, ToolCall } from "@/types";
+export type ToolCallState = "pending" | "completed" | "error";
+export type ToolCallWithResult = {
+    call: ToolCall;
+    result?: ChatMessage;
+    state: ToolCallState;
+    progress?: Array<Record<string, unknown>>;
+    artifact?: unknown;
+};
+/**
+ * getToolCalls - Helper for rendering tool calls with results (LangGraph-style).
+ */
+export declare function getToolCalls(input: ChatMessage | ChatMessage[], allMessages?: ChatMessage[]): ToolCallWithResult[];
+export declare function getToolCallArtifacts(message: ChatMessage, allMessages?: ChatMessage[]): unknown[];

package/dist/shared/core/utils/toolFormatting.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Safely parses a JSON string, returning null on failure.
+ */
+/**
+ * Normalizes tool output by unwrapping nested structures (JSON strings, result objects, arrays, ChatMessages).
+ * Used during streaming, history hydration, and rendering.
+ */
+export declare function extractToolContent(x: any): any;

package/dist/shared/ui/components/toast.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+import * as ToastPrimitives from "@radix-ui/react-toast";
+import { type VariantProps } from "class-variance-authority";
+declare const ToastProvider: React.FC<ToastPrimitives.ToastProviderProps>;
+declare const ToastViewport: React.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastViewportProps & React.RefAttributes<HTMLOListElement>, "ref"> & React.RefAttributes<HTMLOListElement>>;
+declare const Toast: React.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastProps & React.RefAttributes<HTMLLIElement>, "ref"> & VariantProps<(props?: ({
+    variant?: "default" | "destructive" | null | undefined;
+} & import("class-variance-authority/dist/types").ClassProp) | undefined) => string> & React.RefAttributes<HTMLLIElement>>;
+declare const ToastAction: React.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastActionProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare const ToastClose: React.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastCloseProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare const ToastTitle: React.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastTitleProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ToastDescription: React.ForwardRefExoticComponent<Omit<ToastPrimitives.ToastDescriptionProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+type ToastProps = React.ComponentPropsWithoutRef<typeof Toast>;
+type ToastActionElement = React.ReactElement<typeof ToastAction>;
+export { type ToastProps, type ToastActionElement, ToastProvider, ToastViewport, Toast, ToastTitle, ToastDescription, ToastClose, ToastAction, };

package/dist/shared/ui/hooks/use-toast.d.ts

@@ -0,0 +1,44 @@
+import * as React from "react";
+import { type ToastActionElement, type ToastProps } from "../components/toast";
+type ToasterToast = ToastProps & {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    action?: ToastActionElement;
+};
+declare const actionTypes: {
+    readonly ADD_TOAST: "ADD_TOAST";
+    readonly UPDATE_TOAST: "UPDATE_TOAST";
+    readonly DISMISS_TOAST: "DISMISS_TOAST";
+    readonly REMOVE_TOAST: "REMOVE_TOAST";
+};
+type ActionType = typeof actionTypes;
+type Action = {
+    type: ActionType["ADD_TOAST"];
+    toast: ToasterToast;
+} | {
+    type: ActionType["UPDATE_TOAST"];
+    toast: Partial<ToasterToast>;
+} | {
+    type: ActionType["DISMISS_TOAST"];
+    toastId?: ToasterToast["id"];
+} | {
+    type: ActionType["REMOVE_TOAST"];
+    toastId?: ToasterToast["id"];
+};
+interface State {
+    toasts: ToasterToast[];
+}
+export declare const reducer: (state: State, action: Action) => State;
+type Toast = Omit<ToasterToast, "id">;
+export declare function toast({ ...props }: Toast): {
+    id: string;
+    dismiss: () => void;
+    update: (props: ToasterToast) => void;
+};
+export declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+export {};

package/dist/shared/ui/utils/cn.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/shared/ui/utils/index.d.ts

@@ -0,0 +1 @@
+export { cn } from "./cn";

package/dist/shared/utils/jsonUtils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pure JSON parsing and text analysis utilities
+ * Shared across persistence and UI layers
+ */
+/**
+ * Try to parse a JSON object/array safely.
+ *
+ * Includes a "Best Effort" recovery mode for Python-style string representations
+ * (single quotes, True/False, None) which are common in AI agent outputs.
+ * Since standard JSON.parse is tried first, this is zero-risk for valid JSON.
+ *
+ * Returns null if invalid or definitely not a JSON structure.
+ */
+export declare function parseJsonSafe(text: string): any | null;
+/**
+ * Detect if content looks like markdown (has markdown indicators)
+ */
+export declare function looksLikeMarkdown(text: string): boolean;

package/dist/types/api/auth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Auth API Types
+ * Authentication and user management
+ */
+export interface User {
+    user_id?: string;
+    _id?: string;
+    id?: string;
+    username?: string;
+    name?: string;
+    email?: string;
+    avatar_url?: string;
+    display_name?: string;
+    [key: string]: unknown;
+}

package/dist/types/api/common.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Common API Types
+ * Shared API response types used across multiple endpoints
+ */
+export interface ApiResponse<T = unknown> {
+    data?: T;
+    error?: string | null;
+    status: number;
+}

package/dist/types/api/files.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Files API Types
+ * File upload and management
+ */
+export interface ExcelUploadResponse {
+    [key: string]: unknown;
+}

package/dist/types/api/runs.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Runs API Types
+ * Chat execution, threads, checkpoints, projects, and agents
+ */
+export interface ThreadStateValues {
+    active_agent?: string;
+    uploaded_files?: unknown[];
+    distilled_facts?: unknown[];
+    research_summary?: unknown[];
+    web_results?: unknown[];
+    [key: string]: unknown;
+}
+export interface ProjectInfo {
+    id: string;
+    name: string;
+}
+export interface CheckpointSnapshot {
+    id: string;
+    threadId: string;
+    checkpointId: string;
+    checkpointNs?: string | null;
+    createdAt: string;
+    created_at?: string;
+    messages: unknown[];
+    values?: Record<string, unknown>;
+    next?: string[] | string | null;
+    config?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    parent_config?: Record<string, unknown>;
+    parentConfig?: Record<string, unknown>;
+    tasks?: unknown[];
+    interrupts?: unknown[];
+    interrupt?: unknown;
+}
+export interface HistoryPayload {
+    version: string;
+    threadId: string;
+    checkpoints: CheckpointSnapshot[];
+}
+export interface TimelineCheckpoint {
+    id?: string;
+    checkpointId: string;
+    checkpointNs?: string | null;
+    nodeId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ThreadSummary {
+    threadId: string;
+    title: string;
+    project?: ProjectInfo | null;
+    createdAt: string;
+    updatedAt: string;
+    messageCount?: number;
+    lastMessage?: string | null;
+    menuItem?: string;
+}
+export interface SharedThreadSummary extends ThreadSummary {
+    sharedByUserId: string;
+    sharedAt: string;
+    shareId: string;
+}
+export interface ThreadInfo {
+    threadId: string;
+    title: string;
+    project?: ProjectInfo | null;
+    createdAt: string;
+    updatedAt: string;
+    messageCount?: number;
+    lastMessage?: string | null;
+    menuItem?: string;
+}
+export interface ThreadShareTarget {
+    type: "user";
+    value: string;
+    id: string;
+    label: string;
+    secondaryLabel?: string;
+}
+export interface ThreadShareResponse {
+    shareId: string;
+    threadId: string;
+    sharedWithUserId: string;
+    sharedAt: string;
+    createdAt: string;
+}
+export interface AgentSummary {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentDetail extends AgentSummary {
+    description?: string;
+    schema?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface AgentList {
+    items?: AgentDetail[];
+    [key: string]: unknown;
+}
+export interface AgentSchemaInfo {
+    schema?: Record<string, unknown>;
+    [key: string]: unknown;
+}