orkeon-code 1.0.0-rc.1 โ†’ 1.0.0-rc.2

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 (440) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -1
  3. package/NOTICE.md +1 -1
  4. package/README.fr.md +16 -22
  5. package/README.md +16 -22
  6. package/config/appsettings.jev.example.json +4 -1
  7. package/config/appsettings.kev.example.json +4 -1
  8. package/config/appsettings.liquid.example.json +4 -1
  9. package/config/appsettings.ollama-whisper.example.json +1 -0
  10. package/config/appsettings.whisper.example.json +1 -0
  11. package/mcp/whisper/README.md +2 -1
  12. package/orkeon-code +206 -11
  13. package/orkeon-code.ps1 +109 -7
  14. package/package.json +2 -1
  15. package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
  16. package/src/commands/_lib/args.ts +5 -4
  17. package/src/commands/_lib/dev/dev-batches.ts +34 -36
  18. package/src/commands/_lib/dev/dev-implement.ts +11 -14
  19. package/src/commands/_lib/dev/dev-source.ts +7 -11
  20. package/src/commands/_lib/dev/dev.ts +34 -37
  21. package/src/commands/_lib/dev/markers.ts +7 -0
  22. package/src/commands/_lib/dev/messages.ts +112 -0
  23. package/src/commands/_lib/dev-step.ts +16 -13
  24. package/src/commands/_lib/dispatch.ts +62 -39
  25. package/src/commands/_lib/git/branch.ts +9 -10
  26. package/src/commands/_lib/git/commit.ts +9 -13
  27. package/src/commands/_lib/git/diff.ts +22 -12
  28. package/src/commands/_lib/git/messages.ts +54 -0
  29. package/src/commands/_lib/git/review.ts +9 -10
  30. package/src/commands/_lib/memory/memory-admit.ts +19 -21
  31. package/src/commands/_lib/memory/memory.ts +3 -2
  32. package/src/commands/_lib/memory/messages.ts +32 -0
  33. package/src/commands/_lib/messages.ts +48 -0
  34. package/src/commands/_lib/project/messages.ts +8 -0
  35. package/src/commands/_lib/session/export.ts +3 -2
  36. package/src/commands/_lib/session/messages.ts +87 -0
  37. package/src/commands/_lib/session/prompts.ts +4 -0
  38. package/src/commands/_lib/session/resume.ts +15 -24
  39. package/src/commands/_lib/session/tasks.ts +20 -23
  40. package/src/commands/_lib/settings/advisor.ts +11 -16
  41. package/src/commands/_lib/settings/agents.ts +18 -28
  42. package/src/commands/_lib/settings/choices.ts +8 -0
  43. package/src/commands/_lib/settings/config.ts +43 -43
  44. package/src/commands/_lib/settings/effort.ts +147 -0
  45. package/src/commands/_lib/settings/hooks.ts +12 -20
  46. package/src/commands/_lib/settings/messages.ts +408 -0
  47. package/src/commands/_lib/settings/mode.ts +33 -24
  48. package/src/commands/_lib/settings/model.ts +71 -36
  49. package/src/commands/_lib/settings/output-style.ts +39 -0
  50. package/src/commands/_lib/settings/permissions.ts +71 -93
  51. package/src/commands/_lib/settings/route.ts +63 -0
  52. package/src/commands/_lib/settings/skills.ts +53 -11
  53. package/src/commands/_lib/settings/theme.ts +42 -0
  54. package/src/commands/_lib/speech/messages.ts +58 -0
  55. package/src/commands/_lib/speech/prompts.ts +4 -0
  56. package/src/commands/_lib/speech/say.ts +9 -10
  57. package/src/commands/_lib/speech/transcribe.ts +14 -23
  58. package/src/commands/_lib/speech/voice.ts +14 -18
  59. package/src/commands/_lib/status/doctor.ts +47 -28
  60. package/src/commands/_lib/status/messages.ts +100 -0
  61. package/src/commands/_lib/status/meta.ts +3 -24
  62. package/src/commands/_lib/status/status.ts +10 -11
  63. package/src/commands/_lib/status/usage-tools.ts +2 -3
  64. package/src/commands/_lib/status/usage.ts +7 -18
  65. package/src/commands/_lib/view.ts +6 -1
  66. package/src/commands/dev/dev-batches.cmd.ts +4 -3
  67. package/src/commands/dev/dev-learn.cmd.ts +3 -3
  68. package/src/commands/dev/dev-plan.cmd.ts +6 -7
  69. package/src/commands/dev/dev-spec.cmd.ts +6 -7
  70. package/src/commands/git/commit.cmd.ts +3 -3
  71. package/src/commands/git/review.cmd.ts +3 -3
  72. package/src/commands/memory/memory.cmd.ts +2 -2
  73. package/src/commands/project/analyze.cmd.ts +3 -3
  74. package/src/commands/project/debug-tool-call.cmd.ts +4 -9
  75. package/src/commands/project/init-verifiers.cmd.ts +3 -3
  76. package/src/commands/project/init.cmd.ts +3 -3
  77. package/src/commands/project/verify.cmd.ts +2 -2
  78. package/src/commands/session/assistant.cmd.ts +2 -2
  79. package/src/commands/session/compact.cmd.ts +1 -1
  80. package/src/commands/session/copy.cmd.ts +8 -7
  81. package/src/commands/session/rename.cmd.ts +3 -2
  82. package/src/commands/session/rewind.cmd.ts +3 -4
  83. package/src/commands/session/summary.cmd.ts +3 -3
  84. package/src/commands/session/tasks.cmd.ts +4 -2
  85. package/src/commands/settings/config.cmd.ts +4 -2
  86. package/src/commands/settings/effort.cmd.ts +10 -31
  87. package/src/commands/settings/fast.cmd.ts +2 -1
  88. package/src/commands/settings/mode.cmd.ts +3 -3
  89. package/src/commands/settings/model.cmd.ts +3 -2
  90. package/src/commands/settings/output-style.cmd.ts +9 -38
  91. package/src/commands/settings/permissions.cmd.ts +2 -2
  92. package/src/commands/settings/proactive.cmd.ts +2 -1
  93. package/src/commands/settings/route.cmd.ts +16 -0
  94. package/src/commands/settings/skills.cmd.ts +3 -3
  95. package/src/commands/settings/theme.cmd.ts +14 -0
  96. package/src/commands/speech/say.cmd.ts +2 -2
  97. package/src/commands/speech/transcribe.cmd.ts +2 -2
  98. package/src/commands/status/release-notes.cmd.ts +1 -1
  99. package/src/crews/.orkeon/orkeon.d.ts +538 -93
  100. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  101. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
  102. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  103. package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
  104. package/src/crews/advisor/application/messages.ts +4 -0
  105. package/src/crews/advisor/application/prompts.ts +4 -0
  106. package/src/crews/advisor/application/run-advisor.ts +2 -1
  107. package/src/crews/advisor/crew.ork.ts +5 -4
  108. package/src/crews/advisor/domain/advice.ts +7 -23
  109. package/src/crews/advisor/domain/messages.ts +8 -0
  110. package/src/crews/advisor/domain/prompts.ts +26 -0
  111. package/src/crews/agent-run/application/messages.ts +18 -0
  112. package/src/crews/agent-run/application/run-agent-run.ts +5 -4
  113. package/src/crews/agent-run/crew.ork.ts +3 -3
  114. package/src/crews/analyze/application/messages.ts +27 -0
  115. package/src/crews/analyze/application/prompts.ts +4 -0
  116. package/src/crews/analyze/application/run-analyze.ts +16 -14
  117. package/src/crews/analyze/crew.ork.ts +5 -4
  118. package/src/crews/analyze/domain/harvest.ts +33 -65
  119. package/src/crews/analyze/domain/prompts.ts +86 -0
  120. package/src/crews/code-review/application/lens-material.ts +24 -0
  121. package/src/crews/code-review/application/messages.ts +17 -0
  122. package/src/crews/code-review/application/prompts.ts +10 -17
  123. package/src/crews/code-review/application/review.ts +4 -1
  124. package/src/crews/code-review/application/run-code-review.ts +13 -15
  125. package/src/crews/code-review/crew.ork.ts +5 -4
  126. package/src/crews/code-review/domain/lenses.ts +6 -45
  127. package/src/crews/code-review/domain/messages.ts +25 -0
  128. package/src/crews/code-review/domain/prompts.ts +58 -0
  129. package/src/crews/code-review/domain/report.ts +5 -6
  130. package/src/crews/code-review/domain/scope.ts +6 -12
  131. package/src/crews/dev-batches/application/messages.ts +127 -0
  132. package/src/crews/dev-batches/application/plan-close.ts +12 -12
  133. package/src/crews/dev-batches/application/prompts.ts +10 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
  135. package/src/crews/dev-batches/application/run-wave.ts +24 -22
  136. package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
  137. package/src/crews/dev-batches/crew.ork.ts +12 -9
  138. package/src/crews/dev-batches/domain/batches-log.ts +1 -3
  139. package/src/crews/dev-batches/domain/markers.ts +5 -0
  140. package/src/crews/dev-batches/domain/messages.ts +6 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +3 -2
  142. package/src/crews/dev-change/application/change-material.ts +44 -0
  143. package/src/crews/dev-change/application/evidence.ts +25 -22
  144. package/src/crews/dev-change/application/messages.ts +81 -0
  145. package/src/crews/dev-change/application/{change-prompt.ts โ†’ prompts.ts} +40 -43
  146. package/src/crews/dev-change/application/run-dev-change.ts +43 -34
  147. package/src/crews/dev-change/crew.ork.ts +11 -9
  148. package/src/crews/dev-change/domain/change-answer.ts +24 -20
  149. package/src/crews/dev-change/domain/change-render.ts +13 -15
  150. package/src/crews/dev-change/domain/markers.ts +28 -0
  151. package/src/crews/dev-change/domain/messages.ts +16 -0
  152. package/src/crews/dev-implement/application/close.ts +21 -18
  153. package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
  154. package/src/crews/dev-implement/application/messages.ts +161 -0
  155. package/src/crews/dev-implement/application/observe.ts +4 -2
  156. package/src/crews/dev-implement/application/prompts.ts +9 -0
  157. package/src/crews/dev-implement/application/report-writes.ts +14 -9
  158. package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
  159. package/src/crews/dev-implement/application/suite-job.ts +15 -11
  160. package/src/crews/dev-implement/crew.ork.ts +2 -1
  161. package/src/crews/dev-implement/domain/contracts.ts +59 -60
  162. package/src/crews/dev-implement/domain/correction.ts +16 -15
  163. package/src/crews/dev-implement/domain/cycles.ts +2 -1
  164. package/src/crews/dev-implement/domain/markers.ts +23 -0
  165. package/src/crews/dev-implement/domain/messages.ts +58 -0
  166. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  167. package/src/crews/dev-implement/domain/roles.ts +3 -7
  168. package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
  169. package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
  170. package/src/crews/dev-implement/domain/step-checks.ts +17 -16
  171. package/src/crews/dev-implement/domain/step-section.ts +6 -4
  172. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  173. package/src/crews/dev-learn/application/messages.ts +51 -0
  174. package/src/crews/dev-learn/application/{learn-prompt.ts โ†’ prompts.ts} +24 -65
  175. package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
  176. package/src/crews/dev-learn/crew.ork.ts +4 -3
  177. package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
  178. package/src/crews/dev-learn/domain/messages.ts +65 -0
  179. package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
  180. package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
  181. package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
  182. package/src/crews/dev-plan/application/inventory.ts +17 -13
  183. package/src/crews/dev-plan/application/messages.ts +88 -0
  184. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  185. package/src/crews/dev-plan/application/{plan-prompt.ts โ†’ prompts.ts} +37 -55
  186. package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
  187. package/src/crews/dev-plan/crew.ork.ts +11 -8
  188. package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
  189. package/src/crews/dev-plan/domain/markers.ts +18 -0
  190. package/src/crews/dev-plan/domain/messages.ts +118 -0
  191. package/src/crews/dev-plan/domain/plan-answer.ts +118 -103
  192. package/src/crews/dev-plan/domain/plan-render.ts +30 -31
  193. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  194. package/src/crews/dev-spec/application/messages.ts +30 -0
  195. package/src/crews/dev-spec/application/{spec-prompt.ts โ†’ prompts.ts} +42 -47
  196. package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
  197. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  198. package/src/crews/dev-spec/crew.ork.ts +11 -9
  199. package/src/crews/dev-spec/domain/markers.ts +30 -0
  200. package/src/crews/dev-spec/domain/messages.ts +39 -0
  201. package/src/crews/dev-spec/domain/spec-answer.ts +46 -47
  202. package/src/crews/dev-spec/domain/spec-render.ts +18 -18
  203. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  204. package/src/crews/dev-verify/application/audit.ts +38 -30
  205. package/src/crews/dev-verify/application/capture.ts +34 -26
  206. package/src/crews/dev-verify/application/messages.ts +119 -0
  207. package/src/crews/dev-verify/application/prompts.ts +209 -0
  208. package/src/crews/dev-verify/application/run-dev-verify.ts +60 -46
  209. package/src/crews/dev-verify/application/run-gate.ts +11 -9
  210. package/src/crews/dev-verify/crew.ork.ts +6 -6
  211. package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
  212. package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
  213. package/src/crews/dev-verify/domain/commands.ts +3 -3
  214. package/src/crews/dev-verify/domain/gate.ts +21 -16
  215. package/src/crews/dev-verify/domain/markers.ts +16 -0
  216. package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
  217. package/src/crews/dev-verify/domain/messages.ts +92 -0
  218. package/src/crews/dev-verify/domain/verdict.ts +4 -4
  219. package/src/crews/git-commit/application/draft.ts +16 -37
  220. package/src/crews/git-commit/application/messages.ts +15 -0
  221. package/src/crews/git-commit/application/prompts.ts +47 -0
  222. package/src/crews/git-commit/application/run-git-commit.ts +13 -12
  223. package/src/crews/git-commit/crew.ork.ts +5 -4
  224. package/src/crews/git-commit/domain/commit.ts +15 -35
  225. package/src/crews/git-commit/domain/markers.ts +4 -0
  226. package/src/crews/git-commit/domain/messages.ts +48 -0
  227. package/src/crews/init-verifiers/application/authoring.ts +2 -1
  228. package/src/crews/init-verifiers/application/messages.ts +13 -0
  229. package/src/crews/init-verifiers/application/prompts.ts +5 -1
  230. package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
  231. package/src/crews/init-verifiers/crew.ork.ts +5 -4
  232. package/src/crews/main-loop/application/auto-compact.ts +2 -1
  233. package/src/crews/main-loop/application/messages.ts +81 -0
  234. package/src/crews/main-loop/application/prompts.ts +12 -0
  235. package/src/crews/main-loop/application/run-main-loop.ts +63 -30
  236. package/src/crews/main-loop/application/{turn-prompt.ts โ†’ turn-context.ts} +7 -8
  237. package/src/crews/main-loop/crew.ork.ts +12 -7
  238. package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
  239. package/src/crews/main-loop/domain/prompts.ts +336 -0
  240. package/src/crews/main-loop/domain/turn-chains.ts +10 -9
  241. package/src/crews/project-init/application/detect.ts +5 -4
  242. package/src/crews/project-init/application/messages.ts +15 -0
  243. package/src/crews/project-init/application/prompts.ts +11 -7
  244. package/src/crews/project-init/crew.ork.ts +5 -4
  245. package/src/crews/project-init/domain/existing-files.ts +6 -4
  246. package/src/crews/project-init/domain/messages.ts +13 -0
  247. package/src/crews/project-init/domain/package-map.ts +3 -3
  248. package/src/crews/project-init/domain/prompts.ts +10 -0
  249. package/src/crews/session-compact/application/prompts.ts +5 -0
  250. package/src/crews/session-compact/crew.ork.ts +5 -4
  251. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  252. package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
  253. package/src/crews/speech/application/messages.ts +3 -0
  254. package/src/crews/speech/application/prompts.ts +3 -0
  255. package/src/crews/speech/application/run-speech.ts +2 -1
  256. package/src/crews/speech/crew.ork.ts +2 -1
  257. package/src/shared/application/agents/child-agent.ts +11 -7
  258. package/src/shared/application/agents/messages.ts +35 -0
  259. package/src/shared/application/agents/route-agent.ts +115 -0
  260. package/src/shared/application/agents/run-sub-agent.ts +31 -8
  261. package/src/shared/application/compaction/compact-session.ts +19 -14
  262. package/src/shared/application/compaction/messages.ts +20 -0
  263. package/src/shared/application/compaction/prune-context.ts +94 -0
  264. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  265. package/src/shared/application/dev/brief-inventory.ts +6 -4
  266. package/src/shared/application/dev/close-batch.ts +9 -7
  267. package/src/shared/application/dev/find-repo-pack.ts +4 -3
  268. package/src/shared/application/dev/learn-decision.ts +20 -18
  269. package/src/shared/application/dev/load-dev-context.ts +7 -8
  270. package/src/shared/application/dev/measure-access-cost.ts +5 -4
  271. package/src/shared/application/dev/messages.ts +132 -0
  272. package/src/shared/application/dev/phase-timer.ts +54 -0
  273. package/src/shared/application/dev/plan-source.ts +12 -8
  274. package/src/shared/application/dev/preflight.ts +8 -8
  275. package/src/shared/application/dev/prompts.ts +34 -0
  276. package/src/shared/application/dev/question-round.ts +25 -17
  277. package/src/shared/application/dev/resolve-work-folder.ts +4 -3
  278. package/src/shared/application/dev/settle-questions.ts +4 -2
  279. package/src/shared/application/dev/source-review.ts +12 -8
  280. package/src/shared/application/dev/source-step.ts +12 -10
  281. package/src/shared/application/dev/spend.ts +17 -4
  282. package/src/shared/application/dev/step-precedents.ts +2 -1
  283. package/src/shared/application/dev/tool-call-policy.ts +9 -11
  284. package/src/shared/application/dev/tool-callbacks.ts +52 -5
  285. package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
  286. package/src/shared/application/dev/verdict-sources.ts +5 -3
  287. package/src/shared/application/dev/wrapped-tools.ts +4 -2
  288. package/src/shared/application/extra-tools.ts +2 -1
  289. package/src/shared/application/git/batch-worktree.ts +22 -17
  290. package/src/shared/application/git/commit-files.ts +24 -19
  291. package/src/shared/application/git/merge-batch.ts +11 -7
  292. package/src/shared/application/git/messages.ts +75 -0
  293. package/src/shared/application/git/open-pull-request.ts +4 -3
  294. package/src/shared/application/host-context.ts +59 -0
  295. package/src/shared/application/host-layout-store.ts +45 -0
  296. package/src/shared/application/llm-profile.ts +4 -3
  297. package/src/shared/application/messages.ts +14 -0
  298. package/src/shared/application/permission-rules.ts +10 -0
  299. package/src/shared/application/ports/decision.ts +14 -0
  300. package/src/shared/application/ports/human.ts +25 -0
  301. package/src/shared/application/ports/llm.ts +32 -3
  302. package/src/shared/application/ports/memory.ts +1 -1
  303. package/src/shared/application/ports/theme.ts +11 -0
  304. package/src/shared/application/ports.ts +4 -2
  305. package/src/shared/application/session-io.ts +2 -1
  306. package/src/shared/application/shared-memory/admit-entries.ts +16 -14
  307. package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
  308. package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
  309. package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
  310. package/src/shared/application/shared-memory/memory-files.ts +2 -1
  311. package/src/shared/application/shared-memory/memory-settings.ts +2 -1
  312. package/src/shared/application/shared-memory/messages.ts +63 -0
  313. package/src/shared/application/shared-memory/push-candidate.ts +14 -11
  314. package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
  315. package/src/shared/application/skills/messages.ts +4 -0
  316. package/src/shared/application/skills/suggest-skills.ts +102 -0
  317. package/src/shared/application/workflow/messages.ts +8 -0
  318. package/src/shared/application/workflow/workflow-state.ts +7 -6
  319. package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
  320. package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
  321. package/src/shared/domain/agent-policy/messages.ts +66 -0
  322. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  323. package/src/shared/domain/agent-policy/permission.ts +20 -18
  324. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  325. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  326. package/src/shared/domain/agent-policy/rule-sets.ts +18 -14
  327. package/src/shared/domain/agent-policy/tool-access.ts +17 -3
  328. package/src/shared/domain/agent-registry.ts +6 -5
  329. package/src/shared/domain/agents/chain.ts +2 -2
  330. package/src/shared/domain/agents/charter.ts +8 -5
  331. package/src/shared/domain/agents/exclusive.ts +2 -1
  332. package/src/shared/domain/agents/instances.ts +18 -15
  333. package/src/shared/domain/agents/messages.ts +39 -0
  334. package/src/shared/domain/agents/model-route.ts +199 -0
  335. package/src/shared/domain/agents/prompts.ts +20 -0
  336. package/src/shared/domain/code-intel-contract.ts +5 -4
  337. package/src/shared/domain/code-intel-routing.ts +8 -61
  338. package/src/shared/domain/compact-outcome.ts +5 -3
  339. package/src/shared/domain/compaction-thresholds.ts +2 -1
  340. package/src/shared/domain/compaction.ts +22 -113
  341. package/src/shared/domain/config-schema.ts +94 -81
  342. package/src/shared/domain/context-prune.ts +176 -0
  343. package/src/shared/domain/decision/questions.ts +102 -0
  344. package/src/shared/domain/dev/access-cost.ts +19 -15
  345. package/src/shared/domain/dev/batches-concurrency.ts +5 -6
  346. package/src/shared/domain/dev/build-commands.ts +5 -4
  347. package/src/shared/domain/dev/call-guard.ts +29 -28
  348. package/src/shared/domain/dev/carried-text.ts +3 -5
  349. package/src/shared/domain/dev/learn-proposals.ts +5 -4
  350. package/src/shared/domain/dev/learn-state.ts +3 -2
  351. package/src/shared/domain/dev/markers.ts +107 -0
  352. package/src/shared/domain/dev/messages.ts +259 -0
  353. package/src/shared/domain/dev/phase-timing.ts +50 -0
  354. package/src/shared/domain/dev/plan-checks.ts +24 -23
  355. package/src/shared/domain/dev/plan-format.ts +14 -24
  356. package/src/shared/domain/dev/project-files.ts +1 -15
  357. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  358. package/src/shared/domain/dev/{review-prompt.ts โ†’ prompts.ts} +91 -61
  359. package/src/shared/domain/dev/questions.ts +33 -15
  360. package/src/shared/domain/dev/repo-pack.ts +12 -9
  361. package/src/shared/domain/dev/review-answer.ts +40 -17
  362. package/src/shared/domain/dev/review-brief.ts +54 -0
  363. package/src/shared/domain/dev/reviewer-charter.ts +4 -0
  364. package/src/shared/domain/dev/sheet-facts.ts +2 -4
  365. package/src/shared/domain/dev/spec-format.ts +13 -14
  366. package/src/shared/domain/dev/step-budget.ts +4 -2
  367. package/src/shared/domain/dev/step-rules.ts +3 -4
  368. package/src/shared/domain/dev/test-commands.ts +14 -10
  369. package/src/shared/domain/dev/tool-guards.ts +4 -3
  370. package/src/shared/domain/dev/trait-pattern.ts +14 -10
  371. package/src/shared/domain/dev/verdict-format.ts +14 -21
  372. package/src/shared/domain/dev/whitespace.ts +3 -2
  373. package/src/shared/domain/dev/work-folder.ts +4 -3
  374. package/src/shared/domain/dev/yaml-subset.ts +8 -26
  375. package/src/shared/domain/error-text.ts +13 -0
  376. package/src/shared/domain/git/close.ts +5 -4
  377. package/src/shared/domain/git/messages.ts +20 -0
  378. package/src/shared/domain/git/pull-request.ts +5 -5
  379. package/src/shared/domain/host-layout.ts +147 -0
  380. package/src/shared/domain/host-paths.ts +399 -0
  381. package/src/shared/domain/llm-failure.ts +35 -7
  382. package/src/shared/domain/llm-profile.ts +22 -3
  383. package/src/shared/domain/marked-message.ts +1 -5
  384. package/src/shared/domain/markers.ts +30 -0
  385. package/src/shared/domain/messages.ts +291 -0
  386. package/src/shared/domain/model-catalog.ts +2 -9
  387. package/src/shared/domain/permission-modes.ts +4 -8
  388. package/src/shared/domain/prelude.ts +2 -2
  389. package/src/shared/domain/project-manifests.ts +3 -2
  390. package/src/shared/domain/prompts.ts +233 -0
  391. package/src/shared/domain/search-routing.ts +3 -11
  392. package/src/shared/domain/secret-patterns.ts +3 -2
  393. package/src/shared/domain/session-keys.ts +7 -0
  394. package/src/shared/domain/session-start.ts +3 -2
  395. package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
  396. package/src/shared/domain/shared-memory/candidates.ts +3 -4
  397. package/src/shared/domain/shared-memory/entry.ts +26 -20
  398. package/src/shared/domain/shared-memory/front-matter.ts +17 -13
  399. package/src/shared/domain/shared-memory/gate.ts +4 -3
  400. package/src/shared/domain/shared-memory/harvest.ts +9 -6
  401. package/src/shared/domain/shared-memory/layout.ts +11 -8
  402. package/src/shared/domain/shared-memory/markers.ts +9 -0
  403. package/src/shared/domain/shared-memory/messages.ts +66 -0
  404. package/src/shared/domain/shared-memory/precedents-block.ts +4 -15
  405. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  406. package/src/shared/domain/shared-memory/refused.ts +3 -3
  407. package/src/shared/domain/skills/prompts.ts +4 -0
  408. package/src/shared/domain/skills/shortlist.ts +149 -0
  409. package/src/shared/domain/snip-turns.ts +2 -14
  410. package/src/shared/domain/speech.ts +2 -1
  411. package/src/shared/domain/tool-trace.ts +5 -7
  412. package/src/shared/domain/verifiers.ts +7 -11
  413. package/src/shared/domain/vfs.ts +8 -1
  414. package/src/shared/domain/workflow/prompts.ts +15 -0
  415. package/src/shared/domain/workflow/state-file.ts +14 -12
  416. package/src/shared/infrastructure/globals.ts +7 -2
  417. package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
  418. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  419. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  420. package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
  421. package/src/shared/infrastructure/orkeon/files.ts +24 -6
  422. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
  423. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  424. package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
  425. package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
  426. package/src/shared/infrastructure/orkeon/llm.ts +85 -30
  427. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  428. package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
  429. package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
  430. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  431. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  432. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  433. package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
  434. package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
  435. package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
  436. package/src/shared/infrastructure/orkeon/shell.ts +13 -5
  437. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
  438. package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
  439. package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
  440. package/src/shared/domain/session-summary.ts +0 -13
