@action-llama/action-llama 0.27.5 → 0.28.0

package/dist/transport/ssh.js

@@ -0,0 +1,225 @@
+/**
+ * SshTransport — executes commands on a remote host via a persistent SSH
+ * connection. Shell state (cwd, env vars) persists across exec() calls.
+ *
+ * File I/O uses the same SSH connection's stdin/stdout with base64 encoding
+ * to avoid opening additional connections.
+ */
+import { spawn } from "child_process";
+import { randomBytes } from "crypto";
+/** How long to wait for the shell to become ready after connecting (ms). */
+const SHELL_READY_TIMEOUT_MS = 15_000;
+/** Default command execution timeout (ms). */
+const DEFAULT_EXEC_TIMEOUT_MS = 300_000;
+/** Generate a unique delimiter that won't appear in command output. */
+function makeDelimiter() {
+    return `__AL_DELIM_${randomBytes(8).toString("hex")}__`;
+}
+export class SshTransport {
+    opts;
+    shell = null;
+    ready = false;
+    buffer = "";
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /** Establish the persistent SSH shell session. Must be called before exec(). */
+    async connect() {
+        const args = [
+            "-tt", // Force PTY allocation for interactive shell
+            "-o", "BatchMode=yes",
+            "-o", "ServerAliveInterval=15",
+            "-o", "ServerAliveCountMax=3",
+        ];
+        if (this.opts.port) {
+            args.push("-p", String(this.opts.port));
+        }
+        if (this.opts.keyPath) {
+            args.push("-i", this.opts.keyPath);
+        }
+        // Apply custom SSH options
+        if (this.opts.sshOptions) {
+            for (const [key, value] of Object.entries(this.opts.sshOptions)) {
+                args.push("-o", `${key}=${value}`);
+            }
+        }
+        const target = this.opts.user
+            ? `${this.opts.user}@${this.opts.host}`
+            : this.opts.host;
+        args.push(target);
+        // Launch interactive shell
+        args.push("bash", "--norc", "--noprofile");
+        this.shell = spawn("ssh", args, {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.shell.stdout.on("data", (chunk) => {
+            // Strip ANSI escape sequences and carriage returns from PTY output
+            this.buffer += stripAnsi(chunk.toString());
+        });
+        this.shell.on("exit", () => {
+            this.ready = false;
+        });
+        // Wait for shell to be ready
+        const readyDelim = makeDelimiter();
+        this.shell.stdin.write(`echo "${readyDelim} $?"\n`);
+        await this.waitForDelimiter(readyDelim, this.opts.connectTimeoutMs ?? SHELL_READY_TIMEOUT_MS);
+        this.ready = true;
+        // Set initial cwd if specified
+        if (this.opts.cwd) {
+            await this.exec(`cd ${shellQuote(this.opts.cwd)}`);
+        }
+    }
+    /**
+     * Wait for a delimiter to appear in the stdout buffer.
+     * Returns the output before the delimiter and the exit code.
+     */
+    waitForDelimiter(delimiter, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                clearInterval(poll);
+                reject(new Error(`Timed out waiting for SSH shell response (${timeoutMs}ms)`));
+            }, timeoutMs);
+            const check = () => {
+                const idx = this.buffer.indexOf(delimiter);
+                if (idx === -1)
+                    return;
+                const lineEnd = this.buffer.indexOf("\n", idx);
+                if (lineEnd === -1)
+                    return;
+                const output = this.buffer.slice(0, idx);
+                const delimLine = this.buffer.slice(idx, lineEnd);
+                this.buffer = this.buffer.slice(lineEnd + 1);
+                clearTimeout(timer);
+                clearInterval(poll);
+                const match = delimLine.match(/\s+(\d+)\s*$/);
+                const exitCode = match ? parseInt(match[1], 10) : 0;
+                resolve({ output, exitCode });
+            };
+            const poll = setInterval(check, 10);
+            check();
+        });
+    }
+    async exec(command, options) {
+        if (!this.shell || !this.ready) {
+            throw new Error("Transport not connected. Call connect() first.");
+        }
+        const delimiter = makeDelimiter();
+        let stderr = "";
+        const stderrHandler = (chunk) => {
+            stderr += chunk.toString();
+        };
+        this.shell.stderr.on("data", stderrHandler);
+        // Abort handling
+        let aborted = false;
+        const onAbort = () => {
+            aborted = true;
+            this.shell?.stdin?.write("\x03\n");
+        };
+        if (options?.signal) {
+            if (options.signal.aborted) {
+                this.shell.stderr.removeListener("data", stderrHandler);
+                return { stdout: "", stderr: "Aborted", exitCode: 130 };
+            }
+            options.signal.addEventListener("abort", onAbort, { once: true });
+        }
+        const timeoutMs = options?.timeout ?? DEFAULT_EXEC_TIMEOUT_MS;
+        // Streaming
+        let streamingInterval;
+        let lastStreamedIdx = 0;
+        if (options?.onData) {
+            streamingInterval = setInterval(() => {
+                if (this.buffer.length > lastStreamedIdx) {
+                    const newData = this.buffer.slice(lastStreamedIdx);
+                    const delimIdx = newData.indexOf("__AL_DELIM_");
+                    const safeData = delimIdx >= 0 ? newData.slice(0, delimIdx) : newData;
+                    if (safeData.length > 0) {
+                        options.onData(Buffer.from(safeData));
+                        lastStreamedIdx += safeData.length;
+                    }
+                }
+            }, 50);
+        }
+        try {
+            this.shell.stdin.write(`${command}\necho "${delimiter} $?"\n`);
+            const { output, exitCode } = await this.waitForDelimiter(delimiter, timeoutMs);
+            return {
+                stdout: output.trimEnd(),
+                stderr: stderr.trimEnd(),
+                exitCode: aborted ? 130 : exitCode,
+            };
+        }
+        catch (err) {
+            if (aborted) {
+                return { stdout: "", stderr: "Aborted", exitCode: 130 };
+            }
+            throw err;
+        }
+        finally {
+            this.shell.stderr.removeListener("data", stderrHandler);
+            if (options?.signal) {
+                options.signal.removeEventListener("abort", onAbort);
+            }
+            if (streamingInterval)
+                clearInterval(streamingInterval);
+        }
+    }
+    async readFiles(paths) {
+        const result = new Map();
+        if (paths.length === 0)
+            return result;
+        // Use base64 encoding over the shell to read files without extra connections.
+        // For each file: base64-encode → capture in delimiter-framed output → decode locally.
+        for (const path of paths) {
+            try {
+                const { stdout, exitCode } = await this.exec(`test -r ${shellQuote(path)} && base64 ${shellQuote(path)} || echo "__AL_FILE_MISSING__"`, { timeout: 30_000 });
+                if (exitCode === 0 && !stdout.includes("__AL_FILE_MISSING__")) {
+                    // Remove any whitespace (base64 may be wrapped)
+                    const cleaned = stdout.replace(/\s/g, "");
+                    result.set(path, Buffer.from(cleaned, "base64"));
+                }
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+        return result;
+    }
+    async writeFiles(files) {
+        if (files.size === 0)
+            return;
+        // Use base64 encoding over the shell to write files without extra connections.
+        for (const [path, content] of files) {
+            const dir = path.substring(0, path.lastIndexOf("/"));
+            if (dir && dir !== "/") {
+                await this.exec(`mkdir -p ${shellQuote(dir)}`, { timeout: 10_000 });
+            }
+            const b64 = content.toString("base64");
+            // Use heredoc to avoid shell argument length limits
+            await this.exec(`echo '${b64}' | base64 -d > ${shellQuote(path)}`, { timeout: 30_000 });
+        }
+    }
+    async close() {
+        if (this.shell) {
+            this.ready = false;
+            try {
+                this.shell.stdin?.write("exit\n");
+                this.shell.stdin?.end();
+            }
+            catch {
+                // stdin may already be closed
+            }
+            this.shell.kill();
+            this.shell = null;
+        }
+    }
+}
+/** Escape a string for use in a shell command. */
+function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+/** Strip ANSI escape sequences and carriage returns from PTY output. */
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").replace(/\r/g, "");
+}
+//# sourceMappingURL=ssh.js.map

