@finalai/agent-provider 0.1.5 → 0.1.7

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/HOSTING.md CHANGED
@@ -21,6 +21,24 @@ Neither rewrites authored URLs. A GitHub-backed definition uses remote source;
21
21
  push edits before explicitly publishing a ref. Caller API keys never become agent
22
22
  credentials merely because they were used to publish.
23
23
 
24
+ ## Hosted model resolution (SDK 0.2.0)
25
+
26
+ Hosted Final, Pi, Codex and Claude configurations accept string model references.
27
+ `serverless*ConfigSchema.parse(...).model` can be undefined: the host must choose
28
+ its catalog default, resolve aliases and validate availability before dispatch.
29
+ The host owns current candidates, runtime capabilities and dated prices, and
30
+ advertises picker choices through its harness descriptions. Compilation remains
31
+ offline and checks reference syntax.
32
+
33
+ SDK 0.2.0 removes `@finalai/agents/models` and
34
+ `@finalai/final-agent-provider/harnesses/models`, including their model arrays,
35
+ defaults, model-ID unions and pricing helpers. Migrate callers to string model
36
+ references and host-owned discovery, metadata and pricing.
37
+
38
+ Publish the SDK release before upgrading host dependencies. Ship the host's
39
+ catalog/default implementation together with its SDK dependency upgrade; a host
40
+ that only changes the dependency will lose the old default and catalog APIs.
41
+
24
42
  ## Hosted connections
25
43
 
26
44
  ```ts
@@ -99,15 +117,37 @@ export default defineFinalConnection({
99
117
  });
100
118
  ```
101
119
 
