promptspeak-mcp-server 0.1.0

package/dist/swarm/strategies/negotiator.js

@@ -0,0 +1,326 @@
+/**
+ * Negotiator Bidding Strategy
+ *
+ * Specializes in Best Offer negotiations with calculated concessions.
+ * Uses a multi-round approach to find the seller's true floor price.
+ *
+ * Key characteristics:
+ * - Opens with low but reasonable offer (60-70% of asking)
+ * - Makes calculated concessions each round
+ * - Knows when to walk away vs. accept
+ * - Best for: patient bidders, negotiable listings
+ */
+import { BaseStrategy, } from './types.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEFAULT CONFIGURATION
+// ═══════════════════════════════════════════════════════════════════════════════
+const DEFAULT_NEGOTIATOR_CONFIG = {
+    /** Maximum premium above market average */
+    maxPremiumPercent: 10,
+    /** Start offers at 65% of asking price */
+    initialOfferPercent: 65,
+    /** Maximum number of negotiation rounds */
+    maxNegotiationRounds: 4,
+    /** Increase offer by 8% each round */
+    concessionRatePercent: 8,
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// NEGOTIATOR STRATEGY
+// ═══════════════════════════════════════════════════════════════════════════════
+export class NegotiatorStrategy extends BaseStrategy {
+    strategyType = 'NEGOTIATOR';
+    name = 'Negotiator';
+    description = 'Expert at Best Offer negotiations. Opens with strategic low offers and makes ' +
+        'calculated concessions to find the seller\'s true floor price.';
+    capabilities = {
+        supportsAuctions: false, // Doesn't participate in auctions
+        supportsOffers: true,
+        supportsNegotiation: true, // Core competency
+        supportsBuyItNow: true, // If price drops low enough
+        requiresPreciseTiming: false,
+    };
+    constructor(config) {
+        super({ ...DEFAULT_NEGOTIATOR_CONFIG, ...config });
+    }
+    /**
+     * Evaluate whether to negotiate on this listing.
+     */
+    async evaluate(context) {
+        const { listing, remainingBudget, agentConfig, marketContext } = context;
+        // ═══════════════════════════════════════════════════════════════════════
+        // PRE-FLIGHT CHECKS
+        // ═══════════════════════════════════════════════════════════════════════
+        if (!this.meetsListingCriteria(listing, agentConfig)) {
+            return this.skipDecision('Listing does not meet target criteria');
+        }
+        if (remainingBudget.value <= 0) {
+            return this.skipDecision('No budget remaining');
+        }
+        // Negotiator prefers Best Offer listings
+        if (!listing.bestOfferEnabled) {
+            // If not Best Offer, check if BIN is worth it
+            if (listing.buyItNowPrice && this.isBuyItNowWorthIt(listing, marketContext)) {
+                return {
+                    action: 'BID',
+                    amount: listing.buyItNowPrice,
+                    currency: remainingBudget.currency,
+                    confidence: 0.8,
+                    reasoning: 'Buy It Now price is below target - purchasing immediately',
+                    metadata: { purchaseType: 'BUY_IT_NOW' },
+                };
+            }
+            return this.skipDecision('Negotiator strategy requires Best Offer enabled listings');
+        }
+        // Skip auctions
+        if (listing.isAuction) {
+            return this.skipDecision('Negotiator does not participate in auctions');
+        }
+        // ═══════════════════════════════════════════════════════════════════════
+        // INITIAL OFFER CALCULATION
+        // ═══════════════════════════════════════════════════════════════════════
+        const askingPrice = listing.buyItNowPrice ?? listing.currentPrice;
+        const maxWillingToPay = this.calculateMaxPrice(context);
+        // Don't waste time if asking price exceeds our ceiling
+        if (askingPrice > maxWillingToPay * 1.5) {
+            return this.skipDecision(`Asking price ($${askingPrice}) too far above our max ($${maxWillingToPay.toFixed(2)})`);
+        }
+        // Calculate opening offer
+        const openingOffer = this.calculateOfferAmount(context);
+        // Check for existing negotiations on this listing
+        const existingNegotiations = context.listingHistory?.filter(e => e.eventType === 'OFFER_SUBMITTED' || e.eventType === 'OFFER_COUNTERED');
+        if (existingNegotiations?.length) {
+            // We're already in negotiation - defer to handleCounterOffer
+            return this.watchDecision('Existing negotiation in progress - awaiting seller response');
+        }
+        return {
+            action: 'OFFER',
+            amount: openingOffer,
+            currency: remainingBudget.currency,
+            confidence: 0.75,
+            reasoning: this.generateOpeningOfferReasoning(openingOffer, askingPrice, marketContext),
+            metadata: {
+                askingPrice,
+                offerPercent: (openingOffer / askingPrice) * 100,
+                maxWillingToPay,
+                negotiationRound: 1,
+                expectedRounds: this.estimateRoundsNeeded(openingOffer, maxWillingToPay),
+            },
+        };
+    }
+    /**
+     * Handle counter-offer from seller.
+     */
+    async handleCounterOffer(context) {
+        const { listing, remainingBudget, counterAmount, originalOffer, negotiationRound, sellerMessage, } = context;
+        const maxRounds = this.config.maxNegotiationRounds ?? 4;
+        const askingPrice = listing.buyItNowPrice ?? listing.currentPrice;
+        const maxWillingToPay = this.calculateMaxPrice(context);
+        // ═══════════════════════════════════════════════════════════════════════
+        // ANALYZE COUNTER-OFFER
+        // ═══════════════════════════════════════════════════════════════════════
+        const counterAnalysis = this.analyzeCounterOffer(originalOffer, counterAmount, askingPrice, maxWillingToPay);
+        // Counter is at or below our max - accept!
+        if (counterAmount <= maxWillingToPay) {
+            return {
+                action: 'ACCEPT',
+                amount: counterAmount,
+                currency: remainingBudget.currency,
+                confidence: 0.9,
+                reasoning: `Counter-offer of $${counterAmount.toFixed(2)} is within our target - accepting`,
+                metadata: {
+                    originalOffer,
+                    negotiationRound,
+                    savingsFromAsking: askingPrice - counterAmount,
+                    ...counterAnalysis,
+                },
+            };
+        }
+        // Check if we've exceeded max rounds
+        if (negotiationRound >= maxRounds) {
+            return {
+                action: 'DECLINE',
+                confidence: 0.8,
+                reasoning: `Max negotiation rounds (${maxRounds}) reached. ` +
+                    `Counter-offer $${counterAmount.toFixed(2)} exceeds max $${maxWillingToPay.toFixed(2)}`,
+                metadata: {
+                    negotiationRound,
+                    maxRounds,
+                    counterAmount,
+                    maxWillingToPay,
+                },
+            };
+        }
+        // ═══════════════════════════════════════════════════════════════════════
+        // CALCULATE COUNTER-COUNTER
+        // ═══════════════════════════════════════════════════════════════════════
+        const nextOffer = this.calculateNextOffer(originalOffer, counterAmount, maxWillingToPay, negotiationRound);
+        // If our next offer would exceed max or match counter, stop
+        if (nextOffer >= counterAmount) {
+            if (counterAmount <= maxWillingToPay * 1.05) {
+                // Within 5% of max - accept
+                return {
+                    action: 'ACCEPT',
+                    amount: counterAmount,
+                    currency: remainingBudget.currency,
+                    confidence: 0.75,
+                    reasoning: `Counter $${counterAmount.toFixed(2)} is close to our max - accepting to close deal`,
+                };
+            }
+            return {
+                action: 'DECLINE',
+                confidence: 0.7,
+                reasoning: `Cannot improve on counter-offer of $${counterAmount.toFixed(2)}`,
+            };
+        }
+        return {
+            action: 'COUNTER',
+            amount: nextOffer,
+            currency: remainingBudget.currency,
+            confidence: 0.7,
+            reasoning: this.generateCounterReasoning(nextOffer, counterAmount, negotiationRound, sellerMessage),
+            metadata: {
+                previousOffer: originalOffer,
+                sellerCounter: counterAmount,
+                negotiationRound: negotiationRound + 1,
+                concessionAmount: nextOffer - originalOffer,
+                ...counterAnalysis,
+            },
+        };
+    }
+    /**
+     * Calculate maximum price willing to pay.
+     */
+    calculateMaxPrice(context) {
+        const { remainingBudget, marketContext } = context;
+        if (marketContext) {
+            const maxPremium = this.config.maxPremiumPercent ?? 10;
+            const marketMax = marketContext.averagePrice * (1 + maxPremium / 100);
+            return Math.min(marketMax, remainingBudget.value);
+        }
+        // Without market data, use budget
+        return remainingBudget.value;
+    }
+    /**
+     * Calculate opening offer.
+     */
+    calculateOfferAmount(context) {
+        const { listing, remainingBudget, marketContext } = context;
+        const askingPrice = listing.buyItNowPrice ?? listing.currentPrice;
+        let targetPercent = this.config.initialOfferPercent ?? 65;
+        // Adjust based on market data
+        if (marketContext) {
+            const priceRatio = askingPrice / marketContext.averagePrice;
+            if (priceRatio > 1.2) {
+                // Overpriced - offer lower
+                targetPercent = 55;
+            }
+            else if (priceRatio < 0.9) {
+                // Already good deal - offer higher to win
+                targetPercent = 80;
+            }
+        }
+        const offerAmount = askingPrice * (targetPercent / 100);
+        return Math.min(offerAmount, remainingBudget.value);
+    }
+    /**
+     * Calculate bid amount (not used much by negotiator).
+     */
+    calculateBidAmount(context) {
+        return this.calculateMaxPrice(context);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRIVATE HELPERS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Analyze seller's counter-offer behavior.
+     */
+    analyzeCounterOffer(ourOffer, theirCounter, askingPrice, ourMax) {
+        const sellerConcession = askingPrice - theirCounter;
+        const sellerConcessionPercent = (sellerConcession / askingPrice) * 100;
+        const gap = theirCounter - ourOffer;
+        const gapPercent = (gap / askingPrice) * 100;
+        let sellerFlexibility;
+        if (sellerConcessionPercent < 5) {
+            sellerFlexibility = 'RIGID';
+        }
+        else if (sellerConcessionPercent < 15) {
+            sellerFlexibility = 'MODERATE';
+        }
+        else {
+            sellerFlexibility = 'FLEXIBLE';
+        }
+        return {
+            sellerConcession,
+            sellerConcessionPercent,
+            gap,
+            gapPercent,
+            sellerFlexibility,
+        };
+    }
+    /**
+     * Calculate next offer in negotiation.
+     */
+    calculateNextOffer(previousOffer, counterAmount, maxWilling, round) {
+        const concessionRate = this.config.concessionRatePercent ?? 8;
+        // Diminishing concessions as rounds progress
+        const roundMultiplier = 1 - (round * 0.15);
+        const concession = previousOffer * (concessionRate / 100) * Math.max(0.3, roundMultiplier);
+        const nextOffer = previousOffer + concession;
+        // Split the difference approach for later rounds
+        if (round >= 2) {
+            const splitDiff = previousOffer + (counterAmount - previousOffer) * 0.3;
+            return Math.min(Math.max(nextOffer, splitDiff), maxWilling);
+        }
+        return Math.min(nextOffer, maxWilling);
+    }
+    /**
+     * Estimate rounds needed to reach agreement.
+     */
+    estimateRoundsNeeded(openingOffer, maxPrice) {
+        const concessionRate = this.config.concessionRatePercent ?? 8;
+        const gap = maxPrice - openingOffer;
+        const avgConcession = openingOffer * (concessionRate / 100);
+        return Math.min(Math.ceil(gap / avgConcession), this.config.maxNegotiationRounds ?? 4);
+    }
+    /**
+     * Check if BIN price is worth immediate purchase.
+     */
+    isBuyItNowWorthIt(listing, marketContext) {
+        if (!listing.buyItNowPrice)
+            return false;
+        if (marketContext) {
+            // Buy if BIN is 20%+ below market
+            return listing.buyItNowPrice <= marketContext.averagePrice * 0.8;
+        }
+        return false;
+    }
+    /**
+     * Generate reasoning for opening offer.
+     */
+    generateOpeningOfferReasoning(offer, askingPrice, marketContext) {
+        const parts = [];
+        const offerPercent = Math.round((offer / askingPrice) * 100);
+        parts.push(`Opening negotiation with $${offer.toFixed(2)} (${offerPercent}% of asking)`);
+        if (marketContext) {
+            const marketComparison = (offer / marketContext.averagePrice) * 100;
+            parts.push(`- ${Math.round(marketComparison)}% of market average`);
+            if (askingPrice > marketContext.averagePrice) {
+                parts.push('- asking price above market, room to negotiate');
+            }
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Generate reasoning for counter-offer.
+     */
+    generateCounterReasoning(ourOffer, theirCounter, round, sellerMessage) {
+        const parts = [];
+        parts.push(`Round ${round + 1}: Countering with $${ourOffer.toFixed(2)}`);
+        parts.push(`(vs seller's $${theirCounter.toFixed(2)})`);
+        if (sellerMessage) {
+            parts.push(`- seller mentioned: "${sellerMessage.substring(0, 50)}..."`);
+        }
+        return parts.join(' ');
+    }
+}
+//# sourceMappingURL=negotiator.js.map

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

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

package/dist/swarm/strategies/passive.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Passive Bidding Strategy
+ *
+ * Only engages with significantly underpriced listings.
+ * Waits for exceptional deals rather than competing actively.
+ *
+ * Key characteristics:
+ * - Requires large discount from market value (30%+)
+ * - Minimal bidding activity
+ * - Low risk, low effort, lower volume
+ * - Best for: patient value seekers, large portfolios
+ */
+import { BaseStrategy, StrategyCapabilities, StrategyConfig, StrategyContext, StrategyDecision } from './types.js';
+import type { BiddingStrategy, NormalizedListing } from '../types.js';
+export declare class PassiveStrategy extends BaseStrategy {
+    readonly strategyType: BiddingStrategy;
+    readonly name = "Passive";
+    readonly description: string;
+    readonly capabilities: StrategyCapabilities;
+    constructor(config?: Partial<StrategyConfig>);
+    /**
+     * Evaluate whether listing meets passive strategy criteria.
+     */
+    evaluate(context: StrategyContext): Promise<StrategyDecision>;
+    /**
+     * Evaluate auction opportunity.
+     */
+    private evaluateAuction;
+    /**
+     * Evaluate Best Offer opportunity.
+     */
+    private evaluateOffer;
+    /**
+     * Calculate bid amount - passive bids conservatively.
+     */
+    calculateBidAmount(context: StrategyContext): number;
+    /**
+     * Calculate offer amount - targets significant discount.
+     */
+    calculateOfferAmount(context: StrategyContext): number;
+    /**
+     * Calculate maximum bid based on discount requirement.
+     */
+    private calculateMaxBid;
+    /**
+     * Assess value of listing against market.
+     */
+    private assessValue;
+    /**
+     * Check for exceptional opportunity (very rare, very underpriced).
+     */
+    isExceptionalOpportunity(listing: NormalizedListing, marketContext: {
+        averagePrice: number;
+    }): boolean;
+}
+//# sourceMappingURL=passive.d.ts.map

package/dist/swarm/strategies/passive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passive.d.ts","sourceRoot":"","sources":["../../../src/swarm/strategies/passive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqBtE,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAa;IACnD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,SAEyD;IAE7E,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAMzC;gBAEU,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAI5C;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmFnE;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAWpD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAiBtD;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,WAAW;IA4BnB;;OAEG;IACH,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;CAIvG"}

package/dist/swarm/strategies/passive.js

@@ -0,0 +1,247 @@
+/**
+ * Passive Bidding Strategy
+ *
+ * Only engages with significantly underpriced listings.
+ * Waits for exceptional deals rather than competing actively.
+ *
+ * Key characteristics:
+ * - Requires large discount from market value (30%+)
+ * - Minimal bidding activity
+ * - Low risk, low effort, lower volume
+ * - Best for: patient value seekers, large portfolios
+ */
+import { BaseStrategy, } from './types.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEFAULT CONFIGURATION
+// ═══════════════════════════════════════════════════════════════════════════════
+const DEFAULT_PASSIVE_CONFIG = {
+    /** Only buy at 30%+ below market */
+    minDiscountPercent: 30,
+    /** Maximum premium - passive never pays premium */
+    maxPremiumPercent: 0,
+    /** Conservative opening offer */
+    initialOfferPercent: 50,
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// PASSIVE STRATEGY
+// ═══════════════════════════════════════════════════════════════════════════════
+export class PassiveStrategy extends BaseStrategy {
+    strategyType = 'PASSIVE';
+    name = 'Passive';
+    description = 'Only engages with significantly underpriced listings (30%+ below market). ' +
+        'Patient approach that waits for exceptional deals rather than competing.';
+    capabilities = {
+        supportsAuctions: true, // Will bid on underpriced auctions
+        supportsOffers: true, // Will make offers on underpriced items
+        supportsNegotiation: false, // Doesn't negotiate - price must already be good
+        supportsBuyItNow: true, // Primary method - snap up deals
+        requiresPreciseTiming: false,
+    };
+    constructor(config) {
+        super({ ...DEFAULT_PASSIVE_CONFIG, ...config });
+    }
+    /**
+     * Evaluate whether listing meets passive strategy criteria.
+     */
+    async evaluate(context) {
+        const { listing, remainingBudget, agentConfig, marketContext, currentTime } = context;
+        // ═══════════════════════════════════════════════════════════════════════
+        // PRE-FLIGHT CHECKS
+        // ═══════════════════════════════════════════════════════════════════════
+        if (!this.meetsListingCriteria(listing, agentConfig)) {
+            return this.skipDecision('Listing does not meet target criteria');
+        }
+        if (remainingBudget.value <= 0) {
+            return this.skipDecision('No budget remaining');
+        }
+        // ═══════════════════════════════════════════════════════════════════════
+        // VALUE ASSESSMENT (CRITICAL FOR PASSIVE)
+        // ═══════════════════════════════════════════════════════════════════════
+        // Passive strategy REQUIRES market context to assess value
+        if (!marketContext) {
+            return this.watchDecision('Insufficient market data - passive strategy requires price comparison');
+        }
+        const valueAssessment = this.assessValue(listing, marketContext);
+        // Must meet minimum discount threshold
+        if (!valueAssessment.meetsThreshold) {
+            return {
+                action: 'SKIP',
+                confidence: 0.9,
+                reasoning: valueAssessment.reasoning,
+                metadata: {
+                    discountPercent: valueAssessment.discountPercent,
+                    requiredDiscount: this.config.minDiscountPercent ?? 30,
+                    currentPrice: listing.currentPrice,
+                    marketAverage: marketContext.averagePrice,
+                },
+            };
+        }
+        // ═══════════════════════════════════════════════════════════════════════
+        // OPPORTUNITY DETECTED - DETERMINE BEST APPROACH
+        // ═══════════════════════════════════════════════════════════════════════
+        // Priority 1: Buy It Now (instant acquisition)
+        if (listing.buyItNowPrice && listing.buyItNowPrice <= remainingBudget.value) {
+            const binDiscount = this.calculateDiscount(listing.buyItNowPrice, marketContext.averagePrice);
+            if (binDiscount >= (this.config.minDiscountPercent ?? 30)) {
+                return {
+                    action: 'BID',
+                    amount: listing.buyItNowPrice,
+                    currency: remainingBudget.currency,
+                    confidence: 0.95,
+                    reasoning: `Exceptional value! Buy It Now at $${listing.buyItNowPrice} is ` +
+                        `${binDiscount.toFixed(0)}% below market average - acquiring immediately`,
+                    metadata: {
+                        purchaseType: 'BUY_IT_NOW',
+                        discountPercent: binDiscount,
+                        marketAverage: marketContext.averagePrice,
+                        savingsAmount: marketContext.averagePrice - listing.buyItNowPrice,
+                    },
+                };
+            }
+        }
+        // Priority 2: Auction with good current price
+        if (listing.isAuction) {
+            return this.evaluateAuction(context, valueAssessment);
+        }
+        // Priority 3: Best Offer on good deal
+        if (listing.bestOfferEnabled) {
+            return this.evaluateOffer(context, valueAssessment);
+        }
+        // Fixed price that meets our criteria but no BIN (shouldn't happen often)
+        return this.watchDecision('Fixed price listing - watching for price drop');
+    }
+    /**
+     * Evaluate auction opportunity.
+     */
+    evaluateAuction(context, valueAssessment) {
+        const { listing, remainingBudget, currentTime, marketContext } = context;
+        // Check if auction has ended
+        if (listing.auctionEndTime) {
+            const endTime = new Date(listing.auctionEndTime);
+            if (currentTime >= endTime) {
+                return this.skipDecision('Auction has ended');
+            }
+        }
+        // For passive strategy, we set max bid at our discount threshold
+        const maxBid = this.calculateMaxBid(marketContext);
+        // Current price already exceeds our max
+        if (listing.currentPrice >= maxBid) {
+            return this.skipDecision(`Current price ($${listing.currentPrice}) exceeds passive max ($${maxBid.toFixed(2)})`);
+        }
+        // Bid conservatively - at current price plus minimum increment
+        const bidAmount = Math.min(listing.currentPrice * 1.05, // 5% above current
+        maxBid, remainingBudget.value);
+        return {
+            action: 'BID',
+            amount: bidAmount,
+            currency: remainingBudget.currency,
+            confidence: 0.8,
+            reasoning: `Underpriced auction at ${valueAssessment.discountPercent.toFixed(0)}% below market - ` +
+                `bidding conservatively at $${bidAmount.toFixed(2)}`,
+            metadata: {
+                currentPrice: listing.currentPrice,
+                maxBid,
+                discountPercent: valueAssessment.discountPercent,
+                bidCount: listing.bidCount,
+            },
+        };
+    }
+    /**
+     * Evaluate Best Offer opportunity.
+     */
+    evaluateOffer(context, valueAssessment) {
+        const { listing, remainingBudget, marketContext } = context;
+        // For passive strategy, offer at our target discount level
+        const askingPrice = listing.buyItNowPrice ?? listing.currentPrice;
+        const targetPrice = marketContext.averagePrice * (1 - (this.config.minDiscountPercent ?? 30) / 100);
+        const offerAmount = Math.min(targetPrice, remainingBudget.value);
+        // Don't bother if our offer would be insulting (less than 40% of asking)
+        if (offerAmount < askingPrice * 0.4) {
+            return this.skipDecision('Target price too far below asking - unlikely to be accepted');
+        }
+        return {
+            action: 'OFFER',
+            amount: offerAmount,
+            currency: remainingBudget.currency,
+            confidence: 0.6, // Lower confidence - passive offers often rejected
+            reasoning: `Submitting value-seeking offer of $${offerAmount.toFixed(2)} ` +
+                `(${Math.round((offerAmount / askingPrice) * 100)}% of asking, ` +
+                `${Math.round((1 - offerAmount / marketContext.averagePrice) * 100)}% below market)`,
+            metadata: {
+                askingPrice,
+                targetPrice,
+                marketAverage: marketContext.averagePrice,
+                offerPercent: (offerAmount / askingPrice) * 100,
+            },
+        };
+    }
+    /**
+     * Calculate bid amount - passive bids conservatively.
+     */
+    calculateBidAmount(context) {
+        const { marketContext, remainingBudget } = context;
+        if (!marketContext) {
+            return 0; // Passive doesn't bid without market data
+        }
+        const maxBid = this.calculateMaxBid(marketContext);
+        return Math.min(maxBid, remainingBudget.value);
+    }
+    /**
+     * Calculate offer amount - targets significant discount.
+     */
+    calculateOfferAmount(context) {
+        const { marketContext, remainingBudget } = context;
+        if (!marketContext) {
+            return 0;
+        }
+        const minDiscount = this.config.minDiscountPercent ?? 30;
+        const targetPrice = marketContext.averagePrice * (1 - minDiscount / 100);
+        return Math.min(targetPrice, remainingBudget.value);
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRIVATE HELPERS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Calculate maximum bid based on discount requirement.
+     */
+    calculateMaxBid(marketContext) {
+        const minDiscount = this.config.minDiscountPercent ?? 30;
+        return marketContext.averagePrice * (1 - minDiscount / 100);
+    }
+    // Note: calculateDiscount() is inherited from BaseStrategy
+    /**
+     * Assess value of listing against market.
+     */
+    assessValue(listing, marketContext) {
+        const currentPrice = listing.currentPrice;
+        const discountPercent = this.calculateDiscount(currentPrice, marketContext.averagePrice);
+        const requiredDiscount = this.config.minDiscountPercent ?? 30;
+        const meetsThreshold = discountPercent >= requiredDiscount;
+        let reasoning;
+        if (meetsThreshold) {
+            reasoning = `Listing is ${discountPercent.toFixed(0)}% below market - meets passive threshold`;
+        }
+        else if (discountPercent > 0) {
+            reasoning = `Listing is ${discountPercent.toFixed(0)}% below market - ` +
+                `requires ${requiredDiscount}%+ discount`;
+        }
+        else {
+            reasoning = `Listing is at or above market average - passive strategy skipping`;
+        }
+        return {
+            discountPercent,
+            meetsThreshold,
+            reasoning,
+            marketAverage: marketContext.averagePrice,
+            currentPrice,
+        };
+    }
+    /**
+     * Check for exceptional opportunity (very rare, very underpriced).
+     */
+    isExceptionalOpportunity(listing, marketContext) {
+        const discount = this.calculateDiscount(listing.currentPrice, marketContext.averagePrice);
+        return discount >= 50; // 50%+ discount is exceptional
+    }
+}
+//# sourceMappingURL=passive.js.map