promptspeak-mcp-server 0.1.0

package/dist/swarm/strategies/types.js

@@ -0,0 +1,251 @@
+/**
+ * Bidding Strategy Types and Interface
+ *
+ * Defines the contract for all bidding strategies in the swarm.
+ * Each strategy encapsulates decision-making logic for different market conditions.
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// BASE STRATEGY CLASS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Abstract base class with common strategy logic.
+ */
+export class BaseStrategy {
+    config = {};
+    constructor(config) {
+        if (config) {
+            this.config = { ...config };
+        }
+    }
+    /**
+     * Default bid calculation: bid up to remaining budget or listing price.
+     */
+    calculateBidAmount(context) {
+        const { listing, remainingBudget, marketContext } = context;
+        // Don't bid more than we have
+        const maxBid = remainingBudget.value;
+        // Use market context if available
+        if (marketContext) {
+            const fairValue = marketContext.averagePrice;
+            const maxPremium = this.config.maxPremiumPercent ?? 20;
+            const maxFairBid = fairValue * (1 + maxPremium / 100);
+            return Math.min(maxBid, maxFairBid);
+        }
+        // Fall back to listing price with buffer
+        const currentPrice = listing.currentPrice;
+        return Math.min(maxBid, currentPrice * 1.1);
+    }
+    /**
+     * Default offer calculation: percentage of asking price.
+     */
+    calculateOfferAmount(context) {
+        const { listing, remainingBudget } = context;
+        const askingPrice = listing.buyItNowPrice ?? listing.currentPrice;
+        const offerPercent = this.config.initialOfferPercent ?? 70;
+        const calculatedOffer = askingPrice * (offerPercent / 100);
+        return Math.min(remainingBudget.value, calculatedOffer);
+    }
+    /**
+     * Check if listing meets agent's target criteria.
+     */
+    meetsListingCriteria(listing, config) {
+        const { targetCriteria } = config;
+        // Check price range
+        if (targetCriteria.maxPrice !== undefined && listing.currentPrice > targetCriteria.maxPrice) {
+            return false;
+        }
+        if (targetCriteria.minPrice !== undefined && listing.currentPrice < targetCriteria.minPrice) {
+            return false;
+        }
+        // Check condition
+        if (targetCriteria.conditions?.length) {
+            const normalizedCondition = listing.condition?.toLowerCase() ?? '';
+            const matchesCondition = targetCriteria.conditions.some(c => normalizedCondition.includes(c.toLowerCase()));
+            if (!matchesCondition) {
+                return false;
+            }
+        }
+        // Check excluded sellers
+        if (targetCriteria.excludeSellers?.includes(listing.sellerId)) {
+            return false;
+        }
+        // Check preferred sellers (if specified, must match)
+        if (targetCriteria.preferredSellers?.length) {
+            if (!targetCriteria.preferredSellers.includes(listing.sellerId)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Update configuration.
+     */
+    configure(config) {
+        this.config = { ...this.config, ...config };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // HELPER METHODS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Calculate time remaining until auction end.
+     */
+    getTimeRemainingMs(listing, currentTime) {
+        if (!listing.auctionEndTime) {
+            return Infinity;
+        }
+        return new Date(listing.auctionEndTime).getTime() - currentTime.getTime();
+    }
+    /**
+     * Check if within snipe window.
+     */
+    isInSnipeWindow(listing, currentTime) {
+        const snipeSeconds = this.config.snipeWindowSeconds ?? 10;
+        const remainingMs = this.getTimeRemainingMs(listing, currentTime);
+        return remainingMs > 0 && remainingMs <= snipeSeconds * 1000;
+    }
+    /**
+     * Calculate value score for a listing (0-1).
+     * Higher score = better value.
+     */
+    calculateValueScore(listing, marketContext) {
+        if (!marketContext) {
+            return 0.5; // Unknown value
+        }
+        const currentPrice = listing.currentPrice;
+        const avgPrice = marketContext.averagePrice;
+        if (currentPrice >= avgPrice) {
+            // At or above average - score decreases
+            const premium = (currentPrice - avgPrice) / avgPrice;
+            return Math.max(0, 0.5 - premium);
+        }
+        else {
+            // Below average - score increases
+            const discount = (avgPrice - currentPrice) / avgPrice;
+            return Math.min(1, 0.5 + discount);
+        }
+    }
+    /**
+     * Check if price represents good value.
+     */
+    isGoodValue(listing, marketContext) {
+        return this.calculateValueScore(listing, marketContext) >= 0.6;
+    }
+    /**
+     * Create a skip decision with reasoning.
+     */
+    skipDecision(reason) {
+        return {
+            action: 'SKIP',
+            confidence: 0.9,
+            reasoning: reason,
+        };
+    }
+    /**
+     * Create a watch decision with reasoning.
+     */
+    watchDecision(reason) {
+        return {
+            action: 'WATCH',
+            confidence: 0.7,
+            reasoning: reason,
+        };
+    }
+    /**
+     * Create a bid decision with all common fields.
+     */
+    bidDecision(amount, currency, confidence, reasoning, metadata) {
+        return {
+            action: 'BID',
+            amount,
+            currency,
+            confidence,
+            reasoning,
+            metadata,
+        };
+    }
+    /**
+     * Create an offer decision with all common fields.
+     */
+    offerDecision(amount, currency, confidence, reasoning, metadata) {
+        return {
+            action: 'OFFER',
+            amount,
+            currency,
+            confidence,
+            reasoning,
+            metadata,
+        };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRE-FLIGHT CHECKS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Run standard pre-flight checks common to all strategies.
+     * Returns a decision if checks fail, undefined if all pass.
+     *
+     * @param context The strategy context
+     * @param options Pre-flight options
+     * @returns StrategyDecision if checks fail, undefined if all pass
+     */
+    runPreFlightChecks(context, options = {}) {
+        const { listing, remainingBudget, agentConfig, currentTime, marketContext } = context;
+        // Check auction requirement
+        if (options.requireAuction && !listing.isAuction) {
+            return this.skipDecision('Not an auction - strategy requires auctions');
+        }
+        // Check auction end time requirement
+        if (options.requireAuctionEndTime && !listing.auctionEndTime) {
+            return this.skipDecision('Auction has no end time defined');
+        }
+        // Check listing criteria
+        if (!this.meetsListingCriteria(listing, agentConfig)) {
+            return this.skipDecision('Listing does not meet target criteria');
+        }
+        // Check budget
+        if (remainingBudget.value <= 0) {
+            return this.skipDecision('No budget remaining');
+        }
+        // Check market context requirement
+        if (options.requireMarketContext && !marketContext) {
+            return this.watchDecision(options.marketContextReason ?? 'Insufficient market data for evaluation');
+        }
+        // All checks passed
+        return undefined;
+    }
+    /**
+     * Check if auction has ended.
+     * @returns StrategyDecision if ended, undefined if still active
+     */
+    checkAuctionEnded(listing, currentTime) {
+        if (listing.auctionEndTime) {
+            const endTime = new Date(listing.auctionEndTime);
+            if (currentTime >= endTime) {
+                return this.skipDecision('Auction has ended');
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if current price exceeds maximum bid.
+     * @returns StrategyDecision if exceeded, undefined if within budget
+     */
+    checkPriceExceedsMax(listing, maxBid) {
+        if (listing.currentPrice >= maxBid) {
+            return this.skipDecision(`Current price ($${listing.currentPrice}) exceeds max bid ($${maxBid.toFixed(2)})`);
+        }
+        return undefined;
+    }
+    /**
+     * Calculate discount percentage from market average.
+     */
+    calculateDiscount(price, marketAverage) {
+        return ((marketAverage - price) / marketAverage) * 100;
+    }
+    /**
+     * Calculate premium percentage above market average.
+     */
+    calculatePremium(price, marketAverage) {
+        return ((price - marketAverage) / marketAverage) * 100;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/swarm/strategies/types.js.map

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

package/dist/swarm/swarm-controller.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Swarm Controller
+ *
+ * Central orchestrator for the market agent swarm.
+ * Manages agent lifecycle, coordinates operations, and enforces constraints.
+ *
+ * Responsibilities:
+ * - Create and manage swarm instances
+ * - Spawn and terminate agents
+ * - Coordinate search and bidding operations
+ * - Emit events for registry integration
+ * - Enforce budget and safety limits
+ */
+import { EventEmitter } from 'events';
+import type { SwarmConfig, SwarmStatus, MarketAgentState, Money, MonetaryBudget, TargetCriteria, TimeWindow, BiddingStrategy, AgentMode, Observation, AlertConfig } from './types.js';
+/**
+ * Swarm creation options.
+ */
+export interface CreateSwarmOptions {
+    /** Operating mode: COMBAT (autonomous) or RECONNAISSANCE (observe only) */
+    mode?: AgentMode;
+    totalBudget: MonetaryBudget | {
+        value: number;
+        currency: string;
+    };
+    agentCount?: number;
+    strategyDistribution?: Map<BiddingStrategy, number>;
+    targetCriteria: TargetCriteria;
+    timeWindow: TimeWindow;
+    feeReservePercent?: number;
+    searchIntervalMs?: number;
+    /** Alert configuration for RECONNAISSANCE mode */
+    alertConfig?: AlertConfig;
+}
+/**
+ * Swarm status report returned by getStatus().
+ */
+export interface SwarmStatusReport {
+    swarmId: string;
+    status: SwarmStatus;
+    activeAgents: number;
+    totalBids: number;
+    totalOffers: number;
+    wonAuctions: number;
+    acceptedOffers: number;
+    itemsAcquired: number;
+    budgetTotal: Money;
+    budgetSpent: Money;
+    budgetAvailable: Money;
+    timeRemaining: number;
+    lastActivity?: Date;
+}
+/**
+ * Swarm controller events.
+ */
+export interface SwarmControllerEvents {
+    'swarm:created': (swarmId: string, config: SwarmConfig) => void;
+    'swarm:started': (swarmId: string) => void;
+    'swarm:paused': (swarmId: string) => void;
+    'swarm:terminated': (swarmId: string, reason: string) => void;
+    'agent:spawned': (swarmId: string, agentId: string, strategy: BiddingStrategy) => void;
+    'agent:terminated': (swarmId: string, agentId: string, reason: string) => void;
+    'bid:placed': (swarmId: string, agentId: string, listingId: string, amount: number) => void;
+    'bid:won': (swarmId: string, agentId: string, listingId: string, amount: number) => void;
+    'bid:lost': (swarmId: string, agentId: string, listingId: string) => void;
+    'offer:submitted': (swarmId: string, agentId: string, listingId: string, amount: number) => void;
+    'offer:accepted': (swarmId: string, agentId: string, listingId: string, amount: number) => void;
+    'item:acquired': (swarmId: string, agentId: string, listingId: string, cost: number) => void;
+    'error': (swarmId: string, error: Error) => void;
+    'observation:recorded': (swarmId: string, observation: Observation) => void;
+    'opportunity:identified': (swarmId: string, observation: Observation) => void;
+    'probe:requested': (swarmId: string, agentId: string, listingId: string) => void;
+}
+export declare class SwarmController extends EventEmitter {
+    private swarmConfig;
+    private swarmState;
+    private budgetAllocator;
+    private agents;
+    private ebayClient;
+    private database;
+    private searchIntervalMs;
+    private isRunning;
+    constructor();
+    /**
+     * Create a new swarm.
+     */
+    createSwarm(options: CreateSwarmOptions): Promise<string>;
+    /**
+     * Start swarm operations.
+     */
+    startSwarm(): Promise<void>;
+    /**
+     * Pause swarm operations.
+     */
+    pauseSwarm(): Promise<void>;
+    /**
+     * Terminate swarm and compute final insights.
+     */
+    terminateSwarm(reason?: string): Promise<void>;
+    /**
+     * Spawn agents based on strategy distribution.
+     */
+    private spawnAgents;
+    /**
+     * Start search loop for an agent.
+     */
+    private startAgentSearchLoop;
+    /**
+     * Execute a search cycle for an agent.
+     */
+    private executeAgentSearch;
+    /**
+     * Evaluate a listing and decide whether to act.
+     */
+    private evaluateListing;
+    /**
+     * Record an observation based on strategy decision (RECONNAISSANCE mode).
+     */
+    private recordObservationFromDecision;
+    /**
+     * Map action to observation type.
+     */
+    private mapActionToObservationType;
+    /**
+     * Assess market condition based on listing price.
+     */
+    private assessMarketCondition;
+    /**
+     * Assess competition level for a listing.
+     */
+    private assessCompetitionLevel;
+    /**
+     * Check if swarm is in reconnaissance mode.
+     */
+    isReconnaissanceMode(): boolean;
+    /**
+     * Place a bid on an auction.
+     */
+    private placeBid;
+    /**
+     * Submit a Best Offer.
+     */
+    private submitOffer;
+    /**
+     * Add listing to watchlist.
+     */
+    private watchListing;
+    /**
+     * Handle auction win notification.
+     */
+    handleAuctionWin(agentId: string, listingId: string, finalAmount: number): Promise<void>;
+    /**
+     * Handle auction loss notification.
+     */
+    handleAuctionLoss(agentId: string, listingId: string): Promise<void>;
+    /**
+     * Handle offer acceptance.
+     */
+    handleOfferAccepted(agentId: string, listingId: string, finalAmount: number): Promise<void>;
+    /**
+     * Get current swarm status.
+     */
+    getStatus(): SwarmStatusReport | null;
+    /**
+     * Get detailed agent status.
+     */
+    getAgentStatus(agentId: string): MarketAgentState | null;
+    /**
+     * Get all agent summaries.
+     */
+    getAgentSummaries(): Array<{
+        agentId: string;
+        strategy: BiddingStrategy;
+        status: string;
+        budget: number;
+        spent: number;
+        wins: number;
+        losses: number;
+    }>;
+    /**
+     * Calculate time remaining in swarm window.
+     */
+    private calculateTimeRemaining;
+    /**
+     * Record an event to the database.
+     */
+    private recordEvent;
+}
+/**
+ * Get the swarm controller singleton.
+ */
+export declare function getSwarmController(): SwarmController;
+/**
+ * Create a fresh swarm controller (for testing).
+ */
+export declare function createSwarmController(): SwarmController;
+//# sourceMappingURL=swarm-controller.d.ts.map

package/dist/swarm/swarm-controller.d.ts.map

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