@runloop/reflex-client 0.15.2 → 0.17.0

package/dist/react/model/upsertIdpConfigBody.d.ts

@@ -8,9 +8,18 @@ import type { UpsertIdpConfigBodyGroupMappingsItem } from './upsertIdpConfigBody
 export type UpsertIdpConfigBody = {
     displayName?: string | null;
     issuer: string;
+    idJagEnabled?: boolean;
+    /**
+       * @maxItems 50
+       * @items.minLength 1
+       * @items.maxLength 512
+       */
+    idJagAllowedClientIds?: string[];
+    jwksUri?: string | null;
     /** @maxItems 200 */
     groupMappings?: UpsertIdpConfigBodyGroupMappingsItem[];
     oktaOrgUrl?: string | null;
     oktaSyncEnabled?: boolean;
+    expectedUpdatedAt?: number;
 };
 //# sourceMappingURL=upsertIdpConfigBody.d.ts.map

package/dist/react/model/upsertIdpConfigBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upsertIdpConfigBody.d.ts","sourceRoot":"","sources":["../../../src/react/model/upsertIdpConfigBody.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,2CAA2C,CAAC;AAEtG,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,aAAa,CAAC,EAAE,oCAAoC,EAAE,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC"}
+{"version":3,"file":"upsertIdpConfigBody.d.ts","sourceRoot":"","sources":["../../../src/react/model/upsertIdpConfigBody.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,2CAA2C,CAAC;AAEtG,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;SAIK;IACL,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oBAAoB;IACpB,aAAa,CAAC,EAAE,oCAAoC,EAAE,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runloop/reflex-client",
-  "version": "0.15.2",
+  "version": "0.17.0",
   "description": "Typed API client and live event stream for Reflex, authenticated with a personal API key.",
   "license": "MIT",
   "keywords": [

package/src/generated/agent-groups.ts

@@ -177,7 +177,7 @@ export const getAddAgentGroupMembersUrl = (groupId: string,) => {
 }
 
 /**
- * @summary Add agents to a group.
+ * @summary File agents into a group, moving them out of any other group.
  */
 export const addAgentGroupMembers = async (groupId: string,
     agentGroupMembersRequest: AgentGroupMembersRequest, options?: RequestInit): Promise<addAgentGroupMembersResponse> => {

package/src/generated/agents.ts

@@ -9,10 +9,12 @@ import type {
   AgentCommandPendingResponse,
   AgentCommandStatusResponse,
   AgentServiceStatusesResponse,
+  AgentSessionIndexResponse,
   AgentView,
   AgentViewsResponse,
   ArchiveAllAgents200,
   ArchiveAllAgentsBody,
+  AttachAgentMcpServers200,
   AttachAgentMcpServersBody,
   AxonEvent,
   CreateAgentBody,
@@ -22,8 +24,10 @@ import type {
   EnqueueAgentMessageBody,
   GetAgentCommandStatusParams,
   GetAgentQueue200Item,
+  GetAgentStreamParams,
   ListAgents200,
   ListAgentsParams,
+  PagedAgentStreamResponse,
   RemoveQueuedAgentMessage200,
   ReorderAgentQueue200Item,
   ReorderAgentQueueBody,
@@ -534,7 +538,7 @@ export const setAgentMark = async (id: string,
 
 
 export type attachAgentMcpServersResponse200 = {
-  data: Agent
+  data: AttachAgentMcpServers200
   status: 200
 }
 
@@ -554,7 +558,7 @@ export const getAttachAgentMcpServersUrl = (id: string,) => {
 }
 
 /**
- * Mints live MCP hub tokens for the devbox and registers each server in the agent's native config immediately, then records the ids on the agent's `mcp-servers` attachment. The devbox must be running (409 `agent_devbox_not_running` otherwise); a registration the box reports as failed is a 502 `mcp_registration_failed` with nothing persisted. Already-attached ids are skipped, unknown or disabled ids are dropped (compare the returned agent's attachments to detect a partial drop), and the request 404s `mcp_config_not_found` only when no id resolves. Local (stdio) servers are rejected because their subprocess secrets only exist as create-time devbox params.
+ * Mints live MCP hub tokens for the devbox and registers each server in the agent's native config immediately, then records the ids on the agent's `mcp-servers` attachment. The devbox must be running (409 `agent_devbox_not_running` otherwise); a registration the box reports as failed is a 502 `mcp_registration_failed` with nothing persisted. `activation` reports whether the agent process that is running right now loaded the servers (`active`, usable on its next turn) or whether they wait on disk for its next start (`deferred`) — both are successful attaches. Already-attached ids are skipped, unknown or disabled ids are dropped (compare the returned agent's attachments to detect a partial drop), and the request 404s `mcp_config_not_found` only when no id resolves. Local (stdio) servers are rejected because their subprocess secrets only exist as create-time devbox params.
  * @summary Attach MCP servers to a running agent's devbox.
  */
 export const attachAgentMcpServers = async (id: string,
@@ -938,6 +942,41 @@ export const getAgentServiceStatuses = async (id: string, options?: RequestInit)
 );}
 
 
+export type getAgentSessionIndexResponse200 = {
+  data: AgentSessionIndexResponse
+  status: 200
+}
+
+export type getAgentSessionIndexResponseSuccess = (getAgentSessionIndexResponse200) & {
+  headers: Headers;
+};
+;
+
+export type getAgentSessionIndexResponse = (getAgentSessionIndexResponseSuccess)
+
+export const getGetAgentSessionIndexUrl = (id: string,) => {
+
+
+
+
+  return `/agents/${encodeURIComponent(String(id))}/session-index`
+}
+
+/**
+ * @summary The agent's session index: every prompt and turn boundary, for nav and paging.
+ */
+export const getAgentSessionIndex = async (id: string, options?: RequestInit): Promise<getAgentSessionIndexResponse> => {
+
+  return apiFetch<getAgentSessionIndexResponse>(getGetAgentSessionIndexUrl(id),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
 export type createAgentSnapshotResponse202 = {
   data: Snapshot
   status: 202
@@ -1011,7 +1050,7 @@ export const stopAgent = async (id: string, options?: RequestInit): Promise<stop
 
 
 export type getAgentStreamResponse200 = {
-  data: AxonEvent[]
+  data: AxonEvent[] | PagedAgentStreamResponse
   status: 200
 }
 
@@ -1022,20 +1061,29 @@ export type getAgentStreamResponseSuccess = (getAgentStreamResponse200) & {
 
 export type getAgentStreamResponse = (getAgentStreamResponseSuccess)
 
-export const getGetAgentStreamUrl = (id: string,) => {
+export const getGetAgentStreamUrl = (id: string,
+    params?: GetAgentStreamParams,) => {
+  const normalizedParams = new URLSearchParams();
 
+  Object.entries(params || {}).forEach(([key, value]) => {
 
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : String(value))
+    }
+  });
 
+  const stringifiedParams = normalizedParams.toString();
 
-  return `/agents/${encodeURIComponent(String(id))}/stream`
+  return stringifiedParams.length > 0 ? `/agents/${encodeURIComponent(String(id))}/stream?${stringifiedParams}` : `/agents/${encodeURIComponent(String(id))}/stream`
 }
 
 /**
- * @summary Get the agent's full event history.
+ * @summary Get the agent's event history: a turn-aligned window for indexed agents, the full array for legacy ones.
  */
-export const getAgentStream = async (id: string, options?: RequestInit): Promise<getAgentStreamResponse> => {
+export const getAgentStream = async (id: string,
+    params?: GetAgentStreamParams, options?: RequestInit): Promise<getAgentStreamResponse> => {
 
-  return apiFetch<getAgentStreamResponse>(getGetAgentStreamUrl(id),
+  return apiFetch<getAgentStreamResponse>(getGetAgentStreamUrl(id,params),
   {
     ...options,
     method: 'GET'

package/src/generated/model/agentSessionIndexEntry.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AgentSessionIndexEntryEntry } from './agentSessionIndexEntryEntry.js';
+
+export interface AgentSessionIndexEntry {
+  seqNumber: number;
+  timestamp: number | null;
+  entry: AgentSessionIndexEntryEntry;
+}

package/src/generated/model/agentSessionIndexEntryEntry.ts

@@ -0,0 +1,28 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AgentSessionIndexEntryEntry = {
+  type: 'prompt';
+  data: {
+  /** @maxLength 64 */
+  text: string;
+  opensTurn: boolean;
+  protocolType: string;
+};
+} | {
+  type: 'turn.end';
+  data: {
+  reason: 'completed' | 'errored' | 'interrupted' | 'suspended' | 'shutdown';
+  durationMs?: number;
+  tokenUsage?: {
+  inputTokens?: number | null;
+  outputTokens?: number | null;
+  cacheReadTokens?: number | null;
+  cacheWriteTokens?: number | null;
+};
+};
+};

package/src/generated/model/agentSessionIndexResponse.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AgentSessionIndexEntry } from './agentSessionIndexEntry.js';
+
+export interface AgentSessionIndexResponse {
+  entries: AgentSessionIndexEntry[];
+  sessionIndexFromSeq: number | null;
+}

package/src/generated/model/agentStreamPageInfo.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export interface AgentStreamPageInfo {
+  startSeq: number;
+  endSeq: number;
+  prevCursor: number | null;
+  hasMore: boolean;
+}

package/src/generated/model/attachAgentMcpServers200.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { Agent } from './agent.js';
+import type { AttachAgentMcpServers200Activation } from './attachAgentMcpServers200Activation.js';
+
+export type AttachAgentMcpServers200 = {
+  agent: Agent;
+  activation: AttachAgentMcpServers200Activation;
+};

package/src/generated/model/attachAgentMcpServers200Activation.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type AttachAgentMcpServers200Activation = {
+  state: 'active';
+  serverNames: string[];
+} | {
+  state: 'deferred';
+  reason: 'restart-required' | 'agent-unreachable';
+};

package/src/generated/model/availableSecretCategory.ts

@@ -9,7 +9,6 @@ export type AvailableSecretCategory = typeof AvailableSecretCategory[keyof typeo
 
 
 export const AvailableSecretCategory = {
-  integration: 'integration',
   custom: 'custom',
   user: 'user',
   team: 'team',

package/src/generated/model/getAgentStreamPaged.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+
+export type GetAgentStreamPaged = typeof GetAgentStreamPaged[keyof typeof GetAgentStreamPaged];
+
+
+export const GetAgentStreamPaged = {
+  true: 'true',
+  false: 'false',
+} as const;

package/src/generated/model/getAgentStreamParams.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { GetAgentStreamPaged } from './getAgentStreamPaged.js';
+
+export type GetAgentStreamParams = {
+paged?: GetAgentStreamPaged;
+/**
+ * @maximum 9007199254740991
+ * @exclusiveMinimum 0
+ */
+before?: number;
+};

package/src/generated/model/getIdpConfig200Config.ts

@@ -11,6 +11,9 @@ export type GetIdpConfig200Config = {
   organizationId: string;
   displayName: string | null;
   issuer: string;
+  idJagEnabled: boolean;
+  idJagAllowedClientIds: string[];
+  jwksUri: string | null;
   groupMappings: GetIdpConfig200ConfigGroupMappingsItem[];
   oktaOrgUrl: string | null;
   oktaSyncEnabled: boolean;

package/src/generated/model/index.ts

@@ -50,7 +50,11 @@ export * from './agentSandboxOptionsCustomSize.js';
 export * from './agentSandboxOptionsResourceSize.js';
 export * from './agentServiceStatus.js';
 export * from './agentServiceStatusesResponse.js';
+export * from './agentSessionIndexEntry.js';
+export * from './agentSessionIndexEntryEntry.js';
+export * from './agentSessionIndexResponse.js';
 export * from './agentStatus.js';
+export * from './agentStreamPageInfo.js';
 export * from './agentTurnState.js';
 export * from './agentView.js';
 export * from './agentViewerAccess.js';
@@ -61,6 +65,8 @@ export * from './approveShareRequestRequestAccess.js';
 export * from './archiveAllAgents200.js';
 export * from './archiveAllAgentsBody.js';
 export * from './assignOrgRoleBody.js';
+export * from './attachAgentMcpServers200.js';
+export * from './attachAgentMcpServers200Activation.js';
 export * from './attachAgentMcpServersBody.js';
 export * from './availableSecret.js';
 export * from './availableSecretCategory.js';
@@ -166,6 +172,8 @@ export * from './flagUserOverride.js';
 export * from './getAgentCommandStatusParams.js';
 export * from './getAgentQueue200Item.js';
 export * from './getAgentQueue200ItemAttachments.js';
+export * from './getAgentStreamPaged.js';
+export * from './getAgentStreamParams.js';
 export * from './getAuthSettings200.js';
 export * from './getAuthSettings200Mode.js';
 export * from './getAuthStatus200.js';
@@ -271,6 +279,7 @@ export * from './organizationSharingSettings.js';
 export * from './organizationStatus.js';
 export * from './organizationSubscription.js';
 export * from './organizationSubscriptionType.js';
+export * from './pagedAgentStreamResponse.js';
 export * from './pollDeviceAuthToken200.js';
 export * from './pollDeviceAuthTokenBody.js';
 export * from './profileStatsResponse.js';

package/src/generated/model/pagedAgentStreamResponse.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AgentStreamPageInfo } from './agentStreamPageInfo.js';
+import type { AxonEvent } from './axonEvent.js';
+
+export interface PagedAgentStreamResponse {
+  events: AxonEvent[];
+  page: AgentStreamPageInfo;
+}

package/src/generated/model/upsertIdpConfig200.ts

@@ -11,6 +11,9 @@ export type UpsertIdpConfig200 = {
   organizationId: string;
   displayName: string | null;
   issuer: string;
+  idJagEnabled: boolean;
+  idJagAllowedClientIds: string[];
+  jwksUri: string | null;
   groupMappings: UpsertIdpConfig200GroupMappingsItem[];
   oktaOrgUrl: string | null;
   oktaSyncEnabled: boolean;

package/src/generated/model/upsertIdpConfigBody.ts

@@ -9,8 +9,17 @@ import type { UpsertIdpConfigBodyGroupMappingsItem } from './upsertIdpConfigBody
 export type UpsertIdpConfigBody = {
   displayName?: string | null;
   issuer: string;
+  idJagEnabled?: boolean;
+  /**
+     * @maxItems 50
+     * @items.minLength 1
+     * @items.maxLength 512
+     */
+  idJagAllowedClientIds?: string[];
+  jwksUri?: string | null;
   /** @maxItems 200 */
   groupMappings?: UpsertIdpConfigBodyGroupMappingsItem[];
   oktaOrgUrl?: string | null;
   oktaSyncEnabled?: boolean;
+  expectedUpdatedAt?: number;
 };

package/src/react/agent-groups.ts

@@ -322,7 +322,7 @@ export const useDeleteAgentGroup = <TError = unknown,
       return useMutation(getDeleteAgentGroupMutationOptions(options));
     }
     /**
- * @summary Add agents to a group.
+ * @summary File agents into a group, moving them out of any other group.
  */
 export const addAgentGroupMembers = (
     groupId: string,
@@ -373,7 +373,7 @@ const {mutation: mutationOptions, request: requestOptions} = options ?
     export type AddAgentGroupMembersMutationError = unknown
 
     /**
- * @summary Add agents to a group.
+ * @summary File agents into a group, moving them out of any other group.
  */
 export const useAddAgentGroupMembers = <TError = unknown,
     TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof addAgentGroupMembers>>, TError,{groupId: string;data: AgentGroupMembersRequest}, TContext>, request?: SecondParameter<typeof apiFetch>}

package/src/react/agents.ts

@@ -34,6 +34,10 @@ import type {
   AgentServiceStatusesResponse
 } from './model/agentServiceStatusesResponse.js';
 
+import type {
+  AgentSessionIndexResponse
+} from './model/agentSessionIndexResponse.js';
+
 import type {
   AgentView
 } from './model/agentView.js';
@@ -50,6 +54,10 @@ import type {
   ArchiveAllAgentsBody
 } from './model/archiveAllAgentsBody.js';
 
+import type {
+  AttachAgentMcpServers200
+} from './model/attachAgentMcpServers200.js';
+
 import type {
   AttachAgentMcpServersBody
 } from './model/attachAgentMcpServersBody.js';
@@ -86,6 +94,10 @@ import type {
   GetAgentQueue200Item
 } from './model/getAgentQueue200Item.js';
 
+import type {
+  GetAgentStreamParams
+} from './model/getAgentStreamParams.js';
+
 import type {
   ListAgents200
 } from './model/listAgents200.js';
@@ -94,6 +106,10 @@ import type {
   ListAgentsParams
 } from './model/listAgentsParams.js';
 
+import type {
+  PagedAgentStreamResponse
+} from './model/pagedAgentStreamResponse.js';
+
 import type {
   RemoveQueuedAgentMessage200
 } from './model/removeQueuedAgentMessage200.js';
@@ -1025,7 +1041,7 @@ export const useSetAgentMark = <TError = unknown,
       return useMutation(getSetAgentMarkMutationOptions(options));
     }
     /**
- * Mints live MCP hub tokens for the devbox and registers each server in the agent's native config immediately, then records the ids on the agent's `mcp-servers` attachment. The devbox must be running (409 `agent_devbox_not_running` otherwise); a registration the box reports as failed is a 502 `mcp_registration_failed` with nothing persisted. Already-attached ids are skipped, unknown or disabled ids are dropped (compare the returned agent's attachments to detect a partial drop), and the request 404s `mcp_config_not_found` only when no id resolves. Local (stdio) servers are rejected because their subprocess secrets only exist as create-time devbox params.
+ * Mints live MCP hub tokens for the devbox and registers each server in the agent's native config immediately, then records the ids on the agent's `mcp-servers` attachment. The devbox must be running (409 `agent_devbox_not_running` otherwise); a registration the box reports as failed is a 502 `mcp_registration_failed` with nothing persisted. `activation` reports whether the agent process that is running right now loaded the servers (`active`, usable on its next turn) or whether they wait on disk for its next start (`deferred`) — both are successful attaches. Already-attached ids are skipped, unknown or disabled ids are dropped (compare the returned agent's attachments to detect a partial drop), and the request 404s `mcp_config_not_found` only when no id resolves. Local (stdio) servers are rejected because their subprocess secrets only exist as create-time devbox params.
  * @summary Attach MCP servers to a running agent's devbox.
  */
 export const attachAgentMcpServers = (
@@ -1035,7 +1051,7 @@ export const attachAgentMcpServers = (
 ) => {
 
 
-      return apiFetch<Agent>(
+      return apiFetch<AttachAgentMcpServers200>(
       {url: `/agents/${encodeURIComponent(String(id))}/mcp-servers`, method: 'POST',
       headers: {'Content-Type': 'application/json', },
       data: attachAgentMcpServersBody, signal
@@ -1741,6 +1757,74 @@ export function useGetAgentServiceStatuses<TData = Awaited<ReturnType<typeof get
 
 
 
+/**
+ * @summary The agent's session index: every prompt and turn boundary, for nav and paging.
+ */
+export const getAgentSessionIndex = (
+    id: string,
+ options?: SecondParameter<typeof apiFetch>,signal?: AbortSignal
+) => {
+
+
+      return apiFetch<AgentSessionIndexResponse>(
+      {url: `/agents/${encodeURIComponent(String(id))}/session-index`, method: 'GET', signal
+    },
+      options);
+    }
+
+
+
+
+export const getGetAgentSessionIndexQueryKey = (id: string,) => {
+    return [
+    `/agents/${id}/session-index`
+    ] as const;
+    }
+
+
+export const getGetAgentSessionIndexQueryOptions = <TData = Awaited<ReturnType<typeof getAgentSessionIndex>>, TError = unknown>(id: string, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentSessionIndex>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetAgentSessionIndexQueryKey(id);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getAgentSessionIndex>>> = ({ signal }) => getAgentSessionIndex(id, requestOptions, signal);
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: id !== null && id !== undefined, ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getAgentSessionIndex>>, TError, TData> & { queryKey: QueryKey }
+}
+
+export type GetAgentSessionIndexQueryResult = NonNullable<Awaited<ReturnType<typeof getAgentSessionIndex>>>
+export type GetAgentSessionIndexQueryError = unknown
+
+
+/**
+ * @summary The agent's session index: every prompt and turn boundary, for nav and paging.
+ */
+
+export function useGetAgentSessionIndex<TData = Awaited<ReturnType<typeof getAgentSessionIndex>>, TError = unknown>(
+ id: string, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentSessionIndex>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+
+ ):  UseQueryResult<TData, TError> & { queryKey: QueryKey } {
+
+  const queryOptions = getGetAgentSessionIndexQueryOptions(id,options)
+
+  const query = useQuery(queryOptions) as  UseQueryResult<TData, TError> & { queryKey: QueryKey };
+
+  return withQueryKey(query, queryOptions.queryKey);
+}
+
+
+
+
+
+
 /**
  * This ends the run: per-run state is stripped from the disk, the capture starts asynchronously, and the devbox shuts down once it completes. Poll the snapshot's status route until the capture finishes.
  * @summary Capture a reusable snapshot of the agent's devbox disk.
@@ -1868,16 +1952,18 @@ export const useStopAgent = <TError = unknown,
       return useMutation(getStopAgentMutationOptions(options));
     }
     /**
- * @summary Get the agent's full event history.
+ * @summary Get the agent's event history: a turn-aligned window for indexed agents, the full array for legacy ones.
  */
 export const getAgentStream = (
     id: string,
+    params?: GetAgentStreamParams,
  options?: SecondParameter<typeof apiFetch>,signal?: AbortSignal
 ) => {
 
 
-      return apiFetch<AxonEvent[]>(
-      {url: `/agents/${encodeURIComponent(String(id))}/stream`, method: 'GET', signal
+      return apiFetch<AxonEvent[] | PagedAgentStreamResponse>(
+      {url: `/agents/${encodeURIComponent(String(id))}/stream`, method: 'GET',
+        params, signal
     },
       options);
     }
@@ -1885,23 +1971,25 @@ export const getAgentStream = (
 
 
 
-export const getGetAgentStreamQueryKey = (id: string,) => {
+export const getGetAgentStreamQueryKey = (id: string,
+    params?: GetAgentStreamParams,) => {
     return [
-    `/agents/${id}/stream`
+    `/agents/${id}/stream`, ...(params ? [params] : [])
     ] as const;
     }
 
 
-export const getGetAgentStreamQueryOptions = <TData = Awaited<ReturnType<typeof getAgentStream>>, TError = unknown>(id: string, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentStream>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+export const getGetAgentStreamQueryOptions = <TData = Awaited<ReturnType<typeof getAgentStream>>, TError = unknown>(id: string,
+    params?: GetAgentStreamParams, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentStream>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
 ) => {
 
 const {query: queryOptions, request: requestOptions} = options ?? {};
 
-  const queryKey =  queryOptions?.queryKey ?? getGetAgentStreamQueryKey(id);
+  const queryKey =  queryOptions?.queryKey ?? getGetAgentStreamQueryKey(id,params);
 
 
 
-    const queryFn: QueryFunction<Awaited<ReturnType<typeof getAgentStream>>> = ({ signal }) => getAgentStream(id, requestOptions, signal);
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getAgentStream>>> = ({ signal }) => getAgentStream(id,params, requestOptions, signal);
 
 
 
@@ -1915,15 +2003,16 @@ export type GetAgentStreamQueryError = unknown
 
 
 /**
- * @summary Get the agent's full event history.
+ * @summary Get the agent's event history: a turn-aligned window for indexed agents, the full array for legacy ones.
  */
 
 export function useGetAgentStream<TData = Awaited<ReturnType<typeof getAgentStream>>, TError = unknown>(
- id: string, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentStream>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
+ id: string,
+    params?: GetAgentStreamParams, options?: { query?:UseQueryOptions<Awaited<ReturnType<typeof getAgentStream>>, TError, TData>, request?: SecondParameter<typeof apiFetch>}
 
  ):  UseQueryResult<TData, TError> & { queryKey: QueryKey } {
 
-  const queryOptions = getGetAgentStreamQueryOptions(id,options)
+  const queryOptions = getGetAgentStreamQueryOptions(id,params,options)
 
   const query = useQuery(queryOptions) as  UseQueryResult<TData, TError> & { queryKey: QueryKey };
 

package/src/react/model/agentSessionIndexEntry.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.18.0 🍺
+ * Do not edit manually.
+ * Reflex API
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AgentSessionIndexEntryEntry } from './agentSessionIndexEntryEntry.js';
+
+export interface AgentSessionIndexEntry {
+  seqNumber: number;
+  timestamp: number | null;
+  entry: AgentSessionIndexEntryEntry;
+}