agentdb 1.6.1 → 2.0.0-alpha.2

package/dist/simulation/scenarios/domain-examples/robotics-navigation.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Robotics Navigation: Adaptive Real-Time Path Planning
+ *
+ * Use Case: Autonomous robots need real-time similarity search
+ * for environment matching and obstacle avoidance.
+ *
+ * Optimization Priority: BALANCED (latency + accuracy)
+ */
+import { UnifiedMetrics } from '../../types';
+export declare const ROBOTICS_ATTENTION_CONFIG: {
+    heads: number;
+    forwardPassTargetMs: number;
+    batchSize: number;
+    precision: "float16";
+    edgeOptimized: boolean;
+    dynamicHeads: {
+        enabled: boolean;
+        simple: number;
+        complex: number;
+        adaptationStrategy: "scene-complexity";
+    };
+    dynamicK: {
+        min: number;
+        max: number;
+        adaptationStrategy: "obstacle-density";
+    };
+    selfHealing: {
+        enabled: boolean;
+        adaptationIntervalMs: number;
+        degradationThreshold: number;
+        hardwareMonitoring: boolean;
+    };
+};
+export interface RoboticsMetrics extends UnifiedMetrics {
+    controlLoopLatencyMs: number;
+    navigationAccuracy: number;
+    obstacleDetectionRate: number;
+    powerConsumptionW: number;
+    temperatureCelsius: number;
+}
+export interface RobotContext {
+    velocity: number;
+    batteryPercent: number;
+    temperatureCelsius: number;
+    missionCriticality: 'low' | 'medium' | 'high';
+}
+export interface NavigationPlan {
+    bestMatch: any;
+    suggestedPath: any;
+    confidence: number;
+    latencyMs: number;
+}
+export declare function matchEnvironment(currentSensorData: Float32Array, // LIDAR, camera, IMU
+knownEnvironments: any, // HNSWGraph type
+robotContext: RobotContext, applyAttention: (data: Float32Array, config: any) => Promise<Float32Array>, analyzeSceneComplexity: (data: Float32Array) => number, calculateObstacleDensity: (data: Float32Array) => number, computePath: (matches: any[]) => any): Promise<NavigationPlan>;
+export declare const ROBOTICS_PERFORMANCE_TARGETS: {
+    controlLoopLatencyMs: number;
+    navigationAccuracy: number;
+    p99LatencyMs: number;
+    powerConsumptionW: number;
+    uptimePercent: number;
+};
+export declare const ROBOTICS_CONFIG_VARIATIONS: {
+    highPerformance: {
+        heads: number;
+        forwardPassTargetMs: number;
+        precision: "float32";
+        powerConsumptionW: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        dynamicHeads: {
+            enabled: boolean;
+            simple: number;
+            complex: number;
+            adaptationStrategy: "scene-complexity";
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "obstacle-density";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            hardwareMonitoring: boolean;
+        };
+    };
+    consumerDrone: {
+        heads: number;
+        forwardPassTargetMs: number;
+        precision: "float16";
+        powerConsumptionW: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        dynamicHeads: {
+            enabled: boolean;
+            simple: number;
+            complex: number;
+            adaptationStrategy: "scene-complexity";
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "obstacle-density";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            hardwareMonitoring: boolean;
+        };
+    };
+    industrialAGV: {
+        heads: number;
+        forwardPassTargetMs: number;
+        precision: "float32";
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "warehouse-density";
+        };
+        batchSize: number;
+        edgeOptimized: boolean;
+        dynamicHeads: {
+            enabled: boolean;
+            simple: number;
+            complex: number;
+            adaptationStrategy: "scene-complexity";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            hardwareMonitoring: boolean;
+        };
+    };
+    embedded: {
+        heads: number;
+        forwardPassTargetMs: number;
+        precision: "int8";
+        powerConsumptionW: number;
+        batchSize: number;
+        edgeOptimized: boolean;
+        dynamicHeads: {
+            enabled: boolean;
+            simple: number;
+            complex: number;
+            adaptationStrategy: "scene-complexity";
+        };
+        dynamicK: {
+            min: number;
+            max: number;
+            adaptationStrategy: "obstacle-density";
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            hardwareMonitoring: boolean;
+        };
+    };
+};
+export declare function adaptConfigToEnvironment(baseConfig: typeof ROBOTICS_ATTENTION_CONFIG, environment: 'indoor' | 'outdoor' | 'underground' | 'aerial'): typeof ROBOTICS_ATTENTION_CONFIG;
+export declare function adaptConfigToPower(baseConfig: typeof ROBOTICS_ATTENTION_CONFIG, batteryPercent: number): typeof ROBOTICS_ATTENTION_CONFIG;
+//# sourceMappingURL=robotics-navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"robotics-navigation.d.ts","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/robotics-navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CA6BrC,CAAC;AAGF,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC/C;AAGD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,GAAG,CAAC;IACf,aAAa,EAAE,GAAG,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAsB,gBAAgB,CACpC,iBAAiB,EAAE,YAAY,EAAG,qBAAqB;AACvD,iBAAiB,EAAE,GAAG,EAAY,iBAAiB;AACnD,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1E,sBAAsB,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,EACtD,wBAAwB,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,EACxD,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,GAAG,GACnC,OAAO,CAAC,cAAc,CAAC,CA2BzB;AAGD,eAAO,MAAM,4BAA4B;;;;;;CAMxC,CAAC;AAGF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtC,CAAC;AAGF,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,OAAO,yBAAyB,EAC5C,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAC3D,OAAO,yBAAyB,CA8BlC;AAGD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,yBAAyB,EAC5C,cAAc,EAAE,MAAM,GACrB,OAAO,yBAAyB,CAoBlC"}

