openclaw-linear 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stepan Arsentjev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# openclaw-linear
+
+Linear webhook integration for OpenClaw. Receives Linear events, filters and routes them, and dispatches consolidated notifications to agents.
+
+## Features
+
+- **Webhook handler** — receives Linear webhook events with HMAC signature verification (timing-safe), duplicate delivery detection, and body size limits
+- **Event router** — filters by team and event type, routes issue assignments and comment mentions to the configured agent
+- **Debounced dispatch** — batches events within a configurable window into a single consolidated message so the agent can triage before acting
+
+## Install
+
+```bash
+openclaw plugins install openclaw-linear
+```
+
+## Configuration
+
+Add the plugin to your OpenClaw config. Each OpenClaw instance runs one agent — configure a separate instance per agent.
+
+```yaml
+plugins:
+  linear:
+    webhookSecret: "your-webhook-signing-secret"
+    agentMapping:                     # Filter: only handle events for these Linear users
+      "linear-user-uuid": "titus"
+    teamIds: ["ENG", "OPS"]          # Optional: filter to specific teams (empty = all)
+    eventFilter: ["Issue", "Comment"] # Optional: filter event types (empty = all)
+    debounceMs: 30000                 # Optional: batch window in ms (default: 30000)
+```
+
+### Config Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `webhookSecret` | string | **Yes** | Shared secret for HMAC webhook signature verification. |
+| `agentMapping` | object | No | Maps Linear user UUIDs to agent IDs. Acts as a filter — events for unmapped users are ignored. Since each instance runs one agent, this typically has one entry. |
+| `teamIds` | string[] | No | Team keys to scope webhook processing. Empty = all teams. |
+| `eventFilter` | string[] | No | Event types to handle (`Issue`, `Comment`). Empty = all. |
+| `debounceMs` | integer | No | Debounce window in milliseconds. Events arriving within this window are batched into a single message. Must be positive. Default: `30000` (30s). |
+
+## Webhook Setup
+
+1. **Make your endpoint publicly accessible.** The plugin registers at `/hooks/linear`:
+   ```bash
+   # Example with Tailscale Funnel
+   tailscale funnel --bg 3000
+   ```
+
+2. **Register the webhook in Linear:**
+   - Go to **Settings > API > Webhooks**
+   - Set the URL to `https://your-host/hooks/linear`
+   - Set the secret to match your `webhookSecret`
+   - Select event types: Issues, Comments
+   - Save
+
+3. **Verify:** Assign a Linear issue to a mapped user — the agent should receive a notification.
+
+## Routed Events
+
+| Linear Event | Router Action | Agent Event |
+|---|---|---|
+| Issue assigned to mapped user | `wake` | `issue.assigned` |
+| Issue unassigned from mapped user | `notify` | `issue.unassigned` |
+| Issue reassigned away from mapped user | `notify` | `issue.reassigned` |
+| @mention in comment (mapped user) | `wake` | `comment.mention` |
+
+`wake` events are enqueued into the debouncer and dispatched to the agent. `notify` events are logged only.
+
+## How Dispatch Works
+
+```text
+Linear webhook POST
+  → HMAC signature verified (timing-safe)
+  → Duplicate delivery check (10-min TTL, 10k cap)
+  → Event router filters by team/type, matches user via agentMapping
+  → wake actions enqueued into debouncer (keyed by agent ID)
+  → After debounce window expires, consolidated message dispatched to agent
+```
+
+When multiple events arrive within the debounce window, the agent receives a single numbered message:
+
+```
+You have 3 new Linear notifications:
+
+1. [Assigned] ENG-42: Fix login bug
+2. [Assigned] ENG-43: Update API docs
+3. [Mentioned] ENG-40: Auth flow: "Can you review this?"
+
+Review and prioritize before starting work.
+```
+
+Single events are passed through as-is (no numbered wrapper).
+
+## Development
+
+```bash
+npm install
+npm run build
+
+# Type-check without emitting
+npx tsc --noEmit
+
+# Run tests
+npm test
+```

package/dist/event-router.d.ts

@@ -0,0 +1,21 @@
+import type { LinearWebhookPayload } from "./webhook-handler.js";
+export type RouterAction = {
+    type: "wake" | "notify";
+    agentId: string;
+    event: string;
+    detail: string;
+    issueId: string;
+    issueLabel: string;
+    linearUserId: string;
+};
+export type EventRouterConfig = {
+    agentMapping: Record<string, string>;
+    logger: {
+        info: (message: string) => void;
+        error: (message: string) => void;
+    };
+    eventFilter?: string[];
+    teamIds?: string[];
+};
+export declare function createEventRouter(config: EventRouterConfig): (event: LinearWebhookPayload) => RouterAction[];
+//# sourceMappingURL=event-router.d.ts.map

