@almyty/runner 1.2.0

package/dist/streamable-client.js

@@ -0,0 +1,204 @@
+import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
+import { WORKER_PROTOCOL_VERSION, isWorkerEnvelope, } from './protocol.js';
+export class StreamableClient extends EventEmitter {
+    opts;
+    sessionId = null;
+    lastEventId = null;
+    streamAbort = null;
+    stopped = false;
+    reconnectAttempt = 0;
+    fetchImpl;
+    setTimeoutFn;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        this.fetchImpl = opts.fetch ?? globalThis.fetch;
+        this.setTimeoutFn = opts.setTimeoutFn ?? setTimeout;
+    }
+    /** Returns the session id once the first POST has assigned one. */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /** Send an envelope. Returns the parsed response envelope when the
+     *  backend hands one back inline (for unary requests); otherwise null. */
+    async send(env) {
+        const headers = {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.opts.token}`,
+        };
+        if (this.sessionId)
+            headers['Mcp-Session-Id'] = this.sessionId;
+        const res = await this.fetchImpl(`${this.opts.baseUrl}/mcp/streamable`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(env),
+        });
+        const sid = res.headers.get('mcp-session-id') ?? res.headers.get('Mcp-Session-Id');
+        if (sid)
+            this.sessionId = sid;
+        if (res.status === 202)
+            return null;
+        if (!res.ok) {
+            const text = await safeText(res);
+            throw new Error(`backend POST failed: ${res.status} ${text}`);
+        }
+        const json = await res.json();
+        if (isWorkerEnvelope(json))
+            return json;
+        // JSON-RPC response shape (when the runner posts an MCP-shaped
+        // body, which it shouldn't, but the transport supports both).
+        return null;
+    }
+    /** Open the GET stream and dispatch envelopes via emit('envelope'). */
+    async openStream() {
+        if (this.stopped)
+            return;
+        if (!this.sessionId) {
+            throw new Error('cannot open stream before any POST has assigned a session id');
+        }
+        this.streamAbort = new AbortController();
+        const headers = {
+            'Authorization': `Bearer ${this.opts.token}`,
+            'Mcp-Session-Id': this.sessionId,
+            'Accept': 'text/event-stream',
+        };
+        if (this.lastEventId)
+            headers['Last-Event-ID'] = this.lastEventId;
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.opts.baseUrl}/mcp/streamable`, {
+                method: 'GET',
+                headers,
+                signal: this.streamAbort.signal,
+            });
+        }
+        catch (err) {
+            this.scheduleReconnect(err);
+            return;
+        }
+        if (!res.ok) {
+            const text = await safeText(res);
+            // 404 UNKNOWN_SESSION means the server forgot us; we have to
+            // re-establish a session by POSTing again. Drop the saved
+            // session id and let the next send() mint a new one.
+            if (res.status === 404) {
+                this.sessionId = null;
+                this.lastEventId = null;
+                this.emit('session-lost', text);
+            }
+            this.scheduleReconnect(new Error(`stream open failed: ${res.status} ${text}`));
+            return;
+        }
+        if (!res.body) {
+            this.scheduleReconnect(new Error('stream open: no body'));
+            return;
+        }
+        this.reconnectAttempt = 0;
+        this.emit('open');
+        try {
+            await this.consumeStream(res.body);
+        }
+        catch (err) {
+            this.emit('disconnect', err);
+        }
+        if (!this.stopped)
+            this.scheduleReconnect(new Error('stream ended'));
+    }
+    stop() {
+        this.stopped = true;
+        this.streamAbort?.abort();
+    }
+    // ── internals ───────────────────────────────────────────────────────
+    /**
+     * SSE parser. The MCP Streamable HTTP wire format follows the SSE
+     * spec: events are separated by blank lines, fields are `id:`,
+     * `event:`, `data:`. We accept arbitrary header order and ignore
+     * unknown fields.
+     *
+     * Buffers across chunk boundaries because TCP doesn't respect SSE
+     * frame boundaries; one fetch chunk often contains a half-event.
+     */
+    async consumeStream(body) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder('utf-8');
+        let buffer = '';
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                return;
+            buffer += decoder.decode(value, { stream: true });
+            // Frames are double-newline separated.
+            let frameEnd = buffer.indexOf('\n\n');
+            while (frameEnd !== -1) {
+                const frame = buffer.slice(0, frameEnd);
+                buffer = buffer.slice(frameEnd + 2);
+                this.handleFrame(frame);
+                frameEnd = buffer.indexOf('\n\n');
+            }
+        }
+    }
+    handleFrame(frame) {
+        if (!frame)
+            return;
+        let id = '';
+        let dataLines = [];
+        for (const line of frame.split('\n')) {
+            if (line.startsWith('id:'))
+                id = line.slice(3).trim();
+            else if (line.startsWith('data:'))
+                dataLines.push(line.slice(5).trim());
+            else if (line.startsWith('event:')) { /* event name unused on this side */ }
+        }
+        if (dataLines.length === 0)
+            return;
+        if (id)
+            this.lastEventId = id;
+        const dataText = dataLines.join('\n');
+        let parsed;
+        try {
+            parsed = JSON.parse(dataText);
+        }
+        catch {
+            this.emit('parse-error', dataText);
+            return;
+        }
+        if (!isWorkerEnvelope(parsed)) {
+            this.emit('parse-error', dataText);
+            return;
+        }
+        this.emit('envelope', parsed);
+    }
+    scheduleReconnect(reason) {
+        if (this.stopped)
+            return;
+        this.reconnectAttempt++;
+        const delays = [1_000, 2_000, 4_000, 8_000, 16_000, 30_000];
+        const delay = delays[Math.min(this.reconnectAttempt - 1, delays.length - 1)];
+        this.emit('reconnect', { attempt: this.reconnectAttempt, delayMs: delay, reason: reason.message });
+        const t = this.setTimeoutFn(() => {
+            if (!this.stopped)
+                this.openStream().catch(err => this.emit('error', err));
+        }, delay);
+        t.unref?.();
+    }
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+/** Helper to mint an envelope on the runner side. */
+export function envelope(type, payload, correlationId) {
+    return {
+        v: WORKER_PROTOCOL_VERSION,
+        type,
+        id: correlationId ?? randomUUID(),
+        ts: Date.now(),
+        payload,
+    };
+}
+//# sourceMappingURL=streamable-client.js.map

package/dist/streamable-client.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Public types for the runner package. Mirrored against the backend
+ * Runner / Workspace shapes; we keep them duplicated rather than
+ * importing from the backend so the runner can be installed and
+ * versioned without dragging the backend's dep graph in.
+ */
+import type { DetectedCodingAgent } from './coding-agents/index.js';
+export type RunnerIsolationTier = 'container' | 'host';
+export interface RunnerRuntimeInfo {
+    os: string;
+    arch: string;
+    hostname: string;
+    cpuCount: number;
+    memoryMb: number;
+    runnerVersion: string;
+    binaries: Record<string, string | null>;
+    /**
+     * Coding-agent platforms detected on this machine (claude, codex, gemini,
+     * …). Lets the backend route an agent to a runner that can actually drive
+     * the requested CLI, rather than just inferring it from the binary map.
+     */
+    codingAgents: DetectedCodingAgent[];
+}
+export interface RunnerConfig {
+    defaultIsolation: RunnerIsolationTier;
+    maxConcurrent: number;
+    allowedCwdRoots: string[];
+    denyPatterns: string[];
+    networkBlocked: boolean;
+    installBlocked: boolean;
+}
+/**
+ * Resolved runner-side configuration. Combines the user-set fields
+ * (name, labels, RunnerConfig) with the binary probe list and the
+ * backend URL. Result of merging defaults < global < project < env <
+ * flags.
+ */
+export interface ResolvedConfig {
+    name: string;
+    labels: Record<string, string>;
+    config: RunnerConfig;
+    binaryProbeList: string[];
+    backendUrl: string;
+}
+export interface RunnerInfo {
+    name: string;
+    labels: Record<string, string>;
+    runtime: RunnerRuntimeInfo;
+    runnerVersion: string;
+    binaries: Record<string, string | null>;
+    capacity: {
+        maxConcurrent: number;
+        inUse: number;
+    };
+}
+export type ProcessStatus = 'running' | 'exited' | 'killed';
+export interface ProcessHandle {
+    processId: string;
+    binary: string;
+    startedAt: Date;
+    status: ProcessStatus;
+    /** Workspace this process is scoped to. Cross-workspace access is denied. */
+    workspaceId: string;
+}
+export interface SpawnOptions {
+    binary: string;
+    args: string[];
+    env?: Record<string, string>;
+    /** Default true; set false for raw-pipe mode without a TTY. */
+    pty?: boolean;
+    cwd?: string;
+}
+export interface ReadResult {
+    data: string;
+    /** True when more output is buffered beyond what we returned now. */
+    moreAvailable: boolean;
+}
+export interface WaitForIdleOptions {
+    /** Return when the process produces no output for this long (ms). */
+    idleMs: number;
+    /** Hard cap on how long to wait regardless of activity (ms). */
+    maxWaitMs: number;
+}
+export interface WaitForIdleResult {
+    data: string;
+    /** True when we returned because of idle, false when max-wait fired. */
+    idle: boolean;
+}
+export interface WaitResult {
+    exitCode: number | null;
+    signal: string | null;
+}
+export type ProcessSignal = 'TERM' | 'INT' | 'KILL';
+export interface ShellExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+export declare class RunnerError extends Error {
+    readonly code: string;
+    readonly data?: unknown | undefined;
+    constructor(message: string, code: string, data?: unknown | undefined);
+}
+export declare const RUNNER_ERROR_CODES: {
+    readonly PROCESS_NOT_FOUND: "process_not_found";
+    readonly PROCESS_CROSS_WORKSPACE: "process_cross_workspace";
+    readonly CAPACITY_EXCEEDED: "capacity_exceeded";
+    readonly PATH_DENIED: "path_denied";
+    readonly COMMAND_DENIED: "command_denied";
+    readonly PROCESS_ALREADY_EXITED: "process_already_exited";
+    readonly TIMEOUT: "timeout";
+};