package/dist/transport/ssh.js.map

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

package/dist/transport/transport.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Transport — the abstraction layer between the scheduler (brain) and runtime (body).
+ *
+ * A transport provides a persistent connection to a runtime environment (container, VM,
+ * OS user) through which the scheduler can execute commands and transfer files. The agent
+ * (LLM) doesn't know about the transport — it sees standard tools (bash, read, write, edit)
+ * that happen to execute remotely.
+ *
+ * Transport implementations:
+ *  - DockerExecTransport — local Docker via `docker exec`
+ *  - SshTransport — remote VMs via SSH (future)
+ *  - HostUserTransport — local OS user via `sudo -u` (future)
+ */
+/** Result of executing a command on the runtime. */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+/** Options for command execution. */
+export interface ExecOptions {
+    /** Callback for streaming stdout data as it arrives. */
+    onData?: (data: Buffer) => void;
+    /** AbortSignal to cancel execution. */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds. */
+    timeout?: number;
+}
+/**
+ * Transport interface — the contract all transport implementations must satisfy.
+ *
+ * Provides two channels:
+ *  1. A persistent shell session for command execution (exec)
+ *  2. A file transfer mechanism for reading/writing files (readFiles/writeFiles)
+ */
+export interface Transport {
+    /**
+     * Execute a command in the persistent shell session.
+     * Shell state (cwd, env vars) persists across calls.
+     */
+    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+    /**
+     * Read multiple files from the runtime in a single batch.
+     * Returns a map of path → contents. Missing files are omitted from the result.
+     */
+    readFiles(paths: string[]): Promise<Map<string, Buffer>>;
+    /**
+     * Write multiple files to the runtime in a single batch.
+     * Creates parent directories as needed.
+     */
+    writeFiles(files: Map<string, Buffer>): Promise<void>;
+    /** Close the transport connection and release resources. */
+    close(): Promise<void>;
+}
+/** Convenience: read a single file via the transport. */
+export declare function readFile(transport: Transport, path: string): Promise<Buffer>;
+/** Convenience: write a single file via the transport. */
+export declare function writeFile(transport: Transport, path: string, content: Buffer): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAElE;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzD;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,4DAA4D;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,yDAAyD;AACzD,wBAAsB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlF;AAED,0DAA0D;AAC1D,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlG"}

