@aiassesstech/nole 0.4.14 → 0.5.0

package/dist/resilience/resilient-client.js

@@ -0,0 +1,120 @@
+/**
+ * ResilientClient — Unified wrapper combining circuit breaker + retry.
+ *
+ * Replaces raw fetch() calls in Nole's service clients with
+ * protection against transient failures and cascading outages.
+ *
+ * @see SPEC-nole-operational-resilience.md §5
+ */
+import { CircuitBreaker } from './circuit-breaker.js';
+import { DEFAULT_RETRY_CONFIG, calculateDelay, isRetryable, extractRetryAfter, sleep, } from './retry.js';
+export class CircuitOpenError extends Error {
+    service;
+    state;
+    cooldownRemainingMs;
+    constructor(service, cooldownRemainingMs) {
+        super(`Circuit breaker OPEN for ${service} — next probe in ${Math.ceil(cooldownRemainingMs / 1000)}s`);
+        this.name = 'CircuitOpenError';
+        this.service = service;
+        this.state = 'open';
+        this.cooldownRemainingMs = cooldownRemainingMs;
+    }
+}
+export class ResilientClient {
+    config;
+    breaker;
+    retryConfig;
+    timeoutMs;
+    logger;
+    fetchFn;
+    constructor(config) {
+        this.config = config;
+        this.breaker = new CircuitBreaker(config.circuitBreaker);
+        this.retryConfig = config.retry ?? DEFAULT_RETRY_CONFIG;
+        this.timeoutMs = config.timeoutMs;
+        this.fetchFn = config.fetchFn ?? globalThis.fetch;
+        this.logger = config.logger ?? {
+            debug: () => { },
+            warn: () => { },
+            error: () => { },
+        };
+    }
+    async execute(url, init) {
+        const startTime = Date.now();
+        const service = this.config.circuitBreaker.name;
+        if (!this.breaker.canExecute()) {
+            const status = this.breaker.getStatus();
+            const remaining = status.currentCooldownMs - (Date.now() - status.lastStateChange);
+            throw new CircuitOpenError(service, Math.max(0, remaining));
+        }
+        let lastError = null;
+        const maxAttempts = 1 + this.retryConfig.maxRetries;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                this.logger.debug(`${service}: attempt ${attempt + 1}/${maxAttempts}`, { url });
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+                const resp = await this.fetchFn(url, {
+                    ...init,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (this.breaker.isFailureStatus(resp.status)) {
+                    const body = await resp.text().catch(() => '');
+                    this.breaker.recordFailure(`HTTP ${resp.status}: ${body.slice(0, 200)}`);
+                    if (isRetryable(resp.status, this.retryConfig) && attempt < maxAttempts - 1) {
+                        const delay = resp.status === 429
+                            ? (extractRetryAfter(resp.headers) ?? calculateDelay(attempt, this.retryConfig))
+                            : calculateDelay(attempt, this.retryConfig);
+                        this.logger.warn(`${service}: HTTP ${resp.status}, retrying in ${delay}ms`, {
+                            attempt: attempt + 1, url,
+                        });
+                        await sleep(delay);
+                        continue;
+                    }
+                    throw new Error(`${service}: HTTP ${resp.status} after ${attempt + 1} attempts`);
+                }
+                if (resp.status >= 200 && resp.status < 500) {
+                    this.breaker.recordSuccess();
+                }
+                if (resp.status === 429 && attempt < maxAttempts - 1) {
+                    const delay = extractRetryAfter(resp.headers) ?? calculateDelay(attempt, this.retryConfig);
+                    this.logger.warn(`${service}: rate limited (429), waiting ${delay}ms`, { url });
+                    await sleep(delay);
+                    continue;
+                }
+                const body = await resp.text();
+                return {
+                    status: resp.status,
+                    headers: resp.headers,
+                    body,
+                    attempts: attempt + 1,
+                    totalDurationMs: Date.now() - startTime,
+                };
+            }
+            catch (err) {
+                if (err instanceof CircuitOpenError)
+                    throw err;
+                const error = err instanceof Error ? err : new Error(String(err));
+                lastError = error;
+                this.breaker.recordFailure(error.message.slice(0, 200));
+                if (isRetryable(error, this.retryConfig) && attempt < maxAttempts - 1) {
+                    const delay = calculateDelay(attempt, this.retryConfig);
+                    this.logger.warn(`${service}: network error, retrying in ${delay}ms`, {
+                        attempt: attempt + 1, error: error.message.slice(0, 100),
+                    });
+                    await sleep(delay);
+                    continue;
+                }
+            }
+        }
+        throw lastError ?? new Error(`${service}: all ${maxAttempts} attempts failed`);
+    }
+    getCircuitStatus() {
+        return this.breaker.getStatus();
+    }
+    get serviceName() {
+        return this.config.circuitBreaker.name;
+    }
+}
+//# sourceMappingURL=resilient-client.js.map

