@grackle-ai/server 0.0.2

package/README.md

@@ -0,0 +1,5 @@
+# @grackle-ai/server
+
+Central gRPC server with SQLite storage and WebSocket bridge for Grackle.
+
+See the [main repository](https://github.com/nick-pape/grackle) for full documentation.

package/dist/adapter-manager.d.ts

@@ -0,0 +1,18 @@
+import type { EnvironmentAdapter, PowerLineConnection } from "./adapters/adapter.js";
+/** Register an environment adapter so it can be looked up by type. */
+export declare function registerAdapter(adapter: EnvironmentAdapter): void;
+/** Retrieve a registered adapter by its type name. */
+export declare function getAdapter(type: string): EnvironmentAdapter | undefined;
+/** Store an active PowerLine connection for an environment. */
+export declare function setConnection(environmentId: string, conn: PowerLineConnection): void;
+/** Get the active PowerLine connection for an environment, if connected. */
+export declare function getConnection(environmentId: string): PowerLineConnection | undefined;
+/** Remove the stored connection for an environment. */
+export declare function removeConnection(environmentId: string): void;
+/** Return the map of all active environment connections. */
+export declare function listConnections(): Map<string, PowerLineConnection>;
+/** Start a periodic health-check loop that calls `onDisconnect` when a PowerLine becomes unreachable. */
+export declare function startHeartbeat(onDisconnect: (environmentId: string) => void): void;
+/** Stop the periodic health-check loop. */
+export declare function stopHeartbeat(): void;
+//# sourceMappingURL=adapter-manager.d.ts.map

package/dist/adapter-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-manager.d.ts","sourceRoot":"","sources":["../src/adapter-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAUrF,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEjE;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAEpF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEpF;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAElE;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CA4BlF;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}

package/dist/adapter-manager.js

@@ -0,0 +1,67 @@
+import * as envRegistry from "./env-registry.js";
+import { logger } from "./logger.js";
+const HEARTBEAT_INTERVAL_MS = 30_000;
+const adapters = new Map();
+const connections = new Map();
+let heartbeatInterval = undefined;
+/** Register an environment adapter so it can be looked up by type. */
+export function registerAdapter(adapter) {
+    adapters.set(adapter.type, adapter);
+}
+/** Retrieve a registered adapter by its type name. */
+export function getAdapter(type) {
+    return adapters.get(type);
+}
+/** Store an active PowerLine connection for an environment. */
+export function setConnection(environmentId, conn) {
+    connections.set(environmentId, conn);
+}
+/** Get the active PowerLine connection for an environment, if connected. */
+export function getConnection(environmentId) {
+    return connections.get(environmentId);
+}
+/** Remove the stored connection for an environment. */
+export function removeConnection(environmentId) {
+    connections.delete(environmentId);
+}
+/** Return the map of all active environment connections. */
+export function listConnections() {
+    return connections;
+}
+/** Start a periodic health-check loop that calls `onDisconnect` when a PowerLine becomes unreachable. */
+export function startHeartbeat(onDisconnect) {
+    if (heartbeatInterval !== undefined) {
+        return;
+    }
+    heartbeatInterval = setInterval(async () => {
+        for (const [environmentId, conn] of connections) {
+            const env = envRegistry.getEnvironment(environmentId);
+            if (!env) {
+                continue;
+            }
+            const adapter = adapters.get(env.adapterType);
+            if (!adapter) {
+                continue;
+            }
+            try {
+                const ok = await adapter.healthCheck(conn);
+                if (!ok) {
+                    logger.warn({ environmentId }, "Health check failed");
+                    onDisconnect(environmentId);
+                }
+            }
+            catch {
+                logger.warn({ environmentId }, "Connection lost");
+                onDisconnect(environmentId);
+            }
+        }
+    }, HEARTBEAT_INTERVAL_MS);
+}
+/** Stop the periodic health-check loop. */
+export function stopHeartbeat() {
+    if (heartbeatInterval !== undefined) {
+        clearInterval(heartbeatInterval);
+        heartbeatInterval = undefined;
+    }
+}
+//# sourceMappingURL=adapter-manager.js.map