package/dist/event-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../src/event-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAyKF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,IACnC,OAAO,oBAAoB,KAAG,YAAY,EAAE,CAiCnE"}

package/dist/event-router.js

@@ -0,0 +1,162 @@
+/**
+ * Extract mention user IDs from ProseMirror bodyData JSON.
+ * Traverses the document tree looking for "mention" nodes with an `attrs.id`.
+ */
+function extractMentionsFromProseMirror(node) {
+    if (!node || typeof node !== "object")
+        return [];
+    const n = node;
+    const ids = [];
+    if (n.type === "mention") {
+        const attrs = n.attrs;
+        const id = attrs?.id;
+        if (typeof id === "string" && id) {
+            ids.push(id);
+        }
+    }
+    const content = n.content;
+    if (Array.isArray(content)) {
+        for (const child of content) {
+            ids.push(...extractMentionsFromProseMirror(child));
+        }
+    }
+    return ids;
+}
+/**
+ * Extract mentioned user identifiers from a comment.
+ * Tries structured ProseMirror bodyData first (yields UUIDs), then
+ * falls back to regex on the markdown body (yields usernames/handles).
+ */
+function extractMentionedUserIds(body, bodyData) {
+    if (bodyData) {
+        const ids = extractMentionsFromProseMirror(bodyData);
+        if (ids.length > 0)
+            return [...new Set(ids)];
+    }
+    const matches = body.matchAll(/@([a-zA-Z0-9_.-]+)/g);
+    return [...new Set([...matches].map((m) => m[1]))];
+}
+function resolveIssueLabel(data) {
+    const identifier = data.identifier;
+    const title = data.title;
+    const id = String(data.id ?? "unknown");
+    const label = identifier ?? id;
+    return title ? `${label}: ${title}` : label;
+}
+function handleIssueUpdate(event, config) {
+    const changes = event.data.changes;
+    if (!changes?.assigneeId)
+        return [];
+    const actions = [];
+    const { from: oldAssignee, to: newAssignee } = changes.assigneeId;
+    const issueId = String(event.data.id ?? "unknown");
+    const issueLabel = resolveIssueLabel(event.data);
+    if (newAssignee) {
+        const agentId = config.agentMapping[newAssignee];
+        if (agentId) {
+            actions.push({
+                type: "wake",
+                agentId,
+                event: "issue.assigned",
+                detail: `Assigned to issue ${issueLabel}`,
+                issueId,
+                issueLabel,
+                linearUserId: newAssignee,
+            });
+        }
+        else {
+            config.logger.info(`Unmapped Linear user ${newAssignee} assigned to ${issueId}`);
+        }
+    }
+    if (oldAssignee && !newAssignee) {
+        const agentId = config.agentMapping[oldAssignee];
+        if (agentId) {
+            actions.push({
+                type: "notify",
+                agentId,
+                event: "issue.unassigned",
+                detail: `Unassigned from issue ${issueLabel}`,
+                issueId,
+                issueLabel,
+                linearUserId: oldAssignee,
+            });
+        }
+        else {
+            config.logger.info(`Unmapped Linear user ${oldAssignee} unassigned from ${issueId}`);
+        }
+    }
+    // Reassignment: both old and new assignee present — notify old assignee
+    if (oldAssignee && newAssignee) {
+        const agentId = config.agentMapping[oldAssignee];
+        if (agentId) {
+            actions.push({
+                type: "notify",
+                agentId,
+                event: "issue.reassigned",
+                detail: `Reassigned away from issue ${issueLabel}`,
+                issueId,
+                issueLabel,
+                linearUserId: oldAssignee,
+            });
+        }
+    }
+    return actions;
+}
+function handleComment(event, config) {
+    const body = event.data.body;
+    if (!body)
+        return [];
+    const bodyData = event.data.bodyData;
+    const mentionedIds = extractMentionedUserIds(body, bodyData);
+    const actions = [];
+    const issueRef = event.data.issue;
+    const issueId = String(issueRef?.id ?? event.data.issueId ?? "unknown");
+    const issueLabel = issueRef
+        ? resolveIssueLabel(issueRef)
+        : issueId;
+    for (const userId of mentionedIds) {
+        const agentId = config.agentMapping[userId];
+        if (agentId) {
+            actions.push({
+                type: "wake",
+                agentId,
+                event: "comment.mention",
+                detail: `Mentioned in comment on issue ${issueLabel}\n\n> ${body}`,
+                issueId,
+                issueLabel,
+                linearUserId: userId,
+            });
+        }
+        else {
+            config.logger.info(`Unmapped Linear user ${userId} mentioned in comment on ${issueId}`);
+        }
+    }
+    return actions;
+}
+export function createEventRouter(config) {
+    return function route(event) {
+        // Apply event type filter
+        if (config.eventFilter?.length &&
+            !config.eventFilter.includes(event.type)) {
+            return [];
+        }
+        // Apply team filter
+        const teamId = event.data.teamId;
+        const teamObj = event.data.team;
+        const teamKey = teamObj?.key;
+        if (config.teamIds?.length) {
+            const match = config.teamIds.some((t) => t === teamId || t === teamKey);
+            if (!match && (teamId || teamKey))
+                return [];
+        }
+        if (event.type === "Issue" && event.action === "update") {
+            return handleIssueUpdate(event, config);
+        }
+        if (event.type === "Comment" &&
+            (event.action === "create" || event.action === "update")) {
+            return handleComment(event, config);
+        }
+        return [];
+    };
+}
+//# sourceMappingURL=event-router.js.map

