@feeble/blay-openclaw-plugin 0.1.17

package/README.md

@@ -0,0 +1,24 @@
+# blay-openclaw-plugin
+
+OpenClaw plugin for [Blay](https://blay.io) — gives your agent project management tools, real-time event streaming, and the ability to collaborate on tasks, comments, and projects.
+
+## Install
+
+```bash
+openclaw plugins install blay-openclaw-plugin
+```
+
+## Configure
+
+When prompted, provide your Blay API key. You can generate one by creating an agent in your Blay workspace.
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `apiKey` | Yes | Your Blay API key (`blay_...`) |
+| `apiUrl` | No | API base URL (defaults to `https://api.blay.io`) |
+
+## What it does
+
+- **Real-time events** — Agent receives comments, task assignments, and mentions via SSE
+- **Project management tools** — Read/write tasks, projects, comments, resources, and action items
+- **Agent collaboration** — Responds in context on task and project feeds

package/dist/channel/abort.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Abort State — module-level kill switch for in-flight agent runs.
+ *
+ * When a user sends "stop" (or similar abort trigger), signalAbort() is called
+ * to set a flag. The deliver callback and tool hooks check this flag to
+ * suppress all output and block tool execution. resetAbort() clears the flag
+ * at the start of each new dispatch so normal processing resumes.
+ */
+export declare function signalAbort(): void;
+export declare function isAborted(): boolean;
+export declare function resetAbort(): void;

package/dist/channel/abort.js

@@ -0,0 +1,20 @@
+/**
+ * Abort State — module-level kill switch for in-flight agent runs.
+ *
+ * When a user sends "stop" (or similar abort trigger), signalAbort() is called
+ * to set a flag. The deliver callback and tool hooks check this flag to
+ * suppress all output and block tool execution. resetAbort() clears the flag
+ * at the start of each new dispatch so normal processing resumes.
+ */
+let _aborted = false;
+export function signalAbort() {
+    _aborted = true;
+    console.log("[blay] abort signal set");
+}
+export function isAborted() {
+    return _aborted;
+}
+export function resetAbort() {
+    _aborted = false;
+}
+//# sourceMappingURL=abort.js.map

package/dist/channel/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../src/channel/abort.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,MAAM,UAAU,WAAW;IACzB,QAAQ,GAAG,IAAI,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC"}

package/dist/channel/inbound.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Inbound Handler — converts Blay events into MsgContext
+ * and dispatches them through OpenClaw's native auto-reply pipeline.
+ *
+ * Follows the same 4-step pattern every OpenClaw channel uses
+ * (Telegram, Discord, Signal, Line, IRC, etc.):
+ *
+ * 1. resolveAgentRoute  — determines agent ID, session key, tool/skill config
+ * 2. recordInboundSession — registers the session for history and state
+ * 3. createReplyPrefixOptions — sets up response prefix template context
+ * 4. dispatchReplyWithBufferedBlockDispatcher — runs the agent with tools and delivers reply
+ */
+export declare function isAbortTrigger(text?: string): boolean;
+export interface WebhookPayload {
+    event: string;
+    timestamp: number;
+    organization_id?: string;
+    actor?: {
+        id: string;
+        name: string;
+    };
+    target?: {
+        type: string;
+        id: string;
+        name: string;
+    };
+    project?: {
+        name: string;
+    };
+    data?: Record<string, unknown>;
+}
+/**
+ * Post a comment to Blay via the API client.
+ * Returns the comment ID if successful, null otherwise.
+ */
+export declare function postComment(to: string, text: string): Promise<string | null>;
+/**
+ * Handle an abort trigger directly at the plugin level.
+ * Called from the SSE handler before dispatchBlayEvent — never enters
+ * OpenClaw's command lane. Sets the module-level abort flag, posts a
+ * "stopped" comment, and marks the current run as failed.
+ */
+export declare function handleAbortTrigger(payload: WebhookPayload): Promise<void>;
+/**
+ * Dispatch a Blay event through OpenClaw's native auto-reply pipeline.
+ *
+ * Uses the same 4-step pattern as every built-in channel:
+ * 1. resolveAgentRoute → agent ID, session key, tool/skill config
+ * 2. recordInboundSession → register session for history/state
+ * 3. createReplyPrefixOptions → response prefix template context
+ * 4. dispatchReplyWithBufferedBlockDispatcher → agent run + delivery
+ */
+export declare function dispatchBlayEvent(payload: WebhookPayload): Promise<boolean>;

package/dist/channel/inbound.js

@@ -0,0 +1,384 @@
+/**
+ * Inbound Handler — converts Blay events into MsgContext
+ * and dispatches them through OpenClaw's native auto-reply pipeline.
+ *
+ * Follows the same 4-step pattern every OpenClaw channel uses
+ * (Telegram, Discord, Signal, Line, IRC, etc.):
+ *
+ * 1. resolveAgentRoute  — determines agent ID, session key, tool/skill config
+ * 2. recordInboundSession — registers the session for history and state
+ * 3. createReplyPrefixOptions — sets up response prefix template context
+ * 4. dispatchReplyWithBufferedBlockDispatcher — runs the agent with tools and delivers reply
+ */
+import { createReplyPrefixOptions } from "openclaw/plugin-sdk";
+import { getBlayRuntime } from "./runtime.js";
+import { getBlayClient } from "./state.js";
+import { getAgentUserId, getAgentAllowedUserIds } from "./plugin.js";
+import { RunTracker, getCurrentRunTracker, setCurrentRunTracker } from "./run-tracker.js";
+import { signalAbort, isAborted, resetAbort } from "./abort.js";
+/**
+ * Abort trigger detection — matches OpenClaw's internal ABORT_TRIGGERS set.
+ * Used to fast-path abort messages so they bypass the command lane.
+ */
+const ABORT_TRIGGERS = new Set(["stop", "esc", "abort", "wait", "exit", "interrupt"]);
+export function isAbortTrigger(text) {
+    if (!text)
+        return false;
+    const normalized = text.trim().toLowerCase();
+    return ABORT_TRIGGERS.has(normalized) || normalized === "/stop";
+}
+/**
+ * Determine if this event should trigger the agent and build the message context.
+ * Returns null if the agent should ignore the event.
+ */
+function buildInboundContext(payload) {
+    const agentUserId = getAgentUserId();
+    if (!agentUserId) {
+        console.warn("[blay] agentUserId not resolved — dropping event (agent identity not yet available)");
+        return null;
+    }
+    // Never trigger on the agent's own actions
+    if (payload.actor?.id === agentUserId)
+        return null;
+    // Whitelist filter (defense-in-depth — server already filters)
+    // null = no whitelist (respond to everyone)
+    // [] = explicitly empty (respond to no one)
+    // [...ids] = respond only to these users
+    // System events (no actor) pass through
+    const allowedUserIds = getAgentAllowedUserIds();
+    if (Array.isArray(allowedUserIds) && payload.actor?.id) {
+        if (!allowedUserIds.includes(payload.actor.id))
+            return null;
+    }
+    const actorName = payload.actor?.name ?? "Someone";
+    const actorId = payload.actor?.id ?? "unknown";
+    const targetName = payload.target?.name ?? "an item";
+    const targetType = payload.target?.type ?? "item";
+    const targetId = payload.target?.id;
+    const projectName = payload.project?.name;
+    const content = payload.data?.content;
+    const commentId = payload.data?.commentId;
+    const mentions = payload.data?.mentions;
+    const isMentioned = mentions?.includes(agentUserId) ?? false;
+    const location = projectName
+        ? `on ${targetType} "${targetName}" in project "${projectName}"`
+        : `on ${targetType} "${targetName}"`;
+    // Delivery routing context — passed as UntrustedContext so OpenClaw renders
+    // it in a distinct metadata section. The agent needs these values to configure
+    // cron jobs and other scheduled actions that deliver back to Blay.
+    const deliveryTo = targetId ? `${targetType}:${targetId}` : undefined;
+    const untrustedContext = [];
+    if (deliveryTo) {
+        untrustedContext.push(`delivery_channel: blay-openclaw-plugin`);
+        untrustedContext.push(`delivery_to: ${deliveryTo}`);
+    }
+    // ── Comments ──────────────────────────────────────────────────────
+    if (payload.event === "comment_created") {
+        // Relevance filter: only trigger when agent is mentioned, is the
+        // entity owner, or is subscribed (watching). Applies to all entity
+        // types that carry _relevance metadata from the backend.
+        const relevance = payload.data?._relevance;
+        if (relevance) {
+            const isRelevant = isMentioned ||
+                relevance.isEntityOwner === true ||
+                relevance.isSubscribed === true;
+            if (!isRelevant)
+                return null;
+        }
+        let bodyForAgent;
+        if (isMentioned) {
+            bodyForAgent = content
+                ? `${actorName} @mentioned you ${location}: "${content}"`
+                : `${actorName} @mentioned you ${location}.`;
+        }
+        else {
+            bodyForAgent = content
+                ? `${actorName} said ${location}: "${content}"`
+                : `${actorName} posted a message ${location}`;
+        }
+        return {
+            Body: content ?? "",
+            BodyForAgent: bodyForAgent,
+            CommandBody: content ?? "",
+            BodyForCommands: content ?? "",
+            From: actorId,
+            To: targetId ? `${targetType}:${targetId}` : undefined,
+            SenderName: actorName,
+            SenderId: actorId,
+            MessageSid: commentId ?? `blay-${payload.timestamp}`,
+            SessionKey: targetId ? `blay-${targetId}` : "blay-general",
+            Provider: "blay-openclaw-plugin",
+            Surface: "blay-openclaw-plugin",
+            ChatType: "group",
+            GroupChannel: "blay-openclaw-plugin",
+            ConversationLabel: projectName ? `${projectName} / ${targetName}` : targetName,
+            // Always true: the plugin already filters for relevance (mention,
+            // task owner, or subscribed).  Setting WasMentioned=false causes
+            // OpenClaw's group-chat logic to emit NO_REPLY / silent token.
+            WasMentioned: true,
+            UntrustedContext: untrustedContext,
+            CommandAuthorized: true,
+            Timestamp: payload.timestamp,
+            OriginatingChannel: "blay-openclaw-plugin",
+            OriginatingTo: targetId ? `${targetType}:${targetId}` : undefined,
+            AccountId: "default",
+        };
+    }
+    // ── Task assignments ──────────────────────────────────────────────
+    if (payload.event === "task_assignee_changed") {
+        const newAssignee = payload.data?.newValue;
+        if (newAssignee === agentUserId) {
+            const bodyForAgent = [
+                `${actorName} assigned you to ${targetType} "${targetName}"`,
+                projectName ? `in project "${projectName}".` : ".",
+                targetId ? `\nTask ID: ${targetId}` : "",
+            ].filter(Boolean).join(" ");
+            return {
+                Body: `Assigned to: ${targetName}`,
+                BodyForAgent: bodyForAgent,
+                CommandBody: `Assigned to: ${targetName}`,
+                BodyForCommands: `Assigned to: ${targetName}`,
+                From: actorId,
+                To: targetId ? `task:${targetId}` : undefined,
+                SenderName: actorName,
+                SenderId: actorId,
+                MessageSid: `blay-assign-${payload.timestamp}`,
+                SessionKey: targetId ? `blay-${targetId}` : "blay-general",
+                Provider: "blay-openclaw-plugin",
+                Surface: "blay-openclaw-plugin",
+                ChatType: "group",
+                GroupChannel: "blay-openclaw-plugin",
+                ConversationLabel: projectName ? `${projectName} / ${targetName}` : targetName,
+                WasMentioned: true,
+                UntrustedContext: untrustedContext,
+                CommandAuthorized: true,
+                Timestamp: payload.timestamp,
+                OriginatingChannel: "blay-openclaw-plugin",
+                OriginatingTo: targetId ? `task:${targetId}` : undefined,
+                AccountId: "default",
+            };
+        }
+    }
+    // ── Action item assignments ───────────────────────────────────────
+    if (payload.event === "action_item_assigned") {
+        const assignee = payload.data?.assigneeId;
+        if (assignee === agentUserId) {
+            const bodyForAgent = [
+                `${actorName} assigned you an action item: "${targetName}"`,
+                projectName ? `in project "${projectName}".` : ".",
+            ].filter(Boolean).join(" ");
+            return {
+                Body: `Action item assigned: ${targetName}`,
+                BodyForAgent: bodyForAgent,
+                CommandBody: `Action item assigned: ${targetName}`,
+                BodyForCommands: `Action item assigned: ${targetName}`,
+                From: actorId,
+                To: targetId ? `actionItem:${targetId}` : undefined,
+                SenderName: actorName,
+                SenderId: actorId,
+                MessageSid: `blay-action-${payload.timestamp}`,
+                SessionKey: targetId ? `blay-${targetId}` : "blay-general",
+                Provider: "blay-openclaw-plugin",
+                Surface: "blay-openclaw-plugin",
+                ChatType: "group",
+                GroupChannel: "blay-openclaw-plugin",
+                ConversationLabel: projectName ? `${projectName} / ${targetName}` : targetName,
+                WasMentioned: true,
+                UntrustedContext: untrustedContext,
+                CommandAuthorized: true,
+                Timestamp: payload.timestamp,
+                OriginatingChannel: "blay-openclaw-plugin",
+                OriginatingTo: targetId ? `actionItem:${targetId}` : undefined,
+                AccountId: "default",
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Post a comment to Blay via the API client.
+ * Returns the comment ID if successful, null otherwise.
+ */
+export async function postComment(to, text) {
+    const client = getBlayClient();
+    if (!client) {
+        console.error("[blay] No client available for outbound delivery");
+        return null;
+    }
+    const [entityType, entityId] = to.split(":", 2);
+    if (!entityType || !entityId) {
+        console.error(`[blay] Invalid target "${to}"`);
+        return null;
+    }
+    const body = { content: text };
+    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) {
+        console.error(`[blay] Failed to post comment: HTTP ${res.status}`);
+        return null;
+    }
+    return res.data?.id ?? null;
+}
+/**
+ * Handle an abort trigger directly at the plugin level.
+ * Called from the SSE handler before dispatchBlayEvent — never enters
+ * OpenClaw's command lane. Sets the module-level abort flag, posts a
+ * "stopped" comment, and marks the current run as failed.
+ */
+export async function handleAbortTrigger(payload) {
+    signalAbort();
+    // Post "stopped" comment directly
+    const targetId = payload.target?.id;
+    const targetType = payload.target?.type ?? "task";
+    if (targetId) {
+        await postComment(`${targetType}:${targetId}`, "\u23f9\ufe0f Agent run stopped.");
+    }
+    // Mark current run as failed
+    const tracker = getCurrentRunTracker();
+    if (tracker) {
+        await tracker.fail(new Error("Aborted by user"));
+        setCurrentRunTracker(null);
+    }
+}
+/**
+ * Dispatch a Blay event through OpenClaw's native auto-reply pipeline.
+ *
+ * Uses the same 4-step pattern as every built-in channel:
+ * 1. resolveAgentRoute → agent ID, session key, tool/skill config
+ * 2. recordInboundSession → register session for history/state
+ * 3. createReplyPrefixOptions → response prefix template context
+ * 4. dispatchReplyWithBufferedBlockDispatcher → agent run + delivery
+ */
+export async function dispatchBlayEvent(payload) {
+    // Clear any previous abort flag so each new dispatch starts clean
+    resetAbort();
+    const ctx = buildInboundContext(payload);
+    if (!ctx)
+        return false;
+    console.log(`[blay] dispatching event: ${payload.event} from ${payload.actor?.name ?? "unknown"}`);
+    const runtime = getBlayRuntime();
+    const cfg = await runtime.config.loadConfig();
+    // RunTracker is only used for the normal (non-abort) path, but declared
+    // here so the catch block can access it for cleanup.
+    let tracker = null;
+    try {
+        // ── 1. Resolve agent route ──────────────────────────────────────
+        const peerId = ctx.To?.split(":")[1] ?? ctx.SessionKey;
+        const route = runtime.channel.routing.resolveAgentRoute({
+            cfg,
+            channel: "blay-openclaw-plugin",
+            accountId: "default",
+            peer: { kind: "group", id: peerId },
+        });
+        ctx.SessionKey = route.sessionKey;
+        // ── 2. Record inbound session ───────────────────────────────────
+        const storePath = runtime.channel.session.resolveStorePath(undefined, {
+            agentId: route.agentId,
+        });
+        await runtime.channel.session.recordInboundSession({
+            storePath,
+            sessionKey: route.sessionKey,
+            ctx,
+            createIfMissing: true,
+            updateLastRoute: {
+                sessionKey: route.sessionKey,
+                channel: "blay-openclaw-plugin",
+                to: ctx.To ?? "",
+                accountId: "default",
+            },
+            onRecordError: (err) => {
+                console.error("[blay] recordInboundSession error:", err);
+            },
+        });
+        // ── Create RunTracker and dispatch via command lane ─────────────
+        const client = getBlayClient();
+        if (!client) {
+            console.warn("[blay] getBlayClient() returned null — run tracking disabled");
+        }
+        if (client) {
+            const targetType = payload.target?.type;
+            const targetId = payload.target?.id;
+            tracker = new RunTracker(client, {
+                triggerEvent: payload.event,
+                triggerActorId: payload.actor?.id,
+                triggerActorName: payload.actor?.name,
+                entityType: targetType,
+                entityId: targetId,
+            });
+            await tracker.start();
+            setCurrentRunTracker(tracker);
+        }
+        // 3. Create reply prefix options (same as Telegram, Signal, Line, etc.)
+        const { onModelSelected, ...prefixOptions } = createReplyPrefixOptions({
+            cfg,
+            agentId: route.agentId,
+            channel: "blay-openclaw-plugin",
+            accountId: route.accountId,
+        });
+        // 4. Dispatch through the buffered block dispatcher (enters command lane)
+        const outboundTo = (ctx.To ?? ctx.OriginatingTo);
+        let blocksSent = 0;
+        await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+            ctx,
+            cfg,
+            dispatcherOptions: {
+                ...prefixOptions,
+                deliver: async (replyPayload, info) => {
+                    if (isAborted()) {
+                        console.log("[blay] delivery suppressed (aborted)");
+                        return;
+                    }
+                    if (!replyPayload.text && !replyPayload.mediaUrl)
+                        return;
+                    // Skip the final roll-up if blocks were already delivered
+                    if (info.kind === "final" && blocksSent > 0)
+                        return;
+                    if (info.kind === "block")
+                        blocksSent++;
+                    if (!outboundTo) {
+                        console.error("[blay] No outbound target for reply");
+                        return;
+                    }
+                    if (replyPayload.text) {
+                        const commentId = await postComment(outboundTo, replyPayload.text);
+                        if (commentId && tracker) {
+                            tracker.recordComment(commentId);
+                        }
+                    }
+                },
+                onError: (err, info) => {
+                    console.error(`[blay] dispatch error (${info.kind}):`, err);
+                },
+            },
+            replyOptions: {
+                onModelSelected,
+                disableBlockStreaming: false,
+            },
+        });
+        // ── Run completed successfully ────────────────────────────────
+        if (tracker) {
+            await tracker.complete();
+            setCurrentRunTracker(null);
+        }
+        return true;
+    }
+    catch (err) {
+        console.error("[blay] dispatch failed:", err);
+        // ── Run failed ────────────────────────────────────────────────
+        if (tracker) {
+            await tracker.fail(err);
+            setCurrentRunTracker(null);
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=inbound.js.map

package/dist/channel/inbound.js.map

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

package/dist/channel/plugin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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 type { ChannelPlugin } from "openclaw/plugin-sdk";
+import type { BlayClient } from "../client.js";
+import type { BlayPluginConfig } from "../types.js";
+export declare function getGatewayPort(): number;
+export declare function getGatewayBind(): string;
+export declare function getGatewayToken(): string | null;
+/** Resolved account — minimal since Blay uses a single API key */
+export interface BlayResolvedAccount {
+    accountId: string;
+    enabled: boolean;
+    apiKey: string;
+    apiUrl: string;
+}
+export declare function getAgentUserId(): string | null;
+export declare function getAgentAllowedUserIds(): string[] | null;
+export declare function createBlayChannelPlugin(client: BlayClient, pluginConfig: BlayPluginConfig): ChannelPlugin<BlayResolvedAccount>;