@burdenoff/vibe-plugin-notify 1.0.0

package/README.md

@@ -0,0 +1,188 @@
+# @burdenoff/vibe-plugin-notify
+
+Generic webhook notification plugin for AI coding tools - a VibeControls Agent plugin.
+
+Receives events from AI coding tools (OpenCode, Claude Code, Gemini CLI, etc.) and delivers to configured webhooks (Slack, Discord, custom).
+
+## Architecture
+
+```
+┌─────────────────────┐     ┌─────────────────────────────────────────────┐
+│  AI Coding Tool     │     │  VibeControls Agent                         │
+│                     │     │                                             │
+│  Tool-specific      │────>│  vibe-plugin-notify                         │
+│  plugin (e.g.       │POST │    │                                        │
+│  opencode-vibe-     │     │    ├──> Slack webhook                       │
+│  webhook)           │     │    ├──> Discord webhook                     │
+└─────────────────────┘     │    └──> Custom webhook                      │
+                            └─────────────────────────────────────────────┘
+```
+
+**Why this architecture?**
+
+| Component            | Purpose                                                        |
+| -------------------- | -------------------------------------------------------------- |
+| Tool-specific plugin | Runs **inside AI tool** - 100% reliable native event detection |
+| `vibe-plugin-notify` | Runs in **VibeControls** - webhook management, CLI, delivery   |
+
+## Supported AI Tools
+
+| Tool        | Plugin                  | Status  |
+| ----------- | ----------------------- | ------- |
+| OpenCode    | `opencode-vibe-webhook` | Ready   |
+| Claude Code | Coming soon             | Planned |
+| Gemini CLI  | Coming soon             | Planned |
+
+## Quick Start
+
+### 1. Install this plugin in VibeControls
+
+```bash
+vibe plugin install @burdenoff/vibe-plugin-notify
+```
+
+### 2. Install tool-specific plugin
+
+For OpenCode:
+
+```bash
+# Add to opencode.json
+{
+  "plugins": ["opencode-vibe-webhook"]
+}
+```
+
+### 3. Add a webhook
+
+```bash
+vibe notify add https://hooks.slack.com/services/xxx/yyy/zzz
+```
+
+That's it! When your AI tool completes a task, you'll get a notification.
+
+## CLI Commands
+
+| Command                    | Description              |
+| -------------------------- | ------------------------ |
+| `vibe notify add <url>`    | Add a webhook URL        |
+| `vibe notify list`         | List all webhooks        |
+| `vibe notify remove <id>`  | Remove a webhook         |
+| `vibe notify test <id>`    | Send a test notification |
+| `vibe notify enable <id>`  | Enable a webhook         |
+| `vibe notify disable <id>` | Disable a webhook        |
+
+## Usage Examples
+
+### Add a Slack Webhook
+
+```bash
+vibe notify add https://hooks.slack.com/services/T00/B00/XXX --name "Slack Alerts"
+```
+
+### Add a Discord Webhook
+
+```bash
+vibe notify add https://discord.com/api/webhooks/123/abc --name "Discord"
+```
+
+### Add with specific events
+
+```bash
+vibe notify add https://example.com/webhook --events "session.idle,session.error"
+```
+
+## REST API
+
+| Method   | Endpoint                           | Description                     |
+| -------- | ---------------------------------- | ------------------------------- |
+| `GET`    | `/api/notify/health`               | Health check                    |
+| `POST`   | `/api/notify/hook`                 | Receive events from tool plugin |
+| `GET`    | `/api/notify/webhooks`             | List webhooks                   |
+| `POST`   | `/api/notify/webhooks`             | Create webhook                  |
+| `DELETE` | `/api/notify/webhooks/:id`         | Delete webhook                  |
+| `POST`   | `/api/notify/webhooks/:id/test`    | Test webhook                    |
+| `POST`   | `/api/notify/webhooks/:id/enable`  | Enable webhook                  |
+| `POST`   | `/api/notify/webhooks/:id/disable` | Disable webhook                 |
+| `GET`    | `/api/notify/deliveries`           | Delivery history                |
+
+## Webhook Payload
+
+When an AI tool completes a task, webhooks receive:
+
+```json
+{
+  "id": "dlv_abc123",
+  "timestamp": "2026-02-27T10:30:00.000Z",
+  "event": {
+    "type": "session.idle",
+    "sessionId": "sess_xyz",
+    "sessionTitle": "Add user authentication",
+    "projectName": "my-app",
+    "properties": {}
+  },
+  "source": {
+    "agent": "vibecontrols-agent",
+    "plugin": "notify",
+    "version": "1.0.0",
+    "tool": "opencode"
+  }
+}
+```
+
+### Slack Format
+
+```
+:white_check_mark: *Task Completed* (opencode)
+> Add user authentication
+```
+
+### Discord Format
+
+```
+**Task Completed** (opencode)
+> Add user authentication
+```
+
+## Supported Events
+
+| Event              | Description              |
+| ------------------ | ------------------------ |
+| `session.idle`     | Task completed (default) |
+| `session.error`    | Task failed              |
+| `permission.asked` | AI needs user permission |
+| `*`                | All events               |
+
+## Creating a Tool Plugin
+
+To add support for a new AI coding tool, create a plugin that posts events to `/api/notify/hook`:
+
+```typescript
+// Example event payload
+const event = {
+  type: "session.idle",
+  source: "your-tool-name",
+  properties: {
+    sessionID: "sess_123",
+    sessionTitle: "Task description",
+  },
+  timestamp: new Date().toISOString(),
+};
+
+await fetch("http://localhost:4321/api/notify/hook", {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify(event),
+});
+```
+
+See [opencode-vibe-webhook](../opencode-vibe-webhook/) for a reference implementation.
+
+## Requirements
+
+- VibeControls Agent 2.0+
+- Tool-specific plugin (e.g., `opencode-vibe-webhook` for OpenCode)
+- Bun 1.3+
+
+## License
+
+Proprietary - Burdenoff Consultancy Services Pvt. Ltd.