package/dist/simulation/scenarios/domain-examples/robotics-navigation.js

@@ -0,0 +1,161 @@
+/**
+ * Robotics Navigation: Adaptive Real-Time Path Planning
+ *
+ * Use Case: Autonomous robots need real-time similarity search
+ * for environment matching and obstacle avoidance.
+ *
+ * Optimization Priority: BALANCED (latency + accuracy)
+ */
+export const ROBOTICS_ATTENTION_CONFIG = {
+    heads: 8, // Optimal balance (validated)
+    forwardPassTargetMs: 10, // 10ms for 100Hz control loop
+    batchSize: 4, // Small batches for real-time
+    precision: 'float16', // Reduced precision for edge devices
+    edgeOptimized: true, // NVIDIA Jetson, Intel NCS optimization
+    // Dynamic attention based on environment complexity
+    dynamicHeads: {
+        enabled: true,
+        simple: 4, // 4 heads for simple environments
+        complex: 12, // 12 heads for complex scenes
+        adaptationStrategy: 'scene-complexity'
+    },
+    // Dynamic-k based on navigation context
+    dynamicK: {
+        min: 5,
+        max: 20,
+        adaptationStrategy: 'obstacle-density' // More obstacles = more candidates
+    },
+    // Self-healing for continuous operation
+    selfHealing: {
+        enabled: true,
+        adaptationIntervalMs: 100,
+        degradationThreshold: 0.05,
+        hardwareMonitoring: true // Battery, temperature, GPU
+    }
+};
+// Example: Environment matching for navigation
+export async function matchEnvironment(currentSensorData, // LIDAR, camera, IMU
+knownEnvironments, // HNSWGraph type
+robotContext, applyAttention, analyzeSceneComplexity, calculateObstacleDensity, computePath) {
+    const startTime = Date.now();
+    const config = ROBOTICS_ATTENTION_CONFIG;
+    // Adaptive attention based on scene complexity
+    const sceneComplexity = analyzeSceneComplexity(currentSensorData);
+    const adaptiveHeads = sceneComplexity > 0.7 ? 12 : 4;
+    // Apply attention with adaptive heads
+    const enhanced = await applyAttention(currentSensorData, {
+        ...config,
+        heads: adaptiveHeads
+    });
+    // Dynamic-k based on obstacle density
+    const obstacleDensity = calculateObstacleDensity(currentSensorData);
+    const k = Math.round(5 + obstacleDensity * 15); // 5-20 range
+    // Search for similar environments
+    const matches = await knownEnvironments.search(enhanced, k);
+    return {
+        bestMatch: matches[0],
+        suggestedPath: computePath(matches),
+        confidence: matches[0].score,
+        latencyMs: Date.now() - startTime // Track real-time performance
+    };
+}
+// Performance targets for robotics
+export const ROBOTICS_PERFORMANCE_TARGETS = {
+    controlLoopLatencyMs: 10, // 10ms for 100Hz control
+    navigationAccuracy: 0.95, // 95% path planning accuracy
+    p99LatencyMs: 15, // 15ms p99 (real-time critical)
+    powerConsumptionW: 20, // 20W max (battery life)
+    uptimePercent: 99.0 // 99% uptime (2 nines, field operation)
+};
+// Robot platform-specific configurations
+export const ROBOTICS_CONFIG_VARIATIONS = {
+    // High-performance robots (Boston Dynamics Spot, ANYmal)
+    highPerformance: {
+        ...ROBOTICS_ATTENTION_CONFIG,
+        heads: 12,
+        forwardPassTargetMs: 5, // 5ms for 200Hz control
+        precision: 'float32', // Full precision available
+        powerConsumptionW: 100 // Higher power budget
+    },
+    // Consumer drones (DJI, Parrot)
+    consumerDrone: {
+        ...ROBOTICS_ATTENTION_CONFIG,
+        heads: 6,
+        forwardPassTargetMs: 20, // 50Hz control acceptable
+        precision: 'float16',
+        powerConsumptionW: 15 // Battery constrained
+    },
+    // Industrial AGVs (warehouse robots)
+    industrialAGV: {
+        ...ROBOTICS_ATTENTION_CONFIG,
+        heads: 8,
+        forwardPassTargetMs: 15,
+        precision: 'float32',
+        dynamicK: { min: 10, max: 30, adaptationStrategy: 'warehouse-density' }
+    },
+    // Embedded robots (Raspberry Pi, Arduino)
+    embedded: {
+        ...ROBOTICS_ATTENTION_CONFIG,
+        heads: 4,
+        forwardPassTargetMs: 50, // Slower acceptable
+        precision: 'int8', // Quantized for embedded
+        powerConsumptionW: 5 // Very power constrained
+    }
+};
+// Environment adaptation
+export function adaptConfigToEnvironment(baseConfig, environment) {
+    switch (environment) {
+        case 'indoor':
+            return {
+                ...baseConfig,
+                heads: 8,
+                dynamicK: { ...baseConfig.dynamicK, min: 5, max: 15 }
+            };
+        case 'outdoor':
+            return {
+                ...baseConfig,
+                heads: 10, // More complexity
+                dynamicK: { ...baseConfig.dynamicK, min: 10, max: 25 },
+                selfHealing: { ...baseConfig.selfHealing, adaptationIntervalMs: 50 }
+            };
+        case 'underground':
+            return {
+                ...baseConfig,
+                heads: 6, // Limited sensors
+                forwardPassTargetMs: 15
+                // Note: Network resilience handled at transport layer
+            };
+        case 'aerial':
+            return {
+                ...baseConfig,
+                heads: 12, // Complex 3D navigation
+                forwardPassTargetMs: 8,
+                dynamicK: { ...baseConfig.dynamicK, min: 8, max: 20 }
+            };
+    }
+}
+// Power-aware configuration adjustment
+export function adaptConfigToPower(baseConfig, batteryPercent) {
+    if (batteryPercent < 20) {
+        // Critical battery - minimize computation
+        return {
+            ...baseConfig,
+            heads: 4,
+            batchSize: 1
+            // Note: Precision optimization coming in future release
+        };
+    }
+    else if (batteryPercent < 50) {
+        // Low battery - reduce quality slightly
+        return {
+            ...baseConfig,
+            heads: 6,
+            precision: 'float16'
+        };
+    }
+    else {
+        // Normal operation
+        return baseConfig;
+    }
+}
+//# sourceMappingURL=robotics-navigation.js.map

