@crewx/cli 0.9.0-rc.18 → 0.9.0-rc.180

package/dist/commands/doctor.js

@@ -1,196 +1,4 @@
-"use strict";
-/**
- * crewx doctor handler.
- * Performs system diagnosis: checks config, CLI tools, and environment.
- *
- * Usage:
- *   crewx doctor                  Run full diagnosis
- *   crewx doctor --config <path>  Use specific config file
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleDoctor = handleDoctor;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const child_process_1 = require("child_process");
-const sdk_1 = require("@crewx/sdk");
-const parse_common_flags_1 = require("./parse-common-flags");
-function statusIcon(status) {
-    switch (status) {
-        case 'success': return '✅';
-        case 'warning': return '⚠️ ';
-        case 'error': return '❌';
-    }
-}
-/**
- * Check if a CLI command is available on PATH.
- */
-function isCommandAvailable(cmd) {
-    try {
-        (0, child_process_1.execSync)(`which ${cmd}`, { stdio: 'ignore' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check crewx.yaml configuration file.
- */
-function checkConfig(configPath) {
-    if (!(0, fs_1.existsSync)(configPath)) {
-        return {
-            name: 'Configuration File',
-            status: 'error',
-            message: `Configuration file not found: ${configPath}`,
-            details: "Run 'crewx init' to create a default configuration file.",
-        };
-    }
-    try {
-        const raw = (0, sdk_1.loadYamlFile)(configPath);
-        const config = raw;
-        if (!config?.agents || !Array.isArray(config.agents)) {
-            return {
-                name: 'Configuration File',
-                status: 'error',
-                message: 'Invalid configuration format',
-                details: 'Configuration file exists but has invalid structure.',
-            };
-        }
-        if (config.agents.length === 0) {
-            return {
-                name: 'Configuration File',
-                status: 'warning',
-                message: 'No agents configured',
-                details: 'Add agent definitions to your crewx.yaml.',
-            };
-        }
-        return {
-            name: 'Configuration File',
-            status: 'success',
-            message: `Found ${config.agents.length} agent(s) in ${configPath}`,
-        };
-    }
-    catch (err) {
-        return {
-            name: 'Configuration File',
-            status: 'error',
-            message: 'Failed to parse configuration',
-            details: `Error: ${err instanceof Error ? err.message : String(err)}`,
-        };
-    }
-}
-/**
- * Check .crewx/logs directory.
- */
-function checkLogsDir() {
-    const logsDir = (0, path_1.join)(process.cwd(), '.crewx', 'logs');
-    if (!(0, fs_1.existsSync)(logsDir)) {
-        return {
-            name: 'Logs Directory',
-            status: 'warning',
-            message: 'Logs directory not found',
-            details: `Will be created automatically at ${logsDir}`,
-        };
-    }
-    return {
-        name: 'Logs Directory',
-        status: 'success',
-        message: `Logs directory exists: ${logsDir}`,
-    };
-}
-/**
- * Check CLI provider availability.
- * Providers are checked in PROVIDER_ORDER: codex → claude → opencode → antigravity → copilot.
- */
-function checkCliProviders() {
-    // Map each provider (in PROVIDER_ORDER) to its CLI command and install hint.
-    const providerInfo = {
-        codex: { cmd: 'codex', install: 'npm install -g @openai/codex' },
-        claude: { cmd: 'claude', install: 'npm install -g @anthropic-ai/claude-code' },
-        opencode: { cmd: 'opencode', install: 'npm install -g opencode' },
-        antigravity: { cmd: 'antigravity', install: 'npm install -g antigravity' },
-        copilot: { cmd: 'gh', install: 'brew install gh  # or visit cli.github.com' },
-    };
-    return sdk_1.PROVIDER_ORDER.map(provider => {
-        const info = providerInfo[provider];
-        const displayName = provider === 'copilot' ? 'copilot (gh)' : provider;
-        const available = isCommandAvailable(info.cmd);
-        return {
-            name: `${displayName.toUpperCase()} CLI`,
-            status: available ? 'success' : 'warning',
-            message: available ? 'Installed and available' : 'Not installed or not on PATH',
-            details: available ? undefined : `Install: ${info.install}`,
-        };
-    });
-}
-/**
- * Check CREWX_CLI env var.
- */
-function checkEnvVars() {
-    const crewxCli = process.env.CREWX_CLI;
-    if (crewxCli) {
-        return {
-            name: 'CREWX_CLI',
-            status: 'success',
-            message: `Set to: ${crewxCli}`,
-        };
-    }
-    return {
-        name: 'CREWX_CLI',
-        status: 'warning',
-        message: 'Not set — defaulting to "npx crewx"',
-        details: 'This is auto-set at CLI startup; no action needed.',
-    };
-}
-/**
- * Assess overall health.
- */
-function assessHealth(diagnostics) {
-    const errors = diagnostics.filter(d => d.status === 'error').length;
-    const warnings = diagnostics.filter(d => d.status === 'warning').length;
-    const successes = diagnostics.filter(d => d.status === 'success').length;
-    if (errors > 0) {
-        return { status: 'error', message: `System has ${errors} error(s) that need attention` };
-    }
-    if (warnings > 0) {
-        return { status: 'warning', message: `System is functional with ${warnings} warning(s)` };
-    }
-    return { status: 'success', message: `System is healthy — all ${successes} checks passed` };
-}
-/**
- * Handle `crewx doctor` command.
- */
-async function handleDoctor(args) {
-    const { config } = (0, parse_common_flags_1.parseCommonFlags)(args);
-    const configPath = config ?? process.env.CREWX_CONFIG ?? (0, path_1.join)(process.cwd(), 'crewx.yaml');
-    console.log('🩺 Starting CrewX system diagnosis...\n');
-    const diagnostics = [
-        checkConfig(configPath),
-        checkLogsDir(),
-        checkEnvVars(),
-        ...checkCliProviders(),
-    ];
-    // Print diagnostics
-    diagnostics.forEach(d => {
-        const icon = statusIcon(d.status);
-        console.log(`${icon} ${d.name}: ${d.message}`);
-        if (d.details) {
-            console.log(`   ${d.details}`);
-        }
-    });
-    const health = assessHealth(diagnostics);
-    const healthIcon = statusIcon(health.status);
-    console.log('');
-    console.log('─'.repeat(60));
-    console.log(`${healthIcon} Overall: ${health.message}`);
-    if (health.status === 'success') {
-        console.log('\nNext steps:');
-        console.log('  crewx query "@claude hello"');
-    }
-    else {
-        console.log('\nAddress the issues above, then run `crewx doctor` again.');
-    }
-    if (health.status === 'error') {
-        process.exit(1);
-    }
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.CLI_PROVIDER_INFO=void 0;exports.formatBytes=$;exports.inspectNpxCache=y;exports.inspectHookCommands=R;exports.inspectCrewxExecutable=E;exports.inspectCrewxShims=x;exports.checkCliProviders=S;exports.handleDoctor=ee;const w=require("node:child_process");const u=require("node:fs");const F=require("node:os");const c=require("node:path");const d=require("@crewx/sdk");const N=require("./parse-common-flags");const I=require("./hook/command-marker");exports.CLI_PROVIDER_INFO={codex:{cmd:"codex",install:"npm install -g @openai/codex"},claude:{cmd:"claude",install:"npm install -g @anthropic-ai/claude-code"},grok:{cmd:"grok",install:"curl -fsSL https://x.ai/cli/install.sh | bash"},opencode:{cmd:"opencode",install:"npm install -g opencode"},antigravity:{cmd:"antigravity",install:"npm install -g antigravity"},copilot:{cmd:"gh",install:"brew install gh  # or visit cli.github.com"}};function v(e){switch(e){case"success":return"\u2705";case"warning":return"\u26A0\uFE0F ";case"error":return"\u274C"}}function P(e){try{(0,w.execSync)(`which ${e}`,{stdio:"ignore"});return true}catch{return false}}function $(e){if(!Number.isFinite(e)||e<=0)return"0 B";const t=["B","KB","MB","GB","TB"];let n=e;let s=0;while(n>=1024&&s<t.length-1){n/=1024;s+=1}const o=s===0||n>=10?Math.round(n):n.toFixed(1);return`${o} ${t[s]}`}function p(e){try{const t=(0,u.lstatSync)(e);if(!t.isDirectory())return t.size;return(0,u.readdirSync)(e,{withFileTypes:true}).reduce((n,s)=>{return n+p((0,c.join)(e,s.name))},0)}catch{return 0}}function b(e){try{return(0,u.readdirSync)(e,{withFileTypes:true}).filter(t=>t.isDirectory()).map(t=>(0,c.join)(e,t.name)).sort()}catch{return[]}}function _(e){try{const t=JSON.parse((0,u.readFileSync)(e,"utf8"));if(typeof t!=="object"||t===null||Array.isArray(t))return void 0;return t}catch{return void 0}}function O(e=process.env){const t=e.NPM_CONFIG_CACHE??e.npm_config_cache;const n=t?.trim()||(0,c.join)((0,F.homedir)(),".npm");const s=(0,c.resolve)(n);return(0,c.basename)(s)==="_npx"?s:(0,c.join)(s,"_npx")}const L=["dependencies","devDependencies","optionalDependencies","peerDependencies"];function T(e){const t=_((0,c.join)(e,"package.json"));if(!t)return[];const n=[];for(const s of L){const o=t[s];if(typeof o!=="object"||o===null||Array.isArray(o))continue;for(const[i,r]of Object.entries(o)){if(typeof r!=="string"||!r.startsWith("file:"))continue;const a=(0,c.resolve)(e,r.slice("file:".length));if(!(0,u.existsSync)(a)){n.push(`${s}.${i}=${r} (missing ${a})`)}}}return n}function k(e,t,n){const s=e.get(t);if(s){s.details.push(...n);return s}const o={directory:t,sizeBytes:p(t),details:[...n]};e.set(t,o);return o}function y(e=O()){const t=(0,c.resolve)(e);const n=[];const s=[];const o=new Map;for(const i of b(t)){const r=(0,c.join)(i,"package-lock.json");try{const l=(0,u.statSync)(r);if(l.isFile()&&l.size===0){const h=k(o,i,[`0-byte lockfile: ${r}`]);n.push(h)}}catch{}const a=T(i);if(a.length>0){const l=k(o,i,a);s.push(l)}}return{cacheRoot:t,zeroByteLockfileDirectories:n,staleFileCacheDirectories:s,cleanableDirectories:[...o.values()]}}function C(e){if(typeof e!=="object"||e===null||Array.isArray(e))return void 0;return e}function X(e){const t=C(e.hooks)??e;const n=t.PreToolUse;if(!Array.isArray(n))return[];const s=[];for(const o of n){const i=C(o);const r=i?.hooks;if(!Array.isArray(r))continue;for(const a of r){const l=C(a)?.command;if(typeof l==="string"&&I.CREWX_HOOK_COMMAND_RE.test(l)){s.push(l)}}}return s}function B(e){const t=e.trim();if(!t)return"";if(t.startsWith("'")||t.startsWith('"')){const n=t[0];const s=t.indexOf(n,1);return s===-1?t.slice(1):t.slice(1,s)}return t.split(/\s+/,1)[0]}function H(e){return(0,c.isAbsolute)(e)||/^[A-Za-z]:[\\/]/.test(e)||e.startsWith("\\\\")}function q(e){const t=B(e);if(/^(?:npx|pnpm|yarn)$/i.test(t))return"launcher";if(!H(t))return"non-absolute";return void 0}function R(e){const t=[{provider:"claude",settingsPath:(0,c.join)((0,c.resolve)(e),".claude","settings.json")},{provider:"codex",settingsPath:(0,c.join)((0,c.resolve)(e),".codex","hooks.json")}];const n=[];const s=[];for(const o of t){if(!(0,u.existsSync)(o.settingsPath))continue;n.push(o.settingsPath);const i=_(o.settingsPath);if(!i)continue;for(const r of X(i)){const a=q(r);if(a){s.push({provider:o.provider,settingsPath:o.settingsPath,command:r,reason:a})}}}return{inspectedFiles:n,issues:s}}function W(e,t="global_first"){try{const n=(0,d.loadYamlFile)(e);const s=n.settings?.bin_resolution;return s==="local_first"||s==="global_first"?s:t}catch{return t}}function z(e,t,n){if(n!=="win32")return[];try{(0,d.primeWindowsConsoleCodePage)();const s=(0,w.execFileSync)("where.exe",["crewx"],{cwd:e,env:t,encoding:null,stdio:["ignore","pipe","ignore"]});return(0,d.decodeConsoleBuffer)(s,{platform:n}).split(/\r?\n/).map(o=>o.trim()).filter(o=>o.length>0)}catch{return[]}}function E(e={}){const t=e.platform??process.platform;const n=(0,c.resolve)(e.cwd??process.cwd());const s=e.env??process.env;const o=e.configPath??(0,c.join)(n,"crewx.yaml");const i=e.resolution??(0,d.resolveCrewxExecutable)({env:s,cwd:n,platform:t});const r=e.pathCandidates?[...e.pathCandidates]:z(n,s,t);const a=i.ok?Object.keys(i.requiredEnv??{}).filter(l=>l==="ELECTRON_RUN_AS_NODE"):[];return{platform:t,pathCandidates:r,...i.ok?{stage:i.stage,argv:[...i.argv],adoptedPath:i.argv[0]}:{resolutionError:i.reason},electron:a.includes("ELECTRON_RUN_AS_NODE"),requiredEnvKeys:a,binResolution:e.binResolution??W(o)}}function M(e){const t=[`platform: ${e.platform}`,`stage: ${e.stage??"(unresolved)"}`,`argv: ${e.argv?(0,d.formatCrewxExecutableArgv)(e.argv):"(unresolved)"}`,`adopted path: ${e.adoptedPath??"(none)"}`,`Electron runtime: ${e.electron?"yes":"no"}`,`required environment keys: ${e.requiredEnvKeys.length>0?e.requiredEnvKeys.join(", "):"(none)"}`,`bin_resolution setting: ${e.binResolution}`,...e.platform==="win32"?[`where.exe crewx candidates: ${e.pathCandidates.length>0?e.pathCandidates.join(", "):"(none)"}`]:[]];if(e.resolutionError){return{name:"CrewX Executable",status:"warning",message:"Could not resolve the CrewX executable",details:`${t.join("\n")}
+Resolution failed; no environment values were printed.`}}return{name:"CrewX Executable",status:"success",message:"SDK child executable contract is available",details:t.join("\n")}}function x(e=(0,d.getCrewxHome)(),t=(()=>{const n=(0,d.resolveCrewxExecutable)();return n.ok?(0,d.crewxCliShimFingerprint)(n):void 0})()){const n=(0,c.join)((0,c.resolve)(e),"bin-shim");const s=[];if(t){for(const o of b(n)){const i=o.slice(n.length+1);if(i===t)continue;s.push({fingerprint:i,directory:o,sizeBytes:p(o),details:[`not current fingerprint (${t})`]})}}return{shimRoot:n,currentFingerprint:t,staleDirectories:s}}function K(e){const t=e.zeroByteLockfileDirectories.length;const n=e.staleFileCacheDirectories.length;const s=e.cleanableDirectories.length;if(t===0&&n===0){return{name:"npx Cache",status:"success",message:`No stale entries found in ${e.cacheRoot}`}}const o=[];if(t>0){o.push(`0-byte package-lock.json: ${e.zeroByteLockfileDirectories.map(i=>i.directory).join(", ")}`)}if(n>0){o.push(`stale file: cache: ${e.staleFileCacheDirectories.map(i=>i.directory).join(", ")}`)}o.push("Run `crewx doctor --clean-npx-cache` to remove these cache directories explicitly.");return{name:"npx Cache",status:"warning",message:`Found ${s} problematic npx cache director${s===1?"y":"ies"}`,details:o.join("\n")}}function U(e){if(e.issues.length===0){return{name:"CrewX Hooks",status:"success",message:e.inspectedFiles.length>0?"Installed CrewX hook commands use absolute entrypoints":"No installed CrewX hooks found"}}const t=e.issues.map(n=>`${n.settingsPath}: ${n.command} (${n.reason})`).join("\n");return{name:"CrewX Hooks",status:"warning",message:`Found ${e.issues.length} hook command(s) that need an absolute CrewX entrypoint`,details:`${t}
+Run \`crewx hook install\` to refresh the hook after reviewing the change.`}}function V(e){if(!e.currentFingerprint){return{name:"CrewX PATH Shims",status:"warning",message:"Could not resolve the current CrewX executable; skipped orphan shim cleanup",details:`Shim root: ${e.shimRoot}`}}if(e.staleDirectories.length===0){return{name:"CrewX PATH Shims",status:"success",message:"No orphaned CrewX PATH shims found"}}return{name:"CrewX PATH Shims",status:"warning",message:`Found ${e.staleDirectories.length} orphaned CrewX PATH shim director${e.staleDirectories.length===1?"y":"ies"}`,details:`${e.staleDirectories.map(t=>t.directory).join(", ")}
+Run \`crewx doctor --clean-npx-cache\` to remove stale shims explicitly.`}}function D(e,t){const n=(0,c.resolve)(t);let s=0;const o=[];for(const i of e){const r=(0,c.resolve)(i.directory);if((0,c.dirname)(r)!==n){o.push(`${r} (unexpected parent)`);continue}try{(0,u.rmSync)(r,{recursive:true,force:true});if(!(0,u.existsSync)(r))s+=1;else o.push(r)}catch{o.push(r)}}return{removed:s,failed:o}}function G(e,t){const n=e.cleanableDirectories;const s=t.staleDirectories;const o=[...n,...s];const i=o.reduce((h,g)=>h+g.sizeBytes,0);console.log(`\u26A0\uFE0F  --clean-npx-cache: before cleanup, ${n.length} npx cache director${n.length===1?"y":"ies"} and ${s.length} orphan shim director${s.length===1?"y":"ies"} (${$(i)}).`);const r=D(n,e.cacheRoot);const a=D(s,t.shimRoot);const l=[...r.failed,...a.failed];console.log(`   Removed ${r.removed+a.removed} director${r.removed+a.removed===1?"y":"ies"}.`);if(l.length>0){console.log(`   Could not remove: ${l.join(", ")}`)}}function J(e){if(!(0,u.existsSync)(e)){return{name:"Configuration File",status:"error",message:`Configuration file not found: ${e}`,details:"Run 'crewx init' to create a default configuration file."}}try{const t=(0,d.loadYamlFile)(e);const n=t;if(!n?.agents||!Array.isArray(n.agents)){return{name:"Configuration File",status:"error",message:"Invalid configuration format",details:"Configuration file exists but has invalid structure."}}if(n.agents.length===0){return{name:"Configuration File",status:"warning",message:"No agents configured",details:"Add agent definitions to your crewx.yaml."}}return{name:"Configuration File",status:"success",message:`Found ${n.agents.length} agent(s) in ${e}`}}catch(t){return{name:"Configuration File",status:"error",message:"Failed to parse configuration",details:`Error: ${t instanceof Error?t.message:String(t)}`}}}function Y(){const e=(0,c.join)(process.cwd(),".crewx","logs");if(!(0,u.existsSync)(e)){return{name:"Logs Directory",status:"warning",message:"Logs directory not found",details:`Will be created automatically at ${e}`}}return{name:"Logs Directory",status:"success",message:`Logs directory exists: ${e}`}}function S(){return d.PROVIDER_ORDER.map(e=>{const t=exports.CLI_PROVIDER_INFO[e];if(!t){return{name:`${e.toUpperCase()} CLI`,status:"error",message:"Diagnostic metadata is missing",details:`Add ${e} to CLI_PROVIDER_INFO.`}}const n=e==="copilot"?"copilot (gh)":e;const s=P(t.cmd);return{name:`${n.toUpperCase()} CLI`,status:s?"success":"warning",message:s?"Installed and available":"Not installed or not on PATH",details:s?void 0:`Install: ${t.install}`}})}function Z(){const e=process.env.CREWX_CLI;if(e){return{name:"CREWX_CLI",status:"success",message:`Set to: ${e}`}}return{name:"CREWX_CLI",status:"warning",message:'Not set \u2014 defaulting to "crewx"',details:"This is auto-set at CLI startup; no action needed."}}function Q(e){const t=e.filter(o=>o.status==="error").length;const n=e.filter(o=>o.status==="warning").length;const s=e.filter(o=>o.status==="success").length;if(t>0){return{status:"error",message:`System has ${t} error(s) that need attention`}}if(n>0){return{status:"warning",message:`System is functional with ${n} warning(s)`}}return{status:"success",message:`System is healthy \u2014 all ${s} checks passed`}}async function ee(e){const t=e.includes("--clean-npx-cache");const n=e.filter(f=>f!=="--clean-npx-cache");const{config:s}=(0,N.parseCommonFlags)(n);const o=s??process.env.CREWX_CONFIG??(0,c.join)(process.cwd(),"crewx.yaml");console.log("\u{1FA7A} Starting CrewX system diagnosis...\n");let i=y();let r=x();const a=(0,c.dirname)((0,c.resolve)(o));const l=R(a);const h=E({configPath:o,cwd:process.cwd()});if(t){G(i,r);i=y();r=x()}const g=[J(o),Y(),Z(),M(h),...S(),K(i),U(l),V(r)];g.forEach(f=>{const A=v(f.status);console.log(`${A} ${f.name}: ${f.message}`);if(f.details){console.log(`   ${f.details}`)}});const m=Q(g);const j=v(m.status);console.log("");console.log("\u2500".repeat(60));console.log(`${j} Overall: ${m.message}`);if(m.status==="success"){console.log("\nNext steps:");console.log('  crewx q --to crewx "hello"')}else{console.log("\nAddress the issues above, then run `crewx doctor` again.")}if(m.status==="error"){process.exit(1)}}

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,2 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createDelegationEmitState=m;exports.shouldEmitDelegationResult=n;exports.emitDelegationResult=f;const l=require("@crewx/sdk");const c=require("../utils/inherited-trace");const d=new Set(["q","query","x","execute"]);function m(){return{emitted:false}}function n(e,t=(0,c.readInheritedTrace)()){return d.has(e??"")&&Boolean(t?.parentTaskId)}function f(e){const{command:t,trace:i,state:r,taskId:a,agentId:o,isError:s}=e;if(r?.emitted||!n(t,i))return false;const u=(0,l.formatDelegationResult)({taskId:a,agentId:o,isError:s});if(r)r.emitted=true;process.stdout.write(`${u}
+`);return true}

package/dist/commands/execute.d.ts

@@ -3,25 +3,29 @@
  * Parses args, loads config via Crewx SDK, and executes the task.
  *
  * Flags:
+ *   --to <agent>             Explicit recipient (the positional @agent form is shorthand)
  *   --thread <name>          Conversation thread name
  *   --provider <cli/xxx>     Provider override
+ *   --model <name>           Model override (e.g. claude-sonnet-5)
  *   --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 task body from file (bypasses cmd.exe argv truncation)
+ *   -f/--prompt-file <path>  Read task body from file
+ *   --detach/--async         Persist a receipt and launch a detached runner
+ *   --wait                   Force synchronous execution
  *
  * Stdin support:
  *   Pipe or redirect content into crewx x to supply the task body via stdin.
- *   e.g. cat task.md | crewx x "@agent label"
  *   Stdin is ignored when running in an interactive TTY.
  */
+import { type DelegationEmitState } from './emit-trailer';
+export { runDetachedMiddle } from './detached';
 /**
  * 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

@@ -1,146 +1,15 @@
-"use strict";
-/**
- * crewx execute handler.
- * Parses args, loads config via Crewx SDK, and executes the task.
- *
- * 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 task body from file (bypasses cmd.exe argv truncation)
- *
- * Stdin support:
- *   Pipe or redirect content into crewx x to supply the task body via stdin.
- *   e.g. cat task.md | crewx x "@agent label"
- *   Stdin is ignored when running in an interactive TTY.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleExecute = handleExecute;
-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 execute <agentRef> <message>` command.
- *
- * Default output: raw agent response only (stdout).
- * --verbose: debug info written to stderr, response to stdout.
- */
-async function handleExecute(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 execute [@agent] <task> [options]');
-        console.error('       crewx x [@agent] <task> [options]');
-        console.error('');
-        console.error('  @agent is optional. Defaults to @crewx when omitted.');
-        console.error('  Task body can also be supplied via stdin pipe or --prompt-file.');
-        console.error('');
-        console.error('Examples:');
-        console.error('  crewx x "@agent do something"');
-        console.error('  cat task.md | crewx x "@agent label"');
-        console.error('  crewx x "@agent label" --prompt-file=task.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 task 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.execute(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 ?? 'Execute 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✅ Execute 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.runDetachedMiddle=void 0;exports.handleExecute=Y;const F=require("@crewx/sdk");const V=require("@crewx/sdk/repository");const z=require("./parse-agent-message");const j=require("./parse-common-flags");const K=require("./resolve-recipient");const L=require("./resolve-prompt");const Q=require("../bootstrap/crewx-cli");const v=require("../utils/inherited-trace");const D=require("./write-output");const i=require("./detached");const s=require("./emit-trailer");var S=require("./detached");Object.defineProperty(exports,"runDetachedMiddle",{enumerable:true,get:function(){return S.runDetachedMiddle}});async function Y(u,r="execute",a=(0,s.createDelegationEmitState)()){const I=(0,i.readDetachedMiddleHop)(u);if(I){await(0,i.runDetachedMiddle)(r,I);return}const p=(0,i.extractReceiptFlags)(u);const m=(0,i.resolveReceiptMode)({detach:p.detach,wait:p.wait,detachedRunner:(0,v.isDetachedRunner)(),agentContext:Boolean(process.env["CREWX_AGENT_ID"])});if(m.receipt){await(0,i.runDetached)(r,p.rest,m.reason,u);return}let b;try{b=(0,j.parseCommonFlags)(p.rest)}catch(e){(0,s.emitDelegationResult)({command:r,isError:true,state:a});throw e}const{thread:x,provider:k,model:E,metadata:N,verbose:f,config:H,outputFormat:A,effort:R,promptFile:B,overdrive:M,vars:T,out:_,rest:G,to:W}=b;const n=(0,v.readInheritedTrace)();let $;let q;let c;try{({agentRef:$,message:q}=(0,z.parseAgentMessage)(G));c=await(0,L.resolvePrompt)(q,B)}catch(e){(0,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});throw e}let g;try{({agentRef:g}=(0,K.resolveRecipient)({positionalRef:$,toFlag:W,agentContext:Boolean(process.env["CREWX_AGENT_ID"]),bodyForHint:c,command:r,invocationArgs:u}))}catch(e){const t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: ${t}
+`);(0,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});process.exit(2);return}if(!c){console.error("Usage: crewx execute --to <agent> <task> [options]");console.error("       crewx x --to <agent> <task> [options]");console.error('  Human-terminal shorthand: crewx x "@agent <task>"');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("  Task body can also be supplied via stdin pipe or --prompt-file.");console.error("");console.error("Examples:");console.error('  crewx x --to agent "do something"');console.error("  crewx x --to agent -f task.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,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});process.exit(1);return}const X=H??process.env.CREWX_CONFIG??"crewx.yaml";(0,F.setAuditVerbose)(f);let y;try{y=await(0,Q.createCliCrewx)(X)}catch(e){(0,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});throw e}if(f){process.stderr.write(`mode=sync reason=${m.reason}
+`);process.stderr.write(`\u{1F4CB} Task: ${c}
+`);process.stderr.write(`\u{1F916} Agent: ${g}
+`);if(x)process.stderr.write(`\u{1F517} Thread: ${x}
+`);if(k)process.stderr.write(`\u{1F50C} Provider: ${k}
+`);if(E)process.stderr.write(`\u{1F9E0} Model: ${E}
+`);if(A)process.stderr.write(`\u{1F4C4} Output-format: ${A}
+`);if(R)process.stderr.write(`\u26A1 Effort: ${R}
+`);if(M)process.stderr.write("\u{1F680} Overdrive: ON\n");process.stderr.write("\u2500".repeat(60)+"\n")}let h={};try{h=(0,j.parseMetadata)(N)}catch(e){const t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: ${t}
+`);(0,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});process.exit(2);return}const J=(0,i.resolveCliTaskActor)(h);const U=(0,v.isDetachedRunner)();const C=(0,v.readRunnerAssignment)();let w;let O;let P;if(C!==void 0){const e=new V.TaskRepository;const t=(0,i.adoptAssignedTask)(e,C,U);if(t.kind==="failed"){(0,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});process.exit(1);return}if(t.kind==="adopted"){w=t.taskId;O=(0,i.readAssignedTaskActor)(e,t.taskId);P=(0,i.readAssignedTaskProviderAccountId)(e,t.taskId)}}let d;if(w===void 0){d=(0,F.admitDurableTask)(`direct-cli:${r}`);if(!d.ok){(0,i.reportAdmissionBlocked)(d);(0,s.emitDelegationResult)({command:r,trace:n,isError:true,state:a});process.exit(1);return}}let l=0;let o;try{try{o=await y.execute(g,c,{provider:k,model:E,effort:R||void 0,overdrive:M||void 0,threadId:x,taskId:w,actor:w===void 0?J:O,metadata:Object.keys(h).length>0?h:void 0,vars:Object.keys(T).length>0?T:void 0,trace:n,providerAccountId:P});if(!o.ok){const e=o.error?.message??"Execute failed";console.error(e);(0,D.appendError)(_,e);l=1}else{if(f){process.stderr.write(`
+\u{1F4CA} Results from ${g}:
+`);process.stderr.write("\u2550".repeat(60)+"\n");process.stderr.write("\u{1F7E2} Status: Success\n");process.stderr.write(`\u{1F916} Provider: ${o.meta.provider}
+`);process.stderr.write(`\u23F1\uFE0F  Duration: ${o.meta.durationMs}ms
+`);process.stderr.write("\n\u{1F4C4} Response:\n");process.stderr.write("\u2500".repeat(40)+"\n")}(0,D.writeResult)(_,o.data);if(f)process.stderr.write("\n\u2705 Execute completed successfully\n")}}catch(e){const t=e instanceof Error?e.message:String(e);console.error(`Error: ${t}`);(0,D.appendError)(_,`Error: ${t}`);l=1}finally{try{await y.close()}catch(e){(0,s.emitDelegationResult)({command:r,trace:n,taskId:o?.meta.taskId,agentId:o?.meta.agentId,isError:true,state:a});throw e}}}finally{if(d?.ok)d.release()}(0,s.emitDelegationResult)({command:r,trace:n,taskId:o?.meta.taskId,agentId:o?.meta.agentId,isError:l!==0||o?.ok===false,state:a});if(l!==0)process.exit(l)}

package/dist/commands/hook/command-marker.d.ts

@@ -0,0 +1,2 @@
+/** Match only commands that invoke CrewX's hook-dispatch subcommand. */
+export declare const CREWX_HOOK_COMMAND_RE: RegExp;

package/dist/commands/hook/command-marker.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.CREWX_HOOK_COMMAND_RE=void 0;exports.CREWX_HOOK_COMMAND_RE=/crewx(?:\.js|\.cmd|\.exe)?['"]?\s+hook-dispatch\b/i;

package/dist/commands/hook/install.d.ts

@@ -10,7 +10,6 @@
  *   - Never traverses parent directories — project root determined by crewx.yaml
  */
 import { type HookProvider } from './paths';
-export declare const CREWX_HOOK_COMMAND_MARKER = "crewx hook-dispatch";
 export declare function resolveCrewxBinary(): string;
 export interface HookInstallOpts {
     projectRoot: string;