agentdb 3.0.0-alpha.3 → 3.0.0-alpha.4

package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts

@@ -0,0 +1,135 @@
+/**
+ * E-Commerce Recommendations: Personalized Product Discovery
+ *
+ * Use Case: Recommend similar products based on user preferences,
+ * browsing history, and product embeddings.
+ *
+ * Optimization Priority: DIVERSITY + RELEVANCE
+ */
+import { UnifiedMetrics } from '../../types';
+export declare const ECOMMERCE_ATTENTION_CONFIG: {
+    heads: number;
+    forwardPassTargetMs: number;
+    batchSize: number;
+    precision: "float32";
+    diversityBoost: boolean;
+    clustering: {
+        algorithm: "louvain";
+        minModularity: number;
+        semanticPurity: number;
+        hierarchicalLevels: number;
+    };
+    dynamicK: {
+        min: number;
+        max: number;
+        adaptationStrategy: "user-engagement";
+    };
+};
+export interface ECommerceMetrics extends UnifiedMetrics {
+    clickThroughRate: number;
+    conversionRate: number;
+    diversityScore: number;
+    categoryBalanceScore: number;
+    userSatisfaction: number;
+}
+export interface Recommendation {
+    productId: string;
+    relevanceScore: number;
+    category: string;
+    cluster: string;
+    priceUSD: number;
+}
+export declare function recommendProducts(userProfile: Float32Array, // User preferences embeddings
+productCatalog: any, // HNSWGraph type
+userEngagement: number, applyAttention: (data: Float32Array, config: any) => Promise<Float32Array>, applyDiversityBoost: (candidates: any[], weight: number) => Promise<any[]>, clusterRecommendations: (items: any[], config: any) => Promise<any[]>, findCluster: (item: any, clusters: any[]) => string, diversityWeight?: number): Promise<Recommendation[]>;
+export declare const ECOMMERCE_PERFORMANCE_TARGETS: {
+    p95LatencyMs: number;
+    clickThroughRate: number;
+    conversionRate: number;
+    diversityScore: number;
+    uptimePercent: number;
+};
+export declare const ECOMMERCE_CONFIG_VARIATIONS: {
+    fashion: {
+        heads: number;
+        diversityBoost: boolean;
+        clustering: {
+            hierarchicalLevels: number;
+            algorithm: "louvain";
+            minModularity: number;
+            semanticPurity: number;
+        };
+        forwardPassTargetMs: number;
+        batchSize: number;
+        precision: "float32";
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "user-engagement";
+        };
+    };
+    electronics: {
+        heads: number;
+        specificationWeight: number;
+        diversityBoost: boolean;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        precision: "float32";
+        clustering: {
+            algorithm: "louvain";
+            minModularity: number;
+            semanticPurity: number;
+            hierarchicalLevels: number;
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "user-engagement";
+        };
+    };
+    grocery: {
+        heads: number;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "cart-size";
+        };
+        precision: "float32";
+        diversityBoost: boolean;
+        clustering: {
+            algorithm: "louvain";
+            minModularity: number;
+            semanticPurity: number;
+            hierarchicalLevels: number;
+        };
+    };
+    luxury: {
+        heads: number;
+        forwardPassTargetMs: number;
+        diversityBoost: boolean;
+        precision: "float32";
+        batchSize: number;
+        clustering: {
+            algorithm: "louvain";
+            minModularity: number;
+            semanticPurity: number;
+            hierarchicalLevels: number;
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "user-engagement";
+        };
+    };
+};
+export declare function adaptConfigToUserSegment(baseConfig: typeof ECOMMERCE_ATTENTION_CONFIG, segment: 'browser' | 'buyer' | 'loyal' | 'vip'): typeof ECOMMERCE_ATTENTION_CONFIG;
+export interface PromotionalContext {
+    isSale: boolean;
+    seasonalEvent: string | null;
+    inventoryPressure: number;
+}
+export declare function adaptConfigToPromotion(baseConfig: typeof ECOMMERCE_ATTENTION_CONFIG, context: PromotionalContext): typeof ECOMMERCE_ATTENTION_CONFIG;
+export declare function generateABTestConfigs(baseConfig: typeof ECOMMERCE_ATTENTION_CONFIG): Record<string, typeof ECOMMERCE_ATTENTION_CONFIG>;
+//# sourceMappingURL=e-commerce-recommendations.d.ts.map

