@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/network-runtime/protocol-schemas.d.ts

@@ -0,0 +1,328 @@
+import { z } from "zod";
+export { RuntimeEventKindSchema, RuntimeEventSchema, type RuntimeEventKind, type RuntimeEvent, } from "./node-store-contract.js";
+export declare const NETWORK_RUNTIME_PROTOCOL_VERSION: 1;
+export declare const NetworkRuntimeProtocolVersionSchema: z.ZodLiteral<1>;
+export type NetworkRuntimeProtocolVersion = z.infer<typeof NetworkRuntimeProtocolVersionSchema>;
+export declare function isSupportedNetworkRuntimeProtocolVersion(version: number | undefined): version is NetworkRuntimeProtocolVersion;
+export declare function assertSupportedNetworkRuntimeProtocolVersion(version: number | undefined, context?: string): NetworkRuntimeProtocolVersion;
+/**
+ * Shared delivery-ack wire contract.
+ * Durable settlement is keyed by stable peer identity, not display-name strings.
+ */
+export declare const DeliveryAckSchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    senderNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    recipientNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    storedAt: z.ZodNumber;
+}, z.core.$strict>;
+export type DeliveryAck = z.infer<typeof DeliveryAckSchema>;
+export declare const TransportInviteTokenSchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    audienceNodeId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "NodeId", "out">>;
+    publicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    leaderDisplayNameSnapshot: z.ZodOptional<z.ZodString>;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    controlEndpoint: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        protocolVersion: z.ZodNumber;
+        endpointRevision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    psk: z.ZodString;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    signingPublicKey: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">>;
+    caCert: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+    tokenNonce: z.ZodString;
+    coordinationUrl: z.ZodOptional<z.ZodString>;
+    networkId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TransportInviteToken = z.infer<typeof TransportInviteTokenSchema>;
+export declare const JoinRequestSchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    peerPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    signingPublicKey: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+    transportEndpoint: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>;
+    controlEndpoint: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        protocolVersion: z.ZodNumber;
+        endpointRevision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    inviteTokenNonce: z.ZodString;
+}, z.core.$strict>;
+export type JoinRequest = z.infer<typeof JoinRequestSchema>;
+export declare const JoinRouteBodySchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    peerPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    signingPublicKey: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+    transportEndpoint: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>;
+    controlEndpoint: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        protocolVersion: z.ZodNumber;
+        endpointRevision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    inviteTokenNonce: z.ZodString;
+    proofOfWork: z.ZodString;
+}, z.core.$strict>;
+export type JoinRouteBody = z.infer<typeof JoinRouteBodySchema>;
+export declare const JoinRouteBodyJsonSchema: Record<string, unknown>;
+export declare const RuntimeIngressEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    deliveryAck: z.ZodObject<{
+        protocolVersion: z.ZodLiteral<1>;
+        messageId: z.ZodString;
+        senderNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        recipientNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        storedAt: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    ariaMessage: z.ZodUnknown;
+}, z.core.$strict>, z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    joinRequest: z.ZodObject<{
+        protocolVersion: z.ZodLiteral<1>;
+        nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        peerPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+        signingPublicKey: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+        transportEndpoint: z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodNumber;
+        }, z.core.$strip>;
+        controlEndpoint: z.ZodOptional<z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodNumber;
+            tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+            tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+            protocolVersion: z.ZodNumber;
+            endpointRevision: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        displayNameSnapshot: z.ZodOptional<z.ZodString>;
+        inviteTokenNonce: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export type RuntimeIngressEnvelope = z.infer<typeof RuntimeIngressEnvelopeSchema>;
+export declare const RuntimeNodeAdvertisementSchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    controlEndpoint: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        protocolVersion: z.ZodNumber;
+        endpointRevision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    protocolVersion: z.ZodLiteral<1>;
+    publicationRevision: z.ZodNumber;
+    signingPublicKey: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+    transportEndpoint: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>;
+    advertisedHosts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type RuntimeNodeAdvertisement = z.infer<typeof RuntimeNodeAdvertisementSchema>;
+export declare const RuntimeDiscoveryAdvertisementSchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    displayNameSnapshot: z.ZodString;
+    principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    controlPort: z.ZodNumber;
+    advertisedHosts: z.ZodArray<z.ZodString>;
+    tlsCaFingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type RuntimeDiscoveryAdvertisement = z.infer<typeof RuntimeDiscoveryAdvertisementSchema>;
+export declare const RuntimeRegisterRequestSchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    endpointRevision: z.ZodNumber;
+    controlEndpoint: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        protocolVersion: z.ZodNumber;
+        endpointRevision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type RuntimeRegisterRequest = z.infer<typeof RuntimeRegisterRequestSchema>;
+export declare const PairProposalSchema: z.ZodObject<{
+    protocolVersion: z.ZodLiteral<1>;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    controlEndpoint: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        tlsCaFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        tlsServerIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        protocolVersion: z.ZodNumber;
+        endpointRevision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    presharedKey: z.ZodString;
+}, z.core.$strict>;
+export type PairProposal = z.infer<typeof PairProposalSchema>;
+/**
+ * Canonical statement of a continuity bind transition.
+ * This is the byte-exact payload that both parties sign.
+ */
+export declare const ContinuityStatementSchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    previousPrincipalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    newPrincipalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    newTransportPublicKey: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">>;
+    bindingGeneration: z.ZodNumber;
+    revocationGeneration: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type ContinuityStatement = z.infer<typeof ContinuityStatementSchema>;
+/**
+ * Dual-signed continuity bind: delegation (previous principal) + acceptance
+ * (new principal). Both public keys are included for independent verification.
+ */
+export declare const SignedContinuityBindSchema: z.ZodObject<{
+    statement: z.ZodObject<{
+        nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        previousPrincipalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        newPrincipalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        newTransportPublicKey: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">>;
+        bindingGeneration: z.ZodNumber;
+        revocationGeneration: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+    }, z.core.$strict>;
+    delegationSignature: z.ZodString;
+    acceptanceSignature: z.ZodString;
+    previousPublicKey: z.ZodString;
+    newPublicKey: z.ZodString;
+}, z.core.$strict>;
+export type SignedContinuityBind = z.infer<typeof SignedContinuityBindSchema>;
+export declare const MutationOperationSchema: z.ZodEnum<{
+    "network.register": "network.register";
+    "network.revoke": "network.revoke";
+    "network.list_peers": "network.list_peers";
+    "pair.direct": "pair.direct";
+    "pair.relay": "pair.relay";
+    "pair.relay_response": "pair.relay_response";
+    "peer.update_capabilities": "peer.update_capabilities";
+    "peer.update_trust_tier": "peer.update_trust_tier";
+}>;
+export type MutationOperation = z.infer<typeof MutationOperationSchema>;
+export declare const MutationEnvelopeSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    operation: z.ZodEnum<{
+        "network.register": "network.register";
+        "network.revoke": "network.revoke";
+        "network.list_peers": "network.list_peers";
+        "pair.direct": "pair.direct";
+        "pair.relay": "pair.relay";
+        "pair.relay_response": "pair.relay_response";
+        "peer.update_capabilities": "peer.update_capabilities";
+        "peer.update_trust_tier": "peer.update_trust_tier";
+    }>;
+    principal: z.ZodObject<{
+        nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+        bindingGeneration: z.ZodNumber;
+        displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    target: z.ZodObject<{
+        nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+        bindingGeneration: z.ZodNumber;
+        displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    namespace: z.ZodString;
+    policyEpoch: z.ZodNumber;
+    nonce: z.ZodString;
+    timestamp: z.ZodNumber;
+    ttl: z.ZodNumber;
+    contextHash: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    signature: z.ZodString;
+    method: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    reason: z.ZodOptional<z.ZodString>;
+    parentEnvelopeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type MutationEnvelope = z.infer<typeof MutationEnvelopeSchema>;
+export declare const NetworkRouteRevokeRequestSchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    envelope: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        id: z.ZodString;
+        operation: z.ZodEnum<{
+            "network.register": "network.register";
+            "network.revoke": "network.revoke";
+            "network.list_peers": "network.list_peers";
+            "pair.direct": "pair.direct";
+            "pair.relay": "pair.relay";
+            "pair.relay_response": "pair.relay_response";
+            "peer.update_capabilities": "peer.update_capabilities";
+            "peer.update_trust_tier": "peer.update_trust_tier";
+        }>;
+        principal: z.ZodObject<{
+            nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+            principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+            transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+            bindingGeneration: z.ZodNumber;
+            displayNameSnapshot: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        target: z.ZodObject<{
+            nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+            principalFingerprint: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+            transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+            bindingGeneration: z.ZodNumber;
+            displayNameSnapshot: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        namespace: z.ZodString;
+        policyEpoch: z.ZodNumber;
+        nonce: z.ZodString;
+        timestamp: z.ZodNumber;
+        ttl: z.ZodNumber;
+        contextHash: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        signature: z.ZodString;
+        method: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reason: z.ZodOptional<z.ZodString>;
+        parentEnvelopeId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type NetworkRouteRevokeRequest = z.infer<typeof NetworkRouteRevokeRequestSchema>;
+export declare const NetworkRouteRevokeRequestJsonSchema: Record<string, unknown>;

package/dist-cjs/network-runtime/protocol-schemas.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkRouteRevokeRequestJsonSchema = exports.NetworkRouteRevokeRequestSchema = exports.MutationEnvelopeSchema = exports.MutationOperationSchema = exports.SignedContinuityBindSchema = exports.ContinuityStatementSchema = exports.PairProposalSchema = exports.RuntimeRegisterRequestSchema = exports.RuntimeDiscoveryAdvertisementSchema = exports.RuntimeNodeAdvertisementSchema = exports.RuntimeIngressEnvelopeSchema = exports.JoinRouteBodyJsonSchema = exports.JoinRouteBodySchema = exports.JoinRequestSchema = exports.TransportInviteTokenSchema = exports.DeliveryAckSchema = exports.NetworkRuntimeProtocolVersionSchema = exports.NETWORK_RUNTIME_PROTOCOL_VERSION = exports.RuntimeEventSchema = exports.RuntimeEventKindSchema = void 0;
+exports.isSupportedNetworkRuntimeProtocolVersion = isSupportedNetworkRuntimeProtocolVersion;
+exports.assertSupportedNetworkRuntimeProtocolVersion = assertSupportedNetworkRuntimeProtocolVersion;
+const zod_1 = require("zod");
+const address_types_js_1 = require("./address-types.js");
+var node_store_contract_js_1 = require("./node-store-contract.js");
+Object.defineProperty(exports, "RuntimeEventKindSchema", { enumerable: true, get: function () { return node_store_contract_js_1.RuntimeEventKindSchema; } });
+Object.defineProperty(exports, "RuntimeEventSchema", { enumerable: true, get: function () { return node_store_contract_js_1.RuntimeEventSchema; } });
+const peer_principal_ref_js_1 = require("./peer-principal-ref.js");
+const NonEmptyStringSchema = zod_1.z.string().trim().min(1);
+// Signed transport invite tokens must preserve PEM bytes verbatim; trimming
+// a trailing newline changes the signed payload and breaks verification.
+const NonBlankVerbatimStringSchema = zod_1.z
+    .string()
+    .min(1)
+    .refine((value) => value.trim().length > 0);
+const RecordSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+function toFastifyBodyJsonSchema(schema) {
+    const jsonSchema = zod_1.z.toJSONSchema(schema);
+    delete jsonSchema.$schema;
+    return jsonSchema;
+}
+exports.NETWORK_RUNTIME_PROTOCOL_VERSION = 1;
+exports.NetworkRuntimeProtocolVersionSchema = zod_1.z.literal(exports.NETWORK_RUNTIME_PROTOCOL_VERSION);
+function isSupportedNetworkRuntimeProtocolVersion(version) {
+    return version === exports.NETWORK_RUNTIME_PROTOCOL_VERSION;
+}
+function assertSupportedNetworkRuntimeProtocolVersion(version, context = "network runtime") {
+    if (!isSupportedNetworkRuntimeProtocolVersion(version)) {
+        throw new Error(`Unsupported ${context} protocol version ${String(version)}. Supported: ${exports.NETWORK_RUNTIME_PROTOCOL_VERSION}`);
+    }
+    return version;
+}
+/**
+ * Shared delivery-ack wire contract.
+ * Durable settlement is keyed by stable peer identity, not display-name strings.
+ */
+exports.DeliveryAckSchema = zod_1.z
+    .object({
+    protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+    messageId: NonEmptyStringSchema,
+    senderNodeId: address_types_js_1.NodeIdSchema,
+    recipientNodeId: address_types_js_1.NodeIdSchema,
+    storedAt: zod_1.z.number().int().nonnegative(),
+})
+    .strict();
+exports.TransportInviteTokenSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    audienceNodeId: address_types_js_1.NodeIdSchema.optional(),
+    publicKey: address_types_js_1.PeerTransportIdSchema,
+    leaderDisplayNameSnapshot: NonEmptyStringSchema.optional(),
+    host: NonEmptyStringSchema,
+    port: zod_1.z.number().int().min(1).max(65535),
+    controlEndpoint: address_types_js_1.ControlEndpointAdvertisementSchema.optional(),
+    psk: NonEmptyStringSchema,
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+    signingPublicKey: address_types_js_1.SigningPublicKeySchema.optional(),
+    caCert: NonBlankVerbatimStringSchema.optional(),
+    createdAt: zod_1.z.number().int().nonnegative(),
+    expiresAt: zod_1.z.number().int().nonnegative(),
+    tokenNonce: NonEmptyStringSchema,
+    coordinationUrl: NonEmptyStringSchema.optional(),
+    networkId: NonEmptyStringSchema.optional(),
+})
+    .strict();
+exports.JoinRequestSchema = zod_1.z
+    .object({
+    protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+    nodeId: address_types_js_1.NodeIdSchema,
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    peerPublicKey: address_types_js_1.PeerTransportIdSchema,
+    signingPublicKey: address_types_js_1.SigningPublicKeySchema,
+    transportEndpoint: address_types_js_1.TransportEndpointAdvertisementSchema,
+    controlEndpoint: address_types_js_1.ControlEndpointAdvertisementSchema.optional(),
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+    inviteTokenNonce: NonEmptyStringSchema,
+})
+    .strict();
+exports.JoinRouteBodySchema = exports.JoinRequestSchema.extend({
+    proofOfWork: NonEmptyStringSchema,
+}).strict();
+exports.JoinRouteBodyJsonSchema = toFastifyBodyJsonSchema(exports.JoinRouteBodySchema);
+exports.RuntimeIngressEnvelopeSchema = zod_1.z.union([
+    zod_1.z
+        .object({
+        protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+        deliveryAck: exports.DeliveryAckSchema,
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+        ariaMessage: zod_1.z.unknown(),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+        joinRequest: exports.JoinRequestSchema,
+    })
+        .strict(),
+]);
+exports.RuntimeNodeAdvertisementSchema = address_types_js_1.NodeAdvertisementSchema.extend({
+    protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+    publicationRevision: address_types_js_1.PublicationRevisionSchema,
+    signingPublicKey: address_types_js_1.SigningPublicKeySchema,
+    transportEndpoint: address_types_js_1.TransportEndpointAdvertisementSchema,
+    advertisedHosts: zod_1.z.array(NonEmptyStringSchema).min(1).optional(),
+}).strict();
+exports.RuntimeDiscoveryAdvertisementSchema = zod_1.z
+    .object({
+    protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+    nodeId: address_types_js_1.NodeIdSchema,
+    displayNameSnapshot: NonEmptyStringSchema,
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    controlPort: zod_1.z.number().int().min(1).max(65535),
+    advertisedHosts: zod_1.z.array(NonEmptyStringSchema).min(1),
+    tlsCaFingerprint: zod_1.z.string().trim().min(1).optional(),
+})
+    .strict();
+exports.RuntimeRegisterRequestSchema = zod_1.z
+    .object({
+    protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+    nodeId: address_types_js_1.NodeIdSchema,
+    transportPublicKey: address_types_js_1.PeerTransportIdSchema,
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    endpointRevision: address_types_js_1.EndpointRevisionSchema,
+    controlEndpoint: address_types_js_1.ControlEndpointAdvertisementSchema.optional(),
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+})
+    .strict();
+exports.PairProposalSchema = zod_1.z
+    .object({
+    protocolVersion: exports.NetworkRuntimeProtocolVersionSchema,
+    nodeId: address_types_js_1.NodeIdSchema,
+    principalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    transportPublicKey: address_types_js_1.PeerTransportIdSchema,
+    controlEndpoint: address_types_js_1.ControlEndpointAdvertisementSchema.optional(),
+    displayNameSnapshot: NonEmptyStringSchema.optional(),
+    presharedKey: NonEmptyStringSchema,
+})
+    .strict();
+/**
+ * Canonical statement of a continuity bind transition.
+ * This is the byte-exact payload that both parties sign.
+ */
+exports.ContinuityStatementSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    previousPrincipalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    newPrincipalFingerprint: address_types_js_1.PrincipalFingerprintSchema,
+    newTransportPublicKey: address_types_js_1.PeerTransportIdSchema.optional(),
+    bindingGeneration: address_types_js_1.BindingGenerationSchema,
+    revocationGeneration: address_types_js_1.RevocationGenerationSchema.optional(),
+    createdAt: NonEmptyStringSchema,
+})
+    .strict();
+/**
+ * Dual-signed continuity bind: delegation (previous principal) + acceptance
+ * (new principal). Both public keys are included for independent verification.
+ */
+exports.SignedContinuityBindSchema = zod_1.z
+    .object({
+    statement: exports.ContinuityStatementSchema,
+    delegationSignature: NonEmptyStringSchema,
+    acceptanceSignature: NonEmptyStringSchema,
+    previousPublicKey: NonEmptyStringSchema,
+    newPublicKey: NonEmptyStringSchema,
+})
+    .strict();
+exports.MutationOperationSchema = zod_1.z.enum([
+    "network.register",
+    "network.revoke",
+    "network.list_peers",
+    "pair.direct",
+    "pair.relay",
+    "pair.relay_response",
+    "peer.update_capabilities",
+    "peer.update_trust_tier",
+]);
+exports.MutationEnvelopeSchema = zod_1.z
+    .object({
+    version: exports.NetworkRuntimeProtocolVersionSchema,
+    id: NonEmptyStringSchema,
+    operation: exports.MutationOperationSchema,
+    principal: peer_principal_ref_js_1.NodePrincipalBindingRefSchema,
+    target: peer_principal_ref_js_1.NodePrincipalBindingRefSchema,
+    namespace: NonEmptyStringSchema,
+    policyEpoch: zod_1.z.number().int().nonnegative(),
+    nonce: NonEmptyStringSchema,
+    timestamp: zod_1.z.number().int().nonnegative(),
+    ttl: zod_1.z.number().int().positive(),
+    contextHash: NonEmptyStringSchema,
+    payload: RecordSchema,
+    signature: NonEmptyStringSchema,
+    method: NonEmptyStringSchema.optional(),
+    path: NonEmptyStringSchema.optional(),
+    metadata: RecordSchema.optional(),
+    reason: NonEmptyStringSchema.optional(),
+    parentEnvelopeId: NonEmptyStringSchema.optional(),
+})
+    .strict();
+exports.NetworkRouteRevokeRequestSchema = zod_1.z
+    .object({
+    nodeId: address_types_js_1.NodeIdSchema,
+    envelope: exports.MutationEnvelopeSchema,
+})
+    .strict();
+exports.NetworkRouteRevokeRequestJsonSchema = toFastifyBodyJsonSchema(exports.NetworkRouteRevokeRequestSchema);

