@openclaw/crabline 0.0.0

package/dist/src/providers/types.d.ts

@@ -0,0 +1,94 @@
+import type { FixtureDefinition, FixtureMode, InboundAuthor, ProviderConfig, ProviderPlatform } from "../config/schema.js";
+export type ProviderSupportStatus = "bridge" | "planned" | "ready";
+export type InboundMatchConfig = {
+    author: InboundAuthor;
+    nonce: "contains" | "exact" | "ignore";
+    pattern?: string | undefined;
+    strategy: "contains" | "exact" | "regex";
+};
+export type NormalizedTarget = {
+    channelId?: string | undefined;
+    id: string;
+    metadata: Record<string, string>;
+    threadId?: string | undefined;
+};
+export type InboundEnvelope = {
+    author: Exclude<InboundAuthor, "any">;
+    id: string;
+    provider: string;
+    raw?: unknown;
+    sentAt: string;
+    text: string;
+    threadId: string;
+};
+export type ProbeResult = {
+    details: string[];
+    healthy: boolean;
+};
+export type SendResult = {
+    accepted: boolean;
+    messageId: string;
+    threadId: string;
+};
+export type ProviderContext = {
+    config: ProviderConfig;
+    fixture: FixtureDefinition;
+    manifestPath: string;
+    providerId: string;
+    userName: string;
+};
+export type SendContext = ProviderContext & {
+    mode: Extract<FixtureMode, "agent" | "roundtrip" | "send">;
+    nonce: string;
+    text: string;
+};
+export type WaitContext = ProviderContext & {
+    nonce: string;
+    since: string;
+    threadId?: string | undefined;
+    timeoutMs: number;
+};
+export type WatchContext = ProviderContext & {
+    since?: string;
+};
+export interface ProviderAdapter {
+    readonly id: string;
+    readonly platform: ProviderPlatform;
+    readonly status: ProviderSupportStatus;
+    readonly supports: readonly FixtureMode[];
+    normalizeTarget(target: FixtureDefinition["target"]): NormalizedTarget;
+    probe(context: ProviderContext): Promise<ProbeResult>;
+    send(context: SendContext): Promise<SendResult>;
+    waitForInbound(context: WaitContext): Promise<InboundEnvelope | null>;
+    watch?(context: WatchContext): AsyncIterable<InboundEnvelope>;
+    cleanup?(): Promise<void>;
+}
+export type LoopbackMessage = {
+    author: {
+        isMe: boolean;
+        userName: string;
+    };
+    formatted: string;
+    id: string;
+    metadata: {
+        dateSent: Date;
+        edited: boolean;
+        editedAt?: Date;
+    };
+    raw: {
+        author: "assistant" | "user";
+        id: string;
+        text: string;
+        threadId: string;
+        timestamp: string;
+    };
+    text: string;
+    threadId: string;
+};
+export type LoopbackRawMessage = {
+    author: "assistant" | "user";
+    id: string;
+    text: string;
+    threadId: string;
+    timestamp: string;
+};

package/dist/src/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/src/providers/webhook-server.d.ts

@@ -0,0 +1,12 @@
+export type StartedWebhookServer = {
+    close(): Promise<void>;
+    endpointUrl: string;
+};
+export declare function startWebhookServer(params: {
+    handle(request: Request): Promise<Response>;
+    host: string;
+    maxBodyBytes?: number;
+    methods?: readonly string[] | undefined;
+    path: string;
+    port: number;
+}): Promise<StartedWebhookServer>;

package/dist/src/providers/webhook-server.js

