@aria-cli/tools 1.0.0

package/dist-cjs/mcp/jsonrpc.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * JSON-RPC 2.0 Client for MCP
+ *
+ * Handles newline-delimited JSON over stdio streams.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONRPCClient = void 0;
+const events_1 = require("events");
+const crypto_1 = require("crypto");
+class JSONRPCClient extends events_1.EventEmitter {
+    stdin;
+    stdout;
+    pending = new Map();
+    buffer = "";
+    requestTimeout;
+    constructor(options = {}) {
+        super();
+        this.requestTimeout = options.timeout ?? 30000;
+    }
+    /**
+     * Connect to a process via stdio streams
+     */
+    connect(stdin, stdout) {
+        this.stdin = stdin;
+        this.stdout = stdout;
+        stdout.on("data", (chunk) => {
+            this.buffer += chunk.toString();
+            this.processBuffer();
+        });
+        stdout.on("error", (error) => {
+            this.emit("error", error);
+        });
+        stdout.on("end", () => {
+            this.emit("close");
+        });
+    }
+    processBuffer() {
+        let newlineIdx;
+        while ((newlineIdx = this.buffer.indexOf("\n")) !== -1) {
+            const line = this.buffer.slice(0, newlineIdx).trim();
+            this.buffer = this.buffer.slice(newlineIdx + 1);
+            if (line) {
+                try {
+                    this.handleMessage(JSON.parse(line));
+                }
+                catch (e) {
+                    this.emit("error", new Error(`Invalid JSON: ${line}`));
+                }
+            }
+        }
+    }
+    handleMessage(msg) {
+        // Ignore messages that aren't valid JSON-RPC 2.0
+        if (typeof msg !== "object" ||
+            msg === null ||
+            !("jsonrpc" in msg) ||
+            msg.jsonrpc !== "2.0")
+            return;
+        const rpcMsg = msg;
+        // Response to our request
+        if ("id" in rpcMsg && rpcMsg.id !== undefined) {
+            const response = rpcMsg;
+            const pending = this.pending.get(String(response.id));
+            if (pending) {
+                this.pending.delete(String(response.id));
+                clearTimeout(pending.timeout);
+                if (response.error) {
+                    pending.reject(new Error(`${response.error.code}: ${response.error.message}`));
+                }
+                else {
+                    pending.resolve(response.result);
+                }
+            }
+            return;
+        }
+        // Notification from server
+        if ("method" in rpcMsg) {
+            const notification = rpcMsg;
+            this.emit(notification.method, notification.params);
+            this.emit("notification", {
+                method: notification.method,
+                params: notification.params,
+            });
+        }
+    }
+    /**
+     * Send a request and wait for response
+     */
+    async request(method, params) {
+        if (!this.stdin) {
+            throw new Error("Not connected");
+        }
+        const id = (0, crypto_1.randomUUID)();
+        const message = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params,
+        };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`Request timeout: ${method}`));
+                }
+            }, this.requestTimeout);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timeout,
+            });
+            this.send(message);
+        });
+    }
+    /**
+     * Send a notification (no response expected)
+     */
+    notify(method, params) {
+        const message = {
+            jsonrpc: "2.0",
+            method,
+            params,
+        };
+        this.send(message);
+    }
+    send(message) {
+        if (!this.stdin) {
+            throw new Error("Not connected");
+        }
+        this.stdin.write(JSON.stringify(message) + "\n");
+    }
+    /**
+     * Close and cleanup
+     */
+    close() {
+        for (const [, pending] of this.pending) {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error("Connection closed"));
+        }
+        this.pending.clear();
+        this.buffer = "";
+        this.stdin = undefined;
+        this.stdout?.removeAllListeners();
+        this.stdout = undefined;
+    }
+}
+exports.JSONRPCClient = JSONRPCClient;
+//# sourceMappingURL=jsonrpc.js.map

package/dist-cjs/mcp/jsonrpc.js.map

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

package/dist-cjs/mcp/types.d.ts

