@finalai/agent-provider 0.6.0 → 0.7.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.
package/README.md CHANGED
@@ -125,3 +125,39 @@ Manifest v4 records channel credentials and `surface` routes/listeners/place kin
125
125
  The `roomSurface` field describes `channels/final.ts` separately. The old address,
126
126
  attached-session, handoff and bound-conversation channel API is removed. Existing
127
127
  channel authors must migrate and republish their definitions.
128
+
129
+ ## Durable processes
130
+
131
+ A sandbox that advertises `SandboxCapability.DurableProcesses` (through `sandbox/describe`)
132
+ runs `spawn({ durable: true })` as a process that outlives its handle, so a host whose
133
+ runtime restarts (a Worker deploy resetting a Durable Object) keeps long builds and
134
+ tests. The handle's `ref` is an opaque, provider-encoded string; persist it with the
135
+ number of stdout and stderr bytes already delivered, and call
136
+ `attachProcess({ ref, stdoutOffset, stderrOffset })` to watch it again. The memory
137
+ sandbox does not offer durable processes, and sandboxes without the capability ignore
138
+ `durable` (their `ref` is null).
139
+
140
+ - A durable process ends only on its own exit, `kill`, `timeoutMs` (enforced inside
141
+ the sandbox, never by a provider-side timer) or the sandbox stopping or being
142
+ destroyed. Dropping a handle (the handle RPC connection closing,
143
+ `handle/onRuntimeShutdown`, the spawn or attach `abortSignal`) detaches it: its
144
+ streams fail and `wait` rejects, and the process keeps running. Ordinary processes
145
+ are still killed when their handle goes away.
146
+ - `attachProcess` returns null when the sandbox no longer knows the process (it
147
+ restarted or was deleted, the ref expired, is malformed or belongs to another
148
+ sandbox). Otherwise its streams carry output from the returned `stdoutOffset` and
149
+ `stderrOffset`: the requested offsets, or later ones when the provider no longer
150
+ retains the earlier bytes. Attaching after the process exited still yields its
151
+ retained output and its exit code.
152
+ - Stdin belongs to the spawning handle only. An attached process can be watched,
153
+ waited for and killed, but not written to; detaching neither writes to nor closes
154
+ its stdin. Give a durable process its input up front, or through a file.
155
+ - The provider is the source of truth for output and exit; the contract adds no
156
+ buffering. Each provider documents how much output and for how long it retains.
157
+
158
+ To offer durable processes, a provider implements `attachProcess` on its session (the
159
+ handle RPC server then advertises the capability), returns a versioned `ref` from a
160
+ durable spawn, treats the spawn and attach `abortSignal` as detach rather than kill,
161
+ enforces `timeoutMs` inside the sandbox for durable processes, and returns null for a
162
+ ref it cannot resolve, including another provider's. `runSandboxConformance` runs the
163
+ durable cases on any sandbox with `attachProcess`, directly and through the handle RPC.
@@ -24,4 +24,5 @@ export interface SandboxConformanceReportIface {
24
24
  passed: boolean;
25
25
  cases: ConformanceCaseResultIface[];
26
26
  }
27
+ export declare const DURABLE_CONFORMANCE_SCRIPT = "echo one; echo err-one >&2; sleep 2; echo two; echo err-two >&2; exit 7";
27
28
  export declare const runSandboxConformance: (args: RunSandboxConformanceArgsIface) => Promise<SandboxConformanceReportIface>;
@@ -183,6 +183,136 @@ const sandboxCases = (largeFileBytes) => [
183
183
  }
184
184
  }
185
185
  ];
