@timmeck/brain-core 2.22.0 → 2.23.0

package/dist/consciousness/types.d.ts

@@ -1,4 +1,4 @@
-export type ThoughtType = 'perceiving' | 'analyzing' | 'discovering' | 'hypothesizing' | 'experimenting' | 'dreaming' | 'reflecting' | 'correlating' | 'predicting' | 'responding' | 'focusing' | 'explaining';
+export type ThoughtType = 'perceiving' | 'analyzing' | 'discovering' | 'hypothesizing' | 'experimenting' | 'dreaming' | 'reflecting' | 'correlating' | 'predicting' | 'responding' | 'focusing' | 'explaining' | 'exploring';
 export type ThoughtSignificance = 'routine' | 'notable' | 'breakthrough';
 export interface Thought {
     id: string;

package/dist/curiosity/curiosity-engine.d.ts

@@ -0,0 +1,170 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+import type { AttentionEngine } from '../attention/attention-engine.js';
+import type { KnowledgeDistiller } from '../research/knowledge-distiller.js';
+import type { HypothesisEngine } from '../hypothesis/engine.js';
+import type { ExperimentEngine } from '../research/experiment-engine.js';
+import type { ResearchAgendaEngine } from '../research/agenda-engine.js';
+import type { NarrativeEngine } from '../narrative/narrative-engine.js';
+export interface CuriosityEngineConfig {
+    brainName: string;
+    /** UCB1 exploration constant (higher = more exploration). Default: 1.41 (√2) */
+    explorationConstant?: number;
+    /** Minimum cycles between re-exploring same topic. Default: 5 */
+    exploreCooldown?: number;
+    /** Max questions per topic. Default: 10 */
+    maxQuestionsPerTopic?: number;
+    /** Gap score threshold to consider a topic a knowledge gap. Default: 0.6 */
+    gapThreshold?: number;
+}
+export interface CuriosityDataSources {
+    attentionEngine?: AttentionEngine;
+    knowledgeDistiller?: KnowledgeDistiller;
+    hypothesisEngine?: HypothesisEngine;
+    experimentEngine?: ExperimentEngine;
+    agendaEngine?: ResearchAgendaEngine;
+    narrativeEngine?: NarrativeEngine;
+}
+export interface KnowledgeGap {
+    id?: number;
+    topic: string;
+    attentionScore: number;
+    knowledgeScore: number;
+    gapScore: number;
+    gapType: GapType;
+    questions: string[];
+    discoveredAt: string;
+    addressedAt: string | null;
+    explorationCount: number;
+}
+export type GapType = 'dark_zone' | 'shallow' | 'contradictory' | 'stale' | 'unexplored';
+export interface CuriosityQuestion {
+    id?: number;
+    topic: string;
+    question: string;
+    questionType: QuestionType;
+    priority: number;
+    answered: boolean;
+    answer: string | null;
+    askedAt: string;
+    answeredAt: string | null;
+}
+export type QuestionType = 'what' | 'why' | 'how' | 'correlation' | 'prediction' | 'comparison';
+export interface ExplorationRecord {
+    id?: number;
+    topic: string;
+    action: 'explore' | 'exploit';
+    reward: number;
+    context: string;
+    timestamp: string;
+}
+export interface BanditArm {
+    topic: string;
+    pulls: number;
+    totalReward: number;
+    averageReward: number;
+    ucbScore: number;
+    lastPulled: number | null;
+}
+export interface CuriosityStatus {
+    totalGaps: number;
+    activeGaps: number;
+    totalQuestions: number;
+    unansweredQuestions: number;
+    totalExplorations: number;
+    explorationRate: number;
+    topGaps: KnowledgeGap[];
+    topArms: BanditArm[];
+    uptime: number;
+}
+export interface ExplorationDecision {
+    topic: string;
+    action: 'explore' | 'exploit';
+    ucbScore: number;
+    reason: string;
+    suggestedActions: string[];
+}
+export declare function runCuriosityMigration(db: Database.Database): void;
+export declare class CuriosityEngine {
+    private readonly db;
+    private readonly config;
+    private readonly log;
+    private ts;
+    private sources;
+    private startTime;
+    private readonly stmtInsertGap;
+    private readonly stmtUpdateGap;
+    private readonly stmtGetGap;
+    private readonly stmtGetGapByTopic;
+    private readonly stmtListGaps;
+    private readonly stmtActiveGapCount;
+    private readonly stmtInsertQuestion;
+    private readonly stmtAnswerQuestion;
+    private readonly stmtListQuestions;
+    private readonly stmtUnansweredCount;
+    private readonly stmtInsertExploration;
+    private readonly stmtGetExplorations;
+    private readonly stmtGetTopicStats;
+    private readonly stmtTotalExplorations;
+    constructor(db: Database.Database, config: CuriosityEngineConfig);
+    setThoughtStream(stream: ThoughtStream): void;
+    setDataSources(sources: CuriosityDataSources): void;
+    /**
+     * Scan attention topics and knowledge base to find gaps.
+     * A gap = high attention + low knowledge.
+     */
+    detectGaps(): KnowledgeGap[];
+    /**
+     * UCB1: Upper Confidence Bound algorithm.
+     * Balances exploration (trying under-explored topics) vs exploitation
+     * (deepening high-reward topics).
+     *
+     * UCB1(arm) = avg_reward + c * sqrt(ln(N) / n_i)
+     * where N = total pulls, n_i = pulls for arm i, c = exploration constant
+     */
+    selectTopic(): ExplorationDecision | null;
+    /**
+     * Record the outcome of an exploration/exploitation.
+     * Reward: 0-1 where 1 = highly valuable outcome.
+     */
+    recordOutcome(topic: string, action: 'explore' | 'exploit', reward: number, context?: string): void;
+    /**
+     * Generate concrete questions Brain should investigate.
+     * Uses knowledge context to formulate specific questions.
+     */
+    generateQuestions(topic?: string): CuriosityQuestion[];
+    /**
+     * Answer a question (e.g., when user or system provides an answer).
+     */
+    answerQuestion(questionId: number, answer: string): boolean;
+    /**
+     * Check for surprises: things that violated expectations.
+     * Compares predictions vs actual outcomes, hypothesis results vs expected.
+     */
+    detectSurprises(): Array<{
+        topic: string;
+        expected: string;
+        actual: string;
+        deviation: number;
+    }>;
+    getGaps(limit?: number): KnowledgeGap[];
+    getGap(id: number): KnowledgeGap | null;
+    getQuestions(limit?: number): CuriosityQuestion[];
+    getArms(): BanditArm[];
+    getExplorations(limit?: number): ExplorationRecord[];
+    getStatus(): CuriosityStatus;
+    /** Gather topics from attention, knowledge, and hypotheses. */
+    private gatherTopics;
+    /** Extract meaningful topic words from a statement. */
+    private extractTopicWords;
+    /** Get attention score for a topic (0-1 normalized). */
+    private getAttentionFor;
+    /** Get knowledge score for a topic (0-1). High = we know a lot. */
+    private getKnowledgeFor;
+    private classifyGap;
+    private generateQuestionsFor;
+    private inferQuestionType;
+    private suggestActions;
+    private toGap;
+    private toQuestion;
+}