@useago/sdk 0.3.2 → 0.3.4

package/dist/react/context/AgoContext.d.ts

@@ -1,62 +0,0 @@
-import React from "react";
-import type { AgoClient } from "../../client/AgoClient";
-import type { AgoConfig } from "../../client/types";
-import type { ClientFunctionDefinition, ClientFunctionHandler } from "../../functions/types";
-/**
- * Top-level declarative configuration for the `AgoProvider`.
- *
- * - `tools` — full function definitions to expose to the AI app-wide
- * - `helpers` — map of pre-built helper name → handler override (or `true` for default)
- * - `pageContext` — `"auto"` enables automatic URL/title capture
- */
-export interface AgoDeclarativeConfig {
-    tools?: ClientFunctionDefinition[];
-    helpers?: Record<string, ClientFunctionHandler | true>;
-    pageContext?: "auto" | "manual";
-}
-export type AgoProviderProps = {
-    children: React.ReactNode;
-} & AgoDeclarativeConfig & (({
-    client: AgoClient;
-} & Partial<Record<keyof AgoConfig, never>>) | ({
-    client?: never;
-} & AgoConfig));
-/**
- * Provides an AgoClient to all descendant components via React context.
- *
- * ```tsx
- * // Minimal setup
- * <AgoProvider baseUrl="https://YOUR-DOMAIN.useago.com">
- *   <App />
- * </AgoProvider>
- *
- * // Declarative config — tools, helpers, page context
- * <AgoProvider
- *   baseUrl="https://YOUR-DOMAIN.useago.com"
- *   tools={[lookupOrder, cancelOrder]}
- *   helpers={{
- *     showToast: (args) => toast(args.message as string),
- *     copyToClipboard: true, // use default handler
- *   }}
- *   pageContext="auto"
- * >
- *   <App />
- * </AgoProvider>
- *
- * // With a pre-built client (useful for testing)
- * <AgoProvider client={myClient}>
- *   <App />
- * </AgoProvider>
- * ```
- */
-export declare const AgoProvider: React.FC<AgoProviderProps>;
-/**
- * Returns the AgoClient from the nearest AgoProvider.
- * Throws if used outside of an AgoProvider.
- */
-export declare function useAgoClient(): AgoClient;
-/**
- * Returns the AgoClient from context, or null if no provider exists.
- * Use this when client access is optional.
- */
-export declare function useOptionalAgoClient(): AgoClient | null;

package/dist/react/context/index.d.ts

@@ -1,2 +0,0 @@
-export { AgoProvider, useAgoClient, useOptionalAgoClient } from "./AgoContext";
-export type { AgoProviderProps, AgoDeclarativeConfig } from "./AgoContext";

package/dist/react/hooks/index.d.ts

@@ -1,7 +0,0 @@
-export { useAgo } from "./useAgo";
-export type { UseAgoOptions, UseAgoResult } from "./useAgo";
-export { useMessages } from "./useMessages";
-export type { UseMessagesOptions, UseMessagesResult } from "./useMessages";
-export { useConversation } from "./useConversation";
-export type { UseConversationOptions, UseConversationResult } from "./useConversation";
-export { useAgoContext } from "./useAgoContext";

package/dist/react/hooks/useAgo.d.ts

@@ -1,14 +0,0 @@
-import { AgoClient } from "../../client/AgoClient";
-import type { AgoConfig } from "../../client/types";
-export interface UseAgoOptions extends AgoConfig {
-}
-export interface UseAgoResult {
-    /** The AGO client instance */
-    client: AgoClient;
-    /** Whether the client is ready */
-    isReady: boolean;
-}
-/**
- * Hook to create and manage an AgoClient instance
- */
-export declare function useAgo(config: UseAgoOptions): UseAgoResult;

package/dist/react/hooks/useAgoContext.d.ts

@@ -1,40 +0,0 @@
-import type { ContextEntry, DynamicContextProvider } from "../../state/ClientContextRegistry";
-/**
- * Declaratively expose a piece of context to the AI agent with every message.
- *
- * Accepts either:
- * - An **object** — sent as-is on every message (re-registered when it changes).
- *   Use for data that already lives in React state.
- * - A **function** — called lazily at each message send, so the AI always gets
- *   the freshest value. Use for data outside React state (global stores, refs,
- *   computed values).
- *
- * A unique key is auto-generated per component instance via `useId()`. Pass an
- * explicit key as second argument to share context across components or
- * reference it from elsewhere.
- *
- * ```tsx
- * // Static object — captured at render time
- * function OrderPage({ order }) {
- *   useAgoContext({
- *     name: "Order detail",
- *     description: "The user is viewing a specific order",
- *     data: { orderId: order.id, status: order.status },
- *   });
- * }
- *
- * // Dynamic function — evaluated at each sendMessage
- * function App() {
- *   const storeRef = useRef(reduxStore);
- *   useAgoContext(() => {
- *     const state = storeRef.current.getState();
- *     return { name: "App shell", data: { userId: state.auth.userId } };
- *   });
- * }
- *
- * // With an explicit key
- * useAgoContext({ name: "Sidebar filter", data: { filter } }, "sidebar-filter");
- * ```
- */
-export declare function useAgoContext(entry: ContextEntry, key?: string): void;
-export declare function useAgoContext(provider: DynamicContextProvider, key?: string): void;

