promptspeak-mcp-server 0.1.0

package/dist/swarm/hooks/alert-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-hook.js","sourceRoot":"","sources":["../../../src/swarm/hooks/alert-hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAwB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAe,MAAM,2BAA2B,CAAC;AAExE;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO,UAAU,EAAE;SAChB,EAAE,CAAC,cAAc,CAAC;SAClB,IAAI,CAAC,cAAc,CAAC;SACpB,QAAQ,CAAC,EAAE,CAAC,CAAC,yCAAyC;SACtD,QAAQ,CACP,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,CAC3B;SACA,aAAa,CAAC,GAAG,CAAC,CAAC,uDAAuD;SAC1E,OAAO,CAAC,KAAK,EAAE,WAAwB,EAAE,EAAE;QAC1C,2CAA2C;QAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAE5D,uBAAuB;QACvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CACT,WAAW,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CACrF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAmB;IAC3D,OAAO,UAAU,EAAE;SAChB,EAAE,CAAC,qBAAqB,CAAC;SACzB,IAAI,CAAC,uBAAuB,CAAC;SAC7B,QAAQ,CAAC,EAAE,CAAC;SACZ,QAAQ,CACP,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,CAC3B;SACA,OAAO,CAAC,KAAK,EAAE,WAAwB,EAAE,EAAE;QAC1C,MAAM,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACb,CAAC"}

package/dist/swarm/hooks/database-sync-hook.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Database Sync Hook
+ *
+ * Writes observations to SQLite for immutable event stream storage.
+ * This is the primary audit trail for all reconnaissance activities.
+ */
+import { type ObservationHook } from './observation-hooks.js';
+/**
+ * Create the database sync hook.
+ *
+ * This hook runs with high priority (100) to ensure observations
+ * are persisted before other hooks process them.
+ */
+export declare function createDatabaseSyncHook(): ObservationHook;
+/**
+ * Enhanced database sync hook that also updates seller profiles.
+ */
+export declare function createEnhancedDatabaseSyncHook(): ObservationHook;
+//# sourceMappingURL=database-sync-hook.d.ts.map

package/dist/swarm/hooks/database-sync-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-sync-hook.d.ts","sourceRoot":"","sources":["../../../src/swarm/hooks/database-sync-hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM1E;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAqCxD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,eAAe,CAyChE"}

package/dist/swarm/hooks/database-sync-hook.js

@@ -0,0 +1,121 @@
+/**
+ * Database Sync Hook
+ *
+ * Writes observations to SQLite for immutable event stream storage.
+ * This is the primary audit trail for all reconnaissance activities.
+ */
+import { createHook } from './observation-hooks.js';
+import { createSecureLogger } from '../../core/security/index.js';
+// Use SecureLogger for market intelligence hooks - protects seller/listing data
+const logger = createSecureLogger('DatabaseSyncHook');
+/**
+ * Create the database sync hook.
+ *
+ * This hook runs with high priority (100) to ensure observations
+ * are persisted before other hooks process them.
+ */
+export function createDatabaseSyncHook() {
+    return createHook()
+        .id('database-sync')
+        .name('Database Sync')
+        .priority(100) // High priority - run first
+        .forAllTypes()
+        .handler(async (observation) => {
+        // The observation is already recorded by the swarm controller,
+        // but this hook can add additional processing like:
+        // - Logging
+        // - Metrics collection
+        // - Triggering downstream updates
+        // For now, this is a passthrough that confirms database recording
+        // In production, you might add retry logic or backup storage here
+        // Log high-confidence opportunities
+        if (observation.observationType === 'OPPORTUNITY_IDENTIFIED' &&
+            observation.confidenceScore >= 0.8) {
+            logger.info('High-confidence opportunity identified', {
+                itemTitle: observation.itemTitle,
+                price: observation.currentPrice,
+                confidence: observation.confidenceScore,
+            });
+        }
+        // Log probe requests that need human attention
+        if (observation.observationType === 'PROBE_REQUESTED') {
+            logger.info('Probe requested - awaiting human approval', {
+                itemTitle: observation.itemTitle,
+                listingId: observation.listingId,
+            });
+        }
+    })
+        .build();
+}
+/**
+ * Enhanced database sync hook that also updates seller profiles.
+ */
+export function createEnhancedDatabaseSyncHook() {
+    // Track sellers seen in this session
+    const sellerObservations = new Map();
+    return createHook()
+        .id('database-sync-enhanced')
+        .name('Enhanced Database Sync')
+        .priority(100)
+        .forAllTypes()
+        .handler(async (observation) => {
+        // Track seller interactions
+        if (observation.sellerId) {
+            const count = sellerObservations.get(observation.sellerId) ?? 0;
+            sellerObservations.set(observation.sellerId, count + 1);
+        }
+        // Additional processing based on observation type
+        switch (observation.observationType) {
+            case 'OPPORTUNITY_IDENTIFIED':
+                handleOpportunity(observation);
+                break;
+            case 'SELLER_BEHAVIOR_OBSERVED':
+                handleSellerBehavior(observation);
+                break;
+            case 'PROBE_REQUESTED':
+                handleProbeRequest(observation);
+                break;
+            case 'MARKET_CONDITION_DETECTED':
+                handleMarketCondition(observation);
+                break;
+        }
+    })
+        .cleanup(async () => {
+        // Log final stats on shutdown
+        logger.info('Session complete', { uniqueSellers: sellerObservations.size });
+        sellerObservations.clear();
+    })
+        .build();
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// HELPER FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+function handleOpportunity(obs) {
+    const urgency = obs.timeRemaining && obs.timeRemaining < 3600 ? 'URGENT' : 'NORMAL';
+    logger.info('Opportunity detected', {
+        itemTitle: obs.itemTitle?.substring(0, 50),
+        price: obs.currentPrice,
+        discountPercent: obs.discountPercent,
+        urgency,
+    });
+}
+function handleSellerBehavior(obs) {
+    logger.info('Seller behavior observed', {
+        sellerId: obs.sellerId,
+        reasoning: obs.reasoning?.substring(0, 100),
+    });
+}
+function handleProbeRequest(obs) {
+    logger.info('Probe request pending', {
+        listingId: obs.listingId,
+        recommendedAction: obs.recommendedAction,
+        recommendedAmount: obs.recommendedAmount,
+    });
+}
+function handleMarketCondition(obs) {
+    logger.info('Market condition detected', {
+        condition: obs.marketCondition,
+        reasoning: obs.reasoning?.substring(0, 100),
+    });
+}
+//# sourceMappingURL=database-sync-hook.js.map