package/dist/resilience/resilient-client.js.map

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

package/dist/resilience/retry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Retry logic — exponential backoff with jitter, Retry-After support.
+ *
+ * Retry is separate from the circuit breaker: the breaker decides whether
+ * to attempt at all, retry decides how many times to reattempt on failure.
+ *
+ * @see SPEC-nole-operational-resilience.md §4
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    jitterFactor: number;
+    retryableStatusCodes: number[];
+    retryOnNetworkError: boolean;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export declare function calculateDelay(attempt: number, config: RetryConfig): number;
+export declare function isRetryable(statusOrError: number | Error, config: RetryConfig): boolean;
+export declare function extractRetryAfter(headers: Headers | Record<string, string>): number | null;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/resilience/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/resilience/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,oBAAoB,EAAE,WAOlC,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAK3E;AAED,wBAAgB,WAAW,CACzB,aAAa,EAAE,MAAM,GAAG,KAAK,EAC7B,MAAM,EAAE,WAAW,GAClB,OAAO,CAkBT;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAkB1F;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrE"}

package/dist/resilience/retry.js

@@ -0,0 +1,68 @@
+/**
+ * Retry logic — exponential backoff with jitter, Retry-After support.
+ *
+ * Retry is separate from the circuit breaker: the breaker decides whether
+ * to attempt at all, retry decides how many times to reattempt on failure.
+ *
+ * @see SPEC-nole-operational-resilience.md §4
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 1_000,
+    maxDelayMs: 30_000,
+    jitterFactor: 0.25,
+    retryableStatusCodes: [429, 500, 502, 503, 504],
+    retryOnNetworkError: true,
+};
+export function calculateDelay(attempt, config) {
+    const exponentialDelay = config.baseDelayMs * Math.pow(2, attempt);
+    const cappedDelay = Math.min(exponentialDelay, config.maxDelayMs);
+    const jitter = cappedDelay * config.jitterFactor * (Math.random() * 2 - 1);
+    return Math.max(0, Math.round(cappedDelay + jitter));
+}
+export function isRetryable(statusOrError, config) {
+    if (typeof statusOrError === 'number') {
+        return config.retryableStatusCodes.includes(statusOrError);
+    }
+    if (!config.retryOnNetworkError)
+        return false;
+    const msg = statusOrError.message.toLowerCase();
+    return (msg.includes('econnrefused') ||
+        msg.includes('econnreset') ||
+        msg.includes('etimedout') ||
+        msg.includes('enotfound') ||
+        msg.includes('epipe') ||
+        msg.includes('socket hang up') ||
+        msg.includes('fetch failed') ||
+        msg.includes('abort'));
+}
+export function extractRetryAfter(headers) {
+    const value = headers instanceof Headers
+        ? headers.get('retry-after')
+        : headers['retry-after'];
+    if (!value)
+        return null;
+    const seconds = parseInt(value, 10);
+    if (!isNaN(seconds)) {
+        return seconds * 1000;
+    }
+    const date = new Date(value);
+    if (!isNaN(date.getTime())) {
+        return Math.max(0, date.getTime() - Date.now());
+    }
+    return null;
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('Aborted'));
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            reject(new Error('Aborted'));
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/resilience/retry.js.map

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

package/dist/resilience/service-configs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Per-service circuit breaker configurations.
+ *
+ * Each service has different failure characteristics — these configs
+ * are tuned to match expected behavior and recovery patterns.
+ *
+ * @see SPEC-nole-operational-resilience.md §3.3
+ */
+import type { CircuitBreakerConfig } from './circuit-breaker.js';
+export declare const PLATFORM_API_BREAKER: Omit<CircuitBreakerConfig, 'onStateChange'>;
+export declare const X_API_BREAKER: Omit<CircuitBreakerConfig, 'onStateChange'>;
+export declare const MOLTBOOK_API_BREAKER: Omit<CircuitBreakerConfig, 'onStateChange'>;
+export declare const BLOCKCHAIN_BREAKER: Omit<CircuitBreakerConfig, 'onStateChange'>;
+//# sourceMappingURL=service-configs.d.ts.map