package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e-commerce-recommendations.d.ts","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/e-commerce-recommendations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;CAqBtC,CAAC;AAGF,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAGD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,YAAY,EAAQ,8BAA8B;AAC/D,cAAc,EAAE,GAAG,EAAc,iBAAiB;AAClD,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1E,mBAAmB,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,EAC1E,sBAAsB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,EACrE,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,MAAM,EACnD,eAAe,GAAE,MAAY,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC,CAyB3B;AAGD,eAAO,MAAM,6BAA6B;;;;;;CAMzC,CAAC;AAGF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCvC,CAAC;AAGF,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,OAAO,0BAA0B,EAC7C,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAC7C,OAAO,0BAA0B,CA4BnC;AAGD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,OAAO,0BAA0B,EAC7C,OAAO,EAAE,kBAAkB,GAC1B,OAAO,0BAA0B,CAUnC;AAGD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,OAAO,0BAA0B,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,0BAA0B,CAAC,CAsBnD"}

package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js

@@ -0,0 +1,158 @@
+/**
+ * E-Commerce Recommendations: Personalized Product Discovery
+ *
+ * Use Case: Recommend similar products based on user preferences,
+ * browsing history, and product embeddings.
+ *
+ * Optimization Priority: DIVERSITY + RELEVANCE
+ */
+export const ECOMMERCE_ATTENTION_CONFIG = {
+    heads: 8, // Optimal for balanced performance
+    forwardPassTargetMs: 20, // 20ms acceptable for recommendations
+    batchSize: 64, // Batch user requests
+    precision: 'float32', // Full precision for quality
+    diversityBoost: true, // Promote diverse recommendations
+    // Louvain clustering for product categories
+    clustering: {
+        algorithm: 'louvain',
+        minModularity: 0.75, // High-quality clusters
+        semanticPurity: 0.87, // 87.2% purity validated
+        hierarchicalLevels: 3 // Category hierarchy (dept > category > subcategory)
+    },
+    // Dynamic-k based on user engagement
+    dynamicK: {
+        min: 10, // Minimum 10 recommendations
+        max: 50, // Maximum 50 for exploration
+        adaptationStrategy: 'user-engagement' // Active users get more
+    }
+};
+// Example: Product recommendation with diversity
+export async function recommendProducts(userProfile, // User preferences embeddings
+productCatalog, // HNSWGraph type
+userEngagement, applyAttention, applyDiversityBoost, clusterRecommendations, findCluster, diversityWeight = 0.3) {
+    const config = ECOMMERCE_ATTENTION_CONFIG;
+    // 8-head attention for user query enhancement
+    const enhanced = await applyAttention(userProfile, config);
+    // Dynamic-k based on user engagement (engaged users get more options)
+    const k = Math.round(10 + userEngagement * 40); // 10-50 range
+    // Search with clustering for category diversity
+    const candidates = await productCatalog.search(enhanced, k);
+    // Apply diversity boost (promote different categories)
+    const diversified = await applyDiversityBoost(candidates, diversityWeight);
+    // Cluster recommendations by category (Louvain)
+    const clusters = await clusterRecommendations(diversified, config.clustering);
+    return diversified.map((p) => ({
+        productId: p.id,
+        relevanceScore: p.score,
+        category: p.metadata.category,
+        cluster: findCluster(p, clusters),
+        priceUSD: p.metadata.price
+    }));
+}
+// Performance targets for e-commerce
+export const ECOMMERCE_PERFORMANCE_TARGETS = {
+    p95LatencyMs: 50, // 50ms p95 (user experience)
+    clickThroughRate: 0.15, // 15% CTR target
+    conversionRate: 0.05, // 5% conversion target
+    diversityScore: 0.7, // 70% category diversity
+    uptimePercent: 99.9 // 99.9% uptime (3 nines)
+};
+// E-commerce platform-specific configurations
+export const ECOMMERCE_CONFIG_VARIATIONS = {
+    // Fashion/apparel (high visual similarity)
+    fashion: {
+        ...ECOMMERCE_ATTENTION_CONFIG,
+        heads: 12, // More heads for visual nuance
+        diversityBoost: true,
+        clustering: {
+            ...ECOMMERCE_ATTENTION_CONFIG.clustering,
+            hierarchicalLevels: 4 // Deeper taxonomy (category > subcategory > style > color)
+        }
+    },
+    // Electronics (specification-driven)
+    electronics: {
+        ...ECOMMERCE_ATTENTION_CONFIG,
+        heads: 8,
+        specificationWeight: 0.6, // Emphasize specs over style
+        diversityBoost: false // Users want specific features
+    },
+    // Grocery (frequent purchases)
+    grocery: {
+        ...ECOMMERCE_ATTENTION_CONFIG,
+        heads: 6,
+        forwardPassTargetMs: 10, // Faster for mobile
+        batchSize: 128, // High volume
+        dynamicK: { min: 15, max: 30, adaptationStrategy: 'cart-size' }
+    },
+    // Luxury goods (personalization critical)
+    luxury: {
+        ...ECOMMERCE_ATTENTION_CONFIG,
+        heads: 16, // Maximum personalization
+        forwardPassTargetMs: 50, // Allow more time
+        diversityBoost: false, // Highly targeted
+        precision: 'float32'
+    }
+};
+// User segment adaptations
+export function adaptConfigToUserSegment(baseConfig, segment) {
+    switch (segment) {
+        case 'browser':
+            return {
+                ...baseConfig,
+                dynamicK: { ...baseConfig.dynamicK, min: 20, max: 50 }, // More exploration
+                diversityBoost: true // Show variety
+            };
+        case 'buyer':
+            return {
+                ...baseConfig,
+                dynamicK: { ...baseConfig.dynamicK, min: 10, max: 30 }, // Focused recommendations
+                diversityBoost: false
+            };
+        case 'loyal':
+            return {
+                ...baseConfig,
+                heads: 12, // Better personalization
+                dynamicK: { ...baseConfig.dynamicK, min: 15, max: 40 }
+            };
+        case 'vip':
+            return {
+                ...baseConfig,
+                heads: 16, // Maximum personalization
+                forwardPassTargetMs: 30,
+                precision: 'float32'
+            };
+    }
+}
+export function adaptConfigToPromotion(baseConfig, context) {
+    if (context.isSale) {
+        return {
+            ...baseConfig,
+            dynamicK: { ...baseConfig.dynamicK, min: 20, max: 60 }, // Show more options
+            diversityBoost: true // Cross-sell opportunities
+            // Note: Sale boost handled in ranking layer
+        };
+    }
+    return baseConfig;
+}
+// A/B testing configuration generator
+export function generateABTestConfigs(baseConfig) {
+    return {
+        control: baseConfig,
+        moreHeads: {
+            ...baseConfig,
+            heads: 12
+        },
+        moreDiversity: {
+            ...baseConfig,
+            diversityBoost: true,
+            dynamicK: { ...baseConfig.dynamicK, min: 15, max: 60 }
+        },
+        fasterLatency: {
+            ...baseConfig,
+            heads: 6,
+            forwardPassTargetMs: 10,
+            precision: 'float32' // Lower precision not yet supported
+        }
+    };
+}
+//# sourceMappingURL=e-commerce-recommendations.js.map

