doover-js 0.13.2 → 0.14.0

package/dist/apis/messages-api.d.ts

@@ -20,10 +20,32 @@ export interface ListMessagesParams {
      * index 0.
      */
     order?: "asc" | "desc";
+}
+/**
+ * `getTimeseries` options. The endpoint always returns `{ results, count,
+ * next }`: while `next` is set there's more, and passing it back as `before`
+ * continues newest → oldest.
+ */
+export interface TimeseriesParams {
+    /** Exclusive upper bound, and the paging cursor (a response's `next`). */
+    before?: string;
+    /**
+     * Lower bound. A missing bound is filled a week from the other, so unlike
+     * `listMessages`, `after` on its own doesn't page forward: it reads the
+     * newest `limit` points in the week after it.
+     */
+    after?: string;
+    /** Points per page; the server sends 50 without it and allows 1500. */
+    limit?: number;
+    field_name?: string[];
+    /**
+     * `"desc"` (default) keeps the server's newest-first order; `"asc"`
+     * reverses each page client-side so the oldest point is at index 0.
+     */
+    order?: "asc" | "desc";
     /**
-     * Opt into paginated timeseries responses (`getTimeseries` only). When true
-     * the server returns a `next` cursor alongside `{ results, count }`; pass it
-     * back as `before` to page through results.
+     * @deprecated No effect, and no longer sent: the endpoint has no such
+     * parameter and always returns `next`.
      */
     paginate?: boolean;
 }
@@ -52,11 +74,11 @@ export declare class MessagesApi {
         channelName: string;
     }, body: MessageBody): Promise<MessageStructure>;
     private _postMessage;