@@ -0,0 +1,63 @@
1
+ // /route [on|off|why]: the routing of the crews a command launches (ADR 0027). `on` and `off` set `route.agents` for
2
+ // the session, as `/config set` would; bare, it says where the routing stands; `why` shows the last routed launches.
3
+ // A routed crew runs on a rung of the ladder, with the effort /effort stored: bare, /route also says, rung by rung,
4
+ // what that rung's model takes and what the stored effort becomes on it, as the runtime judges them (Orkeon #359,
5
+ // #360).
6
+ import type { DecisionModel, ReasoningReader, SessionStore } from "../../../shared/application/ports.ts";
7
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
8
+ import {
9
+ ROUTE_AGENTS_CONFIG_KEY, ROUTE_LADDER_CONFIG_KEY, ladderOf, parseRecords, routeOn,
10
+ } from "../../../shared/domain/agents/model-route.ts";
11
+ import { providerEffort } from "../../../shared/domain/agent-policy/behavior-flags.ts";
12
+ import type { EffortLevel } from "../../../shared/domain/agent-policy/behavior-flags.ts";
13
+ import { EFFORT_STATE_KEY, ROUTE_RECENT_STATE_KEY } from "../../../shared/domain/session-keys.ts";
14
+ import { routeWhy } from "../../../shared/application/agents/route-agent.ts";
15
+ import { HOST_DEFAULT_MODEL } from "../../../shared/application/agents/messages.ts";
16
+ import type { CommandView } from "../view.ts";
17
+ import { effortWarningNote } from "./effort.ts";
18
+ import { NOTHING_ROUTED_YET, ROUTE_USAGE, modelTakes, routeSet, routeStatus, routedRecord, rungLine } from "./messages.ts";
19
+
20
+ export interface RouteCommandDeps {
21
+ config: Pick<ConfigStore, "readValue" | "readSession" | "writeSession">;
22
+ session: Pick<SessionStore, "readState">;
23
+ decision: Pick<DecisionModel, "available">;
24
+ /** What each rung's model takes for reasoning; absent, or answering nothing for a rung: no line for it. */
25
+ reasoning?: ReasoningReader;
26
+ }
27
+
28
+ /** The line of one rung: what the stored effort becomes on its model when it does not go as asked, else the levels
29
+ * that model takes; none when the runtime cannot tell (a profile the host does not declare, a model the table
30
+ * does not know and no effort stored). */
31
+ function rungReasoning(rung: string, effort: EffortLevel | undefined, reasoning: ReasoningReader): string | null {
32
+ const target = { profile: rung, model: "" };
33
+ const capabilities = reasoning.capabilities(target);
34
+ const note = effort === undefined ? "" : effortWarningNote(reasoning.effort(target, effort), capabilities);
35
+ if (note !== "") return rungLine(rung, note);
36
+ return capabilities !== null && capabilities.known ? rungLine(rung, modelTakes(capabilities.model, capabilities.efforts)) : null;
37
+ }
38
+
39
+ async function status(deps: RouteCommandDeps): Promise<CommandView> {
40
+ const on = routeOn((await deps.config.readValue(ROUTE_AGENTS_CONFIG_KEY)).value);
41
+ const ladder = ladderOf((await deps.config.readValue(ROUTE_LADDER_CONFIG_KEY)).value);
42
+ const head = routeStatus(on, ladder.join(","), deps.decision.available());
43
+ const { reasoning } = deps;
44
+ if (reasoning === undefined) return { text: head };
45
+ const effort = providerEffort(await deps.session.readState(EFFORT_STATE_KEY).catch(() => null));
46
+ const rungs = ladder.map((rung) => rungReasoning(rung, effort, reasoning)).filter((line) => line !== null);
47
+ return { text: [head, ...rungs].join("\n") };
48
+ }
49
+
50
+ async function why(deps: RouteCommandDeps): Promise<CommandView> {
51
+ const records = parseRecords(await deps.session.readState(ROUTE_RECENT_STATE_KEY).catch(() => null));
52
+ if (records.length === 0) return { text: NOTHING_ROUTED_YET };
53
+ return { lines: records.map((r) => routedRecord(r.crew, r.profile ?? HOST_DEFAULT_MODEL, routeWhy(r))) };
54
+ }
55
+
56
+ export async function runRoute(tokens: string[], deps: RouteCommandDeps): Promise<CommandView> {
57
+ const word = (tokens[0] ?? "").toLowerCase();
58
+ if (word === "") return status(deps);
59
+ if (word === "why") return why(deps);
60
+ if (word !== "on" && word !== "off") return { text: ROUTE_USAGE };
61
+ await deps.config.writeSession({ ...await deps.config.readSession(), [ROUTE_AGENTS_CONFIG_KEY]: word });
62
+ return { text: routeSet(word === "on", deps.decision.available()) };
63
+ }
@@ -1,17 +1,57 @@
1
1
  // /skills (E-1) โ€” manage skill attachments (baseline 04 ยง/skills). Skills in