package/dist/simulation/scenarios/domain-examples/e-commerce-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e-commerce-recommendations.js","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/e-commerce-recommendations.ts"],"names":[],"mappings":"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"}

package/dist/simulation/scenarios/domain-examples/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Domain-Specific Attention Configuration Examples
+ *
+ * This module exports real-world configurations and examples for various industries
+ * and use cases, demonstrating how to adapt AgentDB's attention mechanisms for
+ * specific requirements.
+ */
+export { TRADING_ATTENTION_CONFIG, TRADING_PERFORMANCE_TARGETS, TRADING_CONFIG_VARIATIONS, type TradingMetrics, type TradingSignal, matchTradingPattern, adaptConfigToMarket } from './trading-systems';
+export { MEDICAL_ATTENTION_CONFIG, MEDICAL_PERFORMANCE_TARGETS, MEDICAL_CONFIG_VARIATIONS, type MedicalMetrics, type SimilarCase, type MedicalDataQuality, findSimilarCases, adaptConfigToUrgency, validateMedicalData } from './medical-imaging';
+export { ROBOTICS_ATTENTION_CONFIG, ROBOTICS_PERFORMANCE_TARGETS, ROBOTICS_CONFIG_VARIATIONS, type RoboticsMetrics, type RobotContext, type NavigationPlan, matchEnvironment, adaptConfigToEnvironment, adaptConfigToPower } from './robotics-navigation';
+export { ECOMMERCE_ATTENTION_CONFIG, ECOMMERCE_PERFORMANCE_TARGETS, ECOMMERCE_CONFIG_VARIATIONS, type ECommerceMetrics, type Recommendation, type PromotionalContext, recommendProducts, adaptConfigToUserSegment, adaptConfigToPromotion, generateABTestConfigs } from './e-commerce-recommendations';
+export { RESEARCH_ATTENTION_CONFIG, RESEARCH_PERFORMANCE_TARGETS, RESEARCH_CONFIG_VARIATIONS, type ResearchMetrics, type ResearchConnection, type CitationNetworkMetrics, discoverRelatedResearch, adaptConfigToSearchMode, adaptConfigToResearchStage, analyzeCitationNetwork } from './scientific-research';
+export { IOT_ATTENTION_CONFIG, IOT_PERFORMANCE_TARGETS, IOT_CONFIG_VARIATIONS, type IoTMetrics, type Sensor, type AnomalyAlert, type NetworkTopology, detectAnomalies, adaptConfigToDeployment, adaptConfigToBattery, adaptConfigToTopology } from './iot-sensor-networks';
+//# sourceMappingURL=index.d.ts.map

