@renxqoo/renx-code 0.0.4 → 0.0.6

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.
Files changed (210) hide show
  1. package/README.md +82 -51
  2. package/bin/renx.cjs +16 -0
  3. package/package.json +2 -45
  4. package/src/agent/runtime/runtime.context-usage.test.ts +4 -5
  5. package/src/agent/runtime/runtime.error-handling.test.ts +4 -5
  6. package/src/agent/runtime/runtime.test.ts +7 -4
  7. package/src/agent/runtime/runtime.ts +3 -9
  8. package/src/agent/runtime/runtime.usage-forwarding.test.ts +4 -5
  9. package/src/agent/runtime/source-modules.test.ts +16 -35
  10. package/src/agent/runtime/source-modules.ts +17 -0
  11. package/vendor/agent-root/src/agent/ENTERPRISE_ACCEPTANCE_CHECKLIST.md +95 -0
  12. package/vendor/agent-root/src/agent/ENTERPRISE_REALTIME.html +1345 -0
  13. package/vendor/agent-root/src/agent/ENTERPRISE_REALTIME.md +1353 -0
  14. package/vendor/agent-root/src/agent/ERROR_CONTRACT.md +60 -0
  15. package/vendor/agent-root/src/agent/TEST_COVERAGE_ANALYSIS.md +278 -0
  16. package/vendor/agent-root/src/agent/__test__/error-contract.test.ts +72 -0
  17. package/vendor/agent-root/src/agent/__test__/types.test.ts +137 -0
  18. package/vendor/agent-root/src/agent/agent/__test__/abort-runtime.test.ts +83 -0
  19. package/vendor/agent-root/src/agent/agent/__test__/callback-safety.test.ts +34 -0
  20. package/vendor/agent-root/src/agent/agent/__test__/compaction.test.ts +323 -0
  21. package/vendor/agent-root/src/agent/agent/__test__/concurrency.test.ts +290 -0
  22. package/vendor/agent-root/src/agent/agent/__test__/error-normalizer.test.ts +377 -0
  23. package/vendor/agent-root/src/agent/agent/__test__/error.test.ts +212 -0
  24. package/vendor/agent-root/src/agent/agent/__test__/fault-injection.test.ts +295 -0
  25. package/vendor/agent-root/src/agent/agent/__test__/index.test.ts +3607 -0
  26. package/vendor/agent-root/src/agent/agent/__test__/logger.test.ts +35 -0
  27. package/vendor/agent-root/src/agent/agent/__test__/message-utils.test.ts +517 -0
  28. package/vendor/agent-root/src/agent/agent/__test__/telemetry.test.ts +97 -0
  29. package/vendor/agent-root/src/agent/agent/__test__/timeout-budget.test.ts +479 -0
  30. package/vendor/agent-root/src/agent/agent/__test__/tool-call-merge.test.ts +80 -0
  31. package/vendor/agent-root/src/agent/agent/__test__/tool-execution-ledger.test.ts +76 -0
  32. package/vendor/agent-root/src/agent/agent/__test__/write-buffer.test.ts +173 -0
  33. package/vendor/agent-root/src/agent/agent/__test__/write-file-session.test.ts +109 -0
  34. package/vendor/agent-root/src/agent/agent/abort-runtime.ts +71 -0
  35. package/vendor/agent-root/src/agent/agent/callback-safety.ts +33 -0
  36. package/vendor/agent-root/src/agent/agent/compaction.ts +291 -0
  37. package/vendor/agent-root/src/agent/agent/concurrency.ts +103 -0
  38. package/vendor/agent-root/src/agent/agent/error-normalizer.ts +190 -0
  39. package/vendor/agent-root/src/agent/agent/error.ts +198 -0
  40. package/vendor/agent-root/src/agent/agent/index.ts +1772 -0
  41. package/vendor/agent-root/src/agent/agent/logger.ts +65 -0
  42. package/vendor/agent-root/src/agent/agent/message-utils.ts +101 -0
  43. package/vendor/agent-root/src/agent/agent/stream-events.ts +61 -0
  44. package/vendor/agent-root/src/agent/agent/telemetry.ts +123 -0
  45. package/vendor/agent-root/src/agent/agent/timeout-budget.ts +227 -0
  46. package/vendor/agent-root/src/agent/agent/tool-call-merge.ts +111 -0
  47. package/vendor/agent-root/src/agent/agent/tool-execution-ledger.ts +164 -0
  48. package/vendor/agent-root/src/agent/agent/write-buffer.ts +188 -0
  49. package/vendor/agent-root/src/agent/agent/write-file-session.ts +238 -0
  50. package/vendor/agent-root/src/agent/app/__test__/agent-app-service.test.ts +1053 -0
  51. package/vendor/agent-root/src/agent/app/__test__/minimal-agent-application.test.ts +158 -0
  52. package/vendor/agent-root/src/agent/app/__test__/sqlite-agent-app-store.test.ts +437 -0
  53. package/vendor/agent-root/src/agent/app/agent-app-service.ts +748 -0
  54. package/vendor/agent-root/src/agent/app/contracts.ts +109 -0
  55. package/vendor/agent-root/src/agent/app/index.ts +5 -0
  56. package/vendor/agent-root/src/agent/app/minimal-agent-application.ts +151 -0
  57. package/vendor/agent-root/src/agent/app/ports.ts +72 -0
  58. package/vendor/agent-root/src/agent/app/sqlite-agent-app-store.ts +1182 -0
  59. package/vendor/agent-root/src/agent/app/sqlite-client.ts +177 -0
  60. package/vendor/agent-root/src/agent/docs/cli-app-layer/00-README.md +36 -0
  61. package/vendor/agent-root/src/agent/docs/cli-app-layer/01-scope-and-goals.md +33 -0
  62. package/vendor/agent-root/src/agent/docs/cli-app-layer/02-architecture-overview.md +40 -0
  63. package/vendor/agent-root/src/agent/docs/cli-app-layer/03-domain-model-and-contracts.md +91 -0
  64. package/vendor/agent-root/src/agent/docs/cli-app-layer/04-ports-and-interfaces.md +116 -0
  65. package/vendor/agent-root/src/agent/docs/cli-app-layer/05-run-orchestration-and-state-machine.md +52 -0
  66. package/vendor/agent-root/src/agent/docs/cli-app-layer/06-cli-commands-and-ux.md +53 -0
  67. package/vendor/agent-root/src/agent/docs/cli-app-layer/07-storage-design-local.md +52 -0
  68. package/vendor/agent-root/src/agent/docs/cli-app-layer/08-error-and-observability.md +40 -0
  69. package/vendor/agent-root/src/agent/docs/cli-app-layer/09-security-and-policy-boundary.md +19 -0
  70. package/vendor/agent-root/src/agent/docs/cli-app-layer/10-test-plan-and-acceptance.md +28 -0
  71. package/vendor/agent-root/src/agent/docs/cli-app-layer/11-implementation-phases.md +26 -0
  72. package/vendor/agent-root/src/agent/docs/cli-app-layer/12-open-questions-and-risks.md +30 -0
  73. package/vendor/agent-root/src/agent/docs/cli-app-layer/13-sqlite-schema-fields-and-rationale.md +567 -0
  74. package/vendor/agent-root/src/agent/docs/cli-app-layer/14-project-flow-mermaid.md +583 -0
  75. package/vendor/agent-root/src/agent/docs/cli-app-layer/15-openclaw-style-project-blueprint.md +972 -0
  76. package/vendor/agent-root/src/agent/error-contract.ts +154 -0
  77. package/vendor/agent-root/src/agent/prompts/system.ts +246 -0
  78. package/vendor/agent-root/src/agent/prompts/system1.ts +208 -0
  79. package/vendor/agent-root/src/agent/storage/__test__/file-history-store.test.ts +98 -0
  80. package/vendor/agent-root/src/agent/storage/file-history-store.ts +313 -0
  81. package/vendor/agent-root/src/agent/storage/file-storage-config.ts +94 -0
  82. package/vendor/agent-root/src/agent/storage/file-system.ts +31 -0
  83. package/vendor/agent-root/src/agent/storage/file-write-service.ts +21 -0
  84. package/vendor/agent-root/src/agent/tool/__test__/base-tool.test.ts +413 -0
  85. package/vendor/agent-root/src/agent/tool/__test__/bash-policy.test.ts +356 -0
  86. package/vendor/agent-root/src/agent/tool/__test__/bash.mocked-coverage.test.ts +375 -0
  87. package/vendor/agent-root/src/agent/tool/__test__/bash.test.ts +372 -0
  88. package/vendor/agent-root/src/agent/tool/__test__/error.test.ts +108 -0
  89. package/vendor/agent-root/src/agent/tool/__test__/file-edit-tool.test.ts +258 -0
  90. package/vendor/agent-root/src/agent/tool/__test__/file-history-tools.test.ts +121 -0
  91. package/vendor/agent-root/src/agent/tool/__test__/file-read-tool.test.ts +210 -0
  92. package/vendor/agent-root/src/agent/tool/__test__/glob.test.ts +139 -0
  93. package/vendor/agent-root/src/agent/tool/__test__/grep.mocked-coverage.test.ts +456 -0
  94. package/vendor/agent-root/src/agent/tool/__test__/grep.test.ts +192 -0
  95. package/vendor/agent-root/src/agent/tool/__test__/lsp.test.ts +300 -0
  96. package/vendor/agent-root/src/agent/tool/__test__/outside-workspace-confirmation.test.ts +214 -0
  97. package/vendor/agent-root/src/agent/tool/__test__/path-security.test.ts +336 -0
  98. package/vendor/agent-root/src/agent/tool/__test__/skill-loader.test.ts +494 -0
  99. package/vendor/agent-root/src/agent/tool/__test__/skill-parser.test.ts +543 -0
  100. package/vendor/agent-root/src/agent/tool/__test__/skill-tool.test.ts +172 -0
  101. package/vendor/agent-root/src/agent/tool/__test__/task-concurrency-and-version.test.ts +116 -0
  102. package/vendor/agent-root/src/agent/tool/__test__/task-create-get-list-update.test.ts +267 -0
  103. package/vendor/agent-root/src/agent/tool/__test__/task-create.test.ts +519 -0
  104. package/vendor/agent-root/src/agent/tool/__test__/task-errors.test.ts +225 -0
  105. package/vendor/agent-root/src/agent/tool/__test__/task-output-blocking.test.ts +223 -0
  106. package/vendor/agent-root/src/agent/tool/__test__/task-output.test.ts +184 -0
  107. package/vendor/agent-root/src/agent/tool/__test__/task-parent-abort.test.ts +287 -0
  108. package/vendor/agent-root/src/agent/tool/__test__/task-real-runner-adapter.test.ts +190 -0
  109. package/vendor/agent-root/src/agent/tool/__test__/task-run-lifecycle.test.ts +352 -0
  110. package/vendor/agent-root/src/agent/tool/__test__/task-store-runner-branches.test.ts +395 -0
  111. package/vendor/agent-root/src/agent/tool/__test__/task-store.test.ts +391 -0
  112. package/vendor/agent-root/src/agent/tool/__test__/task-subagent-config-integration.test.ts +176 -0
  113. package/vendor/agent-root/src/agent/tool/__test__/task-subagent-config.test.ts +68 -0
  114. package/vendor/agent-root/src/agent/tool/__test__/task-tools-core-edges.test.ts +630 -0
  115. package/vendor/agent-root/src/agent/tool/__test__/task-tools-runtime-edges.test.ts +732 -0
  116. package/vendor/agent-root/src/agent/tool/__test__/task-types.test.ts +494 -0
  117. package/vendor/agent-root/src/agent/tool/__test__/task-utils-branches.test.ts +175 -0
  118. package/vendor/agent-root/src/agent/tool/__test__/tool-manager.test.ts +505 -0
  119. package/vendor/agent-root/src/agent/tool/__test__/types.test.ts +55 -0
  120. package/vendor/agent-root/src/agent/tool/__test__/web-fetch.test.ts +244 -0
  121. package/vendor/agent-root/src/agent/tool/__test__/web-search.test.ts +290 -0
  122. package/vendor/agent-root/src/agent/tool/__test__/write-file.test.ts +368 -0
  123. package/vendor/agent-root/src/agent/tool/base-tool.ts +345 -0
  124. package/vendor/agent-root/src/agent/tool/bash-policy.ts +636 -0
  125. package/vendor/agent-root/src/agent/tool/bash.ts +688 -0
  126. package/vendor/agent-root/src/agent/tool/error.ts +131 -0
  127. package/vendor/agent-root/src/agent/tool/file-edit-tool.ts +264 -0
  128. package/vendor/agent-root/src/agent/tool/file-history-list.ts +103 -0
  129. package/vendor/agent-root/src/agent/tool/file-history-restore.ts +149 -0
  130. package/vendor/agent-root/src/agent/tool/file-read-tool.ts +211 -0
  131. package/vendor/agent-root/src/agent/tool/glob.ts +171 -0
  132. package/vendor/agent-root/src/agent/tool/grep.ts +496 -0
  133. package/vendor/agent-root/src/agent/tool/lsp.ts +481 -0
  134. package/vendor/agent-root/src/agent/tool/path-security.ts +117 -0
  135. package/vendor/agent-root/src/agent/tool/search/common.ts +153 -0
  136. package/vendor/agent-root/src/agent/tool/skill/index.ts +13 -0
  137. package/vendor/agent-root/src/agent/tool/skill/loader.ts +229 -0
  138. package/vendor/agent-root/src/agent/tool/skill/parser.ts +124 -0
  139. package/vendor/agent-root/src/agent/tool/skill/types.ts +27 -0
  140. package/vendor/agent-root/src/agent/tool/skill-tool.ts +143 -0
  141. package/vendor/agent-root/src/agent/tool/task-create.ts +186 -0
  142. package/vendor/agent-root/src/agent/tool/task-errors.ts +42 -0
  143. package/vendor/agent-root/src/agent/tool/task-get.ts +116 -0
  144. package/vendor/agent-root/src/agent/tool/task-graph.ts +78 -0
  145. package/vendor/agent-root/src/agent/tool/task-list.ts +141 -0
  146. package/vendor/agent-root/src/agent/tool/task-mock-runner-adapter.ts +232 -0
  147. package/vendor/agent-root/src/agent/tool/task-output.ts +223 -0
  148. package/vendor/agent-root/src/agent/tool/task-parent-abort.ts +115 -0
  149. package/vendor/agent-root/src/agent/tool/task-real-runner-adapter.ts +336 -0
  150. package/vendor/agent-root/src/agent/tool/task-runner-adapter.ts +55 -0
  151. package/vendor/agent-root/src/agent/tool/task-stop.ts +187 -0
  152. package/vendor/agent-root/src/agent/tool/task-store.ts +217 -0
  153. package/vendor/agent-root/src/agent/tool/task-subagent-config.ts +149 -0
  154. package/vendor/agent-root/src/agent/tool/task-types.ts +264 -0
  155. package/vendor/agent-root/src/agent/tool/task-update.ts +315 -0
  156. package/vendor/agent-root/src/agent/tool/task.ts +209 -0
  157. package/vendor/agent-root/src/agent/tool/tool-manager.ts +362 -0
  158. package/vendor/agent-root/src/agent/tool/tool-prompts.ts +242 -0
  159. package/vendor/agent-root/src/agent/tool/types.ts +116 -0
  160. package/vendor/agent-root/src/agent/tool/web-fetch.ts +227 -0
  161. package/vendor/agent-root/src/agent/tool/web-search.ts +208 -0
  162. package/vendor/agent-root/src/agent/tool/write-file.ts +497 -0
  163. package/vendor/agent-root/src/agent/types.ts +232 -0
  164. package/vendor/agent-root/src/agent/utils/__tests__/index.test.ts +18 -0
  165. package/vendor/agent-root/src/agent/utils/__tests__/message-utils.test.ts +610 -0
  166. package/vendor/agent-root/src/agent/utils/__tests__/message.test.ts +223 -0
  167. package/vendor/agent-root/src/agent/utils/__tests__/token.test.ts +42 -0
  168. package/vendor/agent-root/src/agent/utils/index.ts +16 -0
  169. package/vendor/agent-root/src/agent/utils/message.ts +171 -0
  170. package/vendor/agent-root/src/agent/utils/token.ts +28 -0
  171. package/vendor/agent-root/src/config/__tests__/load-config-to-env.test.ts +129 -0
  172. package/vendor/agent-root/src/config/__tests__/loader.test.ts +247 -0
  173. package/vendor/agent-root/src/config/__tests__/runtime.test.ts +88 -0
  174. package/vendor/agent-root/src/config/index.ts +54 -0
  175. package/vendor/agent-root/src/config/loader.ts +431 -0
  176. package/vendor/agent-root/src/config/paths.ts +30 -0
  177. package/vendor/agent-root/src/config/runtime.ts +163 -0
  178. package/vendor/agent-root/src/config/types.ts +70 -0
  179. package/vendor/agent-root/src/logger/index.ts +57 -0
  180. package/vendor/agent-root/src/logger/logger.ts +819 -0
  181. package/vendor/agent-root/src/logger/types.ts +150 -0
  182. package/vendor/agent-root/src/providers/__tests__/errors.test.ts +441 -0
  183. package/vendor/agent-root/src/providers/__tests__/index.test.ts +16 -0
  184. package/vendor/agent-root/src/providers/__tests__/openai-compatible.options.test.ts +318 -0
  185. package/vendor/agent-root/src/providers/__tests__/openai-compatible.test.ts +600 -0
  186. package/vendor/agent-root/src/providers/__tests__/registry.test.ts +449 -0
  187. package/vendor/agent-root/src/providers/__tests__/responses-adapter.test.ts +298 -0
  188. package/vendor/agent-root/src/providers/adapters/__tests__/anthropic.test.ts +354 -0
  189. package/vendor/agent-root/src/providers/adapters/__tests__/kimi.test.ts +58 -0
  190. package/vendor/agent-root/src/providers/adapters/__tests__/standard.test.ts +261 -0
  191. package/vendor/agent-root/src/providers/adapters/anthropic.ts +572 -0
  192. package/vendor/agent-root/src/providers/adapters/base.ts +131 -0
  193. package/vendor/agent-root/src/providers/adapters/kimi.ts +48 -0
  194. package/vendor/agent-root/src/providers/adapters/responses.ts +732 -0
  195. package/vendor/agent-root/src/providers/adapters/standard.ts +120 -0
  196. package/vendor/agent-root/src/providers/http/__tests__/client.timeout.test.ts +313 -0
  197. package/vendor/agent-root/src/providers/http/client.ts +289 -0
  198. package/vendor/agent-root/src/providers/http/stream-parser.ts +109 -0
  199. package/vendor/agent-root/src/providers/index.ts +76 -0
  200. package/vendor/agent-root/src/providers/kimi-headers.ts +177 -0
  201. package/vendor/agent-root/src/providers/openai-compatible.ts +387 -0
  202. package/vendor/agent-root/src/providers/registry/model-config.ts +230 -0
  203. package/vendor/agent-root/src/providers/registry/provider-factory.ts +123 -0
  204. package/vendor/agent-root/src/providers/registry.ts +135 -0
  205. package/vendor/agent-root/src/providers/types/api.ts +284 -0
  206. package/vendor/agent-root/src/providers/types/config.ts +58 -0
  207. package/vendor/agent-root/src/providers/types/errors.ts +323 -0
  208. package/vendor/agent-root/src/providers/types/index.ts +72 -0
  209. package/vendor/agent-root/src/providers/types/provider.ts +45 -0
  210. package/vendor/agent-root/src/providers/types/registry.ts +88 -0
