@orqenix/mesh-transport-core 0.6.0-phase-6

package/LICENSE

@@ -0,0 +1,19 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2026 Milo Nguyen and Orqenix contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+[Full Apache 2.0 text: include verbatim from https://www.apache.org/licenses/LICENSE-2.0.txt]

package/README.md

@@ -0,0 +1,7 @@
+# @orqenix/mesh-transport-core
+
+Transport-agnostic foundation for the Orqenix mesh.
+
+Provides the `MeshTransport` interface, canonical msgpack envelope (`MeshRequest`/`MeshResponse`), `TransportRegistry`, lifecycle state machine, typed error taxonomy, and a `LoopbackTransport` reference implementation.
+
+Part of [Phase 6](https://github.com/milosaysyolo/Orqenix/tree/main/docs/cr-v7.2/chapter-2-transport-abstraction.md). No HTTP or libp2p code lives here; those land in subsequent parts.

package/dist/canonical.d.ts

@@ -0,0 +1,3 @@
+export declare function canonicalize<T>(value: T): T;
+export declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAgB3C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMhE"}

package/dist/canonical.js

@@ -0,0 +1,29 @@
+export function canonicalize(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (value instanceof Uint8Array)
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((v) => canonicalize(v));
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const sortedKeys = Object.keys(obj).sort();
+        const out = {};
+        for (const k of sortedKeys) {
+            out[k] = canonicalize(obj[k]);
+        }
+        return out;
+    }
+    return value;
+}
+export function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAiB,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,GAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAa,EAAE,CAAa;IACrD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/envelope.d.ts

@@ -0,0 +1,13 @@
+import type { MeshRequest, MeshResponse } from './types.js';
+/** Generate a new ULID request id. */
+export declare function newRequestId(): string;
+/** Structural validation for a MeshRequest. Cheap and synchronous. */
+export declare function validateRequest(req: MeshRequest): void;
+export declare function validateResponse(resp: MeshResponse): void;
+export declare function encodeRequest(req: MeshRequest): Uint8Array;
+export declare function decodeRequest(buf: Uint8Array): MeshRequest;
+export declare function encodeResponse(resp: MeshResponse): Uint8Array;
+export declare function decodeResponse(buf: Uint8Array): MeshResponse;
+/** Byte-equality helper for tests. */
+export { bytesEqual } from './canonical.js';
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAa5D,sCAAsC;AACtC,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAqBD,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAgBtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAMzD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CAI1D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,CAI1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAI7D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAI5D;AAED,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/envelope.js

@@ -0,0 +1,92 @@
+// packages/mesh-transport-core/src/envelope.ts
+/**
+ * Canonical msgpack envelope encode/decode.
+ * Agent note: encoding rules per CR v7.2 Chapter 2.3: sorted keys, smallest int width,
+ * binary as bin family, no floats. Encoded output must be byte-stable for equal inputs.
+ */
+import { Packr, Unpackr } from 'msgpackr';
+import { ulid } from 'ulidx';
+import { canonicalize } from './canonical.js';
+const packr = new Packr({
+    useRecords: false,
+    variableMapSize: true,
+    encodeUndefinedAsNil: true,
+});
+const unpackr = new Unpackr({
+    useRecords: false,
+});
+/** Generate a new ULID request id. */
+export function newRequestId() {
+    return ulid();
+}
+/** Reject any object containing non-integer numeric values. Envelope fields are integer or string. */
+function assertNoFloats(value, path = '$') {
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || !Number.isInteger(value)) {
+            throw new Error(`envelope: non-integer number at ${path}`);
+        }
+        return;
+    }
+    if (value === null || typeof value !== 'object')
+        return;
+    if (value instanceof Uint8Array)
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((v, i) => assertNoFloats(v, `${path}[${i}]`));
+        return;
+    }
+    for (const [k, v] of Object.entries(value)) {
+        assertNoFloats(v, `${path}.${k}`);
+    }
+}
+/** Structural validation for a MeshRequest. Cheap and synchronous. */
+export function validateRequest(req) {
+    if (!req || typeof req !== 'object')
+        throw new Error('envelope: request not an object');
+    for (const k of ['id', 'fromScope', 'toScope', 'capability', 'method']) {
+        if (typeof req[k] !== 'string' || req[k].length === 0) {
+            throw new Error(`envelope: field ${k} missing or empty`);
+        }
+    }
+    if (!(req.payload instanceof Uint8Array)) {
+        throw new Error('envelope: payload must be Uint8Array');
+    }
+    if (!Number.isInteger(req.deadlineMs) || req.deadlineMs <= 0) {
+        throw new Error('envelope: deadlineMs must be a positive integer');
+    }
+    if (!req.trace || typeof req.trace.traceparent !== 'string') {
+        throw new Error('envelope: trace.traceparent missing');
+    }
+}
+export function validateResponse(resp) {
+    if (!resp || typeof resp !== 'object')
+        throw new Error('envelope: response not an object');
+    if (typeof resp.id !== 'string' || resp.id.length === 0)
+        throw new Error('envelope: response.id missing');
+    if (!['ok', 'denied', 'error', 'timeout'].includes(resp.status)) {
+        throw new Error('envelope: response.status not in enum');
+    }
+}
+export function encodeRequest(req) {
+    validateRequest(req);
+    assertNoFloats(req);
+    return packr.pack(canonicalize(req));
+}
+export function decodeRequest(buf) {
+    const obj = unpackr.unpack(buf);
+    validateRequest(obj);
+    return obj;
+}
+export function encodeResponse(resp) {
+    validateResponse(resp);
+    assertNoFloats(resp);
+    return packr.pack(canonicalize(resp));
+}
+export function decodeResponse(buf) {
+    const obj = unpackr.unpack(buf);
+    validateResponse(obj);
+    return obj;
+}
+/** Byte-equality helper for tests. */
+export { bytesEqual } from './canonical.js';
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Typed error taxonomy and error-to-MeshResponse mapping.
+ * Agent note: messages must be sanitized; no stack frames or filesystem paths.
+ */
+import type { MeshResponse } from './types.js';
+export declare const ErrorCode: {
+    readonly TRANSPORT: "E_TRANSPORT";
+    readonly TIMEOUT: "E_TIMEOUT";
+    readonly HANDLER: "E_HANDLER";
+    readonly UNKNOWN: "E_UNKNOWN";
+    readonly CAP_MISSING: "E_CAP_MISSING";
+    readonly CAP_MALFORMED: "E_CAP_MALFORMED";
+    readonly CAP_INVALID: "E_CAP_INVALID";
+    readonly CAP_SIG_INVALID: "E_CAP_SIG_INVALID";
+    readonly CAP_EXPIRED: "E_CAP_EXPIRED";
+    readonly CAP_SUBJECT_MISMATCH: "E_CAP_SUBJECT_MISMATCH";
+    readonly CAP_ISSUER_MISMATCH: "E_CAP_ISSUER_MISMATCH";
+    readonly CAP_METHOD_NOT_ALLOWED: "E_CAP_METHOD_NOT_ALLOWED";
+    readonly IDENTITY_SIG_INVALID: "E_IDENTITY_SIG_INVALID";
+    readonly ENVELOPE_MISMATCH: "E_ENVELOPE_MISMATCH";
+    readonly ILLEGAL_STATE: "E_ILLEGAL_STATE";
+};
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+export declare class TransportError extends Error {
+    readonly code: ErrorCodeValue;
+    constructor(message: string, code?: ErrorCodeValue);
+}
+export declare class CapabilityError extends Error {
+    readonly code: ErrorCodeValue;
+    constructor(message: string, code?: ErrorCodeValue);
+}
+export declare class DeadlineExceeded extends Error {
+    readonly code: "E_TIMEOUT";
+    constructor(message?: string);
+}
+export declare class HandlerError extends Error {
+    readonly code: "E_HANDLER";
+    constructor(message: string);
+}
+export declare class IllegalStateError extends Error {
+    readonly code: "E_ILLEGAL_STATE";
+    constructor(message: string);
+}
+/** Map a thrown error into a MeshResponse with the correct status and a sanitized message. */
+export declare function toMeshResponse(id: string, err: unknown): MeshResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAE3D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;CAgBZ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAoC;CAKxE;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAsC;CAK1E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,cAAqB;gBACtB,OAAO,SAAsB;CAI1C;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,cAAqB;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,oBAA2B;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAUD,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,YAAY,CAkCrE"}

