@blackms/aistack 1.2.0 → 1.3.1

package/dist/utils/retry.js

@@ -0,0 +1,160 @@
+/**
+ * Retry logic with exponential backoff and circuit breaker
+ */
+import { logger } from './logger.js';
+const log = logger.child('retry');
+/**
+ * Circuit Breaker implementation
+ * Prevents cascading failures by stopping requests when error rate is too high
+ */
+export class CircuitBreaker {
+    state = 'CLOSED';
+    failureCount = 0;
+    successCount = 0;
+    nextAttemptTime = 0;
+    failureThreshold;
+    successThreshold;
+    timeout;
+    halfOpenRetryDelayMs;
+    name;
+    constructor(name, options = {}) {
+        this.name = name;
+        this.failureThreshold = options.failureThreshold ?? 5;
+        this.successThreshold = options.successThreshold ?? 2;
+        this.timeout = options.timeout ?? 60000; // 1 minute
+        this.halfOpenRetryDelayMs = options.halfOpenRetryDelayMs ?? 30000; // 30 seconds
+    }
+    getState() {
+        return this.state;
+    }
+    isOpen() {
+        if (this.state === 'OPEN') {
+            // Check if we should transition to HALF_OPEN
+            if (Date.now() >= this.nextAttemptTime) {
+                log.info('Circuit breaker transitioning to HALF_OPEN', { name: this.name });
+                this.state = 'HALF_OPEN';
+                this.successCount = 0;
+                return false;
+            }
+            return true;
+        }
+        return false;
+    }
+    async execute(fn) {
+        if (this.isOpen()) {
+            throw new Error(`Circuit breaker is OPEN for ${this.name}`);
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.failureCount = 0;
+        if (this.state === 'HALF_OPEN') {
+            this.successCount++;
+            if (this.successCount >= this.successThreshold) {
+                log.info('Circuit breaker transitioning to CLOSED', { name: this.name });
+                this.state = 'CLOSED';
+                this.successCount = 0;
+            }
+        }
+    }
+    onFailure() {
+        this.failureCount++;
+        if (this.state === 'HALF_OPEN') {
+            log.warn('Circuit breaker transitioning to OPEN (failure in HALF_OPEN)', {
+                name: this.name,
+            });
+            this.state = 'OPEN';
+            this.nextAttemptTime = Date.now() + this.timeout;
+            return;
+        }
+        if (this.failureCount >= this.failureThreshold) {
+            log.warn('Circuit breaker transitioning to OPEN', {
+                name: this.name,
+                failureCount: this.failureCount,
+                threshold: this.failureThreshold,
+            });
+            this.state = 'OPEN';
+            this.nextAttemptTime = Date.now() + this.timeout;
+        }
+    }
+    reset() {
+        this.state = 'CLOSED';
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.nextAttemptTime = 0;
+        log.info('Circuit breaker reset', { name: this.name });
+    }
+}
+/**
+ * Retry with exponential backoff
+ */
+export async function retryWithBackoff(fn, options = {}) {
+    const maxAttempts = options.maxAttempts ?? 3;
+    const initialDelayMs = options.initialDelayMs ?? 1000;
+    const maxDelayMs = options.maxDelayMs ?? 30000;
+    const backoffMultiplier = options.backoffMultiplier ?? 2;
+    const retryableErrors = options.retryableErrors ?? [
+        'ECONNRESET',
+        'ETIMEDOUT',
+        'ENOTFOUND',
+        'rate_limit',
+        'timeout',
+        '429',
+        '500',
+        '502',
+        '503',
+        '504',
+    ];
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if error is retryable
+            const isRetryable = retryableErrors.some((pattern) => {
+                if (typeof pattern === 'string') {
+                    return lastError.message.includes(pattern);
+                }
+                return pattern.test(lastError.message);
+            });
+            if (!isRetryable || attempt === maxAttempts) {
+                throw lastError;
+            }
+            // Calculate delay with exponential backoff and jitter
+            const baseDelay = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt - 1), maxDelayMs);
+            const jitter = Math.random() * 0.3 * baseDelay; // Up to 30% jitter
+            const delay = baseDelay + jitter;
+            log.warn('Retrying after error', {
+                attempt,
+                maxAttempts,
+                delayMs: Math.round(delay),
+                error: lastError.message,
+            });
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Sleep utility
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry with circuit breaker
+ */
+export async function retryWithCircuitBreaker(fn, circuitBreaker, retryOptions) {
+    return circuitBreaker.execute(() => retryWithBackoff(fn, retryOptions));
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/semaphore.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Semaphore for concurrency control
+ */
+export declare class Semaphore {
+    private permits;
+    private maxPermits;
+    private queue;
+    private readonly name;
+    constructor(name: string, maxPermits: number);
+    /**
+     * Acquire a permit
+     * Waits if no permits available
+     */
+    acquire(): Promise<void>;
+    /**
+     * Try to acquire a permit without waiting
+     * Returns true if acquired, false otherwise
+     */
+    tryAcquire(): boolean;
+    /**
+     * Release a permit
+     */
+    release(): void;
+    /**
+     * Execute function with acquired permit
+     * Automatically releases permit when done
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get current state
+     */
+    getState(): {
+        available: number;
+        maxPermits: number;
+        queued: number;
+    };
+    /**
+     * Reset semaphore to initial state
+     */
+    reset(): void;
+}
+/**
+ * Agent pool for reusing agents
+ */
+export declare class AgentPool {
+    private pool;
+    private inUse;
+    private maxPoolSize;
+    constructor(maxPoolSize?: number);
+    /**
+     * Get an agent from the pool or null if none available
+     */
+    acquire(agentType: string): string | null;
+    /**
+     * Return an agent to the pool
+     */
+    release(agentType: string, agentId: string): void;
+    /**
+     * Remove an agent from the pool
+     */
+    remove(agentType: string, agentId: string): void;
+    /**
+     * Get pool statistics
+     */
+    getStats(): Record<string, {
+        total: number;
+        inUse: number;
+        available: number;
+    }>;
+    /**
+     * Clear the pool
+     */
+    clear(): void;
+}
+//# sourceMappingURL=semaphore.d.ts.map

package/dist/utils/semaphore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.d.ts","sourceRoot":"","sources":["../../src/utils/semaphore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAM5C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAYrB;;OAEG;IACH,OAAO,IAAI,IAAI;IAoBf;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASlD;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB;IAQD;;OAEG;IACH,KAAK,IAAI,IAAI;CASd;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAW;IAIpC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAazC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWjD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYhD;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAe/E;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/utils/semaphore.js

@@ -0,0 +1,185 @@
+/**
+ * Semaphore for concurrency control
+ */
+import { logger } from './logger.js';
+const log = logger.child('semaphore');
+export class Semaphore {
+    permits;
+    maxPermits;
+    queue = [];
+    name;
+    constructor(name, maxPermits) {
+        this.name = name;
+        this.permits = maxPermits;
+        this.maxPermits = maxPermits;
+    }
+    /**
+     * Acquire a permit
+     * Waits if no permits available
+     */
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            log.debug('Permit acquired', {
+                name: this.name,
+                available: this.permits,
+                queued: this.queue.length,
+            });
+            return;
+        }
+        // Wait for permit
+        await new Promise((resolve) => {
+            this.queue.push(resolve);
+            log.debug('Waiting for permit', {
+                name: this.name,
+                queued: this.queue.length,
+            });
+        });
+    }
+    /**
+     * Try to acquire a permit without waiting
+     * Returns true if acquired, false otherwise
+     */
+    tryAcquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            log.debug('Permit acquired (try)', {
+                name: this.name,
+                available: this.permits,
+            });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Release a permit
+     */
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            // Give permit to waiting task
+            next();
+            log.debug('Permit released (waiting task)', {
+                name: this.name,
+                available: this.permits,
+                queued: this.queue.length,
+            });
+        }
+        else {
+            // Return permit to pool
+            this.permits++;
+            log.debug('Permit released', {
+                name: this.name,
+                available: this.permits,
+            });
+        }
+    }
+    /**
+     * Execute function with acquired permit
+     * Automatically releases permit when done
+     */
+    async execute(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return {
+            available: this.permits,
+            maxPermits: this.maxPermits,
+            queued: this.queue.length,
+        };
+    }
+    /**
+     * Reset semaphore to initial state
+     */
+    reset() {
+        // Reject all waiting tasks
+        for (const resolve of this.queue) {
+            resolve();
+        }
+        this.queue = [];
+        this.permits = this.maxPermits;
+        log.info('Semaphore reset', { name: this.name });
+    }
+}
+/**
+ * Agent pool for reusing agents
+ */
+export class AgentPool {
+    pool = new Map(); // type -> agentIds[]
+    inUse = new Set();
+    maxPoolSize;
+    constructor(maxPoolSize = 10) {
+        this.maxPoolSize = maxPoolSize;
+    }
+    /**
+     * Get an agent from the pool or null if none available
+     */
+    acquire(agentType) {
+        const available = this.pool.get(agentType) || [];
+        const agentId = available.find((id) => !this.inUse.has(id));
+        if (agentId) {
+            this.inUse.add(agentId);
+            log.debug('Agent acquired from pool', { agentType, agentId });
+            return agentId;
+        }
+        return null;
+    }
+    /**
+     * Return an agent to the pool
+     */
+    release(agentType, agentId) {
+        this.inUse.delete(agentId);
+        const pool = this.pool.get(agentType) || [];
+        if (!pool.includes(agentId) && pool.length < this.maxPoolSize) {
+            pool.push(agentId);
+            this.pool.set(agentType, pool);
+            log.debug('Agent returned to pool', { agentType, agentId });
+        }
+    }
+    /**
+     * Remove an agent from the pool
+     */
+    remove(agentType, agentId) {
+        this.inUse.delete(agentId);
+        const pool = this.pool.get(agentType) || [];
+        const index = pool.indexOf(agentId);
+        if (index !== -1) {
+            pool.splice(index, 1);
+            this.pool.set(agentType, pool);
+            log.debug('Agent removed from pool', { agentType, agentId });
+        }
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        const stats = {};
+        for (const [agentType, agentIds] of this.pool.entries()) {
+            const inUseCount = agentIds.filter((id) => this.inUse.has(id)).length;
+            stats[agentType] = {
+                total: agentIds.length,
+                inUse: inUseCount,
+                available: agentIds.length - inUseCount,
+            };
+        }
+        return stats;
+    }
+    /**
+     * Clear the pool
+     */
+    clear() {
+        this.pool.clear();
+        this.inUse.clear();
+        log.info('Agent pool cleared');
+    }
+}
+//# sourceMappingURL=semaphore.js.map