package/dist/swarm/hooks/database-sync-hook.js.map

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

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

@@ -0,0 +1,61 @@
+/**
+ * Observation Hooks Module
+ *
+ * Exports hook infrastructure for RECONNAISSANCE mode.
+ */
+export { ObservationHookRegistry, getObservationHookRegistry, createObservationHookRegistry, HookBuilder, createHook, type ObservationHook, type HookFilter, type HookExecutionResult, } from './observation-hooks.js';
+export { createDatabaseSyncHook, createEnhancedDatabaseSyncHook, } from './database-sync-hook.js';
+export { createWebhookAlertHook, createSlackAlertHook, createDiscordAlertHook, type WebhookConfig, } from './webhook-alert-hook.js';
+export { createAlertHook, createAlertHookWithEngine, } from './alert-hook.js';
+export { createPineconeSyncHook, createEnhancedPineconeSyncHook, flushPendingUpserts, type PineconeSyncConfig, } from './pinecone-sync-hook.js';
+import { type PineconeSyncConfig } from './pinecone-sync-hook.js';
+import type { AlertConfig } from '../types.js';
+/**
+ * Options for initializing the default hooks.
+ */
+export interface InitializeHooksOptions {
+    /** Enable database sync hook */
+    enableDatabaseSync?: boolean;
+    /** Enable alert engine hook */
+    enableAlertEngine?: boolean;
+    /** Enable Pinecone vector sync hook */
+    enablePineconeSync?: boolean;
+    /** Alert engine configuration */
+    alertConfig?: Partial<AlertConfig>;
+    /** Pinecone sync configuration */
+    pineconeConfig?: Partial<PineconeSyncConfig>;
+    /** Slack webhook URL for alerts */
+    slackWebhookUrl?: string;
+    /** Discord webhook URL for alerts */
+    discordWebhookUrl?: string;
+    /** Custom hooks to register */
+    customHooks?: import('./observation-hooks.js').ObservationHook[];
+}
+/**
+ * Initialize default hooks for RECONNAISSANCE mode.
+ *
+ * This sets up:
+ * 1. Database sync hook (always enabled by default)
+ * 2. Alert engine hook (enabled by default)
+ * 3. Pinecone vector sync hook (if enabled)
+ * 4. Slack webhook (if URL provided)
+ * 5. Discord webhook (if URL provided)
+ * 6. Any custom hooks provided
+ */
+export declare function initializeDefaultHooks(options?: InitializeHooksOptions): void;
+/**
+ * Initialize hooks from environment variables.
+ *
+ * Environment variables:
+ * - SWARM_ENABLE_DB_SYNC: Set to 'false' to disable database sync hook
+ * - SWARM_ENABLE_ALERT_ENGINE: Set to 'false' to disable alert engine
+ * - SWARM_ENABLE_PINECONE_SYNC: Set to 'true' to enable Pinecone vector sync
+ * - SWARM_PRICE_ANOMALY_THRESHOLD: Minimum % below market for price anomaly alerts (default: 15)
+ * - SWARM_CONFIDENCE_THRESHOLD: Minimum confidence for alerts (default: 0.75)
+ * - SWARM_MIN_AGENTS_CONSENSUS: Agents needed for consensus (default: 3)
+ * - SWARM_PINECONE_NAMESPACE: Pinecone namespace for vector storage (default: 'swarm')
+ * - SWARM_SLACK_WEBHOOK_URL: Slack webhook URL for notifications
+ * - SWARM_DISCORD_WEBHOOK_URL: Discord webhook URL for notifications
+ */
+export declare function initializeHooksFromEnv(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/swarm/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,WAAW,EACX,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AAUjC,OAAO,EAAkC,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,kCAAkC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7C,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,wBAAwB,EAAE,eAAe,EAAE,CAAC;CAClE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG,IAAI,CAoCjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CA8B7C"}

package/dist/swarm/hooks/index.js

@@ -0,0 +1,103 @@
+/**
+ * Observation Hooks Module
+ *
+ * Exports hook infrastructure for RECONNAISSANCE mode.
+ */
+// Core hook system
+export { ObservationHookRegistry, getObservationHookRegistry, createObservationHookRegistry, HookBuilder, createHook, } from './observation-hooks.js';
+// Built-in hooks
+export { createDatabaseSyncHook, createEnhancedDatabaseSyncHook, } from './database-sync-hook.js';
+export { createWebhookAlertHook, createSlackAlertHook, createDiscordAlertHook, } from './webhook-alert-hook.js';
+export { createAlertHook, createAlertHookWithEngine, } from './alert-hook.js';
+export { createPineconeSyncHook, createEnhancedPineconeSyncHook, flushPendingUpserts, } from './pinecone-sync-hook.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// HOOK INITIALIZATION
+// ═══════════════════════════════════════════════════════════════════════════════
+import { getObservationHookRegistry } from './observation-hooks.js';
+import { createEnhancedDatabaseSyncHook } from './database-sync-hook.js';
+import { createSlackAlertHook, createDiscordAlertHook } from './webhook-alert-hook.js';
+import { createAlertHook } from './alert-hook.js';
+import { createEnhancedPineconeSyncHook } from './pinecone-sync-hook.js';
+/**
+ * Initialize default hooks for RECONNAISSANCE mode.
+ *
+ * This sets up:
+ * 1. Database sync hook (always enabled by default)
+ * 2. Alert engine hook (enabled by default)
+ * 3. Pinecone vector sync hook (if enabled)
+ * 4. Slack webhook (if URL provided)
+ * 5. Discord webhook (if URL provided)
+ * 6. Any custom hooks provided
+ */
+export function initializeDefaultHooks(options = {}) {
+    const registry = getObservationHookRegistry();
+    // Database sync hook (high priority, runs first)
+    if (options.enableDatabaseSync !== false) {
+        registry.register(createEnhancedDatabaseSyncHook());
+    }
+    // Alert engine hook (enabled by default, processes observations for alerts)
+    if (options.enableAlertEngine !== false) {
+        registry.register(createAlertHook(options.alertConfig));
+    }
+    // Pinecone vector sync hook (disabled by default - requires index setup)
+    if (options.enablePineconeSync) {
+        registry.register(createEnhancedPineconeSyncHook(options.pineconeConfig));
+    }
+    // Slack webhook
+    if (options.slackWebhookUrl) {
+        registry.register(createSlackAlertHook(options.slackWebhookUrl));
+    }
+    // Discord webhook
+    if (options.discordWebhookUrl) {
+        registry.register(createDiscordAlertHook(options.discordWebhookUrl));
+    }
+    // Custom hooks
+    if (options.customHooks) {
+        for (const hook of options.customHooks) {
+            registry.register(hook);
+        }
+    }
+    console.log(`[HOOKS] Initialized ${registry.getAllHooks().length} observation hooks`);
+}
+/**
+ * Initialize hooks from environment variables.
+ *
+ * Environment variables:
+ * - SWARM_ENABLE_DB_SYNC: Set to 'false' to disable database sync hook
+ * - SWARM_ENABLE_ALERT_ENGINE: Set to 'false' to disable alert engine
+ * - SWARM_ENABLE_PINECONE_SYNC: Set to 'true' to enable Pinecone vector sync
+ * - SWARM_PRICE_ANOMALY_THRESHOLD: Minimum % below market for price anomaly alerts (default: 15)
+ * - SWARM_CONFIDENCE_THRESHOLD: Minimum confidence for alerts (default: 0.75)
+ * - SWARM_MIN_AGENTS_CONSENSUS: Agents needed for consensus (default: 3)
+ * - SWARM_PINECONE_NAMESPACE: Pinecone namespace for vector storage (default: 'swarm')
+ * - SWARM_SLACK_WEBHOOK_URL: Slack webhook URL for notifications
+ * - SWARM_DISCORD_WEBHOOK_URL: Discord webhook URL for notifications
+ */
+export function initializeHooksFromEnv() {
+    // Build alert config from environment
+    const alertConfig = {};
+    if (process.env.SWARM_PRICE_ANOMALY_THRESHOLD) {
+        alertConfig.priceAnomalyThreshold = parseFloat(process.env.SWARM_PRICE_ANOMALY_THRESHOLD);
+    }
+    if (process.env.SWARM_CONFIDENCE_THRESHOLD) {
+        alertConfig.confidenceThreshold = parseFloat(process.env.SWARM_CONFIDENCE_THRESHOLD);
+    }
+    if (process.env.SWARM_MIN_AGENTS_CONSENSUS) {
+        alertConfig.minAgentsForConsensus = parseInt(process.env.SWARM_MIN_AGENTS_CONSENSUS, 10);
+    }
+    // Build Pinecone config from environment
+    const pineconeConfig = {};
+    if (process.env.SWARM_PINECONE_NAMESPACE) {
+        pineconeConfig.namespace = process.env.SWARM_PINECONE_NAMESPACE;
+    }
+    initializeDefaultHooks({
+        enableDatabaseSync: process.env.SWARM_ENABLE_DB_SYNC !== 'false',
+        enableAlertEngine: process.env.SWARM_ENABLE_ALERT_ENGINE !== 'false',
+        enablePineconeSync: process.env.SWARM_ENABLE_PINECONE_SYNC === 'true',
+        alertConfig: Object.keys(alertConfig).length > 0 ? alertConfig : undefined,
+        pineconeConfig: Object.keys(pineconeConfig).length > 0 ? pineconeConfig : undefined,
+        slackWebhookUrl: process.env.SWARM_SLACK_WEBHOOK_URL,
+        discordWebhookUrl: process.env.SWARM_DISCORD_WEBHOOK_URL,
+    });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/swarm/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,WAAW,EACX,UAAU,GAIX,MAAM,wBAAwB,CAAC;AAEhC,iBAAiB;AACjB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GAEvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AAEjC,kFAAkF;AAClF,sBAAsB;AACtB,kFAAkF;AAElF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAA2B,MAAM,yBAAyB,CAAC;AAyBlG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkC,EAAE;IACzE,MAAM,QAAQ,GAAG,0BAA0B,EAAE,CAAC;IAE9C,iDAAiD;IACjD,IAAI,OAAO,CAAC,kBAAkB,KAAK,KAAK,EAAE,CAAC;QACzC,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,4EAA4E;IAC5E,IAAI,OAAO,CAAC,iBAAiB,KAAK,KAAK,EAAE,CAAC;QACxC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,yEAAyE;IACzE,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,eAAe;IACf,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,oBAAoB,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB;IACpC,sCAAsC;IACtC,MAAM,WAAW,GAAyB,EAAE,CAAC;IAE7C,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;QAC9C,WAAW,CAAC,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC;QAC3C,WAAW,CAAC,mBAAmB,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC;QAC3C,WAAW,CAAC,qBAAqB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,yCAAyC;IACzC,MAAM,cAAc,GAAgC,EAAE,CAAC;IAEvD,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;QACzC,cAAc,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAClE,CAAC;IAED,sBAAsB,CAAC;QACrB,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO;QAChE,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,OAAO;QACpE,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,MAAM;QACrE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAC1E,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;QACnF,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB;QACpD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/swarm/hooks/observation-hooks.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Observation Hook System
+ *
+ * Pluggable hook architecture for processing observations in RECONNAISSANCE mode.
+ * Hooks are triggered when agents record observations and can:
+ * - Store data in the database (database-sync-hook)
+ * - Upsert vectors to Pinecone (pinecone-sync-hook)
+ * - Send webhook notifications (webhook-alert-hook)
+ * - Update MCP resources (mcp-resource-hook)
+ */
+import type { Observation, ObservationType, ReconRole } from '../types.js';
+/**
+ * Filter criteria for when a hook should execute.
+ */
+export interface HookFilter {
+    /** Minimum confidence score to trigger */
+    minConfidence?: number;
+    /** Market conditions to match */
+    marketConditions?: string[];
+    /** Agent roles to match */
+    agentRoles?: ReconRole[];
+    /** Custom filter function */
+    customFilter?: (observation: Observation) => boolean;
+}
+/**
+ * Result of hook execution.
+ */
+export interface HookExecutionResult {
+    hookId: string;
+    hookName: string;
+    success: boolean;
+    durationMs: number;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Hook configuration and handler.
+ */
+export interface ObservationHook {
+    /** Unique hook identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Whether hook is active */
+    enabled: boolean;
+    /** Priority (higher = runs first) */
+    priority: number;
+    /** Observation types this hook processes */
+    observationTypes: ObservationType[];
+    /** Optional filter criteria */
+    filters?: HookFilter;
+    /** Handler function called for matching observations */
+    handler: (observation: Observation) => Promise<void>;
+    /** Optional cleanup function called on shutdown */
+    cleanup?: () => Promise<void>;
+}
+/**
+ * Registry for managing observation hooks.
+ */
+export declare class ObservationHookRegistry {
+    private hooks;
+    private executionStats;
+    /**
+     * Register a new hook.
+     */
+    register(hook: ObservationHook): void;
+    /**
+     * Unregister a hook.
+     */
+    unregister(hookId: string): Promise<void>;
+    /**
+     * Enable or disable a hook.
+     */
+    setEnabled(hookId: string, enabled: boolean): boolean;
+    /**
+     * Get a hook by ID.
+     */
+    getHook(hookId: string): ObservationHook | undefined;
+    /**
+     * Get all registered hooks.
+     */
+    getAllHooks(): ObservationHook[];
+    /**
+     * Get enabled hooks sorted by priority.
+     */
+    getEnabledHooks(): ObservationHook[];
+    /**
+     * Execute all matching hooks for an observation.
+     */
+    executeHooks(observation: Observation): Promise<HookExecutionResult[]>;
+    /**
+     * Check if observation passes hook filters.
+     */
+    private passesFilters;
+    /**
+     * Get execution statistics for a hook.
+     */
+    getStats(hookId: string): {
+        calls: number;
+        errors: number;
+        avgMs: number;
+    } | null;
+    /**
+     * Get all hook statistics.
+     */
+    getAllStats(): Map<string, {
+        calls: number;
+        errors: number;
+        avgMs: number;
+    }>;
+    /**
+     * Cleanup all hooks on shutdown.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Get the observation hook registry singleton.
+ */
+export declare function getObservationHookRegistry(): ObservationHookRegistry;
+/**
+ * Create a fresh registry (for testing).
+ */
+export declare function createObservationHookRegistry(): ObservationHookRegistry;
+/**
+ * Builder for creating hooks with fluent API.
+ */
+export declare class HookBuilder {
+    private hook;
+    /**
+     * Set hook ID.
+     */
+    id(id: string): this;
+    /**
+     * Set hook name.
+     */
+    name(name: string): this;
+    /**
+     * Set hook priority.
+     */
+    priority(priority: number): this;
+    /**
+     * Add observation types to handle.
+     */
+    forTypes(...types: ObservationType[]): this;
+    /**
+     * Add all observation types.
+     */
+    forAllTypes(): this;
+    /**
+     * Add filter for minimum confidence.
+     */
+    minConfidence(threshold: number): this;
+    /**
+     * Add filter for market conditions.
+     */
+    forMarketConditions(...conditions: string[]): this;
+    /**
+     * Add custom filter.
+     */
+    withFilter(filter: (obs: Observation) => boolean): this;
+    /**
+     * Set the handler function.
+     */
+    handler(fn: (observation: Observation) => Promise<void>): this;
+    /**
+     * Set cleanup function.
+     */
+    cleanup(fn: () => Promise<void>): this;
+    /**
+     * Build the hook.
+     */
+    build(): ObservationHook;
+}
+/**
+ * Create a new hook builder.
+ */
+export declare function createHook(): HookBuilder;
+//# sourceMappingURL=observation-hooks.d.ts.map

package/dist/swarm/hooks/observation-hooks.d.ts.map

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