@finalai/agent-provider 0.1.6 → 0.2.1
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/dist/modules/channel-context.d.mts +30 -26
- package/dist/modules/channel-context.mjs +11 -18
- package/dist/modules/channel-context.mjs.map +3 -3
- package/dist/modules/channel.d.mts +35 -21
- package/dist/modules/channel.mjs +22 -12
- package/dist/modules/channel.mjs.map +3 -3
- package/dist/modules/conformance/sandbox-kit.mjs +74 -9
- package/dist/modules/conformance/sandbox-kit.mjs.map +2 -2
- package/dist/modules/sandbox/memory-sandbox.mjs +13 -1
- package/dist/modules/sandbox/memory-sandbox.mjs.map +2 -2
- package/dist/modules/sandbox/types.d.mts +5 -0
- package/dist/modules/sandbox/types.mjs +15 -1
- package/dist/modules/sandbox/types.mjs.map +2 -2
- package/package.json +3 -3
|
@@ -3,6 +3,7 @@ import { readAllBytes } from "../sandbox/bytes.mjs";
|
|
|
3
3
|
import { streamToString } from "../sandbox/convenience.mjs";
|
|
4
4
|
import { createInMemoryHandleNetwork } from "../sandbox/testing.mjs";
|
|
5
5
|
import {
|
|
6
|
+
NetworkPolicy,
|
|
6
7
|
noSandboxActingUser,
|
|
7
8
|
noSandboxGuides,
|
|
8
9
|
noSandboxRepositories,
|
|
@@ -211,6 +212,7 @@ const startFromProvider = async (args, provider, overrides = {}) => {
|
|
|
211
212
|
variables: noSandboxVariables,
|
|
212
213
|
repositories: noSandboxRepositories,
|
|
213
214
|
actingUser: noSandboxActingUser,
|
|
215
|
+
platformNetworkPolicy: async () => void 0,
|
|
214
216
|
...args.startContext,
|
|
215
217
|
...overrides.startContext
|
|
216
218
|
};
|
|
@@ -222,8 +224,11 @@ const startFromProvider = async (args, provider, overrides = {}) => {
|
|
|
222
224
|
conversationId: null
|
|
223
225
|
};
|
|
224
226
|
}
|
|
225
|
-
const { handle } = await implementation.start(startContext, args.openOptions, artifact);
|
|
226
|
-
return
|
|
227
|
+
const { handle, state } = await implementation.start(startContext, args.openOptions, artifact);
|
|
228
|
+
return {
|
|
229
|
+
handle,
|
|
230
|
+
awaitRunning: (timeoutMs) => implementation.awaitRunning(startContext, state, { timeoutMs })
|
|
231
|
+
};
|
|
227
232
|
};
|
|
228
233
|
const PLATFORM_VARIABLE = "FINAL_CONFORMANCE_PLATFORM";
|
|
229
234
|
const SPEC_VARIABLE = "FINAL_CONFORMANCE_SPEC";
|
|
@@ -258,7 +263,7 @@ const runPlatformCases = async (args) => {
|
|
|
258
263
|
const order = [];
|
|
259
264
|
const withPlatform = { handle: null };
|
|
260
265
|
await record("platform environment: provider start", async () => {
|
|
261
|
-
withPlatform.handle = await startFromProvider(kit, provider, {
|
|
266
|
+
({ handle: withPlatform.handle } = await startFromProvider(kit, provider, {
|
|
262
267
|
environmentOptions: platform.environmentOptions({ env: SPEC_ENV }),
|
|
263
268
|
startContext: {
|
|
264
269
|
platformFiles: async () => {
|
|
@@ -271,7 +276,7 @@ const runPlatformCases = async (args) => {
|
|
|
271
276
|
}
|
|
272
277
|
},
|
|
273
278
|
ownBinding: true
|
|
274
|
-
});
|
|
279
|
+
}));
|
|
275
280
|
});
|
|
276
281
|
const sandbox = withPlatform.handle?.sandbox;
|
|
277
282
|
if (sandbox != null) {
|
|
@@ -309,12 +314,26 @@ const runPlatformCases = async (args) => {
|
|
|
309
314
|
}
|
|
310
315
|
}
|
|
311
316
|
const withoutPlatform = { handle: null };
|
|
317
|
+
const reported = [];
|
|
318
|
+
const reportOrder = [];
|
|
319
|
+
const allowlistContext = (platformNetworkPolicy) => ({
|
|
320
|
+
platformEnvironment: void 0,
|
|
321
|
+
platformEgressHosts: PLATFORM_EGRESS_HOSTS,
|
|
322
|
+
platformNetworkPolicy,
|
|
323
|
+
platformFiles: async () => {
|
|
324
|
+
reportOrder.push("files");
|
|
325
|
+
return {};
|
|
326
|
+
}
|
|
327
|
+
});
|
|
312
328
|
await record("platform environment: provider start without it", async () => {
|
|
313
|
-
withoutPlatform.handle = await startFromProvider(kit, provider, {
|
|
329
|
+
({ handle: withoutPlatform.handle } = await startFromProvider(kit, provider, {
|
|
314
330
|
environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),
|
|
315
|
-
startContext:
|
|
331
|
+
startContext: allowlistContext(async (policy) => {
|
|
332
|
+
reportOrder.push("policy");
|
|
333
|
+
reported.push(policy);
|
|
334
|
+
}),
|
|
316
335
|
ownBinding: true
|
|
317
|
-
});
|
|
336
|
+
}));
|
|
318
337
|
});
|
|
319
338
|
const plain = withoutPlatform.handle?.sandbox;
|
|
320
339
|
if (plain != null) {
|
|
@@ -330,17 +349,54 @@ const runPlatformCases = async (args) => {
|
|
|
330
349
|
const observe = platform.observedAllowlist;
|
|
331
350
|
if (observe == null) {
|
|
332
351
|
args.skip("platform egress hosts: appended to an allowlist", "no observedAllowlist");
|
|
352
|
+
args.skip("platform network policy: reported as applied", "no observedAllowlist");
|
|
333
353
|
} else {
|
|
334
354
|
await record("platform egress hosts: appended to an allowlist", async () => {
|
|
335
355
|
const allow = await observe(plain) ?? [];
|
|
336
356
|
for (const host of [...SPEC_ALLOW, ...PLATFORM_EGRESS_HOSTS])
|
|
337
357
|
check(allow.includes(host), `allowlist ${JSON.stringify(allow)} lacks ${host}`);
|
|
338
358
|
});
|
|
359
|
+
await record("platform network policy: reported as applied", async () => {
|
|
360
|
+
const last = reported.at(-1);
|
|
361
|
+
check(
|
|
362
|
+
last?.mode === NetworkPolicy.Allowlist,
|
|
363
|
+
`reported ${JSON.stringify(reported)}, expected an allowlist`
|
|
364
|
+
);
|
|
365
|
+
const applied = [...await observe(plain) ?? []].sort();
|
|
366
|
+
const allow = [...last?.allow ?? []].sort();
|
|
367
|
+
check(
|
|
368
|
+
JSON.stringify(allow) === JSON.stringify(applied),
|
|
369
|
+
`reported ${JSON.stringify(allow)}, applied ${JSON.stringify(applied)}`
|
|
370
|
+
);
|
|
371
|
+
check(
|
|
372
|
+
reportOrder.indexOf("policy") < reportOrder.indexOf("files"),
|
|
373
|
+
`platformFiles were written before the policy was reported: ${reportOrder.join(", ")}`
|
|
374
|
+
);
|
|
375
|
+
});
|
|
339
376
|
}
|
|
340
377
|
} finally {
|
|
341
378
|
await withoutPlatform.handle?.onSandboxDelete({ reason: "conformance" }).catch(() => void 0);
|
|
342
379
|
}
|
|
343
380
|
}
|
|
381
|
+
if (platform.observedAllowlist == null) {
|
|
382
|
+
args.skip("platform network policy: a rejected report fails the start", "no observedAllowlist");
|
|
383
|
+
} else {
|
|
384
|
+
await record("platform network policy: a rejected report fails the start", async () => {
|
|
385
|
+
const started = await startFromProvider(kit, provider, {
|
|
386
|
+
environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),
|
|
387
|
+
startContext: allowlistContext(async () => {
|
|
388
|
+
throw new Error("conformance: the policy was not recorded");
|
|
389
|
+
}),
|
|
390
|
+
ownBinding: true
|
|
391
|
+
}).then(
|
|
392
|
+
({ handle }) => handle,
|
|
393
|
+
() => null
|
|
394
|
+
);
|
|
395
|
+
if (started == null) return;
|
|
396
|
+
await started.onSandboxDelete({ reason: "conformance" }).catch(() => void 0);
|
|
397
|
+
throw new Error("a start whose policy report failed returned a sandbox");
|
|
398
|
+
});
|
|
399
|
+
}
|
|
344
400
|
await record("platform environment: reserved names refused", async () => {
|
|
345
401
|
const started = await startFromProvider(kit, provider, {
|
|
346
402
|
environmentOptions: platform.environmentOptions({
|
|
@@ -348,7 +404,7 @@ const runPlatformCases = async (args) => {
|
|
|
348
404
|
}),
|
|
349
405
|
ownBinding: true
|
|
350
406
|
}).then(
|
|
351
|
-
(handle) => handle,
|
|
407
|
+
({ handle }) => handle,
|
|
352
408
|
() => null
|
|
353
409
|
);
|
|
354
410
|
if (started == null) return;
|
|
@@ -387,8 +443,17 @@ const runSandboxConformance = async (args) => {
|
|
|
387
443
|
throw new Error("runSandboxConformance needs a handle or a provider");
|
|
388
444
|
const provider = args.provider;
|
|
389
445
|
await record("provider start", async () => {
|
|
390
|
-
started.handle = await startFromProvider(
|
|
446
|
+
({ handle: started.handle, awaitRunning: started.awaitRunning } = await startFromProvider(
|
|
447
|
+
args,
|
|
448
|
+
provider
|
|
449
|
+
));
|
|
391
450
|
});
|
|
451
|
+
const awaitRunning = started.awaitRunning;
|
|
452
|
+
if (awaitRunning != null)
|
|
453
|
+
await record(
|
|
454
|
+
"provider awaitRunning: resolves for a started sandbox",
|
|
455
|
+
() => awaitRunning(timeoutMs)
|
|
456
|
+
);
|
|
392
457
|
sandbox = started.handle?.sandbox ?? null;
|
|
393
458
|
}
|
|
394
459
|
if (sandbox == null) return { passed: false, cases };
|
|
@@ -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 noSandboxActingUser,\n noSandboxGuides,\n noSandboxRepositories,\n noSandboxVariables,\n SandboxEntryType,\n type AnySandboxProviderIface,\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.\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 case is 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}\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<SandboxProviderHandleIface<NetworkSandboxSessionIface>> => {\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 ...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 } = await implementation.start(startContext, args.openOptions, artifact);\n return handle;\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;\n// 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 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 await record('platform environment: provider start without it', async () => {\n withoutPlatform.handle = await startFromProvider(kit, provider, {\n environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),\n startContext: { platformEnvironment: undefined, platformEgressHosts: PLATFORM_EGRESS_HOSTS },\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 } 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 }\n } finally {\n await withoutPlatform.handle\n ?.onSandboxDelete({ reason: 'conformance' })\n .catch(() => undefined);\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 started.handle = await startFromProvider(args, provider);\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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",
|
|
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
6
|
"names": ["started"]
|
|
7
7
|
}
|
|
@@ -9,7 +9,9 @@ import {
|
|
|
9
9
|
PLATFORM_ENVIRONMENT_NAMES,
|
|
10
10
|
platformProcessEnvironment,
|
|
11
11
|
PortProtocol,
|
|
12
|
+
reportPlatformNetworkPolicy,
|
|
12
13
|
SandboxEntryType,
|
|
14
|
+
withPlatformEgressHosts,
|
|
13
15
|
writePlatformFiles
|
|
14
16
|
} from "./types.mjs";
|
|
15
17
|
const fsError = (code, message) => Object.assign(new Error(`${code}: ${message}`), { code });
|
|
@@ -372,7 +374,9 @@ const memoryEnvironmentSchema = z.object({
|
|
|
372
374
|
cwd: z.string().optional(),
|
|
373
375
|
ports: z.array(z.number().int()).optional(),
|
|
374
376
|
// Plain variables for every process, under the platform's.
|
|
375
|
-
env: z.record(z.string(), z.string()).optional()
|
|
377
|
+
env: z.record(z.string(), z.string()).optional(),
|
|
378
|
+
// Recorded, not enforced: the memory sandbox has no network.
|
|
379
|
+
networkPolicy: z.object({ mode: z.nativeEnum(NetworkPolicy), allow: z.array(z.string()).optional() }).optional()
|
|
376
380
|
}).nullable().optional();
|
|
377
381
|
const fingerprint = (value) => {
|
|
378
382
|
let hash = 2166136261;
|
|
@@ -406,14 +410,22 @@ const memorySandboxProvider = defineSandboxProvider({
|
|
|
406
410
|
files: artifact.files,
|
|
407
411
|
cwd: artifact.cwd,
|
|
408
412
|
ports: artifact.ports,
|
|
413
|
+
networkPolicy: options.networkPolicy != null,
|
|
409
414
|
baseEnv: platformProcessEnvironment(ctx, specEnv)
|
|
410
415
|
});
|
|
416
|
+
if (options.networkPolicy != null) {
|
|
417
|
+
const policy = withPlatformEgressHosts(ctx, options.networkPolicy);
|
|
418
|
+
await sandbox.setNetworkPolicy?.(policy);
|
|
419
|
+
await reportPlatformNetworkPolicy(ctx, policy);
|
|
420
|
+
}
|
|
411
421
|
await writePlatformFiles(ctx, sandbox);
|
|
412
422
|
return sandbox;
|
|
413
423
|
};
|
|
414
424
|
return {
|
|
415
425
|
artifactKey: async (ctx) => `memory:${fingerprint(JSON.stringify(artifactFor(ctx.files)))}`,
|
|
416
426
|
prepare: async (ctx) => artifactFor(ctx.files),
|
|
427
|
+
// An in-memory sandbox runs from the moment it exists.
|
|
428
|
+
awaitRunning: async () => void 0,
|
|
417
429
|
start: async (ctx, _openOptions, artifact) => ({
|
|
418
430
|
handle: memoryHandle(await open(ctx, ctx.session.bindingId, artifact)),
|
|
419
431
|
state: { id: ctx.session.bindingId }
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../../src/sandbox/memory-sandbox.ts"],
|
|
4
|
-
"sourcesContent": ["import * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport { encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { runMemoryArgv, runMemoryScript, type MemoryShellFsIface } from \"./memory-shell.mjs\";\nimport { normalizePosixPath, posixDirname, resolvePosixPath } from \"./paths.mjs\";\nimport {\n defineSandboxProvider,\n NetworkPolicy,\n PLATFORM_ENVIRONMENT_NAMES,\n platformProcessEnvironment,\n PortProtocol,\n SandboxEntryType,\n writePlatformFiles,\n type DirEntryIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n type StatIface,\n} from \"./types.mjs\";\n\n// An in-memory reference sandbox: a virtual filesystem plus a tiny command\n// interpreter (memory-shell.ts). Used by tests and the conformance kit, and as\n// the smallest complete example of the sandbox contract.\n\nexport interface MemorySandboxIface extends NetworkSandboxSessionIface {\n readonly networkPolicy: NetworkPolicyIface;\n readonly stopped: boolean;\n}\n\nexport interface CreateMemorySandboxArgsIface {\n id?: string;\n files?: Record<string, string | Uint8Array>;\n cwd?: string;\n ports?: number[];\n portUrl?: (args: { port: number; protocol: PortProtocol }) => string;\n // Optional capabilities; present only when given.\n computerUse?: () => Promise<SandboxMcpEndpoint>;\n screen?: NetworkSandboxSessionIface['screen'];\n localMcp?: () => Promise<SandboxMcpEndpoint[]>;\n networkPolicy?: boolean;\n // Every process's environment, under per-call env; read again for each process.\n baseEnv?: () => Promise<Record<string, string>>;\n now?: () => Date;\n}\n\ntype MemoryEntry =\n | { type: 'file'; data: Uint8Array; modifiedAt: Date }\n | { type: 'directory'; modifiedAt: Date };\n\ninterface ProcessOutputsIface {\n stdout: ReadableStreamDefaultController<Uint8Array> | null;\n stderr: ReadableStreamDefaultController<Uint8Array> | null;\n}\n\nconst fsError = (code: string, message: string) =>\n Object.assign(new Error(`${code}: ${message}`), { code });\n\nconst abortableSleep = (ms: number, signal: AbortSignal): Promise<void> =>\n new Promise<void>((resolve, reject) => {\n if (signal.aborted) {\n reject(signal.reason);\n return;\n }\n const timer = setTimeout(() => {\n signal.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n const onAbort = () => {\n clearTimeout(timer);\n reject(signal.reason);\n };\n signal.addEventListener('abort', onAbort, { once: true });\n });\n\nconst signalExitCode = (signal: string | undefined): number => {\n if (signal === 'SIGKILL' || signal === 'KILL' || signal === '9') return 137;\n if (signal === 'SIGINT' || signal === 'INT') return 130;\n return 143;\n};\n\nexport const createMemorySandbox = (\n args: CreateMemorySandboxArgsIface = {},\n): MemorySandboxIface => {\n const id = args.id ?? `memory-${crypto.randomUUID()}`;\n const cwd = normalizePosixPath(args.cwd ?? '/workspace');\n const now = args.now ?? (() => new Date());\n const entries = new Map<string, MemoryEntry>();\n const processes = new Set<SandboxProcessIface>();\n let networkPolicy: NetworkPolicyIface = { mode: NetworkPolicy.AllowAll };\n let stopped = false;\n\n const resolve = (path: string) => resolvePosixPath(cwd, path);\n\n const ensureDirectory = (path: string) => {\n const normalized = normalizePosixPath(path);\n const existing = entries.get(normalized);\n if (existing?.type === 'directory') return;\n if (existing?.type === 'file') throw fsError('ENOTDIR', `${normalized} is a file`);\n if (normalized !== '/') ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'directory', modifiedAt: now() });\n };\n\n const putFile = (path: string, data: Uint8Array) => {\n const normalized = normalizePosixPath(path);\n if (entries.get(normalized)?.type === 'directory')\n throw fsError('EISDIR', `${normalized} is a directory`);\n ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'file', data, modifiedAt: now() });\n };\n\n const children = (path: string): string[] => {\n const prefix = path === '/' ? '/' : `${path}/`;\n const names: string[] = [];\n for (const key of entries.keys()) {\n if (key !== path && key.startsWith(prefix) && !key.slice(prefix.length).includes('/')) {\n names.push(key.slice(prefix.length));\n }\n }\n return names.sort();\n };\n\n ensureDirectory('/');\n ensureDirectory(cwd);\n for (const [path, content] of Object.entries(args.files ?? {})) {\n putFile(resolve(path), content instanceof Uint8Array ? content : utf8Encode(content));\n }\n\n const shellFs: MemoryShellFsIface = {\n readFile: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry?.type === 'file' ? entry.data : null;\n },\n writeFile: (path, data, options) => {\n const entry = entries.get(normalizePosixPath(path));\n if (options.append && entry?.type === 'file') {\n const merged = new Uint8Array(entry.data.byteLength + data.byteLength);\n merged.set(entry.data, 0);\n merged.set(data, entry.data.byteLength);\n putFile(path, merged);\n return;\n }\n putFile(path, data);\n },\n kind: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry == null ? null : entry.type;\n },\n list: (path) => {\n const normalized = normalizePosixPath(path);\n return entries.get(normalized)?.type === 'directory' ? children(normalized) : null;\n },\n mkdir: (path, options) => {\n const normalized = normalizePosixPath(path);\n if (!options.parents && entries.get(posixDirname(normalized))?.type !== 'directory') {\n throw fsError('ENOENT', 'No such file or directory');\n }\n if (!options.parents && entries.has(normalized)) throw fsError('EEXIST', 'File exists');\n ensureDirectory(normalized);\n },\n };\n\n const statOf = (path: string): StatIface | null => {\n const entry = entries.get(path);\n if (entry == null) return null;\n return {\n path,\n type: entry.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: entry.type === 'file' ? entry.data.byteLength : 0,\n modifiedAt: entry.modifiedAt.toISOString(),\n mode: entry.type === 'file' ? 0o644 : 0o755,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const env = { ...(await args.baseEnv?.()), ...options.env };\n const controller = new AbortController();\n let killedWith: string | null = null;\n const outputs: ProcessOutputsIface = { stdout: null, stderr: null };\n const stdout = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stdout = c;\n },\n });\n const stderr = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stderr = c;\n },\n });\n let self: SandboxProcessIface | null = null;\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n const bytes = utf8Encode(options.stdin);\n stdinSource = new ReadableStream<Uint8Array>({\n start: (c) => {\n if (bytes.byteLength > 0) c.enqueue(bytes);\n c.close();\n },\n });\n }\n const stdinReader = stdinSource.getReader();\n const abortPromise = new Promise<null>((resolveAbort) =>\n controller.signal.addEventListener('abort', () => resolveAbort(null), { once: true }),\n );\n const readStdin = async (): Promise<Uint8Array | null> => {\n const result = await Promise.race([stdinReader.read(), abortPromise]);\n if (result == null) throw controller.signal.reason;\n return result.done ? null : result.value;\n };\n const emit = (\n target: ReadableStreamDefaultController<Uint8Array> | null,\n bytes: Uint8Array,\n ) => {\n if (bytes.byteLength > 0) target?.enqueue(bytes.slice());\n };\n const context = {\n fs: shellFs,\n io: {\n readStdin,\n stdout: (bytes: Uint8Array) => emit(outputs.stdout, bytes),\n stderr: (bytes: Uint8Array) => emit(outputs.stderr, bytes),\n signal: controller.signal,\n },\n cwd: options.cwd == null ? cwd : resolve(options.cwd),\n env,\n sleep: abortableSleep,\n };\n const timeout =\n options.timeoutMs == null\n ? null\n : setTimeout(() => {\n killedWith = 'timeout';\n controller.abort(new Error('timed out'));\n }, options.timeoutMs);\n const onAbortSignal = () => {\n killedWith ??= 'SIGTERM';\n controller.abort(new Error('aborted'));\n };\n options.abortSignal?.addEventListener('abort', onAbortSignal, { once: true });\n const exited = (async (): Promise<{ exitCode: number }> => {\n let exitCode: number;\n try {\n if (context.fs.kind(context.cwd) !== 'directory') {\n context.io.stderr(utf8Encode(`cd: ${context.cwd}: No such file or directory\\n`));\n exitCode = 1;\n } else if (options.shell === true) {\n const script = [options.command, ...(options.args ?? [])].join(' ');\n exitCode = await runMemoryScript({ ...context, script });\n } else {\n exitCode = await runMemoryArgv({\n ...context,\n argv: [options.command, ...(options.args ?? [])],\n });\n }\n } catch (error) {\n if (!controller.signal.aborted) {\n context.io.stderr(\n utf8Encode(`${error instanceof Error ? error.message : String(error)}\\n`),\n );\n exitCode = 1;\n } else {\n exitCode = killedWith === 'timeout' ? 124 : signalExitCode(killedWith ?? undefined);\n }\n }\n if (timeout != null) clearTimeout(timeout);\n options.abortSignal?.removeEventListener('abort', onAbortSignal);\n stdinReader.cancel().catch(() => undefined);\n outputs.stdout?.close();\n outputs.stderr?.close();\n if (self != null) processes.delete(self);\n return { exitCode };\n })();\n const child: SandboxProcessIface = {\n pid: null,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n wait: () => exited,\n kill: async (signal) => {\n killedWith ??= signal ?? 'SIGTERM';\n controller.abort(new Error(`killed (${signal ?? 'SIGTERM'})`));\n await exited;\n },\n };\n self = child;\n processes.add(child);\n return child;\n };\n\n const sandbox: MemorySandboxIface = {\n id,\n defaultWorkingDirectory: cwd,\n ports: args.ports ?? [],\n get description() {\n return `In-memory sandbox ${id}. Working directory ${cwd}. Commands: echo, cat, ls, pwd, cd, true, false, sleep, exit, mkdir, sh -c.`;\n },\n get networkPolicy() {\n return networkPolicy;\n },\n get stopped() {\n return stopped;\n },\n readFile: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) return null;\n if (entry.type === 'directory') throw fsError('EISDIR', `${path} is a directory`);\n const data = entry.data;\n const chunkBytes = 64 * 1024;\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= data.byteLength) {\n controller.close();\n return;\n }\n const end = Math.min(data.byteLength, offset + chunkBytes);\n controller.enqueue(data.slice(offset, end));\n offset = end;\n },\n });\n },\n readBinaryFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile: async (options) => {\n const data = await readAllBytes(options.content);\n putFile(resolve(options.path), data);\n },\n writeBinaryFile: async (options) => {\n putFile(resolve(options.path), options.content.slice());\n },\n writeTextFile: async (options) => {\n putFile(resolve(options.path), encodeSandboxText(options.content, options.encoding));\n },\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options) => statOf(resolve(options.path)),\n readDir: async (options): Promise<DirEntryIface[]> => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) throw fsError('ENOENT', `${path}: No such file or directory`);\n if (entry.type !== 'directory') throw fsError('ENOTDIR', `${path} is not a directory`);\n return children(path).map((name) => {\n const childPath = path === '/' ? `/${name}` : `${path}/${name}`;\n const child = entries.get(childPath);\n return {\n name,\n path: childPath,\n type: child?.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: child?.type === 'file' ? child.data.byteLength : null,\n };\n });\n },\n resolvePath: resolve,\n removePath: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) {\n if (options.force === true) return;\n throw fsError('ENOENT', `${path}: No such file or directory`);\n }\n if (path === '/') throw fsError('EPERM', 'refusing to remove /');\n if (entry.type === 'directory') {\n const prefix = `${path}/`;\n const nested = [...entries.keys()].filter((key) => key.startsWith(prefix));\n if (nested.length > 0 && options.recursive !== true)\n throw fsError('ENOTEMPTY', `${path}: Directory not empty`);\n for (const key of nested) entries.delete(key);\n }\n entries.delete(path);\n },\n getPortEndpoint: async (options) => {\n const protocol = options.protocol ?? PortProtocol.Http;\n return {\n url:\n args.portUrl?.({ port: options.port, protocol }) ??\n `${protocol}://127.0.0.1:${options.port}`,\n };\n },\n getPortUrl: async (options) => (await sandbox.getPortEndpoint(options)).url,\n stop: async () => {\n stopped = true;\n await Promise.all([...processes].map((child) => child.kill()));\n },\n destroy: async () => {\n await sandbox.stop();\n entries.clear();\n ensureDirectory('/');\n },\n };\n if (args.networkPolicy === true) {\n sandbox.setNetworkPolicy = async (policy) => {\n networkPolicy = policy;\n };\n }\n if (args.computerUse != null) sandbox.computerUse = args.computerUse;\n if (args.screen != null) sandbox.screen = args.screen;\n if (args.localMcp != null) sandbox.localMcp = args.localMcp;\n return sandbox;\n};\n\n// Every file of a memory sandbox as path \u2192 base64-free UTF-8 text (binary\n// files are skipped); handy for assertions.\nexport const memorySandboxTextFiles = async (\n sandbox: NetworkSandboxSessionIface,\n root = '/',\n): Promise<Record<string, string>> => {\n const out: Record<string, string> = {};\n const walk = async (path: string) => {\n for (const entry of await sandbox.readDir({ path })) {\n if (entry.type === SandboxEntryType.Directory) await walk(entry.path);\n else {\n const text = await sandbox.readTextFile({ path: entry.path });\n if (text != null) out[entry.path] = text;\n }\n }\n };\n await walk(root);\n return out;\n};\n\nconst memoryEnvironmentSchema = z\n .object({\n files: z.record(z.string(), z.string()).optional(),\n cwd: z.string().optional(),\n ports: z.array(z.number().int()).optional(),\n // Plain variables for every process, under the platform's.\n env: z.record(z.string(), z.string()).optional(),\n })\n .nullable()\n .optional();\n\nexport type MemorySandboxArtifact = { files: Record<string, string>; cwd: string; ports: number[] };\nexport type MemorySandboxState = { id: string };\n\nconst fingerprint = (value: string): string => {\n // FNV-1a, enough for a content key in an example provider.\n let hash = 0x811c9dc5;\n for (let i = 0; i < value.length; i += 1) {\n hash ^= value.charCodeAt(i);\n hash = Math.imul(hash, 0x01000193) >>> 0;\n }\n return hash.toString(16).padStart(8, '0');\n};\n\nconst memoryHandle = (\n sandbox: MemorySandboxIface,\n): SandboxProviderHandleIface<MemorySandboxIface> => ({\n sandbox,\n onSandboxStop: () => sandbox.stop(),\n onSandboxDelete: () => sandbox.destroy(),\n onRuntimeShutdown: () => sandbox.stop(),\n});\n\n// Example provider over the memory sandbox. Ephemeral: `resume` starts again\n// from the prepared artifact, so files written before a park are lost.\nexport const memorySandboxProvider = defineSandboxProvider<\n JsonValue,\n JsonValue,\n MemorySandboxArtifact,\n MemorySandboxState,\n MemorySandboxIface\n>({\n name: 'memory',\n environment: (rawOptions) => {\n const options = memoryEnvironmentSchema.parse(rawOptions) ?? {};\n const artifactFor = (files: Record<string, string>): MemorySandboxArtifact => ({\n files: { ...options.files, ...files },\n cwd: options.cwd ?? '/workspace',\n ports: options.ports ?? [],\n });\n const specEnv = options.env ?? {};\n const open = async (\n ctx: SandboxStartContextIface,\n bindingId: string,\n artifact: MemorySandboxArtifact,\n ) => {\n for (const name of Object.keys(specEnv))\n if (PLATFORM_ENVIRONMENT_NAMES.has(name)) throw new Error(`${name} is reserved`);\n const sandbox = createMemorySandbox({\n id: bindingId,\n files: artifact.files,\n cwd: artifact.cwd,\n ports: artifact.ports,\n baseEnv: platformProcessEnvironment(ctx, specEnv),\n });\n await writePlatformFiles(ctx, sandbox);\n return sandbox;\n };\n return {\n artifactKey: async (ctx) => `memory:${fingerprint(JSON.stringify(artifactFor(ctx.files)))}`,\n prepare: async (ctx) => artifactFor(ctx.files),\n start: async (ctx, _openOptions, artifact) => ({\n handle: memoryHandle(await open(ctx, ctx.session.bindingId, artifact)),\n state: { id: ctx.session.bindingId },\n }),\n resume: async (ctx, artifact, state) => memoryHandle(await open(ctx, state.id, artifact)),\n park: async (_ctx, _artifact, state) => state,\n };\n },\n});\n"],
|
|
5
|
-
"mappings": "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",
|
|
4
|
+
"sourcesContent": ["import * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport { encodeSandboxText, readAllBytes, utf8Encode } from \"./bytes.mjs\";\nimport { readTextFileStream, runCollect } from \"./convenience.mjs\";\nimport { runMemoryArgv, runMemoryScript, type MemoryShellFsIface } from \"./memory-shell.mjs\";\nimport { normalizePosixPath, posixDirname, resolvePosixPath } from \"./paths.mjs\";\nimport {\n defineSandboxProvider,\n NetworkPolicy,\n PLATFORM_ENVIRONMENT_NAMES,\n platformProcessEnvironment,\n PortProtocol,\n reportPlatformNetworkPolicy,\n SandboxEntryType,\n withPlatformEgressHosts,\n writePlatformFiles,\n type DirEntryIface,\n type NetworkPolicyIface,\n type NetworkSandboxSessionIface,\n type SandboxMcpEndpoint,\n type SandboxProcessIface,\n type SandboxProcessOptionsIface,\n type SandboxProviderHandleIface,\n type SandboxStartContextIface,\n type StatIface,\n} from \"./types.mjs\";\n\n// An in-memory reference sandbox: a virtual filesystem plus a tiny command\n// interpreter (memory-shell.ts). Used by tests and the conformance kit, and as\n// the smallest complete example of the sandbox contract.\n\nexport interface MemorySandboxIface extends NetworkSandboxSessionIface {\n readonly networkPolicy: NetworkPolicyIface;\n readonly stopped: boolean;\n}\n\nexport interface CreateMemorySandboxArgsIface {\n id?: string;\n files?: Record<string, string | Uint8Array>;\n cwd?: string;\n ports?: number[];\n portUrl?: (args: { port: number; protocol: PortProtocol }) => string;\n // Optional capabilities; present only when given.\n computerUse?: () => Promise<SandboxMcpEndpoint>;\n screen?: NetworkSandboxSessionIface['screen'];\n localMcp?: () => Promise<SandboxMcpEndpoint[]>;\n networkPolicy?: boolean;\n // Every process's environment, under per-call env; read again for each process.\n baseEnv?: () => Promise<Record<string, string>>;\n now?: () => Date;\n}\n\ntype MemoryEntry =\n | { type: 'file'; data: Uint8Array; modifiedAt: Date }\n | { type: 'directory'; modifiedAt: Date };\n\ninterface ProcessOutputsIface {\n stdout: ReadableStreamDefaultController<Uint8Array> | null;\n stderr: ReadableStreamDefaultController<Uint8Array> | null;\n}\n\nconst fsError = (code: string, message: string) =>\n Object.assign(new Error(`${code}: ${message}`), { code });\n\nconst abortableSleep = (ms: number, signal: AbortSignal): Promise<void> =>\n new Promise<void>((resolve, reject) => {\n if (signal.aborted) {\n reject(signal.reason);\n return;\n }\n const timer = setTimeout(() => {\n signal.removeEventListener('abort', onAbort);\n resolve();\n }, ms);\n const onAbort = () => {\n clearTimeout(timer);\n reject(signal.reason);\n };\n signal.addEventListener('abort', onAbort, { once: true });\n });\n\nconst signalExitCode = (signal: string | undefined): number => {\n if (signal === 'SIGKILL' || signal === 'KILL' || signal === '9') return 137;\n if (signal === 'SIGINT' || signal === 'INT') return 130;\n return 143;\n};\n\nexport const createMemorySandbox = (\n args: CreateMemorySandboxArgsIface = {},\n): MemorySandboxIface => {\n const id = args.id ?? `memory-${crypto.randomUUID()}`;\n const cwd = normalizePosixPath(args.cwd ?? '/workspace');\n const now = args.now ?? (() => new Date());\n const entries = new Map<string, MemoryEntry>();\n const processes = new Set<SandboxProcessIface>();\n let networkPolicy: NetworkPolicyIface = { mode: NetworkPolicy.AllowAll };\n let stopped = false;\n\n const resolve = (path: string) => resolvePosixPath(cwd, path);\n\n const ensureDirectory = (path: string) => {\n const normalized = normalizePosixPath(path);\n const existing = entries.get(normalized);\n if (existing?.type === 'directory') return;\n if (existing?.type === 'file') throw fsError('ENOTDIR', `${normalized} is a file`);\n if (normalized !== '/') ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'directory', modifiedAt: now() });\n };\n\n const putFile = (path: string, data: Uint8Array) => {\n const normalized = normalizePosixPath(path);\n if (entries.get(normalized)?.type === 'directory')\n throw fsError('EISDIR', `${normalized} is a directory`);\n ensureDirectory(posixDirname(normalized));\n entries.set(normalized, { type: 'file', data, modifiedAt: now() });\n };\n\n const children = (path: string): string[] => {\n const prefix = path === '/' ? '/' : `${path}/`;\n const names: string[] = [];\n for (const key of entries.keys()) {\n if (key !== path && key.startsWith(prefix) && !key.slice(prefix.length).includes('/')) {\n names.push(key.slice(prefix.length));\n }\n }\n return names.sort();\n };\n\n ensureDirectory('/');\n ensureDirectory(cwd);\n for (const [path, content] of Object.entries(args.files ?? {})) {\n putFile(resolve(path), content instanceof Uint8Array ? content : utf8Encode(content));\n }\n\n const shellFs: MemoryShellFsIface = {\n readFile: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry?.type === 'file' ? entry.data : null;\n },\n writeFile: (path, data, options) => {\n const entry = entries.get(normalizePosixPath(path));\n if (options.append && entry?.type === 'file') {\n const merged = new Uint8Array(entry.data.byteLength + data.byteLength);\n merged.set(entry.data, 0);\n merged.set(data, entry.data.byteLength);\n putFile(path, merged);\n return;\n }\n putFile(path, data);\n },\n kind: (path) => {\n const entry = entries.get(normalizePosixPath(path));\n return entry == null ? null : entry.type;\n },\n list: (path) => {\n const normalized = normalizePosixPath(path);\n return entries.get(normalized)?.type === 'directory' ? children(normalized) : null;\n },\n mkdir: (path, options) => {\n const normalized = normalizePosixPath(path);\n if (!options.parents && entries.get(posixDirname(normalized))?.type !== 'directory') {\n throw fsError('ENOENT', 'No such file or directory');\n }\n if (!options.parents && entries.has(normalized)) throw fsError('EEXIST', 'File exists');\n ensureDirectory(normalized);\n },\n };\n\n const statOf = (path: string): StatIface | null => {\n const entry = entries.get(path);\n if (entry == null) return null;\n return {\n path,\n type: entry.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: entry.type === 'file' ? entry.data.byteLength : 0,\n modifiedAt: entry.modifiedAt.toISOString(),\n mode: entry.type === 'file' ? 0o644 : 0o755,\n };\n };\n\n const spawn = async (options: SandboxProcessOptionsIface): Promise<SandboxProcessIface> => {\n const env = { ...(await args.baseEnv?.()), ...options.env };\n const controller = new AbortController();\n let killedWith: string | null = null;\n const outputs: ProcessOutputsIface = { stdout: null, stderr: null };\n const stdout = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stdout = c;\n },\n });\n const stderr = new ReadableStream<Uint8Array>({\n start: (c) => {\n outputs.stderr = c;\n },\n });\n let self: SandboxProcessIface | null = null;\n let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = null;\n let stdinSource: ReadableStream<Uint8Array>;\n if (options.stdin == null) {\n const pipe = new TransformStream<Uint8Array, Uint8Array>();\n stdinWriter = pipe.writable.getWriter();\n stdinSource = pipe.readable;\n } else if (options.stdin instanceof ReadableStream) {\n stdinSource = options.stdin;\n } else {\n const bytes = utf8Encode(options.stdin);\n stdinSource = new ReadableStream<Uint8Array>({\n start: (c) => {\n if (bytes.byteLength > 0) c.enqueue(bytes);\n c.close();\n },\n });\n }\n const stdinReader = stdinSource.getReader();\n const abortPromise = new Promise<null>((resolveAbort) =>\n controller.signal.addEventListener('abort', () => resolveAbort(null), { once: true }),\n );\n const readStdin = async (): Promise<Uint8Array | null> => {\n const result = await Promise.race([stdinReader.read(), abortPromise]);\n if (result == null) throw controller.signal.reason;\n return result.done ? null : result.value;\n };\n const emit = (\n target: ReadableStreamDefaultController<Uint8Array> | null,\n bytes: Uint8Array,\n ) => {\n if (bytes.byteLength > 0) target?.enqueue(bytes.slice());\n };\n const context = {\n fs: shellFs,\n io: {\n readStdin,\n stdout: (bytes: Uint8Array) => emit(outputs.stdout, bytes),\n stderr: (bytes: Uint8Array) => emit(outputs.stderr, bytes),\n signal: controller.signal,\n },\n cwd: options.cwd == null ? cwd : resolve(options.cwd),\n env,\n sleep: abortableSleep,\n };\n const timeout =\n options.timeoutMs == null\n ? null\n : setTimeout(() => {\n killedWith = 'timeout';\n controller.abort(new Error('timed out'));\n }, options.timeoutMs);\n const onAbortSignal = () => {\n killedWith ??= 'SIGTERM';\n controller.abort(new Error('aborted'));\n };\n options.abortSignal?.addEventListener('abort', onAbortSignal, { once: true });\n const exited = (async (): Promise<{ exitCode: number }> => {\n let exitCode: number;\n try {\n if (context.fs.kind(context.cwd) !== 'directory') {\n context.io.stderr(utf8Encode(`cd: ${context.cwd}: No such file or directory\\n`));\n exitCode = 1;\n } else if (options.shell === true) {\n const script = [options.command, ...(options.args ?? [])].join(' ');\n exitCode = await runMemoryScript({ ...context, script });\n } else {\n exitCode = await runMemoryArgv({\n ...context,\n argv: [options.command, ...(options.args ?? [])],\n });\n }\n } catch (error) {\n if (!controller.signal.aborted) {\n context.io.stderr(\n utf8Encode(`${error instanceof Error ? error.message : String(error)}\\n`),\n );\n exitCode = 1;\n } else {\n exitCode = killedWith === 'timeout' ? 124 : signalExitCode(killedWith ?? undefined);\n }\n }\n if (timeout != null) clearTimeout(timeout);\n options.abortSignal?.removeEventListener('abort', onAbortSignal);\n stdinReader.cancel().catch(() => undefined);\n outputs.stdout?.close();\n outputs.stderr?.close();\n if (self != null) processes.delete(self);\n return { exitCode };\n })();\n const child: SandboxProcessIface = {\n pid: null,\n stdout,\n stderr,\n write: async (data, writeOptions) => {\n if (stdinWriter == null) throw new Error('stdin was provided at spawn');\n const bytes = data instanceof Uint8Array ? data : utf8Encode(data);\n if (bytes.byteLength > 0) await stdinWriter.write(bytes);\n if (writeOptions?.end === true) await stdinWriter.close();\n },\n wait: () => exited,\n kill: async (signal) => {\n killedWith ??= signal ?? 'SIGTERM';\n controller.abort(new Error(`killed (${signal ?? 'SIGTERM'})`));\n await exited;\n },\n };\n self = child;\n processes.add(child);\n return child;\n };\n\n const sandbox: MemorySandboxIface = {\n id,\n defaultWorkingDirectory: cwd,\n ports: args.ports ?? [],\n get description() {\n return `In-memory sandbox ${id}. Working directory ${cwd}. Commands: echo, cat, ls, pwd, cd, true, false, sleep, exit, mkdir, sh -c.`;\n },\n get networkPolicy() {\n return networkPolicy;\n },\n get stopped() {\n return stopped;\n },\n readFile: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) return null;\n if (entry.type === 'directory') throw fsError('EISDIR', `${path} is a directory`);\n const data = entry.data;\n const chunkBytes = 64 * 1024;\n let offset = 0;\n return new ReadableStream<Uint8Array>({\n pull: (controller) => {\n if (offset >= data.byteLength) {\n controller.close();\n return;\n }\n const end = Math.min(data.byteLength, offset + chunkBytes);\n controller.enqueue(data.slice(offset, end));\n offset = end;\n },\n });\n },\n readBinaryFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readAllBytes(stream);\n },\n readTextFile: async (options) => {\n const stream = await sandbox.readFile(options);\n return stream == null ? null : readTextFileStream(stream, options);\n },\n writeFile: async (options) => {\n const data = await readAllBytes(options.content);\n putFile(resolve(options.path), data);\n },\n writeBinaryFile: async (options) => {\n putFile(resolve(options.path), options.content.slice());\n },\n writeTextFile: async (options) => {\n putFile(resolve(options.path), encodeSandboxText(options.content, options.encoding));\n },\n spawn,\n run: (options) => runCollect({ spawn }, options),\n stat: async (options) => statOf(resolve(options.path)),\n readDir: async (options): Promise<DirEntryIface[]> => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) throw fsError('ENOENT', `${path}: No such file or directory`);\n if (entry.type !== 'directory') throw fsError('ENOTDIR', `${path} is not a directory`);\n return children(path).map((name) => {\n const childPath = path === '/' ? `/${name}` : `${path}/${name}`;\n const child = entries.get(childPath);\n return {\n name,\n path: childPath,\n type: child?.type === 'file' ? SandboxEntryType.File : SandboxEntryType.Directory,\n size: child?.type === 'file' ? child.data.byteLength : null,\n };\n });\n },\n resolvePath: resolve,\n removePath: async (options) => {\n const path = resolve(options.path);\n const entry = entries.get(path);\n if (entry == null) {\n if (options.force === true) return;\n throw fsError('ENOENT', `${path}: No such file or directory`);\n }\n if (path === '/') throw fsError('EPERM', 'refusing to remove /');\n if (entry.type === 'directory') {\n const prefix = `${path}/`;\n const nested = [...entries.keys()].filter((key) => key.startsWith(prefix));\n if (nested.length > 0 && options.recursive !== true)\n throw fsError('ENOTEMPTY', `${path}: Directory not empty`);\n for (const key of nested) entries.delete(key);\n }\n entries.delete(path);\n },\n getPortEndpoint: async (options) => {\n const protocol = options.protocol ?? PortProtocol.Http;\n return {\n url:\n args.portUrl?.({ port: options.port, protocol }) ??\n `${protocol}://127.0.0.1:${options.port}`,\n };\n },\n getPortUrl: async (options) => (await sandbox.getPortEndpoint(options)).url,\n stop: async () => {\n stopped = true;\n await Promise.all([...processes].map((child) => child.kill()));\n },\n destroy: async () => {\n await sandbox.stop();\n entries.clear();\n ensureDirectory('/');\n },\n };\n if (args.networkPolicy === true) {\n sandbox.setNetworkPolicy = async (policy) => {\n networkPolicy = policy;\n };\n }\n if (args.computerUse != null) sandbox.computerUse = args.computerUse;\n if (args.screen != null) sandbox.screen = args.screen;\n if (args.localMcp != null) sandbox.localMcp = args.localMcp;\n return sandbox;\n};\n\n// Every file of a memory sandbox as path \u2192 base64-free UTF-8 text (binary\n// files are skipped); handy for assertions.\nexport const memorySandboxTextFiles = async (\n sandbox: NetworkSandboxSessionIface,\n root = '/',\n): Promise<Record<string, string>> => {\n const out: Record<string, string> = {};\n const walk = async (path: string) => {\n for (const entry of await sandbox.readDir({ path })) {\n if (entry.type === SandboxEntryType.Directory) await walk(entry.path);\n else {\n const text = await sandbox.readTextFile({ path: entry.path });\n if (text != null) out[entry.path] = text;\n }\n }\n };\n await walk(root);\n return out;\n};\n\nconst memoryEnvironmentSchema = z\n .object({\n files: z.record(z.string(), z.string()).optional(),\n cwd: z.string().optional(),\n ports: z.array(z.number().int()).optional(),\n // Plain variables for every process, under the platform's.\n env: z.record(z.string(), z.string()).optional(),\n // Recorded, not enforced: the memory sandbox has no network.\n networkPolicy: z\n .object({ mode: z.nativeEnum(NetworkPolicy), allow: z.array(z.string()).optional() })\n .optional(),\n })\n .nullable()\n .optional();\n\nexport type MemorySandboxArtifact = { files: Record<string, string>; cwd: string; ports: number[] };\nexport type MemorySandboxState = { id: string };\n\nconst fingerprint = (value: string): string => {\n // FNV-1a, enough for a content key in an example provider.\n let hash = 0x811c9dc5;\n for (let i = 0; i < value.length; i += 1) {\n hash ^= value.charCodeAt(i);\n hash = Math.imul(hash, 0x01000193) >>> 0;\n }\n return hash.toString(16).padStart(8, '0');\n};\n\nconst memoryHandle = (\n sandbox: MemorySandboxIface,\n): SandboxProviderHandleIface<MemorySandboxIface> => ({\n sandbox,\n onSandboxStop: () => sandbox.stop(),\n onSandboxDelete: () => sandbox.destroy(),\n onRuntimeShutdown: () => sandbox.stop(),\n});\n\n// Example provider over the memory sandbox. Ephemeral: `resume` starts again\n// from the prepared artifact, so files written before a park are lost.\nexport const memorySandboxProvider = defineSandboxProvider<\n JsonValue,\n JsonValue,\n MemorySandboxArtifact,\n MemorySandboxState,\n MemorySandboxIface\n>({\n name: 'memory',\n environment: (rawOptions) => {\n const options = memoryEnvironmentSchema.parse(rawOptions) ?? {};\n const artifactFor = (files: Record<string, string>): MemorySandboxArtifact => ({\n files: { ...options.files, ...files },\n cwd: options.cwd ?? '/workspace',\n ports: options.ports ?? [],\n });\n const specEnv = options.env ?? {};\n const open = async (\n ctx: SandboxStartContextIface,\n bindingId: string,\n artifact: MemorySandboxArtifact,\n ) => {\n for (const name of Object.keys(specEnv))\n if (PLATFORM_ENVIRONMENT_NAMES.has(name)) throw new Error(`${name} is reserved`);\n const sandbox = createMemorySandbox({\n id: bindingId,\n files: artifact.files,\n cwd: artifact.cwd,\n ports: artifact.ports,\n networkPolicy: options.networkPolicy != null,\n baseEnv: platformProcessEnvironment(ctx, specEnv),\n });\n if (options.networkPolicy != null) {\n const policy = withPlatformEgressHosts(ctx, options.networkPolicy);\n await sandbox.setNetworkPolicy?.(policy);\n await reportPlatformNetworkPolicy(ctx, policy);\n }\n await writePlatformFiles(ctx, sandbox);\n return sandbox;\n };\n return {\n artifactKey: async (ctx) => `memory:${fingerprint(JSON.stringify(artifactFor(ctx.files)))}`,\n prepare: async (ctx) => artifactFor(ctx.files),\n // An in-memory sandbox runs from the moment it exists.\n awaitRunning: async () => undefined,\n start: async (ctx, _openOptions, artifact) => ({\n handle: memoryHandle(await open(ctx, ctx.session.bindingId, artifact)),\n state: { id: ctx.session.bindingId },\n }),\n resume: async (ctx, artifact, state) => memoryHandle(await open(ctx, state.id, artifact)),\n park: async (_ctx, _artifact, state) => state,\n };\n },\n});\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -293,11 +293,13 @@ export interface SandboxStartContextIface {
|
|
|
293
293
|
actingUser: SandboxActingUserIface;
|
|
294
294
|
platformEnvironment?: () => Promise<Record<string, string>>;
|
|
295
295
|
platformEgressHosts?: string[];
|
|
296
|
+
platformNetworkPolicy: (policy: NetworkPolicyIface) => Promise<void>;
|
|
296
297
|
platformFiles?: () => Promise<Record<string, string>>;
|
|
297
298
|
}
|
|
298
299
|
export declare const PLATFORM_ENVIRONMENT_NAMES: ReadonlySet<string>;
|
|
299
300
|
export declare const platformProcessEnvironment: (ctx: Pick<SandboxStartContextIface, "platformEnvironment">, specEnv: Record<string, string>) => (() => Promise<Record<string, string>>);
|
|
300
301
|
export declare const writePlatformFiles: (ctx: Pick<SandboxStartContextIface, "platformFiles">, sandbox: Pick<SandboxSessionIface, "writeTextFile">) => Promise<void>;
|
|
302
|
+
export declare const reportPlatformNetworkPolicy: (ctx: Pick<SandboxStartContextIface, "platformNetworkPolicy">, policy: NetworkPolicyIface) => Promise<void>;
|
|
301
303
|
export declare const withPlatformEgressHosts: (ctx: Pick<SandboxStartContextIface, "platformEgressHosts">, policy: NetworkPolicyIface) => NetworkPolicyIface;
|
|
302
304
|
export declare enum SandboxSessionEndReason {
|
|
303
305
|
Completed = "completed",
|
|
@@ -320,6 +322,9 @@ export interface SandboxProviderImplementationIface<OpenOptions, Artifact extend
|
|
|
320
322
|
editor?(ctx: SandboxOfferContextIface, state: State, request: SandboxEditorRequestIface): Promise<SandboxEditorResultIface>;
|
|
321
323
|
artifactKey(ctx: SandboxPrepareContextIface): Promise<string>;
|
|
322
324
|
prepare(ctx: SandboxPrepareContextIface): Promise<Artifact>;
|
|
325
|
+
awaitRunning(ctx: SandboxStartContextIface, state: State, options: {
|
|
326
|
+
timeoutMs: number;
|
|
327
|
+
}): Promise<void>;
|
|
323
328
|
start(ctx: SandboxStartContextIface, options: OpenOptions | undefined, artifact: Artifact): Promise<{
|
|
324
329
|
handle: SandboxProviderHandleIface<S>;
|
|
325
330
|
state: State;
|
|
@@ -61,6 +61,9 @@ const writePlatformFiles = async (ctx, sandbox) => {
|
|
|
61
61
|
for (const [path, content] of Object.entries(await ctx.platformFiles?.() ?? {}))
|
|
62
62
|
await sandbox.writeTextFile({ path, content });
|
|
63
63
|
};
|
|
64
|
+
const reportPlatformNetworkPolicy = async (ctx, policy) => ctx.platformNetworkPolicy(
|
|
65
|
+
policy.mode === "allowlist" /* Allowlist */ ? { mode: policy.mode, allow: [...policy.allow ?? []] } : { mode: policy.mode }
|
|
66
|
+
);
|
|
64
67
|
const withPlatformEgressHosts = (ctx, policy) => {
|
|
65
68
|
const hosts = ctx.platformEgressHosts ?? [];
|
|
66
69
|
if (policy.mode !== "allowlist" /* Allowlist */ || hosts.length === 0) return policy;
|
|
@@ -79,7 +82,17 @@ var SandboxWorkspace = /* @__PURE__ */ ((SandboxWorkspace2) => {
|
|
|
79
82
|
return SandboxWorkspace2;
|
|
80
83
|
})(SandboxWorkspace || {});
|
|
81
84
|
const defineSandboxProvider = (definition) => ({
|
|
82
|
-
|
|
85
|
+
// An implementation exists only once its options are given, so awaitRunning is
|
|
86
|
+
// checked as each environment is defined, before anything can start from it.
|
|
87
|
+
definition: {
|
|
88
|
+
...definition,
|
|
89
|
+
environment: (options) => {
|
|
90
|
+
const implementation = definition.environment(options);
|
|
91
|
+
if (typeof implementation.awaitRunning !== "function")
|
|
92
|
+
throw new Error(`sandbox provider ${definition.name} does not implement awaitRunning`);
|
|
93
|
+
return implementation;
|
|
94
|
+
}
|
|
95
|
+
},
|
|
83
96
|
name: definition.name,
|
|
84
97
|
environment: (options) => ({
|
|
85
98
|
providerName: definition.name,
|
|
@@ -111,6 +124,7 @@ export {
|
|
|
111
124
|
noSandboxRepositories,
|
|
112
125
|
noSandboxVariables,
|
|
113
126
|
platformProcessEnvironment,
|
|
127
|
+
reportPlatformNetworkPolicy,
|
|
114
128
|
withPlatformEgressHosts,
|
|
115
129
|
writePlatformFiles
|
|
116
130
|
};
|