@crewx/cli 0.9.0-rc.19 → 0.9.0-rc.191

package/dist/commands/query.js

@@ -1,146 +1,16 @@
-"use strict";
-/**
- * crewx query handler.
- * Parses args, loads config via Crewx SDK, and executes the query.
- *
- * Flags:
- *   --thread <name>          Conversation thread name
- *   --provider <cli/xxx>     Provider override
- *   --metadata <json>        Extra metadata JSON (double-quoted object). Propagated to events/hooks/tracing.
- *                           e.g. --metadata='{"workflow_id":"wf-1"}'
- *   --verbose                Debug output mode (default: raw agent response only)
- *   --config/-c <path>       Config file path override
- *   --output-format <fmt>    Output format (json|text|stream-json)
- *   --effort <level>         Model effort (high|medium|low)
- *   -f/--prompt-file <path>  Read prompt body from file (bypasses cmd.exe argv truncation)
- *
- * Stdin support:
- *   Pipe or redirect content into crewx q to supply the prompt body via stdin.
- *   e.g. cat brief.md | crewx q "@agent label"
- *   Stdin is ignored when running in an interactive TTY.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleQuery = handleQuery;
-const sdk_1 = require("@crewx/sdk");
-const parse_agent_message_1 = require("./parse-agent-message");
-const parse_common_flags_1 = require("./parse-common-flags");
-const resolve_prompt_1 = require("./resolve-prompt");
-const crewx_cli_1 = require("../bootstrap/crewx-cli");
-const inherited_trace_1 = require("../utils/inherited-trace");
-const write_output_1 = require("./write-output");
-/**
- * Handle `crewx query <agentRef> <message>` command.
- *
- * Default output: raw agent response only (stdout).
- * --verbose: debug info written to stderr, response to stdout.
- */
-async function handleQuery(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
-    const { agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest);
-    // No @mention → default to @crewx agent (matches cli-bak behaviour)
-    const agentRef = parsedAgentRef || '@crewx';
-    // Resolve final prompt: argv | stdin pipe | --prompt-file (or combination)
-    const finalMessage = await (0, resolve_prompt_1.resolvePrompt)(message, promptFile);
-    if (!finalMessage) {
-        console.error('Usage: crewx query [@agent] <message> [options]');
-        console.error('       crewx q [@agent] <message> [options]');
-        console.error('');
-        console.error('  @agent is optional. Defaults to @crewx when omitted.');
-        console.error('  Prompt can also be supplied via stdin pipe or --prompt-file.');
-        console.error('');
-        console.error('Examples:');
-        console.error('  crewx q "@agent hello"');
-        console.error('  cat brief.md | crewx q "@agent summarise"');
-        console.error('  crewx q "@agent label" --prompt-file=brief.md');
-        console.error('');
-        console.error('Options:');
-        console.error('  --thread <name>           Conversation thread name');
-        console.error('  --provider <cli/xxx>      Provider override');
-        console.error('  --metadata <json>         Extra metadata (JSON object, double-quoted).');
-        console.error('                            Propagated to events/hooks/tracing.');
-        console.error('                            Invalid JSON aborts with exit code 2.');
-        console.error('                            e.g. --metadata=\'{"workflow_id":"wf-1"}\'');
-        console.error('  --verbose                 Debug output mode');
-        console.error('  --config/-c <path>        Config file path');
-        console.error('  --output-format <fmt>     Output format (json|text|stream-json)');
-        console.error('  --out/-o <path>           Save result to file (stdout suppressed)');
-        console.error('  --effort <level>          Model effort (high|medium|low)');
-        console.error('  -f/--prompt-file <path>   Read prompt body from file');
-        console.error('  --var key=value           Template variable (repeatable)');
-        console.error('  --overdrive               Activate overdrive (boost) profile for this request');
-        process.exit(1);
-    }
-    const configPath = config ?? process.env.CREWX_CONFIG ?? 'crewx.yaml';
-    // Only show exec audit span JSON in verbose mode
-    (0, sdk_1.setAuditVerbose)(verbose);
-    const crewx = await (0, crewx_cli_1.createCliCrewx)(configPath);
-    // file:// remote agent delegation is handled transparently inside Crewx.query/execute.
-    if (verbose) {
-        process.stderr.write(`📋 Task: ${finalMessage}\n`);
-        process.stderr.write(`🤖 Agent: ${agentRef}\n`);
-        if (thread)
-            process.stderr.write(`🔗 Thread: ${thread}\n`);
-        if (provider)
-            process.stderr.write(`🔌 Provider: ${provider}\n`);
-        if (outputFormat)
-            process.stderr.write(`📄 Output-format: ${outputFormat}\n`);
-        if (effort)
-            process.stderr.write(`⚡ Effort: ${effort}\n`);
-        if (overdrive)
-            process.stderr.write(`🚀 Overdrive: ON\n`);
-        process.stderr.write('─'.repeat(60) + '\n');
-    }
-    let parsedMetadata = {};
-    try {
-        parsedMetadata = (0, parse_common_flags_1.parseMetadata)(metadata);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`Error: ${msg}\n`);
-        process.exit(2);
-    }
-    let exitCode = 0;
-    try {
-        const result = await crewx.query(agentRef, finalMessage, {
-            provider,
-            effort: effort || undefined,
-            overdrive: overdrive || undefined,
-            threadId: thread,
-            metadata: Object.keys(parsedMetadata).length > 0 ? parsedMetadata : undefined,
-            vars: Object.keys(vars).length > 0 ? vars : undefined,
-            trace: (0, inherited_trace_1.readInheritedTrace)(),
-        });
-        if (!result.ok) {
-            const errMsg = result.error?.message ?? 'Query failed';
-            console.error(errMsg);
-            (0, write_output_1.appendError)(out, errMsg);
-            exitCode = 1;
-        }
-        else {
-            if (verbose) {
-                process.stderr.write(`\n📊 Results from ${agentRef}:\n`);
-                process.stderr.write('═'.repeat(60) + '\n');
-                process.stderr.write('🟢 Status: Success\n');
-                process.stderr.write(`🤖 Provider: ${result.meta.provider}\n`);
-                process.stderr.write(`⏱️  Duration: ${result.meta.durationMs}ms\n`);
-                process.stderr.write('\n📄 Response:\n');
-                process.stderr.write('─'.repeat(40) + '\n');
-            }
-            (0, write_output_1.writeResult)(out, result.data);
-            if (verbose) {
-                process.stderr.write('\n✅ Query completed successfully\n');
-            }
-        }
-    }
-    catch (err) {
-        const errMsg = err instanceof Error ? err.message : String(err);
-        console.error(`Error: ${errMsg}`);
-        (0, write_output_1.appendError)(out, `Error: ${errMsg}`);
-        exitCode = 1;
-    }
-    finally {
-        await crewx.close();
-    }
-    if (exitCode !== 0)
-        process.exit(exitCode);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.handleQuery=Y;const j=require("@crewx/sdk");const V=require("@crewx/sdk/repository");const z=require("./parse-agent-message");const N=require("./parse-common-flags");const K=require("./resolve-recipient");const L=require("./resolve-prompt");const S=require("../bootstrap/crewx-cli");const m=require("../utils/inherited-trace");const q=require("./write-output");const t=require("./detached");const a=require("./emit-trailer");async function Y(u,r="query",n=(0,a.createDelegationEmitState)()){const D=(0,t.readDetachedMiddleHop)(u);if(D){await(0,t.runDetachedMiddle)(r,D);return}const f=(0,t.extractReceiptFlags)(u);const y=(0,t.resolveReceiptMode)({detach:f.detach,wait:f.wait,detachedRunner:(0,m.isDetachedRunner)(),agentContext:Boolean(process.env["CREWX_AGENT_ID"])});if(y.receipt){await(0,t.runDetached)(r,f.rest,y.reason,u);return}let b;try{b=(0,N.parseCommonFlags)(f.rest)}catch(e){(0,a.emitDelegationResult)({command:r,isError:true,state:n});throw e}const{thread:R,provider:k,model:E,metadata:B,verbose:g,config:H,outputFormat:I,effort:_,promptFile:Q,overdrive:M,vars:T,out:x,rest:G,to:W}=b;const i=(0,m.readInheritedTrace)();let $;let C;let d;try{({agentRef:$,message:C}=(0,z.parseAgentMessage)(G));d=await(0,L.resolvePrompt)(C,Q)}catch(e){(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});throw e}let w;try{({agentRef:w}=(0,K.resolveRecipient)({positionalRef:$,toFlag:W,agentContext:Boolean(process.env["CREWX_AGENT_ID"]),bodyForHint:d,command:r,invocationArgs:u}))}catch(e){const o=e instanceof Error?e.message:String(e);process.stderr.write(`Error: ${o}
+`);(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});process.exit(2);return}if(!d){console.error("Usage: crewx query --to <agent> <message> [options]");console.error("       crewx q --to <agent> <message> [options]");console.error('  Human-terminal shorthand: crewx q "@agent <message>"');console.error("");console.error("  Agent calls require --to or a positional @agent recipient.");console.error("  Human terminal and cron calls default to @crewx when omitted.");console.error("  Prompt can also be supplied via stdin pipe or --prompt-file.");console.error("");console.error("Examples:");console.error('  crewx q --to agent "hello"');console.error("  crewx q --to agent -f brief.md");console.error("  Prompt files contain only the body; set the recipient separately with --to.");console.error("");console.error("Options:");console.error("  --to <agent>              Explicit agent recipient");console.error("  --thread <name>           Conversation thread name");console.error("  --provider <cli/xxx>      Provider override");console.error("  --model <name>            Model override (e.g. claude-sonnet-5)");console.error("  --metadata <json>         Extra metadata (JSON object, double-quoted).");console.error("                            Propagated to events/hooks/tracing.");console.error("                            Invalid JSON aborts with exit code 2.");console.error(`                            e.g. --metadata='{"workflow_id":"wf-1"}'`);console.error("  --verbose                 Debug output mode");console.error("  --config/-c <path>        Config file path");console.error("  --output-format <fmt>     Output format (json|text|stream-json)");console.error("  --out/-o <path>           Save result to file (stdout suppressed)");console.error("  --effort <level>          Model effort (high|medium|low)");console.error("  -f/--prompt-file <path>   Read body only from file; set recipient separately with --to");console.error("  --var key=value           Template variable (repeatable)");console.error("  --overdrive               Activate overdrive (boost) profile for this request");(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});process.exit(1);return}const X=H??process.env.CREWX_CONFIG??"crewx.yaml";(0,j.setAuditVerbose)(g);let A;try{A=await(0,S.createCliCrewx)(X)}catch(e){(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});throw e}if(g){process.stderr.write(`mode=sync reason=${y.reason}
+`);process.stderr.write(`\u{1F4CB} Task: ${d}
+`);process.stderr.write(`\u{1F916} Agent: ${w}
+`);if(R)process.stderr.write(`\u{1F517} Thread: ${R}
+`);if(k)process.stderr.write(`\u{1F50C} Provider: ${k}
+`);if(E)process.stderr.write(`\u{1F9E0} Model: ${E}
+`);if(I)process.stderr.write(`\u{1F4C4} Output-format: ${I}
+`);if(_)process.stderr.write(`\u26A1 Effort: ${_}
+`);if(M)process.stderr.write(`\u{1F680} Overdrive: ON
+`);process.stderr.write("\u2500".repeat(60)+"\n")}let h={};try{h=(0,N.parseMetadata)(B)}catch(e){const o=e instanceof Error?e.message:String(e);process.stderr.write(`Error: ${o}
+`);(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});process.exit(2);return}const J=(0,t.resolveCliTaskActor)(h);const U=(0,m.isDetachedRunner)();const P=(0,m.readRunnerAssignment)();let v;let O;let c;if(P!==void 0){const e=new V.TaskRepository;const o=(0,t.adoptAssignedTask)(e,P,U);if(o.kind==="failed"){(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});process.exit(1);return}if(o.kind==="adopted"){v=o.taskId;O=(0,t.readAssignedTaskActor)(e,o.taskId);c=(0,t.readAssignedTaskProviderAccountBinding)(e,o.taskId)}}let l;if(v===void 0){l=(0,j.admitDurableTask)(`direct-cli:${r}`);if(!l.ok){(0,t.reportAdmissionBlocked)(l);(0,a.emitDelegationResult)({command:r,trace:i,isError:true,state:n});process.exit(1);return}}const F=c?(0,t.mergeAssignedTaskProviderAccountMetadata)(h,c):h;let p=0;let s;try{try{s=await A.query(w,d,{provider:c?.provider??k,model:E,effort:_||void 0,overdrive:M||void 0,threadId:R,taskId:v,actor:v===void 0?J:O,metadata:Object.keys(F).length>0?F:void 0,vars:Object.keys(T).length>0?T:void 0,trace:i,...(0,t.buildRecordedProviderAccountOptions)(c),...c&&(0,t.shouldReplayRecordedAntigravityAcp)(c)?{providerAccountReplay:true}:{}});if(!s.ok){const e=s.error?.message??"Query failed";console.error(e);(0,q.appendError)(x,e);p=1}else{if(g){process.stderr.write(`
+\u{1F4CA} Results from ${w}:
+`);process.stderr.write("\u2550".repeat(60)+"\n");process.stderr.write("\u{1F7E2} Status: Success\n");process.stderr.write(`\u{1F916} Provider: ${s.meta.provider}
+`);process.stderr.write(`\u23F1\uFE0F  Duration: ${s.meta.durationMs}ms
+`);process.stderr.write("\n\u{1F4C4} Response:\n");process.stderr.write("\u2500".repeat(40)+"\n")}(0,q.writeResult)(x,s.data);if(g){process.stderr.write("\n\u2705 Query completed successfully\n")}}}catch(e){const o=e instanceof Error?e.message:String(e);console.error(`Error: ${o}`);(0,q.appendError)(x,`Error: ${o}`);p=1}finally{try{await A.close()}catch(e){(0,a.emitDelegationResult)({command:r,trace:i,taskId:s?.meta.taskId,agentId:s?.meta.agentId,isError:true,state:n});throw e}}}finally{if(l?.ok)l.release()}(0,a.emitDelegationResult)({command:r,trace:i,taskId:s?.meta.taskId,agentId:s?.meta.agentId,isError:p!==0||s?.ok===false,state:n});if(p!==0)process.exit(p)}

