opencode-vibe-webhook 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# opencode-vibe-webhook
+
+OpenCode native plugin for VibeControls notifications. **Companion plugin to [@burdenoff/vibe-plugin-notify](../vibe-plugin-notify/)**.
+
+Runs **inside OpenCode** for 100% reliable event detection and sends events to VibeControls Agent for webhook delivery.
+
+## Architecture
+
+```
+┌─────────────────────────────┐         ┌─────────────────────────────────┐
+│  OpenCode                   │         │  VibeControls Agent             │
+│                             │         │                                 │
+│  opencode-vibe-webhook      │────────>│  vibe-plugin-notify             │
+│  (this plugin)              │  POST   │                                 │
+│                             │         │    Configured Webhooks:         │
+│  - Native event detection   │         │    ├── Slack                    │
+│  - 100% reliable            │         │    ├── Discord                  │
+│  - Zero latency             │         │    └── Custom                   │
+└─────────────────────────────┘         └─────────────────────────────────┘
+```
+
+## Quick Start
+
+### 1. Install vibe-plugin-notify in VibeControls
+
+```bash
+vibe plugin install @burdenoff/vibe-plugin-notify
+```
+
+### 2. Add webhooks via VibeControls CLI
+
+```bash
+vibe notify add https://hooks.slack.com/services/xxx
+```
+
+### 3. Add this plugin to OpenCode
+
+In `~/.config/opencode/opencode.jsonc`:
+
+```json
+{
+  "plugin": ["opencode-vibe-webhook"]
+}
+```
+
+Or with full path:
+
+```json
+{
+  "plugin": ["/path/to/opencode-vibe-webhook/dist/index.js"]
+}
+```
+
+### 4. Done!
+
+Events from OpenCode automatically flow to VibeControls, which delivers to your webhooks.
+
+## Commands
+
+Use `/vibehook` in OpenCode to manage settings:
+
+| Command                  | Description                        |
+| ------------------------ | ---------------------------------- |
+| `/vibehook status`       | Show current configuration         |
+| `/vibehook test`         | Test VibeControls connection       |
+| `/vibehook add <url>`    | Add direct webhook (bypass Vibe)   |
+| `/vibehook list`         | List direct webhooks               |
+| `/vibehook remove <id>`  | Remove a direct webhook            |
+| `/vibehook events`       | Show event presets                 |
+| `/vibehook vibe-enable`  | Enable VibeControls notifications  |
+| `/vibehook vibe-disable` | Disable VibeControls notifications |
+
+### Examples
+
+```
+/vibehook status
+/vibehook test
+/vibehook add https://hooks.slack.com/services/xxx "Backup Slack"
+```
+
+## Configuration
+
+Config is stored at `~/.config/opencode/vibe-webhook.json`:
+
+```json
+{
+  "webhooks": [],
+  "vibeAgentUrl": "http://localhost:3005",
+  "vibeNotifyEnabled": true,
+  "vibeNotifyEvents": ["default"],
+  "notifyChildSessions": false,
+  "debug": false,
+  "logFile": null
+}
+```
+
+### Pre-configured
+
+- **VibeControls notifications enabled by default** - No setup needed
+- Events flow to `http://localhost:3005/api/notify/hook`
+- Manage webhooks centrally via `vibe notify` CLI
+
+### Direct Webhooks (Optional)
+
+Add direct webhooks for backup or custom routing:
+
+```
+/vibehook add https://hooks.slack.com/services/xxx
+```
+
+These bypass VibeControls and deliver directly.
+
+## Supported Events
+
+| Event                | Description             | Notification           |
+| -------------------- | ----------------------- | ---------------------- |
+| `session.idle`       | Task completed          | ✅ Task Completed      |
+| `session.error`      | Task failed             | ❌ Task Failed         |
+| `question.asked`     | AI asks user a question | ❓ Question Asked      |
+| `permission.updated` | Permission requested    | 🔔 Permission Required |
+| `session.created`    | New session started     | 🚀 Session Started     |
+| `session.status`     | Working/retrying        | ⏳ Working...          |
+| `file.edited`        | File modified           | ✏️ File Edited         |
+| `command.executed`   | Command run             | 💻 Command Executed    |
+
+### Event Presets
+
+| Preset     | Events                                                                  |
+| ---------- | ----------------------------------------------------------------------- |
+| `minimal`  | `session.idle`                                                          |
+| `default`  | `session.idle`, `session.error`, `question.asked`, `permission.updated` |
+| `standard` | Above + `session.created`                                               |
+| `verbose`  | Above + `session.status`, `file.edited`, `command.executed`             |
+| `all`      | All events                                                              |
+
+## Why This Architecture?
+
+| Approach        | Where Webhooks Live | Pros                             |
+| --------------- | ------------------- | -------------------------------- |
+| **This plugin** | VibeControls Agent  | Central management, CLI, retries |
+| Direct webhooks | OpenCode config     | Simple, no agent needed          |
+| Both            | Both                | Redundancy, flexibility          |
+
+**Recommended**: Use VibeControls Agent for webhook management. Add direct webhooks only for backup or special cases.
+
+## Troubleshooting
+
+### Test VibeControls connection
+
+```
+/vibehook test
+```
+
+### Enable debug logging
+
+Edit `~/.config/opencode/vibe-webhook.json`:
+
+```json
+{
+  "debug": true,
+  "logFile": "/tmp/vibe-webhook.log"
+}
+```
+
+Watch logs: `tail -f /tmp/vibe-webhook.log`
+
+### Common issues
+
+| Issue                      | Solution                                    |
+| -------------------------- | ------------------------------------------- |
+| VibeControls not reachable | Start VibeControls Agent with notify plugin |
+| No notifications           | Run `/vibehook status` to check config      |
+| Wrong events               | Edit `vibeNotifyEvents` in config file      |
+
+## Related Packages
+
+- [@burdenoff/vibe-plugin-notify](../vibe-plugin-notify/) - VibeControls webhook management plugin
+- [VibeControls Agent](https://github.com/algoshred/vibecontrols) - AI coding assistant orchestration
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * opencode-vibe-webhook
+ *
+ * OpenCode native plugin for VibeControls webhook notifications.
+ * Companion plugin for @burdenoff/vibe-plugin-notify.
+ *
+ * Runs INSIDE OpenCode process for 100% reliable event detection.
+ *
+ * Features:
+ * - Pre-configured to send events to VibeControls Agent (vibe-plugin-notify)
+ * - Native event hook (no polling, no SSE)
+ * - Interactive setup via /vibehook command
+ * - Additional webhooks for Slack, Discord, custom endpoints
+ *
+ * Setup:
+ *   1. Install vibe-plugin-notify in VibeControls Agent
+ *   2. Add this plugin to opencode.jsonc
+ *   3. Events automatically flow to VibeControls for webhook delivery
+ *   4. Optionally add direct webhooks: /vibehook add <url>
+ */
+import { tool } from "@opencode-ai/plugin/tool";
+interface OpenCodeEvent {
+    type: string;
+    properties?: Record<string, unknown>;
+}
+interface PluginContext {
+    project?: {
+        name?: string;
+        path?: string;
+    };
+    client?: {
+        session?: {
+            get: (opts: {
+                path: {
+                    id: string;
+                };
+            }) => Promise<{
+                data?: SessionData;
+            }>;
+        };
+    };
+    directory?: string;
+    worktree?: string;
+}
+interface SessionData {
+    id?: string;
+    title?: string;
+    parentID?: string;
+}
+type Plugin = (ctx: PluginContext) => Promise<{
+    event?: (args: {
+        event: OpenCodeEvent;
+    }) => Promise<void>;
+    tool?: Record<string, ReturnType<typeof tool>>;
+}>;
+export declare const VibeWebhookPlugin: Plugin;
+export default VibeWebhookPlugin;
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAiBhD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE;YACR,GAAG,EAAE,CAAC,IAAI,EAAE;gBAAE,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC;gBAAE,IAAI,CAAC,EAAE,WAAW,CAAA;aAAE,CAAC,CAAC;SAC1E,CAAC;KACH,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,WAAW;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAk1BD,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;IAC5C,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;CAChD,CAAC,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,MAmB/B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}