@ziggs-ai/api-client 0.33.1 → 0.34.1

package/dist/capabilities/chat.d.ts

@@ -13,6 +13,7 @@ export interface SendPresentation {
         type: string;
     };
     workContext?: WorkContext;
+    delivery?: SendChatMessageResult['delivery'];
 }
 /**
  * Present a send as what it is: a message that now exists, addressed to

package/dist/capabilities/chat.js

@@ -38,10 +38,14 @@ export function presentSendResult(result, env) {
     // What counted it, in the server's words: a stranger's free messages with a
     // listed agent run out, and the person writing needs to know before they do.
     const counted = result.coverage?.message ? ` ${result.coverage.message}` : '';
+    const routing = delivery.reachable
+        ? `Assigned to ${delivery.assignee ?? 'nobody'}; reachable: ${delivery.reachable}${delivery.reason ? ` (${delivery.reason})` : ''}.${delivery.lastRead ? ` Last inbox read: ${delivery.lastRead}.` : ''}`
+        : 'Mailbox routing is unconfirmed; a person may be covered by an assistant.';
     return {
         ...base,
-        delivered: `Message ${result.messageId} was accepted into chat ${result.chatId}, addressed to ${destination}. Mailbox routing is unconfirmed; a person may be covered by an assistant. Accepted is not read and does not confirm a wake or reply.${counted}`,
+        delivered: `Message ${result.messageId} was accepted into chat ${result.chatId}, addressed to ${destination}. ${routing} Accepted is not read and does not confirm a wake or reply.${counted}`,
         to: delivery.to,
+        delivery,
     };
 }
 /**

package/dist/http/ChatClient.d.ts

@@ -1,5 +1,5 @@
 import type { ChatReadDto } from '@ziggs-ai/contracts';
-import type { MessageDelivery, SendChatMessageResult as WireSendChatMessageResult } from '@ziggs-ai/contracts';
+import type { MessageDelivery as WireMessageDelivery, SendChatMessageResult as WireSendChatMessageResult } from '@ziggs-ai/contracts';
 import { type Creds } from '../types.js';
 /**
  * One room from `GET /chats/mine`, as the server sends it.
@@ -85,7 +85,12 @@ export interface SendChatMessageInput {
  * `wakesAgent` field that once rode along was removed for exactly that reason
  * and is not coming back.
  */
-export type { MessageDelivery } from '@ziggs-ai/contracts';
+export type MessageDelivery = WireMessageDelivery & {
+    assignee?: string | null;
+    reachable?: 'yes' | 'no';
+    reason?: string;
+    lastRead?: string | null;
+};
 /**
  * The send result as a caller here holds it.
  *

package/dist/http/ContextReadClient.d.ts

@@ -105,6 +105,8 @@ export declare class ContextReadClient {
      *   intended. Send it on every read made while acting on a wake.
      */
     constructor(operatorKey: string, agentId?: string, baseUrl?: string, laneId?: string);
+    /** The same reader acting on one wake's lane. */
+    withLane(laneId: string | undefined): ContextReadClient;
     read<T = unknown>(type: ContextReadType, query: ContextReadQuery): Promise<ContextReadEnvelope<T>>;
     /**
      * Aggregated chat snapshot — `GET /context/snapshot?via=chat:<id>`. The

package/dist/http/ContextReadClient.js

@@ -74,6 +74,12 @@ export class ContextReadClient {
         this.baseUrl = baseUrl || getBackendUrl();
         this.laneId = laneId;
     }
+    /** The same reader acting on one wake's lane. */
+    withLane(laneId) {
+        if (!laneId || laneId === this.laneId)
+            return this;
+        return new ContextReadClient(this.operatorKey, this.agentId, this.baseUrl, laneId);
+    }
     async read(type, query) {
         if (!query.via?.trim()) {
             throw new Error('ContextReadClient.read: via is required');

package/dist/shared/apiError.d.ts

@@ -31,9 +31,11 @@ export declare function parseErrorCode(responseBody: string): string | null;
 export declare function parseRetryAfterMs(headers: {
     get(name: string): string | null;
 }): number | null;
+export declare function isCoverageRefusal(code: string | null | undefined): boolean;
 /**
  * Throw the parsed failure as an {@link ApiError} (or {@link RateLimitedError}
- * for 429), preserving status, body, machine code, and Retry-After.
+ * for a 429 that is not a coverage refusal), preserving status, body, machine
+ * code, and Retry-After.
  */
 export declare function throwApiError(response: {
     status: number;

package/dist/shared/apiError.js

@@ -100,14 +100,34 @@ function clampRetryMs(ms) {
         return 1_000;
     return Math.min(MAX_RETRY_AFTER_MS, Math.max(1_000, Math.round(ms)));
 }
+/**
+ * Coverage refusals name themselves. A 429 with one of these codes is not a
+ * wait-and-retry: the writer has to hire, or someone has to set the agreement
+ * up. The backend answers them as 403; this keeps a stale 429 from becoming a
+ * rate limit too.
+ */
+const COVERAGE_REFUSALS = new Set([
+    'CONVERSATION_ALLOWANCE_EXHAUSTED',
+    'CONTACT_POLICY_REFUSED',
+    'LISTING_PAUSED',
+    'CONVERSATION_COVERAGE_REQUIRED',
+    'CONVERSATION_COVERAGE_ENDED',
+    'CONVERSATION_NOT_FUNDED',
+    'CONVERSATION_SPONSORSHIP_REQUIRED',
+    'TASK_ONLY_AGENT',
+]);
+export function isCoverageRefusal(code) {
+    return !!code && COVERAGE_REFUSALS.has(code);
+}
 /**
  * Throw the parsed failure as an {@link ApiError} (or {@link RateLimitedError}
- * for 429), preserving status, body, machine code, and Retry-After.
+ * for a 429 that is not a coverage refusal), preserving status, body, machine
+ * code, and Retry-After.
  */
 export function throwApiError(response, responseBody, defaultMessage) {
     const message = parseErrorMessage(responseBody, defaultMessage);
     const code = parseErrorCode(responseBody);
-    if (response.status === 429) {
+    if (response.status === 429 && !isCoverageRefusal(code)) {
         throw new RateLimitedError(message, response.headers ? parseRetryAfterMs(response.headers) : null, responseBody, code);
     }
     throw new ApiError(message, response.status, responseBody, code);

package/dist/shared/rateLimit.js

@@ -1,5 +1,5 @@
 import { ApiError, RateLimitedError } from '../types.js';
-import { parseErrorCode, parseErrorMessage, parseRetryAfterMs, } from './apiError.js';
+import { isCoverageRefusal, parseErrorCode, parseErrorMessage, parseRetryAfterMs, } from './apiError.js';
 /**
  * a 429 is not a generic failure, it is an instruction with a
  * deadline attached.
@@ -33,7 +33,7 @@ export function isRateLimited(err) {
 export function pollSurfaceError(label, res, body) {
     const message = parseErrorMessage(body, `${label} failed: ${res.status}`);
     const code = parseErrorCode(body);
-    if (res.status === 429) {
+    if (res.status === 429 && !isCoverageRefusal(code)) {
         return new RateLimitedError(message, parseRetryAfterMs(res.headers), body, code);
     }
     return new ApiError(message, res.status, body, code);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.33.1",
+  "version": "0.34.1",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",