@zooique/memora 2.0.0 → 3.0.0
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/CHANGELOG.md +1028 -0
- package/README.en.md +305 -0
- package/README.md +303 -148
- package/config.example.json +43 -0
- package/dist/agent/agent.d.ts +438 -295
- package/dist/agent/agent.d.ts.map +1 -1
- package/dist/agent/agent.js +1368 -836
- package/dist/agent/agent.js.map +1 -1
- package/dist/agent/assembler.d.ts +117 -39
- package/dist/agent/assembler.d.ts.map +1 -1
- package/dist/agent/assembler.js +574 -71
- package/dist/agent/assembler.js.map +1 -1
- package/dist/agent/budget.d.ts +131 -0
- package/dist/agent/budget.d.ts.map +1 -0
- package/dist/agent/budget.js +128 -0
- package/dist/agent/budget.js.map +1 -0
- package/dist/agent/builtinToolHandlers.d.ts +229 -17
- package/dist/agent/builtinToolHandlers.d.ts.map +1 -1
- package/dist/agent/builtinToolHandlers.js +758 -70
- package/dist/agent/builtinToolHandlers.js.map +1 -1
- package/dist/agent/builtinTools.d.ts +198 -7
- package/dist/agent/builtinTools.d.ts.map +1 -1
- package/dist/agent/builtinTools.js +646 -14
- package/dist/agent/builtinTools.js.map +1 -1
- package/dist/agent/compaction.d.ts +93 -0
- package/dist/agent/compaction.d.ts.map +1 -0
- package/dist/agent/compaction.js +192 -0
- package/dist/agent/compaction.js.map +1 -0
- package/dist/agent/constants.d.ts +139 -18
- package/dist/agent/constants.d.ts.map +1 -1
- package/dist/agent/constants.js +154 -18
- package/dist/agent/constants.js.map +1 -1
- package/dist/agent/contextManager.d.ts +126 -76
- package/dist/agent/contextManager.d.ts.map +1 -1
- package/dist/agent/contextManager.js +197 -135
- package/dist/agent/contextManager.js.map +1 -1
- package/dist/agent/contextPreparer.d.ts +78 -0
- package/dist/agent/contextPreparer.d.ts.map +1 -0
- package/dist/agent/contextPreparer.js +128 -0
- package/dist/agent/contextPreparer.js.map +1 -0
- package/dist/agent/duplicateInterceptor.d.ts +67 -0
- package/dist/agent/duplicateInterceptor.d.ts.map +1 -0
- package/dist/agent/duplicateInterceptor.js +82 -0
- package/dist/agent/duplicateInterceptor.js.map +1 -0
- package/dist/agent/guardRail.d.ts +166 -0
- package/dist/agent/guardRail.d.ts.map +1 -0
- package/dist/agent/guardRail.js +333 -0
- package/dist/agent/guardRail.js.map +1 -0
- package/dist/agent/loop.d.ts +718 -253
- package/dist/agent/loop.d.ts.map +1 -1
- package/dist/agent/loop.js +2215 -648
- package/dist/agent/loop.js.map +1 -1
- package/dist/agent/managers/archiveCoordinator.d.ts +21 -74
- package/dist/agent/managers/archiveCoordinator.d.ts.map +1 -1
- package/dist/agent/managers/archiveCoordinator.js +32 -105
- package/dist/agent/managers/archiveCoordinator.js.map +1 -1
- package/dist/agent/managers/chatLockManager.d.ts +20 -88
- package/dist/agent/managers/chatLockManager.d.ts.map +1 -1
- package/dist/agent/managers/chatLockManager.js +31 -103
- package/dist/agent/managers/chatLockManager.js.map +1 -1
- package/dist/agent/managers/dedupManager.d.ts +85 -0
- package/dist/agent/managers/dedupManager.d.ts.map +1 -0
- package/dist/agent/managers/dedupManager.js +248 -0
- package/dist/agent/managers/dedupManager.js.map +1 -0
- package/dist/agent/managers/goalConsistencyChecker.d.ts +42 -0
- package/dist/agent/managers/goalConsistencyChecker.d.ts.map +1 -0
- package/dist/agent/managers/goalConsistencyChecker.js +178 -0
- package/dist/agent/managers/goalConsistencyChecker.js.map +1 -0
- package/dist/agent/managers/llmCaller.d.ts +124 -0
- package/dist/agent/managers/llmCaller.d.ts.map +1 -0
- package/dist/agent/managers/llmCaller.js +417 -0
- package/dist/agent/managers/llmCaller.js.map +1 -0
- package/dist/agent/managers/llmJudgeHelper.d.ts +21 -0
- package/dist/agent/managers/llmJudgeHelper.d.ts.map +1 -0
- package/dist/agent/managers/llmJudgeHelper.js +32 -0
- package/dist/agent/managers/llmJudgeHelper.js.map +1 -0
- package/dist/agent/managers/loopMetrics.d.ts +58 -0
- package/dist/agent/managers/loopMetrics.d.ts.map +1 -0
- package/dist/agent/managers/loopMetrics.js +68 -0
- package/dist/agent/managers/loopMetrics.js.map +1 -0
- package/dist/agent/managers/memoryAdvisor.d.ts +27 -120
- package/dist/agent/managers/memoryAdvisor.d.ts.map +1 -1
- package/dist/agent/managers/memoryAdvisor.js +56 -192
- package/dist/agent/managers/memoryAdvisor.js.map +1 -1
- package/dist/agent/managers/memoryGovernance.d.ts +24 -0
- package/dist/agent/managers/memoryGovernance.d.ts.map +1 -0
- package/dist/agent/managers/memoryGovernance.js +46 -0
- package/dist/agent/managers/memoryGovernance.js.map +1 -0
- package/dist/agent/managers/memoryInspector.d.ts +59 -393
- package/dist/agent/managers/memoryInspector.d.ts.map +1 -1
- package/dist/agent/managers/memoryInspector.js +92 -736
- package/dist/agent/managers/memoryInspector.js.map +1 -1
- package/dist/agent/managers/roundSummaryGenerator.d.ts +56 -0
- package/dist/agent/managers/roundSummaryGenerator.d.ts.map +1 -0
- package/dist/agent/managers/roundSummaryGenerator.js +201 -0
- package/dist/agent/managers/roundSummaryGenerator.js.map +1 -0
- package/dist/agent/managers/sessionArchiver.d.ts +19 -63
- package/dist/agent/managers/sessionArchiver.d.ts.map +1 -1
- package/dist/agent/managers/sessionArchiver.js +83 -157
- package/dist/agent/managers/sessionArchiver.js.map +1 -1
- package/dist/agent/managers/sessionManager.d.ts +286 -57
- package/dist/agent/managers/sessionManager.d.ts.map +1 -1
- package/dist/agent/managers/sessionManager.js +846 -85
- package/dist/agent/managers/sessionManager.js.map +1 -1
- package/dist/agent/managers/sessionNamer.d.ts +35 -0
- package/dist/agent/managers/sessionNamer.d.ts.map +1 -0
- package/dist/agent/managers/sessionNamer.js +104 -0
- package/dist/agent/managers/sessionNamer.js.map +1 -0
- package/dist/agent/managers/streamAccumulator.d.ts +20 -0
- package/dist/agent/managers/streamAccumulator.d.ts.map +1 -0
- package/dist/agent/managers/streamAccumulator.js +15 -0
- package/dist/agent/managers/streamAccumulator.js.map +1 -0
- package/dist/agent/managers/textPolishManager.d.ts +8 -44
- package/dist/agent/managers/textPolishManager.d.ts.map +1 -1
- package/dist/agent/managers/textPolishManager.js +12 -47
- package/dist/agent/managers/textPolishManager.js.map +1 -1
- package/dist/agent/managers/toolCallHelpers.d.ts +105 -0
- package/dist/agent/managers/toolCallHelpers.d.ts.map +1 -0
- package/dist/agent/managers/toolCallHelpers.js +161 -0
- package/dist/agent/managers/toolCallHelpers.js.map +1 -0
- package/dist/agent/managers/workProjection.d.ts +57 -87
- package/dist/agent/managers/workProjection.d.ts.map +1 -1
- package/dist/agent/managers/workProjection.js +166 -246
- package/dist/agent/managers/workProjection.js.map +1 -1
- package/dist/agent/messageHistory.d.ts +134 -84
- package/dist/agent/messageHistory.d.ts.map +1 -1
- package/dist/agent/messageHistory.js +419 -133
- package/dist/agent/messageHistory.js.map +1 -1
- package/dist/agent/needsPlanning.d.ts +28 -0
- package/dist/agent/needsPlanning.d.ts.map +1 -0
- package/dist/agent/needsPlanning.js +68 -0
- package/dist/agent/needsPlanning.js.map +1 -0
- package/dist/agent/seed/index.d.ts +11 -0
- package/dist/agent/seed/index.d.ts.map +1 -0
- package/dist/agent/seed/index.js +10 -0
- package/dist/agent/seed/index.js.map +1 -0
- package/dist/agent/seed/orchestrator.d.ts +83 -0
- package/dist/agent/seed/orchestrator.d.ts.map +1 -0
- package/dist/agent/seed/orchestrator.js +260 -0
- package/dist/agent/seed/orchestrator.js.map +1 -0
- package/dist/agent/seed/prepare.d.ts +49 -0
- package/dist/agent/seed/prepare.d.ts.map +1 -0
- package/dist/agent/seed/prepare.js +107 -0
- package/dist/agent/seed/prepare.js.map +1 -0
- package/dist/agent/seed/types.d.ts +115 -0
- package/dist/agent/seed/types.d.ts.map +1 -0
- package/dist/agent/seed/types.js +15 -0
- package/dist/agent/seed/types.js.map +1 -0
- package/dist/agent/sessionStateMachine.d.ts +78 -0
- package/dist/agent/sessionStateMachine.d.ts.map +1 -0
- package/dist/agent/sessionStateMachine.js +182 -0
- package/dist/agent/sessionStateMachine.js.map +1 -0
- package/dist/agent/taskTableRenderer.d.ts +51 -0
- package/dist/agent/taskTableRenderer.d.ts.map +1 -0
- package/dist/agent/taskTableRenderer.js +115 -0
- package/dist/agent/taskTableRenderer.js.map +1 -0
- package/dist/agent/toolExecutor.d.ts +255 -9
- package/dist/agent/toolExecutor.d.ts.map +1 -1
- package/dist/agent/toolExecutor.js +956 -20
- package/dist/agent/toolExecutor.js.map +1 -1
- package/dist/agent/toolLedger.d.ts +120 -0
- package/dist/agent/toolLedger.d.ts.map +1 -0
- package/dist/agent/toolLedger.js +149 -0
- package/dist/agent/toolLedger.js.map +1 -0
- package/dist/agent/toolResultCache.d.ts +134 -0
- package/dist/agent/toolResultCache.d.ts.map +1 -0
- package/dist/agent/toolResultCache.js +243 -0
- package/dist/agent/toolResultCache.js.map +1 -0
- package/dist/agent/toolResultOffload.d.ts +59 -0
- package/dist/agent/toolResultOffload.d.ts.map +1 -0
- package/dist/agent/toolResultOffload.js +70 -0
- package/dist/agent/toolResultOffload.js.map +1 -0
- package/dist/agent/toolRunner.d.ts +59 -0
- package/dist/agent/toolRunner.d.ts.map +1 -0
- package/dist/agent/toolRunner.js +147 -0
- package/dist/agent/toolRunner.js.map +1 -0
- package/dist/agent/tracer.d.ts +99 -107
- package/dist/agent/tracer.d.ts.map +1 -1
- package/dist/agent/tracer.js +24 -69
- package/dist/agent/tracer.js.map +1 -1
- package/dist/agent/types.d.ts +512 -162
- package/dist/agent/types.d.ts.map +1 -1
- package/dist/agent/types.js +2 -51
- package/dist/agent/types.js.map +1 -1
- package/dist/code-exec/codeExecutionProvider.d.ts +16 -0
- package/dist/code-exec/codeExecutionProvider.d.ts.map +1 -0
- package/dist/code-exec/codeExecutionProvider.js +57 -0
- package/dist/code-exec/codeExecutionProvider.js.map +1 -0
- package/dist/code-exec/types.d.ts +37 -0
- package/dist/code-exec/types.d.ts.map +1 -0
- package/dist/code-exec/types.js +12 -0
- package/dist/code-exec/types.js.map +1 -0
- package/dist/config/expandEnvVars.d.ts +22 -0
- package/dist/config/expandEnvVars.d.ts.map +1 -0
- package/dist/config/expandEnvVars.js +38 -0
- package/dist/config/expandEnvVars.js.map +1 -0
- package/dist/config/loader.d.ts +59 -242
- package/dist/config/loader.d.ts.map +1 -1
- package/dist/config/loader.js +237 -194
- package/dist/config/loader.js.map +1 -1
- package/dist/index.d.ts +69 -74
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +93 -63
- package/dist/index.js.map +1 -1
- package/dist/llm/abortSignal.d.ts +2 -3
- package/dist/llm/abortSignal.d.ts.map +1 -1
- package/dist/llm/abortSignal.js +2 -3
- package/dist/llm/abortSignal.js.map +1 -1
- package/dist/llm/factory.d.ts +29 -25
- package/dist/llm/factory.d.ts.map +1 -1
- package/dist/llm/factory.js +34 -69
- package/dist/llm/factory.js.map +1 -1
- package/dist/llm/openaiCompatible.d.ts +25 -40
- package/dist/llm/openaiCompatible.d.ts.map +1 -1
- package/dist/llm/openaiCompatible.js +181 -129
- package/dist/llm/openaiCompatible.js.map +1 -1
- package/dist/llm/provider.d.ts +29 -42
- package/dist/llm/provider.d.ts.map +1 -1
- package/dist/llm/provider.js +11 -10
- package/dist/llm/provider.js.map +1 -1
- package/dist/llm/types.d.ts +54 -11
- package/dist/llm/types.d.ts.map +1 -1
- package/dist/llm/types.js +0 -5
- package/dist/llm/types.js.map +1 -1
- package/dist/logging/logger.d.ts +8 -29
- package/dist/logging/logger.d.ts.map +1 -1
- package/dist/logging/logger.js +43 -233
- package/dist/logging/logger.js.map +1 -1
- package/dist/logging/loggerInterface.d.ts +9 -8
- package/dist/logging/loggerInterface.d.ts.map +1 -1
- package/dist/memory/gcService.d.ts +164 -0
- package/dist/memory/gcService.d.ts.map +1 -0
- package/dist/memory/gcService.js +215 -0
- package/dist/memory/gcService.js.map +1 -0
- package/dist/memory/governance.d.ts +17 -0
- package/dist/memory/governance.d.ts.map +1 -0
- package/dist/memory/governance.js +17 -0
- package/dist/memory/governance.js.map +1 -0
- package/dist/memory/inMemoryRoundStore.d.ts +124 -0
- package/dist/memory/inMemoryRoundStore.d.ts.map +1 -0
- package/dist/memory/inMemoryRoundStore.js +216 -0
- package/dist/memory/inMemoryRoundStore.js.map +1 -0
- package/dist/memory/inMemorySessionStore.d.ts +92 -0
- package/dist/memory/inMemorySessionStore.d.ts.map +1 -0
- package/dist/memory/inMemorySessionStore.js +219 -0
- package/dist/memory/inMemorySessionStore.js.map +1 -0
- package/dist/memory/inMemorySessionViewLoader.d.ts +89 -0
- package/dist/memory/inMemorySessionViewLoader.d.ts.map +1 -0
- package/dist/memory/inMemorySessionViewLoader.js +183 -0
- package/dist/memory/inMemorySessionViewLoader.js.map +1 -0
- package/dist/memory/inMemoryStorage.d.ts +26 -141
- package/dist/memory/inMemoryStorage.d.ts.map +1 -1
- package/dist/memory/inMemoryStorage.js +48 -187
- package/dist/memory/inMemoryStorage.js.map +1 -1
- package/dist/memory/keywordsTouch.d.ts +20 -0
- package/dist/memory/keywordsTouch.d.ts.map +1 -0
- package/dist/memory/keywordsTouch.js +25 -0
- package/dist/memory/keywordsTouch.js.map +1 -0
- package/dist/memory/lockManager.d.ts +7 -2
- package/dist/memory/lockManager.d.ts.map +1 -1
- package/dist/memory/lockManager.js +35 -11
- package/dist/memory/lockManager.js.map +1 -1
- package/dist/memory/projectManager.d.ts +30 -128
- package/dist/memory/projectManager.d.ts.map +1 -1
- package/dist/memory/projectManager.js +39 -171
- package/dist/memory/projectManager.js.map +1 -1
- package/dist/memory/projectRegistry.d.ts +22 -37
- package/dist/memory/projectRegistry.d.ts.map +1 -1
- package/dist/memory/projectRegistry.js +78 -85
- package/dist/memory/projectRegistry.js.map +1 -1
- package/dist/memory/roundStore.d.ts +629 -0
- package/dist/memory/roundStore.d.ts.map +1 -0
- package/dist/memory/roundStore.js +116 -0
- package/dist/memory/roundStore.js.map +1 -0
- package/dist/memory/sessionStore.d.ts +70 -61
- package/dist/memory/sessionStore.d.ts.map +1 -1
- package/dist/memory/sessionStore.js +23 -1
- package/dist/memory/sessionStore.js.map +1 -1
- package/dist/memory/sessionViewLoader.d.ts +141 -0
- package/dist/memory/sessionViewLoader.d.ts.map +1 -0
- package/dist/memory/sessionViewLoader.js +65 -0
- package/dist/memory/sessionViewLoader.js.map +1 -0
- package/dist/memory/sourceValidation.d.ts +18 -9
- package/dist/memory/sourceValidation.d.ts.map +1 -1
- package/dist/memory/sourceValidation.js +35 -29
- package/dist/memory/sourceValidation.js.map +1 -1
- package/dist/memory/storageInterface.d.ts +45 -126
- package/dist/memory/storageInterface.d.ts.map +1 -1
- package/dist/memory/types.d.ts +82 -168
- package/dist/memory/types.d.ts.map +1 -1
- package/dist/memory/types.js +116 -79
- package/dist/memory/types.js.map +1 -1
- package/dist/project-search/projectSearchProvider.d.ts +29 -0
- package/dist/project-search/projectSearchProvider.d.ts.map +1 -0
- package/dist/project-search/projectSearchProvider.js +57 -0
- package/dist/project-search/projectSearchProvider.js.map +1 -0
- package/dist/project-search/terms.d.ts +14 -0
- package/dist/project-search/terms.d.ts.map +1 -0
- package/dist/project-search/terms.js +68 -0
- package/dist/project-search/terms.js.map +1 -0
- package/dist/project-search/types.d.ts +139 -0
- package/dist/project-search/types.d.ts.map +1 -0
- package/dist/project-search/types.js +8 -0
- package/dist/project-search/types.js.map +1 -0
- package/dist/role-pack/capabilityMap.d.ts +28 -0
- package/dist/role-pack/capabilityMap.d.ts.map +1 -0
- package/dist/role-pack/capabilityMap.js +56 -0
- package/dist/role-pack/capabilityMap.js.map +1 -0
- package/dist/role-pack/constants.d.ts +21 -0
- package/dist/role-pack/constants.d.ts.map +1 -0
- package/dist/role-pack/constants.js +21 -0
- package/dist/role-pack/constants.js.map +1 -0
- package/dist/role-pack/rolePackManager.d.ts +269 -0
- package/dist/role-pack/rolePackManager.d.ts.map +1 -0
- package/dist/role-pack/rolePackManager.js +1082 -0
- package/dist/role-pack/rolePackManager.js.map +1 -0
- package/dist/role-pack/strategyKeys.d.ts +100 -0
- package/dist/role-pack/strategyKeys.d.ts.map +1 -0
- package/dist/role-pack/strategyKeys.js +184 -0
- package/dist/role-pack/strategyKeys.js.map +1 -0
- package/dist/role-pack/strategyResolver.d.ts +109 -0
- package/dist/role-pack/strategyResolver.d.ts.map +1 -0
- package/dist/role-pack/strategyResolver.js +304 -0
- package/dist/role-pack/strategyResolver.js.map +1 -0
- package/dist/role-pack/types.d.ts +237 -0
- package/dist/role-pack/types.d.ts.map +1 -0
- package/dist/role-pack/types.js +8 -0
- package/dist/role-pack/types.js.map +1 -0
- package/dist/role-pack/validator.d.ts +38 -0
- package/dist/role-pack/validator.d.ts.map +1 -0
- package/dist/role-pack/validator.js +436 -0
- package/dist/role-pack/validator.js.map +1 -0
- package/dist/security/pathGuard.d.ts +69 -72
- package/dist/security/pathGuard.d.ts.map +1 -1
- package/dist/security/pathGuard.js +151 -131
- package/dist/security/pathGuard.js.map +1 -1
- package/dist/skill/skillLayer3.d.ts +91 -0
- package/dist/skill/skillLayer3.d.ts.map +1 -0
- package/dist/skill/skillLayer3.js +104 -0
- package/dist/skill/skillLayer3.js.map +1 -0
- package/dist/skill/skillManager.d.ts +127 -56
- package/dist/skill/skillManager.d.ts.map +1 -1
- package/dist/skill/skillManager.js +318 -163
- package/dist/skill/skillManager.js.map +1 -1
- package/dist/skill/skillScriptRunner.d.ts +97 -0
- package/dist/skill/skillScriptRunner.d.ts.map +1 -0
- package/dist/skill/skillScriptRunner.js +271 -0
- package/dist/skill/skillScriptRunner.js.map +1 -0
- package/dist/skill/types.d.ts +73 -17
- package/dist/skill/types.d.ts.map +1 -1
- package/dist/skill/types.js +5 -1
- package/dist/skill/types.js.map +1 -1
- package/dist/utils/array.d.ts +5 -6
- package/dist/utils/array.d.ts.map +1 -1
- package/dist/utils/array.js +6 -6
- package/dist/utils/array.js.map +1 -1
- package/dist/utils/atomicWrite.d.ts +8 -0
- package/dist/utils/atomicWrite.d.ts.map +1 -0
- package/dist/utils/atomicWrite.js +31 -0
- package/dist/utils/atomicWrite.js.map +1 -0
- package/dist/utils/backgroundTask.d.ts +38 -0
- package/dist/utils/backgroundTask.d.ts.map +1 -0
- package/dist/utils/backgroundTask.js +117 -0
- package/dist/utils/backgroundTask.js.map +1 -0
- package/dist/utils/configResourceManager.d.ts +79 -0
- package/dist/utils/configResourceManager.d.ts.map +1 -0
- package/dist/utils/configResourceManager.js +150 -0
- package/dist/utils/configResourceManager.js.map +1 -0
- package/dist/utils/errors.d.ts +48 -56
- package/dist/utils/errors.d.ts.map +1 -1
- package/dist/utils/errors.js +60 -58
- package/dist/utils/errors.js.map +1 -1
- package/dist/utils/eventEmitter.d.ts +141 -63
- package/dist/utils/eventEmitter.d.ts.map +1 -1
- package/dist/utils/eventEmitter.js +50 -35
- package/dist/utils/eventEmitter.js.map +1 -1
- package/dist/utils/fileSafe.d.ts +20 -0
- package/dist/utils/fileSafe.d.ts.map +1 -0
- package/dist/utils/fileSafe.js +56 -0
- package/dist/utils/fileSafe.js.map +1 -0
- package/dist/utils/frontmatter.d.ts +2 -3
- package/dist/utils/frontmatter.d.ts.map +1 -1
- package/dist/utils/frontmatter.js +6 -5
- package/dist/utils/frontmatter.js.map +1 -1
- package/dist/utils/hash.d.ts +12 -0
- package/dist/utils/hash.d.ts.map +1 -0
- package/dist/utils/hash.js +27 -0
- package/dist/utils/hash.js.map +1 -0
- package/dist/utils/http.d.ts +17 -0
- package/dist/utils/http.d.ts.map +1 -0
- package/dist/utils/http.js +29 -0
- package/dist/utils/http.js.map +1 -0
- package/dist/utils/json.d.ts +1 -1
- package/dist/utils/json.js +1 -1
- package/dist/utils/math.d.ts +34 -1
- package/dist/utils/math.d.ts.map +1 -1
- package/dist/utils/math.js +47 -14
- package/dist/utils/math.js.map +1 -1
- package/dist/utils/objects.d.ts +2 -3
- package/dist/utils/objects.d.ts.map +1 -1
- package/dist/utils/objects.js +2 -3
- package/dist/utils/objects.js.map +1 -1
- package/dist/utils/recallDefaults.d.ts +16 -0
- package/dist/utils/recallDefaults.d.ts.map +1 -0
- package/dist/utils/recallDefaults.js +16 -0
- package/dist/utils/recallDefaults.js.map +1 -0
- package/dist/utils/safeTimer.d.ts +8 -36
- package/dist/utils/safeTimer.d.ts.map +1 -1
- package/dist/utils/safeTimer.js +9 -37
- package/dist/utils/safeTimer.js.map +1 -1
- package/dist/utils/scanner.d.ts +97 -17
- package/dist/utils/scanner.d.ts.map +1 -1
- package/dist/utils/scanner.js +269 -47
- package/dist/utils/scanner.js.map +1 -1
- package/dist/utils/segmenter.d.ts +20 -29
- package/dist/utils/segmenter.d.ts.map +1 -1
- package/dist/utils/segmenter.js +230 -88
- package/dist/utils/segmenter.js.map +1 -1
- package/dist/utils/strings.d.ts +15 -32
- package/dist/utils/strings.d.ts.map +1 -1
- package/dist/utils/strings.js +25 -44
- package/dist/utils/strings.js.map +1 -1
- package/dist/utils/time.d.ts +37 -0
- package/dist/utils/time.d.ts.map +1 -1
- package/dist/utils/time.js +56 -0
- package/dist/utils/time.js.map +1 -1
- package/dist/utils/toError.d.ts +13 -1
- package/dist/utils/toError.d.ts.map +1 -1
- package/dist/utils/toError.js +18 -1
- package/dist/utils/toError.js.map +1 -1
- package/dist/web-fetch/fetchWebFetchProvider.d.ts +14 -0
- package/dist/web-fetch/fetchWebFetchProvider.d.ts.map +1 -0
- package/dist/web-fetch/fetchWebFetchProvider.js +69 -0
- package/dist/web-fetch/fetchWebFetchProvider.js.map +1 -0
- package/dist/web-fetch/types.d.ts +30 -0
- package/dist/web-fetch/types.d.ts.map +1 -0
- package/dist/web-fetch/types.js +7 -0
- package/dist/web-fetch/types.js.map +1 -0
- package/dist/web-fetch/webFetchProvider.d.ts +10 -0
- package/dist/web-fetch/webFetchProvider.d.ts.map +1 -0
- package/dist/web-fetch/webFetchProvider.js +28 -0
- package/dist/web-fetch/webFetchProvider.js.map +1 -0
- package/dist/web-search/fetchWebSearchProvider.d.ts +27 -0
- package/dist/web-search/fetchWebSearchProvider.d.ts.map +1 -0
- package/dist/web-search/fetchWebSearchProvider.js +199 -0
- package/dist/web-search/fetchWebSearchProvider.js.map +1 -0
- package/dist/web-search/types.d.ts +46 -0
- package/dist/web-search/types.d.ts.map +1 -0
- package/dist/web-search/types.js +2 -0
- package/dist/{persona → web-search}/types.js.map +1 -1
- package/dist/web-search/webSearchProvider.d.ts +10 -0
- package/dist/web-search/webSearchProvider.d.ts.map +1 -0
- package/dist/web-search/webSearchProvider.js +30 -0
- package/dist/web-search/webSearchProvider.js.map +1 -0
- package/docs/architecture/role-pack-authoring-guide.md +243 -0
- package/docs/architecture/role-pack-spec.md +767 -0
- package/docs/memora-api-reference.md +1175 -0
- package/docs/memora-/346/216/245/345/205/245/346/214/207/345/215/227.md +843 -0
- package/docs/role-pack-/345/274/200/346/224/276/351/224/256/346/214/207/345/215/227.md +148 -0
- package/package.json +105 -83
- package/role-packs/README.md +41 -0
- package/role-packs/memora/345/212/251/346/211/213/manifest.json +12 -0
- package/role-packs/memora/345/212/251/346/211/213/persona.md +12 -0
- package/role-packs/memora/345/212/251/346/211/213/rules.md +4 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/manifest.json +44 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/persona.md +46 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/rules.md +15 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/character-sheet.md +34 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/core-extractor.md +37 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/craft-review.md +69 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/dialogue-craft.md +45 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/emotion-wave.md +46 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/empathy-craft.md +79 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/foreshadow.md +29 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/hotspot-mapping.md +121 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/idea-lever.md +42 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/logline-craft.md +47 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/longform-guard.md +64 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/need-finder.md +40 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/outline-expand.md +46 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/pacing-hook.md +34 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/polish-method.md +113 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/pov-discipline.md +79 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/project-init/SKILL.md +112 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/project-init/scripts/init-novel-project.mjs +441 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/relationship-web.md +47 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/scene-craft.md +46 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/story-bible.md +60 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/story-structure.md +36 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/style-weaver.md +109 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/three-layer-check.md +27 -0
- package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/world-builder.md +41 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/manifest.json +48 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/persona.md +73 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/rules.md +19 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/api-doc-writer.md +40 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/doc-planner.md +42 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/nutrient-search.md +28 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/seed-finder.md +28 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/ssot-audit.md +34 -0
- package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/style-guide.md +40 -0
- package/dist/agent/guardrail.d.ts +0 -47
- package/dist/agent/guardrail.d.ts.map +0 -1
- package/dist/agent/guardrail.js +0 -51
- package/dist/agent/guardrail.js.map +0 -1
- package/dist/agent/managers/autoConfigRefiner.d.ts +0 -39
- package/dist/agent/managers/autoConfigRefiner.d.ts.map +0 -1
- package/dist/agent/managers/autoConfigRefiner.js +0 -150
- package/dist/agent/managers/autoConfigRefiner.js.map +0 -1
- package/dist/agent/managers/configManager.d.ts +0 -125
- package/dist/agent/managers/configManager.d.ts.map +0 -1
- package/dist/agent/managers/configManager.js +0 -194
- package/dist/agent/managers/configManager.js.map +0 -1
- package/dist/agent/managers/insightExtractor.d.ts +0 -139
- package/dist/agent/managers/insightExtractor.d.ts.map +0 -1
- package/dist/agent/managers/insightExtractor.js +0 -401
- package/dist/agent/managers/insightExtractor.js.map +0 -1
- package/dist/agent/managers/memoryDecayScheduler.d.ts +0 -198
- package/dist/agent/managers/memoryDecayScheduler.d.ts.map +0 -1
- package/dist/agent/managers/memoryDecayScheduler.js +0 -349
- package/dist/agent/managers/memoryDecayScheduler.js.map +0 -1
- package/dist/agent/managers/relationBuilder.d.ts +0 -131
- package/dist/agent/managers/relationBuilder.d.ts.map +0 -1
- package/dist/agent/managers/relationBuilder.js +0 -192
- package/dist/agent/managers/relationBuilder.js.map +0 -1
- package/dist/agent/personaMatcher.d.ts +0 -29
- package/dist/agent/personaMatcher.d.ts.map +0 -1
- package/dist/agent/personaMatcher.js +0 -60
- package/dist/agent/personaMatcher.js.map +0 -1
- package/dist/agent/userFactExtractor.d.ts +0 -25
- package/dist/agent/userFactExtractor.d.ts.map +0 -1
- package/dist/agent/userFactExtractor.js +0 -81
- package/dist/agent/userFactExtractor.js.map +0 -1
- package/dist/eval/evalRunner.d.ts +0 -94
- package/dist/eval/evalRunner.d.ts.map +0 -1
- package/dist/eval/evalRunner.js +0 -141
- package/dist/eval/evalRunner.js.map +0 -1
- package/dist/eval/evalTypes.d.ts +0 -148
- package/dist/eval/evalTypes.d.ts.map +0 -1
- package/dist/eval/evalTypes.js +0 -118
- package/dist/eval/evalTypes.js.map +0 -1
- package/dist/eval/scenarios.d.ts +0 -33
- package/dist/eval/scenarios.d.ts.map +0 -1
- package/dist/eval/scenarios.js +0 -109
- package/dist/eval/scenarios.js.map +0 -1
- package/dist/llm/embedding.d.ts +0 -67
- package/dist/llm/embedding.d.ts.map +0 -1
- package/dist/llm/embedding.js +0 -184
- package/dist/llm/embedding.js.map +0 -1
- package/dist/memory/hybridMerge.d.ts +0 -54
- package/dist/memory/hybridMerge.d.ts.map +0 -1
- package/dist/memory/hybridMerge.js +0 -36
- package/dist/memory/hybridMerge.js.map +0 -1
- package/dist/memory/inMemoryRelationStore.d.ts +0 -51
- package/dist/memory/inMemoryRelationStore.d.ts.map +0 -1
- package/dist/memory/inMemoryRelationStore.js +0 -65
- package/dist/memory/inMemoryRelationStore.js.map +0 -1
- package/dist/memory/loader.d.ts +0 -49
- package/dist/memory/loader.d.ts.map +0 -1
- package/dist/memory/loader.js +0 -93
- package/dist/memory/loader.js.map +0 -1
- package/dist/memory/recall.d.ts +0 -66
- package/dist/memory/recall.d.ts.map +0 -1
- package/dist/memory/recall.js +0 -142
- package/dist/memory/recall.js.map +0 -1
- package/dist/memory/relationStore.d.ts +0 -78
- package/dist/memory/relationStore.d.ts.map +0 -1
- package/dist/memory/relationStore.js +0 -2
- package/dist/memory/relationStore.js.map +0 -1
- package/dist/memory/store.d.ts +0 -50
- package/dist/memory/store.d.ts.map +0 -1
- package/dist/memory/store.js +0 -161
- package/dist/memory/store.js.map +0 -1
- package/dist/memory/userProfile.d.ts +0 -156
- package/dist/memory/userProfile.d.ts.map +0 -1
- package/dist/memory/userProfile.js +0 -320
- package/dist/memory/userProfile.js.map +0 -1
- package/dist/memory/vectorStore.d.ts +0 -185
- package/dist/memory/vectorStore.d.ts.map +0 -1
- package/dist/memory/vectorStore.js +0 -257
- package/dist/memory/vectorStore.js.map +0 -1
- package/dist/persona/personaManager.d.ts +0 -160
- package/dist/persona/personaManager.d.ts.map +0 -1
- package/dist/persona/personaManager.js +0 -414
- package/dist/persona/personaManager.js.map +0 -1
- package/dist/persona/types.d.ts +0 -32
- package/dist/persona/types.d.ts.map +0 -1
- package/dist/persona/types.js +0 -5
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 内存会话视图加载器 — ISessionViewLoader 的内存版实现
|
|
3
|
+
*
|
|
4
|
+
* 职责:将 Session(Round ID 列表)+ RoundStore(物理存储)组合成完整视图
|
|
5
|
+
*
|
|
6
|
+
* 使用场景:
|
|
7
|
+
* - 宿主生产:宿主封装本类并注入文件系统存储(VS Code 宿主 WorkspaceSessionViewLoader
|
|
8
|
+
* 即委托本类,入口 extension.ts → sessionViewLoader.ts:delegate)
|
|
9
|
+
* - 测试环境(零依赖)
|
|
10
|
+
* - 开发调试
|
|
11
|
+
*/
|
|
12
|
+
// 会话显示名回退单一真理源(displayName→autoName),sessionId 兜底留在调用端
|
|
13
|
+
import { getSessionDisplayName } from '../memory/sessionStore.js';
|
|
14
|
+
import { flattenRoundsToMessages, truncateRoundsUpTo, countMessagesInRounds, } from '../memory/sessionViewLoader.js';
|
|
15
|
+
/**
|
|
16
|
+
* 内存会话视图加载器
|
|
17
|
+
*
|
|
18
|
+
* 实现策略:
|
|
19
|
+
* 1. 从 SessionStore 获取 SessionMeta(含 roundIds)
|
|
20
|
+
* 2. 从 RoundStore 批量加载所有 Round
|
|
21
|
+
* 3. 展开为扁平消息列表
|
|
22
|
+
* 4. 支持截断操作(分叉场景)
|
|
23
|
+
*/
|
|
24
|
+
export class InMemorySessionViewLoader {
|
|
25
|
+
roundStore;
|
|
26
|
+
sessionStore;
|
|
27
|
+
constructor(roundStore, sessionStore) {
|
|
28
|
+
this.roundStore = roundStore;
|
|
29
|
+
this.sessionStore = sessionStore;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* 加载会话的完整对话视图
|
|
33
|
+
*
|
|
34
|
+
* 流程:
|
|
35
|
+
* 1. 获取 SessionMeta(含 roundIds 列表)
|
|
36
|
+
* 2. 从 RoundStore 批量加载所有 Round
|
|
37
|
+
* 3. 展开为扁平消息列表
|
|
38
|
+
*
|
|
39
|
+
* @param sessionId - 会话 ID
|
|
40
|
+
* @returns 完整会话视图
|
|
41
|
+
* @throws Error 会话不存在时抛出
|
|
42
|
+
*/
|
|
43
|
+
loadView(sessionId) {
|
|
44
|
+
// 1. 获取会话元数据
|
|
45
|
+
const meta = this.getSessionMeta(sessionId);
|
|
46
|
+
if (!meta) {
|
|
47
|
+
throw new Error(`会话不存在: ${sessionId}`);
|
|
48
|
+
}
|
|
49
|
+
// 2. 获取 Round ID 列表
|
|
50
|
+
const roundIds = this.getRoundIds(sessionId);
|
|
51
|
+
// 3. 批量加载 Round
|
|
52
|
+
const rounds = this.roundStore.getByIds(roundIds);
|
|
53
|
+
// 4. 展开为扁平消息列表
|
|
54
|
+
const messages = flattenRoundsToMessages(rounds);
|
|
55
|
+
return {
|
|
56
|
+
sessionId,
|
|
57
|
+
meta,
|
|
58
|
+
rounds,
|
|
59
|
+
messages,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* 加载会话的简化摘要(用于历史列表等轻量场景)
|
|
64
|
+
*
|
|
65
|
+
* @param sessionId - 会话 ID
|
|
66
|
+
* @returns 会话摘要,不存在返回 null
|
|
67
|
+
*/
|
|
68
|
+
loadSummary(sessionId) {
|
|
69
|
+
// 获取会话元数据
|
|
70
|
+
const meta = this.getSessionMeta(sessionId);
|
|
71
|
+
if (!meta)
|
|
72
|
+
return null;
|
|
73
|
+
// 获取 Round ID 列表
|
|
74
|
+
const roundIds = this.getRoundIds(sessionId);
|
|
75
|
+
// 加载最后一个 Round(用于预览)
|
|
76
|
+
const lastRoundId = roundIds[roundIds.length - 1];
|
|
77
|
+
let lastMessagePreview;
|
|
78
|
+
if (lastRoundId) {
|
|
79
|
+
const lastRound = this.roundStore.getById(lastRoundId);
|
|
80
|
+
if (lastRound) {
|
|
81
|
+
// 取 AI 消息的前 50 个字符作为预览
|
|
82
|
+
if (lastRound.assistantMessage) {
|
|
83
|
+
lastMessagePreview = lastRound.assistantMessage.content.slice(0, 50);
|
|
84
|
+
if (lastRound.assistantMessage.content.length > 50) {
|
|
85
|
+
lastMessagePreview += '...';
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
// 计算标题(SSOT 显示名回退 displayName→autoName,sessionId 作最后兜底)
|
|
91
|
+
const title = getSessionDisplayName(meta) || sessionId;
|
|
92
|
+
return {
|
|
93
|
+
sessionId,
|
|
94
|
+
title,
|
|
95
|
+
roundCount: roundIds.length,
|
|
96
|
+
updatedAt: meta.updatedAt,
|
|
97
|
+
lastMessagePreview,
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* 批量加载多个会话的摘要
|
|
102
|
+
*
|
|
103
|
+
* @param sessionIds - 会话 ID 数组
|
|
104
|
+
* @returns 会话摘要数组
|
|
105
|
+
*/
|
|
106
|
+
loadBatchSummaries(sessionIds) {
|
|
107
|
+
const summaries = [];
|
|
108
|
+
for (const sessionId of sessionIds) {
|
|
109
|
+
const summary = this.loadSummary(sessionId);
|
|
110
|
+
if (summary) {
|
|
111
|
+
summaries.push(summary);
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
// 按 updatedAt 降序排列
|
|
115
|
+
summaries.sort((a, b) => {
|
|
116
|
+
return b.updatedAt > a.updatedAt ? 1 : b.updatedAt < a.updatedAt ? -1 : 0;
|
|
117
|
+
});
|
|
118
|
+
return summaries;
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* 获取会话的消息数量
|
|
122
|
+
*
|
|
123
|
+
* 不加载完整 Round 数据,仅统计消息数
|
|
124
|
+
*
|
|
125
|
+
* @param sessionId - 会话 ID
|
|
126
|
+
* @returns 消息数量(User + AI)
|
|
127
|
+
*/
|
|
128
|
+
getMessageCount(sessionId) {
|
|
129
|
+
const meta = this.getSessionMeta(sessionId);
|
|
130
|
+
if (!meta)
|
|
131
|
+
return 0;
|
|
132
|
+
return meta.messageCount;
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* 从指定 Round 位置截断会话视图
|
|
136
|
+
*
|
|
137
|
+
* 用途:分叉操作时获取分叉点之前的对话
|
|
138
|
+
*
|
|
139
|
+
* @param sessionId - 会话 ID
|
|
140
|
+
* @param upToRoundId - 截断到哪个 Round(包含)
|
|
141
|
+
* @returns 截断后的会话视图
|
|
142
|
+
*/
|
|
143
|
+
loadViewUpTo(sessionId, upToRoundId) {
|
|
144
|
+
// 1. 获取完整视图
|
|
145
|
+
const fullView = this.loadView(sessionId);
|
|
146
|
+
// 2. 截断 Round 列表
|
|
147
|
+
const truncatedRounds = truncateRoundsUpTo(fullView.rounds, upToRoundId);
|
|
148
|
+
// 3. 重新展开消息列表
|
|
149
|
+
const messages = flattenRoundsToMessages(truncatedRounds);
|
|
150
|
+
// 4. 更新元数据中的消息数
|
|
151
|
+
const updatedMeta = {
|
|
152
|
+
...fullView.meta,
|
|
153
|
+
messageCount: countMessagesInRounds(truncatedRounds),
|
|
154
|
+
};
|
|
155
|
+
return {
|
|
156
|
+
sessionId,
|
|
157
|
+
meta: updatedMeta,
|
|
158
|
+
rounds: truncatedRounds,
|
|
159
|
+
messages,
|
|
160
|
+
};
|
|
161
|
+
}
|
|
162
|
+
// ─── 私有辅助方法 ─────────────────────────────────────
|
|
163
|
+
/**
|
|
164
|
+
* 获取会话元数据
|
|
165
|
+
*
|
|
166
|
+
* 直接走 sessionStore.getSessionMeta——ISessionStore 接口**必选**方法(sessionStore.ts 契约),
|
|
167
|
+
* 宿主与内核实现均齐备。返回浅拷贝防外部改 meta 污染存储。
|
|
168
|
+
*/
|
|
169
|
+
getSessionMeta(sessionId) {
|
|
170
|
+
const meta = this.sessionStore.getSessionMeta(sessionId);
|
|
171
|
+
return meta ? { ...meta } : null;
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* 获取会话的 Round ID 列表(SSOT:唯一真源为 sessionStore.getRoundIds)
|
|
175
|
+
*
|
|
176
|
+
* SessionMeta 已回归纯展示 DTO(无 roundIds 字段),轮次一律经真源方法读取。
|
|
177
|
+
* 接口契约保证返回 string[](非空数组也可能),直接展开即可,无需存在性判断。
|
|
178
|
+
*/
|
|
179
|
+
getRoundIds(sessionId) {
|
|
180
|
+
return [...this.sessionStore.getRoundIds(sessionId)];
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
//# sourceMappingURL=inMemorySessionViewLoader.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"inMemorySessionViewLoader.js","sourceRoot":"","sources":["../../src/memory/inMemorySessionViewLoader.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,172 +1,57 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* 内存存储实现 — IMemoryStorage 的纯 JS
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* - 单元测试(不需要 better-sqlite3,不需要文件系统)
|
|
6
|
-
* - 宿主项目注入前的临时占位
|
|
7
|
-
* - 沙箱/演示环境
|
|
8
|
-
*
|
|
9
|
-
* 注意:此实现不持久化,进程退出后数据丢失。
|
|
10
|
-
* ⚠️ 仅限测试/开发使用,生产环境请注入 SqliteStorage(宿主项目提供)。
|
|
2
|
+
* 内存存储实现 — IMemoryStorage 的纯 JS 内存版。
|
|
3
|
+
* 零依赖零 IO,用于单元测试、宿主注入前的临时占位、沙箱。不持久化(进程退出即丢失),
|
|
4
|
+
* 仅限测试/开发;生产由宿主注入持久化实现(当前 vscode 宿主为 WorkspaceStorage,JSON 文件落地)。
|
|
11
5
|
*/
|
|
12
6
|
import type { IMemoryStorage } from '../memory/storageInterface.js';
|
|
13
7
|
import type { Memory } from '../memory/types.js';
|
|
14
8
|
/**
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
* 使用 Map 存储记忆,核心操作 O(1)~O(log n)。
|
|
18
|
-
* 优化:维护 source→count 增量缓存,stats()/sourceHealth() 无需全量遍历。
|
|
9
|
+
* 内存存储:Map 存储,核心操作 O(1)~O(log n)。
|
|
10
|
+
* 维护 source→count 增量缓存,stats()/sourceHealth() 无需全量遍历。
|
|
19
11
|
*/
|
|
20
12
|
export declare class InMemoryStorage implements IMemoryStorage {
|
|
21
13
|
/** 记忆存储(id → Memory) */
|
|
22
14
|
private memories;
|
|
23
|
-
/** source→count 增量缓存(upsert/delete 时维护,getAllSources
|
|
15
|
+
/** source→count 增量缓存(upsert/delete 时维护,getAllSources 直接读取) */
|
|
24
16
|
private sourceCountCache;
|
|
25
17
|
/**
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
* 自动校验 source 字段,对疑似 typo 发出警告日志。
|
|
29
|
-
* 增量维护 sourceCountCache(仅统计活跃记忆):
|
|
30
|
-
* - 新增活跃记忆:source 计数 +1
|
|
31
|
-
* - 更新同 source 同活跃态:计数不变
|
|
32
|
-
* - 更新换 source:旧 source -1、新 source +1
|
|
33
|
-
* 软删除状态转换维护:
|
|
34
|
-
* - 活跃 → 软删除:source 计数 -1
|
|
35
|
-
* - 软删除 → 活跃:source 计数 +1
|
|
36
|
-
*
|
|
37
|
-
* 软删除校验:
|
|
38
|
-
* 若 existing 已软删除(deletedAt !== undefined)且 newMemory 为活跃态
|
|
39
|
-
* (deletedAt === undefined),抛出错误阻止"通过 upsert 复活软删除记忆"。
|
|
40
|
-
* 调用方必须先显式 restore(id) 恢复记忆后再 upsert。
|
|
41
|
-
* 例外:newMemory 显式带 deletedAt(如测试场景篡改 deletedAt)允许通过,
|
|
42
|
-
* 因为此时调用方明确意图是覆盖软删除状态而非"复活"。
|
|
43
|
-
*
|
|
44
|
-
* 采用 delta 方式:先扣除 existing 的活跃贡献,再加回 newMemory 的活跃贡献。
|
|
45
|
-
* 该方式可统一处理 source 变更 + 软删除状态变更的所有组合,避免分支爆炸。
|
|
18
|
+
* upsert:校验 source + 软删除复活拦截 + delta 维护 sourceCountCache。
|
|
19
|
+
* 增量按 source/软删态加减活跃计数;软删除记忆不能经 upsert 静默复活(须先 restore)。
|
|
46
20
|
*/
|
|
47
21
|
upsert(memory: Memory): void;
|
|
48
|
-
/**
|
|
49
|
-
* 软删除记忆
|
|
50
|
-
*
|
|
51
|
-
* 写入 deletedAt 时间戳,不物理移除 Map 条目。
|
|
52
|
-
* - 召回/搜索/列表/统计自动过滤已软删除的记忆
|
|
53
|
-
* - 可通过 restore(id) 恢复
|
|
54
|
-
* - 回收站保留期过后由 purgeExpired(before) 物理清理
|
|
55
|
-
*
|
|
56
|
-
* 对已软删除的记忆调用为 no-op。
|
|
57
|
-
* 增量维护 sourceCountCache:软删除时对应 source 减 1。
|
|
58
|
-
*/
|
|
22
|
+
/** 软删除:写 deletedAt 标记不物理移除;可 restore 恢复,过期由 purgeExpired 清理 */
|
|
59
23
|
delete(id: string): void;
|
|
60
|
-
/**
|
|
61
|
-
* 恢复软删除的记忆
|
|
62
|
-
*
|
|
63
|
-
* 清除 deletedAt 字段,使记忆重新出现在召回/搜索/列表中。
|
|
64
|
-
* 对活跃记忆调用为 no-op。
|
|
65
|
-
* 增量维护 sourceCountCache:恢复时对应 source 加 1。
|
|
66
|
-
*/
|
|
24
|
+
/** 恢复软删除:清除 deletedAt 使记忆重回召回/搜索/列表;活跃态调用为 no-op */
|
|
67
25
|
restore(id: string): void;
|
|
68
|
-
/**
|
|
69
|
-
* 物理删除记忆
|
|
70
|
-
*
|
|
71
|
-
* 从 Map 中彻底移除,不可恢复。
|
|
72
|
-
* 用于回收站的"彻底删除"操作,或测试环境的强制清理。
|
|
73
|
-
*
|
|
74
|
-
* 注意:若记忆为活跃态(未软删除),purge 也会减 1 计数,
|
|
75
|
-
* 但正常流程应先软删除再 purge,此时计数已在 delete() 中扣除。
|
|
76
|
-
*/
|
|
26
|
+
/** 物理删除:从 Map 彻底移除不可恢复;活跃态亦扣减计数(正常流程先 delete 已扣) */
|
|
77
27
|
purge(id: string): void;
|
|
78
|
-
/**
|
|
79
|
-
* 列出回收站中的软删除记忆
|
|
80
|
-
*
|
|
81
|
-
* 按 deletedAt 降序(最近删除的在前),便于回收站 UI 展示。
|
|
82
|
-
* 返回浅拷贝,避免调用方修改污染存储内部对象。
|
|
83
|
-
*
|
|
84
|
-
* @param limit - 返回数量上限(默认 50)
|
|
85
|
-
* @returns 软删除记忆列表(副本)
|
|
86
|
-
*/
|
|
28
|
+
/** 列出软删除记忆,按 deletedAt 降序;limit<=0 或 undefined 表示不设上限(返回全部) */
|
|
87
29
|
listDeleted(limit?: number): Memory[];
|
|
88
|
-
/**
|
|
89
|
-
* 按 ID 获取单条软删除记忆
|
|
90
|
-
*
|
|
91
|
-
* 用于 restore/purge 操作前的存在性校验,避免 listDeleted 默认 50 上限
|
|
92
|
-
* 导致回收站超量时操作失效。
|
|
93
|
-
*
|
|
94
|
-
* @param id 记忆唯一标识
|
|
95
|
-
* @returns 软删除记忆(浅拷贝),不存在或未软删除时返回 null
|
|
96
|
-
*/
|
|
30
|
+
/** 按 ID 取单条软删除记忆(浅拷贝);不存在或未软删除返回 null */
|
|
97
31
|
getDeletedById(id: string): Memory | null;
|
|
98
|
-
/**
|
|
99
|
-
* 清理过期的软删除记忆
|
|
100
|
-
*
|
|
101
|
-
* 物理删除所有 deletedAt 早于 before 的记忆。
|
|
102
|
-
* 由宿主项目的定时器调用(默认 30 天保留期)。
|
|
103
|
-
*
|
|
104
|
-
* @param before - 时间阈值,deletedAt 早于此值的记忆将被物理删除
|
|
105
|
-
* @returns 被清理的记忆数量
|
|
106
|
-
*/
|
|
32
|
+
/** 物理删除 deletedAt 早于 before 的软删除记忆,返回清理数量(宿主定时器默认 30 天保留期调用) */
|
|
107
33
|
purgeExpired(before: Date): number;
|
|
108
|
-
/**
|
|
109
|
-
* 按 ID 获取单条活跃记忆(已软删除的返回 null)
|
|
110
|
-
*
|
|
111
|
-
* 返回浅拷贝,避免调用方修改污染存储内部对象(接口契约:读取隔离)
|
|
112
|
-
*/
|
|
34
|
+
/** 按 ID 取活跃记忆(浅拷贝,软删除返回 null,读取隔离契约) */
|
|
113
35
|
getById(id: string): Memory | null;
|
|
114
|
-
/**
|
|
115
|
-
* 按来源标签获取活跃记忆(自动过滤已软删除的)
|
|
116
|
-
*
|
|
117
|
-
* 返回浅拷贝数组,避免调用方修改污染存储内部对象。
|
|
118
|
-
*
|
|
119
|
-
* @param source - 来源标签(如 'persona'、'rule'、'insight')
|
|
120
|
-
* @returns 该来源的所有活跃记忆(副本),按 score 降序排列
|
|
121
|
-
*/
|
|
36
|
+
/** 按 source 取活跃记忆(浅拷贝,自动过滤软删除,accessedAt 降序) */
|
|
122
37
|
getBySource(source: string): Memory[];
|
|
123
|
-
/**
|
|
124
|
-
* 文本搜索活跃记忆(自动过滤已软删除的,内存版)
|
|
125
|
-
*
|
|
126
|
-
* 使用 segmentText() 规范分词,与 SqliteStorage 行为一致。
|
|
127
|
-
* 搜索 content 和 name 字段,按 score 降序排列。
|
|
128
|
-
*
|
|
129
|
-
* @param query - 搜索查询文本
|
|
130
|
-
* @param limit - 返回数量上限(默认 10)
|
|
131
|
-
* @returns 匹配的活跃记忆列表
|
|
132
|
-
*/
|
|
38
|
+
/** 文本搜索活跃记忆(segmentLower 与 SqliteStorage/keywordsTouch 一致),accessedAt 降序,limit 默认 10 */
|
|
133
39
|
search(query: string, limit?: number): Memory[];
|
|
134
|
-
/**
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
* 优化:直接累加 sourceCountCache 的所有值,O(sources) 复杂度。
|
|
138
|
-
* 因 sourceCountCache 仅维护活跃记忆计数,求和即为活跃总数。
|
|
139
|
-
*/
|
|
40
|
+
/** 排序 + 截断 + 浅拷贝,消除 search 内重复的 pattern */
|
|
41
|
+
private sortCopyLimit;
|
|
42
|
+
/** 活跃记忆总数:累加 sourceCountCache(仅维护活跃计数) */
|
|
140
43
|
count(): number;
|
|
141
|
-
/**
|
|
142
|
-
* 按来源标签统计记忆数量
|
|
143
|
-
*
|
|
144
|
-
* 优化:直接读取 sourceCountCache,O(1) 复杂度
|
|
145
|
-
* (getAllSources 为 O(sources),因需拷贝 Map,二者复杂度不同)
|
|
146
|
-
* 原实现 O(n) 遍历所有记忆,与增量缓存设计不一致
|
|
147
|
-
*/
|
|
44
|
+
/** 按 source 统计活跃数量,O(1) 读 sourceCountCache */
|
|
148
45
|
countBySource(source: string): number;
|
|
149
|
-
/**
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
* 遍历所有匹配 source 的活跃记忆,按时间衰减。
|
|
153
|
-
* 生产环境宿主(SqliteStorage)应重写为 SQL UPDATE 批量操作。
|
|
154
|
-
*/
|
|
155
|
-
decayScores(sources: string[], now: Date): number;
|
|
156
|
-
/**
|
|
157
|
-
* 获取所有 source 标签及其记忆数量
|
|
158
|
-
*
|
|
159
|
-
* 优化:直接读取增量维护的 sourceCountCache。
|
|
160
|
-
* 复杂度为 O(sources)(拷贝 Map),相比全量遍历 O(n) 仍有显著优化。
|
|
161
|
-
*/
|
|
46
|
+
/** 刷新 accessedAt(score 退役后的唯一写位);不存在/软删返回 false */
|
|
47
|
+
touch(id: string, now: string): boolean;
|
|
48
|
+
/** 全部 source 及活跃计数(拷贝 Map,O(sources)) */
|
|
162
49
|
getAllSources(): Map<string, number>;
|
|
163
|
-
/**
|
|
164
|
-
* 关闭(内存实现无需关闭)
|
|
165
|
-
*/
|
|
50
|
+
/** 关闭即丢弃全部记忆(终结操作不可逆);勿在会话暂停/检查点恢复等状态层动作调用 */
|
|
166
51
|
close(): void;
|
|
167
52
|
/** source 计数 +1 */
|
|
168
53
|
private incrementSourceCount;
|
|
169
|
-
/** source 计数 -1(减至 0
|
|
54
|
+
/** source 计数 -1(减至 0 移除键) */
|
|
170
55
|
private decrementSourceCount;
|
|
171
56
|
}
|
|
172
57
|
//# sourceMappingURL=inMemoryStorage.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inMemoryStorage.d.ts","sourceRoot":"","sources":["../../src/memory/inMemoryStorage.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"inMemoryStorage.d.ts","sourceRoot":"","sources":["../../src/memory/inMemoryStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQhD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAkC;IAClD,8DAA8D;IAC9D,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqC5B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQzB,oDAAoD;IACpD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASvB,+DAA+D;IAC/D,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAUrC,yCAAyC;IACzC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMzC,gEAAgE;IAChE,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAYlC,wCAAwC;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMlC,gDAAgD;IAChD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAOrC,wFAAwF;IACxF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE;IAoB3C,2CAA2C;IAC3C,OAAO,CAAC,aAAa;IAOrB,0CAA0C;IAC1C,KAAK,IAAI,MAAM;IAMf,8CAA8C;IAC9C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIrC,mDAAmD;IACnD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAOvC,yCAAyC;IACzC,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IAKb,mBAAmB;IACnB,OAAO,CAAC,oBAAoB;IAI5B,6BAA6B;IAC7B,OAAO,CAAC,oBAAoB;CAS7B"}
|