package/dist/transport/transport.js

@@ -0,0 +1,29 @@
+/**
+ * Transport — the abstraction layer between the scheduler (brain) and runtime (body).
+ *
+ * A transport provides a persistent connection to a runtime environment (container, VM,
+ * OS user) through which the scheduler can execute commands and transfer files. The agent
+ * (LLM) doesn't know about the transport — it sees standard tools (bash, read, write, edit)
+ * that happen to execute remotely.
+ *
+ * Transport implementations:
+ *  - DockerExecTransport — local Docker via `docker exec`
+ *  - SshTransport — remote VMs via SSH (future)
+ *  - HostUserTransport — local OS user via `sudo -u` (future)
+ */
+/** Convenience: read a single file via the transport. */
+export async function readFile(transport, path) {
+    const result = await transport.readFiles([path]);
+    const content = result.get(path);
+    if (!content) {
+        throw new Error(`File not found: ${path}`);
+    }
+    return content;
+}
+/** Convenience: write a single file via the transport. */
+export async function writeFile(transport, path, content) {
+    const files = new Map();
+    files.set(path, content);
+    await transport.writeFiles(files);
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiDH,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAoB,EAAE,IAAY;IAC/D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAoB,EAAE,IAAY,EAAE,OAAe;IACjF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,MAAM,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@action-llama/action-llama",
-  "version": "0.27.5",
+  "version": "0.28.0",
   "description": "Automated development agents triggered by cron or webhooks. BYOM — bring your own model.",
   "type": "module",
   "license": "MIT",

package/dist/agents/container-entry.d.ts

@@ -1,31 +0,0 @@
-import { DefaultResourceLoader, SettingsManager } from "@mariozechner/pi-coding-agent";
-import type { AgentConfig } from "../shared/config.js";
-/**
- * Components initialized once and reused across invocations (Lambda) or
- * used for the single run (Docker/ECS).
- */
-export interface AgentInit {
-    agentConfig: AgentConfig;
-    skillBody: string;
-    timeoutSeconds: number;
-    resourceLoader: InstanceType<typeof DefaultResourceLoader>;
-    settingsManager: ReturnType<typeof SettingsManager.inMemory>;
-    signalDir: string;
-}
-/**
- * One-time initialization — called once during Lambda init (cold start) or
- * at the start of a direct container run. Sets up PATH, signal dir, loads
- * static config, creates reusable model/resourceLoader/settingsManager.
- */
-export declare function initAgent(): Promise<AgentInit>;
-/**
- * Per-invocation handler. Loads credentials, creates a session, runs the
- * prompt, reads signals, and returns an exit code.
- */
-export declare function handleInvocation(init: AgentInit): Promise<number>;
-/**
- * Legacy single-function entrypoint. Calls initAgent() then handleInvocation().
- * Kept for backward compatibility with non-Lambda container runs.
- */
-export declare function runAgent(): Promise<number>;
-//# sourceMappingURL=container-entry.d.ts.map

package/dist/agents/container-entry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"container-entry.d.ts","sourceRoot":"","sources":["../../src/agents/container-entry.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EACrB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAyBvD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC3D,eAAe,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAiGpD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAkMvE;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAGhD"}