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,52 @@
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
+ import { BASE_BRANCH_UNKNOWN, notAGitHubRepository, originUrlUnreadable } from "./messages.ts";
14
+
15
+ /** The `create_pr` call of the github tool: the url of the pull request opened, or a throw with GitHub's reason. */
16
+ export interface GitHubPullRequests {
17
+ create(args: CreatePrArgs): Promise<{ url: string }>;
18
+ }
19
+
20
+ /** What the decision reads: the session's mode and rules, and whether this run asked the user. */
21
+ export interface PullRequestPolicy {
22
+ mode: string;
23
+ rules: readonly PermissionRule[];
24
+ asked: boolean;
25
+ }
26
+
27
+ /** A remote URL without its `user[:secret]@` part. */
28
+ export function withoutUserInfo(url: string): string {
29
+ return String(url ?? "").trim().replace(/^([a-z][a-z0-9+.-]*:\/\/)[^@/]*@/i, "$1");
30
+ }
31
+
32
+ export function createPullRequestOpener(
33
+ deps: { shell: Pick<Shell, "run">; github: GitHubPullRequests },
34
+ policy: PullRequestPolicy,
35
+ ): PullRequestOpener {
36
+ return {
37
+ async open(pr: PullRequest): Promise<{ url: string }> {
38
+ if (pr.base === null) throw new Error(BASE_BRANCH_UNKNOWN);
39
+ const remote = await runGit(deps.shell, GIT_REMOTE_URL_COMMAND);
40
+ if (remote.exitCode !== 0) throw new Error(originUrlUnreadable(gitReason(remote)));
41
+ const repo = parseGitHubRemote(remote.stdout);
42
+ // The URL is echoed without its user part: a token written there never reaches the terminal.
43
+ if (repo === null) throw new Error(notAGitHubRepository(withoutUserInfo(remote.stdout)));
44
+ const args: CreatePrArgs = {
45
+ action: GITHUB_CREATE_PR, owner: repo.owner, repo: repo.repo, base: pr.base, head: pr.head, title: pr.title, body: pr.body,
46
+ };
47
+ const permission = pullRequestPermission({ ...policy, args });
48
+ if (!permission.ok) throw new Error(permission.reason);
49
+ return deps.github.create(args);
50
+ },
51
+ };
52
+ }
@@ -0,0 +1,59 @@
1
+ // What every act's callbacks know of the host: its layout (host-layout-store.ts) and the user's path lists
2
+ // (agent-policy/path-rules.ts), read together once a run. The identity context, a posix host without mounts and
3
+ // without a list, means the callbacks have nothing to do.
4
+ import type { Files } from "./ports.ts";
5
+ import type { ConfigStore } from "./config-store.ts";
6
+ import { readHostLayout } from "./host-layout-store.ts";
7
+ import { IDENTITY_HOST, isIdentityHost } from "../domain/host-layout.ts";
8
+ import type { HostLayout } from "../domain/host-layout.ts";
9
+ import {
10
+ EMPTY_PATH_LISTS, PATHS_ALLOW_CONFIG_KEY, PATHS_DENY_CONFIG_KEY, readPathLists,
11
+ } from "../domain/agent-policy/path-rules.ts";
12
+ import type { PathListValues, PathLists } from "../domain/agent-policy/path-rules.ts";
13
+
14
+ /** How an adapter reads this run's context: once asked, at the first operation that needs it. */
15
+ export type HostSource = () => Promise<HostContext>;
16
+
17
+ export interface HostContext {
18
+ layout: HostLayout;
19
+ lists: PathLists;
20
+ }
21
+
22
+ export const IDENTITY_CONTEXT: HostContext = Object.freeze({ layout: IDENTITY_HOST, lists: EMPTY_PATH_LISTS }) as HostContext;
23
+
24
+ /** True when the context gives the callbacks nothing to do: no host fact, no list. */
25
+ export function isIdentityContext(host: HostContext): boolean {
26
+ return isIdentityHost(host.layout) && host.lists.deny.length === 0 && host.lists.allow.length === 0;
27
+ }
28
+
29
+ /** The lists of a run's context, for a command's gate: none when no source is given. */
30
+ export async function listsOf(host: HostSource | undefined): Promise<PathLists> {
31
+ return host === undefined ? EMPTY_PATH_LISTS : (await host()).lists;
32
+ }
33
+
34
+ export interface HostContextRead extends HostContext {
35
+ /** The layout's problems, then the lists', each named for /doctor. */
36
+ problems: string[];
37
+ /** launch.json is not JSON. */
38
+ malformed: boolean;
39
+ }
40
+
41
+ /** The two keys of one settings map, string values only (another type is no value: the schema reports it). */
42
+ function pathListValues(map: Record<string, unknown>): PathListValues {
43
+ const text = (key: string): string | undefined => typeof map[key] === "string" ? map[key] as string : undefined;
44
+ return { deny: text(PATHS_DENY_CONFIG_KEY), allow: text(PATHS_ALLOW_CONFIG_KEY) };
45
+ }
46
+
47
+ /** The host context of a run: launch.json, then the lists of the user settings and of the project file over it. */
48
+ export async function readHostContext(
49
+ files: Pick<Files, "read">, config: Pick<ConfigStore, "readFile" | "readUserFile">,
50
+ ): Promise<HostContextRead> {
51
+ const [layout, user, project] = await Promise.all([readHostLayout(files), config.readUserFile(), config.readFile()]);
52
+ const lists = readPathLists(pathListValues(user.map), pathListValues(project.map), layout.layout);
53
+ return {
54
+ layout: layout.layout,
55
+ lists: { deny: lists.deny, allow: lists.allow },
56
+ problems: [...layout.problems, ...lists.problems],
57
+ malformed: layout.malformed,
58
+ };
59
+ }
@@ -0,0 +1,45 @@
1
+ // The host layout the launcher wrote: /user-config/launch.json, beside the user settings, read through the Files
2
+ // port and parsed by the domain (host-layout.ts). A file that is absent, empty or unreadable (no mount, an older
3
+ // launcher, docker mode's empty layout) is the identity: today's behaviour, a posix host whose paths need no
4
+ // spelling back. One that is not JSON is malformed, named for /doctor, and the identity too.
5
+ import type { Files } from "./ports.ts";
6
+ import { IDENTITY_HOST, parseHostLayout } from "../domain/host-layout.ts";
7
+ import type { HostLayout } from "../domain/host-layout.ts";
8
+ import { notJsonNoHostLayout } from "./messages.ts";
9
+
10
+ export const HOST_LAYOUT_FILE_PATH = "/user-config/launch.json";
11
+
12
+ export interface HostLayoutRead {
13
+ layout: HostLayout;
14
+ /** What the parse left out, each named (host-layout.ts), and the file itself when it is not JSON. */
15
+ problems: string[];
16
+ /** The file holds text that is not JSON: nothing of it applies. */
17
+ malformed: boolean;
18
+ }
19
+
20
+ const IDENTITY_READ: HostLayoutRead = { layout: IDENTITY_HOST, problems: [], malformed: false };
21
+
22
+ /** The layout of launch.json, the identity when the file is absent, empty, unreadable or malformed. */
23
+ export async function readHostLayout(files: Pick<Files, "read">): Promise<HostLayoutRead> {
24
+ let content: string;
25
+ try {
26
+ content = (await files.read(HOST_LAYOUT_FILE_PATH)).trim();
27
+ } catch {
28
+ return IDENTITY_READ;
29
+ }
30
+ if (content.length === 0) return IDENTITY_READ;
31
+ let raw: unknown;
32
+ try {
33
+ raw = JSON.parse(content);
34
+ } catch {
35
+ return { layout: IDENTITY_HOST, problems: [notJsonNoHostLayout(HOST_LAYOUT_FILE_PATH)], malformed: true };
36
+ }
37
+ const { layout, problems } = parseHostLayout(raw);
38
+ return { layout, problems, malformed: false };
39
+ }
40
+
41
+ /** A reader of the layout that reads once: every call of every act needs it, and the launcher writes it once a run. */
42
+ export function onceHostLayout(read: () => Promise<HostLayoutRead>): () => Promise<HostLayoutRead> {
43
+ let layout: Promise<HostLayoutRead> | null = null;
44
+ return () => (layout ??= read());
45
+ }
@@ -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,36 @@
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
+ import { couldNotBeReadOrParsed, llmProfileRejected, llmProfileUnreadable } from "./messages.ts";
9
+
10
+ export interface LlmProfileRead {
11
+ /** The profile every agent of the crew runs on; null when the session names none. */
12
+ profile: string | null;
13
+ /** The line to warn with when the setting was not read as a profile. */
14
+ warning?: string;
15
+ }
16
+
17
+ export async function readLlmProfile(config: Pick<ConfigStore, "readValue" | "readFile">): Promise<LlmProfileRead> {
18
+ try {
19
+ const { value, source } = await config.readValue(LLM_PROFILE_CONFIG_KEY);
20
+ if (source === "unset" && (await config.readFile()).malformed) {
21
+ return unreadable(couldNotBeReadOrParsed(CONFIG_FILE_PATH));
22
+ }
23
+ if (typeof value !== "string") return { profile: null };
24
+ const problem = llmProfileProblem(value);
25
+ if (problem !== undefined) {
26
+ return { profile: null, warning: llmProfileRejected(LLM_PROFILE_CONFIG_KEY, problem) };
27
+ }
28
+ return { profile: value.trim() };
29
+ } catch (e: unknown) {
30
+ return unreadable(String((e as { message?: unknown })?.message ?? e));
31
+ }
32
+ }
33
+
34
+ function unreadable(why: string): LlmProfileRead {
35
+ return { profile: null, warning: llmProfileUnreadable(LLM_PROFILE_CONFIG_KEY, why) };
36
+ }
@@ -0,0 +1,14 @@
1
+ // The text the shared application services report to the user: unreadable settings, warnings, where a mode came from.
2
+
3
+ export const couldNotBeReadOrParsed = (path: string): string => `${path} could not be read or parsed`;
4
+ export const notJsonNoHostLayout = (path: string): string => `${path} is not JSON: no host layout applies`;
5
+ export const llmProfileRejected = (key: string, problem: string): string =>
6
+ `${key}: ${problem}; the host's default model this launch`;
7
+ export const llmProfileUnreadable = (key: string, why: string): string =>
8
+ `${key} could not be read (${why}): the host's default model this launch`;
9
+ export const SESSION_DEFAULT_VIA_MODE = "session default via /mode";
10
+
11
+ // Shared by several application folders
12
+ export const cannotBeRead = (path: string, reason: string): string => `${path} cannot be read (${reason})`;
13
+ export const prefixedCannotBeRead = (prefix: string, path: string, reason: string): string => `${prefix}: ${path} cannot be read (${reason})`;
14
+ export const couldNotRun = (command: string, reason: string): string => `${command} could not run: ${reason}`;
@@ -0,0 +1,169 @@
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
+ import { memoryWriteRules } from "../domain/shared-memory/layout.ts";
23
+ import { pathListRules, userConfigRules } from "../domain/agent-policy/path-rules.ts";
24
+ import type { PathLists } from "../domain/agent-policy/path-rules.ts";
25
+
26
+ /** The stored rules, sorted by what the session can do with them. */
27
+ export interface StoredRules {
28
+ /** The rules on a built-in or configured extra tool, in stored order: what the gate is handed. */
29
+ rules: PermissionRule[];
30
+ /** The rules on a tool neither built in nor listed in `tools.extra`, as written: kept, not enforced. */
31
+ dormant: string[];
32
+ /** The entries that are not rules, as written: kept, ignored. */
33
+ invalid: string[];
34
+ }
35
+
36
+ /** Reads the stored rules; a rule names a built-in tool or one of `extraNames`, the configured extra tools. */
37
+ export async function readPermissionRules(
38
+ session: Pick<SessionStore, "readState">,
39
+ extraNames: readonly string[] = [],
40
+ ): Promise<StoredRules> {
41
+ const stored: StoredRules = { rules: [], dormant: [], invalid: [] };
42
+ for (const entry of await readJsonArray(session, PERMISSION_RULES_STATE_KEY)) {
43
+ const rule = parseStoredRule(entry, extraNames);
44
+ if (rule) stored.rules.push(rule);
45
+ else if (readRule(entry)) stored.dormant.push(String(entry));
46
+ else stored.invalid.push(String(entry));
47
+ }
48
+ return stored;
49
+ }
50
+
51
+ /** Rewrites the stored entries, keeping as written every entry `keep` accepts (it
52
+ * reads the rule an entry holds, null for one that is not a rule), then appending
53
+ * `added`; returns the entries left out. */
54
+ async function rewrite(
55
+ session: Pick<SessionStore, "readState" | "writeState">,
56
+ keep: (rule: PermissionRule | null) => boolean,
57
+ added: string[] = [],
58
+ ): Promise<unknown[]> {
59
+ const entries = await readJsonArray(session, PERMISSION_RULES_STATE_KEY);
60
+ const kept = entries.map((entry) => keep(readRule(entry)));
61
+ await writeJson(session, PERMISSION_RULES_STATE_KEY, [...entries.filter((_, i) => kept[i]), ...added]);
62
+ return entries.filter((_, i) => !kept[i]);
63
+ }
64
+
65
+ /** Stores `rule`, in place of any stored rule on the same calls whatever its effect:
66
+ * the list never holds an allow and a deny for the same calls. */
67
+ export async function addPermissionRule(
68
+ session: Pick<SessionStore, "readState" | "writeState">,
69
+ rule: PermissionRule,
70
+ ): Promise<void> {
71
+ await rewrite(session, (stored) => stored === null || !sameCalls(stored, rule), [formatRule(rule)]);
72
+ }
73
+
74
+ /** Removes the stored rules equal to `rule` (effect, tool, argument and pattern),
75
+ * dormant ones included; returns them, empty when there was none. */
76
+ export async function removePermissionRule(
77
+ session: Pick<SessionStore, "readState" | "writeState">,
78
+ rule: PermissionRule,
79
+ ): Promise<PermissionRule[]> {
80
+ const removed = await rewrite(
81
+ session,
82
+ (stored) => stored === null || stored.effect !== rule.effect || !sameCalls(stored, rule),
83
+ );
84
+ return removed.map(readRule).filter((r): r is PermissionRule => r !== null);
85
+ }
86
+
87
+ /** Removes every stored entry. */
88
+ export async function clearPermissionRules(session: Pick<SessionStore, "writeState">): Promise<void> {
89
+ await writeJson(session, PERMISSION_RULES_STATE_KEY, []);
90
+ }
91
+
92
+ /** What a sync left in force, and what it left out. */
93
+ export interface RuleSync extends StoredRules {
94
+ /** False when the host keeps no session rules: the gate decides from the mode alone. */
95
+ applied: boolean;
96
+ /** The built-in deny rules handed over after the session's (empty when not applied): never stored, never
97
+ * listed as the session's, and no /permissions change removes them. */
98
+ builtIn: PermissionRule[];
99
+ /** The session's allow rules left out of the gate because a built-in or a step rule denies the same calls. */
100
+ overridden: PermissionRule[];
101
+ }
102
+
103
+ /** Adds the stored rules in stored order, less a stored allow on the same calls as one of the `denies`; returns
104
+ * the allows left out. */
105
+ function addStored(gate: PermissionRules, stored: readonly PermissionRule[], denies: readonly PermissionRule[]): PermissionRule[] {
106
+ const overridden: PermissionRule[] = [];
107
+ for (const rule of stored) {
108
+ const denied = rule.effect === "allow" && denies.some((d) => d.effect === "deny" && sameCalls(d, rule));
109
+ if (denied) overridden.push(rule);
110
+ else gate.add(rule);
111
+ }
112
+ return overridden;
113
+ }
114
+
115
+ /** Makes the gate hold the stored rules, then the built-in ones: clear it, add each stored rule in stored order
116
+ * (less a stored allow on the same calls as a built-in deny), then each built-in rule. */
117
+ export async function syncPermissionRules(deps: {
118
+ session: Pick<SessionStore, "readState">;
119
+ gate: PermissionRules;
120
+ /** The configured extra tools, which rules may name. */
121
+ extraNames?: readonly string[];
122
+ /** Deny rules every sync adds, whatever the mode (the shared memory's folders: memoryWriteRules). */
123
+ builtIn?: readonly PermissionRule[];
124
+ }): Promise<RuleSync> {
125
+ const stored = await readPermissionRules(deps.session, deps.extraNames);
126
+ if (!deps.gate.available()) return { ...stored, applied: false, builtIn: [], overridden: [] };
127
+ const builtIn = [...(deps.builtIn ?? [])];
128
+ deps.gate.clear();
129
+ const overridden = addStored(deps.gate, stored.rules, builtIn);
130
+ for (const rule of builtIn) deps.gate.add(rule);
131
+ return { ...stored, applied: true, builtIn, overridden };
132
+ }
133
+
134
+ /** What a step's sync left in force. `rules`, `dormant`, `invalid` are the session's, as syncPermissionRules
135
+ * reports them; `step` the step's rules handed over (empty when not applied); `overridden` the session's
136
+ * allow rules left out of the gate because a step rule or a built-in one denies the same calls. */
137
+ export interface StepRuleSync extends RuleSync {
138
+ step: PermissionRule[];
139
+ }
140
+
141
+ /**
142
+ * Makes the gate hold the session's rules, then a step's, then the built-in ones: clear it, add each stored rule
143
+ * in stored order (less a stored allow on the same calls as a step or built-in deny), then add each step rule in
144
+ * order, then each built-in rule. The step's rules are never stored: the next syncPermissionRules (the next
145
+ * /assistant turn, the next /permissions change) hands the gate the session's rules and the built-in ones alone.
146
+ */
147
+ export async function syncStepRules(deps: {
148
+ session: Pick<SessionStore, "readState">;
149
+ gate: PermissionRules;
150
+ extraNames?: readonly string[];
151
+ rules: readonly PermissionRule[];
152
+ builtIn?: readonly PermissionRule[];
153
+ }): Promise<StepRuleSync> {
154
+ const stored = await readPermissionRules(deps.session, deps.extraNames);
155
+ if (!deps.gate.available()) return { ...stored, applied: false, step: [], builtIn: [], overridden: [] };
156
+ const builtIn = [...(deps.builtIn ?? [])];
157
+ deps.gate.clear();
158
+ const overridden = addStored(deps.gate, stored.rules, [...deps.rules, ...builtIn]);
159
+ for (const rule of deps.rules) deps.gate.add(rule);
160
+ for (const rule of builtIn) deps.gate.add(rule);
161
+ return { ...stored, applied: true, step: [...deps.rules], builtIn, overridden };
162
+ }
163
+
164
+ /** The rules every sync puts in the gate after the session's: the shared memory's guard (no tool of the model writes
165
+ * its candidates or entries), the whole /user-config mount closed, and the user's paths.deny on the canonical
166
+ * spelling (agent-policy/path-rules.ts). */
167
+ export function builtInRules(memoryDir: string, lists: PathLists): PermissionRule[] {
168
+ return [...memoryWriteRules(memoryDir), ...userConfigRules(), ...pathListRules(lists)];
169
+ }
@@ -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,14 @@
1
+ // The decision port: the host's decision model, asked typed questions about a state.
2
+ // Types only, re-exported by ../ports.ts.
3
+
4
+ import type { DecisionAnswers, DecisionQuestions } from "../../domain/decision/questions.ts";
5
+
6
+ /** The decision model the host's settings configure (`Orkeon:Decision`), whichever provider serves it. A use case
7
+ * that asks it keeps working without it: no model, a failed call and an unreadable answer are all `null`. */
8
+ export interface DecisionModel {
9
+ /** Whether the host has a decision model to ask. */
10
+ available(): boolean;
11
+ /** Ask `questions` about `state` (a text, or any JSON value) in one request; resolves to every answer by the
12
+ * name of its question, or to null. Never throws. */
13
+ ask(state: unknown, questions: DecisionQuestions): Promise<DecisionAnswers | null>;
14
+ }
@@ -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
+ }