centient 2.20.0

package/dist/utils/CircuitBreaker.js

@@ -0,0 +1,236 @@
+export class CircuitBreakerError extends Error {
+    serviceName;
+    state;
+    constructor(message, serviceName, state) {
+        super(message);
+        this.serviceName = serviceName;
+        this.state = state;
+        this.name = "CircuitBreakerError";
+    }
+}
+export class CircuitBreaker {
+    state = "CLOSED";
+    failures = 0;
+    successes = 0;
+    consecutiveSuccesses = 0;
+    lastFailure = null;
+    lastSuccess = null;
+    lastStateChange = new Date();
+    totalRequests = 0;
+    totalFailures = 0;
+    totalSuccesses = 0;
+    openedAt = null;
+    name;
+    failureThreshold;
+    resetTimeout;
+    halfOpenSuccesses;
+    onStateChange;
+    constructor(config) {
+        this.name = config.name;
+        this.failureThreshold = config.failureThreshold ?? 5;
+        this.resetTimeout = config.resetTimeout ?? 30000;
+        this.halfOpenSuccesses = config.halfOpenSuccesses ?? 2;
+        this.onStateChange = config.onStateChange;
+    }
+    async execute(operation) {
+        this.totalRequests++;
+        if (this.state === "OPEN") {
+            if (this.shouldAttemptReset()) {
+                this.transitionTo("HALF_OPEN");
+            }
+            else {
+                throw new CircuitBreakerError(`Circuit breaker is OPEN for ${this.name}. Service unavailable.`, this.name, this.state);
+            }
+        }
+        try {
+            const result = await operation();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure(error);
+            throw error;
+        }
+    }
+    async executeWithFallback(operation, fallback) {
+        try {
+            return await this.execute(operation);
+        }
+        catch (error) {
+            if (error instanceof CircuitBreakerError) {
+                console.error(`[CircuitBreaker] ${this.name}: Using fallback (circuit ${this.state})`);
+            }
+            return typeof fallback === "function"
+                ? await fallback()
+                : fallback;
+        }
+    }
+    isAllowed() {
+        if (this.state === "CLOSED")
+            return true;
+        if (this.state === "HALF_OPEN")
+            return true;
+        if (this.state === "OPEN" && this.shouldAttemptReset())
+            return true;
+        return false;
+    }
+    getStats() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            lastFailure: this.lastFailure,
+            lastSuccess: this.lastSuccess,
+            lastStateChange: this.lastStateChange,
+            totalRequests: this.totalRequests,
+            totalFailures: this.totalFailures,
+            totalSuccesses: this.totalSuccesses,
+            consecutiveSuccesses: this.consecutiveSuccesses,
+        };
+    }
+    getState() {
+        return this.state;
+    }
+    reset() {
+        this.transitionTo("CLOSED");
+        this.failures = 0;
+        this.successes = 0;
+        this.consecutiveSuccesses = 0;
+        this.openedAt = null;
+    }
+    forceOpen() {
+        this.transitionTo("OPEN");
+        this.openedAt = new Date();
+    }
+    shouldAttemptReset() {
+        if (!this.openedAt)
+            return false;
+        return Date.now() - this.openedAt.getTime() >= this.resetTimeout;
+    }
+    onSuccess() {
+        this.lastSuccess = new Date();
+        this.totalSuccesses++;
+        this.successes++;
+        this.consecutiveSuccesses++;
+        this.failures = 0;
+        if (this.state === "HALF_OPEN") {
+            if (this.consecutiveSuccesses >= this.halfOpenSuccesses) {
+                this.transitionTo("CLOSED");
+                this.consecutiveSuccesses = 0;
+                this.openedAt = null;
+            }
+        }
+    }
+    onFailure(error) {
+        this.lastFailure = new Date();
+        this.totalFailures++;
+        this.failures++;
+        this.consecutiveSuccesses = 0;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`[CircuitBreaker] ${this.name}: Failure #${this.failures} - ${errorMessage}`);
+        if (this.state === "HALF_OPEN") {
+            this.transitionTo("OPEN");
+            this.openedAt = new Date();
+        }
+        else if (this.state === "CLOSED" &&
+            this.failures >= this.failureThreshold) {
+            this.transitionTo("OPEN");
+            this.openedAt = new Date();
+        }
+    }
+    transitionTo(newState) {
+        if (this.state === newState)
+            return;
+        const oldState = this.state;
+        const stats = this.getStats();
+        this.state = newState;
+        this.lastStateChange = new Date();
+        console.error(`[CircuitBreaker] ${this.name}: ${oldState} → ${newState} ` +
+            `(failures: ${this.failures}, successes: ${this.successes})`);
+        this.onStateChange?.(oldState, newState, stats);
+    }
+}
+class CircuitBreakerRegistry {
+    breakers = new Map();
+    defaultConfig = {
+        failureThreshold: 5,
+        resetTimeout: 30000,
+        halfOpenSuccesses: 2,
+    };
+    getBreaker(name, config) {
+        let breaker = this.breakers.get(name);
+        if (!breaker) {
+            breaker = new CircuitBreaker({
+                name,
+                ...this.defaultConfig,
+                ...config,
+            });
+            this.breakers.set(name, breaker);
+        }
+        return breaker;
+    }
+    getAllStats() {
+        const stats = {};
+        for (const [name, breaker] of this.breakers) {
+            stats[name] = breaker.getStats();
+        }
+        return stats;
+    }
+    resetAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.reset();
+        }
+    }
+    hasOpenCircuits() {
+        for (const breaker of this.breakers.values()) {
+            if (breaker.getState() === "OPEN")
+                return true;
+        }
+        return false;
+    }
+    getOpenCircuits() {
+        const open = [];
+        for (const [name, breaker] of this.breakers) {
+            if (breaker.getState() === "OPEN") {
+                open.push(name);
+            }
+        }
+        return open;
+    }
+    setDefaultConfig(config) {
+        this.defaultConfig = { ...this.defaultConfig, ...config };
+    }
+    clear() {
+        this.breakers.clear();
+    }
+}
+const registry = new CircuitBreakerRegistry();
+export function getCircuitBreakerRegistry() {
+    return registry;
+}
+export function getCircuitBreaker(serviceName, config) {
+    return registry.getBreaker(serviceName, config);
+}
+export const ServiceCircuitBreakers = {
+    qdrant: () => getCircuitBreaker("qdrant", {
+        failureThreshold: 10,
+        resetTimeout: 60000,
+        halfOpenSuccesses: 3,
+    }),
+    openai: () => getCircuitBreaker("openai", {
+        failureThreshold: 5,
+        resetTimeout: 30000,
+        halfOpenSuccesses: 2,
+    }),
+    gemini: () => getCircuitBreaker("gemini", {
+        failureThreshold: 3,
+        resetTimeout: 45000,
+        halfOpenSuccesses: 1,
+    }),
+    openrouter: () => getCircuitBreaker("openrouter", {
+        failureThreshold: 5,
+        resetTimeout: 30000,
+        halfOpenSuccesses: 2,
+    }),
+};
+//# sourceMappingURL=CircuitBreaker.js.map

