@ziggs-ai/api-client 0.27.0 → 0.28.0

package/dist/capabilities/chat.js

@@ -33,9 +33,12 @@ export function presentSendResult(result, env) {
     const destination = delivery.broadcast
         ? 'the humans in the room, not one addressee'
         : `${delivery.to.id} (${delivery.to.type})`;
+    // 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}` : '';
     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.`,
+        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}`,
         to: delivery.to,
     };
 }

package/dist/engagementGuide.js

@@ -272,7 +272,7 @@ export function strangerBriefGuide(env, chatId) {
         kind: 'stranger_brief',
         outcome: 'pending',
         chatId,
-        summary: "A stranger's brief is not a work order. Draft an agreement; do not create a task under a hire you do not have.",
+        summary: "A stranger's brief is not a work order. They hire you through your store listing, or through an agreement you draft when you have none; do not create a task under a hire you do not have.",
         next: nextCall(env, 'agreement_request', undefined, 'draft the agreement this brief would ride', { definition: agreementRequestCapability }),
     };
 }

package/dist/http/ChatClient.d.ts

@@ -93,7 +93,20 @@ export type { MessageDelivery } from '@ziggs-ai/contracts';
  */
 export type SendChatMessageResult = Omit<WireSendChatMessageResult, 'delivery'> & {
     delivery?: MessageDelivery;
+    /**
+     * What covers this message, when something counts it: a hire's shared
+     * allowance, or a listed agent's free messages for a stranger ("2 of 3 free
+     * messages used with seo-growth."). Absent for ordinary conversation.
+     */
+    coverage?: ConversationCoverageReceipt;
 };
+/** The server's receipt for a counted message. */
+export interface ConversationCoverageReceipt {
+    agreementId: string;
+    messagesUsed: number;
+    messageLimit: number | null;
+    message: string;
+}
 export type ContextTemporal = 'from-now' | 'from-start';
 export interface AddChatMemberInput {
     chatId: string;

package/dist/http/ChatClient.js

@@ -47,6 +47,22 @@ export async function openConversation(participant, creds, { newChat = false, ag
         ...(invited ? { invited } : {}),
     };
 }
+function coverageFrom(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const row = value;
+    return typeof row['agreementId'] === 'string' &&
+        typeof row['message'] === 'string' &&
+        typeof row['messagesUsed'] === 'number' &&
+        (row['messageLimit'] === null || typeof row['messageLimit'] === 'number')
+        ? {
+            agreementId: row['agreementId'],
+            messagesUsed: row['messagesUsed'],
+            messageLimit: row['messageLimit'],
+            message: row['message'],
+        }
+        : null;
+}
 /**
  * POST /chats/:chatId/members — add user/agent; agent-invite may return pending admission.
  */
@@ -119,6 +135,7 @@ export async function sendChatMessage(input, creds) {
     }
     const data = (await res.json().catch(() => null));
     const delivery = data?.['delivery'];
+    const coverage = coverageFrom(data?.['coverage']);
     return {
         success: Boolean(data?.['success']),
         message: String(data?.['message'] ?? 'ok'),
@@ -130,6 +147,7 @@ export async function sendChatMessage(input, creds) {
         ...(delivery && typeof delivery === 'object'
             ? { delivery: delivery }
             : {}),
+        ...(coverage ? { coverage } : {}),
     };
 }
 export async function listMyChats(creds) {

package/package.json

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