@kernlang/agon 0.1.2 → 0.1.3

package/dist/{chunk-IA4AR2R4.js → chunk-XOJPAFCJ.js}

@@ -10,6 +10,7 @@ import {
   appendUserTurnIfAbsent,
   applyPatch,
   assignForgeRoles,
+  buildCodebaseMap,
   buildCritiquePrompt,
   buildForgePrompt,
   buildHistoryPrimedPrompt,
@@ -26,6 +27,7 @@ import {
   createBashTool,
   createBrainstormTool,
   createCampfireTool,
+  createConquerTool,
   createDelegateTool,
   createEditTool,
   createExitPlanModeTool,
@@ -98,7 +100,7 @@ import {
   worktreeCreate,
   worktreeDiff,
   worktreeRemoveBestEffort
-} from "./chunk-7PMMOQZ7.js";
+} from "./chunk-PFHGKBQT.js";
 
 // ../forge/src/generated/forge.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -6729,6 +6731,7 @@ function createCesarToolRegistry(engineId) {
   toolRegistry.register(createCampfireTool());
   toolRegistry.register(createPipelineTool());
   toolRegistry.register(createGoalTool());
+  toolRegistry.register(createConquerTool());
   toolRegistry.register(createReviewTool());
   toolRegistry.register(createDelegateTool());
   toolRegistry.register(createAgentTool());
@@ -8511,6 +8514,7 @@ function extractDelegation(toolName, args) {
     maxTurns: typeof argsRecord.maxTurns === "number" ? argsRecord.maxTurns : void 0,
     queue: typeof argsRecord.queue === "string" ? argsRecord.queue : void 0,
     gate: typeof argsRecord.gate === "string" ? argsRecord.gate : void 0,
+    builder: typeof argsRecord.builder === "string" ? argsRecord.builder : void 0,
     push: argsRecord.push ?? void 0,
     pr: argsRecord.pr ?? void 0,
     maxHours: typeof argsRecord.maxHours === "number" ? argsRecord.maxHours : void 0,
@@ -9064,6 +9068,7 @@ RULE 6 \u2014 AFTER DELEGATION: After calling Forge/Brainstorm/Tribunal/Campfire
 RULE 7 \u2014 NO NARRATION: NEVER narrate your research process. Do not write "Reading the file...", "I'm checking...", "Let me look at...", "I've confirmed...". The user sees your text output \u2014 if you narrate exploration it looks like you have no clue. Instead: call tools SILENTLY, then speak ONLY when you have the answer or decision. Your visible output should be conclusions, answers, and actions \u2014 never a play-by-play of your investigation. If you need to read files or search code, call Read/Grep/Glob directly without announcing it.
 
 RULE 8 \u2014 AUTONOMOUS PLANS: Plan mode is optional, not the default. Stay live unless staged execution is genuinely useful. Switch to planning when the task needs multiple dependent steps, expensive orchestration, resumability, explicit approval, or cost visibility. When you call ProposePlan, decide whether to set autoApprove=true. Set it ONLY when (a) the user clearly described a multi-stage workflow ("plan it, build it, review it"; "investigate then forge it"; "do the whole thing autonomously") AND (b) you have HIGH confidence in the steps after investigation (not before). The runtime applies a layered policy and may still ask the user \u2014 your autoApprove=true is permission, not a guarantee. Default to autoApprove=false (or omit it) whenever you are uncertain or when the plan touches mutating steps and the user did not explicitly invite autonomous execution. selfReview defaults to true for mutating plans \u2014 only set selfReview=false for purely advisory plans (brainstorm/tribunal/research only) where a code-review gate would have nothing to review.
+RULE 8b \u2014 AUTONOMOUS BUILD TOOLS (Goal / Conquer): These run a build to completion in the BACKGROUND. Goal(intent, queue?, gate?) drives a finite, machine-verifiable task QUEUE (forge \u2192 witness \u2192 review \u2192 commit per task on a goal/* branch). Conquer(task, gate, builder?, engines?) is for an OPEN-ENDED build you'd otherwise babysit: it drives an external builder CLI as the user (builder defaults to codex \u2014 pass builder:"codex" / "claude" / "agy") unattended until the gate passes, convening nero/tribunal/council on forks, then STOPS at a human merge gate (NEVER auto-merges). Fire EITHER ONLY when the user explicitly asks to build it unattended ("conquer this with codex", "build it autonomously") \u2014 NEVER on a vague request; both are long, real-spend, multi-hour runs. Conquer REQUIRES a discriminating gate (the done-spec, e.g. gate:"pnpm test"); if the user did not give one, ASK for the command that proves the build is done before calling. After calling either, STOP and wait \u2014 the background job and the merge gate handle the rest.
 
 RULE 10 \u2014 TURN CLOSURE: End every turn with one clear closing line so the user can tell AT A GLANCE which of three states you are in: done, waiting on them for a decision/info, or handed off. This is non-negotiable: NEVER end a turn with only a recap, a silent stop, or a trailing thought \u2014 that leaves the user wondering "is it my turn? do I have to do something?", which must never happen. Four valid shapes \u2014 pick exactly one:
   a) DONE \u2014 past-tense, concrete, names the file/result. Example: "Fixed: brain.kern lines 787-799, drain timers added before early return, typecheck green." No trailing menu, no "standing by".
@@ -9096,6 +9101,12 @@ function buildCesarSystemPrompt(ctx) {
   const systemParts = [CESAR_SYSTEM_PROMPT];
   if (projectCtx) systemParts.push(`## PROJECT CONTEXT
 ${projectCtx}`);
+  try {
+    const codebaseBrief = buildCodebaseMap(cesarCwd);
+    if (codebaseBrief) systemParts.push(codebaseBrief);
+  } catch (err) {
+    console.warn(`[agon] codebase atlas skipped: ${err instanceof Error ? err.message : String(err)}`);
+  }
   systemParts.push(`## AVAILABLE ENGINES
 ${engineList}`);
   if (ctx.explorationMode) {
@@ -9235,6 +9246,7 @@ ${context}`);
 }
 var CESAR_SNAPSHOT_MSG_CHAR_CAP = 4e3;
 var CONFIDENCE_BLOCK_LIMIT = 2;
+var SEARCH_NUDGE_THRESHOLD = 40;
 function capSnapshotMessageContent(content) {
   if (content.length <= CESAR_SNAPSHOT_MSG_CHAR_CAP) return content;
   return `${content.slice(0, CESAR_SNAPSHOT_MSG_CHAR_CAP)}
@@ -9279,6 +9291,7 @@ function buildOnToolCall(ctx, toolRegistry, config) {
   const toolResultCache = /* @__PURE__ */ new Map();
   const nativeToolErrorRetries = /* @__PURE__ */ new Map();
   const CACHEABLE_TOOLS = /* @__PURE__ */ new Set(["Grep", "Glob"]);
+  const SEARCH_NUDGE_TOOLS = /* @__PURE__ */ new Set(["Read", "Grep", "Glob"]);
   const explorationMode = ctx.explorationMode ?? false;
   const sharedToolCtx = {
     cwd,
@@ -9361,7 +9374,7 @@ ${cleaned}`;
       }
     }
     if (name === "ExitPlanMode") {
-      const { handleExitPlanMode } = await import("./plan-mode-DCE7VGQV.js");
+      const { handleExitPlanMode } = await import("./plan-mode-OSU42TOI.js");
       return "[DELEGATION_BREAK] " + handleExitPlanMode(String(args.reason ?? ""), ctx.cesar?.planDispatch ?? null, ctx);
     }
     if (name === "ProposePlan") {
@@ -9384,7 +9397,7 @@ ${cleaned}`;
           }
         }
       }
-      const { handleProposePlan } = await import("./plan-mode-DCE7VGQV.js");
+      const { handleProposePlan } = await import("./plan-mode-OSU42TOI.js");
       const dispatch = ctx.cesar.planDispatch;
       if (!dispatch) {
         return "[PLAN_ERROR] Internal plan display dispatch unavailable. Retry the plan request so Agon can render the approval panel.";
@@ -9420,13 +9433,14 @@ ${cleaned}`;
         return value >= 93 ? `Confidence ${value}% recorded. High confidence. Proceed.` : `Confidence ${value}% recorded. Proceed.`;
       }
     }
-    const READ_TOOLS = /* @__PURE__ */ new Set(["Read", "Grep", "Glob", "ReportConfidence", "Delegate"]);
-    if (!ctx.cesar.confidenceSatisfied && !READ_TOOLS.has(name)) {
+    const CONFIDENCE_INVESTIGATION_TOOLS = /* @__PURE__ */ new Set(["Read", "Grep", "Glob", "ReportConfidence", "Delegate"]);
+    const _isInvestigation = CONFIDENCE_INVESTIGATION_TOOLS.has(name) || name === "Bash" && isReadOnlyCommand(String(args.command ?? ""));
+    if (!ctx.cesar.confidenceSatisfied && !_isInvestigation) {
       const blocks = (ctx.cesar.confidenceBlockCount ?? 0) + 1;
       ctx.cesar.confidenceBlockCount = blocks;
       if (blocks <= CONFIDENCE_BLOCK_LIMIT) {
         ctx.cesar.blockedOnConfidence = { name, args };
-        return `[BLOCKED] Report confidence first. Call ReportConfidence(value) before using ${name}. After ReportConfidence succeeds, retry the SAME ${name} call immediately with the same arguments. Read/Grep/Glob are allowed for investigation.`;
+        return `[BLOCKED] Report confidence first. Call ReportConfidence(value) before using ${name}. After ReportConfidence succeeds, retry the SAME ${name} call immediately with the same arguments. Read/Grep/Glob and read-only Bash are allowed for investigation.`;
       }
       ctx.cesar.confidenceSatisfied = true;
       ctx.cesar.blockedOnConfidence = null;
@@ -9471,6 +9485,16 @@ Repair retry already used for this exact ${name} input in this turn. Stop retryi
       toolResultCache.clear();
       ctx.cesar.blockedOnConfidence = null;
     }
+    if (result.result.ok && SEARCH_NUDGE_TOOLS.has(name)) {
+      const searches = (ctx.cesar.searchToolCount ?? 0) + 1;
+      ctx.cesar.searchToolCount = searches;
+      if (searches >= SEARCH_NUDGE_THRESHOLD && !ctx.cesar.searchNudged) {
+        ctx.cesar.searchNudged = true;
+        output = `${output ?? ""}
+
+[NOTE] ${searches} read/search calls this turn. A CODEBASE BRIEF mapping where things live (files + top symbols per package) is in your system prompt \u2014 consult it to locate code instead of searching more. If something isn't listed, narrow the query rather than broadening it.`;
+      }
+    }
     return output;
   };
 }
