@opengeni/worker-bundle 0.16.21 → 0.17.2

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 (180) hide show
  1. package/dist/activities/agent-turn.d.ts +145 -32
  2. package/dist/activities/api-integrations.d.ts +21 -0
  3. package/dist/activities/codemode-dispatcher.d.ts +35 -0
  4. package/dist/activities/codemode-token-renewal.d.ts +23 -0
  5. package/dist/activities/codex-capacity.d.ts +5 -5
  6. package/dist/activities/codex-image-generation.d.ts +21 -0
  7. package/dist/activities/context-compaction.d.ts +3 -0
  8. package/dist/activities/documents.d.ts +3 -2
  9. package/dist/activities/environment.d.ts +11 -7
  10. package/dist/activities/expiring-material-renewal.d.ts +5 -3
  11. package/dist/activities/file-upload-reaper.d.ts +7 -2
  12. package/dist/activities/gateway-image-generation.d.ts +39 -0
  13. package/dist/activities/gateway-video-generation.d.ts +53 -0
  14. package/dist/activities/generated-images.d.ts +112 -0
  15. package/dist/activities/git-credential-renewal.d.ts +2 -2
  16. package/dist/activities/goals.d.ts +2 -2
  17. package/dist/activities/google-drive-changes.d.ts +99 -0
  18. package/dist/activities/image-generation-operation.d.ts +74 -0
  19. package/dist/activities/image-generation-references.d.ts +25 -0
  20. package/dist/activities/knowledge-source-sync-driver.d.ts +23 -0
  21. package/dist/activities/knowledge-source-sync.d.ts +75 -0
  22. package/dist/activities/packs.d.ts +13 -26
  23. package/dist/activities/parent-wake.d.ts +1 -1
  24. package/dist/activities/retained-screenshot-reaper.d.ts +32 -0
  25. package/dist/activities/retained-screenshots.d.ts +129 -0
  26. package/dist/activities/rig-verification.d.ts +82 -5
  27. package/dist/activities/run-credential-renewal.d.ts +2 -2
  28. package/dist/activities/run-input.d.ts +5 -1
  29. package/dist/activities/sandbox-images.d.ts +14 -0
  30. package/dist/activities/sandbox-lease.d.ts +47 -9
  31. package/dist/activities/scheduled-tasks.d.ts +2 -2
  32. package/dist/activities/session-state.d.ts +4 -4
  33. package/dist/activities/streaming.d.ts +1 -1
  34. package/dist/activities/types.d.ts +71 -5
  35. package/dist/activities/video-generation-admission.d.ts +38 -0
  36. package/dist/activities/video-generation-credential.d.ts +7 -0
  37. package/dist/activities/video-generation-reconciliation.d.ts +13 -0
  38. package/dist/activities/video-media-validation.d.ts +34 -0
  39. package/dist/activities/video-output-retention.d.ts +36 -0
  40. package/dist/activities/video-reference-staging.d.ts +49 -0
  41. package/dist/activities/workflow-wake.d.ts +2 -2
  42. package/dist/activities/workspace-capture.d.ts +11 -1
  43. package/dist/activities-control-44KBWLSM.js +6885 -0
  44. package/dist/activities-control-44KBWLSM.js.map +1 -0
  45. package/dist/activities-control.d.ts +289 -0
  46. package/dist/activities-turn-K4CEDEGJ.js +14675 -0
  47. package/dist/activities-turn-K4CEDEGJ.js.map +1 -0
  48. package/dist/activities-turn.d.ts +17 -0
  49. package/dist/activities.d.ts +130 -147
  50. package/dist/activity-services.d.ts +10 -0
  51. package/dist/artifact-materializer-entry.d.ts +6 -0
  52. package/dist/artifact-materializer-entry.js +2662 -0
  53. package/dist/artifact-materializer-entry.js.map +1 -0
  54. package/dist/artifact-outbox-entry.d.ts +2 -0
  55. package/dist/artifact-outbox-entry.js +681 -0
  56. package/dist/artifact-outbox-entry.js.map +1 -0
  57. package/dist/chunk-E3RI3I33.js +828 -0
  58. package/dist/chunk-E3RI3I33.js.map +1 -0
  59. package/dist/chunk-GRFQTTSQ.js +448 -0
  60. package/dist/chunk-GRFQTTSQ.js.map +1 -0
  61. package/dist/chunk-KKCRGAGZ.js +3091 -0
  62. package/dist/chunk-KKCRGAGZ.js.map +1 -0
  63. package/dist/{chunk-BJUW5LCM.js → chunk-RAMNYSAW.js} +15 -12
  64. package/dist/chunk-RAMNYSAW.js.map +1 -0
  65. package/dist/concurrency.d.ts +108 -5
  66. package/dist/editable-artifact-hint-broker.d.ts +49 -0
  67. package/dist/editable-artifact-materializer-launcher.d.ts +49 -0
  68. package/dist/editable-artifact-materializer-service.d.ts +108 -0
  69. package/dist/editable-artifact-materializer-storage.d.ts +12 -0
  70. package/dist/editable-artifact-materializer-subprocess.d.ts +50 -0
  71. package/dist/editable-artifact-materializer.d.ts +262 -0
  72. package/dist/editable-artifact-outbox-dispatcher.d.ts +44 -0
  73. package/dist/editable-artifact-outbox-service.d.ts +70 -0
  74. package/dist/host-export.d.ts +1 -1
  75. package/dist/host-export.js +1 -1
  76. package/dist/index.d.ts +176 -10
  77. package/dist/index.js +675 -16460
  78. package/dist/index.js.map +1 -1
  79. package/dist/memory-pressure-guard.d.ts +57 -0
  80. package/dist/model-checkpoint-memory-collector.d.ts +22 -0
  81. package/dist/observability-metrics.d.ts +33 -0
  82. package/dist/sandbox-reaper-contract.d.ts +40 -0
  83. package/dist/sandbox-reaper-timeout.d.ts +14 -0
  84. package/dist/sandbox-resume.d.ts +40 -7
  85. package/dist/sandbox-routing.d.ts +13 -6
  86. package/dist/worker-service-lifecycle.d.ts +6 -2
  87. package/dist/workflow-bundle.js +1044 -363
  88. package/dist/workflows/activities.d.ts +7 -1
  89. package/dist/workflows/document-index.d.ts +1 -1
  90. package/dist/workflows/knowledge-source-sync.d.ts +13 -0
  91. package/dist/workflows/rig-verification.d.ts +1 -1
  92. package/dist/workflows/sandbox-reaper.d.ts +8 -0
  93. package/dist/workflows/scheduled-tasks.d.ts +1 -1
  94. package/dist/workflows/session.d.ts +2 -2
  95. package/dist/workflows/video-generation.d.ts +10 -0
  96. package/dist/workflows/workflow-wake.d.ts +1 -1
  97. package/dist/workflows.d.ts +9 -7
  98. package/package.json +34 -15
  99. package/src/activities/agent-turn.ts +1905 -559
  100. package/src/activities/api-integrations.ts +138 -0
  101. package/src/activities/codemode-dispatcher.ts +335 -0
  102. package/src/activities/codemode-token-renewal.ts +64 -0
  103. package/src/activities/codex-capacity.ts +16 -7
  104. package/src/activities/codex-image-generation.ts +56 -0
  105. package/src/activities/codex-rotation.ts +19 -5
  106. package/src/activities/context-compaction.ts +47 -6
  107. package/src/activities/documents.ts +14 -4
  108. package/src/activities/environment.ts +52 -60
  109. package/src/activities/expiring-material-renewal.ts +16 -7
  110. package/src/activities/file-upload-reaper.ts +34 -3
  111. package/src/activities/gateway-image-generation.ts +146 -0
  112. package/src/activities/gateway-video-generation.ts +298 -0
  113. package/src/activities/generated-images.ts +860 -0
  114. package/src/activities/git-credential-renewal.ts +3 -3
  115. package/src/activities/goals.ts +6 -2
  116. package/src/activities/google-drive-changes.ts +454 -0
  117. package/src/activities/image-generation-operation.ts +333 -0
  118. package/src/activities/image-generation-references.ts +118 -0
  119. package/src/activities/knowledge-source-sync-driver.ts +27 -0
  120. package/src/activities/knowledge-source-sync.ts +2840 -0
  121. package/src/activities/mcp-credentials.ts +1 -0
  122. package/src/activities/packs.ts +55 -55
  123. package/src/activities/recording.ts +4 -5
  124. package/src/activities/retained-screenshot-reaper.ts +202 -0
  125. package/src/activities/retained-screenshots.ts +1317 -0
  126. package/src/activities/rig-verification.ts +567 -77
  127. package/src/activities/run-credential-renewal.ts +9 -2
  128. package/src/activities/run-input.ts +40 -10
  129. package/src/activities/sandbox-images.ts +167 -0
  130. package/src/activities/sandbox-lease.ts +1065 -483
  131. package/src/activities/scheduled-tasks.ts +96 -7
  132. package/src/activities/session-state.ts +4 -4
  133. package/src/activities/streaming.ts +42 -3
  134. package/src/activities/types.ts +87 -5
  135. package/src/activities/video-generation-admission.ts +270 -0
  136. package/src/activities/video-generation-credential.ts +34 -0
  137. package/src/activities/video-generation-reconciliation.ts +578 -0
  138. package/src/activities/video-media-validation.ts +326 -0
  139. package/src/activities/video-output-retention.ts +314 -0
  140. package/src/activities/video-reference-staging.ts +263 -0
  141. package/src/activities/workflow-wake.ts +2 -2
  142. package/src/activities/workspace-capture.ts +77 -13
  143. package/src/activities-control.ts +54 -0
  144. package/src/activities-turn.ts +40 -0
  145. package/src/activities.ts +50 -118
  146. package/src/activity-services.ts +62 -0
  147. package/src/artifact-materializer-entry.ts +35 -0
  148. package/src/artifact-outbox-entry.ts +29 -0
  149. package/src/concurrency.ts +484 -6
  150. package/src/editable-artifact-hint-broker.ts +235 -0
  151. package/src/editable-artifact-materializer-launcher.ts +515 -0
  152. package/src/editable-artifact-materializer-service.ts +787 -0
  153. package/src/editable-artifact-materializer-storage.ts +413 -0
  154. package/src/editable-artifact-materializer-subprocess.ts +956 -0
  155. package/src/editable-artifact-materializer.ts +1289 -0
  156. package/src/editable-artifact-outbox-dispatcher.ts +244 -0
  157. package/src/editable-artifact-outbox-service.ts +438 -0
  158. package/src/host-export-pump.ts +28 -11
  159. package/src/http.ts +3 -6
  160. package/src/index.ts +277 -72
  161. package/src/memory-pressure-guard.ts +489 -0
  162. package/src/model-checkpoint-memory-collector.ts +116 -0
  163. package/src/observability-metrics.ts +202 -7
  164. package/src/sandbox-reaper-contract.ts +73 -0
  165. package/src/sandbox-reaper-timeout.ts +79 -0
  166. package/src/sandbox-resume.ts +331 -157
  167. package/src/sandbox-routing.ts +49 -39
  168. package/src/worker-service-lifecycle.ts +82 -12
  169. package/src/workflows/activities.ts +30 -0
  170. package/src/workflows/file-upload-reaper.ts +6 -1
  171. package/src/workflows/knowledge-source-sync.ts +83 -0
  172. package/src/workflows/sandbox-reaper.ts +183 -21
  173. package/src/workflows/scheduled-tasks.ts +42 -6
  174. package/src/workflows/video-generation.ts +36 -0
  175. package/src/workflows.ts +17 -1
  176. package/dist/activities/redaction.d.ts +0 -1
  177. package/dist/activities/toolspace-token-renewal.d.ts +0 -23
  178. package/dist/chunk-BJUW5LCM.js.map +0 -1
  179. package/src/activities/redaction.ts +0 -9
  180. package/src/activities/toolspace-token-renewal.ts +0 -57