package/dist/simulation/scenarios/domain-examples/robotics-navigation.js.map

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

package/dist/simulation/scenarios/domain-examples/scientific-research.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Scientific Research: Research Paper Similarity and Discovery
+ *
+ * Use Case: Find similar research papers, identify research trends,
+ * and discover cross-domain connections.
+ *
+ * Optimization Priority: QUALITY + CROSS-DOMAIN DISCOVERY
+ */
+import { UnifiedMetrics } from '../../types';
+export declare const RESEARCH_ATTENTION_CONFIG: {
+    heads: number;
+    forwardPassTargetMs: number;
+    batchSize: number;
+    precision: "float32";
+    crossDomainDiscovery: boolean;
+    clustering: {
+        algorithm: "hierarchical";
+        linkage: "ward";
+        hierarchicalLevels: number;
+        semanticPurity: number;
+    };
+    recallTarget: number;
+    selfHealing: {
+        enabled: boolean;
+        adaptationIntervalMs: number;
+        degradationThreshold: number;
+        taxonomyUpdates: boolean;
+    };
+};
+export interface ResearchMetrics extends UnifiedMetrics {
+    crossDomainConnections: number;
+    citationAccuracy: number;
+    taxonomyQuality: number;
+    noveltyScore: number;
+    expertAgreement: number;
+}
+export interface ResearchConnection {
+    paperId: string;
+    title: string;
+    authors: string[];
+    similarity: number;
+    domain: string;
+    crossDomainConnection?: {
+        targetDomain: string;
+        connectionType: string;
+        noveltyScore: number;
+    };
+    citations: number;
+}
+export declare function discoverRelatedResearch(paperEmbedding: Float32Array, // Paper abstract + citations embeddings
+researchCorpus: any, // HNSWGraph type
+applyAttention: (data: Float32Array, config: any) => Promise<Float32Array>, buildResearchTaxonomy: (papers: any[], config: any) => Promise<any>, findCrossDomainConnections: (papers: any[], taxonomy: any) => Promise<any[]>, findDomain: (paper: any, taxonomy: any) => string, includeCrossDomain?: boolean): Promise<ResearchConnection[]>;
+export declare const RESEARCH_PERFORMANCE_TARGETS: {
+    recallAt100: number;
+    p95LatencyMs: number;
+    crossDomainRate: number;
+    expertAgreement: number;
+    uptimePercent: number;
+};
+export declare const RESEARCH_CONFIG_VARIATIONS: {
+    computerScience: {
+        heads: number;
+        forwardPassTargetMs: number;
+        batchSize: number;
+        recallTarget: number;
+        precision: "float32";
+        crossDomainDiscovery: boolean;
+        clustering: {
+            algorithm: "hierarchical";
+            linkage: "ward";
+            hierarchicalLevels: number;
+            semanticPurity: number;
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            taxonomyUpdates: boolean;
+        };
+    };
+    medicine: {
+        heads: number;
+        forwardPassTargetMs: number;
+        recallTarget: number;
+        precision: "float32";
+        batchSize: number;
+        crossDomainDiscovery: boolean;
+        clustering: {
+            algorithm: "hierarchical";
+            linkage: "ward";
+            hierarchicalLevels: number;
+            semanticPurity: number;
+        };
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            taxonomyUpdates: boolean;
+        };
+    };
+    physics: {
+        heads: number;
+        crossDomainDiscovery: boolean;
+        clustering: {
+            hierarchicalLevels: number;
+            algorithm: "hierarchical";
+            linkage: "ward";
+            semanticPurity: number;
+        };
+        forwardPassTargetMs: number;
+        batchSize: number;
+        precision: "float32";
+        recallTarget: number;
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            taxonomyUpdates: boolean;
+        };
+    };
+    socialSciences: {
+        heads: number;
+        crossDomainDiscovery: boolean;
+        clustering: {
+            semanticPurity: number;
+            algorithm: "hierarchical";
+            linkage: "ward";
+            hierarchicalLevels: number;
+        };
+        forwardPassTargetMs: number;
+        batchSize: number;
+        precision: "float32";
+        recallTarget: number;
+        selfHealing: {
+            enabled: boolean;
+            adaptationIntervalMs: number;
+            degradationThreshold: number;
+            taxonomyUpdates: boolean;
+        };
+    };
+};
+export declare function adaptConfigToSearchMode(baseConfig: typeof RESEARCH_ATTENTION_CONFIG, mode: 'literature-review' | 'novelty-discovery' | 'citation-tracing' | 'interdisciplinary'): typeof RESEARCH_ATTENTION_CONFIG;
+export declare function adaptConfigToResearchStage(baseConfig: typeof RESEARCH_ATTENTION_CONFIG, stage: 'initial-exploration' | 'hypothesis-formation' | 'validation' | 'writing'): typeof RESEARCH_ATTENTION_CONFIG;
+export interface CitationNetworkMetrics {
+    networkDensity: number;
+    clusteringCoefficient: number;
+    averagePathLength: number;
+    communityModularity: number;
+}
+export declare function analyzeCitationNetwork(papers: ResearchConnection[]): CitationNetworkMetrics;
+//# sourceMappingURL=scientific-research.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scientific-research.d.ts","sourceRoot":"","sources":["../../../../simulation/scenarios/domain-examples/scientific-research.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;CAyBrC,CAAC;AAGF,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,YAAY,EAAK,wCAAwC;AACzE,cAAc,EAAE,GAAG,EAAc,iBAAiB;AAClD,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,YAAY,CAAC,EAC1E,qBAAqB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACnE,0BAA0B,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,EAC5E,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,MAAM,EACjD,kBAAkB,GAAE,OAAc,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0B/B;AAGD,eAAO,MAAM,4BAA4B;;;;;;CAMxC,CAAC;AAGF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCtC,CAAC;AAGF,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,OAAO,yBAAyB,EAC5C,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,GACzF,OAAO,yBAAyB,CAuClC;AAGD,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,OAAO,yBAAyB,EAC5C,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,GAAG,YAAY,GAAG,SAAS,GAC/E,OAAO,yBAAyB,CA+BlC;AAGD,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,sBAAsB,CAQ3F"}

