baxian 0.0.1 → 0.2.0

package/dist/agent/repo-store.js

@@ -0,0 +1,152 @@
+import { homedir } from 'node:os';
+import { shellQuote } from './runner.js';
+export function createRepoStoreCache() {
+    return { homes: new Map(), mutex: new Map(), lastFetchAt: new Map() };
+}
+const GITHUB_HTTPS_RE = /^https?:\/\/github\.com\/([^/]+\/[^/]+?)(?:\.git)?\/?$/;
+const GITHUB_SSH_SCP_RE = /^git@github\.com:([^/]+\/[^/]+?)(?:\.git)?\/?$/;
+const GITHUB_SSH_URL_RE = /^ssh:\/\/git@github\.com\/([^/]+\/[^/]+?)(?:\.git)?\/?$/;
+export function normalizeRepoUrl(url) {
+    if (!url)
+        return null;
+    const trimmed = url.trim();
+    return (trimmed.match(GITHUB_HTTPS_RE)?.[1]
+        ?? trimmed.match(GITHUB_SSH_SCP_RE)?.[1]
+        ?? trimmed.match(GITHUB_SSH_URL_RE)?.[1]
+        ?? null);
+}
+const FETCH_THROTTLE_MS = 30_000;
+export class RepoStore {
+    runner;
+    repoSlug;
+    mode;
+    host;
+    cache;
+    constructor(runner, repoSlug, mode, host, cache) {
+        this.runner = runner;
+        this.repoSlug = repoSlug;
+        this.mode = mode;
+        this.host = host;
+        this.cache = cache;
+    }
+    async ensure() {
+        const absRepoPath = await this.resolveAbsPath();
+        const cacheKey = `${this.hostKey()}:${absRepoPath}`;
+        return this.runUnderMutex(cacheKey, async () => {
+            await this.cloneIfNeeded(absRepoPath);
+            await this.fetchIfStale(cacheKey, absRepoPath);
+            return absRepoPath;
+        });
+    }
+    async refresh(absRepoPath) {
+        const cacheKey = `${this.hostKey()}:${absRepoPath}`;
+        await this.runUnderMutex(cacheKey, () => this.fetchIfStale(cacheKey, absRepoPath));
+    }
+    async readFileFromBranch(absRepoPath, branch, filePath) {
+        // FETCH_HEAD 共享：并发 readFileFromBranch 会互相覆盖 → 用 runUnderMutex 串行化。
+        const cacheKey = `${this.hostKey()}:${absRepoPath}`;
+        return this.runUnderMutex(cacheKey, async () => {
+            const fetchCmd = `cd ${shellQuote(absRepoPath)} && git fetch origin ${shellQuote(branch)}`;
+            const fetchResult = await this.runner.exec(fetchCmd);
+            if (fetchResult.exitCode !== 0) {
+                throw new Error(`git fetch origin ${branch} failed at ${absRepoPath}: ${fetchResult.stderr || fetchResult.stdout}`);
+            }
+            // FETCH_HEAD is the only ref guaranteed updated by `git fetch origin <branch>`.
+            const showCmd = `cd ${shellQuote(absRepoPath)} && git show FETCH_HEAD:${shellQuote(filePath)}`;
+            const showResult = await this.runner.exec(showCmd);
+            if (showResult.exitCode === 0)
+                return showResult.stdout;
+            const stderr = (showResult.stderr || '').toLowerCase();
+            if (stderr.includes('does not exist')
+                || stderr.includes('exists on disk, but not in')
+                || stderr.includes("path '")
+                || stderr.includes('fatal: path')
+                || stderr.includes('unknown revision')) {
+                return null;
+            }
+            throw new Error(`git show FETCH_HEAD:${filePath} failed at ${absRepoPath}: ${showResult.stderr || showResult.stdout}`);
+        });
+    }
+    hostKey() {
+        if (this.mode === 'local')
+            return 'local';
+        if (!this.host)
+            throw new Error('Remote mode requires host config');
+        // Prefix remote keys so an SSH alias named "local" cannot collide with local mode.
+        return this.host.user
+            ? `remote:${this.host.user}@${this.host.hostname}`
+            : `remote:${this.host.hostname}`;
+    }
+    async resolveAbsPath() {
+        const home = await this.resolveHome();
+        // GitHub slugs are case-insensitive; case flips must not fork the store.
+        return `${home}/.baxian/repos/${this.repoSlug.toLowerCase()}`;
+    }
+    async resolveHome() {
+        const key = this.hostKey();
+        if (this.mode === 'local') {
+            const cached = this.cache.homes.get(key);
+            if (cached)
+                return cached;
+            const home = homedir();
+            this.cache.homes.set(key, home);
+            return home;
+        }
+        const cached = this.cache.homes.get(key);
+        if (cached)
+            return cached;
+        const result = await this.runner.exec('printf %s "$HOME"');
+        if (result.exitCode !== 0 || !result.stdout) {
+            throw new Error(`Failed to resolve $HOME on ${key}: ${result.stderr}`);
+        }
+        const home = result.stdout.trim();
+        this.cache.homes.set(key, home);
+        return home;
+    }
+    async cloneIfNeeded(absRepoPath) {
+        const dirExists = (await this.runner.exec(`test -d ${shellQuote(absRepoPath)}`)).exitCode === 0;
+        const gitExists = (await this.runner.exec(`test -d ${shellQuote(`${absRepoPath}/.git`)}`)).exitCode === 0;
+        if (dirExists && !gitExists) {
+            throw new Error(`${absRepoPath} exists but is not a git repository. Remove it manually or change project.repo.`);
+        }
+        if (!dirExists) {
+            const parent = absRepoPath.replace(/\/[^/]+$/, '');
+            const mk = await this.runner.exec(`mkdir -p ${shellQuote(parent)}`);
+            if (mk.exitCode !== 0)
+                throw new Error(`Failed to mkdir ${parent}: ${mk.stderr}`);
+            // --no-upstream is a gh flag; do NOT prefix with `--` (that would forward to git clone).
+            const clone = await this.runner.exec(`gh repo clone ${shellQuote(this.repoSlug)} ${shellQuote(absRepoPath)} --no-upstream`);
+            if (clone.exitCode !== 0) {
+                throw new Error(`gh repo clone ${this.repoSlug} failed: ${clone.stderr || clone.stdout}`);
+            }
+            return;
+        }
+        const originResult = await this.runner.exec(`git -C ${shellQuote(absRepoPath)} remote get-url origin`);
+        if (originResult.exitCode !== 0) {
+            throw new Error(`Failed to read origin URL at ${absRepoPath}: ${originResult.stderr}`);
+        }
+        // GitHub treats owner/repo as case-insensitive.
+        const normalized = normalizeRepoUrl(originResult.stdout.trim());
+        if (normalized?.toLowerCase() !== this.repoSlug.toLowerCase()) {
+            throw new Error(`Existing repo at ${absRepoPath} has origin "${originResult.stdout.trim()}" which does not match project.repo "${this.repoSlug}". Remove the directory or change project.repo.`);
+        }
+    }
+    async fetchIfStale(cacheKey, absRepoPath) {
+        const last = this.cache.lastFetchAt.get(cacheKey) ?? 0;
+        if (Date.now() - last < FETCH_THROTTLE_MS)
+            return;
+        // set-head is best-effort because empty repos have no default branch yet.
+        const result = await this.runner.exec(`cd ${shellQuote(absRepoPath)} && git fetch --all --prune && (git remote set-head origin --auto || true)`);
+        if (result.exitCode !== 0) {
+            throw new Error(`git fetch failed at ${absRepoPath}: ${result.stderr}`);
+        }
+        this.cache.lastFetchAt.set(cacheKey, Date.now());
+    }
+    async runUnderMutex(key, fn) {
+        const prev = this.cache.mutex.get(key) ?? Promise.resolve();
+        const cur = prev.then(fn, fn);
+        this.cache.mutex.set(key, cur.then(() => undefined, () => undefined));
+        return cur;
+    }
+}
+//# sourceMappingURL=repo-store.js.map

