@desplega.ai/agent-swarm 2.11.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.
- package/dist/acp-adapter-cn53011z.js +17 -0
- package/dist/{acp-targets-5wyy2b9m.js → acp-targets-86f0sh6g.js} +10 -9
- package/dist/{actions-4nxq386s.js → actions-zv8vcxvr.js} +25 -22
- package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-jqshb33y.js} +10 -5
- package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-gt503ywc.js} +3 -3
- package/dist/{app-kyqt8ehw.js → app-6t4k5rh1.js} +7 -5
- package/dist/{approval-notifications-a0db0esw.js → approval-notifications-fcfw063h.js} +8 -7
- package/dist/{assistant-9g5jzq25.js → assistant-9dzybh12.js} +26 -23
- package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-xzfp2feg.js} +1 -1
- package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-3jz0p2jk.js} +1 -1
- package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-r88wngfg.js} +5 -2
- package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-scrqhw48.js} +2 -2
- package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-vb2dcrrb.js} +4 -4
- package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
- package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-h3mp9hgs.js} +9 -8
- package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-kpbyj2vb.js} +4 -4
- package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-0efr3wkg.js} +7 -7
- package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-03dw669q.js} +11 -10
- package/dist/{cli-14xdms9a.js → cli-0b655smz.js} +6 -6
- package/dist/{cli-wz4e5am2.js → cli-0dg7ytxm.js} +400 -72
- package/dist/cli-0jkenasr.js +148 -0
- package/dist/{cli-0bgj4rh5.js → cli-0pazkmd4.js} +4 -4
- package/dist/{cli-892y3vfp.js → cli-117g15t4.js} +9 -12
- package/dist/{cli-v3zcnr8g.js → cli-1dbv9mj9.js} +1 -1
- package/dist/{cli-8zmpwe79.js → cli-1v82d2w6.js} +5 -5
- package/dist/{cli-6tvh1fwq.js → cli-2jk4s7z1.js} +3 -3
- package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
- package/dist/{cli-atm0hkes.js → cli-2skf1mdf.js} +11 -11
- package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
- package/dist/{cli-a02habn6.js → cli-48nvk6sb.js} +3 -3
- package/dist/{cli-q71g5q39.js → cli-49f5jyhh.js} +3 -3
- package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
- package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
- package/dist/{cli-rwgwen5v.js → cli-6h88mn9q.js} +4 -4
- package/dist/cli-7dbhnsj9.js +681 -0
- package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
- package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
- package/dist/{cli-rhsc2zyx.js → cli-9fsagra4.js} +1 -1
- package/dist/{cli-f8yhybxr.js → cli-9m9kyw77.js} +3 -3
- package/dist/{cli-yzxqwcvq.js → cli-ajjvqhf3.js} +10 -3
- package/dist/cli-avqkr20b.js +69 -0
- package/dist/{cli-nbakg5xh.js → cli-avxh26pd.js} +46 -15
- package/dist/{cli-n6ygvrrm.js → cli-b2jh3dyb.js} +4 -4
- package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
- package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
- package/dist/{cli-czvvnfr9.js → cli-c8v2yvej.js} +2 -2
- package/dist/{cli-raqw9fw9.js → cli-ct8sz3np.js} +18 -11
- package/dist/{cli-t2s7j5cy.js → cli-dka73bak.js} +2 -2
- package/dist/{cli-tb4j757d.js → cli-dkejt425.js} +76 -17
- package/dist/{cli-27fat7st.js → cli-dnh64e8e.js} +7 -7
- package/dist/{cli-453497a0.js → cli-eb279wn3.js} +2 -2
- package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
- package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
- package/dist/{cli-vy3fn0mz.js → cli-f1952kjy.js} +4 -4
- package/dist/{cli-1h4njv9y.js → cli-f8rcvf2x.js} +58 -13
- package/dist/{cli-xqbqwpxr.js → cli-fhvk2nvp.js} +26 -13
- package/dist/{cli-2jtfm8kh.js → cli-fz9pcjsw.js} +4 -4
- package/dist/{cli-bq97k63w.js → cli-g6j6ac3h.js} +2 -2
- package/dist/{cli-f7dhm7hh.js → cli-gfcv679k.js} +1 -1
- package/dist/cli-hbq0kwxz.js +252 -0
- package/dist/{cli-nc39ym5q.js → cli-hc6e4tac.js} +29 -150
- package/dist/{cli-m00c47q6.js → cli-hgsxnjyg.js} +58 -25
- package/dist/{cli-s9twe4x0.js → cli-hpb9x72z.js} +58 -13
- package/dist/{cli-9g12h1aq.js → cli-j53hpbsm.js} +2 -2
- package/dist/{cli-zhn4r1rz.js → cli-jj3c5nyb.js} +519 -144
- package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
- package/dist/{cli-kbm659dk.js → cli-kde4ky90.js} +2 -2
- package/dist/{cli-4aswccje.js → cli-kspxjftk.js} +2 -2
- package/dist/{cli-p8zqbbt1.js → cli-m4ejz4nj.js} +1 -1
- package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
- package/dist/{cli-b82a13ga.js → cli-mh7pdxe0.js} +23 -27
- package/dist/{cli-rpmw4fsv.js → cli-mz34pxbk.js} +12 -12
- package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
- package/dist/{cli-cstggwq7.js → cli-nc6a8b5b.js} +7 -4
- package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
- package/dist/{cli-j2r1apqm.js → cli-prf7kz78.js} +59 -58
- package/dist/{cli-2gvdvsxj.js → cli-qec9bynj.js} +63 -60
- package/dist/{cli-zb1hff00.js → cli-qhhb30e8.js} +12 -12
- package/dist/{cli-h2qtafm4.js → cli-qm3ntjqs.js} +21 -21
- package/dist/{cli-5ptj757f.js → cli-rfejbpe1.js} +1 -1
- package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
- package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
- package/dist/{cli-mhrr4d5b.js → cli-sdh61g52.js} +38 -20
- package/dist/{cli-7cp6aa1q.js → cli-skd2c4ej.js} +25 -178
- package/dist/{cli-ynph3b70.js → cli-sq913bh1.js} +8 -8
- package/dist/{cli-hnh8erra.js → cli-t35hx078.js} +2 -2
- package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
- package/dist/{cli-yvzxbztc.js → cli-tn91wc6e.js} +2 -2
- package/dist/{cli-075ccjh6.js → cli-tstj6e8e.js} +3660 -232
- package/dist/{cli-4g323fjh.js → cli-w14j2z4k.js} +2 -2
- package/dist/{cli-4kzp7r0q.js → cli-wndegmns.js} +3 -3
- package/dist/{cli-p1a4khta.js → cli-wrhbym01.js} +10 -10
- package/dist/{cli-djt6wmrc.js → cli-wv20kbr3.js} +9 -9
- package/dist/{cli-2aacfdcn.js → cli-wxwv3t11.js} +64 -3
- package/dist/{cli-rytq7dm2.js → cli-xfjn2kyq.js} +59 -5
- package/dist/cli-y260hgep.js +186 -0
- package/dist/{cli-9knhkkgr.js → cli-y4a4458j.js} +3 -3
- package/dist/{cli-a6q6x15h.js → cli-y518qkjg.js} +10 -5
- package/dist/{cli-0b4zam62.js → cli-yfvhvw8m.js} +20 -0
- package/dist/cli-yn4kt85g.js +148 -0
- package/dist/{cli-k4r5sfaj.js → cli-ytc7fpza.js} +11 -11
- package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
- package/dist/{cli-6n7y5ypy.js → cli-z64t9pe6.js} +1 -1
- package/dist/{cli-6a3j25xd.js → cli-zqmmy073.js} +200 -20
- package/dist/cli.js +27 -22
- package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-f3yp0kaj.js} +8 -8
- package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
- package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
- package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ns4mv70p.js} +9 -9
- package/dist/{commands-ctey7tr5.js → commands-5bzf2tfw.js} +3 -3
- package/dist/{controller-rqhbppg9.js → controller-5xt7kvfm.js} +4 -4
- package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-0gg13mzp.js} +26 -23
- package/dist/core-0fqtbrxa.js +42 -0
- package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-p0c5zv6r.js} +2 -2
- package/dist/{db-p5drc1d1.js → db-2s68ycq7.js} +3 -3
- package/dist/{db-2ah39cyx.js → db-q7q639k5.js} +8 -2
- package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
- package/dist/{dispatcher-x6w14pde.js → dispatcher-j2y1q7ae.js} +25 -20
- package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
- package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-pgnkf4st.js} +2 -2
- package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
- package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
- package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-0kea97jf.js} +1 -1
- package/dist/{embedding-space-z6ptw3jk.js → embedding-space-3n6mhhmy.js} +6 -6
- package/dist/{embeddings-0sxb1d2h.js → embeddings-jfmj6yme.js} +1 -1
- package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
- package/dist/{execute-6m1ex8ce.js → execute-tjrej979.js} +1 -1
- package/dist/{external-channel-ezer7pk0.js → external-channel-jy8w2gg3.js} +2 -2
- package/dist/fx-adapter-k6w3jvz9.js +20 -0
- package/dist/grok-adapter-4q5tssw0.js +20 -0
- package/dist/handlers-qxgfvvsf.js +41 -0
- package/dist/{heartbeat-6c4fr49t.js → heartbeat-6tr2w2da.js} +26 -23
- package/dist/{hook-02rt5tvq.js → hook-bpnncsec.js} +77 -18
- package/dist/{hook-t1c5avbv.js → hook-fv1jwrv7.js} +6 -5
- package/dist/{http-qa3h32a1.js → http-bpa26czn.js} +1277 -249
- package/dist/index-0mcxjdsa.js +44 -0
- package/dist/{index-akbgsdhh.js → index-52tgbhrw.js} +30 -27
- package/dist/index-dz4q23ag.js +40 -0
- package/dist/{index-kqv9ebfj.js → index-mpj0z9e0.js} +1 -1
- package/dist/index-s175jckx.js +39 -0
- package/dist/{index-qpjk2hxk.js → index-s8re7mvq.js} +1 -1
- package/dist/{index-e42j998x.js → index-w216g9y9.js} +222 -165
- package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
- package/dist/{keepalive-jmf6pn8c.js → keepalive-d6z12s04.js} +4 -4
- package/dist/lead-p3hx7h35.js +79 -0
- package/dist/{maintenance-g7v15tj1.js → maintenance-7kac6g2g.js} +1 -1
- package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-t1xjetbh.js} +3 -3
- package/dist/object-webhooks-6rdagg0r.js +21 -0
- package/dist/{onboard-m3fedypq.js → onboard-32y1cfxy.js} +5 -5
- package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-enp3v31n.js} +8 -7
- package/dist/{otel-impl-3ehm1hgc.js → otel-impl-k0tm5ptj.js} +2 -2
- package/dist/{pending-fwj2fatd.js → pending-24zebgvs.js} +24 -21
- package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-yj72xxxe.js} +89 -20
- package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-cf25x38j.js} +2 -2
- package/dist/{rbac-roles-8msjr07m.js → rbac-roles-0wydd22m.js} +3 -3
- package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-at6crb3r.js} +7 -4
- package/dist/{registry-32b1mft6.js → registry-zv0zvxsx.js} +1 -1
- package/dist/{render-v2-j7qggj8h.js → render-v2-nvcw0jd7.js} +9 -5
- package/dist/{resume-hj1mn65y.js → resume-y4w0k5v3.js} +10 -9
- package/dist/{runtime-z31mdsgv.js → runtime-vpe43hx0.js} +1 -1
- package/dist/{session-access-w38fh09a.js → session-access-gkyvnfye.js} +5 -4
- package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-3w2st4m2.js} +3 -3
- package/dist/{setup-dsqmpfcr.js → setup-axxvqtys.js} +1 -1
- package/dist/thread-buffer-rwa7d4dx.js +42 -0
- package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-y4fqvab5.js} +2 -2
- package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-kcmwvrc6.js} +3 -3
- package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-7d92dct1.js} +3 -3
- package/dist/{work-objects-4ahy5es5.js → work-objects-f708e069.js} +28 -24
- package/dist/worker-8rg9gz74.js +79 -0
- package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-0by8wztc.js} +23 -20
- package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
- package/dist/xlsx-9acfmxr1.js +31534 -0
- package/openapi.json +5227 -3511
- package/package.json +10 -5
- package/src/agentmail/handlers.ts +26 -19
- package/src/apps/catalog.generated.json +31 -0
- package/src/apps/row-store.ts +37 -14
- package/src/azure-devops/auth.ts +2 -3
- package/src/azure-devops/handlers.ts +2 -0
- package/src/be/agent-fs-identity.ts +46 -0
- package/src/be/agent-history.ts +215 -0
- package/src/be/audit-user.ts +46 -6
- package/src/be/db/agents.ts +34 -12
- package/src/be/db/kv-windows.ts +22 -0
- package/src/be/db/session-moves.ts +3 -3
- package/src/be/db/session-tree.ts +52 -5
- package/src/be/db/skill-audit.ts +17 -0
- package/src/be/db/tasks/write.ts +20 -5
- package/src/be/db.ts +116 -23
- package/src/be/extensions/assets.ts +11 -7
- package/src/be/memory/demotion-evidence.ts +2 -2
- package/src/be/memory/providers/sqlite-store.ts +151 -18
- package/src/be/memory/search-read-worker.ts +60 -0
- package/src/be/memory/search-reader.ts +223 -0
- package/src/be/migrations/332_primitive_objects.sql +31 -0
- package/src/be/migrations/334_agent_history.sql +23 -0
- package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
- package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
- package/src/be/migrations/338_audit_agent_columns.sql +30 -0
- package/src/be/migrations/339_deferred_event_waits.sql +26 -0
- package/src/be/model-tier-resolution.ts +18 -1
- package/src/be/multi-runtime.ts +17 -0
- package/src/be/primitives/boards/elements.ts +717 -0
- package/src/be/primitives/boards/excalifont-metrics.json +516 -0
- package/src/be/primitives/boards/service.ts +121 -0
- package/src/be/primitives/object-embed.ts +250 -0
- package/src/be/primitives/object-webhooks.ts +348 -0
- package/src/be/primitives/objects.ts +706 -0
- package/src/be/primitives/sheets/a1.ts +136 -0
- package/src/be/primitives/sheets/engine-worker.ts +194 -0
- package/src/be/primitives/sheets/engine.ts +199 -0
- package/src/be/primitives/sheets/format.ts +106 -0
- package/src/be/primitives/sheets/service.ts +547 -0
- package/src/be/primitives/sheets/xlsx.ts +367 -0
- package/src/be/primitives/write-object.ts +83 -0
- package/src/be/rbac-roles.ts +3 -0
- package/src/be/repo-checked-update.ts +4 -4
- package/src/be/repo-merge-policy.ts +26 -9
- package/src/be/script-credential-broker.ts +8 -27
- package/src/be/scripts/boot-reembed.ts +6 -0
- package/src/be/scripts/db.ts +17 -5
- package/src/be/scripts/embeddings.ts +6 -0
- package/src/be/scripts/typecheck.ts +257 -0
- package/src/be/seed/agent-fs-provision.ts +18 -0
- package/src/be/seed/schedules-seeder.ts +9 -1
- package/src/be/seed/workflows-seeder.ts +9 -1
- package/src/be/seed-scripts/index.ts +2 -0
- package/src/be/seed-skills/index.ts +12 -0
- package/src/be/swarm-config-guard.ts +1 -0
- package/src/be/unmapped-identities.ts +95 -1
- package/src/be/users.ts +19 -0
- package/src/bitbucket/handlers.ts +2 -0
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/commands/onboard/steps/harness.tsx +1 -1
- package/src/commands/provider-credentials.ts +1 -0
- package/src/e2b/env.ts +3 -1
- package/src/event-waits/github.ts +43 -0
- package/src/event-waits/index.ts +29 -0
- package/src/event-waits/types.ts +51 -0
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/extensions/dispatcher.ts +9 -0
- package/src/fs/agent-fs-provider.ts +37 -3
- package/src/github/handlers.ts +3 -1
- package/src/github/pull-request-state.ts +34 -0
- package/src/gitlab/auth.ts +3 -4
- package/src/gitlab/handlers.ts +12 -7
- package/src/heartbeat/heartbeat.ts +11 -11
- package/src/hooks/codex-hook.ts +99 -1
- package/src/hooks/hook.ts +85 -11
- package/src/hooks/native-tool-hooks.ts +245 -0
- package/src/http/agent-lifecycle.ts +152 -0
- package/src/http/agents.ts +12 -0
- package/src/http/all-routes.ts +3 -0
- package/src/http/assets.ts +4 -3
- package/src/http/auth.ts +2 -1
- package/src/http/comb.ts +2 -2
- package/src/http/favorite-owner.ts +2 -2
- package/src/http/favorites.ts +3 -2
- package/src/http/fs.ts +13 -4
- package/src/http/index.ts +17 -0
- package/src/http/mcp-bridge.ts +4 -0
- package/src/http/object-webhooks.ts +101 -0
- package/src/http/objects.ts +265 -0
- package/src/http/operator-actor.ts +2 -1
- package/src/http/pages.ts +3 -3
- package/src/http/poll.ts +43 -12
- package/src/http/repos.ts +7 -6
- package/src/http/schedules.ts +10 -6
- package/src/http/script-connections.ts +2 -2
- package/src/http/scripts.ts +9 -0
- package/src/http/sessions.ts +37 -12
- package/src/http/skills.ts +17 -0
- package/src/http/task-requester.ts +2 -2
- package/src/http/tasks.ts +13 -3
- package/src/http/tool-hooks.ts +24 -2
- package/src/http/trackers/authorize-gate.ts +2 -2
- package/src/http/users.ts +136 -1
- package/src/http/workflow-events.ts +13 -0
- package/src/http/workflows.ts +47 -5
- package/src/integrations/chat-sdk/outbound-files.ts +3 -2
- package/src/linear/sync.ts +3 -1
- package/src/prompts/base-prompt.ts +35 -13
- package/src/prompts/session-templates.ts +25 -0
- package/src/providers/acp-targets.ts +2 -2
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/dsh-adapter.ts +1 -1
- package/src/providers/opencode-adapter.ts +5 -1
- package/src/providers/opencode-swarm-plugin.ts +50 -1
- package/src/providers/pi-mono-adapter.ts +139 -9
- package/src/providers/pi-mono-extension.ts +69 -0
- package/src/providers/runtime-dependencies.ts +1 -1
- package/src/rbac/legacy-policy.ts +5 -0
- package/src/rbac/permissions.ts +16 -1
- package/src/scheduler/deferred-task-waits.ts +170 -13
- package/src/script-workflows/guest-ctx.ts +32 -0
- package/src/script-workflows/workflow-ctx.ts +2 -0
- package/src/scripts-runtime/ctx.ts +9 -1
- package/src/scripts-runtime/executors/native.ts +106 -21
- package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
- package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
- package/src/scripts-runtime/executors/types.ts +5 -0
- package/src/scripts-runtime/loader.ts +8 -0
- package/src/scripts-runtime/mcp-client.ts +4 -0
- package/src/scripts-runtime/sdk-allowlist.ts +101 -0
- package/src/scripts-runtime/swarm-config.ts +8 -0
- package/src/scripts-runtime/swarm-sdk.ts +55 -3
- package/src/scripts-runtime/types/stdlib.d.ts +310 -0
- package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
- package/src/scripts-runtime/types/swarm-sdk.d.ts +310 -0
- package/src/server.ts +52 -0
- package/src/slack/enrich.ts +81 -21
- package/src/slack/handlers.test.ts +55 -2
- package/src/slack/handlers.ts +38 -3
- package/src/slack/render-v2.ts +19 -0
- package/src/slack/session-mirror.ts +208 -0
- package/src/slack/thread-participants.ts +0 -5
- package/src/slack/watcher.ts +3 -0
- package/src/slack/work-objects.test.ts +2 -1
- package/src/slack/work-objects.ts +7 -2
- package/src/tests/agent-history.test.ts +313 -0
- package/src/tests/agentmail-filters.test.ts +4 -3
- package/src/tests/audit-agent-person.test.ts +825 -0
- package/src/tests/audit-updated-by.test.ts +19 -12
- package/src/tests/azure-devops-auth.test.ts +6 -0
- package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
- package/src/tests/check-unit-test-allowlist.test.ts +193 -0
- package/src/tests/claude-hook-output.test.ts +107 -2
- package/src/tests/claude-managed-setup.test.ts +1 -1
- package/src/tests/codex-adapter.test.ts +6 -6
- package/src/tests/codex-gpt6-release.test.ts +4 -4
- package/src/tests/credential-check.test.ts +12 -0
- package/src/tests/db-task-read-contract.test.ts +3 -0
- package/src/tests/db-task-write-contract.test.ts +3 -0
- package/src/tests/dsh-adapter.test.ts +1 -1
- package/src/tests/e2e-coverage-contract.test.ts +6 -2
- package/src/tests/e2e-diff-coverage.test.ts +154 -0
- package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
- package/src/tests/e2e-shards.test.ts +137 -0
- package/src/tests/e2e-tracker-ingest.test.ts +266 -0
- package/src/tests/extensions-catalog.test.ts +33 -25
- package/src/tests/extensions-heartbeat.test.ts +34 -0
- package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
- package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
- package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
- package/src/tests/gitlab-auth.test.ts +10 -0
- package/src/tests/heartbeat.test.ts +38 -0
- package/src/tests/http-api-integration.test.ts +0 -6
- package/src/tests/kv-storage.test.ts +3 -0
- package/src/tests/memory-search-reader.test.ts +258 -0
- package/src/tests/memory-search-stall.test.ts +197 -20
- package/src/tests/model-control.test.ts +4 -4
- package/src/tests/model-tier-resolution.test.ts +2 -2
- package/src/tests/multi-runtime-registration.test.ts +8 -2
- package/src/tests/native-tool-hooks.test.ts +188 -0
- package/src/tests/opencode-adapter.test.ts +11 -0
- package/src/tests/opencode-swarm-plugin.test.ts +6 -1
- package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
- package/src/tests/poll-probe-readonly.test.ts +108 -0
- package/src/tests/primitives-boards.test.ts +686 -0
- package/src/tests/primitives-object-webhooks.test.ts +642 -0
- package/src/tests/primitives-objects.test.ts +248 -0
- package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
- package/src/tests/prompt-template-session.test.ts +3 -2
- package/src/tests/rbac-roles.test.ts +3 -0
- package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
- package/src/tests/script-connections.test.ts +4 -0
- package/src/tests/script-native-sandbox-identity.test.ts +264 -0
- package/src/tests/scripts-namespaces.test.ts +211 -0
- package/src/tests/secret-scrub-gate.test.ts +1 -0
- package/src/tests/secret-scrubber-convex.test.ts +168 -0
- package/src/tests/secret-scrubber.test.ts +1 -1
- package/src/tests/seed-model-profiles.test.ts +1 -1
- package/src/tests/session-tokens.test.ts +27 -0
- package/src/tests/sessions-tree.test.ts +10 -2
- package/src/tests/sheet-engine.test.ts +58 -0
- package/src/tests/slack-file-tools-attachments.test.ts +74 -6
- package/src/tests/slack-read-boundaries.test.ts +4 -2
- package/src/tests/slack-thread-participants.test.ts +66 -4
- package/src/tests/task-start-after-commit.test.ts +82 -0
- package/src/tests/tool-registrar-no-input.test.ts +1 -0
- package/src/tests/ui-logs-parser.test.ts +67 -0
- package/src/tests/workflow-retry-v2.test.ts +101 -0
- package/src/tests/workflow-tla-races.test.ts +29 -0
- package/src/tools/boards.ts +260 -0
- package/src/tools/defer-task.ts +154 -12
- package/src/tools/objects.ts +196 -0
- package/src/tools/repos/update-repo.ts +6 -6
- package/src/tools/schedules/create-schedule.ts +1 -0
- package/src/tools/schedules/list-schedules.ts +3 -0
- package/src/tools/schedules/patch-schedule.ts +12 -3
- package/src/tools/schedules/update-schedule.ts +12 -3
- package/src/tools/sheets.ts +378 -0
- package/src/tools/skills/skill-create.ts +6 -0
- package/src/tools/skills/skill-install-remote.ts +6 -0
- package/src/tools/skills/skill-sync-remote.ts +9 -0
- package/src/tools/skills/skill-update.ts +9 -1
- package/src/tools/slack-read.ts +10 -3
- package/src/tools/tool-config.ts +25 -0
- package/src/tools/utils.ts +15 -0
- package/src/tools/workflows/create-workflow.ts +20 -5
- package/src/tools/workflows/patch-workflow-node.ts +5 -1
- package/src/tools/workflows/patch-workflow.ts +9 -2
- package/src/tools/workflows/update-workflow.ts +27 -4
- package/src/types.ts +112 -12
- package/src/utils/sandboxed-process.ts +47 -2
- package/src/utils/secret-scrubber.ts +61 -6
- package/src/workflows/engine.ts +35 -21
- package/src/workflows/input.ts +36 -1
- package/src/workflows/patch-definition.ts +24 -2
- package/src/workflows/retry-poller.ts +15 -2
- package/src/workflows/triggers.ts +11 -6
- package/src/workflows/validation.ts +10 -0
- package/src/workflows/version.ts +7 -1
- package/templates/ai-toolbox.manifest.json +1 -1
- package/templates/skills/agent-browser/SKILL.md +1 -0
- package/templates/skills/agent-browser/content.md +1 -0
- package/templates/skills/boards-and-sheets/config.json +14 -0
- package/templates/skills/boards-and-sheets/content.md +163 -0
- package/templates/skills/pages/content.md +5 -0
- package/templates/skills/swarm-docs/content.md +15 -1
- package/templates/skills/swarm-scripts/SKILL.md +1 -0
- package/templates/skills/swarm-scripts/content.md +1 -0
- package/templates/skills/tdd-planning/content.md +5 -2
- package/dist/acp-adapter-weaaxey3.js +0 -16
- package/dist/core-df1n049h.js +0 -39
- package/dist/fx-adapter-zwmps9re.js +0 -19
- package/dist/grok-adapter-q0avf919.js +0 -19
- package/dist/handlers-g5jq0e4q.js +0 -36
- package/dist/index-1f6m47mq.js +0 -37
- package/dist/index-1p1mpqda.js +0 -36
- package/dist/index-tnkd410q.js +0 -41
- package/dist/lead-m5e7xt93.js +0 -75
- package/dist/thread-buffer-nf55vwx3.js +0 -39
- package/dist/worker-ews1nyhw.js +0 -75
- package/src/slack/socket-mode-guard.test.ts +0 -25
- package/src/tests/agent-activity.test.ts +0 -247
- package/src/tests/agent-fs-live-url.test.ts +0 -55
- package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
- package/src/tests/approval-sweeps-config.test.ts +0 -47
- package/src/tests/cards.test.ts +0 -169
- package/src/tests/chat-sdk-facts.test.ts +0 -23
- package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
- package/src/tests/core-auth.test.ts +0 -156
- package/src/tests/date-utils.test.ts +0 -48
- package/src/tests/db-context-versions.test.ts +0 -37
- package/src/tests/db-runtime.test.ts +0 -132
- package/src/tests/enabled-capabilities.test.ts +0 -20
- package/src/tests/extensions-example-mcp-install.test.ts +0 -67
- package/src/tests/extensions-lead-equivalence.test.ts +0 -70
- package/src/tests/get-workflow-run-tool.test.ts +0 -98
- package/src/tests/github-event-labels.test.ts +0 -24
- package/src/tests/haiku-5-5-pricing.test.ts +0 -38
- package/src/tests/http-log-scrubbing.test.ts +0 -123
- package/src/tests/http-semconv-attributes.test.ts +0 -92
- package/src/tests/identity.test.ts +0 -117
- package/src/tests/inbox-state.test.ts +0 -167
- package/src/tests/internal-ai/models.test.ts +0 -54
- package/src/tests/launch-password-rejection.test.ts +0 -140
- package/src/tests/list-total-cache.test.ts +0 -88
- package/src/tests/match-route.test.ts +0 -187
- package/src/tests/memory-feature-flags.test.ts +0 -45
- package/src/tests/memory-get-tool.test.ts +0 -269
- package/src/tests/memory-health-endpoint.test.ts +0 -78
- package/src/tests/memory-http-access.test.ts +0 -221
- package/src/tests/memory-retrieval-purge.test.ts +0 -99
- package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
- package/src/tests/openai-embedding-provider.test.ts +0 -159
- package/src/tests/org-identity.test.ts +0 -44
- package/src/tests/pages-actions-endpoint.test.ts +0 -103
- package/src/tests/pages-browser-sdk.test.ts +0 -76
- package/src/tests/pages-feedback-keys.test.ts +0 -121
- package/src/tests/pages-frame-ancestors.test.ts +0 -189
- package/src/tests/pages-list-endpoint.test.ts +0 -148
- package/src/tests/pages-password-mode.test.ts +0 -266
- package/src/tests/pages-public-authed-401.test.ts +0 -103
- package/src/tests/pages-public-html.test.ts +0 -297
- package/src/tests/pages-public-json-redirect.test.ts +0 -122
- package/src/tests/pages-view-count.test.ts +0 -245
- package/src/tests/prompt-templates-db.test.ts +0 -616
- package/src/tests/rbac-engine.test.ts +0 -742
- package/src/tests/repo-allow-merge-gate.test.ts +0 -389
- package/src/tests/route-def-find-route.test.ts +0 -192
- package/src/tests/runtime-stale-threshold.test.ts +0 -40
- package/src/tests/schedule-validation-helper.test.ts +0 -51
- package/src/tests/scheduled-tasks-api.test.ts +0 -355
- package/src/tests/scheduler-backoff.test.ts +0 -166
- package/src/tests/script-run-token.test.ts +0 -75
- package/src/tests/scripts-extract-signature.test.ts +0 -47
- package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
- package/src/tests/seed-workflow-dreaming.test.ts +0 -117
- package/src/tests/short-id.test.ts +0 -23
- package/src/tests/skill-files-http.test.ts +0 -222
- package/src/tests/skill-get-file-tool.test.ts +0 -110
- package/src/tests/skill-script-refs.test.ts +0 -63
- package/src/tests/skill-update-scope.test.ts +0 -252
- package/src/tests/skills-bundle.test.ts +0 -99
- package/src/tests/slack-app-icon.test.ts +0 -94
- package/src/tests/slack-assistant-comention.test.ts +0 -139
- package/src/tests/slack-delete.test.ts +0 -157
- package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
- package/src/tests/slack-manifest.test.ts +0 -23
- package/src/tests/slack-task-output.test.ts +0 -90
- package/src/tests/store-progress-output-guidance.test.ts +0 -34
- package/src/tests/swarm-diff.test.ts +0 -728
- package/src/tests/task-lifecycle-events.test.ts +0 -53
- package/src/tests/template-asset-config.test.ts +0 -18
- package/src/tests/template-fetch.test.ts +0 -490
- package/src/tests/themes-page-theme.test.ts +0 -155
- package/src/tests/tool-annotations.test.ts +0 -442
- package/src/tests/tool-output-agent-id.test.ts +0 -202
- package/src/tests/update-profile-agentid.test.ts +0 -248
- package/src/tests/whoami-route.test.ts +0 -162
- package/src/tests/workflow-definition-telemetry.test.ts +0 -144
- package/src/tests/workflow-patch.test.ts +0 -169
- package/src/tests/workflow-run-steps-index.test.ts +0 -65
- package/src/tests/workflow-schedule-trigger.test.ts +0 -104
- package/src/tests/workflow-step-claims.test.ts +0 -152
- package/src/tests/workflow-step-order.test.ts +0 -92
- package/src/tests/workflow-trigger-schema.test.ts +0 -359
- package/src/tests/workflow-versions.test.ts +0 -240
- package/src/tests/workflow-wait.test.ts +0 -26
|
@@ -4,7 +4,7 @@ import type { StepProps } from "../types.ts";
|
|
|
4
4
|
import { type InstallProvider, PROVIDER_HARNESS } from "../types.ts";
|
|
5
5
|
|
|
6
6
|
export const PROVIDER_CAPABILITY_MATRIX_URL =
|
|
7
|
-
"https://docs.agent-swarm.dev/docs/guides/harness-configuration#supported-
|
|
7
|
+
"https://docs.agent-swarm.dev/docs/guides/harness-configuration#supported-harnesses";
|
|
8
8
|
|
|
9
9
|
export function HarnessStep({ goToNext, addLog }: StepProps) {
|
|
10
10
|
return (
|
|
@@ -152,6 +152,7 @@ export const REQUIRED_CRED_VARS_BY_PROVIDER: Record<SupportedProvider, readonly
|
|
|
152
152
|
"OPENROUTER_API_KEY",
|
|
153
153
|
"ANTHROPIC_API_KEY",
|
|
154
154
|
"OPENAI_API_KEY",
|
|
155
|
+
"OPENCODE_API_KEY",
|
|
155
156
|
...openAICompatibleKeyVars(),
|
|
156
157
|
],
|
|
157
158
|
pi: ["ANTHROPIC_API_KEY", "OPENROUTER_API_KEY", "OPENAI_API_KEY", ...openAICompatibleKeyVars()],
|
package/src/e2b/env.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { resolve } from "node:path";
|
|
2
2
|
import { openAICompatibleBaseUrlVars, openAICompatibleKeyVars } from "@desplega/model-catalog";
|
|
3
3
|
import { getApiKey } from "../utils/api-key";
|
|
4
|
-
import { isSensitiveKey, scrubSecrets } from "../utils/secret-scrubber";
|
|
4
|
+
import { isSensitiveKey, scrubSecrets, urlForms } from "../utils/secret-scrubber";
|
|
5
5
|
|
|
6
6
|
export type EnvMap = Record<string, string>;
|
|
7
7
|
|
|
@@ -174,6 +174,8 @@ export function redactWithEnv(text: string, env: EnvMap): string {
|
|
|
174
174
|
let out = text;
|
|
175
175
|
const entries = Object.entries(env)
|
|
176
176
|
.filter(([key, value]) => isSensitiveKey(key) && value.length >= 8)
|
|
177
|
+
.flatMap(([key, value]) => urlForms(value).map((form): [string, string] => [key, form]))
|
|
178
|
+
.filter(([, form]) => form.length >= 8)
|
|
177
179
|
.sort((a, b) => b[1].length - a[1].length);
|
|
178
180
|
|
|
179
181
|
for (const [key, value] of entries) {
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import * as z from "zod";
|
|
2
|
+
import { isGitHubEnabled } from "@/github/app";
|
|
3
|
+
import { fetchPullRequestState } from "@/github/pull-request-state";
|
|
4
|
+
import type { EventMatch, ExternalEvent, ExternalEventAdapter } from "./types";
|
|
5
|
+
|
|
6
|
+
const PrMatch = z
|
|
7
|
+
.object({ repo: z.string().regex(/^[\w.-]+\/[\w.-]+$/), number: z.number().int().positive() })
|
|
8
|
+
.strict();
|
|
9
|
+
|
|
10
|
+
/** GitHub names repos case-insensitively; waits and events both carry them lowercase. */
|
|
11
|
+
function prMatch(repo: string, number: number): EventMatch {
|
|
12
|
+
return { repo: repo.toLowerCase(), number };
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export const githubAdapter: ExternalEventAdapter = {
|
|
16
|
+
source: "github",
|
|
17
|
+
events: ["vcs.pr.merged"],
|
|
18
|
+
matchHint: "repo (owner/name), number",
|
|
19
|
+
busPrefix: "github.pull_request.",
|
|
20
|
+
readsWithServerCredentials: true,
|
|
21
|
+
isEnabled: isGitHubEnabled,
|
|
22
|
+
parseMatch(_event, match) {
|
|
23
|
+
const parsed = PrMatch.safeParse(match);
|
|
24
|
+
if (!parsed.success) {
|
|
25
|
+
throw new Error("match for a github PR event takes repo (owner/name) and number only.");
|
|
26
|
+
}
|
|
27
|
+
return prMatch(parsed.data.repo, parsed.data.number);
|
|
28
|
+
},
|
|
29
|
+
fromBusEvent(busEvent, payload): ExternalEvent[] {
|
|
30
|
+
const pr = payload as { repo?: unknown; number?: unknown; merged?: unknown } | null;
|
|
31
|
+
if (
|
|
32
|
+
busEvent !== "github.pull_request.closed" ||
|
|
33
|
+
pr?.merged !== true ||
|
|
34
|
+
typeof pr.repo !== "string" ||
|
|
35
|
+
typeof pr.number !== "number"
|
|
36
|
+
)
|
|
37
|
+
return [];
|
|
38
|
+
return [{ event: "vcs.pr.merged", match: prMatch(pr.repo, pr.number) }];
|
|
39
|
+
},
|
|
40
|
+
async confirm(_event, match) {
|
|
41
|
+
return (await fetchPullRequestState(String(match.repo), Number(match.number))).merged;
|
|
42
|
+
},
|
|
43
|
+
};
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { githubAdapter } from "./github";
|
|
2
|
+
import type { ExternalEventAdapter } from "./types";
|
|
3
|
+
|
|
4
|
+
export * from "./types";
|
|
5
|
+
|
|
6
|
+
/** Register a provider here: this is the only list to extend (GitLab, Linear, ...). */
|
|
7
|
+
export const EXTERNAL_EVENT_ADAPTERS: readonly ExternalEventAdapter[] = [githubAdapter];
|
|
8
|
+
|
|
9
|
+
export function getExternalEventAdapter(source: string): ExternalEventAdapter | undefined {
|
|
10
|
+
return EXTERNAL_EVENT_ADAPTERS.find((adapter) => adapter.source === source);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Bus names the webhook ingest owns. The workflow-events API emits caller-chosen names on the
|
|
15
|
+
* same bus, so it must refuse these: a forged provider event could wake an adapter that
|
|
16
|
+
* trusts the event (no `confirm`), or drive confirm reads with server credentials.
|
|
17
|
+
*/
|
|
18
|
+
export function isReservedProviderEvent(name: string): boolean {
|
|
19
|
+
return EXTERNAL_EVENT_ADAPTERS.some((adapter) => name.startsWith(adapter.busPrefix));
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** Every shared event name some adapter serves, deduplicated. */
|
|
23
|
+
export const EXTERNAL_EVENT_NAMES: [string, ...string[]] = [
|
|
24
|
+
...new Set(EXTERNAL_EVENT_ADAPTERS.flatMap((adapter) => adapter.events)),
|
|
25
|
+
] as [string, ...string[]];
|
|
26
|
+
|
|
27
|
+
/** Tool-description line listing the served events; the docs generator reads it as a literal, so keep it in step with the list above. */
|
|
28
|
+
export const EXTERNAL_EVENTS_DOC =
|
|
29
|
+
'vcs.pr.merged with source "github" and match {repo (owner/name), number}';
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* External-event waits: `defer-task wakeOn {event, source, match}` wakes an agent
|
|
3
|
+
* when a provider event arrives. Events enter through the webhook ingest that
|
|
4
|
+
* already emits on `workflowEventBus` (src/http/webhooks.ts); a provider plugs in
|
|
5
|
+
* by implementing this interface and registering in ./index.ts. The scheduler,
|
|
6
|
+
* the tool schema and the table know nothing about any one provider.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
/** What a wait targets, normalized by the adapter (e.g. `{repo: "owner/name", number: 7}`). */
|
|
10
|
+
export type EventMatch = Record<string, string | number>;
|
|
11
|
+
|
|
12
|
+
/** A provider event reduced to the shared vocabulary (e.g. `vcs.pr.merged`). */
|
|
13
|
+
export type ExternalEvent = { event: string; match: EventMatch };
|
|
14
|
+
|
|
15
|
+
export interface ExternalEventAdapter {
|
|
16
|
+
/** Provider id as agents write it in `wakeOn.source`, e.g. `github`. */
|
|
17
|
+
readonly source: string;
|
|
18
|
+
/** Shared event names this adapter can serve, e.g. `vcs.pr.merged`. */
|
|
19
|
+
readonly events: readonly string[];
|
|
20
|
+
/** What `match` holds, for the tool description, e.g. `repo (owner/name), number`. */
|
|
21
|
+
readonly matchHint: string;
|
|
22
|
+
/** `workflowEventBus` name prefix the provider's webhook handler emits under, e.g. `github.`. */
|
|
23
|
+
readonly busPrefix: string;
|
|
24
|
+
/** True when `confirm` reads with server-held credentials, so task-scoped tokens may not trigger it. */
|
|
25
|
+
readonly readsWithServerCredentials?: boolean;
|
|
26
|
+
/** False when the provider integration is off, so no event could ever arrive. */
|
|
27
|
+
isEnabled(): boolean;
|
|
28
|
+
/** Validate and normalize the agent's match for `event`; throw an Error whose message names the fix. */
|
|
29
|
+
parseMatch(event: string, match: unknown): EventMatch;
|
|
30
|
+
/** Map one bus event to the shared events it signals (usually zero or one). Must not throw. */
|
|
31
|
+
fromBusEvent(busEvent: string, payload: unknown): ExternalEvent[];
|
|
32
|
+
/**
|
|
33
|
+
* Optional authoritative read: has `event` already happened for `match`? Throws
|
|
34
|
+
* when the provider cannot be read. With it, a webhook only names a candidate and
|
|
35
|
+
* the wait fires only on `true`, and boot re-checks pending waits (a delivery
|
|
36
|
+
* missed while the API was down). Without it, the verified webhook is trusted.
|
|
37
|
+
*/
|
|
38
|
+
confirm?(event: string, match: EventMatch): Promise<boolean>;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** Canonical key for lookup: the same match always yields the same string. */
|
|
42
|
+
export function matchKeyOf(match: EventMatch): string {
|
|
43
|
+
return JSON.stringify(Object.entries(match).sort(([a], [b]) => (a < b ? -1 : 1)));
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export function describeEventWait(source: string, event: string, match: EventMatch): string {
|
|
47
|
+
const target = Object.entries(match)
|
|
48
|
+
.map(([key, value]) => `${key}=${value}`)
|
|
49
|
+
.join(", ");
|
|
50
|
+
return `${event} on ${source} (${target})`;
|
|
51
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
// Generated by scripts/bundle-extension-types.ts. Do not edit.
|
|
2
2
|
// biome-ignore-all lint/suspicious/noTemplateCurlyInString: Type declarations contain literal template placeholders.
|
|
3
3
|
export const EXTENSION_TYPE_DEFINITIONS =
|
|
4
|
-
'// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "mcp" | "native" | "extension" | "script-sdk";\n harness?: string | undefined;\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
|
|
4
|
+
'// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n auditSourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "mcp" | "native" | "extension" | "script-sdk";\n harness?: string | undefined;\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
|
|
@@ -385,6 +385,15 @@ export function unregister(extensionId: string): LoadedExtension | undefined {
|
|
|
385
385
|
return loaded;
|
|
386
386
|
}
|
|
387
387
|
|
|
388
|
+
/** True when an enabled extension takes native tool calls: workers skip the hook round trip otherwise. */
|
|
389
|
+
export function hasNativeToolHandlers(): boolean {
|
|
390
|
+
return [...registry.values()].some(
|
|
391
|
+
(loaded) =>
|
|
392
|
+
(loaded.manifest.toolSources ?? ["mcp"]).includes("native") &&
|
|
393
|
+
loaded.handlers.some((h) => h.event === "pre.tool.call" || h.event === "post.tool.call"),
|
|
394
|
+
);
|
|
395
|
+
}
|
|
396
|
+
|
|
388
397
|
export function listRegistered(): LoadedExtension[] {
|
|
389
398
|
return [...registry.values()];
|
|
390
399
|
}
|
|
@@ -81,6 +81,14 @@ export type AgentFsCommentThread = {
|
|
|
81
81
|
// A failed identity lookup is not asked again for this long.
|
|
82
82
|
const SERVICE_USER_RETRY_MS = 60_000;
|
|
83
83
|
|
|
84
|
+
// A stored key is a literal drive path: encode each segment so a `#`, `?` or `%`
|
|
85
|
+
// in a name stays in the URL path. A task-scoped path is already encoded by normalizeName.
|
|
86
|
+
function rawPath(scope: FileScope): string {
|
|
87
|
+
const path = providerPath(scope);
|
|
88
|
+
if (scope.key === undefined || scope.key === null || scope.key === "") return path;
|
|
89
|
+
return path.split("/").map(encodeURIComponent).join("/");
|
|
90
|
+
}
|
|
91
|
+
|
|
84
92
|
export class AgentFsProvider implements FileStorageProvider {
|
|
85
93
|
readonly id = "agent-fs";
|
|
86
94
|
readonly capabilities = {
|
|
@@ -121,7 +129,10 @@ export class AgentFsProvider implements FileStorageProvider {
|
|
|
121
129
|
async upload(scope: FileScope, body: FileBody, options: UploadOptions = {}): Promise<FileObject> {
|
|
122
130
|
const headers = new Headers(this.authHeaders());
|
|
123
131
|
if (options.contentType) {
|
|
124
|
-
|
|
132
|
+
// agent-fs answers a JSON content type on PUT /raw with 415 and stores the type it detects
|
|
133
|
+
// from the path, so JSON goes out as octet-stream; the returned FileObject keeps the caller's type.
|
|
134
|
+
const isJson = options.contentType.trim().toLowerCase().startsWith("application/json");
|
|
135
|
+
headers.set("content-type", isJson ? "application/octet-stream" : options.contentType);
|
|
125
136
|
}
|
|
126
137
|
if (options.ifNoneMatch) {
|
|
127
138
|
headers.set("if-none-match", options.ifNoneMatch);
|
|
@@ -226,6 +237,16 @@ export class AgentFsProvider implements FileStorageProvider {
|
|
|
226
237
|
}
|
|
227
238
|
}
|
|
228
239
|
|
|
240
|
+
/** Paths (leading slash) on the provider's drive that match an agent-fs glob `pattern`. */
|
|
241
|
+
async glob(pattern: string): Promise<string[]> {
|
|
242
|
+
const matches = asRecord(await this.ops({ op: "glob", pattern }))?.matches;
|
|
243
|
+
if (!Array.isArray(matches)) return [];
|
|
244
|
+
return matches.flatMap((match) => {
|
|
245
|
+
const path = asRecord(match)?.path;
|
|
246
|
+
return typeof path === "string" ? [path] : [];
|
|
247
|
+
});
|
|
248
|
+
}
|
|
249
|
+
|
|
229
250
|
async url(scope: FileScope, options: SignedUrlOptions = {}): Promise<string> {
|
|
230
251
|
const expiresIn = Math.min(options.expiresIn ?? 3600, this.capabilities.signedUrl.maxExpiresIn);
|
|
231
252
|
const result = await this.ops(
|
|
@@ -297,6 +318,13 @@ export class AgentFsProvider implements FileStorageProvider {
|
|
|
297
318
|
return (await this.ops({ op: "comment-get", id }, drive)) as AgentFsCommentThread;
|
|
298
319
|
}
|
|
299
320
|
|
|
321
|
+
/** Current version of one file from the `stat` op; null when agent-fs reports none. */
|
|
322
|
+
async currentVersion(scope: FileScope): Promise<number | null> {
|
|
323
|
+
const result = asRecord(await this.ops({ op: "stat", path: providerPath(scope) }, scope));
|
|
324
|
+
const version = result?.currentVersion;
|
|
325
|
+
return typeof version === "number" && Number.isFinite(version) ? version : null;
|
|
326
|
+
}
|
|
327
|
+
|
|
300
328
|
/** `log` of one file (at most 200 versions). */
|
|
301
329
|
async getFileVersions(drive: AgentFsDrive, path: string): Promise<AgentFsFileVersion[]> {
|
|
302
330
|
const result = asRecord(await this.ops({ op: "log", path, limit: 200 }, drive));
|
|
@@ -419,7 +447,13 @@ export class AgentFsProvider implements FileStorageProvider {
|
|
|
419
447
|
cause: error,
|
|
420
448
|
});
|
|
421
449
|
}
|
|
422
|
-
|
|
450
|
+
// fetch rejects only when no response arrived: a refused or reset
|
|
451
|
+
// connection, DNS, TLS. Callers handle it like any other provider error.
|
|
452
|
+
throw new FilesError(
|
|
453
|
+
"Provider",
|
|
454
|
+
`agent-fs is unreachable: ${error instanceof Error ? error.message : String(error)}`,
|
|
455
|
+
{ cause: error },
|
|
456
|
+
);
|
|
423
457
|
} finally {
|
|
424
458
|
clearTimeout(timer);
|
|
425
459
|
}
|
|
@@ -427,7 +461,7 @@ export class AgentFsProvider implements FileStorageProvider {
|
|
|
427
461
|
|
|
428
462
|
private rawUrl(scope: FileScope): string {
|
|
429
463
|
const { orgId, driveId } = this.scopeFor(scope);
|
|
430
|
-
return `${this.apiUrl}/orgs/${encodeURIComponent(orgId)}/drives/${encodeURIComponent(driveId)}/files/${
|
|
464
|
+
return `${this.apiUrl}/orgs/${encodeURIComponent(orgId)}/drives/${encodeURIComponent(driveId)}/files/${rawPath(scope)}/raw`;
|
|
431
465
|
}
|
|
432
466
|
|
|
433
467
|
private scopeFor(scope?: Pick<FileScope, "orgId" | "driveId">): {
|
package/src/github/handlers.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { failTask, findTaskByVcs, getAllAgents, getSwarmConfigs, incrKv, upsertKv } from "../be/db";
|
|
2
2
|
import { renderIdentity, resolveIdentity } from "../be/identity";
|
|
3
|
+
import { isUnmappedIdentityDismissed } from "../be/unmapped-identities";
|
|
3
4
|
import { findUserByExternalId } from "../be/users";
|
|
4
5
|
import { resolveTemplate } from "../prompts/resolver";
|
|
5
6
|
import { githubContextKey } from "../tasks/context-key";
|
|
@@ -182,7 +183,8 @@ async function resolveGitHubSender(
|
|
|
182
183
|
const existing = await findUserByExternalId("github", login);
|
|
183
184
|
if (existing) return existing.id;
|
|
184
185
|
|
|
185
|
-
// No mapping → unmapped tracker.
|
|
186
|
+
// No mapping → unmapped tracker, unless an operator dismissed this login.
|
|
187
|
+
if (await isUnmappedIdentityDismissed("github", login)) return undefined;
|
|
186
188
|
await upsertKv({
|
|
187
189
|
namespace: UNMAPPED_NAMESPACE,
|
|
188
190
|
key: `${login}:meta`,
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { githubApiUrl } from "../utils/github-host";
|
|
2
|
+
import { getWorkerInstallationToken } from "./app";
|
|
3
|
+
|
|
4
|
+
export type PullRequestState = { merged: boolean; state: "open" | "closed" };
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Read one PR from GitHub. A webhook only names a candidate; callers that wake
|
|
8
|
+
* an agent confirm here first. Sends the App installation token when one is
|
|
9
|
+
* configured, otherwise reads unauthenticated (enough for a public repo).
|
|
10
|
+
* Throws on any non-2xx so a failed read never counts as an answer.
|
|
11
|
+
*/
|
|
12
|
+
export async function fetchPullRequestState(
|
|
13
|
+
repo: string,
|
|
14
|
+
number: number,
|
|
15
|
+
): Promise<PullRequestState> {
|
|
16
|
+
const auth = await getWorkerInstallationToken();
|
|
17
|
+
const response = await fetch(githubApiUrl(`/repos/${repo}/pulls/${number}`), {
|
|
18
|
+
headers: {
|
|
19
|
+
Accept: "application/vnd.github+json",
|
|
20
|
+
"X-GitHub-Api-Version": "2022-11-28",
|
|
21
|
+
...(auth.status === "ok" ? { Authorization: `Bearer ${auth.token}` } : {}),
|
|
22
|
+
},
|
|
23
|
+
signal: AbortSignal.timeout(10_000),
|
|
24
|
+
});
|
|
25
|
+
if (!response.ok) throw new Error(`GitHub returned ${response.status} for ${repo}#${number}`);
|
|
26
|
+
const pr = (await response.json()) as {
|
|
27
|
+
merged?: boolean;
|
|
28
|
+
state?: string;
|
|
29
|
+
};
|
|
30
|
+
return {
|
|
31
|
+
merged: pr.merged === true,
|
|
32
|
+
state: pr.state === "open" ? "open" : "closed",
|
|
33
|
+
};
|
|
34
|
+
}
|
package/src/gitlab/auth.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { isEnvFlagEnabled } from "../utils/env-flag";
|
|
2
|
+
import { verifyTokenEquality } from "../workflows/triggers";
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* GitLab Authentication & Webhook Verification
|
|
@@ -33,14 +34,12 @@ export function initGitLab(): void {
|
|
|
33
34
|
|
|
34
35
|
/**
|
|
35
36
|
* Verify a GitLab webhook request.
|
|
36
|
-
*
|
|
37
|
+
* The X-Gitlab-Token header is compared to the configured secret in constant time, by digest.
|
|
37
38
|
*/
|
|
38
39
|
export function verifyGitLabWebhook(tokenHeader: string | undefined): boolean {
|
|
39
40
|
if (!webhookSecret) return false;
|
|
40
41
|
if (!tokenHeader) return false;
|
|
41
|
-
|
|
42
|
-
if (tokenHeader.length !== webhookSecret.length) return false;
|
|
43
|
-
return crypto.timingSafeEqual(Buffer.from(tokenHeader), Buffer.from(webhookSecret));
|
|
42
|
+
return verifyTokenEquality(webhookSecret, tokenHeader);
|
|
44
43
|
}
|
|
45
44
|
|
|
46
45
|
/** Get the GitLab API token for making API calls. */
|
package/src/gitlab/handlers.ts
CHANGED
|
@@ -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
|
|
105
|
-
*
|
|
106
|
-
*
|
|
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
|
|
121
|
-
//
|
|
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`,
|
|
@@ -871,19 +871,11 @@ async function remediateCrashedWorkerTask(
|
|
|
871
871
|
resume.kind === "skipped"
|
|
872
872
|
? `resume_creation_skipped_${resume.reason}`
|
|
873
873
|
: "resume_creation_skipped_workflow";
|
|
874
|
+
// The task is already `superseded` (terminal), so `failTask` would be a no-op:
|
|
875
|
+
// it stays superseded and is not an auto-failure. Dependents fail as before.
|
|
874
876
|
await settleSupersededTaskDependents(task.id, null);
|
|
875
|
-
const failed = await failTask(task.id, reason);
|
|
876
|
-
if (failed) {
|
|
877
|
-
findings.autoFailedTasks.push({
|
|
878
|
-
taskId: task.id,
|
|
879
|
-
agentId: task.agentId,
|
|
880
|
-
reason,
|
|
881
|
-
});
|
|
882
|
-
}
|
|
883
877
|
console.warn(
|
|
884
|
-
`[Heartbeat] Task ${task.id.slice(0, 8)}
|
|
885
|
-
resume.kind === "skipped" ? resume.reason : "workflow-skip"
|
|
886
|
-
})`,
|
|
878
|
+
`[Heartbeat] Task ${task.id.slice(0, 8)} left superseded: no resume was created (${reason})`,
|
|
887
879
|
);
|
|
888
880
|
}
|
|
889
881
|
|
|
@@ -1020,6 +1012,14 @@ export async function runRebootSweep(): Promise<void> {
|
|
|
1020
1012
|
continue;
|
|
1021
1013
|
}
|
|
1022
1014
|
|
|
1015
|
+
// Workflow carve-out: failTask above emitted task.failed with the step
|
|
1016
|
+
// ids, and the engine retries the step or fails the run. A standalone
|
|
1017
|
+
// retry here would run the same work a second time, outside the run.
|
|
1018
|
+
if (task.workflowRunStepId != null) {
|
|
1019
|
+
rebootAffectedTasks.push({ original: failed, retryTaskId: null });
|
|
1020
|
+
continue;
|
|
1021
|
+
}
|
|
1022
|
+
|
|
1023
1023
|
// Auto-retry: create a replacement task with parentTaskId
|
|
1024
1024
|
// A corrupt persisted affinity is never converted into an untagged
|
|
1025
1025
|
// retry by this independent recovery path.
|