@@ -0,0 +1,413 @@
1
+ import { createHash } from "node:crypto";
2
+ import { chmod, mkdtemp, open, rm, type FileHandle } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+
6
+ import {
7
+ BoundedObjectReadError,
8
+ createObjectStorageBoundedPorts,
9
+ type BoundedImmutableObjectWritePort,
10
+ type BoundedObjectReadPort,
11
+ type ObjectStorage,
12
+ } from "@opengeni/storage";
13
+
14
+ import {
15
+ EditableArtifactMaterializerPermanentError,
16
+ mimeTypeForFormat,
17
+ type EditableArtifactMaterializationFormat,
18
+ type EditableArtifactMaterializationMimeType,
19
+ type EditableArtifactMaterializationSemanticVerifierPort,
20
+ type EditableArtifactMaterializationVerifierPort,
21
+ type VerifiedEditableArtifactMaterialization,
22
+ } from "./editable-artifact-materializer";
23
+
24
+ const SHA256 = /^sha256:[0-9a-f]{64}$/u;
25
+ const SNAPSHOT_KEY_PREFIX = "editable-artifacts/snapshots/sha256/";
26
+ const MATERIALIZATION_KEY_PREFIX = "editable-artifacts/materializations/v1/sha256/";
27
+ const SEMANTIC_VERIFIER_CHUNK_BYTES = 1024 * 1024;
28
+ const ZIP_EOCD_SEARCH_BYTES = 65_557;
29
+ const MAX_ZIP_ENTRY_NAME_BYTES = 4_096;
30
+ const MAX_ZIP_TOTAL_NAME_BYTES = 16 * 1024 * 1024;
31
+
32
+ /** Provider-versioned, immutable range reader. No whole-object fallback. */
33
+ export function createEditableArtifactObjectStorageReader(
34
+ storage: ObjectStorage,
35
+ ): BoundedObjectReadPort {
36
+ return createObjectStorageBoundedPorts(storage, { keyPrefix: SNAPSHOT_KEY_PREFIX }).read;
37
+ }
38
+
39
+ /** Conditional-create digest writer with independent version-pinned readback. */
40
+ export function createEditableArtifactObjectStorageWriter(
41
+ storage: ObjectStorage,
42
+ ): BoundedImmutableObjectWritePort {
43
+ return createObjectStorageBoundedPorts(storage, {
44
+ keyPrefix: MATERIALIZATION_KEY_PREFIX,
45
+ }).write;
46
+ }
47
+
48
+ /**
49
+ * Independent immutable readback + structural parser. When the native source
50
+ * projection supplies a semantic digest, a second isolated codec process must
51
+ * re-import the published Office bytes and prove that digest before success.
52
+ */
53
+ export function createEditableArtifactObjectStorageVerifier(
54
+ storage: ObjectStorage,
55
+ semanticVerifier: EditableArtifactMaterializationSemanticVerifierPort,
56
+ ): EditableArtifactMaterializationVerifierPort {
57
+ const read = createObjectStorageBoundedPorts(storage, {
58
+ keyPrefix: MATERIALIZATION_KEY_PREFIX,
59
+ }).read;
60
+ return Object.freeze({
61
+ async verify(
62
+ input: Parameters<EditableArtifactMaterializationVerifierPort["verify"]>[0],
63
+ ): Promise<VerifiedEditableArtifactMaterialization> {
64
+ validateReference(input.objectReference);
65
+ validateLimit(input.maxBytes);
66
+ if (
67
+ !Number.isSafeInteger(input.expectedByteSize) ||
68
+ input.expectedByteSize <= 0 ||
69
+ input.expectedByteSize > input.maxBytes ||
70
+ !SHA256.test(input.expectedContentHash)
71
+ ) {
72
+ throw new BoundedObjectReadError("invalid_request");
73
+ }
74
+ throwIfAborted(input.signal);
75
+ const stagingDirectory = await mkdtemp(join(tmpdir(), "opengeni-artifact-verify-"));
76
+ const stagingPath = join(stagingDirectory, "payload");
77
+ let stagingHandle: FileHandle | null = null;
78
+ try {
79
+ await chmod(stagingDirectory, 0o700);
80
+ stagingHandle = await open(stagingPath, "wx", 0o600);
81
+ const reader = await read.open({
82
+ opaqueReference: input.objectReference,
83
+ maxBytes: input.maxBytes,
84
+ expectedByteSize: input.expectedByteSize,
85
+ signal: input.signal,
86
+ });
87
+ try {
88
+ if (reader.contentType !== undefined && reader.contentType !== input.expectedMimeType) {
89
+ throw new BoundedObjectReadError("object_changed");
90
+ }
91
+ const digest = createHash("sha256");
92
+ let offset = 0;
93
+ for await (const chunk of reader.chunks({ signal: input.signal })) {
94
+ if (offset + chunk.byteLength > input.expectedByteSize) {
95
+ throw new BoundedObjectReadError("object_changed");
96
+ }
97
+ await writeAll(stagingHandle, chunk, offset);
98
+ digest.update(chunk);
99
+ offset += chunk.byteLength;
100
+ }
101
+ if (
102
+ offset !== input.expectedByteSize ||
103
+ `sha256:${digest.digest("hex")}` !== input.expectedContentHash
104
+ ) {
105
+ throw new BoundedObjectReadError("object_changed");
106
+ }
107
+ await reader.assertUnchanged(input.signal);
108
+ } finally {
109
+ await reader.close();
110
+ }
111
+ await stagingHandle.close();
112
+ stagingHandle = null;
113
+ await verifyFormat(
114
+ stagingPath,
115
+ input.expectedByteSize,
116
+ input.format,
117
+ input.expectedMimeType,
118
+ input.signal,
119
+ );
120
+ try {
121
+ await semanticVerifier.verify({
122
+ format: input.format,
123
+ codecId: input.codecId,
124
+ codecVersion: input.codecVersion,
125
+ expectedSemanticHash: input.expectedSemanticHash,
126
+ byteSize: input.expectedByteSize,
127
+ chunks: fileChunks(stagingPath, input.expectedByteSize, input.signal),
128
+ signal: input.signal,
129
+ });
130
+ } catch (error) {
131
+ throwIfAborted(input.signal);
132
+ preserveKernelCompatibilityFailure(error);
133
+ throw new BoundedObjectReadError("object_changed");
134
+ }
135
+ throwIfAborted(input.signal);
136
+ return Object.freeze({
137
+ objectReference: input.objectReference,
138
+ byteSize: input.expectedByteSize,
139
+ contentHash: input.expectedContentHash,
140
+ mimeType: input.expectedMimeType,
141
+ format: input.format,
142
+ codecId: input.codecId,
143
+ codecVersion: input.codecVersion,
144
+ });
145
+ } finally {
146
+ if (stagingHandle) await stagingHandle.close().catch(() => undefined);
147
+ await rm(stagingDirectory, { recursive: true, force: true });
148
+ }
149
+ },
150
+ });
151
+ }
152
+
153
+ async function verifyFormat(
154
+ path: string,
155
+ byteSize: number,
156
+ format: EditableArtifactMaterializationFormat,
157
+ mimeType: EditableArtifactMaterializationMimeType,
158
+ signal: AbortSignal | undefined,
159
+ ): Promise<void> {
160
+ if (mimeType !== mimeTypeForFormat(format)) {
161
+ throw new BoundedObjectReadError("object_changed");
162
+ }
163
+ const handle = await open(path, "r");
164
+ try {
165
+ throwIfAborted(signal);
166
+ switch (format) {
167
+ case "xlsx":
168
+ await assertOfficePackage(handle, byteSize, "xl/workbook.xml", signal);
169
+ break;
170
+ case "pptx":
171
+ await assertOfficePackage(handle, byteSize, "ppt/presentation.xml", signal);
172
+ break;
173
+ case "docx":
174
+ await assertOfficePackage(handle, byteSize, "word/document.xml", signal);
175
+ break;
176
+ case "pdf": {
177
+ const start = await readExact(handle, 0, 5);
178
+ const end = await readExact(handle, byteSize - 5, 5);
179
+ if (!startsWithAscii(start, "%PDF-") || !startsWithAscii(end, "%%EOF")) {
180
+ throw new Error("invalid PDF framing");
181
+ }
182
+ break;
183
+ }
184
+ case "png":
185
+ if (
186
+ !equalPrefix(
187
+ await readExact(handle, 0, 8),
188
+ [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a],
189
+ )
190
+ ) {
191
+ throw new Error("invalid PNG signature");
192
+ }
193
+ break;
194
+ case "webp": {
195
+ const header = await readExact(handle, 0, 12);
196
+ if (!startsWithAscii(header, "RIFF") || !asciiAt(header, 8, "WEBP")) {
197
+ throw new Error("invalid WebP signature");
198
+ }
199
+ break;
200
+ }
201
+ }
202
+ } catch {
203
+ throwIfAborted(signal);
204
+ throw new BoundedObjectReadError("object_changed");
205
+ } finally {
206
+ await handle.close();
207
+ }
208
+ }
209
+
210
+ async function assertOfficePackage(
211
+ handle: FileHandle,
212
+ byteSize: number,
213
+ requiredPart: string,
214
+ signal: AbortSignal | undefined,
215
+ ): Promise<void> {
216
+ if (!equalPrefix(await readExact(handle, 0, 4), [0x50, 0x4b, 0x03, 0x04])) {
217
+ throw new Error("invalid ZIP");
218
+ }
219
+ const tailSize = Math.min(byteSize, ZIP_EOCD_SEARCH_BYTES);
220
+ const tail = await readExact(handle, byteSize - tailSize, tailSize);
221
+ const eocdInTail = findEndOfCentralDirectory(tail);
222
+ const eocd = byteSize - tailSize + eocdInTail;
223
+ const view = new DataView(tail.buffer, tail.byteOffset, tail.byteLength);
224
+ const disk = view.getUint16(eocdInTail + 4, true);
225
+ const centralDisk = view.getUint16(eocdInTail + 6, true);
226
+ const diskEntries = view.getUint16(eocdInTail + 8, true);
227
+ const entries = view.getUint16(eocdInTail + 10, true);
228
+ const centralSize = view.getUint32(eocdInTail + 12, true);
229
+ const centralOffset = view.getUint32(eocdInTail + 16, true);
230
+ const commentLength = view.getUint16(eocdInTail + 20, true);
231
+ if (
232
+ disk !== 0 ||
233
+ centralDisk !== 0 ||
234
+ diskEntries !== entries ||
235
+ entries === 0 ||
236
+ centralSize === 0xffffffff ||
237
+ centralOffset === 0xffffffff ||
238
+ eocd + 22 + commentLength !== byteSize ||
239
+ centralOffset + centralSize !== eocd ||
240
+ centralOffset > byteSize
241
+ ) {
242
+ throw new Error("invalid ZIP central directory");
243
+ }
244
+ const names = new Set<string>();
245
+ let offset = centralOffset;
246
+ let totalNameBytes = 0;
247
+ for (let index = 0; index < entries; index += 1) {
248
+ throwIfAborted(signal);
249
+ if (offset + 46 > eocd) {
250
+ throw new Error("invalid ZIP entry");
251
+ }
252
+ const header = await readExact(handle, offset, 46);
253
+ const headerView = new DataView(header.buffer, header.byteOffset, header.byteLength);
254
+ if (headerView.getUint32(0, true) !== 0x02014b50) throw new Error("invalid ZIP entry");
255
+ if ((headerView.getUint16(8, true) & 1) !== 0) throw new Error("encrypted ZIP entry");
256
+ const nameLength = headerView.getUint16(28, true);
257
+ const extraLength = headerView.getUint16(30, true);
258
+ const commentBytes = headerView.getUint16(32, true);
259
+ const next = offset + 46 + nameLength + extraLength + commentBytes;
260
+ totalNameBytes += nameLength;
261
+ if (
262
+ nameLength === 0 ||
263
+ nameLength > MAX_ZIP_ENTRY_NAME_BYTES ||
264
+ totalNameBytes > MAX_ZIP_TOTAL_NAME_BYTES ||
265
+ next > eocd
266
+ ) {
267
+ throw new Error("truncated ZIP entry");
268
+ }
269
+ const name = new TextDecoder("utf-8", { fatal: true }).decode(
270
+ await readExact(handle, offset + 46, nameLength),
271
+ );
272
+ if (!isSafeZipEntryName(name) || names.has(name)) {
273
+ throw new Error("unsafe ZIP entry name");
274
+ }
275
+ names.add(name);
276
+ offset = next;
277
+ }
278
+ if (offset !== eocd || !names.has("[Content_Types].xml") || !names.has(requiredPart)) {
279
+ throw new Error("Office package is missing required parts");
280
+ }
281
+ }
282
+
283
+ function isSafeZipEntryName(name: string): boolean {
284
+ if (name.startsWith("/") || name.includes("\\")) return false;
285
+ const segments = name.split("/");
286
+ // Office writers commonly include explicit directory entries. A single
287
+ // trailing slash is canonical for those entries; empty interior segments
288
+ // remain forbidden so no alternate path spelling reaches a parser.
289
+ if (segments.at(-1) === "") segments.pop();
290
+ return (
291
+ segments.length > 0 &&
292
+ segments.every((segment) => segment.length > 0 && segment !== "." && segment !== "..")
293
+ );
294
+ }
295
+
296
+ function findEndOfCentralDirectory(bytes: Uint8Array): number {
297
+ const minimum = Math.max(0, bytes.byteLength - 65_557);
298
+ for (let offset = bytes.byteLength - 22; offset >= minimum; offset -= 1) {
299
+ if (
300
+ bytes[offset] === 0x50 &&
301
+ bytes[offset + 1] === 0x4b &&
302
+ bytes[offset + 2] === 0x05 &&
303
+ bytes[offset + 3] === 0x06
304
+ )
305
+ return offset;
306
+ }
307
+ throw new Error("missing ZIP EOCD");
308
+ }
309
+
310
+ async function* fileChunks(
311
+ path: string,
312
+ byteSize: number,
313
+ signal: AbortSignal | undefined,
314
+ ): AsyncIterableIterator<Uint8Array> {
315
+ const handle = await open(path, "r");
316
+ try {
317
+ let offset = 0;
318
+ const buffer = new Uint8Array(SEMANTIC_VERIFIER_CHUNK_BYTES);
319
+ while (offset < byteSize) {
320
+ throwIfAborted(signal);
321
+ const length = Math.min(buffer.byteLength, byteSize - offset);
322
+ const { bytesRead } = await handle.read(buffer, 0, length, offset);
323
+ if (bytesRead !== length) throw new BoundedObjectReadError("object_changed");
324
+ offset += bytesRead;
325
+ yield buffer.slice(0, bytesRead);
326
+ }
327
+ } finally {
328
+ await handle.close();
329
+ }
330
+ }
331
+
332
+ async function writeAll(handle: FileHandle, bytes: Uint8Array, position: number): Promise<void> {
333
+ let offset = 0;
334
+ while (offset < bytes.byteLength) {
335
+ const { bytesWritten } = await handle.write(
336
+ bytes,
337
+ offset,
338
+ bytes.byteLength - offset,
339
+ position + offset,
340
+ );
341
+ if (bytesWritten <= 0) throw new BoundedObjectReadError("object_changed");
342
+ offset += bytesWritten;
343
+ }
344
+ }
345
+
346
+ async function readExact(
347
+ handle: FileHandle,
348
+ position: number,
349
+ length: number,
350
+ ): Promise<Uint8Array> {
351
+ if (
352
+ !Number.isSafeInteger(position) ||
353
+ position < 0 ||
354
+ !Number.isSafeInteger(length) ||
355
+ length < 0
356
+ ) {
357
+ throw new Error("invalid file range");
358
+ }
359
+ const result = new Uint8Array(length);
360
+ let offset = 0;
361
+ while (offset < length) {
362
+ const { bytesRead } = await handle.read(result, offset, length - offset, position + offset);
363
+ if (bytesRead <= 0) throw new Error("truncated file range");
364
+ offset += bytesRead;
365
+ }
366
+ return result;
367
+ }
368
+
369
+ function validateReference(value: string): void {
370
+ if (
371
+ typeof value !== "string" ||
372
+ value.length < 1 ||
373
+ value.length > 2_048 ||
374
+ value.trim() !== value ||
375
+ /[\u0000-\u001f\u007f]/u.test(value)
376
+ )
377
+ throw new BoundedObjectReadError("invalid_request");
378
+ }
379
+
380
+ function validateLimit(value: number): void {
381
+ if (!Number.isSafeInteger(value) || value <= 0) {
382
+ throw new BoundedObjectReadError("invalid_request");
383
+ }
384
+ }
385
+
386
+ function throwIfAborted(signal: AbortSignal | undefined): void {
387
+ if (signal?.aborted) throw new BoundedObjectReadError("aborted");
388
+ }
389
+
390
+ function preserveKernelCompatibilityFailure(error: unknown): void {
391
+ if (
392
+ error instanceof EditableArtifactMaterializerPermanentError &&
393
+ error.code === "kernel_incompatible"
394
+ ) {
395
+ throw error;
396
+ }
397
+ }
398
+
399
+ function startsWithAscii(bytes: Uint8Array, value: string): boolean {
400
+ return asciiAt(bytes, 0, value);
401
+ }
402
+
403
+ function asciiAt(bytes: Uint8Array, offset: number, value: string): boolean {
404
+ if (offset < 0 || offset + value.length > bytes.byteLength) return false;
405
+ for (let index = 0; index < value.length; index += 1) {
406
+ if (bytes[offset + index] !== value.charCodeAt(index)) return false;
407
+ }
408
+ return true;
409
+ }
410
+
411
+ function equalPrefix(bytes: Uint8Array, expected: readonly number[]): boolean {
412
+ return expected.every((value, index) => bytes[index] === value);
413
+ }