renor-engine 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (194) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +75 -0
  3. package/README.md +105 -2
  4. package/dist/.tsbuildinfo +1 -0
  5. package/dist/BUILD.json +6 -0
  6. package/dist/api/apiAuth.js +43 -0
  7. package/dist/api/server.js +174 -0
  8. package/dist/buildIdentity.js +149 -0
  9. package/dist/callPhases.js +82 -0
  10. package/dist/cli-extractors.js +46 -0
  11. package/dist/cli.js +500 -0
  12. package/dist/config.js +65 -0
  13. package/dist/context/composer.js +320 -0
  14. package/dist/context/readHonesty.js +478 -0
  15. package/dist/context/rowStore.js +238 -0
  16. package/dist/conversation/formatter.js +81 -0
  17. package/dist/conversation/parser.js +193 -0
  18. package/dist/conversation/types.js +2 -0
  19. package/dist/conversation/writer.js +42 -0
  20. package/dist/db/client.js +149 -0
  21. package/dist/db/handoffTable.js +31 -0
  22. package/dist/db/indexSalvage.js +101 -0
  23. package/dist/db/migrations.js +670 -0
  24. package/dist/db/readCache.js +109 -0
  25. package/dist/db/schema.js +5 -0
  26. package/dist/db/sqlite.js +396 -0
  27. package/dist/db/statements.js +89 -0
  28. package/dist/digests/digestCache.js +146 -0
  29. package/dist/digests/digests.js +597 -0
  30. package/dist/digests/worker.js +350 -0
  31. package/dist/embeddings/caching.js +337 -0
  32. package/dist/embeddings/coalescing.js +177 -0
  33. package/dist/embeddings/interactive.js +103 -0
  34. package/dist/embeddings/local.js +70 -0
  35. package/dist/embeddings/openai.js +106 -0
  36. package/dist/embeddings/rebuild.js +166 -0
  37. package/dist/embeddings/simdScan.js +260 -0
  38. package/dist/embeddings/space.js +21 -0
  39. package/dist/embeddings/types.js +14 -0
  40. package/dist/embeddings/vectorIndex.js +674 -0
  41. package/dist/embeddings/vertex.js +334 -0
  42. package/dist/eval/artifacts.js +42 -0
  43. package/dist/eval/cacheReport.js +146 -0
  44. package/dist/eval/comparison.js +182 -0
  45. package/dist/eval/context700-candidate.js +145 -0
  46. package/dist/eval/evalCache.js +568 -0
  47. package/dist/eval/hashEmbedding.js +35 -0
  48. package/dist/eval/indexSnapshots.js +548 -0
  49. package/dist/eval/longmemeval.js +56 -0
  50. package/dist/eval/metrics.js +181 -0
  51. package/dist/eval/pageDump.js +67 -0
  52. package/dist/eval/renorbenchBaseline.js +486 -0
  53. package/dist/eval/renorbenchDocuments.js +134 -0
  54. package/dist/eval/renorbenchProduct.js +182 -0
  55. package/dist/eval/runLedger.js +279 -0
  56. package/dist/eval/runManifest.js +485 -0
  57. package/dist/eval/scoring.js +197 -0
  58. package/dist/eval/textTokens.js +17 -0
  59. package/dist/evidence/attach.js +264 -0
  60. package/dist/evidence/background.js +147 -0
  61. package/dist/evidence/evidenceCache.js +182 -0
  62. package/dist/evidence/gate.js +37 -0
  63. package/dist/evidence/keyPool.js +85 -0
  64. package/dist/evidence/ollamaChat.js +84 -0
  65. package/dist/evidence/optin.js +165 -0
  66. package/dist/evidence/options.js +151 -0
  67. package/dist/evidence/secondPass.js +294 -0
  68. package/dist/extraction/classifyCapture.js +34 -0
  69. package/dist/extraction/decision-model.js +174 -0
  70. package/dist/extraction/eventExtractor.js +113 -0
  71. package/dist/extraction/extractionClient.js +122 -0
  72. package/dist/extraction/factExtractor.js +46 -0
  73. package/dist/extraction/factsWritePath.js +179 -0
  74. package/dist/extraction/preferenceExtractor.js +150 -0
  75. package/dist/extraction/secretGuard.js +176 -0
  76. package/dist/extraction/secretScanner.js +665 -0
  77. package/dist/extraction/typedFacts.js +224 -0
  78. package/dist/extraction/writePathAdjudication.js +110 -0
  79. package/dist/importing/apply.js +672 -0
  80. package/dist/importing/bundle-write.js +80 -0
  81. package/dist/importing/cli.js +408 -0
  82. package/dist/importing/existing.js +51 -0
  83. package/dist/importing/facts.js +121 -0
  84. package/dist/importing/forgetImported.js +79 -0
  85. package/dist/importing/hosted.js +467 -0
  86. package/dist/importing/journalLog.js +96 -0
  87. package/dist/importing/markdown.js +98 -0
  88. package/dist/importing/plan.js +201 -0
  89. package/dist/importing/secretScreen.js +113 -0
  90. package/dist/importing/serialize.js +188 -0
  91. package/dist/importing/source.js +463 -0
  92. package/dist/importing/types.js +6 -0
  93. package/dist/indexer/chunker.js +319 -0
  94. package/dist/indexer/dailyEntries.js +63 -0
  95. package/dist/indexer/hasher.js +10 -0
  96. package/dist/indexer/laneRuns.js +48 -0
  97. package/dist/indexer/o200k.js +481 -0
  98. package/dist/indexer/o200k.json +8 -0
  99. package/dist/indexer/outsideRoot.js +77 -0
  100. package/dist/indexer/parser.js +170 -0
  101. package/dist/indexer/pipeline.js +988 -0
  102. package/dist/indexer/staleness.js +201 -0
  103. package/dist/indexer/tokenizer.js +77 -0
  104. package/dist/indexer/walker.js +170 -0
  105. package/dist/mcp/hive.js +88 -0
  106. package/dist/mcp/requestErrors.js +47 -0
  107. package/dist/mcp/server.js +426 -0
  108. package/dist/memory/agentLease.js +43 -0
  109. package/dist/memory/confinedWrite.js +315 -0
  110. package/dist/memory/controls.js +73 -0
  111. package/dist/memory/dailyNote.js +265 -0
  112. package/dist/memory/durableAppend.js +57 -0
  113. package/dist/memory/factConflicts.js +203 -0
  114. package/dist/memory/factTerms.js +321 -0
  115. package/dist/memory/handoff.js +363 -0
  116. package/dist/memory/hiveNameHeader.cjs +10 -0
  117. package/dist/memory/inventory.js +55 -0
  118. package/dist/memory/invisibleText.js +20 -0
  119. package/dist/memory/lifecycle.js +1991 -0
  120. package/dist/memory/limits.js +13 -0
  121. package/dist/memory/requests.js +183 -0
  122. package/dist/memory/sourceName.js +276 -0
  123. package/dist/memory/statusFacts.js +61 -0
  124. package/dist/memory/whatsNew.js +158 -0
  125. package/dist/memory/writer.js +175 -0
  126. package/dist/memory/writerConflicts.js +85 -0
  127. package/dist/memorymap/memoryMap.js +1594 -0
  128. package/dist/memorymap/replacedJournal.js +58 -0
  129. package/dist/memorymap/replacements.js +410 -0
  130. package/dist/mvp/activity.js +86 -0
  131. package/dist/mvp/agentMemory.js +1800 -0
  132. package/dist/mvp/answerCheck.js +211 -0
  133. package/dist/mvp/auth.js +531 -0
  134. package/dist/mvp/cli.js +75 -0
  135. package/dist/mvp/client-store.js +462 -0
  136. package/dist/mvp/compileCache.js +242 -0
  137. package/dist/mvp/compileSeed.js +33 -0
  138. package/dist/mvp/config.js +288 -0
  139. package/dist/mvp/connectionStatus.js +80 -0
  140. package/dist/mvp/contextDistinct.js +53 -0
  141. package/dist/mvp/contextProfile.js +87 -0
  142. package/dist/mvp/contextRelevance.js +413 -0
  143. package/dist/mvp/directorySurface.js +68 -0
  144. package/dist/mvp/engine.js +1078 -0
  145. package/dist/mvp/exportAll.js +374 -0
  146. package/dist/mvp/factLanePack.js +77 -0
  147. package/dist/mvp/factMarkers.js +65 -0
  148. package/dist/mvp/factsLane.js +203 -0
  149. package/dist/mvp/hiddenSpans.js +585 -0
  150. package/dist/mvp/history.js +414 -0
  151. package/dist/mvp/hitDates.js +31 -0
  152. package/dist/mvp/hitFloor.js +36 -0
  153. package/dist/mvp/identity.js +18 -0
  154. package/dist/mvp/idle.js +113 -0
  155. package/dist/mvp/log.js +118 -0
  156. package/dist/mvp/memoryDir.js +98 -0
  157. package/dist/mvp/posthogMcp.js +210 -0
  158. package/dist/mvp/readScope.js +104 -0
  159. package/dist/mvp/readUsefulness.js +222 -0
  160. package/dist/mvp/sanitize.js +48 -0
  161. package/dist/mvp/schemaRejections.js +91 -0
  162. package/dist/mvp/scope.js +127 -0
  163. package/dist/mvp/server.js +2604 -0
  164. package/dist/mvp/serverCard.js +38 -0
  165. package/dist/mvp/storedSize.js +139 -0
  166. package/dist/mvp/telemetry.js +474 -0
  167. package/dist/net/poolFetch.js +174 -0
  168. package/dist/recall/actionRecall.js +282 -0
  169. package/dist/recall/autoRecall.js +447 -0
  170. package/dist/recall/searchRecall.js +189 -0
  171. package/dist/retrieval/adviceLines.js +195 -0
  172. package/dist/retrieval/adviceQuestion.js +44 -0
  173. package/dist/retrieval/conversationShape.js +44 -0
  174. package/dist/retrieval/dailyEntryTime.js +55 -0
  175. package/dist/retrieval/entityLookup.js +162 -0
  176. package/dist/retrieval/factsFirst.js +188 -0
  177. package/dist/retrieval/keyword.js +84 -0
  178. package/dist/retrieval/ledgerEventTime.js +51 -0
  179. package/dist/retrieval/ledgerLiveness.js +83 -0
  180. package/dist/retrieval/ledgerPresentation.js +161 -0
  181. package/dist/retrieval/noteIdentity.js +57 -0
  182. package/dist/retrieval/orchestrator.js +1171 -0
  183. package/dist/retrieval/plainWording.js +236 -0
  184. package/dist/retrieval/queryHelpers.js +142 -0
  185. package/dist/retrieval/questionSpan.js +475 -0
  186. package/dist/retrieval/readerEvents.js +690 -0
  187. package/dist/retrieval/readerLayout.js +422 -0
  188. package/dist/retrieval/relativeTimeHints.js +113 -0
  189. package/dist/retrieval/semantic.js +67 -0
  190. package/dist/router/routerCache.js +106 -0
  191. package/dist/router/sessionRouter.js +726 -0
  192. package/dist/toolRefusal.js +120 -0
  193. package/dist/watcher/watcher.js +77 -0
  194. package/package.json +118 -4
