@crewx/cli 0.9.0-rc.82 → 0.9.0-rc.83

package/dist/commands/emit-trailer.d.ts

@@ -0,0 +1,25 @@
+import type { TraceContext } from '@crewx/sdk';
+/** Mutable per-process guard shared by a handler and main()'s error boundary. */
+export interface DelegationEmitState {
+    emitted: boolean;
+}
+/** The result fields needed to produce a delegation control line. */
+export interface DelegationEmitOptions {
+    command?: string;
+    trace?: TraceContext;
+    taskId?: string;
+    agentId?: string;
+    isError: boolean;
+    state?: DelegationEmitState;
+}
+export declare function createDelegationEmitState(): DelegationEmitState;
+/**
+ * Return true only for an inherited child invocation of q/query/x/execute.
+ * Root CLI calls and unrelated built-in commands must remain byte-compatible.
+ */
+export declare function shouldEmitDelegationResult(command: string | undefined, trace?: TraceContext | undefined): boolean;
+/**
+ * Write one machine-readable result line to stdout when this is a delegated call.
+ * The shared SDK formatter owns the wire syntax and validation rules.
+ */
+export declare function emitDelegationResult(options: DelegationEmitOptions): boolean;

package/dist/commands/emit-trailer.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDelegationEmitState = createDelegationEmitState;
+exports.shouldEmitDelegationResult = shouldEmitDelegationResult;
+exports.emitDelegationResult = emitDelegationResult;
+const sdk_1 = require("@crewx/sdk");
+const inherited_trace_1 = require("../utils/inherited-trace");
+const DELEGATION_COMMANDS = new Set(['q', 'query', 'x', 'execute']);
+function createDelegationEmitState() {
+    return { emitted: false };
+}
+/**
+ * Return true only for an inherited child invocation of q/query/x/execute.
+ * Root CLI calls and unrelated built-in commands must remain byte-compatible.
+ */
+function shouldEmitDelegationResult(command, trace = (0, inherited_trace_1.readInheritedTrace)()) {
+    return DELEGATION_COMMANDS.has(command ?? '') && Boolean(trace?.parentTaskId);
+}
+/**
+ * Write one machine-readable result line to stdout when this is a delegated call.
+ * The shared SDK formatter owns the wire syntax and validation rules.
+ */
+function emitDelegationResult(options) {
+    const { command, trace, state, taskId, agentId, isError } = options;
+    if (state?.emitted || !shouldEmitDelegationResult(command, trace))
+        return false;
+    const line = (0, sdk_1.formatDelegationResult)({ taskId, agentId, isError });
+    // Mark before writing so an EPIPE/error boundary cannot accidentally retry.
+    if (state)
+        state.emitted = true;
+    process.stdout.write(`${line}\n`);
+    return true;
+}

package/dist/commands/execute.d.ts

@@ -22,10 +22,11 @@
  *   e.g. cat task.md | crewx x "@agent label"
  *   Stdin is ignored when running in an interactive TTY.
  */
+import { type DelegationEmitState } from './emit-trailer';
 /**
  * Handle `crewx execute <agentRef> <message>` command.
  *
  * Default output: raw agent response only (stdout).
  * --verbose: debug info written to stderr, response to stdout.
  */
-export declare function handleExecute(args: string[]): Promise<void>;
+export declare function handleExecute(args: string[], command?: string, emitState?: DelegationEmitState): Promise<void>;

package/dist/commands/execute.js

@@ -36,6 +36,7 @@ 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");
+const emit_trailer_1 = require("./emit-trailer");
 /**
  * Split `--detach` out of argv, respecting the `--` literal-args sentinel
  * (a `--detach` appearing after `--` is message text, not the flag).
@@ -97,7 +98,7 @@ function runDetached(filteredArgs) {
  * Default output: raw agent response only (stdout).
  * --verbose: debug info written to stderr, response to stdout.
  */
