@flyingrobots/graft 0.7.1 → 0.9.0

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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"}

package/dist/echo/structural-history-client.js

@@ -0,0 +1,149 @@
+// ---------------------------------------------------------------------------
+// Typed structural-history client over the Echo kernel transport.
+//
+// Rides the generated operation codecs and the EINT v1 / CBOR wire
+// envelopes. Outcome kinds mirror Echo's product-facing intent surface
+// IntentOutcome::{Unknown, Pending, Applied, Rejected, Obstructed}
+// [echo crates/warp-core/src/trusted_runtime_host.rs#740@2048da5c].
+// ---------------------------------------------------------------------------
+import { isCborArray } from "./canonical-cbor.js";
+import { ABI_ERROR_NAMES, EchoEnvelopeCodecError, STRUCTURAL_HISTORY_OBSERVE_OPERATIONS, decodeStructuralHistoryIntentResponse, decodeStructuralHistoryObserveResponse, encodeStructuralHistoryObserveRequest, packStructuralHistoryIntentV1, } from "./structural-history-envelope-codec.js";
+import { OP_RECORD_GIT_WARP_IMPORT_BATCH, encodeRecordGitWarpImportBatchVars, } from "../generated/graft-structural-history.codec.generated.js";
+export class EchoSubstrateObstructionError extends Error {
+    code;
+    recovery;
+    constructor(obstruction) {
+        super(`${obstruction.code}: ${obstruction.message}`);
+        this.name = "EchoSubstrateObstructionError";
+        this.code = obstruction.code;
+        this.recovery = obstruction.recovery;
+    }
+}
+function asRecord(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new EchoEnvelopeCodecError(`${label} is not a map`);
+    }
+    return value;
+}
+function asString(value, label) {
+    if (typeof value !== "string") {
+        throw new EchoEnvelopeCodecError(`${label} is not a string`);
+    }
+    return value;
+}
+function parseObstruction(value) {
+    const record = asRecord(value, "obstruction");
+    const recovery = record["recovery"];
+    return {
+        code: asString(record["code"] ?? null, "obstruction.code"),
+        message: asString(record["message"] ?? null, "obstruction.message"),
+        ...(typeof recovery === "string" ? { recovery } : {}),
+    };
+}
+function parseReceipt(value) {
+    const record = asRecord(value, "receipt");
+    return {
+        submissionId: asString(record["submissionId"] ?? null, "receipt.submissionId"),
+        operationName: asString(record["operationName"] ?? null, "receipt.operationName"),
+    };
+}
+function parseOutcome(value) {
+    const record = asRecord(value, "intent outcome");
+    const kind = asString(record["kind"] ?? null, "outcome.kind");
+    switch (kind) {
+        case "applied":
+            return { kind, receipt: parseReceipt(record["receipt"] ?? null) };
+        case "rejected":
+            return {
+                kind,
+                reason: asString(record["reason"] ?? null, "outcome.reason"),
+                receipt: parseReceipt(record["receipt"] ?? null),
+            };
+        case "pending":
+        case "unknown":
+            return { kind };
+        case "obstructed":
+            return { kind, obstruction: parseObstruction(record["obstruction"] ?? null) };
+        default:
+            throw new EchoEnvelopeCodecError(`unknown intent outcome kind: ${kind}`);
+    }
+}
+function throwWireError(code, message) {
+    throw new EchoSubstrateObstructionError({
+        code: ABI_ERROR_NAMES[code] ?? `ABI_ERROR_${String(code)}`,
+        message,
+    });
+}
+export function createEchoStructuralHistoryClient(transport) {
+    async function observe(operationName, vars) {
+        // The transport seam is synchronous today; awaiting keeps the client
+        // contract stable when a daemon-bridged async kernel replaces the fake.
+        const responseBytes = await Promise.resolve(transport.observeBytes(encodeStructuralHistoryObserveRequest({ operationName, vars })));
+        const response = decodeStructuralHistoryObserveResponse(responseBytes);
+        if (!response.ok) {
+            throwWireError(response.code, response.message);
+        }
+        return { ...response.fields };
+    }
+    return {
+        async recordGitWarpImportBatch(vars) {
+            const envelope = packStructuralHistoryIntentV1(OP_RECORD_GIT_WARP_IMPORT_BATCH, encodeRecordGitWarpImportBatchVars(vars));
+            const responseBytes = await Promise.resolve(transport.submitIntentBytes(envelope));
+            const response = decodeStructuralHistoryIntentResponse(responseBytes);
+            if (!response.ok) {
+                throwWireError(response.code, response.message);
+            }
+            return {
+                submissionId: asString(response.fields["submissionId"] ?? null, "submissionId"),
+            };
+        },
+        async observeIntentOutcome(submissionId) {
+            const fields = await observe(STRUCTURAL_HISTORY_OBSERVE_OPERATIONS.intentOutcome, { submissionId });
+            return parseOutcome(fields["outcome"] ?? null);
+        },
+        async observeStructuralReadings(request) {
+            const fields = await observe(STRUCTURAL_HISTORY_OBSERVE_OPERATIONS.structuralReadings, {
+                basisId: request.basisId,
+                readingKind: request.readingKind ?? null,
+            });
+            const rawReadings = fields["readings"] ?? null;
+            if (!isCborArray(rawReadings)) {
+                throw new EchoEnvelopeCodecError("structural readings response is missing its readings array");
+            }
+            const readings = [];
+            {
+                for (const raw of rawReadings) {
+                    const record = asRecord(raw, "structural reading");
+                    const evidence = asRecord(record["evidence"] ?? null, "reading evidence");
+                    readings.push({
+                        readingId: asString(record["readingId"] ?? null, "reading.readingId"),
+                        readingKind: asString(record["readingKind"] ?? null, "reading.readingKind"),
+                        basisId: asString(record["basisId"] ?? null, "reading.basisId"),
+                        payloadJson: record["payloadJson"] ?? null,
+                        evidence: {
+                            family: asString(evidence["family"] ?? null, "evidence.family"),
+                            readingId: asString(evidence["readingId"] ?? null, "evidence.readingId"),
+                            basis: asRecord(evidence["basis"] ?? null, "evidence.basis"),
+                        },
+                    });
+                }
+            }
+            const obstruction = fields["obstruction"];
+            return {
+                readings,
+                ...(obstruction !== undefined && obstruction !== null
+                    ? { obstruction: parseObstruction(obstruction) }
+                    : {}),
+            };
+        },
+        async inspectRetainedEvidence(request) {
+            const fields = await observe(STRUCTURAL_HISTORY_OBSERVE_OPERATIONS.retainedEvidencePosture, { basisId: request.basisId });
+            const posture = asString(fields["posture"] ?? null, "retained evidence posture");
+            if (posture !== "retained" && posture !== "missing" && posture !== "obstructed") {
+                throw new EchoEnvelopeCodecError(`unknown retained posture: ${posture}`);
+            }
+            return { posture };
+        },
+    };
+}
+//# sourceMappingURL=structural-history-client.js.map

