@opengeni/worker-bundle 0.16.29 → 0.20.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 (188) hide show
  1. package/dist/activities/agent-run-admission.d.ts +12 -0
  2. package/dist/activities/agent-turn.d.ts +110 -19
  3. package/dist/activities/api-integrations.d.ts +21 -0
  4. package/dist/activities/browser-state-artifact-reaper.d.ts +29 -0
  5. package/dist/activities/capabilities.d.ts +6 -0
  6. package/dist/activities/codemode-dispatcher.d.ts +35 -0
  7. package/dist/activities/codemode-token-renewal.d.ts +23 -0
  8. package/dist/activities/codex-capacity.d.ts +6 -5
  9. package/dist/activities/codex-image-generation.d.ts +21 -0
  10. package/dist/activities/context-compaction.d.ts +1 -0
  11. package/dist/activities/documents.d.ts +3 -2
  12. package/dist/activities/environment.d.ts +17 -8
  13. package/dist/activities/expiring-material-renewal.d.ts +1 -1
  14. package/dist/activities/file-upload-reaper.d.ts +7 -2
  15. package/dist/activities/gateway-image-generation.d.ts +39 -0
  16. package/dist/activities/gateway-video-generation.d.ts +53 -0
  17. package/dist/activities/generated-images.d.ts +112 -0
  18. package/dist/activities/git-credential-renewal.d.ts +1 -1
  19. package/dist/activities/goals.d.ts +2 -2
  20. package/dist/activities/google-drive-changes.d.ts +99 -0
  21. package/dist/activities/image-generation-operation.d.ts +74 -0
  22. package/dist/activities/image-generation-references.d.ts +25 -0
  23. package/dist/activities/knowledge-source-sync-driver.d.ts +23 -0
  24. package/dist/activities/knowledge-source-sync.d.ts +75 -0
  25. package/dist/activities/packs.d.ts +21 -36
  26. package/dist/activities/parent-wake.d.ts +1 -1
  27. package/dist/activities/retained-screenshot-reaper.d.ts +2 -2
  28. package/dist/activities/retained-screenshots.d.ts +36 -0
  29. package/dist/activities/rig-verification.d.ts +82 -5
  30. package/dist/activities/run-credential-renewal.d.ts +1 -1
  31. package/dist/activities/run-input.d.ts +3 -1
  32. package/dist/activities/sandbox-images.d.ts +14 -0
  33. package/dist/activities/sandbox-lease.d.ts +47 -9
  34. package/dist/activities/scheduled-tasks.d.ts +2 -2
  35. package/dist/activities/session-state.d.ts +7 -5
  36. package/dist/activities/site-auth-maintenance.d.ts +27 -0
  37. package/dist/activities/streaming.d.ts +1 -1
  38. package/dist/activities/types.d.ts +87 -5
  39. package/dist/activities/video-generation-admission.d.ts +43 -0
  40. package/dist/activities/video-generation-credential.d.ts +24 -0
  41. package/dist/activities/video-generation-reconciliation.d.ts +13 -0
  42. package/dist/activities/video-media-validation.d.ts +34 -0
  43. package/dist/activities/video-output-retention.d.ts +36 -0
  44. package/dist/activities/video-reference-staging.d.ts +55 -0
  45. package/dist/activities/workflow-wake.d.ts +2 -2
  46. package/dist/activities/workspace-capture.d.ts +10 -1
  47. package/dist/activities/xai-auth.d.ts +23 -0
  48. package/dist/activities/xai-image-generation.d.ts +26 -0
  49. package/dist/activities/xai-video-generation.d.ts +18 -0
  50. package/dist/activities-control-XURE4VKN.js +7221 -0
  51. package/dist/activities-control-XURE4VKN.js.map +1 -0
  52. package/dist/activities-control.d.ts +297 -0
  53. package/dist/activities-turn-6EBXGGLS.js +16036 -0
  54. package/dist/activities-turn-6EBXGGLS.js.map +1 -0
  55. package/dist/activities-turn.d.ts +17 -0
  56. package/dist/activities.d.ts +138 -150
  57. package/dist/activity-services.d.ts +10 -0
  58. package/dist/artifact-materializer-entry.d.ts +6 -0
  59. package/dist/artifact-materializer-entry.js +2662 -0
  60. package/dist/artifact-materializer-entry.js.map +1 -0
  61. package/dist/artifact-outbox-entry.d.ts +2 -0
  62. package/dist/artifact-outbox-entry.js +681 -0
  63. package/dist/artifact-outbox-entry.js.map +1 -0
  64. package/dist/chunk-5GRJIP5H.js +3092 -0
  65. package/dist/chunk-5GRJIP5H.js.map +1 -0
  66. package/dist/chunk-GRFQTTSQ.js +448 -0
  67. package/dist/chunk-GRFQTTSQ.js.map +1 -0
  68. package/dist/chunk-TYNPCG4U.js +906 -0
  69. package/dist/chunk-TYNPCG4U.js.map +1 -0
  70. package/dist/concurrency.d.ts +108 -5
  71. package/dist/editable-artifact-hint-broker.d.ts +49 -0
  72. package/dist/editable-artifact-materializer-launcher.d.ts +49 -0
  73. package/dist/editable-artifact-materializer-service.d.ts +108 -0
  74. package/dist/editable-artifact-materializer-storage.d.ts +12 -0
  75. package/dist/editable-artifact-materializer-subprocess.d.ts +50 -0
  76. package/dist/editable-artifact-materializer.d.ts +262 -0
  77. package/dist/editable-artifact-outbox-dispatcher.d.ts +44 -0
  78. package/dist/editable-artifact-outbox-service.d.ts +70 -0
  79. package/dist/host-export.d.ts +1 -1
  80. package/dist/index.d.ts +189 -10
  81. package/dist/index.js +715 -17380
  82. package/dist/index.js.map +1 -1
  83. package/dist/memory-pressure-guard.d.ts +57 -0
  84. package/dist/model-checkpoint-memory-collector.d.ts +23 -0
  85. package/dist/model-context-contributions.d.ts +40 -0
  86. package/dist/observability-metrics.d.ts +53 -1
  87. package/dist/sandbox-reaper-contract.d.ts +40 -0
  88. package/dist/sandbox-reaper-timeout.d.ts +14 -0
  89. package/dist/sandbox-resume.d.ts +34 -7
  90. package/dist/sandbox-routing.d.ts +6 -0
  91. package/dist/worker-service-lifecycle.d.ts +6 -2
  92. package/dist/workflow-bundle.js +1094 -370
  93. package/dist/workflows/activities.d.ts +8 -2
  94. package/dist/workflows/document-index.d.ts +1 -1
  95. package/dist/workflows/knowledge-source-sync.d.ts +13 -0
  96. package/dist/workflows/rig-verification.d.ts +1 -1
  97. package/dist/workflows/sandbox-reaper.d.ts +8 -0
  98. package/dist/workflows/scheduled-tasks.d.ts +1 -1
  99. package/dist/workflows/session.d.ts +2 -2
  100. package/dist/workflows/site-auth-maintenance.d.ts +2 -0
  101. package/dist/workflows/video-generation.d.ts +10 -0
  102. package/dist/workflows/workflow-wake.d.ts +1 -1
  103. package/dist/workflows.d.ts +10 -7
  104. package/package.json +35 -15
  105. package/src/activities/agent-run-admission.ts +76 -0
  106. package/src/activities/agent-turn.ts +2600 -340
  107. package/src/activities/api-integrations.ts +138 -0
  108. package/src/activities/browser-state-artifact-reaper.ts +120 -0
  109. package/src/activities/capabilities.ts +10 -0
  110. package/src/activities/codemode-dispatcher.ts +335 -0
  111. package/src/activities/codemode-token-renewal.ts +64 -0
  112. package/src/activities/codex-capacity.ts +54 -7
  113. package/src/activities/codex-image-generation.ts +56 -0
  114. package/src/activities/context-compaction.ts +38 -3
  115. package/src/activities/documents.ts +14 -4
  116. package/src/activities/environment.ts +54 -45
  117. package/src/activities/expiring-material-renewal.ts +1 -1
  118. package/src/activities/file-upload-reaper.ts +34 -3
  119. package/src/activities/gateway-image-generation.ts +146 -0
  120. package/src/activities/gateway-video-generation.ts +298 -0
  121. package/src/activities/generated-images.ts +860 -0
  122. package/src/activities/goals.ts +8 -3
  123. package/src/activities/google-drive-changes.ts +454 -0
  124. package/src/activities/image-generation-operation.ts +333 -0
  125. package/src/activities/image-generation-references.ts +118 -0
  126. package/src/activities/knowledge-source-sync-driver.ts +27 -0
  127. package/src/activities/knowledge-source-sync.ts +2840 -0
  128. package/src/activities/mcp-credentials.ts +1 -0
  129. package/src/activities/packs.ts +75 -152
  130. package/src/activities/parent-wake.ts +13 -1
  131. package/src/activities/retained-screenshot-reaper.ts +2 -2
  132. package/src/activities/retained-screenshots.ts +453 -28
  133. package/src/activities/rig-verification.ts +554 -43
  134. package/src/activities/run-input.ts +22 -6
  135. package/src/activities/sandbox-images.ts +167 -0
  136. package/src/activities/sandbox-lease.ts +1065 -483
  137. package/src/activities/scheduled-tasks.ts +104 -74
  138. package/src/activities/session-state.ts +22 -4
  139. package/src/activities/site-auth-maintenance.ts +269 -0
  140. package/src/activities/streaming.ts +42 -3
  141. package/src/activities/types.ts +104 -5
  142. package/src/activities/video-generation-admission.ts +303 -0
  143. package/src/activities/video-generation-credential.ts +112 -0
  144. package/src/activities/video-generation-reconciliation.ts +771 -0
  145. package/src/activities/video-media-validation.ts +332 -0
  146. package/src/activities/video-output-retention.ts +314 -0
  147. package/src/activities/video-reference-staging.ts +350 -0
  148. package/src/activities/workflow-wake.ts +2 -2
  149. package/src/activities/workspace-capture.ts +44 -10
  150. package/src/activities/xai-auth.ts +122 -0
  151. package/src/activities/xai-image-generation.ts +86 -0
  152. package/src/activities/xai-video-generation.ts +69 -0
  153. package/src/activities-control.ts +58 -0
  154. package/src/activities-turn.ts +40 -0
  155. package/src/activities.ts +53 -124
  156. package/src/activity-services.ts +62 -0
  157. package/src/artifact-materializer-entry.ts +35 -0
  158. package/src/artifact-outbox-entry.ts +29 -0
  159. package/src/concurrency.ts +484 -6
  160. package/src/editable-artifact-hint-broker.ts +235 -0
  161. package/src/editable-artifact-materializer-launcher.ts +515 -0
  162. package/src/editable-artifact-materializer-service.ts +787 -0
  163. package/src/editable-artifact-materializer-storage.ts +413 -0
  164. package/src/editable-artifact-materializer-subprocess.ts +956 -0
  165. package/src/editable-artifact-materializer.ts +1289 -0
  166. package/src/editable-artifact-outbox-dispatcher.ts +244 -0
  167. package/src/editable-artifact-outbox-service.ts +438 -0
  168. package/src/index.ts +328 -72
  169. package/src/memory-pressure-guard.ts +489 -0
  170. package/src/model-checkpoint-memory-collector.ts +123 -0
  171. package/src/model-context-contributions.ts +159 -0
  172. package/src/observability-metrics.ts +297 -13
  173. package/src/sandbox-reaper-contract.ts +73 -0
  174. package/src/sandbox-reaper-timeout.ts +79 -0
  175. package/src/sandbox-resume.ts +294 -153
  176. package/src/sandbox-routing.ts +32 -24
  177. package/src/worker-service-lifecycle.ts +80 -14
  178. package/src/workflows/activities.ts +31 -0
  179. package/src/workflows/file-upload-reaper.ts +9 -1
  180. package/src/workflows/knowledge-source-sync.ts +83 -0
  181. package/src/workflows/sandbox-reaper.ts +183 -21
  182. package/src/workflows/scheduled-tasks.ts +42 -6
  183. package/src/workflows/session.ts +20 -6
  184. package/src/workflows/site-auth-maintenance.ts +14 -0
  185. package/src/workflows/video-generation.ts +36 -0
  186. package/src/workflows.ts +18 -1
  187. package/dist/activities/toolspace-token-renewal.d.ts +0 -23
  188. package/src/activities/toolspace-token-renewal.ts +0 -64
