@desplega.ai/agent-swarm 2.12.0 → 2.13.0

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 (327) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-86f0sh6g.js} +9 -8
  3. package/dist/{actions-c4chgxp6.js → actions-zv8vcxvr.js} +24 -23
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-jqshb33y.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-gt503ywc.js} +2 -2
  6. package/dist/{app-hn5fftf5.js → app-6t4k5rh1.js} +6 -4
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-fcfw063h.js} +7 -6
  8. package/dist/{assistant-cpjgpjvp.js → assistant-9dzybh12.js} +25 -24
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-h3mp9hgs.js} +7 -6
  15. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-kpbyj2vb.js} +3 -3
  16. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-0efr3wkg.js} +5 -5
  17. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-03dw669q.js} +7 -6
  18. package/dist/{cli-e3ahxq5y.js → cli-0b655smz.js} +4 -4
  19. package/dist/{cli-mcymtvwn.js → cli-0dg7ytxm.js} +89 -11
  20. package/dist/cli-0jkenasr.js +148 -0
  21. package/dist/{cli-c7j31hq9.js → cli-0pazkmd4.js} +3 -3
  22. package/dist/{cli-5tg94mdw.js → cli-117g15t4.js} +8 -11
  23. package/dist/{cli-r14ac1y0.js → cli-1dbv9mj9.js} +1 -1
  24. package/dist/{cli-q8tc22bj.js → cli-1v82d2w6.js} +3 -3
  25. package/dist/{cli-pe3yxedk.js → cli-2jk4s7z1.js} +2 -2
  26. package/dist/{cli-0pp1yjg2.js → cli-2skf1mdf.js} +8 -8
  27. package/dist/{cli-2tw284hj.js → cli-48nvk6sb.js} +1 -1
  28. package/dist/{cli-en6dmkxd.js → cli-49f5jyhh.js} +2 -2
  29. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  30. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  31. package/dist/{cli-yegz2g06.js → cli-6h88mn9q.js} +3 -3
  32. package/dist/{cli-52nfye5j.js → cli-7dbhnsj9.js} +23 -15
  33. package/dist/{cli-04zc3f7b.js → cli-9fsagra4.js} +1 -1
  34. package/dist/{cli-nja15knq.js → cli-9m9kyw77.js} +3 -3
  35. package/dist/{cli-k5jx8jya.js → cli-ajjvqhf3.js} +1 -1
  36. package/dist/{cli-hbvgzjq4.js → cli-avqkr20b.js} +2 -2
  37. package/dist/{cli-yfpc6qy9.js → cli-avxh26pd.js} +46 -15
  38. package/dist/{cli-q2dywc8h.js → cli-b2jh3dyb.js} +4 -4
  39. package/dist/{cli-m5qtmrbc.js → cli-c8v2yvej.js} +2 -2
  40. package/dist/{cli-gfy6hbd9.js → cli-ct8sz3np.js} +17 -10
  41. package/dist/{cli-bz97ff9n.js → cli-dka73bak.js} +1 -1
  42. package/dist/{cli-dkvtfgn4.js → cli-dkejt425.js} +75 -16
  43. package/dist/{cli-sv2r3bw8.js → cli-dnh64e8e.js} +2 -2
  44. package/dist/{cli-kwr5qv5g.js → cli-eb279wn3.js} +2 -2
  45. package/dist/{cli-hhc47ack.js → cli-f1952kjy.js} +2 -2
  46. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  47. package/dist/{cli-eq4kew31.js → cli-fhvk2nvp.js} +24 -11
  48. package/dist/{cli-xf4z5bdn.js → cli-fz9pcjsw.js} +2 -2
  49. package/dist/{cli-fxd1mwtr.js → cli-g6j6ac3h.js} +1 -1
  50. package/dist/{cli-ya3kf4gs.js → cli-gfcv679k.js} +1 -1
  51. package/dist/{cli-55tc8cj4.js → cli-hbq0kwxz.js} +4 -4
  52. package/dist/{cli-39qm0rtm.js → cli-hc6e4tac.js} +28 -149
  53. package/dist/{cli-j5gtytvg.js → cli-hgsxnjyg.js} +13 -10
  54. package/dist/{cli-h70a2mxy.js → cli-hpb9x72z.js} +48 -8
  55. package/dist/{cli-7yn42w6m.js → cli-j53hpbsm.js} +1 -1
  56. package/dist/{cli-12vek61e.js → cli-jj3c5nyb.js} +471 -119
  57. package/dist/{cli-fy4gb74g.js → cli-kde4ky90.js} +1 -1
  58. package/dist/{cli-9qe5y107.js → cli-kspxjftk.js} +1 -1
  59. package/dist/{cli-bp6k9acz.js → cli-mh7pdxe0.js} +16 -16
  60. package/dist/{cli-v9ya390t.js → cli-mz34pxbk.js} +8 -8
  61. package/dist/{cli-ma9ys8rt.js → cli-nc6a8b5b.js} +7 -4
  62. package/dist/{cli-1htmtqc2.js → cli-prf7kz78.js} +49 -49
  63. package/dist/{cli-01tvvtad.js → cli-qec9bynj.js} +3 -3
  64. package/dist/{cli-t75xngj1.js → cli-qhhb30e8.js} +7 -7
  65. package/dist/{cli-73q4g5nx.js → cli-qm3ntjqs.js} +12 -12
  66. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  67. package/dist/{cli-agjbj5x0.js → cli-sdh61g52.js} +37 -19
  68. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  69. package/dist/{cli-5x03v6en.js → cli-sq913bh1.js} +8 -8
  70. package/dist/{cli-b93d81yg.js → cli-t35hx078.js} +1 -1
  71. package/dist/{cli-r0mz92by.js → cli-tn91wc6e.js} +1 -1
  72. package/dist/{cli-wvjqaqcp.js → cli-tstj6e8e.js} +1113 -227
  73. package/dist/{cli-xm34qj8m.js → cli-w14j2z4k.js} +2 -2
  74. package/dist/{cli-eqq0hwvx.js → cli-wndegmns.js} +1 -1
  75. package/dist/{cli-0k1a0sde.js → cli-wrhbym01.js} +6 -6
  76. package/dist/{cli-fyaq4zdv.js → cli-wv20kbr3.js} +6 -6
  77. package/dist/{cli-mq2fbgva.js → cli-wxwv3t11.js} +2 -2
  78. package/dist/{cli-krbcr00p.js → cli-xfjn2kyq.js} +58 -4
  79. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  80. package/dist/{cli-cjqyse9q.js → cli-y4a4458j.js} +3 -3
  81. package/dist/{cli-2amwhyv2.js → cli-y518qkjg.js} +5 -3
  82. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  83. package/dist/cli-yn4kt85g.js +148 -0
  84. package/dist/{cli-n8f0fs3c.js → cli-ytc7fpza.js} +8 -8
  85. package/dist/{cli-e8n0hdzd.js → cli-z64t9pe6.js} +1 -1
  86. package/dist/{cli-72yms3ey.js → cli-zqmmy073.js} +198 -18
  87. package/dist/cli.js +18 -16
  88. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-f3yp0kaj.js} +5 -5
  89. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  90. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-ns4mv70p.js} +5 -5
  91. package/dist/{commands-tsv2vx5b.js → commands-5bzf2tfw.js} +3 -3
  92. package/dist/{controller-ye4sdwsy.js → controller-5xt7kvfm.js} +2 -2
  93. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-0gg13mzp.js} +24 -23
  94. package/dist/core-0fqtbrxa.js +42 -0
  95. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-p0c5zv6r.js} +1 -1
  96. package/dist/{db-g111qn9j.js → db-2s68ycq7.js} +3 -3
  97. package/dist/{db-3r1fyr2n.js → db-q7q639k5.js} +4 -2
  98. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-j2y1q7ae.js} +24 -21
  99. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-pgnkf4st.js} +1 -1
  100. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-0kea97jf.js} +1 -1
  101. package/dist/{embedding-space-kcdn52vz.js → embedding-space-3n6mhhmy.js} +6 -6
  102. package/dist/{embeddings-jnzcd91a.js → embeddings-jfmj6yme.js} +1 -1
  103. package/dist/{execute-74amghty.js → execute-tjrej979.js} +1 -1
  104. package/dist/{external-channel-v9zgxnxz.js → external-channel-jy8w2gg3.js} +2 -2
  105. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  106. package/dist/grok-adapter-4q5tssw0.js +20 -0
  107. package/dist/handlers-qxgfvvsf.js +41 -0
  108. package/dist/{heartbeat-p8pk1msj.js → heartbeat-6tr2w2da.js} +25 -24
  109. package/dist/{hook-p5reemds.js → hook-bpnncsec.js} +76 -17
  110. package/dist/{hook-k1h73zd7.js → hook-fv1jwrv7.js} +6 -5
  111. package/dist/{http-ms1z5xxy.js → http-bpa26czn.js} +785 -181
  112. package/dist/index-0mcxjdsa.js +44 -0
  113. package/dist/{index-kn63q1gr.js → index-52tgbhrw.js} +29 -28
  114. package/dist/index-dz4q23ag.js +40 -0
  115. package/dist/{index-76zzxtzf.js → index-mpj0z9e0.js} +1 -1
  116. package/dist/index-s175jckx.js +39 -0
  117. package/dist/{index-gjn6qfgn.js → index-s8re7mvq.js} +1 -1
  118. package/dist/{index-fbkqhvvj.js → index-w216g9y9.js} +198 -160
  119. package/dist/{keepalive-031js8jz.js → keepalive-d6z12s04.js} +3 -3
  120. package/dist/lead-p3hx7h35.js +79 -0
  121. package/dist/{maintenance-sq9v3qx9.js → maintenance-7kac6g2g.js} +1 -1
  122. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-t1xjetbh.js} +2 -2
  123. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-6rdagg0r.js} +7 -7
  124. package/dist/{onboard-p25yhh7t.js → onboard-32y1cfxy.js} +3 -3
  125. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-enp3v31n.js} +7 -6
  126. package/dist/{otel-impl-ff1gf20m.js → otel-impl-k0tm5ptj.js} +1 -1
  127. package/dist/{pending-hxj5yatb.js → pending-24zebgvs.js} +23 -22
  128. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-yj72xxxe.js} +85 -16
  129. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-cf25x38j.js} +2 -2
  130. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-0wydd22m.js} +3 -3
  131. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-at6crb3r.js} +7 -4
  132. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  133. package/dist/{render-v2-nrdkg9gf.js → render-v2-nvcw0jd7.js} +8 -4
  134. package/dist/{resume-s6ey36rh.js → resume-y4w0k5v3.js} +9 -8
  135. package/dist/{runtime-x0b4pyam.js → runtime-vpe43hx0.js} +1 -1
  136. package/dist/{session-access-xv49tk14.js → session-access-gkyvnfye.js} +5 -4
  137. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-3w2st4m2.js} +2 -2
  138. package/dist/{setup-mj0krk1p.js → setup-axxvqtys.js} +1 -1
  139. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  140. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-y4fqvab5.js} +2 -2
  141. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  142. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-7d92dct1.js} +3 -3
  143. package/dist/{work-objects-pydhzast.js → work-objects-f708e069.js} +27 -25
  144. package/dist/worker-8rg9gz74.js +79 -0
  145. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-0by8wztc.js} +22 -21
  146. package/dist/xlsx-9acfmxr1.js +31534 -0
  147. package/openapi.json +1385 -204
  148. package/package.json +5 -3
  149. package/src/agentmail/handlers.ts +26 -19
  150. package/src/apps/catalog.generated.json +31 -0
  151. package/src/apps/row-store.ts +37 -14
  152. package/src/azure-devops/handlers.ts +2 -0
  153. package/src/be/audit-user.ts +46 -6
  154. package/src/be/db/kv-windows.ts +22 -0
  155. package/src/be/db/session-moves.ts +3 -3
  156. package/src/be/db/session-tree.ts +52 -5
  157. package/src/be/db/skill-audit.ts +17 -0
  158. package/src/be/db/tasks/write.ts +18 -3
  159. package/src/be/db.ts +114 -23
  160. package/src/be/extensions/assets.ts +11 -7
  161. package/src/be/memory/demotion-evidence.ts +2 -2
  162. package/src/be/memory/providers/sqlite-store.ts +151 -18
  163. package/src/be/memory/search-read-worker.ts +60 -0
  164. package/src/be/memory/search-reader.ts +223 -0
  165. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  166. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  167. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  168. package/src/be/model-tier-resolution.ts +18 -1
  169. package/src/be/multi-runtime.ts +17 -0
  170. package/src/be/primitives/object-embed.ts +250 -0
  171. package/src/be/primitives/objects.ts +29 -9
  172. package/src/be/primitives/sheets/service.ts +138 -6
  173. package/src/be/primitives/sheets/xlsx.ts +367 -0
  174. package/src/be/rbac-roles.ts +3 -0
  175. package/src/be/repo-checked-update.ts +4 -4
  176. package/src/be/repo-merge-policy.ts +26 -9
  177. package/src/be/scripts/boot-reembed.ts +6 -0
  178. package/src/be/scripts/db.ts +17 -5
  179. package/src/be/scripts/embeddings.ts +6 -0
  180. package/src/be/scripts/typecheck.ts +43 -2
  181. package/src/be/seed/schedules-seeder.ts +9 -1
  182. package/src/be/seed/workflows-seeder.ts +9 -1
  183. package/src/be/seed-scripts/index.ts +2 -0
  184. package/src/be/seed-skills/index.ts +12 -0
  185. package/src/be/swarm-config-guard.ts +1 -0
  186. package/src/be/unmapped-identities.ts +95 -1
  187. package/src/bitbucket/handlers.ts +2 -0
  188. package/src/commands/onboard/agent-fs-version.ts +1 -1
  189. package/src/event-waits/github.ts +43 -0
  190. package/src/event-waits/index.ts +29 -0
  191. package/src/event-waits/types.ts +51 -0
  192. package/src/extensions/contract-types.generated.ts +1 -1
  193. package/src/extensions/dispatcher.ts +9 -0
  194. package/src/fs/agent-fs-provider.ts +4 -1
  195. package/src/github/handlers.ts +3 -1
  196. package/src/github/pull-request-state.ts +34 -0
  197. package/src/gitlab/handlers.ts +12 -7
  198. package/src/hooks/codex-hook.ts +99 -1
  199. package/src/hooks/hook.ts +85 -11
  200. package/src/hooks/native-tool-hooks.ts +245 -0
  201. package/src/http/all-routes.ts +1 -0
  202. package/src/http/assets.ts +4 -3
  203. package/src/http/comb.ts +2 -2
  204. package/src/http/favorite-owner.ts +2 -2
  205. package/src/http/favorites.ts +3 -2
  206. package/src/http/fs.ts +13 -4
  207. package/src/http/index.ts +2 -0
  208. package/src/http/mcp-bridge.ts +4 -0
  209. package/src/http/objects.ts +265 -0
  210. package/src/http/pages.ts +3 -3
  211. package/src/http/poll.ts +43 -12
  212. package/src/http/repos.ts +7 -6
  213. package/src/http/schedules.ts +10 -6
  214. package/src/http/script-connections.ts +2 -2
  215. package/src/http/scripts.ts +9 -0
  216. package/src/http/sessions.ts +30 -12
  217. package/src/http/skills.ts +17 -0
  218. package/src/http/task-requester.ts +2 -2
  219. package/src/http/tasks.ts +13 -3
  220. package/src/http/tool-hooks.ts +24 -2
  221. package/src/http/trackers/authorize-gate.ts +2 -2
  222. package/src/http/users.ts +136 -1
  223. package/src/http/workflow-events.ts +13 -0
  224. package/src/http/workflows.ts +21 -11
  225. package/src/linear/sync.ts +3 -1
  226. package/src/prompts/base-prompt.ts +35 -13
  227. package/src/prompts/session-templates.ts +25 -0
  228. package/src/providers/acp-targets.ts +1 -1
  229. package/src/providers/amp-adapter.ts +1 -1
  230. package/src/providers/dsh-adapter.ts +1 -1
  231. package/src/providers/opencode-adapter.ts +1 -0
  232. package/src/providers/opencode-swarm-plugin.ts +50 -1
  233. package/src/providers/pi-mono-adapter.ts +139 -9
  234. package/src/providers/pi-mono-extension.ts +69 -0
  235. package/src/providers/runtime-dependencies.ts +1 -1
  236. package/src/rbac/legacy-policy.ts +3 -0
  237. package/src/rbac/permissions.ts +11 -1
  238. package/src/scheduler/deferred-task-waits.ts +170 -13
  239. package/src/scripts-runtime/executors/types.ts +5 -0
  240. package/src/scripts-runtime/loader.ts +8 -0
  241. package/src/scripts-runtime/mcp-client.ts +4 -0
  242. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  243. package/src/scripts-runtime/swarm-config.ts +8 -0
  244. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  245. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  246. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  247. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  248. package/src/server.ts +4 -0
  249. package/src/slack/enrich.ts +81 -21
  250. package/src/slack/handlers.test.ts +55 -2
  251. package/src/slack/handlers.ts +38 -3
  252. package/src/slack/render-v2.ts +19 -0
  253. package/src/slack/session-mirror.ts +208 -0
  254. package/src/slack/thread-participants.ts +0 -5
  255. package/src/slack/watcher.ts +3 -0
  256. package/src/slack/work-objects.test.ts +2 -1
  257. package/src/slack/work-objects.ts +7 -2
  258. package/src/tests/agentmail-filters.test.ts +4 -3
  259. package/src/tests/audit-agent-person.test.ts +825 -0
  260. package/src/tests/audit-updated-by.test.ts +19 -12
  261. package/src/tests/claude-hook-output.test.ts +107 -2
  262. package/src/tests/claude-managed-setup.test.ts +1 -1
  263. package/src/tests/codex-adapter.test.ts +6 -6
  264. package/src/tests/codex-gpt6-release.test.ts +4 -4
  265. package/src/tests/db-task-read-contract.test.ts +1 -0
  266. package/src/tests/db-task-write-contract.test.ts +1 -0
  267. package/src/tests/dsh-adapter.test.ts +1 -1
  268. package/src/tests/extensions-catalog.test.ts +33 -25
  269. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  270. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  271. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  272. package/src/tests/kv-storage.test.ts +3 -0
  273. package/src/tests/memory-search-reader.test.ts +258 -0
  274. package/src/tests/memory-search-stall.test.ts +197 -20
  275. package/src/tests/model-control.test.ts +4 -4
  276. package/src/tests/model-tier-resolution.test.ts +2 -2
  277. package/src/tests/multi-runtime-registration.test.ts +8 -2
  278. package/src/tests/native-tool-hooks.test.ts +188 -0
  279. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  280. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  281. package/src/tests/poll-probe-readonly.test.ts +108 -0
  282. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  283. package/src/tests/prompt-template-session.test.ts +3 -2
  284. package/src/tests/rbac-roles.test.ts +3 -0
  285. package/src/tests/script-connections.test.ts +4 -0
  286. package/src/tests/seed-model-profiles.test.ts +1 -1
  287. package/src/tests/sessions-tree.test.ts +10 -2
  288. package/src/tests/slack-thread-participants.test.ts +66 -4
  289. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  290. package/src/tools/defer-task.ts +154 -12
  291. package/src/tools/objects.ts +10 -5
  292. package/src/tools/repos/update-repo.ts +6 -6
  293. package/src/tools/schedules/create-schedule.ts +1 -0
  294. package/src/tools/schedules/list-schedules.ts +3 -0
  295. package/src/tools/schedules/patch-schedule.ts +12 -3
  296. package/src/tools/schedules/update-schedule.ts +12 -3
  297. package/src/tools/sheets.ts +66 -0
  298. package/src/tools/skills/skill-create.ts +6 -0
  299. package/src/tools/skills/skill-install-remote.ts +6 -0
  300. package/src/tools/skills/skill-sync-remote.ts +9 -0
  301. package/src/tools/skills/skill-update.ts +9 -1
  302. package/src/tools/tool-config.ts +3 -1
  303. package/src/tools/utils.ts +15 -0
  304. package/src/tools/workflows/create-workflow.ts +9 -4
  305. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  306. package/src/tools/workflows/patch-workflow.ts +5 -2
  307. package/src/tools/workflows/update-workflow.ts +13 -7
  308. package/src/types.ts +96 -12
  309. package/src/workflows/input.ts +12 -5
  310. package/src/workflows/patch-definition.ts +13 -5
  311. package/src/workflows/triggers.ts +11 -6
  312. package/src/workflows/version.ts +7 -1
  313. package/templates/skills/boards-and-sheets/config.json +14 -0
  314. package/templates/skills/boards-and-sheets/content.md +163 -0
  315. package/templates/skills/swarm-docs/content.md +9 -0
  316. package/dist/acp-adapter-11m13kx4.js +0 -16
  317. package/dist/core-dxcy02sc.js +0 -41
  318. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  319. package/dist/grok-adapter-t6m74fb1.js +0 -19
  320. package/dist/handlers-9kwcrc4k.js +0 -38
  321. package/dist/index-23cdfzr6.js +0 -39
  322. package/dist/index-g7kkjs5b.js +0 -38
  323. package/dist/index-stk36pa5.js +0 -43
  324. package/dist/lead-mfggjtfk.js +0 -77
  325. package/dist/thread-buffer-temgaqsy.js +0 -41
  326. package/dist/worker-efcemc22.js +0 -77
  327. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