package/dist/simulation/scenarios/domain-examples/scientific-research.js

@@ -0,0 +1,187 @@
+/**
+ * Scientific Research: Research Paper Similarity and Discovery
+ *
+ * Use Case: Find similar research papers, identify research trends,
+ * and discover cross-domain connections.
+ *
+ * Optimization Priority: QUALITY + CROSS-DOMAIN DISCOVERY
+ */
+export const RESEARCH_ATTENTION_CONFIG = {
+    heads: 12, // High-quality attention (more than 8-head optimal)
+    forwardPassTargetMs: 100, // 100ms acceptable (research workflow)
+    batchSize: 128, // Large batches for corpus processing
+    precision: 'float32', // Full precision for scientific data
+    crossDomainDiscovery: true, // Enable cross-field connections
+    // Hierarchical clustering for research topics
+    clustering: {
+        algorithm: 'hierarchical', // Better for taxonomy
+        linkage: 'ward', // Ward's minimum variance
+        hierarchicalLevels: 5, // Deep taxonomy (field > subfield > topic > subtopic > specific)
+        semanticPurity: 0.90 // High purity for research domains
+    },
+    // High-recall for comprehensive literature review
+    recallTarget: 0.98, // 98% recall (don't miss relevant papers)
+    // Self-organizing for evolving research landscape
+    selfHealing: {
+        enabled: true,
+        adaptationIntervalMs: 60000, // 1-minute adaptation (not real-time)
+        degradationThreshold: 0.03, // 3% tolerance
+        taxonomyUpdates: true // Update research taxonomy
+    }
+};
+// Example: Research paper discovery with cross-domain connections
+export async function discoverRelatedResearch(paperEmbedding, // Paper abstract + citations embeddings
+researchCorpus, // HNSWGraph type
+applyAttention, buildResearchTaxonomy, findCrossDomainConnections, findDomain, includeCrossDomain = true) {
+    const config = RESEARCH_ATTENTION_CONFIG;
+    // 12-head attention for nuanced understanding
+    const enhanced = await applyAttention(paperEmbedding, config);
+    // High-recall search (k=100 for comprehensive review)
+    const candidates = await researchCorpus.search(enhanced, 100);
+    // Hierarchical clustering for taxonomy
+    const taxonomy = await buildResearchTaxonomy(candidates, config.clustering);
+    // Cross-domain discovery (find connections across fields)
+    const crossDomain = includeCrossDomain
+        ? await findCrossDomainConnections(candidates, taxonomy)
+        : [];
+    return candidates.map((p) => ({
+        paperId: p.id,
+        title: p.metadata.title,
+        authors: p.metadata.authors,
+        similarity: p.score,
+        domain: findDomain(p, taxonomy),
+        crossDomainConnection: crossDomain.find((c) => c.paperId === p.id),
+        citations: p.metadata.citations
+    }));
+}
+// Performance targets for research
+export const RESEARCH_PERFORMANCE_TARGETS = {
+    recallAt100: 0.98, // 98% recall (comprehensive)
+    p95LatencyMs: 200, // 200ms p95 (batch processing)
+    crossDomainRate: 0.15, // 15% cross-domain discoveries
+    expertAgreement: 0.85, // 85% agreement with experts
+    uptimePercent: 99.0 // 99% uptime (2 nines)
+};
+// Research field-specific configurations
+export const RESEARCH_CONFIG_VARIATIONS = {
+    // Computer science (fast-moving field, many papers)
+    computerScience: {
+        ...RESEARCH_ATTENTION_CONFIG,
+        heads: 10,
+        forwardPassTargetMs: 50, // Faster for large corpus
+        batchSize: 256,
+        recallTarget: 0.97 // Slightly lower for speed
+    },
+    // Medicine (high precision required, slower pace)
+    medicine: {
+        ...RESEARCH_ATTENTION_CONFIG,
+        heads: 16, // Maximum quality
+        forwardPassTargetMs: 150,
+        recallTarget: 0.99, // Highest recall
+        precision: 'float32'
+    },
+    // Physics (mathematical precision, cross-domain links)
+    physics: {
+        ...RESEARCH_ATTENTION_CONFIG,
+        heads: 14,
+        crossDomainDiscovery: true,
+        clustering: {
+            ...RESEARCH_ATTENTION_CONFIG.clustering,
+            hierarchicalLevels: 6 // Deeper for specialized subfields
+        }
+    },
+    // Social sciences (qualitative, broader connections)
+    socialSciences: {
+        ...RESEARCH_ATTENTION_CONFIG,
+        heads: 12,
+        crossDomainDiscovery: true,
+        clustering: {
+            ...RESEARCH_ATTENTION_CONFIG.clustering,
+            semanticPurity: 0.85 // More flexible clustering
+        }
+    }
+};
+// Search mode adaptations
+export function adaptConfigToSearchMode(baseConfig, mode) {
+    switch (mode) {
+        case 'literature-review':
+            return {
+                ...baseConfig,
+                heads: 12,
+                recallTarget: 0.99, // Comprehensive recall
+                crossDomainDiscovery: false // Stay within field
+            };
+        case 'novelty-discovery':
+            return {
+                ...baseConfig,
+                heads: 16, // Maximum quality
+                crossDomainDiscovery: true,
+                clustering: {
+                    ...baseConfig.clustering,
+                    semanticPurity: 0.80 // More flexible for novel connections
+                }
+            };
+        case 'citation-tracing':
+            return {
+                ...baseConfig,
+                heads: 10,
+                forwardPassTargetMs: 50,
+                recallTarget: 0.95, // Fast, focused
+                crossDomainDiscovery: false
+            };
+        case 'interdisciplinary':
+            return {
+                ...baseConfig,
+                heads: 14,
+                crossDomainDiscovery: true,
+                clustering: {
+                    ...baseConfig.clustering,
+                    hierarchicalLevels: 6, // Deep taxonomy for connections
+                    semanticPurity: 0.82 // Flexible for cross-field
+                }
+            };
+    }
+}
+// Research stage adaptations
+export function adaptConfigToResearchStage(baseConfig, stage) {
+    switch (stage) {
+        case 'initial-exploration':
+            return {
+                ...baseConfig,
+                heads: 12,
+                crossDomainDiscovery: true,
+                recallTarget: 0.95 // Broad search
+            };
+        case 'hypothesis-formation':
+            return {
+                ...baseConfig,
+                heads: 14,
+                crossDomainDiscovery: true,
+                recallTarget: 0.98 // Comprehensive
+            };
+        case 'validation':
+            return {
+                ...baseConfig,
+                heads: 16, // Maximum precision
+                recallTarget: 0.99,
+                crossDomainDiscovery: false // Focused
+            };
+        case 'writing':
+            return {
+                ...baseConfig,
+                heads: 10,
+                forwardPassTargetMs: 50, // Fast lookups
+                recallTarget: 0.95
+            };
+    }
+}
+export function analyzeCitationNetwork(papers) {
+    // Placeholder implementation
+    return {
+        networkDensity: 0.15,
+        clusteringCoefficient: 0.45,
+        averagePathLength: 3.2,
+        communityModularity: 0.78
+    };
+}
+//# sourceMappingURL=scientific-research.js.map