package/dist/simulation/scenarios/domain-examples/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC"}

package/dist/simulation/scenarios/domain-examples/index.js

@@ -0,0 +1,14 @@
+/**
+ * Domain-Specific Attention Configuration Examples
+ *
+ * This module exports real-world configurations and examples for various industries
+ * and use cases, demonstrating how to adapt AgentDB's attention mechanisms for
+ * specific requirements.
+ */
+export { TRADING_ATTENTION_CONFIG, TRADING_PERFORMANCE_TARGETS, TRADING_CONFIG_VARIATIONS, matchTradingPattern, adaptConfigToMarket } from './trading-systems';
+export { MEDICAL_ATTENTION_CONFIG, MEDICAL_PERFORMANCE_TARGETS, MEDICAL_CONFIG_VARIATIONS, findSimilarCases, adaptConfigToUrgency, validateMedicalData } from './medical-imaging';
+export { ROBOTICS_ATTENTION_CONFIG, ROBOTICS_PERFORMANCE_TARGETS, ROBOTICS_CONFIG_VARIATIONS, matchEnvironment, adaptConfigToEnvironment, adaptConfigToPower } from './robotics-navigation';
+export { ECOMMERCE_ATTENTION_CONFIG, ECOMMERCE_PERFORMANCE_TARGETS, ECOMMERCE_CONFIG_VARIATIONS, recommendProducts, adaptConfigToUserSegment, adaptConfigToPromotion, generateABTestConfigs } from './e-commerce-recommendations';
+export { RESEARCH_ATTENTION_CONFIG, RESEARCH_PERFORMANCE_TARGETS, RESEARCH_CONFIG_VARIATIONS, discoverRelatedResearch, adaptConfigToSearchMode, adaptConfigToResearchStage, analyzeCitationNetwork } from './scientific-research';
+export { IOT_ATTENTION_CONFIG, IOT_PERFORMANCE_TARGETS, IOT_CONFIG_VARIATIONS, detectAnomalies, adaptConfigToDeployment, adaptConfigToBattery, adaptConfigToTopology } from './iot-sensor-networks';
+//# sourceMappingURL=index.js.map

package/dist/simulation/scenarios/domain-examples/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EAGzB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EAIzB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAI1B,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAI3B,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAI1B,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EAKrB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC"}

package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts

