@desplega.ai/agent-swarm 2.8.2 → 2.9.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-jqn86aam.js +16 -0
- package/dist/acp-targets-swxq55dr.js +23 -0
- package/dist/{actions-kxek041g.js → actions-pb678g3e.js} +22 -20
- package/dist/agent-fs-provision-dmhnc38q.js +27 -0
- package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-3pa66q27.js} +3 -3
- package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
- package/dist/{app-v6zz8yh0.js → app-17d12ev4.js} +6 -4
- package/dist/approval-notifications-h7vd9pmg.js +20 -0
- package/dist/{assistant-m0sw9xx2.js → assistant-t7k39ree.js} +56 -34
- package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
- package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-0gqmkfbe.js} +1 -1
- package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-f064w382.js} +1 -1
- package/dist/{boot-reembed-y27n09tz.js → boot-reembed-n6anc01d.js} +1 -1
- package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
- package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-f99fjs5q.js} +4 -4
- package/dist/{boxd-ent8ch04.js → boxd-wn235q80.js} +7 -7
- package/dist/claude-adapter-gvznwxgc.js +28 -0
- package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-pbrbvc64.js} +4 -4
- package/dist/{claude-managed-setup-y6z2perp.js → claude-managed-setup-kdxttvc3.js} +11 -11
- package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0t2teq6n.js} +9386 -9197
- package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
- package/dist/{cli-rmzsadkf.js → cli-1tvdx9t5.js} +2 -2
- package/dist/{cli-3vmb0n58.js → cli-25nstr34.js} +1 -1
- package/dist/{cli-959kp5h2.js → cli-2kg31ted.js} +45 -38
- package/dist/{cli-4vzgeta4.js → cli-2tnbc3gw.js} +375 -127
- package/dist/{cli-tekytdq9.js → cli-3zxdz9r7.js} +9 -9
- package/dist/{cli-bsywb58a.js → cli-4ghh072d.js} +16 -16
- package/dist/{cli-9mb2q6pb.js → cli-57pvhnyt.js} +4 -4
- package/dist/{cli-d84byzn8.js → cli-5a6pqy45.js} +441 -53
- package/dist/{cli-jrzkw01m.js → cli-5gpqgs8b.js} +2 -2
- package/dist/{cli-0cq8y6m7.js → cli-5gygrr67.js} +9 -9
- package/dist/{cli-z1w943va.js → cli-5kcmxwxv.js} +3 -3
- package/dist/{cli-3e875j5p.js → cli-5ntc4we6.js} +3189 -328
- package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
- package/dist/{cli-mrt48bx7.js → cli-6237rnyr.js} +1 -1
- package/dist/cli-6dp0jkfj.js +754 -0
- package/dist/{cli-b98a65ed.js → cli-7831nhaw.js} +5 -5
- package/dist/{cli-kjtwrhea.js → cli-7cgf614g.js} +10 -10
- package/dist/{cli-fwy8kfd6.js → cli-7fx9jyfs.js} +942 -63
- package/dist/{cli-28fq781p.js → cli-7zm3b3f5.js} +1 -1
- package/dist/{cli-v1dv1r37.js → cli-812paz57.js} +143 -9
- package/dist/{cli-837vfs2x.js → cli-8axx8vnw.js} +4 -4
- package/dist/cli-8x8y70av.js +103 -0
- package/dist/{cli-vj75tyaw.js → cli-95930z69.js} +15 -7
- package/dist/{cli-j24zbska.js → cli-9a2rtd77.js} +16 -14
- package/dist/cli-9ttx00s3.js +137 -0
- package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
- package/dist/{cli-dzpc6en0.js → cli-aa8s22gn.js} +19 -14
- package/dist/{cli-x1wa213s.js → cli-bk9v1xrv.js} +21 -21
- package/dist/{cli-a0z912j7.js → cli-c07v0qfa.js} +194 -75
- package/dist/{cli-1qkz151v.js → cli-c5cspahx.js} +28 -36
- package/dist/{cli-vdektqgf.js → cli-cw7mc1je.js} +4 -4
- package/dist/{cli-n6vtrcht.js → cli-dd37e0cm.js} +2 -2
- package/dist/cli-dqgnbnxs.js +132 -0
- package/dist/{cli-kc7v1nfv.js → cli-dx439zpg.js} +1 -1
- package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
- package/dist/{cli-f6bahpn5.js → cli-e9973bf0.js} +8 -6
- package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
- package/dist/{cli-6rc5frdm.js → cli-eepnpee7.js} +34 -37
- package/dist/{cli-rvhdmjvt.js → cli-eg437b5p.js} +1 -1
- package/dist/cli-faf46gdq.js +714 -0
- package/dist/{cli-f4r3g076.js → cli-fgphc007.js} +2 -2
- package/dist/{cli-5y340nzn.js → cli-fnh4b12r.js} +24 -18
- package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
- package/dist/{cli-e1p3n5gq.js → cli-g3zzby8t.js} +13 -13
- package/dist/{cli-3vjhs18n.js → cli-gabsjg8x.js} +3 -1
- package/dist/{cli-1pz0330a.js → cli-gddgcnav.js} +3 -3
- package/dist/{cli-97ae65rz.js → cli-h474mvp5.js} +11 -11
- package/dist/{cli-m88rpzkh.js → cli-hnamkvnc.js} +2 -2
- package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
- package/dist/{cli-w401b9tq.js → cli-jd3kxppb.js} +1 -1
- package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
- package/dist/{cli-8aes17e4.js → cli-js8zrfyg.js} +3 -3
- package/dist/{cli-pfs8adn4.js → cli-k09cxm6m.js} +9 -7
- package/dist/{cli-q24n86d2.js → cli-k7pt28ad.js} +10 -3
- package/dist/{cli-zh9rsbqf.js → cli-kaa4bd7x.js} +11 -8
- package/dist/cli-kj0hyr43.js +51 -0
- package/dist/{cli-g70vxtjh.js → cli-kmvcm34h.js} +2 -2
- package/dist/{cli-t2tma8gb.js → cli-kqh27v2y.js} +2 -2
- package/dist/{cli-mxn1qvbn.js → cli-m1fbz2wj.js} +32 -57
- package/dist/{cli-2kvhc7x8.js → cli-mc1fx4xd.js} +51 -90
- package/dist/{cli-pchypa1s.js → cli-me4maa4j.js} +61 -6
- package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
- package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
- package/dist/cli-nhq5js1b.js +142 -0
- package/dist/cli-nmcpzbty.js +296 -0
- package/dist/cli-nr46j5pw.js +78 -0
- package/dist/{cli-5mrq3ake.js → cli-pn1v1pb0.js} +1 -1
- package/dist/{cli-f4e8r23x.js → cli-pwsax0vp.js} +11 -6
- package/dist/{cli-gyt3zydq.js → cli-pz1c00aa.js} +9 -754
- package/dist/{cli-eddnyg3t.js → cli-q2d3e1k1.js} +1 -1
- package/dist/{cli-fpjmegdb.js → cli-q8cfh1t9.js} +2 -2
- package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
- package/dist/{cli-2r0jcc3k.js → cli-qj39vrc6.js} +1 -1
- package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
- package/dist/{cli-0jzra9ad.js → cli-rts1qvb4.js} +2 -2
- package/dist/{cli-3rkdne1h.js → cli-sn4pc4qx.js} +2 -2
- package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
- package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
- package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
- package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
- package/dist/{cli-2gxeg5gr.js → cli-ssvdrk4y.js} +1 -1
- package/dist/{cli-jdknh18m.js → cli-svc803vq.js} +69 -816
- package/dist/{cli-7349va39.js → cli-t9ga4qmb.js} +935 -445
- package/dist/{cli-m5akxq8q.js → cli-vs9vdpy0.js} +1 -1
- package/dist/{cli-26ctbcdp.js → cli-vvgaz8t6.js} +93 -44
- package/dist/{cli-3sy2xags.js → cli-vw5x18yj.js} +39 -69
- package/dist/{cli-kchjb7qy.js → cli-w16kwbzw.js} +1 -1
- package/dist/cli-w7dxb2fj.js +921 -0
- package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
- package/dist/{cli-d6521kb5.js → cli-x40a0w9j.js} +1 -1
- package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
- package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
- package/dist/{cli-rcecc3yq.js → cli-ymct0ycy.js} +321 -111
- package/dist/{cli-xzm9vcfg.js → cli-zg3z63x3.js} +2 -2
- package/dist/cli.js +29 -26
- package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-44yq2fkn.js} +9 -9
- package/dist/{codex-hook-30gyhzxe.js → codex-hook-h1zb7cfk.js} +6 -6
- package/dist/{codex-login-bcda78ge.js → codex-login-cdyrr5y1.js} +1 -1
- package/dist/{codex-session-runner-89s304py.js → codex-session-runner-zbh26gbw.js} +10 -10
- package/dist/{commands-jeh1b51j.js → commands-54f02v5b.js} +3 -3
- package/dist/{controller-mctfbrse.js → controller-9gpwcdek.js} +6 -6
- package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-61re6k1n.js} +26 -25
- package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-7e4g81vd.js} +2 -2
- package/dist/{db-b36qn6k3.js → db-dg2gc7fd.js} +17 -13
- package/dist/{db-2dvay0es.js → db-wnh0qjy1.js} +3 -3
- package/dist/{devin-adapter-xedz98zv.js → devin-adapter-zp4tqq53.js} +1 -1
- package/dist/{dispatcher-gndbta01.js → dispatcher-jrm24r43.js} +19 -18
- package/dist/{docker-866qpzt9.js → docker-9aq30pp2.js} +5 -5
- package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-1yqk267c.js} +2 -2
- package/dist/{e2b-3gpc2n3w.js → e2b-3v1e745x.js} +6 -6
- package/dist/{e2b-jbm7mj93.js → e2b-sm28k0k3.js} +6 -6
- package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-r4h9cs9m.js} +1 -1
- package/dist/{embedding-space-4p05vb2x.js → embedding-space-bafjr5f7.js} +6 -6
- package/dist/{embeddings-m6768mgh.js → embeddings-7xmgqe0e.js} +1 -1
- package/dist/{event-bus-e66gh7cc.js → event-bus-xr83x566.js} +1 -1
- package/dist/{execute-b3mrb1mv.js → execute-d6jg5ns0.js} +1 -1
- package/dist/{external-channel-gjv3jne3.js → external-channel-frq1xvq2.js} +2 -2
- package/dist/fx-adapter-0zrkfbkd.js +19 -0
- package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
- package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
- package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
- package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
- package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
- package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
- package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
- package/dist/grok-adapter-3db1c538.js +19 -0
- package/dist/handlers-k22n8mnn.js +33 -0
- package/dist/{heartbeat-a1tv60gt.js → heartbeat-6bpa611t.js} +22 -21
- package/dist/{hook-8h5dzcgq.js → hook-hvm5nf46.js} +5 -5
- package/dist/{hook-cyaps9ba.js → hook-w12k146y.js} +14 -14
- package/dist/{http-t15mhbd9.js → http-43tthdvs.js} +5838 -2600
- package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
- package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
- package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
- package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
- package/dist/index-8xcyd3mc.js +33 -0
- package/dist/index-9sy2bh6n.js +38 -0
- package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
- package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
- package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
- package/dist/{index-w1zqf680.js → index-fn054vsf.js} +1 -1
- package/dist/{index-qav6455f.js → index-ftywhyr0.js} +214 -152
- package/dist/{index-tvfafeyy.js → index-mhq4sh5w.js} +1 -1
- package/dist/index-tx9mc2ap.js +570 -0
- package/dist/index-wjd56k1v.js +34 -0
- package/dist/{keepalive-91s7hzrb.js → keepalive-rk0j0jvh.js} +4 -4
- package/dist/lead-atxf3q6e.js +72 -0
- package/dist/{maintenance-7pjmy5xy.js → maintenance-g6z6kaxw.js} +1 -1
- package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
- package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
- package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
- package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
- package/dist/{onboard-74st7pag.js → onboard-6fdbvh3v.js} +8 -8
- package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
- package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
- package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-fdbsvts7.js} +7 -7
- package/dist/{otel-impl-rnzey8cb.js → otel-impl-rvwtc09q.js} +110 -110
- package/dist/pending-sqkrb836.js +80 -0
- package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-asqayqcg.js} +13 -13
- package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-f5tkgmw2.js} +2 -2
- package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-06s555fa.js} +3 -3
- package/dist/{rbac-roles-59dxachk.js → rbac-roles-szxsg8t1.js} +10 -3
- package/dist/{render-v2-14kpzx12.js → render-v2-103p266q.js} +4 -4
- package/dist/{resume-gsa5fb5f.js → resume-v7kjewt9.js} +8 -7
- package/dist/{runtime-1hv06jsn.js → runtime-f1gmk0b7.js} +1 -1
- package/dist/{session-access-skm7bnp6.js → session-access-6shev8ts.js} +4 -4
- package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-bd7spzjd.js} +3 -3
- package/dist/{setup-5yermsem.js → setup-kmxmztdb.js} +1 -1
- package/dist/thread-buffer-4yz236d0.js +36 -0
- package/dist/{virtual-modules-gazyapte.js → virtual-modules-57eje5wy.js} +5 -5
- package/dist/{work-objects-xj0ck0w4.js → work-objects-zr47ygmf.js} +23 -21
- package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-grrr3fda.js} +19 -18
- package/dist/worker-p4hbtcy3.js +72 -0
- package/dist/{x-2fyrt5pp.js → x-wg164ss9.js} +2 -2
- package/openapi.json +4518 -2356
- package/package.json +11 -8
- package/plugin/commands/create-pr.md +1 -1
- package/plugin/pi-skills/create-pr/SKILL.md +1 -1
- package/src/apps/action-runner.ts +21 -1
- package/src/apps/catalog.generated.json +626 -17
- package/src/apps/page-validator.ts +314 -8
- package/src/assets/key.ts +6 -0
- package/src/be/agent-fs-user-keys.ts +186 -0
- package/src/be/audit-user.ts +27 -13
- package/src/be/automation-preflight.test.ts +14 -14
- package/src/be/automation-preflight.ts +24 -16
- package/src/be/boot-scrub-sweep.ts +143 -14
- package/src/be/caller-session-group.ts +86 -0
- package/src/be/checklist.ts +375 -0
- package/src/be/db/agents.ts +12 -1
- package/src/be/db/approvals.ts +26 -0
- package/src/be/db/session-moves.ts +23 -0
- package/src/be/db/session-tree.ts +78 -19
- package/src/be/db/tasks/eligibility-scan.ts +14 -0
- package/src/be/db/tasks/read.ts +33 -0
- package/src/be/db/tasks/slack-fold.ts +116 -0
- package/src/be/db/tasks/write.ts +34 -0
- package/src/be/db-queries/mcp-servers.ts +13 -0
- package/src/be/db-queries/oauth.ts +6 -0
- package/src/be/db-queries/task-artifacts.ts +10 -8
- package/src/be/db.ts +74 -22
- package/src/be/extensions/assets.ts +17 -13
- package/src/be/import/config.ts +54 -0
- package/src/be/import/dir-source.ts +372 -0
- package/src/be/import/index.ts +149 -0
- package/src/be/import/pending.ts +71 -0
- package/src/be/import/schema.ts +137 -0
- package/src/be/import/seeders.ts +462 -0
- package/src/be/migrations/289_automation_savings_daily.sql +47 -0
- package/src/be/migrations/291_task_slack_participants.sql +4 -0
- package/src/be/migrations/293_savings_component_links.sql +58 -0
- package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
- package/src/be/migrations/297_import_ownership.sql +34 -0
- package/src/be/migrations/301_favorites_key_type.sql +36 -0
- package/src/be/migrations/302_checklist_items.sql +23 -0
- package/src/be/model-profile-check.ts +10 -2
- package/src/be/multi-runtime.ts +8 -1
- package/src/be/rbac-roles.ts +8 -1
- package/src/be/runtime-pools/demand.ts +20 -2
- package/src/be/runtime-pools/reachability.ts +31 -0
- package/src/be/runtime-pools/routing.ts +8 -1
- package/src/be/runtime-pools/supervisor.ts +6 -7
- package/src/be/savings/compute.ts +511 -16
- package/src/be/savings/model.ts +282 -14
- package/src/be/savings/read.ts +1502 -0
- package/src/be/savings/rollup.ts +571 -0
- package/src/be/script-credential-broker.ts +2 -2
- package/src/be/scripts/run-credential.ts +15 -3
- package/src/be/scripts/typecheck.ts +90 -8
- package/src/be/seed/agent-fs-provision.ts +104 -19
- package/src/be/seed/index.ts +1 -1
- package/src/be/seed/registry.ts +27 -8
- package/src/be/seed/runner.ts +1 -1
- package/src/be/seed/schedules-seeder.ts +24 -6
- package/src/be/seed/seed-toggle.ts +32 -0
- package/src/be/seed/types.ts +6 -0
- package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
- package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
- package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
- package/src/be/steering.ts +27 -4
- package/src/be/swarm-config-guard.ts +38 -0
- package/src/be/task-citations.ts +8 -5
- package/src/be/users.ts +29 -2
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/commands/runner.ts +219 -42
- package/src/e2b/env.ts +2 -0
- package/src/extensions/catalog.generated.json +17 -0
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/github/app.ts +10 -1
- package/src/github/handlers.ts +6 -3
- package/src/github/reactions.ts +12 -14
- package/src/heartbeat/heartbeat.ts +14 -4
- package/src/http/agents.ts +19 -10
- package/src/http/all-routes.ts +2 -0
- package/src/http/approval-requests.ts +24 -4
- package/src/http/apps.ts +69 -5
- package/src/http/checklist.ts +176 -0
- package/src/http/db-query-bounded.ts +256 -11
- package/src/http/db-query-shared.ts +9 -0
- package/src/http/favorites.ts +14 -2
- package/src/http/fs.ts +346 -1
- package/src/http/index.ts +37 -2
- package/src/http/kv.ts +13 -0
- package/src/http/mcp-oauth.ts +1 -1
- package/src/http/mcp-servers.ts +15 -2
- package/src/http/onboarding.ts +2 -9
- package/src/http/poll.ts +59 -1
- package/src/http/requested-by.ts +97 -1
- package/src/http/savings.ts +676 -190
- package/src/http/script-connections.ts +1 -0
- package/src/http/scripts.ts +26 -15
- package/src/http/sessions.ts +17 -0
- package/src/http/slack-events.ts +101 -0
- package/src/http/status.ts +25 -7
- package/src/http/task-requester.ts +46 -0
- package/src/http/tasks.ts +107 -42
- package/src/http/users.ts +14 -0
- package/src/http/webhooks.ts +15 -0
- package/src/integrations/cards/index.ts +151 -0
- package/src/integrations/chat-sdk/outbound.ts +39 -13
- package/src/integrations/chat-sdk/runtime.ts +7 -1
- package/src/integrations/chat-sdk/status.ts +17 -0
- package/src/integrations/chat-sdk/telegram-api.ts +6 -1
- package/src/kv-reserved-namespaces.ts +17 -2
- package/src/oauth/presets.ts +29 -2
- package/src/prompts/base-prompt.ts +17 -4
- package/src/prompts/session-templates.ts +163 -9
- package/src/providers/acp-targets.ts +2 -2
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/claude-adapter.ts +0 -20
- package/src/providers/claude-flag-settings.ts +12 -10
- package/src/providers/claude-managed-adapter.ts +5 -1
- package/src/providers/codex-adapter.ts +10 -35
- package/src/providers/codex-app-server.ts +2 -11
- package/src/providers/opencode-adapter.ts +41 -31
- package/src/providers/runtime-dependencies.ts +158 -0
- package/src/rbac/legacy-policy.ts +2 -0
- package/src/rbac/permissions.ts +10 -1
- package/src/scheduler/scheduler.ts +20 -14
- package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
- package/src/scripts-runtime/credential-broker/index.ts +1 -1
- package/src/scripts-runtime/ctx.ts +1 -1
- package/src/scripts-runtime/egress-secrets.ts +2 -2
- package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
- package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
- package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
- package/src/scripts-runtime/stdlib/fetch.ts +113 -15
- package/src/scripts-runtime/stdlib/index.ts +3 -1
- package/src/scripts-runtime/stdlib/retry.ts +174 -0
- package/src/scripts-runtime/swarm-sdk.ts +187 -17
- package/src/scripts-runtime/types/stdlib.d.ts +97 -8
- package/src/scripts-runtime/types/swarm-extension.d.ts +27 -1
- package/src/scripts-runtime/types/swarm-sdk.d.ts +71 -6
- package/src/server.ts +4 -4
- package/src/slack/actions.ts +1 -0
- package/src/slack/app.ts +87 -46
- package/src/slack/assistant.ts +35 -7
- package/src/slack/enrich.ts +144 -50
- package/src/slack/handlers.ts +43 -99
- package/src/slack/http-receiver.ts +284 -0
- package/src/slack/inbound-dispatch.ts +43 -7
- package/src/slack/inbound-files.ts +33 -14
- package/src/slack/message-text.ts +47 -4
- package/src/slack/render-v2.ts +2 -1
- package/src/slack/socket-ack.ts +17 -10
- package/src/slack/steering.ts +5 -0
- package/src/slack/templates.ts +9 -0
- package/src/slack/thread-buffer-store.ts +58 -0
- package/src/slack/thread-buffer.ts +367 -109
- package/src/slack/thread-participants.ts +187 -0
- package/src/tasks/context-key.ts +24 -0
- package/src/tasks/sibling-awareness.ts +13 -1
- package/src/tests/agent-fs-live-url.test.ts +15 -0
- package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
- package/src/tests/agent-fs-user-keys.test.ts +483 -0
- package/src/tests/agentfs-proxy.test.ts +8 -8
- package/src/tests/approval-card-resolution.test.ts +396 -0
- package/src/tests/approval-requests-notifications.test.ts +1 -1
- package/src/tests/approval-respond-auth.test.ts +28 -0
- package/src/tests/apps-action-parent-task.test.ts +140 -0
- package/src/tests/apps-catalog-additions.test.ts +315 -0
- package/src/tests/apps-catalog-files.test.ts +114 -0
- package/src/tests/apps-catalog-hitl.test.ts +117 -0
- package/src/tests/apps-catalog-inputs.test.ts +86 -0
- package/src/tests/apps-catalog-table.test.ts +47 -0
- package/src/tests/apps-chart-shell.test.ts +1 -1
- package/src/tests/apps-element-assembly.test.ts +52 -3
- package/src/tests/apps-session-thread.test.ts +182 -0
- package/src/tests/asset-key-invariants.test.ts +14 -0
- package/src/tests/base-prompt.test.ts +108 -23
- package/src/tests/boot-scrub-sweep.test.ts +172 -0
- package/src/tests/caller-session-group.test.ts +199 -0
- package/src/tests/cards.test.ts +169 -0
- package/src/tests/chat-sdk-status-route.test.ts +16 -3
- package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
- package/src/tests/chat-sdk-tools.test.ts +147 -0
- package/src/tests/checklist-nudge.test.ts +208 -0
- package/src/tests/checklist.test.ts +686 -0
- package/src/tests/claude-adapter-binary.test.ts +7 -1
- package/src/tests/claude-adapter.test.ts +10 -64
- package/src/tests/claude-flag-settings.test.ts +15 -11
- package/src/tests/claude-hook-credentials.test.ts +0 -1
- package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
- package/src/tests/codex-adapter.test.ts +17 -78
- package/src/tests/codex-app-server.test.ts +16 -0
- package/src/tests/comb-config-guard.test.ts +21 -0
- package/src/tests/comb-default.test.ts +59 -97
- package/src/tests/comb-links.test.ts +86 -16
- package/src/tests/comb-status.test.ts +24 -27
- package/src/tests/create-page-tool.test.ts +101 -1
- package/src/tests/create-schedule-key.test.ts +105 -0
- package/src/tests/create-task-vcs-repo.test.ts +136 -0
- package/src/tests/credential-broker.test.ts +2 -2
- package/src/tests/db-query.test.ts +87 -1
- package/src/tests/db-task-read-contract.test.ts +3 -0
- package/src/tests/db-task-write-contract.test.ts +3 -1
- package/src/tests/docs-index-footprint.test.js +3 -3
- package/src/tests/dreaming-learnings.test.ts +104 -0
- package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
- package/src/tests/extensions-assets.test.ts +7 -3
- package/src/tests/extensions-catalog.test.ts +1 -0
- package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
- package/src/tests/extensions-pre-task.test.ts +7 -5
- package/src/tests/extensions-steering.test.ts +14 -2
- package/src/tests/favorites-agent-fs-path.test.ts +124 -0
- package/src/tests/fetch-resolved-env.test.ts +115 -1
- package/src/tests/fixtures/import-package.ts +32 -0
- package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
- package/src/tests/fs-routes.test.ts +505 -2
- package/src/tests/github-ghes-mock.test.ts +196 -0
- package/src/tests/github-host.test.ts +285 -0
- package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
- package/src/tests/heartbeat.test.ts +56 -0
- package/src/tests/import-config.test.ts +209 -0
- package/src/tests/import.test.ts +464 -0
- package/src/tests/invites-http.test.ts +144 -1
- package/src/tests/kv-http.test.ts +11 -0
- package/src/tests/literal-matcher.test.ts +58 -0
- package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
- package/src/tests/oauth-presets.test.ts +12 -0
- package/src/tests/opencode-adapter.test.ts +53 -6
- package/src/tests/pool-affinity.test.ts +50 -0
- package/src/tests/prompt-template-session.test.ts +69 -6
- package/src/tests/provider-registration.test.ts +2 -55
- package/src/tests/provider-runtime-dependencies.test.ts +212 -0
- package/src/tests/rbac-admission.test.ts +19 -0
- package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
- package/src/tests/rbac-engine.test.ts +2 -0
- package/src/tests/rbac-roles.test.ts +2 -0
- package/src/tests/runner-missing-dependency.test.ts +61 -0
- package/src/tests/runner-requester-profile.test.ts +139 -1
- package/src/tests/runtime-pool-reachability.test.ts +135 -1
- package/src/tests/runtime-pool-routing.test.ts +52 -0
- package/src/tests/runtime-stale-threshold.test.ts +40 -0
- package/src/tests/savings-compound.test.ts +774 -0
- package/src/tests/savings-compute.test.ts +7 -198
- package/src/tests/savings-fleet-latency.test.ts +143 -0
- package/src/tests/savings-fleet-read.test.ts +195 -0
- package/src/tests/savings-fleet-scale.test.ts +222 -0
- package/src/tests/savings-fleet-slices.test.ts +122 -0
- package/src/tests/savings-model.test.ts +212 -0
- package/src/tests/savings-read.test.ts +408 -0
- package/src/tests/savings-rollup.test.ts +766 -0
- package/src/tests/savings-scripts.test.ts +617 -0
- package/src/tests/script-connections.test.ts +4 -0
- package/src/tests/script-executor-conformance.test.ts +481 -0
- package/src/tests/scripts-http.test.ts +55 -0
- package/src/tests/scripts-runtime-fetch.test.ts +2 -2
- package/src/tests/secret-rules.test.ts +124 -1
- package/src/tests/secret-scrub-gate.test.ts +257 -0
- package/src/tests/secret-scrubber.test.ts +1 -1
- package/src/tests/seed-registry.test.ts +142 -9
- package/src/tests/session-source-keys.test.ts +42 -1
- package/src/tests/sessions-move.test.ts +70 -0
- package/src/tests/sessions-tree.test.ts +98 -0
- package/src/tests/sessions.test.ts +69 -0
- package/src/tests/slack-config.test.ts +4 -18
- package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
- package/src/tests/slack-http-receiver.test.ts +472 -0
- package/src/tests/slack-identity-resolution.test.ts +23 -0
- package/src/tests/slack-inbound-files.test.ts +2 -1
- package/src/tests/slack-inbound-logging.test.ts +64 -0
- package/src/tests/slack-leave-thread.test.ts +1 -1
- package/src/tests/slack-message-text.test.ts +104 -0
- package/src/tests/slack-mode-lifecycle.test.ts +6 -4
- package/src/tests/slack-render-v2.test.ts +48 -0
- package/src/tests/slack-skip-reaction.test.ts +2 -2
- package/src/tests/slack-steering.test.ts +22 -10
- package/src/tests/slack-thread-buffer-context.test.ts +1 -1
- package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
- package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
- package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
- package/src/tests/slack-thread-buffer.test.ts +34 -34
- package/src/tests/slack-thread-participants.test.ts +447 -0
- package/src/tests/slack-tool-blocks.test.ts +167 -0
- package/src/tests/status.test.ts +32 -6
- package/src/tests/steering-core.test.ts +13 -0
- package/src/tests/steering-enabled.test.ts +7 -1
- package/src/tests/steering-promotion.test.ts +24 -0
- package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
- package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
- package/src/tests/task-artifacts.test.ts +50 -0
- package/src/tests/task-session-prompts.test.ts +95 -1
- package/src/tests/tool-annotations.test.ts +30 -0
- package/src/tests/workflow-system-one-extraction.test.ts +149 -1
- package/src/tools/chat-post.ts +19 -4
- package/src/tools/chat-reply.ts +20 -4
- package/src/tools/create-page.ts +21 -4
- package/src/tools/get-swarm.ts +18 -2
- package/src/tools/join-swarm.ts +2 -1
- package/src/tools/kv/kv-write-auth.ts +17 -1
- package/src/tools/schedules/create-schedule.ts +22 -4
- package/src/tools/slack-post.ts +40 -7
- package/src/tools/slack-reply.ts +50 -14
- package/src/types.ts +74 -2
- package/src/utils/constants.ts +60 -138
- package/src/utils/github-host.ts +217 -0
- package/src/utils/github-pull-request.ts +8 -5
- package/src/utils/literal-matcher.ts +118 -0
- package/src/utils/mcp-server-fetcher.test.ts +89 -0
- package/src/utils/mcp-server-fetcher.ts +13 -5
- package/src/utils/request-auth-context.ts +24 -0
- package/src/utils/secret-rules.generated.ts +1 -1
- package/src/utils/secret-scrubber.ts +485 -54
- package/src/utils/task-attachment-links.ts +9 -12
- package/src/vcs/index.ts +3 -0
- package/src/workflows/approval-notifications.ts +188 -12
- package/src/workflows/executors/swarm-script.ts +23 -19
- package/src/workflows/executors/system-one-extraction.ts +14 -7
- package/src/workflows/executors/system-one-providers.ts +22 -1
- package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
- package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
- package/templates/extensions/README.md +1 -0
- package/templates/extensions/sql-admin-only/README.md +19 -0
- package/templates/extensions/sql-admin-only/hooks.ts +96 -0
- package/templates/extensions/sql-admin-only/manifest.json +8 -0
- package/templates/import/manifest.schema.json +136 -0
- package/templates/import/sources.schema.json +44 -0
- package/templates/skills/agent-browser/SKILL.md +1 -1
- package/templates/skills/agent-browser/content.md +1 -1
- package/templates/skills/apps/SKILL.md +122 -12
- package/templates/skills/apps/content.md +122 -12
- package/templates/skills/asset-namespaces/content.md +2 -1
- package/templates/skills/chat-sdk/content.md +17 -0
- package/templates/skills/db-query-guidance/content.md +2 -1
- package/templates/skills/scheduling/content.md +27 -0
- package/templates/skills/slack-interaction/content.md +12 -2
- package/templates/skills/swarm-docs/content.md +1 -0
- package/templates/skills/swarm-extensions/config.json +1 -1
- package/templates/skills/swarm-extensions/content.md +33 -23
- package/templates/skills/swarm-scripts/SKILL.md +18 -4
- package/templates/skills/swarm-scripts/content.md +18 -4
- package/templates/skills/work-on-task/SKILL.md +1 -1
- package/templates/skills/work-on-task/content.md +1 -1
- package/templates/skills/workflow-iterate/content.md +4 -7
- package/templates/workflows/dreaming/content.md +3 -3
- package/dist/acp-adapter-fqzkxyra.js +0 -15
- package/dist/claude-adapter-stw7jdcf.js +0 -25
- package/dist/cli-4bd1rck6.js +0 -4
- package/dist/cli-dns0y538.js +0 -194
- package/dist/cli-g5mtmf6t.js +0 -432
- package/dist/cli-xf3qw745.js +0 -104
- package/dist/fx-adapter-rpsgb1tw.js +0 -18
- package/dist/grok-adapter-n2m3zjg1.js +0 -18
- package/dist/handlers-nv8edn19.js +0 -32
- package/dist/index-ksmyd6kc.js +0 -37
- package/dist/index-rjnrje98.js +0 -32
- package/dist/index-tv3413wy.js +0 -33
- package/dist/lead-3hmddvrm.js +0 -70
- package/dist/worker-qgg0m2gw.js +0 -70
- package/src/providers/ctx-mode-env.ts +0 -10
- package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
- package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
- package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
- package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
- package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
- package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
package/src/e2b/env.ts
CHANGED
|
@@ -118,6 +118,23 @@
|
|
|
118
118
|
},
|
|
119
119
|
"readme": "# slack-reply-gate\n\nLead is woken by every human message in a Slack thread the swarm takes part in, including \"lol\", an emoji, or two people chatting with each other. This extension asks a SystemOne decision model, Jev ([TypeSafe](https://typesafe.ai)) or Clef (Cloudflare Workers AI), whether Lead should answer a new thread message, and drops the wake-up when it should not.\n\nInstall config:\n\n```json\n{ \"mode\": \"shadow\" }\n```\n\nStart in `shadow`, read the decisions in KV for a few days, then switch to `enforce`.\n\n## Modes\n\n| `mode` | Effect |\n|---|---|\n| `off` | Never evaluates. |\n| `shadow` (default) | Asks the model and records the verdict. Never blocks. |\n| `enforce` | Asks the model, records the verdict, and blocks the Lead task when the answer is no. The message gets :mute: instead: no Lead task, no reply, no outcome card. |\n\n## What it gates\n\nHook: `pre.task.create`, for tasks with origin `slack` whose description carries the thread buffer's header `[Thread follow-up — N message(s) buffered]`. Those are the non-mention thread replies that `src/slack/thread-buffer.ts` batches into a Lead task. A direct @mention of the bot creates a task without that header and is never gated.\n\nThe header counts only at the start of the description or right after the closing `</thread_context>`. Thread context quotes old messages verbatim, and an older Lead reply can quote the header itself, so a header inside the context is ignored. Only the text after the real header is treated as new.\n\n## Decision\n\n1. A follow-up with downloaded files (status `draft`) passes without a decision call.\n2. **@mention pass-through.** A new message that @mentions Lead passes without a decision call. A mention is the bot mention the engine rewrites to `<@U…> (that's you)`, a resolved `<@U…|lead>`, or a literal `@lead` (any name in `leadAliases`). Only the new messages are scanned, never the thread context, so an old mention earlier in the thread does not pass later banter.\n3. Otherwise one decision call (one `choice` question, see [Provider](#provider)) with the new message(s), the sender kind, and the last `contextMessages` thread messages. Labels: `direct_ask`, `followup_to_lead`, `instruction_to_lead`, `reaction_only`, `banter_between_others`, `not_addressed_to_lead`, `other`.\n4. The answer is no only when the top label is `reaction_only`, `banter_between_others`, or `not_addressed_to_lead`, and the summed probability of those three labels is at least `minConfidence`. A split between two skip labels is still a skip. A skip label below the threshold replies. With no probabilities, the top label's confidence stands in for the sum. With neither probabilities nor a confidence, the threshold is not applied and a skip label skips (in `enforce`, the message is dropped).\n\nSeveral buffered messages are judged together. One mention in any of them passes the batch.\n\n## Provider\n\nThe decision is made on the API server by the `system-one-decide` tool (`ctx.swarm.systemOne_decide`), the same path a `system-one-decision` workflow node takes. The server reads the provider's credential, sends the request, and validates the answer, so every SystemOne host works and no key enters the hook.\n\n| `provider` | Model | Credential |\n|---|---|---|\n| `typesafe` | Jev, `model` (default `jev-latest`) | `TYPESAFE_API_KEY` |\n| `openrouter` | Jev, `openrouterModel` (default `typesafe/jev-1.13`) | `OPENROUTER_API_KEY` |\n| `cloudflare` | Clef, `cloudflareModel` (default `clef`, or `clef-flash`) | `CLOUDFLARE_API_TOKEN` (or `CLOUDFLARE_API_KEY`) and `CLOUDFLARE_ACCOUNT_ID` |\n| `laya`, `openai` | The host's default model | See the workflows guide |\n| `auto` (default) | The first of typesafe, openrouter, cloudflare whose credential is set. A provider the server refuses for a deployment setting (openrouter when `OPENROUTER_BASE_URL` points at a gateway) is skipped for the next one | |\n\nWith no credential for `auto`, every message fails open and the KV row names the secrets. Each decision row records the `provider` that answered. `minConfidence` was tuned on Jev; check Clef's verdicts in `shadow` before you enforce on it.\n\n## Fail open\n\nEvery error lets the task through: a missing key, a provider error relayed by the server, a network error, a timeout, a malformed answer, or an unknown label. The handler never throws, so an outage cannot auto-disable the extension. Each failure is recorded as `fail-open` in KV and logged as a warning.\n\n## :mute: on drop (enforce)\n\nNo swarm tool or extension `ctx` method adds a Slack reaction, so the hook calls the Slack Web API with the bot token. It needs the `reactions:write` scope, which the Slack app already uses for its acceptance reactions.\n\n1. `reactions.remove` for each acceptance reaction the engine may have put on the triggering message: `eyes`, `heavy_plus_sign`, `zap`, `speech_balloon`, or their `SLACK_REACTION_ACCEPTED`, `SLACK_REACTION_BUFFERED`, `SLACK_REACTION_NOW`, and `SLACK_REACTION_STEERED` overrides. Slack only removes the bot's own reaction, so a human's :eyes: stays.\n2. `reactions.add` with `muteReaction` (default `mute`). `already_reacted` counts as success. Skipped when `muteReaction` is `\"\"`.\n\nThe block returns first and the Slack calls run after it. A slow or failing Slack call never delays the drop or turns it back into a task. Set `muteReaction` to `\"\"` for a true no-op: step 1 still clears the bot's acceptance reaction(s), and nothing is added.\n\n## Config\n\n| Key | Default | Notes |\n|---|---|---|\n| `mode` | `shadow` | `off`, `shadow`, or `enforce` |\n| `timeoutMs` | `3000` | Decision call timeout, capped at 4000 (the dispatcher cancels a handler at 5 s) |\n| `provider` | `auto` | `auto`, `typesafe`, `openrouter`, `cloudflare`, `laya`, or `openai`. See [Provider](#provider) |\n| `model` | `jev-latest` | Jev model on TypeSafe |\n| `openrouterModel` | `typesafe/jev-1.13` | Jev model on OpenRouter |\n| `cloudflareModel` | `clef` | Clef model on Cloudflare Workers AI |\n| `minConfidence` | `0.55` | Minimum summed skip probability to skip |\n| `contextMessages` | `6` | Thread messages sent to the model, 0 to 20 |\n| `leadAliases` | `[\"lead\"]` | A literal `@alias` in a new message counts as a mention |\n| `botSlackUserIds` | `[]` | Slack user ids labelled `bot` as the sender for the model |\n| `muteReaction` | `mute` | Reaction for a dropped message; `\"\"` only removes the acceptance reaction(s) |\n| `slackTimeoutMs` | `5000` | Timeout per Slack call |\n\n## Required secrets\n\nSet them as global `swarm_config` values. The server reads the provider credential from the global row when it makes the decision. `auto` and the Slack token read the API process environment, which loads global rows at boot and on config reload.\n\n- One provider credential from the [Provider](#provider) table is required for any evaluation. Without one, every message fails open. The `apiKey` config field of earlier versions is gone: the hook never holds a key, so store it as the global `TYPESAFE_API_KEY` secret.\n- `SLACK_BOT_TOKEN`: the Slack app's bot token. A swarm with Slack connected already has it. Without it, `enforce` still drops the message but cannot touch its reactions, and logs a `mute-error`.\n\nNo key is written to config, KV, logs, or a description.\n\n## KV namespace `ext:slack-reply-gate`\n\n- `d:<epochMs>:<channel>_<threadTs>`: one row per decision, with `action` (`pass`, `shadow-skip`, `skipped`, `fail-open`), `provider`, `reason`, `confidence`, `skipP`, `latencyMs`, `sender`, and a 300-character `preview`.\n- `m:<epochMs>:<channel>_<threadTs>`: one row per mute attempt, with `action` (`muted`, `unreacted` when `muteReaction` is `\"\"`, `mute-error`), `removed`, `added`, and `errors`.\n- `last`: the latest decision. Mute rows never overwrite it.\n- Counters: `total`, `mention`, `files`, `reply`, `shadow-skip`, `skipped`, `error`, `muted`, `unreacted`, `mute-error`, and `reason:<label>`.\n\n## Known limits\n\n- When Lead already has an active task in the thread, the buffer steers that task instead of creating one, so `pre.task.create` does not fire and the gate does not run.\n- A blocked flush makes the thread buffer log a `TaskCreationBlockedError`. Nothing is lost: the next follow-up's `<thread_context>` carries the earlier messages.\n- A flush of several messages mutes only the triggering (last) message. The others keep their acceptance reaction.\n"
|
|
120
120
|
},
|
|
121
|
+
"sql-admin-only": {
|
|
122
|
+
"manifestFile": "manifest.json",
|
|
123
|
+
"manifest": {
|
|
124
|
+
"$schema": "../manifest.schema.json",
|
|
125
|
+
"name": "sql-admin-only",
|
|
126
|
+
"description": "Blocks db-query tool calls on tasks created by a non-admin user",
|
|
127
|
+
"version": "1.0.0",
|
|
128
|
+
"runtime": "api",
|
|
129
|
+
"assets": {
|
|
130
|
+
"hooks": "hooks.ts"
|
|
131
|
+
}
|
|
132
|
+
},
|
|
133
|
+
"files": {
|
|
134
|
+
"hooks.ts": "import { block, type SwarmExtension } from \"swarm-extension\";\nimport { z } from \"zod\";\n\nexport const config = z.object({});\n\n/** MCP tools that run raw SQL. db-query is the only one today. */\nconst SQL_TOOLS = new Set([\"db-query\"]);\n\nconst manifest = {\n name: \"sql-admin-only\",\n description: \"Blocks db-query tool calls on tasks created by a non-admin user\",\n version: \"1.0.0\",\n runtime: \"api\",\n assets: { hooks: \"hooks.ts\" },\n config,\n} as const;\n\n/**\n * The task's creator and that user's `users.role`, the role the swarm shows for a\n * requester (for example \"Alice (admin)\"). RBAC roles do not work here: every user is\n * created with the RBAC `admin` role.\n */\nexport const CREATOR_SQL = `SELECT t.requestedByUserId, u.role\nFROM agent_tasks t\nLEFT JOIN users u ON u.id = t.requestedByUserId\nWHERE t.id = ?`;\n\ntype Envelope = { success?: boolean; data?: { rows?: unknown[] }; rows?: unknown[] } | null;\n\nconst cell = (row: unknown, i: number, key: string): unknown =>\n Array.isArray(row) ? row[i] : (row as Record<string, unknown> | null)?.[key];\n\n/**\n * The dispatcher fails a pre hook OPEN when it runs past\n * EXTENSION_HANDLER_TIMEOUT_MS (default 5s). Give the lookup a shorter budget so\n * a slow lookup ends in our own block, not in a silent allow.\n */\nconst lookupBudgetMs = (): number => {\n const raw = Number(process.env.EXTENSION_HANDLER_TIMEOUT_MS);\n const handlerMs = Number.isFinite(raw) && raw > 0 ? raw : 5_000;\n return Math.floor(handlerMs * 0.6);\n};\n\nconst withDeadline = async <T>(work: Promise<T>, ms: number): Promise<T> => {\n let timer: ReturnType<typeof setTimeout> | undefined;\n try {\n return await Promise.race([\n work,\n new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(new Error(`lookup timed out after ${ms}ms`)), ms);\n }),\n ]);\n } finally {\n if (timer) clearTimeout(timer);\n }\n};\n\nconst extension: SwarmExtension<typeof manifest> = (api) => {\n api.on(\"pre.tool.call\", async (event, ctx) => {\n const tool = event.tool;\n if (!SQL_TOOLS.has(tool)) return;\n\n // No task context means no task creator: allow.\n const taskId = event.requestInfo?.sourceTaskId;\n if (!taskId) return;\n\n // Creator lookup. Any failure blocks this SQL call only (fail closed).\n let creator: string;\n let role: string;\n try {\n const q = (await withDeadline(\n ctx.swarm.db_query({ sql: CREATOR_SQL, params: [taskId] }),\n lookupBudgetMs(),\n )) as Envelope;\n if (q?.success === false) throw new Error(\"db-query lookup returned success=false\");\n const row = (q?.data?.rows ?? q?.rows ?? [])[0];\n if (!row) throw new Error(`task ${taskId} not found`);\n creator = String(cell(row, 0, \"requestedByUserId\") ?? \"\");\n role = String(cell(row, 1, \"role\") ?? \"\");\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n const reason = `${tool} is restricted to admin task creators, and the creator of task ${taskId} could not be verified (${message}).`;\n ctx.log.warn(reason, { tool, taskId });\n return block(reason);\n }\n\n if (!creator) return;\n if (role.trim().toLowerCase() === \"admin\") return;\n\n const reason = `${tool} is restricted to admin task creators. Task ${taskId} was created by user ${creator}, whose role is ${role ? `\"${role}\"` : \"not set\"}.`;\n ctx.log.warn(reason, { tool, taskId, requestedByUserId: creator });\n return block(reason);\n });\n};\n\nexport default extension;\n"
|
|
135
|
+
},
|
|
136
|
+
"readme": "# sql-admin-only\n\nBlocks `db-query` tool calls made on a task whose creator (`requestedByUserId`) is not an admin. Every other tool call passes untouched.\n\n| Task creator | `db-query` |\n|---|---|\n| Not set, or the call has no task | Allowed |\n| Set, holds an admin role | Allowed |\n| Set, no admin role | Blocked |\n| Set, but the lookup fails, times out, or the task row is missing | Blocked |\n\nNo config. \"Admin\" means the creator's `users.role` is `admin` (case-insensitive), the role the swarm shows next to a requester's name. Only Lead (`manage-user`) and REST callers with `user.role.manage` can set it. RBAC roles are not used, because every user is created with the RBAC `admin` role. A creator whose user row is gone counts as non-admin.\n\nThe task comes from the call's `X-Source-Task-Id` header. The lookup gets 60% of `EXTENSION_HANDLER_TIMEOUT_MS` (default 5s), because the dispatcher lets a call through when a hook times out.\n\nCoverage limits:\n\n- Only agent MCP tool calls run `pre.tool.call`. Scripts calling `ctx.swarm.db_query`, extensions, and direct `POST /api/db-query` requests skip the hook.\n- A call without an `X-Source-Task-Id` header has no task, so it is allowed.\n"
|
|
137
|
+
},
|
|
121
138
|
"task-digest": {
|
|
122
139
|
"manifestFile": "manifest.yaml",
|
|
123
140
|
"manifest": {
|
|
@@ -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 | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\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 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 | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\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 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";\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" | "extension" | "script-sdk";\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 }\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 args: unknown;\n requestInfo: RequestInfo;\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 }\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 | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\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 | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\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" | "extension" | "script-sdk";\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 }\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 args: unknown;\n requestInfo: RequestInfo;\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 }\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';
|
package/src/github/app.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { isEnvFlagEnabled } from "../utils/env-flag";
|
|
2
|
+
import { githubApiUrl, resolveGitHubHost } from "../utils/github-host";
|
|
2
3
|
|
|
3
4
|
let initialized = false;
|
|
4
5
|
let webhookSecret: string | null = null;
|
|
@@ -39,6 +40,14 @@ export function initGitHub(): boolean {
|
|
|
39
40
|
return false;
|
|
40
41
|
}
|
|
41
42
|
|
|
43
|
+
const host = resolveGitHubHost();
|
|
44
|
+
if (!host.ok) {
|
|
45
|
+
console.error(`[GitHub] ${host.error}; GitHub integration disabled`);
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
48
|
+
if (host.warning) console.warn(`[GitHub] ${host.warning}`);
|
|
49
|
+
console.log(`[GitHub] Host: web ${host.config.webUrl}, API ${host.config.apiUrl}`);
|
|
50
|
+
|
|
42
51
|
webhookSecret = process.env.GITHUB_WEBHOOK_SECRET ?? null;
|
|
43
52
|
|
|
44
53
|
if (!webhookSecret) {
|
|
@@ -202,7 +211,7 @@ export async function getInstallationToken(installationId: number): Promise<stri
|
|
|
202
211
|
|
|
203
212
|
try {
|
|
204
213
|
const response = await fetch(
|
|
205
|
-
|
|
214
|
+
githubApiUrl(`/app/installations/${installationId}/access_tokens`),
|
|
206
215
|
{
|
|
207
216
|
method: "POST",
|
|
208
217
|
headers: {
|
package/src/github/handlers.ts
CHANGED
|
@@ -5,6 +5,7 @@ import { resolveTemplate } from "../prompts/resolver";
|
|
|
5
5
|
import { githubContextKey } from "../tasks/context-key";
|
|
6
6
|
import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
|
|
7
7
|
import { parseEnvFlag } from "../utils/env-flag";
|
|
8
|
+
import { getGitHubGraphqlUrl, githubApiUrl } from "../utils/github-host";
|
|
8
9
|
import { getInstallationToken } from "./app";
|
|
9
10
|
import {
|
|
10
11
|
detectMention,
|
|
@@ -1056,7 +1057,9 @@ async function fetchReviewScopedComments(
|
|
|
1056
1057
|
reviewId: number,
|
|
1057
1058
|
headers: Record<string, string>,
|
|
1058
1059
|
): Promise<FetchReviewCommentsResult> {
|
|
1059
|
-
const url =
|
|
1060
|
+
const url = githubApiUrl(
|
|
1061
|
+
`/repos/${repo}/pulls/${prNumber}/reviews/${reviewId}/comments?per_page=100`,
|
|
1062
|
+
);
|
|
1060
1063
|
|
|
1061
1064
|
let result = await fetchPaginatedReviewComments(url, headers);
|
|
1062
1065
|
if (result.degraded || result.comments.length > 0) {
|
|
@@ -1080,7 +1083,7 @@ async function fetchPrLevelReviewComments(
|
|
|
1080
1083
|
reviewId: number,
|
|
1081
1084
|
headers: Record<string, string>,
|
|
1082
1085
|
): Promise<FetchReviewCommentsResult> {
|
|
1083
|
-
const url =
|
|
1086
|
+
const url = githubApiUrl(`/repos/${repo}/pulls/${prNumber}/comments?per_page=100`);
|
|
1084
1087
|
const result = await fetchPaginatedReviewComments(url, headers);
|
|
1085
1088
|
return {
|
|
1086
1089
|
comments: result.comments.filter((comment) => comment.pull_request_review_id === reviewId),
|
|
@@ -1208,7 +1211,7 @@ async function fetchPrReviewActionCounts(
|
|
|
1208
1211
|
if (!token || !owner || !name) return null;
|
|
1209
1212
|
|
|
1210
1213
|
try {
|
|
1211
|
-
const response = await fetch(
|
|
1214
|
+
const response = await fetch(getGitHubGraphqlUrl(), {
|
|
1212
1215
|
method: "POST",
|
|
1213
1216
|
headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
|
|
1214
1217
|
body: JSON.stringify({
|
package/src/github/reactions.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { getGitHubGraphqlUrl, githubApiUrl } from "../utils/github-host";
|
|
1
2
|
import { scrubSecrets } from "../utils/secret-scrubber";
|
|
2
3
|
import { getInstallationToken, isReactionsEnabled } from "./app";
|
|
3
4
|
|
|
@@ -54,7 +55,7 @@ async function postRestReaction(
|
|
|
54
55
|
if (!token) return false;
|
|
55
56
|
|
|
56
57
|
try {
|
|
57
|
-
const response = await fetch(
|
|
58
|
+
const response = await fetch(githubApiUrl(`/repos/${repo}/${target}/reactions`), {
|
|
58
59
|
method: "POST",
|
|
59
60
|
headers: {
|
|
60
61
|
Accept: "application/vnd.github+json",
|
|
@@ -157,7 +158,7 @@ export async function addGraphQLReaction(
|
|
|
157
158
|
if (!token) return false;
|
|
158
159
|
|
|
159
160
|
try {
|
|
160
|
-
const response = await fetch(
|
|
161
|
+
const response = await fetch(getGitHubGraphqlUrl(), {
|
|
161
162
|
method: "POST",
|
|
162
163
|
headers: {
|
|
163
164
|
Authorization: `Bearer ${token}`,
|
|
@@ -224,19 +225,16 @@ export async function postComment(
|
|
|
224
225
|
}
|
|
225
226
|
|
|
226
227
|
try {
|
|
227
|
-
const response = await fetch(
|
|
228
|
-
|
|
229
|
-
{
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
"X-GitHub-Api-Version": "2022-11-28",
|
|
235
|
-
"Content-Type": "application/json",
|
|
236
|
-
},
|
|
237
|
-
body: JSON.stringify({ body }),
|
|
228
|
+
const response = await fetch(githubApiUrl(`/repos/${repo}/issues/${issueNumber}/comments`), {
|
|
229
|
+
method: "POST",
|
|
230
|
+
headers: {
|
|
231
|
+
Accept: "application/vnd.github+json",
|
|
232
|
+
Authorization: `Bearer ${token}`,
|
|
233
|
+
"X-GitHub-Api-Version": "2022-11-28",
|
|
234
|
+
"Content-Type": "application/json",
|
|
238
235
|
},
|
|
239
|
-
|
|
236
|
+
body: JSON.stringify({ body }),
|
|
237
|
+
});
|
|
240
238
|
|
|
241
239
|
if (!response.ok) {
|
|
242
240
|
const errorText = await response.text();
|
|
@@ -138,9 +138,14 @@ function defaultIntervalMs(): number {
|
|
|
138
138
|
return parseHeartbeatIntervalMs(process.env.HEARTBEAT_INTERVAL_MS);
|
|
139
139
|
}
|
|
140
140
|
|
|
141
|
-
/**
|
|
141
|
+
/**
|
|
142
|
+
* Stall threshold: tasks with fresh worker heartbeat but no task update for
|
|
143
|
+
* this many minutes. A positive integer, or 30: `Number(value) || 30` kept a
|
|
144
|
+
* negative threshold, which flagged every recently updated task (#2835).
|
|
145
|
+
*/
|
|
142
146
|
function stallThresholdMinutes(): number {
|
|
143
|
-
|
|
147
|
+
const value = Number(process.env.HEARTBEAT_STALL_THRESHOLD_MIN);
|
|
148
|
+
return Number.isInteger(value) && value > 0 ? value : 30;
|
|
144
149
|
}
|
|
145
150
|
|
|
146
151
|
/** Stall threshold: tasks with no active session (worker clearly dead) */
|
|
@@ -169,9 +174,14 @@ const STALE_CLEANUP_THRESHOLD_MINUTES = Number(process.env.HEARTBEAT_STALE_CLEAN
|
|
|
169
174
|
*/
|
|
170
175
|
const DRAFT_TASK_TIMEOUT_MINUTES = Number(process.env.HEARTBEAT_DRAFT_TASK_TIMEOUT_MIN) || 5;
|
|
171
176
|
|
|
172
|
-
/**
|
|
177
|
+
/**
|
|
178
|
+
* Max crash-recovery resume generations before failing for lead triage: a
|
|
179
|
+
* positive integer, or 3. `Number(value) || 3` kept a negative limit, which
|
|
180
|
+
* exhausted the budget before the first resume (#2834).
|
|
181
|
+
*/
|
|
173
182
|
export function maxResumeGenerations(): number {
|
|
174
|
-
|
|
183
|
+
const value = Number(process.env.HEARTBEAT_MAX_RESUME_GENERATIONS);
|
|
184
|
+
return Number.isInteger(value) && value > 0 ? value : 3;
|
|
175
185
|
}
|
|
176
186
|
|
|
177
187
|
export const RESUME_BUDGET_EXHAUSTED_REASON = "resume_budget_exhausted";
|
package/src/http/agents.ts
CHANGED
|
@@ -51,6 +51,7 @@ import {
|
|
|
51
51
|
upsertRuntimeInstance,
|
|
52
52
|
} from "../be/multi-runtime";
|
|
53
53
|
import { getPoolForAgent, resolvePoolDelivery } from "../be/runtime-pools/db";
|
|
54
|
+
import { isAgentOnDemand } from "../be/runtime-pools/reachability";
|
|
54
55
|
import { ACP_TARGET_IDS } from "../providers/acp-target-catalog";
|
|
55
56
|
import { reasoningCapability } from "../providers/reasoning-effort";
|
|
56
57
|
import { ALL_CAPABILITIES, getEnabledCapabilities } from "../server";
|
|
@@ -382,8 +383,22 @@ async function resolveListClaudeTransports(
|
|
|
382
383
|
/** List/detail rows carry the effective Claude transport so the dashboard can flag SDK agents. */
|
|
383
384
|
const AgentListItemSchema = AgentWithCapacityAndTasksSchema.extend({
|
|
384
385
|
claudeTransport: ClaudeTransportSchema.optional(),
|
|
386
|
+
/** Offline, but its runtime pool starts a runtime when a task is sent (`isAgentOnDemand`). */
|
|
387
|
+
onDemand: z.boolean().optional(),
|
|
385
388
|
});
|
|
386
389
|
|
|
390
|
+
/** The list/detail extras: effective Claude transport and the on-demand flag, when set. */
|
|
391
|
+
async function withListExtras<T extends Agent>(
|
|
392
|
+
agent: T,
|
|
393
|
+
claudeTransport: ClaudeTransport | undefined,
|
|
394
|
+
): Promise<T & { claudeTransport?: ClaudeTransport; onDemand?: true }> {
|
|
395
|
+
return {
|
|
396
|
+
...agent,
|
|
397
|
+
...(claudeTransport ? { claudeTransport } : {}),
|
|
398
|
+
...((await isAgentOnDemand(agent)) ? { onDemand: true as const } : {}),
|
|
399
|
+
};
|
|
400
|
+
}
|
|
401
|
+
|
|
387
402
|
/**
|
|
388
403
|
* The agents whose name, role or id contains `q` (case-insensitive), at most
|
|
389
404
|
* `limit` of them. A swarm has tens of agents, so filtering loaded rows is cheap.
|
|
@@ -919,10 +934,9 @@ export async function handleAgentsRest(
|
|
|
919
934
|
resolveListClaudeTransports(agents),
|
|
920
935
|
]);
|
|
921
936
|
listAgents.respond(res, 200, {
|
|
922
|
-
agents:
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
}),
|
|
937
|
+
agents: await Promise.all(
|
|
938
|
+
agentsWithCapacity.map((agent) => withListExtras(agent, transports.get(agent.id))),
|
|
939
|
+
),
|
|
926
940
|
});
|
|
927
941
|
return true;
|
|
928
942
|
}
|
|
@@ -1649,12 +1663,7 @@ export async function handleAgentsRest(
|
|
|
1649
1663
|
agentWithCapacity(agent),
|
|
1650
1664
|
resolveListClaudeTransports([agent]),
|
|
1651
1665
|
]);
|
|
1652
|
-
|
|
1653
|
-
getAgent.respond(
|
|
1654
|
-
res,
|
|
1655
|
-
200,
|
|
1656
|
-
claudeTransport ? { ...agentWithCap, claudeTransport } : agentWithCap,
|
|
1657
|
-
);
|
|
1666
|
+
getAgent.respond(res, 200, await withListExtras(agentWithCap, transports.get(agent.id)));
|
|
1658
1667
|
return true;
|
|
1659
1668
|
}
|
|
1660
1669
|
|
package/src/http/all-routes.ts
CHANGED
|
@@ -28,6 +28,7 @@ import "./api-keys";
|
|
|
28
28
|
import "./events";
|
|
29
29
|
import "./extensions";
|
|
30
30
|
import "./favorites";
|
|
31
|
+
import "./checklist";
|
|
31
32
|
import "./fs";
|
|
32
33
|
import "./heartbeat";
|
|
33
34
|
import "./inbox-state";
|
|
@@ -60,6 +61,7 @@ import "./savings";
|
|
|
60
61
|
import "./savings-calibration";
|
|
61
62
|
import "./sessions";
|
|
62
63
|
import "./skills";
|
|
64
|
+
import "./slack-events";
|
|
63
65
|
import "./slack-inbound";
|
|
64
66
|
import "./scripts";
|
|
65
67
|
import "./mcp-bridge";
|
|
@@ -180,7 +180,15 @@ const ApprovalRequestSummarySchema = ApprovalRequestSchema.omit({
|
|
|
180
180
|
resolutionReason: true,
|
|
181
181
|
notificationChannels: true,
|
|
182
182
|
configState: true,
|
|
183
|
-
}).extend({
|
|
183
|
+
}).extend({
|
|
184
|
+
questionCount: z.number().int(),
|
|
185
|
+
viewerCanRespond: z
|
|
186
|
+
.boolean()
|
|
187
|
+
.optional()
|
|
188
|
+
.describe(
|
|
189
|
+
"Pending rows only: whether the caller may answer, by the same rule as the respond route (a listed user or role, or no users and roles listed).",
|
|
190
|
+
),
|
|
191
|
+
});
|
|
184
192
|
|
|
185
193
|
/**
|
|
186
194
|
* Reshapes a DB `ApprovalRequest` row for `respond()` — identical values,
|
|
@@ -209,9 +217,13 @@ async function toApprovalRequestResponse(
|
|
|
209
217
|
};
|
|
210
218
|
}
|
|
211
219
|
|
|
212
|
-
/**
|
|
220
|
+
/**
|
|
221
|
+
* Slim rows plus `approvalProgress` and `viewerCanRespond` for the pending ones
|
|
222
|
+
* (one extra read). `viewer` is null when the caller cannot answer any request.
|
|
223
|
+
*/
|
|
213
224
|
async function withApprovalProgress(
|
|
214
225
|
rows: Awaited<ReturnType<typeof listApprovalRequestSummaries>>,
|
|
226
|
+
viewer: ApprovalResponder | null,
|
|
215
227
|
): Promise<z.infer<typeof ApprovalRequestSummarySchema>[]> {
|
|
216
228
|
const pendingIds = rows.filter((row) => row.status === "pending").map((row) => row.id);
|
|
217
229
|
const state = new Map(
|
|
@@ -225,6 +237,10 @@ async function withApprovalProgress(
|
|
|
225
237
|
approvalProgress: entry
|
|
226
238
|
? await approvalProgress(entry.approvers as ApproversShape, entry.approvals ?? [])
|
|
227
239
|
: null,
|
|
240
|
+
...(entry && {
|
|
241
|
+
viewerCanRespond:
|
|
242
|
+
viewer !== null && isListedApprover(entry.approvers as ApproversShape, viewer),
|
|
243
|
+
}),
|
|
228
244
|
};
|
|
229
245
|
}),
|
|
230
246
|
);
|
|
@@ -490,7 +506,7 @@ const listRoute = route({
|
|
|
490
506
|
pattern: ["api", "approval-requests"],
|
|
491
507
|
summary: "List approval requests with optional filters",
|
|
492
508
|
description:
|
|
493
|
-
"Returns full approval requests by default. Pass `fields=slim` for the list-view shape: `questions`, `approvers`, `responses`, `resolutionReason` and `notificationChannels` are dropped and `questionCount` is added. Fetch one request in full via `GET /api/approval-requests/{id}`.",
|
|
509
|
+
"Returns full approval requests by default. Pass `fields=slim` for the list-view shape: `questions`, `approvers`, `responses`, `resolutionReason` and `notificationChannels` are dropped and `questionCount` is added, plus `viewerCanRespond` on pending rows. Fetch one request in full via `GET /api/approval-requests/{id}`.",
|
|
494
510
|
tags: ["ApprovalRequests"],
|
|
495
511
|
query: z.object({
|
|
496
512
|
status: z.string().optional(),
|
|
@@ -890,8 +906,12 @@ export async function handleApprovalRequests(
|
|
|
890
906
|
};
|
|
891
907
|
// Opt-in: API, MCP and script callers that don't ask keep the full rows.
|
|
892
908
|
if (parsed.query.fields === "slim") {
|
|
909
|
+
const viewer = await approvalResponder(req);
|
|
893
910
|
listRoute.respond(res, 200, {
|
|
894
|
-
approvalRequests: await withApprovalProgress(
|
|
911
|
+
approvalRequests: await withApprovalProgress(
|
|
912
|
+
await listApprovalRequestSummaries(filters),
|
|
913
|
+
viewer.ok ? viewer.responder : null,
|
|
914
|
+
),
|
|
895
915
|
});
|
|
896
916
|
return true;
|
|
897
917
|
}
|
package/src/http/apps.ts
CHANGED
|
@@ -65,6 +65,7 @@ import {
|
|
|
65
65
|
import { getAgentById, getAppVersion, getAppVersions, getTaskById } from "../be/db";
|
|
66
66
|
import type { RbacResource } from "../rbac";
|
|
67
67
|
import { can } from "../rbac";
|
|
68
|
+
import { APP_SESSION_KEY_PATTERN, appSessionContextKey } from "../tasks/context-key";
|
|
68
69
|
import { AgentTaskStatusSchema, AppIconSchema } from "../types";
|
|
69
70
|
import { getRequestAuth } from "../utils/request-auth-context";
|
|
70
71
|
import { scrubObject } from "../utils/secret-scrubber";
|
|
@@ -72,6 +73,7 @@ import { resolveHttpFavoriteOwner } from "./favorite-owner";
|
|
|
72
73
|
import { agentFirstPrincipal, authUser, authUserId, requestPrincipal } from "./request-principal";
|
|
73
74
|
import { bodyTask, route } from "./route-def";
|
|
74
75
|
import { denyParentAttach } from "./session-access";
|
|
76
|
+
import { resolveTaskRequester } from "./task-requester";
|
|
75
77
|
import { BODY_TOO_LARGE, enforceContentLengthCap, json, jsonError } from "./utils";
|
|
76
78
|
|
|
77
79
|
const MAX_APP_BODY_BYTES = 5 * 1024 * 1024;
|
|
@@ -638,6 +640,36 @@ const runActionRoute = route({
|
|
|
638
640
|
input: z.record(z.string(), z.unknown()).optional(),
|
|
639
641
|
/** Chains the new task off an existing one. Task-kind actions only: a script or sync action rejects it (400). */
|
|
640
642
|
parentTaskId: z.string().min(1).optional(),
|
|
643
|
+
/**
|
|
644
|
+
* `false`: no Lead follow-up (review) task when the created task finishes
|
|
645
|
+
* (`followUpConfig.disabled`). A json-render `SessionThread` sends it, so
|
|
646
|
+
* the chat stays one task per message. Script and sync actions create no
|
|
647
|
+
* task and ignore it, so a generic caller may always send it.
|
|
648
|
+
*/
|
|
649
|
+
followUp: z.boolean().optional(),
|
|
650
|
+
/**
|
|
651
|
+
* The person the task is for, when the caller is the shared operator key
|
|
652
|
+
* (the dashboard's picked identity). Resolved like `POST /api/tasks`: a
|
|
653
|
+
* caller bound to a user always wins, and the hint is honored only when
|
|
654
|
+
* the caller may assign requesters.
|
|
655
|
+
*/
|
|
656
|
+
requestedByUserId: z.string().min(1).optional(),
|
|
657
|
+
/**
|
|
658
|
+
* A json-render `SessionThread` session. The server builds the task's
|
|
659
|
+
* `contextKey` (`task:app:<appId>:<key>:user:<requester>`) from this
|
|
660
|
+
* app's id, the key and the resolved requester; a raw `contextKey` is
|
|
661
|
+
* never taken from the client. Scope `user` needs a requesting user.
|
|
662
|
+
* Scope `shared` is reserved: it answers 400 until shared sessions land
|
|
663
|
+
* (planned: an everyone:write `session_shares` row on the root). A
|
|
664
|
+
* follow-up (`parentTaskId`) inherits its parent's key instead. Script
|
|
665
|
+
* and sync actions ignore it.
|
|
666
|
+
*/
|
|
667
|
+
session: z
|
|
668
|
+
.object({
|
|
669
|
+
key: z.string().regex(APP_SESSION_KEY_PATTERN),
|
|
670
|
+
scope: z.enum(["user", "shared"]).optional(),
|
|
671
|
+
})
|
|
672
|
+
.optional(),
|
|
641
673
|
}),
|
|
642
674
|
responses: {
|
|
643
675
|
200: { description: "Action invoked", schema: runActionResultSchema },
|
|
@@ -1403,15 +1435,15 @@ export async function handleApps(
|
|
|
1403
1435
|
return true;
|
|
1404
1436
|
}
|
|
1405
1437
|
if (definitionNeedsRepair(res, app)) return true;
|
|
1438
|
+
const actions = app.definition.actions;
|
|
1439
|
+
const action =
|
|
1440
|
+
actions && Object.hasOwn(actions, parsed.params.name)
|
|
1441
|
+
? actions[parsed.params.name]
|
|
1442
|
+
: undefined;
|
|
1406
1443
|
if (parsed.body.parentTaskId) {
|
|
1407
1444
|
// `parentTaskId` only means something to a task-kind action: a script or
|
|
1408
1445
|
// sync action rejects it rather than silently dropping it. An unknown
|
|
1409
1446
|
// action keeps `runAppAction`'s 404.
|
|
1410
|
-
const actions = app.definition.actions;
|
|
1411
|
-
const action =
|
|
1412
|
-
actions && Object.hasOwn(actions, parsed.params.name)
|
|
1413
|
-
? actions[parsed.params.name]
|
|
1414
|
-
: undefined;
|
|
1415
1447
|
if (action && action.kind !== "task") {
|
|
1416
1448
|
jsonError(res, "parentTaskId is only supported for task-kind actions", 400);
|
|
1417
1449
|
return true;
|
|
@@ -1428,11 +1460,43 @@ export async function handleApps(
|
|
|
1428
1460
|
if (await denyParentAttach(req, res, myAgentId, parentTask, principal)) return true;
|
|
1429
1461
|
}
|
|
1430
1462
|
}
|
|
1463
|
+
// Only a task-kind action creates a task to attribute and key.
|
|
1464
|
+
const requestedByUserId =
|
|
1465
|
+
action?.kind === "task"
|
|
1466
|
+
? await resolveTaskRequester(req, myAgentId, parsed.body.requestedByUserId)
|
|
1467
|
+
: undefined;
|
|
1468
|
+
let contextKey: string | undefined;
|
|
1469
|
+
const session = parsed.body.session;
|
|
1470
|
+
if (session && action?.kind === "task") {
|
|
1471
|
+
if (session.scope === "shared") {
|
|
1472
|
+
jsonError(res, 'session scope "shared" is not supported yet', 400);
|
|
1473
|
+
return true;
|
|
1474
|
+
}
|
|
1475
|
+
if (!requestedByUserId) {
|
|
1476
|
+
jsonError(
|
|
1477
|
+
res,
|
|
1478
|
+
"A user-scoped session needs a requesting user: sign in or pick an identity",
|
|
1479
|
+
400,
|
|
1480
|
+
);
|
|
1481
|
+
return true;
|
|
1482
|
+
}
|
|
1483
|
+
// A follow-up joins its parent's chain and inherits the parent's key.
|
|
1484
|
+
if (!parsed.body.parentTaskId) {
|
|
1485
|
+
contextKey = appSessionContextKey({
|
|
1486
|
+
appId: app.id,
|
|
1487
|
+
sessionKey: session.key,
|
|
1488
|
+
userId: requestedByUserId,
|
|
1489
|
+
});
|
|
1490
|
+
}
|
|
1491
|
+
}
|
|
1431
1492
|
const output = await runAppAction({
|
|
1432
1493
|
app,
|
|
1433
1494
|
name: parsed.params.name,
|
|
1434
1495
|
input: parsed.body.input,
|
|
1435
1496
|
parentTaskId: parsed.body.parentTaskId,
|
|
1497
|
+
followUp: parsed.body.followUp,
|
|
1498
|
+
requestedByUserId,
|
|
1499
|
+
contextKey,
|
|
1436
1500
|
caller,
|
|
1437
1501
|
actor,
|
|
1438
1502
|
});
|