-async function handleExecute(args) {
+async function handleExecute(args, command = 'execute', emitState = (0, emit_trailer_1.createDelegationEmitState)()) {
     const { detach, rest: detachFilteredArgs } = extractDetachFlag(args);
     if (detach) {
         // Recursive-spawn guard: a CREWX_TRACE_ID already present means this
@@ -109,6 +110,7 @@ async function handleExecute(args) {
         }
         else if (process.platform === 'win32') {
             console.error('Error: --detach is not supported on win32.');
+            (0, emit_trailer_1.emitDelegationResult)({ command, isError: true, state: emitState });
             process.exit(1);
             return;
         }
@@ -117,12 +119,29 @@ async function handleExecute(args) {
             return;
         }
     }
-    const { thread, provider, model, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, rest } = (0, parse_common_flags_1.parseCommonFlags)(detachFilteredArgs);
-    const { agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest);
-    // No @mention → default to @crewx agent (matches cli-bak behaviour)
+    let parsedFlags;
+    try {
+        parsedFlags = (0, parse_common_flags_1.parseCommonFlags)(detachFilteredArgs);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, isError: true, state: emitState });
+        throw err;
+    }
+    const { thread, provider, model, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, rest } = parsedFlags;
+    const inheritedTrace = (0, inherited_trace_1.readInheritedTrace)();
+    let parsedAgentRef;
+    let message;
+    let finalMessage;
+    try {
+        ({ agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest));
+        // Resolve final prompt: argv | stdin pipe | --prompt-file (or combination)
+        finalMessage = await (0, resolve_prompt_1.resolvePrompt)(message, promptFile);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+        throw err;
+    }
     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 execute [@agent] <task> [options]');
         console.error('       crewx x [@agent] <task> [options]');
@@ -151,12 +170,21 @@ async function handleExecute(args) {
         console.error('  -f/--prompt-file <path>   Read task body from file');
         console.error('  --var key=value           Template variable (repeatable)');
         console.error('  --overdrive               Activate overdrive (boost) profile for this request');
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
         process.exit(1);
+        return;
     }
     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);
