@burdenoff/vibe-plugin-ssh 1.0.1 → 2.1.0

package/README.md

@@ -31,18 +31,18 @@ vibe plugin list  # verify it shows up
 
 Once installed, the plugin registers these routes on the agent:
 
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/ssh/connections` | List all SSH connections |
-| POST | `/api/ssh/connections` | Create a new SSH connection |
-| POST | `/api/ssh/execute` | Execute a remote command |
-| POST | `/api/ssh/test/:id` | Test an SSH connection |
-| DELETE | `/api/ssh/connections/:id` | Delete a connection |
-| GET | `/api/port-forward/` | List all port forwards |
-| POST | `/api/port-forward/` | Create a port forward |
-| POST | `/api/port-forward/:id/start` | Start forwarding |
-| POST | `/api/port-forward/:id/stop` | Stop forwarding |
-| DELETE | `/api/port-forward/:id` | Delete a forward |
+| Method | Path                          | Description                 |
+| ------ | ----------------------------- | --------------------------- |
+| GET    | `/api/ssh/connections`        | List all SSH connections    |
+| POST   | `/api/ssh/connections`        | Create a new SSH connection |
+| POST   | `/api/ssh/execute`            | Execute a remote command    |
+| POST   | `/api/ssh/test/:id`           | Test an SSH connection      |
+| DELETE | `/api/ssh/connections/:id`    | Delete a connection         |
+| GET    | `/api/port-forward/`          | List all port forwards      |
+| POST   | `/api/port-forward/`          | Create a port forward       |
+| POST   | `/api/port-forward/:id/start` | Start forwarding            |
+| POST   | `/api/port-forward/:id/stop`  | Stop forwarding             |
+| DELETE | `/api/port-forward/:id`       | Delete a forward            |
 
 ## CLI Commands
 

package/dist/index.d.ts

@@ -1,25 +1,17 @@
-import type { FastifyInstance } from "fastify";
-import type { Command } from "commander";
 /**
- * @burdenoff/vibe-plugin-ssh
+ * @burdenoff/vibe-plugin-ssh v2.0.0
  *
  * SSH connections, remote command execution, and port forwarding plugin
- * for the VibeControls Agent. This plugin registers:
+ * for the VibeControls Agent (Bun / Elysia / KV storage).
  *
- *   - Fastify routes: /api/ssh/*, /api/port-forward/*
- *   - CLI commands:   vibe ssh list|add|remove|test|exec
- *                     vibe forward list|create|start|stop|delete
+ * Registers:
+ *   - Elysia routes: /api/ssh/*, /api/port-forward/*
+ *   - CLI stub:      (SSH CLI commands to be implemented later)
  *
  * Install: vibe plugin install @burdenoff/vibe-plugin-ssh
  */
-export interface VibePlugin {
-    name: string;
-    version: string;
-    description?: string;
-    onCliSetup?: (program: Command) => void | Promise<void>;
-    onServerStart?: (app: FastifyInstance) => void | Promise<void>;
-    onServerStop?: (app: FastifyInstance) => void | Promise<void>;
-}
+import type { VibePlugin } from "./types.js";
+export type { VibePlugin, HostServices, StorageProvider, EventBus, ServiceRegistry, SSHConnection, PortForward, } from "./types.js";
 export declare const vibePlugin: VibePlugin;
 export default vibePlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;GAWG;AAGH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,eAAO,MAAM,UAAU,EAAE,UAsBxB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,YAAY,CAAC;AAG3D,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAYpB,eAAO,MAAM,UAAU,EAAE,UAuCxB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -1,20 +1,51 @@
+/**
+ * @burdenoff/vibe-plugin-ssh v2.0.0
+ *
+ * SSH connections, remote command execution, and port forwarding plugin
+ * for the VibeControls Agent (Bun / Elysia / KV storage).
+ *
+ * Registers:
+ *   - Elysia routes: /api/ssh/*, /api/port-forward/*
+ *   - CLI stub:      (SSH CLI commands to be implemented later)
+ *
+ * Install: vibe plugin install @burdenoff/vibe-plugin-ssh
+ */
+// ---------------------------------------------------------------------------
+// Module-level reference so onServerStop can clean up
+// ---------------------------------------------------------------------------
+let cleanupFn;
+// ---------------------------------------------------------------------------
+// Plugin definition
+// ---------------------------------------------------------------------------
 export const vibePlugin = {
     name: "ssh",
-    version: "1.0.0",
-    description: "SSH connections & port forwarding for VibeControls Agent",
-    async onServerStart(app) {
-        // Dynamically import ssh2 — this is the whole point of the plugin:
-        // ssh2 (with native cpu-features) is only loaded when the plugin is installed.
-        const { sshRoutes } = await import("./routes/ssh.js");
-        const { portForwardRoutes } = await import("./routes/port-forward.js");
-        await app.register(sshRoutes, { prefix: "/api/ssh" });
-        await app.register(portForwardRoutes, { prefix: "/api/port-forward" });
-        console.log("  🔌 Plugin 'ssh' registered routes: /api/ssh, /api/port-forward");
+    version: "2.0.0",
+    description: "SSH connection management and port forwarding",
+    tags: ["backend", "cli", "integration"],
+    cliCommand: "ssh",
+    apiPrefix: "/api/ssh",
+    async onServerStart(app, hostServices) {
+        // Dynamically import route modules — ssh2 native deps only load when
+        // the plugin is actually activated.
+        const { createSSHRoutes } = await import("./routes/ssh.js");
+        const { createPortForwardRoutes, cleanupAllTunnels } = await import("./routes/port-forward.js");
+        app.use(createSSHRoutes(hostServices));
+        app.use(createPortForwardRoutes(hostServices));
+        // Stash the cleanup function for onServerStop
+        cleanupFn = cleanupAllTunnels;
+        console.log("  Plugin 'ssh' registered routes: /api/ssh, /api/port-forward");
     },
-    onCliSetup(program) {
-        // SSH CLI commands are registered by the agent's built-in CLI for now.
-        // In a future version, the CLI commands will also move into this plugin.
-        // For now, the plugin only contributes server-side routes.
+    async onServerStop() {
+        // Tear down every active SSH tunnel and connection
+        if (cleanupFn) {
+            cleanupFn();
+            cleanupFn = undefined;
+        }
+        console.log("  Plugin 'ssh' cleaned up active connections");
+    },
+    onCliSetup(_program) {
+        // SSH CLI commands to be implemented in a future version.
+        // The plugin currently only contributes server-side routes.
     },
 };
 export default vibePlugin;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,UAAU,GAAe;IACpC,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,0DAA0D;IAEvE,KAAK,CAAC,aAAa,CAAC,GAAoB;QACtC,mEAAmE;QACnE,+EAA+E;QAC/E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAEvE,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,MAAM,GAAG,CAAC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAEvE,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;IAClF,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,uEAAuE;QACvE,yEAAyE;QACzE,2DAA2D;IAC7D,CAAC;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E,IAAI,SAAmC,CAAC;AAExC,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAe;IACpC,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,+CAA+C;IAC5D,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC;IACvC,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,UAAU;IAErB,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,YAA0B;QACzD,qEAAqE;QACrE,oCAAoC;QACpC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,GAClD,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAE3C,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAC;QAE/C,8CAA8C;QAC9C,SAAS,GAAG,iBAAiB,CAAC;QAE9B,OAAO,CAAC,GAAG,CACT,+DAA+D,CAChE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,mDAAmD;QACnD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,EAAE,CAAC;YACZ,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;IAED,UAAU,CAAC,QAAiB;QAC1B,0DAA0D;QAC1D,4DAA4D;IAC9D,CAAC;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/routes/port-forward.d.ts

@@ -1,3 +1,190 @@
-import { FastifyPluginAsync } from "fastify";
-export declare const portForwardRoutes: FastifyPluginAsync;
+/**
+ * Port-forwarding routes (Elysia + KV storage).
+ *
+ * Namespace: "ssh"
+ * Keys:
+ *   "connections"   → JSON array of SSHConnection objects  (read-only here)
+ *   "port-forwards" → JSON array of PortForward objects
+ */
+import { Elysia } from "elysia";
+import type { HostServices, PortForward } from "../types.js";
+export declare function cleanupAllTunnels(): void;
+export declare function createPortForwardRoutes(hostServices: HostServices): Elysia<"/api/port-forward", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    api: {
+        "port-forward": {
+            get: {
+                body: unknown;
+                params: {};
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: {
+                        portForwards: PortForward[];
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        "port-forward": {
+            post: {
+                body: unknown;
+                params: {};
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: {
+                        error: string;
+                        portForward?: undefined;
+                        details?: undefined;
+                    } | {
+                        portForward: PortForward;
+                        error?: undefined;
+                        details?: undefined;
+                    } | {
+                        error: string;
+                        details: string;
+                        portForward?: undefined;
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        "port-forward": {
+            ":id": {
+                start: {
+                    post: {
+                        body: unknown;
+                        params: {
+                            id: string;
+                        } & {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        "port-forward": {
+            ":id": {
+                stop: {
+                    post: {
+                        body: unknown;
+                        params: {
+                            id: string;
+                        } & {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: {
+                                error: string;
+                                success?: undefined;
+                                details?: undefined;
+                            } | {
+                                success: boolean;
+                                error?: undefined;
+                                details?: undefined;
+                            } | {
+                                error: string;
+                                details: string;
+                                success?: undefined;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        "port-forward": {
+            ":id": {
+                delete: {
+                    body: unknown;
+                    params: {
+                        id: string;
+                    } & {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            error: string;
+                            success?: undefined;
+                            details?: undefined;
+                        } | {
+                            success: boolean;
+                            error?: undefined;
+                            details?: undefined;
+                        } | {
+                            error: string;
+                            details: string;
+                            success?: undefined;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
 //# sourceMappingURL=port-forward.d.ts.map

package/dist/routes/port-forward.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port-forward.d.ts","sourceRoot":"","sources":["../../src/routes/port-forward.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgB7C,eAAO,MAAM,iBAAiB,EAAE,kBAuP/B,CAAC"}
+{"version":3,"file":"port-forward.d.ts","sourceRoot":"","sources":["../../src/routes/port-forward.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EAEZ,MAAM,aAAa,CAAC;AAgHrB,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAMD,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmQjE"}