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,147 @@
1
+ // /effort [<level>|show]: the session's reasoning-effort level. It picks the act() iteration ladder of every later
2
+ // /assistant turn and reaches the provider as `act({effort})`. What the session's model takes, and what the runtime
3
+ // sends for a level it does not take, are read from the runtime (Orkeon #359, #360), never worked out here: the
4
+ // level stored stays the one asked, since the ladder follows it and the model may change.
5
+ import type { Chooser, ReasoningReader } from "../../../shared/application/ports.ts";
6
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
7
+ import { readLlmProfile } from "../../../shared/application/llm-profile.ts";
8
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
9
+ import {
10
+ DEFAULT_EFFORT, EFFORT_LEVELS as LEVELS, EFFORT_MAX_ITERATIONS, providerEffort,
11
+ } from "../../../shared/domain/agent-policy/behavior-flags.ts";
12
+ import type { EffortLevel } from "../../../shared/domain/agent-policy/behavior-flags.ts";
13
+ import type { EffortReport, ReasoningCapabilities, ReasoningTarget } from "../../../shared/domain/agent-policy/reasoning.ts";
14
+ import { EFFORT_STATE_KEY, MODEL_PREFERENCE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
15
+ import type { CommandView } from "../view.ts";
16
+ import { optionsOf } from "./choices.ts";
17
+ import {
18
+ EFFORT_CHOICE, EFFORT_UNCHANGED, NONE_SENT, THINKING_NOT_REQUESTED, actIterations, effortDropped, effortLowered,
19
+ effortSet, effortShown, effortUnchangedNoneStored, effortUnchecked, effortWarning, effortWarningDevSteps, hostAsks, itTakes, modelTakes, sentAs,
20
+ thinkingAt, thinkingDevSteps, unknownEffort,
21
+ } from "./messages.ts";
22
+ import { markedDefault as defaultLevel } from "../messages.ts";
23
+
24
+ export interface EffortDeps {
25
+ session: Pick<SessionIo, "readState" | "writeState">;
26
+ /** Where a bare /effort opens a panel, when it can. */
27
+ chooser?: Chooser;
28
+ /** What the session's model takes and what a level becomes on it; absent, or answering nothing: nothing is said. */
29
+ reasoning?: ReasoningReader;
30
+ /** Where the session's `llm.profile` is read: under a profile, its model is the one judged. */
31
+ config?: Pick<ConfigStore, "readValue" | "readFile">;
32
+ }
33
+
34
+ type TargetDeps = { session: Pick<SessionIo, "readState"> } & Pick<EffortDeps, "config">;
35
+
36
+ /** What the session's turns run on: its `llm.profile`, else its /model override, else the host's own model. */
37
+ async function sessionTarget(deps: TargetDeps): Promise<ReasoningTarget> {
38
+ const [model, profile] = await Promise.all([
39
+ deps.session.readState(MODEL_PREFERENCE_STATE_KEY).catch(() => null),
40
+ deps.config === undefined ? null : readLlmProfile(deps.config).then((read) => read.profile),
41
+ ]);
42
+ return { profile, model: (model ?? "").trim() };
43
+ }
44
+
45
+ /** The host's own model: under a /model override, the dev steps and the sub-agents still run on it. */
46
+ const HOST_TARGET: ReasoningTarget = { profile: null, model: "" };
47
+
48
+ /** Whether the turns run on a /model override: no profile, which would win over it, and a model named. */
49
+ function overridden(target: ReasoningTarget): boolean {
50
+ return target.profile === null && target.model !== "";
51
+ }
52
+
53
+ /** What to say of an effort that does not go as asked; empty when it does, or when the runtime did not say. */
54
+ export function effortNote(report: EffortReport | null, capabilities: ReasoningCapabilities | null): string {
55
+ if (report === null || report.notice === null) return "";
56
+ if (report.notice === "unchecked") return effortUnchecked(report.model, report.asked);
57
+ const takes = capabilities !== null && capabilities.known ? itTakes(capabilities.efforts) : "";
58
+ if (report.sent !== null) return effortLowered(report.model, report.asked, report.sent) + takes;
59
+ // A level the model takes is dropped by the provider or the host's settings (its thinking switched off): the
60
+ // model's levels would read as the cause, so they are left out.
61
+ const taken = capabilities !== null && capabilities.efforts.includes(report.asked);
62
+ return effortDropped(report.model, report.asked) + (taken ? "" : takes);
63
+ }
64
+
65
+ /** `effortNote` without the model the table does not know: that one is `show`'s to say, since most hosts serve
66
+ * some. */
67
+ export function effortWarningNote(report: EffortReport | null, capabilities: ReasoningCapabilities | null): string {
68
+ return report?.notice === "unchecked" ? "" : effortNote(report, capabilities);
69
+ }
70
+
71
+ /** The warning lines for the effort the session stored, on what it reaches; empty when no level is stored or the
72
+ * level goes out as asked, checked or not. The turns of /assistant run on the session's target; under a /model
73
+ * override the dev steps and the sub-agents still run on the host's own model, so that one is judged too, and
74
+ * said when its line differs. /model says it after a switch. */
75
+ export async function storedEffortWarning(deps: TargetDeps & Pick<EffortDeps, "reasoning">): Promise<string> {
76
+ const { reasoning } = deps;
77
+ if (reasoning === undefined) return "";
78
+ const level = providerEffort(await deps.session.readState(EFFORT_STATE_KEY).catch(() => null));
79
+ if (level === undefined) return "";
80
+ const target = await sessionTarget(deps);
81
+ const targets = overridden(target) ? [target, HOST_TARGET] : [target];
82
+ const [turns, devSteps] = targets.map((each) => effortWarningNote(reasoning.effort(each, level), reasoning.capabilities(each)));
83
+ const lines = [turns === "" ? "" : effortWarning(turns)];
84
+ if (devSteps !== undefined && devSteps !== "" && devSteps !== turns) lines.push(effortWarningDevSteps(devSteps));
85
+ return lines.filter((line) => line !== "").join("\n");
86
+ }
87
+
88
+ /** The thinking line of `show`: the level asked, then what does not go as asked, else the levels the model takes.
89
+ * Under a /model override, a second line for the host's own model, which the dev steps and the sub-agents keep,
90
+ * when the level (the one stored, else the host's own) does not go as asked there and not the way the first says. */
91
+ function thinkingShown(stored: EffortLevel | undefined, reasoning: ReasoningReader | undefined, target: ReasoningTarget): string {
92
+ const capabilities = reasoning?.capabilities(target) ?? null;
93
+ const takes = capabilities !== null && capabilities.known ? `; ${modelTakes(capabilities.model, capabilities.efforts)}` : "";
94
+ // With no level stored, the host's own `Llm:Thinking:Effort` goes out on every call all the same.
95
+ const report = reasoning?.effort(target, stored ?? null) ?? null;
96
+ const note = effortNote(report, capabilities);
97
+ const asked = stored !== undefined ? thinkingAt(stored) : report === null ? THINKING_NOT_REQUESTED : hostAsks(report.asked);
98
+ const line = asked + (note === "" ? takes : ` — ${note}`);
99
+ if (reasoning === undefined || !overridden(target)) return line;
100
+ const hostNote = effortNote(reasoning.effort(HOST_TARGET, stored ?? null), reasoning.capabilities(HOST_TARGET));
101
+ return hostNote === "" || hostNote === note ? line : line + thinkingDevSteps(hostNote);
102
+ }
103
+
104
+ /** What a level of the panel becomes on the session's model, after its iterations; empty when it goes as asked. */
105
+ function becomes(report: EffortReport | null): string {
106
+ if (report === null || report.notice === null || report.notice === "unchecked") return "";
107
+ return report.sent === null ? NONE_SENT : sentAs(report.sent);
108
+ }
109
+
110
+ /** `/effort [<level>|show]`, from the command's raw tokens. No argument opens a panel, or without one shows the level,
111
+ * as `show` does. */
112
+ export async function runEffort(tokens: string[], deps: EffortDeps): Promise<CommandView> {
113
+ const requested = (tokens[0] ?? "").toLowerCase();
114
+ if (!requested || requested === "show") {
115
+ const stored = await deps.session.readState(EFFORT_STATE_KEY).catch(() => null);
116
+ const target = await sessionTarget(deps);
117
+ if (!requested && deps.chooser?.interactive) {
118
+ const answer = await deps.chooser.choose({
119
+ message: EFFORT_CHOICE,
120
+ options: LEVELS.map((level) => ({
121
+ ...optionsOf([level], stored ?? DEFAULT_EFFORT)[0],
122
+ description: actIterations(EFFORT_MAX_ITERATIONS[level]) + becomes(deps.reasoning?.effort(target, level) ?? null),
123
+ })),
124
+ });
125
+ if (!answer) return { text: EFFORT_UNCHANGED };
126
+ // Confirming the level marked changes nothing: with none stored, it would ask the provider for thinking.
127
+ if (answer.value === (stored ?? DEFAULT_EFFORT)) {
128
+ return {
129
+ text: stored ? EFFORT_UNCHANGED : effortUnchangedNoneStored(answer.value),
130
+ };
131
+ }
132
+ return runEffort([answer.value], { ...deps, chooser: undefined });
133
+ }
134
+ const level = stored ?? defaultLevel(DEFAULT_EFFORT);
135
+ const ladder = LEVELS.map((l) => `${l}=${EFFORT_MAX_ITERATIONS[l]}`).join(", ");
136
+ return { text: effortShown(level, ladder, thinkingShown(providerEffort(stored), deps.reasoning, target), LEVELS) };
137
+ }
138
+ if (!LEVELS.includes(requested as (typeof LEVELS)[number])) {
139
+ return { text: unknownEffort(requested, LEVELS) };
140
+ }
141
+ await deps.session.writeState(EFFORT_STATE_KEY, requested);
142
+ // Says what it buys: the iterations, and the provider's thinking at that level; then what the session's model
143
+ // makes of that level, when it does not take it.
144
+ const warning = await storedEffortWarning(deps);
145
+ const text = effortSet(requested, EFFORT_MAX_ITERATIONS[requested as (typeof LEVELS)[number]]);
146
+ return { text: warning === "" ? text : `${text}\n${warning}` };
147
+ }
@@ -1,23 +1,18 @@
1
1
  // /hooks — the session's hook registry (session state): list, add, remove. The dev steps (/dev-spec, /dev-plan and
2
2
  // /dev-batches, and a /tasks repair) hand it to their crew, whose tool callbacks
3
- // (shared/application/dev/tool-callbacks.ts) run each pre-tool hook before a model's tool call the gate allowed
4
- // (a failing hook refuses the call) and each post-tool hook after it (a failing one adds a line to the result). The
3
+ // (shared/application/dev/tool-callbacks.ts) run each pre-tool hook before a model's tool call, ahead of the host's gate
4
+ // (Orkeon #303; a failing hook refuses the call) and each post-tool hook after it (a failing one adds a line to the result). The
5
5
  // assistant does not run them yet, and nothing runs a stop hook. Not a command file: the loader reads *.cmd.ts only.
6
6
  import type { SessionStore } from "../../../shared/application/ports.ts";
7
7
  import { readJsonArray, writeJson } from "../../../shared/application/session-state.ts";
8
8
  import { shellOperatorIn } from "../../../shared/domain/dev/call-guard.ts";
9
9
  import { HOOKS_STATE_KEY } from "../../../shared/domain/session-keys.ts";
10
+ import {
11
+ HOOKS_STATUS, HOOKS_USAGE, NO_HOOKS, hookAdded, hookOperatorRefused, hookRemoved, hooksAddUsage, hooksRemoveUsage,
12
+ } from "./messages.ts";
10
13
 
11
14
  export const HOOK_EVENTS = ["pre-tool", "post-tool", "stop"] as const;
12
15
 
13
- /** Where the hooks run, said on every listing: a populated registry is exactly when someone
14
- * believes they all run. */
15
- export const HOOKS_STATUS =
16
- "pre-tool and post-tool hooks run around each tool call the model makes in the dev steps (/dev-spec, " +
17
- "/dev-plan, /dev-batches) and a /tasks repair (a failing pre-tool hook refuses the call); " +
18
- "the assistant does not run " +
19
- "them yet, and no stop hook runs.";
20
-
21
16
  export interface HookRow { n: number; event: string; command: string }
22
17
 
23
18
  /** What /hooks shows: a table of the hooks when it lists some, then its text. */
@@ -28,31 +23,28 @@ export async function runHooks(tokens: readonly string[], session: Pick<SessionS
28
23
  const hooks = (await readJsonArray(session, HOOKS_STATE_KEY)) as Array<{ event: string; command: string }>;
29
24
  switch ((sub ?? "list").toLowerCase()) {
30
25
  case "list":
31
- if (hooks.length === 0) return { text: `no hooks configured. usage: /hooks add <pre-tool|post-tool|stop> <command>\n${HOOKS_STATUS}` };
26
+ if (hooks.length === 0) return { text: NO_HOOKS };
32
27
  return { table: hooks.map((h, i) => ({ n: i + 1, event: h.event, command: h.command })), text: HOOKS_STATUS };
33
28
  case "add": {
34
29
  const command = rest.join(" ");
35
- if (!(HOOK_EVENTS as readonly string[]).includes(String(event)) || !command) return { text: `usage: /hooks add <${HOOK_EVENTS.join("|")}> <command>` };
30
+ if (!(HOOK_EVENTS as readonly string[]).includes(String(event)) || !command) return { text: hooksAddUsage(HOOK_EVENTS) };
36
31
  // The shell tool runs one program and its arguments: the hook would fail at every call.
37
32
  const operator = shellOperatorIn(command);
38
33
  if (operator !== undefined) {
39
- return {
40
- text: `refused: the command holds '${operator.replace(/\n/g, "\\n")}', which the shell tool refuses: a hook is one program ` +
41
- "and its arguments. Put the steps in a script: /hooks add pre-tool node .orkeon/hooks/pre.mjs {tool} {path}",
42
- };
34
+ return { text: hookOperatorRefused(operator.replace(/\n/g, "\\n")) };
43
35
  }
44
36
  hooks.push({ event, command });
45
37
  await writeJson(session, HOOKS_STATE_KEY, hooks);
46
- return { text: `hook #${hooks.length} added on '${event}' (/clear clears). ${HOOKS_STATUS}` };
38
+ return { text: hookAdded(hooks.length, event) };
47
39
  }
48
40
  case "remove": {
49
41
  const n = Number(event);
50
- if (!Number.isInteger(n) || n < 1 || n > hooks.length) return { text: `usage: /hooks remove <1-${hooks.length || 1}>` };
42
+ if (!Number.isInteger(n) || n < 1 || n > hooks.length) return { text: hooksRemoveUsage(hooks.length || 1) };
51
43
  hooks.splice(n - 1, 1);
52
44
  await writeJson(session, HOOKS_STATE_KEY, hooks);
53
- return { text: `hook #${n} removed.` };
45
+ return { text: hookRemoved(n) };
54
46
  }
55
47
  default:
56
- return { text: "usage: /hooks [list|add <event> <command>|remove <n>]" };
48
+ return { text: HOOKS_USAGE };
57
49
  }
58
50
  }
@@ -0,0 +1,408 @@
1
+ // The text the settings commands show the user (ADR 0026): usages, refusals, report lines and hints.
2
+ import { USER_CONFIG_FILE_PATH } from "../../../shared/application/config-store.ts";
3
+ import { EXTRA_TOOLS_CONFIG_KEY } from "../../../shared/domain/agent-policy/extra-tools.ts";
4
+ import { PERMISSION_FALLBACK_CONFIG_KEY } from "../../../shared/domain/permission-modes.ts";
5
+ import { RULE_SYNTAX } from "../../../shared/domain/agent-policy/permission.ts";
6
+ import type { PermissionMode } from "../../../shared/domain/permission-modes.ts";
7
+
8
+ // /permissions
9
+
10
+ export const PERMISSIONS_USAGE =
11
+ `usage: /permissions [show] | add ${RULE_SYNTAX} | remove ${RULE_SYNTAX} | list | clear`;
12
+
13
+ /** Said when the host keeps no session rules: a rule is stored, nothing enforces it. */
14
+ export const NO_GATE_RULES =
15
+ "⚠ the host keeps no session rules (orkeon-repl does): the gate decides each call from the mode alone.";
16
+
17
+ export const EVERY_CALL = "every call";
18
+
19
+ export const extraToolsUnreadableWarning = (reason: string): string =>
20
+ `⚠ ${EXTRA_TOOLS_CONFIG_KEY} could not be read (${reason}): no extra tool is known, and the ` +
21
+ "rules on extra tools are dormant.";
22
+
23
+ export const dormantRule = (rule: string): string =>
24
+ `⚠ rule ${rule} is dormant: its tool is neither built in nor listed in ${EXTRA_TOOLS_CONFIG_KEY}. It is ` +
25
+ "kept, not handed to the gate, and applies again once the tool is listed (/permissions remove deletes it).";
26
+
27
+ export const invalidStoredEntries = (invalid: readonly string[]): string =>
28
+ `⚠ ${invalid.length} stored entr${invalid.length === 1 ? "y is" : "ies are"} not a rule ` +
29
+ `(${invalid.join(", ")}): kept as written, ignored; /permissions clear removes them.`;
30
+
31
+ export const fallbackIgnored = (value: string, reason: string): string =>
32
+ ` ↳ ignored : the project file sets ${PERMISSION_FALLBACK_CONFIG_KEY} '${value}': ` + reason;
33
+
34
+ export const USER_SETTINGS_UNREADABLE =
35
+ `⚠ the user settings (${USER_CONFIG_FILE_PATH}) could not be read or parsed: no user setting applies.`;
36
+
37
+ export const nestedKey = (key: string): string =>
38
+ `⚠ ${key} is written nested in a settings file ({"${key.split(".")[0]}": {…}}), so nothing reads it: ` +
39
+ `write it flat, "${key}": ….`;
40
+
41
+ export const extraToolNotOffered = (value: string, reason: string): string =>
42
+ `⚠ ${EXTRA_TOOLS_CONFIG_KEY} of the project file names ${value}, which ${reason}: ` +
43
+ "not offered.";
44
+
45
+ export const ruleSetsOfLastStep = (sets: string): string => `rule sets of the last dev step: ${sets}`;
46
+
47
+ export const memoryGuard = (memoryDir: string, count: number): string =>
48
+ `the shared memory's guard: no tool of the model writes under ${memoryDir}/candidates or ${memoryDir}/entries (${count} rules)`;
49
+
50
+ export const userConfigGuard = (mount: string, count: number): string =>
51
+ `the user configuration's guard: no tool of the model reads or writes ${mount} (${count} rules)`;
52
+
53
+ export const pathsDenyGuard = (entries: string, count: number): string =>
54
+ `paths.deny: no tool of the model reads or writes ${entries} (${count} rules)`;
55
+
56
+ export const SET_BY_MODE = "set by /mode (session state)";
57
+
58
+ export const modesLine = (modes: string): string =>
59
+ `modes : ${modes} (bare /mode opens a panel, or cycles without one)`;
60
+
61
+ export const HOST_KEEPS_NO_RULES = "(the host keeps no session rules)";
62
+
63
+ /** The enforcement block of /permissions show, before what the host says of its gate. */
64
+ export const ENFORCEMENT_LINES: readonly string[] = [
65
+ "enforcement : 1) catalogue: what the mode offers, less the tools a deny rule covers whole",
66
+ " 2) host gate, at each call: a matching deny refuses; a matching allow runs",
67
+ " without asking (not in plan); else the mode decides, and default and",
68
+ " acceptEdits ask you: [y] once / [s] session / [n] no; a background",
69
+ " command's question names its task (for [t1]), answered from the main prompt",
70
+ " 3) dev crews' callback (/dev-spec, /dev-plan, /dev-batches, a /tasks repair),",
71
+ " before the gate (2), which then judges the input it returns:",
72
+ " the step's rule sets and a role's roots again, glob/grep/count_pattern by",
73
+ " their whole input, the act's mode when the host has no gate, then the",
74
+ " pre-tool and post-tool hooks (/hooks); it can refuse, never allow more",
75
+ ];
76
+
77
+ export const inertRule = (rule: string, mode: string, reason: string): string =>
78
+ `⚠ rule ${rule} has NO effect in '${mode}': ${reason}`;
79
+
80
+ export const GATE_HOLDS_OTHER_RULES =
81
+ "⚠ the gate holds other rules than the session: the next change or /assistant hands it these.";
82
+
83
+ export const GATE_HOLDS_RULE_SETS =
84
+ "⚠ the gate also holds the rule sets of the last dev step: the next /assistant turn or rule change hands it the session's rules alone.";
85
+
86
+ export const GATE_ON_LINES: readonly string[] = [
87
+ " the gate is on (Orkeon:Security:PermissionGate:Enabled, the host says): the rules",
88
+ " and the modes above hold at each call",
89
+ ];
90
+
91
+ export const GATE_OFF_LINES: readonly string[] = [
92
+ "⚠ the gate is OFF (Orkeon:Security:PermissionGate:Enabled is not true, the host says): no rule above",
93
+ " is enforced and nothing asks",
94
+ ];
95
+
96
+ export const GATE_UNKNOWN_LINES: readonly string[] = [
97
+ " the gate runs only when Orkeon:Security:PermissionGate:Enabled is true, which",
98
+ " the launcher sets: off, no rule above is enforced and nothing asks",
99
+ ];
100
+
101
+ export const NO_PERMISSION_RULES = `no permission rules set. ${PERMISSIONS_USAGE}`;
102
+
103
+ export const DORMANT_NOT_LISTED = `dormant: not in ${EXTRA_TOOLS_CONFIG_KEY}`;
104
+
105
+ export const invalidRule = (reason: string): string => `invalid rule: ${reason}.\n${PERMISSIONS_USAGE}`;
106
+
107
+ export const ruleAdded = (rule: string): string => `rule ${rule} added.`;
108
+
109
+ export const ruleNoEffect = (mode: string, reason: string): string => `⚠ it has NO effect in '${mode}': ${reason}`;
110
+
111
+ export const catalogueOfMode = (mode: string, tools: string): string => `catalogue for '${mode}': ${tools}`;
112
+
113
+ export const INVALID_RULE_GRAMMAR = `invalid rule: expected ${RULE_SYNTAX}.\n${PERMISSIONS_USAGE}`;
114
+
115
+ export const noSuchRule = (rule: string): string => `no such rule: ${rule}.`;
116
+
117
+ export const ruleRemoved = (rule: string): string => `rule ${rule} removed.`;
118
+
119
+ export const ALL_RULES_CLEARED = "all permission rules cleared (the mode decides alone).";
120
+
121
+ // The lines of /permissions show, each after its label.
122
+ export const sessionDefaultLine = (mode: string, readOnly: boolean): string =>
123
+ `session default mode : ${mode} ${readOnly ? "(read-only)" : ""}`;
124
+ export const sourceLine = (source: string): string => ` ↳ source : ${source}`;
125
+ export const toolCatalogueLine = (tools: string): string => `tool catalogue : ${tools || "(empty)"}`;
126
+ export const withheldLine = (tools: string): string => ` ↳ withheld by mode : ${tools || "(none)"}`;
127
+ export const removedLine = (tools: string): string => ` ↳ removed by rule : ${tools || "(none)"}`;
128
+ export const extraToolsLine = (present: string, missing: readonly string[], invalid: readonly string[]): string =>
129
+ ` ↳ extra tools : ${present || "(none registered)"}` +
130
+ (missing.length > 0 ? `; not registered: ${missing.join(", ")}` : "") +
131
+ (invalid.length > 0 ? `; ignored: ${invalid.join(", ")}` : "");
132
+ export const sessionRulesLine = (rules: string, dormant: readonly string[]): string =>
133
+ `session rules : ${rules || "(none)"}` + (dormant.length > 0 ? `; dormant: ${dormant.join(", ")}` : "");
134
+ export const hostGateLine = (held: string): string => `in the host gate : ${held || "(none)"}`;
135
+
136
+ // /advisor
137
+
138
+ export const advisorModelLine = (model: string, source: string): string => `advisor model: ${model} [${source}]`;
139
+ export const ADVISOR_UNSET =
140
+ "advisor model: (unset) — /advisor review would ask the SESSION's own model, " +
141
+ "which makes it a self-review and worth much less.";
142
+ export const declaredModelsLine = (models: readonly string[]): string => `declared models: ${models.join(", ")}`;
143
+ export const ADVISOR_USAGE = "usage: /advisor <model> | /advisor off | /advisor review";
144
+ export const refusingUnparsed = (path: string): string => `refusing to write: ${path} could not be parsed.`;
145
+ export const ADVISOR_DISABLED = "advisor model disabled — /advisor review falls back to the session's own model.";
146
+ export const refusingToOverwrite = (path: string): string =>
147
+ `refusing to write: ${path} exists but could not be parsed, and overwriting ` +
148
+ "it would discard whatever it holds. Fix or delete it, then retry.";
149
+ export const advisorSet = (model: string, path: string, undeclared: boolean): string =>
150
+ `advisor model set to '${model}' — persisted in ${path}.` +
151
+ (undeclared ? "\n⚠ NOT among the models this host declares; see the log." : "");
152
+
153
+ // /effort
154
+
155
+ export const EFFORT_CHOICE = "Reasoning effort for this session";
156
+ export const actIterations = (count: number): string => `${count} act() iterations`;
157
+ export const EFFORT_UNCHANGED = "reasoning effort unchanged.";
158
+ export const effortUnchangedNoneStored = (level: string): string =>
159
+ "reasoning effort unchanged: no level is stored, so the session asks the provider for no thinking " +
160
+ `(/effort ${level} asks for it).`;
161
+ export const THINKING_NOT_REQUESTED = "not requested (no level stored)";
162
+ /** With no level stored, the level the host's own configuration asks for (`Llm:Thinking:Effort`). */
163
+ export const hostAsks = (level: string): string => `not requested by the session; the host asks for '${level}'`;
164
+ export const thinkingAt = (level: string): string => `at '${level}' (act effort)`;
165
+ export const effortShown = (level: string, ladder: string, thinking: string, levels: readonly string[]): string =>
166
+ `reasoning effort: ${level}\nact() iterations per level: ${ladder}\n` +
167
+ `provider thinking: ${thinking}\n` +
168
+ `usage: /effort [<${levels.join("|")}>|show]`;
169
+ /** The levels the session's model takes, after the thinking of `show`. */
170
+ export const modelTakes = (model: string, efforts: readonly string[]): string =>
171
+ efforts.length > 0 ? `${model} takes ${efforts.join(", ")}` : `${model} takes no effort level`;
172
+ /** What the runtime does with a level that does not go as asked, or that it cannot check (Orkeon #360). The cause
173
+ * may be the model, the provider or the host's settings: the levels the model takes follow when it is known. */
174
+ export const effortLowered = (model: string, asked: string, sent: string): string =>
175
+ `'${asked}' is sent to ${model} as '${sent}'`;
176
+ export const itTakes = (efforts: readonly string[]): string =>
177
+ efforts.length > 0 ? ` (it takes ${efforts.join(", ")})` : " (it takes no effort level)";
178
+ export const effortDropped = (model: string, asked: string): string => `'${asked}' is not sent to ${model}`;
179
+ export const effortUnchecked = (model: string, asked: string): string =>
180
+ `the capability table does not know ${model}: '${asked}' is sent unchecked`;
181
+ /** The line under an answer of /effort or /model when the effort does not go as asked. */
182
+ export const effortWarning = (note: string): string => `⚠ effort: ${note}.`;
183
+ /** The same line for the host's own model under a /model override: the dev steps and the sub-agents run on it. */
184
+ export const effortWarningDevSteps = (note: string): string => `⚠ effort, dev steps and sub-agents (the host's model): ${note}.`;
185
+ /** Under the thinking line of `show`, the same for the host's own model under a /model override. */
186
+ export const thinkingDevSteps = (note: string): string => `\n dev steps and sub-agents (the host's model): ${note}`;
187
+ export const sentAs = (sent: string): string => `, sent as '${sent}'`;
188
+ export const NONE_SENT = ", none sent";
189
+ export const unknownEffort = (level: string, levels: readonly string[]): string =>
190
+ `unknown level '${level}' — expected one of: ${levels.join(", ")}, show.`;
191
+ export const effortSet = (level: string, iterations: number): string =>
192
+ `reasoning effort set to '${level}' — the next /assistant turn gets ` +
193
+ `${iterations} act() iterations and asks the provider for ` +
194
+ `thinking at '${level}' (act effort; the dev steps and their children too). Session-scoped; /clear clears it.`;
195
+
196
+ // /hooks
197
+
198
+ /** Where the hooks run, said on every listing: a populated registry is exactly when someone
199
+ * believes they all run. */
200
+ export const HOOKS_STATUS =
201
+ "pre-tool and post-tool hooks run around each tool call the model makes in the dev steps (/dev-spec, " +
202
+ "/dev-plan, /dev-batches) and a /tasks repair (a failing pre-tool hook refuses the call); " +
203
+ "the assistant does not run " +
204
+ "them yet, and no stop hook runs.";
205
+ export const NO_HOOKS = `no hooks configured. usage: /hooks add <pre-tool|post-tool|stop> <command>\n${HOOKS_STATUS}`;
206
+ export const hooksAddUsage = (events: readonly string[]): string => `usage: /hooks add <${events.join("|")}> <command>`;
207
+ export const hookOperatorRefused = (operator: string): string =>
208
+ `refused: the command holds '${operator}', which the shell tool refuses: a hook is one program ` +
209
+ "and its arguments. Put the steps in a script: /hooks add pre-tool node .orkeon/hooks/pre.mjs {tool} {path}";
210
+ export const hookAdded = (n: number, event: string): string => `hook #${n} added on '${event}' (/clear clears). ${HOOKS_STATUS}`;
211
+ export const hooksRemoveUsage = (max: number): string => `usage: /hooks remove <1-${max}>`;
212
+ export const hookRemoved = (n: number): string => `hook #${n} removed.`;
213
+ export const HOOKS_USAGE = "usage: /hooks [list|add <event> <command>|remove <n>]";
214
+
215
+ // /agents
216
+
217
+ export const AGENTS_USAGE =
218
+ "usage: /agents [list] | add <name> <role> | <goal> | remove <name> | show <name>";
219
+
220
+ /** What the listing says of the saved agents, and of what runs instead. */
221
+ export const SAVED_AGENTS_NOTE =
222
+ "saved agents are storage only — no command runs one; the built-in charters run as children of /dev-spec, /dev-plan and /dev-batches (/tasks).";
223
+
224
+ export const agentsFileLine = (path: string): string => `file: ${path} (survives /clear)`;
225
+ export const droppedAgents = (dropped: readonly string[]): string =>
226
+ `⚠ ${dropped.length} stored entr(y/ies) ignored — missing role or goal: ${dropped.join(", ")}`;
227
+ export const fileLeftUntouched = (path: string): string => `⚠ ${path} could not be parsed; it is left untouched.`;
228
+ export const savedAgentShown = (name: string, role: string, goal: string, tools: readonly string[]): string =>
229
+ `${name}\n role : ${role}\n goal : ${goal}\n` +
230
+ ` tools: ${tools.length > 0 ? tools.join(", ") : "(inherited from the crew)"}`;
231
+ export const builtInCrewNotSaved = (name: string): string =>
232
+ `'${name}' is a built-in crew (crews/${name}/), not a saved agent — see its crew.ork.ts.`;
233
+ export const noSavedAgentListHint = (name: string): string => `no saved agent '${name}'. /agents list shows what there is.`;
234
+ export const withAgentsUsage = (reason: string): string => `${reason}\n${AGENTS_USAGE}`;
235
+ export const agentSaved = (name: string, replaced: boolean, path: string): string =>
236
+ `agent '${name}' ${replaced ? "replaced" : "saved"} in ${path}.`;
237
+ export const builtInCrewNotRemovable = (name: string): string =>
238
+ `'${name}' is a built-in crew — it is not stored here and cannot be removed with /agents.`;
239
+ export const noSavedAgent = (name: string): string => `no saved agent '${name}'.`;
240
+ export const agentRemoved = (name: string, path: string): string => `agent '${name}' removed from ${path}.`;
241
+
242
+ // /config
243
+
244
+ export const CONFIG_USAGE =
245
+ "usage: /config [list|keys|get <key>|set [--session] <key> <value>|unset [--session] <key>]";
246
+ export const configFileLine = (path: string): string => `file: ${path} — session overrides it until /clear.`;
247
+ export const unknownStoredKeys = (keys: readonly string[]): string =>
248
+ `⚠ stored but NOT in the key space (pre-B-6 residue, nothing reads them): ${keys.join(", ")}`;
249
+ export const nestedKeys = (keys: readonly string[]): string =>
250
+ `⚠ written nested, so nothing reads them: ${keys.join(", ")} — a settings file holds each key flat ` +
251
+ `("${keys[0]}": …).`;
252
+ export const configFileMalformed = (path: string): string =>
253
+ `⚠ ${path} could not be parsed — it is left untouched; fix or delete it.`;
254
+ export const KEYS_NOTE = "every key names its consumer — a key nothing reads is not settable.";
255
+ export const CONFIG_GET_USAGE = "usage: /config get <key>";
256
+ export const keyUnset = (key: string, description: string): string => `${key} is unset (${description})`;
257
+ export const keyValue = (key: string, value: string, source: string): string => `${key} = ${value} [${source}]`;
258
+ export const sessionValueSet = (key: string, value: string): string =>
259
+ `${key} = ${value} [session] — overrides the file until /clear.`;
260
+ export const fileValueSet = (key: string, value: string, path: string): string =>
261
+ `${key} = ${value} [file] — persisted in ${path}.`;
262
+ export const userSettingsUnparsed = (path: string): string =>
263
+ ` The user settings (${path}) could not be parsed: none applies.`;
264
+ export const valueIgnored = (persisted: string, value: string, reason: string, unread: string): string =>
265
+ `${persisted}\n↳ ignored: '${value}': ${reason}.${unread} A setting of your own goes in ` +
266
+ "the orkeonCode block of the user settings file (the one the launcher reads).";
267
+ export const CONFIG_UNSET_USAGE = "usage: /config unset [--session] <key>";
268
+ export const noSessionOverride = (key: string): string => `${key} has no session override.`;
269
+ export const sessionOverrideRemoved = (key: string): string =>
270
+ `${key} session override removed (the file value applies again).`;
271
+ export const keyNotInFile = (key: string, path: string): string => `${key} is not set in ${path}.`;
272
+ export const keyRemoved = (key: string, path: string): string => `${key} removed from ${path}.`;
273
+
274
+ // /mode and /plan
275
+
276
+ /** What each mode lets a turn do, beside its name in the panel. */
277
+ export const MODE_DESCRIPTIONS: Record<PermissionMode, string> = {
278
+ default: "reads run, the rest asks",
279
+ acceptEdits: "reads and file edits run, the rest asks",
280
+ bypassPermissions: "every call runs but what a deny rule refuses",
281
+ plan: "read-only, no edit, network or shell tool",
282
+ dontAsk: "local reads only, nothing asks",
283
+ };
284
+ export const enteringReadOnly = (mode: string): string =>
285
+ `entering '${mode}': the edit, network and shell tools stripped from the catalogue`;
286
+ export const modeApplied = (how: string, mode: string): string =>
287
+ `session default permission mode ${how} '${mode}' ` +
288
+ `(prompts without a "mode:" prefix now run in it; /clear restores 'default').`;
289
+ export const MODE_CHOICE = "Permission mode for this session";
290
+ export const modeUnchanged = (mode: string): string => `permission mode unchanged: ${mode}.`;
291
+ export const MODE_SET_TO = "set to";
292
+ export const modeCycled = (from: string): string => `cycled ${from} →`;
293
+ export const modeShown = (mode: string, via: string, modes: readonly string[]): string =>
294
+ `session default permission mode: ${mode}\n` +
295
+ ` ↳ ${via}\n` +
296
+ `usage: /mode [<${modes.join("|")}>|show] — bare /mode opens a panel, or cycles without one; ` +
297
+ `an explicit "mode:" prefix on a prompt still wins.`;
298
+ export const unknownMode = (mode: string, modes: readonly string[]): string =>
299
+ `unknown mode '${mode}' — expected one of: ${modes.join(", ")}, show.`;
300
+ export const PLAN_ON = "plan mode ON — prompts without a \"mode:\" prefix now run read-only. /plan again to leave.";
301
+ export const LEAVING_PLAN = "leaving 'plan': session default back to 'default' (asks on writes)";
302
+ export const PLAN_OFF =
303
+ "plan mode OFF — the session default is 'default' (asks on writes). " +
304
+ "It is NOT restored to whatever it was before /plan: use /mode to pick another.";
305
+
306
+ // /model
307
+
308
+ export const NO_MODEL_REPORTED =
309
+ "not reported by the host — no LLM provider is registered, or the host predates the " +
310
+ "session-metadata fix. Turns will no-op: check that the settings file has an `Llm` section.";
311
+ export const declaredCatalogue = (catalogue: string): string => `declared models (* = effective):\n${catalogue}`;
312
+ export const modelShown = (
313
+ effective: string, boot: string, override: string, catalogue: string, noCatalogue: string,
314
+ ): string =>
315
+ `effective model for the next turn: ${effective}\n` +
316
+ ` boot model : ${boot || NO_MODEL_REPORTED}\n` +
317
+ ` session override: ${override}\n` +
318
+ (catalogue ? `declared models (* = effective):\n${catalogue}\n` : `declared models: ${noCatalogue}\n`) +
319
+ "usage: /model <name> | /model list | /model reset | /model show";
320
+ export const overrideNotSent = (model: string): string => `${model} (not sent while llm.profile is set)`;
321
+ export const overrideCleared = (boot: string): string => `model override cleared — turns go back to ${boot}.`;
322
+ export const OVERRIDE_CLEARED_NO_BOOT = `model override cleared. Boot model: ${NO_MODEL_REPORTED}`;
323
+ export const profileWinsOverride = (profile: string, model: string): string =>
324
+ `llm.profile ${profile} is active: the /model override '${model}' is stored but not sent ` +
325
+ "while it is set (unset llm.profile to use it)";
326
+ export const modelSetWarned = (model: string, warning: string): string => `model set to '${model}' — ⚠ ${warning}.`;
327
+ export const modelSetUndeclared = (model: string, declared: readonly string[]): string =>
328
+ `model set to '${model}' — ⚠ NOT among the models this host declares ` +
329
+ `(${declared.join(", ")}). Applied anyway; see the log. /model list to review.`;
330
+ export const modelSet = (model: string): string =>
331
+ `model set to '${model}' — it applies from the next /assistant turn, no relaunch.\n` +
332
+ "It travels over the configured provider, so it must be a model that provider serves; " +
333
+ "/clear (or /model reset) returns to the boot model.";
334
+ export const MODEL_CHOICE = "Model for the next turns";
335
+ export const MODEL_UNCHANGED = "model unchanged.";
336
+ export const profileNamesModel = (profile: string): string =>
337
+ `the one llm.profile ${profile} names (the /model override does not apply)`;
338
+ export const NO_EFFECTIVE_MODEL = "(none — see below)";
339
+
340
+ // /output-style
341
+
342
+ export const OUTPUT_STYLE_CHOICE = "Answer style for this session";
343
+ export const OUTPUT_STYLE_UNCHANGED = "output style unchanged.";
344
+ export const outputStyleShown = (style: string, styles: readonly string[]): string =>
345
+ `output style: ${style}\n` +
346
+ `usage: /output-style [<${styles.join("|")}>|show]\n` +
347
+ (style === "default"
348
+ ? "the default adds no block to the prompt — an unconfigured session is byte-identical to before B-7."
349
+ : "the style is injected as a <system-reminder> below the cache boundary, so it never breaks the prefix cache.");
350
+ export const unknownStyle = (style: string, styles: readonly string[]): string =>
351
+ `unknown style '${style}' — expected one of: ${styles.join(", ")}, show.`;
352
+ export const outputStyleSet = (style: string): string =>
353
+ `output style set to '${style}' — it applies from the next /assistant turn ` +
354
+ "(/clear restores 'default').";
355
+
356
+ // /skills
357
+
358
+ export const NO_SKILLS = "no skills attached. usage: /skills attach <workspace path to a .md playbook>";
359
+ export const SKILLS_ATTACH_USAGE = "usage: /skills attach <path>";
360
+ export const cannotAttach = (path: string): string =>
361
+ `cannot attach '${path}' — the file is not readable in the mounted workspace.`;
362
+ export const skillAttached = (path: string, count: number): string =>
363
+ `skill attached: ${path} (${count} attached; /clear clears).`;
364
+ export const skillsDetachUsage = (max: number): string => `usage: /skills detach <1-${max}>`;
365
+ export const skillDetached = (path: unknown): string => `skill detached: ${path}`;
366
+ export const SKILLS_USAGE = "usage: /skills [list|attach <path>|detach <n>|suggest [on|off|why]]";
367
+ export const SKILLS_SUGGEST_USAGE = "usage: /skills suggest [on|off|why]";
368
+ export const NOTHING_SUGGESTED_YET = "no skill was suggested yet in this session.";
369
+ export const suggestStatus = (on: boolean, model: boolean): string =>
370
+ `skills.suggest: ${on ? "on" : "off"}; skills read from .orkeon/skills/*.md and .claude/skills/*/SKILL.md; decision model: ${model ? "present" : "absent, none is suggested"}.`;
371
+ export const suggestSet = (on: boolean, model: boolean): string =>
372
+ on
373
+ ? `skills.suggest: on for this session${model ? "" : " (the host has no decision model: none is suggested until it has one)"}; /clear clears it.`
374
+ : "skills.suggest: off for this session; /clear clears it.";
375
+ export const noSkillFit = (offered: number): string => `the last turn was offered ${offered} skill(s): none fit its request.`;
376
+ export const skillsOffered = (offered: number): string => `suggested to the last turn, among ${offered} skill(s).`;
377
+ export const suggestedSkill = (path: string, share: number): string => `${path} (${share.toFixed(2)})`;
378
+
379
+ // /theme
380
+
381
+ export const NO_PALETTES = "this console has no palettes.";
382
+ export const unknownTheme = (theme: string, themes: readonly string[]): string =>
383
+ `unknown theme '${theme}' — expected one of: ${themes.join(", ")}, show.`;
384
+ export const THEME_CHOICE = "Console palette for this session";
385
+ export const themeUnchanged = (theme: string): string => `theme unchanged: ${theme}.`;
386
+ export const themeShown = (theme: string, themes: readonly string[]): string =>
387
+ `theme: ${theme}\nusage: /theme [<${themes.join("|")}>|show]`;
388
+ export const themeSet = (theme: string): string =>
389
+ `theme set to '${theme}' for this session (the setting Orkeon:Cli:Tui:Theme is the start palette).`;
390
+
391
+ // /fast and /proactive
392
+
393
+ export const fastNote = (blocks: readonly string[]): string =>
394
+ `while on, /assistant turns omit the ${blocks.join(" and ")} blocks`;
395
+ export const PROACTIVE_NOTE = "while on, /assistant answers end with up to three suggested next steps";
396
+
397
+ // /route
398
+ export const ROUTE_USAGE = "usage: /route [on|off|why]";
399
+ export const NOTHING_ROUTED_YET = "nothing routed yet in this session.";
400
+ export const routeStatus = (on: boolean, ladder: string, model: boolean): string =>
401
+ `route.agents: ${on ? "on" : "off"}; ladder: ${ladder} (cheapest first); decision model: ${model ? "present" : "absent, nothing is routed"}.`;
402
+ export const routeSet = (on: boolean, model: boolean): string =>
403
+ on
404
+ ? `route.agents: on for this session${model ? "" : " (the host has no decision model: nothing is routed until it has one)"}; /clear clears it.`
405
+ : "route.agents: off for this session; /clear clears it.";
406
+ /** Under the status: what a rung's model takes, or what the stored effort becomes on it. */
407
+ export const rungLine = (rung: string, what: string): string => ` ${rung}: ${what}`;
408
+ export const routedRecord = (crew: string, profile: string, why: string): string => `${crew} on '${profile}': ${why}`;