nexrall-code 0.5.177 → 0.5.178

package/dist/index.js

@@ -14343,6 +14343,7 @@ var require_sharedTasks = __commonJS({
     exports2.createSharedTask = createSharedTask;
     exports2.claimTask = claimTask;
     exports2.updateSharedTaskStatus = updateSharedTaskStatus;
+    exports2.deleteSharedTask = deleteSharedTask;
     var fs32 = __importStar(__require("fs"));
     var os20 = __importStar(__require("os"));
     var path32 = __importStar(__require("path"));
@@ -14476,6 +14477,14 @@ var require_sharedTasks = __commonJS({
       }, workDir);
     }
     exports2._sharedTasksInternal = { tasksRoot, scopeDir, taskPath, isClaimAbandoned, isUnblocked, CLAIM_STALE_MS, MIN_CLAIM_AGE_FOR_DEATH_CHECK_MS };
+    function deleteSharedTask(workDir, taskId) {
+      try {
+        fs32.unlinkSync(taskPath(workDir, taskId));
+        return true;
+      } catch {
+        return false;
+      }
+    }
   }
 });
 
@@ -106697,6 +106706,14 @@ var require_hooks = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.withAgentHooks = withAgentHooks;
     exports2.loadHooks = loadHooks2;
+    exports2.setHookWakeListener = setHookWakeListener2;
+    exports2.setHookStatusListener = setHookStatusListener2;
+    exports2.drainHookDeliveries = drainHookDeliveries;
+    exports2.takeHookWakes = takeHookWakes2;
+    exports2.hasPendingHookWake = hasPendingHookWake2;
+    exports2.formatHookDeliveries = formatHookDeliveries2;
+    exports2.resetHookOnceState = resetHookOnceState2;
+    exports2.setHookMcpCaller = setHookMcpCaller2;
     exports2.parsePromptHookReply = parsePromptHookReply;
     exports2.hookRunOptsFor = hookRunOptsFor;
     exports2.classifyStopFailure = classifyStopFailure;
