awb-agent-manager 1.0.0

package/dist/lib/cli-resolver.js

@@ -0,0 +1,177 @@
+import { execSync } from 'node:child_process';
+import { accessSync, constants as fsConstants, readlinkSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, basename } from 'node:path';
+import { KNOWN_CLI_TYPES } from './constants.js';
+import { log } from './logging.js';
+const isWindows = process.platform === 'win32';
+const WIN_EXEC_EXT = /\.exe$/i;
+function canExec(p) {
+    if (!p)
+        return false;
+    if (isWindows && !WIN_EXEC_EXT.test(p))
+        return false;
+    try {
+        accessSync(p, fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const CANDIDATE_PROVIDERS = {
+    claude: { unix: claudeUnixCandidates, windows: claudeWindowsCandidates },
+    agy: { unix: agyUnixCandidates, windows: agyWindowsCandidates },
+    codex: { unix: codexUnixCandidates, windows: codexWindowsCandidates },
+};
+function parentExeMatching(nameRegex) {
+    try {
+        const ppid = process.ppid;
+        if (!ppid)
+            return null;
+        const exe = readlinkSync(`/proc/${ppid}/exe`);
+        if (!exe || !canExec(exe))
+            return null;
+        if (/\.vscode\/extensions\//.test(exe))
+            return null;
+        if (!nameRegex.test(basename(exe)))
+            return null;
+        return exe;
+    }
+    catch {
+        return null;
+    }
+}
+const cache = new Map();
+export function resolveCliBin(cliType, configured) {
+    const ct = String(cliType || 'claude').toLowerCase();
+    const cached = cache.get(ct);
+    if (cached)
+        return cached;
+    if (configured && configured !== ct) {
+        if (KNOWN_CLI_TYPES.includes(configured)) {
+            log(`[cli-resolver:${ct}] ignoring configured="${configured}" — it names a different known CLI; falling through to lookup`);
+        }
+        else {
+            cache.set(ct, configured);
+            log(`[cli-resolver:${ct}] using configured path: ${configured}`);
+            return configured;
+        }
+    }
+    if (ct === 'claude') {
+        const viaParent = parentExeMatching(/claude/i);
+        if (viaParent) {
+            cache.set(ct, viaParent);
+            log(`[cli-resolver:claude] resolved via parent /proc/${process.ppid}/exe: ${viaParent}`);
+            return viaParent;
+        }
+    }
+    try {
+        const cmd = isWindows
+            ? `where ${ct}`
+            : `command -v ${ct} 2>/dev/null || which ${ct} 2>/dev/null`;
+        const out = execSync(cmd, {
+            encoding: 'utf8',
+            timeout: 2000,
+            shell: isWindows ? undefined : '/bin/sh',
+        }).trim();
+        const lines = out
+            .split(/\r?\n/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        for (const cand of lines) {
+            if (canExec(cand)) {
+                cache.set(ct, cand);
+                log(`[cli-resolver:${ct}] resolved via shell: ${cand}`);
+                return cand;
+            }
+        }
+    }
+    catch {
+    }
+    const provider = CANDIDATE_PROVIDERS[ct];
+    if (provider) {
+        const home = homedir();
+        const candidates = isWindows ? provider.windows(home) : provider.unix(home);
+        for (const p of candidates) {
+            if (canExec(p)) {
+                cache.set(ct, p);
+                log(`[cli-resolver:${ct}] resolved via candidate: ${p}`);
+                return p;
+            }
+        }
+    }
+    cache.set(ct, ct);
+    log(`[cli-resolver:${ct}] resolution failed; falling back to literal "${ct}" (expect ENOENT unless PATH is set)`);
+    return ct;
+}
+export function _resetResolverCache() {
+    cache.clear();
+}
+function claudeUnixCandidates(home) {
+    return [
+        join(home, '.npm-global/bin/claude'),
+        join(home, '.bun/bin/claude'),
+        join(home, '.local/bin/claude'),
+        join(home, '.volta/bin/claude'),
+        join(home, '.npm-packages/bin/claude'),
+        join(home, 'node_modules/.bin/claude'),
+        '/usr/local/bin/claude',
+        '/opt/homebrew/bin/claude',
+        '/usr/bin/claude',
+    ];
+}
+function claudeWindowsCandidates(home) {
+    const appdata = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+    const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+    const pkgBin = join(appdata, 'npm', 'node_modules', '@anthropic-ai', 'claude-code', 'bin');
+    return [
+        join(pkgBin, 'claude.exe'),
+        join(appdata, 'npm', 'claude.exe'),
+        join(localAppData, 'Programs', 'anthropic', 'claude-code', 'claude.exe'),
+    ];
+}
+function agyUnixCandidates(home) {
+    return [
+        join(home, '.local/bin/agy'),
+        join(home, '.npm-global/bin/agy'),
+        join(home, '.bun/bin/agy'),
+        join(home, '.volta/bin/agy'),
+        join(home, '.npm-packages/bin/agy'),
+        join(home, 'node_modules/.bin/agy'),
+        '/usr/local/bin/agy',
+        '/opt/homebrew/bin/agy',
+        '/usr/bin/agy',
+    ];
+}
+function agyWindowsCandidates(home) {
+    const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+    return [
+        join(localAppData, 'Antigravity', 'agy.exe'),
+        join(localAppData, 'Programs', 'google', 'antigravity', 'agy.exe'),
+    ];
+}
+function codexUnixCandidates(home) {
+    return [
+        join(home, '.npm-global/bin/codex'),
+        join(home, '.bun/bin/codex'),
+        join(home, '.local/bin/codex'),
+        join(home, '.volta/bin/codex'),
+        join(home, '.npm-packages/bin/codex'),
+        join(home, 'node_modules/.bin/codex'),
+        '/usr/local/bin/codex',
+        '/opt/homebrew/bin/codex',
+        '/usr/bin/codex',
+    ];
+}
+function codexWindowsCandidates(home) {
+    const appdata = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+    const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+    const pkgBin = join(appdata, 'npm', 'node_modules', '@openai', 'codex', 'bin');
+    return [
+        join(pkgBin, 'codex.exe'),
+        join(appdata, 'npm', 'codex.exe'),
+        join(localAppData, 'Programs', 'openai', 'codex', 'codex.exe'),
+    ];
+}
+//# sourceMappingURL=cli-resolver.js.map

package/dist/lib/cli-resolver.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,13 @@
+import { type CliType } from './constants.js';
+import type { AwbConfig } from './rest.js';
+export interface AgentInfo {
+    agent_id: string | null;
+    agent_name?: string;
+    workspace_id?: string;
+    _note?: string;
+    [key: string]: unknown;
+}
+export declare function loadConfig(path?: string): AwbConfig | null;
+export declare function loadAgentInfo(path?: string): AgentInfo | null;
+export declare function resolveAgentId(config: AwbConfig, agentPath?: string): Promise<string | null>;
+export declare function getCliType(config: AwbConfig | null | undefined): CliType;

package/dist/lib/config.js

@@ -0,0 +1,124 @@
+import { existsSync, readFileSync, promises as fsp } from 'node:fs';
+import { AGENT_PATH, CONFIG_PATH, DELEGATION_DEFAULTS, KNOWN_CLI_TYPES, REQUEST_TIMEOUT_MS, } from './constants.js';
+import { log } from './logging.js';
+export function loadConfig(path = CONFIG_PATH) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        raw.delegation = { ...DELEGATION_DEFAULTS, ...(raw.delegation || {}) };
+        const cli = String(raw.cli || 'claude').toLowerCase().trim();
+        raw.cli = cli || 'claude';
+        if (!KNOWN_CLI_TYPES.includes(raw.cli)) {
+            log(`config.cli="${raw.cli}" is not a known CLI; valid: ${KNOWN_CLI_TYPES.join(', ')}. Adapter will fall back at creation.`);
+        }
+        return raw;
+    }
+    catch (err) {
+        log(`config load failed (${path}): ${err?.message ?? err}`);
+        return null;
+    }
+}
+export function loadAgentInfo(path = AGENT_PATH) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        return raw && typeof raw === 'object' ? raw : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function resolveAgentId(config, agentPath = AGENT_PATH) {
+    const info = loadAgentInfo(agentPath);
+    if (!info)
+        return null;
+    if (typeof info.agent_id === 'string' && info.agent_id)
+        return info.agent_id;
+    log('agent_id is null — resolving via MCP whoami...');
+    const base = config.url.replace(/\/$/, '');
+    const url = `${base}/mcp`;
+    const headers = {
+        Authorization: `Bearer ${config.apiKey}`,
+        'Content-Type': 'application/json',
+        Accept: 'application/json, text/event-stream',
+    };
+    try {
+        const initResp = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'initialize',
+                params: {
+                    protocolVersion: '2025-03-26',
+                    capabilities: { experimental: { 'awb/schemaVersion': { version: 2 } } },
+                    clientInfo: { name: 'awb-agent-resolve', version: '1.0.0' },
+                },
+            }),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!initResp.ok)
+            throw new Error(`initialize HTTP ${initResp.status}`);
+        const sid = initResp.headers.get('mcp-session-id');
+        if (!sid)
+            throw new Error('initialize did not return Mcp-Session-Id');
+        await initResp.text().catch(() => null);
+        const sessionHeaders = { ...headers, 'Mcp-Session-Id': sid };
+        await fetch(url, {
+            method: 'POST',
+            headers: sessionHeaders,
+            body: JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        }).then((r) => r.text().catch(() => null));
+        const whoamiResp = await fetch(url, {
+            method: 'POST',
+            headers: sessionHeaders,
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 2,
+                method: 'tools/call',
+                params: { name: 'whoami', arguments: {} },
+            }),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!whoamiResp.ok)
+            throw new Error(`whoami HTTP ${whoamiResp.status}`);
+        const whoamiBody = await whoamiResp.json();
+        fetch(url, {
+            method: 'DELETE',
+            headers: sessionHeaders,
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        })
+            .then((r) => r.text().catch(() => null))
+            .catch(() => {
+        });
+        const content = whoamiBody?.result?.content;
+        if (!Array.isArray(content) || !content[0]?.text) {
+            throw new Error('unexpected whoami response shape');
+        }
+        const parsed = JSON.parse(content[0].text);
+        const agentId = parsed?.agent_id;
+        if (!agentId || typeof agentId !== 'string') {
+            throw new Error(`whoami returned no agent_id: ${content[0].text}`);
+        }
+        info.agent_id = agentId;
+        info._note = `agent_id resolved automatically by agent-manager at ${new Date().toISOString()}`;
+        await fsp.writeFile(agentPath, JSON.stringify(info, null, 2) + '\n', 'utf8');
+        log(`agent_id resolved: ${agentId.slice(0, 8)}...`);
+        return agentId;
+    }
+    catch (err) {
+        log(`agent_id resolve failed: ${err?.message ?? err}`);
+        return null;
+    }
+}
+export function getCliType(config) {
+    const raw = String(config?.cli ?? 'claude').toLowerCase().trim();
+    if (KNOWN_CLI_TYPES.includes(raw))
+        return raw;
+    return 'claude';
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/constants.d.ts

@@ -0,0 +1,36 @@
+export declare const AGENT_MANAGER_HOME: string;
+export declare const CONFIG_PATH: string;
+export declare const AGENT_PATH: string;
+export declare const SUBAGENTS_BASE_DIR: string;
+export declare const SUBAGENTS_PERSIST_PATH: string;
+export declare const INSTANCES_DIR: string;
+export declare const MANAGED_AGENTS_DIR: string;
+export declare const LOG_DIR: string;
+export declare const LOG_PATH: string;
+export declare const LEGACY_PLUGIN_HOME: string;
+export declare const LEGACY_CONFIG_PATH: string;
+export declare const LEGACY_AGENT_PATH: string;
+export declare const LEGACY_LOCK_PATH: string;
+export declare const LEGACY_MIGRATION_MARKER: string;
+export declare const RECONNECT_INITIAL_MS = 2000;
+export declare const RECONNECT_MAX_MS = 30000;
+export declare const REQUEST_TIMEOUT_MS = 30000;
+export declare const HEARTBEAT_INTERVAL_MS = 30000;
+export declare const OUTPUT_LIVENESS_MIN_INTERVAL_MS = 15000;
+export declare const DELEGATION_DEFAULTS: Readonly<{
+    enabled: true;
+    maxConcurrent: 15;
+    ttlMinutes: 15;
+    claudeBin: "claude";
+    appendSystemPromptMode: "role_only";
+    persistentChatSessions: true;
+    persistentTicketSessions: true;
+    idleMinutes: 10;
+    maxTurnsPerSession: 30;
+    worktreeIsolation: true;
+}>;
+export declare const TTL_SWEEP_INTERVAL_MS = 60000;
+export declare const SIGTERM_GRACE_MS = 5000;
+export declare const STOP_GRACE_MS = 2000;
+export declare const KNOWN_CLI_TYPES: readonly ["claude", "deepseek", "codex", "antigravity"];
+export type CliType = (typeof KNOWN_CLI_TYPES)[number];

package/dist/lib/constants.js

@@ -0,0 +1,51 @@
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+function configBaseDir() {
+    if (process.env.AWB_AGENT_MANAGER_HOME)
+        return process.env.AWB_AGENT_MANAGER_HOME;
+    if (platform() === 'win32') {
+        const appdata = process.env.APPDATA;
+        if (appdata)
+            return join(appdata, 'awb-agent-manager');
+    }
+    const xdg = process.env.XDG_CONFIG_HOME;
+    if (xdg)
+        return join(xdg, 'awb-agent-manager');
+    return join(homedir(), '.config', 'awb-agent-manager');
+}
+export const AGENT_MANAGER_HOME = configBaseDir();
+export const CONFIG_PATH = join(AGENT_MANAGER_HOME, 'config.json');
+export const AGENT_PATH = join(AGENT_MANAGER_HOME, 'agent.json');
+export const SUBAGENTS_BASE_DIR = join(AGENT_MANAGER_HOME, 'subagents');
+export const SUBAGENTS_PERSIST_PATH = join(AGENT_MANAGER_HOME, 'subagents.json');
+export const INSTANCES_DIR = join(AGENT_MANAGER_HOME, 'instances');
+export const MANAGED_AGENTS_DIR = join(AGENT_MANAGER_HOME, 'agents');
+export const LOG_DIR = AGENT_MANAGER_HOME;
+export const LOG_PATH = join(LOG_DIR, 'agent-manager.log');
+export const LEGACY_PLUGIN_HOME = join(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude'), 'channels', 'awb');
+export const LEGACY_CONFIG_PATH = join(LEGACY_PLUGIN_HOME, 'config.json');
+export const LEGACY_AGENT_PATH = join(LEGACY_PLUGIN_HOME, 'agent.json');
+export const LEGACY_LOCK_PATH = join(LEGACY_PLUGIN_HOME, 'agent.lock');
+export const LEGACY_MIGRATION_MARKER = join(LEGACY_PLUGIN_HOME, 'MIGRATED-TO-AGENT-MANAGER.txt');
+export const RECONNECT_INITIAL_MS = 2000;
+export const RECONNECT_MAX_MS = 30000;
+export const REQUEST_TIMEOUT_MS = 30000;
+export const HEARTBEAT_INTERVAL_MS = 30_000;
+export const OUTPUT_LIVENESS_MIN_INTERVAL_MS = 15_000;
+export const DELEGATION_DEFAULTS = Object.freeze({
+    enabled: true,
+    maxConcurrent: 15,
+    ttlMinutes: 15,
+    claudeBin: 'claude',
+    appendSystemPromptMode: 'role_only',
+    persistentChatSessions: true,
+    persistentTicketSessions: true,
+    idleMinutes: 10,
+    maxTurnsPerSession: 30,
+    worktreeIsolation: true,
+});
+export const TTL_SWEEP_INTERVAL_MS = 60_000;
+export const SIGTERM_GRACE_MS = 5_000;
+export const STOP_GRACE_MS = 2_000;
+export const KNOWN_CLI_TYPES = ['claude', 'deepseek', 'codex', 'antigravity'];
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

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

package/dist/lib/environment-provisioner.d.ts

@@ -0,0 +1,31 @@
+export interface ResolvedEnvironmentRepository {
+    url: string;
+    target_dir: string;
+    branch: string;
+    post_clone_commands: string[];
+}
+export interface ResolvedEnvironmentConfig {
+    repositories: ResolvedEnvironmentRepository[];
+    env_vars: Record<string, string>;
+    setup_commands: string[];
+    setup_timeout_seconds: number;
+    version: number;
+}
+export interface ProvisionArgs {
+    agentId: string;
+    config: ResolvedEnvironmentConfig;
+    ticketId?: string;
+}
+export interface ProvisionResult {
+    ok: boolean;
+    skipped: boolean;
+    fingerprint: string;
+    steps: string[];
+    error?: string;
+    reported?: boolean;
+}
+export declare function fingerprintEnvironment(config: ResolvedEnvironmentConfig): string;
+export declare class EnvironmentProvisioner {
+    #private;
+    provision(args: ProvisionArgs): Promise<ProvisionResult>;
+}

package/dist/lib/environment-provisioner.js

@@ -0,0 +1,182 @@
+import { promises as fsp } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execFile, exec } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { MANAGED_AGENTS_DIR } from './constants.js';
+import { log } from './logging.js';
+const FAILED_COOLDOWN_MS = 5 * 60 * 1000;
+function gitRaw(args, cwd, timeoutMs) {
+    return new Promise((resolve) => {
+        execFile('git', args, { cwd, timeout: timeoutMs, maxBuffer: 8 * 1024 * 1024, windowsHide: true }, (err, stdout, stderr) => {
+            resolve({
+                ok: !err,
+                code: err?.code ?? 0,
+                stdout: (stdout ?? '').toString(),
+                stderr: (stderr ?? err?.message ?? '').toString(),
+            });
+        });
+    });
+}
+function runShell(command, cwd, env, timeoutMs) {
+    return new Promise((resolve) => {
+        exec(command, { cwd, env, timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, windowsHide: true }, (err, stdout, stderr) => {
+            resolve({
+                ok: !err,
+                code: err?.code ?? 0,
+                stdout: (stdout ?? '').toString(),
+                stderr: (stderr ?? err?.message ?? '').toString(),
+            });
+        });
+    });
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(',')}}`;
+}
+export function fingerprintEnvironment(config) {
+    return createHash('sha256').update(stableStringify(config)).digest('hex').slice(0, 32);
+}
+async function pathExists(p) {
+    try {
+        await fsp.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class EnvironmentProvisioner {
+    #inflight = new Map();
+    async provision(args) {
+        const fingerprint = fingerprintEnvironment(args.config);
+        const lockKey = `${args.agentId}::${fingerprint}`;
+        const existing = this.#inflight.get(lockKey);
+        if (existing)
+            return existing;
+        const run = this.#run(args, fingerprint).finally(() => this.#inflight.delete(lockKey));
+        this.#inflight.set(lockKey, run);
+        return run;
+    }
+    async #run(args, fingerprint) {
+        const agentDir = join(MANAGED_AGENTS_DIR, args.agentId);
+        const envDir = join(agentDir, 'env');
+        const markerPath = join(envDir, `${fingerprint}.json`);
+        const failedPath = join(envDir, `${fingerprint}.failed.json`);
+        const steps = [];
+        if (await pathExists(markerPath)) {
+            return { ok: true, skipped: true, fingerprint, steps };
+        }
+        const recentFailure = await this.#readRecentFailure(failedPath);
+        if (recentFailure) {
+            log(`[env-provision] cooldown active for agent=${args.agentId.slice(0, 8)} fp=${fingerprint.slice(0, 8)} (last failure ${recentFailure})`);
+            return {
+                ok: false,
+                skipped: false,
+                fingerprint,
+                steps,
+                error: `environment provisioning previously failed (cooling down): ${recentFailure}`,
+                reported: true,
+            };
+        }
+        const timeoutMs = Math.max(1, args.config.setup_timeout_seconds) * 1000;
+        const env = { ...process.env, ...(args.config.env_vars || {}) };
+        try {
+            await fsp.mkdir(envDir, { recursive: true });
+            for (const repo of args.config.repositories || []) {
+                await this.#prepareRepo(repo, agentDir, env, timeoutMs, steps);
+            }
+            for (const cmd of args.config.setup_commands || []) {
+                log(`[env-provision] setup: ${cmd} (agent=${args.agentId.slice(0, 8)})`);
+                const r = await runShell(cmd, agentDir, env, timeoutMs);
+                steps.push(`setup [${'.'}] ${cmd} → ${r.ok ? 'ok' : `FAIL(${r.code})`}`);
+                if (!r.ok) {
+                    throw new Error(`setup command failed (exit ${r.code}): ${cmd}\n${tail(r.stderr)}`);
+                }
+            }
+            await fsp.writeFile(markerPath, JSON.stringify({
+                fingerprint,
+                applied_at: new Date().toISOString(),
+                version: args.config.version,
+                repositories: (args.config.repositories || []).map((r) => r.target_dir),
+            }, null, 2));
+            await fsp.rm(failedPath, { force: true }).catch(() => { });
+            log(`[env-provision] ready: agent=${args.agentId.slice(0, 8)} fp=${fingerprint.slice(0, 8)} repos=${(args.config.repositories || []).length} setup=${(args.config.setup_commands || []).length}`);
+            return { ok: true, skipped: false, fingerprint, steps };
+        }
+        catch (err) {
+            const error = String(err?.message ?? err);
+            log(`[env-provision] FAILED: agent=${args.agentId.slice(0, 8)} fp=${fingerprint.slice(0, 8)}: ${error}`);
+            await fsp
+                .writeFile(failedPath, JSON.stringify({ fingerprint, failed_at: new Date().toISOString(), error, steps }, null, 2))
+                .catch(() => { });
+            return { ok: false, skipped: false, fingerprint, steps, error };
+        }
+    }
+    async #prepareRepo(repo, agentDir, env, timeoutMs, steps) {
+        const dest = join(agentDir, repo.target_dir);
+        const gitDir = join(dest, '.git');
+        let fresh = false;
+        if (await pathExists(gitDir)) {
+            const fetched = await gitRaw(['-C', dest, 'fetch', '--all', '--prune'], undefined, timeoutMs);
+            steps.push(`fetch ${repo.target_dir} → ${fetched.ok ? 'ok' : `FAIL: ${tail(fetched.stderr)}`}`);
+            if (!fetched.ok) {
+                throw new Error(`git fetch failed for ${repo.target_dir}: ${tail(fetched.stderr)}`);
+            }
+            if (repo.branch) {
+                const co = await gitRaw(['-C', dest, 'checkout', repo.branch], undefined, timeoutMs);
+                steps.push(`checkout ${repo.branch} in ${repo.target_dir} → ${co.ok ? 'ok' : `skip: ${tail(co.stderr)}`}`);
+            }
+            const pulled = await gitRaw(['-C', dest, 'pull', '--ff-only'], undefined, timeoutMs);
+            steps.push(`pull --ff-only ${repo.target_dir} → ${pulled.ok ? 'ok' : `non-ff (left as-is): ${tail(pulled.stderr)}`}`);
+        }
+        else {
+            await fsp.mkdir(dirname(dest), { recursive: true });
+            const args = ['clone'];
+            if (repo.branch)
+                args.push('--branch', repo.branch);
+            args.push(repo.url, dest);
+            log(`[env-provision] clone ${repo.url} → ${repo.target_dir}`);
+            const cloned = await gitRaw(args, undefined, timeoutMs);
+            steps.push(`clone ${repo.url} → ${repo.target_dir} ${cloned.ok ? 'ok' : `FAIL: ${tail(cloned.stderr)}`}`);
+            if (!cloned.ok) {
+                throw new Error(`git clone failed for ${repo.url}: ${tail(cloned.stderr)}`);
+            }
+            fresh = true;
+        }
+        if (fresh) {
+            for (const cmd of repo.post_clone_commands || []) {
+                log(`[env-provision] post_clone [${repo.target_dir}]: ${cmd}`);
+                const r = await runShell(cmd, dest, env, timeoutMs);
+                steps.push(`post_clone [${repo.target_dir}] ${cmd} → ${r.ok ? 'ok' : `FAIL(${r.code})`}`);
+                if (!r.ok) {
+                    throw new Error(`post_clone command failed (exit ${r.code}) in ${repo.target_dir}: ${cmd}\n${tail(r.stderr)}`);
+                }
+            }
+        }
+    }
+    async #readRecentFailure(failedPath) {
+        try {
+            const raw = await fsp.readFile(failedPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            const failedAt = Date.parse(parsed?.failed_at || '');
+            if (!Number.isFinite(failedAt))
+                return null;
+            if (Date.now() - failedAt > FAILED_COOLDOWN_MS)
+                return null;
+            return String(parsed?.error || 'unknown error');
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function tail(s, n = 1500) {
+    const t = (s || '').trim();
+    return t.length > n ? `…${t.slice(-n)}` : t;
+}
+//# sourceMappingURL=environment-provisioner.js.map