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,383 @@
1
+ // MainLoop use case — one turn of the interactive loop: run in the mode the
2
+ // launching command resolved, keep the session buffer, compact around the turn,
3
+ // assemble the prompt (F4) and run the autonomous act() call. The turn's messages are
4
+ // built by ./prompts, the breaker by ./auto-compact; every dependency comes
5
+ // in through the ports.
6
+
7
+ import type { ContextPruning } from "../../../shared/application/compaction/prune-context.ts";
8
+ import {
9
+ MEMORY_TOOLS, catalogueFor, parseStoredRule, resolvePermissionMode, scriptToolsFor,
10
+ } from "../../../shared/domain/agent-policy/permission.ts";
11
+ import type { CatalogueDecision, ExtraTool } from "../../../shared/domain/agent-policy/permission.ts";
12
+ import { parseExtraTools } from "../../../shared/domain/agent-policy/extra-tools.ts";
13
+ import {
14
+ DEFAULT_BEHAVIOR_FLAGS, describeActiveFlags, maxIterationsFor,
15
+ } from "../../../shared/domain/agent-policy/behavior-flags.ts";
16
+ import type { BehaviorFlags } from "../../../shared/domain/agent-policy/behavior-flags.ts";
17
+ import type { Llm, Logger, ToolCatalogue } from "../../../shared/application/ports.ts";
18
+ import {
19
+ applyPrelude, epilogueArgs, errorText, parseEpilogue, parsePrelude, toolFailure,
20
+ } from "../../../shared/domain/prelude.ts";
21
+ import type { PreludeCall } from "../../../shared/domain/prelude.ts";
22
+ import { budgetExhaustedAnswerOf, decisionBlockOf, decisionBlockText, iterationsExhaustedOf } from "../../../shared/domain/llm-failure.ts";
23
+ import type { SessionIo } from "../../../shared/application/session-io.ts";
24
+ import { stateSnapshot } from "../../../shared/application/state-snapshot.ts";
25
+ import {
26
+ AUTOCOMPACT_BREAKER_STATE_KEY, EFFORT_STATE_KEY, FAST_MODE_STATE_KEY, HOOKS_STATE_KEY, MODEL_PREFERENCE_STATE_KEY,
27
+ OUTPUT_STYLE_STATE_KEY, PASSES_STATE_KEY, PROACTIVE_STATE_KEY, SKILLS_STATE_KEY,
28
+ } from "../../../shared/domain/session-keys.ts";
29
+ import type { ToolTrace } from "../../../shared/application/dev/tool-trace-recorder.ts";
30
+ import type { HostSource } from "../../../shared/application/host-context.ts";
31
+ import { IDENTITY_HOST } from "../../../shared/domain/host-layout.ts";
32
+ import { textToVirtual } from "../../../shared/domain/host-paths.ts";
33
+ import { readBehaviorFlags } from "./context-gather.ts";
34
+ import { autoCompactGuarded } from "./auto-compact.ts";
35
+ import type { AutoCompactDeps } from "./auto-compact.ts";
36
+ import { buildTurnPrompt } from "./turn-context.ts";
37
+ import {
38
+ actEffort, actHostEffort, BUDGET_EXHAUSTED_LINE, budgetRanOut, turnsRanOut, effortNotSent, effortSentAs, gateOffWarning, MODE_ORIGIN_BUILT_IN, modelOverrideIgnored, NO_PROMPT,
39
+ nothingToSend, preludeRunning, rulesRemoved, ruleWithoutEffect, stopCheckRetryFailed, stopCheckSendsBack,
40
+ } from "./messages.ts";
41
+ import type { TurnContextDeps, TurnPrompt } from "./turn-context.ts";
42
+ import {
43
+ STOP_GUARDS, TURN_START_GUARDS, buildStopRetryPrompt, buildTurnContextMessage, readClosingLine, refusedTurnText,
44
+ runChain,
45
+ } from "../domain/turn-chains.ts";
46
+ import type { Guard, StopFacts, TurnStartFacts } from "../domain/turn-chains.ts";
47
+ import { readStartOutput } from "../../../shared/domain/session-start.ts";
48
+ import { llmProfileOf } from "../../../shared/domain/llm-profile.ts";
49
+ import type { EffortReport } from "../../../shared/domain/agent-policy/reasoning.ts";
50
+
51
+ /** The crew's input, as launchMainLoop (/assistant, /summary, /transcribe --then, /voice send and --go) passes it. */
52
+ export interface MainLoopInputs {
53
+ prompt?: unknown;
54
+ /** The mode of the turn, resolved by the launching command: the request's
55
+ * `mode:` prefix, else the session's. Absent, the turn runs in `default`. */
56
+ permissionMode?: unknown;
57
+ /** Where a mode the request did not name came from ("session default via /mode"). */
58
+ permissionModeVia?: unknown;
59
+ /** The session's rules ("deny file_write"), threaded by launchMainLoop, which
60
+ * has handed them to the host gate already. */
61
+ permissionRules?: unknown[];
62
+ /** The extra tools the host registers ("search_issues:write"), filtered by launchMainLoop. */
63
+ extraTools?: unknown[];
64
+ /** The session's `llm.profile`, as launchCrew hands it: every agent of the crew runs on it, and the
65
+ * /model override is not sent under it (the profile names the model). */
66
+ llmProfile?: unknown;
67
+ /** A tool call the launching command asks for before the turn ({ tool, args, label, as? }):
68
+ * /transcribe --then hands over the transcription this way, its result following the
69
+ * request under its label in the message the model reads and the session keeps;
70
+ * /voice --go its dictation, which is the request itself (`as: "request"`). */
71
+ prelude?: unknown;
72
+ /** A tool call the launching command asks for after the turn, with the answer
73
+ * ({ tool, args, textArg, label }): voice.reply reads the answer aloud this way.
74
+ * A failure is a warning; the turn and its answer stand. */
75
+ epilogue?: unknown;
76
+ /** What the session's start script printed ({ script, lines }), on the first free-text
77
+ * turn of a session only: /assistant takes it off the runtime's raw input. */
78
+ sessionStart?: unknown;
79
+ /** The text a line of the answer must start with: an answer without it goes back once. */
80
+ closingLine?: unknown;
81
+ }
82
+
83
+ /** The tool catalogue the agent is built with, the mode it was built for, and the
84
+ * extra tools it was built with. */
85
+ export interface LoadedCatalogue {
86
+ mode: string;
87
+ extras: ExtraTool[];
88
+ catalogue: CatalogueDecision;
89
+ /** Orkeon Code's own tools the mode offers under the rules (the shared memory's), attached by name. */
90
+ scriptTools: string[];
91
+ }
92
+
93
+ /**
94
+ * The catalogue, decided at load time — module scope is synchronous — from the
95
+ * inputs alone: the launching command resolved the mode (the session's too) and
96
+ * the extra tools before the crew loads, so the catalogue, the act call and the
97
+ * host gate all run in the same mode. Launched without a mode (scripts/run-crew.sh),
98
+ * the turn runs in `default`. That run is headless: no operator to ask and no
99
+ * session rules, so a gate turned on (the example settings do) REFUSES each call
100
+ * the mode would ask about — every write, every command, every network read — and
101
+ * the model reads `DENIED: …`. A `permissionMode` input lets them run
102
+ * (`--inputs '{"prompt":"…","permissionMode":"bypassPermissions"}'`).
103
+ *
104
+ * The rules are the host gate's to enforce (launchMainLoop handed them over);
105
+ * the catalogue only drops the tools a deny rule covers whole, so the model is
106
+ * not offered a tool whose every call would be refused.
107
+ */
108
+ export function loadCatalogue(input: MainLoopInputs): LoadedCatalogue {
109
+ const mode = resolvePermissionMode(input.permissionMode);
110
+ const extras = parseExtraTools(input.extraTools ?? []).tools;
111
+ const extraNames = extras.map((t) => t.name);
112
+ const rules = (input.permissionRules ?? [])
113
+ .map((raw) => parseStoredRule(raw, extraNames))
114
+ .filter((r): r is NonNullable<typeof r> => r !== null);
115
+ return { mode, extras, catalogue: catalogueFor(mode, rules, extras), scriptTools: scriptToolsFor(mode, MEMORY_TOOLS, rules) };
116
+ }
117
+
118
+ /** Where the mode of the turn came from, when the request did not name it. */
119
+ function modeOrigin(input: MainLoopInputs): string | null {
120
+ if (typeof input.permissionModeVia === "string" && input.permissionModeVia.length > 0) return input.permissionModeVia;
121
+ return input.permissionMode == null ? MODE_ORIGIN_BUILT_IN : null;
122
+ }
123
+
124
+ /** Append one turn to the session buffer (best-effort — continuity across runs).
125
+ * Stores the RAW prompt, never the assembled one: the buffer is the conversation
126
+ * thread — embedding assembled prompts would re-nest quadratically and break the
127
+ * byte-stable cache prefix. */
128
+ export async function appendTurn(session: Pick<SessionIo, "appendMessage">, role: string, content: string): Promise<void> {
129
+ try {
130
+ await session.appendMessage(role, content);
131
+ } catch { /* session buffer optional */ }
132
+ }
133
+
134
+ /** What the provider receives when it is not the level asked (Orkeon #360); empty when it is, or unknown. */
135
+ function sentOf(report: EffortReport | null): string {
136
+ if (report === null || report.notice === null || report.notice === "unchecked") return "";
137
+ return report.sent === null ? effortNotSent(report.model) : effortSentAs(report.sent, report.model);
138
+ }
139
+
140
+ /**
141
+ * Run the autonomous tool-use loop and return its text output.
142
+ *
143
+ * `permissionMode` is consumed by the host's per-tool-call gate, which reads the
144
+ * session's rules first and asks the operator when the mode says so. `maxIterations` and, when /effort stored a level,
145
+ * the provider's `effort` come from `/effort` (B-9, A-3), and the optional
146
+ * model from `/model` (B-10) — the latter PATCHES the provider's own
147
+ * configuration, so the boot credentials and endpoint are preserved and only the
148
+ * model name changes for this call.
149
+ */
150
+ export async function runAct(
151
+ deps: { llm: Pick<Llm, "act" | "effortSent">; log: Logger },
152
+ turn: TurnPrompt,
153
+ mode: string,
154
+ flags: BehaviorFlags = DEFAULT_BEHAVIOR_FLAGS,
155
+ pruning: ContextPruning = {},
156
+ ): Promise<string> {
157
+ const active = describeActiveFlags(flags);
158
+ // Anything off-default is announced: a turn that stops after 10 iterations, or
159
+ // answers from a different model, must not read as the model being erratic.
160
+ if (active) deps.log.info(`session flags — ${active}`);
161
+ const maxIterations = maxIterationsFor(flags.effort);
162
+ // A level /effort stored reaches the provider (A-3); the line says what this act was given.
163
+ // Judged on the agent's own provider and model (its profile included), the /model override over them. With no
164
+ // level stored, the host's own `Llm:Thinking:Effort` still goes out: the line says so when the runtime reports one.
165
+ const report = deps.llm.effortSent({ effort: flags.thinking ?? undefined, model: flags.model });
166
+ if (flags.thinking !== null) deps.log.info(actEffort(flags.thinking, maxIterations, sentOf(report)));
167
+ else if (report !== null) deps.log.info(actHostEffort(report.asked, maxIterations, sentOf(report)));
168
+
169
+ return await deps.llm.act(turn.request, {
170
+ maxIterations,
171
+ ...(flags.thinking === null ? {} : { effort: flags.thinking }),
172
+ permissionMode: mode,
173
+ // The static header rides as a REAL system message (ActOptions.system):
174
+ // identity and tool policy outrank user text and tool results, and the
175
+ // provider's native system handling (Anthropic top-level `system`,
176
+ // cache_control) finally applies.
177
+ system: turn.system,
178
+ // The volatile blocks ride as a user message of their own before the request
179
+ // (ActOptions.context, Orkeon #276): a decision guard judges the request alone.
180
+ context: turn.context,
181
+ model: flags.model,
182
+ // The pruning of the loop's stale tool results, when the session turned it on (compaction.prune).
183
+ ...pruning,
184
+ });
185
+ }
186
+
187
+ /** The ports one turn runs on. */
188
+ export interface MainLoopDeps extends TurnContextDeps, Omit<AutoCompactDeps, "session"> {
189
+ session: SessionIo;
190
+ llm: Pick<Llm, "act" | "effortSent" | "permissionGateEnabled">;
191
+ /** The calls of a prelude and an epilogue, by the registered name the launching command found. */
192
+ tools: Pick<ToolCatalogue, "callText">;
193
+ /** The recorder of the act's tool calls (dev/tool-trace-recorder); absent, the turn stores no [tools] message. */
194
+ trace?: Pick<ToolTrace, "take">;
195
+ /** The guards of the two chains; absent, the built-in ones (domain/turn-chains). */
196
+ chains?: { turnStart?: ReadonlyArray<Guard<TurnStartFacts>>; stop?: ReadonlyArray<Guard<StopFacts>> };
197
+ /** This run's host context (shared/application/host-context): the request's disk spellings come back to the VFS
198
+ * before anything reads them; absent, the identity. */
199
+ host?: HostSource;
200
+ /** What the act carries to prune its loop's stale tool results (shared/application/compaction/prune-context),
201
+ * for the request it works on; absent, nothing is pruned. */
202
+ prune?: (request: string) => Promise<ContextPruning>;
203
+ }
204
+
205
+ /** The request once the prelude's call answered (applyPrelude). */
206
+ async function withPreludeResult(request: string, prelude: PreludeCall, deps: Pick<MainLoopDeps, "tools" | "log">): Promise<string> {
207
+ deps.log.info(preludeRunning(prelude.label, prelude.tool));
208
+ const outcome = await deps.tools.callText(prelude.tool, prelude.args);
209
+ if (!outcome.ok) throw toolFailure(prelude.tool, outcome.failure);
210
+ return applyPrelude(request, prelude, outcome.text);
211
+ }
212
+
213
+ /** The epilogue the input names, with the answer; a failure is logged, never thrown. */
214
+ async function runEpilogue(value: unknown, answer: string, deps: Pick<MainLoopDeps, "tools" | "log">): Promise<void> {
215
+ const epilogue = parseEpilogue(value);
216
+ if (epilogue === null || answer.trim().length === 0) return;
217
+ const outcome = await deps.tools.callText(epilogue.tool, epilogueArgs(epilogue, answer));
218
+ if (outcome.ok) deps.log.info(`${epilogue.label}: ${outcome.text.trim() || epilogue.tool}`);
219
+ else deps.log.warn(`${epilogue.label}: ${epilogue.tool} failed: ${outcome.failure}`);
220
+ }
221
+
222
+ /** The session state key remembering that the operator was told the gate is off. */
223
+ const GATE_WARNED_KEY = "gate.warned";
224
+
225
+ /** The line the operator reads ONCE per session when the host says its permission gate
226
+ * is off (Orkeon #128): every tool call of the turn runs unchecked, whatever the mode
227
+ * promises. Nothing in bypassPermissions, which promises nothing, nor on a host that
228
+ * cannot say. Shown above the answer, logged, never stored in the transcript. */
229
+ async function gateWarning(mode: string, deps: Pick<MainLoopDeps, "llm" | "session" | "log">): Promise<string | null> {
230
+ if (mode === "bypassPermissions" || deps.llm.permissionGateEnabled() !== false) return null;
231
+ if (await deps.session.readState(GATE_WARNED_KEY) !== null) return null;
232
+ await deps.session.writeState(GATE_WARNED_KEY, "1");
233
+ const text = gateOffWarning(mode);
234
+ deps.log.warn(text);
235
+ return text;
236
+ }
237
+
238
+ /** The answer of a turn, and whether the token budget cut it short. */
239
+ interface TurnAnswer { answer: string; cut: boolean }
240
+
241
+ /** The answer once the stop chain read it: a refused answer goes back to the model ONCE,
242
+ * with the reason, and the second answer stands whatever the chain would say of it. When that
243
+ * retry throws, a first answer that is not blank stands, with a warning. An act whose token
244
+ * budget ran out (BudgetExhaustedAnswer) gives its wrap-up as the answer, `cut`, and goes
245
+ * through no stop check: a second act would meet the same spent budget. An act stopped at its
246
+ * iteration cap (IterationsExhausted) answers the runtime's notice, with no stop check either. */
247
+ async function stopChecked(
248
+ deps: Pick<MainLoopDeps, "llm" | "log" | "chains">, turn: TurnPrompt, mode: string, flags: BehaviorFlags,
249
+ request: string, closingLine: string | null, pruningOf: () => Promise<ContextPruning>,
250
+ ): Promise<TurnAnswer> {
251
+ let answer: string;
252
+ try {
253
+ answer = await runAct(deps, turn, mode, flags, await pruningOf());
254
+ } catch (error) {
255
+ const stopped = iterationsExhaustedOf(error);
256
+ if (stopped !== null) {
257
+ deps.log.warn(turnsRanOut(errorText(error)));
258
+ return { answer: stopped.notice, cut: false };
259
+ }
260
+ const exhausted = budgetExhaustedAnswerOf(error);
261
+ if (exhausted === null) throw error;
262
+ deps.log.warn(budgetRanOut(errorText(error)));
263
+ return { answer: exhausted.answer, cut: true };
264
+ }
265
+ const stop = runChain("stop", deps.chains?.stop ?? STOP_GUARDS, { request, answer, closingLine });
266
+ if (stop.refusedBy === undefined) return { answer, cut: false };
267
+ deps.log.info(stopCheckSendsBack(stop.refusedBy, String(stop.reason)));
268
+ try {
269
+ return { answer: await runAct(deps, { ...turn, request: buildStopRetryPrompt(turn.request, answer, stop.reason ?? "") }, mode, flags, await pruningOf()), cut: false };
270
+ } catch (error) {
271
+ // A retry that fails (a provider error) never costs the turn an answer it had: the first one stands, said.
272
+ if (answer.trim().length === 0) throw error;
273
+ deps.log.warn(stopCheckRetryFailed(stop.refusedBy, errorText(error)));
274
+ return { answer, cut: false };
275
+ }
276
+ }
277
+
278
+ /** The flags of a turn under the session's `llm.profile`: the profile names the model, so a /model override is
279
+ * dropped and said once for the turn. Sent as the per-call model, it would replace the profile's own model, and a
280
+ * decision profile's escalation target with it (the runtime patches the same call configuration onto both). */
281
+ function underProfile(flags: BehaviorFlags, profile: string | null, log: Pick<Logger, "warn">): BehaviorFlags {
282
+ if (profile === null || flags.model === "") return flags;
283
+ log.warn(modelOverrideIgnored(flags.model, profile));
284
+ return { ...flags, model: "" };
285
+ }
286
+
287
+ /** The state keys a turn reads, in ONE session_store call at its start (Orkeon #263): the behaviour flags, the
288
+ * output style, the hooks, the skills, the compaction breaker (read at the head and the tail) and the gate's
289
+ * warning. A key read and missing here costs its own call, as before. */
290
+ const TURN_STATE_KEYS = [
291
+ EFFORT_STATE_KEY, PASSES_STATE_KEY, FAST_MODE_STATE_KEY, PROACTIVE_STATE_KEY, MODEL_PREFERENCE_STATE_KEY,
292
+ OUTPUT_STYLE_STATE_KEY, HOOKS_STATE_KEY, SKILLS_STATE_KEY, AUTOCOMPACT_BREAKER_STATE_KEY, GATE_WARNED_KEY,
293
+ ];
294
+
295
+ /** One turn: the answer, or why there was none. */
296
+ export async function runMainLoop(input: MainLoopInputs, loaded: LoadedCatalogue, given: MainLoopDeps): Promise<string> {
297
+ // A path the user typed as the disk spells it names the VFS path from here on, in the transcript too; what a
298
+ // fenced block quotes stays as typed.
299
+ const layout = given.host === undefined ? IDENTITY_HOST : (await given.host()).layout;
300
+ const request = textToVirtual(String(input.prompt ?? "").trim(), layout, { keepFenced: true });
301
+ const prelude = parsePrelude(input.prelude);
302
+ if (request.length === 0 && prelude?.as !== "request") return NO_PROMPT;
303
+ // Every reader of the turn reads the state bag through this session: its keys come from one batch read.
304
+ const session: SessionIo = { ...given.session, ...await stateSnapshot(given.session, TURN_STATE_KEYS) };
305
+ const deps: MainLoopDeps = { ...given, session };
306
+ const { log } = deps;
307
+ // The prelude runs first, as the launching command's call (the gate does not ask):
308
+ // a failure fails the run before any message is stored or any model is called.
309
+ const prompt = prelude === null ? request : await withPreludeResult(request, prelude, deps);
310
+ if (prompt.length === 0) return nothingToSend(prelude?.label ?? "the request");
311
+
312
+ // The mode the catalogue was built for: the "mode:" prefix, else the session
313
+ // default set by /mode, else the fallback (B-2 — built-in 'default' like the
314
+ // original, or the opt-in 'permissions.fallback'), as the command resolved it.
315
+ const { mode } = loaded;
316
+ // Logged on EVERY turn the request did not name the mode of, not only when
317
+ // /mode set one: a session running the fallback is exactly the case that used
318
+ // to say nothing.
319
+ const origin = modeOrigin(input);
320
+ if (origin) log.info(`permission mode '${mode}' — ${origin}`);
321
+ // A rule that changed the catalogue must announce itself. A catalogue silently
322
+ // short of a tool is indistinguishable from a mode that never had it.
323
+ const { catalogue } = loaded;
324
+ if (catalogue.deniedByRule.length > 0) {
325
+ log.warn(rulesRemoved(catalogue.deniedByRule.join(", ")));
326
+ }
327
+ for (const r of catalogue.inert) log.warn(ruleWithoutEffect(r.reason));
328
+ const warning = await gateWarning(mode, deps);
329
+
330
+ // B-9 / B-10: the persisted behavior flags, read ONCE per turn so prompt
331
+ // assembly and the act() call cannot disagree about them mid-turn.
332
+ const flags = underProfile(await readBehaviorFlags(session), llmProfileOf(input as Record<string, unknown>), log);
333
+
334
+ // turn-start: a refusal ends the turn before anything is stored or any model is
335
+ // called; the context lines are stored just before the request, so this turn and
336
+ // the later ones read them in the history.
337
+ const start = runChain("turn-start", deps.chains?.turnStart ?? TURN_START_GUARDS, {
338
+ request: prompt, sessionStart: readStartOutput(input.sessionStart),
339
+ });
340
+ if (start.refusedBy !== undefined) {
341
+ const text = refusedTurnText(start);
342
+ log.warn(text);
343
+ return text;
344
+ }
345
+ if (start.context.length > 0) await appendTurn(session, "user", buildTurnContextMessage(start.context));
346
+
347
+ await appendTurn(session, "user", prompt);
348
+ // Head-of-turn auto-compaction (F3): act() starts from a healthy buffer.
349
+ await autoCompactGuarded(deps);
350
+ const assembled = await buildTurnPrompt(prompt, mode, flags, deps, loaded.extras, loaded.scriptTools);
351
+ // A turn the provider failed throws (LlmFailure), as any failure of act does:
352
+ // no answer is stored, the tail compaction does not run (the breaker counts
353
+ // compactions, not turns), and the run fails with the provider's error, which
354
+ // /assistant shows. The user's message stays in the buffer.
355
+ // A call a decision stage blocked (DecisionBlockedError) is a decision, not an outage: the turn ends
356
+ // with the block said, nothing stored after the user's message but the [tools] message of the calls that
357
+ // ran before it (an edit made on disk stays on record), the run not failed.
358
+ // The calls of a head-of-turn compaction are not the answer's: the trace starts with the act.
359
+ deps.trace?.take();
360
+ // One binding per act: the runtime numbers the calls of each act from 1, and the binding remembers them.
361
+ const pruningOf = async (): Promise<ContextPruning> => deps.prune === undefined ? {} : await deps.prune(prompt);
362
+ let checked: { answer: string; cut: boolean };
363
+ try {
364
+ checked = await stopChecked(deps, assembled, mode, flags, prompt, readClosingLine(input.closingLine), pruningOf);
365
+ } catch (error) {
366
+ const block = decisionBlockOf(error);
367
+ if (block === null) throw error;
368
+ const ran = deps.trace?.take() ?? null;
369
+ if (ran !== null) await appendTurn(session, "system", ran);
370
+ const text = decisionBlockText(block);
371
+ log.warn(text);
372
+ return [warning, text].filter((part) => part !== null).join("\n\n");
373
+ }
374
+ const { answer, cut } = checked;
375
+ const traced = deps.trace?.take() ?? null;
376
+ if (traced !== null) await appendTurn(session, "system", traced);
377
+ await appendTurn(session, "assistant", answer);
378
+ await runEpilogue(input.epilogue, answer, deps);
379
+ // Tail-of-turn: a verbose act() must not bequeath a saturated buffer.
380
+ await autoCompactGuarded(deps);
381
+ // The budget line is shown, never stored: the transcript keeps what the model said.
382
+ return [warning, answer, cut ? BUDGET_EXHAUSTED_LINE : null].filter((part) => part !== null).join("\n\n");
383
+ }
@@ -0,0 +1,111 @@
1
+ // The act() messages of one main-loop turn: the reads of context-gather,
2
+ // rendered by the pure ../domain/prompt-assembly. The permission/toolset logic is
3
+ // pure in shared/domain/agent-policy/permission.
4
+
5
+ import { buildActPrompt, toolsetFor } from "../../../shared/domain/agent-policy/permission.ts";
6
+ import { proactiveSuffix } from "../../../shared/domain/agent-policy/behavior-flags.ts";
7
+ import type { BehaviorFlags } from "../../../shared/domain/agent-policy/behavior-flags.ts";
8
+ import {
9
+ assembleContext,
10
+ buildGaugeBlock,
11
+ buildHistoryBlock,
12
+ buildMemoryBlock,
13
+ buildStaticHeader,
14
+ buildUserContextBlock,
15
+ windowHistory,
16
+ withoutCurrentRequest,
17
+ buildPreferencesBlock,
18
+ buildSkillsBlock,
19
+ buildSuggestedSkillsBlock,
20
+ buildHooksBlock,
21
+ } from "../domain/prompt-assembly.ts";
22
+ import {
23
+ readInstructionsFile, readGauge, readGitContext, readLanguage, readMemoryByCategory,
24
+ readOutputStyle, readHooks,
25
+ } from "./context-gather.ts";
26
+ import { readAttachedSkills } from "../../../shared/application/attached-skills.ts";
27
+ import type { AttachedSkill } from "../../../shared/application/attached-skills.ts";
28
+ import type { ConfigStore } from "../../../shared/application/config-store.ts";
29
+ import type { Clock, Files, MemoryStore, SessionStore, Shell, Telemetry } from "../../../shared/application/ports.ts";
30
+ import { isoDay } from "../../../shared/domain/iso-day.ts";
31
+ import type { SessionMsg } from "../../../shared/domain/types.ts";
32
+ import type { ExtraTool } from "../../../shared/domain/agent-policy/permission.ts";
33
+
34
+ /** The ports the prompt of a turn is gathered from. */
35
+ export interface TurnContextDeps {
36
+ shell: Shell;
37
+ session: SessionStore;
38
+ files: Files;
39
+ telemetry: Telemetry;
40
+ memory: MemoryStore;
41
+ /** The layered settings, for the answer language; absent = no language preference. */
42
+ config?: Pick<ConfigStore, "readValue">;
43
+ /** The time now: the environment block carries its UTC day. */
44
+ clock: Clock;
45
+ /** The skills suggested for the request (shared/application/skills/suggest-skills), given the paths already
46
+ * attached; absent, none is suggested. */
47
+ suggest?: (request: string, attached: readonly string[]) => Promise<AttachedSkill[]>;
48
+ }
49
+
50
+ /** One act() turn's messages: the byte-stable system prompt, the volatile context, the request. */
51
+ export interface TurnPrompt {
52
+ system: string;
53
+ /** The user message before the request (`ActOptions.context`); empty when no block renders. */
54
+ context: string;
55
+ /** The prompt: the request, its permission note, the proactive clause — the last user message. */
56
+ request: string;
57
+ }
58
+
59
+ /**
60
+ * Assemble the act() messages of this turn: the byte-stable static header
61
+ * (behaviour rules + tools + the project's instructions file) is the SYSTEM prompt,
62
+ * the volatile blocks (preferences, skills, memory, hooks, environment, windowed
63
+ * history, budget gauge) are the CONTEXT, and the request is the prompt, alone in the
64
+ * last user message: the message a decision profile's guard judges (Orkeon #276).
65
+ */
66
+ export async function buildTurnPrompt(
67
+ prompt: string,
68
+ mode: string,
69
+ flags: BehaviorFlags,
70
+ deps: TurnContextDeps,
71
+ extras: readonly ExtraTool[] = [],
72
+ scriptTools: readonly string[] = [],
73
+ ): Promise<TurnPrompt> {
74
+ // /fast: skip the two advisory reads entirely, not just their rendering.
75
+ // Rendering-only would keep paying for the memory listing and every skill file
76
+ // read — the latency the flag exists to buy.
77
+ const wantAdvisory = !flags.fast;
78
+ const { shell, session, files, telemetry } = deps;
79
+ const [instructions, memory, git, history, gauge, outputStyle, hooks, skills, language] = await Promise.all([
80
+ readInstructionsFile(files),
81
+ wantAdvisory ? readMemoryByCategory(deps.memory) : Promise.resolve({} as Record<string, string[]>),
82
+ readGitContext(shell),
83
+ session.readMessages().then((read) => read.messages).catch(() => [] as SessionMsg[]),
84
+ readGauge(session, telemetry),
85
+ readOutputStyle(session),
86
+ readHooks(session),
87
+ wantAdvisory ? readAttachedSkills(session, files) : Promise.resolve([] as AttachedSkill[]),
88
+ readLanguage(deps.config),
89
+ ]);
90
+ // The skills that fit this request come after the ones a person attached, in a block of their own, for this turn only.
91
+ const suggested = wantAdvisory && deps.suggest !== undefined ? await deps.suggest(prompt, skills.map((skill) => skill.path)) : [];
92
+ const today = isoDay(deps.clock());
93
+
94
+ return {
95
+ system: buildStaticHeader({ toolNames: toolsetFor(mode, extras), scriptTools, instructions }),
96
+ context: assembleContext({
97
+ // All volatile, all in the context. An unconfigured session renders none
98
+ // of the optional blocks.
99
+ preferences: buildPreferencesBlock({ outputStyle, language }),
100
+ skills: [buildSkillsBlock(skills), buildSuggestedSkillsBlock(suggested)].filter((block) => block.length > 0).join("\n\n"),
101
+ memory: buildMemoryBlock(memory),
102
+ hooks: buildHooksBlock(hooks),
103
+ userContext: buildUserContextBlock({ ...git, date: today }),
104
+ // The buffer already ends with this request: the task block carries it.
105
+ history: buildHistoryBlock(windowHistory(withoutCurrentRequest(history, prompt))),
106
+ gauge: buildGaugeBlock(gauge),
107
+ }),
108
+ // /proactive: the clause rides with the request, the last thing the model reads.
109
+ request: "## Request\n" + buildActPrompt(prompt, mode) + proactiveSuffix(flags.proactive),
110
+ };
111
+ }
@@ -0,0 +1,124 @@
1
+ // @orkeon-script 1.0
2
+ /// <reference path="../.orkeon/orkeon.d.ts" />
3
+ //
4
+ // Interactive coding-agent loop (main-loop) — exp 07 SPEC §3. Composition root.
5
+ // The agent's `.body()` IS the loop: one turn of application/run-main-loop, whose
6
+ // act() call runs the LLM ⇄ tool-calling cycle over the agent's tool catalogue,
7
+ // under an autonomous execution budget.
8
+ //
9
+ // Triggered by: /assistant "<demande>", /summary, /transcribe --then, /voice send|--go
10
+ // → script-host.runCrewAsync("main-loop", { prompt, permissionMode, ... })
11
+ // Input (globalThis.inputs): { prompt: string, permissionMode?: "default"|"acceptEdits"|"bypassPermissions"|"plan"|"dontAsk",
12
+ // permissionModeVia?: string, permissionRules?: string[], extraTools?: string[],
13
+ // prelude?: { tool, args, label, as? }, epilogue?: { tool, args, textArg, label },
14
+ // sessionStart?: { script, lines }, closingLine?: string }
15
+ // sessionStart is what the session's start script printed (first turn only): the
16
+ // turn-start chain stores it as a [turn-context] message before the request. The stop
17
+ // chain sends a blank answer back once, and one without a line starting with
18
+ // closingLine when the launching command names one (domain/turn-chains).
19
+ // The launching command resolves the mode (the session's when the request names
20
+ // none) and the extra tools the host registers: without a mode the turn runs in
21
+ // `default`. A prelude is its tool call before the turn (the transcription of
22
+ // /transcribe --then, the dictation of /voice --go), an epilogue its call after
23
+ // it, with the answer (voice.reply: speak). Both run within the turn's wallTime.
24
+ //
25
+ // Permissions: the TOOL CATALOGUE is what the mode offers the model
26
+ // (shared/domain/agent-policy), the extra tools of the classes it grants
27
+ // included, less the tools a deny rule covers whole; `plan` and `dontAsk` offer
28
+ // no mutating tool. The host's permission gate checks every call the model
29
+ // makes (act) against the session's rules, then the mode, and asks the operator
30
+ // when the mode says so ([y] once / [s] session / [n] no). The shared memory's
31
+ // tools are Orkeon Code's own (memory-tools.ts): memory_recall in every mode,
32
+ // memory_push (a candidate file, never an entry) where the mode edits.
33
+
34
+ import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infrastructure/globals.ts";
35
+ import {
36
+ orkeonAgent,
37
+ orkeonClock,
38
+ orkeonCompactionDeps,
39
+ orkeonConfigStore,
40
+ orkeonFiles,
41
+ orkeonHostContext,
42
+ orkeonMemoryStore,
43
+ orkeonMemoryToolPorts,
44
+ orkeonDecisionModel,
45
+ orkeonProgress,
46
+ orkeonSessionIo,
47
+ orkeonShell,
48
+ orkeonTelemetry,
49
+ orkeonToolCalls,
50
+ } from "../../shared/infrastructure/orkeon/wiring.ts";
51
+ import { memoryTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
52
+ import { agentLlm } from "../../shared/infrastructure/orkeon/llm.ts";
53
+ import { memoryGuardCallbacks } from "../../shared/application/dev/tool-callbacks.ts";
54
+ import { createToolTrace, tracedCallbacks } from "../../shared/application/dev/tool-trace-recorder.ts";
55
+ import { memoryDirOf } from "../../shared/application/shared-memory/memory-settings.ts";
56
+ import { createRunState } from "../../shared/infrastructure/orkeon/run-state.ts";
57
+ import { compactSession } from "../../shared/application/compaction/compact-session.ts";
58
+ import { loadCatalogue, runMainLoop } from "./application/run-main-loop.ts";
59
+ import { contextPruning } from "../../shared/application/compaction/prune-context.ts";
60
+ import { suggestSkills } from "../../shared/application/skills/suggest-skills.ts";
61
+ import { CODER_GOAL, CODER_ROLE } from "./application/prompts.ts";
62
+ import { BREAKER_RUN_FIELD, turnCompaction } from "./application/auto-compact.ts";
63
+
64
+ // The tool catalogue is decided at load time (module scope is synchronous), from
65
+ // the inputs alone: see loadCatalogue.
66
+ const loaded = loadCatalogue(inputs());
67
+
68
+ const clock = orkeonClock();
69
+ const progress = orkeonProgress();
70
+ const ports = {
71
+ shell: orkeonShell(), session: orkeonSessionIo(), files: orkeonFiles(), telemetry: orkeonTelemetry(),
72
+ memory: orkeonMemoryStore(), tools: orkeonToolCalls(), config: orkeonConfigStore(),
73
+ };
74
+
75
+ const coder = orkeonAgent()
76
+ .name("coder")
77
+ .role(CODER_ROLE)
78
+ .goal(CODER_GOAL)
79
+ .tools(loaded.catalogue.tools)
80
+ // The shared memory's tools the mode offers (memory_recall always, memory_push where it edits), attached, not named.
81
+ .withAutonomousTools(memoryTools(ToolBuilder, orkeonMemoryToolPorts, loaded.mode, loaded.scriptTools))
82
+ .maxIterations(40)
83
+ .withState(() => ({ permissionMode: loaded.mode, [BREAKER_RUN_FIELD]: 0 }))
84
+ .body(async (_input: any, ctx: any) => {
85
+ // The shared memory's guard on every call: what the host's gate cannot read (an edit_batch's operations, a
86
+ // path in another case, a shell cd into the folder) is refused here (shared-memory/layout memoryWriteRefusal).
87
+ // Each result is recorded on the way (tool-trace-recorder): the turn stores its calls as a [tools] message.
88
+ const trace = createToolTrace();
89
+ const llm = agentLlm(ctx, tracedCallbacks(memoryGuardCallbacks(memoryDirOf(ports.config)), trace));
90
+ const log = ctx.log;
91
+ return await runMainLoop(inputs(), loaded, {
92
+ ...ports,
93
+ llm,
94
+ log,
95
+ trace,
96
+ run: createRunState(ctx),
97
+ clock,
98
+ host: orkeonHostContext,
99
+ suggest: (request, attached) => suggestSkills({ config: ports.config, decision: orkeonDecisionModel(), files: ports.files, session: ports.session, log }, request, attached),
100
+ prune: (request) => contextPruning({ config: ports.config, decision: orkeonDecisionModel(), session: ports.session, log }, request),
101
+ compact: turnCompaction(ports.config, (trigger) => compactSession(
102
+ { force: false, trigger },
103
+ orkeonCompactionDeps({ llm, log }, { ...ports, progress }, clock),
104
+ )),
105
+ });
106
+ })
107
+ .build();
108
+
109
+ // The budget bounds one turn. Its wall time (seconds) is the model's own work: the
110
+ // clock stops while a tool call waits for the operator's answer (Orkeon #127; the
111
+ // engine's ExecutionTimeout pauses the same way). 30 minutes, the example settings'
112
+ // ExecutionTimeout too, bound a long interactive turn. The context tokens count the
113
+ // context once (Orkeon #224): each call charges its completion plus what its prompt grew
114
+ // by, or the part the provider's cache did not serve, never the whole context again, so
115
+ // a turn of n calls on a context of c tokens spends about c plus its completions. 700k is
116
+ // 200 calls of 3 500 (TOKENS_PER_CALL, the growth a tool call adds), the dev steps' rule.
117
+ publishCrew(
118
+ CrewBuilder()
119
+ .name("main-loop")
120
+ .process("autonomous")
121
+ .budget({ toolCalls: 200, wallTime: 1800, contextTokens: 700_000, delegationDepth: 2 })
122
+ .withAgent(coder)
123
+ .build(),
124
+ );
@@ -0,0 +1,27 @@
1
+ // Auto-compaction circuit breaker (F3.5) — pure, no IO. The mutable counter
2
+ // lives in agent state (ctx.state.with is the ONLY mutation path); these
3
+ // helpers hold the testable transition logic. Per the source design, only
4
+ // consecutive FAILURES open the breaker: a compaction resets it (a summary that
5
+ // failed and fell back to the snip still counts as a failure), a skip leaves it unchanged.
6
+ //
7
+ // Run tests: node --test src/crews/main-loop/domain/autocompact.test.ts
8
+
9
+ import { MAX_CONSECUTIVE_FAILURES } from "../../../shared/domain/compaction-thresholds.ts";
10
+ import type { CompactStatus } from "../../../shared/domain/compact-outcome.ts";
11
+
12
+ /** True when auto-compaction must be suppressed (≥ 3 consecutive failures). */
13
+ export function isBreakerOpen(failures: number): boolean {
14
+ return failures >= MAX_CONSECUTIVE_FAILURES;
15
+ }
16
+
17
+ /** Next failure count after an attempt: failed → +1, success → 0, skip → unchanged. */
18
+ export function nextFailureCount(failures: number, status: CompactStatus): number {
19
+ switch (status) {
20
+ case "failed":
21
+ return failures + 1;
22
+ case "compacted":
23
+ return 0;
24
+ default: // "skipped"
25
+ return failures;
26
+ }
27
+ }