package/dist/resilience/service-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-configs.d.ts","sourceRoot":"","sources":["../../src/resilience/service-configs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,eAAO,MAAM,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAQ5E,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAQrE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAQ5E,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAQ1E,CAAC"}

package/dist/resilience/service-configs.js

@@ -0,0 +1,45 @@
+/**
+ * Per-service circuit breaker configurations.
+ *
+ * Each service has different failure characteristics — these configs
+ * are tuned to match expected behavior and recovery patterns.
+ *
+ * @see SPEC-nole-operational-resilience.md §3.3
+ */
+export const PLATFORM_API_BREAKER = {
+    name: 'platform-api',
+    failureThreshold: 3,
+    failureWindowMs: 60_000,
+    cooldownMs: 30_000,
+    maxCooldownMs: 5 * 60_000,
+    cooldownMultiplier: 2,
+    failureStatusCodes: [500, 502, 503, 504],
+};
+export const X_API_BREAKER = {
+    name: 'x-twitter',
+    failureThreshold: 5,
+    failureWindowMs: 5 * 60_000,
+    cooldownMs: 2 * 60_000,
+    maxCooldownMs: 30 * 60_000,
+    cooldownMultiplier: 2,
+    failureStatusCodes: [500, 502, 503, 504],
+};
+export const MOLTBOOK_API_BREAKER = {
+    name: 'moltbook',
+    failureThreshold: 3,
+    failureWindowMs: 2 * 60_000,
+    cooldownMs: 60_000,
+    maxCooldownMs: 10 * 60_000,
+    cooldownMultiplier: 2,
+    failureStatusCodes: [500, 502, 503, 504],
+};
+export const BLOCKCHAIN_BREAKER = {
+    name: 'blockchain',
+    failureThreshold: 5,
+    failureWindowMs: 10 * 60_000,
+    cooldownMs: 5 * 60_000,
+    maxCooldownMs: 60 * 60_000,
+    cooldownMultiplier: 2,
+    failureStatusCodes: [500, 502, 503, 504],
+};
+//# sourceMappingURL=service-configs.js.map

package/dist/resilience/service-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-configs.js","sourceRoot":"","sources":["../../src/resilience/service-configs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAgD;IAC/E,IAAI,EAAE,cAAc;IACpB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM;IACvB,UAAU,EAAE,MAAM;IAClB,aAAa,EAAE,CAAC,GAAG,MAAM;IACzB,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,IAAI,EAAE,WAAW;IACjB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC,GAAG,MAAM;IAC3B,UAAU,EAAE,CAAC,GAAG,MAAM;IACtB,aAAa,EAAE,EAAE,GAAG,MAAM;IAC1B,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgD;IAC/E,IAAI,EAAE,UAAU;IAChB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC,GAAG,MAAM;IAC3B,UAAU,EAAE,MAAM;IAClB,aAAa,EAAE,EAAE,GAAG,MAAM;IAC1B,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgD;IAC7E,IAAI,EAAE,YAAY;IAClB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,EAAE,GAAG,MAAM;IAC5B,UAAU,EAAE,CAAC,GAAG,MAAM;IACtB,aAAa,EAAE,EAAE,GAAG,MAAM;IAC1B,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACzC,CAAC"}

