@crewx/cli 0.8.1-rc.1 → 0.8.1-rc.3

package/dist/commands/execute.d.ts

@@ -11,6 +11,12 @@
  *   --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.
  */
 /**
  * Handle `crewx execute <agentRef> <message>` command.

package/dist/commands/execute.js

@@ -12,12 +12,19 @@
  *   --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");
 /**
  * Handle `crewx execute <agentRef> <message>` command.
@@ -26,27 +33,36 @@ const crewx_cli_1 = require("../bootstrap/crewx-cli");
  * --verbose: debug info written to stderr, response to stdout.
  */
 async function handleExecute(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
+    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, 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';
-    if (!message) {
+    // 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('  --effort <level>       Model effort (high|medium|low)');
+        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('  --effort <level>          Model effort (high|medium|low)');
+        console.error('  -f/--prompt-file <path>   Read task body from file');
         process.exit(1);
     }
     const configPath = config ?? process.env.CREWX_CONFIG ?? 'crewx.yaml';
@@ -55,7 +71,7 @@ async function handleExecute(args) {
     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: ${message}\n`);
+        process.stderr.write(`📋 Task: ${finalMessage}\n`);
         process.stderr.write(`🤖 Agent: ${agentRef}\n`);
         if (thread)
             process.stderr.write(`🔗 Thread: ${thread}\n`);
@@ -78,7 +94,7 @@ async function handleExecute(args) {
     }
     let exitCode = 0;
     try {
-        const result = await crewx.execute(agentRef, message, {
+        const result = await crewx.execute(agentRef, finalMessage, {
             provider,
             threadId: thread,
             metadata: Object.keys(parsedMetadata).length > 0 ? parsedMetadata : undefined,

package/dist/commands/parse-common-flags.d.ts

@@ -20,6 +20,8 @@ export interface CommonFlags {
     outputFormat?: string;
     /** Model effort level (high | medium | low). */
     effort?: string;
+    /** Path to a file whose content is used as the prompt body (-f/--prompt-file). */
+    promptFile?: string;
     /** Remaining non-flag arguments. */
     rest: string[];
 }

package/dist/commands/parse-common-flags.js

@@ -46,6 +46,7 @@ function parseCommonFlags(args) {
     const config = parseFlag(args, '--config', '-c');
     const outputFormat = parseFlag(args, '--output-format');
     const effort = parseFlag(args, '--effort');
+    const promptFile = parseFlag(args, '--prompt-file', '-f');
     const verbose = hasFlag(args, '--verbose');
     // Collect the set of consumed positions
     const consumed = new Set();
@@ -56,6 +57,7 @@ function parseCommonFlags(args) {
         { names: ['--config', '-c'] },
         { names: ['--output-format'] },
         { names: ['--effort'] },
+        { names: ['--prompt-file', '-f'] },
     ];
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -79,7 +81,7 @@ function parseCommonFlags(args) {
         }
     }
     const rest = args.filter((_, i) => !consumed.has(i));
-    return { thread, provider, metadata, verbose, config, outputFormat, effort, rest };
+    return { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, rest };
 }
 /**
  * Parse metadata JSON string from --metadata flag.

package/dist/commands/query.d.ts

@@ -11,6 +11,12 @@
  *   --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.
  */
 /**
  * Handle `crewx query <agentRef> <message>` command.

package/dist/commands/query.js

@@ -12,12 +12,19 @@
  *   --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");
 /**
  * Handle `crewx query <agentRef> <message>` command.
@@ -26,27 +33,36 @@ const crewx_cli_1 = require("../bootstrap/crewx-cli");
  * --verbose: debug info written to stderr, response to stdout.
  */
 async function handleQuery(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
+    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, 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';
-    if (!message) {
+    // 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('  --effort <level>       Model effort (high|medium|low)');
+        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('  --effort <level>          Model effort (high|medium|low)');
+        console.error('  -f/--prompt-file <path>   Read prompt body from file');
         process.exit(1);
     }
     const configPath = config ?? process.env.CREWX_CONFIG ?? 'crewx.yaml';
@@ -55,7 +71,7 @@ async function handleQuery(args) {
     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: ${message}\n`);
+        process.stderr.write(`📋 Task: ${finalMessage}\n`);
         process.stderr.write(`🤖 Agent: ${agentRef}\n`);
         if (thread)
             process.stderr.write(`🔗 Thread: ${thread}\n`);
@@ -78,7 +94,7 @@ async function handleQuery(args) {
     }
     let exitCode = 0;
     try {
-        const result = await crewx.query(agentRef, message, {
+        const result = await crewx.query(agentRef, finalMessage, {
             provider,
             threadId: thread,
             metadata: Object.keys(parsedMetadata).length > 0 ? parsedMetadata : undefined,

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

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+/**
+ * Read all bytes from stdin (pipe or redirect).
+ * Returns empty string when stdin is a TTY (interactive terminal).
+ */
+export declare function readStdin(): Promise<string>;
+/**
+ * Resolve the final prompt from argv, stdin pipe, or --prompt-file.
+ *
+ * Priority:
+ *   1. promptFile is specified → read file content (ignores stdin)
+ *   2. stdin pipe/redirect    → read stdin
+ *   3. argv + external both present → `${argv}\n\n${external}`
+ *   4. Only one source present → use that source alone
+ *   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.
+ */
+export declare function resolvePrompt(argvPrompt: string, promptFile?: string, _readStdin?: () => Promise<string>): Promise<string>;

package/dist/commands/resolve-prompt.js

@@ -0,0 +1,54 @@
+"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 (ignores stdin)
+ *   2. stdin pipe/redirect    → read stdin
+ *   3. argv + external both present → `${argv}\n\n${external}`
+ *   4. Only one source present → use that source alone
+ *   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 {
+        external = (await _readStdin()).trimEnd();
+    }
+    if (argvPrompt && external)
+        return `${argvPrompt}\n\n${external}`;
+    return external || argvPrompt;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/cli",
-  "version": "0.8.1-rc.1",
+  "version": "0.8.1-rc.3",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -28,13 +28,13 @@
     "@crewx/adapter-slack": "0.1.3",
     "better-sqlite3": "*",
     "@crewx/memory": "0.1.9",
+    "@crewx/search": "0.1.8",
     "@crewx/wbs": "0.1.8",
-    "@crewx/sdk": "0.8.1-rc.1",
-    "@crewx/cron": "0.1.7",
     "@crewx/doc": "0.1.7",
-    "@crewx/search": "0.1.8",
+    "@crewx/sdk": "0.8.1-rc.3",
     "@crewx/workflow": "0.3.7",
     "@crewx/skill": "0.1.6",
+    "@crewx/cron": "0.1.7",
     "@crewx/shared": "0.0.4"
   },
   "devDependencies": {