agent-embassy 1.8.2 → 1.9.2

package/dist/src/gateway/peer-client.js

@@ -0,0 +1,208 @@
+import { spawn as nodeSpawn } from "node:child_process";
+import { Buffer } from "node:buffer";
+import { createHash } from "node:crypto";
+import { decodePeerParams, decodePeerResult, encodePeerFrame, peerEdgeRef, PEER_MAX_CATALOG_BYTES, PEER_MAX_REQUEST_BYTES, PEER_METHOD_NOT_FOUND, PEER_REQUEST_TIMEOUT_MS } from "./peer-protocol.js";
+export class PeerRequestError extends Error {
+    detail;
+    constructor(detail) {
+        super(detail.message);
+        this.detail = detail;
+        this.name = "PeerRequestError";
+    }
+}
+export class PeerConnectionLostError extends Error {
+    failureClass;
+    constructor(message = "Peer connection lost", failureClass = "transport") {
+        super(message);
+        this.failureClass = failureClass;
+        this.name = "PeerConnectionLostError";
+    }
+}
+export class PeerClient {
+    child;
+    localHost;
+    timers;
+    pending = new Map();
+    nextId = 1;
+    buffer = Buffer.alloc(0);
+    writes = Promise.resolve();
+    closed = false;
+    remoteHost = "";
+    constructor(child, localHost, timers) {
+        this.child = child;
+        this.localHost = localHost;
+        this.timers = timers;
+        child.stderr.resume();
+        child.stdout.on("data", (chunk) => this.read(chunk));
+        child.once("error", () => this.fail(new PeerConnectionLostError()));
+        child.once("exit", () => this.fail(new PeerConnectionLostError()));
+    }
+    static async spawn(options) {
+        decodePeerParams("initialize", { protocolVersion: 1, host: options.node });
+        decodePeerParams("initialize", { protocolVersion: 1, host: options.localHost });
+        let child;
+        try {
+            child = (options.spawn ?? nodeSpawn)("/usr/bin/ssh", ["-T", "-x", "-o", "BatchMode=yes", "-o", "ClearAllForwardings=yes", "-o", "ForwardAgent=no", "-o", "PermitLocalCommand=no", "-o", "SendEnv=-*", "-o", "Tunnel=no", options.node, "embassy", "peer-stdio"], { env: peerEnvironment(process.env), shell: false, stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch {
+            throw new PeerConnectionLostError("Peer process could not be spawned", "spawn");
+        }
+        const client = new PeerClient(child, options.localHost, options.timers ?? { setTimeout, clearTimeout });
+        try {
+            const result = await client.request("initialize", { protocolVersion: 1, host: options.localHost });
+            if (result.host !== options.node)
+                throw new Error(`Peer host mismatch: expected ${options.node}, received ${result.host}`);
+            client.remoteHost = result.host;
+            return client;
+        }
+        catch (error) {
+            client.close();
+            throw new PeerConnectionLostError(error instanceof Error ? error.message : "Peer initialization failed", "initialize");
+        }
+    }
+    get connectionInfo() { return { host: this.remoteHost, protocolVersion: 1 }; }
+    async catalog() {
+        const result = await this.request("catalog/get", {});
+        const routeIds = result.routes.flatMap((row) => [row.alias, row.ref]), connectorIds = result.connectors.map((row) => row.provider);
+        const invalid = (result.complete && result.truncated) || new Set(routeIds).size !== routeIds.length || new Set(connectorIds).size !== connectorIds.length ||
+            [...result.routes, ...result.connectors].some((row) => row.host !== this.remoteHost) || result.consentEdges.some((edge) => {
+            const hosts = edge.endpoints.map((endpoint) => endpoint.host).sort();
+            return hosts[0] !== [this.localHost, this.remoteHost].sort()[0] || hosts[1] !== [this.localHost, this.remoteHost].sort()[1] ||
+                edge.ownerHost !== hosts[0] || edge.ownerHost !== this.remoteHost || edge.ref !== peerEdgeRef(edge.endpoints);
+        }) || new Set(result.consentEdges.map((edge) => edge.ref)).size !== result.consentEdges.length ||
+            result.alerts.some((alert) => (alert.host !== undefined && alert.host !== this.remoteHost) ||
+                (alert.alias !== undefined && !alert.alias.endsWith(`@${this.remoteHost}`))) || result.consentEdges.some((edge) => edge.endpoints
+            .filter((endpoint) => endpoint.host === this.remoteHost).some((endpoint) => !result.routes.some((route) => route.alias === endpoint.alias && route.provider === endpoint.provider && route.ref === endpoint.routeRef)));
+        if (invalid) {
+            const error = new Error("Peer catalog is not a local, canonical projection");
+            this.fail(error);
+            throw error;
+        }
+        return result;
+    }
+    prepareHandoff(params) {
+        decodePeerParams("handoff", params);
+        if (this.closed)
+            throw new PeerConnectionLostError();
+        if (params.source.host !== this.localHost || params.target.host !== this.remoteHost)
+            throw new Error("Peer handoff must be direct");
+        const id = this.nextId++, frame = encodePeerFrame({ jsonrpc: "2.0", id, method: "handoff", params }, PEER_MAX_REQUEST_BYTES);
+        let state = "prepared";
+        const used = () => { throw new Error("Peer handoff was already consumed"); };
+        return { bodyBytes: Buffer.byteLength(params.body), bodySha256: createHash("sha256").update(params.body).digest("hex"), frameBytes: Buffer.byteLength(frame), sha256: createHash("sha256").update(frame).digest("hex"),
+            cancel: () => { if (state !== "prepared")
+                used(); state = "cancelled"; }, perform: () => {
+                if (state !== "prepared")
+                    return Promise.reject(used());
+                state = "performed";
+                return this.requestFrame("handoff", id, frame);
+            } };
+    }
+    close() { this.fail(new PeerConnectionLostError()); }
+    request(method, params) {
+        const id = this.nextId++;
+        return this.requestFrame(method, id, encodePeerFrame({ jsonrpc: "2.0", id, method, params }, PEER_MAX_REQUEST_BYTES));
+    }
+    requestFrame(method, id, frame) {
+        if (this.closed)
+            return Promise.reject(new PeerConnectionLostError());
+        return new Promise((resolve, reject) => {
+            const timer = this.timers.setTimeout(() => {
+                this.timers.clearTimeout(timer);
+                this.pending.delete(id);
+                const error = new PeerConnectionLostError("Peer request timed out");
+                this.fail(error);
+                reject(error);
+            }, PEER_REQUEST_TIMEOUT_MS);
+            timer.unref();
+            this.pending.set(id, { method, timer, resolve, reject });
+            void this.write(frame).catch((error) => { const pending = this.pending.get(id); if (pending)
+                this.timers.clearTimeout(pending.timer); this.pending.delete(id); this.fail(error); reject(error); });
+        });
+    }
+    write(frame) {
+        const operation = this.writes.then(() => new Promise((resolve, reject) => {
+            if (this.closed)
+                return reject(new PeerConnectionLostError());
+            this.child.stdin.write(frame, (error) => error ? reject(new PeerConnectionLostError()) : resolve());
+        }));
+        this.writes = operation.catch(() => undefined);
+        return operation;
+    }
+    read(chunk) {
+        if (this.closed)
+            return;
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        for (;;) {
+            const newline = this.buffer.indexOf(0x0a);
+            if (newline < 0) {
+                if (this.buffer.length > PEER_MAX_CATALOG_BYTES)
+                    this.fail(new Error("Peer response exceeds 256 KiB"));
+                return;
+            }
+            const line = this.buffer.subarray(0, newline);
+            this.buffer = this.buffer.subarray(newline + 1);
+            if (line.length > PEER_MAX_CATALOG_BYTES)
+                return this.fail(new Error("Peer response exceeds 256 KiB"));
+            let message;
+            try {
+                message = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(line));
+            }
+            catch {
+                return this.fail(new Error("Peer returned malformed JSON"));
+            }
+            if (!object(message) || message.jsonrpc !== "2.0")
+                return this.fail(new Error("Peer returned an invalid JSON-RPC frame"));
+            if (typeof message.method === "string") {
+                if (!request(message))
+                    return this.fail(new Error("Peer returned an invalid request"));
+                void this.write(encodePeerFrame({ jsonrpc: "2.0", id: message.id, error: { code: PEER_METHOD_NOT_FOUND, message: "Method not found" } }, PEER_MAX_REQUEST_BYTES)).catch((error) => this.fail(error));
+                continue;
+            }
+            if (!response(message))
+                return this.fail(new Error("Peer returned an invalid JSON-RPC response"));
+            const pending = this.pending.get(message.id);
+            if (!pending)
+                return this.fail(new Error("Peer returned an uncorrelated response"));
+            this.pending.delete(message.id);
+            this.timers.clearTimeout(pending.timer);
+            if (Object.hasOwn(message, "error")) {
+                const detail = error(message.error);
+                if (detail === undefined) {
+                    const fault = new Error("Peer returned an invalid error response");
+                    pending.reject(fault);
+                    this.fail(fault);
+                }
+                else
+                    pending.reject(new PeerRequestError(detail));
+            }
+            else
+                try {
+                    pending.resolve(decodePeerResult(pending.method, message.result));
+                }
+                catch (fault) {
+                    const error = fault instanceof Error ? fault : new Error("Invalid peer result");
+                    pending.reject(error);
+                    this.fail(error);
+                }
+        }
+    }
+    fail(error) { if (this.closed)
+        return; this.closed = true; for (const pending of this.pending.values()) {
+        this.timers.clearTimeout(pending.timer);
+        pending.reject(error);
+    } this.pending.clear(); this.child.kill(); }
+}
+const peerEnvironment = (env) => Object.fromEntries(["HOME", "USER", "LOGNAME", "SSH_AUTH_SOCK"].flatMap((key) => env[key] === undefined ? [] : [[key, env[key]]]));
+const object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const id = (value) => typeof value === "string" || typeof value === "number";
+const request = (value) => Object.keys(value).length === 4 && id(value.id) && typeof value.method === "string" && Object.hasOwn(value, "params");
+const response = (value) => Object.keys(value).length === 3 && id(value.id) && (Object.hasOwn(value, "result") !== Object.hasOwn(value, "error"));
+function error(value) {
+    if (!object(value) || typeof value.code !== "number" || typeof value.message !== "string" ||
+        Object.keys(value).some((key) => key !== "code" && key !== "message" && key !== "data"))
+        return undefined;
+    return { code: value.code, message: value.message, ...(Object.hasOwn(value, "data") ? { data: value.data } : {}) };
+}
+export const spawnPeerClient = (options) => PeerClient.spawn(options);
+//# sourceMappingURL=peer-client.js.map

package/dist/src/gateway/peer-client.js.map

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

package/dist/src/gateway/peer-mailbox.d.ts

@@ -0,0 +1,78 @@
+import type { GatewayAdapterDispatchInput, GatewayProviderAdapter } from "./service.js";
+export type PeerMailboxAwaitInput = Readonly<{
+    alias: string;
+    routeHandle: string;
+    registrationId: string;
+    timeoutMs?: number;
+}>;
+export type PeerMailboxAwaitResult = Readonly<{
+    state: "timeout";
+}> | Readonly<{
+    state: "message";
+    frame: string;
+    receipt: string;
+}>;
+export type PeerMailboxReceiptInput = Readonly<{
+    alias: string;
+    routeHandle: string;
+    registrationId: string;
+    receipt: string;
+}>;
+export type PeerMailboxReceiptResult = "acknowledged" | "duplicate" | "rejected";
+export type LocalPeerMailboxProviderOptions = Readonly<{
+    hostId: string;
+    awaitTimeoutMs?: number;
+    receiptTimeoutMs?: number;
+    createReceipt?: () => string;
+    now?: () => number;
+}>;
+type Binding = Readonly<{
+    alias: string;
+    routeHandle: string;
+    registrationId: string;
+}>;
+export declare function isPeerMailboxAwaitResult(value: unknown): value is PeerMailboxAwaitResult;
+export declare class LocalPeerMailboxProvider implements GatewayProviderAdapter {
+    private readonly options;
+    readonly identity: Readonly<{
+        provider: "peer";
+        hostId: string;
+    }>;
+    readonly protocol = "peer-mailbox";
+    readonly protocolVersion = "1";
+    private readonly routes;
+    private readonly waiters;
+    private readonly receipts;
+    private readonly tombstones;
+    private closed;
+    constructor(options: LocalPeerMailboxProviderOptions);
+    initialize(): Promise<{
+        health: "healthy";
+    }>;
+    observeLogicalRoute(input: Binding): void;
+    forgetLogicalRoute(registrationId: string): void;
+    awaitMessage(input: PeerMailboxAwaitInput): Promise<PeerMailboxAwaitResult>;
+    acknowledgeReceipt(input: PeerMailboxReceiptInput): PeerMailboxReceiptResult;
+    dispatch(input: GatewayAdapterDispatchInput): Promise<{
+        state: "failed";
+        safeErrorCode: string;
+    } | {
+        state: "deferred";
+        safeErrorCode: string;
+    } | {
+        state: "ambiguous";
+        safeErrorCode: string;
+    } | {
+        state: "delivered";
+        safeErrorCode?: never;
+    } | {
+        state: "unconfirmed";
+        safeErrorCode: string;
+    }>;
+    close(): Promise<void>;
+    private cancelRegistration;
+    private cancelReceipt;
+    private finishReceipt;
+    private newReceipt;
+}
+export {};

package/dist/src/gateway/peer-mailbox.js

@@ -0,0 +1,168 @@
+import { Buffer } from "node:buffer";
+import { createHash, randomBytes } from "node:crypto";
+import { BridgeError } from "../errors.js";
+import { composeProvenanceEnvelope, PROVENANCE_ENVELOPE_MAX_BYTES } from "./provenance-envelope.js";
+const TIMEOUT = Object.freeze({ state: "timeout" });
+const MAX_WAITERS = 16;
+const RECEIPT = /^prc_[A-Za-z0-9_-]{24}$/;
+const ALIAS = /^[a-z][a-z0-9_-]{0,31}@[a-z0-9](?:[a-z0-9.-]{0,61}[a-z0-9])?$/;
+const CONVERSATION = /^conv_[A-Za-z0-9_-]{16,64}$/;
+export function isPeerMailboxAwaitResult(value) {
+    if (!record(value))
+        return false;
+    if (value.state === "timeout")
+        return Object.keys(value).length === 1;
+    if (value.state !== "message" || Object.keys(value).length !== 3 || typeof value.receipt !== "string" || !RECEIPT.test(value.receipt) || typeof value.frame !== "string")
+        return false;
+    try {
+        const parsed = JSON.parse(value.frame);
+        if (!record(parsed) || Object.keys(parsed).length !== 3 || parsed.ok !== true || parsed.command !== "await" || !record(parsed.result) || Object.keys(parsed.result).length !== 5)
+            return false;
+        const result = parsed.result;
+        return typeof result.fromAlias === "string" && ALIAS.test(result.fromAlias) && typeof result.toAlias === "string" && result.toAlias.startsWith("peer-") && ALIAS.test(result.toAlias) &&
+            typeof result.conversationId === "string" && CONVERSATION.test(result.conversationId) && typeof result.text === "string" && Buffer.byteLength(result.text) <= PROVENANCE_ENVELOPE_MAX_BYTES &&
+            typeof result.expectsReply === "boolean" && Buffer.byteLength(value.frame) <= PROVENANCE_ENVELOPE_MAX_BYTES && value.frame === `${JSON.stringify(parsed)}\n`;
+    }
+    catch {
+        return false;
+    }
+}
+export class LocalPeerMailboxProvider {
+    options;
+    identity;
+    protocol = "peer-mailbox";
+    protocolVersion = "1";
+    routes = new Map();
+    waiters = new Map();
+    receipts = new Map();
+    tombstones = new Map();
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        this.identity = Object.freeze({ provider: "peer", hostId: options.hostId });
+    }
+    async initialize() { return { health: "healthy" }; }
+    observeLogicalRoute(input) {
+        const current = this.routes.get(input.registrationId);
+        if (!this.closed && (!current || same(current, input)))
+            this.routes.set(input.registrationId, Object.freeze({ ...input }));
+    }
+    forgetLogicalRoute(registrationId) {
+        this.routes.delete(registrationId);
+        this.cancelRegistration(registrationId);
+        this.tombstones.delete(registrationId);
+    }
+    async awaitMessage(input) {
+        const route = this.routes.get(input.registrationId);
+        if (this.closed || !same(route, input))
+            throw new BridgeError("ROUTE_UNREGISTERED", "The peer mailbox binding is not current.");
+        if (this.waiters.has(input.registrationId))
+            throw new BridgeError("ROUTE_BUSY", "The peer registration already has a waiter.", true);
+        if (this.waiters.size >= MAX_WAITERS)
+            throw new BridgeError("ROUTE_CAPACITY_REACHED", "The peer waiter limit is full.", true);
+        return await new Promise((resolve) => {
+            const timer = setTimeout(() => { this.waiters.delete(input.registrationId); resolve(TIMEOUT); }, input.timeoutMs ?? this.options.awaitTimeoutMs ?? 30_000);
+            this.waiters.set(input.registrationId, { alias: input.alias, routeHandle: input.routeHandle, registrationId: input.registrationId, resolve, timer });
+        });
+    }
+    acknowledgeReceipt(input) {
+        const key = receiptKey(input);
+        const tombstone = this.tombstones.get(input.registrationId);
+        if (tombstone?.receipt === input.receipt && tombstone.key === key)
+            return "duplicate";
+        const pending = this.receipts.get(input.receipt);
+        if (!same(pending, input))
+            return "rejected";
+        if (pending.acked)
+            return "duplicate";
+        pending.acked = true;
+        if (pending.accepted)
+            this.finishReceipt(input.receipt, pending, key);
+        return "acknowledged";
+    }
+    async dispatch(input) {
+        const route = this.routes.get(input.binding.registrationId);
+        if (this.closed || input.binding.provider !== "peer" || input.binding.hostId !== this.identity.hostId || input.targetAlias !== route?.alias || input.binding.routeHandle !== route.routeHandle)
+            return { state: "failed", safeErrorCode: "ROUTE_UNREGISTERED" };
+        const waiter = this.waiters.get(route.registrationId);
+        if (waiter === undefined)
+            return { state: "deferred", safeErrorCode: "PEER_NOT_AWAITING" };
+        let text;
+        try {
+            text = composeProvenanceEnvelope({ sourceProvider: input.sourceProvider, recipientProvider: "peer", sourceAlias: input.sourceAlias, targetAlias: input.targetAlias, conversationId: input.conversationId, body: input.text });
+        }
+        catch {
+            return { state: "failed", safeErrorCode: "PROVENANCE_ENVELOPE_INVALID" };
+        }
+        const result = { fromAlias: input.sourceAlias, toAlias: input.targetAlias, conversationId: input.conversationId, text, expectsReply: input.expectsReply };
+        const frame = `${JSON.stringify({ ok: true, command: "await", result })}\n`;
+        if (Buffer.byteLength(frame) > PROVENANCE_ENVELOPE_MAX_BYTES)
+            return { state: "failed", safeErrorCode: "PROVENANCE_ENVELOPE_INVALID" };
+        const receipt = this.newReceipt();
+        const evidence = { attemptId: input.attemptId, kind: "peer_mailbox", bodyBytes: Buffer.byteLength(input.text), bodySha256: hash(input.text), frameBytes: Buffer.byteLength(frame), sha256: hash(frame) };
+        let authorized;
+        try {
+            authorized = await input.authorizeWrite(evidence);
+        }
+        catch {
+            return { state: "ambiguous", safeErrorCode: "DISPATCH_OUTCOME_AMBIGUOUS" };
+        }
+        if (!authorized)
+            return { state: "failed", safeErrorCode: "WRITE_AUTHORIZATION_DENIED" };
+        if (this.closed || this.waiters.get(route.registrationId) !== waiter)
+            return { state: "ambiguous", safeErrorCode: "DISPATCH_OUTCOME_AMBIGUOUS" };
+        clearTimeout(waiter.timer);
+        this.waiters.delete(route.registrationId);
+        const acked = new Promise((resolve) => {
+            const waitMs = Math.max(0, Math.min(this.options.receiptTimeoutMs ?? 2_147_483_647, Date.parse(input.deadlineAt) - (this.options.now?.() ?? Date.now())));
+            const timer = setTimeout(() => { this.receipts.delete(receipt); resolve(false); }, waitMs);
+            this.receipts.set(receipt, { ...route, resolve, timer, acked: false, accepted: false });
+        });
+        waiter.resolve({ state: "message", frame, receipt });
+        try {
+            await input.onAccepted({ attemptId: input.attemptId });
+        }
+        catch {
+            this.cancelReceipt(receipt);
+            return { state: "ambiguous", safeErrorCode: "DISPATCH_OUTCOME_AMBIGUOUS" };
+        }
+        const pending = this.receipts.get(receipt);
+        if (pending) {
+            pending.accepted = true;
+            if (pending.acked)
+                this.finishReceipt(receipt, pending, receiptKey({ ...route, receipt }));
+        }
+        return await acked ? { state: "delivered" } : { state: "unconfirmed", safeErrorCode: "DELIVERY_UNCONFIRMED" };
+    }
+    async close() {
+        this.closed = true;
+        for (const id of [...this.routes.keys()])
+            this.cancelRegistration(id);
+        this.routes.clear();
+        this.tombstones.clear();
+    }
+    cancelRegistration(id) {
+        const waiter = this.waiters.get(id);
+        if (waiter) {
+            clearTimeout(waiter.timer);
+            this.waiters.delete(id);
+            waiter.resolve(TIMEOUT);
+        }
+        for (const [receipt, pending] of this.receipts)
+            if (pending.registrationId === id)
+                this.cancelReceipt(receipt);
+    }
+    cancelReceipt(receipt) { const pending = this.receipts.get(receipt); if (pending) {
+        clearTimeout(pending.timer);
+        this.receipts.delete(receipt);
+        pending.resolve(false);
+    } }
+    finishReceipt(receipt, pending, key) { clearTimeout(pending.timer); this.receipts.delete(receipt); this.tombstones.set(pending.registrationId, { receipt, key }); pending.resolve(true); }
+    newReceipt() { const value = this.options.createReceipt?.() ?? `prc_${randomBytes(18).toString("base64url")}`; if (!RECEIPT.test(value) || this.receipts.has(value) || [...this.tombstones.values()].some((item) => item.receipt === value))
+        throw new Error("invalid receipt"); return value; }
+}
+const hash = (value) => createHash("sha256").update(value).digest("hex");
+const same = (left, right) => left?.alias === right.alias && left.routeHandle === right.routeHandle && left.registrationId === right.registrationId;
+const receiptKey = (input) => `${input.registrationId}\0${input.routeHandle}\0${input.alias}\0${input.receipt}`;
+const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+//# sourceMappingURL=peer-mailbox.js.map

package/dist/src/gateway/peer-mailbox.js.map

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

package/dist/src/gateway/peer-protocol.d.ts

@@ -0,0 +1,107 @@
+import { type ConnectorHealth, type GatewayProvider, type RouteState } from "./types.js";
+export declare const PEER_PROTOCOL_VERSION = 1, PEER_MAX_REQUEST_BYTES: number, PEER_MAX_CATALOG_BYTES: number, PEER_MAX_BODY_BYTES: number, PEER_REQUEST_TIMEOUT_MS = 30000, PEER_METHOD_NOT_FOUND = -32601;
+export declare const peerCapabilities: readonly ["catalog", "handoff"];
+export type PeerRpcId = string | number;
+export type PeerRpcError = Readonly<{
+    code: number;
+    message: string;
+    data?: unknown;
+}>;
+export type PeerMethod = "initialize" | "catalog/get" | "handoff";
+export type PeerEndpoint = Readonly<{
+    alias: string;
+    provider: GatewayProvider;
+    host: string;
+    routeRef: string;
+}>;
+export type PeerInitializeParams = Readonly<{
+    protocolVersion: 1;
+    host: string;
+}>;
+export type PeerInitializeResult = Readonly<{
+    protocolVersion: 1;
+    host: string;
+    capabilities: typeof peerCapabilities;
+    limits: Readonly<{
+        requestBytes: number;
+        catalogBytes: number;
+        bodyBytes: number;
+    }>;
+}>;
+export type PeerHandoffParams = Readonly<{
+    originAttemptId: string;
+    originMessageId: string;
+    source: PeerEndpoint;
+    target: PeerEndpoint;
+    edgeRef: string;
+    edgeOwnerHost: string;
+    deadlineAt: string;
+    expectsReply: boolean;
+    body: string;
+    steer?: true;
+    conversationCorrelation?: string;
+}>;
+export type PeerHandoffResult = Readonly<{
+    accepted: true;
+}>;
+export type PeerCatalogResult = Readonly<{
+    revision: number;
+    complete: boolean;
+    truncated: boolean;
+    generatedAt: string;
+    health: ConnectorHealth;
+    connectors: readonly Readonly<{
+        provider: GatewayProvider;
+        host: string;
+        health: ConnectorHealth;
+        protocol: string;
+        protocolVersion: string;
+        lastSeenAt?: string;
+        observationAgeMs?: number;
+        safeErrorCode?: string;
+    }>[];
+    routes: readonly Readonly<{
+        ref: string;
+        alias: string;
+        provider: GatewayProvider;
+        host: string;
+        enabled: boolean;
+        state: RouteState;
+        queueDepth: number;
+        lastSeenAt?: string;
+        safeErrorCode?: string;
+    }>[];
+    consentEdges: readonly Readonly<{
+        ref: string;
+        ownerHost: string;
+        endpoints: readonly [PeerEndpoint, PeerEndpoint];
+    }>[];
+    alerts: readonly Readonly<{
+        code: string;
+        severity: "info" | "warning" | "error";
+        timestamp: string;
+        provider?: GatewayProvider;
+        host?: string;
+        alias?: string;
+    }>[];
+}>;
+export type PeerMethodParams = {
+    initialize: PeerInitializeParams;
+    "catalog/get": Readonly<Record<string, never>>;
+    handoff: PeerHandoffParams;
+};
+export type PeerMethodResult = {
+    initialize: PeerInitializeResult;
+    "catalog/get": PeerCatalogResult;
+    handoff: PeerHandoffResult;
+};
+export declare class PeerProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+export declare const isPeerMethod: (value: unknown) => value is PeerMethod;
+export declare function peerEdgeRef(endpoints: readonly [PeerEndpoint, PeerEndpoint]): string;
+export declare function peerInitializeResult(localHost: string): PeerInitializeResult;
+export declare function decodePeerParams<M extends PeerMethod>(method: M, value: unknown): PeerMethodParams[M];
+export declare function decodePeerResult<M extends PeerMethod>(method: M, value: unknown): PeerMethodResult[M];
+export declare function encodePeerFrame(value: unknown, maximum: number): string;