agent-recall-mcp 3.5.2 → 3.5.4

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 (219) hide show
  1. package/README.md +254 -143
  2. package/dist/build-server.d.ts +28 -0
  3. package/dist/build-server.d.ts.map +1 -0
  4. package/dist/build-server.js +55 -0
  5. package/dist/build-server.js.map +1 -0
  6. package/dist/http/activity.d.ts +60 -0
  7. package/dist/http/activity.d.ts.map +1 -0
  8. package/dist/http/activity.js +254 -0
  9. package/dist/http/activity.js.map +1 -0
  10. package/dist/http/alerts.d.ts +84 -0
  11. package/dist/http/alerts.d.ts.map +1 -0
  12. package/dist/http/alerts.js +213 -0
  13. package/dist/http/alerts.js.map +1 -0
  14. package/dist/http/cli.d.ts +3 -0
  15. package/dist/http/cli.d.ts.map +1 -0
  16. package/dist/http/cli.js +515 -0
  17. package/dist/http/cli.js.map +1 -0
  18. package/dist/http/export-tar.d.ts +23 -0
  19. package/dist/http/export-tar.d.ts.map +1 -0
  20. package/dist/http/export-tar.js +264 -0
  21. package/dist/http/export-tar.js.map +1 -0
  22. package/dist/http/federation.d.ts +45 -0
  23. package/dist/http/federation.d.ts.map +1 -0
  24. package/dist/http/federation.js +185 -0
  25. package/dist/http/federation.js.map +1 -0
  26. package/dist/http/film/film.css +80 -0
  27. package/dist/http/film/film.js +446 -0
  28. package/dist/http/film/human.jpg +0 -0
  29. package/dist/http/film/m0.jpg +0 -0
  30. package/dist/http/film/m2.jpg +0 -0
  31. package/dist/http/film/m3.jpg +0 -0
  32. package/dist/http/film/wrong.jpg +0 -0
  33. package/dist/http/film.d.ts +16 -0
  34. package/dist/http/film.d.ts.map +1 -0
  35. package/dist/http/film.js +119 -0
  36. package/dist/http/film.js.map +1 -0
  37. package/dist/http/home/cabinet.svg +1 -0
  38. package/dist/http/home/drawer-project.svg +1 -0
  39. package/dist/http/home/drawer-rules.svg +1 -0
  40. package/dist/http/home/drawer-you.svg +1 -0
  41. package/dist/http/home/fig1.svg +242 -0
  42. package/dist/http/home/fig2-1.svg +61 -0
  43. package/dist/http/home/fig2-2.svg +92 -0
  44. package/dist/http/home/fig3.svg +1 -0
  45. package/dist/http/home/home.css +509 -0
  46. package/dist/http/home/home.html +517 -0
  47. package/dist/http/home/icons.svg +15 -0
  48. package/dist/http/home.d.ts +23 -0
  49. package/dist/http/home.d.ts.map +1 -0
  50. package/dist/http/home.js +295 -0
  51. package/dist/http/home.js.map +1 -0
  52. package/dist/http/identities.d.ts +29 -0
  53. package/dist/http/identities.d.ts.map +1 -0
  54. package/dist/http/identities.js +91 -0
  55. package/dist/http/identities.js.map +1 -0
  56. package/dist/http/import-memory.d.ts +161 -0
  57. package/dist/http/import-memory.d.ts.map +1 -0
  58. package/dist/http/import-memory.js +718 -0
  59. package/dist/http/import-memory.js.map +1 -0
  60. package/dist/http/jsonfile.d.ts +6 -0
  61. package/dist/http/jsonfile.d.ts.map +1 -0
  62. package/dist/http/jsonfile.js +60 -0
  63. package/dist/http/jsonfile.js.map +1 -0
  64. package/dist/http/legal/PRIVACY.md +70 -0
  65. package/dist/http/legal.d.ts +10 -0
  66. package/dist/http/legal.d.ts.map +1 -0
  67. package/dist/http/legal.js +35 -0
  68. package/dist/http/legal.js.map +1 -0
  69. package/dist/http/limits.d.ts +59 -0
  70. package/dist/http/limits.d.ts.map +1 -0
  71. package/dist/http/limits.js +163 -0
  72. package/dist/http/limits.js.map +1 -0
  73. package/dist/http/markdown-lite.d.ts +2 -0
  74. package/dist/http/markdown-lite.d.ts.map +1 -0
  75. package/dist/http/markdown-lite.js +86 -0
  76. package/dist/http/markdown-lite.js.map +1 -0
  77. package/dist/http/multipart.d.ts +43 -0
  78. package/dist/http/multipart.d.ts.map +1 -0
  79. package/dist/http/multipart.js +152 -0
  80. package/dist/http/multipart.js.map +1 -0
  81. package/dist/http/oauth-app.d.ts +75 -0
  82. package/dist/http/oauth-app.d.ts.map +1 -0
  83. package/dist/http/oauth-app.js +259 -0
  84. package/dist/http/oauth-app.js.map +1 -0
  85. package/dist/http/oauth-config.d.ts +46 -0
  86. package/dist/http/oauth-config.d.ts.map +1 -0
  87. package/dist/http/oauth-config.js +122 -0
  88. package/dist/http/oauth-config.js.map +1 -0
  89. package/dist/http/oauth-pages.d.ts +40 -0
  90. package/dist/http/oauth-pages.d.ts.map +1 -0
  91. package/dist/http/oauth-pages.js +97 -0
  92. package/dist/http/oauth-pages.js.map +1 -0
  93. package/dist/http/oauth-provider.d.ts +124 -0
  94. package/dist/http/oauth-provider.d.ts.map +1 -0
  95. package/dist/http/oauth-provider.js +486 -0
  96. package/dist/http/oauth-provider.js.map +1 -0
  97. package/dist/http/oauth-store.d.ts +128 -0
  98. package/dist/http/oauth-store.d.ts.map +1 -0
  99. package/dist/http/oauth-store.js +317 -0
  100. package/dist/http/oauth-store.js.map +1 -0
  101. package/dist/http/redirect-policy.d.ts +16 -0
  102. package/dist/http/redirect-policy.d.ts.map +1 -0
  103. package/dist/http/redirect-policy.js +83 -0
  104. package/dist/http/redirect-policy.js.map +1 -0
  105. package/dist/http/review-pages.d.ts +39 -0
  106. package/dist/http/review-pages.d.ts.map +1 -0
  107. package/dist/http/review-pages.js +78 -0
  108. package/dist/http/review-pages.js.map +1 -0
  109. package/dist/http/review.d.ts +36 -0
  110. package/dist/http/review.d.ts.map +1 -0
  111. package/dist/http/review.js +220 -0
  112. package/dist/http/review.js.map +1 -0
  113. package/dist/http/serve.d.ts +58 -0
  114. package/dist/http/serve.d.ts.map +1 -0
  115. package/dist/http/serve.js +324 -0
  116. package/dist/http/serve.js.map +1 -0
  117. package/dist/http/site-pages.d.ts +110 -0
  118. package/dist/http/site-pages.d.ts.map +1 -0
  119. package/dist/http/site-pages.js +630 -0
  120. package/dist/http/site-pages.js.map +1 -0
  121. package/dist/http/site-theme.d.ts +13 -0
  122. package/dist/http/site-theme.d.ts.map +1 -0
  123. package/dist/http/site-theme.js +22 -0
  124. package/dist/http/site-theme.js.map +1 -0
  125. package/dist/http/site.d.ts +52 -0
  126. package/dist/http/site.d.ts.map +1 -0
  127. package/dist/http/site.js +353 -0
  128. package/dist/http/site.js.map +1 -0
  129. package/dist/http/stats.d.ts +139 -0
  130. package/dist/http/stats.d.ts.map +1 -0
  131. package/dist/http/stats.js +599 -0
  132. package/dist/http/stats.js.map +1 -0
  133. package/dist/http/tar-import.d.ts +69 -0
  134. package/dist/http/tar-import.d.ts.map +1 -0
  135. package/dist/http/tar-import.js +234 -0
  136. package/dist/http/tar-import.js.map +1 -0
  137. package/dist/http/tenant-paths.d.ts +14 -0
  138. package/dist/http/tenant-paths.d.ts.map +1 -0
  139. package/dist/http/tenant-paths.js +42 -0
  140. package/dist/http/tenant-paths.js.map +1 -0
  141. package/dist/http/tokens.d.ts +32 -0
  142. package/dist/http/tokens.d.ts.map +1 -0
  143. package/dist/http/tokens.js +137 -0
  144. package/dist/http/tokens.js.map +1 -0
  145. package/dist/http/trial.d.ts +55 -0
  146. package/dist/http/trial.d.ts.map +1 -0
  147. package/dist/http/trial.js +218 -0
  148. package/dist/http/trial.js.map +1 -0
  149. package/dist/http/web-session.d.ts +108 -0
  150. package/dist/http/web-session.d.ts.map +1 -0
  151. package/dist/http/web-session.js +267 -0
  152. package/dist/http/web-session.js.map +1 -0
  153. package/dist/index.js +12 -65
  154. package/dist/index.js.map +1 -1
  155. package/dist/lib/ambient-capture.d.ts.map +1 -1
  156. package/dist/lib/ambient-capture.js +4 -1
  157. package/dist/lib/ambient-capture.js.map +1 -1
  158. package/dist/lib/bookkeeping.d.ts +26 -0
  159. package/dist/lib/bookkeeping.d.ts.map +1 -0
  160. package/dist/lib/bookkeeping.js +31 -0
  161. package/dist/lib/bookkeeping.js.map +1 -0
  162. package/dist/lib/hosted-redact.d.ts +17 -0
  163. package/dist/lib/hosted-redact.d.ts.map +1 -0
  164. package/dist/lib/hosted-redact.js +57 -0
  165. package/dist/lib/hosted-redact.js.map +1 -0
  166. package/dist/lib/lifecycle-exit.d.ts +5 -13
  167. package/dist/lib/lifecycle-exit.d.ts.map +1 -1
  168. package/dist/lib/lifecycle-exit.js +38 -16
  169. package/dist/lib/lifecycle-exit.js.map +1 -1
  170. package/dist/server.d.ts +3 -2
  171. package/dist/server.d.ts.map +1 -1
  172. package/dist/server.js +6 -3
  173. package/dist/server.js.map +1 -1
  174. package/dist/tools/annotations.d.ts +65 -0
  175. package/dist/tools/annotations.d.ts.map +1 -0
  176. package/dist/tools/annotations.js +4 -0
  177. package/dist/tools/annotations.js.map +1 -0
  178. package/dist/tools/check-action.d.ts.map +1 -1
  179. package/dist/tools/check-action.js +2 -0
  180. package/dist/tools/check-action.js.map +1 -1
  181. package/dist/tools/check.d.ts.map +1 -1
  182. package/dist/tools/check.js +6 -2
  183. package/dist/tools/check.js.map +1 -1
  184. package/dist/tools/digest.d.ts.map +1 -1
  185. package/dist/tools/digest.js +2 -0
  186. package/dist/tools/digest.js.map +1 -1
  187. package/dist/tools/pipeline-close.d.ts.map +1 -1
  188. package/dist/tools/pipeline-close.js +2 -0
  189. package/dist/tools/pipeline-close.js.map +1 -1
  190. package/dist/tools/pipeline-current.d.ts.map +1 -1
  191. package/dist/tools/pipeline-current.js +2 -0
  192. package/dist/tools/pipeline-current.js.map +1 -1
  193. package/dist/tools/pipeline-list.d.ts.map +1 -1
  194. package/dist/tools/pipeline-list.js +2 -0
  195. package/dist/tools/pipeline-list.js.map +1 -1
  196. package/dist/tools/pipeline-open.d.ts.map +1 -1
  197. package/dist/tools/pipeline-open.js +2 -0
  198. package/dist/tools/pipeline-open.js.map +1 -1
  199. package/dist/tools/pipeline-show.d.ts.map +1 -1
  200. package/dist/tools/pipeline-show.js +2 -0
  201. package/dist/tools/pipeline-show.js.map +1 -1
  202. package/dist/tools/recall.d.ts.map +1 -1
  203. package/dist/tools/recall.js +4 -1
  204. package/dist/tools/recall.js.map +1 -1
  205. package/dist/tools/register-rule.d.ts.map +1 -1
  206. package/dist/tools/register-rule.js +2 -0
  207. package/dist/tools/register-rule.js.map +1 -1
  208. package/dist/tools/remember.d.ts.map +1 -1
  209. package/dist/tools/remember.js +10 -1
  210. package/dist/tools/remember.js.map +1 -1
  211. package/dist/tools/session-end.d.ts +15 -0
  212. package/dist/tools/session-end.d.ts.map +1 -1
  213. package/dist/tools/session-end.js +13 -1
  214. package/dist/tools/session-end.js.map +1 -1
  215. package/dist/tools/session-start.d.ts +6 -1
  216. package/dist/tools/session-start.d.ts.map +1 -1
  217. package/dist/tools/session-start.js +24 -212
  218. package/dist/tools/session-start.js.map +1 -1
  219. package/package.json +11 -8
