@poe-platform/safe-js 0.1.307 → 0.1.309

package/dist/safe-js/chunks/{chunk-W623YLMU.js → chunk-KZ2S6QYZ.js}

@@ -27,7 +27,7 @@ import {
   validateMigrationSemantics,
   validateSnapshotData,
   validateSnapshotMigration
-} from "./chunk-V6LQP64H.js";
+} from "./chunk-A5S5VD23.js";
 
 // packages/safe-js/src/migrate.ts
 import { createHash } from "node:crypto";
@@ -8249,4 +8249,4 @@ export {
   parseMcpConfig,
   makeMcpModule
 };
-//# sourceMappingURL=chunk-W623YLMU.js.map
+//# sourceMappingURL=chunk-KZ2S6QYZ.js.map

package/dist/safe-js/cli.js

@@ -22,7 +22,7 @@ import {
   resolveFsConfig,
   splitFrontmatter,
   withBrokenPipeGuard
-} from "./chunks/chunk-W623YLMU.js";
+} from "./chunks/chunk-KZ2S6QYZ.js";
 import {
   Budget,
   SandboxError,
@@ -34,7 +34,7 @@ import {
   replaceErrorStack,
   restore,
   run
-} from "./chunks/chunk-V6LQP64H.js";
+} from "./chunks/chunk-A5S5VD23.js";
 import "./chunks/chunk-4YIDX44G.js";
 
 // packages/safe-js/src/cli.ts

package/dist/safe-js/core.js

@@ -5,7 +5,7 @@ import {
   defineExtension,
   lint,
   run
-} from "./chunks/chunk-V6LQP64H.js";
+} from "./chunks/chunk-A5S5VD23.js";
 import "./chunks/chunk-4YIDX44G.js";
 export {
   Budget,

package/dist/safe-js/index.js

@@ -26,7 +26,7 @@ import {
   runWithSpawnUsageAccumulator,
   splitFrontmatter,
   supportsSpawnMode
-} from "./chunks/chunk-W623YLMU.js";
+} from "./chunks/chunk-KZ2S6QYZ.js";
 import {
   Budget,
   FileSnapshotBackend,
@@ -50,7 +50,7 @@ import {
   registerPendingHostCallPolicy,
   restore,
   run
-} from "./chunks/chunk-V6LQP64H.js";
+} from "./chunks/chunk-A5S5VD23.js";
 import "./chunks/chunk-4YIDX44G.js";
 
 // packages/safe-js/src/parse.ts

package/dist/safe-js/snapshot/float32array.d.ts

@@ -1,3 +1,6 @@
+import type { GuestObjectState } from "./guest-heap.js";
+export declare function captureFloat32State<T>(value: Float32Array, encode: (value: unknown) => T): GuestObjectState<T>;
+export declare function restoreFloat32Properties<T>(value: Float32Array, state: GuestObjectState<T>, decode: (value: T) => unknown): void;
 export type Float32Data<TReference> = {
     kind: "float32array";
     byteOffset: number;

package/dist/safe-js/snapshot/guest-heap.d.ts

@@ -0,0 +1,114 @@
+import { type SandboxErrorName } from "../error/shape.js";
+import { type ScopeFrame } from "../interp/scope.js";
+import { type PropertyDescriptorData } from "./property-descriptors.js";
+import type { CompletionResult } from "../interp/exceptions.js";
+import type { GeneratorExpressionState } from "../interp/generator-expression-state.js";
+import { type IteratorSnapshot } from "../interp/iteration.js";
+export type GeneratorFinallyCompletion<T> = Omit<CompletionResult, "value" | "node" | "stackFrames"> & {
+    value: T;
+    nodeId?: number;
+    stackFrames?: string[];
+};
+export type GuestObjectState<T> = {
+    properties: PropertyDescriptorData<T>;
+    prototype?: T;
+};
+export type GuestHeapNode<T> = {
+    kind: "bound-function";
+    target: T;
+    thisValue: T;
+    args: T[];
+    name?: string;
+    length: T;
+    state: GuestObjectState<T>;
+} | {
+    kind: "array-iterator";
+    source: T;
+    index: number;
+    method: "keys" | "values" | "entries";
+    state: GuestObjectState<T>;
+} | {
+    kind: "guest-class";
+    astNodeId: number;
+    scope: T;
+    name?: string;
+    fields: Array<{
+        index: number;
+        key: T;
+    }>;
+    state: GuestObjectState<T>;
+} | {
+    kind: "map";
+    entries: Array<[T, T]>;
+    propertyState?: PropertyDescriptorData<T>;
+    prototype?: T;
+} | {
+    kind: "set";
+    values: T[];
+    propertyState?: PropertyDescriptorData<T>;
+    prototype?: T;
+} | {
+    kind: "raw-json";
+    text: string;
+} | {
+    kind: "guest-generator";
+    state: "start" | "running" | "suspended" | "done";
+    astNodeId: number;
+    async: boolean;
+    scope: T;
+    closureScope: T;
+    suspendedScope?: T;
+    yieldNodeId?: number;
+    blockScopes?: Record<string, T>;
+    finallyCompletions?: Record<string, GeneratorFinallyCompletion<T>>;
+    expressionStates?: Record<string, GeneratorExpressionState<T, T, IteratorSnapshot<T>>>;
+    sent: Array<{
+        type: "normal" | "return" | "throw";
+        value: T;
+    }>;
+    environment?: {
+        homeObject?: T;
+        newTarget?: T;
+    };
+    objectState?: GuestObjectState<T>;
+} | {
+    kind: "guest-object";
+    state: GuestObjectState<T>;
+    errorType?: SandboxErrorName;
+} | {
+    kind: "guest-array";
+    state: GuestObjectState<T>;
+    templateNodeId?: number;
+    templateOwner?: T;
+} | {
+    kind: "intrinsic";
+    id: string;
+    state?: GuestObjectState<T>;
+} | {
+    kind: "guest-function";
+    astNodeId: number;
+    scope: T;
+    name?: string;
+    state: GuestObjectState<T>;
+    environment?: {
+        homeObject?: T;
+        newTarget?: T;
+    };
+} | {
+    kind: "scope-frame";
+    parent: T;
+    importMeta: T;
+    functionBoundary: boolean;
+    chargeData: boolean;
+    bindings: Array<[string, number]>;
+    cells: Array<{
+        kind: ScopeFrame["cells"][number]["kind"];
+    } & ({
+        initialized: false;
+    } | {
+        initialized: true;
+        value: T;
+    })>;
+    restoredBindings?: Array<[string, T]>;
+};
+export declare function captureGuestHeapNode<T>(value: object, encode: (value: unknown) => T): GuestHeapNode<T> | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-js",
-  "version": "0.1.307",
+  "version": "0.1.309",
   "description": "Budgeted JavaScript interpreter with explicit host capabilities and resumable execution",
   "type": "module",
   "license": "MIT",
@@ -58,7 +58,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.307",
+    "@poe-platform/safe-fs": "0.1.309",
     "yaml": "^2.8.2",
     "jose": "^6.1.3",
     "@types/node": "^25.2.2"