@@ -0,0 +1,178 @@
+/**
+ * MCP (Model Context Protocol) Types
+ *
+ * Protocol version: 2024-11-05
+ * https://modelcontextprotocol.io
+ */
+import type { JSONSchema7 } from "json-schema";
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    /** Unique server identifier */
+    name: string;
+    /** Transport type (defaults to 'stdio' if omitted) */
+    transport?: "stdio" | "sse";
+    /** Command to spawn (stdio transport) */
+    command?: string;
+    /** Command arguments */
+    args?: string[];
+    /** SSE endpoint URL */
+    url?: string;
+    /** Environment variables for server process */
+    env?: Record<string, string>;
+    /** Configuration scope */
+    scope?: "project" | "global";
+}
+/**
+ * Server capabilities from initialize response
+ */
+export interface MCPCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+    logging?: Record<string, never>;
+}
+/**
+ * Initialize request params
+ */
+export interface MCPInitializeParams {
+    protocolVersion: string;
+    capabilities: {
+        roots?: {
+            listChanged?: boolean;
+        };
+        sampling?: Record<string, never>;
+    };
+    clientInfo: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Initialize response
+ */
+export interface MCPInitializeResult {
+    protocolVersion: string;
+    capabilities: MCPCapabilities;
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Tool definition from tools/list
+ */
+export interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: JSONSchema7;
+    annotations?: {
+        readOnlyHint?: boolean;
+    };
+}
+/**
+ * Tool call request params
+ */
+export interface MCPToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+/**
+ * Content types in tool results
+ */
+export type MCPContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+} | {
+    type: "resource";
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+    };
+};
+/**
+ * Tool call result
+ */
+export interface MCPToolCallResult {
+    content: MCPContent[];
+    isError?: boolean;
+}
+/**
+ * Resource definition from resources/list
+ */
+export interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * Resource content from resources/read
+ */
+export interface MCPResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+}
+/**
+ * Resources read result
+ */
+export interface MCPResourceReadResult {
+    contents: MCPResourceContent[];
+}
+/**
+ * Prompt definition from prompts/list
+ */
+export interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+/**
+ * Prompt message from prompts/get
+ */
+export interface MCPPromptMessage {
+    role: "user" | "assistant";
+    content: MCPContent;
+}
+/**
+ * Prompts get result
+ */
+export interface MCPPromptGetResult {
+    description?: string;
+    messages: MCPPromptMessage[];
+}
+/**
+ * Log message from server
+ */
+export interface MCPLogMessage {
+    level: "debug" | "info" | "warning" | "error";
+    logger?: string;
+    data?: unknown;
+}
+/**
+ * Progress notification
+ */
+export interface MCPProgress {
+    progressToken: string | number;
+    progress: number;
+    total?: number;
+}

package/dist-cjs/mcp/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * MCP (Model Context Protocol) Types
+ *
+ * Protocol version: 2024-11-05
+ * https://modelcontextprotocol.io
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-cjs/mcp/types.js.map

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

package/dist-cjs/network-control-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { NetworkControlRef, NetworkManagerPeerInfo, NetworkManagerRef, NetworkManagerStatusView, NetworkPeerView, NetworkStatusView } from "./types.js";
+export declare function toNetworkPeerView(peer: NetworkManagerPeerInfo): NetworkPeerView | null;
+export declare function toNetworkStatusView(status: NetworkManagerStatusView): NetworkStatusView;
+export declare function toNetworkControlRef(networkManager?: NetworkManagerRef): NetworkControlRef | undefined;