package/dist/agent/repo-store.js.map

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

package/dist/agent/runner.d.ts

@@ -0,0 +1,46 @@
+import type { HostConfig } from '../shared/index.js';
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export type RemoteShellMode = 'login' | 'login-interactive';
+export interface ExecOptions {
+    timeout?: number;
+    signal?: AbortSignal;
+    maxBuffer?: number;
+    remoteShell?: RemoteShellMode;
+    stdin?: Buffer;
+}
+export interface CommandRunner {
+    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+    writeFile(path: string, content: Buffer | string): Promise<void>;
+    /** stdin bypasses argv ARG_MAX (~1MB). */
+    execWithStdin(command: string, stdin: Buffer, options?: ExecOptions): Promise<ExecResult>;
+}
+export declare class LocalRunner implements CommandRunner {
+    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+    writeFile(filePath: string, content: Buffer | string): Promise<void>;
+    execWithStdin(command: string, stdin: Buffer, options?: ExecOptions): Promise<ExecResult>;
+}
+export declare function ensureMuxDir(): Promise<void>;
+export declare function __resetMuxDirReadyForTests(): void;
+export interface BuildSshOptionsArgs {
+    connectTimeoutSec?: number;
+}
+export declare function buildSshOptions(args?: BuildSshOptionsArgs): string;
+export declare class SshRunner implements CommandRunner {
+    private host;
+    private local;
+    constructor(host: HostConfig, local?: CommandRunner);
+    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+    writeFile(filePath: string, content: Buffer | string): Promise<void>;
+    /** Login wrapper may consume stdin via rc — use execRawRemoteWithStdin for clean stdin. */
+    execWithStdin(command: string, stdin: Buffer, options?: ExecOptions): Promise<ExecResult>;
+    /** No login wrapper — clean stdin for load-buffer; remote runs with non-login PATH. */
+    execRawRemoteWithStdin(remoteCommand: string, stdin: Buffer, options?: ExecOptions): Promise<ExecResult>;
+}
+export declare function shellQuote(s: string): string;
+export declare function wrapRemoteCommand(command: string, mode?: RemoteShellMode): string;
+export declare function createRunner(mode: 'local' | 'remote', host?: HostConfig): CommandRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/agent/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,0CAA0C;IAC1C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3F;AAKD,qBAAa,WAAY,YAAW,aAAa;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIrE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;CAGvB;AAgID,wBAAgB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5C;AAGD,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CActE;AAED,qBAAa,SAAU,YAAW,aAAa;IAG3C,OAAO,CAAC,IAAI;IAFd,OAAO,CAAC,KAAK,CAAgB;gBAEnB,IAAI,EAAE,UAAU,EACxB,KAAK,CAAC,EAAE,aAAa;IAKjB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IASrE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1E,2FAA2F;IACrF,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAQtB,uFAAuF;IACjF,sBAAsB,CAC1B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;CAMvB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,eAAyB,GAAG,MAAM,CAI1F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,CAMvF"}