@@ -9945,7 +9969,7 @@ async function commitTurnAndDelegate(pendingDel, input, response, cesarEngineId,
     const reasoning = delResult.userContext ? `${pendingDel.reasoning ?? ""}
 
 User context: ${delResult.userContext}` : pendingDel.reasoning;
-    return { mode, delegated: true, responded: true, action, task: pendingDel.task, reasoning, decisionReason: "tool-delegation", scope: pendingDel.scope, fitnessCmd: pendingDel.fitnessCmd, hardened: delResult.hardened ?? pendingDel.hardened, tribunalMode: delResult.tribunalMode ?? pendingDel.tribunalMode, team: delResult.team ?? pendingDel.team, target: pendingDel.target, engineId: pendingDel.engineId, engines: pendingDel.engines, taskKind: pendingDel.taskKind, maxTurns: pendingDel.maxTurns, queue: pendingDel.queue, gate: pendingDel.gate, push: pendingDel.push, pr: pendingDel.pr, maxHours: pendingDel.maxHours, budget: pendingDel.budget, ...telemetry ?? {} };
+    return { mode, delegated: true, responded: true, action, task: pendingDel.task, reasoning, decisionReason: "tool-delegation", scope: pendingDel.scope, fitnessCmd: pendingDel.fitnessCmd, hardened: delResult.hardened ?? pendingDel.hardened, tribunalMode: delResult.tribunalMode ?? pendingDel.tribunalMode, team: delResult.team ?? pendingDel.team, target: pendingDel.target, engineId: pendingDel.engineId, engines: pendingDel.engines, taskKind: pendingDel.taskKind, maxTurns: pendingDel.maxTurns, queue: pendingDel.queue, gate: pendingDel.gate, builder: pendingDel.builder, push: pendingDel.push, pr: pendingDel.pr, maxHours: pendingDel.maxHours, budget: pendingDel.budget, ...telemetry ?? {} };
   }
   return { delegated: false, responded: true, decisionReason: "delegation-cancelled", ...telemetry ?? {} };
 }