package/dist/commands/registry.js

@@ -1,31 +1 @@
-"use strict";
-/**
- * CLI command registry — SSOT for commands handled by the CLI engine.
- *
- * Consumed by:
- *   - main.ts dispatch (to avoid switch/case literal drift)
- *   - bin/__tests__/crewx-entrypoint.test.ts (SSOT assertion vs CLI_SUBCOMMANDS)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NOT_YET_MIGRATED = exports.BUILTIN_COMMAND_NAMES = exports.KNOWN_COMMANDS = void 0;
-/** Core commands handled by the main.ts switch/case or hook routing. */
-exports.KNOWN_COMMANDS = new Set([
-    'q', 'query',
-    'x', 'execute',
-    'agent',
-    'ps', 'kill', 'result', 'log', 'restart',
-    'doctor', 'init',
-    'db',
-    'help',
-    'slack', 'slack:files',
-    'hook', 'hook-dispatch',
-]);
-/** Built-in tool commands routed via handleBuiltin(). */
-exports.BUILTIN_COMMAND_NAMES = new Set([
-    'memory', 'search', 'doc', 'wbs', 'cron', 'workflow', 'skill', 'dreaming',
-    'wi', 'chromex',
-]);
-/** Commands not yet migrated from cli-bak — show a migration message. */
-exports.NOT_YET_MIGRATED = new Set([
-    'template', 'templates', 'chat', 'mcp',
-]);
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.NOT_YET_MIGRATED=exports.BUILTIN_COMMAND_NAMES=exports.KNOWN_COMMANDS=void 0;exports.KNOWN_COMMANDS=new Set(["q","query","x","execute","agent","history","ps","stop","kill","result","log","restart","doctor","init","db","help","shortcut","ai-account","publish","slack","slack:files","hook","hook-dispatch"]);exports.BUILTIN_COMMAND_NAMES=new Set(["memory","search","doc","wbs","cron","workflow","skill","dreaming","wi","chromex","notify","app"]);exports.NOT_YET_MIGRATED=new Set(["template","templates","chat","mcp"]);

