@adapt-toolkit/sdk 0.6.0 → 0.6.2

package/dist/wasm/wasm_types.d.ts

@@ -0,0 +1,97 @@
+export declare class IteratorString {
+    value(): string;
+    next(): void;
+    more(): boolean;
+}
+export declare class IteratorAdaptValue {
+    value(): AdaptValue;
+    next(): void;
+    more(): boolean;
+}
+export declare class Binary {
+    constructor(data: {
+        ptr: number;
+    }, size: number);
+    Size(): number;
+    Get(): {
+        ptr: number;
+    };
+    Destroy(): void;
+}
+export declare class AdaptEvaluationUnit {
+    static LoadFromFile(fileName: string): AdaptEvaluationUnit;
+    static LoadFromContents(bin: Binary): AdaptEvaluationUnit;
+    Destroy(): void;
+    Clone(): AdaptEvaluationUnit;
+}
+export declare class AdaptValue {
+    static FromString(from: string): AdaptValue;
+    static FromNumber(from: number): AdaptValue;
+    static FromBoolean(from: boolean): AdaptValue;
+    static NilObject(): AdaptValue;
+    Visualize(): string;
+    Serialize(): Binary;
+    GetHash(): AdaptValue;
+    Reduce(reducer: AdaptValue): AdaptValue;
+    Mutate(reducer: AdaptValue, product: AdaptValue): AdaptValue;
+    GetPacket(): AdaptPacketContext;
+    Destroy(): void;
+    Check(): void;
+    GetNumber(): number;
+    GetBoolean(): boolean;
+    GetBinary(): Binary;
+    IsNil(): boolean;
+    Equals(rhs: AdaptValue): boolean;
+    Less(rhs: AdaptValue): boolean;
+    Clone(): AdaptValue;
+    GetKeys(): IteratorAdaptValue;
+}
+export declare class AdaptPacketContext {
+    static LoadFromFile(path: string): AdaptPacketContext;
+    static LoadFromContents(contents: Binary): AdaptPacketContext;
+    ParseValue(source: AdaptValue): AdaptValue;
+    ParseValueFromJSON(value: string): AdaptValue;
+    CreateDictionary(): AdaptValue;
+    NewBinaryFromHex(hex: string): AdaptValue;
+    NewBinaryFromBuffer(bin: Binary): AdaptValue;
+    ExecuteTransaction(transaction: AdaptValue, entropy: string, timestamp: AdaptValue): AdaptValue;
+    GetFunction(name: string): AdaptFunctionInvocation;
+    GetHash(): AdaptValue;
+    GetContainerID(): AdaptValue;
+    GetCodeID(): AdaptValue;
+    Serialize(): Binary;
+    Destroy(): void;
+    Check(): void;
+    Clone(): AdaptPacketContext;
+    TransactionsList(): IteratorString;
+    NilObject(): AdaptValue;
+}
+export declare class AdaptFunctionInvocation {
+    Reset(): void;
+    PushParameter(v: AdaptValue): void;
+    Execute(): AdaptValue;
+    Destroy(): void;
+    Check(): void;
+}
+export declare class AdaptEnvironment {
+    constructor();
+    getStderrContents(): string;
+    getStdoutContents(): string;
+    Initialize(test_mode: boolean): void;
+    EmptyPacket(secure: boolean): AdaptPacketContext;
+    CreatePacket(unit: AdaptEvaluationUnit, seed_phrase: string, entropy: string, timestamp: AdaptValue, secure: boolean, init_arg?: AdaptValue): AdaptPacketContext;
+    GetRandomBytes(length: number): AdaptValue;
+    SetClientDepthLimit(limit: number): void;
+    SystemTime(): AdaptValue;
+    ParseTime(timestamp: string): AdaptValue;
+    hasError(): boolean;
+    getError(): string;
+    clearError(): void;
+    countObjectsOutstanding(): number;
+    get AdaptEvaluationUnit(): typeof AdaptEvaluationUnit;
+    get AdaptValue(): typeof AdaptValue;
+    get AdaptPacketContext(): typeof AdaptPacketContext;
+    get AdaptFunctionInvocation(): typeof AdaptFunctionInvocation;
+}
+export declare type AdaptWasmObject = AdaptEvaluationUnit | AdaptValue | AdaptPacketContext | AdaptFunctionInvocation | Binary;
+//# sourceMappingURL=wasm_types.d.ts.map

