@clawcrony/claw-crony 1.0.1

package/dist/src/telemetry.js

@@ -0,0 +1,235 @@
+import { A2AMetricsCollector } from "./internal/metrics.js";
+export class GatewayTelemetry {
+    collector = new A2AMetricsCollector();
+    logger;
+    structuredLogs;
+    http = {
+        requests_total: 0,
+        jsonrpc_requests: 0,
+        rest_requests: 0,
+        metrics_requests: 0,
+        outbound_requests: 0,
+        security_rejections: 0,
+    };
+    tasks = {
+        queued: 0,
+        started: 0,
+        completed: 0,
+        failed: 0,
+        canceled: 0,
+        rejected: 0,
+        timed_out: 0,
+        queue_rejections: 0,
+        active: 0,
+        queue_depth: 0,
+        max_active_observed: 0,
+        max_queue_depth_observed: 0,
+        total_duration_ms: 0,
+        finished: 0,
+        expired: 0,
+    };
+    peerRetries = {};
+    peerStateProvider = null;
+    taskAuditCallback = null;
+    constructor(logger, options = {}) {
+        this.logger = logger;
+        this.structuredLogs = options.structuredLogs !== false;
+    }
+    /** Register a callback to retrieve peer health states for the metrics snapshot. */
+    setPeerStateProvider(provider) {
+        this.peerStateProvider = provider;
+    }
+    /** Register a callback for audit logging on task completion. */
+    setTaskAuditCallback(callback) {
+        this.taskAuditCallback = callback;
+    }
+    recordInboundHttp(route, statusCode, durationMs) {
+        this.collector.recordReceive();
+        this.http.requests_total += 1;
+        this.http.last_request_at = new Date().toISOString();
+        if (route === "jsonrpc") {
+            this.http.jsonrpc_requests += 1;
+        }
+        else if (route === "rest") {
+            this.http.rest_requests += 1;
+        }
+        else {
+            this.http.metrics_requests += 1;
+        }
+        this.log("info", "http.request", {
+            route,
+            status_code: statusCode,
+            duration_ms: durationMs,
+        });
+    }
+    recordOutboundRequest(peer, ok, statusCode, durationMs) {
+        this.http.outbound_requests += 1;
+        if (ok) {
+            this.collector.recordSend();
+        }
+        else {
+            this.collector.recordError();
+        }
+        this.log(ok ? "info" : "warn", "peer.request", {
+            peer,
+            ok,
+            status_code: statusCode,
+            duration_ms: durationMs,
+        });
+    }
+    recordPeerHealthCheck(peerName, healthy) {
+        this.log(healthy ? "info" : "warn", "peer.health", {
+            peer: peerName,
+            healthy,
+        });
+    }
+    recordPeerCircuitChange(peerName, newState) {
+        this.log(newState === "closed" ? "info" : "warn", "peer.circuit", {
+            peer: peerName,
+            state: newState,
+        });
+    }
+    recordPeerRetry(peerName, attempt) {
+        this.peerRetries[peerName] = (this.peerRetries[peerName] || 0) + 1;
+        this.log("warn", "peer.retry", {
+            peer: peerName,
+            attempt,
+            total_retries: this.peerRetries[peerName],
+        });
+    }
+    getPeerRetries() {
+        return { ...this.peerRetries };
+    }
+    recordSecurityRejection(surface, reason) {
+        this.collector.recordSecurityRejection();
+        this.http.security_rejections += 1;
+        this.log("warn", "security.rejection", {
+            surface,
+            reason,
+        });
+    }
+    recordTaskQueued(taskId, contextId, position, queueDepth) {
+        this.tasks.queued += 1;
+        this.setQueueState(this.tasks.active, queueDepth);
+        this.log("info", "task.queued", {
+            task_id: taskId,
+            context_id: contextId,
+            queue_position: position,
+            queue_depth: queueDepth,
+        });
+    }
+    recordTaskStart(taskId, contextId, agentId, activeCount, queueDepth) {
+        this.tasks.started += 1;
+        this.tasks.last_started_at = new Date().toISOString();
+        this.setQueueState(activeCount, queueDepth);
+        this.log("info", "task.started", {
+            task_id: taskId,
+            context_id: contextId,
+            agent_id: agentId,
+            active_tasks: activeCount,
+            queue_depth: queueDepth,
+        });
+    }
+    recordTaskFinish(taskId, contextId, state, durationMs, activeCount, queueDepth, errorMessage) {
+        this.tasks.finished += 1;
+        this.tasks.total_duration_ms += durationMs;
+        this.tasks.last_finished_at = new Date().toISOString();
+        this.setQueueState(activeCount, queueDepth);
+        if (state === "completed") {
+            this.tasks.completed += 1;
+        }
+        else if (state === "failed") {
+            this.tasks.failed += 1;
+            this.collector.recordError();
+            if (this.isTimeoutError(errorMessage)) {
+                this.tasks.timed_out += 1;
+            }
+        }
+        else if (state === "canceled") {
+            this.tasks.canceled += 1;
+        }
+        else if (state === "rejected") {
+            this.tasks.rejected += 1;
+        }
+        this.log(state === "completed" ? "info" : "warn", "task.finished", {
+            task_id: taskId,
+            context_id: contextId,
+            state,
+            duration_ms: durationMs,
+            active_tasks: activeCount,
+            queue_depth: queueDepth,
+            error: errorMessage,
+        });
+        this.taskAuditCallback?.(taskId, contextId, state, durationMs);
+    }
+    recordQueueRejected(taskId, contextId, queueDepth) {
+        this.tasks.queue_rejections += 1;
+        this.tasks.rejected += 1;
+        this.setQueueState(this.tasks.active, queueDepth);
+        this.log("warn", "task.queue_rejected", {
+            task_id: taskId,
+            context_id: contextId,
+            queue_depth: queueDepth,
+        });
+    }
+    recordTaskExpired(taskId, state) {
+        this.tasks.expired += 1;
+        this.tasks.last_cleanup_at = new Date().toISOString();
+        this.log("info", "task.expired", {
+            task_id: taskId,
+            state,
+        });
+    }
+    snapshot() {
+        const averageDuration = this.tasks.finished > 0
+            ? Number((this.tasks.total_duration_ms / this.tasks.finished).toFixed(2))
+            : 0;
+        // Build peer metrics from health manager state + retry counters
+        const peers = {};
+        if (this.peerStateProvider) {
+            const states = this.peerStateProvider();
+            for (const [name, state] of states) {
+                peers[name] = {
+                    health: state.health,
+                    circuit: state.circuit,
+                    consecutive_failures: state.consecutiveFailures,
+                    total_retries: this.peerRetries[name] || 0,
+                    last_check_at: state.lastCheckAt
+                        ? new Date(state.lastCheckAt).toISOString()
+                        : undefined,
+                };
+            }
+        }
+        return {
+            protocol: this.collector.getMetrics(),
+            http: { ...this.http },
+            tasks: {
+                ...this.tasks,
+                average_duration_ms: averageDuration,
+            },
+            peers,
+        };
+    }
+    setQueueState(activeCount, queueDepth) {
+        this.tasks.active = activeCount;
+        this.tasks.queue_depth = queueDepth;
+        this.tasks.max_active_observed = Math.max(this.tasks.max_active_observed, activeCount);
+        this.tasks.max_queue_depth_observed = Math.max(this.tasks.max_queue_depth_observed, queueDepth);
+    }
+    isTimeoutError(errorMessage) {
+        return typeof errorMessage === "string" && /timed out/i.test(errorMessage);
+    }
+    log(level, event, details) {
+        if (!this.structuredLogs) {
+            return;
+        }
+        const payload = JSON.stringify({
+            ts: new Date().toISOString(),
+            component: "a2a-gateway",
+            event,
+            ...details,
+        });
+        this.logger[level](payload);
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/src/telemetry.js.map

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

package/dist/src/transport-fallback.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Transport fallback helpers for A2A outbound sends.
+ *
+ * When a peer's Agent Card advertises multiple transports via
+ * `additionalInterfaces`, this module provides utilities to order
+ * them by priority and to decide whether a send error is retryable
+ * at the transport level (as opposed to auth / protocol errors that
+ * would fail identically on every transport).
+ */
+/** Canonical transport protocol names from the A2A v0.3.0 spec. */
+export type TransportPriority = "JSONRPC" | "HTTP+JSON" | "GRPC";
+export interface TransportEndpoint {
+    url: string;
+    transport: string;
+}
+/**
+ * Sort transport endpoints by priority (JSON-RPC > REST > gRPC).
+ * Unknown transports are appended at the end in their original order.
+ */
+export declare function orderTransports(interfaces: TransportEndpoint[]): TransportEndpoint[];
+/**
+ * Returns `true` when the error indicates a transport-level problem that
+ * could succeed on a different transport (connection refused, timeout, 5xx).
+ *
+ * Auth errors (401/403) and A2A protocol errors are NOT retryable because
+ * they would fail identically on every transport.
+ */
+export declare function isRetryableTransportError(error: unknown): boolean;
+//# sourceMappingURL=transport-fallback.d.ts.map

package/dist/src/transport-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-fallback.d.ts","sourceRoot":"","sources":["../../src/transport-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAKjE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAmBpF;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2CjE"}

package/dist/src/transport-fallback.js

@@ -0,0 +1,81 @@
+/**
+ * Transport fallback helpers for A2A outbound sends.
+ *
+ * When a peer's Agent Card advertises multiple transports via
+ * `additionalInterfaces`, this module provides utilities to order
+ * them by priority and to decide whether a send error is retryable
+ * at the transport level (as opposed to auth / protocol errors that
+ * would fail identically on every transport).
+ */
+/** Fallback order: JSON-RPC first, REST second, gRPC last. */
+const PRIORITY_ORDER = ["JSONRPC", "HTTP+JSON", "GRPC"];
+/**
+ * Sort transport endpoints by priority (JSON-RPC > REST > gRPC).
+ * Unknown transports are appended at the end in their original order.
+ */
+export function orderTransports(interfaces) {
+    const known = [];
+    const unknown = [];
+    // Bucket by known vs unknown
+    for (const iface of interfaces) {
+        if (PRIORITY_ORDER.includes(iface.transport)) {
+            known.push(iface);
+        }
+        else {
+            unknown.push(iface);
+        }
+    }
+    // Sort known by priority index
+    known.sort((a, b) => PRIORITY_ORDER.indexOf(a.transport) - PRIORITY_ORDER.indexOf(b.transport));
+    return [...known, ...unknown];
+}
+// ---------------------------------------------------------------------------
+// Error classification
+// ---------------------------------------------------------------------------
+/**
+ * Returns `true` when the error indicates a transport-level problem that
+ * could succeed on a different transport (connection refused, timeout, 5xx).
+ *
+ * Auth errors (401/403) and A2A protocol errors are NOT retryable because
+ * they would fail identically on every transport.
+ */
+export function isRetryableTransportError(error) {
+    if (!error)
+        return false;
+    // Fetch / network errors thrown as Error objects
+    if (error instanceof Error) {
+        const msg = error.message.toLowerCase();
+        return (msg.includes("econnrefused") ||
+            msg.includes("econnreset") ||
+            msg.includes("etimedout") ||
+            msg.includes("epipe") ||
+            msg.includes("fetch failed") ||
+            msg.includes("network") ||
+            msg.includes("socket") ||
+            msg.includes("abort") ||
+            msg.includes("timeout") ||
+            msg.includes("timed out") ||
+            msg.includes("dns") ||
+            msg.includes("enotfound") ||
+            // gRPC transport errors
+            msg.includes("unavailable") ||
+            msg.includes("deadline exceeded"));
+    }
+    // HTTP response-like objects with a status code
+    if (error &&
+        typeof error === "object" &&
+        "statusCode" in error &&
+        typeof error.statusCode === "number") {
+        const code = error.statusCode;
+        // 5xx = server error → could be transport-specific → retry
+        // 429 = rate limit → transport-specific → retry
+        if (code >= 500 || code === 429)
+            return true;
+        // 401/403 = auth → would fail on all transports → no retry
+        // Other 4xx = client error → no retry
+        return false;
+    }
+    // Unknown shape → not retryable (be conservative)
+    return false;
+}
+//# sourceMappingURL=transport-fallback.js.map

package/dist/src/transport-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-fallback.js","sourceRoot":"","sources":["../../src/transport-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,8DAA8D;AAC9D,MAAM,cAAc,GAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAO3E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAA+B;IAC7D,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,6BAA6B;IAC7B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,IAAI,CACR,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CACpF,CAAC;IAEF,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,iDAAiD;IACjD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5B,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC1B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;YACzB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrB,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC5B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;YACvB,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACtB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;YACvB,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;YACzB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YACnB,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;YACzB,wBAAwB;YACxB,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3B,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAClC,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,YAAY,IAAI,KAAK;QACrB,OAAQ,KAAa,CAAC,UAAU,KAAK,QAAQ,EAC7C,CAAC;QACD,MAAM,IAAI,GAAI,KAAa,CAAC,UAAoB,CAAC;QACjD,2DAA2D;QAC3D,gDAAgD;QAChD,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAC7C,2DAA2D;QAC3D,sCAAsC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kDAAkD;IAClD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,160 @@
+/**
+ * A2A Gateway Plugin — Standard types
+ *
+ * These types support the A2A v0.3.0 protocol integration via @a2a-js/sdk.
+ */
+export type { OpenClawPluginApi, PluginLogger, OpenClawConfig } from "openclaw/plugin-sdk";
+export type InboundAuth = "none" | "bearer";
+export type PeerAuthType = "bearer" | "apiKey";
+export interface PeerAuthConfig {
+    type: PeerAuthType;
+    token: string;
+}
+export interface PeerConfig {
+    name: string;
+    agentCardUrl: string;
+    auth?: PeerAuthConfig;
+}
+export interface AgentSkillConfig {
+    id?: string;
+    name: string;
+    description?: string;
+}
+export interface AgentCardConfig {
+    name: string;
+    description?: string;
+    url?: string;
+    skills: Array<AgentSkillConfig | string>;
+}
+export interface FileSecurityConfig {
+    /** Allowed MIME type patterns (e.g. "image/*", "application/pdf"). */
+    allowedMimeTypes: string[];
+    /** Max file size in bytes for URI-based files (default 50MB). */
+    maxFileSizeBytes: number;
+    /** Max file size in bytes for inline base64 files (default 10MB). */
+    maxInlineFileSizeBytes: number;
+    /** URI hostname allowlist patterns (e.g. "*.example.com"). Empty = allow all public hosts. */
+    fileUriAllowlist: string[];
+}
+export interface SecurityConfig extends FileSecurityConfig {
+    inboundAuth: InboundAuth;
+    token?: string;
+    tokens?: string[];
+    /** Runtime-merged set of all valid tokens (from `token` + `tokens`, deduplicated). */
+    validTokens: Set<string>;
+}
+export interface GatewayConfig {
+    agentCard: AgentCardConfig;
+    server: {
+        host: string;
+        port: number;
+    };
+    storage: {
+        tasksDir: string;
+        taskTtlHours: number;
+        cleanupIntervalMinutes: number;
+    };
+    peers: PeerConfig[];
+    security: SecurityConfig;
+    routing: {
+        defaultAgentId: string;
+        rules?: RoutingRule[];
+    };
+    limits: {
+        maxConcurrentTasks: number;
+        maxQueuedTasks: number;
+    };
+    observability: {
+        structuredLogs: boolean;
+        exposeMetricsEndpoint: boolean;
+        metricsPath: string;
+        metricsAuth: "none" | "bearer";
+        auditLogPath: string;
+    };
+    timeouts?: {
+        /**
+         * Max time to wait for the underlying OpenClaw agent run to finish (Gateway RPC `agent`).
+         * Long-running prompts should use async task mode (blocking=false) + tasks/get polling.
+         */
+        agentResponseTimeoutMs?: number;
+    };
+    resilience: PeerResilienceConfig;
+    hub?: HubConfig;
+    registration?: RegistrationConfig;
+}
+export interface HubConfig {
+    url: string;
+    enabled: boolean;
+    registrationEnabled: boolean;
+}
+export interface RegistrationConfig {
+    username?: string;
+    email?: string;
+    skills?: string[];
+}
+export interface HubRegistrationData {
+    version: number;
+    hubUrl: string;
+    agentId: number;
+    address: string;
+    token: string;
+    registeredAt: string;
+    name: string;
+    description: string;
+    skills: string[];
+}
+export interface HealthCheckConfig {
+    enabled: boolean;
+    intervalMs: number;
+    timeoutMs: number;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeoutMs: number;
+}
+export interface PeerResilienceConfig {
+    healthCheck: HealthCheckConfig;
+    retry: RetryConfig;
+    circuitBreaker: CircuitBreakerConfig;
+}
+export type CircuitState = "closed" | "open" | "half-open";
+export type HealthStatus = "healthy" | "unhealthy" | "unknown";
+export interface PeerState {
+    health: HealthStatus;
+    circuit: CircuitState;
+    consecutiveFailures: number;
+    lastFailureAt: number | null;
+    lastCheckAt: number | null;
+}
+export interface OutboundSendResult {
+    ok: boolean;
+    statusCode: number;
+    response: unknown;
+}
+export interface RoutingRule {
+    name: string;
+    match: {
+        /** Regex pattern to match against message text (case-insensitive). */
+        pattern?: string;
+        /** Match if message contains any of these tags (OR logic). */
+        tags?: string[];
+        /** Match if target peer has any of these skills. */
+        skills?: string[];
+    };
+    target: {
+        peer: string;
+        agentId?: string;
+    };
+    /** Higher = checked first (default: 0). */
+    priority?: number;
+}
+export interface RoutingMatch {
+    peer: string;
+    agentId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,7 @@
+/**
+ * A2A Gateway Plugin — Standard types
+ *
+ * These types support the A2A v0.3.0 protocol integration via @a2a-js/sdk.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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