@useago/sdk 0.3.0 → 0.3.2

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

@@ -0,0 +1,40 @@
+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,4 +1,4 @@
-import type { ClientFunctionHandler } from "../../functions/types";
+import type { ClientFunctionDefinition, ClientFunctionHandler } from "../../functions/types";
 export interface UseAgoFunctionOptions {
     description: string;
     parameters: {
@@ -17,14 +17,26 @@ export interface UseAgoFunctionOptions {
  * 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
- * useAgoFunction("showToast", {
+ * // 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;

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

@@ -0,0 +1,17 @@
+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/index.d.ts

@@ -1,9 +1,11 @@
 export { AgoProvider, useAgoClient, useOptionalAgoClient } from "./context";
-export type { AgoProviderProps } 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";
@@ -16,5 +18,7 @@ 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";