@desplega.ai/agent-swarm 2.8.3 → 2.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (597) hide show
  1. package/dist/acp-adapter-g909b5hw.js +16 -0
  2. package/dist/acp-targets-ny75x1qy.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-b9qgrmeq.js} +82 -21
  4. package/dist/agent-fs-provision-b5dhdsbd.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-vtax2c9s.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-r5xf5hqw.js} +37 -37
  7. package/dist/{app-mkptw0k7.js → app-g2z15hax.js} +9 -4
  8. package/dist/approval-notifications-yt13wp8r.js +23 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-2cgfxsgk.js} +56 -33
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-4vb0xsat.js → boot-args-schema-3gwy0f60.js} +1 -1
  12. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-92g7s5zp.js} +1 -1
  13. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-mywmyp4s.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-7dkdzqxx.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-ce7rvgq1.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-3m4q7735.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-t8nfgcgz.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-c217draw.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-7fbqm51z.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-sdvcrq5x.js → cli-1jykg0py.js} +18 -14
  23. package/dist/{cli-k96cecs7.js → cli-2czxfnvj.js} +1221 -357
  24. package/dist/{cli-qmqt520k.js → cli-2dq9yv8p.js} +2 -2
  25. package/dist/{cli-e2w34h6z.js → cli-2xs8tsf7.js} +132 -85
  26. package/dist/{cli-z8cvws4c.js → cli-2yjj3e31.js} +907 -56
  27. package/dist/{cli-mdpbjnzq.js → cli-32djehja.js} +42 -42
  28. package/dist/{cli-gpz1d0t2.js → cli-3j873zxq.js} +4 -4
  29. package/dist/cli-43ms35q9.js +270 -0
  30. package/dist/cli-47hz21se.js +25584 -0
  31. package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
  32. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  33. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/{cli-4ax9mvvg.js → cli-67mwzr35.js} +9 -9
  36. package/dist/{cli-t5ys4ebm.js → cli-6945ywhr.js} +3 -3
  37. package/dist/{cli-0bcgyj5b.js → cli-6ehs4mta.js} +87 -8
  38. package/dist/{cli-6yygkr0w.js → cli-6ym4jhzp.js} +15 -7
  39. package/dist/{cli-8bpgbr8k.js → cli-7evph51z.js} +5 -5
  40. package/dist/{cli-dtdht77h.js → cli-7mv4h3sn.js} +2 -2
  41. package/dist/{cli-nx2n3z6p.js → cli-7sf9sb0w.js} +3 -2
  42. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  43. package/dist/cli-8zh9nrew.js +78 -0
  44. package/dist/cli-9ttx00s3.js +137 -0
  45. package/dist/{cli-x6t50dmw.js → cli-9w8712tq.js} +620 -281
  46. package/dist/{cli-8476gtwf.js → cli-b6px1k1q.js} +1 -1
  47. package/dist/{cli-k2rw11py.js → cli-b91nz213.js} +5 -5
  48. package/dist/{cli-7c5tgqhf.js → cli-bg63qmsx.js} +10 -10
  49. package/dist/{cli-qps8je6j.js → cli-bkjdknnp.js} +54 -10
  50. package/dist/{cli-gn9y6fn7.js → cli-bnqncekd.js} +2 -2
  51. package/dist/{cli-s7zz734a.js → cli-br0924pw.js} +1 -1
  52. package/dist/{cli-h9yy18gy.js → cli-ctx0b85j.js} +5484 -5078
  53. package/dist/{cli-0vksaxvr.js → cli-dgs10ttj.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  57. package/dist/{cli-c0xjnr8z.js → cli-f3jyzq4g.js} +2 -2
  58. package/dist/cli-f8x9drqr.js +84 -0
  59. package/dist/{cli-ztq5z4e1.js → cli-f9gz2vyj.js} +6 -6
  60. package/dist/{cli-bhsfbmk8.js → cli-fh97xn30.js} +93 -44
  61. package/dist/cli-fkef327x.js +103 -0
  62. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  63. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  64. package/dist/{cli-1m96dc36.js → cli-gfy38pvt.js} +3 -3
  65. package/dist/{cli-922z7gwm.js → cli-h9yqfzx9.js} +15 -11
  66. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  67. package/dist/{cli-c3ng0mb4.js → cli-j7svy295.js} +71 -818
  68. package/dist/{cli-yss07azk.js → cli-jaw5v1sy.js} +3 -3
  69. package/dist/cli-jkw6ptfw.js +921 -0
  70. package/dist/{cli-s8p8hhty.js → cli-jm0hvmz2.js} +2 -2
  71. package/dist/{cli-knva3nmx.js → cli-jwampxxq.js} +8 -6
  72. package/dist/cli-kj0hyr43.js +51 -0
  73. package/dist/{cli-tnzebztn.js → cli-kpgcm7xy.js} +13 -1
  74. package/dist/{cli-9zmb7ptc.js → cli-kxx4k2jw.js} +8 -753
  75. package/dist/{cli-am1ptset.js → cli-m7c2380k.js} +208 -194
  76. package/dist/{cli-kw44j53p.js → cli-m7zvgt57.js} +45 -38
  77. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  78. package/dist/{cli-54qr8mcd.js → cli-mhapr559.js} +4 -4
  79. package/dist/{cli-tf79ryyy.js → cli-mjw0yf82.js} +3 -3
  80. package/dist/{cli-rjvsf9qa.js → cli-mkwkwq81.js} +14 -11
  81. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  82. package/dist/{cli-awwptga4.js → cli-mw620q3n.js} +1 -1
  83. package/dist/{cli-6wj7p986.js → cli-n3qe7tyr.js} +172 -168
  84. package/dist/{cli-4dpkjc2e.js → cli-nafvvsp8.js} +9 -9
  85. package/dist/{cli-sg27rk2t.js → cli-nbt14he0.js} +25 -19
  86. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  87. package/dist/{cli-zdaypkq9.js → cli-p4kckx1z.js} +285 -97
  88. package/dist/{cli-n5t077me.js → cli-pb2ay3sh.js} +10 -3
  89. package/dist/{cli-t4dv07kr.js → cli-psffsanb.js} +4 -3
  90. package/dist/{cli-mwwmka77.js → cli-pyjn0qhk.js} +2712 -268
  91. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  93. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  94. package/dist/{cli-tas6ckky.js → cli-rq5rpv6k.js} +2 -2
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-kmemts3w.js → cli-sn650d7x.js} +39 -69
  97. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  98. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  99. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  100. package/dist/{cli-me0r8gzr.js → cli-td9tb872.js} +27 -25
  101. package/dist/cli-tvc4jag9.js +754 -0
  102. package/dist/{cli-6ek0hff4.js → cli-ty3gha1p.js} +4 -4
  103. package/dist/{cli-c71n3bxq.js → cli-v57d7fmm.js} +2 -2
  104. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  105. package/dist/cli-vt89089n.js +296 -0
  106. package/dist/{cli-pxwtcgcp.js → cli-vyff45ve.js} +2 -2
  107. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  108. package/dist/{cli-bj6qhgte.js → cli-w4n323t3.js} +197 -45
  109. package/dist/{cli-rqfvkx5t.js → cli-wn13hhdt.js} +13 -13
  110. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  111. package/dist/{cli-zeaehgyd.js → cli-xag7btpe.js} +2 -2
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-dpsfwh7n.js → cli-y2ewxhth.js} +56 -31
  115. package/dist/{cli-vx421edw.js → cli-ysvspf5e.js} +9 -7
  116. package/dist/{cli-crpf163n.js → cli-zh0e5x7p.js} +16 -26
  117. package/dist/{cli-4e1hfbpq.js → cli-zr6qy15y.js} +24 -24
  118. package/dist/cli.js +33 -29
  119. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-n656pvb8.js} +9 -8
  120. package/dist/{codex-hook-c930c3ea.js → codex-hook-59atdwd8.js} +6 -6
  121. package/dist/{codex-login-cbrs1h5w.js → codex-login-a239g1ah.js} +1 -1
  122. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-p0fbv5y9.js} +10 -9
  123. package/dist/{commands-wn9q06qr.js → commands-gwea8z5p.js} +3 -3
  124. package/dist/{controller-fw608czd.js → controller-t67c3grh.js} +9 -6
  125. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-ks155r0h.js} +28 -25
  126. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-ygwrtmkv.js} +2 -2
  127. package/dist/{db-y4wfrzbm.js → db-kpmx06s9.js} +21 -13
  128. package/dist/{db-0m6v5tq4.js → db-rb2xqdb1.js} +3 -3
  129. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  130. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-31sm0ej2.js} +21 -18
  131. package/dist/{docker-j75atvpt.js → docker-09tkkg0n.js} +47 -8
  132. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-qyxh0w31.js} +2 -2
  133. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  134. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  135. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-00wjscn6.js} +1 -1
  136. package/dist/{embedding-space-wh8de1t9.js → embedding-space-qhw4g68n.js} +6 -6
  137. package/dist/{embeddings-3hpbdtjr.js → embeddings-zdv9ke6x.js} +1 -1
  138. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  139. package/dist/{execute-4bdf8sdy.js → execute-zna8wwr7.js} +1 -1
  140. package/dist/{external-channel-ts2fwqh0.js → external-channel-1ac6t56s.js} +2 -2
  141. package/dist/fx-adapter-sk7n0fzc.js +19 -0
  142. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  143. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  144. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  145. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  146. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  147. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-maq6c9bf.js} +1 -1
  148. package/dist/{google-vertex-fhxaafzw.js → google-vertex-2jgsw2nb.js} +5 -5
  149. package/dist/grok-adapter-sjbcm5ew.js +19 -0
  150. package/dist/handlers-yzy0c87x.js +35 -0
  151. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-2f6z4kdx.js} +24 -21
  152. package/dist/{hook-gaehe2w5.js → hook-8y0gvtp1.js} +14 -14
  153. package/dist/{hook-ca54yd4s.js → hook-w1skzaqc.js} +5 -5
  154. package/dist/{http-jfg8t2yk.js → http-wghxvpef.js} +2333 -589
  155. package/dist/{index-d6wkh8ar.js → index-0h6qd4p1.js} +34 -24
  156. package/dist/index-25pvya7q.js +40 -0
  157. package/dist/index-2t4859r5.js +35 -0
  158. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  159. package/dist/{index-khe3gp0k.js → index-4k7m5dgj.js} +645 -370
  160. package/dist/index-620y7jzq.js +15 -0
  161. package/dist/{index-gjwaqaq8.js → index-8p0j4h4j.js} +506 -43
  162. package/dist/{index-3gv6sc4z.js → index-8zn8nxn5.js} +1 -1
  163. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  164. package/dist/{index-3yvzbhxd.js → index-9zkchs9t.js} +336 -193
  165. package/dist/{index-0rvk3vd4.js → index-b5wgnm78.js} +47 -47
  166. package/dist/index-cxca2t8y.js +36 -0
  167. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  168. package/dist/{index-hjhfk3ra.js → index-pe3d8jfy.js} +3 -3
  169. package/dist/index-rv89fvzf.js +572 -0
  170. package/dist/{index-csgrxedz.js → index-s71ez27v.js} +1 -1
  171. package/dist/{keepalive-k2a3qe73.js → keepalive-sh02349h.js} +4 -4
  172. package/dist/lead-gk4h5eg7.js +74 -0
  173. package/dist/{maintenance-gb5sd5nc.js → maintenance-yj0dcjja.js} +1 -1
  174. package/dist/{node-252anz2h.js → node-dqm4xgxw.js} +4 -4
  175. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  176. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-d9xedk66.js} +3 -3
  177. package/dist/{onboard-jmc5qerv.js → onboard-dpgjn03r.js} +8 -8
  178. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  179. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  180. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-2d31cpjc.js} +7 -6
  181. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-1skarpfq.js} +110 -110
  182. package/dist/pending-bfmxtx0g.js +82 -0
  183. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-gvppnasy.js} +43 -16
  184. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-c6b325mk.js} +2 -2
  185. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-h80qbdbs.js} +3 -3
  186. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-zfcx68tx.js} +10 -3
  187. package/dist/{render-v2-1gfpd8rj.js → render-v2-nx20t3rb.js} +7 -4
  188. package/dist/{resume-w1s1eh5v.js → resume-5ep8agan.js} +11 -7
  189. package/dist/{runtime-84g5egsc.js → runtime-r3pj4mce.js} +1 -1
  190. package/dist/{session-access-y6z1txk4.js → session-access-n7p3m15b.js} +4 -4
  191. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-v8mt0zwn.js} +4 -4
  192. package/dist/{setup-r91gstyk.js → setup-z1psaqhe.js} +1 -1
  193. package/dist/thread-buffer-a1re2r9r.js +38 -0
  194. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-rrbjdpxn.js} +5 -5
  195. package/dist/{work-objects-qcxzg61c.js → work-objects-4aghh73z.js} +31 -23
  196. package/dist/worker-3dyyb8ev.js +74 -0
  197. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-166zmex1.js} +21 -18
  198. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  199. package/openapi.json +2561 -131
  200. package/package.json +15 -11
  201. package/plugin/commands/create-pr.md +1 -1
  202. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  203. package/src/apps/action-runner.ts +21 -1
  204. package/src/apps/catalog.generated.json +667 -18
  205. package/src/apps/page-validator.ts +341 -8
  206. package/src/assets/key.ts +6 -0
  207. package/src/be/agent-fs-user-keys.ts +186 -0
  208. package/src/be/audit-user.ts +27 -13
  209. package/src/be/automation-preflight.test.ts +14 -14
  210. package/src/be/automation-preflight.ts +24 -16
  211. package/src/be/boot-scrub-sweep.ts +143 -14
  212. package/src/be/caller-session-group.ts +86 -0
  213. package/src/be/checklist.ts +375 -0
  214. package/src/be/db/agents.ts +12 -1
  215. package/src/be/db/approvals.ts +26 -0
  216. package/src/be/db/model-profiles.ts +4 -1
  217. package/src/be/db/session-costs.ts +219 -0
  218. package/src/be/db/session-log-reasoning.ts +36 -0
  219. package/src/be/db/session-moves.ts +23 -0
  220. package/src/be/db/session-tree.ts +78 -19
  221. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  222. package/src/be/db/tasks/read.ts +7 -3
  223. package/src/be/db/tasks/slack-fold.ts +116 -0
  224. package/src/be/db/tasks/write.ts +67 -1
  225. package/src/be/db-queries/mcp-servers.ts +13 -0
  226. package/src/be/db-queries/oauth.ts +6 -0
  227. package/src/be/db-queries/task-artifacts.ts +10 -8
  228. package/src/be/db.ts +242 -319
  229. package/src/be/extensions/assets.ts +17 -13
  230. package/src/be/import/config.ts +54 -0
  231. package/src/be/import/dir-source.ts +372 -0
  232. package/src/be/import/index.ts +149 -0
  233. package/src/be/import/pending.ts +71 -0
  234. package/src/be/import/schema.ts +137 -0
  235. package/src/be/import/seeders.ts +462 -0
  236. package/src/be/key-window-usage.ts +385 -0
  237. package/src/be/migrations/297_import_ownership.sql +34 -0
  238. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  239. package/src/be/migrations/302_checklist_items.sql +23 -0
  240. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  241. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  242. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  243. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  244. package/src/be/multi-runtime.ts +8 -1
  245. package/src/be/rbac-roles.ts +8 -1
  246. package/src/be/runtime-pools/db.ts +3 -0
  247. package/src/be/runtime-pools/demand.ts +20 -2
  248. package/src/be/runtime-pools/reachability.ts +31 -0
  249. package/src/be/runtime-pools/routing.ts +8 -1
  250. package/src/be/runtime-pools/supervisor.ts +6 -7
  251. package/src/be/savings/read.ts +8 -6
  252. package/src/be/script-credential-broker.ts +2 -2
  253. package/src/be/scripts/typecheck.ts +4 -4
  254. package/src/be/seed/agent-fs-provision.ts +104 -19
  255. package/src/be/seed/index.ts +1 -1
  256. package/src/be/seed/registry.ts +27 -8
  257. package/src/be/seed/runner.ts +1 -1
  258. package/src/be/seed/schedules-seeder.ts +24 -6
  259. package/src/be/seed/seed-toggle.ts +32 -0
  260. package/src/be/seed/types.ts +6 -0
  261. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  262. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  263. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  264. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  265. package/src/be/seed-skills/index.ts +3 -0
  266. package/src/be/steering.ts +27 -4
  267. package/src/be/swarm-config-guard.ts +54 -1
  268. package/src/be/task-citations.ts +8 -5
  269. package/src/be/task-ui-spec.ts +158 -0
  270. package/src/commands/controller.ts +3 -0
  271. package/src/commands/credential-outcome-report.ts +13 -3
  272. package/src/commands/onboard/agent-fs-version.ts +1 -1
  273. package/src/commands/rate-limit-outcome.ts +6 -0
  274. package/src/commands/runner.ts +95 -55
  275. package/src/e2b/env.ts +2 -0
  276. package/src/extensions/catalog.generated.json +17 -0
  277. package/src/extensions/contract-types.generated.ts +1 -1
  278. package/src/github/app.ts +10 -1
  279. package/src/github/handlers.ts +6 -3
  280. package/src/github/reactions.ts +12 -14
  281. package/src/heartbeat/heartbeat.ts +14 -4
  282. package/src/http/agents.ts +19 -10
  283. package/src/http/all-routes.ts +2 -0
  284. package/src/http/api-keys.ts +258 -30
  285. package/src/http/approval-requests.ts +24 -4
  286. package/src/http/apps.ts +69 -5
  287. package/src/http/checklist.ts +176 -0
  288. package/src/http/db-query-bounded.ts +256 -11
  289. package/src/http/db-query-shared.ts +9 -0
  290. package/src/http/favorites.ts +14 -2
  291. package/src/http/fs.ts +346 -1
  292. package/src/http/index.ts +29 -1
  293. package/src/http/kv.ts +13 -0
  294. package/src/http/mcp-oauth.ts +1 -1
  295. package/src/http/mcp-servers.ts +15 -2
  296. package/src/http/onboarding.ts +2 -9
  297. package/src/http/poll.ts +45 -0
  298. package/src/http/script-connections.ts +1 -0
  299. package/src/http/session-data.ts +74 -23
  300. package/src/http/sessions.ts +23 -2
  301. package/src/http/slack-events.ts +101 -0
  302. package/src/http/status.ts +25 -7
  303. package/src/http/task-requester.ts +46 -0
  304. package/src/http/tasks.ts +169 -42
  305. package/src/http/users.ts +14 -0
  306. package/src/http/webhooks.ts +15 -0
  307. package/src/integrations/cards/index.ts +151 -0
  308. package/src/integrations/chat-sdk/outbound.ts +39 -13
  309. package/src/integrations/chat-sdk/relay.ts +87 -0
  310. package/src/integrations/chat-sdk/runtime.ts +7 -1
  311. package/src/integrations/chat-sdk/status.ts +17 -0
  312. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  313. package/src/jira/outbound.ts +5 -3
  314. package/src/kv-reserved-namespaces.ts +17 -2
  315. package/src/linear/outbound.ts +5 -1
  316. package/src/oauth/presets.ts +29 -2
  317. package/src/prompts/base-prompt.ts +25 -4
  318. package/src/prompts/session-templates.ts +102 -8
  319. package/src/providers/acp-targets.ts +1 -1
  320. package/src/providers/amp-adapter.ts +1 -1
  321. package/src/providers/claude-adapter.ts +27 -4
  322. package/src/providers/claude-flag-settings.ts +39 -1
  323. package/src/providers/claude-managed-adapter.ts +5 -1
  324. package/src/providers/codex-adapter.ts +86 -4
  325. package/src/providers/codex-app-server.ts +11 -16
  326. package/src/providers/codex-oauth/auth-json.ts +1 -0
  327. package/src/providers/opencode-adapter.ts +7 -19
  328. package/src/providers/pi-mono-adapter.ts +35 -2
  329. package/src/providers/pricing-sources.md +32 -0
  330. package/src/providers/runtime-dependencies.ts +158 -0
  331. package/src/providers/types.ts +11 -0
  332. package/src/rbac/legacy-policy.ts +2 -0
  333. package/src/rbac/permissions.ts +10 -1
  334. package/src/runtime-providers/docker.ts +65 -1
  335. package/src/scheduler/deferred-task-waits.ts +18 -5
  336. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  337. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  338. package/src/scripts-runtime/egress-secrets.ts +2 -2
  339. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  340. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  341. package/src/scripts-runtime/types/swarm-extension.d.ts +9 -9
  342. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  343. package/src/server.ts +4 -4
  344. package/src/slack/actions.ts +56 -0
  345. package/src/slack/app.ts +107 -59
  346. package/src/slack/assistant.ts +33 -7
  347. package/src/slack/handlers.ts +6 -4
  348. package/src/slack/http-receiver.ts +284 -0
  349. package/src/slack/inbound-dispatch.ts +43 -7
  350. package/src/slack/inbound-files.ts +35 -14
  351. package/src/slack/message-text.ts +47 -4
  352. package/src/slack/render-v2.ts +109 -24
  353. package/src/slack/responses.ts +3 -2
  354. package/src/slack/socket-ack.ts +17 -10
  355. package/src/slack/steering.ts +5 -0
  356. package/src/slack/thread-buffer-store.ts +58 -0
  357. package/src/slack/thread-buffer.ts +341 -57
  358. package/src/slack/work-objects.ts +4 -1
  359. package/src/tasks/context-key.ts +24 -0
  360. package/src/tasks/errors.ts +5 -0
  361. package/src/tasks/sibling-awareness.ts +13 -1
  362. package/src/tests/acp-adapter.test.ts +4 -6
  363. package/src/tests/agent-fs-live-url.test.ts +15 -0
  364. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  365. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  366. package/src/tests/agentfs-proxy.test.ts +8 -8
  367. package/src/tests/api-key-tracking.test.ts +0 -72
  368. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  369. package/src/tests/api-keys-validation.test.ts +42 -0
  370. package/src/tests/approval-card-resolution.test.ts +402 -0
  371. package/src/tests/approval-requests-notifications.test.ts +12 -2
  372. package/src/tests/approval-respond-auth.test.ts +28 -0
  373. package/src/tests/apps-action-parent-task.test.ts +140 -0
  374. package/src/tests/apps-catalog-additions.test.ts +315 -0
  375. package/src/tests/apps-catalog-files.test.ts +114 -0
  376. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  377. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  378. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  379. package/src/tests/apps-catalog-table.test.ts +47 -0
  380. package/src/tests/apps-chart-shell.test.ts +1 -1
  381. package/src/tests/apps-element-assembly.test.ts +52 -3
  382. package/src/tests/apps-session-thread.test.ts +261 -0
  383. package/src/tests/asset-key-invariants.test.ts +14 -0
  384. package/src/tests/base-prompt.test.ts +213 -23
  385. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  386. package/src/tests/caller-session-group.test.ts +199 -0
  387. package/src/tests/cards.test.ts +169 -0
  388. package/src/tests/chat-sdk-relay.test.ts +149 -1
  389. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  390. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  391. package/src/tests/chat-sdk-tools.test.ts +147 -0
  392. package/src/tests/checklist-nudge.test.ts +208 -0
  393. package/src/tests/checklist.test.ts +686 -0
  394. package/src/tests/claude-adapter-binary.test.ts +67 -6
  395. package/src/tests/claude-flag-settings.test.ts +29 -0
  396. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  397. package/src/tests/codex-adapter.test.ts +340 -2
  398. package/src/tests/codex-app-server.test.ts +32 -0
  399. package/src/tests/codex-oauth.test.ts +3 -1
  400. package/src/tests/codex-rate-limits.test.ts +384 -0
  401. package/src/tests/comb-config-guard.test.ts +21 -0
  402. package/src/tests/comb-default.test.ts +59 -97
  403. package/src/tests/comb-links.test.ts +86 -16
  404. package/src/tests/comb-status.test.ts +24 -27
  405. package/src/tests/create-page-tool.test.ts +101 -1
  406. package/src/tests/create-schedule-key.test.ts +105 -0
  407. package/src/tests/credential-broker.test.ts +2 -2
  408. package/src/tests/credential-outcome-report.test.ts +20 -0
  409. package/src/tests/db-query.test.ts +87 -1
  410. package/src/tests/db-task-read-contract.test.ts +4 -0
  411. package/src/tests/db-task-write-contract.test.ts +6 -1
  412. package/src/tests/deferred-task-wake.test.ts +63 -1
  413. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  414. package/src/tests/docs-index-footprint.test.js +11 -3
  415. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  416. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  417. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  418. package/src/tests/extensions-assets.test.ts +7 -3
  419. package/src/tests/extensions-catalog.test.ts +1 -0
  420. package/src/tests/extensions-example-sql-admin-only.test.ts +201 -0
  421. package/src/tests/extensions-pre-task.test.ts +3 -3
  422. package/src/tests/extensions-steering.test.ts +14 -2
  423. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  424. package/src/tests/fetch-resolved-env.test.ts +68 -0
  425. package/src/tests/fixtures/import-package.ts +32 -0
  426. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  427. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  428. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  429. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  430. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  431. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  432. package/src/tests/fs-routes.test.ts +505 -2
  433. package/src/tests/github-ghes-mock.test.ts +196 -0
  434. package/src/tests/github-host.test.ts +285 -0
  435. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  436. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  437. package/src/tests/heartbeat.test.ts +56 -0
  438. package/src/tests/human-thread-routing.test.ts +187 -0
  439. package/src/tests/import-config.test.ts +209 -0
  440. package/src/tests/import.test.ts +464 -0
  441. package/src/tests/invites-http.test.ts +144 -1
  442. package/src/tests/jira-outbound-sync.test.ts +33 -1
  443. package/src/tests/key-window-usage.test.ts +831 -0
  444. package/src/tests/kv-http.test.ts +11 -0
  445. package/src/tests/linear-outbound-sync.test.ts +30 -1
  446. package/src/tests/literal-matcher.test.ts +58 -0
  447. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  448. package/src/tests/oauth-presets.test.ts +12 -0
  449. package/src/tests/pi-mono-adapter.test.ts +79 -0
  450. package/src/tests/pool-affinity.test.ts +50 -0
  451. package/src/tests/preload-env.test.ts +2 -0
  452. package/src/tests/preload.ts +3 -1
  453. package/src/tests/prompt-template-session.test.ts +53 -5
  454. package/src/tests/provider-quota-persistence.test.ts +362 -0
  455. package/src/tests/provider-registration.test.ts +2 -55
  456. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  457. package/src/tests/rate-limit-event.test.ts +22 -0
  458. package/src/tests/rbac-admission.test.ts +19 -0
  459. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  460. package/src/tests/rbac-engine.test.ts +2 -0
  461. package/src/tests/rbac-roles.test.ts +2 -0
  462. package/src/tests/reasoning-events.test.ts +164 -0
  463. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  464. package/src/tests/runner-missing-dependency.test.ts +61 -0
  465. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  466. package/src/tests/runtime-pool-routing.test.ts +52 -0
  467. package/src/tests/runtime-providers-docker.test.ts +91 -0
  468. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  469. package/src/tests/savings-fleet-slices.test.ts +122 -0
  470. package/src/tests/savings-read.test.ts +41 -0
  471. package/src/tests/savings-scripts.test.ts +9 -3
  472. package/src/tests/script-connections.test.ts +7 -0
  473. package/src/tests/script-executor-conformance.test.ts +41 -4
  474. package/src/tests/secret-canary-sweep.test.ts +41 -5
  475. package/src/tests/secret-scrub-gate.test.ts +257 -0
  476. package/src/tests/seed-registry.test.ts +142 -9
  477. package/src/tests/seed-scripts.test.ts +23 -0
  478. package/src/tests/session-cost-attribution.test.ts +748 -0
  479. package/src/tests/session-costs.test.ts +14 -15
  480. package/src/tests/session-logs.test.ts +83 -0
  481. package/src/tests/session-source-keys.test.ts +42 -1
  482. package/src/tests/sessions-detail-batch.test.ts +7 -0
  483. package/src/tests/sessions-move.test.ts +70 -0
  484. package/src/tests/sessions-tree.test.ts +98 -0
  485. package/src/tests/sessions.test.ts +69 -0
  486. package/src/tests/slack-config.test.ts +4 -18
  487. package/src/tests/slack-http-receiver.test.ts +472 -0
  488. package/src/tests/slack-inbound-logging.test.ts +64 -0
  489. package/src/tests/slack-leave-thread.test.ts +1 -1
  490. package/src/tests/slack-message-text.test.ts +104 -0
  491. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  492. package/src/tests/slack-render-v2.test.ts +405 -0
  493. package/src/tests/slack-skip-reaction.test.ts +2 -2
  494. package/src/tests/slack-start-reload-race.test.ts +67 -0
  495. package/src/tests/slack-steering.test.ts +22 -10
  496. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  497. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  498. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  499. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  500. package/src/tests/slack-thread-buffer.test.ts +34 -34
  501. package/src/tests/slack-thread-participants.test.ts +23 -5
  502. package/src/tests/slack-tool-blocks.test.ts +167 -0
  503. package/src/tests/status.test.ts +32 -6
  504. package/src/tests/steering-core.test.ts +13 -0
  505. package/src/tests/steering-enabled.test.ts +7 -1
  506. package/src/tests/steering-promotion.test.ts +24 -0
  507. package/src/tests/subscription-plans.test.ts +20 -1
  508. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  509. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  510. package/src/tests/task-artifacts.test.ts +50 -0
  511. package/src/tests/task-session-prompts.test.ts +95 -1
  512. package/src/tests/task-ui-action-route.test.ts +191 -0
  513. package/src/tests/task-ui-actions.test.ts +195 -0
  514. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  515. package/src/tests/task-ui-spec.test.ts +368 -0
  516. package/src/tests/workflow-agent-task-retry.test.ts +34 -1
  517. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  518. package/src/tools/chat-post.ts +19 -4
  519. package/src/tools/chat-reply.ts +20 -4
  520. package/src/tools/create-page.ts +21 -4
  521. package/src/tools/defer-task.ts +1 -1
  522. package/src/tools/get-swarm.ts +18 -2
  523. package/src/tools/join-swarm.ts +2 -1
  524. package/src/tools/kv/kv-write-auth.ts +17 -1
  525. package/src/tools/schedules/create-schedule.ts +22 -4
  526. package/src/tools/slack-post.ts +40 -7
  527. package/src/tools/slack-reply.ts +50 -14
  528. package/src/tools/store-progress.ts +69 -3
  529. package/src/types.ts +50 -4
  530. package/src/ui-spec/actions.ts +86 -0
  531. package/src/ui-spec/fallback.ts +19 -0
  532. package/src/ui-spec/slack.ts +17 -0
  533. package/src/ui-spec/validate.ts +169 -0
  534. package/src/utils/codex-rate-limits.ts +159 -0
  535. package/src/utils/constants.ts +60 -138
  536. package/src/utils/credentials.ts +2 -0
  537. package/src/utils/error-tracker.ts +19 -0
  538. package/src/utils/github-host.ts +217 -0
  539. package/src/utils/github-pull-request.ts +8 -5
  540. package/src/utils/literal-matcher.ts +118 -0
  541. package/src/utils/provider-account-telemetry.ts +331 -0
  542. package/src/utils/reasoning-events.ts +107 -0
  543. package/src/utils/secret-scrubber.ts +331 -25
  544. package/src/utils/subscription-plans.ts +11 -59
  545. package/src/utils/task-attachment-links.ts +9 -12
  546. package/src/utils/task-ui-spec.ts +67 -0
  547. package/src/vcs/index.ts +3 -0
  548. package/src/workflows/approval-notifications.ts +188 -12
  549. package/src/workflows/executors/system-one-extraction.ts +14 -7
  550. package/src/workflows/executors/system-one-providers.ts +22 -1
  551. package/src/workflows/task-step-routing.ts +8 -3
  552. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  553. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  554. package/templates/extensions/README.md +1 -0
  555. package/templates/extensions/sql-admin-only/README.md +20 -0
  556. package/templates/extensions/sql-admin-only/hooks.ts +100 -0
  557. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  558. package/templates/import/manifest.schema.json +136 -0
  559. package/templates/import/sources.schema.json +44 -0
  560. package/templates/skills/agent-browser/SKILL.md +1 -1
  561. package/templates/skills/agent-browser/content.md +1 -1
  562. package/templates/skills/apps/SKILL.md +151 -14
  563. package/templates/skills/apps/content.md +151 -14
  564. package/templates/skills/asset-namespaces/content.md +2 -1
  565. package/templates/skills/chat-sdk/content.md +17 -0
  566. package/templates/skills/db-query-guidance/content.md +2 -1
  567. package/templates/skills/scheduling/content.md +27 -0
  568. package/templates/skills/slack-interaction/content.md +12 -2
  569. package/templates/skills/swarm-docs/content.md +1 -0
  570. package/templates/skills/swarm-extensions/config.json +1 -1
  571. package/templates/skills/swarm-extensions/content.md +33 -23
  572. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  573. package/templates/skills/swarm-scripts/content.md +13 -0
  574. package/templates/skills/ui-spec/config.json +14 -0
  575. package/templates/skills/ui-spec/content.md +127 -0
  576. package/templates/skills/work-on-task/SKILL.md +1 -1
  577. package/templates/skills/work-on-task/content.md +1 -1
  578. package/templates/skills/workflow-iterate/content.md +4 -7
  579. package/templates/workflows/dreaming/content.md +2 -2
  580. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  581. package/dist/claude-adapter-r33pqnzx.js +0 -24
  582. package/dist/cli-dns0y538.js +0 -194
  583. package/dist/cli-m2z8jagn.js +0 -12078
  584. package/dist/fx-adapter-1rnxnf56.js +0 -17
  585. package/dist/grok-adapter-efhmf1r8.js +0 -17
  586. package/dist/handlers-anrr3py9.js +0 -32
  587. package/dist/index-2skqtd76.js +0 -12795
  588. package/dist/index-8w2aznds.js +0 -33
  589. package/dist/index-qnjvr362.js +0 -37
  590. package/dist/index-yzxd3sn9.js +0 -32
  591. package/dist/lead-zhxqbfdv.js +0 -69
  592. package/dist/worker-7j2907g6.js +0 -69
  593. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  594. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  595. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  596. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  597. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -59,7 +59,7 @@ export type ExtensionAssetKind = "script" | "schedule" | "workflow" | "skill";
