@finalai/agent-provider 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. package/HOSTING.md +334 -245
  2. package/README.md +93 -14
  3. package/dist/modules/canonical-json.d.mts +4 -0
  4. package/dist/modules/canonical-json.mjs +33 -0
  5. package/dist/modules/canonical-json.mjs.map +7 -0
  6. package/dist/modules/channel.d.mts +9 -3
  7. package/dist/modules/channel.mjs.map +2 -2
  8. package/dist/modules/code-host/host.d.mts +10 -0
  9. package/dist/modules/code-host/host.mjs +88 -0
  10. package/dist/modules/code-host/host.mjs.map +7 -0
  11. package/dist/modules/code-host/in-process.d.mts +24 -0
  12. package/dist/modules/code-host/in-process.mjs +89 -0
  13. package/dist/modules/code-host/in-process.mjs.map +7 -0
  14. package/dist/modules/code-host/index.d.mts +4 -0
  15. package/dist/modules/code-host/index.mjs +5 -0
  16. package/dist/modules/code-host/index.mjs.map +7 -0
  17. package/dist/modules/code-host/serverless.d.mts +63 -0
  18. package/dist/modules/code-host/serverless.mjs +27 -0
  19. package/dist/modules/code-host/serverless.mjs.map +7 -0
  20. package/dist/modules/code-host/types.d.mts +152 -0
  21. package/dist/modules/code-host/types.mjs +85 -0
  22. package/dist/modules/code-host/types.mjs.map +7 -0
  23. package/dist/modules/conformance/agent.mjs +72 -6
  24. package/dist/modules/conformance/agent.mjs.map +2 -2
  25. package/dist/modules/conformance/harness-kit.d.mts +9 -2
  26. package/dist/modules/conformance/harness-kit.mjs +224 -63
  27. package/dist/modules/conformance/harness-kit.mjs.map +3 -3
  28. package/dist/modules/conformance/local-harness.d.mts +1 -4
  29. package/dist/modules/conformance/local-harness.mjs +21 -22
  30. package/dist/modules/conformance/local-harness.mjs.map +2 -2
  31. package/dist/modules/conformance/protocol.d.mts +1 -0
  32. package/dist/modules/conformance/protocol.mjs +2 -0
  33. package/dist/modules/conformance/protocol.mjs.map +2 -2
  34. package/dist/modules/conformance/sandbox-kit.d.mts +12 -4
  35. package/dist/modules/conformance/sandbox-kit.mjs +189 -103
  36. package/dist/modules/conformance/sandbox-kit.mjs.map +2 -2
  37. package/dist/modules/conformance/scripted-model/chat-completions.mjs +1 -0
  38. package/dist/modules/conformance/scripted-model/chat-completions.mjs.map +2 -2
  39. package/dist/modules/conformance/scripted-model/directives.d.mts +3 -0
  40. package/dist/modules/conformance/scripted-model/directives.mjs +26 -10
  41. package/dist/modules/conformance/scripted-model/directives.mjs.map +2 -2
  42. package/dist/modules/conformance/scripted-model/messages.mjs +1 -0
  43. package/dist/modules/conformance/scripted-model/messages.mjs.map +2 -2
  44. package/dist/modules/conformance/scripted-model/responses.mjs +2 -0
  45. package/dist/modules/conformance/scripted-model/responses.mjs.map +2 -2
  46. package/dist/modules/conformance/stdio.d.mts +21 -0
  47. package/dist/modules/conformance/stdio.mjs +158 -0
  48. package/dist/modules/conformance/stdio.mjs.map +7 -0
  49. package/dist/modules/credential-routes.d.mts +2 -0
  50. package/dist/modules/credential-routes.mjs +2 -0
  51. package/dist/modules/credential-routes.mjs.map +2 -2
  52. package/dist/modules/document.d.mts +376 -0
  53. package/dist/modules/document.mjs +208 -0
  54. package/dist/modules/document.mjs.map +7 -0
  55. package/dist/modules/harness-configuration.d.mts +16 -0
  56. package/dist/modules/harness-configuration.mjs +83 -0
  57. package/dist/modules/harness-configuration.mjs.map +7 -0
  58. package/dist/modules/harness-definition.d.mts +280 -0
  59. package/dist/modules/harness-definition.mjs +430 -0
  60. package/dist/modules/harness-definition.mjs.map +7 -0
  61. package/dist/modules/harness-provider.d.mts +197 -0
  62. package/dist/modules/harness-provider.mjs +108 -0
  63. package/dist/modules/harness-provider.mjs.map +7 -0
  64. package/dist/modules/harness-requirements.d.mts +19 -0
  65. package/dist/modules/harness-requirements.mjs +40 -0
  66. package/dist/modules/harness-requirements.mjs.map +7 -0
  67. package/dist/modules/harness-start.d.mts +33 -0
  68. package/dist/modules/harness-start.mjs +107 -0
  69. package/dist/modules/harness-start.mjs.map +7 -0
  70. package/dist/modules/harness.d.mts +84 -109
  71. package/dist/modules/harness.mjs +56 -111
  72. package/dist/modules/harness.mjs.map +3 -3
  73. package/dist/modules/identity.d.mts +1 -0
  74. package/dist/modules/identity.mjs +2 -0
  75. package/dist/modules/identity.mjs.map +7 -0
  76. package/dist/modules/index.d.mts +12 -6
  77. package/dist/modules/index.mjs +12 -6
  78. package/dist/modules/index.mjs.map +2 -2
  79. package/dist/modules/inference.d.mts +35 -0
  80. package/dist/modules/inference.mjs +74 -0
  81. package/dist/modules/inference.mjs.map +7 -0
  82. package/dist/modules/local-channel-context.mjs +3 -1
  83. package/dist/modules/local-channel-context.mjs.map +2 -2
  84. package/dist/modules/requirements-check.d.mts +30 -0
  85. package/dist/modules/requirements-check.mjs +164 -0
  86. package/dist/modules/requirements-check.mjs.map +7 -0
  87. package/dist/modules/room-surface.d.mts +0 -5
  88. package/dist/modules/room-surface.mjs.map +2 -2
  89. package/dist/modules/sandbox/client.d.mts +3 -0
  90. package/dist/modules/sandbox/client.mjs +101 -18
  91. package/dist/modules/sandbox/client.mjs.map +2 -2
  92. package/dist/modules/sandbox/grant.d.mts +78 -0
  93. package/dist/modules/sandbox/grant.mjs +134 -0
  94. package/dist/modules/sandbox/grant.mjs.map +7 -0
  95. package/dist/modules/sandbox/index.d.mts +3 -3
  96. package/dist/modules/sandbox/index.mjs +4 -5
  97. package/dist/modules/sandbox/index.mjs.map +2 -2
  98. package/dist/modules/sandbox/mcp-hosted.d.mts +1 -1
  99. package/dist/modules/sandbox/mcp-hosted.mjs +4 -7
  100. package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
  101. package/dist/modules/sandbox/mcp.d.mts +4 -2
  102. package/dist/modules/sandbox/mcp.mjs +14 -7
  103. package/dist/modules/sandbox/mcp.mjs.map +2 -2
  104. package/dist/modules/sandbox/memory-sandbox.d.mts +2 -1
  105. package/dist/modules/sandbox/memory-sandbox.mjs +71 -41
  106. package/dist/modules/sandbox/memory-sandbox.mjs.map +2 -2
  107. package/dist/modules/sandbox/networking.d.mts +7 -7
  108. package/dist/modules/sandbox/networking.mjs +16 -9
  109. package/dist/modules/sandbox/networking.mjs.map +2 -2
  110. package/dist/modules/sandbox/remote/adapter.d.mts +30 -0
  111. package/dist/modules/sandbox/remote/adapter.mjs +381 -0
  112. package/dist/modules/sandbox/remote/adapter.mjs.map +7 -0
  113. package/dist/modules/sandbox/remote/errors.d.mts +10 -0
  114. package/dist/modules/sandbox/remote/errors.mjs +62 -0
  115. package/dist/modules/sandbox/remote/errors.mjs.map +7 -0
  116. package/dist/modules/sandbox/remote/index.d.mts +5 -0
  117. package/dist/modules/sandbox/remote/index.mjs +6 -0
  118. package/dist/modules/sandbox/remote/index.mjs.map +7 -0
  119. package/dist/modules/sandbox/remote/ndjson.d.mts +6 -0
  120. package/dist/modules/sandbox/remote/ndjson.mjs +80 -0
  121. package/dist/modules/sandbox/remote/ndjson.mjs.map +7 -0
  122. package/dist/modules/sandbox/remote/platform-api.d.mts +8 -0
  123. package/dist/modules/sandbox/remote/platform-api.mjs +15 -0
  124. package/dist/modules/sandbox/remote/platform-api.mjs.map +7 -0
  125. package/dist/modules/sandbox/remote/preamble.d.mts +7 -0
  126. package/dist/modules/sandbox/remote/preamble.mjs +51 -0
  127. package/dist/modules/sandbox/remote/preamble.mjs.map +7 -0
  128. package/dist/modules/sandbox/remote/serve.d.mts +34 -0
  129. package/dist/modules/sandbox/remote/serve.mjs +519 -0
  130. package/dist/modules/sandbox/remote/serve.mjs.map +7 -0
  131. package/dist/modules/sandbox/remote/testing.d.mts +34 -0
  132. package/dist/modules/sandbox/remote/testing.mjs +275 -0
  133. package/dist/modules/sandbox/remote/testing.mjs.map +7 -0
  134. package/dist/modules/sandbox/seeds.d.mts +2 -2
  135. package/dist/modules/sandbox/seeds.mjs +2 -2
  136. package/dist/modules/sandbox/seeds.mjs.map +2 -2
  137. package/dist/modules/sandbox/server.d.mts +4 -6
  138. package/dist/modules/sandbox/server.mjs +93 -49
  139. package/dist/modules/sandbox/server.mjs.map +2 -2
  140. package/dist/modules/sandbox/setup/apply.d.mts +41 -0
  141. package/dist/modules/sandbox/setup/apply.mjs +204 -0
  142. package/dist/modules/sandbox/setup/apply.mjs.map +7 -0
  143. package/dist/modules/sandbox/setup/describe.d.mts +10 -0
  144. package/dist/modules/sandbox/setup/describe.mjs +62 -0
  145. package/dist/modules/sandbox/setup/describe.mjs.map +7 -0
  146. package/dist/modules/sandbox/setup/index.d.mts +6 -0
  147. package/dist/modules/sandbox/setup/index.mjs +17 -0
  148. package/dist/modules/sandbox/setup/index.mjs.map +7 -0
  149. package/dist/modules/sandbox/setup/paths.d.mts +8 -0
  150. package/dist/modules/sandbox/setup/paths.mjs +18 -0
  151. package/dist/modules/sandbox/setup/paths.mjs.map +7 -0
  152. package/dist/modules/sandbox/setup/schema.d.mts +42 -0
  153. package/dist/modules/sandbox/setup/schema.mjs +58 -0
  154. package/dist/modules/sandbox/setup/schema.mjs.map +7 -0
  155. package/dist/modules/sandbox/tool-policy.d.mts +1 -1
  156. package/dist/modules/sandbox/tool-policy.mjs +1 -1
  157. package/dist/modules/sandbox/tool-policy.mjs.map +2 -2
  158. package/dist/modules/sandbox/types.d.mts +117 -130
  159. package/dist/modules/sandbox/types.mjs +46 -50
  160. package/dist/modules/sandbox/types.mjs.map +3 -3
  161. package/dist/modules/sandbox/wire.d.mts +93 -6
  162. package/dist/modules/sandbox/wire.mjs +61 -38
  163. package/dist/modules/sandbox/wire.mjs.map +2 -2
  164. package/dist/modules/schemas.d.mts +5 -76
  165. package/dist/modules/schemas.mjs +18 -85
  166. package/dist/modules/schemas.mjs.map +2 -2
  167. package/dist/modules/tool-annotations.d.mts +15 -6
  168. package/dist/modules/tool-annotations.mjs +9 -3
  169. package/dist/modules/tool-annotations.mjs.map +2 -2
  170. package/dist/modules/tool-descriptor.d.mts +16 -0
  171. package/dist/modules/tool-descriptor.mjs +19 -0
  172. package/dist/modules/tool-descriptor.mjs.map +7 -0
  173. package/dist/modules/tool-patterns.d.mts +7 -7
  174. package/dist/modules/tool-patterns.mjs +10 -9
  175. package/dist/modules/tool-patterns.mjs.map +2 -2
  176. package/package.json +86 -36
  177. package/dist/modules/credentials.d.mts +0 -206
  178. package/dist/modules/credentials.mjs +0 -207
  179. package/dist/modules/credentials.mjs.map +0 -7
  180. package/dist/modules/dynamic.d.mts +0 -40
  181. package/dist/modules/dynamic.mjs +0 -79
  182. package/dist/modules/dynamic.mjs.map +0 -7
  183. package/dist/modules/hosted-bindings.d.mts +0 -15
  184. package/dist/modules/hosted-bindings.mjs +0 -21
  185. package/dist/modules/hosted-bindings.mjs.map +0 -7
  186. package/dist/modules/manifest.d.mts +0 -787
  187. package/dist/modules/manifest.mjs +0 -320
  188. package/dist/modules/manifest.mjs.map +0 -7
  189. package/dist/modules/provider-ref.d.mts +0 -29
  190. package/dist/modules/provider-ref.mjs +0 -55
  191. package/dist/modules/provider-ref.mjs.map +0 -7
  192. package/dist/modules/sandbox/open-scope-node.d.mts +0 -4
  193. package/dist/modules/sandbox/open-scope-node.mjs +0 -19
  194. package/dist/modules/sandbox/open-scope-node.mjs.map +0 -7
  195. package/dist/modules/sandbox/open-scope.d.mts +0 -16
  196. package/dist/modules/sandbox/open-scope.mjs +0 -66
  197. package/dist/modules/sandbox/open-scope.mjs.map +0 -7
  198. package/dist/modules/sandbox/workspace-identity.d.mts +0 -5
  199. package/dist/modules/sandbox/workspace-identity.mjs +0 -14
  200. package/dist/modules/sandbox/workspace-identity.mjs.map +0 -7