package/dist/wasm/wasm_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm_types.d.ts","sourceRoot":"","sources":["../../src/wasm/wasm_types.ts"],"names":[],"mappings":"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"}

package/dist/wasm/wasm_types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wasm_types.js.map

package/dist/wasm/wasm_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm_types.js","sourceRoot":"","sources":["../../src/wasm/wasm_types.ts"],"names":[],"mappings":""}

package/dist/wrapper/conversion.d.ts

@@ -0,0 +1,9 @@
+import { AdaptValue, AdaptValueOrConvertible } from '@adapt-toolkit/sdk/backend';
+type convertible = AdaptValueOrConvertible;
+type object_or_convertible = {
+    [index: string | number | symbol]: object_or_convertible;
+} | object_or_convertible[] | convertible;
+export declare const object_to_adapt_value: (obj: object_or_convertible) => AdaptValue;
+export declare const determine_environment: () => "nitro" | "native" | "wasm" | "invalid";
+export {};
+//# sourceMappingURL=conversion.d.ts.map

package/dist/wrapper/conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../../src/wrapper/conversion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,UAAU,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGrG,KAAK,WAAW,GAAG,uBAAuB,CAAC;AAE3C,KAAK,qBAAqB,GACtB;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,qBAAqB,CAAA;CAAE,GAC5D,qBAAqB,EAAE,GACvB,WAAW,CAAC;AAehB,eAAO,MAAM,qBAAqB,GAAI,KAAK,qBAAqB,KAAG,UA4BlE,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAEtE,CAAC"}

package/dist/wrapper/conversion.js

@@ -0,0 +1,41 @@
+import { AdaptEnvironment, AdaptValue } from '@adapt-toolkit/sdk/backend';
+import { AdaptObjectBuilder } from './memory_management/adapt_builder.js';
+// Reuse a SINGLE process-lifetime secure value-host across all conversions. object_to_adapt_value
+// previously minted a fresh EmptyPacket(true) PER CALL to host its dictionary; since CreateDictionary's
+// AdaptValue carries a reference to its host packet (CreateDictionary: ret.m_packet.reset_ptr(m_packet)),
+// every converted value pinned its own packet alive — accumulating one retained packet per conversion
+// under sustained load (unbounded native packet growth). Reusing one host bounds it to a single packet:
+// the values are immutable and independent (NewImmutableDictionary), the host only supplies the value
+// domain/allocator, and evaluation is single-threaded, so a shared host is safe. secure=true is preserved
+// (forbids in-packet primitive calls). lt=undefined ⇒ a process-lifetime singleton (caller-owned, never
+// auto-freed = exactly one packet for the process), mirroring the GetProtocolContainer singleton pattern.
+let _value_host;
+const value_host = () => (_value_host ??= AdaptEnvironment.EmptyPacket(undefined, true));
+export const object_to_adapt_value = (obj) => {
+    return AdaptObjectBuilder.execute_and_collect_garbage((builder) => {
+        if (obj instanceof AdaptValue)
+            return obj.Clone(undefined);
+        if (typeof obj === 'string' ||
+            typeof obj === 'number' ||
+            typeof obj === 'undefined' ||
+            typeof obj === 'boolean' ||
+            obj === null)
+            return builder.AdaptValue.New(obj).Detach();
+        let result = value_host().CreateDictionary();
+        if (Array.isArray(obj)) {
+            obj.forEach((value, index) => {
+                result = result.Mutate(index, builder.Attach(object_to_adapt_value(value)));
+            });
+        }
+        else {
+            for (const [key, value] of Object.entries(obj)) {
+                result = result.Mutate(builder.Attach(object_to_adapt_value(key)), builder.Attach(object_to_adapt_value(value)));
+            }
+        }
+        return result.Detach();
+    });
+};
+export const determine_environment = () => {
+    return AdaptEnvironment.DetermineEnvironment();
+};
+//# sourceMappingURL=conversion.js.map

