@exla/rudder 4.0.0-alpha.7 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/README.md +33 -69
  2. package/dist/agent-efficiency/backend-observer.d.ts +13 -0
  3. package/dist/agent-efficiency/backend-observer.js +77 -0
  4. package/dist/agent-efficiency/backend-observer.js.map +1 -0
  5. package/dist/agent-efficiency/handoff.d.ts +9 -0
  6. package/dist/agent-efficiency/handoff.js +42 -0
  7. package/dist/agent-efficiency/handoff.js.map +1 -0
  8. package/dist/agent-efficiency/index.d.ts +11 -0
  9. package/dist/agent-efficiency/index.js +7 -0
  10. package/dist/agent-efficiency/index.js.map +1 -0
  11. package/dist/agent-efficiency/lessons.d.ts +55 -0
  12. package/dist/agent-efficiency/lessons.js +107 -0
  13. package/dist/agent-efficiency/lessons.js.map +1 -0
  14. package/dist/agent-efficiency/privacy.d.ts +6 -0
  15. package/dist/agent-efficiency/privacy.js +28 -0
  16. package/dist/agent-efficiency/privacy.js.map +1 -0
  17. package/dist/agent-efficiency/production.d.ts +16 -0
  18. package/dist/agent-efficiency/production.js +120 -0
  19. package/dist/agent-efficiency/production.js.map +1 -0
  20. package/dist/agent-efficiency/storage.d.ts +3 -0
  21. package/dist/agent-efficiency/storage.js +28 -0
  22. package/dist/agent-efficiency/storage.js.map +1 -0
  23. package/dist/agent-efficiency/telemetry.d.ts +59 -0
  24. package/dist/agent-efficiency/telemetry.js +143 -0
  25. package/dist/agent-efficiency/telemetry.js.map +1 -0
  26. package/dist/agent-efficiency/trace-lessons.d.ts +21 -0
  27. package/dist/agent-efficiency/trace-lessons.js +36 -0
  28. package/dist/agent-efficiency/trace-lessons.js.map +1 -0
  29. package/dist/agent-efficiency/waits.d.ts +52 -0
  30. package/dist/agent-efficiency/waits.js +131 -0
  31. package/dist/agent-efficiency/waits.js.map +1 -0
  32. package/dist/backends.js +14 -8
  33. package/dist/backends.js.map +1 -1
  34. package/dist/board/authority.d.ts +48 -0
  35. package/dist/board/authority.js +125 -0
  36. package/dist/board/authority.js.map +1 -0
  37. package/dist/board/board.js +6 -2
  38. package/dist/board/daemon.d.ts +3 -6
  39. package/dist/board/daemon.js +242 -222
  40. package/dist/board/daemon.js.map +1 -1
  41. package/dist/board/host-access.d.ts +8 -0
  42. package/dist/board/host-access.js +222 -0
  43. package/dist/board/host-access.js.map +1 -0
  44. package/dist/board/project-files.d.ts +12 -0
  45. package/dist/board/project-files.js +78 -0
  46. package/dist/board/project-files.js.map +1 -0
  47. package/dist/brain.d.ts +2 -1
  48. package/dist/brain.js +15 -21
  49. package/dist/brain.js.map +1 -1
  50. package/dist/claude-sdk-protocol.js +10 -7
  51. package/dist/claude-sdk-protocol.js.map +1 -1
  52. package/dist/cloud-build-profile.d.ts +22 -0
  53. package/dist/cloud-build-profile.js +160 -0
  54. package/dist/cloud-build-profile.js.map +1 -0
  55. package/dist/cloud.js +23 -470
  56. package/dist/cloud.js.map +1 -1
  57. package/dist/codex-binary.d.ts +1 -0
  58. package/dist/codex-binary.js +8 -1
  59. package/dist/codex-binary.js.map +1 -1
  60. package/dist/daemon.d.ts +2 -0
  61. package/dist/daemon.js +14 -2
  62. package/dist/daemon.js.map +1 -1
  63. package/dist/effort.d.ts +8 -0
  64. package/dist/effort.js +15 -2
  65. package/dist/effort.js.map +1 -1
  66. package/dist/engine-authority.js +16 -0
  67. package/dist/engine-authority.js.map +1 -1
  68. package/dist/engine.d.ts +1 -1
  69. package/dist/engine.js +11 -2
  70. package/dist/engine.js.map +1 -1
  71. package/dist/fabric-fetch.d.ts +25 -0
  72. package/dist/fabric-fetch.js +402 -0
  73. package/dist/fabric-fetch.js.map +1 -0
  74. package/dist/fabric-local.d.ts +5 -2
  75. package/dist/fabric-local.js +36 -1
  76. package/dist/fabric-local.js.map +1 -1
  77. package/dist/fabric-remote.d.ts +76 -1
  78. package/dist/fabric-remote.js +333 -61
  79. package/dist/fabric-remote.js.map +1 -1
  80. package/dist/git.js +23 -0
  81. package/dist/git.js.map +1 -1
  82. package/dist/graph.js +9 -1
  83. package/dist/graph.js.map +1 -1
  84. package/dist/jj.d.ts +3 -1
  85. package/dist/jj.js +34 -2
  86. package/dist/jj.js.map +1 -1
  87. package/dist/main.js +102 -310
  88. package/dist/main.js.map +1 -1
  89. package/dist/migration.d.ts +2 -0
  90. package/dist/migration.js +3 -0
  91. package/dist/migration.js.map +1 -1
  92. package/dist/models.js +11 -6
  93. package/dist/models.js.map +1 -1
  94. package/dist/native/darwin-arm64/native-manifest.json +19 -0
  95. package/dist/native/darwin-arm64/rudder-jj +0 -0
  96. package/dist/native/darwin-arm64/rudder-native +0 -0
  97. package/dist/native/darwin-x64/native-manifest.json +19 -0
  98. package/dist/native/darwin-x64/rudder-jj +0 -0
  99. package/dist/native/darwin-x64/rudder-native +0 -0
  100. package/dist/native/linux-x64/native-manifest.json +19 -0
  101. package/dist/native/linux-x64/rudder-jj +0 -0
  102. package/dist/native/linux-x64/rudder-native +0 -0
  103. package/dist/native-agents.js +3 -7
  104. package/dist/native-agents.js.map +1 -1
  105. package/dist/native-binary.js +11 -1
  106. package/dist/native-binary.js.map +1 -1
  107. package/dist/operations/cli.d.ts +23 -0
  108. package/dist/operations/cli.js +110 -0
  109. package/dist/operations/cli.js.map +1 -0
  110. package/dist/operations/registry.d.ts +1076 -0
  111. package/dist/operations/registry.js +69 -0
  112. package/dist/operations/registry.js.map +1 -0
  113. package/dist/operations/registry.json +124 -0
  114. package/dist/operations/requests.d.ts +167 -0
  115. package/dist/operations/requests.js +223 -0
  116. package/dist/operations/requests.js.map +1 -0
  117. package/dist/planning-ownership/index.d.ts +134 -0
  118. package/dist/planning-ownership/index.js +291 -0
  119. package/dist/planning-ownership/index.js.map +1 -0
  120. package/dist/planning-ownership/ingress.d.ts +30 -0
  121. package/dist/planning-ownership/ingress.js +41 -0
  122. package/dist/planning-ownership/ingress.js.map +1 -0
  123. package/dist/planning-ownership/store.d.ts +19 -0
  124. package/dist/planning-ownership/store.js +30 -0
  125. package/dist/planning-ownership/store.js.map +1 -0
  126. package/dist/private-access/cli.d.ts +22 -0
  127. package/dist/private-access/cli.js +76 -0
  128. package/dist/private-access/cli.js.map +1 -0
  129. package/dist/private-access/engine.d.ts +20 -0
  130. package/dist/private-access/engine.js +47 -0
  131. package/dist/private-access/engine.js.map +1 -0
  132. package/dist/private-access/home.d.ts +21 -0
  133. package/dist/private-access/home.js +80 -0
  134. package/dist/private-access/home.js.map +1 -0
  135. package/dist/private-access/previews.d.ts +101 -0
  136. package/dist/private-access/previews.js +447 -0
  137. package/dist/private-access/previews.js.map +1 -0
  138. package/dist/project-files/cli.d.ts +7 -0
  139. package/dist/project-files/cli.js +22 -0
  140. package/dist/project-files/cli.js.map +1 -0
  141. package/dist/project-files/engine.d.ts +14 -0
  142. package/dist/project-files/engine.js +52 -0
  143. package/dist/project-files/engine.js.map +1 -0
  144. package/dist/project-files/home.d.ts +13 -0
  145. package/dist/project-files/home.js +46 -0
  146. package/dist/project-files/home.js.map +1 -0
  147. package/dist/project-files/http.d.ts +9 -0
  148. package/dist/project-files/http.js +54 -0
  149. package/dist/project-files/http.js.map +1 -0
  150. package/dist/project-files/open.d.ts +10 -0
  151. package/dist/project-files/open.js +37 -0
  152. package/dist/project-files/open.js.map +1 -0
  153. package/dist/project-files/references.d.ts +9 -0
  154. package/dist/project-files/references.js +29 -0
  155. package/dist/project-files/references.js.map +1 -0
  156. package/dist/project-files/service.d.ts +32 -0
  157. package/dist/project-files/service.js +236 -0
  158. package/dist/project-files/service.js.map +1 -0
  159. package/dist/project-files/types.d.ts +40 -0
  160. package/dist/project-files/types.js +2 -0
  161. package/dist/project-files/types.js.map +1 -0
  162. package/dist/run-manager.d.ts +2 -0
  163. package/dist/run-manager.js +183 -13
  164. package/dist/run-manager.js.map +1 -1
  165. package/dist/run-timeline.d.ts +29 -0
  166. package/dist/run-timeline.js +112 -0
  167. package/dist/run-timeline.js.map +1 -0
  168. package/dist/scheduler.js +72 -13
  169. package/dist/scheduler.js.map +1 -1
  170. package/dist/surfaces.js +3 -8
  171. package/dist/surfaces.js.map +1 -1
  172. package/dist/tailscale-preview.d.ts +6 -2
  173. package/dist/tailscale-preview.js +58 -13
  174. package/dist/tailscale-preview.js.map +1 -1
  175. package/dist/task-routing.d.ts +2 -0
  176. package/dist/task-routing.js +42 -25
  177. package/dist/task-routing.js.map +1 -1
  178. package/dist/terminal-screen.d.ts +6 -0
  179. package/dist/terminal-screen.js +23 -0
  180. package/dist/terminal-screen.js.map +1 -0
  181. package/dist/tool-cache.d.ts +23 -0
  182. package/dist/tool-cache.js +144 -0
  183. package/dist/tool-cache.js.map +1 -0
  184. package/dist/types.d.ts +0 -17
  185. package/dist/types.js.map +1 -1
  186. package/dist/util.d.ts +8 -0
  187. package/dist/util.js +38 -2
  188. package/dist/util.js.map +1 -1
  189. package/dist/v4-migration/capture.d.ts +53 -0
  190. package/dist/v4-migration/capture.js +197 -0
  191. package/dist/v4-migration/capture.js.map +1 -0
  192. package/dist/v4-migration/cli.d.ts +4 -0
  193. package/dist/v4-migration/cli.js +38 -0
  194. package/dist/v4-migration/cli.js.map +1 -0
  195. package/dist/v4-migration/recovery.d.ts +43 -0
  196. package/dist/v4-migration/recovery.js +180 -0
  197. package/dist/v4-migration/recovery.js.map +1 -0
  198. package/dist/version-check.d.ts +2 -0
  199. package/dist/version-check.js +23 -0
  200. package/dist/version-check.js.map +1 -1
  201. package/dist/warm-snapshot.d.ts +55 -0
  202. package/dist/warm-snapshot.js +381 -0
  203. package/dist/warm-snapshot.js.map +1 -0
  204. package/package.json +4 -3
  205. package/scripts/copy-native.mjs +35 -48
  206. package/scripts/native-artifacts.mjs +248 -0
  207. package/dist/improve/advisor.d.ts +0 -10
  208. package/dist/improve/advisor.js +0 -115
  209. package/dist/improve/advisor.js.map +0 -1
  210. package/dist/improve/collect.d.ts +0 -49
  211. package/dist/improve/collect.js +0 -274
  212. package/dist/improve/collect.js.map +0 -1
  213. package/dist/improve/gate.d.ts +0 -17
  214. package/dist/improve/gate.js +0 -60
  215. package/dist/improve/gate.js.map +0 -1
  216. package/dist/improve/index.d.ts +0 -9
  217. package/dist/improve/index.js +0 -376
  218. package/dist/improve/index.js.map +0 -1
  219. package/dist/improve/judge.d.ts +0 -32
  220. package/dist/improve/judge.js +0 -114
  221. package/dist/improve/judge.js.map +0 -1
  222. package/dist/improve/mine.d.ts +0 -31
  223. package/dist/improve/mine.js +0 -192
  224. package/dist/improve/mine.js.map +0 -1
  225. package/dist/improve/propose.d.ts +0 -51
  226. package/dist/improve/propose.js +0 -150
  227. package/dist/improve/propose.js.map +0 -1
  228. package/dist/improve/rank.d.ts +0 -16
  229. package/dist/improve/rank.js +0 -49
  230. package/dist/improve/rank.js.map +0 -1
  231. package/dist/improve/schedule.d.ts +0 -1
  232. package/dist/improve/schedule.js +0 -95
  233. package/dist/improve/schedule.js.map +0 -1
  234. package/dist/improve/ship.d.ts +0 -25
  235. package/dist/improve/ship.js +0 -82
  236. package/dist/improve/ship.js.map +0 -1
  237. package/dist/improve/state.d.ts +0 -157
  238. package/dist/improve/state.js +0 -264
  239. package/dist/improve/state.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/planning-ownership/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,cAAc,EAAE,gBAAgB,EAAE,eAAe,GAElD,MAAM,YAAY,CAAC;AAOpB;;6EAE6E;AAC7E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,QAAgB,EAChB,OAA8F,EAC9F,OAA6B;IAE7B,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5H,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAC9D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7H,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAA6B,CAAC;IAClC,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;QAClC,sEAAsE;QACtE,wEAAwE;QACxE,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ;YACtE,CAAC,CAAE,KAAuB,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QACjF,IAAI,CAAC,cAAc,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;YACtE,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IACH,OAAO,MAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,22 @@