package/dist-cjs/network-control-adapter.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNetworkPeerView = toNetworkPeerView;
+exports.toNetworkStatusView = toNetworkStatusView;
+exports.toNetworkControlRef = toNetworkControlRef;
+const index_js_1 = require("./network-runtime/index.js");
+function toNetworkPeerView(peer) {
+    const parsedSigningPublicKey = index_js_1.SigningPublicKeySchema.safeParse(peer.signingPublicKey?.trim());
+    if (!parsedSigningPublicKey.success ||
+        typeof peer.nodeId !== "string" ||
+        peer.nodeId.length === 0) {
+        return null;
+    }
+    const signingPublicKey = parsedSigningPublicKey.data;
+    return {
+        nodeId: peer.nodeId,
+        transportPublicKey: peer.publicKey,
+        displayNameSnapshot: peer.name,
+        endpointHost: peer.endpointHost,
+        endpointPort: peer.endpointPort,
+        controlEndpoint: peer.controlEndpoint ?? null,
+        signingPublicKey,
+        status: peer.status,
+        membershipStatus: peer.membershipStatus ?? peer.status,
+        routeOwnership: peer.routeOwnership,
+        routeOwnerNodeId: peer.routeOwnerNodeId ?? null,
+        sessionState: peer.sessionState,
+        deliveryReadiness: peer.deliveryReadiness,
+        lastHandshake: peer.lastHandshake,
+        createdAt: peer.createdAt,
+        endpointRevision: peer.endpointRevision ?? 0,
+        updatedAt: peer.updatedAt ?? peer.createdAt,
+    };
+}
+function toNetworkStatusView(status) {
+    const parsedSigningPublicKey = index_js_1.SigningPublicKeySchema.safeParse(status.signingPublicKey?.trim());
+    const signingPublicKey = parsedSigningPublicKey.success
+        ? parsedSigningPublicKey.data
+        : null;
+    return {
+        configured: status.configured,
+        nodeId: status.nodeId,
+        principalFingerprint: status.principalFingerprint,
+        transportPublicKey: status.publicKey,
+        listenPort: status.listenPort,
+        externalEndpoint: status.externalEndpoint,
+        activePeers: status.activePeers,
+        totalPeers: status.totalPeers,
+        connectedPeers: status.connectedPeers,
+        handshakingPeers: status.handshakingPeers,
+        queueOnlyPeers: status.queueOnlyPeers,
+        supersededPeers: status.supersededPeers,
+        signingPublicKey,
+    };
+}
+function toNetworkControlRef(networkManager) {
+    if (!networkManager) {
+        return undefined;
+    }
+    return {
+        invite(displayName, options) {
+            return networkManager.invite(displayName, options);
+        },
+        revokePeer(nodeId) {
+            return networkManager.revokePeer(nodeId);
+        },
+        listPeers() {
+            return networkManager.listPeers().flatMap((peer) => {
+                const projected = toNetworkPeerView(peer);
+                return projected ? [projected] : [];
+            });
+        },
+        status() {
+            return toNetworkStatusView(networkManager.status());
+        },
+    };
+}
+//# sourceMappingURL=network-control-adapter.js.map

package/dist-cjs/network-control-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-control-adapter.js","sourceRoot":"","sources":["../src/network-control-adapter.ts"],"names":[],"mappings":";;AAUA,8CA6BC;AAED,kDAoBC;AAED,kDAwBC;AAvFD,yDAA2F;AAU3F,SAAgB,iBAAiB,CAAC,IAA4B;IAC5D,MAAM,sBAAsB,GAAG,iCAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,IACE,CAAC,sBAAsB,CAAC,OAAO;QAC/B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,IAAI,CAAC;IACrD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,kBAAkB,EAAE,IAAI,CAAC,SAAS;QAClC,mBAAmB,EAAE,IAAI,CAAC,IAAI;QAC9B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;QAC7C,gBAAgB;QAChB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,MAAM;QACtD,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;QAC/C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,CAAC;QAC5C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;KAC5C,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAgC;IAClE,MAAM,sBAAsB,GAAG,iCAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,MAAM,gBAAgB,GAA4B,sBAAsB,CAAC,OAAO;QAC9E,CAAC,CAAC,sBAAsB,CAAC,IAAI;QAC7B,CAAC,CAAC,IAAI,CAAC;IACT,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,kBAAkB,EAAE,MAAM,CAAC,SAAS;QACpC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CACjC,cAAkC;IAElC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,MAAM,CAAC,WAAW,EAAE,OAAO;YACzB,OAAO,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QACD,UAAU,CAAC,MAAM;YACf,OAAO,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,SAAS;YACP,OAAO,cAAc,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBACjD,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC1C,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM;YACJ,OAAO,mBAAmB,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist-cjs/network-runtime/address-types.d.ts

