@ziggs-ai/api-client 0.37.15 → 0.37.16

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.37.16
+
+- `messages` can ask for the newest page. A forward delta still needs a timestamp.
+
 ## 0.37.15
 
 - A caller can leave one pending proposal unshouted. Later inbox reads name it as parked.

package/dist/http/MessagesClient.d.ts

@@ -4,6 +4,14 @@ export interface ListMessagesOptions {
     /** Page size, default 100, hard cap 1000. */
     limit?: number;
 }
+/**
+ * The chat message URL.
+ *
+ * `after` is a forward delta: the server returns that page only when both
+ * `after` and `direction=forward` are set. Omitting both is the newest page,
+ * which is how a person asks what just happened without already knowing a time.
+ */
+export declare function messagesListUrl(base: string, chatId: string, opts?: ListMessagesOptions): string;
 export interface ListMessagesResult {
     messages: unknown[];
     latestSequence: string | null;
@@ -21,5 +29,12 @@ export declare class MessagesClient {
     private readonly agentId;
     constructor(operatorKey: string, agentId: string);
     list(chatId: string, opts?: ListMessagesOptions): Promise<ListMessagesResult>;
+    /**
+     * Newest page. No `after`, so the server walks backward from now.
+     * `list` is the forward delta and cannot answer "what just happened".
+     */
+    listLatest(chatId: string, opts?: {
+        limit?: number;
+    }): Promise<ListMessagesResult>;
     private _headers;
 }

package/dist/http/MessagesClient.js

@@ -2,6 +2,23 @@ import { decodeOperatorKeyClaims } from '../shared/operatorKey.js';
 import { buildOperatorHeaders } from './operatorHeaders.js';
 import { getBackendUrl } from '../utils/urlUtils.js';
 import { throwApiError } from '../shared/apiError.js';
+/**
+ * The chat message URL.
+ *
+ * `after` is a forward delta: the server returns that page only when both
+ * `after` and `direction=forward` are set. Omitting both is the newest page,
+ * which is how a person asks what just happened without already knowing a time.
+ */
+export function messagesListUrl(base, chatId, opts = {}) {
+    const url = new URL(`${base}/chats/${encodeURIComponent(chatId)}/messages`);
+    if (opts.after) {
+        url.searchParams.set('direction', 'forward');
+        url.searchParams.set('after', opts.after);
+    }
+    if (opts.limit != null)
+        url.searchParams.set('limit', String(opts.limit));
+    return url.toString();
+}
 /**
  * Read-side client for forward-delta message reads.
  *
@@ -24,17 +41,16 @@ export class MessagesClient {
     async list(chatId, opts = {}) {
         if (!chatId)
             return { messages: [], latestSequence: null };
-        const url = new URL(`${getBackendUrl()}/chats/${encodeURIComponent(chatId)}/messages`);
         // Forward-delta read mode. Backend routes to `listMessagesForward`
         // only when BOTH `after` and `direction=forward` are present; without
         // `after` the same handler falls into backward pagination and returns
         // a different envelope. Default `after` to the unix epoch so the
         // forward branch always wins when callers want "from the beginning".
-        url.searchParams.set('direction', 'forward');
-        url.searchParams.set('after', opts.after || '1970-01-01T00:00:00.000Z');
-        if (opts.limit != null)
-            url.searchParams.set('limit', String(opts.limit));
-        const res = await fetch(url.toString(), { headers: this._headers() });
+        const url = messagesListUrl(getBackendUrl(), chatId, {
+            after: opts.after || '1970-01-01T00:00:00.000Z',
+            limit: opts.limit,
+        });
+        const res = await fetch(url, { headers: this._headers() });
         if (!res.ok) {
             const body = await res.text().catch(() => '');
             // Callers branch on ApiError.status (404 = chat deleted/not visible).
@@ -42,6 +58,20 @@ export class MessagesClient {
         }
         return (await res.json());
     }
+    /**
+     * Newest page. No `after`, so the server walks backward from now.
+     * `list` is the forward delta and cannot answer "what just happened".
+     */
+    async listLatest(chatId, opts = {}) {
+        if (!chatId)
+            return { messages: [], latestSequence: null };
+        const res = await fetch(messagesListUrl(getBackendUrl(), chatId, { limit: opts.limit }), { headers: this._headers() });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throwApiError(res, body, `MessagesClient.listLatest failed: ${res.status}`);
+        }
+        return (await res.json());
+    }
     _headers() {
         return {
             'content-type': 'application/json',

package/dist/http/index.d.ts

@@ -3,7 +3,7 @@ export * from './AgreementClient.js';
 export * from './MarketplaceClient.js';
 export * from './agreementFlows.js';
 export * from './ChatClient.js';
-export { MessagesClient } from './MessagesClient.js';
+export { MessagesClient, messagesListUrl } from './MessagesClient.js';
 export type { ListMessagesOptions, ListMessagesResult } from './MessagesClient.js';
 export { ArtifactsClient, artifactScopeForSession, AGREEMENT_LANE_PREFIX, ARTIFACT_INLINE_TEXT_MAX_CHARS, ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT, } from './ArtifactsClient.js';
 export type { ArtifactVisibility, ListArtifactsOptions, ListArtifactsQuery, ListArtifactsResult, WriteArtifactInput, } from './ArtifactsClient.js';

package/dist/http/index.js

@@ -3,7 +3,7 @@ export * from './AgreementClient.js';
 export * from './MarketplaceClient.js';
 export * from './agreementFlows.js';
 export * from './ChatClient.js';
-export { MessagesClient } from './MessagesClient.js';
+export { MessagesClient, messagesListUrl } from './MessagesClient.js';
 export { ArtifactsClient, 
 // agreement lanes are not chats — callers scope artifact writes with this.
 artifactScopeForSession, AGREEMENT_LANE_PREFIX, ARTIFACT_INLINE_TEXT_MAX_CHARS, ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT, } from './ArtifactsClient.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.37.15",
+  "version": "0.37.16",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {