@almyty/runner 1.2.0

package/dist/coding-agents/registry.js

@@ -0,0 +1,260 @@
+/**
+ * Coding-agent platform catalog — the runner's port of maco's driver registry.
+ *
+ * One entry per CLI. Binary names, provider families, API-key env vars,
+ * config-dir env vars, auto-approve flags, resume mechanisms, and status-marker
+ * tables are sourced from maco's drivers (maco-core/src/drivers/*.rs) and the
+ * researched feature matrix (maco/docs/briefs/cli-feature-matrix.md, 2026-06-24).
+ *
+ * Adding a platform = adding a row here. No code branches anywhere else key off
+ * the CLI id; everything (detection, spawn-spec, status) reads this table.
+ */
+import { SPINNER_GLYPHS, PULSE_GLYPHS } from './status.js';
+/** Most CLIs share Claude's prompt/busy shape; start from this and tweak. */
+function defaultStatus(over = {}) {
+    return {
+        busySubstrings: ['esc to interrupt', 'ctrl+c to interrupt'],
+        spinnerGlyphs: SPINNER_GLYPHS,
+        promptPrefixes: ['> '],
+        promptContains: [],
+        promptExact: ['>'],
+        ...over,
+    };
+}
+export const CODING_AGENTS = {
+    claude: {
+        id: 'claude',
+        displayName: 'Claude Code',
+        shortCode: 'cl',
+        binary: 'claude',
+        binaryAliases: [],
+        providerFamily: 'anthropic',
+        apiKeyEnvVars: ['ANTHROPIC_API_KEY'],
+        configDirEnvVar: 'CLAUDE_CONFIG_DIR',
+        autoApproveArgs: ['--dangerously-skip-permissions'],
+        baseArgs: [],
+        session: { kind: 'resume-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus({ promptPrefixes: ['>'], promptContains: ['│ >'] }),
+    },
+    codex: {
+        id: 'codex',
+        displayName: 'Codex',
+        shortCode: 'cx',
+        binary: 'codex',
+        binaryAliases: [],
+        providerFamily: 'openai',
+        apiKeyEnvVars: ['OPENAI_API_KEY'],
+        configDirEnvVar: 'CODEX_HOME',
+        autoApproveArgs: ['--dangerously-bypass-approvals-and-sandbox'],
+        baseArgs: [],
+        session: { kind: 'exec-resume' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus({
+            busySubstrings: ['esc to interrupt', 'working'],
+            promptPrefixes: ['>>', '> '],
+            promptExact: ['>'],
+        }),
+    },
+    gemini: {
+        id: 'gemini',
+        displayName: 'Gemini CLI',
+        shortCode: 'gm',
+        binary: 'gemini',
+        binaryAliases: [],
+        providerFamily: 'google',
+        apiKeyEnvVars: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'],
+        configDirEnvVar: null,
+        autoApproveArgs: ['--yolo'],
+        baseArgs: [],
+        session: { kind: 'resume-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus({
+            busySubstrings: ['esc to interrupt', 'esc to cancel'],
+            promptContains: ['gemini>'],
+        }),
+    },
+    cursor: {
+        id: 'cursor',
+        displayName: 'Cursor Agent',
+        shortCode: 'cu',
+        binary: 'cursor-agent',
+        // NOTE: no bare 'agent' alias — it collides with other tools that install
+        // an `agent` binary (e.g. grok), causing false-positive detection. The real
+        // Cursor CLI binary is `cursor-agent`.
+        binaryAliases: [],
+        providerFamily: 'cursor',
+        apiKeyEnvVars: ['CURSOR_API_KEY'],
+        configDirEnvVar: null,
+        autoApproveArgs: ['--force'],
+        baseArgs: [],
+        session: { kind: 'resume-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus(),
+    },
+    opencode: {
+        id: 'opencode',
+        displayName: 'OpenCode',
+        shortCode: 'oc',
+        binary: 'opencode',
+        binaryAliases: [],
+        providerFamily: 'unknown',
+        apiKeyEnvVars: ['ANTHROPIC_API_KEY', 'OPENAI_API_KEY'],
+        configDirEnvVar: null,
+        autoApproveArgs: [],
+        baseArgs: [],
+        session: { kind: 'session-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus({
+            busySubstrings: ['esc interrupt', 'esc to exit', 'thinking...', 'generating...'],
+            spinnerGlyphs: PULSE_GLYPHS,
+            promptContains: ['ask anything'],
+        }),
+    },
+    crush: {
+        id: 'crush',
+        displayName: 'Crush',
+        shortCode: 'cr',
+        binary: 'crush',
+        binaryAliases: [],
+        providerFamily: 'unknown',
+        apiKeyEnvVars: ['ANTHROPIC_API_KEY', 'OPENAI_API_KEY'],
+        configDirEnvVar: null,
+        autoApproveArgs: ['--yolo'],
+        baseArgs: [],
+        session: { kind: 'session-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus(),
+    },
+    copilot: {
+        id: 'copilot',
+        displayName: 'GitHub Copilot CLI',
+        shortCode: 'cp',
+        binary: 'copilot',
+        binaryAliases: [],
+        providerFamily: 'github',
+        apiKeyEnvVars: ['COPILOT_GITHUB_TOKEN', 'GITHUB_TOKEN'],
+        configDirEnvVar: 'COPILOT_HOME',
+        autoApproveArgs: ['--yolo'],
+        baseArgs: [],
+        session: { kind: 'session-id-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus({ promptContains: ['copilot>'] }),
+    },
+    grok: {
+        id: 'grok',
+        displayName: 'Grok CLI',
+        shortCode: 'gr',
+        binary: 'grok',
+        binaryAliases: [],
+        providerFamily: 'xai',
+        apiKeyEnvVars: ['XAI_API_KEY'],
+        configDirEnvVar: null,
+        // grok needs --no-alt-screen so its output renders in the scrollback we scrape.
+        autoApproveArgs: ['--always-approve', '--no-alt-screen'],
+        baseArgs: [],
+        session: { kind: 'session-id-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus(),
+    },
+    hermes: {
+        id: 'hermes',
+        displayName: 'Hermes',
+        shortCode: 'hr',
+        binary: 'hermes',
+        binaryAliases: [],
+        providerFamily: 'nous',
+        apiKeyEnvVars: ['ANTHROPIC_API_KEY', 'OPENAI_API_KEY'],
+        configDirEnvVar: 'HERMES_HOME',
+        autoApproveArgs: ['--yolo'],
+        baseArgs: [],
+        session: { kind: 'resume-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus(),
+    },
+    mistral_vibe: {
+        id: 'mistral_vibe',
+        displayName: 'Mistral Vibe',
+        shortCode: 'mv',
+        binary: 'vibe',
+        binaryAliases: ['mistral-vibe'],
+        providerFamily: 'mistral',
+        apiKeyEnvVars: ['MISTRAL_API_KEY'],
+        configDirEnvVar: 'VIBE_HOME',
+        autoApproveArgs: ['--yolo'],
+        baseArgs: [],
+        session: { kind: 'resume-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus(),
+    },
+    openclaw: {
+        id: 'openclaw',
+        displayName: 'OpenClaw',
+        shortCode: 'ow',
+        binary: 'openclaw',
+        binaryAliases: [],
+        providerFamily: 'unknown',
+        apiKeyEnvVars: ['OPENAI_API_KEY', 'ANTHROPIC_API_KEY'],
+        configDirEnvVar: 'OPENCLAW_CONFIG_PATH',
+        autoApproveArgs: ['exec-policy', 'preset', 'yolo'],
+        baseArgs: ['chat', '--local'],
+        session: { kind: 'session-id-flag' },
+        supportsMcp: true,
+        canManage: true,
+        status: defaultStatus(),
+    },
+    // aider is not a maco driver, but the runner already probed it and it's a
+    // widely used coding CLI; include it so detection/spawn cover it too.
+    aider: {
+        id: 'aider',
+        displayName: 'Aider',
+        shortCode: 'ai',
+        binary: 'aider',
+        binaryAliases: [],
+        providerFamily: 'unknown',
+        apiKeyEnvVars: ['ANTHROPIC_API_KEY', 'OPENAI_API_KEY'],
+        configDirEnvVar: null,
+        autoApproveArgs: ['--yes-always'],
+        baseArgs: [],
+        session: { kind: 'none' },
+        supportsMcp: false,
+        canManage: false,
+        status: defaultStatus(),
+    },
+};
+export const CODING_AGENT_IDS = Object.keys(CODING_AGENTS);
+export function listCodingAgents() {
+    return CODING_AGENT_IDS.map((id) => CODING_AGENTS[id]);
+}
+export function getCodingAgent(id) {
+    return CODING_AGENTS[id];
+}
+/** Resolve a spec by binary name or alias (e.g. "cursor-agent" → cursor). */
+export function findByBinary(binaryName) {
+    for (const spec of listCodingAgents()) {
+        if (spec.binary === binaryName || spec.binaryAliases.includes(binaryName))
+            return spec;
+    }
+    return undefined;
+}
+/** Every binary name (primary + aliases) for the probe list. */
+export function allProbeBinaries() {
+    const set = new Set();
+    for (const spec of listCodingAgents()) {
+        set.add(spec.binary);
+        for (const a of spec.binaryAliases)
+            set.add(a);
+    }
+    return [...set];
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/coding-agents/spawn-spec.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Build a runner SpawnOptions for a coding-agent platform.
+ *
+ * This is the lever maco drives from its driver layer (`coordination_argv`,
+ * `coordination_env`, auto-approve, resume), narrowed to what the runner needs
+ * to launch an unattended member:
+ *
+ *   - inject the provider API key into the CLI's env (headless auth — under an
+ *     isolated config home the normal credential file is absent);
+ *   - isolate the CLI's config/auth/session home via its dedicated env var
+ *     (CODEX_HOME, CLAUDE_CONFIG_DIR, …) so parallel members don't collide;
+ *   - add the auto-approve flag so the member doesn't stop on per-tool prompts;
+ *   - add resume argv when continuing a prior session;
+ *   - optionally pin a model.
+ *
+ * The result is a plain SpawnOptions the existing ProcessManager runs as-is;
+ * the runner's execution policy still applies on top.
+ */
+import type { SpawnOptions } from '../types.js';
+import type { CodingAgentSpec } from './types.js';
+export interface AgentSpawnInput {
+    /** Provider API key to inject (matched to the CLI's first apiKeyEnvVar). */
+    apiKey?: string;
+    /** Explicit env var name for the key, overriding the spec's default order. */
+    apiKeyEnvVar?: string;
+    /**
+     * Isolated config/auth/session home for this member. Set on the CLI's
+     * dedicated env var if it has one; otherwise exported as HOME so the CLI's
+     * default ~/.<cli> path relocates under it.
+     */
+    configDir?: string;
+    /** Skip per-tool permission prompts (unattended member). Default true. */
+    autoApprove?: boolean;
+    /** Pin a model where the CLI's argv supports it (best-effort, claude/gemini). */
+    model?: string;
+    /** Resume a prior session id (uses the spec's SessionFlavor). */
+    resumeSessionId?: string;
+    /** Extra argv appended last (e.g. a one-shot prompt or CLI-specific flags). */
+    extraArgs?: string[];
+    /** Working directory for the member. */
+    cwd?: string;
+    /** Base env to extend. Defaults to {} (policy/process-manager add the rest). */
+    baseEnv?: Record<string, string>;
+}
+/** Argv that resumes a session for this CLI, or [] if unsupported. */
+export declare function resumeArgv(spec: CodingAgentSpec, sessionId: string): string[];
+export declare function buildAgentSpawn(spec: CodingAgentSpec, input?: AgentSpawnInput): SpawnOptions;

package/dist/coding-agents/spawn-spec.js

@@ -0,0 +1,58 @@
+/** Argv that resumes a session for this CLI, or [] if unsupported. */
+export function resumeArgv(spec, sessionId) {
+    switch (spec.session.kind) {
+        case 'resume-flag': return ['--resume', sessionId];
+        case 'session-id-flag': return ['--session-id', sessionId];
+        case 'session-flag': return ['--session', sessionId];
+        case 'exec-resume': return ['exec', 'resume', sessionId];
+        case 'none': return [];
+    }
+}
+/** Best-effort model-pin argv (only the CLIs that take a plain --model flag). */
+function modelArgv(spec, model) {
+    if (spec.id === 'claude' || spec.id === 'gemini')
+        return ['--model', model];
+    return [];
+}
+export function buildAgentSpawn(spec, input = {}) {
+    const args = [...spec.baseArgs];
+    // Resume vs fresh session.
+    if (input.resumeSessionId) {
+        args.push(...resumeArgv(spec, input.resumeSessionId));
+    }
+    // Auto-approve (default on — these members run unattended).
+    if (input.autoApprove !== false) {
+        args.push(...spec.autoApproveArgs);
+    }
+    // Model pin where supported.
+    if (input.model) {
+        args.push(...modelArgv(spec, input.model));
+    }
+    // Caller extras last so they can override.
+    if (input.extraArgs?.length) {
+        args.push(...input.extraArgs);
+    }
+    const env = { ...(input.baseEnv ?? {}) };
+    // Headless auth: inject the provider key on the CLI's expected env var.
+    if (input.apiKey) {
+        const keyVar = input.apiKeyEnvVar ?? spec.apiKeyEnvVars[0];
+        if (keyVar)
+            env[keyVar] = input.apiKey;
+    }
+    // Config/auth/session isolation. Prefer the CLI's dedicated env var; fall
+    // back to HOME so the default ~/.<cli> path relocates under the isolated dir.
+    if (input.configDir) {
+        if (spec.configDirEnvVar)
+            env[spec.configDirEnvVar] = input.configDir;
+        else
+            env.HOME = input.configDir;
+    }
+    return {
+        binary: spec.binary,
+        args,
+        env: Object.keys(env).length ? env : undefined,
+        pty: true,
+        cwd: input.cwd,
+    };
+}
+//# sourceMappingURL=spawn-spec.js.map

package/dist/coding-agents/spawn-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-spec.js","sourceRoot":"","sources":["../../src/coding-agents/spawn-spec.ts"],"names":[],"mappings":"AA8CA,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,IAAqB,EAAE,SAAiB;IACjE,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,aAAa,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACnD,KAAK,iBAAiB,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAC3D,KAAK,cAAc,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACrD,KAAK,aAAa,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,SAAS,SAAS,CAAC,IAAqB,EAAE,KAAa;IACrD,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAqB,EAAE,QAAyB,EAAE;IAChF,MAAM,IAAI,GAAa,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1C,2BAA2B;IAC3B,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,4DAA4D;IAC5D,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,2CAA2C;IAC3C,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAEjE,wEAAwE;IACxE,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,MAAM;YAAE,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACzC,CAAC;IAED,0EAA0E;IAC1E,8EAA8E;IAC9E,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,eAAe;YAAE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;;YACjE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI;QACJ,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QAC9C,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Two-tier status detection — Tier 2 (VT scrape), ported from maco's
+ * `state/patterns.rs` + `detector.rs`.
+ *
+ * When no fresh lifecycle signal is available, scrape the rendered terminal
+ * screen for busy/prompt markers. Detection is BUSY-FIRST: a live
+ * "esc to interrupt" marker or an active spinner glyph is authoritative; only
+ * when NOT busy do we look at the prompt. Auth/error gates are checked before
+ * the prompt so a member stuck on a sign-in screen reads as `awaiting_auth`,
+ * not idle.
+ *
+ * The per-CLI markers are DATA (registry.ts → spec.status), so tuning a CLI is
+ * a table edit. This module is the matcher only.
+ */
+import type { AgentStatus, StatusPatterns } from './types.js';
+/** Spinner glyphs shared across most CLIs (verbatim from maco). */
+export declare const SPINNER_GLYPHS: string[];
+/** opencode adds a block-shaded pulse on top of the braille set. */
+export declare const PULSE_GLYPHS: string[];
+/**
+ * Cross-CLI auth-gate markers. A member stuck here is blocked on a human, not
+ * working — surfaced as a distinct state so an orchestrator can inject a key or
+ * answer the prompt rather than waiting forever. (maco's AwaitingAuth state.)
+ */
+export declare const AUTH_MARKERS: string[];
+/** Cross-CLI fatal-error markers. */
+export declare const ERROR_MARKERS: string[];
+export declare function stripVtEscapes(s: string): string;
+export declare function lastFrameResetIndex(s: string): number;
+/**
+ * Classify a rendered screen for one CLI. `screen` is the visible VT text
+ * (already de-escaped to plain characters by the caller / process manager).
+ *
+ * Order: busy → auth → error → idle-prompt → unknown. Busy wins because a CLI
+ * often keeps a prompt line on screen while working; the active-work marker is
+ * the truth.
+ */
+export declare function classifyStatus(patterns: StatusPatterns, screen: string): AgentStatus;

package/dist/coding-agents/status.js

@@ -0,0 +1,111 @@
+/** Spinner glyphs shared across most CLIs (verbatim from maco). */
+export const SPINNER_GLYPHS = [
+    '·', '✶', '✷', '✸', '✹', '★', '◐', '◓', '◑', '◒',
+    '⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏',
+];
+/** opencode adds a block-shaded pulse on top of the braille set. */
+export const PULSE_GLYPHS = [...SPINNER_GLYPHS, '█', '▓', '▒', '░'];
+/**
+ * Cross-CLI auth-gate markers. A member stuck here is blocked on a human, not
+ * working — surfaced as a distinct state so an orchestrator can inject a key or
+ * answer the prompt rather than waiting forever. (maco's AwaitingAuth state.)
+ */
+export const AUTH_MARKERS = [
+    'sign in to', 'sign in with', 'please log in', 'please sign in',
+    'press enter to authenticate', 'press enter to login', 'paste your api key',
+    'enter your api key', 'authentication required', 'select auth', 'how would you like to authenticate',
+    'login with', '/login', 'terms of service', 'accept the terms', 'waiting for authentication',
+];
+/** Cross-CLI fatal-error markers. */
+export const ERROR_MARKERS = [
+    'panic:', 'fatal error', 'traceback (most recent call last)',
+    'segmentation fault', 'command not found', 'econnrefused',
+    'rate limit exceeded', 'quota exceeded', 'authentication failed',
+    'invalid api key', 'unhandled exception',
+];
+/**
+ * Strip VT/ANSI escape sequences so the classifier sees plain text. PTY output
+ * is full of CSI color/cursor codes and OSC title sets; the markers we match
+ * (prompts, "esc to interrupt") are plain characters underneath.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1b\[[0-9;?]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[@-Z\\-_]/g;
+export function stripVtEscapes(s) {
+    return s.replace(ANSI_RE, '');
+}
+/**
+ * Alt-screen TUIs (claude, gemini, …) repaint each frame from the top: an
+ * erase-display or cursor-home sequence starts a fresh frame, so everything
+ * before it on the previous frame is stale. Return the index in `s` where the
+ * LAST such frame-reset begins, or -1 if there is none. The caller keeps only
+ * the bytes from that point so a status line that has since been cleared (e.g.
+ * "esc to interrupt") doesn't linger in an append log and falsely read busy.
+ */
+// eslint-disable-next-line no-control-regex
+const FRAME_RESET_RE = /\x1b\[(?:2J|3J|H|1;1H|0;0H)/g;
+export function lastFrameResetIndex(s) {
+    let idx = -1;
+    for (const m of s.matchAll(FRAME_RESET_RE))
+        idx = m.index;
+    return idx;
+}
+/** The last N non-blank lines of the screen — where prompts live. */
+function tailLines(screen, n) {
+    const lines = screen.split('\n').map((l) => l.replace(/\r$/, ''));
+    const nonBlank = lines.filter((l) => l.trim().length > 0);
+    return nonBlank.slice(-n);
+}
+function anyLineStartsWithSpinner(screen, glyphs) {
+    for (const raw of screen.split('\n')) {
+        const line = raw.replace(/\r$/, '');
+        const trimmed = line.trimStart();
+        if (trimmed.length > 0 && glyphs.includes(trimmed[0]))
+            return true;
+    }
+    return false;
+}
+/**
+ * Classify a rendered screen for one CLI. `screen` is the visible VT text
+ * (already de-escaped to plain characters by the caller / process manager).
+ *
+ * Order: busy → auth → error → idle-prompt → unknown. Busy wins because a CLI
+ * often keeps a prompt line on screen while working; the active-work marker is
+ * the truth.
+ */
+export function classifyStatus(patterns, screen) {
+    const lower = screen.toLowerCase();
+    // ── Tier 2a: BUSY (authoritative) ──
+    for (const sub of patterns.busySubstrings) {
+        if (lower.includes(sub))
+            return 'busy';
+    }
+    if (anyLineStartsWithSpinner(screen, patterns.spinnerGlyphs))
+        return 'busy';
+    // ── auth gate before prompt: a sign-in screen is not "idle" ──
+    const tail = tailLines(screen, 12);
+    const tailLower = tail.join('\n').toLowerCase();
+    for (const m of AUTH_MARKERS) {
+        if (tailLower.includes(m))
+            return 'awaiting_auth';
+    }
+    for (const m of ERROR_MARKERS) {
+        if (lower.includes(m))
+            return 'error';
+    }
+    // ── Tier 2b: IDLE PROMPT ──
+    const bottom = tailLines(screen, 3);
+    for (const line of bottom) {
+        const trimmedStart = line.trimStart();
+        const trimmed = line.trim();
+        if (patterns.promptExact.includes(trimmed))
+            return 'idle';
+        if (patterns.promptPrefixes.some((p) => trimmedStart.startsWith(p)))
+            return 'idle';
+        if (patterns.promptContains.some((c) => line.includes(c)))
+            return 'idle';
+    }
+    // No marker matched. The caller decides; for an actively-streaming pane this
+    // usually means "still busy", but we don't assert it here.
+    return 'unknown';
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,104 @@
+/**
+ * Coding-agent platform model.
+ *
+ * The runner's generic process surface can spawn any binary, but driving a
+ * coding CLI unattended needs per-CLI knowledge: the real binary name, the
+ * provider API-key env var, the "relocate my whole config/auth/session home"
+ * env var (so members don't fight over one shared ~/.config), the auto-approve
+ * flag that skips per-tool permission prompts, the resume mechanism, and the
+ * VT markers that say whether the pane is busy / idle / waiting on the human.
+ *
+ * This mirrors maco's `CliDriver` trait, narrowed to what the runner needs:
+ * detect → build a spawn spec → classify live status. The catalog is DATA
+ * (one entry per CLI in registry.ts) so adding a platform is a table edit,
+ * never a new code branch — same design point as maco's driver registry and
+ * its config-driven status-pattern tables.
+ */
+/** Every coding CLI maco supports, by stable id. */
+export type CodingAgentId = 'claude' | 'codex' | 'gemini' | 'cursor' | 'opencode' | 'crush' | 'copilot' | 'grok' | 'hermes' | 'mistral_vibe' | 'openclaw' | 'aider';
+/**
+ * How a CLI resumes a prior session. The runner builds the resume argv from
+ * this + a session id. (Some CLIs have no resume mechanism we drive yet.)
+ */
+export type SessionFlavor = {
+    kind: 'resume-flag';
+} | {
+    kind: 'session-id-flag';
+} | {
+    kind: 'session-flag';
+} | {
+    kind: 'exec-resume';
+} | {
+    kind: 'none';
+};
+/**
+ * Two-tier live status of a spawned coding-agent pane (maco's model):
+ *   - busy: actively working (spinner / "esc to interrupt" present)
+ *   - idle: at its prompt, ready for the next instruction
+ *   - awaiting_input: stopped on a question/permission prompt for the human
+ *   - awaiting_auth: stopped on a sign-in / API-key / ToS gate
+ *   - error: a crash/fatal marker is on screen
+ *   - unknown: no marker matched (caller decides; usually treat as busy)
+ */
+export type AgentStatus = 'busy' | 'idle' | 'awaiting_input' | 'awaiting_auth' | 'error' | 'unknown';
+/** Per-CLI VT scrape table — markers are data, matched busy-first. */
+export interface StatusPatterns {
+    /** Lowercased substrings; presence anywhere ⇒ busy. Keep SPECIFIC. */
+    busySubstrings: string[];
+    /** First non-space char of any line is one of these ⇒ busy (spinner). */
+    spinnerGlyphs: string[];
+    /** A bottom line whose trimStart() starts with one of these ⇒ idle prompt. */
+    promptPrefixes: string[];
+    /** A bottom line that contains one of these (raw) ⇒ idle prompt. */
+    promptContains: string[];
+    /** A bottom line whose trim() equals one of these ⇒ idle prompt. */
+    promptExact: string[];
+}
+export interface CodingAgentSpec {
+    /** Stable id used by the agent.* RPC surface. */
+    id: CodingAgentId;
+    /** Human label, e.g. "Claude Code". */
+    displayName: string;
+    /** Two-letter code mirroring maco's short_code (status table key). */
+    shortCode: string;
+    /** The real executable name. */
+    binary: string;
+    /** Alternate names to also probe (e.g. cursor → cursor-agent). */
+    binaryAliases: string[];
+    /** Throttle-reroute family (maco's provider_family): 'anthropic', 'openai', … */
+    providerFamily: string;
+    /**
+     * Provider API-key env vars, in priority order. Under an isolated config
+     * home the normal credential file is absent, so the key is injected at spawn.
+     */
+    apiKeyEnvVars: string[];
+    /**
+     * The CLI's dedicated "relocate config+auth+sessions" env var, if it has one
+     * (CODEX_HOME, CLAUDE_CONFIG_DIR, COPILOT_HOME, …). Null ⇒ isolate via HOME.
+     */
+    configDirEnvVar: string | null;
+    /** Argv that skips per-tool permission prompts for an unattended member. */
+    autoApproveArgs: string[];
+    /** Argv prepended before everything (e.g. openclaw: ['chat','--local']). */
+    baseArgs: string[];
+    /** How to resume a prior session. */
+    session: SessionFlavor;
+    /** Does the CLI speak MCP (so the runner can inject coordination tools)? */
+    supportsMcp: boolean;
+    /** Can it act as the orchestrating manager (vs member-only)? */
+    canManage: boolean;
+    /** VT status-detection table. */
+    status: StatusPatterns;
+}
+/** A detected, on-PATH coding agent. */
+export interface DetectedCodingAgent {
+    id: CodingAgentId;
+    displayName: string;
+    binary: string;
+    /** The binary name that actually resolved (may be an alias). */
+    resolvedBinary: string;
+    version: string;
+    providerFamily: string;
+    supportsMcp: boolean;
+    canManage: boolean;
+}

package/dist/coding-agents/types.js

@@ -0,0 +1,18 @@
+/**
+ * Coding-agent platform model.
+ *
+ * The runner's generic process surface can spawn any binary, but driving a
+ * coding CLI unattended needs per-CLI knowledge: the real binary name, the
+ * provider API-key env var, the "relocate my whole config/auth/session home"
+ * env var (so members don't fight over one shared ~/.config), the auto-approve
+ * flag that skips per-tool permission prompts, the resume mechanism, and the
+ * VT markers that say whether the pane is busy / idle / waiting on the human.
+ *
+ * This mirrors maco's `CliDriver` trait, narrowed to what the runner needs:
+ * detect → build a spawn spec → classify live status. The catalog is DATA
+ * (one entry per CLI in registry.ts) so adding a platform is a table edit,
+ * never a new code branch — same design point as maco's driver registry and
+ * its config-driven status-pattern tables.
+ */
+export {};
+//# sourceMappingURL=types.js.map