@almyty/runner 1.2.0

package/README.md

@@ -0,0 +1,72 @@
+# @almyty/runner
+
+A long-running CLI daemon that executes processes on a user's machine on behalf of almyty agents. Lets a workflow orchestrate any CLI coding agent (Claude Code, Codex, Gemini, aider, …) on your codebase, in one coherent workspace.
+
+## Install
+
+```
+npx @almyty/runner start --name my-laptop
+```
+
+Three commands in three minutes:
+
+```
+npx @almyty/auth login          # if you haven't already
+npx @almyty/runner start --name my-laptop --label os=macos
+# in another terminal:
+npx @almyty/runner status
+```
+
+Stop with `npx @almyty/runner stop` or ctrl-c in the daemon's terminal.
+
+Or use the UI: log into your almyty account and head to **Runners → Start a runner**. The page generates the exact start command for you and waits for the daemon to come online before redirecting to the runner detail.
+
+## What the runner does
+
+The runner exposes a small process surface (spawn, write, read, signal, wait_for_idle, wait, list, shell.exec, runner.info) over a persistent connection to almyty. Agents call those methods, scoped to a workspace, and the runner runs the actual processes on your machine. It does not bake in any tool-specific knowledge: there is no `claude_code.run` or `codex.run`. Tool intelligence lives in agent prompts; the runner is generic.
+
+## Config
+
+JSON, layered lowest precedence first:
+
+1. Built-in defaults (most restrictive: container isolation, no installs, no network)
+2. `~/.almyty/config.json` (global)
+3. `./.almyty/config.json` (project-local)
+4. Environment variables (`ALMYTY_URL`, `ALMYTY_TOKEN`, `ALMYTY_RUNNER_NAME`, `ALMYTY_RUNNER_ISOLATION`)
+5. CLI flags (`--name`, `--label`, `--config`, `--url`)
+6. Backend overrides (constrain-only; never escalate)
+
+A minimal `~/.almyty/config.json`:
+
+```json
+{
+  "name": "my-laptop",
+  "labels": { "env": "dev", "os": "macos" },
+  "config": {
+    "defaultIsolation": "host",
+    "maxConcurrent": 4,
+    "allowedCwdRoots": ["/Users/frane/workspace"],
+    "denyPatterns": [],
+    "networkBlocked": false,
+    "installBlocked": true
+  }
+}
+```
+
+## Architecture
+
+See [docs/runner.md](../../docs/runner.md) for the load-bearing design decisions: Streamable HTTP transport, no per-tool wrappers, PTY by default, detected vs configured fields, resource scoping, and config layering.
+
+.
+
+## About almyty
+
+almyty is the full-stack platform for AI agents, agnostic by design: any LLM, any
+API turned into tools, served over MCP, A2A, UTCP, and Agent Skills. Open source,
+no lock-in.
+
+- Website — https://almyty.com
+- Docs — https://docs.almyty.com
+- Source — https://github.com/almyty-inc/almyty
+
+Apache-2.0 © Almyty Inc.

package/dist/binaries.d.ts

@@ -0,0 +1,30 @@
+export interface BinaryProbe {
+    name: string;
+    /**
+     * Override the default exec function. Tests inject a stub that
+     * returns canned stdout/stderr/exit without spawning a real
+     * subprocess. Default implementation calls child_process.spawn.
+     */
+    exec?: ProbeExec;
+}
+export type ProbeExec = (bin: string, args: string[]) => Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    timedOut: boolean;
+}>;
+export declare const realExec: ProbeExec;
+/**
+ * Probe a single binary. Returns the version string (first line of
+ * stdout or stderr) or `null` if absent. Empty output with exit 0 is
+ * still treated as truthy presence — the binary is on PATH and exits
+ * cleanly, so it counts; we report 'unknown' so the catalog reflects
+ * presence even when version output is empty.
+ */
+export declare function probe(name: string, execImpl?: ProbeExec): Promise<string | null>;
+/**
+ * Probe a list of binaries concurrently. Bounded by the OS subprocess
+ * cap implicitly; in practice a 15-binary probe finishes well under
+ * a second on macOS/Linux.
+ */
+export declare function probeAll(names: string[], execImpl?: ProbeExec): Promise<Record<string, string | null>>;

package/dist/binaries.js

