@flyingrobots/graft 0.8.0 → 0.10.0

package/dist/echo/canonical-cbor.d.ts

@@ -0,0 +1,10 @@
+export declare class CborCodecError extends Error {
+    constructor(message: string);
+}
+export type CborValue = null | boolean | number | string | readonly CborValue[] | {
+    readonly [key: string]: CborValue;
+};
+export declare function isCborArray(value: CborValue): value is readonly CborValue[];
+export declare function encodeCanonicalCbor(value: CborValue): Uint8Array;
+export declare function decodeCanonicalCbor(bytes: Uint8Array): CborValue;
+//# sourceMappingURL=canonical-cbor.d.ts.map

package/dist/echo/canonical-cbor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-cbor.d.ts","sourceRoot":"","sources":["../../src/echo/canonical-cbor.ts"],"names":[],"mappings":"AAOA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,SAAS,EAAE,GACpB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,SAAS,SAAS,EAAE,CAE3E;AA2FD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAIhE;AA+FD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAgBhE"}

package/dist/echo/canonical-cbor.js

@@ -0,0 +1,213 @@
+// ---------------------------------------------------------------------------
+// Minimal canonical CBOR (RFC 8949 core deterministic encoding) for the Echo
+// wire envelope. Supports the JSON-shaped subset the witness needs: null,
+// boolean, safe integers, text strings, arrays, and string-keyed maps with
+// keys sorted by their encoded bytes. Floats and tags are out of scope.
+// ---------------------------------------------------------------------------
+export class CborCodecError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CborCodecError";
+    }
+}
+export function isCborArray(value) {
+    return Array.isArray(value);
+}
+const UTF8_ENCODER = new TextEncoder();
+const UTF8_DECODER = new TextDecoder("utf-8", { fatal: true });
+const MAJOR_UNSIGNED = 0;
+const MAJOR_NEGATIVE = 1;
+const MAJOR_TEXT = 3;
+const MAJOR_ARRAY = 4;
+const MAJOR_MAP = 5;
+const MAJOR_SIMPLE = 7;
+const SIMPLE_FALSE = 20;
+const SIMPLE_TRUE = 21;
+const SIMPLE_NULL = 22;
+function encodeHead(major, value) {
+    if (value < 24) {
+        return [(major << 5) | value];
+    }
+    if (value < 0x100) {
+        return [(major << 5) | 24, value];
+    }
+    if (value < 0x10000) {
+        return [(major << 5) | 25, value >>> 8, value & 0xff];
+    }
+    if (value <= 0xffffffff) {
+        return [
+            (major << 5) | 26,
+            (value >>> 24) & 0xff,
+            (value >>> 16) & 0xff,
+            (value >>> 8) & 0xff,
+            value & 0xff,
+        ];
+    }
+    throw new CborCodecError(`length ${String(value)} exceeds supported range`);
+}
+function encodeValue(value, out) {
+    if (value === null) {
+        out.push((MAJOR_SIMPLE << 5) | SIMPLE_NULL);
+        return;
+    }
+    if (typeof value === "boolean") {
+        out.push((MAJOR_SIMPLE << 5) | (value ? SIMPLE_TRUE : SIMPLE_FALSE));
+        return;
+    }
+    if (typeof value === "number") {
+        if (!Number.isSafeInteger(value)) {
+            throw new CborCodecError(`unsupported non-integer number: ${String(value)}`);
+        }
+        if (value >= 0) {
+            out.push(...encodeHead(MAJOR_UNSIGNED, value));
+        }
+        else {
+            out.push(...encodeHead(MAJOR_NEGATIVE, -value - 1));
+        }
+        return;
+    }
+    if (typeof value === "string") {
+        const bytes = UTF8_ENCODER.encode(value);
+        out.push(...encodeHead(MAJOR_TEXT, bytes.length), ...bytes);
+        return;
+    }
+    if (isCborArray(value)) {
+        out.push(...encodeHead(MAJOR_ARRAY, value.length));
+        for (const item of value) {
+            encodeValue(item, out);
+        }
+        return;
+    }
+    const entries = Object.entries(value).map(([key, item]) => {
+        const keyBytes = [];
+        encodeValue(key, keyBytes);
+        return { keyBytes, item };
+    });
+    entries.sort((a, b) => {
+        const min = Math.min(a.keyBytes.length, b.keyBytes.length);
+        for (let i = 0; i < min; i += 1) {
+            const delta = (a.keyBytes[i] ?? 0) - (b.keyBytes[i] ?? 0);
+            if (delta !== 0) {
+                return delta;
+            }
+        }
+        return a.keyBytes.length - b.keyBytes.length;
+    });
+    out.push(...encodeHead(MAJOR_MAP, entries.length));
+    for (const entry of entries) {
+        out.push(...entry.keyBytes);
+        encodeValue(entry.item, out);
+    }
+}
+export function encodeCanonicalCbor(value) {
+    const out = [];
+    encodeValue(value, out);
+    return Uint8Array.from(out);
+}
+class CborReader {
+    bytes;
+    offset = 0;
+    constructor(bytes) {
+        this.bytes = bytes;
+    }
+    take(count) {
+        if (this.offset + count > this.bytes.length) {
+            throw new CborCodecError("unexpected end of CBOR input");
+        }
+        const slice = this.bytes.subarray(this.offset, this.offset + count);
+        this.offset += count;
+        return slice;
+    }
+    readLength(additional) {
+        if (additional < 24) {
+            return additional;
+        }
+        if (additional === 24) {
+            return this.take(1)[0] ?? 0;
+        }
+        if (additional === 25) {
+            const b = this.take(2);
+            return ((b[0] ?? 0) << 8) | (b[1] ?? 0);
+        }
+        if (additional === 26) {
+            const b = this.take(4);
+            // Pure arithmetic: bitwise OR would coerce to signed 32-bit and turn
+            // any length with the high bit set negative.
+            return ((b[0] ?? 0) * 0x1000000 +
+                (b[1] ?? 0) * 0x10000 +
+                (b[2] ?? 0) * 0x100 +
+                (b[3] ?? 0));
+        }
+        throw new CborCodecError(`unsupported CBOR length encoding: ${String(additional)}`);
+    }
+    readValue() {
+        const initial = this.take(1)[0] ?? 0;
+        const major = initial >> 5;
+        const additional = initial & 0x1f;
+        switch (major) {
+            case MAJOR_UNSIGNED:
+                return this.readLength(additional);
+            case MAJOR_NEGATIVE:
+                return -this.readLength(additional) - 1;
+            case MAJOR_TEXT: {
+                const length = this.readLength(additional);
+                return UTF8_DECODER.decode(this.take(length));
+            }
+            case MAJOR_ARRAY: {
+                const length = this.readLength(additional);
+                const items = [];
+                for (let i = 0; i < length; i += 1) {
+                    items.push(this.readValue());
+                }
+                return items;
+            }
+            case MAJOR_MAP: {
+                const length = this.readLength(additional);
+                const result = {};
+                for (let i = 0; i < length; i += 1) {
+                    const key = this.readValue();
+                    if (typeof key !== "string") {
+                        throw new CborCodecError("only text map keys are supported");
+                    }
+                    result[key] = this.readValue();
+                }
+                return result;
+            }
+            case MAJOR_SIMPLE:
+                if (additional === SIMPLE_FALSE) {
+                    return false;
+                }
+                if (additional === SIMPLE_TRUE) {
+                    return true;
+                }
+                if (additional === SIMPLE_NULL) {
+                    return null;
+                }
+                throw new CborCodecError(`unsupported CBOR simple value: ${String(additional)}`);
+            default:
+                throw new CborCodecError(`unsupported CBOR major type: ${String(major)}`);
+        }
+    }
+    finished() {
+        return this.offset === this.bytes.length;
+    }
+}
+export function decodeCanonicalCbor(bytes) {
+    let reader;
+    let value;
+    try {
+        reader = new CborReader(bytes);
+        value = reader.readValue();
+    }
+    catch (error) {
+        if (error instanceof CborCodecError) {
+            throw error;
+        }
+        throw new CborCodecError(String(error));
+    }
+    if (!reader.finished()) {
+        throw new CborCodecError("trailing bytes after CBOR value");
+    }
+    return value;
+}
+//# sourceMappingURL=canonical-cbor.js.map

