@livx.cc/agentx 0.99.122 → 0.99.124

package/dist/index.js

@@ -120,13 +120,13 @@ function elideImageParts(content, hit, stub) {
 }
 function mintImageRef(path, mime) {
   const token = randomBytes(16).toString("hex");
-  let bytes = 0;
+  let bytes2 = 0;
   try {
-    bytes = Math.ceil(statSync2(path).size * 4 / 3);
+    bytes2 = Math.ceil(statSync2(path).size * 4 / 3);
   } catch (e) {
     log3.warn(`image ref stat failed, weighing as 0: ${path}`, e);
   }
-  refRegistry.set(token, { mime, path, bytes });
+  refRegistry.set(token, { mime, path, bytes: bytes2 });
   while (refRegistry.size > REF_REGISTRY_MAX) refRegistry.delete(refRegistry.keys().next().value);
   return `${IMAGE_REF_SCHEME}${mime};${token};${path}`;
 }
@@ -799,6 +799,7 @@ var init_tools_structured = __esm({
     };
     writeTool = {
       name: "Write",
+      writes: true,
       description: "Create or overwrite a file with the given contents, creating parent directories as needed. Use for new files instead of `bash echo >`. To replace an EXISTING file you must Read it first \u2014 overwriting an un-Read file is refused (it would destroy unseen content).",
       parameters: {
         type: "object",
@@ -824,6 +825,7 @@ var init_tools_structured = __esm({
     };
     multiEditTool = {
       name: "MultiEdit",
+      writes: true,
       description: "Apply several exact-substring replacements to one file in order, in a single call. Requires a prior Read. Each `old_string` must be unique at the time it is applied. All-or-nothing: if any edit fails, none are written.",
       parameters: {
         type: "object",
@@ -865,6 +867,7 @@ var init_tools_structured = __esm({
     };
     applyEditsTool = {
       name: "ApplyEdits",
+      writes: true,
       description: "Apply edits across one or MORE files in a single call \u2014 for cross-file refactors (rename/extract/move). edits=[{path, old_string?, new_string}]. WITH old_string: replace that exact substring (must be UNIQUE in the file \u2014 add surrounding context; read fresh + verified, no prior Read needed). WITHOUT old_string: write new_string as the whole file (creates it + parent dirs; but to OVERWRITE a file that already exists you must Read it first, else use old_string to edit part of it). Locate sites first with Grep (its output shows the exact text). Atomic: validated across all files before any write.",
       parameters: {
         type: "object",
@@ -1579,6 +1582,7 @@ var init_tools = __esm({
     };
     bashTool = {
       name: "bash",
+      writes: true,
       description: "Run a shell command. Supports ls, cat, grep, find, head, tail, echo, mkdir, rm, mv, cp, wc, pipes (|), redirects (>, >>), and chaining (&&, ||, ;). Best for: running tests/builds, file operations (mkdir/mv/rm), and piped workflows. For searching file contents, prefer `Grep` (structured results, no re-parse). For finding files by name, prefer `Glob`.",
       parameters: {
         type: "object",
@@ -1630,14 +1634,14 @@ var init_tools = __esm({
             if (!await ctx.fs.exists(path)) return `Error: File not found: ${path}`;
             return imageRefResult(real, IMG_MIME[ext]);
           }
-          const bytes = await fs.readFileBytes(path);
-          const b64 = Buffer.from(bytes).toString("base64");
+          const bytes2 = await fs.readFileBytes(path);
+          const b64 = Buffer.from(bytes2).toString("base64");
           return JSON.stringify({ dataUrl: `data:${IMG_MIME[ext]};base64,${b64}`, image: path });
         }
         const raw = await ctx.fs.readFile(path);
         if (isBinary(raw)) {
-          const bytes = await byteSize(ctx.fs, path, raw);
-          return `[binary file: ${path} \u2014 ${bytes} bytes, not shown as text. Read renders png/jpg/jpeg/gif/webp images directly; otherwise attach it as @${path}.]`;
+          const bytes2 = await byteSize(ctx.fs, path, raw);
+          return `[binary file: ${path} \u2014 ${bytes2} bytes, not shown as text. Read renders png/jpg/jpeg/gif/webp images directly; otherwise attach it as @${path}.]`;
         }
         ctx.readState.set(ctx.fs.resolvePath(path), raw);
         if (raw === "") return `[empty file: ${path} \u2014 0 bytes]`;
@@ -1656,6 +1660,7 @@ var init_tools = __esm({
     };
     editTool = {
       name: "Edit",
+      writes: true,
       description: "Replace an exact substring in a file. Requires a prior Read of the same file. `old_string` must occur exactly once \u2014 include surrounding context to disambiguate.",
       parameters: {
         type: "object",
@@ -1967,8 +1972,8 @@ var init_tools_jobs = __esm({
         return [...this.jobs.values()].map((j) => this.info(j));
       }
       info(j) {
-        const { id, kind, label, status, startedAt, lastActivityAt, endedAt, reason, bytes, holds, result } = j;
-        return { id, kind, label, status, startedAt, lastActivityAt, endedAt, reason, bytes, holds, result };
+        const { id, kind, label, status, startedAt, lastActivityAt, endedAt, reason, bytes: bytes2, holds, result } = j;
+        return { id, kind, label, status, startedAt, lastActivityAt, endedAt, reason, bytes: bytes2, holds, result };
       }
       /** Wait (bounded) for a job to settle. Resolves the job's info either way; null for an unknown id. */
       async wait(id, timeoutMs) {
@@ -2402,7 +2407,8 @@ var init_JailedFilesystem = __esm({
       violate(op, abs, rule) {
         this.note(op, abs, rule);
         if (rule === "deny" || rule === "confine") throw new Error(`File not found: ${abs}`);
-        throw new Error(`Blocked by filesystem jail (${rule}): ${abs}`);
+        const hint = rule === "readonly" && this.options.readonlyHint ? ` \u2014 ${this.options.readonlyHint}` : "";
+        throw new Error(`Blocked by filesystem jail (${rule}): ${abs}${hint}`);
       }
       /** Fire the audit hook without throwing (for boolean probes that must still return false). */
       note(op, abs, rule) {
@@ -2527,6 +2533,8 @@ var init_JailedFilesystem = __esm({
       deny = [...DEFAULT_DENY];
       /** Globs readable but not writable/deletable (the pinned constitution). */
       readonly = [];
+      /** Appended to readonly-violation errors (e.g. "edit it via the kb tool instead"). */
+      readonlyHint;
       /** If set, only paths matching these globs are accessible at all. */
       confineTo;
       /** Audit hook fired on every blocked operation (drives the circuit breaker). */
@@ -2792,6 +2800,7 @@ function makeRealShellTool(options) {
   };
   return {
     name: "Shell",
+    writes: true,
     // Rebind for an isolated child agent (git worktree): same policy/env/timeouts, new cwd. The
     // `registry` is deliberately dropped — it is bound to the PARENT's cwd (and, in hosts like
     // shraga-ee, to the parent's session), so a background job started from the child would run
@@ -3281,69 +3290,39 @@ ${prompt} [y/N] `);
   }
 };
 
-// src/relevance.ts
-var STOP = /* @__PURE__ */ new Set([
-  "the",
-  "and",
-  "for",
-  "with",
-  "that",
-  "this",
-  "from",
-  "into",
-  "your",
-  "you",
-  "are",
-  "was",
-  "will",
-  "use",
-  "using",
-  "run",
-  "add",
-  "fix",
-  "make",
-  "file",
-  "files",
-  "code",
-  "please",
-  "need",
-  "want",
-  "should",
-  "all"
-]);
-function tokenize(s) {
-  const out = /* @__PURE__ */ new Set();
-  for (const w of String(s ?? "").toLowerCase().match(/[a-z0-9]+/g) ?? []) {
-    if (w.length >= 3 && !STOP.has(w)) out.add(w);
-  }
-  return out;
-}
-function idfWeights(corpus) {
-  const N = corpus.length;
-  if (N === 0) return /* @__PURE__ */ new Map();
-  const df = /* @__PURE__ */ new Map();
-  for (const doc of corpus) for (const t of tokenize(doc)) df.set(t, (df.get(t) ?? 0) + 1);
-  const idf = /* @__PURE__ */ new Map();
-  for (const [t, n] of df) idf.set(t, Math.log((N + 1) / (n + 1)) + 1);
-  return idf;
-}
-function relevanceScore(text, queryTokens, idf) {
-  if (queryTokens.size === 0) return 0;
-  const t = tokenize(text);
-  let score = 0;
-  for (const q of queryTokens) if (t.has(q)) score += idf?.get(q) ?? 1;
-  return score;
-}
-function topByRelevance(items, query, text, k, corpus) {
-  if (!Number.isInteger(k) || k < 1) return { kept: items, rest: [] };
-  if (items.length <= k || !query.trim()) return { kept: items, rest: [] };
-  const q = tokenize(query);
-  if (q.size === 0) return { kept: items.slice(0, k), rest: items.slice(k) };
-  const idf = corpus?.length ? idfWeights(corpus) : void 0;
-  const scored = items.map((x, i) => ({ i, s: relevanceScore(text(x), q, idf) }));
-  scored.sort((a, b) => b.s - a.s || a.i - b.i);
-  const keep = new Set(scored.slice(0, k).map((e) => e.i));
-  return { kept: items.filter((_, i) => keep.has(i)), rest: items.filter((_, i) => !keep.has(i)) };
+// src/catalog.ts
+var DEFAULT_CATALOG_BUDGET = 6e3;
+var enc = new TextEncoder();
+var bytes = (s) => enc.encode(s).length;
+function clip(s, n) {
+  const cps = [...s];
+  if (cps.length <= n) return s;
+  return n <= 1 ? "\u2026" : cps.slice(0, n - 1).join("").trimEnd() + "\u2026";
+}
+function formatCatalog(entries, opts) {
+  const budget = opts.budgetBytes ?? DEFAULT_CATALOG_BUDGET;
+  const pre = opts.namePrefix ?? "";
+  const wrap = (body) => [opts.title, body, opts.footer].filter((x) => x !== void 0 && x !== "").join("\n");
+  const render = (max) => wrap(entries.map((e) => {
+    const d = (e.description ?? "").replace(/\s+/g, " ").trim();
+    const desc = d && max > 0 ? ` \u2014 ${clip(d, max)}` : "";
+    return `- **${pre}${e.name}**${desc}${e.path ? ` (\`${e.path}\`)` : ""}`;
+  }).join("\n"));
+  const longest = Math.max(0, ...entries.map((e) => [...e.description ?? ""].length));
+  const full = render(longest);
+  if (bytes(full) <= budget) return full;
+  if (bytes(render(0)) <= budget) {
+    let lo = 0, hi = longest;
+    while (lo < hi) {
+      const mid = Math.ceil((lo + hi) / 2);
+      if (bytes(render(mid)) <= budget) lo = mid;
+      else hi = mid - 1;
+    }
+    return render(lo);
+  }
+  const names = wrap(entries.map((e) => `- **${pre}${e.name}**`).join("\n"));
+  if (bytes(names) <= budget) return names;
+  return wrap(`- ${entries.map((e) => pre + e.name).join(", ")}`);
 }
 
 // src/frontmatter.ts
@@ -3365,7 +3344,6 @@ function grabField(block, key) {
 }
 
 // src/commands.ts
-var MAX_CATALOG = 25;
 function parseFrontmatter(md) {
   const { block, body } = splitFrontmatter(md);
   return { description: grabField(block, "description"), body };
@@ -3422,9 +3400,12 @@ async function scanCommands(fs, dir) {
 async function loadCommands(fs, dir, opts = {}) {
   const commands = await scanCommands(fs, dir);
   if (commands.length === 0) return { commands, catalog: "" };
-  const { kept, rest } = topByRelevance(commands, opts.relevanceHint ?? "", (c) => `${c.name} ${c.description}`, opts.max ?? MAX_CATALOG);
-  const catalog = "## Slash commands (reusable prompt templates)\n" + kept.map((c) => `- **/${c.name}** \u2014 ${c.description} (\`${c.path}\`)`).join("\n") + (rest.length ? `
-- (${rest.length} more, names only \u2014 call \`SlashCommand\` to run): ${rest.map((c) => c.name).join(", ")}` : "") + "\nTo run one, call the `SlashCommand` tool with its name (and optional `args`); it returns the expanded template to act on.";
+  const catalog = formatCatalog(commands, {
+    title: "## Slash commands (reusable prompt templates)",
+    footer: "To run one, call the `SlashCommand` tool with its name (and optional `args`); it returns the expanded template to act on.",
+    namePrefix: "/",
+    budgetBytes: opts.budgetBytes
+  });
   const tool = {
     name: "SlashCommand",
     description: "Run a slash command (or skill) by name \u2014 returns its expanded prompt template/instructions (with your `args` substituted/appended). Resolves both the command and skill namespaces. Use when a task matches a listed command or skill.",
@@ -3452,7 +3433,6 @@ async function loadCommands(fs, dir, opts = {}) {
 }
 
 // src/skills.ts
-var MAX_CATALOG2 = 25;
 function parseFrontmatter2(md) {
   const { block } = splitFrontmatter(md);
   const b = block || md.slice(0, 600);
@@ -3478,9 +3458,11 @@ async function scanSkills(fs, dir) {
 async function loadSkills(fs, dir, opts = {}) {
   const skills = await scanSkills(fs, dir);
   if (skills.length === 0) return { skills, catalog: "" };
-  const { kept, rest } = topByRelevance(skills, opts.relevanceHint ?? "", (s) => `${s.name} ${s.description}`, opts.max ?? MAX_CATALOG2);
-  const catalog = "## Skills (load one before acting on a matching task)\n" + kept.map((s) => `- **${s.name}** \u2014 ${s.description} (\`${s.path}\`)`).join("\n") + (rest.length ? `
-- (${rest.length} more, names only \u2014 call \`Skill\` to load): ${rest.map((s) => s.name).join(", ")}` : "") + "\nWhen a task matches a skill, call the `Skill` tool with its name to load its full instructions.";
+  const catalog = formatCatalog(skills, {
+    title: "## Skills (load one before acting on a matching task)",
+    footer: "When a task matches a skill, call the `Skill` tool with its name to load its full instructions.",
+    budgetBytes: opts.budgetBytes
+  });
   const tool = {
     name: "Skill",
     description: "Load a skill (or slash command) by name \u2014 returns its full instructions (SKILL.md / expanded template), with any `args` substituted/appended. Resolves both the skill and command namespaces. Use when a task matches a listed skill or command.",
@@ -3505,7 +3487,73 @@ async function loadSkills(fs, dir, opts = {}) {
 
 // src/memory.ts
 init_tools_structured();
-var MAX_INDEX = 25;
+
+// src/relevance.ts
+var STOP = /* @__PURE__ */ new Set([
+  "the",
+  "and",
+  "for",
+  "with",
+  "that",
+  "this",
+  "from",
+  "into",
+  "your",
+  "you",
+  "are",
+  "was",
+  "will",
+  "use",
+  "using",
+  "run",
+  "add",
+  "fix",
+  "make",
+  "file",
+  "files",
+  "code",
+  "please",
+  "need",
+  "want",
+  "should",
+  "all"
+]);
+function tokenize(s) {
+  const out = /* @__PURE__ */ new Set();
+  for (const w of String(s ?? "").toLowerCase().match(/[a-z0-9]+/g) ?? []) {
+    if (w.length >= 3 && !STOP.has(w)) out.add(w);
+  }
+  return out;
+}
+function idfWeights(corpus) {
+  const N = corpus.length;
+  if (N === 0) return /* @__PURE__ */ new Map();
+  const df = /* @__PURE__ */ new Map();
+  for (const doc of corpus) for (const t of tokenize(doc)) df.set(t, (df.get(t) ?? 0) + 1);
+  const idf = /* @__PURE__ */ new Map();
+  for (const [t, n] of df) idf.set(t, Math.log((N + 1) / (n + 1)) + 1);
+  return idf;
+}
+function relevanceScore(text, queryTokens, idf) {
+  if (queryTokens.size === 0) return 0;
+  const t = tokenize(text);
+  let score = 0;
+  for (const q of queryTokens) if (t.has(q)) score += idf?.get(q) ?? 1;
+  return score;
+}
+function topByRelevance(items, query, text, k, corpus) {
+  if (!Number.isInteger(k) || k < 1) return { kept: items, rest: [] };
+  if (items.length <= k || !query.trim()) return { kept: items, rest: [] };
+  const q = tokenize(query);
+  if (q.size === 0) return { kept: items.slice(0, k), rest: items.slice(k) };
+  const idf = corpus?.length ? idfWeights(corpus) : void 0;
+  const scored = items.map((x, i) => ({ i, s: relevanceScore(text(x), q, idf) }));
+  scored.sort((a, b) => b.s - a.s || a.i - b.i);
+  const keep = new Set(scored.slice(0, k).map((e) => e.i));
+  return { kept: items.filter((_, i) => keep.has(i)), rest: items.filter((_, i) => !keep.has(i)) };
+}
+
+// src/memory.ts
 var MAX_INDEX_LINES = 200;
 var MAX_INDEX_BYTES = 25e3;
 var MEMORY_PROMPT = '## Memory guidelines\n**When to Remember:** user corrections ("no, do X instead"), preferences ("I prefer Y"), project constraints, recurring gotchas, role/context ("I\'m a data scientist"), workflow patterns confirmed by the user. Capture the WHY, not just the what.\n**When NOT to Remember:** task-specific scratch, transient state, things derivable from code/git, conversation filler, anything already in instruction files. If removing the memory wouldn\'t change future behavior, don\'t save it.\n**Types** (pass to Remember \u2014 this determines where the memory is stored):\n- `user` \u2014 role, preferences, knowledge level, collaboration style (GLOBAL \u2014 follows you across projects)\n- `feedback` \u2014 corrections, what to avoid/repeat, with WHY (GLOBAL)\n- `project` \u2014 ongoing work, goals, constraints, deadlines (LOCAL to this project; convert relative dates to absolute)\n- `reference` \u2014 pointers to external resources, URLs, vendor docs (LOCAL to this project)\n**Before acting on a recalled memory:** verify it\'s still true \u2014 a memory naming a file/function/flag is a claim from when it was written. Grep/read to confirm before recommending. Stale memory \u2192 update via Remember (same slug overwrites).\n**Forget:** when the user asks to remove/delete/forget a memory, call `Forget` with its slug \u2014 it deletes the fact and its index line. Never "remove" by re-Remembering a note that says it was removed: that keeps the memory.\n**Dedup:** before writing, check if a similar memory exists (Recall or MemorySearch). Update the existing one rather than creating duplicates.\nCall `Recall` with a slug (or multiple slugs/a pattern) to load full bodies when relevant.\nCall `MemorySearch` with a query to find memories by content when you don\'t know the slug.\nCall `Remember` to persist a durable fact for future sessions.';
@@ -3540,10 +3588,18 @@ async function loadMemory(fs, dir, opts = {}) {
     }
   }
   if (!hasContent) return { index: MEMORY_PROMPT, tools };
-  const { kept, rest } = topByRelevance(allPointers, opts.relevanceHint ?? "", (l) => l, opts.max ?? MAX_INDEX);
-  const restSlugs = rest.map((l) => l.match(/\]\(([^)]+)\.md\)/)?.[1] ?? l.match(/\[([^\]]+)\]/)?.[1] ?? "").filter(Boolean);
-  const index = MEMORY_PROMPT + "\n\n## Memory index (persistent context \u2014 recalled across sessions)\n" + (header ? header + "\n" : "") + kept.join("\n") + (restSlugs.length ? `
-- (${restSlugs.length} more learnings, slugs only \u2014 call \`Recall\` if relevant): ${restSlugs.join(", ")}` : "");
+  const entries = allPointers.map((l) => {
+    const m = l.match(/\]\(([^)]+)\.md\)/);
+    const slug2 = m?.[1] ?? l;
+    const title = m ? l.slice(l.indexOf("[") + 1, m.index).trim() : "";
+    const hook = m ? l.slice(m.index + m[0].length).replace(/^\s*(?:[—:-]\s*)?/, "").trim() : "";
+    return { name: slug2, description: title && title !== slug2 ? hook ? `${title} \u2014 ${hook}` : title : hook };
+  });
+  const index = MEMORY_PROMPT + "\n\n" + formatCatalog(entries, {
+    title: "## Memory index (persistent context \u2014 recalled across sessions)" + (header ? "\n" + header : ""),
+    footer: "Call `Recall` with a slug to load its full fact.",
+    budgetBytes: opts.budgetBytes
+  });
   return { index, tools };
 }
 var TERM_STOPWORDS = new Set(`the and for but not you your yours our ours his her hers its their they them this that these those
@@ -3708,8 +3764,8 @@ function memorySearchTool(fs, dirs) {
           return `Error: invalid regex: ${e}`;
         }
       } else {
-        const lower = q.toLowerCase();
-        matcher = (l) => l.toLowerCase().includes(lower);
+        const lower2 = q.toLowerCase();
+        matcher = (l) => l.toLowerCase().includes(lower2);
       }
       const loaded = [];
       for (const slug2 of slugs) {
@@ -3817,6 +3873,25 @@ ${sections.join("\n\n---\n\n")}`;
   }
   return "";
 }
+async function loadContextFiles(fs, specs = []) {
+  const sections = [];
+  for (const { path, maxChars, label } of specs) {
+    if (!await fs.exists(path)) continue;
+    let md = (await fs.readFile(path)).trim();
+    if (!md) continue;
+    if (maxChars !== void 0) {
+      const cps = [...md], n = Math.max(0, maxChars);
+      if (cps.length > n) md = `${cps.slice(0, n).join("").trimEnd()}
+\u2026 (truncated \u2014 full file: ${path})`;
+    }
+    sections.push(`<!-- ${path} -->
+${label ? `### ${label}
+` : ""}${md}`);
+  }
+  return sections.length ? `## Context files
+
+${sections.join("\n\n---\n\n")}` : "";
+}
 
 // src/subagent.ts
 init_tools();
@@ -4509,6 +4584,11 @@ init_logging();
 var log8 = forComponent("modes");
 var WRITE_TOOLS = /* @__PURE__ */ new Set(["Write", "Edit", "MultiEdit", "ApplyEdits"]);
 var PLANNER_BLOCKED = /* @__PURE__ */ new Set([...WRITE_TOOLS, "bash", "Shell"]);
+var lower = (xs) => new Set([...xs].map((x) => x.toLowerCase()));
+var PLANNER_BLOCKED_LC = lower(PLANNER_BLOCKED);
+var WRITE_TOOLS_LC = lower(WRITE_TOOLS);
+var plannerBlocks = (t) => !!t.writes || PLANNER_BLOCKED_LC.has(t.name.toLowerCase());
+var isFileWrite = (t) => WRITE_TOOLS_LC.has(t.name.toLowerCase());
 var PLANNER_REFUSAL = "Refused: you are the planner and do not write files. Delegate the change with Task/TaskBatch (model set to the worker) and give the worker a full spec.";
 var PLAN_FIRST = "Refused: check your plan with `Advise` before the first write (files, data shape, the hard parts). Then write.";
 var ADVISE_LIMIT = 3;
@@ -4531,7 +4611,7 @@ function advisorFor(worker, advisor) {
   return advisor && pairOk("advisor", worker, advisor) ? advisor : void 0;
 }
 function delegateTools(tools, planner) {
-  return tools.map((t) => !PLANNER_BLOCKED.has(t.name) ? t : {
+  return tools.map((t) => !plannerBlocks(t) ? t : {
     ...t,
     run: async (...a) => a[1]?.model === planner ? PLANNER_REFUSAL : t.run(...a)
   });
@@ -4601,7 +4681,7 @@ ${question}` }
       }
     }
   };
-  const gate = (tools) => tools.map((t) => !WRITE_TOOLS.has(t.name) ? t : { ...t, run: async (...a) => used ? t.run(...a) : PLAN_FIRST });
+  const gate = (tools) => tools.map((t) => !isFileWrite(t) ? t : { ...t, run: async (...a) => used ? t.run(...a) : PLAN_FIRST });
   return { tool, gate, used: () => used };
 }
 function meterWorkers(ai, main) {
@@ -4644,6 +4724,13 @@ function meterWorkers(ai, main) {
     resolved = void 0;
   } };
 }
+var CC_WRITE_TOOLS = ["Write", "Edit", "MultiEdit", "NotebookEdit"];
+function ccModeOptions(kind, hostHooks, used) {
+  if (kind === "delegate") return { bridge: /* @__PURE__ */ new Set(["Task", "TaskBatch"]), disallow: [...CC_WRITE_TOOLS, "Bash", "Task", "Agent"] };
+  if (kind !== "advisor") return { bridge: /* @__PURE__ */ new Set(), disallow: [] };
+  const gate = { matcher: CC_WRITE_TOOLS.join("|"), hooks: [async () => used() ? {} : { hookSpecificOutput: { hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason: PLAN_FIRST.replace("`Advise`", "`mcp__agentx__Advise`") } }] };
+  return { bridge: /* @__PURE__ */ new Set(["Advise"]), disallow: [], hooks: { ...hostHooks, PreToolUse: [...hostHooks?.PreToolUse ?? [], gate] } };
+}
 
 // src/lint.ts
 var CODE_RE = /\.(ts|tsx|js|jsx|mjs|cjs)$/;
@@ -4844,6 +4931,8 @@ var AgentOptions = class {
    *  Walks the VFS tree and merges all found files (general → specific, like Claude Code).
    *  `true` (default) = auto-discover standard names. `string[]` = custom names. `false` = skip. */
   instructionFiles = true;
+  /** Extra files injected right after the instructions (missing → skipped; over `maxChars` → head + pointer to the full file). */
+  contextFiles;
   /** Host interaction channel (human-in-the-loop). If set: adds the `AskUserQuestion` tool. */
   host;
   /** Add the `AskUserQuestion` tool when a host is present (default true). Set false for an agent that
@@ -4971,6 +5060,8 @@ var Agent = class _Agent {
   meter;
   // delegate/advisor: meters the second model's calls
   modeModel;
+  modeKind;
+  adv;
   lastTask = "";
   // the current turn's text — what the advisor reads as the request
   /** claude-code bridge for agentx-only tools (ccBridge.ts) + the current step's executor it calls. */
@@ -5075,12 +5166,15 @@ var Agent = class _Agent {
     const o = this.options;
     if (!o.model.startsWith("claude-code/")) return void 0;
     const po = { steer: () => this.drainPendingSteers() };
-    const bridged = (t) => o.ccBridge === "all" || CC_BRIDGED.has(t.name);
+    const mode = ccModeOptions(this.modeKind, o.providerOptions?.hooks, () => this.adv?.used() ?? 0);
+    const bridged = (t) => o.ccBridge === "all" || CC_BRIDGED.has(t.name) || mode.bridge.has(t.name);
     if (o.providerOptions?.claudeCodeSession && this.activeTools.some(bridged)) {
       this.ccServer ??= ccToolServer("agentx", () => this.activeTools.filter(bridged), (n, a) => this.ccExec(n, a));
       po.mcpServers = { ...o.providerOptions?.mcpServers, agentx: this.ccServer };
     }
-    const denyTools = claudeCodeDisallowedTools(o.permissions);
+    const denyTools = [...claudeCodeDisallowedTools(o.permissions), ...mode.disallow];
+    if (mode.hooks) po.hooks = mode.hooks;
+    if (this.modeKind && o.providerOptions?.claudeCodeSession) po.claudeCodeSession = `${o.providerOptions.claudeCodeSession}:${this.modeKind}`;
     if (denyTools.length) {
       const prior = o.providerOptions?.disallowedTools ?? [];
       po.disallowedTools = [.../* @__PURE__ */ new Set([...prior, ...denyTools])];
@@ -5167,7 +5261,7 @@ var Agent = class _Agent {
    * across turns (and the frozen prompt pairs well with prompt caching). Does NOT touch
    * the transcript; `run`/`send` own that.
    */
-  async prepare(taskHint) {
+  async prepare() {
     if (this.prepared) return this.systemPromptCache;
     const o = this.options;
     const fs = o.fs;
@@ -5178,14 +5272,19 @@ var Agent = class _Agent {
     const advisor = !worker && o.advisor ? advisorFor(o.model, o.advisor.model) : void 0;
     this.meter = worker || advisor ? meterWorkers(o.ai, o.model) : void 0;
     const ai = this.meter?.ai ?? o.ai;
-    const adv = advisor ? makeAdvisor({ ai, advisor, request: () => this.lastTask, snapshot: o.advisor.snapshot, limit: o.advisor.limit }) : void 0;
+    this.modeKind = worker ? "delegate" : advisor ? "advisor" : void 0;
+    const adv = this.adv = advisor ? makeAdvisor({ ai, advisor, request: () => this.lastTask, snapshot: o.advisor.snapshot, limit: o.advisor.limit }) : void 0;
     if (o.instructionFiles !== false) {
       const names = Array.isArray(o.instructionFiles) ? o.instructionFiles : void 0;
       const ins = await loadInstructions(fs, names);
       if (ins) systemPrompt += "\n\n" + ins;
     }
+    if (o.contextFiles?.length) {
+      const ctxFiles = await loadContextFiles(fs, o.contextFiles);
+      if (ctxFiles) systemPrompt += "\n\n" + ctxFiles;
+    }
     if (o.memoryDir) {
-      const { index, tools: memTools } = await loadMemory(fs, o.memoryDir, { relevanceHint: taskHint, userDir: o.memoryUserDir });
+      const { index, tools: memTools } = await loadMemory(fs, o.memoryDir, { userDir: o.memoryUserDir });
       if (index) systemPrompt += "\n\n" + index;
       tools = [...tools, ...memTools];
     }
@@ -5195,7 +5294,7 @@ var Agent = class _Agent {
         const c = (await scanCommands(fs, commandsDir)).find((x) => x.name === name);
         return c ? { path: c.path, stripFrontmatter: true } : void 0;
       } : void 0;
-      const { catalog, tool } = await loadSkills(fs, skillsDir, { relevanceHint: taskHint, sibling });
+      const { catalog, tool } = await loadSkills(fs, skillsDir, { sibling });
       if (catalog) systemPrompt += "\n\n" + catalog;
       if (tool) tools = [...tools, tool];
     }
@@ -5204,7 +5303,7 @@ var Agent = class _Agent {
         const s = (await scanSkills(fs, skillsDir)).find((x) => x.name === name);
         return s ? { path: s.path, stripFrontmatter: false } : void 0;
       } : void 0;
-      const { catalog, tool } = await loadCommands(fs, commandsDir, { relevanceHint: taskHint, sibling });
+      const { catalog, tool } = await loadCommands(fs, commandsDir, { sibling });
       if (catalog) systemPrompt += "\n\n" + catalog;
       if (tool) tools = [...tools, tool];
     }
@@ -5263,7 +5362,7 @@ var Agent = class _Agent {
     this.invokedTools.clear();
     this.fabricatedClaims.clear();
     this.lastTask = contentText(task);
-    const systemPrompt = await this.prepare(contentText(task));
+    const systemPrompt = await this.prepare();
     const startCtx = await this.fireSessionStart();
     const userContent = await this.applyPromptSubmit(task);
     this.transcript = [
@@ -5299,7 +5398,7 @@ var Agent = class _Agent {
   async send(task) {
     await this.ensureFs();
     this.lastTask = contentText(task);
-    const systemPrompt = await this.prepare(contentText(task));
+    const systemPrompt = await this.prepare();
     const startCtx = await this.fireSessionStart();
     const userContent = await this.applyPromptSubmit(task);
     const sys = systemPrompt + (startCtx ? "\n\n" + startCtx : "");
@@ -6123,9 +6222,9 @@ function capOversizedBodies(messages, target, keepRecentImages = 1) {
   return out;
 }
 function elideBody(x, cap) {
-  const note = (bytes, imgs2) => `
+  const note = (bytes2, imgs2) => `
 
-[${bytes} bytes elided by /compact${x.role === "tool" ? " \u2014 re-run the tool to view" : ""}${imgs2 ? `; ${imgs2} image part(s) KEPT in full \u2014 they still cost context` : ""}]`;
+[${bytes2} bytes elided by /compact${x.role === "tool" ? " \u2014 re-run the tool to view" : ""}${imgs2 ? `; ${imgs2} image part(s) KEPT in full \u2014 they still cost context` : ""}]`;
   if (!Array.isArray(x.content)) {
     const text = contentText(x.content);
     if (text.length <= cap) return x;
@@ -7365,8 +7464,8 @@ function isTranscriptComplete(text) {
   const lastWord = words3[words3.length - 1];
   if (COMPLETE_ENDINGS.has(lastWord)) return true;
   if (INCOMPLETE_ENDINGS.has(lastWord)) return false;
-  const lower = trimmed.toLowerCase();
-  for (const marker of CONTINUATION_MARKERS) if (lower.endsWith(marker)) return false;
+  const lower2 = trimmed.toLowerCase();
+  for (const marker of CONTINUATION_MARKERS) if (lower2.endsWith(marker)) return false;
   if (words3.length <= 2) return false;
   return true;
 }
@@ -12061,11 +12160,11 @@ Another agent just implemented the above. Independently check the CURRENT state
         const list = id ? [this.tasks.get(String(id))].filter(Boolean) : [...this.tasks.values()];
         if (!list.length) return id ? `No task '${id}'.` : "No background tasks.";
         const cap = id ? 1500 : 300;
-        const clip = (x) => x.length > cap ? `${x.slice(0, cap)}\u2026 (truncated)` : x;
+        const clip2 = (x) => x.length > cap ? `${x.slice(0, cap)}\u2026 (truncated)` : x;
         return list.map((t) => {
           const head = `${t.id} (${t.label}): ${t.status}`;
           const body = (t.status === "done" ? t.spokenText?.trim() || t.result?.trim() : t.status === "error" ? t.result?.trim() : "") ?? "";
-          return body ? `${head}. ${t.status === "error" ? "Error" : "Result"}: ${clip(body)}` : head;
+          return body ? `${head}. ${t.status === "error" ? "Error" : "Result"}: ${clip2(body)}` : head;
         }).join("\n");
       }
     };
@@ -13961,10 +14060,12 @@ export {
   Agent,
   AgentOptions,
   BodDbFilesystem,
+  CC_WRITE_TOOLS,
   CartesiaTTS,
   CartesiaTTSOptions,
   CommandExecutor2 as CommandExecutor,
   ConsoleHostBridge,
+  DEFAULT_CATALOG_BUDGET,
   DEFAULT_DENY,
   DEFAULT_MAX_DEPTH,
   DEFAULT_MUTATING,
@@ -14022,6 +14123,7 @@ export {
   askUserQuestionTool,
   bashTool,
   buildMcpCatalog,
+  ccModeOptions,
   checkpointTool,
   checkpointTools,
   claudeCodeDisallowedTools,
@@ -14054,6 +14156,7 @@ export {
   findGitRoot,
   forComponent,
   forgetFact,
+  formatCatalog,
   formatJobNotice,
   fullAgentOptions,
   getOrCreateWorktree,
@@ -14072,6 +14175,7 @@ export {
   lessonCapture,
   loadAgents,
   loadCommands,
+  loadContextFiles,
   loadInstructions,
   loadMemory,
   loadSkills,
@@ -14107,6 +14211,7 @@ export {
   parseImageRef,
   pickTier,
   planMode,
+  plannerBlocks,
   raceAttempts,
   readTool,
   reasoningToChatFragment,