package/dist/errors.js

@@ -0,0 +1,101 @@
+export const ErrorCode = {
+    TRANSPORT: 'E_TRANSPORT',
+    TIMEOUT: 'E_TIMEOUT',
+    HANDLER: 'E_HANDLER',
+    UNKNOWN: 'E_UNKNOWN',
+    CAP_MISSING: 'E_CAP_MISSING',
+    CAP_MALFORMED: 'E_CAP_MALFORMED',
+    CAP_INVALID: 'E_CAP_INVALID',
+    CAP_SIG_INVALID: 'E_CAP_SIG_INVALID',
+    CAP_EXPIRED: 'E_CAP_EXPIRED',
+    CAP_SUBJECT_MISMATCH: 'E_CAP_SUBJECT_MISMATCH',
+    CAP_ISSUER_MISMATCH: 'E_CAP_ISSUER_MISMATCH',
+    CAP_METHOD_NOT_ALLOWED: 'E_CAP_METHOD_NOT_ALLOWED',
+    IDENTITY_SIG_INVALID: 'E_IDENTITY_SIG_INVALID',
+    ENVELOPE_MISMATCH: 'E_ENVELOPE_MISMATCH',
+    ILLEGAL_STATE: 'E_ILLEGAL_STATE',
+};
+export class TransportError extends Error {
+    code;
+    constructor(message, code = ErrorCode.TRANSPORT) {
+        super(message);
+        this.name = 'TransportError';
+        this.code = code;
+    }
+}
+export class CapabilityError extends Error {
+    code;
+    constructor(message, code = ErrorCode.CAP_INVALID) {
+        super(message);
+        this.name = 'CapabilityError';
+        this.code = code;
+    }
+}
+export class DeadlineExceeded extends Error {
+    code = ErrorCode.TIMEOUT;
+    constructor(message = 'deadline exceeded') {
+        super(message);
+        this.name = 'DeadlineExceeded';
+    }
+}
+export class HandlerError extends Error {
+    code = ErrorCode.HANDLER;
+    constructor(message) {
+        super(message);
+        this.name = 'HandlerError';
+    }
+}
+export class IllegalStateError extends Error {
+    code = ErrorCode.ILLEGAL_STATE;
+    constructor(message) {
+        super(message);
+        this.name = 'IllegalStateError';
+    }
+}
+/** Strip stack frames and filesystem paths from a free-form message. */
+function sanitize(msg) {
+    // Remove anything that looks like a stack frame: "at foo (path:line)" or "/abs/path.ts"
+    const noFrames = msg.replace(/\s*at\s+\S+\s*\([^)]*\)/g, '');
+    const noPaths = noFrames.replace(/(?:\/|\\)[\w./\\-]+\.(?:ts|js|mjs|cjs)/g, '<file>');
+    return noPaths.split('\n')[0].trim().slice(0, 256);
+}
+/** Map a thrown error into a MeshResponse with the correct status and a sanitized message. */
+export function toMeshResponse(id, err) {
+    let status = 'error';
+    let code = ErrorCode.UNKNOWN;
+    let raw = 'unknown error';
+    if (err instanceof CapabilityError) {
+        status = 'denied';
+        code = err.code;
+        raw = err.message;
+    }
+    else if (err instanceof DeadlineExceeded) {
+        status = 'timeout';
+        code = err.code;
+        raw = err.message;
+    }
+    else if (err instanceof HandlerError) {
+        status = 'error';
+        code = err.code;
+        raw = err.message;
+    }
+    else if (err instanceof TransportError) {
+        status = 'error';
+        code = err.code;
+        raw = err.message;
+    }
+    else if (err instanceof IllegalStateError) {
+        status = 'error';
+        code = err.code;
+        raw = err.message;
+    }
+    else if (err instanceof Error) {
+        raw = err.message;
+    }
+    return {
+        id,
+        status,
+        error: { code, message: sanitize(raw) },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './envelope.js';
+export * from './state-machine.js';
+export * from './registry.js';
+export * from './loopback.js';
+export * from './canonical.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// packages/mesh-transport-core/src/index.ts
+export * from './types.js';
+export * from './errors.js';
+export * from './envelope.js';
+export * from './state-machine.js';
+export * from './registry.js';
+export * from './loopback.js';
+export * from './canonical.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/loopback.d.ts

@@ -0,0 +1,17 @@
+import type { MeshAddress, MeshRequest, MeshResponse, MeshTransport, PeerInfo, ScopeId, SendOpts, TransportCtx } from './types.js';
+type Handler = (req: MeshRequest, ctx: TransportCtx) => Promise<MeshResponse>;
+export declare class LoopbackTransport implements MeshTransport {
+    readonly kind: "loopback";
+    readonly localScopeId: ScopeId;
+    private lifecycle;
+    private handler?;
+    private connectedAt;
+    constructor(localScopeId: ScopeId);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    onRequest(handler: Handler): void;
+    send(target: MeshAddress, req: MeshRequest, opts?: SendOpts): Promise<MeshResponse>;
+    peers(): PeerInfo[];
+}
+export {};
+//# sourceMappingURL=loopback.d.ts.map

package/dist/loopback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopback.d.ts","sourceRoot":"","sources":["../src/loopback.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAK9E,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,WAAW,CAAK;gBAEZ,YAAY,EAAE,OAAO;IAI3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ3B,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IA0BzF,KAAK,IAAI,QAAQ,EAAE;CAapB"}

package/dist/loopback.js

@@ -0,0 +1,117 @@
+// packages/mesh-transport-core/src/loopback.ts
+/**
+ * LoopbackTransport: in-process reference implementation.
+ * Agent note: NOT a production transport. Used as a test harness and as a worked
+ * example for Parts 2 to 4. It connects two local scopes through a shared in-process bus.
+ */
+import { TransportLifecycle } from './state-machine.js';
+import { DeadlineExceeded, IllegalStateError, toMeshResponse } from './errors.js';
+/** Shared in-process bus keyed by ScopeId. */
+const BUS = new Map();
+export class LoopbackTransport {
+    kind = 'loopback';
+    localScopeId;
+    lifecycle = new TransportLifecycle();
+    handler;
+    connectedAt = 0;
+    constructor(localScopeId) {
+        this.localScopeId = localScopeId;
+    }
+    async start() {
+        if (!this.lifecycle.assertCanStart())
+            return; // idempotent
+        this.lifecycle.transition('Starting');
+        try {
+            // Register on the bus only if a handler has been provided. If not yet,
+            // we still go Running and register lazily in onRequest().
+            if (this.handler)
+                BUS.set(this.localScopeId, this.handler);
+            this.connectedAt = Date.now();
+            this.lifecycle.transition('Running');
+        }
+        catch (e) {
+            this.lifecycle.transition('Failed');
+            throw e;
+        }
+    }
+    async stop() {
+        if (!this.lifecycle.assertCanStop())
+            return; // idempotent
+        this.lifecycle.transition('Stopping');
+        try {
+            BUS.delete(this.localScopeId);
+            this.handler = undefined;
+            this.connectedAt = 0;
+        }
+        finally {
+            this.lifecycle.transition('Stopped');
+        }
+    }
+    onRequest(handler) {
+        this.lifecycle.assertCanRegisterHandler();
+        this.handler = handler;
+        if (this.lifecycle.state === 'Running') {
+            BUS.set(this.localScopeId, handler);
+        }
+    }
+    async send(target, req, opts) {
+        this.lifecycle.assertCanSend();
+        if (target.kind !== 'loopback') {
+            return toMeshResponse(req.id, new IllegalStateError(`loopback cannot reach ${target.kind}`));
+        }
+        const peerHandler = BUS.get(target.scopeId);
+        if (!peerHandler) {
+            return toMeshResponse(req.id, new IllegalStateError('peer not present on loopback bus'));
+        }
+        const ctx = {
+            authenticatedScope: req.fromScope, // loopback trusts in-process identity (test only)
+            peerId: 'loopback',
+            remoteAddr: 'inproc',
+        };
+        const deadlineDelta = Math.max(0, req.deadlineMs - Date.now());
+        const perAttemptMs = Math.min(deadlineDelta, opts?.timeoutMs ?? deadlineDelta);
+        try {
+            return await raceWithDeadline(peerHandler(req, ctx), perAttemptMs, opts?.signal);
+        }
+        catch (e) {
+            return toMeshResponse(req.id, e);
+        }
+    }
+    peers() {
+        if (this.lifecycle.state !== 'Running')
+            return [];
+        const list = [];
+        for (const scopeId of BUS.keys()) {
+            if (scopeId === this.localScopeId)
+                continue;
+            list.push({
+                scopeId,
+                transport: 'loopback',
+                connectedAt: this.connectedAt,
+            });
+        }
+        return list;
+    }
+}
+function raceWithDeadline(p, ms, signal) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(() => reject(new DeadlineExceeded()), Math.max(0, ms));
+        const onAbort = () => {
+            clearTimeout(t);
+            reject(new DeadlineExceeded('aborted'));
+        };
+        if (signal) {
+            if (signal.aborted)
+                return onAbort();
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+        p.then((v) => {
+            clearTimeout(t);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(t);
+            reject(e);
+        });
+    });
+}
+//# sourceMappingURL=loopback.js.map

