@iowarp/clio-coder 0.3.6 → 0.3.7

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 (258) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +16 -5
  3. package/dist/{acp-2BEHC4DL.js → acp-SK4MD6MM.js} +10 -10
  4. package/dist/{agents-LNNFTM53.js → agents-2FN2K6ME.js} +30 -25
  5. package/dist/assets/codewiki.json +1 -1
  6. package/dist/{auth-KXXFI2VS.js → auth-QIYZWM5I.js} +13 -13
  7. package/dist/{chunk-KHSFENX2.js → chunk-3HAPLH5M.js} +10 -10
  8. package/dist/{chunk-24I7BN55.js → chunk-465YSENW.js} +2 -2
  9. package/dist/{chunk-4OC57DA6.js → chunk-4DGYLA73.js} +53 -2
  10. package/dist/{chunk-CYQKWTG3.js → chunk-4DWFMQDR.js} +4 -4
  11. package/dist/{chunk-E2ER4LJF.js → chunk-5C3AQNDW.js} +25 -1
  12. package/dist/{chunk-22NAGB7X.js → chunk-5C77SEEY.js} +5 -94
  13. package/dist/{chunk-43AOLP7E.js → chunk-5FR74PWO.js} +2 -1
  14. package/dist/{chunk-K7T3E2SR.js → chunk-5UJ6ECTS.js} +10 -9
  15. package/dist/{chunk-6US73PDB.js → chunk-6M7VS3J3.js} +5 -5
  16. package/dist/{chunk-CJUB2JJ2.js → chunk-6TUKSZVF.js} +5 -5
  17. package/dist/{chunk-5JGRAMKL.js → chunk-AB4XIIVB.js} +8 -6
  18. package/dist/{chunk-R46L2BIR.js → chunk-BMWK7ZIZ.js} +14 -20
  19. package/dist/{chunk-4BPJXDWC.js → chunk-C4JBQ5SR.js} +30 -14
  20. package/dist/{chunk-XXQNGV4M.js → chunk-CEYBNUGC.js} +243 -63
  21. package/dist/{chunk-VEZEGCGW.js → chunk-D4MDIG46.js} +20 -18
  22. package/dist/chunk-DJNLUABN.js +843 -0
  23. package/dist/{chunk-RY3LY4J5.js → chunk-DMD2AGVS.js} +5 -4
  24. package/dist/{chunk-KOHPCX4K.js → chunk-DOOEX22V.js} +2 -2
  25. package/dist/chunk-DQA7QLMD.js +123 -0
  26. package/dist/chunk-DR52UMZW.js +21 -0
  27. package/dist/{chunk-XF5N4U5A.js → chunk-EBEFWSGL.js} +6 -5
  28. package/dist/{chunk-EYPA3EGJ.js → chunk-EELBMBT6.js} +120 -13
  29. package/dist/{chunk-CKXWIANG.js → chunk-EOOQZZDE.js} +16 -14
  30. package/dist/{chunk-WR67VIZY.js → chunk-FOT2FX5J.js} +63 -5
  31. package/dist/{chunk-FYYLNIL5.js → chunk-GH5622CP.js} +2 -2
  32. package/dist/chunk-GWS3VEIW.js +195 -0
  33. package/dist/{chunk-LYF7OHWH.js → chunk-J7PIKKWC.js} +8 -463
  34. package/dist/{chunk-NILBFAPG.js → chunk-JNXPYBB4.js} +2 -2
  35. package/dist/{chunk-4VP4KH3K.js → chunk-JRIO5UD2.js} +4 -4
  36. package/dist/{chunk-6XXKFVSN.js → chunk-JTSEDYVQ.js} +7 -7
  37. package/dist/{chunk-QKMUKYO7.js → chunk-KCMKRQX4.js} +236 -84
  38. package/dist/chunk-KZ2H5X4G.js +1026 -0
  39. package/dist/{chunk-QNQHSOLF.js → chunk-LADCF22A.js} +12 -12
  40. package/dist/chunk-M4AKACEO.js +382 -0
  41. package/dist/{chunk-XYDYPRZI.js → chunk-MXI6J5JF.js} +7 -7
  42. package/dist/{chunk-G7MUEIGA.js → chunk-OB5HIGJY.js} +1 -1
  43. package/dist/{chunk-EKY57CSP.js → chunk-OBMAI2DP.js} +61 -767
  44. package/dist/chunk-PD3MESLB.js +242 -0
  45. package/dist/{chunk-ZRGEBJ4T.js → chunk-QCTRSGHQ.js} +21 -21
  46. package/dist/chunk-RVG5JXAL.js +41 -0
  47. package/dist/{chunk-RD5U66HV.js → chunk-SROCI7ZU.js} +7 -7
  48. package/dist/{chunk-MFFY33HR.js → chunk-THKY7CD7.js} +466 -205
  49. package/dist/{chunk-PCZJO5TI.js → chunk-UFQ3F4FW.js} +13 -178
  50. package/dist/{chunk-AD2SYQYC.js → chunk-UHXRNZ2J.js} +121 -3
  51. package/dist/chunk-UND3GU2L.js +103 -0
  52. package/dist/{chunk-QM3F2GKX.js → chunk-UUANF5CR.js} +2247 -2096
  53. package/dist/chunk-UVDSQ6LW.js +472 -0
  54. package/dist/{chunk-DJVECN66.js → chunk-VQNODYQ4.js} +14 -14
  55. package/dist/{chunk-3BPUFZDL.js → chunk-VREKEFLL.js} +3 -3
  56. package/dist/{chunk-PBTHKCPN.js → chunk-WJHBC77E.js} +6 -6
  57. package/dist/{chunk-XE2VEJHX.js → chunk-X2KV5FXT.js} +2 -2
  58. package/dist/{chunk-ZXF4XRKW.js → chunk-XEGB6BCN.js} +157 -7
  59. package/dist/{chunk-E25LMLRW.js → chunk-YD734TPH.js} +2 -2
  60. package/dist/{verifiers-NCBTHHN2.js → chunk-YTYFXUI3.js} +65 -322
  61. package/dist/{chunk-OH3TOQTB.js → chunk-ZGH7FGS5.js} +13 -7
  62. package/dist/cli/index.js +32 -30
  63. package/dist/{clio-M2KGYUFZ.js → clio-WBVQEBKO.js} +7 -7
  64. package/dist/{code-nav-GQNL7XA6.js → code-nav-FGGFIE7L.js} +3 -3
  65. package/dist/{components-5TTYYX6G.js → components-F7OEATSO.js} +4 -4
  66. package/dist/{config-XUUYQIWO.js → config-TRBL3RCF.js} +34 -29
  67. package/dist/{configure-IHJ7YOMV.js → configure-OLCVPHNM.js} +15 -15
  68. package/dist/{context-74JLXAWD.js → context-MJIJ6GOX.js} +11 -11
  69. package/dist/{context-ZQ7SIFJV.js → context-WFPKQSM6.js} +19 -3
  70. package/dist/{context-75MIWW3U.js → context-XEWE3MOJ.js} +31 -26
  71. package/dist/{context-clear-GYKWNUML.js → context-clear-KNOS2JPB.js} +31 -26
  72. package/dist/{context-working-set-UX5KEP4J.js → context-working-set-EUXAZI6N.js} +8 -8
  73. package/dist/{dispatch-runner-GIJBHNFL.js → dispatch-runner-B7MTOVKL.js} +313 -53
  74. package/dist/{docs-6FZSCG5B.js → docs-FLJTIDSE.js} +4 -4
  75. package/dist/{doctor-SVJ5BZCW.js → doctor-RN4YKO2X.js} +14 -14
  76. package/dist/{eval-CG6LLBLD.js → eval-RUBJVSNQ.js} +8 -7
  77. package/dist/{evidence-ZYFIEN42.js → evidence-JZNBUOQZ.js} +30 -25
  78. package/dist/{evolve-QGEXEMDW.js → evolve-FJVC4KKI.js} +30 -25
  79. package/dist/{extensions-ADGNCJJD.js → extensions-IQL36S7K.js} +4 -4
  80. package/dist/{fleet-S5R4ZOQY.js → fleet-BDKYJFCP.js} +214 -360
  81. package/dist/fleet-commands-ZFIWZSB3.js +70 -0
  82. package/dist/fleet-graph-Y6HPXIVF.js +125 -0
  83. package/dist/fleet-new-RDVJLHHH.js +48 -0
  84. package/dist/fleet-validate-BIYREGIK.js +79 -0
  85. package/dist/{init-5DRU55YR.js → init-LQUB5COQ.js} +44 -37
  86. package/dist/library-NJAHIGG4.js +217 -0
  87. package/dist/{memory-7YKKR6UC.js → memory-OG6HOYKM.js} +31 -26
  88. package/dist/{models-ZPOLRU2C.js → models-5ZG5XY7J.js} +21 -20
  89. package/dist/{monitor-US5F5YGZ.js → monitor-TJ7AMTGB.js} +49 -30
  90. package/dist/{orchestrator-E2AL4T5N.js → orchestrator-WZYB54DM.js} +3827 -581
  91. package/dist/{paths-E7KYAQWE.js → paths-XUC7GS6E.js} +4 -4
  92. package/dist/{reset-KZ652EK6.js → reset-PXQT45IY.js} +7 -7
  93. package/dist/{run-SRNBKDWD.js → run-FQ74YF62.js} +53 -45
  94. package/dist/{share-CGZE33UP.js → share-FW7SVCL3.js} +33 -9
  95. package/dist/{skills-S2X4DLY5.js → skills-7E7IRB3R.js} +24 -8
  96. package/dist/{skills-eval-W2GGIC4R.js → skills-eval-LI75W6OK.js} +34 -27
  97. package/dist/{targets-54SWINWB.js → targets-4CIFKCTW.js} +23 -22
  98. package/dist/{terminal-lease-SAIF2OGY.js → terminal-lease-WUZY7ZV5.js} +4 -4
  99. package/dist/{uninstall-BVLWXKBT.js → uninstall-7FV7IP4E.js} +4 -4
  100. package/dist/{upgrade-JKAR27XC.js → upgrade-K2HVIVMQ.js} +20 -19
  101. package/dist/{usage-MSAWCLX4.js → usage-GTZELZQX.js} +116 -49
  102. package/dist/verifiers-RLAHT27O.js +336 -0
  103. package/dist/{verify-X5HDROLA.js → verify-BX3BRKH5.js} +7 -6
  104. package/dist/{wiki-generate-GUSOQ6ZP.js → wiki-generate-ASIFASCN.js} +45 -37
  105. package/dist/worker/entry.js +38 -35
  106. package/docs/README.md +3 -2
  107. package/docs/acp.md +1 -1
  108. package/docs/alcf-provider.md +1 -1
  109. package/docs/architecture.md +2 -2
  110. package/docs/artifact-versions.md +10 -6
  111. package/docs/built-in-agents.md +26 -2
  112. package/docs/capacity-and-scheduling.md +1 -1
  113. package/docs/commands-and-modes.md +82 -2
  114. package/docs/configuration-and-targets.md +79 -2
  115. package/docs/context-engine.md +1 -1
  116. package/docs/development-pipeline.md +1 -1
  117. package/docs/dispatch-architecture-rationale.md +1 -1
  118. package/docs/documentation-coverage.md +3 -3
  119. package/docs/documentation-guide.md +3 -3
  120. package/docs/eval-runner.md +1 -1
  121. package/docs/evals-internal.md +1 -1
  122. package/docs/evidence-and-memory.md +5 -5
  123. package/docs/evolution.md +1 -1
  124. package/docs/exit-codes-and-output.md +4 -1
  125. package/docs/extensions-and-sharing.md +6 -2
  126. package/docs/fleet-demo-runbook.md +2 -2
  127. package/docs/fleet-dispatch.md +197 -10
  128. package/docs/git-commit-provenance.md +2 -2
  129. package/docs/glossary.md +1 -1
  130. package/docs/installation-and-lifecycle.md +2 -2
  131. package/docs/middleware-and-components.md +2 -1
  132. package/docs/model-catalog.md +1 -1
  133. package/docs/observability.md +55 -8
  134. package/docs/proactive-memory.md +1 -1
  135. package/docs/prompt-envelope-and-tools.md +1 -1
  136. package/docs/provider-adapter-cookbook.md +1 -1
  137. package/docs/release-cut-checklist.md +79 -64
  138. package/docs/resource-library.md +59 -0
  139. package/docs/safety-model.md +2 -2
  140. package/docs/scientific-validation.md +3 -3
  141. package/docs/session-lifecycle.md +37 -1
  142. package/docs/skills-marketplace.md +16 -3
  143. package/docs/tool-usage.md +14 -7
  144. package/docs/trace-store.md +1 -1
  145. package/docs/troubleshooting.md +1 -1
  146. package/docs/tui-design.md +1 -1
  147. package/docs/worker-dispatch-mechanics.md +3 -3
  148. package/package.json +1 -1
  149. package/src/cli/fleet-commands.ts +37 -0
  150. package/src/cli/fleet-graph.ts +102 -0
  151. package/src/cli/fleet-new.ts +36 -0
  152. package/src/cli/fleet-preflight.ts +121 -0
  153. package/src/cli/fleet-validate.ts +30 -0
  154. package/src/cli/fleet.ts +173 -335
  155. package/src/cli/index.ts +3 -1
  156. package/src/cli/library.ts +190 -0
  157. package/src/cli/share.ts +13 -1
  158. package/src/cli/usage.ts +111 -19
  159. package/src/core/bus-events.ts +4 -0
  160. package/src/core/commit-attribution.ts +4 -4
  161. package/src/core/config.ts +130 -0
  162. package/src/core/defaults.ts +81 -0
  163. package/src/domains/agents/builtins/architect.md +1 -0
  164. package/src/domains/agents/builtins/oracle.md +33 -0
  165. package/src/domains/agents/catalog.ts +13 -1
  166. package/src/domains/agents/fleet-contract.ts +278 -16
  167. package/src/domains/agents/index.ts +14 -0
  168. package/src/domains/agents/result-contract.ts +235 -1
  169. package/src/domains/config/classify.ts +4 -0
  170. package/src/domains/dispatch/active-route-planner.ts +14 -0
  171. package/src/domains/dispatch/backoff.ts +2 -1
  172. package/src/domains/dispatch/capability-match.ts +1 -0
  173. package/src/domains/dispatch/checkout-writer-lease.ts +175 -0
  174. package/src/domains/dispatch/contract.ts +34 -0
  175. package/src/domains/dispatch/delegation-plan.ts +167 -0
  176. package/src/domains/dispatch/execution-plan.ts +76 -5
  177. package/src/domains/dispatch/execution-role.ts +3 -1
  178. package/src/domains/dispatch/execution-scheduler.ts +183 -67
  179. package/src/domains/dispatch/extension.ts +258 -9
  180. package/src/domains/dispatch/fleet-gate.ts +14 -0
  181. package/src/domains/dispatch/fleet-plan.ts +63 -3
  182. package/src/domains/dispatch/fleet-run.ts +737 -0
  183. package/src/domains/dispatch/gate-role-prompts.ts +9 -0
  184. package/src/domains/dispatch/host-verification.ts +178 -0
  185. package/src/domains/dispatch/index.ts +38 -0
  186. package/src/domains/dispatch/intent.ts +159 -0
  187. package/src/domains/dispatch/receipt-integrity.ts +8 -4
  188. package/src/domains/dispatch/state.ts +36 -3
  189. package/src/domains/dispatch/types.ts +51 -6
  190. package/src/domains/dispatch/validation.ts +66 -6
  191. package/src/domains/evidence/trust-status.ts +10 -1
  192. package/src/domains/middleware/index.ts +15 -0
  193. package/src/domains/middleware/watchdog.ts +281 -0
  194. package/src/domains/observability/contract.ts +3 -1
  195. package/src/domains/observability/cost.ts +12 -1
  196. package/src/domains/observability/extension.ts +2 -2
  197. package/src/domains/observability/index.ts +10 -0
  198. package/src/domains/observability/out-of-turn-usage.ts +223 -0
  199. package/src/domains/resources/index.ts +20 -0
  200. package/src/domains/resources/library.ts +326 -0
  201. package/src/domains/resources/skills/marketplace.ts +37 -12
  202. package/src/domains/session/handoff.ts +629 -0
  203. package/src/domains/share/archive.ts +67 -2
  204. package/src/entry/orchestrator.ts +37 -0
  205. package/src/interactive/bus-notices.ts +26 -0
  206. package/src/interactive/chat-loop.ts +235 -1
  207. package/src/interactive/chat-renderer.ts +22 -0
  208. package/src/interactive/cost-overlay.ts +31 -3
  209. package/src/interactive/council-dispatch.ts +30 -0
  210. package/src/interactive/council-grid.ts +213 -0
  211. package/src/interactive/council.ts +99 -0
  212. package/src/interactive/dispatch-board.ts +260 -16
  213. package/src/interactive/fleet-run-preview.ts +307 -0
  214. package/src/interactive/footer/notifications.ts +219 -0
  215. package/src/interactive/handoff-round.ts +56 -0
  216. package/src/interactive/interactive-application.ts +43 -1
  217. package/src/interactive/interactive-event-projection.ts +9 -1
  218. package/src/interactive/interactive-slash-runtime.ts +52 -2
  219. package/src/interactive/interactive-subscriptions.ts +14 -2
  220. package/src/interactive/oracle.ts +179 -0
  221. package/src/interactive/overlay-ask-user-lifecycle.ts +6 -0
  222. package/src/interactive/overlay-general-openers.ts +190 -1
  223. package/src/interactive/overlay-key-routing.ts +17 -1
  224. package/src/interactive/overlay-lifecycle.ts +41 -1
  225. package/src/interactive/overlay-permission-lifecycle.ts +10 -0
  226. package/src/interactive/overlay-resource-openers.ts +11 -3
  227. package/src/interactive/overlay-session-lifecycle.ts +234 -2
  228. package/src/interactive/overlays/fleet-run-approval.ts +208 -0
  229. package/src/interactive/overlays/handoff-review.ts +185 -0
  230. package/src/interactive/overlays/library-install-confirm.ts +151 -0
  231. package/src/interactive/overlays/list-overlay.ts +168 -2
  232. package/src/interactive/overlays/settings.ts +101 -4
  233. package/src/interactive/overlays/side-question.ts +139 -0
  234. package/src/interactive/overlays/skills-hub.ts +401 -15
  235. package/src/interactive/side-question.ts +171 -0
  236. package/src/interactive/slash-commands.ts +432 -5
  237. package/src/interactive/slash-spec.ts +19 -6
  238. package/src/interactive/theme/tokens.ts +30 -0
  239. package/src/interactive/turn-middleware.ts +15 -1
  240. package/src/interactive/watchdog-run.ts +75 -0
  241. package/src/interactive/worker-share.ts +56 -1
  242. package/src/interactive/worker-stream.ts +7 -0
  243. package/src/tools/bootstrap.ts +3 -0
  244. package/src/tools/compete-worktrees.ts +13 -79
  245. package/src/tools/dispatch-admission.ts +242 -8
  246. package/src/tools/dispatch-arguments.ts +57 -1
  247. package/src/tools/dispatch-plan.ts +136 -6
  248. package/src/tools/dispatch-runner.ts +319 -13
  249. package/src/tools/dispatch-types.ts +20 -1
  250. package/src/tools/dispatch.ts +72 -2
  251. package/src/tools/monitor.ts +16 -0
  252. package/src/tools/profiles.ts +18 -4
  253. package/src/tools/task-worktree.ts +238 -0
  254. package/src/tools/verify/authoring.ts +61 -1
  255. package/src/tools/verify/scripts.ts +62 -0
  256. package/src/tools/worker-evidence.ts +2 -1
  257. package/src/worker/spec-contract.ts +1 -0
  258. package/dist/chunk-HC4CLZ2Y.js +0 -68