2
2
  // Orkeon Code are workspace markdown files whose PATH is registered here; attached
3
3
  // skills are restorable context (the post-compaction restore, E-4, re-injects
4
- // path-mentioned files). DEVIATION (recorded in RESULTS.md): no autonomous
5
- // skill triggering โ€” attachment is explicit.
4
+ // path-mentioned files). Attachment is explicit; `/skills suggest on` adds, turn by turn, the project's skills the
5
+ // host's decision model finds fit for the request (shared/application/skills/suggest-skills.ts, ADR 0027).
6
6
 
7
- import type { Files, SessionStore } from "../../../shared/application/ports.ts";
7
+ import type { DecisionModel, Files, SessionStore } from "../../../shared/application/ports.ts";
8
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
9
+ import { SKILLS_SUGGEST_CONFIG_KEY, suggestOn } from "../../../shared/domain/skills/shortlist.ts";
10
+ import type { SkillPick } from "../../../shared/domain/skills/shortlist.ts";
8
11
  import { readJsonArray, writeJson } from "../../../shared/application/session-state.ts";
9
- import { SKILLS_STATE_KEY } from "../../../shared/domain/session-keys.ts";
12
+ import { SKILLS_STATE_KEY, SKILLS_SUGGESTED_STATE_KEY } from "../../../shared/domain/session-keys.ts";
10
13
  import type { CommandView } from "../view.ts";
