@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
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"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"}
|
package/dist/agent/types.js
CHANGED
|
@@ -1,57 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Agent 流式输出事件类型
|
|
3
3
|
*
|
|
4
|
-
* 核心库向上层 emit
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* 自然生长原则:这是核心库的"机制"——所有宿主项目都需要进度反馈,
|
|
8
|
-
* 不是 demo 的"策略"。
|
|
9
|
-
*
|
|
10
|
-
* thinking 事件的 phase 取值:
|
|
11
|
-
* - 'recalling':正在召回会话记忆(recall 双通道:语义 + 关键词)
|
|
12
|
-
* - 'processing':正在写入历史/注入技能 prompt
|
|
13
|
-
* - 'archiving':正在归档用户画像/匹配角色/匹配技能
|
|
14
|
-
*
|
|
15
|
-
* error 事件:流式过程中发生错误(如 LLM 超时、连接断开),
|
|
16
|
-
* 替代裸 throw 让宿主能优雅展示错误并清理 UI(避免未处理 rejection 静默卡死)。
|
|
17
|
-
*
|
|
18
|
-
* ─── agent/ 模块依赖图(最后更新:2026-07-16) ─────────────────
|
|
19
|
-
* 如需精确依赖关系,请阅读各文件 import 语句。本图仅展示高层模块关系。
|
|
20
|
-
*
|
|
21
|
-
* agent.ts(门面,Agent 类)
|
|
22
|
-
* ├─ assembler.ts(组件装配,init 阶段)
|
|
23
|
-
* ├─ loop.ts(主循环,chat 阶段)
|
|
24
|
-
* │ ├─ toolExecutor.ts(工具执行)
|
|
25
|
-
* │ ├─ contextManager.ts(上下文窗口管理)
|
|
26
|
-
* │ ├─ messageHistory.ts(历史消息存储)
|
|
27
|
-
* │ ├─ guardrail.ts(护栏规则)
|
|
28
|
-
* │ └─ tracer.ts(可观测性 span)
|
|
29
|
-
* ├─ personaMatcher.ts(LLM 角色匹配,从 persona 迁入)
|
|
30
|
-
* ├─ userFactExtractor.ts(用户事实提取,纯函数)
|
|
31
|
-
* ├─ builtinToolHandlers.ts(内置工具处理器)
|
|
32
|
-
* └─ managers/(12 个专职 Manager)
|
|
33
|
-
* ├─ chatLockManager.ts(并发锁,token 机制)
|
|
34
|
-
* ├─ configManager.ts(配置加载)
|
|
35
|
-
* ├─ contextManager.ts(上下文管理)
|
|
36
|
-
* ├─ insightExtractor.ts(LLM 提炼,prompt 独立函数)
|
|
37
|
-
* ├─ memoryInspector.ts(记忆读写统一入口,ADR-014)
|
|
38
|
-
* ├─ memoryDecayScheduler.ts(记忆衰减调度)
|
|
39
|
-
* ├─ memoryAdvisor.ts(记忆建议)
|
|
40
|
-
* ├─ relationBuilder.ts(记忆关系构建,ADR-014 侧车)
|
|
41
|
-
* ├─ archiveCoordinator.ts(归档协调,emit archiveFailed)
|
|
42
|
-
* ├─ sessionArchiver.ts(会话归档)
|
|
43
|
-
* ├─ sessionManager.ts(会话状态)
|
|
44
|
-
* ├─ textPolishManager.ts(文本润色)
|
|
45
|
-
* ├─ autoConfigRefiner.ts(配置自动优化)
|
|
46
|
-
* └─ workProjection.ts(作品投影)
|
|
47
|
-
*
|
|
48
|
-
* 分层依赖方向(ADR-008):
|
|
49
|
-
* agent/ → memory/ → storage/(不可反向)
|
|
50
|
-
* agent/ → persona/(不可反向,persona 不调 LLM)
|
|
51
|
-
* agent/ → llm/(provider 注入)
|
|
52
|
-
* agent/ → skill/(技能加载)
|
|
53
|
-
* agent/ → config/(配置加载)
|
|
54
|
-
* ──────────────────────────────────────────────────────────
|
|
4
|
+
* 核心库向上层 emit 结构化事件,让宿主区分思考/输出/调用工具等阶段——
|
|
5
|
+
* error 事件替代裸 throw,让宿主优雅展示错误并清理 UI(避免未处理 rejection 静默卡死)。
|
|
55
6
|
*/
|
|
56
7
|
export {};
|
|
57
8
|
//# sourceMappingURL=types.js.map
|
package/dist/agent/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 代码执行集成入口:提供带超时保护的加载包装,组合宿主注入的执行器。
|
|
3
|
+
* 执行失败时降级返回友好错误结果,不中断对话流程(超时防卡死 Agent 主循环)。
|
|
4
|
+
*/
|
|
5
|
+
import type { CodeExecutionOptions, CodeExecutionResult, ICodeExecutionProvider } from '../code-exec/types.js';
|
|
6
|
+
/**
|
|
7
|
+
* 带超时和错误处理的执行包装:超时或失败时不抛异常,返回降级结果。
|
|
8
|
+
*
|
|
9
|
+
* @param provider 宿主注入的执行器
|
|
10
|
+
* @param code 要执行的代码
|
|
11
|
+
* @param language 代码语言
|
|
12
|
+
* @param options 执行选项(timeoutMs 同时用于外层兜底超时)
|
|
13
|
+
* @returns 执行结果(失败时 exitCode=-1 并附降级提示;外层兜底超时时 timedOut=true)
|
|
14
|
+
*/
|
|
15
|
+
export declare function safeExecuteCode(provider: ICodeExecutionProvider, code: string, language: string, options?: CodeExecutionOptions): Promise<CodeExecutionResult>;
|
|
16
|
+
//# sourceMappingURL=codeExecutionProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codeExecutionProvider.d.ts","sourceRoot":"","sources":["../../src/code-exec/codeExecutionProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAW9B;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAsC9B"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/** 代码执行外层兜底超时(毫秒):对齐 run_skill_script 的最大执行超时 */
|
|
2
|
+
const EXECUTION_TIMEOUT_MS = 120_000;
|
|
3
|
+
/**
|
|
4
|
+
* 外层兜底超时错误标记(Symbol 键):区分「执行器超时无响应」与「执行器执行失败」。
|
|
5
|
+
* 用 Symbol 而非字符串匹配——宿主执行器抛同名文案不误判(字符串耦合脆弱)。
|
|
6
|
+
*/
|
|
7
|
+
const TIMEOUT_FLAG = Symbol('safeExecuteCodeTimeout');
|
|
8
|
+
/**
|
|
9
|
+
* 带超时和错误处理的执行包装:超时或失败时不抛异常,返回降级结果。
|
|
10
|
+
*
|
|
11
|
+
* @param provider 宿主注入的执行器
|
|
12
|
+
* @param code 要执行的代码
|
|
13
|
+
* @param language 代码语言
|
|
14
|
+
* @param options 执行选项(timeoutMs 同时用于外层兜底超时)
|
|
15
|
+
* @returns 执行结果(失败时 exitCode=-1 并附降级提示;外层兜底超时时 timedOut=true)
|
|
16
|
+
*/
|
|
17
|
+
export async function safeExecuteCode(provider, code, language, options) {
|
|
18
|
+
const timeoutMs = options?.timeoutMs ?? EXECUTION_TIMEOUT_MS;
|
|
19
|
+
// 外部持有定时器 + finally 清理:执行器正常返回时兜底定时器仍挂起会延迟进程退出
|
|
20
|
+
// (对齐 safeSearch/safeFetch/safeSearchProjectFiles 同款定时器模式)
|
|
21
|
+
let timer;
|
|
22
|
+
const timeoutPromise = new Promise((_, reject) => {
|
|
23
|
+
timer = setTimeout(() => {
|
|
24
|
+
// 打标超时错误:外层兜底超时是「执行器无响应」而非执行失败,须还原 timedOut 位
|
|
25
|
+
const err = new Error('代码执行超时(外层兜底)');
|
|
26
|
+
err[TIMEOUT_FLAG] = true;
|
|
27
|
+
reject(err);
|
|
28
|
+
}, timeoutMs);
|
|
29
|
+
});
|
|
30
|
+
try {
|
|
31
|
+
const result = await Promise.race([provider.execute(code, language, options), timeoutPromise]);
|
|
32
|
+
return result;
|
|
33
|
+
}
|
|
34
|
+
catch (err) {
|
|
35
|
+
// 外层兜底超时(执行器无响应)→ 降级为超时结果(timedOut=true,三态判定走 CODE_TIMEOUT)
|
|
36
|
+
const isTimeout = typeof err === 'object' &&
|
|
37
|
+
err !== null &&
|
|
38
|
+
err[TIMEOUT_FLAG] === true;
|
|
39
|
+
if (isTimeout) {
|
|
40
|
+
return {
|
|
41
|
+
stdout: '',
|
|
42
|
+
stderr: '执行超时(外层兜底:执行器无响应)',
|
|
43
|
+
exitCode: -1,
|
|
44
|
+
timedOut: true,
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
// 执行失败不抛异常,返回降级提示
|
|
48
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
49
|
+
return { stdout: '', stderr: `执行失败:${message}`, exitCode: -1, timedOut: false };
|
|
50
|
+
}
|
|
51
|
+
finally {
|
|
52
|
+
// 正常完成或失败时清理兜底定时器,防 event loop 挂起(进程退出延迟)
|
|
53
|
+
if (timer)
|
|
54
|
+
clearTimeout(timer);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=codeExecutionProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codeExecutionProvider.js","sourceRoot":"","sources":["../../src/code-exec/codeExecutionProvider.ts"],"names":[],"mappings":"AAUA,iDAAiD;AACjD,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAErC;;;GAGG;AACH,MAAM,YAAY,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgC,EAChC,IAAY,EACZ,QAAgB,EAChB,OAA8B;IAE9B,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,oBAAoB,CAAC;IAC7D,+CAA+C;IAC/C,2DAA2D;IAC3D,IAAI,KAAiC,CAAC;IACtC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACpE,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,8CAA8C;YAC9C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,CAAyC,CAAC;YAC9E,GAAG,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;QAC/F,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4DAA4D;QAC5D,MAAM,SAAS,GACb,OAAO,GAAG,KAAK,QAAQ;YACvB,GAAG,KAAK,IAAI;YACX,GAAoC,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;QAC/D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,mBAAmB;gBAC3B,QAAQ,EAAE,CAAC,CAAC;gBACZ,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;QACD,kBAAkB;QAClB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClF,CAAC;YAAS,CAAC;QACT,0CAA0C;QAC1C,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 代码执行提供者接口定义:让 memora 内核具备可注入的通用代码执行能力。
|
|
3
|
+
* 宿主实现 ICodeExecutionProvider 注入沙箱执行器(接口注入,遵循 IWebSearchProvider 模式;零依赖)。
|
|
4
|
+
*
|
|
5
|
+
* 与 run_skill_script 的区别:
|
|
6
|
+
* - run_skill_script 绑定技能目录内的脚本文件(执行器由内核内置,子进程沙箱);
|
|
7
|
+
* - run_code 是通用的「模型写代码 → 执行 → 结果回填」能力,执行器**由宿主注入**。
|
|
8
|
+
*
|
|
9
|
+
* 安全注意:内核不内置沙箱执行器(保持零依赖),执行器的隔离等级与可用语言由宿主决定。
|
|
10
|
+
*/
|
|
11
|
+
/** 代码执行结果 */
|
|
12
|
+
export interface CodeExecutionResult {
|
|
13
|
+
/** 标准输出 */
|
|
14
|
+
stdout: string;
|
|
15
|
+
/** 标准错误 */
|
|
16
|
+
stderr: string;
|
|
17
|
+
/** 退出码(0 = 成功) */
|
|
18
|
+
exitCode: number;
|
|
19
|
+
/** 是否超时 */
|
|
20
|
+
timedOut: boolean;
|
|
21
|
+
}
|
|
22
|
+
/** 代码执行选项 */
|
|
23
|
+
export interface CodeExecutionOptions {
|
|
24
|
+
/** 执行超时(毫秒,默认 30000,最大 120000) */
|
|
25
|
+
timeoutMs?: number;
|
|
26
|
+
/** 工作目录(可选,未传由执行器决定) */
|
|
27
|
+
cwd?: string;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* 代码执行提供者接口:宿主实现并注入 AgentOptions.codeExecutionProvider 提供执行能力;
|
|
31
|
+
* 未注入时 Agent 不会暴露 run_code 工具给 LLM。
|
|
32
|
+
*/
|
|
33
|
+
export interface ICodeExecutionProvider {
|
|
34
|
+
/** 执行代码字符串,返回 stdout/stderr/exitCode/timedOut */
|
|
35
|
+
execute(code: string, language: string, options?: CodeExecutionOptions): Promise<CodeExecutionResult>;
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/code-exec/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,aAAa;AACb,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,aAAa;AACb,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 代码执行提供者接口定义:让 memora 内核具备可注入的通用代码执行能力。
|
|
3
|
+
* 宿主实现 ICodeExecutionProvider 注入沙箱执行器(接口注入,遵循 IWebSearchProvider 模式;零依赖)。
|
|
4
|
+
*
|
|
5
|
+
* 与 run_skill_script 的区别:
|
|
6
|
+
* - run_skill_script 绑定技能目录内的脚本文件(执行器由内核内置,子进程沙箱);
|
|
7
|
+
* - run_code 是通用的「模型写代码 → 执行 → 结果回填」能力,执行器**由宿主注入**。
|
|
8
|
+
*
|
|
9
|
+
* 安全注意:内核不内置沙箱执行器(保持零依赖),执行器的隔离等级与可用语言由宿主决定。
|
|
10
|
+
*/
|
|
11
|
+
export {};
|
|
12
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/code-exec/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 环境变量展开工具
|
|
3
|
+
*
|
|
4
|
+
* 展开配置文件中 ${ENV_VAR} 占位符为实际环境变量值。
|
|
5
|
+
* 覆盖范围:llm.providers 映射表。
|
|
6
|
+
*
|
|
7
|
+
* 保持职责单一(从 loader.ts 提取)。
|
|
8
|
+
*/
|
|
9
|
+
import type { Config } from '../config/loader.js';
|
|
10
|
+
/**
|
|
11
|
+
* 展开 ${ENV_VAR} 占位符
|
|
12
|
+
*
|
|
13
|
+
* 配置文件可写 "apiKey": "${MEMORA_API_KEY}",
|
|
14
|
+
* 实际读取时展开为环境变量值。
|
|
15
|
+
*
|
|
16
|
+
* 展开范围覆盖所有可能包含敏感信息的通道:llm.providers(多 Provider 映射表)的 apiKey / baseUrl。
|
|
17
|
+
*
|
|
18
|
+
* @param config 原始配置(可能含 ${ENV_VAR} 占位符)
|
|
19
|
+
* @returns 展开后的配置(占位符替换为环境变量值)
|
|
20
|
+
*/
|
|
21
|
+
export declare function expandEnvVars(config: Config): Config;
|
|
22
|
+
//# sourceMappingURL=expandEnvVars.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"expandEnvVars.d.ts","sourceRoot":"","sources":["../../src/config/expandEnvVars.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA4BpD"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 展开 ${ENV_VAR} 占位符
|
|
3
|
+
*
|
|
4
|
+
* 配置文件可写 "apiKey": "${MEMORA_API_KEY}",
|
|
5
|
+
* 实际读取时展开为环境变量值。
|
|
6
|
+
*
|
|
7
|
+
* 展开范围覆盖所有可能包含敏感信息的通道:llm.providers(多 Provider 映射表)的 apiKey / baseUrl。
|
|
8
|
+
*
|
|
9
|
+
* @param config 原始配置(可能含 ${ENV_VAR} 占位符)
|
|
10
|
+
* @returns 展开后的配置(占位符替换为环境变量值)
|
|
11
|
+
*/
|
|
12
|
+
export function expandEnvVars(config) {
|
|
13
|
+
const expand = (val) => {
|
|
14
|
+
if (!val)
|
|
15
|
+
return val;
|
|
16
|
+
return val.replace(/\$\{([A-Z_][A-Z0-9_]*)\}/g, (_, name) => process.env[name] ?? '');
|
|
17
|
+
};
|
|
18
|
+
// 展开 providers 映射表中的环境变量
|
|
19
|
+
const expandedProviders = config.llm.providers
|
|
20
|
+
? Object.fromEntries(Object.entries(config.llm.providers).map(([key, p]) => [
|
|
21
|
+
key,
|
|
22
|
+
{
|
|
23
|
+
...p,
|
|
24
|
+
apiKey: expand(p.apiKey),
|
|
25
|
+
baseUrl: expand(p.baseUrl),
|
|
26
|
+
model: expand(p.model) ?? p.model,
|
|
27
|
+
},
|
|
28
|
+
]))
|
|
29
|
+
: undefined;
|
|
30
|
+
return {
|
|
31
|
+
...config,
|
|
32
|
+
llm: {
|
|
33
|
+
...config.llm,
|
|
34
|
+
providers: expandedProviders,
|
|
35
|
+
},
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=expandEnvVars.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"expandEnvVars.js","sourceRoot":"","sources":["../../src/config/expandEnvVars.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAuB,EAAsB,EAAE;QAC7D,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,CAAC;QACrB,OAAO,GAAG,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC;IAEF,yBAAyB;IACzB,MAAM,iBAAiB,GAAoD,MAAM,CAAC,GAAG,CAAC,SAAS;QAC7F,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACrD,GAAG;YACH;gBACE,GAAG,CAAC;gBACJ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;gBACxB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC1B,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK;aAClC;SACF,CAAC,CACH;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,GAAG,MAAM;QACT,GAAG,EAAE;YACH,GAAG,MAAM,CAAC,GAAG;YACb,SAAS,EAAE,iBAAiB;SAC7B;KACF,CAAC;AACJ,CAAC"}
|
package/dist/config/loader.d.ts
CHANGED
|
@@ -1,248 +1,65 @@
|
|
|
1
|
-
import {
|
|
2
|
-
declare const ConfigSchema: z.ZodObject<{
|
|
3
|
-
llm: z.ZodDefault<z.ZodObject<{
|
|
4
|
-
provider: z.ZodDefault<z.ZodString>;
|
|
5
|
-
model: z.ZodDefault<z.ZodString>;
|
|
6
|
-
baseUrl: z.ZodOptional<z.ZodString>;
|
|
7
|
-
apiKey: z.ZodOptional<z.ZodString>;
|
|
8
|
-
temperature: z.ZodDefault<z.ZodNumber>;
|
|
9
|
-
/**
|
|
10
|
-
* 多 Provider 映射表
|
|
11
|
-
*
|
|
12
|
-
* key 为 Provider 别名(如 "deepseek"、"openai"),value 为 Provider 配置。
|
|
13
|
-
* 配置后,旧扁平字段(provider/model/baseUrl/apiKey)被忽略。
|
|
14
|
-
* 不配置时回退到旧的单 provider 行为——完全向后兼容。
|
|
15
|
-
*/
|
|
16
|
-
providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
17
|
-
provider: z.ZodString;
|
|
18
|
-
model: z.ZodString;
|
|
19
|
-
baseUrl: z.ZodOptional<z.ZodString>;
|
|
20
|
-
apiKey: z.ZodOptional<z.ZodString>;
|
|
21
|
-
/** 该 Provider 的 temperature,未配置时回退到全局 llm.temperature */
|
|
22
|
-
temperature: z.ZodOptional<z.ZodNumber>;
|
|
23
|
-
/** 该 Provider 的上下文窗口大小(token 数),未配置时回退到 memory.maxContextTokens */
|
|
24
|
-
contextWindow: z.ZodOptional<z.ZodNumber>;
|
|
25
|
-
}, "strip", z.ZodTypeAny, {
|
|
26
|
-
model: string;
|
|
27
|
-
provider: string;
|
|
28
|
-
apiKey?: string | undefined;
|
|
29
|
-
temperature?: number | undefined;
|
|
30
|
-
baseUrl?: string | undefined;
|
|
31
|
-
contextWindow?: number | undefined;
|
|
32
|
-
}, {
|
|
33
|
-
model: string;
|
|
34
|
-
provider: string;
|
|
35
|
-
apiKey?: string | undefined;
|
|
36
|
-
temperature?: number | undefined;
|
|
37
|
-
baseUrl?: string | undefined;
|
|
38
|
-
contextWindow?: number | undefined;
|
|
39
|
-
}>>>;
|
|
40
|
-
/**
|
|
41
|
-
* 当前激活的 Provider 别名
|
|
42
|
-
*
|
|
43
|
-
* 必须与 providers 中的某个 key 一致。
|
|
44
|
-
* 不配置时默认使用 providers 的第一个 key。
|
|
45
|
-
*/
|
|
46
|
-
active: z.ZodOptional<z.ZodString>;
|
|
47
|
-
/**
|
|
48
|
-
* 后台通道配置(多 Provider 路由预留)
|
|
49
|
-
*
|
|
50
|
-
* 不配时所有消费者复用前台(llm)配置——零破坏性,完全向后兼容。
|
|
51
|
-
* 配置后,归档/投影/画像等后台操作使用此通道,降低成本。
|
|
52
|
-
* 详见接入指南 §九
|
|
53
|
-
*/
|
|
54
|
-
background: z.ZodOptional<z.ZodObject<{
|
|
55
|
-
provider: z.ZodString;
|
|
56
|
-
model: z.ZodString;
|
|
57
|
-
baseUrl: z.ZodOptional<z.ZodString>;
|
|
58
|
-
apiKey: z.ZodOptional<z.ZodString>;
|
|
59
|
-
temperature: z.ZodDefault<z.ZodNumber>;
|
|
60
|
-
}, "strip", z.ZodTypeAny, {
|
|
61
|
-
temperature: number;
|
|
62
|
-
model: string;
|
|
63
|
-
provider: string;
|
|
64
|
-
apiKey?: string | undefined;
|
|
65
|
-
baseUrl?: string | undefined;
|
|
66
|
-
}, {
|
|
67
|
-
model: string;
|
|
68
|
-
provider: string;
|
|
69
|
-
apiKey?: string | undefined;
|
|
70
|
-
temperature?: number | undefined;
|
|
71
|
-
baseUrl?: string | undefined;
|
|
72
|
-
}>>;
|
|
73
|
-
}, "strip", z.ZodTypeAny, {
|
|
74
|
-
temperature: number;
|
|
75
|
-
model: string;
|
|
76
|
-
provider: string;
|
|
77
|
-
apiKey?: string | undefined;
|
|
78
|
-
active?: string | undefined;
|
|
79
|
-
baseUrl?: string | undefined;
|
|
80
|
-
providers?: Record<string, {
|
|
81
|
-
model: string;
|
|
82
|
-
provider: string;
|
|
83
|
-
apiKey?: string | undefined;
|
|
84
|
-
temperature?: number | undefined;
|
|
85
|
-
baseUrl?: string | undefined;
|
|
86
|
-
contextWindow?: number | undefined;
|
|
87
|
-
}> | undefined;
|
|
88
|
-
background?: {
|
|
89
|
-
temperature: number;
|
|
90
|
-
model: string;
|
|
91
|
-
provider: string;
|
|
92
|
-
apiKey?: string | undefined;
|
|
93
|
-
baseUrl?: string | undefined;
|
|
94
|
-
} | undefined;
|
|
95
|
-
}, {
|
|
96
|
-
apiKey?: string | undefined;
|
|
97
|
-
temperature?: number | undefined;
|
|
98
|
-
model?: string | undefined;
|
|
99
|
-
active?: string | undefined;
|
|
100
|
-
provider?: string | undefined;
|
|
101
|
-
baseUrl?: string | undefined;
|
|
102
|
-
providers?: Record<string, {
|
|
103
|
-
model: string;
|
|
104
|
-
provider: string;
|
|
105
|
-
apiKey?: string | undefined;
|
|
106
|
-
temperature?: number | undefined;
|
|
107
|
-
baseUrl?: string | undefined;
|
|
108
|
-
contextWindow?: number | undefined;
|
|
109
|
-
}> | undefined;
|
|
110
|
-
background?: {
|
|
111
|
-
model: string;
|
|
112
|
-
provider: string;
|
|
113
|
-
apiKey?: string | undefined;
|
|
114
|
-
temperature?: number | undefined;
|
|
115
|
-
baseUrl?: string | undefined;
|
|
116
|
-
} | undefined;
|
|
117
|
-
}>>;
|
|
118
|
-
memory: z.ZodDefault<z.ZodObject<{
|
|
119
|
-
dataDir: z.ZodDefault<z.ZodString>;
|
|
120
|
-
maxContextTokens: z.ZodDefault<z.ZodNumber>;
|
|
121
|
-
}, "strip", z.ZodTypeAny, {
|
|
122
|
-
dataDir: string;
|
|
123
|
-
maxContextTokens: number;
|
|
124
|
-
}, {
|
|
125
|
-
dataDir?: string | undefined;
|
|
126
|
-
maxContextTokens?: number | undefined;
|
|
127
|
-
}>>;
|
|
128
|
-
security: z.ZodDefault<z.ZodObject<{
|
|
129
|
-
permission: z.ZodDefault<z.ZodEnum<["owner", "guest"]>>;
|
|
130
|
-
confirmWrites: z.ZodDefault<z.ZodBoolean>;
|
|
131
|
-
}, "strip", z.ZodTypeAny, {
|
|
132
|
-
permission: "owner" | "guest";
|
|
133
|
-
confirmWrites: boolean;
|
|
134
|
-
}, {
|
|
135
|
-
permission?: "owner" | "guest" | undefined;
|
|
136
|
-
confirmWrites?: boolean | undefined;
|
|
137
|
-
}>>;
|
|
138
|
-
allowedPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
|
|
139
|
-
persona: z.ZodOptional<z.ZodString>;
|
|
140
|
-
/**
|
|
141
|
-
* Embedding 配置(可选,配置后启用向量语义召回)
|
|
142
|
-
*
|
|
143
|
-
* 复用 OpenAI 兼容协议的 /embeddings 端点。
|
|
144
|
-
* 不配置时降级为纯关键词召回(当前行为)。
|
|
145
|
-
*/
|
|
146
|
-
embedding: z.ZodOptional<z.ZodObject<{
|
|
147
|
-
model: z.ZodString;
|
|
148
|
-
baseUrl: z.ZodOptional<z.ZodString>;
|
|
149
|
-
apiKey: z.ZodOptional<z.ZodString>;
|
|
150
|
-
}, "strip", z.ZodTypeAny, {
|
|
151
|
-
model: string;
|
|
152
|
-
apiKey?: string | undefined;
|
|
153
|
-
baseUrl?: string | undefined;
|
|
154
|
-
}, {
|
|
155
|
-
model: string;
|
|
156
|
-
apiKey?: string | undefined;
|
|
157
|
-
baseUrl?: string | undefined;
|
|
158
|
-
}>>;
|
|
159
|
-
}, "strip", z.ZodTypeAny, {
|
|
160
|
-
llm: {
|
|
161
|
-
temperature: number;
|
|
162
|
-
model: string;
|
|
163
|
-
provider: string;
|
|
164
|
-
apiKey?: string | undefined;
|
|
165
|
-
active?: string | undefined;
|
|
166
|
-
baseUrl?: string | undefined;
|
|
167
|
-
providers?: Record<string, {
|
|
168
|
-
model: string;
|
|
169
|
-
provider: string;
|
|
170
|
-
apiKey?: string | undefined;
|
|
171
|
-
temperature?: number | undefined;
|
|
172
|
-
baseUrl?: string | undefined;
|
|
173
|
-
contextWindow?: number | undefined;
|
|
174
|
-
}> | undefined;
|
|
175
|
-
background?: {
|
|
176
|
-
temperature: number;
|
|
177
|
-
model: string;
|
|
178
|
-
provider: string;
|
|
179
|
-
apiKey?: string | undefined;
|
|
180
|
-
baseUrl?: string | undefined;
|
|
181
|
-
} | undefined;
|
|
182
|
-
};
|
|
183
|
-
security: {
|
|
184
|
-
permission: "owner" | "guest";
|
|
185
|
-
confirmWrites: boolean;
|
|
186
|
-
};
|
|
187
|
-
memory: {
|
|
188
|
-
dataDir: string;
|
|
189
|
-
maxContextTokens: number;
|
|
190
|
-
};
|
|
191
|
-
allowedPaths: string[];
|
|
192
|
-
persona?: string | undefined;
|
|
193
|
-
embedding?: {
|
|
194
|
-
model: string;
|
|
195
|
-
apiKey?: string | undefined;
|
|
196
|
-
baseUrl?: string | undefined;
|
|
197
|
-
} | undefined;
|
|
198
|
-
}, {
|
|
199
|
-
persona?: string | undefined;
|
|
200
|
-
llm?: {
|
|
201
|
-
apiKey?: string | undefined;
|
|
202
|
-
temperature?: number | undefined;
|
|
203
|
-
model?: string | undefined;
|
|
204
|
-
active?: string | undefined;
|
|
205
|
-
provider?: string | undefined;
|
|
206
|
-
baseUrl?: string | undefined;
|
|
207
|
-
providers?: Record<string, {
|
|
208
|
-
model: string;
|
|
209
|
-
provider: string;
|
|
210
|
-
apiKey?: string | undefined;
|
|
211
|
-
temperature?: number | undefined;
|
|
212
|
-
baseUrl?: string | undefined;
|
|
213
|
-
contextWindow?: number | undefined;
|
|
214
|
-
}> | undefined;
|
|
215
|
-
background?: {
|
|
216
|
-
model: string;
|
|
217
|
-
provider: string;
|
|
218
|
-
apiKey?: string | undefined;
|
|
219
|
-
temperature?: number | undefined;
|
|
220
|
-
baseUrl?: string | undefined;
|
|
221
|
-
} | undefined;
|
|
222
|
-
} | undefined;
|
|
223
|
-
security?: {
|
|
224
|
-
permission?: "owner" | "guest" | undefined;
|
|
225
|
-
confirmWrites?: boolean | undefined;
|
|
226
|
-
} | undefined;
|
|
227
|
-
memory?: {
|
|
228
|
-
dataDir?: string | undefined;
|
|
229
|
-
maxContextTokens?: number | undefined;
|
|
230
|
-
} | undefined;
|
|
231
|
-
allowedPaths?: string[] | undefined;
|
|
232
|
-
embedding?: {
|
|
233
|
-
model: string;
|
|
234
|
-
apiKey?: string | undefined;
|
|
235
|
-
baseUrl?: string | undefined;
|
|
236
|
-
} | undefined;
|
|
237
|
-
}>;
|
|
238
|
-
export type Config = z.infer<typeof ConfigSchema>;
|
|
1
|
+
import type { ProviderEntryConfig } from '../llm/types.js';
|
|
239
2
|
/**
|
|
240
|
-
*
|
|
3
|
+
* contextWindow 的**告警参考上界**:2M(当前主流旗舰模型窗口量级)。
|
|
241
4
|
*
|
|
242
|
-
*
|
|
243
|
-
*
|
|
5
|
+
* ⚠️ **这不是裁决上界**:内核**不做区间裁决** —— 超出此值仅 `logger.warn`(观测),
|
|
6
|
+
* 值仍**原样生效**。理由:「模型能吃多大」是只有 provider/API 知道的事实,内核替用户猜会造成
|
|
7
|
+
* 「UI 显示值 ≠ 真实生效值」的静默失真(坑:填 3M → 静默丢弃 → 兜底 120K,全程无提示);
|
|
8
|
+
* 预算口径定:用户配置的 contextWindow 是预算唯一来源。超模型能力时由 **API 报错**(真实层可见失败)。
|
|
9
|
+
* 若将来必须恢复拦截,**只允许显式报错,不得回到静默**。
|
|
244
10
|
*
|
|
245
|
-
*
|
|
11
|
+
* ⚠️ 与 `src/role-pack/strategyKeys.ts` 的 `MAX_CONTEXT_LIMIT`(角色包 contextLimit 声明上界)**同值对齐,改一处须同步另一处**;
|
|
12
|
+
* 两者语义不同(provider 声明的告警参考 vs 角色包声明上界),故按本仓对 `DEFAULT_MAX_CONTEXT_TOKENS` 的既有做法
|
|
13
|
+
* 「重复 + 双向注释对冲」处理,**不跨层 import**(config 层不依赖 role-pack)。
|
|
14
|
+
* 导出仅供跨模块护栏测试断言同值(constants.test.ts),非 API 承诺。
|
|
15
|
+
*/
|
|
16
|
+
export declare const MAX_CONTEXT_WINDOW = 2000000;
|
|
17
|
+
/**
|
|
18
|
+
* LLM 配置接口。providers + active 是唯一格式;内核仅内置 'mock'(无 API Key 的测试/降级),
|
|
19
|
+
* 其他厂商 provider 需宿主或用户显式配置 baseUrl + model。
|
|
20
|
+
*/
|
|
21
|
+
interface LlmConfig {
|
|
22
|
+
/** 多 Provider 映射表:key 为别名("deepseek"、"openai"),value 为配置 */
|
|
23
|
+
providers?: Record<string, ProviderEntryConfig>;
|
|
24
|
+
/** 激活的 Provider 别名,必须与 providers 某 key 一致;不配时取第一个 key */
|
|
25
|
+
active?: string;
|
|
26
|
+
}
|
|
27
|
+
/** 内存配置接口 */
|
|
28
|
+
interface MemoryConfig {
|
|
29
|
+
/** 数据存储目录 */
|
|
30
|
+
dataDir: string;
|
|
31
|
+
/** 最大上下文 token 数 */
|
|
32
|
+
maxContextTokens: number;
|
|
33
|
+
}
|
|
34
|
+
/** 安全配置接口 */
|
|
35
|
+
interface SecurityConfig {
|
|
36
|
+
/** 权限级别:owner(所有者)或 guest(访客) */
|
|
37
|
+
permission: 'owner' | 'guest';
|
|
38
|
+
/** 是否确认写入操作 */
|
|
39
|
+
confirmWrites: boolean;
|
|
40
|
+
}
|
|
41
|
+
/** 完整配置接口 */
|
|
42
|
+
export interface Config {
|
|
43
|
+
/** LLM 配置 */
|
|
44
|
+
llm: LlmConfig;
|
|
45
|
+
/** 内存配置 */
|
|
46
|
+
memory: MemoryConfig;
|
|
47
|
+
/** 安全配置 */
|
|
48
|
+
security: SecurityConfig;
|
|
49
|
+
/** 允许的路径白名单(绝对路径) */
|
|
50
|
+
allowedPaths: string[];
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* 解析并验证配置:将原始 JSON 转为完整 Config,验证类型并应用默认值
|
|
54
|
+
*
|
|
55
|
+
* @throws 当类型不匹配时抛出错误
|
|
56
|
+
*/
|
|
57
|
+
export declare function parseConfig(raw: unknown): Config;
|
|
58
|
+
/**
|
|
59
|
+
* 加载配置。
|
|
60
|
+
* 单一真理源:所有默认值由 DEFAULT_CONFIG 声明,不维护独立 schema。
|
|
61
|
+
* 查找顺序:显式 configPath → 项目级 .memora/config.json → 内置默认值(apply env 展开)。
|
|
62
|
+
* 默认值合并走 parseConfig(不 spread DEFAULT_CONFIG,避免覆盖 schema 默认)。
|
|
246
63
|
*/
|
|
247
64
|
export declare function loadConfig(configPath?: string): Promise<Config>;
|
|
248
65
|
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAiB1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,UAAY,CAAC;AAI5C;;;GAGG;AACH,UAAU,SAAS;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAChD,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,aAAa;AACb,UAAU,YAAY;IACpB,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,aAAa;AACb,UAAU,cAAc;IACtB,iCAAiC;IACjC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,eAAe;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,aAAa;AACb,MAAM,WAAW,MAAM;IACrB,aAAa;IACb,GAAG,EAAE,SAAS,CAAC;IACf,WAAW;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,qBAAqB;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAsBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAwChD;AAwKD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBrE"}
|