@@ -0,0 +1,99 @@
+import { spawn } from 'child_process';
+const VERSION_TIMEOUT_MS = 1500;
+/**
+ * Probe `binary --version` (or equivalent) with a tight timeout.
+ * Returns the first non-empty line of stdout/stderr the binary emits,
+ * or `null` if the binary is not on PATH or did not respond inside
+ * the timeout. Some tools print version to stderr (cargo, rustc); we
+ * accept output from either stream.
+ *
+ * The probe runs on a few binaries that don't accept --version (none
+ * in the default list at the moment, but `aider` and others have
+ * special-cased flags in the past). We pick a list of fallback flags
+ * per-binary; if none of them produce output, we still return null
+ * rather than mis-reporting the binary as missing.
+ */
+const VERSION_FLAGS_DEFAULT = ['--version', '-V', '-v', 'version'];
+const PER_BINARY_FLAGS = {
+// gemini's CLI prints version on plain `gemini --version`, no special.
+// claude code prints version on `claude --version` since the
+// 1.0 stable release; older nightlies needed `--help`.
+// Keep the mapping empty until we hit a binary that needs an override.
+};
+export const realExec = (bin, args) => {
+    return new Promise(resolve => {
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let child;
+        try {
+            child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        }
+        catch {
+            // ENOENT or similar; surface as exit code 127 (command not found).
+            resolve({ stdout: '', stderr: '', exitCode: 127, timedOut: false });
+            return;
+        }
+        child.on('error', () => {
+            resolve({ stdout: '', stderr: '', exitCode: 127, timedOut: false });
+        });
+        child.stdout?.on('data', d => { stdout += d.toString(); });
+        child.stderr?.on('data', d => { stderr += d.toString(); });
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill('SIGKILL');
+            }
+            catch { /* */ }
+        }, VERSION_TIMEOUT_MS);
+        timer.unref?.();
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({ stdout, stderr, exitCode: code, timedOut });
+        });
+    });
+};
+/**
+ * Probe a single binary. Returns the version string (first line of
+ * stdout or stderr) or `null` if absent. Empty output with exit 0 is
+ * still treated as truthy presence — the binary is on PATH and exits
+ * cleanly, so it counts; we report 'unknown' so the catalog reflects
+ * presence even when version output is empty.
+ */
+export async function probe(name, execImpl = realExec) {
+    const flags = [...(PER_BINARY_FLAGS[name] ?? []), ...VERSION_FLAGS_DEFAULT];
+    for (const flag of flags) {
+        const result = await execImpl(name, [flag]);
+        if (result.timedOut)
+            return null;
+        if (result.exitCode === 127) {
+            // Command not found across all flags - try next, but this
+            // usually fails for everything else too.
+            return null;
+        }
+        const out = (result.stdout || result.stderr).trim();
+        if (out.length > 0) {
+            return firstLine(out);
+        }
+        if (result.exitCode === 0) {
+            // Exited cleanly but said nothing. Treat as present-but-unknown.
+            return 'unknown';
+        }
+        // Non-zero exit, no output: try next flag.
+    }
+    return null;
+}
+/**
+ * Probe a list of binaries concurrently. Bounded by the OS subprocess
+ * cap implicitly; in practice a 15-binary probe finishes well under
+ * a second on macOS/Linux.
+ */
+export async function probeAll(names, execImpl = realExec) {
+    const entries = await Promise.all(names.map(async (n) => [n, await probe(n, execImpl)]));
+    return Object.fromEntries(entries);
+}
+function firstLine(s) {
+    const idx = s.indexOf('\n');
+    return idx === -1 ? s : s.slice(0, idx);
+}
+//# sourceMappingURL=binaries.js.map

