@openclaw/crabline 0.0.0

package/dist/src/providers/builtin/native-local-mock.d.ts

@@ -0,0 +1,48 @@
+import type { LocalMockTargetCodec } from "../local-mock.js";
+import type { InboundEnvelope } from "../types.js";
+export type NativeIdRule = {
+    example: string;
+    name: string;
+    pattern: RegExp;
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function optionalRecord(value: Record<string, unknown>, key: string): Record<string, unknown> | undefined;
+export declare function optionalString(value: Record<string, unknown>, key: string): string | undefined;
+export declare function optionalNumberString(value: Record<string, unknown>, key: string): string | undefined;
+export declare function optionalStringish(value: Record<string, unknown>, key: string): string | undefined;
+export declare function normalizeAuthor(value: unknown): "assistant" | "system" | "user" | undefined;
+export declare function requireNativeId(value: string, rule: NativeIdRule, label: string): string;
+export declare function requireNativeInboundId(value: string, rule: NativeIdRule, label: string): string;
+export declare function createNativeTargetCodec(options: {
+    channel: NativeIdRule;
+    channelLabel?: string | undefined;
+    thread?: NativeIdRule | undefined;
+    threadLabel?: string | undefined;
+}): LocalMockTargetCodec;
+export declare function genericMockPayloadWithNativeThread(params: {
+    channelRule?: NativeIdRule | undefined;
+    payload: Record<string, unknown>;
+    threadRule: NativeIdRule;
+}): {
+    author?: "assistant" | "system" | "user" | undefined;
+    authorIsBot?: boolean;
+    id?: string | undefined;
+    raw: {};
+    text?: string | undefined;
+} | {
+    author?: "assistant" | "system" | "user" | undefined;
+    authorIsBot?: boolean;
+    id?: string | undefined;
+    message?: {
+        author?: "assistant" | "system" | "user" | undefined;
+        authorIsBot?: boolean;
+        id?: string | undefined;
+        raw?: {} | null;
+        text?: string | undefined;
+        threadId: string;
+    };
+    raw: {};
+    text?: string | undefined;
+    threadId: string;
+};
+export declare function authorFromBotFlag(isBot: boolean | undefined): InboundEnvelope["author"];

package/dist/src/providers/builtin/native-local-mock.js

@@ -0,0 +1,119 @@
+import { CrablineError } from "../../core/errors.js";
+export function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+export function optionalRecord(value, key) {
+    const child = value[key];
+    return isRecord(child) ? child : undefined;
+}
+export function optionalString(value, key) {
+    const child = value[key];
+    return typeof child === "string" && child.length > 0 ? child : undefined;
+}
+export function optionalNumberString(value, key) {
+    const child = value[key];
+    return typeof child === "number" || typeof child === "bigint" ? child.toString() : undefined;
+}
+export function optionalStringish(value, key) {
+    return optionalString(value, key) ?? optionalNumberString(value, key);
+}
+export function normalizeAuthor(value) {
+    return value === "assistant" || value === "system" || value === "user" ? value : undefined;
+}
+export function requireNativeId(value, rule, label) {
+    if (!rule.pattern.test(value)) {
+        throw new CrablineError(`${label} must be a native ${rule.name} such as ${rule.example}.`, {
+            kind: "config",
+        });
+    }
+    return value;
+}
+export function requireNativeInboundId(value, rule, label) {
+    if (!rule.pattern.test(value)) {
+        throw new CrablineError(`${label} must be a native ${rule.name} such as ${rule.example}.`, {
+            kind: "inbound",
+        });
+    }
+    return value;
+}
+export function createNativeTargetCodec(options) {
+    const channelLabel = options.channelLabel ?? "channelId";
+    const threadLabel = options.threadLabel ?? "threadId";
+    const threadRule = options.thread ?? options.channel;
+    return {
+        normalize(target) {
+            const channelId = requireNativeId(target.channelId ?? target.id, options.channel, channelLabel);
+            const normalized = {
+                channelId,
+                id: target.id,
+                metadata: target.metadata,
+            };
+            if (target.threadId) {
+                normalized.threadId = requireNativeId(target.threadId, threadRule, threadLabel);
+            }
+            return normalized;
+        },
+        resolveThreadId(target) {
+            const normalized = this.normalize(target);
+            return normalized.threadId ?? normalized.channelId ?? normalized.id;
+        },
+    };
+}
+export function genericMockPayloadWithNativeThread(params) {
+    const message = optionalRecord(params.payload, "message");
+    const threadId = message
+        ? optionalString(message, "threadId")
+        : optionalString(params.payload, "threadId");
+    if (!threadId) {
+        return {
+            ...(normalizeAuthor(params.payload.author)
+                ? { author: normalizeAuthor(params.payload.author) }
+                : {}),
+            ...(typeof params.payload.authorIsBot === "boolean"
+                ? { authorIsBot: params.payload.authorIsBot }
+                : {}),
+            ...(optionalString(params.payload, "id") ? { id: optionalString(params.payload, "id") } : {}),
+            raw: params.payload.raw ?? params.payload,
+            ...(optionalString(params.payload, "text")
+                ? { text: optionalString(params.payload, "text") }
+                : {}),
+        };
+    }
+    const isValidThread = params.threadRule.pattern.test(threadId);
+    const isValidChannel = params.channelRule?.pattern.test(threadId) ?? false;
+    if (!isValidThread && !isValidChannel) {
+        throw new CrablineError(`mock webhook threadId must be a native ${params.threadRule.name}${params.channelRule ? ` or ${params.channelRule.name}` : ""}.`, { kind: "inbound" });
+    }
+    return {
+        ...(normalizeAuthor(params.payload.author)
+            ? { author: normalizeAuthor(params.payload.author) }
+            : {}),
+        ...(typeof params.payload.authorIsBot === "boolean"
+            ? { authorIsBot: params.payload.authorIsBot }
+            : {}),
+        ...(optionalString(params.payload, "id") ? { id: optionalString(params.payload, "id") } : {}),
+        ...(message
+            ? {
+                message: {
+                    ...(normalizeAuthor(message.author) ? { author: normalizeAuthor(message.author) } : {}),
+                    ...(typeof message.authorIsBot === "boolean"
+                        ? { authorIsBot: message.authorIsBot }
+                        : {}),
+                    ...(optionalString(message, "id") ? { id: optionalString(message, "id") } : {}),
+                    ...(message.raw !== undefined ? { raw: message.raw } : {}),
+                    ...(optionalString(message, "text") ? { text: optionalString(message, "text") } : {}),
+                    threadId,
+                },
+            }
+            : {}),
+        raw: params.payload.raw ?? params.payload,
+        ...(optionalString(params.payload, "text")
+            ? { text: optionalString(params.payload, "text") }
+            : {}),
+        threadId,
+    };
+}
+export function authorFromBotFlag(isBot) {
+    return isBot ? "assistant" : "user";
+}
+//# sourceMappingURL=native-local-mock.js.map

package/dist/src/providers/builtin/native-local-mock.js.map

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

package/dist/src/providers/builtin/script.d.ts

@@ -0,0 +1,39 @@
+import type { ProviderAdapter, ProviderContext, SendContext, WaitContext, WatchContext } from "../types.js";
+type ScriptSendResult = {
+    accepted: boolean;
+    messageId: string;
+    threadId: string;
+};
+export declare class ScriptProviderAdapter implements ProviderAdapter {
+    #private;
+    readonly id: string;
+    readonly platform: "bluebubbles" | "discord" | "feishu" | "googlechat" | "imessage" | "irc" | "line" | "loopback" | "matrix" | "mattermost" | "msteams" | "nextcloudtalk" | "nostr" | "signal" | "slack" | "synologychat" | "telegram" | "tlon" | "twitch" | "webchat" | "whatsapp" | "zalo" | "zalouser";
+    readonly status: "bridge";
+    readonly supports: ("agent" | "probe" | "roundtrip" | "send")[];
+    constructor(context: ProviderContext);
+    normalizeTarget(target: ProviderContext["fixture"]["target"]): import("../types.js").NormalizedTarget;
+    probe(context: ProviderContext): Promise<{
+        details: string[];
+        healthy: boolean;
+    }>;
+    send(context: SendContext): Promise<ScriptSendResult>;
+    waitForInbound(context: WaitContext): Promise<{
+        author: "assistant" | "system" | "user";
+        id: string;
+        raw?: unknown;
+        sentAt: string;
+        text: string;
+        threadId: string;
+        provider: string;
+    } | null>;
+    watch(context: WatchContext): AsyncGenerator<{
+        author: "assistant" | "system" | "user";
+        id: string;
+        raw?: unknown;
+        sentAt: string;
+        text: string;
+        threadId: string;
+        provider: string;
+    }, void, unknown>;
+}
+export {};

package/dist/src/providers/builtin/script.js

@@ -0,0 +1,206 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { CrablineError, ensureErrorMessage } from "../../core/errors.js";
+function runScript(command, payload, cwd, shell) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, {
+            cwd: cwd ? path.resolve(cwd) : process.cwd(),
+            env: process.env,
+            shell: shell ?? true,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code !== 0) {
+                reject(new CrablineError(`Script command failed: ${command}\n${stderr.trim() || stdout.trim()}`, {
+                    kind: "connectivity",
+                }));
+                return;
+            }
+            try {
+                resolve(JSON.parse(stdout));
+            }
+            catch (error) {
+                reject(new CrablineError(`Script command did not return valid JSON: ${command}\n${ensureErrorMessage(error)}`, { kind: "config" }));
+            }
+        });
+        child.stdin.end(JSON.stringify(payload));
+    });
+}
+export class ScriptProviderAdapter {
+    id;
+    platform;
+    status = "bridge";
+    supports;
+    #config;
+    constructor(context) {
+        if (!context.config.script) {
+            throw new CrablineError(`Provider "${context.providerId}" is missing script configuration.`, {
+                kind: "config",
+            });
+        }
+        this.id = context.providerId;
+        this.platform = context.config.platform;
+        this.supports = [...context.config.capabilities];
+        this.#config = context.config.script;
+    }
+    normalizeTarget(target) {
+        const normalized = {
+            id: target.id,
+            metadata: target.metadata,
+        };
+        if (target.channelId) {
+            normalized.channelId = target.channelId;
+        }
+        if (target.threadId) {
+            normalized.threadId = target.threadId;
+        }
+        return normalized;
+    }
+    async probe(context) {
+        const command = this.#config.commands.probe;
+        if (!command) {
+            return {
+                details: ["probe command not configured"],
+                healthy: false,
+            };
+        }
+        const result = await runScript(command, createPayload(context), this.#config.cwd, this.#config.shell);
+        return {
+            details: result.details ?? [],
+            healthy: result.healthy,
+        };
+    }
+    async send(context) {
+        const command = this.#config.commands.send;
+        if (!command) {
+            throw new CrablineError(`Provider "${this.id}" is missing send command.`, {
+                kind: "config",
+            });
+        }
+        return runScript(command, {
+            ...createPayload(context),
+            outbound: {
+                mode: context.mode,
+                nonce: context.nonce,
+                target: this.normalizeTarget(context.fixture.target),
+                text: context.text,
+            },
+        }, this.#config.cwd, this.#config.shell);
+    }
+    async waitForInbound(context) {
+        const command = this.#config.commands.waitForInbound;
+        if (!command) {
+            return null;
+        }
+        const result = await runScript(command, {
+            ...createPayload(context),
+            wait: {
+                nonce: context.nonce,
+                since: context.since,
+                target: this.normalizeTarget(context.fixture.target),
+                timeoutMs: context.timeoutMs,
+            },
+        }, this.#config.cwd, this.#config.shell);
+        if (result.timeout || !result.message) {
+            return null;
+        }
+        return {
+            ...result.message,
+            provider: this.id,
+        };
+    }
+    async *watch(context) {
+        const command = this.#config.commands.watch;
+        if (!command) {
+            throw new CrablineError(`Provider "${this.id}" is missing watch command.`, {
+                kind: "config",
+            });
+        }
+        const child = spawn(command, {
+            cwd: this.#config.cwd ? path.resolve(this.#config.cwd) : process.cwd(),
+            env: process.env,
+            shell: this.#config.shell ?? true,
+            detached: process.platform !== "win32",
+            stdio: ["pipe", "pipe", "inherit"],
+        });
+        child.stdin.end(JSON.stringify({
+            ...createPayload(context),
+            watch: {
+                since: context.since,
+                target: this.normalizeTarget(context.fixture.target),
+            },
+        }));
+        let buffer = "";
+        const childClosed = new Promise((resolve) => {
+            if (child.exitCode !== null || child.signalCode !== null) {
+                resolve();
+                return;
+            }
+            child.once("close", () => resolve());
+        });
+        try {
+            for await (const chunk of child.stdout) {
+                buffer += String(chunk);
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.trim()) {
+                        continue;
+                    }
+                    const parsed = JSON.parse(line);
+                    if (!parsed) {
+                        continue;
+                    }
+                    yield {
+                        ...parsed,
+                        provider: this.id,
+                    };
+                }
+            }
+            if (buffer.trim()) {
+                const parsed = JSON.parse(buffer);
+                if (parsed) {
+                    yield {
+                        ...parsed,
+                        provider: this.id,
+                    };
+                }
+            }
+        }
+        finally {
+            child.stdin.destroy();
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill();
+                if (process.platform !== "win32" && child.pid) {
+                    try {
+                        process.kill(-child.pid, "SIGKILL");
+                    }
+                    catch {
+                        // The process group may have already exited with the shell.
+                    }
+                }
+            }
+            await childClosed;
+        }
+    }
+}
+function createPayload(context) {
+    return {
+        fixture: context.fixture,
+        provider: {
+            config: context.config,
+            id: context.providerId,
+            manifestPath: context.manifestPath,
+        },
+    };
+}
+//# sourceMappingURL=script.js.map

