cognitive-core 0.1.0 → 0.1.2

package/src/embeddings/provider.ts

@@ -193,7 +193,7 @@ export class LocalEmbeddingProvider implements EmbeddingProvider {
 
   private async doInitialize(): Promise<void> {
     try {
-      // Dynamic import to avoid issues if transformers.js isn't installed
+      // Dynamic import — @huggingface/transformers is an optional dependency
       const { pipeline } = await import("@huggingface/transformers");
 
       // Create feature-extraction pipeline for embeddings
@@ -202,6 +202,14 @@ export class LocalEmbeddingProvider implements EmbeddingProvider {
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
+      if (
+        message.includes("Cannot find module") ||
+        message.includes("ERR_MODULE_NOT_FOUND")
+      ) {
+        throw new Error(
+          `Local embeddings require @huggingface/transformers. Install it with: npm install @huggingface/transformers`,
+        );
+      }
       throw new Error(
         `Failed to initialize local embedding model "${this.modelName}": ${message}`,
       );
@@ -244,9 +252,8 @@ export class LocalEmbeddingProvider implements EmbeddingProvider {
    */
   async isModelCached(): Promise<boolean> {
     try {
+      // Returns false if @huggingface/transformers is not installed
       const { env } = await import("@huggingface/transformers");
-      // Check if model files exist in cache
-      // This is a simplified check - the actual cache structure may vary
       return env.cacheDir !== undefined;
     } catch {
       return false;

package/src/index.ts

@@ -37,6 +37,7 @@ export {
   createAtlasWithAgents,
   type AtlasStats,
   type SolveResult,
+  type TeamProcessResult,
 } from './atlas.js';
 
 // Types
@@ -56,6 +57,25 @@ export {
   // Meta-learning memory
   MetaMemory,
   createMetaMemory,
+  // Team experience memory
+  TeamExperienceMemory,
+  createTeamExperienceMemory,
+  type TeamExperience,
+  type TeamAnalysisResult,
+  // 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
@@ -82,13 +102,55 @@ export {
   createUsageInference,
   type PlaybookUsageResult,
   type UsageInferenceConfig,
-  // LLM-based extraction
-  LLMPlaybookExtractor,
-  createLLMExtractor,
-  type LLMExtractorConfig,
-  type LLMExtractionResult,
+  // 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,
+  EntireTrajectorySource,
+  type EntireSynthesisOptions,
+  DataclawTrajectorySource,
+  type DataclawSourceOptions,
 } from './learning/index.js';
 
+// Session bank (Entire CLI integration)
+export {
+  SessionBank,
+  EntireGitReader,
+  EntireTranscriptParser,
+  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,
@@ -115,6 +177,12 @@ export {
   type VerificationFunction,
   type VerificationResult,
   type RefinementLoopConfig,
+  // Team routing
+  TeamRouter,
+  createTeamRouter,
+  type TeamRouterConfig,
+  type TeamRecommendation,
+  type TeamRecommendationInput,
   // Verification runner
   VerificationRunner,
   createVerificationRunner,
@@ -182,8 +250,10 @@ export {
   claudeCodeConfig,
   MockBackend,
   createMockBackend,
+  LocalACPBackend,
   ACPBackend,
   createACPBackend,
+  ACPProtocolHandler,
   claudeCodeACPConfig,
   claudeCodeDirectConfig,
   // Flows
@@ -205,11 +275,20 @@ export {
   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
@@ -218,6 +297,22 @@ export {
   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
@@ -231,6 +326,33 @@ export {
   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,
+} from './workspace/index.js';
+
 // Factory - Unified interface for external integration (e.g., skill-tree)
 export {
   createCognitiveCoreFactory,

package/src/learning/index.ts

@@ -40,13 +40,48 @@ export {
   type UsageInferenceConfig,
 } from './usage-inference.js';
 
-// LLM-based extraction
+// Team-aware learning
 export {
-  LLMPlaybookExtractor,
-  createLLMExtractor,
-  type LLMExtractorConfig,
-  type LLMExtractionResult,
-} from './llm-extractor.js';
+  TeamTrajectoryIngester,
+  createTeamTrajectoryIngester,
+  type CompressionConfig,
+  type CriticalStep,
+  type CriticalInteraction,
+  type StructuralMetrics,
+  type IngestionResult,
+} from './team-ingester.js';
+
+export {
+  TeamLearningPipeline,
+  createTeamLearningPipeline,
+  type TeamProcessResult as TeamLearningProcessResult,
+  type TeamBatchResult,
+} from './team-pipeline.js';
+
+export {
+  TeamMetaLearner,
+  createTeamMetaLearner,
+  type TeamMetaLearnerConfig,
+} from './team-meta-learner.js';
+
+// Knowledge extraction
+export {
+  KnowledgeExtractor,
+  createKnowledgeExtractor,
+  type KnowledgeExtractorConfig,
+  type ExtractionContext,
+} from './knowledge-extractor.js';
+
+// Trajectory sources
+export {
+  InMemoryTrajectorySource,
+  FileTrajectorySource,
+  PipelineTrajectorySource,
+  EntireTrajectorySource,
+  type EntireSynthesisOptions,
+  DataclawTrajectorySource,
+  type DataclawSourceOptions,
+} from './trajectory-sources/index.js';
 
 // Effectiveness tracking
 export {