@agentplat/mesh 0.3.0-beta.1 → 0.3.0-beta.3

package/dist/overlay-transport.js

@@ -0,0 +1,7 @@
+export * from "./sparse-overlay-contracts.js";
+export * from "./sparse-overlay-runtime-contracts.js";
+export * from "./sparse-overlay-transport-contracts.js";
+export * from "./sparse-overlay-transport.js";
+export * from "./sparse-overlay-transport-durability.js";
+export * from "./authenticated-overlay-transport.js";
+//# sourceMappingURL=overlay-transport.js.map

package/dist/overlay-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-transport.js","sourceRoot":"","sources":["../src/overlay-transport.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC"}

package/dist/overlay.d.ts

@@ -0,0 +1,9 @@
+export * from './sparse-overlay-contracts.js';
+export * from './sparse-overlay.js';
+export * from './sparse-overlay-runtime-contracts.js';
+export * from './sparse-overlay-runtime.js';
+export * from './sparse-overlay-durability.js';
+export * from './sparse-overlay-transport-contracts.js';
+export * from './sparse-overlay-transport.js';
+export * from './sparse-overlay-transport-durability.js';
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uCAAuC,CAAC;AACtD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC"}

package/dist/overlay.js

@@ -0,0 +1,9 @@
+export * from './sparse-overlay-contracts.js';
+export * from './sparse-overlay.js';
+export * from './sparse-overlay-runtime-contracts.js';
+export * from './sparse-overlay-runtime.js';
+export * from './sparse-overlay-durability.js';
+export * from './sparse-overlay-transport-contracts.js';
+export * from './sparse-overlay-transport.js';
+export * from './sparse-overlay-transport-durability.js';
+//# sourceMappingURL=overlay.js.map

package/dist/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uCAAuC,CAAC;AACtD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC"}

package/dist/sparse-overlay-contracts.d.ts

