@oscharko-dev/keiko 0.2.9 → 0.2.10

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 (206) hide show
  1. package/dist/ui/csp-hashes.json +15 -15
  2. package/dist/ui/static/404.html +1 -1
  3. package/dist/ui/static/__next.__PAGE__.txt +2 -2
  4. package/dist/ui/static/__next._full.txt +3 -3
  5. package/dist/ui/static/__next._head.txt +1 -1
  6. package/dist/ui/static/__next._index.txt +2 -2
  7. package/dist/ui/static/__next._tree.txt +2 -2
  8. package/dist/ui/static/_next/static/chunks/1587.617caa17651dac38.js +1 -0
  9. package/dist/ui/static/_next/static/chunks/2063.22631ea0405e4bb8.js +1 -0
  10. package/dist/ui/static/_next/static/chunks/3883.6a682796a62b576a.js +1 -0
  11. package/dist/ui/static/_next/static/chunks/3968.133ba5ea9ceed689.js +1 -0
  12. package/dist/ui/static/_next/static/chunks/4444.2b28731160b8c136.js +1 -0
  13. package/dist/ui/static/_next/static/chunks/4792.093159997fe3fbef.js +1 -0
  14. package/dist/ui/static/_next/static/chunks/{9211-06ff5a834d85f608.js → 6565-478649df3cb99b80.js} +2 -2
  15. package/dist/ui/static/_next/static/chunks/7301.0750920b7a295c19.js +1 -0
  16. package/dist/ui/static/_next/static/chunks/8395.500469ba6d01580a.js +1 -0
  17. package/dist/ui/static/_next/static/chunks/{8556.4f751fdef390f050.js → 8556.0ec3541a6b932c72.js} +1 -1
  18. package/dist/ui/static/_next/static/chunks/8824-59a261e25fd0a5d0.js +102 -0
  19. package/dist/ui/static/_next/static/chunks/8835-0b991bfcb0308e77.js +1 -0
  20. package/dist/ui/static/_next/static/chunks/9682.565c030c9bd50e04.js +1 -0
  21. package/dist/ui/static/_next/static/chunks/9832.92edd670fc6dec55.js +1 -0
  22. package/dist/ui/static/_next/static/chunks/aad4249a.1f9d09171ef39096.js +45 -0
  23. package/dist/ui/static/_next/static/chunks/app/launch/page-7e1c4ec16697ece8.js +1 -0
  24. package/dist/ui/static/_next/static/chunks/app/local-knowledge/page-7aebdcecb102697e.js +1 -0
  25. package/dist/ui/static/_next/static/chunks/app/page-e7eafa7e282e0347.js +1 -0
  26. package/dist/ui/static/_next/static/chunks/webpack-c61050a60249b41b.js +1 -0
  27. package/dist/ui/static/_next/static/css/{5881ca0ca97f8d4f.css → a44f4ffb37299b42.css} +2 -2
  28. package/dist/ui/static/_next/static/media/pdf.worker.145f9e3d.mjs +6 -0
  29. package/dist/ui/static/_not-found/__next._full.txt +2 -2
  30. package/dist/ui/static/_not-found/__next._head.txt +1 -1
  31. package/dist/ui/static/_not-found/__next._index.txt +2 -2
  32. package/dist/ui/static/_not-found/__next._not-found.__PAGE__.txt +1 -1
  33. package/dist/ui/static/_not-found/__next._not-found.txt +1 -1
  34. package/dist/ui/static/_not-found/__next._tree.txt +2 -2
  35. package/dist/ui/static/_not-found.html +1 -1
  36. package/dist/ui/static/_not-found.txt +2 -2
  37. package/dist/ui/static/index.html +1 -1
  38. package/dist/ui/static/index.txt +3 -3
  39. package/dist/ui/static/launch/__next._full.txt +3 -3
  40. package/dist/ui/static/launch/__next._head.txt +1 -1
  41. package/dist/ui/static/launch/__next._index.txt +2 -2
  42. package/dist/ui/static/launch/__next._tree.txt +2 -2
  43. package/dist/ui/static/launch/__next.launch.__PAGE__.txt +2 -2
  44. package/dist/ui/static/launch/__next.launch.txt +1 -1
  45. package/dist/ui/static/launch.html +1 -1
  46. package/dist/ui/static/launch.txt +3 -3
  47. package/dist/ui/static/local-knowledge/__next._full.txt +3 -3
  48. package/dist/ui/static/local-knowledge/__next._head.txt +1 -1
  49. package/dist/ui/static/local-knowledge/__next._index.txt +2 -2
  50. package/dist/ui/static/local-knowledge/__next._tree.txt +2 -2
  51. package/dist/ui/static/local-knowledge/__next.local-knowledge.__PAGE__.txt +2 -2
  52. package/dist/ui/static/local-knowledge/__next.local-knowledge.txt +1 -1
  53. package/dist/ui/static/local-knowledge/capsule/__next._full.txt +3 -3
  54. package/dist/ui/static/local-knowledge/capsule/__next._head.txt +1 -1
  55. package/dist/ui/static/local-knowledge/capsule/__next._index.txt +2 -2
  56. package/dist/ui/static/local-knowledge/capsule/__next._tree.txt +2 -2
  57. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.capsule.__PAGE__.txt +2 -2
  58. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.capsule.txt +1 -1
  59. package/dist/ui/static/local-knowledge/capsule/__next.local-knowledge.txt +1 -1
  60. package/dist/ui/static/local-knowledge/capsule.html +1 -1
  61. package/dist/ui/static/local-knowledge/capsule.txt +3 -3
  62. package/dist/ui/static/local-knowledge.html +1 -1
  63. package/dist/ui/static/local-knowledge.txt +3 -3
  64. package/dist/ui/static/memoriaviva/__next._full.txt +2 -2
  65. package/dist/ui/static/memoriaviva/__next._head.txt +1 -1
  66. package/dist/ui/static/memoriaviva/__next._index.txt +2 -2
  67. package/dist/ui/static/memoriaviva/__next._tree.txt +2 -2
  68. package/dist/ui/static/memoriaviva/__next.memoriaviva.__PAGE__.txt +1 -1
  69. package/dist/ui/static/memoriaviva/__next.memoriaviva.txt +1 -1
  70. package/dist/ui/static/memoriaviva/consolidation/__next._full.txt +2 -2
  71. package/dist/ui/static/memoriaviva/consolidation/__next._head.txt +1 -1
  72. package/dist/ui/static/memoriaviva/consolidation/__next._index.txt +2 -2
  73. package/dist/ui/static/memoriaviva/consolidation/__next._tree.txt +2 -2
  74. package/dist/ui/static/memoriaviva/consolidation/__next.memoriaviva.consolidation.__PAGE__.txt +1 -1
  75. package/dist/ui/static/memoriaviva/consolidation/__next.memoriaviva.consolidation.txt +1 -1
  76. package/dist/ui/static/memoriaviva/consolidation/__next.memoriaviva.txt +1 -1
  77. package/dist/ui/static/memoriaviva/consolidation.html +1 -1
  78. package/dist/ui/static/memoriaviva/consolidation.txt +2 -2
  79. package/dist/ui/static/memoriaviva/detail/__next._full.txt +2 -2
  80. package/dist/ui/static/memoriaviva/detail/__next._head.txt +1 -1
  81. package/dist/ui/static/memoriaviva/detail/__next._index.txt +2 -2
  82. package/dist/ui/static/memoriaviva/detail/__next._tree.txt +2 -2
  83. package/dist/ui/static/memoriaviva/detail/__next.memoriaviva.detail.__PAGE__.txt +1 -1
  84. package/dist/ui/static/memoriaviva/detail/__next.memoriaviva.detail.txt +1 -1
  85. package/dist/ui/static/memoriaviva/detail/__next.memoriaviva.txt +1 -1
  86. package/dist/ui/static/memoriaviva/detail.html +1 -1
  87. package/dist/ui/static/memoriaviva/detail.txt +2 -2
  88. package/dist/ui/static/memoriaviva/review-queue/__next._full.txt +2 -2
  89. package/dist/ui/static/memoriaviva/review-queue/__next._head.txt +1 -1
  90. package/dist/ui/static/memoriaviva/review-queue/__next._index.txt +2 -2
  91. package/dist/ui/static/memoriaviva/review-queue/__next._tree.txt +2 -2
  92. package/dist/ui/static/memoriaviva/review-queue/__next.memoriaviva.review-queue.__PAGE__.txt +1 -1
  93. package/dist/ui/static/memoriaviva/review-queue/__next.memoriaviva.review-queue.txt +1 -1
  94. package/dist/ui/static/memoriaviva/review-queue/__next.memoriaviva.txt +1 -1
  95. package/dist/ui/static/memoriaviva/review-queue.html +1 -1
  96. package/dist/ui/static/memoriaviva/review-queue.txt +2 -2
  97. package/dist/ui/static/memoriaviva.html +1 -1
  98. package/dist/ui/static/memoriaviva.txt +2 -2
  99. package/node_modules/@oscharko-dev/keiko-cli/dist/.tsbuildinfo +1 -1
  100. package/node_modules/@oscharko-dev/keiko-cli/package.json +14 -14
  101. package/node_modules/@oscharko-dev/keiko-contracts/dist/.tsbuildinfo +1 -1
  102. package/node_modules/@oscharko-dev/keiko-contracts/dist/index.d.ts +3 -1
  103. package/node_modules/@oscharko-dev/keiko-contracts/dist/index.d.ts.map +1 -1
  104. package/node_modules/@oscharko-dev/keiko-contracts/dist/index.js +2 -1
  105. package/node_modules/@oscharko-dev/keiko-contracts/dist/local-knowledge-preview.d.ts +101 -0
  106. package/node_modules/@oscharko-dev/keiko-contracts/dist/local-knowledge-preview.d.ts.map +1 -0
  107. package/node_modules/@oscharko-dev/keiko-contracts/dist/local-knowledge-preview.js +62 -0
  108. package/node_modules/@oscharko-dev/keiko-contracts/dist/local-knowledge-schema.d.ts +1 -1
  109. package/node_modules/@oscharko-dev/keiko-contracts/dist/local-knowledge-schema.d.ts.map +1 -1
  110. package/node_modules/@oscharko-dev/keiko-contracts/dist/local-knowledge-schema.js +59 -2
  111. package/node_modules/@oscharko-dev/keiko-contracts/package.json +5 -1
  112. package/node_modules/@oscharko-dev/keiko-evaluations/dist/.tsbuildinfo +1 -1
  113. package/node_modules/@oscharko-dev/keiko-evaluations/package.json +9 -9
  114. package/node_modules/@oscharko-dev/keiko-evidence/dist/.tsbuildinfo +1 -1
  115. package/node_modules/@oscharko-dev/keiko-evidence/package.json +4 -4
  116. package/node_modules/@oscharko-dev/keiko-harness/dist/.tsbuildinfo +1 -1
  117. package/node_modules/@oscharko-dev/keiko-harness/package.json +6 -6
  118. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/.tsbuildinfo +1 -1
  119. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/citation-preview-snapshot.d.ts +15 -0
  120. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/citation-preview-snapshot.d.ts.map +1 -0
  121. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/citation-preview-snapshot.js +49 -0
  122. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/index.d.ts +1 -0
  123. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/index.d.ts.map +1 -1
  124. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/index.js +1 -0
  125. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/privacy/audit-emitter.d.ts.map +1 -1
  126. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/privacy/audit-emitter.js +45 -19
  127. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/privacy/types.d.ts +21 -1
  128. package/node_modules/@oscharko-dev/keiko-local-knowledge/dist/privacy/types.d.ts.map +1 -1
  129. package/node_modules/@oscharko-dev/keiko-local-knowledge/package.json +5 -5
  130. package/node_modules/@oscharko-dev/keiko-memory-capture/package.json +3 -3
  131. package/node_modules/@oscharko-dev/keiko-memory-consolidation/package.json +3 -3
  132. package/node_modules/@oscharko-dev/keiko-memory-governance/package.json +3 -3
  133. package/node_modules/@oscharko-dev/keiko-memory-retrieval/package.json +3 -3
  134. package/node_modules/@oscharko-dev/keiko-memory-vault/dist/.tsbuildinfo +1 -1
  135. package/node_modules/@oscharko-dev/keiko-memory-vault/package.json +3 -3
  136. package/node_modules/@oscharko-dev/keiko-model-gateway/dist/.tsbuildinfo +1 -1
  137. package/node_modules/@oscharko-dev/keiko-model-gateway/package.json +3 -3
  138. package/node_modules/@oscharko-dev/keiko-quality-intelligence/dist/.tsbuildinfo +1 -1
  139. package/node_modules/@oscharko-dev/keiko-quality-intelligence/package.json +3 -3
  140. package/node_modules/@oscharko-dev/keiko-sandbox/dist/.tsbuildinfo +1 -1
  141. package/node_modules/@oscharko-dev/keiko-sandbox/package.json +2 -2
  142. package/node_modules/@oscharko-dev/keiko-sdk/dist/.tsbuildinfo +1 -1
  143. package/node_modules/@oscharko-dev/keiko-sdk/package.json +9 -9
  144. package/node_modules/@oscharko-dev/keiko-security/dist/.tsbuildinfo +1 -1
  145. package/node_modules/@oscharko-dev/keiko-security/package.json +2 -2
  146. package/node_modules/@oscharko-dev/keiko-server/dist/.tsbuildinfo +1 -1
  147. package/node_modules/@oscharko-dev/keiko-server/dist/deps.d.ts +2 -0
  148. package/node_modules/@oscharko-dev/keiko-server/dist/deps.d.ts.map +1 -1
  149. package/node_modules/@oscharko-dev/keiko-server/dist/grounded-qa-hybrid.d.ts.map +1 -1
  150. package/node_modules/@oscharko-dev/keiko-server/dist/grounded-qa-hybrid.js +19 -2
  151. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-grounded-qa.d.ts.map +1 -1
  152. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-grounded-qa.js +26 -4
  153. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-authority.d.ts +11 -0
  154. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-authority.d.ts.map +1 -0
  155. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-authority.js +85 -0
  156. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-delivery.d.ts +16 -0
  157. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-delivery.d.ts.map +1 -0
  158. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-delivery.js +131 -0
  159. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-handlers.d.ts +8 -0
  160. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-handlers.d.ts.map +1 -0
  161. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-handlers.js +349 -0
  162. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-service.d.ts +29 -0
  163. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-service.d.ts.map +1 -0
  164. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-service.js +260 -0
  165. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-session-manager.d.ts +41 -0
  166. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-session-manager.d.ts.map +1 -0
  167. package/node_modules/@oscharko-dev/keiko-server/dist/local-knowledge-preview-session-manager.js +145 -0
  168. package/node_modules/@oscharko-dev/keiko-server/dist/routes.d.ts.map +1 -1
  169. package/node_modules/@oscharko-dev/keiko-server/dist/routes.js +26 -0
  170. package/node_modules/@oscharko-dev/keiko-server/dist/store/db.d.ts.map +1 -1
  171. package/node_modules/@oscharko-dev/keiko-server/dist/store/db.js +3 -2
  172. package/node_modules/@oscharko-dev/keiko-server/dist/store/messages.d.ts +3 -2
  173. package/node_modules/@oscharko-dev/keiko-server/dist/store/messages.d.ts.map +1 -1
  174. package/node_modules/@oscharko-dev/keiko-server/dist/store/messages.js +37 -7
  175. package/node_modules/@oscharko-dev/keiko-server/dist/store/schema.d.ts +1 -1
  176. package/node_modules/@oscharko-dev/keiko-server/dist/store/schema.d.ts.map +1 -1
  177. package/node_modules/@oscharko-dev/keiko-server/dist/store/schema.js +9 -1
  178. package/node_modules/@oscharko-dev/keiko-server/dist/store/types.d.ts +4 -2
  179. package/node_modules/@oscharko-dev/keiko-server/dist/store/types.d.ts.map +1 -1
  180. package/node_modules/@oscharko-dev/keiko-server/package.json +19 -19
  181. package/node_modules/@oscharko-dev/keiko-tools/dist/.tsbuildinfo +1 -1
  182. package/node_modules/@oscharko-dev/keiko-tools/package.json +5 -5
  183. package/node_modules/@oscharko-dev/keiko-verification/dist/.tsbuildinfo +1 -1
  184. package/node_modules/@oscharko-dev/keiko-verification/package.json +5 -5
  185. package/node_modules/@oscharko-dev/keiko-workflows/dist/.tsbuildinfo +1 -1
  186. package/node_modules/@oscharko-dev/keiko-workflows/package.json +10 -10
  187. package/node_modules/@oscharko-dev/keiko-workspace/dist/.tsbuildinfo +1 -1
  188. package/node_modules/@oscharko-dev/keiko-workspace/package.json +3 -3
  189. package/package.json +22 -22
  190. package/dist/ui/static/_next/static/chunks/1587.33fc772cb66c38d7.js +0 -1
  191. package/dist/ui/static/_next/static/chunks/2063.a7cd2441b60aa093.js +0 -1
  192. package/dist/ui/static/_next/static/chunks/2107.c1ff3a39fd003d88.js +0 -1
  193. package/dist/ui/static/_next/static/chunks/3883.f8e3dc3fea7fdbe1.js +0 -1
  194. package/dist/ui/static/_next/static/chunks/3968.55fa02cd74fb96b3.js +0 -1
  195. package/dist/ui/static/_next/static/chunks/4444.46b9cfb85257a381.js +0 -1
  196. package/dist/ui/static/_next/static/chunks/7301.501daea6a309d3f5.js +0 -1
  197. package/dist/ui/static/_next/static/chunks/8395.e30ea9a63eb35cb3.js +0 -1
  198. package/dist/ui/static/_next/static/chunks/8824-7bd1fafeeeda68c2.js +0 -102
  199. package/dist/ui/static/_next/static/chunks/8835-b68c3abd8ddcb452.js +0 -1
  200. package/dist/ui/static/_next/static/chunks/9682.d5b8d9ce8cb80519.js +0 -1
  201. package/dist/ui/static/_next/static/chunks/app/launch/page-82ed92234aabb847.js +0 -1
  202. package/dist/ui/static/_next/static/chunks/app/local-knowledge/page-9124d233dd58858c.js +0 -1
  203. package/dist/ui/static/_next/static/chunks/app/page-dcdb404becd4ddb6.js +0 -1
  204. package/dist/ui/static/_next/static/chunks/webpack-4e37711fe87dbc9e.js +0 -1
  205. /package/dist/ui/static/_next/static/{tzWFDxPPJ3-NtjB1T1JFu → WGuvz70_f_uiVSiv-B1wx}/_buildManifest.js +0 -0
  206. /package/dist/ui/static/_next/static/{tzWFDxPPJ3-NtjB1T1JFu → WGuvz70_f_uiVSiv-B1wx}/_ssgManifest.js +0 -0
