@ziggs-ai/api-client 0.9.9 → 0.9.11

package/dist/http/index.js

@@ -5,7 +5,7 @@ export * from './agreementFlows.js';
 export * from './ChatClient.js';
 export { MessagesClient } from './MessagesClient.js';
 export { ArtifactsClient, 
-// ZIG-1032: agreement lanes are not chats — callers scope artifact writes with this.
+// agreement lanes are not chats — callers scope artifact writes with this.
 artifactScopeForSession, AGREEMENT_LANE_PREFIX, } from './ArtifactsClient.js';
 export { ContextReadClient, CONTEXT_READ_TYPES, CONTEXT_READ_VIA, VIA_KINDS, parseVia, viaHint, } from './ContextReadClient.js';
 export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';

package/dist/http/operatorHeaders.d.ts

@@ -1,11 +1,11 @@
 /**
  * Auth headers for operator-key HTTP clients. `X-Agent-Id` is only sent when
  * an agentId is present — agent-scoped keys identify the agent themselves;
- * fleet keys must pass one (ZIG-642).
+ * fleet keys must pass one.
  */
 export declare function buildOperatorHeaders(operatorKey: string, agentId?: string, extra?: Record<string, string>, 
 /**
- * ZIG-1092 — the lane this call belongs to, sent as `X-Ziggs-Lane`. The
+ * the lane this call belongs to, sent as `X-Ziggs-Lane`. The
  * backend narrows the wake's reach to the engagement's orgs; omitting it
  * narrows to the agent's own org, so it can never widen reach.
  */

package/dist/http/operatorHeaders.js

@@ -1,11 +1,11 @@
 /**
  * Auth headers for operator-key HTTP clients. `X-Agent-Id` is only sent when
  * an agentId is present — agent-scoped keys identify the agent themselves;
- * fleet keys must pass one (ZIG-642).
+ * fleet keys must pass one.
  */
 export function buildOperatorHeaders(operatorKey, agentId, extra, 
 /**
- * ZIG-1092 — the lane this call belongs to, sent as `X-Ziggs-Lane`. The
+ * the lane this call belongs to, sent as `X-Ziggs-Lane`. The
  * backend narrows the wake's reach to the engagement's orgs; omitting it
  * narrows to the agent's own org, so it can never widen reach.
  */

package/dist/index.js

@@ -4,10 +4,10 @@ export * from './relay/provisionRelayWorkers.js';
 export { ConnectionManager } from './ConnectionManager.js';
 export { EntryTypes, ContentTypes, OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, BROADCAST_TARGETS, isBroadcastTarget, isPersonaRef, isRoomPresentationRef, isOpaquePresentationRef, AGREEMENT_ENGAGEMENT_KIND, isValidContentType, } from './types.js';
 export { getBackendUrl } from './utils/urlUtils.js';
-// ZIG-652: the host injects the environment; this package never reads it.
+// the host injects the environment; this package never reads it.
 export { configureApiClient, apiClientConfig } from './config.js';
 export { runtimeLog, resetRuntimeLogLevelCache } from './shared/runtimeLog.js';
-// ZIG-1019 / ZIG-1124: one ApiError shape; 429s carry the server's wait.
+// one ApiError shape; 429s carry the server's wait.
 export { RateLimitedError, isRateLimited, parseRetryAfterMs, pollSurfaceError, } from './shared/rateLimit.js';
 // One reader for the one error shape the API answers in — exported so nothing has
 // to re-implement the field precedence (it was copy-pasted into six clients, and

package/dist/shared/apiError.d.ts

@@ -26,7 +26,7 @@ export declare function parseErrorCode(responseBody: string): string | null;
  * not reproduce the hot-retry it is meant to stop.
  *
  * Lives next to {@link throwApiError} so every client path (not only the poll
- * surface) can honour the server's number (ZIG-1124).
+ * surface) can honour the server's number.
  */
 export declare function parseRetryAfterMs(headers: {
     get(name: string): string | null;

package/dist/shared/apiError.js

@@ -75,7 +75,7 @@ const MAX_RETRY_AFTER_MS = 120_000;
  * not reproduce the hot-retry it is meant to stop.
  *
  * Lives next to {@link throwApiError} so every client path (not only the poll
- * surface) can honour the server's number (ZIG-1124).
+ * surface) can honour the server's number.
  */
 export function parseRetryAfterMs(headers) {
     const explicit = headers.get('retry-after');

package/dist/shared/rateLimit.d.ts

@@ -1,7 +1,7 @@
 import { ApiError, RateLimitedError } from '../types.js';
 import { parseRetryAfterMs } from './apiError.js';
 /**
- * ZIG-1019 — a 429 is not a generic failure, it is an instruction with a
+ * a 429 is not a generic failure, it is an instruction with a
  * deadline attached.
  *
  * The poll surface (`/inbox`, `/context/read`) is capped per actor, and every
@@ -14,7 +14,7 @@ import { parseRetryAfterMs } from './apiError.js';
  * `RateLimit-Reset` from the standard headers. These helpers carry that number
  * to whoever is doing the backing off.
  *
- * ZIG-1124 — {@link RateLimitedError} extends {@link ApiError}; non-429 poll
+ * {@link RateLimitedError} extends {@link ApiError}; non-429 poll
  * failures are ApiError too (same shape as {@link throwApiError}).
  */
 export { RateLimitedError, parseRetryAfterMs };

package/dist/shared/rateLimit.js

@@ -1,7 +1,7 @@
 import { ApiError, RateLimitedError } from '../types.js';
 import { parseErrorCode, parseErrorMessage, parseRetryAfterMs, } from './apiError.js';
 /**
- * ZIG-1019 — a 429 is not a generic failure, it is an instruction with a
+ * a 429 is not a generic failure, it is an instruction with a
  * deadline attached.
  *
  * The poll surface (`/inbox`, `/context/read`) is capped per actor, and every
@@ -14,7 +14,7 @@ import { parseErrorCode, parseErrorMessage, parseRetryAfterMs, } from './apiErro
  * `RateLimit-Reset` from the standard headers. These helpers carry that number
  * to whoever is doing the backing off.
  *
- * ZIG-1124 — {@link RateLimitedError} extends {@link ApiError}; non-429 poll
+ * {@link RateLimitedError} extends {@link ApiError}; non-429 poll
  * failures are ApiError too (same shape as {@link throwApiError}).
  */
 export { RateLimitedError, parseRetryAfterMs };

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * One failure shape for every HTTP client path (ZIG-1124).
+ * One failure shape for every HTTP client path.
  *
  * `status` and optional machine `code` come from the response; `body` is the
  * raw text so callers can re-parse without scraping concatenated messages.
@@ -21,7 +21,7 @@ export interface Creds {
     operatorKey: string;
     agentId: string;
     /**
-     * ZIG-1092 — the lane (chat id, or `agrn-<agreementId>`) this call is being
+     * the lane (chat id, or `agrn-<agreementId>`) this call is being
      * made from. Sent as `X-Ziggs-Lane` so the backend can fence the wake to the
      * engagement the agent is actually acting inside.
      *
@@ -49,10 +49,10 @@ export interface Task {
     agentId?: string;
     executorId?: string;
     payerId?: string;
-    /** Explicit delegation target (ZIG-586) — id of the agent/user this task is assigned to, or null when unassigned. */
+    /** Explicit delegation target — id of the agent/user this task is assigned to, or null when unassigned. */
     assigneeId?: string | null;
     agreementId?: string;
-    /** Compact reference to the governing agreement (ZIG-665). Read endpoints
+    /** Compact reference to the governing agreement. Read endpoints
      * never inline the full agreement — fetch it via getAgreement when the
      * paper-work (money, approvals) matters. */
     agreement?: AgreementSummary | null;
@@ -79,11 +79,11 @@ export type ProposalStatus = 'pending' | 'approved' | 'rejected' | 'countered' |
 export declare const AGREEMENT_ENGAGEMENT_KIND: {
     readonly HIRE: "hire";
     readonly SERVICE: "service";
-    /** ZIG-481: a bilateral reach link between two agents (no money, no work). */
+    /** a bilateral reach link between two agents (no money, no work). */
     readonly LINK: "link";
 };
 export type EngagementKind = (typeof AGREEMENT_ENGAGEMENT_KIND)[keyof typeof AGREEMENT_ENGAGEMENT_KIND];
-/** Compact agreement reference carried by task reads (ZIG-665). */
+/** Compact agreement reference carried by task reads. */
 export interface AgreementSummary {
     agreementId: string;
     description: string;
@@ -143,7 +143,7 @@ export interface Agreement {
     /** Set on a link that was formed by claiming the invite with this id. */
     linkInviteTemplateId?: string | null;
     /**
-     * ZIG-997/ZIG-1059 — the provider slot is FIXED (a hand-off): claiming or
+     * the provider slot is FIXED (a hand-off): claiming or
      * approving this makes you the party the work is done FOR, not the worker —
      * and, when priced, the payer.
      */
@@ -190,13 +190,13 @@ export declare const BROADCAST_TARGETS: readonly ["everyone", "org"];
 export declare function isBroadcastTarget(id: string | null | undefined): boolean;
 /**
  * Persona face id (`psn_*`). Non-addressable — never use for agent lookup,
- * wake, or payment parties (ZIG-1137).
+ * wake, or payment parties.
  */
 export declare function isPersonaRef(id: string | null | undefined): boolean;
 /**
  * Room presentation binding id (`rpb_*`). Opaque to account lookup / wake /
  * pay. Chat sends may echo it as `receiverId` — the backend resolves it in-room
- * (ZIG-1137).
+ *.
  */
 export declare function isRoomPresentationRef(id: string | null | undefined): boolean;
 /** Either opaque presentation ref (`psn_*` | `rpb_*`). */
@@ -220,7 +220,7 @@ export interface PrincipalPresentation {
 }
 export interface MessageMetadata {
     chatId: string;
-    /** Stable id for dedup across push + inbox catch-up (ZIG-454). */
+    /** Stable id for dedup across push + inbox catch-up. */
     messageId?: string;
     userId: string;
     sender: {
@@ -260,8 +260,8 @@ export interface MessageMetadata {
     operation?: string | null;
     agreementId?: string | null;
     /**
-     * Message send time from the wire payload (ZIG-860). The live-path inbox
-     * watermark ack (AgentHost, ZIG-832 P4) needs it — without a timestamp the
+     * Message send time from the wire payload. The live-path inbox
+     * watermark ack (AgentHost, P4) needs it — without a timestamp the
      * ack never fires and catch-up re-delivers the chat's whole backlog after a
      * host eviction, re-running already-answered goals.
      */
@@ -294,13 +294,13 @@ export interface InboxDeliveryRef {
     actorId: string | null;
     ts: string;
     /**
-     * ZIG-703 — lifecycle hint when the server includes one (e.g.
+     * lifecycle hint when the server includes one (e.g.
      * `connection_request_fulfilled`). Absent on ordinary doorbells / older servers.
      */
     reason?: string | null;
-    /** ZIG-703 — MCP connection after a fulfilled first-hop request. */
+    /** MCP connection after a fulfilled first-hop request. */
     connectionId?: string | null;
-    /** ZIG-703 — grant minted for this agent on fulfill. */
+    /** grant minted for this agent on fulfill. */
     grantId?: string | null;
 }
 /** Message/artifact deliveries folded by chat, so you can open chats directly. */
@@ -314,11 +314,11 @@ export interface InboxProposalRef {
     title: string;
     proposedAt: string | null;
     /**
-     * ZIG-1087 — party ids still owing a decision, and the named responder slot.
+     * party ids still owing a decision, and the named responder slot.
      * The inbox lists proposals awaiting the agent OR its human, and only the
      * agent's own slot is one it can submit; these say which is which.
      *
-     * Optional because a backend deployed before ZIG-1087 omits them, and this
+     * Optional because a backend deployed before omits them, and this
      * client is installed independently of the server it talks to. Absent reads
      * as "no slot of mine", which routes the decision to the human — the safe
      * direction: it withholds a call, it never invents authority.
@@ -330,20 +330,20 @@ export interface InboxConnectionRequestRef {
     requestId: string;
     /**
      * Non-addressable persona reference for the requester (`psn_*`).
-     * Never use as an account id for lookup / wake / pay (ZIG-1137).
+     * Never use as an account id for lookup / wake / pay.
      */
     requesterRef: string;
-    /** ZIG-1039 — human-readable name for consent cards. */
+    /** human-readable name for consent cards. */
     requesterDisplayName?: string | null;
-    /** ZIG-1039 — org label for consent cards. */
+    /** org label for consent cards. */
     requesterOrgName?: string | null;
     message: string | null;
     requestedAt: string | null;
-    /** ZIG-1087 — see InboxProposalRef; a link request uses the same gate. */
+    /** see InboxProposalRef; a link request uses the same gate. */
     pendingApprovalPartyIds?: string[];
     proposedTo?: string | null;
 }
-/** Pull-only MCP: prompt the human when proposals need a decision (ZIG-482 / ZIG-481). */
+/** Pull-only MCP: prompt the human when proposals need a decision. */
 export interface InboxHumanAttention {
     required: true;
     reason: 'proposals_awaiting_me' | 'connection_requests_awaiting_me' | 'multiple';
@@ -354,7 +354,7 @@ export interface InboxHumanAttention {
     promptUser: string;
 }
 /**
- * An open task assigned to this agent (ZIG-973). References only — read the
+ * An open task assigned to this agent. References only — read the
  * task for its description/plan/inputs.
  *
  * Tasks ride their own channel because assignment IS their delivery: before
@@ -369,7 +369,7 @@ export interface InboxTaskRef {
     updatedAt: string | null;
 }
 /**
- * A marketplace quest doorbell (ZIG-1185). Own channel so the host can
+ * A marketplace quest doorbell. Own channel so the host can
  * exact-match triage with zero LLM tokens before any wake.
  */
 export interface InboxQuestRef {
@@ -391,14 +391,16 @@ export interface InboxEnvelope {
     /** The chat-bearing deliveries above, folded by chat. */
     chats: InboxChatNews[];
     /**
-     * Pass to `ack()` after acting. Null when there is nothing to ack. Ack after
-     * acting, not after reading: a crash in between redelivers.
+     * Pass to `ack(upTo, { handledResourceIds })` after acting (ZIG-1305).
+     * Null when there is nothing to ack. Ack after acting, not after reading:
+     * a crash in between redelivers. Listing every handled resourceId is what
+     * stops a partial triage from burying other chats.
      */
     ackTo: string | null;
-    /** Open tasks assigned to this agent — the work channel (ZIG-973). */
+    /** Open tasks assigned to this agent — the work channel. */
     tasksAwaitingMe: InboxTaskRef[];
     truncatedTasks: number;
-    /** Unacked quest deliveries (ZIG-1185) — triaged before any LLM wake. */
+    /** Unacked quest deliveries — triaged before any LLM wake. */
     questsAwaitingMe?: InboxQuestRef[];
     truncatedQuests?: number;
     proposalsAwaitingMe: InboxProposalRef[];

package/dist/types.js

@@ -1,5 +1,5 @@
 /**
- * One failure shape for every HTTP client path (ZIG-1124).
+ * One failure shape for every HTTP client path.
  *
  * `status` and optional machine `code` come from the response; `body` is the
  * raw text so callers can re-parse without scraping concatenated messages.
@@ -31,7 +31,7 @@ export class RateLimitedError extends ApiError {
 export const AGREEMENT_ENGAGEMENT_KIND = {
     HIRE: 'hire',
     SERVICE: 'service',
-    /** ZIG-481: a bilateral reach link between two agents (no money, no work). */
+    /** a bilateral reach link between two agents (no money, no work). */
     LINK: 'link',
 };
 /** ⚠️ SYNC: Keep in sync with backend src/chat/chat.types.ts ENTRY_TYPE */
@@ -79,7 +79,7 @@ export function isBroadcastTarget(id) {
 }
 /**
  * Persona face id (`psn_*`). Non-addressable — never use for agent lookup,
- * wake, or payment parties (ZIG-1137).
+ * wake, or payment parties.
  */
 export function isPersonaRef(id) {
     return typeof id === 'string' && id.startsWith('psn_');
@@ -87,7 +87,7 @@ export function isPersonaRef(id) {
 /**
  * Room presentation binding id (`rpb_*`). Opaque to account lookup / wake /
  * pay. Chat sends may echo it as `receiverId` — the backend resolves it in-room
- * (ZIG-1137).
+ *.
  */
 export function isRoomPresentationRef(id) {
     return typeof id === 'string' && id.startsWith('rpb_');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepack": "npm run build",
+    "prepack": "rm -rf dist && npm run build",
     "test": "node --import tsx/esm --test --test-reporter=spec test/*.test.ts",
     "test:watch": "node --import tsx/esm --test --watch test/*.test.ts"
   },