package/dist/wrapper/conversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../src/wrapper/conversion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,UAAU,EAA2B,MAAM,UAAU,CAAC;AACrG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAS1E,kGAAkG;AAClG,wGAAwG;AACxG,0GAA0G;AAC1G,sGAAsG;AACtG,wGAAwG;AACxG,sGAAsG;AACtG,0GAA0G;AAC1G,wGAAwG;AACxG,0GAA0G;AAC1G,IAAI,WAA2C,CAAC;AAChD,MAAM,UAAU,GAAG,GAAuB,EAAE,CAC1C,CAAC,WAAW,KAAK,gBAAgB,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAA0B,EAAc,EAAE;IAC9E,OAAO,kBAAkB,CAAC,2BAA2B,CAAC,CAAC,OAAO,EAAE,EAAE;QAChE,IAAI,GAAG,YAAY,UAAU;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3D,IACE,OAAO,GAAG,KAAK,QAAQ;YACvB,OAAO,GAAG,KAAK,QAAQ;YACvB,OAAO,GAAG,KAAK,WAAW;YAC1B,OAAO,GAAG,KAAK,SAAS;YACxB,GAAG,KAAK,IAAI;YAEZ,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QAE9C,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC,gBAAgB,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC3B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAC1C,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAC7C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAA4C,EAAE;IACjF,OAAO,gBAAgB,CAAC,oBAAoB,EAAE,CAAC;AACjD,CAAC,CAAC"}

package/dist/wrapper/index.d.ts

@@ -0,0 +1,12 @@
+export * from './memory_management/adapt_builder.js';
+export * from './memory_management/exit_handler_registrar.js';
+export * from './conversion.js';
+export { Protocol } from './protocol/protocol.js';
+export * from './protocol/message_handler_interfaces.js';
+export * from './protocol/broker_frame.js';
+/**
+ * Read the bytes of a file from either a Node filesystem path or a
+ * browser-fetchable URL. Selection is automatic based on the runtime.
+ */
+export declare function ReadFile(file_path: string): Promise<Uint8Array>;
+//# sourceMappingURL=index.d.ts.map

package/dist/wrapper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wrapper/index.ts"],"names":[],"mappings":"AAGA,cAAc,sCAAsC,CAAC;AACrD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAE3C;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAWrE"}

package/dist/wrapper/index.js

@@ -0,0 +1,26 @@
+import { readFileSync } from 'node:fs';
+import { determine_environment } from './conversion.js';
+export * from './memory_management/adapt_builder.js';
+export * from './memory_management/exit_handler_registrar.js';
+export * from './conversion.js';
+export { Protocol } from './protocol/protocol.js';
+export * from './protocol/message_handler_interfaces.js';
+export * from './protocol/broker_frame.js';
+/**
+ * Read the bytes of a file from either a Node filesystem path or a
+ * browser-fetchable URL. Selection is automatic based on the runtime.
+ */
+export async function ReadFile(file_path) {
+    if (determine_environment() === 'wasm') {
+        try {
+            const data = await (await (await fetch(file_path)).blob()).arrayBuffer();
+            return new Uint8Array(data);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            throw new Error('Error while fetching code object file: ' + message);
+        }
+    }
+    return readFileSync(file_path);
+}
+//# sourceMappingURL=index.js.map

package/dist/wrapper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wrapper/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,cAAc,sCAAsC,CAAC;AACrD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB;IAC9C,IAAI,qBAAqB,EAAE,KAAK,MAAM,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACzE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,OAAO,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/wrapper/memory_management/adapt_builder.d.ts

