@useago/sdk 1.5.3 → 1.5.5

package/dist/react.d.ts

@@ -1,5 +1,21 @@
 import { default as default_2 } from 'react';
 
+export declare interface ActivityEntry {
+    ts: number;
+    actor: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+
+export declare interface ActivityInput {
+    actor?: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+    ts?: number;
+}
+
 /**
  * One normalized entry in the agent's activity feed. Merges a tool call
  * (`toolCall:received`) or a client-function invocation (`function:invoke` /
@@ -91,6 +107,8 @@ declare class AgoClient {
     private functionRegistry;
     private contextRegistry;
     private eventEmitter;
+    private activityLedger;
+    private lastSentPageState;
     private config;
     /** Conversations already warned about an empty reply (one warning each). */
     private warnedEmptyConversations;
@@ -177,9 +195,14 @@ declare class AgoClient {
      */
     rejectFunction(invocationId: string): Promise<void>;
     /**
-     * Get list of conversations
+     * Get a page of conversations, newest-first. `pageSize` is capped at 100 by
+     * the backend (default 50). Returns the `{ data, has_more, total }` envelope
+     * so callers can page; `total` counts across all pages.
      */
-    getConversations(): Promise<Conversation[]>;
+    getConversations(options?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<PaginatedResult<Conversation>>;
     /**
      * Get a specific conversation with messages
      */
@@ -401,6 +424,19 @@ declare class AgoClient {
      * Get the current context snapshot.
      */
     getContextSnapshot(): ContextSnapshot | null;
+    private buildSendContext;
+    /**
+     * Record something the user just did so the agent is aware of it on the next
+     * message. `actor` defaults to `"user"`. Keep `summary` short and high-signal
+     * (no raw payloads, secrets, or PII).
+     */
+    recordActivity(entry: ActivityInput): void;
+    /** Recent user + agent actions, oldest first (a copy). */
+    getRecentActivity(): ActivityEntry[];
+    clearActivity(): void;
+    private addActivity;
+    private recordAgentAction;
+    private registerActivityContext;
     /**
      * Subscribe to an event
      */
@@ -512,6 +548,15 @@ declare interface AgoClientEvents {
      * notably `createFormCollector` — can replay them to restore their state.
      */
     "conversation:loaded": Conversation;
+    /**
+     * The conversation's title was generated and streamed during a live turn
+     * (the backend emits it once, at the end of the first turn). Lets the UI
+     * update a header without a refetch.
+     */
+    "conversation:title": {
+        conversationId: string;
+        title: string;
+    };
     "toolCall:received": ToolCallData;
     "toolCall:form": ToolCallData;
     "function:invoke": ClientFunctionInvocation;
@@ -572,6 +617,8 @@ declare interface AgoClientEvents {
     "nudge:accepted": {
         nudge: ProactiveNudgeInstance;
     };
+    /** A user- or agent-action was recorded into the activity ledger. */
+    "activity:recorded": ActivityEntry;
 }
 
 /**
@@ -633,6 +680,14 @@ export declare interface AgoConfig {
      * with `maxResultBytes` on its definition; `Infinity` disables the guard.
      */
     maxFunctionResultBytes?: number;
+    /**
+     * Max number of recent actions kept in the in-memory activity ledger that
+     * rides along as the `activity:recent` context entry. Older entries drop
+     * first. Default `10`. Larger values give the agent more history at the cost
+     * of tokens on every message. Each entry's `data` is also size-clamped (long
+     * strings truncated, large arrays capped) so one event can't bloat the context.
+     */
+    maxActivityEntries?: number;
     /**
      * Enable the proactive mode: declarative triggers evaluated client-side
      * against friction signals (dwell/idle time, rage clicks, route bounces…)
@@ -1393,6 +1448,16 @@ export declare type NudgeAction = {
     setPageState: Record<string, unknown>;
 };
 
+/**
+ * A page of list results, mirroring the API's `{ data, has_more, total }`
+ * envelope. `total` is the count across all pages, not just this page.
+ */
+export declare interface PaginatedResult<T> {
+    data: T[];
+    hasMore: boolean;
+    total: number;
+}
+
 /**
  * Controller returned by {@link createAgoProactive} (also available as
  * `client.proactive`).
@@ -1645,6 +1710,8 @@ declare interface SSEChunkData {
     thread?: {
         id: string;
     };
+    /** Generated conversation title, streamed once at the end of the first turn. */
+    title?: string;
     agent?: {
         id: string;
         name: string;
@@ -1789,6 +1856,20 @@ export declare function useAgo(config: UseAgoOptions | null): {
  */
 export declare function useAgoActivity(options?: UseAgoActivityOptions): UseAgoActivityResult;
 
+/** Recent user + agent activity, kept in sync with the client's ledger. */
+export declare function useAgoActivityLog(options?: UseAgoActivityLogOptions): UseAgoActivityLogResult;
+
+export declare interface UseAgoActivityLogOptions {
+    client?: AgoClient;
+}
+
+export declare interface UseAgoActivityLogResult {
+    entries: ActivityEntry[];
+    latest?: ActivityEntry;
+    record: (entry: ActivityInput) => void;
+    clear: () => void;
+}
+
 export declare interface UseAgoActivityOptions {
     /** The AGO client. If omitted, reads from AgoProvider context. */
     client?: AgoClient;