@zenera/neo 1.1.25 → 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/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

package/dist/memory/match.d.ts

@@ -0,0 +1,18 @@
+/** 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;
+}
+/** The offset of the first match in `text`, or -1. */
+export type Matcher = (text: string) => number;
+/**
+ * A finder over a string. 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 matcher(pattern: string, options?: MatchOptions): Matcher;
+//# sourceMappingURL=match.d.ts.map

package/dist/memory/match.js

@@ -0,0 +1,61 @@
+// ---------------------------------------------------------------------------
+// Matching, with nothing learned in between
+//
+// Everything here is exact. A substring is a substring, which is the whole
+// point of the surface built on it: the 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.
+//
+// This is a copy of `common/match.ts` in @zenera/rag, and has to be: the
+// dependency runs rag → cli → neo, so neo importing rag would close a cycle.
+// Two differences earn their place rather than being drift. A matcher returns
+// the offset it matched at, because grep reports *where*, not merely whether;
+// and there are no globs, because the haystack here is prose and a glob is
+// anchored to the whole string, so `error*` would match a line only when the
+// line began with the word.
+//
+// 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 {
+}
+/**
+ * A finder over a string. 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 matcher(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);
+}
+// ---------------------------------------------------------------------------
+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}`);
+    }
+}
+//# sourceMappingURL=match.js.map

package/dist/memory/store.js

@@ -115,12 +115,13 @@ export class MemoryStore {
         if (this.readOnly) {
             throw new MemoryError('this memory is open read-only', 'nothing this run learns can be kept — point it at a memory of its own');
         }
-        await atomic(join(this.dir, GRAPH_FILE), JSON.stringify(this.graph.export()));
+        // Indented so a committed memory diffs per node rather than as one line.
+        await atomic(join(this.dir, GRAPH_FILE), `${JSON.stringify(this.graph.export(), null, 2)}\n`);
         const vectors = this.#vectors;
         if (vectors) {
             const raw = vectors.bytes();
             await atomic(join(this.dir, VECTORS_FILE), new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength));
-            await atomic(join(this.dir, VECTOR_IDS_FILE), JSON.stringify({ dims: vectors.dims, ids: vectors.ids }));
+            await atomic(join(this.dir, VECTOR_IDS_FILE), `${JSON.stringify({ dims: vectors.dims, ids: vectors.ids }, null, 2)}\n`);
         }
         const manifest = {
             version: MEMORY_VERSION,

package/dist/memory-stores/factory.d.ts

@@ -0,0 +1,15 @@
+import type { MemoryStore } from '../memory.ts';
+import { type FileMemoryStoreOptions } from './file.ts';
+export interface MemoryMemoryStoreSpec {
+    kind: 'memory';
+    id?: string;
+}
+export interface FileMemoryStoreSpec extends FileMemoryStoreOptions {
+    kind: 'file';
+}
+/** Grows a member per backend (`pgvector`, `redis`, …). */
+export type MemoryStoreSpec = MemoryMemoryStoreSpec | FileMemoryStoreSpec;
+/** Shorthand: `mem`, `memory`, `file:./.data/memory`. */
+export type MemoryStoreRef = MemoryStoreSpec | string;
+export declare function createMemoryStore(ref: MemoryStoreRef): MemoryStore;
+//# sourceMappingURL=factory.d.ts.map

package/dist/memory-stores/factory.js

@@ -0,0 +1,29 @@
+import { FileMemoryStore } from "./file.js";
+import { InMemoryMemoryStore } from "./in-memory.js";
+export function createMemoryStore(ref) {
+    const spec = typeof ref === 'string' ? parseRef(ref) : ref;
+    switch (spec.kind) {
+        case 'memory':
+            return new InMemoryMemoryStore(spec.id);
+        case 'file':
+            return new FileMemoryStore(spec);
+        default:
+            throw new TypeError(`unknown memory store kind: ${spec.kind}`);
+    }
+}
+function parseRef(ref) {
+    if (ref === 'mem' || ref === 'memory') {
+        return { kind: 'memory' };
+    }
+    const colon = ref.indexOf(':');
+    const scheme = colon < 0 ? ref : ref.slice(0, colon);
+    const rest = colon < 0 ? '' : ref.slice(colon + 1);
+    if (scheme === 'file') {
+        if (!rest) {
+            throw new TypeError(`missing directory in "${ref}" (expected file:<dir>)`);
+        }
+        return { kind: 'file', dir: rest };
+    }
+    throw new TypeError(`unknown memory store ref: "${ref}"`);
+}
+//# sourceMappingURL=factory.js.map