102
- Without `load`, the harness lists every exposed tool, as before. With it, the host
103
- lists only the loaded tools and must keep every other exposed tool reachable: it
104
- serves a search over the connection's remaining exposed tools (name, description,
105
- input schema) and a call that runs a found tool by its real name, with the same
106
- exposure and approval checks as a direct call. A host may instead add a found tool
107
- to the list and send `notifications/tools/list_changed`; harnesses that ignore that
108
- notification still need the call path. `load: []` leaves every tool to search.
109
- Entries are tool names or `*` patterns. `isToolLoaded` from `@finalai/agent-provider`
110
- applies the rule after exposure.
120
+ With `load`, the host lists only the loaded tools and must keep every other exposed
121
+ tool reachable: it serves a search over the connection's remaining exposed tools
122
+ (name, description, input schema) and a call that runs a found tool by its real
123
+ name, with the same exposure and approval checks as a direct call. A host may
124
+ instead add a found tool to the list and send `notifications/tools/list_changed`;
125
+ harnesses that ignore that notification still need the call path. `load: []`
126
+ leaves every tool to search. Entries are tool names or `*` patterns.
127
+ `isToolLoaded` from `@finalai/agent-provider` applies the rule after exposure.
128
+
129
+ Without `load`, the harness lists the connection's exposed tools except:
130
+
131
+ - **Connector tools.** A server can label a tool with the connector it belongs to
132
+ in the tool's `_meta`:
133
+ `{ "ai.final/connector": { "namespace": "salesforce", "name": "Salesforce" } }`.
134
+ The namespace identifies the connector (unique within the server's tools); the
135
+ name is for display, and two connectors may share one. Final's server labels
136
+ every connector tool with the namespace and name of the install it comes from.
137
+ The host never lists labelled tools up front. Its search tool names each
138
+ connector and how many tools it has, so the agent knows what is connected
139
+ without any of those definitions in its context, and searches for the tools it
140
+ needs. A `load` entry that names a labelled tool still lists it.
141
+ - **Tools past a size limit.** When a connection exposes more unlabelled tools
142
+ than the host lists directly (100 in Final's host), those are searched too.
143
+
144
+ A harness that declares `supports.deferredToolSearch` defers and searches tools
145
+ itself, so the host lists every exposed tool to it and serves no search.
146
+
147
+ A host's search should name the connectors it covers and accept a connector's
148
+ namespace to narrow to. Once a host has listed its search and call tools, it keeps answering them for
149
+ that harness even if the connection stops hiding tools, unless the connection
150
+ then lists its own tool by one of those names.
111
151
 
112
152
  ## Selecting tools by annotation
113
153
 
@@ -11,6 +11,14 @@ export interface RunSandboxConformanceArgsIface {
11
11
  viaWire?: boolean;
12
12
  largeFileBytes?: number;
13
13
  timeoutMs?: number;
14
+ platform?: SandboxPlatformConformanceIface;
15
+ }
16
+ export interface SandboxPlatformConformanceIface {
17
+ environmentOptions(args: {
18
+ env: Record<string, string>;
19
+ allow?: string[];
20
+ }): JsonValue;
21
+ observedAllowlist?(sandbox: NetworkSandboxSessionIface): Promise<readonly string[] | null>;
14
22
  }
15
23
  export interface SandboxConformanceReportIface {
16
24
  passed: boolean;
@@ -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,
@@ -182,8 +183,10 @@ const sandboxCases = (largeFileBytes) => [
182
183
  }
183
184
  }
184
185
  ];
185
- const startFromProvider = async (args, provider) => {
186
- const implementation = provider.definition.environment(args.environmentOptions);
186
+ const startFromProvider = async (args, provider, overrides = {}) => {
187
+ const implementation = provider.definition.environment(
188
+ overrides.environmentOptions ?? args.environmentOptions
189
+ );
187
190
  const prepareContext = {
188
191
  files: {},
189
192
  resources: {},
@@ -209,10 +212,205 @@ const startFromProvider = async (args, provider) => {
209
212
  variables: noSandboxVariables,
210
213
  repositories: noSandboxRepositories,
211
214
  actingUser: noSandboxActingUser,
212
- ...args.startContext
215
+ platformNetworkPolicy: async () => void 0,
216
+ ...args.startContext,
217
+ ...overrides.startContext
213
218
  };
214
- const { handle } = await implementation.start(startContext, args.openOptions, artifact);
215
- return handle;
219
+ if (overrides.ownBinding === true) {
220
+ startContext.session = {
221
+ ...startContext.session,
222
+ id: crypto.randomUUID(),
223
+ bindingId: crypto.randomUUID(),
224
+ conversationId: null
225
+ };
226
+ }
227
+ const { handle, state } = await implementation.start(startContext, args.openOptions, artifact);
228
+ return {
229
+ handle,
230
+ awaitRunning: (timeoutMs) => implementation.awaitRunning(startContext, state, { timeoutMs })
231
+ };
232
+ };
233
+ const PLATFORM_VARIABLE = "FINAL_CONFORMANCE_PLATFORM";
234
+ const SPEC_VARIABLE = "FINAL_CONFORMANCE_SPEC";
235
+ const SHARED_VARIABLE = "FINAL_CONFORMANCE_SHARED";
236
+ const SPEC_ENV = { [SPEC_VARIABLE]: "spec", [SHARED_VARIABLE]: "spec" };
237
+ const SPEC_ALLOW = ["conformance.example.com"];
238
+ const PLATFORM_EGRESS_HOSTS = ["egress.conformance.example.com"];
239
+ const variableIn = async (sandbox, name) => {
240
+ const process = await sandbox.spawn({ command: "printenv", args: [name] });
241
+ const [stdout, { exitCode }] = await Promise.all([
242
+ streamToString(process.stdout),
243
+ process.wait()
244
+ ]);
245
+ return exitCode === 0 ? stdout.replace(/\n$/, "") : null;
246
+ };
247
+ const expectVariables = async (sandbox, expected) => {
248
+ for (const [name, value] of Object.entries(expected)) {
249
+ const actual = await variableIn(sandbox, name);
250
+ check(
251
+ actual === value,
252
+ `${name} is ${JSON.stringify(actual)}, expected ${JSON.stringify(value)}`
253
+ );
254
+ }
255
+ };
256
+ const runPlatformCases = async (args) => {
257
+ const { kit, provider, platform, record } = args;
258
+ let platformValues = {
259
+ [PLATFORM_VARIABLE]: "first",
260
+ [SHARED_VARIABLE]: "platform"
261
+ };
262
+ const filePath = `/tmp/final-conformance-${crypto.randomUUID().slice(0, 8)}/platform/ca.pem`;
263
+ const order = [];
264
+ const withPlatform = { handle: null };
265
+ await record("platform environment: provider start", async () => {
266
+ ({ handle: withPlatform.handle } = await startFromProvider(kit, provider, {
267
+ environmentOptions: platform.environmentOptions({ env: SPEC_ENV }),
268
+ startContext: {
269
+ platformFiles: async () => {
270
+ order.push("files");
271
+ return { [filePath]: "conformance CA\n" };
272
+ },
273
+ platformEnvironment: async () => {
274
+ order.push("environment");
275
+ return { ...platformValues };
276
+ }
277
+ },
278
+ ownBinding: true
279
+ }));
280
+ });
281
+ const sandbox = withPlatform.handle?.sandbox;
282
+ if (sandbox != null) {
283
+ try {
284
+ await record("platform files: written before any process", async () => {
285
+ check(
286
+ order.indexOf("files") === 0,
287
+ `platformEnvironment was read before platformFiles: ${order.join(", ")}`
288
+ );
289
+ const content = await sandbox.readTextFile({ path: filePath });
290
+ check(content === "conformance CA\n", `${filePath} holds ${JSON.stringify(content)}`);
291
+ });
292
+ await record("platform environment: reaches spawned processes", async () => {
293
+ await expectVariables(sandbox, { [PLATFORM_VARIABLE]: "first" });
294
+ const run = await sandbox.run({ command: "printenv", args: [PLATFORM_VARIABLE] });
295
+ check(run.stdout === "first\n", `run saw ${JSON.stringify(run.stdout)}`);
296
+ });
297
+ await record("platform environment: read again for every process", async () => {
298
+ platformValues = { ...platformValues, [PLATFORM_VARIABLE]: "second" };
299
+ await expectVariables(sandbox, { [PLATFORM_VARIABLE]: "second" });
300
+ });
301
+ await record("platform environment: overrides the spec env", async () => {
302
+ await expectVariables(sandbox, { [SHARED_VARIABLE]: "platform", [SPEC_VARIABLE]: "spec" });
303
+ });
304
+ await record("platform environment: {} leaves the spec env", async () => {
305
+ platformValues = {};
306
+ await expectVariables(sandbox, {
307
+ [PLATFORM_VARIABLE]: null,
308
+ [SHARED_VARIABLE]: "spec",
309
+ [SPEC_VARIABLE]: "spec"
310
+ });
311
+ });
312
+ } finally {
313
+ await withPlatform.handle?.onSandboxDelete({ reason: "conformance" }).catch(() => void 0);
314
+ }
315
+ }
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
+ });
328
+ await record("platform environment: provider start without it", async () => {
329
+ ({ handle: withoutPlatform.handle } = await startFromProvider(kit, provider, {
330
+ environmentOptions: platform.environmentOptions({ env: SPEC_ENV, allow: SPEC_ALLOW }),
331
+ startContext: allowlistContext(async (policy) => {
332
+ reportOrder.push("policy");
333
+ reported.push(policy);
334
+ }),
335
+ ownBinding: true
336
+ }));
337
+ });
338
+ const plain = withoutPlatform.handle?.sandbox;
339
+ if (plain != null) {
340
+ try {
341
+ await record(
342
+ "platform environment: absent leaves the spec env",
343
+ () => expectVariables(plain, {
344
+ [PLATFORM_VARIABLE]: null,
345
+ [SHARED_VARIABLE]: "spec",
346
+ [SPEC_VARIABLE]: "spec"
347
+ })
348
+ );
349
+ const observe = platform.observedAllowlist;
350
+ if (observe == null) {
351
+ args.skip("platform egress hosts: appended to an allowlist", "no observedAllowlist");
352
+ args.skip("platform network policy: reported as applied", "no observedAllowlist");
353
+ } else {
354
+ await record("platform egress hosts: appended to an allowlist", async () => {
355
+ const allow = await observe(plain) ?? [];
356
+ for (const host of [...SPEC_ALLOW, ...PLATFORM_EGRESS_HOSTS])
357
+ check(allow.includes(host), `allowlist ${JSON.stringify(allow)} lacks ${host}`);
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
+ });
376
+ }
377
+ } finally {
378
+ await withoutPlatform.handle?.onSandboxDelete({ reason: "conformance" }).catch(() => void 0);
379
+ }
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
+ }
400
+ await record("platform environment: reserved names refused", async () => {
401
+ const started = await startFromProvider(kit, provider, {
402
+ environmentOptions: platform.environmentOptions({
403
+ env: { HTTPS_PROXY: "http://spec.example.com" }
404
+ }),
405
+ ownBinding: true
406
+ }).then(
407
+ ({ handle }) => handle,
408
+ () => null
409
+ );
410
+ if (started == null) return;
411
+ await started.onSandboxDelete({ reason: "conformance" }).catch(() => void 0);
412
+ throw new Error("a spec setting HTTPS_PROXY started");
413
+ });
216
414
  };
217
415
  const runSandboxConformance = async (args) => {
218
416
  const timeoutMs = args.timeoutMs ?? 3e4;
@@ -245,8 +443,17 @@ const runSandboxConformance = async (args) => {
245
443
  throw new Error("runSandboxConformance needs a handle or a provider");
246
444
  const provider = args.provider;
247
445
  await record("provider start", async () => {
248
- started.handle = await startFromProvider(args, provider);
446
+ ({ handle: started.handle, awaitRunning: started.awaitRunning } = await startFromProvider(
447
+ args,
448
+ provider
449
+ ));
249
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
+ );
250
457
  sandbox = started.handle?.sandbox ?? null;
251
458
  }
252
459
  if (sandbox == null) return { passed: false, cases };
@@ -312,6 +519,21 @@ const runSandboxConformance = async (args) => {
312
519
  }
313
520
  await target.removePath({ path: root, recursive: true, force: true }).catch(() => void 0);
314
521
  await started.handle?.onSandboxDelete({ reason: "conformance" }).catch(() => void 0);
522
+ if (args.platform != null && args.provider != null) {
523
+ await runPlatformCases({
524
+ kit: args,
525
+ provider: args.provider,
526
+ platform: args.platform,
527
+ record,
528
+ skip: (name, detail) => cases.push({
529
+ name,
530
+ status: ConformanceCaseStatus.Skipped,
531
+ durationMs: 0,
532
+ error: null,
533
+ detail
534
+ })
535
+ });
536
+ }
315
537
  return { passed: cases.every((entry) => entry.status !== ConformanceCaseStatus.Failed), cases };
316
538
  };
317
539
  export {
@@ -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`.\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}\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): Promise<SandboxProviderHandleIface<NetworkSandboxSessionIface>> => {\n const implementation = provider.definition.environment(args.environmentOptions);\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 };\n const { handle } = await implementation.start(startContext, args.openOptions, artifact);\n return handle;\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 = async (name: string, run: () => Promise<string | void>) => {\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 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
  }
@@ -83,7 +83,8 @@ const harnessDescriptionSchema = z.object({
83
83
  nativeToolPolicy: z.boolean().optional(),
84
84
  // Defers and searches MCP tools itself (a harness-native tool search): the
85
85
  // host lists every exposed tool, ignoring connections' `tools.load`, and
86
- // adds no search of its own. Absent: the host applies `load` and serves search.
86
+ // adds no search of its own. Absent: the host lists what `load` (or, without
87
+ // it, HOSTING.md's defaults) leaves listed and serves search for the rest.
87
88
  deferredToolSearch: z.boolean().optional()
88
89
  }),
89
90
  promptWhileRunning: z.nativeEnum(PromptWhileRunning).default(DEFAULT_PROMPT_WHILE_RUNNING),