@@ -0,0 +1,178 @@
+/**
+ * IoT Sensor Networks: Distributed Anomaly Detection
+ *
+ * Use Case: Real-time anomaly detection in IoT sensor networks
+ * with limited compute resources.
+ *
+ * Optimization Priority: POWER EFFICIENCY + LATENCY
+ */
+import { UnifiedMetrics } from '../../types';
+export declare const IOT_ATTENTION_CONFIG: {
+    heads: number;
+    forwardPassTargetMs: number;
+    batchSize: number;
+    precision: "int8";
+    edgeOptimized: boolean;
+    powerBudgetMw: number;
+    hypergraph: {
+        enabled: boolean;
+        maxHyperedgeSize: number;
+        compressionRatio: number;
+        distributedProcessing: boolean;
+    };
+    dynamicK: {
+        min: number;
+        max: number;
+        adaptationStrategy: "anomaly-severity";
+    };
+    selfHealing: {
+        enabled: boolean;
+        adaptationIntervalMs: number;
+        degradationThreshold: number;
+        networkResilience: boolean;
+    };
+};
+export interface IoTMetrics extends UnifiedMetrics {
+    anomalyDetectionRate: number;
+    falseAlarmRate: number;
+    powerConsumptionMw: number;
+    networkLatencyMs: number;
+    sensorCoverage: number;
+}
+export interface Sensor {
+    id: string;
+    reading: Float32Array;
+    timestamp: number;
+    batteryPercent: number;
+}
+export interface AnomalyAlert {
+    sensorId: string;
+    anomalyScore: number;
+    severity: 'warning' | 'critical';
+    correlatedSensors: string[];
+    timestamp: number;
+    latencyMs: number;
+}
+export declare function detectAnomalies(sensorReading: Float32Array & {
+    id: string;
+}, normalPatterns: any, // HNSWGraph type
+neighborSensors: Sensor[], applyAttention: (data: Float32Array, config: any) => Promise<Float32Array>, createHyperedge: (readings: Float32Array[]) => Promise<Float32Array>, severityThreshold?: number): Promise<AnomalyAlert[]>;
+export declare const IOT_PERFORMANCE_TARGETS: {
+    p50LatencyMs: number;
+    anomalyDetectionRate: number;
+    falseAlarmRate: number;
+    powerConsumptionMw: number;
+    uptimePercent: number;
+};
+export declare const IOT_CONFIG_VARIATIONS: {
+    esp32: {
+        heads: number;
+        precision: "int8";
+        powerBudgetMw: number;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        hypergraph: {
+            enabled: boolean;
+            maxHyperedgeSize: number;
+            compressionRatio: number;
+            distributedProcessing: boolean;
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "anomaly-severity";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            networkResilience: boolean;
+        };
+    };
+    raspberryPi: {
+        heads: number;
+        precision: "float16";
+        powerBudgetMw: number;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        hypergraph: {
+            enabled: boolean;
+            maxHyperedgeSize: number;
+            compressionRatio: number;
+            distributedProcessing: boolean;
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "anomaly-severity";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            networkResilience: boolean;
+        };
+    };
+    jetsonNano: {
+        heads: number;
+        precision: "float16";
+        powerBudgetMw: number;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        hypergraph: {
+            enabled: boolean;
+            maxHyperedgeSize: number;
+            compressionRatio: number;
+            distributedProcessing: boolean;
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "anomaly-severity";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            networkResilience: boolean;
+        };
+    };
+    coralTPU: {
+        heads: number;
+        precision: "int8";
+        powerBudgetMw: number;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        hypergraph: {
+            enabled: boolean;
+            maxHyperedgeSize: number;
+            compressionRatio: number;
+            distributedProcessing: boolean;
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "anomaly-severity";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            networkResilience: boolean;
+        };
+    };
+};
+export declare function adaptConfigToDeployment(baseConfig: typeof IOT_ATTENTION_CONFIG, environment: 'urban' | 'industrial' | 'agricultural' | 'remote'): typeof IOT_ATTENTION_CONFIG;
+export declare function adaptConfigToBattery(baseConfig: typeof IOT_ATTENTION_CONFIG, batteryPercent: number, chargingStatus: 'charging' | 'discharging' | 'solar'): typeof IOT_ATTENTION_CONFIG;
+export interface NetworkTopology {
+    nodeCount: number;
+    averageDegree: number;
+    meshDensity: number;
+    gatewayDistance: number;
+}
+export declare function adaptConfigToTopology(baseConfig: typeof IOT_ATTENTION_CONFIG, topology: NetworkTopology): typeof IOT_ATTENTION_CONFIG;
+//# sourceMappingURL=iot-sensor-networks.d.ts.map

package/dist/simulation/scenarios/domain-examples/iot-sensor-networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iot-sensor-networks.d.ts","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/iot-sensor-networks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;CA8BhC,CAAC;AAGF,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAsB,eAAe,CACnC,aAAa,EAAE,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC5C,cAAc,EAAE,GAAG,EAAc,iBAAiB;AAClD,eAAe,EAAE,MAAM,EAAE,EACzB,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1E,eAAe,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,EACpE,iBAAiB,GAAE,MAAY,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CAmCzB;AAGD,eAAO,MAAM,uBAAuB;;;;;;CAMnC,CAAC;AAGF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCjC,CAAC;AAGF,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,OAAO,oBAAoB,EACvC,WAAW,EAAE,OAAO,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,GAC9D,OAAO,oBAAoB,CAqC7B;AAGD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,OAAO,oBAAoB,EACvC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,UAAU,GAAG,aAAa,GAAG,OAAO,GACnD,OAAO,oBAAoB,CAoC7B;AAGD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,OAAO,oBAAoB,EACvC,QAAQ,EAAE,eAAe,GACxB,OAAO,oBAAoB,CA0B7B"}