186
+ const DURABLE_CONFORMANCE_SCRIPT = "echo one; echo err-one >&2; sleep 2; echo two; echo err-two >&2; exit 7";
187
+ const textOf = (chunks) => new TextDecoder().decode(concatChunks(chunks));
188
+ const concatChunks = (chunks) => {
189
+ const out = new Uint8Array(chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0));
190
+ let offset = 0;
191
+ for (const chunk of chunks) {
192
+ out.set(chunk, offset);
193
+ offset += chunk.byteLength;
194
+ }
195
+ return out;
196
+ };
197
+ const readThrough = async (stream, text) => {
198
+ const reader = stream.getReader();
199
+ const chunks = [];
200
+ while (!textOf(chunks).includes(text)) {
201
+ const next = await reader.read();
202
+ if (next.done) throw new Error(`stream ended before ${JSON.stringify(text)}`);
203
+ chunks.push(next.value);
204
+ }
205
+ return concatChunks(chunks);
206
+ };
207
+ const DURABLE_STDOUT = "one\ntwo\n";
208
+ const DURABLE_STDERR = "err-one\nerr-two\n";
209
+ const after = (text, offset) => text.slice(offset);
210
+ const attachOrFail = async (sandbox, options) => {
211
+ check(sandbox.attachProcess != null, "attachProcess is missing");
212
+ const attached = await sandbox.attachProcess?.(options);
213
+ if (attached == null) throw new Error("attachProcess found no process for a durable ref");
214
+ return attached;
215
+ };
216
+ const durableCases = async (targets, record, prefix) => {
217
+ const state = {
218
+ spawned: null
219
+ };
220
+ await record(
221
+ `${prefix}durable processes: re-attach resumes at the delivered offsets`,
222
+ async () => {
223
+ const controller = new AbortController();
224
+ const sandbox = await targets.spawnOn();
225
+ const process = await sandbox.spawn({
226
+ command: DURABLE_CONFORMANCE_SCRIPT,
227
+ shell: true,
228
+ durable: true,
229
+ abortSignal: controller.signal
230
+ });
231
+ const ref = process.ref;
232
+ check(typeof ref === "string" && ref.length > 0, "a durable process has no ref");
233
+ if (ref == null) return;
234
+ const [stdout, stderr] = await Promise.all([
235
+ readThrough(process.stdout, "one\n"),
236
+ readThrough(process.stderr, "err-one\n")
237
+ ]);
238
+ targets.drop({ controller, sandbox });
239
+ const options = { ref, stdoutOffset: stdout.byteLength, stderrOffset: stderr.byteLength };
240
+ const attached = await attachOrFail(await targets.attachOn(), options);
241
+ check(
242
+ attached.stdoutOffset === options.stdoutOffset && attached.stderrOffset === options.stderrOffset,
243
+ `attached at ${attached.stdoutOffset}/${attached.stderrOffset}, asked ${options.stdoutOffset}/${options.stderrOffset}`
244
+ );
245
+ const [restOut, restErr, exit] = await Promise.all([
246
+ streamToString(attached.stdout),
247
+ streamToString(attached.stderr),
248
+ attached.wait()
249
+ ]);
250
+ const out = textOf([stdout]) + restOut;
251
+ const err = textOf([stderr]) + restErr;
252
+ check(out === DURABLE_STDOUT, `stdout across the re-attach: ${JSON.stringify(out)}`);
253
+ check(err === DURABLE_STDERR, `stderr across the re-attach: ${JSON.stringify(err)}`);
254
+ check(exit.exitCode === 7, `exit code ${exit.exitCode}`);
255
+ state.spawned = options;
256
+ }
257
+ );
258
+ await record(
259
+ `${prefix}durable processes: attach after exit keeps output and exit code`,
260
+ async () => {
261
+ const options = state.spawned;
262
+ if (options == null) throw new Error("the re-attach case failed");
263
+ const attached = await attachOrFail(await targets.attachOn(), options);
264
+ const [out, err, exit] = await Promise.all([
265
+ streamToString(attached.stdout),
266
+ streamToString(attached.stderr),
267
+ attached.wait()
268
+ ]);
269
+ check(
270
+ out === after(DURABLE_STDOUT, options.stdoutOffset) && err === after(DURABLE_STDERR, options.stderrOffset),
271
+ `after exit: ${JSON.stringify([out, err])}`
272
+ );
273
+ check(exit.exitCode === 7, `exit code after exit ${exit.exitCode}`);
274
+ }
275
+ );
276
+ await record(`${prefix}durable processes: kill through an attached handle`, async () => {
277
+ const controller = new AbortController();
278
+ const sandbox = await targets.spawnOn();
279
+ const process = await sandbox.spawn({
280
+ command: "sleep 30",
281
+ shell: true,
282
+ durable: true,
283
+ abortSignal: controller.signal
284
+ });
285
+ const ref = process.ref;
286
+ if (ref == null) throw new Error("a durable process has no ref");
287
+ targets.drop({ controller, sandbox });
288
+ const attached = await attachOrFail(await targets.attachOn(), {
289
+ ref,
290
+ stdoutOffset: 0,
291
+ stderrOffset: 0
292
+ });
293
+ void streamToString(attached.stdout).catch(() => void 0);
294
+ void streamToString(attached.stderr).catch(() => void 0);
295
+ await attached.kill();
296
+ const result = await withTimeout(attached.wait(), 1e4, "wait after kill");
297
+ check(result.exitCode !== 0, "killed process exited 0");
298
+ });
299
+ await record(`${prefix}durable processes: unknown refs and ordinary processes`, async () => {
300
+ const sandbox = await targets.attachOn();
301
+ const unknown = await sandbox.attachProcess?.({
302
+ ref: "conformance-unknown-ref",
303
+ stdoutOffset: 0,
304
+ stderrOffset: 0
305
+ });
306
+ check(unknown === null, "an unknown ref attached to a process");
307
+ const ordinary = await (await targets.spawnOn()).spawn({ command: "echo", args: ["ordinary"] });
308
+ check(ordinary.ref == null, "an ordinary process has a ref");
309
+ await Promise.all([
310
+ streamToString(ordinary.stdout),
311
+ streamToString(ordinary.stderr),
312
+ ordinary.wait()
313
+ ]);
314
+ });
315
+ };
186
316
  const startFromProvider = async (args, provider, overrides = {}) => {
187
317
  const implementation = provider.definition.environment(
188
318
  overrides.environmentOptions ?? args.environmentOptions
@@ -461,6 +591,25 @@ const runSandboxConformance = async (args) => {
461
591
  const root = target.resolvePath(`conformance-${crypto.randomUUID().slice(0, 8)}`);
462
592
  const list = sandboxCases(args.largeFileBytes ?? 5 * 1024 * 1024);
463
593
  for (const entry of list) await record(entry.name, () => entry.run(target, root));
594
+ const durable = target.attachProcess != null;
595
+ if (durable)
596
+ await durableCases(
597
+ {
598
+ spawnOn: async () => target,
599
+ attachOn: async () => target,
600
+ drop: ({ controller }) => controller.abort()
601
+ },
602
+ record,
603
+ ""
604
+ );
605
+ else
606
+ cases.push({
607
+ name: "durable processes",
608
+ status: ConformanceCaseStatus.Skipped,
609
+ durationMs: 0,
610
+ error: null,
611
+ detail: "the sandbox has no attachProcess"
612
+ });
464
613
  if (args.viaWire !== false) {
465
614
  const network = createInMemoryHandleNetwork();
466
615
  network.serve({ url: "mem://conformance", sandbox: target });
@@ -512,6 +661,30 @@ const runSandboxConformance = async (args) => {
512
661
  readOnly.close();
513
662
  }
514
663
  });
664
+ if (durable) {
665
+ const connections = [];
666
+ const open = async () => {
667
+ const connection = await network.connect({
668
+ url: "mem://conformance",
669
+ token: "conformance"
670
+ });
671
+ connections.push(connection);
672
+ return connection;
673
+ };
674
+ try {
675
+ await durableCases(
676
+ {
677
+ spawnOn: open,
678
+ attachOn: open,
679
+ drop: ({ sandbox: sandbox2 }) => connections.find((entry) => entry === sandbox2)?.close()
680
+ },
681
+ record,
682
+ "handle rpc: "
683
+ );
684
+ } finally {
685
+ for (const connection of connections) connection.close();
686
+ }
687
+ }
515
688
  } finally {
516
689
  client.close();
517
690
  await target.removePath({ path: `${root}-wire`, recursive: true, force: true }).catch(() => void 0);
@@ -537,6 +710,7 @@ const runSandboxConformance = async (args) => {
537
710
  return { passed: cases.every((entry) => entry.status !== ConformanceCaseStatus.Failed), cases };
538
711
  };
539
712
  export {
713
+ DURABLE_CONFORMANCE_SCRIPT,
540
714
  runSandboxConformance
541
715
  };
542
716
  //# sourceMappingURL=sandbox-kit.mjs.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/conformance/sandbox-kit.ts"],
4
- "sourcesContent": ["import type { JsonValue } from \"../json.mjs\";\nimport { SandboxAccess } from \"../manifest.mjs\";\nimport { readAllBytes } from \"../sandbox/bytes.mjs\";\nimport { streamToString } from \"../sandbox/convenience.mjs\";\nimport { createInMemoryHandleNetwork } from \"../sandbox/testing.mjs\";\nimport {\n NetworkPolicy,\n noSandboxActingUser,\n noSandboxGuides,\n noSandboxRepositories,\n noSandboxVariables,\n SandboxEntryType,\n type AnySandboxProviderIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxPrepareContextIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n} from \"../sandbox/types.mjs\";\nimport { HandleRpcErrorCode, isHandleRpcError } from \"../sandbox/wire.mjs\";\nimport { ConformanceCaseStatus, type ConformanceCaseResultIface } from \"./harness-kit.mjs\";\n\n// Sandbox conformance: files, streams with\n// multi-megabyte content, ranged reads, process I/O and kill, run directly on\n// the handle and again through the handle RPC (client and server over an\n// in-memory connection), plus the server's read-only access policy. Commands\n// used: echo, cat, sleep and `exit` under `shell: true`, and printenv for the\n// platform environment cases. A provider start also checks that awaitRunning\n// resolves for the sandbox it started.\n\nexport interface RunSandboxConformanceArgsIface {\n // Either a started handle, or a provider the kit prepares and starts.\n handle?: NetworkSandboxSessionIface;\n provider?: AnySandboxProviderIface;\n environmentOptions?: JsonValue;\n openOptions?: JsonValue;\n prepareContext?: Partial<SandboxPrepareContextIface>;\n startContext?: Partial<SandboxStartContextIface>;\n // Also run the cases through the handle RPC (default true).\n viaWire?: boolean;\n largeFileBytes?: number;\n timeoutMs?: number;\n // Also run the platform environment cases, on sandboxes of their own (needs `provider`).\n platform?: SandboxPlatformConformanceIface;\n}\n\n// How the platform environment cases declare a spec for the provider under test.\nexport interface SandboxPlatformConformanceIface {\n // Environment options whose spec sets `env` as plain variables for every\n // process and, when `allow` is given, an allowlist egress policy of those hosts.\n environmentOptions(args: { env: Record<string, string>; allow?: string[] }): JsonValue;\n // The allowlist the provider gave its backend for this sandbox. Absent: the\n // egress hosts and network policy report cases are skipped.\n observedAllowlist?(sandbox: NetworkSandboxSessionIface): Promise<readonly string[] | null>;\n}\n\nexport interface SandboxConformanceReportIface {\n passed: boolean;\n cases: ConformanceCaseResultIface[];\n}\n\ninterface StartedProviderIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface> | null;\n // The provider's awaitRunning for the sandbox it started.\n awaitRunning?: (timeoutMs: number) => Promise<void>;\n}\n\ninterface ProviderStartIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface>;\n awaitRunning: (timeoutMs: number) => Promise<void>;\n}\n\nconst check = (condition: boolean, message: string) => {\n if (!condition) throw new Error(message);\n};\n\nconst patternBytes = (size: number, seed: number): Uint8Array => {\n const bytes = new Uint8Array(size);\n let state = seed >>> 0;\n for (let i = 0; i < size; i += 1) {\n state = (Math.imul(state, 1664525) + 1013904223) >>> 0;\n bytes[i] = state >>> 24;\n }\n return bytes;\n};\n\nconst chunked = (bytes: Uint8Array, chunk: number): ReadableStream<Uint8Array> => {\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= bytes.byteLength) {\n controller.close();\n return;\n }\n controller.enqueue(bytes.slice(offset, offset + chunk));\n offset += chunk;\n },\n });\n};\n\nconst sameBytes = (a: Uint8Array, b: Uint8Array) =>\n a.byteLength === b.byteLength && a.every((value, i) => value === b[i]);\n\nconst withTimeout = async <T>(promise: Promise<T>, ms: number, what: string): Promise<T> => {\n let timer: ReturnType<typeof setTimeout> | null = null;\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error(`${what} timed out after ${ms} ms`)), ms);\n }),\n ]);\n } finally {\n if (timer != null) clearTimeout(timer);\n }\n};\n\ntype SandboxCase = {\n name: string;\n run: (sandbox: NetworkSandboxSessionIface, root: string) => Promise<string | void>;\n};\n\nconst sandboxCases = (largeFileBytes: number): SandboxCase[] => [\n {\n name: 'describe',\n run: async (sandbox) => {\n check(sandbox.id.length > 0, 'empty id');\n check(\n sandbox.defaultWorkingDirectory.startsWith('/'),\n 'defaultWorkingDirectory is not absolute',\n );\n check(\n sandbox.resolvePath('a/b') === `${sandbox.defaultWorkingDirectory.replace(/\\/$/, '')}/a/b`,\n 'resolvePath',\n );\n },\n },\n {\n name: 'text files',\n run: async (sandbox, root) => {\n const path = `${root}/nested/dir/a.txt`;\n await sandbox.writeTextFile({ path, content: 'first' });\n await sandbox.writeTextFile({ path, content: 'h\u00E9llo\\n' });\n check((await sandbox.readTextFile({ path })) === 'h\u00E9llo\\n', 'text round trip');\n check(\n (await sandbox.readTextFile({ path: `${root}/missing.txt` })) == null,\n 'missing text file is not null',\n );\n check(\n (await sandbox.readFile({ path: `${root}/missing.txt` })) == null,\n 'missing file stream is not null',\n );\n },\n },\n {\n name: 'ranged reads',\n run: async (sandbox, root) => {\n const path = `${root}/lines.txt`;\n await sandbox.writeTextFile({ path, content: 'l1\\nl2\\nl3\\nl4\\n' });\n check(\n (await sandbox.readTextFile({ path, startLine: 2, endLine: 3 })) === 'l2\\nl3\\n',\n 'lines 2-3',\n );\n check(\n (await sandbox.readTextFile({ path, startLine: 4, endLine: 99 })) === 'l4\\n',\n 'endLine past EOF',\n );\n },\n },\n {\n name: 'multi-megabyte streams',\n run: async (sandbox, root) => {\n const path = `${root}/large.bin`;\n const content = patternBytes(largeFileBytes, largeFileBytes);\n await sandbox.writeFile({ path, content: chunked(content, 300_000) });\n const stream = await sandbox.readFile({ path });\n check(stream != null, 'large file not found');\n if (stream == null) return;\n check(sameBytes(await readAllBytes(stream), content), 'streamed bytes differ');\n const binary = await sandbox.readBinaryFile({ path });\n check(binary != null && sameBytes(binary, content), 'readBinaryFile differs');\n const small = patternBytes(1000, 7);\n await sandbox.writeBinaryFile({ path: `${root}/small.bin`, content: small });\n const back = await sandbox.readBinaryFile({ path: `${root}/small.bin` });\n check(back != null && sameBytes(back, small), 'binary round trip');\n return `${largeFileBytes} bytes`;\n },\n },\n {\n name: 'stat, readDir, removePath',\n run: async (sandbox, root) => {\n await sandbox.writeTextFile({ path: `${root}/tree/x.txt`, content: 'xyz' });\n await sandbox.writeTextFile({ path: `${root}/tree/sub/y.txt`, content: 'y' });\n const stat = await sandbox.stat({ path: `${root}/tree/x.txt` });\n check(stat?.type === SandboxEntryType.File && stat.size === 3, 'file stat');\n check(\n (await sandbox.stat({ path: `${root}/tree` }))?.type === SandboxEntryType.Directory,\n 'directory stat',\n );\n check(\n (await sandbox.stat({ path: `${root}/tree/none` })) == null,\n 'missing stat is not null',\n );\n const names = (await sandbox.readDir({ path: `${root}/tree` }))\n .map((entry) => entry.name)\n .sort();\n check(\n JSON.stringify(names) === JSON.stringify(['sub', 'x.txt']),\n `readDir returned ${names.join(',')}`,\n );\n await sandbox.removePath({ path: `${root}/tree/none`, force: true });\n await sandbox.removePath({ path: `${root}/tree`, recursive: true });\n check(\n (await sandbox.stat({ path: `${root}/tree/x.txt` })) == null,\n 'recursive remove left files',\n );\n },\n },\n {\n name: 'process output and exit codes',\n run: async (sandbox) => {\n const echo = await sandbox.run({ command: 'echo', args: ['hello', 'world'] });\n check(\n echo.exitCode === 0 && echo.stdout === 'hello world\\n',\n `echo: ${JSON.stringify(echo)}`,\n );\n const shell = await sandbox.run({ command: 'echo out; echo err >&2; exit 3', shell: true });\n check(\n shell.exitCode === 3 && shell.stdout === 'out\\n' && shell.stderr === 'err\\n',\n `shell: ${JSON.stringify(shell)}`,\n );\n },\n },\n {\n name: 'process stdin',\n run: async (sandbox) => {\n const piped = await sandbox.run({ command: 'cat', stdin: 'from stdin' });\n check(piped.stdout === 'from stdin', `run stdin: ${JSON.stringify(piped)}`);\n const cat = await sandbox.spawn({ command: 'cat' });\n const output = streamToString(cat.stdout);\n await cat.write('a');\n await cat.write('b', { end: true });\n check((await output) === 'ab', 'spawned cat echoed wrong data');\n check((await cat.wait()).exitCode === 0, 'cat exit code');\n },\n },\n {\n name: 'process kill',\n run: async (sandbox) => {\n const sleeper = await sandbox.spawn({ command: 'sleep', args: ['30'] });\n await sleeper.kill();\n const result = await withTimeout(sleeper.wait(), 5_000, 'wait after kill');\n check(result.exitCode !== 0, 'killed process exited 0');\n },\n },\n];\n\nconst startFromProvider = async (\n args: RunSandboxConformanceArgsIface,\n provider: AnySandboxProviderIface,\n overrides: {\n environmentOptions?: JsonValue;\n startContext?: Partial<SandboxStartContextIface>;\n // A binding (and so a sandbox) of its own, whatever session the caller's context names.\n ownBinding?: boolean;\n } = {},\n): Promise<ProviderStartIface> => {\n const implementation = provider.definition.environment(\n overrides.environmentOptions ?? args.environmentOptions,\n );\n const prepareContext: SandboxPrepareContextIface = {\n files: {},\n resources: {},\n sourceRevision: 'conformance',\n storagePath: '/tmp/final-conformance',\n organizationId: 'conformance',\n guides: noSandboxGuides,\n actingUser: noSandboxActingUser,\n ...args.prepareContext,\n };\n const artifact = await implementation.prepare(prepareContext);\n const startContext: SandboxStartContextIface = {\n session: {\n id: crypto.randomUUID(),\n organizationId: 'conformance',\n conversationId: null,\n definitionId: 'conformance',\n bindingId: crypto.randomUUID(),\n target: 'conformance',\n },\n storagePath: '/tmp/final-conformance',\n guides: noSandboxGuides,\n variables: noSandboxVariables,\n repositories: noSandboxRepositories,\n actingUser: noSandboxActingUser,\n platformNetworkPolicy: async () => undefined,\n ...args.startContext,\n ...overrides.startContext,\n };\n if (overrides.ownBinding === true) {\n startContext.session = {\n ...startContext.session,\n id: crypto.randomUUID(),\n bindingId: crypto.randomUUID(),\n conversationId: null,\n };\n }\n const { handle, state } = await implementation.start(startContext, args.openOptions, artifact);\n return {\n handle,\n awaitRunning: (timeoutMs) => implementation.awaitRunning(startContext, state, { timeoutMs }),\n };\n};\n\nconst PLATFORM_VARIABLE = 'FINAL_CONFORMANCE_PLATFORM';\nconst SPEC_VARIABLE = 'FINAL_CONFORMANCE_SPEC';\nconst SHARED_VARIABLE = 'FINAL_CONFORMANCE_SHARED';\nconst SPEC_ENV = { [SPEC_VARIABLE]: 'spec', [SHARED_VARIABLE]: 'spec' };\nconst SPEC_ALLOW = ['conformance.example.com'];\nconst PLATFORM_EGRESS_HOSTS = ['egress.conformance.example.com'];\n\n// A variable as a spawned process sees it; null when unset.\nconst variableIn = async (\n sandbox: NetworkSandboxSessionIface,\n name: string,\n): Promise<string | null> => {\n const process = await sandbox.spawn({ command: 'printenv', args: [name] });\n const [stdout, { exitCode }] = await Promise.all([\n streamToString(process.stdout),\n process.wait(),\n ]);\n return exitCode === 0 ? stdout.replace(/\\n$/, '') : null;\n};\n\nconst expectVariables = async (\n sandbox: NetworkSandboxSessionIface,\n expected: Record<string, string | null>,\n) => {\n for (const [name, value] of Object.entries(expected)) {\n const actual = await variableIn(sandbox, name);\n check(\n actual === value,\n `${name} is ${JSON.stringify(actual)}, expected ${JSON.stringify(value)}`,\n );\n }\n};\n\ntype RecordCase = (name: string, run: () => Promise<string | void>) => Promise<void>;\n\n// The start context's platformFiles are written before any process runs;\n// platformEnvironment reaches every process, read again for each one and over\n// the spec's env; platformEgressHosts join an allowlist, and the policy is\n// reported through platformNetworkPolicy before platformFiles are written (a\n// rejected report fails the start); a spec naming a platform variable is refused.\nconst runPlatformCases = async (args: {\n kit: RunSandboxConformanceArgsIface;\n provider: AnySandboxProviderIface;\n platform: SandboxPlatformConformanceIface;\n record: RecordCase;\n skip: (name: string, detail: string) => void;\n}) => {\n const { kit, provider, platform, record } = args;\n let platformValues: Record<string, string> = {\n [PLATFORM_VARIABLE]: 'first',\n [SHARED_VARIABLE]: 'platform',\n };\n const filePath = `/tmp/final-conformance-${crypto.randomUUID().slice(0, 8)}/platform/ca.pem`;\n const order: string[] = [];\n const withPlatform: StartedProviderIface = { handle: null };\n await record('platform environment: provider start', async () => {\n ({ handle: withPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV }),\n startContext: {\n platformFiles: async () => {\n order.push('files');\n return { [filePath]: 'conformance CA\\n' };\n },\n platformEnvironment: async () => {\n order.push('environment');\n return { ...platformValues };\n },\n },\n ownBinding: true,\n }));\n });\n const sandbox = withPlatform.handle?.sandbox;\n if (sandbox != null) {\n try {\n await record('platform files: written before any process', async () => {\n check(\n order.indexOf('files') === 0,\n `platformEnvironment was read before platformFiles: ${order.join(', ')}`,\n );\n const content = await sandbox.readTextFile({ path: filePath });\n check(content === 'conformance CA\\n', `${filePath} holds ${JSON.stringify(content)}`);\n });\n await record('platform environment: reaches spawned processes', async () => {\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'first' });\n const run = await sandbox.run({ command: 'printenv', args: [PLATFORM_VARIABLE] });\n check(run.stdout === 'first\\n', `run saw ${JSON.stringify(run.stdout)}`);\n });\n await record('platform environment: read again for every process', async () => {\n platformValues = { ...platformValues, [PLATFORM_VARIABLE]: 'second' };\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'second' });\n });\n await record('platform environment: overrides the spec env', async () => {\n await expectVariables(sandbox, { [SHARED_VARIABLE]: 'platform', [SPEC_VARIABLE]: 'spec' });\n });\n await record('platform environment: {} leaves the spec env', async () => {\n platformValues = {};\n await expectVariables(sandbox, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n });\n });\n } finally {\n await withPlatform.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n }\n }\n\n const withoutPlatform: StartedProviderIface = { handle: null };\n const reported: NetworkPolicyIface[] = [];\n const reportOrder: string[] = [];\n const allowlistContext = (\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>,\n ): Partial<SandboxStartContextIface> => ({\n platformEnvironment: undefined,\n platformEgressHosts: PLATFORM_EGRESS_HOSTS,\n platformNetworkPolicy,\n platformFiles: async () => {\n reportOrder.push('files');\n return {};\n },\n });\n await record('platform environment: provider start without it', async () => {\n ({ handle: withoutPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async (policy) => {\n reportOrder.push('policy');\n reported.push(policy);\n }),\n ownBinding: true,\n }));\n });\n const plain = withoutPlatform.handle?.sandbox;\n if (plain != null) {\n try {\n await record('platform environment: absent leaves the spec env', () =>\n expectVariables(plain, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n }),\n );\n const observe = platform.observedAllowlist;\n if (observe == null) {\n args.skip('platform egress hosts: appended to an allowlist', 'no observedAllowlist');\n args.skip('platform network policy: reported as applied', 'no observedAllowlist');\n } else {\n await record('platform egress hosts: appended to an allowlist', async () => {\n const allow = (await observe(plain)) ?? [];\n for (const host of [...SPEC_ALLOW, ...PLATFORM_EGRESS_HOSTS])\n check(allow.includes(host), `allowlist ${JSON.stringify(allow)} lacks ${host}`);\n });\n await record('platform network policy: reported as applied', async () => {\n const last = reported.at(-1);\n check(\n last?.mode === NetworkPolicy.Allowlist,\n `reported ${JSON.stringify(reported)}, expected an allowlist`,\n );\n const applied = [...((await observe(plain)) ?? [])].sort();\n const allow = [...(last?.allow ?? [])].sort();\n check(\n JSON.stringify(allow) === JSON.stringify(applied),\n `reported ${JSON.stringify(allow)}, applied ${JSON.stringify(applied)}`,\n );\n check(\n reportOrder.indexOf('policy') < reportOrder.indexOf('files'),\n `platformFiles were written before the policy was reported: ${reportOrder.join(', ')}`,\n );\n });\n }\n } finally {\n await withoutPlatform.handle\n ?.onSandboxDelete({ reason: 'conformance' })\n .catch(() => undefined);\n }\n }\n\n if (platform.observedAllowlist == null) {\n args.skip('platform network policy: a rejected report fails the start', 'no observedAllowlist');\n } else {\n await record('platform network policy: a rejected report fails the start', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async () => {\n throw new Error('conformance: the policy was not recorded');\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a start whose policy report failed returned a sandbox');\n });\n }\n\n await record('platform environment: reserved names refused', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({\n env: { HTTPS_PROXY: 'http://spec.example.com' },\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a spec setting HTTPS_PROXY started');\n });\n};\n\nexport const runSandboxConformance = async (\n args: RunSandboxConformanceArgsIface,\n): Promise<SandboxConformanceReportIface> => {\n const timeoutMs = args.timeoutMs ?? 30_000;\n const cases: ConformanceCaseResultIface[] = [];\n const record: RecordCase = async (name, run) => {\n const started = Date.now();\n try {\n const detail = await withTimeout(run(), timeoutMs, name);\n cases.push({\n name,\n status: ConformanceCaseStatus.Passed,\n durationMs: Date.now() - started,\n error: null,\n detail: detail ?? null,\n });\n } catch (error) {\n cases.push({\n name,\n status: ConformanceCaseStatus.Failed,\n durationMs: Date.now() - started,\n error: error instanceof Error ? error.message : String(error),\n detail: null,\n });\n }\n };\n\n // A holder, so the assignment inside the closure is visible to the narrowing.\n const started: StartedProviderIface = { handle: null };\n let sandbox = args.handle ?? null;\n if (sandbox == null) {\n if (args.provider == null)\n throw new Error('runSandboxConformance needs a handle or a provider');\n const provider = args.provider;\n await record('provider start', async () => {\n ({ handle: started.handle, awaitRunning: started.awaitRunning } = await startFromProvider(\n args,\n provider,\n ));\n });\n const awaitRunning = started.awaitRunning;\n if (awaitRunning != null)\n await record('provider awaitRunning: resolves for a started sandbox', () =>\n awaitRunning(timeoutMs),\n );\n sandbox = started.handle?.sandbox ?? null;\n }\n if (sandbox == null) return { passed: false, cases };\n const target = sandbox;\n\n const root = target.resolvePath(`conformance-${crypto.randomUUID().slice(0, 8)}`);\n const list = sandboxCases(args.largeFileBytes ?? 5 * 1024 * 1024);\n for (const entry of list) await record(entry.name, () => entry.run(target, root));\n\n if (args.viaWire !== false) {\n const network = createInMemoryHandleNetwork();\n network.serve({ url: 'mem://conformance', sandbox: target });\n network.serve({\n url: 'mem://conformance-read',\n sandbox: target,\n access: { mode: SandboxAccess.Read, lifecycle: false },\n });\n const client = await network.connect({ url: 'mem://conformance', token: 'conformance' });\n try {\n const wireRoot = `${root}-wire`;\n for (const entry of list)\n await record(`handle rpc: ${entry.name}`, () => entry.run(client, wireRoot));\n await record('handle rpc: read-only access policy', async () => {\n const readOnly = await network.connect({\n url: 'mem://conformance-read',\n token: 'conformance',\n });\n try {\n await target.writeTextFile({ path: `${root}/ro.txt`, content: 'visible' });\n check(\n (await readOnly.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'read failed on a read binding',\n );\n const attempts: [string, Promise<unknown>][] = [\n [\n 'writeTextFile',\n readOnly.writeTextFile({ path: `${root}/ro.txt`, content: 'changed' }),\n ],\n ['run', readOnly.run({ command: 'echo' })],\n ['spawn', readOnly.spawn({ command: 'echo' })],\n ['removePath', readOnly.removePath({ path: `${root}/ro.txt` })],\n ];\n for (const [what, attempt] of attempts) {\n const error = await attempt.then(\n () => null,\n (cause: unknown) => cause,\n );\n check(\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Forbidden,\n `${what} was not rejected`,\n );\n }\n check(\n (await target.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'a read binding changed the file',\n );\n } finally {\n readOnly.close();\n }\n });\n } finally {\n client.close();\n await target\n .removePath({ path: `${root}-wire`, recursive: true, force: true })\n .catch(() => undefined);\n }\n }\n\n await target.removePath({ path: root, recursive: true, force: true }).catch(() => undefined);\n await started.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n\n if (args.platform != null && args.provider != null) {\n await runPlatformCases({\n kit: args,\n provider: args.provider,\n platform: args.platform,\n record,\n skip: (name, detail) =>\n cases.push({\n name,\n status: ConformanceCaseStatus.Skipped,\n durationMs: 0,\n error: null,\n detail,\n }),\n });\n }\n return { passed: cases.every((entry) => entry.status !== ConformanceCaseStatus.Failed), cases };\n};\n"],
5
- "mappings": "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",
6
- "names": ["started"]
4
+ "sourcesContent": ["import type { JsonValue } from \"../json.mjs\";\nimport { SandboxAccess } from \"../manifest.mjs\";\nimport { readAllBytes } from \"../sandbox/bytes.mjs\";\nimport { streamToString } from \"../sandbox/convenience.mjs\";\nimport type { SandboxClientIface } from \"../sandbox/client.mjs\";\nimport { createInMemoryHandleNetwork } from \"../sandbox/testing.mjs\";\nimport {\n NetworkPolicy,\n noSandboxActingUser,\n noSandboxGuides,\n noSandboxRepositories,\n noSandboxVariables,\n SandboxEntryType,\n type AnySandboxProviderIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxPrepareContextIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n} from \"../sandbox/types.mjs\";\nimport { HandleRpcErrorCode, isHandleRpcError } from \"../sandbox/wire.mjs\";\nimport { ConformanceCaseStatus, type ConformanceCaseResultIface } from \"./harness-kit.mjs\";\n\n// Sandbox conformance: files, streams with\n// multi-megabyte content, ranged reads, process I/O and kill, run directly on\n// the handle and again through the handle RPC (client and server over an\n// in-memory connection), plus the server's read-only access policy. Commands\n// used: echo, cat, sleep and `exit` under `shell: true`, and printenv for the\n// platform environment cases. A provider start also checks that awaitRunning\n// resolves for the sandbox it started. A sandbox with durable processes\n// (`attachProcess`) also runs the durable cases, directly (dropping a handle by\n// aborting its signal) and through the handle RPC (by closing the connection);\n// they use DURABLE_CONFORMANCE_SCRIPT and `sleep 30` under `shell: true`.\n\nexport interface RunSandboxConformanceArgsIface {\n // Either a started handle, or a provider the kit prepares and starts.\n handle?: NetworkSandboxSessionIface;\n provider?: AnySandboxProviderIface;\n environmentOptions?: JsonValue;\n openOptions?: JsonValue;\n prepareContext?: Partial<SandboxPrepareContextIface>;\n startContext?: Partial<SandboxStartContextIface>;\n // Also run the cases through the handle RPC (default true).\n viaWire?: boolean;\n largeFileBytes?: number;\n timeoutMs?: number;\n // Also run the platform environment cases, on sandboxes of their own (needs `provider`).\n platform?: SandboxPlatformConformanceIface;\n}\n\n// How the platform environment cases declare a spec for the provider under test.\nexport interface SandboxPlatformConformanceIface {\n // Environment options whose spec sets `env` as plain variables for every\n // process and, when `allow` is given, an allowlist egress policy of those hosts.\n environmentOptions(args: { env: Record<string, string>; allow?: string[] }): JsonValue;\n // The allowlist the provider gave its backend for this sandbox. Absent: the\n // egress hosts and network policy report cases are skipped.\n observedAllowlist?(sandbox: NetworkSandboxSessionIface): Promise<readonly string[] | null>;\n}\n\nexport interface SandboxConformanceReportIface {\n passed: boolean;\n cases: ConformanceCaseResultIface[];\n}\n\ninterface StartedProviderIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface> | null;\n // The provider's awaitRunning for the sandbox it started.\n awaitRunning?: (timeoutMs: number) => Promise<void>;\n}\n\ninterface ProviderStartIface {\n handle: SandboxProviderHandleIface<NetworkSandboxSessionIface>;\n awaitRunning: (timeoutMs: number) => Promise<void>;\n}\n\nconst check = (condition: boolean, message: string) => {\n if (!condition) throw new Error(message);\n};\n\nconst patternBytes = (size: number, seed: number): Uint8Array => {\n const bytes = new Uint8Array(size);\n let state = seed >>> 0;\n for (let i = 0; i < size; i += 1) {\n state = (Math.imul(state, 1664525) + 1013904223) >>> 0;\n bytes[i] = state >>> 24;\n }\n return bytes;\n};\n\nconst chunked = (bytes: Uint8Array, chunk: number): ReadableStream<Uint8Array> => {\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= bytes.byteLength) {\n controller.close();\n return;\n }\n controller.enqueue(bytes.slice(offset, offset + chunk));\n offset += chunk;\n },\n });\n};\n\nconst sameBytes = (a: Uint8Array, b: Uint8Array) =>\n a.byteLength === b.byteLength && a.every((value, i) => value === b[i]);\n\nconst withTimeout = async <T>(promise: Promise<T>, ms: number, what: string): Promise<T> => {\n let timer: ReturnType<typeof setTimeout> | null = null;\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error(`${what} timed out after ${ms} ms`)), ms);\n }),\n ]);\n } finally {\n if (timer != null) clearTimeout(timer);\n }\n};\n\ntype SandboxCase = {\n name: string;\n run: (sandbox: NetworkSandboxSessionIface, root: string) => Promise<string | void>;\n};\n\nconst sandboxCases = (largeFileBytes: number): SandboxCase[] => [\n {\n name: 'describe',\n run: async (sandbox) => {\n check(sandbox.id.length > 0, 'empty id');\n check(\n sandbox.defaultWorkingDirectory.startsWith('/'),\n 'defaultWorkingDirectory is not absolute',\n );\n check(\n sandbox.resolvePath('a/b') === `${sandbox.defaultWorkingDirectory.replace(/\\/$/, '')}/a/b`,\n 'resolvePath',\n );\n },\n },\n {\n name: 'text files',\n run: async (sandbox, root) => {\n const path = `${root}/nested/dir/a.txt`;\n await sandbox.writeTextFile({ path, content: 'first' });\n await sandbox.writeTextFile({ path, content: 'h\u00E9llo\\n' });\n check((await sandbox.readTextFile({ path })) === 'h\u00E9llo\\n', 'text round trip');\n check(\n (await sandbox.readTextFile({ path: `${root}/missing.txt` })) == null,\n 'missing text file is not null',\n );\n check(\n (await sandbox.readFile({ path: `${root}/missing.txt` })) == null,\n 'missing file stream is not null',\n );\n },\n },\n {\n name: 'ranged reads',\n run: async (sandbox, root) => {\n const path = `${root}/lines.txt`;\n await sandbox.writeTextFile({ path, content: 'l1\\nl2\\nl3\\nl4\\n' });\n check(\n (await sandbox.readTextFile({ path, startLine: 2, endLine: 3 })) === 'l2\\nl3\\n',\n 'lines 2-3',\n );\n check(\n (await sandbox.readTextFile({ path, startLine: 4, endLine: 99 })) === 'l4\\n',\n 'endLine past EOF',\n );\n },\n },\n {\n name: 'multi-megabyte streams',\n run: async (sandbox, root) => {\n const path = `${root}/large.bin`;\n const content = patternBytes(largeFileBytes, largeFileBytes);\n await sandbox.writeFile({ path, content: chunked(content, 300_000) });\n const stream = await sandbox.readFile({ path });\n check(stream != null, 'large file not found');\n if (stream == null) return;\n check(sameBytes(await readAllBytes(stream), content), 'streamed bytes differ');\n const binary = await sandbox.readBinaryFile({ path });\n check(binary != null && sameBytes(binary, content), 'readBinaryFile differs');\n const small = patternBytes(1000, 7);\n await sandbox.writeBinaryFile({ path: `${root}/small.bin`, content: small });\n const back = await sandbox.readBinaryFile({ path: `${root}/small.bin` });\n check(back != null && sameBytes(back, small), 'binary round trip');\n return `${largeFileBytes} bytes`;\n },\n },\n {\n name: 'stat, readDir, removePath',\n run: async (sandbox, root) => {\n await sandbox.writeTextFile({ path: `${root}/tree/x.txt`, content: 'xyz' });\n await sandbox.writeTextFile({ path: `${root}/tree/sub/y.txt`, content: 'y' });\n const stat = await sandbox.stat({ path: `${root}/tree/x.txt` });\n check(stat?.type === SandboxEntryType.File && stat.size === 3, 'file stat');\n check(\n (await sandbox.stat({ path: `${root}/tree` }))?.type === SandboxEntryType.Directory,\n 'directory stat',\n );\n check(\n (await sandbox.stat({ path: `${root}/tree/none` })) == null,\n 'missing stat is not null',\n );\n const names = (await sandbox.readDir({ path: `${root}/tree` }))\n .map((entry) => entry.name)\n .sort();\n check(\n JSON.stringify(names) === JSON.stringify(['sub', 'x.txt']),\n `readDir returned ${names.join(',')}`,\n );\n await sandbox.removePath({ path: `${root}/tree/none`, force: true });\n await sandbox.removePath({ path: `${root}/tree`, recursive: true });\n check(\n (await sandbox.stat({ path: `${root}/tree/x.txt` })) == null,\n 'recursive remove left files',\n );\n },\n },\n {\n name: 'process output and exit codes',\n run: async (sandbox) => {\n const echo = await sandbox.run({ command: 'echo', args: ['hello', 'world'] });\n check(\n echo.exitCode === 0 && echo.stdout === 'hello world\\n',\n `echo: ${JSON.stringify(echo)}`,\n );\n const shell = await sandbox.run({ command: 'echo out; echo err >&2; exit 3', shell: true });\n check(\n shell.exitCode === 3 && shell.stdout === 'out\\n' && shell.stderr === 'err\\n',\n `shell: ${JSON.stringify(shell)}`,\n );\n },\n },\n {\n name: 'process stdin',\n run: async (sandbox) => {\n const piped = await sandbox.run({ command: 'cat', stdin: 'from stdin' });\n check(piped.stdout === 'from stdin', `run stdin: ${JSON.stringify(piped)}`);\n const cat = await sandbox.spawn({ command: 'cat' });\n const output = streamToString(cat.stdout);\n await cat.write('a');\n await cat.write('b', { end: true });\n check((await output) === 'ab', 'spawned cat echoed wrong data');\n check((await cat.wait()).exitCode === 0, 'cat exit code');\n },\n },\n {\n name: 'process kill',\n run: async (sandbox) => {\n const sleeper = await sandbox.spawn({ command: 'sleep', args: ['30'] });\n await sleeper.kill();\n const result = await withTimeout(sleeper.wait(), 5_000, 'wait after kill');\n check(result.exitCode !== 0, 'killed process exited 0');\n },\n },\n];\n\n// Prints a first line on each stream, pauses (the kit drops its handle then),\n// prints a second one and exits 7. Fake backends script exactly this text.\nexport const DURABLE_CONFORMANCE_SCRIPT =\n 'echo one; echo err-one >&2; sleep 2; echo two; echo err-two >&2; exit 7';\n\nconst textOf = (chunks: Uint8Array[]) => new TextDecoder().decode(concatChunks(chunks));\nconst concatChunks = (chunks: Uint8Array[]): Uint8Array => {\n const out = new Uint8Array(chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0));\n let offset = 0;\n for (const chunk of chunks) {\n out.set(chunk, offset);\n offset += chunk.byteLength;\n }\n return out;\n};\n\n// Reads until the text read so far contains `text` (a provider may deliver\n// more in the same chunk); returns the bytes read. The reader stays locked,\n// so nothing more is consumed.\nconst readThrough = async (\n stream: ReadableStream<Uint8Array>,\n text: string,\n): Promise<Uint8Array> => {\n const reader = stream.getReader();\n const chunks: Uint8Array[] = [];\n while (!textOf(chunks).includes(text)) {\n const next = await reader.read();\n if (next.done) throw new Error(`stream ended before ${JSON.stringify(text)}`);\n chunks.push(next.value);\n }\n return concatChunks(chunks);\n};\n\nconst DURABLE_STDOUT = 'one\\ntwo\\n';\nconst DURABLE_STDERR = 'err-one\\nerr-two\\n';\n// The output after `offset` bytes (the script's output is ASCII).\nconst after = (text: string, offset: number) => text.slice(offset);\n\ninterface DurableTargetsIface {\n // Where a process is spawned, and where it is attached again.\n spawnOn: () => Promise<NetworkSandboxSessionIface>;\n attachOn: () => Promise<NetworkSandboxSessionIface>;\n // Drops the spawning handle: aborts its signal, or closes its connection.\n drop: (args: { controller: AbortController; sandbox: NetworkSandboxSessionIface }) => void;\n}\n\nconst attachOrFail = async (\n sandbox: NetworkSandboxSessionIface,\n options: { ref: string; stdoutOffset: number; stderrOffset: number },\n) => {\n check(sandbox.attachProcess != null, 'attachProcess is missing');\n const attached = await sandbox.attachProcess?.(options);\n if (attached == null) throw new Error('attachProcess found no process for a durable ref');\n return attached;\n};\n\nconst durableCases = async (targets: DurableTargetsIface, record: RecordCase, prefix: string) => {\n const state: { spawned: { ref: string; stdoutOffset: number; stderrOffset: number } | null } = {\n spawned: null,\n };\n await record(\n `${prefix}durable processes: re-attach resumes at the delivered offsets`,\n async () => {\n const controller = new AbortController();\n const sandbox = await targets.spawnOn();\n const process = await sandbox.spawn({\n command: DURABLE_CONFORMANCE_SCRIPT,\n shell: true,\n durable: true,\n abortSignal: controller.signal,\n });\n const ref = process.ref;\n check(typeof ref === 'string' && ref.length > 0, 'a durable process has no ref');\n if (ref == null) return;\n const [stdout, stderr] = await Promise.all([\n readThrough(process.stdout, 'one\\n'),\n readThrough(process.stderr, 'err-one\\n'),\n ]);\n targets.drop({ controller, sandbox });\n const options = { ref, stdoutOffset: stdout.byteLength, stderrOffset: stderr.byteLength };\n const attached = await attachOrFail(await targets.attachOn(), options);\n check(\n attached.stdoutOffset === options.stdoutOffset &&\n attached.stderrOffset === options.stderrOffset,\n `attached at ${attached.stdoutOffset}/${attached.stderrOffset}, asked ${options.stdoutOffset}/${options.stderrOffset}`,\n );\n const [restOut, restErr, exit] = await Promise.all([\n streamToString(attached.stdout),\n streamToString(attached.stderr),\n attached.wait(),\n ]);\n const out = textOf([stdout]) + restOut;\n const err = textOf([stderr]) + restErr;\n check(out === DURABLE_STDOUT, `stdout across the re-attach: ${JSON.stringify(out)}`);\n check(err === DURABLE_STDERR, `stderr across the re-attach: ${JSON.stringify(err)}`);\n check(exit.exitCode === 7, `exit code ${exit.exitCode}`);\n state.spawned = options;\n },\n );\n await record(\n `${prefix}durable processes: attach after exit keeps output and exit code`,\n async () => {\n const options = state.spawned;\n if (options == null) throw new Error('the re-attach case failed');\n const attached = await attachOrFail(await targets.attachOn(), options);\n const [out, err, exit] = await Promise.all([\n streamToString(attached.stdout),\n streamToString(attached.stderr),\n attached.wait(),\n ]);\n check(\n out === after(DURABLE_STDOUT, options.stdoutOffset) &&\n err === after(DURABLE_STDERR, options.stderrOffset),\n `after exit: ${JSON.stringify([out, err])}`,\n );\n check(exit.exitCode === 7, `exit code after exit ${exit.exitCode}`);\n },\n );\n await record(`${prefix}durable processes: kill through an attached handle`, async () => {\n const controller = new AbortController();\n const sandbox = await targets.spawnOn();\n const process = await sandbox.spawn({\n command: 'sleep 30',\n shell: true,\n durable: true,\n abortSignal: controller.signal,\n });\n const ref = process.ref;\n if (ref == null) throw new Error('a durable process has no ref');\n targets.drop({ controller, sandbox });\n const attached = await attachOrFail(await targets.attachOn(), {\n ref,\n stdoutOffset: 0,\n stderrOffset: 0,\n });\n void streamToString(attached.stdout).catch(() => undefined);\n void streamToString(attached.stderr).catch(() => undefined);\n await attached.kill();\n const result = await withTimeout(attached.wait(), 10_000, 'wait after kill');\n check(result.exitCode !== 0, 'killed process exited 0');\n });\n await record(`${prefix}durable processes: unknown refs and ordinary processes`, async () => {\n const sandbox = await targets.attachOn();\n const unknown = await sandbox.attachProcess?.({\n ref: 'conformance-unknown-ref',\n stdoutOffset: 0,\n stderrOffset: 0,\n });\n check(unknown === null, 'an unknown ref attached to a process');\n const ordinary = await (await targets.spawnOn()).spawn({ command: 'echo', args: ['ordinary'] });\n check(ordinary.ref == null, 'an ordinary process has a ref');\n await Promise.all([\n streamToString(ordinary.stdout),\n streamToString(ordinary.stderr),\n ordinary.wait(),\n ]);\n });\n};\n\nconst startFromProvider = async (\n args: RunSandboxConformanceArgsIface,\n provider: AnySandboxProviderIface,\n overrides: {\n environmentOptions?: JsonValue;\n startContext?: Partial<SandboxStartContextIface>;\n // A binding (and so a sandbox) of its own, whatever session the caller's context names.\n ownBinding?: boolean;\n } = {},\n): Promise<ProviderStartIface> => {\n const implementation = provider.definition.environment(\n overrides.environmentOptions ?? args.environmentOptions,\n );\n const prepareContext: SandboxPrepareContextIface = {\n files: {},\n resources: {},\n sourceRevision: 'conformance',\n storagePath: '/tmp/final-conformance',\n organizationId: 'conformance',\n guides: noSandboxGuides,\n actingUser: noSandboxActingUser,\n ...args.prepareContext,\n };\n const artifact = await implementation.prepare(prepareContext);\n const startContext: SandboxStartContextIface = {\n session: {\n id: crypto.randomUUID(),\n organizationId: 'conformance',\n conversationId: null,\n definitionId: 'conformance',\n bindingId: crypto.randomUUID(),\n target: 'conformance',\n },\n storagePath: '/tmp/final-conformance',\n guides: noSandboxGuides,\n variables: noSandboxVariables,\n repositories: noSandboxRepositories,\n actingUser: noSandboxActingUser,\n platformNetworkPolicy: async () => undefined,\n ...args.startContext,\n ...overrides.startContext,\n };\n if (overrides.ownBinding === true) {\n startContext.session = {\n ...startContext.session,\n id: crypto.randomUUID(),\n bindingId: crypto.randomUUID(),\n conversationId: null,\n };\n }\n const { handle, state } = await implementation.start(startContext, args.openOptions, artifact);\n return {\n handle,\n awaitRunning: (timeoutMs) => implementation.awaitRunning(startContext, state, { timeoutMs }),\n };\n};\n\nconst PLATFORM_VARIABLE = 'FINAL_CONFORMANCE_PLATFORM';\nconst SPEC_VARIABLE = 'FINAL_CONFORMANCE_SPEC';\nconst SHARED_VARIABLE = 'FINAL_CONFORMANCE_SHARED';\nconst SPEC_ENV = { [SPEC_VARIABLE]: 'spec', [SHARED_VARIABLE]: 'spec' };\nconst SPEC_ALLOW = ['conformance.example.com'];\nconst PLATFORM_EGRESS_HOSTS = ['egress.conformance.example.com'];\n\n// A variable as a spawned process sees it; null when unset.\nconst variableIn = async (\n sandbox: NetworkSandboxSessionIface,\n name: string,\n): Promise<string | null> => {\n const process = await sandbox.spawn({ command: 'printenv', args: [name] });\n const [stdout, { exitCode }] = await Promise.all([\n streamToString(process.stdout),\n process.wait(),\n ]);\n return exitCode === 0 ? stdout.replace(/\\n$/, '') : null;\n};\n\nconst expectVariables = async (\n sandbox: NetworkSandboxSessionIface,\n expected: Record<string, string | null>,\n) => {\n for (const [name, value] of Object.entries(expected)) {\n const actual = await variableIn(sandbox, name);\n check(\n actual === value,\n `${name} is ${JSON.stringify(actual)}, expected ${JSON.stringify(value)}`,\n );\n }\n};\n\ntype RecordCase = (name: string, run: () => Promise<string | void>) => Promise<void>;\n\n// The start context's platformFiles are written before any process runs;\n// platformEnvironment reaches every process, read again for each one and over\n// the spec's env; platformEgressHosts join an allowlist, and the policy is\n// reported through platformNetworkPolicy before platformFiles are written (a\n// rejected report fails the start); a spec naming a platform variable is refused.\nconst runPlatformCases = async (args: {\n kit: RunSandboxConformanceArgsIface;\n provider: AnySandboxProviderIface;\n platform: SandboxPlatformConformanceIface;\n record: RecordCase;\n skip: (name: string, detail: string) => void;\n}) => {\n const { kit, provider, platform, record } = args;\n let platformValues: Record<string, string> = {\n [PLATFORM_VARIABLE]: 'first',\n [SHARED_VARIABLE]: 'platform',\n };\n const filePath = `/tmp/final-conformance-${crypto.randomUUID().slice(0, 8)}/platform/ca.pem`;\n const order: string[] = [];\n const withPlatform: StartedProviderIface = { handle: null };\n await record('platform environment: provider start', async () => {\n ({ handle: withPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV }),\n startContext: {\n platformFiles: async () => {\n order.push('files');\n return { [filePath]: 'conformance CA\\n' };\n },\n platformEnvironment: async () => {\n order.push('environment');\n return { ...platformValues };\n },\n },\n ownBinding: true,\n }));\n });\n const sandbox = withPlatform.handle?.sandbox;\n if (sandbox != null) {\n try {\n await record('platform files: written before any process', async () => {\n check(\n order.indexOf('files') === 0,\n `platformEnvironment was read before platformFiles: ${order.join(', ')}`,\n );\n const content = await sandbox.readTextFile({ path: filePath });\n check(content === 'conformance CA\\n', `${filePath} holds ${JSON.stringify(content)}`);\n });\n await record('platform environment: reaches spawned processes', async () => {\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'first' });\n const run = await sandbox.run({ command: 'printenv', args: [PLATFORM_VARIABLE] });\n check(run.stdout === 'first\\n', `run saw ${JSON.stringify(run.stdout)}`);\n });\n await record('platform environment: read again for every process', async () => {\n platformValues = { ...platformValues, [PLATFORM_VARIABLE]: 'second' };\n await expectVariables(sandbox, { [PLATFORM_VARIABLE]: 'second' });\n });\n await record('platform environment: overrides the spec env', async () => {\n await expectVariables(sandbox, { [SHARED_VARIABLE]: 'platform', [SPEC_VARIABLE]: 'spec' });\n });\n await record('platform environment: {} leaves the spec env', async () => {\n platformValues = {};\n await expectVariables(sandbox, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n });\n });\n } finally {\n await withPlatform.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n }\n }\n\n const withoutPlatform: StartedProviderIface = { handle: null };\n const reported: NetworkPolicyIface[] = [];\n const reportOrder: string[] = [];\n const allowlistContext = (\n platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>,\n ): Partial<SandboxStartContextIface> => ({\n platformEnvironment: undefined,\n platformEgressHosts: PLATFORM_EGRESS_HOSTS,\n platformNetworkPolicy,\n platformFiles: async () => {\n reportOrder.push('files');\n return {};\n },\n });\n await record('platform environment: provider start without it', async () => {\n ({ handle: withoutPlatform.handle } = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async (policy) => {\n reportOrder.push('policy');\n reported.push(policy);\n }),\n ownBinding: true,\n }));\n });\n const plain = withoutPlatform.handle?.sandbox;\n if (plain != null) {\n try {\n await record('platform environment: absent leaves the spec env', () =>\n expectVariables(plain, {\n [PLATFORM_VARIABLE]: null,\n [SHARED_VARIABLE]: 'spec',\n [SPEC_VARIABLE]: 'spec',\n }),\n );\n const observe = platform.observedAllowlist;\n if (observe == null) {\n args.skip('platform egress hosts: appended to an allowlist', 'no observedAllowlist');\n args.skip('platform network policy: reported as applied', 'no observedAllowlist');\n } else {\n await record('platform egress hosts: appended to an allowlist', async () => {\n const allow = (await observe(plain)) ?? [];\n for (const host of [...SPEC_ALLOW, ...PLATFORM_EGRESS_HOSTS])\n check(allow.includes(host), `allowlist ${JSON.stringify(allow)} lacks ${host}`);\n });\n await record('platform network policy: reported as applied', async () => {\n const last = reported.at(-1);\n check(\n last?.mode === NetworkPolicy.Allowlist,\n `reported ${JSON.stringify(reported)}, expected an allowlist`,\n );\n const applied = [...((await observe(plain)) ?? [])].sort();\n const allow = [...(last?.allow ?? [])].sort();\n check(\n JSON.stringify(allow) === JSON.stringify(applied),\n `reported ${JSON.stringify(allow)}, applied ${JSON.stringify(applied)}`,\n );\n check(\n reportOrder.indexOf('policy') < reportOrder.indexOf('files'),\n `platformFiles were written before the policy was reported: ${reportOrder.join(', ')}`,\n );\n });\n }\n } finally {\n await withoutPlatform.handle\n ?.onSandboxDelete({ reason: 'conformance' })\n .catch(() => undefined);\n }\n }\n\n if (platform.observedAllowlist == null) {\n args.skip('platform network policy: a rejected report fails the start', 'no observedAllowlist');\n } else {\n await record('platform network policy: a rejected report fails the start', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: allowlistContext(async () => {\n throw new Error('conformance: the policy was not recorded');\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a start whose policy report failed returned a sandbox');\n });\n }\n\n await record('platform environment: reserved names refused', async () => {\n const started = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({\n env: { HTTPS_PROXY: 'http://spec.example.com' },\n }),\n ownBinding: true,\n }).then(\n ({ handle }) => handle,\n () => null,\n );\n if (started == null) return;\n await started.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n throw new Error('a spec setting HTTPS_PROXY started');\n });\n};\n\nexport const runSandboxConformance = async (\n args: RunSandboxConformanceArgsIface,\n): Promise<SandboxConformanceReportIface> => {\n const timeoutMs = args.timeoutMs ?? 30_000;\n const cases: ConformanceCaseResultIface[] = [];\n const record: RecordCase = async (name, run) => {\n const started = Date.now();\n try {\n const detail = await withTimeout(run(), timeoutMs, name);\n cases.push({\n name,\n status: ConformanceCaseStatus.Passed,\n durationMs: Date.now() - started,\n error: null,\n detail: detail ?? null,\n });\n } catch (error) {\n cases.push({\n name,\n status: ConformanceCaseStatus.Failed,\n durationMs: Date.now() - started,\n error: error instanceof Error ? error.message : String(error),\n detail: null,\n });\n }\n };\n\n // A holder, so the assignment inside the closure is visible to the narrowing.\n const started: StartedProviderIface = { handle: null };\n let sandbox = args.handle ?? null;\n if (sandbox == null) {\n if (args.provider == null)\n throw new Error('runSandboxConformance needs a handle or a provider');\n const provider = args.provider;\n await record('provider start', async () => {\n ({ handle: started.handle, awaitRunning: started.awaitRunning } = await startFromProvider(\n args,\n provider,\n ));\n });\n const awaitRunning = started.awaitRunning;\n if (awaitRunning != null)\n await record('provider awaitRunning: resolves for a started sandbox', () =>\n awaitRunning(timeoutMs),\n );\n sandbox = started.handle?.sandbox ?? null;\n }\n if (sandbox == null) return { passed: false, cases };\n const target = sandbox;\n\n const root = target.resolvePath(`conformance-${crypto.randomUUID().slice(0, 8)}`);\n const list = sandboxCases(args.largeFileBytes ?? 5 * 1024 * 1024);\n for (const entry of list) await record(entry.name, () => entry.run(target, root));\n const durable = target.attachProcess != null;\n if (durable)\n await durableCases(\n {\n spawnOn: async () => target,\n attachOn: async () => target,\n drop: ({ controller }) => controller.abort(),\n },\n record,\n '',\n );\n else\n cases.push({\n name: 'durable processes',\n status: ConformanceCaseStatus.Skipped,\n durationMs: 0,\n error: null,\n detail: 'the sandbox has no attachProcess',\n });\n\n if (args.viaWire !== false) {\n const network = createInMemoryHandleNetwork();\n network.serve({ url: 'mem://conformance', sandbox: target });\n network.serve({\n url: 'mem://conformance-read',\n sandbox: target,\n access: { mode: SandboxAccess.Read, lifecycle: false },\n });\n const client = await network.connect({ url: 'mem://conformance', token: 'conformance' });\n try {\n const wireRoot = `${root}-wire`;\n for (const entry of list)\n await record(`handle rpc: ${entry.name}`, () => entry.run(client, wireRoot));\n await record('handle rpc: read-only access policy', async () => {\n const readOnly = await network.connect({\n url: 'mem://conformance-read',\n token: 'conformance',\n });\n try {\n await target.writeTextFile({ path: `${root}/ro.txt`, content: 'visible' });\n check(\n (await readOnly.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'read failed on a read binding',\n );\n const attempts: [string, Promise<unknown>][] = [\n [\n 'writeTextFile',\n readOnly.writeTextFile({ path: `${root}/ro.txt`, content: 'changed' }),\n ],\n ['run', readOnly.run({ command: 'echo' })],\n ['spawn', readOnly.spawn({ command: 'echo' })],\n ['removePath', readOnly.removePath({ path: `${root}/ro.txt` })],\n ];\n for (const [what, attempt] of attempts) {\n const error = await attempt.then(\n () => null,\n (cause: unknown) => cause,\n );\n check(\n isHandleRpcError(error) && error.code === HandleRpcErrorCode.Forbidden,\n `${what} was not rejected`,\n );\n }\n check(\n (await target.readTextFile({ path: `${root}/ro.txt` })) === 'visible',\n 'a read binding changed the file',\n );\n } finally {\n readOnly.close();\n }\n });\n if (durable) {\n // Each spawn gets a connection of its own, which dropping closes.\n const connections: SandboxClientIface[] = [];\n const open = async () => {\n const connection = await network.connect({\n url: 'mem://conformance',\n token: 'conformance',\n });\n connections.push(connection);\n return connection;\n };\n try {\n await durableCases(\n {\n spawnOn: open,\n attachOn: open,\n drop: ({ sandbox }) => connections.find((entry) => entry === sandbox)?.close(),\n },\n record,\n 'handle rpc: ',\n );\n } finally {\n for (const connection of connections) connection.close();\n }\n }\n } finally {\n client.close();\n await target\n .removePath({ path: `${root}-wire`, recursive: true, force: true })\n .catch(() => undefined);\n }\n }\n\n await target.removePath({ path: root, recursive: true, force: true }).catch(() => undefined);\n await started.handle?.onSandboxDelete({ reason: 'conformance' }).catch(() => undefined);\n\n if (args.platform != null && args.provider != null) {\n await runPlatformCases({\n kit: args,\n provider: args.provider,\n platform: args.platform,\n record,\n skip: (name, detail) =>\n cases.push({\n name,\n status: ConformanceCaseStatus.Skipped,\n durationMs: 0,\n error: null,\n detail,\n }),\n });\n }\n return { passed: cases.every((entry) => entry.status !== ConformanceCaseStatus.Failed), cases };\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["started", "sandbox"]
7
7
  }