@agent-deck/cli 2.0.0 → 2.1.1

package/dist/run-detach.js

@@ -0,0 +1,233 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DETACH_FIRST_LINE_TIMEOUT_MS = void 0;
+exports.resolveRunOutPath = resolveRunOutPath;
+exports.buildDetachedChildArgs = buildDetachedChildArgs;
+exports.startDetachedRun = startDetachedRun;
+/**
+ * `agent-deck run --detach` — start the same run in a new session (NOT-401).
+ *
+ * The starter validates the launch exactly like a foreground run, allocates the
+ * run id and log path, then re-executes the CLI as a detached child (`detached:
+ * true` calls setsid on POSIX, so the child survives the calling shell, SSH
+ * session, or tool call going away) with stdin from /dev/null and stdout/stderr
+ * to `run.out` next to the log. Every flag of the starter is passed through
+ * unchanged, so a `--tools edit` run cannot silently run as readonly.
+ *
+ * The starter prints `runId`, child `pid`, and the log path, then exits 0
+ * within DETACH_FIRST_LINE_TIMEOUT_MS. Only one outcome is a starter failure:
+ * the child died before writing its first log line — that surfaces as exit 1
+ * with the tail of the child's captured output.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const daemon_logs_1 = require("./daemon-logs");
+const paths_1 = require("./managed/paths");
+const run_1 = require("./run");
+/** Bounded starter return: never wait longer than this for the first log line. */
+exports.DETACH_FIRST_LINE_TIMEOUT_MS = 5000;
+/** How often the starter polls for the first log line / child exit. */
+const DETACH_POLL_MS = 50;
+/** Stderr lines shown when the child dies before its first log line. */
+const DETACH_TAIL_LINES = 20;
+/** Child stdout/stderr sink, always next to the JSONL log. */
+function resolveRunOutPath(logPath) {
+    return node_path_1.default.join(node_path_1.default.dirname(logPath), 'run.out');
+}
+/** run.ts flags that consume the following argv token as their value. */
+const RUN_VALUE_FLAGS = new Set([
+    '--client',
+    '--cwd',
+    '--prompt',
+    '--prompt-file',
+    '--tools',
+    '--log',
+    '--resume',
+    '--_run-id',
+]);
+/**
+ * Child argv for the re-exec: the starter's own tokens verbatim (so a `--prompt`
+ * value that happens to read `--detach` still arrives intact), minus `--detach`
+ * itself, plus an explicit `--log` when the starter relied on the default and
+ * the allocated `--_run-id` so the child reuses the same run record.
+ */
+function buildDetachedChildArgs(originalArgs, runId, logPath) {
+    const child = [];
+    let hasLog = false;
+    for (let i = 0; i < originalArgs.length; i += 1) {
+        const arg = originalArgs[i];
+        if (arg === '--detach') {
+            continue;
+        }
+        if (arg === '--_run-id') {
+            // A stale override never survives: the starter's allocation always wins.
+            i += 1;
+            continue;
+        }
+        child.push(arg);
+        if (arg === '--log') {
+            hasLog = true;
+        }
+        if (RUN_VALUE_FLAGS.has(arg)) {
+            i += 1;
+            if (i < originalArgs.length) {
+                child.push(originalArgs[i]);
+            }
+        }
+    }
+    if (!hasLog) {
+        child.push('--log', logPath);
+    }
+    child.push('--_run-id', runId);
+    return child;
+}
+function logHasFirstLine(logPath) {
+    try {
+        return node_fs_1.default.readFileSync(logPath, 'utf8').trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function readOutTail(outPath, maxLines) {
+    try {
+        return node_fs_1.default
+            .readFileSync(outPath, 'utf8')
+            .split('\n')
+            .map((line) => line.trimEnd())
+            .filter((line) => line.length > 0)
+            .slice(-maxLines);
+    }
+    catch {
+        return [];
+    }
+}
+function describeChildEnd(code, signal) {
+    if (signal) {
+        return `signal ${signal}`;
+    }
+    return `code ${code ?? 1}`;
+}
+async function startDetachedRun(originalArgs, options, deps = {}) {
+    const prereq = await (0, run_1.validateRunPrereqs)(options, deps);
+    if ('error' in prereq) {
+        console.error(prereq.error);
+        return 1;
+    }
+    const { deck } = prereq;
+    const homeDir = deps.homeDir ?? (0, paths_1.agentDeckHome)();
+    const runId = (0, run_1.newRunId)();
+    const logPath = options.log ?? node_path_1.default.join(homeDir, 'runs', runId, 'run.jsonl');
+    const metaPath = node_path_1.default.join(node_path_1.default.dirname(logPath), 'meta.json');
+    const outPath = resolveRunOutPath(logPath);
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logPath), { recursive: true });
+    const childArgs = buildDetachedChildArgs(originalArgs, runId, logPath);
+    const spawnFn = deps.spawnFn ?? node_child_process_1.spawn;
+    const cliEntry = deps.cliEntry ?? (0, daemon_logs_1.resolveCliEntry)();
+    const timeoutMs = deps.firstLineTimeoutMs ?? exports.DETACH_FIRST_LINE_TIMEOUT_MS;
+    const outFd = node_fs_1.default.openSync(outPath, 'a');
+    node_fs_1.default.writeSync(outFd, `\n--- run ${runId} ${new Date().toISOString()} ---\n`);
+    let child;
+    try {
+        child = spawnFn(process.execPath, [cliEntry, 'run', ...childArgs], {
+            detached: true,
+            stdio: ['ignore', outFd, outFd],
+        });
+    }
+    catch (error) {
+        node_fs_1.default.closeSync(outFd);
+        console.error(`Failed to start the detached run: ${error instanceof Error ? error.message : error}`);
+        return 1;
+    }
+    // The stdio fds are dup'd into the child at spawn; the starter's copies can go.
+    node_fs_1.default.closeSync(outFd);
+    let spawnError = null;
+    let childEnd = null;
+    child.on('error', (error) => {
+        spawnError = error;
+        childEnd = { code: null, signal: null };
+    });
+    child.on('exit', (code, signal) => {
+        childEnd = { code, signal };
+    });
+    const pid = child.pid;
+    if (!pid) {
+        console.error('Failed to start the detached run: no child pid');
+        return 1;
+    }
+    child.unref();
+    const meta = {
+        runId,
+        deck: deck.id,
+        client: options.client,
+        tools: options.tools,
+        cwd: options.cwd,
+        pid,
+        startedAt: new Date().toISOString(),
+        state: 'running',
+    };
+    (0, run_1.writeRunMeta)(metaPath, meta);
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        if (logHasFirstLine(logPath)) {
+            break;
+        }
+        if (childEnd !== null || spawnError !== null) {
+            break;
+        }
+        if (Date.now() >= deadline) {
+            break;
+        }
+        await new Promise((resolve) => setTimeout(resolve, DETACH_POLL_MS));
+    }
+    if (logHasFirstLine(logPath)) {
+        console.log(`run ${runId} detached: pid ${pid} log ${logPath}`);
+        return 0;
+    }
+    if (childEnd === null && spawnError === null) {
+        // Slow first token, but the child is alive: the launch succeeded and the
+        // starter must still return within its bound.
+        console.log(`run ${runId} detached: pid ${pid} log ${logPath}`);
+        return 0;
+    }
+    // The child died before writing its first log line: surface its last words
+    // instead of reporting a launch that never happened.
+    // `as` defeats narrowing: both are only assigned from event callbacks, which
+    // control flow cannot see, so without it they read as still-null here.
+    const failure = spawnError;
+    const end = childEnd;
+    if (failure !== null) {
+        console.error(`Detached run ${runId} failed to spawn: ${failure.message}`);
+    }
+    else {
+        console.error(`Detached run ${runId} (pid ${pid}) died before its first log line (${describeChildEnd(end?.code ?? null, end?.signal ?? null)})`);
+    }
+    // Console output to a file fd flushes asynchronously; give the tail a beat.
+    await new Promise((resolve) => setTimeout(resolve, 200));
+    const tail = readOutTail(outPath, DETACH_TAIL_LINES);
+    if (tail.length === 0) {
+        console.error(`[agent-deck] ${outPath} had no output to show`);
+    }
+    else {
+        console.error(`[agent-deck] --- last ${tail.length} line(s) of ${outPath} ---`);
+        for (const line of tail) {
+            console.error(`[agent-deck] run.out| ${line}`);
+        }
+    }
+    try {
+        const current = JSON.parse(node_fs_1.default.readFileSync(metaPath, 'utf8'));
+        if (current.runId === runId && current.state === 'running') {
+            current.state = 'error';
+            (0, run_1.writeRunMeta)(metaPath, current);
+        }
+    }
+    catch {
+        // The diagnostic above is the deliverable; meta bookkeeping never fails it.
+    }
+    return 1;
+}
+//# sourceMappingURL=run-detach.js.map

