@openclaw/crabline 0.0.0

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

@@ -0,0 +1,243 @@
+import path from "node:path";
+import { CrablineError, ensureErrorMessage } from "../core/errors.js";
+import { appendRecordedInbound, waitForRecordedInbound, watchRecordedInbound } from "./recorder.js";
+import { startWebhookServer } from "./webhook-server.js";
+export function createGenericLocalMockTargetCodec(platform) {
+    const prefix = `${platform}:`;
+    const encode = (value) => (value.startsWith(prefix) ? value : `${prefix}${value}`);
+    return {
+        normalize(target) {
+            const normalized = {
+                id: target.id,
+                metadata: target.metadata,
+            };
+            if (target.channelId) {
+                normalized.channelId = encode(target.channelId);
+            }
+            else if (!target.threadId) {
+                normalized.channelId = encode(target.id);
+            }
+            if (target.threadId) {
+                normalized.channelId ??= encode(target.id);
+                normalized.threadId = target.threadId.startsWith(prefix)
+                    ? target.threadId
+                    : `${normalized.channelId}:${target.threadId}`;
+            }
+            return normalized;
+        },
+        resolveThreadId(target) {
+            const normalized = this.normalize(target);
+            return normalized.threadId ?? normalized.channelId ?? encode(normalized.id);
+        },
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isAddressInChannel(threadId, channelId) {
+    if (!channelId) {
+        return true;
+    }
+    return threadId === channelId || threadId.startsWith(`${channelId}:`);
+}
+function createMessageId(platform) {
+    return `${platform}-mock-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function toRecorderPath(providerId, configuredPath) {
+    return configuredPath
+        ? path.resolve(configuredPath)
+        : path.resolve(".crabline", "recorders", `${providerId}.jsonl`);
+}
+function authorFromPayload(payload) {
+    const explicit = payload.message?.author ?? payload.author;
+    if (explicit) {
+        return explicit;
+    }
+    return (payload.message?.authorIsBot ?? payload.authorIsBot ?? true) ? "assistant" : "user";
+}
+function normalizeWebhookPayload(payload) {
+    if (!payload || typeof payload !== "object") {
+        throw new CrablineError("mock webhook payload must be an object", { kind: "inbound" });
+    }
+    return payload;
+}
+function mockReplyText(params) {
+    return `[${params.platform} mock] ${params.text}`;
+}
+export class LocalMockProviderAdapter {
+    id;
+    platform;
+    status = "ready";
+    supports = ["probe", "send", "roundtrip", "agent"];
+    #codec;
+    #config;
+    #options;
+    #recorderPath;
+    #server = null;
+    constructor(params) {
+        this.id = params.id;
+        this.platform = params.options.platform;
+        this.#codec = params.codec;
+        this.#config = params.config;
+        this.#options = params.options;
+        this.#recorderPath = toRecorderPath(params.id, params.options.recorderPath);
+    }
+    normalizeTarget(target) {
+        return this.#codec.normalize(target);
+    }
+    async probe(context) {
+        const server = await this.#ensureWebhookServer(true);
+        const target = this.normalizeTarget(context.fixture.target);
+        const details = [
+            `${this.platform} local mock ready`,
+            `recorder path ${this.#recorderPath}`,
+            `${this.#options.endpointLabel} ${server.endpointUrl}`,
+        ];
+        if (this.#options.publicUrl) {
+            details.push(`public webhook ${this.#options.publicUrl}`);
+        }
+        if (target.threadId) {
+            details.push(`thread reachable ${target.threadId}`);
+        }
+        else if (target.channelId) {
+            details.push(`channel reachable ${target.channelId}`);
+        }
+        else {
+            details.push(`dm reachable ${this.#codec.resolveThreadId(context.fixture.target)}`);
+        }
+        return { details, healthy: true };
+    }
+    async send(context) {
+        const threadId = this.#codec.resolveThreadId(context.fixture.target);
+        const messageId = createMessageId(this.platform);
+        await appendRecordedInbound(this.#recorderPath, {
+            author: "user",
+            id: messageId,
+            provider: this.id,
+            raw: {
+                direction: "outbound",
+                mode: context.mode,
+                platform: this.platform,
+            },
+            sentAt: new Date().toISOString(),
+            text: context.text,
+            threadId,
+        });
+        if (context.mode !== "send" && context.fixture.target.behavior !== "sink") {
+            await sleep(this.#config.loopback?.delayMs ?? 25);
+            await appendRecordedInbound(this.#recorderPath, {
+                author: "assistant",
+                id: `${messageId}-reply`,
+                provider: this.id,
+                raw: {
+                    direction: "mock-reply",
+                    mode: context.mode,
+                    platform: this.platform,
+                },
+                sentAt: new Date().toISOString(),
+                text: mockReplyText({ platform: this.platform, text: context.text }),
+                threadId,
+            });
+        }
+        return {
+            accepted: true,
+            messageId,
+            threadId,
+        };
+    }
+    async waitForInbound(context) {
+        await this.#ensureWebhookServer(true);
+        const target = this.normalizeTarget(context.fixture.target);
+        const expectedAuthor = context.fixture.inboundMatch.author;
+        return await waitForRecordedInbound({
+            filePath: this.#recorderPath,
+            matches: (event) => event.provider === this.id &&
+                (expectedAuthor === "any" || event.author === expectedAuthor) &&
+                isAddressInChannel(event.threadId, context.threadId ?? target.threadId ?? target.channelId),
+            since: context.since,
+            timeoutMs: context.timeoutMs,
+        });
+    }
+    async *watch(context) {
+        await this.#ensureWebhookServer(false);
+        const target = this.normalizeTarget(context.fixture.target);
+        for await (const event of watchRecordedInbound({
+            filePath: this.#recorderPath,
+            matches: (entry) => entry.provider === this.id &&
+                isAddressInChannel(entry.threadId, target.threadId ?? target.channelId),
+            since: context.since,
+        })) {
+            yield event;
+        }
+    }
+    async cleanup() {
+        if (!this.#server) {
+            return;
+        }
+        await this.#server.close();
+        this.#server = null;
+    }
+    async #handleWebhook(request) {
+        if (!request.headers.get("content-type")?.includes("application/json")) {
+            return new Response("expected application/json", { status: 415 });
+        }
+        let payload;
+        try {
+            const rawPayload = await request.json();
+            payload = normalizeWebhookPayload(this.#options.normalizeWebhookPayload
+                ? this.#options.normalizeWebhookPayload(rawPayload)
+                : rawPayload);
+        }
+        catch (error) {
+            return new Response(ensureErrorMessage(error), { status: 400 });
+        }
+        const id = payload.message?.id ?? payload.id ?? createMessageId(this.platform);
+        const threadId = payload.message?.threadId ?? payload.threadId;
+        const text = payload.message?.text ?? payload.text;
+        if (!threadId || !text) {
+            return new Response("payload requires message.threadId and message.text", { status: 400 });
+        }
+        await appendRecordedInbound(this.#recorderPath, {
+            author: authorFromPayload(payload),
+            id,
+            provider: this.id,
+            raw: payload.message?.raw ?? payload.raw ?? payload,
+            sentAt: new Date().toISOString(),
+            text,
+            threadId,
+        });
+        return new Response(JSON.stringify({ ok: true, id }), {
+            headers: { "content-type": "application/json" },
+            status: 200,
+        });
+    }
+    async #ensureWebhookServer(allowExisting) {
+        if (this.#server) {
+            return this.#server;
+        }
+        const webhook = this.#options.webhook;
+        const host = webhook?.host ?? this.#options.defaultWebhook.host;
+        const port = webhook?.port ?? this.#options.defaultWebhook.port;
+        const webhookPath = webhook?.path ?? this.#options.defaultWebhook.path;
+        try {
+            this.#server = await startWebhookServer({
+                handle: (request) => this.#handleWebhook(request),
+                host,
+                path: webhookPath,
+                port,
+            });
+            return this.#server;
+        }
+        catch (error) {
+            const code = error.code;
+            if (allowExisting && code === "EADDRINUSE") {
+                return {
+                    async close() { },
+                    endpointUrl: `http://${host}:${port}${webhookPath}`,
+                };
+            }
+            throw new CrablineError(`${this.platform} local mock webhook server failed: ${ensureErrorMessage(error)}`, { cause: error, kind: "connectivity" });
+        }
+    }
+}
+//# sourceMappingURL=local-mock.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { InboundEnvelope } from "./types.js";
+export type RecordedInboundEnvelope = InboundEnvelope & {
+    recordedAt: string;
+};
+export declare function appendRecordedInbound(filePath: string, event: InboundEnvelope): Promise<RecordedInboundEnvelope>;
+export declare function readRecordedInbound(filePath: string): Promise<RecordedInboundEnvelope[]>;
+export declare function waitForRecordedInbound(params: {
+    filePath: string;
+    matches: (event: RecordedInboundEnvelope) => boolean;
+    pollMs?: number;
+    since?: string | undefined;
+    timeoutMs: number;
+}): Promise<RecordedInboundEnvelope | null>;
+export declare function watchRecordedInbound(params: {
+    filePath: string;
+    matches: (event: RecordedInboundEnvelope) => boolean;
+    pollMs?: number;
+    since?: string | undefined;
+}): AsyncIterable<RecordedInboundEnvelope>;

