cognitive-core 0.2.4 → 0.3.1

package/src/index.ts

@@ -1,495 +0,0 @@
-/**
- * Atlas - Adaptive Trajectory Learning and Abstraction System
- *
- * A TypeScript-native cognitive core for building agents that learn
- * from experience. Extracts playbooks from problem-solving trajectories
- * to guide future task solving.
- *
- * @example
- * ```typescript
- * import { createAtlas, createTask } from 'cognitive-core';
- *
- * const atlas = createAtlas();
- * await atlas.init();
- *
- * // Set your LLM provider
- * atlas.setProvider(myProvider);
- *
- * // Solve a task
- * const task = createTask({
- *   domain: 'code',
- *   description: 'Write a function that...',
- * });
- *
- * const result = await atlas.solve(task);
- * console.log(result.trajectory.outcome);
- *
- * // Close when done
- * await atlas.close();
- * ```
- */
-
-// Main Atlas class
-export {
-  Atlas,
-  createAtlas,
-  createAtlasWithProvider,
-  createAtlasWithAgents,
-  type AtlasStats,
-  type SolveResult,
-  type TeamProcessResult,
-} from './atlas.js';
-
-// Types
-export * from './types/index.js';
-
-// Memory system
-export {
-  MemorySystem,
-  createMemorySystem,
-  ExperienceMemory,
-  type MemoryQueryResult,
-  type MemoryQueryResultV2,
-  // Playbook-based memory
-  PlaybookLibrary,
-  createPlaybookLibrary,
-  type PlaybookMatch,
-  // Meta-learning memory
-  MetaMemory,
-  createMetaMemory,
-  // Team experience memory
-  TeamExperienceMemory,
-  createTeamExperienceMemory,
-  type TeamExperience,
-  type TeamAnalysisResult,
-  // Reflexion episodes
-  ReflexionMemory,
-  createReflexionMemory,
-  // Coherence checking
-  CoherenceChecker,
-  createCoherenceChecker,
-  type CoherenceResult,
-  type CoherenceCheckerConfig,
-  // Reasoning bank (clustered experience retrieval)
-  ReasoningBank,
-  createReasoningBank,
-  type ExperienceCluster,
-  type ClusterStats,
-  type ReasoningBankConfig,
-  // Causal edge store
-  CausalStore,
-  createCausalStore,
-  type CausalEdge,
-  // Temporal compression
-  TemporalCompressor,
-  createTemporalCompressor,
-  type TemporalCompressorConfig,
-  type CompressionResult,
-  // Knowledge bank (semantic memory)
-  KnowledgeBank,
-  KnowledgeGraphManager,
-  KnowledgeDefragmenter,
-  SemanticGraphLayer,
-  TemporalGraphLayer,
-  CausalGraphLayer,
-  EntityGraphLayer,
-  // Search providers (strategy pattern for knowledge search)
-  type SearchProvider,
-  type SearchProviderResult,
-  TextSimilaritySearchProvider,
-  MinimemSearchProvider,
-  type MinimemSearchClient,
-} from './memory/index.js';
-
-// Learning engine
-export {
-  TrajectoryAnalyzer,
-  createAnalyzer,
-  type AnalysisResult,
-  // Playbook-based learning
-  PlaybookExtractor,
-  createPlaybookExtractor,
-  type ExtractedPlaybooks,
-  type PlaybookUpdate,
-  type PlaybookExtractorConfig,
-  // Meta-learning
-  MetaLearner,
-  createMetaLearner,
-  type MetaLearnerConfig,
-  // Usage inference
-  PlaybookUsageInference,
-  createUsageInference,
-  type PlaybookUsageResult,
-  type UsageInferenceConfig,
-  // Team-aware learning
-  TeamTrajectoryIngester,
-  createTeamTrajectoryIngester,
-  TeamLearningPipeline,
-  createTeamLearningPipeline,
-  type IngestionResult,
-  type TeamLearningProcessResult,
-  type TeamBatchResult,
-  // Team meta-learning
-  TeamMetaLearner,
-  createTeamMetaLearner,
-  type TeamMetaLearnerConfig,
-  // Knowledge extraction
-  KnowledgeExtractor,
-  createKnowledgeExtractor,
-  type KnowledgeExtractorConfig,
-  type ExtractionContext,
-  // Trajectory sources
-  InMemoryTrajectorySource,
-  FileTrajectorySource,
-  PipelineTrajectorySource,
-  SessionTrajectorySource,
-  type SessionSynthesisOptions,
-  DataclawTrajectorySource,
-  type DataclawSourceOptions,
-  // Instant (hot-path) learning
-  InstantLoop,
-  createInstantLoop,
-  type InstantLoopResult,
-  type InstantLoopConfig,
-  // Reflexion generation
-  ReflexionGenerator,
-  createReflexionGenerator,
-  type ReflexionGeneratorConfig,
-  // Effectiveness tracking
-  LearningEffectivenessTracker,
-  createEffectivenessTracker,
-  type TaskAnnotation,
-  type EffectivenessMetrics,
-  type PlaybookEffectivenessEntry,
-  // Unified learning pipeline (three-speed: immediate + batch + maintenance)
-  UnifiedLearningPipeline,
-  createUnifiedPipeline,
-  type UnifiedPipelineConfig,
-  type UnifiedPipelineFeatures,
-  type ImmediateResult,
-  type UnifiedBatchResult,
-  type UnifiedPipelineStats,
-  // Energy evaluator
-  EnergyEvaluator,
-  createEnergyEvaluator,
-  type EnergyEvaluatorConfig,
-  type EnergyEvaluation,
-  type EnergySignal,
-  type EscalationReason,
-  type LaneTransition,
-  // Maintenance scheduler
-  MaintenanceScheduler,
-  createMaintenanceScheduler,
-  type MaintenanceSchedulerConfig,
-  type MaintenanceMode,
-  type MaintenanceCycleResult,
-  type MaintenanceTask,
-  type MaintenanceTaskResult,
-  // Healing orchestrator
-  HealingOrchestrator,
-  createHealingOrchestrator,
-  PlaybookDriftDetector,
-  MemoryBloatDetector,
-  MetricDriftDetector,
-  type HealingCycleResult,
-  type HealthContext,
-  type AnomalyDetector,
-  type RepairStrategy,
-  type Anomaly,
-  type RepairResult,
-} from './learning/index.js';
-
-// Session bank (SessionLog checkpoint reader, with Entire CLI fallback)
-export {
-  SessionBank,
-  CheckpointGitReader,
-  CheckpointParser,
-  detectFormat,
-  type CheckpointFormat,
-  type SessionRecord,
-  type SessionMetadata,
-  type TranscriptMessage,
-  type ContentBlock as SessionContentBlock,
-  type TextBlock as SessionTextBlock,
-  type ToolUseBlock as SessionToolUseBlock,
-  type ToolResultBlock as SessionToolResultBlock,
-  type SessionSummary,
-  type TokenUsage as SessionTokenUsage,
-  type Attribution as SessionAttribution,
-  type SessionSource,
-  type CheckpointRef,
-  type SessionQuery,
-  type SessionQueryResult,
-  type SessionBankOptions,
-} from './session-bank/index.js';
-
-// Search/solving
-export {
-  TaskRouter,
-  createRouter,
-  DirectSolver,
-  createSolver,
-  type RoutingDecision,
-  type SolverResult,
-  // MoE-inspired routing gate
-  MoEGate,
-  createMoEGate,
-  extractTaskFeatures,
-  MOE_FEATURE_SIZE,
-  MOE_STRATEGIES,
-  type MoEGateState,
-  // Refinement
-  SolutionEvaluator,
-  createSolutionEvaluator,
-  RefinementLoop,
-  createRefinementLoop,
-  createEvaluationResult,
-  scoreToQuality,
-  isQualityAcceptable,
-  type EvaluationResult,
-  type EvaluationIssue,
-  type EvaluationMethod,
-  type QualityLevel,
-  type FailureContext,
-  type RefinementResult,
-  type EvaluatorConfig,
-  type VerificationFunction,
-  type VerificationResult,
-  type RefinementLoopConfig,
-  // Team routing
-  TeamRouter,
-  createTeamRouter,
-  type TeamRouterConfig,
-  type TeamRecommendation,
-  type TeamRecommendationInput,
-  // Verification runner
-  VerificationRunner,
-  createVerificationRunner,
-  TestRunners,
-  type CommandVerificationConfig,
-  type CommandResult,
-  type VerificationIssue,
-} from './search/index.js';
-
-// Agents
-export {
-  Agent,
-  MockLLMProvider,
-  createMockProvider,
-  type LLMProvider,
-  type Message,
-  type CompletionOptions,
-  type AgentConfig,
-} from './agents/index.js';
-
-// Utilities
-export {
-  cosineSimilarity,
-  textSimilarity,
-  findTopK,
-  JsonStore,
-  saveJson,
-  loadJson,
-  // Domain-partitioned storage
-  PartitionedStore,
-  type PartitionedStoreOptions,
-} from './utils/index.js';
-
-// Embeddings - Vector search and similarity
-export {
-  // Provider interface and implementations
-  type EmbeddingProvider,
-  type EmbeddingProviderConfig,
-  OpenAIEmbeddingProvider,
-  VoyageEmbeddingProvider,
-  LocalEmbeddingProvider,
-  createEmbeddingProvider,
-  // BM25 text search fallback
-  BM25Index,
-  createBM25Index,
-  type MemoryItemType,
-  // Vector store
-  SqliteVectorStore,
-  createVectorStore,
-  type VectorSearchResult,
-  // Inverted index (candidate narrowing)
-  InvertedIndex,
-  // Embedding manager
-  EmbeddingManager,
-  createEmbeddingManager,
-  type EmbeddingManagerOptions,
-  type SearchResult,
-} from './embeddings/index.js';
-
-// Runtime - Agent management and flows
-export {
-  // Manager
-  AgentManager,
-  createAgentManager,
-  DefaultKnowledgeInjector,
-  DefaultTrajectoryExtractor,
-  // Backends
-  SubprocessBackend,
-  createSubprocessBackend,
-  claudeCodeConfig,
-  MockBackend,
-  createMockBackend,
-  LocalACPBackend,
-  ACPBackend,
-  createACPBackend,
-  ACPProtocolHandler,
-  claudeCodeACPConfig,
-  claudeCodeDirectConfig,
-  // Flows
-  LearningFlow,
-  createLearningFlow,
-  ValidationFlow,
-  createValidationFlow,
-  // Types
-  type AgentMessage,
-  type ToolCall,
-  type AgentState,
-  type AgentSession,
-  type AgentSpawnConfig,
-  type AgentResult,
-  type AgentBackend,
-  type KnowledgeInjector,
-  type TrajectoryExtractor,
-  type AgentObserverCallbacks,
-  type SubprocessAgentConfig,
-  type MockAgentBehavior,
-  type ACPAgentConfig,
-  type ACPSessionBase,
-  type LearningFlowConfig,
-  type LearningFlowResult,
-  type ValidationFlowConfig,
-  type ValidationFlowResult,
-  type ValidationMetrics,
-  // Compute Provider
-  DefaultComputeProvider,
-  createComputeProvider,
-  type ComputeProvider,
-  type ComputeRequirements,
-  type ComputeTarget,
-  type ComputeSource,
-  type CostTier,
-} from './runtime/index.js';
-
-// Surfacing - Skill library for agent consumption
-export {
-  SkillLibrary,
-  createSkillLibrary,
-  type AgentSkills,
-  type TierRefreshResult,
-  // Team skill library
-  TeamSkillLibrary,
-  createTeamSkillLibrary,
-  type TeamSkillLibraryConfig,
-  type RankedTeamPlaybook,
-  type RankedRolePlaybook,
-  type TeamOutcomeFeedback,
-  type RoleOutcomeFeedback,
-  type TeamAgentSkills,
-  // Skill publishing to skill-tree storage
-  SkillPublisher,
-  convertPlaybookToSkill,
-  type PublishResult,
-  type DeprecateResult,
-  // SQLite storage adapter for skill-tree persistence
-  SqliteStorageAdapter,
-} from './surfacing/index.js';
-
-// MCP Server - On-demand playbook access
-// @deprecated Use the CLI (bin/cognitive-core) + SKILL.md approach instead
-export {
-  PlaybookMCPServer,
-  createPlaybookMCPServer,
-  type MCPTool,
-  type MCPToolCall,
-  type MCPToolResult,
-  type PlaybookSearchResult,
-} from './mcp/index.js';
-
-// Workspace - Agentic analysis workspace infrastructure
-// WorkspaceManager and WorkspaceHandle provided by agent-workspace package
-export {
-  // Manager (from agent-workspace)
-  WorkspaceManager,
-  WorkspaceHandle,
-  // Runner
-  AgenticTaskRunner,
-  createAgenticTaskRunner,
-  // Skill converter
-  convertPlaybooksToSkills,
-  generateSkillMd,
-  parseSkillMdToPlaybook,
-  // Types
-  type OutputSpec,
-  type OutputFileSpec,
-  type ValidationResult,
-  type AgentSkillSpec,
-  type ResourceSpec,
-  type AnalysisComplexity,
-  type ProcessingContext,
-  type AgenticTaskTemplate,
-  type AgenticTaskResult,
-  type AgenticTaskMetrics,
-  AgenticTaskOutputError,
-  // Efficacy toolkit
-  computeNormalizedGain,
-  computeTemporalTrend,
-  computeDomainBreakdown,
-  buildEfficacyProfile,
-  buildPortfolioSnapshot,
-  type PlaybookEfficacyProfile,
-  type DomainBreakdown,
-  type TemporalTrend,
-  type UsageProfile,
-  type EvolutionSummary,
-  type PortfolioSnapshot,
-  type PlaybookHealthFlag,
-  type RedundancyPair,
-  // Efficacy templates
-  playbookEfficacyAuditTemplate,
-  type PlaybookEfficacyAuditInput,
-  type PlaybookEfficacyAuditOutput,
-  type PlaybookRecommendation,
-  playbookDecayDetectionTemplate,
-  type PlaybookDecayDetectionInput,
-  type PlaybookDecayDetectionOutput,
-  type DecaySignal,
-  playbookLifecycleReviewTemplate,
-  type PlaybookLifecycleReviewInput,
-  type PlaybookLifecycleReviewOutput,
-  type LifecycleRecommendation,
-} from './workspace/index.js';
-
-// Persistence - Unified SQLite database for system-internal state
-export {
-  SqlitePersistence,
-  createSqlitePersistence,
-  type SqlitePersistenceConfig,
-  type ExperienceRow,
-  type PlaybookRow,
-  type ReflexionRow,
-  type CausalEdgeRow,
-  type MetaObservationRow,
-  type MetaStrategyRow,
-  JsonToSqliteMigrator,
-  runMigration,
-  type MigrationResult,
-} from './persistence/index.js';
-
-// Factory - Unified interface for external integration (e.g., skill-tree)
-export {
-  createCognitiveCoreFactory,
-  cognitiveCoreFactory,
-  type CognitiveCoreFactory,
-  type ILearningPipeline,
-  type IMemorySystem,
-  type TaskParams,
-  type TrajectoryParams,
-  type StepParams,
-  type OutcomeParams,
-  type LearningPipelineConfig,
-} from './factory.js';