package/dist/echo/structural-history-client.js.map

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

package/dist/echo/structural-history-envelope-codec.d.ts

@@ -0,0 +1,46 @@
+import { type CborValue } from "./canonical-cbor.js";
+/** ABI v3 error codes [echo docs/spec/SPEC-0009-wasm-abi-v3.md@2048da5c]. */
+export declare const ABI_ERROR_CODES: {
+    readonly INVALID_INTENT: 2;
+    readonly NOT_SUPPORTED: 5;
+    readonly CODEC_ERROR: 6;
+    readonly UNSUPPORTED_QUERY: 11;
+    readonly FORBIDDEN_CONTROL_INTENT: 19;
+};
+export declare const ABI_ERROR_NAMES: Readonly<Record<number, string>>;
+/** Envelope-level observe operation names (pre-observer-plan convention). */
+export declare const STRUCTURAL_HISTORY_OBSERVE_OPERATIONS: {
+    readonly intentOutcome: "intentOutcome";
+    readonly structuralReadings: "structuralReadings";
+    readonly retainedEvidencePosture: "retainedEvidencePosture";
+};
+/** Default basis id used by the witness fixture space. */
+export declare const DEFAULT_STRUCTURAL_HISTORY_BASIS_ID = "basis-live";
+export declare class EchoEnvelopeCodecError extends Error {
+    constructor(message: string);
+}
+export declare function packStructuralHistoryIntentV1(opId: number, vars: Uint8Array): Uint8Array;
+export interface StructuralHistoryIntentEnvelope {
+    readonly opId: number;
+    readonly vars: Uint8Array;
+}
+export declare function unpackStructuralHistoryIntentV1(envelope: Uint8Array): StructuralHistoryIntentEnvelope;
+export interface StructuralHistoryObserveRequest {
+    readonly operationName: string;
+    readonly vars: CborValue;
+}
+export declare function encodeStructuralHistoryObserveRequest(request: StructuralHistoryObserveRequest): Uint8Array;
+export declare function decodeStructuralHistoryObserveRequest(bytes: Uint8Array): StructuralHistoryObserveRequest;
+export type StructuralHistoryWireResponse = {
+    readonly ok: true;
+    readonly fields: Readonly<Record<string, CborValue>>;
+} | {
+    readonly ok: false;
+    readonly code: number;
+    readonly message: string;
+};
+export declare function encodeStructuralHistoryOkResponse(fields: Readonly<Record<string, CborValue>>): Uint8Array;
+export declare function encodeStructuralHistoryErrorResponse(code: number, message: string): Uint8Array;
+export declare function decodeStructuralHistoryIntentResponse(bytes: Uint8Array): StructuralHistoryWireResponse;
+export declare function decodeStructuralHistoryObserveResponse(bytes: Uint8Array): StructuralHistoryWireResponse;
+//# sourceMappingURL=structural-history-envelope-codec.d.ts.map

package/dist/echo/structural-history-envelope-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-history-envelope-codec.d.ts","sourceRoot":"","sources":["../../src/echo/structural-history-envelope-codec.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAK7B,6EAA6E;AAC7E,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5D,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,qCAAqC;;;;CAIxC,CAAC;AAEX,0DAA0D;AAC1D,eAAO,MAAM,mCAAmC,eAAe,CAAC;AAEhE,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GACf,UAAU,CAQZ;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,UAAU,GACnB,+BAA+B,CAgBjC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,+BAA+B,GACvC,UAAU,CAKZ;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,UAAU,GAChB,+BAA+B,CAOjC;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAC1C,UAAU,CAEZ;AAED,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,UAAU,CAEZ;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,UAAU,GAChB,6BAA6B,CAE/B;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,UAAU,GAChB,6BAA6B,CAE/B"}