promptspeak-mcp-server 0.1.0

package/dist/drift/baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../src/drift/baseline.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrE,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,cAAc,CAAuD;IAE7E;;OAEG;IACH,cAAc,CACZ,KAAK,EAAE,WAAW,EAClB,sBAAsB,EAAE,MAAM,EAC9B,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE,MAAiB,GACzB,cAAc;IAuBjB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiB,GAAG,cAAc,GAAG,SAAS;IAKlF;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiB,GAAG,OAAO;IAI/D;;OAEG;IACH,iBAAiB,CACf,KAAK,EAAE,WAAW,EAClB,qBAAqB,EAAE,MAAM,EAC7B,eAAe,EAAE,MAAM,EAAE,EACzB,OAAO,GAAE,MAAiB,GACzB;QACD,WAAW,EAAE,OAAO,CAAC;QACrB,mBAAmB,EAAE,OAAO,CAAC;QAC7B,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB;IAkDD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAKpD;;OAEG;IACH,eAAe,IAAI,cAAc,EAAE;IAInC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiB,GAAG,OAAO;IAYlE;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU1C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,MAAM,IAAI;QAAE,SAAS,EAAE,cAAc,EAAE,CAAA;KAAE;IAMzC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,cAAc,EAAE,CAAA;KAAE,GAAG,IAAI;IAgBnD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,iBAAiB;CAU1B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/drift/baseline.js