package/dist/src/providers/builtin/script.js.map

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

package/dist/src/providers/builtin/slack.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderConfig } from "../../config/schema.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import type { ProviderAdapter } from "../types.js";
+export declare class SlackProviderAdapter extends LocalMockProviderAdapter implements ProviderAdapter {
+    constructor(id: string, config: ProviderConfig, _userName: string, _runtime?: unknown);
+}

package/dist/src/providers/builtin/slack.js

@@ -0,0 +1,106 @@
+import path from "node:path";
+import { CrablineError } from "../../core/errors.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import { genericMockPayloadWithNativeThread, isRecord, requireNativeInboundId, } from "./native-local-mock.js";
+const SLACK_CHANNEL_ID_RULE = {
+    example: "C1234567890",
+    name: "Slack conversation id",
+    pattern: /^[CDG][A-Z0-9]{2,}$/u,
+};
+const SLACK_TS_RULE = {
+    example: "1700000000.000100",
+    name: "Slack timestamp",
+    pattern: /^\d{10}\.\d{6}$/u,
+};
+function requireSlackChannelId(value, label) {
+    if (!SLACK_CHANNEL_ID_RULE.pattern.test(value)) {
+        throw new CrablineError(`Slack ${label} must be a native Slack conversation id such as C1234567890, G1234567890, or D1234567890.`, { kind: "config" });
+    }
+    return value;
+}
+function requireSlackThreadTs(value, label) {
+    if (!SLACK_TS_RULE.pattern.test(value)) {
+        throw new CrablineError(`Slack ${label} must be a Slack timestamp such as 1700000000.000100.`, {
+            kind: "config",
+        });
+    }
+    return value;
+}
+function slackAuthorFromEvent(event) {
+    if (typeof event.bot_id === "string" || event.subtype === "bot_message") {
+        return "assistant";
+    }
+    return "user";
+}
+function normalizeSlackEventsPayload(payload) {
+    if (!isRecord(payload)) {
+        throw new CrablineError("Slack webhook payload must be an object", { kind: "inbound" });
+    }
+    if (isRecord(payload.event)) {
+        const event = payload.event;
+        const channel = event.channel;
+        const text = event.text;
+        if (typeof channel !== "string" || typeof text !== "string") {
+            throw new CrablineError("Slack event payload requires event.channel and event.text", {
+                kind: "inbound",
+            });
+        }
+        const threadTs = event.thread_ts;
+        const ts = event.ts;
+        return {
+            author: slackAuthorFromEvent(event),
+            ...(typeof ts === "string"
+                ? { id: requireNativeInboundId(ts, SLACK_TS_RULE, "Slack event.ts") }
+                : {}),
+            raw: payload,
+            text,
+            threadId: typeof threadTs === "string"
+                ? requireNativeInboundId(threadTs, SLACK_TS_RULE, "Slack event.thread_ts")
+                : requireNativeInboundId(channel, SLACK_CHANNEL_ID_RULE, "Slack event.channel"),
+        };
+    }
+    return genericMockPayloadWithNativeThread({
+        channelRule: SLACK_CHANNEL_ID_RULE,
+        payload,
+        threadRule: SLACK_TS_RULE,
+    });
+}
+const SLACK_CODEC = {
+    normalize(target) {
+        const channelId = requireSlackChannelId(target.channelId ?? target.id, "channelId");
+        const normalized = {
+            channelId,
+            id: target.id,
+            metadata: target.metadata,
+        };
+        if (target.threadId) {
+            normalized.threadId = requireSlackThreadTs(target.threadId, "threadId");
+        }
+        return normalized;
+    },
+    resolveThreadId(target) {
+        const normalized = this.normalize(target);
+        return normalized.threadId ?? normalized.channelId ?? normalized.id;
+    },
+};
+export class SlackProviderAdapter extends LocalMockProviderAdapter {
+    constructor(id, config, _userName, _runtime) {
+        super({
+            codec: SLACK_CODEC,
+            config,
+            id,
+            options: {
+                defaultWebhook: { host: "127.0.0.1", path: "/slack/events", port: 8787 },
+                endpointLabel: "events endpoint",
+                normalizeWebhookPayload: normalizeSlackEventsPayload,
+                platform: "slack",
+                publicUrl: config.slack?.webhook.publicUrl,
+                recorderPath: config.slack?.recorder.path
+                    ? path.resolve(config.slack.recorder.path)
+                    : undefined,
+                webhook: config.slack?.webhook,
+            },
+        });
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/src/providers/builtin/slack.js.map

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

package/dist/src/providers/builtin/telegram.d.ts

@@ -0,0 +1,21 @@
+import type { ProviderConfig } from "../../config/schema.js";
+import { LocalMockProviderAdapter } from "../local-mock.js";
+import type { ProviderAdapter } from "../types.js";
+type TelegramEnvironment = Partial<Pick<NodeJS.ProcessEnv, "TELEGRAM_API_BASE_URL" | "TELEGRAM_BOT_USERNAME" | "TELEGRAM_WEBHOOK_SECRET_TOKEN">>;
+export declare function resolveTelegramAdapterConfig(config: ProviderConfig, env?: TelegramEnvironment): {
+    mode: "auto" | "polling" | "webhook";
+    apiUrl?: string;
+    secretToken?: string;
+    userName?: string;
+};
+export declare function normalizeTelegramWebhookPayload(payload: unknown): {
+    author?: "assistant" | "system" | "user" | undefined;
+    authorIsBot?: boolean;
+    id?: string | undefined;
+    raw: {};
+    text?: string | undefined;
+};
+export declare class TelegramProviderAdapter extends LocalMockProviderAdapter implements ProviderAdapter {
+    constructor(id: string, config: ProviderConfig, _userName: string);
+}
+export {};