@flyingrobots/graft 0.8.0 → 0.10.0

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

package/dist/echo/structural-history-envelope-codec.js

@@ -0,0 +1,121 @@
+// ---------------------------------------------------------------------------
+// Structural-history wire envelopes over the Echo kernel transport.
+//
+// Intent intake follows the EINT v1 layout from SPEC-0009 ABI v3
+// [echo docs/spec/SPEC-0009-wasm-abi-v3.md@2048da5c]:
+//   "EINT" (4 bytes) + op_id (u32 LE) + vars_len (u32 LE) + vars bytes.
+// Every transport return is a canonical-CBOR wire envelope with an `ok`
+// discriminator: { ok: true, ...fields } | { ok: false, code, message }.
+// ---------------------------------------------------------------------------
+import { CborCodecError, decodeCanonicalCbor, encodeCanonicalCbor, } from "./canonical-cbor.js";
+const EINT_MAGIC = Uint8Array.from([0x45, 0x49, 0x4e, 0x54]);
+const EINT_V1_HEADER_SIZE = 12;
+/** ABI v3 error codes [echo docs/spec/SPEC-0009-wasm-abi-v3.md@2048da5c]. */
+export const ABI_ERROR_CODES = {
+    INVALID_INTENT: 2,
+    NOT_SUPPORTED: 5,
+    CODEC_ERROR: 6,
+    UNSUPPORTED_QUERY: 11,
+    FORBIDDEN_CONTROL_INTENT: 19,
+};
+export const ABI_ERROR_NAMES = Object.fromEntries(Object.entries(ABI_ERROR_CODES).map(([name, code]) => [code, name]));
+/** Envelope-level observe operation names (pre-observer-plan convention). */
+export const STRUCTURAL_HISTORY_OBSERVE_OPERATIONS = {
+    intentOutcome: "intentOutcome",
+    structuralReadings: "structuralReadings",
+    retainedEvidencePosture: "retainedEvidencePosture",
+};
+/** Default basis id used by the witness fixture space. */
+export const DEFAULT_STRUCTURAL_HISTORY_BASIS_ID = "basis-live";
+export class EchoEnvelopeCodecError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EchoEnvelopeCodecError";
+    }
+}
+export function packStructuralHistoryIntentV1(opId, vars) {
+    const envelope = new Uint8Array(EINT_V1_HEADER_SIZE + vars.byteLength);
+    envelope.set(EINT_MAGIC, 0);
+    const view = new DataView(envelope.buffer, envelope.byteOffset, envelope.byteLength);
+    view.setUint32(4, opId >>> 0, true);
+    view.setUint32(8, vars.byteLength, true);
+    envelope.set(vars, EINT_V1_HEADER_SIZE);
+    return envelope;
+}
+export function unpackStructuralHistoryIntentV1(envelope) {
+    if (envelope.byteLength < EINT_V1_HEADER_SIZE) {
+        throw new EchoEnvelopeCodecError("EINT envelope shorter than header");
+    }
+    for (let i = 0; i < EINT_MAGIC.length; i += 1) {
+        if (envelope[i] !== EINT_MAGIC[i]) {
+            throw new EchoEnvelopeCodecError("EINT magic mismatch");
+        }
+    }
+    const view = new DataView(envelope.buffer, envelope.byteOffset, envelope.byteLength);
+    const opId = view.getUint32(4, true);
+    const varsLength = view.getUint32(8, true);
+    if (EINT_V1_HEADER_SIZE + varsLength !== envelope.byteLength) {
+        throw new EchoEnvelopeCodecError("EINT vars length mismatch");
+    }
+    return { opId, vars: envelope.subarray(EINT_V1_HEADER_SIZE) };
+}
+export function encodeStructuralHistoryObserveRequest(request) {
+    return encodeCanonicalCbor({
+        operationName: request.operationName,
+        vars: request.vars,
+    });
+}
+export function decodeStructuralHistoryObserveRequest(bytes) {
+    const decoded = decodeWireMap(bytes, "observe request");
+    const operationName = decoded["operationName"];
+    if (typeof operationName !== "string") {
+        throw new EchoEnvelopeCodecError("observe request missing operationName");
+    }
+    return { operationName, vars: decoded["vars"] ?? null };
+}
+export function encodeStructuralHistoryOkResponse(fields) {
+    return encodeCanonicalCbor({ ...fields, ok: true });
+}
+export function encodeStructuralHistoryErrorResponse(code, message) {
+    return encodeCanonicalCbor({ ok: false, code, message });
+}
+export function decodeStructuralHistoryIntentResponse(bytes) {
+    return decodeWireResponse(bytes, "intent response");
+}
+export function decodeStructuralHistoryObserveResponse(bytes) {
+    return decodeWireResponse(bytes, "observe response");
+}
+function decodeWireMap(bytes, label) {
+    let decoded;
+    try {
+        decoded = decodeCanonicalCbor(bytes);
+    }
+    catch (error) {
+        if (error instanceof CborCodecError) {
+            throw new EchoEnvelopeCodecError(`${label}: ${error.message}`);
+        }
+        throw error;
+    }
+    if (decoded === null || typeof decoded !== "object" || Array.isArray(decoded)) {
+        throw new EchoEnvelopeCodecError(`${label} is not a CBOR map`);
+    }
+    return decoded;
+}
+function decodeWireResponse(bytes, label) {
+    const decoded = decodeWireMap(bytes, label);
+    const ok = decoded["ok"];
+    if (ok === true) {
+        const { ok: _discriminator, ...fields } = decoded;
+        return { ok: true, fields };
+    }
+    if (ok === false) {
+        const code = decoded["code"];
+        const message = decoded["message"];
+        if (typeof code !== "number" || typeof message !== "string") {
+            throw new EchoEnvelopeCodecError(`${label} error envelope missing code/message`);
+        }
+        return { ok: false, code, message };
+    }
+    throw new EchoEnvelopeCodecError(`${label} missing ok discriminator`);
+}
+//# sourceMappingURL=structural-history-envelope-codec.js.map