package/dist/utils/CircuitBreaker.js.map

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

package/dist/utils/CostTracker.d.ts

@@ -0,0 +1,83 @@
+export type ServiceType = "openai" | "google" | "qdrant" | "openrouter";
+export type OperationType = "embedding" | "completion" | "file-search" | "storage" | "search" | "upsert";
+export type PeriodType = "hour" | "day" | "week" | "month" | "all";
+export interface CostEvent {
+    timestamp: string;
+    service: ServiceType;
+    operation: OperationType;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+    cached: boolean;
+    duration: number;
+    module: string;
+    tool?: string;
+}
+export interface ServiceSummary {
+    costUsd: number;
+    calls: number;
+    avgCostPerCall: number;
+    cachedCalls: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+}
+export interface ModelSummary {
+    costUsd: number;
+    calls: number;
+    avgCostPerCall: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface CostSummary {
+    period: PeriodType;
+    startDate: string;
+    endDate: string;
+    totalCostUsd: number;
+    totalCalls: number;
+    totalCachedCalls: number;
+    byService: Record<ServiceType, ServiceSummary>;
+    byModel: Record<string, ModelSummary>;
+    byModule: Record<string, number>;
+}
+export interface CostTrackingData {
+    events: CostEvent[];
+    lastFlush: string;
+    version: string;
+}
+export interface CostTrackerConfig {
+    storagePath: string;
+    flushIntervalMs: number;
+    maxEventAge: number;
+    maxEvents: number;
+}
+export declare class CostTracker {
+    private events;
+    private config;
+    private flushTimer;
+    private isDirty;
+    private isLoaded;
+    private loadPromise;
+    constructor(config?: Partial<CostTrackerConfig>);
+    recordCost(event: Omit<CostEvent, "timestamp" | "costUsd"> & {
+        costUsd?: number;
+    }): Promise<void>;
+    getSummary(period?: PeriodType, filters?: {
+        service?: ServiceType;
+        module?: string;
+    }): Promise<CostSummary>;
+    getRecentEvents(limit?: number): Promise<CostEvent[]>;
+    getEventCount(): Promise<number>;
+    flush(): Promise<void>;
+    clear(): Promise<void>;
+    destroy(): void;
+    private ensureLoaded;
+    private load;
+    private pruneOldEvents;
+    private startFlushTimer;
+    private getPeriodBounds;
+    private createEmptyServiceSummary;
+}
+export declare function getCostTracker(config?: Partial<CostTrackerConfig>): CostTracker;
+export declare function resetCostTracker(): void;
+//# sourceMappingURL=CostTracker.d.ts.map

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

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

package/dist/utils/CostTracker.js

@@ -0,0 +1,228 @@
+import * as fs from "fs/promises";
+import { calculateCost } from "./costPricing.js";
+const DEFAULT_CONFIG = {
+    storagePath: ".cost-tracking.json",
+    flushIntervalMs: 30 * 1000,
+    maxEventAge: 30 * 24 * 60 * 60 * 1000,
+    maxEvents: 10000,
+};
+export class CostTracker {
+    events = [];
+    config;
+    flushTimer = null;
+    isDirty = false;
+    isLoaded = false;
+    loadPromise = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startFlushTimer();
+    }
+    async recordCost(event) {
+        await this.ensureLoaded();
+        const costUsd = event.costUsd ??
+            calculateCost(event.model, event.inputTokens, event.outputTokens);
+        const fullEvent = {
+            ...event,
+            timestamp: new Date().toISOString(),
+            costUsd,
+        };
+        this.events.push(fullEvent);
+        this.isDirty = true;
+        if (this.events.length > this.config.maxEvents) {
+            this.pruneOldEvents();
+        }
+    }
+    async getSummary(period = "day", filters) {
+        await this.ensureLoaded();
+        const now = new Date();
+        const { startDate, endDate } = this.getPeriodBounds(period, now);
+        let filteredEvents = this.events.filter((e) => {
+            const eventDate = new Date(e.timestamp);
+            return eventDate >= new Date(startDate) && eventDate <= new Date(endDate);
+        });
+        if (filters?.service) {
+            filteredEvents = filteredEvents.filter((e) => e.service === filters.service);
+        }
+        if (filters?.module) {
+            filteredEvents = filteredEvents.filter((e) => e.module === filters.module);
+        }
+        const byService = {
+            openai: this.createEmptyServiceSummary(),
+            google: this.createEmptyServiceSummary(),
+            qdrant: this.createEmptyServiceSummary(),
+            openrouter: this.createEmptyServiceSummary(),
+        };
+        const byModel = {};
+        const byModule = {};
+        let totalCostUsd = 0;
+        let totalCalls = 0;
+        let totalCachedCalls = 0;
+        for (const event of filteredEvents) {
+            totalCostUsd += event.costUsd;
+            totalCalls++;
+            if (event.cached)
+                totalCachedCalls++;
+            byService[event.service].costUsd += event.costUsd;
+            byService[event.service].calls++;
+            if (event.cached)
+                byService[event.service].cachedCalls++;
+            byService[event.service].totalInputTokens += event.inputTokens;
+            byService[event.service].totalOutputTokens += event.outputTokens;
+            if (!byModel[event.model]) {
+                byModel[event.model] = {
+                    costUsd: 0,
+                    calls: 0,
+                    avgCostPerCall: 0,
+                    inputTokens: 0,
+                    outputTokens: 0,
+                };
+            }
+            const modelStats = byModel[event.model];
+            modelStats.costUsd += event.costUsd;
+            modelStats.calls++;
+            modelStats.inputTokens += event.inputTokens;
+            modelStats.outputTokens += event.outputTokens;
+            byModule[event.module] = (byModule[event.module] || 0) + event.costUsd;
+        }
+        for (const service of Object.values(byService)) {
+            service.avgCostPerCall =
+                service.calls > 0 ? service.costUsd / service.calls : 0;
+        }
+        for (const model of Object.values(byModel)) {
+            model.avgCostPerCall = model.calls > 0 ? model.costUsd / model.calls : 0;
+        }
+        return {
+            period,
+            startDate,
+            endDate,
+            totalCostUsd,
+            totalCalls,
+            totalCachedCalls,
+            byService,
+            byModel,
+            byModule,
+        };
+    }
+    async getRecentEvents(limit = 10) {
+        await this.ensureLoaded();
+        return this.events.slice(-limit);
+    }
+    async getEventCount() {
+        await this.ensureLoaded();
+        return this.events.length;
+    }
+    async flush() {
+        if (!this.isDirty)
+            return;
+        const data = {
+            events: this.events,
+            lastFlush: new Date().toISOString(),
+            version: "1.0.0",
+        };
+        try {
+            await fs.writeFile(this.config.storagePath, JSON.stringify(data, null, 2), "utf-8");
+            this.isDirty = false;
+        }
+        catch (error) {
+            console.error("[CostTracker] Failed to flush to disk:", error);
+        }
+    }
+    async clear() {
+        this.events = [];
+        this.isDirty = true;
+        await this.flush();
+    }
+    destroy() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    async ensureLoaded() {
+        if (this.isLoaded)
+            return;
+        if (this.loadPromise) {
+            await this.loadPromise;
+            return;
+        }
+        this.loadPromise = this.load();
+        await this.loadPromise;
+        this.loadPromise = null;
+    }
+    async load() {
+        try {
+            const content = await fs.readFile(this.config.storagePath, "utf-8");
+            const data = JSON.parse(content);
+            this.events = data.events || [];
+            this.pruneOldEvents();
+        }
+        catch (error) {
+            this.events = [];
+        }
+        this.isLoaded = true;
+    }
+    pruneOldEvents() {
+        const cutoff = Date.now() - this.config.maxEventAge;
+        const beforeCount = this.events.length;
+        this.events = this.events.filter((e) => new Date(e.timestamp).getTime() > cutoff);
+        if (this.events.length > this.config.maxEvents) {
+            this.events = this.events.slice(-this.config.maxEvents);
+        }
+        if (this.events.length !== beforeCount) {
+            this.isDirty = true;
+        }
+    }
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            this.flush().catch((err) => console.error("[CostTracker] Flush error:", err));
+        }, this.config.flushIntervalMs);
+        this.flushTimer.unref();
+    }
+    getPeriodBounds(period, now) {
+        const endDate = now.toISOString();
+        let startDate;
+        switch (period) {
+            case "hour":
+                startDate = new Date(now.getTime() - 60 * 60 * 1000);
+                break;
+            case "day":
+                startDate = new Date(now.getTime() - 24 * 60 * 60 * 1000);
+                break;
+            case "week":
+                startDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+                break;
+            case "month":
+                startDate = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+                break;
+            case "all":
+            default:
+                startDate = new Date(0);
+                break;
+        }
+        return { startDate: startDate.toISOString(), endDate };
+    }
+    createEmptyServiceSummary() {
+        return {
+            costUsd: 0,
+            calls: 0,
+            avgCostPerCall: 0,
+            cachedCalls: 0,
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+        };
+    }
+}
+let costTrackerInstance = null;
+export function getCostTracker(config) {
+    if (!costTrackerInstance) {
+        costTrackerInstance = new CostTracker(config);
+    }
+    return costTrackerInstance;
+}
+export function resetCostTracker() {
+    if (costTrackerInstance) {
+        costTrackerInstance.destroy();
+        costTrackerInstance = null;
+    }
+}
+//# sourceMappingURL=CostTracker.js.map