14
+ import {
15
+ NO_SKILLS, NOTHING_SUGGESTED_YET, SKILLS_ATTACH_USAGE, SKILLS_SUGGEST_USAGE, SKILLS_USAGE, cannotAttach, noSkillFit, skillAttached,
16
+ skillDetached, skillsDetachUsage, skillsOffered, suggestSet, suggestStatus, suggestedSkill,
17
+ } from "./messages.ts";
11
18
 
12
19
  export interface SkillsDeps {
13
20
  session: Pick<SessionStore, "readState" | "writeState">;
14
21
  files: Pick<Files, "read">;
22
+ /** The settings and the decision model `/skills suggest` reads; absent, the sub-command answers its usage. */
23
+ config?: Pick<ConfigStore, "readValue" | "readSession" | "writeSession">;
24
+ decision?: Pick<DecisionModel, "available">;
25
+ }
26
+
27
+ /** What the last turn was suggested, as stored; null when nothing readable is. */
28
+ function lastSuggestion(stored: string | null): { offered: number; picks: SkillPick[] } | null {
29
+ try {
30
+ const raw = JSON.parse(stored ?? "null") as { offered?: unknown; picks?: unknown } | null;
31
+ if (raw === null || typeof raw.offered !== "number" || !Array.isArray(raw.picks)) return null;
32
+ return { offered: raw.offered, picks: raw.picks.filter((p): p is SkillPick => typeof p?.path === "string" && typeof p?.share === "number") };
33
+ } catch {
34
+ return null;
35
+ }
36
+ }
37
+
38
+ /** `/skills suggest [on|off|why]`. */
39
+ async function runSuggest(word: string, deps: SkillsDeps): Promise<CommandView> {
40
+ const { config, decision } = deps;
41
+ if (config === undefined || decision === undefined) return { text: SKILLS_SUGGEST_USAGE };
42
+ if (word === "") {
43
+ const value = await config.readValue(SKILLS_SUGGEST_CONFIG_KEY).then((read) => read.value).catch(() => undefined);
44
+ return { text: suggestStatus(suggestOn(value), decision.available()) };
45
+ }
46
+ if (word === "why") {
47
+ const last = lastSuggestion(await deps.session.readState(SKILLS_SUGGESTED_STATE_KEY).catch(() => null));
48
+ if (last === null) return { text: NOTHING_SUGGESTED_YET };
49
+ if (last.picks.length === 0) return { text: noSkillFit(last.offered) };
50
+ return { lines: last.picks.map((pick) => suggestedSkill(pick.path, pick.share)), text: skillsOffered(last.offered) };
51
+ }
52
+ if (word !== "on" && word !== "off") return { text: SKILLS_SUGGEST_USAGE };
53
+ await config.writeSession({ ...await config.readSession(), [SKILLS_SUGGEST_CONFIG_KEY]: word });
54
+ return { text: suggestSet(word === "on", decision.available()) };
15
55
  }
