@grackle-ai/adapter-codespace 0.72.2

package/README.md

@@ -0,0 +1,20 @@
+# @grackle-ai/adapter-codespace
+
+Grackle environment adapter for managing GitHub Codespaces.
+
+## Overview
+
+The Codespace adapter provisions PowerLine inside a GitHub Codespace, opens a port-forward tunnel via `gh codespace ports forward`, and a reverse tunnel so remote agents can reach the local MCP server.
+
+## Configuration
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `codespaceName` | `string` | *required* | Codespace name from `gh codespace list` |
+| `localPort` | `number` | auto | Override local tunnel port |
+| `env` | `Record<string, string>` | — | Extra env vars for remote PowerLine |
+
+## Prerequisites
+
+- GitHub CLI (`gh`) installed and authenticated
+- An existing GitHub Codespace

package/dist/codespace.d.ts

@@ -0,0 +1,38 @@
+import type { EnvironmentAdapter, BaseEnvironmentConfig, PowerLineConnection, ProvisionEvent, AdapterDependencies } from "@grackle-ai/adapter-sdk";
+/** GitHub Codespaces-specific environment configuration. */
+export interface CodespaceEnvironmentConfig extends BaseEnvironmentConfig {
+    /** The codespace name from `gh codespace list` (required). */
+    codespaceName: 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 GitHub Codespaces running the PowerLine. */
+export declare class CodespaceAdapter implements EnvironmentAdapter {
+    type: string;
+    private readonly execFn;
+    private readonly sleepFn;
+    private readonly isGitHubProviderEnabled;
+    constructor(deps?: AdapterDependencies);
+    /** Provision the codespace: verify connectivity, bootstrap PowerLine, open port-forward. */
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    /**
+     * Attempt fast reconnect: probe PowerLine, restart if needed, re-open tunnel.
+     */
+    reconnect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    /** Connect to the PowerLine through the port-forward tunnel. */
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    /** Close the port-forward 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 and remove artifacts from the codespace.
+     * This does NOT delete the codespace itself.
+     */
+    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=codespace.d.ts.map

package/dist/codespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codespace.d.ts","sourceRoot":"","sources":["../src/codespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAgB,MAAM,yBAAyB,CAAC;AA8BjK,4DAA4D;AAC5D,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAoHD,+FAA+F;AAC/F,qBAAa,gBAAiB,YAAW,kBAAkB;IAClD,IAAI,EAAE,MAAM,CAAe;IAClC,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,4FAA4F;IAC9E,SAAS,CACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,cAAc,CAAC;IAuDjC;;OAEG;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;IAsCjC,gEAAgE;IACnD,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,2EAA2E;IAC9D,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;;;OAGG;IACU,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/codespace.js

@@ -0,0 +1,213 @@
+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;
+// ─── Executor ───────────────────────────────────────────────
+/** Execute commands inside a GitHub Codespace via the `gh` CLI. */
+class CodespaceExecutor {
+    codespaceName;
+    execFn;
+    constructor(codespaceName, execFn) {
+        this.codespaceName = codespaceName;
+        this.execFn = execFn;
+    }
+    /** Execute a shell command inside the codespace and return trimmed stdout. */
+    async exec(command, opts) {
+        const args = ["codespace", "ssh", "-c", this.codespaceName, "--", command];
+        const result = await this.execFn("gh", args, { timeout: opts?.timeout ?? REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        return result.stdout;
+    }
+    /** Copy a local file or directory into the codespace via `gh codespace cp`. */
+    async copyTo(localPath, remotePath) {
+        // Resolve $HOME since gh codespace cp uses SCP, which doesn't expand shell variables
+        let resolvedPath = remotePath;
+        if (resolvedPath.includes("$HOME")) {
+            const home = (await this.exec("echo $HOME")).trim();
+            resolvedPath = resolvedPath.replace(/\$HOME/g, home);
+        }
+        const args = [
+            "codespace", "cp", "-r", "-e",
+            "-c", this.codespaceName,
+            localPath,
+            `remote:${resolvedPath}`,
+        ];
+        await this.execFn("gh", args, { timeout: REMOTE_COPY_TIMEOUT_MS });
+    }
+}
+// ─── Tunnel ─────────────────────────────────────────────────
+/** Port-forwarding tunnel using `gh codespace ports forward`. */
+class CodespaceTunnel extends ProcessTunnel {
+    codespaceName;
+    constructor(localPort, codespaceName, processFactory, portProbe) {
+        super(localPort, undefined, processFactory, portProbe);
+        this.codespaceName = codespaceName;
+    }
+    /** Return the gh command and arguments for the port-forward process. */
+    spawnArgs() {
+        // gh codespace ports forward uses <remote>:<local> order (opposite of SSH -L)
+        const args = [
+            "codespace", "ports", "forward",
+            `${DEFAULT_POWERLINE_PORT}:${this.localPort}`,
+            "-c", this.codespaceName,
+        ];
+        return { command: "gh", args };
+    }
+}
+/**
+ * Reverse SSH tunnel: binds a port inside the codespace that tunnels back to a local port.
+ * Used so agents (running in the codespace) can reach the Grackle MCP server (on the host).
+ */
+class CodespaceReverseTunnel extends ProcessTunnel {
+    codespaceName;
+    remotePort;
+    sleepFn;
+    constructor(localPort, remotePort, codespaceName, sleepFn, processFactory, portProbe) {
+        super(localPort, undefined, processFactory, portProbe);
+        this.remotePort = remotePort;
+        this.codespaceName = codespaceName;
+        this.sleepFn = sleepFn;
+    }
+    /** Return the gh codespace ssh command with -R for reverse port forwarding. */
+    spawnArgs() {
+        const args = [
+            "codespace", "ssh",
+            "-c", this.codespaceName,
+            "--",
+            "-R", `${this.remotePort}:127.0.0.1:${this.localPort}`,
+            "-N",
+        ];
+        return { command: "gh", 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 GitHub Codespaces running the PowerLine. */
+export class CodespaceAdapter {
+    type = "codespace";
+    execFn;
+    sleepFn;
+    isGitHubProviderEnabled;
+    constructor(deps = {}) {
+        this.execFn = deps.exec ?? defaultExec;
+        this.sleepFn = deps.sleep ?? defaultSleep;
+        this.isGitHubProviderEnabled = deps.isGitHubProviderEnabled ?? (() => false);
+    }
+    /** Provision the codespace: verify connectivity, bootstrap PowerLine, open port-forward. */
+    async *provision(environmentId, config, powerlineToken) {
+        const cfg = config;
+        if (!cfg.codespaceName) {
+            throw new Error("Codespace adapter requires a 'codespaceName' in the configuration");
+        }
+        const executor = new CodespaceExecutor(cfg.codespaceName, this.execFn);
+        // Test codespace connectivity
+        yield { stage: "connecting", message: `Connecting to codespace ${cfg.codespaceName}...`, progress: 0.05 };
+        try {
+            await executor.exec("echo ok", { timeout: SSH_CONNECTIVITY_TIMEOUT_MS });
+        }
+        catch (err) {
+            throw new Error(`Cannot reach codespace '${cfg.codespaceName}' via gh CLI: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Detect the repo working directory (codespaces clone to /workspaces/<name>)
+        let workingDirectory;
+        try {
+            const workspaceDir = (await executor.exec("ls -d /workspaces/*/ 2>/dev/null | head -1", { timeout: SSH_CONNECTIVITY_TIMEOUT_MS })).trim().replace(/\/$/, "");
+            if (workspaceDir) {
+                workingDirectory = workspaceDir;
+            }
+        }
+        catch {
+            // Non-fatal — fall back to PowerLine directory
+        }
+        // Bootstrap PowerLine on the codespace
+        yield* bootstrapPowerLine(executor, powerlineToken, {
+            extraEnv: cfg.env,
+            workingDirectory,
+            isGitHubProviderEnabled: this.isGitHubProviderEnabled,
+            defaultRuntime: config.defaultRuntime || undefined,
+        });
+        // Open port-forward tunnel (host → codespace PowerLine)
+        const localPort = cfg.localPort || await findFreePort();
+        yield { stage: "tunneling", message: `Forwarding local port ${localPort} to codespace...`, progress: 0.80 };
+        const tunnel = new CodespaceTunnel(localPort, cfg.codespaceName);
+        await tunnel.open();
+        // Open reverse tunnel (codespace → host MCP server) for agent tool calls
+        const mcpPort = parseInt(process.env.GRACKLE_MCP_PORT || String(DEFAULT_MCP_PORT), 10);
+        const reverseTunnel = new CodespaceReverseTunnel(mcpPort, mcpPort, cfg.codespaceName, 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.
+     */
+    async *reconnect(environmentId, config, powerlineToken) {
+        const cfg = config;
+        if (!cfg.codespaceName) {
+            throw new Error("Codespace adapter requires a 'codespaceName' in the configuration");
+        }
+        const executor = new CodespaceExecutor(cfg.codespaceName, 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.codespaceName}...`, progress: 0.30 };
+        const { alreadyRunning } = await startRemotePowerLine(executor, powerlineToken, {
+            extraEnv: cfg.env,
+            autoDetectWorkspace: true,
+            probeFirst: true,
+        });
+        if (!alreadyRunning) {
+            yield { stage: "reconnecting", message: "PowerLine restarted", progress: 0.50 };
+        }
+        // 3. Open new port-forward tunnel + reverse tunnel for MCP
+        const localPort = cfg.localPort || await findFreePort();
+        yield { stage: "reconnecting", message: `Forwarding local port ${localPort} to codespace...`, progress: 0.70 };
+        const tunnel = new CodespaceTunnel(localPort, cfg.codespaceName);
+        await tunnel.open();
+        const mcpPort = parseInt(process.env.GRACKLE_MCP_PORT || String(DEFAULT_MCP_PORT), 10);
+        const reverseTunnel = new CodespaceReverseTunnel(mcpPort, mcpPort, cfg.codespaceName, this.sleepFn);
+        await reverseTunnel.open();
+        registerTunnel(environmentId, { tunnel, reverseTunnel });
+        yield { stage: "reconnecting", message: "Reconnected to codespace", progress: 0.90 };
+    }
+    /** Connect to the PowerLine through the port-forward 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 port-forward 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 CodespaceExecutor(cfg.codespaceName, this.execFn));
+    }
+    /**
+     * Stop the remote PowerLine and remove artifacts from the codespace.
+     * This does NOT delete the codespace itself.
+     */
+    async destroy(environmentId, config) {
+        const cfg = config;
+        await remoteDestroy(environmentId, new CodespaceExecutor(cfg.codespaceName, this.execFn));
+    }
+    /** Check that the tunnel is alive and the PowerLine responds to a ping. */
+    async healthCheck(connection) {
+        return remoteHealthCheck(connection);
+    }
+}
+//# sourceMappingURL=codespace.js.map

package/dist/codespace.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { CodespaceAdapter } from "./codespace.js";
+export type { CodespaceEnvironmentConfig } from "./codespace.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,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { CodespaceAdapter } from "./codespace.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,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

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,44 @@
+{
+  "name": "@grackle-ai/adapter-codespace",
+  "version": "0.72.2",
+  "description": "Grackle GitHub Codespace environment adapter",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/adapter-codespace"
+  },
+  "keywords": [
+    "grackle",
+    "adapter",
+    "codespace",
+    "github",
+    "environment"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@grackle-ai/common": "0.72.2",
+    "@grackle-ai/adapter-sdk": "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"
+  }
+}