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,143 @@
1
+ // B-12 — the saved-agent registry: schema and CRUD decisions. Pure, no IO.
2
+ //
3
+ // Baseline 04 §/agents: "List, create, delete, and edit saved agent configurations
4
+ // stored in `.orkeon/agents.json`". So the registry is a FILE, not session state —
5
+ // a saved agent is meant to outlive the session, and `/clear` must not take
6
+ // someone's agent definitions with it. It lives beside `config.json` (B-6), under
7
+ // the same `/workspace/.orkeon/` directory the operator can read and edit by hand.
8
+ //
9
+ // The built-in crews are NOT in this file. They are discovered from the crews
10
+ // directory by the host, so listing them from a stored copy would go stale the
11
+ // moment a crew is added or renamed — the command merges the two at read time and
12
+ // labels which is which.
13
+ import { agentNeedsGoal, agentNeedsRole, DISCOVERED_IN_CREWS, invalidAgentName, shadowedByCrew } from "./messages.ts";
14
+
15
+ /** A saved agent definition. Deliberately small: the fields an agent needs to run. */
16
+ export interface SavedAgent {
17
+ name: string;
18
+ role: string;
19
+ goal: string;
20
+ /** Tool names; empty means "whatever the crew grants". */
21
+ tools: string[];
22
+ }
23
+
24
+ /** Names are the file's keys, so they must be a stable, typo-visible slug. */
25
+ const NAME_RE = /^[a-z][a-z0-9-]*$/;
26
+
27
+ export type AgentVerdict =
28
+ | { ok: true; agent: SavedAgent }
29
+ | { ok: false; reason: string };
30
+
31
+ /**
32
+ * Validates a definition on the way in.
33
+ *
34
+ * `role` and `goal` are required because an agent without them is not a definition
35
+ * an operator could later understand, and this file is meant to be re-read by a
36
+ * human. Refusing here is right — unlike a model name or a lens, a saved agent has
37
+ * no useful "fall back to the default" reading.
38
+ */
39
+ export function validateSavedAgent(raw: {
40
+ name?: unknown; role?: unknown; goal?: unknown; tools?: unknown;
41
+ }): AgentVerdict {
42
+ const name = String(raw?.name ?? "").trim().toLowerCase();
43
+ if (!NAME_RE.test(name)) {
44
+ return {
45
+ ok: false,
46
+ reason: invalidAgentName(String(raw?.name ?? "")),
47
+ };
48
+ }
49
+ const role = String(raw?.role ?? "").trim();
50
+ const goal = String(raw?.goal ?? "").trim();
51
+ if (role.length === 0) return { ok: false, reason: agentNeedsRole(name) };
52
+ if (goal.length === 0) return { ok: false, reason: agentNeedsGoal(name) };
53
+
54
+ const tools = Array.isArray(raw?.tools)
55
+ ? [...new Set(raw.tools.map((t: unknown) => String(t ?? "").trim()).filter((t: string) => t.length > 0))]
56
+ : [];
57
+
58
+ return { ok: true, agent: { name, role, goal, tools } };
59
+ }
60
+
61
+ /**
62
+ * Reads the stored map into a list, dropping entries that no longer validate.
63
+ *
64
+ * Dropped rather than fatal, and the count is returned: the file is hand-editable,
65
+ * and refusing to list ten good agents because an eleventh lost its `goal` would
66
+ * make a typo cost the whole registry. Silence is the part that is not acceptable.
67
+ */
68
+ export function parseAgentRegistry(raw: unknown): { agents: SavedAgent[]; dropped: string[] } {
69
+ const agents: SavedAgent[] = [];
70
+ const dropped: string[] = [];
71
+ const entries = raw && typeof raw === "object" && !Array.isArray(raw)
72
+ ? Object.entries(raw as Record<string, unknown>)
73
+ : [];
74
+
75
+ for (const [key, value] of entries) {
76
+ const candidate = value && typeof value === "object" && !Array.isArray(value)
77
+ ? { name: key, ...(value as Record<string, unknown>) }
78
+ : { name: key };
79
+ const verdict = validateSavedAgent(candidate);
80
+ if (verdict.ok) agents.push(verdict.agent);
81
+ else dropped.push(key);
82
+ }
83
+ agents.sort((a, b) => a.name.localeCompare(b.name));
84
+ return { agents, dropped };
85
+ }
86
+
87
+ /** The list back to its stored form (name as key — the file is browsed by name). */
88
+ export function serializeAgentRegistry(agents: readonly SavedAgent[]): Record<string, unknown> {
89
+ const out: Record<string, unknown> = {};
90
+ for (const a of [...agents].sort((x, y) => x.name.localeCompare(y.name))) {
91
+ out[a.name] = { role: a.role, goal: a.goal, tools: a.tools };
92
+ }
93
+ return out;
94
+ }
95
+
96
+ /** Upsert. Returns the new list plus whether an existing definition was replaced. */
97
+ export function upsertAgent(
98
+ agents: readonly SavedAgent[],
99
+ agent: SavedAgent,
100
+ ): { agents: SavedAgent[]; replaced: boolean } {
101
+ const rest = agents.filter((a) => a.name !== agent.name);
102
+ return { agents: [...rest, agent], replaced: rest.length !== agents.length };
103
+ }
104
+
105
+ /** Remove by name. `removed` false when there was nothing to remove. */
106
+ export function removeAgent(
107
+ agents: readonly SavedAgent[],
108
+ name: string,
109
+ ): { agents: SavedAgent[]; removed: boolean } {
110
+ const key = String(name ?? "").trim().toLowerCase();
111
+ const rest = agents.filter((a) => a.name !== key);
112
+ return { agents: rest, removed: rest.length !== agents.length };
113
+ }
114
+
115
+ /**
116
+ * The rows `/agents` prints: the built-in crews first, then the saved agents.
117
+ *
118
+ * Crews come first because they are what actually runs today, and they are marked
119
+ * read-only so nobody tries `/agents remove code-review` and wonders why the crew
120
+ * is still there. A saved agent whose name shadows a crew is flagged: the crew wins
121
+ * at dispatch, so the definition would sit there doing nothing.
122
+ */
123
+ export function describeAgentRows(
124
+ crews: readonly string[],
125
+ agents: readonly SavedAgent[],
126
+ ): Array<{ name: string; kind: string; detail: string }> {
127
+ const crewNames = new Set(crews.map((c) => c.toLowerCase()));
128
+ const rows = [...crews].sort().map((c) => ({
129
+ name: c,
130
+ kind: "crew (built-in)",
131
+ detail: DISCOVERED_IN_CREWS,
132
+ }));
133
+ for (const a of agents) {
134
+ rows.push({
135
+ name: a.name,
136
+ kind: "saved agent",
137
+ detail: crewNames.has(a.name.toLowerCase())
138
+ ? shadowedByCrew(a.role)
139
+ : `${a.role} — ${a.goal}${a.tools.length > 0 ? ` [tools: ${a.tools.join(", ")}]` : ""}`,
140
+ });
141
+ }
142
+ return rows;
143
+ }
@@ -0,0 +1,43 @@
1
+ // The charters Orkeon Code runs as children of its dev steps (A-3), by name: which step runs each one
2
+ // and whose rule sets apply to it. The charters themselves live beside their step (the reviewer in
3
+ // shared/domain/dev/, the auditor in crews/dev-verify/domain/); /agents lists these rows and the
4
+ // agent-run crew repairs an instance of one by a new run. Pure.
5
+ import { stepCommand } from "../dev/step-rules.ts";
6
+
7
+ export interface BuiltInCharter {
8
+ name: string;
9
+ /** The dev step that runs it as a child, and whose rule sets apply to a repair its run does not name. */
10
+ step: "dev-plan" | "dev-verify";
11
+ /** Every step that runs it as a child. */
12
+ steps: readonly string[];
13
+ role: string;
14
+ }
15
+
16
+ export const BUILT_IN_CHARTERS: readonly BuiltInCharter[] = [
17
+ { name: "dev-reviewer", step: "dev-plan", steps: ["dev-spec", "dev-change", "dev-plan"], role: "Adversarial reviewer" },
18
+ { name: "dev-auditor", step: "dev-verify", steps: ["dev-verify"], role: "Batch auditor" },
19
+ ];
20
+
21
+ export function builtInCharter(name: string): BuiltInCharter | undefined {
22
+ return BUILT_IN_CHARTERS.find((c) => c.name === name);
23
+ }
24
+
25
+ /** The steps a repair can run under: those that run a charter as a child. */
26
+ export type RepairStep = "dev-plan" | "dev-verify" | "dev-spec" | "dev-change";
27
+ const REPAIR_STEPS: readonly string[] = ["dev-plan", "dev-verify", "dev-spec", "dev-change"];
28
+
29
+ /** The step a repair of `charter` runs under: the one the instance's run named (a reviewer of /dev-spec repairs under
30
+ * dev-spec's rule sets and budget), else the charter's own, else dev-plan's. */
31
+ export function repairStep(charter: string, runStep: unknown): RepairStep {
32
+ if (typeof runStep === "string" && REPAIR_STEPS.includes(runStep)) return runStep as RepairStep;
33
+ return builtInCharter(charter)?.step ?? "dev-plan";
34
+ }
35
+
36
+ /** The rows /agents lists for the built-in charters, after the crews. */
37
+ export function builtInCharterRows(): Array<{ name: string; kind: string; detail: string }> {
38
+ return BUILT_IN_CHARTERS.map((c) => ({
39
+ name: c.name,
40
+ kind: "charter (built-in)",
41
+ detail: `${c.role} — runs as a background child of ${[...new Set(c.steps.map((s) => `/${stepCommand(s)}`))].join(", ")}; /tasks lists, stops and repairs it`,
42
+ }));
43
+ }
@@ -0,0 +1,30 @@
1
+ // A chain of crews launched from `completed` handlers (`runCrewAsync` from a `completed`): the runtime
2
+ // counts each hop and refuses the one past `Orkeon:Cli:ScriptCommands:MaxChainDepth` (default 8, the
3
+ // first crew counted, V-A5) with a plain JS error, `chain depth <d> reached (MaxChainDepth <l>, /<command>)`,
4
+ // the command whose launch was refused last (`ChainDepthExceededException`, Orkeon #221). A driver reads the
5
+ // depth, the limit and the command off the refusal through chainDepthRefusal, rather than failing on an
6
+ // unexplained throw: the limit the host is configured with, never a default copied here. A driver that
7
+ // relaunches its own work passes `{ chain: "continue" }` to the launch (CrewLaunchOptions) and never meets
8
+ // the refusal. Pure.
9
+ import { chainLimitReached } from "./messages.ts";
10
+
11
+ const REFUSAL = /chain depth (\d+) reached \(MaxChainDepth (\d+)(?:, \/([^\s)]+))?\)/i;
12
+
13
+ /** What a chain refusal says: the depth reached, the limit, and the command refused when the message names it. */
14
+ export interface ChainDepthRefusal { depth: number; limit: number; command?: string }
15
+
16
+ /** The depth and limit of a chain refusal; null for any other failure. */
17
+ export function chainDepthRefusal(error: unknown): ChainDepthRefusal | null {
18
+ const message = error instanceof Error ? error.message : typeof error === "string" ? error : String(error ?? "");
19
+ const m = REFUSAL.exec(message);
20
+ if (m === null) return null;
21
+ return m[3] === undefined
22
+ ? { depth: Number(m[1]), limit: Number(m[2]) }
23
+ : { depth: Number(m[1]), limit: Number(m[2]), command: m[3] };
24
+ }
25
+
26
+ /** The line a command shows for a refused hop. */
27
+ export function chainDepthLine(crew: string, refusal: ChainDepthRefusal): string {
28
+ const of = refusal.command === undefined ? "" : ` of /${refusal.command}`;
29
+ return chainLimitReached(crew, of, refusal.depth, refusal.limit);
30
+ }
@@ -0,0 +1,64 @@
1
+ // A sub-agent's charter: who it is, the mode it acts in, the tools it may be
2
+ // offered and how many tool-call iterations it gets. Pure, no IO. For now a
3
+ // sub-agent acts read-only: its catalogue is the mode's own (no session rule
4
+ // applies yet), narrowed to the charter's list.
5
+
6
+ import type { PermissionMode } from "../permission-modes.ts";
7
+ import { catalogueFor } from "../agent-policy/permission.ts";
8
+ import { policyFor } from "../agent-policy/mode-policy.ts";
9
+ import {
10
+ charterIterations, charterModeCanWrite, charterNameNotKebab, charterNoToolLeft, charterToolNotOffered,
11
+ } from "./messages.ts";
12
+
13
+ /** A check's outcome: the value, or what is wrong with it. */
14
+ export type Checked<T> = { ok: true; value: T } | { ok: false; problems: string[] };
15
+
16
+ /** What a sub-agent is: its identity, its mode, the tools it may be offered, its iteration cap. */
17
+ export interface Charter {
18
+ name: string;
19
+ role: string;
20
+ goal: string;
21
+ mode: PermissionMode;
22
+ tools: readonly string[];
23
+ disallowed: readonly string[];
24
+ maxIterations: number;
25
+ /** The model to answer with; the host's when absent. */
26
+ model?: string;
27
+ }
28
+
29
+ export const CHARTER_NAME: RegExp = /^[a-z][a-z0-9-]{1,39}$/;
30
+ export const MAX_CHARTER_ITERATIONS = 80;
31
+ /** The longest brief a sub-agent is handed, in characters (temp/03 § A "MAX_BRIEF_CHARS"). */
32
+ export const MAX_BRIEF_CHARS = 24_000;
33
+
34
+ function offeredIn(mode: string): string[] {
35
+ return catalogueFor(mode, []).tools;
36
+ }
37
+
38
+ /** catalogueFor(mode, []).tools ∩ charter.tools − charter.disallowed, in the order of charter.tools. */
39
+ export function charterCatalogue(charter: Charter): string[] {
40
+ const offered = new Set(offeredIn(charter.mode));
41
+ const disallowed = new Set(charter.disallowed);
42
+ return charter.tools.filter((t) => offered.has(t) && !disallowed.has(t));
43
+ }
44
+
45
+ /** Empty when the charter can run. */
46
+ export function charterProblems(charter: Charter): string[] {
47
+ const { name, mode, maxIterations } = charter;
48
+ const problems: string[] = [];
49
+ if (!CHARTER_NAME.test(name)) problems.push(charterNameNotKebab(name));
50
+ if (!policyFor(mode).readOnly) {
51
+ problems.push(charterModeCanWrite(name, mode));
52
+ }
53
+ const offered = new Set(offeredIn(mode));
54
+ for (const tool of charter.tools) {
55
+ if (!offered.has(tool)) problems.push(charterToolNotOffered(name, tool, mode));
56
+ }
57
+ if (charterCatalogue(charter).length === 0) {
58
+ problems.push(charterNoToolLeft(name));
59
+ }
60
+ if (!(Number.isInteger(maxIterations) && maxIterations >= 1 && maxIterations <= MAX_CHARTER_ITERATIONS)) {
61
+ problems.push(charterIterations(name, maxIterations));
62
+ }
63
+ return problems;
64
+ }
@@ -0,0 +1,25 @@
1
+ // An exclusive crew launch (`runCrewAsync(name, input, { exclusive: true })`, Orkeon #239): the runtime refuses
2
+ // a crew whose previous exclusive launch is not terminal, before any LLM call, with a plain JS error naming the
3
+ // running instance, `crew '<name>' already running (ticket <t>)`. The check and the registration are one step on
4
+ // the host, so two lines typed in the same tick cannot both pass; the crew is free again once that instance's work has
5
+ // ended: completed, failed, or stopped at its next cooperative checkpoint after a cancel (Orkeon #266), so a relaunch
6
+ // right after a cancel may still be refused. A command reads the crew and the ticket off the refusal through
7
+ // exclusiveRefusal and shows exclusiveLine, rather than failing on an unexplained throw. Pure.
8
+ import { alreadyRunning } from "./messages.ts";
9
+
10
+ const REFUSAL = /crew '([^']+)' already running \(ticket ([^\s)]+)\)/i;
11
+
12
+ /** What an exclusive refusal says: the crew that runs and the ticket of its instance. */
13
+ export interface ExclusiveRefusal { crew: string; ticket: string }
14
+
15
+ /** The crew and the ticket of an exclusive refusal; null for any other failure. */
16
+ export function exclusiveRefusal(error: unknown): ExclusiveRefusal | null {
17
+ const message = error instanceof Error ? error.message : typeof error === "string" ? error : String(error ?? "");
18
+ const m = REFUSAL.exec(message);
19
+ return m === null ? null : { crew: m[1], ticket: m[2] };
20
+ }
21
+
22
+ /** The line a command shows for a crew refused because it already runs. */
23
+ export function exclusiveLine(refusal: ExclusiveRefusal): string {
24
+ return alreadyRunning(refusal.crew, refusal.ticket);
25
+ }
@@ -0,0 +1,252 @@
1
+ // The agent instances of a crew run as /tasks sees them (A-3). The runtime keeps a crew's
2
+ // children (`crew.instances()`, `send`, `stop`) on the crew object of ONE run, which no command
3
+ // reaches: the crew writes a snapshot of its run in the session's state bag while its children
4
+ // run, and reads there the stop /tasks leaves for one instance. This module holds the two
5
+ // shapes, their reading, and what /tasks decides and shows from them. Pure, no IO.
6
+
7
+ import { AGENT_INSTANCES_STATE_PREFIX, AGENT_REQUEST_STATE_PREFIX } from "../session-keys.ts";
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";
14
+
15
+ export const INSTANCE_STATES = ["running", "completed", "failed", "stopped"] as const;
16
+ export type InstanceState = (typeof INSTANCE_STATES)[number];
17
+
18
+ /** The crews that run children and publish them: one snapshot key each. */
19
+ export const CHILD_CREWS = ["dev-spec", "dev-change", "dev-plan", "dev-verify"] as const;
20
+
21
+ // The runtime keeps a transcript of an ended instance for `crew.send` (`ScriptAgentInstanceOptions`, 40 messages
22
+ // and 32 000 characters by default). Orkeon Code sends nothing in place (sendVerdict): a repair is a new run whose
23
+ // brief carries the report (buildRepairBrief, within MAX_BRIEF_CHARS), so those limits bind nothing here.
24
+
25
+ /** The runtime's defaults for `crew.concurrency(n)` and `crew.maxInstances(n)`, and the bounds a crew input is held to. */
26
+ export const INSTANCE_LIMITS = {
27
+ concurrency: { fallback: 4, max: 16 },
28
+ maxInstances: { fallback: 32, max: 64 },
29
+ } as const;
30
+
31
+ /** One child of the run. `system` and `brief` are what it was asked, kept for a repair by a new run. */
32
+ export interface InstanceRecord {
33
+ /** The runtime's id (`a1`…); empty until the child has said it. */
34
+ id: string;
35
+ agent: string;
36
+ /** The built-in charter the child runs (built-in-charters.ts). */
37
+ charter: string;
38
+ task: string;
39
+ state: InstanceState;
40
+ startedAt: string;
41
+ endedAt?: string;
42
+ effort?: string;
43
+ system: string;
44
+ brief: string;
45
+ reply?: string;
46
+ error?: string;
47
+ stopRequested?: boolean;
48
+ }
49
+
50
+ /**
51
+ * One run of a crew: `serving` while its body answers requests, `open` until the body ends. A run
52
+ * that answers writes it again at least every SNAPSHOT_HEARTBEAT_MS, so a snapshot older than
53
+ * SNAPSHOT_STALE_MS is a run that died (settleSnapshot).
54
+ */
55
+ export interface RunSnapshot {
56
+ crew: string;
57
+ /** The dev step whose rule sets apply to the children (and to a repair). */
58
+ step: string;
59
+ startedAt: string;
60
+ updatedAt: string;
61
+ serving: boolean;
62
+ open: boolean;
63
+ instances: InstanceRecord[];
64
+ }
65
+
66
+ /** How often a run that answers writes its snapshot, changed or not. */
67
+ export const SNAPSHOT_HEARTBEAT_MS = 5_000;
68
+ /** How old the snapshot of a run that says it answers may be before /tasks takes the run for dead. */
69
+ export const SNAPSHOT_STALE_MS = 30_000;
70
+
71
+ /** What /tasks asks of one instance: stop it. `run` is the run's `startedAt`, so a request never reaches the next run's `a1`. */
72
+ export interface InstanceRequest { action: "stop"; run: string; at: string }
73
+
74
+ export const snapshotKey = (crew: string): string => `${AGENT_INSTANCES_STATE_PREFIX}${crew}`;
75
+ export const requestKey = (crew: string, id: string): string => `${AGENT_REQUEST_STATE_PREFIX}${crew}:${id}`;
76
+
77
+ const text = (v: unknown): string => (typeof v === "string" ? v : "");
78
+ const optional = (v: unknown): string | undefined => (typeof v === "string" && v !== "" ? v : undefined);
79
+
80
+ function parseRecord(raw: unknown): InstanceRecord | null {
81
+ const r = raw as Record<string, unknown> | null;
82
+ if (r === null || typeof r !== "object" || typeof r.agent !== "string") return null;
83
+ const state = (INSTANCE_STATES as readonly string[]).includes(String(r.state)) ? (r.state as InstanceState) : "failed";
84
+ return {
85
+ id: text(r.id), agent: r.agent, charter: text(r.charter) || r.agent, task: text(r.task), state,
86
+ startedAt: text(r.startedAt), endedAt: optional(r.endedAt), effort: optional(r.effort),
87
+ system: text(r.system), brief: text(r.brief), reply: optional(r.reply), error: optional(r.error),
88
+ stopRequested: r.stopRequested === true ? true : undefined,
89
+ };
90
+ }
91
+
92
+ /** A stored snapshot; null when there is none or it cannot be read. */
93
+ export function parseSnapshot(raw: string | null): RunSnapshot | null {
94
+ if (!raw) return null;
95
+ let v: Record<string, unknown>;
96
+ try {
97
+ v = JSON.parse(raw);
98
+ } catch {
99
+ return null;
100
+ }
101
+ if (v === null || typeof v !== "object" || typeof v.crew !== "string" || !Array.isArray(v.instances)) return null;
102
+ return {
103
+ crew: v.crew, step: text(v.step) || v.crew, startedAt: text(v.startedAt), updatedAt: text(v.updatedAt),
104
+ serving: v.serving === true, open: v.open === true,
105
+ instances: v.instances.map(parseRecord).filter((r): r is InstanceRecord => r !== null),
106
+ };
107
+ }
108
+
109
+ /** A stored request; null when there is none (an empty value is a cleared one) or it cannot be read. */
110
+ export function parseRequest(raw: string | null): InstanceRequest | null {
111
+ if (!raw) return null;
112
+ try {
113
+ const v = JSON.parse(raw);
114
+ if (v?.action === "stop") return { action: "stop", run: text(v.run), at: text(v.at) };
115
+ } catch {
116
+ // unreadable: no request
117
+ }
118
+ return null;
119
+ }
120
+
121
+ /**
122
+ * The snapshot as /tasks may trust it at `now`: a run that says it is open but has not written for
123
+ * SNAPSHOT_STALE_MS died (the host was stopped mid-run): it no longer answers, and its running
124
+ * children are failed, which a repair can take up.
125
+ */
126
+ export function settleSnapshot(s: RunSnapshot, now: Date): RunSnapshot {
127
+ const age = now.getTime() - Date.parse(s.updatedAt);
128
+ // An updatedAt that does not parse dates nothing: the run cannot be shown to answer, so it is taken for dead.
129
+ if (!s.open || (Number.isFinite(age) && age <= SNAPSHOT_STALE_MS)) return s;
130
+ return {
131
+ ...s, serving: false, open: false,
132
+ instances: s.instances.map((r) => r.state !== "running" ? r : { ...r, state: "failed", error: RUN_STOPPED_ANSWERING }),
133
+ };
134
+ }
135
+
136
+ /** A crew input as an integer within 1..max, else the runtime's default. */
137
+ function limit(raw: unknown, bounds: { fallback: number; max: number }): number {
138
+ const n = typeof raw === "number" ? raw : typeof raw === "string" && raw.trim() !== "" ? Number(raw) : NaN;
139
+ return Number.isInteger(n) && n >= 1 && n <= bounds.max ? n : bounds.fallback;
140
+ }
141
+
142
+ /** The `concurrency` and `maxInstances` a crew is built with, from its inputs. */
143
+ export function instanceLimits(raw: { concurrency?: unknown; maxInstances?: unknown } | null | undefined): {
144
+ concurrency: number; maxInstances: number;
145
+ } {
146
+ return {
147
+ concurrency: limit(raw?.concurrency, INSTANCE_LIMITS.concurrency),
148
+ maxInstances: limit(raw?.maxInstances, INSTANCE_LIMITS.maxInstances),
149
+ };
150
+ }
151
+
152
+ // ── /tasks: which instance a reference names, and what may be done with it ──
153
+
154
+ export interface Located { snapshot: RunSnapshot; record: InstanceRecord }
155
+
156
+ /**
157
+ * The instance `ref` names: `a1`, or `<crew>:a1` when two crews hold an `a1`. Only the last run of
158
+ * each crew is kept, so an id is unique within a crew.
159
+ */
160
+ export function locateInstance(snapshots: readonly RunSnapshot[], ref: string): { ok: true; found: Located } | { ok: false; text: string } {
161
+ const [crew, id] = ref.includes(":") ? ref.split(":", 2) : [undefined, ref];
162
+ const found = snapshots.flatMap((snapshot) =>
163
+ crew !== undefined && snapshot.crew !== crew
164
+ ? []
165
+ : snapshot.instances.filter((r) => r.id === id && id !== "").map((record) => ({ snapshot, record })));
166
+ if (found.length === 1) return { ok: true, found: found[0] };
167
+ if (found.length === 0) return { ok: false, text: noAgentInstance(ref) };
168
+ return {
169
+ ok: false,
170
+ text: namesAnInstanceOf(ref, found.map((f) => f.snapshot.crew).join(" and "),
171
+ found.map((f) => `${f.snapshot.crew}:${id}`).join(" or ")),
172
+ };
173
+ }
174
+
175
+ const label = (l: Located): string => `${l.snapshot.crew}:${l.record.id}`;
176
+
177
+ /** Whether /tasks may ask the crew to stop the instance: only a running one, of a run still answering. */
178
+ export function stopVerdict(l: Located): { ok: true } | { ok: false; text: string } {
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)) };
181
+ return { ok: true };
182
+ }
183
+
184
+ /**
185
+ * What a send to the instance becomes: refused while it runs; once it has ended, a repair by a new
186
+ * run. A send in place (`crew.send` over the kept transcript) is not offered: the parent stops
187
+ * answering as soon as its child settles, so no command would ever reach the crew object in time.
188
+ */
189
+ export function sendVerdict(l: Located): { kind: "refused"; text: string } | { kind: "repair" } {
190
+ if (l.record.state === "running") {
191
+ return { kind: "refused", text: sendRefusedWhileRunning(label(l), l.record.id) };
192
+ }
193
+ return { kind: "repair" };
194
+ }
195
+
196
+ /** The tail of `s` within `max` characters, the cut said in front. */
197
+ function tail(s: string, max: number): string {
198
+ if (s.length <= max) return s;
199
+ return max <= CUT_MARK.length ? s.slice(s.length - max) : CUT_MARK + s.slice(s.length - (max - CUT_MARK.length));
200
+ }
201
+
202
+ /**
203
+ * The brief of a repair by a new run: the operator's message, the previous report and the previous
204
+ * brief, within MAX_BRIEF_CHARS; the previous brief is cut first, from its start, then the report.
205
+ * The new run has no live context of the old one, and the brief says so.
206
+ */
207
+ export function buildRepairBrief(record: InstanceRecord, message: string): string {
208
+ const head = [
209
+ repairOpening(record.charter, record.id || "?"),
210
+ REPAIR_INSTRUCTION,
211
+ "",
212
+ "## Operator's message",
213
+ message.trim(),
214
+ "",
215
+ "## Previous report",
216
+ "",
217
+ ].join("\n");
218
+ const report = record.reply ?? noReport(record.state, record.error ? `: ${record.error}` : "");
219
+ const briefHeading = "\n\n## Previous brief\n";
220
+ const forReport = MAX_BRIEF_CHARS - head.length - briefHeading.length;
221
+ const keptReport = tail(report, Math.max(0, forReport));
222
+ const forBrief = MAX_BRIEF_CHARS - head.length - keptReport.length - briefHeading.length;
223
+ const out = head + keptReport + briefHeading + tail(record.brief, Math.max(0, forBrief));
224
+ return out.slice(0, MAX_BRIEF_CHARS);
225
+ }
226
+
227
+ /** One row per instance, the open runs first, for the /tasks table. */
228
+ export function instanceRows(snapshots: readonly RunSnapshot[]): Array<Record<string, string>> {
229
+ const ordered = [...snapshots].sort((a, b) => Number(b.open) - Number(a.open) || b.startedAt.localeCompare(a.startedAt));
230
+ return ordered.flatMap((s) => s.instances.map((r) => ({
231
+ id: r.id || "?",
232
+ crew: s.crew,
233
+ agent: r.agent,
234
+ state: r.stopRequested && r.state === "running" ? RUNNING_STOP_ASKED : r.state,
235
+ task: r.task,
236
+ run: s.serving ? "answering" : s.open ? RUNNING_NOT_ANSWERING : "ended",
237
+ })));
238
+ }
239
+
240
+ /** The lines `/tasks show <id>` prints. */
241
+ export function describeInstance(l: Located): string[] {
242
+ const { snapshot: s, record: r } = l;
243
+ const lines = [
244
+ `${label(l)} — ${r.agent} (${r.charter}), ${r.state}${r.stopRequested && r.state === "running" ? ", stop asked" : ""}`,
245
+ `task: ${r.task}`,
246
+ `started ${r.startedAt}${r.endedAt ? `, ended ${r.endedAt}` : ""}${r.effort ? `, effort ${r.effort}` : ""}`,
247
+ runOfStarted(s.crew, s.startedAt, s.serving ? "answering /tasks" : s.open ? RUNNING_NO_LONGER_ANSWERING : "ended"),
248
+ ];
249
+ if (r.error) lines.push(`error: ${r.error}`);
250
+ if (r.reply) lines.push("report:", r.reply);
251
+ return lines;
252
+ }
@@ -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`;