@snoglobe/helios 0.1.0

package/dist/providers/sse.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared SSE (Server-Sent Events) stream parser.
+ * Both Claude and OpenAI providers use SSE framing with identical structure.
+ */
+export declare function parseSSELines(resp: Response): AsyncGenerator<unknown>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/providers/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/providers/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAuB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CA4B5E"}

package/dist/providers/sse.js

@@ -0,0 +1,35 @@
+/**
+ * Shared SSE (Server-Sent Events) stream parser.
+ * Both Claude and OpenAI providers use SSE framing with identical structure.
+ */
+export async function* parseSSELines(resp) {
+    const reader = resp.body?.getReader();
+    if (!reader)
+        throw new Error("No response body");
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (!line.startsWith("data: "))
+                continue;
+            const data = line.slice(6).trim();
+            if (!data || data === "[DONE]")
+                continue;
+            try {
+                yield JSON.parse(data);
+            }
+            catch (e) {
+                // Skip malformed/partial JSON, re-throw anything else
+                if (!(e instanceof SyntaxError))
+                    throw e;
+            }
+        }
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/providers/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/providers/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAAC,IAAc;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAEjD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAEzC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,sDAAsD;gBACtD,IAAI,CAAC,CAAC,CAAC,YAAY,WAAW,CAAC;oBAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export interface TextEvent {
+    type: "text";
+    text: string;
+    /** Incremental delta for streaming */
+    delta?: string;
+}
+export interface ToolCallEvent {
+    type: "tool_call";
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface ToolResultEvent {
+    type: "tool_result";
+    callId: string;
+    result: string;
+    isError?: boolean;
+}
+export interface ErrorEvent {
+    type: "error";
+    error: Error;
+    recoverable: boolean;
+}
+export interface DoneEvent {
+    type: "done";
+    usage?: TokenUsage;
+}
+export type AgentEvent = TextEvent | ToolCallEvent | ToolResultEvent | ErrorEvent | DoneEvent;
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    costUsd?: number;
+}
+export interface Session {
+    id: string;
+    providerId: string;
+    providerSessionId?: string;
+    createdAt: number;
+    lastActiveAt: number;
+}
+export interface SessionConfig {
+    systemPrompt?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export declare const ToolParameterSchema: z.ZodObject<{
+    type: z.ZodLiteral<"object">;
+    properties: z.ZodRecord<z.ZodString, z.ZodAny>;
+    required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: z.infer<typeof ToolParameterSchema>;
+    execute: (args: Record<string, unknown>) => Promise<string>;
+}
+export interface ModelProvider {
+    readonly name: "claude" | "openai";
+    readonly displayName: string;
+    /** Check if the provider is authenticated */
+    isAuthenticated(): Promise<boolean>;
+    /** Initiate authentication flow */
+    authenticate(): Promise<void>;
+    /** Create a new conversation session */
+    createSession(config: SessionConfig): Promise<Session>;
+    /** Resume an existing session */
+    resumeSession(id: string): Promise<Session>;
+    /** Send a message and stream events */
+    send(session: Session, message: string, tools: ToolDefinition[]): AsyncGenerator<AgentEvent>;
+    /** Interrupt the current generation */
+    interrupt(session: Session): void;
+    /** Replace conversation history with a checkpoint briefing (context window management). */
+    resetHistory(session: Session, briefingMessage: string): void;
+    /** Clean up session resources */
+    closeSession(session: Session): Promise<void>;
+    /** Fetch available models (optional) */
+    fetchModels?(): Promise<ModelInfo[]>;
+    /** Get/set the current model */
+    currentModel: string;
+    /** Get/set reasoning effort */
+    reasoningEffort: ReasoningEffort;
+}
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+export interface ModelInfo {
+    id: string;
+    name: string;
+    description?: string;
+}
+/** Faux-assistant response used after a context checkpoint reset. */
+export declare const CHECKPOINT_ACK = "Understood. I have my memory tree and will continue working. Let me check what needs to be done.";
+export type AuthMethod = "api_key" | "oauth";
+export interface AuthCredentials {
+    method: AuthMethod;
+    provider: "claude" | "openai";
+    accessToken?: string;
+    refreshToken?: string;
+    apiKey?: string;
+    expiresAt?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

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

package/dist/providers/types.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+// --- Tool Definition ---
+export const ToolParameterSchema = z.object({
+    type: z.literal("object"),
+    properties: z.record(z.string(), z.any()),
+    required: z.array(z.string()).optional(),
+});
+// --- Constants ---
+/** Faux-assistant response used after a context checkpoint reset. */
+export const CHECKPOINT_ACK = "Understood. I have my memory tree and will continue working. Let me check what needs to be done.";
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoExB,0BAA0B;AAE1B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AA+DH,oBAAoB;AAEpB,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,kGAAkG,CAAC"}

package/dist/remote/config.d.ts

@@ -0,0 +1,14 @@
+import type { RemoteMachine } from "./types.js";
+export declare function loadMachines(): RemoteMachine[];
+export declare function saveMachines(machines: RemoteMachine[]): void;
+export declare function addMachine(machine: RemoteMachine): void;
+export declare function removeMachine(id: string): boolean;
+/**
+ * Parse a machine spec string into a RemoteMachine.
+ * Format: user@host[:port] [--key path] [--auth agent|key|password]
+ */
+export declare function parseMachineSpec(id: string, spec: string, options?: {
+    key?: string;
+    auth?: string;
+}): RemoteMachine;
+//# sourceMappingURL=config.d.ts.map

package/dist/remote/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/remote/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWhD,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAU9C;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAG5D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CASvD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,aAAa,CA6Bf"}

package/dist/remote/config.js

@@ -0,0 +1,81 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = join(homedir(), ".helios");
+const MACHINES_FILE = join(CONFIG_DIR, "machines.json");
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+export function loadMachines() {
+    try {
+        if (!existsSync(MACHINES_FILE))
+            return [];
+        const data = readFileSync(MACHINES_FILE, "utf-8");
+        const parsed = JSON.parse(data);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed;
+    }
+    catch {
+        return [];
+    }
+}
+export function saveMachines(machines) {
+    ensureConfigDir();
+    writeFileSync(MACHINES_FILE, JSON.stringify(machines, null, 2), "utf-8");
+}
+export function addMachine(machine) {
+    const machines = loadMachines();
+    const existing = machines.findIndex((m) => m.id === machine.id);
+    if (existing >= 0) {
+        machines[existing] = machine;
+    }
+    else {
+        machines.push(machine);
+    }
+    saveMachines(machines);
+}
+export function removeMachine(id) {
+    const machines = loadMachines();
+    const filtered = machines.filter((m) => m.id !== id);
+    if (filtered.length === machines.length)
+        return false;
+    saveMachines(filtered);
+    return true;
+}
+/**
+ * Parse a machine spec string into a RemoteMachine.
+ * Format: user@host[:port] [--key path] [--auth agent|key|password]
+ */
+export function parseMachineSpec(id, spec, options = {}) {
+    // Parse user@host[:port]
+    const atIdx = spec.indexOf("@");
+    if (atIdx < 0)
+        throw new Error("Format: user@host[:port]");
+    const username = spec.slice(0, atIdx);
+    const hostPart = spec.slice(atIdx + 1);
+    let host;
+    let port = 22;
+    const colonIdx = hostPart.lastIndexOf(":");
+    if (colonIdx >= 0) {
+        host = hostPart.slice(0, colonIdx);
+        port = parseInt(hostPart.slice(colonIdx + 1), 10);
+        if (isNaN(port))
+            throw new Error("Invalid port number");
+    }
+    else {
+        host = hostPart;
+    }
+    const authMethod = options.auth ?? (options.key ? "key" : "agent");
+    return {
+        id,
+        host,
+        port,
+        username,
+        authMethod,
+        keyPath: options.key,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/remote/config.js.map

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

package/dist/remote/connection-pool.d.ts

@@ -0,0 +1,26 @@
+import type { RemoteMachine, ExecResult, ConnectionStatus } from "./types.js";
+export declare const LOCAL_MACHINE: RemoteMachine;
+export declare class ConnectionPool {
+    private connections;
+    private machines;
+    constructor();
+    addMachine(machine: RemoteMachine): void;
+    removeMachine(id: string): void;
+    connect(machineId: string): Promise<void>;
+    exec(machineId: string, command: string): Promise<ExecResult>;
+    private execLocal;
+    execBackground(machineId: string, command: string, logPath?: string): Promise<{
+        pid: number;
+        logPath: string;
+    }>;
+    private execBackgroundLocal;
+    isProcessRunning(machineId: string, pid: number): Promise<boolean>;
+    tailFile(machineId: string, path: string, lines?: number): Promise<string>;
+    getStatus(machineId: string): ConnectionStatus;
+    getAllStatuses(): ConnectionStatus[];
+    getMachineIds(): string[];
+    disconnect(machineId: string): void;
+    disconnectAll(): void;
+    private getConnection;
+}
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/remote/connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/remote/connection-pool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,aAAa,EAAE,aAO3B,CAAC;AAWF,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,QAAQ,CAAoC;;IAcpD,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMzB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiFzC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BnE,OAAO,CAAC,SAAS;IAwBX,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB5C,OAAO,CAAC,mBAAmB;IAuCrB,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC;IAQb,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAK,GACT,OAAO,CAAC,MAAM,CAAC;IAKlB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAU9C,cAAc,IAAI,gBAAgB,EAAE;IAMpC,aAAa,IAAI,MAAM,EAAE;IAIzB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASnC,aAAa,IAAI,IAAI;YAMP,aAAa;CAa5B"}

package/dist/remote/connection-pool.js

@@ -0,0 +1,268 @@
+import { Client } from "ssh2";
+import { exec as cpExec, spawn } from "node:child_process";
+import { readFileSync, openSync, closeSync } from "node:fs";
+export const LOCAL_MACHINE = {
+    id: "local",
+    host: "localhost",
+    port: 0,
+    username: process.env.USER ?? "local",
+    authMethod: "local",
+    labels: ["local"],
+};
+export class ConnectionPool {
+    connections = new Map();
+    machines = new Map();
+    constructor() {
+        // Always register the local machine
+        this.machines.set("local", LOCAL_MACHINE);
+        this.connections.set("local", {
+            client: null,
+            machine: LOCAL_MACHINE,
+            connected: true,
+            lastUsedAt: Date.now(),
+            reconnectAttempts: 0,
+        });
+    }
+    addMachine(machine) {
+        this.machines.set(machine.id, machine);
+    }
+    removeMachine(id) {
+        if (id === "local")
+            return; // Can't remove local
+        this.disconnect(id);
+        this.machines.delete(id);
+    }
+    async connect(machineId) {
+        if (machineId === "local")
+            return; // Always connected
+        const machine = this.machines.get(machineId);
+        if (!machine)
+            throw new Error(`Unknown machine: ${machineId}`);
+        const existing = this.connections.get(machineId);
+        if (existing?.connected)
+            return;
+        // Clean up any previous failed client before creating a new one
+        if (existing?.client) {
+            try {
+                existing.client.end();
+            }
+            catch { /* best effort */ }
+        }
+        const client = new Client();
+        return new Promise((resolve, reject) => {
+            client.on("ready", () => {
+                this.connections.set(machineId, {
+                    client,
+                    machine,
+                    connected: true,
+                    lastUsedAt: Date.now(),
+                    reconnectAttempts: 0,
+                });
+                resolve();
+            });
+            client.on("error", (err) => {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                const conn = this.connections.get(machineId);
+                if (conn) {
+                    conn.connected = false;
+                    conn.lastError = errMsg;
+                }
+                else {
+                    this.connections.set(machineId, {
+                        client,
+                        machine,
+                        connected: false,
+                        lastUsedAt: Date.now(),
+                        reconnectAttempts: 0,
+                        lastError: errMsg,
+                    });
+                }
+                reject(err);
+            });
+            client.on("close", () => {
+                const conn = this.connections.get(machineId);
+                if (conn)
+                    conn.connected = false;
+            });
+            const connectConfig = {
+                host: machine.host,
+                port: machine.port,
+                username: machine.username,
+                keepaliveInterval: 30_000,
+                keepaliveCountMax: 3,
+                readyTimeout: 30_000,
+            };
+            if (machine.authMethod === "key" && machine.keyPath) {
+                try {
+                    connectConfig.privateKey = readFileSync(machine.keyPath);
+                }
+                catch (err) {
+                    return reject(new Error(`Cannot read SSH key at ${machine.keyPath}: ${err instanceof Error ? err.message : String(err)}`));
+                }
+            }
+            else if (machine.authMethod === "agent") {
+                const sock = process.env.SSH_AUTH_SOCK;
+                if (!sock) {
+                    return reject(new Error("SSH_AUTH_SOCK not set — cannot use agent auth. Start ssh-agent or use key auth."));
+                }
+                connectConfig.agent = sock;
+            }
+            else if (machine.authMethod === "password" && machine.password) {
+                connectConfig.password = machine.password;
+            }
+            client.connect(connectConfig);
+        });
+    }
+    async exec(machineId, command) {
+        if (machineId === "local") {
+            return this.execLocal(command);
+        }
+        const conn = await this.getConnection(machineId);
+        conn.lastUsedAt = Date.now();
+        return new Promise((resolve, reject) => {
+            conn.client.exec(command, (err, stream) => {
+                if (err)
+                    return reject(err);
+                let stdout = "";
+                let stderr = "";
+                stream.on("data", (data) => {
+                    stdout += data.toString();
+                });
+                stream.stderr.on("data", (data) => {
+                    stderr += data.toString();
+                });
+                stream.on("error", (streamErr) => {
+                    reject(streamErr);
+                });
+                stream.on("close", (code) => {
+                    resolve({ stdout, stderr, exitCode: code ?? 0 });
+                });
+            });
+        });
+    }
+    execLocal(command, timeoutMs = 300_000) {
+        return new Promise((resolve) => {
+            cpExec(command, { maxBuffer: 10 * 1024 * 1024, timeout: timeoutMs, shell: "/bin/bash" }, (err, stdout, stderr) => {
+                let exitCode = 0;
+                if (err) {
+                    // err.code can be number (exit code), string (error code like ETIMEDOUT), or null (signal kill)
+                    if (typeof err.code === "number") {
+                        exitCode = err.code;
+                    }
+                    else if (err.signal) {
+                        // Process killed by signal — report as non-zero
+                        exitCode = 128 + ({ SIGHUP: 1, SIGINT: 2, SIGQUIT: 3, SIGTERM: 15, SIGKILL: 9 }[err.signal] ?? 1);
+                    }
+                    else {
+                        exitCode = 1;
+                    }
+                }
+                resolve({
+                    stdout: stdout ?? "",
+                    stderr: stderr ?? "",
+                    exitCode,
+                });
+            });
+        });
+    }
+    async execBackground(machineId, command, logPath) {
+        const log = logPath ?? `/tmp/helios-${Date.now()}.log`;
+        if (machineId === "local") {
+            return this.execBackgroundLocal(command, log);
+        }
+        // Remote: use nohup + & over SSH (SSH channels close cleanly)
+        // PYTHONUNBUFFERED ensures Python flushes stdout immediately for live metric capture
+        const wrappedCmd = `PYTHONUNBUFFERED=1 nohup ${command} > ${log} 2>&1 & echo $!`;
+        const result = await this.exec(machineId, wrappedCmd);
+        const pid = parseInt(result.stdout.trim().split("\n").pop() ?? "", 10);
+        if (isNaN(pid)) {
+            throw new Error(`Failed to get PID. stdout: ${result.stdout}, stderr: ${result.stderr}`);
+        }
+        return { pid, logPath: log };
+    }
+    execBackgroundLocal(command, logPath) {
+        return new Promise((resolve, reject) => {
+            let logFd = null;
+            try {
+                // Open the log file for writing
+                logFd = openSync(logPath, "w");
+                // Spawn detached with stdio redirected to log file
+                // PYTHONUNBUFFERED ensures Python flushes stdout immediately for live metric capture
+                const child = spawn("/bin/bash", ["-c", command], {
+                    detached: true,
+                    stdio: ["ignore", logFd, logFd],
+                    env: { ...process.env, PYTHONUNBUFFERED: "1" },
+                });
+                const pid = child.pid;
+                if (pid === undefined) {
+                    closeSync(logFd);
+                    reject(new Error("Failed to spawn background process"));
+                    return;
+                }
+                // Fully detach — don't let Node wait for this child
+                child.unref();
+                closeSync(logFd);
+                resolve({ pid, logPath });
+            }
+            catch (err) {
+                if (logFd !== null) {
+                    try {
+                        closeSync(logFd);
+                    }
+                    catch { /* best effort */ }
+                }
+                reject(err);
+            }
+        });
+    }
+    async isProcessRunning(machineId, pid) {
+        const result = await this.exec(machineId, `kill -0 ${pid} 2>/dev/null && echo "running" || echo "stopped"`);
+        return result.stdout.trim() === "running";
+    }
+    async tailFile(machineId, path, lines = 50) {
+        const result = await this.exec(machineId, `tail -n ${lines} '${path.replace(/'/g, "'\\''")}'`);
+        return result.stdout;
+    }
+    getStatus(machineId) {
+        const conn = this.connections.get(machineId);
+        return {
+            machineId,
+            connected: conn?.connected ?? false,
+            lastConnectedAt: conn?.lastUsedAt,
+            error: conn?.lastError,
+        };
+    }
+    getAllStatuses() {
+        return Array.from(this.machines.keys()).map((id) => this.getStatus(id));
+    }
+    getMachineIds() {
+        return Array.from(this.machines.keys());
+    }
+    disconnect(machineId) {
+        if (machineId === "local")
+            return;
+        const conn = this.connections.get(machineId);
+        if (conn) {
+            conn.client?.end();
+            this.connections.delete(machineId);
+        }
+    }
+    disconnectAll() {
+        for (const [id] of this.connections) {
+            if (id !== "local")
+                this.disconnect(id);
+        }
+    }
+    async getConnection(machineId) {
+        let conn = this.connections.get(machineId);
+        if (!conn?.connected) {
+            await this.connect(machineId);
+            conn = this.connections.get(machineId);
+        }
+        if (!conn?.connected) {
+            throw new Error(`Cannot connect to ${machineId}`);
+        }
+        return conn;
+    }
+}
+//# sourceMappingURL=connection-pool.js.map

package/dist/remote/connection-pool.js.map

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

package/dist/remote/executor.d.ts

@@ -0,0 +1,23 @@
+import { ConnectionPool } from "./connection-pool.js";
+import type { ExecResult, BackgroundProcess } from "./types.js";
+/**
+ * High-level remote execution interface.
+ * Wraps ConnectionPool with task tracking and convenience methods.
+ */
+export declare class RemoteExecutor {
+    private pool;
+    private backgroundProcesses;
+    constructor(pool: ConnectionPool);
+    exec(machineId: string, command: string, timeoutMs?: number): Promise<ExecResult>;
+    execBackground(machineId: string, command: string, logPath?: string, opts?: {
+        metricNames?: string[];
+        metricPatterns?: Record<string, string>;
+    }): Promise<BackgroundProcess>;
+    isRunning(machineId: string, pid: number): Promise<boolean>;
+    tail(machineId: string, path: string, lines?: number): Promise<string>;
+    gpuStatus(machineId: string): Promise<string>;
+    getBackgroundProcesses(): BackgroundProcess[];
+    getBackgroundProcess(machineId: string, pid: number): BackgroundProcess | undefined;
+    removeBackgroundProcess(key: string): void;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/remote/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;GAGG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,mBAAmB,CAAwC;gBAE/C,IAAI,EAAE,cAAc;IAElC,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC;IAQhB,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GACzE,OAAO,CAAC,iBAAiB,CAAC;IAsBvB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAK,GACT,OAAO,CAAC,MAAM,CAAC;IAIZ,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnD,sBAAsB,IAAI,iBAAiB,EAAE;IAI7C,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,iBAAiB,GAAG,SAAS;IAIhC,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG3C"}