package/dist/cli/commands.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI Commands for vibe-plugin-notify
+ *
+ * Commands:
+ *   vibe notify add <url>      - Add a webhook
+ *   vibe notify list           - List all webhooks
+ *   vibe notify remove <id>    - Remove a webhook
+ *   vibe notify test <id>      - Test a webhook
+ *   vibe notify enable <id>    - Enable a webhook
+ *   vibe notify disable <id>   - Disable a webhook
+ */
+import type { Command } from "commander";
+import type { HostServices } from "../types.js";
+export declare function registerCommands(program: Command, hostServices: HostServices): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAqBjE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,GACzB,IAAI,CA+PN"}

package/dist/cli/commands.js

@@ -0,0 +1,194 @@
+/**
+ * CLI Commands for vibe-plugin-notify
+ *
+ * Commands:
+ *   vibe notify add <url>      - Add a webhook
+ *   vibe notify list           - List all webhooks
+ *   vibe notify remove <id>    - Remove a webhook
+ *   vibe notify test <id>      - Test a webhook
+ *   vibe notify enable <id>    - Enable a webhook
+ *   vibe notify disable <id>   - Disable a webhook
+ */
+export function registerCommands(program, hostServices) {
+    const cmd = program
+        .command("notify")
+        .description("Webhook management for AI coding tool notifications");
+    // Add webhook
+    cmd
+        .command("add <url>")
+        .description("Add a webhook URL")
+        .option("-n, --name <name>", "Friendly name for the webhook")
+        .option("-e, --events <events>", "Comma-separated event types (default: session.idle)")
+        .action(async (url, options) => {
+        const baseUrl = hostServices.getAgentBaseUrl();
+        const eventTypes = options.events?.split(",").map((e) => e.trim());
+        try {
+            const response = await fetch(`${baseUrl}/api/notify/webhooks`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    url,
+                    name: options.name,
+                    eventTypes,
+                    test: true,
+                }),
+            });
+            const data = (await response.json());
+            if (!response.ok) {
+                const errorData = data;
+                console.error(`Error: ${errorData.error || "Failed to add webhook"}`);
+                process.exit(1);
+            }
+            const successData = data;
+            console.log("\nWebhook added successfully!\n");
+            console.log(`  ID:     ${successData.webhook.id}`);
+            console.log(`  Name:   ${successData.webhook.name}`);
+            console.log(`  URL:    ${successData.webhook.url}`);
+            console.log(`  Events: ${successData.webhook.eventTypes.join(", ")}`);
+            if (successData.test) {
+                if (successData.test.success) {
+                    console.log(`  Test:   Passed (${successData.test.statusCode})`);
+                }
+                else {
+                    console.log(`  Test:   Failed - ${successData.test.error}`);
+                }
+            }
+            console.log();
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    // List webhooks
+    cmd
+        .command("list")
+        .description("List all webhooks")
+        .action(async () => {
+        const baseUrl = hostServices.getAgentBaseUrl();
+        try {
+            const response = await fetch(`${baseUrl}/api/notify/webhooks`);
+            const data = (await response.json());
+            if (!response.ok) {
+                const errorData = data;
+                console.error(`Error: ${errorData.error || "Failed to list webhooks"}`);
+                process.exit(1);
+            }
+            const listData = data;
+            if (listData.webhooks.length === 0) {
+                console.log("\nNo webhooks configured.\n");
+                console.log("Add one with: vibe notify add <url>\n");
+                return;
+            }
+            console.log(`\nWebhooks (${listData.count}):\n`);
+            for (const webhook of listData.webhooks) {
+                const status = webhook.enabled ? "enabled" : "disabled";
+                console.log(`  ${webhook.id}`);
+                console.log(`    Name:   ${webhook.name}`);
+                console.log(`    URL:    ${webhook.url}`);
+                console.log(`    Status: ${status}`);
+                console.log(`    Events: ${webhook.eventTypes.join(", ")}`);
+                console.log();
+            }
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    // Remove webhook
+    cmd
+        .command("remove <id>")
+        .description("Remove a webhook")
+        .action(async (id) => {
+        const baseUrl = hostServices.getAgentBaseUrl();
+        try {
+            const response = await fetch(`${baseUrl}/api/notify/webhooks/${id}`, {
+                method: "DELETE",
+            });
+            const data = (await response.json());
+            if (!response.ok) {
+                const errorData = data;
+                console.error(`Error: ${errorData.error || "Failed to remove webhook"}`);
+                process.exit(1);
+            }
+            console.log(`\nWebhook ${id} removed.\n`);
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    // Test webhook
+    cmd
+        .command("test <id>")
+        .description("Send a test notification to a webhook")
+        .action(async (id) => {
+        const baseUrl = hostServices.getAgentBaseUrl();
+        try {
+            const response = await fetch(`${baseUrl}/api/notify/webhooks/${id}/test`, { method: "POST" });
+            const data = (await response.json());
+            if (!response.ok) {
+                const errorData = data;
+                console.error(`Error: ${errorData.error || "Failed to test webhook"}`);
+                process.exit(1);
+            }
+            const testData = data;
+            console.log(`\nTest notification sent to: ${testData.webhook.name}\n`);
+            if (testData.test?.success) {
+                console.log(`  Result: Passed (HTTP ${testData.test.statusCode})\n`);
+            }
+            else {
+                console.log(`  Result: Failed\n`);
+                console.log(`  Error:  ${testData.test?.error}\n`);
+            }
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    // Enable webhook
+    cmd
+        .command("enable <id>")
+        .description("Enable a webhook")
+        .action(async (id) => {
+        const baseUrl = hostServices.getAgentBaseUrl();
+        try {
+            const response = await fetch(`${baseUrl}/api/notify/webhooks/${id}/enable`, { method: "POST" });
+            const data = (await response.json());
+            if (!response.ok) {
+                const errorData = data;
+                console.error(`Error: ${errorData.error || "Failed to enable webhook"}`);
+                process.exit(1);
+            }
+            console.log(`\nWebhook ${id} enabled.\n`);
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    // Disable webhook
+    cmd
+        .command("disable <id>")
+        .description("Disable a webhook")
+        .action(async (id) => {
+        const baseUrl = hostServices.getAgentBaseUrl();
+        try {
+            const response = await fetch(`${baseUrl}/api/notify/webhooks/${id}/disable`, { method: "POST" });
+            const data = (await response.json());
+            if (!response.ok) {
+                const errorData = data;
+                console.error(`Error: ${errorData.error || "Failed to disable webhook"}`);
+                process.exit(1);
+            }
+            console.log(`\nWebhook ${id} disabled.\n`);
+        }
+        catch (error) {
+            console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @burdenoff/vibe-plugin-notify v1.0.0
+ *
+ * Generic webhook notifications for AI coding tools.
+ * Receives events from native plugins and delivers to configured webhooks.
+ *
+ * Supported AI Tools:
+ * - OpenCode (via opencode-vibe-webhook plugin)
+ * - Claude Code (via claudecode-vibe-webhook plugin) [future]
+ * - Gemini CLI (via gemini-vibe-webhook plugin) [future]
+ *
+ * Features:
+ * - Webhook CRUD management via CLI and REST API
+ * - Supports Slack, Discord, and custom webhooks
+ * - Delivery with retries and tracking
+ * - Simple CLI: vibe notify add <url>
+ *
+ * Install: vibe plugin install @burdenoff/vibe-plugin-notify
+ */
+import type { VibePlugin } from "./types.js";
+export type { VibePlugin, HostServices, WebhookEndpoint, WebhookDelivery, NotifyEvent, } from "./types.js";
+export declare const vibePlugin: VibePlugin;
+export default vibePlugin;
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAcpB,eAAO,MAAM,UAAU,EAAE,UA2PxB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,237 @@
+/**
+ * @burdenoff/vibe-plugin-notify v1.0.0
+ *
+ * Generic webhook notifications for AI coding tools.
+ * Receives events from native plugins and delivers to configured webhooks.
+ *
+ * Supported AI Tools:
+ * - OpenCode (via opencode-vibe-webhook plugin)
+ * - Claude Code (via claudecode-vibe-webhook plugin) [future]
+ * - Gemini CLI (via gemini-vibe-webhook plugin) [future]
+ *
+ * Features:
+ * - Webhook CRUD management via CLI and REST API
+ * - Supports Slack, Discord, and custom webhooks
+ * - Delivery with retries and tracking
+ * - Simple CLI: vibe notify add <url>
+ *
+ * Install: vibe plugin install @burdenoff/vibe-plugin-notify
+ */
+import { Elysia } from "elysia";
+import { DEFAULT_CONFIG } from "./types.js";
+import { WebhookDeliveryService } from "./services/webhook-delivery.js";
+import { registerCommands } from "./cli/commands.js";
+// ---------------------------------------------------------------------------
+// Module-level references for lifecycle management
+// ---------------------------------------------------------------------------
+let deliveryService = null;
+let hostServicesRef = null;
+const config = { ...DEFAULT_CONFIG };
+// ---------------------------------------------------------------------------
+// Plugin definition
+// ---------------------------------------------------------------------------
+export const vibePlugin = {
+    name: "notify",
+    version: "1.0.0",
+    description: "Webhook notifications for AI coding tools",
+    tags: ["backend", "cli", "integration"],
+    cliCommand: "notify",
+    apiPrefix: "/api/notify",
+    publicPaths: ["/health", "/hook"],
+    /**
+     * Create routes for the plugin
+     */
+    createRoutes(_deps) {
+        return (new Elysia()
+            // Health check (public)
+            .get("/health", () => {
+            return {
+                ok: true,
+                plugin: "notify",
+                version: "1.0.0",
+                mode: "webhook-receiver",
+            };
+        })
+            // Hook endpoint - receives events from AI tool plugins (public)
+            .post("/hook", async ({ body, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const hookData = body;
+            // Extract event from payload (standard format from native plugins)
+            const eventData = hookData?.event;
+            // Determine source (opencode, claudecode, gemini, etc.)
+            const source = hookData?.source?.plugin || "unknown";
+            hostServicesRef?.logger.info("notify", `[HOOK] Event received from ${source}`, { type: eventData?.type || "unknown" });
+            const event = {
+                type: eventData?.type || "task.completed",
+                properties: {
+                    sessionId: eventData?.sessionId,
+                    sessionTitle: eventData?.sessionTitle,
+                    projectName: eventData?.projectName,
+                    projectPath: eventData?.projectPath,
+                    source: source,
+                    ...(eventData?.properties || {}),
+                },
+            };
+            // Deliver webhooks
+            await deliveryService.processEvent(event);
+            return { success: true, message: "Event processed" };
+        })
+            // List all webhooks
+            .get("/webhooks", async ({ set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const manager = deliveryService.getWebhookManager();
+            const webhooks = await manager.listWebhooks();
+            return { webhooks, count: webhooks.length };
+        })
+            // Create a new webhook
+            .post("/webhooks", async ({ body, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const input = body;
+            try {
+                const manager = deliveryService.getWebhookManager();
+                const webhook = await manager.createWebhook({
+                    url: input.url,
+                    name: input.name,
+                    eventTypes: input.eventTypes,
+                });
+                // Optionally send test webhook
+                let testResult = null;
+                if (input.test !== false) {
+                    testResult = await deliveryService.sendTestWebhook(webhook.id);
+                }
+                return { webhook, test: testResult };
+            }
+            catch (error) {
+                set.status = 400;
+                return {
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+        })
+            // Get a specific webhook
+            .get("/webhooks/:id", async ({ params, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const manager = deliveryService.getWebhookManager();
+            const webhook = await manager.getWebhook(params.id);
+            if (!webhook) {
+                set.status = 404;
+                return { error: "Webhook not found" };
+            }
+            return { webhook };
+        })
+            // Delete a webhook
+            .delete("/webhooks/:id", async ({ params, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const manager = deliveryService.getWebhookManager();
+            const deleted = await manager.deleteWebhook(params.id);
+            if (!deleted) {
+                set.status = 404;
+                return { error: "Webhook not found" };
+            }
+            return { success: true, message: "Webhook deleted" };
+        })
+            // Enable a webhook
+            .post("/webhooks/:id/enable", async ({ params, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const manager = deliveryService.getWebhookManager();
+            const webhook = await manager.enableWebhook(params.id);
+            if (!webhook) {
+                set.status = 404;
+                return { error: "Webhook not found" };
+            }
+            return { webhook };
+        })
+            // Disable a webhook
+            .post("/webhooks/:id/disable", async ({ params, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const manager = deliveryService.getWebhookManager();
+            const webhook = await manager.disableWebhook(params.id);
+            if (!webhook) {
+                set.status = 404;
+                return { error: "Webhook not found" };
+            }
+            return { webhook };
+        })
+            // Test a webhook
+            .post("/webhooks/:id/test", async ({ params, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const manager = deliveryService.getWebhookManager();
+            const webhook = await manager.getWebhook(params.id);
+            if (!webhook) {
+                set.status = 404;
+                return { error: "Webhook not found" };
+            }
+            const result = await deliveryService.sendTestWebhook(params.id);
+            return {
+                webhook: { id: webhook.id, name: webhook.name },
+                test: result,
+            };
+        })
+            // List deliveries
+            .get("/deliveries", async ({ query, set }) => {
+            if (!deliveryService) {
+                set.status = 503;
+                return { error: "Plugin not initialized" };
+            }
+            const q = query;
+            const deliveries = await deliveryService.getDeliveries({
+                webhookId: q.webhookId,
+                status: q.status,
+                limit: q.limit ? parseInt(q.limit, 10) : 50,
+            });
+            return { deliveries, count: deliveries.length };
+        }));
+    },
+    /**
+     * Initialize services when server starts
+     */
+    async onServerStart(_app, hostServices) {
+        const { storage, logger } = hostServices;
+        hostServicesRef = hostServices;
+        logger.info("notify", "Initializing plugin...");
+        // Initialize delivery service
+        deliveryService = new WebhookDeliveryService(storage, logger, config);
+        logger.info("notify", "Plugin initialized (webhook receiver mode)");
+        logger.info("notify", "Waiting for events from AI tool plugins at /api/notify/hook");
+    },
+    /**
+     * Cleanup when server stops
+     */
+    async onServerStop() {
+        deliveryService = null;
+        hostServicesRef = null;
+        console.log("  Plugin 'notify' cleaned up");
+    },
+    /**
+     * Register CLI commands
+     */
+    onCliSetup(program, hostServices) {
+        registerCommands(program, hostServices);
+    },
+};
+export default vibePlugin;
+//# sourceMappingURL=index.js.map