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,41 @@
1
+ // MemoryStore adapter over memory_store, its results read whatever their casing
2
+ // (`entries` or `Entries`, `id` or `Id`, `content` or `Content`...).
3
+
4
+ import type { MemoryStore } from "../../application/ports.ts";
5
+ import type { MemoryStoreInput } from "./runtime-tools.ts";
6
+ import { pick } from "./tool-results.ts";
7
+
8
+ /** A reported number; null and absent both read as unreported. */
9
+ const num = (v: unknown): number | undefined => (v == null ? undefined : Number(v));
10
+ /** A reported string; null and absent both read as unreported. */
11
+ const str = (v: unknown): string | undefined => (v == null ? undefined : String(v));
12
+
13
+ export function createMemoryStore(tools: Pick<OrkeonTools, "memoryStore">): MemoryStore {
14
+ // One shape per operation (runtime-tools.ts): a misspelled operation fails here.
15
+ const memoryStore = (input: MemoryStoreInput) => tools.memoryStore(input);
16
+ return {
17
+ async list(category, options) {
18
+ // newest_first is sent only when asked.
19
+ const order = options?.newestFirst ? { newest_first: true } : {};
20
+ const resp = await memoryStore({ operation: "list", category, ...order });
21
+ const entries: any[] = pick(resp, "entries", "Entries") ?? [];
22
+ return entries.map((e) => ({
23
+ id: num(pick(e, "id", "Id")),
24
+ category: str(pick(e, "category", "Category")),
25
+ content: String(pick(e, "content", "Content") ?? ""),
26
+ }));
27
+ },
28
+ async add(category, content) {
29
+ return String(pick(await memoryStore({ operation: "add", category, content }), "id", "Id"));
30
+ },
31
+ async get(id) {
32
+ return pick(await memoryStore({ operation: "get", id }), "entry", "Entry", "error");
33
+ },
34
+ async remove(id) {
35
+ return Boolean(pick(await memoryStore({ operation: "delete", id }), "success", "Success"));
36
+ },
37
+ async replace(id, content) {
38
+ return Boolean(pick(await memoryStore({ operation: "replace", id, content }), "success", "Success"));
39
+ },
40
+ };
41
+ }
@@ -0,0 +1,129 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // memory_recall and memory_push (temp/05 § 5): the shared memory offered to the model as two of
3
+ // Orkeon Code's own tools, built with scriptTool and attached with `withAutonomousTool`. The recall
4
+ // reads (every mode); the push writes a candidate file, never entries/ (an edit: not offered in
5
+ // plan or dontAsk, asked in default). The gate decides from the declared access; the push also
6
+ // refuses by itself in a read-only mode. Their ports are built when the model calls them, from the
7
+ // wiring: `ctx` is undefined in a tool's execute. Under a batch's working root, the recall's
8
+ // file paths go out on the root (scriptTool's `root`).
9
+
10
+ import { ENTRY_TYPES } from "../../domain/shared-memory/entry.ts";
11
+ import type { EntryType } from "../../domain/shared-memory/entry.ts";
12
+ import { MAX_PRECEDENTS } from "../../domain/shared-memory/precedents-block.ts";
13
+ import { isReadOnly } from "../../domain/agent-policy/permission.ts";
14
+ import type { ConfigStore } from "../../application/config-store.ts";
15
+ import type { Files, SharedMemory, Shell } from "../../application/ports.ts";
16
+ import { readMemorySettings } from "../../application/shared-memory/memory-settings.ts";
17
+ import { recallEntries } from "../../application/shared-memory/recall-precedents.ts";
18
+ import { pushCandidate } from "../../application/shared-memory/push-candidate.ts";
19
+ import { scriptTool } from "./script-tools.ts";
20
+ import type { ScriptToolSpec, ToolBuilderFactory } from "./script-tools.ts";
21
+ import {
22
+ MEMORY_PUSH_DESCRIPTION, MEMORY_RECALL_DESCRIPTION, PUSH_APPLIES_WHEN, PUSH_CORRECTION, PUSH_DETECTION_SIGNAL, PUSH_EVIDENCE,
23
+ PUSH_RATIONALE, PUSH_TITLE, PUSH_TOPIC, QUERY_REQUIRED, RECALL_QUERY, RECALL_TYPES, pushWritesNothing, recallTopK,
24
+ } from "./prompts.ts";
25
+
26
+ export interface MemoryToolPorts {
27
+ files: Pick<Files, "read" | "write" | "list">;
28
+ shell: Pick<Shell, "run">;
29
+ config: Pick<ConfigStore, "readValue">;
30
+ memory: Pick<SharedMemory, "search">;
31
+ clock: () => Date;
32
+ }
33
+
34
+ export const MEMORY_RECALL: ScriptToolSpec = {
35
+ name: "memory_recall",
36
+ description: MEMORY_RECALL_DESCRIPTION,
37
+ schema: {
38
+ type: "object",
39
+ properties: {
40
+ query: { type: "string", description: RECALL_QUERY },
41
+ types: { type: "array", items: { type: "string", enum: [...ENTRY_TYPES] }, description: RECALL_TYPES },
42
+ top_k: { type: "number", description: recallTopK(MAX_PRECEDENTS) },
43
+ },
44
+ required: ["query"],
45
+ },
46
+ };
47
+
48
+ export const MEMORY_PUSH: ScriptToolSpec = {
49
+ name: "memory_push",
50
+ description: MEMORY_PUSH_DESCRIPTION,
51
+ schema: {
52
+ type: "object",
53
+ properties: {
54
+ type: { type: "string", enum: [...ENTRY_TYPES] },
55
+ title: { type: "string", description: PUSH_TITLE },
56
+ topic: { type: "string", description: PUSH_TOPIC },
57
+ applies_when: { type: "string", description: PUSH_APPLIES_WHEN },
58
+ rationale: { type: "string", description: PUSH_RATIONALE },
59
+ correction: { type: "string", description: PUSH_CORRECTION },
60
+ detection_signal: { type: "string", description: PUSH_DETECTION_SIGNAL },
61
+ evidence: { type: "array", items: { type: "string" }, description: PUSH_EVIDENCE },
62
+ tags: { type: "array", items: { type: "string" } },
63
+ },
64
+ required: ["type", "title", "topic", "applies_when", "rationale", "evidence"],
65
+ },
66
+ };
67
+
68
+ const typesOf = (value: unknown): EntryType[] =>
69
+ Array.isArray(value) ? value.filter((t): t is EntryType => (ENTRY_TYPES as readonly unknown[]).includes(t)) : [];
70
+
71
+ export function memoryRecallTool(builder: ToolBuilderFactory, ports: () => MemoryToolPorts, root?: string): Tool<unknown, unknown> {
72
+ return scriptTool(builder, MEMORY_RECALL, async (input) => {
73
+ const raw = (input !== null && typeof input === "object" ? input : {}) as Record<string, unknown>;
74
+ const query = typeof raw.query === "string" ? raw.query.trim() : "";
75
+ if (query === "") return { ok: false, refused: QUERY_REQUIRED };
76
+ const p = ports();
77
+ const settings = await readMemorySettings(p);
78
+ const max = typeof raw.top_k === "number" && Number.isFinite(raw.top_k) ? raw.top_k : MAX_PRECEDENTS;
79
+ const recall = await recallEntries(p, { memory: settings, query, types: typesOf(raw.types), max });
80
+ return {
81
+ entries: recall.precedents.map(({ entry: e, path, score }) => ({
82
+ id: e.id, type: e.type, project: e.project, date: e.date, status: e.status, title: e.title,
83
+ applies_when: e.appliesWhen, rationale: e.rationale,
84
+ ...(e.correction === undefined ? {} : { correction: e.correction }),
85
+ ...(e.detectionSignal === undefined ? {} : { detection_signal: e.detectionSignal }),
86
+ path, score,
87
+ })),
88
+ truncated: recall.truncated,
89
+ };
90
+ }, root);
91
+ }
92
+
93
+ export function memoryPushTool(builder: ToolBuilderFactory, ports: () => MemoryToolPorts, mode: string): Tool<unknown, unknown> {
94
+ return scriptTool(builder, MEMORY_PUSH, async (input) => {
95
+ if (isReadOnly(mode)) return { ok: false, refused: pushWritesNothing(mode) };
96
+ const p = ports();
97
+ const settings = await readMemorySettings(p);
98
+ const pushed = await pushCandidate(p, settings, input);
99
+ return pushed.ok
100
+ ? { candidate_path: pushed.path, id: pushed.id, status: "candidate", ...(pushed.warnings.length > 0 ? { warnings: pushed.warnings } : {}) }
101
+ : { refused: pushed.refused };
102
+ });
103
+ }
104
+
105
+ /** The memory tools among `names` (what scriptToolsFor offered the mode), built; any other name is left out. */
106
+ export function memoryTools(
107
+ builder: ToolBuilderFactory, ports: () => MemoryToolPorts, mode: string, names: readonly string[],
108
+ ): Array<Tool<unknown, unknown>> {
109
+ return names.flatMap((name) => name === MEMORY_RECALL.name ? [memoryRecallTool(builder, ports)]
110
+ : name === MEMORY_PUSH.name ? [memoryPushTool(builder, ports, mode)] : []);
111
+ }
112
+
113
+ /** A dev crew attaches memory_recall unless its command said a session rule denies every call of it
114
+ * (`memoryRecall: false` in the input): the gate would refuse each call the agent tried. */
115
+ export function memoryRecallOn(input: unknown): boolean {
116
+ return !(input !== null && typeof input === "object" && (input as { memoryRecall?: unknown }).memoryRecall === false);
117
+ }
118
+
119
+ /** memory_recall for a dev agent's `withAutonomousTools`, none when it is off. */
120
+ export function memoryRecallTools(
121
+ builder: ToolBuilderFactory, ports: () => MemoryToolPorts, on: boolean, root?: string,
122
+ ): Array<Tool<unknown, unknown>> {
123
+ return on ? [memoryRecallTool(builder, ports, root)] : [];
124
+ }
125
+
126
+ /** The read tools a dev agent's callbacks let through on a host without a gate: memory_recall when it is on. */
127
+ export function memoryReadTools(on: boolean): string[] {
128
+ return on ? [MEMORY_RECALL.name] : [];
129
+ }
@@ -0,0 +1,15 @@
1
+ // The text the Orkeon adapters show the user: the errors they throw.
2
+
3
+ export const notOneOfOurTools = (name: string): string => `'${name}' is not one of Orkeon Code's tools (SCRIPT_TOOLS)`;
4
+ export const CHILD_INPUT_NOT_A_CALL = "child agent: its input is not a child call";
5
+ export const GITHUB_FAILED_WITHOUT_REASON = "the github tool reported a failure without a reason";
6
+ export const GITHUB_SUCCESS_WITHOUT_PULL_REQUEST = "the github tool answered success without the pull request";
7
+ export const noLlmNamespace = (name: string): string =>
8
+ `llm.profile '${name}': this host declares no llm namespace, no profile can be applied`;
9
+ export const sessionStoreRefusedAppend = (role: string): string => `session_store refused to append a '${role}' message`;
10
+ export const SHELL_JOB_NEEDS_COMMAND = "a shell job needs a command";
11
+ export const noJobIdFor = (command: string): string => `start_job answered no job id for: ${command}`;
12
+ export const waitNotWholeSeconds = (seconds: number): string => `a wait is a whole number of seconds, at least 1: ${seconds}`;
13
+ export const timeoutNotWholeSeconds = (timeout: number): string =>
14
+ `a shell timeout is a whole number of seconds, at least 1: ${timeout}`;
15
+ export const noRegisteredTool = (name: string): string => `no registered tool '${name}'`;
@@ -0,0 +1,42 @@
1
+ // PermissionRules adapter over orkeon-repl's `permissions` service
2
+ // (PermissionRulesFacade). Like the script-host, the service is reached through
3
+ // the command context the runtime hands each command (`ctx.services`), so the
4
+ // adapter takes the context's service locator as a parameter rather than being
5
+ // bound in wiring.ts.
6
+
7
+ import type { PermissionRules } from "../../application/ports.ts";
8
+ import type { PermissionRulesFacade, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
9
+
10
+ /** The service name; orkeon-repl registers it, a host that keeps no rules does not. */
11
+ const PERMISSIONS = "permissions";
12
+
13
+ export function createPermissionRules(services: Pick<ServiceLocator, "get" | "has">): PermissionRules {
14
+ const facade = () => services.get<PermissionRulesFacade>(PERMISSIONS);
15
+ return {
16
+ available() {
17
+ return services.has(PERMISSIONS);
18
+ },
19
+ enabled() {
20
+ return services.has(PERMISSIONS) ? facade().enabled : undefined;
21
+ },
22
+ add(rule) {
23
+ const rules = facade();
24
+ // A rule over every call passes the tool alone: the facade reads an absent
25
+ // argument as "every call".
26
+ if (rule.argument === undefined) {
27
+ if (rule.effect === "allow") rules.allow(rule.tool);
28
+ else rules.deny(rule.tool);
29
+ } else if (rule.effect === "allow") {
30
+ rules.allow(rule.tool, rule.argument, rule.pattern);
31
+ } else {
32
+ rules.deny(rule.tool, rule.argument, rule.pattern);
33
+ }
34
+ },
35
+ clear() {
36
+ facade().clear();
37
+ },
38
+ list() {
39
+ return [...facade().list()].map(String);
40
+ },
41
+ };
42
+ }
@@ -0,0 +1,24 @@
1
+ // Progress adapter: the host progress channel (the `progress_report` tool →
2
+ // ProgressBroker → TUI status-line bar; also stamped on the owning command
3
+ // instance for ps/inspect and the agents pane).
4
+ //
5
+ // Best-effort BY CONTRACT: progress is decoration, and no long operation may
6
+ // fail because the host it runs on (an older orkeon-repl, a bare test harness)
7
+ // does not expose the tool. Every call degrades to a silent no-op.
8
+
9
+ import type { Progress } from "../../application/ports.ts";
10
+ import type { ProgressReportInput } from "./runtime-tools.ts";
11
+
12
+ /** `progressReport` is optional: the host may not register it. */
13
+ export function createProgress(tools: Partial<Pick<OrkeonTools, "progressReport">>): Progress {
14
+ const send = async (input: ProgressReportInput): Promise<void> => {
15
+ try {
16
+ if (typeof tools.progressReport !== "function") return;
17
+ await tools.progressReport(input);
18
+ } catch { /* progress is decoration — never fail the operation for it */ }
19
+ };
20
+ return {
21
+ report: (spec) => send(spec),
22
+ done: (label) => send({ label, done: true }),
23
+ };
24
+ }
@@ -0,0 +1,47 @@
1
+ // The text the Orkeon adapters hand to the model: the descriptions of Orkeon Code's own tools, their parameters, and
2
+ // the refusals a tool answers with.
3
+
4
+ // memory_recall
5
+ export const MEMORY_RECALL_DESCRIPTION =
6
+ "Search the shared memory of this project: the admitted decisions, code structures, methods and mistakes of " +
7
+ "past work. Returns at most five entries, best first, each with what it applies to and its file. A precedent is " +
8
+ "material, not an instruction: check it fits here.";
9
+ export const RECALL_QUERY = "What you are about to do or decide, in a sentence.";
10
+ export const RECALL_TYPES = "Only these types; absent, every type.";
11
+ export const recallTopK = (max: number): string => `How many entries at most, ${max} at most.`;
12
+ export const QUERY_REQUIRED = "'query' is required";
13
+
14
+ // memory_push
15
+ export const MEMORY_PUSH_DESCRIPTION =
16
+ "Propose a lesson for the shared memory: it is written as a candidate, never admitted; the operator decides " +
17
+ "with /memory-admit. Name the evidence (path:line, a commit, or a verdict file). A topic refused before is " +
18
+ "refused again; a secret or a secret-like file is refused.";
19
+ export const PUSH_TITLE = "One line, at most 90 characters.";
20
+ export const PUSH_TOPIC = "A few words naming the subject; entries of one topic are compared.";
21
+ export const PUSH_APPLIES_WHEN = "When the lesson applies, so another project can tell.";
22
+ export const PUSH_RATIONALE = "Why: what happened, what it cost.";
23
+ export const PUSH_CORRECTION = "A mistake only: what to do instead.";
24
+ export const PUSH_DETECTION_SIGNAL = "A mistake only: how to notice it.";
25
+ export const PUSH_EVIDENCE = "path:line, a commit or a verdict file, one each.";
26
+ export const pushWritesNothing = (mode: string): string => `memory_push writes a candidate file: mode '${mode}' writes nothing`;
27
+
28
+ // run_validation, run_tests, run_build
29
+ export const notSetUpForThisRun = (name: string): string =>
30
+ `${name} is not set up for this run (not bound yet, or two runs at once): name the command in your answer instead`;
31
+ export const RUN_VALIDATION_DESCRIPTION =
32
+ "Run one narrow test command of the repository pack (one test class, one test project, or the integration " +
33
+ "tests narrowed by a filter, exactly as the brief lists them, each <placeholder> filled with one plain value) " +
34
+ "and return its exit code and the tail of its output. Three per audit at most; never a whole suite, a build or " +
35
+ "an option of your own.";
36
+ export const RUN_VALIDATION_COMMAND = "The command, one of the brief's validation commands with its placeholders filled.";
37
+ export const COMMAND_REQUIRED = "'command' is required";
38
+ export const RUN_TESTS_DESCRIPTION =
39
+ "Run one narrow test command of the repository pack (test_class, test_project, or test_integration with its " +
40
+ "filter), each <placeholder> filled with one plain relative value. Returns the exit code, the tail of the output " +
41
+ "and the path of the whole log. Never a whole suite, never a restore.";
42
+ export const RUN_TESTS_COMMAND = "The pack's test command with its placeholders filled.";
43
+ export const RUN_BUILD_DESCRIPTION =
44
+ "Build with the repository pack's command: without project, commands.build; with project, commands.build_test " +
45
+ "for that test project. Never restores, except once on a tree that was never restored. Returns the exit code, " +
46
+ "whether it restored, the tail of the output and the path of the whole log.";
47
+ export const RUN_BUILD_PROJECT = "The test project to build, a plain relative path; absent, the whole build.";
@@ -0,0 +1,40 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // ReasoningReader over the runtime's `llm` namespace (Orkeon #359, #360, #364): the configuration the session's
3
+ // turns run on (`llm.profile(name)`, else `llm.model(name)`, else `llm.default_`), its `capabilities`, and its
4
+ // `reasoning`, with the effort asked or as the host configures it. The runtime judges, as it judges the call;
5
+ // nothing is called. A profile is asked for only when `llm.profiles` lists its name: one the host does not declare
6
+ // answers null, as do a host without the namespace and a provider that cannot tell.
7
+
8
+ import type { ReasoningReader } from "../../application/ports.ts";
9
+ import { capabilitiesOf, effortReportOf } from "../../domain/agent-policy/reasoning.ts";
10
+ import type { ReasoningTarget } from "../../domain/agent-policy/reasoning.ts";
11
+
12
+ /** What the reader needs of the `llm` namespace. */
13
+ export type LlmConfigs = Pick<typeof llm, "default_" | "model" | "profile" | "profiles">;
14
+
15
+ /** Whether the host declares the profile `name`, compared as `llm.profile` compares: trimmed, without case. */
16
+ function declares(host: LlmConfigs, name: string): boolean {
17
+ const wanted = name.trim().toLowerCase();
18
+ return host.profiles.some((declared) => declared.toLowerCase() === wanted);
19
+ }
20
+
21
+ function configOf(host: LlmConfigs, target: ReasoningTarget): LlmConfig | null {
22
+ if (target.profile !== null) return declares(host, target.profile) ? host.profile(target.profile) : null;
23
+ return target.model === "" ? host.default_ : host.model(target.model);
24
+ }
25
+
26
+ export function createReasoningReader(host: LlmConfigs | undefined): ReasoningReader {
27
+ const read = <T>(target: ReasoningTarget, of: (config: LlmConfig) => T | null): T | null => {
28
+ if (host === undefined) return null;
29
+ try {
30
+ const config = configOf(host, target);
31
+ return config === null ? null : of(config);
32
+ } catch {
33
+ return null;
34
+ }
35
+ };
36
+ return {
37
+ capabilities: (target) => read(target, (config) => capabilitiesOf(config.capabilities)),
38
+ effort: (target, level) => read(target, (config) => effortReportOf((level === null ? config : config.with({ effort: level })).reasoning)),
39
+ };
40
+ }
@@ -0,0 +1,17 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // RunState adapter over the running agent's state (`ctx.state`). The state is
3
+ // read from the context at every call, never kept, so a read sees the last
4
+ // mutation. `ctx.state.with` is the runtime's only mutation path (a direct
5
+ // assignment throws), and it replaces the whole state, so a write carries the
6
+ // other fields over.
7
+
8
+ import type { RunState } from "../../application/ports.ts";
9
+
10
+ export function createRunState(ctx: Pick<AgentContext<Record<string, unknown>>, "state">): RunState {
11
+ return {
12
+ read: (field) => (ctx.state as Record<string, unknown> | undefined)?.[field],
13
+ async write(field, value) {
14
+ await ctx.state.with((s) => ({ ...s, [field]: value }));
15
+ },
16
+ };
17
+ }
@@ -0,0 +1,30 @@
1
+ // RuntimeInfoReader adapter over the command context's `runtime` service (Orkeon #225): the
2
+ // release with its build metadata removed, the commit that metadata carried, the install channel.
3
+ // Like the provider's name, it is reached through the service locator each command receives,
4
+ // so the adapter takes it as a parameter. Jint keeps the CLR member names on a host object, so
5
+ // both casings are read.
6
+
7
+ import type { RuntimeInfo, RuntimeInfoReader } from "../../application/ports.ts";
8
+ import type { RuntimeInfo as HostRuntimeInfo, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
9
+ import { pick } from "./tool-results.ts";
10
+
11
+ /** The service name; always registered by orkeon-repl, a bare host answers its entry assembly. */
12
+ const RUNTIME = "runtime";
13
+
14
+ export function createRuntimeInfo(services: Pick<ServiceLocator, "get" | "has">): RuntimeInfoReader {
15
+ return {
16
+ read(): RuntimeInfo | undefined {
17
+ try {
18
+ if (!services.has(RUNTIME)) return undefined;
19
+ const info = services.get<HostRuntimeInfo>(RUNTIME);
20
+ const version = String(pick(info, "version", "Version") ?? "").trim();
21
+ if (version.length === 0) return undefined;
22
+ const commit = pick(info, "commit", "Commit");
23
+ const channel = String(pick(info, "channel", "Channel") ?? "").trim();
24
+ return { version, commit: commit == null ? null : String(commit), channel: channel || "unknown" };
25
+ } catch {
26
+ return undefined;
27
+ }
28
+ },
29
+ };
30
+ }
@@ -0,0 +1,60 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // The runtime's `tools` global as this code calls it.
3
+ //
4
+ // Every built-in tool is declared by the generated typings (crews/.orkeon/orkeon.d.ts,
5
+ // `OrkeonBuiltInTools`, which `OrkeonTools` extends — Orkeon #125): the input the tool
6
+ // deserializes and the result it hands back, in the tool's own snake_case. The adapters
7
+ // of this folder take `Pick<OrkeonTools, ...>`. This file keeps only the shapes this
8
+ // code passes that are STRICTER than the generated input: one union member per
9
+ // operation where the tool declares a bare `operation?: string`, so a misspelled
10
+ // operation fails at the call. Each shape is declared through `Fits`, which refuses
11
+ // it at `tsc` when a key is not one the tool declares (renamed on the .NET side) or a
12
+ // type does not fit; an operation VALUE is not checked (the tool declares none).
13
+ // Results are still read through tool-results.ts: see there for the casing.
14
+
15
+ /** The input the generated typings declare for a built-in tool. */
16
+ type Input<K extends keyof OrkeonBuiltInTools> = NonNullable<Parameters<OrkeonBuiltInTools[K]>[0]>;
17
+
18
+ /** The keys of every member of a union, not only the common ones. */
19
+ type Keys<T> = T extends unknown ? keyof T : never;
20
+
21
+ /** The generated input of `K`, where a key `T` names that the tool does not declare takes `never`. */
22
+ type Exact<K extends keyof OrkeonBuiltInTools, T> =
23
+ Input<K> & { [P in Exclude<Keys<T>, keyof Input<K>>]: never };
24
+
25
+ /** A local shape of the input of tool `K`, refused at its declaration when it stops fitting the generated one. */
26
+ type Fits<T extends Exact<K, T>, K extends keyof OrkeonBuiltInTools> = T;
27
+
28
+ /** session_store, one input shape per operation this code sends. */
29
+ export type SessionStoreInput = Fits<
30
+ | { operation: "read_messages" | "get_metadata" | "reset" }
31
+ | { operation: "write_messages"; messages: readonly unknown[] }
32
+ | { operation: "append_message"; role: string; content: string }
33
+ | { operation: "get_state"; key: string }
34
+ | { operation: "get_state"; keys: readonly string[] }
35
+ | { operation: "set_state"; key: string; value: string | null }
36
+ | { operation: "set_title"; title: string },
37
+ "sessionStore"
38
+ >;
39
+
40
+ /** memory_store, one input shape per operation this code sends. */
41
+ export type MemoryStoreInput = Fits<
42
+ | { operation: "list"; category?: string; newest_first?: boolean }
43
+ | { operation: "add"; category: string; content: string }
44
+ | { operation: "get" | "delete"; id: number }
45
+ | { operation: "replace"; id: number; content: string },
46
+ "memoryStore"
47
+ >;
48
+
49
+ /** progress_report: a progress line, or the release of its slot (`done`). */
50
+ export type ProgressReportInput = Fits<{
51
+ label: string;
52
+ step?: number;
53
+ total?: number;
54
+ percent?: number;
55
+ message?: string;
56
+ done?: boolean;
57
+ }, "progressReport">;
58
+
59
+ /** batch_anchors, the closure of a set of anchors by FQN. */
60
+ export type BatchAnchorsClosureInput = Fits<{ action: "closure"; fqns: readonly string[] }, "batchAnchors">;
@@ -0,0 +1,129 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // The tools Orkeon Code defines itself, built with the runtime's toolBuilder and attached to an
3
+ // agent with `withAutonomousTool` (never named in `.tools([...])`): run_validation for the auditor,
4
+ // run_tests and run_build for a writing role. The host gate is asked once per model call, from the
5
+ // access each declares (permission.ts SCRIPT_TOOLS: undeclared would be a write); the shell
6
+ // commands the body runs are not asked again, so each body runs the guard chain first
7
+ // (application/dev/wrapped-tools.ts, dev-verify's audit.ts). A body never throws to the model:
8
+ // a throw comes back as `{ok: false, refused}`, the tool's result.
9
+ //
10
+ // A crew builds its tools before its agent's body runs, and the body is where the pack and the
11
+ // step's rules are known: each tool reads what it calls from a slot the body fills (bind), and
12
+ // refuses while the slot is empty. A slot belongs to the crew script that built it; the body releases
13
+ // it when its run ends. Two runs of one crew bound at once would mix their calls, so the slot then
14
+ // refuses until one of them releases it.
15
+ //
16
+ // Given a batch's working root (a parallel /dev-batches), a tool's input comes back from the root to the logical
17
+ // `/workspace` its body names, and its result goes out with each `/workspace` path on the root: the model, held to
18
+ // its root, is never handed a path it may not touch (shared/domain/dev/path-rebase.ts).
19
+
20
+ import { scriptToolAccess } from "../../domain/agent-policy/permission.ts";
21
+ import { mapStrings, textFromRoot, textToRoot } from "../../domain/dev/path-rebase.ts";
22
+ import type { WrappedRun, WrappedTools } from "../../application/dev/wrapped-tools.ts";
23
+ import type { ScriptToolSlot } from "../../application/dev/script-tool-slot.ts";
24
+
25
+ export { scriptToolSlot } from "../../application/dev/script-tool-slot.ts";
26
+ export type { ScriptToolSlot } from "../../application/dev/script-tool-slot.ts";
27
+ import {
28
+ COMMAND_REQUIRED, RUN_BUILD_DESCRIPTION, RUN_BUILD_PROJECT, RUN_TESTS_COMMAND, RUN_TESTS_DESCRIPTION, RUN_VALIDATION_COMMAND,
29
+ RUN_VALIDATION_DESCRIPTION, notSetUpForThisRun,
30
+ } from "./prompts.ts";
31
+ import { notOneOfOurTools } from "./messages.ts";
32
+
33
+ /** The runtime's `toolBuilder`, or a test's. */
34
+ export type ToolBuilderFactory = () => ToolBuilder<unknown, unknown>;
35
+
36
+ export interface ScriptToolSpec {
37
+ /** One of SCRIPT_TOOLS: its access comes from there. */
38
+ name: string;
39
+ description: string;
40
+ schema: JsonSchema;
41
+ }
42
+
43
+ const firstLine = (error: unknown): string => (error instanceof Error ? error.message : String(error)).split("\n")[0];
44
+
45
+ /** The tool `spec` describes, its body `handler`; a throw of the handler is the tool's refusal. Under `root`,
46
+ * the input is read back on `/workspace` and the result's paths go out on the root. */
47
+ export function scriptTool(
48
+ builder: ToolBuilderFactory, spec: ScriptToolSpec, handler: (input: unknown) => Promise<unknown>, root?: string,
49
+ ): Tool<unknown, unknown> {
50
+ const access = scriptToolAccess(spec.name);
51
+ if (access === undefined) throw new Error(notOneOfOurTools(spec.name));
52
+ return builder()
53
+ .name(spec.name)
54
+ .description(spec.description)
55
+ .withSchema(spec.schema)
56
+ .access(access)
57
+ .execute(async (input: unknown) => {
58
+ try {
59
+ const result = await handler(mapStrings(input, (t) => textFromRoot(t, root)));
60
+ return mapStrings(result, (t) => textToRoot(t, root));
61
+ } catch (error) {
62
+ return { ok: false, refused: `${spec.name} failed: ${firstLine(error)}` };
63
+ }
64
+ })
65
+ .build();
66
+ }
67
+
68
+ const notReady = (name: string) => ({
69
+ ok: false, refused: notSetUpForThisRun(name),
70
+ });
71
+
72
+ const commandSchema = (what: string): JsonSchema => ({
73
+ type: "object",
74
+ properties: { command: { type: "string", description: what } },
75
+ required: ["command"],
76
+ });
77
+
78
+ /** What run_validation calls: dev-verify's recording runner (audit.ts), seen by its shape. */
79
+ export interface ValidationCalls {
80
+ run(command: string): Promise<{ report: { command: string; outcome: string; tail: string }; line: string | null }>;
81
+ }
82
+
83
+ export const RUN_VALIDATION: ScriptToolSpec = {
84
+ name: "run_validation",
85
+ description: RUN_VALIDATION_DESCRIPTION,
86
+ schema: commandSchema(RUN_VALIDATION_COMMAND),
87
+ };
88
+
89
+ export function runValidationTool(builder: ToolBuilderFactory, slot: ScriptToolSlot<ValidationCalls>, root?: string): Tool<unknown, unknown> {
90
+ return scriptTool(builder, RUN_VALIDATION, async (input) => {
91
+ const runner = slot.get();
92
+ if (runner === undefined) return notReady(RUN_VALIDATION.name);
93
+ const command = (input as { command?: unknown } | null)?.command;
94
+ if (typeof command !== "string" || command.trim() === "") return { ok: false, refused: COMMAND_REQUIRED };
95
+ const { report, line } = await runner.run(command);
96
+ return { ok: line !== null, command: report.command, outcome: report.outcome, tail: report.tail };
97
+ }, root);
98
+ }
99
+
100
+ export const RUN_TESTS: ScriptToolSpec = {
101
+ name: "run_tests",
102
+ description: RUN_TESTS_DESCRIPTION,
103
+ schema: commandSchema(RUN_TESTS_COMMAND),
104
+ };
105
+
106
+ export const RUN_BUILD: ScriptToolSpec = {
107
+ name: "run_build",
108
+ description: RUN_BUILD_DESCRIPTION,
109
+ schema: {
110
+ type: "object",
111
+ properties: { project: { type: "string", description: RUN_BUILD_PROJECT } },
112
+ },
113
+ };
114
+
115
+ function wrapped(
116
+ builder: ToolBuilderFactory, spec: ScriptToolSpec, slot: ScriptToolSlot<WrappedTools>,
117
+ call: (tools: WrappedTools, input: unknown) => Promise<WrappedRun>, root?: string,
118
+ ): Tool<unknown, unknown> {
119
+ return scriptTool(builder, spec, async (input) => {
120
+ const tools = slot.get();
121
+ return tools === undefined ? notReady(spec.name) : call(tools, input);
122
+ }, root);
123
+ }
124
+
125
+ export const runTestsTool = (builder: ToolBuilderFactory, slot: ScriptToolSlot<WrappedTools>, root?: string): Tool<unknown, unknown> =>
126
+ wrapped(builder, RUN_TESTS, slot, (tools, input) => tools.runTests(input), root);
127
+
128
+ export const runBuildTool = (builder: ToolBuilderFactory, slot: ScriptToolSlot<WrappedTools>, root?: string): Tool<unknown, unknown> =>
129
+ wrapped(builder, RUN_BUILD, slot, (tools, input) => tools.runBuild(input), root);