@datalayer/agent-runtimes 1.5.83 → 1.5.84

package/lib/portable/hosts/contracts.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 /**
- * The generic Datalayer host contracts, as ai-agents answers them, for every chat host (Slack, Discord).
+ * The generic Datalayer host contracts, as ai-agents answers them, for every chat host (Slack, Discord, WhatsApp).
  * These shapes are shared with ai-agents through `contracts.json`, beside
  * this file and byte-identical to ai-agents' `tests/fixtures/hosts/`, which
  * both sides test. A delivery's `target` stays opaque here: each host

package/lib/portable/hosts/contracts.js

@@ -5,7 +5,7 @@
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import { z } from 'zod';
 /**
- * The generic Datalayer host contracts, as ai-agents answers them, for every chat host (Slack, Discord).
+ * The generic Datalayer host contracts, as ai-agents answers them, for every chat host (Slack, Discord, WhatsApp).
  * These shapes are shared with ai-agents through `contracts.json`, beside
  * this file and byte-identical to ai-agents' `tests/fixtures/hosts/`, which
  * both sides test. A delivery's `target` stays opaque here: each host

package/lib/portable/hosts/contracts.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "about": "The generic host contracts of the chat hosts, as ai-agents and the runtime's session API answer them. Shared verbatim by ai-agents (tests/fixtures/hosts) and agent-runtimes (src/portable/hosts, read by the Slack and Discord adapters from lib/portable/hosts): each side's tests check its half against this file.",
+  "about": "The generic host contracts of the chat hosts, as ai-agents and the runtime's session API answer them. Shared verbatim by ai-agents (tests/fixtures/hosts) and agent-runtimes (src/portable/hosts, read by the Slack, Discord and WhatsApp adapters from lib/portable/hosts): each side's tests check its half against this file.",
   "headers": {
     "host_key": "X-Datalayer-Host-Key",
     "signature": "X-Datalayer-Signature",
@@ -493,5 +493,63 @@
       "threadId": "456789012345678901",
       "userId": "567890123456789012"
     }
+  },
+  "whatsapp": {
+    "about": "WhatsApp's forms of the generic contracts: the installation is <waba_id>:<phone_number_id>, one per connected business number; a person is their business-scoped user id (BSUID: a country code, a period and up to 128 characters; never the phone number), which the external id pattern admits as it is, no hash in between; a 1:1 chat is a direct place named by the BSUID, a group a channel named by its group id; the session uid is hostSessionUid(\"whatsapp\", [waba_id, phone_number_id, user_id]) for a chat and [waba_id, phone_number_id, group_id] for a group; a turn's provenance names the message by its wamid.",
+    "waba_id": "102290129340398",
+    "phone_number_id": "106540352242922",
+    "bind_request": {
+      "code": "dlhc_…",
+      "external_id": "102290129340398:106540352242922",
+      "name": "Acme"
+    },
+    "external_user_id": "US.13491208655302741918",
+    "external_user_name": "Alice",
+    "external_user_id_longest": "US.11111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
+    "direct": {
+      "place": {
+        "kind": "direct",
+        "id": "US.13491208655302741918"
+      }
+    },
+    "group": {
+      "id": "120363025246125486",
+      "place": {
+        "kind": "channel",
+        "id": "120363025246125486"
+      }
+    },
+    "session": {
+      "parts": [
+        "102290129340398",
+        "106540352242922",
+        "US.13491208655302741918"
+      ],
+      "uid": "whatsapp-870e7e8165519947ec9c7df03d378b342cee380e"
+    },
+    "group_session": {
+      "parts": [
+        "102290129340398",
+        "106540352242922",
+        "120363025246125486"
+      ],
+      "uid": "whatsapp-49aeadff03b2d02e6359121f9a55bae904640b35"
+    },
+    "provenance": {
+      "host_kind": "whatsapp",
+      "place": {
+        "kind": "direct",
+        "id": "US.13491208655302741918"
+      },
+      "message_id": "wamid.HBgLMTU1NTEyMzQ1NjcVAgASGBQzQUY3RjU0QjRFRjc2MzBCNkJCNAA="
+    },
+    "target": {
+      "phoneNumberId": "106540352242922",
+      "userId": "US.13491208655302741918"
+    },
+    "group_target": {
+      "phoneNumberId": "106540352242922",
+      "groupId": "120363025246125486"
+    }
   }
 }

package/lib/portable/hosts/forbiddenGraph.js

@@ -26,6 +26,7 @@ export const FORBIDDEN = [
     /^@datalayer\/reactor$/,
     /^@datalayer\/slack$/,
     /^@datalayer\/discord$/,
+    /^@datalayer\/whatsapp$/,
 ];
 export const isForbidden = (name) => FORBIDDEN.some(pattern => pattern.test(name));
 /** The package name an import specifier names: `@scope/name/deep` → `@scope/name`. */

package/lib/portable/hosts/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * What a chat host service (Slack, Discord) shares, on Node: the ai-agents
+ * What a chat host service (Slack, Discord, WhatsApp) shares, on Node: the ai-agents
  * host contracts and client, the agent client over the session API, the
  * semantic events a turn is reduced to, approval renderers, deliveries, the
  * turn's state, application resolution, the durable queue, quotas, secrets

package/lib/portable/hosts/index.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * What a chat host service (Slack, Discord) shares, on Node: the ai-agents
+ * What a chat host service (Slack, Discord, WhatsApp) shares, on Node: the ai-agents
  * host contracts and client, the agent client over the session API, the
  * semantic events a turn is reduced to, approval renderers, deliveries, the
  * turn's state, application resolution, the durable queue, quotas, secrets

package/lib/portable/hosts/sessionUid.d.ts

@@ -2,6 +2,8 @@
  * `<kind>-<40 hex>`: the SHA-256 of the thread's parts joined by `:`, and
  * `:<generation>` once the thread started over or switched application. The
  * same parts give the same uid (Slack: app, enterprise or `-`, team,
- * channel, thread ts; Discord: application, guild, channel, thread).
+ * channel, thread ts; Discord: application, guild, channel, thread;
+ * WhatsApp: WABA, phone number id, and the person's BSUID for a chat or the
+ * group's id for a group).
  */
 export declare function hostSessionUid(kind: string, parts: readonly string[], generation?: number): string;

package/lib/portable/hosts/sessionUid.js

@@ -13,7 +13,9 @@ import { createHash } from 'node:crypto';
  * `<kind>-<40 hex>`: the SHA-256 of the thread's parts joined by `:`, and
  * `:<generation>` once the thread started over or switched application. The
  * same parts give the same uid (Slack: app, enterprise or `-`, team,
- * channel, thread ts; Discord: application, guild, channel, thread).
+ * channel, thread ts; Discord: application, guild, channel, thread;
+ * WhatsApp: WABA, phone number id, and the person's BSUID for a chat or the
+ * group's id for a group).
  */
 export function hostSessionUid(kind, parts, generation) {
     if (!/^[a-z][a-z0-9-]{1,31}$/.test(kind)) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.83",
+    "version": "1.5.84",
     "type": "module",
     "workspaces": [
         ".",