@darkiceinteractive/mcp-conductor 2.0.0-alpha.1 → 3.0.0-beta.2

package/dist/reliability/errors.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Structured error classes for the reliability layer.
+ *
+ * All reliability errors carry `server`, `tool`, and `attempts` so the
+ * caller (hub, sandbox) can surface actionable context without string-parsing.
+ */
+/**
+ * Structured wrapper for any error thrown by a backend MCP tool call.
+ *
+ * Hub.callTool re-throws every upstream error as MCPToolError so the sandbox
+ * can catch by class and inspect structured fields without string-parsing.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await mcp.ibkr.get_portfolio({});
+ * } catch (e) {
+ *   if (e instanceof MCPToolError && e.code === 'contract_not_found') {
+ *     // handle known error code
+ *   }
+ * }
+ * ```
+ */
+export declare class MCPToolError extends Error {
+    /** Upstream error code string, if available. Falls back to 'UNKNOWN'. */
+    readonly code: string;
+    /** Backend server name (e.g. 'ibkr', 'github') */
+    readonly server: string;
+    /** Tool name (e.g. 'get_portfolio') */
+    readonly tool: string;
+    /** Original error object — preserve full upstream context */
+    readonly upstream: unknown;
+    readonly name = "MCPToolError";
+    constructor(
+    /** Upstream error code string, if available. Falls back to 'UNKNOWN'. */
+    code: string, 
+    /** Backend server name (e.g. 'ibkr', 'github') */
+    server: string, 
+    /** Tool name (e.g. 'get_portfolio') */
+    tool: string, 
+    /** Original error object — preserve full upstream context */
+    upstream: unknown);
+}
+export declare class TimeoutError extends Error {
+    readonly server: string;
+    readonly tool: string;
+    readonly timeoutMs: number;
+    readonly attempts: number;
+    readonly name = "TimeoutError";
+    constructor(server: string, tool: string, timeoutMs: number, attempts: number);
+}
+export declare class RetryExhaustedError extends Error {
+    readonly server: string;
+    readonly tool: string;
+    readonly attempts: number;
+    readonly lastError: unknown;
+    readonly name = "RetryExhaustedError";
+    constructor(server: string, tool: string, attempts: number, lastError: unknown);
+}
+export declare class CircuitOpenError extends Error {
+    readonly server: string;
+    readonly tool: string;
+    readonly attempts: number;
+    readonly name = "CircuitOpenError";
+    constructor(server: string, tool: string, attempts?: number);
+}
+/**
+ * Extract an error code string from an unknown thrown value.
+ * Used by hub.callTool when constructing MCPToolError.
+ */
+export declare function extractErrorCode(err: unknown): string;
+/**
+ * Returns true for errors that are safe to retry (transient failures).
+ * Mutations always receive retries=0 at the profile level, so this only
+ * matters for read operations.
+ */
+export declare function isRetryable(err: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/reliability/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/reliability/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAInC,yEAAyE;aACzD,IAAI,EAAE,MAAM;IAC5B,kDAAkD;aAClC,MAAM,EAAE,MAAM;IAC9B,uCAAuC;aACvB,IAAI,EAAE,MAAM;IAC5B,6DAA6D;aAC7C,QAAQ,EAAE,OAAO;IAVnC,SAAkB,IAAI,kBAAkB;;IAGtC,yEAAyE;IACzD,IAAI,EAAE,MAAM;IAC5B,kDAAkD;IAClC,MAAM,EAAE,MAAM;IAC9B,uCAAuC;IACvB,IAAI,EAAE,MAAM;IAC5B,6DAA6D;IAC7C,QAAQ,EAAE,OAAO;CAMpC;AAMD,qBAAa,YAAa,SAAQ,KAAK;aAInB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACjB,QAAQ,EAAE,MAAM;IANlC,SAAkB,IAAI,kBAAkB;gBAGtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM;CAKnC;AAMD,qBAAa,mBAAoB,SAAQ,KAAK;aAI1B,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,OAAO;IANpC,SAAkB,IAAI,yBAAyB;gBAG7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO;CAOrC;AAMD,qBAAa,gBAAiB,SAAQ,KAAK;aAIvB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM;IALlC,SAAkB,IAAI,sBAAsB;gBAG1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAU;CAKvC;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAarD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAqBjD"}

package/dist/reliability/errors.js

@@ -0,0 +1,160 @@
+/**
+ * Structured error classes for the reliability layer.
+ *
+ * All reliability errors carry `server`, `tool`, and `attempts` so the
+ * caller (hub, sandbox) can surface actionable context without string-parsing.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// MCPToolError — wraps upstream backend errors (amendment from consolidated plan)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Structured wrapper for any error thrown by a backend MCP tool call.
+ *
+ * Hub.callTool re-throws every upstream error as MCPToolError so the sandbox
+ * can catch by class and inspect structured fields without string-parsing.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await mcp.ibkr.get_portfolio({});
+ * } catch (e) {
+ *   if (e instanceof MCPToolError && e.code === 'contract_not_found') {
+ *     // handle known error code
+ *   }
+ * }
+ * ```
+ */
+export class MCPToolError extends Error {
+    code;
+    server;
+    tool;
+    upstream;
+    name = 'MCPToolError';
+    constructor(
+    /** Upstream error code string, if available. Falls back to 'UNKNOWN'. */
+    code, 
+    /** Backend server name (e.g. 'ibkr', 'github') */
+    server, 
+    /** Tool name (e.g. 'get_portfolio') */
+    tool, 
+    /** Original error object — preserve full upstream context */
+    upstream) {
+        super(`[${server}.${tool}] ${code}`);
+        this.code = code;
+        this.server = server;
+        this.tool = tool;
+        this.upstream = upstream;
+        // Maintain proper prototype chain for instanceof checks across module boundaries
+        Object.setPrototypeOf(this, MCPToolError.prototype);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// TimeoutError
+// ─────────────────────────────────────────────────────────────────────────────
+export class TimeoutError extends Error {
+    server;
+    tool;
+    timeoutMs;
+    attempts;
+    name = 'TimeoutError';
+    constructor(server, tool, timeoutMs, attempts) {
+        super(`[${server}.${tool}] timed out after ${timeoutMs}ms (attempt ${attempts})`);
+        this.server = server;
+        this.tool = tool;
+        this.timeoutMs = timeoutMs;
+        this.attempts = attempts;
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// RetryExhaustedError
+// ─────────────────────────────────────────────────────────────────────────────
+export class RetryExhaustedError extends Error {
+    server;
+    tool;
+    attempts;
+    lastError;
+    name = 'RetryExhaustedError';
+    constructor(server, tool, attempts, lastError) {
+        const cause = lastError instanceof Error ? lastError.message : String(lastError);
+        super(`[${server}.${tool}] exhausted ${attempts} attempt(s): ${cause}`);
+        this.server = server;
+        this.tool = tool;
+        this.attempts = attempts;
+        this.lastError = lastError;
+        Object.setPrototypeOf(this, RetryExhaustedError.prototype);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// CircuitOpenError
+// ─────────────────────────────────────────────────────────────────────────────
+export class CircuitOpenError extends Error {
+    server;
+    tool;
+    attempts;
+    name = 'CircuitOpenError';
+    constructor(server, tool, attempts = 0) {
+        super(`[${server}.${tool}] circuit open — failing fast`);
+        this.server = server;
+        this.tool = tool;
+        this.attempts = attempts;
+        Object.setPrototypeOf(this, CircuitOpenError.prototype);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Extract an error code string from an unknown thrown value.
+ * Used by hub.callTool when constructing MCPToolError.
+ */
+export function extractErrorCode(err) {
+    if (err instanceof MCPToolError)
+        return err.code;
+    if (err instanceof TimeoutError)
+        return 'TIMEOUT';
+    if (err instanceof CircuitOpenError)
+        return 'CIRCUIT_OPEN';
+    if (err instanceof RetryExhaustedError)
+        return 'RETRY_EXHAUSTED';
+    if (err && typeof err === 'object') {
+        // MCP SDK errors often carry a `code` field
+        const obj = err;
+        if (typeof obj['code'] === 'string')
+            return obj['code'];
+        if (typeof obj['code'] === 'number')
+            return String(obj['code']);
+    }
+    if (err instanceof Error)
+        return err.message || 'ERROR';
+    return 'UNKNOWN';
+}
+/**
+ * Returns true for errors that are safe to retry (transient failures).
+ * Mutations always receive retries=0 at the profile level, so this only
+ * matters for read operations.
+ */
+export function isRetryable(err) {
+    // Never retry if the circuit is already open — it's a fast-fail, not a transient error
+    if (err instanceof CircuitOpenError)
+        return false;
+    // Never double-wrap MCPToolErrors — let them propagate
+    if (err instanceof MCPToolError)
+        return false;
+    // Timeouts are retryable
+    if (err instanceof TimeoutError)
+        return true;
+    // Generic network-level errors are retryable
+    if (err instanceof Error) {
+        const msg = err.message.toLowerCase();
+        return (msg.includes('network') ||
+            msg.includes('econnreset') ||
+            msg.includes('enotfound') ||
+            msg.includes('etimedout') ||
+            msg.includes('socket') ||
+            msg.includes('timeout') ||
+            msg.includes('econnrefused'));
+    }
+    return false;
+}
+//# sourceMappingURL=errors.js.map

package/dist/reliability/errors.js.map

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

package/dist/reliability/gateway.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ReliabilityGateway — composes timeout, retry, and circuit breaker into a
+ * single call pipeline.
+ *
+ * Wiring order (cache sits in front of this layer per Agent B):
+ *   cache miss → ReliabilityGateway.call() → backend fn
+ *
+ * Profile resolution order:
+ *   tool-level ToolDefinition.reliability → server-level config → global default
+ */
+import { CircuitOpenError, MCPToolError, RetryExhaustedError, TimeoutError, extractErrorCode } from './errors.js';
+import { type CircuitState, type ReliabilityProfile } from './profile.js';
+export interface ServerStats {
+    totalCalls: number;
+    successes: number;
+    failures: number;
+    timeouts: number;
+    retries: number;
+    circuitState: CircuitState;
+    lastTrip?: number;
+}
+export interface ReliabilityStats {
+    byServer: Record<string, ServerStats>;
+}
+/**
+ * Minimal tool-lookup interface so ReliabilityGateway can resolve per-tool
+ * profiles without importing the full ToolRegistry (avoids circular deps).
+ */
+export interface ToolLookup {
+    getToolReliability(server: string, tool: string): ReliabilityProfile | undefined;
+}
+export interface GatewayOptions {
+    /** Optional per-tool profile resolver (typically the ToolRegistry) */
+    toolLookup?: ToolLookup;
+    /** Global default profile override */
+    defaultProfile?: ReliabilityProfile;
+    /**
+     * Per-server profile overrides, keyed by server name.
+     * Corresponds to the `reliability.perServer` block in conductor config.
+     */
+    serverProfiles?: Record<string, ReliabilityProfile>;
+    /**
+     * Per-tool profile overrides, keyed by "server.tool".
+     * Corresponds to the `reliability.perTool` block in conductor config.
+     */
+    toolProfiles?: Record<string, ReliabilityProfile>;
+}
+export declare class ReliabilityGateway {
+    private readonly breakers;
+    private readonly stats;
+    private readonly options;
+    constructor(options?: GatewayOptions);
+    /**
+     * Execute `fn` with full reliability protection: timeout → retry → circuit breaker.
+     *
+     * Returns the resolved value of `fn` or throws one of:
+     *   - CircuitOpenError (circuit OPEN, fast-fail)
+     *   - TimeoutError (single attempt timed out, retries=0)
+     *   - RetryExhaustedError (all attempts failed)
+     *   - MCPToolError (non-retryable upstream error wrapped by hub)
+     *   - original error (non-retryable, non-MCPToolError)
+     */
+    call<T>(server: string, tool: string, fn: () => Promise<T>): Promise<T>;
+    /** Current circuit state for a server. Returns 'closed' if never seen. */
+    getCircuitState(server: string): CircuitState;
+    /** Aggregate stats snapshot across all servers seen so far. */
+    getStats(): ReliabilityStats;
+    /** Reset circuit breaker for a specific server back to CLOSED. */
+    resetCircuit(server: string): void;
+    private _breaker;
+    private _accumulator;
+    /**
+     * Resolve the effective profile for a specific server+tool combination.
+     *
+     * Priority (highest → lowest):
+     *   1. toolProfiles["server.tool"]
+     *   2. toolLookup.getToolReliability(server, tool) [ToolDefinition.reliability]
+     *   3. serverProfiles[server]
+     *   4. defaultProfile (global)
+     *   5. DEFAULT_PROFILE (hardcoded fallback)
+     *
+     * After resolution, mutation default is applied (retries forced to 0 if
+     * no explicit retries were set for a mutation-named tool).
+     */
+    private _resolveProfile;
+}
+export { CircuitOpenError, MCPToolError, RetryExhaustedError, TimeoutError, extractErrorCode };
+//# sourceMappingURL=gateway.d.ts.map

package/dist/reliability/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/reliability/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAQtB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACvC;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;CAClF;AAED,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sCAAsC;IACtC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACpD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACnD;AAsBD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;gBAEU,OAAO,GAAE,cAAmB;IAWxC;;;;;;;;;OASG;IACG,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoE7E,0EAA0E;IAC1E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAI7C,+DAA+D;IAC/D,QAAQ,IAAI,gBAAgB;IAoB5B,kEAAkE;IAClE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,YAAY;IAOpB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;CA6BxB;AAGD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/reliability/gateway.js

@@ -0,0 +1,180 @@
+/**
+ * ReliabilityGateway — composes timeout, retry, and circuit breaker into a
+ * single call pipeline.
+ *
+ * Wiring order (cache sits in front of this layer per Agent B):
+ *   cache miss → ReliabilityGateway.call() → backend fn
+ *
+ * Profile resolution order:
+ *   tool-level ToolDefinition.reliability → server-level config → global default
+ */
+import { CircuitBreaker } from './breaker.js';
+import { CircuitOpenError, MCPToolError, RetryExhaustedError, TimeoutError, extractErrorCode, } from './errors.js';
+import { DEFAULT_PROFILE, applyMutationDefault, resolveProfile, } from './profile.js';
+import { withRetry } from './retry.js';
+import { withTimeoutSimple } from './timeout.js';
+function emptyMutableStats() {
+    return { totalCalls: 0, successes: 0, failures: 0, timeouts: 0, retries: 0 };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// ReliabilityGateway
+// ─────────────────────────────────────────────────────────────────────────────
+export class ReliabilityGateway {
+    breakers = new Map();
+    stats = new Map();
+    options;
+    constructor(options = {}) {
+        this.options = {
+            toolLookup: options.toolLookup,
+            defaultProfile: options.defaultProfile ?? DEFAULT_PROFILE,
+            serverProfiles: options.serverProfiles ?? {},
+            toolProfiles: options.toolProfiles ?? {},
+        };
+    }
+    // ─── Public API ────────────────────────────────────────────────────────────
+    /**
+     * Execute `fn` with full reliability protection: timeout → retry → circuit breaker.
+     *
+     * Returns the resolved value of `fn` or throws one of:
+     *   - CircuitOpenError (circuit OPEN, fast-fail)
+     *   - TimeoutError (single attempt timed out, retries=0)
+     *   - RetryExhaustedError (all attempts failed)
+     *   - MCPToolError (non-retryable upstream error wrapped by hub)
+     *   - original error (non-retryable, non-MCPToolError)
+     */
+    async call(server, tool, fn) {
+        const profile = this._resolveProfile(server, tool);
+        const breaker = this._breaker(server, profile);
+        const acc = this._accumulator(server);
+        acc.totalCalls++;
+        // Fast-fail if circuit is open
+        breaker.allowCall(tool);
+        let attemptCount = 0;
+        const wrappedFn = async () => {
+            attemptCount++;
+            const attempt = attemptCount;
+            // Count retries (all attempts after the first)
+            if (attempt > 1) {
+                acc.retries++;
+            }
+            return withTimeoutSimple(fn, {
+                timeoutMs: profile.timeoutMs,
+                server,
+                tool,
+                attempt,
+            });
+        };
+        try {
+            const result = await withRetry(wrappedFn, {
+                retries: profile.retries,
+                retryDelayMs: profile.retryDelayMs,
+                retryMaxDelayMs: profile.retryMaxDelayMs,
+                server,
+                tool,
+            });
+            breaker.recordSuccess();
+            acc.successes++;
+            return result;
+        }
+        catch (err) {
+            breaker.recordFailure();
+            acc.failures++;
+            // Count timeouts: either a direct TimeoutError or a RetryExhaustedError
+            // whose last underlying cause was a TimeoutError.
+            if (err instanceof TimeoutError) {
+                acc.timeouts++;
+                throw err;
+            }
+            if (err instanceof RetryExhaustedError) {
+                if (err.lastError instanceof TimeoutError) {
+                    acc.timeouts++;
+                }
+                // When there was only one attempt (retries=0), surface the underlying
+                // error directly so the sandbox sees the specific error type (TimeoutError,
+                // etc.) rather than the wrapping RetryExhaustedError.
+                if (err.attempts === 1 && err.lastError instanceof Error) {
+                    throw err.lastError;
+                }
+            }
+            throw err;
+        }
+    }
+    /** Current circuit state for a server. Returns 'closed' if never seen. */
+    getCircuitState(server) {
+        return this.breakers.get(server)?.getState() ?? 'closed';
+    }
+    /** Aggregate stats snapshot across all servers seen so far. */
+    getStats() {
+        const byServer = {};
+        for (const [server, acc] of this.stats) {
+            const breaker = this.breakers.get(server);
+            const breakerStats = breaker?.getStats();
+            byServer[server] = {
+                totalCalls: acc.totalCalls,
+                successes: acc.successes,
+                failures: acc.failures,
+                timeouts: acc.timeouts,
+                retries: acc.retries,
+                circuitState: breakerStats?.state ?? 'closed',
+                lastTrip: breakerStats?.lastTrip,
+            };
+        }
+        return { byServer };
+    }
+    /** Reset circuit breaker for a specific server back to CLOSED. */
+    resetCircuit(server) {
+        this.breakers.get(server)?.reset();
+    }
+    // ─── Private helpers ───────────────────────────────────────────────────────
+    _breaker(server, profile) {
+        if (!this.breakers.has(server)) {
+            this.breakers.set(server, new CircuitBreaker(server, profile));
+        }
+        return this.breakers.get(server);
+    }
+    _accumulator(server) {
+        if (!this.stats.has(server)) {
+            this.stats.set(server, emptyMutableStats());
+        }
+        return this.stats.get(server);
+    }
+    /**
+     * Resolve the effective profile for a specific server+tool combination.
+     *
+     * Priority (highest → lowest):
+     *   1. toolProfiles["server.tool"]
+     *   2. toolLookup.getToolReliability(server, tool) [ToolDefinition.reliability]
+     *   3. serverProfiles[server]
+     *   4. defaultProfile (global)
+     *   5. DEFAULT_PROFILE (hardcoded fallback)
+     *
+     * After resolution, mutation default is applied (retries forced to 0 if
+     * no explicit retries were set for a mutation-named tool).
+     */
+    _resolveProfile(server, tool) {
+        const globalBase = resolveProfile(this.options.defaultProfile);
+        // Layer 3: server-level override
+        const serverOverride = this.options.serverProfiles[server];
+        const afterServer = serverOverride ? resolveProfile(serverOverride, globalBase) : globalBase;
+        // Layer 2: tool-level from ToolDefinition (via registry lookup)
+        const registryOverride = this.options.toolLookup?.getToolReliability(server, tool);
+        const afterRegistry = registryOverride
+            ? resolveProfile(registryOverride, afterServer)
+            : afterServer;
+        // Layer 1: explicit tool profile key "server.tool"
+        const toolKey = `${server}.${tool}`;
+        const toolOverride = this.options.toolProfiles[toolKey];
+        const explicit = toolOverride ? resolveProfile(toolOverride, afterRegistry) : afterRegistry;
+        // Determine whether retries were explicitly set at a tool/server-specific
+        // override level. The global defaultProfile does NOT count as an explicit
+        // override — if only the global default has retries set, mutations still
+        // get retries forced to 0 by applyMutationDefault.
+        const explicitRetries = toolOverride?.retries !== undefined ||
+            registryOverride?.retries !== undefined ||
+            serverOverride?.retries !== undefined;
+        return applyMutationDefault(tool, explicit, explicitRetries);
+    }
+}
+// Re-export error types at gateway level for convenience
+export { CircuitOpenError, MCPToolError, RetryExhaustedError, TimeoutError, extractErrorCode };
+//# sourceMappingURL=gateway.js.map

package/dist/reliability/gateway.js.map

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

package/dist/reliability/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * src/reliability — public API
+ *
+ * Everything a consumer needs is re-exported here. Internal modules should be
+ * imported directly only within the reliability package.
+ *
+ * @module reliability
+ */
+export type { ReliabilityProfile, CircuitState } from './profile.js';
+export { DEFAULT_PROFILE, resolveProfile, isMutation, applyMutationDefault } from './profile.js';
+export { MCPToolError, TimeoutError, RetryExhaustedError, CircuitOpenError, extractErrorCode, isRetryable, } from './errors.js';
+export type { BreakerStats } from './breaker.js';
+export { CircuitBreaker } from './breaker.js';
+export type { RetryOptions } from './retry.js';
+export { withRetry } from './retry.js';
+export type { TimeoutOptions } from './timeout.js';
+export { withTimeout, withTimeoutSimple } from './timeout.js';
+export type { GatewayOptions, ReliabilityStats, ServerStats, ToolLookup, } from './gateway.js';
+export { ReliabilityGateway } from './gateway.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/reliability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGjG,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9D,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/reliability/index.js

@@ -0,0 +1,16 @@
+/**
+ * src/reliability — public API
+ *
+ * Everything a consumer needs is re-exported here. Internal modules should be
+ * imported directly only within the reliability package.
+ *
+ * @module reliability
+ */
+export { DEFAULT_PROFILE, resolveProfile, isMutation, applyMutationDefault } from './profile.js';
+// Structured error classes
+export { MCPToolError, TimeoutError, RetryExhaustedError, CircuitOpenError, extractErrorCode, isRetryable, } from './errors.js';
+export { CircuitBreaker } from './breaker.js';
+export { withRetry } from './retry.js';
+export { withTimeout, withTimeoutSimple } from './timeout.js';
+export { ReliabilityGateway } from './gateway.js';
+//# sourceMappingURL=index.js.map

package/dist/reliability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEjG,2BAA2B;AAC3B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAS9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/reliability/profile.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ReliabilityProfile — per-tool/per-server/global reliability configuration.
+ *
+ * Resolution order:
+ *   tool-level ToolDefinition.reliability → server-level config → global default
+ */
+export interface ReliabilityProfile {
+    /** Call timeout in ms. Default: 10000 */
+    timeoutMs?: number;
+    /**
+     * Number of retry attempts after the initial failure.
+     * Default: 2 for reads, 0 for mutations.
+     */
+    retries?: number;
+    /** Initial retry delay in ms; doubles on each attempt. Default: 100 */
+    retryDelayMs?: number;
+    /** Maximum retry delay ceiling in ms. Default: 5000 */
+    retryMaxDelayMs?: number;
+    /**
+     * Failure ratio (0–1) that trips the circuit OPEN when exceeded.
+     * Default: 0.5
+     */
+    circuitBreakerThreshold?: number;
+    /** Rolling window for failure ratio tracking in ms. Default: 60000 */
+    circuitBreakerWindowMs?: number;
+    /** Minimum calls in the window before the circuit can trip. Default: 10 */
+    circuitBreakerMinCalls?: number;
+    /** How long to wait in OPEN state before allowing a probe. Default: 30000 */
+    halfOpenProbeIntervalMs?: number;
+}
+export type CircuitState = 'closed' | 'open' | 'half-open';
+/** Global defaults applied when no profile field is provided. */
+export declare const DEFAULT_PROFILE: Required<ReliabilityProfile>;
+/**
+ * Merge profile overrides onto the global default, producing a fully-resolved
+ * profile with every field set.
+ */
+export declare function resolveProfile(override?: ReliabilityProfile, base?: Required<ReliabilityProfile>): Required<ReliabilityProfile>;
+/** Returns true if the tool name matches a mutation pattern. */
+export declare function isMutation(toolName: string): boolean;
+/**
+ * Apply mutation override: if the tool is a mutation AND the resolved profile
+ * did not explicitly set `retries`, force retries to 0.
+ *
+ * We detect "explicitly set" by checking whether the override provided the
+ * `retries` field directly (i.e., override?.retries is a number).
+ */
+export declare function applyMutationDefault(toolName: string, profile: Required<ReliabilityProfile>, explicitRetries: boolean): Required<ReliabilityProfile>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/reliability/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/reliability/profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,kBAAkB,CASxD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,IAAI,GAAE,QAAQ,CAAC,kBAAkB,CAAmB,GACnD,QAAQ,CAAC,kBAAkB,CAAC,CAY9B;AAQD,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACrC,eAAe,EAAE,OAAO,GACvB,QAAQ,CAAC,kBAAkB,CAAC,CAK9B"}