package/dist/utils/semaphore.js.map

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

package/dist/utils/validation.d.ts

@@ -89,13 +89,13 @@ export declare const AgentSpawnInputSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     type: string;
-    metadata?: Record<string, unknown> | undefined;
     name?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
     sessionId?: string | undefined;
 }, {
     type: string;
-    metadata?: Record<string, unknown> | undefined;
     name?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
     sessionId?: string | undefined;
 }>;
 export declare const AgentStopInputSchema: z.ZodEffects<z.ZodObject<{

package/dist/web/middleware/auth.d.ts

@@ -1,21 +1,27 @@
 /**
- * Authentication middleware (placeholder for future implementation)
+ * Authentication middleware
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
-export interface AuthContext {
-    authenticated: boolean;
-    userId?: string;
-    permissions?: string[];
-}
+import { AuthService } from '../../auth/service.js';
+import type { AuthContext } from '../../auth/types.js';
+export type { AuthContext };
+/**
+ * Initialize authentication with service
+ */
+export declare function initAuth(service: AuthService): void;
 /**
  * Create authentication middleware
- * Currently a no-op that allows all requests
  */
-export declare function createAuthMiddleware(_options?: {
+export declare function createAuthMiddleware(options?: {
     required?: boolean;
-}): (_req: IncomingMessage, _res: ServerResponse) => AuthContext;
+    roles?: string[];
+}): (req: IncomingMessage, res: ServerResponse) => AuthContext;
 /**
- * Extract API key from request headers
+ * Get API key from request (legacy support)
  */
 export declare function getApiKey(req: IncomingMessage): string | null;
+/**
+ * Verify user has permission
+ */
+export declare function hasPermission(context: AuthContext, permission: string): boolean;
 //# sourceMappingURL=auth.d.ts.map

package/dist/web/middleware/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/web/middleware/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,IAEtE,MAAM,eAAe,EACrB,MAAM,cAAc,KACnB,WAAW,CAOf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAY7D"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/web/middleware/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,YAAY,EAAE,WAAW,EAAE,CAAC;AAI5B;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,IAIvF,KAAK,eAAe,EACpB,KAAK,cAAc,KAClB,WAAW,CAqEf;AAmBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAE7D;AAiDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAkB/E"}