package/dist/src/providers/recorder.js

@@ -0,0 +1,160 @@
+import { appendFile, mkdir, open, readFile } from "node:fs/promises";
+import path from "node:path";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function toRecordKey(event) {
+    return `${event.provider}:${event.threadId}:${event.id}`;
+}
+const MAX_WATCH_SEEN_KEYS = 4096;
+async function readRecordedInboundAppend(filePath, state) {
+    let handle;
+    try {
+        handle = await open(filePath, "r");
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            state.offset = 0;
+            state.pending = Buffer.alloc(0);
+            return [];
+        }
+        throw error;
+    }
+    try {
+        const size = (await handle.stat()).size;
+        if (size < state.offset) {
+            state.offset = 0;
+            state.pending = Buffer.alloc(0);
+        }
+        const chunks = [];
+        let position = state.offset;
+        while (position < size) {
+            const chunk = Buffer.alloc(Math.min(64 * 1024, size - position));
+            const { bytesRead } = await handle.read(chunk, 0, chunk.length, position);
+            if (bytesRead === 0) {
+                break;
+            }
+            chunks.push(chunk.subarray(0, bytesRead));
+            position += bytesRead;
+        }
+        state.offset = position;
+        const raw = Buffer.concat([state.pending, ...chunks]);
+        const lastNewline = raw.lastIndexOf(0x0a);
+        if (lastNewline < 0) {
+            state.pending = raw;
+            return [];
+        }
+        state.pending = raw.subarray(lastNewline + 1);
+        const lines = raw
+            .subarray(0, lastNewline)
+            .toString("utf8")
+            .split("\n")
+            .filter((line) => line.trim().length > 0);
+        const events = [];
+        for (const [index, line] of lines.entries()) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch (error) {
+                if (index === lines.length - 1 && state.pending.length === 0) {
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return events;
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function appendRecordedInbound(filePath, event) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    const recorded = {
+        ...event,
+        recordedAt: new Date().toISOString(),
+    };
+    await appendFile(filePath, `${JSON.stringify(recorded)}\n`, "utf8");
+    return recorded;
+}
+export async function readRecordedInbound(filePath) {
+    let raw = "";
+    try {
+        raw = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    const lines = raw.split("\n").filter((line) => line.trim().length > 0);
+    const events = [];
+    for (const [index, line] of lines.entries()) {
+        try {
+            events.push(JSON.parse(line));
+        }
+        catch (error) {
+            if (index === lines.length - 1) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    return events;
+}
+export async function waitForRecordedInbound(params) {
+    const deadline = Date.now() + params.timeoutMs;
+    const seen = new Set();
+    while (Date.now() <= deadline) {
+        const events = await readRecordedInbound(params.filePath);
+        for (const event of events) {
+            const key = toRecordKey(event);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            if (params.since && new Date(event.sentAt).getTime() < new Date(params.since).getTime()) {
+                continue;
+            }
+            if (params.matches(event)) {
+                return event;
+            }
+        }
+        await sleep(params.pollMs ?? 200);
+    }
+    return null;
+}
+export async function* watchRecordedInbound(params) {
+    const state = {
+        offset: 0,
+        pending: Buffer.alloc(0),
+    };
+    const seen = new Set();
+    while (true) {
+        const events = await readRecordedInboundAppend(params.filePath, state);
+        for (const event of events) {
+            const key = toRecordKey(event);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            if (seen.size > MAX_WATCH_SEEN_KEYS) {
+                const oldest = seen.values().next().value;
+                if (oldest !== undefined) {
+                    seen.delete(oldest);
+                }
+            }
+            if (params.since && new Date(event.sentAt).getTime() < new Date(params.since).getTime()) {
+                continue;
+            }
+            if (params.matches(event)) {
+                yield event;
+            }
+        }
+        await sleep(params.pollMs ?? 250);
+    }
+}
+//# sourceMappingURL=recorder.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { ManifestDefinition } from "../config/schema.js";
+import { OPENCLAW_SUPPORT_CATALOG } from "./catalog.js";
+import type { ProviderAdapter } from "./types.js";
+export type Registry = {
+    catalog: typeof OPENCLAW_SUPPORT_CATALOG;
+    resolve(providerId: string, fixtureId: string): ProviderAdapter;
+};
+export declare function createRegistry(manifest: ManifestDefinition, manifestPath: string): Registry;

package/dist/src/providers/registry.js

@@ -0,0 +1,171 @@
+import { CrablineError } from "../core/errors.js";
+import { ScriptProviderAdapter } from "./builtin/script.js";
+import { OPENCLAW_SUPPORT_CATALOG } from "./catalog.js";
+const COMMON_PROVIDER_SUPPORT = [
+    "probe",
+    "send",
+    "roundtrip",
+    "agent",
+];
+const LAZY_PROVIDER_FACTORIES = {
+    async discord({ config, providerId, userName }) {
+        const { DiscordProviderAdapter } = await import("./builtin/discord.js");
+        return new DiscordProviderAdapter(providerId, config, userName);
+    },
+    async feishu({ config, providerId, userName }) {
+        const { FeishuProviderAdapter } = await import("./builtin/feishu.js");
+        return new FeishuProviderAdapter(providerId, config, userName);
+    },
+    async googlechat({ config, providerId, userName }) {
+        const { GoogleChatProviderAdapter } = await import("./builtin/googlechat.js");
+        return new GoogleChatProviderAdapter(providerId, config, userName);
+    },
+    async imessage({ config, providerId, userName }) {
+        const { IMessageProviderAdapter } = await import("./builtin/imessage.js");
+        return new IMessageProviderAdapter(providerId, config, userName);
+    },
+    async loopback({ config, providerId, userName }) {
+        const { LoopbackProviderAdapter } = await import("./builtin/loopback.js");
+        return new LoopbackProviderAdapter(providerId, config, userName);
+    },
+    async matrix({ config, providerId, userName }) {
+        const { MatrixProviderAdapter } = await import("./builtin/matrix.js");
+        return new MatrixProviderAdapter(providerId, config, userName);
+    },
+    async mattermost({ config, providerId, userName }) {
+        const { MattermostProviderAdapter } = await import("./builtin/mattermost.js");
+        return new MattermostProviderAdapter(providerId, config, userName);
+    },
+    async msteams({ config, providerId, userName }) {
+        const { MsTeamsProviderAdapter } = await import("./builtin/msteams.js");
+        return new MsTeamsProviderAdapter(providerId, config, userName);
+    },
+    async slack({ config, providerId, userName }) {
+        const { SlackProviderAdapter } = await import("./builtin/slack.js");
+        return new SlackProviderAdapter(providerId, config, userName);
+    },
+    async telegram({ config, providerId, userName }) {
+        const { TelegramProviderAdapter } = await import("./builtin/telegram.js");
+        return new TelegramProviderAdapter(providerId, config, userName);
+    },
+    async whatsapp({ config, providerId, userName }) {
+        const { WhatsAppProviderAdapter } = await import("./builtin/whatsapp.js");
+        return new WhatsAppProviderAdapter(providerId, config, userName);
+    },
+    async zalo({ config, providerId, userName }) {
+        const { ZaloProviderAdapter } = await import("./builtin/zalo.js");
+        return new ZaloProviderAdapter(providerId, config, userName);
+    },
+};
+function isLazyAdapter(adapter) {
+    return adapter in LAZY_PROVIDER_FACTORIES;
+}
+function 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;
+}
+function createLazyProvider(params) {
+    return new LazyProviderAdapter({
+        adapterName: params.adapter,
+        factory: () => LAZY_PROVIDER_FACTORIES[params.adapter](params),
+        id: params.providerId,
+        platform: params.config.platform,
+        status: "ready",
+        supports: COMMON_PROVIDER_SUPPORT,
+    });
+}
+class LazyProviderAdapter {
+    id;
+    platform;
+    status;
+    supports;
+    #adapterName;
+    #factory;
+    #providerPromise = null;
+    constructor(params) {
+        this.#adapterName = params.adapterName;
+        this.#factory = params.factory;
+        this.id = params.id;
+        this.platform = params.platform;
+        this.status = params.status;
+        this.supports = params.supports;
+    }
+    normalizeTarget(target) {
+        return normalizeTarget(target);
+    }
+    async probe(context) {
+        return await (await this.#provider()).probe(context);
+    }
+    async send(context) {
+        return await (await this.#provider()).send(context);
+    }
+    async waitForInbound(context) {
+        return await (await this.#provider()).waitForInbound(context);
+    }
+    watch(context) {
+        return this.#watch(context);
+    }
+    async cleanup() {
+        if (!this.#providerPromise) {
+            return;
+        }
+        await (await this.#providerPromise).cleanup?.();
+    }
+    async #provider() {
+        this.#providerPromise ??= this.#factory().catch((error) => {
+            this.#providerPromise = null;
+            throw new CrablineError(`Provider adapter "${this.#adapterName}" could not load. Install its optional peer dependencies before using this adapter.`, { cause: error, kind: "config" });
+        });
+        return await this.#providerPromise;
+    }
+    async *#watch(context) {
+        const provider = await this.#provider();
+        if (!provider.watch) {
+            throw new CrablineError(`Provider "${this.id}" does not implement watch.`, {
+                kind: "config",
+            });
+        }
+        yield* provider.watch(context);
+    }
+}
+export function createRegistry(manifest, manifestPath) {
+    return {
+        catalog: OPENCLAW_SUPPORT_CATALOG,
+        resolve(providerId, fixtureId) {
+            const fixture = manifest.fixtures.find((entry) => entry.id === fixtureId);
+            if (!fixture) {
+                throw new CrablineError(`Unknown fixture: ${fixtureId}`, { kind: "config" });
+            }
+            const config = manifest.providers[providerId];
+            if (!config) {
+                throw new CrablineError(`Unknown provider: ${providerId}`, { kind: "config" });
+            }
+            if (config.status === "disabled") {
+                throw new CrablineError(`Provider "${providerId}" is disabled.`, { kind: "config" });
+            }
+            const context = {
+                config,
+                fixture,
+                manifestPath,
+                providerId,
+                userName: manifest.userName,
+            };
+            if (isLazyAdapter(config.adapter)) {
+                return createLazyProvider({
+                    adapter: config.adapter,
+                    config,
+                    providerId,
+                    userName: manifest.userName,
+                });
+            }
+            return new ScriptProviderAdapter(context);
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

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

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