@crewx/cli 0.9.0-rc.145 → 0.9.0-rc.147

package/dist/commands/detached.js

@@ -1,620 +1,15 @@
-"use strict";
-/**
- * Shared receipt-mode implementation for the query and execute commands.
- *
- * A receipt is persisted before a detached runner is started. The runner gets
- * its own identity variables, while the trace variables remain the caller's
- * trace context and are never repurposed as the runner assignment.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCliTaskActor = resolveCliTaskActor;
-exports.resolveReceiptActor = resolveReceiptActor;
-exports.reportAdmissionBlocked = reportAdmissionBlocked;
-exports.extractReceiptFlags = extractReceiptFlags;
-exports.resolveReceiptMode = resolveReceiptMode;
-exports.buildDetachedRunnerArgs = buildDetachedRunnerArgs;
-exports.adoptAssignedTask = adoptAssignedTask;
-exports.readAssignedTaskActor = readAssignedTaskActor;
-exports.readDetachedMiddleHop = readDetachedMiddleHop;
-exports.runDetachedMiddle = runDetachedMiddle;
-exports.runDetached = runDetached;
-const child_process_1 = require("child_process");
-const fs_1 = require("fs");
-const path_1 = require("path");
-const os_1 = require("os");
-const sdk_1 = require("@crewx/sdk");
-const node_1 = require("@crewx/sdk/node");
-const repository_1 = require("@crewx/sdk/repository");
-const parse_agent_message_1 = require("./parse-agent-message");
-const parse_common_flags_1 = require("./parse-common-flags");
-const resolve_recipient_1 = require("./resolve-recipient");
-const resolve_prompt_1 = require("./resolve-prompt");
-const version_1 = require("../utils/version");
-const inherited_trace_1 = require("../utils/inherited-trace");
-const cal_1 = require("./cal");
-const emit_trailer_1 = require("./emit-trailer");
-function nonEmptyString(value) {
-    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
-}
-/** Resolve the CLI actor from metadata and the caller's current environment. */
-function resolveCliTaskActor(metadata, agentId = process.env['CREWX_AGENT_ID']) {
-    const scheduleId = nonEmptyString(metadata.schedule_id);
-    if (scheduleId)
-        return { actorKind: 'system', actorId: `cron:${scheduleId}` };
-    const workflow = metadata.workflow;
-    const workflowMetadata = workflow !== null && typeof workflow === 'object' && !Array.isArray(workflow)
-        ? workflow
-        : undefined;
-    const workflowExecId = nonEmptyString(workflowMetadata?.exec_id);
-    if (workflowExecId)
-        return { actorKind: 'system', actorId: `workflow:${workflowExecId}` };
-    const normalizedAgentId = nonEmptyString(agentId);
-    if (normalizedAgentId)
-        return { actorKind: 'agent', actorId: normalizedAgentId };
-    if (process.stdin.isTTY === true || process.stderr.isTTY === true) {
-        return { actorKind: 'human', actorId: (0, node_1.getLocalActorId)() };
-    }
-    return { actorKind: 'unknown', actorId: null };
-}
-/**
- * Resolve the actor at the receipt boundary while the caller's environment is
- * still available. The receipt and synchronous paths share one predicate so
- * cron runners cannot diverge after root context is stripped.
- */
-function resolveReceiptActor(metadata, agentId = process.env['CREWX_AGENT_ID']) {
-    const actor = resolveCliTaskActor(metadata, agentId);
-    return { kind: actor.actorKind, id: actor.actorId };
-}
-/**
- * Report a blocked direct admission (WI-CTO-20260919-004 R2 finding #1) to
- * the operator. Never called for an adopted (already pending) receipt — see
- * admitDurableTask()'s own doc comment.
- */
-function reportAdmissionBlocked(admission) {
-    process.stderr.write(`${admission.message}\n`);
-}
-const DETACHED_RUNNER_POLL_INTERVAL_MS = 200;
-const DETACHED_RUNNER_ADOPTION_TIMEOUT_MS = 30_000;
-const DETACHED_VALUE_FLAGS = [
-    '--to',
-    '--thread',
-    '--provider',
-    '--model',
-    '--metadata',
-    '--config',
-    '-c',
-    '--output-format',
-    '--effort',
-    '--prompt-file',
-    '-f',
-    '--out',
-    '-o',
-];
-const INTERNAL_MIDDLE_FLAG = '--__crewx-detached-middle';
-const INTERNAL_TASK_FLAG = '--__crewx-detached-task';
-const INTERNAL_LOG_FLAG = '--__crewx-detached-log';
-const INTERNAL_TOKEN_FLAG = '--__crewx-detached-token';
-const INTERNAL_TOKEN_ENV = 'CREWX_DETACHED_HOP_TOKEN';
-function isDetachedValueFlag(arg) {
-    return DETACHED_VALUE_FLAGS.some((name) => arg === name || arg.startsWith(`${name}=`));
-}
-function isDetachedPromptFileFlag(arg) {
-    return arg === '--prompt-file'
-        || arg === '-f'
-        || arg.startsWith('--prompt-file=')
-        || arg.startsWith('-f=');
-}
-/**
- * Remove receipt-selection flags, respecting the `--` literal-args sentinel.
- */
-function extractReceiptFlags(args) {
-    const rest = [];
-    let detach = false;
-    let wait = false;
-    let escapeMode = false;
-    for (const arg of args) {
-        if (!escapeMode && arg === '--') {
-            escapeMode = true;
-            rest.push(arg);
-            continue;
-        }
-        if (!escapeMode && (arg === '--detach' || arg === '--async')) {
-            detach = true;
-            continue;
-        }
-        if (!escapeMode && (arg === '--wait' || arg.startsWith('--wait='))) {
-            wait = true;
-            continue;
-        }
-        rest.push(arg);
-    }
-    return { detach, wait, rest };
-}
-/** Resolve the receipt/synchronous mode contract shared by q and x. */
-function resolveReceiptMode(options) {
-    if (options.wait)
-        return { receipt: false, reason: 'wait' };
-    // The runner guard is deliberately independent from trace propagation.
-    if (options.detachedRunner)
-        return { receipt: false, reason: 'detached-runner' };
-    if (options.detach)
-        return { receipt: true, reason: 'explicit-detach' };
-    if (options.agentContext)
-        return { receipt: true, reason: 'agent-context' };
-    return { receipt: false, reason: 'default' };
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-/** Wait for the pending receipt to be adopted, or for the runner to die. */
-function waitForDetachedRunner(taskRepo, taskId, child, options = {}) {
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        let pollTimer;
-        let timeoutTimer;
-        const cleanup = () => {
-            if (pollTimer !== undefined)
-                clearInterval(pollTimer);
-            if (timeoutTimer !== undefined)
-                clearTimeout(timeoutTimer);
-        };
-        const finish = (outcome) => {
-            if (settled)
-                return;
-            settled = true;
-            cleanup();
-            resolve(outcome);
-        };
-        const inspect = (terminalReason, timedOut = false) => {
-            try {
-                const task = taskRepo.getTask(taskId);
-                if (task && task.status !== 'pending') {
-                    finish({ kind: 'adopted' });
-                    return;
-                }
-                if (terminalReason !== undefined) {
-                    finish({ kind: 'exited', reason: terminalReason });
-                    return;
-                }
-                if (timedOut)
-                    finish({ kind: 'timeout' });
-            }
-            catch (error) {
-                if (settled)
-                    return;
-                settled = true;
-                cleanup();
-                reject(error);
-            }
-        };
-        child.on('error', (error) => {
-            inspect(`Runner failed before adopting task: ${errorMessage(error)}`);
-        });
-        child.on('exit', (code, signal) => {
-            if (options.ignoreSuccessfulExit && code === 0 && signal === null)
-                return;
-            const detail = signal ? `signal ${signal}` : `exit ${code ?? 'unknown'}`;
-            inspect(`Runner exited before adopting task (${detail})`);
-        });
-        pollTimer = setInterval(() => inspect(), DETACHED_RUNNER_POLL_INTERVAL_MS);
-        timeoutTimer = setTimeout(() => inspect(undefined, true), DETACHED_RUNNER_ADOPTION_TIMEOUT_MS);
-        inspect();
-    });
-}
-/** Mark a failed receipt only while the parent still owns its pending row. */
-function failDetachedTask(taskRepo, taskId, reason) {
-    try {
-        const transitioned = taskRepo.failPendingTask(taskId, reason);
-        if (transitioned) {
-            process.stderr.write(`Detached task ${taskId} failed: ${reason}\n`);
-            return false;
-        }
-        const task = taskRepo.getTask(taskId);
-        if (task && task.status !== 'pending')
-            return true;
-    }
-    catch (error) {
-        reason += `; could not persist failure: ${errorMessage(error)}`;
-    }
-    process.stderr.write(`Detached task ${taskId} failed: ${reason}\n`);
-    return false;
-}
-function announceDetachedTask(taskRepo, taskId, logPath, reason, verbose, outputFormat, warning) {
-    let status = 'pending';
-    try {
-        const task = taskRepo.getTask(taskId);
-        status = task?.status === 'pending' ? 'pending' : 'running';
-    }
-    catch {
-        // The receipt was already persisted. Keep the output contract stable if a
-        // follow-up status read is temporarily unavailable.
-    }
-    if (outputFormat === 'json') {
-        process.stdout.write(`${JSON.stringify({ taskId, status, mode: 'receipt', logPath })}\n`);
-        return;
-    }
-    if (verbose)
-        process.stderr.write(`mode=receipt reason=${reason}\n`);
-    process.stdout.write(`${taskId}\n`);
-    process.stderr.write(`Task ${taskId} accepted. This ID is the handle (not a PID).\n`);
-    if (warning && verbose)
-        process.stderr.write(`${warning}\n`);
-    const waitSeconds = (0, cal_1.suggestWaitSeconds)({ startedAt: null });
-    (0, cal_1.writeCalFooter)({
-        commandId: 'crewx.receipt',
-        params: { taskId, wait: String(waitSeconds) },
-    });
-}
-/**
- * Rebuild runner argv from the parsed request. The resolved prompt is passed
- * as one argv value after `--`, so stdin is never needed by the detached
- * child and prompt text beginning with a dash remains positional text.
- */
-function buildDetachedRunnerArgs(filteredArgs, agentRef, finalMessage) {
-    const forwarded = [];
-    for (let i = 0; i < filteredArgs.length; i += 1) {
-        const arg = filteredArgs[i];
-        if (arg === '--')
-            break;
-        if (arg === '--verbose' || arg === '--overdrive') {
-            forwarded.push(arg);
-            continue;
-        }
-        if (arg === '--var') {
-            const value = filteredArgs[i + 1];
-            if (value !== undefined) {
-                forwarded.push(arg, value);
-                i += 1;
-            }
-            continue;
-        }
-        if (arg.startsWith('--var=')) {
-            forwarded.push(arg);
-            continue;
-        }
-        if (arg === '--to') {
-            // The child receives the resolved recipient as a positional @agent.
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith('--to='))
-            continue;
-        if (!isDetachedValueFlag(arg))
-            continue;
-        if (isDetachedPromptFileFlag(arg)) {
-            // The parent already resolved this file into finalMessage. Forwarding
-            // the original path would make a later child read a mutable file again.
-            if (!arg.includes('='))
-                i += 1;
-            continue;
-        }
-        forwarded.push(arg);
-        if (!arg.includes('=')) {
-            const value = filteredArgs[i + 1];
-            if (value !== undefined) {
-                forwarded.push(value);
-                i += 1;
-            }
-        }
-    }
-    return [
-        ...forwarded,
-        ...(agentRef ? [agentRef] : []),
-        '--',
-        finalMessage,
-    ];
-}
-function runnerCommand(command) {
-    if (command === 'execute')
-        return 'x';
-    if (command === 'query')
-        return 'q';
-    return command;
-}
-/** Build the only environment contract that identifies a detached runner. */
-function buildRunnerEnvironment(taskId) {
-    const env = { ...process.env };
-    delete env[INTERNAL_TOKEN_ENV];
-    if (process.versions.electron) {
-        env.ELECTRON_RUN_AS_NODE = '1';
-    }
-    env.CREWX_DETACHED_RUNNER = '1';
-    env.CREWX_ASSIGNED_TASK_ID = taskId;
-    return env;
-}
-/**
- * Claim a pre-issued receipt without overwriting an already-owned row.
- * Assignment-only leakage is recoverable: discard the stale id and let the
- * normal SDK path create a fresh task. A real detached runner must fail loud
- * because its receipt would otherwise point at no execution row.
- */
-function adoptAssignedTask(taskRepo, taskId, detachedRunner) {
-    if (taskRepo.adoptPendingTask(taskId)) {
-        return { kind: 'adopted', taskId };
-    }
-    const reason = `stale assigned id ${taskId}: expected pending task with pid NULL`;
-    if (detachedRunner) {
-        process.stderr.write(`Detached runner failed to adopt task ${taskId}: ${reason}\n`);
-        return { kind: 'failed' };
-    }
-    process.stderr.write(`${reason}\n`);
-    return { kind: 'stale' };
-}
-/** Read the actor persisted on the receipt after the runner adopts it. */
-function readAssignedTaskActor(taskRepo, taskId) {
-    const task = taskRepo.getTask(taskId);
-    const actorKind = task?.actor_kind;
-    if (actorKind === null || actorKind === undefined) {
-        return { actorKind: 'unknown', actorId: null };
-    }
-    if (actorKind === 'human' || actorKind === 'agent' || actorKind === 'system' || actorKind === 'unknown') {
-        return { actorKind, actorId: task?.actor_id ?? null };
-    }
-    return { actorKind: 'unknown', actorId: task?.actor_id ?? null };
-}
-function buildMiddleEnvironment(token) {
-    const env = { ...process.env };
-    if (process.versions.electron) {
-        env.ELECTRON_RUN_AS_NODE = '1';
-    }
-    env[INTERNAL_TOKEN_ENV] = token;
-    return env;
-}
-/**
- * Read the private Windows middle-hop contract. Invalid direct invocations
- * are left untouched and therefore fail through the normal unknown-option
- * path instead of becoming an undocumented public command.
- */
-function readDetachedMiddleHop(args) {
-    let marker = false;
-    let taskId;
-    let logPath;
-    let token;
-    let escapeMode = false;
-    const runnerArgs = [];
-    for (const arg of args) {
-        if (!escapeMode && arg === '--') {
-            escapeMode = true;
-            runnerArgs.push(arg);
-            continue;
-        }
-        if (!escapeMode && arg === INTERNAL_MIDDLE_FLAG) {
-            marker = true;
-            continue;
-        }
-        if (!escapeMode && arg.startsWith(`${INTERNAL_TASK_FLAG}=`)) {
-            taskId = arg.slice(`${INTERNAL_TASK_FLAG}=`.length);
-            continue;
-        }
-        if (!escapeMode && arg.startsWith(`${INTERNAL_LOG_FLAG}=`)) {
-            logPath = arg.slice(`${INTERNAL_LOG_FLAG}=`.length);
-            continue;
-        }
-        if (!escapeMode && arg.startsWith(`${INTERNAL_TOKEN_FLAG}=`)) {
-            token = arg.slice(`${INTERNAL_TOKEN_FLAG}=`.length);
-            continue;
-        }
-        runnerArgs.push(arg);
-    }
-    if (!marker || !taskId || !logPath || !token || token !== process.env[INTERNAL_TOKEN_ENV]) {
-        return undefined;
-    }
-    return { taskId, logPath, runnerArgs };
-}
-/**
- * Windows middle hop: transfer a transient log handle to the final runner,
- * close the middle process's copy, and exit immediately. The parent treats a
- * successful middle-hop exit as normal and makes adoption a database decision.
- */
-async function runDetachedMiddle(command, hop) {
-    let logFd;
-    try {
-        const logDir = (0, path_1.dirname)(hop.logPath);
-        if (!(0, fs_1.existsSync)(logDir))
-            (0, fs_1.mkdirSync)(logDir, { recursive: true });
-        logFd = (0, fs_1.openSync)(hop.logPath, 'a');
-        const entry = process.argv[1];
-        const child = (0, child_process_1.spawn)(process.execPath, [entry, runnerCommand(command), ...hop.runnerArgs], {
-            detached: true,
-            windowsHide: true,
-            stdio: ['ignore', logFd, logFd],
-            env: buildRunnerEnvironment(hop.taskId),
-        });
-        (0, fs_1.closeSync)(logFd);
-        logFd = undefined;
-        child.unref();
-    }
-    catch (error) {
-        if (logFd !== undefined)
-            (0, fs_1.closeSync)(logFd);
-        process.stderr.write(`Runner failed before adopting task: ${errorMessage(error)}\n`);
-        process.exit(1);
-        return;
-    }
-    process.exit(0);
-}
-/**
- * Persist a receipt and launch its detached runner. Unix uses one hop. Windows
- * uses a short-lived middle hop so the final runner has no live parent link.
- */
-async function runDetached(command, filteredArgs, reason, invocationArgs = filteredArgs) {
-    const parsedFlags = (0, parse_common_flags_1.parseCommonFlags)(filteredArgs);
-    const { thread, metadata, promptFile, rest, to } = parsedFlags;
-    const { agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest);
-    const finalMessage = await (0, resolve_prompt_1.resolvePrompt)(message, promptFile);
-    let agentRef;
-    try {
-        ({ agentRef } = (0, resolve_recipient_1.resolveRecipient)({
-            positionalRef: parsedAgentRef,
-            toFlag: to,
-            agentContext: Boolean(process.env['CREWX_AGENT_ID']),
-            bodyForHint: finalMessage,
-            command,
-            invocationArgs,
-        }));
-    }
-    catch (error) {
-        const messageText = errorMessage(error);
-        process.stderr.write(`Error: ${messageText}\n`);
-        (0, emit_trailer_1.emitDelegationResult)({ command, trace: (0, inherited_trace_1.readInheritedTrace)(), isError: true });
-        process.exit(2);
-        return;
-    }
-    if (!finalMessage) {
-        console.error('Usage: crewx q|x --to <agent> <message> [options]');
-        console.error('  @agent is a positional shorthand for selecting a recipient.');
-        console.error('  Task body can also be supplied via stdin pipe or --prompt-file.');
-        process.exit(1);
-        return;
-    }
-    let parsedMetadata;
-    try {
-        parsedMetadata = (0, parse_common_flags_1.parseMetadata)(metadata);
-    }
-    catch (error) {
-        process.stderr.write(`Error: ${errorMessage(error)}\n`);
-        process.exit(2);
-        return;
-    }
-    // This process is a separate OS process from the embedded server and
-    // would otherwise never see a desktop update's admission gate at all
-    // (WI-CTO-20260919-004 R2 finding #1) — reserve-then-check before the
-    // pending receipt is written below, not after; see admitDurableTask()'s
-    // own doc comment for why that ordering closes the TOCTOU.
-    const admission = (0, sdk_1.admitDurableTask)(`direct-cli:${command}`);
-    if (!admission.ok) {
-        reportAdmissionBlocked(admission);
-        process.exit(1);
-        return;
-    }
-    const taskId = admission.taskId;
-    const startedAt = new Date().toISOString();
-    const workspacePath = process.cwd();
-    const hasWorkspaceConfig = (0, fs_1.existsSync)((0, path_1.join)(workspacePath, 'crewx.yaml'))
-        || (0, fs_1.existsSync)((0, path_1.join)(workspacePath, 'crewx.yml'));
-    const inheritedTrace = (0, inherited_trace_1.readInheritedTrace)();
-    const taskTrace = inheritedTrace?.rootTraceId || taskId;
-    const taskRepo = new repository_1.TaskRepository();
-    const actor = resolveReceiptActor(parsedMetadata);
-    try {
-        taskRepo.startTask({
-            id: taskId,
-            agentId: agentRef.replace(/^@/, ''),
-            actorKind: actor.kind,
-            actorId: actor.id,
-            prompt: finalMessage,
-            mode: command === 'q' || command === 'query' ? 'query' : 'execute',
-            status: 'pending',
-            startedAt,
-            pid: null,
-            parentTaskId: inheritedTrace?.parentTaskId ?? null,
-            callerAgentId: inheritedTrace?.callerAgentId ?? null,
-            traceId: taskTrace,
-            command: process.argv.join(' '),
-            metadata: Object.keys(parsedMetadata).length > 0 ? JSON.stringify(parsedMetadata) : null,
-            workspaceId: hasWorkspaceConfig ? (0, sdk_1.hashWorkspaceId)((0, sdk_1.resolveWorkspaceOwnerPath)(workspacePath)) : null,
-            cwd: (0, sdk_1.normalizeWorkspacePath)(workspacePath),
-            projectId: null,
-            platform: 'cli',
-            crewxVersion: version_1.CLI_VERSION,
-            threadId: thread ?? null,
-        });
-    }
-    catch (error) {
-        // The receipt's own pending row failed to persist — nothing durable was
-        // admitted, so the reservation's job is done regardless.
-        admission.release();
-        process.stderr.write(`Failed to create detached task receipt: ${errorMessage(error)}\n`);
-        process.exit(1);
-        return;
-    }
-    // The pending row above is now the durable, DB-visible signal of this
-    // work's admission — the reservation only ever existed to bridge the gap
-    // before it landed.
-    admission.release();
-    const runnerArgs = buildDetachedRunnerArgs(filteredArgs, agentRef, finalMessage);
-    const commandForRunner = runnerCommand(command);
-    const logDir = (0, path_1.join)((0, os_1.homedir)(), '.crewx', 'logs');
-    const logPath = (0, path_1.join)(logDir, `${taskId}.log`);
-    let logFd;
-    let child;
-    let middleHop = false;
-    try {
-        if (!(0, fs_1.existsSync)(logDir))
-            (0, fs_1.mkdirSync)(logDir, { recursive: true });
-        if (process.platform === 'win32') {
-            middleHop = true;
-            const token = (0, sdk_1.generateId)('req');
-            child = (0, child_process_1.spawn)(process.execPath, [
-                process.argv[1],
-                commandForRunner,
-                INTERNAL_MIDDLE_FLAG,
-                `${INTERNAL_TASK_FLAG}=${taskId}`,
-                `${INTERNAL_LOG_FLAG}=${logPath}`,
-                `${INTERNAL_TOKEN_FLAG}=${token}`,
-                ...runnerArgs,
-            ], {
-                detached: true,
-                windowsHide: true,
-                stdio: 'ignore',
-                env: buildMiddleEnvironment(token),
-            });
-        }
-        else {
-            logFd = (0, fs_1.openSync)(logPath, 'a');
-            child = (0, child_process_1.spawn)(process.execPath, [process.argv[1], commandForRunner, ...runnerArgs], {
-                detached: true,
-                windowsHide: true,
-                stdio: ['ignore', logFd, logFd],
-                env: buildRunnerEnvironment(taskId),
-            });
-            (0, fs_1.closeSync)(logFd);
-            logFd = undefined;
-        }
-        child.unref();
-    }
-    catch (error) {
-        if (logFd !== undefined)
-            (0, fs_1.closeSync)(logFd);
-        const reasonMessage = `Runner failed before adopting task: ${errorMessage(error)}`;
-        if (!failDetachedTask(taskRepo, taskId, reasonMessage))
-            process.exit(1);
-        else {
-            announceDetachedTask(taskRepo, taskId, logPath, reason, parsedFlags.verbose, parsedFlags.outputFormat);
-            process.exit(0);
-        }
-        return;
-    }
-    let outcome;
-    try {
-        outcome = await waitForDetachedRunner(taskRepo, taskId, child, {
-            ignoreSuccessfulExit: middleHop,
-        });
-    }
-    catch (error) {
-        const reasonMessage = `Runner adoption check failed: ${errorMessage(error)}`;
-        if (!failDetachedTask(taskRepo, taskId, reasonMessage))
-            process.exit(1);
-        else {
-            announceDetachedTask(taskRepo, taskId, logPath, reason, parsedFlags.verbose, parsedFlags.outputFormat);
-            process.exit(0);
-        }
-        return;
-    }
-    if (outcome.kind === 'adopted') {
-        announceDetachedTask(taskRepo, taskId, logPath, reason, parsedFlags.verbose, parsedFlags.outputFormat);
-        process.exit(0);
-        return;
-    }
-    if (outcome.kind === 'timeout') {
-        announceDetachedTask(taskRepo, taskId, logPath, reason, parsedFlags.verbose, parsedFlags.outputFormat, `Warning: runner alive, row not yet adopted after ${DETACHED_RUNNER_ADOPTION_TIMEOUT_MS / 1000}s.`);
-        process.exit(0);
-        return;
-    }
-    if (!failDetachedTask(taskRepo, taskId, outcome.reason))
-        process.exit(1);
-    else {
-        announceDetachedTask(taskRepo, taskId, logPath, reason, parsedFlags.verbose, parsedFlags.outputFormat);
-        process.exit(0);
-    }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.resolveCliTaskActor=V;exports.resolveReceiptActor=X;exports.reportAdmissionBlocked=B;exports.extractReceiptFlags=he;exports.resolveReceiptMode=_e;exports.buildDetachedRunnerArgs=Y;exports.adoptAssignedTask=we;exports.readAssignedTaskActor=me;exports.readDetachedMiddleHop=Ee;exports.runDetachedMiddle=xe;exports.runDetached=ve;const F=require("child_process");const l=require("fs");const A=require("path");const ne=require("os");const y=require("@crewx/sdk");const se=require("@crewx/sdk/node");const oe=require("@crewx/sdk/repository");const ie=require("./parse-agent-message");const j=require("./parse-common-flags");const ce=require("./resolve-recipient");const ae=require("./resolve-prompt");const de=require("../utils/version");const G=require("../utils/inherited-trace");const U=require("./cal");const ue=require("./emit-trailer");function q(e){return typeof e==="string"&&e.trim().length>0?e.trim():void 0}function V(e,t=process.env["CREWX_AGENT_ID"]){const r=q(e.schedule_id);if(r)return{actorKind:"system",actorId:`cron:${r}`};const n=e.workflow;const s=n!==null&&typeof n==="object"&&!Array.isArray(n)?n:void 0;const o=q(s?.exec_id);if(o)return{actorKind:"system",actorId:`workflow:${o}`};const i=q(t);if(i)return{actorKind:"agent",actorId:i};if(process.stdin.isTTY===true||process.stderr.isTTY===true){return{actorKind:"human",actorId:(0,se.getLocalActorId)()}}return{actorKind:"unknown",actorId:null}}function X(e,t=process.env["CREWX_AGENT_ID"]){const r=V(e,t);return{kind:r.actorKind,id:r.actorId}}function B(e){process.stderr.write(`${e.message}
+`)}const le=200;const z=3e4;const pe=["--to","--thread","--provider","--model","--metadata","--config","-c","--output-format","--effort","--prompt-file","-f","--out","-o"];const J="--__crewx-detached-middle";const C="--__crewx-detached-task";const L="--__crewx-detached-log";const M="--__crewx-detached-token";const b="CREWX_DETACHED_HOP_TOKEN";function fe(e){return pe.some(t=>e===t||e.startsWith(`${t}=`))}function ge(e){return e==="--prompt-file"||e==="-f"||e.startsWith("--prompt-file=")||e.startsWith("-f=")}function he(e){const t=[];let r=false;let n=false;let s=false;for(const o of e){if(!s&&o==="--"){s=true;t.push(o);continue}if(!s&&(o==="--detach"||o==="--async")){r=true;continue}if(!s&&(o==="--wait"||o.startsWith("--wait="))){n=true;continue}t.push(o)}return{detach:r,wait:n,rest:t}}function _e(e){if(e.wait)return{receipt:false,reason:"wait"};if(e.detachedRunner)return{receipt:false,reason:"detached-runner"};if(e.detach)return{receipt:true,reason:"explicit-detach"};if(e.agentContext)return{receipt:true,reason:"agent-context"};return{receipt:false,reason:"default"}}function h(e){return e instanceof Error?e.message:String(e)}function ke(e,t,r,n={}){return new Promise((s,o)=>{let i=false;let c;let _;const T=()=>{if(c!==void 0)clearInterval(c);if(_!==void 0)clearTimeout(_)};const E=a=>{if(i)return;i=true;T();s(a)};const k=(a,g=false)=>{try{const p=e.getTask(t);if(p&&p.status!=="pending"){E({kind:"adopted"});return}if(a!==void 0){E({kind:"exited",reason:a});return}if(g)E({kind:"timeout"})}catch(p){if(i)return;i=true;T();o(p)}};r.on("error",a=>{k(`Runner failed before adopting task: ${h(a)}`)});r.on("exit",(a,g)=>{if(n.ignoreSuccessfulExit&&a===0&&g===null)return;const p=g?`signal ${g}`:`exit ${a??"unknown"}`;k(`Runner exited before adopting task (${p})`)});c=setInterval(()=>k(),le);_=setTimeout(()=>k(void 0,true),z);k()})}function W(e,t,r){try{const n=e.failPendingTask(t,r);if(n){process.stderr.write(`Detached task ${t} failed: ${r}
+`);return false}const s=e.getTask(t);if(s&&s.status!=="pending")return true}catch(n){r+=`; could not persist failure: ${h(n)}`}process.stderr.write(`Detached task ${t} failed: ${r}
+`);return false}function R(e,t,r,n,s,o,i){let c="pending";try{const T=e.getTask(t);c=T?.status==="pending"?"pending":"running"}catch{}if(o==="json"){process.stdout.write(`${JSON.stringify({taskId:t,status:c,mode:"receipt",logPath:r})}
+`);return}if(s)process.stderr.write(`mode=receipt reason=${n}
+`);process.stdout.write(`${t}
+`);process.stderr.write(`Task ${t} accepted. This ID is the handle (not a PID).
+`);if(i&&s)process.stderr.write(`${i}
+`);const _=(0,U.suggestWaitSeconds)({startedAt:null});(0,U.writeCalFooter)({commandId:"crewx.receipt",params:{taskId:t,wait:String(_)}})}function Y(e,t,r){const n=[];for(let s=0;s<e.length;s+=1){const o=e[s];if(o==="--")break;if(o==="--verbose"||o==="--overdrive"){n.push(o);continue}if(o==="--var"){const i=e[s+1];if(i!==void 0){n.push(o,i);s+=1}continue}if(o.startsWith("--var=")){n.push(o);continue}if(o==="--to"){s+=1;continue}if(o.startsWith("--to="))continue;if(!fe(o))continue;if(ge(o)){if(!o.includes("="))s+=1;continue}n.push(o);if(!o.includes("=")){const i=e[s+1];if(i!==void 0){n.push(i);s+=1}}}return[...n,...t?[t]:[],"--",r]}function Q(e){if(e==="execute")return"x";if(e==="query")return"q";return e}function Z(e){const t={...process.env};delete t[b];if(process.versions.electron){t.ELECTRON_RUN_AS_NODE="1"}t.CREWX_DETACHED_RUNNER="1";t.CREWX_ASSIGNED_TASK_ID=e;return t}function we(e,t,r){if(e.adoptPendingTask(t)){return{kind:"adopted",taskId:t}}const n=`stale assigned id ${t}: expected pending task with pid NULL`;if(r){process.stderr.write(`Detached runner failed to adopt task ${t}: ${n}
+`);return{kind:"failed"}}process.stderr.write(`${n}
+`);return{kind:"stale"}}function me(e,t){const r=e.getTask(t);const n=r?.actor_kind;if(n===null||n===void 0){return{actorKind:"unknown",actorId:null}}if(n==="human"||n==="agent"||n==="system"||n==="unknown"){return{actorKind:n,actorId:r?.actor_id??null}}return{actorKind:"unknown",actorId:r?.actor_id??null}}function Te(e){const t={...process.env};if(process.versions.electron){t.ELECTRON_RUN_AS_NODE="1"}t[b]=e;return t}function Ee(e){let t=false;let r;let n;let s;let o=false;const i=[];for(const c of e){if(!o&&c==="--"){o=true;i.push(c);continue}if(!o&&c===J){t=true;continue}if(!o&&c.startsWith(`${C}=`)){r=c.slice(`${C}=`.length);continue}if(!o&&c.startsWith(`${L}=`)){n=c.slice(`${L}=`.length);continue}if(!o&&c.startsWith(`${M}=`)){s=c.slice(`${M}=`.length);continue}i.push(c)}if(!t||!r||!n||!s||s!==process.env[b]){return void 0}return{taskId:r,logPath:n,runnerArgs:i}}async function xe(e,t){let r;try{const n=(0,A.dirname)(t.logPath);if(!(0,l.existsSync)(n))(0,l.mkdirSync)(n,{recursive:true});r=(0,l.openSync)(t.logPath,"a");const s=process.argv[1];const o=(0,F.spawn)(process.execPath,[s,Q(e),...t.runnerArgs],{detached:true,windowsHide:true,stdio:["ignore",r,r],env:Z(t.taskId)});(0,l.closeSync)(r);r=void 0;o.unref()}catch(n){if(r!==void 0)(0,l.closeSync)(r);process.stderr.write(`Runner failed before adopting task: ${h(n)}
+`);process.exit(1);return}process.exit(0)}async function ve(e,t,r,n=t){const s=(0,j.parseCommonFlags)(t);const{thread:o,metadata:i,promptFile:c,rest:_,to:T}=s;const{agentRef:E,message:k}=(0,ie.parseAgentMessage)(_);const a=await(0,ae.resolvePrompt)(k,c);let g;try{({agentRef:g}=(0,ce.resolveRecipient)({positionalRef:E,toFlag:T,agentContext:Boolean(process.env["CREWX_AGENT_ID"]),bodyForHint:a,command:e,invocationArgs:n}))}catch(u){const v=h(u);process.stderr.write(`Error: ${v}
+`);(0,ue.emitDelegationResult)({command:e,trace:(0,G.readInheritedTrace)(),isError:true});process.exit(2);return}if(!a){console.error("Usage: crewx q|x --to <agent> <message> [options]");console.error("  @agent is a positional shorthand for selecting a recipient.");console.error("  Task body can also be supplied via stdin pipe or --prompt-file.");process.exit(1);return}let p;try{p=(0,j.parseMetadata)(i)}catch(u){process.stderr.write(`Error: ${h(u)}
+`);process.exit(2);return}const x=(0,y.admitDurableTask)(`direct-cli:${e}`);if(!x.ok){B(x);process.exit(1);return}const d=x.taskId;const ee=new Date().toISOString();const I=process.cwd();const te=(0,l.existsSync)((0,A.join)(I,"crewx.yaml"))||(0,l.existsSync)((0,A.join)(I,"crewx.yml"));const N=(0,G.readInheritedTrace)();const re=N?.rootTraceId||d;const f=new oe.TaskRepository;const O=X(p);try{f.startTask({id:d,agentId:g.replace(/^@/,""),actorKind:O.kind,actorId:O.id,prompt:a,mode:e==="q"||e==="query"?"query":"execute",status:"pending",startedAt:ee,pid:null,parentTaskId:N?.parentTaskId??null,callerAgentId:N?.callerAgentId??null,traceId:re,command:process.argv.join(" "),metadata:Object.keys(p).length>0?JSON.stringify(p):null,workspaceId:te?(0,y.hashWorkspaceId)((0,y.resolveWorkspaceOwnerPath)(I)):null,cwd:(0,y.normalizeWorkspacePath)(I),projectId:null,platform:"cli",crewxVersion:de.CLI_VERSION,threadId:o??null})}catch(u){x.release();process.stderr.write(`Failed to create detached task receipt: ${h(u)}
+`);process.exit(1);return}x.release();const P=Y(t,g,a);const K=Q(e);const S=(0,A.join)((0,ne.homedir)(),".crewx","logs");const w=(0,A.join)(S,`${d}.log`);let m;let D;let H=false;try{if(!(0,l.existsSync)(S))(0,l.mkdirSync)(S,{recursive:true});if(process.platform==="win32"){H=true;const u=(0,y.generateId)("req");D=(0,F.spawn)(process.execPath,[process.argv[1],K,J,`${C}=${d}`,`${L}=${w}`,`${M}=${u}`,...P],{detached:true,windowsHide:true,stdio:"ignore",env:Te(u)})}else{m=(0,l.openSync)(w,"a");D=(0,F.spawn)(process.execPath,[process.argv[1],K,...P],{detached:true,windowsHide:true,stdio:["ignore",m,m],env:Z(d)});(0,l.closeSync)(m);m=void 0}D.unref()}catch(u){if(m!==void 0)(0,l.closeSync)(m);const v=`Runner failed before adopting task: ${h(u)}`;if(!W(f,d,v))process.exit(1);else{R(f,d,w,r,s.verbose,s.outputFormat);process.exit(0)}return}let $;try{$=await ke(f,d,D,{ignoreSuccessfulExit:H})}catch(u){const v=`Runner adoption check failed: ${h(u)}`;if(!W(f,d,v))process.exit(1);else{R(f,d,w,r,s.verbose,s.outputFormat);process.exit(0)}return}if($.kind==="adopted"){R(f,d,w,r,s.verbose,s.outputFormat);process.exit(0);return}if($.kind==="timeout"){R(f,d,w,r,s.verbose,s.outputFormat,`Warning: runner alive, row not yet adopted after ${z/1e3}s.`);process.exit(0);return}if(!W(f,d,$.reason))process.exit(1);else{R(f,d,w,r,s.verbose,s.outputFormat);process.exit(0)}}