@ziggs-ai/api-client 0.19.0 → 0.20.0

package/dist/sessionOrientation.js

@@ -0,0 +1,43 @@
+/**
+ * Who this session is, who it represents, and whether it can continue
+ * unattended. Built from the binding the caller already has. Does not
+ * read mail and does not take the inbox lease.
+ */
+const PEEK = {
+    tool: 'ziggs_inbox_peek',
+    http: { method: 'GET', path: '/inbox/peek' },
+};
+/**
+ * Facts a cold entry needs that `session.ownerId` never labelled: the
+ * represented person, whether this host can arm a wake, and who drives ack.
+ */
+export function sessionOrientation(input) {
+    const mcp = input.surface === 'mcp';
+    return {
+        representedPerson: {
+            id: input.ownerUserId,
+            kind: 'user',
+        },
+        continuation: mcp
+            ? {
+                kind: 'manual',
+                canScheduleWake: false,
+                summary: 'This MCP session has no wake_at. Continue by calling ziggs_inbox again — a scheduler in the host is the only unattended path.',
+            }
+            : {
+                kind: 'scheduled',
+                canScheduleWake: true,
+                summary: 'The hosted runtime can arm wake_at. The brain does not ack; the host owns the inbox loop.',
+            },
+        inboxHandling: {
+            ackDriver: mcp ? 'agent' : 'host',
+            readAcquiresHost: true,
+            peekDoesNotAcquire: true,
+            peek: PEEK,
+        },
+        identity: {
+            agentId: input.agentId,
+            distinctFromBackgroundWorker: true,
+        },
+    };
+}

package/package.json

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