package/dist/react/hooks/useAgoFunction.d.ts

@@ -1,58 +0,0 @@
-import type { ClientFunctionDefinition, ClientFunctionHandler } from "../../functions/types";
-export interface UseAgoFunctionOptions {
-    description: string;
-    parameters: {
-        type: "object";
-        properties: Record<string, {
-            type: string;
-            description?: string;
-            enum?: string[];
-            default?: unknown;
-        }>;
-        required?: string[];
-    };
-    handler: ClientFunctionHandler;
-}
-/**
- * Declaratively register a client-side function with the AGO agent.
- * Automatically unregisters on unmount and re-registers when deps change.
- *
- * Accepts either a full definition object (preferred) or classic (name, options) args.
- *
- * ```tsx
- * // Preferred — pass the whole definition
- * useAgoFunction({
- *   name: "showToast",
- *   description: "Show a notification to the user",
- *   parameters: { type: "object", properties: { message: { type: "string" } } },
- *   handler: async (args) => { toast(args.message); return { shown: true }; },
- * });
- *
- * // Or reuse a pre-defined function
- * const lookupOrder = defineFunction({ name: "lookupOrder", ... });
- * useAgoFunction(lookupOrder);
- *
- * // Classic form
- * useAgoFunction("showToast", { description: "...", parameters: {...}, handler: async (args) => ... });
- * ```
- */
-export declare function useAgoFunction(definition: ClientFunctionDefinition): void;
-export declare function useAgoFunction(name: string, options: UseAgoFunctionOptions): void;
-export interface AgoRoute {
-    name: string;
-    path: string;
-    description: string;
-}
-/**
- * Declaratively register navigation routes with the AGO agent.
- * Wraps `registerNavigationFunction` with React lifecycle management.
- *
- * ```tsx
- * const navigate = useNavigate();
- * useAgoNavigation(navigate, [
- *   { name: "dashboard", path: "/dashboard", description: "Main dashboard" },
- *   { name: "settings", path: "/settings", description: "User settings" },
- * ]);
- * ```
- */
-export declare function useAgoNavigation(navigate: (path: string) => void, routes: AgoRoute[]): void;

package/dist/react/hooks/useAgoStore.d.ts

@@ -1,17 +0,0 @@
-import type { Store } from "../../state/createStore";
-/**
- * Read a framework-agnostic AGO store (`createStore`) reactively in React.
- *
- * Re-renders the component whenever the store's value changes. Mutate the store
- * via `store.set(...)`, not the value returned here.
- *
- * ```tsx
- * const cart = createStore({ items: [] as string[] });
- *
- * function CartBadge() {
- *   const { items } = useAgoStore(cart);
- *   return <span>{items.length}</span>;
- * }
- * ```
- */
-export declare function useAgoStore<T>(store: Store<T>): T;

package/dist/react/hooks/useChat.d.ts

@@ -1,45 +0,0 @@
-import type { AgoClient } from "../../client/AgoClient";
-import type { AgoMessage, Conversation } from "../../client/types";
-export interface UseChatOptions {
-    /** AgoClient instance. If omitted, reads from AgoProvider context. */
-    client?: AgoClient;
-    /** Initial conversation ID to load */
-    conversationId?: string;
-    /** Auto-load conversation list on mount (default: true) */
-    autoLoad?: boolean;
-}
-export interface UseChatResult {
-    /** Messages in the current conversation */
-    messages: AgoMessage[];
-    /** Whether a message is being sent/streamed */
-    isLoading: boolean;
-    /** Current error */
-    error: Error | null;
-    /** Send a message */
-    sendMessage: (content: string, files?: File[]) => Promise<AgoMessage | null>;
-    /** Clear current messages */
-    clearMessages: () => void;
-    /** Current conversation ID */
-    conversationId: string | undefined;
-    /** All conversations */
-    conversations: Conversation[];
-    /** Currently selected conversation */
-    currentConversation: Conversation | null;
-    /** Whether conversations are loading */
-    isConversationsLoading: boolean;
-    /** Select a conversation by ID */
-    selectConversation: (conversationId: string) => Promise<void>;
-    /** Start a new conversation */
-    startNewConversation: () => void;
-    /** Refresh conversations list */
-    refreshConversations: () => Promise<void>;
-}
-/**
- * All-in-one hook for building a custom chat UI.
- * Composes useMessages + useConversation.
- *
- * ```tsx
- * const { messages, sendMessage, conversations, selectConversation } = useChat();
- * ```
- */
-export declare function useChat(options?: UseChatOptions): UseChatResult;