@@ -14,6 +14,7 @@ import {
14
14
  getTrackerSyncByExternalId,
15
15
  updateTrackerSync,
16
16
  } from "../be/db-queries/tracker";
17
+ import { isUnmappedIdentityDismissed } from "../be/unmapped-identities";
17
18
  import { findOrCreateUserByEmail, findUserByExternalId, linkIdentity } from "../be/users";
18
19
  import { ensureToken } from "../oauth/ensure-token";
19
20
  import { resolveTemplate } from "../prompts/resolver";
@@ -431,7 +432,8 @@ async function resolveLinearActor(
431
432
  return linked.id;
432
433
  }
433
434
 
434
- // No mapping + no inline email → unmapped tracker (Q14/Q17.D).
435
+ // No mapping + no inline email → unmapped tracker (Q14/Q17.D), unless an operator dismissed it.
436
+ if (await isUnmappedIdentityDismissed("linear", linearUserId)) return undefined;
435
437
  await upsertKv({
436
438
  namespace: UNMAPPED_NAMESPACE,
437
439
  key: `${linearUserId}:meta`,
@@ -21,7 +21,12 @@
21
21
 
22
22
  import type { ProviderTraits } from "../providers/types";
23
23
  import { getSlackConfiguration } from "../slack/config";
24
- import type { ProviderName, RequestCompositionPartInput } from "../types";
24
+ import {
25
+ agentsMayMerge,
26
+ type ProviderName,
27
+ type RepoMergePolicy,
28
+ type RequestCompositionPartInput,
29
+ } from "../types";
25
30
  import { agentFsFileLinkQuery, getAppUrl, resolveAgentFsLinkBase } from "../utils/constants";
26
31
  import { isEnvFlagEnabled } from "../utils/env-flag";
27
32
  import { isSteeringEnabled } from "../utils/steering-enabled";
@@ -155,6 +160,7 @@ export type RepoContext = {
155
160
  mergeChecks: string[];
156
161
  allowMerge?: boolean;
157
162
  review: string[];
163
+ mergePolicy?: RepoMergePolicy;
158
164
  } | null;
159
165
  };
160
166
 
@@ -506,7 +512,7 @@ export const getTaskContextPrompt = async (args: TaskContextPromptArgs): Promise
506
512
  if (args.repoContext) {
507
513
  const repoResult = await resolveTemplateAsync(
508
514
  "system.agent.repository",
509
- renderRepositoryVars(args.repoContext, { hasMcp, hasLocalEnv, provider }),
515
+ await renderRepositoryVars(args.repoContext, { hasMcp, hasLocalEnv, provider }),
510
516
  );
511
517
  prompt += repoResult.text;
512
518
  }
@@ -577,14 +583,25 @@ function renderToolsAndSkillsVars(input: {
577
583
  };
578
584
  }
579
585
 
586
+ /** The mergePolicy record's swarm auto-merge line, or "" when the repo has no record. */
587
+ function renderSwarmAutoMerge(policy: RepoMergePolicy | undefined): string {
588
+ const auto = policy?.autoMerge;
589
+ if (!auto) return "";
590
+ if (!auto.enabled) return "\n- Swarm auto-merge: off";
591
+ const parts = [`Swarm auto-merge: on (minimum score ${auto.threshold})`];
592
+ if (auto.classes.length > 0) parts.push(`classes: ${auto.classes.join(", ")}`);
593
+ if (auto.riskyPaths.length > 0) parts.push(`never for paths: ${auto.riskyPaths.join(", ")}`);
594
+ return `\n- ${parts.join("; ")}`;
595
+ }
596
+
580
597
  /**
581
598
  * Dynamic parts of `system.agent.repository`. Same split as the tools section:
582
599
  * the heading lives in the template, the per-task pieces are built here.
583
600
  */
584
- function renderRepositoryVars(
601
+ async function renderRepositoryVars(
585
602
  repo: RepoContext,
586
603
  ctx: { hasMcp: boolean; hasLocalEnv: boolean; provider: string },
587
- ): Record<string, string> {
604
+ ): Promise<Record<string, string>> {
588
605
  const vars: Record<string, string> = {
589
606
  clone_note: "",
590
607
  warning: "",
@@ -629,7 +646,11 @@ function renderRepositoryVars(
629
646
  section += `\n### Repository Guidelines\n\nNo repository guidelines are defined. Ask the lead before you push.\n`;
630
647
  } else {
631
648
  const hasAnyContent =
632
- g.prChecks.length > 0 || g.mergeChecks.length > 0 || g.review.length > 0 || g.allowMerge;
649
+ g.prChecks.length > 0 ||
650
+ g.mergeChecks.length > 0 ||
651
+ g.review.length > 0 ||
652
+ agentsMayMerge(g) ||
653
+ g.mergePolicy !== undefined;
633
654
  if (hasAnyContent) {
634
655
  section += `\n### Repository Guidelines (MANDATORY)\n\n`;
635
656
  if (g.prChecks.length > 0) {
@@ -639,14 +660,15 @@ function renderRepositoryVars(
639
660
  });
640
661
  section += `If ANY check fails, fix the issue before pushing. Do NOT push code with failing checks.\nDo NOT use \`--no-verify\` or any flag that bypasses git hooks.\n\n`;
641
662
  }
642
- section += `**Merge Policy:**\n`;
643
- section += `- Auto-merge: ${g.allowMerge ? "Allowed" : "Not allowed (default)"}\n`;
644
- if (g.mergeChecks.length > 0) {
645
- section += `- Before merging, verify:\n`;
646
- g.mergeChecks.forEach((check) => {
647
- section += ` - ${check}\n`;
648
- });
649
- }
663
+ const mergePolicy = await resolveTemplateAsync("system.agent.repository.merge_policy", {
664
+ agents_may_merge: agentsMayMerge(g) ? "Allowed" : "Not allowed (default)",
665
+ swarm_auto_merge: renderSwarmAutoMerge(g.mergePolicy),
666
+ merge_checks:
667
+ g.mergeChecks.length > 0
668
+ ? `\n- Before merging, verify:\n${g.mergeChecks.map((check) => ` - ${check}`).join("\n")}`
669
+ : "",
670
+ });
671
+ section += `${mergePolicy.text}\n`;
650
672
  section += `\n`;
651
673
  if (g.review.length > 0) {
652
674
  section += `**Review Guidance:**\n`;
@@ -614,6 +614,31 @@ registerTemplate({
614
614
  category: "system",
615
615
  });
616
616
 
617
+ registerTemplate({
618
+ eventType: "system.agent.repository.merge_policy",
619
+ header: "",
620
+ defaultBody: `**Merge Policy:**
621
+ - Auto-merge: {{agents_may_merge}}{{swarm_auto_merge}}{{merge_checks}}`,
622
+ variables: [
623
+ {
624
+ name: "agents_may_merge",
625
+ description:
626
+ "'Allowed' or 'Not allowed (default)': the repo's mergePolicy.agentsMayMerge, else its allowMerge guideline.",
627
+ },
628
+ {
629
+ name: "swarm_auto_merge",
630
+ description:
631
+ "Lines for the repo's mergePolicy record (swarm auto-merge state, classes, threshold, risky paths). Empty when the repo has no record.",
632
+ },
633
+ {
634
+ name: "merge_checks",
635
+ description:
636
+ "The 'Before merging, verify' list from the repo's mergeChecks guideline. Empty when there are none.",
637
+ },
638
+ ],
639
+ category: "system",
640
+ });
641
+
617
642
  // ============================================================================
618
643
  // Scripts-only mode (code-mode). Rewrite deferred; see design section 8.
619
644
  // ============================================================================
@@ -480,7 +480,7 @@ const qwenTargetProfile: AcpTargetProfile = {
480
480
  * Kiro CLI reads its prompt from a Kiro agent config, not from a flag or an
481
481
  * env var, so the swarm system prompt is not injected (as with OpenCode).
482
482
  * Kiro advertises no ACP config options (checked on 2.29.1), so the model
483
- * rides on argv as `--model`, which `kiro-cli acp` still accepts in 3.2.0.
483
+ * rides on argv as `--model`, which `kiro-cli acp` still accepts in 3.2.1.
484
484
  */
485
485
  const kiroTargetProfile: AcpTargetProfile = {
486
486
  target: "kiro",
@@ -45,7 +45,7 @@ import type {
45
45
  * default; the image installs exactly this version and the per-task settings
46
46
  * set `amp.updates.mode: "disabled"`. Bump it deliberately, with a live run.
47
47
  */
48
- export const AMP_PACKAGE = "@ampcode/cli@0.0.1794398443-g0895e3";
48
+ export const AMP_PACKAGE = "@ampcode/cli@0.0.1794484845-g2f1e0a";
49
49
 
50
50
  /** MCP server name. Amp exposes its tools as `agent_swarm` / `store_progress` (dashes become underscores). */
51
51
  const AMP_MCP_SERVER_NAME = "agent-swarm";
@@ -37,7 +37,7 @@ import type {
37
37
  } from "./types";
38
38
 
39
39
  // npm's `latest` is older and lacks the JSON/stdin contract used here.
40
- export const DSH_PACKAGE = "@deepseek-ai/dsh@0.2.2-rc.1";
40
+ export const DSH_PACKAGE = "@deepseek-ai/dsh@0.2.2-rc.2";
41
41
 
42
42
  export function checkDshCredentials(env: Record<string, string | undefined>): CredStatus {
43
43
  return env.DEEPSEEK_API_KEY?.trim() || env.OPENROUTER_API_KEY?.trim()
@@ -1085,6 +1085,7 @@ export class OpencodeAdapter implements ProviderAdapter {
1085
1085
  },
1086
1086
  ...(billing ? { onOpenRouterResponse: (response) => billing.observe(response) } : {}),
1087
1087
  onContext: (event) => onContext?.(event),
1088
+ mcpServers: Object.keys(mcp),
1088
1089
  }),
1089
1090
  ],
1090
1091
  log: {
@@ -11,6 +11,13 @@
11
11
  */
12
12
 
13
13
  import type { Plugin } from "@opencode/plugin";
14
+ import {
15
+ canonicalArgs,
16
+ canonicalToolName,
17
+ rawArgsFromCanonical,
18
+ runNativePost,
19
+ runNativePre,
20
+ } from "../hooks/native-tool-hooks";
14
21
  import { renderGoalReminder } from "../prompts/goal-reminder";
15
22
  import {
16
23
  apiHeaders,
@@ -19,6 +26,7 @@ import {
19
26
  fetchTaskDetails,
20
27
  fireAndForget,
21
28
  isTaskCancelled,
29
+ nativeHookTarget,
22
30
  type SwarmHooksConfig,
23
31
  } from "./pi-mono-extension";
24
32
 
@@ -36,6 +44,11 @@ export interface OpencodeSwarmPluginOptions {
36
44
  * agent-loop step, so this sees every primary call.
37
45
  */
38
46
  onContext?: (event: OpencodeRequestContext) => void;
47
+ /**
48
+ * Names of the MCP servers in the session's config. OpenCode keys their tools
49
+ * `<server>_<tool>`; any other tool is a built-in and goes to native-tool extensions.
50
+ */
51
+ mcpServers?: readonly string[];
39
52
  }
40
53
 
41
54
  /** The parts of OpenCode's `context` hook event the request measurement reads. */
@@ -69,10 +82,26 @@ function applyOpencodeShellEnv(
69
82
  }
70
83
  }
71
84
 
85
+ /** True for an OpenCode built-in tool: not keyed `<server>_<tool>` for any configured MCP server. */
86
+ export function isOpencodeBuiltinTool(name: string, mcpServers: readonly string[]): boolean {
87
+ return !mcpServers.some((server) => name.startsWith(`${server}_`));
88
+ }
89
+
72
90
  export function createOpencodeSwarmPlugin(
73
91
  config: SwarmHooksConfig,
74
92
  options: OpencodeSwarmPluginOptions = {},
75
93
  ): Plugin.Plugin {
94
+ const mcpServers = options.mcpServers ?? [];
95
+ /** Built-in calls in flight, so the post report carries a real duration. */
96
+ const nativeStartedAt = new Map<string, number>();
97
+ const nativeCall = (event: { tool: string; id: string; input: unknown }) => ({
98
+ harness: "opencode" as const,
99
+ tool: canonicalToolName(event.tool),
100
+ nativeTool: event.tool,
101
+ args: canonicalArgs(event.input),
102
+ rawArgs: event.input,
103
+ toolCallId: event.id,
104
+ });
76
105
  return {
77
106
  id: "agent-swarm",
78
107
  async setup(ctx) {
@@ -107,9 +136,29 @@ export function createOpencodeSwarmPlugin(
107
136
  "EXIT NOW - do not make any more tool calls.",
108
137
  );
109
138
  }
139
+
140
+ // Extensions with toolSources "native": last, so the guards above win. `event.input` is
141
+ // writable, which is how a rewrite lands; a throw is how a block lands.
142
+ if (isOpencodeBuiltinTool(event.tool, mcpServers)) {
143
+ const decision = await runNativePre(nativeHookTarget(config), nativeCall(event));
144
+ if (decision.action === "block") throw new Error(decision.reason);
145
+ if (decision.action === "modify") {
146
+ event.input = rawArgsFromCanonical(decision.args, event.input);
147
+ }
148
+ nativeStartedAt.set(event.id, Date.now());
149
+ }
110
150
  });
111
151
 
112
- await ctx.tool.hook("execute.after", () => {
152
+ await ctx.tool.hook("execute.after", (event) => {
153
+ if (isOpencodeBuiltinTool(event.tool, mcpServers)) {
154
+ const startedAt = nativeStartedAt.get(event.id);
155
+ nativeStartedAt.delete(event.id);
156
+ void runNativePost(nativeHookTarget(config), nativeCall(event), {
157
+ result: event.status === "completed" ? event.result : event.error,
158
+ isError: event.status === "error",
159
+ durationMs: startedAt === undefined ? 0 : Date.now() - startedAt,
160
+ });
161
+ }
113
162
  if (config.isLead || !config.taskId) return;
114
163
  fireAndForget(`${config.apiUrl}/api/agents/${config.agentId}/activity`, {
115
164
  method: "PUT",
@@ -32,7 +32,9 @@ import {
32
32
  providerKeyVars,
33
33
  } from "@desplega/model-catalog";
34
34
  import { InMemoryCredentialStore } from "@earendil-works/pi-ai";
35
+ import { findEnvKeys } from "@earendil-works/pi-ai/compat";
35
36
  import {
37
+ getBuiltinProviders,
36
38
  getBuiltinModel as getModel,
37
39
  getBuiltinModels as getModels,
38
40
  } from "@earendil-works/pi-ai/providers/all";
@@ -99,6 +101,68 @@ import type {
99
101
  SteerDeliveryResult,
100
102
  } from "./types";
101
103
 
104
+ /**
105
+ * The env var(s) that can satisfy a provider id, for providers pi-ai ships a
106
+ * builtin catalog and an env-key list for (`fireworks`, `deepseek`, `xai`, ...).
107
+ *
108
+ * Derived from pi-ai rather than hardcoded, so a provider pi-ai adds is
109
+ * recognised here on the next bump with no change in this file. `findEnvKeys`
110
+ * is read with an exhaustive env, so it reports the provider's key vars
111
+ * whatever the caller's env holds. Providers pi-ai has no catalog for return
112
+ * `undefined`, and so does a provider whose credential is not a plain key
113
+ * (`amazon-bedrock`, `google-vertex` ADC, `openai-codex`): those have their own
114
+ * branches in `checkPiMonoCredentials` or are not an inference key pi reads
115
+ * from `sessionEnv`.
116
+ *
117
+ * Computed once per process (the catalog is static). A miss falls back to the
118
+ * hardcoded provider cases in `modelToCredKeys` and the permissive branch.
119
+ */
120
+ let piAiKeyVarsByProvider: Map<string, string[]> | undefined;
121
+ function piAiProviderKeyVars(providerId: string): string[] | undefined {
122
+ if (!piAiKeyVarsByProvider) {
123
+ // An env that answers every lookup, so `findEnvKeys` returns the full list.
124
+ const exhaustiveEnv = new Proxy(
125
+ {},
126
+ { get: (_target, name) => (typeof name === "string" ? "probe" : undefined) },
127
+ ) as Record<string, string>;
128
+ const keyVars = new Map<string, string[]>();
129
+ for (const provider of getBuiltinProviders()) {
130
+ const vars = findEnvKeys(provider, exhaustiveEnv)?.filter((name) => !isGatewayTokenVar(name));
131
+ if (vars?.length) keyVars.set(provider, vars);
132
+ }
133
+ piAiKeyVarsByProvider = keyVars;
134
+ }
135
+ return piAiKeyVarsByProvider.get(providerId);
136
+ }
137
+
138
+ /**
139
+ * Anthropic gateway tokens pi-ai's anthropic provider also accepts. They only
140
+ * work against a gateway base URL, which this adapter never writes for a pi
141
+ * session, so they are not an inference credential on their own — the same
142
+ * reason `modelToCredKeys` has always required `ANTHROPIC_API_KEY`.
143
+ */
144
+ function isGatewayTokenVar(name: string): boolean {
145
+ return name === "ANTHROPIC_AUTH_TOKEN" || name === "ANTHROPIC_OAUTH_TOKEN";
146
+ }
147
+
148
+ /**
149
+ * Every env var that satisfies a builtin provider with a chat catalog
150
+ * (`FIREWORKS_API_KEY`, `DEEPSEEK_API_KEY`, ...). This is the set the permissive
151
+ * branch accepts and `createPiRuntimeAuth` forwards, minus the providers that
152
+ * resolve auth another way (Bedrock, Vertex ADC) or have no chat models.
153
+ */
154
+ let piAiInferenceKeyVarsCache: string[] | undefined;
155
+ function piAiInferenceKeyVars(): string[] {
156
+ if (!piAiInferenceKeyVarsCache) {
157
+ const keyVars: string[] = [];
158
+ for (const [envKey] of piRuntimeApiKeys()) {
159
+ if (!keyVars.includes(envKey)) keyVars.push(envKey);
160
+ }
161
+ piAiInferenceKeyVarsCache = keyVars;
162
+ }
163
+ return piAiInferenceKeyVarsCache;
164
+ }
165
+
102
166
  /**
103
167
  * Map a `MODEL_OVERRIDE` string to the env var(s) that can satisfy it.
104
168
  *
@@ -107,9 +171,10 @@ import type {
107
171
  * `OPENROUTER_API_KEY` — in the latter case `resolveModel` swaps to the
108
172
  * OpenRouter mirror of the same model so pi-ai's anthropic-provider env
109
173
  * lookup (which only checks `ANTHROPIC_*`) doesn't fail with "No API key
110
- * found for anthropic". Provider-prefixed model IDs only accept that one
111
- * provider's key. Returns `null` for the permissive case (no MODEL_OVERRIDE
112
- * or bare unprefixed model name).
174
+ * found for anthropic". Provider-prefixed model IDs accept that one
175
+ * provider's key: the pi-ai catalog's key vars when it knows the provider,
176
+ * else the historical hardcoded names. Returns `null` for the permissive
177
+ * case (no MODEL_OVERRIDE or bare unprefixed model name).
113
178
  */
114
179
  function modelToCredKeys(modelStr: string | undefined): string[] | null {
115
180
  if (!modelStr) return null;
@@ -131,6 +196,9 @@ function modelToCredKeys(modelStr: string | undefined): string[] | null {
131
196
  // worker without that step (or a boot-time check) may only see the alias.
132
197
  const direct = openAICompatibleProvider(provider);
133
198
  if (direct) return providerKeyVars(direct);
199
+ // Every other provider pi-ai ships a catalog and env key for.
200
+ const piAiKeyVars = piAiProviderKeyVars(provider);
201
+ if (piAiKeyVars) return piAiKeyVars;
134
202
  }
135
203
  // Bare model name with no provider prefix — adapter falls through to a
136
204
  // best-effort resolution against multiple providers, so the boot loop
@@ -247,10 +315,13 @@ export async function runBedrockSdkProbeAndEnumerate(
247
315
  * `checkProviderCredentials`); the API binary never imports the SDK.
248
316
  * 2. `~/.pi/agent/auth.json` exists.
249
317
  * 3. `MODEL_OVERRIDE` is set to a non-Bedrock provider-prefixed model — only
250
- * the matching provider's key is required.
318
+ * the matching provider's key is required. The key vars come from pi-ai's
319
+ * own per-provider env-key list, so `fireworks/accounts/fireworks/models/
320
+ * deepseek-v4p1-flash` needs `FIREWORKS_API_KEY` without another entry in
321
+ * this file.
251
322
  * 4. `MODEL_OVERRIDE` is empty / unprefixed — any one of the supported
252
- * keys (ANTHROPIC_API_KEY / OPENROUTER_API_KEY / OPENAI_API_KEY) is
253
- * enough.
323
+ * keys is enough, including any key pi-ai resolves an inference
324
+ * credential from (`FIREWORKS_API_KEY`, `DEEPSEEK_API_KEY`, ...).
254
325
  *
255
326
  * The Bedrock branch is checked first so a stale `auth.json` (Anthropic /
256
327
  * OpenRouter creds from a previous login) doesn't get falsely reported as
@@ -381,6 +452,16 @@ export async function checkPiMonoCredentials(
381
452
  ) {
382
453
  return { ready: true, missing: [], satisfiedBy: "env" };
383
454
  }
455
+
456
+ // Any other inference key pi-ai resolves (`FIREWORKS_API_KEY`,
457
+ // `DEEPSEEK_API_KEY`, `XAI_API_KEY`, ...). pi ships the provider and its
458
+ // model catalog, so a task model routes there without a MODEL_OVERRIDE.
459
+ // Only providers with a chat catalog count: a classifier-only entry's key
460
+ // is not an inference credential.
461
+ if (piAiInferenceKeyVars().some((k) => env[k])) {
462
+ return { ready: true, missing: [], satisfiedBy: "env" };
463
+ }
464
+
384
465
  return {
385
466
  ready: false,
386
467
  missing: ["ANTHROPIC_API_KEY", "OPENROUTER_API_KEY", "OPENAI_API_KEY", authFile],
@@ -388,7 +469,9 @@ export async function checkPiMonoCredentials(
388
469
  .map((p) => p.envVar)
389
470
  .join(" or ")} serve only ${openAICompatibleProviders()
390
471
  .map((p) => `${p.id}/*`)
391
- .join(" or ")} models), or run \`pi auth login\` to create ~/.pi/agent/auth.json.`,
472
+ .join(
473
+ " or ",
474
+ )} models). Any other provider key pi resolves works too — FIREWORKS_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, XAI_API_KEY and the rest of pi's built-in providers. Or run \`pi auth login\` to create ${authFile}.`,
392
475
  };
393
476
  }
394
477
 
@@ -512,7 +595,37 @@ function envHasAnthropicCred(env: Record<string, string | undefined>): boolean {
512
595
  return !!(env.ANTHROPIC_API_KEY || env.ANTHROPIC_OAUTH_TOKEN);
513
596
  }
514
597
 
515
- const PI_RUNTIME_API_KEYS: readonly (readonly [envKey: string, provider: string])[] = [
598
+ /**
599
+ * `[envKey, provider]` rows for the builtin providers whose credential pi-ai
600
+ * resolves from an env key, so a `FIREWORKS_API_KEY` (or any later provider's
601
+ * key) reaches the session as a runtime key. Providers the explicit list below
602
+ * already covers are left out: that list decides precedence between a
603
+ * provider's several key vars, and a derived row would silently replace its
604
+ * pick (`GOOGLE_API_KEY` over `GEMINI_API_KEY`).
605
+ */
606
+ function piAiRuntimeKeyRows(
607
+ explicitProviders: ReadonlySet<string>,
608
+ ): Array<readonly [string, string]> {
609
+ const rows: Array<readonly [string, string]> = [];
610
+ for (const provider of getBuiltinProviders()) {
611
+ if (explicitProviders.has(provider)) continue;
612
+ // Bedrock resolves the AWS SDK chain and google-vertex ADC, not a key var;
613
+ // `openai-codex` is OAuth-only (the ChatGPT pool).
614
+ if (provider === "amazon-bedrock" || provider === "google-vertex") continue;
615
+ if (provider === "openai-codex") continue;
616
+ if (getModels(provider).length === 0) continue;
617
+ for (const keyVar of piAiProviderKeyVars(provider) ?? []) rows.push([keyVar, provider]);
618
+ }
619
+ return rows;
620
+ }
621
+
622
+ /**
623
+ * Key var → provider for the providers this adapter handles explicitly. The
624
+ * order is precedence: a later row for the same provider wins, so a provider's
625
+ * canonical var comes last (`GOOGLE_API_KEY` over `GEMINI_API_KEY`, and
626
+ * `NAN_API_KEY` over its `HELMCODE_API_NAN` alias).
627
+ */
628
+ const EXPLICIT_PI_RUNTIME_API_KEYS: readonly (readonly [envKey: string, provider: string])[] = [
516
629
  ["OPENROUTER_API_KEY", "openrouter"],
517
630
  ["ANTHROPIC_API_KEY", "anthropic"],
518
631
  ["OPENAI_API_KEY", "openai"],
@@ -529,6 +642,23 @@ const PI_RUNTIME_API_KEYS: readonly (readonly [envKey: string, provider: string]
529
642
  ),
530
643
  ];
531
644
 
645
+ /**
646
+ * Every runtime-key row the session applies: the explicit list, then a row for
647
+ * each remaining builtin provider pi-ai resolves from an env key
648
+ * (`FIREWORKS_API_KEY`, `DEEPSEEK_API_KEY`, ...).
649
+ */
650
+ let piRuntimeApiKeysCache: ReadonlyArray<readonly [string, string]> | undefined;
651
+ function piRuntimeApiKeys(): ReadonlyArray<readonly [string, string]> {
652
+ if (!piRuntimeApiKeysCache) {
653
+ const explicitProviders = new Set(EXPLICIT_PI_RUNTIME_API_KEYS.map(([, provider]) => provider));
654
+ piRuntimeApiKeysCache = [
655
+ ...EXPLICIT_PI_RUNTIME_API_KEYS,
656
+ ...piAiRuntimeKeyRows(explicitProviders),
657
+ ];
658
+ }
659
+ return piRuntimeApiKeysCache;
660
+ }
661
+
532
662
  /**
533
663
  * Build pi-coding-agent auth services from the runner's per-task resolved env.
534
664
  *
@@ -550,7 +680,7 @@ export async function createPiRuntimeAuth(
550
680
  : {}),
551
681
  ...(subscription ? { credentials: await subscriptionCredentialStore(subscription) } : {}),
552
682
  });
553
- for (const [envKey, provider] of PI_RUNTIME_API_KEYS) {
683
+ for (const [envKey, provider] of piRuntimeApiKeys()) {
554
684
  const apiKey = env[envKey];
555
685
  if (apiKey) {
556
686
  await modelRuntime.setRuntimeApiKey(provider, apiKey);
@@ -15,6 +15,15 @@ import {
15
15
  type ProfileFileIO,
16
16
  readIdentityBaselines,
17
17
  } from "../commands/profile-sync";
18
+ import {
19
+ canonicalArgs,
20
+ canonicalToolName,
21
+ type NativeCall,
22
+ type NativeHookTarget,
23
+ rawArgsFromCanonical,
24
+ runNativePost,
25
+ runNativePre,
26
+ } from "../hooks/native-tool-hooks";
18
27
  import { checkToolLoop, clearToolHistory } from "../hooks/tool-loop-detection";
19
28
  import { renderGoalReminder } from "../prompts/goal-reminder";
20
29
  import { isSessionSummarySkipped } from "../utils/env-flag";
@@ -65,6 +74,34 @@ export function apiHeaders(config: SwarmHooksConfig): Record<string, string> {
65
74
  };
66
75
  }
67
76
 
77
+ /** Where a pi or opencode session reports its native tool calls. */
78
+ export function nativeHookTarget(config: SwarmHooksConfig): NativeHookTarget {
79
+ return { apiUrl: config.apiUrl, headers: apiHeaders(config), taskId: config.taskId };
80
+ }
81
+
82
+ /** Pi's own tools. Everything else pi runs (swarm and agent-installed MCP tools) is not native. */
83
+ const PI_NATIVE_TOOLS = new Set([
84
+ "bash",
85
+ "powershell",
86
+ "read",
87
+ "edit",
88
+ "write",
89
+ "grep",
90
+ "find",
91
+ "ls",
92
+ ]);
93
+
94
+ export function piNativeCall(toolName: string, input: unknown, toolCallId?: string): NativeCall {
95
+ return {
96
+ harness: "pi",
97
+ tool: canonicalToolName(toolName),
98
+ nativeTool: toolName,
99
+ args: canonicalArgs(input),
100
+ rawArgs: input,
101
+ toolCallId,
102
+ };
103
+ }
104
+
68
105
  /** Fire-and-forget fetch — logs nothing, swallows errors */
69
106
  export function fireAndForget(url: string, init: RequestInit): void {
70
107
  void fetch(url, init).catch(() => {});
@@ -527,6 +564,8 @@ export function piToolGroups(
527
564
  export function createSwarmHooksExtension(config: SwarmHooksConfig): ExtensionFactory {
528
565
  return (pi) => {
529
566
  let lastContextPostTime = 0;
567
+ /** Native calls in flight, so the post report carries a real duration. */
568
+ const nativeStartedAt = new Map<string, number>();
530
569
 
531
570
  // === before_provider_request + message_end → request composition ===
532
571
  // The payload is what pi sends, so its system prompt, tool declarations
@@ -657,6 +696,21 @@ export function createSwarmHooksExtension(config: SwarmHooksConfig): ExtensionFa
657
696
  }
658
697
  }
659
698
 
699
+ // Extensions with toolSources "native": last, so every guard above wins. Pi lets a handler
700
+ // mutate `event.input` in place, which is how a rewrite lands.
701
+ if (PI_NATIVE_TOOLS.has(event.toolName)) {
702
+ const call = piNativeCall(event.toolName, event.input, event.toolCallId);
703
+ const decision = await runNativePre(nativeHookTarget(config), call);
704
+ if (decision.action === "block") return { block: true, reason: decision.reason };
705
+ if (decision.action === "modify") {
706
+ const input = event.input as Record<string, unknown>;
707
+ const rewritten = rawArgsFromCanonical(decision.args, input) as Record<string, unknown>;
708
+ for (const key of Object.keys(input)) delete input[key];
709
+ Object.assign(input, rewritten);
710
+ }
711
+ nativeStartedAt.set(event.toolCallId, Date.now());
712
+ }
713
+
660
714
  return undefined;
661
715
  });
662
716
 
@@ -696,6 +750,21 @@ export function createSwarmHooksExtension(config: SwarmHooksConfig): ExtensionFa
696
750
  }
697
751
  }
698
752
 
753
+ // Observe-only report to extensions with toolSources "native".
754
+ if (PI_NATIVE_TOOLS.has(event.toolName)) {
755
+ const startedAt = nativeStartedAt.get(event.toolCallId);
756
+ nativeStartedAt.delete(event.toolCallId);
757
+ void runNativePost(
758
+ nativeHookTarget(config),
759
+ piNativeCall(event.toolName, event.input, event.toolCallId),
760
+ {
761
+ result: event.content,
762
+ isError: event.isError,
763
+ durationMs: startedAt === undefined ? 0 : Date.now() - startedAt,
764
+ },
765
+ );
766
+ }
767
+
699
768
  // File sync: check if tool wrote to identity files or memory dirs
700
769
  // Pi-mono uses tool names: "write", "edit" (lowercase, unlike Claude's "Write", "Edit")
701
770
  const toolName = event.toolName;
@@ -94,7 +94,7 @@ export async function validateProviderDependencies(
94
94
  case "dsh":
95
95
  requireExecutable(
96
96
  env.DSH_BINARY || "dsh",
97
- "Use worker-full, install @deepseek-ai/dsh@0.2.2-rc.1, or set DSH_BINARY to a trusted executable.",
97
+ "Use worker-full, install @deepseek-ai/dsh@0.2.2-rc.2, or set DSH_BINARY to a trusted executable.",
98
98
  );
99
99
  return;
100
100
  case "amp":
@@ -348,6 +348,9 @@ export const LEGACY_POLICY = {
348
348
  "comb.presence": operatorOrUser,
349
349
  "fs.join.own": anyAuthenticated,
350
350
  "page.delete.any": leadOrResourceOwner,
351
+ // Humans only: agents edit objects with the board-* and sheet-* tools as themselves.
352
+ "objects.read": operatorOrUser,
353
+ "objects.write": operatorOrUser,
351
354
  "app.manage": anyAuthenticated,
352
355
  "app.use": anyAuthenticated,
353
356
  "script.global.write": leadOnly,
@@ -167,7 +167,7 @@ export const PERMISSIONS = {
167
167
  },
168
168
  "repo.merge-policy.write": {
169
169
  description:
170
- "Change a repo's allowMerge guideline, which tells agents whether they may merge a PR themselves.",
170
+ "Change a repo's merge policy (the allowMerge guideline or the mergePolicy record), which tells agents whether they may merge a PR themselves and which PRs the swarm may auto-merge.",
171
171
  namespace: "repo",
172
172
  },
173
173
  "integration.kapso.manage": {
@@ -356,6 +356,16 @@ export const PERMISSIONS = {
356
356
  description: "Delete a page the caller does not own.",
357
357
  namespace: "page",
358
358
  },
359
+ "objects.read": {
360
+ description:
361
+ "Read a board or sheet on the swarm's shared agent-fs drive through the object routes.",
362
+ namespace: "objects",
363
+ },
364
+ "objects.write": {
365
+ description:
366
+ "Save a board or edit sheet cells on the swarm's shared agent-fs drive through the object routes.",
367
+ namespace: "objects",
368
+ },
359
369
  "app.manage": {
360
370
  description: "Create, update, delete, or roll back apps, and inspect app version history.",
361
371
  namespace: "app",