@blen/uspto-mcp-server 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (201) hide show
  1. package/CHANGELOG.md +52 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +55 -0
  4. package/README.md +229 -2
  5. package/SECURITY.md +142 -0
  6. package/dist/accounts/app.d.ts +18 -0
  7. package/dist/accounts/app.d.ts.map +1 -0
  8. package/dist/accounts/app.js +407 -0
  9. package/dist/accounts/app.js.map +1 -0
  10. package/dist/accounts/config.d.ts +21 -0
  11. package/dist/accounts/config.d.ts.map +1 -0
  12. package/dist/accounts/config.js +55 -0
  13. package/dist/accounts/config.js.map +1 -0
  14. package/dist/accounts/crypto.d.ts +18 -0
  15. package/dist/accounts/crypto.d.ts.map +1 -0
  16. package/dist/accounts/crypto.js +43 -0
  17. package/dist/accounts/crypto.js.map +1 -0
  18. package/dist/accounts/keyGates.d.ts +19 -0
  19. package/dist/accounts/keyGates.d.ts.map +1 -0
  20. package/dist/accounts/keyGates.js +47 -0
  21. package/dist/accounts/keyGates.js.map +1 -0
  22. package/dist/accounts/paths.d.ts +10 -0
  23. package/dist/accounts/paths.d.ts.map +1 -0
  24. package/dist/accounts/paths.js +10 -0
  25. package/dist/accounts/paths.js.map +1 -0
  26. package/dist/accounts/portal.d.ts +7 -0
  27. package/dist/accounts/portal.d.ts.map +1 -0
  28. package/dist/accounts/portal.js +225 -0
  29. package/dist/accounts/portal.js.map +1 -0
  30. package/dist/accounts/provider.d.ts +2610 -0
  31. package/dist/accounts/provider.d.ts.map +1 -0
  32. package/dist/accounts/provider.js +108 -0
  33. package/dist/accounts/provider.js.map +1 -0
  34. package/dist/accounts/runtime.d.ts +26 -0
  35. package/dist/accounts/runtime.d.ts.map +1 -0
  36. package/dist/accounts/runtime.js +168 -0
  37. package/dist/accounts/runtime.js.map +1 -0
  38. package/dist/accounts/store.d.ts +30 -0
  39. package/dist/accounts/store.d.ts.map +1 -0
  40. package/dist/accounts/store.js +155 -0
  41. package/dist/accounts/store.js.map +1 -0
  42. package/dist/bin.d.ts +3 -0
  43. package/dist/bin.d.ts.map +1 -0
  44. package/dist/bin.js +195 -0
  45. package/dist/bin.js.map +1 -0
  46. package/dist/index.d.ts +11 -0
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +8 -0
  49. package/dist/index.js.map +1 -0
  50. package/dist/sandbox/deno.d.ts +35 -0
  51. package/dist/sandbox/deno.d.ts.map +1 -0
  52. package/dist/sandbox/deno.js +373 -0
  53. package/dist/sandbox/deno.js.map +1 -0
  54. package/dist/sandbox/index.d.ts +28 -0
  55. package/dist/sandbox/index.d.ts.map +1 -0
  56. package/dist/sandbox/index.js +55 -0
  57. package/dist/sandbox/index.js.map +1 -0
  58. package/dist/sandbox/isolate.d.ts +17 -0
  59. package/dist/sandbox/isolate.d.ts.map +1 -0
  60. package/dist/sandbox/isolate.js +195 -0
  61. package/dist/sandbox/isolate.js.map +1 -0
  62. package/dist/sandbox/limits.d.ts +60 -0
  63. package/dist/sandbox/limits.d.ts.map +1 -0
  64. package/dist/sandbox/limits.js +86 -0
  65. package/dist/sandbox/limits.js.map +1 -0
  66. package/dist/sandbox/policy.d.ts +7 -0
  67. package/dist/sandbox/policy.d.ts.map +1 -0
  68. package/dist/sandbox/policy.js +87 -0
  69. package/dist/sandbox/policy.js.map +1 -0
  70. package/dist/sandbox/types.d.ts +57 -0
  71. package/dist/sandbox/types.d.ts.map +1 -0
  72. package/dist/sandbox/types.js +6 -0
  73. package/dist/sandbox/types.js.map +1 -0
  74. package/dist/sdk/bindings.d.ts +13 -0
  75. package/dist/sdk/bindings.d.ts.map +1 -0
  76. package/dist/sdk/bindings.js +22 -0
  77. package/dist/sdk/bindings.js.map +1 -0
  78. package/dist/sdk/odp-client.d.ts +167 -0
  79. package/dist/sdk/odp-client.d.ts.map +1 -0
  80. package/dist/sdk/odp-client.js +253 -0
  81. package/dist/sdk/odp-client.js.map +1 -0
  82. package/dist/sdk/runtime.d.ts +21 -0
  83. package/dist/sdk/runtime.d.ts.map +1 -0
  84. package/dist/sdk/runtime.js +32 -0
  85. package/dist/sdk/runtime.js.map +1 -0
  86. package/dist/sdk/sources/corpus-loader.d.ts +8 -0
  87. package/dist/sdk/sources/corpus-loader.d.ts.map +1 -0
  88. package/dist/sdk/sources/corpus-loader.js +17 -0
  89. package/dist/sdk/sources/corpus-loader.js.map +1 -0
  90. package/dist/sdk/sources/index.d.ts +8 -0
  91. package/dist/sdk/sources/index.d.ts.map +1 -0
  92. package/dist/sdk/sources/index.js +25 -0
  93. package/dist/sdk/sources/index.js.map +1 -0
  94. package/dist/sdk/sources/odp.d.ts +5 -0
  95. package/dist/sdk/sources/odp.d.ts.map +1 -0
  96. package/dist/sdk/sources/odp.js +78 -0
  97. package/dist/sdk/sources/odp.js.map +1 -0
  98. package/dist/sdk/sources/source.d.ts +44 -0
  99. package/dist/sdk/sources/source.d.ts.map +1 -0
  100. package/dist/sdk/sources/source.js +3 -0
  101. package/dist/sdk/sources/source.js.map +1 -0
  102. package/dist/sdk/sources/tsdr.d.ts +5 -0
  103. package/dist/sdk/sources/tsdr.d.ts.map +1 -0
  104. package/dist/sdk/sources/tsdr.js +38 -0
  105. package/dist/sdk/sources/tsdr.js.map +1 -0
  106. package/dist/sdk/tsdr-client.d.ts +24 -0
  107. package/dist/sdk/tsdr-client.d.ts.map +1 -0
  108. package/dist/sdk/tsdr-client.js +65 -0
  109. package/dist/sdk/tsdr-client.js.map +1 -0
  110. package/dist/search/bm25.d.ts +25 -0
  111. package/dist/search/bm25.d.ts.map +1 -0
  112. package/dist/search/bm25.js +67 -0
  113. package/dist/search/bm25.js.map +1 -0
  114. package/dist/search/corpus.d.ts +24 -0
  115. package/dist/search/corpus.d.ts.map +1 -0
  116. package/dist/search/corpus.js +23 -0
  117. package/dist/search/corpus.js.map +1 -0
  118. package/dist/server/authz.d.ts +40 -0
  119. package/dist/server/authz.d.ts.map +1 -0
  120. package/dist/server/authz.js +70 -0
  121. package/dist/server/authz.js.map +1 -0
  122. package/dist/server/http.d.ts +44 -0
  123. package/dist/server/http.d.ts.map +1 -0
  124. package/dist/server/http.js +199 -0
  125. package/dist/server/http.js.map +1 -0
  126. package/dist/server/ipRateLimiter.d.ts +22 -0
  127. package/dist/server/ipRateLimiter.d.ts.map +1 -0
  128. package/dist/server/ipRateLimiter.js +58 -0
  129. package/dist/server/ipRateLimiter.js.map +1 -0
  130. package/dist/server/mcpServer.d.ts +22 -0
  131. package/dist/server/mcpServer.d.ts.map +1 -0
  132. package/dist/server/mcpServer.js +90 -0
  133. package/dist/server/mcpServer.js.map +1 -0
  134. package/dist/server/stdio.d.ts +3 -0
  135. package/dist/server/stdio.d.ts.map +1 -0
  136. package/dist/server/stdio.js +16 -0
  137. package/dist/server/stdio.js.map +1 -0
  138. package/dist/server/toolCatalog.d.ts +162 -0
  139. package/dist/server/toolCatalog.d.ts.map +1 -0
  140. package/dist/server/toolCatalog.js +83 -0
  141. package/dist/server/toolCatalog.js.map +1 -0
  142. package/dist/server/wellKnown.d.ts +16 -0
  143. package/dist/server/wellKnown.d.ts.map +1 -0
  144. package/dist/server/wellKnown.js +17 -0
  145. package/dist/server/wellKnown.js.map +1 -0
  146. package/dist/server/zodToJsonSchema.d.ts +8 -0
  147. package/dist/server/zodToJsonSchema.d.ts.map +1 -0
  148. package/dist/server/zodToJsonSchema.js +14 -0
  149. package/dist/server/zodToJsonSchema.js.map +1 -0
  150. package/dist/supervisor/index.d.ts +54 -0
  151. package/dist/supervisor/index.d.ts.map +1 -0
  152. package/dist/supervisor/index.js +62 -0
  153. package/dist/supervisor/index.js.map +1 -0
  154. package/dist/tools/describeSchema.d.ts +23 -0
  155. package/dist/tools/describeSchema.d.ts.map +1 -0
  156. package/dist/tools/describeSchema.js +14 -0
  157. package/dist/tools/describeSchema.js.map +1 -0
  158. package/dist/tools/execute.d.ts +36 -0
  159. package/dist/tools/execute.d.ts.map +1 -0
  160. package/dist/tools/execute.js +70 -0
  161. package/dist/tools/execute.js.map +1 -0
  162. package/dist/tools/searchApi.d.ts +21 -0
  163. package/dist/tools/searchApi.d.ts.map +1 -0
  164. package/dist/tools/searchApi.js +14 -0
  165. package/dist/tools/searchApi.js.map +1 -0
  166. package/dist/util/executionContext.d.ts +6 -0
  167. package/dist/util/executionContext.d.ts.map +1 -0
  168. package/dist/util/executionContext.js +26 -0
  169. package/dist/util/executionContext.js.map +1 -0
  170. package/dist/util/executionLimiter.d.ts +19 -0
  171. package/dist/util/executionLimiter.d.ts.map +1 -0
  172. package/dist/util/executionLimiter.js +41 -0
  173. package/dist/util/executionLimiter.js.map +1 -0
  174. package/dist/util/httpClient.d.ts +116 -0
  175. package/dist/util/httpClient.d.ts.map +1 -0
  176. package/dist/util/httpClient.js +434 -0
  177. package/dist/util/httpClient.js.map +1 -0
  178. package/dist/util/logger.d.ts +7 -0
  179. package/dist/util/logger.d.ts.map +1 -0
  180. package/dist/util/logger.js +25 -0
  181. package/dist/util/logger.js.map +1 -0
  182. package/dist/util/quotas.d.ts +13 -0
  183. package/dist/util/quotas.d.ts.map +1 -0
  184. package/dist/util/quotas.js +29 -0
  185. package/dist/util/quotas.js.map +1 -0
  186. package/dist/util/tokenBucket.d.ts +11 -0
  187. package/dist/util/tokenBucket.d.ts.map +1 -0
  188. package/dist/util/tokenBucket.js +30 -0
  189. package/dist/util/tokenBucket.js.map +1 -0
  190. package/dist/util/upstreamGate.d.ts +36 -0
  191. package/dist/util/upstreamGate.d.ts.map +1 -0
  192. package/dist/util/upstreamGate.js +112 -0
  193. package/dist/util/upstreamGate.js.map +1 -0
  194. package/dist/web/THIRD_PARTY_NOTICES.txt +1940 -0
  195. package/dist/web/assets/blen-logo-BKJFojyj.png +0 -0
  196. package/dist/web/assets/index-Dbbu8lq3.js +317 -0
  197. package/dist/web/assets/index-DkKvyv-b.css +2 -0
  198. package/dist/web/index.html +14 -0
  199. package/package.json +127 -4
  200. package/schema/odp.json +743 -0
  201. package/schema/tsdr.json +129 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deno.js","sourceRoot":"","sources":["../../src/sandbox/deno.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import type { ExecuteOptions, ExecuteResult, RpcBridge, SandboxKind, SandboxRunner } from './types.js';