@@ -106786,7 +106803,10 @@ var require_hooks = __commonJS({
       "ConfigChange",
       "WorktreeCreate",
       "WorktreeRemove",
-      "Setup"
+      "Setup",
+      "PostToolBatch",
+      "TaskCreated",
+      "TaskCompleted"
     ];
     function toHookEntries(list) {
       return list.map((it) => {
@@ -106795,11 +106815,117 @@ var require_hooks = __commonJS({
           return { matcher: e2.matcher, hooks: e2.hooks };
         const { matcher, ...rest } = e2;
         const hook = { ...rest };
-        if (!isKnownHandlerType(hook.type))
-          hook.type = "command";
+        if (!isKnownHandlerType(hook.type)) {
+          hook.type = !hook.command && !hook.url && !hook.prompt && hook.server && hook.tool ? "mcp_tool" : "command";
+        }
         return { matcher, hooks: [hook] };
       });
     }
+    var _hookDeliveries = [];
+    var _hookWakeListener = null;
+    var _hookStatusListener = null;
+    function setHookWakeListener2(fn) {
+      _hookWakeListener = fn;
+    }
+    function setHookStatusListener2(fn) {
+      _hookStatusListener = fn;
+    }
+    function drainHookDeliveries() {
+      return _hookDeliveries.splice(0);
+    }
+    function takeHookWakes2() {
+      const out = _hookDeliveries.filter((d) => d.kind === "wake");
+      for (let i2 = _hookDeliveries.length - 1; i2 >= 0; i2--)
+        if (_hookDeliveries[i2].kind === "wake")
+          _hookDeliveries.splice(i2, 1);
+      return out;
+    }
+    function hasPendingHookWake2() {
+      return _hookDeliveries.some((d) => d.kind === "wake");
+    }
+    function formatHookDeliveries2(list) {
+      return list.map((d) => `<hook-context source="${d.source}">
+${d.text}
+</hook-context>`).join("\n\n");
+    }
+    var _hookOnceDone = /* @__PURE__ */ new Set();
+    function hookIdentity(event, hook, matcher, dir) {
+      const body = hook.command ?? hook.url ?? hook.prompt ?? `${hook.server ?? ""}__${hook.tool ?? ""}`;
+      return `${dir ?? ""}|${event}|${matcher ?? ""}|${body}`;
+    }
+    function resetHookOnceState2() {
+      _hookOnceDone.clear();
+    }
+    var _activeStatuses = /* @__PURE__ */ new Map();
+    var _statusSeq = 0;
+    function hookStatusBegin(message) {
+      const id = ++_statusSeq;
+      _activeStatuses.set(id, message);
+      _hookStatusListener?.(message);
+      return id;
+    }
+    function hookStatusEnd(id) {
+      if (!_activeStatuses.delete(id))
+        return;
+      if (!_activeStatuses.size) {
+        _hookStatusListener?.(null);
+        return;
+      }
+      _hookStatusListener?.([..._activeStatuses.values()].pop() ?? null);
+    }
+    var _hookMcpCaller = null;
+    function setHookMcpCaller2(fn) {
+      _hookMcpCaller = fn;
+    }
+    function isBackgroundHook(hook) {
+      return hook.type === "command" && (hook.async === true || hook.asyncRewake === true);
+    }
+    function hookGate(hook, event, matcher, dir) {
+      const key = hook.once ? hookIdentity(event, hook, matcher, dir) : void 0;
+      if (key && _hookOnceDone.has(key))
+        return { skip: true };
+      if (isBackgroundHook(hook))
+        return { background: true, key };
+      return { key, statusId: hook.statusMessage ? hookStatusBegin(hook.statusMessage) : void 0 };
+    }
+    function startBackgroundHook(hook, payload, opts) {
+      const statusId = hook.statusMessage ? hookStatusBegin(hook.statusMessage) : void 0;
+      const done = (r2) => {
+        if (statusId !== void 0)
+          hookStatusEnd(statusId);
+        if (r2.status === 0 && opts.key)
+          _hookOnceDone.add(opts.key);
+        const out = (r2.stdout ?? "").toString().trim();
+        if (hook.asyncRewake && r2.status === 2) {
+          const text = (r2.stderr ?? "").toString().trim() || out;
+          _hookDeliveries.push({ kind: "wake", text: text || "Hook asked the session to wake (exit 2).", source: opts.eventLabel });
+          try {
+            _hookWakeListener?.();
+          } catch {
+          }
+          return;
+        }
+        const context = directiveContext(out);
+        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: "" }));
+    }
+    function directiveContext(out) {
+      if (!out.startsWith("{"))
+        return "";
+      try {
+        const j = JSON.parse(out);
+        const parts = [];
+        if (typeof j.additionalContext === "string" && j.additionalContext)
+          parts.push(j.additionalContext);
+        if (typeof j.systemMessage === "string" && j.systemMessage)
+          parts.push(j.systemMessage);
+        return parts.join("\n");
+      } catch {
+        return "";
+      }
+    }
     function spawnHook(command, opts) {
       return new Promise((resolve12) => {
         let stdout = "";
@@ -106809,7 +106935,8 @@ var require_hooks = __commonJS({
           if (settled)
             return;
           settled = true;
-          clearTimeout(timer);
+          if (timer)
+            clearTimeout(timer);
           resolve12({ status, stdout, stderr });
         };
         let child;
@@ -106819,7 +106946,7 @@ var require_hooks = __commonJS({
           resolve12({ status: null, stdout: "", stderr: "" });
           return;
         }
-        const timer = setTimeout(() => {
+        const timer = opts.timeout === null ? null : setTimeout(() => {
           try {
             child.kill("SIGTERM");
           } catch {
@@ -106866,9 +106993,85 @@ var require_hooks = __commonJS({
         return { status: 1, stdout: "", stderr: `hook request failed: ${err.message}` };
       }
     }
+    async function mcpToolHook(hook, payload) {
+      const caller = _hookMcpCaller;
+      const server = String(hook.server ?? "");
+      const tool = String(hook.tool ?? "");
+      if (!caller) {
+        return { status: 1, stdout: "", stderr: `mcp_tool hook "${server}:${tool}" needs a connected MCP client` };
+      }
+      try {
+        const res = await caller(server, tool, mcpHookInput(hook.input, payload));
+        if ("error" in res)
+          return { status: 1, stdout: "", stderr: res.error };
+        const text = (res.text ?? "").trim();
+        if (!text)
+          return { status: 0, stdout: "", stderr: "" };
+        return { status: 0, stdout: text.startsWith("{") ? text : JSON.stringify({ additionalContext: text }), stderr: "" };
+      } catch (err) {
+        return { status: 1, stdout: "", stderr: `mcp_tool hook ${server}:${tool} failed: ${err.message}` };
+      }
+    }
+    function mcpHookInput(input, payload) {
+      if (!input)
+        return {};
+      let root = {};
+      try {
+        const j = JSON.parse(payload);
+        if (j && typeof j === "object" && !Array.isArray(j))
+          root = j;
+      } catch {
+      }
+      const nav = (parts) => {
+        let cur = root;
+        for (const p of parts) {
+          if (cur === null || typeof cur !== "object")
+            return void 0;
+          cur = cur[p];
+        }
+        return cur;
+      };
+      const lookup = (path33) => {
+        const parts = path33.split(".").map((s2) => s2.trim()).filter(Boolean);
+        if (!parts.length)
+          return void 0;
+        const candidates = [parts];
+        if (parts[0] === "tool_input" || parts[0] === "input") {
+          const rest = parts.slice(1);
+          candidates.unshift(rest, ["input", ...rest], ["tool_input", ...rest]);
+        }
+        for (const c of candidates) {
+          const v = nav(c);
+          if (v !== void 0)
+            return v;
+        }
+        return void 0;
+      };
+      const subst = (v) => {
+        if (typeof v !== "string")
+          return v;
+        const whole = v.match(/^\$\{([^}]+)\}$/);
+        if (whole) {
+          const hit = lookup(whole[1]);
+          return hit === void 0 ? "" : hit;
+        }
+        return v.replace(/\$\{([^}]+)\}/g, (_m, p) => {
+          const hit = lookup(p);
+          if (hit === void 0)
+            return "";
+          return typeof hit === "string" ? hit : JSON.stringify(hit);
+        });
+      };
+      const out = {};
+      for (const [k, val] of Object.entries(input))
+        out[k] = subst(val);
+      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 });
       }
@@ -107094,22 +107297,36 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
         input,
         ...result ? { result: { output: result.output, error: result.error } } : {}
       });
+      const eventLabel = `${phase} (${toolName})`;
+      const hookEnv = {
+        ...process.env,
+        NEXRALL_TOOL_NAME: toolName,
+        NEXRALL_TOOL_INPUT: JSON.stringify(input),
+        NEXRALL_HOOK_PHASE: phase
+      };
       for (const entry of entries) {
         if (!hookMatches(entry.matcher, toolName))
           continue;
         for (const hook of entry.hooks ?? []) {
           if (!isRunnableHook(hook))
             continue;
-          const hookTimeout = hookTimeoutMs(hook, 6e4);
+          const gate = hookGate(hook, phase, entry.matcher, workDir);
+          if (gate.skip)
+            continue;
+          if (gate.background) {
+            startBackgroundHook(hook, payload, {
+              cwd: workDir,
+              env: hookEnv,
+              eventLabel,
+              timeoutMs: hook.asyncRewake ? hookTimeoutMs(hook, 6e4) : null,
+              key: gate.key
+            });
+            continue;
+          }
           const r2 = await runHookHandler(hook, payload, {
             cwd: workDir,
-            timeoutMs: hookTimeout,
-            env: {
-              ...process.env,
-              NEXRALL_TOOL_NAME: toolName,
-              NEXRALL_TOOL_INPUT: JSON.stringify(input),
-              NEXRALL_HOOK_PHASE: phase
-            },
+            timeoutMs: hookTimeoutMs(hook, 6e4),
+            env: hookEnv,
             ...hookOpts
           });
           const out = (r2.stdout ?? "").toString().trim();
@@ -107131,17 +107348,33 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
             const err = (r2.stderr ?? "").toString().trim();
             outcome.reason = err || outcome.reason || `Blocked by ${phase} hook`;
           }
+          if (gate.statusId !== void 0)
+            hookStatusEnd(gate.statusId);
+          if (r2.status === 0 && gate.key)
+            _hookOnceDone.add(gate.key);
         }
       }
       return outcome;
     }
-    async function runSimpleHooks(defs, workDir, extraEnv, hookOpts) {
+    async function runSimpleHooks(defs, workDir, extraEnv, hookOpts, event = "hook") {
       if (!defs?.length)
         return;
+      const env4 = extraEnv ? { ...process.env, ...extraEnv } : void 0;
       for (const hook of defs) {
         if (!isRunnableHook(hook))
           continue;
-        await runHookHandler(hook, "", { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 1e4), env: extraEnv ? { ...process.env, ...extraEnv } : void 0, ...hookOpts });
+        const gate = hookGate(hook, event, void 0, workDir);
+        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 });
+          continue;
+        }
+        const r2 = await runHookHandler(hook, "", { cwd: workDir, timeoutMs: hookTimeoutMs(hook, 1e4), env: env4, ...hookOpts });
+        if (gate.statusId !== void 0)
+          hookStatusEnd(gate.statusId);
+        if (r2.status === 0 && gate.key)
+          _hookOnceDone.add(gate.key);
       }
     }
     function flattenHookDefs(items, matchValue) {
@@ -107158,7 +107391,7 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
       return out;
     }
     function isKnownHandlerType(t2) {
-      return t2 === "command" || t2 === "http" || t2 === "prompt" || t2 === "agent";
+      return t2 === "command" || t2 === "http" || t2 === "prompt" || t2 === "agent" || t2 === "mcp_tool";
     }
     function isRunnableHook(hook) {
       if (!isKnownHandlerType(hook.type))
@@ -107167,6 +107400,8 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
         return !!hook.command;
       if (hook.type === "http")
         return !!hook.url;
+      if (hook.type === "mcp_tool")
+        return !!hook.server && !!hook.tool;
       return !!hook.prompt;
     }
     async function runLifecycleHooks(items, event, workDir, payload, matchValue, hookOpts) {
@@ -107178,6 +107413,19 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
       for (const hook of defs) {
         if (!isRunnableHook(hook))
           continue;
+        const gate = hookGate(hook, event, matchValue, workDir);
+        if (gate.skip)
+          continue;
+        if (gate.background) {
+          startBackgroundHook(hook, input, {
+            cwd: workDir,
+            env: { ...process.env, NEXRALL_HOOK_PHASE: event },
+            eventLabel: 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 out = (r2.stdout ?? "").toString().trim();
@@ -107212,6 +107460,10 @@ ${out.output}` : `Error: ${out.error}` : out.output ?? "",
           outcome.block = true;
           outcome.reason = (r2.stderr ?? "").toString().trim() || outcome.reason || `Blocked by ${event} hook`;
         }
+        if (gate.statusId !== void 0)
+          hookStatusEnd(gate.statusId);
+        if (r2.status === 0 && gate.key)
+          _hookOnceDone.add(gate.key);
       }
       return outcome;
     }
@@ -107923,6 +108175,11 @@ var require_iterationPolicy = __commonJS({
 \u{1F6D1} Stopped: the same tool error repeated ${exports2.REPEAT_STALL_LIMIT} rounds in a row, so the agent was looping without making progress.` + (ctx.repeatError ? ` The recurring error was:
 ${ctx.repeatError}
 ` : "\n") + `Fix that underlying cause (or grant the needed permission) and send "continue".
+`;
+        case "hook-blocked":
+          return `
+\u26D4 A PostToolBatch hook stopped the turn before the next model call` + (ctx.hookReason ? `: ${ctx.hookReason}` : ".") + `
+The reason is in the conversation, so send "continue" once the cause is handled.
 `;
         case "budget":
           return `
@@ -108523,7 +108780,10 @@ ${body}`);
       "no-balance",
       "no-team-budget",
       "team-unavailable",
-      "reported-elsewhere"
+      "reported-elsewhere",
+      // A hook stopping the batch means the sub-agent stopped short of its report, so the
+      // parent must not read the result as a finished one.
+      "hook-blocked"
     ]);
     exports2.SUBAGENT_PREAMBLE = [
       "# You are a sub-agent",
@@ -109232,8 +109492,8 @@ var require_loop = __commonJS({
   "../core/dist/agent/loop.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.resolveSubtaskTimeoutMs = exports2.canSpawnSubAgents = exports2.intersectAllowlists = exports2.noSpawnReason = exports2.resolveMaxSubagentDepth = exports2._sessionSubAgentCount = exports2.resetSessionSubAgentBudget = exports2._resetSubTaskLimiter = 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.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 = void 0;
+    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.dispatchSubAgent = dispatchSubAgent;
     exports2.dispatchBackgroundSubAgent = dispatchBackgroundSubAgent;
     exports2.runAgentLoop = runAgentLoop2;
@@ -109244,6 +109504,7 @@ var require_loop = __commonJS({
     var types_1 = require_types();
     var client_1 = require_client();
     var executor_1 = require_executor();
+    var sharedTasks_1 = require_sharedTasks();
     var agentTypes_1 = require_agentTypes();
     var skills_1 = require_skills();
     var rules_1 = require_rules();
@@ -109291,6 +109552,30 @@ var require_loop = __commonJS({
     Object.defineProperty(exports2, "fireObserverHook", { enumerable: true, get: function() {
       return hooks_2.fireObserverHook;
     } });
+    Object.defineProperty(exports2, "drainHookDeliveries", { enumerable: true, get: function() {
+      return hooks_2.drainHookDeliveries;
+    } });
+    Object.defineProperty(exports2, "takeHookWakes", { enumerable: true, get: function() {
+      return hooks_2.takeHookWakes;
+    } });
+    Object.defineProperty(exports2, "hasPendingHookWake", { enumerable: true, get: function() {
+      return hooks_2.hasPendingHookWake;
+    } });
+    Object.defineProperty(exports2, "formatHookDeliveries", { enumerable: true, get: function() {
+      return hooks_2.formatHookDeliveries;
+    } });
+    Object.defineProperty(exports2, "setHookWakeListener", { enumerable: true, get: function() {
+      return hooks_2.setHookWakeListener;
+    } });
+    Object.defineProperty(exports2, "setHookStatusListener", { enumerable: true, get: function() {
+      return hooks_2.setHookStatusListener;
+    } });
+    Object.defineProperty(exports2, "setHookMcpCaller", { enumerable: true, get: function() {
+      return hooks_2.setHookMcpCaller;
+    } });
+    Object.defineProperty(exports2, "resetHookOnceState", { enumerable: true, get: function() {
+      return hooks_2.resetHookOnceState;
+    } });
     var compaction_1 = require_compaction();
     var compaction_2 = require_compaction();
     Object.defineProperty(exports2, "contextWindowFor", { enumerable: true, get: function() {
@@ -109465,6 +109750,27 @@ var require_loop = __commonJS({
           subAgentBudget_1._inFlightByDepth.delete(childDepth);
       }
     }
+    async function taskHookVeto(entries, event, input, options, extra = {}) {
+      if (!entries?.length)
+        return null;
+      const taskId = typeof input.task_id === "string" ? input.task_id : "";
+      const task = extra.task_subject ? null : (0, sharedTasks_1.listSharedTasks)(options.workDir).find((t2) => t2.id === taskId);
+      const payload = {
+        session_id: options.sessionId ?? "",
+        ...taskId ? { task_id: taskId } : {},
+        ...task ? { task_subject: task.content, task_description: task.content } : {},
+        ...extra,
+        tool_input: input
+      };
+      try {
+        const outcome = await (0, hooks_1.runLifecycleHooks)(entries, event, options.workDir, payload, void 0, (0, hooks_1.hookRunOptsFor)(options));
+        if (!outcome.block)
+          return null;
+        return `Refused by ${event} hook${outcome.reason ? `: ${outcome.reason}` : ""}`;
+      } catch {
+        return null;
+      }
+    }
     function dispatchBackgroundSubAgent(input, options, agentTypes, hub) {
       const overBudget = (0, subAgentBudget_1.claimSessionSubAgentSlot)(options.workDir, options.onNotice ?? options.onText, options.sessionId);
       if (overBudget)
@@ -109668,6 +109974,7 @@ ${ctx}
       let repeatedErrorRounds = 0;
       let lastErrorSignature = "";
       let stalledRepeatError = null;
+      let hookBlockedReason = null;
       let budget = maxIterations;
       let iteration = 0;
       let emptyTurnRetries = 0;
@@ -109851,7 +110158,8 @@ ${ctx}
             const queued = options.takePendingInput?.() ?? [];
             const peerMsgs = options.drainPeerMessages?.() ?? [];
             const bgDone = drainBackgroundNotifications();
-            if (queued.length || peerMsgs.length || bgDone.length) {
+            const hookMsgs = (0, hooks_1.drainHookDeliveries)();
+            if (queued.length || peerMsgs.length || bgDone.length || hookMsgs.length) {
               const parts = [];
               if (queued.length) {
                 parts.push(queued.join("\n\n"));
@@ -109863,6 +110171,8 @@ ${ctx}
               }
               if (bgDone.length)
                 parts.push((0, backgroundAgents_1.formatBackgroundNotifications)(bgDone));
+              if (hookMsgs.length)
+                parts.push((0, hooks_1.formatHookDeliveries)(hookMsgs));
               messages.push({ role: "user", content: [{ type: "text", text: parts.join("\n\n") }] });
               continue;
             }
@@ -109895,7 +110205,8 @@ ${ctx}
             const queued = options.takePendingInput?.() ?? [];
             const peerMsgs = options.drainPeerMessages?.() ?? [];
             const bgDone = drainBackgroundNotifications();
-            if (queued.length || peerMsgs.length || bgDone.length) {
+            const hookMsgs = (0, hooks_1.drainHookDeliveries)();
+            if (queued.length || peerMsgs.length || bgDone.length || hookMsgs.length) {
               const parts = [];
               if (queued.length) {
                 parts.push(queued.join("\n\n"));
@@ -109907,6 +110218,8 @@ ${ctx}
               }
               if (bgDone.length)
                 parts.push((0, backgroundAgents_1.formatBackgroundNotifications)(bgDone));
+              if (hookMsgs.length)
+                parts.push((0, hooks_1.formatHookDeliveries)(hookMsgs));
               messages.push({ role: "user", content: [{ type: "text", text: parts.join("\n\n") }] });
               continue;
             }
@@ -110065,7 +110378,16 @@ ${ctx}
               if (pre.block) {
                 result = { error: `Blocked by PreToolUse hook: ${pre.reason}` };
               } else {
+                const taskIdsBefore = name === "create_shared_task" ? new Set((0, sharedTasks_1.listSharedTasks)(options.workDir).map((t2) => t2.id)) : null;
                 try {
+                  if (name === "update_shared_task_status" && String(input.status ?? "") === "completed") {
+                    const veto = await taskHookVeto(hooks.TaskCompleted, "TaskCompleted", input, options);
+                    if (veto) {
+                      result = { error: veto };
+                      options.onToolResult(name, result, void 0, toolMeta);
+                      return { block: { ...block, id }, result };
+                    }
+                  }
                   if (name === iterationPolicy_1.AGENT_MEMORY_TOOL) {
                     result = await (0, iterationPolicy_1.executeAgentMemoryWrite)(input, options._agentMemory, options.workDir);
                     options.onToolResult(name, result, void 0, toolMeta);
@@ -110103,6 +110425,21 @@ ${ctx}
                 } catch (err) {
                   result = { error: `Tool execution failed: ${err.message}` };
                 }
+                if (name === "create_shared_task" && result.error === void 0 && taskIdsBefore) {
+                  const created = (0, sharedTasks_1.listSharedTasks)(options.workDir).filter((t2) => !taskIdsBefore.has(t2.id) && typeof input.content === "string" && t2.content === input.content);
+                  const task = created[created.length - 1];
+                  if (task) {
+                    const veto = await taskHookVeto(hooks.TaskCreated, "TaskCreated", input, options, {
+                      task_id: task.id,
+                      task_subject: task.content,
+                      task_description: task.content
+                    });
+                    if (veto) {
+                      (0, sharedTasks_1.deleteSharedTask)(options.workDir, task.id);
+                      result = { error: veto };
+                    }
+                  }
+                }
                 if (name === "memory_write" && result.error === void 0) {
                   const scope = input.scope === "global" ? "global" : "project";
                   void (0, compaction_1.maybeCompactMemory)(scope, options);
@@ -110194,6 +110531,32 @@ ${result.output}` : `Error: ${result.error}` : result.output ?? "",
           if (bgFinished.length) {
             toolResultContent.push({ type: "text", text: (0, backgroundAgents_1.formatBackgroundNotifications)(bgFinished) });
           }
+          const hookDeliveries = (0, hooks_1.drainHookDeliveries)();
+          if (hookDeliveries.length) {
+            toolResultContent.push({ type: "text", text: (0, hooks_1.formatHookDeliveries)(hookDeliveries) });
+          }
+          let postBatchStop = null;
+          if (hooks.PostToolBatch?.length) {
+            const batch = await (0, hooks_1.runLifecycleHooks)(hooks.PostToolBatch, "PostToolBatch", options.workDir, {
+              tool_calls: toolResults.map(({ block: b, result: r2 }) => ({
+                tool_name: b.name,
+                tool_input: b.input,
+                tool_use_id: b.id,
+                tool_response: r2.error !== void 0 ? r2.output ? `Error: ${r2.error}
+
+${r2.output}` : `Error: ${r2.error}` : r2.output ?? ""
+              }))
+            }, void 0, (0, hooks_1.hookRunOptsFor)(options));
+            if (batch.context)
+              toolResultContent.push({ type: "text", text: batch.context });
+            if (batch.block) {
+              postBatchStop = batch.reason?.trim() || "a PostToolBatch hook stopped the turn";
+              toolResultContent.push({
+                type: "text",
+                text: `A PostToolBatch hook stopped the turn before the next model call: ${postBatchStop}`
+              });
+            }
+          }
           const toolResultMessage = {
             role: "user",
             content: toolResultContent
@@ -110201,6 +110564,11 @@ ${result.output}` : `Error: ${result.error}` : result.output ?? "",
           messages.push(toolResultMessage);
           completedRounds++;
           options.onProgress?.(messages);
+          if (postBatchStop) {
+            stopReason = "hook-blocked";
+            hookBlockedReason = postBatchStop;
+            break;
+          }
           const errored = toolResults.filter(({ result }) => result.error !== void 0);
           const allErrored = toolResults.length > 0 && errored.length === toolResults.length;
           consecutiveErrorRounds = allErrored ? consecutiveErrorRounds + 1 : 0;
@@ -110234,7 +110602,7 @@ ${result.output}` : `Error: ${result.error}` : result.output ?? "",
         const apiFailure = (0, hooks_1.apiFailureForStopReason)(stopReason);
         if (apiFailure)
           await fireStopFailure(apiFailure);
-        const notice = (0, iterationPolicy_1.stopReasonNotice)(stopReason, { budget, repeatError: stalledRepeatError });
+        const notice = (0, iterationPolicy_1.stopReasonNotice)(stopReason, { budget, repeatError: stalledRepeatError, hookReason: hookBlockedReason });
         if (options._onStopReason)
           options._onStopReason(stopReason, notice || null);
         else if (notice)
@@ -155286,7 +155654,7 @@ import * as os18 from "os";
 import * as crypto7 from "crypto";
 import { createRequire } from "module";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { execSync, execFileSync as execFileSync5 } from "child_process";
+import { execFile as execFile2, execFileSync as execFileSync5 } from "child_process";
 
 // src/permissions/handler.ts
 import * as readline2 from "readline";
@@ -172348,12 +172716,16 @@ function resolveModelLabel(alias) {
   const id = normaliseModelId(alias);
   return (0, import_code_core18.liveLabelFor)(id, MODEL_LABELS[id] ?? id);
 }
-function tryExec(cmd, cwd2) {
-  try {
-    return execSync(cmd, { cwd: cwd2, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim() || void 0;
-  } catch {
-    return void 0;
-  }
+async function tryExecAsync(file, args, cwd2) {
+  return new Promise((resolve12) => {
+    try {
+      execFile2(file, args, { cwd: cwd2, encoding: "utf-8" }, (err, stdout) => {
+        resolve12(err ? void 0 : String(stdout).trim() || void 0);
+      });
+    } catch {
+      resolve12(void 0);
+    }
+  });
 }
 var BILLING_URL = "https://app.nexrall.com/?settings=billing";
 function hyperlink(label, url) {
@@ -172381,28 +172753,29 @@ function currentUserLabel() {
     return "there";
   }
 }
-function collectEnv(workDir) {
+async function collectEnv(workDir) {
   return {
     cwd: workDir,
     platform: `${os18.platform()} ${os18.release()}`,
     shell: process.env.SHELL ?? process.env.ComSpec ?? "unknown",
     date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-    ...collectGitEnv(workDir)
+    ...await collectGitEnv(workDir)
   };
 }
-function collectGitEnv(workDir) {
-  return {
-    gitBranch: tryExec("git branch --show-current", workDir),
-    gitStatus: tryExec("git status --short", workDir),
-    gitDiff: tryExec("git diff --stat HEAD", workDir),
-    recentCommits: tryExec("git log --oneline -5", workDir)
-  };
+async function collectGitEnv(workDir) {
+  const [gitBranch2, gitStatus, gitDiff, recentCommits] = await Promise.all([
+    tryExecAsync("git", ["branch", "--show-current"], workDir),
+    tryExecAsync("git", ["status", "--short"], workDir),
+    tryExecAsync("git", ["diff", "--stat", "HEAD"], workDir),
+    tryExecAsync("git", ["log", "--oneline", "-5"], workDir)
+  ]);
+  return { gitBranch: gitBranch2, gitStatus, gitDiff, recentCommits };
 }
-function refreshEnvForTurn(env4, workDir) {
+async function refreshEnvForTurn(env4, workDir) {
   return {
     ...env4,
     date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-    ...collectGitEnv(workDir)
+    ...await collectGitEnv(workDir)
   };
 }
 var noDiscovery = false;
@@ -172586,6 +172959,10 @@ var Spinner = class {
   verbIdx = 0;
   thinkTokens = 0;
   thinkText = "";
+  // A running hook's `statusMessage` (Claude Code). While set it REPLACES the label —
+  // the whole point is telling the user which hook is producing the wait — and the
+  // normal label returns the moment the hook finishes (listener sends null).
+  hookStatus = "";
   start(text, opts) {
     this.stop();
     this.baseText = text;
@@ -172640,13 +173017,24 @@ var Spinner = class {
       return;
     this.baseText = text;
   }
+  /**
+   * A hook with `statusMessage` started (message) or finished (null). Renders immediately
+   * rather than on the next tick: the whole point of the message is that a long hook is
+   * RUNNING, and waiting up to 100ms to admit that is the kind of silence it exists to fix.
+   * No-op while the spinner is stopped — an idle session keeps its prompt, not a status line.
+   */
+  setHookStatus(message) {
+    this.hookStatus = message ?? "";
+    if (this.interval !== null)
+      this.render();
+  }
   render() {
     const elapsedSec = Math.floor((Date.now() - this.startedAt) / 1e3);
     if (this.verbs && elapsedSec > 0 && elapsedSec % VERB_ROTATE_SEC === 0 && this.lastRotateSec !== elapsedSec) {
       this.lastRotateSec = elapsedSec;
       this.verbIdx++;
     }
-    const label = this.verbs ? `${WORKING_VERBS[this.verbIdx % WORKING_VERBS.length]}\u2026` : this.baseText;
+    const label = this.hookStatus || (this.verbs ? `${WORKING_VERBS[this.verbIdx % WORKING_VERBS.length]}\u2026` : this.baseText);
     const status = composeStatusLine({
       frame: this.frames[this.i % this.frames.length],
       text: label,
@@ -172695,6 +173083,7 @@ async function initMcp(workDir, override, strict) {
   if (noDiscovery && !override) {
     _mcpConfig = { mcpServers: {} };
     _mcpManager = null;
+    wireHookMcpCaller();
     return;
   }
   _mcpConfig = strict && override ? { mcpServers: {} } : import_code_core18.McpManager.loadConfig(workDir);
@@ -172702,6 +173091,7 @@ async function initMcp(workDir, override, strict) {
     Object.assign(_mcpConfig.mcpServers, override.mcpServers);
   if (Object.keys(_mcpConfig.mcpServers).length === 0) {
     _mcpManager = null;
+    wireHookMcpCaller();
     return;
   }
   try {
@@ -172711,6 +173101,18 @@ async function initMcp(workDir, override, strict) {
   const manager = new import_code_core18.McpManager();
   await manager.connectAll(_mcpConfig);
   _mcpManager = manager;
+  wireHookMcpCaller();
+}
+function wireHookMcpCaller() {
+  const mgr = _mcpManager;
+  if (!mgr) {
+    (0, import_code_core19.setHookMcpCaller)(null);
+    return;
+  }
+  (0, import_code_core19.setHookMcpCaller)(async (server, tool, input) => {
+    const text = await mgr.callTool(`${server}__${tool}`, input);
+    return text === null ? { error: `MCP server "${server}" has no tool "${tool}" (or the server is not connected)` } : { text };
+  });
 }
 function formatAgentsList(workDir) {
   const { types: types3, warnings } = (0, import_code_core18.loadAgentTypesWithWarnings)(workDir);
@@ -173086,6 +173488,7 @@ async function runTurn(messages, modelAlias, workDir, abortSignal, env4, nexrall
   const turnStart = Date.now();
   userActiveThisTurn = false;
   const spinner = new Spinner();
+  (0, import_code_core19.setHookStatusListener)((m2) => spinner.setHookStatus(m2));
   const mdRender = new MarkdownStreamRenderer();
   const toolStream = new ToolStreamPrinter(PREVIEW_LINES);
   let toolStartTime = 0;
@@ -173112,7 +173515,7 @@ async function runTurn(messages, modelAlias, workDir, abortSignal, env4, nexrall
     workDir,
     sessionId: activeSessionIdGetter(),
     model: modelAlias,
-    env: refreshEnvForTurn(env4, workDir),
+    env: await refreshEnvForTurn(env4, workDir),
     nexrallMd,
     mode,
     // `/mode plan` previously only hinted to the backend — the footer said "plan
@@ -173465,7 +173868,7 @@ async function runTurnHeadless(messages, modelAlias, workDir, _abortSignal, env4
     workDir,
     sessionId: activeSessionIdGetter(),
     model: modelAlias,
-    env: refreshEnvForTurn(env4, workDir),
+    env: await refreshEnvForTurn(env4, workDir),
     nexrallMd,
     mode,
     planMode: mode === "plan",
@@ -173991,7 +174394,7 @@ Resume it with: nex --worktree ${worktreeState.name}
       void (0, import_code_core19.fireObserverHook)(requestedWorkDir, "WorktreeRemove", { name: worktreeState.name, path: worktreeState.worktreePath }, worktreeState.name);
     });
   }
-  const env4 = collectEnv(workDir);
+  const env4 = await collectEnv(workDir);
   let briefBase = options.systemPrompt?.trim() ?? readNexrallMd(workDir);
   const agentPrefix = options.selectedAgent?.prompt?.trim();
   const briefParts = [agentPrefix, briefBase, options.appendSystemPrompt?.trim(), addDirNote(options.addDirs ?? []), options.jsonSchema ? schemaInstruction(options.jsonSchema) : ""];
@@ -175114,6 +175517,7 @@ ${text}` : "");
           activeGoal = null;
           criteriaLastLine = "";
           cliBackgroundAgents.stopAll({ dropPending: true });
+          (0, import_code_core19.resetHookOnceState)();
           inputBuffer = "";
           if (interactive)
             await getInkTerminal().clearTranscript();
@@ -175320,7 +175724,7 @@ ${summaryText}` }] },
           }
           const readme = tryRead(path29.join(workDir, "README.md"))?.slice(0, 2e3) ?? "";
           const pkgJson = tryRead(path29.join(workDir, "package.json"))?.slice(0, 1e3) ?? "";
-          const dirList = tryExec("ls -la", workDir)?.slice(0, 500) ?? "";
+          const dirList = (await tryExecAsync("ls", ["-la"], workDir))?.slice(0, 500) ?? "";
           const initPrompt = `Analyze this project and write a concise nexrall.md (project-specific instructions for an AI coding assistant).
 Include: project overview, tech stack, coding conventions, important files/folders, what to avoid.
 Keep it under 400 words. Use markdown. Be specific and actionable.
@@ -177246,6 +177650,7 @@ ${text}
     rl.resume();
     rl.prompt();
     deliverBackgroundWhenIdle();
+    deliverHookWakeWhenIdle();
   });
   async function runGoalLoop() {
     while (activeGoal) {
@@ -177326,6 +177731,20 @@ ${text}
     bgLastCount = n;
     deliverBackgroundWhenIdle();
   });
+  let hookWakeTimer = null;
+  function deliverHookWakeWhenIdle() {
+    if (hookWakeTimer || agentRunning || !(0, import_code_core19.hasPendingHookWake)())
+      return;
+    hookWakeTimer = setTimeout(() => {
+      hookWakeTimer = null;
+      if (agentRunning || !(0, import_code_core19.hasPendingHookWake)())
+        return;
+      const wakes = (0, import_code_core19.takeHookWakes)();
+      console.log(paint.dim(`  \u2699 hook wake \u2014 continuing`));
+      rl.emit("line", (0, import_code_core19.formatHookDeliveries)(wakes));
+    }, 400);
+  }
+  (0, import_code_core19.setHookWakeListener)(deliverHookWakeWhenIdle);
   const loopTimer = setInterval(() => {
     if (loopScheduler.size === 0)
       return;

package/package.json

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