nexrall-code 0.5.178 → 0.5.179

package/dist/index.js

@@ -106714,6 +106714,8 @@ var require_hooks = __commonJS({
     exports2.formatHookDeliveries = formatHookDeliveries2;
     exports2.resetHookOnceState = resetHookOnceState2;
     exports2.setHookMcpCaller = setHookMcpCaller2;
+    exports2.setHookEventListener = setHookEventListener2;
+    exports2.hasHookEventListener = hasHookEventListener;
     exports2.parsePromptHookReply = parsePromptHookReply;
     exports2.hookRunOptsFor = hookRunOptsFor;
     exports2.classifyStopFailure = classifyStopFailure;
@@ -106722,6 +106724,8 @@ var require_hooks = __commonJS({
     exports2.runSimpleHooks = runSimpleHooks;
     exports2.runLifecycleHooks = runLifecycleHooks;
     exports2.runPermissionRequestHooks = runPermissionRequestHooks3;
+    exports2.runElicitationHooks = runElicitationHooks2;
+    exports2.runElicitationResultHooks = runElicitationResultHooks2;
     exports2.fireObserverHook = fireObserverHook3;
     exports2.fireNotificationHooks = fireNotificationHooks2;
     exports2.fireManualPostCompactHook = fireManualPostCompactHook2;
@@ -106806,7 +106810,9 @@ var require_hooks = __commonJS({
       "Setup",
       "PostToolBatch",
       "TaskCreated",
-      "TaskCompleted"
+      "TaskCompleted",
+      "Elicitation",
+      "ElicitationResult"
     ];
     function toHookEntries(list) {
       return list.map((it) => {
@@ -106877,6 +106883,95 @@ ${d.text}
     function setHookMcpCaller2(fn) {
       _hookMcpCaller = fn;
     }
+    var _hookEventListener = null;
+    function setHookEventListener2(fn) {
+      _hookEventListener = fn;
+    }
+    function hasHookEventListener() {
+      return _hookEventListener !== null;
+    }
+    var _hookIdSeq = 0;
+    function emitHookLifecycle(evt) {
+      try {
+        _hookEventListener?.(evt);
+      } catch {
+      }
+    }
+    function hookDisplayName(hook) {
+      if (hook.type === "http")
+        return String(hook.url ?? "http");
+      if (hook.type === "mcp_tool")
+        return `${String(hook.server ?? "")}:${String(hook.tool ?? "")}`;
+      if (hook.type === "prompt" || hook.type === "agent")
+        return hook.type;
+      return String(hook.command ?? "command");
+    }
+    var HOOK_PROGRESS_AFTER_MS = 1e3;
+    var HOOK_PROGRESS_FLUSH_MS = 250;
+    async function runWithHookEvents(hook, event, run) {
+      if (!_hookEventListener)
+        return run(void 0);
+      const hookId = `hook_${Date.now().toString(36)}_${(++_hookIdSeq).toString(36)}`;
+      const hookName = hookDisplayName(hook);
+      const startedAt = Date.now();
+      emitHookLifecycle({ kind: "started", hookId, hookName, hookEvent: event });
+      let pendingOut = "";
+      let pendingErr = "";
+      let lastFlush = 0;
+      let flushTimer = null;
+      const flush = () => {
+        flushTimer = null;
+        if (!pendingOut && !pendingErr)
+          return;
+        const stdout2 = pendingOut, stderr2 = pendingErr;
+        pendingOut = "";
+        pendingErr = "";
+        lastFlush = Date.now();
+        emitHookLifecycle({ kind: "progress", hookId, hookName, hookEvent: event, stdout: stdout2, stderr: stderr2, output: stdout2 + stderr2 });
+      };
+      const onData = (d) => {
+        if (Date.now() - startedAt < HOOK_PROGRESS_AFTER_MS)
+          return;
+        if (d.stdout)
+          pendingOut += d.stdout;
+        if (d.stderr)
+          pendingErr += d.stderr;
+        if (!pendingOut && !pendingErr)
+          return;
+        const since = Date.now() - lastFlush;
+        if (since >= HOOK_PROGRESS_FLUSH_MS)
+          flush();
+        else if (!flushTimer)
+          flushTimer = setTimeout(flush, HOOK_PROGRESS_FLUSH_MS - since);
+      };
+      let r2;
+      try {
+        r2 = await run(onData);
+      } catch (err) {
+        if (flushTimer)
+          clearTimeout(flushTimer);
+        const message = err?.message ?? String(err);
+        emitHookLifecycle({ kind: "response", hookId, hookName, hookEvent: event, stdout: "", stderr: message, output: message, outcome: "error" });
+        throw err;
+      }
+      if (flushTimer)
+        clearTimeout(flushTimer);
+      const stdout = r2.stdout ?? "";
+      const stderr = r2.stderr ?? "";
+      emitHookLifecycle({
+        kind: "response",
+        hookId,
+        hookName,
+        hookEvent: event,
+        stdout,
+        stderr,
+        output: [stdout.trim(), stderr.trim()].filter(Boolean).join("\n"),
+        // status null = killed / never exited (spawnHook's timeout path) — there is no exit code to report.
+        ...r2.status === null ? {} : { exitCode: r2.status },
+        outcome: r2.status === 0 ? "success" : r2.status === null ? "cancelled" : "error"
+      });
+      return r2;
+    }
     function isBackgroundHook(hook) {
       return hook.type === "command" && (hook.async === true || hook.asyncRewake === true);
     }
@@ -106909,7 +107004,7 @@ ${d.text}
         if (context)
           _hookDeliveries.push({ kind: "context", text: context, source: opts.eventLabel });
       };
-      void spawnHook(String(hook.command ?? ""), { cwd: opts.cwd, timeout: opts.timeoutMs, input: payload, env: opts.env }).then(done, () => done({ status: null, stdout: "", stderr: "" }));
+      void runHookHandler(hook, payload, { cwd: opts.cwd, timeoutMs: opts.timeoutMs, env: opts.env, event: opts.event }).then(done, () => done({ status: null, stdout: "", stderr: "" }));
     }
     function directiveContext(out) {
       if (!out.startsWith("{"))
@@ -106955,12 +107050,16 @@ ${d.text}
         }, opts.timeout);
         const cap = 16 * 1024 * 1024;
         child.stdout?.on("data", (d) => {
+          const s2 = d.toString("utf-8");
           if (stdout.length < cap)
-            stdout += d.toString("utf-8");
+            stdout += s2;
+          opts.onData?.({ stdout: s2 });
         });
         child.stderr?.on("data", (d) => {
+          const s2 = d.toString("utf-8");
           if (stderr.length < cap)
-            stderr += d.toString("utf-8");
+            stderr += s2;
+          opts.onData?.({ stderr: s2 });
         });
         child.on("error", () => done(null));
         child.on("close", (code) => done(code));
@@ -107068,14 +107167,16 @@ ${d.text}
       return out;
     }
     async function runHookHandler(hook, payload, opts) {
-      if (hook.type === "http")
-        return httpHook(hook, payload, opts.timeoutMs);
-      if (hook.type === "mcp_tool")
-        return mcpToolHook(hook, payload);
-      if (hook.type === "prompt" || hook.type === "agent") {
-        return promptHook(hook, payload, { ...opts, envCtx: opts.hookEnv });
-      }
-      return spawnHook(String(hook.command ?? ""), { cwd: opts.cwd, timeout: opts.timeoutMs, input: payload, env: opts.env });
+      return runWithHookEvents(hook, opts.event ?? "hook", (onData) => {
+        if (hook.type === "http")
+          return httpHook(hook, payload, opts.timeoutMs ?? 6e4);
+        if (hook.type === "mcp_tool")
+          return mcpToolHook(hook, payload);
+        if (hook.type === "prompt" || hook.type === "agent") {
+          return promptHook(hook, payload, { ...opts, timeoutMs: opts.timeoutMs ?? 6e4, envCtx: opts.hookEnv });
+        }
+        return spawnHook(String(hook.command ?? ""), { cwd: opts.cwd, timeout: opts.timeoutMs, input: payload, env: opts.env, onData });
+      });
     }
     var HOOK_AGENT_TOOLS = [
       {
@@ -107318,6 +107419,7 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
               cwd: workDir,
               env: hookEnv,
               eventLabel,
+              event: phase,
               timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 6e4) : null,
               key: gate.key
             });
@@ -107327,6 +107429,7 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
             cwd: workDir,
             timeoutMs: hookTimeoutMs(hook, 6e4),
             env: hookEnv,
+            event: phase,
             ...hookOpts
           });
           const out = (r2.stdout ?? "").toString().trim();
@@ -107367,10 +107470,10 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
         if (gate.skip)
           continue;
         if (gate.background) {
-          startBackgroundHook(hook, "", { cwd: workDir, env: env4, eventLabel: event, timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 1e4) : null, key: gate.key });
+          startBackgroundHook(hook, "", { cwd: workDir, env: env4, eventLabel: event, event, timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 1e4) : null, key: gate.key });
           continue;
         }