16
56
 
17
57
  /** `/skills [list|attach <path>|detach <n>]`, from the command's raw tokens. */
@@ -22,30 +62,32 @@ export async function runSkills(tokens: string[], deps: SkillsDeps): Promise<Com
22
62
  switch ((sub ?? "list").toLowerCase()) {
23
63
  case "list":
24
64
  if (skills.length === 0) {
25
- return { text: "no skills attached. usage: /skills attach <workspace path to a .md playbook>" };
65
+ return { text: NO_SKILLS };
26
66
  }
27
67
  return { table: skills.map((p, i) => ({ n: i + 1, path: String(p) })) };
28
68
  case "attach": {
29
- if (!arg) return { text: "usage: /skills attach <path>" };
69
+ if (!arg) return { text: SKILLS_ATTACH_USAGE };
30
70
  try {
31
71
  await files.read(arg, 1);
32
72
  } catch {
33
- return { text: `cannot attach '${arg}' โ€” the file is not readable in the mounted workspace.` };
73
+ return { text: cannotAttach(arg) };
34
74
  }
35
75
  if (!skills.includes(arg)) skills.push(arg);
36
76
  await writeJson(session, SKILLS_STATE_KEY, skills);
37
- return { text: `skill attached: ${arg} (${skills.length} attached; /clear clears).` };
77
+ return { text: skillAttached(arg, skills.length) };
38
78
  }
39
79
  case "detach": {
40
80
  const n = Number(arg);
41
81
  if (!Number.isInteger(n) || n < 1 || n > skills.length) {
42
- return { text: `usage: /skills detach <1-${skills.length || 1}>` };
82
+ return { text: skillsDetachUsage(skills.length || 1) };
43
83
  }
44
84
  const [removed] = skills.splice(n - 1, 1);
45
85
  await writeJson(session, SKILLS_STATE_KEY, skills);
46
- return { text: `skill detached: ${removed}` };
86
+ return { text: skillDetached(removed) };
47
87
  }
88
+ case "suggest":
89
+ return runSuggest((arg ?? "").toLowerCase(), deps);
48
90
  default:
49
- return { text: "usage: /skills [list|attach <path>|detach <n>]" };
91
+ return { text: SKILLS_USAGE };
50
92
  }
51
93
  }