@@ -0,0 +1,264 @@
1
+ /**
2
+ * export-tar.ts — "Download my memory": stream one tenant directory as a .tar.
3
+ *
4
+ * Containment, because the directory holds data an agent wrote:
5
+ * - only REGULAR files (a symlink, socket, device or fifo is skipped, never followed);
6
+ * - before a directory is entered it is lstat-ed (must still be a real directory) and
7
+ * its realpath must still lie inside the realpath of the tenant root; each file is
8
+ * opened with O_NOFOLLOW (final component only), re-checked with fstat on the open
9
+ * descriptor, and its realpath is checked against the root again after the open, so
10
+ * a directory or file swapped for a link between the listing and the read is
11
+ * skipped. A swap in the instant between a check and the next system call cannot be
12
+ * ruled out by any path-based API; on Linux (production) the tenant tree is only
13
+ * written by this server, and O_NOFOLLOW is a Linux/POSIX guarantee. On Windows the
14
+ * checks are best-effort;
15
+ * - the archive paths are built from entry names under the tenant root only, never
16
+ * from the contents of a file, and a name containing a control character or
17
+ * backslash, or longer than ustar can hold, is skipped (and counted);
18
+ * - memory use is one 64 KiB chunk: nothing is buffered whole, whatever the size.
19
+ *
20
+ * A client that disconnects, errors or stops reading ends the export: the wait for
21
+ * `drain` also settles on 'close', 'error' and an idle timeout, its listeners are
22
+ * removed, and every file handle is closed on every exit path (try/finally).
23
+ * The size written in each header is the size at open time; a file that grows while
24
+ * being read is cut at that size, one that shrinks is zero-padded, so the archive is
25
+ * always well formed.
26
+ */
27
+ import * as fs from "node:fs";
28
+ import * as path from "node:path";
29
+ const BLOCK = 512;
30
+ const CHUNK = 64 * 1024;
31
+ const MAX_ENTRIES = 200_000;
32
+ /** ustar's 11 octal digits. */
33
+ const MAX_FILE = 8 * 1024 ** 3 - 1;
34
+ const NOFOLLOW = fs.constants.O_NOFOLLOW ?? 0;
35
+ /** How long one write may wait for the client to read before the export is abandoned. */
36
+ export const DEFAULT_IDLE_MS = 60_000;
37
+ /** The export ended early because the client is gone or stalled; never a data problem. */
38
+ export class TarAbort extends Error {
39
+ }
40
+ const octal = (n, width) => n.toString(8).padStart(width - 1, "0") + "\0";
41
+ /** Splits a path into ustar (prefix, name), or null when it cannot fit. */
42
+ function splitName(p) {
43
+ const b = Buffer.byteLength(p);
44
+ if (b <= 100)
45
+ return { prefix: "", name: p };
46
+ if (b > 255)
47
+ return null;
48
+ for (let i = p.lastIndexOf("/"); i > 0; i = p.lastIndexOf("/", i - 1)) {
49
+ const prefix = p.slice(0, i);
50
+ const name = p.slice(i + 1);
51
+ if (Buffer.byteLength(prefix) <= 155 && Buffer.byteLength(name) <= 100 && name.length > 0)
52
+ return { prefix, name };
53
+ }
54
+ return null;
55
+ }
56
+ function header(p, size, mtimeSec, type) {
57
+ const parts = splitName(p);
58
+ if (!parts)
59
+ return null;
60
+ const h = Buffer.alloc(BLOCK, 0);
61
+ h.write(parts.name, 0, "utf8");
62
+ h.write(octal(type === "5" ? 0o755 : 0o644, 8), 100, "ascii");
63
+ h.write(octal(0, 8), 108, "ascii");
64
+ h.write(octal(0, 8), 116, "ascii");
65
+ h.write(octal(size, 12), 124, "ascii");
66
+ h.write(octal(Math.max(0, Math.floor(mtimeSec)), 12), 136, "ascii");
67
+ h.write(" ", 148, "ascii"); // checksum field counts as spaces while summing
68
+ h.write(type, 156, "ascii");
69
+ h.write("ustar\0" + "00", 257, "ascii");
70
+ h.write(parts.prefix, 345, "utf8");
71
+ let sum = 0;
72
+ for (const byte of h)
73
+ sum += byte;
74
+ h.write(sum.toString(8).padStart(6, "0") + "\0 ", 148, "ascii");
75
+ return h;
76
+ }
77
+ /** Writes `buf`; when the stream is full, waits for 'drain' but also settles on 'close', 'error' and the idle timeout. */
78
+ async function put(out, buf, idleMs) {
79
+ if (out.destroyed || out.writableEnded)
80
+ throw new TarAbort("client went away");
81
+ if (out.write(buf))
82
+ return;
83
+ await new Promise((resolve, reject) => {
84
+ const timer = setTimeout(() => finish(new TarAbort("client stalled")), idleMs);
85
+ const onDrain = () => finish();
86
+ const onClose = () => finish(new TarAbort("client went away"));
87
+ const onError = () => finish(new TarAbort("client went away"));
88
+ function finish(err) {
89
+ clearTimeout(timer);
90
+ out.off("drain", onDrain);
91
+ out.off("close", onClose);
92
+ out.off("error", onError);
93
+ if (err)
94
+ reject(err);
95
+ else
96
+ resolve();
97
+ }
98
+ out.on("drain", onDrain);
99
+ out.once("close", onClose);
100
+ out.once("error", onError);
101
+ // Closed between the failed write and the listeners being attached.
102
+ if (out.destroyed)
103
+ onClose();
104
+ });
105
+ }
106
+ const SAFE_NAME = (n) =>
107
+ // eslint-disable-next-line no-control-regex
108
+ n.length > 0 && n !== "." && n !== ".." && !/[\u0000-\u001f\u007f\\/]/.test(n);
109
+ /** Streams `root` as `<top>/…` into `out` and writes the end-of-archive marker. Does not end `out`. Rejects with TarAbort if the client goes away or stalls. */
110
+ export async function streamTenantTar(root, top, out, opts = {}) {
111
+ const idleMs = opts.idleMs ?? DEFAULT_IDLE_MS;
112
+ const hooks = opts.hooks;
113
+ const stats = { files: 0, bytes: 0, skipped: 0 };
114
+ let entries = 0;
115
+ const buf = Buffer.allocUnsafe(CHUNK);
116
+ const send = (b) => put(out, b, idleMs);
117
+ // A root that is missing, or is a link instead of a real directory, exports as an empty archive.
118
+ let rootReal = null;
119
+ try {
120
+ if ((await fs.promises.lstat(root)).isDirectory())
121
+ rootReal = await fs.promises.realpath(root);
122
+ }
123
+ catch { /* no memory yet */ }
124
+ const inside = (real) => rootReal !== null && (real === rootReal || real.startsWith(rootReal + path.sep));
125
+ const stillInside = async (abs) => {
126
+ try {
127
+ return inside(await fs.promises.realpath(abs));
128
+ }
129
+ catch {
130
+ return false;
131
+ }
132
+ };
133
+ async function dir(abs, rel) {
134
+ // Re-check at the moment of entering: still a real directory (not a link now), and still inside the tenant root.
135
+ try {
136
+ if (!(await fs.promises.lstat(abs)).isDirectory() || !(await stillInside(abs))) {
137
+ stats.skipped++;
138
+ return;
139
+ }
140
+ }
141
+ catch {
142
+ stats.skipped++;
143
+ return;
144
+ }
145
+ let list;
146
+ try {
147
+ list = await fs.promises.readdir(abs, { withFileTypes: true });
148
+ }
149
+ catch {
150
+ stats.skipped++;
151
+ return;
152
+ }
153
+ // The listing itself must have come from inside the root too (a swap during readdir).
154
+ if (!(await stillInside(abs))) {
155
+ stats.skipped++;
156
+ return;
157
+ }
158
+ list.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
159
+ for (const e of list) {
160
+ if (out.destroyed)
161
+ throw new TarAbort("client went away");
162
+ if (++entries > MAX_ENTRIES) {
163
+ stats.skipped++;
164
+ return;
165
+ }
166
+ if (!SAFE_NAME(e.name)) {
167
+ stats.skipped++;
168
+ continue;
169
+ }
170
+ const childAbs = path.join(abs, e.name);
171
+ const childRel = `${rel}/${e.name}`;
172
+ if (e.isSymbolicLink()) {
173
+ stats.skipped++;
174
+ continue;
175
+ }
176
+ if (e.isDirectory()) {
177
+ await hooks?.beforeDir?.(childAbs);
178
+ // dir() re-checks lstat and realpath before listing; the entry header follows only a directory that passed.
179
+ let ok = false;
180
+ try {
181
+ ok = (await fs.promises.lstat(childAbs)).isDirectory() && (await stillInside(childAbs));
182
+ }
183
+ catch { /* gone */ }
184
+ if (!ok) {
185
+ stats.skipped++;
186
+ continue;
187
+ }
188
+ const h = header(childRel + "/", 0, Date.now() / 1000, "5");
189
+ if (!h) {
190
+ stats.skipped++;
191
+ continue;
192
+ }
193
+ await send(h);
194
+ await dir(childAbs, childRel);
195
+ continue;
196
+ }
197
+ if (!e.isFile()) {
198
+ stats.skipped++;
199
+ continue;
200
+ }
201
+ await hooks?.beforeFile?.(childAbs);
202
+ await file(childAbs, childRel);
203
+ }
204
+ }
205
+ async function file(abs, rel) {
206
+ let fh;
207
+ try {
208
+ fh = await fs.promises.open(abs, fs.constants.O_RDONLY | NOFOLLOW);
209
+ const st = await fh.stat();
210
+ // Opened through a swapped parent directory? Then the real path is no longer under the tenant root.
211
+ if (!st.isFile() || st.size > MAX_FILE || !(await stillInside(abs))) {
212
+ stats.skipped++;
213
+ return;
214
+ }
215
+ const h = header(rel, st.size, st.mtimeMs / 1000, "0");
216
+ if (!h) {
217
+ stats.skipped++;
218
+ return;
219
+ }
220
+ await send(h);
221
+ let left = st.size;
222
+ while (left > 0) {
223
+ let bytesRead = 0;
224
+ try {
225
+ ({ bytesRead } = await fh.read(buf, 0, Math.min(CHUNK, left), null));
226
+ }
227
+ catch {
228
+ break;
229
+ } // read error: zero-pad below
230
+ if (bytesRead === 0)
231
+ break;
232
+ await send(Buffer.from(buf.subarray(0, bytesRead)));
233
+ left -= bytesRead;
234
+ }
235
+ while (left > 0) { // shrank or unreadable mid-file: pad so the archive stays well formed
236
+ const n = Math.min(CHUNK, left);
237
+ await send(Buffer.alloc(n));
238
+ left -= n;
239
+ }
240
+ const pad = (BLOCK - (st.size % BLOCK)) % BLOCK;
241
+ if (pad)
242
+ await send(Buffer.alloc(pad));
243
+ stats.files++;
244
+ stats.bytes += st.size;
245
+ }
246
+ catch (err) {
247
+ if (err instanceof TarAbort)
248
+ throw err;
249
+ // ELOOP (a symlink swapped in), ENOENT (deleted meanwhile), EACCES: not part of the export.
250
+ stats.skipped++;
251
+ }
252
+ finally {
253
+ await fh?.close().catch(() => undefined);
254
+ }
255
+ }
256
+ const top0 = header(top + "/", 0, Date.now() / 1000, "5");
257
+ if (top0)
258
+ await send(top0);
259
+ if (rootReal !== null)
260
+ await dir(root, top);
261
+ await send(Buffer.alloc(BLOCK * 2));
262
+ return stats;
263
+ }
264
+ //# sourceMappingURL=export-tar.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export-tar.js","sourceRoot":"","sources":["../../src/http/export-tar.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import { type OAuthConfig, type ProviderName } from "./oauth-config.js";
2
+ export interface ProviderUrls {
3
+ githubAuthorize: string;
4
+ githubToken: string;
5
+ githubApi: string;
6
+ googleAuthorize: string;
7
+ googleToken: string;
8
+ }
9
+ export declare const DEFAULT_PROVIDER_URLS: ProviderUrls;
10
+ export declare const PROVIDER_LABEL: Record<ProviderName, string>;
11
+ export declare class FederationError extends Error {
12
+ kind: "unavailable" | "rejected";
13
+ reason: string;
14
+ constructor(kind: "unavailable" | "rejected", reason: string);
15
+ }
16
+ /** Test-only overrides must still be https (or http on localhost): same rule as AR_PUBLIC_URL, applied to the origin. */
17
+ export declare function validateProviderUrls(urls: ProviderUrls): ProviderUrls;
18
+ /** Origins the sign-in page must allow in `form-action` (browsers apply it to the redirect after the form POST). */
19
+ export declare function formActionOrigins(urls: ProviderUrls, providers: readonly ProviderName[]): string[];
20
+ export declare const b64url: (b: Buffer) => string;
21
+ export declare function newPkce(): {
22
+ verifier: string;
23
+ challenge: string;
24
+ };
25
+ export declare class Federation {
26
+ private readonly config;
27
+ private readonly fetchImpl;
28
+ private readonly now;
29
+ private readonly timeoutMs;
30
+ readonly urls: ProviderUrls;
31
+ constructor(config: OAuthConfig, urls?: ProviderUrls, fetchImpl?: typeof fetch, now?: () => number, timeoutMs?: number);
32
+ enabledProviders(): ProviderName[];
33
+ redirectUri(provider: ProviderName): string;
34
+ authorizeUrl(provider: ProviderName, p: {
35
+ state: string;
36
+ challenge: string;
37
+ nonce: string;
38
+ }): string;
39
+ private call;
40
+ /** Trade the provider's code for a verified subject id. */
41
+ identify(provider: ProviderName, code: string, verifier: string, nonce: string): Promise<string>;
42
+ private identifyGithub;
43
+ private identifyGoogle;
44
+ }
45
+ //# sourceMappingURL=federation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../src/http/federation.ts"],"names":[],"mappings":"AAcA,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErF,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAMnC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAA0C,CAAC;AAOnG,qBAAa,eAAgB,SAAQ,KAAK;IACrB,IAAI,EAAE,aAAa,GAAG,UAAU;IAAS,MAAM,EAAE,MAAM;gBAAvD,IAAI,EAAE,aAAa,GAAG,UAAU,EAAS,MAAM,EAAE,MAAM;CAG3E;AAED,yHAAyH;AACzH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAGrE;AAED,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAIlG;AAED,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAiC,CAAC;AAErE,wBAAgB,OAAO,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAGjE;AAED,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAGT,MAAM,EAAE,WAAW,EACpC,IAAI,GAAE,YAAoC,EACzB,SAAS,GAAE,OAAO,KAAa,EAC/B,GAAG,GAAE,MAAM,MAAiB,EAC5B,SAAS,GAAE,MAAmB;IAKjD,gBAAgB,IAAI,YAAY,EAAE;IAIlC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAI3C,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;YAkBtF,IAAI;IAmBlB,2DAA2D;IACrD,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAYxF,cAAc;YAkBd,cAAc;CA4B7B"}
@@ -0,0 +1,185 @@
1
+ /**
2
+ * federation.ts — talks to GitHub / Google so users can sign in without AgentRecall
3
+ * ever handling a password. Authorization-code flow with PKCE (S256) toward the
4
+ * provider; we only learn a stable numeric subject:
5
+ *
6
+ * github → GET /user `id`
7
+ * google → OIDC id_token `sub`
8
+ *
9
+ * Every upstream call: 10 s timeout, redirects refused, response size capped.
10
+ * FederationError messages never contain codes, tokens, secrets or response bodies.
11
+ * kind "unavailable": network / timeout / 5xx / 429 / non-JSON (user may retry)
12
+ * kind "rejected": the provider or its answer did not check out (generic failure)
13
+ */
14
+ import { createHash, randomBytes } from "node:crypto";
15
+ import { parseOrigin } from "./oauth-config.js";
16
+ export const DEFAULT_PROVIDER_URLS = {
17
+ githubAuthorize: "https://github.com/login/oauth/authorize",
18
+ githubToken: "https://github.com/login/oauth/access_token",
19
+ githubApi: "https://api.github.com/user",
20
+ googleAuthorize: "https://accounts.google.com/o/oauth2/v2/auth",
21
+ googleToken: "https://oauth2.googleapis.com/token",
22
+ };
23
+ export const PROVIDER_LABEL = { github: "GitHub", google: "Google" };
24
+ const TIMEOUT_MS = 10_000;
25
+ const MAX_RESPONSE_CHARS = 256 * 1024;
26
+ const SUBJECT_RE = { github: /^[1-9]\d{0,15}$/, google: /^\d{1,30}$/ };
27
+ const GOOGLE_ISSUERS = new Set(["accounts.google.com", "https://accounts.google.com"]);
28
+ export class FederationError extends Error {
29
+ kind;
30
+ reason;
31
+ constructor(kind, reason) {
32
+ super(`federation ${kind}: ${reason}`);
33
+ this.kind = kind;
34
+ this.reason = reason;
35
+ }
36
+ }
37
+ /** Test-only overrides must still be https (or http on localhost): same rule as AR_PUBLIC_URL, applied to the origin. */
38
+ export function validateProviderUrls(urls) {
39
+ for (const [k, v] of Object.entries(urls))
40
+ parseOrigin(`provider url ${k}`, new URL(v).origin + "/");
41
+ return urls;
42
+ }
43
+ /** Origins the sign-in page must allow in `form-action` (browsers apply it to the redirect after the form POST). */
44
+ export function formActionOrigins(urls, providers) {
45
+ const set = new Set();
46
+ for (const p of providers)
47
+ set.add(new URL(p === "github" ? urls.githubAuthorize : urls.googleAuthorize).origin);
48
+ return [...set];
49
+ }
50
+ export const b64url = (b) => b.toString("base64url");
51
+ export function newPkce() {
52
+ const verifier = b64url(randomBytes(32));
53
+ return { verifier, challenge: b64url(createHash("sha256").update(verifier).digest()) };
54
+ }
55
+ export class Federation {
56
+ config;
57
+ fetchImpl;
58
+ now;
59
+ timeoutMs;
60
+ urls;
61
+ constructor(config, urls = DEFAULT_PROVIDER_URLS, fetchImpl = fetch, now = Date.now, timeoutMs = TIMEOUT_MS) {
62
+ this.config = config;
63
+ this.fetchImpl = fetchImpl;
64
+ this.now = now;
65
+ this.timeoutMs = timeoutMs;
66
+ this.urls = validateProviderUrls(urls);
67
+ }
68
+ enabledProviders() {
69
+ return ["github", "google"].filter((p) => this.config.providers[p] !== undefined);
70
+ }
71
+ redirectUri(provider) {
72
+ return new URL(`/authorize/callback/${provider}`, this.config.publicUrl).href;
73
+ }
74
+ authorizeUrl(provider, p) {
75
+ const creds = this.config.providers[provider];
76
+ if (!creds)
77
+ throw new FederationError("rejected", "provider not configured");
78
+ const u = new URL(provider === "github" ? this.urls.githubAuthorize : this.urls.googleAuthorize);
79
+ u.searchParams.set("client_id", creds.clientId);
80
+ u.searchParams.set("redirect_uri", this.redirectUri(provider));
81
+ u.searchParams.set("state", p.state);
82
+ u.searchParams.set("code_challenge", p.challenge);
83
+ u.searchParams.set("code_challenge_method", "S256");
84
+ if (provider === "google") {
85
+ u.searchParams.set("response_type", "code");
86
+ u.searchParams.set("scope", "openid");
87
+ u.searchParams.set("nonce", p.nonce);
88
+ u.searchParams.set("prompt", "select_account");
89
+ }
90
+ return u.href;
91
+ }
92
+ async call(url, init) {
93
+ let res;
94
+ let text;
95
+ try {
96
+ res = await this.fetchImpl(url, { ...init, redirect: "error", signal: AbortSignal.timeout(this.timeoutMs) });
97
+ text = await res.text();
98
+ }
99
+ catch (err) {
100
+ const name = err?.name;
101
+ throw new FederationError("unavailable", name === "TimeoutError" || name === "AbortError" ? "timeout" : "network");
102
+ }
103
+ if (res.status >= 500 || res.status === 429)
104
+ throw new FederationError("unavailable", `http ${res.status}`);
105
+ if (text.length > MAX_RESPONSE_CHARS)
106
+ throw new FederationError("unavailable", "response too large");
107
+ try {
108
+ return { status: res.status, json: JSON.parse(text) };
109
+ }
110
+ catch {
111
+ throw new FederationError("unavailable", "non-json response");
112
+ }
113
+ }
114
+ /** Trade the provider's code for a verified subject id. */
115
+ async identify(provider, code, verifier, nonce) {
116
+ const creds = this.config.providers[provider];
117
+ if (!creds)
118
+ throw new FederationError("rejected", "provider not configured");
119
+ const body = new URLSearchParams({
120
+ client_id: creds.clientId, client_secret: creds.clientSecret, code,
121
+ redirect_uri: this.redirectUri(provider), code_verifier: verifier,
122
+ });
123
+ if (provider === "github")
124
+ return this.identifyGithub(body);
125
+ body.set("grant_type", "authorization_code");
126
+ return this.identifyGoogle(body, creds.clientId, nonce);
127
+ }
128
+ async identifyGithub(body) {
129
+ const tok = await this.call(this.urls.githubToken, {
130
+ method: "POST", body: body.toString(),
131
+ headers: { Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded", "User-Agent": "agent-recall-server" },
132
+ });
133
+ const accessToken = tok.json?.access_token;
134
+ if (tok.status !== 200 || typeof accessToken !== "string" || accessToken.length === 0)
135
+ throw new FederationError("rejected", "github token exchange");
136
+ const user = await this.call(this.urls.githubApi, {
137
+ method: "GET",
138
+ headers: { Authorization: `Bearer ${accessToken}`, Accept: "application/vnd.github+json", "User-Agent": "agent-recall-server" },
139
+ });
140
+ const id = user.json?.id;
141
+ if (user.status !== 200 || typeof id !== "number" || !Number.isSafeInteger(id) || !SUBJECT_RE.github.test(String(id))) {
142
+ throw new FederationError("rejected", "github user id");
143
+ }
144
+ return String(id);
145
+ }
146
+ async identifyGoogle(body, clientId, nonce) {
147
+ const tok = await this.call(this.urls.googleToken, {
148
+ method: "POST", body: body.toString(),
149
+ headers: { Accept: "application/json", "Content-Type": "application/x-www-form-urlencoded" },
150
+ });
151
+ const idToken = tok.json?.id_token;
152
+ if (tok.status !== 200 || typeof idToken !== "string")
153
+ throw new FederationError("rejected", "google token exchange");
154
+ // The id_token comes straight from Google's token endpoint over TLS, so its signature need not be
155
+ // verified (OpenID Connect Core 3.1.3.7, step 6); we still check every claim that binds it to this request.
156
+ const parts = idToken.split(".");
157
+ let claims;
158
+ try {
159
+ claims = parts.length === 3 ? JSON.parse(Buffer.from(parts[1], "base64url").toString("utf-8")) : null;
160
+ }
161
+ catch {
162
+ claims = null;
163
+ }
164
+ if (claims === null || typeof claims !== "object")
165
+ throw new FederationError("rejected", "google id_token format");
166
+ // aud: our client id; an array form additionally needs azp === our client id (OIDC Core 3.1.3.7 steps 3-5).
167
+ const audOk = claims.aud === clientId || (Array.isArray(claims.aud) && claims.aud.includes(clientId) && claims.azp === clientId);
168
+ if (claims.azp !== undefined && claims.azp !== clientId)
169
+ throw new FederationError("rejected", "google azp");
170
+ if (typeof claims.iat !== "number" || claims.iat * 1000 > this.now() + 5 * 60 * 1000)
171
+ throw new FederationError("rejected", "google iat");
172
+ if (!GOOGLE_ISSUERS.has(claims.iss))
173
+ throw new FederationError("rejected", "google iss");
174
+ if (!audOk)
175
+ throw new FederationError("rejected", "google aud");
176
+ if (typeof claims.exp !== "number" || claims.exp * 1000 <= this.now())
177
+ throw new FederationError("rejected", "google exp");
178
+ if (typeof claims.nonce !== "string" || claims.nonce !== nonce)
179
+ throw new FederationError("rejected", "google nonce");
180
+ if (typeof claims.sub !== "string" || !SUBJECT_RE.google.test(claims.sub))
181
+ throw new FederationError("rejected", "google sub");
182
+ return claims.sub;
183
+ }
184
+ }
185
+ //# sourceMappingURL=federation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"federation.js","sourceRoot":"","sources":["../../src/http/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAuC,MAAM,mBAAmB,CAAC;AAUrF,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,eAAe,EAAE,0CAA0C;IAC3D,WAAW,EAAE,6CAA6C;IAC1D,SAAS,EAAE,6BAA6B;IACxC,eAAe,EAAE,8CAA8C;IAC/D,WAAW,EAAE,qCAAqC;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAiC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAEnG,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC;AACtC,MAAM,UAAU,GAAiC,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACrG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC,CAAC;AAEvF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACrB;IAAyC;IAA5D,YAAmB,IAAgC,EAAS,MAAc;QACxE,KAAK,CAAC,cAAc,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;QADtB,SAAI,GAAJ,IAAI,CAA4B;QAAS,WAAM,GAAN,MAAM,CAAQ;IAE1E,CAAC;CACF;AAED,yHAAyH;AACzH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,WAAW,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACrG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,iBAAiB,CAAC,IAAkB,EAAE,SAAkC;IACtF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;IACjH,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAErE,MAAM,UAAU,OAAO;IACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,MAAM,OAAO,UAAU;IAIF;IAEA;IACA;IACA;IAPV,IAAI,CAAe;IAE5B,YACmB,MAAmB,EACpC,OAAqB,qBAAqB,EACzB,YAA0B,KAAK,EAC/B,MAAoB,IAAI,CAAC,GAAG,EAC5B,YAAoB,UAAU;QAJ9B,WAAM,GAAN,MAAM,CAAa;QAEnB,cAAS,GAAT,SAAS,CAAsB;QAC/B,QAAG,GAAH,GAAG,CAAyB;QAC5B,cAAS,GAAT,SAAS,CAAqB;QAE/C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB;QACd,OAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/F,CAAC;IAED,WAAW,CAAC,QAAsB;QAChC,OAAO,IAAI,GAAG,CAAC,uBAAuB,QAAQ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;IAChF,CAAC;IAED,YAAY,CAAC,QAAsB,EAAE,CAAsD;QACzF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAC7E,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACjG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,IAAiB;QAC/C,IAAI,GAAa,CAAC;QAClB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC7G,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAAa,EAAE,IAAI,CAAC;YAClC,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5G,IAAI,IAAI,CAAC,MAAM,GAAG,kBAAkB;YAAE,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;QACrG,IAAI,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,QAAQ,CAAC,QAAsB,EAAE,IAAY,EAAE,QAAgB,EAAE,KAAa;QAClF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;YAC/B,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI;YAClE,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,QAAQ;SAClE,CAAC,CAAC;QACH,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAqB;QAChD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACjD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;YACrC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,mCAAmC,EAAE,YAAY,EAAE,qBAAqB,EAAE;SAClI,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC;QAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;QACtJ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAChD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,WAAW,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,YAAY,EAAE,qBAAqB,EAAE;SAChI,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACtH,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAqB,EAAE,QAAgB,EAAE,KAAa;QACjF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACjD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;YACrC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,mCAAmC,EAAE;SAC7F,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;QACnC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;QACtH,kGAAkG;QAClG,4GAA4G;QAC5G,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxG,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;QACnH,4GAA4G;QAC5G,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;QACjI,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,QAAQ;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC7G,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC1I,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACzF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAChE,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC3H,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACtH,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/H,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;CACF"}
@@ -0,0 +1,80 @@
1
+ /* Home page film. Without script (or before it runs) this is a plain, readable
2
+ dark page: the beats are stacked sections. The script adds .film to <html>,
3
+ which pins the canvas and turns the beats into scroll-driven captions. */
4
+ *{box-sizing:border-box}
5
+ :root{--gold:#F5C451}
6
+ html{-webkit-text-size-adjust:100%}
7
+ body{margin:0;background:#04060a;color:#eef1f6;font:17px/1.6 "Segoe UI",system-ui,-apple-system,Roboto,sans-serif}
8
+ a{color:inherit;text-underline-offset:3px}
9
+ :focus-visible{outline:3px solid #6fe3ff;outline-offset:3px;border-radius:4px}
10
+ .skip{position:absolute;left:-999px;top:8px;background:#fff;color:#04060a;padding:8px 14px;border-radius:8px;z-index:9}
11
+ .skip:focus{left:8px}
12
+ #stage{display:none}
13
+ .top{position:relative;z-index:4;display:flex;align-items:center;justify-content:space-between;gap:16px;flex-wrap:wrap;padding:20px 32px}
14
+ .brand{display:flex;align-items:center;gap:10px;font-weight:600;letter-spacing:.02em;text-decoration:none}
15
+ .mark{width:10px;height:10px;border-radius:50%;background:var(--gold);box-shadow:0 0 14px var(--gold)}
16
+ .top nav{display:flex;align-items:center;gap:12px;flex-wrap:wrap;font-size:15px}
17
+ .top nav a{text-decoration:none;color:#c9d3df}
18
+ .top nav a:hover{color:#fff}
19
+ .top nav a.btn{color:#04060a}
20
+ .top nav a.btn.alt{color:#eef1f6}
21
+ .top nav a.btn:hover{color:#04060a;filter:brightness(1.08)}
22
+ .top nav a.btn.alt:hover{color:#fff;border-color:#fff}
23
+ .meter,.hint{display:none}
24
+ .beat{max-width:760px;margin:0 auto;padding:44px 24px;text-align:center}
25
+ .kicker{font:12px/1 ui-monospace,Consolas,monospace;letter-spacing:.24em;text-transform:uppercase;color:var(--gold);margin:0 0 14px}
26
+ h1,h2{font-family:Georgia,"Times New Roman",serif;font-weight:500;line-height:1.1;margin:0 0 14px;letter-spacing:-.01em}
27
+ h1{font-size:clamp(36px,5.2vw,68px)}
28
+ h2{font-size:clamp(28px,3.8vw,50px)}
29
+ .beat p{font-size:clamp(15px,1.25vw,18px);line-height:1.55;color:#c9d3df;margin:0 auto;max-width:620px}
30
+ .beat .cta{margin-top:24px;display:flex;gap:14px;justify-content:center;flex-wrap:wrap}
31
+ .btn{display:inline-block;padding:14px 24px;border-radius:999px;font-weight:600;text-decoration:none;font-size:16px;background:var(--gold);color:#04060a}
32
+ .btn.sm{padding:8px 16px;font-size:14px}
33
+ .btn.alt{background:transparent;color:#eef1f6;border:1px solid rgba(255,255,255,.4)}
34
+ .beat .agentnote{font-size:14px;color:#8fa2b6;margin-top:18px}
35
+ .agentnote a{font-family:ui-monospace,Consolas,monospace;font-size:13px}
36
+
37
+ .after{position:relative;z-index:5;background:#070b12;border-top:1px solid #16202e}
38
+ .inner{max-width:1080px;margin:0 auto;padding:56px 24px 28px}
39
+ .doors{display:grid;grid-template-columns:1fr 1fr;gap:22px}
40
+ .door{background:#0c121c;border:1px solid #1e2a3b;border-radius:16px;padding:28px}
41
+ .door h2{font-size:28px;margin:0 0 10px}
42
+ .door p{color:#a9b8ca;margin:0 0 12px}
43
+ .door ul{margin:0 0 22px;padding-left:20px;color:#dbe3ee}
44
+ .door li{margin:4px 0}
45
+ .door.human{border-top:3px solid var(--gold)}
46
+ .door.machine{border-top:3px solid #6fe3ff}
47
+ .how{padding-top:48px}
48
+ .how h2{font-size:28px}
49
+ .steps{list-style:none;margin:18px 0 0;padding:0;display:grid;grid-template-columns:repeat(3,1fr);gap:18px;counter-reset:s}
50
+ .steps li{counter-increment:s;background:#0c121c;border:1px solid #1e2a3b;border-radius:14px;padding:20px}
51
+ .steps li:before{content:counter(s);display:block;font:600 13px/1 ui-monospace,Consolas,monospace;color:var(--gold);margin-bottom:10px}
52
+ .steps strong{display:block;margin-bottom:6px}
53
+ .steps span{color:#a9b8ca;font-size:15px}
54
+ .foot{display:flex;justify-content:space-between;gap:16px;flex-wrap:wrap;margin-top:48px;padding-top:20px;border-top:1px solid #16202e;font-size:14px;color:#8fa2b6}
55
+ .foot nav{display:flex;gap:18px}
56
+
57
+ .film #stage{display:block;position:fixed;inset:0;width:100vw;height:100vh;z-index:0}
58
+ .film.nogl #stage{background:radial-gradient(ellipse at 30% 40%,#4a3608 0,transparent 45%),radial-gradient(ellipse at 70% 40%,#083a44 0,transparent 45%),#04060a}
59
+ .film .top{position:fixed;top:0;left:0;right:0}
60
+ .film #track{position:relative;height:450vh}
61
+ .film .meter{display:flex;gap:22px;position:fixed;top:76px;right:32px;z-index:3;font:12px/1.4 ui-monospace,Consolas,monospace;letter-spacing:.14em;color:#a9bccf}
62
+ .film .hint{display:block;position:fixed;left:50%;bottom:22px;transform:translateX(-50%);z-index:3;font:11px/1 ui-monospace,Consolas,monospace;letter-spacing:.3em;text-transform:uppercase;color:#7f93a8;transition:opacity .4s ease}
63
+ .film .hint.off{opacity:0}
64
+ .skipfilm{display:none}
65
+ .film .skipfilm{display:block;position:fixed;right:32px;bottom:18px;z-index:3;font:11px/1 ui-monospace,Consolas,monospace;letter-spacing:.2em;text-transform:uppercase;color:#c9d3df;text-decoration:none;padding:8px 2px;border-bottom:1px solid rgba(245,196,81,.6)}
66
+ .film .skipfilm:hover{color:var(--gold)}
67
+ #doors{scroll-margin-top:72px}
68
+ /* Off-screen captions are transparent, not hidden: a screen reader still reads the whole story in order. */
69
+ .film .beat{position:fixed;left:50%;bottom:9vh;width:min(760px,88vw);max-width:none;margin:0;padding:0;transform:translate(-50%,16px);z-index:2;opacity:0;pointer-events:none;transition:opacity .45s ease,transform .45s ease;text-shadow:0 2px 26px rgba(0,0,0,.9)}
70
+ .film .beat.on{opacity:1;pointer-events:auto;transform:translate(-50%,0)}
71
+
72
+ @media (max-width:760px){
73
+ .doors,.steps{grid-template-columns:1fr}
74
+ .top{padding:16px}
75
+ .film .meter{right:16px;top:116px;gap:12px;font-size:10px}
76
+ .top nav{gap:8px}
77
+ .top nav a.btn.sm{padding:7px 12px;font-size:13px}
78
+ .film .skipfilm{right:16px;bottom:14px;font-size:10px}
79
+ }
80
+ @media (prefers-reduced-motion:reduce){.film .beat,.film .beat.on,.film .hint{transition:none}}