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,16 @@
1
+ // The mount of the Orkeon VFS the code works in (docs/architecture.md, "The VFS and the host platform"): the
2
+ // project's checkout. Pure.
3
+
4
+ /** The project's checkout: where the file tools name a project file `/workspace/<path>`, where the shell runs, and
5
+ * the root the code index holds every path under. */
6
+ export const WORKSPACE = "/workspace";
7
+
8
+ /** `path` relative to the checkout when it lies under it; any other path as given. */
9
+ export const workspaceRelative = (path: string): string =>
10
+ path.startsWith(`${WORKSPACE}/`) ? path.slice(WORKSPACE.length + 1) : path;
11
+
12
+ /** The mount points the launchers give the REPL, /audio and /transcripts when a speech folder is set: every path
13
+ * of the VFS starts with one of them. */
14
+ export const MOUNT_POINTS: readonly string[] = [
15
+ WORKSPACE, "/output", "/tmp", "/user-config", "/sessions", "/session-history", "/memory", "/audio", "/transcripts",
16
+ ];
@@ -0,0 +1,15 @@
1
+ // The text of the state file a batch in progress leaves before a compaction, read by the model after it.
2
+
3
+ export const stateFileTitle = (phase: string, code: string, at: string, trigger: string): string =>
4
+ `# State of batch ${phase} of ${code} — written at ${at} before a ${trigger} compaction`;
5
+ export const readThisFirst = (sheet: string): string =>
6
+ `> Read this file first after a compaction. The sheet is \`${sheet}\`: resume at its first open step, and`;
7
+ export const TICK_NOTHING_UNOBSERVED = "> tick nothing that was not observed. A report listed below came back already: do not ask for it again.";
8
+ export const REWRITTEN_AT_EVERY_COMPACTION = "> Rewritten at every compaction; Orkeon Code never commits it.";
9
+ export const STEPS_HEADING = "## Steps of the sheet (TDD lines)";
10
+ export const NO_STEP_WITH_TDD = "(the sheet has no step with a TDD line)";
11
+ export const NO_OPEN_STEP = "No open step: every TDD line is ticked.";
12
+ export const eventsHeading = (phase: string, path: string): string => `## Events of ${phase} in \`${path}\``;
13
+ export const earlierLinesLeftOut = (n: number): string => `(${n} earlier line(s) left out)`;
14
+ export const reportsHeading = (phase: string): string => `## Reports recorded for ${phase}`;
15
+ export const WORKING_TREE_HEADING = "## Working tree (`git status --short`)";
@@ -0,0 +1,142 @@
1
+ // The state of a dev batch written before a compaction, `.orkeon/dev/<code>/state-<phase>.md`,
2
+ // and the session's pointer to the batch in progress. Pure, no IO.
3
+ //
4
+ // A compaction may keep the batch sheet in its summary or lose it, and nothing in the
5
+ // summary says which steps were closed or which reports came back. The facts are on
6
+ // disk, so code writes them before the buffer is rewritten: the TDD lines of the sheet
7
+ // and the first open one, the batch's events in Code's own log, the reports recorded,
8
+ // the working tree. The file is rewritten at every compaction; the session's start
9
+ // script names it again at the next start (scripts/session-start.sh reads its
10
+ // `First open:` line and its header's date).
11
+ import type { BatchSheet } from "../dev/plan-format.ts";
12
+ import { isCode } from "../dev/artefacts.ts";
13
+ import { earlierLinesLeftOut, eventsHeading, NO_OPEN_STEP, NO_STEP_WITH_TDD, readThisFirst, reportsHeading, REWRITTEN_AT_EVERY_COMPACTION, stateFileTitle, STEPS_HEADING, TICK_NOTHING_UNOBSERVED, WORKING_TREE_HEADING } from "./prompts.ts";
14
+ import { moreLinesLeftOut } from "../prompts.ts";
15
+
16
+ /** Code's own state folder, in the project. */
17
+ export const DEV_STATE_DIR = ".orkeon/dev";
18
+
19
+ /** The batch a workflow step works on: `code` null when the step did not name it. */
20
+ export interface ActiveWorkflow {
21
+ code: string | null;
22
+ phase: string;
23
+ }
24
+
25
+ const PHASE = /^F\d+$/;
26
+
27
+ /** The pointer as stored (JSON), or null when absent or malformed. */
28
+ export function parseActiveWorkflow(raw: string | null): ActiveWorkflow | null {
29
+ if (raw === null || raw.trim().length === 0) return null;
30
+ let value: unknown;
31
+ try {
32
+ value = JSON.parse(raw);
33
+ } catch {
34
+ return null;
35
+ }
36
+ if (value === null || typeof value !== "object") return null;
37
+ const v = value as { code?: unknown; phase?: unknown };
38
+ if (typeof v.phase !== "string" || !PHASE.test(v.phase)) return null;
39
+ const code = typeof v.code === "string" && isCode(v.code) ? v.code : null;
40
+ return { code, phase: v.phase };
41
+ }
42
+
43
+ export function formatActiveWorkflow(active: ActiveWorkflow): string {
44
+ return JSON.stringify({ code: active.code, phase: active.phase });
45
+ }
46
+
47
+ /** The state file of a batch, relative to the project root. */
48
+ export function stateFilePath(code: string, phase: string): string {
49
+ return `${DEV_STATE_DIR}/${code}/state-${phase}.md`;
50
+ }
51
+
52
+ /** Code's event log of a work code, relative to the project root. */
53
+ export function batchesStatePath(code: string): string {
54
+ return `${DEV_STATE_DIR}/${code}/batches-state.md`;
55
+ }
56
+
57
+ export interface StateStep {
58
+ label: string;
59
+ tdd: string;
60
+ open: boolean;
61
+ }
62
+
63
+ /** A step title, an event line: cut to this many characters, so a sheet cannot flood the prompt. */
64
+ export const MAX_STATE_LINE_CHARS = 160;
65
+ /** At most this many event lines go into the file (the last ones). */
66
+ export const MAX_EVENT_LINES = 40;
67
+
68
+ export function boundLine(line: string): string {
69
+ return line.length <= MAX_STATE_LINE_CHARS ? line : line.slice(0, MAX_STATE_LINE_CHARS - 1) + "…";
70
+ }
71
+
72
+ /** The steps of a sheet that carry a TDD line, in order. */
73
+ export function sheetStateSteps(sheet: BatchSheet): StateStep[] {
74
+ const box = (ticked: boolean): string => (ticked ? "[x]" : "[ ]");
75
+ return sheet.steps
76
+ .filter((s) => s.tdd !== null)
77
+ .map((s) => {
78
+ const t = s.tdd!;
79
+ return {
80
+ label: boundLine(`Step ${s.number} — ${s.title}`),
81
+ tdd: `RED ${box(t.red)} GREEN ${box(t.green)} COST ${box(t.cost)}`,
82
+ open: !(t.red && t.green && t.cost),
83
+ };
84
+ });
85
+ }
86
+
87
+ export function firstOpenStep(steps: readonly StateStep[]): string | null {
88
+ return steps.find((s) => s.open)?.label ?? null;
89
+ }
90
+
91
+ /** At most this many lines of `git status --short` go into the file. */
92
+ export const MAX_TREE_LINES = 40;
93
+
94
+ export interface StateFacts {
95
+ code: string;
96
+ phase: string;
97
+ /** When the file was written (ISO 8601, UTC). */
98
+ at: string;
99
+ trigger: "manual" | "auto";
100
+ /** The sheet, as the work folder shows it ("workbench/demo/DEMO-PLAN-F2.md"). */
101
+ sheet: string;
102
+ steps: StateStep[];
103
+ /** The batch's lines of Code's event log, as written there. */
104
+ events: string[];
105
+ /** The reports recorded for the batch (file names). */
106
+ reports: string[];
107
+ /** `git status --short`, or why there is none. */
108
+ tree: { lines: string[] } | { note: string };
109
+ }
110
+
111
+ /** The file's text. */
112
+ export function renderStateFile(f: StateFacts): string {
113
+ const first = firstOpenStep(f.steps);
114
+ const out: string[] = [
115
+ stateFileTitle(f.phase, f.code, f.at, f.trigger),
116
+ "",
117
+ readThisFirst(f.sheet),
118
+ TICK_NOTHING_UNOBSERVED,
119
+ REWRITTEN_AT_EVERY_COMPACTION,
120
+ "",
121
+ STEPS_HEADING,
122
+ "",
123
+ ];
124
+ if (f.steps.length === 0) out.push(NO_STEP_WITH_TDD);
125
+ for (const s of f.steps) out.push(`- ${s.label}: ${s.tdd}`);
126
+ out.push("", first === null ? NO_OPEN_STEP : `First open: ${first}`, "");
127
+ out.push(eventsHeading(f.phase, batchesStatePath(f.code)), "");
128
+ const events = f.events.slice(-MAX_EVENT_LINES).map(boundLine);
129
+ if (f.events.length > MAX_EVENT_LINES) out.push(earlierLinesLeftOut(f.events.length - MAX_EVENT_LINES));
130
+ out.push(...(events.length === 0 ? ["(none)"] : events), "");
131
+ out.push(reportsHeading(f.phase), "");
132
+ out.push(...(f.reports.length === 0 ? ["(none)"] : f.reports.map((r) => `- ${boundLine(r)}`)), "");
133
+ out.push(WORKING_TREE_HEADING, "");
134
+ if ("note" in f.tree) {
135
+ out.push(`(${f.tree.note})`);
136
+ } else {
137
+ const shown = f.tree.lines.slice(0, MAX_TREE_LINES).map(boundLine);
138
+ out.push("```text", ...(shown.length === 0 ? ["(clean)"] : shown), "```");
139
+ if (f.tree.lines.length > MAX_TREE_LINES) out.push(moreLinesLeftOut(f.tree.lines.length - MAX_TREE_LINES));
140
+ }
141
+ return out.join("\n") + "\n";
142
+ }
@@ -0,0 +1,57 @@
1
+ // Typed bridge to the runtime globals injected by Orkeon.Scripting.Cli /
2
+ // Orkeon.Cli.Scripting (Jint engine). Declared ONCE here and re-exported as
3
+ // typed aliases so the rest of the codebase never writes `(globalThis as any)`.
4
+ // Esbuild bundles every module into a single script for Jint, so these
5
+ // declarations resolve at runtime against the engine's globalThis.
6
+ //
7
+ // This is the ONLY module allowed to reach into the runtime globals — the
8
+ // source-layer analogue of the C# "all IO through IFileSystemService" rule.
9
+ // (Mirrors exp 02 crews/unified/infrastructure/globals.ts.)
10
+ //
11
+ // `Tools` is typed (OrkeonTools plus the local declarations of orkeon/runtime-tools.ts)
12
+ // and read by the adapters of orkeon/ and by entry points only.
13
+
14
+ declare const agentBuilder: () => any;
15
+ declare const crewBuilder: () => any;
16
+ declare const toolBuilder: () => ToolBuilder<unknown, unknown>;
17
+
18
+ /** `tools.<camelCase>(args)` namespace bridging IBaseTool implementations, as the
19
+ * generated typings declare it: every built-in tool typed (Orkeon #125). */
20
+ export const Tools: OrkeonTools = tools;
21
+ /** Domain DSL: build an agent. */
22
+ export const AgentBuilder: () => any = agentBuilder;
23
+ /** Domain DSL: build a crew. */
24
+ export const CrewBuilder: () => any = crewBuilder;
25
+ /** Domain DSL: build a tool Orkeon Code defines (orkeon/script-tools.ts). */
26
+ export const ToolBuilder: () => ToolBuilder<unknown, unknown> = toolBuilder;
27
+
28
+ /** The RAG namespace (`rag.retrieve`, `rag.ingest`), or undefined when the host declares none (it needs
29
+ * AddOrkeonRag): orkeon/shared-memory.ts then calls the rag_search and rag_ingest tools. */
30
+ export const Rag: typeof rag | undefined = typeof rag === "undefined" ? undefined : rag;
31
+
32
+ /** The `llm` namespace (`llm.profile`, `llm.default_`), or undefined where the host declares none:
33
+ * orkeon/llm-profile.ts builds an agent on the profile the crew input names, orkeon/reasoning.ts reads what a
34
+ * model takes for reasoning, for a command as for a crew. */
35
+ export const Llm: typeof llm | undefined = typeof llm === "undefined" ? undefined : llm;
36
+
37
+ /** The class of the runtime's refusals of what a script asked (`llm.profile` naming a profile the host lacks, a
38
+ * builder method refusing its argument; Orkeon #366), or undefined where the host plants none. */
39
+ export const InvalidScript: typeof InvalidScriptError | undefined = typeof InvalidScriptError === "undefined" ? undefined : InvalidScriptError;
40
+
41
+ /** Typed accessor for `globalThis.inputs` (crew/command invocation payload).
42
+ *
43
+ * ⚠️ The implementation binding is deliberately NOT named `inputs`: esbuild
44
+ * bundles to a flat esm script that Jint evaluates in SCRIPT mode, where a
45
+ * top-level `function inputs()` becomes a GLOBAL binding and clobbers the
46
+ * `globalThis.inputs` object the host injects before evaluation (`--inputs`
47
+ * then reads back as the function itself → empty payload). Exporting under
48
+ * the public name keeps every call site unchanged. */
49
+ function readInputs<T = Record<string, any>>(): T {
50
+ return ((globalThis as any).inputs ?? {}) as T;
51
+ }
52
+ export { readInputs as inputs };
53
+
54
+ /** Publish the assembled crew back to the runtime (`globalThis.crew = ...`). */
55
+ export function publishCrew(crew: any): void {
56
+ (globalThis as any).crew = crew;
57
+ }
@@ -0,0 +1,24 @@
1
+ // PendingApprovals adapter over orkeon-repl's `approvals` service (Orkeon #198). Like the
2
+ // permissions service, it is reached through the command context the runtime hands each
3
+ // command (`ctx.services`), so the adapter takes the context's service locator rather than
4
+ // being bound in wiring.ts. A host that does not register the service has no approval to show.
5
+
6
+ import type { PendingApproval, PendingApprovals } from "../../application/ports.ts";
7
+ import type { PendingApprovals as HostApprovals, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
8
+
9
+ /** The service name; orkeon-repl registers it when it watches the tool approvals. */
10
+ const APPROVALS = "approvals";
11
+
12
+ export function createPendingApprovals(services: Pick<ServiceLocator, "get" | "has">): PendingApprovals {
13
+ return {
14
+ list(): PendingApproval[] {
15
+ if (!services.has(APPROVALS)) return [];
16
+ return services.get<HostApprovals>(APPROVALS).list().map((a) => ({
17
+ taskId: a.taskId ?? null,
18
+ command: a.command ?? null,
19
+ tool: String(a.tool),
20
+ input: String(a.input ?? ""),
21
+ }));
22
+ },
23
+ };
24
+ }
@@ -0,0 +1,122 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // The children of a crew run (A-3) over the runtime: `ctx.spawnBackground`, the crew's
3
+ // `instances()`/`stop()`, the crew's memory and `ctx.receive({ timeout })` as the pause (it
4
+ // rejects with a ReceiveTimeoutError when nothing arrives, which is the whole point here). The
5
+ // crew entry builds them from the context its body receives and the crew object it published;
6
+ // withChildAct hands the use cases an Llm whose act runs in such a child, the rest unchanged.
7
+ // A parallel /dev-batches' batch agent uses none of this: its audit acts inline on its own Llm, no child
8
+ // and no board, so /tasks does not list it (dev-batches/crew.ork.ts, L8P-D2).
9
+
10
+ import type { ActRequest, ChildRuntime, Llm, Logger } from "../../application/ports.ts";
11
+ import { createChildBoard, instanceKey, parseChildInput, runChildAct } from "../../application/agents/child-agent.ts";
12
+ import type { BoardDeps, ChildBoard } from "../../application/agents/child-agent.ts";
13
+ import { agentLlm } from "./llm.ts";
14
+ import type { ToolCallbacks } from "../../application/dev/tool-callbacks.ts";
15
+ import { CHILD_INPUT_NOT_A_CALL } from "./messages.ts";
16
+
17
+ type ChildContext = Pick<AgentContext, "spawnBackground" | "memory" | "receive">;
18
+ type ChildCrew = Pick<Crew, "instances" | "stop">;
19
+
20
+ const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
21
+
22
+ /** A rejection of `receive` that is its timeout, the expected end of a pause. */
23
+ function isTimeout(error: unknown): boolean {
24
+ const e = error as { name?: unknown; message?: unknown; code?: unknown } | null;
25
+ return /timeout/i.test(`${e?.name ?? ""} ${e?.code ?? ""} ${e?.message ?? error}`);
26
+ }
27
+
28
+ /** The runtime's children for this run. */
29
+ export function createChildRuntime(ctx: ChildContext, crew: ChildCrew): ChildRuntime {
30
+ return {
31
+ spawn(agent, input) {
32
+ ctx.spawnBackground(agent, input);
33
+ },
34
+ instances: () => [...crew.instances()].map((i) => ({ id: String(i.id), agent: String(i.agent), state: String(i.state) })),
35
+ stop: (id) => id !== "" && crew.stop(id) === true,
36
+ read: (key) => ctx.memory.crew.get(key),
37
+ async pause(ms) {
38
+ try {
39
+ // Nothing sends the parent an event; one that arrives anyway is left unread.
40
+ await ctx.receive({ timeout: ms });
41
+ } catch (error) {
42
+ if (!isTimeout(error)) throw error;
43
+ }
44
+ },
45
+ };
46
+ }
47
+
48
+ /**
49
+ * The body of a child agent: it acts on the call its input carries, under the callbacks of its
50
+ * step, and leaves the outcome in the crew's memory for the parent before it returns. `wrap` dresses the Llm
51
+ * the child acts on: what a request cannot carry from the parent, a callback (the pruning of the act's tool loop).
52
+ */
53
+ export function childAgentBody(
54
+ callbacksFor: (ctx: AgentContext) => ToolCallbacks | undefined,
55
+ wrap: (llm: Llm, ctx: AgentContext) => Llm = (llm) => llm,
56
+ ): (input: unknown, ctx: AgentContext) => Promise<string> {
57
+ return async (input, ctx) => {
58
+ const call = parseChildInput(input);
59
+ if (call === null) throw new Error(CHILD_INPUT_NOT_A_CALL);
60
+ // The parent cannot match the runtime's rows by agent name (they hold the agent's id): say which instance this is.
61
+ if (typeof ctx.instanceId === "string") await ctx.memory.crew.store(instanceKey(call.key), ctx.instanceId).catch(() => undefined);
62
+ try {
63
+ const reply = await wrap(agentLlm(ctx, callbacksFor(ctx)), ctx).act(call.prompt, call.request);
64
+ await ctx.memory.crew.store(call.key, { ok: true, reply });
65
+ return reply;
66
+ } catch (error) {
67
+ await ctx.memory.crew.store(call.key, { ok: false, error: firstLine(error) }).catch(() => undefined);
68
+ throw error;
69
+ }
70
+ };
71
+ }
72
+
73
+ export interface ChildActSpec {
74
+ /** The crew agent the child runs as, added to the crew by `ctx.spawn(builder())` at its first act. */
75
+ agent: string;
76
+ charter: string;
77
+ task: string;
78
+ builder: () => AgentBuilder;
79
+ }
80
+
81
+ /** `base` with its act run by a background child (approach A2). */
82
+ export function withChildAct(
83
+ base: Llm,
84
+ ctx: ChildContext & Pick<AgentContext, "crew" | "spawn">,
85
+ crew: ChildCrew,
86
+ deps: { board: ChildBoard; clock: () => Date; log: Logger; effort?: ActRequest["effort"] },
87
+ spec: ChildActSpec,
88
+ ): Llm {
89
+ const runtime = createChildRuntime(ctx, crew);
90
+ return {
91
+ ...base,
92
+ act(prompt: string, request: ActRequest) {
93
+ if (!ctx.crew.has(spec.agent)) ctx.spawn(spec.builder());
94
+ return runChildAct(
95
+ { runtime, board: deps.board, clock: deps.clock, log: deps.log },
96
+ {
97
+ agent: spec.agent, charter: spec.charter, task: spec.task, prompt,
98
+ // The crew's effort when the request names none, as the Llm adapter fills it for an inline act.
99
+ request: request.effort === undefined && deps.effort !== undefined ? { ...request, effort: deps.effort } : request,
100
+ },
101
+ );
102
+ },
103
+ };
104
+ }
105
+
106
+ /**
107
+ * A step run whose act goes to a background child (A2), from its board to its close: the board
108
+ * /tasks reads under `run.crew`, and withChildAct over it. The caller closes it once the run ended,
109
+ * whatever the outcome (`finally`), so /tasks no longer shows the run as open.
110
+ */
111
+ export function openChildAct(
112
+ base: Llm,
113
+ ctx: ChildContext & Pick<AgentContext, "crew" | "spawn">,
114
+ crew: ChildCrew,
115
+ deps: BoardDeps & { effort?: ActRequest["effort"] },
116
+ run: { crew: string; step: string },
117
+ spec: ChildActSpec,
118
+ ): { llm: Llm; close: () => Promise<void> } {
119
+ const board = createChildBoard({ state: deps.state, clock: deps.clock, log: deps.log }, run);
120
+ const llm = withChildAct(base, ctx, crew, { board, clock: deps.clock, log: deps.log, effort: deps.effort }, spec);
121
+ return { llm, close: () => board.close() };
122
+ }
@@ -0,0 +1,32 @@
1
+ // The Chooser port over the command context's `prompt`: a `select` panel, answered in detail.
2
+ import type { Chooser } from "../../application/ports.ts";
3
+
4
+ /** The part of the command context a choice goes through. */
5
+ export interface PromptConsole {
6
+ readonly interactive: boolean;
7
+ prompt(spec: {
8
+ type: "select";
9
+ message: string;
10
+ choices: readonly { value: string; label?: string; description?: string; current?: boolean }[];
11
+ control?: { label: string; values: readonly string[]; value?: string };
12
+ detailed: true;
13
+ }): Promise<{ readonly value: string; readonly control: string | null } | null>;
14
+ }
15
+
16
+ export function createChooser(console: PromptConsole): Chooser {
17
+ return {
18
+ get interactive() {
19
+ return console.interactive;
20
+ },
21
+ choose: async ({ message, options, control }) => {
22
+ const answer = await console.prompt({
23
+ type: "select",
24
+ message,
25
+ choices: options,
26
+ ...(control ? { control } : {}),
27
+ detailed: true,
28
+ });
29
+ return answer ? { value: answer.value, control: answer.control ?? null } : null;
30
+ },
31
+ };
32
+ }
@@ -0,0 +1,120 @@
1
+ // CodeIndex adapter over index_status, index_codebase, codebase_map,
2
+ // dependency_graph, package_summary, codebase_search, symbol_source and
3
+ // impact_analysis. The payloads are read once, here,
4
+ // through the readers of shared/domain/code-intel-contract.ts, which pin the
5
+ // field names of the live tools. The AnchorIndex adapter over batch_anchors
6
+ // reads its result through tool-results.ts; the CostIndex adapter over
7
+ // index_status, incremental_reindex and access_cost reads the report through
8
+ // shared/domain/dev/access-cost.ts, and asks affected_tests when the host has it.
9
+
10
+ import type { AnchorIndex, CodeIndex, CostIndex } from "../../application/ports.ts";
11
+ import { readAccessCostReport } from "../../domain/dev/access-cost.ts";
12
+ import { INDEXED_LANGUAGES } from "../../domain/index-languages.ts";
13
+ import type { BatchAnchorsClosureInput } from "./runtime-tools.ts";
14
+ import { asArray, pick } from "./tool-results.ts";
15
+ import {
16
+ readGraph, readImpact, readIndexSummary, readMapEntries, readMapSymbolCount, readPackageSummary,
17
+ readSearchHitsWithOrigin, readSymbolLocation,
18
+ } from "../../domain/code-intel-contract.ts";
19
+
20
+ type CodeIndexTools = "indexStatus" | "indexCodebase" | "codebaseMap" | "dependencyGraph" | "packageSummary"
21
+ | "codebaseSearch" | "symbolSource" | "impactAnalysis";
22
+
23
+ /** Lines of source `symbol_source` returns: only the first one is kept, so the payload stays small. */
24
+ const SOURCE_LINES = 20;
25
+
26
+ export function createCodeIndex(tools: Pick<OrkeonTools, CodeIndexTools>): CodeIndex {
27
+ return {
28
+ async rootCount() {
29
+ const status = (await tools.indexStatus({})) as { roots?: unknown } | null | undefined;
30
+ return Array.isArray(status?.roots) ? status.roots.length : 0;
31
+ },
32
+ async index(root, opts) {
33
+ // The languages named: every grammar of the runtime's registry (index-languages.ts); a file the runtime still
34
+ // refuses to read is skipped by the discovery, not fatal (Orkeon #215).
35
+ return readIndexSummary(await tools.indexCodebase({
36
+ root_path: root,
37
+ languages: INDEXED_LANGUAGES,
38
+ ...(opts?.parallel === undefined ? {} : { max_parallelism: opts.parallel }),
39
+ ...(opts?.rebuild === true ? { use_cache: false } : {}),
40
+ }));
41
+ },
42
+ async map(level, withMetrics, maxEntries) {
43
+ const raw = await tools.codebaseMap({
44
+ level,
45
+ ...(withMetrics ? { include_metrics: true } : {}),
46
+ ...(maxEntries === undefined ? {} : { max_entries: maxEntries }),
47
+ });
48
+ return { entries: readMapEntries(raw), symbolCount: readMapSymbolCount(raw) };
49
+ },
50
+ async dependencyGraph(scope, maxNodes) {
51
+ return readGraph(await tools.dependencyGraph({ scope, max_nodes: maxNodes, include_mermaid: false }));
52
+ },
53
+ async packageSummary(fqn) {
54
+ return readPackageSummary(await tools.packageSummary({ fqn }));
55
+ },
56
+ async search(query, topK) {
57
+ // No `mode`: the tool's default is the hybrid search.
58
+ return readSearchHitsWithOrigin(await tools.codebaseSearch({ query, top_k: topK }));
59
+ },
60
+ async symbolSource(fqn) {
61
+ return readSymbolLocation(await tools.symbolSource({ fqn, max_lines: SOURCE_LINES }), fqn);
62
+ },
63
+ async impact(target, maxDepth) {
64
+ return readImpact(await tools.impactAnalysis({ target, direction: "Backward", max_depth: maxDepth }));
65
+ },
66
+ };
67
+ }
68
+
69
+ /** The closure of `fqns` by batch_anchors: its nodes, the anchors it did not find, and whether it was cut. */
70
+ export function createAnchorIndex(tools: Pick<OrkeonTools, "batchAnchors">): AnchorIndex {
71
+ return {
72
+ async closure(fqns) {
73
+ const input: BatchAnchorsClosureInput = { action: "closure", fqns };
74
+ const raw = await tools.batchAnchors(input);
75
+ return {
76
+ nodes: asArray(pick(raw, "nodes", "Nodes")).map(String),
77
+ unresolved: asArray(pick(raw, "unresolved", "Unresolved")).map(String),
78
+ truncated: pick(raw, "truncated", "Truncated") === true,
79
+ };
80
+ },
81
+ };
82
+ }
83
+
84
+ /** The access cost of dev-verify and dev-implement: the indexed roots, the refresh of the changed files, the
85
+ * report; and the tests the graph reaches from them (affected_tests), when the tools hold it. */
86
+ export function createCostIndex(
87
+ tools: Pick<OrkeonTools, "indexStatus" | "incrementalReindex" | "accessCost"> & Partial<Pick<OrkeonTools, "affectedTests">>,
88
+ ): CostIndex {
89
+ return {
90
+ ...(tools.affectedTests === undefined ? {} : {
91
+ async affected(files: readonly string[]) {
92
+ // Called on `tools`, never detached from it.
93
+ const raw = await (tools as Pick<OrkeonTools, "affectedTests">).affectedTests({ changed_files: [...files] });
94
+ const strings = (v: unknown): string[] => asArray(v).map(String).filter((s) => s !== "");
95
+ return {
96
+ all: pick(raw, "all", "All") === true,
97
+ projects: strings(pick(raw, "test_projects", "TestProjects")),
98
+ classes: strings(pick(raw, "test_classes", "TestClasses")),
99
+ unresolved: strings(pick(raw, "unresolved", "Unresolved")),
100
+ };
101
+ },
102
+ }),
103
+ async roots() {
104
+ const status = (await tools.indexStatus({})) as { roots?: unknown } | null | undefined;
105
+ if (!Array.isArray(status?.roots)) return [];
106
+ return status.roots
107
+ .map((r) => (typeof r === "string" ? r : String(pick(r, "virtual_root", "VirtualRoot") ?? "")))
108
+ .filter((r) => r !== "");
109
+ },
110
+ async refresh(root, files) {
111
+ const result = await tools.incrementalReindex({ root_path: root, changed_files: [...files] });
112
+ return asArray(pick(result, "errors", "Errors")).map(String);
113
+ },
114
+ async accessCost(files, receivers) {
115
+ const raw = await tools.accessCost({ changed_files: [...files], ...(receivers === undefined ? {} : { receivers }) });
116
+ const report = pick(raw, "report", "Report");
117
+ return { report: report === undefined || report === null ? null : readAccessCostReport(report), errors: asArray(pick(raw, "errors", "Errors")).map(String) };
118
+ },
119
+ };
120
+ }
@@ -0,0 +1,27 @@
1
+ // CrewHost adapter over the runtime's script-host service. The service is reached
2
+ // through the command context the runtime hands each command (`ctx.services`),
3
+ // not through a global, so the adapter takes the context's service locator as a
4
+ // parameter rather than being bound in wiring.ts. A launch option (`chain: "continue"`,
5
+ // Orkeon #221) is handed to runCrewAsync as it is, and left out when the caller gives none.
6
+
7
+ import type { CrewHost } from "../../application/ports.ts";
8
+ import type { ScriptHostFacade, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
9
+
10
+ /** The service name; the host registers it only when it can run crews. */
11
+ const SCRIPT_HOST = "script-host";
12
+
13
+ export function createCrewHost(services: Pick<ServiceLocator, "get">): CrewHost {
14
+ const host = () => services.get<ScriptHostFacade | null | undefined>(SCRIPT_HOST);
15
+ return {
16
+ listCrews() {
17
+ try {
18
+ return [...(host()?.listCrews?.() ?? [])];
19
+ } catch {
20
+ return [];
21
+ }
22
+ },
23
+ launch(name, input, options) {
24
+ return options === undefined ? host()!.runCrewAsync(name, input) : host()!.runCrewAsync(name, input, options);
25
+ },
26
+ };
27
+ }
@@ -0,0 +1,12 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // CrewMemory adapter over the running agent's crew-scoped memory
3
+ // (`ctx.memory.crew`). Like the state, it belongs to the context each agent body
4
+ // receives, so the entry point builds it (`createCrewMemory(ctx)`).
5
+
6
+ import type { CrewMemory } from "../../application/ports.ts";
7
+
8
+ export function createCrewMemory(ctx: Pick<AgentContext, "memory">): CrewMemory {
9
+ return {
10
+ store: (key, value) => ctx.memory.crew.store(key, value),
11
+ };
12
+ }
@@ -0,0 +1,31 @@
1
+ // DecisionModel adapter over the host's `system_one_decide` tool, which the host registers when its settings
2
+ // configure a decision provider (`Orkeon:Decision:Provider`, or a provider section alone), whichever it is. The
3
+ // tool is in no built-in list, so its member of the `tools` namespace is looked up by name: absent, there is no
4
+ // decision model. It answers `{ success, answers, model, error }`; a refusal of the model makes the call throw (the
5
+ // `tools` namespace throws on a failed tool), and both that and a `success: false` read as no answer.
6
+
7
+ import type { DecisionModel } from "../../application/ports.ts";
8
+ import { parseDecisionAnswers } from "../../domain/decision/questions.ts";
9
+ import { toolMemberName } from "./tool-catalogue.ts";
10
+ import { pick } from "./tool-results.ts";
11
+
12
+ /** The tool the host's decision model is asked through. */
13
+ export const DECIDE_TOOL = "system_one_decide";
14
+
15
+ export function createDecisionModel(tools: object): DecisionModel {
16
+ const member = (): unknown => (tools as Record<string, unknown> | undefined)?.[toolMemberName(DECIDE_TOOL)];
17
+ return {
18
+ available: () => typeof member() === "function",
19
+ ask: async (state, questions) => {
20
+ const decide = member();
21
+ if (typeof decide !== "function") return null;
22
+ try {
23
+ const reply = await (decide as (input: Record<string, unknown>) => unknown)({ state, questions });
24
+ if (pick(reply, "success", "Success") !== true) return null;
25
+ return parseDecisionAnswers(questions, pick(reply, "answers", "Answers"));
26
+ } catch {
27
+ return null;
28
+ }
29
+ },
30
+ };
31
+ }