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,559 @@
1
+ // Orkeon CLI scripted-commands TypeScript declarations.
2
+ // Shipped inside the `orkeon` tool: `orkeon typings` writes this file (and orkeon.d.ts) into
3
+ // ./.orkeon/ — run it again after updating the tool.
4
+ //
5
+ // Reference at the top of each script:
6
+ // /// <reference path="./.orkeon/orkeon-cli.d.ts" />
7
+
8
+ declare global {
9
+ /**
10
+ * Register a scripted command. Called at module top level — calling it from inside a
11
+ * handler throws (the loader freezes the collector after evaluation).
12
+ */
13
+ function defineCommand<TArgs extends ArgsSchema | undefined = undefined>(
14
+ desc: CommandDescriptor<TArgs>,
15
+ ): void;
16
+
17
+ /**
18
+ * Register an asynchronous scripted command. `dispatch` launches and returns
19
+ * the prompt immediately; the optional `completed` is replayed on the engine thread when the
20
+ * agent responds. Called at module top level (same freeze rule as `defineCommand`).
21
+ */
22
+ function defineAsyncCommand<TArgs extends ArgsSchema | undefined = undefined>(
23
+ desc: AsyncCommandDescriptor<TArgs>,
24
+ ): void;
25
+ }
26
+
27
+ /** Descriptor passed to `defineAsyncCommand`. */
28
+ export interface AsyncCommandDescriptor<TArgs extends ArgsSchema | undefined = undefined> {
29
+ name: string;
30
+ aliases?: readonly string[];
31
+ /**
32
+ * Group `/help` lists the command under (`^[a-z][a-z0-9-]*$`). When omitted, the name of the folder
33
+ * holding the `*.cmd.ts` (none for a file at the root of the commands mount).
34
+ */
35
+ group?: string;
36
+ description: string;
37
+ /** Typed args spec. When omitted, `dispatch` receives `{ raw: string[] }`. */
38
+ args?: TArgs;
39
+ /**
40
+ * Per-command admission quota: the max number of in-flight instances of THIS command.
41
+ * Omitted ⇒ unbounded (∞). Must be an integer ≥ 1 when present.
42
+ */
43
+ maxConcurrent?: number;
44
+ /** Launches the work and returns immediately (do not block). Typically returns `{ ticket }`. */
45
+ dispatch: (args: ParsedArgs<TArgs>, ctx: CommandRuntimeContext) => unknown;
46
+ /**
47
+ * Replayed on the engine thread, under the script's engine lock, when the agent (or the crew of a
48
+ * `runCrewAsync`) responds. It may be `async`: when it returns a promise the drain awaits it before
49
+ * going on (to the next completion, to the next command of the same script), so its whole body,
50
+ * every `await` included, must settle there — a host read (`ctx.services.get(...)`), then a
51
+ * `runCrewAsync`, is the intended use. Work left pending past the promise (a promise not awaited)
52
+ * is not waited for, and a launch it makes is not chained to this command.
53
+ *
54
+ * A rejection, or a throw, does not stop the drain: the console shows
55
+ * `Error in completed('<name>'): <first line of the reason>`, the host log keeps the whole error,
56
+ * and the registry reports a completion failure for the instance (`ReportCompletionFailure`;
57
+ * `orkeon-repl --replay` stops on the line that launched it). The instance keeps its own state
58
+ * (`done` or `failed`), and a launch made before the rejection still runs and drains.
59
+ *
60
+ * completed: async (result, ctx) => {
61
+ * // A host service of the application whose method returns a Task, which the script sees as a promise.
62
+ * const saved = await ctx.services.get("session").save();
63
+ * ctx.writeLine(`session saved to ${saved}`);
64
+ * ctx.services.get("script-host").runCrewAsync("next-step", { previous: result.payload });
65
+ * },
66
+ */
67
+ completed?: (result: CommandResponse, ctx: CommandRuntimeContext) => void | Promise<void>;
68
+ }
69
+
70
+ /**
71
+ * The command-dispatch facade — `ctx.services.get<CommandsFacade>("commands")`.
72
+ * Addresses agents by name; the host routes over `IAgentChannel` and correlates completion.
73
+ */
74
+ export interface CommandsFacade {
75
+ /** Dispatch to an agent and return its response (a sync command blocks until it arrives). */
76
+ request(agent: string, intent: string, payload: string): CommandResponse;
77
+ /**
78
+ * Dispatch to an agent in the background; returns a ticket immediately. Its completion drains to the
79
+ * `completed` of the command that posted it. Called from a `completed`, the new instance is one hop deeper
80
+ * in the chain, bounded by `MaxChainDepth` like {@link ScriptHostFacade.runCrewAsync}: at the limit it throws
81
+ * `chain depth 8 reached (MaxChainDepth 8, /<command>)`.
82
+ */
83
+ post(agent: string, intent: string, payload: string): string;
84
+ /** List in-flight / recent instances, optionally filtered. */
85
+ list(filter?: CommandInstanceFilter | string): readonly CommandInstanceView[];
86
+ /** Full view for a ticket, or `undefined`. */
87
+ get(ticket: string): CommandInstanceView | undefined;
88
+ /**
89
+ * Request cancellation of an in-flight ticket. An exclusive target stays held until the cancelled work has
90
+ * actually ended: a relaunch is refused until then.
91
+ */
92
+ cancel(ticket: string): boolean;
93
+ }
94
+
95
+ /** Agent response — resolved value of `request()` / argument to `completed()`. */
96
+ export interface CommandResponse {
97
+ readonly agent: string;
98
+ readonly intent: string;
99
+ readonly success: boolean;
100
+ readonly payload: string;
101
+ /**
102
+ * True when any turn of this request was written to the console in the foreground
103
+ * (`Orkeon:Cli:ConsoleStreaming:Enabled`): skip your own print of `payload`, or the answer shows twice.
104
+ * Background and labelled output report false: streaming off, an agent that did not stream, and a
105
+ * background instance (`post`, `runCrewAsync`), whose turns are written as whole lines prefixed with
106
+ * its ticket (`[t2] `).
107
+ */
108
+ readonly streamed: boolean;
109
+ readonly error?: string;
110
+ }
111
+
112
+ export type CommandInstanceState = "running" | "done" | "failed" | "cancelled" | "rejected";
113
+
114
+ /** Read filter for `commands.list`. Any omitted field is a wildcard. */
115
+ export interface CommandInstanceFilter {
116
+ state?: CommandInstanceState | "all";
117
+ name?: string;
118
+ agent?: string;
119
+ }
120
+
121
+ /** Snapshot of a dispatched command instance. */
122
+ export interface CommandInstanceView {
123
+ readonly ticket: string;
124
+ readonly name: string;
125
+ readonly kind: "sync" | "async";
126
+ readonly targetAgent: string;
127
+ readonly intent: string;
128
+ readonly correlationId: string;
129
+ readonly state: CommandInstanceState;
130
+ /** Launched with `{ onMain: true }`: it writes on the main screen and is no task of the list. */
131
+ readonly onMain: boolean;
132
+ readonly startedAt: string;
133
+ readonly completedAt?: string;
134
+ readonly elapsedMs: number;
135
+ readonly result?: CommandResponse;
136
+ readonly error?: string;
137
+ readonly progress?: { step?: number; percent?: number; message?: string };
138
+ /** LLM tokens attributed to this instance so far; 0 when none were observed. */
139
+ readonly tokens: number;
140
+ }
141
+
142
+ /** Descriptor passed to `defineCommand`. */
143
+ export interface CommandDescriptor<TArgs extends ArgsSchema | undefined = undefined> {
144
+ /** Primary identifier, lowercase kebab-case (`^[a-z][a-z0-9-]*$`). */
145
+ name: string;
146
+ /** Alternate identifiers; must not duplicate `name`. */
147
+ aliases?: readonly string[];
148
+ /**
149
+ * Group `/help` lists the command under (`^[a-z][a-z0-9-]*$`). When omitted, the name of the folder
150
+ * holding the `*.cmd.ts` (none for a file at the root of the commands mount).
151
+ */
152
+ group?: string;
153
+ /** Single-line description (≤ 200 chars, no newline). */
154
+ description: string;
155
+ /** Typed args spec. When omitted, the handler receives `{ raw: string[] }`. */
156
+ args?: TArgs;
157
+ /** Handler invoked when the user types the command. */
158
+ handler: (
159
+ args: ParsedArgs<TArgs>,
160
+ ctx: CommandRuntimeContext,
161
+ ) => Promise<CommandActionResult | void> | CommandActionResult | void;
162
+ }
163
+
164
+ /** Result returned by a handler. Use `ctx.continue()` / `ctx.exit()` to build one. */
165
+ export interface CommandActionResult {
166
+ exit?: boolean;
167
+ message?: string;
168
+ }
169
+
170
+ /** Rich runtime context. */
171
+ export interface CommandRuntimeContext {
172
+ readonly command: { readonly name: string; readonly rawInput: string };
173
+
174
+ readonly log: {
175
+ debug(msg: string, data?: object): void;
176
+ info(msg: string, data?: object): void;
177
+ warn(msg: string, data?: object): void;
178
+ error(msg: string, data?: object): void;
179
+ };
180
+
181
+ write(text: string): void;
182
+ writeLine(text: string): void;
183
+ /**
184
+ * Writes a typed block on lines of its own. The split-pane console styles it; any other console
185
+ * shows `text` as plain lines. The caller hands over the source, never a colour.
186
+ */
187
+ writeBlock(spec: { kind: "markdown" | "diff"; text: string }): void;
188
+ /** The console's palette; null on a console without palettes. */
189
+ readonly theme: "dark" | "light" | "none" | null;
190
+ /**
191
+ * Paints the console in a palette, what is already on screen included. Returns false on a console without
192
+ * palettes, which stays as it is. The choice lasts for the session: the start palette is the setting
193
+ * `Orkeon:Cli:Tui:Theme`.
194
+ */
195
+ setTheme(name: "dark" | "light" | "none"): boolean;
196
+ clear(): void;
197
+
198
+ /**
199
+ * Asks the operator. On a console with panels (`interactive`) `select` and `confirm` open one, and Esc answers
200
+ * `null` to a `select` and the default to a `confirm`; elsewhere they are numbered lines.
201
+ */
202
+ prompt(spec: SelectPromptSpec & { detailed: true }): Promise<PromptChoiceAnswer | null>;
203
+ prompt(spec: SelectPromptSpec & { detailed: boolean }): Promise<PromptChoiceAnswer | string | null>;
204
+ prompt(spec: PromptSpec): Promise<PromptResult>;
205
+ /** Whether `prompt` asks a choice with a panel; a replay and a plain console answer false. */
206
+ readonly interactive: boolean;
207
+ progress(spec: { total?: number; label: string }): ProgressHandle;
208
+ table<T extends object>(rows: readonly T[], columns?: readonly (keyof T)[]): void;
209
+
210
+ /**
211
+ * Cooperative cancellation token, exposed directly by Jint. Properties are PascalCase
212
+ * (CLR convention preserved through reflection):
213
+ * if (ctx.signal.IsCancellationRequested) return ctx.continue("cancelled");
214
+ * ctx.signal.ThrowIfCancellationRequested();
215
+ */
216
+ readonly signal: CommandSignal;
217
+
218
+ readonly services: ServiceLocator;
219
+
220
+ continue(message?: string): CommandActionResult;
221
+ exit(farewell?: string): CommandActionResult;
222
+ }
223
+
224
+ /** Backing shape — what Jint actually exposes from the underlying CLR CancellationToken. */
225
+ export interface CancellationTokenLike {
226
+ readonly IsCancellationRequested: boolean;
227
+ ThrowIfCancellationRequested(): void;
228
+ }
229
+
230
+ /**
231
+ * Documentation alias. The actual runtime object is a CLR `CancellationToken` —
232
+ * write `ctx.signal.IsCancellationRequested`, not `ctx.signal.aborted`.
233
+ */
234
+ export type CommandSignal = CancellationTokenLike;
235
+
236
+ export type PromptSpec =
237
+ | { type: "text"; message: string; default?: string }
238
+ | { type: "confirm"; message: string; default?: boolean }
239
+ | SelectPromptSpec
240
+ | { type: "password"; message: string };
241
+
242
+ export interface SelectPromptSpec {
243
+ type: "select";
244
+ message: string;
245
+ /** A string is its own value and label. */
246
+ choices: readonly (string | PromptChoice)[];
247
+ default?: string;
248
+ title?: string;
249
+ description?: string;
250
+ /** The line of keys under the options, in place of the default one. */
251
+ keys?: string;
252
+ /** A value adjusted with the side arrows; read it with `detailed: true`. */
253
+ control?: { label: string; values: readonly string[]; value?: string };
254
+ /** False: Esc does not leave the panel. Default: true. */
255
+ cancellable?: boolean;
256
+ /** True: the answer is a `PromptChoiceAnswer` rather than the value alone. */
257
+ detailed?: boolean;
258
+ }
259
+
260
+ export interface PromptChoice {
261
+ value: string;
262
+ label?: string;
263
+ /** Aligned in a column after the label. */
264
+ description?: string;
265
+ /** Shown only while the option is selected. */
266
+ hint?: string;
267
+ /** The value in force, marked in the list and selected on opening. */
268
+ current?: boolean;
269
+ }
270
+
271
+ export interface PromptChoiceAnswer {
272
+ readonly value: string;
273
+ readonly control: string | null;
274
+ }
275
+
276
+ export type PromptResult = string | boolean | null;
277
+
278
+ export interface ProgressHandle {
279
+ advance(label?: string): void;
280
+ set(value: number, label?: string): void;
281
+ done(label?: string): void;
282
+ }
283
+
284
+ /** Whitelisted service locator: `get` throws for a key that is not whitelisted. */
285
+ export interface ServiceLocator {
286
+ /**
287
+ * Resolve a whitelisted host service. Keys of the default whitelist:
288
+ * - `"fs"` → IFileSystemService, `"tools"` → IBaseTool[],
289
+ * `"runtime"` → {@link RuntimeInfo} (the version and install channel of the runtime that runs the command);
290
+ * - present only when the host wired them (check with `has`): `"llm"` → ILlmProvider,
291
+ * `"logger"` → ILogger, `"commands"` → CommandsFacade (agent dispatch),
292
+ * `"script-host"` → {@link ScriptHostFacade} (run a crew by name),
293
+ * `"permissions"` → {@link PermissionRulesFacade} (the session's tool-call rules, in `orkeon-repl`),
294
+ * `"approvals"` → {@link PendingApprovals} (the tool approvals waiting for the operator, read-only, in `orkeon-repl`),
295
+ * `"session"` → {@link SessionFacade} (save the persisted session now, here or to another file, load a saved one, in `orkeon-repl`),
296
+ * `"usage"` → {@link SessionUsage} (the session's LLM usage by model and by command, with its cost, read-only).
297
+ *
298
+ * The host configuration is deliberately not served: it carries API keys and connection
299
+ * strings (SEC-009), so `get("configuration")` throws.
300
+ */
301
+ get(name: "commands"): CommandsFacade;
302
+ get(name: "script-host"): ScriptHostFacade;
303
+ get(name: "permissions"): PermissionRulesFacade;
304
+ get(name: "approvals"): PendingApprovals;
305
+ get(name: "session"): SessionFacade;
306
+ get(name: "runtime"): RuntimeInfo;
307
+ get(name: "usage"): SessionUsage;
308
+ get<T = unknown>(name: string): T;
309
+ has(name: string): boolean;
310
+ }
311
+
312
+ /**
313
+ * The crew-launching facade — `ctx.services.get<ScriptHostFacade>("script-host")`.
314
+ * Runs a `crews/<name>/crew.ork.ts` (which honours `.body()` + `ctx.llm`), passing `input`
315
+ * as the crew's `globalThis.inputs` object.
316
+ */
317
+ export interface ScriptHostFacade {
318
+ /**
319
+ * Run the crew and wait for its output (short crews; call from a sync handler). The call
320
+ * blocks and returns the output itself, not a promise: `.then(...)` on it throws a
321
+ * `TypeError`. `await` on it is harmless (it resolves to the same value). In `orkeon-repl`
322
+ * with the permission gate on, a tool call of the crew that needs an approval is asked here,
323
+ * while the call waits, and the time the operator takes to answer does not count in
324
+ * `RunCrewTimeout`. Refused with an `ExclusiveLaunchRefusedException` when the same crew is held by an
325
+ * exclusive `runCrewAsync`.
326
+ */
327
+ runCrew(name: string, input?: Record<string, unknown>): CrewRunOutput;
328
+ /**
329
+ * Post the crew on a pool thread and return a ticket immediately. The completion is drained
330
+ * to a `defineAsyncCommand`'s `completed(result)` (the same ticket cycle as `commands.post`);
331
+ * `result.payload` carries the crew summary. Use for long workflows. It may be called from a
332
+ * `completed` handler: the second crew's completion drains to its own command (the same command
333
+ * name). The chain is bounded by `MaxChainDepth` (default 8, `ScriptCommandsConfiguration.MaxChainDepth`);
334
+ * a deeper call throws `chain depth 8 reached (MaxChainDepth 8, /<command>)`. A driver relaunching
335
+ * itself passes `{ chain: "continue" }` (see {@link CrewLaunchOptions}) to keep the parent's depth.
336
+ */
337
+ runCrewAsync(name: string, input?: Record<string, unknown>, options?: CrewLaunchOptions): string;
338
+ /** The discovered crew names. */
339
+ listCrews(): readonly string[];
340
+ }
341
+
342
+ /** Options of {@link ScriptHostFacade.runCrewAsync}. */
343
+ export interface CrewLaunchOptions {
344
+ /**
345
+ * `"continue"`: called from a `completed`, the new instance takes the chain depth of the instance whose
346
+ * `completed` runs instead of that depth plus one, so a driver that relaunches its own work after each
347
+ * cycle (command -> crew -> the same command's `completed` -> crew) is not stopped by `MaxChainDepth`.
348
+ * The parent is always an instance of the same command: a command runs only the `completed` of its own
349
+ * instances, and what that `completed` launches is keyed to it. Outside a `completed` (a `dispatch`, a
350
+ * handler) it changes nothing: the launch takes the depth it takes without it (a first hop is depth 1).
351
+ * Any other value throws.
352
+ */
353
+ chain?: "continue";
354
+ /**
355
+ * `true`: refused while another exclusive launch of the same crew runs — a crew that must not run twice at a
356
+ * time (a review, the writer of a shared store). The check and the launch are one step, so two lines typed in
357
+ * the same tick cannot both pass. The refusal is a throw, before any LLM call, naming the running instance:
358
+ * `crew 'code-review' already running (ticket t2)`. The crew is free again when that instance's work has ended
359
+ * (completed, failed, or stopped after `cancel()`, at its next cooperative checkpoint); a synchronous `runCrew` of
360
+ * the same crew is refused meanwhile. A launch without the option
361
+ * is neither refused nor counted. Boolean or absent: any other value, an explicit `null` included, throws.
362
+ */
363
+ exclusive?: boolean;
364
+ /**
365
+ * `true`: the crew is the conversation itself rather than a task beside it. In the split-pane console what it
366
+ * writes, its calls and its approvals land on the main screen, and the list of tasks leaves it out; `ps` and `get`
367
+ * still report it. Its end line shows only when it failed or its token expired; cancelled on request, it writes no
368
+ * end line and its `completed` does not run. While another `onMain` crew runs, this one is an ordinary task beside
369
+ * it. Boolean or absent: any other value throws.
370
+ */
371
+ onMain?: boolean;
372
+ }
373
+
374
+ /**
375
+ * The session's tool-call rules — `ctx.services.get("permissions")`, in `orkeon-repl`. The permission
376
+ * gate reads them before the mode: a deny rule refuses a call in every mode, an allow rule lets it run
377
+ * without asking in every mode but `plan`. A rule covers every call of a tool, or the calls whose
378
+ * argument matches a pattern whole, `*` standing for any run of characters. They last until the REPL
379
+ * exits.
380
+ */
381
+ export interface PermissionRulesFacade {
382
+ /**
383
+ * Whether the host registered a permission gate (`Orkeon:Security:PermissionGate:Enabled = true`).
384
+ * False, the gate does not run: the session's rules and the permission modes check nothing, and every
385
+ * tool call runs. A crew reads the same fact as `ctx.llm.permissionGate.enabled`.
386
+ */
387
+ readonly enabled: boolean;
388
+ /** Lets the calls run without asking: `allow("shell_command", "command", "npm test*")`. */
389
+ allow(tool: string, argument?: string, pattern?: string): void;
390
+ /** Refuses the calls in every mode: `deny("shell_command", "command", "git push*")`. */
391
+ deny(tool: string, argument?: string, pattern?: string): void;
392
+ /** Removes every rule. */
393
+ clear(): void;
394
+ /** The rules in force, one line each: `allow shell_command command=npm test*`. */
395
+ list(): readonly string[];
396
+ }
397
+
398
+ /**
399
+ * The tool approvals waiting for the operator — `ctx.services.get("approvals")`, in `orkeon-repl`.
400
+ * Read-only: the operator answers them. Each `list()` reads the questions waiting at that moment.
401
+ */
402
+ export interface PendingApprovals {
403
+ /** The approvals waiting, the one the next answer settles first; empty when none waits. */
404
+ list(): readonly PendingApproval[];
405
+ }
406
+
407
+ /**
408
+ * The REPL's persisted session — `ctx.services.get("session")`, in `orkeon-repl` while
409
+ * `Orkeon:Cli:Session:Persist` is on (the REPL's default). Paths are virtual (`/workspace/...`).
410
+ */
411
+ export interface SessionFacade {
412
+ /**
413
+ * Writes the session now and resolves to the virtual path written. Without `path`, to its own file —
414
+ * the file and the shape the REPL writes at exit (`<SessionsDirectory>/<project>/last.json`). With
415
+ * `path`, to that virtual file instead, in the same shape, so {@link SessionFacade.load} reads it back.
416
+ * A blank `path` rejects. The session goes on saving to its own file, so archive the current one with
417
+ * `save(path)` before a `load`: the loaded session overwrites the own file at the next save.
418
+ */
419
+ save(path?: string): Promise<string>;
420
+ /**
421
+ * Swaps the conversation buffer and the state bag (with the session's id and title) for those of a
422
+ * file the REPL saved, and resolves to the number of messages loaded: the next turn continues the
423
+ * loaded conversation. The running command instances (`commands.list`) are untouched, and the
424
+ * session goes on saving to its own file (archive the current one first with `save(path)`). A
425
+ * missing file, or one not of the shape the REPL writes, rejects and leaves the session as it was.
426
+ * A load while another command's turn runs is not supported: the last writer wins.
427
+ */
428
+ load(path: string): Promise<number>;
429
+ }
430
+
431
+ /** One tool approval waiting for the operator. */
432
+ export interface PendingApproval {
433
+ /** The ticket of the background task that asks (`t1`); null outside a task. */
434
+ readonly taskId: string | null;
435
+ /** The name of the command that runs that task (`dev-batches`); null outside a task. */
436
+ readonly command: string | null;
437
+ /** The tool the call names (`shell_command`). */
438
+ readonly tool: string;
439
+ /** The call's input as the status line shows it: its JSON arguments, cut at 60 characters with `…`. */
440
+ readonly input: string;
441
+ }
442
+
443
+ /**
444
+ * The runtime that runs the command — `ctx.services.get("runtime")`, always present. The version and
445
+ * the channel are the ones `orkeon doctor` prints; `version + "+" + commit` is the full build version.
446
+ */
447
+ export interface RuntimeInfo {
448
+ /** The release, build metadata removed (`1.0.0`); `"unknown"` when the host carries none. */
449
+ readonly version: string;
450
+ /** The commit sha the build was made from (the metadata after `+`); null when the version carries none. */
451
+ readonly commit: string | null;
452
+ /**
453
+ * The channel the runtime was installed through: `dotnet-tool`, `deb`, `tarball`, `zip`, `msi`,
454
+ * `homebrew`, `source`…, `"unknown"` when nothing names one (a build tree, an installation older than the marker).
455
+ */
456
+ readonly channel: string;
457
+ }
458
+
459
+ /**
460
+ * The session's LLM usage — `ctx.services.get("usage")`, present when the host keeps a cost manager or
461
+ * command instances (`orkeon-repl`). Read-only. Each `report()` reads the figures of that moment.
462
+ */
463
+ export interface SessionUsage {
464
+ /** The session's usage now: its totals, one row per model, one row per command instance. */
465
+ report(): SessionUsageReport;
466
+ }
467
+
468
+ /** The token split every usage row carries. The cache counts are a part of the prompt, the reasoning a part of the completion. */
469
+ export interface UsageTokens {
470
+ readonly promptTokens: number;
471
+ readonly completionTokens: number;
472
+ /** Prompt tokens served from the provider's cache; null when no call reported a cache count (not measured, never 0). */
473
+ readonly cacheHitTokens: number | null;
474
+ /** Prompt tokens written to the provider's cache; null when no call reported a cache count (not measured, never 0). */
475
+ readonly cacheWriteTokens: number | null;
476
+ /** Completion tokens spent reasoning (Z.AI, OpenRouter report them); null when no call reported them. */
477
+ readonly reasoningTokens: number | null;
478
+ }
479
+
480
+ /** What {@link SessionUsage.report} returns. */
481
+ export interface SessionUsageReport extends UsageTokens {
482
+ /** `promptTokens + completionTokens`. */
483
+ readonly totalTokens: number;
484
+ /** The LLM calls of the session. */
485
+ readonly calls: number;
486
+ /** The calls nobody priced (no vendor charge, no registry price): `cost` counts them as 0, a lower bound while this is not 0. */
487
+ readonly unpricedCalls: number;
488
+ /** The session's cost (USD for the registry's prices); null when no price is known for any call it made. */
489
+ readonly cost: number | null;
490
+ /**
491
+ * One row per model, by name. A call whose provider named no model has no row: the session's totals count it,
492
+ * so they may exceed the sum of these rows.
493
+ */
494
+ readonly byModel: readonly ModelUsageRow[];
495
+ /** One row per command instance the session keeps (a crew run with `runCrewAsync` included), the newest first. */
496
+ readonly byCommand: readonly CommandUsageRow[];
497
+ }
498
+
499
+ /** The usage of one model. */
500
+ export interface ModelUsageRow extends UsageTokens {
501
+ /** The model, as the provider named it in its answer. */
502
+ readonly model: string;
503
+ /** The LLM calls of the model. */
504
+ readonly calls: number;
505
+ /** The calls nobody priced: `cost` counts them as 0. */
506
+ readonly unpricedCalls: number;
507
+ /** The model's cost; null when the vendor billed nothing and no price is configured for it. */
508
+ readonly cost: number | null;
509
+ }
510
+
511
+ /** The usage of one command instance. */
512
+ export interface CommandUsageRow extends UsageTokens {
513
+ /** The instance's ticket (`t1`). */
514
+ readonly ticket: string;
515
+ /** The command's name. */
516
+ readonly name: string;
517
+ /** The instance's state. */
518
+ readonly state: CommandInstanceState;
519
+ /** The LLM calls of the instance. */
520
+ readonly calls: number;
521
+ /** The calls nobody priced: `cost` counts them as 0. */
522
+ readonly unpricedCalls: number;
523
+ /** The instance's cost; null while none of its calls was priced. */
524
+ readonly cost: number | null;
525
+ }
526
+
527
+ /** Result of a crew run launched via {@link ScriptHostFacade}. */
528
+ export interface CrewRunOutput {
529
+ readonly ok: boolean;
530
+ readonly summary?: string;
531
+ readonly artifacts?: unknown;
532
+ readonly error?: string;
533
+ /**
534
+ * True when any turn of this run was written to the console in the foreground; background and
535
+ * labelled output report false: streaming off, a crew task's lines (`[task] `), and `runCrewAsync`.
536
+ */
537
+ readonly streamed: boolean;
538
+ }
539
+
540
+ // ── Args schema: `args: { who: { type: "string" } }` gives the handler `args.who: string`. ──
541
+
542
+ export type ArgSpec =
543
+ | { type: "string"; required?: boolean; default?: string; choices?: readonly string[] }
544
+ | { type: "number"; required?: boolean; default?: number; min?: number; max?: number }
545
+ | { type: "boolean"; required?: boolean; default?: boolean }
546
+ | { type: "string[]"; required?: boolean; default?: readonly string[] };
547
+
548
+ export type ArgsSchema = Readonly<Record<string, ArgSpec>>;
549
+
550
+ export type ParsedArgs<TArgs> = TArgs extends ArgsSchema
551
+ ? { readonly [K in keyof TArgs]: ResolveArgType<TArgs[K]> }
552
+ : { readonly raw: readonly string[] };
553
+
554
+ export type ResolveArgType<S> =
555
+ S extends { type: "string" } ? string
556
+ : S extends { type: "number" } ? number
557
+ : S extends { type: "boolean" } ? boolean
558
+ : S extends { type: "string[]" } ? readonly string[]
559
+ : unknown;