package/dist/utils/CostTracker.js.map

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

package/dist/utils/DockerSandbox.d.ts

@@ -0,0 +1,39 @@
+import type { SkillLanguage, ExecutionResult } from "./SkillExecutor.js";
+export interface SandboxConfig {
+    mode: "docker" | "subprocess" | "none";
+    memory: string;
+    cpu: string;
+    timeout: number;
+    networkEnabled: boolean;
+    allowedEnvVars: string[];
+    imagePrefix: string;
+}
+export interface SkillSandboxOverride {
+    sandbox?: boolean;
+    memory?: string;
+    cpu?: string;
+    timeout?: number;
+    networkEnabled?: boolean;
+}
+export declare class DockerSandbox {
+    private config;
+    private dockerAvailable;
+    constructor(config?: Partial<SandboxConfig>);
+    isAvailable(): Promise<boolean>;
+    getImageName(language: SkillLanguage): string;
+    imageExists(language: SkillLanguage): Promise<boolean>;
+    buildImage(language: SkillLanguage): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    ensureImage(language: SkillLanguage): Promise<{
+        available: boolean;
+        error?: string;
+    }>;
+    execute(skillPath: string, language: SkillLanguage, input: unknown, overrides?: SkillSandboxOverride): Promise<ExecutionResult>;
+    getConfig(): SandboxConfig;
+    getMode(): SandboxConfig["mode"];
+}
+export declare function getDockerSandbox(config?: Partial<SandboxConfig>): DockerSandbox;
+export declare function resetDockerSandbox(): void;
+//# sourceMappingURL=DockerSandbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DockerSandbox.d.ts","sourceRoot":"","sources":["../../src/utils/DockerSandbox.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKzE,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;IAEvC,MAAM,EAAE,MAAM,CAAC;IAEf,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,EAAE,MAAM,CAAC;IAEhB,cAAc,EAAE,OAAO,CAAC;IAExB,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,oBAAoB;IAEnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA4CD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAwB;gBAEnC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAQrC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA4BrC,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM;IAQvC,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAYtD,UAAU,CACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgD1C,WAAW,CACf,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgB5C,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAiN3B,SAAS,IAAI,aAAa;IAO1B,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC;CAGjC;AAQD,wBAAgB,gBAAgB,CAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,aAAa,CAKf;AAKD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}