1
+ type Client = {
2
+ request<T>(route: string, options: {
3
+ method: "GET";
4
+ }): Promise<T>;
5
+ };
6
+ /** Exact-reference opening for the real Cloud command. URLs are issued only by
7
+ * fresh authenticated Home discovery and re-resolved after local ACL/readiness. */
8
+ export declare function runPrivatePreviewCommand(args: readonly string[], options: {
9
+ json?: boolean;
10
+ }, dependencies: {
11
+ client: Client;
12
+ project: {
13
+ repo?: string | null;
14
+ name?: string;
15
+ };
16
+ localStatus: () => Promise<unknown>;
17
+ reachable: (url: string) => Promise<boolean>;
18
+ open: (url: string) => unknown;
19
+ write?: (text: string) => void;
20
+ printJson?: (value: unknown) => void;
21
+ }): Promise<void>;
22
+ export {};
@@ -0,0 +1,76 @@
1
+ import { canonicalPreviewUrl, previewAccess } from "../tailscale-preview.js";
2
+ const identifier = (value) => typeof value === "string" && value.length > 0 && value.length <= 256 && !/[\x00-\x1f\x7f]/.test(value);
3
+ function preview(value) {
4
+ const row = value;
5
+ if (!row || !/^[a-f0-9]{64}$/.test(row.id) || ![row.tenantId, row.projectId, row.workspaceId, row.attemptId, row.deviceId, row.processStart].every(identifier)
6
+ || row.ready !== true || !Number.isSafeInteger(row.pid) || row.pid <= 1 || !["http", "https"].includes(row.protocol)
7
+ || canonicalPreviewUrl(row.url, row.dnsName, row.port) !== row.url)
8
+ throw new Error("Invalid current private preview reference");
9
+ return row;
10
+ }
11
+ const identity = (row) => JSON.stringify([row.id, row.tenantId, row.projectId, row.workspaceId, row.attemptId, row.deviceId, row.dnsName, row.url, row.port, row.pid, row.processStart, row.protocol]);
12
+ /** Exact-reference opening for the real Cloud command. URLs are issued only by
13
+ * fresh authenticated Home discovery and re-resolved after local ACL/readiness. */
14
+ export async function runPrivatePreviewCommand(args, options, dependencies) {
15
+ const positional = args.filter(arg => arg !== "--list");
16
+ if (args.filter(arg => arg === "--list").length > 1 || positional.length > 1 || positional[0] && !/^[a-f0-9]{64}$/.test(positional[0])) {
17
+ throw new Error("Usage: rudder cloud preview [preview-id] [--list] [--json]");
18
+ }
19
+ const write = dependencies.write ?? ((text) => process.stdout.write(`${text}\n`));
20
+ const state = await dependencies.client.request("/api/rudder/home", { method: "GET" });
21
+ const projects = (Array.isArray(state.projects) ? state.projects : []).filter((raw) => {
22
+ const row = raw;
23
+ return identifier(row?.workspaceId) && (dependencies.project.repo
24
+ ? typeof row.repo === "string" && row.repo.toLowerCase() === dependencies.project.repo.toLowerCase()
25
+ : typeof dependencies.project.name === "string" && row.name === dependencies.project.name);
26
+ });
27
+ if (projects.length !== 1)
28
+ throw new Error(projects.length ? "Choose an unambiguous Cloud project before opening its preview." : "This project has no registered Cloud workspace.");
29
+ const workspace = encodeURIComponent(projects[0].workspaceId);
30
+ const result = await dependencies.client.request(`/api/app/previews?workspace=${workspace}`, { method: "GET" });
31
+ if (result?.version !== 1 || !Array.isArray(result.previews) || result.previews.length > 64)
32
+ throw new Error("Invalid private preview discovery");
33
+ const rows = result.previews.map(preview);
34
+ if (options.json) {
35
+ (dependencies.printJson ?? (value => write(JSON.stringify(value, null, 2))))({ version: 1, previews: rows, access: "tailnet", requiresTailscale: true });
36
+ return;
37
+ }
38
+ const requested = positional[0];
39
+ if (!requested || args.includes("--list")) {
40
+ if (!rows.length) {
41
+ write("No registered private preview is ready for this project.");
42
+ return;
43
+ }
44
+ for (const row of rows)
45
+ write(`${row.id} :${row.port} ${row.url}`);
46
+ write("Open one with: rudder cloud preview <preview-id>");
47
+ return;
48
+ }
49
+ const selected = rows.find(row => row.id === requested);
50
+ if (!selected)
51
+ throw new Error("The exact private preview is no longer ready. Refresh discovery.");
52
+ const resolve = async () => {
53
+ const response = await dependencies.client.request(`/api/app/previews/open?workspace=${workspace}&id=${requested}`, { method: "GET" });
54
+ if (response?.version !== 1)
55
+ throw new Error("Invalid private preview discovery");
56
+ const current = preview(response.preview);
57
+ if (identity(current) !== identity(selected))
58
+ throw new Error("The private preview binding changed. Refresh discovery.");
59
+ return current;
60
+ };
61
+ const current = await resolve();
62
+ const access = previewAccess(await dependencies.localStatus(), current.dnsName, current.deviceId);
63
+ if (!access.ok)
64
+ throw new Error(access.error);
65
+ if (!(await dependencies.reachable(current.url)))
66
+ throw new Error("The private preview is not reachable with this computer's existing Tailscale access rules.");
67
+ // The potentially slow local probe grants no durable authorization. A changed
68
+ // owner, process token, device or project ACL must prevent browser launch.
69
+ const final = await resolve();
70
+ const finalAccess = previewAccess(await dependencies.localStatus(), final.dnsName, final.deviceId);
71
+ if (!finalAccess.ok)
72
+ throw new Error(finalAccess.error);
73
+ await dependencies.open(final.url);
74
+ write(final.url);
75
+ }
76
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/private-access/cli.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import type { FileScope } from "../project-files/types.js";
2
+ export type RegisteredPreviewProcess = {
3
+ version: 1;
4
+ role: "preview";
5
+ action: "register";
6
+ scope: FileScope;
7
+ owner: {
8
+ project_id: string;
9
+ owner_id: string;
10
+ epoch: number;
11
+ };
12
+ workspacePath: string;
13
+ rootPid: number;
14
+ pid: number;
15
+ processStart: string;
16
+ protocol: "http" | "https";
17
+ };
18
+ /** Private owner socket supplies current process custody, never projected state,
19
+ * arbitrary cwd, or an unreceipted Home process launch. */
20
+ export declare function queryPreviewOwner(repo: string, operation: "previews" | "preview-register", request?: unknown, signal?: AbortSignal, nativeBinary?: string | undefined): Promise<RegisteredPreviewProcess[] | unknown>;
@@ -0,0 +1,47 @@
1
+ import { execFile } from "node:child_process";
2
+ import { realpath } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { parseEngineStatus } from "../engine.js";
5
+ import { resolveNativeBinaryPath } from "../native-binary.js";
6
+ import { validateFileScope } from "../project-files/service.js";
7
+ /** Private owner socket supplies current process custody, never projected state,
8
+ * arbitrary cwd, or an unreceipted Home process launch. */
9
+ export async function queryPreviewOwner(repo, operation, request, signal = AbortSignal.timeout(3000), nativeBinary = resolveNativeBinaryPath()) {
10
+ signal.throwIfAborted();
11
+ if (!nativeBinary)
12
+ throw new Error("Current preview authority is unavailable");
13
+ const root = await realpath(repo);
14
+ const args = ["engine", operation, "--repo", root, "--json"];
15
+ if (operation === "preview-register") {
16
+ const encoded = JSON.stringify(request);
17
+ if (!encoded || Buffer.byteLength(encoded) > 4096)
18
+ throw new Error("Preview registration exceeds bound");
19
+ args.push("--preview-json", encoded);
20
+ }
21
+ const raw = await new Promise((resolve, reject) => execFile(nativeBinary, args, { cwd: root, signal, timeout: 3000, maxBuffer: 128 * 1024 }, (error, stdout) => error ? reject(new Error("Current preview authority is unavailable")) : resolve(stdout)));
22
+ const status = parseEngineStatus(raw);
23
+ if (!status.running || status.authority !== "fabric" || !status.owner || await realpath(status.repo) !== root) {
24
+ throw new Error("Current preview authority is unavailable");
25
+ }
26
+ const output = JSON.parse(raw);
27
+ signal.throwIfAborted();
28
+ if (operation === "preview-register")
29
+ return output.preview;
30
+ const values = output.previews;
31
+ if (!Array.isArray(values) || values.length > 64)
32
+ throw new Error("Current preview bindings exceed bound");
33
+ return values.map((raw) => {
34
+ const value = raw;
35
+ const scope = validateFileScope(value?.scope);
36
+ if (value.version !== 1 || value.role !== "preview" || value.action !== "register"
37
+ || value.owner?.project_id !== status.owner.project_id || value.owner?.owner_id !== status.owner.owner_id
38
+ || value.owner?.epoch !== status.owner.epoch || scope.projectId !== status.owner.project_id || scope.ownerEpoch !== status.owner.epoch
39
+ || typeof value.workspacePath !== "string" || !path.isAbsolute(value.workspacePath) || value.workspacePath.length > 4096
40
+ || !Number.isSafeInteger(value.pid) || value.pid <= 1 || !Number.isSafeInteger(value.rootPid) || value.rootPid <= 1
41
+ || typeof value.processStart !== "string" || !/^\d{1,32}$/.test(value.processStart) || !["http", "https"].includes(value.protocol)) {
42
+ throw new Error("Current preview binding changed");
43
+ }
44
+ return { ...value, scope };
45
+ });
46
+ }
47
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/private-access/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { queryPreviewOwner } from "./engine.js";
2
+ import { PrivatePreviewDirectory, observeLinuxPreviewListeners, type PreviewListener, type PrivatePreview } from "./previews.js";
3
+ type Project = {
4
+ workspaceId: string;
5
+ dir: string;
6
+ };
7
+ /** One Home-wide directory owns Serve reconciliation. Only native App receipts
8
+ * supply preview roles; ordinary agent listeners remain private and unpublished. */
9
+ export declare class HomePrivatePreviews {
10
+ #private;
11
+ readonly tenantId: string;
12
+ readonly directory: PrivatePreviewDirectory;
13
+ readonly query: typeof queryPreviewOwner;
14
+ readonly observe: typeof observeLinuxPreviewListeners;
15
+ constructor(tenantId: string, directory?: PrivatePreviewDirectory, query?: typeof queryPreviewOwner, observe?: typeof observeLinuxPreviewListeners);
16
+ reconcile(projects: Project[]): Promise<void>;
17
+ processMatches(item: PreviewListener): Promise<boolean>;
18
+ snapshot(workspaceId: string): PrivatePreview[];
19
+ register(project: Project, request: unknown): Promise<unknown>;
20
+ }
21
+ export {};
@@ -0,0 +1,80 @@
1
+ import { queryPreviewOwner } from "./engine.js";
2
+ import { PrivatePreviewDirectory, observeLinuxPreviewListeners, previewProcessMatches } from "./previews.js";
3
+ /** One Home-wide directory owns Serve reconciliation. Only native App receipts
4
+ * supply preview roles; ordinary agent listeners remain private and unpublished. */
5
+ export class HomePrivatePreviews {
6
+ tenantId;
7
+ directory;
8
+ query;
9
+ observe;
10
+ #projects = new Map();
11
+ #roots = new Map();
12
+ #scanning;
13
+ constructor(tenantId, directory = new PrivatePreviewDirectory(), query = queryPreviewOwner, observe = observeLinuxPreviewListeners) {
14
+ this.tenantId = tenantId;
15
+ this.directory = directory;
16
+ this.query = query;
17
+ this.observe = observe;
18
+ }
19
+ reconcile(projects) {
20
+ if (this.#scanning)
21
+ return this.#scanning;
22
+ return this.#scanning = this.#reconcile(projects).finally(() => { this.#scanning = undefined; });
23
+ }
24
+ async #reconcile(projects) {
25
+ const next = new Map();
26
+ // Bound concurrent native owner snapshots. A disappeared owner clears its
27
+ // reports in this tick rather than preserving stale published URLs.
28
+ for (let i = 0; i < Math.min(projects.length, 64); i += 4) {
29
+ await Promise.all(projects.slice(i, i + 4).map(async (project) => {
30
+ try {
31
+ const rows = await this.query(project.dir, "previews");
32
+ if (Array.isArray(rows))
33
+ next.set(project.workspaceId, rows);
34
+ }
35
+ catch { /* no current custody, so no preview */ }
36
+ }));
37
+ }
38
+ this.#projects = next;
39
+ this.#roots = new Map(projects.slice(0, 64).map(project => [project.workspaceId, project.dir]));
40
+ const processes = [...next.values()].flat().map(row => ({ tenantId: this.tenantId,
41
+ projectId: row.scope.projectId, workspaceId: row.scope.workspaceId, attemptId: row.scope.attemptId,
42
+ workspacePath: row.workspacePath, pid: row.pid, processStart: row.processStart, protocol: row.protocol, role: row.role }));
43
+ await this.directory.reconcile(await this.observe(processes));
44
+ }
45
+ async processMatches(item) {
46
+ for (const [workspace, records] of this.#projects) {
47
+ const prior = records.find(row => row.scope.projectId === item.projectId && row.scope.workspaceId === item.workspaceId
48
+ && row.scope.attemptId === item.attemptId && row.pid === item.pid && row.processStart === item.processStart);
49
+ const repo = this.#roots.get(workspace);
50
+ if (!prior || !repo || item.tenantId !== this.tenantId)
51
+ continue;
52
+ try {
53
+ // Probes and Serve commands can outlive an owner observation. Recheck
54
+ // actual App custody before and after readiness, including owner epoch.
55
+ const current = await this.query(repo, "previews", undefined, AbortSignal.timeout(1500));
56
+ return Array.isArray(current) && current.some((row) => row.pid === prior.pid && row.processStart === prior.processStart && row.protocol === prior.protocol
57
+ && row.workspacePath === prior.workspacePath && row.scope.projectId === prior.scope.projectId
58
+ && row.scope.workspaceId === prior.scope.workspaceId && row.scope.attemptId === prior.scope.attemptId && row.scope.ownerEpoch === prior.scope.ownerEpoch
59
+ && row.owner.owner_id === prior.owner.owner_id && row.owner.epoch === prior.owner.epoch)
60
+ && await previewProcessMatches(item);
61
+ }
62
+ catch {
63
+ return false;
64
+ }
65
+ }
66
+ return false;
67
+ }
68
+ snapshot(workspaceId) {
69
+ const rows = this.#projects.get(workspaceId) ?? [];
70
+ return this.directory.snapshot().filter(item => rows.some(row => row.scope.projectId === item.projectId
71
+ && row.scope.workspaceId === item.workspaceId && row.scope.attemptId === item.attemptId
72
+ && row.pid === item.pid && row.processStart === item.processStart));
73
+ }
74
+ async register(project, request) {
75
+ // This records an already-owned process. It cannot start a process or grant
76
+ // custody to a project inferred from a path.
77
+ return this.query(project.dir, "preview-register", request);
78
+ }
79
+ }
80
+ //# sourceMappingURL=home.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/private-access/home.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,101 @@
1
+ export type PreviewBinding = {
2
+ tenantId: string;
3
+ projectId: string;
4
+ workspaceId: string;
5
+ attemptId: string;
6
+ workspacePath: string;
7
+ };
8
+ export type PreviewListener = PreviewBinding & {
9
+ pid: number;
10
+ processStart: string;
11
+ port: number;
12
+ protocol: "http" | "https";
13
+ origin: string;
14
+ role: "preview";
15
+ };
16
+ export type PrivatePreview = PreviewListener & {
17
+ id: string;
18
+ deviceId: string;
19
+ dnsName: string;
20
+ url: string;
21
+ ready: true;
22
+ observedAt: number;
23
+ };
24
+ export type TailnetCommandResult = {
25
+ code: number;
26
+ stdout: string;
27
+ };
28
+ export type TailnetCommand = (args: string[], signal: AbortSignal) => Promise<TailnetCommandResult>;
29
+ export type PreviewTrace = {
30
+ correlationId: string;
31
+ stage: string;
32
+ at: number;
33
+ };
34
+ /** No login/up/auth-key command: persisted tailscaled identity remains authoritative. */
35
+ export declare const executeTailnetCommand: TailnetCommand;
36
+ export declare function loopbackPreviewOrigin(host: string, port: number, protocol?: "http" | "https"): string | null;
37
+ export declare function processStartToken(pid: number, procRoot?: string): Promise<string | null>;
38
+ export declare function previewProcessMatches(item: PreviewListener, procRoot?: string): Promise<boolean>;
39
+ /** Read only engine-registered preview processes, never all machine listeners.
40
+ * The spawn record supplies the owner attempt and process-start token. */
41
+ export declare function observeLinuxPreviewListeners(processes: Array<PreviewBinding & {
42
+ pid: number;
43
+ processStart: string;
44
+ role: string;
45
+ protocol?: "http" | "https";
46
+ }>, options?: {
47
+ procRoot?: string;
48
+ maxProcesses?: number;
49
+ maxListeners?: number;
50
+ }): Promise<PreviewListener[]>;
51
+ /** Project ownership and route readiness are independent from network reachability.
52
+ * This directory is ephemeral; persist only its owned-route journal through the
53
+ * existing JSON store, and repopulate from fresh process observations on boot. */
54
+ export declare class PrivatePreviewDirectory {
55
+ private readonly options;
56
+ private readonly routes;
57
+ private readonly owned;
58
+ private readonly claimedTargets;
59
+ private readonly uncertain;
60
+ private readonly unsettled;
61
+ private desired;
62
+ private revision;
63
+ private queue;
64
+ private online;
65
+ readonly timeoutMs: number;
66
+ constructor(options?: {
67
+ execute?: TailnetCommand;
68
+ probe?: (url: string, timeoutMs: number) => Promise<boolean>;
69
+ processMatches?: (item: PreviewListener) => Promise<boolean>;
70
+ now?: () => number;
71
+ timeoutMs?: number;
72
+ maxAgeMs?: number;
73
+ maxListeners?: number;
74
+ allowPrivateHttp?: boolean;
75
+ ownedPorts?: number[];
76
+ onOwnedPorts?: (ports: number[]) => void;
77
+ trace?: (event: PreviewTrace) => void;
78
+ });
79
+ private now;
80
+ private trace;
81
+ private journal;
82
+ private current;
83
+ private processMatches;
84
+ private command;
85
+ private retire;
86
+ snapshot(binding?: PreviewBinding): PrivatePreview[];
87
+ reconcile(listeners: PreviewListener[]): Promise<void>;
88
+ private update;
89
+ /** Resolve from the live directory after tenant/project authorization. Caller
90
+ * invokes its local browser only with this returned URL. Never accepts a URL
91
+ * supplied by a user or a terminal byte stream. */
92
+ open(id: string, binding: PreviewBinding, options: {
93
+ authorize: (binding: PreviewBinding) => Promise<boolean>;
94
+ localStatus: () => Promise<unknown>;
95
+ probe?: (url: string, timeoutMs: number) => Promise<boolean>;
96
+ relay?: (preview: PrivatePreview) => Promise<string | null>;
97
+ }): Promise<{
98
+ url: string;
99
+ access: "tailnet" | "relay";
100
+ }>;
101
+ }