@zenera/neo 1.1.19 → 1.1.20

package/dist/inspect/client.js

@@ -134,6 +134,42 @@ function textBlock(title, body, tag) {
   return s;
 }
 
+// A prompt is assembled from tagged sections — <house_rules src="...">, <role>,
+// <skills> — and unhighlighted they read as one wall of text, so the reader
+// cannot see which file put which paragraph in front of the model. A section
+// delimiter always stands alone on its line, which is what keeps prose and
+// placeholders (/memory/<id>.<ext>) from lighting up as structure.
+const TAG_LINE_RE = /^(\\s*)(<\\/?[A-Za-z][A-Za-z0-9._:-]*(?:\\s[^<>]*)?\\/?>)(\\s*)$/;
+
+/** A <pre> with every section delimiter lifted out as its own span. */
+function taggedPre(text) {
+  const s = String(text);
+  const pre = el('pre', 'text');
+  if (s.indexOf('<') < 0) { pre.textContent = s; return pre; }
+  const lines = s.split('\\n');
+  let buf = '';
+  function flush() {
+    if (buf) { pre.appendChild(document.createTextNode(buf)); buf = ''; }
+  }
+  for (let i = 0; i < lines.length; i++) {
+    const m = TAG_LINE_RE.exec(lines[i]);
+    if (!m) { buf += (i ? '\\n' : '') + lines[i]; continue; }
+    buf += (i ? '\\n' : '') + m[1];
+    flush();
+    pre.appendChild(el('span', m[2].indexOf('</') === 0 ? 'xtag end' : 'xtag', m[2]));
+    buf = m[3];
+  }
+  flush();
+  return pre;
+}
+
+function promptBlock(title, body, tag) {
+  const s = block(title, tag);
+  if (body) s.appendChild(taggedPre(body));
+  else s.appendChild(el('div', 'empty', '(empty)'));
+  return s;
+}
+
 function foldBlock(title, body) {
   const s = block(title);
   const d = document.createElement('details');
@@ -423,12 +459,14 @@ function message(m) {
 
   if (m.role === 'user' && Array.isArray(m.content)) {
     m.content.forEach(function (p) {
-      if (p.type === 'text') { wrap.appendChild(el('pre', 'text', p.text)); return; }
+      if (p.type === 'text') { wrap.appendChild(taggedPre(p.text)); return; }
       const img = imageEl(p, true);
       wrap.appendChild(img || el('pre', 'text', '[' + p.type + '] ' + mediaUrl(p.url)));
     });
   } else if (typeof m.content === 'string' && m.content) {
-    wrap.appendChild(el('pre', 'text', m.role === 'tool' ? pretty(m.content) : m.content));
+    wrap.appendChild(m.role === 'tool'
+      ? el('pre', 'text', pretty(m.content))
+      : taggedPre(m.content));
   } else if (!m.toolCalls) {
     wrap.appendChild(el('div', 'empty', '(no content)'));
   }
@@ -448,7 +486,7 @@ function requestBlocks(raw, into) {
     into.appendChild(textBlock('Request (unparsed)', raw));
     return;
   }
-  if (req.system) into.appendChild(textBlock('System prompt', req.system)).classList.add('sys');
+  if (req.system) into.appendChild(promptBlock('System prompt', req.system)).classList.add('sys');
 
   const conv = block('Messages', (req.messages || []).length + ' messages');
   (req.messages || []).forEach(function (m) { conv.appendChild(message(m)); });
@@ -496,10 +534,10 @@ function detailFor(e) {
 
   switch (n.type) {
     case 'system_prompt':
-      out.appendChild(textBlock('Prompt', blob(n.prompt)));
+      out.appendChild(promptBlock('Prompt', blob(n.prompt)));
       // The editable half: which file to open when the instruction is wrong.
       (n.sources || []).forEach(function (s) {
-        out.appendChild(textBlock(s.path, blob(s.content), 'prompt file'));
+        out.appendChild(promptBlock(s.path, blob(s.content), 'prompt file'));
       });
       break;
 
@@ -516,7 +554,7 @@ function detailFor(e) {
         return s.name + (s.version ? '@' + s.version : '') + '  ' + s.contentHash.slice(0, 12)
           + (s.file ? '  ' + s.file : '');
       }).join('\\n'), n.provider));
-      out.appendChild(textBlock('Injected instructions', blob(n.content)));
+      out.appendChild(promptBlock('Injected instructions', blob(n.content)));
       out.appendChild(textBlock('Tools unlocked', n.toolNames.join('\\n')));
       break;
 

package/dist/inspect/css.d.ts

@@ -1,2 +1,2 @@
-export declare const CSS = "\n:root {\n  --bg: #0f1115; --panel: #161922; --line: #262b36; --fg: #d7dbe3; --dim: #8a92a6;\n  --accent: #6ea8fe; --ok: #4ec9a0; --err: #f0776c; --warn: #e2b341; --mono: ui-monospace, SFMono-Regular, Menlo, monospace;\n}\n* { box-sizing: border-box; }\nbody { margin: 0; background: var(--bg); color: var(--fg);\n  font: 14px/1.5 system-ui, -apple-system, Segoe UI, sans-serif; }\nheader { padding: 12px 16px; border-bottom: 1px solid var(--line); background: var(--panel);\n  display: flex; flex-wrap: wrap; gap: 8px 20px; align-items: baseline; }\nheader h1 { font-size: 15px; margin: 0 12px 0 0; font-weight: 600; }\nheader .kv { color: var(--dim); font-size: 12px; }\nheader .kv b { color: var(--fg); font-weight: 600; }\nmain { display: grid; grid-template-columns: 340px 1fr; height: calc(100vh - 49px); }\naside { border-right: 1px solid var(--line); overflow: auto; background: var(--panel); }\n.pad { padding: 10px; position: sticky; top: 0; background: var(--panel); border-bottom: 1px solid var(--line); }\n#filter { width: 100%; padding: 6px 8px; background: var(--bg); color: var(--fg);\n  border: 1px solid var(--line); border-radius: 6px; }\n#timeline { list-style: none; margin: 0; padding: 4px 0; }\n#timeline li { padding: 6px 10px; border-left: 3px solid transparent; cursor: pointer; }\n#timeline li:hover { background: #1c2130; }\n#timeline li.sel { background: #1f2637; border-left-color: var(--accent); }\n#timeline li.covered { opacity: .45; }\n#timeline .row { display: flex; gap: 6px; align-items: baseline; }\n#timeline .t { color: var(--fg); font: 11px var(--mono); min-width: 38px; text-align: right; }\n#timeline .t.same { color: #3d4453; }\n#timeline .dur { margin-left: auto; color: var(--dim); font: 11px var(--mono); }\n#timeline .idx { color: var(--dim); font: 11px var(--mono); min-width: 22px; }\n#timeline .prev { color: var(--dim); font-size: 11px; white-space: nowrap;\n  overflow: hidden; text-overflow: ellipsis; padding-left: 44px; }\n/* Branch histories are contiguous in this list, so a coloured edge plus a\n   header is enough to stop ten parallel branches reading as one long run. */\n#timeline li.sep { cursor: default; padding: 10px 10px 4px; display: flex; gap: 7px;\n  align-items: center; font-size: 11px; letter-spacing: .06em; text-transform: uppercase;\n  color: var(--dim); border-left-color: transparent; }\n#timeline li.sep:hover { background: none; }\n#timeline li.sep .dot { width: 8px; height: 8px; border-radius: 2px;\n  background: var(--bc, var(--dim)); }\n/* The group header shouts in uppercase; its elapsed time should not. */\n#timeline li.sep .dur { text-transform: none; letter-spacing: 0; }\n/* The branch the join actually waited for. */\n#timeline li.sep.slow { background: #232a38; color: var(--fg); }\n#timeline li.sep.slow .dur { color: var(--fg); }\n#timeline li.branch { padding-left: 20px; border-left-color: var(--bc, var(--line)); }\n#timeline li.branch.sel { border-left-color: var(--bc, var(--accent)); }\n#middle { display: flex; flex-direction: column; overflow: hidden; }\n.tabs { display: flex; gap: 4px; padding: 8px 12px; border-bottom: 1px solid var(--line); }\n.tabs button { background: none; border: 1px solid transparent; color: var(--dim);\n  padding: 4px 12px; border-radius: 6px; cursor: pointer; font-size: 13px; }\n.tabs button.on { color: var(--fg); background: var(--panel); border-color: var(--line); }\n#detail { overflow: auto; padding: 16px; flex: 1; }\n#stats { overflow: auto; padding: 16px; flex: 1; }\ntable.st { width: 100%; border-collapse: collapse; font: 12px var(--mono); }\ntable.st th { text-align: right; color: var(--dim); font-weight: 600; padding: 6px 12px;\n  border-bottom: 1px solid var(--line); white-space: nowrap; }\ntable.st td { text-align: right; padding: 5px 12px; border-bottom: 1px solid #1d2230;\n  white-space: nowrap; }\ntable.st th:first-child, table.st td:first-child { text-align: left; }\ntable.st tbody tr:hover { background: #1c2130; }\ntable.st tbody tr:last-child td { border-bottom: none; }\n/* The total is a different kind of row, not one more of the same: it gets its\n   own band so nobody reads it as another model or another agent. */\ntable.st tfoot td { color: var(--fg); font-weight: 600; background: #191e2a;\n  border-top: 1px solid #2b3346; border-bottom: none; padding: 7px 12px; }\ntable.st tfoot td:first-child { color: var(--dim); text-transform: uppercase;\n  letter-spacing: .07em; font-size: 11px; }\n/* Two panes hold a zoomable diagram (the run graph and the architecture), so\n   everything about one is written for both. */\n.pane { display: flex; flex-direction: column; overflow: hidden; flex: 1; }\n/* An explicit display on the pane would otherwise beat the hidden attribute\n   and both views would show at once. */\n.pane[hidden], #detail[hidden], #stats[hidden] { display: none; }\n.pane svg { max-width: none; display: block; }\n.pane .node { cursor: pointer; }\n/* A node with nothing behind it in this run is not clickable, and says so. */\n.pane .node.idle { cursor: default; }\n.gtools { display: flex; align-items: center; gap: 6px; padding: 6px 10px;\n  border-bottom: 1px solid var(--line); background: var(--panel); }\n.gtools button { background: var(--bg); border: 1px solid var(--line); color: var(--fg);\n  border-radius: 6px; padding: 2px 10px; cursor: pointer; font: 12px var(--mono); }\n.gtools button:hover { border-color: var(--accent); }\n.gtools .hint:first-of-type { margin-left: 8px; }\n.gtools .lvl { margin-left: auto; font-family: var(--mono); }\n.gtools label.check { display: flex; align-items: center; gap: 5px; margin-left: 8px;\n  color: var(--dim); font-size: 12px; cursor: pointer; user-select: none; }\n/* The memory view reads left to right: the graph is the index, the panel is\n   the page. Putting the body under a tab of its own would mean losing the\n   picture every time you asked what a node actually says. */\n#memory .split { display: flex; flex: 1; overflow: hidden; }\n#mdetail { width: 380px; flex: none; padding: 16px; overflow: auto;\n  border-right: none; border-left: 1px solid var(--line); }\n#mdetail .dt { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; margin: 0 0 10px; }\n#mdetail .idrow { display: flex; gap: 8px; align-items: center; margin: 0 0 14px; }\n#mdetail .idrow code { flex: 1; min-width: 0; font: 12px var(--mono); color: var(--fg);\n  background: var(--bg); border: 1px solid var(--line); border-radius: 6px;\n  padding: 4px 8px; word-break: break-all; }\n#mdetail .idrow button { flex: 0 0 auto; background: var(--bg); border: 1px solid var(--line);\n  color: var(--dim); border-radius: 6px; padding: 4px 9px; font: 11px var(--mono);\n  cursor: pointer; }\n#mdetail .idrow button:hover { border-color: var(--accent); color: var(--fg); }\n#mdetail dl.props { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 5px 14px;\n  margin: 0 0 14px; font: 12px var(--mono); }\n#mdetail dl.props dt { color: var(--dim); }\n#mdetail dl.props dd { margin: 0; word-break: break-word; }\n/* A block that shares the panel's own background has no edges to show. */\n#mdetail section.blk { background: var(--bg); }\n#mdetail ul.links { list-style: none; margin: 0; padding: 0; }\n#mdetail ul.links li { display: grid; grid-template-columns: 96px auto minmax(0, 1fr);\n  gap: 8px; align-items: baseline; padding: 6px 12px; }\n#mdetail ul.links li + li { border-top: 1px solid var(--line); }\n#mdetail ul.links .rel { font: 11px var(--mono); color: var(--warn); white-space: nowrap; }\n#mdetail button.link { font: 12px/1.4 system-ui, sans-serif; padding: 0; text-align: left;\n  overflow-wrap: anywhere; }\n#mdetail button.link:hover { text-decoration: underline; }\n#mcount .ok { color: var(--ok); }\n#mcount .bad { color: var(--err); }\n/* The kind palette is the memory page's, so a node reads the same in both. */\n.kind { font-size: 11px; letter-spacing: .04em; text-transform: uppercase;\n  padding: 1px 6px; border-radius: 4px; background: #232a38; color: var(--dim); }\n.kind.task { background: #1e3357; color: #9dc1ff; }\n.kind.plan { background: #3a2450; color: #d1a6ff; }\n.kind.fact { background: #14392c; color: #8ee0c2; }\n.kind.snippet { background: #1e3d33; color: #8ee0c2; }\n.kind.file { background: #40331a; color: #f0dfb4; }\n.kind.operation { background: #3d2a1b; color: #f2d9c2; }\n.kind.preference { background: #3d1f2c; color: #f5b8cd; }\n/* Selection is a class rather than attributes written onto the shapes: the\n   previous pick has to lose its outline without a redraw. White, because the\n   accent already means \"the recall matched this one\". */\n#memory .node.picked rect, #memory .node.picked polygon,\n#memory .node.picked path, #memory .node.picked circle {\n  stroke: var(--fg) !important; stroke-width: 4px !important; }\n/* The canvas is transformed, not scrolled: panning has to work past the edges\n   of the diagram, which overflow:auto would forbid. */\n.viewport { flex: 1; overflow: hidden; position: relative; cursor: grab; touch-action: none;\n  user-select: none; -webkit-user-select: none; }\n.viewport.drag { cursor: grabbing; }\n.canvas { position: absolute; top: 0; left: 0; transform-origin: 0 0; }\n.hint { color: var(--dim); font-size: 12px; }\n.hint.pad { padding: 16px; }\n.type { font-size: 11px; letter-spacing: .04em; text-transform: uppercase;\n  padding: 1px 6px; border-radius: 4px; background: #232a38; color: var(--dim); }\n.type.llm_call { background: #1e3357; color: #9dc1ff; }\n.type.tool_call, .type.tool_result { background: #1e3d33; color: #8ee0c2; }\n.type.compaction { background: #40331a; color: var(--warn); }\n.type.fork, .type.join { background: #3a2450; color: #d1a6ff; }\n.type.final_output { background: #14392c; color: var(--ok); }\n.type.err { background: #4a1f1c; color: var(--err); }\nh2.dt { font-size: 16px; margin: 0 0 4px; display: flex; gap: 10px; align-items: center; }\n.meta { color: var(--dim); font-size: 12px; font-family: var(--mono); margin-bottom: 14px;\n  display: flex; flex-wrap: wrap; gap: 4px 14px; }\nsection.blk { border: 1px solid var(--line); border-radius: 8px; margin-bottom: 12px;\n  background: var(--panel); overflow: hidden; }\nsection.blk > h3 { margin: 0; padding: 7px 12px; font-size: 12px; font-weight: 600;\n  color: var(--dim); border-bottom: 1px solid var(--line); letter-spacing: .03em; }\nsection.blk > h3 .tag { float: right; font-weight: 400; }\nsection.blk.sys { border-left: 3px solid var(--warn); }\n/* An LLM call has three things a reader wants to tell apart at a glance: what\n   went in, what came back, and what it cost. Groups carry the first two. */\n.group { border: 1px solid var(--line); border-radius: 10px; margin-bottom: 14px;\n  background: #12151d; overflow: hidden; }\n.group > .ghdr { display: flex; align-items: center; gap: 10px; padding: 8px 12px;\n  font-size: 11px; font-weight: 700; letter-spacing: .09em; text-transform: uppercase;\n  background: #1b2130; border-bottom: 1px solid var(--line); }\n.group > .ghdr .tag { margin-left: auto; font: 11px var(--mono); font-weight: 400;\n  letter-spacing: 0; text-transform: none; color: var(--dim); }\n.group > .body { padding: 10px; }\n.group > .body > .blk:last-child { margin-bottom: 0; }\n.group.req { border-left: 3px solid var(--accent); }\n.group.req > .ghdr { color: #9dc1ff; }\n.group.res { border-left: 3px solid var(--ok); }\n.group.res > .ghdr { color: #8ee0c2; }\n.stats { display: flex; flex-wrap: wrap; gap: 8px; margin-bottom: 14px; }\n.stat { background: var(--panel); border: 1px solid var(--line); border-radius: 999px;\n  padding: 3px 12px; font: 12px var(--mono); color: var(--dim); }\n.stat b { color: var(--fg); font-weight: 600; }\npre { margin: 0; padding: 10px 12px; font: 12px/1.55 var(--mono); white-space: pre-wrap;\n  word-break: break-word; overflow-wrap: anywhere; }\npre.text { white-space: pre-wrap; }\nimg.media { display: block; max-width: 100%; max-height: 420px; margin: 10px 12px;\n  border: 1px solid var(--line); border-radius: 6px; background: #0d1017; }\nimg.media.thumb { max-height: 88px; margin: 8px 12px; cursor: zoom-in; }\n.msg { border-top: 1px solid var(--line); border-left: 3px solid transparent; }\n.msg:first-of-type { border-top: none; }\n.msg > .role { padding: 5px 12px; font-size: 11px; text-transform: uppercase;\n  letter-spacing: .05em; color: var(--dim); background: #1b202c;\n  display: flex; justify-content: space-between; }\n.msg.user > .role { color: #9dc1ff; }\n.msg.user { border-left-color: #35507f; }\n.msg.assistant > .role { color: #c3a6ff; }\n.msg.assistant { border-left-color: #5a4380; }\n.msg.tool > .role { color: #8ee0c2; }\n.msg.tool { border-left-color: #2f6b58; }\n.msg.system > .role { color: var(--warn); }\n.msg.system { border-left-color: #7a6535; }\n.msg.err > .role { color: var(--err); }\n.msg.err { border-left-color: #8a3a33; }\n.call { border-top: 1px dashed var(--line); }\n.call .name { padding: 5px 12px; font: 12px var(--mono); color: #8ee0c2; }\ndetails > summary { cursor: pointer; padding: 6px 12px; color: var(--dim); font-size: 12px; }\n.badge { font: 11px var(--mono); color: var(--dim); }\n.badge.ok { color: var(--ok); } .badge.bad { color: var(--err); }\n.empty { padding: 10px 12px; color: var(--dim); font-size: 12px; font-style: italic; }\nbutton.link { background: none; border: none; color: var(--accent); cursor: pointer;\n  font: 12px var(--mono); padding: 0 6px 0 0; }\n";
+export declare const CSS = "\n:root {\n  --bg: #0f1115; --panel: #161922; --line: #262b36; --fg: #d7dbe3; --dim: #8a92a6;\n  --accent: #6ea8fe; --ok: #4ec9a0; --err: #f0776c; --warn: #e2b341; --mono: ui-monospace, SFMono-Regular, Menlo, monospace;\n}\n* { box-sizing: border-box; }\nbody { margin: 0; background: var(--bg); color: var(--fg);\n  font: 14px/1.5 system-ui, -apple-system, Segoe UI, sans-serif; }\nheader { padding: 12px 16px; border-bottom: 1px solid var(--line); background: var(--panel);\n  display: flex; flex-wrap: wrap; gap: 8px 20px; align-items: baseline; }\nheader h1 { font-size: 15px; margin: 0 12px 0 0; font-weight: 600; }\nheader .kv { color: var(--dim); font-size: 12px; }\nheader .kv b { color: var(--fg); font-weight: 600; }\nmain { display: grid; grid-template-columns: 340px 1fr; height: calc(100vh - 49px); }\naside { border-right: 1px solid var(--line); overflow: auto; background: var(--panel); }\n.pad { padding: 10px; position: sticky; top: 0; background: var(--panel); border-bottom: 1px solid var(--line); }\n#filter { width: 100%; padding: 6px 8px; background: var(--bg); color: var(--fg);\n  border: 1px solid var(--line); border-radius: 6px; }\n#timeline { list-style: none; margin: 0; padding: 4px 0; }\n#timeline li { padding: 6px 10px; border-left: 3px solid transparent; cursor: pointer; }\n#timeline li:hover { background: #1c2130; }\n#timeline li.sel { background: #1f2637; border-left-color: var(--accent); }\n#timeline li.covered { opacity: .45; }\n#timeline .row { display: flex; gap: 6px; align-items: baseline; }\n#timeline .t { color: var(--fg); font: 11px var(--mono); min-width: 38px; text-align: right; }\n#timeline .t.same { color: #3d4453; }\n#timeline .dur { margin-left: auto; color: var(--dim); font: 11px var(--mono); }\n#timeline .idx { color: var(--dim); font: 11px var(--mono); min-width: 22px; }\n#timeline .prev { color: var(--dim); font-size: 11px; white-space: nowrap;\n  overflow: hidden; text-overflow: ellipsis; padding-left: 44px; }\n/* Branch histories are contiguous in this list, so a coloured edge plus a\n   header is enough to stop ten parallel branches reading as one long run. */\n#timeline li.sep { cursor: default; padding: 10px 10px 4px; display: flex; gap: 7px;\n  align-items: center; font-size: 11px; letter-spacing: .06em; text-transform: uppercase;\n  color: var(--dim); border-left-color: transparent; }\n#timeline li.sep:hover { background: none; }\n#timeline li.sep .dot { width: 8px; height: 8px; border-radius: 2px;\n  background: var(--bc, var(--dim)); }\n/* The group header shouts in uppercase; its elapsed time should not. */\n#timeline li.sep .dur { text-transform: none; letter-spacing: 0; }\n/* The branch the join actually waited for. */\n#timeline li.sep.slow { background: #232a38; color: var(--fg); }\n#timeline li.sep.slow .dur { color: var(--fg); }\n#timeline li.branch { padding-left: 20px; border-left-color: var(--bc, var(--line)); }\n#timeline li.branch.sel { border-left-color: var(--bc, var(--accent)); }\n#middle { display: flex; flex-direction: column; overflow: hidden; }\n.tabs { display: flex; gap: 4px; padding: 8px 12px; border-bottom: 1px solid var(--line); }\n.tabs button { background: none; border: 1px solid transparent; color: var(--dim);\n  padding: 4px 12px; border-radius: 6px; cursor: pointer; font-size: 13px; }\n.tabs button.on { color: var(--fg); background: var(--panel); border-color: var(--line); }\n#detail { overflow: auto; padding: 16px; flex: 1; }\n#stats { overflow: auto; padding: 16px; flex: 1; }\ntable.st { width: 100%; border-collapse: collapse; font: 12px var(--mono); }\ntable.st th { text-align: right; color: var(--dim); font-weight: 600; padding: 6px 12px;\n  border-bottom: 1px solid var(--line); white-space: nowrap; }\ntable.st td { text-align: right; padding: 5px 12px; border-bottom: 1px solid #1d2230;\n  white-space: nowrap; }\ntable.st th:first-child, table.st td:first-child { text-align: left; }\ntable.st tbody tr:hover { background: #1c2130; }\ntable.st tbody tr:last-child td { border-bottom: none; }\n/* The total is a different kind of row, not one more of the same: it gets its\n   own band so nobody reads it as another model or another agent. */\ntable.st tfoot td { color: var(--fg); font-weight: 600; background: #191e2a;\n  border-top: 1px solid #2b3346; border-bottom: none; padding: 7px 12px; }\ntable.st tfoot td:first-child { color: var(--dim); text-transform: uppercase;\n  letter-spacing: .07em; font-size: 11px; }\n/* Two panes hold a zoomable diagram (the run graph and the architecture), so\n   everything about one is written for both. */\n.pane { display: flex; flex-direction: column; overflow: hidden; flex: 1; }\n/* An explicit display on the pane would otherwise beat the hidden attribute\n   and both views would show at once. */\n.pane[hidden], #detail[hidden], #stats[hidden] { display: none; }\n.pane svg { max-width: none; display: block; }\n.pane .node { cursor: pointer; }\n/* A node with nothing behind it in this run is not clickable, and says so. */\n.pane .node.idle { cursor: default; }\n.gtools { display: flex; align-items: center; gap: 6px; padding: 6px 10px;\n  border-bottom: 1px solid var(--line); background: var(--panel); }\n.gtools button { background: var(--bg); border: 1px solid var(--line); color: var(--fg);\n  border-radius: 6px; padding: 2px 10px; cursor: pointer; font: 12px var(--mono); }\n.gtools button:hover { border-color: var(--accent); }\n.gtools .hint:first-of-type { margin-left: 8px; }\n.gtools .lvl { margin-left: auto; font-family: var(--mono); }\n.gtools label.check { display: flex; align-items: center; gap: 5px; margin-left: 8px;\n  color: var(--dim); font-size: 12px; cursor: pointer; user-select: none; }\n/* The memory view reads left to right: the graph is the index, the panel is\n   the page. Putting the body under a tab of its own would mean losing the\n   picture every time you asked what a node actually says. */\n#memory .split { display: flex; flex: 1; overflow: hidden; }\n#mdetail { width: 380px; flex: none; padding: 16px; overflow: auto;\n  border-right: none; border-left: 1px solid var(--line); }\n#mdetail .dt { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; margin: 0 0 10px; }\n#mdetail .idrow { display: flex; gap: 8px; align-items: center; margin: 0 0 14px; }\n#mdetail .idrow code { flex: 1; min-width: 0; font: 12px var(--mono); color: var(--fg);\n  background: var(--bg); border: 1px solid var(--line); border-radius: 6px;\n  padding: 4px 8px; word-break: break-all; }\n#mdetail .idrow button { flex: 0 0 auto; background: var(--bg); border: 1px solid var(--line);\n  color: var(--dim); border-radius: 6px; padding: 4px 9px; font: 11px var(--mono);\n  cursor: pointer; }\n#mdetail .idrow button:hover { border-color: var(--accent); color: var(--fg); }\n#mdetail dl.props { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 5px 14px;\n  margin: 0 0 14px; font: 12px var(--mono); }\n#mdetail dl.props dt { color: var(--dim); }\n#mdetail dl.props dd { margin: 0; word-break: break-word; }\n/* A block that shares the panel's own background has no edges to show. */\n#mdetail section.blk { background: var(--bg); }\n#mdetail ul.links { list-style: none; margin: 0; padding: 0; }\n#mdetail ul.links li { display: grid; grid-template-columns: 96px auto minmax(0, 1fr);\n  gap: 8px; align-items: baseline; padding: 6px 12px; }\n#mdetail ul.links li + li { border-top: 1px solid var(--line); }\n#mdetail ul.links .rel { font: 11px var(--mono); color: var(--warn); white-space: nowrap; }\n#mdetail button.link { font: 12px/1.4 system-ui, sans-serif; padding: 0; text-align: left;\n  overflow-wrap: anywhere; }\n#mdetail button.link:hover { text-decoration: underline; }\n#mcount .ok { color: var(--ok); }\n#mcount .bad { color: var(--err); }\n/* The kind palette is the memory page's, so a node reads the same in both. */\n.kind { font-size: 11px; letter-spacing: .04em; text-transform: uppercase;\n  padding: 1px 6px; border-radius: 4px; background: #232a38; color: var(--dim); }\n.kind.task { background: #1e3357; color: #9dc1ff; }\n.kind.plan { background: #3a2450; color: #d1a6ff; }\n.kind.fact { background: #14392c; color: #8ee0c2; }\n.kind.snippet { background: #1e3d33; color: #8ee0c2; }\n.kind.file { background: #40331a; color: #f0dfb4; }\n.kind.operation { background: #3d2a1b; color: #f2d9c2; }\n.kind.preference { background: #3d1f2c; color: #f5b8cd; }\n/* Selection is a class rather than attributes written onto the shapes: the\n   previous pick has to lose its outline without a redraw. White, because the\n   accent already means \"the recall matched this one\". */\n#memory .node.picked rect, #memory .node.picked polygon,\n#memory .node.picked path, #memory .node.picked circle {\n  stroke: var(--fg) !important; stroke-width: 4px !important; }\n/* The canvas is transformed, not scrolled: panning has to work past the edges\n   of the diagram, which overflow:auto would forbid. */\n.viewport { flex: 1; overflow: hidden; position: relative; cursor: grab; touch-action: none;\n  user-select: none; -webkit-user-select: none; }\n.viewport.drag { cursor: grabbing; }\n.canvas { position: absolute; top: 0; left: 0; transform-origin: 0 0; }\n.hint { color: var(--dim); font-size: 12px; }\n.hint.pad { padding: 16px; }\n.type { font-size: 11px; letter-spacing: .04em; text-transform: uppercase;\n  padding: 1px 6px; border-radius: 4px; background: #232a38; color: var(--dim); }\n.type.llm_call { background: #1e3357; color: #9dc1ff; }\n.type.tool_call, .type.tool_result { background: #1e3d33; color: #8ee0c2; }\n.type.compaction { background: #40331a; color: var(--warn); }\n.type.fork, .type.join { background: #3a2450; color: #d1a6ff; }\n.type.final_output { background: #14392c; color: var(--ok); }\n.type.err { background: #4a1f1c; color: var(--err); }\nh2.dt { font-size: 16px; margin: 0 0 4px; display: flex; gap: 10px; align-items: center; }\n.meta { color: var(--dim); font-size: 12px; font-family: var(--mono); margin-bottom: 14px;\n  display: flex; flex-wrap: wrap; gap: 4px 14px; }\nsection.blk { border: 1px solid var(--line); border-radius: 8px; margin-bottom: 12px;\n  background: var(--panel); overflow: hidden; }\nsection.blk > h3 { margin: 0; padding: 7px 12px; font-size: 12px; font-weight: 600;\n  color: var(--dim); border-bottom: 1px solid var(--line); letter-spacing: .03em; }\nsection.blk > h3 .tag { float: right; font-weight: 400; }\nsection.blk.sys { border-left: 3px solid var(--warn); }\n/* An LLM call has three things a reader wants to tell apart at a glance: what\n   went in, what came back, and what it cost. Groups carry the first two. */\n.group { border: 1px solid var(--line); border-radius: 10px; margin-bottom: 14px;\n  background: #12151d; overflow: hidden; }\n.group > .ghdr { display: flex; align-items: center; gap: 10px; padding: 8px 12px;\n  font-size: 11px; font-weight: 700; letter-spacing: .09em; text-transform: uppercase;\n  background: #1b2130; border-bottom: 1px solid var(--line); }\n.group > .ghdr .tag { margin-left: auto; font: 11px var(--mono); font-weight: 400;\n  letter-spacing: 0; text-transform: none; color: var(--dim); }\n.group > .body { padding: 10px; }\n.group > .body > .blk:last-child { margin-bottom: 0; }\n.group.req { border-left: 3px solid var(--accent); }\n.group.req > .ghdr { color: #9dc1ff; }\n.group.res { border-left: 3px solid var(--ok); }\n.group.res > .ghdr { color: #8ee0c2; }\n.stats { display: flex; flex-wrap: wrap; gap: 8px; margin-bottom: 14px; }\n.stat { background: var(--panel); border: 1px solid var(--line); border-radius: 999px;\n  padding: 3px 12px; font: 12px var(--mono); color: var(--dim); }\n.stat b { color: var(--fg); font-weight: 600; }\npre { margin: 0; padding: 10px 12px; font: 12px/1.55 var(--mono); white-space: pre-wrap;\n  word-break: break-word; overflow-wrap: anywhere; }\npre.text { white-space: pre-wrap; }\n/* Section tags inside a prompt (<house_rules src=\"...\">, <role>, ...): the only\n   structure a composed prompt has, and invisible without this. */\npre .xtag { color: #ffb0cd; background: #2d1b27; border: 1px solid #4e2c40;\n  border-radius: 4px; padding: 0 4px; font-weight: 600; }\npre .xtag.end { color: #a07f92; background: #201a1e; border-color: #3b2b35;\n  font-weight: 400; }\nimg.media { display: block; max-width: 100%; max-height: 420px; margin: 10px 12px;\n  border: 1px solid var(--line); border-radius: 6px; background: #0d1017; }\nimg.media.thumb { max-height: 88px; margin: 8px 12px; cursor: zoom-in; }\n.msg { border-top: 1px solid var(--line); border-left: 3px solid transparent; }\n.msg:first-of-type { border-top: none; }\n.msg > .role { padding: 5px 12px; font-size: 11px; text-transform: uppercase;\n  letter-spacing: .05em; color: var(--dim); background: #1b202c;\n  display: flex; justify-content: space-between; }\n.msg.user > .role { color: #9dc1ff; }\n.msg.user { border-left-color: #35507f; }\n.msg.assistant > .role { color: #c3a6ff; }\n.msg.assistant { border-left-color: #5a4380; }\n.msg.tool > .role { color: #8ee0c2; }\n.msg.tool { border-left-color: #2f6b58; }\n.msg.system > .role { color: var(--warn); }\n.msg.system { border-left-color: #7a6535; }\n.msg.err > .role { color: var(--err); }\n.msg.err { border-left-color: #8a3a33; }\n.call { border-top: 1px dashed var(--line); }\n.call .name { padding: 5px 12px; font: 12px var(--mono); color: #8ee0c2; }\ndetails > summary { cursor: pointer; padding: 6px 12px; color: var(--dim); font-size: 12px; }\n.badge { font: 11px var(--mono); color: var(--dim); }\n.badge.ok { color: var(--ok); } .badge.bad { color: var(--err); }\n.empty { padding: 10px 12px; color: var(--dim); font-size: 12px; font-style: italic; }\nbutton.link { background: none; border: none; color: var(--accent); cursor: pointer;\n  font: 12px var(--mono); padding: 0 6px 0 0; }\n";
 //# sourceMappingURL=css.d.ts.map

package/dist/inspect/css.js

@@ -183,6 +183,12 @@ section.blk.sys { border-left: 3px solid var(--warn); }
 pre { margin: 0; padding: 10px 12px; font: 12px/1.55 var(--mono); white-space: pre-wrap;
   word-break: break-word; overflow-wrap: anywhere; }
 pre.text { white-space: pre-wrap; }
+/* Section tags inside a prompt (<house_rules src="...">, <role>, ...): the only
+   structure a composed prompt has, and invisible without this. */
+pre .xtag { color: #ffb0cd; background: #2d1b27; border: 1px solid #4e2c40;
+  border-radius: 4px; padding: 0 4px; font-weight: 600; }
+pre .xtag.end { color: #a07f92; background: #201a1e; border-color: #3b2b35;
+  font-weight: 400; }
 img.media { display: block; max-width: 100%; max-height: 420px; margin: 10px 12px;
   border: 1px solid var(--line); border-radius: 6px; background: #0d1017; }
 img.media.thumb { max-height: 88px; margin: 8px 12px; cursor: zoom-in; }

package/dist/kernel.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
 import { Agent, AgentRegistry, handoffTarget, handoffTool } from "./agent.js";
-import { FORK_DESCRIPTION, forkInstructions, forkParameters } from "./fork.js";
+import { FORK_DESCRIPTION, forkParameters } from "./fork.js";
 import { systemClock } from "./ids.js";
-import { memoryInstructions, renderPreferences } from "./memory/instructions.js";
+import { renderPreferences } from "./memory/render.js";
 import { memoryTools } from "./memory/tools.js";
 import { hash } from "./payload.js";
 import { composePrompt } from "./prompt.js";
@@ -194,7 +194,13 @@ function forkAgents(state, reg) {
     const known = allowed.filter((n) => reg.find(n));
     return known.length ? known : [state.agentName];
 }
-/** One condition for the tool and for the prompt block that explains it. */
+/**
+ * The tool is withdrawn at the depth cap, so a branch cannot spawn branches
+ * forever. `agents/fork-instructions.md` is gated on the same two conditions,
+ * from the other side: `requires: [fork]` for the binding, and a `when` on the
+ * depth, because a rule about a tool the model does not have is a rule it can
+ * only be confused by.
+ */
 function canFork(agent, state) {
     return Boolean(agent.fork) && state.spec.forkDepth < state.spec.maxForkDepth;
 }
@@ -251,12 +257,17 @@ function toSchema(t) {
     return { name: t.name, description: t.description, parameters: t.parameters };
 }
 /**
- * Prompt text the runtime owns rather than the author: how to use memory, the
- * user's standing preferences, the skill index and the `final_output`
- * instruction. Most used to be appended inside `buildRequest`, which meant part
- * of the system prompt existed in no node and showed up in no audit. Composed
- * in now, always last, so the volatile tail never invalidates the cacheable
- * prefix.
+ * Prompt text the runtime owns rather than the author: the user's standing
+ * preferences, the skill index and the `final_output` instruction. Most used to
+ * be appended inside `buildRequest`, which meant part of the system prompt
+ * existed in no node and showed up in no audit. Composed in now, always last,
+ * so the volatile tail never invalidates the cacheable prefix.
+ *
+ * How to *use* memory is not here: it is the project's own house rules, in
+ * `agents/memory-instructions.md`, so that one document is the only place it is
+ * written. An agent with memory tools and no such file gets the tool schemas
+ * and nothing else - `zen check` warns about it, the runtime does not invent a
+ * replacement. Forking is the same, in `agents/fork-instructions.md`.
  */
 async function derivedPrompt(agent, state, env) {
     const out = [];
@@ -266,7 +277,6 @@ async function derivedPrompt(agent, state, env) {
         // because preferences change at most once in a run and
         // `applySystemPrompt` is keyed on the rendered bytes, so a commit
         // re-renders the prefix once rather than every turn.
-        out.push(memoryInstructions(memory));
         out.push(renderPreferences(env.services.memory.preferences(memory.sees)));
     }
     if (agent.skills?.discovery === 'index') {
@@ -284,9 +294,6 @@ async function derivedPrompt(agent, state, env) {
             out.push(rendered);
         }
     }
-    if (canFork(agent, state)) {
-        out.push(forkInstructions());
-    }
     if (state.spec.outputSchema) {
         out.push(FINAL_OUTPUT_INSTRUCTIONS);
     }

package/dist/memory/render.d.ts

@@ -1,5 +1,6 @@
-import { type Recollection } from './types.ts';
+import { type MemoryNode, type Recollection } from './types.ts';
 export declare const RECOLLECTION_TAG = "memory-recollection";
+export declare const PREFERENCES_TAG = "memory-preferences";
 export interface RenderOptions {
     /** wrap in the <memory-recollection> element; off for CLI output */
     tagged?: boolean;
@@ -7,4 +8,5 @@ export interface RenderOptions {
     now?: number;
 }
 export declare function renderRecollection(rec: Recollection, opts?: RenderOptions): string;
+export declare function renderPreferences(nodes: readonly MemoryNode[]): string;
 //# sourceMappingURL=render.d.ts.map

package/dist/memory/render.js

@@ -22,10 +22,17 @@ import { SPINE_RELATIONS, } from "./types.js";
 //
 // No SUPERSEDES arrow can appear on the ordinary path: recall drops the node
 // one points at, so the edge loses an endpoint before it reaches here. It shows
-// up only under `stale`, which is the audit view, and `memory/instructions.ts`
-// therefore does not teach the model to look for one.
+// up only under `stale`, which is the audit view, and the house rules in
+// `agents/memory-instructions.md` therefore do not teach the model to look for
+// one.
+//
+// The preferences block is here too. It is the other thing the runtime renders
+// out of the graph for a model to read, and it exists for the one reason a
+// static document cannot cover it: each line carries a live id, without which a
+// preference can be read but not superseded.
 // ---------------------------------------------------------------------------
 export const RECOLLECTION_TAG = 'memory-recollection';
+export const PREFERENCES_TAG = 'memory-preferences';
 /** Enough to judge relevance; the model calls `memory_load` for the rest. */
 const TEXT_CLIP = 160;
 /** Two columns per level of nesting, so the tree is the indentation. */
@@ -225,4 +232,22 @@ function used(node, now) {
     const ago = days <= 0 ? 'today' : days === 1 ? 'yesterday' : `${days}d ago`;
     return `used ${node.useCount}\u00d7, ${ago}`;
 }
+export function renderPreferences(nodes) {
+    if (!nodes.length) {
+        return '';
+    }
+    const lines = nodes.map((n) => `- ${oneLine(n.text)} [${n.id}]`);
+    return [
+        `<${PREFERENCES_TAG}>`,
+        "Standing instructions from earlier runs. They apply unless this run's",
+        'request contradicts them; to change one, commit the replacement and link',
+        'it to the id here with SUPERSEDES.',
+        ...lines,
+        `</${PREFERENCES_TAG}>`,
+    ].join('\n');
+}
+/** Never clipped: half an instruction is a different instruction. */
+function oneLine(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
 //# sourceMappingURL=render.js.map

package/dist/project/load.js

@@ -2,6 +2,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { basename, join, relative, resolve, sep } from 'node:path';
 import { Agent, AgentRegistry } from "../agent.js";
 import { RunStream } from "../events.js";
+import { frontmatter, toList } from "../frontmatter.js";
 import { MemoryIndex } from "../memory/index.js";
 import { MemoryStore } from "../memory/store.js";
 import { ModelRegistry, } from "../models/factory.js";
@@ -199,6 +200,11 @@ function within(root, path) {
  * nothing to declare. Order is the filename's, which is the only ordering that
  * is the same on every machine and is visible without opening another file.
  *
+ * The exception a document declares for itself: `requires:` in its frontmatter
+ * names capabilities, and the document then reaches only the agents that have
+ * them. That stays a property of the document rather than of `agents.yaml`
+ * because the condition and the prose it guards are the same edit.
+ *
  * All of it is optional: a one-agent project whose whole prompt is its role
  * file should not need a second, empty document.
  */
@@ -206,9 +212,21 @@ function readHouseRules(root) {
     const rules = [];
     const take = (rel) => {
         const path = join(root, rel);
-        if (existsSync(path)) {
-            rules.push(promptFile(path, 'house_rules', rel));
+        if (!existsSync(path)) {
+            return;
         }
+        const { data, body } = frontmatter(readFileSync(path, 'utf8'));
+        const requires = toList(data.requires);
+        for (const cap of requires) {
+            if (!(cap in CAPABILITIES)) {
+                throw new Error(`${rel}: unknown capability "${cap}" in requires: ` +
+                    `(known: ${Object.keys(CAPABILITIES).join(', ')})`);
+            }
+        }
+        // One object per document, shared by every agent it reaches, so the
+        // report says "one document, five prompts" rather than showing five
+        // identical blobs.
+        rules.push({ rel, requires, part: { text: body, path, section: 'house_rules', src: rel } });
     };
     take(HOUSE_RULES);
     for (const name of topics(root)) {
@@ -216,6 +234,46 @@ function readHouseRules(root) {
     }
     return rules;
 }
+/**
+ * What `requires:` may name, and what each one means. A closed vocabulary
+ * rather than an expression language: these are the capabilities the runtime
+ * can turn on and off, so the set of useful conditions is finite and knowable,
+ * and a typo is a load error instead of a rule that silently never fires.
+ *
+ * Every entry reads `agents.yaml` and nothing else. In particular none of them
+ * consults the resolved tool set, which is a function of the *state* — a prompt
+ * that varied with it would move the provider's cache prefix mid-run.
+ *
+ * A capability may also contribute a run-time half, returned as `when`: `fork`
+ * does, because the tool is withdrawn at the depth cap and a rule about a tool
+ * the model does not have is a rule it can only be confused by.
+ */
+const CAPABILITIES = {
+    fork: (spec) => Boolean(spec.fork) && ((_ctx, run) => run.forkDepth < run.maxForkDepth),
+    memory: (spec) => Boolean(spec.memory),
+    'memory-write': (spec) => spec.memory?.access === 'read-write' || spec.memory?.access === 'full',
+    'memory-forget': (spec) => spec.memory?.access === 'full',
+};
+/**
+ * The document as this agent gets it, or `undefined` when its conditions rule
+ * the agent out. Several run-time conditions are met by meeting all of them.
+ */
+function ruleFor(rule, spec) {
+    const gates = [];
+    for (const cap of rule.requires) {
+        const resolved = CAPABILITIES[cap](spec);
+        if (!resolved) {
+            return undefined;
+        }
+        if (typeof resolved === 'function') {
+            gates.push(resolved);
+        }
+    }
+    if (!gates.length) {
+        return rule.part;
+    }
+    return { ...rule.part, when: (ctx, run) => gates.every((g) => g(ctx, run)) };
+}
 /** `agents/<topic>-instructions.md`, sorted. Subdirectories are not searched. */
 function topics(root) {
     const dir = join(root, AGENTS_DIR);
@@ -233,7 +291,13 @@ function topics(root) {
  * can reuse it.
  */
 function instructionsFor(root, spec, houseRules) {
-    const parts = [...houseRules];
+    const parts = [];
+    for (const rule of houseRules) {
+        const part = ruleFor(rule, spec);
+        if (part) {
+            parts.push(part);
+        }
+    }
     const role = spec.system
         ? projectFile(root, spec.system, `agents.${spec.name}.system`)
         : join(root, PROMPTS_DIR, `${spec.name}.md`);

package/dist/prompt.d.ts

@@ -20,6 +20,17 @@ export interface PromptText {
      * different cache prefixes for the same project.
      */
     src?: string;
+    /**
+     * Whether this block belongs in *this* run's prompt at all. False and the
+     * part is skipped entirely — no text, and no entry in `sources`, because a
+     * document the model never read is not a document that fed the prompt.
+     *
+     * It takes the same arguments as the function form of `PromptPart` and for
+     * the same reason: a condition on mutable state would move the cache prefix
+     * mid-run. This is how one shared document can be conditional per agent
+     * while still being read once.
+     */
+    when?: (ctx: unknown, spec: RunSpec) => boolean;
 }
 /**
  * One contributor to a system prompt: literal text, text computed from the run

package/dist/prompt.js

@@ -67,6 +67,9 @@ export async function composePrompt(instructions, ctx, spec, put, derived = [])
             chunks.push(part(ctx, spec));
         }
         else {
+            if (part.when && !part.when(ctx, spec)) {
+                continue;
+            }
             if (part.path && part.text) {
                 sources.push({ path: part.path, content: await put(part.text) });
             }

package/dist/skill-providers/file.d.ts

@@ -1,4 +1,4 @@
-import type { Skill, SkillProvider, SkillSummary } from '../skills.ts';
+import { type Skill, type SkillProvider, type SkillSummary } from '../skills.ts';
 import { type AnyTool } from '../types.ts';
 /**
  * A directory of skills, and the name the *agent* reaches it by — which is not

package/dist/skill-providers/file.js

@@ -1,5 +1,7 @@
 import { readFile, readdir } from 'node:fs/promises';
 import { basename, join, relative, resolve } from 'node:path';
+import { frontmatter, toList } from "../frontmatter.js";
+import { unknownSkill } from "../skills.js";
 import { selectTools } from "../types.js";
 // ---------------------------------------------------------------------------
 // Filesystem-backed skill provider
@@ -69,7 +71,7 @@ export class FileSkillProvider {
     async load(name, version) {
         const entry = (await this.#scan()).get(name);
         if (!entry) {
-            throw new Error(`unknown skill: ${name}`);
+            throw new Error(unknownSkill(name, await this.list()));
         }
         const { version: found } = entry.summary;
         if (version && found && found !== version) {
@@ -163,41 +165,6 @@ async function readOptional(path) {
         throw err;
     }
 }
-/**
- * Deliberately not a YAML parser: `key: value` and flow lists cover what a
- * skill header needs, and a real dependency would buy nothing.
- */
-function frontmatter(raw) {
-    const m = /^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/.exec(raw);
-    if (!m) {
-        return { data: {}, body: raw.trim() };
-    }
-    const data = {};
-    for (const line of m[1].split(/\r?\n/)) {
-        const i = line.indexOf(':');
-        const key = i < 0 ? '' : line.slice(0, i).trim();
-        if (!key || key.startsWith('#')) {
-            continue;
-        }
-        data[key] = unquote(line.slice(i + 1).trim());
-    }
-    return { data, body: raw.slice(m[0].length).trim() };
-}
-function toList(value) {
-    if (!value) {
-        return [];
-    }
-    const inner = value.startsWith('[') && value.endsWith(']') ? value.slice(1, -1) : value;
-    return inner
-        .split(',')
-        .map((v) => unquote(v.trim()))
-        .filter(Boolean);
-}
-function unquote(value) {
-    const quoted = (value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"));
-    return quoted && value.length > 1 ? value.slice(1, -1) : value;
-}
 function firstLine(body) {
     return (body
         .split(/\r?\n/)

package/dist/skill-providers/static.d.ts

@@ -1,4 +1,4 @@
-import type { Skill, SkillProvider, SkillSummary } from '../skills.ts';
+import { type Skill, type SkillProvider, type SkillSummary } from '../skills.ts';
 import type { AnyTool } from '../types.ts';
 /** Skills handed over in code, held in a map. No I/O, no catalog to scan. */
 export declare class StaticSkillProvider implements SkillProvider {

package/dist/skill-providers/static.js

@@ -1,3 +1,4 @@
+import { unknownSkill } from "../skills.js";
 /** Skills handed over in code, held in a map. No I/O, no catalog to scan. */
 export class StaticSkillProvider {
     id;
@@ -33,7 +34,7 @@ export class StaticSkillProvider {
     async load(name, version) {
         const s = this.#skills.get(name);
         if (!s) {
-            throw new Error(`unknown skill: ${name}`);
+            throw new Error(unknownSkill(name, await this.list()));
         }
         if (version && s.version && s.version !== version) {
             throw new Error(`skill ${name} is at ${s.version}, ${version} was requested`);

package/dist/skills.d.ts

@@ -113,4 +113,11 @@ export declare function lockedSkillTools<TCtx>(binding: SkillBinding, provider:
  * are not duplicated in the tool result and can be compacted independently.
  */
 export declare function skillTools<TCtx>(binding: SkillBinding): AnyTool<TCtx>[];
+/**
+ * A model that misses does not usually misspell: it invents a plausible name
+ * out of something it read, so `memory-policy-instructions` is reaching for
+ * `zen-memory`. Shared words therefore rank above edit distance, and the
+ * catalog is listed either way so the retry needs no further guessing.
+ */
+export declare function unknownSkill(name: string, catalog: SkillSummary[]): string;
 //# sourceMappingURL=skills.d.ts.map

package/dist/skills.js

@@ -213,7 +213,12 @@ export function skillTools(binding) {
                     if (summary && !allows(binding, summary)) {
                         throw new Error(`skill "${name}" is not available to this agent`);
                     }
-                    loaded.push(await provider.load(name, summary?.version));
+                    if (!summary) {
+                        // Only over what this agent may see: a suggestion must
+                        // not name a skill the index and `skill_search` hide.
+                        throw new Error(unknownSkill(name, index.filter((s) => allows(binding, s))));
+                    }
+                    loaded.push(await provider.load(name, summary.version));
                 }
                 // Two skills may declare the same tool; it is unlocked once.
                 const unlocked = [
@@ -246,4 +251,64 @@ export function skillTools(binding) {
     }
     return tools;
 }
+// ---------------------------------------------------------------------------
+// Unknown names
+// ---------------------------------------------------------------------------
+const CATALOG_IN_ERROR = 30;
+/**
+ * A model that misses does not usually misspell: it invents a plausible name
+ * out of something it read, so `memory-policy-instructions` is reaching for
+ * `zen-memory`. Shared words therefore rank above edit distance, and the
+ * catalog is listed either way so the retry needs no further guessing.
+ */
+export function unknownSkill(name, catalog) {
+    const names = catalog.map((s) => s.name);
+    const scored = names
+        .map((n) => ({ n, score: closeness(name, n) }))
+        .filter((c) => c.score > 0)
+        .sort((a, b) => b.score - a.score || a.n.localeCompare(b.n));
+    // Only the equal-best ones: a shared `zen-` prefix makes weak matches of
+    // the whole catalog, and three of those are worse than one good guess.
+    const near = scored
+        .filter((c) => c.score === scored[0]?.score)
+        .slice(0, 3)
+        .map((c) => c.n);
+    const list = names.slice(0, CATALOG_IN_ERROR).join(', ') || 'none';
+    const more = names.length > CATALOG_IN_ERROR ? `, … (${names.length} in all)` : '';
+    return (`unknown skill "${name}"` +
+        (near.length ? ` — did you mean ${near.map((n) => `"${n}"`).join(' or ')}?` : '') +
+        ` (the catalog has: ${list}${more})`);
+}
+function closeness(query, candidate) {
+    const q = query.toLowerCase();
+    const c = candidate.toLowerCase();
+    if (c.includes(q) || q.includes(c)) {
+        return 4;
+    }
+    const wanted = new Set(words(q));
+    const shared = words(c).filter((w) => wanted.has(w)).length;
+    if (shared) {
+        return 1 + shared;
+    }
+    return distance(q, c) <= 2 ? 1 : 0;
+}
+function words(s) {
+    return s.split(/[^a-z0-9]+/).filter((w) => w.length > 2);
+}
+/** Levenshtein, one row at a time, giving up as soon as the lengths rule it out. */
+function distance(a, b) {
+    if (Math.abs(a.length - b.length) > 2) {
+        return 3;
+    }
+    let row = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const next = [i];
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            next[j] = Math.min(next[j - 1] + 1, row[j] + 1, row[j - 1] + cost);
+        }
+        row = next;
+    }
+    return row[b.length];
+}
 //# sourceMappingURL=skills.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zenera/neo",
-    "version": "1.1.19",
+    "version": "1.1.20",
     "description": "A multi-agent runtime for Node.js: agents, models, tools, skills, memory and an append-only trajectory.",
     "keywords": [
         "agents",

package/dist/memory/instructions.d.ts

@@ -1,15 +0,0 @@
-import { type MemoryNode, type ResolvedMemoryBinding } from './types.ts';
-export declare const PREFERENCES_TAG = "memory-preferences";
-/**
- * Deliberately not a function of `sees`: those labels come from the run's
- * context, and naming them here would rewrite the prompt whenever the context
- * moved. It also tells an agent the shape of a slice it was not given.
- */
-export declare function memoryInstructions(binding: ResolvedMemoryBinding): string;
-/**
- * The id on each line is what makes a preference revisable rather than merely
- * readable: without it the model can read the instruction but cannot name the
- * thing it would supersede.
- */
-export declare function renderPreferences(nodes: readonly MemoryNode[]): string;
-//# sourceMappingURL=instructions.d.ts.map