package/dist/react/hooks/useConversation.d.ts

@@ -1,28 +0,0 @@
-import type { AgoClient } from "../../client/AgoClient";
-import type { Conversation } from "../../client/types";
-export interface UseConversationOptions {
-    /** The AGO client instance. If omitted, reads from AgoProvider context. */
-    client?: AgoClient;
-    /** Auto-load conversations on mount */
-    autoLoad?: boolean;
-}
-export interface UseConversationResult {
-    /** List of conversations */
-    conversations: Conversation[];
-    /** Currently selected conversation */
-    currentConversation: Conversation | null;
-    /** Whether conversations are loading */
-    isLoading: boolean;
-    /** Current error, if any */
-    error: Error | null;
-    /** Select a conversation */
-    selectConversation: (conversationId: string) => Promise<void>;
-    /** Clear current conversation (start new) */
-    startNewConversation: () => void;
-    /** Refresh conversations list */
-    refreshConversations: () => Promise<void>;
-}
-/**
- * Hook to manage conversations
- */
-export declare function useConversation({ client: clientProp, autoLoad, }?: UseConversationOptions): UseConversationResult;

package/dist/react/hooks/useMessages.d.ts

@@ -1,26 +0,0 @@
-import type { AgoClient } from "../../client/AgoClient";
-import type { AgoMessage } from "../../client/types";
-export interface UseMessagesOptions {
-    /** The AGO client instance. If omitted, reads from AgoProvider context. */
-    client?: AgoClient;
-    /** Conversation ID to load messages for */
-    conversationId?: string;
-}
-export interface UseMessagesResult {
-    /** List of messages */
-    messages: AgoMessage[];
-    /** Whether a message is being sent */
-    isLoading: boolean;
-    /** Current error, if any */
-    error: Error | null;
-    /** Send a new message */
-    sendMessage: (content: string, files?: File[]) => Promise<AgoMessage | null>;
-    /** Clear messages */
-    clearMessages: () => void;
-    /** Current conversation ID */
-    conversationId: string | undefined;
-}
-/**
- * Hook to manage messages in a conversation
- */
-export declare function useMessages({ client: clientProp, conversationId: initialConversationId, }?: UseMessagesOptions): UseMessagesResult;

package/dist/react/index.d.ts

@@ -1,24 +0,0 @@
-export { AgoProvider, useAgoClient, useOptionalAgoClient } from "./context";
-export type { AgoProviderProps, AgoDeclarativeConfig } from "./context/AgoContext";
-export { ChatWidget } from "./components/ChatWidget";
-export type { ChatWidgetProps } from "./components/ChatWidget";
-export { Message } from "./components/Message";
-export type { MessageProps } from "./components/Message";
-export { Markdown } from "./components/Markdown";
-export type { MarkdownProps } from "./components/Markdown";
-export { ChatInput } from "./components/ChatInput";
-export type { ChatInputProps } from "./components/ChatInput";
-export { useAgo } from "./hooks/useAgo";
-export type { UseAgoOptions, UseAgoResult } from "./hooks/useAgo";
-export { useMessages } from "./hooks/useMessages";
-export type { UseMessagesOptions, UseMessagesResult } from "./hooks/useMessages";
-export { useConversation } from "./hooks/useConversation";
-export type { UseConversationOptions, UseConversationResult } from "./hooks/useConversation";
-export { useChat } from "./hooks/useChat";
-export type { UseChatOptions, UseChatResult } from "./hooks/useChat";
-export { useAgoFunction, useAgoNavigation } from "./hooks/useAgoFunction";
-export type { UseAgoFunctionOptions, AgoRoute } from "./hooks/useAgoFunction";
-export { useAgoContext } from "./hooks/useAgoContext";
-export { useAgoStore } from "./hooks/useAgoStore";
-export { createMockClient } from "./testing";
-export type { AgoConfig, AgoMessage, Conversation, AgoAgent, AgoSource, ToolCallData, } from "../client/types";

package/dist/react/testing.d.ts

@@ -1,2 +0,0 @@
-export { createMockClient } from "../testing";
-export type { MockAgoClient, MockAgoClientOptions } from "../testing";