@phantomind/core 0.1.0

package/dist/providers/openai.js

@@ -0,0 +1,80 @@
+/**
+ * PhantomMindAI — OpenAI Provider
+ */
+import { BaseProvider } from './base.js';
+export class OpenAIProvider extends BaseProvider {
+    client;
+    async getClient() {
+        if (!this.client) {
+            const { default: OpenAI } = await import('openai');
+            this.client = new OpenAI({
+                apiKey: this.config.apiKey || process.env.OPENAI_API_KEY,
+                ...(this.config.baseUrl && { baseURL: this.config.baseUrl }),
+            });
+        }
+        return this.client;
+    }
+    async complete(request) {
+        const client = await this.getClient();
+        const messages = this.buildMessages(request);
+        const start = Date.now();
+        const response = await client.chat.completions.create({
+            model: this.config.model,
+            messages: messages.map(m => ({ role: m.role, content: m.content })),
+            max_tokens: request.maxTokens ?? this.config.maxTokens ?? 8096,
+            temperature: request.temperature ?? this.config.temperature ?? 0.2,
+        });
+        const content = response.choices[0]?.message?.content ?? '';
+        const inputTokens = response.usage?.prompt_tokens ?? 0;
+        const outputTokens = response.usage?.completion_tokens ?? 0;
+        return {
+            content,
+            model: this.config.model,
+            provider: 'openai',
+            usage: {
+                inputTokens,
+                outputTokens,
+                totalTokens: inputTokens + outputTokens,
+                estimatedCost: this.estimateCost({ inputTokens, outputTokens }),
+            },
+            duration: Date.now() - start,
+        };
+    }
+    async *stream(request) {
+        const client = await this.getClient();
+        const messages = this.buildMessages(request);
+        const stream = await client.chat.completions.create({
+            model: this.config.model,
+            messages: messages.map(m => ({ role: m.role, content: m.content })),
+            max_tokens: request.maxTokens ?? this.config.maxTokens ?? 8096,
+            temperature: request.temperature ?? this.config.temperature ?? 0.2,
+            stream: true,
+        });
+        let totalContent = '';
+        for await (const chunk of stream) {
+            const delta = chunk.choices[0]?.delta?.content ?? '';
+            totalContent += delta;
+            if (delta) {
+                yield { content: delta, done: false };
+            }
+        }
+        yield {
+            content: '',
+            done: true,
+            usage: {
+                inputTokens: 0,
+                outputTokens: 0,
+                totalTokens: 0,
+                estimatedCost: 0,
+            },
+        };
+    }
+    async isAvailable() {
+        const apiKey = this.config.apiKey || process.env.OPENAI_API_KEY;
+        return !!apiKey;
+    }
+    async listModels() {
+        return ['gpt-4o', 'gpt-4o-mini', 'o1', 'o3'];
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/providers/openrouter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PhantomMindAI — OpenRouter Provider (universal gateway)
+ */
+import { BaseProvider } from './base.js';
+import type { CompletionRequest, CompletionResponse, StreamChunk } from '../types.js';
+export declare class OpenRouterProvider extends BaseProvider {
+    private baseUrl;
+    private apiKey;
+    constructor(config: any);
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    stream(request: CompletionRequest): AsyncGenerator<StreamChunk>;
+    isAvailable(): Promise<boolean>;
+    listModels(): Promise<string[]>;
+}
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/providers/openrouter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtF,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,GAAG;IAMjB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0ChE,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC;IA8ChE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAGtC"}

package/dist/providers/openrouter.js

@@ -0,0 +1,101 @@
+/**
+ * PhantomMindAI — OpenRouter Provider (universal gateway)
+ */
+import { BaseProvider } from './base.js';
+export class OpenRouterProvider extends BaseProvider {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        super(config);
+        this.apiKey = config.apiKey || process.env.OPENROUTER_API_KEY || '';
+        this.baseUrl = config.baseUrl || 'https://openrouter.ai/api/v1';
+    }
+    async complete(request) {
+        const messages = this.buildMessages(request);
+        const start = Date.now();
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+                'X-Title': 'PhantomMindAI',
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                messages: messages.map(m => ({ role: m.role, content: m.content })),
+                max_tokens: request.maxTokens ?? this.config.maxTokens ?? 8096,
+                temperature: request.temperature ?? this.config.temperature ?? 0.2,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`OpenRouter API error: ${response.status} ${await response.text()}`);
+        }
+        const data = await response.json();
+        const content = data.choices?.[0]?.message?.content ?? '';
+        const inputTokens = data.usage?.prompt_tokens ?? 0;
+        const outputTokens = data.usage?.completion_tokens ?? 0;
+        return {
+            content,
+            model: this.config.model,
+            provider: 'openrouter',
+            usage: {
+                inputTokens,
+                outputTokens,
+                totalTokens: inputTokens + outputTokens,
+                estimatedCost: this.estimateCost({ inputTokens, outputTokens }),
+            },
+            duration: Date.now() - start,
+        };
+    }
+    async *stream(request) {
+        const messages = this.buildMessages(request);
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+                'X-Title': 'PhantomMindAI',
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                messages: messages.map(m => ({ role: m.role, content: m.content })),
+                max_tokens: request.maxTokens ?? this.config.maxTokens ?? 8096,
+                temperature: request.temperature ?? this.config.temperature ?? 0.2,
+                stream: true,
+            }),
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`OpenRouter stream error: ${response.status}`);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                if (line.startsWith('data: ') && line !== 'data: [DONE]') {
+                    try {
+                        const data = JSON.parse(line.slice(6));
+                        const text = data.choices?.[0]?.delta?.content ?? '';
+                        if (text)
+                            yield { content: text, done: false };
+                    }
+                    catch { /* skip */ }
+                }
+            }
+        }
+        yield { content: '', done: true };
+    }
+    async isAvailable() {
+        return !!(this.config.apiKey || process.env.OPENROUTER_API_KEY);
+    }
+    async listModels() {
+        return ['anthropic/claude-sonnet-4', 'openai/gpt-4o', 'google/gemini-2.0-flash-001'];
+    }
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/providers/openrouter.js.map

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

