@crewx/cli 0.9.0-rc.6 → 0.9.0-rc.8

package/dist/bootstrap/codex-writable-roots.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CLI-layer policy: inject CrewX home as an extra writable root for Codex
+ * `workspace-write` sandbox invocations.
+ *
+ * Why this lives in packages/cli (not packages/sdk):
+ * CrewX home (`~/.crewx` by default) is a product-specific path. The SDK's
+ * `additionalArgsProvider` extension point (WI-20260703-001) exists precisely
+ * so that product layers like this CLI can inject such paths without the SDK
+ * knowing about them.
+ *
+ * Why `-c sandbox_workspace_write.writable_roots=[...]` instead of `--add-dir`:
+ * Verified against codex-cli 0.139.0 (`codex exec --help` / `codex exec resume --help`):
+ *   - `codex exec` supports `--add-dir <DIR>`.
+ *   - `codex exec resume` does NOT support `--add-dir` (only `-c/--config`).
+ * Using the `-c` config-override form works identically for both `exec` and
+ * `exec resume`, avoiding a resume-incompatible flag.
+ */
+import type { AdditionalArgsProvider } from '@crewx/sdk';
+/**
+ * Resolve CrewX home directory.
+ * Priority: `CREWX_HOME` env var → `~/.crewx`.
+ */
+export declare function resolveCrewxHome(): string;
+/**
+ * Escape a string for embedding inside a TOML basic string (`"..."`).
+ * Sufficient for filesystem paths: handles backslash (Windows paths),
+ * double-quote, and control characters that could otherwise break TOML
+ * parsing of the `-c key="value"` override.
+ */
+export declare function escapeTomlBasicString(value: string): string;
+/**
+ * Build the `-c sandbox_workspace_write.writable_roots=["<path>"]` arg pair.
+ * Works for both `codex exec` and `codex exec resume` (config-override form).
+ */
+export declare function buildCodexWritableRootArgs(crewxHome: string): string[];
+/**
+ * Create an `AdditionalArgsProvider` (SDK extension point, WI-20260703-001)
+ * that injects CrewX home as a Codex writable root for `workspace-write`
+ * equivalent modes (`agent`, `auto`, `undefined`).
+ *
+ * No-ops for:
+ *   - Non-codex providers.
+ *   - Modes in {@link NO_INJECT_MODES} (read-only/plan/agent-full-access/yolo/danger-full-access).
+ */
+export declare function createCodexWritableRootsProvider(crewxHome?: string): AdditionalArgsProvider;

