@clawcrony/claw-crony 1.0.1

package/dist/src/internal/security.js

@@ -0,0 +1,122 @@
+/**
+ * A2A Gateway — HMAC-SHA256 signing, nonce cache, and peer registry
+ *
+ * OpenClaw gateway-internal module — NOT part of the A2A spec.
+ * A2A standard uses OAuth/API Key; this implements custom HMAC-SHA256
+ * for gateway-to-gateway communication.
+ */
+import crypto from "node:crypto";
+/** Sign a request body using HMAC-SHA256. */
+export function signRequest(body, secret, timestamp) {
+    const ts = timestamp ?? Date.now();
+    const nonce = crypto.randomUUID();
+    const data = `${ts}.${nonce}.${body}`;
+    const signature = crypto
+        .createHmac("sha256", secret)
+        .update(data)
+        .digest("hex");
+    return { signature, timestamp: ts, nonce };
+}
+/** Verify a signed request using constant-time comparison. */
+export function verifyRequest(body, signature, timestamp, nonce, secret) {
+    const data = `${timestamp}.${nonce}.${body}`;
+    const expected = crypto
+        .createHmac("sha256", secret)
+        .update(data)
+        .digest("hex");
+    // Constant-time comparison
+    const sigBuf = Buffer.from(signature, "utf8");
+    const expBuf = Buffer.from(expected, "utf8");
+    if (sigBuf.length !== expBuf.length) {
+        return { valid: false, error: "Signature length mismatch" };
+    }
+    if (!crypto.timingSafeEqual(sigBuf, expBuf)) {
+        return { valid: false, error: "Signature mismatch" };
+    }
+    return { valid: true };
+}
+// ---------------------------------------------------------------------------
+// Timestamp check
+// ---------------------------------------------------------------------------
+/** Check if a timestamp is within the acceptable skew window. */
+export function checkTimestamp(timestamp, skewSeconds) {
+    const now = Date.now();
+    const diff = Math.abs(now - timestamp);
+    const maxDiff = skewSeconds * 1000;
+    if (diff > maxDiff) {
+        return {
+            valid: false,
+            error: `Timestamp skew ${Math.round(diff / 1000)}s exceeds limit ${skewSeconds}s`,
+        };
+    }
+    return { valid: true };
+}
+/** In-memory nonce cache with TTL and automatic cleanup. */
+export class NonceCache {
+    cache = new Map();
+    cleanupTimer = null;
+    constructor(cleanupIntervalMs = 60_000) {
+        this.cleanupTimer = setInterval(() => this.cleanup(), cleanupIntervalMs);
+        // Allow the process to exit even if the timer is still running
+        this.cleanupTimer.unref();
+    }
+    /** Add a nonce. Returns false if it already exists and is not expired (replay detected). */
+    add(nonce, ttlMs) {
+        const existing = this.cache.get(nonce);
+        if (existing) {
+            if (existing.expiresAt <= Date.now()) {
+                // Expired entry — safe to reuse
+                this.cache.delete(nonce);
+            }
+            else {
+                return false;
+            }
+        }
+        this.cache.set(nonce, { expiresAt: Date.now() + ttlMs });
+        return true;
+    }
+    /** Check if a nonce exists in the cache. */
+    has(nonce) {
+        return this.cache.has(nonce);
+    }
+    /** Remove expired entries. */
+    cleanup() {
+        const now = Date.now();
+        for (const [nonce, entry] of this.cache) {
+            if (entry.expiresAt <= now) {
+                this.cache.delete(nonce);
+            }
+        }
+    }
+    /** Stop the automatic cleanup interval. */
+    destroy() {
+        if (this.cleanupTimer !== null) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Peer registry
+// ---------------------------------------------------------------------------
+/** Manage known peers and their HMAC secrets. */
+export class PeerRegistry {
+    peers = new Map();
+    /** Register a peer. */
+    addPeer(config) {
+        this.peers.set(config.gatewayId, config);
+    }
+    /** Get peer config by gateway ID. */
+    getPeer(gatewayId) {
+        return this.peers.get(gatewayId);
+    }
+    /** Check if a peer is registered. */
+    isKnown(gatewayId) {
+        return this.peers.has(gatewayId);
+    }
+    /** Get the HMAC secret for a peer. */
+    getSecret(gatewayId) {
+        return this.peers.get(gatewayId)?.hmacSecret;
+    }
+}
+//# sourceMappingURL=security.js.map

package/dist/src/internal/security.js.map

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

package/dist/src/internal/transport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * A2A Gateway — HTTP Transport Layer
+ *
+ * OpenClaw gateway-internal module — NOT part of the A2A spec.
+ * Uses only Node.js built-in modules (http, https).
+ */
+import type { A2AEnvelope } from "./types-internal.js";
+export interface InboundHeaders {
+    signature: string;
+    timestamp: number;
+    nonce: string;
+    sourceGatewayId: string;
+}
+export interface InboundHandlers {
+    onMessage(envelope: A2AEnvelope, rawBody: string, headers: InboundHeaders): Promise<{
+        statusCode: number;
+        body: string;
+    }>;
+}
+export declare class InboundServer {
+    private server;
+    private readonly config;
+    private readonly handlers;
+    constructor(config: {
+        host: string;
+        port: number;
+    }, handlers: InboundHandlers);
+    /** Start the HTTP server. Resolves once the server is listening. */
+    start(): Promise<void>;
+    /** Gracefully stop the server. */
+    stop(): Promise<void>;
+    private handleRequest;
+    private processBody;
+    private readBody;
+    private headerString;
+    private sendJson;
+}
+export interface OutboundResult {
+    success: boolean;
+    statusCode: number;
+    body: string;
+}
+export declare class OutboundClient {
+    /**
+     * Send an A2A envelope to a remote gateway.
+     */
+    send(url: string, envelope: A2AEnvelope, signature: string, timestamp: number, nonce: string, sourceGatewayId: string): Promise<OutboundResult>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/src/internal/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/internal/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAcD,MAAM,WAAW,eAAe;IAC9B,SAAS,CACP,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAGzC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EACtC,QAAQ,EAAE,eAAe;IAM3B,oEAAoE;IACpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrB,OAAO,CAAC,aAAa;YA0CP,WAAW;IAmCzB,OAAO,CAAC,QAAQ;IAyBhB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,QAAQ;CAYjB;AAMD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,cAAc;IACzB;;OAEG;IACH,IAAI,CACF,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,cAAc,CAAC;CA4D3B"}

package/dist/src/internal/transport.js

@@ -0,0 +1,207 @@
+/**
+ * A2A Gateway — HTTP Transport Layer
+ *
+ * OpenClaw gateway-internal module — NOT part of the A2A spec.
+ * Uses only Node.js built-in modules (http, https).
+ */
+import http from "node:http";
+import https from "node:https";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_BODY_BYTES = 2 * 1024 * 1024; // 2 MB
+const INBOX_PATH = "/a2a/v1/inbox";
+const OUTBOUND_TIMEOUT_MS = 30_000;
+export class InboundServer {
+    server = null;
+    config;
+    handlers;
+    constructor(config, handlers) {
+        this.config = config;
+        this.handlers = handlers;
+    }
+    /** Start the HTTP server. Resolves once the server is listening. */
+    start() {
+        return new Promise((resolve, reject) => {
+            this.server = http.createServer((req, res) => {
+                this.handleRequest(req, res);
+            });
+            this.server.once("error", reject);
+            this.server.listen(this.config.port, this.config.host, () => {
+                this.server.removeListener("error", reject);
+                resolve();
+            });
+        });
+    }
+    /** Gracefully stop the server. */
+    stop() {
+        return new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(() => resolve());
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Internal request handler
+    // -------------------------------------------------------------------------
+    handleRequest(req, res) {
+        // Route check
+        let url;
+        try {
+            url = new URL(req.url ?? "/", "http://localhost");
+        }
+        catch {
+            this.sendJson(res, 400, { error: "Malformed URL" });
+            return;
+        }
+        if (url.pathname !== INBOX_PATH) {
+            this.sendJson(res, 404, { error: "Not found" });
+            return;
+        }
+        // Method check
+        if (req.method !== "POST") {
+            this.sendJson(res, 405, { error: "Method not allowed" });
+            return;
+        }
+        // Content-Type check
+        const contentType = req.headers["content-type"] ?? "";
+        if (!contentType.includes("application/json")) {
+            this.sendJson(res, 400, { error: "Content-Type must be application/json" });
+            return;
+        }
+        // Read body with size limit
+        this.readBody(req)
+            .then((rawBody) => this.processBody(rawBody, req, res))
+            .catch((err) => {
+            if (err.code === "PAYLOAD_TOO_LARGE") {
+                this.sendJson(res, 413, { error: "Payload too large" });
+            }
+            else {
+                this.sendJson(res, 500, { error: "Internal server error" });
+            }
+        });
+    }
+    async processBody(rawBody, req, res) {
+        // Parse JSON
+        let envelope;
+        try {
+            envelope = JSON.parse(rawBody);
+        }
+        catch {
+            this.sendJson(res, 400, { error: "Invalid JSON" });
+            return;
+        }
+        // Extract security headers
+        const headers = {
+            signature: this.headerString(req, "x-a2a-signature"),
+            timestamp: Number(this.headerString(req, "x-a2a-timestamp")) || 0,
+            nonce: this.headerString(req, "x-a2a-nonce"),
+            sourceGatewayId: this.headerString(req, "x-a2a-source-gateway"),
+        };
+        // Delegate to handler
+        try {
+            const result = await this.handlers.onMessage(envelope, rawBody, headers);
+            this.sendJson(res, result.statusCode, JSON.parse(result.body));
+        }
+        catch {
+            this.sendJson(res, 500, { error: "Internal server error" });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let totalBytes = 0;
+            req.on("data", (chunk) => {
+                totalBytes += chunk.length;
+                if (totalBytes > MAX_BODY_BYTES) {
+                    req.destroy();
+                    const err = new Error("Payload too large");
+                    err.code = "PAYLOAD_TOO_LARGE";
+                    reject(err);
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on("end", () => {
+                resolve(Buffer.concat(chunks).toString("utf8"));
+            });
+            req.on("error", reject);
+        });
+    }
+    headerString(req, name) {
+        const value = req.headers[name];
+        if (Array.isArray(value))
+            return value[0] ?? "";
+        return value ?? "";
+    }
+    sendJson(res, statusCode, body) {
+        const payload = JSON.stringify(body);
+        res.writeHead(statusCode, {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(payload, "utf8"),
+        });
+        res.end(payload);
+    }
+}
+export class OutboundClient {
+    /**
+     * Send an A2A envelope to a remote gateway.
+     */
+    send(url, envelope, signature, timestamp, nonce, sourceGatewayId) {
+        return new Promise((resolve) => {
+            const parsed = new URL(url);
+            const isHttps = parsed.protocol === "https:";
+            const transport = isHttps ? https : http;
+            const body = JSON.stringify(envelope);
+            const options = {
+                hostname: parsed.hostname,
+                port: parsed.port || (isHttps ? 443 : 80),
+                path: parsed.pathname + parsed.search,
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Content-Length": Buffer.byteLength(body, "utf8"),
+                    "X-A2A-Signature": signature,
+                    "X-A2A-Timestamp": String(timestamp),
+                    "X-A2A-Nonce": nonce,
+                    "X-A2A-Source-Gateway": sourceGatewayId,
+                },
+                timeout: OUTBOUND_TIMEOUT_MS,
+            };
+            const req = transport.request(options, (res) => {
+                const chunks = [];
+                res.on("data", (chunk) => chunks.push(chunk));
+                res.on("end", () => {
+                    const responseBody = Buffer.concat(chunks).toString("utf8");
+                    const statusCode = res.statusCode ?? 0;
+                    resolve({
+                        success: statusCode >= 200 && statusCode < 300,
+                        statusCode,
+                        body: responseBody,
+                    });
+                });
+                res.on("error", () => {
+                    resolve({ success: false, statusCode: 0, body: "Response read error" });
+                });
+            });
+            req.on("timeout", () => {
+                req.destroy();
+                resolve({ success: false, statusCode: 0, body: "Request timeout" });
+            });
+            req.on("error", (err) => {
+                resolve({
+                    success: false,
+                    statusCode: 0,
+                    body: err.message || "Connection error",
+                });
+            });
+            req.end(body);
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/internal/transport.js.map

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

package/dist/src/internal/types-internal.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Gateway-internal types — NOT part of the A2A spec.
+ *
+ * These types support the OpenClaw gateway-to-gateway protocol layer
+ * (custom envelope format, HMAC signing, routing, outbox, idempotency, metrics).
+ * They are separate from the standard A2A types used by the SDK integration.
+ */
+export interface A2ASource {
+    gateway_id: string;
+    agent_id?: string;
+}
+export interface A2ADestination {
+    gateway_id?: string;
+    agent_id?: string;
+    route_key?: string;
+}
+export type MessageType = "command" | "event" | "response" | "error" | "ack";
+export interface A2AEnvelope {
+    protocol_version: string;
+    message_id: string;
+    idempotency_key: string;
+    correlation_id?: string;
+    timestamp: string;
+    ttl_seconds: number;
+    trace_id?: string;
+    span_id?: string;
+    source: A2ASource;
+    destination: A2ADestination;
+    message_type: MessageType;
+    hop_count: number;
+    route_path: string[];
+    payload: unknown;
+}
+export interface A2AAck {
+    protocol_version: string;
+    message_id: string;
+    correlation_id: string;
+    source: {
+        gateway_id: string;
+    };
+    message_type: "ack";
+    timestamp: string;
+    status: "accepted" | "rejected";
+    reason?: string;
+}
+export interface A2AConfig {
+    gatewayId: string;
+    limits: {
+        maxHops: number;
+        maxPayloadBytes: number;
+    };
+}
+export interface RoutingRule {
+    routeKey: string;
+    agentId: string;
+}
+export interface RouteResult {
+    agentId: string;
+    matched_by: "agent_id" | "route_key" | "default";
+}
+export type OutboxStatus = "pending" | "sending" | "sent" | "failed" | "dead";
+export interface OutboxEntry {
+    id: string;
+    status: OutboxStatus;
+    retry_count: number;
+    next_retry_at: number;
+    created_at: number;
+    last_error?: string;
+    [key: string]: unknown;
+}
+export interface IdempotencyEntry {
+    idempotency_key: string;
+    payload_fingerprint: string;
+    response: string;
+    created_at: number;
+    expires_at: number;
+}
+export interface A2AMetrics {
+    messages_sent: number;
+    messages_received: number;
+    acks_sent: number;
+    retries: number;
+    idempotent_hits: number;
+    dead_letters: number;
+    errors: number;
+    security_rejections: number;
+    loop_rejections: number;
+    last_send_at?: string;
+    last_receive_at?: string;
+}
+export interface InternalPeerConfig {
+    gatewayId: string;
+    hmacSecret: string;
+}
+//# sourceMappingURL=types-internal.d.ts.map

package/dist/src/internal/types-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-internal.d.ts","sourceRoot":"","sources":["../../../src/internal/types-internal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,cAAc,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;CAClD;AAMD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/src/internal/types-internal.js

@@ -0,0 +1,9 @@
+/**
+ * Gateway-internal types — NOT part of the A2A spec.
+ *
+ * These types support the OpenClaw gateway-to-gateway protocol layer
+ * (custom envelope format, HMAC signing, routing, outbox, idempotency, metrics).
+ * They are separate from the standard A2A types used by the SDK integration.
+ */
+export {};
+//# sourceMappingURL=types-internal.js.map

package/dist/src/internal/types-internal.js.map

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

package/dist/src/peer-health.d.ts

@@ -0,0 +1,47 @@
+import type { PeerConfig, HealthCheckConfig, CircuitBreakerConfig, PeerState } from "./types.js";
+type LogFn = (level: "info" | "warn" | "error", msg: string, details?: Record<string, unknown>) => void;
+type HealthProbe = (peer: PeerConfig) => Promise<boolean>;
+/**
+ * Manages per-peer health checks and circuit breaker state.
+ *
+ * Health checks periodically probe each peer's Agent Card endpoint.
+ * The circuit breaker follows the standard three-state pattern:
+ *   closed → open → half-open → closed
+ */
+export declare class PeerHealthManager {
+    private readonly states;
+    private readonly peers;
+    private readonly healthConfig;
+    private readonly cbConfig;
+    private readonly probe;
+    private readonly log;
+    private timer;
+    private halfOpenInFlight;
+    /** Cached skills per peer, refreshed on each successful health check probe. */
+    private readonly peerSkills;
+    constructor(peers: PeerConfig[], healthConfig: HealthCheckConfig, cbConfig: CircuitBreakerConfig, probe: HealthProbe, log: LogFn);
+    /** Start periodic health checks. */
+    start(): void;
+    /** Stop periodic health checks. */
+    stop(): void;
+    /** Check if a peer is available for requests (circuit is not open). */
+    isAvailable(peerName: string): boolean;
+    /** Record a successful call to a peer. */
+    recordSuccess(peerName: string): void;
+    /** Record a failed call to a peer. May trigger circuit open. */
+    recordFailure(peerName: string): void;
+    /** Get state for a single peer. */
+    getState(peerName: string): PeerState | undefined;
+    /** Get states for all peers. */
+    getAllStates(): Map<string, PeerState>;
+    /** Get cached skills for all peers (populated during health checks). */
+    getPeerSkills(): Map<string, string[]>;
+    /** Update cached skills for a peer (called by the health probe). */
+    setPeerSkills(peerName: string, skills: string[]): void;
+    /** Run health checks for all peers. */
+    private runHealthChecks;
+    /** Probe a single peer and update its state. */
+    private checkPeer;
+}
+export {};
+//# sourceMappingURL=peer-health.d.ts.map

package/dist/src/peer-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-health.d.ts","sourceRoot":"","sources":["../../src/peer-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EAGpB,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AACxG,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;gBAGxD,KAAK,EAAE,UAAU,EAAE,EACnB,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,KAAK;IAoBZ,oCAAoC;IACpC,KAAK,IAAI,IAAI;IAab,mCAAmC;IACnC,IAAI,IAAI,IAAI;IAOZ,uEAAuE;IACvE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IA0BtC,0CAA0C;IAC1C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkBrC,gEAAgE;IAChE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkCrC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD,gCAAgC;IAChC,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAItC,wEAAwE;IACxE,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAItC,oEAAoE;IACpE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvD,uCAAuC;IACvC,OAAO,CAAC,eAAe;IAWvB,gDAAgD;YAClC,SAAS;CAcxB"}