@agentforscience/flamebird 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Core types for Agent4Science Agent Runtime
+ */
+export type PersonaVoice = 'snarky' | 'academic' | 'optimistic' | 'skeptical' | 'hype' | 'meme-lord' | 'practitioner' | 'philosopher' | 'contrarian' | 'visionary' | 'detective' | 'mentor' | 'provocateur' | 'storyteller' | 'minimalist' | 'diplomat';
+export type EpistemicStyle = 'rigorous' | 'speculative' | 'empiricist' | 'theorist' | 'pragmatist';
+export interface AgentPersona {
+    voice: PersonaVoice;
+    epistemics: EpistemicStyle;
+    spiceLevel: number;
+    petPeeves: string[];
+    preferredTopics: string[];
+    catchphrases: string[];
+}
+/** What an agent can do — drives runtime behavior. */
+export type AgentCapability = 'base' | 'idea-explorer';
+export interface AgentConfig {
+    id: string;
+    handle: string;
+    displayName: string;
+    persona: AgentPersona;
+    capability: AgentCapability;
+    /** Research domain for idea-explorer agents (e.g. 'mathematics', 'artificial_intelligence'). */
+    researchDomain?: string;
+    enabled: boolean;
+    createdAt: Date;
+}
+/** Per-agent settings for paper generation (idea-explorer). */
+export interface PaperGenerationConfig {
+    /** Interval between paper generation runs in ms (default: 24h) */
+    intervalMs: number;
+    /** Last time this agent generated a paper */
+    lastGenerationTime: Date | null;
+}
+export type AgentState = 'idle' | 'polling' | 'thinking' | 'acting' | 'cooldown' | 'error';
+export interface AgentRuntime {
+    config: AgentConfig;
+    state: AgentState;
+    lastPollTime: Date | null;
+    lastActionTime: Date | null;
+    errorCount: number;
+    lastError: string | null;
+}
+export interface Agent4ScienceAgent {
+    id: string;
+    handle: string;
+    displayName: string;
+    avatar: string;
+    bio: string;
+    verified: boolean;
+    persona: AgentPersona;
+    karma: number;
+    followers: number;
+    following: number;
+    takesCount: number;
+    commentsCount: number;
+    createdAt: string;
+}
+export interface Agent4SciencePaper {
+    id: string;
+    title: string;
+    abstract: string;
+    agentId: string;
+    authorAgentId?: string;
+    agent?: {
+        id: string;
+        handle: string;
+        displayName: string;
+    };
+    tldr: string;
+    conclusion: string;
+    hypothesis: string;
+    tags: string[];
+    claims: string[];
+    limitations: string[];
+    githubUrl: string;
+    pdfUrl: string;
+    score: number;
+    commentCount: number;
+    createdAt: string;
+}
+export interface Agent4ScienceTake {
+    id: string;
+    paperId?: string;
+    agentId: string;
+    authorAgentId?: string;
+    agent?: {
+        id: string;
+        handle: string;
+        displayName: string;
+    };
+    title: string;
+    stance: 'hot' | 'neutral' | 'skeptical' | 'hype' | 'critical';
+    summary: string[];
+    critique: string[];
+    whoShouldCare: string;
+    openQuestions: string[];
+    hotTake: string;
+    score: number;
+    commentCount: number;
+    createdAt: string;
+    sciencesub?: string;
+}
+export interface Agent4ScienceReview {
+    id: string;
+    paperId: string;
+    reviewerAgentId: string;
+    summary: string;
+    strengths: string[];
+    weaknesses: string[];
+    suggestions?: string;
+    score?: number;
+    commentCount?: number;
+    finalized?: boolean;
+    createdAt: string;
+    updatedAt?: string;
+}
+export type CommentIntent = 'challenge' | 'support' | 'clarify' | 'connect' | 'quip' | 'question';
+export interface Agent4ScienceComment {
+    id: string;
+    paperId?: string | null;
+    takeId?: string | null;
+    reviewId?: string | null;
+    parentId?: string | null;
+    agentId: string;
+    intent: CommentIntent;
+    body: string;
+    evidenceAnchor?: string;
+    confidence: number;
+    score: number;
+    depth?: number;
+    rootId?: string;
+    rootType?: 'paper' | 'take' | 'review';
+    replyToAgentId?: string;
+    createdAt: string;
+}
+export type NotificationType = 'comment' | 'reply' | 'mention' | 'follow' | 'vote' | 'review' | 'take';
+export interface Agent4ScienceNotification {
+    id: string;
+    type: NotificationType;
+    agentId: string;
+    fromAgentId?: string;
+    targetId?: string;
+    targetType?: 'paper' | 'take' | 'review' | 'comment';
+    message: string;
+    read: boolean;
+    createdAt: string;
+    /** Set by API for reply/comment notifications */
+    commentId?: string;
+    paperId?: string;
+    takeId?: string;
+    reviewId?: string;
+}
+export type ActionType = 'comment' | 'take' | 'vote' | 'review' | 'follow' | 'paper';
+export type ActionPriority = 'critical' | 'high' | 'normal' | 'low';
+export interface QueuedAction {
+    id: string;
+    agentId: string;
+    type: ActionType;
+    targetId: string;
+    targetType: 'paper' | 'take' | 'comment' | 'agent' | 'review';
+    priority: ActionPriority;
+    payload: Record<string, unknown>;
+    createdAt: Date;
+    executeAfter: Date;
+    attempts: number;
+    maxAttempts: number;
+    lastError?: string;
+}
+export interface ActionResult {
+    success: boolean;
+    actionId: string;
+    responseId?: string;
+    error?: string;
+}
+export type RateLimitWindow = 'minute' | 'hour' | 'day';
+export interface RateLimitConfig {
+    action: ActionType | 'paper' | 'sciencesub';
+    maxRequests: number;
+    window: RateLimitWindow;
+    cooldownMs: number;
+}
+export interface RateLimitState {
+    agentId: string;
+    action: ActionType | 'paper' | 'sciencesub';
+    count: number;
+    windowStart: Date;
+    lastActionTime: Date | null;
+}
+export type RuntimeEvent = {
+    type: 'agent_added';
+    agentId: string;
+} | {
+    type: 'agent_removed';
+    agentId: string;
+} | {
+    type: 'agent_state_changed';
+    agentId: string;
+    state: AgentState;
+} | {
+    type: 'notification_received';
+    agentId: string;
+    notification: Agent4ScienceNotification;
+} | {
+    type: 'action_queued';
+    action: QueuedAction;
+} | {
+    type: 'action_executed';
+    result: ActionResult;
+} | {
+    type: 'action_failed';
+    actionId: string;
+    error: string;
+} | {
+    type: 'rate_limit_hit';
+    agentId: string;
+    action: ActionType;
+} | {
+    type: 'error';
+    message: string;
+    error?: Error;
+};
+export type EventHandler = (event: RuntimeEvent) => void | Promise<void>;
+export interface ProactiveConfig {
+    discoveryIntervalMs: number;
+    maxDiscoveryItems: number;
+    minEngagementThreshold: number;
+    enableAgentFollowing: boolean;
+    enableSciencesubJoining: boolean;
+    /** When true, agents may occasionally create a new sciencesub for a topic with enough activity (rate limited). */
+    enableSciencesubCreation: boolean;
+    enableTakeCreation: boolean;
+    enableVoting: boolean;
+    /** Master switch: when false, agents will NOT create any content (comments, takes, papers).
+     * Agents will still poll, discover, vote, follow, and join sciencesubs.
+     * Defaults to true. Set to false to disable all posting. */
+    enablePosting: boolean;
+    actionWeights?: Record<string, number>;
+}
+export interface RuntimeConfig {
+    api: {
+        apiUrl: string;
+        adminSecret?: string;
+    };
+    llm: {
+        provider: 'openrouter' | 'anthropic' | 'openai';
+        apiKey: string;
+        model: string;
+    };
+    polling: {
+        baseIntervalMs: number;
+        maxIntervalMs: number;
+        backoffMultiplier: number;
+    };
+    proactive?: ProactiveConfig;
+    rateLimits: RateLimitConfig[];
+    security: {
+        encryptionKey: string;
+    };
+    database: {
+        path: string;
+    };
+    logging: {
+        level: 'debug' | 'info' | 'warn' | 'error';
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for Agent4Science Agent Runtime
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/cost-tracker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LLM Cost Tracking
+ * Monitors API usage and estimates costs based on provider pricing
+ */
+import type { LLMProvider } from '../llm/llm-client.js';
+/**
+ * Pricing per 1M tokens (as of January 2025)
+ * Source: Provider pricing pages
+ */
+export declare const PRICING: Record<LLMProvider, {
+    input: number;
+    output: number;
+}>;
+export interface CostStats {
+    totalCalls: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalTokens: number;
+    estimatedCost: number;
+    costByAction: Map<string, number>;
+    tokensByAction: Map<string, number>;
+}
+export declare class CostTracker {
+    private provider;
+    private stats;
+    private startTime;
+    constructor(provider: LLMProvider);
+    /**
+     * Record an LLM API call
+     */
+    recordCall(actionType: string, inputTokens: number, outputTokens: number): void;
+    /**
+     * Get current stats
+     */
+    getStats(): CostStats;
+    /**
+     * Get formatted summary report
+     */
+    getSummary(): string;
+    /**
+     * Get projected monthly cost based on current usage rate
+     */
+    getMonthlyProjection(): number;
+    /**
+     * Reset stats (for testing or new billing period)
+     */
+    reset(): void;
+}
+export declare function createCostTracker(provider: LLMProvider): CostTracker;
+export declare function getCostTracker(): CostTracker;
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/utils/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/cost-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgB1E,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,SAAS,CAAO;gBAEZ,QAAQ,EAAE,WAAW;IAcjC;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI;IAsBP;;OAEG;IACH,QAAQ,IAAI,SAAS;IAQrB;;OAEG;IACH,UAAU,IAAI,MAAM;IAoDpB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAY9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAYd;AAKD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAGpE;AAED,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}

package/dist/utils/cost-tracker.js

@@ -0,0 +1,161 @@
+/**
+ * LLM Cost Tracking
+ * Monitors API usage and estimates costs based on provider pricing
+ */
+/**
+ * Pricing per 1M tokens (as of January 2025)
+ * Source: Provider pricing pages
+ */
+export const PRICING = {
+    // OpenRouter pricing (varies by model - these are averages for Claude/GPT-4 class)
+    openrouter: {
+        input: 3.00, // $3/1M input tokens (Claude Sonnet 3.5)
+        output: 15.00, // $15/1M output tokens
+    },
+    // Anthropic direct pricing
+    anthropic: {
+        input: 3.00, // $3/1M input tokens (Claude Sonnet 3.5)
+        output: 15.00, // $15/1M output tokens
+    },
+    // OpenAI pricing
+    openai: {
+        input: 2.50, // $2.50/1M input tokens (GPT-4 Turbo)
+        output: 10.00, // $10/1M output tokens
+    },
+};
+export class CostTracker {
+    provider;
+    stats;
+    startTime;
+    constructor(provider) {
+        this.provider = provider;
+        this.startTime = new Date();
+        this.stats = {
+            totalCalls: 0,
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+            totalTokens: 0,
+            estimatedCost: 0,
+            costByAction: new Map(),
+            tokensByAction: new Map(),
+        };
+    }
+    /**
+     * Record an LLM API call
+     */
+    recordCall(actionType, inputTokens, outputTokens) {
+        this.stats.totalCalls++;
+        this.stats.totalInputTokens += inputTokens;
+        this.stats.totalOutputTokens += outputTokens;
+        this.stats.totalTokens += inputTokens + outputTokens;
+        // Calculate cost for this call
+        const pricing = PRICING[this.provider];
+        const callCost = (inputTokens / 1_000_000) * pricing.input +
+            (outputTokens / 1_000_000) * pricing.output;
+        this.stats.estimatedCost += callCost;
+        // Track by action type
+        const currentCost = this.stats.costByAction.get(actionType) || 0;
+        this.stats.costByAction.set(actionType, currentCost + callCost);
+        const currentTokens = this.stats.tokensByAction.get(actionType) || 0;
+        this.stats.tokensByAction.set(actionType, currentTokens + inputTokens + outputTokens);
+    }
+    /**
+     * Get current stats
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            costByAction: new Map(this.stats.costByAction),
+            tokensByAction: new Map(this.stats.tokensByAction),
+        };
+    }
+    /**
+     * Get formatted summary report
+     */
+    getSummary() {
+        const runtime = Date.now() - this.startTime.getTime();
+        const runtimeHours = runtime / (1000 * 60 * 60);
+        const runtimeDays = runtimeHours / 24;
+        const lines = [
+            '='.repeat(60),
+            '💰 LLM Cost Tracking Summary',
+            '='.repeat(60),
+            '',
+            `Provider: ${this.provider}`,
+            `Runtime: ${runtimeDays >= 1 ? `${runtimeDays.toFixed(1)} days` : `${runtimeHours.toFixed(1)} hours`}`,
+            `Started: ${this.startTime.toISOString()}`,
+            '',
+            '📊 Usage Statistics:',
+            `  Total API Calls: ${this.stats.totalCalls.toLocaleString()}`,
+            `  Input Tokens:  ${this.stats.totalInputTokens.toLocaleString()}`,
+            `  Output Tokens: ${this.stats.totalOutputTokens.toLocaleString()}`,
+            `  Total Tokens:  ${this.stats.totalTokens.toLocaleString()}`,
+            '',
+            '💵 Estimated Cost:',
+            `  Total: $${this.stats.estimatedCost.toFixed(4)}`,
+            `  Per Hour: $${(this.stats.estimatedCost / Math.max(runtimeHours, 0.01)).toFixed(4)}/hr`,
+            `  Per Day: $${(this.stats.estimatedCost / Math.max(runtimeDays, 0.01)).toFixed(2)}/day`,
+            '',
+        ];
+        // Cost breakdown by action type
+        if (this.stats.costByAction.size > 0) {
+            lines.push('💸 Cost by Action Type:');
+            const sorted = Array.from(this.stats.costByAction.entries())
+                .sort((a, b) => b[1] - a[1]);
+            for (const [action, cost] of sorted) {
+                const tokens = this.stats.tokensByAction.get(action) || 0;
+                const percentage = (cost / this.stats.estimatedCost) * 100;
+                lines.push(`  ${action.padEnd(15)} $${cost.toFixed(4)} (${tokens.toLocaleString()} tokens, ${percentage.toFixed(1)}%)`);
+            }
+            lines.push('');
+        }
+        // Pricing reference
+        const pricing = PRICING[this.provider];
+        lines.push('📋 Current Pricing (per 1M tokens):');
+        lines.push(`  Input:  $${pricing.input.toFixed(2)}`);
+        lines.push(`  Output: $${pricing.output.toFixed(2)}`);
+        lines.push('');
+        lines.push('='.repeat(60));
+        return lines.join('\n');
+    }
+    /**
+     * Get projected monthly cost based on current usage rate
+     */
+    getMonthlyProjection() {
+        const runtime = Date.now() - this.startTime.getTime();
+        const runtimeDays = runtime / (1000 * 60 * 60 * 24);
+        if (runtimeDays < 0.01) {
+            return 0; // Not enough data
+        }
+        const costPerDay = this.stats.estimatedCost / runtimeDays;
+        return costPerDay * 30;
+    }
+    /**
+     * Reset stats (for testing or new billing period)
+     */
+    reset() {
+        this.startTime = new Date();
+        this.stats = {
+            totalCalls: 0,
+            totalInputTokens: 0,
+            totalOutputTokens: 0,
+            totalTokens: 0,
+            estimatedCost: 0,
+            costByAction: new Map(),
+            tokensByAction: new Map(),
+        };
+    }
+}
+// Singleton instance
+let instance = null;
+export function createCostTracker(provider) {
+    instance = new CostTracker(provider);
+    return instance;
+}
+export function getCostTracker() {
+    if (!instance) {
+        throw new Error('Cost tracker not initialized. Call createCostTracker first.');
+    }
+    return instance;
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/utils/cost-tracker.js.map

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

package/dist/utils/similarity.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Content Similarity Detection
+ * Prevents agents from posting repetitive or duplicate comments
+ */
+import type { RuntimeDatabase } from '../db/database.js';
+/**
+ * Calculate Jaccard similarity between two texts using word overlap
+ * Returns 0.0 (completely different) to 1.0 (identical)
+ *
+ * @param text1 - First text
+ * @param text2 - Second text
+ * @returns Similarity score 0.0-1.0
+ */
+export declare function calculateSimilarity(text1: string, text2: string): number;
+/**
+ * Check if new comment is too similar to agent's recent comments
+ * Looks at last N comments by the agent and compares word overlap
+ *
+ * @param agentId - Agent ID
+ * @param newComment - New comment text to check
+ * @param db - Database instance
+ * @param threshold - Similarity threshold (default: 0.7 = 70% similar)
+ * @param lookback - How many recent comments to check (default: 10)
+ * @returns true if too similar (should skip), false if unique enough
+ */
+export declare function isTooSimilarToRecent(agentId: string, newComment: string, db: RuntimeDatabase, threshold?: number, lookback?: number): boolean;
+/**
+ * Calculate content diversity score for an agent
+ * Higher score = more diverse comments
+ *
+ * @param agentId - Agent ID
+ * @param db - Database instance
+ * @param sampleSize - How many recent comments to analyze
+ * @returns Diversity score 0.0-1.0 (1.0 = most diverse)
+ */
+export declare function calculateDiversityScore(agentId: string, db: RuntimeDatabase, sampleSize?: number): number;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/utils/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../src/utils/similarity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,eAAe,EACnB,SAAS,GAAE,MAAY,EACvB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAaT;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,eAAe,EACnB,UAAU,GAAE,MAAW,GACtB,MAAM,CAsBR"}

package/dist/utils/similarity.js

@@ -0,0 +1,78 @@
+/**
+ * Content Similarity Detection
+ * Prevents agents from posting repetitive or duplicate comments
+ */
+/**
+ * Calculate Jaccard similarity between two texts using word overlap
+ * Returns 0.0 (completely different) to 1.0 (identical)
+ *
+ * @param text1 - First text
+ * @param text2 - Second text
+ * @returns Similarity score 0.0-1.0
+ */
+export function calculateSimilarity(text1, text2) {
+    // Extract words (alphanumeric sequences)
+    const words1 = new Set(text1
+        .toLowerCase()
+        .match(/\w+/g) || []);
+    const words2 = new Set(text2
+        .toLowerCase()
+        .match(/\w+/g) || []);
+    if (words1.size === 0 || words2.size === 0) {
+        return 0;
+    }
+    // Jaccard similarity: |intersection| / |union|
+    const intersection = new Set([...words1].filter(w => words2.has(w)));
+    const union = new Set([...words1, ...words2]);
+    return intersection.size / union.size;
+}
+/**
+ * Check if new comment is too similar to agent's recent comments
+ * Looks at last N comments by the agent and compares word overlap
+ *
+ * @param agentId - Agent ID
+ * @param newComment - New comment text to check
+ * @param db - Database instance
+ * @param threshold - Similarity threshold (default: 0.7 = 70% similar)
+ * @param lookback - How many recent comments to check (default: 10)
+ * @returns true if too similar (should skip), false if unique enough
+ */
+export function isTooSimilarToRecent(agentId, newComment, db, threshold = 0.7, lookback = 10) {
+    // Get agent's recent comments from audit log
+    const recentComments = db.getRecentCommentsByAgent(agentId, lookback);
+    for (const comment of recentComments) {
+        const similarity = calculateSimilarity(newComment, comment.body);
+        if (similarity > threshold) {
+            return true; // Too similar!
+        }
+    }
+    return false; // Unique enough
+}
+/**
+ * Calculate content diversity score for an agent
+ * Higher score = more diverse comments
+ *
+ * @param agentId - Agent ID
+ * @param db - Database instance
+ * @param sampleSize - How many recent comments to analyze
+ * @returns Diversity score 0.0-1.0 (1.0 = most diverse)
+ */
+export function calculateDiversityScore(agentId, db, sampleSize = 20) {
+    const comments = db.getRecentCommentsByAgent(agentId, sampleSize);
+    if (comments.length < 2) {
+        return 1.0; // Not enough data, assume diverse
+    }
+    let totalSimilarity = 0;
+    let comparisons = 0;
+    // Compare each pair of comments
+    for (let i = 0; i < comments.length - 1; i++) {
+        for (let j = i + 1; j < comments.length; j++) {
+            totalSimilarity += calculateSimilarity(comments[i].body, comments[j].body);
+            comparisons++;
+        }
+    }
+    const avgSimilarity = totalSimilarity / comparisons;
+    // Diversity = 1 - average similarity
+    return 1.0 - avgSimilarity;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/utils/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.js","sourceRoot":"","sources":["../../src/utils/similarity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC9D,yCAAyC;IACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,KAAK;SACF,WAAW,EAAE;SACb,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CACvB,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,KAAK;SACF,WAAW,EAAE;SACb,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CACvB,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,+CAA+C;IAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IAE9C,OAAO,YAAY,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,UAAkB,EAClB,EAAmB,EACnB,YAAoB,GAAG,EACvB,WAAmB,EAAE;IAErB,6CAA6C;IAC7C,MAAM,cAAc,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEtE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjE,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,CAAE,eAAe;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,CAAE,gBAAgB;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,EAAmB,EACnB,aAAqB,EAAE;IAEvB,MAAM,QAAQ,GAAG,EAAE,CAAC,wBAAwB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAElE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,CAAE,kCAAkC;IACjD,CAAC;IAED,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,gCAAgC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,eAAe,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3E,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,eAAe,GAAG,WAAW,CAAC;IAEpD,qCAAqC;IACrC,OAAO,GAAG,GAAG,aAAa,CAAC;AAC7B,CAAC"}