59
59
  * Every script field the install writes. A user edit to any of them (the source, or
60
60
  * only the description) must mark the script as edited.
61
61
  */
62
- type ScriptSpec = {
62
+ export type ScriptSpec = {
63
63
  source: string;
64
64
  description: string;
65
65
  intent: string;
@@ -85,7 +85,7 @@ type ScheduleSpec = {
85
85
  };
86
86
  type SchedulePlan = { kind: "schedule"; name: string; spec: ScheduleSpec; hash: string };
87
87
 
88
- type WorkflowSpec = {
88
+ export type WorkflowSpec = {
89
89
  name: string;
90
90
  description: string | null;
91
91
  definition: ExtensionWorkflowFile["definition"];
@@ -96,12 +96,12 @@ type WorkflowSpec = {
96
96
  };
97
97
  type WorkflowPlan = { kind: "workflow"; name: string; spec: WorkflowSpec; hash: string };
98
98
 
99
- type SkillFileSpec = { path: string; content: string };
99
+ export type SkillFileSpec = { path: string; content: string };
100
100
  /**
101
101
  * Every skill field `updateSkill` can change, except `isEnabled`. A user edit to any
102
102
  * of them (description, scope, model settings, ...) must mark the skill as edited.
103
103
  */
104
- type SkillSpec = {
104
+ export type SkillSpec = {
105
105
  name: string;
106
106
  description: string;
107
107
  content: string;
@@ -188,11 +188,11 @@ function canonicalJson(value: unknown): unknown {
188
188
  return value;
189
189
  }
190
190
 
191
- function hashOf(value: unknown): string {
191
+ export function hashOf(value: unknown): string {
192
192
  return computeContentHash(JSON.stringify(canonicalJson(value)));
193
193
  }
194
194
 
195
- function scriptHash(spec: ScriptSpec): string {
195
+ export function scriptHash(spec: ScriptSpec): string {
196
196
  return hashOf({
197
197
  source: spec.source,
198
198
  description: spec.description,
@@ -203,7 +203,7 @@ function scriptHash(spec: ScriptSpec): string {
203
203
  });
204
204
  }
205
205
 
206
- function liveScriptSpec(script: ScriptRecord): ScriptSpec {
206
+ export function liveScriptSpec(script: ScriptRecord): ScriptSpec {
207
207
  return {
208
208
  source: script.source,
209
209
  description: script.description,
@@ -230,7 +230,7 @@ function liveScheduleSpec(schedule: ScheduledTask): ScheduleSpec {
230
230
  };
231
231
  }
232
232
 
233
- function liveWorkflowSpec(workflow: Workflow): WorkflowSpec {
233
+ export function liveWorkflowSpec(workflow: Workflow): WorkflowSpec {
234
234
  return {
235
235
  name: workflow.name,
236
236
  // An update writes "" for a missing description; hash it as missing.
@@ -243,7 +243,11 @@ function liveWorkflowSpec(workflow: Workflow): WorkflowSpec {
243
243
  };
244
244
  }
245
245
 
246
- function skillSpecOf(content: string, parsed: ParsedSkill): SkillSpec {
246
+ /**
247
+ * `hasFiles`: the skill ships bundled files. Workers fetch `skill_files` only for
248
+ * complex skills, so a skill with files stored as simple loses them on refresh.
249
+ */
250
+ export function skillSpecOf(content: string, parsed: ParsedSkill, hasFiles: boolean): SkillSpec {
247
251
  return {
248
252
  name: parsed.name,
249
253
  description: parsed.description,
@@ -263,11 +267,11 @@ function skillSpecOf(content: string, parsed: ParsedSkill): SkillSpec {
263
267
  sourcePath: null,
264
268
  sourceBranch: "main",
265
269
  sourceHash: null,
266
- isComplex: false,
270
+ isComplex: hasFiles,
267
271
  };
268
272
  }
269
273
 
270
- function liveSkillSpec(skill: Skill): SkillSpec {
274
+ export function liveSkillSpec(skill: Skill): SkillSpec {
271
275
  return {
272
276
  name: skill.name,
273
277
  description: skill.description,
@@ -290,7 +294,7 @@ function liveSkillSpec(skill: Skill): SkillSpec {
290
294
  };
291
295
  }
292
296
 
293
- function skillHash(spec: SkillSpec, files: SkillFileSpec[]): string {
297
+ export function skillHash(spec: SkillSpec, files: SkillFileSpec[]): string {
294
298
  return hashOf({
295
299
  ...spec,
296
300
  files: [...files].sort((a, b) => a.path.localeCompare(b.path)).map((f) => [f.path, f.content]),
@@ -416,7 +420,7 @@ export async function preflightAssets(
416
420
  content: fileContent,
417
421
  }))
418
422
  .sort((a, b) => a.path.localeCompare(b.path));
419
- const spec = skillSpecOf(content, parsed);
423
+ const spec = skillSpecOf(content, parsed, skillFiles.length > 0);
420
424
  skills.push({
421
425
  kind: "skill",
422
426
  name: parsed.name,
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Operator import config. Read from `process.env` after boot injected global
3
+ * `swarm_config` rows (`loadGlobalConfigsIntoEnv`), so a stored row wins over
4
+ * the deployment env like every other config key.
5
+ */
6
+
7
+ import { formatIssues, type ImportSource, ImportSourcesSchema } from "./schema";
8
+
9
+ /** Fixed-text config failure. Never carries the configured value. */
10
+ export class ImportConfigError extends Error {
11
+ constructor(readonly diagnostics: string[]) {
12
+ super(diagnostics.join("; "));
13
+ this.name = "ImportConfigError";
14
+ }
15
+ }
16
+
17
+ function parseText(label: string, text: string, yaml: boolean): unknown {
18
+ try {
19
+ return yaml ? Bun.YAML.parse(text) : JSON.parse(text);
20
+ } catch {
21
+ // The parser message quotes the input; keep it out of the log.
22
+ throw new ImportConfigError([`${label}: cannot parse as ${yaml ? "YAML" : "JSON"}`]);
23
+ }
24
+ }
25
+
26
+ /** The configured sources, or `[]` when neither variable is set (boot unchanged). */
27
+ export async function loadImportSources(
28
+ env: Record<string, string | undefined> = process.env,
29
+ ): Promise<ImportSource[]> {
30
+ const inline = env.SWARM_IMPORT_SOURCES?.trim();
31
+ const file = env.SWARM_IMPORT_SOURCES_FILE?.trim();
32
+ if (!inline && !file) return [];
33
+ if (inline && file) {
34
+ throw new ImportConfigError([
35
+ "set only one of SWARM_IMPORT_SOURCES and SWARM_IMPORT_SOURCES_FILE",
36
+ ]);
37
+ }
38
+
39
+ let raw: unknown;
40
+ let label: string;
41
+ if (inline) {
42
+ label = "SWARM_IMPORT_SOURCES";
43
+ raw = parseText(label, inline, false);
44
+ } else {
45
+ label = "SWARM_IMPORT_SOURCES_FILE";
46
+ const handle = Bun.file(file as string);
47
+ if (!(await handle.exists())) throw new ImportConfigError([`${label}: file not found`]);
48
+ raw = parseText(label, await handle.text(), /\.ya?ml$/i.test(file as string));
49
+ }
50
+
51
+ const parsed = ImportSourcesSchema.safeParse(raw);
52
+ if (!parsed.success) throw new ImportConfigError(formatIssues(label, parsed.error.issues));
53
+ return parsed.data;
54
+ }
@@ -0,0 +1,372 @@
1
+ /**
2
+ * The `dir` import source: reads a package root (read only) and validates
3
+ * every item before the importer writes anything. A package that fails any
4
+ * check throws {@link ImportPackageError} with every diagnostic at once.
5
+ *
6
+ * With a root `swarm-import.{yaml,yml,json}` the manifest lists the items.
7
+ * Without one, the directory convention applies: `workflows/*.{yaml,yml,json}`,
8
+ * `skills/<id>/SKILL.md`, `scripts/*.ts`, `agents/<name>.md`.
9
+ */
10
+
11
+ import { realpath, stat } from "node:fs/promises";
12
+ import { basename, dirname, extname, join, sep } from "node:path";
13
+ import { extractScriptSignature } from "../../scripts-runtime/extract-signature";
14
+ import { validateScriptImports } from "../../scripts-runtime/import-allowlist";
15
+ import { ExtensionWorkflowFileSchema } from "../../types";
16
+ import { IDENTITY_MD_MAX_CHARS } from "../../utils/identity-field-budget";
17
+ import { getExecutorRegistry } from "../../workflows";
18
+ import { validateDefinition } from "../../workflows/definition";
19
+ import { computeContentHash, normalizeSkillFilePath, SKILL_FILE_LIMITS } from "../db";
20
+ import {
21
+ hashOf,
22
+ type ScriptSpec,
23
+ type SkillFileSpec,
24
+ type SkillSpec,
25
+ scriptHash,
26
+ skillHash,
27
+ skillSpecOf,
28
+ type WorkflowSpec,
29
+ } from "../extensions/assets";
30
+ import { extractArgsJsonSchema } from "../scripts/extract-schema";
31
+ import { typecheckScript } from "../scripts/typecheck";
32
+ import { parseSkillContent } from "../skill-parser";
33
+ import {
34
+ formatIssues,
35
+ type ImportManifest,
36
+ ImportManifestSchema,
37
+ type ImportSource,
38
+ } from "./schema";
39
+
40
+ export const MANIFEST_FILENAMES = [
41
+ "swarm-import.yaml",
42
+ "swarm-import.yml",
43
+ "swarm-import.json",
44
+ ] as const;
45
+
46
+ export type ImportedWorkflow = { key: string; spec: WorkflowSpec; hash: string };
47
+ export type ImportedSkill = {
48
+ key: string;
49
+ spec: SkillSpec;
50
+ files: SkillFileSpec[];
51
+ hash: string;
52
+ };
53
+ /** Scripts are keyed by their global name. */
54
+ export type ImportedScript = { key: string; spec: ScriptSpec; hash: string };
55
+ export type ImportedAgent = {
56
+ /** `id:<agent id>` or `name:<agent name>`. */
57
+ key: string;
58
+ agentId: string | null;
59
+ agentName: string | null;
60
+ instructions: { text: string; hash: string } | null;
61
+ /** Local skill ids to install. */
62
+ skills: string[];
63
+ };
64
+
65
+ /** Every kind is optional: an omitted kind imports nothing. */
66
+ export type ImportPackage = {
67
+ workflows: ImportedWorkflow[];
68
+ skills: ImportedSkill[];
69
+ scripts: ImportedScript[];
70
+ agents: ImportedAgent[];
71
+ };
72
+
73
+ export class ImportPackageError extends Error {
74
+ constructor(readonly diagnostics: string[]) {
75
+ super(diagnostics.join("\n"));
76
+ this.name = "ImportPackageError";
77
+ }
78
+ }
79
+
80
+ function parseStructured(file: string, text: string): unknown {
81
+ const yaml = /\.ya?ml$/i.test(file);
82
+ try {
83
+ return yaml ? Bun.YAML.parse(text) : JSON.parse(text);
84
+ } catch {
85
+ // Parser messages quote the input; name the file only.
86
+ throw new ImportPackageError([`${file}: cannot parse as ${yaml ? "YAML" : "JSON"}`]);
87
+ }
88
+ }
89
+
90
+ async function scan(root: string, pattern: string): Promise<string[]> {
91
+ try {
92
+ return (await Array.fromAsync(new Bun.Glob(pattern).scan({ cwd: root, onlyFiles: true })))
93
+ .map((path) => path.split("\\").join("/"))
94
+ .sort();
95
+ } catch {
96
+ return [];
97
+ }
98
+ }
99
+
100
+ /**
101
+ * Read `path` relative to the package root. Symlinks and `..` segments may
102
+ * point anywhere, so the resolved path must stay inside the resolved root.
103
+ */
104
+ async function readText(root: string, path: string): Promise<string | undefined> {
105
+ const resolved = await realpath(join(root, path)).catch(() => null);
106
+ if (resolved === null) return undefined;
107
+ const base = await realpath(root);
108
+ if (resolved !== base && !resolved.startsWith(base + sep)) {
109
+ throw new ImportPackageError([`${path}: resolves outside the package`]);
110
+ }
111
+ const file = Bun.file(resolved);
112
+ return (await file.exists()) ? await file.text() : undefined;
113
+ }
114
+
115
+ const stem = (path: string) => basename(path, extname(path));
116
+
117
+ /** Manifest the directory convention implies. */
118
+ async function conventionManifest(root: string): Promise<unknown> {
119
+ return {
120
+ workflows: (await scan(root, "workflows/*.{yaml,yml,json}")).map((file) => ({
121
+ id: stem(file),
122
+ file,
123
+ })),
124
+ skills: (await scan(root, "skills/*/SKILL.md")).map((file) => ({
125
+ id: basename(dirname(file)),
126
+ dir: dirname(file),
127
+ })),
128
+ scripts: (await scan(root, "scripts/*.ts")).map((file) => ({
129
+ name: stem(file),
130
+ file,
131
+ // shortcut: no description source in the convention; use a manifest for searchable descriptions.
132
+ description: `Imported script ${stem(file)}`,
133
+ })),
134
+ agents: (await scan(root, "agents/*.md")).map((file) => ({
135
+ name: stem(file),
136
+ instructions: file,
137
+ })),
138
+ };
139
+ }
140
+
141
+ async function readManifest(root: string): Promise<unknown> {
142
+ const present: string[] = [];
143
+ for (const name of MANIFEST_FILENAMES) {
144
+ if (await Bun.file(join(root, name)).exists()) present.push(name);
145
+ }
146
+ if (present.length > 1) {
147
+ throw new ImportPackageError([`manifest: found ${present.join(", ")}; keep exactly one`]);
148
+ }
149
+ const name = present[0];
150
+ if (!name) return conventionManifest(root);
151
+ return parseStructured(name, (await readText(root, name)) as string);
152
+ }
153
+
154
+ function duplicates(values: string[]): string[] {
155
+ const seen = new Set<string>();
156
+ const dupes = new Set<string>();
157
+ for (const value of values) {
158
+ if (seen.has(value)) dupes.add(value);
159
+ seen.add(value);
160
+ }
161
+ return [...dupes];
162
+ }
163
+
164
+ async function loadWorkflows(
165
+ root: string,
166
+ manifest: ImportManifest,
167
+ diagnostics: string[],
168
+ ): Promise<ImportedWorkflow[]> {
169
+ const workflows: ImportedWorkflow[] = [];
170
+ for (const entry of manifest.workflows ?? []) {
171
+ const label = `workflow ${entry.id}`;
172
+ const text = await readText(root, entry.file);
173
+ if (text === undefined) {
174
+ diagnostics.push(`${label}: ${entry.file} not found`);
175
+ continue;
176
+ }
177
+ let raw: unknown;
178
+ try {
179
+ raw = parseStructured(entry.file, text);
180
+ } catch (error) {
181
+ diagnostics.push(...(error as ImportPackageError).diagnostics);
182
+ continue;
183
+ }
184
+ const parsed = ExtensionWorkflowFileSchema.safeParse(raw);
185
+ if (!parsed.success) {
186
+ diagnostics.push(...formatIssues(entry.file, parsed.error.issues));
187
+ continue;
188
+ }
189
+ const validation = validateDefinition(parsed.data.definition, getExecutorRegistry());
190
+ if (!validation.valid) {
191
+ diagnostics.push(`${label}: ${validation.errors.join("; ")}`);
192
+ continue;
193
+ }
194
+ const spec: WorkflowSpec = {
195
+ name: parsed.data.name,
196
+ description: parsed.data.description || null,
197
+ definition: parsed.data.definition,
198
+ triggers: parsed.data.triggers ?? [],
199
+ cooldown: parsed.data.cooldown ?? null,
200
+ input: parsed.data.input ?? null,
201
+ triggerSchema: parsed.data.triggerSchema ?? null,
202
+ };
203
+ workflows.push({ key: entry.id, spec, hash: hashOf(spec) });
204
+ }
205
+ for (const name of duplicates(workflows.map((workflow) => workflow.spec.name))) {
206
+ diagnostics.push(`workflows: name "${name}" is used by more than one file`);
207
+ }
208
+ return workflows;
209
+ }
210
+
211
+ /**
212
+ * The checks `upsertSkillFiles` runs at storage time, run before any write.
213
+ * The seeder replaces a skill's whole file set, so `files` is the stored set.
214
+ */
215
+ function assertSkillFileSet(files: SkillFileSpec[]): void {
216
+ let total = 0;
217
+ for (const file of files) {
218
+ const path = normalizeSkillFilePath(file.path);
219
+ const size = Buffer.byteLength(file.content, "utf8");
220
+ if (size > SKILL_FILE_LIMITS.maxFileBytes) {
221
+ throw new Error(`File ${path} exceeds max size ${SKILL_FILE_LIMITS.maxFileBytes}`);
222
+ }
223
+ total += size;
224
+ }
225
+ if (files.length > SKILL_FILE_LIMITS.maxCount) {
226
+ throw new Error(`Skill file count exceeds max ${SKILL_FILE_LIMITS.maxCount}`);
227
+ }
228
+ if (total > SKILL_FILE_LIMITS.maxTotalBytes) {
229
+ throw new Error(`Skill files exceed max total size ${SKILL_FILE_LIMITS.maxTotalBytes}`);
230
+ }
231
+ }
232
+
233
+ async function loadSkills(
234
+ root: string,
235
+ manifest: ImportManifest,
236
+ diagnostics: string[],
237
+ ): Promise<ImportedSkill[]> {
238
+ const skills: ImportedSkill[] = [];
239
+ for (const entry of manifest.skills ?? []) {
240
+ const label = `skill ${entry.id}`;
241
+ const content = await readText(root, `${entry.dir}/SKILL.md`);
242
+ if (content === undefined) {
243
+ diagnostics.push(`${label}: ${entry.dir}/SKILL.md not found`);
244
+ continue;
245
+ }
246
+ const files: SkillFileSpec[] = [];
247
+ for (const path of await scan(join(root, entry.dir, "files"), "**/*")) {
248
+ files.push({ path, content: (await readText(root, `${entry.dir}/files/${path}`)) ?? "" });
249
+ }
250
+ let spec: SkillSpec;
251
+ try {
252
+ spec = skillSpecOf(content, parseSkillContent(content), files.length > 0);
253
+ assertSkillFileSet(files);
254
+ } catch (error) {
255
+ diagnostics.push(`${label}: ${(error as Error).message}`);
256
+ continue;
257
+ }
258
+ skills.push({ key: entry.id, spec, files, hash: skillHash(spec, files) });
259
+ }
260
+ for (const name of duplicates(skills.map((skill) => skill.spec.name))) {
261
+ diagnostics.push(`skills: name "${name}" is used by more than one SKILL.md`);
262
+ }
263
+ return skills;
264
+ }
265
+
266
+ async function loadScripts(
267
+ root: string,
268
+ manifest: ImportManifest,
269
+ diagnostics: string[],
270
+ ): Promise<ImportedScript[]> {
271
+ const scripts: ImportedScript[] = [];
272
+ for (const entry of manifest.scripts ?? []) {
273
+ const label = `script ${entry.name}`;
274
+ const source = await readText(root, entry.file);
275
+ if (source === undefined) {
276
+ diagnostics.push(`${label}: ${entry.file} not found`);
277
+ continue;
278
+ }
279
+ const imports = validateScriptImports(source);
280
+ if (!imports.ok) {
281
+ diagnostics.push(`${label}: ${imports.diagnostic}`);
282
+ continue;
283
+ }
284
+ const typecheck = await typecheckScript(source);
285
+ if (!typecheck.ok) {
286
+ diagnostics.push(...typecheck.diagnostics.map((line) => `${label} (${entry.file}): ${line}`));
287
+ continue;
288
+ }
289
+ const spec: ScriptSpec = {
290
+ source,
291
+ description: entry.description,
292
+ intent: entry.intent ?? entry.description,
293
+ signatureJson: JSON.stringify(extractScriptSignature(source)),
294
+ argsJsonSchema: await extractArgsJsonSchema(source),
295
+ fsMode: "none",
296
+ };
297
+ scripts.push({ key: entry.name, spec, hash: scriptHash(spec) });
298
+ }
299
+ return scripts;
300
+ }
301
+
302
+ async function loadAgents(
303
+ root: string,
304
+ manifest: ImportManifest,
305
+ diagnostics: string[],
306
+ ): Promise<ImportedAgent[]> {
307
+ const skillIds = new Set((manifest.skills ?? []).map((skill) => skill.id));
308
+ const agents: ImportedAgent[] = [];
309
+ for (const entry of manifest.agents ?? []) {
310
+ const key = entry.id !== undefined ? `id:${entry.id}` : `name:${entry.name}`;
311
+ const label = `agent ${key}`;
312
+ let instructions: ImportedAgent["instructions"] = null;
313
+ if (entry.instructions !== undefined) {
314
+ const text = await readText(root, entry.instructions);
315
+ if (text === undefined) {
316
+ diagnostics.push(`${label}: ${entry.instructions} not found`);
317
+ continue;
318
+ }
319
+ if (text.length > IDENTITY_MD_MAX_CHARS) {
320
+ diagnostics.push(
321
+ `${label}: ${entry.instructions} is longer than ${IDENTITY_MD_MAX_CHARS} characters`,
322
+ );
323
+ continue;
324
+ }
325
+ instructions = { text, hash: computeContentHash(text) };
326
+ }
327
+ const unknown = (entry.skills ?? []).filter((id) => !skillIds.has(id));
328
+ if (unknown.length > 0) {
329
+ diagnostics.push(`${label}: skills not declared in this package: ${unknown.join(", ")}`);
330
+ continue;
331
+ }
332
+ agents.push({
333
+ key,
334
+ agentId: entry.id ?? null,
335
+ agentName: entry.name ?? null,
336
+ instructions,
337
+ skills: [...new Set(entry.skills ?? [])],
338
+ });
339
+ }
340
+ return agents;
341
+ }
342
+
343
+ /** Load and validate a whole package. Reads only; never writes to `source.path`. */
344
+ export async function loadDirPackage(source: ImportSource): Promise<ImportPackage> {
345
+ const root = source.path;
346
+ const info = await stat(root).catch(() => null);
347
+ if (!info?.isDirectory()) throw new ImportPackageError(["path: not a readable directory"]);
348
+
349
+ const parsed = ImportManifestSchema.safeParse(await readManifest(root));
350
+ if (!parsed.success) throw new ImportPackageError(formatIssues("manifest", parsed.error.issues));
351
+ const manifest = parsed.data;
352
+
353
+ const diagnostics: string[] = [];
354
+ const kinds = {
355
+ workflows: (manifest.workflows ?? []).map((item) => item.id),
356
+ skills: (manifest.skills ?? []).map((item) => item.id),
357
+ scripts: (manifest.scripts ?? []).map((item) => item.name),
358
+ agents: (manifest.agents ?? []).map((item) => item.id ?? `name:${item.name}`),
359
+ };
360
+ for (const [kind, ids] of Object.entries(kinds)) {
361
+ for (const id of duplicates(ids)) diagnostics.push(`${kind}: "${id}" is declared twice`);
362
+ }
363
+
364
+ const pkg: ImportPackage = {
365
+ workflows: await loadWorkflows(root, manifest, diagnostics),
366
+ skills: await loadSkills(root, manifest, diagnostics),
367
+ scripts: await loadScripts(root, manifest, diagnostics),
368
+ agents: await loadAgents(root, manifest, diagnostics),
369
+ };
370
+ if (diagnostics.length > 0) throw new ImportPackageError(diagnostics);
371
+ return pkg;
372
+ }
@@ -0,0 +1,149 @@
1
+ /**
2
+ * File-based resource import (#2494). Called once at API boot, after the
3
+ * built-in seeders. With no source configured it does nothing.
4
+ *
5
+ * Per source: load and validate the whole package (nothing is written when
6
+ * any item fails), resolve ownership, run the kind seeders, install skill
7
+ * assignments, and store assignments for agents that have not registered.
8
+ * Every failure is logged and contained; boot always continues.
9
+ */
10
+
11
+ import { getDbClient } from "../db";
12
+ import { runSeeder } from "../seed/runner";
13
+ import type { SeederResult } from "../seed/types";
14
+ import { ImportConfigError, loadImportSources } from "./config";
15
+ import { type ImportPackage, ImportPackageError, loadDirPackage } from "./dir-source";
16
+ import type { ImportSource } from "./schema";
17
+ import { installImportedSkills, prepareSeeders } from "./seeders";
18
+
19
+ export type ImportReport = {
20
+ sourceId: string;
21
+ /** Why the import stopped. `validate`: the package was invalid and nothing was written. */
22
+ error?: string[];
23
+ failedAt?: "validate" | "apply";
24
+ results: SeederResult[];
25
+ conflicts: string[];
26
+ /** `agent <key>: ...` lines; resolved when that agent registers. */
27
+ unresolved: string[];
28
+ installed: number;
29
+ };
30
+
31
+ async function storePending(source: ImportSource, pkg: ImportPackage, keys: Set<string>) {
32
+ await getDbClient().transaction(async (tx) => {
33
+ // Rewritten on every import, so an entry removed from the package drops out.
34
+ await tx.run("DELETE FROM import_pending_assignments WHERE sourceId = ?", [source.id]);
35
+ const now = new Date().toISOString();
36
+ for (const agent of pkg.agents.filter((entry) => keys.has(entry.key))) {
37
+ await tx.run(
38
+ `INSERT INTO import_pending_assignments
39
+ (sourceId, agentKey, agentId, agentName, instructions, instructionsHash, skillKeys, createdAt)
40
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
41
+ [
42
+ source.id,
43
+ agent.key,
44
+ agent.agentId,
45
+ agent.agentName,
46
+ agent.instructions?.text ?? null,
47
+ agent.instructions?.hash ?? null,
48
+ JSON.stringify(agent.skills),
49
+ now,
50
+ ],
51
+ );
52
+ }
53
+ });
54
+ }
55
+
56
+ /** Import one source. Never throws. */
57
+ export async function importSource(source: ImportSource): Promise<ImportReport> {
58
+ const report: ImportReport = {
59
+ sourceId: source.id,
60
+ results: [],
61
+ conflicts: [],
62
+ unresolved: [],
63
+ installed: 0,
64
+ };
65
+ let pkg: ImportPackage;
66
+ try {
67
+ pkg = await loadDirPackage(source);
68
+ } catch (error) {
69
+ report.error =
70
+ error instanceof ImportPackageError ? error.diagnostics : [(error as Error).message];
71
+ report.failedAt = "validate";
72
+ return report;
73
+ }
74
+
75
+ try {
76
+ const prepared = await prepareSeeders(source, pkg);
77
+ report.conflicts = prepared.conflicts;
78
+ for (const seeder of prepared.seeders) {
79
+ report.results.push(await runSeeder(seeder, { quiet: true }));
80
+ }
81
+ for (const { agentId, agent } of prepared.assignments) {
82
+ const { installed, missing } = await installImportedSkills(source.id, agentId, agent.skills);
83
+ report.installed += installed;
84
+ if (missing.length > 0) {
85
+ report.unresolved.push(`agent ${agent.key}: skills not imported: ${missing.join(", ")}`);
86
+ }
87
+ }
88
+ await storePending(source, pkg, new Set(prepared.unresolved.map((agent) => agent.key)));
89
+ for (const agent of prepared.unresolved) {
90
+ report.unresolved.push(
91
+ `agent ${agent.key}: not registered; applies when it registers (instructions: ${agent.instructions ? "yes" : "no"}, skills: ${agent.skills.length})`,
92
+ );
93
+ }
94
+ } catch (error) {
95
+ report.error = [(error as Error).message];
96
+ report.failedAt = "apply";
97
+ }
98
+ return report;
99
+ }
100
+
101
+ function logReport(report: ImportReport): void {
102
+ const tag = `[import:${report.sourceId}]`;
103
+ if (report.error) {
104
+ console.error(
105
+ report.failedAt === "validate"
106
+ ? `${tag} package invalid, nothing imported:`
107
+ : `${tag} import stopped after a write error:`,
108
+ );
109
+ for (const line of report.error) console.error(`${tag} ${line}`);
110
+ }
111
+ for (const r of report.results) {
112
+ if (
113
+ r.created + r.updated + r.skippedUnchanged + r.skippedUserModified + r.failed.length ===
114
+ 0
115
+ ) {
116
+ continue;
117
+ }
118
+ const kind = r.kind.split(":").pop();
119
+ console.log(
120
+ `${tag} ${kind} created=${r.created} updated=${r.updated} unchanged=${r.skippedUnchanged} ` +
121
+ `preserved=${r.skippedUserModified} failed=${r.failed.length}`,
122
+ );
123
+ for (const f of r.failed) console.error(`${tag} FAILED ${kind} ${f.key}: ${f.error}`);
124
+ }
125
+ if (report.installed > 0) console.log(`${tag} skill installs added=${report.installed}`);
126
+ for (const line of report.conflicts) console.warn(`${tag} conflict ${line}`);
127
+ for (const line of report.unresolved) console.warn(`${tag} unresolved ${line}`);
128
+ }
129
+
130
+ /** Boot entry point. Returns one report per configured source. */
131
+ export async function runImports(
132
+ env: Record<string, string | undefined> = process.env,
133
+ ): Promise<ImportReport[]> {
134
+ let sources: ImportSource[];
135
+ try {
136
+ sources = await loadImportSources(env);
137
+ } catch (error) {
138
+ const lines = error instanceof ImportConfigError ? error.diagnostics : ["invalid config"];
139
+ for (const line of lines) console.error(`[import] config ignored: ${line}`);
140
+ return [];
141
+ }
142
+ const reports: ImportReport[] = [];
143
+ for (const source of sources) {
144
+ const report = await importSource(source);
145
+ logReport(report);
146
+ reports.push(report);
147
+ }
148
+ return reports;
149
+ }