@grackle-ai/adapter-sdk 0.36.0

package/dist/adapter.d.ts

@@ -0,0 +1,51 @@
+import type { Client } from "@connectrpc/connect";
+import type { powerline } from "@grackle-ai/common";
+import type { AdapterLogger } from "./logger.js";
+/** Type-safe ConnectRPC client for the PowerLine gRPC service. */
+export type PowerLineClient = Client<typeof powerline.GracklePowerLine>;
+/** An active connection to a PowerLine, including the gRPC client and port info. */
+export interface PowerLineConnection {
+    client: PowerLineClient;
+    environmentId: string;
+    port: number;
+}
+/** Progress event emitted during environment provisioning. */
+export interface ProvisionEvent {
+    stage: string;
+    message: string;
+    progress: number;
+}
+/** Base configuration shared by all environment adapters. */
+export interface BaseEnvironmentConfig {
+    /** Override the default PowerLine port. */
+    port?: number;
+    /** Override the host to connect to. */
+    host?: string;
+}
+/** Contract that all environment adapter backends must implement. */
+export interface EnvironmentAdapter {
+    type: string;
+    /** Provision infrastructure and yield progress events. */
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    /** Establish a gRPC connection to the PowerLine running in the environment. */
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    /** Release resources associated with a connection without stopping the environment. */
+    disconnect(environmentId: string): Promise<void>;
+    /** Stop the environment's underlying compute (e.g. stop a Docker container). */
+    stop(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /** Permanently destroy the environment's underlying compute. */
+    destroy(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /** Return true if the PowerLine is reachable via ping. */
+    healthCheck(connection: PowerLineConnection): Promise<boolean>;
+    /** Attempt fast reconnect without re-bootstrapping. Throws if PowerLine cannot be restarted. */
+    reconnect?(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+}
+/**
+ * Try fast reconnect if the adapter supports it and the environment was
+ * previously bootstrapped, falling back to full provision on any error.
+ *
+ * Yields {@link ProvisionEvent}s from whichever path runs, allowing callers
+ * (gRPC streaming and WebSocket broadcast) to forward them uniformly.
+ */
+export declare function reconnectOrProvision(environmentId: string, adapter: EnvironmentAdapter, config: Record<string, unknown>, powerlineToken: string, bootstrapped: boolean, logger?: AdapterLogger): AsyncGenerator<ProvisionEvent>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAExE,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,0DAA0D;IAC1D,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAC1H,+EAA+E;IAC/E,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtH,uFAAuF;IACvF,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gFAAgF;IAChF,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,gEAAgE;IAChE,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,0DAA0D;IAC1D,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,gGAAgG;IAChG,SAAS,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;CAC5H;AAED;;;;;;GAMG;AACH,wBAAuB,oBAAoB,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,OAAO,EACrB,MAAM,GAAE,aAA6B,GACpC,cAAc,CAAC,cAAc,CAAC,CAahC"}

package/dist/adapter.js

@@ -0,0 +1,24 @@
+import { defaultLogger } from "./logger.js";
+/**
+ * Try fast reconnect if the adapter supports it and the environment was
+ * previously bootstrapped, falling back to full provision on any error.
+ *
+ * Yields {@link ProvisionEvent}s from whichever path runs, allowing callers
+ * (gRPC streaming and WebSocket broadcast) to forward them uniformly.
+ */
+export async function* reconnectOrProvision(environmentId, adapter, config, powerlineToken, bootstrapped, logger = defaultLogger) {
+    let reconnected = false;
+    if (bootstrapped && adapter.reconnect) {
+        try {
+            yield* adapter.reconnect(environmentId, config, powerlineToken);
+            reconnected = true;
+        }
+        catch (err) {
+            logger.info({ environmentId, err }, "Reconnect failed, falling back to full provision");
+        }
+    }
+    if (!reconnected) {
+        yield* adapter.provision(environmentId, config, powerlineToken);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA+C5C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,oBAAoB,CACzC,aAAqB,EACrB,OAA2B,EAC3B,MAA+B,EAC/B,cAAsB,EACtB,YAAqB,EACrB,SAAwB,aAAa;IAErC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;YAChE,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,kDAAkD,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,89 @@
+import type { ProvisionEvent } from "./adapter.js";
+import type { RemoteExecutor } from "./remote-executor.js";
+import type { AdapterLogger } from "./logger.js";
+/**
+ * Write the environment variable file to the remote PowerLine directory.
+ * Used during both initial bootstrap and reconnect (tokens may have rotated).
+ */
+export declare function writeRemoteEnvFile(executor: RemoteExecutor, powerlineToken: string, extraEnv?: Record<string, string>, logger?: AdapterLogger): Promise<void>;
+/**
+ * Probe whether the remote PowerLine is listening on its port.
+ * Throws if the port is not reachable.
+ */
+export declare function probeRemotePowerLine(executor: RemoteExecutor): Promise<void>;
+/**
+ * Build a shell command that kills the remote PowerLine process.
+ * Prefers killing by tracked PID (written at startup) to avoid terminating
+ * unrelated services on the same port. Falls back to port-based kill.
+ */
+export declare function buildRemoteKillCommand(): string;
+/** Options for {@link startRemotePowerLine}. */
+export interface StartRemotePowerLineOptions {
+    /** Additional environment variables forwarded to the remote PowerLine. */
+    extraEnv?: Record<string, string>;
+    /** Explicit working directory for the PowerLine process. */
+    workingDirectory?: string;
+    /**
+     * Host address to bind the PowerLine to. Defaults to unset (PowerLine's
+     * own default, 127.0.0.1). Use "0.0.0.0" for Docker containers where
+     * the port is accessed via Docker's port mapping.
+     */
+    host?: string;
+    /**
+     * When true, detects `/workspaces/*\/` on the remote host (codespace
+     * convention) and uses it as the working directory.
+     */
+    autoDetectWorkspace?: boolean;
+    /**
+     * When true, the compound script starts with a TCP probe and exits
+     * immediately if PowerLine is already listening. This avoids a separate
+     * SSH round trip for the initial health check.
+     */
+    probeFirst?: boolean;
+    /** Logger for diagnostic output. */
+    logger?: AdapterLogger;
+}
+/**
+ * Ensure the remote PowerLine process is running.
+ *
+ * Batches env-var write, process start, and port probe into a **single SSH
+ * call** to minimize per-call latency (each `gh codespace ssh` round trip
+ * takes ~10-15 s through GitHub's relay).
+ *
+ * Uses Node's `spawn({ detached: true })` to properly daemonize the
+ * PowerLine process, avoiding the SSH-hanging issue where `nohup ... &`
+ * keeps the session alive through GitHub's codespace relay.
+ *
+ * When `probeFirst` is true the script begins with a TCP port check and
+ * returns immediately if PowerLine is already listening, combining the
+ * "is it alive?" check and the "start if not" logic into one SSH call.
+ *
+ * This is the "restart" middle path — it assumes code is already installed
+ * and skips npm install, git checks, and artifact copies.
+ */
+export declare function startRemotePowerLine(executor: RemoteExecutor, powerlineToken: string, options?: StartRemotePowerLineOptions): Promise<{
+    alreadyRunning: boolean;
+}>;
+/** Options for {@link bootstrapPowerLine}. */
+export interface BootstrapOptions {
+    /** Additional environment variables forwarded to the remote PowerLine. */
+    extraEnv?: Record<string, string>;
+    /** Explicit working directory for the PowerLine process. */
+    workingDirectory?: string;
+    /**
+     * Host address to bind the PowerLine to. Defaults to unset (PowerLine's
+     * own default, 127.0.0.1). Use "0.0.0.0" for Docker containers where
+     * the port is accessed via Docker's port mapping.
+     */
+    host?: string;
+    /** Logger for diagnostic output. */
+    logger?: AdapterLogger;
+    /** Callback to check whether the GitHub credential provider is enabled. */
+    isGitHubProviderEnabled?: () => boolean;
+}
+/**
+ * Bootstrap the PowerLine on a remote host via the given executor.
+ * Yields progress events for each stage of the process.
+ */
+export declare function bootstrapPowerLine(executor: RemoteExecutor, powerlineToken: string, options?: BootstrapOptions): AsyncGenerator<ProvisionEvent>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoDjD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAef;AAUD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAmB/C;AAID,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAoBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC,CA0FtC;AAID,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,2EAA2E;IAC3E,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAuB,kBAAkB,CACvC,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CAAC,cAAc,CAAC,CAyLhC"}

package/dist/bootstrap.js

@@ -0,0 +1,322 @@
+import { DEFAULT_POWERLINE_PORT } from "@grackle-ai/common";
+import { defaultLogger } from "./logger.js";
+import { REMOTE_POWERLINE_DIRECTORY, REMOTE_EXEC_DEFAULT_TIMEOUT_MS, SSH_CONNECTIVITY_TIMEOUT_MS, sleep, isDevMode, getPackageVersion, shellEscape, } from "./utils.js";
+import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+// ─── Constants ──────────────────────────────────────────────
+/** Timeout for `npm install` on the remote host. */
+const BOOTSTRAP_NPM_INSTALL_TIMEOUT_MS = 120_000;
+/** Wait after starting the remote PowerLine process before verifying. */
+const POWERLINE_STARTUP_DELAY_MS = 2_000;
+// ─── Env File Helpers ───────────────────────────────────────
+/** Regex for valid POSIX environment variable names. */
+const ENV_VAR_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * Build the list of env-file lines for the PowerLine process.
+ * Pure helper used by both {@link writeRemoteEnvFile} and {@link startRemotePowerLine}.
+ */
+function writeRemoteEnvFileLines(powerlineToken, extraEnv, logger = defaultLogger) {
+    const envLines = [];
+    if (powerlineToken) {
+        envLines.push(`export GRACKLE_POWERLINE_TOKEN='${shellEscape(powerlineToken)}'`);
+    }
+    if (extraEnv) {
+        for (const [key, value] of Object.entries(extraEnv)) {
+            if (!ENV_VAR_NAME_PATTERN.test(key)) {
+                logger.warn({ key }, "Skipping invalid env var name");
+                continue;
+            }
+            envLines.push(`export ${key}='${shellEscape(value)}'`);
+        }
+    }
+    return envLines;
+}
+/**
+ * Write the environment variable file to the remote PowerLine directory.
+ * Used during both initial bootstrap and reconnect (tokens may have rotated).
+ */
+export async function writeRemoteEnvFile(executor, powerlineToken, extraEnv, logger = defaultLogger) {
+    const envLines = writeRemoteEnvFileLines(powerlineToken, extraEnv, logger);
+    if (envLines.length === 0) {
+        return;
+    }
+    const envFileContent = envLines.join("\n") + "\n";
+    const envFileContentBase64 = Buffer.from(envFileContent, "utf8").toString("base64");
+    await executor.exec(`cd ${REMOTE_POWERLINE_DIRECTORY} && node -e "require('fs').writeFileSync('.env.sh',Buffer.from(process.argv[1],'base64').toString('utf8'))" '${shellEscape(envFileContentBase64)}'`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+    await executor.exec(`chmod 600 ${REMOTE_POWERLINE_DIRECTORY}/.env.sh`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+}
+// ─── Remote Probe ───────────────────────────────────────────
+/** Node.js one-liner that probes the PowerLine port and exits 0/1. */
+const PROBE_SCRIPT = `node -e "const s=require('net').createConnection(${DEFAULT_POWERLINE_PORT},'127.0.0.1');`
+    + `s.on('connect',()=>{s.destroy();process.exit(0)});`
+    + `s.on('error',()=>process.exit(1))"`;
+/**
+ * Probe whether the remote PowerLine is listening on its port.
+ * Throws if the port is not reachable.
+ */
+export async function probeRemotePowerLine(executor) {
+    await executor.exec(PROBE_SCRIPT, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+}
+// ─── Remote Kill ────────────────────────────────────────────
+/**
+ * Build a shell command that kills the remote PowerLine process.
+ * Prefers killing by tracked PID (written at startup) to avoid terminating
+ * unrelated services on the same port. Falls back to port-based kill.
+ */
+export function buildRemoteKillCommand() {
+    const pidfile = `${REMOTE_POWERLINE_DIRECTORY}/powerline.pid`;
+    // Try pidfile-based kill first (safe — only kills what we started)
+    const pidfileKill = [
+        `[ -f "${pidfile}" ]`,
+        `PID=$(cat "${pidfile}" 2>/dev/null)`,
+        `[ -n "$PID" ]`,
+        `kill "$PID" 2>/dev/null`,
+        `rm -f "${pidfile}"`,
+    ].join(" && ");
+    // Fallback: port-based kill (for upgrades from before pidfile support)
+    const portKill = `fuser -k ${DEFAULT_POWERLINE_PORT}/tcp 2>/dev/null`
+        + ` || lsof -ti:${DEFAULT_POWERLINE_PORT} | xargs kill 2>/dev/null`
+        + ` || pkill -f "powerline.*${DEFAULT_POWERLINE_PORT}" 2>/dev/null`;
+    return `(${pidfileKill}) || (${portKill}) || true`;
+}
+/** Validate and build the node one-liner that spawns a fully detached PowerLine process. */
+function buildSpawnScript(host) {
+    if (host && !/^[\d.a-zA-Z:]+$/.test(host)) {
+        throw new Error(`Invalid host address: ${host}`);
+    }
+    const hostArg = host ? `,'--host=${host}'` : "";
+    return (`node -e "`
+        + `const fs=require('fs');`
+        + `const {spawn}=require('child_process');`
+        + `const out=fs.openSync(process.argv[3],'w');`
+        + `const c=spawn('node',[process.argv[1],'--port=${DEFAULT_POWERLINE_PORT}'${hostArg}],`
+        + `{cwd:process.cwd(),detached:true,stdio:['ignore',out,out]});`
+        + `fs.writeFileSync(process.argv[2],String(c.pid));`
+        + `c.unref();"`);
+}
+/**
+ * Ensure the remote PowerLine process is running.
+ *
+ * Batches env-var write, process start, and port probe into a **single SSH
+ * call** to minimize per-call latency (each `gh codespace ssh` round trip
+ * takes ~10-15 s through GitHub's relay).
+ *
+ * Uses Node's `spawn({ detached: true })` to properly daemonize the
+ * PowerLine process, avoiding the SSH-hanging issue where `nohup ... &`
+ * keeps the session alive through GitHub's codespace relay.
+ *
+ * When `probeFirst` is true the script begins with a TCP port check and
+ * returns immediately if PowerLine is already listening, combining the
+ * "is it alive?" check and the "start if not" logic into one SSH call.
+ *
+ * This is the "restart" middle path — it assumes code is already installed
+ * and skips npm install, git checks, and artifact copies.
+ */
+export async function startRemotePowerLine(executor, powerlineToken, options = {}) {
+    const { extraEnv, workingDirectory, host, autoDetectWorkspace, probeFirst, logger = defaultLogger } = options;
+    // Validate workingDirectory to prevent shell injection — must be an absolute POSIX path
+    if (workingDirectory && !/^\/[\w./-]+$/.test(workingDirectory)) {
+        throw new Error(`Invalid working directory: ${workingDirectory}`);
+    }
+    const envLines = writeRemoteEnvFileLines(powerlineToken, extraEnv, logger);
+    const devMode = isDevMode();
+    const entryPoint = devMode
+        ? "dist/index.js"
+        : "node_modules/@grackle-ai/powerline/dist/index.js";
+    const absoluteEntryPoint = `${REMOTE_POWERLINE_DIRECTORY}/${entryPoint}`;
+    const logFilePath = "$HOME/.grackle/powerline.log";
+    const pidFilePath = `${REMOTE_POWERLINE_DIRECTORY}/powerline.pid`;
+    // Build a compound script that runs in a single SSH call:
+    //   0. (Optional) Probe — exit early if already listening
+    //   1. Write env file (base64 → file)
+    //   2. Detect working directory (optional)
+    //   3. Source env + spawn PowerLine (detached, exits immediately)
+    //   4. Brief sleep + probe
+    const parts = [];
+    // 0. Early-exit probe (saves work when PowerLine is already running).
+    let probeFirstPrefix = "";
+    if (probeFirst) {
+        probeFirstPrefix = `${PROBE_SCRIPT} && echo "__PL_ALIVE__" && exit 0; `;
+    }
+    // 1. Env file
+    if (envLines.length > 0) {
+        const envFileContent = envLines.join("\n") + "\n";
+        const envFileContentBase64 = Buffer.from(envFileContent, "utf8").toString("base64");
+        parts.push(`cd ${REMOTE_POWERLINE_DIRECTORY}`
+            + ` && node -e "require('fs').writeFileSync('.env.sh',Buffer.from(process.argv[1],'base64').toString('utf8'))"`
+            + ` '${shellEscape(envFileContentBase64)}'`
+            + ` && chmod 600 .env.sh`);
+    }
+    // 2. Working directory
+    let startDirExpr;
+    if (workingDirectory) {
+        startDirExpr = workingDirectory;
+    }
+    else if (autoDetectWorkspace) {
+        parts.push(`WD=$(ls -d /workspaces/*/ 2>/dev/null | head -1 | sed "s/\\/$//");`
+            + ` WD=\${WD:-${REMOTE_POWERLINE_DIRECTORY}}`);
+        startDirExpr = "$WD";
+    }
+    else {
+        startDirExpr = REMOTE_POWERLINE_DIRECTORY;
+    }
+    // 3. Source env vars and spawn PowerLine as a detached process.
+    const sourceEnv = envLines.length > 0
+        ? `. ${REMOTE_POWERLINE_DIRECTORY}/.env.sh && `
+        : "";
+    parts.push(`cd "${startDirExpr}" && ${sourceEnv}`
+        + `${buildSpawnScript(host)} "${absoluteEntryPoint}" "${pidFilePath}" "${logFilePath}"`);
+    // 4. Probe (after a brief pause for the port to bind)
+    parts.push(`sleep ${POWERLINE_STARTUP_DELAY_MS / 1000} && ${PROBE_SCRIPT}`);
+    const compoundScript = probeFirstPrefix + parts.join(" && ");
+    try {
+        const stdout = await executor.exec(`bash -c '${shellEscape(compoundScript)}'`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        if (probeFirst && stdout.includes("__PL_ALIVE__")) {
+            logger.info({ port: DEFAULT_POWERLINE_PORT }, "Remote PowerLine was already running");
+            return { alreadyRunning: true };
+        }
+        logger.info({ port: DEFAULT_POWERLINE_PORT }, "Remote PowerLine is listening");
+        return { alreadyRunning: false };
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        logger.info({ detail }, "Failed to start remote PowerLine");
+        throw new Error(`PowerLine process died immediately after starting. Check ~/.grackle/powerline.log on the remote host. Cause: ${detail}`);
+    }
+}
+/**
+ * Bootstrap the PowerLine on a remote host via the given executor.
+ * Yields progress events for each stage of the process.
+ */
+export async function* bootstrapPowerLine(executor, powerlineToken, options = {}) {
+    const { extraEnv, workingDirectory, host, logger = defaultLogger, isGitHubProviderEnabled, } = options;
+    // 1. Check Node.js (PowerLine requires >= 22)
+    yield { stage: "bootstrapping", message: "Checking Node.js on remote host...", progress: 0.10 };
+    try {
+        const nodeVersionOutput = await executor.exec("node --version", { timeout: SSH_CONNECTIVITY_TIMEOUT_MS });
+        const nodeVersion = String(nodeVersionOutput).trim();
+        logger.info({ nodeVersion }, "Remote Node.js version");
+        const versionMatch = nodeVersion.match(/^v?(\d+)\./);
+        if (!versionMatch) {
+            throw new Error(`Unable to parse Node.js version "${nodeVersion}" on remote host. Install Node.js >= 22 and try again.`);
+        }
+        const majorVersion = parseInt(versionMatch[1], 10);
+        if (isNaN(majorVersion) || majorVersion < 22) {
+            throw new Error(`Unsupported Node.js version "${nodeVersion}" on remote host. PowerLine requires Node.js >= 22.`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error
+            && (error.message.startsWith("Unable to parse Node.js version")
+                || error.message.startsWith("Unsupported Node.js version"))) {
+            throw error;
+        }
+        throw new Error("Node.js is not installed or not accessible on the remote host. Install Node.js >= 22 and try again.");
+    }
+    // 2. Check git
+    yield { stage: "bootstrapping", message: "Checking git on remote host...", progress: 0.15 };
+    try {
+        await executor.exec("git --version", { timeout: SSH_CONNECTIVITY_TIMEOUT_MS });
+    }
+    catch {
+        throw new Error("git is not installed on the remote host. Install git and try again.");
+    }
+    // 2.5. Capture GITHUB_TOKEN from remote host for git push connectivity.
+    let enrichedExtraEnv = extraEnv;
+    const hasLocalToken = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+    const hasAdapterToken = extraEnv?.GITHUB_TOKEN || extraEnv?.GH_TOKEN;
+    const githubProviderEnabled = isGitHubProviderEnabled ? isGitHubProviderEnabled() : false;
+    if (githubProviderEnabled && !hasLocalToken && !hasAdapterToken) {
+        try {
+            const remoteToken = (await executor.exec(`(grep -m1 '^GITHUB_TOKEN=' /workspaces/.codespaces/shared/.env 2>/dev/null | cut -d= -f2- || grep -m1 '^GH_TOKEN=' /workspaces/.codespaces/shared/.env 2>/dev/null | cut -d= -f2- || printenv GITHUB_TOKEN 2>/dev/null || printenv GH_TOKEN 2>/dev/null || true)`, { timeout: SSH_CONNECTIVITY_TIMEOUT_MS })).trim();
+            if (remoteToken) {
+                enrichedExtraEnv = { ...extraEnv, GITHUB_TOKEN: remoteToken };
+                logger.info({}, "Captured GITHUB_TOKEN from remote host for agent git operations");
+            }
+        }
+        catch {
+            logger.debug({}, "Could not read GITHUB_TOKEN from remote host");
+        }
+    }
+    // 3. Install PowerLine — dev mode (copy artifacts) vs production (npm install)
+    const devMode = isDevMode();
+    if (devMode) {
+        // ── Dev mode: copy local monorepo artifacts ──
+        yield { stage: "bootstrapping", message: "Creating remote directories...", progress: 0.20 };
+        await executor.exec(`mkdir -p ${REMOTE_POWERLINE_DIRECTORY}/node_modules/@grackle-ai/common`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        // Resolve local artifact paths relative to adapter-sdk's built location.
+        // import.meta.dirname = packages/adapter-sdk/dist → up 2 levels → packages/
+        const sdkDistDir = resolve(import.meta.dirname);
+        const commonPackageDir = resolve(sdkDistDir, "../../common");
+        const powerlinePackageDir = resolve(sdkDistDir, "../../powerline");
+        const mcpPackageDir = resolve(sdkDistDir, "../../mcp");
+        yield { stage: "bootstrapping", message: "Copying PowerLine artifacts...", progress: 0.25 };
+        await executor.copyTo(join(powerlinePackageDir, "dist"), `${REMOTE_POWERLINE_DIRECTORY}/dist`);
+        await executor.copyTo(join(powerlinePackageDir, "package.json"), `${REMOTE_POWERLINE_DIRECTORY}/package.json`);
+        // Collect non-workspace deps from @grackle-ai/common and @grackle-ai/mcp
+        const extraDeps = {};
+        for (const dir of [commonPackageDir, mcpPackageDir]) {
+            const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+            for (const [k, v] of Object.entries(pkg.dependencies || {})) {
+                if (!k.startsWith("@grackle-ai/")) {
+                    extraDeps[k] = v;
+                }
+            }
+        }
+        // Strip @grackle-ai/* workspace deps, merge in common/mcp deps, then npm install once.
+        yield { stage: "bootstrapping", message: "Installing dependencies on remote host...", progress: 0.40 };
+        const extraDepsJson = JSON.stringify(extraDeps).replace(/'/g, "'\\''");
+        await executor.exec(`cd ${REMOTE_POWERLINE_DIRECTORY} && node -e "`
+            + `const p=JSON.parse(require('fs').readFileSync('package.json','utf8'));`
+            + `for(const k of Object.keys(p.dependencies||{})){if(k.startsWith('@grackle-ai/'))delete p.dependencies[k];}`
+            + `for(const k of Object.keys(p.devDependencies||{})){if(k.startsWith('@grackle-ai/'))delete p.devDependencies[k];}`
+            + `Object.assign(p.dependencies||{},JSON.parse(process.argv[1]));`
+            + `require('fs').writeFileSync('package.json',JSON.stringify(p,null,2));" '${extraDepsJson}'`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        await executor.exec(`cd ${REMOTE_POWERLINE_DIRECTORY} && npm install --omit=dev --legacy-peer-deps --registry=https://registry.npmjs.org`, { timeout: BOOTSTRAP_NPM_INSTALL_TIMEOUT_MS });
+        // Copy @grackle-ai/* packages AFTER all npm installs (npm wipes unmanaged dirs)
+        for (const [name, dir] of [["common", commonPackageDir], ["mcp", mcpPackageDir]]) {
+            const remotePkgDir = `${REMOTE_POWERLINE_DIRECTORY}/node_modules/@grackle-ai/${name}`;
+            yield { stage: "bootstrapping", message: `Copying @grackle-ai/${name}...`, progress: name === "common" ? 0.57 : 0.59 };
+            await executor.exec(`mkdir -p ${remotePkgDir}`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+            await executor.copyTo(join(dir, "dist"), `${remotePkgDir}/dist`);
+            await executor.copyTo(join(dir, "package.json"), `${remotePkgDir}/package.json`);
+        }
+    }
+    else {
+        // ── Production mode: npm install from registry ──
+        const version = getPackageVersion();
+        yield { stage: "bootstrapping", message: "Creating remote directories...", progress: 0.20 };
+        await executor.exec(`mkdir -p ${REMOTE_POWERLINE_DIRECTORY}`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        yield { stage: "bootstrapping", message: `Installing @grackle-ai/powerline@${version}...`, progress: 0.25 };
+        await executor.exec(`cd ${REMOTE_POWERLINE_DIRECTORY} && npm init -y && npm install @grackle-ai/powerline@${version} --omit=dev --legacy-peer-deps --registry=https://registry.npmjs.org`, { timeout: BOOTSTRAP_NPM_INSTALL_TIMEOUT_MS });
+    }
+    logger.info({ devMode }, "PowerLine bootstrap mode");
+    // 4. Configure git credential helper so agents can push to GitHub.
+    yield { stage: "bootstrapping", message: "Configuring git credentials...", progress: 0.56 };
+    try {
+        const credHelperScript = '#!/bin/sh\ntest "$1" = get || exit 0\necho "username=x-access-token"\necho "password=${GITHUB_TOKEN:-$GH_TOKEN}"\n';
+        const credHelperBase64 = Buffer.from(credHelperScript, "utf8").toString("base64");
+        const credHelperPath = `${REMOTE_POWERLINE_DIRECTORY}/git-credential-github.sh`;
+        await executor.exec(`node -e "require('fs').writeFileSync(process.argv[1],Buffer.from(process.argv[2],'base64').toString('utf8'),{mode:0o755})" `
+            + `"${credHelperPath}" '${credHelperBase64}'`
+            + ` && git config --global credential.helper "${credHelperPath}"`, { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        logger.info({ path: credHelperPath }, "Git credential helper configured");
+    }
+    catch (err) {
+        logger.warn({ err }, "Failed to configure git credential helper (agents may be unable to push)");
+    }
+    // 5. Kill any existing PowerLine process on the port (with fallbacks)
+    yield { stage: "bootstrapping", message: "Stopping any existing PowerLine process...", progress: 0.60 };
+    try {
+        await executor.exec(buildRemoteKillCommand(), { timeout: REMOTE_EXEC_DEFAULT_TIMEOUT_MS });
+        await sleep(1_000);
+    }
+    catch {
+        // Ignore — no process to kill
+    }
+    // 6–8. Write env vars, start process, wait, verify
+    yield { stage: "bootstrapping", message: "Starting PowerLine on remote host...", progress: 0.65 };
+    await startRemotePowerLine(executor, powerlineToken, { extraEnv: enrichedExtraEnv, workingDirectory, host, logger });
+    yield { stage: "bootstrapping", message: "PowerLine is running on remote host", progress: 0.75 };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/connect.d.ts

@@ -0,0 +1,18 @@
+import type { PowerLineClient, PowerLineConnection } from "./adapter.js";
+import type { AdapterLogger } from "./logger.js";
+/**
+ * Create an authenticated gRPC client for a PowerLine.
+ * The PowerLine token is sent as a Bearer token on every request.
+ */
+export declare function createPowerLineClient(baseUrl: string, powerlineToken: string): PowerLineClient;
+/**
+ * Connect to a PowerLine through a local tunnel port, retrying until the gRPC
+ * service responds to a ping.
+ */
+export declare function connectThroughTunnel(environmentId: string, localPort: number, powerlineToken: string, logger?: AdapterLogger): Promise<PowerLineConnection>;
+/**
+ * Poll until a TCP connection can be established on localhost at the given port.
+ * Used to wait for a tunnel process to begin accepting connections.
+ */
+export declare function waitForLocalPort(port: number): Promise<void>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmBjD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,eAAe,CAa9F;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;AAID;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBlE"}

package/dist/connect.js

@@ -0,0 +1,88 @@
+import { createClient } from "@connectrpc/connect";
+import { createGrpcTransport } from "@connectrpc/connect-node";
+import { powerline } from "@grackle-ai/common";
+import { createConnection } from "node:net";
+import { closeTunnel } from "./tunnel-registry.js";
+import { sleep } from "./utils.js";
+import { defaultLogger } from "./logger.js";
+// ─── Constants ──────────────────────────────────────────────
+/** Delay between gRPC connect-with-retry attempts. */
+const CONNECT_RETRY_DELAY_MS = 1_500;
+/** Maximum number of gRPC connect-with-retry attempts. */
+const CONNECT_MAX_RETRIES = 10;
+/** Delay between port availability polls. */
+const TUNNEL_PORT_POLL_DELAY_MS = 500;
+/** Maximum number of port availability polls. */
+const TUNNEL_PORT_POLL_MAX_ATTEMPTS = 20;
+// ─── PowerLine Client ───────────────────────────────────────
+/**
+ * Create an authenticated gRPC client for a PowerLine.
+ * The PowerLine token is sent as a Bearer token on every request.
+ */
+export function createPowerLineClient(baseUrl, powerlineToken) {
+    const transport = createGrpcTransport({
+        baseUrl,
+        interceptors: powerlineToken
+            ? [
+                (next) => async (req) => {
+                    req.header.set("Authorization", `Bearer ${powerlineToken}`);
+                    return next(req);
+                },
+            ]
+            : [],
+    });
+    return createClient(powerline.GracklePowerLine, transport);
+}
+// ─── Connect Through Tunnel ─────────────────────────────────
+/**
+ * Connect to a PowerLine through a local tunnel port, retrying until the gRPC
+ * service responds to a ping.
+ */
+export async function connectThroughTunnel(environmentId, localPort, powerlineToken, logger = defaultLogger) {
+    const client = createPowerLineClient(`http://127.0.0.1:${localPort}`, powerlineToken);
+    let lastError;
+    for (let attempt = 0; attempt < CONNECT_MAX_RETRIES; attempt++) {
+        try {
+            await client.ping({});
+            return { client, environmentId, port: localPort };
+        }
+        catch (err) {
+            lastError = err;
+            await sleep(CONNECT_RETRY_DELAY_MS);
+        }
+    }
+    // Clean up the tunnel so we don't leak background processes on connect failure
+    try {
+        await closeTunnel(environmentId);
+    }
+    catch (err) {
+        logger.error({ environmentId, err }, "Failed to close tunnel after connect failure");
+    }
+    throw new Error(`Could not reach PowerLine after ${CONNECT_MAX_RETRIES} attempts: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+}
+// ─── Wait for Local Port ────────────────────────────────────
+/**
+ * Poll until a TCP connection can be established on localhost at the given port.
+ * Used to wait for a tunnel process to begin accepting connections.
+ */
+export async function waitForLocalPort(port) {
+    for (let attempt = 0; attempt < TUNNEL_PORT_POLL_MAX_ATTEMPTS; attempt++) {
+        const reachable = await new Promise((resolve) => {
+            const socket = createConnection({ host: "127.0.0.1", port });
+            socket.once("connect", () => {
+                socket.destroy();
+                resolve(true);
+            });
+            socket.once("error", () => {
+                socket.destroy();
+                resolve(false);
+            });
+        });
+        if (reachable) {
+            return;
+        }
+        await sleep(TUNNEL_PORT_POLL_DELAY_MS);
+    }
+    throw new Error(`Local port ${port} did not become reachable after ${TUNNEL_PORT_POLL_MAX_ATTEMPTS} attempts`);
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export type { AdapterLogger } from "./logger.js";
+export { defaultLogger } from "./logger.js";
+export type { PowerLineClient, PowerLineConnection, ProvisionEvent, BaseEnvironmentConfig, EnvironmentAdapter, } from "./adapter.js";
+export { reconnectOrProvision } from "./adapter.js";
+export type { RemoteExecutor } from "./remote-executor.js";
+export type { RemoteTunnel } from "./tunnel.js";
+export { ProcessTunnel } from "./tunnel.js";
+export type { TunnelState } from "./tunnel-registry.js";
+export { registerTunnel, getTunnel, closeTunnel, closeAllTunnels } from "./tunnel-registry.js";
+export { createPowerLineClient, connectThroughTunnel, waitForLocalPort } from "./connect.js";
+export type { BootstrapOptions, StartRemotePowerLineOptions } from "./bootstrap.js";
+export { bootstrapPowerLine, startRemotePowerLine, probeRemotePowerLine, writeRemoteEnvFile, buildRemoteKillCommand, } from "./bootstrap.js";
+export { remoteStop, remoteDestroy, remoteHealthCheck } from "./shared-operations.js";
+export { sleep, findFreePort, isDevMode, getPackageVersion, shellEscape, REMOTE_POWERLINE_DIRECTORY, SSH_CONNECTIVITY_TIMEOUT_MS, REMOTE_EXEC_DEFAULT_TIMEOUT_MS, } from "./utils.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":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/F,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG7F,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,OAAO,EACL,KAAK,EACL,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { defaultLogger } from "./logger.js";
+export { reconnectOrProvision } from "./adapter.js";
+export { ProcessTunnel } from "./tunnel.js";
+export { registerTunnel, getTunnel, closeTunnel, closeAllTunnels } from "./tunnel-registry.js";
+// ─── Connect ────────────────────────────────────────────────
+export { createPowerLineClient, connectThroughTunnel, waitForLocalPort } from "./connect.js";
+export { bootstrapPowerLine, startRemotePowerLine, probeRemotePowerLine, writeRemoteEnvFile, buildRemoteKillCommand, } from "./bootstrap.js";
+// ─── Shared Operations ─────────────────────────────────────
+export { remoteStop, remoteDestroy, remoteHealthCheck } from "./shared-operations.js";
+// ─── Utilities ──────────────────────────────────────────────
+export { sleep, findFreePort, isDevMode, getPackageVersion, shellEscape, REMOTE_POWERLINE_DIRECTORY, SSH_CONNECTIVITY_TIMEOUT_MS, REMOTE_EXEC_DEFAULT_TIMEOUT_MS, } from "./utils.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":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAOpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE/F,+DAA+D;AAC/D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAI7F,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtF,+DAA+D;AAC/D,OAAO,EACL,KAAK,EACL,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger interface compatible with pino's structured-logging signature.
+ * All SDK functions accept an optional {@link AdapterLogger} parameter;
+ * when omitted, the {@link defaultLogger} (console) is used.
+ */
+export interface AdapterLogger {
+    info(obj: object, msg: string): void;
+    warn(obj: object, msg: string): void;
+    error(obj: object, msg: string): void;
+    debug(obj: object, msg: string): void;
+}
+/** Console-based logger used when no logger is explicitly provided. */
+export declare const defaultLogger: AdapterLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,uEAAuE;AACvE,eAAO,MAAM,aAAa,EAAE,aAa3B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,16 @@
+/** Console-based logger used when no logger is explicitly provided. */
+export const defaultLogger = {
+    info(_obj, msg) {
+        console.log("[adapter-sdk]", msg);
+    },
+    warn(_obj, msg) {
+        console.warn("[adapter-sdk]", msg);
+    },
+    error(_obj, msg) {
+        console.error("[adapter-sdk]", msg);
+    },
+    debug(_obj, msg) {
+        console.debug("[adapter-sdk]", msg);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAYA,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,IAAI,CAAC,IAAY,EAAE,GAAW;QAC5B,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,IAAY,EAAE,GAAW;QAC5B,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,KAAK,CAAC,IAAY,EAAE,GAAW;QAC7B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,CAAC,IAAY,EAAE,GAAW;QAC7B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/dist/remote-executor.d.ts

@@ -0,0 +1,10 @@
+/** Abstraction for executing commands on a remote host. */
+export interface RemoteExecutor {
+    /** Execute a shell command on the remote host and return stdout. */
+    exec(command: string, opts?: {
+        timeout?: number;
+    }): Promise<string>;
+    /** Copy a local file or directory to a path on the remote host. */
+    copyTo(localPath: string, remotePath: string): Promise<void>;
+}
+//# sourceMappingURL=remote-executor.d.ts.map

package/dist/remote-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-executor.d.ts","sourceRoot":"","sources":["../src/remote-executor.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,mEAAmE;IACnE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/dist/remote-executor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remote-executor.js.map

package/dist/remote-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-executor.js","sourceRoot":"","sources":["../src/remote-executor.ts"],"names":[],"mappings":""}

package/dist/shared-operations.d.ts

@@ -0,0 +1,16 @@
+import type { PowerLineConnection } from "./adapter.js";
+import type { RemoteExecutor } from "./remote-executor.js";
+import type { AdapterLogger } from "./logger.js";
+/**
+ * Stop the remote PowerLine process and close the tunnel.
+ * Shared by SSH and Codespace adapters.
+ */
+export declare function remoteStop(environmentId: string, executor: RemoteExecutor, logger?: AdapterLogger): Promise<void>;
+/**
+ * Stop the remote PowerLine, remove artifacts, and close the tunnel.
+ * Shared by SSH and Codespace adapters.
+ */
+export declare function remoteDestroy(environmentId: string, executor: RemoteExecutor, logger?: AdapterLogger): Promise<void>;
+/** Check that the tunnel is alive and the PowerLine responds to a ping. */
+export declare function remoteHealthCheck(connection: PowerLineConnection): Promise<boolean>;
+//# sourceMappingURL=shared-operations.d.ts.map

package/dist/shared-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-operations.d.ts","sourceRoot":"","sources":["../src/shared-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzF"}

package/dist/shared-operations.js

@@ -0,0 +1,50 @@
+import { closeTunnel, getTunnel } from "./tunnel-registry.js";
+import { buildRemoteKillCommand } from "./bootstrap.js";
+import { REMOTE_POWERLINE_DIRECTORY } from "./utils.js";
+import { defaultLogger } from "./logger.js";
+/**
+ * Stop the remote PowerLine process and close the tunnel.
+ * Shared by SSH and Codespace adapters.
+ */
+export async function remoteStop(environmentId, executor, logger = defaultLogger) {
+    try {
+        await executor.exec(buildRemoteKillCommand());
+    }
+    catch (err) {
+        logger.debug({ environmentId, err }, "Failed to kill remote PowerLine (may already be stopped)");
+    }
+    await closeTunnel(environmentId);
+}
+/**
+ * Stop the remote PowerLine, remove artifacts, and close the tunnel.
+ * Shared by SSH and Codespace adapters.
+ */
+export async function remoteDestroy(environmentId, executor, logger = defaultLogger) {
+    try {
+        await executor.exec(`${buildRemoteKillCommand()}; `
+            + 'CRED="$HOME/.claude/.credentials.json"; '
+            + `if [ -L "$CRED" ]; then case "$(readlink "$CRED" 2>/dev/null)" in ${REMOTE_POWERLINE_DIRECTORY}/*) rm -f "$CRED";; esac; fi; `
+            + `HELPER="$(git config --global credential.helper 2>/dev/null || true)"; `
+            + `case "$HELPER" in ${REMOTE_POWERLINE_DIRECTORY}/*) git config --global --unset credential.helper 2>/dev/null || true;; esac; `
+            + `rm -rf ${REMOTE_POWERLINE_DIRECTORY}`);
+    }
+    catch (err) {
+        logger.debug({ environmentId, err }, "Failed to clean up remote PowerLine artifacts");
+    }
+    await closeTunnel(environmentId);
+}
+/** Check that the tunnel is alive and the PowerLine responds to a ping. */
+export async function remoteHealthCheck(connection) {
+    const state = getTunnel(connection.environmentId);
+    if (!state?.tunnel.isAlive()) {
+        return false;
+    }
+    try {
+        await connection.client.ping({});
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=shared-operations.js.map

package/dist/shared-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-operations.js","sourceRoot":"","sources":["../src/shared-operations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,aAAqB,EACrB,QAAwB,EACxB,SAAwB,aAAa;IAErC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,0DAA0D,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,aAAqB,EACrB,QAAwB,EACxB,SAAwB,aAAa;IAErC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CACjB,GAAG,sBAAsB,EAAE,IAAI;cAC7B,0CAA0C;cAC1C,qEAAqE,0BAA0B,gCAAgC;cAC/H,yEAAyE;cACzE,qBAAqB,0BAA0B,gFAAgF;cAC/H,UAAU,0BAA0B,EAAE,CACzC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,+CAA+C,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,WAAW,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAA+B;IACrE,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/tunnel-registry.d.ts

@@ -0,0 +1,17 @@
+import type { RemoteTunnel } from "./tunnel.js";
+import type { AdapterLogger } from "./logger.js";
+/** State for an active tunnel pair (forward + optional reverse). */
+export interface TunnelState {
+    tunnel: RemoteTunnel;
+    /** Optional reverse tunnel so remote agents can reach the host MCP endpoint. */
+    reverseTunnel?: RemoteTunnel;
+}
+/** Register an active tunnel for an environment, closing any existing tunnel first. */
+export declare function registerTunnel(environmentId: string, state: TunnelState, logger?: AdapterLogger): void;
+/** Get the tunnel state for an environment. */
+export declare function getTunnel(environmentId: string): TunnelState | undefined;
+/** Close and unregister the tunnel(s) for an environment. */
+export declare function closeTunnel(environmentId: string): Promise<void>;
+/** Close all active tunnels (called during server shutdown). */
+export declare function closeAllTunnels(logger?: AdapterLogger): Promise<void>;
+//# sourceMappingURL=tunnel-registry.d.ts.map

package/dist/tunnel-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-registry.d.ts","sourceRoot":"","sources":["../src/tunnel-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,gFAAgF;IAChF,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAID,uFAAuF;AACvF,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,WAAW,EAClB,MAAM,GAAE,aAA6B,GACpC,IAAI,CAaN;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAExE;AAED,6DAA6D;AAC7D,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE;AAED,gEAAgE;AAChE,wBAAsB,eAAe,CAAC,MAAM,GAAE,aAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAS1F"}

package/dist/tunnel-registry.js

@@ -0,0 +1,45 @@
+import { defaultLogger } from "./logger.js";
+const tunnelMap = new Map();
+/** Register an active tunnel for an environment, closing any existing tunnel first. */
+export function registerTunnel(environmentId, state, logger = defaultLogger) {
+    const existing = tunnelMap.get(environmentId);
+    if (existing) {
+        existing.tunnel.close().catch((err) => {
+            logger.warn({ err, environmentId }, "Failed to close existing tunnel before registering new one");
+        });
+        if (existing.reverseTunnel) {
+            existing.reverseTunnel.close().catch((err) => {
+                logger.warn({ err, environmentId }, "Failed to close existing reverse tunnel before registering new one");
+            });
+        }
+    }
+    tunnelMap.set(environmentId, state);
+}
+/** Get the tunnel state for an environment. */
+export function getTunnel(environmentId) {
+    return tunnelMap.get(environmentId);
+}
+/** Close and unregister the tunnel(s) for an environment. */
+export async function closeTunnel(environmentId) {
+    const state = tunnelMap.get(environmentId);
+    if (state) {
+        await state.tunnel.close();
+        if (state.reverseTunnel) {
+            await state.reverseTunnel.close();
+        }
+        tunnelMap.delete(environmentId);
+    }
+}
+/** Close all active tunnels (called during server shutdown). */
+export async function closeAllTunnels(logger = defaultLogger) {
+    const ids = [...tunnelMap.keys()];
+    for (const id of ids) {
+        try {
+            await closeTunnel(id);
+        }
+        catch (err) {
+            logger.error({ environmentId: id, err }, "Failed to close tunnel during shutdown");
+        }
+    }
+}
+//# sourceMappingURL=tunnel-registry.js.map

package/dist/tunnel-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-registry.js","sourceRoot":"","sources":["../src/tunnel-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,MAAM,SAAS,GAA6B,IAAI,GAAG,EAAuB,CAAC;AAE3E,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,KAAkB,EAClB,SAAwB,aAAa;IAErC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,4DAA4D,CAAC,CAAC;QACpG,CAAC,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC3B,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC3C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,oEAAoE,CAAC,CAAC;YAC5G,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,aAAqB;IAC7C,OAAO,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,aAAqB;IACrD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QACpC,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAwB,aAAa;IACzE,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,wCAAwC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tunnel.d.ts

@@ -0,0 +1,35 @@
+import { type ChildProcess } from "node:child_process";
+import type { AdapterLogger } from "./logger.js";
+/** Abstraction for a long-lived port-forwarding tunnel. */
+export interface RemoteTunnel {
+    /** The local port the tunnel is bound to. */
+    localPort: number;
+    /** Open the tunnel (spawns a background process). */
+    open(): Promise<void>;
+    /** Close the tunnel (kills the background process). */
+    close(): Promise<void>;
+    /** Return true if the tunnel process is still running. */
+    isAlive(): boolean;
+}
+/**
+ * Base class for tunnels backed by a long-lived child process.
+ * Subclasses provide the command and arguments to spawn.
+ */
+export declare abstract class ProcessTunnel implements RemoteTunnel {
+    localPort: number;
+    protected process: ChildProcess | undefined;
+    protected logger: AdapterLogger;
+    constructor(localPort: number, logger?: AdapterLogger);
+    /** Return the command and arguments to spawn the tunnel process. */
+    protected abstract spawnArgs(): {
+        command: string;
+        args: string[];
+    };
+    /** Open the tunnel by spawning the background process. */
+    open(): Promise<void>;
+    /** Close the tunnel by killing the background process. */
+    close(): Promise<void>;
+    /** Return true if the tunnel process is still running. */
+    isAlive(): boolean;
+}
+//# sourceMappingURL=tunnel.d.ts.map

package/dist/tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../src/tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,uDAAuD;IACvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,0DAA0D;IAC1D,OAAO,IAAI,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,8BAAsB,aAAc,YAAW,YAAY;IAClD,SAAS,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEb,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,aAA6B;IAK3E,oEAAoE;IACpE,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAEnE,0DAA0D;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BlC,0DAA0D;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC,0DAA0D;IACnD,OAAO,IAAI,OAAO;CAG1B"}

package/dist/tunnel.js

@@ -0,0 +1,60 @@
+import { spawn } from "node:child_process";
+import { defaultLogger } from "./logger.js";
+import { sleep } from "./utils.js";
+import { waitForLocalPort } from "./connect.js";
+/** Grace period before sending SIGKILL to a tunnel process. */
+const TUNNEL_KILL_GRACE_MS = 1_000;
+/**
+ * Base class for tunnels backed by a long-lived child process.
+ * Subclasses provide the command and arguments to spawn.
+ */
+export class ProcessTunnel {
+    localPort;
+    process;
+    logger;
+    constructor(localPort, logger = defaultLogger) {
+        this.localPort = localPort;
+        this.logger = logger;
+    }
+    /** Open the tunnel by spawning the background process. */
+    async open() {
+        const { command, args } = this.spawnArgs();
+        this.logger.info({ command, args }, "Opening tunnel");
+        this.process = spawn(command, args, {
+            stdio: ["ignore", "ignore", "pipe"],
+            detached: false,
+        });
+        this.process.on("error", (err) => {
+            this.logger.error({ err }, "Tunnel process error");
+        });
+        this.process.stderr?.on("data", (data) => {
+            this.logger.debug({ stderr: data.toString() }, "Tunnel stderr");
+        });
+        // Wait for the local port to become reachable. Kill the process if it fails.
+        try {
+            await waitForLocalPort(this.localPort);
+        }
+        catch (err) {
+            await this.close();
+            throw err;
+        }
+    }
+    /** Close the tunnel by killing the background process. */
+    async close() {
+        if (this.process?.exitCode !== null) {
+            return;
+        }
+        this.process.kill("SIGTERM");
+        await sleep(TUNNEL_KILL_GRACE_MS);
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- exitCode may change after SIGTERM + sleep
+        if (this.process.exitCode === null) {
+            this.process.kill("SIGKILL");
+        }
+        this.process = undefined;
+    }
+    /** Return true if the tunnel process is still running. */
+    isAlive() {
+        return this.process?.exitCode === null;
+    }
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../src/tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,+DAA+D;AAC/D,MAAM,oBAAoB,GAAW,KAAK,CAAC;AAc3C;;;GAGG;AACH,MAAM,OAAgB,aAAa;IAC1B,SAAS,CAAS;IACf,OAAO,CAA2B;IAClC,MAAM,CAAgB;IAEhC,YAAmB,SAAiB,EAAE,SAAwB,aAAa;QACzE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAKD,0DAA0D;IACnD,KAAK,CAAC,IAAI;QACf,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAEtD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YAClC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;YACnC,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,eAAe,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,6EAA6E;QAC7E,IAAI,CAAC;YACH,MAAM,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,0DAA0D;IACnD,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAClC,oHAAoH;QACpH,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,0DAA0D;IACnD,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IACzC,CAAC;CACF"}

package/dist/utils.d.ts

@@ -0,0 +1,27 @@
+/** Remote directory where PowerLine artifacts are installed. Uses $HOME (not ~) so it expands inside double-quoted shell strings. */
+export declare const REMOTE_POWERLINE_DIRECTORY: string;
+/** Timeout for the initial SSH connectivity test. */
+export declare const SSH_CONNECTIVITY_TIMEOUT_MS: number;
+/** Default timeout for remote command execution. */
+export declare const REMOTE_EXEC_DEFAULT_TIMEOUT_MS: number;
+/** Return a promise that resolves after the specified number of milliseconds. */
+export declare function sleep(ms: number): Promise<void>;
+/** Find and return an available TCP port by briefly binding to port 0. */
+export declare function findFreePort(): Promise<number>;
+/**
+ * Check if we are running from a monorepo source checkout.
+ * We detect this by checking for `rush.json` at the repo root,
+ * computed relative to this file's compiled location (packages/adapter-sdk/dist → 3 levels up).
+ */
+export declare function isDevMode(): boolean;
+/**
+ * Read the lockstep version from the SDK's own package.json.
+ * import.meta.dirname = dist/, so ../package.json = adapter-sdk's package.json.
+ */
+export declare function getPackageVersion(): string;
+/**
+ * Escape a value for safe use inside a shell single-quoted string.
+ * Replaces each `'` with `'\''` (end quote, escaped quote, start quote).
+ */
+export declare function shellEscape(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAMA,qIAAqI;AACrI,eAAO,MAAM,0BAA0B,EAAE,MAAmC,CAAC;AAE7E,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,EAAE,MAAe,CAAC;AAE1D,oDAAoD;AACpD,eAAO,MAAM,8BAA8B,EAAE,MAAe,CAAC;AAI7D,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAc9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils.js

@@ -0,0 +1,58 @@
+import { createServer } from "node:net";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+// ─── Constants ──────────────────────────────────────────────
+/** Remote directory where PowerLine artifacts are installed. Uses $HOME (not ~) so it expands inside double-quoted shell strings. */
+export const REMOTE_POWERLINE_DIRECTORY = "$HOME/.grackle/powerline";
+/** Timeout for the initial SSH connectivity test. */
+export const SSH_CONNECTIVITY_TIMEOUT_MS = 15_000;
+/** Default timeout for remote command execution. */
+export const REMOTE_EXEC_DEFAULT_TIMEOUT_MS = 60_000;
+// ─── Utilities ──────────────────────────────────────────────
+/** Return a promise that resolves after the specified number of milliseconds. */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Find and return an available TCP port by briefly binding to port 0. */
+export function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.listen(0, () => {
+            const addr = server.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                server.close(() => resolve(port));
+            }
+            else {
+                server.close(() => reject(new Error("Failed to get port")));
+            }
+        });
+        server.on("error", reject);
+    });
+}
+/**
+ * Check if we are running from a monorepo source checkout.
+ * We detect this by checking for `rush.json` at the repo root,
+ * computed relative to this file's compiled location (packages/adapter-sdk/dist → 3 levels up).
+ */
+export function isDevMode() {
+    const repoRoot = resolve(import.meta.dirname, "../../../");
+    return existsSync(join(repoRoot, "rush.json"));
+}
+/**
+ * Read the lockstep version from the SDK's own package.json.
+ * import.meta.dirname = dist/, so ../package.json = adapter-sdk's package.json.
+ */
+export function getPackageVersion() {
+    const packageJsonPath = resolve(import.meta.dirname, "../package.json");
+    const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    return pkg.version;
+}
+/**
+ * Escape a value for safe use inside a shell single-quoted string.
+ * Replaces each `'` with `'\''` (end quote, escaped quote, start quote).
+ */
+export function shellEscape(value) {
+    return value.replace(/'/g, "'\\''");
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,+DAA+D;AAE/D,qIAAqI;AACrI,MAAM,CAAC,MAAM,0BAA0B,GAAW,0BAA0B,CAAC;AAE7E,qDAAqD;AACrD,MAAM,CAAC,MAAM,2BAA2B,GAAW,MAAM,CAAC;AAE1D,oDAAoD;AACpD,MAAM,CAAC,MAAM,8BAA8B,GAAW,MAAM,CAAC;AAE7D,+DAA+D;AAE/D,iFAAiF;AACjF,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAwB,CAAC;IACrF,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@grackle-ai/adapter-sdk",
+  "version": "0.36.0",
+  "description": "SDK for building Grackle environment adapters",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/adapter-sdk"
+  },
+  "keywords": [
+    "grackle",
+    "adapter",
+    "sdk",
+    "environment"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.5.0",
+    "@connectrpc/connect": "^2.0.0",
+    "@connectrpc/connect-node": "^2.0.0",
+    "@grackle-ai/common": "0.36.0"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.4",
+    "@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"
+  }
+}