package/dist/bootstrap/codex-writable-roots.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * CLI-layer policy: inject CrewX home as an extra writable root for Codex
+ * `workspace-write` sandbox invocations.
+ *
+ * Why this lives in packages/cli (not packages/sdk):
+ * CrewX home (`~/.crewx` by default) is a product-specific path. The SDK's
+ * `additionalArgsProvider` extension point (WI-20260703-001) exists precisely
+ * so that product layers like this CLI can inject such paths without the SDK
+ * knowing about them.
+ *
+ * Why `-c sandbox_workspace_write.writable_roots=[...]` instead of `--add-dir`:
+ * Verified against codex-cli 0.139.0 (`codex exec --help` / `codex exec resume --help`):
+ *   - `codex exec` supports `--add-dir <DIR>`.
+ *   - `codex exec resume` does NOT support `--add-dir` (only `-c/--config`).
+ * Using the `-c` config-override form works identically for both `exec` and
+ * `exec resume`, avoiding a resume-incompatible flag.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCrewxHome = resolveCrewxHome;
+exports.escapeTomlBasicString = escapeTomlBasicString;
+exports.buildCodexWritableRootArgs = buildCodexWritableRootArgs;
+exports.createCodexWritableRootsProvider = createCodexWritableRootsProvider;
+const os_1 = require("os");
+const path_1 = require("path");
+/**
+ * crewx.yaml / query-option `mode` values for which Codex is NOT running in
+ * (or being pushed into) a `workspace-write`-equivalent sandbox. Injecting an
+ * extra writable root is meaningless (read-only/plan) or redundant
+ * (full-access variants already allow writes everywhere) in these modes.
+ */
+const NO_INJECT_MODES = new Set([
+    'read-only',
+    'plan',
+    'agent-full-access',
+    'yolo',
+    'danger-full-access',
+]);
+/**
+ * Resolve CrewX home directory.
+ * Priority: `CREWX_HOME` env var → `~/.crewx`.
+ */
+function resolveCrewxHome() {
+    return process.env.CREWX_HOME ?? (0, path_1.join)((0, os_1.homedir)(), '.crewx');
+}
+/**
+ * Escape a string for embedding inside a TOML basic string (`"..."`).
+ * Sufficient for filesystem paths: handles backslash (Windows paths),
+ * double-quote, and control characters that could otherwise break TOML
+ * parsing of the `-c key="value"` override.
+ */
+function escapeTomlBasicString(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * Build the `-c sandbox_workspace_write.writable_roots=["<path>"]` arg pair.
+ * Works for both `codex exec` and `codex exec resume` (config-override form).
+ */
+function buildCodexWritableRootArgs(crewxHome) {
+    const escaped = escapeTomlBasicString(crewxHome);
+    return ['-c', `sandbox_workspace_write.writable_roots=["${escaped}"]`];
+}
+function isCodexProvider(ctx) {
+    return ctx.providerId === 'codex' || ctx.providerStr === 'cli/codex';
+}
+/**
+ * Create an `AdditionalArgsProvider` (SDK extension point, WI-20260703-001)
+ * that injects CrewX home as a Codex writable root for `workspace-write`
+ * equivalent modes (`agent`, `auto`, `undefined`).
+ *
+ * No-ops for:
+ *   - Non-codex providers.
+ *   - Modes in {@link NO_INJECT_MODES} (read-only/plan/agent-full-access/yolo/danger-full-access).
+ */
+function createCodexWritableRootsProvider(crewxHome = resolveCrewxHome()) {
+    return (ctx) => {
+        if (!isCodexProvider(ctx))
+            return [];
+        if (ctx.mode !== undefined && NO_INJECT_MODES.has(ctx.mode))
+            return [];
+        return buildCodexWritableRootArgs(crewxHome);
+    };
+}

package/dist/bootstrap/crewx-cli.js

@@ -9,6 +9,7 @@ const plugins_1 = require("@crewx/sdk/plugins");
 const repository_1 = require("@crewx/sdk/repository");
 const register_builtin_tools_1 = require("../register-builtin-tools");
 const version_1 = require("../utils/version");
+const codex_writable_roots_1 = require("./codex-writable-roots");
 /**
  * Build a Crewx instance with CLI-standard plugins (FileLogger + SqliteTracing)
  * and built-in tools registered. Use this from any CLI command that needs a
@@ -52,6 +53,7 @@ async function createCliCrewx(configPath = process.env.CREWX_CONFIG ?? 'crewx.ya
     }
     const crewx = await sdk_1.Crewx.loadYaml(yamlPath, {
         remoteFactory: createCliCrewx,
+        additionalArgsProvider: (0, codex_writable_roots_1.createCodexWritableRootsProvider)(),
     });
     (0, register_builtin_tools_1.registerBuiltinToolsIfNeeded)(crewx);
     await crewx.use(new plugins_1.ConversationPlugin());

package/dist/commands/execute.js

@@ -34,7 +34,7 @@ const inherited_trace_1 = require("../utils/inherited-trace");
  * --verbose: debug info written to stderr, response to stdout.
  */
 async function handleExecute(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, vars, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
+    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, 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';
@@ -65,6 +65,7 @@ async function handleExecute(args) {
         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';
@@ -83,6 +84,8 @@ async function handleExecute(args) {
             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 = {};
@@ -99,6 +102,7 @@ async function handleExecute(args) {
         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,

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

@@ -3,7 +3,7 @@
  *
  * Supports both `--flag=value` and `--flag value` forms.
  * Handles: --thread, --provider, --metadata, --verbose, --config/-c,
- *          --output-format, --effort, --prompt-file/-f.
+ *          --output-format, --effort, --prompt-file/-f, --overdrive.
  *
  * Strict mode: unknown --xxx tokens after known flags are consumed throw an
  * error instead of silently leaking into the message prompt.
@@ -26,6 +26,8 @@ export interface CommonFlags {
     effort?: string;
     /** Path to a file whose content is used as the prompt body (-f/--prompt-file). */
     promptFile?: string;
+    /** Whether overdrive (boost) is active for this request. */
+    overdrive: boolean;
     /** Template variables from --var key=value flags. */
     vars: Record<string, string>;
     /** Remaining non-flag positional arguments. */

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

@@ -4,7 +4,7 @@
  *
  * Supports both `--flag=value` and `--flag value` forms.
  * Handles: --thread, --provider, --metadata, --verbose, --config/-c,
- *          --output-format, --effort, --prompt-file/-f.
+ *          --output-format, --effort, --prompt-file/-f, --overdrive.
  *
  * Strict mode: unknown --xxx tokens after known flags are consumed throw an
  * error instead of silently leaking into the message prompt.
@@ -69,6 +69,7 @@ function parseCommonFlags(args) {
     const effort = parseFlag(args, '--effort');
     const promptFile = parseFlag(args, '--prompt-file', '-f');
     const verbose = hasFlag(args, '--verbose');
+    const overdrive = hasFlag(args, '--overdrive');
     // Collect consumed positions for known flags
     const consumed = new Set();
     const flagPairs = [
@@ -88,6 +89,10 @@ function parseCommonFlags(args) {
             consumed.add(i);
             continue;
         }
+        if (arg === '--overdrive') {
+            consumed.add(i);
+            continue;
+        }
         // --var=key=value or --var key=value
         if (arg.startsWith('--var=') || arg === '--var') {
             let kv;
@@ -148,7 +153,7 @@ function parseCommonFlags(args) {
         }
         rest.push(token);
     }
-    return { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, vars, rest };
+    return { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, rest };
 }
 /**
  * Parse metadata JSON string from --metadata flag.

package/dist/commands/ps.js

@@ -21,14 +21,54 @@ function formatElapsed(ms) {
     const h = Math.floor(m / 60);
     return `${h}h ${m % 60}m`;
 }
+/**
+ * Antigravity-family providers (coding_agent_command starting with 'agy',
+ * path-included forms like '/usr/local/bin/agy' also count) don't emit
+ * parseable logs, so they get a distinct 'n/a' instead of '—'.
+ */
+function isAgyCommand(codingAgentCommand) {
+    const cmd = (codingAgentCommand ?? '').trim();
+    if (!cmd)
+        return false;
+    const firstToken = cmd.split(/\s+/)[0] ?? '';
+    const base = firstToken.split('/').pop() ?? firstToken;
+    return base.startsWith('agy');
+}
+function getLastActive(task) {
+    try {
+        const entries = task.logs ? JSON.parse(task.logs) : [];
+        if (Array.isArray(entries) && entries.length > 0) {
+            const lastEntry = entries[entries.length - 1];
+            const ts = lastEntry?.timestamp;
+            const parsedMs = ts ? new Date(ts).getTime() : NaN;
+            if (ts && !Number.isNaN(parsedMs)) {
+                const diffMs = Math.max(0, Date.now() - parsedMs);
+                return {
+                    display: `${formatElapsed(diffMs)} ago`,
+                    isoTimestamp: ts,
+                    logCapable: true,
+                };
+            }
+        }
+    }
+    catch {
+        // fall through to antigravity/dash fallback below
+    }
+    if (isAgyCommand(task.coding_agent_command)) {
+        return { display: 'n/a', isoTimestamp: null, logCapable: false };
+    }
+    return { display: '—', isoTimestamp: null, logCapable: true };
+}
 function taskToRow(task) {
     const elapsed = formatElapsed(Date.now() - new Date(task.started_at).getTime());
+    const lastActive = getLastActive(task);
     return [
         task.id,
         task.agent_id ?? '—',
         task.pid !== null && task.pid !== undefined ? String(task.pid) : '—',
         elapsed,
         task.mode ?? '—',
+        lastActive.display,
     ];
 }
 function renderTable(headers, rows) {
@@ -49,10 +89,18 @@ async function handlePs(args) {
         return;
     }
     if (args.includes('--json')) {
-        console.log(JSON.stringify(tasks, null, 2));
+        const withLastActive = tasks.map((task) => {
+            const lastActive = getLastActive(task);
+            return {
+                ...task,
+                last_active_at: lastActive.isoTimestamp,
+                log_capable: lastActive.logCapable,
+            };
+        });
+        console.log(JSON.stringify(withLastActive, null, 2));
         return;
     }
-    const headers = ['TASK ID', 'AGENT', 'PID', 'ELAPSED', 'MODE'];
+    const headers = ['TASK ID', 'AGENT', 'PID', 'ELAPSED', 'MODE', 'LAST ACTIVE'];
     const rows = tasks.map(taskToRow);
     renderTable(headers, rows);
     console.log(`\n  ${tasks.length} running task(s)`);

package/dist/commands/query.js

@@ -34,7 +34,7 @@ const inherited_trace_1 = require("../utils/inherited-trace");
  * --verbose: debug info written to stderr, response to stdout.
  */
 async function handleQuery(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, vars, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
+    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, 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';
@@ -65,6 +65,7 @@ async function handleQuery(args) {
         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';
@@ -83,6 +84,8 @@ async function handleQuery(args) {
             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 = {};
@@ -99,6 +102,7 @@ async function handleQuery(args) {
         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,

package/dist/commands/restart.js

@@ -43,18 +43,23 @@ function buildRetryPrefix(originalTaskId) {
  * the string when present and non-empty, otherwise `undefined` so the
  * agent's configured provider default is used.
  */
-function extractProvider(metadata) {
+function parseTaskMetadata(metadata) {
     if (!metadata)
-        return undefined;
+        return {};
     try {
         const parsed = JSON.parse(metadata);
-        const provider = parsed.provider;
-        return typeof provider === 'string' && provider.length > 0 ? provider : undefined;
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : {};
     }
     catch {
-        return undefined;
+        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('--'));
@@ -96,7 +101,10 @@ async function handleRestart(args) {
     // 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 provider = extractProvider(original.metadata);
+    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`);
@@ -111,10 +119,16 @@ async function handleRestart(args) {
         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)(),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/cli",
-  "version": "0.9.0-rc.6",
+  "version": "0.9.0-rc.8",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -24,17 +24,17 @@
     "@crewx/adapter-slack": "0.1.4",
     "better-sqlite3": "*",
     "isomorphic-git": "1.37.1",
-    "@crewx/sdk": "0.9.0-rc.6",
-    "@crewx/search": "0.1.10",
+    "@crewx/sdk": "0.9.0-rc.8",
     "@crewx/doc": "0.1.9",
+    "@crewx/search": "0.1.10",
+    "@crewx/workflow": "0.3.22-rc.54",
     "@crewx/cron": "0.1.10",
     "@crewx/skill": "0.1.20",
-    "@crewx/workflow": "0.3.22-rc.52",
-    "@crewx/shared": "0.0.6",
     "@crewx/chromex": "0.1.0",
     "@crewx/wbs": "0.1.10",
     "@crewx/memory": "0.1.23",
-    "@crewx/wi": "0.1.10"
+    "@crewx/wi": "0.1.10",
+    "@crewx/shared": "0.0.6"
   },
   "devDependencies": {
     "@types/better-sqlite3": "*",