@ziggs-ai/api-client 0.7.1 → 0.9.0

package/dist/types.d.ts

@@ -6,6 +6,21 @@ export declare class ApiError extends Error {
 export interface Creds {
     operatorKey: string;
     agentId: string;
+    /**
+     * ZIG-1092 — 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.
+     *
+     * The operator key says WHO is calling; this says ON WHOSE BEHALF, RIGHT NOW.
+     * Without it an agent serving several customers carries its full authority
+     * into every call, and one tool call reaches another customer's work.
+     *
+     * Optional, and omitting it can only narrow what comes back (the backend
+     * falls back to the agent's own org) — never widen it. Nothing here is
+     * trusted: the server re-derives the party orgs itself and refuses a lane the
+     * agent is not in.
+     */
+    laneId?: string;
 }
 export type TaskState = 'active' | 'proposal' | 'completed' | 'failed' | 'cancelled' | 'ledger_open';
 export type PlanStepStatus = 'pending' | 'in_progress' | 'completed' | 'skipped';
@@ -159,6 +174,36 @@ export type BroadcastAudience = typeof OPEN_AGREEMENT_TARGET | typeof ORG_AGREEM
 export declare const BROADCAST_TARGETS: readonly ["everyone", "org"];
 /** True when `id` is a broadcast sentinel ('everyone' | 'org') rather than a concrete principal id. */
 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).
+ */
+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_*`). */
+export declare function isOpaquePresentationRef(id: string | null | undefined): boolean;
+/** Display + entitlement face for a principal on the message/roster wire. */
+export interface PrincipalPresentation {
+    /** Public, non-addressable reference (`psn_*` or `rpb_*`). */
+    ref?: string;
+    persona: {
+        id: string;
+        name: string;
+        image?: string | null;
+        revision?: number;
+    };
+    mode: 'persona' | 'chain';
+    /** Present only when the viewer is entitled to resolve the subject. */
+    subject?: {
+        id: string;
+        type: 'user' | 'agent';
+    };
+}
 export interface MessageMetadata {
     chatId: string;
     /** Stable id for dedup across push + inbox catch-up (ZIG-454). */
@@ -167,13 +212,23 @@ export interface MessageMetadata {
     sender: {
         id: string;
         type?: string;
+        presentation?: PrincipalPresentation | null;
+        /** Absent when the viewer is masked (persona layer). */
+        underAgreementId?: string | null;
+        presentedAs?: string | null;
     };
     senderId: string;
     senderType?: string;
     receiver?: {
         id: string;
+        presentation?: PrincipalPresentation | null;
     } | null;
     receiverId?: string | null;
+    /**
+     * Message-level presentation stamp when the backend attaches one
+     * (same shape as sender.presentation). Prefer sender.presentation.
+     */
+    presentation?: PrincipalPresentation | null;
     entryType?: string;
     content_type?: string;
     taskId?: string | null;

package/dist/types.js

@@ -58,3 +58,22 @@ export const BROADCAST_TARGETS = [OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET];
 export function isBroadcastTarget(id) {
     return id === OPEN_AGREEMENT_TARGET || id === ORG_AGREEMENT_TARGET;
 }
+/**
+ * Persona face id (`psn_*`). Non-addressable — never use for agent lookup,
+ * wake, or payment parties (ZIG-1137).
+ */
+export function isPersonaRef(id) {
+    return typeof id === 'string' && id.startsWith('psn_');
+}
+/**
+ * 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_');
+}
+/** Either opaque presentation ref (`psn_*` | `rpb_*`). */
+export function isOpaquePresentationRef(id) {
+    return isPersonaRef(id) || isRoomPresentationRef(id);
+}

package/package.json

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