package/dist/providers/router.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PhantomMindAI — Provider Router & Factory
+ * Handles provider creation, automatic fallback, and budget-aware routing.
+ */
+import { EventEmitter } from 'eventemitter3';
+import { BaseProvider } from './base.js';
+import type { ProviderConfig, ProviderRouting, CompletionRequest, CompletionResponse, StreamChunk } from '../types.js';
+export declare class ProviderRouter extends EventEmitter {
+    private providers;
+    private routing;
+    private dailyCost;
+    private dailyCostDate;
+    private maxCostPerDay;
+    private warningThreshold;
+    private fallbackOnBudget;
+    constructor(routing: ProviderRouting, budgetConfig?: {
+        maxCostPerDay?: number;
+        warningAt?: number;
+        fallbackOnBudget?: string;
+    });
+    private initProvider;
+    /**
+     * Complete with automatic fallback and budget awareness
+     */
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /**
+     * Stream with fallback
+     */
+    stream(request: CompletionRequest): AsyncGenerator<StreamChunk>;
+    /**
+     * Get a specific provider by name
+     */
+    getProvider(name: string): BaseProvider | undefined;
+    /**
+     * Get a provider for a specific slot
+     */
+    getSlotProvider(slot: 'primary' | 'fallback' | 'budget' | 'local'): BaseProvider | undefined;
+    /**
+     * Get daily cost tracking
+     */
+    getDailyCost(): number;
+    private executeWithTracking;
+    private trackCost;
+    private shouldUseBudgetProvider;
+    private resetDailyCostIfNeeded;
+}
+/**
+ * Factory function to create a provider instance
+ */
+export declare function createProvider(config: ProviderConfig): BaseProvider;
+//# sourceMappingURL=router.d.ts.map

package/dist/providers/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/providers/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASzC,OAAO,KAAK,EAEV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EAEZ,MAAM,aAAa,CAAC;AAIrB,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAG/B,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE;IAe1F,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoDvE;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC;IAgBtE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWnD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS;IAI5F;;OAEG;IACH,YAAY,IAAI,MAAM;YAKR,mBAAmB;IAmBjC,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,sBAAsB;CAO/B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAqBnE"}