@@ -0,0 +1,118 @@
+import { createServer } from "node:http";
+const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
+class RequestBodyTooLargeError extends Error {
+}
+async function readRequestBody(request, maxBodyBytes) {
+    return await new Promise((resolve, reject) => {
+        const chunks = [];
+        let bodyBytes = 0;
+        let settled = false;
+        request.on("data", (chunk) => {
+            if (settled) {
+                return;
+            }
+            const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            bodyBytes += buffer.length;
+            if (bodyBytes > maxBodyBytes) {
+                settled = true;
+                request.resume();
+                reject(new RequestBodyTooLargeError());
+                return;
+            }
+            chunks.push(buffer);
+        });
+        request.once("end", () => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            resolve(Buffer.concat(chunks));
+        });
+        request.once("error", (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            reject(error);
+        });
+    });
+}
+async function toFetchRequest(request, maxBodyBytes) {
+    const host = request.headers.host ?? "127.0.0.1";
+    const url = new URL(request.url ?? "/", `http://${host}`);
+    const body = request.method === "GET" || request.method === "HEAD"
+        ? undefined
+        : await readRequestBody(request, maxBodyBytes);
+    const init = {
+        headers: request.headers,
+    };
+    if (request.method) {
+        init.method = request.method;
+    }
+    if (body) {
+        init.body = body;
+        init.duplex = "half";
+    }
+    return new Request(url, init);
+}
+async function writeFetchResponse(response, fetchResponse) {
+    response.statusCode = fetchResponse.status;
+    for (const [name, value] of fetchResponse.headers) {
+        response.setHeader(name, value);
+    }
+    if (!fetchResponse.body) {
+        response.end();
+        return;
+    }
+    const body = Buffer.from(await fetchResponse.arrayBuffer());
+    response.end(body);
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+export async function startWebhookServer(params) {
+    const methods = new Set(params.methods ?? ["POST"]);
+    const maxBodyBytes = params.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES;
+    const server = createServer(async (request, response) => {
+        try {
+            const fetchRequest = await toFetchRequest(request, maxBodyBytes);
+            const pathname = new URL(fetchRequest.url).pathname;
+            if (!methods.has(fetchRequest.method) || pathname !== params.path) {
+                await writeFetchResponse(response, new Response("not found", { status: 404 }));
+                return;
+            }
+            await writeFetchResponse(response, await params.handle(fetchRequest));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const status = error instanceof RequestBodyTooLargeError ? 413 : 500;
+            await writeFetchResponse(response, new Response(status === 413 ? "request body too large" : message, { status }));
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(params.port, params.host, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        throw new Error("Unable to resolve webhook server address.");
+    }
+    return {
+        async close() {
+            await closeServer(server);
+        },
+        endpointUrl: `http://${params.host}:${address.port}${params.path}`,
+    };
+}
+//# sourceMappingURL=webhook-server.js.map

package/dist/src/providers/webhook-server.js.map

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

package/docs/channel-setup.md

@@ -0,0 +1,181 @@
+# Channel Setup
+
+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
+
+Live channel testing belongs in OpenClaw's live channel adapters. Crabline
+belongs in deterministic smoke CI and local QA where the test needs
+provider-shaped behavior without external services.
+
+## Provider Shape
+
+Provider ids are local profile names:
+
+```yaml
+providers:
+  telegram:
+    adapter: telegram
+```
+
+Fixtures reference provider ids:
+
+```yaml
+fixtures:
+  - id: telegram-dm
+    provider: telegram
+```
+
+Built-in adapters infer `platform` from `adapter`. `platform` is required only
+for `adapter: script`, where Crabline needs to know which OpenClaw channel the
+bridge profile represents.
+
+## Built-In Local Mocks
+
+| Adapter      | Default Webhook Path    | Default Port |
+| ------------ | ----------------------- | ------------ |
+| `discord`    | `/discord/interactions` | `8788`       |
+| `feishu`     | `/feishu/webhook`       | `8795`       |
+| `googlechat` | `/googlechat/webhook`   | `8792`       |
+| `imessage`   | `/imessage/webhook`     | `8796`       |
+| `matrix`     | `/matrix/webhook`       | `8797`       |
+| `mattermost` | `/mattermost/webhook`   | `8793`       |
+| `msteams`    | `/msteams/webhook`      | `8791`       |
+| `slack`      | `/slack/events`         | `8787`       |
+| `telegram`   | `/telegram/webhook`     | `8790`       |
+| `whatsapp`   | `/whatsapp/webhook`     | `8789`       |
+| `zalo`       | `/zalo/webhook`         | `8794`       |
+
+`loopback` has no externally meaningful webhook surface and is primarily useful
+for local direct adapter checks.
+
+## Mock Config
+
+```yaml
+providers:
+  slack:
+    adapter: slack
+    slack:
+      recorder:
+        path: ./.crabline/recorders/slack.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8787
+        path: /slack/events
+```
+
+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
+
+Fake 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.
+
+Telegram is currently implemented:
+
+```bash
+crabline --json serve telegram --ready-file .crabline/telegram-server.json
+```
+
+Manifest fields:
+
+- `endpoints.apiRoot`: OpenClaw `channels.telegram.apiRoot`
+- `botToken`: OpenClaw `channels.telegram.botToken`
+- `adminToken`: value for the `X-Crabline-Admin-Token` header on admin ingress
+- `endpoints.adminInboundUrl`: authenticated admin ingress for test user messages
+- `recorderPath`: JSONL provider traffic recorder
+
+The admin token is generated randomly unless `--admin-token <token>` is
+provided. Requests may also use `Authorization: Bearer <token>`.
+
+The admin ingress accepts JSON like:
+
+```json
+{
+  "chatId": "-1001234567890",
+  "messageThreadId": 42,
+  "fromId": 100001,
+  "text": "user nonce-123"
+}
+```
+
+OpenClaw consumes that message through Telegram `getUpdates`; outbound adapter
+sends are recorded through Telegram `sendMessage`.
+
+## Webhook Payload
+
+Mock webhooks accept provider-native event payloads where Crabline has a built-in
+adapter for the channel. They also accept this simple JSON shape with native
+thread ids:
+
+```json
+{
+  "id": "inbound-1",
+  "threadId": "C1234567890",
+  "text": "reply nonce-123",
+  "author": "assistant"
+}
+```
+
+The nested form is also accepted:
+
+```json
+{
+  "message": {
+    "id": "inbound-1",
+    "threadId": "C1234567890",
+    "text": "reply nonce-123"
+  }
+}
+```
+
+Missing `threadId` or `text` returns `400`. Non-JSON requests return `415`.
+
+## Target IDs
+
+Targets use native channel identifiers. Crabline does not add local prefixes such
+as `telegram:`, `discord:`, or `slack:`.
+
+- Slack conversations: `C1234567890`, `G1234567890`, or `D1234567890`
+- Slack threads: `1700000000.000100`
+- Telegram chats: `-1001234567890` or `@channelusername`
+- Telegram topics: `42`
+- Discord channels and threads: Discord snowflake ids such as
+  `123456789012345678`
+- Google Chat spaces: `spaces/AAAABbbbCCC`
+- Google Chat threads: `spaces/AAAABbbbCCC/threads/BBBBccccDDD`
+
+## Smoke CI Guidance
+
+For deterministic CI, use Crabline through a mock channel driver:
+
+```yaml
+profile: smoke-ci
+channelDriver: crabline
+```
+
+The scenario channel should remain the real channel contract:
+
+```yaml
+execution:
+  channel: telegram
+```
+
+That means "run Telegram-shaped behavior through the mock Telegram backend."
+It does not mean "connect to live Telegram."
+
+For release or live verification, use OpenClaw's live driver:
+
+```yaml
+profile: release
+channelDriver: live
+```
+
+If a live driver does not support a requested channel, the QA run should report
+unsupported coverage. Crabline should not be used as a substitute for live
+transport coverage.

package/fixtures/examples/crabline.example.yaml

@@ -0,0 +1,195 @@
+configVersion: 1
+userName: crabline
+
+providers:
+  local:
+    adapter: loopback
+    loopback:
+      delayMs: 0
+
+  telegram:
+    adapter: telegram
+    telegram:
+      recorder:
+        path: ./.crabline/recorders/telegram.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8790
+        path: /telegram/webhook
+
+  discord:
+    adapter: discord
+    discord:
+      recorder:
+        path: ./.crabline/recorders/discord.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8788
+        path: /discord/interactions
+
+  slack:
+    adapter: slack
+    slack:
+      recorder:
+        path: ./.crabline/recorders/slack.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8787
+        path: /slack/events
+
+  whatsapp:
+    adapter: whatsapp
+    whatsapp:
+      recorder:
+        path: ./.crabline/recorders/whatsapp.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8789
+        path: /whatsapp/webhook
+
+  msteams:
+    adapter: msteams
+    msteams:
+      recorder:
+        path: ./.crabline/recorders/msteams.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8791
+        path: /msteams/webhook
+
+  googlechat:
+    adapter: googlechat
+    googlechat:
+      recorder:
+        path: ./.crabline/recorders/googlechat.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8792
+        path: /googlechat/webhook
+
+  feishu:
+    adapter: feishu
+    feishu:
+      recorder:
+        path: ./.crabline/recorders/feishu.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8795
+        path: /feishu/webhook
+
+  mattermost:
+    adapter: mattermost
+    mattermost:
+      recorder:
+        path: ./.crabline/recorders/mattermost.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8793
+        path: /mattermost/webhook
+
+  zalo:
+    adapter: zalo
+    zalo:
+      recorder:
+        path: ./.crabline/recorders/zalo.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8794
+        path: /zalo/webhook
+
+  matrix:
+    adapter: matrix
+    matrix:
+      recorder:
+        path: ./.crabline/recorders/matrix.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8797
+        path: /matrix/webhook
+
+  imessage:
+    adapter: imessage
+    imessage:
+      recorder:
+        path: ./.crabline/recorders/imessage.jsonl
+      webhook:
+        host: 127.0.0.1
+        port: 8796
+        path: /imessage/webhook
+
+fixtures:
+  - id: loopback-roundtrip
+    provider: local
+    mode: roundtrip
+    target:
+      id: echo-bot
+      behavior: echo
+
+  - id: telegram-dm
+    provider: telegram
+    mode: roundtrip
+    target:
+      id: "100000001"
+      behavior: agent
+
+  - id: discord-channel
+    provider: discord
+    mode: roundtrip
+    target:
+      id: "123456789012345678"
+      metadata:
+        guildId: "987654321098765432"
+
+  - id: slack-channel
+    provider: slack
+    mode: roundtrip
+    target:
+      id: C1234567890
+
+  - id: whatsapp-dm
+    provider: whatsapp
+    mode: roundtrip
+    target:
+      id: "15551234567"
+
+  - id: msteams-channel
+    provider: msteams
+    mode: roundtrip
+    target:
+      id: "19:conversation@thread.v2"
+
+  - id: googlechat-space
+    provider: googlechat
+    mode: roundtrip
+    target:
+      id: spaces/AAAA1234567
+
+  - id: feishu-chat
+    provider: feishu
+    mode: roundtrip
+    target:
+      id: oc_123
+
+  - id: mattermost-channel
+    provider: mattermost
+    mode: roundtrip
+    target:
+      id: channel-id
+
+  - id: zalo-chat
+    provider: zalo
+    mode: roundtrip
+    target:
+      id: chat-123
+
+  - id: matrix-room
+    provider: matrix
+    mode: roundtrip
+    target:
+      id: "!room:example.com"
+
+  - id: imessage-chat
+    provider: imessage
+    mode: roundtrip
+    target:
+      id: chat-guid