package/dist/echo/canonical-cbor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-cbor.js","sourceRoot":"","sources":["../../src/echo/canonical-cbor.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAUD,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC;AACvC,MAAM,YAAY,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/D,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa;IAC9C,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE;YACjB,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI;YACrB,CAAC,KAAK,KAAK,EAAE,CAAC,GAAG,IAAI;YACrB,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI;YACpB,KAAK,GAAG,IAAI;SACb,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,cAAc,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB,EAAE,GAAa;IAClD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,cAAc,CAAC,mCAAmC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;QACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/C,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU;IAGe;IAFrB,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA6B,KAAiB;QAAjB,UAAK,GAAL,KAAK,CAAY;IAAG,CAAC;IAE1C,IAAI,CAAC,KAAa;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,cAAc,CAAC,8BAA8B,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,UAAU,CAAC,UAAkB;QACnC,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;YACpB,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACvB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACvB,qEAAqE;YACrE,6CAA6C;YAC7C,OAAO,CACL,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS;gBACvB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO;gBACrB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK;gBACnB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CACZ,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,qCAAqC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,SAAS;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,CAAC;QAC3B,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;QAClC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACrC,KAAK,cAAc;gBACjB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC1C,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAC3C,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAC3C,MAAM,KAAK,GAAgB,EAAE,CAAC;gBAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC/B,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAC3C,MAAM,MAAM,GAA8B,EAAE,CAAC;gBAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;wBAC5B,MAAM,IAAI,cAAc,CAAC,kCAAkC,CAAC,CAAC;oBAC/D,CAAC;oBACD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjC,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,KAAK,YAAY;gBACf,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;oBAChC,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;oBAC/B,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;oBAC/B,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,cAAc,CAAC,kCAAkC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACnF;gBACE,MAAM,IAAI,cAAc,CAAC,gCAAgC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,IAAI,MAAkB,CAAC;IACvB,IAAI,KAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,cAAc,CAAC,iCAAiC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/echo/codec-runtime.d.ts