package/dist/echo/structural-history-envelope-codec.js.map

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

package/dist/echo/structural-reading-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { StructuralReadingFreshness, StructuralReadingPort, StructuralReadingResidualPosture } from "../ports/structural-reading.js";
+import { type EchoStructuralHistoryClient } from "./structural-history-client.js";
+export interface CreateEchoStructuralReadingPortOptions {
+    readonly basisId?: string;
+}
+interface MappedPosture {
+    readonly freshness: StructuralReadingFreshness;
+    readonly residualPosture: StructuralReadingResidualPosture;
+}
+export declare const OBSTRUCTION_POSTURE: Readonly<Record<string, MappedPosture>>;
+export declare function createEchoStructuralReadingPort(client: EchoStructuralHistoryClient, options?: CreateEchoStructuralReadingPortOptions): StructuralReadingPort;
+export {};
+//# sourceMappingURL=structural-reading-adapter.d.ts.map

package/dist/echo/structural-reading-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-reading-adapter.d.ts","sourceRoot":"","sources":["../../src/echo/structural-reading-adapter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAKV,0BAA0B,EAC1B,qBAAqB,EACrB,gCAAgC,EAIjC,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAGL,KAAK,2BAA2B,EAGjC,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,gCAAgC,CAAC;CAC5D;AAED,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CASvE,CAAC;AA6EF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,2BAA2B,EACnC,OAAO,GAAE,sCAA2C,GACnD,qBAAqB,CAgDvB"}

package/dist/echo/structural-reading-adapter.js