@@ -0,0 +1,42 @@
1
+ // /theme [<name>|show]: the console's palette for this session. The start palette is the setting Orkeon:Cli:Tui:Theme.
2
+ import type { Chooser, ThemeConsole, ThemeName } from "../../../shared/application/ports.ts";
3
+ import type { CommandView } from "../view.ts";
4
+ import { optionsOf } from "./choices.ts";
5
+ import { NO_PALETTES, THEME_CHOICE, themeSet, themeShown, themeUnchanged, unknownTheme } from "./messages.ts";
6
+
7
+ const THEMES: readonly ThemeName[] = ["dark", "light", "none"];
8
+
9
+ export interface ThemeDeps {
10
+ console: ThemeConsole;
11
+ /** Where a bare /theme opens a panel, when it can. */
12
+ chooser?: Chooser;
13
+ }
14
+
15
+ const isTheme = (token: string): token is ThemeName => (THEMES as readonly string[]).includes(token);
16
+
17
+ /** `/theme [<name>|show]`, from the command's raw tokens. No argument opens a panel, or without one shows the palette,
18
+ * as `show` does. */
19
+ export async function runTheme(tokens: string[], deps: ThemeDeps): Promise<CommandView> {
20
+ const { console, chooser } = deps;
21
+ const requested = (tokens[0] ?? "").toLowerCase();
22
+ if (requested && requested !== "show" && !isTheme(requested)) {
23
+ return { text: unknownTheme(requested, THEMES) };
24
+ }
25
+ const current = console.theme;
26
+ if (current === null) return { text: NO_PALETTES };
27
+
28
+ if (isTheme(requested)) return setTheme(console, requested);
29
+ if (!requested && chooser?.interactive) {
30
+ const answer = await chooser.choose({
31
+ message: THEME_CHOICE,
32
+ options: optionsOf(THEMES, current),
33
+ });
34
+ return answer ? setTheme(console, answer.value as ThemeName) : { text: themeUnchanged(current) };
35
+ }
36
+ return { text: themeShown(current, THEMES) };
37
+ }
38
+
39
+ function setTheme(console: ThemeConsole, name: ThemeName): CommandView {
40
+ if (!console.setTheme(name)) return { text: NO_PALETTES };
41
+ return { text: themeSet(name) };
42
+ }
@@ -0,0 +1,58 @@
1
+ // The text /say, /transcribe and /voice show the user (ADR 0026): their usage, their refusals and what a completion
2
+ // prints. Read by say.ts, transcribe.ts and voice.ts.
3
+
4
+ export const SAY_USAGE = "usage: /say [<text>] [--voice <voice>]\n /say --stop";
5
+
6
+ export const TRANSCRIBE_USAGE =
7
+ 'usage: /transcribe <file> [--lang <code>] [--prompt "<words>"] [--then "<instruction>"]\n' +
8
+ " /transcribe --list";
9
+
10
+ export const VOICE_USAGE =
11
+ 'usage: /voice [--go] [--lang <code>] [--prompt "<words>"] [--max <seconds>] [--silence <seconds>]\n' +
12
+ " /voice send";
13
+
14
+ // The refusals of a bad line
15
+ export const unknownArgument = (word: string) => `unknown argument ${word}`;
16
+ export const VOICE_NEEDS_NAME = "--voice needs a voice name (fr_FR-siwis-medium, en_US-lessac-medium...)";
17
+ export const STOP_ALONE = "--stop takes nothing else";
18
+ export const NAME_A_FILE = "name a file under /audio (/transcribe --list shows them)";
19
+ export const oneFileAtATime = (file: string, word: string) =>
20
+ `one file at a time (${file}, ${word}): quote a name that holds a space`;
21
+ export const needsLanguageCode = (option: string) => `${option} needs a language code (fr, en...)`;
22
+ export const PROMPT_NEEDS_WORDS = '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")';
23
+ export const THEN_NEEDS_INSTRUCTION = "--then needs an instruction";
24
+ export const LIST_ALONE = "--list takes no file and no option";
25
+ export const SEND_ALONE = "send takes no option and no quotes: /voice send sends the last dictation";
26
+ export const secondsBetween = (option: string, min: number, max: number) =>
27
+ `${option} takes seconds between ${min} and ${max}`;
28
+
29
+ /** The line that says what to do when the server's tools are not registered. */
30
+ export function missingToolMessage(tool: string): string {
31
+ return (
32
+ `no registered tool '${tool}': the Whisper MCP server is not connected. Start orkeon-code with ` +
33
+ "ORKEON_CODE_AUDIO_DIR set (docs/configuration.md, Speech-to-text); /debug-tool-call list shows what this host registers."
34
+ );
35
+ }
36
+
37
+ // /say
38
+ export const STOPPED = "stopped";
39
+ export const toolFailed = (tool: string, failure: string) => `โœ— ${tool}: ${failure}`;
40
+ export const lastAnswerUnreadable = (reason: string) => `cannot read the session's last answer: ${reason}`;
41
+ export const NOTHING_TO_READ = "nothing to read: give a text, or ask the assistant first (/say alone reads its last answer)";
42
+ export const TEXT_READ_ALOUD = "text read aloud";
43
+ export const LAST_ANSWER_READ_ALOUD = "last answer read aloud";
44
+
45
+ // /transcribe
46
+ export const filesUnder = (root: string) => `the files under ${root}`;
47
+ export const transcriptionOf = (path: string) => `transcription of ${path}`;
48
+
49
+ // /voice
50
+ export const recordingLine = (silenceSeconds: number, maxSeconds: number, go: boolean) =>
51
+ `๐ŸŽ™ recording: speak, then stay silent ${silenceSeconds} s to stop (${maxSeconds} s at most)` +
52
+ (go ? "; the text goes straight to the assistant" : "");
53
+ export const noDictationToSend = (file: string) => `no dictation to send: /voice records one (it is kept in ${file})`;
54
+ export const cannotRead = (file: string, reason: string) => `cannot read ${file}: ${reason}`;
55
+ export const voiceFailed = (error: string) => `โœ— voice failed: ${error}`;
56
+ export const NOTHING_HEARD = "nothing was heard: /voice records again";
57
+ export const dictationLine = (payload: string) => `๐ŸŽ™ ${payload}`;
58
+ export const DICTATION_NEXT = "send it: /voice send ยท edit it: /assistant <text> ยท record again: /voice";
@@ -0,0 +1,4 @@
1
+ // The text /transcribe hands the model (ADR 0026): the label of the transcription a --then turn reads first.
2
+
3
+ export const transcriptionPreludeLabel = (path: string) =>
4
+ `Transcription of ${path}, made by /transcribe before this request`;
@@ -15,12 +15,11 @@ import { SPEAK_TOOL } from "../../../shared/domain/speech.ts";
15
15
  import { commandLine, isOption, optionValue, splitWords } from "../args.ts";
16
16
  import { launchCrew, withLlmProfile } from "../dispatch.ts";
17
17
  import type { CommandLog, LaunchDeps, LaunchResult } from "../dispatch.ts";
18
- import { missingToolMessage } from "./transcribe.ts";
18
+ import { LAST_ANSWER_READ_ALOUD, NOTHING_TO_READ, SAY_USAGE, STOP_ALONE, STOPPED, TEXT_READ_ALOUD, VOICE_NEEDS_NAME, lastAnswerUnreadable, missingToolMessage, toolFailed } from "./messages.ts";
19
+ import { unknownOption } from "../messages.ts";
19
20
 
20
21
  export const STOP_TOOL = "stop_speaking";
21
22
 
22
- export const SAY_USAGE = "usage: /say [<text>] [--voice <voice>]\n /say --stop";
23
-
24
23
  export type SayRequest = { kind: "stop" } | { kind: "say"; text: string; voice: string };
25
24
 
26
25
  export type ParsedSay = { ok: true; request: SayRequest } | { ok: false; error: string };
@@ -38,12 +37,12 @@ export function parseSayArgs(tokens: readonly string[]): ParsedSay {
38
37
  text.push(word);
39
38
  } else if (word === "--voice") {
40
39
  const value = optionValue(words, i++);
41
- if (value === null) return { ok: false, error: "--voice needs a voice name (fr_FR-siwis-medium, en_US-lessac-medium...)" };
40
+ if (value === null) return { ok: false, error: VOICE_NEEDS_NAME };
42
41
  voice = value;
43
42
  } else if (word === "--stop") {
44
- return { ok: false, error: "--stop takes nothing else" };
43
+ return { ok: false, error: STOP_ALONE };
45
44
  } else {
46
- return { ok: false, error: `unknown option ${word}` };
45
+ return { ok: false, error: unknownOption(word) };
47
46
  }