package/dist/resilience/service-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Service Registry — Degraded-mode management.
+ *
+ * Tracks which external services are healthy, degraded, or down.
+ * Nole's business logic queries this to adapt behavior.
+ * Writes a status file that Mighty Mark can read (read-only contract).
+ *
+ * @see SPEC-nole-operational-resilience.md §6
+ */
+import type { ResilientClient } from './resilient-client.js';
+export type ServiceHealth = 'healthy' | 'degraded' | 'down';
+export interface ServiceStatus {
+    name: string;
+    health: ServiceHealth;
+    circuitState: string;
+    failureCount: number;
+    lastSuccessfulCall: number | null;
+    lastFailedCall: number | null;
+    recentErrors: string[];
+}
+export interface RegistrySnapshot {
+    timestamp: number;
+    overallHealth: ServiceHealth;
+    services: Record<string, ServiceStatus>;
+}
+export declare class ServiceRegistry {
+    private clients;
+    private lastSuccess;
+    private lastFailure;
+    register(client: ResilientClient): void;
+    recordSuccess(serviceName: string): void;
+    recordFailure(serviceName: string): void;
+    getHealth(serviceName: string): ServiceHealth;
+    getOverallHealth(): ServiceHealth;
+    getSnapshot(): RegistrySnapshot;
+    writeStatusFile(dataDir: string): Promise<void>;
+    isAvailable(serviceName: string): boolean;
+}
+//# sourceMappingURL=service-registry.d.ts.map

package/dist/resilience/service-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../../src/resilience/service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAA6B;IAEhD,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIvC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIxC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIxC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAc7C,gBAAgB,IAAI,aAAa;IAUjC,WAAW,IAAI,gBAAgB;IAuBzB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAerD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAG1C"}

package/dist/resilience/service-registry.js

@@ -0,0 +1,82 @@
+/**
+ * Service Registry — Degraded-mode management.
+ *
+ * Tracks which external services are healthy, degraded, or down.
+ * Nole's business logic queries this to adapt behavior.
+ * Writes a status file that Mighty Mark can read (read-only contract).
+ *
+ * @see SPEC-nole-operational-resilience.md §6
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class ServiceRegistry {
+    clients = new Map();
+    lastSuccess = new Map();
+    lastFailure = new Map();
+    register(client) {
+        this.clients.set(client.serviceName, client);
+    }
+    recordSuccess(serviceName) {
+        this.lastSuccess.set(serviceName, Date.now());
+    }
+    recordFailure(serviceName) {
+        this.lastFailure.set(serviceName, Date.now());
+    }
+    getHealth(serviceName) {
+        const client = this.clients.get(serviceName);
+        if (!client)
+            return 'down';
+        const status = client.getCircuitStatus();
+        switch (status.state) {
+            case 'open': return 'down';
+            case 'half-open': return 'degraded';
+            case 'closed':
+                return status.failureCount > 0 ? 'degraded' : 'healthy';
+        }
+    }
+    getOverallHealth() {
+        let worst = 'healthy';
+        for (const [name] of this.clients) {
+            const health = this.getHealth(name);
+            if (health === 'down')
+                return 'down';
+            if (health === 'degraded')
+                worst = 'degraded';
+        }
+        return worst;
+    }
+    getSnapshot() {
+        const services = {};
+        for (const [name, client] of this.clients) {
+            const circuit = client.getCircuitStatus();
+            services[name] = {
+                name,
+                health: this.getHealth(name),
+                circuitState: circuit.state,
+                failureCount: circuit.failureCount,
+                lastSuccessfulCall: this.lastSuccess.get(name) ?? null,
+                lastFailedCall: this.lastFailure.get(name) ?? null,
+                recentErrors: circuit.recentFailures,
+            };
+        }
+        return {
+            timestamp: Date.now(),
+            overallHealth: this.getOverallHealth(),
+            services,
+        };
+    }
+    async writeStatusFile(dataDir) {
+        const snapshot = this.getSnapshot();
+        const statusPath = path.join(dataDir, 'service-health.json');
+        try {
+            await fs.promises.writeFile(statusPath, JSON.stringify(snapshot, null, 2), 'utf-8');
+        }
+        catch {
+            // Non-fatal — status file is informational
+        }
+    }
+    isAvailable(serviceName) {
+        return this.getHealth(serviceName) !== 'down';
+    }
+}
+//# sourceMappingURL=service-registry.js.map

package/dist/resilience/service-registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiassesstech/nole",
-  "version": "0.4.14",
+  "version": "0.5.0",
   "description": "Nole — Autonomous Trust Evangelist & Intelligence Operative for AI. Economic agency, social presence, and autonomous decision-making within a governed hierarchy.",
   "type": "module",
   "main": "dist/index.js",