@@ -0,0 +1,181 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.roleOf = roleOf;
4
+ exports.hitMatchesTarget = hitMatchesTarget;
5
+ exports.matchedTargetIndexes = matchedTargetIndexes;
6
+ exports.hitAtK = hitAtK;
7
+ exports.recallAtK = recallAtK;
8
+ exports.recallAllAtK = recallAllAtK;
9
+ exports.forbiddenRetrieved = forbiddenRetrieved;
10
+ exports.reciprocalRank = reciprocalRank;
11
+ exports.ndcgAtK = ndcgAtK;
12
+ exports.contradictionFirst = contradictionFirst;
13
+ /**
14
+ * Role resolution for a gold target.
15
+ *
16
+ * Explicit `role` always wins. Otherwise RenorBench v0 semantics apply:
17
+ * - relevance >= 2 -> positive (creditable for Hit/Recall/MRR and nDCG)
18
+ * - relevance === 1 -> forbidden (superseded/contradictory value that is NOT
19
+ * the answer to the query; never creditable, and surfacing it first is an
20
+ * error tracked by contradictionFirst)
21
+ * - relevance absent -> positive (the target is the only/primary gold)
22
+ *
23
+ * Use explicit `role: 'supporting'` when a low-grade target is genuinely
24
+ * acceptable evidence (nDCG-graded but never counted by binary metrics).
25
+ */
26
+ function roleOf(target) {
27
+ if (target.role)
28
+ return target.role;
29
+ if (target.relevance === undefined)
30
+ return 'positive';
31
+ return target.relevance >= 2 ? 'positive' : 'forbidden';
32
+ }
33
+ function normalized(value) {
34
+ return (value ?? '').trim().toLowerCase();
35
+ }
36
+ /**
37
+ * Matching semantics:
38
+ *
39
+ * - Path-pinned targets (notePath set) require the hit to come from exactly
40
+ * that note, and credit a needle occurring in the hit text or in the pinned
41
+ * path itself (session-id style metadata matching, used by LongMemEval).
42
+ * - Text-scoped targets (no notePath) match against the retrieved text ONLY.
43
+ * A needle appearing merely in a filename never earns textual relevance
44
+ * credit, and unrelated notes can never satisfy the target.
45
+ */
46
+ function hitMatchesTarget(hit, target) {
47
+ const needle = normalized(target.match);
48
+ if (!needle)
49
+ return false;
50
+ if (target.notePath !== undefined) {
51
+ if (normalized(hit.notePath) !== normalized(target.notePath))
52
+ return false;
53
+ return normalized(hit.text).includes(needle) || normalized(target.notePath).includes(needle);
54
+ }
55
+ return normalized(hit.text).includes(needle);
56
+ }
57
+ function creditableTargets(targets) {
58
+ return targets.filter(target => roleOf(target) === 'positive');
59
+ }
60
+ function matchedTargetIndexes(hits, targets, k) {
61
+ const matched = new Set();
62
+ for (const hit of hits.slice(0, k)) {
63
+ targets.forEach((target, index) => {
64
+ if (hitMatchesTarget(hit, target))
65
+ matched.add(index);
66
+ });
67
+ }
68
+ return matched;
69
+ }
70
+ /**
71
+ * Binary Hit@K: credit only positive evidence. Stale/forbidden or merely
72
+ * supporting gold targets can never produce a Hit.
73
+ */
74
+ function hitAtK(hits, targets, k) {
75
+ const positive = creditableTargets(targets);
76
+ if (positive.length === 0)
77
+ return 0;
78
+ return matchedTargetIndexes(hits, positive, k).size > 0 ? 1 : 0;
79
+ }
80
+ /**
81
+ * Recall@K over positive evidence only.
82
+ */
83
+ function recallAtK(hits, targets, k) {
84
+ const positive = creditableTargets(targets);
85
+ if (positive.length === 0)
86
+ return 0;
87
+ return matchedTargetIndexes(hits, positive, k).size / positive.length;
88
+ }
89
+ /**
90
+ * All-required-evidence retrieval (multi-hop): 1 only when every required
91
+ * target is matched within top-K. Single-target lists reduce to Hit@K.
92
+ */
93
+ function recallAllAtK(hits, targets, k) {
94
+ const positive = creditableTargets(targets);
95
+ if (positive.length === 0)
96
+ return 0;
97
+ return matchedTargetIndexes(hits, positive, k).size === positive.length ? 1 : 0;
98
+ }
99
+ /**
100
+ * True when any forbidden-evidence target is retrieved within top-K.
101
+ * Used for deletion/erasure cases: retrieving deleted or must-not-surface
102
+ * content is a violation regardless of ordering.
103
+ */
104
+ function forbiddenRetrieved(hits, targets, k) {
105
+ const forbidden = targets.filter(target => roleOf(target) === 'forbidden');
106
+ if (forbidden.length === 0)
107
+ return false;
108
+ return matchedTargetIndexes(hits, forbidden, k).size > 0;
109
+ }
110
+ /**
111
+ * Reciprocal rank of the first positive-evidence hit.
112
+ */
113
+ function reciprocalRank(hits, targets) {
114
+ const positive = creditableTargets(targets);
115
+ if (positive.length === 0)
116
+ return 0;
117
+ const rank = hits.findIndex(hit => positive.some(target => hitMatchesTarget(hit, target)));
118
+ return rank === -1 ? 0 : 1 / (rank + 1);
119
+ }
120
+ function dcg(relevances) {
121
+ return relevances.reduce((sum, relevance, index) => {
122
+ if (relevance <= 0)
123
+ return sum;
124
+ return sum + (Math.pow(2, relevance) - 1) / Math.log2(index + 2);
125
+ }, 0);
126
+ }
127
+ /**
128
+ * Graded nDCG where each gold target can receive credit at most once.
129
+ * This prevents duplicated retrieval rows from inflating the score.
130
+ * Forbidden targets are excluded entirely; supporting targets keep their grade.
131
+ */
132
+ function ndcgAtK(hits, targets, k) {
133
+ const graded = targets
134
+ .map((target, index) => ({ target, index }))
135
+ .filter(({ target }) => roleOf(target) !== 'forbidden');
136
+ if (graded.length === 0)
137
+ return 0;
138
+ const credited = new Set();
139
+ const observed = [];
140
+ for (const hit of hits.slice(0, k)) {
141
+ let bestIndex = -1;
142
+ let bestRelevance = 0;
143
+ graded.forEach(({ target, index }) => {
144
+ if (credited.has(index) || !hitMatchesTarget(hit, target))
145
+ return;
146
+ const relevance = target.relevance ?? 1;
147
+ if (relevance > bestRelevance) {
148
+ bestRelevance = relevance;
149
+ bestIndex = index;
150
+ }
151
+ });
152
+ if (bestIndex >= 0)
153
+ credited.add(bestIndex);
154
+ observed.push(bestRelevance);
155
+ }
156
+ const ideal = graded
157
+ .map(({ target }) => target.relevance ?? 1)
158
+ .sort((a, b) => b - a)
159
+ .slice(0, k);
160
+ const idealDcg = dcg(ideal);
161
+ return idealDcg === 0 ? 0 : dcg(observed) / idealDcg;
162
+ }
163
+ /**
164
+ * True when the highest-ranked gold-matching hit matches only forbidden
165
+ * targets: an obsolete/contradictory answer was surfaced ahead of the
166
+ * current one. Cases without both positive and forbidden targets never
167
+ * trigger this.
168
+ */
169
+ function contradictionFirst(hits, targets) {
170
+ const hasPositive = targets.some(target => roleOf(target) === 'positive');
171
+ const hasForbidden = targets.some(target => roleOf(target) === 'forbidden');
172
+ if (!hasPositive || !hasForbidden)
173
+ return false;
174
+ for (const hit of hits) {
175
+ const matched = targets.filter(target => hitMatchesTarget(hit, target));
176
+ if (matched.length === 0)
177
+ continue;
178
+ return matched.every(target => roleOf(target) === 'forbidden');
179
+ }
180
+ return false;
181
+ }
@@ -0,0 +1,67 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.jsonl = void 0;
7
+ exports.pagesSha256Of = pagesSha256Of;
8
+ exports.verifyPageDump = verifyPageDump;
9
+ const node_fs_1 = __importDefault(require("node:fs"));
10
+ const node_path_1 = __importDefault(require("node:path"));
11
+ const node_crypto_1 = __importDefault(require("node:crypto"));
12
+ /**
13
+ * The page dump (scripts/eval/dump-longmemeval-pages.ts) is step one of a two-step LongMemEval run: the pages, made with no model
14
+ * and no key, possibly on another machine. Step two (scripts/eval/run-longmemeval-qa.ts --run <dump>) reads it and answers and grades.
15
+ * This module is what both ends agree on: how the pages are hashed, and the check that a dump on disk is the dump its manifest
16
+ * describes, made before the QA run spends anything. The QA manifest then carries the dump's provenance (which caches its pages came
17
+ * from), so the output alone can show it after the dump directory is gone.
18
+ */
19
+ const sha256 = (data) => node_crypto_1.default.createHash('sha256').update(data).digest('hex');
20
+ const jsonl = (rows) => rows.map(row => JSON.stringify(row)).join('\n') + '\n';
21
+ exports.jsonl = jsonl;
22
+ /** The pages alone, no timings: equal for two dumps of the same questions exactly when the reader would see the same pages. */
23
+ function pagesSha256Of(resultRows) {
24
+ return sha256((0, exports.jsonl)(resultRows.map(row => ({ id: row.id, hits: row.hits }))));
25
+ }
26
+ const readRows = (file) => node_fs_1.default.readFileSync(file, 'utf8').split('\n').filter(Boolean).map(line => JSON.parse(line));
27
+ /**
28
+ * Null for a run directory that is not a page dump (a retrieval run from run-longmemeval.ts). For a page dump: recompute the hashes
29
+ * from the files and throw unless they are the manifest's, so a dump that was edited, truncated or mixed with another one is refused
30
+ * before the first model call.
31
+ */
32
+ function verifyPageDump(runDir, manifest) {
33
+ if (manifest.kind !== 'page-dump')
34
+ return null;
35
+ const fail = (what) => { throw new Error(`Refused: page dump ${runDir} does not match its manifest (${what}); dump it again`); };
36
+ if (manifest.scored !== false || manifest.noModelCalls !== true)
37
+ fail('a page dump is unscored and made with no model call');
38
+ const resultsPath = node_path_1.default.join(runDir, 'results.jsonl');
39
+ const casesPath = node_path_1.default.join(runDir, 'cases.jsonl');
40
+ const resultsBytes = node_fs_1.default.readFileSync(resultsPath);
41
+ const casesBytes = node_fs_1.default.readFileSync(casesPath);
42
+ if (sha256(resultsBytes) !== manifest.resultsSha256)
43
+ fail('results.jsonl hash');
44
+ if (sha256(casesBytes) !== manifest.casesSha256)
45
+ fail('cases.jsonl hash');
46
+ const rows = readRows(resultsPath);
47
+ if (pagesSha256Of(rows) !== manifest.pagesSha256)
48
+ fail('pages hash');
49
+ if (rows.length !== manifest.selectedCases)
50
+ fail(`${rows.length} pages for ${String(manifest.selectedCases)} selected questions`);
51
+ const ids = Array.isArray(manifest.selectionIds) ? manifest.selectionIds : [];
52
+ if (ids.length !== rows.length || ids.some((id, index) => rows[index].id !== id))
53
+ fail('selected question ids');
54
+ return {
55
+ kind: 'page-dump',
56
+ pagesSha256: manifest.pagesSha256,
57
+ resultsSha256: manifest.resultsSha256,
58
+ casesSha256: manifest.casesSha256,
59
+ selectedCases: rows.length,
60
+ cachesUsed: manifest.cachesUsed ?? null,
61
+ gitSha: manifest.gitSha ?? null,
62
+ gitShaSource: manifest.gitShaSource ?? null,
63
+ gitDirty: manifest.gitDirty ?? null,
64
+ noModelCalls: true,
65
+ verified: true,
66
+ };
67
+ }