@zenera/neo 1.1.24 → 1.1.26

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; }\n.tagged-pre { margin: 4px 0; }\n.tagged-pre > pre.text { margin: 0; padding: 6px 12px; }\n/* Section tags inside a prompt (<house_rules src=\"...\">, <role>, ...): the only\n   structure a composed prompt has, and invisible without this. */\n.xtag { color: #ffb0cd; background: #2d1b27; border: 1px solid #4e2c40;\n  border-radius: 4px; padding: 1px 5px; font-weight: 600; font: 12px var(--mono); }\n.xtag.end { color: #a07f92; background: #201a1e; border-color: #3b2b35;\n  font-weight: 400; }\ndetails.xtag-section {\n  border: 1px solid var(--line); border-radius: 6px; margin: 6px 12px;\n  background: var(--panel);\n}\ndetails.xtag-section > summary {\n  cursor: pointer; padding: 6px 10px; font: 12px/1.55 var(--mono);\n  color: var(--dim); white-space: nowrap; overflow: hidden;\n  text-overflow: ellipsis; user-select: none;\n}\ndetails.xtag-section > summary:hover { background: rgba(255, 255, 255, 0.03); }\ndetails.xtag-section > summary .preview {\n  color: var(--dim); margin-left: 8px; font-size: 11px;\n}\ndetails.xtag-section[open] > summary {\n  white-space: normal; border-bottom: 1px solid var(--line);\n  background: rgba(0, 0, 0, 0.15);\n}\ndetails.xtag-section[open] > summary .preview { display: none; }\ndetails.xtag-section > pre.xtag-body {\n  margin: 0; padding: 8px 12px 10px; background: #0d1017;\n  border-radius: 0 0 5px 5px; font: 12px/1.55 var(--mono);\n  white-space: pre-wrap; word-break: break-word; overflow-wrap: anywhere;\n}\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; }\npre a.path { color: var(--accent); }\n.tagged-pre { margin: 4px 0; }\n.tagged-pre > pre.text { margin: 0; padding: 6px 12px; }\n/* Section tags inside a prompt (<house_rules src=\"...\">, <role>, ...): the only\n   structure a composed prompt has, and invisible without this. */\n.xtag { color: #ffb0cd; background: #2d1b27; border: 1px solid #4e2c40;\n  border-radius: 4px; padding: 1px 5px; font-weight: 600; font: 12px var(--mono); }\n.xtag.end { color: #a07f92; background: #201a1e; border-color: #3b2b35;\n  font-weight: 400; }\ndetails.xtag-section {\n  border: 1px solid var(--line); border-radius: 6px; margin: 6px 12px;\n  background: var(--panel);\n}\ndetails.xtag-section > summary {\n  cursor: pointer; padding: 6px 10px; font: 12px/1.55 var(--mono);\n  color: var(--dim); white-space: nowrap; overflow: hidden;\n  text-overflow: ellipsis; user-select: none;\n}\ndetails.xtag-section > summary:hover { background: rgba(255, 255, 255, 0.03); }\ndetails.xtag-section > summary .preview {\n  color: var(--dim); margin-left: 8px; font-size: 11px;\n}\ndetails.xtag-section[open] > summary {\n  white-space: normal; border-bottom: 1px solid var(--line);\n  background: rgba(0, 0, 0, 0.15);\n}\ndetails.xtag-section[open] > summary .preview { display: none; }\ndetails.xtag-section > pre.xtag-body {\n  margin: 0; padding: 8px 12px 10px; background: #0d1017;\n  border-radius: 0 0 5px 5px; font: 12px/1.55 var(--mono);\n  white-space: pre-wrap; word-break: break-word; overflow-wrap: anywhere;\n}\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,7 @@ 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; }
+pre a.path { color: var(--accent); }
 .tagged-pre { margin: 4px 0; }
 .tagged-pre > pre.text { margin: 0; padding: 6px 12px; }
 /* Section tags inside a prompt (<house_rules src="...">, <role>, ...): the only

package/dist/inspect/index.d.ts

@@ -1,7 +1,7 @@
 import type { PayloadResolver } from '../payload.ts';
 import type { AgentState } from '../state.ts';
 import { type ReportOptions, type RunReport } from './report.ts';
-export { buildRunReport, MAX_BLOB_BYTES, MAX_MEMORY_FILE_BYTES, MERMAID_URL, type ReportOptions, type RunMemory, type RunReport, } from './report.ts';
+export { buildRunReport, MAX_BLOB_BYTES, MAX_MEMORY_FILE_BYTES, MERMAID_URL, type ReportMount, type ReportOptions, type RunMemory, type RunReport, } from './report.ts';
 /** Report → one standalone HTML document. */
 export declare function renderReportHtml(report: RunReport, opts?: ReportOptions): string;
 /** The usual entry point: state in, HTML out. */

package/dist/inspect/report.d.ts

@@ -36,6 +36,14 @@ export interface ReportOptions {
     memory?: MemoryStore;
     /** ceiling on an inlined remembered file; 0 to inline none */
     maxMemoryFileBytes?: number;
+    /** Trees the run named by a mount, so the page can link those paths to this machine. */
+    mounts?: readonly ReportMount[];
+}
+export interface ReportMount {
+    /** the name the agent used, e.g. `/workspace` */
+    at: string;
+    /** the `file:` url of the directory behind it */
+    href: string;
 }
 /** Everything the page needs, and nothing that needs a store to interpret. */
 export interface RunReport {
@@ -64,6 +72,7 @@ export interface RunReport {
      * can have moved on a revision since, or be gone from the graph entirely.
      */
     memory?: RunMemory;
+    mounts?: ReportMount[];
 }
 export interface RunMemory {
     dir: string;

package/dist/inspect/report.js

@@ -62,6 +62,7 @@ export async function buildRunReport(state, payloads, opts = {}) {
         media,
         architecture: opts.architecture,
         memory: opts.memory ? await remembered(opts.memory, state, media, opts) : undefined,
+        ...(opts.mounts?.length ? { mounts: [...opts.mounts] } : {}),
     };
 }
 /** Every memory node the run touched, branches included. */

package/dist/lock.d.ts

@@ -0,0 +1,27 @@
+export interface Lock {
+    pid: number;
+    host: string;
+    startedAt: string;
+}
+/** A lock body for this process, with whatever else the holder wants to say. */
+export declare function ownLock<T extends object>(extra?: T): Lock & T;
+/**
+ * `kill(pid, 0)` sends no signal and only asks whether the process exists.
+ * EPERM means it exists and belongs to someone else, which still counts.
+ */
+export declare function pidAlive(pid: number): boolean;
+/** The lock file as written, or undefined when absent or unreadable. */
+export declare function readLock<T extends Lock = Lock>(path: string): T | undefined;
+/**
+ * Who holds a lock right now, if anyone. Read-only: it never claims the lock
+ * and never clears a stale one. A lock from another host cannot be verified
+ * here, so it is not reported as held.
+ */
+export declare function liveHolder<T extends Lock = Lock>(path: string): T | undefined;
+/**
+ * Writes `lock` to `path`, or calls `refuse` with the live holder and throws
+ * what it returns. `wx` makes the create and the check one operation, so two
+ * processes racing for the same directory cannot both win.
+ */
+export declare function claimLock<T extends Lock>(path: string, lock: T, refuse: (held: T) => Error, indent?: number): void;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.js

@@ -0,0 +1,66 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { hostname } from 'node:os';
+/** A lock body for this process, with whatever else the holder wants to say. */
+export function ownLock(extra) {
+    return {
+        pid: process.pid,
+        host: hostname(),
+        startedAt: new Date().toISOString(),
+        ...extra,
+    };
+}
+/**
+ * `kill(pid, 0)` sends no signal and only asks whether the process exists.
+ * EPERM means it exists and belongs to someone else, which still counts.
+ */
+export function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+/** The lock file as written, or undefined when absent or unreadable. */
+export function readLock(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Who holds a lock right now, if anyone. Read-only: it never claims the lock
+ * and never clears a stale one. A lock from another host cannot be verified
+ * here, so it is not reported as held.
+ */
+export function liveHolder(path) {
+    const held = readLock(path);
+    return held && held.host === hostname() && pidAlive(held.pid) ? held : undefined;
+}
+/**
+ * Writes `lock` to `path`, or calls `refuse` with the live holder and throws
+ * what it returns. `wx` makes the create and the check one operation, so two
+ * processes racing for the same directory cannot both win.
+ */
+export function claimLock(path, lock, refuse, indent = 4) {
+    const body = `${JSON.stringify(lock, null, indent)}\n`;
+    try {
+        writeFileSync(path, body, { flag: 'wx' });
+        return;
+    }
+    catch (err) {
+        if (err.code !== 'EEXIST') {
+            throw err;
+        }
+    }
+    const held = liveHolder(path);
+    if (held) {
+        throw refuse(held);
+    }
+    // Stale, or from another machine's run that cannot be verified here.
+    writeFileSync(path, body);
+}
+//# sourceMappingURL=lock.js.map

package/dist/match.d.ts

@@ -0,0 +1,44 @@
+/** Long enough for any honest pattern, short enough to bound a bad one. */
+export declare const MAX_PATTERN = 200;
+export declare class PatternError extends Error {
+}
+export interface MatchOptions {
+    /** read the pattern as a regular expression rather than as a literal */
+    regex?: boolean;
+    caseSensitive?: boolean;
+}
+export type Matcher = (text: string) => boolean;
+/** The offset of the first match in `text`, or -1. */
+export type Finder = (text: string) => number;
+/**
+ * Where a pattern first occurs. Literal by default: someone typing `user.id`
+ * means those seven characters, and a dot that quietly matched anything would
+ * be a worse answer than no answer.
+ */
+export declare function finder(pattern: string, options?: MatchOptions): Finder;
+/** Whether a pattern occurs at all, read the same way `finder` reads it. */
+export declare function matcher(pattern: string, options?: MatchOptions): Matcher;
+/**
+ * A glob, matched against the whole string. Globs rather than regexes because
+ * these are for naming things — a path, a schema — and a star is what everyone
+ * reaches for first.
+ */
+export declare function wildcard(pattern: string, options?: {
+    caseSensitive?: boolean;
+}): Matcher;
+/** Whether a pattern is asking to be read as a glob at all. */
+export declare const isGlob: (pattern: string) => boolean;
+/**
+ * What someone means when they type a name into a filter. With a star in it,
+ * a glob; without one, a substring — because `password` typed into `--name` is
+ * a search for the word, and a whole-string match would answer nothing and
+ * look like the field does not exist.
+ *
+ * `regex` settles it outright, and has to: a star is punctuation in both
+ * languages, so `^/(users|teams)/.*` read as a glob would match nothing and
+ * never say why.
+ */
+export declare function loose(pattern: string, options?: MatchOptions): Matcher;
+/** True when any of the patterns matches; no patterns means no opinion. */
+export declare function anyOf(matchers: readonly Matcher[]): Matcher | undefined;
+//# sourceMappingURL=match.d.ts.map

package/dist/match.js

@@ -0,0 +1,100 @@
+// ---------------------------------------------------------------------------
+// Matching, with nothing learned in between
+//
+// Everything here is exact. A glob matches the characters it names and a
+// substring is a substring, which is the whole point of the surfaces built on
+// it: a vector index answers "what is near this", and near is a ranking, so it
+// can only ever return the top of a list. When the question is "does the word
+// `password` appear anywhere at all", a ranking is the wrong instrument and no
+// amount of tuning makes it the right one.
+//
+// Memory grep and @zenera/rag's lookups both stand on this. A `finder` says
+// *where*, for grep, which reports the line; a `matcher` says *whether*.
+//
+// A pattern may arrive from a model, so a regex is a bounded promise: the
+// length is capped here and the scan that uses it keeps a deadline.
+// ---------------------------------------------------------------------------
+/** Long enough for any honest pattern, short enough to bound a bad one. */
+export const MAX_PATTERN = 200;
+export class PatternError extends Error {
+}
+/**
+ * Where a pattern first occurs. Literal by default: someone typing `user.id`
+ * means those seven characters, and a dot that quietly matched anything would
+ * be a worse answer than no answer.
+ */
+export function finder(pattern, options = {}) {
+    guard(pattern);
+    if (!options.regex) {
+        if (options.caseSensitive) {
+            return (text) => text.indexOf(pattern);
+        }
+        const needle = pattern.toLowerCase();
+        return (text) => text.toLowerCase().indexOf(needle);
+    }
+    const expression = compile(pattern, options.caseSensitive ? '' : 'i');
+    // `lastIndex` is not carried between calls: the flags never include `g`.
+    return (text) => text.search(expression);
+}
+/** Whether a pattern occurs at all, read the same way `finder` reads it. */
+export function matcher(pattern, options = {}) {
+    const find = finder(pattern, options);
+    return (text) => find(text) >= 0;
+}
+/**
+ * A glob, matched against the whole string. Globs rather than regexes because
+ * these are for naming things — a path, a schema — and a star is what everyone
+ * reaches for first.
+ */
+export function wildcard(pattern, options = {}) {
+    guard(pattern);
+    const source = [...pattern]
+        .map((char) => (char === '*' ? '.*' : char === '?' ? '.' : escape(char)))
+        .join('');
+    const expression = compile(`^${source}$`, options.caseSensitive ? '' : 'i');
+    return (text) => expression.test(text);
+}
+/** Whether a pattern is asking to be read as a glob at all. */
+export const isGlob = (pattern) => /[*?]/.test(pattern);
+/**
+ * What someone means when they type a name into a filter. With a star in it,
+ * a glob; without one, a substring — because `password` typed into `--name` is
+ * a search for the word, and a whole-string match would answer nothing and
+ * look like the field does not exist.
+ *
+ * `regex` settles it outright, and has to: a star is punctuation in both
+ * languages, so `^/(users|teams)/.*` read as a glob would match nothing and
+ * never say why.
+ */
+export function loose(pattern, options = {}) {
+    if (options.regex) {
+        return matcher(pattern, options);
+    }
+    return isGlob(pattern) ? wildcard(pattern, options) : matcher(pattern, options);
+}
+/** True when any of the patterns matches; no patterns means no opinion. */
+export function anyOf(matchers) {
+    if (matchers.length === 0) {
+        return undefined;
+    }
+    return (text) => matchers.some((match) => match(text));
+}
+// ---------------------------------------------------------------------------
+function guard(pattern) {
+    if (pattern.length === 0) {
+        throw new PatternError('the pattern is empty');
+    }
+    if (pattern.length > MAX_PATTERN) {
+        throw new PatternError(`the pattern is longer than ${MAX_PATTERN} characters`);
+    }
+}
+function compile(source, flags) {
+    try {
+        return new RegExp(source, flags);
+    }
+    catch (err) {
+        throw new PatternError(`invalid pattern: ${err.message}`);
+    }
+}
+const escape = (char) => char.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+//# sourceMappingURL=match.js.map

package/dist/memory/diff.d.ts

@@ -0,0 +1,39 @@
+import type { MemoryStore } from './store.ts';
+import type { MemoryNode } from './types.ts';
+export interface MemoryNearest {
+    id: string;
+    score: number;
+    text: string;
+}
+export interface MemoryDiffAdded {
+    node: MemoryNode;
+    /** the closest comparable node the base held, if any */
+    nearest?: MemoryNearest;
+    /** `merge` would fold it onto `nearest`: the base already said this */
+    twin: boolean;
+}
+export interface MemoryDiff {
+    base: string;
+    other: string;
+    /** how `nearest` was scored: cosine when both sides hold vectors, else term overlap */
+    by: 'vector' | 'text';
+    added: MemoryDiffAdded[];
+    revised: {
+        before: MemoryNode;
+        after: MemoryNode;
+    }[];
+    /** base nodes `memory_load` returned since — what the run actually read */
+    used: {
+        node: MemoryNode;
+        loads: number;
+    }[];
+    removed: MemoryNode[];
+    /** edges `other` has that `base` did not */
+    edges: number;
+    supersedes: {
+        source: string;
+        target: string;
+    }[];
+}
+export declare function diffMemories(base: MemoryStore, other: MemoryStore): MemoryDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/memory/diff.js

@@ -0,0 +1,95 @@
+import { DUPLICATE_SCORE } from "./index.js";
+import { comparable, sameContent, twinKey } from "./twin.js";
+import { overlap, tokenize } from "./vectors.js";
+export function diffMemories(base, other) {
+    const stale = base.graph.superseded();
+    const block = base.vectors;
+    const theirs = other.vectors;
+    const byVector = !!block?.rows && !!theirs && theirs.dims === block.dims;
+    const held = base.graph.nodes();
+    const lexical = new Map(held.filter((n) => !stale.has(n.id)).map((n) => [twinKey(n), n.id]));
+    const nearestOf = (node) => {
+        if (node.file) {
+            return { twin: false };
+        }
+        const allow = (id) => {
+            const n = base.graph.get(id);
+            return !stale.has(id) && !!n && comparable(n, node);
+        };
+        const exact = lexical.get(twinKey(node));
+        const vector = byVector ? theirs.get(node.id) : undefined;
+        if (vector) {
+            const hit = block.topK(vector, 1, allow)[0];
+            if (hit) {
+                const text = base.graph.get(hit.id).text;
+                return {
+                    nearest: { id: hit.id, score: hit.score, text },
+                    twin: hit.score >= DUPLICATE_SCORE,
+                };
+            }
+        }
+        if (exact) {
+            return {
+                nearest: { id: exact, score: 1, text: base.graph.get(exact).text },
+                twin: true,
+            };
+        }
+        const words = tokenize(node.text);
+        let best;
+        for (const n of held) {
+            if (!allow(n.id)) {
+                continue;
+            }
+            const score = overlap(words, tokenize(n.text));
+            if (score > 0 && (!best || score > best.score)) {
+                best = { id: n.id, score, text: n.text };
+            }
+        }
+        return { nearest: best, twin: false };
+    };
+    const diff = {
+        base: base.dir,
+        other: other.dir,
+        by: byVector ? 'vector' : 'text',
+        added: [],
+        revised: [],
+        used: [],
+        removed: [],
+        edges: 0,
+        supersedes: [],
+    };
+    for (const after of other.graph.nodes()) {
+        const before = base.graph.get(after.id);
+        if (!before) {
+            diff.added.push({ node: after, ...nearestOf(after) });
+            continue;
+        }
+        if (before.revision !== after.revision || !sameContent(before, after)) {
+            diff.revised.push({ before, after });
+        }
+        if (after.useCount > before.useCount) {
+            diff.used.push({ node: after, loads: after.useCount - before.useCount });
+        }
+    }
+    for (const node of held) {
+        if (!other.graph.has(node.id)) {
+            diff.removed.push(node);
+        }
+    }
+    const key = (source, target, relation) => `${source}\u0000${target}\u0000${relation}`;
+    const had = new Set(base.graph.links().map((l) => key(l.source, l.target, l.attrs.relation)));
+    for (const link of other.graph.links()) {
+        if (had.has(key(link.source, link.target, link.attrs.relation))) {
+            continue;
+        }
+        diff.edges++;
+        if (link.attrs.relation === 'SUPERSEDES') {
+            diff.supersedes.push({ source: link.source, target: link.target });
+        }
+    }
+    const newest = (a, b) => b.node.createdAt.localeCompare(a.node.createdAt);
+    diff.added.sort(newest);
+    diff.used.sort((a, b) => b.loads - a.loads);
+    return diff;
+}
+//# sourceMappingURL=diff.js.map

package/dist/memory/files.d.ts

@@ -20,7 +20,7 @@ export interface RememberOptions {
  */
 export declare function rememberFile(dir: string, source: string, id: string, opts?: RememberOptions): Promise<MemoryFile>;
 /** The host path of a remembered file, for reading it back or deleting it. */
-export declare function hostPath(dir: string, file: MemoryFile): string;
+export declare function hostPath(dir: string, file: Pick<MemoryFile, 'path'>): string;
 /** Drop the bytes of a forgotten node. Missing is success — the goal is absence. */
 export declare function forgetFile(dir: string, file: MemoryFile): Promise<void>;
 //# sourceMappingURL=files.d.ts.map

package/dist/memory/grep.d.ts

@@ -1,4 +1,4 @@
-import { type MatchOptions } from './match.ts';
+import { type MatchOptions } from '../match.ts';
 import type { Omitted } from './report.ts';
 import type { MemoryStore } from './store.ts';
 import { type MemoryNode } from './types.ts';

package/dist/memory/grep.js

@@ -1,6 +1,6 @@
 import { readFile, stat } from 'node:fs/promises';
+import { PatternError, finder } from "../match.js";
 import { hostPath } from "./files.js";
-import { PatternError, matcher } from "./match.js";
 import { MemoryError } from "./types.js";
 // ---------------------------------------------------------------------------
 // The memory, read exhaustively
@@ -106,7 +106,7 @@ export async function grepMemory(store, pattern, filter = {}) {
  */
 function compile(pattern, options) {
     try {
-        return matcher(pattern, options);
+        return finder(pattern, options);
     }
     catch (err) {
         if (err instanceof PatternError) {

package/dist/memory/instructions.d.ts

@@ -0,0 +1,15 @@
+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

package/dist/memory/instructions.js

@@ -0,0 +1,103 @@
+import { MEMORY_COMMIT_TOOL, MEMORY_FORGET_TOOL, MEMORY_LOAD_TOOL, MEMORY_SEARCH_TOOL, } from "../types.js";
+import { RECOLLECTION_TAG } from "./render.js";
+import { canForget, canWrite } from "./types.js";
+// ---------------------------------------------------------------------------
+// Teaching the model to read and write memory
+//
+// The tool schemas say what the arguments are; none of them says when a thing
+// is worth remembering, or that a recollection is a subgraph rather than a
+// ranked list. That is policy, it is the same for every agent, and it belongs
+// in the system prompt — which is also the only place it can be stated once
+// per run instead of once per call.
+//
+// Both halves go in through `composePrompt`'s `derived` array, so they sit in
+// the cacheable prefix and are recorded in the `system_prompt` node like every
+// other part of what the model read.
+//
+// The text is gated on the binding, not on the project: an agent that cannot
+// write is never told how to commit. A rule it cannot act on is a rule it can
+// only be confused by, and an unusable tool name in the prompt invites a call
+// that will be refused.
+// ---------------------------------------------------------------------------
+export 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 function memoryInstructions(binding) {
+    const parts = [READING];
+    if (canWrite(binding)) {
+        parts.push(WRITING);
+    }
+    if (canForget(binding)) {
+        parts.push(FORGETTING);
+    }
+    return parts.join('\n\n');
+}
+const READING = `Memory is a graph shared with other agents, and it outlives this run.
+
+A <${RECOLLECTION_TAG}> block is a subgraph, not a ranked list — the links are
+as much of the answer as the nodes. It is an outline, and the indentation is
+the graph. A line at the left margin reads \`score kind id\` and is something
+the search matched. A line indented under it reads \`<arrow>relation kind id\`
+and is a neighbour: \`\u2192produced\` means the line above produced this one,
+\`\u2190informed\` means this one informed the line above. A neighbour the
+search matched in its own right carries a score too, after the arrow. Under
+each header, indented further, is that node's text — and for a \`file\`, the
+path under /memory you can open or run, its size and how often it has been read.
+
+A line beginning \`+\` is a link to an id already shown above, for an edge the
+outline could not nest. Text is clipped: copy an id into \`${MEMORY_LOAD_TOOL}\`
+to read a node whole. \`${MEMORY_SEARCH_TOOL}\` finds ids, it does not return
+contents.
+
+You see part of the graph, not all of it. Finding nothing means nothing you can
+see, not that it never happened.`;
+const WRITING = `Commit when a run produced something a later run would otherwise have to work
+out again: a script that ran, an interface that behaved differently from its
+documentation, a call sequence that turned out to be necessary. Commit it in
+one \`${MEMORY_COMMIT_TOOL}\` call — the artifact and what explains it are one
+memory, and splitting them leaves a later run holding a script with no idea why
+it exists.
+
+Do not commit the request restated, progress notes, anything you have not
+verified, or anything a search already returned. A node that says what one
+already in memory says is folded into it and its existing id comes back under
+your ref, so the links you asked for still land — on the memory that was
+already there.
+
+Never edit a memory to correct it. Add the new one and link it to the old with
+SUPERSEDES; the wrong answer is evidence too, and the link is what hides it
+from later recalls without destroying the history.
+
+Commit a preference only when the user's own words generalise — "always", "from
+now on", "I prefer", "never". A single request being fulfilled is not a
+standing instruction.`;
+const FORGETTING = `Forget only what is wrong and has no successor. A superseded memory is already
+hidden from recall and should stay for the history, so \`${MEMORY_FORGET_TOOL}\`
+is for what should never have been written, not for what has been replaced.`;
+/**
+ * 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 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=instructions.js.map