chatccc 0.2.252 → 0.2.253

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 (280) hide show
  1. package/README.md +1 -1
  2. package/bin/cccagent.mjs +12 -3
  3. package/bin/chatccc.mjs +15 -6
  4. package/deepccc-agent/os-prompts/darwin.md +8 -8
  5. package/deepccc-agent/os-prompts/linux.md +8 -8
  6. package/deepccc-agent/os-prompts/win32.md +11 -11
  7. package/deepccc-agent/package.json +65 -65
  8. package/dist/deepccc-agent/src/cli.js +634 -0
  9. package/dist/deepccc-agent/src/config.js +76 -0
  10. package/dist/deepccc-agent/src/context.js +348 -0
  11. package/dist/deepccc-agent/src/file-log.js +34 -0
  12. package/dist/deepccc-agent/src/file-tools.js +1208 -0
  13. package/dist/deepccc-agent/src/index.js +571 -0
  14. package/dist/deepccc-agent/src/permissions.js +170 -0
  15. package/dist/deepccc-agent/src/privacy.js +124 -0
  16. package/dist/deepccc-agent/src/proc-tree-kill.js +60 -0
  17. package/dist/deepccc-agent/src/progress/cards-helpers.js +70 -0
  18. package/dist/deepccc-agent/src/progress/reducer.js +102 -0
  19. package/dist/deepccc-agent/src/progress/terminal-renderer.js +264 -0
  20. package/dist/deepccc-agent/src/progress/view.js +30 -0
  21. package/dist/deepccc-agent/src/raw-stream-log.js +106 -0
  22. package/dist/deepccc-agent/src/session-search.js +276 -0
  23. package/dist/deepccc-agent/src/session-select.js +23 -0
  24. package/dist/deepccc-agent/src/sigint.js +26 -0
  25. package/dist/deepccc-agent/src/skills.js +178 -0
  26. package/dist/deepccc-agent/src/web-tools.js +246 -0
  27. package/dist/src/adapters/adapter-interface.js +19 -0
  28. package/dist/src/adapters/ccc-adapter.js +112 -0
  29. package/dist/src/adapters/claude-adapter.js +497 -0
  30. package/dist/src/adapters/claude-session-meta-store.js +92 -0
  31. package/dist/src/adapters/codex-adapter.js +279 -0
  32. package/dist/src/adapters/codex-session-meta-store.js +94 -0
  33. package/dist/src/adapters/cursor-adapter.js +491 -0
  34. package/dist/src/adapters/cursor-session-meta-store.js +116 -0
  35. package/dist/src/adapters/jsonl-stream.js +104 -0
  36. package/{src/adapters/proc-tree-kill.ts → dist/src/adapters/proc-tree-kill.js} +94 -97
  37. package/dist/src/adapters/raw-stream-log.js +106 -0
  38. package/dist/src/adapters/resource-monitor.js +113 -0
  39. package/dist/src/agent-activity.js +133 -0
  40. package/dist/src/agent-delegate-task-rpc.js +129 -0
  41. package/dist/src/agent-delegate-task.js +48 -0
  42. package/dist/src/agent-file-rpc.js +152 -0
  43. package/dist/src/agent-image-rpc.js +148 -0
  44. package/dist/src/agent-platform-routing.js +13 -0
  45. package/dist/src/agent-reload-config-rpc.js +23 -0
  46. package/dist/src/agent-rpc-body.js +87 -0
  47. package/dist/src/agent-stop-stuck.js +110 -0
  48. package/dist/src/card-action-routing.js +7 -0
  49. package/dist/src/card-plain-text.js +101 -0
  50. package/dist/src/cardkit.js +158 -0
  51. package/dist/src/cards.js +573 -0
  52. package/dist/src/chatgpt-subscription-rpc.js +18 -0
  53. package/dist/src/chatgpt-subscription.js +199 -0
  54. package/dist/src/chrome-devtools-guard.js +238 -0
  55. package/dist/src/claude-sdk-installer.js +249 -0
  56. package/dist/src/codex-reset-actions.js +143 -0
  57. package/dist/src/config-utils.js +149 -0
  58. package/dist/src/config.js +804 -0
  59. package/dist/src/cursor-usage.js +77 -0
  60. package/dist/src/exit-banner.js +28 -0
  61. package/dist/src/feishu-api.js +1404 -0
  62. package/dist/src/feishu-message-ingress.js +137 -0
  63. package/dist/src/feishu-platform.js +97 -0
  64. package/dist/src/format-message.js +252 -0
  65. package/dist/src/git-command.js +155 -0
  66. package/dist/src/im-skills.js +121 -0
  67. package/dist/src/index.js +833 -0
  68. package/dist/src/litellm-proxy.js +300 -0
  69. package/dist/src/orchestrator.js +2078 -0
  70. package/dist/src/package-root.js +26 -0
  71. package/dist/src/platform-adapter.js +7 -0
  72. package/dist/src/platform-startup.js +6 -0
  73. package/dist/src/privacy.js +100 -0
  74. package/dist/src/progress/reducer.js +102 -0
  75. package/dist/src/progress/terminal-renderer.js +264 -0
  76. package/dist/src/progress/view.js +30 -0
  77. package/dist/src/response-stall.js +14 -0
  78. package/dist/src/runtime-entry.js +13 -0
  79. package/dist/src/runtime-reload.js +19 -0
  80. package/dist/src/session-chat-binding.js +183 -0
  81. package/dist/src/session-name.js +7 -0
  82. package/dist/src/session.js +2144 -0
  83. package/dist/src/shared-prefix.js +16 -0
  84. package/dist/src/shared.js +493 -0
  85. package/dist/src/sim-agent.js +105 -0
  86. package/dist/src/sim-platform.js +142 -0
  87. package/dist/src/sim-store.js +231 -0
  88. package/dist/src/simplify.js +99 -0
  89. package/dist/src/startup-lifecycle.js +209 -0
  90. package/dist/src/stream-state.js +141 -0
  91. package/dist/src/terminal-error.js +100 -0
  92. package/dist/src/trace.js +50 -0
  93. package/dist/src/turn-cards.js +92 -0
  94. package/dist/src/update-command-guard.js +114 -0
  95. package/{src/web-ui.ts → dist/src/web-ui.js} +749 -823
  96. package/dist/src/wechat-platform.js +545 -0
  97. package/package.json +76 -74
  98. package/deepccc-agent/LICENSE +0 -201
  99. package/deepccc-agent/bin/deepccc.mjs +0 -26
  100. package/deepccc-agent/docs/cache-hit-rate-1.jpg +0 -0
  101. package/deepccc-agent/docs/cache-hit-rate-2.jpg +0 -0
  102. package/deepccc-agent/package-lock.json +0 -2027
  103. package/deepccc-agent/src/__tests__/chat-session.test.ts +0 -877
  104. package/deepccc-agent/src/__tests__/cli-json.test.ts +0 -49
  105. package/deepccc-agent/src/__tests__/config.test.ts +0 -34
  106. package/deepccc-agent/src/__tests__/context.test.ts +0 -341
  107. package/deepccc-agent/src/__tests__/file-tools.test.ts +0 -240
  108. package/deepccc-agent/src/__tests__/permissions.test.ts +0 -199
  109. package/deepccc-agent/src/__tests__/privacy.test.ts +0 -318
  110. package/deepccc-agent/src/__tests__/progress-reducer.test.ts +0 -121
  111. package/deepccc-agent/src/__tests__/session-search.test.ts +0 -262
  112. package/deepccc-agent/src/__tests__/session-select.test.ts +0 -116
  113. package/deepccc-agent/src/__tests__/sigint.test.ts +0 -56
  114. package/deepccc-agent/src/__tests__/skills.test.ts +0 -284
  115. package/deepccc-agent/src/__tests__/terminal-renderer.test.ts +0 -247
  116. package/deepccc-agent/src/__tests__/web-tools.test.ts +0 -220
  117. package/deepccc-agent/src/cli.ts +0 -682
  118. package/deepccc-agent/src/config.ts +0 -101
  119. package/deepccc-agent/src/context.ts +0 -465
  120. package/deepccc-agent/src/file-log.ts +0 -38
  121. package/deepccc-agent/src/file-tools.ts +0 -1493
  122. package/deepccc-agent/src/index.ts +0 -710
  123. package/deepccc-agent/src/permissions.ts +0 -226
  124. package/deepccc-agent/src/privacy.ts +0 -141
  125. package/deepccc-agent/src/proc-tree-kill.ts +0 -61
  126. package/deepccc-agent/src/progress/cards-helpers.ts +0 -76
  127. package/deepccc-agent/src/progress/reducer.ts +0 -113
  128. package/deepccc-agent/src/progress/terminal-renderer.ts +0 -294
  129. package/deepccc-agent/src/progress/view.ts +0 -77
  130. package/deepccc-agent/src/raw-stream-log.ts +0 -124
  131. package/deepccc-agent/src/session-search.ts +0 -370
  132. package/deepccc-agent/src/session-select.ts +0 -48
  133. package/deepccc-agent/src/sigint.ts +0 -50
  134. package/deepccc-agent/src/skills.ts +0 -205
  135. package/deepccc-agent/src/web-tools.ts +0 -313
  136. package/deepccc-agent/tsconfig.build.json +0 -13
  137. package/deepccc-agent/tsconfig.json +0 -13
  138. package/deepccc-agent/vitest.config.ts +0 -7
  139. package/src/__tests__/adapter-interface.test.ts +0 -152
  140. package/src/__tests__/agent-activity.test.ts +0 -86
  141. package/src/__tests__/agent-delegate-task-rpc.test.ts +0 -165
  142. package/src/__tests__/agent-image-rpc.test.ts +0 -34
  143. package/src/__tests__/agent-platform-routing.test.ts +0 -26
  144. package/src/__tests__/agent-reload-config-rpc.test.ts +0 -99
  145. package/src/__tests__/agent-rpc-body.test.ts +0 -42
  146. package/src/__tests__/builtin-chat-session.test.ts +0 -532
  147. package/src/__tests__/builtin-cli-json.test.ts +0 -39
  148. package/src/__tests__/builtin-config.test.ts +0 -26
  149. package/src/__tests__/builtin-context.test.ts +0 -319
  150. package/src/__tests__/builtin-file-tools.test.ts +0 -240
  151. package/src/__tests__/builtin-permissions.test.ts +0 -219
  152. package/src/__tests__/builtin-session-search.test.ts +0 -262
  153. package/src/__tests__/builtin-session-select.test.ts +0 -116
  154. package/src/__tests__/builtin-sigint.test.ts +0 -56
  155. package/src/__tests__/builtin-skills.test.ts +0 -284
  156. package/src/__tests__/builtin-web-tools.test.ts +0 -220
  157. package/src/__tests__/card-action-routing.test.ts +0 -18
  158. package/src/__tests__/card-plain-text.test.ts +0 -45
  159. package/src/__tests__/cardkit.test.ts +0 -60
  160. package/src/__tests__/cards.test.ts +0 -607
  161. package/src/__tests__/ccc-adapter.test.ts +0 -194
  162. package/src/__tests__/chatgpt-subscription-rpc.test.ts +0 -89
  163. package/src/__tests__/chatgpt-subscription.test.ts +0 -135
  164. package/src/__tests__/chrome-devtools-guard.test.ts +0 -165
  165. package/src/__tests__/claude-adapter.test.ts +0 -614
  166. package/src/__tests__/claude-raw-stream-log.test.ts +0 -96
  167. package/src/__tests__/claude-sdk-installer.test.ts +0 -285
  168. package/src/__tests__/codex-adapter.test.ts +0 -331
  169. package/src/__tests__/codex-raw-stream-log.test.ts +0 -170
  170. package/src/__tests__/codex-reset-actions.test.ts +0 -146
  171. package/src/__tests__/config-reload.test.ts +0 -284
  172. package/src/__tests__/config-sample.test.ts +0 -97
  173. package/src/__tests__/config-utils.test.ts +0 -40
  174. package/src/__tests__/config.test.ts +0 -395
  175. package/src/__tests__/crash-logging.test.ts +0 -360
  176. package/src/__tests__/cursor-adapter.test.ts +0 -890
  177. package/src/__tests__/cursor-session-meta-store.test.ts +0 -212
  178. package/src/__tests__/feishu-api.test.ts +0 -60
  179. package/src/__tests__/feishu-avatar.test.ts +0 -504
  180. package/src/__tests__/feishu-message-ingress.test.ts +0 -138
  181. package/src/__tests__/feishu-platform.test.ts +0 -75
  182. package/src/__tests__/fixtures/codex_simple_text.jsonl +0 -4
  183. package/src/__tests__/fixtures/codex_with_tool.jsonl +0 -6
  184. package/src/__tests__/fixtures/cursor_partial_only.jsonl +0 -5
  185. package/src/__tests__/fixtures/cursor_partial_with_final.jsonl +0 -13
  186. package/src/__tests__/fixtures/cursor_with_tool_call.jsonl +0 -12
  187. package/src/__tests__/format-message.test.ts +0 -316
  188. package/src/__tests__/git-command.test.ts +0 -288
  189. package/src/__tests__/im-skills.test.ts +0 -125
  190. package/src/__tests__/jsonl-stream.test.ts +0 -79
  191. package/src/__tests__/orchestrator.test.ts +0 -1268
  192. package/src/__tests__/package-files.test.ts +0 -24
  193. package/src/__tests__/platform-startup.test.ts +0 -19
  194. package/src/__tests__/privacy.test.ts +0 -198
  195. package/src/__tests__/proc-tree-kill.test.ts +0 -108
  196. package/src/__tests__/progress-reducer.test.ts +0 -121
  197. package/src/__tests__/raw-stream-log.test.ts +0 -106
  198. package/src/__tests__/response-stall.test.ts +0 -49
  199. package/src/__tests__/restart.test.ts +0 -232
  200. package/src/__tests__/session-ccc-config.test.ts +0 -66
  201. package/src/__tests__/session.test.ts +0 -3004
  202. package/src/__tests__/shared-prefix.test.ts +0 -36
  203. package/src/__tests__/sim-agent.test.ts +0 -174
  204. package/src/__tests__/sim-platform.test.ts +0 -93
  205. package/src/__tests__/sim-store.test.ts +0 -214
  206. package/src/__tests__/simplify.test.ts +0 -283
  207. package/src/__tests__/startup-lifecycle.test.ts +0 -231
  208. package/src/__tests__/stop-session.test.ts +0 -162
  209. package/src/__tests__/stream-state.test.ts +0 -164
  210. package/src/__tests__/terminal-error.test.ts +0 -54
  211. package/src/__tests__/terminal-renderer.test.ts +0 -247
  212. package/src/__tests__/update-command-guard.test.ts +0 -144
  213. package/src/__tests__/web-ui.test.ts +0 -438
  214. package/src/__tests__/wechat-platform.test.ts +0 -111
  215. package/src/adapters/adapter-interface.ts +0 -217
  216. package/src/adapters/ccc-adapter.ts +0 -150
  217. package/src/adapters/claude-adapter.ts +0 -673
  218. package/src/adapters/claude-session-meta-store.ts +0 -120
  219. package/src/adapters/codex-adapter.ts +0 -426
  220. package/src/adapters/codex-session-meta-store.ts +0 -131
  221. package/src/adapters/cursor-adapter.ts +0 -681
  222. package/src/adapters/cursor-session-meta-store.ts +0 -154
  223. package/src/adapters/jsonl-stream.ts +0 -157
  224. package/src/adapters/raw-stream-log.ts +0 -124
  225. package/src/adapters/resource-monitor.ts +0 -141
  226. package/src/agent-activity.ts +0 -175
  227. package/src/agent-delegate-task-rpc.ts +0 -153
  228. package/src/agent-delegate-task.ts +0 -91
  229. package/src/agent-file-rpc.ts +0 -172
  230. package/src/agent-image-rpc.ts +0 -168
  231. package/src/agent-platform-routing.ts +0 -28
  232. package/src/agent-reload-config-rpc.ts +0 -34
  233. package/src/agent-rpc-body.ts +0 -92
  234. package/src/agent-stop-stuck.ts +0 -129
  235. package/src/card-action-routing.ts +0 -14
  236. package/src/card-plain-text.ts +0 -108
  237. package/src/cardkit.ts +0 -179
  238. package/src/cards.ts +0 -684
  239. package/src/chatgpt-subscription-rpc.ts +0 -27
  240. package/src/chatgpt-subscription.ts +0 -299
  241. package/src/chrome-devtools-guard.ts +0 -318
  242. package/src/claude-sdk-installer.ts +0 -324
  243. package/src/codex-reset-actions.ts +0 -184
  244. package/src/config-utils.ts +0 -211
  245. package/src/config.ts +0 -1063
  246. package/src/cursor-usage.ts +0 -128
  247. package/src/exit-banner.ts +0 -33
  248. package/src/feishu-api.ts +0 -1616
  249. package/src/feishu-message-ingress.ts +0 -195
  250. package/src/feishu-platform.ts +0 -159
  251. package/src/format-message.ts +0 -293
  252. package/src/git-command.ts +0 -202
  253. package/src/im-skills.ts +0 -149
  254. package/src/index.ts +0 -1089
  255. package/src/litellm-proxy.ts +0 -374
  256. package/src/orchestrator.ts +0 -2543
  257. package/src/platform-adapter.ts +0 -70
  258. package/src/platform-startup.ts +0 -16
  259. package/src/privacy.ts +0 -118
  260. package/src/progress/reducer.ts +0 -113
  261. package/src/progress/terminal-renderer.ts +0 -294
  262. package/src/progress/view.ts +0 -77
  263. package/src/response-stall.ts +0 -28
  264. package/src/runtime-reload.ts +0 -34
  265. package/src/session-chat-binding.ts +0 -292
  266. package/src/session-name.ts +0 -8
  267. package/src/session.ts +0 -2659
  268. package/src/shared-prefix.ts +0 -29
  269. package/src/shared.ts +0 -552
  270. package/src/sim-agent.ts +0 -167
  271. package/src/sim-platform.ts +0 -177
  272. package/src/sim-store.ts +0 -317
  273. package/src/simplify.ts +0 -120
  274. package/src/startup-lifecycle.ts +0 -250
  275. package/src/stream-state.ts +0 -177
  276. package/src/terminal-error.ts +0 -129
  277. package/src/trace.ts +0 -51
  278. package/src/turn-cards.ts +0 -118
  279. package/src/update-command-guard.ts +0 -165
  280. package/src/wechat-platform.ts +0 -680
