nexrall-code 0.5.162 → 0.5.164

package/dist/index.js

@@ -12139,11 +12139,11 @@ var require_agentTypes = __commonJS({
     exports2.parseModel = parseModel;
     exports2.parseAgentHooks = parseAgentHooks;
     exports2.loadAgentTypes = loadAgentTypes;
-    exports2.loadAgentTypesWithWarnings = loadAgentTypesWithWarnings2;
+    exports2.loadAgentTypesWithWarnings = loadAgentTypesWithWarnings3;
     exports2.knownToolNames = knownToolNames3;
     exports2.builtinAgents = builtinAgents;
     exports2.summariseAgents = summariseAgents;
-    exports2.findAgentType = findAgentType;
+    exports2.findAgentType = findAgentType2;
     var miniYaml_1 = require_miniYaml();
     var fs27 = __importStar(__require("fs"));
     var path27 = __importStar(__require("path"));
@@ -12614,11 +12614,19 @@ var require_agentTypes = __commonJS({
           throw new Error(`${where}: expected a list of hooks`);
         return list.map((h2, i2) => {
           const o = h2;
+          const ms = typeof o.timeout_ms === "number" ? o.timeout_ms : typeof o.timeout === "number" ? o.timeout * 1e3 : void 0;
+          const timeout = ms && ms > 0 ? { timeout_ms: ms } : {};
+          if (o && o.type === "http" && typeof o.url === "string" && o.url.trim()) {
+            if (!/^https?:\/\//i.test(o.url.trim()))
+              throw new Error(`${where}[${i2}]: http hooks need an http(s) url`);
+            const headers = o.headers && typeof o.headers === "object" && !Array.isArray(o.headers) ? o.headers : void 0;
+            const allowed = Array.isArray(o.allowedEnvVars) ? o.allowedEnvVars.filter((v2) => typeof v2 === "string") : void 0;
+            return { type: "http", url: o.url.trim(), ...headers ? { headers } : {}, ...allowed ? { allowedEnvVars: allowed } : {}, ...timeout };
+          }
           if (!o || o.type !== "command" || typeof o.command !== "string" || !o.command.trim()) {
-            throw new Error(`${where}[${i2}]: each hook needs type: command and a command`);
+            throw new Error(`${where}[${i2}]: each hook needs type: command and a command, or type: http and a url`);
           }
-          const ms = typeof o.timeout_ms === "number" ? o.timeout_ms : typeof o.timeout === "number" ? o.timeout * 1e3 : void 0;
-          return { type: "command", command: o.command, ...ms && ms > 0 ? { timeout_ms: ms } : {} };
+          return { type: "command", command: o.command, ...timeout };
         });
       };
       const entries = (list, ev) => {
@@ -12677,9 +12685,9 @@ var require_agentTypes = __commonJS({
       return out;
     }
     function loadAgentTypes(workDir) {
-      return loadAgentTypesWithWarnings2(workDir).types;
+      return loadAgentTypesWithWarnings3(workDir).types;
     }
-    function loadAgentTypesWithWarnings2(workDir, extra = []) {
+    function loadAgentTypesWithWarnings3(workDir, extra = []) {
       const out = /* @__PURE__ */ new Map();
       const warnings = [];
       loadDir(path27.join(workDir, ".nexrall", "agents"), "project", out, warnings);
@@ -12734,7 +12742,7 @@ var require_agentTypes = __commonJS({
       "write_xlsx",
       "write_pptx"
     ]);
-    function findAgentType(types3, name) {
+    function findAgentType2(types3, name) {
       if (!name)
         return void 0;
       const want = name.trim().toLowerCase();
@@ -107063,6 +107071,42 @@ var require_loop = __commonJS({
         child.stdin?.end(opts.input ?? "");
       });
     }
+    async function httpHook(hook, payload, timeoutMs) {
+      const url = String(hook.url ?? "");
+      if (!/^https?:\/\//i.test(url))
+        return { status: 1, stdout: "", stderr: `hook url must be http(s): ${url}` };
+      const headers = { "content-type": "application/json" };
+      const allowed = new Set(hook.allowedEnvVars ?? []);
+      for (const [k, v] of Object.entries(hook.headers ?? {})) {
+        headers[k] = String(v).replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}|\$([A-Za-z_][A-Za-z0-9_]*)/g, (_m, a1, a2) => allowed.has(a1 ?? a2) ? process.env[a1 ?? a2] ?? "" : "");
+      }
+      try {
+        const res = await fetch(url, { method: "POST", headers, body: payload, signal: AbortSignal.timeout(timeoutMs) });
+        const text = (await res.text()).trim();
+        if (res.status < 200 || res.status >= 300) {
+          return { status: 1, stdout: "", stderr: `hook returned HTTP ${res.status}` };
+        }
+        if (!text)
+          return { status: 0, stdout: "", stderr: "" };
+        if (text.startsWith("{"))
+          return { status: 0, stdout: text, stderr: "" };
+        return { status: 1, stdout: "", stderr: "hook returned a non-JSON body" };
+      } catch (err) {
+        return { status: 1, stdout: "", stderr: `hook request failed: ${err.message}` };
+      }
+    }
+    async function runHookHandler(hook, payload, opts) {
+      if (hook.type === "http")
+        return httpHook(hook, payload, opts.timeoutMs);
+      return spawnHook(String(hook.command ?? ""), { cwd: opts.cwd, timeout: opts.timeoutMs, input: payload, env: opts.env });
+    }
+    function hookTimeoutMs(hook, fallbackMs = 6e4) {
+      if (typeof hook.timeout_ms === "number" && hook.timeout_ms > 0)
+        return Math.min(hook.timeout_ms, 6e5);
+      if (typeof hook.timeout === "number" && hook.timeout > 0)
+        return Math.min(hook.timeout * 1e3, 6e5);
+      return fallbackMs;
+    }
     function hookMatches(matcher, toolName) {
       if (!matcher || matcher === "*")
         return true;
@@ -107085,13 +107129,16 @@ var require_loop = __commonJS({
         if (!hookMatches(entry.matcher, toolName))
           continue;
         for (const hook of entry.hooks ?? []) {
-          if (hook.type !== "command" || !hook.command)
+          if (hook.type !== "command" && hook.type !== "http")
+            continue;
+          if (hook.type === "command" && !hook.command)
             continue;
-          const hookTimeout = typeof hook.timeout_ms === "number" && hook.timeout_ms > 0 ? Math.min(hook.timeout_ms, 6e5) : 6e4;
-          const r2 = await spawnHook(hook.command, {
+          if (hook.type === "http" && !hook.url)
+            continue;
+          const hookTimeout = hookTimeoutMs(hook, 6e4);
+          const r2 = await runHookHandler(hook, payload, {
             cwd: workDir,
-            timeout: hookTimeout,
-            input: payload,
+            timeoutMs: hookTimeout,
             env: {
               ...process.env,
               NEXRALL_TOOL_NAME: toolName,
@@ -107126,9 +107173,13 @@ var require_loop = __commonJS({
       if (!defs?.length)
         return;
       for (const hook of defs) {
-        if (hook.type === "command" && hook.command) {
-          await spawnHook(hook.command, { cwd: workDir, timeout: 1e4, env: extraEnv ? { ...process.env, ...extraEnv } : void 0 });
-        }
+        if (hook.type !== "command" && hook.type !== "http")
+          continue;
+        if (hook.type === "command" && !hook.command)
+          continue;
+        if (hook.type === "http" && !hook.url)
+          continue;
+        await runHookHandler(hook, "", { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 1e4), env: extraEnv ? { ...process.env, ...extraEnv } : void 0 });
       }
     }
     function flattenHookDefs(items, matchValue) {
@@ -107139,7 +107190,7 @@ var require_loop = __commonJS({
           if (m2 && m2 !== "*" && matchValue !== void 0 && !m2.split("|").map((x2) => x2.trim()).includes(matchValue))
             continue;
           out.push(...it.hooks);
-        } else if (it && it.type === "command")
+        } else if (it && (it.type === "command" || it.type === "http"))
           out.push(it);
       }
       return out;
@@ -107151,10 +107202,14 @@ var require_loop = __commonJS({
         return outcome;
       const input = JSON.stringify({ hook_event_name: event, cwd: workDir, ...payload });
       for (const hook of defs) {
-        if (!hook.command)
+        if (hook.type !== "command" && hook.type !== "http")
+          continue;
+        if (hook.type === "command" && !hook.command)
           continue;
-        const timeout = typeof hook.timeout_ms === "number" && hook.timeout_ms > 0 ? Math.min(hook.timeout_ms, 6e5) : 3e4;
-        const r2 = await spawnHook(hook.command, { cwd: workDir, timeout, input, env: { ...process.env, NEXRALL_HOOK_PHASE: event } });
+        if (hook.type === "http" && !hook.url)
+          continue;
+        const timeout = hookTimeoutMs(hook, 3e4);
+        const r2 = await runHookHandler(hook, input, { cwd: workDir, timeoutMs: timeout, env: { ...process.env, NEXRALL_HOOK_PHASE: event } });
         const out = (r2.stdout ?? "").toString().trim();
         if (out.startsWith("{")) {
           try {
@@ -152355,6 +152410,54 @@ function initEventPayload(i2) {
 function userReplayPayload(text) {
   return { type: "user", message: { role: "user", content: [{ type: "text", text }] } };
 }
+function parseAgentsArg(raw, cwd2) {
+  if (raw === void 0)
+    return { ok: true, value: [] };
+  const text = String(raw).trim();
+  if (!text)
+    return { ok: false, error: "--agents: the value is empty." };
+  let json = text;
+  const looksLikePath = text.startsWith("@") || !text.startsWith("{") && fs6.existsSync(path7.resolve(cwd2, text));
+  if (looksLikePath) {
+    const file = text.startsWith("@") ? text.slice(1) : text;
+    try {
+      json = fs6.readFileSync(path7.resolve(cwd2, file), "utf-8");
+    } catch (e2) {
+      return { ok: false, error: `--agents: cannot read ${file}: ${e2.message}` };
+    }
+  }
+  let obj2;
+  try {
+    obj2 = JSON.parse(json);
+  } catch (e2) {
+    return { ok: false, error: `--agents: not valid JSON: ${e2.message}` };
+  }
+  if (!obj2 || typeof obj2 !== "object" || Array.isArray(obj2)) {
+    return { ok: false, error: '--agents: expected an object of { "name": { "description", "prompt" } }.' };
+  }
+  const out = [];
+  for (const [name, v] of Object.entries(obj2)) {
+    const a = v ?? {};
+    if (!/^[A-Za-z0-9._-]+$/.test(name)) {
+      return { ok: false, error: `--agents: "${name}" is not a usable agent name (letters, digits, . _ - only).` };
+    }
+    if (typeof a.description !== "string" || !a.description.trim()) {
+      return { ok: false, error: `--agents: "${name}" needs a description (that is how the model decides to use it).` };
+    }
+    if (typeof a.prompt !== "string" || !a.prompt.trim()) {
+      return { ok: false, error: `--agents: "${name}" needs a prompt (the agent's instructions).` };
+    }
+    const tools = Array.isArray(a.tools) ? a.tools.filter((t2) => typeof t2 === "string" && !!t2.trim()) : void 0;
+    if (a.tools !== void 0 && (!tools || tools.length !== a.tools.length)) {
+      return { ok: false, error: `--agents: "${name}".tools must be a list of tool names.` };
+    }
+    const model = typeof a.model === "string" && a.model.trim() ? a.model.trim() : void 0;
+    out.push({ name, description: a.description.trim(), prompt: a.prompt, ...tools ? { tools } : {}, ...model ? { model } : {} });
+  }
+  if (!out.length)
+    return { ok: false, error: "--agents: no agents defined." };
+  return { ok: true, value: out };
+}
 
 // src/commands/chat.ts
 var import_code_core17 = __toESM(require_dist3(), 1);
@@ -168246,6 +168349,7 @@ function refreshEnvForTurn(env4, workDir) {
   };
 }
 var noDiscovery = false;
+var _cliAgentTypes = [];
 function setNoDiscovery(v) {
   noDiscovery = v;
 }
@@ -168958,6 +169062,7 @@ async function runTurn(messages, modelAlias, workDir, abortSignal, env4, nexrall
     },
     backgroundAgents: cliBackgroundAgents,
     disableHooks: noDiscovery,
+    _extraAgentTypes: _cliAgentTypes,
     // The backend streams a cumulative output-token count (routes/code.js's
     // sendProgress, throttled to ≤5/s) covering thinking, visible text AND
     // tool-argument JSON. This used to be stored in a variable and rendered only
@@ -169280,6 +169385,7 @@ async function runTurnHeadless(messages, modelAlias, workDir, _abortSignal, env4
     worktree: worktreeState,
     backgroundAgents: cliBackgroundAgents,
     disableHooks: noDiscovery,
+    _extraAgentTypes: _cliAgentTypes,
     effort,
     abortSignal: _abortSignal,
     // `--max-turns`: a hard round cap. autoContinue off, or the loop would extend it.
@@ -169654,6 +169760,7 @@ function printSessions() {
 async function startChatSession(options) {
   if (options.bare)
     setNoDiscovery(true);
+  _cliAgentTypes = (options.agents ?? []).map((a) => ({ ...a, source: "programmatic" }));
   (0, import_code_core15.enableAgentTranscriptPersistence)();
   const headless = options.outputFormat === "json" || options.outputFormat === "stream-json";
   const requestedWorkDir = options.workDir;
@@ -169750,8 +169857,11 @@ Resume it with: nex --worktree ${worktreeState.name}
   }
   const env4 = collectEnv(workDir);
   const briefBase = options.systemPrompt?.trim() ?? readNexrallMd(workDir);
-  const nexrallMd = [briefBase, options.appendSystemPrompt?.trim(), addDirNote(options.addDirs ?? []), options.jsonSchema ? schemaInstruction(options.jsonSchema) : ""].filter(Boolean).join("\n\n") || void 0;
-  _headlessPolicy = { strict: !!options.strictPermissions, budgetUsd: options.budgetUsd, spent: 0, schema: options.jsonSchema, maxTurns: options.maxTurns, onlyTools: options.onlyTools ? new Set(options.onlyTools) : void 0 };
+  const agentPrefix = options.selectedAgent?.prompt?.trim();
+  const nexrallMd = [agentPrefix, briefBase, options.appendSystemPrompt?.trim(), addDirNote(options.addDirs ?? []), options.jsonSchema ? schemaInstruction(options.jsonSchema) : ""].filter(Boolean).join("\n\n") || void 0;
+  const agentTools = options.selectedAgent?.tools;
+  const toolAllow = agentTools && options.onlyTools ? options.onlyTools.filter((t2) => agentTools.includes(t2)) : options.onlyTools ?? agentTools;
+  _headlessPolicy = { strict: !!options.strictPermissions, budgetUsd: options.budgetUsd, spent: 0, schema: options.jsonSchema, maxTurns: options.maxTurns, onlyTools: toolAllow ? new Set(toolAllow) : void 0 };
   _headlessPolicy.verbose = !!options.verbose;
   _headlessPolicy.includePartial = !!options.includePartialMessages;
   _headlessPolicy.permissionMode = String(options.initialMode ?? "");
@@ -172982,6 +173092,17 @@ function killJob(job, dir = bgDir()) {
     }
   }
 }
+function removeJob(job, dir = bgDir()) {
+  if (job.state === "running")
+    return { ok: false, error: `Job ${job.id} is still running \u2014 stop it first (nex kill ${job.id}).` };
+  for (const suffix of [".json", ".log", ".code", ".killed"]) {
+    try {
+      fs25.rmSync(path25.join(dir, job.id + suffix), { force: true });
+    } catch {
+    }
+  }
+  return { ok: true };
+}
 var ago = (t2) => {
   const s2 = Math.max(0, Math.round((Date.now() - t2) / 1e3));
   return s2 < 90 ? `${s2}s` : s2 < 5400 ? `${Math.round(s2 / 60)}m` : `${Math.round(s2 / 3600)}h`;
@@ -173357,6 +173478,33 @@ program2.command("attach <id>").description("Watch a background job live, readab
   }
   process.exit(await followLog(r2.job, true, void 0, void 0, true));
 });
+program2.command("stop <id>").description("Stop a running background job (same as kill; matches Claude Code's name)").action((id) => {
+  const r2 = resolveJob(id);
+  if (!r2.ok) {
+    console.error(r2.error);
+    process.exit(1);
+  }
+  if (!killJob(r2.job)) {
+    console.error(`Job ${r2.job.id} is not running (${r2.job.state}).`);
+    process.exit(1);
+  }
+  console.log(`Stopped job ${r2.job.id}`);
+  process.exit(0);
+});
+program2.command("rm <id>").description("Delete a finished background job's records (log included)").action((id) => {
+  const r2 = resolveJob(id);
+  if (!r2.ok) {
+    console.error(r2.error);
+    process.exit(1);
+  }
+  const res = removeJob(r2.job);
+  if (!res.ok) {
+    console.error(res.error);
+    process.exit(1);
+  }
+  console.log(`Removed job ${r2.job.id}`);
+  process.exit(0);
+});
 program2.command("kill <id>").description("Stop a background job").action((id) => {
   const r2 = resolveJob(id);
   if (!r2.ok) {
@@ -173501,7 +173649,7 @@ program2.command("sessions").description("List, export, import, or delete saved
   console.log(paint.dim("  nex sessions --events <id> [--json]       to follow its event stream"));
   console.log();
 });
-program2.option("-p, --pro", "Use Claude Opus 5.5 (most capable)").option("-t, --turbo", "Use Claude Sonnet 5.5 (fast)").option("-u, --ultra", "Use Claude Fable 5.1 (most powerful)").option("-y, --yolo", "Auto-approve all tool calls (no permission prompts)").option("-d, --dir <path>", "Set working directory (default: current directory)").option("-m, --model <name>", "Explicit model, e.g. claude-opus-5-5 | gpt-5.4 | gpt-4.1").option("-r, --resume [id]", "Resume last session, or a specific session id").option("-c, --continue", "Continue the latest conversation in this folder").option("--plan", "Start in plan mode (read-only; /mode or Shift+Tab can leave it)").option("--readonly", "Read-only for the whole session: plan mode that cannot be switched off").option("--auto", "Start in auto mode (the default \u2014 edits and commands run without asking)").option("--mode <mode>", "Starting permission mode: ask | edit | auto | plan").option("--fullscreen", "Draw the whole session on the terminal's alternate screen: the transcript re-wraps on resize and PgUp/PgDn page through it (no terminal scrollback while it is on; /fullscreen toggles it)").option("--bg", "Run the prompt in the background (headless); returns a job id. See: nex jobs | logs | attach | kill").option("--debug", "Write request timing, retries and errors to a debug log file").option("--no-color", "Disable colored output (also honours NO_COLOR)").option("-w, --worktree [name]", "Isolate this session in its own worktree \u2014 a separate directory (and, in a git repo, its own branch) so it can never overwrite files another session (or you) are touching in the main checkout. Omit a name for an auto-generated one; pass an existing name to resume that same worktree.").option("-e, --effort <level>", "Thinking effort \u2014 real levels depend on the model (e.g. DeepSeek: low|high|max, Qwen: low|high); run `nex --model <id>` then `/effort` with no argument to see a model's scale").option("--no-banner", "Skip the ASCII banner (useful in scripts/pipes)").option("--output-format <fmt>", "One-shot output format: text | json | stream-json (implies auto-approve)").option("--audit [path]", "Log every tool call (and refusal) to a JSONL trail (default: .nexrall/audit/<session>.jsonl)").option("--permission-mode <mode>", "Permission mode: ask | edit | auto | plan (also Claude Code names: default | acceptEdits | bypassPermissions). With --output-format, anything that would prompt is DENIED instead of auto-approved").option("--allowedTools, --allowed-tools <tools...>", 'Tools/rules to allow without asking, e.g. "Bash(git *)" Edit (comma or space separated; put the prompt BEFORE this flag)').option("--disallowedTools, --disallowed-tools <tools...>", 'Tools/rules to deny, e.g. "Bash(rm *)" (deny always wins)').option("--append-system-prompt <text>", "Extra instructions appended to the project brief for this run").option("--max-budget-usd <amount>", "Stop a one-shot run once it has spent this many dollars (needs --output-format)").option("--mcp-config <configs...>", 'Load MCP servers from JSON files or inline JSON ({"mcpServers":{\u2026}}) for this run').option("--strict-mcp-config", "With --mcp-config: use ONLY those servers, ignoring ~/.nexrall/mcp.json and the project one").option("--add-dir <dirs...>", "Extra directories the agent may read and edit besides the project folder").option("--input-format <format>", "text (default) | stream-json \u2014 read the prompt as Claude-Code-style NDJSON user messages on stdin").option("--json-schema <schema>", 'JSON Schema (inline or file) the final answer must satisfy; needs --output-format. Result gains "structured_output"; exit 3 if it does not validate').option("--no-session-persistence", "Do not save this run to disk (needs --output-format; it cannot be resumed)").option("--max-turns <n>", "Stop a headless run after N agent rounds (needs --output-format; exit 4 when it hits the limit)").option("--append-system-prompt-file <path>", "Like --append-system-prompt, read from a file").option("--system-prompt <text>", "REPLACE the project brief (nexrall.md + memory + global instructions) with this text for this run").option("--system-prompt-file <path>", "Like --system-prompt, read from a file").option("--verbose", "Print progress detail (tool calls, timings, usage) to stderr while a one-shot run works").option("--include-partial-messages", "Stream model deltas as they arrive (needs --output-format stream-json)").option("--replay-user-messages", "Echo each stdin message back on stdout as it is consumed (needs --input-format stream-json --output-format stream-json)").option("--bare", "Start without discovery: no nexrall.md/memory, skills, plugins, hooks or MCP config files").option("--safe-mode", "Same as --bare (Claude Code's troubleshooting name)").option("--tools <list>", 'Exactly these built-in tools ("Bash,Read,Edit", "default", or "" for none); the rest are removed, not just unapproved').option("--session-id <id>", "Use this id for a NEW conversation (letters, digits, - _), so a script can find it again").option("-n, --name <name>", "Name the conversation; `nex -r <name>` resumes it by that name").option("--fork-session", "With --resume/--continue: branch into a new session instead of continuing the original").option("--fallback-model <name>", "If the main model is overloaded or unreachable, retry the turn once on this model (needs --output-format)").option("--settings <file|json>", "Settings (permissions, hooks\u2026) for this run only: a JSON file or an inline JSON object; merged over the user/project settings").option("--debug-file <path>", "Write the --debug diagnostics log to this file (implies --debug)").argument("[prompt...]", "One-shot prompt \u2014 if omitted, starts interactive mode").action(async (promptParts, options) => {
+program2.option("-p, --pro", "Use Claude Opus 5.5 (most capable)").option("-t, --turbo", "Use Claude Sonnet 5.5 (fast)").option("-u, --ultra", "Use Claude Fable 5.1 (most powerful)").option("-y, --yolo", "Auto-approve all tool calls (no permission prompts)").option("-d, --dir <path>", "Set working directory (default: current directory)").option("-m, --model <name>", "Explicit model, e.g. claude-opus-5-5 | gpt-5.4 | gpt-4.1").option("-r, --resume [id]", "Resume last session, or a specific session id").option("-c, --continue", "Continue the latest conversation in this folder").option("--plan", "Start in plan mode (read-only; /mode or Shift+Tab can leave it)").option("--readonly", "Read-only for the whole session: plan mode that cannot be switched off").option("--auto", "Start in auto mode (the default \u2014 edits and commands run without asking)").option("--mode <mode>", "Starting permission mode: ask | edit | auto | plan").option("--fullscreen", "Draw the whole session on the terminal's alternate screen: the transcript re-wraps on resize and PgUp/PgDn page through it (no terminal scrollback while it is on; /fullscreen toggles it)").option("--bg", "Run the prompt in the background (headless); returns a job id. See: nex jobs | logs | attach | kill").option("--debug", "Write request timing, retries and errors to a debug log file").option("--no-color", "Disable colored output (also honours NO_COLOR)").option("-w, --worktree [name]", "Isolate this session in its own worktree \u2014 a separate directory (and, in a git repo, its own branch) so it can never overwrite files another session (or you) are touching in the main checkout. Omit a name for an auto-generated one; pass an existing name to resume that same worktree.").option("-e, --effort <level>", "Thinking effort \u2014 real levels depend on the model (e.g. DeepSeek: low|high|max, Qwen: low|high); run `nex --model <id>` then `/effort` with no argument to see a model's scale").option("--no-banner", "Skip the ASCII banner (useful in scripts/pipes)").option("--output-format <fmt>", "One-shot output format: text | json | stream-json (implies auto-approve)").option("--audit [path]", "Log every tool call (and refusal) to a JSONL trail (default: .nexrall/audit/<session>.jsonl)").option("--permission-mode <mode>", "Permission mode: ask | edit | auto | plan (also Claude Code names: default | acceptEdits | bypassPermissions). With --output-format, anything that would prompt is DENIED instead of auto-approved").option("--allowedTools, --allowed-tools <tools...>", 'Tools/rules to allow without asking, e.g. "Bash(git *)" Edit (comma or space separated; put the prompt BEFORE this flag)').option("--disallowedTools, --disallowed-tools <tools...>", 'Tools/rules to deny, e.g. "Bash(rm *)" (deny always wins)').option("--append-system-prompt <text>", "Extra instructions appended to the project brief for this run").option("--max-budget-usd <amount>", "Stop a one-shot run once it has spent this many dollars (needs --output-format)").option("--mcp-config <configs...>", 'Load MCP servers from JSON files or inline JSON ({"mcpServers":{\u2026}}) for this run').option("--strict-mcp-config", "With --mcp-config: use ONLY those servers, ignoring ~/.nexrall/mcp.json and the project one").option("--add-dir <dirs...>", "Extra directories the agent may read and edit besides the project folder").option("--input-format <format>", "text (default) | stream-json \u2014 read the prompt as Claude-Code-style NDJSON user messages on stdin").option("--json-schema <schema>", 'JSON Schema (inline or file) the final answer must satisfy; needs --output-format. Result gains "structured_output"; exit 3 if it does not validate').option("--no-session-persistence", "Do not save this run to disk (needs --output-format; it cannot be resumed)").option("--max-turns <n>", "Stop a headless run after N agent rounds (needs --output-format; exit 4 when it hits the limit)").option("--append-system-prompt-file <path>", "Like --append-system-prompt, read from a file").option("--system-prompt <text>", "REPLACE the project brief (nexrall.md + memory + global instructions) with this text for this run").option("--system-prompt-file <path>", "Like --system-prompt, read from a file").option("--verbose", "Print progress detail (tool calls, timings, usage) to stderr while a one-shot run works").option("--include-partial-messages", "Stream model deltas as they arrive (needs --output-format stream-json)").option("--replay-user-messages", "Echo each stdin message back on stdout as it is consumed (needs --input-format stream-json --output-format stream-json)").option("--agents <json-or-file>", 'Define extra sub-agents for this run: a JSON object { "name": { "description", "prompt", "tools", "model" } } or @file.json').option("--agent <name>", "Run this session AS that agent (its prompt, tools and model), from .nexrall/agents, a plugin, --agents or a builtin").option("--bare", "Start without discovery: no nexrall.md/memory, skills, plugins, hooks or MCP config files").option("--safe-mode", "Same as --bare (Claude Code's troubleshooting name)").option("--tools <list>", 'Exactly these built-in tools ("Bash,Read,Edit", "default", or "" for none); the rest are removed, not just unapproved').option("--session-id <id>", "Use this id for a NEW conversation (letters, digits, - _), so a script can find it again").option("-n, --name <name>", "Name the conversation; `nex -r <name>` resumes it by that name").option("--fork-session", "With --resume/--continue: branch into a new session instead of continuing the original").option("--fallback-model <name>", "If the main model is overloaded or unreachable, retry the turn once on this model (needs --output-format)").option("--settings <file|json>", "Settings (permissions, hooks\u2026) for this run only: a JSON file or an inline JSON object; merged over the user/project settings").option("--debug-file <path>", "Write the --debug diagnostics log to this file (implies --debug)").argument("[prompt...]", "One-shot prompt \u2014 if omitted, starts interactive mode").action(async (promptParts, options) => {
   if (!(0, import_code_core20.isAuthenticated)()) {
     console.error("Not logged in. Run: nex auth");
     process.exit(1);
@@ -173598,6 +173746,32 @@ program2.option("-p, --pro", "Use Claude Opus 5.5 (most capable)").option("-t, -
     console.error(headlessErr);
     process.exit(1);
   }
+  const agentsParsed = parseAgentsArg(options.agents, process.cwd());
+  if (!agentsParsed.ok) {
+    console.error(agentsParsed.error);
+    process.exit(1);
+  }
+  const extraTypes = agentsParsed.value.map((a) => ({
+    name: a.name,
+    description: a.description,
+    prompt: a.prompt,
+    source: "programmatic",
+    ...a.tools ? { tools: a.tools } : {},
+    ...a.model ? { model: a.model } : {}
+  }));
+  if (options.agent && options.bare) {
+    console.error("--agent needs agent discovery, which --bare/--safe-mode turns off \u2014 drop one of them.");
+    process.exit(1);
+  }
+  let selectedAgent;
+  if (options.agent) {
+    const catalogue = (0, import_code_core21.loadAgentTypesWithWarnings)(process.cwd(), extraTypes).types;
+    selectedAgent = (0, import_code_core21.findAgentType)(catalogue, String(options.agent));
+    if (!selectedAgent) {
+      console.error(`Unknown agent "${options.agent}". Available: ${catalogue.map((t2) => t2.name).join(", ")}`);
+      process.exit(1);
+    }
+  }
   const sysPrompt = resolveSystemPrompt({ text: typeof options.systemPrompt === "string" ? options.systemPrompt : void 0, file: options.systemPromptFile, cwd: process.cwd() });
   if (!sysPrompt.ok) {
     console.error(sysPrompt.error);
@@ -173756,7 +173930,7 @@ program2.option("-p, --pro", "Use Claude Opus 5.5 (most capable)").option("-t, -
     }
     effort = lvl;
   }
-  await startChatSession({ model, workDir, prompt: prompt2, resume, continueLast: !!options.continue, initialMode: modeRes.mode, lockMode: modeRes.locked, debug: !!options.debug || debugFile !== void 0, debugFile, fallbackModel, maxTurns, onlyTools, newSessionId, sessionName, forkSession: !!options.forkSession, stdinText, stdinFollowUps, showBanner, outputFormat, effort, audit: options.audit, worktree, fullscreen: !!options.fullscreen, strictPermissions: options.permissionMode !== void 0, budgetUsd, appendSystemPrompt, mcpOverride, strictMcp: !!options.strictMcpConfig, systemPrompt: sysPrompt.value, verbose: !!options.verbose, includePartialMessages: !!options.includePartialMessages, replayUserMessages: !!options.replayUserMessages, inputFormatWasStreamJson: options.inputFormat !== void 0 && String(options.inputFormat).toLowerCase() === "stream-json", bare: !!(options.bare || options.safeMode), noSessionPersistence: options.sessionPersistence === false, addDirs: addDirs.value, jsonSchema });
+  await startChatSession({ model, workDir, prompt: prompt2, resume, continueLast: !!options.continue, initialMode: modeRes.mode, lockMode: modeRes.locked, debug: !!options.debug || debugFile !== void 0, debugFile, fallbackModel, maxTurns, onlyTools, newSessionId, sessionName, forkSession: !!options.forkSession, stdinText, stdinFollowUps, showBanner, outputFormat, effort, audit: options.audit, worktree, fullscreen: !!options.fullscreen, strictPermissions: options.permissionMode !== void 0, budgetUsd, appendSystemPrompt, mcpOverride, strictMcp: !!options.strictMcpConfig, systemPrompt: sysPrompt.value, verbose: !!options.verbose, includePartialMessages: !!options.includePartialMessages, agents: agentsParsed.value, selectedAgent: selectedAgent ? { name: selectedAgent.name, prompt: selectedAgent.prompt, tools: selectedAgent.tools, model: selectedAgent.model } : void 0, replayUserMessages: !!options.replayUserMessages, inputFormatWasStreamJson: options.inputFormat !== void 0 && String(options.inputFormat).toLowerCase() === "stream-json", bare: !!(options.bare || options.safeMode), noSessionPersistence: options.sessionPersistence === false, addDirs: addDirs.value, jsonSchema });
 });
 program2.parse();
 /*! Bundled license information:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexrall-code",
-  "version": "0.5.162",
+  "version": "0.5.164",
   "description": "Nexrall Code — AI coding assistant for your terminal (headless agent for scripts, CI and automation)",
   "keywords": [
     "ai",