package/dist/event-router.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { type RouterAction } from "./event-router.js";
+export declare function formatConsolidatedMessage(actions: RouterAction[]): string;
+export declare function activate(api: OpenClawPluginApi): void;
+export declare function deactivate(api: OpenClawPluginApi): Promise<void>;
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    activate: typeof activate;
+    deactivate: typeof deactivate;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYzE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAYzE;AA0ED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAyErD;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE;AAED,QAAA,MAAM,MAAM;;;;;;CAYX,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,153 @@
+import { createWebhookHandler } from "./webhook-handler.js";
+import { createEventRouter } from "./event-router.js";
+const CHANNEL_ID = "linear";
+const DEFAULT_DEBOUNCE_MS = 30_000;
+const EVENT_LABELS = {
+    "issue.assigned": "Assigned",
+    "issue.unassigned": "Unassigned",
+    "issue.reassigned": "Reassigned",
+    "comment.mention": "Mentioned",
+};
+export function formatConsolidatedMessage(actions) {
+    if (actions.length === 1) {
+        return actions[0].detail;
+    }
+    const lines = actions.map((a, i) => {
+        const label = EVENT_LABELS[a.event] ?? a.event;
+        const summary = formatActionSummary(a);
+        return `${i + 1}. [${label}] ${summary}`;
+    });
+    return `You have ${actions.length} new Linear notifications:\n\n${lines.join("\n")}\n\nReview and prioritize before starting work.`;
+}
+function formatActionSummary(action) {
+    if (action.event === "comment.mention") {
+        const bodyStart = action.detail.indexOf("\n\n> ");
+        if (bodyStart !== -1) {
+            const quote = action.detail.slice(bodyStart + 4); // skip "\n\n> "
+            return `${action.issueLabel}: "${quote}"`;
+        }
+    }
+    return action.issueLabel || action.detail;
+}
+async function dispatchConsolidatedActions(actions, api) {
+    if (actions.length === 0)
+        return;
+    const core = api.runtime;
+    const cfg = api.config;
+    const first = actions[0];
+    const route = core.channel.routing.resolveAgentRoute({
+        cfg,
+        channel: CHANNEL_ID,
+        accountId: "default",
+        peer: {
+            kind: "direct",
+            id: first.linearUserId,
+        },
+    });
+    const body = formatConsolidatedMessage(actions);
+    const ctx = core.channel.reply.finalizeInboundContext({
+        Body: body,
+        BodyForAgent: body,
+        RawBody: body,
+        CommandBody: body,
+        From: `${CHANNEL_ID}:${first.linearUserId}`,
+        To: `${CHANNEL_ID}:${route.agentId ?? first.agentId}`,
+        SessionKey: route.sessionKey,
+        AccountId: route.accountId ?? "default",
+        ChatType: "direct",
+        ConversationLabel: `Linear: batch (${actions.length} events)`,
+        SenderId: first.linearUserId,
+        Provider: CHANNEL_ID,
+        Surface: CHANNEL_ID,
+        OriginatingChannel: CHANNEL_ID,
+        OriginatingTo: `${CHANNEL_ID}:${first.linearUserId}`,
+    });
+    await core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+        ctx,
+        cfg,
+        dispatcherOptions: {
+            deliver: async () => {
+                // No-op: agent uses Linear tools to respond to specific issues after triage
+            },
+            onError: (err) => {
+                api.logger.error(`[linear] Reply error: ${err instanceof Error ? err.message : String(err)}`);
+            },
+        },
+    });
+}
+let activeDebouncer;
+const activeDebouncerKeys = new Set();
+export function activate(api) {
+    api.logger.info("Linear plugin activated");
+    const webhookSecret = api.pluginConfig?.["webhookSecret"];
+    if (typeof webhookSecret !== "string" || !webhookSecret) {
+        api.logger.error("[linear] webhookSecret is not configured — plugin is inert");
+        return;
+    }
+    const agentMapping = api.pluginConfig?.["agentMapping"] ?? {};
+    if (Object.keys(agentMapping).length === 0) {
+        api.logger.info("[linear] agentMapping is empty — all events will be dropped");
+    }
+    const eventFilter = api.pluginConfig?.["eventFilter"] ?? [];
+    const teamIds = api.pluginConfig?.["teamIds"] ?? [];
+    const rawDebounceMs = api.pluginConfig?.["debounceMs"];
+    const debounceMs = (typeof rawDebounceMs === "number" && rawDebounceMs > 0)
+        ? rawDebounceMs
+        : DEFAULT_DEBOUNCE_MS;
+    const route = createEventRouter({
+        agentMapping,
+        logger: api.logger,
+        eventFilter: eventFilter.length ? eventFilter : undefined,
+        teamIds: teamIds.length ? teamIds : undefined,
+    });
+    const debouncer = api.runtime.channel.debounce.createInboundDebouncer({
+        debounceMs,
+        buildKey: (action) => action.agentId,
+        shouldDebounce: () => true,
+        onFlush: async (actions) => {
+            await dispatchConsolidatedActions(actions, api);
+        },
+        onError: (err) => {
+            api.logger.error(`[linear] Debounce flush failed: ${err instanceof Error ? err.message : String(err)}`);
+        },
+    });
+    activeDebouncer = debouncer;
+    const handler = createWebhookHandler({
+        webhookSecret,
+        logger: api.logger,
+        onEvent: (event) => {
+            const actions = route(event);
+            for (const action of actions) {
+                api.logger.info(`[event-router] ${action.type} agent=${action.agentId} event=${action.event}: ${action.detail}`);
+                if (action.type === "wake") {
+                    activeDebouncerKeys.add(action.agentId);
+                    debouncer.enqueue(action);
+                }
+            }
+        },
+    });
+    api.registerHttpRoute({
+        path: "/hooks/linear",
+        handler,
+    });
+    api.logger.info(`Linear webhook handler registered at /hooks/linear (debounce: ${debounceMs}ms)`);
+}
+export async function deactivate(api) {
+    if (activeDebouncer) {
+        for (const key of activeDebouncerKeys) {
+            await activeDebouncer.flushKey(key);
+        }
+        activeDebouncerKeys.clear();
+        activeDebouncer = undefined;
+    }
+    api.logger.info("Linear plugin deactivated");
+}
+const plugin = {
+    id: "linear",
+    name: "Linear",
+    description: "Linear project management integration for OpenClaw",
+    activate,
+    deactivate,
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAqB,MAAM,mBAAmB,CAAC;AAEzE,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,MAAM,YAAY,GAA2B;IAC3C,gBAAgB,EAAE,UAAU;IAC5B,kBAAkB,EAAE,YAAY;IAChC,kBAAkB,EAAE,YAAY;IAChC,iBAAiB,EAAE,WAAW;CAC/B,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,OAAuB;IAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;QAC/C,MAAM,OAAO,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,OAAO,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,YAAY,OAAO,CAAC,MAAM,iCAAiC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iDAAiD,CAAC;AACtI,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAoB;IAC/C,IAAI,MAAM,CAAC,KAAK,KAAK,iBAAiB,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB;YAClE,OAAO,GAAG,MAAM,CAAC,UAAU,MAAM,KAAK,GAAG,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,OAAuB,EACvB,GAAsB;IAEtB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACnD,GAAG;QACH,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE;YACJ,IAAI,EAAE,QAAiB;YACvB,EAAE,EAAE,KAAK,CAAC,YAAY;SACvB;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC;QACpD,IAAI,EAAE,IAAI;QACV,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,GAAG,UAAU,IAAI,KAAK,CAAC,YAAY,EAAE;QAC3C,EAAE,EAAE,GAAG,UAAU,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACrD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACvC,QAAQ,EAAE,QAAQ;QAClB,iBAAiB,EAAE,kBAAkB,OAAO,CAAC,MAAM,UAAU;QAC7D,QAAQ,EAAE,KAAK,CAAC,YAAY;QAC5B,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,UAAU;QACnB,kBAAkB,EAAE,UAAU;QAC9B,aAAa,EAAE,GAAG,UAAU,IAAI,KAAK,CAAC,YAAY,EAAE;KACrD,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC;QAChE,GAAG;QACH,GAAG;QACH,iBAAiB,EAAE;YACjB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,4EAA4E;YAC9E,CAAC;YACD,OAAO,EAAE,CAAC,GAAY,EAAE,EAAE;gBACxB,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC5E,CAAC;YACJ,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,IAAI,eAAyE,CAAC;AAC9E,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE9C,MAAM,UAAU,QAAQ,CAAC,GAAsB;IAC7C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAE3C,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,CAAC;IAC1D,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GACf,GAAG,CAAC,YAAY,EAAE,CAAC,cAAc,CAA4B,IAAI,EAAE,CAAC;IACvE,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,WAAW,GACd,GAAG,CAAC,YAAY,EAAE,CAAC,aAAa,CAAc,IAAI,EAAE,CAAC;IACxD,MAAM,OAAO,GACV,GAAG,CAAC,YAAY,EAAE,CAAC,SAAS,CAAc,IAAI,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,YAAY,CAAuB,CAAC;IAC7E,MAAM,UAAU,GACd,CAAC,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,GAAG,CAAC,CAAC;QACtD,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,mBAAmB,CAAC;IAE1B,MAAM,KAAK,GAAG,iBAAiB,CAAC;QAC9B,YAAY;QACZ,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QACzD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAe;QAClF,UAAU;QACV,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;QACpC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI;QAC1B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,2BAA2B,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,GAAG,CAAC,MAAM,CAAC,KAAK,CACd,mCAAmC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,eAAe,GAAG,SAAS,CAAC;IAE5B,MAAM,OAAO,GAAG,oBAAoB,CAAC;QACnC,aAAa;QACb,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,kBAAkB,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,CAChG,CAAC;gBAEF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC3B,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBACxC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,GAAG,CAAC,iBAAiB,CAAC;QACpB,IAAI,EAAE,eAAe;QACrB,OAAO;KACR,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,iEAAiE,UAAU,KAAK,CACjF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAsB;IACrD,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACtC,MAAM,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAC5B,eAAe,GAAG,SAAS,CAAC;IAC9B,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oDAAoD;IACjE,QAAQ;IACR,UAAU;CAOX,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/webhook-handler.d.ts

@@ -0,0 +1,18 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export type LinearWebhookPayload = {
+    action: string;
+    type: string;
+    data: Record<string, unknown>;
+    createdAt: string;
+};
+type WebhookHandlerDeps = {
+    webhookSecret: string;
+    logger: {
+        info: (message: string) => void;
+        error: (message: string) => void;
+    };
+    onEvent?: (event: LinearWebhookPayload) => void;
+};
+export declare function createWebhookHandler(deps: WebhookHandlerDeps): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export {};
+//# sourceMappingURL=webhook-handler.d.ts.map

package/dist/webhook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handler.d.ts","sourceRoot":"","sources":["../src/webhook-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACjD,CAAC;AAgCF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,IAqB7C,KAAK,eAAe,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAyExE"}

package/dist/webhook-handler.js

@@ -0,0 +1,118 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+const MAX_BODY_BYTES = 1024 * 1024; // 1 MB
+const DEDUP_TTL_MS = 10 * 60 * 1000; // 10 minutes
+const DEDUP_MAX_SIZE = 10_000;
+function verifySignature(body, signature, secret) {
+    const expected = createHmac("sha256", secret).update(body).digest("hex");
+    if (expected.length !== signature.length) {
+        return false;
+    }
+    return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on("data", (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new Error("Request body too large"));
+                req.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+export function createWebhookHandler(deps) {
+    /** Map of delivery ID → timestamp for duplicate detection with TTL. */
+    const processedDeliveries = new Map();
+    function pruneDeliveries() {
+        const now = Date.now();
+        for (const [id, ts] of processedDeliveries) {
+            if (now - ts > DEDUP_TTL_MS) {
+                processedDeliveries.delete(id);
+            }
+        }
+        if (processedDeliveries.size > DEDUP_MAX_SIZE) {
+            const excess = processedDeliveries.size - DEDUP_MAX_SIZE;
+            const iter = processedDeliveries.keys();
+            for (let i = 0; i < excess; i++) {
+                const key = iter.next().value;
+                if (key !== undefined)
+                    processedDeliveries.delete(key);
+            }
+        }
+    }
+    return async (req, res) => {
+        if (req.method !== "POST") {
+            res.writeHead(405, { Allow: "POST" });
+            res.end("Method Not Allowed");
+            return;
+        }
+        let rawBody;
+        try {
+            rawBody = await readBody(req);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes("too large")) {
+                res.writeHead(413);
+                res.end("Payload Too Large");
+            }
+            else {
+                res.writeHead(500);
+                res.end("Internal Server Error");
+            }
+            return;
+        }
+        const signature = req.headers["linear-signature"];
+        if (typeof signature !== "string" || !verifySignature(rawBody, signature, deps.webhookSecret)) {
+            res.writeHead(400);
+            res.end("Invalid signature");
+            return;
+        }
+        let event;
+        try {
+            const payload = JSON.parse(rawBody);
+            const deliveryId = req.headers["linear-delivery"];
+            // Prune expired entries periodically
+            pruneDeliveries();
+            if (deliveryId) {
+                if (processedDeliveries.has(deliveryId)) {
+                    deps.logger.info(`Duplicate delivery skipped: ${deliveryId}`);
+                    res.writeHead(200);
+                    res.end("OK");
+                    return;
+                }
+                processedDeliveries.set(deliveryId, Date.now());
+            }
+            event = {
+                action: String(payload.action ?? ""),
+                type: String(payload.type ?? ""),
+                data: payload.data ?? {},
+                createdAt: String(payload.createdAt ?? ""),
+            };
+            deps.logger.info(`Linear webhook: ${event.action} ${event.type} (${String(event.data.id ?? "unknown")})`);
+        }
+        catch (err) {
+            deps.logger.error(`Webhook parse error: ${err instanceof Error ? err.message : String(err)}`);
+            res.writeHead(500);
+            res.end("Internal Server Error");
+            return;
+        }
+        // Always return 200 after successful parse — onEvent errors must not
+        // cause Linear to retry (which could create a retry storm).
+        res.writeHead(200);
+        res.end("OK");
+        try {
+            deps.onEvent?.(event);
+        }
+        catch (err) {
+            deps.logger.error(`Event handler error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    };
+}
+//# sourceMappingURL=webhook-handler.js.map

package/dist/webhook-handler.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,36 @@
+{
+  "id": "linear",
+  "name": "Linear",
+  "description": "Linear project management integration for OpenClaw",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "webhookSecret": {
+        "type": "string",
+        "sensitive": true,
+        "description": "Webhook signing secret for HMAC verification"
+      },
+      "teamIds": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Linear team keys to listen for (e.g. [\"ENG\", \"OPS\"]). Empty = all teams."
+      },
+      "eventFilter": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Event types to handle (e.g. [\"Issue\", \"Comment\"]). Empty = all types."
+      },
+      "agentMapping": {
+        "type": "object",
+        "additionalProperties": { "type": "string" },
+        "description": "Map Linear user IDs to OpenClaw agent IDs for routing (e.g. {\"linear-user-uuid\": \"agent-name\"})"
+      },
+      "debounceMs": {
+        "type": "integer",
+        "description": "Debounce window in milliseconds for batching webhook events before dispatch (default: 30000)"
+      }
+    },
+    "required": ["webhookSecret"]
+  }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "openclaw-linear",
+  "version": "0.1.0",
+  "description": "Linear webhook integration for OpenClaw — receives events, routes them, and dispatches consolidated notifications to agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepack": "npm run build",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "openclaw",
+    "linear",
+    "webhook",
+    "plugin"
+  ],
+  "author": "Stepan Arsentjev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stepandel/openclaw-linear.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.0"
+  },
+  "devDependencies": {
+    "openclaw": "^2026.2.12",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
+}