package/dist/agent/runner.js

@@ -0,0 +1,241 @@
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { mkdir, writeFile as fsWriteFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const KILL_GRACE_MS = 2000;
+const DEFAULT_MAX_BUFFER = 16 * 1024 * 1024;
+export class LocalRunner {
+    async exec(command, options = {}) {
+        return runShell(command, options);
+    }
+    async writeFile(filePath, content) {
+        await mkdir(dirname(filePath), { recursive: true });
+        await fsWriteFile(filePath, content);
+    }
+    async execWithStdin(command, stdin, options = {}) {
+        return runShell(command, { ...options, stdin });
+    }
+}
+function runShell(command, options) {
+    return new Promise((resolve, reject) => {
+        if (options.signal?.aborted) {
+            reject(new Error('Command aborted'));
+            return;
+        }
+        let timeoutHit = false;
+        let aborted = false;
+        let settled = false;
+        let bufferExceeded = false;
+        let bufferedBytes = 0;
+        let stdout = '';
+        let stderr = '';
+        let killTimer = null;
+        const maxBuffer = options.maxBuffer === undefined ? DEFAULT_MAX_BUFFER : options.maxBuffer;
+        const internalAbort = new AbortController();
+        const onUserAbort = () => {
+            aborted = true;
+            internalAbort.abort();
+        };
+        if (options.signal) {
+            options.signal.addEventListener('abort', onUserAbort, { once: true });
+        }
+        // detached → process-group kill prevents orphaning ssh/git children.
+        const child = spawn('/bin/bash', ['-c', command], { detached: true });
+        if (options.stdin) {
+            // EPIPE on child exit during write — convert to abort.
+            child.stdin?.on('error', () => {
+                bufferExceeded = false;
+                internalAbort.abort();
+            });
+            child.stdin?.write(options.stdin);
+            child.stdin?.end();
+        }
+        else {
+            child.stdin?.end();
+        }
+        const killGroup = (sig) => {
+            if (typeof child.pid !== 'number')
+                return;
+            try {
+                process.kill(-child.pid, sig);
+            }
+            catch {
+                // group already gone
+            }
+        };
+        internalAbort.signal.addEventListener('abort', () => killGroup('SIGTERM'), { once: true });
+        const timer = options.timeout
+            ? setTimeout(() => {
+                timeoutHit = true;
+                internalAbort.abort();
+                killTimer = setTimeout(() => killGroup('SIGKILL'), KILL_GRACE_MS);
+                killTimer.unref();
+            }, options.timeout)
+            : null;
+        timer?.unref();
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            if (options.signal)
+                options.signal.removeEventListener('abort', onUserAbort);
+        };
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            fn();
+        };
+        const accumulate = (chunk) => {
+            if (bufferExceeded)
+                return null;
+            if (maxBuffer > 0 && bufferedBytes + chunk.length > maxBuffer) {
+                bufferExceeded = true;
+                internalAbort.abort();
+                return null;
+            }
+            bufferedBytes += chunk.length;
+            return chunk.toString();
+        };
+        child.stdout?.on('data', (chunk) => {
+            const piece = accumulate(chunk);
+            if (piece !== null)
+                stdout += piece;
+        });
+        child.stderr?.on('data', (chunk) => {
+            const piece = accumulate(chunk);
+            if (piece !== null)
+                stderr += piece;
+        });
+        child.on('error', (err) => {
+            finish(() => {
+                if (bufferExceeded)
+                    return reject(new Error(`Command output exceeded maxBuffer (${maxBuffer} bytes)`));
+                if (timeoutHit)
+                    return reject(new Error(`Command timed out after ${options.timeout}ms`));
+                if (aborted)
+                    return reject(new Error('Command aborted'));
+                reject(err);
+            });
+        });
+        child.on('close', (code, signal) => {
+            finish(() => {
+                if (bufferExceeded)
+                    return reject(new Error(`Command output exceeded maxBuffer (${maxBuffer} bytes)`));
+                if (timeoutHit)
+                    return reject(new Error(`Command timed out after ${options.timeout}ms`));
+                if (aborted)
+                    return reject(new Error('Command aborted'));
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: code ?? (signal ? 128 : 1),
+                });
+            });
+        });
+    });
+}
+// OpenSSH ControlMaster lets a backlog of short commands share one TCP+SSH session per target,
+// cutting per-call TCP handshake + key exchange (~tens-of-ms each on LAN, much more on WAN).
+// Caveats this design accepts: socket lives under the local user's HOME (multi-user boxes get
+// per-user mux pools), and a crashed master leaves a stale socket — ControlMaster=auto detects
+// and falls back to a fresh connection in that case.
+const SSH_MUX_DIR = join(homedir(), '.baxian', 'ssh-mux');
+const SSH_CONTROL_PERSIST = '5m';
+let muxDirReady;
+export function ensureMuxDir() {
+    if (!muxDirReady) {
+        // Read-only HOME / permission glitches must not strand the whole SSH path:
+        // ControlMaster=auto falls back to a fresh TCP connection when ControlPath is
+        // unreachable. Log + reset the singleton so a transient failure can recover next call.
+        muxDirReady = mkdir(SSH_MUX_DIR, { recursive: true, mode: 0o700 })
+            .then(() => undefined)
+            .catch(err => {
+            console.warn(`[runner] ensureMuxDir(${SSH_MUX_DIR}) failed; SSH will run without mux this call:`, err);
+            muxDirReady = undefined;
+        });
+    }
+    return muxDirReady;
+}
+// Test-only: reset the singleton so each spec exercises the first-call path.
+export function __resetMuxDirReadyForTests() {
+    muxDirReady = undefined;
+}
+export function buildSshOptions(args = {}) {
+    const connectTimeoutSec = args.connectTimeoutSec ?? 10;
+    // shellQuote on the path so a HOME containing spaces / shell metacharacters cannot
+    // word-split into multiple argv slots (which would mangle the -- delimiter that follows).
+    const controlPath = shellQuote(join(SSH_MUX_DIR, 'cm-%C'));
+    return [
+        '-o BatchMode=yes',
+        `-o ConnectTimeout=${connectTimeoutSec}`,
+        '-o ServerAliveInterval=2',
+        '-o ServerAliveCountMax=2',
+        '-o ControlMaster=auto',
+        `-o ControlPath=${controlPath}`,
+        `-o ControlPersist=${SSH_CONTROL_PERSIST}`,
+    ].join(' ');
+}
+export class SshRunner {
+    host;
+    local;
+    constructor(host, local) {
+        this.host = host;
+        this.local = local ?? new LocalRunner();
+    }
+    async exec(command, options = {}) {
+        await ensureMuxDir();
+        const target = this.host.user ? `${this.host.user}@${this.host.hostname}` : this.host.hostname;
+        const wrapped = wrapRemoteCommand(command, options.remoteShell ?? 'login');
+        const ssh = `ssh ${buildSshOptions()} -- ${shellQuote(target)} ${shellQuote(wrapped)}`;
+        return this.local.exec(ssh, options);
+    }
+    // openssl avoids GNU/BSD base64 flag drift; payloads must stay below ARG_MAX.
+    async writeFile(filePath, content) {
+        const buf = typeof content === 'string' ? Buffer.from(content, 'utf8') : content;
+        const b64 = buf.toString('base64');
+        const eof = `BAXIAN_EOF_${randomBytes(4).toString('hex')}`;
+        const cmd = `mkdir -p ${shellQuote(dirname(filePath))} && ` +
+            `openssl base64 -d -A > ${shellQuote(filePath)} <<'${eof}'\n${b64}\n${eof}`;
+        const r = await this.exec(cmd);
+        if (r.exitCode !== 0) {
+            throw new Error(`writeFile remote failed (${filePath}): ${r.stderr}`);
+        }
+    }
+    /** Login wrapper may consume stdin via rc — use execRawRemoteWithStdin for clean stdin. */
+    async execWithStdin(command, stdin, options = {}) {
+        await ensureMuxDir();
+        const target = this.host.user ? `${this.host.user}@${this.host.hostname}` : this.host.hostname;
+        const wrapped = wrapRemoteCommand(command, options.remoteShell ?? 'login');
+        const ssh = `ssh ${buildSshOptions()} -- ${shellQuote(target)} ${shellQuote(wrapped)}`;
+        return this.local.execWithStdin(ssh, stdin, options);
+    }
+    /** No login wrapper — clean stdin for load-buffer; remote runs with non-login PATH. */
+    async execRawRemoteWithStdin(remoteCommand, stdin, options = {}) {
+        await ensureMuxDir();
+        const target = this.host.user ? `${this.host.user}@${this.host.hostname}` : this.host.hostname;
+        const ssh = `ssh ${buildSshOptions()} -- ${shellQuote(target)} ${shellQuote(remoteCommand)}`;
+        return this.local.execWithStdin(ssh, stdin, options);
+    }
+}
+export function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+// sh as outer shell so fish accepts the $SHELL handoff.
+export function wrapRemoteCommand(command, mode = 'login') {
+    const flags = mode === 'login-interactive' ? '-l -i -c' : '-l -c';
+    const inner = `exec "\${SHELL:-/bin/sh}" ${flags} "$1"`;
+    return `sh -c ${shellQuote(inner)} _ ${shellQuote(command)}`;
+}
+export function createRunner(mode, host) {
+    if (mode === 'remote') {
+        if (!host)
+            throw new Error('Remote mode requires host config');
+        return new SshRunner(host);
+    }
+    return new LocalRunner();
+}
+//# sourceMappingURL=runner.js.map