-    getTimeseries(agentId: string, channelName: string, params: ListMessagesParams): Promise<DataSeries>;
+    getTimeseries(agentId: string, channelName: string, params: TimeseriesParams): Promise<DataSeries>;
     getTimeseries(identifier: {
         agentId: string;
         channelName: string;
-    }, params: ListMessagesParams): Promise<DataSeries>;
+    }, params: TimeseriesParams): Promise<DataSeries>;
     private _getTimeseries;
     getMessage(agentId: string, channelName: string, messageId: string): Promise<MessageStructure>;
     getMessage(identifier: {

package/dist/apis/messages-api.js

@@ -66,9 +66,19 @@ class MessagesApi {
         const { agentId, channelName, options } = (0, _args_js_1.resolveChannelArgs)(args);
         return this._getTimeseries(agentId, channelName, options);
     }
-    _getTimeseries(agentId, channelName, params) {
-        const { order: _order, ...rest } = params;
-        return this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/timeseries`, rest);
+    async _getTimeseries(agentId, channelName, params) {
+        const { order, paginate: _paginate, ...query } = params;
+        const series = await this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/timeseries`, query);
+        // Older servers sent `next` as a JSON number; keep the declared string
+        // type (the digits past 2^53 were already rounded in parsing).
+        const next = series.next;
+        return {
+            ...series,
+            ...(typeof next === "number" ? { next: String(next) } : {}),
+            results: order === "asc" && series.results
+                ? [...series.results].reverse()
+                : series.results,
+        };
     }
     async getMessage(...args) {
         if (typeof args[0] === "string") {

package/dist/esm/apis/messages-api.d.ts

@@ -20,10 +20,32 @@ export interface ListMessagesParams {
      * index 0.
      */
     order?: "asc" | "desc";
+}
+/**
+ * `getTimeseries` options. The endpoint always returns `{ results, count,
+ * next }`: while `next` is set there's more, and passing it back as `before`
+ * continues newest → oldest.
+ */
+export interface TimeseriesParams {
+    /** Exclusive upper bound, and the paging cursor (a response's `next`). */
+    before?: string;
+    /**
+     * Lower bound. A missing bound is filled a week from the other, so unlike
+     * `listMessages`, `after` on its own doesn't page forward: it reads the
+     * newest `limit` points in the week after it.
+     */
+    after?: string;
+    /** Points per page; the server sends 50 without it and allows 1500. */
+    limit?: number;
+    field_name?: string[];
+    /**
+     * `"desc"` (default) keeps the server's newest-first order; `"asc"`
+     * reverses each page client-side so the oldest point is at index 0.
+     */
+    order?: "asc" | "desc";
     /**
-     * Opt into paginated timeseries responses (`getTimeseries` only). When true
-     * the server returns a `next` cursor alongside `{ results, count }`; pass it
-     * back as `before` to page through results.
+     * @deprecated No effect, and no longer sent: the endpoint has no such
+     * parameter and always returns `next`.
      */
     paginate?: boolean;
 }
@@ -52,11 +74,11 @@ export declare class MessagesApi {
         channelName: string;
     }, body: MessageBody): Promise<MessageStructure>;
     private _postMessage;
-    getTimeseries(agentId: string, channelName: string, params: ListMessagesParams): Promise<DataSeries>;
+    getTimeseries(agentId: string, channelName: string, params: TimeseriesParams): Promise<DataSeries>;
     getTimeseries(identifier: {
         agentId: string;
         channelName: string;
-    }, params: ListMessagesParams): Promise<DataSeries>;
+    }, params: TimeseriesParams): Promise<DataSeries>;
     private _getTimeseries;
     getMessage(agentId: string, channelName: string, messageId: string): Promise<MessageStructure>;
     getMessage(identifier: {

package/dist/esm/apis/messages-api.js

@@ -63,9 +63,19 @@ export class MessagesApi {
         const { agentId, channelName, options } = resolveChannelArgs(args);
         return this._getTimeseries(agentId, channelName, options);
     }
-    _getTimeseries(agentId, channelName, params) {
-        const { order: _order, ...rest } = params;
-        return this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/timeseries`, rest);
+    async _getTimeseries(agentId, channelName, params) {
+        const { order, paginate: _paginate, ...query } = params;
+        const series = await this.rest.get(`/agents/${agentId}/channels/${channelName}/messages/timeseries`, query);
+        // Older servers sent `next` as a JSON number; keep the declared string
+        // type (the digits past 2^53 were already rounded in parsing).
+        const next = series.next;
+        return {
+            ...series,
+            ...(typeof next === "number" ? { next: String(next) } : {}),
+            results: order === "asc" && series.results
+                ? [...series.results].reverse()
+                : series.results,
+        };
     }
     async getMessage(...args) {
         if (typeof args[0] === "string") {

package/dist/esm/package.json

@@ -1 +1 @@
-{"name":"doover-js","version":"0.13.2","type":"module","sideEffects":false}
+{"name":"doover-js","version":"0.14.0","type":"module","sideEffects":false}

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

@@ -28,7 +28,7 @@ export { useSendRpc } from "./useSendRpc.js";
 export type { RpcCommandId, RpcStatusEvent, SendRpcVariables, UseSendRpcOptions, UseSendRpcResult, } from "./useSendRpc.js";
 export { useMultiAgentAggregates, multiAgentAggregatesQueryKey, } from "./useMultiAgentAggregates.js";
 export type { UseMultiAgentAggregatesOptions, UseMultiAgentAggregatesResult, } from "./useMultiAgentAggregates.js";
-export { useMultiAgentChannelMessages, multiAgentChannelMessagesQueryKey, } from "./useMultiAgentChannelMessages.js";
+export { useMultiAgentChannelMessages, multiAgentChannelMessagesQueryKey, MULTI_AGENT_MAX_WINDOW_MS, } from "./useMultiAgentChannelMessages.js";
 export type { UseMultiAgentChannelMessagesOptions, UseMultiAgentChannelMessagesResult, } from "./useMultiAgentChannelMessages.js";
 export { useDeviceMap } from "./useDeviceMap.js";
 export type { DeviceMapEntry, UseDeviceMapOptions, UseDeviceMapResult, } from "./useDeviceMap.js";

package/dist/esm/react/index.js

@@ -14,7 +14,7 @@ export { useChannelMessage, channelMessageQueryKey, } from "./useChannelMessage.
 export { useInvocationLogs, invocationLogsQueryKey, } from "./useInvocationLogs.js";
 export { useSendRpc } from "./useSendRpc.js";
 export { useMultiAgentAggregates, multiAgentAggregatesQueryKey, } from "./useMultiAgentAggregates.js";
-export { useMultiAgentChannelMessages, multiAgentChannelMessagesQueryKey, } from "./useMultiAgentChannelMessages.js";
+export { useMultiAgentChannelMessages, multiAgentChannelMessagesQueryKey, MULTI_AGENT_MAX_WINDOW_MS, } from "./useMultiAgentChannelMessages.js";
 export { useDeviceMap } from "./useDeviceMap.js";
 export { useTurnCredentials } from "./useTurnCredentials.js";
 export { useAgentTokenState, useSetAgentTokenPolicy, useSetAgentAuthLock, useRevokeAgentTokens, useSetRevocationFloor, useCreateAdhocToken, useCreateDeviceToken, agentTokenStateQueryKey, } from "./useAgentTokenState.js";

package/dist/esm/react/useMultiAgentChannelMessages.d.ts

@@ -1,5 +1,12 @@
 import { type InfiniteData, type UseInfiniteQueryResult } from "@tanstack/react-query";
 import type { MessageStructure } from "../types/common.js";
+/**
+ * Widest `before - after` span one multi-agent request may cover. The server
+ * caps it at 7 days (it walks each agent's history a day at a time); the
+ * minute's margin keeps each request clear of the cap. Longer ranges are
+ * read as a series of these, newest first.
+ */
+export declare const MULTI_AGENT_MAX_WINDOW_MS: number;
 export declare function multiAgentChannelMessagesQueryKey(channelName: string, agentIds: string[], sources?: string[], scope?: {
     after?: string;
     fields?: readonly string[];
@@ -25,7 +32,12 @@ export interface UseMultiAgentChannelMessagesOptions {
      * of these top-level field names. Forwarded as `field_name`.
      */
     fields?: string[];
-    /** Optional first-page `before` cursor (snowflake id). */
+    /**
+     * Optional first-page `before` cursor (snowflake id). With `after`, it
+     * bounds a time range, which may be wider than the server's 7-day cap:
+     * the range is then read a window at a time, each further window arriving
+     * as more pages (see `after`).
+     */
     initialBefore?: string;
     /**
      * Keep paging older automatically until `hasNextPage` is false. Each page
@@ -48,6 +60,14 @@ export interface UseMultiAgentChannelMessagesOptions {
      * mirrors `useChannelMessages`'s `after`. Use this to fetch a bounded
      * time window (e.g. last 24h) across many agents without filtering
      * on the client.
+     *
+     * With `initialBefore` more than `MULTI_AGENT_MAX_WINDOW_MS` before it, the
+     * range is split into windows the server accepts, read newest first:
+     * `fetchNextPage` finishes one window's per-agent cursors, then moves on
+     * to the next window, and `hasNextPage` stays true until the whole range
+     * is read. A quiet window can come back empty, so fetch on until you have
+     * what you need (or set `autoPaginate`, raising `maxPages` for a long
+     * range: a year is 53 windows).
      */
     after?: string;
     /**

package/dist/esm/react/useMultiAgentChannelMessages.js

@@ -1,6 +1,15 @@
 import { useCallback, useEffect, useMemo } from "react";
 import { useInfiniteQuery, useQueryClient, } from "@tanstack/react-query";
 import { useDooverClient } from "./context.js";
+/**
+ * Widest `before - after` span one multi-agent request may cover. The server
+ * caps it at 7 days (it walks each agent's history a day at a time); the
+ * minute's margin keeps each request clear of the cap. Longer ranges are
+ * read as a series of these, newest first.
+ */
+export const MULTI_AGENT_MAX_WINDOW_MS = 7 * 24 * 60 * 60 * 1000 - 60000;
+/** The window above as a snowflake-id delta (ids carry ms in bits 22+). */
+const MAX_WINDOW_ID_SPAN = BigInt(MULTI_AGENT_MAX_WINDOW_MS) << 22n;
 export function multiAgentChannelMessagesQueryKey(channelName, agentIds, sources, scope) {
     const sourceDim = sources && sources.length ? [...sources].sort().join(",") : "*";
     const base = [
@@ -26,6 +35,31 @@ export function multiAgentChannelMessagesQueryKey(channelName, agentIds, sources
         ? [...base, scopeKey]
         : base;
 }
+/** The window ending at `before`, reaching back no further than `after`. */
+function windowEndingAt(before, after) {
+    const start = BigInt(before) - MAX_WINDOW_ID_SPAN;
+    const floor = BigInt(after);
+    return {
+        windowBefore: before,
+        windowAfter: (start > floor ? start : floor).toString(),
+    };
+}
+/**
+ * Within a windowed range: carry on inside the current window, or once it's
+ * drained, step back to the window before it until the range's `after`.
+ */
+function nextWindowedPageParam(lastPage, lastParam, after) {
+    const { windowBefore, windowAfter } = lastParam;
+    if (windowBefore === undefined || windowAfter === undefined) {
+        return nextPageParam(lastPage);
+    }
+    const within = nextPageParam(lastPage);
+    if (within)
+        return { ...within, windowBefore, windowAfter };
+    if (BigInt(windowAfter) <= BigInt(after))
+        return undefined;
+    return windowEndingAt(windowAfter, after);
+}
 function nextPageParam(lastPage) {
     if (!lastPage)
         return undefined;
@@ -107,23 +141,36 @@ export function useMultiAgentChannelMessages(channelName, agentIds, options) {
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [client, channelName, liveUpdates, agentIds.join(",")]);
+    // A range wider than the server accepts in one request is read a window
+    // at a time; narrower ones (and open-ended reads) are one window as ever.
+    const windowed = after !== undefined &&
+        initialBefore !== undefined &&
+        BigInt(initialBefore) - BigInt(after) > MAX_WINDOW_ID_SPAN;
     const query = useInfiniteQuery({
         queryKey: key,
         enabled: agentIds.length > 0,
         staleTime: Infinity,
-        initialPageParam: (initialBefore ? { before: initialBefore } : {}),
-        getNextPageParam: nextPageParam,
+        initialPageParam: (windowed
+            ? windowEndingAt(initialBefore, after)
+            : initialBefore
+                ? { before: initialBefore }
+                : {}),
+        getNextPageParam: (lastPage, _allPages, lastParam) => windowed
+            ? nextWindowedPageParam(lastPage, lastParam, after)
+            : nextPageParam(lastPage),
         queryFn: async ({ pageParam }) => {
+            const before = pageParam.before ?? pageParam.windowBefore;
+            const lowerBound = pageParam.windowAfter ?? after;
             const params = {
                 agent_id: pageParam.agentIds ?? agentIds,
-                ...(pageParam.before ? { before: pageParam.before } : {}),
+                ...(before ? { before } : {}),
                 ...(pageParam.agentBefore ? { agent_before: pageParam.agentBefore } : {}),
                 ...(limit !== undefined ? { limit } : {}),
                 ...(agentMessageLimit !== undefined
                     ? { agent_message_limit: agentMessageLimit }
                     : {}),
                 ...(fields && fields.length > 0 ? { field_name: fields } : {}),
-                ...(after !== undefined ? { after } : {}),
+                ...(lowerBound !== undefined ? { after: lowerBound } : {}),
             };
             // Pass `{ sources }` as a trailing bag only when set — cast through
             // `never` since the TypeScript overloads don't declare it.

package/dist/react/index.d.ts

@@ -28,7 +28,7 @@ export { useSendRpc } from "./useSendRpc.js";
 export type { RpcCommandId, RpcStatusEvent, SendRpcVariables, UseSendRpcOptions, UseSendRpcResult, } from "./useSendRpc.js";
 export { useMultiAgentAggregates, multiAgentAggregatesQueryKey, } from "./useMultiAgentAggregates.js";
 export type { UseMultiAgentAggregatesOptions, UseMultiAgentAggregatesResult, } from "./useMultiAgentAggregates.js";
-export { useMultiAgentChannelMessages, multiAgentChannelMessagesQueryKey, } from "./useMultiAgentChannelMessages.js";
+export { useMultiAgentChannelMessages, multiAgentChannelMessagesQueryKey, MULTI_AGENT_MAX_WINDOW_MS, } from "./useMultiAgentChannelMessages.js";
 export type { UseMultiAgentChannelMessagesOptions, UseMultiAgentChannelMessagesResult, } from "./useMultiAgentChannelMessages.js";
 export { useDeviceMap } from "./useDeviceMap.js";
 export type { DeviceMapEntry, UseDeviceMapOptions, UseDeviceMapResult, } from "./useDeviceMap.js";

package/dist/react/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useServiceReachability = exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.agentTokenStateQueryKey = exports.useCreateDeviceToken = exports.useCreateAdhocToken = exports.useSetRevocationFloor = exports.useRevokeAgentTokens = exports.useSetAgentAuthLock = exports.useSetAgentTokenPolicy = exports.useAgentTokenState = exports.useTurnCredentials = exports.useDeviceMap = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.invocationLogsQueryKey = exports.useInvocationLogs = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.hasOfflineStatus = exports.useOfflineStatus = exports.useClientStatus = exports.useDooverClient = exports.DooverProvider = void 0;
+exports.useServiceReachability = exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.agentTokenStateQueryKey = exports.useCreateDeviceToken = exports.useCreateAdhocToken = exports.useSetRevocationFloor = exports.useRevokeAgentTokens = exports.useSetAgentAuthLock = exports.useSetAgentTokenPolicy = exports.useAgentTokenState = exports.useTurnCredentials = exports.useDeviceMap = exports.MULTI_AGENT_MAX_WINDOW_MS = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.invocationLogsQueryKey = exports.useInvocationLogs = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.hasOfflineStatus = exports.useOfflineStatus = exports.useClientStatus = exports.useDooverClient = exports.DooverProvider = void 0;
 var context_js_1 = require("./context.js");
 Object.defineProperty(exports, "DooverProvider", { enumerable: true, get: function () { return context_js_1.DooverProvider; } });
 Object.defineProperty(exports, "useDooverClient", { enumerable: true, get: function () { return context_js_1.useDooverClient; } });
@@ -44,6 +44,7 @@ Object.defineProperty(exports, "multiAgentAggregatesQueryKey", { enumerable: tru
 var useMultiAgentChannelMessages_js_1 = require("./useMultiAgentChannelMessages.js");
 Object.defineProperty(exports, "useMultiAgentChannelMessages", { enumerable: true, get: function () { return useMultiAgentChannelMessages_js_1.useMultiAgentChannelMessages; } });
 Object.defineProperty(exports, "multiAgentChannelMessagesQueryKey", { enumerable: true, get: function () { return useMultiAgentChannelMessages_js_1.multiAgentChannelMessagesQueryKey; } });
+Object.defineProperty(exports, "MULTI_AGENT_MAX_WINDOW_MS", { enumerable: true, get: function () { return useMultiAgentChannelMessages_js_1.MULTI_AGENT_MAX_WINDOW_MS; } });
 var useDeviceMap_js_1 = require("./useDeviceMap.js");
 Object.defineProperty(exports, "useDeviceMap", { enumerable: true, get: function () { return useDeviceMap_js_1.useDeviceMap; } });
 var useTurnCredentials_js_1 = require("./useTurnCredentials.js");

package/dist/react/useMultiAgentChannelMessages.d.ts

@@ -1,5 +1,12 @@
 import { type InfiniteData, type UseInfiniteQueryResult } from "@tanstack/react-query";
 import type { MessageStructure } from "../types/common.js";
+/**
+ * Widest `before - after` span one multi-agent request may cover. The server
+ * caps it at 7 days (it walks each agent's history a day at a time); the
+ * minute's margin keeps each request clear of the cap. Longer ranges are
+ * read as a series of these, newest first.
+ */
+export declare const MULTI_AGENT_MAX_WINDOW_MS: number;
 export declare function multiAgentChannelMessagesQueryKey(channelName: string, agentIds: string[], sources?: string[], scope?: {
     after?: string;
     fields?: readonly string[];
@@ -25,7 +32,12 @@ export interface UseMultiAgentChannelMessagesOptions {
      * of these top-level field names. Forwarded as `field_name`.
      */
     fields?: string[];
-    /** Optional first-page `before` cursor (snowflake id). */
+    /**
+     * Optional first-page `before` cursor (snowflake id). With `after`, it
+     * bounds a time range, which may be wider than the server's 7-day cap:
+     * the range is then read a window at a time, each further window arriving
+     * as more pages (see `after`).
+     */
     initialBefore?: string;
     /**
      * Keep paging older automatically until `hasNextPage` is false. Each page
@@ -48,6 +60,14 @@ export interface UseMultiAgentChannelMessagesOptions {
      * mirrors `useChannelMessages`'s `after`. Use this to fetch a bounded
      * time window (e.g. last 24h) across many agents without filtering
      * on the client.
+     *
+     * With `initialBefore` more than `MULTI_AGENT_MAX_WINDOW_MS` before it, the
+     * range is split into windows the server accepts, read newest first:
+     * `fetchNextPage` finishes one window's per-agent cursors, then moves on
+     * to the next window, and `hasNextPage` stays true until the whole range
+     * is read. A quiet window can come back empty, so fetch on until you have
+     * what you need (or set `autoPaginate`, raising `maxPages` for a long
+     * range: a year is 53 windows).
      */
     after?: string;
     /**

package/dist/react/useMultiAgentChannelMessages.js

@@ -1,10 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTI_AGENT_MAX_WINDOW_MS = void 0;
 exports.multiAgentChannelMessagesQueryKey = multiAgentChannelMessagesQueryKey;
 exports.useMultiAgentChannelMessages = useMultiAgentChannelMessages;
 const react_1 = require("react");
 const react_query_1 = require("@tanstack/react-query");
 const context_js_1 = require("./context.js");
+/**
+ * Widest `before - after` span one multi-agent request may cover. The server
+ * caps it at 7 days (it walks each agent's history a day at a time); the
+ * minute's margin keeps each request clear of the cap. Longer ranges are
+ * read as a series of these, newest first.
+ */
+exports.MULTI_AGENT_MAX_WINDOW_MS = 7 * 24 * 60 * 60 * 1000 - 60000;
+/** The window above as a snowflake-id delta (ids carry ms in bits 22+). */
+const MAX_WINDOW_ID_SPAN = BigInt(exports.MULTI_AGENT_MAX_WINDOW_MS) << 22n;
 function multiAgentChannelMessagesQueryKey(channelName, agentIds, sources, scope) {
     const sourceDim = sources && sources.length ? [...sources].sort().join(",") : "*";
     const base = [
@@ -30,6 +40,31 @@ function multiAgentChannelMessagesQueryKey(channelName, agentIds, sources, scope
         ? [...base, scopeKey]
         : base;
 }
+/** The window ending at `before`, reaching back no further than `after`. */
+function windowEndingAt(before, after) {
+    const start = BigInt(before) - MAX_WINDOW_ID_SPAN;
+    const floor = BigInt(after);
+    return {
+        windowBefore: before,
+        windowAfter: (start > floor ? start : floor).toString(),
+    };
+}
+/**
+ * Within a windowed range: carry on inside the current window, or once it's
+ * drained, step back to the window before it until the range's `after`.
+ */
+function nextWindowedPageParam(lastPage, lastParam, after) {
+    const { windowBefore, windowAfter } = lastParam;
+    if (windowBefore === undefined || windowAfter === undefined) {
+        return nextPageParam(lastPage);
+    }
+    const within = nextPageParam(lastPage);
+    if (within)
+        return { ...within, windowBefore, windowAfter };
+    if (BigInt(windowAfter) <= BigInt(after))
+        return undefined;
+    return windowEndingAt(windowAfter, after);
+}
 function nextPageParam(lastPage) {
     if (!lastPage)
         return undefined;
@@ -111,23 +146,36 @@ function useMultiAgentChannelMessages(channelName, agentIds, options) {
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [client, channelName, liveUpdates, agentIds.join(",")]);
+    // A range wider than the server accepts in one request is read a window
+    // at a time; narrower ones (and open-ended reads) are one window as ever.
+    const windowed = after !== undefined &&
+        initialBefore !== undefined &&
+        BigInt(initialBefore) - BigInt(after) > MAX_WINDOW_ID_SPAN;
     const query = (0, react_query_1.useInfiniteQuery)({
         queryKey: key,
         enabled: agentIds.length > 0,
         staleTime: Infinity,
-        initialPageParam: (initialBefore ? { before: initialBefore } : {}),
-        getNextPageParam: nextPageParam,
+        initialPageParam: (windowed
+            ? windowEndingAt(initialBefore, after)
+            : initialBefore
+                ? { before: initialBefore }
+                : {}),
+        getNextPageParam: (lastPage, _allPages, lastParam) => windowed
+            ? nextWindowedPageParam(lastPage, lastParam, after)
+            : nextPageParam(lastPage),
         queryFn: async ({ pageParam }) => {
+            const before = pageParam.before ?? pageParam.windowBefore;
+            const lowerBound = pageParam.windowAfter ?? after;
             const params = {
                 agent_id: pageParam.agentIds ?? agentIds,
-                ...(pageParam.before ? { before: pageParam.before } : {}),
+                ...(before ? { before } : {}),
                 ...(pageParam.agentBefore ? { agent_before: pageParam.agentBefore } : {}),
                 ...(limit !== undefined ? { limit } : {}),
                 ...(agentMessageLimit !== undefined
                     ? { agent_message_limit: agentMessageLimit }
                     : {}),
                 ...(fields && fields.length > 0 ? { field_name: fields } : {}),
-                ...(after !== undefined ? { after } : {}),
+                ...(lowerBound !== undefined ? { after: lowerBound } : {}),
             };
             // Pass `{ sources }` as a trailing bag only when set — cast through
             // `never` since the TypeScript overloads don't declare it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doover-js",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "description": "TypeScript client for Doover.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",