@ziggs-ai/api-client 0.42.2 → 0.42.4

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.42.4
+
+- `SessionsClient.hold(messageId, sessionId?)` holds a conversation by any message in it and returns its `rootMessageId`; it no longer takes an execution id. `AssistantSessionRow.heldThreadIds` replaces `heldExecutionIds`.
+
+## 0.42.3
+
 ## 0.42.2
 
 - `bucket_send` sends a page: `page` (a full HTML document) and `pageName` save the HTML as a file, and carry that exact version as the message's `page` (with its sha256); whoever reads the message opens the page, so nothing is shared. Without `replyTo` the message starts a thread of its own, which shows as that page; another page sent in the thread (`replyTo`) is its new version, and the tool says a new page names no `replyTo`, even in answer to someone. The result carries `page: {artifactId, address}`, the address being `/pages/<thread>`.

package/dist/capabilities/mcpBriefs.js

@@ -53,12 +53,12 @@ const BRIEFS = {
         changes: 'nothing is approved or rejected. The decision stays pending.',
     },
     ziggs_session_list: {
-        does: 'Lists your open windows: name, app, awake or not, and the executions each holds. Sibling windows of the same assistant key.',
+        does: 'Lists your open windows: name, app, awake or not, and the conversations each holds. Sibling windows of the same assistant key.',
         returns: 'sessions[] for this assistant',
-        next: 'ziggs_session_hold to route an execution to this window',
+        next: 'ziggs_session_hold to route a conversation to this window',
     },
     ziggs_session_hold: {
-        does: 'Routes an authorized execution to this window (the X-Ziggs-Session host). Removes its routing hint from siblings.',
+        does: 'Keeps a conversation in this window: later messages of its thread come here, with what nobody handled yet. Takes it off any sibling. Writing in a thread already holds it.',
         changes: 'changes session routing, not authority or responsibility',
     },
     ziggs_context_snapshot: {
@@ -67,7 +67,7 @@ const BRIEFS = {
     },
     // Agreements
     ziggs_agreement_list: {
-        does: 'Lists the agreements you can reach, including hires. scope mine keeps only agreements you are a party to.',
+        does: 'Lists the agreements you can reach, including hires, as short rows (ziggs_agreement_get has the full one). scope mine keeps only agreements you are a party to.',
     },
     ziggs_agreement_get: {
         does: 'Reads one agreement: parties, terms, status, and approvalAction (who may decide a pending slot).',

package/dist/capabilities/payments.d.ts

@@ -20,8 +20,7 @@ import { type CapabilityDefinition } from './types.js';
  * getting paid under an agreement.
  *
  * Balance stays readable, because "see your points" is the intended
- * experience. Note that `ZIGGS_MCP_CORE_ONLY` gates this whole group off
- * including balance, so it is not the lever for this on its own.
+ * experience.
  */
 export declare const paymentBalanceCapability: CapabilityDefinition;
 export declare const PAYMENT_CAPABILITIES: CapabilityDefinition[];

package/dist/capabilities/payments.js

@@ -27,8 +27,7 @@ function client(env) {
  * getting paid under an agreement.
  *
  * Balance stays readable, because "see your points" is the intended
- * experience. Note that `ZIGGS_MCP_CORE_ONLY` gates this whole group off
- * including balance, so it is not the lever for this on its own.
+ * experience.
  */
 export const paymentBalanceCapability = {
     key: 'payment_balance',

package/dist/http/SessionsClient.d.ts

@@ -8,11 +8,12 @@ export interface AssistantSessionRow {
     lastSeenAt: string;
     expiresAt: string;
     workspaceIds: string[];
-    heldExecutionIds: string[];
+    /** Conversations this window holds, each by the first message of its thread. */
+    heldThreadIds: string[];
     awake: boolean;
 }
 /**
- * List sibling windows and hold an execution in this one.
+ * List sibling windows and hold a conversation in this one.
  * Uses the same session headers as the inbox so "this window" is the
  * X-Ziggs-Session the host already sends.
  */
@@ -23,12 +24,14 @@ export declare class SessionsClient {
     private url;
     list(): Promise<AssistantSessionRow[]>;
     /**
-     * Hold `executionContextId` in this window (omit sessionId; server resolves from
-     * X-Ziggs-Session), move it to `sessionId`, or pass null to release.
+     * Hold a conversation in this window (omit sessionId; the server resolves
+     * the window from X-Ziggs-Session), move it to `sessionId`, or pass null to
+     * release it. `messageId` is any message of the conversation: the hold is on
+     * its thread, and mail of that thread nobody handled yet moves with it.
      */
-    hold(executionContextId: string, sessionId?: string | null): Promise<{
+    hold(messageId: string, sessionId?: string | null): Promise<{
         success: true;
-        executionContextId: string;
+        rootMessageId: string;
         sessionId: string | null;
     }>;
 }

package/dist/http/SessionsClient.js

@@ -2,7 +2,7 @@ import { getBackendUrl } from '../utils/urlUtils.js';
 import { pollSurfaceError } from '../shared/rateLimit.js';
 import { buildCredsHeaders } from './operatorHeaders.js';
 /**
- * List sibling windows and hold an execution in this one.
+ * List sibling windows and hold a conversation in this one.
  * Uses the same session headers as the inbox so "this window" is the
  * X-Ziggs-Session the host already sends.
  */
@@ -48,14 +48,16 @@ export class SessionsClient {
         return Array.isArray(rows) ? rows : [];
     }
     /**
-     * Hold `executionContextId` in this window (omit sessionId; server resolves from
-     * X-Ziggs-Session), move it to `sessionId`, or pass null to release.
+     * Hold a conversation in this window (omit sessionId; the server resolves
+     * the window from X-Ziggs-Session), move it to `sessionId`, or pass null to
+     * release it. `messageId` is any message of the conversation: the hold is on
+     * its thread, and mail of that thread nobody handled yet moves with it.
      */
-    async hold(executionContextId, sessionId) {
-        if (!executionContextId?.trim())
-            throw new Error('SessionsClient.hold: executionContextId is required');
+    async hold(messageId, sessionId) {
+        if (!messageId?.trim())
+            throw new Error('SessionsClient.hold: messageId is required');
         const body = {
-            executionContextId: executionContextId.trim(),
+            messageId: messageId.trim(),
         };
         if (sessionId !== undefined)
             body.sessionId = sessionId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.42.2",
+  "version": "0.42.4",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {
@@ -31,7 +31,7 @@
     "test:watch": "node --import tsx/esm --test --watch test/*.test.ts"
   },
   "dependencies": {
-    "@ziggs-ai/contracts": "0.49.0",
+    "@ziggs-ai/contracts": "0.49.1",
     "socket.io-client": "^4.7.0"
   },
   "keywords": [