@@ -0,0 +1,179 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK MCP SERVER - BASELINE STORE
+// ═══════════════════════════════════════════════════════════════════════════
+// Stores and manages baseline records for drift detection.
+// Baselines capture the expected behavior at deployment time.
+// ═══════════════════════════════════════════════════════════════════════════
+import { generateFrameEmbedding, calculateDriftScore } from '../utils/embeddings.js';
+import { generateBehaviorHash } from '../utils/hash.js';
+export class BaselineStore {
+    baselines = new Map();
+    agentBaselines = new Map();
+    /**
+     * Record a baseline for a frame.
+     */
+    recordBaseline(frame, expectedInterpretation, expectedBehavior, agentId = 'global') {
+        const record = {
+            frame: frame.raw,
+            expectedInterpretation,
+            expectedBehaviorHash: generateBehaviorHash(expectedBehavior),
+            embedding: generateFrameEmbedding(frame),
+            recordedAt: Date.now(),
+            agentId,
+        };
+        // Store globally
+        const key = this.createKey(frame.raw, agentId);
+        this.baselines.set(key, record);
+        // Store per-agent
+        if (!this.agentBaselines.has(agentId)) {
+            this.agentBaselines.set(agentId, new Map());
+        }
+        this.agentBaselines.get(agentId).set(frame.raw, record);
+        return record;
+    }
+    /**
+     * Get a baseline for a frame.
+     */
+    getBaseline(frame, agentId = 'global') {
+        const key = this.createKey(frame, agentId);
+        return this.baselines.get(key) || this.baselines.get(this.createKey(frame, 'global'));
+    }
+    /**
+     * Check if a baseline exists.
+     */
+    hasBaseline(frame, agentId = 'global') {
+        return this.getBaseline(frame, agentId) !== undefined;
+    }
+    /**
+     * Compare current frame interpretation against baseline.
+     */
+    compareToBaseline(frame, currentInterpretation, currentBehavior, agentId = 'global') {
+        const baseline = this.getBaseline(frame.raw, agentId);
+        if (!baseline) {
+            return {
+                hasBaseline: false,
+                interpretationMatch: false,
+                behaviorMatch: false,
+                embeddingDistance: 0,
+                driftScore: 0,
+                details: 'No baseline found',
+            };
+        }
+        // Compare interpretation
+        const interpretationMatch = this.normalizeInterpretation(currentInterpretation) ===
+            this.normalizeInterpretation(baseline.expectedInterpretation);
+        // Compare behavior hash
+        const currentBehaviorHash = generateBehaviorHash(currentBehavior);
+        const behaviorMatch = currentBehaviorHash === baseline.expectedBehaviorHash;
+        // Compare embeddings
+        const currentEmbedding = generateFrameEmbedding(frame);
+        const driftScore = calculateDriftScore(baseline.embedding, currentEmbedding);
+        // Calculate embedding distance
+        const embeddingDistance = this.euclideanDistance(baseline.embedding, currentEmbedding);
+        const details = [];
+        if (!interpretationMatch) {
+            details.push(`Interpretation changed from "${baseline.expectedInterpretation}" to "${currentInterpretation}"`);
+        }
+        if (!behaviorMatch) {
+            details.push('Behavior hash mismatch');
+        }
+        if (driftScore > 0.1) {
+            details.push(`Embedding drift: ${(driftScore * 100).toFixed(1)}%`);
+        }
+        return {
+            hasBaseline: true,
+            interpretationMatch,
+            behaviorMatch,
+            embeddingDistance,
+            driftScore,
+            details: details.length > 0 ? details.join('; ') : 'Matches baseline',
+        };
+    }
+    /**
+     * Get all baselines for an agent.
+     */
+    getAgentBaselines(agentId) {
+        const agentMap = this.agentBaselines.get(agentId);
+        return agentMap ? Array.from(agentMap.values()) : [];
+    }
+    /**
+     * Get all global baselines.
+     */
+    getAllBaselines() {
+        return Array.from(this.baselines.values());
+    }
+    /**
+     * Delete a baseline.
+     */
+    deleteBaseline(frame, agentId = 'global') {
+        const key = this.createKey(frame, agentId);
+        const deleted = this.baselines.delete(key);
+        const agentMap = this.agentBaselines.get(agentId);
+        if (agentMap) {
+            agentMap.delete(frame);
+        }
+        return deleted;
+    }
+    /**
+     * Clear all baselines for an agent.
+     */
+    clearAgentBaselines(agentId) {
+        const agentMap = this.agentBaselines.get(agentId);
+        if (agentMap) {
+            for (const frame of agentMap.keys()) {
+                this.baselines.delete(this.createKey(frame, agentId));
+            }
+            agentMap.clear();
+        }
+    }
+    /**
+     * Clear all baselines.
+     */
+    clearAll() {
+        this.baselines.clear();
+        this.agentBaselines.clear();
+    }
+    /**
+     * Export baselines for persistence.
+     */
+    export() {
+        return {
+            baselines: Array.from(this.baselines.values()),
+        };
+    }
+    /**
+     * Import baselines from persistence.
+     */
+    import(data) {
+        for (const record of data.baselines) {
+            const key = this.createKey(record.frame, record.agentId);
+            this.baselines.set(key, record);
+            if (!this.agentBaselines.has(record.agentId)) {
+                this.agentBaselines.set(record.agentId, new Map());
+            }
+            this.agentBaselines.get(record.agentId).set(record.frame, record);
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // PRIVATE HELPERS
+    // ─────────────────────────────────────────────────────────────────────────
+    createKey(frame, agentId) {
+        return `${agentId}:${frame}`;
+    }
+    normalizeInterpretation(interpretation) {
+        return interpretation.toLowerCase().trim().replace(/\s+/g, ' ');
+    }
+    euclideanDistance(a, b) {
+        if (a.length !== b.length)
+            return Infinity;
+        let sum = 0;
+        for (let i = 0; i < a.length; i++) {
+            const diff = a[i] - b[i];
+            sum += diff * diff;
+        }
+        return Math.sqrt(sum);
+    }
+}
+// Singleton instance
+export const baselineStore = new BaselineStore();
+//# sourceMappingURL=baseline.js.map

package/dist/drift/baseline.js.map

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

package/dist/drift/circuit-breaker.d.ts

@@ -0,0 +1,91 @@
+import type { CircuitBreakerState, DriftAlert } from '../types/index.js';
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    successThreshold: number;
+    timeout: number;
+    driftScoreThreshold: number;
+}
+export declare class CircuitBreaker {
+    private states;
+    private config;
+    private alerts;
+    private enabled;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Enable or disable the circuit breaker.
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Update configuration.
+     */
+    setConfig(config: Partial<CircuitBreakerConfig>): void;
+    /**
+     * Get the current state for an agent.
+     */
+    getState(agentId: string): CircuitBreakerState;
+    /**
+     * Check if an agent is allowed to execute.
+     */
+    isAllowed(agentId: string): boolean;
+    /**
+     * Record a successful operation.
+     */
+    recordSuccess(agentId: string): void;
+    /**
+     * Record a failure.
+     */
+    recordFailure(agentId: string, reason: string): void;
+    /**
+     * Record drift detection.
+     */
+    recordDrift(agentId: string, driftScore: number, details: string): void;
+    /**
+     * Manually open the circuit for an agent.
+     */
+    openCircuit(agentId: string, reason: string): void;
+    /**
+     * Manually close the circuit for an agent.
+     */
+    closeCircuit(agentId: string): void;
+    /**
+     * Manually set to half-open for testing.
+     */
+    halfOpenCircuit(agentId: string): void;
+    /**
+     * Get all agents with open circuits.
+     */
+    getOpenCircuits(): CircuitBreakerState[];
+    /**
+     * Get all circuit states.
+     */
+    getAllStates(): CircuitBreakerState[];
+    /**
+     * Get alerts.
+     */
+    getAlerts(limit?: number): DriftAlert[];
+    /**
+     * Get alerts for an agent.
+     */
+    getAgentAlerts(agentId: string, limit?: number): DriftAlert[];
+    /**
+     * Clear an agent's state.
+     */
+    clearAgent(agentId: string): void;
+    /**
+     * Clear all states.
+     */
+    clearAll(): void;
+    /**
+     * Get circuit breaker statistics.
+     */
+    getStats(): {
+        totalAgents: number;
+        closedCircuits: number;
+        openCircuits: number;
+        halfOpenCircuits: number;
+        totalAlerts: number;
+        criticalAlerts: number;
+    };
+}
+export declare const circuitBreaker: CircuitBreaker;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/drift/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/drift/circuit-breaker.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGzE,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAIlD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAItD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB;IAY9C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IA2BnC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA8BpC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA0BpD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAuBvE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQlD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUnC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMtC;;OAEG;IACH,eAAe,IAAI,mBAAmB,EAAE;IAIxC;;OAEG;IACH,YAAY,IAAI,mBAAmB,EAAE;IAIrC;;OAEG;IACH,SAAS,CAAC,KAAK,GAAE,MAAY,GAAG,UAAU,EAAE;IAI5C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,UAAU,EAAE;IAMlE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB;CAYF;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/drift/circuit-breaker.js

@@ -0,0 +1,237 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK MCP SERVER - CIRCUIT BREAKER
+// ═══════════════════════════════════════════════════════════════════════════
+// The Circuit Breaker halts agents when drift thresholds are exceeded.
+// Implements three states: closed (normal), open (blocked), half-open (testing).
+// ═══════════════════════════════════════════════════════════════════════════
+import { generateAlertId } from '../utils/hash.js';
+const DEFAULT_CONFIG = {
+    failureThreshold: 5,
+    successThreshold: 3,
+    timeout: 60000, // 1 minute
+    driftScoreThreshold: 0.25,
+};
+export class CircuitBreaker {
+    states = new Map();
+    config;
+    alerts = [];
+    enabled = true;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Enable or disable the circuit breaker.
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Update configuration.
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get the current state for an agent.
+     */
+    getState(agentId) {
+        if (!this.states.has(agentId)) {
+            this.states.set(agentId, {
+                agentId,
+                state: 'closed',
+                failureCount: 0,
+                successCount: 0,
+            });
+        }
+        return this.states.get(agentId);
+    }
+    /**
+     * Check if an agent is allowed to execute.
+     */
+    isAllowed(agentId) {
+        if (!this.enabled)
+            return true;
+        const state = this.getState(agentId);
+        switch (state.state) {
+            case 'closed':
+                return true;
+            case 'open':
+                // Check if timeout has passed
+                if (state.openedAt && Date.now() - state.openedAt > this.config.timeout) {
+                    // Move to half-open
+                    state.state = 'half-open';
+                    state.successCount = 0;
+                    return true;
+                }
+                return false;
+            case 'half-open':
+                return true;
+            default:
+                return true;
+        }
+    }
+    /**
+     * Record a successful operation.
+     */
+    recordSuccess(agentId) {
+        if (!this.enabled)
+            return;
+        const state = this.getState(agentId);
+        switch (state.state) {
+            case 'closed':
+                // Reset failure count on success
+                state.failureCount = 0;
+                state.successCount++;
+                break;
+            case 'half-open':
+                state.successCount++;
+                if (state.successCount >= this.config.successThreshold) {
+                    // Close the circuit
+                    state.state = 'closed';
+                    state.failureCount = 0;
+                    state.openedAt = undefined;
+                    state.lastFailure = undefined;
+                    state.reason = undefined;
+                }
+                break;
+            case 'open':
+                // Ignore successes when open (shouldn't happen)
+                break;
+        }
+    }
+    /**
+     * Record a failure.
+     */
+    recordFailure(agentId, reason) {
+        if (!this.enabled)
+            return;
+        const state = this.getState(agentId);
+        state.failureCount++;
+        state.lastFailure = reason;
+        switch (state.state) {
+            case 'closed':
+                if (state.failureCount >= this.config.failureThreshold) {
+                    this.openCircuit(agentId, reason);
+                }
+                break;
+            case 'half-open':
+                // Any failure in half-open opens the circuit again
+                this.openCircuit(agentId, reason);
+                break;
+            case 'open':
+                // Already open, update timestamp
+                state.openedAt = Date.now();
+                break;
+        }
+    }
+    /**
+     * Record drift detection.
+     */
+    recordDrift(agentId, driftScore, details) {
+        if (!this.enabled)
+            return;
+        if (driftScore >= this.config.driftScoreThreshold) {
+            this.openCircuit(agentId, `Drift threshold exceeded: ${(driftScore * 100).toFixed(1)}% - ${details}`);
+            // Create alert
+            this.alerts.push({
+                alertId: generateAlertId(),
+                agentId,
+                type: 'semantic_erosion',
+                severity: driftScore > 0.5 ? 'critical' : driftScore > 0.35 ? 'high' : 'medium',
+                message: `Drift score ${(driftScore * 100).toFixed(1)}% exceeds threshold ${(this.config.driftScoreThreshold * 100).toFixed(1)}%`,
+                detectedAt: Date.now(),
+                evidence: {
+                    driftScore,
+                    threshold: this.config.driftScoreThreshold,
+                    details,
+                },
+            });
+        }
+    }
+    /**
+     * Manually open the circuit for an agent.
+     */
+    openCircuit(agentId, reason) {
+        const state = this.getState(agentId);
+        state.state = 'open';
+        state.openedAt = Date.now();
+        state.reason = reason;
+        state.successCount = 0;
+    }
+    /**
+     * Manually close the circuit for an agent.
+     */
+    closeCircuit(agentId) {
+        const state = this.getState(agentId);
+        state.state = 'closed';
+        state.failureCount = 0;
+        state.successCount = 0;
+        state.openedAt = undefined;
+        state.lastFailure = undefined;
+        state.reason = undefined;
+    }
+    /**
+     * Manually set to half-open for testing.
+     */
+    halfOpenCircuit(agentId) {
+        const state = this.getState(agentId);
+        state.state = 'half-open';
+        state.successCount = 0;
+    }
+    /**
+     * Get all agents with open circuits.
+     */
+    getOpenCircuits() {
+        return Array.from(this.states.values()).filter(s => s.state === 'open');
+    }
+    /**
+     * Get all circuit states.
+     */
+    getAllStates() {
+        return Array.from(this.states.values());
+    }
+    /**
+     * Get alerts.
+     */
+    getAlerts(limit = 100) {
+        return this.alerts.slice(-limit);
+    }
+    /**
+     * Get alerts for an agent.
+     */
+    getAgentAlerts(agentId, limit = 100) {
+        return this.alerts
+            .filter(a => a.agentId === agentId)
+            .slice(-limit);
+    }
+    /**
+     * Clear an agent's state.
+     */
+    clearAgent(agentId) {
+        this.states.delete(agentId);
+    }
+    /**
+     * Clear all states.
+     */
+    clearAll() {
+        this.states.clear();
+        this.alerts = [];
+    }
+    /**
+     * Get circuit breaker statistics.
+     */
+    getStats() {
+        const states = Array.from(this.states.values());
+        return {
+            totalAgents: states.length,
+            closedCircuits: states.filter(s => s.state === 'closed').length,
+            openCircuits: states.filter(s => s.state === 'open').length,
+            halfOpenCircuits: states.filter(s => s.state === 'half-open').length,
+            totalAlerts: this.alerts.length,
+            criticalAlerts: this.alerts.filter(a => a.severity === 'critical').length,
+        };
+    }
+}
+// Singleton instance
+export const circuitBreaker = new CircuitBreaker();
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/drift/circuit-breaker.js.map

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