-        const r2 = await runHookHandler(hook, "", { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 1e4), env: env4, ...hookOpts });
+        const r2 = await runHookHandler(hook, "", { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 1e4), env: env4, event, ...hookOpts });
         if (gate.statusId !== void 0)
           hookStatusEnd(gate.statusId);
         if (r2.status === 0 && gate.key)
@@ -107421,13 +107524,14 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
             cwd: workDir,
             env: { ...process.env, NEXRALL_HOOK_PHASE: event },
             eventLabel: event,
+            event,
             timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 6e4) : null,
             key: gate.key
           });
           continue;
         }
         const timeout = hookTimeoutMs(hook, hook.type === "agent" ? 6e4 : hook.type === "prompt" ? 3e4 : 3e4);
-        const r2 = await runHookHandler(hook, input, { cwd: workDir, timeoutMs: timeout, env: { ...process.env, NEXRALL_HOOK_PHASE: event }, ...hookOpts });
+        const r2 = await runHookHandler(hook, input, { cwd: workDir, timeoutMs: timeout, env: { ...process.env, NEXRALL_HOOK_PHASE: event }, event, ...hookOpts });
         const out = (r2.stdout ?? "").toString().trim();
         if (out.startsWith("{")) {
           try {
@@ -107481,6 +107585,106 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
       }
       return { answer: null };
     }