@@ -0,0 +1,36 @@
+import { AdaptEvaluationUnit, AdaptValue, AdaptPacketContext, AdaptObject, AdaptObjectLifetime, Convertible } from '@adapt-toolkit/sdk/backend';
+/**
+ * Lifecycle helper that owns an {@link AdaptObjectLifetime} and offers typed
+ * factory methods for the core ADAPT classes. Every object produced through
+ * the builder is registered against the same lifetime, so a single
+ * `Destroy()` call cleans them all up.
+ */
+export declare class AdaptObjectBuilder {
+    readonly lifetime: AdaptObjectLifetime;
+    constructor();
+    Destroy(): void;
+    Attach<T extends AdaptObject>(object: T): T;
+    readonly AdaptValue: {
+        readonly New: (value: Convertible | AdaptValue) => AdaptValue;
+    };
+    readonly AdaptPacketContext: {
+        readonly New: (unit: AdaptEvaluationUnit, seed_phrase: string, entropy_hex: string, secure: boolean, init_arg?: AdaptValue) => AdaptPacketContext;
+        readonly EmptyPacket: (secure: boolean) => AdaptPacketContext;
+        readonly LoadFromFile: (path: string) => AdaptPacketContext;
+        readonly LoadFromContents: (contents: Uint8Array) => AdaptPacketContext;
+    };
+    readonly AdaptEvaluationUnit: {
+        readonly LoadFromFile: (path: string) => AdaptEvaluationUnit;
+        readonly LoadFromContents: (contents: Uint8Array) => AdaptEvaluationUnit;
+    };
+    readonly AdaptEnvironment: {
+        readonly CreatePacket: (unit: AdaptEvaluationUnit, seed_phrase: string, entropy_hex: string, secure: boolean, init_arg?: AdaptValue) => AdaptPacketContext;
+        readonly EmptyPacket: (secure: boolean) => AdaptPacketContext;
+        readonly SystemTime: () => AdaptValue;
+        readonly ParseTime: (timestamp: string) => AdaptValue;
+        readonly GetRandomBytes: (length: number) => AdaptValue;
+    };
+    static execute_and_collect_garbage<T>(cb: (builder: AdaptObjectBuilder) => T, onError?: (e: unknown, builder: AdaptObjectBuilder) => T): T;
+    static execute_and_collect_garbage_sync<T>(cb: (builder: AdaptObjectBuilder) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=adapt_builder.d.ts.map

package/dist/wrapper/memory_management/adapt_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapt_builder.d.ts","sourceRoot":"","sources":["../../../src/wrapper/memory_management/adapt_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;;IAiF9C,OAAO,IAAI,IAAI;IAIf,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;IAK3C,SAAgB,UAAU,EAAE;QAC1B,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,KAAK,UAAU,CAAC;KAC/D,CAAC;IAEF,SAAgB,kBAAkB,EAAE;QAClC,QAAQ,CAAC,GAAG,EAAE,CACZ,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,UAAU,KAClB,kBAAkB,CAAC;QACxB,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,kBAAkB,CAAC;QAC9D,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,CAAC;QAC5D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,kBAAkB,CAAC;KACzE,CAAC;IAEF,SAAgB,mBAAmB,EAAE;QACnC,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,mBAAmB,CAAC;QAC7D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,mBAAmB,CAAC;KAC1E,CAAC;IAEF,SAAgB,gBAAgB,EAAE;QAChC,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,UAAU,KAClB,kBAAkB,CAAC;QACxB,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,kBAAkB,CAAC;QAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,UAAU,CAAC;QACtC,QAAQ,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,CAAC;QACtD,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC;KACzD,CAAC;IAEF,MAAM,CAAC,2BAA2B,CAAC,CAAC,EAClC,EAAE,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,CAAC,EACtC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,GACvD,CAAC;IAYJ,MAAM,CAAC,gCAAgC,CAAC,CAAC,EACvC,EAAE,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9C,OAAO,CAAC,CAAC,CAAC;CAYd"}

package/dist/wrapper/memory_management/adapt_builder.js

@@ -0,0 +1,98 @@
+import { AdaptEnvironment, AdaptEvaluationUnit, AdaptValue, AdaptPacketContext, AdaptObjectLifetime, } from '@adapt-toolkit/sdk/backend';
+/**
+ * Lifecycle helper that owns an {@link AdaptObjectLifetime} and offers typed
+ * factory methods for the core ADAPT classes. Every object produced through
+ * the builder is registered against the same lifetime, so a single
+ * `Destroy()` call cleans them all up.
+ */
+export class AdaptObjectBuilder {
+    lifetime;
+    constructor() {
+        this.lifetime = new AdaptObjectLifetime();
+        const lifetime = this.lifetime;
+        this.AdaptValue = {
+            New(value) {
+                return new AdaptValue(lifetime, value);
+            },
+        };
+        this.AdaptPacketContext = {
+            New(unit, seed_phrase, entropy_hex, secure, init_arg) {
+                return AdaptEnvironment.CreatePacket(lifetime, unit, seed_phrase, entropy_hex, secure, new AdaptValue(lifetime, init_arg));
+            },
+            EmptyPacket(secure) {
+                return AdaptEnvironment.EmptyPacket(lifetime, secure);
+            },
+            LoadFromFile(path) {
+                return AdaptPacketContext.LoadFromFile(lifetime, path);
+            },
+            LoadFromContents(contents) {
+                return AdaptPacketContext.LoadFromContents(lifetime, contents);
+            },
+        };
+        this.AdaptEvaluationUnit = {
+            LoadFromFile(path) {
+                return AdaptEvaluationUnit.LoadFromFile(lifetime, path);
+            },
+            LoadFromContents(contents) {
+                return AdaptEvaluationUnit.LoadFromContents(lifetime, contents);
+            },
+        };
+        this.AdaptEnvironment = {
+            CreatePacket(unit, seed_phrase, entropy_hex, secure, init_arg) {
+                return AdaptEnvironment.CreatePacket(lifetime, unit, seed_phrase, entropy_hex, secure, init_arg);
+            },
+            EmptyPacket(secure) {
+                return AdaptEnvironment.EmptyPacket(lifetime, secure);
+            },
+            SystemTime() {
+                return AdaptEnvironment.SystemTime(lifetime);
+            },
+            ParseTime(timestamp) {
+                return AdaptEnvironment.ParseTime(lifetime, timestamp);
+            },
+            GetRandomBytes(length) {
+                return AdaptEnvironment.GetRandomBytes(lifetime, length);
+            },
+        };
+    }
+    Destroy() {
+        this.lifetime.Finalize();
+    }
+    Attach(object) {
+        object.Attach(this.lifetime);
+        return object;
+    }
+    AdaptValue;
+    AdaptPacketContext;
+    AdaptEvaluationUnit;
+    AdaptEnvironment;
+    static execute_and_collect_garbage(cb, onError) {
+        const builder = new AdaptObjectBuilder();
+        try {
+            return cb(builder);
+        }
+        catch (e) {
+            if (onError)
+                return onError(e, builder);
+            throw e;
+        }
+        finally {
+            builder.Destroy();
+        }
+    }
+    static execute_and_collect_garbage_sync(cb) {
+        return new Promise((resolve, reject) => {
+            const builder = new AdaptObjectBuilder();
+            try {
+                resolve(cb(builder));
+            }
+            catch (e) {
+                reject(e);
+            }
+            finally {
+                builder.Destroy();
+            }
+        });
+    }
+}
+//# sourceMappingURL=adapt_builder.js.map

package/dist/wrapper/memory_management/adapt_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapt_builder.js","sourceRoot":"","sources":["../../../src/wrapper/memory_management/adapt_builder.ts"],"names":[],"mappings":"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"}

package/dist/wrapper/memory_management/exit_handler_registrar.d.ts

@@ -0,0 +1,10 @@
+export declare class ExitHandlerRegistrar {
+    private static instance;
+    private handlers;
+    private constructor();
+    static getInstance(): ExitHandlerRegistrar;
+    registerOnExitHandler(handler: () => void): void;
+    private onExit;
+    private onSignal;
+}
+//# sourceMappingURL=exit_handler_registrar.d.ts.map

package/dist/wrapper/memory_management/exit_handler_registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit_handler_registrar.d.ts","sourceRoot":"","sources":["../../../src/wrapper/memory_management/exit_handler_registrar.ts"],"names":[],"mappings":"AAEA,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAsB;IAEtC,OAAO;WAQO,WAAW,IAAI,oBAAoB;IAO1C,qBAAqB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvD,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/wrapper/memory_management/exit_handler_registrar.js

@@ -0,0 +1,38 @@
+import { AdaptObject } from '@adapt-toolkit/sdk/backend';
+export class ExitHandlerRegistrar {
+    static instance = null;
+    handlers = [];
+    constructor() {
+        if (typeof process !== 'undefined') {
+            process.on('exit', this.onExit.bind(this));
+            process.on('SIGINT', this.onSignal.bind(this));
+            process.on('SIGTERM', this.onSignal.bind(this));
+        }
+    }
+    static getInstance() {
+        if (!ExitHandlerRegistrar.instance) {
+            ExitHandlerRegistrar.instance = new ExitHandlerRegistrar();
+        }
+        return ExitHandlerRegistrar.instance;
+    }
+    registerOnExitHandler(handler) {
+        this.handlers.push(handler);
+    }
+    onExit() {
+        this.handlers.forEach((handler) => {
+            try {
+                handler();
+            }
+            catch (err) {
+                console.error('Exit handler failed:', err);
+            }
+        });
+        AdaptObject.logLeaks();
+    }
+    onSignal() {
+        if (typeof process !== 'undefined') {
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=exit_handler_registrar.js.map

package/dist/wrapper/memory_management/exit_handler_registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit_handler_registrar.js","sourceRoot":"","sources":["../../../src/wrapper/memory_management/exit_handler_registrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAC,QAAQ,GAAgC,IAAI,CAAC;IACpD,QAAQ,GAAmB,EAAE,CAAC;IAEtC;QACE,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACnC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7D,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC,CAAC;IAEM,qBAAqB,CAAC,OAAmB;QAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAChC,IAAI,CAAC;gBACH,OAAO,EAAE,CAAC;YACZ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAEO,QAAQ;QACd,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC"}

package/dist/wrapper/protocol/broker_frame.d.ts

@@ -0,0 +1,20 @@
+import type { Protocol } from './protocol.js';
+export declare const FRAME_VERSION = 1;
+export declare const FRAME_HEADER_SIZE = 39;
+export declare const FRAME_TYPE_BY_ID: readonly ["b2w_exec_transaction", "b2w_init", "b2w_reg_ok", "d2w_backup_data", "d2w_code_object", "d2w_create_packet_confirm", "d2w_init", "d2w_last_snapshot_state", "d2w_last_state", "d2w_snapshot", "d2w_transaction_chain", "d2w_write_snapshot_confirm", "d2w_write_transaction_confirm", "e2w_init", "w2b_reg", "w2b_transaction", "w2d_create_packet", "w2d_get_code_object", "w2d_get_last_snapshot_state", "w2d_get_last_state", "w2d_get_transaction_chain", "w2d_read_snapshot", "w2d_request_backup_data", "w2d_write_snapshot", "w2d_write_transaction"];
+export declare function frameIdForType(type: string): number;
+export declare function cidHexToBytes(cidHex: string): Uint8Array;
+export declare function bytesToCidHex(to: Uint8Array): string;
+export declare function encodeFrame(type: Protocol.MessageName, to: Uint8Array | null, payload: Uint8Array): Uint8Array;
+export interface DecodedFrame {
+    version: number;
+    type: Protocol.MessageName;
+    to: Uint8Array;
+    toHex: string;
+    payload: Uint8Array;
+}
+export declare function decodeFrame(buf: Uint8Array): DecodedFrame;
+export declare function frameType(buf: Uint8Array): Protocol.MessageName;
+export declare function frameToHex(buf: Uint8Array): string;
+export declare function patchFrameType(buf: Uint8Array, type: Protocol.MessageName): void;
+//# sourceMappingURL=broker_frame.d.ts.map

package/dist/wrapper/protocol/broker_frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker_frame.d.ts","sourceRoot":"","sources":["../../../src/wrapper/protocol/broker_frame.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAUpC,eAAO,MAAM,gBAAgB,wiBA0BnB,CAAC;AAIX,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAIxD;AAID,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAY9G;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC;IAC3B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAazD;AAID,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAAC,WAAW,CAI/D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAElD;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAEhF"}

package/dist/wrapper/protocol/broker_frame.js

@@ -0,0 +1,102 @@
+import { Buffer } from 'buffer';
+export const FRAME_VERSION = 1;
+export const FRAME_HEADER_SIZE = 39;
+const VERSION_OFFSET = 0;
+const TYPE_OFFSET = 2;
+const TO_OFFSET = 3;
+const TO_SIZE = 32;
+const LEN_OFFSET = 35;
+// Wire ordering for the 1-byte type field: index = type id. Append-only; never
+// reorder (the index IS the wire value). Must enumerate every Protocol.MessageName
+// — the test broker_frame.test.ts asserts this list matches the enum exactly.
+export const FRAME_TYPE_BY_ID = [
+    'b2w_exec_transaction',
+    'b2w_init',
+    'b2w_reg_ok',
+    'd2w_backup_data',
+    'd2w_code_object',
+    'd2w_create_packet_confirm',
+    'd2w_init',
+    'd2w_last_snapshot_state',
+    'd2w_last_state',
+    'd2w_snapshot',
+    'd2w_transaction_chain',
+    'd2w_write_snapshot_confirm',
+    'd2w_write_transaction_confirm',
+    'e2w_init',
+    'w2b_reg',
+    'w2b_transaction',
+    'w2d_create_packet',
+    'w2d_get_code_object',
+    'w2d_get_last_snapshot_state',
+    'w2d_get_last_state',
+    'w2d_get_transaction_chain',
+    'w2d_read_snapshot',
+    'w2d_request_backup_data',
+    'w2d_write_snapshot',
+    'w2d_write_transaction',
+];
+const ID_BY_TYPE = new Map(FRAME_TYPE_BY_ID.map((t, i) => [t, i]));
+export function frameIdForType(type) {
+    const id = ID_BY_TYPE.get(type);
+    if (id === undefined)
+        throw new Error(`broker_frame: unknown frame type "${type}"`);
+    return id;
+}
+export function cidHexToBytes(cidHex) {
+    const bytes = Buffer.from(cidHex, 'hex');
+    if (bytes.length !== TO_SIZE)
+        throw new Error(`broker_frame: cid must be ${TO_SIZE} bytes (got ${bytes.length})`);
+    return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+// Uppercase to match the engine's canonical cid form (AdaptValue.Visualize()),
+// which is the key used in the broker's connection registry.
+export function bytesToCidHex(to) {
+    return Buffer.from(to.buffer, to.byteOffset, to.byteLength).toString('hex').toUpperCase();
+}
+export function encodeFrame(type, to, payload) {
+    const frame = new Uint8Array(FRAME_HEADER_SIZE + payload.length);
+    const dv = new DataView(frame.buffer);
+    dv.setUint16(VERSION_OFFSET, FRAME_VERSION, true);
+    frame[TYPE_OFFSET] = frameIdForType(type);
+    if (to) {
+        if (to.length !== TO_SIZE)
+            throw new Error(`broker_frame: to must be ${TO_SIZE} bytes (got ${to.length})`);
+        frame.set(to, TO_OFFSET);
+    } // else left zero-filled (broker-directed messages)
+    dv.setUint32(LEN_OFFSET, payload.length, true);
+    frame.set(payload, FRAME_HEADER_SIZE);
+    return frame;
+}
+export function decodeFrame(buf) {
+    if (buf.length < FRAME_HEADER_SIZE)
+        throw new Error(`broker_frame: buffer (${buf.length}B) shorter than header`);
+    const dv = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    const version = dv.getUint16(VERSION_OFFSET, true);
+    const typeId = buf[TYPE_OFFSET];
+    const type = FRAME_TYPE_BY_ID[typeId];
+    if (type === undefined)
+        throw new Error(`broker_frame: unknown frame type id ${typeId}`);
+    const len = dv.getUint32(LEN_OFFSET, true);
+    if (FRAME_HEADER_SIZE + len > buf.length)
+        throw new Error(`broker_frame: payload_len ${len} exceeds buffer (${buf.length - FRAME_HEADER_SIZE}B available)`);
+    const to = buf.subarray(TO_OFFSET, TO_OFFSET + TO_SIZE);
+    const payload = buf.subarray(FRAME_HEADER_SIZE, FRAME_HEADER_SIZE + len);
+    return { version, type, to, toHex: bytesToCidHex(to), payload };
+}
+// Fast single-field reads for the broker hot path (no full decode / no allocation
+// beyond the hex string).
+export function frameType(buf) {
+    const type = FRAME_TYPE_BY_ID[buf[TYPE_OFFSET]];
+    if (type === undefined)
+        throw new Error(`broker_frame: unknown frame type id ${buf[TYPE_OFFSET]}`);
+    return type;
+}
+export function frameToHex(buf) {
+    return Buffer.from(buf.buffer, buf.byteOffset + TO_OFFSET, TO_SIZE).toString('hex').toUpperCase();
+}
+// In-place type flip for the relay path — no length change, no re-encode.
+export function patchFrameType(buf, type) {
+    buf[TYPE_OFFSET] = frameIdForType(type);
+}
+//# sourceMappingURL=broker_frame.js.map

package/dist/wrapper/protocol/broker_frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker_frame.js","sourceRoot":"","sources":["../../../src/wrapper/protocol/broker_frame.ts"],"names":[],"mappings":"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"}

package/dist/wrapper/protocol/message_handler_interfaces.d.ts

@@ -0,0 +1,32 @@
+import { AdaptValue } from '@adapt-toolkit/sdk/backend';
+export interface IAdaptWrapperMessageHandlers {
+    b2w_exec_transaction_handler(message: AdaptValue): void;
+    b2w_init_handler(message: AdaptValue): void;
+    b2w_reg_ok_handler(message: AdaptValue): void;
+    d2w_backup_data_handler(message: AdaptValue): void;
+    d2w_code_object_handler(message: AdaptValue): void;
+    d2w_create_packet_confirm_handler(message: AdaptValue): void;
+    d2w_init_handler(message: AdaptValue): void;
+    d2w_last_snapshot_state_handler(message: AdaptValue): void;
+    d2w_last_state_handler(message: AdaptValue): void;
+    d2w_snapshot_handler(message: AdaptValue): void;
+    d2w_transaction_chain_handler(message: AdaptValue): void;
+    d2w_write_snapshot_confirm_handler(message: AdaptValue): void;
+    d2w_write_transaction_confirm_handler(message: AdaptValue): void;
+}
+export interface IStorageMessageHandlers {
+    w2d_create_packet_handler(message: AdaptValue): void;
+    w2d_get_code_object_handler(message: AdaptValue): void;
+    w2d_get_last_snapshot_state_handler(message: AdaptValue): void;
+    w2d_get_last_state_handler(message: AdaptValue): void;
+    w2d_get_transaction_chain_handler(message: AdaptValue): void;
+    w2d_read_snapshot_handler(message: AdaptValue): void;
+    w2d_request_backup_data_handler(message: AdaptValue): void;
+    w2d_write_snapshot_handler(message: AdaptValue): void;
+    w2d_write_transaction_handler(message: AdaptValue): void;
+}
+export interface IBrokerMessageHandlers {
+    w2b_reg_handler(message: AdaptValue): void;
+    w2b_transaction_handler(message: AdaptValue): void;
+}
+//# sourceMappingURL=message_handler_interfaces.d.ts.map

package/dist/wrapper/protocol/message_handler_interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_handler_interfaces.d.ts","sourceRoot":"","sources":["../../../src/wrapper/protocol/message_handler_interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC,MAAM,WAAW,4BAA4B;IAC3C,4BAA4B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACxD,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5C,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACnD,iCAAiC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7D,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5C,+BAA+B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3D,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAClD,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChD,6BAA6B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACzD,kCAAkC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9D,qCAAqC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,uBAAuB;IACtC,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACrD,2BAA2B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACvD,mCAAmC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/D,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACtD,iCAAiC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7D,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACrD,+BAA+B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3D,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACtD,6BAA6B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3C,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CACpD"}

package/dist/wrapper/protocol/message_handler_interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message_handler_interfaces.js.map

package/dist/wrapper/protocol/message_handler_interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_handler_interfaces.js","sourceRoot":"","sources":["../../../src/wrapper/protocol/message_handler_interfaces.ts"],"names":[],"mappings":""}