package/dist/adapter-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-manager.js","sourceRoot":"","sources":["../src/adapter-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,qBAAqB,GAAW,MAAM,CAAC;AAE7C,MAAM,QAAQ,GAAoC,IAAI,GAAG,EAA8B,CAAC;AACxF,MAAM,WAAW,GAAqC,IAAI,GAAG,EAA+B,CAAC;AAC7F,IAAI,iBAAiB,GAA+C,SAAS,CAAC;AAE9E,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAA2B;IACzD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,IAAyB;IAC5E,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,OAAO,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,aAAqB;IACpD,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,cAAc,CAAC,YAA6C;IAC1E,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,KAAK,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,qBAAqB,CAAC,CAAC;oBACtD,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,iBAAiB,CAAC,CAAC;gBAClD,YAAY,CAAC,aAAa,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAC5B,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa;IAC3B,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,aAAa,CAAC,iBAAiB,CAAC,CAAC;QACjC,iBAAiB,GAAG,SAAS,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/adapters/adapter.d.ts

@@ -0,0 +1,40 @@
+import type { Client } from "@connectrpc/connect";
+import type { powerline } from "@grackle-ai/common";
+/** 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>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,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;CAChE"}

package/dist/adapters/adapter.js

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

package/dist/adapters/adapter.js.map

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

package/dist/adapters/docker.d.ts

@@ -0,0 +1,26 @@
+import type { EnvironmentAdapter, BaseEnvironmentConfig, PowerLineConnection, ProvisionEvent } from "./adapter.js";
+/** Docker-specific environment configuration. */
+export interface DockerEnvironmentConfig extends BaseEnvironmentConfig {
+    image: string;
+    containerName?: string;
+    localPort?: number;
+    volumes?: string[];
+    env?: Record<string, string>;
+    /** Git repo URL to clone into the container workspace. */
+    repo?: string;
+    /** Enable GPU passthrough (e.g. "all" for --gpus all). */
+    gpus?: string;
+}
+/** Environment adapter that provisions and manages Docker containers running the PowerLine. */
+export declare class DockerAdapter implements EnvironmentAdapter {
+    type: string;
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    disconnect(environmentId: string): Promise<void>;
+    stop(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    destroy(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    healthCheck(connection: PowerLineConnection): Promise<boolean>;
+    /** Build the `docker run` argument array from config and token. */
+    private buildRunArgs;
+}
+//# sourceMappingURL=docker.d.ts.map

package/dist/adapters/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/adapters/docker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAmBnH,iDAAiD;AACjD,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAgID,+FAA+F;AAC/F,qBAAa,aAAc,YAAW,kBAAkB;IAC/C,IAAI,EAAE,MAAM,CAAY;IAEjB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC;IAkC1H,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoBrH,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3E,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9E,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3E,mEAAmE;IACnE,OAAO,CAAC,YAAY;CAqErB"}

package/dist/adapters/docker.js

@@ -0,0 +1,274 @@
+import { DEFAULT_POWERLINE_PORT } from "@grackle-ai/common";
+import { createPowerLineClient } from "./powerline-transport.js";
+import { exec } from "../utils/exec.js";
+import { findFreePort } from "../utils/ports.js";
+import { sleep } from "../utils/sleep.js";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { logger } from "../logger.js";
+const DOCKER_PULL_TIMEOUT_MS = 120_000;
+const GIT_CLONE_TIMEOUT_MS = 120_000;
+const GIT_PULL_TIMEOUT_MS = 60_000;
+const CONTAINER_POLL_DELAY_MS = 1_000;
+const CONTAINER_POLL_MAX_ATTEMPTS = 30;
+const CONNECT_RETRY_DELAY_MS = 1_500;
+const CONNECT_MAX_RETRIES = 10;
+const WORKSPACE_PATH = "/workspace";
+const containerPorts = new Map();
+// ─── Docker CLI Helpers ────────────────────────────────────
+/** Pull a Docker image, suppressing errors if the image exists locally. */
+async function pullImage(image) {
+    try {
+        await exec("docker", ["pull", image], { timeout: DOCKER_PULL_TIMEOUT_MS });
+        return true;
+    }
+    catch {
+        logger.debug({ image }, "Docker pull failed, trying local image");
+        return false;
+    }
+}
+/** Start a new Docker container with the given arguments. Returns true if created; false if it already existed. */
+async function createOrStartContainer(containerName, runArgs) {
+    try {
+        await exec("docker", ["inspect", containerName]);
+        // Container exists — just start it
+        await exec("docker", ["start", containerName]);
+        return false;
+    }
+    catch {
+        // Container doesn't exist — create it
+        await exec("docker", runArgs);
+        return true;
+    }
+}
+/** Discover the host-mapped port of an existing container. */
+async function discoverHostPort(containerName, containerPort, fallback) {
+    try {
+        const { stdout } = await exec("docker", [
+            "inspect", "-f",
+            `{{(index (index .NetworkSettings.Ports "${containerPort}/tcp") 0).HostPort}}`,
+            containerName,
+        ]);
+        const parsed = parseInt(stdout, 10);
+        if (!isNaN(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        logger.debug({ containerName }, "Could not discover host port, using fallback");
+    }
+    return fallback;
+}
+/** Poll until a Docker container reaches the Running state. */
+async function waitForContainerRunning(containerName) {
+    for (let i = 0; i < CONTAINER_POLL_MAX_ATTEMPTS; i++) {
+        try {
+            const { stdout } = await exec("docker", ["inspect", "-f", "{{.State.Running}}", containerName]);
+            if (stdout === "true") {
+                return;
+            }
+        }
+        catch {
+            logger.debug({ containerName, attempt: i }, "Container not yet running");
+        }
+        await sleep(CONTAINER_POLL_DELAY_MS);
+    }
+}
+/** Clone or pull a git repo inside a container's workspace. */
+async function ensureRepoInContainer(containerName, repo) {
+    // Check if already cloned
+    try {
+        const { stdout } = await exec("docker", [
+            "exec", containerName, "bash", "-c", `ls ${WORKSPACE_PATH}/.git 2>/dev/null && echo exists`,
+        ]);
+        if (stdout.includes("exists")) {
+            await exec("docker", [
+                "exec", "-w", WORKSPACE_PATH, containerName, "git", "pull", "--ff-only",
+            ], { timeout: GIT_PULL_TIMEOUT_MS }).catch((err) => {
+                logger.warn({ containerName, err }, "Git pull failed (may be detached HEAD)");
+            });
+            return;
+        }
+    }
+    catch {
+        // Not cloned — proceed to clone below
+    }
+    const ghToken = await getGitHubToken();
+    const cloneUrl = repo.startsWith("https://") ? repo : `https://github.com/${repo}.git`;
+    if (ghToken) {
+        await exec("docker", [
+            "exec", containerName, "git", "config", "--global",
+            "credential.helper", `!f() { echo "username=x-access-token"; echo "password=${ghToken}"; }; f`,
+        ]);
+        await exec("docker", [
+            "exec", containerName, "git", "clone", cloneUrl, WORKSPACE_PATH,
+        ], { timeout: GIT_CLONE_TIMEOUT_MS });
+        await exec("docker", [
+            "exec", containerName, "git", "config", "--global", "--unset", "credential.helper",
+        ]).catch((err) => {
+            logger.warn({ err }, "Failed to unset credential helper");
+        });
+    }
+    else {
+        await exec("docker", [
+            "exec", containerName, "git", "clone", cloneUrl, WORKSPACE_PATH,
+        ], { timeout: GIT_CLONE_TIMEOUT_MS });
+    }
+}
+/** Validate that a token contains only safe characters (alphanumeric, underscore, hyphen). */
+const SAFE_TOKEN_PATTERN = /^[a-zA-Z0-9_\-]+$/;
+/** Get a GitHub token from the local `gh` CLI for private repo cloning. */
+async function getGitHubToken() {
+    try {
+        const { stdout } = await exec("gh", ["auth", "token"]);
+        if (!stdout) {
+            return undefined;
+        }
+        if (!SAFE_TOKEN_PATTERN.test(stdout)) {
+            logger.warn("GitHub token contains unexpected characters, skipping credential setup");
+            return undefined;
+        }
+        return stdout;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ─── Docker Adapter ────────────────────────────────────────
+/** Environment adapter that provisions and manages Docker containers running the PowerLine. */
+export class DockerAdapter {
+    type = "docker";
+    async *provision(environmentId, config, powerlineToken) {
+        const cfg = config;
+        const image = cfg.image || "grackle-powerline:latest";
+        const containerName = cfg.containerName || `grackle-${environmentId}`;
+        const localPort = cfg.localPort || await findFreePort();
+        yield { stage: "creating", message: `Pulling image ${image}...`, progress: 0.1 };
+        await pullImage(image);
+        yield { stage: "creating", message: `Creating container ${containerName}...`, progress: 0.3 };
+        const runArgs = this.buildRunArgs(containerName, localPort, image, cfg, powerlineToken);
+        const isNew = await createOrStartContainer(containerName, runArgs);
+        let actualPort = localPort;
+        if (!isNew) {
+            yield { stage: "starting", message: "Container exists, starting...", progress: 0.4 };
+            actualPort = await discoverHostPort(containerName, DEFAULT_POWERLINE_PORT, localPort);
+        }
+        containerPorts.set(environmentId, actualPort);
+        yield { stage: "starting", message: "Waiting for container...", progress: 0.5 };
+        await waitForContainerRunning(containerName);
+        if (cfg.repo) {
+            yield { stage: "cloning", message: `Cloning ${cfg.repo}...`, progress: 0.6 };
+            await ensureRepoInContainer(containerName, cfg.repo);
+            yield { stage: "cloning", message: "Repo ready", progress: 0.75 };
+        }
+        yield { stage: "connecting", message: `Connecting on port ${actualPort}...`, progress: 0.8 };
+    }
+    async connect(environmentId, config, powerlineToken) {
+        const cfg = config;
+        const localPort = containerPorts.get(environmentId) || cfg.localPort || DEFAULT_POWERLINE_PORT;
+        const client = createPowerLineClient(`http://127.0.0.1:${localPort}`, powerlineToken);
+        let lastErr;
+        for (let attempt = 0; attempt < CONNECT_MAX_RETRIES; attempt++) {
+            try {
+                await client.ping({});
+                return { client, environmentId, port: localPort };
+            }
+            catch (err) {
+                lastErr = err;
+                await sleep(CONNECT_RETRY_DELAY_MS);
+            }
+        }
+        throw new Error(`Could not reach PowerLine after ${CONNECT_MAX_RETRIES} attempts: ${lastErr}`);
+    }
+    async disconnect(environmentId) {
+        containerPorts.delete(environmentId);
+    }
+    async stop(environmentId, config) {
+        const cfg = config;
+        const containerName = cfg.containerName || `grackle-${environmentId}`;
+        try {
+            await exec("docker", ["stop", containerName]);
+        }
+        catch (err) {
+            logger.debug({ environmentId, err }, "Container may already be stopped");
+        }
+        containerPorts.delete(environmentId);
+    }
+    async destroy(environmentId, config) {
+        const cfg = config;
+        const containerName = cfg.containerName || `grackle-${environmentId}`;
+        try {
+            await exec("docker", ["rm", "-f", containerName]);
+        }
+        catch (err) {
+            logger.debug({ environmentId, err }, "Container may not exist");
+        }
+        containerPorts.delete(environmentId);
+    }
+    async healthCheck(connection) {
+        try {
+            await connection.client.ping({});
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Build the `docker run` argument array from config and token. */
+    buildRunArgs(containerName, localPort, image, cfg, powerlineToken) {
+        const args = [
+            "run", "-d",
+            "--name", containerName,
+            "-p", `127.0.0.1:${localPort}:${DEFAULT_POWERLINE_PORT}`,
+        ];
+        if (cfg.volumes) {
+            for (const vol of cfg.volumes) {
+                args.push("-v", vol);
+            }
+        }
+        if (cfg.env) {
+            for (const [key, val] of Object.entries(cfg.env)) {
+                args.push("-e", `${key}=${val}`);
+            }
+        }
+        // Forward ANTHROPIC_API_KEY if set on host
+        if (process.env.ANTHROPIC_API_KEY && !cfg.env?.ANTHROPIC_API_KEY) {
+            args.push("-e", `ANTHROPIC_API_KEY=${process.env.ANTHROPIC_API_KEY}`);
+        }
+        // Forward GitHub tokens for Copilot runtime
+        for (const tokenVar of ["GITHUB_TOKEN", "GH_TOKEN", "COPILOT_GITHUB_TOKEN"]) {
+            if (process.env[tokenVar] && !cfg.env?.[tokenVar]) {
+                args.push("-e", `${tokenVar}=${process.env[tokenVar]}`);
+            }
+        }
+        // Forward Copilot-specific configuration environment variables
+        for (const envVar of ["COPILOT_CLI_URL", "COPILOT_CLI_PATH", "COPILOT_PROVIDER_CONFIG"]) {
+            if (process.env[envVar] && !cfg.env?.[envVar]) {
+                args.push("-e", `${envVar}=${process.env[envVar]}`);
+            }
+        }
+        // Pass PowerLine token for authentication
+        if (powerlineToken) {
+            args.push("-e", `GRACKLE_POWERLINE_TOKEN=${powerlineToken}`);
+        }
+        // Mount Claude Code credentials for subscription auth
+        const hostCredsPath = join(homedir(), ".claude", ".credentials.json");
+        try {
+            readFileSync(hostCredsPath); // verify it exists
+            args.push("-v", `${hostCredsPath}:/home/grackle/.claude/.credentials.json:ro`);
+        }
+        catch {
+            logger.debug("No Claude credentials file found, skipping mount");
+        }
+        // Chromium needs >64MB shared memory for rendering
+        args.push("--shm-size=1gb");
+        // GPU passthrough for accelerated inference (e.g. TTS, ML models)
+        if (cfg.gpus) {
+            args.push("--gpus", cfg.gpus);
+        }
+        args.push(image);
+        return args;
+    }
+}
+//# sourceMappingURL=docker.js.map

package/dist/adapters/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/adapters/docker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,sBAAsB,GAAW,OAAO,CAAC;AAC/C,MAAM,oBAAoB,GAAW,OAAO,CAAC;AAC7C,MAAM,mBAAmB,GAAW,MAAM,CAAC;AAC3C,MAAM,uBAAuB,GAAW,KAAK,CAAC;AAC9C,MAAM,2BAA2B,GAAW,EAAE,CAAC;AAC/C,MAAM,sBAAsB,GAAW,KAAK,CAAC;AAC7C,MAAM,mBAAmB,GAAW,EAAE,CAAC;AACvC,MAAM,cAAc,GAAW,YAAY,CAAC;AAe5C,MAAM,cAAc,GAAwB,IAAI,GAAG,EAAkB,CAAC;AAEtE,8DAA8D;AAE9D,2EAA2E;AAC3E,KAAK,UAAU,SAAS,CAAC,KAAa;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,wCAAwC,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,mHAAmH;AACnH,KAAK,UAAU,sBAAsB,CAAC,aAAqB,EAAE,OAAiB;IAC5E,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;QACjD,mCAAmC;QACnC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,KAAK,UAAU,gBAAgB,CAAC,aAAqB,EAAE,aAAqB,EAAE,QAAgB;IAC5F,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;YACtC,SAAS,EAAE,IAAI;YACf,2CAA2C,aAAa,sBAAsB;YAC9E,aAAa;SACd,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,EAAE,8CAA8C,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+DAA+D;AAC/D,KAAK,UAAU,uBAAuB,CAAC,aAAqB;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,2BAA2B,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAC;YAChG,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,KAAK,UAAU,qBAAqB,CAAC,aAAqB,EAAE,IAAY;IACtE,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE;YACtC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,kCAAkC;SAC5F,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,QAAQ,EAAE;gBACnB,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW;aACxE,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACjD,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,wCAAwC,CAAC,CAAC;YAChF,CAAC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC;IAEvF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU;YAClD,mBAAmB,EAAE,yDAAyD,OAAO,SAAS;SAC/F,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc;SAChE,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB;SACnF,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,mCAAmC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc;SAChE,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,MAAM,kBAAkB,GAAW,mBAAmB,CAAC;AAEvD,2EAA2E;AAC3E,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;YACtF,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,8DAA8D;AAE9D,+FAA+F;AAC/F,MAAM,OAAO,aAAa;IACjB,IAAI,GAAW,QAAQ,CAAC;IAExB,KAAK,CAAC,CAAC,SAAS,CAAC,aAAqB,EAAE,MAA+B,EAAE,cAAsB;QACpG,MAAM,GAAG,GAAG,MAA4C,CAAC;QACzD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,0BAA0B,CAAC;QACtD,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,WAAW,aAAa,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,MAAM,YAAY,EAAE,CAAC;QAExD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,KAAK,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACjF,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QAEvB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,sBAAsB,aAAa,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAE9F,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAExF,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACnE,IAAI,UAAU,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YACrF,UAAU,GAAG,MAAM,gBAAgB,CAAC,aAAa,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAC;QACxF,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAE9C,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChF,MAAM,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAE7C,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,IAAI,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YAC7E,MAAM,qBAAqB,CAAC,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,sBAAsB,UAAU,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC/F,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,aAAqB,EAAE,MAA+B,EAAE,cAAsB;QACjG,MAAM,GAAG,GAAG,MAA4C,CAAC;QACzD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,sBAAsB,CAAC;QAE/F,MAAM,MAAM,GAAG,qBAAqB,CAAC,oBAAoB,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;QAEtF,IAAI,OAAgB,CAAC;QACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,mBAAmB,EAAE,OAAO,EAAE,EAAE,CAAC;YAC/D,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YACpD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,GAAG,GAAG,CAAC;gBACd,MAAM,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,mBAAmB,cAAc,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,aAAqB;QAC3C,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,aAAqB,EAAE,MAA+B;QACtE,MAAM,GAAG,GAAG,MAA4C,CAAC;QACzD,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,WAAW,aAAa,EAAE,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,kCAAkC,CAAC,CAAC;QAC3E,CAAC;QACD,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,aAAqB,EAAE,MAA+B;QACzE,MAAM,GAAG,GAAG,MAA4C,CAAC;QACzD,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,WAAW,aAAa,EAAE,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAC;QAClE,CAAC;QACD,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,UAA+B;QACtD,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,YAAY,CAClB,aAAqB,EACrB,SAAiB,EACjB,KAAa,EACb,GAA4B,EAC5B,cAAsB;QAEtB,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,aAAa;YACvB,IAAI,EAAE,aAAa,SAAS,IAAI,sBAAsB,EAAE;SACzD,CAAC;QAEF,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,iBAAiB,EAAE,CAAC;YACjE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,4CAA4C;QAC5C,KAAK,MAAM,QAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,sBAAsB,CAAC,EAAE,CAAC;YAC5E,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,+DAA+D;QAC/D,KAAK,MAAM,MAAM,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,yBAAyB,CAAC,EAAE,CAAC;YACxF,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,cAAc,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,sDAAsD;QACtD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,mBAAmB;YAChD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,aAAa,6CAA6C,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACnE,CAAC;QAED,mDAAmD;QACnD,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAE5B,kEAAkE;QAClE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/adapters/local.d.ts

@@ -0,0 +1,15 @@
+import type { EnvironmentAdapter, BaseEnvironmentConfig, PowerLineConnection, ProvisionEvent } from "./adapter.js";
+/** Local-specific environment configuration. */
+export interface LocalEnvironmentConfig extends BaseEnvironmentConfig {
+}
+/** Environment adapter that connects to a locally-running PowerLine process. */
+export declare class LocalAdapter implements EnvironmentAdapter {
+    type: string;
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    disconnect(): Promise<void>;
+    stop(): Promise<void>;
+    destroy(): Promise<void>;
+    healthCheck(connection: PowerLineConnection): Promise<boolean>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/adapters/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/adapters/local.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnH,gDAAgD;AAChD,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;CAEpE;AAED,gFAAgF;AAChF,qBAAa,YAAa,YAAW,kBAAkB;IAC9C,IAAI,EAAE,MAAM,CAAW;IAEhB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC;IAyB1H,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWrH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ5E"}

package/dist/adapters/local.js

@@ -0,0 +1,57 @@
+import { DEFAULT_POWERLINE_PORT } from "@grackle-ai/common";
+import { createPowerLineClient } from "./powerline-transport.js";
+import { sleep } from "../utils/sleep.js";
+const POWERLINE_RETRY_DELAY_MS = 1_000;
+const POWERLINE_MAX_RETRIES = 5;
+/** Environment adapter that connects to a locally-running PowerLine process. */
+export class LocalAdapter {
+    type = "local";
+    async *provision(environmentId, config, powerlineToken) {
+        const cfg = config;
+        const port = cfg.port || DEFAULT_POWERLINE_PORT;
+        const host = cfg.host || "localhost";
+        yield { stage: "connecting", message: `Connecting to PowerLine at ${host}:${port}...`, progress: 0.5 };
+        const client = createPowerLineClient(`http://${host}:${port}`, powerlineToken);
+        let lastErr;
+        for (let attempt = 0; attempt < POWERLINE_MAX_RETRIES; attempt++) {
+            try {
+                await client.ping({});
+                yield { stage: "ready", message: "Connected to local PowerLine", progress: 1 };
+                return;
+            }
+            catch (err) {
+                lastErr = err;
+                yield { stage: "connecting", message: `Waiting for PowerLine (attempt ${attempt + 1}/${POWERLINE_MAX_RETRIES})...`, progress: 0.5 + attempt * 0.1 };
+                await sleep(POWERLINE_RETRY_DELAY_MS);
+            }
+        }
+        yield { stage: "error", message: `Could not reach PowerLine: ${lastErr}`, progress: 0 };
+    }
+    async connect(environmentId, config, powerlineToken) {
+        const cfg = config;
+        const port = cfg.port || DEFAULT_POWERLINE_PORT;
+        const host = cfg.host || "localhost";
+        const client = createPowerLineClient(`http://${host}:${port}`, powerlineToken);
+        await client.ping({});
+        return { client, environmentId, port };
+    }
+    async disconnect() {
+        // Nothing to clean up for local connections
+    }
+    async stop() {
+        // Local PowerLine lifecycle is managed externally
+    }
+    async destroy() {
+        // Local PowerLine lifecycle is managed externally
+    }
+    async healthCheck(connection) {
+        try {
+            await connection.client.ping({});
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/adapters/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/adapters/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,wBAAwB,GAAW,KAAK,CAAC;AAC/C,MAAM,qBAAqB,GAAW,CAAC,CAAC;AAOxC,gFAAgF;AAChF,MAAM,OAAO,YAAY;IAChB,IAAI,GAAW,OAAO,CAAC;IAEvB,KAAK,CAAC,CAAC,SAAS,CAAC,aAAqB,EAAE,MAA+B,EAAE,cAAsB;QACpG,MAAM,GAAG,GAAG,MAA2C,CAAC;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,sBAAsB,CAAC;QAChD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC;QAErC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,8BAA8B,IAAI,IAAI,IAAI,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAEvG,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;QAE/E,IAAI,OAAgB,CAAC;QACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,qBAAqB,EAAE,OAAO,EAAE,EAAE,CAAC;YACjE,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;gBAC/E,OAAO;YACT,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,GAAG,GAAG,CAAC;gBACd,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,kCAAkC,OAAO,GAAG,CAAC,IAAI,qBAAqB,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC;gBACpJ,MAAM,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,8BAA8B,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,aAAqB,EAAE,MAA+B,EAAE,cAAsB;QACjG,MAAM,GAAG,GAAG,MAA2C,CAAC;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,sBAAsB,CAAC;QAChD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC;QAErC,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;QAC/E,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEtB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,4CAA4C;IAC9C,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,kDAAkD;IACpD,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,kDAAkD;IACpD,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,UAA+B;QACtD,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/powerline-transport.d.ts

@@ -0,0 +1,7 @@
+import type { PowerLineClient } from "./adapter.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;
+//# sourceMappingURL=powerline-transport.d.ts.map

package/dist/adapters/powerline-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerline-transport.d.ts","sourceRoot":"","sources":["../../src/adapters/powerline-transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,eAAe,CAa9F"}

package/dist/adapters/powerline-transport.js

@@ -0,0 +1,22 @@
+import { createClient } from "@connectrpc/connect";
+import { createGrpcTransport } from "@connectrpc/connect-node";
+import { powerline } from "@grackle-ai/common";
+/**
+ * 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);
+}
+//# sourceMappingURL=powerline-transport.js.map

package/dist/adapters/powerline-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerline-transport.js","sourceRoot":"","sources":["../../src/adapters/powerline-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,cAAsB;IAC3E,MAAM,SAAS,GAAG,mBAAmB,CAAC;QACpC,OAAO;QACP,YAAY,EAAE,cAAc;YAC1B,CAAC,CAAC;gBACE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACtB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,cAAc,EAAE,CAAC,CAAC;oBAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;aACF;YACH,CAAC,CAAC,EAAE;KACP,CAAC,CAAC;IACH,OAAO,YAAY,CAAC,SAAS,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/api-key.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Load or create the API key. On first run, a random 256-bit key is
+ * generated and written to ~/.grackle/api-key with 0600 permissions.
+ */
+export declare function loadOrCreateApiKey(): string;
+/** Verify a bearer token matches the API key. */
+export declare function verifyApiKey(token: string): boolean;
+//# sourceMappingURL=api-key.d.ts.map

package/dist/api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../src/api-key.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYnD"}