package/dist/providers/router.js

@@ -0,0 +1,198 @@
+/**
+ * PhantomMindAI — Provider Router & Factory
+ * Handles provider creation, automatic fallback, and budget-aware routing.
+ */
+import { EventEmitter } from 'eventemitter3';
+import { AnthropicProvider } from './anthropic.js';
+import { OpenAIProvider } from './openai.js';
+import { GeminiProvider } from './gemini.js';
+import { GroqProvider } from './groq.js';
+import { MistralProvider } from './mistral.js';
+import { OllamaProvider } from './ollama.js';
+import { DeepSeekProvider } from './deepseek.js';
+import { OpenRouterProvider } from './openrouter.js';
+const FALLBACK_TIMEOUT_MS = 2000;
+export class ProviderRouter extends EventEmitter {
+    providers = new Map();
+    routing;
+    dailyCost = 0;
+    dailyCostDate = '';
+    maxCostPerDay;
+    warningThreshold;
+    fallbackOnBudget;
+    constructor(routing, budgetConfig) {
+        super();
+        this.routing = routing;
+        this.maxCostPerDay = budgetConfig?.maxCostPerDay ?? 10.0;
+        this.warningThreshold = budgetConfig?.warningAt ?? 80;
+        this.fallbackOnBudget = budgetConfig?.fallbackOnBudget ?? 'budget';
+        // Initialize providers
+        this.initProvider('primary', routing.primary);
+        if (routing.fallback)
+            this.initProvider('fallback', routing.fallback);
+        if (routing.budget)
+            this.initProvider('budget', routing.budget);
+        if (routing.local)
+            this.initProvider('local', routing.local);
+    }
+    initProvider(slot, config) {
+        const provider = createProvider(config);
+        this.providers.set(slot, provider);
+    }
+    /**
+     * Complete with automatic fallback and budget awareness
+     */
+    async complete(request) {
+        this.resetDailyCostIfNeeded();
+        // Check budget
+        if (this.shouldUseBudgetProvider()) {
+            const budgetProvider = this.providers.get(this.fallbackOnBudget);
+            if (budgetProvider) {
+                this.emit('provider:fallback', { reason: 'budget', provider: this.fallbackOnBudget });
+                return this.executeWithTracking(budgetProvider, request);
+            }
+        }
+        // Try primary
+        const primary = this.providers.get('primary');
+        if (!primary)
+            throw new Error('No primary provider configured');
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.routing.primary.timeout ?? 30000);
+            const result = await this.executeWithTracking(primary, request);
+            clearTimeout(timeout);
+            return result;
+        }
+        catch (error) {
+            this.emit('provider:fallback', { reason: 'error', error, provider: 'primary' });
+            // Try fallback
+            const fallback = this.providers.get('fallback');
+            if (fallback) {
+                try {
+                    return await this.executeWithTracking(fallback, request);
+                }
+                catch (fallbackError) {
+                    this.emit('provider:fallback', { reason: 'error', error: fallbackError, provider: 'fallback' });
+                }
+            }
+            // Try budget
+            const budget = this.providers.get('budget');
+            if (budget) {
+                return this.executeWithTracking(budget, request);
+            }
+            // Try local
+            const local = this.providers.get('local');
+            if (local) {
+                return this.executeWithTracking(local, request);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Stream with fallback
+     */
+    async *stream(request) {
+        const primary = this.providers.get('primary');
+        if (!primary)
+            throw new Error('No primary provider configured');
+        try {
+            yield* primary.stream(request);
+        }
+        catch (error) {
+            const fallback = this.providers.get('fallback');
+            if (fallback) {
+                yield* fallback.stream(request);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Get a specific provider by name
+     */
+    getProvider(name) {
+        // Check slots first
+        if (this.providers.has(name))
+            return this.providers.get(name);
+        // Check by provider name
+        for (const provider of this.providers.values()) {
+            if (provider.providerName === name)
+                return provider;
+        }
+        return undefined;
+    }
+    /**
+     * Get a provider for a specific slot
+     */
+    getSlotProvider(slot) {
+        return this.providers.get(slot);
+    }
+    /**
+     * Get daily cost tracking
+     */
+    getDailyCost() {
+        this.resetDailyCostIfNeeded();
+        return this.dailyCost;
+    }
+    async executeWithTracking(provider, request) {
+        this.emit('provider:request', { provider: provider.providerName, model: provider.getModel() });
+        const result = await provider.complete(request);
+        this.trackCost(result.usage);
+        this.emit('provider:response', {
+            provider: provider.providerName,
+            model: result.model,
+            usage: result.usage,
+            duration: result.duration,
+        });
+        return result;
+    }
+    trackCost(usage) {
+        this.resetDailyCostIfNeeded();
+        this.dailyCost += usage.estimatedCost;
+        const percentage = (this.dailyCost / this.maxCostPerDay) * 100;
+        if (percentage >= this.warningThreshold) {
+            this.emit('budget:warning', { dailyCost: this.dailyCost, maxCost: this.maxCostPerDay, percentage });
+        }
+        if (percentage >= 100) {
+            this.emit('budget:exceeded', { dailyCost: this.dailyCost, maxCost: this.maxCostPerDay });
+        }
+    }
+    shouldUseBudgetProvider() {
+        const percentage = (this.dailyCost / this.maxCostPerDay) * 100;
+        return percentage >= this.warningThreshold && this.providers.has(this.fallbackOnBudget);
+    }
+    resetDailyCostIfNeeded() {
+        const today = new Date().toISOString().split('T')[0];
+        if (this.dailyCostDate !== today) {
+            this.dailyCost = 0;
+            this.dailyCostDate = today;
+        }
+    }
+}
+/**
+ * Factory function to create a provider instance
+ */
+export function createProvider(config) {
+    switch (config.name) {
+        case 'anthropic':
+            return new AnthropicProvider(config);
+        case 'openai':
+            return new OpenAIProvider(config);
+        case 'gemini':
+            return new GeminiProvider(config);
+        case 'groq':
+            return new GroqProvider(config);
+        case 'mistral':
+            return new MistralProvider(config);
+        case 'ollama':
+            return new OllamaProvider(config);
+        case 'deepseek':
+            return new DeepSeekProvider(config);
+        case 'openrouter':
+            return new OpenRouterProvider(config);
+        default:
+            throw new Error(`Unsupported provider: ${config.name}`);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/providers/router.js.map

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

package/dist/quality/anomaly.d.ts

@@ -0,0 +1,32 @@
+/**
+ * PhantomMindAI — Anomaly Detector
+ * Real-time monitoring of agent behavior to detect stuck loops, thrashing, etc.
+ */
+import type { AnomalyReport, AnomalyMetrics } from '../types.js';
+export declare class AnomalyDetector {
+    private actions;
+    private fileAccessCounts;
+    private tokenHistory;
+    private windowMs;
+    private maxFileAccess;
+    private maxStepsWithoutProgress;
+    private maxErrorRate;
+    private tokenSpikeMultiplier;
+    /**
+     * Record an agent action
+     */
+    recordAction(action: string, file: string | undefined, success: boolean, tokenUsage: number): void;
+    /**
+     * Check for anomalies in recent behavior
+     */
+    check(): AnomalyReport;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): AnomalyMetrics;
+    /**
+     * Reset metrics (e.g., after human intervention)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/quality/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../../src/quality/anomaly.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAUjE,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,uBAAuB,CAAM;IACrC,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,oBAAoB,CAAO;IAEnC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAiBlG;;OAEG;IACH,KAAK,IAAI,aAAa;IA4DtB;;OAEG;IACH,UAAU,IAAI,cAAc;IA6B5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/quality/anomaly.js

@@ -0,0 +1,126 @@
+/**
+ * PhantomMindAI — Anomaly Detector
+ * Real-time monitoring of agent behavior to detect stuck loops, thrashing, etc.
+ */
+export class AnomalyDetector {
+    actions = [];
+    fileAccessCounts = new Map();
+    tokenHistory = [];
+    windowMs = 60000; // 60 second window
+    // Thresholds
+    maxFileAccess = 5;
+    maxStepsWithoutProgress = 10;
+    maxErrorRate = 0.5;
+    tokenSpikeMultiplier = 3.0;
+    /**
+     * Record an agent action
+     */
+    recordAction(action, file, success, tokenUsage) {
+        const record = {
+            action,
+            file,
+            timestamp: Date.now(),
+            success,
+            tokenUsage,
+        };
+        this.actions.push(record);
+        this.tokenHistory.push(tokenUsage);
+        if (file) {
+            this.fileAccessCounts.set(file, (this.fileAccessCounts.get(file) ?? 0) + 1);
+        }
+    }
+    /**
+     * Check for anomalies in recent behavior
+     */
+    check() {
+        const metrics = this.getMetrics();
+        // Check: Same file accessed >5 times in 60s
+        const now = Date.now();
+        const recentActions = this.actions.filter(a => now - a.timestamp < this.windowMs);
+        const recentFileAccess = new Map();
+        for (const action of recentActions) {
+            if (action.file) {
+                recentFileAccess.set(action.file, (recentFileAccess.get(action.file) ?? 0) + 1);
+            }
+        }
+        for (const [file, count] of recentFileAccess) {
+            if (count > this.maxFileAccess) {
+                return {
+                    detected: true,
+                    type: 'stuck-loop',
+                    description: `File "${file}" accessed ${count} times in the last 60 seconds. Agent may be stuck in a loop.`,
+                    metrics,
+                };
+            }
+        }
+        // Check: No progress after N steps
+        if (metrics.stepsWithoutProgress > this.maxStepsWithoutProgress) {
+            return {
+                detected: true,
+                type: 'no-progress',
+                description: `No measurable progress after ${metrics.stepsWithoutProgress} steps. Agent may be stuck.`,
+                metrics,
+            };
+        }
+        // Check: High error rate
+        if (this.actions.length >= 5 && metrics.errorRate > this.maxErrorRate) {
+            return {
+                detected: true,
+                type: 'high-error-rate',
+                description: `Error rate is ${(metrics.errorRate * 100).toFixed(0)}% in the last 5 actions. Agent may be failing.`,
+                metrics,
+            };
+        }
+        // Check: Token usage spike
+        if (this.tokenHistory.length >= 3 && metrics.averageTokenUsage > 0) {
+            const lastUsage = this.tokenHistory[this.tokenHistory.length - 1];
+            if (lastUsage > metrics.averageTokenUsage * this.tokenSpikeMultiplier) {
+                return {
+                    detected: true,
+                    type: 'token-spike',
+                    description: `Token usage spike: ${lastUsage} tokens (avg: ${metrics.averageTokenUsage.toFixed(0)}). Possible runaway prompt.`,
+                    metrics,
+                };
+            }
+        }
+        return { detected: false, metrics };
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        const last5 = this.actions.slice(-5);
+        const errorRate = last5.length > 0
+            ? last5.filter(a => !a.success).length / last5.length
+            : 0;
+        const avgTokens = this.tokenHistory.length > 0
+            ? this.tokenHistory.reduce((a, b) => a + b, 0) / this.tokenHistory.length
+            : 0;
+        // Compute steps without progress (consecutive failed or no-op steps)
+        let stepsWithoutProgress = 0;
+        for (let i = this.actions.length - 1; i >= 0; i--) {
+            if (!this.actions[i].success || this.actions[i].action === 'read_file') {
+                stepsWithoutProgress++;
+            }
+            else {
+                break;
+            }
+        }
+        return {
+            fileAccessCounts: Object.fromEntries(this.fileAccessCounts),
+            stepsWithoutProgress,
+            errorRate,
+            tokenUsageHistory: this.tokenHistory.slice(-20),
+            averageTokenUsage: avgTokens,
+        };
+    }
+    /**
+     * Reset metrics (e.g., after human intervention)
+     */
+    reset() {
+        this.actions = [];
+        this.fileAccessCounts.clear();
+        this.tokenHistory = [];
+    }
+}
+//# sourceMappingURL=anomaly.js.map

package/dist/quality/anomaly.js.map

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