package/dist-cjs/network-runtime/runtime-bootstrap-contract.d.ts

@@ -0,0 +1,81 @@
+import { z } from "zod";
+export declare const RuntimeBootstrapRevisionSchema: z.ZodNumber;
+export type RuntimeBootstrapRevision = z.infer<typeof RuntimeBootstrapRevisionSchema>;
+export declare const RuntimeBootstrapPhaseSchema: z.ZodEnum<{
+    degraded: "degraded";
+    stopped: "stopped";
+    starting: "starting";
+    tls_bound: "tls_bound";
+    control_ready: "control_ready";
+    network_ready: "network_ready";
+    mesh_ready: "mesh_ready";
+}>;
+export type RuntimeBootstrapPhase = z.infer<typeof RuntimeBootstrapPhaseSchema>;
+export declare const RuntimeBootstrapControlEndpointSchema: z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodNumber;
+}, z.core.$strict>;
+export type RuntimeBootstrapControlEndpoint = z.infer<typeof RuntimeBootstrapControlEndpointSchema>;
+export declare const RuntimeBootstrapTlsSchema: z.ZodObject<{
+    caFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+    caCertPem: z.ZodString;
+    principalIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+    loopbackIdentity: z.core.$ZodBranded<z.ZodString, "LoopbackTlsIdentity", "out">;
+}, z.core.$strict>;
+export type RuntimeBootstrapTls = z.infer<typeof RuntimeBootstrapTlsSchema>;
+export declare const RuntimeBootstrapIdentitySchema: z.ZodObject<{
+    signingPublicKey: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+    transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    transportEndpoint: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type RuntimeBootstrapIdentity = z.infer<typeof RuntimeBootstrapIdentitySchema>;
+export declare const RuntimeBootstrapRecordSchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    runtimeId: z.core.$ZodBranded<z.ZodString, "RuntimeId", "out">;
+    arionName: z.ZodOptional<z.ZodString>;
+    ownerGeneration: z.ZodNumber;
+    bootstrapRevision: z.ZodNumber;
+    phase: z.ZodEnum<{
+        degraded: "degraded";
+        stopped: "stopped";
+        starting: "starting";
+        tls_bound: "tls_bound";
+        control_ready: "control_ready";
+        network_ready: "network_ready";
+        mesh_ready: "mesh_ready";
+    }>;
+    protocolVersion: z.ZodLiteral<1>;
+    controlEndpoint: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strict>;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    signingPublicKey: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+    transportPublicKey: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+    transportEndpoint: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+    }, z.core.$strip>;
+    tls: z.ZodObject<{
+        caFingerprint: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+        caCertPem: z.ZodString;
+        principalIdentity: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+        loopbackIdentity: z.core.$ZodBranded<z.ZodString, "LoopbackTlsIdentity", "out">;
+    }, z.core.$strict>;
+    publishedAt: z.ZodString;
+    degradedReason: z.ZodOptional<z.ZodString>;
+    failedPhase: z.ZodOptional<z.ZodEnum<{
+        degraded: "degraded";
+        stopped: "stopped";
+        starting: "starting";
+        tls_bound: "tls_bound";
+        control_ready: "control_ready";
+        network_ready: "network_ready";
+        mesh_ready: "mesh_ready";
+    }>>;
+}, z.core.$strict>;
+export type RuntimeBootstrapRecord = z.infer<typeof RuntimeBootstrapRecordSchema>;