orkeon-code 0.0.0-stage → 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 (552) hide show
  1. package/.orkeon-runtime +10 -0
  2. package/.orkeon-version +1 -0
  3. package/LICENSE.md +21 -0
  4. package/NOTICE.md +17 -0
  5. package/README.fr.md +163 -0
  6. package/README.md +156 -2
  7. package/config/appsettings.anthropic.example.json +77 -0
  8. package/config/appsettings.example.json +71 -0
  9. package/config/appsettings.jev.example.json +131 -0
  10. package/config/appsettings.kev.example.json +133 -0
  11. package/config/appsettings.liquid.example.json +132 -0
  12. package/config/appsettings.ollama-whisper.example.json +93 -0
  13. package/config/appsettings.ollama.example.json +70 -0
  14. package/config/appsettings.whisper.example.json +32 -0
  15. package/mcp/whisper/README.md +294 -0
  16. package/mcp/whisper/pyproject.toml +32 -0
  17. package/mcp/whisper/uv.lock +1641 -0
  18. package/mcp/whisper/whisper_mcp.py +1053 -0
  19. package/orkeon-code +1092 -0
  20. package/orkeon-code.mjs +71 -0
  21. package/orkeon-code.ps1 +939 -0
  22. package/package.json +58 -4
  23. package/scripts/install.ps1 +156 -0
  24. package/scripts/install.sh +148 -0
  25. package/scripts/session-start.ork.ts +90 -0
  26. package/scripts/session-start.sh +74 -0
  27. package/scripts/setup-fixture.sh +88 -0
  28. package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
  29. package/src/commands/_lib/args.ts +194 -0
  30. package/src/commands/_lib/dev/dev-batches.ts +366 -0
  31. package/src/commands/_lib/dev/dev-implement.ts +185 -0
  32. package/src/commands/_lib/dev/dev-source.ts +61 -0
  33. package/src/commands/_lib/dev/dev.ts +341 -0
  34. package/src/commands/_lib/dev/markers.ts +7 -0
  35. package/src/commands/_lib/dev/messages.ts +112 -0
  36. package/src/commands/_lib/dev-step.ts +145 -0
  37. package/src/commands/_lib/dispatch.ts +254 -0
  38. package/src/commands/_lib/effort.ts +15 -0
  39. package/src/commands/_lib/git/branch.ts +94 -0
  40. package/src/commands/_lib/git/commit.ts +90 -0
  41. package/src/commands/_lib/git/diff.ts +107 -0
  42. package/src/commands/_lib/git/messages.ts +54 -0
  43. package/src/commands/_lib/git/review.ts +108 -0
  44. package/src/commands/_lib/memory/memory-admit.ts +148 -0
  45. package/src/commands/_lib/memory/memory.ts +52 -0
  46. package/src/commands/_lib/memory/messages.ts +32 -0
  47. package/src/commands/_lib/messages.ts +48 -0
  48. package/src/commands/_lib/pr-context.ts +32 -0
  49. package/src/commands/_lib/project/analyze.ts +24 -0
  50. package/src/commands/_lib/project/messages.ts +8 -0
  51. package/src/commands/_lib/session/export.ts +105 -0
  52. package/src/commands/_lib/session/messages.ts +87 -0
  53. package/src/commands/_lib/session/prompts.ts +4 -0
  54. package/src/commands/_lib/session/resume.ts +151 -0
  55. package/src/commands/_lib/session/tasks.ts +181 -0
  56. package/src/commands/_lib/settings/advisor.ts +75 -0
  57. package/src/commands/_lib/settings/agents.ts +137 -0
  58. package/src/commands/_lib/settings/choices.ts +8 -0
  59. package/src/commands/_lib/settings/config.ts +141 -0
  60. package/src/commands/_lib/settings/effort.ts +147 -0
  61. package/src/commands/_lib/settings/hooks.ts +50 -0
  62. package/src/commands/_lib/settings/messages.ts +408 -0
  63. package/src/commands/_lib/settings/mode.ts +100 -0
  64. package/src/commands/_lib/settings/model.ts +181 -0
  65. package/src/commands/_lib/settings/output-style.ts +39 -0
  66. package/src/commands/_lib/settings/permissions.ts +287 -0
  67. package/src/commands/_lib/settings/route.ts +63 -0
  68. package/src/commands/_lib/settings/session-config.ts +49 -0
  69. package/src/commands/_lib/settings/skills.ts +93 -0
  70. package/src/commands/_lib/settings/theme.ts +42 -0
  71. package/src/commands/_lib/speech/messages.ts +58 -0
  72. package/src/commands/_lib/speech/prompts.ts +4 -0
  73. package/src/commands/_lib/speech/say.ts +95 -0
  74. package/src/commands/_lib/speech/transcribe.ts +121 -0
  75. package/src/commands/_lib/speech/voice.ts +142 -0
  76. package/src/commands/_lib/status/cache.ts +31 -0
  77. package/src/commands/_lib/status/context.ts +57 -0
  78. package/src/commands/_lib/status/doctor.ts +205 -0
  79. package/src/commands/_lib/status/messages.ts +100 -0
  80. package/src/commands/_lib/status/meta.ts +24 -0
  81. package/src/commands/_lib/status/status.ts +128 -0
  82. package/src/commands/_lib/status/usage-tools.ts +48 -0
  83. package/src/commands/_lib/status/usage.ts +128 -0
  84. package/src/commands/_lib/view.ts +34 -0
  85. package/src/commands/dev/dev-batches.cmd.ts +109 -0
  86. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  87. package/src/commands/dev/dev-plan.cmd.ts +51 -0
  88. package/src/commands/dev/dev-spec.cmd.ts +54 -0
  89. package/src/commands/dev/dev-status.cmd.ts +16 -0
  90. package/src/commands/git/branch.cmd.ts +27 -0
  91. package/src/commands/git/commit.cmd.ts +48 -0
  92. package/src/commands/git/diff.cmd.ts +26 -0
  93. package/src/commands/git/review.cmd.ts +36 -0
  94. package/src/commands/memory/memory.cmd.ts +48 -0
  95. package/src/commands/project/analyze.cmd.ts +32 -0
  96. package/src/commands/project/debug-tool-call.cmd.ts +62 -0
  97. package/src/commands/project/files.cmd.ts +22 -0
  98. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  99. package/src/commands/project/init.cmd.ts +14 -0
  100. package/src/commands/project/verify.cmd.ts +27 -0
  101. package/src/commands/session/assistant.cmd.ts +40 -0
  102. package/src/commands/session/btw.cmd.ts +18 -0
  103. package/src/commands/session/clear.cmd.ts +19 -0
  104. package/src/commands/session/compact.cmd.ts +16 -0
  105. package/src/commands/session/copy.cmd.ts +45 -0
  106. package/src/commands/session/exit.cmd.ts +9 -0
  107. package/src/commands/session/export.cmd.ts +28 -0
  108. package/src/commands/session/rename.cmd.ts +18 -0
  109. package/src/commands/session/resume.cmd.ts +19 -0
  110. package/src/commands/session/rewind.cmd.ts +25 -0
  111. package/src/commands/session/summary.cmd.ts +27 -0
  112. package/src/commands/session/tasks.cmd.ts +46 -0
  113. package/src/commands/settings/advisor.cmd.ts +38 -0
  114. package/src/commands/settings/agents.cmd.ts +19 -0
  115. package/src/commands/settings/config.cmd.ts +19 -0
  116. package/src/commands/settings/effort.cmd.ts +19 -0
  117. package/src/commands/settings/fast.cmd.ts +18 -0
  118. package/src/commands/settings/hooks.cmd.ts +17 -0
  119. package/src/commands/settings/mode.cmd.ts +20 -0
  120. package/src/commands/settings/model.cmd.ts +21 -0
  121. package/src/commands/settings/output-style.cmd.ts +19 -0
  122. package/src/commands/settings/permissions.cmd.ts +25 -0
  123. package/src/commands/settings/proactive.cmd.ts +16 -0
  124. package/src/commands/settings/route.cmd.ts +16 -0
  125. package/src/commands/settings/skills.cmd.ts +17 -0
  126. package/src/commands/settings/theme.cmd.ts +14 -0
  127. package/src/commands/speech/say.cmd.ts +24 -0
  128. package/src/commands/speech/transcribe.cmd.ts +29 -0
  129. package/src/commands/speech/voice.cmd.ts +30 -0
  130. package/src/commands/status/context.cmd.ts +18 -0
  131. package/src/commands/status/doctor.cmd.ts +27 -0
  132. package/src/commands/status/release-notes.cmd.ts +9 -0
  133. package/src/commands/status/status.cmd.ts +25 -0
  134. package/src/commands/status/usage.cmd.ts +21 -0
  135. package/src/crews/.orkeon/orkeon.d.ts +4391 -0
  136. package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
  137. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
  138. package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
  139. package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
  140. package/src/crews/advisor/application/messages.ts +4 -0
  141. package/src/crews/advisor/application/prompts.ts +4 -0
  142. package/src/crews/advisor/application/run-advisor.ts +41 -0
  143. package/src/crews/advisor/crew.ork.ts +44 -0
  144. package/src/crews/advisor/domain/advice.ts +119 -0
  145. package/src/crews/advisor/domain/messages.ts +8 -0
  146. package/src/crews/advisor/domain/prompts.ts +26 -0
  147. package/src/crews/agent-run/application/messages.ts +18 -0
  148. package/src/crews/agent-run/application/run-agent-run.ts +43 -0
  149. package/src/crews/agent-run/crew.ork.ts +67 -0
  150. package/src/crews/analyze/application/messages.ts +27 -0
  151. package/src/crews/analyze/application/prompts.ts +4 -0
  152. package/src/crews/analyze/application/run-analyze.ts +120 -0
  153. package/src/crews/analyze/crew.ork.ts +41 -0
  154. package/src/crews/analyze/domain/harvest.ts +269 -0
  155. package/src/crews/analyze/domain/prompts.ts +86 -0
  156. package/src/crews/code-review/application/lens-material.ts +24 -0
  157. package/src/crews/code-review/application/messages.ts +17 -0
  158. package/src/crews/code-review/application/prompts.ts +126 -0
  159. package/src/crews/code-review/application/review.ts +74 -0
  160. package/src/crews/code-review/application/run-code-review.ts +121 -0
  161. package/src/crews/code-review/crew.ork.ts +52 -0
  162. package/src/crews/code-review/domain/lenses.ts +154 -0
  163. package/src/crews/code-review/domain/messages.ts +25 -0
  164. package/src/crews/code-review/domain/prompts.ts +58 -0
  165. package/src/crews/code-review/domain/report.ts +58 -0
  166. package/src/crews/code-review/domain/scope.ts +106 -0
  167. package/src/crews/dev-batches/application/messages.ts +127 -0
  168. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  169. package/src/crews/dev-batches/application/prompts.ts +10 -0
  170. package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
  171. package/src/crews/dev-batches/application/run-wave.ts +452 -0
  172. package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
  173. package/src/crews/dev-batches/crew.ork.ts +146 -0
  174. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  175. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  176. package/src/crews/dev-batches/domain/batches-log.ts +52 -0
  177. package/src/crews/dev-batches/domain/markers.ts +5 -0
  178. package/src/crews/dev-batches/domain/messages.ts +6 -0
  179. package/src/crews/dev-batches/domain/wave-order.ts +44 -0
  180. package/src/crews/dev-change/application/change-material.ts +44 -0
  181. package/src/crews/dev-change/application/evidence.ts +172 -0
  182. package/src/crews/dev-change/application/messages.ts +81 -0
  183. package/src/crews/dev-change/application/prompts.ts +101 -0
  184. package/src/crews/dev-change/application/run-dev-change.ts +324 -0
  185. package/src/crews/dev-change/crew.ork.ts +114 -0
  186. package/src/crews/dev-change/domain/change-answer.ts +163 -0
  187. package/src/crews/dev-change/domain/change-render.ts +77 -0
  188. package/src/crews/dev-change/domain/markers.ts +28 -0
  189. package/src/crews/dev-change/domain/messages.ts +16 -0
  190. package/src/crews/dev-implement/application/close.ts +186 -0
  191. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  192. package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
  193. package/src/crews/dev-implement/application/messages.ts +161 -0
  194. package/src/crews/dev-implement/application/observe.ts +52 -0
  195. package/src/crews/dev-implement/application/prompts.ts +9 -0
  196. package/src/crews/dev-implement/application/report-writes.ts +46 -0
  197. package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
  198. package/src/crews/dev-implement/application/run-role.ts +27 -0
  199. package/src/crews/dev-implement/application/suite-job.ts +122 -0
  200. package/src/crews/dev-implement/application/touched.ts +74 -0
  201. package/src/crews/dev-implement/crew.ork.ts +69 -0
  202. package/src/crews/dev-implement/domain/contracts.ts +255 -0
  203. package/src/crews/dev-implement/domain/correction.ts +103 -0
  204. package/src/crews/dev-implement/domain/cycles.ts +36 -0
  205. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  206. package/src/crews/dev-implement/domain/markers.ts +23 -0
  207. package/src/crews/dev-implement/domain/messages.ts +58 -0
  208. package/src/crews/dev-implement/domain/prompts.ts +93 -0
  209. package/src/crews/dev-implement/domain/roles.ts +49 -0
  210. package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
  211. package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
  212. package/src/crews/dev-implement/domain/step-checks.ts +137 -0
  213. package/src/crews/dev-implement/domain/step-section.ts +129 -0
  214. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  215. package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
  216. package/src/crews/dev-learn/application/messages.ts +51 -0
  217. package/src/crews/dev-learn/application/prompts.ts +99 -0
  218. package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
  219. package/src/crews/dev-learn/crew.ork.ts +53 -0
  220. package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
  221. package/src/crews/dev-learn/domain/messages.ts +65 -0
  222. package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
  223. package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
  224. package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
  225. package/src/crews/dev-plan/application/inventory.ts +174 -0
  226. package/src/crews/dev-plan/application/messages.ts +88 -0
  227. package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
  228. package/src/crews/dev-plan/application/prompts.ts +141 -0
  229. package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
  230. package/src/crews/dev-plan/crew.ork.ts +112 -0
  231. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  232. package/src/crews/dev-plan/domain/markers.ts +18 -0
  233. package/src/crews/dev-plan/domain/messages.ts +118 -0
  234. package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
  235. package/src/crews/dev-plan/domain/plan-render.ts +306 -0
  236. package/src/crews/dev-plan/domain/prompts.ts +44 -0
  237. package/src/crews/dev-spec/application/messages.ts +30 -0
  238. package/src/crews/dev-spec/application/prompts.ts +93 -0
  239. package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
  240. package/src/crews/dev-spec/application/spec-material.ts +42 -0
  241. package/src/crews/dev-spec/crew.ork.ts +110 -0
  242. package/src/crews/dev-spec/domain/markers.ts +30 -0
  243. package/src/crews/dev-spec/domain/messages.ts +39 -0
  244. package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
  245. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  246. package/src/crews/dev-verify/application/audit-brief.ts +187 -0
  247. package/src/crews/dev-verify/application/audit.ts +267 -0
  248. package/src/crews/dev-verify/application/capture.ts +311 -0
  249. package/src/crews/dev-verify/application/messages.ts +119 -0
  250. package/src/crews/dev-verify/application/prompts.ts +209 -0
  251. package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
  252. package/src/crews/dev-verify/application/run-gate.ts +204 -0
  253. package/src/crews/dev-verify/crew.ork.ts +103 -0
  254. package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
  255. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  256. package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
  257. package/src/crews/dev-verify/domain/commands.ts +103 -0
  258. package/src/crews/dev-verify/domain/gate.ts +131 -0
  259. package/src/crews/dev-verify/domain/markers.ts +16 -0
  260. package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
  261. package/src/crews/dev-verify/domain/messages.ts +92 -0
  262. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  263. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  264. package/src/crews/dev-verify/domain/text.ts +20 -0
  265. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  266. package/src/crews/git-commit/application/draft.ts +133 -0
  267. package/src/crews/git-commit/application/messages.ts +15 -0
  268. package/src/crews/git-commit/application/prompts.ts +47 -0
  269. package/src/crews/git-commit/application/run-git-commit.ts +117 -0
  270. package/src/crews/git-commit/crew.ork.ts +53 -0
  271. package/src/crews/git-commit/domain/commit.ts +200 -0
  272. package/src/crews/git-commit/domain/markers.ts +4 -0
  273. package/src/crews/git-commit/domain/messages.ts +48 -0
  274. package/src/crews/init-verifiers/application/authoring.ts +90 -0
  275. package/src/crews/init-verifiers/application/messages.ts +13 -0
  276. package/src/crews/init-verifiers/application/prompts.ts +107 -0
  277. package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
  278. package/src/crews/init-verifiers/crew.ork.ts +35 -0
  279. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  280. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  281. package/src/crews/main-loop/application/auto-compact.ts +78 -0
  282. package/src/crews/main-loop/application/context-gather.ts +133 -0
  283. package/src/crews/main-loop/application/messages.ts +81 -0
  284. package/src/crews/main-loop/application/prompts.ts +12 -0
  285. package/src/crews/main-loop/application/run-main-loop.ts +383 -0
  286. package/src/crews/main-loop/application/turn-context.ts +111 -0
  287. package/src/crews/main-loop/crew.ork.ts +124 -0
  288. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  289. package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
  290. package/src/crews/main-loop/domain/prompts.ts +336 -0
  291. package/src/crews/main-loop/domain/turn-chains.ts +130 -0
  292. package/src/crews/project-init/application/detect.ts +123 -0
  293. package/src/crews/project-init/application/messages.ts +15 -0
  294. package/src/crews/project-init/application/prompts.ts +105 -0
  295. package/src/crews/project-init/application/run-project-init.ts +31 -0
  296. package/src/crews/project-init/crew.ork.ts +36 -0
  297. package/src/crews/project-init/domain/conventions.ts +36 -0
  298. package/src/crews/project-init/domain/existing-files.ts +65 -0
  299. package/src/crews/project-init/domain/messages.ts +13 -0
  300. package/src/crews/project-init/domain/package-map.ts +73 -0
  301. package/src/crews/project-init/domain/prompts.ts +10 -0
  302. package/src/crews/session-compact/application/prompts.ts +5 -0
  303. package/src/crews/session-compact/crew.ork.ts +56 -0
  304. package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
  305. package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
  306. package/src/crews/speech/application/messages.ts +3 -0
  307. package/src/crews/speech/application/prompts.ts +3 -0
  308. package/src/crews/speech/application/run-speech.ts +26 -0
  309. package/src/crews/speech/crew.ork.ts +38 -0
  310. package/src/shared/application/agents/child-agent.ts +259 -0
  311. package/src/shared/application/agents/messages.ts +35 -0
  312. package/src/shared/application/agents/route-agent.ts +115 -0
  313. package/src/shared/application/agents/run-sub-agent.ts +119 -0
  314. package/src/shared/application/answer-language.ts +14 -0
  315. package/src/shared/application/attached-skills.ts +36 -0
  316. package/src/shared/application/compaction/compact-session.ts +242 -0
  317. package/src/shared/application/compaction/extract-memories.ts +38 -0
  318. package/src/shared/application/compaction/messages.ts +20 -0
  319. package/src/shared/application/compaction/prune-context.ts +94 -0
  320. package/src/shared/application/compaction/pruned-llm.ts +35 -0
  321. package/src/shared/application/compaction/restore-context.ts +78 -0
  322. package/src/shared/application/config-store.ts +123 -0
  323. package/src/shared/application/dev/brief-inventory.ts +115 -0
  324. package/src/shared/application/dev/close-batch.ts +85 -0
  325. package/src/shared/application/dev/find-repo-pack.ts +78 -0
  326. package/src/shared/application/dev/learn-decision.ts +254 -0
  327. package/src/shared/application/dev/load-dev-context.ts +265 -0
  328. package/src/shared/application/dev/measure-access-cost.ts +69 -0
  329. package/src/shared/application/dev/messages.ts +132 -0
  330. package/src/shared/application/dev/phase-timer.ts +54 -0
  331. package/src/shared/application/dev/plan-source.ts +116 -0
  332. package/src/shared/application/dev/preflight.ts +71 -0
  333. package/src/shared/application/dev/project-files.ts +17 -0
  334. package/src/shared/application/dev/prompts.ts +34 -0
  335. package/src/shared/application/dev/question-round.ts +60 -0
  336. package/src/shared/application/dev/resolve-work-folder.ts +134 -0
  337. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  338. package/src/shared/application/dev/settle-questions.ts +57 -0
  339. package/src/shared/application/dev/source-review.ts +67 -0
  340. package/src/shared/application/dev/source-step.ts +152 -0
  341. package/src/shared/application/dev/spend.ts +55 -0
  342. package/src/shared/application/dev/step-precedents.ts +90 -0
  343. package/src/shared/application/dev/tool-call-policy.ts +87 -0
  344. package/src/shared/application/dev/tool-callbacks.ts +262 -0
  345. package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
  346. package/src/shared/application/dev/verdict-sources.ts +50 -0
  347. package/src/shared/application/dev/wrapped-tools.ts +147 -0
  348. package/src/shared/application/extra-tools.ts +71 -0
  349. package/src/shared/application/git/batch-worktree.ts +102 -0
  350. package/src/shared/application/git/commit-files.ts +191 -0
  351. package/src/shared/application/git/merge-batch.ts +67 -0
  352. package/src/shared/application/git/messages.ts +75 -0
  353. package/src/shared/application/git/open-pull-request.ts +52 -0
  354. package/src/shared/application/host-context.ts +59 -0
  355. package/src/shared/application/host-layout-store.ts +45 -0
  356. package/src/shared/application/instructions-file.ts +19 -0
  357. package/src/shared/application/json-file.ts +34 -0
  358. package/src/shared/application/llm-profile.ts +36 -0
  359. package/src/shared/application/messages.ts +14 -0
  360. package/src/shared/application/permission-rules.ts +169 -0
  361. package/src/shared/application/ports/approvals.ts +20 -0
  362. package/src/shared/application/ports/clock.ts +5 -0
  363. package/src/shared/application/ports/code-index.ts +93 -0
  364. package/src/shared/application/ports/crew.ts +60 -0
  365. package/src/shared/application/ports/decision.ts +14 -0
  366. package/src/shared/application/ports/files.ts +21 -0
  367. package/src/shared/application/ports/human.ts +38 -0
  368. package/src/shared/application/ports/llm.ts +83 -0
  369. package/src/shared/application/ports/memory.ts +30 -0
  370. package/src/shared/application/ports/progress.ts +23 -0
  371. package/src/shared/application/ports/runtime.ts +15 -0
  372. package/src/shared/application/ports/session.ts +74 -0
  373. package/src/shared/application/ports/shared-memory.ts +26 -0
  374. package/src/shared/application/ports/shell.ts +40 -0
  375. package/src/shared/application/ports/telemetry.ts +45 -0
  376. package/src/shared/application/ports/theme.ts +11 -0
  377. package/src/shared/application/ports/tools.ts +46 -0
  378. package/src/shared/application/ports/usage.ts +45 -0
  379. package/src/shared/application/ports.ts +29 -0
  380. package/src/shared/application/project-manifests.ts +106 -0
  381. package/src/shared/application/session-io.ts +85 -0
  382. package/src/shared/application/session-state.ts +36 -0
  383. package/src/shared/application/shared-memory/admit-entries.ts +179 -0
  384. package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
  385. package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
  386. package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
  387. package/src/shared/application/shared-memory/memory-files.ts +111 -0
  388. package/src/shared/application/shared-memory/memory-settings.ts +94 -0
  389. package/src/shared/application/shared-memory/messages.ts +63 -0
  390. package/src/shared/application/shared-memory/push-candidate.ts +149 -0
  391. package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
  392. package/src/shared/application/skills/messages.ts +4 -0
  393. package/src/shared/application/skills/suggest-skills.ts +102 -0
  394. package/src/shared/application/state-snapshot.ts +38 -0
  395. package/src/shared/application/workflow/messages.ts +8 -0
  396. package/src/shared/application/workflow/workflow-state.ts +136 -0
  397. package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
  398. package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
  399. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  400. package/src/shared/domain/agent-policy/messages.ts +66 -0
  401. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  402. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  403. package/src/shared/domain/agent-policy/path-rules.ts +299 -0
  404. package/src/shared/domain/agent-policy/permission.ts +625 -0
  405. package/src/shared/domain/agent-policy/prompts.ts +17 -0
  406. package/src/shared/domain/agent-policy/reasoning.ts +59 -0
  407. package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
  408. package/src/shared/domain/agent-policy/tool-access.ts +91 -0
  409. package/src/shared/domain/agent-registry.ts +143 -0
  410. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  411. package/src/shared/domain/agents/chain.ts +30 -0
  412. package/src/shared/domain/agents/charter.ts +64 -0
  413. package/src/shared/domain/agents/exclusive.ts +25 -0
  414. package/src/shared/domain/agents/instances.ts +252 -0
  415. package/src/shared/domain/agents/messages.ts +39 -0
  416. package/src/shared/domain/agents/model-route.ts +199 -0
  417. package/src/shared/domain/agents/prompts.ts +20 -0
  418. package/src/shared/domain/code-intel-contract.ts +357 -0
  419. package/src/shared/domain/code-intel-routing.ts +60 -0
  420. package/src/shared/domain/compact-outcome.ts +46 -0
  421. package/src/shared/domain/compaction-thresholds.ts +162 -0
  422. package/src/shared/domain/compaction.ts +288 -0
  423. package/src/shared/domain/config-schema.ts +434 -0
  424. package/src/shared/domain/context-prune.ts +176 -0
  425. package/src/shared/domain/decision/questions.ts +102 -0
  426. package/src/shared/domain/dev/access-cost.ts +230 -0
  427. package/src/shared/domain/dev/artefacts.ts +50 -0
  428. package/src/shared/domain/dev/batches-concurrency.ts +35 -0
  429. package/src/shared/domain/dev/batches-state.ts +49 -0
  430. package/src/shared/domain/dev/build-commands.ts +45 -0
  431. package/src/shared/domain/dev/call-guard.ts +342 -0
  432. package/src/shared/domain/dev/carried-text.ts +47 -0
  433. package/src/shared/domain/dev/design-rules.ts +100 -0
  434. package/src/shared/domain/dev/learn-proposals.ts +176 -0
  435. package/src/shared/domain/dev/learn-state.ts +94 -0
  436. package/src/shared/domain/dev/markers.ts +107 -0
  437. package/src/shared/domain/dev/messages.ts +259 -0
  438. package/src/shared/domain/dev/path-args.ts +42 -0
  439. package/src/shared/domain/dev/path-rebase.ts +93 -0
  440. package/src/shared/domain/dev/phase-timing.ts +50 -0
  441. package/src/shared/domain/dev/plan-checks.ts +191 -0
  442. package/src/shared/domain/dev/plan-format.ts +170 -0
  443. package/src/shared/domain/dev/project-files.ts +29 -0
  444. package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
  445. package/src/shared/domain/dev/prompts.ts +251 -0
  446. package/src/shared/domain/dev/questions.ts +267 -0
  447. package/src/shared/domain/dev/reading-rule.ts +41 -0
  448. package/src/shared/domain/dev/repo-pack.ts +240 -0
  449. package/src/shared/domain/dev/review-answer.ts +173 -0
  450. package/src/shared/domain/dev/review-brief.ts +54 -0
  451. package/src/shared/domain/dev/reviewer-charter.ts +35 -0
  452. package/src/shared/domain/dev/sheet-facts.ts +81 -0
  453. package/src/shared/domain/dev/spec-format.ts +182 -0
  454. package/src/shared/domain/dev/step-budget.ts +74 -0
  455. package/src/shared/domain/dev/step-rules.ts +109 -0
  456. package/src/shared/domain/dev/test-commands.ts +94 -0
  457. package/src/shared/domain/dev/test-output.ts +33 -0
  458. package/src/shared/domain/dev/test-paths.ts +40 -0
  459. package/src/shared/domain/dev/tool-guards.ts +65 -0
  460. package/src/shared/domain/dev/trait-pattern.ts +87 -0
  461. package/src/shared/domain/dev/verdict-format.ts +162 -0
  462. package/src/shared/domain/dev/whitespace.ts +35 -0
  463. package/src/shared/domain/dev/work-folder.ts +68 -0
  464. package/src/shared/domain/dev/yaml-subset.ts +385 -0
  465. package/src/shared/domain/error-text.ts +13 -0
  466. package/src/shared/domain/git/close.ts +274 -0
  467. package/src/shared/domain/git/messages.ts +20 -0
  468. package/src/shared/domain/git/pull-request.ts +96 -0
  469. package/src/shared/domain/git/worktree.ts +46 -0
  470. package/src/shared/domain/host-layout.ts +147 -0
  471. package/src/shared/domain/host-paths.ts +399 -0
  472. package/src/shared/domain/index-languages.ts +16 -0
  473. package/src/shared/domain/instructions-file.ts +18 -0
  474. package/src/shared/domain/iso-day.ts +4 -0
  475. package/src/shared/domain/llm-failure.ts +134 -0
  476. package/src/shared/domain/llm-profile.ts +44 -0
  477. package/src/shared/domain/marked-message.ts +29 -0
  478. package/src/shared/domain/markers.ts +30 -0
  479. package/src/shared/domain/messages.ts +291 -0
  480. package/src/shared/domain/model-catalog.ts +79 -0
  481. package/src/shared/domain/permission-modes.ts +99 -0
  482. package/src/shared/domain/prelude.ts +92 -0
  483. package/src/shared/domain/project-manifests.ts +84 -0
  484. package/src/shared/domain/prompts.ts +233 -0
  485. package/src/shared/domain/search-routing.ts +77 -0
  486. package/src/shared/domain/secret-patterns.ts +46 -0
  487. package/src/shared/domain/session-keys.ts +92 -0
  488. package/src/shared/domain/session-start.ts +61 -0
  489. package/src/shared/domain/severity.ts +72 -0
  490. package/src/shared/domain/sha1.ts +61 -0
  491. package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
  492. package/src/shared/domain/shared-memory/candidates.ts +40 -0
  493. package/src/shared/domain/shared-memory/entry.ts +151 -0
  494. package/src/shared/domain/shared-memory/front-matter.ts +187 -0
  495. package/src/shared/domain/shared-memory/gate.ts +45 -0
  496. package/src/shared/domain/shared-memory/harvest.ts +64 -0
  497. package/src/shared/domain/shared-memory/layout.ts +190 -0
  498. package/src/shared/domain/shared-memory/markers.ts +9 -0
  499. package/src/shared/domain/shared-memory/messages.ts +66 -0
  500. package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
  501. package/src/shared/domain/shared-memory/prompts.ts +28 -0
  502. package/src/shared/domain/shared-memory/refused.ts +84 -0
  503. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  504. package/src/shared/domain/skills/prompts.ts +4 -0
  505. package/src/shared/domain/skills/shortlist.ts +149 -0
  506. package/src/shared/domain/snip-turns.ts +33 -0
  507. package/src/shared/domain/speech.ts +21 -0
  508. package/src/shared/domain/strip.ts +88 -0
  509. package/src/shared/domain/tool-trace.ts +120 -0
  510. package/src/shared/domain/types.ts +67 -0
  511. package/src/shared/domain/verifiers.ts +33 -0
  512. package/src/shared/domain/vfs.ts +16 -0
  513. package/src/shared/domain/workflow/prompts.ts +15 -0
  514. package/src/shared/domain/workflow/state-file.ts +142 -0
  515. package/src/shared/infrastructure/globals.ts +57 -0
  516. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  517. package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
  518. package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
  519. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  520. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  521. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  522. package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
  523. package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
  524. package/src/shared/infrastructure/orkeon/files.ts +58 -0
  525. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
  526. package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
  527. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  528. package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
  529. package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
  530. package/src/shared/infrastructure/orkeon/llm.ts +164 -0
  531. package/src/shared/infrastructure/orkeon/markers.ts +6 -0
  532. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  533. package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
  534. package/src/shared/infrastructure/orkeon/messages.ts +15 -0
  535. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  536. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  537. package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
  538. package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
  539. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  540. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  541. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  542. package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
  543. package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
  544. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  545. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  546. package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
  547. package/src/shared/infrastructure/orkeon/shell.ts +39 -0
  548. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  549. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
  550. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  551. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  552. package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