@@ -10114,6 +10138,8 @@ async function handleCesarBrain(input, dispatch, ctx, images) {
   ctx.cesar.confidenceSatisfied = false;
   ctx.cesar.blockedOnConfidence = null;
   ctx.cesar.confidenceBlockCount = 0;
+  ctx.cesar.searchToolCount = 0;
+  ctx.cesar.searchNudged = false;
   ctx.cesar.turnId = _turnId;
   ctx.cesar.planDispatch = dispatch;
   const _brainStartMs = Date.now();
@@ -10272,7 +10298,7 @@ async function handleCesarBrain(input, dispatch, ctx, images) {
     const fastPathMode = simpleEditFastPath ? "edit" : answerFastPath ? "answer" : "";
     const fastPathBaseBudget = simpleEditFastPath ? 5 : 3;
     const fastPathMaxBudget = simpleEditFastPath ? 8 : 4;
-    const FAST_PATH_BLOCKED_TOOLS = ["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal", "Delegate", "ProposePlan", "QuickNero"];
+    const FAST_PATH_BLOCKED_TOOLS = ["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal", "Conquer", "Delegate", "ProposePlan", "QuickNero"];
     if (cesarFastPath && !restoreFastPathMode) {
       const hadPreviousFastPathMode = Object.prototype.hasOwnProperty.call(ctx.cesar, "fastPathMode");
       const previousFastPathMode = ctx.cesar.fastPathMode;
@@ -10521,7 +10547,7 @@ ${enrichedInput}`;
           const toolInput = typeof meta.input === "string" ? meta.input : meta.input ? JSON.stringify(meta.input) : "";
           const toolName = chunk.content || "tool";
           const toolStatus = meta.status ?? "running";
-          const STREAM_ORCH = /* @__PURE__ */ new Set(["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal"]);
+          const STREAM_ORCH = /* @__PURE__ */ new Set(["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal", "Conquer"]);
           hadToolActivity = true;
           recordToolUse(toolName, ctx.cesar.hasNativeTools ? "native" : "eager", toolInput, toolStatus);
           dispatch({ type: "spinner-update", message: `Cesar: ${toolName}\u2026` });
@@ -10866,7 +10892,7 @@ ${enrichedInput}`;
                 });
                 continue;
               }
