@mce-bt/microagents-communication 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generate an HMAC signature for a request.
+ */
+export declare function signRequest(sharedSecret: string, payload: string, timestamp: string): string;
+/**
+ * Verify an HMAC signature from a request.
+ * Uses timing-safe comparison to prevent timing attacks.
+ */
+export declare function verifySignature(sharedSecret: string, payload: string, timestamp: string, signature: string): boolean;
+/**
+ * Verify a signature against multiple secrets (supports secret rotation).
+ * Returns true if ANY secret produces a valid signature.
+ */
+export declare function verifySignatureWithRotation(secrets: string[], payload: string, timestamp: string, signature: string): boolean;
+/**
+ * Check that a request timestamp is within an acceptable window (default: 5 minutes).
+ */
+export declare function isTimestampValid(timestamp: string, windowMs?: number): boolean;
+/**
+ * Sanitize a string input by removing control characters and null bytes.
+ * Preserves normal whitespace (spaces, tabs, newlines).
+ */
+export declare function sanitizeString(input: string): string;
+/**
+ * Deep-sanitize an object: recursively sanitize all string values.
+ */
+export declare function sanitizeInput<T>(input: T): T;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAM7F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAe5C"}

package/dist/auth.js

@@ -0,0 +1,65 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+const HMAC_ALGORITHM = 'sha256';
+/**
+ * Generate an HMAC signature for a request.
+ */
+export function signRequest(sharedSecret, payload, timestamp) {
+    const data = `${timestamp}.${payload}`;
+    return createHmac(HMAC_ALGORITHM, sharedSecret).update(data).digest('hex');
+}
+/**
+ * Verify an HMAC signature from a request.
+ * Uses timing-safe comparison to prevent timing attacks.
+ */
+export function verifySignature(sharedSecret, payload, timestamp, signature) {
+    const expected = signRequest(sharedSecret, payload, timestamp);
+    if (expected.length !== signature.length) {
+        return false;
+    }
+    return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+}
+/**
+ * Verify a signature against multiple secrets (supports secret rotation).
+ * Returns true if ANY secret produces a valid signature.
+ */
+export function verifySignatureWithRotation(secrets, payload, timestamp, signature) {
+    return secrets.some((secret) => verifySignature(secret, payload, timestamp, signature));
+}
+/**
+ * Check that a request timestamp is within an acceptable window (default: 5 minutes).
+ */
+export function isTimestampValid(timestamp, windowMs = 5 * 60 * 1000) {
+    const ts = parseInt(timestamp, 10);
+    if (isNaN(ts))
+        return false;
+    const now = Date.now();
+    return Math.abs(now - ts) <= windowMs;
+}
+/**
+ * Sanitize a string input by removing control characters and null bytes.
+ * Preserves normal whitespace (spaces, tabs, newlines).
+ */
+export function sanitizeString(input) {
+    // Remove null bytes and control characters except \t, \n, \r
+    return input.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '');
+}
+/**
+ * Deep-sanitize an object: recursively sanitize all string values.
+ */
+export function sanitizeInput(input) {
+    if (typeof input === 'string') {
+        return sanitizeString(input);
+    }
+    if (Array.isArray(input)) {
+        return input.map(sanitizeInput);
+    }
+    if (input !== null && typeof input === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(input)) {
+            result[sanitizeString(key)] = sanitizeInput(value);
+        }
+        return result;
+    }
+    return input;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,YAAoB,EACpB,OAAe,EACf,SAAiB;IAEjB,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IACvC,OAAO,UAAU,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,OAAe,EACf,SAAiB,EACjB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAE/D,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAiB,EACjB,OAAe,EACf,SAAiB,EACjB,SAAiB;IAEjB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,WAAmB,CAAC,GAAG,EAAE,GAAG,IAAI;IAClF,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,6DAA6D;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC,KAAK,CAAM,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAM,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/http-client.d.ts