package/dist/commands/resolve-prompt.js

@@ -1,54 +1,3 @@
-"use strict";
-/**
- * Prompt resolution utilities for q/x commands.
- *
- * Supports three input channels:
- *   1. --prompt-file <path>  — read content from a file
- *   2. stdin pipe/redirect   — read from process.stdin when not a TTY
- *   3. argv prompt           — positional argument passed directly on the command line
- *
- * When multiple sources are present, argv is used as a short label/prefix
- * and the file/stdin content is appended after a blank line.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readStdin = readStdin;
-exports.resolvePrompt = resolvePrompt;
-const fs_1 = require("fs");
-/**
- * Read all bytes from stdin (pipe or redirect).
- * Returns empty string when stdin is a TTY (interactive terminal).
- */
-async function readStdin() {
-    if (process.stdin.isTTY)
-        return '';
-    const chunks = [];
-    for await (const chunk of process.stdin)
-        chunks.push(chunk);
-    return Buffer.concat(chunks).toString('utf8').trimEnd();
-}
-/**
- * Resolve the final prompt from argv, stdin pipe, or --prompt-file.
- *
- * Priority:
- *   1. promptFile is specified → read file content
- *   2. argv is present → use argv (stdin is NOT read — prevents hang in child processes)
- *   3. argv is empty, no promptFile → read stdin pipe/redirect
- *   4. argv + promptFile both present → `${argv}\n\n${fileContent}`
- *   5. Neither present → return '' (caller decides error handling)
- *
- * @param _readStdin - injectable stdin reader, defaults to the module-level
- *   readStdin. Exposed as a parameter so unit tests can substitute a stub
- *   without fighting ESM module binding rules.
- */
-async function resolvePrompt(argvPrompt, promptFile, _readStdin = readStdin) {
-    let external = '';
-    if (promptFile) {
-        external = (0, fs_1.readFileSync)(promptFile, 'utf8').trimEnd();
-    }
-    else if (!argvPrompt) {
-        external = (await _readStdin()).trimEnd();
-    }
-    if (argvPrompt && external)
-        return `${argvPrompt}\n\n${external}`;
-    return external || argvPrompt;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.readStdin=f;exports.resolvePrompt=o;const s=require("fs");function u(n){const t=(0,s.readFileSync)(n);if(t.length>=3&&t[0]===239&&t[1]===187&&t[2]===191){return t.subarray(3).toString("utf8")}if(t.length>=2&&t[0]===255&&t[1]===254){return t.subarray(2).toString("utf16le")}if(t.length>=2&&t[0]===254&&t[1]===255){const r=t.subarray(2);for(let e=0;e+1<r.length;e+=2){const i=r[e];r[e]=r[e+1];r[e+1]=i}return r.toString("utf16le")}return t.toString("utf8")}async function f(){if(process.stdin.isTTY)return"";const n=[];for await(const t of process.stdin)n.push(t);return Buffer.concat(n).toString("utf8").trimEnd()}async function o(n,t,r=f){let e="";if(t){e=u(t).trimEnd()}else if(!n){e=(await r()).trimEnd()}if(n&&e)return`${n}
+
+${e}`;return e||n}

package/dist/commands/resolve-recipient.d.ts

@@ -0,0 +1,14 @@
+export interface ResolveRecipientOptions {
+    positionalRef?: string;
+    toFlag?: string;
+    agentContext: boolean;
+    bodyForHint?: string;
+    command?: string;
+    invocationArgs?: string[];
+}
+export declare class RecipientResolutionError extends Error {
+    constructor(message: string);
+}
+export declare function resolveRecipient(options: ResolveRecipientOptions): {
+    agentRef: string;
+};

package/dist/commands/resolve-recipient.js

@@ -0,0 +1,3 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.RecipientResolutionError=void 0;exports.resolveRecipient=d;class r extends Error{constructor(t){super(t);this.name="RecipientResolutionError"}}exports.RecipientResolutionError=r;function d(e){const t=c(e.toFlag,true);const n=c(e.positionalRef,false);if(t&&n&&t!==n){throw new r(`Recipient was specified twice: --to ${t.slice(1)} conflicts with positional ${n}.`)}const i=t??n;if(i)return{agentRef:i};if(!e.agentContext)return{agentRef:"@crewx"};const s=e.bodyForHint?.match(/^@(\S+)/u)?.[1];const u=s??"<agent-id>";const a=e.command??"query";const o=(e.invocationArgs??[]).map(l).join(" ");const f=`crewx ${a} --to ${u}${o?` ${o}`:""}`;throw new r(`No recipient was specified. Agent calls must set one explicitly; nothing was run.
+Retry command: ${f}
+To ask the built-in assistant on purpose, use --to crewx.`)}function c(e,t){if(e===void 0)return void 0;const n=e.trim().replace(/^@/u,"");if(!n){if(t)throw new r("--to requires an agent id.");return void 0}return`@${n}`}function l(e){if(!/\s/u.test(e))return e;return`"${e.replaceAll('"','\\"')}"`}

package/dist/commands/restart.d.ts

@@ -14,7 +14,9 @@
  *   crewx restart <task-id>
  *
  * Behavior:
- *   - Only tasks with status='failed' can be restarted.
+ *   - Only tasks with status='failed' can be restarted, except a run whose end was not
+ *     observed (`terminalReason: 'runner_lost'`): it may still be running, so it is refused
+ *     by default (same decision as the SDK's `isTaskRetryableByDefault`).
  *   - A new taskId is generated; the original task row is never mutated.
  *   - metadata.restartedFromTaskId (+ retriedFromTaskId for compat) is recorded.
  *   - The Web UI `TSK.RETRY` system-message prefix is reused verbatim.

package/dist/commands/restart.js

@@ -1,162 +1,18 @@
-"use strict";
-/**
- * crewx restart handler.
- * Restarts a failed task as a new task, reusing the original task's
- * thread / agent / mode / model / provider. The `provider` column is not
- * persisted on the task row, but the SDK records the effective provider in
- * `metadata.provider`, so we recover it from there (falling back to the
- * agent's configured provider when absent).
- *
- * Unlike the Web UI `Retry` (fire-and-forget), CLI `restart` awaits the new
- * task to completion and prints the final response — the CLI process is the
- * tracking owner, so it must not exit before the task finishes.
- *
- * Usage:
- *   crewx restart <task-id>
- *
- * Behavior:
- *   - Only tasks with status='failed' can be restarted.
- *   - A new taskId is generated; the original task row is never mutated.
- *   - metadata.restartedFromTaskId (+ retriedFromTaskId for compat) is recorded.
- *   - The Web UI `TSK.RETRY` system-message prefix is reused verbatim.
- *   - stdout carries the agent final response; guidance/errors go to stderr.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleRestart = handleRestart;
-const sdk_1 = require("@crewx/sdk");
-const crewx_cli_1 = require("../bootstrap/crewx-cli");
-const inherited_trace_1 = require("../utils/inherited-trace");
-/**
- * Build the retry system-message prefix.
- * Intentionally identical to the server `ThreadService.retryTask()` prefix so
- * stored conversations / parsers stay compatible. `type="retry"` is preserved.
- */
-function buildRetryPrefix(originalTaskId) {
-    return (`<crewx_system_message type="retry">\n` +
-        `Retrying a failed task.\n` +
-        `You must run \`crewx dreaming --task=${originalTaskId}\` to review where it stopped before continuing.\n` +
-        `</crewx_system_message>\n\n`);
-}
-/**
- * Recover the effective provider from a task row's `metadata` JSON.
- * The SDK persists the resolved provider as `metadata.provider`. Returns
- * the string when present and non-empty, otherwise `undefined` so the
- * agent's configured provider default is used.
- */
-function parseTaskMetadata(metadata) {
-    if (!metadata)
-        return {};
-    try {
-        const parsed = JSON.parse(metadata);
-        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-            ? parsed
-            : {};
-    }
-    catch {
-        return {};
-    }
-}
-function extractProvider(metadata) {
-    const provider = metadata.provider;
-    return typeof provider === 'string' && provider.length > 0 ? provider : undefined;
-}
-async function handleRestart(args) {
-    const verbose = args.includes('--verbose');
-    const taskId = args.find((a) => !a.startsWith('--'));
-    if (!taskId) {
-        process.stderr.write('Usage: crewx restart <task-id>\n');
-        process.exit(1);
-        return;
-    }
-    const repo = new sdk_1.TaskRepository();
-    const original = repo.getTask(taskId);
-    if (!original) {
-        process.stderr.write(`Error: Task not found: ${taskId}\n`);
-        process.exit(1);
-        return;
-    }
-    if (original.status !== 'failed') {
-        process.stderr.write(`Error: Task ${taskId} is not in failed state (current: ${original.status ?? 'unknown'}). ` +
-            `Only failed tasks can be restarted.\n`);
-        process.exit(1);
-        return;
-    }
-    if (!original.prompt) {
-        process.stderr.write(`Error: Task ${taskId} has no prompt to restart.\n`);
-        process.exit(1);
-        return;
-    }
-    if (!original.agent_id) {
-        process.stderr.write(`Error: Task ${taskId} has no agent to restart.\n`);
-        process.exit(1);
-        return;
-    }
-    const mode = original.mode === 'query' ? 'query' : 'execute';
-    const agentRef = `@${original.agent_id}`;
-    const newTaskId = (0, sdk_1.generateId)('tsk');
-    const restartPrompt = `${buildRetryPrefix(taskId)}${original.prompt}`;
-    // model: reuse the original task row value when present, otherwise fall back
-    // to the agent's configured default (resolved inside Crewx).
-    const model = original.model ?? undefined;
-    // provider: recovered from metadata.provider (SDK-persisted). Falls back to
-    // the agent's configured provider when absent. This preserves a
-    // `crewx x --provider ...` choice across restart.
-    const originalMetadata = parseTaskMetadata(original.metadata);
-    const provider = extractProvider(originalMetadata);
-    const originalWasOverdrive = originalMetadata.overdrive === true;
-    const originalOverdriveMode = originalMetadata.overdriveState === 'latch' ? 'latch' : 'count';
-    (0, sdk_1.setAuditVerbose)(verbose);
-    if (verbose) {
-        process.stderr.write(`🔁 Restart: ${taskId} → ${newTaskId}\n`);
-        process.stderr.write(`🤖 Agent: ${agentRef}  Mode: ${mode}\n`);
-        if (original.thread_id)
-            process.stderr.write(`🔗 Thread: ${original.thread_id}\n`);
-        process.stderr.write('─'.repeat(60) + '\n');
-    }
-    const crewx = await (0, crewx_cli_1.createCliCrewx)();
-    const sdkOptions = {
-        taskId: newTaskId,
-        threadId: original.thread_id ?? undefined,
-        model,
-        provider,
-        ...(originalWasOverdrive ? { overdrive: { mode: originalOverdriveMode } } : {}),
-        metadata: {
-            restartedFromTaskId: taskId,
-            // Back-compat / search convenience: mirror the Web UI metadata key.
-            retriedFromTaskId: taskId,
-            ...(originalWasOverdrive ? {
-                overdrive: true,
-                overdriveState: originalOverdriveMode,
-                overdriveMode: mode,
-            } : {}),
-        },
-        trace: (0, inherited_trace_1.readInheritedTrace)(),
-    };
-    let exitCode = 0;
-    try {
-        const result = mode === 'query'
-            ? await crewx.query(agentRef, restartPrompt, sdkOptions)
-            : await crewx.execute(agentRef, restartPrompt, sdkOptions);
-        if (result.ok) {
-            process.stdout.write(result.data + '\n');
-        }
-        else {
-            const errMsg = result.error?.message ?? 'Restart failed';
-            const resultTaskId = result.meta?.taskId ?? newTaskId;
-            process.stderr.write(`Error: ${errMsg}\n`);
-            process.stderr.write(`taskId=${resultTaskId}\n`);
-            exitCode = 1;
-        }
-    }
-    catch (err) {
-        const errMsg = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`Error: ${errMsg}\n`);
-        process.stderr.write(`taskId=${newTaskId}\n`);
-        exitCode = 1;
-    }
-    finally {
-        await crewx.close();
-    }
-    if (exitCode !== 0)
-        process.exit(exitCode);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.handleRestart=I;const n=require("@crewx/sdk");const T=require("../bootstrap/crewx-cli");const _=require("../utils/inherited-trace");const u=require("./detached");function b(o){return`<crewx_system_message type="retry">
+Retrying a failed task.
+You must run \`crewx dreaming --task=${o}\` to review where it stopped before continuing.
+</crewx_system_message>
+
+`}function R(o){if(!o)return{};try{const t=JSON.parse(o);return t&&typeof t==="object"&&!Array.isArray(t)?t:{}}catch{return{}}}function A(o){const t=o.provider;return typeof t==="string"&&t.length>0?t:void 0}async function I(o){const t=o.includes("--verbose");const r=o.find(s=>!s.startsWith("--"));if(!r){process.stderr.write("Usage: crewx restart <task-id>\n");process.exit(1);return}const h=new n.TaskRepository;const e=h.getTask(r);if(!e){process.stderr.write(`Error: Task not found: ${r}
+`);process.exit(1);return}if(!(0,n.isTaskRetryableByDefault)(e)){if((0,n.normalizeTaskStatus)(e)==="failed"){process.stderr.write(`Error: Task ${r} was not restarted: the end of the run was not observed (runner lost), so it may have done part of the work or may still be running. Check it with \`crewx log ${r}\` or \`crewx ps\` before running it again.
+`)}else{process.stderr.write(`Error: Task ${r} is not in failed state (current: ${e.status??"unknown"}). Only failed tasks can be restarted.
+`)}process.exit(1);return}if(!e.prompt){process.stderr.write(`Error: Task ${r} has no prompt to restart.
+`);process.exit(1);return}if(!e.agent_id){process.stderr.write(`Error: Task ${r} has no agent to restart.
+`);process.exit(1);return}const p=e.mode==="query"?"query":"execute";const l=`@${e.agent_id}`;const a=(0,n.generateId)("tsk");const g=`${b(r)}${e.prompt}`;const m=e.model??void 0;const i=R(e.metadata);const d=(0,u.readTaskProviderAccountBinding)(i);const x=d.provider??A(i);const k=i.overdrive===true;const v=i.overdriveState==="latch"?"latch":"count";(0,n.setAuditVerbose)(t);if(t){process.stderr.write(`\u{1F501} Restart: ${r} \u2192 ${a}
+`);process.stderr.write(`\u{1F916} Agent: ${l}  Mode: ${p}
+`);if(e.thread_id)process.stderr.write(`\u{1F517} Thread: ${e.thread_id}
+`);process.stderr.write("\u2500".repeat(60)+"\n")}const f=await(0,T.createCliCrewx)();const y={taskId:a,threadId:e.thread_id??void 0,model:m,provider:x,...(0,u.buildRecordedProviderAccountOptions)(d),...(0,u.shouldReplayRecordedAntigravityAcp)(d)?{providerAccountReplay:true}:{},...k?{overdrive:{mode:v}}:{},metadata:(0,u.mergeAssignedTaskProviderAccountMetadata)({restartedFromTaskId:r,retriedFromTaskId:r,...k?{overdrive:true,overdriveState:v,overdriveMode:p}:{}},d),trace:(0,_.readInheritedTrace)()};let c=0;try{const s=p==="query"?await f.query(l,g,y):await f.execute(l,g,y);if(s.ok){process.stdout.write(s.data+"\n")}else{const w=s.error?.message??"Restart failed";const $=s.meta?.taskId??a;process.stderr.write(`Error: ${w}
+`);process.stderr.write(`taskId=${$}
+`);c=1}}catch(s){const w=s instanceof Error?s.message:String(s);process.stderr.write(`Error: ${w}
+`);process.stderr.write(`taskId=${a}
+`);c=1}finally{await f.close()}if(c!==0)process.exit(c)}

package/dist/commands/result.d.ts

@@ -3,8 +3,13 @@
  * Retrieves the result of a completed task by its ID.
  *
  * Usage:
- *   crewx result <task-id>         Print raw result
- *   crewx result <task-id> --json  Print full task record as JSON
- *   crewx result                   List recent tasks (latest 10)
+ *   crewx result <task-id>            Print raw result
+ *   crewx result <task-id> --json     Print full task record as JSON
+ *   crewx result <task-id> --wait=<seconds> Poll (1s interval) up to the given
+ *                                    number of seconds for
+ *                                    the task to leave 'pending'/'running'. Exit 124 on
+ *                                    timeout. --wait=0 behaves like no --wait
+ *                                    (single immediate check).
+ *   crewx result                      List recent tasks (latest 10)
  */
 export declare function handleResult(args: string[]): Promise<void>;

package/dist/commands/result.js

@@ -1,70 +1 @@
-"use strict";
-/**
- * crewx result handler.
- * Retrieves the result of a completed task by its ID.
- *
- * Usage:
- *   crewx result <task-id>         Print raw result
- *   crewx result <task-id> --json  Print full task record as JSON
- *   crewx result                   List recent tasks (latest 10)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleResult = handleResult;
-const repository_1 = require("@crewx/sdk/repository");
-function statusIcon(status) {
-    switch (status) {
-        case 'running': return '⏳';
-        case 'success': return '✅';
-        case 'failed': return '❌';
-        default: return '❓';
-    }
-}
-async function handleResult(args) {
-    const jsonMode = args.includes('--json');
-    const taskId = args.find(a => !a.startsWith('--'));
-    const repo = new repository_1.TaskRepository();
-    if (!taskId) {
-        const all = repo.getAllTasks();
-        const recent = all.slice(0, 10);
-        if (recent.length === 0) {
-            console.log('No tasks found.');
-            console.log('Tip: Run `crewx query` or `crewx execute` to start a task.');
-            return;
-        }
-        console.log('Recent Tasks (latest 10)\n');
-        recent.forEach((task, idx) => {
-            const icon = statusIcon(task.status);
-            console.log(`${idx + 1}. ${icon} ${task.id}`);
-            console.log(`   Agent: ${task.agent_id ?? '—'}  Mode: ${task.mode ?? '—'}`);
-            console.log(`   Started: ${new Date(task.started_at).toLocaleString()}`);
-            if (task.completed_at) {
-                console.log(`   Completed: ${new Date(task.completed_at).toLocaleString()}`);
-            }
-            console.log('');
-        });
-        console.log('Tip: Run `crewx result <task-id>` to see full output.');
-        return;
-    }
-    const task = repo.getTask(taskId);
-    if (!task) {
-        console.error(`Error: Task not found: ${taskId}`);
-        process.exit(1);
-        return;
-    }
-    if (jsonMode) {
-        console.log(JSON.stringify(task, null, 2));
-        return;
-    }
-    if (task.status === 'running') {
-        console.error(`Task ${taskId} is still running.`);
-        console.error(`Use \`crewx kill ${taskId}\` to stop it.`);
-        process.exit(1);
-        return;
-    }
-    if (task.status === 'failed') {
-        console.error(`Task ${taskId} failed: ${task.error ?? 'unknown error'}`);
-        process.exit(1);
-        return;
-    }
-    console.log(task.result ?? '');
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.handleResult=M;const g=require("@crewx/sdk");const w=require("@crewx/sdk/repository");const d=require("./cal");const x=1e3;const f=1e4;function $(t){return t.status==="failed"&&(0,w.readTaskTerminalReason)(t)==="runner_lost"}function T(t){if($(t))return"\u26A0\uFE0F";switch(t.status){case"pending":return"\u{1F553}";case"running":return"\u23F3";case"success":return"\u2705";case"failed":return"\u274C";case"stopped":return"\u23F9";default:return"\u2753"}}function p(t){return t==="pending"||t==="running"}function _(t){return new Promise(s=>setTimeout(s,t))}function R(t){switch(t){case"pending":return"crewx.result-pending";case"running":return"crewx.result-running";case"success":return"crewx.result-done";case"failed":case"stopped":return"crewx.result-terminal-abnormal";default:return"crewx.result"}}function c(t,s){const r={taskId:t.id};if(t.agent_id)r.agent=t.agent_id;if(t.thread_id)r.thread=t.thread_id;if(p(t.status)){r.wait=String((0,d.suggestWaitSeconds)({startedAt:t.started_at,lastWaitSeconds:s}))}(0,d.writeCalFooter)({commandId:R(t.status),params:r})}function S(t,s=Date.now()){const r=Date.parse(t);const n=Number.isFinite(r)?Math.max(0,Math.floor((s-r)/1e3)):0;const i=Math.floor(n/3600);const u=Math.floor(n%3600/60);const e=n%60;if(i>0)return`${i}h ${u}m ${e}s`;if(u>0)return`${u}m ${e}s`;return`${e}s`}function k(t){const s=t.find(n=>n.startsWith("--wait="));if(s===void 0)return void 0;const r=Number(s.slice("--wait=".length));return Number.isFinite(r)&&r>=0?r:0}async function M(t){const s=t.includes("--json");const r=k(t);const n=t.find(o=>!o.startsWith("--"));const i=new w.TaskRepository;const u=await i.reapOrphanedTasks({tickIntervalMs:f});if(u>0)console.error(`Reaped ${u} orphaned task(s)`);if(!n){const o=i.getAllTasks();const l=o.slice(0,10);if(l.length===0){console.log("No tasks found.");console.log("Tip: Run `crewx query` or `crewx execute` to start a task.");return}console.log("Recent Tasks (latest 10)\n");l.forEach((a,m)=>{const h=T(a);console.log(`${m+1}. ${h} ${a.id}`);console.log(`   Agent: ${a.agent_id??"\u2014"}  Mode: ${a.mode??"\u2014"}`);console.log(`   Started: ${(0,g.formatDisplayTimestamp)(new Date(a.started_at))}`);if(a.completed_at){console.log(`   Completed: ${(0,g.formatDisplayTimestamp)(new Date(a.completed_at))}`)}console.log("")});console.log("Tip: Run `crewx result <task-id>` to see full output.");if(!s)c(l[0]);return}let e=i.getTask(n);if(!e){console.error(`Error: Task not found: ${n}`);process.exit(1);return}if(r!==void 0&&r>0&&p(e.status)){const o=Date.now()+r*1e3;let l=Date.now();while(e&&p(e.status)){if(Date.now()>=o){console.error(`Task ${n} is still ${e.status} (waited ${r}s; running for ${S(e.started_at)}). Not stalled \u2014 check again with a longer wait.`);c(e,r);process.exit(124);return}await _(Math.min(x,Math.max(0,o-Date.now())));if(Date.now()-l>=f){const a=await i.reapOrphanedTasks({tickIntervalMs:f});if(a>0)console.error(`Reaped ${a} orphaned task(s)`);l=Date.now()}e=i.getTask(n);if(!e){console.error(`Error: Task not found: ${n}`);process.exit(1);return}}}if(s){console.log(JSON.stringify(e,null,2));return}if(e.status==="pending"){console.error(`\u{1F553} Task ${n} is pending (waiting to start \u2014 runner has not adopted the task yet).`);const o=(0,d.suggestWaitSeconds)({startedAt:e.started_at,lastWaitSeconds:r});console.error(`Use \`crewx result ${n} --wait=${o}\` to wait for completion.`);c(e,r);process.exit(1);return}if(e.status==="running"){console.error(`Task ${n} is still running.`);const o=(0,d.suggestWaitSeconds)({startedAt:e.started_at,lastWaitSeconds:r});console.error(`Use \`crewx result ${n} --wait=${o}\` to wait longer or \`crewx log ${n}\` to inspect progress.`);c(e,r);process.exit(1);return}if(e.status==="stopped"){if(e.result!==null&&e.result!==void 0){console.log(e.result)}console.error(`\u23F9 Task ${n} was stopped by user: ${e.error??"no further details"}.`);c(e);process.exit(1);return}if($(e)){console.error(`\u26A0\uFE0F Task ${n} runner lost before completion: ${e.error??"no further details"}.`);c(e);process.exit(1);return}if(e.status==="failed"){console.error(`Task ${n} failed: ${e.error??"unknown error"}`);c(e);process.exit(1);return}console.log(e.result??"");c(e)}

package/dist/commands/shortcut.d.ts

@@ -0,0 +1 @@
+export declare function handleShortcut(args: string[]): Promise<void>;

package/dist/commands/shortcut.js

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.handleShortcut=b;const c=require("@crewx/sdk/desktop");const h=require("./parse-common-flags");const i="NOT_WINDOWS: Desktop shortcuts are only supported on Windows.";function a(e,t){let o=false;let s=false;for(const r of e){if(r==="--json"){o=true;continue}if(r==="--force"&&t){s=true;continue}throw new h.UnknownOptionError(`Unknown option: ${r}`)}return{json:o,force:s}}function f(e){process.stderr.write(`[shortcut] ${e.message}
+`)}function n(e){console.log(JSON.stringify(e))}function l(e,t){const o=e instanceof Error?e.message:String(e);if(t){n({success:false,error:o})}else{console.error(`\u2717 ${o}`)}process.exit(1)}function u(e){if(e){n({success:false,supported:false,state:"unsupported",error:i})}else{console.error(`\u2717 ${i}`)}process.exit(1)}function p(e){const t=e.errors.find(s=>s.startsWith("SUPERSEDED:"));if(e.state==="superseded"||t){return t??"Installed shortcut belongs to a newer CrewX version; refusing to modify it."}const o=e.errors.find(s=>s.startsWith("GLOBAL_INSTALL_UNCONFIRMED:"));if(!e.installedGlobal&&o){return o}if(e.errors.length>0){return e.errors[0]}return null}const w=new Set(["declined","not-installed"]);function g(e){if(w.has(e.state)){return null}const t=e.errors.find(o=>o.startsWith("SUPERSEDED:"));if(e.state==="superseded"||t){return t??"Installed shortcut belongs to a newer CrewX version; nothing was removed."}if(e.state==="foreign"){const o=e.errors.find(s=>s.startsWith("NSIS_PRESENT:"));return o??"Existing Desktop shortcut is not managed by CrewX; nothing was removed."}if(e.errors.length>0){return e.errors[0]}return`CrewX desktop shortcut could not be removed (state: ${e.state}).`}function S(e){switch(e.state){case"unsupported":console.log("Desktop shortcuts are only supported on Windows.");break;case"not-installed":console.log("No CrewX desktop shortcut installed yet.");console.log("Run `crewx shortcut install` to create one.");break;case"declined":console.log("CrewX desktop shortcut setup was previously dismissed.");console.log("Run `crewx shortcut install` to create one.");break;case"installed":console.log("\u2713 CrewX desktop shortcut is installed and up to date.");if(e.shortcutPath)console.log(`  Shortcut: ${e.shortcutPath}`);break;case"stale":console.log("\u26A0 CrewX desktop shortcut needs an update.");console.log("Run `crewx shortcut install` to refresh it.");break;case"foreign":console.log("\u26A0 A Desktop shortcut exists that CrewX does not manage.");console.log("Run `crewx shortcut install --force` to replace it.");break;case"superseded":console.log("\u26A0 The installed shortcut belongs to a newer CrewX version than the one running.");console.log("Update CrewX before touching the shortcut.");break}for(const t of e.errors){console.log(`  note: ${t}`)}}async function k(e){const{json:t}=a(e,false);let o;try{o=await(0,c.getShortcutStatus)()}catch(s){l(s,t)}if(t){n(o);return}S(o)}async function m(e){const{json:t,force:o}=a(e,true);let s;try{s=await(0,c.installShortcut)({force:o,onProgress:f})}catch(d){l(d,t)}if(!s.supported){u(t)}const r=p(s);if(r){if(t){n({...s,success:false})}else{console.error(`\u2717 ${r}`)}process.exit(1)}if(t){n({...s,success:true});return}if(s.changed){console.log('\u2713 CrewX desktop shortcut installed. Double-click "CrewX" on your Desktop to launch it.')}else{console.log('\u2713 CrewX desktop shortcut is already up to date. Double-click "CrewX" on your Desktop to launch it.')}if(s.shortcutPath)console.log(`  Shortcut: ${s.shortcutPath}`)}async function y(e){const{json:t}=a(e,false);let o;try{o=await(0,c.uninstallShortcut)()}catch(r){l(r,t)}if(!o.supported){u(t)}const s=g(o);if(s){if(t){n({...o,success:false})}else{console.error(`\u2717 ${s}`);for(const r of o.errors){if(r!==s)console.error(`  note: ${r}`)}}process.exit(1)}if(t){n({...o,success:true});return}console.log("\u2713 CrewX desktop shortcut removed.")}function C(){console.log(`
+crewx shortcut \u2014 manage the Windows Desktop shortcut for CrewX
+
+Usage:
+  crewx shortcut status [--json]
+  crewx shortcut install [--force] [--json]
+  crewx shortcut uninstall [--json]
+
+Options:
+  --json     Print machine-readable JSON to stdout (progress/log always go to stderr)
+  --force    (install only) Overwrite a Desktop shortcut CrewX does not manage.
+             Never overwrites a shortcut created by a newer CrewX version.
+
+Notes:
+  Windows only. On macOS/Linux, \`status\` reports state "unsupported" (exit 0);
+  \`install\`/\`uninstall\` exit 1 with no changes made.
+`.trim())}async function b(e){const t=e[0];if(!t||t==="help"||t==="--help"||t==="-h"){C();return}const o=e.slice(1);switch(t){case"status":return k(o);case"install":return m(o);case"uninstall":return y(o);default:console.error(`Unknown shortcut subcommand: ${t}`);console.error("Run `crewx shortcut help` for usage.");process.exit(1)}}