2
+ import { IsolateRunner } from './isolate.js';
3
+ import { DenoRunner } from './deno.js';
4
+ export { IsolateRunner, DenoRunner };
5
+ export type { SandboxKind, SandboxRunner } from './types.js';
6
+ export type { ExecuteOptions, ExecuteResult, RpcBridge, RpcCall } from './types.js';
7
+ /**
8
+ * Placeholder runner that returns a clear error when `execute` is invoked.
9
+ * Keeps `search_api` and `describe_schema` functional in environments where
10
+ * neither `isolated-vm` nor `deno` is available.
11
+ */
12
+ export declare class UnavailableRunner implements SandboxRunner {
13
+ private readonly reason;
14
+ kind: 'unavailable';
15
+ constructor(reason: string);
16
+ available(): Promise<boolean>;
17
+ execute(_opts: ExecuteOptions, _rpc: RpcBridge): Promise<ExecuteResult>;
18
+ }
19
+ /**
20
+ * `auto` prefers isolated-vm (in-process, fastest) for single-user use (stdio, --insecure local).
21
+ * With `processIsolation` (authenticated, multi-user HTTP serving) only the Deno runner is allowed:
22
+ * user code must run in a separate, killable, permissionless process. There it never falls back
23
+ * to the in-process runner; without Deno, `execute` is unavailable and says why.
24
+ */
25
+ export declare function pickSandbox(preferred: SandboxKind, opts?: {
26
+ processIsolation?: boolean;
27
+ }): Promise<SandboxRunner>;
28
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpF;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,IAAI,EAAG,aAAa,CAAU;IAC9B,YAA6B,MAAM,EAAE,MAAM,EAAI;IACzC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAkB;IAC/C,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAO5E;CACF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAmB3H"}
@@ -0,0 +1,55 @@
1
+ import { IsolateRunner } from './isolate.js';
2
+ import { DenoRunner } from './deno.js';
3
+ export { IsolateRunner, DenoRunner };
4
+ /**
5
+ * Placeholder runner that returns a clear error when `execute` is invoked.
6
+ * Keeps `search_api` and `describe_schema` functional in environments where
7
+ * neither `isolated-vm` nor `deno` is available.
8
+ */
9
+ export class UnavailableRunner {
10
+ reason;
11
+ kind = 'unavailable';
12
+ constructor(reason) {
13
+ this.reason = reason;
14
+ }
15
+ async available() { return false; }
16
+ async execute(_opts, _rpc) {
17
+ return {
18
+ ok: false,
19
+ logs: [],
20
+ error: { name: 'SandboxUnavailable', message: this.reason },
21
+ durationMs: 0,
22
+ };
23
+ }
24
+ }
25
+ /**
26
+ * `auto` prefers isolated-vm (in-process, fastest) for single-user use (stdio, --insecure local).
27
+ * With `processIsolation` (authenticated, multi-user HTTP serving) only the Deno runner is allowed:
28
+ * user code must run in a separate, killable, permissionless process. There it never falls back
29
+ * to the in-process runner; without Deno, `execute` is unavailable and says why.
30
+ */
31
+ export async function pickSandbox(preferred, opts = {}) {
32
+ if (opts.processIsolation && preferred === 'isolate') {
33
+ throw new Error('--sandbox isolate runs user code inside the server process and is not allowed for authenticated multi-user HTTP serving. Use --sandbox deno (or auto) and install Deno.');
34
+ }
35
+ if (preferred === 'isolate') {
36
+ const r = new IsolateRunner();
37
+ if (await r.available())
38
+ return r;
39
+ return new UnavailableRunner('isolated-vm is not available on this platform (it ships prebuilt binaries for Node 24 and 26 on macOS arm64, Linux x64/arm64 and Windows x64); run with --sandbox deno instead');
40
+ }
41
+ const deno = new DenoRunner();
42
+ if (preferred === 'deno' || opts.processIsolation) {
43
+ if (await deno.available())
44
+ return deno;
45
+ return new UnavailableRunner(opts.processIsolation
46
+ ? 'Multi-user HTTP serving runs code only in the Deno sandbox, and Deno is not on PATH. Install Deno (https://deno.com). search_api and describe_schema still work.'
47
+ : 'Deno is not available on PATH; install Deno or run with --sandbox isolate');
48
+ }
49
+ const iso = new IsolateRunner();
50
+ for (const r of [iso, deno])
51
+ if (await r.available())
52
+ return r;
53
+ return new UnavailableRunner('No sandbox runner available. Use Node 24/26 on a platform with isolated-vm prebuilds, or install Deno, to use the `execute` tool. search_api and describe_schema still work.');
54
+ }
55
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAIrC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAEC,MAAM;IADnC,IAAI,GAAG,aAAsB,CAAC;IAC9B,YAA6B,MAAc;sBAAd,MAAM;IAAW,CAAC;IAC/C,KAAK,CAAC,SAAS,KAAuB,OAAO,KAAK,CAAC,CAAC,CAAC;IACrD,KAAK,CAAC,OAAO,CAAC,KAAqB,EAAE,IAAe;QAClD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;YAC3D,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAsB,EAAE,IAAI,GAAmC,EAAE;IACjG,IAAI,IAAI,CAAC,gBAAgB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,yKAAyK,CAAC,CAAC;IAC7L,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,CAAC,SAAS,EAAE;YAAE,OAAO,CAAC,CAAC;QAClC,OAAO,IAAI,iBAAiB,CAAC,gLAAgL,CAAC,CAAC;IACjN,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;IAC9B,IAAI,SAAS,KAAK,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAClD,IAAI,MAAM,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,gBAAgB;YAChD,CAAC,CAAC,kKAAkK;YACpK,CAAC,CAAC,2EAA2E,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,aAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;QAAE,IAAI,MAAM,CAAC,CAAC,SAAS,EAAE;YAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,IAAI,iBAAiB,CAAC,8KAA8K,CAAC,CAAC;AAC/M,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { ExecuteOptions, ExecuteResult, RpcBridge, SandboxRunner } from './types.js';
2
+ import { type SandboxLimits } from './limits.js';
3
+ /**
4
+ * isolated-vm sandbox: a fresh V8 isolate per execution with a heap cap. The host owns a
5
+ * wall-clock deadline that starts before setup: when it fires (or the caller aborts) the isolate
6
+ * is disposed, which stops running code and rejects anything it awaits, and the execution settles
7
+ * once. V8's own `timeout` stays as a second guard for synchronous loops. This runs in the server
8
+ * process, so for hosted multi-user execution prefer the Deno runner (separate process).
9
+ */
10
+ export declare class IsolateRunner implements SandboxRunner {
11
+ private readonly limits;
12
+ kind: 'isolate';
13
+ constructor(limits?: SandboxLimits);
14
+ available(): Promise<boolean>;
15
+ execute(opts: ExecuteOptions, rpc: RpcBridge): Promise<ExecuteResult>;
16
+ }
17
+ //# sourceMappingURL=isolate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"isolate.d.ts","sourceRoot":"","sources":["../../src/sandbox/isolate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1F,OAAO,EAAwJ,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAWvM;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,aAAa;IAGrC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,IAAI,EAAG,SAAS,CAAU;IAE1B,YAA6B,MAAM,GAAE,aAA8B,EAAI;IAEjE,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CASlC;IAEK,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAgJ1E;CACF"}
@@ -0,0 +1,195 @@
1
+ import { preflight } from './policy.js';
2
+ import { DEFAULT_LIMITS, LOG_LINE_OVERHEAD, LOG_TRUNCATED, LogSink, MAX_ERROR_MESSAGE, boundMessage, checkRpcArgs, finishValue, policyMessage, resultTooLarge } from './limits.js';
3
+ async function loadIvm() {
4
+ const mod = await import('isolated-vm');
5
+ const candidate = (typeof mod.Isolate === 'function' ? mod : mod.default ?? {});
6
+ if (typeof candidate.Isolate !== 'function')
7
+ throw new Error('isolated-vm native binding unavailable');
8
+ return candidate;
9
+ }
10
+ /**
11
+ * isolated-vm sandbox: a fresh V8 isolate per execution with a heap cap. The host owns a
12
+ * wall-clock deadline that starts before setup: when it fires (or the caller aborts) the isolate
13
+ * is disposed, which stops running code and rejects anything it awaits, and the execution settles
14
+ * once. V8's own `timeout` stays as a second guard for synchronous loops. This runs in the server
15
+ * process, so for hosted multi-user execution prefer the Deno runner (separate process).
16
+ */
17
+ export class IsolateRunner {
18
+ limits;
19
+ kind = 'isolate';
20
+ constructor(limits = DEFAULT_LIMITS) {
21
+ this.limits = limits;
22
+ }
23
+ async available() {
24
+ try {
25
+ const ivm = await loadIvm();
26
+ const iso = new ivm.Isolate({ memoryLimit: 16 });
27
+ iso.dispose();
28
+ return true;
29
+ }
30
+ catch {
31
+ return false;
32
+ }
33
+ }
34
+ async execute(opts, rpc) {
35
+ const started = Date.now();
36
+ const limits = { ...this.limits, ...(opts.limits ?? {}) };
37
+ const timeoutMs = opts.timeoutMs ?? 15_000;
38
+ const logs = new LogSink(limits.maxLogBytes, limits.maxLogLines);
39
+ const done = (r) => ({ ...r, logs: logs.lines(), durationMs: Date.now() - started });
40
+ const policy = preflight(opts.code);
41
+ if (!policy.ok)
42
+ return done({ ok: false, error: { name: 'PolicyError', message: policyMessage(policy.errors) } });
43
+ if (Buffer.byteLength(opts.code, 'utf8') > limits.maxCodeBytes) {
44
+ return done({ ok: false, error: { name: 'CodeTooLarge', message: `Code exceeds ${limits.maxCodeBytes} bytes.` } });
45
+ }
46
+ const ivm = await loadIvm();
47
+ const isolate = new ivm.Isolate({ memoryLimit: Math.max(16, opts.memoryMb ?? 64) });
48
+ let disposed = false;
49
+ const dispose = () => { if (!disposed) {
50
+ disposed = true;
51
+ try {
52
+ isolate.dispose();
53
+ }
54
+ catch { /* ignore */ }
55
+ } };
56
+ let stop;
57
+ const stopped = new Promise(resolve => { stop = resolve; });
58
+ const deadline = setTimeout(() => stop({ ok: false, error: { name: 'TimeoutError', message: `Execution exceeded ${timeoutMs}ms` } }), timeoutMs);
59
+ const onAbort = () => stop({ ok: false, error: { name: 'AbortError', message: 'Execution was cancelled.' } });
60
+ opts.signal?.addEventListener('abort', onAbort, { once: true });
61
+ if (opts.signal?.aborted)
62
+ onAbort();
63
+ const run = async () => {
64
+ const context = await isolate.createContext();
65
+ const jail = context.global;
66
+ await jail.set('global', jail.derefInto());
67
+ // Trusted primitives are captured here, before any user code runs, and every budget (logs,
68
+ // SDK arguments, result, error) is enforced with them inside the isolate, in UTF-8 bytes, so
69
+ // replacing JSON.stringify, String.prototype methods or Promise.prototype.then cannot push an
70
+ // oversized value into the host copy path. The host re-checks everything it receives.
71
+ const L = {
72
+ maxLogBytes: limits.maxLogBytes, maxLogLines: limits.maxLogLines, overhead: LOG_LINE_OVERHEAD, marker: LOG_TRUNCATED,
73
+ maxRpcArgBytes: limits.maxRpcArgBytes, maxResultBytes: limits.maxResultBytes, maxError: MAX_ERROR_MESSAGE,
74
+ };
75
+ await context.evalClosure(`const L = ${JSON.stringify(L)};
76
+ const S = JSON.stringify, Str = String, apply = Reflect.apply, then = Promise.prototype.then;
77
+ const cca = String.prototype.charCodeAt, sl = String.prototype.slice, join = Array.prototype.join, map = Array.prototype.map;
78
+ const freeze = Object.freeze, define = Object.defineProperty, isArray = Array.isArray, create = Object.create;
79
+ const bytes = (s) => { let n = 0; const len = s.length; for (let i = 0; i < len; i++) { const c = apply(cca, s, [i]);
80
+ n += c < 0x80 ? 1 : c < 0x800 ? 2 : (c >= 0xD800 && c <= 0xDBFF) ? (i++, 4) : 3; } return n; };
81
+ const cut = (s, n) => s.length > n ? apply(sl, s, [0, n]) : s;
82
+ const show = (v) => { if (typeof v === 'string') return v; try { const j = S(v); return j === undefined ? Str(v) : j; } catch { return Str(v); } };
83
+ let used = 0, lines = 0, done = false;
84
+ const log = (...a) => {
85
+ if (done) return;
86
+ let text = cut(apply(join, apply(map, a, [show]), [' ']), L.maxLogBytes);
87
+ used += bytes(text) + L.overhead; lines++;
88
+ if (used > L.maxLogBytes - L.marker.length - L.overhead || lines >= L.maxLogLines) { done = true; text = L.marker; }
89
+ $0.applyIgnored(undefined, [text]);
90
+ };
91
+ define(globalThis, 'console', { value: freeze({ log, error: log, warn: log, info: log, debug: log }), writable: false, configurable: false });
92
+ const argsJson = (args) => { const j = S(isArray(args) ? args : []); if (bytes(j) > L.maxRpcArgBytes) return undefined; return j; };
93
+ const ok = (v) => { let j; try { j = S(v === undefined ? null : v); } catch (e) { return err({ name: 'TypeError', message: 'The returned value is not JSON-serializable' }); }
94
+ if (typeof j !== 'string') j = 'null';
95
+ const b = bytes(j); return b > L.maxResultBytes ? 'R' + b : 'V' + j; };
96
+ const err = (e) => { let name = 'Error', message = '', status;
97
+ try { name = cut(Str(e && e.name || 'Error'), 100); message = cut(Str(e && e.message !== undefined ? e.message : e), L.maxError); status = e && typeof e.status === 'number' ? e.status : undefined; } catch {}
98
+ // Null-prototype record of primitives: no inherited toJSON or getters can reshape it.
99
+ const rec = create(null); rec.name = name; rec.message = message; if (typeof status === 'number') rec.status = status;
100
+ // name/message were cut before serializing, so the JSON is bounded (escaping at most 6x);
101
+ // it is never sliced, which could break it and lose the name and status.
102
+ let out; try { out = S(rec); } catch {
103
+ const fb = create(null); fb.name = 'Error'; fb.message = 'The error could not be serialized.'; if (typeof status === 'number') fb.status = status;
104
+ out = S(fb); }
105
+ return 'E' + out; };
106
+ define(globalThis, '__usptoInternal', { value: freeze({ argsJson,
107
+ run: (fn) => apply(then, fn(), [ok, err]) }), writable: false, configurable: false, enumerable: false });`, [(line) => logs.push(String(line))], { arguments: { reference: true } });
108
+ let pending = 0;
109
+ const hostRpc = async (binding, path, argsJson) => {
110
+ const fail = (name, message) => new ivm.ExternalCopy({ ok: false, error: { name, message } }).copyInto();
111
+ if (disposed)
112
+ return fail('AbortError', 'Execution has ended.');
113
+ if (pending >= limits.maxPendingRpc)
114
+ return fail('TooManyPendingCalls', `At most ${limits.maxPendingRpc} SDK calls may be pending at once.`);
115
+ if (typeof argsJson !== 'string' || Buffer.byteLength(argsJson, 'utf8') > limits.maxRpcArgBytes)
116
+ return fail('ArgumentsTooLarge', `SDK call arguments exceed ${limits.maxRpcArgBytes} bytes.`);
117
+ let args;
118
+ try {
119
+ args = JSON.parse(argsJson);
120
+ }
121
+ catch {
122
+ return fail('TypeError', 'SDK arguments must be JSON-serializable.');
123
+ }
124
+ const tooBig = checkRpcArgs(args, limits);
125
+ if (tooBig)
126
+ return fail(tooBig.name, tooBig.message);
127
+ pending++;
128
+ try {
129
+ const result = await rpc.dispatch({ binding, path, args }, { signal: opts.signal });
130
+ return new ivm.ExternalCopy(result).copyInto();
131
+ }
132
+ finally {
133
+ pending--;
134
+ }
135
+ };
136
+ // Binding names are pre-validated JS identifiers (getSources); safe to embed as JSON.
137
+ await context.evalClosure(`const internal = globalThis.__usptoInternal;
138
+ function makeProxy(binding, rpc) {
139
+ const handler = (path) => new Proxy(function(){}, {
140
+ get(_, key) { return typeof key === 'symbol' ? undefined : handler([...path, String(key)]); },
141
+ apply(_, __, args) {
142
+ let json;
143
+ try { json = internal.argsJson(args); } catch { return Promise.reject(new TypeError('SDK arguments must be JSON-serializable')); }
144
+ if (json === undefined) { const e = new Error('SDK call arguments exceed ${limits.maxRpcArgBytes} bytes.'); e.name = 'ArgumentsTooLarge'; return Promise.reject(e); }
145
+ return rpc.apply(undefined, [binding, path, json], { arguments: { copy: true }, result: { promise: true, copy: true } })
146
+ .then(r => {
147
+ if (!r.ok) { const e = new Error(r.error.message); e.name = r.error.name; if (typeof r.error.status === 'number') e.status = r.error.status; throw e; }
148
+ return r.value;
149
+ });
150
+ },
151
+ });
152
+ return handler([]);
153
+ }
154
+ for (const name of ${JSON.stringify(opts.bindings ?? [])}) {
155
+ Object.defineProperty(globalThis, name, { value: makeProxy(name, $0), writable: false, configurable: false });
156
+ }`, [hostRpc], { arguments: { reference: true } });
157
+ // 'V' + JSON (value), 'R' + bytes (result over budget, never transferred), 'E' + JSON (bounded
158
+ // error, so an SDK error's status survives the copy).
159
+ const script = await isolate.compileScript(`__usptoInternal.run(async () => { ${opts.code}\n })`);
160
+ const tagged = await script.run(context, { timeout: timeoutMs, promise: true, copy: true });
161
+ if (typeof tagged === 'string' && tagged.startsWith('V'))
162
+ return finishValue(tagged.slice(1), limits);
163
+ if (typeof tagged === 'string' && tagged.startsWith('R'))
164
+ return { ok: false, error: resultTooLarge(Number(tagged.slice(1)), limits) };
165
+ if (typeof tagged !== 'string' || !tagged.startsWith('E'))
166
+ return { ok: false, error: { name: 'SandboxProtocolError', message: 'The sandbox returned an invalid result.' } };
167
+ let e;
168
+ try {
169
+ e = JSON.parse(tagged.slice(1));
170
+ }
171
+ catch {
172
+ e = { name: 'Error', message: 'The sandbox returned an unreadable error.' };
173
+ }
174
+ return { ok: false, error: { name: String(e.name ?? 'Error').slice(0, 100), message: boundMessage(String(e.message ?? '')), ...(typeof e.status === 'number' ? { status: e.status } : {}) } };
175
+ };
176
+ try {
177
+ const outcome = await Promise.race([
178
+ run().catch((err) => {
179
+ const e = err;
180
+ if (disposed)
181
+ return { ok: false, error: { name: 'TimeoutError', message: `Execution exceeded ${timeoutMs}ms` } };
182
+ return { ok: false, error: { name: String(e?.name ?? 'Error').slice(0, 100), message: boundMessage(String(e?.message ?? err)), ...(typeof e?.status === 'number' ? { status: e.status } : {}) } };
183
+ }),
184
+ stopped,
185
+ ]);
186
+ return done(outcome);
187
+ }
188
+ finally {
189
+ clearTimeout(deadline);
190
+ opts.signal?.removeEventListener('abort', onAbort);
191
+ dispose();
192
+ }
193
+ }
194
+ }
195
+ //# sourceMappingURL=isolate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"isolate.js","sourceRoot":"","sources":["../../src/sandbox/isolate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Byte budgets for one execution. They bound what the host buffers and what reaches the model,
3
+ * independently of the V8 heap limit inside the sandbox.
4
+ */
5
+ export interface SandboxLimits {
6
+ /** Largest accepted user code. */
7
+ maxCodeBytes: number;
8
+ /** Total log size kept (text plus per-line overhead); later lines are dropped with a marker. */
9
+ maxLogBytes: number;
10
+ /** Most log lines kept, however short. */
11
+ maxLogLines: number;
12
+ /** Largest JSON-serialized return value; bigger results fail with ResultTooLarge. */
13
+ maxResultBytes: number;
14
+ /** Largest JSON-serialized argument list for one SDK call. */
15
+ maxRpcArgBytes: number;
16
+ /** SDK calls that may be awaiting a response at once. */
17
+ maxPendingRpc: number;
18
+ /** Deno only: total bytes the child may write to stdout over the execution. */
19
+ maxStdoutBytes: number;
20
+ /** Deno only: largest single frame (line) on stdout. */
21
+ maxFrameBytes: number;
22
+ }
23
+ export declare const DEFAULT_LIMITS: Readonly<SandboxLimits>;
24
+ /** Bytes charged per log line on top of its text, so empty-line floods are bounded too. */
25
+ export declare const LOG_LINE_OVERHEAD = 16;
26
+ export declare const LOG_TRUNCATED = "[logs truncated]";
27
+ /** Host-side log budget. The sandboxes enforce the same budget before sending (defense in depth). */
28
+ export declare class LogSink {
29
+ private readonly max;
30
+ private readonly maxLines;
31
+ private readonly out;
32
+ private bytes;
33
+ private dropped;
34
+ constructor(max: number, maxLines?: number);
35
+ push(line: string): void;
36
+ lines(): string[];
37
+ }
38
+ export declare function checkRpcArgs(args: unknown[], limits: SandboxLimits): {
39
+ name: string;
40
+ message: string;
41
+ } | undefined;
42
+ /** Turn the sandbox's JSON result into the execute envelope, enforcing maxResultBytes. */
43
+ export declare function finishValue(json: string, limits: SandboxLimits): {
44
+ ok: boolean;
45
+ value?: unknown;
46
+ error?: {
47
+ name: string;
48
+ message: string;
49
+ };
50
+ };
51
+ export declare function resultTooLarge(size: number, limits: SandboxLimits): {
52
+ name: string;
53
+ message: string;
54
+ };
55
+ /** Longest error message any execution reports. */
56
+ export declare const MAX_ERROR_MESSAGE = 4000;
57
+ export declare function boundMessage(message: string): string;
58
+ /** Preflight diagnostics: distinct messages only, at most 10, bounded in total. */
59
+ export declare function policyMessage(errors: string[]): string;
60
+ //# sourceMappingURL=limits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/sandbox/limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CASjD,CAAC;AAEH,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAEhD,qGAAqG;AACrG,qBAAa,OAAO;IAIN,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHnE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAS;IACxB,YAA6B,GAAG,EAAE,MAAM,EAAmB,QAAQ,SAA6B,EAAI;IACpG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcvB;IACD,KAAK,IAAI,MAAM,EAAE,CAA0B;CAC5C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOlH;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAK5I;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMrG;AAED,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAItD"}
@@ -0,0 +1,86 @@
1
+ export const DEFAULT_LIMITS = Object.freeze({
2
+ maxCodeBytes: 256 * 1024,
3
+ maxLogBytes: 64 * 1024,
4
+ maxLogLines: 1000,
5
+ maxResultBytes: 256 * 1024,
6
+ maxRpcArgBytes: 64 * 1024,
7
+ maxPendingRpc: 16,
8
+ maxStdoutBytes: 64 * 1024 * 1024,
9
+ maxFrameBytes: 16 * 1024 * 1024,
10
+ });
11
+ /** Bytes charged per log line on top of its text, so empty-line floods are bounded too. */
12
+ export const LOG_LINE_OVERHEAD = 16;
13
+ export const LOG_TRUNCATED = '[logs truncated]';
14
+ /** Host-side log budget. The sandboxes enforce the same budget before sending (defense in depth). */
15
+ export class LogSink {
16
+ max;
17
+ maxLines;
18
+ out = [];
19
+ bytes = 0;
20
+ dropped = false;
21
+ constructor(max, maxLines = DEFAULT_LIMITS.maxLogLines) {
22
+ this.max = max;
23
+ this.maxLines = maxLines;
24
+ }
25
+ push(line) {
26
+ if (this.dropped)
27
+ return;
28
+ const text = line.length > this.max ? line.slice(0, this.max) : line;
29
+ const cost = Buffer.byteLength(text, 'utf8') + LOG_LINE_OVERHEAD;
30
+ // Room for the marker is reserved up front, so the total never exceeds the budget.
31
+ const reserve = Buffer.byteLength(LOG_TRUNCATED, 'utf8') + LOG_LINE_OVERHEAD;
32
+ if (text === LOG_TRUNCATED || this.out.length >= this.maxLines - 1 || this.bytes + cost > this.max - reserve) {
33
+ this.dropped = true;
34
+ // The budget reserves room for the marker; a budget too small to hold even the marker gets none.
35
+ if (reserve <= this.max)
36
+ this.out.push(LOG_TRUNCATED);
37
+ return;
38
+ }
39
+ this.bytes += cost;
40
+ this.out.push(text);
41
+ }
42
+ lines() { return [...this.out]; }
43
+ }
44
+ export function checkRpcArgs(args, limits) {
45
+ let size;
46
+ try {
47
+ size = Buffer.byteLength(JSON.stringify(args) ?? '', 'utf8');
48
+ }
49
+ catch {
50
+ return { name: 'TypeError', message: 'SDK arguments must be JSON-serializable.' };
51
+ }
52
+ return size > limits.maxRpcArgBytes
53
+ ? { name: 'ArgumentsTooLarge', message: `SDK call arguments exceed ${limits.maxRpcArgBytes} bytes.` }
54
+ : undefined;
55
+ }
56
+ /** Turn the sandbox's JSON result into the execute envelope, enforcing maxResultBytes. */
57
+ export function finishValue(json, limits) {
58
+ const size = Buffer.byteLength(json, 'utf8');
59
+ if (size > limits.maxResultBytes)
60
+ return { ok: false, error: resultTooLarge(size, limits) };
61
+ try {
62
+ return { ok: true, value: JSON.parse(json) };
63
+ }
64
+ catch {
65
+ return { ok: false, error: { name: 'SandboxProtocolError', message: 'The sandbox returned an invalid result.' } };
66
+ }
67
+ }
68
+ export function resultTooLarge(size, limits) {
69
+ return {
70
+ name: 'ResultTooLarge',
71
+ message: `The returned value is ${size} bytes; the limit is ${limits.maxResultBytes}. Return only what you need: `
72
+ + 'request fewer records (limit), select fields (fields: [...]), map records to the attributes you need, or slice long text.',
73
+ };
74
+ }
75
+ /** Longest error message any execution reports. */
76
+ export const MAX_ERROR_MESSAGE = 4000;
77
+ export function boundMessage(message) {
78
+ return message.length > MAX_ERROR_MESSAGE ? `${message.slice(0, MAX_ERROR_MESSAGE)}… [truncated]` : message;
79
+ }
80
+ /** Preflight diagnostics: distinct messages only, at most 10, bounded in total. */
81
+ export function policyMessage(errors) {
82
+ const unique = [...new Set(errors)];
83
+ const shown = unique.slice(0, 10).join('; ');
84
+ return boundMessage(unique.length > 10 ? `${shown}; and ${unique.length - 10} more` : shown);
85
+ }
86
+ //# sourceMappingURL=limits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/sandbox/limits.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export declare const BANNED_GLOBALS: Set<string>;
2
+ export interface PolicyResult {
3
+ ok: boolean;
4
+ errors: string[];
5
+ }
6
+ export declare function preflight(code: string): PolicyResult;
7
+ //# sourceMappingURL=policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/sandbox/policy.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,aAKzB,CAAC;AAMH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAwEpD"}
@@ -0,0 +1,87 @@
1
+ import { parse } from 'acorn';
2
+ import { simple } from 'acorn-walk';
3
+ export const BANNED_GLOBALS = new Set([
4
+ 'process', 'require', 'global', 'globalThis', 'Buffer', 'Deno',
5
+ '__dirname', '__filename', 'module', 'exports', 'eval', 'Function',
6
+ 'WebAssembly', 'XMLHttpRequest', 'fetch', 'WebSocket', 'Worker',
7
+ 'SharedArrayBuffer',
8
+ ]);
9
+ const BANNED_MEMBERS = new Set([
10
+ 'constructor', '__proto__', 'prototype',
11
+ ]);
12
+ export function preflight(code) {
13
+ const errors = [];
14
+ // User code is executed inside an async wrapper, so allow top-level await/return.
15
+ // Parse the user code directly in module mode first to catch imports; then re-parse
16
+ // wrapped to validate the rest of the AST.
17
+ let directAst = null;
18
+ try {
19
+ directAst = parse(code, { ecmaVersion: 2022, sourceType: 'module', allowAwaitOutsideFunction: true });
20
+ }
21
+ catch {
22
+ // ignore — wrapper parse will be authoritative
23
+ }
24
+ if (directAst) {
25
+ simple(directAst, {
26
+ ImportDeclaration() { errors.push('imports are not allowed'); },
27
+ ImportExpression() { errors.push('dynamic import() is not allowed'); },
28
+ });
29
+ }
30
+ const wrapped = `(async () => { ${code}\n })()`;
31
+ let ast;
32
+ try {
33
+ ast = parse(wrapped, { ecmaVersion: 2022, sourceType: 'module', allowAwaitOutsideFunction: true });
34
+ }
35
+ catch (err) {
36
+ return { ok: false, errors: [...errors, `Parse error: ${err.message}`] };
37
+ }
38
+ simple(ast, {
39
+ ImportDeclaration() { errors.push('imports are not allowed'); },
40
+ ImportExpression() { errors.push('dynamic import() is not allowed'); },
41
+ CallExpression(node) {
42
+ const callee = node.callee;
43
+ if (callee?.type === 'Identifier' && (callee.name === 'eval' || callee.name === 'Function')) {
44
+ errors.push(`call to ${callee.name}() is not allowed`);
45
+ }
46
+ },
47
+ NewExpression(node) {
48
+ const callee = node.callee;
49
+ if (callee?.type === 'Identifier' && callee.name === 'Function') {
50
+ errors.push('new Function() is not allowed');
51
+ }
52
+ },
53
+ Identifier(node) {
54
+ if (BANNED_GLOBALS.has(node.name)) {
55
+ errors.push(`reference to '${node.name}' is not allowed`);
56
+ }
57
+ },
58
+ MemberExpression(node) {
59
+ // `a.constructor`, `a['constructor']` and a template literal without substitutions. A
60
+ // fully dynamic key (`a[k]`) cannot be decided statically: the runners are the boundary.
61
+ const p = node.property;
62
+ const name = !node.computed && p?.type === 'Identifier' ? p.name
63
+ : node.computed && p?.type === 'Literal' && typeof p.value === 'string' ? p.value
64
+ : node.computed && p?.type === 'TemplateLiteral' && p.expressions.length === 0 ? p.quasis[0]?.value?.cooked
65
+ : undefined;
66
+ if (name !== undefined && BANNED_MEMBERS.has(name))
67
+ errors.push(`access to .${name} is not allowed`);
68
+ },
69
+ // `const { constructor: F } = x` reads the same member without a MemberExpression.
70
+ ObjectPattern(node) {
71
+ for (const prop of node.properties) {
72
+ const key = prop.type === 'Property' ? prop.key : undefined;
73
+ const name = key?.type === 'Identifier' && !prop.computed ? key.name
74
+ : key?.type === 'Literal' && typeof key.value === 'string' ? key.value
75
+ : undefined;
76
+ if (name !== undefined && BANNED_MEMBERS.has(name))
77
+ errors.push(`access to .${name} is not allowed`);
78
+ }
79
+ },
80
+ MetaProperty(node) {
81
+ if (node.meta?.name === 'import')
82
+ errors.push('import.meta is not allowed');
83
+ },
84
+ });
85
+ return { ok: errors.length === 0, errors };
86
+ }
87
+ //# sourceMappingURL=policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/sandbox/policy.ts"],"names":[],"mappings":"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"}