package/dist/agent/runner.js.map

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

package/dist/agent/spec-review-marker-watcher.d.ts

@@ -0,0 +1,33 @@
+import type { AgentConfig } from '../shared/index.js';
+import type { EventBus } from '../event/bus.js';
+import type { PaneStreamerManager } from './pane-streamer-manager.js';
+import { type ShortMarkerKind } from './marker-protocol.js';
+export type SpecMarkerKind = Extract<ShortMarkerKind, 'spec-ready' | 'spec-review-complete' | 'spec-fix-complete'>;
+export interface SpecReviewMarkerWatcherDeps {
+    paneStreamerManager: PaneStreamerManager;
+    eventBus: EventBus;
+    resolveAgent: (agentId: string) => AgentConfig | undefined;
+}
+export interface SpecReviewMarkerStartArgs {
+    taskId: string;
+    projectId: string;
+    agentId: string;
+    kind: SpecMarkerKind;
+    token: string;
+    skipSnapshot?: boolean;
+}
+export declare class SpecReviewMarkerWatcher {
+    private readonly deps;
+    private readonly entries;
+    constructor(deps: SpecReviewMarkerWatcherDeps);
+    start(args: SpecReviewMarkerStartArgs): Promise<void>;
+    /** Stops a single kind; without kind stops all kinds for the task. */
+    stop(taskId: string, kind?: SpecMarkerKind): void;
+    has(taskId: string, kind: SpecMarkerKind): boolean;
+    private onPaneData;
+    private emitCompletion;
+    private onSessionGone;
+    private emitArmFailureIntervention;
+    private emitInterventionFireAndForget;
+}
+//# sourceMappingURL=spec-review-marker-watcher.d.ts.map

package/dist/agent/spec-review-marker-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-review-marker-watcher.d.ts","sourceRoot":"","sources":["../../src/agent/spec-review-marker-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI9E,MAAM,MAAM,cAAc,GAAG,OAAO,CAClC,eAAe,EACf,YAAY,GAAG,sBAAsB,GAAG,mBAAmB,CAC5D,CAAC;AAmBF,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;CAC5D;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IAEd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD,qBAAa,uBAAuB;IAGtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;gBAE5B,IAAI,EAAE,2BAA2B;IAExD,KAAK,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD3D,sEAAsE;IACtE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,IAAI;IAgBjD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAIlD,OAAO,CAAC,UAAU;YA8BJ,cAAc;IAoB5B,OAAO,CAAC,aAAa;YAcP,0BAA0B;YAa1B,6BAA6B;CA2B5C"}