package/dist/loopback.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DefaultTransportRegistry implements TransportRegistry.
+ * Agent note: this class is the seam for a future Pro-only Rust accelerator
+ * (rust-libp2p via NAPI-RS) at Phase 7+. Do not embed transport-specific logic here.
+ */
+import type { MeshTransport, ScopeId, TransportRegistry } from './types.js';
+export declare class DefaultTransportRegistry implements TransportRegistry {
+    private entries;
+    private counter;
+    register(t: MeshTransport): void;
+    unregister(kind: string): void;
+    get(kind: string): MeshTransport | undefined;
+    all(): MeshTransport[];
+    /**
+     * Return transports that can currently reach `scopeId`.
+     * Phase 6 Part 1 returns all registered transports; richer reachability
+     * (peer membership, circuit breaker filtering) lands with Parts 5 and 9.
+     * Ordering is deterministic: by transport kind ascending, then registration order.
+     */
+    reachable(_scopeId: ScopeId): MeshTransport[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAO5E,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAK;IAEpB,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAOhC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C,GAAG,IAAI,aAAa,EAAE;IAMtB;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,aAAa,EAAE;CAS9C"}

package/dist/registry.js

@@ -0,0 +1,38 @@
+export class DefaultTransportRegistry {
+    entries = new Map();
+    counter = 0;
+    register(t) {
+        if (this.entries.has(t.kind)) {
+            throw new Error(`transport already registered: ${t.kind}`);
+        }
+        this.entries.set(t.kind, { transport: t, order: this.counter++ });
+    }
+    unregister(kind) {
+        this.entries.delete(kind);
+    }
+    get(kind) {
+        return this.entries.get(kind)?.transport;
+    }
+    all() {
+        return [...this.entries.values()]
+            .sort((a, b) => a.order - b.order)
+            .map((e) => e.transport);
+    }
+    /**
+     * Return transports that can currently reach `scopeId`.
+     * Phase 6 Part 1 returns all registered transports; richer reachability
+     * (peer membership, circuit breaker filtering) lands with Parts 5 and 9.
+     * Ordering is deterministic: by transport kind ascending, then registration order.
+     */
+    reachable(_scopeId) {
+        return [...this.entries.values()]
+            .sort((a, b) => {
+            const byKind = a.transport.kind.localeCompare(b.transport.kind);
+            if (byKind !== 0)
+                return byKind;
+            return a.order - b.order;
+        })
+            .map((e) => e.transport);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,wBAAwB;IAC3B,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,OAAO,GAAG,CAAC,CAAC;IAEpB,QAAQ,CAAC,CAAgB;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC3C,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,QAAiB;QACzB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChE,IAAI,MAAM,KAAK,CAAC;gBAAE,OAAO,MAAM,CAAC;YAChC,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAC3B,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/state-machine.d.ts

@@ -0,0 +1,13 @@
+export type TransportState = 'Created' | 'Starting' | 'Running' | 'Stopping' | 'Stopped' | 'Failed';
+export declare class TransportLifecycle {
+    private _state;
+    get state(): TransportState;
+    transition(next: TransportState): void;
+    /** start() is idempotent on Running; allowed on Created/Stopped. */
+    assertCanStart(): boolean;
+    /** stop() is idempotent on Stopped/Stopping; allowed almost anywhere else. */
+    assertCanStop(): boolean;
+    assertCanSend(): void;
+    assertCanRegisterHandler(): void;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAWb,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA6B;IAE3C,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAUtC,oEAAoE;IACpE,cAAc,IAAI,OAAO;IAMzB,8EAA8E;IAC9E,aAAa,IAAI,OAAO;IAKxB,aAAa,IAAI,IAAI;IAMrB,wBAAwB,IAAI,IAAI;CAKjC"}

package/dist/state-machine.js

@@ -0,0 +1,52 @@
+// packages/mesh-transport-core/src/state-machine.ts
+/**
+ * Transport lifecycle state machine per CR v7.2 Chapter 2.4.
+ * Agent note: this is the single place where state transitions are guarded.
+ */
+import { IllegalStateError } from './errors.js';
+const ALLOWED = {
+    Created: ['Starting', 'Stopped'],
+    Starting: ['Running', 'Failed', 'Stopping'],
+    Running: ['Stopping', 'Failed'],
+    Stopping: ['Stopped'],
+    Stopped: ['Starting'],
+    Failed: ['Stopping'],
+};
+export class TransportLifecycle {
+    _state = 'Created';
+    get state() {
+        return this._state;
+    }
+    transition(next) {
+        const allowed = ALLOWED[this._state];
+        if (!allowed.includes(next)) {
+            throw new IllegalStateError(`illegal transport transition: ${this._state} -> ${next}`);
+        }
+        this._state = next;
+    }
+    /** start() is idempotent on Running; allowed on Created/Stopped. */
+    assertCanStart() {
+        if (this._state === 'Running' || this._state === 'Starting')
+            return false; // no-op
+        if (this._state === 'Created' || this._state === 'Stopped')
+            return true;
+        throw new IllegalStateError(`cannot start in state ${this._state}`);
+    }
+    /** stop() is idempotent on Stopped/Stopping; allowed almost anywhere else. */
+    assertCanStop() {
+        if (this._state === 'Stopped' || this._state === 'Stopping')
+            return false; // no-op
+        return true;
+    }
+    assertCanSend() {
+        if (this._state !== 'Running') {
+            throw new IllegalStateError(`cannot send in state ${this._state}`);
+        }
+    }
+    assertCanRegisterHandler() {
+        if (this._state === 'Stopping') {
+            throw new IllegalStateError(`cannot register handler in state Stopping`);
+        }
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUhD,MAAM,OAAO,GAA0D;IACrE,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IAChC,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC/B,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,MAAM,EAAE,CAAC,UAAU,CAAC;CACrB,CAAC;AAEF,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAmB,SAAS,CAAC;IAE3C,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,IAAoB;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,iBAAiB,CACzB,iCAAiC,IAAI,CAAC,MAAM,OAAO,IAAI,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,oEAAoE;IACpE,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC,CAAC,QAAQ;QACnF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACxE,MAAM,IAAI,iBAAiB,CAAC,yBAAyB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,8EAA8E;IAC9E,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC,CAAC,QAAQ;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,iBAAiB,CAAC,wBAAwB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,wBAAwB;QACtB,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,iBAAiB,CAAC,2CAA2C,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Public type surface for the transport-agnostic mesh layer.
+ * Agent note: this file is API-stable. Adding fields requires a CR amendment.
+ */
+/** Branded scope identifier (BLAKE3 of scope Ed25519 public key, base32). */
+export type ScopeId = string & {
+    readonly __brand: 'ScopeId';
+};
+/** Branded opaque capability token; structural fields live in the security package. */
+export type CapabilityToken = string & {
+    readonly __brand: 'CapabilityToken';
+};
+/** Address used by a concrete transport to reach a peer. Opaque to the router. */
+export type MeshAddress = {
+    kind: 'http';
+    baseUrl: string;
+} | {
+    kind: 'libp2p';
+    multiaddr: string;
+} | {
+    kind: 'loopback';
+    scopeId: ScopeId;
+};
+/** Cooperative cancellation and per-attempt soft timeout. */
+export interface SendOpts {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+/** Context surfaced to the inbound handler after identity verification. */
+export interface TransportCtx {
+    peerId?: string;
+    remoteAddr?: string;
+    authenticatedScope: ScopeId;
+}
+/** Snapshot entry returned by peers(). */
+export interface PeerInfo {
+    scopeId: ScopeId;
+    peerId?: string;
+    transport: 'http' | 'libp2p' | 'loopback' | string;
+    connectedAt: number;
+    rttMs?: number;
+}
+/** W3C trace context propagated through every envelope. */
+export interface TraceContext {
+    traceparent: string;
+    tracestate?: string;
+}
+/** Final, exhaustive status enum for a MeshResponse. */
+export type MeshStatus = 'ok' | 'denied' | 'error' | 'timeout';
+/** Canonical wire-level request shape, serialized as msgpack. */
+export interface MeshRequest {
+    id: string;
+    fromScope: ScopeId;
+    toScope: ScopeId;
+    capability: CapabilityToken;
+    method: string;
+    payload: Uint8Array;
+    deadlineMs: number;
+    trace: TraceContext;
+}
+/** Canonical wire-level response shape. */
+export interface MeshResponse {
+    id: string;
+    status: MeshStatus;
+    payload?: Uint8Array;
+    /** Populated only when status = 'error' or 'denied'. Must never include a stack trace. */
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/** The interface every concrete transport implements. */
+export interface MeshTransport {
+    readonly kind: 'http' | 'libp2p' | 'loopback' | string;
+    readonly localScopeId: ScopeId;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(target: MeshAddress, req: MeshRequest, opts?: SendOpts): Promise<MeshResponse>;
+    onRequest(handler: (req: MeshRequest, ctx: TransportCtx) => Promise<MeshResponse>): void;
+    peers(): PeerInfo[];
+}
+/** Holds active transports; the seam for a future Pro Rust accelerator (Phase 7+). */
+export interface TransportRegistry {
+    register(t: MeshTransport): void;
+    unregister(kind: string): void;
+    get(kind: string): MeshTransport | undefined;
+    all(): MeshTransport[];
+    /** Deterministic ordering across repeated calls when health is unchanged. */
+    reachable(scopeId: ScopeId): MeshTransport[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+// packages/mesh-transport-core/src/types.ts
+/**
+ * Public type surface for the transport-agnostic mesh layer.
+ * Agent note: this file is API-stable. Adding fields requires a CR amendment.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C;;;GAGG"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@orqenix/mesh-transport-core",
+  "version": "0.6.0-phase-6",
+  "description": "Transport-agnostic foundation for the Orqenix mesh: MeshTransport interface, canonical envelope, registry, lifecycle, and loopback reference transport.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "msgpackr": "^1.11.0",
+    "ulidx": "^2.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "gate:G36": "tsx ../../scripts/gates/G36-transport-abstraction.ts"
+  }
+}