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,69 @@
1
+ /** A structural problem with the archive: the whole import is abandoned. */
2
+ export declare class TarError extends Error {
3
+ }
4
+ export declare const BLOCK = 512;
5
+ export type EntryKind = "file" | "dir" | "special";
6
+ export interface TarEntry {
7
+ /** The path exactly as stored (prefix + name), not yet validated. */
8
+ name: string;
9
+ kind: EntryKind;
10
+ size: number;
11
+ }
12
+ export interface TarHandlers {
13
+ /** Called per header. For a file, return true to receive its bytes through data()/fileEnd(); false skips them. */
14
+ entry(e: TarEntry): Promise<boolean> | boolean;
15
+ data(chunk: Buffer): Promise<void> | void;
16
+ fileEnd(): Promise<void> | void;
17
+ }
18
+ export interface TarReaderOptions {
19
+ maxEntries: number;
20
+ }
21
+ export declare class TarReader {
22
+ private readonly h;
23
+ private readonly opts;
24
+ private buf;
25
+ private st;
26
+ private left;
27
+ private deliver;
28
+ private entries;
29
+ constructor(h: TarHandlers, opts: TarReaderOptions);
30
+ write(chunk: Buffer): Promise<void>;
31
+ /** The stream is over: it must have ended with an end-of-archive marker. */
32
+ end(): void;
33
+ private afterBody;
34
+ private padFor;
35
+ private onHeader;
36
+ }
37
+ export type PathVerdict = {
38
+ ok: true;
39
+ rel: string;
40
+ segs: string[];
41
+ wrapper?: string; /** Loaded by agents as an always-follow instruction (see isRuleFile). */
42
+ rule?: boolean;
43
+ } | {
44
+ ok: false;
45
+ why: "path" | "type";
46
+ };
47
+ export declare const ROOT_FILES: readonly string[];
48
+ export declare const ALLOWED_EXTENSIONS: readonly string[];
49
+ /**
50
+ * Files an agent loads as standing instructions at session start. They only come in when the user
51
+ * ticks "also import always-follow rules":
52
+ * - projects/<slug>/corrections/** active corrections (p0 = HARD RULES) and the _pending staging area
53
+ * - projects/<slug>/palace/behavior-policies.json IF-THEN behaviour policies, loaded as rules
54
+ * - projects/<slug>/personal/** the corrections-derived behavioural profile
55
+ * - identity-card.md the owner identity card, loaded first at every session_start
56
+ */
57
+ export declare function isRuleFile(segs: readonly string[]): boolean;
58
+ /**
59
+ * Judges one archive path. `wrapper` is the top-level directory a download from this
60
+ * server has (`agentrecall-<id>/`): it is stripped when present, and every entry of one
61
+ * archive must agree on it.
62
+ * - `path`: unsafe or malformed (traversal, absolute, backslash, control character, too long/deep…);
63
+ * - `type`: a safe path that is not part of a memory (config.json, telemetry/, a dotfile, .bin…).
64
+ * `isDir`: a directory entry is judged by its path syntax and only needs to lie on the way to an allowed path.
65
+ */
66
+ export declare function classifyPath(raw: string, isDir: boolean, wrapper: string | undefined): PathVerdict & {
67
+ wrapperSeen?: string;
68
+ };
69
+ //# sourceMappingURL=tar-import.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-import.d.ts","sourceRoot":"","sources":["../../src/http/tar-import.ts"],"names":[],"mappings":"AAqBA,4EAA4E;AAC5E,qBAAa,QAAS,SAAQ,KAAK;CAAG;AAEtC,eAAO,MAAM,KAAK,MAAM,CAAC;AAEzB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,kHAAkH;IAClH,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAAG,UAAU,EAAE,MAAM,CAAA;CAAE;AAWxD,qBAAa,SAAS;IAOR,OAAO,CAAC,QAAQ,CAAC,CAAC;IAAe,OAAO,CAAC,QAAQ,CAAC,IAAI;IANlE,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAK;gBAES,CAAC,EAAE,WAAW,EAAmB,IAAI,EAAE,gBAAgB;IAE9E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BzC,4EAA4E;IAC5E,GAAG,IAAI,IAAI;IAIX,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,MAAM,CAAK;YAEL,QAAQ;CAwCvB;AAID,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,yEAAyE;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACrJ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAExC,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAGvC,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAuC,CAAC;AAUxF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI3D;AAQD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CA8B7H"}
@@ -0,0 +1,234 @@
1
+ /**
2
+ * tar-import.ts — the reading half of "Import memory": a STREAMING ustar reader and the
3
+ * rules that decide which archive entries may become part of a memory.
4
+ *
5
+ * The archive is hostile input. So:
6
+ * - only POSIX ustar (as export-tar.ts writes it, long names via the `prefix` field) is
7
+ * understood. pax ('x', 'g') and GNU ('L', 'K', 'S', …) extension entries, base-256
8
+ * sizes, old v7/GNU magic and any unknown type flag abort the import: guessing what
9
+ * such an entry means is how path-confusion bugs happen;
10
+ * - every header checksum is verified; a name must be valid UTF-8;
11
+ * - sizes are only a promise: the reader hands out exactly the bytes that arrive and
12
+ * fails if the stream ends before the promised bytes (or before an end marker);
13
+ * - memory use is one chunk plus a 512-byte header, whatever the archive says.
14
+ *
15
+ * `classifyPath` is the policy: relative, forward slashes, no empty/./.. segments, no
16
+ * control characters, no Windows-reserved names, bounded length and depth, then an
17
+ * allowlist of what a memory is (projects/<slug>/** and a fixed list of root files, with
18
+ * extensions .md .json .jsonl .txt). Everything else is skipped and counted.
19
+ */
20
+ import { PROJECT_RE } from "./tenant-paths.js";
21
+ /** A structural problem with the archive: the whole import is abandoned. */
22
+ export class TarError extends Error {
23
+ }
24
+ export const BLOCK = 512;
25
+ const decoder = new TextDecoder("utf-8", { fatal: true });
26
+ function cString(b) {
27
+ const z = b.indexOf(0);
28
+ return z < 0 ? b : b.subarray(0, z);
29
+ }
30
+ export class TarReader {
31
+ h;
32
+ opts;
33
+ buf = Buffer.alloc(0);
34
+ st = "header";
35
+ left = 0;
36
+ deliver = false;
37
+ entries = 0;
38
+ constructor(h, opts) {
39
+ this.h = h;
40
+ this.opts = opts;
41
+ }
42
+ async write(chunk) {
43
+ if (this.st === "end")
44
+ return; // anything after the end marker is ignored
45
+ this.buf = this.buf.length === 0 ? chunk : Buffer.concat([this.buf, chunk]);
46
+ for (;;) {
47
+ if (this.st === "end") {
48
+ this.buf = Buffer.alloc(0);
49
+ return;
50
+ }
51
+ if (this.st === "header") {
52
+ if (this.buf.length < BLOCK)
53
+ return;
54
+ const hdr = this.buf.subarray(0, BLOCK);
55
+ this.buf = this.buf.subarray(BLOCK);
56
+ await this.onHeader(hdr);
57
+ continue;
58
+ }
59
+ if (this.st === "body") {
60
+ if (this.left === 0) {
61
+ this.afterBody();
62
+ if (this.deliver) {
63
+ this.deliver = false;
64
+ await this.h.fileEnd();
65
+ }
66
+ continue;
67
+ }
68
+ if (this.buf.length === 0)
69
+ return;
70
+ const n = Math.min(this.left, this.buf.length);
71
+ const part = this.buf.subarray(0, n);
72
+ this.buf = this.buf.subarray(n);
73
+ this.left -= n;
74
+ if (this.deliver)
75
+ await this.h.data(part);
76
+ continue;
77
+ }
78
+ // pad
79
+ if (this.left === 0) {
80
+ this.st = "header";
81
+ continue;
82
+ }
83
+ if (this.buf.length === 0)
84
+ return;
85
+ const n = Math.min(this.left, this.buf.length);
86
+ this.buf = this.buf.subarray(n);
87
+ this.left -= n;
88
+ }
89
+ }
90
+ /** The stream is over: it must have ended with an end-of-archive marker. */
91
+ end() {
92
+ if (this.st !== "end")
93
+ throw new TarError("the archive ended early (no end-of-archive marker): it is cut off or damaged");
94
+ }
95
+ afterBody() {
96
+ // `left` is 0 here: skip the padding up to the next block boundary.
97
+ this.st = "pad";
98
+ this.left = this.padFor;
99
+ }
100
+ padFor = 0;
101
+ async onHeader(h) {
102
+ if (h.every((x) => x === 0)) {
103
+ this.st = "end";
104
+ return;
105
+ }
106
+ let sum = 0;
107
+ for (let i = 0; i < BLOCK; i++)
108
+ sum += i >= 148 && i < 156 ? 32 : h[i];
109
+ const chkTxt = cString(h.subarray(148, 156)).toString("ascii").trim();
110
+ if (!/^[0-7]{1,8}$/.test(chkTxt) || parseInt(chkTxt, 8) !== sum)
111
+ throw new TarError("bad header checksum: not a tar archive, or damaged");
112
+ if (h.subarray(257, 263).toString("latin1") !== "ustar\0" || h.subarray(263, 265).toString("latin1") !== "00") {
113
+ throw new TarError("unsupported tar format: pack with `tar --format=ustar` (see the command on the connect page)");
114
+ }
115
+ if (++this.entries > this.opts.maxEntries)
116
+ throw new TarError(`too many entries (more than ${this.opts.maxEntries})`);
117
+ const sizeField = h.subarray(124, 136);
118
+ if (sizeField[0] & 0x80)
119
+ throw new TarError("unsupported size encoding");
120
+ const sizeTxt = cString(sizeField).toString("ascii").trim();
121
+ if (!/^[0-7]{0,11}$/.test(sizeTxt))
122
+ throw new TarError("malformed size field");
123
+ const size = sizeTxt === "" ? 0 : parseInt(sizeTxt, 8);
124
+ let name;
125
+ try {
126
+ const n = decoder.decode(cString(h.subarray(0, 100)));
127
+ const p = decoder.decode(cString(h.subarray(345, 500)));
128
+ name = p ? `${p}/${n}` : n;
129
+ }
130
+ catch {
131
+ throw new TarError("an entry name is not valid UTF-8");
132
+ }
133
+ const t = String.fromCharCode(h[156]);
134
+ let kind;
135
+ if (t === "0" || t === "\0")
136
+ kind = "file";
137
+ else if (t === "5")
138
+ kind = "dir";
139
+ else if (t === "1" || t === "2" || t === "3" || t === "4" || t === "6")
140
+ kind = "special";
141
+ else
142
+ throw new TarError(`unsupported entry type '${/[\x21-\x7e]/.test(t) ? t : "?"}' (pax or GNU extension?): pack with \`tar --format=ustar\``);
143
+ if (kind !== "file" && size !== 0)
144
+ throw new TarError("a non-file entry claims data");
145
+ const want = await this.h.entry({ name, kind, size });
146
+ this.deliver = kind === "file" && want;
147
+ this.left = size;
148
+ this.padFor = (BLOCK - (size % BLOCK)) % BLOCK;
149
+ this.st = "body";
150
+ }
151
+ }
152
+ export const ROOT_FILES = [
153
+ "identity-card.md", "awareness.md", "awareness-state.json", "awareness-archive.json",
154
+ "insights-index.json", "feedback-log.json", "MANIFEST.md",
155
+ ];
156
+ export const ALLOWED_EXTENSIONS = [".md", ".json", ".jsonl", ".txt"];
157
+ const MAX_SEGMENT = 255;
158
+ const MAX_TOTAL = 512;
159
+ const MAX_DEPTH = 16;
160
+ const WRAPPER_RE = /^agentrecall-[A-Za-z0-9_-]{1,64}$/;
161
+ const RESERVED_RE = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])(\..*)?$/i;
162
+ // eslint-disable-next-line no-control-regex
163
+ const BAD_CHARS_RE = /[\u0000-\u001f\u007f\\<>:"|?*]/;
164
+ /**
165
+ * Files an agent loads as standing instructions at session start. They only come in when the user
166
+ * ticks "also import always-follow rules":
167
+ * - projects/<slug>/corrections/** active corrections (p0 = HARD RULES) and the _pending staging area
168
+ * - projects/<slug>/palace/behavior-policies.json IF-THEN behaviour policies, loaded as rules
169
+ * - projects/<slug>/personal/** the corrections-derived behavioural profile
170
+ * - identity-card.md the owner identity card, loaded first at every session_start
171
+ */
172
+ export function isRuleFile(segs) {
173
+ if (segs.length === 1)
174
+ return segs[0] === "identity-card.md";
175
+ if (segs[0] !== "projects")
176
+ return false;
177
+ return segs[2] === "corrections" || segs[2] === "personal" || (segs[2] === "palace" && segs.length === 4 && segs[3] === "behavior-policies.json");
178
+ }
179
+ /** Does a path segment stay safe on every common file system? */
180
+ function segmentOk(s) {
181
+ return s.length > 0 && s !== "." && s !== ".." && Buffer.byteLength(s) <= MAX_SEGMENT
182
+ && !BAD_CHARS_RE.test(s) && !/[. ]$/.test(s) && !RESERVED_RE.test(s);
183
+ }
184
+ /**
185
+ * Judges one archive path. `wrapper` is the top-level directory a download from this
186
+ * server has (`agentrecall-<id>/`): it is stripped when present, and every entry of one
187
+ * archive must agree on it.
188
+ * - `path`: unsafe or malformed (traversal, absolute, backslash, control character, too long/deep…);
189
+ * - `type`: a safe path that is not part of a memory (config.json, telemetry/, a dotfile, .bin…).
190
+ * `isDir`: a directory entry is judged by its path syntax and only needs to lie on the way to an allowed path.
191
+ */
192
+ export function classifyPath(raw, isDir, wrapper) {
193
+ let p = raw;
194
+ if (p.endsWith("/")) {
195
+ if (!isDir)
196
+ return { ok: false, why: "path" };
197
+ p = p.slice(0, -1);
198
+ }
199
+ if (p.length === 0 || Buffer.byteLength(p) > MAX_TOTAL || p.startsWith("/"))
200
+ return { ok: false, why: "path" };
201
+ let segs = p.split("/");
202
+ if (segs.length > MAX_DEPTH + 1 || !segs.every(segmentOk))
203
+ return { ok: false, why: "path" };
204
+ let w;
205
+ if (WRAPPER_RE.test(segs[0]) && (segs.length > 1 || isDir)) {
206
+ if (wrapper !== undefined && wrapper !== segs[0])
207
+ return { ok: false, why: "path" };
208
+ w = segs[0];
209
+ segs = segs.slice(1);
210
+ if (segs.length === 0)
211
+ return { ok: true, rel: "", segs: [], wrapper: w, wrapperSeen: w }; // the wrapper directory itself
212
+ }
213
+ else if (wrapper !== undefined) {
214
+ return { ok: false, why: "path" }; // some entries wrapped, some not
215
+ }
216
+ if (segs.length > MAX_DEPTH)
217
+ return { ok: false, why: "path" };
218
+ const rel = segs.join("/");
219
+ const out = (ok) => ok ? { ok: true, rel, segs, wrapper: w, wrapperSeen: w, rule: isRuleFile(segs) } : { ok: false, why: "type" };
220
+ if (segs.some((s) => s.startsWith(".")))
221
+ return out(false);
222
+ if (isDir)
223
+ return out(segs[0] === "projects" && (segs.length === 1 || PROJECT_RE.test(segs[1])) || segs.length === 0);
224
+ if (segs.length === 1)
225
+ return out(ROOT_FILES.includes(segs[0]));
226
+ if (segs[0] !== "projects" || segs.length < 3 || !PROJECT_RE.test(segs[1]))
227
+ return out(false);
228
+ if (segs[2] === "digest")
229
+ return out(false); // digests carry ids that are joined into paths when read: never imported
230
+ const leaf = segs[segs.length - 1];
231
+ const dot = leaf.lastIndexOf(".");
232
+ return out(dot > 0 && ALLOWED_EXTENSIONS.includes(leaf.slice(dot).toLowerCase()));
233
+ }
234
+ //# sourceMappingURL=tar-import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tar-import.js","sourceRoot":"","sources":["../../src/http/tar-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,OAAO,QAAS,SAAQ,KAAK;CAAG;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAC;AAsBzB,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1D,SAAS,OAAO,CAAC,CAAS;IACxB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,OAAO,SAAS;IAOS;IAAiC;IANtD,GAAG,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,EAAE,GAAO,QAAQ,CAAC;IAClB,IAAI,GAAG,CAAC,CAAC;IACT,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,CAAC,CAAC;IAEpB,YAA6B,CAAc,EAAmB,IAAsB;QAAvD,MAAC,GAAD,CAAC,CAAa;QAAmB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAExF,KAAK,CAAC,KAAK,CAAC,KAAa;QACvB,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK;YAAE,OAAO,CAAC,2CAA2C;QAC1E,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5E,SAAS,CAAC;YACR,IAAK,IAAI,CAAC,EAAS,KAAK,KAAK,EAAE,CAAC;gBAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACtE,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK;oBAAE,OAAO;gBACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACxC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACzB,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;wBAAC,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;oBAAC,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACxH,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;gBACf,IAAI,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1C,SAAS;YACX,CAAC;YACD,MAAM;YACN,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC;gBAAC,SAAS;YAAC,CAAC;YACtD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,GAAG;QACD,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK;YAAE,MAAM,IAAI,QAAQ,CAAC,8EAA8E,CAAC,CAAC;IAC5H,CAAC;IAEO,SAAS;QACf,oEAAoE;QACpE,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IACO,MAAM,GAAG,CAAC,CAAC;IAEX,KAAK,CAAC,QAAQ,CAAC,CAAS;QAC9B,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC;YAAC,OAAO;QAAC,CAAC;QACzD,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;YAAE,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG;YAAE,MAAM,IAAI,QAAQ,CAAC,oDAAoD,CAAC,CAAC;QAC1I,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9G,MAAM,IAAI,QAAQ,CAAC,8FAA8F,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,QAAQ,CAAC,+BAA+B,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QAEtH,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;YAAE,MAAM,IAAI,QAAQ,CAAC,2BAA2B,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,sBAAsB,CAAC,CAAC;QAC/E,MAAM,IAAI,GAAG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEvD,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YACxD,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAAC,kCAAkC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,IAAe,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,IAAI,GAAG,MAAM,CAAC;aACtC,IAAI,CAAC,KAAK,GAAG;YAAE,IAAI,GAAG,KAAK,CAAC;aAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG;YAAE,IAAI,GAAG,SAAS,CAAC;;YACpF,MAAM,IAAI,QAAQ,CAAC,2BAA2B,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,6DAA6D,CAAC,CAAC;QACjJ,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,8BAA8B,CAAC,CAAC;QAEtF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;QAC/C,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC;IACnB,CAAC;CACF;AAQD,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,wBAAwB;IACpF,qBAAqB,EAAE,mBAAmB,EAAE,aAAa;CAC1D,CAAC;AACF,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAExF,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,UAAU,GAAG,mCAAmC,CAAC;AACvD,MAAM,WAAW,GAAG,+CAA+C,CAAC;AACpE,4CAA4C;AAC5C,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,kBAAkB,CAAC;IAC7D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,wBAAwB,CAAC,CAAC;AACpJ,CAAC;AAED,iEAAiE;AACjE,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,WAAW;WAChF,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAc,EAAE,OAA2B;IACnF,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAC9C,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC/G,IAAI,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC7F,IAAI,CAAqB,CAAC;IAC1B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACpF,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,+BAA+B;IAC5H,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,iCAAiC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC,EAAW,EAA0C,EAAE,CAClE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAChH,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IACtH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9F,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,yEAAyE;IACtH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACpF,CAAC"}
@@ -0,0 +1,14 @@
1
+ /** The project slug a hosted tool call uses when the agent passes "auto". */
2
+ export declare const HOSTED_DEFAULT_PROJECT = "main";
3
+ export declare const PROJECT_RE: RegExp;
4
+ export declare function tenantRoot(dataDir: string, uid: string): string;
5
+ /** Project slugs that exist on disk for a tenant (none when the tenant has no data yet). */
6
+ export declare function tenantProjects(root: string): string[];
7
+ /**
8
+ * Run `fn` as the OWNER of tenant `uid`: a tenant scope WITHOUT
9
+ * stageAgentCorrections, which is what lets confirmPendingCorrection activate.
10
+ * Only the operator CLI and the owner's signed-in review page may call this;
11
+ * never an MCP request.
12
+ */
13
+ export declare function asOwner<T>(dataDir: string, uid: string, fn: () => Promise<T>): Promise<T>;
14
+ //# sourceMappingURL=tenant-paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-paths.d.ts","sourceRoot":"","sources":["../../src/http/tenant-paths.ts"],"names":[],"mappings":"AAUA,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAE7C,eAAO,MAAM,UAAU,QAA+B,CAAC;AAEvD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzF"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * tenant-paths.ts — where a hosted tenant's memory lives, and its owner scope.
3
+ * Shared by serve.ts (MCP), review.ts (the owner's review page) and cli.ts (operator).
4
+ */
5
+ import * as fs from "node:fs";
6
+ import * as path from "node:path";
7
+ import { randomUUID } from "node:crypto";
8
+ import { withTenant } from "agent-recall-core";
9
+ import { UID_RE } from "./tokens.js";
10
+ /** The project slug a hosted tool call uses when the agent passes "auto". */
11
+ export const HOSTED_DEFAULT_PROJECT = "main";
12
+ export const PROJECT_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;
13
+ export function tenantRoot(dataDir, uid) {
14
+ if (!UID_RE.test(uid))
15
+ throw new Error("invalid uid");
16
+ const tenantsDir = path.resolve(dataDir, "tenants");
17
+ const root = path.resolve(tenantsDir, uid);
18
+ // Defence in depth: UID_RE already forbids separators and dots.
19
+ if (path.dirname(root) !== tenantsDir)
20
+ throw new Error("tenant root escapes data dir");
21
+ return root;
22
+ }
23
+ /** Project slugs that exist on disk for a tenant (none when the tenant has no data yet). */
24
+ export function tenantProjects(root) {
25
+ const projectsDir = path.join(root, "projects");
26
+ if (!fs.existsSync(projectsDir))
27
+ return [];
28
+ return fs.readdirSync(projectsDir, { withFileTypes: true })
29
+ .filter((e) => e.isDirectory() && PROJECT_RE.test(e.name))
30
+ .map((e) => e.name)
31
+ .sort();
32
+ }
33
+ /**
34
+ * Run `fn` as the OWNER of tenant `uid`: a tenant scope WITHOUT
35
+ * stageAgentCorrections, which is what lets confirmPendingCorrection activate.
36
+ * Only the operator CLI and the owner's signed-in review page may call this;
37
+ * never an MCP request.
38
+ */
39
+ export function asOwner(dataDir, uid, fn) {
40
+ return withTenant({ root: tenantRoot(dataDir, uid), sid: randomUUID(), defaultProject: HOSTED_DEFAULT_PROJECT }, fn);
41
+ }
42
+ //# sourceMappingURL=tenant-paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-paths.js","sourceRoot":"","sources":["../../src/http/tenant-paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEvD,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,GAAW;IACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,gEAAgE;IAChE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACxD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAI,OAAe,EAAE,GAAW,EAAE,EAAoB;IAC3E,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,cAAc,EAAE,sBAAsB,EAAE,EAAE,EAAE,CAAC,CAAC;AACvH,CAAC"}
@@ -0,0 +1,32 @@
1
+ export declare const UID_RE: RegExp;
2
+ export interface TokenRecord {
3
+ /** Short public id (first 12 hex of the hash) — safe to show and use for revoke. */
4
+ id: string;
5
+ uid: string;
6
+ label: string;
7
+ /** sha256(token), hex. */
8
+ hash: string;
9
+ created_at: string;
10
+ revoked_at?: string;
11
+ }
12
+ export declare function validateUid(uid: string): string;
13
+ /** Thrown when tokens.json exists but cannot be parsed; the server maps it to 503. */
14
+ export declare class TokenStoreUnavailableError extends Error {
15
+ }
16
+ /** Create a token for `uid`. The plaintext token is returned ONCE and never stored. */
17
+ export declare function createToken(dataDir: string, uid: string, label?: string): {
18
+ token: string;
19
+ record: TokenRecord;
20
+ };
21
+ /** Resolve a presented token to its uid and record id, or null (malformed, unknown, revoked). */
22
+ export declare function resolveTokenRecord(dataDir: string, token: string): {
23
+ uid: string;
24
+ id: string;
25
+ } | null;
26
+ /** Resolve a presented token to its uid, or null (malformed, unknown, revoked). */
27
+ export declare function resolveToken(dataDir: string, token: string): string | null;
28
+ /** Records without hashes, for display. */
29
+ export declare function listTokens(dataDir: string): Array<Omit<TokenRecord, "hash">>;
30
+ /** Revoke by public id. Returns false if no active token has that id. */
31
+ export declare function revokeToken(dataDir: string, id: string): boolean;
32
+ //# sourceMappingURL=tokens.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/http/tokens.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,MAAM,QAA8B,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAUD,sFAAsF;AACtF,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAsDxD,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAgB5G;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYrG;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAE5E;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAOhE"}
@@ -0,0 +1,137 @@
1
+ /**
2
+ * tokens.ts — bearer-token store for the hosted server.
3
+ *
4
+ * A token is the ONLY credential: `ar_` + 32 random bytes (base64url). Only its
5
+ * SHA-256 is persisted, so a leaked tokens.json cannot be replayed. A uid names
6
+ * the tenant's storage folder; it is server-assigned, validated, and grants
7
+ * nothing by itself.
8
+ *
9
+ * File: <dataDir>/_server/tokens.json (dir 0700, file 0600). Written only by the
10
+ * admin CLI; read per request so revocation takes effect immediately.
11
+ */
12
+ import * as fs from "node:fs";
13
+ import * as path from "node:path";
14
+ import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
15
+ export const UID_RE = /^[a-z0-9][a-z0-9-]{2,39}$/;
16
+ const TOKEN_RE = /^ar_[A-Za-z0-9_-]{43}$/;
17
+ const LABEL_MAX = 80;
18
+ export function validateUid(uid) {
19
+ if (!UID_RE.test(uid)) {
20
+ throw new Error(`invalid uid "${uid}": must match ${UID_RE} (lowercase letters, digits, dashes; 3-40 chars)`);
21
+ }
22
+ return uid;
23
+ }
24
+ function tokensPath(dataDir) {
25
+ return path.join(dataDir, "_server", "tokens.json");
26
+ }
27
+ function sha256Hex(s) {
28
+ return createHash("sha256").update(s, "utf-8").digest("hex");
29
+ }
30
+ /** Thrown when tokens.json exists but cannot be parsed; the server maps it to 503. */
31
+ export class TokenStoreUnavailableError extends Error {
32
+ }
33
+ function parseFile(p) {
34
+ let parsed;
35
+ try {
36
+ parsed = JSON.parse(fs.readFileSync(p, "utf-8"));
37
+ }
38
+ catch (err) {
39
+ throw new TokenStoreUnavailableError(`token file unreadable at ${p}: ${err.message}`);
40
+ }
41
+ if (parsed?.version !== 1 || !Array.isArray(parsed.tokens)) {
42
+ throw new TokenStoreUnavailableError(`unrecognized token file format at ${p}`);
43
+ }
44
+ return parsed;
45
+ }
46
+ function readFile(dataDir) {
47
+ const p = tokensPath(dataDir);
48
+ if (!fs.existsSync(p))
49
+ return { version: 1, tokens: [] };
50
+ return parseFile(p);
51
+ }
52
+ // Per-request reads are served from a cache keyed on (mtimeMs, size), so a
53
+ // revoke/create by the admin CLI (atomic rename → new mtime) takes effect on
54
+ // the very next request without re-parsing the file every time.
55
+ const cache = new Map();
56
+ function readFileCached(dataDir) {
57
+ const p = tokensPath(dataDir);
58
+ let st;
59
+ try {
60
+ st = fs.statSync(p);
61
+ }
62
+ catch {
63
+ cache.delete(p);
64
+ return { version: 1, tokens: [] };
65
+ }
66
+ const hit = cache.get(p);
67
+ if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size)
68
+ return hit.file;
69
+ const file = parseFile(p);
70
+ cache.set(p, { mtimeMs: st.mtimeMs, size: st.size, file });
71
+ return file;
72
+ }
73
+ function writeFile(dataDir, file) {
74
+ const p = tokensPath(dataDir);
75
+ fs.mkdirSync(path.dirname(p), { recursive: true, mode: 0o700 });
76
+ const tmp = `${p}.tmp.${process.pid}.${randomBytes(4).toString("hex")}`;
77
+ try {
78
+ fs.writeFileSync(tmp, JSON.stringify(file, null, 2), { encoding: "utf-8", mode: 0o600 });
79
+ fs.renameSync(tmp, p);
80
+ }
81
+ finally {
82
+ fs.rmSync(tmp, { force: true });
83
+ }
84
+ }
85
+ /** Create a token for `uid`. The plaintext token is returned ONCE and never stored. */
86
+ export function createToken(dataDir, uid, label = "") {
87
+ validateUid(uid);
88
+ if (/^g[hg]-/.test(uid))
89
+ throw new Error(`uid "${uid}" is reserved: the "gh-" and "gg-" prefixes belong to GitHub/Google sign-ins (use identity link to attach an account to a tenant)`);
90
+ const token = "ar_" + randomBytes(32).toString("base64url");
91
+ const hash = sha256Hex(token);
92
+ const record = {
93
+ id: hash.slice(0, 12),
94
+ uid,
95
+ label: label.replace(/[\r\n\t]/g, " ").slice(0, LABEL_MAX),
96
+ hash,
97
+ created_at: new Date().toISOString(),
98
+ };
99
+ const file = readFile(dataDir);
100
+ file.tokens.push(record);
101
+ writeFile(dataDir, file);
102
+ return { token, record };
103
+ }
104
+ /** Resolve a presented token to its uid and record id, or null (malformed, unknown, revoked). */
105
+ export function resolveTokenRecord(dataDir, token) {
106
+ if (!TOKEN_RE.test(token))
107
+ return null;
108
+ const presented = Buffer.from(sha256Hex(token), "hex");
109
+ let hit = null;
110
+ for (const rec of readFileCached(dataDir).tokens) {
111
+ const stored = Buffer.from(rec.hash, "hex");
112
+ // Compare every record (no early exit) in constant time per comparison.
113
+ if (stored.length === presented.length && timingSafeEqual(stored, presented) && !rec.revoked_at) {
114
+ hit = rec;
115
+ }
116
+ }
117
+ return hit !== null && UID_RE.test(hit.uid) ? { uid: hit.uid, id: hit.id } : null;
118
+ }
119
+ /** Resolve a presented token to its uid, or null (malformed, unknown, revoked). */
120
+ export function resolveToken(dataDir, token) {
121
+ return resolveTokenRecord(dataDir, token)?.uid ?? null;
122
+ }
123
+ /** Records without hashes, for display. */
124
+ export function listTokens(dataDir) {
125
+ return readFile(dataDir).tokens.map(({ hash: _hash, ...rest }) => rest);
126
+ }
127
+ /** Revoke by public id. Returns false if no active token has that id. */
128
+ export function revokeToken(dataDir, id) {
129
+ const file = readFile(dataDir);
130
+ const rec = file.tokens.find((t) => t.id === id && !t.revoked_at);
131
+ if (!rec)
132
+ return false;
133
+ rec.revoked_at = new Date().toISOString();
134
+ writeFile(dataDir, file);
135
+ return true;
136
+ }
137
+ //# sourceMappingURL=tokens.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/http/tokens.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ export declare const MAX_PROJECTS = 8;
2
+ export declare const MAX_FILES = 20;
3
+ export declare const SCAN_TTL_MS = 10000;
4
+ export interface TrialCredential {
5
+ key: string;
6
+ lastSeen?: string;
7
+ lastCall?: string;
8
+ }
9
+ export interface ActiveRule {
10
+ /** ms epoch the rule went live. */
11
+ at: number;
12
+ /** Every credential that taught this rule text; empty when any copy of it has no recorded author. */
13
+ authors: readonly string[];
14
+ }
15
+ export interface RuleScan {
16
+ /** Active corrections found (bounded scan). */
17
+ rules: ActiveRule[];
18
+ /** A cap cut the scan: rules may exist that were not looked at. */
19
+ capped: boolean;
20
+ }
21
+ export interface RuleSignals extends RuleScan {
22
+ /** Proposals waiting for the owner that /review can approve. */
23
+ ready: number;
24
+ }
25
+ export interface TrialState {
26
+ done: [boolean, boolean, boolean];
27
+ /** Step 3 is done because a credential other than a rule's recorded author was active after it (not just two credentials). */
28
+ proven: boolean;
29
+ count: number;
30
+ /** The first step not done (1..3), or null when all are. */
31
+ next: 1 | 2 | 3 | null;
32
+ /** A ready proposal is waiting and nothing is active yet: step 2 is the owner's approval. */
33
+ waiting: boolean;
34
+ /** Rules could not be read: steps 2 and 3 are unknown, not "not done". */
35
+ degraded: boolean;
36
+ /** A cap cut the scan (see RuleScan). */
37
+ capped: boolean;
38
+ }
39
+ /** Pure: the trial state from the account's credentials and rule signals (null = rules unreadable). */
40
+ export declare function computeTrial(credentials: readonly TrialCredential[], rules: RuleSignals | null): TrialState;
41
+ /**
42
+ * This account's active corrections (bounded): when each went live and who proposed it. Throws on an
43
+ * unreadable store (e.g. a corrections path that is not a directory); the caller degrades the
44
+ * card. A missing tenant or corrections directory is simply "none". Never creates anything.
45
+ */
46
+ export declare function scanRules(dataDir: string, uid: string): RuleScan;
47
+ /** Per-account cache of scanRules for SCAN_TTL_MS. Bounded; expired entries are dropped when it fills. Only successes are kept. */
48
+ export declare class RuleScanCache {
49
+ private readonly now;
50
+ private readonly ttlMs;
51
+ private readonly hits;
52
+ constructor(now: () => number, ttlMs?: number);
53
+ get(dataDir: string, uid: string): RuleScan;
54
+ }
55
+ //# sourceMappingURL=trial.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trial.d.ts","sourceRoot":"","sources":["../../src/http/trial.ts"],"names":[],"mappings":"AA+CA,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,SAAS,KAAK,CAAC;AAM5B,eAAO,MAAM,WAAW,QAAS,CAAC;AAGlC,MAAM,WAAW,eAAe;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;AACtF,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,qGAAqG;IACrG,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AACD,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,8HAA8H;IAC9H,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACvB,6FAA6F;IAC7F,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,UAAU,CAkB3G;AA8DD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAiChE;AAED,mIAAmI;AACnI,qBAAa,aAAa;IAEZ,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAgB,OAAO,CAAC,QAAQ,CAAC,KAAK;IADtE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqD;gBAC7C,GAAG,EAAE,MAAM,MAAM,EAAmB,KAAK,SAAc;IAEpF,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ;CAY5C"}