48
47
  }
49
48
  return { ok: true, request: { kind: "say", text: text.join(" ").trim(), voice } };
@@ -75,7 +74,7 @@ export async function dispatchSay(tokens: readonly string[], deps: SayDeps): Pro
75
74
  const stop = deps.catalogue.find(STOP_TOOL);
76
75
  if (stop === undefined) return { message: missingToolMessage(STOP_TOOL) };
77
76
  const outcome = await deps.catalogue.callText(stop, {});
78
- return { message: outcome.ok ? (outcome.text || "stopped") : `โœ— ${STOP_TOOL}: ${outcome.failure}` };
77
+ return { message: outcome.ok ? (outcome.text || STOPPED) : toolFailed(STOP_TOOL, outcome.failure) };
79
78
  }
80
79
  const speak = deps.catalogue.find(SPEAK_TOOL);
81
80
  if (speak === undefined) return { message: missingToolMessage(SPEAK_TOOL) };
@@ -84,13 +83,13 @@ export async function dispatchSay(tokens: readonly string[], deps: SayDeps): Pro
84
83
  try {
85
84
  text = lastAnswer((await deps.session.readMessages()).messages);
86
85
  } catch (error) {
87
- return { message: `cannot read the session's last answer: ${errorText(error)}` };
86
+ return { message: lastAnswerUnreadable(errorText(error)) };
88
87
  }
89
88
  }
90
- if (!text) return { message: "nothing to read: give a text, or ask the assistant first (/say alone reads its last answer)" };
89
+ if (!text) return { message: NOTHING_TO_READ };
91
90
  const args: Record<string, unknown> = { text };
92
91
  if (request.voice) args.voice = request.voice;
93
- return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: speak, args, label: request.text ? "text read aloud" : "last answer read aloud" }, {
92
+ return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: speak, args, label: request.text ? TEXT_READ_ALOUD : LAST_ANSWER_READ_ALOUD }, {
94
93
  characters: text.length, ...(request.voice ? { voice: request.voice } : {}),
95
94
  });
96
95
  }
@@ -12,15 +12,14 @@ import type { PreludeCall } from "../../../shared/domain/prelude.ts";
12
12
  import { commandLine, isOption, optionValue, parseAssistantInput, splitWords } from "../args.ts";
13
13
  import { launchCrew, launchMainLoop, withLlmProfile } from "../dispatch.ts";
14
14
  import type { LaunchResult, MainLoopLaunchDeps } from "../dispatch.ts";
15
+ import { LIST_ALONE, NAME_A_FILE, PROMPT_NEEDS_WORDS, THEN_NEEDS_INSTRUCTION, TRANSCRIBE_USAGE, filesUnder, missingToolMessage, needsLanguageCode, oneFileAtATime, transcriptionOf } from "./messages.ts";
16
+ import { unknownOption } from "../messages.ts";
17
+ import { transcriptionPreludeLabel } from "./prompts.ts";
15
18
 
16
19
  export const TRANSCRIBE_TOOL = "transcribe_audio";
17
20
  export const LIST_AUDIO_TOOL = "list_audio";
18
21
  export const AUDIO_ROOT = "/audio";
19
22
 
20
- export const TRANSCRIBE_USAGE =
21
- 'usage: /transcribe <file> [--lang <code>] [--prompt "<words>"] [--then "<instruction>"]\n' +
22
- " /transcribe --list";
23
-
24
23
  /** What /transcribe was asked: the listing of /audio, or one file. */
25
24
  export type TranscribeRequest =
26
25
  | { kind: "list" }
@@ -50,45 +49,37 @@ export function parseTranscribeArgs(tokens: readonly string[]): ParsedTranscribe
50
49
  for (let i = 0; i < words.length; i++) {
51
50
  const word = words[i].text;
52
51
  if (!isOption(words[i])) {
53
- if (word.trim().length === 0) return { ok: false, error: "name a file under /audio (/transcribe --list shows them)" };
54
- if (file !== null) return { ok: false, error: `one file at a time (${file}, ${word}): quote a name that holds a space` };
52
+ if (word.trim().length === 0) return { ok: false, error: NAME_A_FILE };
53
+ if (file !== null) return { ok: false, error: oneFileAtATime(file, word) };
55
54
  file = word;
56
55
  } else if (word === "--list") {
57
56
  list = true;
58
57
  } else if (word === "--lang" || word === "--language") {
59
58
  const value = optionValue(words, i++);
60
- if (value === null) return { ok: false, error: `${word} needs a language code (fr, en...)` };
59
+ if (value === null) return { ok: false, error: needsLanguageCode(word) };
61
60
  language = value;
62
61
  } else if (word === "--prompt") {
63
62
  const value = optionValue(words, i++);
64
- if (value === null) return { ok: false, error: '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")' };
63
+ if (value === null) return { ok: false, error: PROMPT_NEEDS_WORDS };
65
64
  vocabulary = value;
66
65
  } else if (word === "--then") {
67
66
  // One quoted instruction loses its quotes; otherwise the rest is kept as typed, quotes included.
68
67
  const rest = words.slice(i + 1);
69
68
  then = (rest.length === 1 ? rest[0].text : line.slice(words[i].end)).trim();
70
- if (then.length === 0) return { ok: false, error: "--then needs an instruction" };
69
+ if (then.length === 0) return { ok: false, error: THEN_NEEDS_INSTRUCTION };
71
70
  break;
72
71
  } else {
73
- return { ok: false, error: `unknown option ${word}` };
72
+ return { ok: false, error: unknownOption(word) };
74
73
  }
75
74
  }
76
75
  if (list) {
77
- if (file !== null || then !== null || language || vocabulary) return { ok: false, error: "--list takes no file and no option" };
76
+ if (file !== null || then !== null || language || vocabulary) return { ok: false, error: LIST_ALONE };
78
77
  return { ok: true, request: { kind: "list" } };
79
78
  }
80
- if (file === null) return { ok: false, error: "name a file under /audio (/transcribe --list shows them)" };
79
+ if (file === null) return { ok: false, error: NAME_A_FILE };
81
80
  return { ok: true, request: { kind: "file", path: audioPath(file), language, vocabulary, then } };
82
81
  }
83
82
 
84
- /** The line that says what to do when the server's tools are not registered. */
85
- export function missingToolMessage(tool: string): string {
86
- return (
87
- `no registered tool '${tool}': the Whisper MCP server is not connected. Start orkeon-code with ` +
88
- "ORKEON_CODE_AUDIO_DIR set (docs/configuration.md, Speech-to-text); /debug-tool-call list shows what this host registers."
89
- );
90
- }
91
-
92
83
  /** The arguments of transcribe_audio for a file request (the server's parameter names). */
93
84
  export function transcribeCall(registered: string, request: Extract<TranscribeRequest, { kind: "file" }>, label: string): PreludeCall {
94
85
  const args: Record<string, unknown> = { path: request.path };
@@ -118,13 +109,13 @@ export async function dispatchTranscribe(
118
109
  const registered = deps.catalogue.find(wanted);
119
110
  if (registered === undefined) return { message: missingToolMessage(wanted) };
120
111
  if (request.kind === "list") {
121
- return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: registered, args: {}, label: `the files under ${AUDIO_ROOT}` });
112
+ return launchCrew(await withLlmProfile(deps, deps.config), "speech", { tool: registered, args: {}, label: filesUnder(AUDIO_ROOT) });
122
113
  }
