promptspeak-mcp-server 0.1.0

package/dist/swarm/alerts/alert-engine.js

@@ -0,0 +1,343 @@
+/**
+ * Alert Engine
+ *
+ * Analyzes observations to generate actionable alerts.
+ * Supports three trigger types (per user selection):
+ * 1. Price Anomaly - Listing significantly below market average
+ * 2. Pattern Match - Seller/listing matches saved criteria
+ * 3. Multi-Agent Consensus - Multiple agents flag same opportunity
+ */
+import { generateAlertId, DEFAULT_ALERT_CONFIG, } from '../types.js';
+import { createAlert as dbCreateAlert, getListingObservations, } from '../database.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// ALERT ENGINE CLASS
+// ═══════════════════════════════════════════════════════════════════════════════
+export class AlertEngine {
+    config;
+    recentAlerts = new Map(); // listingId -> alertId (dedup)
+    constructor(config) {
+        this.config = { ...DEFAULT_ALERT_CONFIG, ...config };
+    }
+    /**
+     * Process an observation and generate alerts if conditions are met.
+     */
+    async processObservation(observation) {
+        const alerts = [];
+        // Check for price anomaly
+        const priceAnomalyAlert = this.checkPriceAnomaly(observation);
+        if (priceAnomalyAlert) {
+            alerts.push(priceAnomalyAlert);
+        }
+        // Check pattern matches
+        const patternMatchAlert = this.checkPatternMatch(observation);
+        if (patternMatchAlert) {
+            alerts.push(patternMatchAlert);
+        }
+        // Check multi-agent consensus
+        const consensusAlert = await this.checkMultiAgentConsensus(observation);
+        if (consensusAlert) {
+            alerts.push(consensusAlert);
+        }
+        // Store and deduplicate alerts
+        for (const alert of alerts) {
+            // Skip if we already have an alert for this listing (dedup)
+            if (this.recentAlerts.has(alert.listingId)) {
+                continue;
+            }
+            // Store in database
+            dbCreateAlert(alert);
+            this.recentAlerts.set(alert.listingId, alert.alertId);
+        }
+        return alerts;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRICE ANOMALY DETECTION
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Check if observation indicates a price anomaly.
+     *
+     * A price anomaly occurs when:
+     * - Current price is X% below market average
+     * - Listing is marked as UNDERPRICED
+     * - Confidence score meets threshold
+     */
+    checkPriceAnomaly(observation) {
+        // Only check for actionable observations
+        if (!['BID', 'OFFER'].includes(observation.recommendedAction)) {
+            return null;
+        }
+        // Must have discount info or be marked underpriced
+        const hasDiscount = observation.discountPercent !== undefined &&
+            observation.discountPercent >= this.config.priceAnomalyThreshold;
+        const isUnderpriced = observation.marketCondition === 'UNDERPRICED' &&
+            observation.confidenceScore >= this.config.confidenceThreshold;
+        if (!hasDiscount && !isUnderpriced) {
+            return null;
+        }
+        const severity = this.calculatePriceAnomalySeverity(observation);
+        const now = new Date().toISOString();
+        return {
+            alertId: generateAlertId(),
+            alertType: 'PRICE_ANOMALY',
+            severity,
+            swarmId: observation.swarmId,
+            triggerObservationIds: [observation.observationId],
+            listingId: observation.listingId ?? '',
+            recommendedAction: observation.recommendedAction,
+            recommendedAmount: observation.recommendedAmount,
+            estimatedValue: this.estimateOpportunityValue(observation),
+            confidence: observation.confidenceScore,
+            summary: this.generatePriceAnomalySummary(observation),
+            requiresApproval: true,
+            approvalDeadline: this.calculateDeadline(observation),
+            status: 'PENDING',
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    calculatePriceAnomalySeverity(obs) {
+        const discount = obs.discountPercent ?? 0;
+        const confidence = obs.confidenceScore;
+        if (discount >= 30 && confidence >= 0.9)
+            return 'CRITICAL';
+        if (discount >= 20 && confidence >= 0.8)
+            return 'HIGH';
+        if (discount >= 15 && confidence >= 0.7)
+            return 'MEDIUM';
+        return 'LOW';
+    }
+    generatePriceAnomalySummary(obs) {
+        const discount = obs.discountPercent ?? 0;
+        return `${obs.itemTitle?.substring(0, 50) || 'Item'} is ${discount.toFixed(0)}% below market. ` +
+            `Current: $${obs.currentPrice.toFixed(2)} | ` +
+            `Recommend: ${obs.recommendedAction} @ $${obs.recommendedAmount?.toFixed(2) ?? 'N/A'}`;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PATTERN MATCHING
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Check if observation matches any saved pattern rules.
+     */
+    checkPatternMatch(observation) {
+        const rules = this.config.patternMatchRules.filter(r => r.enabled);
+        for (const rule of rules) {
+            if (this.matchesRule(observation, rule)) {
+                const now = new Date().toISOString();
+                return {
+                    alertId: generateAlertId(),
+                    alertType: 'PATTERN_MATCH',
+                    severity: this.rulePriorityToSeverity(rule.priority),
+                    swarmId: observation.swarmId,
+                    triggerObservationIds: [observation.observationId],
+                    listingId: observation.listingId ?? '',
+                    recommendedAction: observation.recommendedAction,
+                    recommendedAmount: observation.recommendedAmount,
+                    estimatedValue: this.estimateOpportunityValue(observation),
+                    confidence: observation.confidenceScore,
+                    summary: `Matched rule "${rule.name}": ${rule.description || observation.reasoning}`,
+                    requiresApproval: rule.action !== 'LOG_ONLY',
+                    approvalDeadline: this.calculateDeadline(observation),
+                    status: 'PENDING',
+                    createdAt: now,
+                    updatedAt: now,
+                };
+            }
+        }
+        return null;
+    }
+    matchesRule(obs, rule) {
+        const conditions = rule.conditions;
+        // Check discount threshold
+        if (conditions.minDiscountPercent !== undefined) {
+            if ((obs.discountPercent ?? 0) < conditions.minDiscountPercent) {
+                return false;
+            }
+        }
+        // Check confidence
+        if (conditions.minConfidence !== undefined) {
+            if (obs.confidenceScore < conditions.minConfidence) {
+                return false;
+            }
+        }
+        // Check title keywords
+        if (conditions.titleKeywords?.length) {
+            const title = obs.itemTitle?.toLowerCase() ?? '';
+            const hasKeyword = conditions.titleKeywords.some(kw => title.includes(kw.toLowerCase()));
+            if (!hasKeyword)
+                return false;
+        }
+        // Check time remaining
+        if (conditions.maxTimeRemaining !== undefined) {
+            const hoursRemaining = (obs.timeRemaining ?? Infinity) / 3600;
+            if (hoursRemaining > conditions.maxTimeRemaining) {
+                return false;
+            }
+        }
+        // Check listing formats
+        if (conditions.listingFormats?.length) {
+            const metadata = obs.metadata;
+            const isAuction = metadata?.isAuction;
+            const hasBestOffer = metadata?.hasBestOffer;
+            const matchesFormat = conditions.listingFormats.some(format => {
+                if (format === 'AUCTION' && isAuction)
+                    return true;
+                if (format === 'BEST_OFFER' && hasBestOffer)
+                    return true;
+                if (format === 'FIXED_PRICE' && !isAuction)
+                    return true;
+                return false;
+            });
+            if (!matchesFormat)
+                return false;
+        }
+        return true;
+    }
+    rulePriorityToSeverity(priority) {
+        if (priority >= 8)
+            return 'CRITICAL';
+        if (priority >= 6)
+            return 'HIGH';
+        if (priority >= 4)
+            return 'MEDIUM';
+        return 'LOW';
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // MULTI-AGENT CONSENSUS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Check if multiple agents have flagged the same listing.
+     *
+     * Consensus is reached when:
+     * - N agents (configurable) recommend action on same listing
+     * - Average confidence meets threshold
+     */
+    async checkMultiAgentConsensus(observation) {
+        if (!observation.listingId)
+            return null;
+        // Get all observations for this listing
+        const listingObs = getListingObservations(observation.listingId);
+        // Filter to actionable recommendations
+        const actionableObs = listingObs.filter(obs => ['BID', 'OFFER'].includes(obs.recommendedAction));
+        // Get unique agents
+        const uniqueAgents = new Set(actionableObs.map(obs => obs.agentId));
+        // Check if we have enough agents
+        if (uniqueAgents.size < this.config.minAgentsForConsensus) {
+            return null;
+        }
+        // Calculate average confidence
+        const avgConfidence = actionableObs.reduce((sum, obs) => sum + obs.confidenceScore, 0)
+            / actionableObs.length;
+        if (avgConfidence < this.config.confidenceThreshold) {
+            return null;
+        }
+        // Determine consensus action (most common recommendation)
+        const actionCounts = new Map();
+        for (const obs of actionableObs) {
+            const count = actionCounts.get(obs.recommendedAction) ?? 0;
+            actionCounts.set(obs.recommendedAction, count + 1);
+        }
+        let consensusAction = 'WATCH';
+        let maxCount = 0;
+        for (const [action, count] of actionCounts) {
+            if (count > maxCount) {
+                maxCount = count;
+                consensusAction = action;
+            }
+        }
+        // Calculate consensus amount (average of recommendations)
+        const amounts = actionableObs
+            .filter(obs => obs.recommendedAmount !== undefined)
+            .map(obs => obs.recommendedAmount);
+        const consensusAmount = amounts.length > 0
+            ? amounts.reduce((sum, a) => sum + a, 0) / amounts.length
+            : undefined;
+        const now = new Date().toISOString();
+        return {
+            alertId: generateAlertId(),
+            alertType: 'MULTI_AGENT_CONSENSUS',
+            severity: this.calculateConsensusSeverity(uniqueAgents.size, avgConfidence),
+            swarmId: observation.swarmId,
+            triggerObservationIds: actionableObs.map(obs => obs.observationId),
+            listingId: observation.listingId,
+            recommendedAction: consensusAction,
+            recommendedAmount: consensusAmount,
+            estimatedValue: this.estimateOpportunityValue(observation),
+            confidence: avgConfidence,
+            summary: `${uniqueAgents.size} agents agree: ${consensusAction} @ $${consensusAmount?.toFixed(2) ?? 'N/A'} ` +
+                `(${(avgConfidence * 100).toFixed(0)}% avg confidence)`,
+            requiresApproval: true,
+            approvalDeadline: this.calculateDeadline(observation),
+            status: 'PENDING',
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    calculateConsensusSeverity(agentCount, avgConfidence) {
+        // More agents + higher confidence = higher severity
+        const score = agentCount * avgConfidence;
+        if (score >= 4.5)
+            return 'CRITICAL';
+        if (score >= 3.5)
+            return 'HIGH';
+        if (score >= 2.5)
+            return 'MEDIUM';
+        return 'LOW';
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // UTILITY METHODS
+    // ═══════════════════════════════════════════════════════════════════════════
+    estimateOpportunityValue(obs) {
+        // Estimate potential savings
+        const currentPrice = obs.currentPrice;
+        const marketAvg = obs.marketAverage ?? currentPrice;
+        const discount = obs.discountPercent ?? 0;
+        // Value = potential savings + confidence bonus
+        return (marketAvg - currentPrice) + (currentPrice * discount / 100 * obs.confidenceScore);
+    }
+    calculateDeadline(obs) {
+        // If auction has time remaining, use that
+        if (obs.timeRemaining && obs.timeRemaining > 0) {
+            const deadline = new Date(Date.now() + obs.timeRemaining * 1000);
+            return deadline.toISOString();
+        }
+        // Otherwise, use config default
+        const hours = this.config.alertExpiryHours;
+        const deadline = new Date(Date.now() + hours * 60 * 60 * 1000);
+        return deadline.toISOString();
+    }
+    /**
+     * Update configuration.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Clear recent alerts cache (for testing or manual reset).
+     */
+    clearCache() {
+        this.recentAlerts.clear();
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// SINGLETON INSTANCE
+// ═══════════════════════════════════════════════════════════════════════════════
+let engineInstance = null;
+/**
+ * Get the alert engine singleton.
+ */
+export function getAlertEngine(config) {
+    if (!engineInstance) {
+        engineInstance = new AlertEngine(config);
+    }
+    else if (config) {
+        engineInstance.updateConfig(config);
+    }
+    return engineInstance;
+}
+/**
+ * Create a fresh alert engine (for testing).
+ */
+export function createAlertEngine(config) {
+    return new AlertEngine(config);
+}
+//# sourceMappingURL=alert-engine.js.map

package/dist/swarm/alerts/alert-engine.js.map

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

package/dist/swarm/alerts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Alert System Module
+ *
+ * Exports alert engine and related functionality.
+ */
+export { AlertEngine, getAlertEngine, createAlertEngine, } from './alert-engine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/swarm/alerts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/swarm/alerts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/swarm/alerts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Alert System Module
+ *
+ * Exports alert engine and related functionality.
+ */
+export { AlertEngine, getAlertEngine, createAlertEngine, } from './alert-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/swarm/alerts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/swarm/alerts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/swarm/budget-allocator.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Budget Allocator
+ *
+ * Manages budget distribution across swarm agents.
+ * Enforces hard limits and provides reallocation capabilities.
+ *
+ * Key principles:
+ * - Total allocations never exceed swarm budget
+ * - Fee reserve maintained for eBay fees
+ * - Agents cannot exceed their individual allocation
+ * - Supports dynamic reallocation based on performance
+ */
+import type { Money, MonetaryBudget, SwarmConfig, BiddingStrategy } from './types.js';
+/**
+ * Budget allocation for a single agent.
+ * Uses Money (value + currency) for tracking actual amounts.
+ */
+export interface AgentAllocation {
+    agentId: string;
+    allocated: Money;
+    spent: Money;
+    reserved: Money;
+    available: Money;
+}
+/**
+ * Overall budget status for the swarm.
+ * Uses Money for tracking amounts, MonetaryBudget for config.
+ */
+export interface SwarmBudgetStatus {
+    total: Money;
+    allocated: Money;
+    spent: Money;
+    reserved: Money;
+    available: Money;
+    feeReserve: Money;
+    agentAllocations: AgentAllocation[];
+}
+/**
+ * Allocation strategy options.
+ */
+export type AllocationStrategy = 'EQUAL' | 'WEIGHTED' | 'PERFORMANCE' | 'CUSTOM';
+/**
+ * Allocation request.
+ */
+export interface AllocationRequest {
+    agentId: string;
+    strategy: BiddingStrategy;
+    requestedAmount?: number;
+    priority?: number;
+}
+/**
+ * Reallocation result.
+ */
+export interface ReallocationResult {
+    success: boolean;
+    fromAgentId: string;
+    toAgentId: string;
+    amount: number;
+    newFromAllocation: number;
+    newToAllocation: number;
+    error?: string;
+}
+export declare class BudgetAllocator {
+    private totalBudget;
+    private budgetConfig;
+    private feeReservePercent;
+    private allocations;
+    private currency;
+    constructor(config: SwarmConfig);
+    /**
+     * Initialize allocations for a set of agents.
+     */
+    initializeAllocations(requests: AllocationRequest[], strategy?: AllocationStrategy): AgentAllocation[];
+    /**
+     * Calculate equal allocations.
+     */
+    private calculateEqualAllocations;
+    /**
+     * Calculate weighted allocations based on strategy type.
+     */
+    private calculateWeightedAllocations;
+    /**
+     * Calculate custom allocations from requested amounts.
+     */
+    private calculateCustomAllocations;
+    /**
+     * Check if an agent can make a purchase.
+     */
+    canAfford(agentId: string, amount: number): boolean;
+    /**
+     * Reserve funds for a pending bid/offer.
+     */
+    reserveFunds(agentId: string, amount: number): boolean;
+    /**
+     * Release reserved funds (bid lost or offer declined).
+     */
+    releaseFunds(agentId: string, amount: number): boolean;
+    /**
+     * Record a completed purchase.
+     */
+    recordPurchase(agentId: string, amount: number, wasReserved?: boolean): boolean;
+    /**
+     * Reallocate funds from one agent to another.
+     */
+    reallocate(fromAgentId: string, toAgentId: string, amount: number): ReallocationResult;
+    /**
+     * Get allocation for a specific agent.
+     */
+    getAllocation(agentId: string): AgentAllocation | undefined;
+    /**
+     * Get overall swarm budget status.
+     */
+    getSwarmStatus(): SwarmBudgetStatus;
+    /**
+     * Get agents sorted by available budget (for reallocation candidates).
+     */
+    getAgentsByAvailable(ascending?: boolean): AgentAllocation[];
+    /**
+     * Get agents sorted by spent (for performance analysis).
+     */
+    getAgentsBySpent(ascending?: boolean): AgentAllocation[];
+    /**
+     * Get agent efficiency (spent / allocated ratio).
+     */
+    getAgentEfficiency(agentId: string): number;
+    /**
+     * Automatically reallocate from underperforming to high-performing agents.
+     *
+     * @param performanceScores Map of agentId -> performance score (0-1)
+     * @param threshold Minimum performance to keep full allocation
+     * @param maxReallocationPercent Maximum % of budget to reallocate at once
+     */
+    performanceBasedReallocation(performanceScores: Map<string, number>, threshold?: number, maxReallocationPercent?: number): ReallocationResult[];
+    /**
+     * Export state for persistence.
+     */
+    exportState(): {
+        totalBudget: Money;
+        budgetConfig: MonetaryBudget;
+        feeReservePercent: number;
+        allocations: AgentAllocation[];
+    };
+    /**
+     * Import state from persistence.
+     */
+    importState(state: {
+        totalBudget: Money;
+        budgetConfig?: MonetaryBudget;
+        feeReservePercent: number;
+        allocations: AgentAllocation[];
+    }): void;
+}
+//# sourceMappingURL=budget-allocator.d.ts.map

package/dist/swarm/budget-allocator.d.ts.map

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