@@ -0,0 +1,472 @@
1
+ import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
2
+ import {
3
+ assertAgentIdNamespace
4
+ } from "./chunk-DR52UMZW.js";
5
+ import {
6
+ loadSkills
7
+ } from "./chunk-C4JBQ5SR.js";
8
+ import {
9
+ parseFrontmatter
10
+ } from "./chunk-KCMKRQX4.js";
11
+ import {
12
+ parseResultContract
13
+ } from "./chunk-DJNLUABN.js";
14
+ import {
15
+ assertAgentSpecPolicy,
16
+ isAgentAudience,
17
+ isAgentCapabilityClass,
18
+ isAgentCategory,
19
+ isAgentLatencyClass,
20
+ isAgentProduct,
21
+ isAgentProjectContextTier,
22
+ isShadowAgent,
23
+ normalizeAgentSpec
24
+ } from "./chunk-AOCYTWAV.js";
25
+ import {
26
+ clioConfigDir
27
+ } from "./chunk-BNAZZHFG.js";
28
+ import {
29
+ resolvePackageRoot
30
+ } from "./chunk-IWHMRKLL.js";
31
+ import {
32
+ init_esm_shims
33
+ } from "./chunk-3R73A4XB.js";
34
+
35
+ // src/domains/agents/index.ts
36
+ init_esm_shims();
37
+
38
+ // src/domains/agents/extension.ts
39
+ init_esm_shims();
40
+ import path3 from "node:path";
41
+
42
+ // src/domains/agents/registry.ts
43
+ init_esm_shims();
44
+ import { existsSync, readdirSync, readFileSync } from "node:fs";
45
+ import path2 from "node:path";
46
+
47
+ // src/domains/agents/recipe.ts
48
+ init_esm_shims();
49
+ import path from "node:path";
50
+ var AGENT_BUDGET_KEYS = ["toolCalls", "readReserve", "synthesis", "maximum"];
51
+ function parseAgentBudgetPhase(value, prefix, relationTarget) {
52
+ if (value === null || typeof value !== "object" || Array.isArray(value)) {
53
+ throw new Error(`${prefix} must be a non-null YAML object`);
54
+ }
55
+ const record = value;
56
+ for (const key of Object.keys(record)) {
57
+ if (key !== "toolCalls" && key !== "readReserve") throw new Error(`${prefix}.${key} is unknown`);
58
+ }
59
+ for (const key of ["toolCalls", "readReserve"]) {
60
+ if (!Object.hasOwn(record, key)) throw new Error(`${prefix}.${key} is required`);
61
+ }
62
+ const toolCalls = record.toolCalls;
63
+ if (typeof toolCalls !== "number" || !Number.isSafeInteger(toolCalls)) {
64
+ throw new Error(`${prefix}.toolCalls must be a finite safe integer`);
65
+ }
66
+ if (toolCalls <= 0) throw new Error(`${prefix}.toolCalls must be greater than 0`);
67
+ const readReserve = record.readReserve;
68
+ if (typeof readReserve !== "number" || !Number.isSafeInteger(readReserve)) {
69
+ throw new Error(`${prefix}.readReserve must be a finite safe integer`);
70
+ }
71
+ if (readReserve < 0) throw new Error(`${prefix}.readReserve must be greater than or equal to 0`);
72
+ if (readReserve >= toolCalls) throw new Error(`${prefix}.readReserve must be less than ${relationTarget}`);
73
+ return { toolCalls, readReserve };
74
+ }
75
+ function parseAgentBudget(value, sourcePath) {
76
+ if (value === void 0) return void 0;
77
+ const prefix = `agent budget: ${sourcePath}: budget`;
78
+ if (value === null || typeof value !== "object" || Array.isArray(value)) {
79
+ throw new Error(`${prefix} must be a non-null YAML object`);
80
+ }
81
+ const record = value;
82
+ for (const key of Object.keys(record)) {
83
+ if (!AGENT_BUDGET_KEYS.includes(key)) {
84
+ throw new Error(`${prefix}.${key} is unknown`);
85
+ }
86
+ }
87
+ for (const key of ["toolCalls", "readReserve", "synthesis"]) {
88
+ if (!Object.hasOwn(record, key)) throw new Error(`${prefix}.${key} is required`);
89
+ }
90
+ const phase = parseAgentBudgetPhase(
91
+ { toolCalls: record.toolCalls, readReserve: record.readReserve },
92
+ prefix,
93
+ "budget.toolCalls"
94
+ );
95
+ const synthesis = record.synthesis;
96
+ if (typeof synthesis !== "boolean") throw new Error(`${prefix}.synthesis must be a boolean`);
97
+ const maximum = record.maximum === void 0 ? void 0 : parseAgentBudgetPhase(record.maximum, `${prefix}.maximum`, "budget.maximum.toolCalls");
98
+ if (maximum !== void 0) {
99
+ if (maximum.toolCalls < phase.toolCalls) {
100
+ throw new Error(`${prefix}.maximum.toolCalls must be greater than or equal to budget.toolCalls`);
101
+ }
102
+ if (maximum.readReserve < phase.readReserve) {
103
+ throw new Error(`${prefix}.maximum.readReserve must be greater than or equal to budget.readReserve`);
104
+ }
105
+ }
106
+ return { ...phase, synthesis, ...maximum === void 0 ? {} : { maximum } };
107
+ }
108
+ function recipeIdFromPath(absPath, rootDir) {
109
+ const resolvedRoot = path.resolve(rootDir);
110
+ const resolvedPath = path.resolve(absPath);
111
+ const relPath = path.relative(resolvedRoot, resolvedPath);
112
+ if (relPath === "" || relPath.startsWith("..") || path.isAbsolute(relPath)) {
113
+ throw new Error(`recipe: path must live under rootDir (${resolvedPath} not under ${resolvedRoot})`);
114
+ }
115
+ if (path.dirname(relPath) !== ".") {
116
+ throw new Error(`recipe: recipes must live directly under rootDir (${resolvedPath})`);
117
+ }
118
+ if (path.extname(relPath) !== ".md") {
119
+ throw new Error(`recipe: recipe files must end in .md (${resolvedPath})`);
120
+ }
121
+ const id = path.basename(relPath, ".md");
122
+ if (id === "") {
123
+ throw new Error(`recipe: recipe filename must not be empty (${resolvedPath})`);
124
+ }
125
+ return id;
126
+ }
127
+
128
+ // src/domains/agents/recipe-schema.ts
129
+ init_esm_shims();
130
+ var RECIPE_KEYS = [
131
+ "version",
132
+ "name",
133
+ "description",
134
+ "tools",
135
+ "skills",
136
+ "audience",
137
+ "category",
138
+ "capabilityClass",
139
+ "latencyClass",
140
+ "projectContextTier",
141
+ "budget",
142
+ "resultContract",
143
+ "tags"
144
+ ];
145
+ var OPTIONAL_RECIPE_KEYS = ["product"];
146
+ var ALL_RECIPE_KEYS = [...RECIPE_KEYS, ...OPTIONAL_RECIPE_KEYS];
147
+ function requiredString(value, path4) {
148
+ if (typeof value !== "string" || value.trim().length === 0)
149
+ throw new Error(`agent recipe: ${path4} must be a non-empty string`);
150
+ return value;
151
+ }
152
+ function requiredStringArray(value, path4) {
153
+ if (!Array.isArray(value)) throw new Error(`agent recipe: ${path4} must be an array of strings`);
154
+ const entries = value.map((entry, index) => requiredString(entry, `${path4}[${index}]`));
155
+ if (new Set(entries).size !== entries.length) throw new Error(`agent recipe: ${path4} must not contain duplicates`);
156
+ return entries;
157
+ }
158
+ function enumValue(value, path4, predicate) {
159
+ if (!predicate(value)) throw new Error(`agent recipe: ${path4} has an unsupported value`);
160
+ return value;
161
+ }
162
+ function parseAudience(value, source, filepath) {
163
+ const audience = enumValue(value, `${filepath}: audience`, isAgentAudience);
164
+ if (source === "builtin") {
165
+ if (audience === "custom") {
166
+ throw new Error(`agent recipe: ${filepath}: a builtin recipe must not declare audience 'custom'`);
167
+ }
168
+ return audience;
169
+ }
170
+ if (audience !== "custom") {
171
+ throw new Error(
172
+ `agent recipe: ${filepath}: a ${source} recipe must declare audience 'custom', not '${audience}'; audience follows where the recipe was discovered and cannot be claimed in frontmatter`
173
+ );
174
+ }
175
+ return audience;
176
+ }
177
+ function parseTools(value, filepath) {
178
+ if (value === null || typeof value !== "object" || Array.isArray(value)) {
179
+ throw new Error(`agent recipe: ${filepath}: tools must be a { required, optional } object`);
180
+ }
181
+ const record = value;
182
+ if (Object.keys(record).some((key) => key !== "required" && key !== "optional")) {
183
+ throw new Error(`agent recipe: ${filepath}: tools has an unknown key`);
184
+ }
185
+ if (!("required" in record) || !("optional" in record)) {
186
+ throw new Error(`agent recipe: ${filepath}: tools.required and tools.optional are required`);
187
+ }
188
+ if (!Array.isArray(record.required) || !Array.isArray(record.optional)) {
189
+ throw new Error(`agent recipe: ${filepath}: tools.required and tools.optional must be arrays`);
190
+ }
191
+ const required = record.required.map((entry, index) => {
192
+ const entryPath = `${filepath}: tools.required[${index}]`;
193
+ if (typeof entry === "string") return requiredString(entry, entryPath);
194
+ if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
195
+ throw new Error(`agent recipe: ${entryPath} must be a tool name or { anyOf: [...] }`);
196
+ }
197
+ const group = entry;
198
+ if (Object.keys(group).length !== 1 || !("anyOf" in group)) {
199
+ throw new Error(`agent recipe: ${entryPath} must contain only anyOf`);
200
+ }
201
+ const anyOf = requiredStringArray(group.anyOf, `${entryPath}.anyOf`);
202
+ if (anyOf.length === 0) throw new Error(`agent recipe: ${entryPath}.anyOf must not be empty`);
203
+ return { anyOf };
204
+ });
205
+ const optional = requiredStringArray(record.optional, `${filepath}: tools.optional`);
206
+ const tools = [
207
+ ...required.flatMap((requirement) => typeof requirement === "string" ? [requirement] : requirement.anyOf),
208
+ ...optional
209
+ ];
210
+ if (new Set(tools).size !== tools.length)
211
+ throw new Error(`agent recipe: ${filepath}: tools contains duplicate requirements`);
212
+ return { tools, toolRequirements: { required, optional } };
213
+ }
214
+ function parseAgentRecipeSchema(input) {
215
+ const { frontmatter, filepath } = input;
216
+ for (const key of Object.keys(frontmatter)) {
217
+ if (!ALL_RECIPE_KEYS.includes(key)) {
218
+ throw new Error(`agent recipe: ${filepath}: unknown key '${key}'`);
219
+ }
220
+ }
221
+ for (const key of RECIPE_KEYS) {
222
+ if (!(key in frontmatter)) throw new Error(`agent recipe: ${filepath}: ${key} is required`);
223
+ }
224
+ if (frontmatter.version !== 1) throw new Error(`agent recipe: ${filepath}: version must be the supported integer 1`);
225
+ if (input.body.trim().length === 0) throw new Error(`agent recipe: ${filepath}: persona body must not be empty`);
226
+ const parsedTools = parseTools(frontmatter.tools, filepath);
227
+ const budget = parseAgentBudget(frontmatter.budget, filepath);
228
+ if (budget === void 0) throw new Error(`agent recipe: ${filepath}: budget is required`);
229
+ return {
230
+ version: 1,
231
+ id: input.id,
232
+ name: requiredString(frontmatter.name, `${filepath}: name`),
233
+ description: requiredString(frontmatter.description, `${filepath}: description`),
234
+ tools: parsedTools.tools,
235
+ toolRequirements: parsedTools.toolRequirements,
236
+ skills: requiredStringArray(frontmatter.skills, `${filepath}: skills`),
237
+ boundSkillPaths: [],
238
+ audience: parseAudience(frontmatter.audience, input.source, filepath),
239
+ category: enumValue(frontmatter.category, `${filepath}: category`, isAgentCategory),
240
+ capabilityClass: enumValue(
241
+ frontmatter.capabilityClass,
242
+ `${filepath}: capabilityClass`,
243
+ isAgentCapabilityClass
244
+ ),
245
+ latencyClass: enumValue(
246
+ frontmatter.latencyClass,
247
+ `${filepath}: latencyClass`,
248
+ isAgentLatencyClass
249
+ ),
250
+ projectContextTier: enumValue(
251
+ frontmatter.projectContextTier,
252
+ `${filepath}: projectContextTier`,
253
+ isAgentProjectContextTier
254
+ ),
255
+ budget,
256
+ resultContract: parseResultContract(frontmatter.resultContract, filepath),
257
+ // Optional, but not lenient. A misspelled product silently costs the run
258
+ // the delivery tools its reserve window was supposed to keep, and the
259
+ // only symptom is a blocked tool call deep in a dispatch log.
260
+ ...frontmatter.product === void 0 ? {} : { product: enumValue(frontmatter.product, `${filepath}: product`, isAgentProduct) },
261
+ tags: requiredStringArray(frontmatter.tags, `${filepath}: tags`),
262
+ source: input.source,
263
+ filepath,
264
+ body: input.body
265
+ };
266
+ }
267
+
268
+ // src/domains/agents/registry.ts
269
+ var RESERVED_CUSTOM_AGENT_IDS = /* @__PURE__ */ new Set(["worker", "delegate", "auto"]);
270
+ function resolveBoundSkills(recipe, source) {
271
+ if (recipe.skills.length === 0) return { ...recipe, boundSkillPaths: [] };
272
+ const packageSkills = path2.resolve(source.dir, "..", "..", "..", "..", "skills");
273
+ const skills = loadSkills({
274
+ cwd: process.cwd(),
275
+ ...source.source === "builtin" && existsSync(packageSkills) ? { explicitSkillPaths: [packageSkills] } : {}
276
+ });
277
+ const byName = new Map(skills.items.map((skill) => [skill.name, skill.filePath]));
278
+ const missing = recipe.skills.filter((skill) => !byName.has(skill));
279
+ if (missing.length > 0) {
280
+ throw new Error(`agent recipe: ${recipe.filepath}: bound skill(s) unavailable: ${missing.join(", ")}`);
281
+ }
282
+ const boundSkillPaths = recipe.skills.map((skill) => {
283
+ const filePath = byName.get(skill);
284
+ if (filePath === void 0) throw new Error(`agent recipe: ${recipe.filepath}: bound skill unavailable: ${skill}`);
285
+ return filePath;
286
+ });
287
+ return { ...recipe, boundSkillPaths };
288
+ }
289
+ function loadRecipesFromDir(source, diagnostics = []) {
290
+ let entries;
291
+ try {
292
+ entries = readdirSync(source.dir, { withFileTypes: true });
293
+ } catch (err) {
294
+ const error = err;
295
+ if (error.code === "ENOENT" || error.code === "ENOTDIR") return [];
296
+ throw err;
297
+ }
298
+ const recipes = [];
299
+ for (const entry of entries) {
300
+ if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
301
+ const filepath = path2.join(source.dir, entry.name);
302
+ try {
303
+ const id = recipeIdFromPath(filepath, source.dir);
304
+ const raw = readFileSync(filepath, "utf8");
305
+ const { frontmatter, body } = parseFrontmatter(raw, filepath);
306
+ const parsedRecipe = parseAgentRecipeSchema({ id, source: source.source, filepath, body, frontmatter });
307
+ const recipe = resolveBoundSkills(parsedRecipe, source);
308
+ assertAgentSpecPolicy(normalizeAgentSpec(recipe));
309
+ recipes.push(recipe);
310
+ } catch (error) {
311
+ if (source.source === "builtin") throw error;
312
+ const message = error instanceof Error ? error.message : String(error);
313
+ diagnostics.push({ source: source.source, filepath, message });
314
+ process.stderr.write(`[clio:agents] quarantine path=${filepath} source=${source.source} reason=${message}
315
+ `);
316
+ }
317
+ }
318
+ recipes.sort((left, right) => left.id.localeCompare(right.id));
319
+ return recipes;
320
+ }
321
+ function mergeRecipes(...sources) {
322
+ const byId = /* @__PURE__ */ new Map();
323
+ const builtinById = /* @__PURE__ */ new Map();
324
+ for (const group of sources) {
325
+ for (const recipe of group) {
326
+ if (recipe.source === "builtin") builtinById.set(recipe.id, recipe);
327
+ }
328
+ }
329
+ for (const group of sources) {
330
+ for (const recipe of group) {
331
+ if (recipe.source !== "builtin" && RESERVED_CUSTOM_AGENT_IDS.has(recipe.id)) {
332
+ process.stderr.write(`[clio:agents] ignore id=${recipe.id} by=${recipe.source} reason=reserved-agent-id
333
+ `);
334
+ continue;
335
+ }
336
+ const builtin = builtinById.get(recipe.id);
337
+ if (recipe.source === "user" && builtin && isShadowAgent(normalizeAgentSpec(builtin))) {
338
+ process.stderr.write(`[clio:agents] ignore override id=${recipe.id} by=user reason=reserved-shadow
339
+ `);
340
+ continue;
341
+ }
342
+ if (recipe.source === "project" && builtin) {
343
+ process.stderr.write(`[clio:agents] ignore override id=${recipe.id} by=project reason=reserved-builtin
344
+ `);
345
+ continue;
346
+ }
347
+ if (byId.has(recipe.id)) process.stderr.write(`[clio:agents] override id=${recipe.id} by=${recipe.source}
348
+ `);
349
+ byId.set(recipe.id, recipe);
350
+ }
351
+ }
352
+ return Array.from(byId.values()).sort((left, right) => left.id.localeCompare(right.id));
353
+ }
354
+
355
+ // src/domains/agents/extension.ts
356
+ function createAgentsBundle(_context) {
357
+ let recipes = [];
358
+ let specs = [];
359
+ let diagnostics = [];
360
+ function discover() {
361
+ const builtinDir = path3.join(resolvePackageRoot(), "src", "domains", "agents", "builtins");
362
+ const userDir = path3.join(clioConfigDir(), "agents");
363
+ const projectDir = path3.join(process.cwd(), ".clio-coder", "agents");
364
+ const nextDiagnostics = [];
365
+ const builtin = loadRecipesFromDir({ dir: builtinDir, source: "builtin" }, nextDiagnostics);
366
+ const user = loadRecipesFromDir({ dir: userDir, source: "user" }, nextDiagnostics);
367
+ const project = loadRecipesFromDir({ dir: projectDir, source: "project" }, nextDiagnostics);
368
+ const merged = mergeRecipes(builtin, user, project);
369
+ const config = _context.getContract("config");
370
+ assertAgentIdNamespace(merged, config?.get()?.delegation?.agents ?? []);
371
+ recipes = merged;
372
+ specs = recipes.map(normalizeAgentSpec);
373
+ diagnostics = nextDiagnostics;
374
+ }
375
+ const extension = {
376
+ async start() {
377
+ discover();
378
+ },
379
+ async stop() {
380
+ }
381
+ };
382
+ const contract = {
383
+ list() {
384
+ return recipes;
385
+ },
386
+ get(id) {
387
+ return recipes.find((r) => r.id === id) ?? null;
388
+ },
389
+ diagnostics() {
390
+ return diagnostics.map((diagnostic) => ({ ...diagnostic }));
391
+ },
392
+ listSpecs() {
393
+ const config = _context.getContract("config");
394
+ const delegationAgents = config?.get()?.delegation?.agents ?? [];
395
+ const delegationSpecs = delegationAgents.map((agent) => ({
396
+ version: 1,
397
+ id: agent.id,
398
+ name: agent.id,
399
+ description: `External ACP delegation agent: ${agent.command} ${(agent.args ?? []).join(" ")}`,
400
+ source: "custom",
401
+ filepath: "settings.yaml",
402
+ tools: [],
403
+ toolRequirements: { required: [], optional: [] },
404
+ category: "explore",
405
+ capabilityClass: "orchestration",
406
+ latencyClass: "deep",
407
+ projectContextTier: "none",
408
+ audience: "custom",
409
+ tags: ["delegation", "acp"],
410
+ skills: [],
411
+ resultContract: { kind: "external-delegation" },
412
+ budget: { toolCalls: 1, readReserve: 0, synthesis: false },
413
+ body: "External ACP delegation."
414
+ }));
415
+ return [...specs, ...delegationSpecs];
416
+ },
417
+ getSpec(id) {
418
+ const found = specs.find((r) => r.id === id);
419
+ if (found) return found;
420
+ const config = _context.getContract("config");
421
+ const agent = config?.get()?.delegation?.agents?.find((entry) => entry.id === id);
422
+ if (agent) {
423
+ return {
424
+ version: 1,
425
+ id: agent.id,
426
+ name: agent.id,
427
+ description: `External ACP delegation agent: ${agent.command} ${(agent.args ?? []).join(" ")}`,
428
+ source: "custom",
429
+ filepath: "settings.yaml",
430
+ tools: [],
431
+ toolRequirements: { required: [], optional: [] },
432
+ category: "explore",
433
+ capabilityClass: "orchestration",
434
+ latencyClass: "deep",
435
+ projectContextTier: "none",
436
+ audience: "custom",
437
+ tags: ["delegation", "acp"],
438
+ skills: [],
439
+ resultContract: { kind: "external-delegation" },
440
+ budget: { toolCalls: 1, readReserve: 0, synthesis: false },
441
+ body: "External ACP delegation."
442
+ };
443
+ }
444
+ return null;
445
+ },
446
+ reload() {
447
+ discover();
448
+ }
449
+ };
450
+ return { extension, contract };
451
+ }
452
+
453
+ // src/domains/agents/manifest.ts
454
+ init_esm_shims();
455
+ var AgentsManifest = {
456
+ name: "agents",
457
+ dependsOn: ["config"]
458
+ };
459
+
460
+ // src/domains/agents/index.ts
461
+ var AgentsDomainModule = {
462
+ manifest: AgentsManifest,
463
+ createExtension: createAgentsBundle
464
+ };
465
+
466
+ export {
467
+ parseAgentRecipeSchema,
468
+ loadRecipesFromDir,
469
+ mergeRecipes,
470
+ AgentsDomainModule
471
+ };
472
+ //# sourceMappingURL=chunk-UVDSQ6LW.js.map
@@ -3,12 +3,6 @@ import {
3
3
  createSentinelStripper,
4
4
  stripTokenizerSentinels
5
5
  } from "./chunk-CFGTUFWB.js";