+    let crewx;
+    try {
+        crewx = await (0, crewx_cli_1.createCliCrewx)(configPath);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+        throw err;
+    }
     // file:// remote agent delegation is handled transparently inside Crewx.query/execute.
     if (verbose) {
         process.stderr.write(`📋 Task: ${finalMessage}\n`);
@@ -182,9 +210,10 @@ async function handleExecute(args) {
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         process.stderr.write(`Error: ${msg}\n`);
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
         process.exit(2);
+        return;
     }
-    const inheritedTrace = (0, inherited_trace_1.readInheritedTrace)();
     // A trace with a rootTraceId but no parentTaskId means the id was pre-assigned
     // to *this* task itself (the detach runner's parent injects only CREWX_TRACE_ID,
     // never CREWX_PARENT_TASK_ID — see execute.ts's runDetached), not inherited from
@@ -194,8 +223,9 @@ async function handleExecute(args) {
         ? (inheritedTrace.rootTraceId || undefined)
         : undefined;
     let exitCode = 0;
+    let result;
     try {
-        const result = await crewx.execute(agentRef, finalMessage, {
+        result = await crewx.execute(agentRef, finalMessage, {
             provider,
             model,
             effort: effort || undefined,
@@ -235,8 +265,29 @@ async function handleExecute(args) {
         exitCode = 1;
     }
     finally {
-        await crewx.close();
+        try {
+            await crewx.close();
+        }
+        catch (err) {
+            (0, emit_trailer_1.emitDelegationResult)({
+                command,
+                trace: inheritedTrace,
+                taskId: result?.meta.taskId,
+                agentId: result?.meta.agentId,
+                isError: true,
+                state: emitState,
+            });
+            throw err;
+        }
     }
+    (0, emit_trailer_1.emitDelegationResult)({
+        command,
+        trace: inheritedTrace,
+        taskId: result?.meta.taskId,
+        agentId: result?.meta.agentId,
+        isError: exitCode !== 0 || result?.ok === false,
+        state: emitState,
+    });
     if (exitCode !== 0)
         process.exit(exitCode);
 }

package/dist/commands/publish.js

@@ -44,10 +44,11 @@ exports.handlePublish = handlePublish;
  * tar.gz packing lives in @crewx/sdk/publish (planPublish / packTemplate).
  * Submit+upload (WI-SHR-20260806-013) lives in the same package
  * (uploadToMarketplace) for the same reason — see that module's header.
- * This command only parses argv, forwards options, reads auth.json
- * (read-only — see readAuthJson()'s own doc), and renders the result.
+ * This command only parses argv, forwards options, asks the SDK SessionManager
+ * for a valid account bearer when upload is requested, and renders the result.
  */
 const fs = __importStar(require("fs"));
+const account_1 = require("@crewx/sdk/account");
 const publish_1 = require("@crewx/sdk/publish");
 const parse_common_flags_1 = require("./parse-common-flags");
 function parsePublishFlags(args) {
@@ -138,10 +139,26 @@ Notes:
 /** CREWX_MARKETPLACE_URL — same env var name as the server's MARKETPLACE_DISABLED check, never a second name. */
 function requireMarketplaceUrl() {
     const url = process.env['CREWX_MARKETPLACE_URL'];
-    if (!url) {
+    if (!url?.trim()) {
         throw new Error('publish: [E_ENV_MISSING] CREWX_MARKETPLACE_URL is not set — this environment variable is required for upload');
     }
-    return url;
+    return url.trim();
+}
+function isMarketplaceUnauthorized(err) {
+    return err instanceof Error
+        && err.message.includes('publish: [E_AUTH_EXPIRED]')
+        && /HTTP 401\b/.test(err.message);
+}
+async function uploadWithSessionRefresh(sessionManager, options, accessToken) {
+    try {
+        return await (0, publish_1.uploadToMarketplace)({ ...options, accessToken });
+    }
+    catch (err) {
+        if (!isMarketplaceUnauthorized(err))
+            throw err;
+        const refreshedSession = await sessionManager.refresh();
+        return (0, publish_1.uploadToMarketplace)({ ...options, accessToken: refreshedSession.access_token });
+    }
 }
 async function handlePublish(args) {
     const flags = parsePublishFlags(args);
@@ -198,10 +215,12 @@ async function handlePublish(args) {
     // workspace — WI-SHR-20260806-013 AC-U5.
     let marketplaceUrl = '';
     let accessToken = '';
+    let sessionManager;
     if (flags.upload) {
         try {
             marketplaceUrl = requireMarketplaceUrl();
-            accessToken = (0, publish_1.readAuthJson)().access_token;
+            sessionManager = new account_1.SessionManager({ authClient: new account_1.AuthClient() });
+            accessToken = await sessionManager.getAccessToken();
         }
         catch (err) {
             if (err instanceof Error && !err.message.startsWith('publish: [')) {
@@ -224,12 +243,13 @@ async function handlePublish(args) {
     if (flags.upload) {
         process.stderr.write(`[publish] uploading ${packed.manifest.name}@${packed.manifest.version} to ${marketplaceUrl}...\n`);
         try {
-            uploadResult = await (0, publish_1.uploadToMarketplace)({
+            if (!sessionManager)
+                throw new Error('publish: [E_AUTH_EXPIRED] Account session is unavailable');
+            uploadResult = await uploadWithSessionRefresh(sessionManager, {
                 tgzPath: packed.tgzPath,
                 manifest: packed.manifest,
                 baseUrl: marketplaceUrl,
-                accessToken,
-            });
+            }, accessToken);
         }
         catch (err) {
             failWithError(err, flags.json);

package/dist/commands/query.d.ts

@@ -19,10 +19,11 @@
  *   e.g. cat brief.md | crewx q "@agent label"
  *   Stdin is ignored when running in an interactive TTY.
  */
+import { type DelegationEmitState } from './emit-trailer';
 /**
  * Handle `crewx query <agentRef> <message>` command.
  *
  * Default output: raw agent response only (stdout).
  * --verbose: debug info written to stderr, response to stdout.
  */
-export declare function handleQuery(args: string[]): Promise<void>;
+export declare function handleQuery(args: string[], command?: string, emitState?: DelegationEmitState): Promise<void>;

package/dist/commands/query.js

@@ -29,19 +29,37 @@ 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");
+const emit_trailer_1 = require("./emit-trailer");
 /**
  * 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, model, 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)
+async function handleQuery(args, command = 'query', emitState = (0, emit_trailer_1.createDelegationEmitState)()) {
+    let parsedFlags;
+    try {
+        parsedFlags = (0, parse_common_flags_1.parseCommonFlags)(args);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, isError: true, state: emitState });
+        throw err;
+    }
+    const { thread, provider, model, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, rest } = parsedFlags;
+    const inheritedTrace = (0, inherited_trace_1.readInheritedTrace)();
+    let parsedAgentRef;
+    let message;
+    let finalMessage;
+    try {
+        ({ agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest));
+        // Resolve final prompt: argv | stdin pipe | --prompt-file (or combination)
+        finalMessage = await (0, resolve_prompt_1.resolvePrompt)(message, promptFile);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+        throw err;
+    }
     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]');
@@ -70,12 +88,21 @@ async function handleQuery(args) {
         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');
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
         process.exit(1);
+        return;
     }
     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);
+    let crewx;
+    try {
+        crewx = await (0, crewx_cli_1.createCliCrewx)(configPath);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+        throw err;
+    }
     // file:// remote agent delegation is handled transparently inside Crewx.query/execute.
     if (verbose) {
         process.stderr.write(`📋 Task: ${finalMessage}\n`);
@@ -101,11 +128,14 @@ async function handleQuery(args) {
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         process.stderr.write(`Error: ${msg}\n`);
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
         process.exit(2);
+        return;
     }
     let exitCode = 0;
+    let result;
     try {
-        const result = await crewx.query(agentRef, finalMessage, {
+        result = await crewx.query(agentRef, finalMessage, {
             provider,
             model,
             effort: effort || undefined,
@@ -113,7 +143,7 @@ async function handleQuery(args) {
             threadId: thread,
             metadata: Object.keys(parsedMetadata).length > 0 ? parsedMetadata : undefined,
             vars: Object.keys(vars).length > 0 ? vars : undefined,
-            trace: (0, inherited_trace_1.readInheritedTrace)(),
+            trace: inheritedTrace,
         });
         if (!result.ok) {
             const errMsg = result.error?.message ?? 'Query failed';
@@ -144,8 +174,29 @@ async function handleQuery(args) {
         exitCode = 1;
     }
     finally {
-        await crewx.close();
+        try {
+            await crewx.close();
+        }
+        catch (err) {
+            (0, emit_trailer_1.emitDelegationResult)({
+                command,
+                trace: inheritedTrace,
+                taskId: result?.meta.taskId,
+                agentId: result?.meta.agentId,
+                isError: true,
+                state: emitState,
+            });
+            throw err;
+        }
     }
+    (0, emit_trailer_1.emitDelegationResult)({
+        command,
+        trace: inheritedTrace,
+        taskId: result?.meta.taskId,
+        agentId: result?.meta.agentId,
+        isError: exitCode !== 0 || result?.ok === false,
+        state: emitState,
+    });
     if (exitCode !== 0)
         process.exit(exitCode);
 }

package/dist/main.js

@@ -84,6 +84,7 @@ const db_1 = require("./commands/db");
 const parse_common_flags_1 = require("./commands/parse-common-flags");
 const registry_1 = require("./commands/registry");
 const version_1 = require("./utils/version");
+const emit_trailer_1 = require("./commands/emit-trailer");
 /**
  * Dev-only SSOT assertion: bin/cli-commands.js must be the exact union of
  * KNOWN_COMMANDS ∪ BUILTIN_COMMAND_NAMES ∪ NOT_YET_MIGRATED from registry.ts.
@@ -108,7 +109,7 @@ async function assertSsotParity() {
             (extra.length ? `  CLI_SUBCOMMANDS has, registry missing: ${extra.join(', ')}` : ''));
     }
 }
-async function main() {
+async function main(emitState) {
     if (process.env['NODE_ENV'] === 'development') {
         await assertSsotParity();
     }
@@ -128,11 +129,11 @@ async function main() {
         // P0-2: q/x aliases
         case 'q':
         case 'query':
-            await (0, query_1.handleQuery)(args.slice(1));
+            await (0, query_1.handleQuery)(args.slice(1), command, emitState);
             return;
         case 'x':
         case 'execute':
-            await (0, execute_1.handleExecute)(args.slice(1));
+            await (0, execute_1.handleExecute)(args.slice(1), command, emitState);
             return;
         case 'agent':
             await (0, agent_1.handleAgent)(args.slice(1));
@@ -194,7 +195,7 @@ async function main() {
         case 'shortcut':
             await (0, shortcut_1.handleShortcut)(args.slice(1));
             return;
-        // WI-20260803-004: crewx publish [dir] [--dry-run] [--version <semver>] [--json]
+        // crewx publish [dir] [--dry-run] [--version <semver>] [--json] [--upload]
         case 'publish':
             await (0, publish_1.handlePublish)(args.slice(1));
             return;
@@ -332,7 +333,7 @@ Publish:
     --dry-run                     Scan + build manifest only; do not write a .tgz
     --version <ver>               Override manifest version (semver)
     --json                        Print machine-readable JSON to stdout
-    (marketplace upload is not yet supported by this command)
+    --upload                      Submit + upload using the SDK account session
 
 Built-in Tools:
   memory <args>                  Memory tool
@@ -354,7 +355,9 @@ Global Options:
   --version, -v                  Show version
 `.trim());
 }
-main().catch((err) => {
+const emitState = (0, emit_trailer_1.createDelegationEmitState)();
+main(emitState).catch((err) => {
     console.error(err instanceof Error ? err.message : String(err));
+    (0, emit_trailer_1.emitDelegationResult)({ command: process.argv[2], isError: true, state: emitState });
     process.exit(err instanceof parse_common_flags_1.UnknownOptionError ? 2 : 1);
 });

package/dist/utils/sdk-compat.d.ts

@@ -1,11 +1,14 @@
+import type { CrewxExecutableResolution } from '@crewx/sdk';
 type PricingInitializer = () => Promise<unknown> | unknown;
 export interface SdkLike {
     resolveCrewxCli?: () => string;
+    resolveCrewxCliArgv?: () => CrewxExecutableResolution;
     resolveCrewxWorkspace?: () => string;
     initPricingRemote?: PricingInitializer;
 }
 export interface SdkCompat {
     resolveCrewxCli(): string;
+    resolveCrewxCliArgv(): CrewxExecutableResolution;
     resolveCrewxWorkspace(): string;
     initPricingRemote(): void;
 }

package/dist/utils/sdk-compat.js

@@ -36,6 +36,38 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkCompat = void 0;
 exports.createSdkCompat = createSdkCompat;
 const sdk = __importStar(require("@crewx/sdk"));
+function formatLegacyArgv(argv) {
+    const formatter = sdk.formatCrewxExecutableArgv;
+    if (typeof formatter === 'function')
+        return formatter(argv);
+    // Older SDKs may expose the argv resolver before exposing its formatter.
+    // Keep this compatibility-only fallback one-way and quote every token.
+    if (process.platform === 'win32') {
+        return argv
+            .map((value) => {
+            const escaped = value
+                .replace(/(\\*)"/g, '$1$1\\"')
+                .replace(/(\\+)$/g, '$1$1');
+            return `"${escaped}"`;
+        })
+            .join(' ');
+    }
+    return argv.map((value) => `'${value.replace(/'/g, `'\\''`)}'`).join(' ');
+}
+const FALLBACK_CREWX_CLI_DISPLAY = 'crewx';
+function missingCliResolver() {
+    return {
+        ok: false,
+        reason: 'The installed SDK does not expose the argv-based CrewX CLI resolver.',
+        attempts: [
+            { stage: 'env', reason: 'argv resolver capability is unavailable' },
+            { stage: 'self', reason: 'argv resolver capability is unavailable' },
+            { stage: 'workspace', reason: 'argv resolver capability is unavailable' },
+            { stage: 'module', reason: 'argv resolver capability is unavailable' },
+            { stage: 'path', reason: 'argv resolver capability is unavailable' },
+        ],
+    };
+}
 /**
  * Create the CLI bootstrap capability accessor for the installed SDK.
  *
@@ -46,10 +78,26 @@ const sdk = __importStar(require("@crewx/sdk"));
 function createSdkCompat(sdkLike = sdk) {
     return {
         resolveCrewxCli: () => {
+            const configured = process.env.CREWX_CLI;
+            if (configured?.trim())
+                return configured;
+            if (typeof sdkLike.resolveCrewxCliArgv === 'function') {
+                const resolution = sdkLike.resolveCrewxCliArgv();
+                if (resolution.ok)
+                    return formatLegacyArgv(resolution.argv);
+            }
             if (typeof sdkLike.resolveCrewxCli === 'function') {
-                return sdkLike.resolveCrewxCli();
+                const value = sdkLike.resolveCrewxCli();
+                if (value.trim())
+                    return value;
+            }
+            return FALLBACK_CREWX_CLI_DISPLAY;
+        },
+        resolveCrewxCliArgv: () => {
+            if (typeof sdkLike.resolveCrewxCliArgv === 'function') {
+                return sdkLike.resolveCrewxCliArgv();
             }
-            return process.env.CREWX_CLI || 'npx crewx';
+            return missingCliResolver();
         },
         resolveCrewxWorkspace: () => {
             if (typeof sdkLike.resolveCrewxWorkspace === 'function') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/cli",
-  "version": "0.9.0-rc.82",
+  "version": "0.9.0-rc.83",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -25,18 +25,18 @@
     "better-sqlite3": "*",
     "dotenv": "17.2.3",
     "isomorphic-git": "1.37.1",
-    "@crewx/sdk": "0.9.0-rc.82",
-    "@crewx/memory": "0.1.23-rc.99",
-    "@crewx/search": "0.1.10-rc.78",
-    "@crewx/doc": "0.1.9-rc.75",
-    "@crewx/wbs": "0.1.10-rc.108",
-    "@crewx/cron": "0.1.10-rc.117",
+    "@crewx/sdk": "0.9.0-rc.83",
+    "@crewx/search": "0.1.10-rc.79",
+    "@crewx/doc": "0.1.9-rc.76",
+    "@crewx/wbs": "0.1.10-rc.109",
+    "@crewx/workflow": "0.3.22-rc.129",
+    "@crewx/cron": "0.1.10-rc.118",
+    "@crewx/chromex": "0.1.0-rc.116",
+    "@crewx/notify": "0.1.0-rc.54",
+    "@crewx/wi": "0.1.10-rc.103",
+    "@crewx/memory": "0.1.23-rc.100",
     "@crewx/skill": "0.1.20",
-    "@crewx/workflow": "0.3.22-rc.128",
-    "@crewx/shared": "0.0.6",
-    "@crewx/wi": "0.1.10-rc.102",
-    "@crewx/notify": "0.1.0-rc.53",
-    "@crewx/chromex": "0.1.0-rc.115"
+    "@crewx/shared": "0.0.6"
   },
   "devDependencies": {
     "@types/better-sqlite3": "*",