@poe-platform/safe-js 0.1.723 → 0.1.725

package/README.md

@@ -324,6 +324,7 @@ Supply your own bounded `journal`; this does not add browser console behavior. W
 | `invokeCallback(callback, { thisValue?, args? })` | Invoke a captured guest function with the realm's state, cancellation and budgets. Same operation as on the realm. |
 | `startCallback(callback, { thisValue?, args? })` | Return separate `synchronous` and `result` promises for the same realm-owned invocation. Also available on the realm. |
 | `releaseCallback(callback)` | Revoke the callback and release its retained guest state. |
+| `retainCallbackArguments(operation)` | During setup, give each call independent callback wrappers in its copied arguments. Requires declared and granted `guest:retain`. The host owns these wrappers and releases each with `releaseCallback`; aliases within one call still share a wrapper. |
 | `retainGuestArguments(operation, from)` | During setup, opt an operation into opaque argument references starting at the zero-based index `from`. Requires declared and granted `guest:retain`. Earlier arguments keep normal conversion; live host methods preserve the declaration. |
 | `releaseGuestReference(reference)` | Revoke one reference and release its retained state. Also available on the realm. |
 | `nestedOperation(fn)` | During setup, mark a host operation authorized to run nested source. Requires declared and granted `source:nested`. |
@@ -333,6 +334,8 @@ Use `expandos: { maxKeys, maxKeyCodeUnits, assertActive? }` to allow guest assig
 
 For a timer-shaped `schedule(callback, delay, ...args)`, register `context.retainGuestArguments(schedule, 2)`. The host receives normal callback/delay values and opaque `GuestReference` handles for the remaining arguments. Pass those handles to `context.invokeCallback(callback, { args })` to recover the original guest objects and observe mutations made after scheduling. References also work as callback receivers and host return values, including cycles, closures, primitives and live host objects.
 
+Also register `context.retainCallbackArguments(schedule)` when each scheduled task owns its callback. Different calls then receive independently releasable wrappers, even for the same guest function; normal exports keep their shared callback identity. Release a timer's wrapper after cancellation or after all its invocation phases settle. Copied callbacks count against `limits.callbacks` and data budgets. Argument-copy failure or synchronous host failure revokes that call's owned wrappers; asynchronous operations must release theirs in host cleanup. Returning a wrapper to guest code preserves the original function identity and does not release it.
+
 For a trusted native buffer such as WebAssembly memory, use `context.createArrayBufferReference(buffer)` and return the handle from a host property or operation. Guest ArrayBuffer views then share its bytes with the host, preserving identity and bidirectional writes. Ordinary host buffers still copy. Shared, resizable, detached, subclassed and proxy buffers reject, as do buffers with own properties or symbols. After native memory growth detaches the old buffer, create a new reference to the new buffer; the old reference continues to denote the detached buffer.
 
 Release each reference when the host no longer needs it; returning it does not release it. Retained graphs count against data budgets and `limits.guestReferences`. Synchronous native failure releases references captured for that call; asynchronous operations must release theirs in host cleanup. Close revokes all remaining references. Handles cannot be inspected, used in another realm, or serialized into replay/error data. Unmarked operations still copy values.

package/dist/safe-js/chunks/{chunk-WF7HYDJ4.js → chunk-6OE64YMG.js}

@@ -14,7 +14,7 @@ import {
   safeRecordException,
   safeStartSpan,
   splitSourceLines
-} from "./chunk-RYVHEOHM.js";
+} from "./chunk-KOO6YGQG.js";
 
 // packages/safe-js/src/error/format.ts
 var DEFAULT_MAX_MESSAGE_LENGTH = 1e4;
@@ -2841,4 +2841,4 @@ export {
   makeLogModule,
   makeMetricModule
 };
-//# sourceMappingURL=chunk-WF7HYDJ4.js.map
+//# sourceMappingURL=chunk-6OE64YMG.js.map

package/dist/safe-js/chunks/{chunk-7TL6Z6LT.js → chunk-6YSHQ5ET.js}

@@ -5,7 +5,7 @@ import {
   accessDeniedSystemError,
   declareBudgetedHostOperation,
   declareHostOperation
-} from "./chunk-IZ52PAOD.js";
+} from "./chunk-QU2F65UQ.js";
 
 // packages/safe-js/src/modules/fs.ts
 import { constants as nodeFsConstants } from "node:fs";
@@ -721,4 +721,4 @@ export {
   FS_OPTION_SURFACE,
   makeFsModule
 };
-//# sourceMappingURL=chunk-7TL6Z6LT.js.map
+//# sourceMappingURL=chunk-6YSHQ5ET.js.map

package/dist/safe-js/chunks/{chunk-7FCMZUZJ.js → chunk-ECTNNLWN.js}

@@ -7,7 +7,7 @@ import {
   validateMigrationReconciliation,
   validateMigrationSemantics,
   validateSnapshotMigration
-} from "./chunk-Y5ZXQHL6.js";
+} from "./chunk-Y7LSEUWV.js";
 import {
   DUMP_FORMAT_VERSION,
   EXECUTION_SEMANTICS,
@@ -17,10 +17,10 @@ import {
   serializeSafeJSSnapshot,
   validateDumpEnvelope,
   validateSnapshotData
-} from "./chunk-IZ52PAOD.js";
+} from "./chunk-QU2F65UQ.js";
 import {
   parseModule
-} from "./chunk-RYVHEOHM.js";
+} from "./chunk-KOO6YGQG.js";
 
 // packages/safe-js/src/migration-file.ts
 import { randomUUID } from "node:crypto";