package/dist/memory-stores/file.d.ts

@@ -0,0 +1,37 @@
+import { type MemoryDraft, type MemoryHit, type MemoryPatch, type MemoryQuery, type MemoryRecord, type MemoryStore } from '../memory.ts';
+export interface FileMemoryStoreOptions {
+    /** root directory; created on demand */
+    dir: string;
+    /** logical store id agents bind to; defaults to `file` */
+    id?: string;
+}
+/**
+ * One JSON file per record, under one directory per scope:
+ *
+ * ```
+ * <dir>/<scope>/scope.json        the unescaped scope name, for humans
+ * <dir>/<scope>/records/<id>.json
+ * <dir>/<scope>/ops/<opId>.json   idempotency ledger
+ * ```
+ *
+ * A file per record (rather than one appended log) keeps writes atomic and
+ * deletes cheap without a compaction step. Search reads the whole scope and
+ * ranks in process, which is exactly the trade this backend makes: no server,
+ * no index, fine up to a few thousand records per scope.
+ *
+ * There is no cross-process lock. Concurrent writers to the *same* record can
+ * lose an update; `expectedRevision` narrows that window, and a deployment
+ * that needs real isolation should use a database-backed store.
+ */
+export declare class FileMemoryStore implements MemoryStore {
+    #private;
+    readonly id: string;
+    constructor(opts: FileMemoryStoreOptions | string);
+    get dir(): string;
+    search(scope: string, q: MemoryQuery): Promise<MemoryHit[]>;
+    get(scope: string, id: string): Promise<MemoryRecord | undefined>;
+    write(scope: string, rec: MemoryDraft, opId: string): Promise<MemoryRecord>;
+    update(scope: string, id: string, patch: MemoryPatch, opId: string): Promise<MemoryRecord>;
+    delete(scope: string, id: string, opId: string): Promise<void>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/memory-stores/file.js

@@ -0,0 +1,174 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { rankMemories, } from "../memory.js";
+// ---------------------------------------------------------------------------
+// Filesystem-backed memory store
+// ---------------------------------------------------------------------------
+/**
+ * Record ids and op ids reach this store from model-authored tool arguments
+ * (`memory_update`, `memory_delete`), so they are validated before becoming
+ * path segments. Dots are excluded outright, which makes `.` and `..`
+ * unrepresentable.
+ */
+const SAFE_ID = /^[A-Za-z0-9_-]+$/;
+/**
+ * One JSON file per record, under one directory per scope:
+ *
+ * ```
+ * <dir>/<scope>/scope.json        the unescaped scope name, for humans
+ * <dir>/<scope>/records/<id>.json
+ * <dir>/<scope>/ops/<opId>.json   idempotency ledger
+ * ```
+ *
+ * A file per record (rather than one appended log) keeps writes atomic and
+ * deletes cheap without a compaction step. Search reads the whole scope and
+ * ranks in process, which is exactly the trade this backend makes: no server,
+ * no index, fine up to a few thousand records per scope.
+ *
+ * There is no cross-process lock. Concurrent writers to the *same* record can
+ * lose an update; `expectedRevision` narrows that window, and a deployment
+ * that needs real isolation should use a database-backed store.
+ */
+export class FileMemoryStore {
+    id;
+    #dir;
+    constructor(opts) {
+        const o = typeof opts === 'string' ? { dir: opts } : opts;
+        this.#dir = resolve(o.dir);
+        this.id = o.id ?? 'file';
+    }
+    get dir() {
+        return this.#dir;
+    }
+    async search(scope, q) {
+        return rankMemories(await this.#all(scope), q);
+    }
+    async get(scope, id) {
+        return this.#readJson(this.#recordPath(scope, id));
+    }
+    async write(scope, rec, opId) {
+        const known = await this.#readOp(scope, opId);
+        if (known) {
+            const existing = await this.get(scope, known);
+            if (existing) {
+                return existing;
+            }
+        }
+        const now = new Date().toISOString();
+        const record = {
+            id: randomUUID(),
+            scope,
+            kind: rec.kind ?? 'fact',
+            text: rec.text,
+            metadata: rec.metadata,
+            createdAt: now,
+            updatedAt: now,
+            revision: 1,
+        };
+        await this.#writeRecord(record);
+        await this.#writeOp(scope, opId, record.id);
+        return record;
+    }
+    async update(scope, id, patch, opId) {
+        const cur = await this.get(scope, id);
+        if (!cur) {
+            throw new Error(`memory record not found: ${scope}/${id}`);
+        }
+        if ((await this.#readOp(scope, opId)) === id) {
+            return cur;
+        }
+        if (patch.expectedRevision !== undefined && patch.expectedRevision !== cur.revision) {
+            throw new Error(`memory conflict on ${scope}/${id}: expected revision ` +
+                `${patch.expectedRevision}, found ${cur.revision}`);
+        }
+        const next = {
+            ...cur,
+            kind: patch.kind ?? cur.kind,
+            text: patch.text ?? cur.text,
+            metadata: patch.metadata ?? cur.metadata,
+            updatedAt: new Date().toISOString(),
+            revision: cur.revision + 1,
+        };
+        await this.#writeRecord(next);
+        await this.#writeOp(scope, opId, id);
+        return next;
+    }
+    async delete(scope, id, opId) {
+        await rm(this.#recordPath(scope, id), { force: true });
+        await this.#writeOp(scope, opId, id);
+    }
+    // --- layout -----------------------------------------------------------
+    /**
+     * Percent-encoding is reversible and, with dots escaped too, cannot
+     * produce a traversal segment out of a scope like `../etc`.
+     */
+    #scopeDir(scope) {
+        return join(this.#dir, encodeURIComponent(scope).replace(/\./g, '%2E'));
+    }
+    #recordPath(scope, id) {
+        return join(this.#scopeDir(scope), 'records', `${safeId(id, 'record id')}.json`);
+    }
+    #opPath(scope, opId) {
+        return join(this.#scopeDir(scope), 'ops', `${safeId(opId, 'op id')}.json`);
+    }
+    // --- io ---------------------------------------------------------------
+    async #all(scope) {
+        const dir = join(this.#scopeDir(scope), 'records');
+        let names;
+        try {
+            names = await readdir(dir);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return [];
+            }
+            throw err;
+        }
+        const records = await Promise.all(names
+            .filter((n) => n.endsWith('.json'))
+            .map((n) => this.#readJson(join(dir, n))));
+        return records.filter((r) => r !== undefined);
+    }
+    async #readOp(scope, opId) {
+        const op = await this.#readJson(this.#opPath(scope, opId));
+        return op?.recordId;
+    }
+    async #writeOp(scope, opId, recordId) {
+        await writeJson(this.#opPath(scope, opId), { recordId });
+    }
+    async #writeRecord(record) {
+        await writeJson(join(this.#scopeDir(record.scope), 'scope.json'), { scope: record.scope });
+        await writeJson(this.#recordPath(record.scope, record.id), record);
+    }
+    async #readJson(path) {
+        try {
+            return JSON.parse(await readFile(path, 'utf8'));
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return undefined;
+            }
+            throw err;
+        }
+    }
+}
+function safeId(value, what) {
+    if (!SAFE_ID.test(value)) {
+        throw new Error(`invalid ${what}: ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+async function writeJson(path, value) {
+    await mkdir(join(path, '..'), { recursive: true });
+    const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(tmp, JSON.stringify(value), 'utf8');
+    try {
+        await rename(tmp, path);
+    }
+    catch (err) {
+        await rm(tmp, { force: true });
+        throw err;
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/memory-stores/in-memory.d.ts

@@ -0,0 +1,17 @@
+import { type MemoryDraft, type MemoryHit, type MemoryPatch, type MemoryQuery, type MemoryRecord, type MemoryStore } from '../memory.ts';
+/**
+ * Reference implementation: scoped maps plus token-overlap scoring. Good enough
+ * for tests and local runs; production deployments swap in a vector store
+ * without touching the kernel.
+ */
+export declare class InMemoryMemoryStore implements MemoryStore {
+    #private;
+    readonly id: string;
+    constructor(id?: string);
+    search(scope: string, q: MemoryQuery): Promise<MemoryHit[]>;
+    get(scope: string, id: string): Promise<MemoryRecord | undefined>;
+    write(scope: string, rec: MemoryDraft, opId: string): Promise<MemoryRecord>;
+    update(scope: string, id: string, patch: MemoryPatch, opId: string): Promise<MemoryRecord>;
+    delete(scope: string, id: string, opId: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory.d.ts.map