@@ -0,0 +1,143 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { buildCodexResetConfirmCard } from "./cards.js";
3
+ const pendingCodexResetRequests = new Map();
4
+ function rawEvent(data) {
5
+ return (data?.event ?? data);
6
+ }
7
+ function actionValue(raw) {
8
+ const action = raw.action;
9
+ const value = action?.value;
10
+ if (!value || typeof value !== "object")
11
+ return null;
12
+ return value;
13
+ }
14
+ function eventMessageId(raw) {
15
+ return typeof raw.open_message_id === "string"
16
+ ? raw.open_message_id
17
+ : typeof raw.context?.open_message_id === "string"
18
+ ? raw.context.open_message_id
19
+ : typeof raw.message_id === "string"
20
+ ? raw.message_id
21
+ : typeof raw.context?.message_id === "string"
22
+ ? raw.context.message_id
23
+ : typeof raw.message?.message_id === "string"
24
+ ? raw.message.message_id
25
+ : "";
26
+ }
27
+ function eventChatId(raw) {
28
+ return typeof raw.open_chat_id === "string"
29
+ ? raw.open_chat_id
30
+ : typeof raw.context?.open_chat_id === "string"
31
+ ? raw.context.open_chat_id
32
+ : typeof raw.message?.chat_id === "string"
33
+ ? raw.message.chat_id
34
+ : "";
35
+ }
36
+ function collapsedCard() {
37
+ return JSON.stringify({
38
+ config: { wide_screen_mode: true },
39
+ elements: [{ tag: "markdown", content: " " }],
40
+ });
41
+ }
42
+ function resetResultMessage(result) {
43
+ if (result.code === "reset") {
44
+ return {
45
+ content: `重置成功。已重置 ${result.windowsReset} 个 Codex 用量窗口。`,
46
+ template: "green",
47
+ };
48
+ }
49
+ if (result.code === "nothing_to_reset") {
50
+ return {
51
+ content: "没有需要重置的 Codex 用量窗口。",
52
+ template: "yellow",
53
+ };
54
+ }
55
+ if (result.code === "no_credit") {
56
+ return {
57
+ content: "没有可用的 Codex 主动重置次数。",
58
+ template: "red",
59
+ };
60
+ }
61
+ return {
62
+ content: "这次 Codex 主动重置请求已经处理过。",
63
+ template: "yellow",
64
+ };
65
+ }
66
+ async function sendResetRequestConfirmation(raw, value, deps) {
67
+ const parentMessageId = eventMessageId(raw);
68
+ const chatId = eventChatId(raw);
69
+ if (!parentMessageId || !chatId)
70
+ return true;
71
+ const availableCount = Number(value.availableCount);
72
+ const requestId = (deps.createRequestId ?? randomUUID)();
73
+ pendingCodexResetRequests.set(requestId, {
74
+ chatId,
75
+ parentMessageId,
76
+ status: "pending",
77
+ });
78
+ const token = await deps.getTenantAccessToken();
79
+ await deps.sendRawCard(token, chatId, buildCodexResetConfirmCard({
80
+ availableCount: Number.isFinite(availableCount) ? Math.max(1, Math.trunc(availableCount)) : 1,
81
+ parentMessageId,
82
+ requestId,
83
+ }));
84
+ return true;
85
+ }
86
+ async function handleResetConfirmation(raw, value, deps) {
87
+ const decision = value.decision;
88
+ const requestId = value.requestId;
89
+ const parentMessageId = value.parentMessageId;
90
+ if ((decision !== "yes" && decision !== "no") || typeof requestId !== "string" || typeof parentMessageId !== "string") {
91
+ return true;
92
+ }
93
+ const token = await deps.getTenantAccessToken();
94
+ const confirmMessageId = eventMessageId(raw);
95
+ if (confirmMessageId) {
96
+ const collapsed = await deps.updateCardMessage(token, confirmMessageId, collapsedCard());
97
+ console.log(`[Codex Reset] collapse confirmation card ${collapsed ? "OK" : "FAILED"}: messageId=${confirmMessageId}`);
98
+ const recalled = await deps.recallMessage(token, confirmMessageId);
99
+ console.log(`[Codex Reset] recall confirmation card ${recalled ? "OK" : "FAILED"}: messageId=${confirmMessageId}`);
100
+ }
101
+ else {
102
+ console.error("[Codex Reset] missing confirmation card message id; cannot collapse");
103
+ }
104
+ const pending = pendingCodexResetRequests.get(requestId);
105
+ const chatId = pending?.chatId ?? eventChatId(raw);
106
+ if (!chatId)
107
+ return true;
108
+ if (!pending || pending.status !== "pending" || pending.parentMessageId !== parentMessageId) {
109
+ await deps.sendTextReply(token, chatId, "Codex 主动重置:这张确认卡片已经失效或已处理。");
110
+ return true;
111
+ }
112
+ pending.status = "handled";
113
+ if (decision === "no") {
114
+ await deps.sendTextReply(token, chatId, "Codex 主动重置:用户取消了重置。");
115
+ return true;
116
+ }
117
+ try {
118
+ const result = await deps.consumeCodexRateLimitResetCredit(requestId);
119
+ const message = resetResultMessage(result);
120
+ await deps.sendTextReply(token, chatId, `Codex 主动重置:${message.content}`);
121
+ }
122
+ catch (err) {
123
+ await deps.sendTextReply(token, chatId, `Codex 主动重置失败:${err.message}`);
124
+ }
125
+ return true;
126
+ }
127
+ export async function handleCodexResetCardAction(data, deps) {
128
+ const raw = rawEvent(data);
129
+ const value = actionValue(raw);
130
+ if (!value)
131
+ return false;
132
+ const action = value?.action;
133
+ if (action === "codex_reset_request") {
134
+ return sendResetRequestConfirmation(raw, value, deps);
135
+ }
136
+ if (action === "codex_reset_confirm") {
137
+ return handleResetConfirmation(raw, value, deps);
138
+ }
139
+ return false;
140
+ }
141
+ export function _resetCodexResetRequestsForTest() {
142
+ pendingCodexResetRequests.clear();
143
+ }
@@ -0,0 +1,149 @@
1
+ // ---------------------------------------------------------------------------
2
+ // 纯函数/常量工具集
3
+ //
4
+ // 这些工具与 fs / 进程状态完全无关(CLI 路径探测函数虽然要查文件/PATH,但所有
5
+ // I/O 通过参数注入,函数本身仍然是纯函数,可被单测无副作用地调用)。
6
+ // 其它生产代码应优先从 `./config.ts` 引用(`config.ts` 会 re-export 这里的符号),
7
+ // 仅在需要避免触发 config.ts 副作用的场景(如单测)才直接 import 本文件。
8
+ // ---------------------------------------------------------------------------
9
+ import { join } from "node:path";
10
+ /**
11
+ * 把 model / effort 等"可选向 SDK/CLI 透传"的字段标准化为字符串。
12
+ *
13
+ * 项目内部统一约定:`""`(空字符串/全空白)表示**不向 SDK/CLI 传该字段**。
14
+ * 旧版本曾使用字面量 `"default"` 表达同样的意思,本函数兼容性地把它视作 `""`,
15
+ * 并在每次启动时打印一次 warning,提示用户更新 config.json。
16
+ *
17
+ * - `value` 不是字符串(例如 undefined / 缺失)→ 使用 `fallback`(默认 `""`)。
18
+ * - `value` 去除空白后等于 `"default"`(不区分大小写)→ 视作 `""` 并 warn。
19
+ * - 其余情况原样返回(不裁剪两端空白,留给具体调用方决定)。
20
+ */
21
+ export function normalizeOptionalConfigField(value, options) {
22
+ const fallback = options.fallback ?? "";
23
+ if (typeof value !== "string")
24
+ return fallback;
25
+ const trimmed = value.trim();
26
+ if (trimmed.toLowerCase() === "default") {
27
+ console.warn(`[CONFIG] ${options.label} 的值 "${trimmed}" 已废弃,请改为 ""(空字符串)表示不向 SDK/CLI 传该字段;本次启动按 "" 处理。`);
28
+ return "";
29
+ }
30
+ return value;
31
+ }
32
+ /**
33
+ * 归一化 `ccc.provider`(ChatCCC 主进程配置对 DeepCCC 内核传输层的 override):
34
+ * - 非字符串 / 空串 / 字面量 "default" → `""`(不 override,跟随
35
+ * ~/.deepccc/config.json 或 DEEPCCC_PROVIDER,向后兼容旧 config.json)
36
+ * - `openai` / `anthropic`(大小写不敏感)→ 规范化小写返回
37
+ * - 其它非法值 → `""` 并打印 warning(避免运行时 normalizeDeepCccProvider 抛错)
38
+ */
39
+ export function normalizeCccProviderOverride(value) {
40
+ if (typeof value !== "string")
41
+ return "";
42
+ const trimmed = value.trim().toLowerCase();
43
+ if (trimmed === "" || trimmed === "default")
44
+ return "";
45
+ if (trimmed === "openai" || trimmed === "anthropic")
46
+ return trimmed;
47
+ console.warn(`[CONFIG] ccc.provider 的值 "${value}" 非法,已忽略(仅支持 openai / anthropic / 空字符串)。`);
48
+ return "";
49
+ }
50
+ /**
51
+ * CCC Agent requires credentials owned by ChatCCC. An explicit enabled=true
52
+ * must not make the agent selectable when that credential is absent.
53
+ */
54
+ export function resolveCccEnabled(rawEnabled, apiKey) {
55
+ const hasApiKey = typeof apiKey === "string" && apiKey.trim().length > 0;
56
+ if (!hasApiKey)
57
+ return false;
58
+ return typeof rawEnabled === "boolean" ? rawEnabled : true;
59
+ }
60
+ // ---------------------------------------------------------------------------
61
+ // /git 超时配置相关
62
+ // ---------------------------------------------------------------------------
63
+ /** /git 命令默认超时秒数(用户未配置时使用) */
64
+ export const DEFAULT_GIT_TIMEOUT_SECONDS = 180;
65
+ /** /git 超时允许的下限/上限(防止 0、负数、过大值导致行为异常) */
66
+ export const MIN_GIT_TIMEOUT_SECONDS = 1;
67
+ export const MAX_GIT_TIMEOUT_SECONDS = 3600; // 1 小时
68
+ export function parseGitTimeoutSeconds(raw, defaultSeconds = DEFAULT_GIT_TIMEOUT_SECONDS) {
69
+ if (typeof raw === "number") {
70
+ if (!Number.isFinite(raw) ||
71
+ !Number.isInteger(raw) ||
72
+ raw < MIN_GIT_TIMEOUT_SECONDS ||
73
+ raw > MAX_GIT_TIMEOUT_SECONDS) {
74
+ return { seconds: defaultSeconds, valid: false, raw: String(raw), usingDefault: true };
75
+ }
76
+ return { seconds: raw, valid: true, raw: String(raw), usingDefault: false };
77
+ }
78
+ const trimmed = raw?.trim();
79
+ if (!trimmed) {
80
+ return { seconds: defaultSeconds, valid: true, usingDefault: true };
81
+ }
82
+ const n = Number(trimmed);
83
+ if (!Number.isFinite(n) ||
84
+ !Number.isInteger(n) ||
85
+ n < MIN_GIT_TIMEOUT_SECONDS ||
86
+ n > MAX_GIT_TIMEOUT_SECONDS) {
87
+ return { seconds: defaultSeconds, valid: false, raw: trimmed, usingDefault: true };
88
+ }
89
+ return { seconds: n, valid: true, raw: trimmed, usingDefault: false };
90
+ }
91
+ /**
92
+ * 判断 model / effort 等"可选向 SDK/CLI 透传"的字段是否为"不传值"。
93
+ * 项目内部统一以空字符串(含全空白)表示该语义。
94
+ */
95
+ export function isAnthropicConfigEmpty(value) {
96
+ return value.trim() === "";
97
+ }
98
+ /** 状态展示用:留空时显示 `(留空)`,否则原样返回。 */
99
+ export function anthropicConfigDisplay(value) {
100
+ return isAnthropicConfigEmpty(value) ? "(留空)" : value;
101
+ }
102
+ /**
103
+ * 探测 Cursor Agent CLI 的可执行文件绝对路径。
104
+ *
105
+ * 优先级(依次尝试,命中即返回):
106
+ * 1. Windows + `%LOCALAPPDATA%\cursor-agent\agent.cmd`(Cursor IDE 默认安装位置)
107
+ * 2. PATH 中查找 `cursor-agent`(独立 CLI 安装常见名)
108
+ * 3. PATH 中查找 `agent`(旧版默认名)
109
+ *
110
+ * 全部命中失败时返回 `null`,调用方可选择留空让运行时回退到 PATH 兜底。
111
+ */
112
+ export function autoDetectCursorPath(deps) {
113
+ if (deps.platform === "win32" && deps.localAppData) {
114
+ const localPath = join(deps.localAppData, "cursor-agent", "agent.cmd");
115
+ if (deps.existsSync(localPath))
116
+ return localPath;
117
+ }
118
+ return deps.whichSync("cursor-agent") ?? deps.whichSync("agent");
119
+ }
120
+ /**
121
+ * 探测 Codex CLI 的可执行文件绝对路径。
122
+ *
123
+ * Codex 没有固定安装位置,只通过 PATH 查找 `codex` 命令。
124
+ * 找不到时返回 `null`,由调用方决定留空或后续重试。
125
+ */
126
+ export function autoDetectCodexPath(deps) {
127
+ return deps.whichSync("codex");
128
+ }
129
+ // ---------------------------------------------------------------------------
130
+ // CLI 路径字段(cursor.path / codex.path)的兼容性读取
131
+ // ---------------------------------------------------------------------------
132
+ /**
133
+ * 从 raw config 对象中读取 cursor / codex 的 CLI 路径,兼容旧字段名 `command`。
134
+ *
135
+ * - 优先读 `path`,回退到旧字段 `command`(升级前的 config.json 仍然可用)
136
+ * - 回退命中时通过 `onLegacyField` 回调通知调用方(用于打印一次性 warning)
137
+ * - 不要在此函数里写文件,迁移交给上层
138
+ */
139
+ export function readToolCliPath(raw, options) {
140
+ if (!raw)
141
+ return "";
142
+ if (typeof raw.path === "string" && raw.path.trim() !== "")
143
+ return raw.path;
144
+ if (typeof raw.command === "string" && raw.command.trim() !== "") {
145
+ options.onLegacyField?.(options.label, raw.command);
146
+ return raw.command;
147
+ }
148
+ return "";
149
+ }