@@ -0,0 +1,91 @@
+/** Closed, interoperable scale profiles for the sparse overlay. */
+export type MeshSparseOverlayProfileIdV2 = 'standard-500' | 'large-5000' | 'frontier-100000';
+export type MeshSparseOverlayDigestV2 = `sha256:${string}`;
+export type MeshSparseOverlayUpdateIdV2 = `overlay-update:${string}`;
+/** Immutable population, topology and resource bounds. */
+export interface MeshSparseOverlayProfileV2 {
+    readonly schemaVersion: 2;
+    readonly profileId: MeshSparseOverlayProfileIdV2;
+    readonly maximumPeers: 500 | 5_000 | 100_000;
+    readonly maximumInteractions: 5_000 | 50_000 | 1_000_000;
+    readonly activeNeighborCount: number;
+    readonly reserveNeighborCount: number;
+    readonly maximumFanout: number;
+    readonly maximumHops: number;
+    readonly maximumRecentUpdates: number;
+    readonly profileDigest: MeshSparseOverlayDigestV2;
+}
+/** One peer's complete bounded routing knowledge. */
+export interface MeshSparsePeerViewV2 {
+    readonly schemaVersion: 2;
+    readonly profileDigest: MeshSparseOverlayDigestV2;
+    readonly topologySeed: number;
+    readonly peerIndex: number;
+    readonly peerId: string;
+    readonly revision: number;
+    readonly activeNeighborIndexes: readonly number[];
+    readonly reserveNeighborIndexes: readonly number[];
+    readonly excludedNeighborIndexes: readonly number[];
+    readonly viewDigest: MeshSparseOverlayDigestV2;
+}
+/** Content-free update identity propagated by the overlay. */
+export interface MeshSparseUpdateV2 {
+    readonly schemaVersion: 2;
+    readonly profileDigest: MeshSparseOverlayDigestV2;
+    readonly updateId: MeshSparseOverlayUpdateIdV2;
+    readonly originPeerIndex: number;
+    readonly originPeerId: string;
+    readonly originSequence: number;
+    readonly topic: string;
+    readonly payloadDigest: MeshSparseOverlayDigestV2;
+    readonly createdAtLogicalTime: number;
+    readonly expiresAtLogicalTime: number;
+    readonly maximumHops: number;
+    readonly updateDigest: MeshSparseOverlayDigestV2;
+}
+/** One transport-agnostic delivery plan in an auditable forwarding chain. */
+export interface MeshSparseDeliveryV2 {
+    readonly schemaVersion: 2;
+    readonly update: MeshSparseUpdateV2;
+    readonly senderPeerIndex: number;
+    readonly recipientPeerIndex: number;
+    readonly hop: number;
+    readonly senderViewDigest: MeshSparseOverlayDigestV2;
+    readonly previousDeliveryDigest: MeshSparseOverlayDigestV2 | null;
+    readonly deliveryDigest: MeshSparseOverlayDigestV2;
+}
+export interface MeshSparseRecentUpdateV2 {
+    readonly updateId: MeshSparseOverlayUpdateIdV2;
+    readonly expiresAtLogicalTime: number;
+}
+/** Construction-bound local routing state; it never contains global state. */
+export interface MeshSparseRoutingStateV2 {
+    readonly schemaVersion: 2;
+    readonly profileDigest: MeshSparseOverlayDigestV2;
+    readonly view: MeshSparsePeerViewV2;
+    readonly recentUpdates: readonly MeshSparseRecentUpdateV2[];
+    readonly nextOriginSequence: number;
+    readonly maximumOutboundInteractions: number;
+    readonly outboundInteractions: number;
+    readonly acceptedRemoteUpdates: number;
+    readonly lastLogicalTime: number;
+    readonly stateDigest: MeshSparseOverlayDigestV2;
+}
+export interface MeshSparsePublishResultV2 {
+    readonly state: MeshSparseRoutingStateV2;
+    readonly update: MeshSparseUpdateV2;
+    readonly deliveries: readonly MeshSparseDeliveryV2[];
+}
+export type MeshSparseReceiveRejectionCodeV2 = 'profile_mismatch' | 'recipient_mismatch' | 'update_expired' | 'hop_limit_exceeded' | 'recent_update_capacity_exceeded';
+export type MeshSparseReceiveResultV2 = {
+    readonly accepted: true;
+    readonly duplicate: boolean;
+    readonly state: MeshSparseRoutingStateV2;
+    readonly deliveries: readonly MeshSparseDeliveryV2[];
+} | {
+    readonly accepted: false;
+    readonly code: MeshSparseReceiveRejectionCodeV2;
+    readonly state: MeshSparseRoutingStateV2;
+    readonly deliveries: readonly [];
+};
+//# sourceMappingURL=sparse-overlay-contracts.d.ts.map

package/dist/sparse-overlay-contracts.d.ts.map

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

package/dist/sparse-overlay-contracts.js

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

package/dist/sparse-overlay-contracts.js.map

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

package/dist/sparse-overlay-durability.d.ts

@@ -0,0 +1,23 @@
+import type { MeshDurableLocalTransitionRepository, MeshDurableScope } from "./durability.js";
+import type { MeshSparsePeerPlaneStateV1, MeshSparsePeerPlaneStoreV1 } from "./sparse-overlay-runtime-contracts.js";
+export declare const MESH_SPARSE_PEER_PLANE_SNAPSHOT_FORMAT_V1: "application/vnd.agentplat.mesh-sparse-peer-plane.v1+json";
+/**
+ * Concrete durable CAS adapter over the mesh local-transition repository.
+ * Use a dedicated scope/instance for this plane; repository snapshots are
+ * single-head and must not share the node business-state scope.
+ */
+export declare class MeshDurableSparsePeerPlaneStoreV1 implements MeshSparsePeerPlaneStoreV1 {
+    #private;
+    constructor(input: {
+        readonly repository: MeshDurableLocalTransitionRepository;
+        readonly scope: MeshDurableScope;
+    });
+    load(overlayId: string): Promise<MeshSparsePeerPlaneStateV1 | undefined>;
+    compareAndSwap(input: {
+        readonly overlayId: string;
+        readonly expectedRevision: number | null;
+        readonly expectedStateDigest: MeshSparsePeerPlaneStateV1["stateDigest"] | null;
+        readonly next: MeshSparsePeerPlaneStateV1;
+    }): Promise<boolean>;
+}
+//# sourceMappingURL=sparse-overlay-durability.d.ts.map