@@ -179,4 +179,4 @@ export {
   migrateSnapshot,
   migrateSnapshotFile
 };
-//# sourceMappingURL=chunk-7FCMZUZJ.js.map
+//# sourceMappingURL=chunk-ECTNNLWN.js.map

package/dist/safe-js/chunks/{chunk-5MT2LF3W.js → chunk-FYSWUSHN.js}

@@ -1,10 +1,10 @@
 import {
   SnapshotNotReadyError,
   serializeSafeJSSnapshot
-} from "./chunk-IZ52PAOD.js";
+} from "./chunk-QU2F65UQ.js";
 import {
   SandboxError
-} from "./chunk-RYVHEOHM.js";
+} from "./chunk-KOO6YGQG.js";
 
 // packages/safe-js/src/snapshot/dump.ts
 var RUN_DUMP_CONTROLLER = /* @__PURE__ */ Symbol("SafeJS.run-dump-controller");
@@ -195,4 +195,4 @@ export {
   dumpCurrent,
   serializeRunSnapshot
 };
-//# sourceMappingURL=chunk-5MT2LF3W.js.map
+//# sourceMappingURL=chunk-FYSWUSHN.js.map

package/dist/safe-js/chunks/{chunk-3QQYJ4RQ.js → chunk-HG5QP5UC.js}

@@ -8,7 +8,7 @@ import {
   numericTypedArrayConstructors,
   parseModule,
   tokenize
-} from "./chunk-RYVHEOHM.js";
+} from "./chunk-KOO6YGQG.js";
 
 // packages/safe-js/src/lint/rules/AS001.ts
 function AS001(source, options = {}) {
@@ -11177,4 +11177,4 @@ function hasOnlyRegexLiteralDiagnostics(diagnostics) {
 export {
   lint
 };
-//# sourceMappingURL=chunk-3QQYJ4RQ.js.map
+//# sourceMappingURL=chunk-HG5QP5UC.js.map

package/dist/safe-js/chunks/{chunk-QMZG576E.js → chunk-K6F5QLZQ.js}

@@ -6,10 +6,10 @@ import {
 import {
   declareHostOperation,
   runResources
-} from "./chunk-IZ52PAOD.js";
+} from "./chunk-QU2F65UQ.js";
 import {
   hostErrorData
-} from "./chunk-RYVHEOHM.js";
+} from "./chunk-KOO6YGQG.js";
 
 // packages/safe-js/src/modules/mcp.ts
 var DEFAULT_TOOL_BATCH_CONCURRENCY = 4;
@@ -402,4 +402,4 @@ function isPlainObjectRecord(value) {
 export {
   makeMcpModule
 };
-//# sourceMappingURL=chunk-QMZG576E.js.map
+//# sourceMappingURL=chunk-K6F5QLZQ.js.map

package/dist/safe-js/chunks/{chunk-RYVHEOHM.js → chunk-KOO6YGQG.js}

@@ -1076,6 +1076,8 @@ var CompactSourcePositions = class {
   sourceLength;
   lines = [0];
   positions = /* @__PURE__ */ new Map();
+  evictionOffsets = new Float64Array(cacheSize);
+  evictionIndex = 0;
   makeSpan;
   constructor(source) {
     this.sourceLength = source.length;
@@ -1143,8 +1145,10 @@ var CompactSourcePositions = class {
     });
     setOwner(position, this);
     if (this.positions.size === cacheSize)
-      this.positions.delete(this.positions.keys().next().value);
+      this.positions.delete(this.evictionOffsets[this.evictionIndex]);
     this.positions.set(offset, position);
+    this.evictionOffsets[this.evictionIndex] = offset;
+    this.evictionIndex = (this.evictionIndex + 1) % cacheSize;
     return position;
   }
   span(start, end) {
@@ -1158,6 +1162,18 @@ var CompactSourcePositions = class {
     const point = this.position(position.offset);
     return point.line === position.line && point.column === position.column ? point : void 0;
   }
+  /** Packing validates coordinates without materializing or interning a point. */
+  matchesPosition(position) {
+    if (!Number.isSafeInteger(position.offset) || position.offset < 0 || position.offset > this.sourceLength)
+      return false;
+    const offset = position.offset;
+    this.assertOffset(offset);
+    const line = position.line;
+    if (!Number.isSafeInteger(line) || line < 1 || line > this.lines.length) return false;
+    const start = this.lines[line - 1];
+    if (offset < start || line < this.lines.length && offset >= this.lines[line]) return false;
+    return offset - start + 1 === position.column;
+  }
   assertOffset(offset) {
     if (!Number.isSafeInteger(offset) || offset < 0 || offset > this.sourceLength)
       throw new RangeError("Source coordinate offset is outside its source.");
@@ -1287,9 +1303,9 @@ var CompactModuleAst = class {
         this.write(row + 1, value.length);
       } else if (keys.length === 2 && keys[0] === "start" && keys[1] === "end") {
         const span = value, start = span.start, end = span.end;
-        const startPoint = this.positions.compatiblePosition(start);
-        const endPoint = this.positions.compatiblePosition(end);
-        if (startPoint && endPoint) {
+        const startMatches = this.positions.matchesPosition(start);
+        const endMatches = this.positions.matchesPosition(end);
+        if (startMatches && endMatches) {
           kind = 1;
           row = this.reserve(3);
           this.write(row, kind);
@@ -8645,4 +8661,4 @@ export {
   Float16Array2 as Float16Array,
   numericTypedArrayConstructors
 };
-//# sourceMappingURL=chunk-RYVHEOHM.js.map
+//# sourceMappingURL=chunk-KOO6YGQG.js.map