-              const { handleProposePlan } = await import("./plan-mode-DCE7VGQV.js");
+              const { handleProposePlan } = await import("./plan-mode-OSU42TOI.js");
               const planDispatch = ctx.cesar.planDispatch ?? dispatch;
               if (planDispatch) {
                 try {
@@ -10879,7 +10905,7 @@ ${enrichedInput}`;
               }
             } else if (signal.tool === "ExitPlanMode") {
               recordToolUse("ExitPlanMode", "mcp", JSON.stringify(signal.args ?? {}), "done");
-              const { handleExitPlanMode } = await import("./plan-mode-DCE7VGQV.js");
+              const { handleExitPlanMode } = await import("./plan-mode-OSU42TOI.js");
               const planDispatch = ctx.cesar.planDispatch ?? dispatch;
               try {
                 const exitResult = handleExitPlanMode(String(signal.args?.reason ?? ""), planDispatch, ctx);
@@ -11022,7 +11048,7 @@ ${enrichedInput}`;
               _lastToolInputs[name] = JSON.stringify(inp);
               recordToolUse(name, "xml", _lastToolInputs[name], "running");
               emitXmlToolEvent(name, inp, "running");
-              const LOOP_ORCH = /* @__PURE__ */ new Set(["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal"]);
+              const LOOP_ORCH = /* @__PURE__ */ new Set(["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal", "Conquer"]);
               if (LOOP_ORCH.has(name)) {
                 if (cesarFastPath) {
                   return;
@@ -11095,7 +11121,7 @@ ${enrichedInput}`;
             output: "A Cesar plan is already active; nested plans are blocked. Resume or cancel the current plan before proposing another."
           });
         } else {
-          const { handleProposePlan } = await import("./plan-mode-DCE7VGQV.js");
+          const { handleProposePlan } = await import("./plan-mode-OSU42TOI.js");
           const planDispatch = ctx.cesar.planDispatch ?? dispatch;
           const plan = await handleProposePlan(ppArgs, planDispatch, ctx);
           if (ctx.setActivePlan) ctx.setActivePlan(plan);
@@ -11119,7 +11145,7 @@ ${enrichedInput}`;
       const epArgs = ctx.cesar._exitPlanModeArgs;
       delete ctx.cesar._exitPlanModeArgs;
       try {
-        const { handleExitPlanMode } = await import("./plan-mode-DCE7VGQV.js");
+        const { handleExitPlanMode } = await import("./plan-mode-OSU42TOI.js");
         const planDispatch = ctx.cesar.planDispatch ?? dispatch;
         const exitResult = handleExitPlanMode(String(epArgs?.reason ?? ""), planDispatch, ctx);
         dispatch({ type: "tool-call", engineId: cesarEngineId, tool: "ExitPlanMode", input: JSON.stringify(epArgs ?? {}), status: "done", output: exitResult });
@@ -11397,7 +11423,7 @@ ${cleanFinalAnswer}` : cleanFinalAnswer;
       }
     }
     const _AUTO_CONT_WRITE_TOOLS = /* @__PURE__ */ new Set(["Edit", "Write", "MultiEdit", "NotebookEdit"]);
-    const _AUTO_CONT_LOOP_ORCH = /* @__PURE__ */ new Set(["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal"]);
+    const _AUTO_CONT_LOOP_ORCH = /* @__PURE__ */ new Set(["Forge", "Brainstorm", "Tribunal", "Campfire", "Pipeline", "Review", "Agent", "Goal", "Conquer"]);
     const _AUTO_CONT_CONTINUE_RE = /\b(?:now i'?ll|next i'?ll|still need|let me also|i'?ll also|then i'?ll|next step|next up)\b/i;
     const _AUTO_CONT_READONLY_DONE_RE = /\b(?:tests? passed|all (?:tests|checks) pass|no matches found|no issues found|no errors|all clean|nothing to (?:do|fix|change)|already (?:correct|fixed|in place|done))\b/i;
     const _detectTurnState = (resp, baselineToolCount) => {
@@ -11461,7 +11487,7 @@ ${cleanFinalAnswer}` : cleanFinalAnswer;
       },
       maxTurns: cesarFastPath ? fastPathMaxBudget : void 0
     });
-    const _shouldAutoContinue = (hadToolActivity || ranToolLoop) && !inPlanMode && !ctx.cesar.pendingDelegation && session.alive && !abort.signal.aborted && !_engineErrored && response.trim().length > 0;
+    const _shouldAutoContinue = (hadToolActivity || ranToolLoop) && !inPlanMode && !answerFastPath && !ctx.cesar.pendingDelegation && session.alive && !abort.signal.aborted && !_engineErrored && response.trim().length > 0;
     if (_shouldAutoContinue) {
       const MAX_CONTINUATIONS = 5;
       let _continuations = 0;
@@ -11706,8 +11732,9 @@ ${cleanFinalAnswer}` : cleanFinalAnswer;
         const full = m[3].trim();
         _forkOptions.push({ key, label: full.length > 60 ? full.slice(0, 59) + "\u2026" : full, full });
       }
-      const isForkQuestion = /\?\s*$/.test(lastLine) && _forkOptions.length >= 2 && _forkOptions.length <= 6;
-      const asksConfirmation = !ranToolLoop && /\?\s*$/.test(lastLine) && /\b(want|shall|should|ready|proceed|go ahead|dispatch|confirm|continue|implement)\b/i.test(lastLine);
+      const _isChatTurn = routingHints.intakeKind === "chat" || routingHints.recommendedFlow === "answer";
+      const isForkQuestion = !_isChatTurn && /\?\s*$/.test(lastLine) && _forkOptions.length >= 2 && _forkOptions.length <= 6;
+      const asksConfirmation = !_isChatTurn && !ranToolLoop && /\?\s*$/.test(lastLine) && /\b(want|shall|should|ready|proceed|go ahead|dispatch|confirm|continue|implement)\b/i.test(lastLine);
       if (isForkQuestion) {
         const _forkColors = ["#4ade80", "#22d3ee", "#fbbf24", "#a78bfa", "#f97316", "#ef4444"];
         const _allNumeric = _forkOptions.every((o) => /^[0-9]$/.test(o.key));
@@ -11888,4 +11915,4 @@ export {
   ensureCesarSession,
   handleCesarBrain
 };
-//# sourceMappingURL=chunk-IA4AR2R4.js.map
+//# sourceMappingURL=chunk-XOJPAFCJ.js.map