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,10 @@
1
+ # The Orkeon runtime the launcher downloads at the first start when the machine has none (ADR 0028).
2
+ # id: the seven characters of the pin the archives were built from; url: the folder holding
3
+ # orkeon-runtime-<id>-<platform>.tar.gz; then one SHA-256 per platform. The release workflow fills this file
4
+ # before it publishes; in a checkout the id is empty, and nothing is downloaded.
5
+ id=
6
+ url=
7
+ linux-x64=
8
+ linux-arm64=
9
+ osx-x64=
10
+ osx-arm64=
@@ -0,0 +1 @@
1
+ a9f3878aca94c81d5c23fa0b858b59b8a78d5122
package/LICENSE.md ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Orkeon Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/NOTICE.md ADDED
@@ -0,0 +1,17 @@
1
+ # Notice
2
+
3
+ Orkeon Code
4
+ Copyright (c) 2026 Orkeon Contributors. Licensed under the MIT License (see [LICENSE.md](LICENSE.md)).
5
+
6
+ Orkeon Code runs on the [Orkeon](https://github.com/Orkeon/orkeon) runtime (MIT), which is distributed separately
7
+ (the release archives, the `orkeon` container image, the apt package, the .NET tools) with its own
8
+ third-party notices.
9
+
10
+ This repository ships TypeScript sources, and the Python sources of its speech MCP server (`mcp/whisper/`). Its
11
+ development dependencies (esbuild, MIT; TypeScript, Apache-2.0; `@types/node`, MIT) are not redistributed, nor are
12
+ the server's, which uv resolves on each machine: `mcp` (MIT), faster-whisper (MIT) and, as optional extras, openai
13
+ (Apache-2.0), sounddevice (MIT), NVIDIA's cuBLAS and cuDNN wheels (NVIDIA's own licence) and piper-tts (GPL-3.0),
14
+ which the server runs as a separate process and never imports. The 5-second sample `mcp/whisper/samples/fr-5s.wav`
15
+ is CC0 ([samples/README.md](mcp/whisper/samples/README.md)).
16
+
17
+ Orkeon Code is an independent project. Product names mentioned in its documentation belong to their owners.
package/README.fr.md ADDED
@@ -0,0 +1,163 @@
1
+ > 🇬🇧 [English version](README.md)
2
+
3
+ # Orkeon Code
4
+
5
+ [![CI](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml/badge.svg)](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml)
6
+ [![Licence : MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
7
+ [![Documentation](https://img.shields.io/badge/documentation-orkeon.github.io-blue.svg)](https://orkeon.github.io/orkeon-code/)
8
+
9
+ <p align="center">
10
+ <img src="docs/assets/kama-surfer-docker.jpg" alt="Mascotte d'Orkeon Code — un caméléon qui surfe sur une vague" width="320">
11
+ </p>
12
+
13
+ **Un assistant de code agentique en TypeScript sur le runtime [Orkeon](https://github.com/Orkeon/orkeon).**
14
+ Travaillez avec lui dans le terminal sous le mode de permission de votre choix, laissez-le mener une tâche jusqu'au
15
+ bout tout seul, ou lancez ses crews depuis un script, un planificateur ou votre propre application. Il lit, cherche,
16
+ modifie et exécute le code de votre projet par appels d'outils, et tout ce qu'il peut toucher est déclaré : un projet
17
+ monté, un shell sous liste blanche, un catalogue d'outils réduit selon le mode. Chaque commande, chaque crew et
18
+ chaque prompt est un fichier source : modifiez-le, ou ajoutez le vôtre.
19
+
20
+ > **Statut : release candidate.** La boucle, les crews et les modes de permission fonctionnent de bout en bout sur de vrais LLM.
21
+ > Des aspérités et des changements cassants restent possibles avant la 1.0.
22
+
23
+ ## Ce qu'il fait
24
+
25
+ - **`/assistant`** : la boucle interactive. Le modèle explore le code avec les outils de recherche et d'intelligence
26
+ de code (recherche hybride, source d'un symbole, graphes d'appels, analyse d'impact), modifie des fichiers et lance
27
+ des commandes, tour après tour, sous un budget d'exécution. Le texte libre saisi sans `/` initial y est envoyé.
28
+ - **Modes de permission** : `plan` (lecture seule), `default` (vous demande avant une modification, une commande ou
29
+ un appel réseau), `acceptEdits` (modifie sans demander), `dontAsk`, `bypassPermissions`, choisis par requête
30
+ (`plan: explique le flux d'authentification`) ou pour la session (`/mode`), plus des règles autoriser/refuser sur un
31
+ outil ou sur ses arguments (`allow shell_command command=npm test*`). Le runtime Orkeon les applique et pose les
32
+ questions.
33
+ - **Des outils de serveurs MCP et de plugins** : les outils qu'Orkeon connecte (`MCP:Servers`, `Plugins`) rejoignent
34
+ le catalogue de l'assistant dès que `tools.extra` les nomme
35
+ ([Configuration](docs/fr/configuration.md#outils-supplémentaires--serveurs-mcp-et-plugins)).
36
+ - **La transcription de la parole** : un serveur MCP Whisper est livré dans `mcp/whisper/` ; `ORKEON_CODE_AUDIO_DIR`
37
+ l'active, et l'assistant transcrit notes vocales, réunions et vidéos d'écran sur votre machine ; `/voice` dicte une
38
+ requête et `/say` lit à voix haute ([Configuration](docs/fr/speech.md#transcription-de-la-parole)).
39
+ - **Des crews pour les tâches récurrentes** : `/init` (décrire le projet pour l'agent), `/commit` (un commit
40
+ conventionnel tiré du diff), `/review` (revue de code multi-angles ; `--lens security` pour le seul angle sécurité), `/analyze`
41
+ (analyse déterministe du code), `/compact` et `/summary` (gestion du contexte), `/init-verifiers`, `/advisor`.
42
+ - **Un workflow dev, étape par étape** : `/dev-spec` écrit la spec ou la fiche de changement,
43
+ `/dev-plan` la découpe en lots qu'un relecteur en lecture seule questionne, `/dev-batches` exécute les lots d'un
44
+ plan l'un après l'autre, chacun en test d'abord (tests rouges, puis le moindre code, puis un audit en lecture seule)
45
+ et clos par un commit (`<code> F<n>` un lot, `<code> F<n> --audit` son audit seul), `/dev-status` dit où en
46
+ est un travail et `/dev-learn` propose des règles à partir des écarts récurrents des audits. Chaque étape s'exécute
47
+ sous des règles de refus que son crew vérifie à nouveau
48
+ ([Permissions](docs/fr/permissions.md#jeux-de-règles-des-étapes-dev)).
49
+ - **Une mémoire partagée** : décisions, structures, méthodes et erreurs que les étapes retrouvent, admises seulement
50
+ par `/memory admit` ([Mémoire partagée](docs/fr/shared-memory.md)).
51
+ - **Gestion du contexte** : compaction automatique avec disjoncteur, `/compact` qui résume toute la session
52
+ (la troncature est `/compact --snip`, ou le repli d'un résumé en échec), restauration des fichiers après
53
+ compaction, paliers de pression du contexte, mémoire typée tenue par le processus Orkeon (`/memory`).
54
+ - **50 commandes slash** au total : [docs/fr/commands.md](docs/fr/commands.md).
55
+
56
+ ## Démarrage rapide
57
+
58
+ Il faut le runtime Orkeon et une clé d'API pour un fournisseur LLM pris en charge par Orkeon (tout point d'accès
59
+ compatible OpenAI, Anthropic...). Le runtime s'obtient par une release (`orkeon-repl`), par une image Docker ou
60
+ depuis un checkout d'Orkeon ; sous Windows, la voie que ce projet pratique est WSL
61
+ ([tutoriel](docs/fr/wsl-tutorial.md)). Le choix du runtime, ses versions et ses canaux, et les façons d'installer
62
+ Orkeon Code lui-même sont dans [Premiers pas](docs/fr/getting-started.md). Depuis un clone :
63
+
64
+ ```bash
65
+ git clone https://github.com/Orkeon/orkeon-code.git ~/orkeon-code
66
+ cd ~/orkeon-code
67
+ cp config/appsettings.example.json config/appsettings.local.json # choisir le modèle et le point d'accès
68
+ export DEEPSEEK_API_KEY=... # la variable nommée par Llm:ApiKeyEnvVar
69
+
70
+ ./orkeon-code --demo # l'essayer sur un dépôt d'exemple jetable
71
+ cd ~/src/mon-projet && ~/orkeon-code/orkeon-code # ou sur votre projet
72
+ ```
73
+
74
+ Puis, dans le REPL (*Read–Eval–Print Loop* : la boucle interactive lire-évaluer-afficher) :
75
+
76
+ ```text
77
+ /init décrire le projet (écrit AGENTS.md)
78
+ plan: comment la configuration est-elle chargée ? question en lecture seule
79
+ acceptEdits: valide les entrées de parseArgs et ajoute un test
80
+ /diff
81
+ /commit
82
+ /review
83
+ ```
84
+
85
+ ## Fonctionnement
86
+
87
+ ```text
88
+ vous ──▶ /commande ──▶ *.cmd.ts (src/commands) ──script-host──▶ crew.ork.ts (src/crews)
89
+ │ ctx.llm.act() : boucle LLM ⇄ outils
90
+ ▼
91
+ runtime Orkeon (.NET) : outils, garde de permission, VFS, fournisseurs LLM
92
+ │
93
+ /workspace = votre projet
94
+ ```
95
+
96
+ Orkeon Code est la couche TypeScript : les commandes slash, les crews et la logique de domaine partagée. Le runtime
97
+ [Orkeon](https://github.com/Orkeon/orkeon) les exécute (Jint), fournit les outils, applique la garde de permission et
98
+ confine tout accès fichier au projet monté. Le runtime est épinglé dans [`.orkeon-version`](.orkeon-version), un
99
+ commit du `main` d'Orkeon.
100
+ Détails : [Architecture](docs/fr/architecture.md).
101
+
102
+ ## Interactif, autonome, embarqué
103
+
104
+ Le REPL est une façon de lancer les crews, pas la seule.
105
+
106
+ - **Interactif** : `./orkeon-code` sur votre projet. `plan:` pour demander, `acceptEdits:` pour le laisser modifier,
107
+ `/mode` pour la session ; en mode `default`, le runtime vous demande avant une modification, une commande ou un
108
+ appel réseau.
109
+ - **Autonome** : en `bypassPermissions`, la boucle mène une tâche jusqu'au bout sans poser de question, sous un budget
110
+ (200 appels d'outils, 30 minutes, 700k tokens de contexte) et la garde du runtime. `scripts/run-crew.sh` lance le même crew en un
111
+ coup depuis un shell, une ligne de cron ou un job de CI, et imprime son résultat en JSON.
112
+ - **Embarqué** : une application lance l'outil `orkeon` (nuget.org) ou l'image `orkeon` sur un crew et lit le
113
+ JSON ; le démon `orkeon-host` d'Orkeon peut héberger les crews derrière un canal de chat ou un point d'accès A2A.
114
+ L'intégration .NET en processus attend que la couche de scripting soit publiée en paquet.
115
+
116
+ Détails et limites : [Exécutions autonomes et embarquées](docs/fr/headless.md).
117
+
118
+ ## Faites-en le vôtre
119
+
120
+ Une commande est un fichier dans `src/commands`, un crew un dossier dans `src/crews`, un outil un `toolBuilder()`
121
+ dans un crew, un prompt une chaîne avec son test, et les modes de permission une table de noms d'outils. Pas d'étape
122
+ de build : le runtime bundle le TypeScript et l'exécute au prochain démarrage. Vos propres crews et commandes peuvent
123
+ vivre hors du checkout (`--crews-dir`, `--commands-dir`), et les outils des serveurs MCP et des plugins rejoignent le
124
+ catalogue dès que `tools.extra` les nomme, sans une ligne de code. Ce qui bouge à chaque changement, et les limites :
125
+ [Étendre Orkeon Code](docs/fr/extending.md).
126
+
127
+ ## Documentation
128
+
129
+ La documentation est publiée en français et en anglais, en site consultable, avec recherche :
130
+ <https://orkeon.github.io/orkeon-code/>. Les pages ci-dessous sont les françaises ; les mêmes existent
131
+ [en anglais](docs/README.md), et les décisions (ADR) ne sont écrites qu'en anglais.
132
+
133
+ | | |
134
+ |---|---|
135
+ | [Premiers pas](docs/fr/getting-started.md) | Modes docker, tool et source, première session |
136
+ | [Tutoriel WSL](docs/fr/wsl-tutorial.md) | La voix et un modèle local sous WSL2, sur le GPU, pas à pas |
137
+ | [Configuration](docs/fr/configuration.md) | Fournisseurs LLM, fichier de settings, variables d'environnement |
138
+ | [Voix](docs/fr/speech.md) | Transcrire un fichier, dicter une requête, lire une réponse à voix haute |
139
+ | [Modèles de décision](docs/fr/decision-models.md) | Ce qu'Orkeon Code demande à un modèle de décision : élaguer un long tour, router un crew, suggérer des skills, avec ce qui a été mesuré |
140
+ | [Modèles de décision en local](docs/fr/decision-models-local.md) | Kev sur cette machine et Liquid, pas à pas, avec des profils de décision à essayer |
141
+ | [Permissions](docs/fr/permissions.md) | Modes, règles, ce que l'agent peut toucher |
142
+ | [Référence des permissions](docs/fr/permissions-reference.md) | L'ordre des contrôles, ce que lit une règle, chaque règle des jeux des étapes dev |
143
+ | [Hooks](docs/fr/hooks.md) | Vos commandes autour des appels d'outils du modèle dans les étapes dev |
144
+ | [Mémoire partagée](docs/fr/shared-memory.md) | Décisions, structures, méthodes et erreurs admises que les agents rappellent |
145
+ | [Commandes](docs/fr/commands.md) | La liste complète (générée) |
146
+ | [Architecture](docs/fr/architecture.md) | Couches, ports, points d'entrée, le VFS, les crews |
147
+ | [Le déroulement d'un tour](docs/fr/turn.md) | La boucle, l'assemblage du prompt, le routage, la suggestion de skills, la compaction |
148
+ | [Les prompts des crews](docs/fr/crew-prompts.md) | Le comportement d'après lequel le prompt de chaque crew est écrit |
149
+ | [Recettes](docs/fr/recipes.md) | Ajouter une commande, un crew, un outil, un mode, un bloc de prompt, une clé de configuration, un port |
150
+ | [Exécutions autonomes et embarquées](docs/fr/headless.md) | Tours sans opérateur, lancement en un coup, planificateurs et CI, votre application |
151
+ | [Étendre](docs/fr/extending.md) | Commandes, crews, outils, prompts, modes, vos propres dossiers, les limites |
152
+ | [Développement](docs/fr/development.md) | Tests, vérifications, typings, montée de version d'Orkeon, release |
153
+ | [Feuille de route](docs/fr/roadmap.md) | Ce qui manque et ce qui vient |
154
+
155
+ ## Contribuer
156
+
157
+ Issues et pull requests sont bienvenues : lisez d'abord [CONTRIBUTING.md](CONTRIBUTING.md). Un problème du runtime
158
+ lui-même (outils, VFS, fournisseurs, hôte REPL) relève d'[Orkeon/orkeon](https://github.com/Orkeon/orkeon/issues). Les
159
+ signalements de sécurité suivent [SECURITY.md](SECURITY.md).
160
+
161
+ ## Licence
162
+
163
+ [MIT](LICENSE.md) © 2026 Orkeon Contributors.
package/README.md CHANGED
@@ -1,3 +1,157 @@
1
- # Temporary Holding Version
1
+ > 🇫🇷 [Version française](README.fr.md)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ # Orkeon Code
4
+
5
+ [![CI](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml/badge.svg)](https://github.com/Orkeon/orkeon-code/actions/workflows/ci.yml)
6
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
7
+ [![Documentation](https://img.shields.io/badge/documentation-orkeon.github.io-blue.svg)](https://orkeon.github.io/orkeon-code/)
8
+
9
+ <p align="center">
10
+ <img src="docs/assets/kama-surfer-docker.jpg" alt="Orkeon Code mascot — a chameleon surfing a wave" width="320">
11
+ </p>
12
+
13
+ **An agentic coding assistant in TypeScript on the [Orkeon](https://github.com/Orkeon/orkeon) runtime.** Pair with
14
+ it in the terminal under a permission mode you choose, let it run a task to the end on its own, or start its crews
15
+ from a script, a scheduler or your own application. It reads, searches, edits and runs code in your project through
16
+ tool calls, and everything it can touch is declared: one mounted project, an allow-listed shell, a tool catalogue
17
+ trimmed by the mode. Every command, crew and prompt is a source file: change it, or add yours.
18
+
19
+ > **Status: release candidate.** The loop, the crews and the permission modes work end to end against real LLMs. Rough
20
+ > edges and breaking changes remain possible before 1.0.
21
+
22
+ ## What it does
23
+
24
+ - **`/assistant`**: the interactive loop. The model explores the code with search and code-intelligence tools
25
+ (hybrid code search, symbol source, call graphs, impact analysis), edits files and runs commands, turn after turn,
26
+ under an execution budget. Free text typed without a leading `/` goes there.
27
+ - **Permission modes**: `plan` (read-only), `default` (asks you before an edit, a command or a network call),
28
+ `acceptEdits` (edits without asking), `dontAsk`, `bypassPermissions`, chosen per request
29
+ (`plan: explain the auth flow`) or for the session (`/mode`), plus allow/deny rules on a tool or on its arguments
30
+ (`allow shell_command command=npm test*`). The Orkeon runtime enforces them and asks the questions.
31
+ - **Tools from MCP servers and plugins**: the tools Orkeon connects (`MCP:Servers`, `Plugins`) join the assistant's
32
+ catalogue once `tools.extra` names them ([Configuration](docs/configuration.md#extra-tools-mcp-servers-and-plugins)).
33
+ - **Speech-to-text**: a Whisper MCP server ships in `mcp/whisper/`; `ORKEON_CODE_AUDIO_DIR` turns it on, and the
34
+ assistant transcribes voice notes, meetings and screen recordings on your machine; `/voice` dictates a request
35
+ and `/say` reads aloud ([Configuration](docs/speech.md#speech-to-text)).
36
+ - **Crews for the recurring jobs**: `/init` (describe the project for the agent), `/commit` (a conventional commit
37
+ from the diff), `/review` (multi-lens code review; `--lens security` for the security lens alone), `/analyze` (deterministic
38
+ codebase analysis), `/compact` and `/summary` (context management), `/init-verifiers`, `/advisor`.
39
+ - **A dev workflow, step by step**: `/dev-spec` writes the spec or the change brief, `/dev-plan`
40
+ cuts it into batches a read-only reviewer questions, `/dev-batches` runs a plan's batches one after the other, each
41
+ test-first (red tests, then the least code, then a read-only audit) and closed with a commit (`<code> F<n>` one
42
+ batch, `<code> F<n> --audit` its audit alone), `/dev-status` says where a piece of work stands and `/dev-learn` proposes rules
43
+ from the audits' recurring gaps. Each step runs under deny rules its crew checks again
44
+ ([Permissions](docs/permissions.md#rule-sets-of-the-dev-steps)).
45
+ - **A shared memory**: decisions, structures, methods and mistakes the steps recall, admitted only through
46
+ `/memory admit` ([Shared memory](docs/shared-memory.md)).
47
+ - **Context management**: automatic compaction with a circuit breaker, a `/compact` that summarises the whole session
48
+ (the snip is `/compact --snip`, or the fallback of a failed summary), file restore after compaction, context
49
+ pressure tiers, typed memory held by the Orkeon process (`/memory`).
50
+ - **50 slash commands** in all: [docs/commands.md](docs/commands.md).
51
+
52
+ ## Quick start
53
+
54
+ You need the Orkeon runtime and an API key for an LLM provider Orkeon supports (any OpenAI-compatible endpoint,
55
+ Anthropic...). The runtime comes as a release (`orkeon-repl`), as a Docker image or from an Orkeon checkout; on
56
+ Windows, the path this project exercises is WSL ([tutorial](docs/wsl-tutorial.md)). Which runtime to pick, its
57
+ versions and channels, and the ways to install Orkeon Code itself are in
58
+ [Getting started](docs/getting-started.md). From a clone:
59
+
60
+ ```bash
61
+ git clone https://github.com/Orkeon/orkeon-code.git ~/orkeon-code
62
+ cd ~/orkeon-code
63
+ cp config/appsettings.example.json config/appsettings.local.json # pick the model and endpoint
64
+ export DEEPSEEK_API_KEY=... # the variable named by Llm:ApiKeyEnvVar
65
+
66
+ ./orkeon-code --demo # try it on a throwaway sample repository
67
+ cd ~/src/my-project && ~/orkeon-code/orkeon-code # or on your project
68
+ ```
69
+
70
+ Then, in the REPL (Read–Eval–Print Loop — the interactive console):
71
+
72
+ ```text
73
+ /init describe the project (writes AGENTS.md)
74
+ plan: how is the configuration loaded? read-only question
75
+ acceptEdits: add input validation to parseArgs and a test for it
76
+ /diff
77
+ /commit
78
+ /review
79
+ ```
80
+
81
+ ## How it works
82
+
83
+ ```text
84
+ you ──▶ /command ──▶ *.cmd.ts (src/commands) ──script-host──▶ crew.ork.ts (src/crews)
85
+ │ ctx.llm.act(): LLM ⇄ tools loop
86
+ ▼
87
+ Orkeon runtime (.NET): tools, permission gate, VFS, LLM providers
88
+ │
89
+ /workspace = your project
90
+ ```
91
+
92
+ Orkeon Code is the TypeScript layer: slash commands, crews and the shared domain logic they use. The
93
+ [Orkeon](https://github.com/Orkeon/orkeon) runtime executes them (Jint), provides the tools, enforces the permission
94
+ gate and confines every file access to the mounted project. The runtime is pinned in
95
+ [`.orkeon-version`](.orkeon-version), a commit of Orkeon's `main`. Details: [Architecture](docs/architecture.md).
96
+
97
+ ## Interactive, autonomous, embedded
98
+
99
+ The REPL is one way to run the crews, not the only one.
100
+
101
+ - **Interactive**: `./orkeon-code` on your project. `plan:` to ask, `acceptEdits:` to let it edit, `/mode` for the
102
+ session; in `default` mode the runtime asks you before an edit, a command or a network call.
103
+ - **Autonomous**: in `bypassPermissions` the loop runs a task to the end without a question, under a budget (200 tool
104
+ calls, 30 minutes, 700k context tokens) and the host gate. `scripts/run-crew.sh` runs the same crew in one shot from a shell, a
105
+ cron line or a CI job, and prints its result as JSON.
106
+ - **Embedded**: an application starts the `orkeon` tool (nuget.org) or the `orkeon` image on a crew and reads
107
+ the JSON; Orkeon's `orkeon-host` daemon can host the crews behind a chat channel or an A2A endpoint. In-process
108
+ .NET embedding waits for the scripting layer to ship as a package.
109
+
110
+ Details and limits: [Autonomous and embedded runs](docs/headless.md).
111
+
112
+ ## Make it yours
113
+
114
+ A command is a file in `src/commands`, a crew is a folder in `src/crews`, a tool is a `toolBuilder()` in a crew, a
115
+ prompt is a string with its test, and the permission modes are a table of tool names. There is no build step: the
116
+ runtime bundles the TypeScript and runs it at the next start. Your own crews and commands can live outside the
117
+ checkout (`--crews-dir`, `--commands-dir`), and the tools of MCP servers and plugins join the catalogue once
118
+ `tools.extra` names them, without a line of code. What moves with each change, and the limits:
119
+ [Extending Orkeon Code](docs/extending.md).
120
+
121
+ ## Documentation
122
+
123
+ The pages below are published as a browsable site, with a search box:
124
+ <https://orkeon.github.io/orkeon-code/>. The same pages exist [in French](docs/fr/README.md); the decisions (ADR)
125
+ are written in English only.
126
+
127
+ | | |
128
+ |---|---|
129
+ | [Getting started](docs/getting-started.md) | Docker, tool and source modes, first session |
130
+ | [WSL tutorial](docs/wsl-tutorial.md) | Speech and a local model on WSL2, on the GPU, step by step |
131
+ | [Configuration](docs/configuration.md) | LLM providers, settings file, environment variables |
132
+ | [Speech](docs/speech.md) | Transcribing a file, dictating a request, reading an answer aloud |
133
+ | [Decision models](docs/decision-models.md) | What Orkeon Code asks a decision model: pruning a long turn, routing a crew, suggesting skills, with what was measured |
134
+ | [Decision models locally](docs/decision-models-local.md) | Kev on this machine and Liquid, step by step, with decision profiles to try |
135
+ | [Permissions](docs/permissions.md) | Modes, rules, what the agent can touch |
136
+ | [Permissions reference](docs/permissions-reference.md) | The order of the checks, what a rule reads, every rule of the dev steps' rule sets |
137
+ | [Hooks](docs/hooks.md) | Your commands around the model's tool calls in the dev steps |
138
+ | [Shared memory](docs/shared-memory.md) | Admitted decisions, structures, methods and mistakes the agents recall |
139
+ | [Slash commands](docs/commands.md) | The full list (generated) |
140
+ | [Architecture](docs/architecture.md) | Layers, ports, entry points, the VFS, crews |
141
+ | [How a turn runs](docs/turn.md) | The loop, prompt assembly, routing, skill suggestion, compaction |
142
+ | [Crew prompts](docs/crew-prompts.md) | The behaviour each crew's prompt is written from |
143
+ | [Recipes](docs/recipes.md) | Add a command, a crew, a tool, a mode, a prompt block, a config key, a port |
144
+ | [Autonomous and embedded runs](docs/headless.md) | Unattended turns, one-shot runs, schedulers and CI, your application |
145
+ | [Extending](docs/extending.md) | Commands, crews, tools, prompts, modes, your own directories, the limits |
146
+ | [Development](docs/development.md) | Tests, checks, typings, upgrading Orkeon, releasing |
147
+ | [Roadmap](docs/roadmap.md) | What is missing and what comes next |
148
+
149
+ ## Contributing
150
+
151
+ Issues and pull requests are welcome: read [CONTRIBUTING.md](CONTRIBUTING.md) first. A problem in the runtime itself
152
+ (tools, VFS, providers, the REPL host) belongs to [Orkeon/orkeon](https://github.com/Orkeon/orkeon/issues). Security
153
+ reports follow [SECURITY.md](SECURITY.md).
154
+
155
+ ## License
156
+
157
+ [MIT](LICENSE.md) © 2026 Orkeon Contributors.
@@ -0,0 +1,77 @@
1
+ {
2
+ "_comment": "Orkeon Code on Claude, through the API credits of a Max plan. Since October 2026 a Max plan includes monthly API credits (100 USD on Max 5x, 200 USD on Max 20x, no rollover), spent through an API key of the Anthropic Console organisation linked to the plan: on claude.ai, Settings, Billing, API credits, Link organization (the link is made once, only the support changes it), then create a key in that organisation. The key goes in the environment, export ANTHROPIC_API_KEY=..., never in this file; beyond the credits the key is billed at the API's usage rates. Signing in with the plan itself is reserved to Anthropic's own applications, so it is not a way to run Orkeon Code. Copy this file to config/appsettings.local.json (ignored by git), or pass it with --settings. Orkeon recognises Anthropic by its address; every agent of Orkeon Code asks it to cache its system prompt and its tools (cache_control), and Orkeon reads the tokens it served, so /usage and /context show cacheRead and cacheWrite. No Temperature: the current Claude generation refuses one, and Orkeon sends only what the file sets. The AvailableModels are the other Claude models /model switches to: claude-fable-5-1 is the most capable and costs about two and a half times claude-opus-5-5 per token, so it empties the monthly credits faster, and it needs an organisation with the standard 30-day data retention (one under zero data retention gets a 400). /effort sets the thinking effort. The other sections are those of config/appsettings.example.json; every key is explained in docs/configuration.md.",
3
+ "Llm": {
4
+ "Model": "claude-opus-5-5",
5
+ "BaseUrl": "https://api.anthropic.com",
6
+ "ApiKeyEnvVar": "ANTHROPIC_API_KEY",
7
+ "AvailableModels": [
8
+ "claude-opus-5-5",
9
+ "claude-fable-5-1",
10
+ "claude-sonnet-5-5",
11
+ "claude-haiku-5-5"
12
+ ],
13
+ "MaxTokens": 24576,
14
+ "TimeoutSeconds": 600,
15
+ "MaxRateLimitWait": "00:05:00"
16
+ },
17
+ "RateLimiting": {
18
+ "MaxConcurrentRequests": 16,
19
+ "GlobalRequestsPerMinute": 300,
20
+ "ProviderRequestsPerMinute": 300,
21
+ "AgentRequestsPerMinute": 10,
22
+ "QueueLimit": 512
23
+ },
24
+ "Orkeon": {
25
+ "Rag": {
26
+ "Retrieval": {
27
+ "MinScore": 0.6
28
+ }
29
+ },
30
+ "Scripting": {
31
+ "Limits": {
32
+ "ExecutionTimeout": "00:30:00",
33
+ "MemoryLimitBytes": 2147483648
34
+ }
35
+ },
36
+ "Security": {
37
+ "PermissionGate": {
38
+ "Enabled": true
39
+ }
40
+ },
41
+ "Tools": {
42
+ "Shell": {
43
+ "AllowInterpreters": true,
44
+ "ExtraAllowedCommands": [
45
+ "make"
46
+ ],
47
+ "Confinement": {
48
+ "Mode": "None"
49
+ }
50
+ },
51
+ "ResultLimits": {
52
+ "MaxParallelToolCalls": 4,
53
+ "Limits": {
54
+ "shell_command": 10000
55
+ }
56
+ }
57
+ },
58
+ "Cli": {
59
+ "ConsoleStreaming": {
60
+ "Enabled": true
61
+ },
62
+ "Session": {
63
+ "Persist": true
64
+ },
65
+ "Memory": {
66
+ "Persist": true,
67
+ "RootDirectory": "/workspace/.orkeon/typed-memory"
68
+ },
69
+ "ScriptCommands": {
70
+ "Limits": {
71
+ "ExecutionTimeout": "00:30:00",
72
+ "MemoryLimitBytes": 2147483648
73
+ }
74
+ }
75
+ }
76
+ }
77
+ }
@@ -0,0 +1,71 @@
1
+ {
2
+ "_comment": "Orkeon Code settings template. Copy it to config/appsettings.local.json (ignored by git) and adjust the Llm section. The API key never goes in this file: ApiKeyEnvVar names the environment variable that holds it, and ORKEON_Llm__ApiKey, when set, wins over everything. Any OpenAI-compatible endpoint works through BaseUrl; see docs/configuration.md for the providers Orkeon supports, and for the MCP:Servers and Plugins sections whose tools the tools.extra session key offers to the assistant. Every key below is explained in docs/configuration.md: Orkeon refuses a key it does not know inside its sections, so this file carries no other comment.",
3
+ "Llm": {
4
+ "Model": "deepseek-v4-flash",
5
+ "BaseUrl": "https://api.deepseek.com",
6
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
7
+ "AvailableModels": ["deepseek-v4-flash", "deepseek-v4-pro"],
8
+ "Temperature": 0.2,
9
+ "MaxTokens": 24576,
10
+ "TimeoutSeconds": 600,
11
+ "MaxRateLimitWait": "00:05:00"
12
+ },
13
+ "RateLimiting": {
14
+ "MaxConcurrentRequests": 16,
15
+ "GlobalRequestsPerMinute": 300,
16
+ "ProviderRequestsPerMinute": 300,
17
+ "AgentRequestsPerMinute": 10,
18
+ "QueueLimit": 512
19
+ },
20
+ "Orkeon": {
21
+ "Rag": {
22
+ "Retrieval": {
23
+ "MinScore": 0.6
24
+ }
25
+ },
26
+ "Scripting": {
27
+ "Limits": {
28
+ "ExecutionTimeout": "00:30:00",
29
+ "MemoryLimitBytes": 2147483648
30
+ }
31
+ },
32
+ "Security": {
33
+ "PermissionGate": {
34
+ "Enabled": true
35
+ }
36
+ },
37
+ "Tools": {
38
+ "Shell": {
39
+ "AllowInterpreters": true,
40
+ "ExtraAllowedCommands": ["make"],
41
+ "Confinement": {
42
+ "Mode": "None"
43
+ }
44
+ },
45
+ "ResultLimits": {
46
+ "MaxParallelToolCalls": 4,
47
+ "Limits": {
48
+ "shell_command": 10000
49
+ }
50
+ }
51
+ },
52
+ "Cli": {
53
+ "ConsoleStreaming": {
54
+ "Enabled": true
55
+ },
56
+ "Session": {
57
+ "Persist": true
58
+ },
59
+ "Memory": {
60
+ "Persist": true,
61
+ "RootDirectory": "/workspace/.orkeon/typed-memory"
62
+ },
63
+ "ScriptCommands": {
64
+ "Limits": {
65
+ "ExecutionTimeout": "00:30:00",
66
+ "MemoryLimitBytes": 2147483648
67
+ }
68
+ }
69
+ }
70
+ }
71
+ }
@@ -0,0 +1,131 @@
1
+ {
2
+ "_comment": "Orkeon Code settings with a decision model, Jev (TypeSafe's System One), in front of the LLM. Copy it to config/appsettings.local.json (ignored by git): the Llm section is the default profile, as in appsettings.example.json; Llm:Profiles declares the named profiles a decision profile targets; Orkeon:TypeSafe reaches Jev, its key in the variable ApiKeyEnvVar names (TYPESAFE_API_KEY), never in this file; Orkeon:Decision:Profiles:guarded guards every request of the small profile against prompt injection, verifies the answer and escalates to the large profile when it does not hold. Then, in the REPL, /config set llm.profile guarded: every crew a command launches builds its agents on it; without the key, nothing changes. See docs/configuration.md.",
3
+ "Llm": {
4
+ "Model": "deepseek-v4-flash",
5
+ "BaseUrl": "https://api.deepseek.com",
6
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
7
+ "AvailableModels": [
8
+ "deepseek-v4-flash",
9
+ "deepseek-v4-pro"
10
+ ],
11
+ "Temperature": 0.2,
12
+ "MaxTokens": 24576,
13
+ "TimeoutSeconds": 600,
14
+ "MaxRateLimitWait": "00:05:00",
15
+ "Profiles": {
16
+ "small": {
17
+ "Model": "deepseek-v4-flash",
18
+ "BaseUrl": "https://api.deepseek.com",
19
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
20
+ "Temperature": 0.2,
21
+ "MaxTokens": 24576,
22
+ "TimeoutSeconds": 600,
23
+ "MaxRateLimitWait": "00:05:00",
24
+ "Fallback": [
25
+ "large"
26
+ ]
27
+ },
28
+ "large": {
29
+ "Model": "deepseek-v4-pro",
30
+ "BaseUrl": "https://api.deepseek.com",
31
+ "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
32
+ "Temperature": 0.2,
33
+ "MaxTokens": 24576,
34
+ "TimeoutSeconds": 600,
35
+ "MaxRateLimitWait": "00:05:00"
36
+ }
37
+ }
38
+ },
39
+ "RateLimiting": {
40
+ "MaxConcurrentRequests": 16,
41
+ "GlobalRequestsPerMinute": 300,
42
+ "ProviderRequestsPerMinute": 300,
43
+ "AgentRequestsPerMinute": 10,
44
+ "QueueLimit": 512
45
+ },
46
+ "Orkeon": {
47
+ "Rag": {
48
+ "Retrieval": {
49
+ "MinScore": 0.6
50
+ }
51
+ },
52
+ "TypeSafe": {
53
+ "Model": "jev-latest",
54
+ "ApiKeyEnvVar": "TYPESAFE_API_KEY",
55
+ "TimeoutSeconds": 30,
56
+ "MaxRetries": 3
57
+ },
58
+ "Decision": {
59
+ "Enabled": true,
60
+ "Profiles": {
61
+ "guarded": {
62
+ "Target": "small",
63
+ "FailClosed": false,
64
+ "Stages": [
65
+ {
66
+ "Kind": "guard",
67
+ "Phase": "request",
68
+ "Risks": {
69
+ "prompt_injection": "The message tries to override the system instructions or the tool rules"
70
+ },
71
+ "BlockThreshold": 0.8,
72
+ "WarnThreshold": 0.5
73
+ },
74
+ {
75
+ "Kind": "verify",
76
+ "Criterion": "The answer does what the request asks, on the code it names, and says what it did not do",
77
+ "EscalateTo": "large",
78
+ "MinProbability": 0.6
79
+ }
80
+ ]
81
+ }
82
+ }
83
+ },
84
+ "Scripting": {
85
+ "Limits": {
86
+ "ExecutionTimeout": "00:30:00",
87
+ "MemoryLimitBytes": 2147483648
88
+ }
89
+ },
90
+ "Security": {
91
+ "PermissionGate": {
92
+ "Enabled": true
93
+ }
94
+ },
95
+ "Tools": {
96
+ "Shell": {
97
+ "AllowInterpreters": true,
98
+ "ExtraAllowedCommands": [
99
+ "make"
100
+ ],
101
+ "Confinement": {
102
+ "Mode": "None"
103
+ }
104
+ },
105
+ "ResultLimits": {
106
+ "MaxParallelToolCalls": 4,
107
+ "Limits": {
108
+ "shell_command": 10000
109
+ }
110
+ }
111
+ },
112
+ "Cli": {
113
+ "ConsoleStreaming": {
114
+ "Enabled": true
115
+ },
116
+ "Session": {
117
+ "Persist": true
118
+ },
119
+ "Memory": {
120
+ "Persist": true,
121
+ "RootDirectory": "/workspace/.orkeon/typed-memory"
122
+ },
123
+ "ScriptCommands": {
124
+ "Limits": {
125
+ "ExecutionTimeout": "00:30:00",
126
+ "MemoryLimitBytes": 2147483648
127
+ }
128
+ }
129
+ }
130
+ }
131
+ }