@openclaw/crabline 0.1.3 → 0.1.5

package/dist/src/servers/whatsapp-wire/handshake.js

@@ -0,0 +1,154 @@
+import { Buffer } from "node:buffer";
+export function decodeHandshakeMessage(data) {
+    const reader = new ProtoReader(data);
+    const message = {};
+    while (!reader.done()) {
+        const tag = reader.uint32();
+        const field = tag >>> 3;
+        if (field === 2) {
+            message.clientHello = decodeClientHello(reader.bytes());
+        }
+        else if (field === 4) {
+            message.clientFinish = decodeClientFinish(reader.bytes());
+        }
+        else {
+            reader.skip(tag & 7);
+        }
+    }
+    return message;
+}
+export function encodeHandshakeMessage(message) {
+    const writer = new ProtoWriter();
+    if (message.serverHello) {
+        writer.bytesField(3, encodeServerHello(message.serverHello));
+    }
+    return writer.finish();
+}
+function decodeClientHello(data) {
+    const reader = new ProtoReader(data);
+    let ephemeral;
+    while (!reader.done()) {
+        const tag = reader.uint32();
+        if (tag >>> 3 === 1) {
+            ephemeral = reader.bytes();
+        }
+        else {
+            reader.skip(tag & 7);
+        }
+    }
+    return ephemeral === undefined ? {} : { ephemeral };
+}
+function decodeClientFinish(data) {
+    const reader = new ProtoReader(data);
+    let payload;
+    let staticKey;
+    while (!reader.done()) {
+        const tag = reader.uint32();
+        const field = tag >>> 3;
+        if (field === 1) {
+            staticKey = reader.bytes();
+        }
+        else if (field === 2) {
+            payload = reader.bytes();
+        }
+        else {
+            reader.skip(tag & 7);
+        }
+    }
+    return {
+        ...(payload === undefined ? {} : { payload }),
+        ...(staticKey === undefined ? {} : { staticKey }),
+    };
+}
+function encodeServerHello(serverHello) {
+    const writer = new ProtoWriter();
+    writer.bytesField(1, serverHello.ephemeral);
+    writer.bytesField(2, serverHello.staticKey);
+    writer.bytesField(3, serverHello.payload);
+    return writer.finish();
+}
+class ProtoReader {
+    #offset = 0;
+    #buffer;
+    constructor(data) {
+        this.#buffer = Buffer.from(data);
+    }
+    done() {
+        return this.#offset >= this.#buffer.length;
+    }
+    bytes() {
+        const length = this.uint32();
+        this.#require(length);
+        const value = this.#buffer.subarray(this.#offset, this.#offset + length);
+        this.#offset += length;
+        return value;
+    }
+    skip(wireType) {
+        if (wireType === 0) {
+            this.uint32();
+            return;
+        }
+        if (wireType === 1) {
+            this.#require(8);
+            this.#offset += 8;
+            return;
+        }
+        if (wireType === 2) {
+            const length = this.uint32();
+            this.#require(length);
+            this.#offset += length;
+            return;
+        }
+        if (wireType === 5) {
+            this.#require(4);
+            this.#offset += 4;
+            return;
+        }
+        throw new Error(`Unsupported WhatsApp handshake wire type: ${wireType}.`);
+    }
+    uint32() {
+        let value = 0;
+        let shift = 0;
+        while (shift < 32) {
+            this.#require(1);
+            const byte = this.#buffer[this.#offset];
+            this.#offset += 1;
+            if (byte === undefined) {
+                throw new Error("Unexpected end of WhatsApp handshake protobuf.");
+            }
+            value |= (byte & 0x7f) << shift;
+            if ((byte & 0x80) === 0) {
+                return value >>> 0;
+            }
+            shift += 7;
+        }
+        throw new Error("Invalid WhatsApp handshake varint.");
+    }
+    #require(length) {
+        if (this.#offset + length > this.#buffer.length) {
+            throw new Error("Unexpected end of WhatsApp handshake protobuf.");
+        }
+    }
+}
+class ProtoWriter {
+    #parts = [];
+    bytesField(field, value) {
+        this.uint32((field << 3) | 2);
+        this.uint32(value.byteLength);
+        this.#parts.push(Buffer.from(value));
+    }
+    finish() {
+        return Buffer.concat(this.#parts);
+    }
+    uint32(value) {
+        let remaining = value >>> 0;
+        const bytes = [];
+        while (remaining > 127) {
+            bytes.push((remaining & 0x7f) | 0x80);
+            remaining >>>= 7;
+        }
+        bytes.push(remaining);
+        this.#parts.push(Buffer.from(bytes));
+    }
+}
+//# sourceMappingURL=handshake.js.map

package/dist/src/servers/whatsapp-wire/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../../../src/servers/whatsapp-wire/handshake.ts"],"names":[],"mappings":"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"}

package/dist/src/servers/whatsapp-wire/signal.d.ts

@@ -0,0 +1,5 @@
+import type { BinaryNode } from "./binary-node.js";
+import { KEY_BUNDLE_TYPE, type KeyPair, type SignedKeyPair } from "./crypto.js";
+export declare function xmppPreKey(pair: KeyPair, id: number): BinaryNode;
+export declare function xmppSignedPreKey(key: SignedKeyPair): BinaryNode;
+export { KEY_BUNDLE_TYPE };

package/dist/src/servers/whatsapp-wire/signal.js

@@ -0,0 +1,24 @@
+import { encodeBigEndian, KEY_BUNDLE_TYPE } from "./crypto.js";
+export function xmppPreKey(pair, id) {
+    return {
+        attrs: {},
+        content: [
+            { attrs: {}, content: encodeBigEndian(id, 3), tag: "id" },
+            { attrs: {}, content: pair.public, tag: "value" },
+        ],
+        tag: "key",
+    };
+}
+export function xmppSignedPreKey(key) {
+    return {
+        attrs: {},
+        content: [
+            { attrs: {}, content: encodeBigEndian(key.keyId, 3), tag: "id" },
+            { attrs: {}, content: key.keyPair.public, tag: "value" },
+            { attrs: {}, content: key.signature, tag: "signature" },
+        ],
+        tag: "skey",
+    };
+}
+export { KEY_BUNDLE_TYPE };
+//# sourceMappingURL=signal.js.map

package/dist/src/servers/whatsapp-wire/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../../../src/servers/whatsapp-wire/signal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAoC,MAAM,aAAa,CAAC;AAEjG,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,EAAU;IAClD,OAAO;QACL,KAAK,EAAE,EAAE;QACT,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE;YACzD,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE;SAClD;QACD,GAAG,EAAE,KAAK;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAkB;IACjD,OAAO;QACL,KAAK,EAAE,EAAE;QACT,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE;YAChE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE;YACxD,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE;SACxD;QACD,GAAG,EAAE,MAAM;KACZ,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/src/servers/whatsapp.d.ts

@@ -0,0 +1,39 @@
+import { type WhatsAppBaileysInboundMessage } from "./whatsapp-baileys-websocket.js";
+export type WhatsAppBaileysMessage = WhatsAppBaileysInboundMessage;
+export type WhatsAppServerManifest = {
+    accessToken: string;
+    adminToken: string;
+    baseUrl: string;
+    endpoints: {
+        adminInboundUrl: string;
+        apiRoot: string;
+        baileysWebSocketUrl: string;
+        messagesUrl: string;
+        presenceUrl: string;
+    };
+    env: {
+        CRABLINE_WHATSAPP_ADMIN_TOKEN: string;
+        CRABLINE_WHATSAPP_ACCESS_TOKEN: string;
+        CRABLINE_WHATSAPP_API_ROOT: string;
+        CRABLINE_WHATSAPP_BAILEYS_WEB_SOCKET_URL: string;
+        CRABLINE_WHATSAPP_RECORDER_PATH: string;
+        CRABLINE_WHATSAPP_SELF_JID: string;
+    };
+    provider: "whatsapp";
+    recorderPath: string;
+    selfJid: string;
+    version: 1;
+};
+export type StartedWhatsAppServer = {
+    close(): Promise<void>;
+    manifest: WhatsAppServerManifest;
+};
+export type StartWhatsAppServerParams = {
+    accessToken?: string | undefined;
+    adminToken?: string | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+    recorderPath?: string | undefined;
+    selfJid?: string | undefined;
+};
+export declare function startWhatsAppServer(params?: StartWhatsAppServerParams): Promise<StartedWhatsAppServer>;

package/dist/src/{fake-servers → servers}/whatsapp.js

@@ -2,6 +2,7 @@ import { randomBytes } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { adminAuthError, hasAdminToken, jsonResponse, parseRequestBody, queryRecord, readTrimmedString, startHttpJsonServer, } from "./http.js";
+import { attachWhatsAppBaileysWebSocketServer, } from "./whatsapp-baileys-websocket.js";
 const WHATSAPP_USER_JID_RE = /^\d{7,15}(?::\d+)?@s\.whatsapp\.net$/iu;
 const WHATSAPP_LEGACY_USER_JID_RE = /^\d{7,15}@c\.us$/iu;
 const WHATSAPP_GROUP_JID_RE = /^\d{5,}@g\.us$/iu;
@@ -65,42 +66,6 @@ function nextMessageId(state) {
 function waIdFromJid(jid) {
     return jid.split("@", 1)[0]?.split(":", 1)[0] ?? jid;
 }
-function trimTrailingSlashes(value) {
-    let end = value.length;
-    while (end > 0 && value.charCodeAt(end - 1) === 47) {
-        end -= 1;
-    }
-    return value.slice(0, end);
-}
-function trimLeadingSlashes(value) {
-    let start = 0;
-    while (start < value.length && value.charCodeAt(start) === 47) {
-        start += 1;
-    }
-    return value.slice(start);
-}
-function joinUrl(root, pathPart) {
-    return `${trimTrailingSlashes(root)}/${trimLeadingSlashes(pathPart)}`;
-}
-function normalizeApiRoot(value) {
-    return trimTrailingSlashes(value);
-}
-async function postJson(params) {
-    const response = await params.fetchImpl(params.url, {
-        body: JSON.stringify(params.body),
-        headers: {
-            authorization: `Bearer ${params.accessToken}`,
-            "content-type": "application/json",
-        },
-        method: "POST",
-    });
-    const rawBody = await response.text();
-    const parsed = rawBody ? JSON.parse(rawBody) : {};
-    if (!response.ok) {
-        throw new Error(`WhatsApp API request failed with HTTP ${response.status}.`);
-    }
-    return parsed;
-}
 function requireMessagingProduct(body) {
     const messagingProduct = readTrimmedString(body.messaging_product);
     if (messagingProduct && messagingProduct !== "whatsapp") {
@@ -142,122 +107,6 @@ function createWhatsAppMessage(params) {
         pushName: params.pushName ?? (params.fromMe ? "Test Bot" : "Test User"),
     };
 }
-function readBaileysTextContent(content) {
-    const text = readTrimmedString(content.text) ?? readTrimmedString(content.conversation);
-    if (!text) {
-        throw new Error("WhatsApp Baileys mock supports text sends only.");
-    }
-    return text;
-}
-function readResponseMessage(body, fallbackJid) {
-    const message = body.message;
-    if (message && typeof message === "object") {
-        return message;
-    }
-    const messageId = readTrimmedString(body.messages?.[0]?.id) ??
-        readTrimmedString(body.messageId) ??
-        "wamid.FAKEUNKNOWN";
-    return createWhatsAppMessage({
-        fromMe: true,
-        id: messageId,
-        remoteJid: fallbackJid,
-        text: "",
-    });
-}
-function createEventBus() {
-    const listeners = new Map();
-    return {
-        emit(event, payload) {
-            const handlers = listeners.get(event);
-            if (!handlers?.size) {
-                return false;
-            }
-            for (const handler of handlers) {
-                handler(payload);
-            }
-            return true;
-        },
-        off(event, handler) {
-            listeners.get(event)?.delete(handler);
-        },
-        on(event, handler) {
-            const handlers = listeners.get(event) ?? new Set();
-            handlers.add(handler);
-            listeners.set(event, handlers);
-        },
-    };
-}
-export class WhatsAppBaileysMockRegistry {
-    #busesByApiRoot = new Map();
-    clear(apiRoot) {
-        this.#busesByApiRoot.delete(normalizeApiRoot(apiRoot));
-    }
-    createSocket(config) {
-        const fetchImpl = config.fetch ?? fetch;
-        const selfJid = config.selfJid ?? "15550000000@s.whatsapp.net";
-        const ev = createEventBus();
-        this.register(config.apiRoot, ev);
-        return {
-            ev,
-            async sendMessage(jid, content) {
-                const text = readBaileysTextContent(content);
-                const body = await postJson({
-                    accessToken: config.accessToken,
-                    body: {
-                        messaging_product: "whatsapp",
-                        text: { body: text },
-                        to: jid,
-                        type: "text",
-                    },
-                    fetchImpl,
-                    url: joinUrl(config.apiRoot, "messages"),
-                });
-                const message = readResponseMessage(body, jid);
-                ev.emit("messages.upsert", { messages: [message], type: "notify" });
-                return message;
-            },
-            async sendPresenceUpdate(presence, jid) {
-                await postJson({
-                    accessToken: config.accessToken,
-                    body: { ...(jid ? { jid } : {}), presence },
-                    fetchImpl,
-                    url: joinUrl(config.apiRoot, "presence"),
-                });
-                ev.emit("presence.update", { jid, presence });
-            },
-            user: {
-                id: selfJid,
-                name: "Test Bot",
-            },
-        };
-    }
-    emitInbound(apiRoot, message) {
-        const buses = this.#busesByApiRoot.get(normalizeApiRoot(apiRoot));
-        if (!buses?.size) {
-            return;
-        }
-        const payload = { messages: [message], type: "notify" };
-        for (const ev of buses) {
-            ev.emit("messages.upsert", payload);
-        }
-    }
-    register(apiRoot, ev) {
-        const key = normalizeApiRoot(apiRoot);
-        const buses = this.#busesByApiRoot.get(key) ?? new Set();
-        buses.add(ev);
-        this.#busesByApiRoot.set(key, buses);
-    }
-}
-export const DEFAULT_WHATSAPP_BAILEYS_MOCK_REGISTRY = new WhatsAppBaileysMockRegistry();
-export function createWhatsAppBaileysMockSocket(config) {
-    const registry = config.registry ?? DEFAULT_WHATSAPP_BAILEYS_MOCK_REGISTRY;
-    return registry.createSocket({
-        accessToken: config.accessToken,
-        apiRoot: config.apiRoot,
-        fetch: config.fetch,
-        selfJid: config.selfJid,
-    });
-}
 async function handleSendMessage(params) {
     const productError = requireMessagingProduct(params.body);
     if (productError) {
@@ -305,7 +154,7 @@ async function handleAdminInbound(params) {
     const text = readTrimmedString(params.body.text);
     if (!text) {
         return {
-            response: graphParameterError("(#100) Missing required parameter: text", "An inbound WhatsApp fake event requires text."),
+            response: graphParameterError("(#100) Missing required parameter: text", "An inbound WhatsApp event requires text."),
         };
     }
     const message = createWhatsAppMessage({
@@ -381,7 +230,7 @@ async function handleRequest(params) {
         }
         await appendEvent(params.state, event);
         if (result.message) {
-            params.state.baileysRegistry.emitInbound(params.state.apiRoot, result.message);
+            params.state.deliverInboundMessage(result.message);
         }
         return result.response;
     }
@@ -412,16 +261,16 @@ async function handleRequest(params) {
     }
     return new Response("not found", { status: 404 });
 }
-export async function startWhatsAppFakeServer(params = {}) {
+export async function startWhatsAppServer(params = {}) {
     const state = {
         accessToken: params.accessToken ?? "crabline-whatsapp-access-token",
         adminToken: params.adminToken ?? randomBytes(24).toString("hex"),
         apiRoot: "",
-        baileysRegistry: params.baileysRegistry ?? DEFAULT_WHATSAPP_BAILEYS_MOCK_REGISTRY,
+        deliverInboundMessage: () => undefined,
         displayPhoneNumber: "15550000000",
         nextMessageId: 1,
         phoneNumberId: "TEST_PHONE_NUMBER_ID",
-        recorderPath: params.recorderPath ?? path.resolve(".crabline", "fake-servers", "whatsapp.jsonl"),
+        recorderPath: params.recorderPath ?? path.resolve(".crabline", "servers", "whatsapp.jsonl"),
         selfJid: params.selfJid ?? "15550000000@s.whatsapp.net",
     };
     const host = params.host ?? "127.0.0.1";
@@ -433,20 +282,21 @@ export async function startWhatsAppFakeServer(params = {}) {
     });
     const baseUrl = httpServer.baseUrl;
     const apiRoot = `${baseUrl}/crabline/whatsapp`;
+    const baileysWebSocketUrl = `${baseUrl.replace(/^http/u, "ws")}/crabline/whatsapp/ws/chat?access_token=${encodeURIComponent(state.accessToken)}`;
     state.apiRoot = apiRoot;
+    const baileysWebSocketServer = attachWhatsAppBaileysWebSocketServer({
+        accessToken: state.accessToken,
+        appendEvent: (event) => appendEvent(state, event),
+        httpServer: httpServer.server,
+        path: "/crabline/whatsapp/ws/chat",
+        selfJid: state.selfJid,
+    });
+    state.deliverInboundMessage = (message) => baileysWebSocketServer.deliverInboundMessage(message);
     return {
         async close() {
-            state.baileysRegistry.clear(apiRoot);
+            await baileysWebSocketServer.close();
             await httpServer.close();
         },
-        createBaileysMockSocket(config = {}) {
-            return state.baileysRegistry.createSocket({
-                accessToken: state.accessToken,
-                apiRoot,
-                selfJid: state.selfJid,
-                ...config,
-            });
-        },
         manifest: {
             accessToken: state.accessToken,
             adminToken: state.adminToken,
@@ -454,6 +304,7 @@ export async function startWhatsAppFakeServer(params = {}) {
             endpoints: {
                 adminInboundUrl: `${apiRoot}/inbound`,
                 apiRoot,
+                baileysWebSocketUrl,
                 messagesUrl: `${apiRoot}/messages`,
                 presenceUrl: `${apiRoot}/presence`,
             },
@@ -461,6 +312,7 @@ export async function startWhatsAppFakeServer(params = {}) {
                 CRABLINE_WHATSAPP_ADMIN_TOKEN: state.adminToken,
                 CRABLINE_WHATSAPP_ACCESS_TOKEN: state.accessToken,
                 CRABLINE_WHATSAPP_API_ROOT: apiRoot,
+                CRABLINE_WHATSAPP_BAILEYS_WEB_SOCKET_URL: baileysWebSocketUrl,
                 CRABLINE_WHATSAPP_RECORDER_PATH: state.recorderPath,
                 CRABLINE_WHATSAPP_SELF_JID: state.selfJid,
             },

package/dist/src/servers/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.js","sourceRoot":"","sources":["../../../src/servers/whatsapp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oCAAoC,GAErC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,oBAAoB,GAAG,wCAAwC,CAAC;AACtE,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AACzD,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AACjD,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAgE3C,SAAS,UAAU,CAAC,KAAK,GAA4B,EAAE;IACrD,OAAO,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,MAMnB;IACC,OAAO,YAAY,CACjB;QACE,KAAK,EAAE;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG;YACxB,GAAG,CAAC,MAAM,CAAC,OAAO;gBAChB,CAAC,CAAC;oBACE,UAAU,EAAE;wBACV,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,iBAAiB,EAAE,UAAU;qBAC9B;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,UAAU,EAAE,aAAa;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,gBAAgB;SACtC;QACD,EAAE,EAAE,KAAK;KACV,EACD,MAAM,CAAC,MAAM,IAAI,GAAG,CACrB,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe,EAAE,OAAgB;IAC5D,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,6BAA6B;QACtC,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,KAA0B,EAAE,KAAyB;IAC9E,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,CACL,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QAChC,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC;QACvC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QACjC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc,EAAE,KAAa;IACvD,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,WAAW,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,OAAO,mBAAmB,CACxB,6BAA6B,KAAK,EAAE,EACpC,GAAG,KAAK,wFAAwF,CACjG,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,OAAwB,EAAE,KAA0B;IACvE,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;IACpD,OAAO,CACL,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,UAAU,KAAK,CAAC,WAAW,EAAE,CAC5F,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAA0B;IAC/C,OAAO,aAAa,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AACvD,CAAC;AAED,SAAS,uBAAuB,CAAC,IAA6B;IAC5D,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACnE,IAAI,gBAAgB,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACxD,OAAO,mBAAmB,CACxB,6CAA6C,EAC7C,uCAAuC,CACxC,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAA6B;IACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CACxB,iCAAiC,EACjC,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,QAAQ,GACZ,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAC5C,CAAC,CAAC,iBAAiB,CAAE,WAAuC,CAAC,IAAI,CAAC;QAClE,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,WAAW,GACf,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QACpC,CAAC,CAAC,iBAAiB,CAAE,OAAmC,CAAC,IAAI,CAAC;QAC9D,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG,QAAQ,IAAI,WAAW,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,mBAAmB,CACxB,8CAA8C,EAC9C,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,MAO9B;IACC,OAAO;QACL,GAAG,EAAE;YACH,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B;QACD,OAAO,EAAE;YACP,YAAY,EAAE,MAAM,CAAC,IAAI;SAC1B;QACD,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,MAGhC;IACC,MAAM,YAAY,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvE,IAAI,EAAE,YAAY,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,IAAI,YAAY,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,qBAAqB,CAAC;QACpC,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/B,SAAS,EAAE,EAAE;QACb,IAAI;KACL,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC7B,OAAO,UAAU,CAAC;QAChB,QAAQ,EAAE;YACR;gBACE,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,IAAI;aACZ;SACF;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE;QACzB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAClC,iBAAiB,EAAE,UAAU;QAC7B,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAGjC;IACC,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzF,IAAI,OAAO,YAAY,QAAQ,EAAE,CAAC;QAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7F,IAAI,SAAS,YAAY,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,QAAQ,EAAE,mBAAmB,CAC3B,yCAAyC,EACzC,0CAA0C,CAC3C;SACF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,qBAAqB,CAAC;QACpC,MAAM,EAAE,KAAK;QACb,EAAE,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3E,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW;QAChE,SAAS,EAAE,OAAO;QAClB,SAAS;QACT,IAAI;KACL,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG;QACd,KAAK,EAAE;YACL;gBACE,OAAO,EAAE;oBACP;wBACE,KAAK,EAAE,UAAU;wBACjB,KAAK,EAAE;4BACL,QAAQ,EAAE;gCACR;oCACE,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE;oCACzE,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC;iCAC9B;6BACF;4BACD,QAAQ,EAAE;gCACR;oCACE,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC;oCAC5B,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE;oCAClB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;oCACpB,SAAS;oCACT,IAAI,EAAE,MAAM;iCACb;6BACF;4BACD,iBAAiB,EAAE,UAAU;4BAC7B,QAAQ,EAAE;gCACR,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,kBAAkB;gCACrD,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa;6BAC5C;yBACF;qBACF;iBACF;gBACD,EAAE,EAAE,WAAW;aAChB;SACF;QACD,MAAM,EAAE,2BAA2B;KACpC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAgE;IAC3F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAEnE,IAAI,GAAG,CAAC,QAAQ,KAAK,2BAA2B,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,4BAA4B,EAAE,CAAC;QAClD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACrC,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,OAAO,cAAc,EAAE,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACvE,MAAM,KAAK,GAA0B;YACnC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC7B,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;YACvB,IAAI,EAAE,OAAO;SACd,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,MAAM,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9F,MAAM,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE;QAC9B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK;QACtC,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;QACvB,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IAEH,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,6BAA6B,EAAE,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACrC,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,MAAM,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,6BAA6B,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC;QACjE,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,OAAO,mBAAmB,CACxB,oCAAoC,EACpC,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAM,GAA8B,EAAE;IAEtC,MAAM,KAAK,GAAwB;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,gCAAgC;QACnE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChE,OAAO,EAAE,EAAE;QACX,qBAAqB,EAAE,GAAG,EAAE,CAAC,SAAS;QACtC,kBAAkB,EAAE,aAAa;QACjC,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,sBAAsB;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC;QAC3F,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,4BAA4B;KACxD,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC;QAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACtD,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;QACtB,UAAU,EAAE,UAAU;KACvB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACnC,MAAM,OAAO,GAAG,GAAG,OAAO,oBAAoB,CAAC;IAC/C,MAAM,mBAAmB,GAAG,GAAG,OAAO,CAAC,OAAO,CAC5C,QAAQ,EACR,IAAI,CACL,2CAA2C,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IACpF,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,MAAM,sBAAsB,GAAG,oCAAoC,CAAC;QAClE,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;QACjD,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,qBAAqB,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACjG,OAAO;QACL,KAAK,CAAC,KAAK;YACT,MAAM,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;QAC3B,CAAC;QACD,QAAQ,EAAE;YACR,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO;YACP,SAAS,EAAE;gBACT,eAAe,EAAE,GAAG,OAAO,UAAU;gBACrC,OAAO;gBACP,mBAAmB;gBACnB,WAAW,EAAE,GAAG,OAAO,WAAW;gBAClC,WAAW,EAAE,GAAG,OAAO,WAAW;aACnC;YACD,GAAG,EAAE;gBACH,6BAA6B,EAAE,KAAK,CAAC,UAAU;gBAC/C,8BAA8B,EAAE,KAAK,CAAC,WAAW;gBACjD,0BAA0B,EAAE,OAAO;gBACnC,wCAAwC,EAAE,mBAAmB;gBAC7D,+BAA+B,EAAE,KAAK,CAAC,YAAY;gBACnD,0BAA0B,EAAE,KAAK,CAAC,OAAO;aAC1C;YACD,QAAQ,EAAE,UAAU;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,CAAC;SACX;KACF,CAAC;AACJ,CAAC"}

package/docs/channel-setup.md

@@ -4,7 +4,7 @@ Crabline is a local mock service for OpenClaw channel contracts. It has two
 surfaces:
 
 - fixture-level local mocks used directly by the Crabline CLI
-- fake provider servers that OpenClaw live adapters can target
+- local provider servers that OpenClaw live adapters can target
 
 Live channel testing belongs in OpenClaw's live channel adapters. Crabline
 belongs in deterministic smoke CI and local QA where the test needs
@@ -70,11 +70,11 @@ Provider credential fields such as `botToken`, `accessToken`, `baseURL`, or
 `serverUrl` are optional mock metadata. They are not required for local mock
 execution.
 
-## Fake Provider Servers
+## Local Provider Servers
 
-Fake provider servers sit below OpenClaw's normal channel adapters. QA starts the
+Local provider servers sit below OpenClaw's normal channel adapters. QA starts the
 server, writes the emitted runtime manifest into OpenClaw config/env, and then
-OpenClaw talks to the local fake provider instead of the public provider.
+OpenClaw talks to the local provider instead of the public provider.
 
 Slack:
 
@@ -145,34 +145,36 @@ crabline --json serve whatsapp --ready-file .crabline/whatsapp-server.json
 
 Manifest fields:
 
-- `endpoints.apiRoot`: Crabline WhatsApp fake provider API root
-- `accessToken`: bearer token for fake provider requests
+- `endpoints.apiRoot`: Crabline WhatsApp local provider API root
+- `endpoints.baileysWebSocketUrl`: Baileys-compatible WebSocket URL for
+  `waWebSocketUrl`, including the local provider access token query parameter
+- `accessToken`: bearer token for local provider requests
 - `adminToken`: value for the `X-Crabline-Admin-Token` header on admin ingress
-- `selfJid`: fake authenticated WhatsApp user JID
-- `env.CRABLINE_WHATSAPP_ACCESS_TOKEN`: access token for the runtime socket
-  factory
-- `env.CRABLINE_WHATSAPP_API_ROOT`: API root for the runtime socket factory
-- `env.CRABLINE_WHATSAPP_RECORDER_PATH`: recorder file followed by the runtime
-  socket factory for cross-process inbound delivery
-- `env.CRABLINE_WHATSAPP_SELF_JID`: fake authenticated WhatsApp user JID for
-  the runtime socket factory
+- `selfJid`: local authenticated WhatsApp user JID
+- `env.CRABLINE_WHATSAPP_ACCESS_TOKEN`: same value as `accessToken`
+- `env.CRABLINE_WHATSAPP_API_ROOT`: same value as `endpoints.apiRoot`
+- `env.CRABLINE_WHATSAPP_BAILEYS_WEB_SOCKET_URL`: same value as
+  `endpoints.baileysWebSocketUrl`
+- `env.CRABLINE_WHATSAPP_RECORDER_PATH`: recorder file for HTTP traffic and
+  Baileys WebSocket stanzas
+- `env.CRABLINE_WHATSAPP_SELF_JID`: local authenticated WhatsApp user JID
 - `endpoints.adminInboundUrl`: authenticated admin ingress for test user
-  messages; subscribed Baileys mock sockets receive them as `messages.upsert`
-- `endpoints.messagesUrl`: text send endpoint used by the Baileys-shaped mock
-- `endpoints.presenceUrl`: presence endpoint used by `sendPresenceUpdate`
-- `recorderPath`: JSONL provider traffic recorder
-
-Use the package subpath `@openclaw/crabline/whatsapp-socket-factory` when a
-runtime needs a Baileys-style module with `createWhatsAppSocket()`. The module
-reads the `CRABLINE_WHATSAPP_*` env vars emitted by the manifest, sends outbound
-traffic to the fake provider API, and follows the recorder for inbound
-`messages.upsert` events. The admin token is generated randomly unless
-`--admin-token <token>` is provided.
+  messages using the WhatsApp Business webhook payload shape
+- `endpoints.messagesUrl`: text send endpoint for Graph-style callers
+- `endpoints.presenceUrl`: presence endpoint for Graph-style callers
+- `recorderPath`: JSONL provider traffic recorder for HTTP traffic and Baileys
+  WebSocket stanzas
+
+Pass `endpoints.baileysWebSocketUrl` to Baileys as `waWebSocketUrl` when a
+runtime needs to connect through the local provider. The local server completes
+the Baileys Noise handshake, serves bootstrap/device/prekey queries, and records
+encrypted outbound WebSocket stanzas. The WebSocket endpoint rejects clients
+that do not present the access token embedded in the manifest URL. The admin
+token is generated randomly unless `--admin-token <token>` is provided.
 
 OpenClaw bridge callers should post injected user messages with the
 `providerUrl`, `providerHeaders`, and `providerBody` returned by
-`createOpenClawCrablineInbound()`. For direct in-process tests, the started fake
-server also exposes `createBaileysMockSocket()`.
+`createOpenClawCrablineInbound()`.
 The admin ingress accepts JSON like:
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/crabline",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Standalone CLI for deterministic messaging provider E2E tests",
   "homepage": "https://github.com/openclaw/crabline#readme",
   "bugs": {
@@ -27,10 +27,6 @@
     ".": {
       "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
-    },
-    "./whatsapp-socket-factory": {
-      "types": "./dist/src/fake-servers/whatsapp-socket-factory.d.ts",
-      "import": "./dist/src/fake-servers/whatsapp-socket-factory.js"
     }
   },
   "scripts": {
@@ -53,18 +49,22 @@
     "check": "pnpm verify"
   },
   "dependencies": {
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
+    "curve25519-js": "^0.0.4",
     "picocolors": "^1.1.1",
+    "ws": "^8.21.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
-    "@typescript/native-preview": "7.0.0-dev.20260503.1",
+    "@types/node": "^26.0.1",
+    "@types/ws": "^8.18.1",
+    "@typescript/native-preview": "7.0.0-dev.20260629.1",
     "@vitest/coverage-v8": "^4.1.8",
-    "oxfmt": "^0.47.0",
+    "baileys": "7.0.0-rc13",
+    "oxfmt": "^0.56.0",
     "oxlint": "^1.69.0",
-    "oxlint-tsgolint": "^0.22.1",
+    "oxlint-tsgolint": "^0.23.0",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"