@armadra/agent 0.5.1 → 0.6.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.
Files changed (467) hide show
  1. package/CHANGELOG.md +177 -304
  2. package/CHANGELOG.zh-CN.md +442 -0
  3. package/README.md +408 -364
  4. package/README.zh-CN.md +705 -0
  5. package/dist/agent/session-plan.js +2 -2
  6. package/dist/agent/session-state.d.ts +3 -0
  7. package/dist/agent/session-state.js +20 -0
  8. package/dist/agent/session-subagent.d.ts +15 -1
  9. package/dist/agent/session-subagent.js +26 -3
  10. package/dist/agent/session-telemetry.d.ts +16 -2
  11. package/dist/agent/session-telemetry.js +29 -7
  12. package/dist/agent/session-tools.js +5 -2
  13. package/dist/agent/session-trace-writer.d.ts +27 -0
  14. package/dist/agent/session-trace-writer.js +253 -0
  15. package/dist/agent/session.d.ts +2 -0
  16. package/dist/agent/session.js +12 -0
  17. package/dist/agent/subagent-direct.d.ts +20 -0
  18. package/dist/agent/subagent-direct.js +76 -0
  19. package/dist/agent/subagent-registry.d.ts +8 -1
  20. package/dist/agent/subagent-registry.js +28 -1
  21. package/dist/agent/system-prompt.d.ts +3 -1
  22. package/dist/agent/system-prompt.js +3 -0
  23. package/dist/agent/tool-runner.d.ts +2 -1
  24. package/dist/agent/tool-runner.js +5 -4
  25. package/dist/agent/types-w6.d.ts +39 -0
  26. package/dist/agent/types-w6.js +4 -0
  27. package/dist/agent/types.d.ts +5 -2
  28. package/dist/agents/external.js +1 -1
  29. package/dist/agents/task-record.d.ts +74 -1
  30. package/dist/agents/task-record.js +100 -0
  31. package/dist/ai/apis/cache-params.js +2 -1
  32. package/dist/ai/apis/chatgpt-backend.d.ts +52 -0
  33. package/dist/ai/apis/chatgpt-backend.js +224 -0
  34. package/dist/ai/apis/chatgpt-rate-limits.d.ts +26 -0
  35. package/dist/ai/apis/chatgpt-rate-limits.js +91 -0
  36. package/dist/ai/apis/openai-responses-request.d.ts +2 -1
  37. package/dist/ai/apis/openai-responses-request.js +8 -2
  38. package/dist/ai/apis/openai-responses.d.ts +2 -0
  39. package/dist/ai/apis/openai-responses.js +51 -16
  40. package/dist/ai/overflow.d.ts +1 -1
  41. package/dist/ai/overflow.js +10 -7
  42. package/dist/ai/providers/auth.d.ts +15 -2
  43. package/dist/ai/providers/auth.js +69 -2
  44. package/dist/ai/providers/builtin.js +27 -0
  45. package/dist/ai/providers/catalog-data.js +1 -0
  46. package/dist/ai/providers/enrich.js +2 -7
  47. package/dist/ai/providers/models-dev-cache.js +15 -19
  48. package/dist/ai/providers/models-dev-snapshot.js +8 -7
  49. package/dist/ai/providers/models-dev.js +5 -15
  50. package/dist/ai/providers/suggest.js +2 -16
  51. package/dist/ai/types.d.ts +27 -1
  52. package/dist/auth/chatgpt/backend-client.d.ts +26 -0
  53. package/dist/auth/chatgpt/backend-client.js +74 -0
  54. package/dist/auth/chatgpt/claims.d.ts +17 -0
  55. package/dist/auth/chatgpt/claims.js +46 -0
  56. package/dist/auth/chatgpt/cli.d.ts +33 -0
  57. package/dist/auth/chatgpt/cli.js +252 -0
  58. package/dist/auth/chatgpt/doctor.d.ts +17 -0
  59. package/dist/auth/chatgpt/doctor.js +36 -0
  60. package/dist/auth/chatgpt/host-id.d.ts +7 -0
  61. package/dist/auth/chatgpt/host-id.js +26 -0
  62. package/dist/auth/chatgpt/login.d.ts +30 -0
  63. package/dist/auth/chatgpt/login.js +130 -0
  64. package/dist/auth/chatgpt/presets.d.ts +66 -0
  65. package/dist/auth/chatgpt/presets.js +120 -0
  66. package/dist/auth/chatgpt/quota-text.d.ts +13 -0
  67. package/dist/auth/chatgpt/quota-text.js +36 -0
  68. package/dist/auth/oauth/browser.d.ts +12 -0
  69. package/dist/auth/oauth/browser.js +27 -0
  70. package/dist/auth/oauth/callback-server.d.ts +47 -0
  71. package/dist/auth/oauth/callback-server.js +147 -0
  72. package/dist/auth/oauth/flows.d.ts +62 -0
  73. package/dist/auth/oauth/flows.js +113 -0
  74. package/dist/auth/oauth/jwt.d.ts +24 -0
  75. package/dist/auth/oauth/jwt.js +81 -0
  76. package/dist/auth/oauth/live.d.ts +21 -0
  77. package/dist/auth/oauth/live.js +25 -0
  78. package/dist/auth/oauth/oidc.d.ts +26 -0
  79. package/dist/auth/oauth/oidc.js +72 -0
  80. package/dist/auth/oauth/pkce.d.ts +15 -0
  81. package/dist/auth/oauth/pkce.js +20 -0
  82. package/dist/auth/oauth/refresh.d.ts +35 -0
  83. package/dist/auth/oauth/refresh.js +129 -0
  84. package/dist/auth/oauth/token-client.d.ts +33 -0
  85. package/dist/auth/oauth/token-client.js +121 -0
  86. package/dist/auth/oauth/token-store.d.ts +23 -0
  87. package/dist/auth/oauth/token-store.js +125 -0
  88. package/dist/auth/testing/fake-oauth.d.ts +73 -0
  89. package/dist/auth/testing/fake-oauth.js +271 -0
  90. package/dist/auth/testing/refresh-child.d.ts +5 -0
  91. package/dist/auth/testing/refresh-child.js +16 -0
  92. package/dist/bundle/ama.cjs +25928 -11144
  93. package/dist/checkpoints/backend.js +6 -5
  94. package/dist/checkpoints/restore.js +3 -2
  95. package/dist/checkpoints/settings.js +2 -1
  96. package/dist/checkpoints/shadow-git.js +7 -6
  97. package/dist/checkpoints/shadow-restore.js +3 -2
  98. package/dist/checkpoints/tracker.js +4 -3
  99. package/dist/cli/args.d.ts +9 -2
  100. package/dist/cli/args.js +74 -27
  101. package/dist/cli/bootstrap.js +53 -31
  102. package/dist/cli/choice-prompt.js +8 -6
  103. package/dist/cli/codemode-notice.js +2 -2
  104. package/dist/cli/compose-agents.js +2 -1
  105. package/dist/cli/compose-extensions.js +2 -0
  106. package/dist/cli/compose-memory.d.ts +53 -0
  107. package/dist/cli/compose-memory.js +127 -0
  108. package/dist/cli/compose-providers.d.ts +5 -0
  109. package/dist/cli/compose-providers.js +32 -2
  110. package/dist/cli/compose-session.d.ts +5 -0
  111. package/dist/cli/compose-session.js +27 -13
  112. package/dist/cli/compose-store.d.ts +2 -0
  113. package/dist/cli/compose-store.js +9 -5
  114. package/dist/cli/compose.d.ts +2 -0
  115. package/dist/cli/compose.js +13 -5
  116. package/dist/cli/default-model.d.ts +0 -2
  117. package/dist/cli/default-model.js +5 -8
  118. package/dist/cli/deps.d.ts +5 -1
  119. package/dist/cli/exit-codes.d.ts +1 -1
  120. package/dist/cli/exit-codes.js +7 -16
  121. package/dist/cli/from-prompt.js +3 -2
  122. package/dist/cli/help-text.d.ts +2 -1
  123. package/dist/cli/help-text.js +5 -99
  124. package/dist/cli/main.d.ts +5 -0
  125. package/dist/cli/main.js +21 -2
  126. package/dist/cli/proxy.js +14 -9
  127. package/dist/cli/runtime.d.ts +5 -0
  128. package/dist/cli/startup-screen.js +20 -27
  129. package/dist/cli/startup-steps.js +6 -8
  130. package/dist/cli/subcommands/auth.d.ts +6 -3
  131. package/dist/cli/subcommands/auth.js +52 -22
  132. package/dist/cli/subcommands/config-set.d.ts +21 -0
  133. package/dist/cli/subcommands/config-set.js +137 -0
  134. package/dist/cli/subcommands/config.d.ts +2 -1
  135. package/dist/cli/subcommands/config.js +51 -37
  136. package/dist/cli/subcommands/doctor.d.ts +2 -1
  137. package/dist/cli/subcommands/doctor.js +97 -58
  138. package/dist/cli/subcommands/init.d.ts +1 -1
  139. package/dist/cli/subcommands/init.js +8 -7
  140. package/dist/cli/subcommands/memory.d.ts +18 -0
  141. package/dist/cli/subcommands/memory.js +189 -0
  142. package/dist/cli/subcommands/model-meta.js +11 -9
  143. package/dist/cli/subcommands/models-cache-probe.js +23 -20
  144. package/dist/cli/subcommands/models-discover.d.ts +3 -0
  145. package/dist/cli/subcommands/models-discover.js +44 -21
  146. package/dist/cli/subcommands/models.d.ts +1 -1
  147. package/dist/cli/subcommands/models.js +29 -22
  148. package/dist/cli/subcommands/probe-runner.js +8 -7
  149. package/dist/cli/subcommands/providers-list.js +32 -21
  150. package/dist/cli/subcommands/providers-plan.js +24 -25
  151. package/dist/cli/subcommands/providers-probe.js +5 -6
  152. package/dist/cli/subcommands/providers.d.ts +1 -1
  153. package/dist/cli/subcommands/providers.js +45 -50
  154. package/dist/cli/subcommands/sessions-export.d.ts +1 -1
  155. package/dist/cli/subcommands/sessions-export.js +10 -9
  156. package/dist/cli/subcommands/sessions-search.d.ts +1 -1
  157. package/dist/cli/subcommands/sessions-search.js +11 -10
  158. package/dist/cli/subcommands/sessions-trace.d.ts +30 -0
  159. package/dist/cli/subcommands/sessions-trace.js +156 -0
  160. package/dist/cli/subcommands/sessions.d.ts +4 -3
  161. package/dist/cli/subcommands/sessions.js +40 -37
  162. package/dist/cli/subcommands/stats.d.ts +1 -1
  163. package/dist/cli/subcommands/stats.js +49 -30
  164. package/dist/cli/system-prompt-arg.js +3 -2
  165. package/dist/codemode/capability.js +3 -2
  166. package/dist/compaction/post-compact.d.ts +1 -0
  167. package/dist/compaction/post-compact.js +15 -1
  168. package/dist/compaction/prune-tier.d.ts +1 -1
  169. package/dist/compaction/prune-tier.js +3 -3
  170. package/dist/compaction/serialize.js +2 -1
  171. package/dist/config/auth-file.d.ts +12 -2
  172. package/dist/config/auth-file.js +32 -10
  173. package/dist/config/checker.js +12 -11
  174. package/dist/config/context-files.js +3 -2
  175. package/dist/config/edit.d.ts +106 -0
  176. package/dist/config/edit.js +350 -0
  177. package/dist/config/init.d.ts +4 -3
  178. package/dist/config/init.js +10 -18
  179. package/dist/config/json-schema.d.ts +2 -1
  180. package/dist/config/json-schema.js +101 -68
  181. package/dist/config/key-docs.d.ts +18 -7
  182. package/dist/config/key-docs.js +43 -128
  183. package/dist/config/load.js +7 -6
  184. package/dist/config/merge.d.ts +4 -1
  185. package/dist/config/merge.js +42 -22
  186. package/dist/config/paths.js +6 -5
  187. package/dist/config/profile.d.ts +5 -1
  188. package/dist/config/profile.js +7 -2
  189. package/dist/config/schema-w5.js +3 -2
  190. package/dist/config/schema-w6.d.ts +19 -0
  191. package/dist/config/schema-w6.js +115 -0
  192. package/dist/config/schema.js +34 -20
  193. package/dist/config/settings-registry.d.ts +78 -0
  194. package/dist/config/settings-registry.js +184 -0
  195. package/dist/config/types-w6.d.ts +109 -0
  196. package/dist/config/types-w6.js +19 -0
  197. package/dist/config/types.d.ts +11 -8
  198. package/dist/config/types.js +1 -0
  199. package/dist/drivers/acp/client.js +1 -1
  200. package/dist/drivers/acp/driver.js +13 -8
  201. package/dist/drivers/agents.js +4 -3
  202. package/dist/drivers/base.js +3 -2
  203. package/dist/drivers/host-runners.js +2 -1
  204. package/dist/drivers/native/claude-stream.js +12 -11
  205. package/dist/drivers/native/codex-app-server.js +17 -12
  206. package/dist/drivers/native/oneshot.js +8 -7
  207. package/dist/drivers/pool.js +1 -1
  208. package/dist/drivers/runner.d.ts +3 -1
  209. package/dist/drivers/runner.js +68 -20
  210. package/dist/drivers/turn.js +1 -1
  211. package/dist/hooks/config.js +3 -2
  212. package/dist/hooks/protocol.js +18 -12
  213. package/dist/host/api-impl.js +11 -10
  214. package/dist/host/loader.js +9 -8
  215. package/dist/host/types.d.ts +3 -0
  216. package/dist/i18n/catalog.d.ts +2169 -0
  217. package/dist/i18n/catalog.js +72 -0
  218. package/dist/i18n/format.d.ts +21 -0
  219. package/dist/i18n/format.js +58 -0
  220. package/dist/i18n/index.d.ts +58 -0
  221. package/dist/i18n/index.js +72 -0
  222. package/dist/i18n/messages/agents.d.ts +84 -0
  223. package/dist/i18n/messages/agents.js +85 -0
  224. package/dist/i18n/messages/approval.d.ts +99 -0
  225. package/dist/i18n/messages/approval.js +100 -0
  226. package/dist/i18n/messages/auth.d.ts +187 -0
  227. package/dist/i18n/messages/auth.js +189 -0
  228. package/dist/i18n/messages/cli-args.d.ts +46 -0
  229. package/dist/i18n/messages/cli-args.js +46 -0
  230. package/dist/i18n/messages/cli-help.d.ts +12 -0
  231. package/dist/i18n/messages/cli-help.js +244 -0
  232. package/dist/i18n/messages/cli.d.ts +336 -0
  233. package/dist/i18n/messages/cli.js +311 -0
  234. package/dist/i18n/messages/config-keys.d.ts +289 -0
  235. package/dist/i18n/messages/config-keys.js +292 -0
  236. package/dist/i18n/messages/config.d.ts +502 -0
  237. package/dist/i18n/messages/config.js +239 -0
  238. package/dist/i18n/messages/drivers.d.ts +123 -0
  239. package/dist/i18n/messages/drivers.js +124 -0
  240. package/dist/i18n/messages/errors.d.ts +83 -0
  241. package/dist/i18n/messages/errors.js +171 -0
  242. package/dist/i18n/messages/interactive-line.d.ts +61 -0
  243. package/dist/i18n/messages/interactive-line.js +69 -0
  244. package/dist/i18n/messages/interactive-startup.d.ts +103 -0
  245. package/dist/i18n/messages/interactive-startup.js +104 -0
  246. package/dist/i18n/messages/interactive-view.d.ts +140 -0
  247. package/dist/i18n/messages/interactive-view.js +141 -0
  248. package/dist/i18n/messages/interactive.d.ts +493 -0
  249. package/dist/i18n/messages/interactive.js +248 -0
  250. package/dist/i18n/messages/memory.d.ts +123 -0
  251. package/dist/i18n/messages/memory.js +128 -0
  252. package/dist/i18n/messages/panels.d.ts +190 -0
  253. package/dist/i18n/messages/panels.js +189 -0
  254. package/dist/i18n/messages/permissions.d.ts +126 -0
  255. package/dist/i18n/messages/permissions.js +151 -0
  256. package/dist/i18n/messages/plan.d.ts +123 -0
  257. package/dist/i18n/messages/plan.js +124 -0
  258. package/dist/i18n/messages/print.d.ts +86 -0
  259. package/dist/i18n/messages/print.js +91 -0
  260. package/dist/i18n/messages/report.d.ts +391 -0
  261. package/dist/i18n/messages/report.js +490 -0
  262. package/dist/i18n/messages/rewind.d.ts +198 -0
  263. package/dist/i18n/messages/rewind.js +217 -0
  264. package/dist/i18n/messages/session.d.ts +230 -0
  265. package/dist/i18n/messages/session.js +258 -0
  266. package/dist/i18n/messages/settings.d.ts +348 -0
  267. package/dist/i18n/messages/settings.js +336 -0
  268. package/dist/i18n/messages/subcommands-config.d.ts +111 -0
  269. package/dist/i18n/messages/subcommands-config.js +127 -0
  270. package/dist/i18n/messages/subcommands.d.ts +548 -0
  271. package/dist/i18n/messages/subcommands.js +474 -0
  272. package/dist/i18n/messages/trace.d.ts +243 -0
  273. package/dist/i18n/messages/trace.js +238 -0
  274. package/dist/i18n/types.d.ts +15 -0
  275. package/dist/i18n/types.js +7 -0
  276. package/dist/index.d.ts +6 -0
  277. package/dist/index.js +2 -0
  278. package/dist/memory/edit.d.ts +24 -0
  279. package/dist/memory/edit.js +63 -0
  280. package/dist/memory/frontmatter.d.ts +37 -0
  281. package/dist/memory/frontmatter.js +79 -0
  282. package/dist/memory/index.d.ts +28 -0
  283. package/dist/memory/index.js +126 -0
  284. package/dist/memory/lock.d.ts +17 -0
  285. package/dist/memory/lock.js +62 -0
  286. package/dist/memory/paths.d.ts +57 -0
  287. package/dist/memory/paths.js +175 -0
  288. package/dist/memory/report.d.ts +36 -0
  289. package/dist/memory/report.js +86 -0
  290. package/dist/memory/runtime.d.ts +42 -0
  291. package/dist/memory/runtime.js +36 -0
  292. package/dist/memory/secrets.d.ts +8 -0
  293. package/dist/memory/secrets.js +27 -0
  294. package/dist/memory/section.d.ts +28 -0
  295. package/dist/memory/section.js +59 -0
  296. package/dist/memory/store.d.ts +70 -0
  297. package/dist/memory/store.js +284 -0
  298. package/dist/memory/tool.d.ts +31 -0
  299. package/dist/memory/tool.js +94 -0
  300. package/dist/modes/acp/acp-events.js +2 -1
  301. package/dist/modes/acp/acp-server.js +13 -12
  302. package/dist/modes/commands-core.d.ts +11 -0
  303. package/dist/modes/commands-core.js +93 -62
  304. package/dist/modes/image-input.js +20 -6
  305. package/dist/modes/interactive/agent-bar.d.ts +95 -0
  306. package/dist/modes/interactive/agent-bar.js +248 -0
  307. package/dist/modes/interactive/agent-panels.js +27 -26
  308. package/dist/modes/interactive/agent-transcript.d.ts +47 -0
  309. package/dist/modes/interactive/agent-transcript.js +191 -0
  310. package/dist/modes/interactive/agent-ui.d.ts +36 -1
  311. package/dist/modes/interactive/agent-ui.js +180 -14
  312. package/dist/modes/interactive/agent-view.d.ts +72 -0
  313. package/dist/modes/interactive/agent-view.js +281 -0
  314. package/dist/modes/interactive/approval-dialog.js +46 -34
  315. package/dist/modes/interactive/clipboard-paste.d.ts +2 -2
  316. package/dist/modes/interactive/clipboard-paste.js +9 -4
  317. package/dist/modes/interactive/commands.d.ts +19 -1
  318. package/dist/modes/interactive/commands.js +84 -40
  319. package/dist/modes/interactive/completion.js +2 -1
  320. package/dist/modes/interactive/config-panel.d.ts +70 -0
  321. package/dist/modes/interactive/config-panel.js +319 -0
  322. package/dist/modes/interactive/config-ui.d.ts +96 -0
  323. package/dist/modes/interactive/config-ui.js +397 -0
  324. package/dist/modes/interactive/confirm-dialog.js +6 -7
  325. package/dist/modes/interactive/event-notices.js +11 -9
  326. package/dist/modes/interactive/interactive-mode.d.ts +1 -1
  327. package/dist/modes/interactive/interactive-mode.js +19 -22
  328. package/dist/modes/interactive/key-dispatch.d.ts +12 -0
  329. package/dist/modes/interactive/key-dispatch.js +24 -9
  330. package/dist/modes/interactive/line/line-editor.js +2 -1
  331. package/dist/modes/interactive/line/line-mode.js +18 -7
  332. package/dist/modes/interactive/line/line-render.js +25 -24
  333. package/dist/modes/interactive/memory-panel.d.ts +64 -0
  334. package/dist/modes/interactive/memory-panel.js +221 -0
  335. package/dist/modes/interactive/message-view.d.ts +4 -2
  336. package/dist/modes/interactive/message-view.js +42 -33
  337. package/dist/modes/interactive/panels.js +39 -31
  338. package/dist/modes/interactive/pickers.d.ts +2 -1
  339. package/dist/modes/interactive/pickers.js +10 -6
  340. package/dist/modes/interactive/plan-command.d.ts +1 -1
  341. package/dist/modes/interactive/plan-command.js +24 -27
  342. package/dist/modes/interactive/plan-dialog.js +18 -17
  343. package/dist/modes/interactive/plan-flow.js +6 -5
  344. package/dist/modes/interactive/rewind-command.d.ts +1 -1
  345. package/dist/modes/interactive/rewind-command.js +18 -16
  346. package/dist/modes/interactive/rewind-flow.d.ts +0 -1
  347. package/dist/modes/interactive/rewind-flow.js +13 -14
  348. package/dist/modes/interactive/rewind-list.js +7 -6
  349. package/dist/modes/interactive/rewind-panel.js +40 -40
  350. package/dist/modes/interactive/rewind-text.d.ts +5 -3
  351. package/dist/modes/interactive/rewind-text.js +48 -38
  352. package/dist/modes/interactive/run-indicator.js +15 -12
  353. package/dist/modes/interactive/session-events.js +3 -2
  354. package/dist/modes/interactive/startup-header.js +22 -23
  355. package/dist/modes/interactive/startup-ui.js +38 -30
  356. package/dist/modes/interactive/status-area.d.ts +2 -0
  357. package/dist/modes/interactive/status-area.js +8 -2
  358. package/dist/modes/interactive/status-bar.js +4 -3
  359. package/dist/modes/interactive/subagent-view.js +9 -7
  360. package/dist/modes/interactive/tasks-report.d.ts +6 -0
  361. package/dist/modes/interactive/tasks-report.js +28 -31
  362. package/dist/modes/interactive/terminal-setup.d.ts +9 -0
  363. package/dist/modes/interactive/terminal-setup.js +23 -0
  364. package/dist/modes/interactive/tool-summary.js +19 -17
  365. package/dist/modes/interactive/tool-view.js +7 -4
  366. package/dist/modes/interactive/trace-view.d.ts +89 -0
  367. package/dist/modes/interactive/trace-view.js +332 -0
  368. package/dist/modes/print/print-mode.js +14 -15
  369. package/dist/modes/rpc/commands.js +7 -3
  370. package/dist/modes/rpc/rpc-mode.js +9 -3
  371. package/dist/modes/session-report.d.ts +2 -0
  372. package/dist/modes/session-report.js +101 -105
  373. package/dist/modes/startup-ui-text.js +11 -6
  374. package/dist/permissions/bypass.d.ts +8 -10
  375. package/dist/permissions/bypass.js +19 -10
  376. package/dist/permissions/memory-class.d.ts +23 -0
  377. package/dist/permissions/memory-class.js +54 -0
  378. package/dist/permissions/modes.d.ts +3 -3
  379. package/dist/permissions/modes.js +21 -16
  380. package/dist/permissions/pipeline.d.ts +1 -1
  381. package/dist/permissions/pipeline.js +9 -2
  382. package/dist/permissions/preview.js +49 -42
  383. package/dist/permissions/rules.js +5 -2
  384. package/dist/permissions/types.d.ts +4 -0
  385. package/dist/plan/store.js +2 -1
  386. package/dist/rpc.d.ts +39 -1
  387. package/dist/rpc.js +3 -0
  388. package/dist/sandbox/bash.js +11 -8
  389. package/dist/sandbox/detect.js +14 -11
  390. package/dist/sdk.d.ts +17 -1
  391. package/dist/sdk.js +29 -7
  392. package/dist/session/export.js +31 -30
  393. package/dist/session/manager.d.ts +1 -1
  394. package/dist/session/manager.js +5 -3
  395. package/dist/session/reuse.js +5 -4
  396. package/dist/session/scan.js +3 -2
  397. package/dist/session/stats-aggregate.d.ts +3 -1
  398. package/dist/session/stats-aggregate.js +5 -1
  399. package/dist/session/stats-index.js +2 -1
  400. package/dist/session/stats-scan.d.ts +4 -1
  401. package/dist/session/stats-scan.js +6 -2
  402. package/dist/session/store.d.ts +11 -0
  403. package/dist/session/store.js +48 -1
  404. package/dist/session/types.d.ts +2 -0
  405. package/dist/skills/builtin.js +2 -1
  406. package/dist/tools/image-file.d.ts +26 -1
  407. package/dist/tools/image-file.js +55 -13
  408. package/dist/tools/presets.d.ts +14 -1
  409. package/dist/tools/presets.js +3 -3
  410. package/dist/tools/registry.js +1 -1
  411. package/dist/tools/truncate.d.ts +1 -1
  412. package/dist/tools/truncate.js +2 -2
  413. package/dist/tools/types.d.ts +17 -1
  414. package/dist/trace/build-index.d.ts +91 -0
  415. package/dist/trace/build-index.js +127 -0
  416. package/dist/trace/build-nodes.d.ts +24 -0
  417. package/dist/trace/build-nodes.js +279 -0
  418. package/dist/trace/build-util.d.ts +43 -0
  419. package/dist/trace/build-util.js +120 -0
  420. package/dist/trace/build.d.ts +82 -0
  421. package/dist/trace/build.js +382 -0
  422. package/dist/trace/detail.d.ts +35 -0
  423. package/dist/trace/detail.js +205 -0
  424. package/dist/trace/flatten.d.ts +69 -0
  425. package/dist/trace/flatten.js +173 -0
  426. package/dist/trace/format.d.ts +47 -0
  427. package/dist/trace/format.js +329 -0
  428. package/dist/trace/html-template.d.ts +19 -0
  429. package/dist/trace/html-template.js +150 -0
  430. package/dist/trace/html.d.ts +104 -0
  431. package/dist/trace/html.js +292 -0
  432. package/dist/trace/preview.d.ts +29 -0
  433. package/dist/trace/preview.js +59 -0
  434. package/dist/trace/query-session.d.ts +14 -0
  435. package/dist/trace/query-session.js +38 -0
  436. package/dist/trace/query.d.ts +55 -0
  437. package/dist/trace/query.js +188 -0
  438. package/dist/trace/session.d.ts +40 -0
  439. package/dist/trace/session.js +168 -0
  440. package/dist/trace/types.d.ts +243 -0
  441. package/dist/trace/types.js +13 -0
  442. package/dist/tui/components/editor-paste.d.ts +2 -0
  443. package/dist/tui/components/editor-paste.js +6 -3
  444. package/dist/tui/components/editor.js +2 -2
  445. package/dist/tui/components/loader.d.ts +3 -0
  446. package/dist/tui/components/loader.js +14 -0
  447. package/dist/tui/components/settings-list.d.ts +61 -0
  448. package/dist/tui/components/settings-list.js +135 -0
  449. package/dist/tui/keybindings.d.ts +5 -0
  450. package/dist/tui/keybindings.js +17 -5
  451. package/dist/tui.d.ts +1 -0
  452. package/dist/tui.js +2 -0
  453. package/docs/en/host-api.md +167 -0
  454. package/docs/en/permissions.md +214 -0
  455. package/docs/en/providers.md +625 -0
  456. package/docs/en/rpc.md +361 -0
  457. package/docs/en/sessions.md +219 -0
  458. package/docs/en/tui.md +527 -0
  459. package/docs/host-api.md +18 -17
  460. package/docs/memory.md +172 -0
  461. package/docs/permissions.md +2 -2
  462. package/docs/providers.md +67 -1
  463. package/docs/rpc.md +31 -3
  464. package/docs/session-format.md +8 -2
  465. package/docs/sessions.md +29 -1
  466. package/docs/tui.md +132 -3
  467. package/package.json +8 -3