@@ -0,0 +1,120 @@
+// ---------------------------------------------------------------------------
+// Echo-backed StructuralReadingPort adapter — sibling to the git-warp
+// adapter in src/warp/structural-reading-adapter.ts.
+//
+// Maps Echo contract obstructions into Graft freshness/residual posture per
+// the witness design packet's mapping table. The taxonomy is Echo's
+// ContractObstructionKind [echo crates/warp-core/src/contract_obstruction.rs
+// #17@2048da5c] plus ABI-level observation rights. Not wired into any
+// production context in this slice; tests enforce that.
+// ---------------------------------------------------------------------------
+import { isCborArray } from "./canonical-cbor.js";
+import { DEFAULT_STRUCTURAL_HISTORY_BASIS_ID } from "./structural-history-envelope-codec.js";
+import { EchoSubstrateObstructionError, } from "./structural-history-client.js";
+export const OBSTRUCTION_POSTURE = {
+    STALE_BASIS: { freshness: "stale", residualPosture: "complete" },
+    BUDGET_EXCEEDED: { freshness: "current", residualPosture: "budget-limited" },
+    UNSUPPORTED_OBSERVATION_RIGHTS: {
+        freshness: "current",
+        residualPosture: "rights-limited",
+    },
+    MISSING_RETENTION: { freshness: "incomparable", residualPosture: "unavailable" },
+    RESIDUAL_READING: { freshness: "current", residualPosture: "partial" },
+};
+function mapPosture(obstruction) {
+    if (obstruction === undefined) {
+        return { freshness: "current", residualPosture: "complete" };
+    }
+    const mapped = OBSTRUCTION_POSTURE[obstruction.code];
+    if (mapped === undefined) {
+        throw new EchoSubstrateObstructionError(obstruction);
+    }
+    return mapped;
+}
+function echoNativeEvidence(basisId, record) {
+    return {
+        kind: "continuum-native",
+        evidenceLabel: "echo-native",
+        nativeContinuumWitness: true,
+        envelope: {
+            family: record?.evidence.family ?? "graft-structural-history",
+            readingId: record?.evidence.readingId ?? "reading-unavailable",
+            basis: record?.evidence.basis ?? { basisId },
+        },
+    };
+}
+function textOf(value) {
+    return typeof value === "string" ? value : "";
+}
+function asRecordValue(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return {};
+    }
+    return value;
+}
+function deadSymbolsPayload(record) {
+    const payload = asRecordValue(record?.payloadJson ?? null);
+    const rawSymbols = payload["symbols"] ?? null;
+    const symbols = [];
+    if (isCborArray(rawSymbols)) {
+        for (const raw of rawSymbols) {
+            const entry = asRecordValue(raw);
+            symbols.push({
+                name: textOf(entry["name"]),
+                kind: textOf(entry["kind"]),
+                filePath: textOf(entry["filePath"]),
+                exported: entry["exported"] === true,
+                removedInCommit: textOf(entry["removedInCommit"]),
+            });
+        }
+    }
+    return { symbols, total: symbols.length };
+}
+function symbolReferencePayload(symbolName, record) {
+    const payload = asRecordValue(record?.payloadJson ?? null);
+    const rawFiles = payload["referencingFiles"] ?? null;
+    return {
+        symbol: symbolName,
+        referenceCount: typeof payload["referenceCount"] === "number" ? payload["referenceCount"] : 0,
+        referencingFiles: isCborArray(rawFiles)
+            ? rawFiles.filter((file) => typeof file === "string")
+            : [],
+    };
+}
+export function createEchoStructuralReadingPort(client, options = {}) {
+    const basisId = options.basisId ?? DEFAULT_STRUCTURAL_HISTORY_BASIS_ID;
+    async function observeKind(readingKind) {
+        return client.observeStructuralReadings({ basisId, readingKind });
+    }
+    return {
+        async countSymbolReferences(request) {
+            const observation = await observeKind("SYMBOL_REFERENCE_COUNT");
+            const posture = mapPosture(observation.obstruction);
+            const record = observation.readings.find((candidate) => {
+                const payload = asRecordValue(candidate.payloadJson);
+                return (payload["symbol"] === request.symbolName &&
+                    payload["filePath"] === request.filePath);
+            });
+            return {
+                kind: "symbol-reference-count",
+                freshness: posture.freshness,
+                residualPosture: posture.residualPosture,
+                payload: symbolReferencePayload(request.symbolName, record),
+                evidence: echoNativeEvidence(basisId, record),
+            };
+        },
+        async findDeadSymbols(_request) {
+            const observation = await observeKind("DEAD_SYMBOLS");
+            const posture = mapPosture(observation.obstruction);
+            const record = observation.readings.find((candidate) => candidate.readingKind === "DEAD_SYMBOLS");
+            return {
+                kind: "dead-symbols",
+                freshness: posture.freshness,
+                residualPosture: posture.residualPosture,
+                payload: deadSymbolsPayload(record),
+                evidence: echoNativeEvidence(basisId, record),
+            };
+        },
+    };
+}
+//# sourceMappingURL=structural-reading-adapter.js.map