@@ -0,0 +1,72 @@
+export declare class Writer {
+    private buf;
+    private view;
+    private pos;
+    constructor();
+    private reserve;
+    writeBytes(bytes: Uint8Array): void;
+    writeU8(v: number): void;
+    writeU16Le(v: number): void;
+    writeU32Le(v: number): void;
+    writeI32Le(v: number): void;
+    /**
+     * Canonicalize `v` identically to `F32Scalar::new()` / `canonicalize_f32()`
+     * in Rust, then write 4 bytes LE.
+     *
+     * Caller contract: `v` must already be an exact f32-representable value.
+     * Do not feed f64 intermediate results into this method.
+     */
+    writeF32Le(v: number): void;
+    /**
+     * 1 byte: 0x00 = false, 0x01 = true. Takes the literal byte value
+     * directly rather than a `boolean` because the quality gate forbids
+     * boolean parameters (no flag-shaped function signatures). Callers
+     * with a runtime `boolean` should write `w.writeBool(v ? 1 : 0)`.
+     */
+    writeBool(v: 0 | 1): void;
+    /**
+     * Write a length-prefixed UTF-8 string (u32 LE length + bytes, no null
+     * terminator). Caller must ensure the string is NFC-normalized before
+     * encoding if cross-platform digest stability is required.
+     */
+    writeString(v: string): void;
+    /** Presence tag (0x00 = null) + encoded payload when present. */
+    writeOption<T>(v: T | null, encode: (w: Writer, v: T) => void): void;
+    /** u32 LE element count + each element encoded inline. */
+    writeList<T>(vs: readonly T[], encode: (w: Writer, v: T) => void): void;
+    finish(): Uint8Array;
+}
+export declare class CodecError extends Error {
+    constructor(message: string);
+}
+export declare class Reader {
+    private readonly view;
+    private pos;
+    constructor(bytes: Uint8Array);
+    /** Number of bytes left to consume from the underlying buffer. */
+    remaining(): number;
+    private take;
+    readU8(): number;
+    readU16Le(): number;
+    readU32Le(): number;
+    readI32Le(): number;
+    readF32Le(): number;
+    readBool(): boolean;
+    readString(): string;
+    readOption<T>(decode: (r: Reader) => T): T | null;
+    readList<T>(decode: (r: Reader) => T): T[];
+}
+/**
+ * Canonicalize a number as an f32, matching `canonicalize_f32()` in Rust.
+ *
+ * - NaN (any) → 0x7fc00000 (positive quiet NaN)
+ * - subnormal → +0.0
+ * - -0.0 → +0.0
+ * - all other values pass through unchanged
+ *
+ * JavaScript has no f32 type. This function reads the float32 bit pattern
+ * written by `DataView.setFloat32` (which narrows the f64 to the nearest f32),
+ * then applies the canonicalization rules above.
+ */
+export declare function canonicalizeF32(v: number): number;
+//# sourceMappingURL=codec-runtime.d.ts.map