@@ -0,0 +1,145 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ const DEFAULT_TTL_MS = 5 * 60_000;
3
+ const DEFAULT_SWEEP_INTERVAL_MS = 60_000;
4
+ const SETTLED_RETENTION_MS = 10 * 60_000;
5
+ function sha256Hex(value) {
6
+ return createHash("sha256").update(value, "utf8").digest("hex");
7
+ }
8
+ function documentKey(authority) {
9
+ const current = authority.current;
10
+ const citation = authority.citation;
11
+ return sha256Hex(JSON.stringify({
12
+ capsuleId: citation.lineage.capsuleId,
13
+ documentId: citation.lineage.documentId,
14
+ mediaType: current?.documentMediaType ?? citation.documentMediaType,
15
+ sourceId: citation.lineage.sourceId,
16
+ storedContentHash: citation.documentContentHash,
17
+ })).slice(0, 32);
18
+ }
19
+ function toSession(record) {
20
+ return {
21
+ authority: record.authority,
22
+ documentKey: record.documentKey,
23
+ expiresAt: new Date(record.expiresAtMs).toISOString(),
24
+ handle: record.handle,
25
+ state: record.state,
26
+ };
27
+ }
28
+ function settleRecord(state, record, next) {
29
+ record.state = next;
30
+ record.settledAtMs = state.now();
31
+ state.byDocumentKey.delete(record.documentKey);
32
+ }
33
+ function sweepRecords(state) {
34
+ const nowMs = state.now();
35
+ for (const [handle, record] of state.byHandle) {
36
+ if (record.state === "open" && nowMs >= record.expiresAtMs) {
37
+ settleRecord(state, record, "expired");
38
+ continue;
39
+ }
40
+ if (record.state !== "open" &&
41
+ record.settledAtMs !== undefined &&
42
+ nowMs - record.settledAtMs >= SETTLED_RETENTION_MS) {
43
+ state.byHandle.delete(handle);
44
+ }
45
+ }
46
+ }
47
+ function lookupOpenRecord(state, authority) {
48
+ const key = documentKey(authority);
49
+ const handle = state.byDocumentKey.get(key);
50
+ if (handle === undefined)
51
+ return undefined;
52
+ const record = state.byHandle.get(handle);
53
+ if (record?.state !== "open") {
54
+ state.byDocumentKey.delete(key);
55
+ return undefined;
56
+ }
57
+ return record;
58
+ }
59
+ function createManagerState(options) {
60
+ return {
61
+ byDocumentKey: new Map(),
62
+ byHandle: new Map(),
63
+ now: options.now ?? Date.now,
64
+ ttlMs: options.ttlMs ?? DEFAULT_TTL_MS,
65
+ };
66
+ }
67
+ function createSweepTimer(options, state) {
68
+ if (options.autoSweep === false)
69
+ return undefined;
70
+ const sweepTimer = setInterval(sweepRecords, options.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS, state);
71
+ sweepTimer.unref();
72
+ return sweepTimer;
73
+ }
74
+ function lookupSessionRecord(state, handle) {
75
+ sweepRecords(state);
76
+ return state.byHandle.get(handle);
77
+ }
78
+ function closeSessionRecord(state, handle) {
79
+ const record = lookupSessionRecord(state, handle);
80
+ if (record?.state !== "open")
81
+ return false;
82
+ settleRecord(state, record, "closed");
83
+ return true;
84
+ }
85
+ function openSessionRecord(state, authority) {
86
+ sweepRecords(state);
87
+ const existing = lookupOpenRecord(state, authority);
88
+ const expiresAtMs = state.now() + state.ttlMs;
89
+ if (existing !== undefined) {
90
+ existing.authority = authority;
91
+ existing.expiresAtMs = expiresAtMs;
92
+ return { reused: true, session: toSession(existing) };
93
+ }
94
+ const record = {
95
+ authority,
96
+ documentKey: documentKey(authority),
97
+ expiresAtMs,
98
+ handle: randomUUID(),
99
+ state: "open",
100
+ };
101
+ state.byHandle.set(record.handle, record);
102
+ state.byDocumentKey.set(record.documentKey, record.handle);
103
+ return { reused: false, session: toSession(record) };
104
+ }
105
+ function lookupSessionResult(state, handle) {
106
+ const record = lookupSessionRecord(state, handle);
107
+ if (record === undefined)
108
+ return { kind: "missing" };
109
+ if (record.state === "closed")
110
+ return { kind: "closed", session: toSession(record) };
111
+ if (record.state === "expired")
112
+ return { kind: "expired", session: toSession(record) };
113
+ return { kind: "open", session: toSession(record) };
114
+ }
115
+ export function createPdfCitationPreviewSessionManager(options = {}) {
116
+ const state = createManagerState(options);
117
+ const sweepTimer = createSweepTimer(options, state);
118
+ return {
119
+ closeSession: (handle) => closeSessionRecord(state, handle),
120
+ dispose() {
121
+ if (sweepTimer !== undefined) {
122
+ clearInterval(sweepTimer);
123
+ }
124
+ state.byDocumentKey.clear();
125
+ state.byHandle.clear();
126
+ },
127
+ lookupSession: (handle) => lookupSessionResult(state, handle),
128
+ openSession: (authority) => openSessionRecord(state, authority),
129
+ sweep() {
130
+ sweepRecords(state);
131
+ },
132
+ };
133
+ }
134
+ const previewSessionManagers = new WeakMap();
135
+ export function previewSessionManagerFor(deps) {
136
+ const injected = deps.pdfCitationPreviewSessions;
137
+ if (injected !== undefined)
138
+ return injected;
139
+ const existing = previewSessionManagers.get(deps);
140
+ if (existing !== undefined)
141
+ return existing;
142
+ const created = createPdfCitationPreviewSessionManager();
143
+ previewSessionManagers.set(deps, created);
144
+ return created;
145
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAoO/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,SAAS,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAElD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,KAChB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAUD,eAAO,MAAM,UAAU,EAAE,SAAS,eAAe,EAknBhD,CAAC;AA6BF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAKD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,oBAAoB,GAAG,SAAS,CA2B/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,wBAAgB,oBAAoB,IAAI,QAAQ,CAE/C"}
1
+ {"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AA2O/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,SAAS,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAElD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,KAChB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAUD,eAAO,MAAM,UAAU,EAAE,SAAS,eAAe,EA2oBhD,CAAC;AA6BF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAKD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,oBAAoB,GAAG,SAAS,CA2B/C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,wBAAgB,oBAAoB,IAAI,QAAQ,CAE/C"}
@@ -39,6 +39,7 @@ import { handleEditorPatchApply } from "./editor/patchApplyRoutes.js";
39
39
  import { handleEditorAgentActions, handleEditorAgentAudit, handleEditorAgentEvents, handleEditorAgentSessions, handleEditorAgentSnapshot, } from "./editor/agentRoutes.js";
40
40
  import { handleBrowserApplyScreenshot, handleBrowserContent, handleBrowserEvents, handleBrowserNavigate, handleBrowserScreenshot, handleBrowserStatus, handleCreateBrowserSession, handleDeleteBrowserSession, } from "./browser.js";
41
41
  import { handleCancelLocalKnowledgeCapsuleIndexing, handleConnectLocalKnowledgeCapsule, handleCreateLocalKnowledgeCapsule, handleCreateLocalKnowledgeCapsuleSet, handleDeleteLocalKnowledgeCapsule, handleDisconnectLocalKnowledgeCapsule, handleGetLocalKnowledgeCapsule, handleListLocalKnowledgeCapsules, handleListLocalKnowledgeCapsuleSets, handleReindexLocalKnowledgeCapsule, handleStartLocalKnowledgeCapsuleIndexing, handleUpdateLocalKnowledgeCapsule, } from "./local-knowledge-handlers.js";
42
+ import { handleAuthorizePdfCitationPreview, handleClosePdfCitationPreviewSession, handleGetPdfCitationPreviewDocument, handleGetPdfCitationPreviewStatus, handleOpenPdfCitationPreviewSession, } from "./local-knowledge-preview-handlers.js";
42
43
  import { handleRelationshipCreate, handleRelationshipDelete, handleRelationshipDependencies, handleRelationshipEvents, handleRelationshipExplain, handleRelationshipGet, handleRelationshipHealth, handleRelationshipImpact, handleRelationshipList, handleRelationshipPatch, handleRelationshipValidate, } from "./relationship-handlers.js";
43
44
  import { handleQiCapabilities, handleQiDryRunFigma, handleQiDryRunJira, handleQiSourceSelect, handleListQiRuns, handleGetQiRun, QI_HANDOFF_ROUTE_GROUP, QI_RUN_EXECUTION_ROUTE_GROUP, QI_REVIEW_ROUTE_GROUP, QI_EXPORT_ROUTE_GROUP, QI_EDIT_ROUTE_GROUP, QI_RETENTION_ROUTE_GROUP, QI_TRACEABILITY_ROUTE_GROUP, QI_RECHECK_ROUTE_GROUP, } from "./qualityIntelligence/index.js";
44
45
  import { handleFigmaListSnapshots, handleFigmaInspectSnapshotScreenJson, handleFigmaDeleteSnapshot, handleFigmaTriggerSnapshot, handleFigmaLoadSnapshot, handleFigmaLoadSnapshotImage, handleFigmaRevokeToken, handleFigmaUpdateSnapshotMetadata, } from "./qualityIntelligence/figmaSnapshotRoutes.js";
@@ -467,6 +468,31 @@ export const API_ROUTES = [
467
468
  pattern: "/api/local-knowledge/capsules/:capsuleId/reindex",
468
469
  handler: handleReindexLocalKnowledgeCapsule,
469
470
  },
471
+ {
472
+ method: "POST",
473
+ pattern: "/api/local-knowledge/citation-preview/status",
474
+ handler: handleGetPdfCitationPreviewStatus,
475
+ },
476
+ {
477
+ method: "POST",
478
+ pattern: "/api/local-knowledge/citation-preview/authorize",
479
+ handler: handleAuthorizePdfCitationPreview,
480
+ },
481
+ {
482
+ method: "POST",
483
+ pattern: "/api/local-knowledge/citation-preview/open",
484
+ handler: handleOpenPdfCitationPreviewSession,
485
+ },
486
+ {
487
+ method: "GET",
488
+ pattern: "/api/local-knowledge/citation-preview/sessions/:sessionHandle/document",
489
+ handler: handleGetPdfCitationPreviewDocument,
490
+ },
491
+ {
492
+ method: "DELETE",
493
+ pattern: "/api/local-knowledge/citation-preview/sessions/:sessionHandle",
494
+ handler: handleClosePdfCitationPreviewSession,
495
+ },
470
496
  // Issues #209/#211 — MemoriaViva governance routes (Epic #204).
471
497
  { method: "GET", pattern: "/api/memory", handler: handleListMemories },
472
498
  { method: "GET", pattern: "/api/memory/review-queue", handler: handleMemoryReviewQueue },
@@ -1 +1 @@
1
- {"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/store/db.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAMV,OAAO,EACP,qBAAqB,EAKtB,MAAM,YAAY,CAAC;AAkCpB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAM9E;AAiKD,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAa3C,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAI3E;AAgCD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAkB/D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAEvF"}
1
+ {"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/store/db.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAMV,OAAO,EACP,qBAAqB,EAKtB,MAAM,YAAY,CAAC;AAmCpB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAM9E;AAkKD,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAa3C,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAI3E;AAgCD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAkB/D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAEvF"}
@@ -8,7 +8,7 @@ import { randomUUID } from "node:crypto";
8
8
  import { runMigrations } from "./schema.js";
9
9
  import { deleteProject as sqlDeleteProject, getProject as sqlGetProject, listProjects as sqlListProjects, updateProject as sqlUpdateProject, upsertProject as sqlUpsertProject, } from "./projects.js";
10
10
  import { deleteChat as sqlDeleteChat, findChatById as sqlFindChatById, insertChat as sqlInsertChat, listChats as sqlListChats, listChatsLimited as sqlListChatsLimited, touchChat as sqlTouchChat, updateChat as sqlUpdateChat, } from "./chats.js";
11
- import { findMessageById as sqlFindMessageById, attachGroundedAnswer as sqlAttachGroundedAnswer, insertMessage as sqlInsertMessage, listMessages as sqlListMessages, listMessagesLimited as sqlListMessagesLimited, updateMessage as sqlUpdateMessage, } from "./messages.js";
11
+ import { findMessageById as sqlFindMessageById, attachGroundedAnswer as sqlAttachGroundedAnswer, findGroundedPreviewCitations as sqlFindGroundedPreviewCitations, insertMessage as sqlInsertMessage, listMessages as sqlListMessages, listMessagesLimited as sqlListMessagesLimited, updateMessage as sqlUpdateMessage, } from "./messages.js";
12
12
  import { validateProjectPath } from "./validation.js";
13
13
  import { basename } from "node:path";
14
14
  import { invalidRequest } from "./errors.js";
@@ -111,7 +111,8 @@ function buildStore(db, options) {
111
111
  },
112
112
  createMessages: (messages) => createMessageBatch(db, options, messages),
113
113
  updateMessage: (id, patch) => sqlUpdateMessage(db, id, patch, options.redactString),
114
- attachGroundedAnswer: (id, answer) => sqlAttachGroundedAnswer(db, id, answer, options.redactString),
114
+ attachGroundedAnswer: (id, answer, previewCitations) => sqlAttachGroundedAnswer(db, id, answer, previewCitations, options.redactString),
115
+ findGroundedPreviewCitations: (id) => sqlFindGroundedPreviewCitations(db, id),
115
116
  close: () => {
116
117
  db.close();
117
118
  },
@@ -1,9 +1,10 @@
1
1
  import type { DatabaseSync } from "node:sqlite";
2
- import type { ChatMessage, GroundedAnswer, NewChatMessage, UpdateChatMessagePatch } from "./types.js";
2
+ import type { ChatMessage, GroundedAnswer, NewChatMessage, StoredPdfCitationPreviewCitation, UpdateChatMessagePatch } from "./types.js";
3
3
  export declare function listMessages(db: DatabaseSync, chatId: string): readonly ChatMessage[];
4
4
  export declare function listMessagesLimited(db: DatabaseSync, chatId: string, limit: number): readonly ChatMessage[];
5
5
  export declare function findMessageById(db: DatabaseSync, id: string): ChatMessage | undefined;
6
6
  export declare function insertMessage(db: DatabaseSync, id: string, msg: NewChatMessage, redactString: (s: string) => string): ChatMessage;
7
- export declare function attachGroundedAnswer(db: DatabaseSync, id: string, answer: GroundedAnswer, redactString: (s: string) => string): ChatMessage;
7
+ export declare function attachGroundedAnswer(db: DatabaseSync, id: string, answer: GroundedAnswer, previewCitations: readonly StoredPdfCitationPreviewCitation[] | undefined, redactString: (s: string) => string): ChatMessage;
8
+ export declare function findGroundedPreviewCitations(db: DatabaseSync, id: string): readonly StoredPdfCitationPreviewCitation[] | undefined;
8
9
  export declare function updateMessage(db: DatabaseSync, id: string, patch: UpdateChatMessagePatch, redactString: (s: string) => string): ChatMessage;
9
10
  //# sourceMappingURL=messages.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/store/messages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EAEX,cAAc,EACd,cAAc,EACd,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AA4IpB,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAErF;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,SAAS,WAAW,EAAE,CAOxB;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGrF;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CAsBb;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CAcb;AAOD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,EAC7B,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CA6Bb"}
1
+ {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/store/messages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EAEX,cAAc,EACd,cAAc,EACd,gCAAgC,EAChC,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAqKpB,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAErF;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,SAAS,WAAW,EAAE,CAOxB;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGrF;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CAwBb;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,EACtB,gBAAgB,EAAE,SAAS,gCAAgC,EAAE,GAAG,SAAS,EACzE,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CAeb;AAED,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,GACT,SAAS,gCAAgC,EAAE,GAAG,SAAS,CAKzD;AAOD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,EAC7B,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAClC,WAAW,CA6Bb"}
@@ -27,6 +27,16 @@ function parseGroundedAnswer(raw) {
27
27
  return undefined;
28
28
  }
29
29
  }
30
+ function parseGroundedPreviewCitations(raw) {
31
+ if (raw === null)
32
+ return undefined;
33
+ try {
34
+ return JSON.parse(raw);
35
+ }
36
+ catch {
37
+ return undefined;
38
+ }
39
+ }
30
40
  function rowToMessage(row) {
31
41
  const groundedAnswer = parseGroundedAnswer(row.grounded_answer_json);
32
42
  return {
@@ -43,15 +53,15 @@ function rowToMessage(row) {
43
53
  ...(groundedAnswer === undefined ? {} : { groundedAnswer }),
44
54
  };
45
55
  }
46
- const COLUMNS = "id, chat_id, role, content, timestamp, run_id, workflow_id, workflow_status, short_result, task_type, grounded_answer_json";
56
+ const COLUMNS = "id, chat_id, role, content, timestamp, run_id, workflow_id, workflow_status, short_result, task_type, grounded_answer_json, grounded_preview_citations_json";
47
57
  const SQL_LIST = `SELECT ${COLUMNS} FROM chat_messages WHERE chat_id = ? ORDER BY timestamp ASC, rowid ASC`;
48
58
  const SQL_LIST_LIMITED = `${SQL_LIST} LIMIT ?`;
49
59
  const SQL_FIND_BY_ID = `SELECT ${COLUMNS} FROM chat_messages WHERE id = ? LIMIT 1`;
50
60
  const SQL_CHAT_EXISTS = "SELECT 1 FROM chats WHERE id = ?";
51
61
  const SQL_INSERT = `
52
62
  INSERT INTO chat_messages
53
- (id, chat_id, role, content, timestamp, run_id, workflow_id, workflow_status, short_result, task_type, grounded_answer_json)
54
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
63
+ (id, chat_id, role, content, timestamp, run_id, workflow_id, workflow_status, short_result, task_type, grounded_answer_json, grounded_preview_citations_json)
64
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
55
65
  RETURNING ${COLUMNS}
56
66
  `;
57
67
  function validateTaskType(value) {
@@ -113,6 +123,18 @@ function processGroundedAnswer(raw, redactString) {
113
123
  }
114
124
  return redacted;
115
125
  }
126
+ function processGroundedPreviewCitations(raw) {
127
+ if (raw === undefined)
128
+ return null;
129
+ const json = JSON.stringify(raw);
130
+ try {
131
+ JSON.parse(json);
132
+ }
133
+ catch {
134
+ throw invalidRequest("Grounded preview citation metadata is invalid.");
135
+ }
136
+ return json;
137
+ }
116
138
  export function listMessages(db, chatId) {
117
139
  return db.prepare(SQL_LIST).all(chatId).map(rowToMessage);
118
140
  }
@@ -133,25 +155,33 @@ export function insertMessage(db, id, msg, redactString) {
133
155
  throw notFound("Chat");
134
156
  const shortResult = processShortResult(msg.shortResult, redactString);
135
157
  const groundedAnswer = processGroundedAnswer(msg.groundedAnswer, redactString);
158
+ const groundedPreviewCitations = null;
136
159
  const row = db
137
160
  .prepare(SQL_INSERT)
138
- .get(id, msg.chatId, msg.role, msg.content, msg.timestamp, msg.runId ?? null, msg.workflowId ?? null, msg.workflowStatus ?? null, shortResult, msg.taskType ?? null, groundedAnswer);
161
+ .get(id, msg.chatId, msg.role, msg.content, msg.timestamp, msg.runId ?? null, msg.workflowId ?? null, msg.workflowStatus ?? null, shortResult, msg.taskType ?? null, groundedAnswer, groundedPreviewCitations);
139
162
  return rowToMessage(row);
140
163
  }
141
- export function attachGroundedAnswer(db, id, answer, redactString) {
164
+ export function attachGroundedAnswer(db, id, answer, previewCitations, redactString) {
142
165
  const groundedAnswer = processGroundedAnswer(answer, redactString);
166
+ const groundedPreviewCitations = processGroundedPreviewCitations(previewCitations);
143
167
  const row = db
144
168
  .prepare(`
145
169
  UPDATE chat_messages
146
- SET grounded_answer_json = ?
170
+ SET grounded_answer_json = ?, grounded_preview_citations_json = ?
147
171
  WHERE id = ? AND role = 'assistant'
148
172
  RETURNING ${COLUMNS}
149
173
  `)
150
- .get(groundedAnswer, id);
174
+ .get(groundedAnswer, groundedPreviewCitations, id);
151
175
  if (row === undefined)
152
176
  throw notFound("Message");
153
177
  return rowToMessage(row);
154
178
  }
179
+ export function findGroundedPreviewCitations(db, id) {
180
+ const row = db.prepare(SQL_FIND_BY_ID).get(id);
181
+ return row === undefined
182
+ ? undefined
183
+ : parseGroundedPreviewCitations(row.grounded_preview_citations_json);
184
+ }
155
185
  // Issue #66 — Partial PATCH on a system run-summary message. Builds a dynamic SET clause from the
156
186
  // supplied fields so absent fields are not overwritten. shortResult goes through the existing
157
187
  // redact+truncate pipeline. workflowStatus and taskType are validated before SQL is built. An
@@ -1,4 +1,4 @@
1
1
  import type { DatabaseSync } from "node:sqlite";
2
- export declare const SCHEMA_VERSION = 8;
2
+ export declare const SCHEMA_VERSION = 9;
3
3
  export declare function runMigrations(db: DatabaseSync): void;
4
4
  //# sourceMappingURL=schema.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,cAAc,IAAI,CAAC;AA2RhC,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAepD"}
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,cAAc,IAAI,CAAC;AAoShC,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAepD"}
@@ -1,7 +1,7 @@
1
1
  // ADR-0013 D5 — Schema v1 + migration runner via PRAGMA user_version. Forward-only, idempotent,
2
2
  // transactional. Each migration is a `.sql` string of one or more CREATE/ALTER statements; the
3
3
  // runner applies migrations whose 1-based index > current user_version.
4
- export const SCHEMA_VERSION = 8;
4
+ export const SCHEMA_VERSION = 9;
5
5
  const V1_SQL = `
6
6
  CREATE TABLE projects (
7
7
  path TEXT NOT NULL PRIMARY KEY,
@@ -248,6 +248,13 @@ CREATE TABLE task_workspace_active_pointer (
248
248
  FOREIGN KEY (workspace_id) REFERENCES task_workspace_instances(workspace_id) ON DELETE CASCADE
249
249
  ) STRICT;
250
250
  `;
251
+ // V9 (issue #1632) adds a server-only assistant-message metadata column for authoritative Local
252
+ // Knowledge PDF preview citations. The browser-safe grounded_answer_json remains the public wire
253
+ // payload; this sibling JSON stores only the minimum private lineage + content-hash metadata the
254
+ // preview authorization contract needs and is never projected through ChatMessage.
255
+ const V9_SQL = `
256
+ ALTER TABLE chat_messages ADD COLUMN grounded_preview_citations_json TEXT;
257
+ `;
251
258
  const MIGRATIONS = [
252
259
  { version: 1, sql: V1_SQL },
253
260
  { version: 2, sql: V2_SQL },
@@ -257,6 +264,7 @@ const MIGRATIONS = [
257
264
  { version: 6, sql: V6_SQL },
258
265
  { version: 7, sql: V7_SQL },
259
266
  { version: 8, sql: V8_SQL },
267
+ { version: 9, sql: V9_SQL },
260
268
  ];
261
269
  function currentUserVersion(db) {
262
270
  const row = db.prepare("PRAGMA user_version").get();
@@ -1,5 +1,6 @@
1
1
  import type { Project, Chat, ChatConnectedScope, ChatLocalKnowledgeScope, ChatRole, WorkflowStatus, ChatMessage, CreateChatOptions, GroundedAnswer, UpdateProjectPatch, UpdateChatPatch, NewChatMessage, UpdateChatMessagePatch } from "@oscharko-dev/keiko-contracts/bff-wire";
2
- export type { Project, Chat, ChatConnectedScope, ChatLocalKnowledgeScope, ChatRole, WorkflowStatus, ChatMessage, CreateChatOptions, GroundedAnswer, UpdateProjectPatch, UpdateChatPatch, NewChatMessage, UpdateChatMessagePatch, };
2
+ import type { StoredPdfCitationPreviewCitation } from "@oscharko-dev/keiko-contracts";
3
+ export type { Project, Chat, ChatConnectedScope, ChatLocalKnowledgeScope, ChatRole, WorkflowStatus, ChatMessage, CreateChatOptions, GroundedAnswer, UpdateProjectPatch, UpdateChatPatch, NewChatMessage, UpdateChatMessagePatch, StoredPdfCitationPreviewCitation, };
3
4
  export interface UiStore {
4
5
  readonly listProjects: () => readonly Project[];
5
6
  readonly createProject: (path: string, name?: string) => Project;
@@ -15,7 +16,8 @@ export interface UiStore {
15
16
  readonly createMessage: (msg: NewChatMessage) => ChatMessage;
16
17
  readonly createMessages: (messages: readonly NewChatMessage[]) => readonly ChatMessage[];
17
18
  readonly updateMessage: (id: string, patch: UpdateChatMessagePatch) => ChatMessage;
18
- readonly attachGroundedAnswer: (id: string, answer: GroundedAnswer) => ChatMessage;
19
+ readonly attachGroundedAnswer: (id: string, answer: GroundedAnswer, previewCitations?: readonly StoredPdfCitationPreviewCitation[]) => ChatMessage;
20
+ readonly findGroundedPreviewCitations: (id: string) => readonly StoredPdfCitationPreviewCitation[] | undefined;
19
21
  readonly close: () => void;
20
22
  }
21
23
  export interface UpdateChatOptions {
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,OAAO,EACP,IAAI,EACJ,kBAAkB,EAClB,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,sBAAsB,EACvB,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,OAAO,EACP,IAAI,EACJ,kBAAkB,EAClB,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,sBAAsB,GACvB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,SAAS,OAAO,EAAE,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACjE,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/C,QAAQ,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,SAAS,IAAI,EAAE,CAAC;IAC7E,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,CACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,iBAAiB,KACrB,IAAI,CAAC;IACV,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC/F,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,SAAS,WAAW,EAAE,CAAC;IAClF,QAAQ,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,WAAW,CAAC;IAC7D,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,KAAK,SAAS,WAAW,EAAE,CAAC;IACzF,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,KAAK,WAAW,CAAC;IACnF,QAAQ,CAAC,oBAAoB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,WAAW,CAAC;IAEnF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAC5C;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oscharko-dev/keiko-server",
3
- "version": "0.2.9",
3
+ "version": "0.2.10",
4
4
  "type": "module",
5
5
  "license": "Apache-2.0",
6
6
  "description": "Internal server package: local loopback BFF runtime (HTTP/SSE/WebSocket router, CSP, host check, CSRF gate, terminal, browser, files, run engine, SQLite-backed UI store) that mediates the browser presentation tier and the Node-side domain packages (ADR-0019). Not published independently.",
@@ -29,24 +29,24 @@
29
29
  "node": ">=22"
30
30
  },
31
31
  "dependencies": {
32
- "@oscharko-dev/keiko-contracts": "0.2.9",
33
- "@oscharko-dev/keiko-security": "0.2.9",
34
- "@oscharko-dev/keiko-model-gateway": "0.2.9",
35
- "@oscharko-dev/keiko-quality-intelligence": "0.2.9",
36
- "@oscharko-dev/keiko-local-knowledge": "0.2.9",
37
- "@oscharko-dev/keiko-workspace": "0.2.9",
38
- "@oscharko-dev/keiko-sandbox": "0.2.9",
39
- "@oscharko-dev/keiko-tools": "0.2.9",
40
- "@oscharko-dev/keiko-evidence": "0.2.9",
41
- "@oscharko-dev/keiko-verification": "0.2.9",
42
- "@oscharko-dev/keiko-harness": "0.2.9",
43
- "@oscharko-dev/keiko-sdk": "0.2.9",
44
- "@oscharko-dev/keiko-workflows": "0.2.9",
45
- "@oscharko-dev/keiko-memory-vault": "0.2.9",
46
- "@oscharko-dev/keiko-memory-governance": "0.2.9",
47
- "@oscharko-dev/keiko-memory-retrieval": "0.2.9",
48
- "@oscharko-dev/keiko-memory-capture": "0.2.9",
49
- "@oscharko-dev/keiko-memory-consolidation": "0.2.9",
32
+ "@oscharko-dev/keiko-contracts": "0.2.10",
33
+ "@oscharko-dev/keiko-security": "0.2.10",
34
+ "@oscharko-dev/keiko-model-gateway": "0.2.10",
35
+ "@oscharko-dev/keiko-quality-intelligence": "0.2.10",
36
+ "@oscharko-dev/keiko-local-knowledge": "0.2.10",
37
+ "@oscharko-dev/keiko-workspace": "0.2.10",
38
+ "@oscharko-dev/keiko-sandbox": "0.2.10",
39
+ "@oscharko-dev/keiko-tools": "0.2.10",
40
+ "@oscharko-dev/keiko-evidence": "0.2.10",
41
+ "@oscharko-dev/keiko-verification": "0.2.10",
42
+ "@oscharko-dev/keiko-harness": "0.2.10",
43
+ "@oscharko-dev/keiko-sdk": "0.2.10",
44
+ "@oscharko-dev/keiko-workflows": "0.2.10",
45
+ "@oscharko-dev/keiko-memory-vault": "0.2.10",
46
+ "@oscharko-dev/keiko-memory-governance": "0.2.10",
47
+ "@oscharko-dev/keiko-memory-retrieval": "0.2.10",
48
+ "@oscharko-dev/keiko-memory-capture": "0.2.10",
49
+ "@oscharko-dev/keiko-memory-consolidation": "0.2.10",
50
50
  "ws": "^8.21.0",
51
51
  "typescript": "^6.0.3"
52
52
  }