@poe-platform/safe-js 0.1.805 → 0.1.807

package/dist/safe-js/chunks/{chunk-ECMGBHAB.js → chunk-XQOJJA4C.js}

@@ -13,7 +13,7 @@ import {
 import {
   AsyncLocalStorage,
   hostCwd
-} from "./chunk-VVOPJZRG.js";
+} from "./chunk-H25SH6HQ.js";
 
 // packages/safe-js/src/error/format.ts
 var DEFAULT_MAX_MESSAGE_LENGTH = Infinity;
@@ -1684,7 +1684,7 @@ function makeAgentModule(spawnAgent, moduleOptions = {}) {
     const input = resolveSpawnInput(agentDef, options);
     const spawnId = nextSpawnId;
     nextSpawnId += 1;
-    recordActiveSpawnStart();
+    activeUsageAccumulator.getStore()?.beginSpawn?.();
     return runObservedSpawn(moduleOptions.otelSink, input, async () => {
       return defaultRetry === void 0 ? runSpawnAttempt(spawnAgent, input, moduleOptions.onEvent, spawnId) : runSpawnRetry(spawnAgent, input, defaultRetry, moduleOptions.onEvent, spawnId);
     });
@@ -1696,7 +1696,7 @@ function makeAgentModule(spawnAgent, moduleOptions = {}) {
         const normalizedRetry = normalizeRetryOptions(retryOptions);
         const spawnId = nextSpawnId;
         nextSpawnId += 1;
-        recordActiveSpawnStart();
+        activeUsageAccumulator.getStore()?.beginSpawn?.();
         return await runObservedSpawn(
           moduleOptions.otelSink,
           input,
@@ -1718,7 +1718,7 @@ function makeAgentModule(spawnAgent, moduleOptions = {}) {
             const input = resolveSpawnInput(agentDef, spawnOptions);
             const spawnId = nextSpawnId;
             nextSpawnId += 1;
-            recordActiveSpawnStart();
+            activeUsageAccumulator.getStore()?.beginSpawn?.();
             return runObservedSpawn(
               moduleOptions.otelSink,
               input,
@@ -1751,6 +1751,7 @@ function makeAgentModule(spawnAgent, moduleOptions = {}) {
   };
 }
 async function runSpawnAttempt(spawnAgent, input, onEvent, spawnId) {
+  const accumulator = activeUsageAccumulator.getStore();
   const task = resolveTaskLabel(input);
   const startedAt = Date.now();
   try {
@@ -1768,10 +1769,10 @@ async function runSpawnAttempt(spawnAgent, input, onEvent, spawnId) {
     maxAttempts: 1
   });
   try {
-    recordActiveSpawnAttempt();
+    accumulator?.beginAttempt?.();
     const result = validateSpawnResult(await spawnAgent(toProviderSpawnInput(input)));
     throwIfAborted2(input.signal);
-    recordActiveSpawnUsage(result.usage);
+    accumulator?.record(result.usage);
     if (result.exitCode !== 0) {
       const error = new AgentSpawnError(result);
       if (input.check) {
@@ -1858,6 +1859,7 @@ function readCurrentWorkingDirectory() {
   }
 }
 async function runSpawnRetry(spawnAgent, input, retryOptions, onEvent, spawnId) {
+  const accumulator = activeUsageAccumulator.getStore();
   const task = resolveTaskLabel(input);
   const startedAt = Date.now();
   for (let attempt = 1; attempt <= retryOptions.maxAttempts; attempt += 1) {
@@ -1886,7 +1888,7 @@ async function runSpawnRetry(spawnAgent, input, retryOptions, onEvent, spawnId)
     });
     let result;
     try {
-      recordActiveSpawnAttempt();
+      accumulator?.beginAttempt?.();
       result = validateSpawnResult(await spawnAgent(toProviderSpawnInput(input)));
       throwIfAborted2(input.signal);
     } catch (error2) {
@@ -1974,7 +1976,7 @@ async function runSpawnRetry(spawnAgent, input, retryOptions, onEvent, spawnId)
       }
       continue;
     }
-    recordActiveSpawnUsage(result.usage);
+    accumulator?.record(result.usage);
     if (result.exitCode === 0) {
       emitSpawnEvent(onEvent, {
         type: "spawn.succeeded",
@@ -2342,15 +2344,6 @@ function validateSpawnResult(result) {
     ...usage === void 0 ? {} : { usage: readSpawnUsage(usage) }
   });
 }
-function recordActiveSpawnUsage(usage) {
-  activeUsageAccumulator.getStore()?.record(usage);
-}
-function recordActiveSpawnAttempt() {
-  activeUsageAccumulator.getStore()?.beginAttempt?.();
-}
-function recordActiveSpawnStart() {
-  activeUsageAccumulator.getStore()?.beginSpawn?.();
-}
 function readSpawnUsage(value) {
   if (!isRecord2(value)) {
     throw new Error("spawnAgent result usage must be an object.");
@@ -2519,51 +2512,6 @@ function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-// packages/safe-js/src/modules/fs-config.ts
-import {
-  createFileSystem,
-  createNodeFileSystemAdapterRegistry,
-  readConfigRecord,
-  validateFileSystemConfig
-} from "@poe-platform/safe-fs";
-function validateFsConfig(value) {
-  const config = readConfigRecord(value, "fs config", ["adapter", "root", "cwd", "readFileMaxBytes", "hostReadMemoryLimit", "maxSymlinkFollows"]);
-  const paths = {};
-  for (const key of ["root", "cwd"]) {
-    const path = config[key];
-    if (path === void 0) continue;
-    if (typeof path !== "string" || !path.startsWith("/") || path.includes("\0")) {
-      throw new TypeError(`${key} must be an absolute virtual path`);
-    }
-    paths[key] = path;
-  }
-  const limits = {};
-  for (const key of ["readFileMaxBytes", "hostReadMemoryLimit", "maxSymlinkFollows"]) {
-    const value2 = config[key];
-    if (value2 === void 0) continue;
-    if (value2 !== Infinity && (typeof value2 !== "number" || !Number.isSafeInteger(value2) || value2 < 0))
-      throw new TypeError(`${key} must be a non-negative safe integer or Infinity`);
-    Object.assign(limits, { [key]: value2 });
-  }
-  return {
-    adapter: validateFileSystemConfig(config.adapter),
-    ...paths,
-    ...limits
-  };
-}
-function parseFsConfig(json) {
-  return validateFsConfig(JSON.parse(json));
-}
-async function resolveFsConfig(config, options = {}) {
-  const { adapter: adapterConfig, ...paths } = validateFsConfig(config);
-  const resolution = readConfigRecord(options, "fs resolution option", ["registry"]);
-  const registry = createNodeFileSystemAdapterRegistry(
-    resolution.registry
-  );
-  const adapter = await createFileSystem(adapterConfig, { registry });
-  return { adapter, ...paths };
-}
-
 export {
   formatInterpreterError,
   SPAWN_MODES,
@@ -2575,7 +2523,5 @@ export {
   AgentSpawnError,
   createSpawnUsageAccumulator,
   runWithSpawnUsageAccumulator,
-  makeAgentModule,
-  parseFsConfig,
-  resolveFsConfig
+  makeAgentModule
 };

package/dist/safe-js/chunks/{cli-runtime-6EBUM6AL.js → cli-runtime-EV4DQ7UW.js}

@@ -4,21 +4,21 @@ import {
   formatInterpreterError,
   makeAgentModule,
   maskSource,
-  parseFsConfig,
-  resolveFsConfig,
   splitFrontmatter
-} from "./chunk-ECMGBHAB.js";
+} from "./chunk-XQOJJA4C.js";
 import {
   parseMcpConfig
-} from "./chunk-HFCSCNZN.js";
+} from "./chunk-E7V44LSN.js";
 import {
   lint,
   makeEnvModule,
   makeFailModule,
   makeLogModule,
   makeMetricModule,
-  parseEnvConfig
-} from "./chunk-RPGCF4KE.js";
+  parseEnvConfig,
+  parseFsConfig,
+  resolveFsConfig
+} from "./chunk-TG7TRXYG.js";
 import {
   createBrokenPipeState,
   createSafeOutputStream,
@@ -26,7 +26,7 @@ import {
 } from "./chunk-X3YCE3ZH.js";
 import {
   createRootedSourceResolver
-} from "./chunk-JQ5QJV5Q.js";
+} from "./chunk-P5Y4UF4L.js";
 import "./chunk-DHGJSEFX.js";
 import {
   fsCodec
@@ -45,11 +45,11 @@ import {
   dirname,
   extname,
   paths_default
-} from "./chunk-KMBCLXER.js";
+} from "./chunk-2IYZK337.js";
 import {
   formatWithOptions,
   hostFs
-} from "./chunk-VVOPJZRG.js";
+} from "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 
 // packages/safe-js/src/cli-runtime.ts
@@ -72,7 +72,7 @@ async function runCli(argv, options, usage) {
     async () => {
       try {
         if (argv[0] === "migrate") {
-          const { migrateSnapshotFile } = await import("./migration-file-BJVZMCID.js");
+          const { migrateSnapshotFile } = await import("./migration-file-6LFFQLZN.js");
           const result = await migrateSnapshotFile({
             ...parseMigrationArgs(argv.slice(1)),
             cwd: options.cwd ?? readCurrentWorkingDirectory(),
@@ -291,12 +291,12 @@ async function assertHarnessFile(input) {
 }
 async function runScriptFile(filepath, parsed, options) {
   const [{ run }, { restore }, { dump, dumpCurrent }, { createLintModulesFromRuntimeRegistry }, { makeFsModule }, { makeMcpModule }] = await Promise.all([
-    import("./run-STNASYDW.js"),
-    import("./restore-GU6CISV6.js"),
-    import("./dump-S6HOPYA6.js"),
-    import("./runtime-modules-5MQCTIB5.js"),
+    import("./run-PWX3SVTF.js"),
+    import("./restore-BFVCW6H4.js"),
+    import("./dump-OX7M4C56.js"),
+    import("./runtime-modules-UOVJSSD7.js"),
     import("../modules/fs.js"),
-    import("./mcp-MILSUBPS.js")
+    import("./mcp-DSJET2K4.js")
   ]);
   const loaded = loadExecutableSource(filepath, await options.readFile(filepath, "utf8"));
   const meta = {
@@ -534,7 +534,7 @@ async function createRuntime(frontmatter, meta, options) {
     };
   }
   const [{ makeHarnessModule }, { makeFsModule }] = await Promise.all([
-    import("./harness-GQGDTZ5P.js"),
+    import("./harness-4BETCNJY.js"),
     import("../modules/fs.js")
   ]);
   const state = {

package/dist/safe-js/chunks/{dump-S6HOPYA6.js → dump-OX7M4C56.js}

@@ -4,10 +4,10 @@ import {
   dump,
   dumpCurrent,
   serializeRunSnapshot
-} from "./chunk-WNCT5WTP.js";
-import "./chunk-JVE54EBX.js";
+} from "./chunk-3W4JJFK6.js";
+import "./chunk-ROIZEQTS.js";
 import "./chunk-EQUBWQJN.js";
-import "./chunk-VVOPJZRG.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   attachDumpController,

package/dist/safe-js/chunks/{harness-GQGDTZ5P.js → harness-4BETCNJY.js}

@@ -1,9 +1,9 @@
 import {
   makeHarnessModule
-} from "./chunk-NOS76GMS.js";
-import "./chunk-JVE54EBX.js";
+} from "./chunk-5ZVTZBH2.js";
+import "./chunk-ROIZEQTS.js";
 import "./chunk-EQUBWQJN.js";
-import "./chunk-VVOPJZRG.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   makeHarnessModule

package/dist/safe-js/chunks/mcp-DSJET2K4.js

@@ -0,0 +1,12 @@
+import {
+  makeMcpModule
+} from "./chunk-7RGEML7S.js";
+import "./chunk-E7V44LSN.js";
+import "./chunk-ROIZEQTS.js";
+import "./chunk-EQUBWQJN.js";
+import "./chunk-2IYZK337.js";
+import "./chunk-H25SH6HQ.js";
+import "./chunk-CQ52GEHY.js";
+export {
+  makeMcpModule
+};

package/dist/safe-js/chunks/{migration-file-BJVZMCID.js → migration-file-6LFFQLZN.js}

@@ -1,13 +1,13 @@
 import {
   migrateSnapshotFile
-} from "./chunk-IRCZI6HL.js";
+} from "./chunk-SV37HEM5.js";
 import "./chunk-DIG26TEI.js";
 import "./chunk-ONWFPHUI.js";
-import "./chunk-AN6Z3R6M.js";
-import "./chunk-JVE54EBX.js";
+import "./chunk-MJH5AYEK.js";
+import "./chunk-ROIZEQTS.js";
 import "./chunk-EQUBWQJN.js";
-import "./chunk-KMBCLXER.js";
-import "./chunk-VVOPJZRG.js";
+import "./chunk-2IYZK337.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   migrateSnapshotFile

package/dist/safe-js/chunks/{restore-GU6CISV6.js → restore-BFVCW6H4.js}

@@ -1,11 +1,11 @@
 import {
   SnapshotMismatchError,
   restore
-} from "./chunk-HR3HSM26.js";
-import "./chunk-AN6Z3R6M.js";
-import "./chunk-JVE54EBX.js";
+} from "./chunk-SAYUBVHD.js";
+import "./chunk-MJH5AYEK.js";
+import "./chunk-ROIZEQTS.js";
 import "./chunk-EQUBWQJN.js";
-import "./chunk-VVOPJZRG.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   SnapshotMismatchError,

package/dist/safe-js/chunks/{run-STNASYDW.js → run-PWX3SVTF.js}

@@ -1,17 +1,17 @@
 import {
   UnhandledRejectionError,
   run
-} from "./chunk-2LI4AP6C.js";
+} from "./chunk-5FPEN6AM.js";
 import "./chunk-DHGJSEFX.js";
 import "./chunk-DIG26TEI.js";
 import "./chunk-ONWFPHUI.js";
-import "./chunk-HR3HSM26.js";
-import "./chunk-AN6Z3R6M.js";
-import "./chunk-WNCT5WTP.js";
-import "./chunk-JVE54EBX.js";
+import "./chunk-SAYUBVHD.js";
+import "./chunk-MJH5AYEK.js";
+import "./chunk-3W4JJFK6.js";
+import "./chunk-ROIZEQTS.js";
 import "./chunk-EQUBWQJN.js";
-import "./chunk-KMBCLXER.js";
-import "./chunk-VVOPJZRG.js";
+import "./chunk-2IYZK337.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   UnhandledRejectionError,

package/dist/safe-js/chunks/{runtime-modules-5MQCTIB5.js → runtime-modules-UOVJSSD7.js}

@@ -1,9 +1,9 @@
 import {
   createLintModulesFromRuntimeRegistry
-} from "./chunk-GJPD4ALZ.js";
-import "./chunk-JVE54EBX.js";
+} from "./chunk-425IYA26.js";
+import "./chunk-ROIZEQTS.js";
 import "./chunk-EQUBWQJN.js";
-import "./chunk-VVOPJZRG.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   createLintModulesFromRuntimeRegistry

package/dist/safe-js/chunks/{source-files-A2WSOO6G.js → source-files-QT24SQTE.js}

@@ -1,8 +1,8 @@
 import {
   createRootedSourceResolver
-} from "./chunk-JQ5QJV5Q.js";
-import "./chunk-KMBCLXER.js";
-import "./chunk-VVOPJZRG.js";
+} from "./chunk-P5Y4UF4L.js";
+import "./chunk-2IYZK337.js";
+import "./chunk-H25SH6HQ.js";
 import "./chunk-CQ52GEHY.js";
 export {
   createRootedSourceResolver

package/dist/safe-js/cli.js

@@ -13,7 +13,7 @@ import { createHostFileSystem } from "@poe-platform/safe-fs/node";
 import { fileURLToPath } from "node:url";
 async function runCli(argv, options = {}) {
   if (!argv.includes("--help") && !argv.includes("-h")) {
-    const runtime = await import("./chunks/cli-runtime-6EBUM6AL.js");
+    const runtime = await import("./chunks/cli-runtime-EV4DQ7UW.js");
     return runtime.runCli(argv, options, createUsage());
   }
   const brokenPipe = createBrokenPipeState();
@@ -32,7 +32,7 @@ async function runCli(argv, options = {}) {
         stderr.write(`${error instanceof Error ? error.message : String(error)}
 `);
         if (brokenPipe.closed) return 0;
-        const { exitCodeForError } = await import("./chunks/cli-runtime-6EBUM6AL.js");
+        const { exitCodeForError } = await import("./chunks/cli-runtime-EV4DQ7UW.js");
         return exitCodeForError(error);
       }
     }

package/dist/safe-js/core.d.ts

@@ -12,6 +12,7 @@ export declare const deepCopyFromSandbox: {
     (value: SandboxValue, options?: PublicCopyOptions): unknown;
 };
 export { admitNativePromiseProperties } from "./interp/native-promise-properties.js";
+export { captureHostContext } from "./host-context.js";
 export { lint, type Diagnostic, type Fix, type LintFixResult, type LintOptions } from "./lint.js";
 export { run } from "./run.js";
 export type { RunPromise } from "./run.js";
@@ -37,3 +38,5 @@ export { deepCopyToSandbox } from "./interp/values.js";
 export { SandboxError } from "./interp/budget.js";
 export { SnapshotValidationError } from "./snapshot/validation.js";
 export { declareHostOperation } from "./interp/host-bridge.js";
+export { parseFsConfig, resolveFsConfig } from "./modules/fs-config.js";
+export type { FsConfig, ResolveFsConfigOptions } from "./modules/fs-config.js";

package/dist/safe-js/core.js

@@ -1,14 +1,15 @@
 import {
+  captureHostContext,
   deepCopyFromSandbox,
   makeTimeModule,
   parse,
   parseModule,
   parseSourceModule,
   restore
-} from "./chunks/chunk-VQKUOXQ2.js";
+} from "./chunks/chunk-BEA7FA5M.js";
 import {
   makeHarnessModule
-} from "./chunks/chunk-NOS76GMS.js";
+} from "./chunks/chunk-5ZVTZBH2.js";
 import {
   EnvAccessError,
   HarnessFailure,
@@ -17,42 +18,44 @@ import {
   makeFailModule,
   makeLogModule,
   makeMetricModule,
-  parseEnvConfig
-} from "./chunks/chunk-RPGCF4KE.js";
+  parseEnvConfig,
+  parseFsConfig,
+  resolveFsConfig
+} from "./chunks/chunk-TG7TRXYG.js";
 import "./chunks/chunk-X3YCE3ZH.js";
 import {
   FS_OPTION_SURFACE,
   makeFsModule
-} from "./chunks/chunk-WZ27FAD3.js";
+} from "./chunks/chunk-C5NG3LHQ.js";
 import {
   createRootedSourceResolver
-} from "./chunks/chunk-JQ5QJV5Q.js";
+} from "./chunks/chunk-P5Y4UF4L.js";
 import {
   createRealm,
   createReplayableRandom,
   run
-} from "./chunks/chunk-2LI4AP6C.js";
+} from "./chunks/chunk-5FPEN6AM.js";
 import "./chunks/chunk-DHGJSEFX.js";
 import "./chunks/chunk-DIG26TEI.js";
 import "./chunks/chunk-ONWFPHUI.js";
-import "./chunks/chunk-HR3HSM26.js";
-import "./chunks/chunk-AN6Z3R6M.js";
+import "./chunks/chunk-SAYUBVHD.js";
+import "./chunks/chunk-MJH5AYEK.js";
 import {
   dump
-} from "./chunks/chunk-WNCT5WTP.js";
+} from "./chunks/chunk-3W4JJFK6.js";
 import {
   SnapshotValidationError,
   admitNativePromiseProperties,
   declareHostOperation,
   deepCopyToSandbox,
   defineExtension
-} from "./chunks/chunk-JVE54EBX.js";
+} from "./chunks/chunk-ROIZEQTS.js";
 import {
   Budget,
   SandboxError
 } from "./chunks/chunk-EQUBWQJN.js";
-import "./chunks/chunk-KMBCLXER.js";
-import "./chunks/chunk-VVOPJZRG.js";
+import "./chunks/chunk-2IYZK337.js";
+import "./chunks/chunk-H25SH6HQ.js";
 import "./chunks/chunk-CQ52GEHY.js";
 export {
   Budget,
@@ -62,6 +65,7 @@ export {
   SandboxError,
   SnapshotValidationError,
   admitNativePromiseProperties,
+  captureHostContext,
   createRealm,
   createReplayableRandom,
   createRootedSourceResolver,
@@ -80,8 +84,10 @@ export {
   makeTimeModule,
   parse,
   parseEnvConfig,
+  parseFsConfig,
   parseModule,
   parseSourceModule,
+  resolveFsConfig,
   restore,
   run
 };

package/dist/safe-js/host-context.d.ts

@@ -0,0 +1,5 @@
+/** Capture the current host scope before awaiting or scheduling a callback.
+ * The returned function restores that scope for one synchronous continuation.
+ * Call it again around later continuations; it does not change native await.
+ */
+export declare const captureHostContext: () => <Result>(callback: () => Result) => Result;

package/dist/safe-js/index.d.ts

@@ -1,4 +1,5 @@
 export { admitNativePromiseProperties } from "./interp/native-promise-properties.js";
+export { captureHostContext } from "./host-context.js";
 export { parse, parseModule, parseSourceModule, restore, deepCopyFromSandbox } from "./core.js";
 export type { ParsedSourceModule, SourceImport, SourceExport } from "./parse/module-syntax.js";
 export { lint, type Diagnostic, type Fix, type LintFixResult, type LintOptions } from "./lint.js";

package/dist/safe-js/index.js

@@ -2,13 +2,13 @@ import {
   inspectSnapshotMigration,
   migrateSnapshot,
   migrateSnapshotFile
-} from "./chunks/chunk-IRCZI6HL.js";
+} from "./chunks/chunk-SV37HEM5.js";
 import {
   createLintModulesFromRuntimeRegistry
-} from "./chunks/chunk-GJPD4ALZ.js";
+} from "./chunks/chunk-425IYA26.js";
 import {
   makeMcpModule
-} from "./chunks/chunk-N3EL5B4L.js";
+} from "./chunks/chunk-7RGEML7S.js";
 import {
   AgentSpawnError,
   SPAWN_MODES,
@@ -18,26 +18,25 @@ import {
   formatInterpreterError,
   makeAgentModule,
   maskSource,
-  parseFsConfig,
-  resolveFsConfig,
   runWithSpawnUsageAccumulator,
   splitFrontmatter,
   supportsSpawnMode
-} from "./chunks/chunk-ECMGBHAB.js";
+} from "./chunks/chunk-XQOJJA4C.js";
 import {
   parseMcpConfig
-} from "./chunks/chunk-HFCSCNZN.js";
+} from "./chunks/chunk-E7V44LSN.js";
 import {
+  captureHostContext,
   deepCopyFromSandbox,
   makeTimeModule,
   parse,
   parseModule as parseModule2,
   parseSourceModule,
   restore
-} from "./chunks/chunk-VQKUOXQ2.js";
+} from "./chunks/chunk-BEA7FA5M.js";
 import {
   makeHarnessModule
-} from "./chunks/chunk-NOS76GMS.js";
+} from "./chunks/chunk-5ZVTZBH2.js";
 import {
   EnvAccessError,
   lint,
@@ -45,21 +44,23 @@ import {
   makeFailModule,
   makeLogModule,
   makeMetricModule,
-  parseEnvConfig
-} from "./chunks/chunk-RPGCF4KE.js";
+  parseEnvConfig,
+  parseFsConfig,
+  resolveFsConfig
+} from "./chunks/chunk-TG7TRXYG.js";
 import "./chunks/chunk-X3YCE3ZH.js";
 import {
   makeFsModule
-} from "./chunks/chunk-WZ27FAD3.js";
+} from "./chunks/chunk-C5NG3LHQ.js";
 import {
   createRootedSourceResolver
-} from "./chunks/chunk-JQ5QJV5Q.js";
+} from "./chunks/chunk-P5Y4UF4L.js";
 import {
   FileSnapshotBackend,
   createRealm,
   createReplayableRandom,
   run
-} from "./chunks/chunk-2LI4AP6C.js";
+} from "./chunks/chunk-5FPEN6AM.js";
 import "./chunks/chunk-DHGJSEFX.js";
 import {
   fsCodec
@@ -67,11 +68,11 @@ import {
 import {
   hasOwnErrorCode
 } from "./chunks/chunk-ONWFPHUI.js";
-import "./chunks/chunk-HR3HSM26.js";
-import "./chunks/chunk-AN6Z3R6M.js";
+import "./chunks/chunk-SAYUBVHD.js";
+import "./chunks/chunk-MJH5AYEK.js";
 import {
   dump
-} from "./chunks/chunk-WNCT5WTP.js";
+} from "./chunks/chunk-3W4JJFK6.js";
 import {
   HostCallResumabilityError,
   HostOperationResumePolicyError,
@@ -81,7 +82,7 @@ import {
   deepCopyToSandbox,
   defineExtension,
   registerPendingHostCallPolicy
-} from "./chunks/chunk-JVE54EBX.js";
+} from "./chunks/chunk-ROIZEQTS.js";
 import {
   Budget,
   SandboxError,
@@ -90,10 +91,10 @@ import {
 } from "./chunks/chunk-EQUBWQJN.js";
 import {
   extname
-} from "./chunks/chunk-KMBCLXER.js";
+} from "./chunks/chunk-2IYZK337.js";
 import {
   hostFs
-} from "./chunks/chunk-VVOPJZRG.js";
+} from "./chunks/chunk-H25SH6HQ.js";
 import "./chunks/chunk-CQ52GEHY.js";
 
 // packages/safe-js/src/runner/run-harness.ts
