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
@@ -8,6 +8,11 @@
8
8
 
9
9
  import { policyFor } from "./mode-policy.ts";
10
10
  import type { ToolClass } from "./mode-policy.ts";
11
+ import {
12
+ argumentsNotKnown, hasNoArgument, modeDoesNotOffer, noToolARuleMayName, offeredToEveryAct, PLAN_IGNORES_ALLOW_RULES,
13
+ takesNoArgument,
14
+ } from "./messages.ts";
15
+ import { MAY_ACT_CLAUSE, READ_ONLY_CLAUSE } from "./prompts.ts";
11
16
 
12
17
  /** Read-side tools (inspection + the read-only RaggableTree index queries). */
13
18
  export const READ_TOOLS = [
@@ -54,11 +59,14 @@ export const READ_TOOLS = [
54
59
  * agent's own list; it never enters the DI catalogue the scripting bridge draws
55
60
  * from. "Framework-registered and auto-bridged" holds for http_api, not for it.
56
61
  *
62
+ * `firefox` (Orkeon #293) is filed here whatever its action: its reads load pages, and a page load is an outbound
63
+ * request, so `plan` and `dontAsk` go without it although the runtime lets its reads pass in plan.
64
+ *
57
65
  * `spawn_agent` is the script host's own tool, appended to every act whatever
58
66
  * `.tools([...])` names (naming it there fails the act): it is ruleable
59
67
  * (ACT_TOOLS) and never named in a catalogue.
60
68
  */
61
- export const NETWORK_READ_TOOLS = ["http_api", "web_scrape", "scrape_element"];
69
+ export const NETWORK_READ_TOOLS = ["http_api", "web_scrape", "scrape_element", "firefox"];
62
70
 
63
71
  /** The built-in tools of each class a mode policy grants: each tool is named
64
72
  * once, here or in the lists above, and every other list derives from this table. */
@@ -117,10 +125,7 @@ export function toolsetFor(mode: string, extras: readonly ExtraTool[] = []): str
117
125
 
118
126
  /** The permission clause appended to the act() prompt. */
119
127
  export function permissionNote(mode: string): string {
120
- const clause = isReadOnly(mode)
121
- ? "Read-only: read and search the project, but MUST NOT modify files, run commands or fetch anything over the " +
122
- "network; answer with an assessment or a plan."
123
- : "You may edit files, run shell commands and fetch over the network; the host may ask the user before a call.";
128
+ const clause = isReadOnly(mode) ? READ_ONLY_CLAUSE : MAY_ACT_CLAUSE;
124
129
  return `(Permission mode: ${mode}. ${clause})`;
125
130
  }
126
131
 
@@ -255,6 +260,7 @@ export const TOOL_ARGUMENTS: Readonly<Record<string, readonly string[]>> = {
255
260
  http_api: ["url", "method", "headers", "body", "content_type"],
256
261
  web_scrape: ["url", "selector", "cached", "chunk_size"],
257
262
  scrape_element: ["url", "css_selector", "extract_attributes", "include_html", "max_elements"],
263
+ firefox: ["action", "url", "node_id", "kind", "name", "query", "text", "key", "script", "save_to_path", "max_nodes", "offset", "tab", "profile"],
258
264
  file_write: ["path", "content", "encoding", "append", "create_backup"],
259
265
  shell_command: ["command", "working_directory", "timeout_seconds", "action", "job_id", "tail_lines"],
260
266
  // The tools of Orkeon #180, each with the depth-1 keys of its input (orkeon.d.ts, OrkeonBuiltInTools).
@@ -271,7 +277,7 @@ export const TOOL_ARGUMENTS: Readonly<Record<string, readonly string[]>> = {
271
277
  // - batch_anchors.a and .b are {fqns, files}, for action "overlap"; "closure" takes fqns or files.
272
278
  // - arrays or objects: rag_ingest.sources, access_cost.*, affected_tests.changed_files,
273
279
  // sub_graph.seeds|edge_kinds|node_kinds, edge_list.edge_kinds, structural_search.paths|rule,
274
- // count_pattern.patterns, statement_query.kinds|parent_fqns, incremental_reindex.changed_files|languages.
280
+ // count_pattern.patterns, statement_query.kinds|parent_fqns, incremental_reindex.changed_files.
275
281
  glob: ["max_results", "path", "pattern"],
276
282
  grep: ["case_insensitive", "glob", "max_files", "max_results", "output_mode", "path", "pattern"],
277
283
  list_mounts: [],
@@ -283,7 +289,7 @@ export const TOOL_ARGUMENTS: Readonly<Record<string, readonly string[]>> = {
283
289
  documented_in: ["fqn"],
284
290
  documents_of: ["path"],
285
291
  structural_search: ["glob", "language", "max_files", "max_results", "paths", "pattern", "rule", "rule_file"],
286
- incremental_reindex: ["changed_files", "enrich_with_llm", "from_commit", "languages", "root_path", "to_commit"],
292
+ incremental_reindex: ["changed_files", "from_commit", "root_path", "to_commit"],
287
293
  count_pattern: ["distinct_matches", "include_matches", "max_matches_returned", "multiline", "path", "patterns"],
288
294
  statement_query: ["kinds", "parent_fqns", "semantic_query", "top_k"],
289
295
  complexity_report: ["metric", "root_fqn", "top_n"],
@@ -352,14 +358,12 @@ function inertReason(mode: string, rule: PermissionRule, offered: readonly strin
352
358
  // The gate reads no allow rule in plan (ModePermissionGate): plan's promise of a
353
359
  // turn that changes nothing outranks the session's rules.
354
360
  if (mode === "plan") {
355
- return "mode 'plan' ignores every allow rule: the gate decides each call from the mode, which runs reads " +
356
- "and refuses the rest. Switch mode instead.";
361
+ return PLAN_IGNORES_ALLOW_RULES;
357
362
  }
358
363
  // An ACT_TOOLS tool reaches the gate from every act whatever the catalogue: the gate reads an allow
359
364
  // rule on it in every other mode, dontAsk included.
360
365
  if (!offered.includes(rule.tool) && !isActTool(rule.tool)) {
361
- return `mode '${mode}' does not offer '${rule.tool}': an allow rule spares a question, ` +
362
- "it does not hand a tool over. Switch mode instead.";
366
+ return modeDoesNotOffer(mode, rule.tool);
363
367
  }
364
368
  return undefined;
365
369
  }
@@ -466,7 +470,7 @@ export function checkRule(text: unknown, extraNames: readonly string[] = []): Ru
466
470
  const tool = ruleableTool(read.tool, extraNames);
467
471
  if (tool === undefined) {
468
472
  const tools = [...RULEABLE_TOOLS, ...extraNames].join(", ");
469
- return { ok: false, reason: `'${read.tool}' is no tool a rule may name: one of ${tools}` };
473
+ return { ok: false, reason: noToolARuleMayName(read.tool, tools) };
470
474
  }
471
475
  const rule = { ...read, tool };
472
476
  // The gate reads an allow rule on an ACT_TOOLS tool in every mode but plan: say so, refuse nothing.
@@ -474,8 +478,7 @@ export function checkRule(text: unknown, extraNames: readonly string[] = []): Ru
474
478
  ? {
475
479
  ok: true,
476
480
  rule,
477
- warning: `'${tool}' is offered to every act whatever the mode: an allow rule lets it run without asking in ` +
478
- "dontAsk too.",
481
+ warning: offeredToEveryAct(tool),
479
482
  }
480
483
  : { ok: true, rule };
481
484
  if (rule.argument === undefined) return accepted;
@@ -484,16 +487,15 @@ export function checkRule(text: unknown, extraNames: readonly string[] = []): Ru
484
487
  return {
485
488
  ok: true,
486
489
  rule,
487
- warning: `the arguments of '${tool}' are not known here (its MCP server or plugin declares them): the rule ` +
488
- `matches a call only if '${tool}' takes an argument named exactly '${rule.argument}'.`,
490
+ warning: argumentsNotKnown(tool, rule.argument),
489
491
  };
490
492
  }
491
493
  if (known.includes(rule.argument)) return accepted;
492
494
  return {
493
495
  ok: false,
494
496
  reason: known.length === 0
495
- ? `'${tool}' takes no argument: a rule on it covers every call`
496
- : `'${tool}' has no argument '${rule.argument}': it takes ${known.join(", ")}`,
497
+ ? takesNoArgument(tool)
498
+ : hasNoArgument(tool, rule.argument, known),
497
499
  };
498
500
  }
499
501
 
@@ -0,0 +1,17 @@
1
+ // The prompts of shared/domain/agent-policy: the text the model reads (ADR 0026).
2
+
3
+ /** The permission clause of a read-only mode, and of the others. */
4
+ export const READ_ONLY_CLAUSE =
5
+ "Read-only: read and search the project, but MUST NOT modify files, run commands or fetch anything over the " +
6
+ "network; answer with an assessment or a plan.";
7
+ export const MAY_ACT_CLAUSE =
8
+ "You may edit files, run shell commands and fetch over the network; the host may ask the user before a call.";
9
+
10
+ /**
11
+ * Appended to the task block (last, with the request) rather than added as its
12
+ * own context block: it is an instruction about the ANSWER's shape, and the
13
+ * furthest thing from the task is the easiest for a model to lose.
14
+ */
15
+ export const PROACTIVE_CLAUSE =
16
+ "(Proactive mode: after the answer, suggest at most three concrete next steps under " +
17
+ "'Next steps'; leave the list out when the work is self-contained.)";
@@ -0,0 +1,59 @@
1
+ // What a model takes for reasoning and what becomes of an effort asked, as the runtime judges them (Orkeon #359,
2
+ // #360): the capability table of the host, the provider's own levels, the model's entry. Nothing here repeats that
3
+ // rule: these are the shapes the runtime answers with, read from whatever object it hands over. Pure.
4
+ import { isEffortLevel } from "./behavior-flags.ts";
5
+ import type { EffortLevel } from "./behavior-flags.ts";
6
+
7
+ /** What the session's turns run on: the session's `llm.profile`, else the /model override, else the host's own
8
+ * model. A profile wins over the model, as it does in the main loop. */
9
+ export interface ReasoningTarget {
10
+ profile: string | null;
11
+ model: string;
12
+ }
13
+
14
+ /** What a provider and one of its models take for reasoning. */
15
+ export interface ReasoningCapabilities {
16
+ model: string;
17
+ /** Whether the capability table knows the model; when it does not, an effort is sent unchecked. */
18
+ known: boolean;
19
+ /** The levels sent as asked, in order; empty when the model takes no effort. */
20
+ efforts: readonly EffortLevel[];
21
+ }
22
+
23
+ export const EFFORT_NOTICES = ["lowered", "dropped", "unchecked"] as const;
24
+ export type EffortNotice = (typeof EFFORT_NOTICES)[number];
25
+
26
+ /** What the runtime does with an effort asked. */
27
+ export interface EffortReport {
28
+ model: string;
29
+ asked: EffortLevel;
30
+ /** What the provider receives; null when no effort goes out. */
31
+ sent: string | null;
32
+ /** Null when the effort goes as asked on a model the table knows. */
33
+ notice: EffortNotice | null;
34
+ }
35
+
36
+ function fieldsOf(raw: unknown): Record<string, unknown> | null {
37
+ return raw !== null && typeof raw === "object" ? (raw as Record<string, unknown>) : null;
38
+ }
39
+
40
+ /** The capabilities the runtime answered; null when it answered none, or something that names no model. */
41
+ export function capabilitiesOf(raw: unknown): ReasoningCapabilities | null {
42
+ const fields = fieldsOf(raw);
43
+ if (fields === null || typeof fields.model !== "string") return null;
44
+ const efforts = Array.isArray(fields.efforts) ? fields.efforts.filter((level): level is EffortLevel => isEffortLevel(level)) : [];
45
+ return { model: fields.model, known: fields.known === true, efforts };
46
+ }
47
+
48
+ /** The report the runtime answered; null when it answered none (no effort asked, no provider), or one whose asked
49
+ * level is not a level. */
50
+ export function effortReportOf(raw: unknown): EffortReport | null {
51
+ const fields = fieldsOf(raw);
52
+ if (fields === null || typeof fields.model !== "string" || !isEffortLevel(fields.asked)) return null;
53
+ return {
54
+ model: fields.model,
55
+ asked: fields.asked,
56
+ sent: typeof fields.sent === "string" ? fields.sent : null,
57
+ notice: EFFORT_NOTICES.find((notice) => notice === fields.notice) ?? null,
58
+ };
59
+ }
@@ -10,6 +10,10 @@
10
10
  import { gateLine, sameCalls } from "./permission.ts";
11
11
  import type { PermissionRule } from "./permission.ts";
12
12
  import { WORKSPACE, workspaceRelative } from "../vfs.ts";
13
+ import {
14
+ GIT_READONLY_TITLE, INLINE_INTERPRETERS_TITLE, patternClimbsOut, patternOutside, patternWholeProject,
15
+ READ_NOISE_TITLE, rootClimbsOut, rootHoldsStar, rootOutside, rootWholeProject, SECRETS_TITLE, STATE_FILES_TITLE,
16
+ } from "./messages.ts";
13
17
 
14
18
  export type RuleSetId = "git-readonly" | "inline-interpreters" | "read-noise" | "secrets" | "state-files";
15
19
 
@@ -215,7 +219,7 @@ export const OPERATION_TOOLS: Readonly<Record<string, string>> = {
215
219
  };
216
220
 
217
221
  /** A deny on every call of each tool. */
218
- function denyWhole(tools: readonly string[]): PermissionRule[] {
222
+ export function denyWhole(tools: readonly string[]): PermissionRule[] {
219
223
  return tools.map((tool): PermissionRule => ({ effect: "deny", tool }));
220
224
  }
221
225
 
@@ -229,14 +233,14 @@ const STATE_ENTRIES: readonly string[] = [
229
233
  "dev", "memory", "agent", "sessions", "hooks", "shared", "repo", "config", "state", "orkeon", "ORKEON_", "forge", "rag",
230
234
  ];
231
235
 
232
- function denyEach(tools: readonly string[], argument: string, patterns: readonly string[]): PermissionRule[] {
236
+ export function denyEach(tools: readonly string[], argument: string, patterns: readonly string[]): PermissionRule[] {
233
237
  return tools.flatMap((tool) => denyAll(tool, argument, patterns));
234
238
  }
235
239
 
236
240
  export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
237
241
  "git-readonly": {
238
242
  id: "git-readonly",
239
- title: "git commands that change the repository, its branches or its remotes",
243
+ title: GIT_READONLY_TITLE,
240
244
  rules: denyAll("shell_command", "command", [
241
245
  ...GIT_MUTATING_VERBS.flatMap(gitPatterns),
242
246
  // `-c key=value` sets a config for one command, and core.pager or core.sshCommand run a program.
@@ -245,7 +249,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
245
249
  },
246
250
  "inline-interpreters": {
247
251
  id: "inline-interpreters",
248
- title: "code handed inline to an interpreter, which could run what the other rules refuse",
252
+ title: INLINE_INTERPRETERS_TITLE,
249
253
  // `*sh -c*` covers bash, sh, zsh, dash, ksh and fish behind a path or an `env`; `*sh -*c *` a flag cluster
250
254
  // (bash -xc), `*sh -* -c*` a flag before `-c`; the same for the other interpreters. `ssh -c <cipher>` is
251
255
  // refused too, a side effect of matching any word ending with `sh`. `python3.*` names a versioned python
@@ -261,7 +265,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
261
265
  },
262
266
  "read-noise": {
263
267
  id: "read-noise",
264
- title: "reads under build outputs, version-control internals and installed packages",
268
+ title: READ_NOISE_TITLE,
265
269
  // Each folder twice: inside a path, and as the start of a path relative to the project.
266
270
  rules: denyEach(PATH_READ_TOOLS, "path", [
267
271
  "*/bin/*", "bin/*", "*/obj/*", "obj/*", "*/.git/*", ".git/*", "*/node_modules/*", "node_modules/*",
@@ -269,7 +273,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
269
273
  },
270
274
  secrets: {
271
275
  id: "secrets",
272
- title: "a private key block or a token with a known prefix in written content",
276
+ title: SECRETS_TITLE,
273
277
  // The prefixes of SECRET_PATTERNS (secret-patterns.ts) a whole-content pattern can hold without refusing
274
278
  // ordinary text; the others need a check of the content itself. edit_batch's texts sit in its
275
279
  // operations, which the crews' callback reads as node_replace, node_insert or node_ensure texts.
@@ -284,7 +288,7 @@ export const RULE_SETS: Readonly<Record<RuleSetId, RuleSet>> = {
284
288
  },
285
289
  "state-files": {
286
290
  id: "state-files",
287
- title: "files only Orkeon Code's own code writes",
291
+ title: STATE_FILES_TITLE,
288
292
  // Batch logs, batch states, verdicts and audit captures; the state folder's entries; the harness's deployed files.
289
293
  rules: [
290
294
  ...denyEach(PATH_WRITE_TOOLS, "path", [
@@ -320,10 +324,10 @@ function normaliseRoot(raw: string): string {
320
324
  }
321
325
 
322
326
  function rootProblem(raw: string, root: string): string | undefined {
323
- if (root === "") return `root '${raw}' names the whole project: no rule`;
324
- if (root.startsWith("/")) return `root '${raw}' is outside ${WORKSPACE}: no rule`;
325
- if (root.split("/").includes("..")) return `root '${raw}' climbs out with '..': no rule`;
326
- if (root.includes("*")) return `root '${raw}' holds '*': a rule on it would cover more than the folder`;
327
+ if (root === "") return rootWholeProject(raw);
328
+ if (root.startsWith("/")) return rootOutside(raw, WORKSPACE);
329
+ if (root.split("/").includes("..")) return rootClimbsOut(raw);
330
+ if (root.includes("*")) return rootHoldsStar(raw);
327
331
  return undefined;
328
332
  }
329
333
 
@@ -381,9 +385,9 @@ export function patternWriteRules(patterns: readonly string[]): PathRules {
381
385
  const seen = new Set<string>();
382
386
  for (const raw of patterns) {
383
387
  const pattern = normaliseRoot(raw);
384
- if (pattern === "" || pattern === "*") { problems.push(`pattern '${raw}' covers the whole project: no rule`); continue; }
385
- if (pattern.startsWith("/")) { problems.push(`pattern '${raw}' is outside ${WORKSPACE}: no rule`); continue; }
386
- if (pattern.split("/").includes("..")) { problems.push(`pattern '${raw}' climbs out with '..': no rule`); continue; }
388
+ if (pattern === "" || pattern === "*") { problems.push(patternWholeProject(raw)); continue; }
389
+ if (pattern.startsWith("/")) { problems.push(patternOutside(raw, WORKSPACE)); continue; }
390
+ if (pattern.split("/").includes("..")) { problems.push(patternClimbsOut(raw)); continue; }
387
391
  if (seen.has(pattern)) continue;
388
392
  seen.add(pattern);
389
393
  rules.push(...denyEach(PATH_WRITE_TOOLS, "path", [`${WORKSPACE}/${pattern}`, pattern]));
@@ -3,7 +3,9 @@
3
3
  // reads for `list_issues`, `get_pr`, `search_repos` and `get_repo`, executes for `create_issue`, `create_pr` and an
4
4
  // unknown or missing action; `http_api` reads for `GET`, `HEAD`, `OPTIONS` and a missing method, executes for any
5
5
  // other method and for a read method that carries a body or a method-override header; `web_search` reads whatever
6
- // the call. The arguments are read as Orkeon reads them: a key matched case aside (`Method`, `BODY`), the action
6
+ // the call; `firefox` reads for the actions that only look (FIREFOX_READ_ACTIONS), executes for any other and for a
7
+ // missing one, its `screenshot` included: Orkeon declares that one an edit, which this table has no word for, and
8
+ // execute is the answer that lets no more through. The arguments are read as Orkeon reads them: a key matched case aside (`Method`, `BODY`), the action
7
9
  // trimmed and compared case aside, the method compared case aside (an empty one is no read method), a body present
8
10
  // whatever its content, an empty string included, and the headers' names taken from an object or from a JSON string
9
11
  // holding one. `rag_eval` declares an edit whatever the call (it ingests its corpus and writes its reports), the
@@ -18,6 +20,11 @@ export type ToolAccess = "read" | "execute";
18
20
  /** The `github` actions Orkeon reads for. */
19
21
  export const GITHUB_READ_ACTIONS: readonly string[] = ["list_issues", "get_pr", "search_repos", "get_repo"];
20
22
 
23
+ /** The `firefox` actions Orkeon reads for. */
24
+ export const FIREFOX_READ_ACTIONS: readonly string[] = [
25
+ "navigate", "back", "snapshot", "read", "find", "search", "tabs", "new_tab", "switch_tab",
26
+ ];
27
+
21
28
  /** The `http_api` methods Orkeon reads for; a missing method is a GET. */
22
29
  export const HTTP_READ_METHODS: readonly string[] = ["GET", "HEAD", "OPTIONS"];
23
30
 
@@ -59,12 +66,19 @@ const carriesMethodOverride = (headers: unknown): boolean => {
59
66
  return headerNames(headers).some((name) => overrides.includes(name.toLowerCase()));
60
67
  };
61
68
 
69
+ /** The tools whose access follows their `action`, with the actions that read. */
70
+ const READ_ACTIONS_OF: Readonly<Record<string, readonly string[]>> = {
71
+ github: GITHUB_READ_ACTIONS,
72
+ firefox: FIREFOX_READ_ACTIONS,
73
+ };
74
+
62
75
  /** The access Orkeon declares for this call; null when the tool declares one access whatever the call, as its class says. */
63
76
  export function declaredAccess(tool: string, input: unknown): ToolAccess | null {
64
77
  if (READ_WHATEVER_THE_CALL.includes(tool)) return "read";
65
- if (tool === "github") {
78
+ const readActions = READ_ACTIONS_OF[tool];
79
+ if (readActions) {
66
80
  const action = field(input, "action");
67
- return typeof action === "string" && GITHUB_READ_ACTIONS.includes(action.trim().toLowerCase()) ? "read" : "execute";
81
+ return typeof action === "string" && readActions.includes(action.trim().toLowerCase()) ? "read" : "execute";
68
82
  }
69
83
  if (tool === "http_api") {
70
84
  const method = field(input, "method");
@@ -10,6 +10,7 @@
10
10
  // directory by the host, so listing them from a stored copy would go stale the
11
11
  // moment a crew is added or renamed — the command merges the two at read time and
12
12
  // labels which is which.
13
+ import { agentNeedsGoal, agentNeedsRole, DISCOVERED_IN_CREWS, invalidAgentName, shadowedByCrew } from "./messages.ts";
13
14
 
14
15
  /** A saved agent definition. Deliberately small: the fields an agent needs to run. */
15
16
  export interface SavedAgent {
@@ -42,13 +43,13 @@ export function validateSavedAgent(raw: {
42
43
  if (!NAME_RE.test(name)) {
43
44
  return {
44
45
  ok: false,
45
- reason: `'${String(raw?.name ?? "")}' is not a valid agent name (lowercase letters, digits and '-', starting with a letter)`,
46
+ reason: invalidAgentName(String(raw?.name ?? "")),
46
47
  };
47
48
  }
48
49
  const role = String(raw?.role ?? "").trim();
49
50
  const goal = String(raw?.goal ?? "").trim();
50
- if (role.length === 0) return { ok: false, reason: `agent '${name}' needs a role` };
51
- if (goal.length === 0) return { ok: false, reason: `agent '${name}' needs a goal` };
51
+ if (role.length === 0) return { ok: false, reason: agentNeedsRole(name) };
52
+ if (goal.length === 0) return { ok: false, reason: agentNeedsGoal(name) };
52
53
 
53
54
  const tools = Array.isArray(raw?.tools)
54
55
  ? [...new Set(raw.tools.map((t: unknown) => String(t ?? "").trim()).filter((t: string) => t.length > 0))]
@@ -127,14 +128,14 @@ export function describeAgentRows(
127
128
  const rows = [...crews].sort().map((c) => ({
128
129
  name: c,
129
130
  kind: "crew (built-in)",
130
- detail: "discovered in crews/ — read-only here",
131
+ detail: DISCOVERED_IN_CREWS,
131
132
  }));
132
133
  for (const a of agents) {
133
134
  rows.push({
134
135
  name: a.name,
135
136
  kind: "saved agent",
136
137
  detail: crewNames.has(a.name.toLowerCase())
137
- ? `⚠ shadowed by the crew of the same name — never dispatched. ${a.role}`
138
+ ? shadowedByCrew(a.role)
138
139
  : `${a.role} — ${a.goal}${a.tools.length > 0 ? ` [tools: ${a.tools.join(", ")}]` : ""}`,
139
140
  });
140
141
  }
@@ -6,6 +6,7 @@
6
6
  // unexplained throw: the limit the host is configured with, never a default copied here. A driver that
7
7
  // relaunches its own work passes `{ chain: "continue" }` to the launch (CrewLaunchOptions) and never meets
8
8
  // the refusal. Pure.
9
+ import { chainLimitReached } from "./messages.ts";
9
10
 
10
11
  const REFUSAL = /chain depth (\d+) reached \(MaxChainDepth (\d+)(?:, \/([^\s)]+))?\)/i;
11
12
 
@@ -25,6 +26,5 @@ export function chainDepthRefusal(error: unknown): ChainDepthRefusal | null {
25
26
  /** The line a command shows for a refused hop. */
26
27
  export function chainDepthLine(crew: string, refusal: ChainDepthRefusal): string {
27
28
  const of = refusal.command === undefined ? "" : ` of /${refusal.command}`;
28
- return `${crew} not launched: the chain of crews${of} reached its limit (depth ${refusal.depth}, limit ${refusal.limit}, ` +
29
- "Orkeon:Cli:ScriptCommands:MaxChainDepth); type the next step yourself.";
29
+ return chainLimitReached(crew, of, refusal.depth, refusal.limit);
30
30
  }
@@ -6,6 +6,9 @@
6
6
  import type { PermissionMode } from "../permission-modes.ts";
7
7
  import { catalogueFor } from "../agent-policy/permission.ts";
8
8
  import { policyFor } from "../agent-policy/mode-policy.ts";
9
+ import {
10
+ charterIterations, charterModeCanWrite, charterNameNotKebab, charterNoToolLeft, charterToolNotOffered,
11
+ } from "./messages.ts";
9
12
 
10
13
  /** A check's outcome: the value, or what is wrong with it. */
11
14
  export type Checked<T> = { ok: true; value: T } | { ok: false; problems: string[] };
@@ -43,19 +46,19 @@ export function charterCatalogue(charter: Charter): string[] {
43
46
  export function charterProblems(charter: Charter): string[] {
44
47
  const { name, mode, maxIterations } = charter;
45
48
  const problems: string[] = [];
46
- if (!CHARTER_NAME.test(name)) problems.push(`charter name '${name}' is not a kebab-case name of 2 to 40 characters`);
49
+ if (!CHARTER_NAME.test(name)) problems.push(charterNameNotKebab(name));
47
50
  if (!policyFor(mode).readOnly) {
48
- problems.push(`charter ${name}: mode ${mode} can write; a sub-agent runs read-only (plan or dontAsk) for now`);
51
+ problems.push(charterModeCanWrite(name, mode));
49
52
  }
50
53
  const offered = new Set(offeredIn(mode));
51
54
  for (const tool of charter.tools) {
52
- if (!offered.has(tool)) problems.push(`charter ${name}: ${tool} is not offered in mode ${mode}`);
55
+ if (!offered.has(tool)) problems.push(charterToolNotOffered(name, tool, mode));
53
56
  }
54
57
  if (charterCatalogue(charter).length === 0) {
55
- problems.push(`charter ${name}: no tool left once the mode and the disallowed list apply`);
58
+ problems.push(charterNoToolLeft(name));
56
59
  }
57
60
  if (!(Number.isInteger(maxIterations) && maxIterations >= 1 && maxIterations <= MAX_CHARTER_ITERATIONS)) {
58
- problems.push(`charter ${name}: maxIterations ${maxIterations} is not between 1 and 80`);
61
+ problems.push(charterIterations(name, maxIterations));
59
62
  }
60
63
  return problems;
61
64
  }
@@ -5,6 +5,7 @@
5
5
  // ended: completed, failed, or stopped at its next cooperative checkpoint after a cancel (Orkeon #266), so a relaunch
6
6
  // right after a cancel may still be refused. A command reads the crew and the ticket off the refusal through
7
7
  // exclusiveRefusal and shows exclusiveLine, rather than failing on an unexplained throw. Pure.
8
+ import { alreadyRunning } from "./messages.ts";
8
9
 
9
10
  const REFUSAL = /crew '([^']+)' already running \(ticket ([^\s)]+)\)/i;
10
11
 
@@ -20,5 +21,5 @@ export function exclusiveRefusal(error: unknown): ExclusiveRefusal | null {
20
21
 
21
22
  /** The line a command shows for a crew refused because it already runs. */
22
23
  export function exclusiveLine(refusal: ExclusiveRefusal): string {
23
- return `${refusal.crew} not launched: it is already running (ticket ${refusal.ticket}); wait for its result, then type the line again.`;
24
+ return alreadyRunning(refusal.crew, refusal.ticket);
24
25
  }
@@ -6,6 +6,11 @@
6
6
 
7
7
  import { AGENT_INSTANCES_STATE_PREFIX, AGENT_REQUEST_STATE_PREFIX } from "../session-keys.ts";
8
8
  import { MAX_BRIEF_CHARS } from "./charter.ts";
9
+ import {
10
+ namesAnInstanceOf, noAgentInstance, nothingToStop, RUN_STOPPED_ANSWERING, RUNNING_NO_LONGER_ANSWERING,
11
+ RUNNING_NOT_ANSWERING, RUNNING_STOP_ASKED, runNoLongerAnswers, runOfStarted, sendRefusedWhileRunning,
12
+ } from "./messages.ts";
13
+ import { CUT_MARK, noReport, REPAIR_INSTRUCTION, repairOpening } from "./prompts.ts";
9
14
 
10
15
  export const INSTANCE_STATES = ["running", "completed", "failed", "stopped"] as const;
11
16
  export type InstanceState = (typeof INSTANCE_STATES)[number];
@@ -124,7 +129,7 @@ export function settleSnapshot(s: RunSnapshot, now: Date): RunSnapshot {
124
129
  if (!s.open || (Number.isFinite(age) && age <= SNAPSHOT_STALE_MS)) return s;
125
130
  return {
126
131
  ...s, serving: false, open: false,
127
- instances: s.instances.map((r) => r.state !== "running" ? r : { ...r, state: "failed", error: "its run stopped answering" }),
132
+ instances: s.instances.map((r) => r.state !== "running" ? r : { ...r, state: "failed", error: RUN_STOPPED_ANSWERING }),
128
133
  };
129
134
  }
130
135
 
@@ -159,11 +164,11 @@ export function locateInstance(snapshots: readonly RunSnapshot[], ref: string):
159
164
  ? []
160
165
  : snapshot.instances.filter((r) => r.id === id && id !== "").map((record) => ({ snapshot, record })));
161
166
  if (found.length === 1) return { ok: true, found: found[0] };
162
- if (found.length === 0) return { ok: false, text: `no agent instance '${ref}': /tasks lists them` };
167
+ if (found.length === 0) return { ok: false, text: noAgentInstance(ref) };
163
168
  return {
164
169
  ok: false,
165
- text: `'${ref}' names an instance of ${found.map((f) => f.snapshot.crew).join(" and ")}: write ${found
166
- .map((f) => `${f.snapshot.crew}:${id}`).join(" or ")}`,
170
+ text: namesAnInstanceOf(ref, found.map((f) => f.snapshot.crew).join(" and "),
171
+ found.map((f) => `${f.snapshot.crew}:${id}`).join(" or ")),
167
172
  };
168
173
  }
169
174
 
@@ -171,8 +176,8 @@ const label = (l: Located): string => `${l.snapshot.crew}:${l.record.id}`;
171
176
 
172
177
  /** Whether /tasks may ask the crew to stop the instance: only a running one, of a run still answering. */
173
178
  export function stopVerdict(l: Located): { ok: true } | { ok: false; text: string } {
174
- if (l.record.state !== "running") return { ok: false, text: `${label(l)} is ${l.record.state}: there is nothing to stop` };
175
- if (!l.snapshot.serving) return { ok: false, text: `${label(l)}: its run no longer answers; it ends with the run` };
179
+ if (l.record.state !== "running") return { ok: false, text: nothingToStop(label(l), l.record.state) };
180
+ if (!l.snapshot.serving) return { ok: false, text: runNoLongerAnswers(label(l)) };
176
181
  return { ok: true };
177
182
  }
178
183
 
@@ -183,13 +188,11 @@ export function stopVerdict(l: Located): { ok: true } | { ok: false; text: strin
183
188
  */
184
189
  export function sendVerdict(l: Located): { kind: "refused"; text: string } | { kind: "repair" } {
185
190
  if (l.record.state === "running") {
186
- return { kind: "refused", text: `${label(l)} is running: a send is refused until it ends (/tasks stop ${l.record.id} ends it)` };
191
+ return { kind: "refused", text: sendRefusedWhileRunning(label(l), l.record.id) };
187
192
  }
188
193
  return { kind: "repair" };
189
194
  }
190
195
 
191
- const CUT_MARK = "[… the start is left out]\n";
192
-
193
196
  /** The tail of `s` within `max` characters, the cut said in front. */
194
197
  function tail(s: string, max: number): string {
195
198
  if (s.length <= max) return s;
@@ -203,8 +206,8 @@ function tail(s: string, max: number): string {
203
206
  */
204
207
  export function buildRepairBrief(record: InstanceRecord, message: string): string {
205
208
  const head = [
206
- `This is a new run of ${record.charter}, repairing instance ${record.id || "?"} of an ended run: you do not have its context,`,
207
- "only what follows. Answer the operator's message below, then give the whole report again in the shape the previous brief asked for.",
209
+ repairOpening(record.charter, record.id || "?"),
210
+ REPAIR_INSTRUCTION,
208
211
  "",
209
212
  "## Operator's message",
210
213
  message.trim(),
@@ -212,7 +215,7 @@ export function buildRepairBrief(record: InstanceRecord, message: string): strin
212
215
  "## Previous report",
213
216
  "",
214
217
  ].join("\n");
215
- const report = record.reply ?? `(none: the instance ${record.state}${record.error ? `: ${record.error}` : ""})`;
218
+ const report = record.reply ?? noReport(record.state, record.error ? `: ${record.error}` : "");
216
219
  const briefHeading = "\n\n## Previous brief\n";
217
220
  const forReport = MAX_BRIEF_CHARS - head.length - briefHeading.length;
218
221
  const keptReport = tail(report, Math.max(0, forReport));
@@ -228,9 +231,9 @@ export function instanceRows(snapshots: readonly RunSnapshot[]): Array<Record<st
228
231
  id: r.id || "?",
229
232
  crew: s.crew,
230
233
  agent: r.agent,
231
- state: r.stopRequested && r.state === "running" ? "running (stop asked)" : r.state,
234
+ state: r.stopRequested && r.state === "running" ? RUNNING_STOP_ASKED : r.state,
232
235
  task: r.task,
233
- run: s.serving ? "answering" : s.open ? "running, not answering" : "ended",
236
+ run: s.serving ? "answering" : s.open ? RUNNING_NOT_ANSWERING : "ended",
234
237
  })));
235
238
  }
236
239
 
@@ -241,7 +244,7 @@ export function describeInstance(l: Located): string[] {
241
244
  `${label(l)} — ${r.agent} (${r.charter}), ${r.state}${r.stopRequested && r.state === "running" ? ", stop asked" : ""}`,
242
245
  `task: ${r.task}`,
243
246
  `started ${r.startedAt}${r.endedAt ? `, ended ${r.endedAt}` : ""}${r.effort ? `, effort ${r.effort}` : ""}`,
244
- `run of ${s.crew} started ${s.startedAt}: ${s.serving ? "answering /tasks" : s.open ? "running, no longer answering" : "ended"}`,
247
+ runOfStarted(s.crew, s.startedAt, s.serving ? "answering /tasks" : s.open ? RUNNING_NO_LONGER_ANSWERING : "ended"),
245
248
  ];
246
249
  if (r.error) lines.push(`error: ${r.error}`);
247
250
  if (r.reply) lines.push("report:", r.reply);
@@ -0,0 +1,39 @@
1
+ // The text the agents and crews show the user: a refused launch, the problems of a charter, the answers of
2
+ // /tasks about an instance.
3
+
4
+ // ── Refused launches ────────────────────────────────────────────────────
5
+
6
+ export const chainLimitReached = (crew: string, of: string, depth: number, limit: number): string =>
7
+ `${crew} not launched: the chain of crews${of} reached its limit (depth ${depth}, limit ${limit}, ` +
8
+ "Orkeon:Cli:ScriptCommands:MaxChainDepth); type the next step yourself.";
9
+ export const alreadyRunning = (crew: string, ticket: string | number): string =>
10
+ `${crew} not launched: it is already running (ticket ${ticket}); wait for its result, then type the line again.`;
11
+
12
+ // ── The problems of a charter ───────────────────────────────────────────
13
+
14
+ export const charterNameNotKebab = (name: string): string => `charter name '${name}' is not a kebab-case name of 2 to 40 characters`;
15
+ export const charterModeCanWrite = (name: string, mode: string): string =>
16
+ `charter ${name}: mode ${mode} can write; a sub-agent runs read-only (plan or dontAsk) for now`;
17
+ export const charterToolNotOffered = (name: string, tool: string, mode: string): string =>
18
+ `charter ${name}: ${tool} is not offered in mode ${mode}`;
19
+ export const charterNoToolLeft = (name: string): string => `charter ${name}: no tool left once the mode and the disallowed list apply`;
20
+ export const charterIterations = (name: string, maxIterations: number): string =>
21
+ `charter ${name}: maxIterations ${maxIterations} is not between 1 and 80`;
22
+
23
+ // ── /tasks and the agent instances ──────────────────────────────────────
24
+
25
+ export const RUN_STOPPED_ANSWERING = "its run stopped answering";
26
+ export const noAgentInstance = (ref: string): string => `no agent instance '${ref}': /tasks lists them`;
27
+ export const namesAnInstanceOf = (ref: string, crews: string, choices: string): string =>
28
+ `'${ref}' names an instance of ${crews}: write ${choices}`;
29
+ export const nothingToStop = (label: string, state: string): string => `${label} is ${state}: there is nothing to stop`;
30
+ export const runNoLongerAnswers = (label: string): string => `${label}: its run no longer answers; it ends with the run`;
31
+ export const sendRefusedWhileRunning = (label: string, id: string): string =>
32
+ `${label} is running: a send is refused until it ends (/tasks stop ${id} ends it)`;
33
+ export const RUNNING_STOP_ASKED = "running (stop asked)";
34
+ export const RUNNING_NOT_ANSWERING = "running, not answering";
35
+ export const RUNNING_NO_LONGER_ANSWERING = "running, no longer answering";
36
+ export const runOfStarted = (crew: string, startedAt: string, state: string): string => `run of ${crew} started ${startedAt}: ${state}`;
37
+ export const ladderNeedsTwo = (value: string): string =>
38
+ `'${value}' is no ladder: name at least two profiles of the host, cheapest first, separated by commas (small,large)`;
39
+ export const ladderRepeats = (value: string): string => `'${value}' names a profile twice`;