@useago/sdk 1.5.3 → 1.5.5

package/dist/testing.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./createMockClient-BwNLPjeT.cjs");exports.createMockClient=e.createMockClient;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./createMockClient-Dw-cyISN.cjs");exports.createMockClient=e.createMockClient;

package/dist/testing.d.cts

@@ -1,3 +1,19 @@
+declare interface ActivityEntry {
+    ts: number;
+    actor: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+
+declare interface ActivityInput {
+    actor?: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+    ts?: number;
+}
+
 /**
  * Agent information
  */
@@ -36,6 +52,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;
@@ -122,9 +140,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
      */
@@ -346,6 +369,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
      */
@@ -457,6 +493,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;
@@ -517,6 +562,8 @@ declare interface AgoClientEvents {
     "nudge:accepted": {
         nudge: ProactiveNudgeInstance;
     };
+    /** A user- or agent-action was recorded into the activity ledger. */
+    "activity:recorded": ActivityEntry;
 }
 
 /**
@@ -578,6 +625,14 @@ 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…)
@@ -1005,6 +1060,16 @@ 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.
+ */
+declare interface PaginatedResult<T> {
+    data: T[];
+    hasMore: boolean;
+    total: number;
+}
+
 /**
  * Controller returned by {@link createAgoProactive} (also available as
  * `client.proactive`).
@@ -1257,6 +1322,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;

package/dist/testing.d.ts

@@ -1,3 +1,19 @@
+declare interface ActivityEntry {
+    ts: number;
+    actor: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+
+declare interface ActivityInput {
+    actor?: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+    ts?: number;
+}
+
 /**
  * Agent information
  */
@@ -36,6 +52,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;
@@ -122,9 +140,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
      */
@@ -346,6 +369,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
      */
@@ -457,6 +493,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;
@@ -517,6 +562,8 @@ declare interface AgoClientEvents {
     "nudge:accepted": {
         nudge: ProactiveNudgeInstance;
     };
+    /** A user- or agent-action was recorded into the activity ledger. */
+    "activity:recorded": ActivityEntry;
 }
 
 /**
@@ -578,6 +625,14 @@ 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…)
@@ -1005,6 +1060,16 @@ 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.
+ */
+declare interface PaginatedResult<T> {
+    data: T[];
+    hasMore: boolean;
+    total: number;
+}
+
 /**
  * Controller returned by {@link createAgoProactive} (also available as
  * `client.proactive`).
@@ -1257,6 +1322,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;

package/dist/testing.js

@@ -1,4 +1,4 @@
-import { t as e } from "./createMockClient-Br0TWgLO.js";
+import { t as e } from "./createMockClient-DcuNlufr.js";
 export {
   e as createMockClient
 };

package/dist/vue.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const D=require("./rolldown-runtime-16Nf8qvH.cjs"),I=require("./AgoClient-BGkFSNZF.cjs");let o=require("vue");var w=Symbol("ago-client"),N={install(t,e){const n=new I.AgoClient(e);t.provide(w,n)}};function v(t){if(t)return new I.AgoClient(t);const e=(0,o.inject)(w);if(!e)throw new Error("useAgo(): no AgoClient found. Either pass config or install AgoPlugin.");return e}function M(t={}){const e=t.client??v(),n=(0,o.ref)([]),s=(0,o.ref)(t.conversationId),a=(0,o.ref)(!1),u=(0,o.ref)(null),c=r=>{s.value||(s.value=r.conversationId)},f=r=>{const i=n.value.findIndex(d=>d.id===r.messageId);i>=0&&(n.value[i]={...n.value[i],content:n.value[i].content+r.content})},m=r=>{const i=n.value.findIndex(d=>d.id===r.id);i>=0?n.value[i]=r:n.value.push(r),a.value=!1},C=r=>{u.value=new Error(r.error),a.value=!1};(0,o.onMounted)(()=>{e.on("message:start",c),e.on("message:chunk",f),e.on("message:complete",m),e.on("message:error",C)}),(0,o.onUnmounted)(()=>{e.off("message:start",c),e.off("message:chunk",f),e.off("message:complete",m),e.off("message:error",C)});async function g(r,i){a.value=!0,u.value=null;const d={id:`temp-${Date.now()}`,conversationId:s.value||"",content:r,role:"user",status:"DONE",createdAt:new Date},y={id:`temp-assistant-${Date.now()}`,conversationId:s.value||"",content:"",role:"assistant",status:"IN_PROGRESS",createdAt:new Date};n.value.push(d,y);try{const l=await e.sendMessage(r,{conversationId:s.value,files:i});l.conversationId&&!s.value&&(s.value=l.conversationId),n.value=n.value.filter(A=>!A.id.startsWith("temp-"));const p={...d,id:d.id.replace("temp-","user-"),conversationId:l.conversationId};return n.value.some(A=>A.id===l.id)?n.value.push(p):n.value.push(p,l),l}catch(l){return u.value=l instanceof Error?l:new Error("Failed to send"),a.value=!1,n.value=n.value.filter(p=>!p.id.startsWith("temp-")),null}}function h(){n.value=[],s.value=void 0,u.value=null}return{messages:n,isLoading:a,error:u,conversationId:s,sendMessage:g,clearMessages:h}}function E(t={}){const e=t.client??v(),n=t.autoLoad??!0,s=(0,o.ref)([]),a=(0,o.ref)(null),u=(0,o.ref)(!1),c=(0,o.ref)(null);async function f(){u.value=!0,c.value=null;try{s.value=await e.getConversations()}catch(g){c.value=g instanceof Error?g:new Error("Failed to load conversations")}finally{u.value=!1}}async function m(g){u.value=!0,c.value=null;try{a.value=await e.getConversation(g)}catch(h){c.value=h instanceof Error?h:new Error("Failed to load conversation")}finally{u.value=!1}}function C(){a.value=null}return(0,o.onMounted)(()=>{n&&f()}),{conversations:s,currentConversation:a,isLoading:u,error:c,selectConversation:m,startNewConversation:C,refreshConversations:f}}function S(t={}){const e=M({client:t.client,conversationId:t.conversationId}),n=E({client:t.client,autoLoad:t.autoLoad}),s=(0,o.computed)(()=>e.error.value||n.error.value);return{messages:e.messages,isLoading:e.isLoading,error:s,sendMessage:e.sendMessage,clearMessages:e.clearMessages,conversationId:e.conversationId,conversations:n.conversations,currentConversation:n.currentConversation,isConversationsLoading:n.isLoading,selectConversation:n.selectConversation,startNewConversation:n.startNewConversation,refreshConversations:n.refreshConversations}}function L(t,e){const n=v();(0,o.onMounted)(()=>{n.registerFunction(t,e.handler,{description:e.description,parameters:e.parameters,maxResultBytes:e.maxResultBytes})}),(0,o.onUnmounted)(()=>{n.unregisterFunction(t)})}function P(t,e){const n=v();(0,o.onMounted)(()=>{n.registerNavigationFunction(t,e)}),(0,o.onUnmounted)(()=>{n.unregisterNavigationFunction()})}function F(t,e){const n=v(),s=e?.functionName??"setPageState";(0,o.onMounted)(()=>{n.registerPageStateFunction(t,{functionName:s})}),(0,o.onUnmounted)(()=>{n.unregisterPageStateFunction(s)})}function R(t,e){const n=v();(0,o.onMounted)(()=>{n.on(t,e)}),(0,o.onUnmounted)(()=>{n.off(t,e)})}function _(t){const e=(0,o.shallowRef)(t.get());return(0,o.onScopeDispose)(t.subscribe(n=>{e.value=n})),e}function U(){const t=v(),e=(0,o.shallowRef)(null),n=a=>{e.value=a,t.proactive?.shown(a)},s=({nudge:a})=>{e.value?.id===a.id&&(e.value=null)};return(0,o.onMounted)(()=>{t.on("nudge:ready",n),t.on("nudge:accepted",s),t.on("nudge:dismissed",s)}),(0,o.onUnmounted)(()=>{t.off("nudge:ready",n),t.off("nudge:accepted",s),t.off("nudge:dismissed",s)}),{nudge:e,accept:async()=>{const a=e.value;a&&(e.value=null,await t.proactive?.accept(a))},dismiss:()=>{const a=e.value;a&&(e.value=null,t.proactive?.dismiss(a))}}}exports.AGO_CLIENT_KEY=w;exports.AgoPlugin=N;exports.useAgo=v;exports.useAgoEvents=R;exports.useAgoFunction=L;exports.useAgoNavigation=P;exports.useAgoPageState=F;exports.useAgoStore=_;exports.useChat=S;exports.useConversation=E;exports.useMessages=M;exports.useProactiveNudge=U;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const I=require("./AgoClient-CQh8YovA.cjs");let o=require("vue");var w=Symbol("ago-client"),N={install(t,e){const n=new I.AgoClient(e);t.provide(w,n)}};function v(t){if(t)return new I.AgoClient(t);const e=(0,o.inject)(w);if(!e)throw new Error("useAgo(): no AgoClient found. Either pass config or install AgoPlugin.");return e}function M(t={}){const e=t.client??v(),n=(0,o.ref)([]),s=(0,o.ref)(t.conversationId),a=(0,o.ref)(!1),u=(0,o.ref)(null),c=r=>{s.value||(s.value=r.conversationId)},f=r=>{const i=n.value.findIndex(d=>d.id===r.messageId);i>=0&&(n.value[i]={...n.value[i],content:n.value[i].content+r.content})},m=r=>{const i=n.value.findIndex(d=>d.id===r.id);i>=0?n.value[i]=r:n.value.push(r),a.value=!1},C=r=>{u.value=new Error(r.error),a.value=!1};(0,o.onMounted)(()=>{e.on("message:start",c),e.on("message:chunk",f),e.on("message:complete",m),e.on("message:error",C)}),(0,o.onUnmounted)(()=>{e.off("message:start",c),e.off("message:chunk",f),e.off("message:complete",m),e.off("message:error",C)});async function g(r,i){a.value=!0,u.value=null;const d={id:`temp-${Date.now()}`,conversationId:s.value||"",content:r,role:"user",status:"DONE",createdAt:new Date},y={id:`temp-assistant-${Date.now()}`,conversationId:s.value||"",content:"",role:"assistant",status:"IN_PROGRESS",createdAt:new Date};n.value.push(d,y);try{const l=await e.sendMessage(r,{conversationId:s.value,files:i});l.conversationId&&!s.value&&(s.value=l.conversationId),n.value=n.value.filter(A=>!A.id.startsWith("temp-"));const p={...d,id:d.id.replace("temp-","user-"),conversationId:l.conversationId};return n.value.some(A=>A.id===l.id)?n.value.push(p):n.value.push(p,l),l}catch(l){return u.value=l instanceof Error?l:new Error("Failed to send"),a.value=!1,n.value=n.value.filter(p=>!p.id.startsWith("temp-")),null}}function h(){n.value=[],s.value=void 0,u.value=null}return{messages:n,isLoading:a,error:u,conversationId:s,sendMessage:g,clearMessages:h}}function E(t={}){const e=t.client??v(),n=t.autoLoad??!0,s=(0,o.ref)([]),a=(0,o.ref)(null),u=(0,o.ref)(!1),c=(0,o.ref)(null);async function f(){u.value=!0,c.value=null;try{s.value=(await e.getConversations()).data}catch(g){c.value=g instanceof Error?g:new Error("Failed to load conversations")}finally{u.value=!1}}async function m(g){u.value=!0,c.value=null;try{a.value=await e.getConversation(g)}catch(h){c.value=h instanceof Error?h:new Error("Failed to load conversation")}finally{u.value=!1}}function C(){a.value=null}return(0,o.onMounted)(()=>{n&&f()}),{conversations:s,currentConversation:a,isLoading:u,error:c,selectConversation:m,startNewConversation:C,refreshConversations:f}}function S(t={}){const e=M({client:t.client,conversationId:t.conversationId}),n=E({client:t.client,autoLoad:t.autoLoad}),s=(0,o.computed)(()=>e.error.value||n.error.value);return{messages:e.messages,isLoading:e.isLoading,error:s,sendMessage:e.sendMessage,clearMessages:e.clearMessages,conversationId:e.conversationId,conversations:n.conversations,currentConversation:n.currentConversation,isConversationsLoading:n.isLoading,selectConversation:n.selectConversation,startNewConversation:n.startNewConversation,refreshConversations:n.refreshConversations}}function L(t,e){const n=v();(0,o.onMounted)(()=>{n.registerFunction(t,e.handler,{description:e.description,parameters:e.parameters,maxResultBytes:e.maxResultBytes})}),(0,o.onUnmounted)(()=>{n.unregisterFunction(t)})}function P(t,e){const n=v();(0,o.onMounted)(()=>{n.registerNavigationFunction(t,e)}),(0,o.onUnmounted)(()=>{n.unregisterNavigationFunction()})}function F(t,e){const n=v(),s=e?.functionName??"setPageState";(0,o.onMounted)(()=>{n.registerPageStateFunction(t,{functionName:s})}),(0,o.onUnmounted)(()=>{n.unregisterPageStateFunction(s)})}function R(t,e){const n=v();(0,o.onMounted)(()=>{n.on(t,e)}),(0,o.onUnmounted)(()=>{n.off(t,e)})}function U(t){const e=(0,o.shallowRef)(t.get());return(0,o.onScopeDispose)(t.subscribe(n=>{e.value=n})),e}function D(){const t=v(),e=(0,o.shallowRef)(null),n=a=>{e.value=a,t.proactive?.shown(a)},s=({nudge:a})=>{e.value?.id===a.id&&(e.value=null)};return(0,o.onMounted)(()=>{t.on("nudge:ready",n),t.on("nudge:accepted",s),t.on("nudge:dismissed",s)}),(0,o.onUnmounted)(()=>{t.off("nudge:ready",n),t.off("nudge:accepted",s),t.off("nudge:dismissed",s)}),{nudge:e,accept:async()=>{const a=e.value;a&&(e.value=null,await t.proactive?.accept(a))},dismiss:()=>{const a=e.value;a&&(e.value=null,t.proactive?.dismiss(a))}}}exports.AGO_CLIENT_KEY=w;exports.AgoPlugin=N;exports.useAgo=v;exports.useAgoEvents=R;exports.useAgoFunction=L;exports.useAgoNavigation=P;exports.useAgoPageState=F;exports.useAgoStore=U;exports.useChat=S;exports.useConversation=E;exports.useMessages=M;exports.useProactiveNudge=D;

package/dist/vue.d.cts

@@ -4,6 +4,22 @@ import { InjectionKey } from 'vue';
 import { Ref } from 'vue';
 import { ShallowRef } from 'vue';
 
+declare interface ActivityEntry {
+    ts: number;
+    actor: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+
+declare interface ActivityInput {
+    actor?: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+    ts?: number;
+}
+
 export declare const AGO_CLIENT_KEY: InjectionKey<AgoClient>;
 
 /**
@@ -44,6 +60,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;
@@ -130,9 +148,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
      */
@@ -354,6 +377,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
      */
@@ -465,6 +501,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;
@@ -525,6 +570,8 @@ declare interface AgoClientEvents {
     "nudge:accepted": {
         nudge: ProactiveNudgeInstance;
     };
+    /** A user- or agent-action was recorded into the activity ledger. */
+    "activity:recorded": ActivityEntry;
 }
 
 /**
@@ -586,6 +633,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…)
@@ -1007,6 +1062,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.
+ */
+declare interface PaginatedResult<T> {
+    data: T[];
+    hasMore: boolean;
+    total: number;
+}
+
 /**
  * Controller returned by {@link createAgoProactive} (also available as
  * `client.proactive`).
@@ -1259,6 +1324,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;

package/dist/vue.d.ts

@@ -4,6 +4,22 @@ import { InjectionKey } from 'vue';
 import { Ref } from 'vue';
 import { ShallowRef } from 'vue';
 
+declare interface ActivityEntry {
+    ts: number;
+    actor: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+
+declare interface ActivityInput {
+    actor?: "user" | "agent";
+    name: string;
+    summary: string;
+    data?: Record<string, unknown>;
+    ts?: number;
+}
+
 export declare const AGO_CLIENT_KEY: InjectionKey<AgoClient>;
 
 /**
@@ -44,6 +60,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;
@@ -130,9 +148,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
      */
@@ -354,6 +377,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
      */
@@ -465,6 +501,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;
@@ -525,6 +570,8 @@ declare interface AgoClientEvents {
     "nudge:accepted": {
         nudge: ProactiveNudgeInstance;
     };
+    /** A user- or agent-action was recorded into the activity ledger. */
+    "activity:recorded": ActivityEntry;
 }
 
 /**
@@ -586,6 +633,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…)
@@ -1007,6 +1062,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.
+ */
+declare interface PaginatedResult<T> {
+    data: T[];
+    hasMore: boolean;
+    total: number;
+}
+
 /**
  * Controller returned by {@link createAgoProactive} (also available as
  * `client.proactive`).
@@ -1259,6 +1324,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;

package/dist/vue.js

@@ -1,4 +1,4 @@
-import { t as E } from "./AgoClient-CW-BLT1_.js";
+import { t as E } from "./AgoClient-BI5esqbd.js";
 import { computed as M, inject as F, onMounted as d, onScopeDispose as S, onUnmounted as m, ref as l, shallowRef as A } from "vue";
 var N = /* @__PURE__ */ Symbol("ago-client"), b = { install(t, e) {
   const n = new E(e);
@@ -81,7 +81,7 @@ function P(t = {}) {
   async function p() {
     r.value = !0, c.value = null;
     try {
-      s.value = await e.getConversations();
+      s.value = (await e.getConversations()).data;
     } catch (g) {
       c.value = g instanceof Error ? g : /* @__PURE__ */ new Error("Failed to load conversations");
     } finally {