orkeon-code 0.0.0-stage → 1.0.0-rc.1

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 (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,255 @@
1
+ // A sub-agent's act run as a background child of the crew (A-3, approach A2 of temp/03 § A). The
2
+ // child is an agent of the crew holding the charter's tools; it acts on the prompt and leaves its
3
+ // reply in the crew's memory under a key the parent chose. Meanwhile the parent body keeps the run's
4
+ // board — the snapshot /tasks reads in the session's state bag — and serves the stop /tasks asks
5
+ // for a running one. An act with `waitFor: "children"` would wait as well, but no script runs
6
+ // during its wait, so nothing could answer /tasks. The runtime's instance rows name the agent by
7
+ // its id, not its name: the child says its instance id (`ctx.instanceId`) under instanceKey first.
8
+
9
+ import type { ActRequest, ChildRuntime, Logger, SessionStore } from "../ports.ts";
10
+ import { INSTANCE_STATES, SNAPSHOT_HEARTBEAT_MS, parseRequest, requestKey, snapshotKey } from "../../domain/agents/instances.ts";
11
+ import type { InstanceRecord, InstanceState, RunSnapshot } from "../../domain/agents/instances.ts";
12
+
13
+ type StateBag = Pick<SessionStore, "readState" | "writeState">;
14
+
15
+ /** How long the parent waits between two looks at its child. */
16
+ export const CHILD_POLL_MS = 1000;
17
+ /** Pauses in a row that return at once before the wait gives up rather than spin. */
18
+ export const MAX_EARLY_WAKES = 3;
19
+
20
+ /** What the child is handed: what it acts on, how, and where it leaves its reply. */
21
+ export interface ChildInput {
22
+ key: string;
23
+ prompt: string;
24
+ request: ActRequest;
25
+ }
26
+
27
+ /** What a child leaves under its key once its act has settled. */
28
+ export type ChildOutcome = { ok: true; reply: string } | { ok: false; error: string };
29
+
30
+ /** The child's input, read back from the string spawnBackground carries; null when it is not one. */
31
+ export function parseChildInput(raw: unknown): ChildInput | null {
32
+ let v: any;
33
+ try {
34
+ v = typeof raw === "string" ? JSON.parse(raw) : raw;
35
+ } catch {
36
+ return null;
37
+ }
38
+ if (v === null || typeof v !== "object" || typeof v.key !== "string" || typeof v.prompt !== "string") return null;
39
+ const request = v.request !== null && typeof v.request === "object" ? (v.request as ActRequest) : {};
40
+ return { key: v.key, prompt: v.prompt, request };
41
+ }
42
+
43
+ /** Where the child leaves its instance id (`a1`…) beside its reply. */
44
+ export const instanceKey = (key: string): string => `${key}:instance`;
45
+
46
+ /** A stored outcome; undefined while the child has left none. */
47
+ export function readChildOutcome(raw: unknown): ChildOutcome | undefined {
48
+ const v = raw as Record<string, unknown> | null | undefined;
49
+ if (v === null || typeof v !== "object") return undefined;
50
+ if (v.ok === true && typeof v.reply === "string") return { ok: true, reply: v.reply };
51
+ if (v.ok === false) return { ok: false, error: typeof v.error === "string" ? v.error : "the child failed" };
52
+ return undefined;
53
+ }
54
+
55
+ const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
56
+
57
+ /** The run's board: its children, the snapshot /tasks reads, and the requests it serves. */
58
+ export interface ChildBoard {
59
+ /** A key no other child of this run uses. */
60
+ nextKey(): string;
61
+ add(record: InstanceRecord): void;
62
+ records(): readonly InstanceRecord[];
63
+ /** Writes the snapshot when it changed; a failed write is logged once and never fails the run. */
64
+ publish(serving: boolean): Promise<void>;
65
+ /** Reads and clears the pending stop of each running child of this run, and stops it. */
66
+ serve(runtime: Pick<ChildRuntime, "stop">): Promise<void>;
67
+ /** Clears what /tasks left for `id`: a request of an earlier run, or one this run no longer serves. */
68
+ clearRequest(id: string): Promise<void>;
69
+ /** The run has ended: the snapshot says so. */
70
+ close(): Promise<void>;
71
+ }
72
+
73
+ export interface BoardDeps {
74
+ state: StateBag;
75
+ clock: () => Date;
76
+ log: Logger;
77
+ }
78
+
79
+ export function createChildBoard(deps: BoardDeps, run: { crew: string; step: string }): ChildBoard {
80
+ const records: InstanceRecord[] = [];
81
+ const startedAt = deps.clock().toISOString();
82
+ let serial = 0;
83
+ let written = "";
84
+ let writtenAt = 0;
85
+ let warned = false;
86
+ let open = true;
87
+ const now = () => deps.clock().toISOString();
88
+
89
+ async function write(serving: boolean): Promise<void> {
90
+ const body: Omit<RunSnapshot, "updatedAt"> = { crew: run.crew, step: run.step, startedAt, serving, open, instances: records };
91
+ const text = JSON.stringify(body);
92
+ const at = deps.clock().getTime();
93
+ // Unchanged, it is written again while the run answers, so /tasks can tell a live run from a dead one.
94
+ if (text === written && !(serving && at - writtenAt >= SNAPSHOT_HEARTBEAT_MS)) return;
95
+ try {
96
+ await deps.state.writeState(snapshotKey(run.crew), JSON.stringify({ ...body, updatedAt: now() }));
97
+ written = text;
98
+ writtenAt = at;
99
+ } catch (error) {
100
+ if (!warned) deps.log.warn(`${run.crew}: the agent instances could not be written for /tasks: ${firstLine(error)}`);
101
+ warned = true;
102
+ }
103
+ }
104
+
105
+ async function clearRequest(id: string): Promise<void> {
106
+ if (id !== "") await deps.state.writeState(requestKey(run.crew, id), "").catch(() => undefined);
107
+ }
108
+
109
+ async function serveOne(runtime: Pick<ChildRuntime, "stop">, record: InstanceRecord): Promise<void> {
110
+ let raw: string | null;
111
+ try {
112
+ raw = await deps.state.readState(requestKey(run.crew, record.id));
113
+ } catch {
114
+ return;
115
+ }
116
+ const request = parseRequest(raw);
117
+ if (request === null) return;
118
+ await clearRequest(record.id);
119
+ // Ids restart at a1 in every run: a stop meant for another run is dropped, never served here.
120
+ if (request.run !== startedAt) return;
121
+ record.stopRequested = runtime.stop(record.id) || undefined;
122
+ deps.log.info(`${run.crew}: /tasks stop ${record.id} (${record.agent})${record.stopRequested ? "" : ": it was no longer running"}`);
123
+ }
124
+
125
+ return {
126
+ nextKey: () => `${run.crew}:child:${++serial}`,
127
+ add: (record) => {
128
+ records.push(record);
129
+ },
130
+ records: () => records,
131
+ publish: write,
132
+ async serve(runtime) {
133
+ for (const record of records) if (record.id !== "" && record.state === "running") await serveOne(runtime, record);
134
+ },
135
+ clearRequest,
136
+ async close() {
137
+ open = false;
138
+ // A run that started no child leaves the last run's snapshot alone: its instances can still be repaired.
139
+ if (records.length > 0) await write(false);
140
+ },
141
+ };
142
+ }
143
+
144
+ export interface ChildCall {
145
+ /** The crew agent the child runs as. */
146
+ agent: string;
147
+ /** The built-in charter it runs (built-in-charters.ts). */
148
+ charter: string;
149
+ /** What it is asked, in a few words, for /tasks. */
150
+ task: string;
151
+ prompt: string;
152
+ request: ActRequest;
153
+ }
154
+
155
+ export interface ChildDeps {
156
+ runtime: ChildRuntime;
157
+ board: ChildBoard;
158
+ clock: () => Date;
159
+ log: Logger;
160
+ }
161
+
162
+ const asState = (s: string): InstanceState =>
163
+ (INSTANCE_STATES as readonly string[]).includes(s) ? (s as InstanceState) : "failed";
164
+
165
+ /**
166
+ * The instance id of the child under `key`: the one it said, else the newest running instance no
167
+ * record of the board holds (the parent starts one child at a time, so that is the one it just
168
+ * started; the rows name the agent by its id, not its name, so they cannot be matched by name).
169
+ */
170
+ async function childInstanceId(runtime: Pick<ChildRuntime, "instances" | "read">, board: ChildBoard, key: string): Promise<string> {
171
+ const said = await runtime.read(instanceKey(key));
172
+ if (typeof said === "string" && said !== "") return said;
173
+ const held = new Set(board.records().map((r) => r.id));
174
+ const fresh = runtime.instances().filter((i) => i.state === "running" && !held.has(i.id));
175
+ return fresh.length > 0 ? fresh[fresh.length - 1].id : "";
176
+ }
177
+
178
+ /**
179
+ * The act of `call` run by a background child; resolves to its reply, throws when it failed or was
180
+ * stopped (the caller's sub-agent run reads that as a failed model call).
181
+ */
182
+ export async function runChildAct(deps: ChildDeps, call: ChildCall): Promise<string> {
183
+ const { runtime, board, clock, log } = deps;
184
+ const key = board.nextKey();
185
+ const input: ChildInput = { key, prompt: call.prompt, request: call.request };
186
+ runtime.spawn(call.agent, JSON.stringify(input));
187
+ const record: InstanceRecord = {
188
+ id: "", agent: call.agent, charter: call.charter, task: call.task,
189
+ state: "running", startedAt: clock().toISOString(), effort: call.request.effort, system: call.request.system ?? "",
190
+ brief: call.prompt,
191
+ };
192
+ const resolveId = async () => {
193
+ if (record.id !== "") return;
194
+ record.id = await childInstanceId(runtime, board, key);
195
+ // A request an earlier run left for this id is not this child's.
196
+ await board.clearRequest(record.id);
197
+ };
198
+ await resolveId();
199
+ board.add(record);
200
+ log.info(`${call.agent} ${record.id || "?"} started in the background: ${call.task}`);
201
+ let early = 0;
202
+ try {
203
+ for (;;) {
204
+ await resolveId();
205
+ const outcome = readChildOutcome(await runtime.read(key));
206
+ const row = runtime.instances().find((i) => i.id === record.id);
207
+ const stopped = row?.state === "stopped" || (record.stopRequested === true && outcome?.ok !== true);
208
+ if (stopped && (outcome !== undefined || (row !== undefined && row.state !== "running"))) {
209
+ // A stopped child's act rejects, and its body leaves that failure: the stop is what happened.
210
+ record.state = "stopped";
211
+ record.error = "stopped by /tasks stop";
212
+ break;
213
+ }
214
+ if (outcome !== undefined) {
215
+ record.state = outcome.ok ? "completed" : "failed";
216
+ if (outcome.ok) record.reply = outcome.reply;
217
+ else record.error = outcome.error;
218
+ break;
219
+ }
220
+ if (row !== undefined && row.state !== "running") {
221
+ record.state = asState(row.state);
222
+ record.error = "the child ended without leaving a reply";
223
+ break;
224
+ }
225
+ await board.serve(runtime);
226
+ await board.publish(true);
227
+ const before = clock().getTime();
228
+ await runtime.pause(CHILD_POLL_MS);
229
+ if (clock().getTime() - before < CHILD_POLL_MS / 4) {
230
+ early += 1;
231
+ if (early >= MAX_EARLY_WAKES) {
232
+ record.state = "failed";
233
+ record.error = `the wait for ${call.agent} returned at once ${early} times in a row`;
234
+ runtime.stop(record.id);
235
+ break;
236
+ }
237
+ } else {
238
+ early = 0;
239
+ }
240
+ }
241
+ } catch (error) {
242
+ // The wait itself failed (the run was cancelled, the host refused a read): the child goes with it.
243
+ record.state = "failed";
244
+ record.error = firstLine(error);
245
+ runtime.stop(record.id);
246
+ throw error;
247
+ } finally {
248
+ record.endedAt = clock().toISOString();
249
+ await board.clearRequest(record.id);
250
+ await board.publish(false);
251
+ }
252
+ log.info(`${call.agent} ${record.id || "?"} ${record.state}${record.error ? `: ${record.error}` : ""}`);
253
+ if (record.state === "completed" && record.reply !== undefined) return record.reply;
254
+ throw new Error(`${call.agent} ${record.id || "?"} ${record.state}: ${record.error ?? "no reply"}`);
255
+ }
@@ -0,0 +1,96 @@
1
+ // runSubAgent: one sub-agent turn under its charter. It acts in the charter's
2
+ // mode with the behaviour specification as the system message, then extracts the
3
+ // final reply into a schema and checks it. An answer that fails is re-asked once
4
+ // over the same reply, with the problems found; no second act is made. A call
5
+ // that throws a cancellation (the host cancelled the run, /tasks stop stopped the
6
+ // child) is `cancelled`; a step budget spent during the extraction is the model's
7
+ // failure, not an answer that did not parse.
8
+
9
+ import type { Llm } from "../ports.ts";
10
+ import { MAX_BRIEF_CHARS, charterProblems } from "../../domain/agents/charter.ts";
11
+ import type { Charter, Checked } from "../../domain/agents/charter.ts";
12
+ import { readBudgetExhausted } from "../../domain/dev/step-budget.ts";
13
+
14
+ export interface SubAgentCall<T> {
15
+ charter: Charter;
16
+ /** The charter's behaviour specification: the act's system message. */
17
+ system: string;
18
+ /** The task and its material: the act's prompt. */
19
+ brief: string;
20
+ /** The tools the act is offered, a subset of the agent's; the agent's whole catalogue when absent. */
21
+ tools?: readonly string[];
22
+ /** The JSON schema the answer is extracted into. */
23
+ schema: object;
24
+ /** The extraction prompt over the act's final reply; `problems` is empty on the first try. */
25
+ answerPrompt: (reply: string, problems: readonly string[]) => string;
26
+ check: (value: unknown) => Checked<T>;
27
+ }
28
+
29
+ export type SubAgentFailure = "invalid-charter" | "brief-too-long" | "model-failed" | "cancelled" | "unparsable";
30
+
31
+ export type SubAgentOutcome<T> =
32
+ | { ok: true; value: T; reply: string; tries: 1 | 2 }
33
+ | { ok: false; reason: SubAgentFailure; problems: string[]; reply: string };
34
+
35
+ function firstLine(error: unknown): string {
36
+ const message = error instanceof Error ? error.message : String(error);
37
+ return message.split("\n")[0];
38
+ }
39
+
40
+ /** The .NET cancellation name, the DOM's abort, the runtime's cancel sentence, and the stop /tasks serves on a child (runChildAct). */
41
+ // Not TaskCanceled: .NET raises it for an HTTP timeout too, which is the model's failure.
42
+ const CANCEL_NAME = /^OperationCanceled(?:Exception)?$|^AbortError$/;
43
+ const CANCEL_MESSAGE = /\b(?:the )?(?:operation|task) was cancell?ed\b|stopped by \/tasks stop/i;
44
+
45
+ /** Why a thrown call failed: a cancellation, else the model's failure. */
46
+ function failureOf(error: unknown): "cancelled" | "model-failed" {
47
+ const name = error instanceof Error ? error.name : "";
48
+ return CANCEL_NAME.test(name) || CANCEL_MESSAGE.test(firstLine(error)) ? "cancelled" : "model-failed";
49
+ }
50
+
51
+ type Answer<T> = Checked<T> | { ok: false; reason: "cancelled" | "model-failed"; problems: string[] };
52
+
53
+ async function tryAnswer<T>(
54
+ llm: Pick<Llm, "extract">, call: SubAgentCall<T>, reply: string, problems: readonly string[],
55
+ ): Promise<Answer<T>> {
56
+ let value: unknown;
57
+ try {
58
+ value = await llm.extract(call.answerPrompt(reply, problems), call.schema);
59
+ } catch (error) {
60
+ const reason = failureOf(error);
61
+ if (reason === "cancelled" || readBudgetExhausted(error) !== null) return { ok: false, reason, problems: [firstLine(error)] };
62
+ return { ok: false, problems: [`the answer did not parse: ${firstLine(error)}`] };
63
+ }
64
+ return call.check(value);
65
+ }
66
+
67
+ export async function runSubAgent<T>(llm: Pick<Llm, "act" | "extract">, call: SubAgentCall<T>): Promise<SubAgentOutcome<T>> {
68
+ const { charter, brief } = call;
69
+ const invalid = charterProblems(charter);
70
+ if (invalid.length > 0) return { ok: false, reason: "invalid-charter", problems: invalid, reply: "" };
71
+ if (brief.length > MAX_BRIEF_CHARS) {
72
+ return {
73
+ ok: false, reason: "brief-too-long", reply: "",
74
+ problems: [`the brief is ${brief.length} characters, over ${MAX_BRIEF_CHARS}`],
75
+ };
76
+ }
77
+ let reply: string;
78
+ try {
79
+ reply = await llm.act(brief, {
80
+ system: call.system,
81
+ permissionMode: charter.mode,
82
+ maxIterations: charter.maxIterations,
83
+ ...(charter.model === undefined ? {} : { model: charter.model }),
84
+ ...(call.tools === undefined ? {} : { tools: [...call.tools] }),
85
+ });
86
+ } catch (error) {
87
+ return { ok: false, reason: failureOf(error), problems: [firstLine(error)], reply: "" };
88
+ }
89
+ const first = await tryAnswer(llm, call, reply, []);
90
+ if (first.ok) return { ok: true, value: first.value, reply, tries: 1 };
91
+ if ("reason" in first) return { ok: false, reason: first.reason, problems: first.problems, reply };
92
+ const second = await tryAnswer(llm, call, reply, first.problems);
93
+ if (second.ok) return { ok: true, value: second.value, reply, tries: 2 };
94
+ if ("reason" in second) return { ok: false, reason: second.reason, problems: second.problems, reply };
95
+ return { ok: false, reason: "unparsable", problems: second.problems, reply };
96
+ }
@@ -0,0 +1,14 @@
1
+ // The language the session answers in (`answer.language`), read through the config port. Shared by the main
2
+ // loop's prompt and the crews a command hands it to (/analyze), so neither depends on the other.
3
+ import type { ConfigStore } from "./config-store.ts";
4
+ import { ANSWER_LANGUAGE_CONFIG_KEY } from "../domain/agent-policy/output-styles.ts";
5
+
6
+ /** The `answer.language` setting; "" when unset, unreadable or without a store. */
7
+ export async function readLanguage(config: Pick<ConfigStore, "readValue"> | undefined): Promise<string> {
8
+ if (config === undefined) return "";
9
+ try {
10
+ return String((await config.readValue(ANSWER_LANGUAGE_CONFIG_KEY)).value ?? "").trim();
11
+ } catch {
12
+ return "";
13
+ }
14
+ }
@@ -0,0 +1,36 @@
1
+ // The /skills registry as the turn prompt and the compaction read it: the paths
2
+ // attached in the session's state bag, each with its file's content.
3
+
4
+ import type { Files, SessionStore } from "./ports.ts";
5
+ import { SKILLS_STATE_KEY } from "../domain/session-keys.ts";
6
+ import { readJsonArray } from "./session-state.ts";
7
+
8
+ export interface AttachedSkill {
9
+ path: string;
10
+ content: string;
11
+ }
12
+
13
+ /**
14
+ * B-13: the attached /skills, WITH their content, in attachment order.
15
+ *
16
+ * The path alone would tell the model a playbook exists without letting it read
17
+ * one — worse than silence. A skill whose file has gone, cannot be read or is blank
18
+ * is dropped: the registry is a session preference, not a guarantee about the
19
+ * filesystem, and neither a turn nor a compaction may fail over it.
20
+ */
21
+ export async function readAttachedSkills(
22
+ session: Pick<SessionStore, "readState">,
23
+ files: Pick<Files, "read">,
24
+ ): Promise<AttachedSkill[]> {
25
+ const paths = (await readJsonArray(session, SKILLS_STATE_KEY))
26
+ .map((p) => String(p ?? ""))
27
+ .filter((p) => p.length > 0);
28
+ const out: AttachedSkill[] = [];
29
+ for (const path of paths) {
30
+ try {
31
+ const content = await files.read(path);
32
+ if (content.trim().length > 0) out.push({ path, content });
33
+ } catch { /* detached-then-deleted → skip */ }
34
+ }
35
+ return out;
36
+ }
@@ -0,0 +1,237 @@
1
+ // The compaction pipeline, called inline by BOTH the session-compact crew
2
+ // (/compact, forced) and the main loop's automatic compaction (above the trigger
3
+ // only) — a plain function call, never a crew launch from a crew. In order: the
4
+ // durable facts go to typed memory first, so nothing worth keeping is lost; the
5
+ // summary is written from the whole buffer as it stands (clipped head and tail by
6
+ // the prompt), then the files the conversation was working on and the attached
7
+ // skills are read back. A request still waiting for its answer (the compaction at the head of a turn) stays last,
8
+ // after all of them, so the answer that follows has its request before it. The deterministic snip (session_snip) is the fallback of a
9
+ // summary that fails, and `/compact --snip`: it keeps the head and the last turns whole (runtimeTurnsToKeep), and
10
+ // either leaves a notice in the buffer saying the earlier turns were removed without a summary.
11
+ //
12
+ // The pipeline runs on the ports of CompactDeps: both entry points wire the Orkeon
13
+ // adapters and the running agent's model, log and clock. Memory extraction and the
14
+ // restoration of files and skills are in ./extract-memories.ts and
15
+ // ./restore-context.ts; the outcome and its line in shared/domain/compact-outcome.ts.
16
+
17
+ import type { Clock, Files, Llm, Logger, MemoryStore, Progress, SessionStore } from "../ports.ts";
18
+ import type { CompactOutcome } from "../../domain/compact-outcome.ts";
19
+ import type { StateWritten } from "../workflow/workflow-state.ts";
20
+ import {
21
+ MIN_COMPACTABLE,
22
+ buildCompactedBuffer,
23
+ buildMemoryRecapMessage,
24
+ buildRestoredStateMessage,
25
+ buildSnipNoticeMessage,
26
+ buildSummaryPrompt,
27
+ buildTranscript,
28
+ extractSummary,
29
+ } from "../../domain/compaction.ts";
30
+ import { COMPACTION_TRIGGER_CONFIG_KEY, SNIP_RETAIN_COUNT, parseTokenCount, shouldCompact } from "../../domain/compaction-thresholds.ts";
31
+ import type { ConfigStore } from "../config-store.ts";
32
+ import { extractMemories } from "./extract-memories.ts";
33
+ import { restoreAttachedSkills, restoreRecentFiles } from "./restore-context.ts";
34
+ import { WORKSPACE } from "../../domain/vfs.ts";
35
+ import { isoDay } from "../../domain/iso-day.ts";
36
+ import { pendingRequestLength } from "../../domain/marked-message.ts";
37
+ import { runtimeTurnsToKeep } from "../../domain/snip-turns.ts";
38
+ import type { SessionMsg } from "../../domain/types.ts";
39
+
40
+ /** The ports the pipeline runs on. */
41
+ export interface CompactDeps {
42
+ progress: Progress;
43
+ session: SessionStore;
44
+ files: Files;
45
+ memory: MemoryStore;
46
+ llm: Llm;
47
+ log: Logger;
48
+ /** Today's date for the memory extraction, so a relative date is saved as an absolute one: the UTC day, as the
49
+ * Environment line of the turn gives it. */
50
+ clock: Clock;
51
+ /** Step 0: writes the state file of the dev batch in progress (null: none is). Absent, no step 0. */
52
+ workflow?: (trigger: "manual" | "auto") => Promise<StateWritten | null>;
53
+ }
54
+
55
+ /**
56
+ * Run the compaction pipeline. `force: true` (the /compact crew) skips the
57
+ * threshold check; `force: false` (main-loop auto-compaction) only acts above the
58
+ * trigger. Past it, every run pays one summary call over the whole buffer.
59
+ * `focus` is what the operator asked the summary to keep above all
60
+ * (`/compact <focus>`). A summary that comes back empty, or a model that fails,
61
+ * fails the compaction (the breaker counts it) rather than replace the history
62
+ * with nothing: the buffer is snipped instead, with a notice, and the outcome says
63
+ * so (`fallback: "snip"`).
64
+ */
65
+ export async function compactSession(
66
+ opts: { force?: boolean; focus?: string; trigger?: number },
67
+ deps: CompactDeps,
68
+ ): Promise<CompactOutcome> {
69
+ const { progress, session, files, memory, llm, log } = deps;
70
+ const force = opts.force === true;
71
+ let state: StateWritten | null = null;
72
+ const withState = (o: CompactOutcome): CompactOutcome =>
73
+ state === null ? o : { ...o, state: "path" in state ? { path: state.path } : { skipped: state.skipped } };
74
+ try {
75
+ // The budget first: under the trigger the automatic run reads no message, so a turn does not pay a read of
76
+ // the whole buffer at its head and its tail.
77
+ const gated = force ? null : await session.readBudget();
78
+ if (gated !== null && !shouldCompact(gated.used, gated.window, opts.trigger))
79
+ return { status: "skipped", reason: "below trigger", usedTokens: gated.used };
80
+ const raw = await session.readMessages();
81
+ // 0. The state of the dev batch in progress goes to its file first, from files and
82
+ // git alone. /compact (force) refreshes it whatever the buffer holds.
83
+ if (force) state = await writeState(deps, "manual");
84
+ if (raw.stored.length <= MIN_COMPACTABLE)
85
+ return withState({ status: "skipped", reason: "buffer too small" });
86
+ const { used } = gated ?? await session.readBudget();
87
+ if (!force) state = await writeState(deps, "auto");
88
+
89
+ // Progress: reported only past the threshold checks (a skipped compaction must
90
+ // not flash a bar), released on EVERY exit below — the fallback included.
91
+ try {
92
+ // 1. Memory extraction BEFORE any loss — best-effort (extract throws on
93
+ // non-JSON replies; compaction must never fail because of it).
94
+ await progress.report(compactPhase(1, "extracting memories"));
95
+ const transcript = buildTranscript(raw.messages);
96
+ const memories = await extractMemories(llm, memory, transcript, isoDay(deps.clock()));
97
+
98
+ // 2. The summary, from the buffer as it stands: the prompt clips the transcript head and tail.
99
+ await progress.report(compactPhase(2, "synthesizing the summary"));
100
+ const summary = await summarise(llm, transcript, opts.focus);
101
+ if ("failure" in summary) return withState(await snipFallback(deps, raw.messages, summary.failure));
102
+ const buffer = buildCompactedBuffer(raw.stored[0], summary.text);
103
+ if (memories.length > 0) buffer.push(buildMemoryRecapMessage(memories));
104
+ // 3. Re-inject the recently-touched files so the agent keeps its working
105
+ // context (paths harvested from the buffer before the compaction).
106
+ await progress.report(compactPhase(3, "restoring recent files"));
107
+ const restored = await restoreRecentFiles(files, raw.messages);
108
+ if (restored.length > 0) {
109
+ buffer.push(...restored);
110
+ note(log, `post-compaction restore: ${restored.length} file(s) re-injected`);
111
+ }
112
+ // 4. Re-inject the ATTACHED SKILLS under their own budget. Files came
113
+ // back because the agent was touching them; skills come back because the
114
+ // operator attached them and expects them to outlive every compaction —
115
+ // which is exactly what "the agent forgot the rules" looks like when they
116
+ // do not.
117
+ await progress.report(compactPhase(4, "restoring attached skills"));
118
+ const skills = await restoreAttachedSkills(session, files);
119
+ if (skills.length > 0) {
120
+ buffer.push(...skills);
121
+ note(log, `post-compaction restore: ${skills.length} skill(s) re-injected`);
122
+ }
123
+ // 5. The pointer to the state file written at step 0, last: what to read first.
124
+ if (state !== null && "path" in state) buffer.push(buildRestoredStateMessage(`${WORKSPACE}/${state.path}`, state.firstOpen));
125
+ // 6. The request still waiting for its answer, with its [turn-context], stays last: the summary records it, and
126
+ // the answer appended next must follow it.
127
+ const pending = pendingRequestLength(raw.messages);
128
+ if (pending > 0) buffer.push(...raw.stored.slice(raw.stored.length - pending));
129
+ await session.writeMessages(buffer);
130
+
131
+ return withState({ status: "compacted", before: raw.stored.length, after: buffer.length, usedTokens: used });
132
+ } finally {
133
+ await progress.done(COMPACT_PROGRESS_LABEL);
134
+ }
135
+ } catch (e: any) {
136
+ return withState({ status: "failed", reason: String(e?.message ?? e) });
137
+ }
138
+ }
139
+
140
+ /** The summary of `transcript`, or why there is none: an empty reply or a model that failed. */
141
+ async function summarise(llm: Llm, transcript: string, focus: string | undefined): Promise<{ text: string } | { failure: string }> {
142
+ try {
143
+ const prompt = buildSummaryPrompt(transcript, focus);
144
+ const reply = await llm.complete(prompt.user, { system: prompt.system });
145
+ const text = extractSummary(String(reply ?? ""));
146
+ return text.length === 0 ? { failure: "the summary came back empty" } : { text };
147
+ } catch (e: any) {
148
+ return { failure: String(e?.message ?? e) };
149
+ }
150
+ }
151
+
152
+ /** No summary: the buffer (`messages`, as just read) is snipped to its last turns with a notice, and the compaction
153
+ * still fails (the breaker counts it). A snip that fails too, or removes nothing (no more turns than it keeps), leaves
154
+ * the failure of the summary as the reason and no fallback; a notice that cannot be written is logged, the fallback
155
+ * kept (the buffer was cut). */
156
+ async function snipFallback(deps: CompactDeps, messages: readonly SessionMsg[], reason: string): Promise<CompactOutcome> {
157
+ const keep = runtimeTurnsToKeep(messages, SNIP_RETAIN_COUNT);
158
+ if (keep === null) return { status: "failed", reason };
159
+ let removed: number;
160
+ try {
161
+ ({ removed } = await deps.session.snip(keep));
162
+ } catch {
163
+ return { status: "failed", reason };
164
+ }
165
+ if (removed === 0) return { status: "failed", reason };
166
+ try {
167
+ await leaveSnipNotice(deps.session);
168
+ } catch (e: any) {
169
+ note(deps.log, `the notice of the snip could not be written: ${String(e?.message ?? e).split("\n")[0]}`);
170
+ }
171
+ note(deps.log, `compaction path: no summary (${reason}), the buffer was snipped`);
172
+ return { status: "failed", reason, fallback: "snip" };
173
+ }
174
+
175
+ /** The notice that the turns a snip removed were not summarised, right after the head: the kept tail opens on a whole
176
+ * turn and the current request stays last. None added when one already sits there (a second snip). */
177
+ async function leaveSnipNotice(session: Pick<SessionStore, "readMessages" | "writeMessages">): Promise<void> {
178
+ const { stored } = await session.readMessages();
179
+ const notice = buildSnipNoticeMessage();
180
+ if (stored.length > 1 && String((stored[1] as { content?: unknown })?.content ?? "") === notice.content) return;
181
+ await session.writeMessages(stored.length === 0 ? [notice] : [stored[0], notice, ...stored.slice(1)]);
182
+ }
183
+
184
+ /** Step 0, best-effort: a state that cannot be written is logged, and the compaction goes on. */
185
+ async function writeState(deps: CompactDeps, trigger: "manual" | "auto"): Promise<StateWritten | null> {
186
+ if (deps.workflow === undefined) return null;
187
+ try {
188
+ const state = await deps.workflow(trigger);
189
+ if (state !== null) {
190
+ note(deps.log, "path" in state ? `state of the batch in progress written to ${state.path}` : `no state file written: ${state.skipped}`);
191
+ }
192
+ return state;
193
+ } catch (e: any) {
194
+ const reason = String(e?.message ?? e).split("\n")[0];
195
+ try { deps.log.warn(`the state of the batch in progress could not be written: ${reason}`); } catch { /* best-effort */ }
196
+ return { skipped: `it could not be written (${reason})` };
197
+ }
198
+ }
199
+
200
+ /** `/compact --snip [N]`: the head and the last N turns kept whole, nothing summarised, a notice saying so. A buffer
201
+ * with no more turns than that is left as it is. */
202
+ export async function snipBuffer(
203
+ turns: number,
204
+ deps: { session: Pick<SessionStore, "snip" | "readMessages" | "writeMessages"> },
205
+ ): Promise<string> {
206
+ const { messages } = await deps.session.readMessages();
207
+ const keep = runtimeTurnsToKeep(messages, turns);
208
+ if (keep === null) return `snipped: 0 removed, ${messages.length} kept.`;
209
+ const { removed, retained } = await deps.session.snip(keep);
210
+ if (removed > 0) await leaveSnipNotice(deps.session);
211
+ return `snipped: ${removed} removed, ${retained} kept.`;
212
+ }
213
+
214
+ /** The `compaction.trigger` setting as a token count; undefined when unset, invalid
215
+ * or unreadable (the computed trigger then applies). */
216
+ export async function readCompactionTrigger(config: Pick<ConfigStore, "readValue">): Promise<number | undefined> {
217
+ try {
218
+ return parseTokenCount((await config.readValue(COMPACTION_TRIGGER_CONFIG_KEY)).value);
219
+ } catch {
220
+ return undefined;
221
+ }
222
+ }
223
+
224
+ /** Status-line headline of the compaction progress. */
225
+ export const COMPACT_PROGRESS_LABEL = "Compacting conversation";
226
+
227
+ /** Total phases of the full pipeline (extract, synthesis, files, skills). */
228
+ const COMPACT_PROGRESS_TOTAL = 4;
229
+
230
+ function compactPhase(step: number, message: string) {
231
+ return { label: COMPACT_PROGRESS_LABEL, step, total: COMPACT_PROGRESS_TOTAL, message };
232
+ }
233
+
234
+ /** Logging is best-effort: a log that fails never fails the compaction. */
235
+ function note(log: Logger, message: string): void {
236
+ try { log.info(message); } catch { /* logging is best-effort */ }
237
+ }