@@ -0,0 +1,190 @@
1
+ /**
2
+ * 消息目录:panels(键名规范见 docs/i18n.md)。[W6-C0 建空壳,归 W6-I2]
3
+ *
4
+ * en 是形状源;zh 用 `satisfies Messages<typeof en>`,缺键 / 多键 / 参数不符在 tsc 期报错。
5
+ * 整句一个键、禁止片段拼接;插值写成函数,条件分支写进函数体。
6
+ *
7
+ * 消息区面板与选择器:`/session`、`/cache`、`/permissions`(`panels.ts`)、选择器(`pickers.ts`)、
8
+ * `/plan` 面板、`/agents`、`/tasks`(`agent-panels.ts`、`tasks-report.ts`)。句中需要另一种颜色的部分由调用方
9
+ * 传入 `dim` 之类的着色函数,整句仍在一个键里。
10
+ */
11
+ type Paint = (text: string) => string;
12
+ export declare const en: {
13
+ session: {
14
+ title: (id: string) => string;
15
+ notSaved: string;
16
+ model: string;
17
+ thinking: (level: string) => string;
18
+ permission: (mode: string) => string;
19
+ messages: string;
20
+ user: (n: number) => string;
21
+ assistant: (n: number) => string;
22
+ toolCalls: (n: number) => string;
23
+ usage: string;
24
+ input: (tokens: string) => string;
25
+ output: (tokens: string) => string;
26
+ cacheRead: (tokens: string) => string;
27
+ cacheWrite: (tokens: string) => string;
28
+ context: string;
29
+ subagents: string;
30
+ external: string;
31
+ };
32
+ cache: {
33
+ title: string;
34
+ };
35
+ permissions: {
36
+ mode: string;
37
+ modeValue: (label: string, mode: string, dim: Paint) => string;
38
+ order: string;
39
+ orderAuto: string;
40
+ orderAllowlist: string;
41
+ orderDefault: string;
42
+ rulesNone: string;
43
+ rules: (n: number) => string;
44
+ recentAuto: (n: number) => string;
45
+ cached: string;
46
+ };
47
+ picker: {
48
+ footer: (arrows: string) => string;
49
+ permissionTitle: string;
50
+ permissionFooter: (arrows: string) => string;
51
+ thinkingUnsupported: string;
52
+ emptyText: string;
53
+ };
54
+ plan: {
55
+ title: string;
56
+ titleVersion: (version: number) => string;
57
+ status: string;
58
+ mode: string;
59
+ modePlan: (back: string, dim: Paint) => string;
60
+ todos: string;
61
+ todosValue: (done: number, total: number, current: string | undefined, dim: Paint) => string;
62
+ steps: (n: number) => string;
63
+ };
64
+ agents: {
65
+ title: string;
66
+ titleCount: (n: number) => string;
67
+ none: string;
68
+ typesHeading: (n: number) => string;
69
+ source: {
70
+ builtin: string;
71
+ cli: string;
72
+ profile: string;
73
+ user: string;
74
+ project: string;
75
+ host: string;
76
+ };
77
+ notInstalled: string;
78
+ installed: (version: string | undefined) => string;
79
+ };
80
+ tasks: {
81
+ status: {
82
+ running: string;
83
+ completed: string;
84
+ failed: string;
85
+ aborted: string;
86
+ max_turns: string;
87
+ interrupted: string;
88
+ };
89
+ turns: (n: number) => string;
90
+ agentRunner: (agent: string, runner: string) => string;
91
+ background: string;
92
+ none: string;
93
+ heading: (n: number) => string;
94
+ footer: string;
95
+ notFound: (id: string) => string;
96
+ fullOutput: (path: string) => string;
97
+ noOutput: string;
98
+ title: (id: string) => string;
99
+ };
100
+ };
101
+ export declare const zh: {
102
+ session: {
103
+ title: (id: string) => string;
104
+ notSaved: string;
105
+ model: string;
106
+ thinking: (level: string) => string;
107
+ permission: (mode: string) => string;
108
+ messages: string;
109
+ user: (n: number) => string;
110
+ assistant: (n: number) => string;
111
+ toolCalls: (n: number) => string;
112
+ usage: string;
113
+ input: (tokens: string) => string;
114
+ output: (tokens: string) => string;
115
+ cacheRead: (tokens: string) => string;
116
+ cacheWrite: (tokens: string) => string;
117
+ context: string;
118
+ subagents: string;
119
+ external: string;
120
+ };
121
+ cache: {
122
+ title: string;
123
+ };
124
+ permissions: {
125
+ mode: string;
126
+ modeValue: (label: string, mode: string, dim: Paint) => string;
127
+ order: string;
128
+ orderAuto: string;
129
+ orderAllowlist: string;
130
+ orderDefault: string;
131
+ rulesNone: string;
132
+ rules: (n: number) => string;
133
+ recentAuto: (n: number) => string;
134
+ cached: string;
135
+ };
136
+ picker: {
137
+ footer: (arrows: string) => string;
138
+ permissionTitle: string;
139
+ permissionFooter: (arrows: string) => string;
140
+ thinkingUnsupported: string;
141
+ emptyText: string;
142
+ };
143
+ plan: {
144
+ title: string;
145
+ titleVersion: (version: number) => string;
146
+ status: string;
147
+ mode: string;
148
+ modePlan: (back: string, dim: Paint) => string;
149
+ todos: string;
150
+ todosValue: (done: number, total: number, current: string | undefined, dim: Paint) => string;
151
+ steps: (n: number) => string;
152
+ };
153
+ agents: {
154
+ title: string;
155
+ titleCount: (n: number) => string;
156
+ none: string;
157
+ typesHeading: (n: number) => string;
158
+ source: {
159
+ builtin: string;
160
+ cli: string;
161
+ profile: string;
162
+ user: string;
163
+ project: string;
164
+ host: string;
165
+ };
166
+ notInstalled: string;
167
+ installed: (version: string | undefined) => string;
168
+ };
169
+ tasks: {
170
+ status: {
171
+ running: string;
172
+ completed: string;
173
+ failed: string;
174
+ aborted: string;
175
+ max_turns: string;
176
+ interrupted: string;
177
+ };
178
+ turns: (n: number) => string;
179
+ agentRunner: (agent: string, runner: string) => string;
180
+ background: string;
181
+ none: string;
182
+ heading: (n: number) => string;
183
+ footer: string;
184
+ notFound: (id: string) => string;
185
+ fullOutput: (path: string) => string;
186
+ noOutput: string;
187
+ title: (id: string) => string;
188
+ };
189
+ };
190
+ export {};
@@ -0,0 +1,189 @@
1
+ /**
2
+ * 消息目录:panels(键名规范见 docs/i18n.md)。[W6-C0 建空壳,归 W6-I2]
3
+ *
4
+ * en 是形状源;zh 用 `satisfies Messages<typeof en>`,缺键 / 多键 / 参数不符在 tsc 期报错。
5
+ * 整句一个键、禁止片段拼接;插值写成函数,条件分支写进函数体。
6
+ *
7
+ * 消息区面板与选择器:`/session`、`/cache`、`/permissions`(`panels.ts`)、选择器(`pickers.ts`)、
8
+ * `/plan` 面板、`/agents`、`/tasks`(`agent-panels.ts`、`tasks-report.ts`)。句中需要另一种颜色的部分由调用方
9
+ * 传入 `dim` 之类的着色函数,整句仍在一个键里。
10
+ */
11
+ import { plural } from "../format.js";
12
+ export const en = {
13
+ session: {
14
+ title: (id) => `Session ${id}`,
15
+ notSaved: "not saved",
16
+ model: "Model",
17
+ thinking: (level) => `thinking ${level}`,
18
+ permission: (mode) => `permissions ${mode}`,
19
+ messages: "Messages",
20
+ user: (n) => `user ${n}`,
21
+ assistant: (n) => `assistant ${n}`,
22
+ toolCalls: (n) => `tool calls ${n}`,
23
+ usage: "Usage",
24
+ input: (tokens) => `input ${tokens}`,
25
+ output: (tokens) => `output ${tokens}`,
26
+ cacheRead: (tokens) => `cache read ${tokens}`,
27
+ cacheWrite: (tokens) => `cache write ${tokens}`,
28
+ context: "Context",
29
+ subagents: "Subagents",
30
+ external: "External agents",
31
+ },
32
+ cache: {
33
+ title: "Cache",
34
+ },
35
+ permissions: {
36
+ mode: "Mode",
37
+ modeValue: (label, mode, dim) => `${label}${dim(` (${mode})`)}`,
38
+ order: "Order",
39
+ orderAuto: "deny rules → Hook deny → dangerous-command confirmation → rule layer (protected paths, writes outside the project, network, deletions) → Hook ask → allow rules / Hook allow / session memory → static check (read-only, in-project writes, safe list) → model classifier → ask",
40
+ orderAllowlist: "deny rules → Hook deny → dangerous commands (denied) → read-only tools / allow rules / Hook allow pass → everything else denied (never asks)",
41
+ orderDefault: "deny rules → Hook deny → dangerous-command confirmation → permission mode → allow rules / Hook allow / session memory → ask",
42
+ rulesNone: "Rules (none)",
43
+ rules: (n) => `Rules (${n})`,
44
+ recentAuto: (n) => `Recent auto decisions (${n})`,
45
+ cached: " (cached)",
46
+ },
47
+ picker: {
48
+ footer: (arrows) => `${arrows} select · Enter confirm · Esc cancel`,
49
+ permissionTitle: "Permission mode",
50
+ permissionFooter: (arrows) => `${arrows} select · 1-6 pick · Enter confirm · Esc cancel`,
51
+ thinkingUnsupported: "The current model does not support thinking",
52
+ emptyText: "(empty)",
53
+ },
54
+ plan: {
55
+ title: "Plan",
56
+ titleVersion: (version) => `Plan v${version}`,
57
+ status: "Status",
58
+ mode: "Mode",
59
+ modePlan: (back, dim) => `Plan${dim(` (returns to ${back} after approval)`)}`,
60
+ todos: "Todos",
61
+ todosValue: (done, total, current, dim) => `${done}/${total} done${current !== undefined ? dim(` · in progress ${current}`) : ""}`,
62
+ steps: (n) => `Steps (${n})`,
63
+ },
64
+ agents: {
65
+ title: "Subagents",
66
+ titleCount: (n) => `Subagents (${n})`,
67
+ none: "This session has no subagents (the task tool is not enabled)",
68
+ typesHeading: (n) => `Subagent types (${n}):`,
69
+ source: {
70
+ builtin: "built-in",
71
+ cli: "command line",
72
+ profile: "profile",
73
+ user: "user",
74
+ project: "project",
75
+ host: "host",
76
+ },
77
+ notInstalled: "not installed",
78
+ installed: (version) => version !== undefined ? `installed ${version}` : "installed",
79
+ },
80
+ tasks: {
81
+ status: {
82
+ running: "running",
83
+ completed: "done",
84
+ failed: "failed",
85
+ aborted: "stopped",
86
+ max_turns: "out of turns",
87
+ interrupted: "interrupted",
88
+ },
89
+ turns: (n) => plural(n, "turn"),
90
+ agentRunner: (agent, runner) => `${agent} (${runner})`,
91
+ background: "background",
92
+ none: "No subagent tasks yet",
93
+ heading: (n) => `Subagent tasks (${n}):`,
94
+ footer: "/tasks <id> to view output · /tasks stop <id> to stop",
95
+ notFound: (id) => `No task ${id}`,
96
+ fullOutput: (path) => `Full output: ${path}`,
97
+ noOutput: "(no output yet)",
98
+ title: (id) => `Task ${id}`,
99
+ },
100
+ };
101
+ export const zh = {
102
+ session: {
103
+ title: (id) => `会话 ${id}`,
104
+ notSaved: "未落盘",
105
+ model: "模型",
106
+ thinking: (level) => `思考 ${level}`,
107
+ permission: (mode) => `权限 ${mode}`,
108
+ messages: "消息",
109
+ user: (n) => `用户 ${n}`,
110
+ assistant: (n) => `助手 ${n}`,
111
+ toolCalls: (n) => `工具调用 ${n}`,
112
+ usage: "用量",
113
+ input: (tokens) => `输入 ${tokens}`,
114
+ output: (tokens) => `输出 ${tokens}`,
115
+ cacheRead: (tokens) => `缓存读 ${tokens}`,
116
+ cacheWrite: (tokens) => `缓存写 ${tokens}`,
117
+ context: "上下文",
118
+ subagents: "子 Agent",
119
+ external: "外部 Agent",
120
+ },
121
+ cache: {
122
+ title: "缓存",
123
+ },
124
+ permissions: {
125
+ mode: "权限模式",
126
+ modeValue: (label, mode, dim) => `${label}${dim(`(${mode})`)}`,
127
+ order: "判定顺序",
128
+ orderAuto: "deny 规则 → Hook deny → 危险命令确认 → 规则层(受保护路径、项目外写入、网络、删除类)→ Hook ask → allow 规则 / Hook allow / 本会话记忆 → 静态判定(只读、项目内写入、安全名单)→ 模型分类器 → 询问",
129
+ orderAllowlist: "deny 规则 → Hook deny → 危险命令(拒绝)→ 只读工具 / allow 规则 / Hook allow 放行 → 其余拒绝(从不询问)",
130
+ orderDefault: "deny 规则 → Hook deny → 危险命令确认 → 权限模式 → allow 规则 / Hook allow / 本会话记忆 → 询问",
131
+ rulesNone: "规则(无)",
132
+ rules: (n) => `规则(${n})`,
133
+ recentAuto: (n) => `最近的 auto 判定(${n})`,
134
+ cached: "(缓存)",
135
+ },
136
+ picker: {
137
+ footer: (arrows) => `${arrows} 选择 · Enter 确认 · Esc 取消`,
138
+ permissionTitle: "权限模式",
139
+ permissionFooter: (arrows) => `${arrows} 选择 · 1-6 直接选 · Enter 确认 · Esc 取消`,
140
+ thinkingUnsupported: "当前模型不支持思考",
141
+ emptyText: "(空)",
142
+ },
143
+ plan: {
144
+ title: "计划",
145
+ titleVersion: (version) => `计划 v${version}`,
146
+ status: "状态",
147
+ mode: "模式",
148
+ modePlan: (back, dim) => `Plan${dim(`(批准后回到 ${back})`)}`,
149
+ todos: "待办",
150
+ todosValue: (done, total, current, dim) => `${done}/${total} 完成${current !== undefined ? dim(` · 进行中 ${current}`) : ""}`,
151
+ steps: (n) => `步骤(${n})`,
152
+ },
153
+ agents: {
154
+ title: "子 Agent",
155
+ titleCount: (n) => `子 Agent(${n})`,
156
+ none: "当前会话没有子 Agent(task 工具未启用)",
157
+ typesHeading: (n) => `子 Agent 类型(${n}):`,
158
+ source: {
159
+ builtin: "内置",
160
+ cli: "命令行",
161
+ profile: "profile",
162
+ user: "用户",
163
+ project: "项目",
164
+ host: "宿主",
165
+ },
166
+ notInstalled: "未安装",
167
+ installed: (version) => (version !== undefined ? `已安装 ${version}` : "已安装"),
168
+ },
169
+ tasks: {
170
+ status: {
171
+ running: "运行中",
172
+ completed: "完成",
173
+ failed: "失败",
174
+ aborted: "已停止",
175
+ max_turns: "轮数耗尽",
176
+ interrupted: "已中断",
177
+ },
178
+ turns: (n) => `${n} 轮`,
179
+ agentRunner: (agent, runner) => `${agent}(${runner})`,
180
+ background: "后台",
181
+ none: "还没有子 Agent 任务",
182
+ heading: (n) => `子 Agent 任务(${n}):`,
183
+ footer: "/tasks <id> 查看输出 · /tasks stop <id> 停止",
184
+ notFound: (id) => `没有任务 ${id}`,
185
+ fullOutput: (path) => `全文:${path}`,
186
+ noOutput: "(还没有输出)",
187
+ title: (id) => `任务 ${id}`,
188
+ },
189
+ };
@@ -0,0 +1,126 @@
1
+ /**
2
+ * 消息目录:permissions(键名规范见 docs/i18n.md)。[W6-C0 建空壳,归 W6-I2]
3
+ *
4
+ * en 是形状源;zh 用 `satisfies Messages<typeof en>`,缺键 / 多键 / 参数不符在 tsc 期报错。
5
+ * 整句一个键、禁止片段拼接;插值写成函数,条件分支写进函数体。
6
+ *
7
+ * 模式显示名(`Manual`、`Accept edits`…)两种语言都是英文,不在这里;这里是说明、执行前预览与 Bypass 确认。
8
+ */
9
+ /** 预览里一个路径参数的动作(`permissions/preview.ts`)。 */
10
+ export type PreviewVerb = "append" | "overwrite" | "delete" | "move" | "moveTo" | "gitClean" | "discard";
11
+ /** 预览路径行尾的补充说明。 */
12
+ export type PreviewNote = "intoDir" | "overwritten" | "gitCleanTracked";
13
+ export declare const en: {
14
+ /** 六种权限模式的一行说明(`permissions/modes.ts`)。 */
15
+ modeDescription: {
16
+ default: string;
17
+ autoEdit: string;
18
+ plan: string;
19
+ auto: string;
20
+ fullAuto: string;
21
+ allowlist: string;
22
+ };
23
+ /** auto 判定层的名字(审批框、`/permissions`)。 */
24
+ autoLayer: {
25
+ rule: string;
26
+ static: string;
27
+ classifier: string;
28
+ };
29
+ bypass: {
30
+ title: string;
31
+ riskAllowAll: string;
32
+ riskDangerous: string;
33
+ choiceEnter: string;
34
+ choiceCancel: string;
35
+ lineQuestion: string;
36
+ };
37
+ preview: {
38
+ moreHidden: (n: number) => string;
39
+ timedOut: (ms: number) => string;
40
+ missing: string;
41
+ symlink: string;
42
+ file: (size: string) => string;
43
+ dirCapped: (max: number) => string;
44
+ dir: (files: number, size: string, partial: boolean) => string;
45
+ pathUnexpanded: (verb: PreviewVerb, word: string) => string;
46
+ pathTarget: (verb: PreviewVerb, path: string, detail: string, note: PreviewNote | undefined) => string;
47
+ rmUnknown: (name: string) => string;
48
+ gitResetHard: string;
49
+ dangerous: (description: string) => string;
50
+ tooDeep: string;
51
+ unread: (tool: string) => string;
52
+ size: (lines: number, size: string) => string;
53
+ writeNew: (path: string, next: string) => string;
54
+ writeIsDir: (path: string) => string;
55
+ writeOverwrite: (path: string, before: string, next: string) => string;
56
+ editNotUnique: (what: string, count: string) => string;
57
+ editNotFound: (what: string) => string;
58
+ editOverlap: string;
59
+ editNoChange: string;
60
+ editMissing: (path: string) => string;
61
+ editTooLarge: (path: string, size: string) => string;
62
+ editPlan: (path: string, replacements: number, fuzzy: boolean) => string;
63
+ editOp: (index: number, removed: number, added: number) => string;
64
+ editMore: (n: number) => string;
65
+ editTotal: (before: number, after: number) => string;
66
+ editDryRunFailed: (path: string, reason: string) => string;
67
+ failed: (reason: string) => string;
68
+ moreLines: (n: number) => string;
69
+ };
70
+ };
71
+ export declare const zh: {
72
+ modeDescription: {
73
+ default: string;
74
+ autoEdit: string;
75
+ plan: string;
76
+ auto: string;
77
+ fullAuto: string;
78
+ allowlist: string;
79
+ };
80
+ autoLayer: {
81
+ rule: string;
82
+ static: string;
83
+ classifier: string;
84
+ };
85
+ bypass: {
86
+ title: string;
87
+ riskAllowAll: string;
88
+ riskDangerous: string;
89
+ choiceEnter: string;
90
+ choiceCancel: string;
91
+ lineQuestion: string;
92
+ };
93
+ preview: {
94
+ moreHidden: (n: number) => string;
95
+ timedOut: (ms: number) => string;
96
+ missing: string;
97
+ symlink: string;
98
+ file: (size: string) => string;
99
+ dirCapped: (max: number) => string;
100
+ dir: (files: number, size: string, partial: boolean) => string;
101
+ pathUnexpanded: (verb: PreviewVerb, word: string) => string;
102
+ pathTarget: (verb: PreviewVerb, path: string, detail: string, note: PreviewNote | undefined) => string;
103
+ rmUnknown: (name: string) => string;
104
+ gitResetHard: string;
105
+ dangerous: (description: string) => string;
106
+ tooDeep: string;
107
+ unread: (tool: string) => string;
108
+ size: (lines: number, size: string) => string;
109
+ writeNew: (path: string, next: string) => string;
110
+ writeIsDir: (path: string) => string;
111
+ writeOverwrite: (path: string, before: string, next: string) => string;
112
+ editNotUnique: (what: string, count: string) => string;
113
+ editNotFound: (what: string) => string;
114
+ editOverlap: string;
115
+ editNoChange: string;
116
+ editMissing: (path: string) => string;
117
+ editTooLarge: (path: string, size: string) => string;
118
+ editPlan: (path: string, replacements: number, fuzzy: boolean) => string;
119
+ editOp: (index: number, removed: number, added: number) => string;
120
+ editMore: (n: number) => string;
121
+ editTotal: (before: number, after: number) => string;
122
+ editDryRunFailed: (path: string, reason: string) => string;
123
+ failed: (reason: string) => string;
124
+ moreLines: (n: number) => string;
125
+ };
126
+ };
@@ -0,0 +1,151 @@
1
+ /**
2
+ * 消息目录:permissions(键名规范见 docs/i18n.md)。[W6-C0 建空壳,归 W6-I2]
3
+ *
4
+ * en 是形状源;zh 用 `satisfies Messages<typeof en>`,缺键 / 多键 / 参数不符在 tsc 期报错。
5
+ * 整句一个键、禁止片段拼接;插值写成函数,条件分支写进函数体。
6
+ *
7
+ * 模式显示名(`Manual`、`Accept edits`…)两种语言都是英文,不在这里;这里是说明、执行前预览与 Bypass 确认。
8
+ */
9
+ import { plural } from "../format.js";
10
+ const EN_VERB = {
11
+ append: "Append to",
12
+ overwrite: "Overwrite",
13
+ delete: "Delete",
14
+ move: "Move",
15
+ moveTo: "Move to",
16
+ gitClean: "git clean scope",
17
+ discard: "Discard changes",
18
+ };
19
+ const ZH_VERB = {
20
+ append: "追加写入",
21
+ overwrite: "覆盖写入",
22
+ delete: "删除",
23
+ move: "移动",
24
+ moveTo: "移到",
25
+ gitClean: "git clean 范围",
26
+ discard: "丢弃改动",
27
+ };
28
+ const EN_NOTE = {
29
+ intoDir: " (existing directory; moves into it)",
30
+ overwritten: " (exists; will be overwritten)",
31
+ gitCleanTracked: " (count includes tracked files; only untracked ones are deleted)",
32
+ };
33
+ const ZH_NOTE = {
34
+ intoDir: "(已存在的目录,移入其中)",
35
+ overwritten: "(已存在,将被覆盖)",
36
+ gitCleanTracked: "(计数含已跟踪文件,实际只删未跟踪的)",
37
+ };
38
+ export const en = {
39
+ /** 六种权限模式的一行说明(`permissions/modes.ts`)。 */
40
+ modeDescription: {
41
+ default: "Ask before writing files or running commands",
42
+ autoEdit: "Accept file edits automatically; still ask before commands",
43
+ plan: "Read-only research and commands; approve the plan to run",
44
+ auto: "ama judges each step: safe ones run, risky ones ask",
45
+ fullAuto: "Allow everything (dangerous commands still ask)",
46
+ allowlist: "Allow only what allow rules match; deny the rest, never ask",
47
+ },
48
+ /** auto 判定层的名字(审批框、`/permissions`)。 */
49
+ autoLayer: {
50
+ rule: "rule layer",
51
+ static: "static check",
52
+ classifier: "classifier",
53
+ },
54
+ bypass: {
55
+ title: "Enter Bypass permissions?",
56
+ riskAllowAll: "No tool call will ask anymore: file writes, commands and network run directly",
57
+ riskDangerous: "Only dangerous commands still ask and deny rules still apply; use it only in a throwaway sandbox or container",
58
+ choiceEnter: "Enter Bypass",
59
+ choiceCancel: "Cancel",
60
+ lineQuestion: "Enter Bypass? [y/N] ",
61
+ },
62
+ preview: {
63
+ moreHidden: (n) => `… ${n} more not listed`,
64
+ timedOut: (ms) => `Count timed out (> ${ms} ms); actual scope may be larger`,
65
+ missing: "does not exist",
66
+ symlink: "symlink",
67
+ file: (size) => `file, ${size}`,
68
+ dirCapped: (max) => `directory, > ${max} entries`,
69
+ dir: (files, size, partial) => `directory, ${plural(files, "file")}, ${size}${partial ? " (count incomplete)" : ""}`,
70
+ pathUnexpanded: (verb, word) => `${EN_VERB[verb]} ${word}: contains wildcards or variables, not expanded; actual scope may be larger`,
71
+ pathTarget: (verb, path, detail, note) => `${EN_VERB[verb]} ${path}: ${detail}${note === undefined ? "" : EN_NOTE[note]}`,
72
+ rmUnknown: (name) => `${name}: paths come from a pipe or expansion; scope unknown`,
73
+ gitResetHard: "git reset --hard: discards all uncommitted changes in the working tree and the index",
74
+ dangerous: (description) => `Dangerous: ${description}`,
75
+ tooDeep: "Nested too deep; inner commands not expanded",
76
+ unread: (tool) => `This file has not been read in this session; ${tool} will be rejected (read it first)`,
77
+ size: (lines, size) => `${plural(lines, "line")}, ${size}`,
78
+ writeNew: (path, next) => `Create ${path}: ${next}`,
79
+ writeIsDir: (path) => `${path} is a directory; write will fail`,
80
+ writeOverwrite: (path, before, next) => `Overwrite ${path}: ${before} → ${next}`,
81
+ editNotUnique: (what, count) => `${what} is not unique (${count} matches)`,
82
+ editNotFound: (what) => `${what} not found`,
83
+ editOverlap: "edit ranges overlap",
84
+ editNoChange: "content is the same before and after",
85
+ editMissing: (path) => `${path} does not exist or is not a file; edit will fail`,
86
+ editTooLarge: (path, size) => `Edit ${path}: ${size}, file too large; dry run skipped`,
87
+ editPlan: (path, replacements, fuzzy) => `Edit ${path}: ${plural(replacements, "replacement")}${fuzzy ? " (matched after normalizing whitespace / quotes)" : ""}`,
88
+ editOp: (index, removed, added) => ` #${index} −${removed}/+${added} lines`,
89
+ editMore: (n) => ` … ${n} more`,
90
+ editTotal: (before, after) => ` Total ${before} → ${after} lines`,
91
+ editDryRunFailed: (path, reason) => `Edit ${path}: dry run failed — ${reason}`,
92
+ failed: (reason) => `Preview failed: ${reason}`,
93
+ moreLines: (n) => `… ${plural(n, "more line")}`,
94
+ },
95
+ };
96
+ export const zh = {
97
+ modeDescription: {
98
+ default: "写文件、执行命令前询问",
99
+ autoEdit: "自动接受文件编辑,执行命令仍询问",
100
+ plan: "只读调研,只跑只读命令,出计划后审批执行",
101
+ auto: "由 ama 判断每一步:安全的自动放行,有风险的才问",
102
+ fullAuto: "全部放行(危险命令仍询问)",
103
+ allowlist: "只放行 allow 规则命中的,其余拒绝,从不询问",
104
+ },
105
+ autoLayer: {
106
+ rule: "规则层",
107
+ static: "静态判定",
108
+ classifier: "分类器",
109
+ },
110
+ bypass: {
111
+ title: "进入 Bypass permissions?",
112
+ riskAllowAll: "所有工具调用都不再询问:写文件、执行命令、联网直接放行",
113
+ riskDangerous: "只有危险命令仍会询问,deny 规则照常生效;只建议在一次性沙箱、容器里用",
114
+ choiceEnter: "进入 Bypass",
115
+ choiceCancel: "取消",
116
+ lineQuestion: "确认进入 Bypass?[y/N] ",
117
+ },
118
+ preview: {
119
+ moreHidden: (n) => `… 另 ${n} 处未列出`,
120
+ timedOut: (ms) => `统计超时(> ${ms} ms),实际范围可能更大`,
121
+ missing: "不存在",
122
+ symlink: "符号链接",
123
+ file: (size) => `文件,${size}`,
124
+ dirCapped: (max) => `目录,> ${max} 项`,
125
+ dir: (files, size, partial) => `目录,${files} 个文件,${size}${partial ? "(统计未完成)" : ""}`,
126
+ pathUnexpanded: (verb, word) => `${ZH_VERB[verb]} ${word}:含通配符或变量,未展开,实际范围可能更大`,
127
+ pathTarget: (verb, path, detail, note) => `${ZH_VERB[verb]} ${path}:${detail}${note === undefined ? "" : ZH_NOTE[note]}`,
128
+ rmUnknown: (name) => `${name}:路径来自管道或展开,范围未知`,
129
+ gitResetHard: "git reset --hard:丢弃工作区与暂存区的全部未提交改动",
130
+ dangerous: (description) => `危险:${description}`,
131
+ tooDeep: "嵌套过深,内层命令未展开",
132
+ unread: (tool) => `本会话未 read 过此文件,${tool} 会被拒绝(先 read)`,
133
+ size: (lines, size) => `${lines} 行,${size}`,
134
+ writeNew: (path, next) => `新建 ${path}:${next}`,
135
+ writeIsDir: (path) => `${path} 是目录,write 会失败`,
136
+ writeOverwrite: (path, before, next) => `覆盖 ${path}:${before} → ${next}`,
137
+ editNotUnique: (what, count) => `${what} 匹配不唯一(${count} 处)`,
138
+ editNotFound: (what) => `未找到 ${what}`,
139
+ editOverlap: "多处修改的区间重叠",
140
+ editNoChange: "修改前后内容相同",
141
+ editMissing: (path) => `${path} 不存在或不是文件,edit 会失败`,
142
+ editTooLarge: (path, size) => `修改 ${path}:${size},文件过大,未干跑`,
143
+ editPlan: (path, replacements, fuzzy) => `修改 ${path}:${replacements} 处替换${fuzzy ? "(空白 / 引号归一后匹配)" : ""}`,
144
+ editOp: (index, removed, added) => ` #${index} −${removed}/+${added} 行`,
145
+ editMore: (n) => ` … 另 ${n} 处`,
146
+ editTotal: (before, after) => ` 共 ${before} → ${after} 行`,
147
+ editDryRunFailed: (path, reason) => `修改 ${path}:干跑失败——${reason}`,
148
+ failed: (reason) => `预览失败:${reason}`,
149
+ moreLines: (n) => `… 另 ${n} 行`,
150
+ },
151
+ };