6
- import {
7
- readSettings
8
- } from "./chunk-AD2SYQYC.js";
9
- import {
10
- THINKING_LEVELS
11
- } from "./chunk-4OC57DA6.js";
12
6
  import {
13
7
  authNotRequiredStatus,
14
8
  openAuthStorage,
@@ -16,18 +10,24 @@ import {
16
10
  resolveAuthTarget,
17
11
  resolveRuntimeAuthTarget,
18
12
  targetRequiresAuth
19
- } from "./chunk-4VP4KH3K.js";
13
+ } from "./chunk-JRIO5UD2.js";
14
+ import {
15
+ ceilChars,
16
+ estimateAgentMessageTokens,
17
+ toolSchemaChars
18
+ } from "./chunk-GEYXPTRF.js";
19
+ import {
20
+ readSettings
21
+ } from "./chunk-UHXRNZ2J.js";
22
+ import {
23
+ THINKING_LEVELS
24
+ } from "./chunk-4DGYLA73.js";
20
25
  import {
21
26
  sleep
22
27
  } from "./chunk-FQ4SKYE4.js";
23
28
  import {
24
29
  withStateFileLock
25
30
  } from "./chunk-IKCO5N3L.js";
26
- import {
27
- ceilChars,
28
- estimateAgentMessageTokens,
29
- toolSchemaChars
30
- } from "./chunk-GEYXPTRF.js";
31
31
  import {
32
32
  activateExternalPluginApiBridge,
33
33
  calculateEngineCost,
@@ -49,7 +49,7 @@ import {
49
49
  } from "./chunk-ZGVHUX3M.js";
50
50
  import {
51
51
  BusChannels
52
- } from "./chunk-G7MUEIGA.js";
52
+ } from "./chunk-OB5HIGJY.js";
53
53
  import {
54
54
  __toESM,
55
55
  init_esm_shims
@@ -7740,4 +7740,4 @@ export {
7740
7740
  normalizeCostProvenance,
7741
7741
  ProvidersDomainModule
7742
7742
  };
7743
- //# sourceMappingURL=chunk-DJVECN66.js.map
7743
+ //# sourceMappingURL=chunk-VQNODYQ4.js.map
@@ -1,10 +1,10 @@
1
1
  import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
2
2
  import {
3
3
  durableAssistantTextFromEvent
4
- } from "./chunk-QM3F2GKX.js";
4
+ } from "./chunk-UUANF5CR.js";
5
5
  import {
6
6
  responseModelIdObservationFromRecord
7
- } from "./chunk-CJUB2JJ2.js";
7
+ } from "./chunk-6TUKSZVF.js";
8
8
  import {
9
9
  init_esm_shims
10
10
  } from "./chunk-3R73A4XB.js";