package/dist/echo/codec-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-runtime.d.ts","sourceRoot":"","sources":["../../src/echo/codec-runtime.ts"],"names":[],"mappings":"AAmCA,qBAAa,MAAM;IACf,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,GAAG,CAAS;;IAQpB,OAAO,CAAC,OAAO;IAWf,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMnC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAOxB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3B,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3B;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM3B;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI;IAIzB;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAM5B,iEAAiE;IACjE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IASpE,0DAA0D;IAC1D,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAOvE,MAAM,IAAI,UAAU;CAGvB;AAMD,qBAAa,UAAW,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,GAAG,CAAS;gBAER,KAAK,EAAE,UAAU;IAK7B,kEAAkE;IAClE,SAAS,IAAI,MAAM;IAInB,OAAO,CAAC,IAAI;IASZ,MAAM,IAAI,MAAM;IAKhB,SAAS,IAAI,MAAM;IAKnB,SAAS,IAAI,MAAM;IAKnB,SAAS,IAAI,MAAM;IAKnB,SAAS,IAAI,MAAM;IAKnB,QAAQ,IAAI,OAAO;IAOnB,UAAU,IAAI,MAAM;IAepB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAOjD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE;CAQ7C;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BjD"}

package/dist/echo/codec-runtime.js

@@ -0,0 +1,259 @@
+// SPDX-License-Identifier: Apache-2.0
+// Minimal deterministic codec helpers — little-endian binary encoding.
+//
+// This is a method-for-method TypeScript mirror of echo-wasm-abi::codec (Rust).
+// Wire layout is identical: same field order, same type widths, same endianness.
+//
+// Canonicalization contract for f32 (matches F32Scalar::new in warp-math):
+//   NaN (any variant)  → 0x7fc00000 (positive quiet NaN)
+//   subnormal          → +0.0  (0x00000000)
+//   -0.0               → +0.0
+//   all other values   pass through unchanged
+// ---------------------------------------------------------------------------
+// Writer
+// ---------------------------------------------------------------------------
+const INITIAL_CAPACITY = 256;
+const U8_MAX = 0xff;
+const U16_MAX = 0xffff;
+const U32_MAX = 0xffffffff;
+const I32_MIN = -0x80000000;
+const I32_MAX = 0x7fffffff;
+function assertUint(name, v, max) {
+    if (!Number.isInteger(v) || v < 0 || v > max) {
+        throw new CodecError(`${name} ${String(v)} is out of range`);
+    }
+}
+function assertInt32(v) {
+    if (!Number.isInteger(v) || v < I32_MIN || v > I32_MAX) {
+        throw new CodecError(`i32 ${String(v)} is out of range`);
+    }
+}
+export class Writer {
+    buf;
+    view;
+    pos;
+    constructor() {
+        this.buf = new Uint8Array(INITIAL_CAPACITY);
+        this.view = new DataView(this.buf.buffer);
+        this.pos = 0;
+    }
+    reserve(n) {
+        const needed = this.pos + n;
+        if (needed <= this.buf.length)
+            return;
+        let next = this.buf.length * 2;
+        while (next < needed)
+            next *= 2;
+        const grown = new Uint8Array(next);
+        grown.set(this.buf);
+        this.buf = grown;
+        this.view = new DataView(this.buf.buffer);
+    }
+    writeBytes(bytes) {
+        this.reserve(bytes.length);
+        this.buf.set(bytes, this.pos);
+        this.pos += bytes.length;
+    }
+    writeU8(v) {
+        assertUint('u8', v, U8_MAX);
+        this.reserve(1);
+        this.buf[this.pos] = v;
+        this.pos += 1;
+    }
+    writeU16Le(v) {
+        assertUint('u16', v, U16_MAX);
+        this.reserve(2);
+        this.view.setUint16(this.pos, v, /* littleEndian */ true);
+        this.pos += 2;
+    }
+    writeU32Le(v) {
+        assertUint('u32', v, U32_MAX);
+        this.reserve(4);
+        this.view.setUint32(this.pos, v, /* littleEndian */ true);
+        this.pos += 4;
+    }
+    writeI32Le(v) {
+        assertInt32(v);
+        this.reserve(4);
+        this.view.setInt32(this.pos, v, /* littleEndian */ true);
+        this.pos += 4;
+    }
+    /**
+     * Canonicalize `v` identically to `F32Scalar::new()` / `canonicalize_f32()`
+     * in Rust, then write 4 bytes LE.
+     *
+     * Caller contract: `v` must already be an exact f32-representable value.
+     * Do not feed f64 intermediate results into this method.
+     */
+    writeF32Le(v) {
+        this.reserve(4);
+        this.view.setFloat32(this.pos, canonicalizeF32(v), /* littleEndian */ true);
+        this.pos += 4;
+    }
+    /**
+     * 1 byte: 0x00 = false, 0x01 = true. Takes the literal byte value
+     * directly rather than a `boolean` because the quality gate forbids
+     * boolean parameters (no flag-shaped function signatures). Callers
+     * with a runtime `boolean` should write `w.writeBool(v ? 1 : 0)`.
+     */
+    writeBool(v) {
+        this.writeU8(v);
+    }
+    /**
+     * Write a length-prefixed UTF-8 string (u32 LE length + bytes, no null
+     * terminator). Caller must ensure the string is NFC-normalized before
+     * encoding if cross-platform digest stability is required.
+     */
+    writeString(v) {
+        const bytes = new TextEncoder().encode(v);
+        this.writeU32Le(bytes.length);
+        this.writeBytes(bytes);
+    }
+    /** Presence tag (0x00 = null) + encoded payload when present. */
+    writeOption(v, encode) {
+        if (v === null) {
+            this.writeU8(0x00);
+        }
+        else {
+            this.writeU8(0x01);
+            encode(this, v);
+        }
+    }
+    /** u32 LE element count + each element encoded inline. */
+    writeList(vs, encode) {
+        this.writeU32Le(vs.length);
+        for (const v of vs) {
+            encode(this, v);
+        }
+    }
+    finish() {
+        return this.buf.slice(0, this.pos);
+    }
+}
+// ---------------------------------------------------------------------------
+// Reader
+// ---------------------------------------------------------------------------
+export class CodecError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CodecError';
+    }
+}
+export class Reader {
+    view;
+    pos;
+    constructor(bytes) {
+        this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+        this.pos = 0;
+    }
+    /** Number of bytes left to consume from the underlying buffer. */
+    remaining() {
+        return this.view.byteLength - this.pos;
+    }
+    take(n) {
+        const start = this.pos;
+        if (start + n > this.view.byteLength) {
+            throw new CodecError('buffer too short');
+        }
+        this.pos += n;
+        return start;
+    }
+    readU8() {
+        const at = this.take(1);
+        return this.view.getUint8(at);
+    }
+    readU16Le() {
+        const at = this.take(2);
+        return this.view.getUint16(at, /* littleEndian */ true);
+    }
+    readU32Le() {
+        const at = this.take(4);
+        return this.view.getUint32(at, /* littleEndian */ true);
+    }
+    readI32Le() {
+        const at = this.take(4);
+        return this.view.getInt32(at, /* littleEndian */ true);
+    }
+    readF32Le() {
+        const at = this.take(4);
+        return this.view.getFloat32(at, /* littleEndian */ true);
+    }
+    readBool() {
+        const tag = this.readU8();
+        if (tag === 0x00)
+            return false;
+        if (tag === 0x01)
+            return true;
+        throw new CodecError(`invalid bool tag: 0x${tag.toString(16).padStart(2, '0')}`);
+    }
+    readString() {
+        const len = this.readU32Le();
+        const at = this.take(len);
+        const slice = new Uint8Array(this.view.buffer, this.view.byteOffset + at, len);
+        try {
+            return new TextDecoder('utf-8', { fatal: true }).decode(slice);
+        }
+        catch {
+            throw new CodecError('invalid utf-8');
+        }
+    }
+    readOption(decode) {
+        const tag = this.readU8();
+        if (tag === 0x00)
+            return null;
+        if (tag === 0x01)
+            return decode(this);
+        throw new CodecError(`invalid option tag: 0x${tag.toString(16).padStart(2, '0')}`);
+    }
+    readList(decode) {
+        const count = this.readU32Le();
+        const out = [];
+        for (let i = 0; i < count; i++) {
+            out.push(decode(this));
+        }
+        return out;
+    }
+}
+// ---------------------------------------------------------------------------
+// F32 canonicalization
+// ---------------------------------------------------------------------------
+// Shared DataView for bit-manipulation of f32 values.
+const _f32Buf = new ArrayBuffer(4);
+const _f32View = new DataView(_f32Buf);
+/** Canonical quiet-NaN bit pattern (matches `F32Scalar` in warp-math). */
+const F32_CANONICAL_NAN_BITS = 0x7fc0_0000;
+/**
+ * Canonicalize a number as an f32, matching `canonicalize_f32()` in Rust.
+ *
+ * - NaN (any) → 0x7fc00000 (positive quiet NaN)
+ * - subnormal → +0.0
+ * - -0.0 → +0.0
+ * - all other values pass through unchanged
+ *
+ * JavaScript has no f32 type. This function reads the float32 bit pattern
+ * written by `DataView.setFloat32` (which narrows the f64 to the nearest f32),
+ * then applies the canonicalization rules above.
+ */
+export function canonicalizeF32(v) {
+    // Write as f32 to capture the narrowed bit pattern.
+    _f32View.setFloat32(0, v, /* littleEndian */ false);
+    const bits = _f32View.getUint32(0, /* littleEndian */ false);
+    const exponent = (bits >>> 23) & 0xff;
+    const mantissa = bits & 0x007f_ffff;
+    // NaN: exponent all-1s, mantissa non-zero.
+    if (exponent === 0xff && mantissa !== 0) {
+        _f32View.setUint32(0, F32_CANONICAL_NAN_BITS, /* littleEndian */ false);
+        return _f32View.getFloat32(0, /* littleEndian */ false);
+    }
+    // Subnormal: exponent zero, mantissa non-zero. → +0.0
+    if (exponent === 0 && mantissa !== 0) {
+        return 0;
+    }
+    // -0.0: sign bit set, exponent zero, mantissa zero. → +0.0
+    if (bits === 0x8000_0000) {
+        return 0;
+    }
+    // All other values (normal, ±Infinity, +0.0) pass through.
+    return _f32View.getFloat32(0, /* littleEndian */ false);
+}
+//# sourceMappingURL=codec-runtime.js.map