123
114
  if (request.then === null) {
124
- const call = transcribeCall(registered, request, `transcription of ${request.path}`);
115
+ const call = transcribeCall(registered, request, transcriptionOf(request.path));
125
116
  return launchCrew(await withLlmProfile(deps, deps.config), "speech", { ...call }, call.args);
126
117
  }
127
118
  const { prompt, permissionMode } = parseAssistantInput(request.then);
128
- const prelude = transcribeCall(registered, request, `Transcription of ${request.path}, made by /transcribe before this request`);
119
+ const prelude = transcribeCall(registered, request, transcriptionPreludeLabel(request.path));
129
120
  return await launchMainLoop(deps, { prompt, permissionMode, prelude });
130
121
  }
@@ -15,17 +15,14 @@ import { errorText, nothingReturned } from "../../../shared/domain/prelude.ts";
15
15
  import { commandLine, isOption, optionValue, parseAssistantInput, splitWords } from "../args.ts";
16
16
  import { launchCrew, launchMainLoop, withLlmProfile } from "../dispatch.ts";
17
17
  import type { CrewCompletion, LaunchResult, MainLoopLaunchDeps } from "../dispatch.ts";
18
- import { missingToolMessage } from "./transcribe.ts";
18
+ import { DICTATION_NEXT, NOTHING_HEARD, PROMPT_NEEDS_WORDS, SEND_ALONE, VOICE_USAGE, cannotRead, dictationLine, missingToolMessage, needsLanguageCode, noDictationToSend, recordingLine, secondsBetween, unknownArgument, voiceFailed } from "./messages.ts";
19
+ import { unknownOption } from "../messages.ts";
19
20
 
20
21
  export const RECORD_TOOL = "record_and_transcribe";
21
22
  export const DICTATION_FILE = "/transcripts/dictation.txt";
22
23
  const DEFAULT_MAX_SECONDS = 60;
23
24
  const DEFAULT_SILENCE_SECONDS = 2;
24
25
 
25
- export const VOICE_USAGE =
26
- 'usage: /voice [--go] [--lang <code>] [--prompt "<words>"] [--max <seconds>] [--silence <seconds>]\n' +
27
- " /voice send";
28
-
29
26
  export type VoiceRequest =
30
27
  | { kind: "record"; go: boolean; language: string; vocabulary: string; maxSeconds: number; silenceSeconds: number }
31
28
  | { kind: "send" };
@@ -35,7 +32,7 @@ export type ParsedVoice = { ok: true; request: VoiceRequest } | { ok: false; err
35
32
  /** A number option within bounds, or the reason it is not one. */
36
33
  function seconds(option: string, value: string | null, min: number, max: number): number | string {
37
34
  const n = value === null ? Number.NaN : Number(value);
38
- if (!Number.isFinite(n) || n < min || n > max) return `${option} takes seconds between ${min} and ${max}`;
35
+ if (!Number.isFinite(n) || n < min || n > max) return secondsBetween(option, min, max);
39
36
  return n;
40
37
  }
41
38
 
@@ -50,17 +47,17 @@ export function parseVoiceArgs(tokens: readonly string[]): ParsedVoice {
50
47
  for (let i = 0; i < words.length; i++) {
51
48
  const word = words[i].text;
52
49
  if (!isOption(words[i])) {
53
- if (word === "send") return { ok: false, error: "send takes no option and no quotes: /voice send sends the last dictation" };
54
- return { ok: false, error: `unknown argument ${word}` };
50
+ if (word === "send") return { ok: false, error: SEND_ALONE };
51
+ return { ok: false, error: unknownArgument(word) };
55
52
  } else if (word === "--go") {
56
53
  request.go = true;
57
54
  } else if (word === "--lang" || word === "--language") {
58
55
  const value = optionValue(words, i++);
59
- if (value === null) return { ok: false, error: `${word} needs a language code (fr, en...)` };
56
+ if (value === null) return { ok: false, error: needsLanguageCode(word) };
60
57
  request.language = value;
61
58
  } else if (word === "--prompt") {
62
59
  const value = optionValue(words, i++);
63
- if (value === null) return { ok: false, error: '--prompt needs the words the speech may contain, quoted ("Orkeon, Jint, MCP")' };
60
+ if (value === null) return { ok: false, error: PROMPT_NEEDS_WORDS };
64
61
  request.vocabulary = value;
65
62
  } else if (word === "--max" || word === "--silence") {
66
63
  const value = optionValue(words, i++);
@@ -69,7 +66,7 @@ export function parseVoiceArgs(tokens: readonly string[]): ParsedVoice {
69
66
  if (word === "--max") request.maxSeconds = parsed;
70
67
  else request.silenceSeconds = parsed;
71
68
  } else {
72
- return { ok: false, error: `unknown option ${word}` };
69
+ return { ok: false, error: unknownOption(word) };
73
70
  }
74
71
  }
75
72
  return { ok: true, request };
@@ -85,8 +82,7 @@ export function recordArgs(request: Extract<VoiceRequest, { kind: "record" }>):
85
82
 
86
83
  /** The line shown when the microphone opens. */
87
84
  export function recordingNotice(request: Extract<VoiceRequest, { kind: "record" }>): string {
88
- return `๐ŸŽ™ recording: speak, then stay silent ${request.silenceSeconds} s to stop (${request.maxSeconds} s at most)` +
89
- (request.go ? "; the text goes straight to the assistant" : "");
85
+ return recordingLine(request.silenceSeconds, request.maxSeconds, request.go);
90
86
  }
91
87
 
92
88
  /** What /voice reads and drives: the registered tools, the files (the last dictation, for
@@ -97,7 +93,7 @@ export type VoiceDeps = MainLoopLaunchDeps & {
97
93
  out: { writeLine(text: string): void };
98
94
  };
99
95
 
100
- const NOTHING_TO_SEND = `no dictation to send: /voice records one (it is kept in ${DICTATION_FILE})`;
96
+ const NOTHING_TO_SEND = noDictationToSend(DICTATION_FILE);
101
97
 
102
98
  /** Launch what the request asks and return its ticket, or the message to show when it launches nothing. */
103
99
  export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps): Promise<LaunchResult | { message: string }> {
@@ -111,7 +107,7 @@ export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps):
111
107
  } catch (error) {
112
108
  // A missing file is the common case (no dictation yet); the runtime's read says so, as json-file.ts reads it.
113
109
  if (/not found|no such|does not exist/i.test(errorText(error))) return { message: NOTHING_TO_SEND };
114
- return { message: `cannot read ${DICTATION_FILE}: ${errorText(error)}` };
110
+ return { message: cannotRead(DICTATION_FILE, errorText(error)) };
115
111
  }
116
112
  if (text.length === 0) return { message: NOTHING_TO_SEND };
117
113
  const { prompt, permissionMode } = parseAssistantInput(text);
@@ -135,12 +131,12 @@ export async function dispatchVoice(tokens: readonly string[], deps: VoiceDeps):
135
131
  * "script-host", and the crew's name as the intent).
136
132
  */
137
133
  export function renderVoiceCompletion(result: CrewCompletion & { agent?: string; intent?: string }): string[] {
138
- if (!result.success) return [`โœ— voice failed: ${result.error ?? "unknown"}`];
134
+ if (!result.success) return [voiceFailed(result.error ?? "unknown")];
139
135
  const payload = (result.payload ?? "").trim();
140
136
  if (result.intent !== "speech") return [payload];
141
137
  // The crew names the tool as the host registers it: compared case aside.
142
138
  if (payload.length === 0 || payload.toLowerCase() === nothingReturned(RECORD_TOOL).toLowerCase()) {
143
- return ["nothing was heard: /voice records again"];
139
+ return [NOTHING_HEARD];
144
140
  }
145
- return [`๐ŸŽ™ ${payload}`, "send it: /voice send ยท edit it: /assistant <text> ยท record again: /voice"];
141
+ return [dictationLine(payload), DICTATION_NEXT];
146
142
  }