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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,61 @@
1
+ /// <reference path="../../../crews/.orkeon/orkeon.d.ts" />
2
+ // SharedMemory adapter: the RAG index of the shared memory over the runtime's `rag` namespace
3
+ // (retrieve: the passages without a generated answer, so no model call; ingest with prune), and
4
+ // over the rag_search / rag_ingest tools when the host declares no `rag` namespace. A file the
5
+ // index cut into several passages comes back once, with its best score.
6
+
7
+ import type { SharedHit, SharedIngest, SharedMemory } from "../../application/ports.ts";
8
+ import { asArray, pick } from "./tool-results.ts";
9
+
10
+ /** What this adapter calls of the runtime's `rag` namespace. */
11
+ export interface RagApi {
12
+ retrieve(question: string, options: { collection: string; topN?: number }): Promise<{ citations: readonly unknown[] }>;
13
+ ingest(options: {
14
+ collection: string; sources: readonly string[]; chunkingStrategy?: string; prune?: boolean;
15
+ }): Promise<unknown>;
16
+ }
17
+
18
+ /** The entries are cut on their headings (## Context, ## Content, ## Evidence). */
19
+ export const MEMORY_CHUNKING = "structural";
20
+
21
+ function bestPerSource(citations: readonly unknown[]): SharedHit[] {
22
+ const best = new Map<string, number>();
23
+ for (const c of citations) {
24
+ const sourceId = String(pick(c, "sourceId", "source_id", "SourceId") ?? "");
25
+ const score = Number(pick(c, "score", "Score") ?? 0);
26
+ if (sourceId === "") continue;
27
+ if (!best.has(sourceId) || score > (best.get(sourceId) as number)) best.set(sourceId, score);
28
+ }
29
+ return [...best].map(([sourceId, score]) => ({ sourceId, score })).sort((a, b) => b.score - a.score);
30
+ }
31
+
32
+ const count = (report: unknown, ...names: string[]): number => Number(pick(report, ...names) ?? 0);
33
+
34
+ function ingestOf(report: unknown): SharedIngest {
35
+ return {
36
+ added: count(report, "sourcesAdded", "sources_added", "SourcesAdded"),
37
+ reingested: count(report, "sourcesReingested", "sources_reingested", "SourcesReingested"),
38
+ unchanged: count(report, "sourcesUnchanged", "sources_unchanged", "SourcesUnchanged"),
39
+ pruned: count(report, "sourcesPruned", "sources_pruned", "SourcesPruned"),
40
+ errors: asArray(pick(report, "errors", "Errors")).map(String),
41
+ };
42
+ }
43
+
44
+ export function createSharedMemory(
45
+ rag: RagApi | undefined, tools: Pick<OrkeonTools, "ragSearch" | "ragIngest">,
46
+ ): SharedMemory {
47
+ return {
48
+ async search(collection, query, topN) {
49
+ const citations = rag !== undefined
50
+ ? (await rag.retrieve(query, { collection, topN })).citations
51
+ : asArray(pick(await tools.ragSearch({ collection, question: query, top_k: topN }), "citations", "Citations"));
52
+ return bestPerSource(citations);
53
+ },
54
+ async ingest(collection, sources, options) {
55
+ const report = rag !== undefined
56
+ ? await rag.ingest({ collection, sources, chunkingStrategy: MEMORY_CHUNKING, prune: options.prune })
57
+ : await tools.ragIngest({ collection, sources: [...sources], chunking_strategy: MEMORY_CHUNKING, prune: options.prune });
58
+ return ingestOf(report);
59
+ },
60
+ };
61
+ }
@@ -0,0 +1,75 @@
1
+ // ShellJobs adapter: shell_command's job actions (start_job, job_status, job_tail),
2
+ // pinned to /workspace like the Shell adapter. The runtime's schema asks for
3
+ // `command` on every action: it is always passed (the command itself to start a job,
4
+ // an empty one to read it). A job lives in the running crew's agent run and is
5
+ // stopped when that run ends; a call the runtime refuses throws.
6
+ //
7
+ // The script host has no timer: `wait` runs a small node script that sleeps the
8
+ // given seconds (`.orkeon/dev/bin/wait.mjs`, written at the first wait). Without
9
+ // node or interpreters, that run fails once and every later wait says false at once,
10
+ // so the caller falls back to a blocking run.
11
+ //
12
+ // Given a batch's working root, the jobs run there, as the Shell adapter's commands do.
13
+
14
+ import type { ShellJobs } from "../../application/ports.ts";
15
+ import { textFromRoot, textToRoot } from "../../domain/dev/path-rebase.ts";
16
+ import { pick, shCode } from "./tool-results.ts";
17
+ import { WORKSPACE } from "../../domain/vfs.ts";
18
+
19
+ /** The waiting script, relative to /workspace, and its virtual path. */
20
+ export const WAIT_SCRIPT = ".orkeon/dev/bin/wait.mjs";
21
+ const WAIT_SCRIPT_CONTENT =
22
+ "// Written by Orkeon Code's dev-implement crew: sleeps argv[2] seconds (the script host has no timer).\n" +
23
+ "const seconds = Number(process.argv[2]);\n" +
24
+ "setTimeout(() => {}, Number.isFinite(seconds) && seconds > 0 ? seconds * 1000 : 0);\n";
25
+ /** job_tail's own ceiling. */
26
+ const MAX_TAIL_LINES = 500;
27
+
28
+ export function createShellJobs(tools: Pick<OrkeonTools, "shellCommand" | "fileWrite">, root?: string): ShellJobs {
29
+ const cwd = root ?? WORKSPACE;
30
+ let waiter: "unknown" | "ready" | "absent" = "unknown";
31
+ return {
32
+ async start(command) {
33
+ if (command.trim() === "") throw new Error("a shell job needs a command");
34
+ const r = await tools.shellCommand({ action: "start_job", command: textToRoot(command, root), working_directory: cwd });
35
+ const id = String(pick(r, "job_id", "jobId", "JobId") ?? "");
36
+ if (id === "") throw new Error(`start_job answered no job id for: ${command}`);
37
+ return { id, log: String(pick(r, "output_path", "outputPath", "OutputPath") ?? "") };
38
+ },
39
+ async status(id) {
40
+ const r = await tools.shellCommand({ action: "job_status", command: "", job_id: id, working_directory: cwd });
41
+ const status = String(pick(r, "status", "Status") ?? "");
42
+ return { running: status === "running", exitCode: status === "running" ? -1 : shCode(r) };
43
+ },
44
+ async tail(id, lines) {
45
+ const count = Math.max(1, Math.min(MAX_TAIL_LINES, Math.floor(lines)));
46
+ const r = await tools.shellCommand({
47
+ action: "job_tail", command: "", job_id: id, tail_lines: count, working_directory: cwd,
48
+ });
49
+ return textFromRoot(String(pick(r, "tail", "Tail") ?? ""), root);
50
+ },
51
+ async wait(seconds) {
52
+ if (!(Number.isInteger(seconds) && seconds >= 1)) {
53
+ throw new Error(`a wait is a whole number of seconds, at least 1: ${seconds}`);
54
+ }
55
+ if (waiter === "absent") return false;
56
+ try {
57
+ if (waiter === "unknown") {
58
+ await tools.fileWrite({ path: `${cwd}/${WAIT_SCRIPT}`, content: WAIT_SCRIPT_CONTENT });
59
+ }
60
+ const r = await tools.shellCommand({
61
+ command: `node ${WAIT_SCRIPT} ${seconds}`, working_directory: cwd, timeout_seconds: seconds + 30,
62
+ });
63
+ if (shCode(r) !== 0) {
64
+ waiter = "absent";
65
+ return false;
66
+ }
67
+ waiter = "ready";
68
+ return true;
69
+ } catch {
70
+ waiter = "absent";
71
+ return false;
72
+ }
73
+ },
74
+ };
75
+ }
@@ -0,0 +1,31 @@
1
+ // Shell adapter: shell_command pinned to the /workspace cwd the VFS mounts
2
+ // (SPEC §9.4), its result read once, whatever its casing. A timeout goes to the
3
+ // runtime's own `timeout_seconds`; a result with `completed: false` is read as a
4
+ // command stopped at that timeout (the typings give the field, not its meaning).
5
+ // Given a batch's working root, the command runs there: its `/workspace` paths go
6
+ // onto the root, and the root's paths of its output come back as `/workspace`, so the
7
+ // callers keep naming the checkout `/workspace` (shared/domain/dev/path-rebase.ts).
8
+
9
+ import type { Shell } from "../../application/ports.ts";
10
+ import { textFromRoot, textToRoot } from "../../domain/dev/path-rebase.ts";
11
+ import { pick, shCode, shErr, shOut } from "./tool-results.ts";
12
+ import { WORKSPACE } from "../../domain/vfs.ts";
13
+
14
+ export function createShell(tools: Pick<OrkeonTools, "shellCommand">, root?: string): Shell {
15
+ const cwd = root ?? WORKSPACE;
16
+ return {
17
+ async run(logical, options) {
18
+ const command = textToRoot(logical, root);
19
+ const timeout = options?.timeoutSeconds;
20
+ if (timeout !== undefined && !(Number.isInteger(timeout) && timeout >= 1)) {
21
+ throw new Error(`a shell timeout is a whole number of seconds, at least 1: ${timeout}`);
22
+ }
23
+ const input = timeout === undefined
24
+ ? { command, working_directory: cwd }
25
+ : { command, working_directory: cwd, timeout_seconds: timeout };
26
+ const r = await tools.shellCommand(input);
27
+ const result = { stdout: textFromRoot(shOut(r), root), stderr: textFromRoot(shErr(r), root), exitCode: shCode(r) };
28
+ return pick(r, "completed", "Completed") === false ? { ...result, timedOut: true } : result;
29
+ },
30
+ };
31
+ }
@@ -0,0 +1,63 @@
1
+ // Telemetry adapter over session_store get_metadata, session_cost and
2
+ // session_stats (its prompt, completion, cache read and write and reasoning tokens summed over by_model_tokens; a
3
+ // count a model did not report is absent or null, left out of the sum, never read as 0). The counters come back snake_case (or camelCase) and the
4
+ // metadata PascalCase from the .NET record: this is the one place that reads
5
+ // either casing, and the one place that turns the values into numbers and strings.
6
+
7
+ import type { SessionCost, SessionMetadata, SessionStats, Telemetry } from "../../application/ports.ts";
8
+ import type { SessionStoreInput } from "./runtime-tools.ts";
9
+ import { normalizeModelList } from "../../domain/model-catalog.ts";
10
+ import { asArray, pick } from "./tool-results.ts";
11
+
12
+ /** A reported number; null and absent both read as unreported. */
13
+ const num = (v: unknown): number | undefined => (v == null ? undefined : Number(v));
14
+ /** A reported string; null and absent both read as unreported. */
15
+ const str = (v: unknown): string | undefined => (v == null ? undefined : String(v));
16
+
17
+ function costOf(r: unknown): SessionCost {
18
+ return {
19
+ costUsd: num(pick(r, "total_cost_usd", "totalCostUsd")),
20
+ totalTokens: num(pick(r, "total_tokens", "totalTokens")),
21
+ totalCalls: num(pick(r, "total_calls", "totalCalls")),
22
+ };
23
+ }
24
+
25
+ /** The sum of one count over `by_model_tokens`, undefined when no entry reports it. */
26
+ function modelSum(entries: readonly unknown[], ...names: string[]): number | undefined {
27
+ const counts = entries.map((e) => num(pick(e, ...names))).filter((n): n is number => n !== undefined);
28
+ return counts.length > 0 ? counts.reduce((a, b) => a + b, 0) : undefined;
29
+ }
30
+
31
+ export function createTelemetry(tools: Pick<OrkeonTools, "sessionStore" | "sessionCost" | "sessionStats">): Telemetry {
32
+ return {
33
+ async readMetadata(): Promise<SessionMetadata> {
34
+ const md = pick(await tools.sessionStore({ operation: "get_metadata" } satisfies SessionStoreInput), "metadata", "Metadata");
35
+ return {
36
+ title: str(pick(md, "title", "Title")),
37
+ model: str(pick(md, "model", "Model")),
38
+ messageCount: num(pick(md, "messageCount", "MessageCount", "message_count")),
39
+ estimatedTokens: num(pick(md, "estimatedTokens", "EstimatedTokens")),
40
+ availableModels: normalizeModelList(pick(md, "available_models", "availableModels", "AvailableModels")),
41
+ };
42
+ },
43
+ async readCost(): Promise<SessionCost> {
44
+ return costOf(await tools.sessionCost());
45
+ },
46
+ async readStats(): Promise<SessionStats> {
47
+ const s = await tools.sessionStats();
48
+ // The counts per model (RT-12); an older host reported the cache hits alone, in one figure.
49
+ const byModel = asArray(pick(s, "by_model_tokens", "byModelTokens"));
50
+ return {
51
+ ...costOf(s),
52
+ messageCount: num(pick(s, "message_count", "messageCount")),
53
+ estimatedTokens: num(pick(s, "estimated_tokens", "estimatedTokens")),
54
+ promptTokens: modelSum(byModel, "prompt_tokens", "promptTokens"),
55
+ completionTokens: modelSum(byModel, "completion_tokens", "completionTokens"),
56
+ cacheHitTokens: modelSum(byModel, "cache_read_tokens", "cacheReadTokens")
57
+ ?? num(pick(s, "prompt_cache_hit_tokens", "promptCacheHitTokens", "cache_hit_tokens")),
58
+ cacheWriteTokens: modelSum(byModel, "cache_write_tokens", "cacheWriteTokens"),
59
+ reasoningTokens: modelSum(byModel, "reasoning_tokens", "reasoningTokens"),
60
+ };
61
+ },
62
+ };
63
+ }
@@ -0,0 +1,75 @@
1
+ // ToolCatalogue adapter. The names are the registered ones, read from the host's
2
+ // `tools` service (ctx.services.get("tools"): the registered tools, each with its
3
+ // `Name`), and matched case-insensitively, as Orkeon matches an agent's
4
+ // `.tools([...])`. The calls go through the runtime's `tools` namespace, which
5
+ // exposes each tool as a camelCase member (file_read → tools.fileRead): a member
6
+ // cannot give the registered name back (`get-file-contents`, `get_file_contents`
7
+ // and `getFileContents` are all `getFileContents`). `call` passes a result through
8
+ // raw: /debug-tool-call exists to show it as the tool returned it; `callText`
9
+ // decodes it (tool-results.ts), for the callers that read its text.
10
+
11
+ import type { ToolCatalogue } from "../../application/ports.ts";
12
+ import type { ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
13
+ import { asArray, pick, toolOutcome } from "./tool-results.ts";
14
+
15
+ /** The service that hands out the registered tools. */
16
+ const TOOLS = "tools";
17
+
18
+ /**
19
+ * `file_read` → `fileRead`: the tools namespace exposes camelCase members, built
20
+ * as the runtime builds them (ToolsNamespaceBinding.ToCamelCase): `_` and `-` are
21
+ * dropped and raise the next letter, the first letter is lowered — so an MCP
22
+ * server's `search-issues` is `searchIssues` too.
23
+ */
24
+ export function toolMemberName(name: string): string {
25
+ let member = "";
26
+ let raise = false;
27
+ for (const c of name) {
28
+ if (c === "_" || c === "-") {
29
+ raise = member.length > 0;
30
+ continue;
31
+ }
32
+ member += raise ? c.toUpperCase() : c;
33
+ raise = false;
34
+ }
35
+ return member.charAt(0).toLowerCase() + member.slice(1);
36
+ }
37
+
38
+ /** The names of the tools the service hands out (IBaseTool[], each with its `Name`). */
39
+ function registeredNames(services: Pick<ServiceLocator, "get">): string[] {
40
+ return asArray(services.get<unknown>(TOOLS))
41
+ .map((tool) => String(pick(tool, "Name", "name") ?? ""))
42
+ .filter((name) => name.length > 0);
43
+ }
44
+
45
+ /**
46
+ * The calls alone, by registered name, through the tools namespace: what a crew
47
+ * gets, since it has no `tools` service to list the names. The launching command
48
+ * found the registered name already (a ToolCatalogue's `find`).
49
+ */
50
+ export function createToolCalls(tools: object): Pick<ToolCatalogue, "call" | "callText"> {
51
+ const call = async (name: string, args: Record<string, unknown>): Promise<unknown> => {
52
+ const fn = (tools as Record<string, unknown> | undefined)?.[toolMemberName(name)];
53
+ if (typeof fn !== "function") throw new Error(`no registered tool '${name}'`);
54
+ return (fn as (input: Record<string, unknown>) => unknown)(args);
55
+ };
56
+ return { call, callText: (name, args) => toolOutcome(() => call(name, args)) };
57
+ }
58
+
59
+ export function createToolCatalogue(tools: object, services: Pick<ServiceLocator, "get">): ToolCatalogue {
60
+ const find = (name: string): string | undefined => {
61
+ const wanted = name.toLowerCase();
62
+ return registeredNames(services).find((registered) => registered.toLowerCase() === wanted);
63
+ };
64
+ const call = async (name: string, args: Record<string, unknown>): Promise<unknown> => {
65
+ const registered = find(name);
66
+ if (registered === undefined) throw new Error(`no registered tool '${name}'`);
67
+ return createToolCalls(tools).call(registered, args);
68
+ };
69
+ return {
70
+ names: () => registeredNames(services).sort(),
71
+ find,
72
+ call,
73
+ callText: (name, args) => toolOutcome(() => call(name, args)),
74
+ };
75
+ }
@@ -0,0 +1,120 @@
1
+ // Normaliser for tool results whose property casing varies — .NET-bridged CLR
2
+ // types come back PascalCase, pure-JS tools camel/snake_case. Centralises the
3
+ // `r.stdout ?? r.Stdout` / `pick(...,"messages","Messages")` dual-casing that
4
+ // was duplicated inline across every crew (git-commit:14-16, code-review:12,
5
+ // project-init:9, session-compact:10, init-verifiers:10). Pure — no IO. The
6
+ // adapters of this folder read every result through it, and the failures of a
7
+ // tool call: the runtime wraps the tool's own message, which is all a user reads.
8
+ //
9
+ // Run tests: node --test src/shared/infrastructure/orkeon/tool-results.test.ts
10
+
11
+ import type { ToolOutcome } from "../../application/ports.ts";
12
+ import { errorText } from "../../domain/prelude.ts";
13
+
14
+ /** First defined property among the given candidate names (any casing). */
15
+ export function pick(obj: any, ...names: string[]): any {
16
+ if (!obj) return undefined;
17
+ for (const n of names) {
18
+ if (obj[n] !== undefined) return obj[n];
19
+ }
20
+ return undefined;
21
+ }
22
+
23
+ /** `stdout` of a shell_command result (snake or Pascal), as a string. */
24
+ export function shOut(r: any): string {
25
+ return String(pick(r, "stdout", "Stdout") ?? "");
26
+ }
27
+
28
+ /** `stderr` of a shell_command result (snake or Pascal), as a string. */
29
+ export function shErr(r: any): string {
30
+ return String(pick(r, "stderr", "Stderr") ?? "");
31
+ }
32
+
33
+ /** `exit_code` of a shell_command result (snake/camel/Pascal); -1 if absent. */
34
+ export function shCode(r: any): number {
35
+ return Number(pick(r, "exit_code", "exitCode", "ExitCode") ?? -1);
36
+ }
37
+
38
+ /** `content` / `text` of a file_read result (snake or Pascal), as a string; a
39
+ * result that is itself a string is the content. */
40
+ export function fileContent(r: any): string {
41
+ if (typeof r === "string") return r;
42
+ return String(pick(r, "content", "Content", "text", "Text") ?? "");
43
+ }
44
+
45
+ /** Coerce a value to an array (returns [] for null/undefined/non-array). */
46
+ export function asArray<T = any>(v: any): T[] {
47
+ return Array.isArray(v) ? (v as T[]) : [];
48
+ }
49
+
50
+ /**
51
+ * Entry names from a directory_read result. The real tool shape is
52
+ * `{ Files: [{Name,Path}], Directories: [{Name,Path}] }`; the older
53
+ * `{ entries|Entries|items }` shape is tolerated too. Names + casing vary.
54
+ */
55
+ export function entryNames(listing: any): string[] {
56
+ const files = asArray(pick(listing, "files", "Files"));
57
+ const dirs = asArray(pick(listing, "directories", "Directories"));
58
+ const legacy = asArray(pick(listing, "entries", "Entries", "items"));
59
+ return [...files, ...dirs, ...legacy].map((e: any) =>
60
+ String(pick(e, "name", "Name", "path", "Path") ?? e));
61
+ }
62
+
63
+ /** A tool result as text: a string as it is; else the first string field among
64
+ * text, content and result (either case); else its JSON; nothing for no result. */
65
+ export function resultText(raw: unknown): string {
66
+ if (typeof raw === "string") return raw;
67
+ if (raw === null || raw === undefined) return "";
68
+ if (typeof raw === "object") {
69
+ for (const key of ["text", "content", "result", "Text", "Content", "Result"]) {
70
+ const field = (raw as Record<string, unknown>)[key];
71
+ if (typeof field === "string") return field;
72
+ }
73
+ }
74
+ return JSON.stringify(raw);
75
+ }
76
+
77
+ /**
78
+ * A failed tool call as the tool's own message, every line of it: without what the runtime
79
+ * wraps it in ("One or more errors occurred. (tools.transcribeAudio failed [path=…]: Error
80
+ * executing tool transcribe_audio: …)") nor the host's inner exception (" ---> System.…").
81
+ * Callers that look for "not found" in it read the tool's whole message.
82
+ */
83
+ export function ownMessage(error: unknown): string {
84
+ let text = (error instanceof Error ? error.message : String(error)).trim();
85
+ const executing = /Error executing tool [\w.-]+:\s*([\s\S]*)$/.exec(text);
86
+ const failed = /tools\.\w+ failed \[[^\]]*\]:\s*([\s\S]*)$/.exec(text);
87
+ if (executing) text = executing[1];
88
+ else if (failed) text = failed[1];
89
+ const inner = text.indexOf("\n --->");
90
+ if (inner >= 0) text = text.slice(0, inner);
91
+ text = text.trim();
92
+ const count = (c: string) => text.split(c).length - 1;
93
+ while (text.endsWith(")") && count(")") > count("(")) text = text.slice(0, -1);
94
+ return text.trim();
95
+ }
96
+
97
+ /** A failed tool call as one readable line: the first line of its own message (ownMessage). */
98
+ export function failureText(error: unknown): string {
99
+ return errorText(ownMessage(error));
100
+ }
101
+
102
+ /** A call read as text: its result's text, or its failure's own message. Never throws. */
103
+ export async function toolOutcome(call: () => Promise<unknown>): Promise<ToolOutcome> {
104
+ try {
105
+ return { ok: true, text: resultText(await call()) };
106
+ } catch (error) {
107
+ return { ok: false, failure: failureText(error) };
108
+ }
109
+ }
110
+
111
+ /** A call whose failure is rethrown with the tool's own message, every line kept (ownMessage):
112
+ * a caller tells an absent file by it, and what it shows of it (errorText, the first line)
113
+ * reads the same as a failed tool call. */
114
+ export async function withToolMessage<T>(call: () => Promise<T> | T): Promise<T> {
115
+ try {
116
+ return await call();
117
+ } catch (error) {
118
+ throw new Error(ownMessage(error));
119
+ }
120
+ }
@@ -0,0 +1,74 @@
1
+ // UsageReader adapter over the command context's `usage` service (Orkeon #226): the session's LLM
2
+ // usage, in total and by model and by command, as the host's cost manager accounts it. Reached
3
+ // through the service locator each command receives, like the approvals; a host that keeps no
4
+ // account registers no service and the reader answers nothing. Jint keeps the CLR member names on a
5
+ // host object, so both casings are read, and every count is made a number here. A cache or reasoning count no
6
+ // call reported is null or absent (Orkeon #254): it stays null, never read as 0.
7
+
8
+ import type { CommandUsage, ModelUsage, UsageReader, UsageReport, UsageSpent } from "../../application/ports.ts";
9
+ import type { SessionUsage, ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
10
+ import { asArray, pick } from "./tool-results.ts";
11
+
12
+ /** The service name; orkeon-repl registers it while it keeps a cost manager or command instances. */
13
+ const USAGE = "usage";
14
+
15
+ const field = (r: unknown, name: string): unknown => pick(r, name, name[0].toUpperCase() + name.slice(1));
16
+
17
+ /** A reported count, as a number; absent reads as 0. */
18
+ const count = (r: unknown, name: string): number => Number(field(r, name) ?? 0) || 0;
19
+
20
+ /** A count the host may leave unmeasured: null and absent read as null, a measured 0 as 0. */
21
+ function measured(r: unknown, name: string): number | null {
22
+ const v = field(r, name);
23
+ if (v == null) return null;
24
+ const n = Number(v);
25
+ return Number.isFinite(n) ? n : null;
26
+ }
27
+
28
+ /** A reported cost; null, absent and a non-number all read as unpriced. */
29
+ function costOf(r: unknown): number | null {
30
+ const v = pick(r, "cost", "Cost");
31
+ return typeof v === "number" && Number.isFinite(v) ? v : null;
32
+ }
33
+
34
+ function spentOf(r: unknown): UsageSpent {
35
+ return {
36
+ promptTokens: count(r, "promptTokens"),
37
+ completionTokens: count(r, "completionTokens"),
38
+ cacheHitTokens: measured(r, "cacheHitTokens"),
39
+ cacheWriteTokens: measured(r, "cacheWriteTokens"),
40
+ reasoningTokens: measured(r, "reasoningTokens"),
41
+ calls: count(r, "calls"),
42
+ unpricedCalls: count(r, "unpricedCalls"),
43
+ cost: costOf(r),
44
+ };
45
+ }
46
+
47
+ const text = (r: unknown, name: string): string => String(field(r, name) ?? "");
48
+
49
+ function modelOf(r: unknown): ModelUsage {
50
+ return { ...spentOf(r), model: text(r, "model") };
51
+ }
52
+
53
+ function commandOf(r: unknown): CommandUsage {
54
+ return { ...spentOf(r), ticket: text(r, "ticket"), name: text(r, "name"), state: text(r, "state") };
55
+ }
56
+
57
+ export function createUsageReader(services: Pick<ServiceLocator, "get" | "has">): UsageReader {
58
+ return {
59
+ report(): UsageReport | undefined {
60
+ try {
61
+ if (!services.has(USAGE)) return undefined;
62
+ const r = services.get<SessionUsage>(USAGE).report();
63
+ return {
64
+ ...spentOf(r),
65
+ totalTokens: count(r, "totalTokens"),
66
+ byModel: asArray(pick(r, "byModel", "ByModel")).map(modelOf),
67
+ byCommand: asArray(pick(r, "byCommand", "ByCommand")).map(commandOf),
68
+ };
69
+ } catch {
70
+ return undefined;
71
+ }
72
+ },
73
+ };
74
+ }
@@ -0,0 +1,118 @@
1
+ // The adapters bound to the runtime's `tools` global, and the session and config
2
+ // services built over them, for the entry points to wire into the application
3
+ // (the commands' _lib takes them as parameters). The only module of this folder
4
+ // that imports globals.ts:
5
+ // the adapters themselves take the tools as a parameter, so their tests run them
6
+ // over tests/support/fake-tools.ts. The CrewHost adapter (crew-host.ts) is not
7
+ // here: it reads the command context, which each command receives, not a global;
8
+ // nor are the Llm (llm.ts) and RunState (run-state.ts) adapters, which read the
9
+ // context each agent body receives. The tool catalogue reads both: the `tools`
10
+ // global for the calls, the context's `tools` service for the registered names.
11
+ //
12
+ // Each factory takes the tools it calls, the global by default: an agent body that may run beside others (a
13
+ // parallel /dev-batches) passes its own `ctx.tools`, held to its working root, since the global refuses a call
14
+ // from code while agents with different roots run. The file, shell and config ports also take that root, to
15
+ // keep naming the checkout `/workspace` (shared/domain/dev/path-rebase.ts). `Rag` stays the global: its
16
+ // namespace is not a tool call and is never refused.
17
+
18
+ import type {
19
+ AnchorIndex, Clock, CodeIndex, CostIndex, Files, HumanInput, Llm, Logger, MemoryStore, Progress, SessionStore,
20
+ SharedMemory, Shell, ShellJobs, Telemetry, ToolCatalogue,
21
+ } from "../../application/ports.ts";
22
+ import type { CompactDeps } from "../../application/compaction/compact-session.ts";
23
+ import { writeWorkflowState } from "../../application/workflow/workflow-state.ts";
24
+ import { createConfigStore } from "../../application/config-store.ts";
25
+ import type { ConfigStore } from "../../application/config-store.ts";
26
+ import { createSessionIo } from "../../application/session-io.ts";
27
+ import type { SessionIo } from "../../application/session-io.ts";
28
+ import type { ServiceLocator } from "../../../commands/.orkeon/orkeon-cli.d.ts";
29
+ import { AgentBuilder, Llm as HostLlm, Rag, Tools, inputs } from "../globals.ts";
30
+ import { profiledAgent, runtimeTakesActContext } from "./llm-profile.ts";
31
+ import type { AgentFactories } from "./llm-profile.ts";
32
+ import { createAnchorIndex, createCodeIndex, createCostIndex } from "./code-index.ts";
33
+ import { createFiles } from "./files.ts";
34
+ import { createHumanInput } from "./human-input.ts";
35
+ import { createMemoryStore } from "./memory-store.ts";
36
+ import { createProgress } from "./progress.ts";
37
+ import { createSessionStore } from "./session-store.ts";
38
+ import { createShell } from "./shell.ts";
39
+ import { createShellJobs } from "./shell-jobs.ts";
40
+ import { createTelemetry } from "./telemetry.ts";
41
+ import { createGitHubPullRequests } from "./github-pull-requests.ts";
42
+ import { createPullRequestOpener } from "../../application/git/open-pull-request.ts";
43
+ import type { PullRequestPolicy } from "../../application/git/open-pull-request.ts";
44
+ import type { PullRequestOpener } from "../../application/git/commit-files.ts";
45
+ import { createToolCalls, createToolCatalogue } from "./tool-catalogue.ts";
46
+ import type { MemoryToolPorts } from "./memory-tools.ts";
47
+ import { createSharedMemory } from "./shared-memory.ts";
48
+
49
+ /** The system clock: the one place the time is read, handed to the application as its Clock port. */
50
+ export const orkeonClock = (): Clock => () => new Date();
51
+
52
+ export const orkeonShell = (tools: OrkeonTools = Tools, root?: string): Shell => createShell(tools, root);
53
+ export const orkeonShellJobs = (tools: OrkeonTools = Tools, root?: string): ShellJobs => createShellJobs(tools, root);
54
+ export const orkeonFiles = (tools: OrkeonTools = Tools, root?: string): Files => createFiles(tools, root);
55
+ export const orkeonProgress = (tools: OrkeonTools = Tools): Progress => createProgress(tools);
56
+ export const orkeonTelemetry = (tools: OrkeonTools = Tools): Telemetry => createTelemetry(tools);
57
+ export const orkeonMemoryStore = (tools: OrkeonTools = Tools): MemoryStore => createMemoryStore(tools);
58
+ export const orkeonCodeIndex = (tools: OrkeonTools = Tools): CodeIndex => createCodeIndex(tools);
59
+ export const orkeonAnchorIndex = (tools: OrkeonTools = Tools): AnchorIndex => createAnchorIndex(tools);
60
+ export const orkeonCostIndex = (tools: OrkeonTools = Tools): CostIndex => createCostIndex(tools);
61
+ /** The shared memory's RAG index: the `rag` namespace, else the rag tools. */
62
+ export const orkeonSharedMemory = (tools: OrkeonTools = Tools): SharedMemory => createSharedMemory(Rag, tools);
63
+ /** What memory_recall and memory_push call, built when the model calls one. */
64
+ export const orkeonMemoryToolPorts = (tools: OrkeonTools = Tools, root?: string): MemoryToolPorts => ({
65
+ files: orkeonFiles(tools, root), shell: orkeonShell(tools, root), config: orkeonConfigStore(tools, root),
66
+ memory: orkeonSharedMemory(tools), clock: orkeonClock(),
67
+ });
68
+ /** human_input: a question to the person at the terminal, never answered on their behalf. */
69
+ export const orkeonHumanInput = (tools: OrkeonTools = Tools): HumanInput => createHumanInput(tools);
70
+ /** The pull request opened with the github tool, under the session's mode and rules (W0-C). */
71
+ export const orkeonPullRequestOpener = (policy: PullRequestPolicy, tools: OrkeonTools = Tools): PullRequestOpener =>
72
+ createPullRequestOpener({ shell: orkeonShell(tools), github: createGitHubPullRequests(tools) }, policy);
73
+ /** The registered tools: built in a handler, from the `ctx.services` it receives. */
74
+ export const orkeonToolCatalogue = (services: Pick<ServiceLocator, "get">): ToolCatalogue =>
75
+ createToolCatalogue(Tools, services);
76
+
77
+ /** The calls alone, by registered name: for a crew, which gets no `tools` service. */
78
+ export const orkeonToolCalls = (tools: OrkeonTools = Tools): Pick<ToolCatalogue, "call" | "callText"> =>
79
+ createToolCalls(tools);
80
+ const orkeonSessionStore = (tools: OrkeonTools = Tools): SessionStore => createSessionStore(tools);
81
+
82
+ /** The /config store: the settings file, overridden by the session bag. */
83
+ export const orkeonConfigStore = (tools: OrkeonTools = Tools, root?: string): ConfigStore =>
84
+ createConfigStore({ files: orkeonFiles(tools, root), session: orkeonSessionStore(tools) });
85
+
86
+ /** The session's buffer, state and budget, and its permission mode. */
87
+ export const orkeonSessionIo = (tools: OrkeonTools = Tools): SessionIo =>
88
+ createSessionIo({ store: orkeonSessionStore(tools), config: orkeonConfigStore(tools) });
89
+
90
+ /** The compaction pipeline's ports, for /compact and the main loop's automatic compaction alike: the running
91
+ * agent's model and log, and step 0 writing the state file of the dev batch in progress. */
92
+ export const orkeonCompactionDeps = (
93
+ ctx: { llm: Llm; log: Logger },
94
+ ports: {
95
+ session: SessionStore; files: Files; memory: MemoryStore; progress: Progress; shell: Shell;
96
+ config: Pick<ConfigStore, "readValue">;
97
+ },
98
+ clock: Clock,
99
+ ): CompactDeps => {
100
+ const { session, files, memory, progress, shell, config } = ports;
101
+ return {
102
+ progress, session, files, memory, llm: ctx.llm, log: ctx.log, clock,
103
+ workflow: (trigger) => writeWorkflowState({ session, files, shell, config, clock }, trigger),
104
+ };
105
+ };
106
+
107
+ /** The runtime's agent factories: `agentBuilder` and `llm.profile`, the latter absent where the host declares no `llm`. */
108
+ export const orkeonAgentFactories = (): AgentFactories => {
109
+ const host = HostLlm;
110
+ return { agent: AgentBuilder, profile: host === undefined ? undefined : (name) => host.profile(name) };
111
+ };
112
+
113
+ /** Whether the runtime's act() reads `context` (Orkeon #277): false on the rc.6 release (orkeon/llm-profile.ts). */
114
+ export const orkeonActTakesContext = (): boolean => runtimeTakesActContext(orkeonAgentFactories());
115
+
116
+ /** An agent builder on the profile the crew input names (`llmProfile`, the session's `llm.profile`), else the plain
117
+ * one: where every composition root starts an agent (orkeon/llm-profile.ts). */
118
+ export const orkeonAgent = (input: Readonly<Record<string, unknown>> = inputs()): any => profiledAgent(input, orkeonAgentFactories());