@@ -0,0 +1,181 @@
1
+ // /model (E-1, hot-swap since B-10) — show the active model, or switch the model
2
+ // used by subsequent turns WITHOUT relaunching (baseline 04 §/model).
3
+ //
4
+ // How it works, and why the old deviation is gone. The provider still binds at
5
+ // host startup, so there is no second provider to switch to; what changed is that
6
+ // the loop now passes the preference to `ctx.llm.act` as `{ llm: { model } }`,
7
+ // which the scripting facade applies as a PATCH on the provider's own
8
+ // configuration. Credentials, endpoint and timeout are inherited; only the model
9
+ // name changes, for that call.
10
+ //
11
+ // Two limits, stated rather than discovered:
12
+ // - the override travels over the SAME provider, so it can only name a model
13
+ // that provider serves ('claude-…' on a DeepSeek endpoint is a 4xx from the
14
+ // API, not a local error);
15
+ // - the preference is session state, so /clear drops it back to the
16
+ // boot model;
17
+ // - `llm.profile` wins: under a profile the loop does not send the override (the
18
+ // profile names the model, and a decision profile's escalation target would get
19
+ // it too), so `show` names the profile and a switch warns that it is not sent.
20
+ //
21
+ // Framework note (the B-10 verification step): `LlmConfigOverride` — the Domain
22
+ // cascade vehicle — carries ResponseFormat/Temperature/MaxTokens/TopP/Thinking/
23
+ // Cache and NO model field, so it is not the vehicle here. The options bag is,
24
+ // and it needed a framework fix to be usable at all: call-time settings used to
25
+ // be built from LlmConfig.Default() and REPLACE the provider's config wholesale,
26
+ // which dropped the API key. Patched in Orkeon.Scripting (JsLlmFacade.ConfigFrom).
27
+
28
+ import type { Chooser, Logger, ReasoningReader, SessionMetadata, SessionStore, Telemetry } from "../../../shared/application/ports.ts";
29
+ import { DEFAULT_EFFORT, EFFORT_LEVELS, providerEffort } from "../../../shared/domain/agent-policy/behavior-flags.ts";
30
+ import { EFFORT_STATE_KEY, MODEL_PREFERENCE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
31
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
32
+ import { readLlmProfile } from "../../../shared/application/llm-profile.ts";
33
+ import { judgeModelChoice, renderModelList } from "../../../shared/domain/model-catalog.ts";
34
+ import { NO_CATALOGUE_NOTE } from "../../../shared/domain/messages.ts";
35
+ import type { CommandView } from "../view.ts";
36
+ import { optionsOf } from "./choices.ts";
37
+ import { runEffort, storedEffortWarning } from "./effort.ts";
38
+ import {
39
+ MODEL_CHOICE, MODEL_UNCHANGED, NO_EFFECTIVE_MODEL, OVERRIDE_CLEARED_NO_BOOT, declaredCatalogue, modelSet,
40
+ modelSetUndeclared, modelSetWarned, modelShown, overrideCleared, overrideNotSent, profileNamesModel,
41
+ profileWinsOverride,
42
+ } from "./messages.ts";
43
+
44
+ export interface ModelDeps {
45
+ session: Pick<SessionStore, "readState" | "writeState">;
46
+ telemetry: Pick<Telemetry, "readMetadata">;
47
+ /** Where the session's `llm.profile` is read: under a profile, the override is not sent. */
48
+ config: Pick<ConfigStore, "readValue" | "readFile">;
49
+ log: Pick<Logger, "warn">;
50
+ /** Where a bare /model opens a panel, when it can and there is something to pick. */
51
+ chooser?: Chooser;
52
+ /** What the model switched to makes of the effort /effort stored; absent: nothing is said of it. */
53
+ reasoning?: ReasoningReader;
54
+ }
55
+
56
+ /** `text`, then the warning when the stored effort does not go as asked on the model the turns now run on. */
57
+ async function withEffortWarning(text: string, deps: ModelDeps): Promise<string> {
58
+ const warning = await storedEffortWarning(deps);
59
+ return warning === "" ? text : `${text}\n${warning}`;
60
+ }
61
+
62
+ /**
63
+ * What the host reports as the active model, or "" when it reports nothing.
64
+ *
65
+ * `session_store get_metadata` is the ONLY channel a script has for this. It used
66
+ * to be empty in every host: `AddOrkeonSessionTools` registered the buffer as
67
+ * `new InMemorySessionBufferService()` and never passed the constructor's optional
68
+ * model, so `SessionMetadata.Model` was always null. Fixed framework-side; the
69
+ * empty case survives here because a host may still register no provider at all,
70
+ * and that case must be SAID rather than dressed up as a reading — the old
71
+ * "(unknown — reported by provider config)" claimed the provider had been asked.
72
+ */
73
+ async function readHostModels(telemetry: ModelDeps["telemetry"]): Promise<{ boot: string; declared: string[] }> {
74
+ const md = await telemetry.readMetadata().catch((): SessionMetadata => ({}));
75
+ return {
76
+ boot: (md.model ?? "").trim(),
77
+ // `Llm:AvailableModels` — what this host DECLARES the provider serves.
78
+ declared: md.availableModels ?? [],
79
+ };
80
+ }
81
+
82
+ /** `/model [show|list|reset|clear|<name>]`, from the command's raw tokens. */
83
+ export async function runModel(tokens: string[], deps: ModelDeps): Promise<CommandView> {
84
+ const { session, telemetry, config, log } = deps;
85
+ const first = (tokens[0] ?? "").toLowerCase();
86
+
87
+ // `show` is explicit; a bare /model does the same thing.
88
+ if (tokens.length === 0 || first === "show" || first === "list") {
89
+ const [{ boot, declared }, pref, { profile }] = await Promise.all([
90
+ readHostModels(telemetry),
91
+ session.readState(MODEL_PREFERENCE_STATE_KEY).catch(() => null),
92
+ readLlmProfile(config),
93
+ ]);
94
+ // Under a profile no declared model of the host is the effective one: the profile names its own.
95
+ const effective = profile === null ? pref || boot : "";
96
+ if (tokens.length === 0 && deps.chooser?.interactive && profile === null && declared.length > 0) {
97
+ return pickModel(deps, deps.chooser, { declared, effective, boot, override: pref ?? "" });
98
+ }
99
+ const catalogue = renderModelList(declared, effective);
100
+
101
+ // `/model list` is the catalogue alone — the question is "what can I pick".
102
+ if (first === "list") {
103
+ return { text: catalogue ? declaredCatalogue(catalogue) : NO_CATALOGUE_NOTE };
104
+ }
105
+
106
+ const override = pref ? (profile === null ? pref : overrideNotSent(pref)) : "(none)";
107
+ return { text: modelShown(effectiveLine(effective, profile), boot, override, catalogue, NO_CATALOGUE_NOTE) };
108
+ }
109
+
110
+ if (first === "reset" || first === "clear") {
111
+ await session.writeState(MODEL_PREFERENCE_STATE_KEY, "");
112
+ const { boot } = await readHostModels(telemetry);
113
+ return { text: await withEffortWarning(boot ? overrideCleared(boot) : OVERRIDE_CLEARED_NO_BOOT, deps) };
114
+ }
115
+
116
+ const requested = tokens.join(" ").trim();
117
+ // Checked against the declared list BEFORE writing, and applied either way: the
118
+ // list is a settings-file hint that may lag the provider, so refusing on it would
119
+ // block a model that works. The warning is the whole value here — without it the
120
+ // mistake surfaces one turn later as an API error buried in the log.
121
+ const { declared } = await readHostModels(telemetry);
122
+ const verdict = judgeModelChoice(declared, requested);
123
+ if (verdict.warning) log.warn(verdict.warning);
124
+ await session.writeState(MODEL_PREFERENCE_STATE_KEY, requested);
125
+ const { profile } = await readLlmProfile(config);
126
+ if (profile !== null) {
127
+ // Stored all the same: it applies again once the profile is unset.
128
+ const warning = profileWinsOverride(profile, requested);
129
+ log.warn(warning);
130
+ return { text: modelSetWarned(requested, warning) };
131
+ }
132
+ if (verdict.warning) {
133
+ // Terse inline, full reason in the log: in the split-pane console the two land
134
+ // in different panes, and repeating four lines verbatim next to themselves
135
+ // trains the eye to skip them.
136
+ return { text: await withEffortWarning(modelSetUndeclared(requested, declared), deps) };
137
+ }
138
+ return { text: await withEffortWarning(modelSet(requested), deps) };
139
+ }
140
+
141
+ /** The panel of a bare /model: the declared models, the effective one when the host does not declare it (Enter must
142
+ * not switch away from a model the list hides), the boot model when an override hides it, and the session's
143
+ * effort on the side arrows. Only what the answer changes is written, so opening it and pressing Enter turns no
144
+ * provider thinking on. */
145
+ async function pickModel(
146
+ deps: ModelDeps,
147
+ chooser: Chooser,
148
+ { declared, effective, boot, override }: { declared: string[]; effective: string; boot: string; override: string },
149
+ ): Promise<CommandView> {
150
+ const effort = providerEffort(await deps.session.readState(EFFORT_STATE_KEY).catch(() => null)) ?? DEFAULT_EFFORT;
151
+ const isDeclared = !effective || declared.some((name) => name.toLowerCase() === effective.toLowerCase());
152
+ const answer = await chooser.choose({
153
+ message: MODEL_CHOICE,
154
+ options: [
155
+ ...optionsOf(declared, effective),
156
+ ...(isDeclared ? [] : [{ value: effective, current: true }]),
157
+ ...(override ? [{ value: "reset", label: "Boot model", description: boot }] : []),
158
+ ],
159
+ control: { label: "Effort", values: EFFORT_LEVELS, value: effort },
160
+ });
161
+ if (!answer) return { text: MODEL_UNCHANGED };
162
+
163
+ const texts: string[] = [];
164
+ const newEffort = answer.control !== undefined && answer.control !== null && answer.control !== "" && answer.control !== effort;
165
+ if (answer.value.toLowerCase() !== effective.toLowerCase()) {
166
+ // With a new effort too, the level still stored is about to be replaced: the effort's own answer judges the
167
+ // new one on the new model.
168
+ const reasoning = newEffort ? undefined : deps.reasoning;
169
+ texts.push((await runModel([answer.value], { ...deps, chooser: undefined, reasoning })).text ?? "");
170
+ }
171
+ if (answer.control && newEffort) {
172
+ texts.push((await runEffort([answer.control], { session: deps.session, config: deps.config, reasoning: deps.reasoning })).text ?? "");
173
+ }
174
+ return { text: texts.length > 0 ? texts.join("\n") : MODEL_UNCHANGED };
175
+ }
176
+
177
+ /** The first line of `show`: the profile when one is set, else the effective model. */
178
+ function effectiveLine(effective: string, profile: string | null): string {
179
+ if (profile !== null) return profileNamesModel(profile);
180
+ return effective || NO_EFFECTIVE_MODEL;
181
+ }
@@ -0,0 +1,39 @@
1
+ // /output-style [<name>|show]: the session's answer style, consumed by the main-loop prompt assembly. One
2
+ // session-state key, deliberately not a /config key: two owners for one setting is how a value ends up read from the
3
+ // layer nobody wrote to.
4
+ import type { Chooser } from "../../../shared/application/ports.ts";
5
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
6
+ import { OUTPUT_STYLES, isOutputStyle } from "../../../shared/domain/agent-policy/output-styles.ts";
7
+ import { OUTPUT_STYLE_STATE_KEY } from "../../../shared/domain/session-keys.ts";
8
+ import type { CommandView } from "../view.ts";
9
+ import { optionsOf } from "./choices.ts";
10
+ import { OUTPUT_STYLE_CHOICE, OUTPUT_STYLE_UNCHANGED, outputStyleSet, outputStyleShown, unknownStyle } from "./messages.ts";
11
+
12
+ export interface OutputStyleDeps {
13
+ session: Pick<SessionIo, "readState" | "writeState">;
14
+ /** Where a bare /output-style opens a panel, when it can. */
15
+ chooser?: Chooser;
16
+ }
17
+
18
+ /** `/output-style [<name>|show]`, from the command's raw tokens. No argument opens a panel, or without one shows the
19
+ * style, as `show` does. */
20
+ export async function runOutputStyle(tokens: string[], deps: OutputStyleDeps): Promise<CommandView> {
21
+ const requested = (tokens[0] ?? "").trim();
22
+ const current = (await deps.session.readState(OUTPUT_STYLE_STATE_KEY)) ?? "default";
23
+
24
+ if (!requested && deps.chooser?.interactive) {
25
+ const answer = await deps.chooser.choose({
26
+ message: OUTPUT_STYLE_CHOICE,
27
+ options: optionsOf(OUTPUT_STYLES, current),
28
+ });
29
+ return answer ? runOutputStyle([answer.value], { session: deps.session }) : { text: OUTPUT_STYLE_UNCHANGED };
30
+ }
31
+ if (!requested || requested === "show") {
32
+ return { text: outputStyleShown(current, OUTPUT_STYLES) };
33
+ }
34
+ if (!isOutputStyle(requested)) {
35
+ return { text: unknownStyle(requested, OUTPUT_STYLES) };
36
+ }
37
+ await deps.session.writeState(OUTPUT_STYLE_STATE_KEY, requested);
38
+ return { text: outputStyleSet(requested) };
39
+ }
@@ -0,0 +1,287 @@
1
+ // /permissions — display the effective permission surface and manage the
2
+ // session's allow/deny rules.
3
+ //
4
+ // The rules live in the session state bag and the host's permission gate
5
+ // enforces them at each tool call (shared/application/permission-rules.ts): every
6
+ // change is written to the bag, then the gate is cleared and handed the whole
7
+ // list again, as it has no per-rule removal. A rule names a tool, and optionally
8
+ // an argument pattern: `allow shell_command command=npm test*`. The catalogue
9
+ // reads one kind of rule only — a deny covering every call of a tool removes the
10
+ // tool (agent-policy/permission.ts). A rule may name a built-in tool or one of
11
+ // the extra tools of `tools.extra`, registered by the host or not; a stored rule
12
+ // whose tool `tools.extra` no longer lists stays, dormant, until it lists it again
13
+ // or the rule is removed. The gate itself runs only when the host turned it on
14
+ // (Orkeon:Security:PermissionGate:Enabled); the host says whether it did
15
+ // (PermissionRules.enabled, Orkeon #128, which the runtime always reports) and the
16
+ // view says on or off. The last case of gateStateLines - no value - is for a fake
17
+ // or a port that says nothing: it names the setting and the launcher instead.
18
+
19
+ import type { PermissionRules, ToolCatalogue } from "../../../shared/application/ports.ts";
20
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
21
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
22
+ import { configuredNames, resolveExtraTools } from "../../../shared/application/extra-tools.ts";
23
+ import type { ExtraToolsResolution } from "../../../shared/application/extra-tools.ts";
24
+ import {
25
+ addPermissionRule, builtInRules, clearPermissionRules, readPermissionRules, removePermissionRule, syncPermissionRules,
26
+ } from "../../../shared/application/permission-rules.ts";
27
+ import { listsOf } from "../../../shared/application/host-context.ts";
28
+ import type { HostSource } from "../../../shared/application/host-context.ts";
29
+ import {
30
+ USER_CONFIG_MOUNT, listedEntries, pathListRules, userConfigRules,
31
+ } from "../../../shared/domain/agent-policy/path-rules.ts";
32
+ import type { StoredRules } from "../../../shared/application/permission-rules.ts";
33
+ import { readMemoryDir } from "../../../shared/application/shared-memory/memory-settings.ts";
34
+ import { memoryWriteRules } from "../../../shared/domain/shared-memory/layout.ts";
35
+ import { PERMISSION_FALLBACK_CONFIG_KEY, PERMISSION_MODES } from "../../../shared/domain/permission-modes.ts";
36
+ import { EXTRA_TOOLS_CONFIG_KEY } from "../../../shared/domain/agent-policy/extra-tools.ts";
37
+ import {
38
+ catalogueFor, checkRule, formatRule, gateLine, isReadOnly, readRule, sameCalls, toolsetFor,
39
+ ACT_TOOLS,
40
+ MEMORY_TOOLS,
41
+ RULEABLE_TOOLS,
42
+ scriptToolAccess,
43
+ scriptToolsFor,
44
+ } from "../../../shared/domain/agent-policy/permission.ts";
45
+ import type { ExtraTool, PermissionRule } from "../../../shared/domain/agent-policy/permission.ts";
46
+ import { heldRuleSets } from "../../../shared/domain/agent-policy/rule-sets.ts";
47
+ import { nestedConfigKeys } from "../../../shared/domain/config-schema.ts";
48
+ import type { CommandView } from "../view.ts";
49
+ import {
50
+ ALL_RULES_CLEARED, DORMANT_NOT_LISTED, ENFORCEMENT_LINES, EVERY_CALL, GATE_HOLDS_OTHER_RULES, GATE_HOLDS_RULE_SETS,
51
+ GATE_OFF_LINES, GATE_ON_LINES, GATE_UNKNOWN_LINES, HOST_KEEPS_NO_RULES, INVALID_RULE_GRAMMAR, NO_GATE_RULES,
52
+ NO_PERMISSION_RULES, PERMISSIONS_USAGE, SET_BY_MODE, USER_SETTINGS_UNREADABLE, catalogueOfMode, dormantRule,
53
+ extraToolNotOffered, extraToolsUnreadableWarning, fallbackIgnored, inertRule, invalidRule, invalidStoredEntries, memoryGuard,
54
+ modesLine, nestedKey, noSuchRule, pathsDenyGuard, ruleAdded, ruleNoEffect, ruleRemoved, ruleSetsOfLastStep,
55
+ userConfigGuard, sessionDefaultLine, sourceLine, toolCatalogueLine, withheldLine, removedLine, extraToolsLine,
56
+ sessionRulesLine, hostGateLine,
57
+ } from "./messages.ts";
58
+
59
+ export interface PermissionsDeps {
60
+ session: Pick<SessionIo, "readDefaultPermissionMode" | "resolveSessionFallbackMode" | "readState" | "writeState">;
61
+ gate: PermissionRules;
62
+ /** Reads `tools.extra`, the extra tools a rule may name, and what the project file
63
+ * could not widen (QL-06). */
64
+ config: Pick<ConfigStore, "readValue" | "readFile" | "readUserFile">;
65
+ /** The tools the host registers: the catalogue offers the extra tools it has. */
66
+ catalogue: Pick<ToolCatalogue, "find">;
67
+ /** This run's host context, for its path lists (paths.deny in the gate); absent: no list. */
68
+ host?: HostSource;
69
+ }
70
+
71
+ /** The mode a turn without a `mode:` prefix runs in: /mode's, else the fallback. */
72
+ async function sessionMode(session: PermissionsDeps["session"]): Promise<string> {
73
+ return (await session.readDefaultPermissionMode()) ?? (await session.resolveSessionFallbackMode()).mode;
74
+ }
75
+
76
+ /** An extra tool as `/permissions` shows it: `search_issues (write)`. */
77
+ function describeExtra(tool: ExtraTool): string {
78
+ return `${tool.name} (${tool.access})`;
79
+ }
80
+
81
+ /** The scope of a rule, for the `list` table. */
82
+ function callsOf(rule: PermissionRule): string {
83
+ return rule.argument === undefined ? EVERY_CALL : `${rule.argument}=${rule.pattern}`;
84
+ }
85
+
86
+ /** What the stored rules hold that the gate does not get, and a setting that could not be read. */
87
+ function storedNotes(stored: StoredRules, extras: ExtraToolsResolution): string[] {
88
+ return [
89
+ ...(extras.unreadable === undefined
90
+ ? []
91
+ : [extraToolsUnreadableWarning(extras.unreadable)]),
92
+ ...stored.dormant.map(dormantRule),
93
+ ...(stored.invalid.length > 0 ? [invalidStoredEntries(stored.invalid)] : []),
94
+ ];
95
+ }
96
+
97
+ /** What a sync must report: a gate that holds none, rules it did not get. */
98
+ function syncNotes(sync: StoredRules & { applied: boolean }, extras: ExtraToolsResolution): string[] {
99
+ return [...(sync.applied ? [] : [NO_GATE_RULES]), ...storedNotes(sync, extras)];
100
+ }
101
+
102
+ /** What the project file set and could not widen (QL-06), and user settings that could not be read. */
103
+ async function widenedNotes(config: PermissionsDeps["config"]): Promise<{ fallback: string[]; notes: string[] }> {
104
+ const [fallback, extra, user, project] = await Promise.all([
105
+ config.readValue(PERMISSION_FALLBACK_CONFIG_KEY).catch(() => undefined),
106
+ config.readValue(EXTRA_TOOLS_CONFIG_KEY).catch(() => undefined),
107
+ config.readUserFile().catch(() => ({ malformed: true, map: {} })),
108
+ config.readFile().catch(() => ({ map: {} })),
109
+ ]);
110
+ const nested = [...new Set([project.map, user.map].flatMap(nestedConfigKeys))]
111
+ .filter((key) => key === PERMISSION_FALLBACK_CONFIG_KEY || key === EXTRA_TOOLS_CONFIG_KEY);
112
+ return {
113
+ fallback: fallback?.ignored === undefined
114
+ ? []
115
+ : [fallbackIgnored(fallback.ignored.value, fallback.ignored.reason)],
116
+ notes: [
117
+ ...(user.malformed ? [USER_SETTINGS_UNREADABLE] : []),
118
+ ...nested.map(nestedKey),
119
+ ...(extra?.ignored === undefined ? [] : [extraToolNotOffered(extra.ignored.value, extra.ignored.reason)]),
120
+ ],
121
+ };
122
+ }
123
+
124
+ /** The effective surface: mode, catalogue, rules and what the gate holds. */
125
+ async function renderShow(deps: PermissionsDeps, extras: ExtraToolsResolution): Promise<string> {
126
+ const { session, gate } = deps;
127
+ const sessionDefault = await session.readDefaultPermissionMode();
128
+ const fallback = await session.resolveSessionFallbackMode();
129
+ const mode = sessionDefault ?? fallback.mode;
130
+ const widened = await widenedNotes(deps.config);
131
+ const stored = await readPermissionRules(session, configuredNames(extras));
132
+ const { rules } = stored;
133
+ const decision = catalogueFor(mode, rules, extras.present);
134
+ const gateOn = gate.enabled();
135
+ // What the gate holds beyond the session's rules: the shared memory's guard every sync adds, then the
136
+ // built-in rule sets (a dev step's), grouped.
137
+ const sessionLines = rules.map(gateLine);
138
+ const memoryDir = (await readMemoryDir(deps.config)).dir;
139
+ const lists = await listsOf(deps.host);
140
+ const memoryLines = memoryWriteRules(memoryDir).map(gateLine);
141
+ const userConfigLines = userConfigRules().map(gateLine);
142
+ const pathLines = pathListRules(lists).map(gateLine);
143
+ const builtInLines = [...memoryLines, ...userConfigLines, ...pathLines];
144
+ const all = gate.available() ? gate.list() : null;
145
+ const guarded = all === null ? [] : all.filter((l) => builtInLines.includes(l) && !sessionLines.includes(l));
146
+ const guardedOf = (lines: string[]): number => guarded.filter((l) => lines.includes(l)).length;
147
+ const held = all === null ? null : all.filter((l) => !guarded.includes(l));
148
+ const grouped = held === null ? null : heldRuleSets(held.filter((l) => !sessionLines.includes(l)));
149
+ const setLines = new Set(held === null || grouped === null
150
+ ? []
151
+ : held.filter((l) => !sessionLines.includes(l) && !grouped.rest.includes(l)));
152
+ const plain = held === null ? null : held.filter((l) => !setLines.has(l));
153
+ const setParts = grouped !== null && grouped.sets.length > 0
154
+ ? [ruleSetsOfLastStep(grouped.sets.map((g) => `${g.id} (${g.count} rules)`).join(", "))]
155
+ : [];
156
+ const guardParts = [
157
+ ...(guardedOf(memoryLines) > 0
158
+ ? [memoryGuard(memoryDir, guardedOf(memoryLines))]
159
+ : []),
160
+ ...(guardedOf(userConfigLines) > 0
161
+ ? [userConfigGuard(USER_CONFIG_MOUNT, guardedOf(userConfigLines))]
162
+ : []),
163
+ ...(guardedOf(pathLines) > 0
164
+ ? [pathsDenyGuard(listedEntries(lists.deny).join(", "), guardedOf(pathLines))]
165
+ : []),
166
+ ];
167
+ const heldParts = plain === null ? [] : [...(plain.length > 0 ? [plain.join(", ")] : []), ...setParts, ...guardParts];
168
+
169
+ // The shared memory's tools are the main loop's, offered by mode (memory_recall always, memory_push where the
170
+ // mode edits) less a deny rule on the whole tool; Orkeon Code's other tools (SCRIPT_TOOLS) belong to the dev
171
+ // crews that attach them, never to the session.
172
+ const memoryByMode = scriptToolsFor(mode, MEMORY_TOOLS);
173
+ const memory = scriptToolsFor(mode, MEMORY_TOOLS, rules);
174
+ const offered = [...toolsetFor(mode, extras.present), ...memoryByMode];
175
+ // The host offers the ACT_TOOLS to every act, and its gate refuses them in the read-only modes only.
176
+ const withheld = (t: string) => MEMORY_TOOLS.includes(t)
177
+ || ((isReadOnly(mode) || !ACT_TOOLS.includes(t)) && scriptToolAccess(t) === undefined);
178
+ const vocabulary = [...RULEABLE_TOOLS.filter(withheld), ...extras.present.map((t) => t.name)];
179
+ const lines = [
180
+ sessionDefaultLine(mode, isReadOnly(mode)),
181
+ sourceLine(sessionDefault ? SET_BY_MODE : fallback.explanation),
182
+ ...widened.fallback,
183
+ modesLine(PERMISSION_MODES.join(", ")),
184
+ toolCatalogueLine([...decision.tools, ...memory].join(", ")),
185
+ withheldLine(vocabulary.filter((t) => !offered.includes(t)).join(", ")),
186
+ removedLine([...decision.deniedByRule, ...memoryByMode.filter((t) => !memory.includes(t))].join(", ")),
187
+ ...(extras.present.length + extras.missing.length + extras.invalid.length > 0
188
+ ? [extraToolsLine(extras.present.map(describeExtra).join(", "), extras.missing.map(describeExtra), extras.invalid)]
189
+ : []),
190
+ sessionRulesLine(rules.map(formatRule).join(", "), stored.dormant),
191
+ plain === null ? hostGateLine(HOST_KEEPS_NO_RULES) : hostGateLine(heldParts.join("; ")),
192
+ ...ENFORCEMENT_LINES,
193
+ ...gateStateLines(gateOn),
194
+ ];
195
+
196
+ for (const r of decision.inert) {
197
+ lines.push(inertRule(formatRule(r.rule), mode, r.reason));
198
+ }
199
+ if (plain !== null && plain.join("\n") !== sessionLines.join("\n")) {
200
+ lines.push(GATE_HOLDS_OTHER_RULES);
201
+ } else if (setParts.length > 0) {
202
+ lines.push(GATE_HOLDS_RULE_SETS);
203
+ }
204
+ lines.push(...widened.notes, ...storedNotes(stored, extras));
205
+ return lines.join("\n");
206
+ }
207
+
208
+ /** The closing lines of the enforcement block: what the host says of its gate. */
209
+ function gateStateLines(on: boolean | undefined): string[] {
210
+ if (on === true) return [...GATE_ON_LINES];
211
+ if (on === false) return [...GATE_OFF_LINES];
212
+ return [...GATE_UNKNOWN_LINES];
213
+ }
214
+
215
+ /** `/permissions [show|list|add|remove|clear] …`, from the command's raw tokens. */
216
+ export async function runPermissions(tokens: string[], deps: PermissionsDeps): Promise<CommandView> {
217
+ const { session, gate } = deps;
218
+ const [sub, ...ruleTokens] = tokens;
219
+ const ruleText = ruleTokens.join(" ");
220
+ const extras = await resolveExtraTools(deps);
221
+ const extraNames = configuredNames(extras);
222
+ const builtIn = builtInRules((await readMemoryDir(deps.config)).dir, await listsOf(deps.host));
223
+ const sync = () => syncPermissionRules({ session, gate, extraNames, builtIn });
224
+ switch ((sub ?? "show").toLowerCase()) {
225
+ case "show":
226
+ return { text: await renderShow(deps, extras) };
227
+
228
+ case "list": {
229
+ const stored = await readPermissionRules(session, extraNames);
230
+ const dormant = stored.dormant.map(readRule).filter((r): r is PermissionRule => r !== null);
231
+ if (stored.rules.length + dormant.length === 0) {
232
+ return { text: [NO_PERMISSION_RULES, ...storedNotes(stored, extras)].join("\n") };
233
+ }
234
+ const notes = storedNotes({ ...stored, dormant: [] }, extras);
235
+ return {
236
+ table: [
237
+ ...stored.rules.map((r) => ({ effect: r.effect, tool: r.tool, calls: callsOf(r), state: "enforced" })),
238
+ ...dormant.map((r) => ({
239
+ effect: r.effect, tool: r.tool, calls: callsOf(r), state: DORMANT_NOT_LISTED,
240
+ })),
241
+ ],
242
+ text: notes.length > 0 ? notes.join("\n") : undefined,
243
+ };
244
+ }
245
+
246
+ case "add": {
247
+ const check = checkRule(ruleText, extraNames);
248
+ if (!check.ok) return { text: invalidRule(check.reason) };
249
+ const { rule } = check;
250
+ await addPermissionRule(session, rule);
251
+ const synced = await sync();
252
+ const mode = await sessionMode(session);
253
+ const decision = catalogueFor(mode, synced.rules, extras.present);
254
+ const inert = decision.inert.find((r) => r.rule.effect === rule.effect && sameCalls(r.rule, rule));
255
+ return {
256
+ text: [
257
+ ruleAdded(formatRule(rule)),
258
+ ...(check.warning ? [`⚠ ${check.warning}`] : []),
259
+ ...(inert ? [ruleNoEffect(mode, inert.reason)] : []),
260
+ catalogueOfMode(mode, decision.tools.join(", ") || "(empty)"),
261
+ ...syncNotes(synced, extras),
262
+ ].join("\n"),
263
+ };
264
+ }
265
+
266
+ case "remove": {
267
+ // Read by the grammar alone: a dormant rule, whose tool is not known now, is removed too.
268
+ const rule = readRule(ruleText);
269
+ if (!rule) return { text: INVALID_RULE_GRAMMAR };
270
+ const removed = await removePermissionRule(session, rule);
271
+ if (removed.length === 0) return { text: noSuchRule(formatRule(rule)) };
272
+ const synced = await sync();
273
+ return { text: [ruleRemoved(formatRule(removed[0])), ...syncNotes(synced, extras)].join("\n") };
274
+ }
275
+
276
+ case "clear": {
277
+ await clearPermissionRules(session);
278
+ const synced = await sync();
279
+ return {
280
+ text: [ALL_RULES_CLEARED, ...syncNotes(synced, extras)].join("\n"),
281
+ };
282
+ }
283
+
284
+ default:
285
+ return { text: PERMISSIONS_USAGE };
286
+ }
287
+ }
@@ -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
+ }
@@ -0,0 +1,49 @@
1
+ // Session-scoped toggles shared by the slash commands (/fast, /proactive). Values
2
+ // live in the session state bag (session_store
3
+ // get_state/set_state) so they survive crew runs and are cleared by
4
+ // /clear. Each helper takes the session it works on, so a test runs it
5
+ // over FakeSessionStore; the entry points pass orkeonSessionIo(). Lives under
6
+ // commands/_lib/ — the loader's SearchPattern is "*.cmd.ts", so this file is
7
+ // never loaded as a command.
8
+
9
+ import type { SessionStore } from "../../../shared/application/ports.ts";
10
+ import { rawTokens } from "../args.ts";
11
+
12
+ /** Read a boolean flag ("true"/"false" strings in the bag; default false). */
13
+ async function readFlag(session: Pick<SessionStore, "readState">, key: string): Promise<boolean> {
14
+ try {
15
+ return (await session.readState(key)) === "true";
16
+ } catch {
17
+ return false;
18
+ }
19
+ }
20
+
21
+ /** A toggle command's descriptor, for its entry point to register with defineCommand. */
22
+ export interface ToggleCommand {
23
+ name: string;
24
+ description: string;
25
+ handler<R>(args: { readonly raw?: unknown }, ctx: { continue(message: string): R }): Promise<R>;
26
+ }
27
+
28
+ /**
29
+ * A `/name [on|off]` toggle command over one boolean state key — bare
30
+ * invocation flips the flag, `on`/`off` set it explicitly. `note` is appended
31
+ * to the confirmation so each command states what consumes the flag. The entry
32
+ * point registers it: `defineCommand(toggleCommand(spec, session))`.
33
+ */
34
+ export function toggleCommand(
35
+ spec: { name: string; description: string; key: string; note: string },
36
+ session: Pick<SessionStore, "readState" | "writeState">,
37
+ ): ToggleCommand {
38
+ return {
39
+ name: spec.name,
40
+ description: spec.description,
41
+ async handler(args, ctx) {
42
+ const token = String(rawTokens(args)[0] ?? "").toLowerCase();
43
+ const current = await readFlag(session, spec.key);
44
+ const next = token === "on" ? true : token === "off" ? false : !current;
45
+ await session.writeState(spec.key, String(next));
46
+ return ctx.continue(`${spec.name}: ${next ? "on" : "off"} (${spec.note}; /clear clears it).`);
47
+ },
48
+ };
49
+ }