@grackle-ai/server 0.35.1 → 0.37.0

package/dist/adapters/remote-adapter-utils.d.ts

@@ -1,161 +0,0 @@
-import type { PowerLineConnection, ProvisionEvent } from "./adapter.js";
-import { findFreePort } from "../utils/ports.js";
-import { type ChildProcess } from "node:child_process";
-/** Default timeout for remote command execution. */
-declare const REMOTE_EXEC_DEFAULT_TIMEOUT_MS: number;
-/** Timeout for the initial SSH connectivity test. */
-declare const SSH_CONNECTIVITY_TIMEOUT_MS: number;
-/** Remote directory where PowerLine artifacts are installed. Uses $HOME (not ~) so it expands inside double-quoted shell strings. */
-declare const REMOTE_POWERLINE_DIRECTORY: string;
-/**
- * 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/server/dist/adapters → 4 levels up).
- * The old approach (checking for a sibling powerline dist) would false-positive when
- * `@grackle-ai/powerline` is installed alongside the server in node_modules.
- */
-export declare function isDevMode(): boolean;
-/** 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>;
-}
-/** 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;
-}
-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): 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(): Promise<void>;
-/**
- * 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;
-    constructor(localPort: number);
-    /** 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;
-}
-/**
- * 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>): 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>;
-/** Options for {@link startRemotePowerLine}. */
-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;
-}
-/**
- * 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;
-}>;
-/**
- * Bootstrap the PowerLine on a remote host via the given executor.
- * Yields progress events for each stage of the process.
- * @param extraEnv - Additional env vars to forward (from adapter config).
- */
-export declare function bootstrapPowerLine(executor: RemoteExecutor, powerlineToken: string, extraEnv?: Record<string, string>, workingDirectory?: string, host?: string): AsyncGenerator<ProvisionEvent>;
-/**
- * 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): 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>;
-/**
- * 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;
-/**
- * Stop the remote PowerLine process and close the tunnel.
- * Shared by SSH and Codespace adapters.
- */
-export declare function remoteStop(environmentId: string, executor: RemoteExecutor): 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): Promise<void>;
-/** Check that the tunnel is alive and the PowerLine responds to a ping. */
-export declare function remoteHealthCheck(connection: PowerLineConnection): Promise<boolean>;
-export { findFreePort, REMOTE_POWERLINE_DIRECTORY, SSH_CONNECTIVITY_TIMEOUT_MS, REMOTE_EXEC_DEFAULT_TIMEOUT_MS };
-//# sourceMappingURL=remote-adapter-utils.d.ts.map

package/dist/adapters/remote-adapter-utils.d.ts.map

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