@@ -34,4 +34,4 @@ export {
34
34
  assistantTextFromEvent,
35
35
  receiptResponseModelIdObservationLabel
36
36
  };
37
- //# sourceMappingURL=chunk-3BPUFZDL.js.map
37
+ //# sourceMappingURL=chunk-VREKEFLL.js.map
@@ -2,22 +2,22 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
2
2
  import {
3
3
  canonicalJson,
4
4
  sha256
5
- } from "./chunk-QM3F2GKX.js";
5
+ } from "./chunk-UUANF5CR.js";
6
6
  import {
7
7
  addResponseModelIdObservationCount,
8
8
  emptyResponseModelIdObservationCounts,
9
9
  responseModelIdObservationFromRecord
10
- } from "./chunk-CJUB2JJ2.js";
10
+ } from "./chunk-6TUKSZVF.js";
11
11
  import {
12
12
  ToolNames
13
13
  } from "./chunk-CGKSTWHD.js";
14
- import {
15
- settingsPath
16
- } from "./chunk-AD2SYQYC.js";
17
14
  import {
18
15
  ceilChars,
19
16
  extractReasoningTokens
20
17
  } from "./chunk-GEYXPTRF.js";
18
+ import {
19
+ settingsPath
20
+ } from "./chunk-UHXRNZ2J.js";
21
21
  import {
22
22
  expandConfigPath
23
23
  } from "./chunk-SST6Z5JA.js";
@@ -1094,4 +1094,4 @@ export {
1094
1094
  readFileArgsAsync,
1095
1095
  expandInlineFileReferencesAsync
1096
1096
  };
1097
- //# sourceMappingURL=chunk-PBTHKCPN.js.map
1097
+ //# sourceMappingURL=chunk-WJHBC77E.js.map
@@ -4,7 +4,7 @@ import {
4
4
  } from "./chunk-ZGVHUX3M.js";
5
5
  import {
6
6
  BusChannels
7
- } from "./chunk-G7MUEIGA.js";
7
+ } from "./chunk-OB5HIGJY.js";
8
8
  import {
9
9
  init_esm_shims
10
10
  } from "./chunk-3R73A4XB.js";
@@ -226,4 +226,4 @@ export {
226
226
  runWithBudget,
227
227
  getTerminationCoordinator
228
228
  };
229
- //# sourceMappingURL=chunk-XE2VEJHX.js.map
229
+ //# sourceMappingURL=chunk-X2KV5FXT.js.map