@vibecontrols/vibe-plugin-ssh 2026.416.1

package/README.md

@@ -0,0 +1,70 @@
+# @burdenoff/vibe-plugin-ssh
+
+SSH connections & port forwarding plugin for [VibeControls Agent](https://www.npmjs.com/package/@vibecontrols/agent).
+
+## Installation
+
+```bash
+vibe plugin install @burdenoff/vibe-plugin-ssh
+```
+
+Or install globally alongside the agent:
+
+```bash
+npm install -g @burdenoff/vibe-plugin-ssh
+```
+
+Then register it:
+
+```bash
+vibe plugin list  # verify it shows up
+```
+
+## Features
+
+- **SSH Connections** — Save, test, and manage SSH connection configs
+- **Remote Execution** — Execute commands on remote servers via SSH
+- **Port Forwarding** — Create and manage SSH port forwards (local → remote)
+- **Real-time Output** — SSH command output streamed via Socket.IO events
+
+## API Routes
+
+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            |
+
+## CLI Commands
+
+SSH and port forward CLI commands are built into the `vibe` CLI:
+
+```bash
+vibe ssh list                       # List saved connections
+vibe ssh add --name my-server ...   # Add a connection
+vibe ssh test -i <id>               # Test connectivity
+vibe ssh exec -i <id> -c "uptime"   # Run remote command
+
+vibe forward list                   # List port forwards
+vibe forward create --local 5432 --remote-host db --remote-port 5432 --server my-server
+vibe forward start -i <id>          # Start forwarding
+vibe forward stop -i <id>           # Stop forwarding
+```
+
+## Requirements
+
+- VibeControls Agent >= 1.1.0
+- Node.js >= 18.0.0
+
+## License
+
+Proprietary — Copyright Burdenoff Consultancy Services Pvt. Ltd.

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @burdenoff/vibe-plugin-ssh v3.0.0
+ *
+ * SSH connections, remote command execution, port forwarding,
+ * remote terminal sessions (ttyd on destination), and remote agent installation.
+ *
+ * Registers:
+ *   - Elysia routes: /api/ssh/*, /api/port-forward/*
+ *   - Session provider: "ssh" (for terminal proxy integration)
+ *   - CLI commands: vibe ssh ...
+ *
+ * Install: vibe plugin install @burdenoff/vibe-plugin-ssh
+ */
+import type { VibePlugin } from "./types.js";
+export type { VibePlugin, HostServices, StorageProvider, EventBus, ServiceRegistry, SSHConnection, PortForward, SSHTerminalSession, RemoteAgentInstallJob, } 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;;;;;;;;;;;;GAYG;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,EACX,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAapB,eAAO,MAAM,UAAU,EAAE,UA6HxB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,118 @@
+/**
+ * @burdenoff/vibe-plugin-ssh v3.0.0
+ *
+ * SSH connections, remote command execution, port forwarding,
+ * remote terminal sessions (ttyd on destination), and remote agent installation.
+ *
+ * Registers:
+ *   - Elysia routes: /api/ssh/*, /api/port-forward/*
+ *   - Session provider: "ssh" (for terminal proxy integration)
+ *   - CLI commands: vibe ssh ...
+ *
+ * Install: vibe plugin install @burdenoff/vibe-plugin-ssh
+ */
+// ---------------------------------------------------------------------------
+// Module-level references for cleanup
+// ---------------------------------------------------------------------------
+let cleanupPortForwards;
+let cleanupTerminals;
+// ---------------------------------------------------------------------------
+// Plugin definition
+// ---------------------------------------------------------------------------
+export const vibePlugin = {
+    name: "ssh",
+    version: "3.0.0",
+    description: "SSH connection management, remote terminals, port forwarding, and remote agent installation",
+    tags: ["backend", "cli", "integration", "provider"],
+    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");
+        const { createRemoteTerminalRoutes, cleanupAllTerminals, getTerminalInfo, listTerminalSessions, } = await import("./routes/remote-terminal.js");
+        const { createRemoteAgentInstallRoutes } = await import("./routes/remote-agent-install.js");
+        const { createSSHConfigScanRoutes } = await import("./routes/ssh-config-scan.js");
+        // Mount all route groups
+        app.use(createSSHRoutes(hostServices));
+        app.use(createPortForwardRoutes(hostServices));
+        app.use(createRemoteTerminalRoutes(hostServices));
+        app.use(createRemoteAgentInstallRoutes(hostServices));
+        app.use(createSSHConfigScanRoutes(hostServices));
+        // Stash cleanup functions
+        cleanupPortForwards = cleanupAllTunnels;
+        cleanupTerminals = cleanupAllTerminals;
+        // Register as a "session" provider so the agent's terminal proxy at
+        // /terminal/:sessionId/ws can find our SSH-forwarded ttyd ports.
+        // We only need to implement getTerminalInfo(); other SessionProvider
+        // methods are not called by the terminal proxy.
+        if (hostServices.serviceRegistry) {
+            const sshSessionProvider = {
+                name: "ssh",
+                getTerminalInfo: (sessionId) => getTerminalInfo(sessionId),
+                // Minimal stubs — the terminal proxy only calls getTerminalInfo
+                list: async () => {
+                    return listTerminalSessions().map((s) => ({
+                        id: s.id,
+                        name: `ssh-terminal-${s.id.slice(0, 8)}`,
+                        status: s.status === "active" ? "active" : "inactive",
+                        provider: "ssh",
+                        createdAt: s.startedAt,
+                    }));
+                },
+                get: async (sessionId) => {
+                    const sessions = listTerminalSessions();
+                    const s = sessions.find((x) => x.id === sessionId);
+                    if (!s)
+                        return null;
+                    return {
+                        id: s.id,
+                        name: `ssh-terminal-${s.id.slice(0, 8)}`,
+                        status: s.status === "active" ? "active" : "inactive",
+                        provider: "ssh",
+                        createdAt: s.startedAt,
+                    };
+                },
+            };
+            hostServices.serviceRegistry.registerProvider("session", sshSessionProvider, "ssh");
+        }
+        console.log("  Plugin 'ssh' v3.0.0 registered routes: /api/ssh, /api/port-forward, /api/ssh/terminal, /api/ssh/agent-install, /api/ssh/config-scan");
+    },
+    async onServerStop() {
+        if (cleanupTerminals) {
+            cleanupTerminals();
+            cleanupTerminals = undefined;
+        }
+        if (cleanupPortForwards) {
+            cleanupPortForwards();
+            cleanupPortForwards = undefined;
+        }
+        console.log("  Plugin 'ssh' cleaned up active connections and terminals");
+    },
+    onCliSetup(program) {
+        const ssh = program
+            .command("ssh")
+            .description("SSH connection and remote terminal management");
+        ssh
+            .command("list")
+            .description("List saved SSH connections")
+            .action(() => {
+            console.log("Use the agent API to list SSH connections: GET /api/ssh/connections");
+        });
+        ssh
+            .command("terminals")
+            .description("List active remote terminal sessions")
+            .action(() => {
+            console.log("Use the agent API to list terminal sessions: GET /api/ssh/terminal/sessions");
+        });
+        ssh
+            .command("install-jobs")
+            .description("List remote agent installation jobs")
+            .action(() => {
+            console.log("Use the agent API to list install jobs: GET /api/ssh/agent-install/jobs");
+        });
+    },
+};
+export default vibePlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,190 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}