@grackle-ai/adapter-ssh 0.72.2

package/README.md

@@ -0,0 +1,24 @@
+# @grackle-ai/adapter-ssh
+
+Grackle environment adapter for managing remote environments via SSH.
+
+## Overview
+
+The SSH adapter provisions PowerLine on a remote host, opens an SSH tunnel for gRPC communication, and a reverse tunnel so remote agents can reach the local MCP server.
+
+## Configuration
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `host` | `string` | *required* | Remote hostname or IP |
+| `user` | `string` | current OS user | SSH username |
+| `sshPort` | `number` | `22` | SSH port |
+| `identityFile` | `string` | — | Path to SSH private key |
+| `sshOptions` | `Record<string, string>` | — | Extra SSH `-o Key=Value` options |
+| `localPort` | `number` | auto | Override local tunnel port |
+| `env` | `Record<string, string>` | — | Extra env vars for remote PowerLine |
+
+## Prerequisites
+
+- SSH access to the remote host (key-based authentication recommended)
+- `ssh` and `scp` available on PATH

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { SshAdapter } from "./ssh.js";
+export type { SshEnvironmentConfig } from "./ssh.js";
+//# 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,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { SshAdapter } from "./ssh.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/ssh.d.ts

@@ -0,0 +1,49 @@
+import type { EnvironmentAdapter, BaseEnvironmentConfig, PowerLineConnection, ProvisionEvent, AdapterDependencies } from "@grackle-ai/adapter-sdk";
+/** SSH-specific environment configuration. */
+export interface SshEnvironmentConfig extends BaseEnvironmentConfig {
+    /** Remote hostname or IP address (required). */
+    host: string;
+    /** SSH username (defaults to the current OS user). */
+    user?: string;
+    /** SSH port on the remote host (defaults to 22). */
+    sshPort?: number;
+    /** Path to an SSH private key file. */
+    identityFile?: string;
+    /** Extra SSH options passed as `-o Key=Value`. */
+    sshOptions?: Record<string, string>;
+    /** Override the local tunnel port (otherwise a free port is chosen). */
+    localPort?: number;
+    /** Additional environment variables forwarded to the remote PowerLine. */
+    env?: Record<string, string>;
+}
+/** Environment adapter that provisions and manages remote environments via SSH. */
+export declare class SshAdapter implements EnvironmentAdapter {
+    type: string;
+    private readonly execFn;
+    private readonly sleepFn;
+    private readonly isGitHubProviderEnabled;
+    constructor(deps?: AdapterDependencies);
+    /** Provision the remote host: test connectivity, bootstrap PowerLine, open tunnel. */
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    /**
+     * Attempt fast reconnect: probe PowerLine, restart if needed, re-open tunnel.
+     *
+     * Any failure (SSH unreachable, PowerLine won't start, tunnel error) throws
+     * and falls through to the caller, which should trigger a full provision.
+     *
+     * Minimizes SSH round trips — probe and conditional restart run in a single
+     * SSH call via `startRemotePowerLine({ probeFirst: true })`.
+     */
+    reconnect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    /** Connect to the PowerLine through the SSH tunnel. */
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    /** Close the SSH tunnel without stopping the remote PowerLine. */
+    disconnect(environmentId: string): Promise<void>;
+    /** Stop the remote PowerLine process and close the tunnel. */
+    stop(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /** Stop the remote PowerLine, remove artifacts, and close the tunnel. */
+    destroy(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /** Check that the tunnel is alive and the PowerLine responds to a ping. */
+    healthCheck(connection: PowerLineConnection): Promise<boolean>;
+}
+//# sourceMappingURL=ssh.d.ts.map

package/dist/ssh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../src/ssh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAgB,MAAM,yBAAyB,CAAC;AA8BjK,8CAA8C;AAC9C,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AA2ID,mFAAmF;AACnF,qBAAa,UAAW,YAAW,kBAAkB;IAC5C,IAAI,EAAE,MAAM,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAgB;gBAErC,IAAI,GAAE,mBAAwB;IAMjD,sFAAsF;IACxE,SAAS,CACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,cAAc,CAAC;IAwCjC;;;;;;;;OAQG;IACW,SAAS,CACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,cAAc,CAAC;IAqCjC,uDAAuD;IAC1C,OAAO,CAClB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC;IAQ/B,kEAAkE;IACrD,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,8DAA8D;IACjD,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF,yEAAyE;IAC5D,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3F,2EAA2E;IAC9D,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5E"}

package/dist/ssh.js

@@ -0,0 +1,223 @@
+import { DEFAULT_POWERLINE_PORT, DEFAULT_MCP_PORT } from "@grackle-ai/common";
+import { ProcessTunnel, bootstrapPowerLine, connectThroughTunnel, registerTunnel, getTunnel, closeTunnel, findFreePort, remoteStop, remoteDestroy, remoteHealthCheck, startRemotePowerLine, exec as defaultExec, sleep as defaultSleep, SSH_CONNECTIVITY_TIMEOUT_MS, REMOTE_EXEC_DEFAULT_TIMEOUT_MS, } from "@grackle-ai/adapter-sdk";
+const REMOTE_COPY_TIMEOUT_MS = 120_000;
+/** Delay for reverse tunnels to wait for SSH to establish. */
+const REVERSE_TUNNEL_SETTLE_MS = 3_000;
+// ─── SSH Helpers ────────────────────────────────────────────
+/** Build the common SSH flags shared across exec, scp, and tunnel commands. */
+function buildSshFlags(cfg) {
+    const flags = ["-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=accept-new"];
+    if (cfg.sshPort) {
+        flags.push("-p", String(cfg.sshPort));
+    }
+    if (cfg.identityFile) {
+        flags.push("-i", cfg.identityFile);
+    }
+    if (cfg.sshOptions) {
+        for (const [key, value] of Object.entries(cfg.sshOptions)) {
+            flags.push("-o", `${key}=${value}`);
+        }
+    }
+    return flags;
+}
+/** Build the `user@host` destination string. */
+function buildDestination(cfg) {
+    return cfg.user ? `${cfg.user}@${cfg.host}` : cfg.host;
+}
+// ─── Executor ───────────────────────────────────────────────
+/** Execute commands on a remote host via SSH. */
+class SshExecutor {
+    cfg;
+    execFn;
+    constructor(cfg, execFn) {
+        this.cfg = cfg;
+        this.execFn = execFn;
+    }
+    /** Execute a shell command on the remote host and return trimmed stdout. */
+    async exec(command, opts) {
+        const args = [...buildSshFlags(this.cfg), buildDestination(this.cfg), command];
+        const result = await this.execFn("ssh", args, { timeout: opts?.timeout ?? REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        return result.stdout;
+    }
+    /** Copy a local file or directory to the remote host via scp. */
+    async copyTo(localPath, remotePath) {
+        const flags = buildSshFlags(this.cfg);
+        // scp uses -P (uppercase) instead of -p for port
+        const scpFlags = flags.map((f, i) => (f === "-p" && i > 0 && flags[i - 1] !== "-o") ? "-P" : f);
+        const args = ["-r", ...scpFlags, localPath, `${buildDestination(this.cfg)}:${remotePath}`];
+        await this.execFn("scp", args, { timeout: REMOTE_COPY_TIMEOUT_MS });
+    }
+}
+// ─── Tunnel ─────────────────────────────────────────────────
+/** SSH tunnel that forwards a local port to the remote PowerLine port. */
+class SshTunnel extends ProcessTunnel {
+    cfg;
+    constructor(localPort, cfg, processFactory, portProbe) {
+        super(localPort, undefined, processFactory, portProbe);
+        this.cfg = cfg;
+    }
+    /** Return the ssh command and arguments for the tunnel process. */
+    spawnArgs() {
+        const flags = buildSshFlags(this.cfg);
+        const args = [
+            "-N",
+            "-L", `${this.localPort}:127.0.0.1:${DEFAULT_POWERLINE_PORT}`,
+            "-o", "ExitOnForwardFailure=yes",
+            "-o", "ServerAliveInterval=15",
+            "-o", "ServerAliveCountMax=3",
+            ...flags,
+            buildDestination(this.cfg),
+        ];
+        return { command: "ssh", args };
+    }
+}
+/**
+ * Reverse SSH tunnel: binds a port on the remote host that tunnels back to a local port.
+ * Used so agents (running on the remote host) can reach the Grackle MCP server (on the host).
+ */
+class SshReverseTunnel extends ProcessTunnel {
+    cfg;
+    remotePort;
+    sleepFn;
+    constructor(localPort, remotePort, cfg, sleepFn, processFactory, portProbe) {
+        super(localPort, undefined, processFactory, portProbe);
+        this.cfg = cfg;
+        this.remotePort = remotePort;
+        this.sleepFn = sleepFn;
+    }
+    /** Return the ssh command with -R for reverse port forwarding. */
+    spawnArgs() {
+        const flags = buildSshFlags(this.cfg);
+        const args = [
+            "-N",
+            "-R", `${this.remotePort}:127.0.0.1:${this.localPort}`,
+            "-o", "ExitOnForwardFailure=yes",
+            "-o", "ServerAliveInterval=15",
+            "-o", "ServerAliveCountMax=3",
+            ...flags,
+            buildDestination(this.cfg),
+        ];
+        return { command: "ssh", args };
+    }
+    /**
+     * Reverse tunnels bind on the remote side, not locally.
+     * We can't probe the remote port, so wait a fixed delay for SSH to establish.
+     */
+    async waitForReady() {
+        await this.sleepFn(REVERSE_TUNNEL_SETTLE_MS);
+        if (this.process?.exitCode !== null) {
+            throw new Error(`Reverse tunnel exited immediately with code ${this.process?.exitCode}`);
+        }
+    }
+}
+// ─── Adapter ────────────────────────────────────────────────
+/** Environment adapter that provisions and manages remote environments via SSH. */
+export class SshAdapter {
+    type = "ssh";
+    execFn;
+    sleepFn;
+    isGitHubProviderEnabled;
+    constructor(deps = {}) {
+        this.execFn = deps.exec ?? defaultExec;
+        this.sleepFn = deps.sleep ?? defaultSleep;
+        this.isGitHubProviderEnabled = deps.isGitHubProviderEnabled ?? (() => false);
+    }
+    /** Provision the remote host: test connectivity, bootstrap PowerLine, open tunnel. */
+    async *provision(environmentId, config, powerlineToken) {
+        const cfg = config;
+        if (!cfg.host) {
+            throw new Error("SSH adapter requires a 'host' in the configuration");
+        }
+        const executor = new SshExecutor(cfg, this.execFn);
+        // Test SSH connectivity
+        yield { stage: "connecting", message: `Testing SSH connectivity to ${cfg.host}...`, progress: 0.05 };
+        try {
+            await executor.exec("echo ok", { timeout: SSH_CONNECTIVITY_TIMEOUT_MS });
+        }
+        catch (err) {
+            throw new Error(`Cannot reach ${cfg.host} via SSH: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Bootstrap PowerLine on the remote host
+        yield* bootstrapPowerLine(executor, powerlineToken, {
+            extraEnv: cfg.env,
+            isGitHubProviderEnabled: this.isGitHubProviderEnabled,
+            defaultRuntime: config.defaultRuntime || undefined,
+        });
+        // Open SSH tunnel
+        const localPort = cfg.localPort || await findFreePort();
+        yield { stage: "tunneling", message: `Opening SSH tunnel on local port ${localPort}...`, progress: 0.80 };
+        const tunnel = new SshTunnel(localPort, cfg);
+        await tunnel.open();
+        // Open reverse tunnel (remote → host MCP server) for agent tool calls
+        const mcpPort = parseInt(process.env.GRACKLE_MCP_PORT || String(DEFAULT_MCP_PORT), 10);
+        const reverseTunnel = new SshReverseTunnel(mcpPort, mcpPort, cfg, this.sleepFn);
+        await reverseTunnel.open();
+        registerTunnel(environmentId, { tunnel, reverseTunnel });
+        yield { stage: "connecting", message: `Tunnel open, connecting on port ${localPort}...`, progress: 0.90 };
+    }
+    /**
+     * Attempt fast reconnect: probe PowerLine, restart if needed, re-open tunnel.
+     *
+     * Any failure (SSH unreachable, PowerLine won't start, tunnel error) throws
+     * and falls through to the caller, which should trigger a full provision.
+     *
+     * Minimizes SSH round trips — probe and conditional restart run in a single
+     * SSH call via `startRemotePowerLine({ probeFirst: true })`.
+     */
+    async *reconnect(environmentId, config, powerlineToken) {
+        const cfg = config;
+        if (!cfg.host) {
+            throw new Error("SSH adapter requires a 'host' in the configuration");
+        }
+        const executor = new SshExecutor(cfg, this.execFn);
+        // 1. Close any stale tunnel
+        yield { stage: "reconnecting", message: "Closing stale tunnel...", progress: 0.10 };
+        await closeTunnel(environmentId);
+        // 2. Probe + conditional restart in a single SSH call.
+        yield { stage: "reconnecting", message: `Checking PowerLine on ${cfg.host}...`, progress: 0.30 };
+        const { alreadyRunning } = await startRemotePowerLine(executor, powerlineToken, {
+            extraEnv: cfg.env,
+            probeFirst: true,
+        });
+        if (!alreadyRunning) {
+            yield { stage: "reconnecting", message: "PowerLine restarted", progress: 0.50 };
+        }
+        // 3. Open new SSH tunnel + reverse tunnel for MCP
+        const localPort = cfg.localPort || await findFreePort();
+        yield { stage: "reconnecting", message: `Opening SSH tunnel on local port ${localPort}...`, progress: 0.70 };
+        const tunnel = new SshTunnel(localPort, cfg);
+        await tunnel.open();
+        const mcpPort = parseInt(process.env.GRACKLE_MCP_PORT || String(DEFAULT_MCP_PORT), 10);
+        const reverseTunnel = new SshReverseTunnel(mcpPort, mcpPort, cfg, this.sleepFn);
+        await reverseTunnel.open();
+        registerTunnel(environmentId, { tunnel, reverseTunnel });
+        yield { stage: "reconnecting", message: "Reconnected via SSH", progress: 0.90 };
+    }
+    /** Connect to the PowerLine through the SSH tunnel. */
+    async connect(environmentId, config, powerlineToken) {
+        const state = getTunnel(environmentId);
+        if (!state) {
+            throw new Error(`No tunnel registered for environment ${environmentId}`);
+        }
+        return connectThroughTunnel(environmentId, state.tunnel.localPort, powerlineToken);
+    }
+    /** Close the SSH tunnel without stopping the remote PowerLine. */
+    async disconnect(environmentId) {
+        await closeTunnel(environmentId);
+    }
+    /** Stop the remote PowerLine process and close the tunnel. */
+    async stop(environmentId, config) {
+        const cfg = config;
+        await remoteStop(environmentId, new SshExecutor(cfg, this.execFn));
+    }
+    /** Stop the remote PowerLine, remove artifacts, and close the tunnel. */
+    async destroy(environmentId, config) {
+        const cfg = config;
+        await remoteDestroy(environmentId, new SshExecutor(cfg, this.execFn));
+    }
+    /** Check that the tunnel is alive and the PowerLine responds to a ping. */
+    async healthCheck(connection) {
+        return remoteHealthCheck(connection);
+    }
+}
+//# sourceMappingURL=ssh.js.map

package/dist/ssh.js.map

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

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@grackle-ai/adapter-ssh",
+  "version": "0.72.2",
+  "description": "Grackle SSH environment adapter",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/adapter-ssh"
+  },
+  "keywords": [
+    "grackle",
+    "adapter",
+    "ssh",
+    "environment"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@grackle-ai/adapter-sdk": "0.72.2",
+    "@grackle-ai/common": "0.72.2"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.1.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}