@@ -0,0 +1,34 @@
+import { type RetryOptions, type CircuitBreakerOptions } from './resilience.js';
+export interface HttpClientConfig {
+    agentId: string;
+    sharedSecret: string;
+    timeoutMs?: number;
+    /** Retry options for transient failures (default: 3 retries with backoff) */
+    retry?: RetryOptions;
+    /** Circuit breaker options */
+    circuitBreaker?: CircuitBreakerOptions;
+}
+export declare class HttpResponseError extends Error {
+    readonly statusCode: number;
+    readonly body: string;
+    constructor(statusCode: number, body: string);
+}
+/**
+ * HTTP client for inter-agent communication.
+ * Signs all requests with the shared secret for authentication.
+ * Includes retry with exponential backoff and circuit breaker.
+ */
+export declare class HttpClient {
+    private config;
+    private breaker;
+    constructor(config: HttpClientConfig);
+    request<T = unknown>(url: string, options?: {
+        method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    private doRequest;
+    /** Get the current circuit breaker state */
+    getCircuitState(): import("./resilience.js").CircuitState;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEvG,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAaD,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,UAAU,EAAE,MAAM;aAClB,IAAI,EAAE,MAAM;gBADZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM;CAK/B;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,EAAE,gBAAgB;IAK9B,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;QAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC7B,GACL,OAAO,CAAC,CAAC,CAAC;YAcC,SAAS;IA2CvB,4CAA4C;IAC5C,eAAe;CAGhB"}

package/dist/http-client.js

@@ -0,0 +1,84 @@
+import { randomUUID } from 'node:crypto';
+import { signRequest } from './auth.js';
+import { retry, CircuitBreaker } from './resilience.js';
+/** Errors considered transient and safe to retry */
+function isTransientError(error) {
+    if (error instanceof DOMException && error.name === 'AbortError')
+        return true;
+    if (error instanceof TypeError)
+        return true; // fetch network errors
+    if (error instanceof HttpResponseError) {
+        const code = error.statusCode;
+        return code === 429 || code === 502 || code === 503 || code === 504;
+    }
+    return false;
+}
+export class HttpResponseError extends Error {
+    statusCode;
+    body;
+    constructor(statusCode, body) {
+        super(`HTTP ${statusCode}: ${body}`);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.name = 'HttpResponseError';
+    }
+}
+/**
+ * HTTP client for inter-agent communication.
+ * Signs all requests with the shared secret for authentication.
+ * Includes retry with exponential backoff and circuit breaker.
+ */
+export class HttpClient {
+    config;
+    breaker;
+    constructor(config) {
+        this.config = config;
+        this.breaker = new CircuitBreaker(config.circuitBreaker);
+    }
+    async request(url, options = {}) {
+        const retryOpts = {
+            maxRetries: 3,
+            baseDelayMs: 500,
+            isRetryable: isTransientError,
+            ...this.config.retry,
+        };
+        return retry(() => this.breaker.execute(() => this.doRequest(url, options)), retryOpts);
+    }
+    async doRequest(url, options) {
+        const method = options.method ?? 'POST';
+        const body = options.body ? JSON.stringify(options.body) : '';
+        const timestamp = Date.now().toString();
+        const signature = signRequest(this.config.sharedSecret, body, timestamp);
+        const controller = new AbortController();
+        const timeout = this.config.timeoutMs ?? 30_000;
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Agent-Id': this.config.agentId,
+                    'X-Signature': signature,
+                    'X-Timestamp': timestamp,
+                    'X-Correlation-Id': randomUUID(),
+                    ...options.headers,
+                },
+                body: body || undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new HttpResponseError(response.status, text);
+            }
+            return response.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Get the current circuit breaker state */
+    getCircuitState() {
+        return this.breaker.getState();
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAiD,MAAM,iBAAiB,CAAC;AAYvG,oDAAoD;AACpD,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,uBAAuB;IACpE,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;QAC9B,OAAO,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IACA;IAFlB,YACkB,UAAkB,EAClB,IAAY;QAE5B,KAAK,CAAC,QAAQ,UAAU,KAAK,IAAI,EAAE,CAAC,CAAC;QAHrB,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAmB;IACzB,OAAO,CAAiB;IAEhC,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,OAAO,CACX,GAAW,EACX,UAII,EAAE;QAEN,MAAM,SAAS,GAAiB;YAC9B,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,GAAG;YAChB,WAAW,EAAE,gBAAgB;YAC7B,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;SACrB,CAAC;QAEF,OAAO,KAAK,CACV,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC,EACjE,SAAS,CACV,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,GAAW,EACX,OAIC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAEzE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;QAChD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM;gBACN,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBACjC,aAAa,EAAE,SAAS;oBACxB,aAAa,EAAE,SAAS;oBACxB,kBAAkB,EAAE,UAAU,EAAE;oBAChC,GAAG,OAAO,CAAC,OAAO;iBACnB;gBACD,IAAI,EAAE,IAAI,IAAI,SAAS;gBACvB,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;QACvC,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/http-server.d.ts

@@ -0,0 +1,35 @@
+import type { Agent } from '@mce-bt/microagents-core';
+export interface HttpServerConfig {
+    port: number;
+    host: string;
+    sharedSecret: string;
+    /** Previous shared secrets still accepted during rotation (default: []) */
+    previousSecrets?: string[];
+    /** Max request body size in bytes (default: 1MB) */
+    bodyLimit?: number;
+    /** Rate limit: max requests per window per IP (default: 100) */
+    rateLimitMax?: number;
+    /** Rate limit window in ms (default: 60_000) */
+    rateLimitWindowMs?: number;
+    /**
+     * Paths served WITHOUT HMAC auth, in addition to /health and /ready.
+     * Entries ending in '/' match as prefixes ('/wiki/' matches '/wiki/x'),
+     * other entries match exactly. Everything else requires a signature.
+     */
+    publicPaths?: string[];
+}
+/**
+ * HTTP server resource for an agent.
+ * Mounts the agent's public route handlers with shared-secret auth.
+ */
+export declare class HttpServer {
+    private server;
+    private config;
+    private rateLimiter;
+    private pruneTimer;
+    constructor(config: HttpServerConfig);
+    start(agent: Agent): Promise<void>;
+    private mountRoute;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAA4C,MAAM,0BAA0B,CAAC;AAEhG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAoCD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAA+C;gBAErD,MAAM,EAAE,gBAAgB;IAQ9B,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IA+RxC,OAAO,CAAC,UAAU;IA2BZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAU5B"}

package/dist/http-server.js

@@ -0,0 +1,326 @@
+import Fastify, {} from 'fastify';
+import { randomUUID } from 'node:crypto';
+import { verifySignature, verifySignatureWithRotation, isTimestampValid, sanitizeInput } from './auth.js';
+/** Simple in-memory sliding window rate limiter */
+class RateLimiter {
+    windows = new Map();
+    max;
+    windowMs;
+    constructor(max, windowMs) {
+        this.max = max;
+        this.windowMs = windowMs;
+    }
+    check(key) {
+        const now = Date.now();
+        const entry = this.windows.get(key);
+        if (!entry || now >= entry.resetAt) {
+            this.windows.set(key, { count: 1, resetAt: now + this.windowMs });
+            return { allowed: true, remaining: this.max - 1, resetAt: now + this.windowMs };
+        }
+        entry.count++;
+        const allowed = entry.count <= this.max;
+        return { allowed, remaining: Math.max(0, this.max - entry.count), resetAt: entry.resetAt };
+    }
+    /** Prune expired entries to prevent memory leaks */
+    prune() {
+        const now = Date.now();
+        for (const [key, entry] of this.windows) {
+            if (now >= entry.resetAt)
+                this.windows.delete(key);
+        }
+    }
+}
+/**
+ * HTTP server resource for an agent.
+ * Mounts the agent's public route handlers with shared-secret auth.
+ */
+export class HttpServer {
+    server = null;
+    config;
+    rateLimiter;
+    pruneTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.rateLimiter = new RateLimiter(config.rateLimitMax ?? 100, config.rateLimitWindowMs ?? 60_000);
+    }
+    async start(agent) {
+        const bodyLimit = this.config.bodyLimit ?? 20_971_520; // 20MB default (supports base64-encoded media)
+        this.server = Fastify({
+            logger: false,
+            genReqId: () => randomUUID(),
+            bodyLimit,
+        });
+        // Prune rate limiter every 60s to prevent memory leaks
+        this.pruneTimer = setInterval(() => this.rateLimiter.prune(), 60_000);
+        // Health endpoint (no auth required)
+        this.server.get('/health', async () => {
+            const health = {
+                status: 'ok',
+                agentId: agent.definition.id,
+                agentName: agent.definition.name,
+                uptime: process.uptime(),
+            };
+            // Include scheduler status if available
+            if (agent.schedulerStatus) {
+                health.scheduler = agent.schedulerStatus;
+            }
+            return health;
+        });
+        // Ready endpoint (no auth required)
+        this.server.get('/ready', async () => ({
+            status: agent.state === 'running' ? 'ready' : 'not-ready',
+        }));
+        // Scheduler detail endpoint (no auth required)
+        this.server.get('/scheduler', async () => {
+            if (!agent.schedulerStatus) {
+                return { status: 'no-scheduler' };
+            }
+            return agent.schedulerStatus;
+        });
+        // ─── Dashboard data endpoints (no auth required) ───
+        // Aggregated metrics for the dashboard
+        this.server.get('/dashboard/metrics', async () => {
+            const sessions = await agent.sessionManager.list(50);
+            const activeSessions = agent.sessionManager.getActiveSessions();
+            // Completion usage — try getUsageSummary first (includes per-model/tier breakdown)
+            let completionUsage = null;
+            let callHistory = [];
+            try {
+                const completion = agent
+                    .resources?.completion;
+                if (completion && typeof completion === 'object') {
+                    if ('getUsageSummary' in completion && typeof completion.getUsageSummary === 'function') {
+                        completionUsage = completion.getUsageSummary();
+                    }
+                    else if ('getUsage' in completion && typeof completion.getUsage === 'function') {
+                        completionUsage = completion.getUsage();
+                    }
+                    if ('getCallHistory' in completion && typeof completion.getCallHistory === 'function') {
+                        // Return last 100 calls
+                        const history = completion.getCallHistory();
+                        callHistory = history.slice(-100);
+                    }
+                }
+            }
+            catch { /* completion may not support these methods */ }
+            return {
+                agent: {
+                    id: agent.definition.id,
+                    name: agent.definition.name,
+                    domain: agent.definition.domain,
+                    version: agent.definition.version,
+                    state: agent.state,
+                    uptime: process.uptime(),
+                },
+                scheduler: agent.schedulerStatus ?? null,
+                sessions: {
+                    active: activeSessions.length,
+                    activeIds: activeSessions,
+                    recent: sessions.map((s) => ({
+                        id: s.id,
+                        startedAt: s.startedAt.toISOString(),
+                        endedAt: s.endedAt?.toISOString() ?? null,
+                        metadata: s.metadata ?? {},
+                    })),
+                },
+                completion: completionUsage,
+                callHistory,
+                channels: agent
+                    .resources?.channels?.map(ch => ({
+                    type: ch.type,
+                    activeChatIds: typeof ch.getActiveChatIds === 'function' ? ch.getActiveChatIds() : [],
+                })) ?? [],
+                tools: agent.toolRegistry.getAll().map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                    visibility: t.visibility,
+                })),
+            };
+        });
+        // Full session log for deep inspection
+        this.server.get('/dashboard/sessions/:sessionId', async (request) => {
+            const { sessionId } = request.params;
+            // Get session metadata
+            const session = await agent.sessionManager.get(sessionId);
+            if (!session) {
+                return { error: 'Session not found' };
+            }
+            // Get STM entries if memory is available
+            let entries = [];
+            try {
+                const memory = agent.resources?.memory;
+                if (memory && 'stm' in memory && memory.stm) {
+                    entries = await memory.stm.getSessionLog(sessionId);
+                }
+            }
+            catch { /* memory may not be configured */ }
+            return {
+                session: {
+                    id: session.id,
+                    agentId: session.agentId,
+                    startedAt: session.startedAt.toISOString(),
+                    endedAt: session.endedAt?.toISOString() ?? null,
+                    metadata: session.metadata ?? {},
+                },
+                entries,
+            };
+        });
+        // Recent log entries for dashboard
+        this.server.get('/dashboard/logs', async (request) => {
+            const { limit } = request.query ?? {};
+            const maxEntries = Math.min(parseInt(limit ?? '100', 10) || 100, 500);
+            const logBuffer = agent.resources?.logBuffer;
+            if (!logBuffer) {
+                return { logs: [], agentId: agent.definition.id, agentName: agent.definition.name };
+            }
+            return {
+                logs: logBuffer.getEntries(maxEntries),
+                agentId: agent.definition.id,
+                agentName: agent.definition.name,
+            };
+        });
+        // Rate limiting hook — applied to all requests
+        this.server.addHook('onRequest', async (request, reply) => {
+            const ip = request.ip || 'unknown';
+            const { allowed, remaining, resetAt } = this.rateLimiter.check(ip);
+            reply.header('X-RateLimit-Remaining', remaining.toString());
+            reply.header('X-RateLimit-Reset', Math.ceil(resetAt / 1000).toString());
+            if (!allowed) {
+                reply.code(429).send({ error: 'Too many requests' });
+                return;
+            }
+        });
+        // Shared-secret auth middleware for all other routes
+        // Uses preHandler (not onRequest) because request.body must be parsed first
+        this.server.addHook('preHandler', async (request, reply) => {
+            // Only /health, /ready, and explicitly configured publicPaths skip
+            // auth. Everything else — including /scheduler and /dashboard/* —
+            // requires a valid signature.
+            const url = request.url.split('?')[0];
+            const publicPaths = this.config.publicPaths ?? [];
+            const isPublic = url === '/health' ||
+                url === '/ready' ||
+                publicPaths.some((p) => (p.endsWith('/') ? url === p.slice(0, -1) || url.startsWith(p) : url === p));
+            if (isPublic) {
+                return;
+            }
+            const signature = request.headers['x-signature'];
+            const timestamp = request.headers['x-timestamp'];
+            const agentId = request.headers['x-agent-id'];
+            if (!signature || !timestamp || !agentId) {
+                reply.code(401).send({ error: 'Missing authentication headers' });
+                return;
+            }
+            if (!isTimestampValid(timestamp)) {
+                reply.code(401).send({ error: 'Request timestamp expired' });
+                return;
+            }
+            const body = typeof request.body === 'string'
+                ? request.body
+                : JSON.stringify(request.body ?? '');
+            const secrets = [this.config.sharedSecret, ...(this.config.previousSecrets ?? [])];
+            if (!verifySignatureWithRotation(secrets, body, timestamp, signature)) {
+                reply.code(401).send({ error: 'Invalid signature' });
+                return;
+            }
+        });
+        // Input sanitization hook — clean all incoming request bodies
+        this.server.addHook('preHandler', async (request) => {
+            if (request.body && typeof request.body === 'object') {
+                request.body = sanitizeInput(request.body);
+            }
+        });
+        // Mount agent routes
+        for (const handler of agent.routes) {
+            this.mountRoute(handler);
+        }
+        // AG-UI SSE endpoint — streams AG-UI events for a run
+        this.server.post('/ag-ui/runs', async (request, reply) => {
+            const body = request.body;
+            if (!body || !body.threadId || !body.runId || !body.message) {
+                reply.code(400).send({ error: 'Missing required fields: threadId, runId, message' });
+                return;
+            }
+            // Set SSE headers
+            reply.raw.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+                'X-Accel-Buffering': 'no',
+            });
+            // Use or create session
+            const sessionId = body.sessionId ?? await agent.createSession();
+            try {
+                const eventStream = agent.agentLoop.runStream({
+                    sessionId,
+                    message: body.message,
+                    tier: body.tier,
+                    temperature: body.temperature,
+                    maxTokens: body.maxTokens,
+                    maxToolRounds: body.maxToolRounds,
+                    threadId: body.threadId,
+                    runId: body.runId,
+                });
+                for await (const event of eventStream) {
+                    if (reply.raw.destroyed)
+                        break;
+                    reply.raw.write(`data: ${JSON.stringify(event)}\n\n`);
+                }
+            }
+            catch (err) {
+                const errorEvent = {
+                    type: 'RUN_ERROR',
+                    message: err instanceof Error ? err.message : String(err),
+                    timestamp: new Date().toISOString(),
+                };
+                if (!reply.raw.destroyed) {
+                    reply.raw.write(`data: ${JSON.stringify(errorEvent)}\n\n`);
+                }
+            }
+            finally {
+                if (!reply.raw.destroyed) {
+                    reply.raw.end();
+                }
+            }
+        });
+        await this.server.listen({
+            port: this.config.port,
+            host: this.config.host,
+        });
+    }
+    mountRoute(handler) {
+        if (!this.server)
+            return;
+        const path = handler.url.startsWith('/') ? handler.url : `/${handler.url}`;
+        this.server.route({
+            method: handler.method.toUpperCase(),
+            url: path,
+            handler: async (request, reply) => {
+                // Validate input if schema is provided
+                if (handler.schema) {
+                    const input = handler.method === 'get' ? request.query : request.body;
+                    const result = handler.schema.safeParse(input);
+                    if (!result.success) {
+                        reply.code(400).send({
+                            error: 'Validation failed',
+                            details: result.error.issues,
+                        });
+                        return;
+                    }
+                }
+                return handler.callback(request, reply);
+            },
+        });
+    }
+    async stop() {
+        if (this.pruneTimer) {
+            clearInterval(this.pruneTimer);
+            this.pruneTimer = null;
+        }
+        if (this.server) {
+            await this.server.close();
+            this.server = null;
+        }
+    }
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { HttpServer, type HttpServerConfig } from './http-server.js';
+export { HttpClient, HttpResponseError, type HttpClientConfig } from './http-client.js';
+export { RabbitMQClient, type RabbitConfig } from './rabbitmq.js';
+export { signRequest, verifySignature, verifySignatureWithRotation, isTimestampValid, sanitizeString, sanitizeInput } from './auth.js';
+export { retry, CircuitBreaker, CircuitOpenError, type RetryOptions, type CircuitBreakerOptions, type CircuitState, } from './resilience.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvI,OAAO,EACL,KAAK,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { HttpServer } from './http-server.js';
+export { HttpClient, HttpResponseError } from './http-client.js';
+export { RabbitMQClient } from './rabbitmq.js';
+export { signRequest, verifySignature, verifySignatureWithRotation, isTimestampValid, sanitizeString, sanitizeInput } from './auth.js';
+export { retry, CircuitBreaker, CircuitOpenError, } from './resilience.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAyB,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvI,OAAO,EACL,KAAK,EACL,cAAc,EACd,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC"}

