@feeble/blay-openclaw-plugin 0.1.17

package/dist/channel/plugin.js

@@ -0,0 +1,291 @@
+/**
+ * Blay Channel Plugin — registers Blay as a native OpenClaw channel.
+ *
+ * This allows the agent to participate in Blay conversations using
+ * OpenClaw's native auto-reply pipeline. Inbound events arrive via
+ * a persistent SSE connection to the Blay API, and are dispatched
+ * through the same pipeline as Telegram/Discord/Slack messages.
+ * Agent responses are automatically delivered as Blay comments.
+ */
+import { DEFAULT_BASE_URL } from "../client.js";
+import { SSEClient } from "./sse-client.js";
+import { dispatchBlayEvent, isAbortTrigger, handleAbortTrigger } from "./inbound.js";
+const DEFAULT_ACCOUNT_ID = "default";
+// ── Module-level gateway config ──────────────────────────────────────
+let _gatewayPort = 18789;
+let _gatewayBind = "loopback";
+let _gatewayToken = null;
+export function getGatewayPort() { return _gatewayPort; }
+export function getGatewayBind() { return _gatewayBind; }
+export function getGatewayToken() { return _gatewayToken; }
+// ── Module-level SSE singleton ────────────────────────────────────────
+// Must be module-level (not closure-scoped) so that if OpenClaw's health
+// monitor creates a new gateway adapter instance on restart, we can still
+// stop the old SSE connection. Without this, old connections leak and
+// each receives + dispatches the same events → duplicate runs.
+let _sseClient = null;
+// ── Module-level event dedup ─────────────────────────────────────────
+// Shared across all SSE connections so events seen by a previous connection
+// are not re-dispatched by a new one after restart.
+const _seenEvents = new Map(); // dedupKey -> insertedAt
+const DEDUP_WINDOW_MS = 10 * 60 * 1000;
+// ── Channel Meta ──────────────────────────────────────────────────────
+const blayMeta = {
+    id: "blay-openclaw-plugin",
+    label: "Blay",
+    selectionLabel: "Blay",
+    docsPath: "/channels/blay",
+    blurb: "Project management and collaboration platform",
+};
+// ── Config Adapter ────────────────────────────────────────────────────
+function createConfigAdapter(pluginConfig) {
+    return {
+        listAccountIds: () => [DEFAULT_ACCOUNT_ID],
+        resolveAccount: () => ({
+            accountId: DEFAULT_ACCOUNT_ID,
+            enabled: true,
+            apiKey: pluginConfig.apiKey,
+            apiUrl: pluginConfig.apiUrl ?? DEFAULT_BASE_URL,
+        }),
+        defaultAccountId: () => DEFAULT_ACCOUNT_ID,
+        isEnabled: () => true,
+        isConfigured: () => Boolean(pluginConfig.apiKey),
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: Boolean(account.apiKey),
+        }),
+    };
+}
+// ── Outbound Adapter ──────────────────────────────────────────────────
+//
+// Delivers agent responses as Blay comments. OpenClaw's reply pipeline
+// calls sendText() after the agent produces a response.
+function createOutboundAdapter(client) {
+    const sendTextImpl = async (ctx) => {
+        // `ctx.to` contains the target as "entityType:entityId" or just a bare entity ID
+        const parts = ctx.to.split(":", 2);
+        const hasPrefixedType = parts.length === 2 && ["task", "project", "resource", "actionItem"].includes(parts[0]);
+        const entityType = hasPrefixedType ? parts[0] : "task";
+        const entityId = hasPrefixedType ? parts[1] : ctx.to.trim();
+        if (!entityId) {
+            throw new Error(`[blay] Invalid outbound target "${ctx.to}" — no entity ID found`);
+        }
+        // Build comment body
+        const body = { content: ctx.text };
+        // Set the entity target
+        if (entityType === "task")
+            body.taskId = entityId;
+        else if (entityType === "project")
+            body.projectId = entityId;
+        else if (entityType === "resource")
+            body.resourceId = entityId;
+        else if (entityType === "actionItem")
+            body.actionItemId = entityId;
+        else
+            body.taskId = entityId;
+        const res = await client.post("/api/v1/comments", body);
+        if (!res.ok) {
+            throw new Error(`[blay] Failed to post comment: HTTP ${res.status}`);
+        }
+        return {
+            channel: "blay-openclaw-plugin",
+            messageId: res.data?.id ?? `blay-${Date.now()}`,
+            chatId: entityId,
+        };
+    };
+    return {
+        deliveryMode: "direct",
+        textChunkLimit: 10000,
+        sendText: sendTextImpl,
+        sendMedia: async (ctx) => {
+            // Blay doesn't support media attachments — deliver as text if available
+            if (ctx.text) {
+                return sendTextImpl(ctx);
+            }
+            return {
+                channel: "blay-openclaw-plugin",
+                messageId: `blay-noop-${Date.now()}`,
+                chatId: ctx.to.split(":", 2)[1] ?? "",
+            };
+        },
+    };
+}
+function createGatewayAdapter(client, pluginConfig) {
+    return {
+        startAccount: async (ctx) => {
+            const log = ctx.log;
+            _gatewayPort = ctx.cfg.gateway?.port ?? 18789;
+            _gatewayBind = ctx.cfg.gateway?.bind ?? "loopback";
+            _gatewayToken = ctx.cfg.gateway?.auth?.token ?? null;
+            if (_gatewayBind !== "loopback") {
+                log?.warn(`Gateway bind is "${_gatewayBind}" (not loopback) — cron tool will use gatewayUrl override`);
+            }
+            // Stop any existing SSE client before creating a new one.
+            // Uses module-level _sseClient so this works even if OpenClaw creates
+            // a new gateway adapter instance on restart (fresh closure).
+            if (_sseClient) {
+                log?.info("Stopping existing SSE client before restart");
+                _sseClient.stop();
+                _sseClient = null;
+            }
+            // 1. Resolve agent identity and whitelist
+            try {
+                const meRes = await client.get("/api/v1/me");
+                if (meRes.ok && meRes.data.userId) {
+                    _agentUserId = meRes.data.userId;
+                    _agentAllowedUserIds = meRes.data.agentAllowedUserIds ?? null;
+                    log?.info(`Agent identity: "${meRes.data.name}" (${meRes.data.userId})`);
+                    if (_agentAllowedUserIds && _agentAllowedUserIds.length > 0) {
+                        log?.info(`User whitelist active: ${_agentAllowedUserIds.length} user(s)`);
+                    }
+                }
+            }
+            catch {
+                log?.warn("Could not resolve agent identity — mention detection disabled");
+            }
+            // 2. Open SSE connection to the Blay event stream
+            const apiUrl = (pluginConfig.apiUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+            const sseStartedAt = Date.now();
+            const sseUrl = `${apiUrl}/api/v1/events/stream?since=${sseStartedAt}`;
+            _sseClient = new SSEClient({
+                url: sseUrl,
+                headers: {
+                    Authorization: `Bearer ${pluginConfig.apiKey}`,
+                },
+                onEvent: (sseEvent) => {
+                    // Log all SSE events for diagnostics
+                    if (sseEvent.event === "heartbeat") {
+                        return; // Heartbeats are too noisy
+                    }
+                    if (sseEvent.event === "connected") {
+                        console.log(`[blay] SSE received: connected`);
+                        return;
+                    }
+                    console.log(`[blay] SSE received event: type=${sseEvent.event} dataLen=${sseEvent.data?.length ?? 0}`);
+                    // Parse the event data and enqueue for sequential dispatch
+                    try {
+                        const payload = JSON.parse(sseEvent.data);
+                        console.log(`[blay] SSE parsed: event=${payload.event} actor=${payload.actor?.name ?? "?"} target=${payload.target?.type}:${payload.target?.id ?? "?"} ts=${payload.timestamp}`);
+                        // Reject events older than this SSE connection (defense-in-depth
+                        // against replay after restarts — the server filters via `since`
+                        // but dedup map is cleared on restart so stale events could slip through)
+                        if (payload.timestamp && payload.timestamp < sseStartedAt) {
+                            console.log(`[blay] SSE filtered: event too old (${payload.timestamp} < ${sseStartedAt})`);
+                            return;
+                        }
+                        // Deduplicate using composite key (module-level map shared across
+                        // all SSE connections, survives restarts)
+                        const dedupKey = `${payload.event}:${payload.target?.id ?? ""}:${payload.timestamp}`;
+                        if (_seenEvents.has(dedupKey)) {
+                            console.log(`[blay] SSE filtered: duplicate key ${dedupKey}`);
+                            return;
+                        }
+                        _seenEvents.set(dedupKey, Date.now());
+                        // Evict old entries to bound memory
+                        const cutoff = Date.now() - DEDUP_WINDOW_MS;
+                        for (const [key, insertedAt] of _seenEvents) {
+                            if (insertedAt < cutoff)
+                                _seenEvents.delete(key);
+                        }
+                        // Intercept abort triggers BEFORE dispatching through OpenClaw.
+                        // Handle abort entirely at the plugin level — never enters the command lane.
+                        if (payload.event === "comment_created" && isAbortTrigger(payload.data?.content)) {
+                            console.log(`[blay] SSE abort trigger: "${payload.data?.content}" — handling directly`);
+                            handleAbortTrigger(payload).catch(err => console.error("[blay] abort handler error:", err));
+                            return;
+                        }
+                        console.log(`[blay] SSE dispatching: ${payload.event} from ${payload.actor?.name ?? "unknown"}`);
+                        dispatchBlayEvent(payload).catch(err => console.error("[blay] event dispatch error:", err));
+                    }
+                    catch (err) {
+                        console.error("[blay] Failed to parse SSE event:", err);
+                    }
+                },
+                onConnected: () => {
+                    log?.info("SSE event stream connected");
+                },
+                onDisconnected: () => {
+                    log?.warn("SSE event stream disconnected — reconnecting...");
+                },
+                onError: (err) => {
+                    log?.warn(`SSE error: ${err.message}`);
+                },
+                reconnectDelay: 2000,
+                maxReconnectDelay: 30000,
+            });
+            _sseClient.start();
+            log?.info("Blay channel started (SSE mode)");
+            // Block until OpenClaw signals shutdown via abort.
+            // OpenClaw expects startAccount to return a long-lived Promise that
+            // resolves only when the channel stops. Returning early causes the
+            // health monitor to think the channel crashed → restart loop.
+            if (!ctx.abortSignal.aborted) {
+                await new Promise((resolve) => {
+                    ctx.abortSignal.addEventListener("abort", () => resolve(), { once: true });
+                });
+            }
+            // Cleanup when abort fires
+            if (_sseClient) {
+                _sseClient.stop();
+                _sseClient = null;
+            }
+            log?.info("Blay channel stopped");
+        },
+        stopAccount: async () => {
+            if (_sseClient) {
+                _sseClient.stop();
+                _sseClient = null;
+            }
+        },
+    };
+}
+// ── Agent Identity & Whitelist (set during gateway start) ─────────────
+let _agentUserId = null;
+let _agentAllowedUserIds = null;
+export function getAgentUserId() {
+    return _agentUserId;
+}
+export function getAgentAllowedUserIds() {
+    return _agentAllowedUserIds;
+}
+// ── Plugin Factory ────────────────────────────────────────────────────
+export function createBlayChannelPlugin(client, pluginConfig) {
+    return {
+        id: "blay-openclaw-plugin",
+        meta: blayMeta,
+        capabilities: {
+            chatTypes: ["group"],
+            media: false,
+            polls: false,
+            reactions: false,
+            threads: false,
+            nativeCommands: false,
+        },
+        defaults: {
+            queue: {
+                debounceMs: 8000, // Wait for conversation to settle before agent responds
+            },
+        },
+        config: createConfigAdapter(pluginConfig),
+        outbound: createOutboundAdapter(client),
+        gateway: createGatewayAdapter(client, pluginConfig),
+        messaging: {
+            targetResolver: {
+                hint: "Use entityType:entityId format (e.g. task:abc123, project:xyz) or just the entity ID",
+                looksLikeId: (raw) => {
+                    // Accept any non-empty value — Blay targets are always entity IDs
+                    // (prefixed like "task:abc123" or bare IDs). No directory lookup needed.
+                    return raw.trim().length > 0;
+                },
+            },
+            normalizeTarget: (raw) => raw.trim(),
+            formatTargetDisplay: (params) => {
+                if (params.display)
+                    return params.display;
+                return params.target;
+            },
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/channel/plugin.js.map

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

package/dist/channel/run-tracker.d.ts

@@ -0,0 +1,54 @@
+/**
+ * RunTracker — manages agent run lifecycle and telemetry collection.
+ *
+ * Creates a run record at the start of event dispatch, accumulates tool calls
+ * and comment IDs during execution, then sends a final PATCH on completion.
+ *
+ * All API calls are fire-and-forget (try/catch guarded) — a logging failure
+ * must never break agent execution.
+ *
+ * Module-level current-run singleton is safe because OpenClaw processes
+ * SSE events sequentially per agent.
+ */
+import type { BlayClient } from "../client.js";
+export interface ToolCallRecord {
+    name: string;
+    params?: unknown;
+    result?: string;
+    status: "success" | "error";
+    error?: string;
+    startedAt: number;
+    completedAt: number;
+    durationMs: number;
+}
+export declare class RunTracker {
+    private client;
+    private runId;
+    private toolCalls;
+    private commentIds;
+    private startTime;
+    private triggerEvent;
+    private triggerActorId?;
+    private triggerActorName?;
+    private entityType?;
+    private entityId?;
+    constructor(client: BlayClient, opts: {
+        triggerEvent: string;
+        triggerActorId?: string;
+        triggerActorName?: string;
+        entityType?: string;
+        entityId?: string;
+    });
+    /** POST to create the run record. */
+    start(): Promise<void>;
+    /** Push a tool call record (accumulated in memory). */
+    recordToolCall(record: ToolCallRecord): void;
+    /** Push a comment ID (accumulated in memory). */
+    recordComment(commentId: string): void;
+    /** PATCH with status "completed" and all accumulated data. */
+    complete(): Promise<void>;
+    /** PATCH with status "failed" and error message. */
+    fail(error: unknown): Promise<void>;
+}
+export declare function setCurrentRunTracker(tracker: RunTracker | null): void;
+export declare function getCurrentRunTracker(): RunTracker | null;

package/dist/channel/run-tracker.js

@@ -0,0 +1,137 @@
+/**
+ * RunTracker — manages agent run lifecycle and telemetry collection.
+ *
+ * Creates a run record at the start of event dispatch, accumulates tool calls
+ * and comment IDs during execution, then sends a final PATCH on completion.
+ *
+ * All API calls are fire-and-forget (try/catch guarded) — a logging failure
+ * must never break agent execution.
+ *
+ * Module-level current-run singleton is safe because OpenClaw processes
+ * SSE events sequentially per agent.
+ */
+import { getUsageCollector } from "../telemetry/usage-collector.js";
+import { getTelemetryPusher } from "../telemetry/pusher.js";
+export class RunTracker {
+    client;
+    runId = null;
+    toolCalls = [];
+    commentIds = [];
+    startTime;
+    triggerEvent;
+    triggerActorId;
+    triggerActorName;
+    entityType;
+    entityId;
+    constructor(client, opts) {
+        this.client = client;
+        this.startTime = Date.now();
+        this.triggerEvent = opts.triggerEvent;
+        this.triggerActorId = opts.triggerActorId;
+        this.triggerActorName = opts.triggerActorName;
+        this.entityType = opts.entityType;
+        this.entityId = opts.entityId;
+    }
+    /** POST to create the run record. */
+    async start() {
+        try {
+            const res = await this.client.post("/api/v1/agent-runs", {
+                triggerEvent: this.triggerEvent,
+                triggerActorId: this.triggerActorId,
+                triggerActorName: this.triggerActorName,
+                entityType: this.entityType,
+                entityId: this.entityId,
+            });
+            if (res.ok && res.data?.id) {
+                this.runId = res.data.id;
+            }
+            else {
+                console.error("[blay] Failed to create agent run:", res.status);
+            }
+        }
+        catch (err) {
+            console.error("[blay] Failed to create agent run:", err);
+        }
+    }
+    /** Push a tool call record (accumulated in memory). */
+    recordToolCall(record) {
+        this.toolCalls.push(record);
+    }
+    /** Push a comment ID (accumulated in memory). */
+    recordComment(commentId) {
+        this.commentIds.push(commentId);
+    }
+    /** PATCH with status "completed" and all accumulated data. */
+    async complete() {
+        if (!this.runId)
+            return;
+        const now = Date.now();
+        try {
+            // Collect token usage from the UsageCollector
+            const usage = getUsageCollector()?.getAndResetUsage();
+            const tokenFields = usage && usage.totalTokens > 0
+                ? {
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    totalTokens: usage.totalTokens,
+                    estimatedCostUsd: usage.estimatedCost,
+                }
+                : {};
+            await this.client.patch(`/api/v1/agent-runs/${this.runId}`, {
+                status: "completed",
+                toolCalls: this.toolCalls,
+                commentIds: this.commentIds.length > 0 ? this.commentIds : undefined,
+                completedAt: now,
+                durationMs: now - this.startTime,
+                ...tokenFields,
+            });
+            // Notify TelemetryPusher
+            getTelemetryPusher()?.recordRunCompleted();
+        }
+        catch (err) {
+            console.error("[blay] Failed to complete agent run:", err);
+        }
+    }
+    /** PATCH with status "failed" and error message. */
+    async fail(error) {
+        if (!this.runId)
+            return;
+        const now = Date.now();
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        try {
+            // Collect token usage even on failure
+            const usage = getUsageCollector()?.getAndResetUsage();
+            const tokenFields = usage && usage.totalTokens > 0
+                ? {
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    totalTokens: usage.totalTokens,
+                    estimatedCostUsd: usage.estimatedCost,
+                }
+                : {};
+            await this.client.patch(`/api/v1/agent-runs/${this.runId}`, {
+                status: "failed",
+                toolCalls: this.toolCalls,
+                commentIds: this.commentIds.length > 0 ? this.commentIds : undefined,
+                errorMessage,
+                completedAt: now,
+                durationMs: now - this.startTime,
+                ...tokenFields,
+            });
+            // Notify TelemetryPusher
+            getTelemetryPusher()?.recordRunFailed();
+        }
+        catch (err) {
+            console.error("[blay] Failed to record agent run failure:", err);
+        }
+    }
+}
+// ── Module-level current-run singleton ──────────────────────────────────
+let _currentTracker = null;
+export function setCurrentRunTracker(tracker) {
+    _currentTracker = tracker;
+}
+export function getCurrentRunTracker() {
+    return _currentTracker;
+}
+//# sourceMappingURL=run-tracker.js.map

package/dist/channel/run-tracker.js.map

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

package/dist/channel/runtime.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Channel Runtime — stores the PluginRuntime reference for use by channel adapters.
+ *
+ * Follows the same pattern as the Telegram channel extension.
+ */
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+export declare function setBlayRuntime(runtime: PluginRuntime): void;
+export declare function getBlayRuntime(): PluginRuntime;

package/dist/channel/runtime.js

@@ -0,0 +1,16 @@
+/**
+ * Channel Runtime — stores the PluginRuntime reference for use by channel adapters.
+ *
+ * Follows the same pattern as the Telegram channel extension.
+ */
+let _runtime = null;
+export function setBlayRuntime(runtime) {
+    _runtime = runtime;
+}
+export function getBlayRuntime() {
+    if (!_runtime) {
+        throw new Error("[blay] PluginRuntime not initialized — setBlayRuntime() must be called first");
+    }
+    return _runtime;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/channel/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/channel/runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/channel/sse-client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Minimal SSE Client for Node.js
+ *
+ * Connects to a Server-Sent Events endpoint using fetch streams.
+ * Handles reconnection with exponential backoff.
+ * No external dependencies — uses Node.js built-in fetch.
+ */
+export interface SSEEvent {
+    event: string;
+    data: string;
+    id?: string;
+}
+export interface SSEClientOptions {
+    url: string;
+    headers?: Record<string, string>;
+    onEvent: (event: SSEEvent) => void;
+    onError?: (error: Error) => void;
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    /** Initial reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Max reconnect delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+}
+export declare class SSEClient {
+    private abortController;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private currentDelay;
+    private running;
+    private options;
+    private lastEventId;
+    /**
+     * Generation counter — incremented on every stop(). Prevents stale
+     * reconnection chains from forking when stop() + start() is called
+     * while a reconnection sleep is in progress.
+     */
+    private generation;
+    constructor(options: SSEClientOptions);
+    /**
+     * Start the SSE connection. Reconnects automatically on failure.
+     */
+    start(): void;
+    /**
+     * Stop the SSE connection permanently.
+     */
+    stop(): void;
+    private connectWithGen;
+    /**
+     * Parse SSE events from a text buffer.
+     * Returns parsed events and the remaining unparsed text.
+     */
+    private parseEvents;
+}