+    function parseElicitationAnswer(stdout) {
+      const out = stdout.trim();
+      if (!out.startsWith("{"))
+        return null;
+      try {
+        const j = JSON.parse(out);
+        const src = j.hookSpecificOutput ?? j;
+        if (src.action !== "accept" && src.action !== "decline" && src.action !== "cancel")
+          return null;
+        const content = src.content && typeof src.content === "object" && !Array.isArray(src.content) ? src.content : void 0;
+        return content ? { action: src.action, content } : { action: src.action };
+      } catch {
+        return null;
+      }
+    }
+    async function runElicitationHooks2(workDir, server, input, sessionId = "") {
+      try {
+        const items = loadHooks2(workDir).Elicitation;
+        if (!items?.length)
+          return null;
+        const defs = flattenHookDefs(items, server);
+        if (!defs.length)
+          return null;
+        const payload = JSON.stringify({ session_id: sessionId, cwd: workDir, hook_event_name: "Elicitation", mcp_server_name: server, ...input });
+        for (const hook of defs) {
+          if (!isRunnableHook(hook))
+            continue;
+          const gate = hookGate(hook, "Elicitation", server, workDir);
+          if (gate.skip)
+            continue;
+          if (gate.background) {
+            startBackgroundHook(hook, payload, { cwd: workDir, env: { ...process.env, NEXRALL_HOOK_PHASE: "Elicitation" }, eventLabel: "Elicitation", event: "Elicitation", timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 6e4) : null, key: gate.key });
+            continue;
+          }
+          const r2 = await runHookHandler(hook, payload, { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 3e4), env: { ...process.env, NEXRALL_HOOK_PHASE: "Elicitation" }, event: "Elicitation" });
+          if (gate.statusId !== void 0)
+            hookStatusEnd(gate.statusId);
+          if (r2.status === 0 && gate.key)
+            _hookOnceDone.add(gate.key);
+          if (r2.status === 2)
+            return { action: "decline" };
+          const answer = parseElicitationAnswer((r2.stdout ?? "").toString());
+          if (answer)
+            return answer;
+        }
+      } catch {
+      }
+      return null;
+    }
+    async function runElicitationResultHooks2(workDir, server, answer, meta = {}) {
+      try {
+        const items = loadHooks2(workDir).ElicitationResult;
+        if (!items?.length)
+          return answer;
+        const defs = flattenHookDefs(items, server);
+        if (!defs.length)
+          return answer;
+        let current = answer;
+        for (const hook of defs) {
+          if (!isRunnableHook(hook))
+            continue;
+          const gate = hookGate(hook, "ElicitationResult", server, workDir);
+          if (gate.skip)
+            continue;
+          const payload = JSON.stringify({
+            session_id: meta.sessionId ?? "",
+            cwd: workDir,
+            hook_event_name: "ElicitationResult",
+            mcp_server_name: server,
+            action: current.action,
+            content: current.content,
+            mode: meta.mode,
+            elicitation_id: meta.elicitationId
+          });
+          if (gate.background) {
+            startBackgroundHook(hook, payload, { cwd: workDir, env: { ...process.env, NEXRALL_HOOK_PHASE: "ElicitationResult" }, eventLabel: "ElicitationResult", event: "ElicitationResult", timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 6e4) : null, key: gate.key });
+            continue;
+          }
+          const r2 = await runHookHandler(hook, payload, { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 3e4), env: { ...process.env, NEXRALL_HOOK_PHASE: "ElicitationResult" }, event: "ElicitationResult" });
+          if (gate.statusId !== void 0)
+            hookStatusEnd(gate.statusId);
+          if (r2.status === 0 && gate.key)
+            _hookOnceDone.add(gate.key);
+          if (r2.status === 2)
+            return { action: "decline" };
+          const override = parseElicitationAnswer((r2.stdout ?? "").toString());
+          if (override) {
+            if (override.action === "accept") {
+              const content = override.content ?? (current.action === "accept" ? current.content : void 0);
+              current = content ? { action: "accept", content } : { action: "accept" };
+            } else {
+              current = { action: override.action };
+            }
+          }
+        }
+        return current;
+      } catch {
+        return answer;
+      }
+    }
     async function fireObserverHook3(workDir, event, payload, matchValue) {
       try {
         const items = loadHooks2(workDir)[event];
@@ -109492,8 +109696,8 @@ var require_loop = __commonJS({
   "../core/dist/agent/loop.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.createLimiter = exports2.resolveMaxSubagentsPerSession = exports2.resolveMaxConcurrentSubtasks = exports2.lockPathsFor = exports2.resolveMaxIterations = exports2.stopReasonNotice = exports2.executeAgentMemoryWrite = exports2.AGENT_MEMORY_TOOL_SCHEMA = exports2.AGENT_MEMORY_TOOL = exports2._stallLimits = exports2.errorRoundSignature = exports2._emptyTurnRetry = exports2.shouldRetryEmptyTurn = exports2.emptyTurnBackoffMs = exports2.compactMessagesForResume = exports2.estimateTokensRough = exports2.makeCachedSummarizer = exports2.pruneOldToolResults = exports2.ledgerSummary = exports2.ledgerRecord = exports2.createLedger = exports2.transcriptOf = exports2.persistRuntimeContext = exports2.findSafeCutIndex = exports2.VERIFY_CMD_RE = exports2.allowsTestOnlyWrite = exports2.WRITE_TOOL_NAMES = exports2.estimateBodyBytes = exports2.pruneReclaimFloor = exports2.compactionThresholds = exports2.compactionLimits = exports2.contextWindowFor = exports2.resetHookOnceState = exports2.setHookMcpCaller = exports2.setHookStatusListener = exports2.setHookWakeListener = exports2.formatHookDeliveries = exports2.hasPendingHookWake = exports2.takeHookWakes = exports2.drainHookDeliveries = exports2.fireObserverHook = exports2.fireManualPreCompactHook = exports2.fireManualPostCompactHook = exports2.fireNotificationHooks = exports2.runPermissionRequestHooks = exports2.runLifecycleHooks = exports2.classifyStopFailure = exports2.parsePromptHookReply = exports2.loadHooks = exports2.bashNeedsRepoLock = void 0;
-    exports2.lastToolResults = exports2.summariseSubTaskProgress = exports2.capSubTaskText = exports2.extractSubTaskText = exports2.ToolNotAllowedError = exports2.resolveSubtaskTimeoutMs = exports2.canSpawnSubAgents = exports2.intersectAllowlists = exports2.noSpawnReason = exports2.resolveMaxSubagentDepth = exports2._sessionSubAgentCount = exports2.resetSessionSubAgentBudget = exports2._resetSubTaskLimiter = void 0;
+    exports2.resolveMaxIterations = exports2.stopReasonNotice = exports2.executeAgentMemoryWrite = exports2.AGENT_MEMORY_TOOL_SCHEMA = exports2.AGENT_MEMORY_TOOL = exports2._stallLimits = exports2.errorRoundSignature = exports2._emptyTurnRetry = exports2.shouldRetryEmptyTurn = exports2.emptyTurnBackoffMs = exports2.compactMessagesForResume = exports2.estimateTokensRough = exports2.makeCachedSummarizer = exports2.pruneOldToolResults = exports2.ledgerSummary = exports2.ledgerRecord = exports2.createLedger = exports2.transcriptOf = exports2.persistRuntimeContext = exports2.findSafeCutIndex = exports2.VERIFY_CMD_RE = exports2.allowsTestOnlyWrite = exports2.WRITE_TOOL_NAMES = exports2.estimateBodyBytes = exports2.pruneReclaimFloor = exports2.compactionThresholds = exports2.compactionLimits = exports2.contextWindowFor = exports2.runElicitationResultHooks = exports2.runElicitationHooks = exports2.hasHookEventListener = exports2.setHookEventListener = exports2.resetHookOnceState = exports2.setHookMcpCaller = exports2.setHookStatusListener = exports2.setHookWakeListener = exports2.formatHookDeliveries = exports2.hasPendingHookWake = exports2.takeHookWakes = exports2.drainHookDeliveries = exports2.fireObserverHook = exports2.fireManualPreCompactHook = exports2.fireManualPostCompactHook = exports2.fireNotificationHooks = exports2.runPermissionRequestHooks = exports2.runLifecycleHooks = exports2.classifyStopFailure = exports2.parsePromptHookReply = exports2.loadHooks = exports2.bashNeedsRepoLock = void 0;
+    exports2.lastToolResults = exports2.summariseSubTaskProgress = exports2.capSubTaskText = exports2.extractSubTaskText = exports2.ToolNotAllowedError = exports2.resolveSubtaskTimeoutMs = exports2.canSpawnSubAgents = exports2.intersectAllowlists = exports2.noSpawnReason = exports2.resolveMaxSubagentDepth = exports2._sessionSubAgentCount = exports2.resetSessionSubAgentBudget = exports2._resetSubTaskLimiter = exports2.createLimiter = exports2.resolveMaxSubagentsPerSession = exports2.resolveMaxConcurrentSubtasks = exports2.lockPathsFor = void 0;
     exports2.dispatchSubAgent = dispatchSubAgent;
     exports2.dispatchBackgroundSubAgent = dispatchBackgroundSubAgent;
     exports2.runAgentLoop = runAgentLoop2;
@@ -109576,6 +109780,18 @@ var require_loop = __commonJS({
     Object.defineProperty(exports2, "resetHookOnceState", { enumerable: true, get: function() {
       return hooks_2.resetHookOnceState;
     } });
+    Object.defineProperty(exports2, "setHookEventListener", { enumerable: true, get: function() {
+      return hooks_2.setHookEventListener;
+    } });
+    Object.defineProperty(exports2, "hasHookEventListener", { enumerable: true, get: function() {
+      return hooks_2.hasHookEventListener;
+    } });
+    Object.defineProperty(exports2, "runElicitationHooks", { enumerable: true, get: function() {
+      return hooks_2.runElicitationHooks;
+    } });
+    Object.defineProperty(exports2, "runElicitationResultHooks", { enumerable: true, get: function() {
+      return hooks_2.runElicitationResultHooks;
+    } });
     var compaction_1 = require_compaction();
     var compaction_2 = require_compaction();
     Object.defineProperty(exports2, "contextWindowFor", { enumerable: true, get: function() {
@@ -110893,9 +111109,12 @@ var require_client2 = __commonJS({
   "../core/dist/mcp/client.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.McpClient = void 0;
+    exports2.McpClient = exports2.MCP_ELICITATION_CAPABILITY = void 0;
     exports2.flattenResourceContents = flattenResourceContents;
     exports2.flattenPromptMessages = flattenPromptMessages;
+    exports2.elicitationCapability = elicitationCapability;
+    exports2.normalizeElicitationRequest = normalizeElicitationRequest;
+    exports2.serverRequestReply = serverRequestReply;
     var child_process_1 = __require("child_process");
     function flattenResourceContents(result, maxChars = 1e5) {
       const contents = result?.contents ?? [];
@@ -110935,6 +111154,39 @@ var require_client2 = __commonJS({
       return text.length > maxChars ? text.slice(0, maxChars) + `
 \u2026 [truncated, ${text.length - maxChars} more characters]` : text;
     }
+    exports2.MCP_ELICITATION_CAPABILITY = { elicitation: { form: {}, url: {} } };
+    function elicitationCapability(bare) {
+      return bare ? { elicitation: {} } : { elicitation: { form: {}, url: {} } };
+    }
+    function normalizeElicitationRequest(params) {
+      const p = params ?? {};
+      const url = typeof p.url === "string" ? p.url : void 0;
+      const schema = p.requestedSchema ?? p.schema;
+      return {
+        message: typeof p.message === "string" && p.message.trim() ? p.message : "An MCP server is asking for input.",
+        mode: p.mode === "url" || !p.mode && url ? "url" : "form",
+        requestedSchema: schema && typeof schema === "object" ? schema : void 0,
+        url,
+        elicitationId: typeof p.elicitationId === "string" ? p.elicitationId : typeof p.elicitation_id === "string" ? p.elicitation_id : void 0
+      };
+    }
+    async function serverRequestReply(server, handler, method, params) {
+      if (method === "elicitation/create") {
+        let resp = { action: "decline" };
+        const request = normalizeElicitationRequest(params);
+        try {
+          if (handler)
+            resp = await handler(server, request);
+        } catch {
+          resp = { action: "decline" };
+        }
+        const result = { action: resp.action };
+        if (resp.action === "accept" && resp.content)
+          result.content = resp.content;
+        return { result };
+      }
+      return { error: { code: -32601, message: `Method not found: ${method}` } };
+    }
     var McpClient = class {
       constructor(name, config) {
         this.config = config;
@@ -110943,11 +111195,15 @@ var require_client2 = __commonJS({
         this._pending = /* @__PURE__ */ new Map();
         this._buf = "";
         this._tools = [];
+        this._elicitationHandler = null;
         this.name = name;
       }
       get tools() {
         return this._tools;
       }
+      setElicitationHandler(handler) {
+        this._elicitationHandler = handler;
+      }
       async connect() {
         if (!this.config.command)
           throw new Error(`MCP server "${this.name}" has no command (stdio transport requires one).`);
@@ -110975,7 +111231,7 @@ var require_client2 = __commonJS({
         });
         await this._request("initialize", {
           protocolVersion: "2024-11-05",
-          capabilities: {},
+          capabilities: elicitationCapability(this.config.bareElicitationCapability),
           clientInfo: { name: "nexrall-code", version: "1.0" }
         });
         this._notify("notifications/initialized");
@@ -111056,6 +111312,10 @@ var require_client2 = __commonJS({
         } catch {
           return;
         }
+        if (typeof msg.method === "string" && msg.id != null) {
+          void this._handleServerRequest(msg.id, msg.method, msg.params);
+          return;
+        }
         if (msg.id == null)
           return;
         const pending = this._pending.get(msg.id);
@@ -111068,6 +111328,11 @@ var require_client2 = __commonJS({
           pending.resolve(msg.result);
         }
       }
+      /** Answer a server→client request. Errors are swallowed — the server must get SOME reply. */
+      async _handleServerRequest(id, method, params) {
+        const reply = await serverRequestReply(this.name, this._elicitationHandler, method, params);
+        this._send({ jsonrpc: "2.0", id, ...reply });
+      }
       _rejectAll(err) {
         for (const { reject } of this._pending.values())
           reject(err);
@@ -111106,17 +111371,21 @@ var require_httpClient = __commonJS({
         this._nextId = 1;
         this._tools = [];
         this._sessionId = null;
+        this._elicitationHandler = null;
         this.name = name;
       }
       get tools() {
         return this._tools;
       }
+      setElicitationHandler(handler) {
+        this._elicitationHandler = handler;
+      }
       async connect() {
         if (!this.config.url)
           throw new Error(`MCP server "${this.name}" has no url (http/sse transport requires one).`);
         await this._rpc("initialize", {
           protocolVersion: "2024-11-05",
-          capabilities: {},
+          capabilities: (0, client_1.elicitationCapability)(this.config.bareElicitationCapability),
           clientInfo: { name: "nexrall-code", version: "1.0" }
         });
         await this._notify("notifications/initialized");
@@ -111211,29 +111480,106 @@ var require_httpClient = __commonJS({
           throw new Error(`MCP HTTP ${resp.status} ${resp.statusText}${body ? `: ${body.slice(0, 200)}` : ""}`);
         }
         const contentType = resp.headers.get("content-type") ?? "";
+        if (contentType.includes("text/event-stream"))
+          return await this._consumeSse(resp, id);
         const text = await resp.text();
         if (!text.trim())
           return null;
-        const consume = (msg) => {
+        const msg = JSON.parse(text);
+        if (msg.error)
+          throw new Error(`MCP error ${msg.error.code}: ${msg.error.message}`);
+        return msg.result ?? null;
+      }
+      /**
+       * Read an SSE reply frame by frame. A server request (elicitation) is answered on the
+       * spot: the server WAITS for that answer before it sends our own result, so buffering
+       * the whole stream first would deadlock until the request timeout. As soon as our id
+       * arrives we stop and cancel the body (the stream may stay open for the session).
+       * Falls back to a buffered parse when the runtime hands us no readable body.
+       */
+      async _consumeSse(resp, id) {
+        const state = { have: false };
+        const handle2 = (msg) => {
+          if (typeof msg.method === "string" && msg.id != null) {
+            this._answerServerRequest(msg.id, msg.method, msg.params);
+            return;
+          }
+          if (msg.id !== id)
+            return;
           if (msg.error)
-            throw new Error(`MCP error ${msg.error.code}: ${msg.error.message}`);
-          return msg.result ?? null;
+            state.failure = new Error(`MCP error ${msg.error.code}: ${msg.error.message}`);
+          else {
+            state.result = msg.result ?? null;
+            state.have = true;
+          }
         };
-        if (contentType.includes("text/event-stream")) {
-          for (const frame of text.split(/\r?\n\r?\n/)) {
-            const dataLines = frame.split(/\r?\n/).filter((l2) => l2.startsWith("data:")).map((l2) => l2.slice(5).trim());
+        const body = resp.body;
+        if (body && typeof body[Symbol.asyncIterator] === "function") {
+          let buf = "";
+          const dataLines = [];
+          const flush = () => {
             if (!dataLines.length)
+              return;
+            const data = dataLines.join("\n");
+            dataLines.length = 0;
+            try {
+              handle2(JSON.parse(data));
+            } catch {
+            }
+          };
+          try {
+            for await (const chunk of body) {
+              buf += Buffer.from(chunk).toString("utf-8");
+              let nl;
+              while ((nl = buf.indexOf("\n")) !== -1) {
+                let line = buf.slice(0, nl);
+                buf = buf.slice(nl + 1);
+                if (line.endsWith("\r"))
+                  line = line.slice(0, -1);
+                if (!line) {
+                  flush();
+                  if (state.have || state.failure)
+                    break;
+                  continue;
+                }
+                if (line.startsWith("data:"))
+                  dataLines.push(line.slice(5).replace(/^ /, ""));
+              }
+              if (state.have || state.failure)
+                break;
+            }
+            flush();
+          } catch {
+          }
+          try {
+            await body.cancel?.();
+          } catch {
+          }
+        } else {
+          const text = await resp.text();
+          for (const frame of text.split(/\r?\n\r?\n/)) {
+            const data = frame.split(/\r?\n/).filter((l2) => l2.startsWith("data:")).map((l2) => l2.slice(5).trim()).join("\n");
+            if (!data)
               continue;
             try {
-              const msg = JSON.parse(dataLines.join("\n"));
-              if (msg.id === id)
-                return consume(msg);
+              handle2(JSON.parse(data));
             } catch {
             }
           }
-          throw new Error("No matching JSON-RPC response found in SSE stream");
         }
-        return consume(JSON.parse(text));
+        if (state.failure)
+          throw state.failure;
+        if (!state.have)
+          throw new Error("No matching JSON-RPC response found in SSE stream");
+        return state.result;
+      }
+      /** Reply to a server→client request. Fire-and-forget: the in-flight reader must not block. */
+      _answerServerRequest(id, method, params) {
+        void (async () => {
+          const reply = await (0, client_1.serverRequestReply)(this.name, this._elicitationHandler, method, params);
+          await this._post({ jsonrpc: "2.0", id, ...reply });
+        })().catch(() => {
+        });
       }
     };
     exports2.McpHttpClient = McpHttpClient;
@@ -111265,18 +111611,22 @@ var require_sseClient = __commonJS({
         this._closed = false;
         this._pending = /* @__PURE__ */ new Map();
         this._endpointWaiter = null;
+        this._elicitationHandler = null;
         this.name = name;
       }
       get tools() {
         return this._tools;
       }
+      setElicitationHandler(handler) {
+        this._elicitationHandler = handler;
+      }
       async connect() {
         if (!this.config.url)
           throw new Error(`MCP server "${this.name}" has no url (sse transport requires one).`);
         await this._openStream();
         await this._rpc("initialize", {
           protocolVersion: "2024-11-05",
-          capabilities: {},
+          capabilities: (0, client_1.elicitationCapability)(this.config.bareElicitationCapability),
           clientInfo: { name: "nexrall-code", version: "1.0" }
         });
         await this._notify("notifications/initialized");
@@ -111429,6 +111779,17 @@ var require_sseClient = __commonJS({
         } catch {
           return;
         }
+        if (typeof msg.method === "string" && msg.id != null) {
+          const method = msg.method;
+          const params = msg.params;
+          const reqId = msg.id;
+          void (async () => {
+            const reply = await (0, client_1.serverRequestReply)(this.name, this._elicitationHandler, method, params);
+            await this._postMessage({ jsonrpc: "2.0", id: reqId, ...reply });
+          })().catch(() => {
+          });
+          return;
+        }
         if (typeof msg.id === "number" && this._pending.has(msg.id)) {
           const { resolve: resolve12, reject, timer } = this._pending.get(msg.id);
           clearTimeout(timer);
@@ -111437,6 +111798,7 @@ var require_sseClient = __commonJS({
             reject(new Error(`MCP error ${msg.error.code}: ${msg.error.message}`));
           else
             resolve12(msg.result ?? null);
+          return;
         }
       }
       _rpc(method, params) {
@@ -111658,6 +112020,17 @@ var require_manager = __commonJS({
         this._needsAuth = /* @__PURE__ */ new Map();
         this._disabled = /* @__PURE__ */ new Set();
         this.stats = new stats_1.ToolStats();
+        this._elicitationHandler = null;
+      }
+      /**
+       * Route every server's elicitation (`elicitation/create`) through this handler —
+       * including servers that connect later, which is why it is also re-applied in
+       * connectAll/enable. Pass null to restore auto-decline.
+       */
+      setElicitationHandler(handler) {
+        this._elicitationHandler = handler;
+        for (const client of this._clients.values())
+          client.setElicitationHandler(handler);
       }
       /** Pick the transport for a server config: stdio (command), Streamable HTTP, or legacy SSE. */
       static makeClient(name, cfg) {
@@ -111703,6 +112076,7 @@ var require_manager = __commonJS({
             return;
           }
           const client = _McpManager.makeClient(name, serverCfg);
+          client.setElicitationHandler(this._elicitationHandler);
           try {
             await client.connect();
             this._clients.set(name, client);
@@ -111962,6 +112336,7 @@ var require_manager = __commonJS({
           return `no server named "${name}" is configured`;
         this._dropClient(name);
         const client = _McpManager.makeClient(name, cfg);
+        client.setElicitationHandler(this._elicitationHandler);
         try {
           await client.connect();
         } catch (err) {
@@ -153147,6 +153522,14 @@ function checkPartialMessages(f3) {
   }
   return null;
 }
+function checkHookEvents(f3) {
+  if (!f3.includeHookEvents)
+    return null;
+  if (f3.outputFormat !== "stream-json") {
+    return "--include-hook-events needs --output-format stream-json (hook lifecycle events are part of the JSON stream).";
+  }
+  return null;
+}
 function checkReplayUserMessages(f3) {
   if (!f3.replay)
     return null;
@@ -153177,6 +153560,29 @@ function initEventPayload(i2) {
 function userReplayPayload(text) {
   return { type: "user", message: { role: "user", content: [{ type: "text", text }] } };
 }
+function hookEventPayload(e2) {
+  const base = {
+    type: "system",
+    subtype: `hook_${e2.kind}`,
+    hook_id: e2.hookId,
+    hook_name: e2.hookName,
+    hook_event: e2.hookEvent,
+    uuid: e2.uuid,
+    session_id: e2.sessionId
+  };
+  if (e2.kind === "started")
+    return base;
+  if (e2.kind === "progress")
+    return { ...base, stdout: e2.stdout ?? "", stderr: e2.stderr ?? "", output: e2.output ?? "" };
+  return {
+    ...base,
+    output: e2.output ?? "",
+    stdout: e2.stdout ?? "",
+    stderr: e2.stderr ?? "",
+    ...e2.exitCode !== void 0 ? { exit_code: e2.exitCode } : {},
+    outcome: e2.outcome ?? "error"
+  };
+}
 function parseAgentsArg(raw, cwd2) {
   if (raw === void 0)
     return { ok: true, value: [] };
@@ -156636,6 +157042,117 @@ function currentAudit() {
 
 // src/commands/chat.ts
 var import_code_core19 = __toESM(require_dist3(), 1);
+
+// src/ui/mcpElicit.ts
+function fieldsOf(schema) {
+  const props = schema?.properties ?? {};
+  const required = new Set(Array.isArray(schema?.required) ? schema.required.map(String) : []);
+  return Object.entries(props).map(([name, p]) => ({
+    name,
+    title: typeof p.title === "string" ? p.title : name,
+    description: typeof p.description === "string" ? p.description : void 0,
+    type: typeof p.type === "string" ? p.type : "string",
+    enumValues: Array.isArray(p.enum) ? p.enum : void 0,
+    required: required.has(name)
+  }));
+}
+function coerce(raw, type) {
+  if (type === "number" || type === "integer") {
+    const n = type === "integer" ? parseInt(raw, 10) : Number(raw);
+    return Number.isFinite(n) ? { ok: true, value: n } : { ok: false };
+  }
+  return { ok: true, value: raw };
+}
+async function elicitForm(server, req, io) {
+  const fields = fieldsOf(req.requestedSchema);
+  io.print(paint.dim(`  ${server} asks: ${truncateCells(req.message, 300)}`));
+  if (!fields.length) {
+    const idx = await io.choose({
+      title: `${server} is asking for your confirmation`,
+      // The 'n'-keyed option is what Esc / Ctrl+C resolve to (choiceBox.denyIndex).
+      options: [{ key: "y", label: "Continue" }, { key: "n", label: "Decline" }, { key: "c", label: "Cancel" }]
+    });
+    if (idx < 0)
+      return { action: "decline" };
+    return idx === 0 ? { action: "accept", content: {} } : { action: idx === 1 ? "decline" : "cancel" };
+  }
+  const content = {};
+  for (const f3 of fields) {
+    const label = f3.title + (f3.required ? "" : " (optional)");
+    if (f3.enumValues?.length) {
+      const options = f3.enumValues.map((v, i2) => ({ key: String(i2 + 1), label: String(v) }));
+      options.push({ key: "n", label: "\u2014 decline \u2014" }, { key: "c", label: "\u2014 cancel \u2014" });
+      const idx = await io.choose({ title: `${server}: ${label}`, detail: f3.description, options });
+      if (idx < 0)
+        return { action: "decline" };
+      if (idx === f3.enumValues.length)
+        return { action: "decline" };
+      if (idx === f3.enumValues.length + 1)
+        return { action: "cancel" };
+      content[f3.name] = f3.enumValues[idx];
+      continue;
+    }
+    if (f3.type === "boolean") {
+      const idx = await io.choose({
+        title: `${server}: ${label}`,
+        detail: f3.description,
+        // Esc means "leave the form", NOT "answer false" — a silent wrong answer is worse
+        // than a dismissal, so 'n' is the decline sentinel here too.
+        options: [
+          { key: "y", label: "Yes" },
+          { key: "f", label: "No" },
+          { key: "n", label: "\u2014 decline \u2014" },
+          { key: "c", label: "\u2014 cancel \u2014" }
+        ]
+      });
+      if (idx < 0 || idx === 2)
+        return { action: "decline" };
+      if (idx === 3)
+        return { action: "cancel" };
+      content[f3.name] = idx === 0;
+      continue;
+    }
+    const raw = (await io.line(`  ${server}: ${label}${f3.description ? ` \u2014 ${f3.description}` : ""}: `)).trim();
+    if (!raw) {
+      if (f3.required)
+        return { action: "decline" };
+      continue;
+    }
+    const c = coerce(raw, f3.type);
+    if (!c.ok) {
+      io.print(paint.yellow(`  ${server}: "${raw}" is not a ${f3.type} \u2014 declining.`));
+      return { action: "decline" };
+    }
+    content[f3.name] = c.value;
+  }
+  return { action: "accept", content };
+}
+async function elicitUrl(server, req, io) {
+  if (!req.url)
+    return { action: "decline" };
+  io.print(paint.dim(`  ${server} asks: ${truncateCells(req.message, 300)}`));
+  const idx = await io.choose({
+    title: `${server} needs you to open a page`,
+    detail: truncateCells(req.url, 120),
+    options: [{ key: "o", label: "Open in browser" }, { key: "n", label: "Decline" }, { key: "c", label: "Cancel" }]
+  });
+  if (idx < 0)
+    return { action: "decline" };
+  if (idx === 0) {
+    io.openUrl(req.url);
+    return { action: "accept" };
+  }
+  return { action: idx === 1 ? "decline" : "cancel" };
+}
+async function elicit(server, req, io) {
+  try {
+    return req.mode === "url" ? await elicitUrl(server, req, io) : await elicitForm(server, req, io);
+  } catch {
+    return { action: "decline" };
+  }
+}
+
+// src/commands/chat.ts
 var import_code_core20 = __toESM(require_dist3(), 1);
 
 // src/debugLog.ts
@@ -173077,6 +173594,7 @@ function nextBackgroundChange() {
 }
 var _mcpManager = null;
 var _askIO = null;
+var _elicitationHandler = null;
 var _mcpConfig = null;
 var sessionTouched = [];
 async function initMcp(workDir, override, strict) {
@@ -173099,6 +173617,7 @@ async function initMcp(workDir, override, strict) {
   } catch {
   }
   const manager = new import_code_core18.McpManager();
+  manager.setElicitationHandler(_elicitationHandler);
   await manager.connectAll(_mcpConfig);
   _mcpManager = manager;
   wireHookMcpCaller();
@@ -173114,6 +173633,33 @@ function wireHookMcpCaller() {
     return text === null ? { error: `MCP server "${server}" has no tool "${tool}" (or the server is not connected)` } : { text };
   });
 }
+async function handleElicitation(server, req, workDir, getSessionId, interactive) {
+  const hookAnswer = await (0, import_code_core19.runElicitationHooks)(workDir, server, {
+    message: req.message,
+    mode: req.mode,
+    url: req.url,
+    elicitation_id: req.elicitationId,
+    requested_schema: req.requestedSchema
+  }, getSessionId());
+  let answer;
+  if (hookAnswer)
+    answer = hookAnswer;
+  else if (!interactive || !_askIO)
+    answer = { action: "decline" };
+  else {
+    answer = await elicit(server, req, {
+      choose: _askIO.choose,
+      line: _askIO.line,
+      print: (t2) => console.log(t2),
+      openUrl: (url) => openInBrowser(url)
+    });
+  }
+  return await (0, import_code_core19.runElicitationResultHooks)(workDir, server, answer, {
+    sessionId: getSessionId(),
+    mode: req.mode,
+    elicitationId: req.elicitationId
+  });
+}
 function formatAgentsList(workDir) {
   const { types: types3, warnings } = (0, import_code_core18.loadAgentTypesWithWarnings)(workDir);
   if (!types3.length)
@@ -174408,6 +174954,13 @@ Resume it with: nex --worktree ${worktreeState.name}
   _headlessPolicy.verbose = !!options.verbose;
   _headlessPolicy.includePartial = !!options.includePartialMessages;
   _headlessPolicy.permissionMode = String(options.initialMode ?? "");
+  const streamHookEvents = options.outputFormat === "stream-json";
+  const allHookEvents = !!options.includeHookEvents;
+  (0, import_code_core19.setHookEventListener)(streamHookEvents ? (evt) => {
+    if (!allHookEvents && evt.hookEvent !== "SessionStart" && evt.hookEvent !== "Setup")
+      return;
+    process.stdout.write(JSON.stringify(hookEventPayload({ ...evt, sessionId: activeSessionIdGetter() ?? "", uuid: crypto7.randomUUID() })) + "\n");
+  } : null);
   const saveSession2 = options.noSessionPersistence ? () => {
   } : saveSession;
   const interactive = !headless && !options.prompt && !options.stdinText;
@@ -174530,6 +175083,7 @@ Resume it with: nex --worktree ${worktreeState.name}
     setExcludedPatterns(contextSet.excluded);
     console.log((edit.ok ? paint.green : paint.yellow)("  " + edit.message));
   };
+  _elicitationHandler = (server, req) => handleElicitation(server, req, workDir, () => sessionId, interactive);
   const mcpStarted = (async () => {
     try {
       await initMcp(workDir, options.mcpOverride, options.strictMcp);
@@ -178557,7 +179111,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("--print", "One-shot, non-interactive run that prints the answer and exits (same as --output-format text). Claude Code's `-p` is spelled --print here because `-p` already means --pro").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 | dontAsk | 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("--permission-prompt-tool <t>", "MCP tool (mcp__server__tool) that answers permission prompts in non-interactive runs \u2014 instead of nex denying them").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) => {
+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("--print", "One-shot, non-interactive run that prints the answer and exits (same as --output-format text). Claude Code's `-p` is spelled --print here because `-p` already means --pro").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 | dontAsk | 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("--permission-prompt-tool <t>", "MCP tool (mcp__server__tool) that answers permission prompts in non-interactive runs \u2014 instead of nex denying them").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("--include-hook-events", "Include hook lifecycle events in the stream-json output (system: hook_started / hook_progress / hook_response)").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_core22.isAuthenticated)()) {
     console.error("Not logged in. Run: nex auth");
     process.exit(1);
@@ -178829,6 +179383,11 @@ program2.option("-p, --pro", "Use Claude Opus 5.5 (most capable)").option("-t, -
     console.error(partialErr);
     process.exit(1);
   }
+  const hookEventsErr = checkHookEvents({ includeHookEvents: !!options.includeHookEvents, outputFormat });
+  if (hookEventsErr) {
+    console.error(hookEventsErr);
+    process.exit(1);
+  }
   const replayErr = checkReplayUserMessages({ replay: !!options.replayUserMessages, inputFormat: options.inputFormat, outputFormat });
   if (replayErr) {
     console.error(replayErr);
@@ -178853,7 +179412,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, 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, permissionPromptTool });
+  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, includeHookEvents: !!options.includeHookEvents, 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, permissionPromptTool });
 });
 program2.parse();
 /*! Bundled license information:

package/package.json

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