@@ -0,0 +1,247 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import * as fs from 'node:fs';
3
+ import * as os from 'node:os';
4
+ import * as path from 'node:path';
5
+ import {
6
+ ensureConfigDirs,
7
+ getGlobalConfigDir,
8
+ getGlobalConfigPath,
9
+ getProjectConfigDir,
10
+ getProjectConfigPath,
11
+ loadConfig,
12
+ writeGlobalConfig,
13
+ writeProjectConfig,
14
+ } from '../loader';
15
+ import { LogLevel } from '../../logger';
16
+
17
+ describe('Renx Config Loader', () => {
18
+ let tmpDir: string;
19
+ let globalDir: string;
20
+ let renxHome: string;
21
+ const originalRenxHome = process.env.RENX_HOME;
22
+
23
+ beforeEach(() => {
24
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'renx-config-test-'));
25
+ renxHome = path.join(tmpDir, 'renx-home');
26
+ globalDir = path.join(tmpDir, '.renx-global');
27
+ process.env.RENX_HOME = renxHome;
28
+ });
29
+
30
+ afterEach(() => {
31
+ if (originalRenxHome === undefined) {
32
+ delete process.env.RENX_HOME;
33
+ } else {
34
+ process.env.RENX_HOME = originalRenxHome;
35
+ }
36
+ fs.rmSync(tmpDir, { recursive: true, force: true });
37
+ });
38
+
39
+ describe('path helpers', () => {
40
+ it('should return global config dir', () => {
41
+ expect(getGlobalConfigDir()).toBe(renxHome);
42
+ });
43
+
44
+ it('should return project config dir', () => {
45
+ expect(getProjectConfigDir(path.join(path.sep, 'my', 'project'))).toBe(
46
+ path.join(path.sep, 'my', 'project', '.renx')
47
+ );
48
+ });
49
+
50
+ it('should return global config path', () => {
51
+ expect(getGlobalConfigPath()).toBe(path.join(renxHome, 'config.json'));
52
+ });
53
+
54
+ it('should return project config path', () => {
55
+ expect(getProjectConfigPath(path.join(path.sep, 'my', 'project'))).toBe(
56
+ path.join(path.sep, 'my', 'project', '.renx', 'config.json')
57
+ );
58
+ });
59
+ });
60
+
61
+ describe('loadConfig with defaults', () => {
62
+ it('should initialize and load default global config when no files exist', () => {
63
+ const config = loadConfig({
64
+ projectRoot: tmpDir,
65
+ globalDir,
66
+ loadEnv: false,
67
+ env: { RENX_HOME: renxHome },
68
+ });
69
+
70
+ expect(config.log.level).toBe(LogLevel.INFO);
71
+ expect(config.log.format).toBe('pretty');
72
+ expect(config.log.console).toBe(false);
73
+ expect(config.log.file).toBe(true);
74
+ expect(config.agent.maxSteps).toBe(10000);
75
+ expect(config.agent.confirmationMode).toBe('manual');
76
+ expect(config.agent.defaultModel).toBe('qwen3.5-plus');
77
+ expect(config.storage.fileHistory.enabled).toBe(true);
78
+ expect(config.sources.global).toBe(path.join(globalDir, 'config.json'));
79
+ expect(config.sources.project).toBeNull();
80
+ expect(fs.existsSync(path.join(globalDir, 'config.json'))).toBe(true);
81
+ });
82
+ });
83
+
84
+ describe('loadConfig with global config', () => {
85
+ it('should merge global config over defaults', () => {
86
+ fs.mkdirSync(globalDir, { recursive: true });
87
+ fs.writeFileSync(
88
+ path.join(globalDir, 'config.json'),
89
+ JSON.stringify({
90
+ log: { level: 'DEBUG', format: 'json' },
91
+ agent: { defaultModel: 'gpt-5.3' },
92
+ })
93
+ );
94
+
95
+ const config = loadConfig({
96
+ projectRoot: tmpDir,
97
+ globalDir,
98
+ loadEnv: false,
99
+ env: { RENX_HOME: renxHome },
100
+ });
101
+
102
+ expect(config.log.level).toBe(LogLevel.DEBUG);
103
+ expect(config.log.format).toBe('json');
104
+ expect(config.agent.defaultModel).toBe('gpt-5.3');
105
+ expect(config.log.console).toBe(false);
106
+ expect(config.agent.maxSteps).toBe(10000);
107
+ expect(config.sources.global).toBe(path.join(globalDir, 'config.json'));
108
+ expect(config.sources.project).toBeNull();
109
+ });
110
+ });
111
+
112
+ describe('loadConfig with project config', () => {
113
+ it('should merge project config over global config', () => {
114
+ fs.mkdirSync(globalDir, { recursive: true });
115
+ fs.writeFileSync(
116
+ path.join(globalDir, 'config.json'),
117
+ JSON.stringify({
118
+ log: { level: 'DEBUG', format: 'json' },
119
+ agent: { defaultModel: 'gpt-5.3', maxSteps: 100 },
120
+ })
121
+ );
122
+
123
+ const projectConfigDir = path.join(tmpDir, '.renx');
124
+ fs.mkdirSync(projectConfigDir, { recursive: true });
125
+ fs.writeFileSync(
126
+ path.join(projectConfigDir, 'config.json'),
127
+ JSON.stringify({
128
+ log: { level: 'ERROR' },
129
+ agent: { defaultModel: 'openrouter/hunter-alpha' },
130
+ })
131
+ );
132
+
133
+ const config = loadConfig({
134
+ projectRoot: tmpDir,
135
+ globalDir,
136
+ loadEnv: false,
137
+ env: { RENX_HOME: renxHome },
138
+ });
139
+
140
+ expect(config.log.level).toBe(LogLevel.ERROR);
141
+ expect(config.agent.defaultModel).toBe('openrouter/hunter-alpha');
142
+ expect(config.log.format).toBe('json');
143
+ expect(config.agent.maxSteps).toBe(100);
144
+ expect(config.sources.global).toBe(path.join(globalDir, 'config.json'));
145
+ expect(config.sources.project).toBe(path.join(projectConfigDir, 'config.json'));
146
+ });
147
+ });
148
+
149
+ describe('loadConfig with env overrides', () => {
150
+ it('should apply env overrides over file configs', () => {
151
+ const projectConfigDir = path.join(tmpDir, '.renx');
152
+ fs.mkdirSync(projectConfigDir, { recursive: true });
153
+ fs.writeFileSync(
154
+ path.join(projectConfigDir, 'config.json'),
155
+ JSON.stringify({
156
+ log: { level: 'INFO' },
157
+ agent: { defaultModel: 'glm-5' },
158
+ })
159
+ );
160
+
161
+ const config = loadConfig({
162
+ projectRoot: tmpDir,
163
+ globalDir,
164
+ env: {
165
+ RENX_HOME: renxHome,
166
+ AGENT_LOG_LEVEL: 'FATAL',
167
+ AGENT_MODEL: 'qwen3.5-max',
168
+ AGENT_TOOL_CONFIRMATION_MODE: 'manual',
169
+ },
170
+ });
171
+
172
+ expect(config.log.level).toBe(LogLevel.FATAL);
173
+ expect(config.agent.defaultModel).toBe('qwen3.5-max');
174
+ expect(config.agent.confirmationMode).toBe('manual');
175
+ });
176
+
177
+ it('should use AGENT_* env vars directly', () => {
178
+ const config = loadConfig({
179
+ projectRoot: tmpDir,
180
+ globalDir,
181
+ env: {
182
+ RENX_HOME: renxHome,
183
+ AGENT_LOG_LEVEL: 'WARN',
184
+ AGENT_LOG_FORMAT: 'json',
185
+ AGENT_TOOL_CONFIRMATION_MODE: 'auto-deny',
186
+ },
187
+ });
188
+
189
+ expect(config.log.level).toBe(LogLevel.WARN);
190
+ expect(config.log.format).toBe('json');
191
+ expect(config.agent.confirmationMode).toBe('auto-deny');
192
+ });
193
+ });
194
+
195
+ describe('writeProjectConfig', () => {
196
+ it('should write project config file', () => {
197
+ const configPath = writeProjectConfig(
198
+ { log: { level: 'DEBUG' }, agent: { defaultModel: 'gpt-5.3' } },
199
+ tmpDir
200
+ );
201
+
202
+ expect(fs.existsSync(configPath)).toBe(true);
203
+ const content = JSON.parse(fs.readFileSync(configPath, 'utf8'));
204
+ expect(content.log.level).toBe('DEBUG');
205
+ expect(content.agent.defaultModel).toBe('gpt-5.3');
206
+ });
207
+ });
208
+
209
+ describe('writeGlobalConfig', () => {
210
+ it('should write global config file', () => {
211
+ const configPath = writeGlobalConfig({ log: { level: 'WARN' } });
212
+
213
+ expect(fs.existsSync(configPath)).toBe(true);
214
+ const content = JSON.parse(fs.readFileSync(configPath, 'utf8'));
215
+ expect(content.log.level).toBe('WARN');
216
+ });
217
+ });
218
+
219
+ describe('ensureConfigDirs', () => {
220
+ it('should create config directories', () => {
221
+ ensureConfigDirs(tmpDir);
222
+
223
+ expect(fs.existsSync(path.join(tmpDir, '.renx'))).toBe(true);
224
+ expect(fs.existsSync(renxHome)).toBe(true);
225
+ });
226
+ });
227
+
228
+ describe('resolved paths', () => {
229
+ it('should resolve runtime paths under RENX_HOME', () => {
230
+ const config = loadConfig({
231
+ projectRoot: tmpDir,
232
+ globalDir,
233
+ loadEnv: false,
234
+ env: { RENX_HOME: renxHome },
235
+ });
236
+
237
+ expect(path.isAbsolute(config.log.dir)).toBe(true);
238
+ expect(path.isAbsolute(config.log.filePath)).toBe(true);
239
+ expect(path.isAbsolute(config.storage.root)).toBe(true);
240
+ expect(path.isAbsolute(config.db.path)).toBe(true);
241
+ expect(config.log.dir).toBe(path.join(renxHome, 'logs'));
242
+ expect(config.storage.root).toBe(path.join(renxHome, 'storage'));
243
+ expect(config.db.path).toBe(path.join(renxHome, 'data.db'));
244
+ expect(config.log.filePath.startsWith(path.join(renxHome, 'logs'))).toBe(true);
245
+ });
246
+ });
247
+ });
@@ -0,0 +1,88 @@
1
+ import { describe, it, expect, afterEach } from 'vitest';
2
+ import * as fs from 'node:fs/promises';
3
+ import * as os from 'node:os';
4
+ import * as path from 'node:path';
5
+ import { createLoggerFromEnv, loadEnvFiles, loadRuntimeConfigFromEnv } from '../runtime';
6
+
7
+ describe('runtime config from env', () => {
8
+ const loggers: Array<ReturnType<typeof createLoggerFromEnv>> = [];
9
+ const tempDirs: string[] = [];
10
+
11
+ afterEach(async () => {
12
+ for (const logger of loggers.splice(0, loggers.length)) {
13
+ logger.close();
14
+ }
15
+
16
+ for (const dir of tempDirs.splice(0, tempDirs.length)) {
17
+ await fs.rm(dir, { recursive: true, force: true });
18
+ }
19
+
20
+ delete process.env.AGENT_LOG_LEVEL;
21
+ delete process.env.RENX_HOME;
22
+ });
23
+
24
+ it('should load default runtime logging config', () => {
25
+ const config = loadRuntimeConfigFromEnv({});
26
+
27
+ expect(config.log.consoleEnabled).toBe(false);
28
+ expect(config.log.fileEnabled).toBe(true);
29
+ expect(config.log.format).toBe('pretty');
30
+ expect(config.log.filePath.endsWith('.log')).toBe(true);
31
+ });
32
+
33
+ it('should derive logging paths from RENX_HOME', async () => {
34
+ const renxHome = await fs.mkdtemp(path.join(os.tmpdir(), 'renx-home-'));
35
+ tempDirs.push(renxHome);
36
+ const config = loadRuntimeConfigFromEnv({
37
+ RENX_HOME: renxHome,
38
+ AGENT_LOG_LEVEL: 'debug',
39
+ AGENT_LOG_CONSOLE: '0',
40
+ AGENT_LOG_FILE_ENABLED: '1',
41
+ AGENT_LOG_FORMAT: 'json',
42
+ });
43
+
44
+ expect(config.log.level).toBe(10);
45
+ expect(config.log.consoleEnabled).toBe(false);
46
+ expect(config.log.fileEnabled).toBe(true);
47
+ expect(config.log.filePath.startsWith(path.join(renxHome, 'logs'))).toBe(true);
48
+ expect(config.log.format).toBe('json');
49
+ });
50
+
51
+ it('should throw on invalid log level', () => {
52
+ expect(() => loadRuntimeConfigFromEnv({ AGENT_LOG_LEVEL: 'verbose' })).toThrow(
53
+ 'Invalid AGENT_LOG_LEVEL'
54
+ );
55
+ });
56
+
57
+ it('should throw on invalid log format', () => {
58
+ expect(() => loadRuntimeConfigFromEnv({ AGENT_LOG_FORMAT: 'xml' })).toThrow(
59
+ 'Invalid AGENT_LOG_FORMAT'
60
+ );
61
+ });
62
+
63
+ it('should load env files', async () => {
64
+ const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'config-test-'));
65
+ tempDirs.push(tmpDir);
66
+
67
+ await fs.writeFile(
68
+ path.join(tmpDir, '.env'),
69
+ 'AGENT_LOG_LEVEL=debug\nRENX_HOME=./custom-home\n'
70
+ );
71
+
72
+ const loaded = await loadEnvFiles(tmpDir, { files: ['.env'], override: true });
73
+ expect(loaded).toHaveLength(1);
74
+ expect(process.env.AGENT_LOG_LEVEL).toBe('debug');
75
+ expect(process.env.RENX_HOME).toBe('./custom-home');
76
+ });
77
+
78
+ it('should create logger from env', () => {
79
+ const logger = createLoggerFromEnv({
80
+ AGENT_LOG_LEVEL: 'info',
81
+ AGENT_LOG_CONSOLE: 'true',
82
+ });
83
+ loggers.push(logger);
84
+ expect(logger).toBeDefined();
85
+ expect(typeof logger.info).toBe('function');
86
+ expect(typeof logger.error).toBe('function');
87
+ });
88
+ });
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Renx config module.
3
+ *
4
+ * Sources:
5
+ * - global config: ~/.renx/config.json (or RENX_HOME/config.json)
6
+ * - project config: <project>/.renx/config.json
7
+ * - environment variables
8
+ *
9
+ * Effective precedence:
10
+ * env > project config > global config > defaults
11
+ */
12
+
13
+ // Type exports
14
+ export type {
15
+ RenxConfig,
16
+ ResolvedConfig,
17
+ LoadConfigOptions,
18
+ LogConfig,
19
+ StorageConfig,
20
+ FileHistoryConfig,
21
+ AgentConfig,
22
+ } from './types';
23
+
24
+ // Config loaders
25
+ export {
26
+ loadConfig,
27
+ loadConfigToEnv,
28
+ getGlobalConfigDir,
29
+ getProjectConfigDir,
30
+ getGlobalConfigPath,
31
+ getProjectConfigPath,
32
+ ensureConfigDirs,
33
+ writeProjectConfig,
34
+ writeGlobalConfig,
35
+ } from './loader';
36
+
37
+ // Runtime env helpers
38
+ export type { LogFormat, RuntimeLogConfig, RuntimeConfig, LoadEnvFilesOptions } from './runtime';
39
+
40
+ export {
41
+ loadEnvFiles,
42
+ loadRuntimeConfigFromEnv,
43
+ createLoggerFromRuntimeConfig,
44
+ createLoggerFromEnv,
45
+ } from './runtime';
46
+
47
+ export {
48
+ RENX_HOME_ENV,
49
+ resolveRenxHome,
50
+ resolveRenxLogsDir,
51
+ resolveRenxStorageRoot,
52
+ resolveRenxTaskDir,
53
+ resolveRenxDatabasePath,
54
+ } from './paths';