package/dist/echo/codec-runtime.js.map

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

package/dist/echo/structural-history-client.d.ts

@@ -0,0 +1,68 @@
+import type { EchoKernelTransport } from "../ports/echo-kernel-transport.js";
+import { type CborValue } from "./canonical-cbor.js";
+import { type RecordGitWarpImportBatchVars } from "../generated/graft-structural-history.codec.generated.js";
+export interface EchoContractObstruction {
+    readonly code: string;
+    readonly message: string;
+    readonly recovery?: string;
+}
+export declare class EchoSubstrateObstructionError extends Error {
+    readonly code: string;
+    readonly recovery: string | undefined;
+    constructor(obstruction: EchoContractObstruction);
+}
+export interface EchoIntentReceipt {
+    readonly submissionId: string;
+    readonly operationName: string;
+}
+export type EchoIntentOutcome = {
+    readonly kind: "applied";
+    readonly receipt: EchoIntentReceipt;
+} | {
+    readonly kind: "rejected";
+    readonly reason: string;
+    readonly receipt: EchoIntentReceipt;
+} | {
+    readonly kind: "pending";
+} | {
+    readonly kind: "unknown";
+} | {
+    readonly kind: "obstructed";
+    readonly obstruction: EchoContractObstruction;
+};
+export interface EchoIntentSubmissionHandle {
+    readonly submissionId: string;
+}
+export interface EchoStructuralReadingRecord {
+    readonly readingId: string;
+    readonly readingKind: string;
+    readonly basisId: string;
+    readonly payloadJson: CborValue;
+    readonly evidence: {
+        readonly family: string;
+        readonly readingId: string;
+        readonly basis: Readonly<Record<string, CborValue>>;
+    };
+}
+export interface EchoStructuralReadingsObservation {
+    readonly readings: readonly EchoStructuralReadingRecord[];
+    readonly obstruction?: EchoContractObstruction;
+}
+export interface EchoStructuralReadingsRequest {
+    readonly basisId: string;
+    readonly readingKind?: string;
+}
+export interface EchoRetainedEvidenceRequest {
+    readonly basisId: string;
+}
+export interface EchoRetainedEvidenceResult {
+    readonly posture: "retained" | "missing" | "obstructed";
+}
+export interface EchoStructuralHistoryClient {
+    recordGitWarpImportBatch(vars: RecordGitWarpImportBatchVars): Promise<EchoIntentSubmissionHandle>;
+    observeIntentOutcome(submissionId: string): Promise<EchoIntentOutcome>;
+    observeStructuralReadings(request: EchoStructuralReadingsRequest): Promise<EchoStructuralReadingsObservation>;
+    inspectRetainedEvidence(request: EchoRetainedEvidenceRequest): Promise<EchoRetainedEvidenceResult>;
+}
+export declare function createEchoStructuralHistoryClient(transport: EchoKernelTransport): EchoStructuralHistoryClient;
+//# sourceMappingURL=structural-history-client.d.ts.map

package/dist/echo/structural-history-client.d.ts.map

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