@@ -0,0 +1,515 @@
1
+ import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
2
+ import { access, readlink, realpath, stat } from "node:fs/promises";
3
+ import { basename, dirname, isAbsolute, relative } from "node:path";
4
+
5
+ import type { VerifiedEditableArtifactProcessLauncher } from "./editable-artifact-materializer-subprocess";
6
+
7
+ const MAX_PROBE_BYTES = 16 * 1024;
8
+ const PROBE_TIMEOUT_MS = 5_000;
9
+
10
+ export type LinuxEditableArtifactLauncherOptions = Readonly<{
11
+ materializerExecutable: string;
12
+ bubblewrapExecutable: string;
13
+ prlimitExecutable: string;
14
+ runtimeRoot: string;
15
+ memoryLimitBytes: number;
16
+ cpuTimeLimitMs: number;
17
+ fileDescriptorLimit: number;
18
+ processLimit: number;
19
+ fileSizeLimitBytes: number;
20
+ probeExecutable?: string;
21
+ }>;
22
+
23
+ export type DevelopmentEditableArtifactLauncherOptions = Readonly<{
24
+ materializerExecutable: string;
25
+ explicitlyEnabled: boolean;
26
+ nodeEnvironment: string | undefined;
27
+ }>;
28
+
29
+ /**
30
+ * Current-host local development only. This deliberately reports that no OS
31
+ * sandbox, network namespace, or process resource limit is enforced. The
32
+ * caller must surface that degraded capability and can never select this path
33
+ * in production.
34
+ */
35
+ export async function createDevelopmentEditableArtifactProcessLauncher(
36
+ options: DevelopmentEditableArtifactLauncherOptions,
37
+ ): Promise<VerifiedEditableArtifactProcessLauncher> {
38
+ if (!options.explicitlyEnabled || options.nodeEnvironment === "production") {
39
+ throw new Error("Unsandboxed artifact materialization is forbidden outside development");
40
+ }
41
+ const configuredMaterializerExecutable = options.materializerExecutable;
42
+ const materializerExecutable = await developmentExecutable(options.materializerExecutable);
43
+ return Object.freeze({
44
+ identity: Object.freeze({
45
+ platform: `${process.platform}-${process.arch}-development-unsandboxed-v1`,
46
+ isolation: "subprocess",
47
+ network: "host",
48
+ officeAutomation: false,
49
+ sandboxEnforced: false,
50
+ memoryLimitBytes: 0,
51
+ cpuTimeLimitMs: 0,
52
+ fileDescriptorLimit: 0,
53
+ processLimit: 0,
54
+ fileSizeLimitBytes: 0,
55
+ }),
56
+ spawn(input) {
57
+ if (
58
+ input.executable !== configuredMaterializerExecutable &&
59
+ input.executable !== materializerExecutable
60
+ ) {
61
+ throw new Error("Development materializer differs from its verified executable");
62
+ }
63
+ return spawn(materializerExecutable, [...input.args], {
64
+ cwd: "/",
65
+ env: { ...input.environment },
66
+ stdio: ["pipe", "pipe", "pipe"],
67
+ windowsHide: true,
68
+ });
69
+ },
70
+ });
71
+ }
72
+
73
+ /**
74
+ * Concrete production launcher for Linux. Isolation facts are established by
75
+ * a parent-run behavioral probe of the actual bwrap+prlimit command, never by
76
+ * the untrusted codec child. macOS/Windows require their own native launcher
77
+ * implementation and therefore fail closed in production today.
78
+ */
79
+ export async function createLinuxEditableArtifactProcessLauncher(
80
+ options: LinuxEditableArtifactLauncherOptions,
81
+ ): Promise<VerifiedEditableArtifactProcessLauncher> {
82
+ if (process.platform !== "linux") {
83
+ throw new Error("Linux artifact materializer sandbox is unavailable on this platform");
84
+ }
85
+ if (
86
+ !Number.isSafeInteger(options.memoryLimitBytes) ||
87
+ options.memoryLimitBytes <= 0 ||
88
+ !Number.isSafeInteger(options.cpuTimeLimitMs) ||
89
+ options.cpuTimeLimitMs <= 0 ||
90
+ options.cpuTimeLimitMs % 1_000 !== 0 ||
91
+ !Number.isSafeInteger(options.fileDescriptorLimit) ||
92
+ options.fileDescriptorLimit <= 0 ||
93
+ !Number.isSafeInteger(options.processLimit) ||
94
+ options.processLimit <= 0 ||
95
+ !Number.isSafeInteger(options.fileSizeLimitBytes) ||
96
+ options.fileSizeLimitBytes <= 0
97
+ ) {
98
+ throw new Error("Artifact materializer launcher limits are invalid");
99
+ }
100
+ const bubblewrap = await trustedExecutable(options.bubblewrapExecutable, "bwrap");
101
+ const prlimit = await trustedExecutable(options.prlimitExecutable, "prlimit");
102
+ const configuredMaterializerExecutable = options.materializerExecutable;
103
+ const materializerExecutable = await trustedExecutable(
104
+ options.materializerExecutable,
105
+ basename(options.materializerExecutable),
106
+ );
107
+ const runtimeRoot = await trustedRuntimeRoot(options.runtimeRoot);
108
+ const cpuSeconds = options.cpuTimeLimitMs / 1_000;
109
+
110
+ const spawnIsolated = (input: {
111
+ executable: string;
112
+ args: readonly string[];
113
+ environment: Readonly<Record<string, string>>;
114
+ }): ChildProcessWithoutNullStreams => {
115
+ if (!isAbsolute(input.executable)) throw new Error("Sandbox target must be absolute");
116
+ const sandboxArguments = linuxEditableArtifactSandboxArguments({
117
+ executable: input.executable,
118
+ args: input.args,
119
+ runtimeRoot,
120
+ scratchLimitBytes: options.fileSizeLimitBytes,
121
+ });
122
+ return spawn(
123
+ prlimit,
124
+ [
125
+ ...linuxEditableArtifactPrlimitArguments({
126
+ memoryLimitBytes: options.memoryLimitBytes,
127
+ cpuSeconds,
128
+ fileDescriptorLimit: options.fileDescriptorLimit,
129
+ processLimit: options.processLimit,
130
+ fileSizeLimitBytes: options.fileSizeLimitBytes,
131
+ }),
132
+ "--",
133
+ bubblewrap,
134
+ ...sandboxArguments,
135
+ ],
136
+ {
137
+ cwd: "/",
138
+ env: { ...input.environment },
139
+ stdio: ["pipe", "pipe", "pipe"],
140
+ windowsHide: true,
141
+ },
142
+ );
143
+ };
144
+
145
+ const spawnMaterializer = (input: {
146
+ executable: string;
147
+ args: readonly string[];
148
+ environment: Readonly<Record<string, string>>;
149
+ }): ChildProcessWithoutNullStreams => {
150
+ if (
151
+ input.executable !== configuredMaterializerExecutable &&
152
+ input.executable !== materializerExecutable
153
+ ) {
154
+ throw new Error("Sandbox target differs from the verified materializer executable");
155
+ }
156
+ assertRuntimeEnvironmentConfined(input.environment, runtimeRoot);
157
+ return spawnIsolated({ ...input, executable: materializerExecutable });
158
+ };
159
+
160
+ const probeExecutable = await trustedExecutable(
161
+ options.probeExecutable ?? process.execPath,
162
+ basename(process.execPath),
163
+ );
164
+ const parentNetworkNamespace = await readlink("/proc/self/ns/net");
165
+ const probe = spawnIsolated({
166
+ executable: probeExecutable,
167
+ args: [
168
+ "-e",
169
+ [
170
+ 'const fs=require("node:fs")',
171
+ 'const net=fs.readlinkSync("/proc/self/ns/net")',
172
+ 'const limits=fs.readFileSync("/proc/self/limits","utf8")',
173
+ 'const rootEntries=fs.readdirSync("/").sort()',
174
+ 'let rootWritable=false;try{fs.writeFileSync("/opengeni-root-write-probe","x");rootWritable=true;fs.unlinkSync("/opengeni-root-write-probe")}catch{}',
175
+ 'let scratchWritable=false;try{fs.writeFileSync("/tmp/opengeni-scratch-write-probe","x");scratchWritable=true;fs.unlinkSync("/tmp/opengeni-scratch-write-probe")}catch{}',
176
+ "process.stdout.write(JSON.stringify({net,limits,rootEntries,rootWritable,scratchWritable}))",
177
+ ].join(";"),
178
+ ],
179
+ environment: Object.freeze({ LANG: "C", LC_ALL: "C", TZ: "UTC" }),
180
+ });
181
+ probe.stdin.end();
182
+ const timeout = setTimeout(() => terminateChild(probe), PROBE_TIMEOUT_MS);
183
+ timeout.unref?.();
184
+ let stdout: Uint8Array;
185
+ let stderr: Uint8Array;
186
+ let status: { code: number | null; signal: NodeJS.Signals | null };
187
+ try {
188
+ [stdout, stderr, status] = await Promise.all([
189
+ boundedStream(probe.stdout),
190
+ boundedStream(probe.stderr),
191
+ waitForExit(probe),
192
+ ]);
193
+ } finally {
194
+ clearTimeout(timeout);
195
+ terminateChild(probe);
196
+ }
197
+ if (status.code !== 0 || status.signal !== null || stderr.byteLength !== 0) {
198
+ throw new Error("Artifact materializer sandbox behavioral probe failed");
199
+ }
200
+ const parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(stdout)) as unknown;
201
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
202
+ throw new Error("Artifact materializer sandbox probe returned invalid evidence");
203
+ }
204
+ const evidence = parsed as Record<string, unknown>;
205
+ const expectedRootEntries = linuxEditableArtifactSandboxRootEntries({
206
+ executable: probeExecutable,
207
+ runtimeRoot,
208
+ });
209
+ if (
210
+ typeof evidence.net !== "string" ||
211
+ evidence.net === parentNetworkNamespace ||
212
+ typeof evidence.limits !== "string" ||
213
+ !hasResourceLimit(evidence.limits, "Max cpu time", String(cpuSeconds)) ||
214
+ !hasResourceLimit(evidence.limits, "Max address space", String(options.memoryLimitBytes)) ||
215
+ !hasResourceLimit(evidence.limits, "Max open files", String(options.fileDescriptorLimit)) ||
216
+ !hasResourceLimit(evidence.limits, "Max processes", String(options.processLimit)) ||
217
+ !hasResourceLimit(evidence.limits, "Max file size", String(options.fileSizeLimitBytes)) ||
218
+ !sameStringList(evidence.rootEntries, expectedRootEntries) ||
219
+ evidence.rootWritable !== false ||
220
+ evidence.scratchWritable !== true
221
+ ) {
222
+ throw new Error("Artifact materializer sandbox enforcement could not be proved");
223
+ }
224
+
225
+ return Object.freeze({
226
+ identity: Object.freeze({
227
+ platform: `linux-${process.arch}-bwrap-prlimit-v1`,
228
+ isolation: "subprocess",
229
+ network: "denied",
230
+ officeAutomation: false,
231
+ sandboxEnforced: true,
232
+ memoryLimitBytes: options.memoryLimitBytes,
233
+ cpuTimeLimitMs: options.cpuTimeLimitMs,
234
+ fileDescriptorLimit: options.fileDescriptorLimit,
235
+ processLimit: options.processLimit,
236
+ fileSizeLimitBytes: options.fileSizeLimitBytes,
237
+ }),
238
+ spawn: spawnMaterializer,
239
+ });
240
+ }
241
+
242
+ export function linuxEditableArtifactSandboxArguments(
243
+ input: Readonly<{
244
+ executable: string;
245
+ args: readonly string[];
246
+ runtimeRoot: string;
247
+ scratchLimitBytes: number;
248
+ }>,
249
+ ): readonly string[] {
250
+ if (
251
+ !isAbsolute(input.executable) ||
252
+ !isAbsolute(input.runtimeRoot) ||
253
+ !Number.isSafeInteger(input.scratchLimitBytes) ||
254
+ input.scratchLimitBytes <= 0
255
+ ) {
256
+ throw new Error("Artifact materializer sandbox paths must be absolute");
257
+ }
258
+ const parentDirectories = sandboxParentDirectories([input.executable, input.runtimeRoot]);
259
+ return Object.freeze([
260
+ "--die-with-parent",
261
+ "--new-session",
262
+ "--unshare-all",
263
+ ...parentDirectories.flatMap((path) => ["--dir", path]),
264
+ "--ro-bind",
265
+ "/usr/lib",
266
+ "/usr/lib",
267
+ "--ro-bind-try",
268
+ "/usr/lib64",
269
+ "/usr/lib64",
270
+ "--ro-bind-try",
271
+ "/usr/share",
272
+ "/usr/share",
273
+ "--symlink",
274
+ "usr/lib",
275
+ "/lib",
276
+ "--symlink",
277
+ "usr/lib64",
278
+ "/lib64",
279
+ "--dir",
280
+ "/etc",
281
+ "--ro-bind-try",
282
+ "/etc/ld.so.cache",
283
+ "/etc/ld.so.cache",
284
+ "--ro-bind-try",
285
+ "/etc/ld.so.conf",
286
+ "/etc/ld.so.conf",
287
+ "--ro-bind-try",
288
+ "/etc/ld.so.conf.d",
289
+ "/etc/ld.so.conf.d",
290
+ "--ro-bind",
291
+ input.runtimeRoot,
292
+ input.runtimeRoot,
293
+ "--ro-bind",
294
+ input.executable,
295
+ input.executable,
296
+ "--proc",
297
+ "/proc",
298
+ "--dev",
299
+ "/dev",
300
+ "--size",
301
+ String(input.scratchLimitBytes),
302
+ "--tmpfs",
303
+ "/tmp",
304
+ "--remount-ro",
305
+ "/",
306
+ "--chdir",
307
+ "/",
308
+ "--",
309
+ input.executable,
310
+ ...input.args,
311
+ ]);
312
+ }
313
+
314
+ export function linuxEditableArtifactPrlimitArguments(
315
+ input: Readonly<{
316
+ memoryLimitBytes: number;
317
+ cpuSeconds: number;
318
+ fileDescriptorLimit: number;
319
+ processLimit: number;
320
+ fileSizeLimitBytes: number;
321
+ }>,
322
+ ): readonly string[] {
323
+ return Object.freeze([
324
+ `--as=${input.memoryLimitBytes}`,
325
+ `--cpu=${input.cpuSeconds}`,
326
+ `--nofile=${input.fileDescriptorLimit}`,
327
+ `--nproc=${input.processLimit}`,
328
+ `--fsize=${input.fileSizeLimitBytes}`,
329
+ ]);
330
+ }
331
+
332
+ export function linuxEditableArtifactSandboxRootEntries(
333
+ input: Readonly<{
334
+ executable: string;
335
+ runtimeRoot: string;
336
+ }>,
337
+ ): readonly string[] {
338
+ const entries = new Set(["dev", "etc", "lib", "lib64", "proc", "tmp", "usr"]);
339
+ for (const path of [input.executable, input.runtimeRoot]) {
340
+ const topLevel = path.split("/").find((part) => part.length > 0);
341
+ if (topLevel) entries.add(topLevel);
342
+ }
343
+ return Object.freeze([...entries].sort());
344
+ }
345
+
346
+ async function trustedExecutable(input: string, expectedBasename: string): Promise<string> {
347
+ if (!isAbsolute(input) || basename(input) !== expectedBasename) {
348
+ throw new Error(`Artifact materializer ${expectedBasename} path is invalid`);
349
+ }
350
+ const canonical = await realpath(input);
351
+ const metadata = await stat(canonical);
352
+ await access(canonical, 1);
353
+ if (!metadata.isFile() || metadata.uid !== 0 || (metadata.mode & 0o022) !== 0) {
354
+ throw new Error(`Artifact materializer ${expectedBasename} is not a trusted executable`);
355
+ }
356
+ return canonical;
357
+ }
358
+
359
+ async function trustedRuntimeRoot(input: string): Promise<string> {
360
+ if (!isAbsolute(input) || broadRuntimeRoot(input)) {
361
+ throw new Error("Artifact materializer runtime root is invalid");
362
+ }
363
+ const canonical = await realpath(input);
364
+ const metadata = await stat(canonical);
365
+ if (
366
+ canonical !== input ||
367
+ !metadata.isDirectory() ||
368
+ metadata.uid !== 0 ||
369
+ (metadata.mode & 0o022) !== 0
370
+ ) {
371
+ throw new Error("Artifact materializer runtime root is not a trusted directory");
372
+ }
373
+ return canonical;
374
+ }
375
+
376
+ function broadRuntimeRoot(input: string): boolean {
377
+ if (input.split("/").filter(Boolean).length < 2) return true;
378
+ return new Set([
379
+ "/",
380
+ "/app",
381
+ "/bin",
382
+ "/dev",
383
+ "/etc",
384
+ "/home",
385
+ "/lib",
386
+ "/lib64",
387
+ "/media",
388
+ "/mnt",
389
+ "/opt",
390
+ "/proc",
391
+ "/root",
392
+ "/run",
393
+ "/sbin",
394
+ "/srv",
395
+ "/sys",
396
+ "/tmp",
397
+ "/usr",
398
+ "/usr/local",
399
+ "/var",
400
+ "/workspace",
401
+ ]).has(input);
402
+ }
403
+
404
+ function assertRuntimeEnvironmentConfined(
405
+ environment: Readonly<Record<string, string>>,
406
+ runtimeRoot: string,
407
+ ): void {
408
+ for (const name of [
409
+ "OPENGENI_ARTIFACT_RUNTIME_MANIFEST",
410
+ "OPENGENI_ARTIFACT_TOOL_ENTRY",
411
+ ] as const) {
412
+ const path = environment[name];
413
+ if (!path || !isPathInside(runtimeRoot, path)) {
414
+ throw new Error("Artifact materializer runtime environment escapes its verified root");
415
+ }
416
+ }
417
+ }
418
+
419
+ function isPathInside(root: string, path: string): boolean {
420
+ if (!isAbsolute(path)) return false;
421
+ const fromRoot = relative(root, path);
422
+ return (
423
+ fromRoot.length > 0 &&
424
+ fromRoot !== ".." &&
425
+ !fromRoot.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) &&
426
+ !isAbsolute(fromRoot)
427
+ );
428
+ }
429
+
430
+ function sandboxParentDirectories(paths: readonly string[]): readonly string[] {
431
+ const directories = new Set<string>();
432
+ for (const path of paths) {
433
+ let parent = dirname(path);
434
+ while (parent !== "/" && parent !== ".") {
435
+ directories.add(parent);
436
+ parent = dirname(parent);
437
+ }
438
+ }
439
+ return [...directories].sort((left, right) => {
440
+ const depth = left.split("/").length - right.split("/").length;
441
+ return depth === 0 ? left.localeCompare(right) : depth;
442
+ });
443
+ }
444
+
445
+ function sameStringList(value: unknown, expected: readonly string[]): boolean {
446
+ return (
447
+ Array.isArray(value) &&
448
+ value.length === expected.length &&
449
+ value.every((entry, index) => entry === expected[index])
450
+ );
451
+ }
452
+
453
+ async function developmentExecutable(input: string): Promise<string> {
454
+ if (!isAbsolute(input) || !/^opengeni-artifact-materializer(?:\.exe)?$/u.test(basename(input))) {
455
+ throw new Error("Development artifact materializer path is invalid");
456
+ }
457
+ const canonical = await realpath(input);
458
+ const metadata = await stat(canonical);
459
+ await access(canonical, 1);
460
+ if (!metadata.isFile()) throw new Error("Development artifact materializer is not executable");
461
+ return canonical;
462
+ }
463
+
464
+ function hasResourceLimit(limits: string, name: string, expected: string): boolean {
465
+ const line = limits.split("\n").find((candidate) => candidate.startsWith(name));
466
+ if (!line) return false;
467
+ const fields = line.trim().split(/\s{2,}/u);
468
+ return fields[1] === expected && fields[2] === expected;
469
+ }
470
+
471
+ async function boundedStream(
472
+ stream: NodeJS.ReadableStream & AsyncIterable<Buffer | string>,
473
+ ): Promise<Uint8Array> {
474
+ const chunks: Uint8Array[] = [];
475
+ let total = 0;
476
+ for await (const value of stream) {
477
+ const chunk = typeof value === "string" ? Buffer.from(value) : value;
478
+ total += chunk.byteLength;
479
+ if (total > MAX_PROBE_BYTES) throw new Error("Artifact materializer sandbox probe overflowed");
480
+ chunks.push(new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength).slice());
481
+ }
482
+ const output = new Uint8Array(total);
483
+ let offset = 0;
484
+ for (const chunk of chunks) {
485
+ output.set(chunk, offset);
486
+ offset += chunk.byteLength;
487
+ }
488
+ return output;
489
+ }
490
+
491
+ function waitForExit(
492
+ child: ChildProcessWithoutNullStreams,
493
+ ): Promise<{ code: number | null; signal: NodeJS.Signals | null }> {
494
+ if (child.exitCode !== null || child.signalCode !== null) {
495
+ return Promise.resolve({ code: child.exitCode, signal: child.signalCode });
496
+ }
497
+ return new Promise((resolve, reject) => {
498
+ const onError = (error: Error) => {
499
+ child.removeListener("exit", onExit);
500
+ reject(error);
501
+ };
502
+ const onExit = (code: number | null, signal: NodeJS.Signals | null) => {
503
+ child.removeListener("error", onError);
504
+ resolve({ code, signal });
505
+ };
506
+ child.once("error", onError);
507
+ child.once("exit", onExit);
508
+ });
509
+ }
510
+
511
+ function terminateChild(child: ChildProcessWithoutNullStreams): void {
512
+ if (child.exitCode !== null || child.signalCode !== null) return;
513
+ child.stdin.destroy();
514
+ child.kill("SIGKILL");
515
+ }