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,51 @@
1
+ // The pull request opened by Orkeon Code itself (W0-C, Q-10): the PullRequestOpener
2
+ // of commit-files.ts over the runtime's `github` tool. It reads origin's
3
+ // repository, decides as the host gate would (shared/domain/git/pull-request.ts),
4
+ // then asks GitHub to open it. Every refusal is a throw carrying its reason:
5
+ // handOverPullRequest says it and hands the `gh pr create` command over.
6
+
7
+ import type { Shell } from "../ports.ts";
8
+ import type { PermissionRule } from "../../domain/agent-policy/permission.ts";
9
+ import type { CreatePrArgs } from "../../domain/git/pull-request.ts";
10
+ import { GITHUB_CREATE_PR, GIT_REMOTE_URL_COMMAND, parseGitHubRemote, pullRequestPermission } from "../../domain/git/pull-request.ts";
11
+ import type { PullRequest, PullRequestOpener } from "./commit-files.ts";
12
+ import { gitReason, runGit } from "./commit-files.ts";
13
+
14
+ /** The `create_pr` call of the github tool: the url of the pull request opened, or a throw with GitHub's reason. */
15
+ export interface GitHubPullRequests {
16
+ create(args: CreatePrArgs): Promise<{ url: string }>;
17
+ }
18
+
19
+ /** What the decision reads: the session's mode and rules, and whether this run asked the user. */
20
+ export interface PullRequestPolicy {
21
+ mode: string;
22
+ rules: readonly PermissionRule[];
23
+ asked: boolean;
24
+ }
25
+
26
+ /** A remote URL without its `user[:secret]@` part. */
27
+ export function withoutUserInfo(url: string): string {
28
+ return String(url ?? "").trim().replace(/^([a-z][a-z0-9+.-]*:\/\/)[^@/]*@/i, "$1");
29
+ }
30
+
31
+ export function createPullRequestOpener(
32
+ deps: { shell: Pick<Shell, "run">; github: GitHubPullRequests },
33
+ policy: PullRequestPolicy,
34
+ ): PullRequestOpener {
35
+ return {
36
+ async open(pr: PullRequest): Promise<{ url: string }> {
37
+ if (pr.base === null) throw new Error("the base branch is unknown (origin/HEAD is unset): git remote set-head origin --auto sets it");
38
+ const remote = await runGit(deps.shell, GIT_REMOTE_URL_COMMAND);
39
+ if (remote.exitCode !== 0) throw new Error(`origin's URL could not be read: ${gitReason(remote)}`);
40
+ const repo = parseGitHubRemote(remote.stdout);
41
+ // The URL is echoed without its user part: a token written there never reaches the terminal.
42
+ if (repo === null) throw new Error(`origin is not a github.com repository (${withoutUserInfo(remote.stdout)})`);
43
+ const args: CreatePrArgs = {
44
+ action: GITHUB_CREATE_PR, owner: repo.owner, repo: repo.repo, base: pr.base, head: pr.head, title: pr.title, body: pr.body,
45
+ };
46
+ const permission = pullRequestPermission({ ...policy, args });
47
+ if (!permission.ok) throw new Error(permission.reason);
48
+ return deps.github.create(args);
49
+ },
50
+ };
51
+ }
@@ -0,0 +1,19 @@
1
+ // Reading the project's instructions file — shared by the main loop (its header)
2
+ // and the crews that need the project's conventions (review, /init).
3
+
4
+ import type { Files } from "./ports.ts";
5
+ import { INSTRUCTIONS_FILES } from "../domain/instructions-file.ts";
6
+ import type { InstructionsFile } from "../domain/instructions-file.ts";
7
+ import { WORKSPACE } from "../domain/vfs.ts";
8
+
9
+ /** The project's instructions file: the first of INSTRUCTIONS_FILES present and
10
+ * not blank (AGENTS.md, then CLAUDE.md); undefined when the project has none. */
11
+ export async function readInstructionsFile(files: Pick<Files, "read">): Promise<InstructionsFile | undefined> {
12
+ for (const file of INSTRUCTIONS_FILES) {
13
+ try {
14
+ const content = await files.read(`${WORKSPACE}/${file}`);
15
+ if (content.trim().length > 0) return { file, content };
16
+ } catch { /* absent or unreadable → the next one */ }
17
+ }
18
+ return undefined;
19
+ }
@@ -0,0 +1,34 @@
1
+ // A JSON file a person may edit by hand (the /config settings, the /agents
2
+ // registry), over the Files port: read guarded against malformed content, written
3
+ // pretty-printed.
4
+
5
+ import type { Files } from "./ports.ts";
6
+
7
+ /**
8
+ * Reads the file. An absent or blank file is the normal first state: no value, not
9
+ * malformed. Malformed JSON, or a read that fails for another reason than absence,
10
+ * yields no value and the `malformed` flag, because writing over a file we could
11
+ * not parse would destroy whatever it did contain.
12
+ */
13
+ export async function readJsonFile(
14
+ files: Pick<Files, "read">,
15
+ path: string,
16
+ ): Promise<{ value: unknown; malformed: boolean }> {
17
+ try {
18
+ const content = (await files.read(path)).trim();
19
+ if (content.length === 0) return { value: undefined, malformed: false };
20
+ return { value: JSON.parse(content), malformed: false };
21
+ } catch (e: any) {
22
+ // A read failure is "absent" in the common case. Distinguishing absent from
23
+ // unreadable needs an error shape the tool does not promise, so the only safe
24
+ // reading is: nothing persisted, and never write over it blindly.
25
+ const message = String(e?.message ?? e);
26
+ const looksMissing = /not found|no such|does not exist/i.test(message);
27
+ return { value: undefined, malformed: !looksMissing };
28
+ }
29
+ }
30
+
31
+ /** Writes the file pretty-printed, with a final newline: a person edits it too. */
32
+ export async function writeJsonFile(files: Pick<Files, "write">, path: string, value: unknown): Promise<void> {
33
+ await files.write(path, `${JSON.stringify(value, null, 2)}\n`);
34
+ }
@@ -0,0 +1,35 @@
1
+ // The session's `llm.profile`, read by a command before it launches a crew: the profile's name, or the
2
+ // line to warn with when the setting cannot be read or holds no profile name (the launch then goes on,
3
+ // on the host's default model).
4
+
5
+ import type { ConfigStore } from "./config-store.ts";
6
+ import { CONFIG_FILE_PATH } from "./config-store.ts";
7
+ import { LLM_PROFILE_CONFIG_KEY, llmProfileProblem } from "../domain/llm-profile.ts";
8
+
9
+ export interface LlmProfileRead {
10
+ /** The profile every agent of the crew runs on; null when the session names none. */
11
+ profile: string | null;
12
+ /** The line to warn with when the setting was not read as a profile. */
13
+ warning?: string;
14
+ }
15
+
16
+ export async function readLlmProfile(config: Pick<ConfigStore, "readValue" | "readFile">): Promise<LlmProfileRead> {
17
+ try {
18
+ const { value, source } = await config.readValue(LLM_PROFILE_CONFIG_KEY);
19
+ if (source === "unset" && (await config.readFile()).malformed) {
20
+ return unreadable(`${CONFIG_FILE_PATH} could not be read or parsed`);
21
+ }
22
+ if (typeof value !== "string") return { profile: null };
23
+ const problem = llmProfileProblem(value);
24
+ if (problem !== undefined) {
25
+ return { profile: null, warning: `${LLM_PROFILE_CONFIG_KEY}: ${problem}; the host's default model this launch` };
26
+ }
27
+ return { profile: value.trim() };
28
+ } catch (e: unknown) {
29
+ return unreadable(String((e as { message?: unknown })?.message ?? e));
30
+ }
31
+ }
32
+
33
+ function unreadable(why: string): LlmProfileRead {
34
+ return { profile: null, warning: `${LLM_PROFILE_CONFIG_KEY} could not be read (${why}): the host's default model this launch` };
35
+ }
@@ -0,0 +1,159 @@
1
+ // The session's permission rules: kept in the session state bag, where
2
+ // /permissions writes them, and enforced by the host's permission gate, which
3
+ // holds its own copy. The gate keeps its rules until the REPL exits and removes
4
+ // them only all at once, so a sync clears it and replays the stored list: the
5
+ // gate then holds exactly what the bag holds, whatever an earlier command, an
6
+ // earlier session or /clear left in either, then the built-in denies the caller
7
+ // hands over (no model tool writes the shared memory's candidates or entries).
8
+ // /permissions syncs after every change, and every command that launches the
9
+ // main loop syncs first.
10
+ //
11
+ // Every stored entry is kept as written until the user removes it: a rule on a
12
+ // tool the session does not know now (an extra tool `tools.extra` no longer lists,
13
+ // or a setting that could not be read) is DORMANT — kept, left out of the gate,
14
+ // reported — and applies again once the tool is listed; an entry that is not a
15
+ // rule at all is kept and ignored. A change rewrites only the rule it is about.
16
+
17
+ import type { PermissionRules, SessionStore } from "./ports.ts";
18
+ import { readJsonArray, writeJson } from "./session-state.ts";
19
+ import { formatRule, parseStoredRule, readRule, sameCalls } from "../domain/agent-policy/permission.ts";
20
+ import type { PermissionRule } from "../domain/agent-policy/permission.ts";
21
+ import { PERMISSION_RULES_STATE_KEY } from "../domain/session-keys.ts";
22
+
23
+ /** The stored rules, sorted by what the session can do with them. */
24
+ export interface StoredRules {
25
+ /** The rules on a built-in or configured extra tool, in stored order: what the gate is handed. */
26
+ rules: PermissionRule[];
27
+ /** The rules on a tool neither built in nor listed in `tools.extra`, as written: kept, not enforced. */
28
+ dormant: string[];
29
+ /** The entries that are not rules, as written: kept, ignored. */
30
+ invalid: string[];
31
+ }
32
+
33
+ /** Reads the stored rules; a rule names a built-in tool or one of `extraNames`, the configured extra tools. */
34
+ export async function readPermissionRules(
35
+ session: Pick<SessionStore, "readState">,
36
+ extraNames: readonly string[] = [],
37
+ ): Promise<StoredRules> {
38
+ const stored: StoredRules = { rules: [], dormant: [], invalid: [] };
39
+ for (const entry of await readJsonArray(session, PERMISSION_RULES_STATE_KEY)) {
40
+ const rule = parseStoredRule(entry, extraNames);
41
+ if (rule) stored.rules.push(rule);
42
+ else if (readRule(entry)) stored.dormant.push(String(entry));
43
+ else stored.invalid.push(String(entry));
44
+ }
45
+ return stored;
46
+ }
47
+
48
+ /** Rewrites the stored entries, keeping as written every entry `keep` accepts (it
49
+ * reads the rule an entry holds, null for one that is not a rule), then appending
50
+ * `added`; returns the entries left out. */
51
+ async function rewrite(
52
+ session: Pick<SessionStore, "readState" | "writeState">,
53
+ keep: (rule: PermissionRule | null) => boolean,
54
+ added: string[] = [],
55
+ ): Promise<unknown[]> {
56
+ const entries = await readJsonArray(session, PERMISSION_RULES_STATE_KEY);
57
+ const kept = entries.map((entry) => keep(readRule(entry)));
58
+ await writeJson(session, PERMISSION_RULES_STATE_KEY, [...entries.filter((_, i) => kept[i]), ...added]);
59
+ return entries.filter((_, i) => !kept[i]);
60
+ }
61
+
62
+ /** Stores `rule`, in place of any stored rule on the same calls whatever its effect:
63
+ * the list never holds an allow and a deny for the same calls. */
64
+ export async function addPermissionRule(
65
+ session: Pick<SessionStore, "readState" | "writeState">,
66
+ rule: PermissionRule,
67
+ ): Promise<void> {
68
+ await rewrite(session, (stored) => stored === null || !sameCalls(stored, rule), [formatRule(rule)]);
69
+ }
70
+
71
+ /** Removes the stored rules equal to `rule` (effect, tool, argument and pattern),
72
+ * dormant ones included; returns them, empty when there was none. */
73
+ export async function removePermissionRule(
74
+ session: Pick<SessionStore, "readState" | "writeState">,
75
+ rule: PermissionRule,
76
+ ): Promise<PermissionRule[]> {
77
+ const removed = await rewrite(
78
+ session,
79
+ (stored) => stored === null || stored.effect !== rule.effect || !sameCalls(stored, rule),
80
+ );
81
+ return removed.map(readRule).filter((r): r is PermissionRule => r !== null);
82
+ }
83
+
84
+ /** Removes every stored entry. */
85
+ export async function clearPermissionRules(session: Pick<SessionStore, "writeState">): Promise<void> {
86
+ await writeJson(session, PERMISSION_RULES_STATE_KEY, []);
87
+ }
88
+
89
+ /** What a sync left in force, and what it left out. */
90
+ export interface RuleSync extends StoredRules {
91
+ /** False when the host keeps no session rules: the gate decides from the mode alone. */
92
+ applied: boolean;
93
+ /** The built-in deny rules handed over after the session's (empty when not applied): never stored, never
94
+ * listed as the session's, and no /permissions change removes them. */
95
+ builtIn: PermissionRule[];
96
+ /** The session's allow rules left out of the gate because a built-in or a step rule denies the same calls. */
97
+ overridden: PermissionRule[];
98
+ }
99
+
100
+ /** Adds the stored rules in stored order, less a stored allow on the same calls as one of the `denies`; returns
101
+ * the allows left out. */
102
+ function addStored(gate: PermissionRules, stored: readonly PermissionRule[], denies: readonly PermissionRule[]): PermissionRule[] {
103
+ const overridden: PermissionRule[] = [];
104
+ for (const rule of stored) {
105
+ const denied = rule.effect === "allow" && denies.some((d) => d.effect === "deny" && sameCalls(d, rule));
106
+ if (denied) overridden.push(rule);
107
+ else gate.add(rule);
108
+ }
109
+ return overridden;
110
+ }
111
+
112
+ /** Makes the gate hold the stored rules, then the built-in ones: clear it, add each stored rule in stored order
113
+ * (less a stored allow on the same calls as a built-in deny), then each built-in rule. */
114
+ export async function syncPermissionRules(deps: {
115
+ session: Pick<SessionStore, "readState">;
116
+ gate: PermissionRules;
117
+ /** The configured extra tools, which rules may name. */
118
+ extraNames?: readonly string[];
119
+ /** Deny rules every sync adds, whatever the mode (the shared memory's folders: memoryWriteRules). */
120
+ builtIn?: readonly PermissionRule[];
121
+ }): Promise<RuleSync> {
122
+ const stored = await readPermissionRules(deps.session, deps.extraNames);
123
+ if (!deps.gate.available()) return { ...stored, applied: false, builtIn: [], overridden: [] };
124
+ const builtIn = [...(deps.builtIn ?? [])];
125
+ deps.gate.clear();
126
+ const overridden = addStored(deps.gate, stored.rules, builtIn);
127
+ for (const rule of builtIn) deps.gate.add(rule);
128
+ return { ...stored, applied: true, builtIn, overridden };
129
+ }
130
+
131
+ /** What a step's sync left in force. `rules`, `dormant`, `invalid` are the session's, as syncPermissionRules
132
+ * reports them; `step` the step's rules handed over (empty when not applied); `overridden` the session's
133
+ * allow rules left out of the gate because a step rule or a built-in one denies the same calls. */
134
+ export interface StepRuleSync extends RuleSync {
135
+ step: PermissionRule[];
136
+ }
137
+
138
+ /**
139
+ * Makes the gate hold the session's rules, then a step's, then the built-in ones: clear it, add each stored rule
140
+ * in stored order (less a stored allow on the same calls as a step or built-in deny), then add each step rule in
141
+ * order, then each built-in rule. The step's rules are never stored: the next syncPermissionRules (the next
142
+ * /assistant turn, the next /permissions change) hands the gate the session's rules and the built-in ones alone.
143
+ */
144
+ export async function syncStepRules(deps: {
145
+ session: Pick<SessionStore, "readState">;
146
+ gate: PermissionRules;
147
+ extraNames?: readonly string[];
148
+ rules: readonly PermissionRule[];
149
+ builtIn?: readonly PermissionRule[];
150
+ }): Promise<StepRuleSync> {
151
+ const stored = await readPermissionRules(deps.session, deps.extraNames);
152
+ if (!deps.gate.available()) return { ...stored, applied: false, step: [], builtIn: [], overridden: [] };
153
+ const builtIn = [...(deps.builtIn ?? [])];
154
+ deps.gate.clear();
155
+ const overridden = addStored(deps.gate, stored.rules, [...deps.rules, ...builtIn]);
156
+ for (const rule of deps.rules) deps.gate.add(rule);
157
+ for (const rule of builtIn) deps.gate.add(rule);
158
+ return { ...stored, applied: true, step: [...deps.rules], builtIn, overridden };
159
+ }
@@ -0,0 +1,20 @@
1
+ // The pending-approvals port: the tool approvals waiting for the operator, read by a command (/tasks).
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** One tool approval waiting for the operator, as the host's status line shows it. */
5
+ export interface PendingApproval {
6
+ /** The ticket of the background task that asks (`t1`); null outside a task. */
7
+ taskId: string | null;
8
+ /** The command that runs that task (`dev-batches`); null outside a task. */
9
+ command: string | null;
10
+ /** The tool the call names (`shell_command`). */
11
+ tool: string;
12
+ /** The call's input, cut as the status line cuts it. */
13
+ input: string;
14
+ }
15
+
16
+ /** The approvals waiting for the operator. Read-only: the operator answers them; each `list()` reads what waits
17
+ * at that moment, and a host that keeps no approvals answers none. */
18
+ export interface PendingApprovals {
19
+ list(): readonly PendingApproval[];
20
+ }
@@ -0,0 +1,5 @@
1
+ // The clock port: the time now, read by infrastructure alone.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** The time now: the only way the application reads the clock (orkeonClock in wiring.ts, FakeClock in tests). */
5
+ export type Clock = () => Date;
@@ -0,0 +1,93 @@
1
+ // The code-index ports: the map, search and graph of the code, its anchors and the access cost.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ import type { AccessCostReport } from "../../domain/dev/access-cost.ts";
5
+ import type {
6
+ GraphSummary, ImpactSummary, IndexSummary, MapEntry, PackageSummary,
7
+ } from "../../domain/code-intel-contract.ts";
8
+
9
+ /** A level of the code index that Orkeon Code reads: packages, modules or symbols (the runtime's
10
+ * `codebase_map.level` and `dependency_graph.scope` take these among their own). */
11
+ export type MapLevel = "L1_Package" | "L2_Module" | "L3_Symbol";
12
+
13
+ /** One level of the code map: its entries, and the symbol total it reports. */
14
+ export interface CodeMap {
15
+ entries: MapEntry[];
16
+ symbolCount: number;
17
+ }
18
+
19
+ /** One hit of the hybrid code search. */
20
+ export interface CodeSearchHit {
21
+ /** The symbol, e.g. "/workspace/src/math.ts::add". */
22
+ fqn: string;
23
+ /** A rank aggregate in hybrid mode (about 0.03): an order, not a probability. */
24
+ score: number;
25
+ /** Why the hit ranked: "hybrid", "vector" or "bm25". */
26
+ origin: string;
27
+ }
28
+
29
+ /** Where a symbol lives: the file and the lines the index cites for it. */
30
+ export interface SymbolLocation {
31
+ fqn: string;
32
+ /** The file path as the index returns it, e.g. "/workspace/src/math.ts". */
33
+ path: string;
34
+ /** 1-based; 0 when the index reports none. */
35
+ startLine: number;
36
+ endLine: number;
37
+ language: string;
38
+ /** The first non-blank line of the source, trimmed, at most 160 characters. */
39
+ firstLine: string;
40
+ }
41
+
42
+ /** The code index (RaggableTree), as /analyze harvests it and /dev-plan searches it.
43
+ * Each call throws when the host cannot answer it. */
44
+ export interface CodeIndex {
45
+ /** How many roots the index holds; 0 before the first indexing. */
46
+ rootCount(): Promise<number>;
47
+ /** Index `root`, and count what the index then holds. `parallel` files are parsed at once; the runtime's
48
+ * default (one per processor) when absent. `rebuild` builds from scratch rather than reloading the index an
49
+ * earlier session saved. */
50
+ index(root: string, opts?: { parallel?: number; rebuild?: boolean }): Promise<IndexSummary>;
51
+ /** The map at `level`; `withMetrics` asks for the per-symbol metrics. */
52
+ map(level: MapLevel, withMetrics: boolean, maxEntries?: number): Promise<CodeMap>;
53
+ /** The dependency graph of `scope`, at most `maxNodes` nodes, without its mermaid rendering. */
54
+ dependencyGraph(scope: MapLevel, maxNodes: number): Promise<GraphSummary>;
55
+ packageSummary(fqn: string): Promise<PackageSummary>;
56
+ /** The hybrid code search: at most `topK` hits, best first. */
57
+ search(query: string, topK: number): Promise<CodeSearchHit[]>;
58
+ /** Where `fqn` lives: its file and lines. Throws when the index has no such symbol. */
59
+ symbolSource(fqn: string): Promise<SymbolLocation>;
60
+ /** The callers of `target`, `maxDepth` levels up. */
61
+ impact(target: string, maxDepth: number): Promise<ImpactSummary>;
62
+ }
63
+
64
+ /** The closure of anchors: the FQNs they contain, and the callers and tests of them and of what
65
+ * they contain, distinct and sorted; `unresolved` the anchors the index does not know. */
66
+ export interface AnchorClosure {
67
+ nodes: string[];
68
+ unresolved: string[];
69
+ truncated: boolean;
70
+ }
71
+
72
+ /** The anchors of the code index (`batch_anchors`), apart from CodeIndex. Throws when the host cannot answer. */
73
+ export interface AnchorIndex {
74
+ closure(fqns: readonly string[]): Promise<AnchorClosure>;
75
+ }
76
+
77
+ /** What `dev-verify` asks of the code index for the access cost (`index_status`, `incremental_reindex`,
78
+ * `access_cost`), apart from CodeIndex. Each call throws when the host cannot answer it. */
79
+ export interface CostIndex {
80
+ /** The virtual roots the index holds; none before the first indexing. */
81
+ roots(): Promise<string[]>;
82
+ /** Re-parse `files` (virtual paths) under `root`; the errors the tool reports. */
83
+ refresh(root: string, files: readonly string[]): Promise<string[]>;
84
+ /** The access cost of the members of `files` (virtual paths): the report, or null and the tool's errors. */
85
+ accessCost(files: readonly string[], receivers: string | undefined): Promise<{ report: AccessCostReport | null; errors: string[] }>;
86
+ /** The tests the graph reaches from `files` (paths relative to the indexed root, as git names them: the runtime
87
+ * looks each up as `<root>/<file>`), by `affected_tests`; absent when it is not wired. */
88
+ affected?(files: readonly string[]): Promise<AffectedTests>;
89
+ }
90
+
91
+ /** What `affected_tests` answers: the test projects and classes reached, `all` when the graph cannot bound them,
92
+ * and the files it could not resolve. */
93
+ export interface AffectedTests { all: boolean; projects: string[]; classes: string[]; unresolved: string[] }
@@ -0,0 +1,60 @@
1
+ // The crew ports: the crews the host runs, the running crew's children, log, run state and memory.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** How a crew is launched (Orkeon #221). `chain: "continue"`: from a `completed`, the new instance keeps the
5
+ * chain depth of the instance whose `completed` runs instead of climbing one, so a driver that relaunches its
6
+ * own work after each cycle is not stopped by `Orkeon:Cli:ScriptCommands:MaxChainDepth`; outside a `completed`
7
+ * it changes nothing. */
8
+ export interface CrewLaunchOptions {
9
+ /** The launch keeps the parent's chain depth (a driver relaunching its own work, Orkeon #221). */
10
+ chain?: "continue";
11
+ /** The host refuses the crew while its previous exclusive launch is not terminal (Orkeon #239, domain/agents/exclusive.ts). */
12
+ exclusive?: boolean;
13
+ /** The crew is the conversation: its text, calls and approvals land on the console's main screen, with no row in its list of tasks. */
14
+ onMain?: boolean;
15
+ }
16
+
17
+ /** The crews the host can run, by name. */
18
+ export interface CrewHost {
19
+ /** The discovered crew names; empty when the host lists none or cannot list them. */
20
+ listCrews(): string[];
21
+ /** Start a crew and return its ticket at once: the completion reaches the async
22
+ * command's `completed`. Throws when the host cannot run crews, or refuses the hop. */
23
+ launch(name: string, input: Record<string, unknown>, options?: CrewLaunchOptions): string;
24
+ }
25
+
26
+ /** The children of the running crew (A-3): one background agent per call, its reply left in the crew's
27
+ * memory, its instance listed, stopped and sent to by id (`crew.instances()`, `stop`, `send`). */
28
+ export interface ChildRuntime {
29
+ /** Starts `agent`, an agent of the crew, as a background child with `input`; throws when the host refuses. */
30
+ spawn(agent: string, input: string): void;
31
+ /** The crew's kept instances, oldest first. */
32
+ instances(): ReadonlyArray<{ id: string; agent: string; state: string }>;
33
+ /** Cancels a running instance; false when none runs under `id`. */
34
+ stop(id: string): boolean;
35
+ /** What a child left under `key` in the crew's memory; undefined until it does. */
36
+ read(key: string): Promise<unknown>;
37
+ /** Waits about `ms` milliseconds. */
38
+ pause(ms: number): Promise<void>;
39
+ }
40
+
41
+ /** The running crew's log. */
42
+ export interface Logger {
43
+ info(message: string): void;
44
+ warn(message: string): void;
45
+ }
46
+
47
+ /** The running agent's own state: it lasts one crew run, where the session's
48
+ * state bag outlives it. */
49
+ export interface RunState {
50
+ /** A field as stored; undefined when the run holds none. */
51
+ read(field: string): unknown;
52
+ /** Replace one field, keeping the others. */
53
+ write(field: string, value: unknown): Promise<void>;
54
+ }
55
+
56
+ /** The running crew's own key/value memory, which its agents share for one run. */
57
+ export interface CrewMemory {
58
+ /** Keep `value` under `key`, replacing what the key held. Throws when the host cannot store it. */
59
+ store(key: string, value: unknown): Promise<void>;
60
+ }
@@ -0,0 +1,21 @@
1
+ // The files port: the virtual file system and its mounts.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** One VFS mount: its virtual path, and its access as the host spells it (`ro`, `rw`, `rwnd`). */
5
+ export interface Mount {
6
+ path: string;
7
+ /** Undefined when the host reports none. */
8
+ rights?: string;
9
+ }
10
+
11
+ /** Files by virtual path (/workspace, /output, /tmp). A read that fails throws,
12
+ * with the runtime's own message (an absent file says "not found"). */
13
+ export interface Files {
14
+ /** The file's content, its first `maxLength` characters when given. */
15
+ read(path: string, maxLength?: number): Promise<string>;
16
+ write(path: string, content: string): Promise<void>;
17
+ /** The names of a directory's entries, files and directories, at most `maxEntries`. */
18
+ list(path: string, maxEntries: number): Promise<string[]>;
19
+ /** The VFS mounts. Throws when the host cannot list them. */
20
+ mounts(): Promise<Mount[]>;
21
+ }
@@ -0,0 +1,13 @@
1
+ // The human-input port: a question to the person at the terminal.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** A question to the person at the terminal (`human_input`). Each call says whether a person answered: an
5
+ * unattended host answers on nobody's behalf, and that answer is never taken (`answered: false`). */
6
+ export interface HumanInput {
7
+ /** One of `options`, the first one recommended; `value` is the option picked. */
8
+ choice(prompt: string, options: readonly string[]): Promise<{ answered: true; value: string } | { answered: false }>;
9
+ /** Free text; an empty answer is no answer. */
10
+ text(prompt: string): Promise<{ answered: true; value: string } | { answered: false }>;
11
+ /** Several of `options`, none recommended: the options picked, in the order given. */
12
+ multi(prompt: string, options: readonly string[]): Promise<{ answered: true; values: string[] } | { answered: false }>;
13
+ }
@@ -0,0 +1,54 @@
1
+ // The model port: the agentic call, the completion and the extraction, with their per-call settings.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** What one model call may change, for that call only. */
5
+ export interface ModelOverride {
6
+ /** The model to answer with; the host's provider keeps its credentials and
7
+ * endpoint. Empty or absent: the model the host booted with. */
8
+ model?: string;
9
+ }
10
+
11
+ /** The settings of one completion. */
12
+ export interface CompleteRequest extends ModelOverride {
13
+ /** The system message the completion starts with, the prompt then being the user
14
+ * message: a crew's instructions at system authority, its material (a diff, a
15
+ * transcript, an answer under review) as the user's. Absent: the prompt alone. */
16
+ system?: string;
17
+ }
18
+
19
+ /** The settings of one agentic call. */
20
+ export interface ActRequest extends ModelOverride {
21
+ /** The system message the conversation starts with. */
22
+ system?: string;
23
+ /** The context of the call (memory, repository state, earlier turns): a user message of its own, after `system`
24
+ * and before the prompt, so the prompt stays the last user message, the request a decision profile judges
25
+ * (Orkeon #276). Absent or blank: no message. */
26
+ context?: string;
27
+ /** Tool-call iterations granted; the runtime's default when absent. */
28
+ maxIterations?: number;
29
+ /** The mode the host's permission gate applies to each tool call. */
30
+ permissionMode?: string;
31
+ /** The provider's thinking at this level (`act({effort})`); none when absent. A provider whose field does
32
+ * not know the level receives the highest it knows below it, with a warning in the runtime's log. */
33
+ effort?: "low" | "medium" | "high" | "xhigh" | "max";
34
+ /** The agent's tools offered for this call (a role's subset); all of them when absent. */
35
+ tools?: readonly string[];
36
+ }
37
+
38
+ /** The model, as the crews call it. Every call throws when the host's provider
39
+ * fails; a failed `act` or `complete` throws an LlmFailure (shared/domain/llm-failure.ts), and a call a
40
+ * decision stage of the host blocked rejects with the runtime's DecisionBlockedError (decisionBlockOf). */
41
+ export interface Llm {
42
+ /** The model ⇄ tool-call loop over the running agent's tools, under the crew's
43
+ * budget; resolves to the final answer's text. A token budget that ran out
44
+ * rejects with a BudgetExhaustedAnswer (shared/domain/llm-failure.ts) carrying
45
+ * the wrap-up the model made without tools: never resolved as an answer. */
46
+ act(prompt: string, request: ActRequest): Promise<string>;
47
+ /** One completion, without tools; with `request.system`, a system message first. */
48
+ complete(prompt: string, request?: CompleteRequest): Promise<string>;
49
+ /** A JSON answer shaped by `schema`; throws when the reply does not parse. */
50
+ extract(prompt: string, schema: object): Promise<unknown>;
51
+ /** Whether the host's permission gate checks the tool calls of `act`: false, the mode and the
52
+ * session's rules check nothing; undefined when the facade does not say (a test's). */
53
+ permissionGateEnabled(): boolean | undefined;
54
+ }
@@ -0,0 +1,30 @@
1
+ // The typed-memory port: the entries that outlive compaction, and the session when the runtime persists them.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** A typed-memory entry as listed. */
5
+ export interface MemoryEntry {
6
+ /** The id /memory get and delete take; undefined when the host reports none. */
7
+ id?: number;
8
+ /** Undefined when the host reports none. */
9
+ category?: string;
10
+ content: string;
11
+ }
12
+
13
+ /** Typed memory (user, project, feedback, reference), which outlives compaction, and the session when the runtime
14
+ * keeps it per project (`Orkeon:Cli:Memory:Persist`, Orkeon #286). Every call throws when the store cannot answer. */
15
+ export interface MemoryStore {
16
+ /** The entries of one category, or of every category when none is named, in stored order, or the newest first
17
+ * when `newestFirst` is set (Orkeon #286; a release before it keeps the stored order). */
18
+ list(category?: string, options?: { newestFirst?: boolean }): Promise<MemoryEntry[]>;
19
+ /** Store an entry; resolves to its id as the host reports it, as text (`null` or
20
+ * `undefined` when it reports none): /memory add prints it as is. */
21
+ add(category: string, content: string): Promise<string>;
22
+ /** The entry `id` as the host reports it, its own field casing included (/memory get
23
+ * prints it verbatim), else the host's error; undefined when it reports neither. */
24
+ get(id: number): Promise<unknown>;
25
+ /** Delete the entry `id`; false when the host does not report a success. */
26
+ remove(id: number): Promise<boolean>;
27
+ /** Put `content` in place of the entry `id`'s, which keeps its id and category (Orkeon #286); false when the host
28
+ * does not report a success. */
29
+ replace(id: number, content: string): Promise<boolean>;
30
+ }
@@ -0,0 +1,23 @@
1
+ // The progress port: the host's progress line, best effort.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ export interface ProgressSpec {
5
+ /** Headline of the operation, e.g. "Compacting conversation". */
6
+ label: string;
7
+ /** Current step (1-based) for step-wise operations. */
8
+ step?: number;
9
+ /** Total step count, when known. */
10
+ total?: number;
11
+ /** Completion ratio in [0, 100]. */
12
+ percent?: number;
13
+ /** Current-phase line, e.g. "extracting memories". */
14
+ message?: string;
15
+ }
16
+
17
+ /** The host's progress line. Best effort by contract: progress is decoration, so
18
+ * neither call ever throws, and a host without a progress channel ignores both. */
19
+ export interface Progress {
20
+ report(spec: ProgressSpec): Promise<void>;
21
+ /** Release the progress slot of `label`. */
22
+ done(label: string): Promise<void>;
23
+ }
@@ -0,0 +1,15 @@
1
+ // The runtime port: the Orkeon that runs the command, as the host names itself (Orkeon #225).
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ /** The runtime that runs the command: its release, the commit its build metadata carries (null when none)
5
+ * and the channel it was installed through (`deb`, `tarball`, `source`, `dotnet-tool`, `unknown`). */
6
+ export interface RuntimeInfo {
7
+ version: string;
8
+ commit: string | null;
9
+ channel: string;
10
+ }
11
+
12
+ /** The reader of the running runtime; undefined when the host names none, or the read fails. */
13
+ export interface RuntimeInfoReader {
14
+ read(): RuntimeInfo | undefined;
15
+ }