cogmem 3.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/BENCHMARKS.md +62 -0
- package/CHANGELOG.md +215 -0
- package/CONCURRENT_ACCESS.md +27 -0
- package/CONTRIBUTING.md +32 -0
- package/LICENSE +21 -0
- package/MEMORY_ATLAS.md +101 -0
- package/MEMORY_MODEL.md +179 -0
- package/README.md +751 -0
- package/RECALL_EXPLAINABILITY.md +152 -0
- package/RELEASE_CHECKLIST.md +92 -0
- package/SECURITY.md +21 -0
- package/dist/adapters/MarkdownSourceLoader.d.ts +5 -0
- package/dist/adapters/MarkdownSourceLoader.js +19 -0
- package/dist/adapters/conversation/ConversationMarkdownAdapter.d.ts +9 -0
- package/dist/adapters/conversation/ConversationMarkdownAdapter.js +233 -0
- package/dist/adapters/hermes/HermesStateDbAdapter.d.ts +10 -0
- package/dist/adapters/hermes/HermesStateDbAdapter.js +268 -0
- package/dist/adapters/hermes/HermesWorkspaceProfile.d.ts +15 -0
- package/dist/adapters/hermes/HermesWorkspaceProfile.js +82 -0
- package/dist/adapters/index.d.ts +15 -0
- package/dist/adapters/index.js +12 -0
- package/dist/adapters/openclaw/OpenClawAdapterSupport.d.ts +14 -0
- package/dist/adapters/openclaw/OpenClawAdapterSupport.js +29 -0
- package/dist/adapters/openclaw/OpenClawDailyMemoryAdapter.d.ts +8 -0
- package/dist/adapters/openclaw/OpenClawDailyMemoryAdapter.js +35 -0
- package/dist/adapters/openclaw/OpenClawMemoryIndexAdapter.d.ts +8 -0
- package/dist/adapters/openclaw/OpenClawMemoryIndexAdapter.js +23 -0
- package/dist/adapters/openclaw/OpenClawPersonaAdapter.d.ts +8 -0
- package/dist/adapters/openclaw/OpenClawPersonaAdapter.js +24 -0
- package/dist/adapters/openclaw/OpenClawSessionAdapter.d.ts +8 -0
- package/dist/adapters/openclaw/OpenClawSessionAdapter.js +15 -0
- package/dist/adapters/openclaw/OpenClawUserProfileAdapter.d.ts +8 -0
- package/dist/adapters/openclaw/OpenClawUserProfileAdapter.js +24 -0
- package/dist/adapters/openclaw/OpenClawWorkspaceProfile.d.ts +38 -0
- package/dist/adapters/openclaw/OpenClawWorkspaceProfile.js +199 -0
- package/dist/adapters/soul/SoulMarkdownAdapter.d.ts +14 -0
- package/dist/adapters/soul/SoulMarkdownAdapter.js +255 -0
- package/dist/adapters/types.d.ts +97 -0
- package/dist/adapters/types.js +185 -0
- package/dist/agent/AgentMemoryBackend.d.ts +291 -0
- package/dist/agent/AgentMemoryBackend.js +1272 -0
- package/dist/agent/AgentRecallQueryCompiler.d.ts +20 -0
- package/dist/agent/AgentRecallQueryCompiler.js +289 -0
- package/dist/agent/ContextHygiene.d.ts +9 -0
- package/dist/agent/ContextHygiene.js +20 -0
- package/dist/agent/MemoryUsageReceipt.d.ts +35 -0
- package/dist/agent/MemoryUsageReceipt.js +136 -0
- package/dist/agent/SessionWorkingState.d.ts +20 -0
- package/dist/agent/SessionWorkingState.js +94 -0
- package/dist/agent/index.d.ts +6 -0
- package/dist/agent/index.js +5 -0
- package/dist/algorithm/AlgorithmReviewBackend.d.ts +84 -0
- package/dist/algorithm/AlgorithmReviewBackend.js +261 -0
- package/dist/algorithm/AlgorithmReviewMetrics.d.ts +23 -0
- package/dist/algorithm/AlgorithmReviewMetrics.js +25 -0
- package/dist/algorithm/Phase2ModelAlgorithmReviewBackend.d.ts +38 -0
- package/dist/algorithm/Phase2ModelAlgorithmReviewBackend.js +372 -0
- package/dist/assets/FileAssetIngestionService.d.ts +32 -0
- package/dist/assets/FileAssetIngestionService.js +133 -0
- package/dist/assets/FileAssetStore.d.ts +36 -0
- package/dist/assets/FileAssetStore.js +152 -0
- package/dist/assets/FileBlockStore.d.ts +12 -0
- package/dist/assets/FileBlockStore.js +110 -0
- package/dist/assets/FileChunkStore.d.ts +23 -0
- package/dist/assets/FileChunkStore.js +179 -0
- package/dist/assets/FileChunker.d.ts +10 -0
- package/dist/assets/FileChunker.js +69 -0
- package/dist/assets/FileLoaderRegistry.d.ts +8 -0
- package/dist/assets/FileLoaderRegistry.js +21 -0
- package/dist/assets/FileLoaders.d.ts +37 -0
- package/dist/assets/FileLoaders.js +268 -0
- package/dist/assets/index.d.ts +10 -0
- package/dist/assets/index.js +7 -0
- package/dist/assets/providers/types.d.ts +47 -0
- package/dist/assets/providers/types.js +1 -0
- package/dist/assets/types.d.ts +159 -0
- package/dist/assets/types.js +1 -0
- package/dist/atlas/ActionFrameExtractor.d.ts +15 -0
- package/dist/atlas/ActionFrameExtractor.js +135 -0
- package/dist/atlas/MemoryAtlasIndexer.d.ts +32 -0
- package/dist/atlas/MemoryAtlasIndexer.js +74 -0
- package/dist/atlas/MemoryAtlasQueryCompiler.d.ts +23 -0
- package/dist/atlas/MemoryAtlasQueryCompiler.js +55 -0
- package/dist/atlas/MemoryAtlasService.d.ts +25 -0
- package/dist/atlas/MemoryAtlasService.js +216 -0
- package/dist/atlas/MemoryAtlasTypes.d.ts +107 -0
- package/dist/atlas/MemoryAtlasTypes.js +1 -0
- package/dist/atlas/index.d.ts +6 -0
- package/dist/atlas/index.js +5 -0
- package/dist/backend/SemanticBackend.d.ts +40 -0
- package/dist/backend/SemanticBackend.js +107 -0
- package/dist/batch/IngestionCursorStore.d.ts +52 -0
- package/dist/batch/IngestionCursorStore.js +153 -0
- package/dist/batch/InstalledBatchProcessor.d.ts +88 -0
- package/dist/batch/InstalledBatchProcessor.js +179 -0
- package/dist/batch/SourceOnboarding.d.ts +56 -0
- package/dist/batch/SourceOnboarding.js +366 -0
- package/dist/belief/BeliefGovernanceService.d.ts +59 -0
- package/dist/belief/BeliefGovernanceService.js +183 -0
- package/dist/belief/BeliefStore.d.ts +78 -0
- package/dist/belief/BeliefStore.js +898 -0
- package/dist/benchmark/BenchmarkRegistry.d.ts +16 -0
- package/dist/benchmark/BenchmarkRegistry.js +97 -0
- package/dist/benchmark/BenchmarkReport.d.ts +23 -0
- package/dist/benchmark/BenchmarkReport.js +62 -0
- package/dist/benchmark/BenchmarkRunner.d.ts +27 -0
- package/dist/benchmark/BenchmarkRunner.js +64 -0
- package/dist/benchmark/BrainEval.d.ts +134 -0
- package/dist/benchmark/BrainEval.js +252 -0
- package/dist/benchmark/ExternalBenchmarkRunner.d.ts +8 -0
- package/dist/benchmark/ExternalBenchmarkRunner.js +12 -0
- package/dist/benchmark/LongMemEvalAdapter.d.ts +46 -0
- package/dist/benchmark/LongMemEvalAdapter.js +88 -0
- package/dist/benchmark/LongMemEvalCli.d.ts +6 -0
- package/dist/benchmark/LongMemEvalCli.js +26 -0
- package/dist/bin/CliJson.d.ts +17 -0
- package/dist/bin/CliJson.js +20 -0
- package/dist/bin/brain-eval.d.ts +3 -0
- package/dist/bin/brain-eval.js +46 -0
- package/dist/bin/cogmem.d.ts +3 -0
- package/dist/bin/cogmem.js +95 -0
- package/dist/bin/compact.d.ts +3 -0
- package/dist/bin/compact.js +96 -0
- package/dist/bin/connect.d.ts +3 -0
- package/dist/bin/connect.js +398 -0
- package/dist/bin/doctor.d.ts +3 -0
- package/dist/bin/doctor.js +171 -0
- package/dist/bin/dream.d.ts +3 -0
- package/dist/bin/dream.js +65 -0
- package/dist/bin/episode.d.ts +3 -0
- package/dist/bin/episode.js +268 -0
- package/dist/bin/explain-recall.d.ts +3 -0
- package/dist/bin/explain-recall.js +139 -0
- package/dist/bin/import-hermes.d.ts +3 -0
- package/dist/bin/import-hermes.js +6 -0
- package/dist/bin/import-openclaw.d.ts +3 -0
- package/dist/bin/import-openclaw.js +6 -0
- package/dist/bin/import-support.d.ts +43 -0
- package/dist/bin/import-support.js +528 -0
- package/dist/bin/init.d.ts +30 -0
- package/dist/bin/init.js +761 -0
- package/dist/bin/mcp.d.ts +3 -0
- package/dist/bin/mcp.js +52 -0
- package/dist/bin/memory.d.ts +3 -0
- package/dist/bin/memory.js +803 -0
- package/dist/bin/migrate-vectors.d.ts +3 -0
- package/dist/bin/migrate-vectors.js +74 -0
- package/dist/bin/migrate.d.ts +3 -0
- package/dist/bin/migrate.js +95 -0
- package/dist/bin/normalize-transcript.d.ts +16 -0
- package/dist/bin/normalize-transcript.js +153 -0
- package/dist/bin/openclaw.d.ts +3 -0
- package/dist/bin/openclaw.js +78 -0
- package/dist/bin/prospective.d.ts +3 -0
- package/dist/bin/prospective.js +115 -0
- package/dist/bin/re-embed.d.ts +3 -0
- package/dist/bin/re-embed.js +46 -0
- package/dist/bin/repair.d.ts +3 -0
- package/dist/bin/repair.js +118 -0
- package/dist/bin/snapshot.d.ts +3 -0
- package/dist/bin/snapshot.js +100 -0
- package/dist/bin/strategy.d.ts +3 -0
- package/dist/bin/strategy.js +66 -0
- package/dist/bin/update-release.d.ts +15 -0
- package/dist/bin/update-release.js +62 -0
- package/dist/bin/update.d.ts +3 -0
- package/dist/bin/update.js +215 -0
- package/dist/binding/BindingClassifier.d.ts +19 -0
- package/dist/binding/BindingClassifier.js +270 -0
- package/dist/binding/BindingDecisionEngine.d.ts +11 -0
- package/dist/binding/BindingDecisionEngine.js +13 -0
- package/dist/binding/ClaimKeyGenerator.d.ts +4 -0
- package/dist/binding/ClaimKeyGenerator.js +21 -0
- package/dist/binding/MemoryBindingService.d.ts +28 -0
- package/dist/binding/MemoryBindingService.js +283 -0
- package/dist/binding/MemoryBindingTypes.d.ts +140 -0
- package/dist/binding/MemoryBindingTypes.js +1 -0
- package/dist/binding/TopicPathRegistry.d.ts +5 -0
- package/dist/binding/TopicPathRegistry.js +33 -0
- package/dist/binding/index.d.ts +12 -0
- package/dist/binding/index.js +6 -0
- package/dist/boards/ApprovalBoard.d.ts +14 -0
- package/dist/boards/ApprovalBoard.js +32 -0
- package/dist/boards/Board.d.ts +23 -0
- package/dist/boards/Board.js +1 -0
- package/dist/boards/BoardEventBuffer.d.ts +10 -0
- package/dist/boards/BoardEventBuffer.js +22 -0
- package/dist/boards/BoardEventBus.d.ts +15 -0
- package/dist/boards/BoardEventBus.js +38 -0
- package/dist/boards/BoardEventFilter.d.ts +5 -0
- package/dist/boards/BoardEventFilter.js +1 -0
- package/dist/boards/BoardRegistry.d.ts +11 -0
- package/dist/boards/BoardRegistry.js +15 -0
- package/dist/boards/ContextBoard.d.ts +15 -0
- package/dist/boards/ContextBoard.js +33 -0
- package/dist/boards/MemoryBoard.d.ts +13 -0
- package/dist/boards/MemoryBoard.js +30 -0
- package/dist/boards/ProcessBoard.d.ts +16 -0
- package/dist/boards/ProcessBoard.js +56 -0
- package/dist/boards/ProposalBoard.d.ts +13 -0
- package/dist/boards/ProposalBoard.js +37 -0
- package/dist/boards/ReasoningTraceBoard.d.ts +11 -0
- package/dist/boards/ReasoningTraceBoard.js +34 -0
- package/dist/boards/TaskBoard.d.ts +14 -0
- package/dist/boards/TaskBoard.js +37 -0
- package/dist/boards/index.d.ts +13 -0
- package/dist/boards/index.js +12 -0
- package/dist/config/CogmemConfig.d.ts +43 -0
- package/dist/config/CogmemConfig.js +247 -0
- package/dist/config/VectorDimension.d.ts +13 -0
- package/dist/config/VectorDimension.js +53 -0
- package/dist/context/ContextCortex.d.ts +71 -0
- package/dist/context/ContextCortex.js +156 -0
- package/dist/context/index.d.ts +2 -0
- package/dist/context/index.js +1 -0
- package/dist/core/ImportanceLevels.d.ts +4 -0
- package/dist/core/ImportanceLevels.js +6 -0
- package/dist/core/IntentParser.d.ts +12 -0
- package/dist/core/IntentParser.js +211 -0
- package/dist/core/MemoryGraph.d.ts +100 -0
- package/dist/core/MemoryGraph.js +860 -0
- package/dist/core/Metabolism.d.ts +43 -0
- package/dist/core/Metabolism.js +196 -0
- package/dist/core/Neuron.d.ts +20 -0
- package/dist/core/Neuron.js +51 -0
- package/dist/core/QueryClassifier.d.ts +36 -0
- package/dist/core/QueryClassifier.js +161 -0
- package/dist/core/Reflection.d.ts +42 -0
- package/dist/core/Reflection.js +183 -0
- package/dist/core/ResonanceCore.d.ts +26 -0
- package/dist/core/ResonanceCore.js +115 -0
- package/dist/core/Synapse.d.ts +10 -0
- package/dist/core/Synapse.js +27 -0
- package/dist/core/TwoStagePulseRanker.d.ts +16 -0
- package/dist/core/TwoStagePulseRanker.js +120 -0
- package/dist/dream/DreamScheduler.d.ts +47 -0
- package/dist/dream/DreamScheduler.js +156 -0
- package/dist/dream/index.d.ts +2 -0
- package/dist/dream/index.js +1 -0
- package/dist/embedding/EmbeddingProvider.d.ts +16 -0
- package/dist/embedding/EmbeddingProvider.js +12 -0
- package/dist/embedding/NeuronEmbeddingStore.d.ts +38 -0
- package/dist/embedding/NeuronEmbeddingStore.js +193 -0
- package/dist/embedding/OllamaEmbeddingProvider.d.ts +21 -0
- package/dist/embedding/OllamaEmbeddingProvider.js +65 -0
- package/dist/embedding/QwenAPIEmbeddingProvider.d.ts +26 -0
- package/dist/embedding/QwenAPIEmbeddingProvider.js +53 -0
- package/dist/embedding/ReEmbeddingPipeline.d.ts +30 -0
- package/dist/embedding/ReEmbeddingPipeline.js +119 -0
- package/dist/embedding/ReEmbeddingStatus.d.ts +10 -0
- package/dist/embedding/ReEmbeddingStatus.js +1 -0
- package/dist/embedding/index.d.ts +11 -0
- package/dist/embedding/index.js +5 -0
- package/dist/encryption/AesGcmEncryptionProvider.d.ts +9 -0
- package/dist/encryption/AesGcmEncryptionProvider.js +42 -0
- package/dist/encryption/EncryptionProvider.d.ts +6 -0
- package/dist/encryption/EncryptionProvider.js +3 -0
- package/dist/encryption/index.d.ts +4 -0
- package/dist/encryption/index.js +2 -0
- package/dist/engine/BeliefExtractor.d.ts +48 -0
- package/dist/engine/BeliefExtractor.js +1189 -0
- package/dist/engine/CognitiveGraphCompiler.d.ts +24 -0
- package/dist/engine/CognitiveGraphCompiler.js +243 -0
- package/dist/engine/ConsolidationPipeline.d.ts +66 -0
- package/dist/engine/ConsolidationPipeline.js +376 -0
- package/dist/engine/ConsolidationTrigger.d.ts +18 -0
- package/dist/engine/ConsolidationTrigger.js +41 -0
- package/dist/engine/CrossTopicSynthesizer.d.ts +28 -0
- package/dist/engine/CrossTopicSynthesizer.js +70 -0
- package/dist/engine/CrossTopicTrigger.d.ts +17 -0
- package/dist/engine/CrossTopicTrigger.js +29 -0
- package/dist/engine/DeepWriteConfig.d.ts +14 -0
- package/dist/engine/DeepWriteConfig.js +37 -0
- package/dist/engine/DeepWriteMemoryCompiler.d.ts +43 -0
- package/dist/engine/DeepWriteMemoryCompiler.js +42 -0
- package/dist/engine/DeepWriteMemoryOrchestrator.d.ts +60 -0
- package/dist/engine/DeepWriteMemoryOrchestrator.js +175 -0
- package/dist/engine/DeepWritePromotionPolicy.d.ts +48 -0
- package/dist/engine/DeepWritePromotionPolicy.js +514 -0
- package/dist/engine/DeepWriteRedactor.d.ts +14 -0
- package/dist/engine/DeepWriteRedactor.js +53 -0
- package/dist/engine/DreamCuratorSchedule.d.ts +18 -0
- package/dist/engine/DreamCuratorSchedule.js +95 -0
- package/dist/engine/DreamCuratorWorker.d.ts +67 -0
- package/dist/engine/DreamCuratorWorker.js +908 -0
- package/dist/engine/EntityResolutionEngine.d.ts +45 -0
- package/dist/engine/EntityResolutionEngine.js +105 -0
- package/dist/engine/EpisodicSemanticDistiller.d.ts +25 -0
- package/dist/engine/EpisodicSemanticDistiller.js +68 -0
- package/dist/engine/EvolutionVerifier.d.ts +39 -0
- package/dist/engine/EvolutionVerifier.js +104 -0
- package/dist/engine/FactCompiler.d.ts +41 -0
- package/dist/engine/FactCompiler.js +820 -0
- package/dist/engine/GraphCommunityEngine.d.ts +20 -0
- package/dist/engine/GraphCommunityEngine.js +91 -0
- package/dist/engine/ImportanceSignalDetector.d.ts +11 -0
- package/dist/engine/ImportanceSignalDetector.js +51 -0
- package/dist/engine/IngestionEngine.d.ts +44 -0
- package/dist/engine/IngestionEngine.js +182 -0
- package/dist/engine/InteractionBinder.d.ts +16 -0
- package/dist/engine/InteractionBinder.js +87 -0
- package/dist/engine/LocalSemanticCompiler.d.ts +40 -0
- package/dist/engine/LocalSemanticCompiler.js +111 -0
- package/dist/engine/MemoryConsolidationEngine.d.ts +11 -0
- package/dist/engine/MemoryConsolidationEngine.js +21 -0
- package/dist/engine/MemoryGate.d.ts +10 -0
- package/dist/engine/MemoryGate.js +34 -0
- package/dist/engine/OfflineConsolidationPipeline.d.ts +148 -0
- package/dist/engine/OfflineConsolidationPipeline.js +670 -0
- package/dist/engine/OrphanCleaner.d.ts +15 -0
- package/dist/engine/OrphanCleaner.js +27 -0
- package/dist/engine/PipelineMetrics.d.ts +32 -0
- package/dist/engine/PipelineMetrics.js +126 -0
- package/dist/engine/PrincipleDecayPolicy.d.ts +17 -0
- package/dist/engine/PrincipleDecayPolicy.js +64 -0
- package/dist/engine/TopologyCompiler.d.ts +25 -0
- package/dist/engine/TopologyCompiler.js +276 -0
- package/dist/engine/WorkingMemoryDelta.d.ts +23 -0
- package/dist/engine/WorkingMemoryDelta.js +63 -0
- package/dist/entity/EntityGovernanceService.d.ts +47 -0
- package/dist/entity/EntityGovernanceService.js +215 -0
- package/dist/entity/index.d.ts +3 -0
- package/dist/entity/index.js +1 -0
- package/dist/episode/CogmemBlockStripper.d.ts +11 -0
- package/dist/episode/CogmemBlockStripper.js +58 -0
- package/dist/episode/CorrectionResolver.d.ts +30 -0
- package/dist/episode/CorrectionResolver.js +17 -0
- package/dist/episode/EpisodeAssembler.d.ts +54 -0
- package/dist/episode/EpisodeAssembler.js +203 -0
- package/dist/episode/EpisodeImportIdentity.d.ts +7 -0
- package/dist/episode/EpisodeImportIdentity.js +17 -0
- package/dist/episode/EpisodeSemanticSummarizer.d.ts +4 -0
- package/dist/episode/EpisodeSemanticSummarizer.js +31 -0
- package/dist/episode/EpisodeStore.d.ts +189 -0
- package/dist/episode/EpisodeStore.js +680 -0
- package/dist/episode/EpisodeTypes.d.ts +96 -0
- package/dist/episode/EpisodeTypes.js +1 -0
- package/dist/episode/TurnRelationClassifier.d.ts +40 -0
- package/dist/episode/TurnRelationClassifier.js +205 -0
- package/dist/episode/index.d.ts +9 -0
- package/dist/episode/index.js +8 -0
- package/dist/eval/datasets/contradiction_injection.d.ts +3 -0
- package/dist/eval/datasets/contradiction_injection.js +56 -0
- package/dist/eval/datasets/noisy_tool_output_corpus.d.ts +16 -0
- package/dist/eval/datasets/noisy_tool_output_corpus.js +59 -0
- package/dist/eval/datasets/synthetic_long_conversation.d.ts +40 -0
- package/dist/eval/datasets/synthetic_long_conversation.js +136 -0
- package/dist/eval/runners/EvalRunner.d.ts +12 -0
- package/dist/eval/runners/EvalRunner.js +66 -0
- package/dist/eval/runners/ReportFormatter.d.ts +13 -0
- package/dist/eval/runners/ReportFormatter.js +59 -0
- package/dist/eval/strategy/ContextOutcomeStore.d.ts +12 -0
- package/dist/eval/strategy/ContextOutcomeStore.js +44 -0
- package/dist/eval/strategy/ContextPolicyScorer.d.ts +25 -0
- package/dist/eval/strategy/ContextPolicyScorer.js +58 -0
- package/dist/eval/strategy/MemoryUseJudge.d.ts +49 -0
- package/dist/eval/strategy/MemoryUseJudge.js +75 -0
- package/dist/eval/strategy/StrategyDiversitySelector.d.ts +8 -0
- package/dist/eval/strategy/StrategyDiversitySelector.js +44 -0
- package/dist/eval/strategy/StrategyRolloutEvaluator.d.ts +15 -0
- package/dist/eval/strategy/StrategyRolloutEvaluator.js +30 -0
- package/dist/eval/strategy/index.d.ts +6 -0
- package/dist/eval/strategy/index.js +5 -0
- package/dist/factory.d.ts +726 -0
- package/dist/factory.js +2118 -0
- package/dist/governance/CandidateReviewService.d.ts +33 -0
- package/dist/governance/CandidateReviewService.js +126 -0
- package/dist/governance/ContradictionResolver.d.ts +22 -0
- package/dist/governance/ContradictionResolver.js +54 -0
- package/dist/governance/CredibilityScorer.d.ts +10 -0
- package/dist/governance/CredibilityScorer.js +29 -0
- package/dist/governance/DecayPolicy.d.ts +18 -0
- package/dist/governance/DecayPolicy.js +28 -0
- package/dist/governance/MemoryExplain.d.ts +46 -0
- package/dist/governance/MemoryExplain.js +62 -0
- package/dist/governance/MemoryGovernanceExecutor.d.ts +18 -0
- package/dist/governance/MemoryGovernanceExecutor.js +37 -0
- package/dist/governance/MemoryGovernancePlan.d.ts +36 -0
- package/dist/governance/MemoryGovernancePlan.js +1 -0
- package/dist/governance/MemoryGovernanceValidator.d.ts +13 -0
- package/dist/governance/MemoryGovernanceValidator.js +53 -0
- package/dist/governance/ObservationHygieneRules.d.ts +17 -0
- package/dist/governance/ObservationHygieneRules.js +28 -0
- package/dist/governance/PiiRedactor.d.ts +20 -0
- package/dist/governance/PiiRedactor.js +37 -0
- package/dist/governance/SupersedeChain.d.ts +21 -0
- package/dist/governance/SupersedeChain.js +107 -0
- package/dist/governance/index.d.ts +14 -0
- package/dist/governance/index.js +6 -0
- package/dist/graph/BrainGraphView.d.ts +20 -0
- package/dist/graph/BrainGraphView.js +45 -0
- package/dist/host/openclaw/AutoMemoryPluginInstaller.d.ts +45 -0
- package/dist/host/openclaw/AutoMemoryPluginInstaller.js +1904 -0
- package/dist/internal.d.ts +148 -0
- package/dist/internal.js +144 -0
- package/dist/lexicon/coreMemoryLexicon.d.ts +96 -0
- package/dist/lexicon/coreMemoryLexicon.js +525 -0
- package/dist/lexicon/language-packs/en.d.ts +42 -0
- package/dist/lexicon/language-packs/en.js +41 -0
- package/dist/lexicon/language-packs/zh.d.ts +42 -0
- package/dist/lexicon/language-packs/zh.js +41 -0
- package/dist/lexicon/zh/entities.d.ts +2 -0
- package/dist/lexicon/zh/entities.js +17 -0
- package/dist/lexicon/zh/index.d.ts +5 -0
- package/dist/lexicon/zh/index.js +3 -0
- package/dist/lexicon/zh/stopwords.d.ts +2 -0
- package/dist/lexicon/zh/stopwords.js +22 -0
- package/dist/lexicon/zh/topics.d.ts +6 -0
- package/dist/lexicon/zh/topics.js +52 -0
- package/dist/mcp/CoreMcpTools.d.ts +33 -0
- package/dist/mcp/CoreMcpTools.js +832 -0
- package/dist/mcp/server.d.ts +5 -0
- package/dist/mcp/server.js +29 -0
- package/dist/meta/MetaObservationCollector.d.ts +37 -0
- package/dist/meta/MetaObservationCollector.js +348 -0
- package/dist/meta/PolicyProposalGenerator.d.ts +11 -0
- package/dist/meta/PolicyProposalGenerator.js +159 -0
- package/dist/meta/ProposalApplier.d.ts +18 -0
- package/dist/meta/ProposalApplier.js +91 -0
- package/dist/meta/ProposalConfigOverlay.d.ts +13 -0
- package/dist/meta/ProposalConfigOverlay.js +27 -0
- package/dist/meta/ProposalEvalRunner.d.ts +31 -0
- package/dist/meta/ProposalEvalRunner.js +62 -0
- package/dist/meta/ProposalLedger.d.ts +34 -0
- package/dist/meta/ProposalLedger.js +242 -0
- package/dist/meta/types.d.ts +63 -0
- package/dist/meta/types.js +1 -0
- package/dist/migrations/0001_init.d.ts +4 -0
- package/dist/migrations/0001_init.js +67 -0
- package/dist/migrations/0002_v06_platform.d.ts +10 -0
- package/dist/migrations/0002_v06_platform.js +103 -0
- package/dist/migrations/0003_v07_dialogues.d.ts +9 -0
- package/dist/migrations/0003_v07_dialogues.js +53 -0
- package/dist/migrations/0004_v09_self_improvement.d.ts +9 -0
- package/dist/migrations/0004_v09_self_improvement.js +100 -0
- package/dist/migrations/0005_dialogue_buffer.d.ts +8 -0
- package/dist/migrations/0005_dialogue_buffer.js +44 -0
- package/dist/migrations/0006_deep_write_memory.d.ts +3 -0
- package/dist/migrations/0006_deep_write_memory.js +54 -0
- package/dist/migrations/0007_deep_write_summaries.d.ts +3 -0
- package/dist/migrations/0007_deep_write_summaries.js +24 -0
- package/dist/migrations/0009_memory_importance.d.ts +3 -0
- package/dist/migrations/0009_memory_importance.js +18 -0
- package/dist/migrations/0010_skill_neurons.d.ts +3 -0
- package/dist/migrations/0010_skill_neurons.js +19 -0
- package/dist/migrations/0011_topic_path.d.ts +3 -0
- package/dist/migrations/0011_topic_path.js +19 -0
- package/dist/migrations/0012_governance_security.d.ts +3 -0
- package/dist/migrations/0012_governance_security.js +23 -0
- package/dist/migrations/0015_memory_governance.d.ts +3 -0
- package/dist/migrations/0015_memory_governance.js +74 -0
- package/dist/migrations/0016_entity_governance.d.ts +3 -0
- package/dist/migrations/0016_entity_governance.js +40 -0
- package/dist/migrations/0017_belief_graph.d.ts +3 -0
- package/dist/migrations/0017_belief_graph.js +41 -0
- package/dist/migrations/0018_temporal_memory.d.ts +3 -0
- package/dist/migrations/0018_temporal_memory.js +25 -0
- package/dist/migrations/0019_context_cortex.d.ts +3 -0
- package/dist/migrations/0019_context_cortex.js +19 -0
- package/dist/migrations/0020_prospective_memory.d.ts +3 -0
- package/dist/migrations/0020_prospective_memory.js +42 -0
- package/dist/migrations/0021_strategy_cortex.d.ts +3 -0
- package/dist/migrations/0021_strategy_cortex.js +23 -0
- package/dist/migrations/0022_episode_dream_engine.d.ts +3 -0
- package/dist/migrations/0022_episode_dream_engine.js +74 -0
- package/dist/migrations/0023_episode_dream_hardening.d.ts +3 -0
- package/dist/migrations/0023_episode_dream_hardening.js +65 -0
- package/dist/migrations/0024_episode_ontology_reliability.d.ts +3 -0
- package/dist/migrations/0024_episode_ontology_reliability.js +70 -0
- package/dist/migrations/0025_memory_atlas.d.ts +6 -0
- package/dist/migrations/0025_memory_atlas.js +268 -0
- package/dist/migrations/0026_runtime_governance_atlas_reliability.d.ts +3 -0
- package/dist/migrations/0026_runtime_governance_atlas_reliability.js +72 -0
- package/dist/migrations/0027_openclaw_upgrade_hotfix.d.ts +3 -0
- package/dist/migrations/0027_openclaw_upgrade_hotfix.js +21 -0
- package/dist/migrations/SchemaMigrationRunner.d.ts +21 -0
- package/dist/migrations/SchemaMigrationRunner.js +67 -0
- package/dist/migrations/index.d.ts +36 -0
- package/dist/migrations/index.js +57 -0
- package/dist/models/ModelCapabilityRouter.d.ts +17 -0
- package/dist/models/ModelCapabilityRouter.js +75 -0
- package/dist/models/ModelRegistry.d.ts +15 -0
- package/dist/models/ModelRegistry.js +132 -0
- package/dist/models/ModelRole.d.ts +19 -0
- package/dist/models/ModelRole.js +1 -0
- package/dist/models/UserInsight.d.ts +16 -0
- package/dist/models/UserInsight.js +9 -0
- package/dist/models/UserInsightExtractor.d.ts +19 -0
- package/dist/models/UserInsightExtractor.js +99 -0
- package/dist/models/UserModelManager.d.ts +21 -0
- package/dist/models/UserModelManager.js +41 -0
- package/dist/models/UserModelStore.d.ts +20 -0
- package/dist/models/UserModelStore.js +136 -0
- package/dist/models/WorkingMemoryReporter.d.ts +16 -0
- package/dist/models/WorkingMemoryReporter.js +38 -0
- package/dist/models/adapters/MemoryReviewAdapter.d.ts +12 -0
- package/dist/models/adapters/MemoryReviewAdapter.js +77 -0
- package/dist/models/index.d.ts +8 -0
- package/dist/models/index.js +5 -0
- package/dist/models/providers/AnthropicClient.d.ts +17 -0
- package/dist/models/providers/AnthropicClient.js +40 -0
- package/dist/models/providers/OpenAICompatibleClient.d.ts +24 -0
- package/dist/models/providers/OpenAICompatibleClient.js +76 -0
- package/dist/observability/DecisionExplainer.d.ts +5 -0
- package/dist/observability/DecisionExplainer.js +62 -0
- package/dist/observability/TraceEvent.d.ts +11 -0
- package/dist/observability/TraceEvent.js +1 -0
- package/dist/observability/TraceQuery.d.ts +15 -0
- package/dist/observability/TraceQuery.js +28 -0
- package/dist/observability/TraceStore.d.ts +15 -0
- package/dist/observability/TraceStore.js +110 -0
- package/dist/observability/TraceWriter.d.ts +8 -0
- package/dist/observability/TraceWriter.js +14 -0
- package/dist/ontology/MemoryOntology.d.ts +4 -0
- package/dist/ontology/MemoryOntology.js +7 -0
- package/dist/prospective/ProspectiveMemoryService.d.ts +79 -0
- package/dist/prospective/ProspectiveMemoryService.js +258 -0
- package/dist/prospective/index.d.ts +2 -0
- package/dist/prospective/index.js +1 -0
- package/dist/public.d.ts +160 -0
- package/dist/public.js +115 -0
- package/dist/recall/BrainRecall.d.ts +96 -0
- package/dist/recall/BrainRecall.js +574 -0
- package/dist/recall/HierarchicalRecallRouter.d.ts +24 -0
- package/dist/recall/HierarchicalRecallRouter.js +62 -0
- package/dist/recall/RecallExplanation.d.ts +59 -0
- package/dist/recall/RecallExplanation.js +244 -0
- package/dist/recall/RecallGovernance.d.ts +10 -0
- package/dist/recall/RecallGovernance.js +83 -0
- package/dist/recall/RecallSufficiencyGate.d.ts +40 -0
- package/dist/recall/RecallSufficiencyGate.js +208 -0
- package/dist/recall/SourceContextMetadata.d.ts +49 -0
- package/dist/recall/SourceContextMetadata.js +134 -0
- package/dist/recall/TopicClassifier.d.ts +33 -0
- package/dist/recall/TopicClassifier.js +138 -0
- package/dist/recall/TopicDecayPolicy.d.ts +15 -0
- package/dist/recall/TopicDecayPolicy.js +46 -0
- package/dist/recall/TopicRegistry.d.ts +12 -0
- package/dist/recall/TopicRegistry.js +26 -0
- package/dist/recall/TopicSummaryBoard.d.ts +27 -0
- package/dist/recall/TopicSummaryBoard.js +139 -0
- package/dist/recall/VectorCandidateFilter.d.ts +50 -0
- package/dist/recall/VectorCandidateFilter.js +78 -0
- package/dist/retrieval/ConditionDslEvaluator.d.ts +33 -0
- package/dist/retrieval/ConditionDslEvaluator.js +160 -0
- package/dist/retrieval/EntityActivationIndex.d.ts +14 -0
- package/dist/retrieval/EntityActivationIndex.js +19 -0
- package/dist/retrieval/EvidenceFusionPolicy.d.ts +30 -0
- package/dist/retrieval/EvidenceFusionPolicy.js +112 -0
- package/dist/retrieval/EvidenceFusionRanker.d.ts +13 -0
- package/dist/retrieval/EvidenceFusionRanker.js +17 -0
- package/dist/retrieval/NarrativeRecallAssembler.d.ts +32 -0
- package/dist/retrieval/NarrativeRecallAssembler.js +27 -0
- package/dist/retrieval/NativeQueryParser.d.ts +23 -0
- package/dist/retrieval/NativeQueryParser.js +135 -0
- package/dist/retrieval/PlanDslExecutor.d.ts +67 -0
- package/dist/retrieval/PlanDslExecutor.js +194 -0
- package/dist/retrieval/PolicyRuntimeEvaluator.d.ts +48 -0
- package/dist/retrieval/PolicyRuntimeEvaluator.js +96 -0
- package/dist/retrieval/PolicySideEffectExecutor.d.ts +50 -0
- package/dist/retrieval/PolicySideEffectExecutor.js +202 -0
- package/dist/retrieval/PulseRetrievalEngine.d.ts +37 -0
- package/dist/retrieval/PulseRetrievalEngine.js +51 -0
- package/dist/retrieval/QueryCompiler.d.ts +18 -0
- package/dist/retrieval/QueryCompiler.js +97 -0
- package/dist/retrieval/QueryTimePendingEntityResolver.d.ts +67 -0
- package/dist/retrieval/QueryTimePendingEntityResolver.js +260 -0
- package/dist/retrieval/RetrievalPlanner.d.ts +42 -0
- package/dist/retrieval/RetrievalPlanner.js +209 -0
- package/dist/retrieval/TemporalBranchSearch.d.ts +38 -0
- package/dist/retrieval/TemporalBranchSearch.js +109 -0
- package/dist/retrieval/UniverseNavigator.d.ts +43 -0
- package/dist/retrieval/UniverseNavigator.js +75 -0
- package/dist/retrieval/UniverseTraversalExecutor.d.ts +21 -0
- package/dist/retrieval/UniverseTraversalExecutor.js +77 -0
- package/dist/routing/AnswerEvidenceTrace.d.ts +18 -0
- package/dist/routing/AnswerEvidenceTrace.js +1 -0
- package/dist/routing/BrainToolDispatcher.d.ts +37 -0
- package/dist/routing/BrainToolDispatcher.js +163 -0
- package/dist/routing/ConfidenceGate.d.ts +26 -0
- package/dist/routing/ConfidenceGate.js +40 -0
- package/dist/routing/ConfirmationPhraseMatcher.d.ts +9 -0
- package/dist/routing/ConfirmationPhraseMatcher.js +43 -0
- package/dist/routing/DirectReplyFormatter.d.ts +5 -0
- package/dist/routing/DirectReplyFormatter.js +55 -0
- package/dist/routing/EvidenceBudgetManager.d.ts +30 -0
- package/dist/routing/EvidenceBudgetManager.js +55 -0
- package/dist/routing/ExecutionLoop.d.ts +79 -0
- package/dist/routing/ExecutionLoop.js +234 -0
- package/dist/routing/IntentClassifier.d.ts +15 -0
- package/dist/routing/IntentClassifier.js +97 -0
- package/dist/routing/IntentPatternMatcher.d.ts +12 -0
- package/dist/routing/IntentPatternMatcher.js +206 -0
- package/dist/routing/IterativeLLMClarifier.d.ts +80 -0
- package/dist/routing/IterativeLLMClarifier.js +408 -0
- package/dist/routing/LLMToolSchema.d.ts +60 -0
- package/dist/routing/LLMToolSchema.js +143 -0
- package/dist/routing/MessageRouter.d.ts +20 -0
- package/dist/routing/MessageRouter.js +58 -0
- package/dist/routing/SessionContextSelector.d.ts +12 -0
- package/dist/routing/SessionContextSelector.js +86 -0
- package/dist/routing/SystemIntentClassifier.d.ts +15 -0
- package/dist/routing/SystemIntentClassifier.js +50 -0
- package/dist/routing/TaskPlan.d.ts +31 -0
- package/dist/routing/TaskPlan.js +1 -0
- package/dist/routing/TaskRouter.d.ts +13 -0
- package/dist/routing/TaskRouter.js +111 -0
- package/dist/routing/ToolCallParser.d.ts +16 -0
- package/dist/routing/ToolCallParser.js +123 -0
- package/dist/routing/ToolEvidenceNormalizer.d.ts +13 -0
- package/dist/routing/ToolEvidenceNormalizer.js +96 -0
- package/dist/routing/ToolEvidencePack.d.ts +36 -0
- package/dist/routing/ToolEvidencePack.js +84 -0
- package/dist/routing/ToolResultSanitizer.d.ts +19 -0
- package/dist/routing/ToolResultSanitizer.js +58 -0
- package/dist/routing/ToolUsePolicy.d.ts +78 -0
- package/dist/routing/ToolUsePolicy.js +163 -0
- package/dist/routing/index.d.ts +32 -0
- package/dist/routing/index.js +19 -0
- package/dist/routing/templates/ability_template.d.ts +2 -0
- package/dist/routing/templates/ability_template.js +34 -0
- package/dist/routing/templates/approvals_template.d.ts +2 -0
- package/dist/routing/templates/approvals_template.js +43 -0
- package/dist/routing/templates/context_template.d.ts +2 -0
- package/dist/routing/templates/context_template.js +25 -0
- package/dist/routing/templates/contradictions_template.d.ts +2 -0
- package/dist/routing/templates/contradictions_template.js +36 -0
- package/dist/routing/templates/importance_template.d.ts +2 -0
- package/dist/routing/templates/importance_template.js +23 -0
- package/dist/routing/templates/memory_template.d.ts +2 -0
- package/dist/routing/templates/memory_template.js +37 -0
- package/dist/routing/templates/self_manifest_template.d.ts +5 -0
- package/dist/routing/templates/self_manifest_template.js +64 -0
- package/dist/routing/templates/tasks_template.d.ts +2 -0
- package/dist/routing/templates/tasks_template.js +41 -0
- package/dist/routing/templates/trace_template.d.ts +2 -0
- package/dist/routing/templates/trace_template.js +37 -0
- package/dist/routing/tools/EntityExpandTool.d.ts +25 -0
- package/dist/routing/tools/EntityExpandTool.js +59 -0
- package/dist/routing/tools/NeuronContextTool.d.ts +32 -0
- package/dist/routing/tools/NeuronContextTool.js +66 -0
- package/dist/routing/tools/SecondaryRecallTool.d.ts +27 -0
- package/dist/routing/tools/SecondaryRecallTool.js +30 -0
- package/dist/routing/tools/SkillDiscoveryTool.d.ts +13 -0
- package/dist/routing/tools/SkillDiscoveryTool.js +11 -0
- package/dist/snapshot/SnapshotExporter.d.ts +13 -0
- package/dist/snapshot/SnapshotExporter.js +70 -0
- package/dist/snapshot/SnapshotHeader.d.ts +15 -0
- package/dist/snapshot/SnapshotHeader.js +1 -0
- package/dist/snapshot/SnapshotImporter.d.ts +20 -0
- package/dist/snapshot/SnapshotImporter.js +40 -0
- package/dist/snapshot/errors.d.ts +18 -0
- package/dist/snapshot/errors.js +34 -0
- package/dist/snapshot/index.d.ts +5 -0
- package/dist/snapshot/index.js +3 -0
- package/dist/storage/StorageCompactor.d.ts +30 -0
- package/dist/storage/StorageCompactor.js +95 -0
- package/dist/store/ActivationStore.d.ts +45 -0
- package/dist/store/ActivationStore.js +135 -0
- package/dist/store/BackgroundJobStore.d.ts +49 -0
- package/dist/store/BackgroundJobStore.js +156 -0
- package/dist/store/CandidateReviewStore.d.ts +33 -0
- package/dist/store/CandidateReviewStore.js +67 -0
- package/dist/store/CognitiveGraphStore.d.ts +42 -0
- package/dist/store/CognitiveGraphStore.js +193 -0
- package/dist/store/CompilerConfidenceStore.d.ts +20 -0
- package/dist/store/CompilerConfidenceStore.js +76 -0
- package/dist/store/DeepWriteCandidateStore.d.ts +94 -0
- package/dist/store/DeepWriteCandidateStore.js +290 -0
- package/dist/store/DeterministicEmbedder.d.ts +10 -0
- package/dist/store/DeterministicEmbedder.js +24 -0
- package/dist/store/DreamLedgerStore.d.ts +22 -0
- package/dist/store/DreamLedgerStore.js +84 -0
- package/dist/store/Embedder.d.ts +14 -0
- package/dist/store/Embedder.js +52 -0
- package/dist/store/EmbedderFactory.d.ts +12 -0
- package/dist/store/EmbedderFactory.js +51 -0
- package/dist/store/EntityStore.d.ts +195 -0
- package/dist/store/EntityStore.js +941 -0
- package/dist/store/EventStore.d.ts +118 -0
- package/dist/store/EventStore.js +699 -0
- package/dist/store/FactStore.d.ts +76 -0
- package/dist/store/FactStore.js +356 -0
- package/dist/store/HnswlibVectorStore.d.ts +2 -0
- package/dist/store/HnswlibVectorStore.js +1 -0
- package/dist/store/IVectorStore.d.ts +32 -0
- package/dist/store/IVectorStore.js +1 -0
- package/dist/store/InteractionUnitStore.d.ts +52 -0
- package/dist/store/InteractionUnitStore.js +167 -0
- package/dist/store/MemoryAtlasStore.d.ts +60 -0
- package/dist/store/MemoryAtlasStore.js +500 -0
- package/dist/store/MemoryBindingStore.d.ts +77 -0
- package/dist/store/MemoryBindingStore.js +608 -0
- package/dist/store/MemoryGovernanceStore.d.ts +23 -0
- package/dist/store/MemoryGovernanceStore.js +103 -0
- package/dist/store/MemoryInspectionStore.d.ts +61 -0
- package/dist/store/MemoryInspectionStore.js +215 -0
- package/dist/store/PlanRuntimeStore.d.ts +83 -0
- package/dist/store/PlanRuntimeStore.js +257 -0
- package/dist/store/PolicyExecutionProjector.d.ts +17 -0
- package/dist/store/PolicyExecutionProjector.js +115 -0
- package/dist/store/PolicyExecutionStore.d.ts +62 -0
- package/dist/store/PolicyExecutionStore.js +290 -0
- package/dist/store/PolicyProjectionStore.d.ts +18 -0
- package/dist/store/PolicyProjectionStore.js +61 -0
- package/dist/store/ProjectionObservabilityStore.d.ts +38 -0
- package/dist/store/ProjectionObservabilityStore.js +310 -0
- package/dist/store/ReasoningChainStore.d.ts +13 -0
- package/dist/store/ReasoningChainStore.js +74 -0
- package/dist/store/RuntimeProjectionStore.d.ts +18 -0
- package/dist/store/RuntimeProjectionStore.js +61 -0
- package/dist/store/RuntimeProjector.d.ts +17 -0
- package/dist/store/RuntimeProjector.js +119 -0
- package/dist/store/SqliteVecStore.d.ts +25 -0
- package/dist/store/SqliteVecStore.js +126 -0
- package/dist/store/SummaryStore.d.ts +56 -0
- package/dist/store/SummaryStore.js +225 -0
- package/dist/store/TemporalAdjacencyStore.d.ts +49 -0
- package/dist/store/TemporalAdjacencyStore.js +300 -0
- package/dist/store/TopologyStore.d.ts +89 -0
- package/dist/store/TopologyStore.js +657 -0
- package/dist/store/VectorProjector.d.ts +22 -0
- package/dist/store/VectorProjector.js +125 -0
- package/dist/store/VectorStore.d.ts +35 -0
- package/dist/store/VectorStore.js +201 -0
- package/dist/strategy/StrategyCapsule.d.ts +44 -0
- package/dist/strategy/StrategyCapsule.js +1 -0
- package/dist/strategy/StrategyConditionedCandidateBuilder.d.ts +9 -0
- package/dist/strategy/StrategyConditionedCandidateBuilder.js +11 -0
- package/dist/strategy/StrategyContextFormatter.d.ts +3 -0
- package/dist/strategy/StrategyContextFormatter.js +25 -0
- package/dist/strategy/StrategyCortex.d.ts +28 -0
- package/dist/strategy/StrategyCortex.js +78 -0
- package/dist/strategy/StrategyTemplateRegistry.d.ts +9 -0
- package/dist/strategy/StrategyTemplateRegistry.js +78 -0
- package/dist/strategy/index.d.ts +6 -0
- package/dist/strategy/index.js +5 -0
- package/dist/temporal/TemporalMemoryService.d.ts +62 -0
- package/dist/temporal/TemporalMemoryService.js +128 -0
- package/dist/temporal/index.d.ts +2 -0
- package/dist/temporal/index.js +1 -0
- package/dist/topic/TopicAliasRegistry.d.ts +21 -0
- package/dist/topic/TopicAliasRegistry.js +67 -0
- package/dist/topic/TopicGovernance.d.ts +21 -0
- package/dist/topic/TopicGovernance.js +173 -0
- package/dist/topic/TopicPathRegistry.d.ts +36 -0
- package/dist/topic/TopicPathRegistry.js +105 -0
- package/dist/topic/TopicRelationGraph.d.ts +23 -0
- package/dist/topic/TopicRelationGraph.js +55 -0
- package/dist/topic/TopicTypes.d.ts +73 -0
- package/dist/topic/TopicTypes.js +1 -0
- package/dist/topic/index.d.ts +6 -0
- package/dist/topic/index.js +5 -0
- package/dist/types/AsyncEnrichment.d.ts +62 -0
- package/dist/types/AsyncEnrichment.js +7 -0
- package/dist/types/BrainRecallResult.d.ts +66 -0
- package/dist/types/BrainRecallResult.js +1 -0
- package/dist/types/ExtensionPoints.d.ts +116 -0
- package/dist/types/ExtensionPoints.js +1 -0
- package/dist/types/Migration.d.ts +22 -0
- package/dist/types/Migration.js +1 -0
- package/dist/types/QueryTimePendingEntityResolution.d.ts +11 -0
- package/dist/types/QueryTimePendingEntityResolution.js +23 -0
- package/dist/types/index.d.ts +855 -0
- package/dist/types/index.js +24 -0
- package/dist/types/query-ir.d.ts +71 -0
- package/dist/types/query-ir.js +4 -0
- package/dist/types/reasoning.d.ts +16 -0
- package/dist/types/reasoning.js +4 -0
- package/dist/utils/AAAKGenerator.d.ts +57 -0
- package/dist/utils/AAAKGenerator.js +212 -0
- package/dist/utils/Config.d.ts +78 -0
- package/dist/utils/Config.js +91 -0
- package/dist/utils/ConversationMarkdownNormalization.d.ts +88 -0
- package/dist/utils/ConversationMarkdownNormalization.js +567 -0
- package/dist/utils/Logger.d.ts +22 -0
- package/dist/utils/Logger.js +77 -0
- package/dist/utils/hash.d.ts +33 -0
- package/dist/utils/hash.js +53 -0
- package/dist/utils/text.d.ts +2 -0
- package/dist/utils/text.js +19 -0
- package/dist/utils/vector.d.ts +26 -0
- package/dist/utils/vector.js +38 -0
- package/examples/hermes-backend/AGENTS.md +218 -0
- package/examples/hermes-backend/README.md +153 -0
- package/examples/hermes-backend/SKILL.md +365 -0
- package/examples/hermes-backend/references/operations.md +202 -0
- package/examples/openclaw-backend/AGENTS.md +195 -0
- package/examples/openclaw-backend/README.md +228 -0
- package/examples/openclaw-backend/SKILL.md +464 -0
- package/examples/openclaw-backend/references/operations.md +269 -0
- package/install.sh +84 -0
- package/package.json +90 -0
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import Database from 'bun:sqlite';
|
|
3
|
+
import { loadCogmemConfig, resolveCogmemConfigPath } from '../config/CogmemConfig.js';
|
|
4
|
+
import { DEFAULT_VECTOR_DIMENSION, parseVectorDimensionValue } from '../config/VectorDimension.js';
|
|
5
|
+
import { NeuronEmbeddingStore } from '../embedding/NeuronEmbeddingStore.js';
|
|
6
|
+
import { SqliteVecStore } from '../store/SqliteVecStore.js';
|
|
7
|
+
import { printCliJson } from './CliJson.js';
|
|
8
|
+
function parseArgs(argv) {
|
|
9
|
+
let dbPath = '';
|
|
10
|
+
let configPath = '';
|
|
11
|
+
let dimension;
|
|
12
|
+
let dryRun = false;
|
|
13
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
14
|
+
const arg = argv[index];
|
|
15
|
+
if (arg === '--db')
|
|
16
|
+
dbPath = argv[++index] ?? '';
|
|
17
|
+
else if (arg === '--config')
|
|
18
|
+
configPath = argv[++index] ?? '';
|
|
19
|
+
else if (arg === '--dimension')
|
|
20
|
+
dimension = parseDimensionArg(argv[++index], '--dimension');
|
|
21
|
+
else if (arg === '--dry-run')
|
|
22
|
+
dryRun = true;
|
|
23
|
+
}
|
|
24
|
+
return { dbPath: dbPath || undefined, configPath: configPath || undefined, dimension, dryRun };
|
|
25
|
+
}
|
|
26
|
+
function parseDimensionArg(value, label) {
|
|
27
|
+
if (!value || value.startsWith('--'))
|
|
28
|
+
throw new Error(`${label} must be a positive integer.`);
|
|
29
|
+
const diagnostics = [];
|
|
30
|
+
const dimension = parseVectorDimensionValue(value, label, diagnostics);
|
|
31
|
+
const error = diagnostics.find((diagnostic) => diagnostic.severity === 'error');
|
|
32
|
+
if (error || dimension === undefined)
|
|
33
|
+
throw new Error(error?.message ?? `${label} must be a positive integer.`);
|
|
34
|
+
return dimension;
|
|
35
|
+
}
|
|
36
|
+
async function main() {
|
|
37
|
+
const args = parseArgs(Bun.argv.slice(2));
|
|
38
|
+
const resolution = args.configPath ? resolveCogmemConfigPath({ configPath: args.configPath }) : resolveCogmemConfigPath();
|
|
39
|
+
const loaded = resolution.kind === 'toml' ? loadCogmemConfig({ configPath: resolution.path }) : undefined;
|
|
40
|
+
const dbPath = args.dbPath || loaded?.options.dbPath;
|
|
41
|
+
if (!dbPath) {
|
|
42
|
+
throw new Error('Usage: bun run packages/core/src/bin/migrate-vectors.ts [--config <config.toml>|--db <memory.db>] [--dimension 384] [--dry-run]');
|
|
43
|
+
}
|
|
44
|
+
const db = new Database(dbPath);
|
|
45
|
+
db.exec('PRAGMA busy_timeout = 5000;');
|
|
46
|
+
try {
|
|
47
|
+
const embeddingStore = new NeuronEmbeddingStore(db);
|
|
48
|
+
const embeddings = embeddingStore.listLatestEmbeddings();
|
|
49
|
+
const dimension = args.dimension ?? loaded?.options.vectorDimension ?? embeddings[0]?.dimensions ?? DEFAULT_VECTOR_DIMENSION;
|
|
50
|
+
const sqliteVec = new SqliteVecStore(db, dimension);
|
|
51
|
+
const compatible = embeddings.filter((row) => row.dimensions === dimension);
|
|
52
|
+
if (!args.dryRun) {
|
|
53
|
+
sqliteVec.addVectors(compatible.map((row) => ({
|
|
54
|
+
id: row.neuronId,
|
|
55
|
+
vector: Array.from(row.vector),
|
|
56
|
+
})));
|
|
57
|
+
}
|
|
58
|
+
printCliJson('migrate-vectors', {
|
|
59
|
+
migrated: args.dryRun ? 0 : compatible.length,
|
|
60
|
+
eligible: compatible.length,
|
|
61
|
+
skippedDimensionMismatch: embeddings.length - compatible.length,
|
|
62
|
+
dimension,
|
|
63
|
+
backend: sqliteVec.getStats().backend,
|
|
64
|
+
dryRun: args.dryRun,
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
finally {
|
|
68
|
+
db.close();
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
main().catch((error) => {
|
|
72
|
+
console.error(error instanceof Error ? error.message : String(error));
|
|
73
|
+
process.exit(1);
|
|
74
|
+
});
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import Database from 'bun:sqlite';
|
|
3
|
+
import { existsSync, renameSync, rmSync } from 'node:fs';
|
|
4
|
+
import { loadCogmemConfig, resolveCogmemConfigPath } from '../config/CogmemConfig.js';
|
|
5
|
+
import { ALL_MIGRATIONS, SchemaMigrationRunner } from '../migrations/index.js';
|
|
6
|
+
import { printCliJson } from './CliJson.js';
|
|
7
|
+
function parseArgs(argv) {
|
|
8
|
+
let dbPath;
|
|
9
|
+
let configPath;
|
|
10
|
+
let yes = false;
|
|
11
|
+
let dryRun = false;
|
|
12
|
+
let backup = false;
|
|
13
|
+
let json = false;
|
|
14
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
15
|
+
const arg = argv[index];
|
|
16
|
+
if (arg === '--db')
|
|
17
|
+
dbPath = argv[++index];
|
|
18
|
+
else if (arg === '--config')
|
|
19
|
+
configPath = argv[++index];
|
|
20
|
+
else if (arg === '--yes')
|
|
21
|
+
yes = true;
|
|
22
|
+
else if (arg === '--dry-run')
|
|
23
|
+
dryRun = true;
|
|
24
|
+
else if (arg === '--backup')
|
|
25
|
+
backup = true;
|
|
26
|
+
else if (arg === '--json')
|
|
27
|
+
json = true;
|
|
28
|
+
}
|
|
29
|
+
return { dbPath, configPath, dryRun: dryRun || !yes, backup, json };
|
|
30
|
+
}
|
|
31
|
+
function resolveDbPath(args) {
|
|
32
|
+
if (args.dbPath)
|
|
33
|
+
return args.dbPath;
|
|
34
|
+
const resolution = args.configPath
|
|
35
|
+
? resolveCogmemConfigPath({ configPath: args.configPath })
|
|
36
|
+
: resolveCogmemConfigPath();
|
|
37
|
+
if (resolution.kind !== 'toml') {
|
|
38
|
+
throw new Error('Usage: cogmem migrate [--config <config.toml>|--db <memory.db>] [--dry-run|--yes] [--backup] [--json]');
|
|
39
|
+
}
|
|
40
|
+
const loaded = loadCogmemConfig({ configPath: resolution.path });
|
|
41
|
+
if (!loaded.options.dbPath)
|
|
42
|
+
throw new Error('Configured database path is missing.');
|
|
43
|
+
return loaded.options.dbPath;
|
|
44
|
+
}
|
|
45
|
+
function backupDatabase(db, dbPath) {
|
|
46
|
+
if (dbPath === ':memory:')
|
|
47
|
+
return undefined;
|
|
48
|
+
const stamp = new Date().toISOString().replace(/[:.]/g, '-');
|
|
49
|
+
const backupPath = `${dbPath}.pre-migrate-${stamp}.bak`;
|
|
50
|
+
const temporaryPath = `${backupPath}.tmp`;
|
|
51
|
+
try {
|
|
52
|
+
// VACUUM INTO includes committed WAL pages and produces a standalone backup.
|
|
53
|
+
db.prepare('VACUUM INTO ?').run(temporaryPath);
|
|
54
|
+
renameSync(temporaryPath, backupPath);
|
|
55
|
+
return backupPath;
|
|
56
|
+
}
|
|
57
|
+
finally {
|
|
58
|
+
rmSync(temporaryPath, { force: true });
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
async function main() {
|
|
62
|
+
const args = parseArgs(process.argv.slice(2));
|
|
63
|
+
const dbPath = resolveDbPath(args);
|
|
64
|
+
const shouldBackup = !args.dryRun && args.backup && dbPath !== ':memory:' && existsSync(dbPath);
|
|
65
|
+
const db = new Database(dbPath);
|
|
66
|
+
db.exec('PRAGMA busy_timeout = 5000;');
|
|
67
|
+
try {
|
|
68
|
+
const backupPath = shouldBackup ? backupDatabase(db, dbPath) : undefined;
|
|
69
|
+
const runner = new SchemaMigrationRunner(db, ALL_MIGRATIONS);
|
|
70
|
+
const result = runner.run({ dryRun: args.dryRun });
|
|
71
|
+
if (!args.dryRun) {
|
|
72
|
+
db.exec(`CREATE TABLE IF NOT EXISTS _meta (key TEXT PRIMARY KEY, value TEXT NOT NULL);`);
|
|
73
|
+
const numericVersion = Number.parseInt(result.currentVersion || '0', 10);
|
|
74
|
+
db.prepare(`INSERT OR REPLACE INTO _meta (key, value) VALUES ('schema_version', ?)`).run(String(numericVersion));
|
|
75
|
+
}
|
|
76
|
+
const output = { command: 'migrate', dbPath, backupPath, ...result };
|
|
77
|
+
if (args.json)
|
|
78
|
+
printCliJson('migrate', output);
|
|
79
|
+
else {
|
|
80
|
+
console.log(`cogmem migrate ${args.dryRun ? 'dry-run' : 'complete'}`);
|
|
81
|
+
console.log(`database: ${dbPath}`);
|
|
82
|
+
console.log(`pending: ${result.pending.join(', ') || 'none'}`);
|
|
83
|
+
console.log(`applied: ${result.applied.join(', ') || 'none'}`);
|
|
84
|
+
if (backupPath)
|
|
85
|
+
console.log(`backup: ${backupPath}`);
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
finally {
|
|
89
|
+
db.close();
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
main().catch((error) => {
|
|
93
|
+
console.error(error instanceof Error ? error.message : String(error));
|
|
94
|
+
process.exit(1);
|
|
95
|
+
});
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import { type ExportBridgeMarker, type NormalizationFamily, type NormalizedMessageSource } from '../utils/ConversationMarkdownNormalization.js';
|
|
3
|
+
export interface NormalizeTranscriptCliResult {
|
|
4
|
+
inputPath: string;
|
|
5
|
+
outputPath: string;
|
|
6
|
+
title: string;
|
|
7
|
+
family: NormalizationFamily;
|
|
8
|
+
dryRun: boolean;
|
|
9
|
+
written: boolean;
|
|
10
|
+
messageCount: number;
|
|
11
|
+
sourceRefCount: number;
|
|
12
|
+
sourceRefs: NormalizedMessageSource[];
|
|
13
|
+
markers: ExportBridgeMarker[];
|
|
14
|
+
}
|
|
15
|
+
export declare function runNormalizeTranscript(argv: string[]): Promise<NormalizeTranscriptCliResult | void>;
|
|
16
|
+
//# sourceMappingURL=normalize-transcript.d.ts.map
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import { extname, resolve } from 'node:path';
|
|
3
|
+
import { normalizeAppPrivateMixedEventExport, normalizeDelimitedRecords, normalizeJsonArrayRecords, normalizeJsonlMixedEventLogExport, normalizeJsonlRecords, writeNormalizedConversationMarkdown, } from '../utils/ConversationMarkdownNormalization.js';
|
|
4
|
+
import { printCliJson } from './CliJson.js';
|
|
5
|
+
const USAGE = [
|
|
6
|
+
'Usage: cogmem-normalize-transcript --input <file> --output <file> [--family json-array|jsonl|csv|tsv|app-private-mixed-event|jsonl-mixed-event-log] [--title <title>] [--dry-run] [--json]',
|
|
7
|
+
'',
|
|
8
|
+
'This command only normalizes transcript exports into conversation Markdown with source-ref anchors.',
|
|
9
|
+
'It does not open a memory database, run recall, or modify agent runtime state.',
|
|
10
|
+
].join('\n');
|
|
11
|
+
export async function runNormalizeTranscript(argv) {
|
|
12
|
+
const args = parseArgs(argv);
|
|
13
|
+
if (args.values.help === true || args.values.h === true) {
|
|
14
|
+
console.log(USAGE);
|
|
15
|
+
return;
|
|
16
|
+
}
|
|
17
|
+
const inputPath = resolve(requireString(args, 'input'));
|
|
18
|
+
const outputPath = resolve(requireString(args, 'output'));
|
|
19
|
+
const title = stringArg(args, 'title') || 'Normalized Conversation Export';
|
|
20
|
+
const dryRun = args.values['dry-run'] === true;
|
|
21
|
+
const normalized = normalizeInput(inputPath, stringArg(args, 'family'), stringArg(args, 'format'));
|
|
22
|
+
if (!dryRun) {
|
|
23
|
+
writeNormalizedConversationMarkdown(outputPath, title, normalized.family, normalized.messages, normalized.markers);
|
|
24
|
+
}
|
|
25
|
+
const sourceRefs = normalized.messages
|
|
26
|
+
.map((message) => message.source)
|
|
27
|
+
.filter((source) => Boolean(source));
|
|
28
|
+
const result = {
|
|
29
|
+
inputPath,
|
|
30
|
+
outputPath,
|
|
31
|
+
title,
|
|
32
|
+
family: normalized.family,
|
|
33
|
+
dryRun,
|
|
34
|
+
written: !dryRun,
|
|
35
|
+
messageCount: normalized.messages.length,
|
|
36
|
+
sourceRefCount: sourceRefs.length,
|
|
37
|
+
sourceRefs,
|
|
38
|
+
markers: normalized.markers,
|
|
39
|
+
};
|
|
40
|
+
if (args.values.json === true) {
|
|
41
|
+
printCliJson('normalize-transcript', result);
|
|
42
|
+
}
|
|
43
|
+
else {
|
|
44
|
+
printHumanSummary(result);
|
|
45
|
+
}
|
|
46
|
+
return result;
|
|
47
|
+
}
|
|
48
|
+
function normalizeInput(inputPath, familyArg, formatArg) {
|
|
49
|
+
const family = resolveFamily(inputPath, familyArg, formatArg);
|
|
50
|
+
switch (family) {
|
|
51
|
+
case 'jsonl_transcript_export':
|
|
52
|
+
return { family, messages: normalizeJsonlRecords(inputPath), markers: [] };
|
|
53
|
+
case 'json_array_transcript_export':
|
|
54
|
+
return { family, messages: normalizeJsonArrayRecords(inputPath), markers: [] };
|
|
55
|
+
case 'csv_transcript_export': {
|
|
56
|
+
const normalized = normalizeDelimitedRecords(inputPath, 'csv');
|
|
57
|
+
return { family: normalized.family, messages: normalized.messages, markers: [] };
|
|
58
|
+
}
|
|
59
|
+
case 'tsv_transcript_export': {
|
|
60
|
+
const normalized = normalizeDelimitedRecords(inputPath, 'tsv');
|
|
61
|
+
return { family: normalized.family, messages: normalized.messages, markers: [] };
|
|
62
|
+
}
|
|
63
|
+
case 'app_private_mixed_event_export':
|
|
64
|
+
return normalizeAppPrivateMixedEventExport(inputPath);
|
|
65
|
+
case 'jsonl_mixed_event_log_export':
|
|
66
|
+
return normalizeJsonlMixedEventLogExport(inputPath);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
function resolveFamily(inputPath, familyArg, formatArg) {
|
|
70
|
+
if (familyArg)
|
|
71
|
+
return normalizeFamilyAlias(familyArg);
|
|
72
|
+
if (formatArg)
|
|
73
|
+
return normalizeFamilyAlias(formatArg);
|
|
74
|
+
const ext = extname(inputPath).toLowerCase();
|
|
75
|
+
if (ext === '.json')
|
|
76
|
+
return 'json_array_transcript_export';
|
|
77
|
+
if (ext === '.jsonl')
|
|
78
|
+
return 'jsonl_transcript_export';
|
|
79
|
+
if (ext === '.csv')
|
|
80
|
+
return 'csv_transcript_export';
|
|
81
|
+
if (ext === '.tsv')
|
|
82
|
+
return 'tsv_transcript_export';
|
|
83
|
+
throw new Error('Unable to infer transcript family. Pass --family json-array|jsonl|csv|tsv|app-private-mixed-event|jsonl-mixed-event-log.');
|
|
84
|
+
}
|
|
85
|
+
function normalizeFamilyAlias(value) {
|
|
86
|
+
const normalized = value.trim().toLowerCase().replace(/_/g, '-');
|
|
87
|
+
const aliases = {
|
|
88
|
+
'json': 'json_array_transcript_export',
|
|
89
|
+
'json-array': 'json_array_transcript_export',
|
|
90
|
+
'json-array-transcript-export': 'json_array_transcript_export',
|
|
91
|
+
'jsonl': 'jsonl_transcript_export',
|
|
92
|
+
'jsonl-transcript-export': 'jsonl_transcript_export',
|
|
93
|
+
'csv': 'csv_transcript_export',
|
|
94
|
+
'csv-transcript-export': 'csv_transcript_export',
|
|
95
|
+
'tsv': 'tsv_transcript_export',
|
|
96
|
+
'tsv-transcript-export': 'tsv_transcript_export',
|
|
97
|
+
'app-private-mixed-event': 'app_private_mixed_event_export',
|
|
98
|
+
'app-private-mixed-event-export': 'app_private_mixed_event_export',
|
|
99
|
+
'jsonl-mixed': 'jsonl_mixed_event_log_export',
|
|
100
|
+
'jsonl-mixed-event-log': 'jsonl_mixed_event_log_export',
|
|
101
|
+
'jsonl-mixed-event-log-export': 'jsonl_mixed_event_log_export',
|
|
102
|
+
};
|
|
103
|
+
const family = aliases[normalized];
|
|
104
|
+
if (!family) {
|
|
105
|
+
throw new Error(`Unsupported --family: ${value}`);
|
|
106
|
+
}
|
|
107
|
+
return family;
|
|
108
|
+
}
|
|
109
|
+
function parseArgs(argv) {
|
|
110
|
+
const values = {};
|
|
111
|
+
const args = argv[0] === '--' ? argv.slice(1) : argv;
|
|
112
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
113
|
+
const item = args[index];
|
|
114
|
+
if (!item.startsWith('--'))
|
|
115
|
+
continue;
|
|
116
|
+
const key = item.slice(2);
|
|
117
|
+
const next = args[index + 1];
|
|
118
|
+
if (!next || next.startsWith('--')) {
|
|
119
|
+
values[key] = true;
|
|
120
|
+
}
|
|
121
|
+
else {
|
|
122
|
+
values[key] = next;
|
|
123
|
+
index += 1;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
return { values };
|
|
127
|
+
}
|
|
128
|
+
function requireString(args, key) {
|
|
129
|
+
const value = args.values[key];
|
|
130
|
+
if (typeof value !== 'string' || value.length === 0) {
|
|
131
|
+
throw new Error(`Missing required --${key}. ${USAGE}`);
|
|
132
|
+
}
|
|
133
|
+
return value;
|
|
134
|
+
}
|
|
135
|
+
function stringArg(args, key) {
|
|
136
|
+
const value = args.values[key];
|
|
137
|
+
return typeof value === 'string' && value.length > 0 ? value : undefined;
|
|
138
|
+
}
|
|
139
|
+
function printHumanSummary(result) {
|
|
140
|
+
console.log(`cogmem transcript normalization ${result.dryRun ? 'dry-run' : 'complete'}`);
|
|
141
|
+
console.log(`input: ${result.inputPath}`);
|
|
142
|
+
console.log(`output: ${result.outputPath}`);
|
|
143
|
+
console.log(`family: ${result.family}`);
|
|
144
|
+
console.log(`messages: ${result.messageCount}`);
|
|
145
|
+
console.log(`source refs: ${result.sourceRefCount}`);
|
|
146
|
+
console.log(`written: ${result.written}`);
|
|
147
|
+
}
|
|
148
|
+
if (import.meta.main) {
|
|
149
|
+
runNormalizeTranscript(process.argv.slice(2)).catch((error) => {
|
|
150
|
+
console.error(error instanceof Error ? error.message : String(error));
|
|
151
|
+
process.exit(1);
|
|
152
|
+
});
|
|
153
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
3
|
+
import { join, resolve } from 'node:path';
|
|
4
|
+
import { defaultOpenClawAutoMemoryPluginDir, inspectOpenClawAutoMemoryPlugin, } from '../host/openclaw/AutoMemoryPluginInstaller.js';
|
|
5
|
+
function readArg(name) {
|
|
6
|
+
const index = process.argv.indexOf(name);
|
|
7
|
+
if (index === -1)
|
|
8
|
+
return undefined;
|
|
9
|
+
return process.argv[index + 1];
|
|
10
|
+
}
|
|
11
|
+
function hasFlag(name) {
|
|
12
|
+
return process.argv.includes(name);
|
|
13
|
+
}
|
|
14
|
+
function usage() {
|
|
15
|
+
return [
|
|
16
|
+
'Usage: cogmem openclaw diagnose --workspace <workspace> [--plugin-dir <dir>] [--json]',
|
|
17
|
+
'',
|
|
18
|
+
'Diagnoses the generated OpenClaw Cogmem plugin without opening the Cogmem database.',
|
|
19
|
+
].join('\n');
|
|
20
|
+
}
|
|
21
|
+
function readAudit(workspaceRoot) {
|
|
22
|
+
const logPath = join(workspaceRoot, '.cogmem', 'logs', 'openclaw-auto-memory.jsonl');
|
|
23
|
+
if (!existsSync(logPath))
|
|
24
|
+
return { logPath, recentErrors: [] };
|
|
25
|
+
const records = readFileSync(logPath, 'utf8')
|
|
26
|
+
.split('\n')
|
|
27
|
+
.map((line) => line.trim())
|
|
28
|
+
.filter(Boolean)
|
|
29
|
+
.slice(-500)
|
|
30
|
+
.map((line) => {
|
|
31
|
+
try {
|
|
32
|
+
return JSON.parse(line);
|
|
33
|
+
}
|
|
34
|
+
catch {
|
|
35
|
+
return undefined;
|
|
36
|
+
}
|
|
37
|
+
})
|
|
38
|
+
.filter((record) => Boolean(record));
|
|
39
|
+
return {
|
|
40
|
+
logPath,
|
|
41
|
+
lastBeforePromptBuild: records.slice().reverse().find((record) => record.hook === 'before_prompt_build'),
|
|
42
|
+
recentErrors: records.filter((record) => record.action === 'error').slice(-20),
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
function main() {
|
|
46
|
+
const [command] = process.argv.slice(2).filter((arg) => !arg.startsWith('--'));
|
|
47
|
+
if (command !== 'diagnose' || hasFlag('--help') || hasFlag('-h')) {
|
|
48
|
+
console.log(usage());
|
|
49
|
+
process.exit(command === 'diagnose' ? 0 : 1);
|
|
50
|
+
}
|
|
51
|
+
const workspace = readArg('--workspace');
|
|
52
|
+
if (!workspace)
|
|
53
|
+
throw new Error(`Missing --workspace.\n${usage()}`);
|
|
54
|
+
const workspaceRoot = resolve(workspace);
|
|
55
|
+
const pluginDir = readArg('--plugin-dir') || defaultOpenClawAutoMemoryPluginDir(workspaceRoot);
|
|
56
|
+
const plugin = inspectOpenClawAutoMemoryPlugin({ workspaceRoot, pluginDir });
|
|
57
|
+
const audit = readAudit(workspaceRoot);
|
|
58
|
+
const payload = {
|
|
59
|
+
schemaVersion: 'cogmem.cli.v1',
|
|
60
|
+
command: 'openclaw diagnose',
|
|
61
|
+
workspaceRoot,
|
|
62
|
+
plugin,
|
|
63
|
+
audit,
|
|
64
|
+
};
|
|
65
|
+
if (hasFlag('--json')) {
|
|
66
|
+
console.log(JSON.stringify(payload));
|
|
67
|
+
return;
|
|
68
|
+
}
|
|
69
|
+
console.log(`OpenClaw workspace: ${workspaceRoot}`);
|
|
70
|
+
console.log(`plugin: ${plugin.current ? 'current' : plugin.installed ? 'stale' : 'missing'} ${plugin.pluginDir}`);
|
|
71
|
+
if (audit.lastBeforePromptBuild) {
|
|
72
|
+
console.log(`last before_prompt_build: action=${audit.lastBeforePromptBuild.action || 'unknown'} reason=${audit.lastBeforePromptBuild.reason || ''}`);
|
|
73
|
+
}
|
|
74
|
+
else {
|
|
75
|
+
console.log('last before_prompt_build: none');
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
main();
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import { createMemoryKernel, createMemoryKernelFromConfig } from '../factory.js';
|
|
3
|
+
import { printCliJson } from './CliJson.js';
|
|
4
|
+
function parseArgs(argv) {
|
|
5
|
+
const [command, ...rest] = argv;
|
|
6
|
+
const values = new Map();
|
|
7
|
+
for (let index = 0; index < rest.length; index += 1) {
|
|
8
|
+
const item = rest[index];
|
|
9
|
+
if (!item.startsWith('--'))
|
|
10
|
+
continue;
|
|
11
|
+
const next = rest[index + 1];
|
|
12
|
+
const value = !next || next.startsWith('--') ? 'true' : next;
|
|
13
|
+
values.set(item.slice(2), [...(values.get(item.slice(2)) ?? []), value]);
|
|
14
|
+
if (value !== 'true')
|
|
15
|
+
index += 1;
|
|
16
|
+
}
|
|
17
|
+
return { command, values };
|
|
18
|
+
}
|
|
19
|
+
function usage() {
|
|
20
|
+
return [
|
|
21
|
+
'Usage: cogmem prospective <list|due|create|confirm|reject|defer|complete|expire> [options]',
|
|
22
|
+
' list --project <id> [--status pending --status confirmed]',
|
|
23
|
+
' due --project <id> [--at <epoch-ms>]',
|
|
24
|
+
' create --project <id> --type <type> --key <key> --title <text> --evidence <eventId> [--due <epoch-ms>]',
|
|
25
|
+
' confirm --project <id> --id <candidateId> --evidence <userEventId>',
|
|
26
|
+
' reject|complete|expire --project <id> --id <candidateId>',
|
|
27
|
+
' defer --project <id> --id <candidateId> --until <epoch-ms>',
|
|
28
|
+
' Common: --config <config.toml> | --db <memory.db> --json',
|
|
29
|
+
'This command manages candidates only. It never executes tasks or tools.',
|
|
30
|
+
].join('\n');
|
|
31
|
+
}
|
|
32
|
+
async function main() {
|
|
33
|
+
const args = parseArgs(process.argv.slice(2));
|
|
34
|
+
if (!args.command || args.command === 'help' || args.values.has('help')) {
|
|
35
|
+
console.log(usage());
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
const dbPath = args.values.get('db')?.[0];
|
|
39
|
+
const configPath = args.values.get('config')?.[0];
|
|
40
|
+
const kernel = dbPath ? createMemoryKernel({ dbPath }) : createMemoryKernelFromConfig({ configPath });
|
|
41
|
+
try {
|
|
42
|
+
const service = kernel.prospectiveMemoryService;
|
|
43
|
+
const projectId = args.values.get('project')?.[0];
|
|
44
|
+
let result;
|
|
45
|
+
if (args.command === 'list') {
|
|
46
|
+
if (!projectId)
|
|
47
|
+
throw new Error('--project is required');
|
|
48
|
+
result = service.list({ projectId, statuses: args.values.get('status') });
|
|
49
|
+
}
|
|
50
|
+
else if (args.command === 'due') {
|
|
51
|
+
if (!projectId)
|
|
52
|
+
throw new Error('--project is required');
|
|
53
|
+
result = service.listDue({ projectId, atTime: numberValue(args.values, 'at') });
|
|
54
|
+
}
|
|
55
|
+
else if (args.command === 'create') {
|
|
56
|
+
const candidateType = args.values.get('type')?.[0];
|
|
57
|
+
const canonicalKey = args.values.get('key')?.[0];
|
|
58
|
+
const title = args.values.get('title')?.[0];
|
|
59
|
+
const evidenceEventIds = args.values.get('evidence') ?? [];
|
|
60
|
+
if (!projectId || !candidateType || !canonicalKey || !title || evidenceEventIds.length === 0) {
|
|
61
|
+
throw new Error('create requires --project --type --key --title and at least one --evidence');
|
|
62
|
+
}
|
|
63
|
+
result = service.propose({
|
|
64
|
+
projectId, candidateType, canonicalKey, title, evidenceEventIds,
|
|
65
|
+
details: args.values.get('details')?.[0],
|
|
66
|
+
proposedBy: args.values.get('proposed-by')?.[0] ?? 'operator',
|
|
67
|
+
dueAt: numberValue(args.values, 'due'),
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
else {
|
|
71
|
+
const candidateId = args.values.get('id')?.[0];
|
|
72
|
+
if (!candidateId)
|
|
73
|
+
throw new Error('--id is required');
|
|
74
|
+
if (!projectId)
|
|
75
|
+
throw new Error('--project is required');
|
|
76
|
+
if (args.command === 'confirm') {
|
|
77
|
+
const evidence = args.values.get('evidence')?.[0];
|
|
78
|
+
if (!evidence)
|
|
79
|
+
throw new Error('confirm requires --evidence <userEventId>');
|
|
80
|
+
result = service.resolve(candidateId, { action: 'confirm', confirmationEvidenceEventId: evidence }, projectId);
|
|
81
|
+
}
|
|
82
|
+
else if (args.command === 'reject')
|
|
83
|
+
result = service.resolve(candidateId, { action: 'reject' }, projectId);
|
|
84
|
+
else if (args.command === 'complete')
|
|
85
|
+
result = service.resolve(candidateId, { action: 'complete' }, projectId);
|
|
86
|
+
else if (args.command === 'expire')
|
|
87
|
+
result = service.resolve(candidateId, { action: 'expire' }, projectId);
|
|
88
|
+
else if (args.command === 'defer') {
|
|
89
|
+
const deferredUntil = numberValue(args.values, 'until');
|
|
90
|
+
if (deferredUntil === undefined)
|
|
91
|
+
throw new Error('defer requires --until <epoch-ms>');
|
|
92
|
+
result = service.resolve(candidateId, { action: 'defer', deferredUntil }, projectId);
|
|
93
|
+
}
|
|
94
|
+
else
|
|
95
|
+
throw new Error(`unknown prospective command: ${args.command}`);
|
|
96
|
+
}
|
|
97
|
+
printCliJson(`prospective.${String(args.command)}`, result);
|
|
98
|
+
}
|
|
99
|
+
finally {
|
|
100
|
+
kernel.close();
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
function numberValue(values, key) {
|
|
104
|
+
const value = values.get(key)?.[0];
|
|
105
|
+
if (value === undefined)
|
|
106
|
+
return undefined;
|
|
107
|
+
const parsed = Number(value);
|
|
108
|
+
if (!Number.isFinite(parsed))
|
|
109
|
+
throw new Error(`--${key} must be a finite number`);
|
|
110
|
+
return parsed;
|
|
111
|
+
}
|
|
112
|
+
main().catch((error) => {
|
|
113
|
+
console.error(error instanceof Error ? error.message : String(error));
|
|
114
|
+
process.exit(1);
|
|
115
|
+
});
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
import Database from 'bun:sqlite';
|
|
3
|
+
import { NeuronEmbeddingStore } from '../embedding/NeuronEmbeddingStore.js';
|
|
4
|
+
import { loadCogmemConfig, resolveCogmemConfigPath } from '../config/CogmemConfig.js';
|
|
5
|
+
import { printCliJson } from './CliJson.js';
|
|
6
|
+
function parseArgs(argv) {
|
|
7
|
+
const args = {};
|
|
8
|
+
for (let index = 0; index < argv.length; index += 1) {
|
|
9
|
+
const item = argv[index];
|
|
10
|
+
if (!item.startsWith('--'))
|
|
11
|
+
continue;
|
|
12
|
+
const key = item.slice(2);
|
|
13
|
+
const next = argv[index + 1];
|
|
14
|
+
if (!next || next.startsWith('--')) {
|
|
15
|
+
args[key] = true;
|
|
16
|
+
}
|
|
17
|
+
else {
|
|
18
|
+
args[key] = next;
|
|
19
|
+
index += 1;
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
return args;
|
|
23
|
+
}
|
|
24
|
+
const [command, ...rest] = process.argv.slice(2);
|
|
25
|
+
const args = parseArgs(rest);
|
|
26
|
+
if (command !== 'status') {
|
|
27
|
+
console.error('Usage: re-embed.ts status --db <cogmem.db>');
|
|
28
|
+
process.exit(1);
|
|
29
|
+
}
|
|
30
|
+
const configPath = typeof args.config === 'string' ? args.config : undefined;
|
|
31
|
+
const resolution = configPath ? resolveCogmemConfigPath({ configPath }) : resolveCogmemConfigPath();
|
|
32
|
+
const loaded = resolution.kind === 'toml' ? loadCogmemConfig({ configPath: resolution.path }) : undefined;
|
|
33
|
+
const dbPath = typeof args.db === 'string' ? args.db : loaded?.options.dbPath ?? './cogmem.db';
|
|
34
|
+
const db = new Database(dbPath);
|
|
35
|
+
const store = new NeuronEmbeddingStore(db);
|
|
36
|
+
const progress = store.getProgress();
|
|
37
|
+
const completedOrFailed = progress.completed + progress.failed;
|
|
38
|
+
const status = {
|
|
39
|
+
isRunning: false,
|
|
40
|
+
dbPath,
|
|
41
|
+
...progress,
|
|
42
|
+
percentComplete: progress.total === 0 ? 100 : Math.min(100, (completedOrFailed / progress.total) * 100),
|
|
43
|
+
estimatedRemainingMs: null,
|
|
44
|
+
};
|
|
45
|
+
printCliJson('re-embed.status', status);
|
|
46
|
+
db.close();
|