@@ -378,6 +379,7 @@ export {
   SandboxError,
   SnapshotValidationError,
   admitNativePromiseProperties,
+  captureHostContext,
   createRealm,
   createReplayableRandom,
   createRootedSourceResolver,

package/dist/safe-js/interp/host-bridge.d.ts

@@ -1,3 +1,4 @@
+import { type RunResources } from "./resources.js";
 import { type Budget, type CompileOwner } from "./budget.js";
 import { type PendingHostCallPolicyMode } from "../snapshot/policy.js";
 import { type HostCallJournal, type HostCallOutcome } from "./host-call.js";
@@ -20,6 +21,7 @@ export type RealmBridge = {
     };
 };
 export type HostBridgeOptions = {
+    resources?: RunResources;
     realm?: RealmBridge;
     registerCapabilities?: boolean;
     capabilityPath?: readonly string[];

package/dist/safe-js/interp/resources.d.ts

@@ -0,0 +1,23 @@
+import { AsyncLocalStorage } from "#safe-js-platform";
+import type { Budget } from "./budget.js";
+export type RunResources = {
+    signal: AbortSignal;
+    functionSourceText?: boolean;
+    hostDataMetadata?: boolean;
+    nativeDataResults?: boolean;
+    sourceLocation?: (position: {
+        line: number;
+        column: number;
+    }) => {
+        filename: string;
+        line: number;
+        column: number;
+    } | undefined;
+    canBlock?: boolean;
+    referenceReleases: Set<() => void>;
+    reportError?: (reason: unknown) => void;
+    add(close: () => Promise<void>): void | (() => void);
+};
+export declare const runResources: AsyncLocalStorage<RunResources>;
+export declare function retainValues(budget: Budget, values: () => Iterable<unknown>): () => void;
+export declare function withRunResources<Result>(signal: AbortSignal | undefined, execute: () => Promise<Result>): Promise<Result>;