@livx.cc/agentx 0.99.122 → 0.99.124

package/dist/cli.js

@@ -121,13 +121,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(statSync3(path).size * 4 / 3);
+    bytes2 = Math.ceil(statSync3(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}`;
 }
@@ -825,6 +825,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",
@@ -850,6 +851,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",
@@ -891,6 +893,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",
@@ -1584,6 +1587,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",
@@ -1635,14 +1639,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]`;
@@ -1661,6 +1665,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",
@@ -1972,8 +1977,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) {
@@ -2568,7 +2573,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) {
@@ -2693,6 +2699,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). */
@@ -2992,6 +3000,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
@@ -3514,69 +3523,39 @@ function normalizeQuestion(input) {
   return { question: q2.question, header: typeof q2.header === "string" ? q2.header : void 0, options, multiSelect: q2.multiSelect === true };
 }
 
-// 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 q2 of queryTokens) if (t.has(q2)) score += idf?.get(q2) ?? 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 q2 = tokenize(query);
-  if (q2.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), q2, 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
@@ -3598,7 +3577,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 };
@@ -3655,9 +3633,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.",
@@ -3685,7 +3666,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);
@@ -3711,9 +3691,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.",
@@ -3738,7 +3720,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 q2 of queryTokens) if (t.has(q2)) score += idf?.get(q2) ?? 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 q2 = tokenize(query);
+  if (q2.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), q2, 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.';
@@ -3773,10 +3821,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
@@ -3967,8 +4023,8 @@ function memorySearchTool(fs, dirs) {
           return `Error: invalid regex: ${e}`;
         }
       } else {
-        const lower = q2.toLowerCase();
-        matcher = (l) => l.toLowerCase().includes(lower);
+        const lower2 = q2.toLowerCase();
+        matcher = (l) => l.toLowerCase().includes(lower2);
       }
       const loaded = [];
       for (const slug2 of slugs) {
@@ -4076,6 +4132,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();
@@ -4618,6 +4693,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;
@@ -4640,7 +4720,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)
   });
@@ -4710,7 +4790,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, main2) {
@@ -4753,6 +4833,13 @@ function meterWorkers(ai, main2) {
     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)$/;
@@ -4953,6 +5040,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
@@ -5080,6 +5169,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. */
@@ -5184,12 +5275,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])];
@@ -5276,7 +5370,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;
@@ -5287,14 +5381,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];
     }
@@ -5304,7 +5403,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];
     }
@@ -5313,7 +5412,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];
     }
@@ -5372,7 +5471,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 = [
@@ -5408,7 +5507,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 : "");
@@ -6232,9 +6331,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;
@@ -7389,8 +7488,8 @@ function isTranscriptComplete(text) {
   const lastWord = words4[words4.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 (words4.length <= 2) return false;
   return true;
 }
@@ -12393,11 +12492,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");
       }
     };
@@ -14986,6 +15085,7 @@ function readJsonFile(path, fallback) {
 }
 
 // cli/core.ts
+init_models();
 init_hostPath();
 init_platform();
 var DEFAULT_TOOLS = ["bash", "Read", "Edit", "Write", "Grep", "Glob", "MultiEdit", "ApplyEdits", "RepoMap", "TodoWrite"];
@@ -15182,6 +15282,14 @@ Reference files in them by their mount path (the left side).`;
       const po = providerOptionsFor(o.model, cwd, o.mcpServers, o.hostMcpServers);
       return po ? { providerOptions: o.lean && isClaudeCode ? { ...po, settingSources: [] } : po } : {};
     })(),
+    // A child on ANOTHER provider (delegate mode's anthropic planner → claude-code/* worker, or back) gets that
+    // runtime's own options (cwd, env, MCP) — the Agent default inherits only same-provider options, so a claude-code
+    // worker under an anthropic planner ran with none. Same provider: the Agent default (parent's, minus its resume).
+    providerOptionsFor: (m) => {
+      const a = agentRef.agent, po = a?.options.providerOptions;
+      if (modelProvider(m) === modelProvider(a?.options.model ?? "")) return po ? { ...po, resume: void 0, onClaudeCodeSession: void 0 } : void 0;
+      return providerOptionsFor(m, cwd, o.mcpServers, o.hostMcpServers);
+    },
     ...(() => {
       const now4 = /* @__PURE__ */ new Date();
       const platformNames = { darwin: "macOS", linux: "Linux", win32: "Windows" };
@@ -19732,7 +19840,7 @@ function makeHost(format = "text", opts) {
           spinner.start();
           return;
         }
-        const clip = (s) => s.length > 200 ? s.slice(0, 200) + "\u2026" : s;
+        const clip2 = (s) => s.length > 200 ? s.slice(0, 200) + "\u2026" : s;
         const terminal = a.status === "completed" || a.status === "error";
         if (!terminal || !a.id || !activitySeen.has(a.id)) {
           if (a.id) activitySeen.add(a.id);
@@ -19751,8 +19859,8 @@ function makeHost(format = "text", opts) {
           }
           const lines = text.split("\n");
           const shown = lines.slice(0, previewLines());
-          err(paint("    \u23BF " + clip(shown[0])) + "\n");
-          for (const ln of shown.slice(1)) err(dim("      " + clip(ln)) + "\n");
+          err(paint("    \u23BF " + clip2(shown[0])) + "\n");
+          for (const ln of shown.slice(1)) err(dim("      " + clip2(ln)) + "\n");
           const more = lines.length - shown.length;
           if (more > 0 || a.truncated?.result) err(dim(`      \u2026 (${more > 0 ? `+${more} more line${more > 1 ? "s" : ""}` : "truncated by backend"}${a.truncated?.result && more > 0 ? ", truncated" : ""} \xB7 ctrl+o expands)
 `));
@@ -19988,7 +20096,7 @@ function formatTranscriptFull(messages, opts) {
   if (!shown.length) return dim("  (empty transcript)\n");
   const results = /* @__PURE__ */ new Map();
   for (const m of shown) if (m.role === "tool" && m.tool_call_id) results.set(m.tool_call_id, m);
-  const clip = (s) => {
+  const clip2 = (s) => {
     const lines = s.split("\n");
     return lines.length > cap ? lines.slice(0, cap).join("\n") + `
 \u2026 (+${lines.length - cap} more lines)` : s;
@@ -20009,7 +20117,7 @@ function formatTranscriptFull(messages, opts) {
         }
         out.push(cyan("  \u2699 ") + tc.function.name + dim(" " + summarizeCall(tc.function.name, args)) + "\n");
         const r = results.get(tc.id);
-        if (r) out.push(dim("    " + clip(contentText(r.content).trimEnd()).replace(/\n/g, "\n    ")) + "\n");
+        if (r) out.push(dim("    " + clip2(contentText(r.content).trimEnd()).replace(/\n/g, "\n    ")) + "\n");
       }
     }
   }