@@ -0,0 +1,201 @@
+import { z } from "zod";
+/**
+ * Stable durable identity for a node.
+ * Semantic rules are enforced by the runtime cutover plan; the contract layer
+ * starts by making the shape canonical everywhere.
+ */
+export declare const NodeIdSchema: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+export type NodeId = z.infer<typeof NodeIdSchema>;
+/** One boot of a given node runtime. */
+export declare const RuntimeIdSchema: z.core.$ZodBranded<z.ZodString, "RuntimeId", "out">;
+export type RuntimeId = z.infer<typeof RuntimeIdSchema>;
+export declare const NodeMetadataSchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    createdAt: z.ZodString;
+    schemaVersion: z.ZodNumber;
+    migratedFromLegacy: z.ZodBoolean;
+}, z.core.$strip>;
+export type NodeMetadata = z.infer<typeof NodeMetadataSchema>;
+/** Monotonic publication revision for externally visible runtime advertisements. */
+export declare const PublicationRevisionSchema: z.ZodNumber;
+export type PublicationRevision = z.infer<typeof PublicationRevisionSchema>;
+/** Monotonic endpoint revision for register/discovery refreshes. */
+export declare const EndpointRevisionSchema: z.ZodNumber;
+export type EndpointRevision = z.infer<typeof EndpointRevisionSchema>;
+/** Monotonic generation for peer-binding continuity transitions. */
+export declare const BindingGenerationSchema: z.ZodNumber;
+export type BindingGeneration = z.infer<typeof BindingGenerationSchema>;
+/** Monotonic generation for revocation precedence and continuity conflict checks. */
+export declare const RevocationGenerationSchema: z.ZodNumber;
+export type RevocationGeneration = z.infer<typeof RevocationGenerationSchema>;
+/** How a local operator confirmed a revocation decision. */
+export declare const RevocationOperatorConfirmationSchema: z.ZodEnum<{
+    local_operator_confirmed: "local_operator_confirmed";
+    remote_capability_authenticated: "remote_capability_authenticated";
+}>;
+export type RevocationOperatorConfirmation = z.infer<typeof RevocationOperatorConfirmationSchema>;
+/** Structured local authority record for a peer revocation decision. */
+export declare const RevocationDecisionSchema: z.ZodObject<{
+    localNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    targetNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    revocationGeneration: z.ZodNumber;
+    operatorConfirmation: z.ZodEnum<{
+        local_operator_confirmed: "local_operator_confirmed";
+        remote_capability_authenticated: "remote_capability_authenticated";
+    }>;
+}, z.core.$strip>;
+export type RevocationDecision = z.infer<typeof RevocationDecisionSchema>;
+/** Monotonic owner generation for runtime ownership records. */
+export declare const OwnerGenerationSchema: z.ZodNumber;
+export type OwnerGeneration = z.infer<typeof OwnerGenerationSchema>;
+/** Monotonic revision for durable delivery lifecycle state transitions. */
+export declare const DeliveryLifecycleRevisionSchema: z.ZodNumber;
+export type DeliveryLifecycleRevision = z.infer<typeof DeliveryLifecycleRevisionSchema>;
+export declare const RuntimeOwnerRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodNumber;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    ariaHome: z.ZodString;
+    runtimePid: z.ZodNumber;
+    runtimeId: z.core.$ZodBranded<z.ZodString, "RuntimeId", "out">;
+    displayNameSnapshot: z.ZodOptional<z.ZodString>;
+    runtimeSocket: z.ZodString;
+    startedAt: z.ZodString;
+    lastHeartbeat: z.ZodString;
+    ownerGeneration: z.ZodNumber;
+}, z.core.$strict>;
+export type RuntimeOwnerRecord = z.infer<typeof RuntimeOwnerRecordSchema>;
+/** One attached local client of the runtime. */
+export declare const ClientIdSchema: z.core.$ZodBranded<z.ZodString, "ClientId", "out">;
+export type ClientId = z.infer<typeof ClientIdSchema>;
+/** Durable principal fingerprint (SHA-256 hex of signing public key DER). Signing-key evidence only. */
+export declare const PrincipalFingerprintSchema: z.core.$ZodBranded<z.ZodString, "PrincipalFingerprint", "out">;
+export type PrincipalFingerprint = z.infer<typeof PrincipalFingerprintSchema>;
+/** Transport public key / transport identity for a peer. */
+export declare const PeerTransportIdSchema: z.core.$ZodBranded<z.ZodString, "PeerTransportId", "out">;
+export type PeerTransportId = z.infer<typeof PeerTransportIdSchema>;
+/** TLS CA certificate fingerprint (SHA-256 hex of CA cert DER). Certificate-authority evidence only — distinct from signing-key evidence. */
+export declare const TlsCaFingerprintSchema: z.core.$ZodBranded<z.ZodString, "TlsCaFingerprint", "out">;
+export type TlsCaFingerprint = z.infer<typeof TlsCaFingerprintSchema>;
+/** Local-only loopback TLS SAN identity used for same-machine control attachment. */
+export declare const LoopbackTlsIdentitySchema: z.core.$ZodBranded<z.ZodString, "LoopbackTlsIdentity", "out">;
+export type LoopbackTlsIdentity = z.infer<typeof LoopbackTlsIdentitySchema>;
+/** Base64-encoded signing public key material crossing runtime/shared boundaries. */
+export declare const SigningPublicKeySchema: z.core.$ZodBranded<z.ZodString, "SigningPublicKey", "out">;
+export type SigningPublicKey = z.infer<typeof SigningPublicKeySchema>;
+/** Explicit network transport endpoint advertisement. */
+export declare const TransportEndpointAdvertisementSchema: z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodNumber;
+}, z.core.$strip>;
+export type TransportEndpointAdvertisement = z.infer<typeof TransportEndpointAdvertisementSchema>;
+/**
+ * Runtime-owned local inbox addressing.
+ * Same-machine clients are local attachments, not mesh peers.
+ */
+export declare const InboxAddressSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"node">;
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"client">;
+    clientId: z.core.$ZodBranded<z.ZodString, "ClientId", "out">;
+}, z.core.$strip>], "kind">;
+export type InboxAddress = z.infer<typeof InboxAddressSchema>;
+/**
+ * Public control-plane endpoint advertisement used by peers for pinned,
+ * mutating requests.
+ */
+export declare const ControlEndpointAdvertisementSchema: 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>;
+export type ControlEndpointAdvertisement = z.infer<typeof ControlEndpointAdvertisementSchema>;
+/**
+ * Remote/public node advertisement. This deliberately excludes local-only
+ * runtime/session identity like RuntimeId.
+ */
+export declare const NodeAdvertisementSchema: 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">;
+    publicationRevision: z.ZodOptional<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.$strip>;
+export type NodeAdvertisement = z.infer<typeof NodeAdvertisementSchema>;
+/**
+ * Local-only runtime registry summary. This is not a remote/public mesh
+ * contract and may include RuntimeId.
+ */
+export declare const LocalRuntimeSummarySchema: z.ZodObject<{
+    nodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+    runtimeId: z.core.$ZodBranded<z.ZodString, "RuntimeId", "out">;
+    lastHeartbeat: z.ZodOptional<z.ZodString>;
+    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.$strip>;
+export type LocalRuntimeSummary = z.infer<typeof LocalRuntimeSummarySchema>;
+/**
+ * Branded operation handle for durable delivery.
+ * Produced ONLY by `submitDurable()` — the caller never mints handles.
+ */
+export declare const DurableDeliveryHandleSchema: z.core.$ZodBranded<z.ZodString, "DurableDeliveryHandle", "out">;
+export type DurableDeliveryHandle = z.infer<typeof DurableDeliveryHandleSchema>;
+/**
+ * Terminal status types for a durable delivery operation.
+ */
+export declare const DurableDeliveryResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"pending">;
+    queuedAt: z.ZodString;
+    nextAttemptAt: z.ZodOptional<z.ZodString>;
+    attemptCount: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"delivered">;
+    deliveredAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"expired">;
+    reason: z.ZodLiteral<"ttl_exceeded">;
+    queuedAt: z.ZodString;
+    expiredAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"rejected">;
+    reason: z.ZodEnum<{
+        recipient_revoked: "recipient_revoked";
+        recipient_unknown: "recipient_unknown";
+        envelope_invalid: "envelope_invalid";
+    }>;
+}, z.core.$strip>], "status">;
+export type DurableDeliveryResult = z.infer<typeof DurableDeliveryResultSchema>;
+/**
+ * Submit result — returned immediately from `submitDurable()`.
+ */
+export declare const DurableSubmitResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"accepted">;
+    operationId: z.core.$ZodBranded<z.ZodString, "DurableDeliveryHandle", "out">;
+    queuedAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"rejected">;
+    reason: z.ZodEnum<{
+        recipient_revoked: "recipient_revoked";
+        recipient_unknown: "recipient_unknown";
+        envelope_invalid: "envelope_invalid";
+    }>;
+}, z.core.$strip>], "status">;
+export type DurableSubmitResult = z.infer<typeof DurableSubmitResultSchema>;