package/dist/echo/structural-reading-adapter.js.map

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

package/dist/echo/structural-reading-generated-model.d.ts

@@ -0,0 +1,18 @@
+import type { StructuralBasis, StructuralReading, StructuralReadingEvidence as GeneratedStructuralReadingEvidence } from "../generated/graft-structural-history.js";
+import { type StructuralReadingResult } from "../ports/structural-reading.js";
+export type GeneratedModelMappingErrorCode = "ECHO_NATIVE_REFUSED" | "UNSUPPORTED_EVIDENCE_LABEL" | "UNSUPPORTED_READING_KIND" | "UNSUPPORTED_FRESHNESS" | "UNSUPPORTED_RESIDUAL_POSTURE" | "UNSUPPORTED_SUBSTRATE" | "UNSERIALIZABLE_PAYLOAD" | "EVIDENCE_MISMATCH" | "MISSING_PAYLOAD_JSON" | "PAYLOAD_DIGEST_MISMATCH" | "MALFORMED_PAYLOAD" | "MALFORMED_EVIDENCE_SUMMARY";
+export declare class GeneratedModelMappingError extends Error {
+    readonly code: GeneratedModelMappingErrorCode;
+    constructor(code: GeneratedModelMappingErrorCode, message: string);
+}
+export interface StructuralReadingMappingContext {
+    readonly repositoryId: string;
+}
+export interface GeneratedStructuralReadingBundle {
+    readonly reading: StructuralReading;
+    readonly evidence: GeneratedStructuralReadingEvidence;
+    readonly basis: StructuralBasis;
+}
+export declare function toGeneratedStructuralReading<TPayload>(result: StructuralReadingResult<TPayload>, ctx: StructuralReadingMappingContext): GeneratedStructuralReadingBundle;
+export declare function fromGeneratedStructuralReading(reading: StructuralReading, evidence: GeneratedStructuralReadingEvidence): StructuralReadingResult<unknown>;
+//# sourceMappingURL=structural-reading-generated-model.d.ts.map

package/dist/echo/structural-reading-generated-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-reading-generated-model.d.ts","sourceRoot":"","sources":["../../src/echo/structural-reading-generated-model.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAGV,eAAe,EAEf,iBAAiB,EACjB,yBAAyB,IAAI,kCAAkC,EAIhE,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAUL,KAAK,uBAAuB,EAE7B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,8BAA8B,GACtC,qBAAqB,GACrB,4BAA4B,GAC5B,0BAA0B,GAC1B,uBAAuB,GACvB,8BAA8B,GAC9B,uBAAuB,GACvB,wBAAwB,GACxB,mBAAmB,GACnB,sBAAsB,GACtB,yBAAyB,GACzB,mBAAmB,GACnB,4BAA4B,CAAC;AAEjC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;gBAElC,IAAI,EAAE,8BAA8B,EAAE,OAAO,EAAE,MAAM;CAKlE;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,kCAAkC,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AA0OD,wBAAgB,4BAA4B,CAAC,QAAQ,EACnD,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,EACzC,GAAG,EAAE,+BAA+B,GACnC,gCAAgC,CAuHlC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kCAAkC,GAC3C,uBAAuB,CAAC,OAAO,CAAC,CAqFlC"}