package/dist/sparse-overlay-durability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse-overlay-durability.d.ts","sourceRoot":"","sources":["../src/sparse-overlay-durability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oCAAoC,EAEpC,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAE/C,eAAO,MAAM,yCAAyC,EACpD,0DAAmE,CAAC;AAEtE;;;;GAIG;AACH,qBAAa,iCACX,YAAW,0BAA0B;;gBAKzB,KAAK,EAAE;QACjB,QAAQ,CAAC,UAAU,EAAE,oCAAoC,CAAC;QAC1D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;KAClC;IAWK,IAAI,CACR,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC;IAM5C,cAAc,CAAC,KAAK,EAAE;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QACzC,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QAC/E,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;KAC3C,GAAG,OAAO,CAAC,OAAO,CAAC;CA6CrB"}

package/dist/sparse-overlay-durability.js

@@ -0,0 +1,97 @@
+export const MESH_SPARSE_PEER_PLANE_SNAPSHOT_FORMAT_V1 = "application/vnd.agentplat.mesh-sparse-peer-plane.v1+json";
+/**
+ * Concrete durable CAS adapter over the mesh local-transition repository.
+ * Use a dedicated scope/instance for this plane; repository snapshots are
+ * single-head and must not share the node business-state scope.
+ */
+export class MeshDurableSparsePeerPlaneStoreV1 {
+    #repository;
+    #scope;
+    constructor(input) {
+        if (!input?.repository ||
+            typeof input.repository.loadSnapshot !== "function" ||
+            typeof input.repository.commitLocalTransition !== "function")
+            throw new TypeError("sparse peer plane durable repository is required");
+        this.#repository = input.repository;
+        this.#scope = normalizeScope(input.scope);
+    }
+    async load(overlayId) {
+        identifier(overlayId, "overlayId");
+        const snapshot = await this.#repository.loadSnapshot(this.#scope);
+        return snapshot ? decode(snapshot, overlayId) : undefined;
+    }
+    async compareAndSwap(input) {
+        identifier(input?.overlayId, "overlayId");
+        if (!input.next || input.next.overlayId !== input.overlayId)
+            throw new TypeError("sparse peer plane next state binding is invalid");
+        const snapshot = await this.#repository.loadSnapshot(this.#scope);
+        const current = snapshot ? decode(snapshot, input.overlayId) : undefined;
+        if (input.expectedRevision === null || input.expectedStateDigest === null) {
+            if (input.expectedRevision !== null ||
+                input.expectedStateDigest !== null ||
+                current ||
+                input.next.revision !== 0)
+                return false;
+        }
+        else if (!current ||
+            current.revision !== input.expectedRevision ||
+            current.stateDigest !== input.expectedStateDigest ||
+            input.next.revision !== current.revision + 1) {
+            return false;
+        }
+        const transitionId = `sparse-plane.${input.next.revision}.${input.next.stateDigest.slice(7, 23)}`;
+        const committed = await this.#repository.commitLocalTransition({
+            scope: this.#scope,
+            expectedSnapshotRevision: snapshot?.revision ?? 0,
+            transitionId,
+            nextState: json(input.next),
+            nextStateDescriptor: {
+                format: MESH_SPARSE_PEER_PLANE_SNAPSHOT_FORMAT_V1,
+                schemaVersion: 1,
+            },
+            journal: [
+                {
+                    entryId: transitionId,
+                    kind: input.next.revision === 0
+                        ? "sparse.peer-plane.initialized"
+                        : "sparse.peer-plane.committed",
+                },
+            ],
+            outbox: [],
+        });
+        return committed.committed;
+    }
+}
+function decode(snapshot, overlayId) {
+    if (snapshot.snapshotFormat !== MESH_SPARSE_PEER_PLANE_SNAPSHOT_FORMAT_V1 ||
+        snapshot.snapshotSchemaVersion !== 1 ||
+        !snapshot.state ||
+        typeof snapshot.state !== "object" ||
+        Array.isArray(snapshot.state))
+        throw new TypeError("sparse peer plane durable snapshot is invalid");
+    const state = snapshot.state;
+    if (state.schemaVersion !== 1 || state.overlayId !== overlayId)
+        throw new TypeError("sparse peer plane durable snapshot binding is invalid");
+    return state;
+}
+function json(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function normalizeScope(scope) {
+    if (!scope || typeof scope !== "object")
+        throw new TypeError("sparse peer plane durable scope is required");
+    return Object.freeze({
+        tenantId: identifier(scope.tenantId, "scope.tenantId"),
+        meshId: identifier(scope.meshId, "scope.meshId"),
+        peerId: identifier(scope.peerId, "scope.peerId"),
+        instanceId: identifier(scope.instanceId, "scope.instanceId"),
+    });
+}
+function identifier(value, label) {
+    if (typeof value !== "string" ||
+        value.length > 256 ||
+        !/^[A-Za-z0-9][A-Za-z0-9._:@/-]*$/u.test(value))
+        throw new TypeError(`${label} is invalid`);
+    return value;
+}
+//# sourceMappingURL=sparse-overlay-durability.js.map

package/dist/sparse-overlay-durability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse-overlay-durability.js","sourceRoot":"","sources":["../src/sparse-overlay-durability.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,yCAAyC,GACpD,0DAAmE,CAAC;AAEtE;;;;GAIG;AACH,MAAM,OAAO,iCAAiC;IAGnC,WAAW,CAAuC;IAClD,MAAM,CAAmB;IAElC,YAAY,KAGX;QACC,IACE,CAAC,KAAK,EAAE,UAAU;YAClB,OAAO,KAAK,CAAC,UAAU,CAAC,YAAY,KAAK,UAAU;YACnD,OAAO,KAAK,CAAC,UAAU,CAAC,qBAAqB,KAAK,UAAU;YAE5D,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;QAC1E,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CACR,SAAiB;QAEjB,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClE,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAKpB;QACC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;YACzD,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI,IAAI,KAAK,CAAC,mBAAmB,KAAK,IAAI,EAAE,CAAC;YAC1E,IACE,KAAK,CAAC,gBAAgB,KAAK,IAAI;gBAC/B,KAAK,CAAC,mBAAmB,KAAK,IAAI;gBAClC,OAAO;gBACP,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC;gBAEzB,OAAO,KAAK,CAAC;QACjB,CAAC;aAAM,IACL,CAAC,OAAO;YACR,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,gBAAgB;YAC3C,OAAO,CAAC,WAAW,KAAK,KAAK,CAAC,mBAAmB;YACjD,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,GAAG,CAAC,EAC5C,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,YAAY,GAAG,gBAAgB,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAClG,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC;YAC7D,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,wBAAwB,EAAE,QAAQ,EAAE,QAAQ,IAAI,CAAC;YACjD,YAAY;YACZ,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAC3B,mBAAmB,EAAE;gBACnB,MAAM,EAAE,yCAAyC;gBACjD,aAAa,EAAE,CAAC;aACjB;YACD,OAAO,EAAE;gBACP;oBACE,OAAO,EAAE,YAAY;oBACrB,IAAI,EACF,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC;wBACvB,CAAC,CAAC,+BAA+B;wBACjC,CAAC,CAAC,6BAA6B;iBACpC;aACF;YACD,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,SAAS,MAAM,CACb,QAAiC,EACjC,SAAiB;IAEjB,IACE,QAAQ,CAAC,cAAc,KAAK,yCAAyC;QACrE,QAAQ,CAAC,qBAAqB,KAAK,CAAC;QACpC,CAAC,QAAQ,CAAC,KAAK;QACf,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;QAClC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAE7B,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAA8C,CAAC;IACtE,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAC5D,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,IAAI,CAAC,KAAiC;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAkB,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,KAAuB;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QACrC,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QACtD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC;QAChD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC;QAChD,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,kBAAkB,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,KAAa;IAC/C,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,GAAG,GAAG;QAClB,CAAC,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC;QAE/C,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sparse-overlay-runtime-contracts.d.ts

@@ -0,0 +1,158 @@
+import type { MeshAdaptiveOverlayCertificateV1, MeshAdaptiveOverlayResultV1 } from "./adaptive-overlay-contracts.js";
+import type { MeshSparseDeliveryV2, MeshSparseOverlayDigestV2, MeshSparseOverlayProfileV2, MeshSparsePeerViewV2, MeshSparseRoutingStateV2, MeshSparseUpdateV2 } from "./sparse-overlay-contracts.js";
+export declare const MESH_SPARSE_PEER_PLANE_SCHEMA_VERSION_V1: 1;
+export type MeshSparsePeerAvailabilityV1 = "active" | "suspect" | "departed";
+/** One bounded membership projection. It may contain only requested local-view peers. */
+export interface MeshSparseMembershipPeerV1 {
+    readonly peerIndex: number;
+    readonly peerId: string;
+    readonly availability: MeshSparsePeerAvailabilityV1;
+}
+export interface MeshSparseMembershipSliceV1 {
+    readonly schemaVersion: 1;
+    readonly overlayId: string;
+    readonly membershipDigest: MeshSparseOverlayDigestV2;
+    readonly observedAtLogicalTime: number;
+    readonly validUntilLogicalTime: number;
+    readonly peers: readonly MeshSparseMembershipPeerV1[];
+}
+export interface MeshSparseMembershipPortV1 {
+    /** Must return no peer outside `peerIndexes`; callers never request a global graph. */
+    resolve(input: {
+        readonly overlayId: string;
+        readonly membershipDigest: MeshSparseOverlayDigestV2;
+        readonly peerIndexes: readonly number[];
+        readonly logicalTime: number;
+    }): Promise<MeshSparseMembershipSliceV1>;
+}
+export interface MeshSparseMembershipCatchUpPortV1 {
+    /** Refreshes a lagging local projection of the same membership configuration. */
+    catchUp(input: {
+        readonly overlayId: string;
+        readonly membershipDigest: MeshSparseOverlayDigestV2;
+        readonly requiredPeerIndexes: readonly number[];
+        readonly logicalTime: number;
+    }): Promise<boolean>;
+}
+/** Narrow application surface implemented by MeshAdaptiveOverlayRuntimeV1. */
+export interface MeshSparseAdaptiveOverlayApplicationPortV1 {
+    apply(input: {
+        readonly certificate: MeshAdaptiveOverlayCertificateV1;
+        readonly profile: MeshSparseOverlayProfileV2;
+        readonly view: MeshSparsePeerViewV2;
+        /** Fences a new application; exact already-applied certificate replay is duplicate. */
+        readonly expectedRevision: number;
+        readonly logicalTimeMs: number;
+    }): Promise<MeshAdaptiveOverlayResultV1>;
+}
+export interface MeshSparsePendingDeliveryV1 {
+    readonly delivery: MeshSparseDeliveryV2;
+    readonly queuedAtLogicalTime: number;
+}
+export interface MeshSparsePendingUpdateV1 {
+    readonly update: MeshSparseUpdateV2;
+    readonly admittedAtLogicalTime: number;
+}
+/** Durable local state. It contains one sparse view, never collective-wide topology. */
+export interface MeshSparsePeerPlaneStateV1 {
+    readonly schemaVersion: 1;
+    readonly overlayId: string;
+    readonly revision: number;
+    readonly membershipDigest: MeshSparseOverlayDigestV2;
+    readonly profile: MeshSparseOverlayProfileV2;
+    readonly routing: MeshSparseRoutingStateV2;
+    readonly pendingDeliveries: readonly MeshSparsePendingDeliveryV1[];
+    readonly pendingUpdates: readonly MeshSparsePendingUpdateV1[];
+    readonly lastLogicalTime: number;
+    readonly stateDigest: MeshSparseOverlayDigestV2;
+}
+/** Implementations must provide durable compare-and-swap for one local peer. */
+export interface MeshSparsePeerPlaneStoreV1 {
+    load(overlayId: string): Promise<MeshSparsePeerPlaneStateV1 | undefined>;
+    compareAndSwap(input: {
+        readonly overlayId: string;
+        readonly expectedRevision: number | null;
+        readonly expectedStateDigest: MeshSparseOverlayDigestV2 | null;
+        readonly next: MeshSparsePeerPlaneStateV1;
+    }): Promise<boolean>;
+}
+export type MeshSparseDurableAdmissionV1 = {
+    readonly status: "admitted" | "duplicate";
+} | {
+    readonly status: "backpressured";
+    readonly reasonCode: string;
+} | {
+    readonly status: "rejected";
+    readonly reasonCode: string;
+};
+/** Durable, idempotent next-hop queue keyed by deliveryDigest. */
+export interface MeshSparseDeliveryQueuePortV1 {
+    pending(recipientPeerId: string): number | Promise<number>;
+    enqueue(input: {
+        readonly overlayId: string;
+        readonly recipient: MeshSparseMembershipPeerV1;
+        readonly delivery: MeshSparseDeliveryV2;
+    }): Promise<MeshSparseDurableAdmissionV1>;
+}
+/** Durable, idempotent local announcement inbox keyed by updateId. */
+export interface MeshSparseUpdateAdmissionPortV1 {
+    pending(topic: string): number | Promise<number>;
+    admit(input: {
+        readonly overlayId: string;
+        readonly update: MeshSparseUpdateV2;
+    }): Promise<MeshSparseDurableAdmissionV1>;
+}
+export interface MeshSparsePeerPlaneLimitsV1 {
+    readonly maximumPendingDeliveries: number;
+    readonly maximumPendingUpdates: number;
+    readonly maximumPendingPerNeighbor: number;
+    readonly maximumPendingPerTopic: number;
+    readonly maximumDrainItems: number;
+    readonly maximumCommitAttempts: number;
+}
+export interface MeshSparsePeerPlaneOptionsV1 {
+    readonly overlayId: string;
+    readonly profile: MeshSparseOverlayProfileV2;
+    readonly topologySeed: number;
+    readonly localPeerIndex: number;
+    readonly membershipDigest: MeshSparseOverlayDigestV2;
+    readonly store: MeshSparsePeerPlaneStoreV1;
+    readonly membership: MeshSparseMembershipPortV1;
+    readonly deliveryQueue: MeshSparseDeliveryQueuePortV1;
+    readonly updateAdmission: MeshSparseUpdateAdmissionPortV1;
+    readonly membershipCatchUp?: MeshSparseMembershipCatchUpPortV1;
+    readonly adaptive?: MeshSparseAdaptiveOverlayApplicationPortV1;
+    readonly limits?: Partial<MeshSparsePeerPlaneLimitsV1>;
+}
+export type MeshSparseTopologyFreshnessV1 = "fresh" | "stale" | "unknown";
+export interface MeshSparsePeerPlaneDrainResultV1 {
+    readonly attempted: number;
+    readonly admitted: number;
+    readonly backpressured: number;
+    readonly rejected: number;
+    readonly remaining: number;
+}
+export interface MeshSparsePeerPlanePublishResultV1 {
+    readonly update: MeshSparseUpdateV2;
+    readonly state: MeshSparsePeerPlaneStateV1;
+    readonly drain: MeshSparsePeerPlaneDrainResultV1;
+}
+export interface MeshSparsePeerPlaneReceiveResultV1 {
+    readonly accepted: boolean;
+    readonly duplicate: boolean;
+    readonly reasonCode: string | null;
+    readonly state: MeshSparsePeerPlaneStateV1;
+    readonly drain: MeshSparsePeerPlaneDrainResultV1;
+}
+export interface MeshSparsePeerPlaneAdaptationResultV1 {
+    readonly adaptation: MeshAdaptiveOverlayResultV1;
+    readonly state: MeshSparsePeerPlaneStateV1;
+}
+export interface MeshSparsePeerPlaneAdaptivePortV1 {
+    applyAdaptation(input: {
+        readonly certificate: MeshAdaptiveOverlayCertificateV1;
+        readonly expectedRevision: number;
+        readonly logicalTime: number;
+    }): Promise<MeshSparsePeerPlaneAdaptationResultV1>;
+}
+//# sourceMappingURL=sparse-overlay-runtime-contracts.d.ts.map

package/dist/sparse-overlay-runtime-contracts.d.ts.map

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

package/dist/sparse-overlay-runtime-contracts.js

@@ -0,0 +1,2 @@
+export const MESH_SPARSE_PEER_PLANE_SCHEMA_VERSION_V1 = 1;
+//# sourceMappingURL=sparse-overlay-runtime-contracts.js.map

package/dist/sparse-overlay-runtime-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparse-overlay-runtime-contracts.js","sourceRoot":"","sources":["../src/sparse-overlay-runtime-contracts.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAU,CAAC"}

package/dist/sparse-overlay-runtime.d.ts

@@ -0,0 +1,48 @@
+import type { MeshAdaptiveOverlayCertificateV1 } from "./adaptive-overlay-contracts.js";
+import type { MeshSparseDeliveryV2, MeshSparseOverlayDigestV2 } from "./sparse-overlay-contracts.js";
+import type { MeshSparsePeerPlaneAdaptationResultV1, MeshSparsePeerPlaneDrainResultV1, MeshSparsePeerPlaneOptionsV1, MeshSparsePeerPlanePublishResultV1, MeshSparsePeerPlaneReceiveResultV1, MeshSparsePeerPlaneStateV1, MeshSparseTopologyFreshnessV1 } from "./sparse-overlay-runtime-contracts.js";
+interface MeshSparsePeerPlaneRuntimeInvokersV1 {
+    readonly restore: (logicalTime?: number) => Promise<MeshSparsePeerPlaneStateV1>;
+    readonly publish: (input: {
+        readonly topic: string;
+        readonly payloadDigest: MeshSparseOverlayDigestV2;
+        readonly logicalTime: number;
+        readonly lifetime: number;
+        readonly fanout?: number;
+    }) => Promise<MeshSparsePeerPlanePublishResultV1>;
+    readonly receive: (input: {
+        readonly delivery: MeshSparseDeliveryV2;
+        readonly logicalTime: number;
+    }) => Promise<MeshSparsePeerPlaneReceiveResultV1>;
+    readonly drain: (input: {
+        readonly logicalTime: number;
+        readonly maximumItems?: number;
+    }) => Promise<MeshSparsePeerPlaneDrainResultV1>;
+    readonly topologyFreshness: (logicalTime: number) => Promise<MeshSparseTopologyFreshnessV1>;
+    readonly catchUpMembership: (logicalTime: number) => Promise<boolean>;
+    readonly applyAdaptation: (input: {
+        readonly certificate: MeshAdaptiveOverlayCertificateV1;
+        readonly expectedRevision: number;
+        readonly logicalTime: number;
+    }) => Promise<MeshSparsePeerPlaneAdaptationResultV1>;
+}
+/** Durable peer-local execution path for sparse selection, deduplication and forwarding. */
+export declare class MeshSparsePeerPlaneRuntimeV1 {
+    #private;
+    readonly restore: MeshSparsePeerPlaneRuntimeInvokersV1["restore"];
+    readonly publish: MeshSparsePeerPlaneRuntimeInvokersV1["publish"];
+    readonly receive: MeshSparsePeerPlaneRuntimeInvokersV1["receive"];
+    readonly drain: MeshSparsePeerPlaneRuntimeInvokersV1["drain"];
+    readonly topologyFreshness: MeshSparsePeerPlaneRuntimeInvokersV1["topologyFreshness"];
+    readonly catchUpMembership: MeshSparsePeerPlaneRuntimeInvokersV1["catchUpMembership"];
+    readonly applyAdaptation: MeshSparsePeerPlaneRuntimeInvokersV1["applyAdaptation"];
+    constructor(options: MeshSparsePeerPlaneOptionsV1);
+}
+/** Nominal check for the module-owned sparse peer plane runtime. */
+export declare function isMeshSparsePeerPlaneRuntimeV1(value: unknown): value is MeshSparsePeerPlaneRuntimeV1;
+/** Invokes the construction-time publish implementation. */
+export declare function invokeMeshSparsePeerPlanePublishV1(runtime: MeshSparsePeerPlaneRuntimeV1, input: Parameters<MeshSparsePeerPlaneRuntimeInvokersV1["publish"]>[0]): Promise<MeshSparsePeerPlanePublishResultV1>;
+/** Invokes the construction-time sparse admission implementation. */
+export declare function invokeMeshSparsePeerPlaneReceiveV1(runtime: MeshSparsePeerPlaneRuntimeV1, input: Parameters<MeshSparsePeerPlaneRuntimeInvokersV1["receive"]>[0]): Promise<MeshSparsePeerPlaneReceiveResultV1>;
+export {};
+//# sourceMappingURL=sparse-overlay-runtime.d.ts.map

package/dist/sparse-overlay-runtime.d.ts.map

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