package/dist/run-detach.js.map

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

package/dist/run-muse.d.ts

@@ -0,0 +1,127 @@
+import { type ClientAdapter, type NormalizedEvent, type RunToolsProfile } from './run-adapter';
+/**
+ * readonly: Muse's own read-only enforcement — `--disable-write` blocks
+ * non-shell workspace file writes and `--disable-shell` blocks workspace
+ * shell execution, so a readonly run cannot modify the checkout.
+ */
+export declare const MUSE_READONLY_FLAGS: readonly string[];
+/**
+ * edit: default bounded permissions (approval on-request, sandbox on) with
+ * no extra flags — there is no named profile to select, and the default
+ * never disables checks.
+ */
+export declare const MUSE_EDIT_FLAGS: readonly string[];
+export declare const MUSE_FLAGS_FOR_PROFILE: Record<RunToolsProfile, readonly string[]>;
+/** Flags that must never appear in generated argv (bypass checks or trust). */
+export declare const MUSE_FORBIDDEN_FLAGS: readonly string[];
+export declare function resolveMuseBin(): string;
+/**
+ * Readonly enforcement is structural AND verified: the flags exist in
+ * `muse exec --help` output (Muse Code 1.4.4), and planStart fails closed
+ * when the installed muse does not list them, so readonly never silently
+ * runs under default permissions. Help text, not a model call.
+ */
+export declare function museReadonlyFlagsSupported(probe: (bin: string, argv: string[]) => {
+    code: number;
+    stdout: string;
+    stderr: string;
+}, bin: string): boolean;
+export type MuseArgvArgs = {
+    prompt: string;
+    tools: RunToolsProfile;
+    resumeId?: string;
+};
+/**
+ * Resume ids are muse session ids (UUIDs); a leading `-` is never legitimate
+ * and would be parsed as an exec option, so it fails closed in planStart and
+ * throws here.
+ */
+export declare function assertSafeMuseResumeId(resumeId: string): void;
+/**
+ * Pure argv builder (everything after the `muse` binary). Start:
+ * `exec --json [--disable-write --disable-shell] -- <prompt>`; resume:
+ * `exec --json --session-id <id> [--disable-write --disable-shell] -- <prompt>`.
+ * The `--` terminator (accepted by `muse exec`, verified with the echo
+ * provider) keeps dash-leading prompts from being parsed as muse options.
+ */
+export declare function buildMuseArgv(args: MuseArgvArgs): string[];
+export type MuseProbeResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type MuseProbe = (bin: string, argv: string[]) => MuseProbeResult;
+export declare function defaultMuseProbe(bin: string, argv: string[]): MuseProbeResult;
+export type MuseChild = {
+    /** Stdout split into lines (without line terminators). */
+    stdout: AsyncIterable<string>;
+    /** Stderr split into lines (without line terminators). */
+    stderr: AsyncIterable<string>;
+    wait: () => Promise<{
+        code: number | null;
+        stderrTail: string;
+    }>;
+};
+export type MuseSpawn = (bin: string, argv: string[], opts: {
+    cwd: string;
+}) => MuseChild;
+export declare function defaultMuseSpawn(bin: string, argv: string[], opts: {
+    cwd: string;
+}): MuseChild;
+export type MuseLineContext = {
+    sessionId: string | null;
+};
+/**
+ * Map one `muse exec --json` stdout line onto normalized events. The session
+ * id is captured from `stream: {kind: "session", id}` on every record (no
+ * log line); `run.output.delta` becomes `text`; `tool_batch.effect.started`
+ * becomes `tool`; `run.terminal.completed` becomes `result` (subtype
+ * `success`, result text); any other `run.terminal.*` becomes `result`
+ * (subtype `failed`). Unknown kinds are ignored so a newer CLI cannot break
+ * the log. Never throws: unparseable lines become `notice`.
+ */
+export declare function museEventsFromLine(line: string, ctx: MuseLineContext): NormalizedEvent[];
+/** Stderr lines matching this surface as `notice` events; others are ignored. */
+export declare const MUSE_STDERR_NOTICE_PATTERN: RegExp;
+/**
+ * Map one stderr line onto a `notice` message. Muse prints startup warnings
+ * (`muse: Agent delegation: auto unavailable: workspace is untrusted.`,
+ * `muse: warning: rules file ... skipped ...`) to stderr; those surface as
+ * notices while routine diagnostics (`muse: workspace root: ...`, plugin
+ * lines) stay out of the log. Returns null for ignored lines. Never throws.
+ */
+export declare function museNoticeFromStderr(line: string): string | null;
+type MergedLine = {
+    source: 'out' | 'err';
+    line: string;
+};
+/**
+ * Merge stdout and stderr line iterables by arrival so startup warnings
+ * (stderr) land in the log in real order ahead of the streamed answer. Both
+ * sides are always consumed (no pipe deadlock); a rejection on either side
+ * throws, and the other side's pending read can never reject unobserved.
+ */
+export declare function mergeMuseLines(stdout: AsyncIterable<string>, stderr: AsyncIterable<string>): AsyncGenerator<MergedLine>;
+export type MuseFileReader = (path: string) => string | null;
+export declare function defaultMuseFileReader(filePath: string): string | null;
+/**
+ * Non-model signed-in check: META_API_KEY takes priority over the account
+ * login (`muse login --help`), otherwise the auth file must record a `meta`
+ * provider (token itself lives in the keychain; only the metadata is read).
+ */
+export declare function isMuseSignedIn(readFile: MuseFileReader): boolean;
+/**
+ * The agent-deck MCP entry must exist in the global Muse settings or the
+ * cwd's project `.mcp.json` (whichever `agent-deck use --client muse` wrote);
+ * without it no session receipt can ever appear in the log.
+ */
+export declare function hasMuseMcpEntry(cwd: string, readFile: MuseFileReader): boolean;
+export type MuseAdapterDeps = {
+    bin?: string;
+    probe?: MuseProbe;
+    spawn?: MuseSpawn;
+    readFile?: MuseFileReader;
+};
+export declare function createMuseAdapter(deps?: MuseAdapterDeps): ClientAdapter;
+export {};
+//# sourceMappingURL=run-muse.d.ts.map

package/dist/run-muse.d.ts.map

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