package/dist/rabbitmq.d.ts

@@ -0,0 +1,59 @@
+import type { Agent } from '@mce-bt/microagents-core';
+import { type RetryOptions } from './resilience.js';
+export interface RabbitConfig {
+    url: string;
+    /** Exchange name for events (topic exchange) */
+    eventsExchange?: string;
+    /** Exchange name for tasks (direct exchange) */
+    tasksExchange?: string;
+    /** Reconnect delay in ms (default: 5000) */
+    reconnectDelayMs?: number;
+    /** Maximum reconnect attempts (default: Infinity) */
+    maxReconnectAttempts?: number;
+    /** Retry options for message handler failures */
+    handlerRetry?: RetryOptions;
+}
+interface MessageMetadata {
+    sourceAgentId: string;
+    sessionId?: string;
+    timestamp: string;
+    correlationId: string;
+}
+/**
+ * RabbitMQ communication resource.
+ * Handles events (topic exchange, pub/sub) and tasks (work queues, guaranteed delivery).
+ * Includes automatic reconnection with backoff and handler retry support.
+ */
+export declare class RabbitMQClient {
+    private config;
+    private connection;
+    private channel;
+    private agentId;
+    private eventsExchange;
+    private tasksExchange;
+    private agent;
+    private stopping;
+    private reconnecting;
+    /** Monotonic counter — incremented on each reconnect so in-flight handlers can detect stale channels. */
+    private channelEpoch;
+    /** Number of messages currently being processed. */
+    private inflightCount;
+    constructor(config: RabbitConfig);
+    start(agent: Agent): Promise<void>;
+    private connect;
+    private handleMessage;
+    private scheduleReconnect;
+    emitEvent(topic: string, payload: unknown, sessionId?: string): Promise<void>;
+    emitTask(topic: string, payload: unknown, sessionId?: string): Promise<void>;
+    /**
+     * Dynamically register a task consumer after start().
+     * Used by the Scheduler to self-consume cron task messages.
+     */
+    consumeTask(topic: string, callback: (data: {
+        payload: unknown;
+        metadata: MessageMetadata;
+    }) => Promise<void>, concurrency?: number): Promise<void>;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=rabbitmq.d.ts.map

package/dist/rabbitmq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rabbitmq.d.ts","sourceRoot":"","sources":["../src/rabbitmq.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,UAAU,eAAe;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAA4D;IAC9E,OAAO,CAAC,OAAO,CAAkG;IACjH,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,yGAAyG;IACzG,OAAO,CAAC,YAAY,CAAK;IACzB,oDAAoD;IACpD,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,EAAE,YAAY;IAM1B,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ1B,OAAO;YA6FP,aAAa;IAgC3B,OAAO,CAAC,iBAAiB;IA4CnB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBlF;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EAClF,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,IAAI,CAAC;IA6BV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAe5B"}

package/dist/rabbitmq.js

@@ -0,0 +1,265 @@
+import amqplib from 'amqplib';
+import { randomUUID } from 'node:crypto';
+import { retry } from './resilience.js';
+/**
+ * RabbitMQ communication resource.
+ * Handles events (topic exchange, pub/sub) and tasks (work queues, guaranteed delivery).
+ * Includes automatic reconnection with backoff and handler retry support.
+ */
+export class RabbitMQClient {
+    config;
+    connection = null;
+    channel = null;
+    agentId = '';
+    eventsExchange;
+    tasksExchange;
+    agent = null;
+    stopping = false;
+    reconnecting = false;
+    /** Monotonic counter — incremented on each reconnect so in-flight handlers can detect stale channels. */
+    channelEpoch = 0;
+    /** Number of messages currently being processed. */
+    inflightCount = 0;
+    constructor(config) {
+        this.config = config;
+        this.eventsExchange = config.eventsExchange ?? 'microagents.events';
+        this.tasksExchange = config.tasksExchange ?? 'microagents.tasks';
+    }
+    async start(agent) {
+        this.agentId = agent.definition.id;
+        this.agent = agent;
+        this.stopping = false;
+        await this.connect();
+    }
+    async connect() {
+        if (!this.agent)
+            return;
+        const agent = this.agent;
+        const conn = await amqplib.connect(this.config.url);
+        this.connection = conn;
+        this.channel = await conn.createChannel();
+        // Declare exchanges
+        await this.channel.assertExchange(this.eventsExchange, 'topic', { durable: true });
+        await this.channel.assertExchange(this.tasksExchange, 'direct', { durable: true });
+        // Dead letter exchanges + queues
+        const eventsDlx = `${this.eventsExchange}.dlx`;
+        const tasksDlx = `${this.tasksExchange}.dlx`;
+        await this.channel.assertExchange(eventsDlx, 'topic', { durable: true });
+        await this.channel.assertExchange(tasksDlx, 'direct', { durable: true });
+        // Set up event handlers
+        for (const handler of agent.eventHandlers) {
+            const queueName = `${agent.definition.id}.events.${handler.topic}`;
+            const dlqName = `${queueName}.dlq`;
+            // DLQ — messages that fail after retries land here
+            await this.channel.assertQueue(dlqName, { durable: true });
+            await this.channel.bindQueue(dlqName, eventsDlx, handler.topic);
+            await this.channel.assertQueue(queueName, {
+                durable: true,
+                arguments: {
+                    'x-dead-letter-exchange': eventsDlx,
+                    'x-dead-letter-routing-key': handler.topic,
+                },
+            });
+            await this.channel.bindQueue(queueName, this.eventsExchange, handler.topic);
+            await this.channel.consume(queueName, async (msg) => {
+                if (!msg)
+                    return;
+                await this.handleMessage(msg, handler.handleCallback.bind(handler));
+            });
+        }
+        // Set up task handlers
+        for (const handler of agent.taskHandlers) {
+            const queueName = `${agent.definition.id}.tasks.${handler.topic}`;
+            const dlqName = `${queueName}.dlq`;
+            // DLQ
+            await this.channel.assertQueue(dlqName, { durable: true });
+            await this.channel.bindQueue(dlqName, tasksDlx, handler.topic);
+            await this.channel.assertQueue(queueName, {
+                durable: true,
+                arguments: {
+                    'x-dead-letter-exchange': tasksDlx,
+                    'x-dead-letter-routing-key': handler.topic,
+                },
+            });
+            await this.channel.bindQueue(queueName, this.tasksExchange, handler.topic);
+            await this.channel.prefetch(handler.concurrency);
+            await this.channel.consume(queueName, async (msg) => {
+                if (!msg)
+                    return;
+                await this.handleMessage(msg, handler.handleCallback.bind(handler));
+            });
+        }
+        // Handle channel errors (e.g., PRECONDITION_FAILED from stale delivery tags)
+        this.channel.on('error', (err) => {
+            if (!this.stopping) {
+                console.error('[RabbitMQ] Channel error:', err.message);
+                this.scheduleReconnect();
+            }
+        });
+        // Handle connection errors — trigger reconnect
+        this.connection.on('error', (err) => {
+            if (!this.stopping) {
+                console.error('[RabbitMQ] Connection error:', err.message);
+                this.scheduleReconnect();
+            }
+        });
+        this.connection.on('close', () => {
+            if (!this.stopping) {
+                console.warn('[RabbitMQ] Connection closed unexpectedly');
+                this.scheduleReconnect();
+            }
+        });
+    }
+    async handleMessage(msg, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    callback) {
+        // Pin the channel reference and epoch at the moment the message was received.
+        // If a reconnect happens while the callback is running, we must NOT ack/nack
+        // on the new channel — that causes PRECONDITION_FAILED (unknown delivery tag).
+        const pinnedChannel = this.channel;
+        const pinnedEpoch = this.channelEpoch;
+        this.inflightCount++;
+        const retryOpts = this.config.handlerRetry ?? { maxRetries: 2, baseDelayMs: 500 };
+        try {
+            const data = JSON.parse(msg.content.toString());
+            await retry(() => callback(data), retryOpts);
+            // Only ack if the channel hasn't been replaced
+            if (this.channelEpoch === pinnedEpoch && pinnedChannel) {
+                try {
+                    pinnedChannel.ack(msg);
+                }
+                catch { /* channel already closed */ }
+            }
+        }
+        catch (err) {
+            console.error('[RabbitMQ] Handler failed after retries, sending to DLQ:', err.message);
+            if (this.channelEpoch === pinnedEpoch && pinnedChannel) {
+                try {
+                    pinnedChannel.nack(msg, false, false);
+                }
+                catch { /* channel already closed */ }
+            }
+        }
+        finally {
+            this.inflightCount--;
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnecting || this.stopping)
+            return;
+        this.reconnecting = true;
+        const baseDelay = this.config.reconnectDelayMs ?? 5_000;
+        const maxAttempts = this.config.maxReconnectAttempts ?? Infinity;
+        const doReconnect = async (attempt) => {
+            if (this.stopping) {
+                this.reconnecting = false;
+                return;
+            }
+            if (attempt > maxAttempts) {
+                console.error('[RabbitMQ] Max reconnect attempts reached, giving up');
+                this.reconnecting = false;
+                return;
+            }
+            const delay = Math.min(baseDelay * 2 ** (attempt - 1), 60_000);
+            console.log(`[RabbitMQ] Reconnecting in ${delay}ms (attempt ${attempt})...`);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            try {
+                // Bump epoch so in-flight handlers know their channel is stale
+                this.channelEpoch++;
+                // Clean up stale refs
+                this.channel = null;
+                try {
+                    this.connection?.removeAllListeners();
+                }
+                catch { /* ignore */ }
+                this.connection = null;
+                await this.connect();
+                console.log('[RabbitMQ] Reconnected successfully');
+                this.reconnecting = false;
+            }
+            catch (err) {
+                console.error('[RabbitMQ] Reconnect failed:', err.message);
+                await doReconnect(attempt + 1);
+            }
+        };
+        void doReconnect(1);
+    }
+    async emitEvent(topic, payload, sessionId) {
+        if (!this.channel) {
+            throw new Error('RabbitMQ channel not initialized');
+        }
+        const message = {
+            payload,
+            metadata: {
+                sourceAgentId: this.agentId,
+                sessionId,
+                timestamp: new Date().toISOString(),
+                correlationId: randomUUID(),
+            },
+        };
+        this.channel.publish(this.eventsExchange, topic, Buffer.from(JSON.stringify(message)), { persistent: true });
+    }
+    async emitTask(topic, payload, sessionId) {
+        if (!this.channel) {
+            throw new Error('RabbitMQ channel not initialized');
+        }
+        const message = {
+            payload,
+            metadata: {
+                sourceAgentId: this.agentId,
+                sessionId,
+                timestamp: new Date().toISOString(),
+                correlationId: randomUUID(),
+            },
+        };
+        this.channel.publish(this.tasksExchange, topic, Buffer.from(JSON.stringify(message)), { persistent: true });
+    }
+    /**
+     * Dynamically register a task consumer after start().
+     * Used by the Scheduler to self-consume cron task messages.
+     */
+    async consumeTask(topic, callback, concurrency = 1) {
+        if (!this.channel) {
+            throw new Error('RabbitMQ channel not initialized');
+        }
+        const queueName = `${this.agentId}.tasks.${topic}`;
+        const tasksDlx = `${this.tasksExchange}.dlx`;
+        const dlqName = `${queueName}.dlq`;
+        await this.channel.assertQueue(dlqName, { durable: true });
+        await this.channel.bindQueue(dlqName, tasksDlx, topic);
+        await this.channel.assertQueue(queueName, {
+            durable: true,
+            arguments: {
+                'x-dead-letter-exchange': tasksDlx,
+                'x-dead-letter-routing-key': topic,
+            },
+        });
+        await this.channel.bindQueue(queueName, this.tasksExchange, topic);
+        await this.channel.prefetch(concurrency);
+        await this.channel.consume(queueName, async (msg) => {
+            if (!msg)
+                return;
+            await this.handleMessage(msg, callback);
+        });
+    }
+    async stop() {
+        this.stopping = true;
+        if (this.channel) {
+            try {
+                await this.channel.close();
+            }
+            catch { /* ignore during shutdown */ }
+            this.channel = null;
+        }
+        if (this.connection) {
+            try {
+                this.connection.removeAllListeners();
+                await this.connection.close();
+            }
+            catch { /* ignore during shutdown */ }
+            this.connection = null;
+        }
+        this.agent = null;
+    }
+}
+//# sourceMappingURL=rabbitmq.js.map

package/dist/rabbitmq.js.map

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

package/dist/resilience.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Resilience utilities — retry with exponential backoff and circuit breaker.
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Base delay in ms (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay in ms (default: 30_000) */
+    maxDelayMs?: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    multiplier?: number;
+    /** Add jitter to delays (default: true) */
+    jitter?: boolean;
+    /** Predicate to decide if an error is retryable (default: all errors are retryable) */
+    isRetryable?: (error: unknown) => boolean;
+    /** Called on each retry attempt */
+    onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
+}
+/**
+ * Retry an async operation with exponential backoff.
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening the circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms the circuit stays open before transitioning to half-open (default: 30_000) */
+    resetTimeoutMs?: number;
+    /** Max attempts allowed in half-open state (default: 1) */
+    halfOpenMaxAttempts?: number;
+    /** Called when state changes */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private lastFailureTime;
+    private halfOpenAttempts;
+    private failureThreshold;
+    private resetTimeoutMs;
+    private halfOpenMaxAttempts;
+    private onStateChange?;
+    constructor(options?: CircuitBreakerOptions);
+    getState(): CircuitState;
+    private transition;
+    /**
+     * Execute an operation through the circuit breaker.
+     * Throws a CircuitOpenError if the circuit is open.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+    reset(): void;
+}
+export declare class CircuitOpenError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=resilience.d.ts.map

package/dist/resilience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../src/resilience.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAwBD;;GAEG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAID,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;CAChE;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAE7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAAC,CAAiD;gBAE3D,OAAO,GAAE,qBAA0B;IAO/C,QAAQ,IAAI,YAAY;IAIxB,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA4BlD,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,SAAS;IAQjB,KAAK,IAAI,IAAI;CAMd;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/resilience.js

@@ -0,0 +1,124 @@
+/**
+ * Resilience utilities — retry with exponential backoff and circuit breaker.
+ */
+const DEFAULT_RETRY = {
+    maxRetries: 3,
+    baseDelayMs: 1_000,
+    maxDelayMs: 30_000,
+    multiplier: 2,
+    jitter: true,
+};
+function computeDelay(attempt, baseDelayMs, maxDelayMs, multiplier, jitter) {
+    const expDelay = baseDelayMs * multiplier ** attempt;
+    const capped = Math.min(expDelay, maxDelayMs);
+    if (!jitter)
+        return capped;
+    // Full jitter: uniform random between 0 and capped delay
+    return Math.floor(Math.random() * capped);
+}
+/**
+ * Retry an async operation with exponential backoff.
+ */
+export async function retry(fn, options = {}) {
+    const { maxRetries = DEFAULT_RETRY.maxRetries, baseDelayMs = DEFAULT_RETRY.baseDelayMs, maxDelayMs = DEFAULT_RETRY.maxDelayMs, multiplier = DEFAULT_RETRY.multiplier, jitter = DEFAULT_RETRY.jitter, } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= maxRetries)
+                break;
+            if (options.isRetryable && !options.isRetryable(error))
+                break;
+            const delay = computeDelay(attempt, baseDelayMs, maxDelayMs, multiplier, jitter);
+            options.onRetry?.(error, attempt + 1, delay);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+export class CircuitBreaker {
+    state = 'closed';
+    failureCount = 0;
+    lastFailureTime = 0;
+    halfOpenAttempts = 0;
+    failureThreshold;
+    resetTimeoutMs;
+    halfOpenMaxAttempts;
+    onStateChange;
+    constructor(options = {}) {
+        this.failureThreshold = options.failureThreshold ?? 5;
+        this.resetTimeoutMs = options.resetTimeoutMs ?? 30_000;
+        this.halfOpenMaxAttempts = options.halfOpenMaxAttempts ?? 1;
+        this.onStateChange = options.onStateChange;
+    }
+    getState() {
+        return this.state;
+    }
+    transition(to) {
+        if (this.state === to)
+            return;
+        const from = this.state;
+        this.state = to;
+        this.onStateChange?.(from, to);
+    }
+    /**
+     * Execute an operation through the circuit breaker.
+     * Throws a CircuitOpenError if the circuit is open.
+     */
+    async execute(fn) {
+        if (this.state === 'open') {
+            // Check if enough time has elapsed to try half-open
+            if (Date.now() - this.lastFailureTime >= this.resetTimeoutMs) {
+                this.transition('half-open');
+                this.halfOpenAttempts = 0;
+            }
+            else {
+                throw new CircuitOpenError('Circuit breaker is open');
+            }
+        }
+        if (this.state === 'half-open' && this.halfOpenAttempts >= this.halfOpenMaxAttempts) {
+            throw new CircuitOpenError('Circuit breaker half-open limit reached');
+        }
+        try {
+            if (this.state === 'half-open') {
+                this.halfOpenAttempts++;
+            }
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.failureCount = 0;
+        if (this.state === 'half-open') {
+            this.transition('closed');
+        }
+    }
+    onFailure() {
+        this.failureCount++;
+        this.lastFailureTime = Date.now();
+        if (this.failureCount >= this.failureThreshold) {
+            this.transition('open');
+        }
+    }
+    reset() {
+        this.failureCount = 0;
+        this.halfOpenAttempts = 0;
+        this.lastFailureTime = 0;
+        this.transition('closed');
+    }
+}
+export class CircuitOpenError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CircuitOpenError';
+    }
+}
+//# sourceMappingURL=resilience.js.map

package/dist/resilience.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@mce-bt/microagents-communication",
+  "version": "0.1.0",
+  "description": "Communication layer — HTTP server/client + RabbitMQ events/tasks",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "fastify": "^5.2.0",
+    "amqplib": "^0.10.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/amqplib": "^0.10.0"
+  },
+  "peerDependencies": {
+    "@mce-bt/microagents-observability": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@mce-bt/microagents-observability": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cavillo/microagents.git",
+    "directory": "packages/communication"
+  },
+  "homepage": "https://github.com/cavillo/microagents#readme",
+  "bugs": {
+    "url": "https://github.com/cavillo/microagents/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}