package/dist/types.js

@@ -0,0 +1,21 @@
+// Errors ─────────────────────────────────────────────────────────────
+export class RunnerError extends Error {
+    code;
+    data;
+    constructor(message, code, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'RunnerError';
+    }
+}
+export const RUNNER_ERROR_CODES = {
+    PROCESS_NOT_FOUND: 'process_not_found',
+    PROCESS_CROSS_WORKSPACE: 'process_cross_workspace',
+    CAPACITY_EXCEEDED: 'capacity_exceeded',
+    PATH_DENIED: 'path_denied',
+    COMMAND_DENIED: 'command_denied',
+    PROCESS_ALREADY_EXITED: 'process_already_exited',
+    TIMEOUT: 'timeout',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgHA,uEAAuE;AAEvE,MAAM,OAAO,WAAY,SAAQ,KAAK;IACS;IAA8B;IAA3E,YAAY,OAAe,EAAkB,IAAY,EAAkB,IAAc;QACvF,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,SAAI,GAAJ,IAAI,CAAQ;QAAkB,SAAI,GAAJ,IAAI,CAAU;QAEvF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,uBAAuB,EAAE,yBAAyB;IAClD,iBAAiB,EAAE,mBAAmB;IACtC,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,OAAO,EAAE,SAAS;CACV,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@almyty/runner",
+  "version": "1.2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Connect your own machine to almyty \u2014 a small daemon that lets agents run tools and coding CLIs locally, with code and credentials staying on your box.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "almyty-runner": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "node-pty": "^1.0.0",
+    "@almyty/client": "^1.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "almyty",
+    "runner",
+    "daemon",
+    "agent",
+    "cli"
+  ],
+  "author": "almyty",
+  "license": "Apache-2.0",
+  "homepage": "https://almyty.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/almyty-inc/almyty.git",
+    "directory": "packages/runner"
+  },
+  "bugs": {
+    "url": "https://github.com/almyty-inc/almyty/issues"
+  }
+}