@@ -0,0 +1,275 @@
1
+ import { platformIdentityExchangeRequestSchema } from "@finalai/agent-protocol/agent-platform/sandbox-providers";
2
+ import {
3
+ PLATFORM_IDENTITY_TOKEN_TYPE,
4
+ PlatformIdentityVariant,
5
+ SANDBOX_PROVIDER_SCOPES,
6
+ verifyPlatformIdentity
7
+ } from "@finalai/agent-protocol/identity";
8
+ import {
9
+ SANDBOX_PROVIDER_DISCOVERY_PATH,
10
+ SandboxFormFactor,
11
+ sandboxProviderDiscoverySchema
12
+ } from "@finalai/agent-protocol/sandbox-provider-wire";
13
+ import {
14
+ remoteSandboxProvider
15
+ } from "./adapter.mjs";
16
+ import {
17
+ PLATFORM_IDENTITY_EXCHANGE_PATH,
18
+ SANDBOX_PROVIDER_ARTIFACTS_PATH,
19
+ sandboxProviderArtifactBodySchema
20
+ } from "./platform-api.mjs";
21
+ import { serveSandboxProvider } from "./serve.mjs";
22
+ const IN_MEMORY_PLATFORM_ISSUER = "https://platform.sandbox-wire.test";
23
+ const IN_MEMORY_PROVIDER_ORIGIN = "https://providers.sandbox-wire.test";
24
+ const base64url = (bytes) => {
25
+ let binary = "";
26
+ for (const byte of bytes) binary += String.fromCharCode(byte);
27
+ return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
28
+ };
29
+ const encodeJson = (value) => base64url(new TextEncoder().encode(JSON.stringify(value)));
30
+ const createTestSigner = async () => {
31
+ const pair = await crypto.subtle.generateKey({ name: "Ed25519" }, true, ["sign", "verify"]);
32
+ if (!("privateKey" in pair)) throw new Error("expected an Ed25519 key pair");
33
+ const exported = await crypto.subtle.exportKey("jwk", pair.publicKey);
34
+ const kid = "sandbox-wire-test";
35
+ return {
36
+ jwks: { keys: [{ kty: "OKP", crv: "Ed25519", x: exported.x, kid, alg: "EdDSA", use: "sig" }] },
37
+ sign: async (payload) => {
38
+ const input = `${encodeJson({ alg: "EdDSA", typ: PLATFORM_IDENTITY_TOKEN_TYPE, kid })}.${encodeJson(payload)}`;
39
+ const signature = await crypto.subtle.sign(
40
+ { name: "Ed25519" },
41
+ pair.privateKey,
42
+ new TextEncoder().encode(input)
43
+ );
44
+ return `${input}.${base64url(new Uint8Array(signature))}`;
45
+ }
46
+ };
47
+ };
48
+ const ABNORMAL_CLOSE = 1006;
49
+ const OPEN = 1;
50
+ const CLOSED = 3;
51
+ const createTestSocket = (peer, startOpen) => {
52
+ const listeners = /* @__PURE__ */ new Map();
53
+ const emit = (type, event) => {
54
+ for (const listener of listeners.get(type) ?? []) Reflect.apply(listener, void 0, [event]);
55
+ };
56
+ const socket = {
57
+ readyState: startOpen ? OPEN : 0,
58
+ binaryType: "arraybuffer",
59
+ send: (data) => {
60
+ if (socket.readyState !== OPEN) return;
61
+ const copy = typeof data === "string" ? data : data.slice();
62
+ queueMicrotask(() => peer().deliver(copy));
63
+ },
64
+ close: (code, reason) => {
65
+ if (socket.readyState === CLOSED) return;
66
+ const info = { code: code ?? 1e3, reason: reason ?? "" };
67
+ socket.ended(info.code, info.reason);
68
+ queueMicrotask(() => peer().ended(info.code, info.reason));
69
+ },
70
+ addEventListener: (type, listener) => {
71
+ listeners.set(type, [...listeners.get(type) ?? [], listener]);
72
+ },
73
+ deliver: (data) => {
74
+ if (socket.readyState === OPEN) emit("message", { data });
75
+ },
76
+ ended: (code, reason) => {
77
+ if (socket.readyState === CLOSED) return;
78
+ socket.readyState = CLOSED;
79
+ emit("close", { code, reason });
80
+ }
81
+ };
82
+ if (!startOpen)
83
+ queueMicrotask(() => {
84
+ if (socket.readyState !== 0) return;
85
+ socket.readyState = OPEN;
86
+ emit("open", { type: "open" });
87
+ });
88
+ return socket;
89
+ };
90
+ const connectSandboxProviderInMemory = async (args) => {
91
+ const name = args.name ?? args.provider.name;
92
+ const signer = await createTestSigner();
93
+ const calls = [];
94
+ const exchanges = [];
95
+ const assertions = [];
96
+ const artifacts = /* @__PURE__ */ new Map();
97
+ const sockets = /* @__PURE__ */ new Set();
98
+ const url = `${IN_MEMORY_PROVIDER_ORIGIN}/${name}`;
99
+ const providerId = `provider-${name}`;
100
+ const sign = async (claims) => {
101
+ const iat = Math.floor(Date.now() / 1e3);
102
+ return signer.sign({
103
+ iss: IN_MEMORY_PLATFORM_ISSUER,
104
+ aud: claims.audience,
105
+ sub: claims.sandboxId ?? providerId,
106
+ jti: crypto.randomUUID(),
107
+ iat,
108
+ exp: iat + 300,
109
+ variant: claims.variant,
110
+ organization_id: claims.organizationId,
111
+ project_id: claims.projectId,
112
+ session_id: null,
113
+ sandbox_id: claims.sandboxId,
114
+ conversation_id: null,
115
+ participant_id: null,
116
+ turn_id: null,
117
+ user_id: claims.userId,
118
+ actor: null,
119
+ scopes: claims.scopes,
120
+ provider_id: providerId,
121
+ ...claims.grantAudience == null ? {} : { grant_audience: claims.grantAudience }
122
+ });
123
+ };
124
+ const platformFetch = async (request) => {
125
+ const target = new URL(request.url);
126
+ const verifySubject = (token) => verifyPlatformIdentity({
127
+ token,
128
+ audience: null,
129
+ variant: [PlatformIdentityVariant.SandboxProvider, PlatformIdentityVariant.Downstream],
130
+ issuer: IN_MEMORY_PLATFORM_ISSUER,
131
+ jwks: signer.jwks
132
+ });
133
+ if (target.pathname === PLATFORM_IDENTITY_EXCHANGE_PATH) {
134
+ const body = platformIdentityExchangeRequestSchema.parse(JSON.parse(await request.text()));
135
+ const subject = await verifySubject(body.subjectToken);
136
+ if (!subject.ok) return Response.json({ error: { code: subject.refusal } }, { status: 403 });
137
+ const claims = subject.claims;
138
+ if (args.grants != null && body.audience !== url && !args.grants.includes(body.audience))
139
+ return Response.json({ error: { code: "audience_not_granted" } }, { status: 403 });
140
+ exchanges.push({
141
+ audience: body.audience,
142
+ sandboxId: claims.sandboxId,
143
+ userId: claims.userId
144
+ });
145
+ const downstream = body.audience === url ? null : args.downstreamToken?.({ audience: body.audience, userId: claims.userId }) ?? null;
146
+ if (downstream != null)
147
+ return Response.json({
148
+ token: downstream,
149
+ expiresAt: new Date(Date.now() + 3e5).toISOString()
150
+ });
151
+ const token = await sign({
152
+ audience: body.audience,
153
+ variant: body.audience === url ? PlatformIdentityVariant.SandboxProvider : PlatformIdentityVariant.Downstream,
154
+ organizationId: claims.organizationId,
155
+ projectId: claims.projectId,
156
+ sandboxId: claims.sandboxId,
157
+ userId: claims.userId,
158
+ scopes: body.audience === url ? SANDBOX_PROVIDER_SCOPES : { backend: ["use"] },
159
+ ...body.audience === url ? {} : { grantAudience: body.audience }
160
+ });
161
+ return Response.json({ token, expiresAt: new Date(Date.now() + 3e5).toISOString() });
162
+ }
163
+ if (target.pathname.startsWith(`${SANDBOX_PROVIDER_ARTIFACTS_PATH}/`)) {
164
+ const bearer = /^Bearer\s+(.+)$/iu.exec(request.headers.get("authorization") ?? "")?.[1];
165
+ const subject = bearer == null ? null : await verifySubject(bearer);
166
+ if (subject == null || !subject.ok) return new Response(null, { status: 401 });
167
+ const key = `${subject.claims.organizationId}:${decodeURIComponent(
168
+ target.pathname.slice(SANDBOX_PROVIDER_ARTIFACTS_PATH.length + 1)
169
+ )}`;
170
+ if (request.method === "PUT") {
171
+ artifacts.set(
172
+ key,
173
+ sandboxProviderArtifactBodySchema.parse(JSON.parse(await request.text())).artifact
174
+ );
175
+ return new Response(null, { status: 204 });
176
+ }
177
+ const artifact = artifacts.get(key);
178
+ return artifact === void 0 ? new Response(null, { status: 404 }) : Response.json({ artifact });
179
+ }
180
+ return new Response(null, { status: 404 });
181
+ };
182
+ const server = serveSandboxProvider({
183
+ providers: {
184
+ [name]: {
185
+ provider: args.provider,
186
+ discovery: {
187
+ formFactor: SandboxFormFactor.Machine,
188
+ capabilities: {},
189
+ ...args.discovery
190
+ }
191
+ }
192
+ },
193
+ issuer: IN_MEMORY_PLATFORM_ISSUER,
194
+ jwks: signer.jwks,
195
+ publicUrl: (provider) => `${IN_MEMORY_PROVIDER_ORIGIN}/${provider}`,
196
+ fetch: async (input, init) => platformFetch(new Request(input, init)),
197
+ ...args.heartbeatMs == null ? {} : { heartbeatMs: args.heartbeatMs }
198
+ });
199
+ const providerFetch = async (input, init) => {
200
+ const request = new Request(input, init);
201
+ calls.push(new URL(request.url).pathname.slice(`/${name}`.length));
202
+ return args.proxy == null ? server.fetch(request) : args.proxy(request, server.fetch);
203
+ };
204
+ const openSocket = (target, protocols) => {
205
+ calls.push(new URL(target).pathname.slice(`/${name}`.length));
206
+ const holder = {
207
+ client: null,
208
+ server: null
209
+ };
210
+ const client = createTestSocket(() => {
211
+ if (holder.server == null) throw new Error("no server socket");
212
+ return holder.server;
213
+ }, false);
214
+ const serverSocket = createTestSocket(() => client, true);
215
+ holder.client = client;
216
+ holder.server = serverSocket;
217
+ sockets.add(client);
218
+ server.upgrade(
219
+ new Request(target.replace(/^ws/u, "http"), {
220
+ headers: { "sec-websocket-protocol": protocols.join(", ") }
221
+ }),
222
+ serverSocket
223
+ );
224
+ return client;
225
+ };
226
+ const discovery = sandboxProviderDiscoverySchema.parse(
227
+ JSON.parse(
228
+ await (await server.fetch(new Request(`${url}${SANDBOX_PROVIDER_DISCOVERY_PATH}`))).text()
229
+ )
230
+ );
231
+ const registration = {
232
+ id: providerId,
233
+ name,
234
+ url,
235
+ stateProtocolVersion: discovery.stateProtocolVersion,
236
+ features: discovery.features
237
+ };
238
+ const mintAssertion = (claims) => sign({
239
+ audience: claims.audience,
240
+ variant: PlatformIdentityVariant.SandboxProvider,
241
+ organizationId: claims.organizationId,
242
+ projectId: claims.projectId,
243
+ sandboxId: claims.sandboxId,
244
+ userId: claims.userId,
245
+ scopes: SANDBOX_PROVIDER_SCOPES
246
+ });
247
+ return {
248
+ url,
249
+ mintAssertion,
250
+ fetchProvider: (request) => server.fetch(request),
251
+ provider: remoteSandboxProvider({
252
+ registration,
253
+ mintAssertion: async (claims) => {
254
+ assertions.push(claims);
255
+ return mintAssertion(claims);
256
+ },
257
+ forwardedSecrets: async () => ({ ...args.forwardedSecrets }),
258
+ fetch: providerFetch,
259
+ openSocket
260
+ }),
261
+ calls: () => [...calls],
262
+ exchanges: () => [...exchanges],
263
+ assertions: () => [...assertions],
264
+ dropSockets: () => {
265
+ for (const socket of sockets) socket.close(ABNORMAL_CLOSE, "network drop");
266
+ sockets.clear();
267
+ }
268
+ };
269
+ };
270
+ export {
271
+ IN_MEMORY_PLATFORM_ISSUER,
272
+ IN_MEMORY_PROVIDER_ORIGIN,
273
+ connectSandboxProviderInMemory
274
+ };
275
+ //# sourceMappingURL=testing.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../../src/sandbox/remote/testing.ts"],
4
+ "sourcesContent": ["import { platformIdentityExchangeRequestSchema } from '@finalai/agent-protocol/agent-platform/sandbox-providers';\nimport {\n PLATFORM_IDENTITY_TOKEN_TYPE,\n PlatformIdentityVariant,\n SANDBOX_PROVIDER_SCOPES,\n verifyPlatformIdentity,\n type JwksIface,\n} from '@finalai/agent-protocol/identity';\nimport {\n SANDBOX_PROVIDER_DISCOVERY_PATH,\n SandboxFormFactor,\n sandboxProviderDiscoverySchema,\n} from '@finalai/agent-protocol/sandbox-provider-wire';\nimport type { JsonValue } from \"../../json.mjs\";\nimport type { AnySandboxProviderIface } from \"../types.mjs\";\nimport type {\n WebSocketCloseEventLikeIface,\n WebSocketEventLikeIface,\n WebSocketLikeIface,\n WebSocketMessageEventLikeIface,\n} from \"../wire.mjs\";\nimport {\n remoteSandboxProvider,\n type RemoteSandboxProviderRegistrationIface,\n type SandboxProviderAssertionArgsIface,\n} from \"./adapter.mjs\";\nimport {\n PLATFORM_IDENTITY_EXCHANGE_PATH,\n SANDBOX_PROVIDER_ARTIFACTS_PATH,\n sandboxProviderArtifactBodySchema,\n} from \"./platform-api.mjs\";\nimport { serveSandboxProvider, type SandboxProviderDiscoveryInputIface } from \"./serve.mjs\";\n\n// A sandbox provider driven through the sandbox-provider wire entirely in\n// memory: serveSandboxProvider on one side, remoteSandboxProvider on the\n// other, an in-process fetch and WebSocket pair between them, and a test\n// platform that signs assertions, answers identity exchanges and keeps\n// artifacts. Used by the conformance kit's remote mode and by tests.\n\nexport const IN_MEMORY_PLATFORM_ISSUER = 'https://platform.sandbox-wire.test';\nexport const IN_MEMORY_PROVIDER_ORIGIN = 'https://providers.sandbox-wire.test';\n\nexport interface InMemoryExchangeIface {\n audience: string;\n sandboxId: string | null;\n userId: string | null;\n}\n\nexport interface InMemorySandboxProviderWireIface {\n // The provider as a platform drives it: over the wire.\n provider: AnySandboxProviderIface;\n // The wire paths called, in order (`/v1/create`, `/v1/attach`, \u2026).\n calls(): string[];\n // Every identity exchange the provider host asked for.\n exchanges(): InMemoryExchangeIface[];\n // Every assertion minted, in order.\n assertions(): SandboxProviderAssertionArgsIface[];\n // Closes every attach socket (a dropped connection).\n dropSockets(): void;\n // Signs a sandbox-provider assertion as the platform does.\n mintAssertion(claims: SandboxProviderAssertionArgsIface): Promise<string>;\n // A request straight to the provider host.\n fetchProvider(request: Request): Promise<Response>;\n // The registration URL.\n readonly url: string;\n}\n\nexport interface ConnectSandboxProviderInMemoryArgsIface {\n provider: AnySandboxProviderIface;\n name?: string;\n discovery?: Partial<SandboxProviderDiscoveryInputIface>;\n // What `forwardedSecrets` resolves to for every call.\n forwardedSecrets?: Record<string, string>;\n // Audiences the registration was granted; every exchange for another is refused.\n grants?: string[];\n heartbeatMs?: number;\n // The token an exchange for a granted backend answers, in place of a\n // downstream assertion: what a test backend accepts.\n downstreamToken?: (args: { audience: string; userId: string | null }) => string;\n // Sits between the platform and the provider host, as a proxy would.\n proxy?: (request: Request, next: (request: Request) => Promise<Response>) => Promise<Response>;\n}\n\nconst base64url = (bytes: Uint8Array): string => {\n let binary = '';\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return btoa(binary).replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/u, '');\n};\n\nconst encodeJson = (value: unknown): string =>\n base64url(new TextEncoder().encode(JSON.stringify(value)));\n\ninterface TestSignerIface {\n jwks: JwksIface;\n sign(payload: Record<string, unknown>): Promise<string>;\n}\n\nconst createTestSigner = async (): Promise<TestSignerIface> => {\n const pair = await crypto.subtle.generateKey({ name: 'Ed25519' }, true, ['sign', 'verify']);\n if (!('privateKey' in pair)) throw new Error('expected an Ed25519 key pair');\n const exported = await crypto.subtle.exportKey('jwk', pair.publicKey);\n const kid = 'sandbox-wire-test';\n return {\n jwks: { keys: [{ kty: 'OKP', crv: 'Ed25519', x: exported.x, kid, alg: 'EdDSA', use: 'sig' }] },\n sign: async (payload) => {\n const input = `${encodeJson({ alg: 'EdDSA', typ: PLATFORM_IDENTITY_TOKEN_TYPE, kid })}.${encodeJson(payload)}`;\n const signature = await crypto.subtle.sign(\n { name: 'Ed25519' },\n pair.privateKey,\n new TextEncoder().encode(input),\n );\n return `${input}.${base64url(new Uint8Array(signature))}`;\n },\n };\n};\n\nconst ABNORMAL_CLOSE = 1006;\nconst OPEN = 1;\nconst CLOSED = 3;\n\ntype ListenerType =\n | ((event: WebSocketMessageEventLikeIface) => void)\n | ((event: WebSocketCloseEventLikeIface) => void)\n | ((event: WebSocketEventLikeIface) => void);\n\ninterface TestSocketIface extends WebSocketLikeIface {\n readyState: number;\n deliver(data: string | Uint8Array): void;\n ended(code: number, reason: string): void;\n}\n\n// One end of an in-memory WebSocket; frames reach the other end asynchronously.\nconst createTestSocket = (peer: () => TestSocketIface, startOpen: boolean): TestSocketIface => {\n const listeners = new Map<string, ListenerType[]>();\n const emit = (type: string, event: object) => {\n for (const listener of listeners.get(type) ?? []) Reflect.apply(listener, undefined, [event]);\n };\n const socket: TestSocketIface = {\n readyState: startOpen ? OPEN : 0,\n binaryType: 'arraybuffer',\n send: (data) => {\n if (socket.readyState !== OPEN) return;\n const copy = typeof data === 'string' ? data : data.slice();\n queueMicrotask(() => peer().deliver(copy));\n },\n close: (code, reason) => {\n if (socket.readyState === CLOSED) return;\n const info = { code: code ?? 1000, reason: reason ?? '' };\n socket.ended(info.code, info.reason);\n queueMicrotask(() => peer().ended(info.code, info.reason));\n },\n addEventListener: (type: string, listener: ListenerType) => {\n listeners.set(type, [...(listeners.get(type) ?? []), listener]);\n },\n deliver: (data) => {\n if (socket.readyState === OPEN) emit('message', { data });\n },\n ended: (code, reason) => {\n if (socket.readyState === CLOSED) return;\n socket.readyState = CLOSED;\n emit('close', { code, reason });\n },\n };\n if (!startOpen)\n queueMicrotask(() => {\n if (socket.readyState !== 0) return;\n socket.readyState = OPEN;\n emit('open', { type: 'open' });\n });\n return socket;\n};\n\nexport const connectSandboxProviderInMemory = async (\n args: ConnectSandboxProviderInMemoryArgsIface,\n): Promise<InMemorySandboxProviderWireIface> => {\n const name = args.name ?? args.provider.name;\n const signer = await createTestSigner();\n const calls: string[] = [];\n const exchanges: InMemoryExchangeIface[] = [];\n const assertions: SandboxProviderAssertionArgsIface[] = [];\n const artifacts = new Map<string, JsonValue>();\n const sockets = new Set<TestSocketIface>();\n const url = `${IN_MEMORY_PROVIDER_ORIGIN}/${name}`;\n const providerId = `provider-${name}`;\n\n const sign = async (claims: {\n audience: string;\n variant: PlatformIdentityVariant;\n organizationId: string;\n projectId: string;\n sandboxId: string | null;\n userId: string | null;\n scopes: Readonly<Record<string, readonly string[]>>;\n grantAudience?: string;\n }): Promise<string> => {\n const iat = Math.floor(Date.now() / 1000);\n return signer.sign({\n iss: IN_MEMORY_PLATFORM_ISSUER,\n aud: claims.audience,\n sub: claims.sandboxId ?? providerId,\n jti: crypto.randomUUID(),\n iat,\n exp: iat + 300,\n variant: claims.variant,\n organization_id: claims.organizationId,\n project_id: claims.projectId,\n session_id: null,\n sandbox_id: claims.sandboxId,\n conversation_id: null,\n participant_id: null,\n turn_id: null,\n user_id: claims.userId,\n actor: null,\n scopes: claims.scopes,\n provider_id: providerId,\n ...(claims.grantAudience == null ? {} : { grant_audience: claims.grantAudience }),\n });\n };\n\n // The platform side of the two callbacks a provider host makes.\n const platformFetch = async (request: Request): Promise<Response> => {\n const target = new URL(request.url);\n const verifySubject = (token: string) =>\n verifyPlatformIdentity({\n token,\n audience: null,\n variant: [PlatformIdentityVariant.SandboxProvider, PlatformIdentityVariant.Downstream],\n issuer: IN_MEMORY_PLATFORM_ISSUER,\n jwks: signer.jwks,\n });\n if (target.pathname === PLATFORM_IDENTITY_EXCHANGE_PATH) {\n const body = platformIdentityExchangeRequestSchema.parse(JSON.parse(await request.text()));\n const subject = await verifySubject(body.subjectToken);\n if (!subject.ok) return Response.json({ error: { code: subject.refusal } }, { status: 403 });\n const claims = subject.claims;\n if (args.grants != null && body.audience !== url && !args.grants.includes(body.audience))\n return Response.json({ error: { code: 'audience_not_granted' } }, { status: 403 });\n exchanges.push({\n audience: body.audience,\n sandboxId: claims.sandboxId,\n userId: claims.userId,\n });\n const downstream =\n body.audience === url\n ? null\n : (args.downstreamToken?.({ audience: body.audience, userId: claims.userId }) ?? null);\n if (downstream != null)\n return Response.json({\n token: downstream,\n expiresAt: new Date(Date.now() + 300_000).toISOString(),\n });\n const token = await sign({\n audience: body.audience,\n variant:\n body.audience === url\n ? PlatformIdentityVariant.SandboxProvider\n : PlatformIdentityVariant.Downstream,\n organizationId: claims.organizationId,\n projectId: claims.projectId,\n sandboxId: claims.sandboxId,\n userId: claims.userId,\n scopes: body.audience === url ? SANDBOX_PROVIDER_SCOPES : { backend: ['use'] },\n ...(body.audience === url ? {} : { grantAudience: body.audience }),\n });\n return Response.json({ token, expiresAt: new Date(Date.now() + 300_000).toISOString() });\n }\n if (target.pathname.startsWith(`${SANDBOX_PROVIDER_ARTIFACTS_PATH}/`)) {\n const bearer = /^Bearer\\s+(.+)$/iu.exec(request.headers.get('authorization') ?? '')?.[1];\n const subject = bearer == null ? null : await verifySubject(bearer);\n if (subject == null || !subject.ok) return new Response(null, { status: 401 });\n const key = `${subject.claims.organizationId}:${decodeURIComponent(\n target.pathname.slice(SANDBOX_PROVIDER_ARTIFACTS_PATH.length + 1),\n )}`;\n if (request.method === 'PUT') {\n artifacts.set(\n key,\n sandboxProviderArtifactBodySchema.parse(JSON.parse(await request.text())).artifact,\n );\n return new Response(null, { status: 204 });\n }\n const artifact = artifacts.get(key);\n return artifact === undefined\n ? new Response(null, { status: 404 })\n : Response.json({ artifact });\n }\n return new Response(null, { status: 404 });\n };\n\n const server = serveSandboxProvider({\n providers: {\n [name]: {\n provider: args.provider,\n discovery: {\n formFactor: SandboxFormFactor.Machine,\n capabilities: {},\n ...args.discovery,\n },\n },\n },\n issuer: IN_MEMORY_PLATFORM_ISSUER,\n jwks: signer.jwks,\n publicUrl: (provider) => `${IN_MEMORY_PROVIDER_ORIGIN}/${provider}`,\n fetch: async (input, init) => platformFetch(new Request(input, init)),\n ...(args.heartbeatMs == null ? {} : { heartbeatMs: args.heartbeatMs }),\n });\n\n const providerFetch = async (input: RequestInfo | URL, init?: RequestInit) => {\n const request = new Request(input, init);\n calls.push(new URL(request.url).pathname.slice(`/${name}`.length));\n return args.proxy == null ? server.fetch(request) : args.proxy(request, server.fetch);\n };\n\n const openSocket = (target: string, protocols: string[]): WebSocketLikeIface => {\n calls.push(new URL(target).pathname.slice(`/${name}`.length));\n const holder: { client: TestSocketIface | null; server: TestSocketIface | null } = {\n client: null,\n server: null,\n };\n const client = createTestSocket(() => {\n if (holder.server == null) throw new Error('no server socket');\n return holder.server;\n }, false);\n const serverSocket = createTestSocket(() => client, true);\n holder.client = client;\n holder.server = serverSocket;\n sockets.add(client);\n server.upgrade(\n new Request(target.replace(/^ws/u, 'http'), {\n headers: { 'sec-websocket-protocol': protocols.join(', ') },\n }),\n serverSocket,\n );\n return client;\n };\n\n // Registered as a platform would: from the provider's discovery document.\n const discovery = sandboxProviderDiscoverySchema.parse(\n JSON.parse(\n await (await server.fetch(new Request(`${url}${SANDBOX_PROVIDER_DISCOVERY_PATH}`))).text(),\n ),\n );\n const registration: RemoteSandboxProviderRegistrationIface = {\n id: providerId,\n name,\n url,\n stateProtocolVersion: discovery.stateProtocolVersion,\n features: discovery.features,\n };\n\n const mintAssertion = (claims: SandboxProviderAssertionArgsIface) =>\n sign({\n audience: claims.audience,\n variant: PlatformIdentityVariant.SandboxProvider,\n organizationId: claims.organizationId,\n projectId: claims.projectId,\n sandboxId: claims.sandboxId,\n userId: claims.userId,\n scopes: SANDBOX_PROVIDER_SCOPES,\n });\n\n return {\n url,\n mintAssertion,\n fetchProvider: (request) => server.fetch(request),\n provider: remoteSandboxProvider({\n registration,\n mintAssertion: async (claims) => {\n assertions.push(claims);\n return mintAssertion(claims);\n },\n forwardedSecrets: async () => ({ ...args.forwardedSecrets }),\n fetch: providerFetch,\n openSocket,\n }),\n calls: () => [...calls],\n exchanges: () => [...exchanges],\n assertions: () => [...assertions],\n dropSockets: () => {\n for (const socket of sockets) socket.close(ABNORMAL_CLOSE, 'network drop');\n sockets.clear();\n },\n };\n};\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -1,5 +1,5 @@
1
1
  import * as z from 'zod';
2
- import type { SandboxPrepareContextIface, SandboxSessionIface, SandboxStartContextIface } from "./types.mjs";
2
+ import type { SandboxPrepareContextIface, SandboxSessionIface, SandboxResourceContextIface } from "./types.mjs";
3
3
  export declare const sandboxPreparationInputs: (files: Record<string, string>) => Pick<SandboxPrepareContextIface, "files" | "resources">;
4
4
  export declare const MAX_SANDBOX_SEED_BYTES: number;
5
5
  export declare const sandboxSeedFilesSchema: z.ZodPreprocess<z.ZodPipe<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>, z.ZodTransform<{
@@ -23,4 +23,4 @@ export declare const sandboxSeedArtifactSchema: z.ZodObject<{
23
23
  seedHash: z.ZodOptional<z.ZodString>;
24
24
  }, z.core.$strip>;
25
25
  export declare const sandboxSeedArtifact: (ctx: SandboxPrepareContextIface, files: Record<string, string>) => Promise<z.output<typeof sandboxSeedArtifactSchema>>;
26
- export declare const sandboxSeedFilesForStart: (ctx: SandboxStartContextIface, artifact: z.output<typeof sandboxSeedArtifactSchema>) => Promise<Record<string, string>>;
26
+ export declare const sandboxSeedFilesForAttach: (ctx: SandboxResourceContextIface, artifact: z.output<typeof sandboxSeedArtifactSchema>) => Promise<Record<string, string>>;
@@ -202,7 +202,7 @@ const sandboxSeedArtifact = async (ctx, files) => {
202
202
  throw new Error("preparation resource revision does not match");
203
203
  return { seedFiles: {}, seedSourceRevision: ctx.sourceRevision, seedHash: await seedHash(files) };
204
204
  };
205
- const sandboxSeedFilesForStart = async (ctx, artifact) => {
205
+ const sandboxSeedFilesForAttach = async (ctx, artifact) => {
206
206
  if (artifact.seedSourceRevision == null) return artifact.seedFiles;
207
207
  if (ctx.preparation?.sourceRevision !== artifact.seedSourceRevision)
208
208
  throw new Error("pinned sandbox seed resource source is unavailable");
@@ -221,7 +221,7 @@ export {
221
221
  sandboxSeedArtifact,
222
222
  sandboxSeedArtifactSchema,
223
223
  sandboxSeedFiles,
224
- sandboxSeedFilesForStart,
224
+ sandboxSeedFilesForAttach,
225
225
  sandboxSeedFilesSchema,
226
226
  sandboxSeedIdentity
227
227
  };
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/sandbox/seeds.ts"],
4
- "sourcesContent": ["import * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport type {\n SandboxPrepareContextIface,\n SandboxSessionIface,\n SandboxStartContextIface,\n} from \"./types.mjs\";\n\nexport const sandboxPreparationInputs = (\n files: Record<string, string>,\n): Pick<SandboxPrepareContextIface, 'files' | 'resources'> => {\n const workspace = new Map<string, string>();\n const skills = new Map<string, Map<string, string>>();\n for (const [path, content] of Object.entries(files)) {\n if (path.startsWith('workspace/')) workspace.set(path.slice('workspace/'.length), content);\n if (!path.startsWith('skills/')) continue;\n const segments = path.slice('skills/'.length).split('/');\n const key = segments.shift();\n if (key == null || segments.length === 0) continue;\n const skill = skills.get(key) ?? new Map<string, string>();\n skill.set(segments.join('/'), content);\n skills.set(key, skill);\n }\n const resources = {\n workspace: { files: Object.fromEntries(workspace) },\n skills: Object.fromEntries(\n [...skills].map(([key, entries]) => [key, Object.fromEntries(entries)]),\n ),\n } satisfies Record<string, JsonValue>;\n return { files: Object.fromEntries(workspace), resources };\n};\nconst skillResourcesSchema = z.record(z.string(), z.record(z.string(), z.string()));\nexport const MAX_SANDBOX_SEED_BYTES = 8 * 1024 * 1024;\nexport const sandboxSeedFilesSchema = z.preprocess(\n (value) =>\n z.record(z.string(), z.unknown()).safeParse(value).success ? Object.entries(value ?? {}) : null,\n z.array(z.tuple([z.string(), z.string()])).transform((entries) => Object.fromEntries(entries)),\n);\n\nconst seedPath = (path: string): string => {\n if (\n path === '.final' ||\n path.startsWith('.final/') ||\n path.includes('\\\\') ||\n path.includes('\\0') ||\n path.split('/').some((part) => part === '' || part === '.' || part === '..')\n ) {\n throw new Error(`invalid workspace seed path: ${path}`);\n }\n return path;\n};\n\n// Skills remain harness config; their auxiliary files are also available in the workspace.\nexport const sandboxSeedFiles = (\n ctx: Pick<SandboxPrepareContextIface, 'files' | 'resources'>,\n): Record<string, string> => {\n const entries: [string, string][] = Object.entries(ctx.files).map(([path, content]) => [\n seedPath(path),\n content,\n ]);\n const skills = ctx.resources.skills ?? {};\n skillResourcesSchema.parse(skills);\n // Zod dictionaries omit __proto__; validate values while retaining literal filenames.\n const skillEntries: [string, unknown][] = Object.entries(skills);\n for (const [name, files] of skillEntries) {\n if (seedPath(name).includes('/')) throw new Error(`invalid skill resource name: ${name}`);\n z.record(z.string(), z.string()).parse(files);\n const fileEntries: [string, unknown][] = Object.entries(files ?? {});\n for (const [path, content] of fileEntries)\n entries.push([`.agents/skills/${name}/${seedPath(path)}`, z.string().parse(content)]);\n }\n const paths = new Set<string>();\n for (const [path] of entries) {\n if (paths.has(path)) throw new Error(`conflicting workspace seed path: ${path}`);\n paths.add(path);\n }\n for (const path of paths) {\n const parts = path.split('/');\n for (let end = 1; end < parts.length; end += 1) {\n const ancestor = parts.slice(0, end).join('/');\n if (paths.has(ancestor))\n throw new Error(`conflicting workspace seed paths: ${ancestor}, ${path}`);\n }\n }\n const encoder = new TextEncoder();\n let bytes = 0;\n for (const [path, content] of entries) {\n if (!path.isWellFormed() || !content.isWellFormed())\n throw new Error(`workspace seed ${path} must contain valid Unicode text`);\n bytes += encoder.encode(path).byteLength + encoder.encode(content).byteLength;\n if (bytes > MAX_SANDBOX_SEED_BYTES)\n throw new Error('workspace and skill resources exceed the combined 8 MiB limit');\n }\n return Object.fromEntries(entries);\n};\n\nexport const sandboxSeedIdentity = (files: Record<string, string>): string =>\n JSON.stringify(\n Object.entries(files).sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0)),\n );\n\n// As with confined reads, Python 3 is required. Directory descriptors pin every\n// ancestor; link publishes a complete file without replacing existing content.\nexport const SANDBOX_SEED_MARKER = 'workspace-seeded';\nexport const SANDBOX_SEED_PROTOCOL = 'workspace-seed-v1';\nexport const SANDBOX_SEED_SCRIPT = `import json, os, stat, sys, uuid\np = json.load(sys.stdin)\nflags = os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW\nroot = os.open('/', flags)\ntry:\n for part in p['root'].split('/'):\n if not part:\n continue\n if part in ('.', '..'):\n raise ValueError('invalid workspace root')\n next_fd = os.open(part, flags, dir_fd=root)\n os.close(root)\n root = next_fd\n try:\n os.mkdir('.final', dir_fd=root)\n except FileExistsError:\n pass\n state = os.open('.final', flags, dir_fd=root)\n try:\n marker = os.open('${SANDBOX_SEED_MARKER}', os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK, dir_fd=state)\n except FileNotFoundError:\n marker = None\n if marker is not None:\n try:\n if not stat.S_ISREG(os.fstat(marker).st_mode) or os.read(marker, 64) != b'${SANDBOX_SEED_PROTOCOL}':\n raise ValueError('invalid workspace seed marker')\n finally:\n os.close(marker)\n os.close(state)\n sys.exit(0)\n for path, content in p['files'].items():\n parts = path.split('/')\n if parts[0] == '.final' or any(x in ('', '.', '..') or '\\\\\\\\' in x or '\\\\x00' in x for x in parts):\n raise ValueError('invalid seed path')\n parent = os.dup(root)\n temporary = None\n try:\n for part in parts[:-1]:\n try:\n os.mkdir(part, dir_fd=parent)\n except FileExistsError:\n pass\n next_fd = os.open(part, flags, dir_fd=parent)\n os.close(parent)\n parent = next_fd\n name = parts[-1]\n try:\n existing = os.stat(name, dir_fd=parent, follow_symlinks=False)\n except FileNotFoundError:\n existing = None\n if existing is not None:\n if not stat.S_ISREG(existing.st_mode):\n raise ValueError('seed destination is not a regular file: ' + path)\n continue\n temporary = '.final-seed-' + uuid.uuid4().hex\n fd = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o644, dir_fd=parent)\n with os.fdopen(fd, 'wb') as output:\n output.write(content.encode('utf-8'))\n output.flush()\n os.fsync(output.fileno())\n try:\n os.link(temporary, name, src_dir_fd=parent, dst_dir_fd=parent, follow_symlinks=False)\n except FileExistsError:\n if not stat.S_ISREG(os.stat(name, dir_fd=parent, follow_symlinks=False).st_mode):\n raise ValueError('seed destination is not a regular file: ' + path)\n finally:\n if temporary is not None:\n os.unlink(temporary, dir_fd=parent)\n os.close(parent)\n temporary = '.seed-marker-' + uuid.uuid4().hex\n marker = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o600, dir_fd=state)\n try:\n with os.fdopen(marker, 'wb') as output:\n output.write(b'${SANDBOX_SEED_PROTOCOL}')\n output.flush()\n os.fsync(output.fileno())\n try:\n os.link(temporary, '${SANDBOX_SEED_MARKER}', src_dir_fd=state, dst_dir_fd=state, follow_symlinks=False)\n except FileExistsError:\n pass\n finally:\n os.unlink(temporary, dir_fd=state)\n os.close(state)\nfinally:\n os.close(root)\n`;\n\nexport const materializeSandboxSeeds = async (args: {\n sandbox: Pick<SandboxSessionIface, 'run'>;\n root: string;\n files: Record<string, string>;\n}): Promise<void> => {\n if (Object.keys(args.files).length === 0) return;\n if (!args.root.startsWith('/')) throw new Error('workspace seed root must be absolute');\n const result = await args.sandbox.run({\n command: 'python3',\n args: ['-c', SANDBOX_SEED_SCRIPT],\n cwd: '/',\n stdin: new ReadableStream<Uint8Array>({\n start: (controller) => {\n const bytes = new TextEncoder().encode(\n JSON.stringify({ root: args.root, files: args.files }),\n );\n for (let offset = 0; offset < bytes.byteLength; offset += 64 * 1024)\n controller.enqueue(bytes.subarray(offset, offset + 64 * 1024));\n controller.close();\n },\n }),\n timeoutMs: 60_000,\n });\n if (result.exitCode !== 0)\n throw new Error(`workspace seeding failed: ${result.stderr.trim().slice(-2000)}`);\n};\n\nexport const sandboxSeedArtifactSchema = z.object({\n seedFiles: sandboxSeedFilesSchema.default({}),\n seedSourceRevision: z.string().optional(),\n seedHash: z.string().optional(),\n});\n\nconst seedHash = async (files: Record<string, string>): Promise<string> => {\n const digest = await crypto.subtle.digest(\n 'SHA-256',\n new TextEncoder().encode(sandboxSeedIdentity(files)),\n );\n return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, '0')).join('');\n};\n\nexport const sandboxSeedArtifact = async (\n ctx: SandboxPrepareContextIface,\n files: Record<string, string>,\n): Promise<z.output<typeof sandboxSeedArtifactSchema>> => {\n if (ctx.preparation == null || Object.keys(files).length === 0) return { seedFiles: files };\n if (ctx.preparation.sourceRevision !== ctx.sourceRevision)\n throw new Error('preparation resource revision does not match');\n return { seedFiles: {}, seedSourceRevision: ctx.sourceRevision, seedHash: await seedHash(files) };\n};\n\nexport const sandboxSeedFilesForStart = async (\n ctx: SandboxStartContextIface,\n artifact: z.output<typeof sandboxSeedArtifactSchema>,\n): Promise<Record<string, string>> => {\n if (artifact.seedSourceRevision == null) return artifact.seedFiles;\n if (ctx.preparation?.sourceRevision !== artifact.seedSourceRevision)\n throw new Error('pinned sandbox seed resource source is unavailable');\n const files = sandboxSeedFiles(await ctx.preparation.read());\n if (artifact.seedHash == null || (await seedHash(files)) !== artifact.seedHash)\n throw new Error('pinned sandbox seed resource identity does not match the artifact');\n return files;\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import * as z from 'zod';\nimport type { JsonValue } from \"../json.mjs\";\nimport type {\n SandboxPrepareContextIface,\n SandboxSessionIface,\n SandboxResourceContextIface,\n} from \"./types.mjs\";\n\nexport const sandboxPreparationInputs = (\n files: Record<string, string>,\n): Pick<SandboxPrepareContextIface, 'files' | 'resources'> => {\n const workspace = new Map<string, string>();\n const skills = new Map<string, Map<string, string>>();\n for (const [path, content] of Object.entries(files)) {\n if (path.startsWith('workspace/')) workspace.set(path.slice('workspace/'.length), content);\n if (!path.startsWith('skills/')) continue;\n const segments = path.slice('skills/'.length).split('/');\n const key = segments.shift();\n if (key == null || segments.length === 0) continue;\n const skill = skills.get(key) ?? new Map<string, string>();\n skill.set(segments.join('/'), content);\n skills.set(key, skill);\n }\n const resources = {\n workspace: { files: Object.fromEntries(workspace) },\n skills: Object.fromEntries(\n [...skills].map(([key, entries]) => [key, Object.fromEntries(entries)]),\n ),\n } satisfies Record<string, JsonValue>;\n return { files: Object.fromEntries(workspace), resources };\n};\nconst skillResourcesSchema = z.record(z.string(), z.record(z.string(), z.string()));\nexport const MAX_SANDBOX_SEED_BYTES = 8 * 1024 * 1024;\nexport const sandboxSeedFilesSchema = z.preprocess(\n (value) =>\n z.record(z.string(), z.unknown()).safeParse(value).success ? Object.entries(value ?? {}) : null,\n z.array(z.tuple([z.string(), z.string()])).transform((entries) => Object.fromEntries(entries)),\n);\n\nconst seedPath = (path: string): string => {\n if (\n path === '.final' ||\n path.startsWith('.final/') ||\n path.includes('\\\\') ||\n path.includes('\\0') ||\n path.split('/').some((part) => part === '' || part === '.' || part === '..')\n ) {\n throw new Error(`invalid workspace seed path: ${path}`);\n }\n return path;\n};\n\n// Skills remain harness config; their auxiliary files are also available in the workspace.\nexport const sandboxSeedFiles = (\n ctx: Pick<SandboxPrepareContextIface, 'files' | 'resources'>,\n): Record<string, string> => {\n const entries: [string, string][] = Object.entries(ctx.files).map(([path, content]) => [\n seedPath(path),\n content,\n ]);\n const skills = ctx.resources.skills ?? {};\n skillResourcesSchema.parse(skills);\n // Zod dictionaries omit __proto__; validate values while retaining literal filenames.\n const skillEntries: [string, unknown][] = Object.entries(skills);\n for (const [name, files] of skillEntries) {\n if (seedPath(name).includes('/')) throw new Error(`invalid skill resource name: ${name}`);\n z.record(z.string(), z.string()).parse(files);\n const fileEntries: [string, unknown][] = Object.entries(files ?? {});\n for (const [path, content] of fileEntries)\n entries.push([`.agents/skills/${name}/${seedPath(path)}`, z.string().parse(content)]);\n }\n const paths = new Set<string>();\n for (const [path] of entries) {\n if (paths.has(path)) throw new Error(`conflicting workspace seed path: ${path}`);\n paths.add(path);\n }\n for (const path of paths) {\n const parts = path.split('/');\n for (let end = 1; end < parts.length; end += 1) {\n const ancestor = parts.slice(0, end).join('/');\n if (paths.has(ancestor))\n throw new Error(`conflicting workspace seed paths: ${ancestor}, ${path}`);\n }\n }\n const encoder = new TextEncoder();\n let bytes = 0;\n for (const [path, content] of entries) {\n if (!path.isWellFormed() || !content.isWellFormed())\n throw new Error(`workspace seed ${path} must contain valid Unicode text`);\n bytes += encoder.encode(path).byteLength + encoder.encode(content).byteLength;\n if (bytes > MAX_SANDBOX_SEED_BYTES)\n throw new Error('workspace and skill resources exceed the combined 8 MiB limit');\n }\n return Object.fromEntries(entries);\n};\n\nexport const sandboxSeedIdentity = (files: Record<string, string>): string =>\n JSON.stringify(\n Object.entries(files).sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0)),\n );\n\n// As with confined reads, Python 3 is required. Directory descriptors pin every\n// ancestor; link publishes a complete file without replacing existing content.\nexport const SANDBOX_SEED_MARKER = 'workspace-seeded';\nexport const SANDBOX_SEED_PROTOCOL = 'workspace-seed-v1';\nexport const SANDBOX_SEED_SCRIPT = `import json, os, stat, sys, uuid\np = json.load(sys.stdin)\nflags = os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW\nroot = os.open('/', flags)\ntry:\n for part in p['root'].split('/'):\n if not part:\n continue\n if part in ('.', '..'):\n raise ValueError('invalid workspace root')\n next_fd = os.open(part, flags, dir_fd=root)\n os.close(root)\n root = next_fd\n try:\n os.mkdir('.final', dir_fd=root)\n except FileExistsError:\n pass\n state = os.open('.final', flags, dir_fd=root)\n try:\n marker = os.open('${SANDBOX_SEED_MARKER}', os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK, dir_fd=state)\n except FileNotFoundError:\n marker = None\n if marker is not None:\n try:\n if not stat.S_ISREG(os.fstat(marker).st_mode) or os.read(marker, 64) != b'${SANDBOX_SEED_PROTOCOL}':\n raise ValueError('invalid workspace seed marker')\n finally:\n os.close(marker)\n os.close(state)\n sys.exit(0)\n for path, content in p['files'].items():\n parts = path.split('/')\n if parts[0] == '.final' or any(x in ('', '.', '..') or '\\\\\\\\' in x or '\\\\x00' in x for x in parts):\n raise ValueError('invalid seed path')\n parent = os.dup(root)\n temporary = None\n try:\n for part in parts[:-1]:\n try:\n os.mkdir(part, dir_fd=parent)\n except FileExistsError:\n pass\n next_fd = os.open(part, flags, dir_fd=parent)\n os.close(parent)\n parent = next_fd\n name = parts[-1]\n try:\n existing = os.stat(name, dir_fd=parent, follow_symlinks=False)\n except FileNotFoundError:\n existing = None\n if existing is not None:\n if not stat.S_ISREG(existing.st_mode):\n raise ValueError('seed destination is not a regular file: ' + path)\n continue\n temporary = '.final-seed-' + uuid.uuid4().hex\n fd = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o644, dir_fd=parent)\n with os.fdopen(fd, 'wb') as output:\n output.write(content.encode('utf-8'))\n output.flush()\n os.fsync(output.fileno())\n try:\n os.link(temporary, name, src_dir_fd=parent, dst_dir_fd=parent, follow_symlinks=False)\n except FileExistsError:\n if not stat.S_ISREG(os.stat(name, dir_fd=parent, follow_symlinks=False).st_mode):\n raise ValueError('seed destination is not a regular file: ' + path)\n finally:\n if temporary is not None:\n os.unlink(temporary, dir_fd=parent)\n os.close(parent)\n temporary = '.seed-marker-' + uuid.uuid4().hex\n marker = os.open(temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o600, dir_fd=state)\n try:\n with os.fdopen(marker, 'wb') as output:\n output.write(b'${SANDBOX_SEED_PROTOCOL}')\n output.flush()\n os.fsync(output.fileno())\n try:\n os.link(temporary, '${SANDBOX_SEED_MARKER}', src_dir_fd=state, dst_dir_fd=state, follow_symlinks=False)\n except FileExistsError:\n pass\n finally:\n os.unlink(temporary, dir_fd=state)\n os.close(state)\nfinally:\n os.close(root)\n`;\n\nexport const materializeSandboxSeeds = async (args: {\n sandbox: Pick<SandboxSessionIface, 'run'>;\n root: string;\n files: Record<string, string>;\n}): Promise<void> => {\n if (Object.keys(args.files).length === 0) return;\n if (!args.root.startsWith('/')) throw new Error('workspace seed root must be absolute');\n const result = await args.sandbox.run({\n command: 'python3',\n args: ['-c', SANDBOX_SEED_SCRIPT],\n cwd: '/',\n stdin: new ReadableStream<Uint8Array>({\n start: (controller) => {\n const bytes = new TextEncoder().encode(\n JSON.stringify({ root: args.root, files: args.files }),\n );\n for (let offset = 0; offset < bytes.byteLength; offset += 64 * 1024)\n controller.enqueue(bytes.subarray(offset, offset + 64 * 1024));\n controller.close();\n },\n }),\n timeoutMs: 60_000,\n });\n if (result.exitCode !== 0)\n throw new Error(`workspace seeding failed: ${result.stderr.trim().slice(-2000)}`);\n};\n\nexport const sandboxSeedArtifactSchema = z.object({\n seedFiles: sandboxSeedFilesSchema.default({}),\n seedSourceRevision: z.string().optional(),\n seedHash: z.string().optional(),\n});\n\nconst seedHash = async (files: Record<string, string>): Promise<string> => {\n const digest = await crypto.subtle.digest(\n 'SHA-256',\n new TextEncoder().encode(sandboxSeedIdentity(files)),\n );\n return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, '0')).join('');\n};\n\nexport const sandboxSeedArtifact = async (\n ctx: SandboxPrepareContextIface,\n files: Record<string, string>,\n): Promise<z.output<typeof sandboxSeedArtifactSchema>> => {\n if (ctx.preparation == null || Object.keys(files).length === 0) return { seedFiles: files };\n if (ctx.preparation.sourceRevision !== ctx.sourceRevision)\n throw new Error('preparation resource revision does not match');\n return { seedFiles: {}, seedSourceRevision: ctx.sourceRevision, seedHash: await seedHash(files) };\n};\n\nexport const sandboxSeedFilesForAttach = async (\n ctx: SandboxResourceContextIface,\n artifact: z.output<typeof sandboxSeedArtifactSchema>,\n): Promise<Record<string, string>> => {\n if (artifact.seedSourceRevision == null) return artifact.seedFiles;\n if (ctx.preparation?.sourceRevision !== artifact.seedSourceRevision)\n throw new Error('pinned sandbox seed resource source is unavailable');\n const files = sandboxSeedFiles(await ctx.preparation.read());\n if (artifact.seedHash == null || (await seedHash(files)) !== artifact.seedHash)\n throw new Error('pinned sandbox seed resource identity does not match the artifact');\n return files;\n};\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,11 +1,8 @@
1
- import { SandboxAccess } from "../manifest.mjs";
1
+ import { type HandleAccessPolicyIface } from "./grant.mjs";
2
2
  import { type RpcRequestContextIface } from "./rpc-peer.mjs";
3
3
  import { type NetworkSandboxSessionIface, type SandboxProviderHandleIface } from "./types.mjs";
4
4
  import { type DescribeResultIface, type FrameChannelIface, type FrameStreamIface, type WebSocketLikeIface, type WireFrame } from "./wire.mjs";
5
- export interface HandleAccessPolicyIface {
6
- mode: SandboxAccess;
7
- lifecycle: boolean;
8
- }
5
+ export type { HandleAccessPolicyIface } from "./grant.mjs";
9
6
  export declare const DEFAULT_HANDLE_ACCESS: HandleAccessPolicyIface;
10
7
  export interface HandleAuthorizationIface {
11
8
  expiresAt: string | null;
@@ -13,6 +10,7 @@ export interface HandleAuthorizationIface {
13
10
  }
14
11
  export type HandleAuthorizeFn = (args: {
15
12
  token: string | null;
13
+ identity?: string | null;
16
14
  }) => Promise<HandleAuthorizationIface | null>;
17
15
  export type HandleLifecycle = Pick<SandboxProviderHandleIface<NetworkSandboxSessionIface>, 'onSandboxStop' | 'onSandboxDelete' | 'onRuntimeShutdown'>;
18
16
  export interface HandleResolutionIface {
@@ -36,7 +34,7 @@ export interface HandleRpcMessageHandlerIface {
36
34
  onFrame(frame: WireFrame): void;
37
35
  onClose(code?: number, reason?: string): void;
38
36
  }
39
- export declare const describeSandbox: (sandbox: NetworkSandboxSessionIface, mcpChannels?: boolean) => Promise<DescribeResultIface>;
37
+ export declare const describeSandboxHandle: (sandbox: NetworkSandboxSessionIface, mcpChannels?: boolean) => Promise<DescribeResultIface>;
40
38
  export declare const createHandleRpcMessageHandler: (options: HandleRpcMessageHandlerOptionsIface) => HandleRpcMessageHandlerIface;
41
39
  export interface ServeSandboxHandleArgsIface {
42
40
  sandbox: NetworkSandboxSessionIface;