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,146 @@
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.DigestCache = exports.DIGEST_CACHE_SCHEMA_VERSION = void 0;
7
+ const node_fs_1 = __importDefault(require("node:fs"));
8
+ const node_crypto_1 = __importDefault(require("node:crypto"));
9
+ const node_path_1 = __importDefault(require("node:path"));
10
+ const sqlite_1 = __importDefault(require("../db/sqlite"));
11
+ /**
12
+ * Content-addressed store for per-note digests (RENOR_DIGESTS, src/digests/digests.ts).
13
+ *
14
+ * digest key = sha256(schema \0 model \0 reasoning effort \0 sha256(prompt template) \0 input version \0 note_hash)
15
+ *
16
+ * A note's digest is keyed by the hash of the note's file (the index's `note_hash`), so an unchanged note is never
17
+ * digested twice, an edited note gets a new digest, and a changed prompt, model or input rule re-digests every note.
18
+ * An empty digest (the note states nothing about the user's life) is stored too, so it is not asked for again.
19
+ *
20
+ * The item vectors live beside the digest, one set per embedding space (provider, model, dimensions): a digest
21
+ * outlives a change of embedding model, only its vectors are rebuilt. A vector from another space is never read.
22
+ *
23
+ * Design follows src/router/routerCache.ts: SQLite + WAL + busy_timeout=10000 + INSERT OR IGNORE.
24
+ */
25
+ exports.DIGEST_CACHE_SCHEMA_VERSION = 'note-digest-v1';
26
+ const sha256 = (text) => node_crypto_1.default.createHash('sha256').update(text).digest('hex');
27
+ class DigestCache {
28
+ db;
29
+ getDigestStmt;
30
+ putDigestStmt;
31
+ getVectorsStmt;
32
+ putVectorsStmt;
33
+ constructor(dbPath, opts = {}) {
34
+ if (!opts.readonly)
35
+ node_fs_1.default.mkdirSync(node_path_1.default.dirname(dbPath), { recursive: true });
36
+ this.db = new sqlite_1.default(dbPath, opts.readonly ? { readonly: true, fileMustExist: true } : undefined);
37
+ if (!opts.readonly) {
38
+ this.db.pragma('journal_mode = WAL');
39
+ this.db.exec(`
40
+ CREATE TABLE IF NOT EXISTS note_digests (
41
+ cache_key TEXT PRIMARY KEY,
42
+ schema_version TEXT NOT NULL,
43
+ model TEXT NOT NULL,
44
+ note_hash TEXT NOT NULL,
45
+ items_json TEXT NOT NULL,
46
+ created_at TEXT NOT NULL
47
+ );
48
+ CREATE TABLE IF NOT EXISTS digest_vectors (
49
+ cache_key TEXT NOT NULL,
50
+ space TEXT NOT NULL,
51
+ dims INTEGER NOT NULL,
52
+ vectors BLOB NOT NULL,
53
+ PRIMARY KEY (cache_key, space)
54
+ );
55
+ -- What the background worker (src/digests/worker.ts) spent per UTC day: the per-workspace cost guard reads it.
56
+ CREATE TABLE IF NOT EXISTS digest_spend (
57
+ day TEXT PRIMARY KEY,
58
+ calls INTEGER NOT NULL DEFAULT 0,
59
+ prompt_tokens INTEGER NOT NULL DEFAULT 0,
60
+ completion_tokens INTEGER NOT NULL DEFAULT 0,
61
+ micro_usd INTEGER NOT NULL DEFAULT 0
62
+ );
63
+ `);
64
+ }
65
+ this.db.pragma('busy_timeout = 10000');
66
+ this.getDigestStmt = this.db.prepare('SELECT items_json, model FROM note_digests WHERE cache_key = ?');
67
+ this.putDigestStmt = this.db.prepare(`INSERT OR IGNORE INTO note_digests (cache_key, schema_version, model, note_hash, items_json, created_at)
68
+ VALUES (?, ?, ?, ?, ?, ?)`);
69
+ this.getVectorsStmt = this.db.prepare('SELECT dims, vectors FROM digest_vectors WHERE cache_key = ? AND space = ?');
70
+ this.putVectorsStmt = this.db.prepare('INSERT OR IGNORE INTO digest_vectors (cache_key, space, dims, vectors) VALUES (?, ?, ?, ?)');
71
+ }
72
+ static digestKey(model, effort, promptTemplate, inputVersion, noteHash) {
73
+ return sha256([exports.DIGEST_CACHE_SCHEMA_VERSION, model, effort, sha256(promptTemplate), inputVersion, noteHash].join('\0'));
74
+ }
75
+ getDigest(key) {
76
+ const row = this.getDigestStmt.get(key);
77
+ if (!row)
78
+ return null;
79
+ return { items: JSON.parse(row.items_json), model: row.model };
80
+ }
81
+ putDigest(key, noteHash, entry) {
82
+ this.putDigestStmt.run(key, exports.DIGEST_CACHE_SCHEMA_VERSION, entry.model, noteHash, JSON.stringify(entry.items), new Date().toISOString());
83
+ }
84
+ /** The item vectors of one digest in one embedding space, or null when they are absent or do not match the items. */
85
+ getVectors(key, space, count) {
86
+ const row = this.getVectorsStmt.get(key, space);
87
+ if (!row || row.dims <= 0 || row.vectors.length !== count * row.dims * 4)
88
+ return null;
89
+ const floats = new Float32Array(row.vectors.buffer.slice(row.vectors.byteOffset, row.vectors.byteOffset + row.vectors.length));
90
+ const out = [];
91
+ for (let i = 0; i < count; i++)
92
+ out.push(Array.from(floats.subarray(i * row.dims, (i + 1) * row.dims)));
93
+ return out;
94
+ }
95
+ putVectors(key, space, vectors) {
96
+ if (vectors.length === 0)
97
+ return;
98
+ const dims = vectors[0].length;
99
+ const floats = new Float32Array(vectors.length * dims);
100
+ vectors.forEach((vector, i) => floats.set(vector, i * dims));
101
+ this.putVectorsStmt.run(key, space, dims, Buffer.from(floats.buffer));
102
+ }
103
+ /** The models the cache holds digests of, and how many digests each: what an eval run reads to arm the digests for the model the cache holds. */
104
+ digestsByModel() {
105
+ return this.db.prepare('SELECT model, COUNT(*) AS digests FROM note_digests GROUP BY model ORDER BY model').all();
106
+ }
107
+ /**
108
+ * Keep only the digests of the notes whose file hash is in `noteHashes`, and the vectors that go with them: a digest
109
+ * of text a note no longer holds (it was edited, forgotten, or its file is gone) is derived from content the user
110
+ * removed, so it is not kept. Only the workspace's own cache calls this: an eval cache is shared by many vaults.
111
+ * Returns how many digests it removed.
112
+ */
113
+ retainOnly(noteHashes) {
114
+ const rows = this.db.prepare('SELECT cache_key, note_hash FROM note_digests').all();
115
+ const stale = rows.filter(row => !noteHashes.has(row.note_hash));
116
+ if (stale.length === 0)
117
+ return 0;
118
+ const dropDigest = this.db.prepare('DELETE FROM note_digests WHERE cache_key = ?');
119
+ const dropVectors = this.db.prepare('DELETE FROM digest_vectors WHERE cache_key = ?');
120
+ this.db.transaction(() => {
121
+ for (const row of stale) {
122
+ dropVectors.run(row.cache_key);
123
+ dropDigest.run(row.cache_key);
124
+ }
125
+ })();
126
+ return stale.length;
127
+ }
128
+ /** What the worker has spent on `day` (a UTC `YYYY-MM-DD`), in USD. */
129
+ spentUsd(day) {
130
+ const row = this.db.prepare('SELECT micro_usd FROM digest_spend WHERE day = ?').get(day);
131
+ return (row?.micro_usd ?? 0) / 1e6;
132
+ }
133
+ addSpend(day, promptTokens, completionTokens, usd) {
134
+ this.db.prepare(`INSERT INTO digest_spend (day, calls, prompt_tokens, completion_tokens, micro_usd) VALUES (?, 1, ?, ?, ?)
135
+ ON CONFLICT(day) DO UPDATE SET calls = calls + 1, prompt_tokens = prompt_tokens + excluded.prompt_tokens,
136
+ completion_tokens = completion_tokens + excluded.completion_tokens, micro_usd = micro_usd + excluded.micro_usd`).run(day, Math.max(0, Math.round(promptTokens)), Math.max(0, Math.round(completionTokens)), Math.max(0, Math.round(usd * 1e6)));
137
+ }
138
+ /** Spend rows older than the newest `keepDays` days are dropped, so the table does not grow without bound. */
139
+ pruneSpend(keepDays) {
140
+ this.db.prepare('DELETE FROM digest_spend WHERE day NOT IN (SELECT day FROM digest_spend ORDER BY day DESC LIMIT ?)').run(keepDays);
141
+ }
142
+ close() {
143
+ this.db.close();
144
+ }
145
+ }
146
+ exports.DigestCache = DigestCache;