@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
@@ -17,6 +17,7 @@ import {
17
17
  upsertKv,
18
18
  } from "../be/db";
19
19
  import { renderIdentity, resolveIdentity } from "../be/identity";
20
+ import { isUnmappedIdentityDismissed } from "../be/unmapped-identities";
20
21
  import { findOrCreateUserByEmail, findUserByExternalId, linkIdentity } from "../be/users";
21
22
  import { resolveTemplate } from "../prompts/resolver";
22
23
  import { gitlabContextKey } from "../tasks/context-key";
@@ -95,15 +96,18 @@ async function findLeadAgent() {
95
96
  const UNMAPPED_NAMESPACE = "integration:unmapped:gitlab";
96
97
  const UNMAPPED_TTL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
97
98
  const GITLAB_WEBHOOK_ACTOR = { kind: "system", id: "webhook:gitlab" } as const;
99
+ const EMAIL_ADDRESS_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
98
100
 
99
101
  /**
100
102
  * Resolve a GitLab webhook sender to a `users.id`.
101
103
  *
102
104
  * Cascade (Q17):
103
105
  * 1. Fast path — `findUserByExternalId('gitlab', user.username)`.
104
- * 2. If missing AND `user.email` is a real non-empty string (some GitLab
105
- * installations send `email: ""` instead of omitting the field — Q17.E
106
- * manual spot-check), run `findOrCreateUserByEmail` + `linkIdentity`.
106
+ * 2. If missing AND `user.email` is an email address, run
107
+ * `findOrCreateUserByEmail` + `linkIdentity`. GitLab sends other values
108
+ * for senders without a public email (`""` on some installations — Q17.E
109
+ * manual spot-check — or a redaction marker such as `[REDACTED]`). Many
110
+ * senders share such a value, so it never identifies one person.
107
111
  * 3. Otherwise record an unmapped tracker entry (kv) for operator triage.
108
112
  *
109
113
  * Returns `undefined` when no mapping could be established — callers pass
@@ -117,10 +121,10 @@ async function resolveGitLabSender(
117
121
  const existing = await findUserByExternalId("gitlab", user.username);
118
122
  if (existing) return existing.id;
119
123
 
120
- // Inline-email cascade — only run when email is a real non-empty string.
121
- // Some GitLab installations emit `email: ""` instead of omitting the field.
124
+ // Inline-email cascade — only run when email is an address. Empty strings and
125
+ // redaction markers fall through to the unmapped tracker.
122
126
  const inlineEmail = typeof user.email === "string" ? user.email.trim() : "";
123
- if (inlineEmail !== "") {
127
+ if (EMAIL_ADDRESS_RE.test(inlineEmail)) {
124
128
  const { user: linked } = await findOrCreateUserByEmail(
125
129
  inlineEmail,
126
130
  { name: user.name },
@@ -130,7 +134,8 @@ async function resolveGitLabSender(
130
134
  return linked.id;
131
135
  }
132
136
 
133
- // No mapping + no inline email → unmapped tracker.
137
+ // No mapping + no inline email → unmapped tracker, unless an operator dismissed it.
138
+ if (await isUnmappedIdentityDismissed("gitlab", user.username)) return undefined;
134
139
  await upsertKv({
135
140
  namespace: UNMAPPED_NAMESPACE,
136
141
  key: `${user.username}:meta`,
@@ -23,6 +23,10 @@
23
23
  * the reason to stderr, which codex-cli 0.160.0 turns into
24
24
  * "Command blocked by PreToolUse hook: <reason>".
25
25
  *
26
+ * Native tool calls (Bash, apply_patch) also go to `POST /api/tool-hooks`
27
+ * (`native-tool-hooks.ts`), so an extension with `toolSources: ["native"]`
28
+ * can observe, block (exit 2) or rewrite a Bash command (`updatedInput`).
29
+ *
26
30
  * One-shot guarantee: a message is included in hook output only after its
27
31
  * `/delivered` POST succeeded, so a message is injected at most once. A
28
32
  * failed POST leaves the row `pending` for the next lifecycle event; rows a
@@ -34,6 +38,14 @@ import type { SteeringMessage } from "../types";
34
38
  import { getApiKey } from "../utils/api-key";
35
39
  import { getMcpBaseUrl } from "../utils/constants";
36
40
  import { isSteeringEnabled } from "../utils/steering-enabled";
41
+ import {
42
+ canonicalArgs,
43
+ canonicalToolName,
44
+ type NativeCall,
45
+ type NativeHookTarget,
46
+ runNativePost,
47
+ runNativePre,
48
+ } from "./native-tool-hooks";
37
49
  import { guardGhPrBody, type PrBodyGuardDeps } from "./pr-body-guard";
38
50
  import { guardGhPrRoom, type PrRoomGuardDeps } from "./pr-room-guard";
39
51
 
@@ -45,6 +57,8 @@ export interface CodexHookMessage {
45
57
  cwd?: string;
46
58
  tool_name?: string;
47
59
  tool_input?: unknown;
60
+ tool_response?: unknown;
61
+ tool_use_id?: string;
48
62
  }
49
63
 
50
64
  export interface CodexHookConfig {
@@ -177,11 +191,78 @@ export async function codexPreToolUseBlock(
177
191
  roomDeps?: PrRoomGuardDeps,
178
192
  ): Promise<string | null> {
179
193
  if (msg.hook_event_name !== "PreToolUse") return null;
194
+ // An apply_patch payload is patch text, never a shell command: `gh pr create` inside a patched file is not one.
195
+ if (msg.tool_name === "apply_patch") return null;
180
196
  const cwd = msg.cwd ?? process.cwd();
181
197
  const block = await guardGhPrBody(msg.tool_input, cwd, deps);
182
198
  return block ?? (await guardGhPrRoom(msg.tool_input, cwd, roomDeps));
183
199
  }
184
200
 
201
+ /** Codex's own tool calls; its MCP tools (`mcp__server__tool`) reach extensions through the MCP path. */
202
+ function nativeCallOf(msg: CodexHookMessage): NativeCall | undefined {
203
+ if (!msg.tool_name || msg.tool_name.startsWith("mcp__")) return undefined;
204
+ return {
205
+ harness: "codex",
206
+ tool: canonicalToolName(msg.tool_name),
207
+ nativeTool: msg.tool_name,
208
+ args: canonicalArgs(msg.tool_input),
209
+ rawArgs: msg.tool_input,
210
+ toolCallId: msg.tool_use_id,
211
+ };
212
+ }
213
+
214
+ function nativeTargetOf(config: CodexHookConfig | null): NativeHookTarget | undefined {
215
+ if (!config) return undefined;
216
+ return {
217
+ apiUrl: config.apiUrl,
218
+ headers: { Authorization: `Bearer ${config.apiKey}`, "X-Agent-ID": config.agentId },
219
+ taskId: config.taskId,
220
+ };
221
+ }
222
+
223
+ export type CodexNativePre =
224
+ | { action: "continue" }
225
+ | { action: "block"; reason: string }
226
+ | { action: "modify"; output: Record<string, unknown> };
227
+
228
+ /** PreToolUse: what the native-tool extensions decided, as codex hook output. */
229
+ export async function codexNativePre(
230
+ msg: CodexHookMessage,
231
+ config: CodexHookConfig | null,
232
+ fetchImpl: typeof fetch = fetch,
233
+ deps?: PrBodyGuardDeps,
234
+ roomDeps?: PrRoomGuardDeps,
235
+ ): Promise<CodexNativePre> {
236
+ const call = nativeCallOf(msg);
237
+ const target = nativeTargetOf(config);
238
+ if (msg.hook_event_name !== "PreToolUse" || !call || !target) return { action: "continue" };
239
+ const decision = await runNativePre(target, call, fetchImpl);
240
+ if (decision.action === "block") return decision;
241
+ // shortcut: only a Bash rewrite is applied; codex's rewrite support for apply_patch payloads is
242
+ // unverified, so that modify is dropped. Upgrade once a codex run proves updatedInput there.
243
+ if (decision.action === "modify" && call.tool === "bash") {
244
+ // The rewrite is input the PreToolUse guards never saw: check the final command too.
245
+ const reason = await codexPreToolUseBlock(
246
+ { ...msg, tool_input: decision.args },
247
+ deps,
248
+ roomDeps,
249
+ );
250
+ if (reason) return { action: "block", reason };
251
+ return {
252
+ action: "modify",
253
+ output: {
254
+ hookSpecificOutput: {
255
+ hookEventName: "PreToolUse",
256
+ permissionDecision: "allow",
257
+ permissionDecisionReason: "Tool input rewritten by an extension",
258
+ updatedInput: decision.args,
259
+ },
260
+ },
261
+ };
262
+ }
263
+ return { action: "continue" };
264
+ }
265
+
185
266
  /** stdin/stdout entry point used by the `codex-hook` CLI command. */
186
267
  export async function handleCodexHook(): Promise<void> {
187
268
  let msg: CodexHookMessage;
@@ -196,8 +277,25 @@ export async function handleCodexHook(): Promise<void> {
196
277
  process.exitCode = 2;
197
278
  return;
198
279
  }
280
+ const config = resolveCodexHookConfig();
281
+ const native = await codexNativePre(msg, config);
282
+ if (native.action === "block") {
283
+ console.error(native.reason);
284
+ process.exitCode = 2;
285
+ return;
286
+ }
287
+ if (native.action === "modify") {
288
+ console.log(JSON.stringify(native.output));
289
+ return;
290
+ }
291
+ const postCall = msg.hook_event_name === "PostToolUse" ? nativeCallOf(msg) : undefined;
292
+ const postTarget = nativeTargetOf(config);
293
+ if (postCall && postTarget) {
294
+ // shortcut: pre and post are separate processes, so durationMs is sent as 0.
295
+ await runNativePost(postTarget, postCall, { result: msg.tool_response, durationMs: 0 });
296
+ }
199
297
  try {
200
- const output = await handleCodexHookEvent(msg, resolveCodexHookConfig());
298
+ const output = await handleCodexHookEvent(msg, config);
201
299
  if (output) console.log(JSON.stringify(output));
202
300
  } catch {
203
301
  // Never fail the harness over steering delivery.
package/src/hooks/hook.ts CHANGED
@@ -26,6 +26,15 @@ import { isSessionSummarySkipped } from "../utils/env-flag";
26
26
  import { summarizeSession as runSummarize } from "../utils/internal-ai";
27
27
  import { scrubSecrets } from "../utils/secret-scrubber";
28
28
  import { contextBoundNoteThreshold, injectClaimedContextBoundNote } from "./context-bound-note";
29
+ import {
30
+ canonicalArgs,
31
+ canonicalToolName,
32
+ type NativeCall,
33
+ type NativeHookTarget,
34
+ rawArgsFromCanonical,
35
+ runNativePost,
36
+ runNativePre,
37
+ } from "./native-tool-hooks";
29
38
  import { guardGhPrBody } from "./pr-body-guard";
30
39
  import { guardGhPrRoom } from "./pr-room-guard";
31
40
  import { checkToolLoop, clearToolHistory } from "./tool-loop-detection";
@@ -1033,6 +1042,25 @@ export async function handleHook(): Promise<void> {
1033
1042
  return lines.join("\n");
1034
1043
  };
1035
1044
 
1045
+ /** Claude's own tool calls only: swarm MCP tools reach extensions through the MCP path. */
1046
+ const nativeCallOf = (): NativeCall | undefined => {
1047
+ if (!msg.tool_name || msg.tool_name.startsWith("mcp__")) return undefined;
1048
+ return {
1049
+ harness: "claude",
1050
+ tool: canonicalToolName(msg.tool_name),
1051
+ nativeTool: msg.tool_name,
1052
+ args: canonicalArgs(msg.tool_input),
1053
+ rawArgs: msg.tool_input,
1054
+ toolCallId: msg.tool_use_id,
1055
+ };
1056
+ };
1057
+
1058
+ const nativeTargetOf = async (): Promise<NativeHookTarget | undefined> => {
1059
+ const apiUrl = getBaseUrl();
1060
+ if (!mcpConfig || !apiUrl) return undefined;
1061
+ return { apiUrl, headers: mcpConfig.headers, taskId: (await readTaskFile())?.taskId };
1062
+ };
1063
+
1036
1064
  const isToolEvent = msg.hook_event_name === "PreToolUse" || msg.hook_event_name === "PostToolUse";
1037
1065
 
1038
1066
  // Ping the server to indicate activity, then get current agent info.
@@ -1206,16 +1234,13 @@ export async function handleHook(): Promise<void> {
1206
1234
 
1207
1235
  // Block `gh pr create|edit` when the body for a public repo leaks internal
1208
1236
  // identifiers. Exit code 2 blocks the call and stderr reaches the model.
1237
+ const prGuardBlock = async (toolInput: unknown): Promise<string | null> =>
1238
+ (await guardGhPrBody(toolInput, msg.cwd ?? process.cwd())) ??
1239
+ (await guardGhPrRoom(toolInput, msg.cwd ?? process.cwd()));
1209
1240
  if (msg.tool_name === "Bash") {
1210
- const prBodyBlock = await guardGhPrBody(msg.tool_input, msg.cwd ?? process.cwd());
1211
- if (prBodyBlock) {
1212
- console.error(prBodyBlock);
1213
- process.exitCode = 2;
1214
- return;
1215
- }
1216
- const prRoomBlock = await guardGhPrRoom(msg.tool_input, msg.cwd ?? process.cwd());
1217
- if (prRoomBlock) {
1218
- console.error(prRoomBlock);
1241
+ const prBlock = await prGuardBlock(msg.tool_input);
1242
+ if (prBlock) {
1243
+ console.error(prBlock);
1219
1244
  process.exitCode = 2;
1220
1245
  return;
1221
1246
  }
@@ -1261,13 +1286,61 @@ export async function handleHook(): Promise<void> {
1261
1286
  }
1262
1287
  }
1263
1288
 
1264
- if (loopWarning) {
1289
+ // Extensions with toolSources "native" see the call last, so every guard above wins.
1290
+ // Block: exit 2, stderr reaches the model. Modify: updatedInput, plus any loop warning in
1291
+ // the same JSON object (stdout must be exactly one).
1292
+ let rewrittenInput: unknown;
1293
+ const nativeCall = nativeCallOf();
1294
+ const nativeTarget = nativeCall ? await nativeTargetOf() : undefined;
1295
+ if (nativeCall && nativeTarget) {
1296
+ const decision = await runNativePre(nativeTarget, nativeCall);
1297
+ if (decision.action === "block") {
1298
+ console.error(decision.reason);
1299
+ process.exitCode = 2;
1300
+ return;
1301
+ }
1302
+ if (decision.action === "modify") {
1303
+ rewrittenInput = rawArgsFromCanonical(decision.args, msg.tool_input);
1304
+ // The rewrite is input the guards above never saw: check the final Bash command too.
1305
+ const rewriteBlock = msg.tool_name === "Bash" ? await prGuardBlock(rewrittenInput) : null;
1306
+ if (rewriteBlock) {
1307
+ console.error(rewriteBlock);
1308
+ process.exitCode = 2;
1309
+ return;
1310
+ }
1311
+ }
1312
+ }
1313
+
1314
+ if (rewrittenInput !== undefined) {
1315
+ console.log(
1316
+ JSON.stringify({
1317
+ hookSpecificOutput: {
1318
+ hookEventName: "PreToolUse",
1319
+ permissionDecision: "allow",
1320
+ permissionDecisionReason: "Tool input rewritten by an extension",
1321
+ updatedInput: rewrittenInput,
1322
+ ...(loopWarning ? { additionalContext: loopWarning } : {}),
1323
+ },
1324
+ }),
1325
+ );
1326
+ } else if (loopWarning) {
1265
1327
  outputToolContext("PreToolUse", loopWarning);
1266
1328
  }
1267
1329
  break;
1268
1330
  }
1269
1331
 
1270
- case "PostToolUse":
1332
+ case "PostToolUse": {
1333
+ // Observe-only report to extensions with toolSources "native".
1334
+ // shortcut: pre and post run in separate hook processes, so durationMs is sent as 0;
1335
+ // upgrade by stamping the pre call in a temp file keyed by tool_use_id.
1336
+ const postCall = nativeCallOf();
1337
+ const postTarget = postCall ? await nativeTargetOf() : undefined;
1338
+ if (postCall && postTarget) {
1339
+ await runNativePost(postTarget, postCall, {
1340
+ result: msg.tool_response,
1341
+ durationMs: 0,
1342
+ });
1343
+ }
1271
1344
  // Active session heartbeat (workers only, fire-and-forget)
1272
1345
  if (agentInfo && !agentInfo.isLead) {
1273
1346
  const heartbeatTaskFile = await readTaskFile();
@@ -1373,6 +1446,7 @@ export async function handleHook(): Promise<void> {
1373
1446
  }
1374
1447
  }
1375
1448
  break;
1449
+ }
1376
1450
 
1377
1451
  case "Stop":
1378
1452
  // Sync CLAUDE.md (then restore its backup), identity files, and setup script back to database
@@ -0,0 +1,245 @@
1
+ /**
2
+ * Worker shim for harness-native tool calls (bash, read, write, edit, ...).
3
+ *
4
+ * Every harness reports its own built-in tool calls to `POST /api/tool-hooks`, where
5
+ * extensions whose manifest lists `toolSources: ["native"]` can observe, block or rewrite
6
+ * them. One module serves all four harnesses (claude and codex run it per hook process, pi
7
+ * and opencode run it in-process); each harness only maps its own event to a `NativeCall`
8
+ * and applies the `NativeDecision`.
9
+ *
10
+ * Contract, in order of importance:
11
+ * - Fail open. An API that is down, slow (2 s) or answers non-2xx lets the call run.
12
+ * - Skip the round trip when no enabled extension takes native calls: a cached
13
+ * `GET /api/tool-hooks/status` answer (30 s) gates everything else.
14
+ * - Scrub arguments worker-side before they leave the process. The server scrubs again, but
15
+ * only knows its own env; a worker holds per-task credentials the server never sees.
16
+ * - Talk HTTP only. Never import the DB layer.
17
+ */
18
+
19
+ import { createHash } from "node:crypto";
20
+ import { readFileSync, writeFileSync } from "node:fs";
21
+ import { tmpdir } from "node:os";
22
+ import { join } from "node:path";
23
+ import { scrubObject } from "../utils/secret-scrubber";
24
+
25
+ const REQUEST_TIMEOUT_MS = 2_000;
26
+ const STATUS_TTL_MS = 30_000;
27
+ /** After a failed status read: stay quiet this long so a dead API costs one timeout, not one per call. */
28
+ const STATUS_FAILURE_TTL_MS = 10_000;
29
+
30
+ export interface NativeHookTarget {
31
+ apiUrl: string;
32
+ /** Authorization and X-Agent-ID, as the rest of the worker sends them. */
33
+ headers: Record<string, string>;
34
+ /** The running task, forwarded as `X-Source-Task-ID` so an extension run points at it. */
35
+ taskId?: string;
36
+ }
37
+
38
+ export interface NativeCall {
39
+ harness: "claude" | "codex" | "pi" | "opencode";
40
+ /** Canonical name: `bash`, `read`, `write`, `edit`, otherwise the harness name, lowercased. */
41
+ tool: string;
42
+ /** The harness's own tool name, such as `Bash`. */
43
+ nativeTool: string;
44
+ args: Record<string, unknown>;
45
+ rawArgs: unknown;
46
+ toolCallId?: string;
47
+ }
48
+
49
+ export type NativeDecision =
50
+ | { action: "continue" }
51
+ | { action: "modify"; args: Record<string, unknown> }
52
+ | { action: "block"; reason: string };
53
+
54
+ const CONTINUE: NativeDecision = { action: "continue" };
55
+
56
+ const CANONICAL_NAMES: Record<string, string> = {
57
+ bash: "bash",
58
+ shell: "bash",
59
+ read: "read",
60
+ write: "write",
61
+ edit: "edit",
62
+ multiedit: "edit",
63
+ };
64
+
65
+ /** Canonical tool name: the four shared ones are the same on every harness. */
66
+ export function canonicalToolName(nativeTool: string): string {
67
+ const lower = nativeTool.toLowerCase();
68
+ return CANONICAL_NAMES[lower] ?? lower;
69
+ }
70
+
71
+ /**
72
+ * Canonical args are the harness's own keys with Claude's `file_path` renamed `path`, the key
73
+ * pi and opencode already use.
74
+ * shortcut: no per-tool schema (edit shapes still differ per harness), upgrade when an
75
+ * extension needs to treat an edit identically across harnesses.
76
+ */
77
+ export function canonicalArgs(raw: unknown): Record<string, unknown> {
78
+ if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return {};
79
+ const { file_path, ...rest } = raw as Record<string, unknown>;
80
+ return file_path === undefined ? rest : { ...rest, path: file_path };
81
+ }
82
+
83
+ /** Back to the harness's key names, so a rewritten `path` reaches a tool that reads `file_path`. */
84
+ export function rawArgsFromCanonical(args: Record<string, unknown>, raw: unknown): unknown {
85
+ const usesFilePath = typeof raw === "object" && raw !== null && "file_path" in raw;
86
+ if (!usesFilePath || args.path === undefined) return args;
87
+ const { path, ...rest } = args;
88
+ return { ...rest, file_path: path };
89
+ }
90
+
91
+ function cacheKey(target: NativeHookTarget): string {
92
+ return createHash("sha256")
93
+ .update(`${target.apiUrl}\n${target.headers["X-Agent-ID"] ?? ""}`)
94
+ .digest("hex")
95
+ .slice(0, 16);
96
+ }
97
+
98
+ interface StatusEntry {
99
+ native: boolean;
100
+ /** When this answer stops being trusted. */
101
+ until: number;
102
+ }
103
+
104
+ const memoryStatus = new Map<string, StatusEntry>();
105
+
106
+ function readStatusFile(path: string): StatusEntry | undefined {
107
+ try {
108
+ const parsed = JSON.parse(readFileSync(path, "utf8")) as Partial<StatusEntry>;
109
+ if (typeof parsed.native === "boolean" && typeof parsed.until === "number") {
110
+ return { native: parsed.native, until: parsed.until };
111
+ }
112
+ } catch {
113
+ // No file, or a half-written one: read the API instead.
114
+ }
115
+ return undefined;
116
+ }
117
+
118
+ /**
119
+ * Whether any enabled extension takes native tool calls. The claude and codex hooks are a new
120
+ * process per call, so the answer lives in a small file under the temp dir as well as in memory.
121
+ */
122
+ export async function nativeHooksActive(
123
+ target: NativeHookTarget,
124
+ fetchImpl: typeof fetch = fetch,
125
+ now: () => number = Date.now,
126
+ ): Promise<boolean> {
127
+ const key = cacheKey(target);
128
+ const file = join(tmpdir(), `agent-swarm-native-hooks-${key}.json`);
129
+ const cached = memoryStatus.get(key) ?? readStatusFile(file);
130
+ if (cached && cached.until > now()) return cached.native;
131
+
132
+ let entry: StatusEntry;
133
+ try {
134
+ const response = await fetchImpl(`${target.apiUrl}/api/tool-hooks/status`, {
135
+ headers: target.headers,
136
+ signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
137
+ });
138
+ if (!response.ok) throw new Error(`status ${response.status}`);
139
+ const body = (await response.json()) as { native?: unknown };
140
+ entry = { native: body.native === true, until: now() + STATUS_TTL_MS };
141
+ } catch {
142
+ entry = { native: false, until: now() + STATUS_FAILURE_TTL_MS };
143
+ }
144
+ memoryStatus.set(key, entry);
145
+ try {
146
+ writeFileSync(file, JSON.stringify(entry));
147
+ } catch {
148
+ // An unwritable temp dir only costs the cache.
149
+ }
150
+ return entry.native;
151
+ }
152
+
153
+ /** Drop the cached answers. Tests and e2e runs that flip an extension need a fresh read. */
154
+ export function resetNativeHookCache(): void {
155
+ memoryStatus.clear();
156
+ }
157
+
158
+ function postHeaders(target: NativeHookTarget): Record<string, string> {
159
+ return {
160
+ ...target.headers,
161
+ "Content-Type": "application/json",
162
+ ...(target.taskId ? { "X-Source-Task-ID": target.taskId } : {}),
163
+ };
164
+ }
165
+
166
+ function wireBody(call: NativeCall) {
167
+ return scrubObject({
168
+ harness: call.harness,
169
+ tool: call.tool,
170
+ nativeTool: call.nativeTool,
171
+ args: call.args,
172
+ rawArgs: call.rawArgs,
173
+ ...(call.toolCallId ? { toolCallId: call.toolCallId } : {}),
174
+ });
175
+ }
176
+
177
+ /**
178
+ * Ask the extensions about a native call before it runs. Returns `continue` when no extension
179
+ * takes native calls (no request is made), unless one blocked or rewrote it; any failure is
180
+ * `continue`. A body over the route's 2 MB limit is refused with a 4xx and so is not intercepted.
181
+ */
182
+ export async function runNativePre(
183
+ target: NativeHookTarget,
184
+ call: NativeCall,
185
+ fetchImpl: typeof fetch = fetch,
186
+ ): Promise<NativeDecision> {
187
+ if (!(await nativeHooksActive(target, fetchImpl))) return CONTINUE;
188
+ try {
189
+ const response = await fetchImpl(`${target.apiUrl}/api/tool-hooks`, {
190
+ method: "POST",
191
+ headers: postHeaders(target),
192
+ body: JSON.stringify({ phase: "pre", ...wireBody(call) }),
193
+ signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
194
+ });
195
+ if (!response.ok) return CONTINUE;
196
+ const decision = (await response.json()) as Record<string, unknown>;
197
+ if (decision.action === "block" && typeof decision.reason === "string") {
198
+ return { action: "block", reason: decision.reason };
199
+ }
200
+ if (decision.action === "modify") {
201
+ const args = decision.args;
202
+ if (typeof args === "object" && args !== null && !Array.isArray(args)) {
203
+ return { action: "modify", args: args as Record<string, unknown> };
204
+ }
205
+ }
206
+ } catch {
207
+ // Fail open.
208
+ }
209
+ return CONTINUE;
210
+ }
211
+
212
+ const MAX_RESULT_CHARS = 64_000;
213
+
214
+ /** A tool result can be megabytes; an observer needs the head of it, not all of it. */
215
+ function clipResult(result: unknown): unknown {
216
+ const text = typeof result === "string" ? result : JSON.stringify(result);
217
+ if (text === undefined || text.length <= MAX_RESULT_CHARS) return result;
218
+ return `${text.slice(0, MAX_RESULT_CHARS)}… [clipped, ${text.length} chars]`;
219
+ }
220
+
221
+ /** Report a finished native call. Observe-only: the answer is 202 and nothing can change. */
222
+ export async function runNativePost(
223
+ target: NativeHookTarget,
224
+ call: NativeCall,
225
+ outcome: { result: unknown; isError?: boolean; durationMs: number },
226
+ fetchImpl: typeof fetch = fetch,
227
+ ): Promise<void> {
228
+ if (!(await nativeHooksActive(target, fetchImpl))) return;
229
+ try {
230
+ await fetchImpl(`${target.apiUrl}/api/tool-hooks`, {
231
+ method: "POST",
232
+ headers: postHeaders(target),
233
+ body: JSON.stringify({
234
+ phase: "post",
235
+ ...wireBody(call),
236
+ ...scrubObject({ result: clipResult(outcome.result) }),
237
+ ...(outcome.isError === undefined ? {} : { isError: outcome.isError }),
238
+ durationMs: Math.max(0, outcome.durationMs),
239
+ }),
240
+ signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
241
+ });
242
+ } catch {
243
+ // Fail open.
244
+ }
245
+ }
@@ -42,6 +42,7 @@ import "./model-groups";
42
42
  import "./model-profiles";
43
43
  import "./models-catalog";
44
44
  import "./object-webhooks";
45
+ import "./objects";
45
46
  import "./oauth-locks";
46
47
  import "./oauth-callback";
47
48
  import "./oauth-generic";
@@ -5,7 +5,7 @@ import { normalizeAssetKey } from "../assets/key";
5
5
  import { sourceMoveError, sourceOfKey } from "../assets/source-key";
6
6
  import { auditAssetKeys } from "../be/asset-key-audit";
7
7
  import { AssetKeyAuthorizationError, authorizeAssetKeyWrite } from "../be/asset-key-auth";
8
- import { resolveHttpAuditUserId } from "../be/audit-user";
8
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
9
9
  import {
10
10
  AssetKeyMovesBlockedError,
11
11
  getDb,
@@ -281,7 +281,7 @@ export async function handleAssets(
281
281
  if (!parsed) return true;
282
282
  if (!ensureOperator(req, res)) return true;
283
283
  try {
284
- const actor = await resolveHttpAuditUserId(req, myAgentId);
284
+ const actor = await resolveHttpRequesterUserId(req, myAgentId);
285
285
  const key = parsed.body.key
286
286
  ? await authorizeAssetKeyWrite(parsed.body.key, actor)
287
287
  : undefined;
@@ -381,13 +381,14 @@ export async function handleAssets(
381
381
  }
382
382
 
383
383
  try {
384
- const actor = await resolveHttpAuditUserId(req, myAgentId);
384
+ const actor = await resolveHttpRequesterUserId(req, myAgentId);
385
385
  const key = await authorizeAssetKeyWrite(parsed.body.key, actor);
386
386
  const moved = await moveAssetKey({
387
387
  entityType: parsed.params.entityType,
388
388
  id: parsed.params.id,
389
389
  key,
390
390
  changedBy: actor ?? undefined,
391
+ changedByAgentId: myAgentId,
391
392
  descendantTaskIds,
392
393
  });
393
394
  if (!moved) {
package/src/http/comb.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
- import { resolveHttpAuditUserId } from "../be/audit-user";
3
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
4
4
  import { getCombConfig } from "../comb/config";
5
5
  import {
6
6
  REVIEW_BATCH_MAX,
@@ -120,7 +120,7 @@ export async function handleComb(
120
120
  try {
121
121
  const result = await sendReviewBatch({
122
122
  ...parsed.body,
123
- requestedByUserId: await resolveHttpAuditUserId(req, myAgentId),
123
+ requestedByUserId: await resolveHttpRequesterUserId(req, myAgentId),
124
124
  });
125
125
  reviewBatchRoute.respond(res, result.taskId === null ? 200 : 201, result);
126
126
  } catch (error) {
@@ -1,5 +1,5 @@
1
1
  import type { IncomingMessage } from "node:http";
2
- import { resolveHttpAuditUserId } from "../be/audit-user";
2
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
3
3
  import { findUserById } from "../be/users";
4
4
  import { authUserId, getRequestAuth, isOperatorAuth } from "../utils/request-auth-context";
5
5
 
@@ -67,6 +67,6 @@ export async function resolveHttpFavoriteOwner(
67
67
  };
68
68
  }
69
69
 
70
- const userId = await resolveHttpAuditUserId(req, callerAgentId);
70
+ const userId = await resolveHttpRequesterUserId(req, callerAgentId);
71
71
  return userId ? { scope: `user:${userId}`, userId, actorId: userId } : null;
72
72
  }
@@ -51,7 +51,7 @@ const putFavorite = route({
51
51
  row: UserFavoriteSchema.nullable(),
52
52
  }),
53
53
  },
54
- 400: { description: "Invalid asset key for a key favorite" },
54
+ 400: { description: "Invalid asset key for a key or hidden-key favorite" },
55
55
  401: { description: "No authenticated principal context" },
56
56
  },
57
57
  });
@@ -96,7 +96,8 @@ export async function handleFavorites(
96
96
  return true;
97
97
  }
98
98
  let itemId = parsed.body.itemId;
99
- if (parsed.body.itemType === "key") {
99
+ // A group key (a star or a hidden group) is stored normalized.
100
+ if (parsed.body.itemType === "key" || parsed.body.itemType === "hidden-key") {
100
101
  try {
101
102
  itemId = normalizeAssetKey(itemId);
102
103
  } catch (error) {