package/dist/binaries.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * almyty-runner CLI.
+ *
+ *   almyty-runner start [--name X] [--label k=v]... [--config path] [--url URL]
+ *   almyty-runner status
+ *   almyty-runner stop
+ *
+ * Auth: ALMYTY_TOKEN env or ~/.almyty/credentials.json (run
+ * `npx @almyty/auth login` first if neither is configured).
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * almyty-runner CLI.
+ *
+ *   almyty-runner start [--name X] [--label k=v]... [--config path] [--url URL]
+ *   almyty-runner status
+ *   almyty-runner stop
+ *
+ * Auth: ALMYTY_TOKEN env or ~/.almyty/credentials.json (run
+ * `npx @almyty/auth login` first if neither is configured).
+ */
+import { RunnerDaemon, readStatus, stopDaemon } from './daemon.js';
+import { RUNNER_VERSION } from './runtime-info.js';
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    if (args.length === 0)
+        return { command: 'help' };
+    const command = args[0];
+    if (command === '--version' || command === '-v')
+        return { command: 'version' };
+    if (command === '--help' || command === '-h')
+        return { command: 'help' };
+    if (!['start', 'status', 'stop', 'help', 'version'].includes(command)) {
+        return { command: 'help' };
+    }
+    const flags = { command: command };
+    for (let i = 1; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--name' && args[i + 1]) {
+            flags.name = args[++i];
+            continue;
+        }
+        if (a === '--config' && args[i + 1]) {
+            flags.configPath = args[++i];
+            continue;
+        }
+        if (a === '--url' && args[i + 1]) {
+            flags.url = args[++i];
+            continue;
+        }
+        if (a === '--label' && args[i + 1]) {
+            const kv = args[++i];
+            const eq = kv.indexOf('=');
+            if (eq <= 0) {
+                process.stderr.write(`--label expects key=value, got: ${kv}\n`);
+                process.exit(2);
+            }
+            flags.labels = flags.labels ?? {};
+            flags.labels[kv.slice(0, eq)] = kv.slice(eq + 1);
+            continue;
+        }
+        if (a === '--help' || a === '-h') {
+            flags.command = 'help';
+            return flags;
+        }
+    }
+    return flags;
+}
+function printHelp() {
+    process.stdout.write(`almyty-runner v${RUNNER_VERSION}
+
+Usage:
+  almyty-runner start [options]    Register and run the daemon
+  almyty-runner status             Show local daemon status
+  almyty-runner stop               Send SIGTERM to the local daemon
+
+Options for start:
+  --name <name>           Runner name (matches [a-zA-Z0-9_-]{1,64})
+  --label key=value       Add a routing label; repeat for multiple
+  --config <path>         Path to a JSON config file (overrides global+project)
+  --url <backend-url>     Override backend URL (e.g. https://api.almyty.com)
+
+Auth:
+  ALMYTY_TOKEN env or ~/.almyty/credentials.json (\`npx @almyty/auth login\`).
+`);
+}
+async function main() {
+    const flags = parseArgs(process.argv);
+    switch (flags.command) {
+        case 'version':
+            process.stdout.write(`${RUNNER_VERSION}\n`);
+            return;
+        case 'help':
+            printHelp();
+            return;
+        case 'status': {
+            const status = readStatus();
+            if (!status) {
+                process.stdout.write('runner: not running\n');
+                process.exit(1);
+            }
+            process.stdout.write(JSON.stringify(status, null, 2) + '\n');
+            return;
+        }
+        case 'stop': {
+            const ok = stopDaemon();
+            if (!ok) {
+                process.stdout.write('runner: not running\n');
+                process.exit(1);
+            }
+            process.stdout.write('runner: stop signal sent\n');
+            return;
+        }
+        case 'start': {
+            const daemon = new RunnerDaemon();
+            try {
+                await daemon.start({
+                    name: flags.name,
+                    labels: flags.labels,
+                    backendUrl: flags.url,
+                    configPath: flags.configPath,
+                });
+            }
+            catch (err) {
+                process.stderr.write(`failed to start: ${err.message}\n`);
+                process.exit(1);
+            }
+            // Keep the process alive; signal handlers exit cleanly.
+            await new Promise(() => { });
+            return;
+        }
+    }
+}
+main().catch(err => {
+    process.stderr.write(`unexpected error: ${err?.message ?? err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/coding-agents/detect.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Detect which coding-agent platforms are installed on this machine.
+ *
+ * Probes each platform's binary (and any aliases — e.g. cursor resolves via
+ * `cursor-agent` or `agent`) using the same version-probe the runtime catalog
+ * uses, then returns the available platforms with their capabilities. This is
+ * what makes the runner report "I can drive claude, codex, gemini here" to the
+ * backend at registration, instead of just a flat binary map.
+ */
+import { type ProbeExec } from '../binaries.js';
+import type { DetectedCodingAgent } from './types.js';
+export declare function detectCodingAgents(exec?: ProbeExec): Promise<DetectedCodingAgent[]>;

package/dist/coding-agents/detect.js

@@ -0,0 +1,35 @@
+/**
+ * Detect which coding-agent platforms are installed on this machine.
+ *
+ * Probes each platform's binary (and any aliases — e.g. cursor resolves via
+ * `cursor-agent` or `agent`) using the same version-probe the runtime catalog
+ * uses, then returns the available platforms with their capabilities. This is
+ * what makes the runner report "I can drive claude, codex, gemini here" to the
+ * backend at registration, instead of just a flat binary map.
+ */
+import { probe, realExec } from '../binaries.js';
+import { listCodingAgents } from './registry.js';
+export async function detectCodingAgents(exec = realExec) {
+    const results = await Promise.all(listCodingAgents().map(async (spec) => {
+        // Probe the primary binary first, then aliases; first hit wins.
+        for (const name of [spec.binary, ...spec.binaryAliases]) {
+            const version = await probe(name, exec);
+            if (version !== null) {
+                const detected = {
+                    id: spec.id,
+                    displayName: spec.displayName,
+                    binary: spec.binary,
+                    resolvedBinary: name,
+                    version,
+                    providerFamily: spec.providerFamily,
+                    supportsMcp: spec.supportsMcp,
+                    canManage: spec.canManage,
+                };
+                return detected;
+            }
+        }
+        return null;
+    }));
+    return results.filter((r) => r !== null);
+}
+//# sourceMappingURL=detect.js.map

package/dist/coding-agents/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/coding-agents/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkB,QAAQ;IACjE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,gBAAgB,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACpC,gEAAgE;QAChE,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAwB;oBACpC,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,cAAc,EAAE,IAAI;oBACpB,OAAO;oBACP,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC;gBACF,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CACH,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AACrE,CAAC"}

package/dist/coding-agents/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Coding-agent platform support for the runner — the orchestration substrate.
+ *
+ * Turns the runner's generic process surface into a fleet that KNOWS the
+ * coding CLIs maco supports (claude, codex, gemini, cursor, opencode, crush,
+ * copilot, grok, hermes, mistral_vibe, openclaw, + aider): detect them, build
+ * an unattended spawn spec (headless auth + isolated config home + auto-approve
+ * + resume), and classify each live pane's status (busy / idle / awaiting input
+ * / awaiting auth / error).
+ */
+export { CODING_AGENTS, CODING_AGENT_IDS, listCodingAgents, getCodingAgent, findByBinary, allProbeBinaries, } from './registry.js';
+export { buildAgentSpawn, resumeArgv, type AgentSpawnInput } from './spawn-spec.js';
+export { classifyStatus, stripVtEscapes, lastFrameResetIndex, SPINNER_GLYPHS, PULSE_GLYPHS, AUTH_MARKERS, ERROR_MARKERS, } from './status.js';
+export { detectCodingAgents } from './detect.js';
+export type { CodingAgentId, CodingAgentSpec, DetectedCodingAgent, AgentStatus, StatusPatterns, SessionFlavor, } from './types.js';

package/dist/coding-agents/index.js

@@ -0,0 +1,15 @@
+/**
+ * Coding-agent platform support for the runner — the orchestration substrate.
+ *
+ * Turns the runner's generic process surface into a fleet that KNOWS the
+ * coding CLIs maco supports (claude, codex, gemini, cursor, opencode, crush,
+ * copilot, grok, hermes, mistral_vibe, openclaw, + aider): detect them, build
+ * an unattended spawn spec (headless auth + isolated config home + auto-approve
+ * + resume), and classify each live pane's status (busy / idle / awaiting input
+ * / awaiting auth / error).
+ */
+export { CODING_AGENTS, CODING_AGENT_IDS, listCodingAgents, getCodingAgent, findByBinary, allProbeBinaries, } from './registry.js';
+export { buildAgentSpawn, resumeArgv } from './spawn-spec.js';
+export { classifyStatus, stripVtEscapes, lastFrameResetIndex, SPINNER_GLYPHS, PULSE_GLYPHS, AUTH_MARKERS, ERROR_MARKERS, } from './status.js';
+export { detectCodingAgents } from './detect.js';
+//# sourceMappingURL=index.js.map

package/dist/coding-agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coding-agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AACpF,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/coding-agents/registry.d.ts

@@ -0,0 +1,9 @@
+import type { CodingAgentId, CodingAgentSpec } from './types.js';
+export declare const CODING_AGENTS: Record<CodingAgentId, CodingAgentSpec>;
+export declare const CODING_AGENT_IDS: CodingAgentId[];
+export declare function listCodingAgents(): CodingAgentSpec[];
+export declare function getCodingAgent(id: string): CodingAgentSpec | undefined;
+/** Resolve a spec by binary name or alias (e.g. "cursor-agent" → cursor). */
+export declare function findByBinary(binaryName: string): CodingAgentSpec | undefined;
+/** Every binary name (primary + aliases) for the probe list. */
+export declare function allProbeBinaries(): string[];