@rickydata/react 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,603 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { AgentClient, AgentDetailResponse, AgentInfo, WalletBalanceResponse, WalletTransactionsResponse, SessionDetail, SessionListEntry, WalletSettings } from 'rickydata/agent';
+export { AgentClientConfig, AgentDetailResponse, AgentInfo, SSEEvent, SessionDetail, SessionListEntry, WalletBalanceResponse, WalletSettings } from 'rickydata/agent';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as _tanstack_query_core from '@tanstack/query-core';
+
+interface RickyDataProviderProps {
+    /** Config to auto-create an AgentClient. Provide `getAuthToken` for browser use. */
+    config?: {
+        gatewayUrl?: string;
+        getAuthToken: () => Promise<string | undefined>;
+    };
+    /** Pre-built client (for testing/mocks). Mutually exclusive with `config`. */
+    client?: AgentClient;
+    children: ReactNode;
+}
+/**
+ * Provides an `AgentClient` instance to all descendant hooks and components.
+ *
+ * Usage:
+ * ```tsx
+ * <RickyDataProvider config={{ getAuthToken: () => getToken() }}>
+ *   <App />
+ * </RickyDataProvider>
+ * ```
+ */
+declare function RickyDataProvider({ config, client, children }: RickyDataProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Access the AgentClient from context. Throws if used outside `<RickyDataProvider>`.
+ */
+declare function useRickyData(): AgentClient;
+
+declare const agentKeys: {
+    all: readonly ["agents"];
+    lists: () => readonly ["agents", "list"];
+    details: () => readonly ["agents", "detail"];
+    detail: (id: string) => readonly ["agents", "detail", string];
+};
+/** Fetch all published agents. */
+declare function useAgents(): _tanstack_react_query.UseQueryResult<AgentInfo[], Error>;
+/** Fetch a single agent's detail (tools, skills). */
+declare function useAgent(agentId: string | undefined): _tanstack_react_query.UseQueryResult<AgentDetailResponse, Error>;
+
+declare const apiKeyKeys: {
+    all: readonly ["apikey"];
+    status: () => readonly ["apikey", "status"];
+    openai: () => readonly ["apikey", "openai"];
+};
+/** Check if Anthropic API key is configured. */
+declare function useApiKeyStatus(): _tanstack_react_query.UseQueryResult<{
+    configured: boolean;
+}, Error>;
+/** Mutation to set the Anthropic API key. Invalidates status on success. */
+declare function useSetApiKey(): _tanstack_react_query.UseMutationResult<{
+    configured: boolean;
+}, Error, string, unknown>;
+/** Mutation to delete the Anthropic API key. */
+declare function useDeleteApiKey(): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+/** Check if OpenAI API key is configured. */
+declare function useOpenAIApiKeyStatus(): _tanstack_react_query.UseQueryResult<{
+    configured: boolean;
+}, Error>;
+/** Mutation to set the OpenAI API key. */
+declare function useSetOpenAIApiKey(): _tanstack_react_query.UseMutationResult<{
+    configured: boolean;
+}, Error, string, unknown>;
+
+declare const balanceKeys: {
+    all: readonly ["wallet-balance"];
+    balance: () => readonly ["wallet-balance", "balance"];
+    transactions: (limit?: number, offset?: number) => readonly ["wallet-balance", "transactions", {
+        readonly limit: number | undefined;
+        readonly offset: number | undefined;
+    }];
+};
+interface UseWalletBalanceOptions {
+    enabled?: boolean;
+    /** Stale time in ms. Defaults to 60s. */
+    staleTime?: number;
+}
+/** Fetch wallet balance with formatted display value. */
+declare function useWalletBalance(opts?: UseWalletBalanceOptions): {
+    balance: string;
+    balanceDisplay: string;
+    depositAddress: string | undefined;
+    agentSpends: Record<string, {
+        totalSpent: string;
+    }> | undefined;
+    refresh: () => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    data: WalletBalanceResponse;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletBalanceResponse>;
+} | {
+    balance: string;
+    balanceDisplay: string;
+    depositAddress: string | undefined;
+    agentSpends: Record<string, {
+        totalSpent: string;
+    }> | undefined;
+    refresh: () => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    data: WalletBalanceResponse;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletBalanceResponse>;
+} | {
+    balance: string;
+    balanceDisplay: string;
+    depositAddress: string | undefined;
+    agentSpends: Record<string, {
+        totalSpent: string;
+    }> | undefined;
+    refresh: () => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletBalanceResponse>;
+} | {
+    balance: string;
+    balanceDisplay: string;
+    depositAddress: string | undefined;
+    agentSpends: Record<string, {
+        totalSpent: string;
+    }> | undefined;
+    refresh: () => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletBalanceResponse>;
+} | {
+    balance: string;
+    balanceDisplay: string;
+    depositAddress: string | undefined;
+    agentSpends: Record<string, {
+        totalSpent: string;
+    }> | undefined;
+    refresh: () => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletBalanceResponse>;
+} | {
+    balance: string;
+    balanceDisplay: string;
+    depositAddress: string | undefined;
+    agentSpends: Record<string, {
+        totalSpent: string;
+    }> | undefined;
+    refresh: () => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    data: WalletBalanceResponse;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletBalanceResponse, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletBalanceResponse>;
+};
+/** Fetch wallet transaction history. */
+declare function useWalletTransactions(limit?: number, offset?: number): _tanstack_react_query.UseQueryResult<WalletTransactionsResponse, Error>;
+
+declare const sessionKeys: {
+    all: readonly ["sessions"];
+    lists: (agentId: string) => readonly ["sessions", "list", string];
+    details: () => readonly ["sessions", "detail"];
+    detail: (agentId: string, sessionId: string) => readonly ["sessions", "detail", string, string];
+};
+/** List sessions for an agent. */
+declare function useSessions(agentId: string | undefined): _tanstack_react_query.UseQueryResult<SessionListEntry[], Error>;
+/** Get session detail including messages. */
+declare function useSession(agentId: string | undefined, sessionId: string | undefined): _tanstack_react_query.UseQueryResult<SessionDetail, Error>;
+/** Mutation to delete a session. */
+declare function useDeleteSession(): _tanstack_react_query.UseMutationResult<void, Error, {
+    agentId: string;
+    sessionId: string;
+}, unknown>;
+
+declare const walletSettingsKeys: {
+    all: readonly ["wallet-settings"];
+    settings: () => readonly ["wallet-settings", "current"];
+};
+/** Fetch wallet settings. */
+declare function useWalletSettings(): {
+    settings: WalletSettings | undefined;
+    updateSettings: _tanstack_react_query.UseMutateAsyncFunction<WalletSettings, Error, Partial<WalletSettings>, unknown>;
+    isUpdating: boolean;
+    data: WalletSettings;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletSettings, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletSettings>;
+} | {
+    settings: WalletSettings | undefined;
+    updateSettings: _tanstack_react_query.UseMutateAsyncFunction<WalletSettings, Error, Partial<WalletSettings>, unknown>;
+    isUpdating: boolean;
+    data: WalletSettings;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletSettings, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletSettings>;
+} | {
+    settings: WalletSettings | undefined;
+    updateSettings: _tanstack_react_query.UseMutateAsyncFunction<WalletSettings, Error, Partial<WalletSettings>, unknown>;
+    isUpdating: boolean;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletSettings, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletSettings>;
+} | {
+    settings: WalletSettings | undefined;
+    updateSettings: _tanstack_react_query.UseMutateAsyncFunction<WalletSettings, Error, Partial<WalletSettings>, unknown>;
+    isUpdating: boolean;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletSettings, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletSettings>;
+} | {
+    settings: WalletSettings | undefined;
+    updateSettings: _tanstack_react_query.UseMutateAsyncFunction<WalletSettings, Error, Partial<WalletSettings>, unknown>;
+    isUpdating: boolean;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletSettings, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletSettings>;
+} | {
+    settings: WalletSettings | undefined;
+    updateSettings: _tanstack_react_query.UseMutateAsyncFunction<WalletSettings, Error, Partial<WalletSettings>, unknown>;
+    isUpdating: boolean;
+    data: WalletSettings;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<WalletSettings, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<WalletSettings>;
+};
+
+/** Chat message as used in React UI state. */
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'agent';
+    content: string;
+    toolExecutions?: ToolExecution[];
+    timestamp: string;
+    costUSD?: string;
+}
+/** A tool call + optional result within a chat message. */
+interface ToolExecution {
+    id: string;
+    name: string;
+    displayName?: string;
+    args: unknown;
+    result?: {
+        content?: string;
+        isError: boolean;
+    };
+}
+/** Section of missing secrets to configure. */
+interface SecretSection {
+    id: string;
+    label: string;
+    keys: string[];
+    configuredKeys: string[];
+    save: (secrets: Record<string, string>) => Promise<void>;
+}
+
+interface UseSecretsOptions {
+    agentId: string;
+    mcpServers?: string[];
+}
+interface UseSecretsResult {
+    sections: SecretSection[];
+    loading: boolean;
+    allConfigured: boolean;
+    refresh: () => void;
+}
+/**
+ * Discovers all missing secrets (API key + agent + MCP) for an agent.
+ * Returns sections with save callbacks for each.
+ */
+declare function useSecrets({ agentId, mcpServers }: UseSecretsOptions): UseSecretsResult;
+
+interface UseAgentChatOptions {
+    agentId: string;
+    model?: 'haiku' | 'sonnet' | 'opus';
+    resumeSessionId?: string;
+}
+interface UseAgentChatResult {
+    messages: ChatMessage[];
+    messagesLoading: boolean;
+    sending: boolean;
+    sessionId: string | null;
+    streamingPhase: 'idle' | 'tools' | 'streaming';
+    activeTools: string[];
+    apiKeyConfigured: boolean | null;
+    sendMessage: (text: string) => Promise<void>;
+    clearChat: () => void;
+    refreshApiKeyStatus: () => void;
+}
+/**
+ * SSE streaming chat hook. NOT React Query — uses imperative state management.
+ *
+ * Ported from rickydata_agentbook/src/hooks/useAgentTextChat.ts.
+ */
+declare function useAgentChat({ agentId, model, resumeSessionId, }: UseAgentChatOptions): UseAgentChatResult;
+
+interface SecretFormProps {
+    secretKeys: string[];
+    configuredKeys: string[];
+    onSave: (secrets: Record<string, string>) => Promise<void>;
+    onDelete?: (() => Promise<void>) | null;
+    onClose?: () => void;
+    className?: string;
+}
+/**
+ * Generic secret/password form with show/hide toggle.
+ * Uses inline styles — no CSS framework dependency.
+ */
+declare function SecretForm({ secretKeys, configuredKeys, onSave, onDelete, onClose, className }: SecretFormProps): react_jsx_runtime.JSX.Element;
+
+interface SecretOrchestratorProps {
+    agentId: string;
+    mcpServers?: string[];
+    onAllConfigured?: () => void;
+    className?: string;
+    compact?: boolean;
+}
+/**
+ * Discovers all missing secrets for an agent and renders collapsible
+ * SecretForm sections for each. Calls `onAllConfigured` when done.
+ */
+declare function SecretOrchestrator({ agentId, mcpServers, onAllConfigured, className, compact, }: SecretOrchestratorProps): react_jsx_runtime.JSX.Element | null;
+
+interface WalletChipProps {
+    address: string;
+    balanceDisplay?: string;
+    displayName?: string;
+    onPress?: () => void;
+    className?: string;
+}
+/**
+ * Compact wallet identity pill with optional balance badge.
+ * Pure presentational, inline styles, no framework dependency.
+ */
+declare function WalletChip({ address, balanceDisplay, displayName, onPress, className }: WalletChipProps): react_jsx_runtime.JSX.Element;
+
+export { type ChatMessage, RickyDataProvider, type RickyDataProviderProps, SecretForm, type SecretFormProps, SecretOrchestrator, type SecretOrchestratorProps, type SecretSection, type ToolExecution, type UseAgentChatOptions, type UseAgentChatResult, WalletChip, type WalletChipProps, agentKeys, apiKeyKeys, balanceKeys, sessionKeys, useAgent, useAgentChat, useAgents, useApiKeyStatus, useDeleteApiKey, useDeleteSession, useOpenAIApiKeyStatus, useRickyData, useSecrets, useSession, useSessions, useSetApiKey, useSetOpenAIApiKey, useWalletBalance, useWalletSettings, useWalletTransactions, walletSettingsKeys };