@desplega.ai/agent-swarm 2.13.5 → 2.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/acp-adapter-7jv7w8jh.js +17 -0
- package/dist/{acp-targets-w8dbs4nr.js → acp-targets-0ebmg3et.js} +10 -10
- package/dist/{actions-8zrcbjrx.js → actions-0ds9dx6c.js} +63 -42
- package/dist/{agent-fs-provision-cbt2ttds.js → agent-fs-provision-zpbxa9jc.js} +4 -4
- package/dist/{amp-adapter-8x6zp8w4.js → amp-adapter-awh5nn7a.js} +3 -3
- package/dist/{anthropic-messages-vdd1zmha.js → anthropic-messages-gtgp9r85.js} +17 -17
- package/dist/{app-zfa9dwjw.js → app-nzejkvpp.js} +10 -10
- package/dist/{approval-notifications-rv92zmza.js → approval-notifications-hbqtb2w3.js} +11 -11
- package/dist/{assistant-q7s7rm1q.js → assistant-1paft129.js} +42 -37
- package/dist/{boot-args-schema-g27kpzr1.js → boot-args-schema-zs435mfx.js} +1 -1
- package/dist/{boot-reembed-1mjs52nt.js → boot-reembed-7xq2qgg4.js} +1 -1
- package/dist/{boot-reembed-m62dpdkg.js → boot-reembed-91qrd4mz.js} +1 -1
- package/dist/{boot-scrub-sweep-ss1vcamw.js → boot-scrub-sweep-3h5xscw6.js} +2 -2
- package/dist/{boot-seeds-hwnvgbb3.js → boot-seeds-xkxqa8zc.js} +4 -4
- package/dist/{boxd-y0szhp0g.js → boxd-464x3w4m.js} +4 -4
- package/dist/{claude-adapter-0rjmbhjk.js → claude-adapter-6d8eyf2f.js} +12 -13
- package/dist/{claude-managed-adapter-6k032agg.js → claude-managed-adapter-jzxcaf9m.js} +4 -4
- package/dist/{claude-managed-setup-6czvve8q.js → claude-managed-setup-5fcx0qh3.js} +10 -10
- package/dist/{claude-sdk-session-pr0znb81.js → claude-sdk-session-11vhz1hc.js} +12720 -13882
- package/dist/{cli-kr0jpw9c.js → cli-02ba8qx5.js} +1 -1
- package/dist/{cli-ywy8yz6t.js → cli-08gfvs58.js} +2 -2
- package/dist/{cli-0qt3epg4.js → cli-0dkpdvnn.js} +10 -10
- package/dist/{cli-s8dhq7rj.js → cli-0mq8kxfx.js} +5 -5
- package/dist/{cli-ybte1fqc.js → cli-0nvqg1hb.js} +1 -1
- package/dist/{cli-f9xw9pr4.js → cli-0qyfna7a.js} +5 -5
- package/dist/cli-0vxbrxr3.js +1006 -0
- package/dist/{cli-ehg90jd1.js → cli-132h67ps.js} +64 -59
- package/dist/{cli-f7b9nyvk.js → cli-1e13gvfn.js} +17 -17
- package/dist/cli-1hj68b3h.js +30 -0
- package/dist/{cli-srktrbby.js → cli-1zbj28py.js} +1 -1
- package/dist/{cli-q41qar56.js → cli-20mkgwev.js} +173 -46
- package/dist/{cli-v09eza21.js → cli-288k5ep1.js} +15 -15
- package/dist/{cli-abby987g.js → cli-2n7qdqfv.js} +3 -3
- package/dist/{cli-kezzteka.js → cli-2r62jy9s.js} +1 -1
- package/dist/{cli-qmx8bnt4.js → cli-3179w2rz.js} +2 -2
- package/dist/cli-3a3hm1z8.js +15 -0
- package/dist/cli-3bagv8rt.js +37 -0
- package/dist/{cli-zxa1vmx7.js → cli-3bcsc3m7.js} +2 -2
- package/dist/{cli-j69pzrrz.js → cli-3g0vbq46.js} +5 -5
- package/dist/{cli-69szn7w7.js → cli-3ktfe5jx.js} +71 -47
- package/dist/{cli-69zzpjgh.js → cli-44r66df2.js} +1 -1
- package/dist/{cli-grbngev5.js → cli-466jjrwe.js} +11 -2
- package/dist/{cli-1jq2em7b.js → cli-4y2bekkn.js} +10 -9
- package/dist/cli-547fsc36.js +15 -0
- package/dist/{cli-6p8p2e6r.js → cli-5pyes68e.js} +1278 -23
- package/dist/{cli-ewk3sg68.js → cli-5t00r6c9.js} +3 -3
- package/dist/{cli-wzecestt.js → cli-5xjdft4s.js} +4063 -1835
- package/dist/{cli-4dyzzkfb.js → cli-643skca1.js} +954 -180
- package/dist/{cli-vr4eyq6p.js → cli-6a77m17n.js} +540 -412
- package/dist/{cli-v41kn3cd.js → cli-6prwz0zn.js} +4427 -5566
- package/dist/{cli-ks06cd0n.js → cli-6xrbpj5j.js} +8 -8
- package/dist/{cli-meydjstb.js → cli-6yhjqd6k.js} +4965 -69
- package/dist/{cli-bvamr9g0.js → cli-727sq1f9.js} +4 -4
- package/dist/{cli-snxhtehz.js → cli-7abeph0b.js} +7 -8
- package/dist/{cli-ty3gha1p.js → cli-7b9bwrfg.js} +2 -2
- package/dist/{cli-vbge4rsp.js → cli-7dwsn9y5.js} +4 -4
- package/dist/{cli-1kvcsd2f.js → cli-7qkbab03.js} +76 -8
- package/dist/{cli-8b4rpnwj.js → cli-7svwhw1a.js} +1 -1
- package/dist/{cli-jdq3jmny.js → cli-83kf2y60.js} +8 -10
- package/dist/{cli-tgc1kgg3.js → cli-84wxwt3z.js} +1 -1
- package/dist/{cli-sejvnjvw.js → cli-8crn0510.js} +1 -1
- package/dist/{cli-19d6v8er.js → cli-8kemtj1r.js} +172 -18
- package/dist/{cli-qrvk9nka.js → cli-967jrz7j.js} +40 -26
- package/dist/{cli-cp163xga.js → cli-976m0zcw.js} +72 -50
- package/dist/{cli-887vhew6.js → cli-98sea4d9.js} +2716 -2643
- package/dist/{cli-xh5fpmg8.js → cli-9txap41q.js} +101 -18
- package/dist/{cli-nrt048ys.js → cli-aktk3qt6.js} +40 -3
- package/dist/{cli-t0n9svkb.js → cli-b70cpf8f.js} +12 -7
- package/dist/{cli-2ap1the6.js → cli-by7s3n4p.js} +1 -1
- package/dist/{cli-tt7dkwjj.js → cli-byzq8xht.js} +7 -7
- package/dist/{cli-55h8m1x3.js → cli-d1zkys4j.js} +150 -99
- package/dist/cli-dr6x9qdk.js +15 -0
- package/dist/cli-dt931hb8.js +9740 -0
- package/dist/{cli-emdfd8fh.js → cli-dy754erz.js} +9 -1
- package/dist/{cli-2wzkvfgm.js → cli-e1wprqnd.js} +3 -3
- package/dist/{cli-pedm2kht.js → cli-e2wzzw17.js} +2 -2
- package/dist/{cli-1jx0srjt.js → cli-e9p9h14n.js} +1921 -80
- package/dist/{cli-evy3egte.js → cli-eaqxkeq0.js} +14 -103
- package/dist/{cli-he5nxaa8.js → cli-etykr11s.js} +3062 -728
- package/dist/{cli-3vw6dd4g.js → cli-f07sgaax.js} +2 -2
- package/dist/{cli-z1vam71h.js → cli-fe8he9cy.js} +2 -2
- package/dist/{cli-94gx6ze9.js → cli-h0edykd1.js} +1 -1
- package/dist/cli-h5cveb69.js +15 -0
- package/dist/{cli-5tq15aa7.js → cli-hamdfjtx.js} +2 -2
- package/dist/{cli-kwj3131p.js → cli-hh5m39pt.js} +1 -1
- package/dist/{cli-tvyt8w6n.js → cli-j8fmn3wv.js} +11 -11
- package/dist/cli-jngvszex.js +1514 -0
- package/dist/{cli-9n6g14vs.js → cli-k791mabe.js} +6 -6
- package/dist/{cli-6msnpj1z.js → cli-k9m8fckz.js} +10 -10
- package/dist/{cli-2vp0z049.js → cli-kz8rar0g.js} +1 -1
- package/dist/{cli-94mxerrp.js → cli-n15fhd43.js} +1 -1
- package/dist/{cli-htb5bpz2.js → cli-nmdy8bzf.js} +10 -3
- package/dist/{cli-t9pzz2eq.js → cli-ntmjzyte.js} +4 -1
- package/dist/{cli-avax5mp9.js → cli-ny8f5g7t.js} +19 -7
- package/dist/cli-p0g0erm9.js +15 -0
- package/dist/{cli-n79j1vxc.js → cli-pgdqhdkw.js} +4 -4
- package/dist/cli-ph1jce1b.js +16 -0
- package/dist/{cli-ced4azn1.js → cli-phantfg3.js} +771 -401
- package/dist/{cli-ebpq3c5z.js → cli-rb1z91g8.js} +10221 -1397
- package/dist/{cli-a49frv85.js → cli-redtbppc.js} +1 -1
- package/dist/{cli-cmbb2t8a.js → cli-s7bfz1ye.js} +15 -15
- package/dist/{cli-8pd1t17c.js → cli-sf5kp73f.js} +18 -18
- package/dist/{cli-zbbtp02a.js → cli-sq32dgfe.js} +1837 -7206
- package/dist/{cli-k0nebh10.js → cli-tbrjvrrg.js} +1 -1
- package/dist/{cli-4gaf3tx5.js → cli-tdd9dvw6.js} +1 -1
- package/dist/{cli-7ypg8hka.js → cli-tjrrabez.js} +3 -3
- package/dist/{cli-q1h041y8.js → cli-tkrp183j.js} +11 -11
- package/dist/{cli-srre41gb.js → cli-trvtxwzt.js} +2 -2
- package/dist/{cli-ffn0a515.js → cli-v1rhq77v.js} +68 -25
- package/dist/{cli-t879ww0y.js → cli-v3jxx8dv.js} +2 -2
- package/dist/{cli-b42yfn17.js → cli-v84kb7af.js} +14 -14
- package/dist/{cli-sa02jsqt.js → cli-vp2ksaq9.js} +1 -1
- package/dist/{cli-b0m3bg0f.js → cli-vrb8pvrf.js} +6 -6
- package/dist/cli-vxxdf2ma.js +15 -0
- package/dist/{cli-x2adbg4j.js → cli-w81s97bn.js} +1 -1
- package/dist/{cli-4vynxtrb.js → cli-wkzrknpt.js} +10 -3
- package/dist/{cli-fw67mnyc.js → cli-wqpvfq2m.js} +1 -1
- package/dist/{cli-prz1p3ft.js → cli-wsh5vfa7.js} +9 -9
- package/dist/{cli-hd5bm1e1.js → cli-wtwe8vng.js} +45 -45
- package/dist/{cli-34fygf87.js → cli-ww8wxfzx.js} +2 -2
- package/dist/{cli-e8trbfx1.js → cli-x80zagf5.js} +1 -1
- package/dist/{cli-zntvmqmm.js → cli-xd6ntv7x.js} +2 -2
- package/dist/{cli-vcpyttcw.js → cli-xmc2nrtv.js} +1 -1
- package/dist/{cli-z40t85ms.js → cli-ytgtqsy9.js} +1 -1
- package/dist/{cli-r3dxpmyt.js → cli-yvnnyjxm.js} +1 -1
- package/dist/{cli-zzq96q57.js → cli-z0c98h7h.js} +2450 -554
- package/dist/{cli-ryem5cfq.js → cli-z0effej1.js} +217 -27
- package/dist/{cli-0h8skzss.js → cli-zcb64xzv.js} +4 -3
- package/dist/{cli-5web09sb.js → cli-zdkcp8p0.js} +8 -10
- package/dist/{cli-z3x7h79n.js → cli-zgsd2w2k.js} +20 -22
- package/dist/{cli-7r9tvk8v.js → cli-zmfs06hg.js} +15 -9
- package/dist/{cli-3860pmrq.js → cli-zvsy4abb.js} +4 -4
- package/dist/{cli-5n9w2xzx.js → cli-zyf288rw.js} +2 -2
- package/dist/cli.js +64 -65
- package/dist/{codex-adapter-bn7eaxk5.js → codex-adapter-seht4h9t.js} +9 -9
- package/dist/{codex-hook-nnmezjg9.js → codex-hook-w5nmtrn2.js} +3 -3
- package/dist/{codex-login-ktfg1cxk.js → codex-login-67qarfcg.js} +1 -1
- package/dist/{codex-session-runner-j1e9hffc.js → codex-session-runner-tq95x3gq.js} +10 -10
- package/dist/{commands-amhpafrr.js → commands-0awwqxq5.js} +3 -3
- package/dist/{controller-tw7g10j2.js → controller-hgjx521c.js} +4 -4
- package/dist/{controllers-connect-2ssqz7f4.js → controllers-connect-j4kdmhfj.js} +28 -29
- package/dist/core-8fw1gwg7.js +41 -0
- package/dist/{cursor-adapter-d6knjmwa.js → cursor-adapter-0rg8wk6j.js} +2 -2
- package/dist/{db-fd6xxm77.js → db-8xs2js3s.js} +3 -3
- package/dist/{db-sc59379z.js → db-dd6hj211.js} +4 -2
- package/dist/{devin-adapter-3bp6rape.js → devin-adapter-tn1twrha.js} +1 -1
- package/dist/{devtools-qxfgbsqz.js → devtools-b8qts77k.js} +1 -1
- package/dist/{dispatcher-a2gdqz8c.js → dispatcher-v7drd034.js} +24 -25
- package/dist/{docker-a59g3ebm.js → docker-6007r2fj.js} +2 -2
- package/dist/dsh-adapter-ah8npj2x.js +11 -0
- package/dist/{e2b-qnxyfea6.js → e2b-hg80w0qr.js} +3 -3
- package/dist/{e2b-cn7cvjqy.js → e2b-z1g7vpz6.js} +16 -5
- package/dist/{easter-egg-3d-a0pphy71.js → easter-egg-3d-8n4w3s9k.js} +1 -1
- package/dist/{embedding-space-qepzrach.js → embedding-space-0p921zt3.js} +13 -23
- package/dist/{embeddings-d7vr881x.js → embeddings-9s7kbrc6.js} +1 -1
- package/dist/emscripten-module-Q67P5WYC-3sde6cre.js +2458 -0
- package/dist/{event-bus-7gbsr0g4.js → event-bus-pawddp92.js} +1 -1
- package/dist/{execute-6afts2bn.js → execute-x0fy9j0m.js} +1 -1
- package/dist/{external-channel-881zq1x4.js → external-channel-ktfvn29c.js} +2 -2
- package/dist/ffi-cbfmmtqk.js +85 -0
- package/dist/fx-adapter-15vjxvgm.js +20 -0
- package/dist/getMachineId-bsd-2rd3pnz7.js +36 -0
- package/dist/getMachineId-bsd-3p48mkt1.js +36 -0
- package/dist/{getMachineId-bsd-637a7rbk.js → getMachineId-bsd-bk6tmeen.js} +5 -5
- package/dist/getMachineId-bsd-pssqgwmm.js +37 -0
- package/dist/getMachineId-bsd-v218x3xd.js +36 -0
- package/dist/getMachineId-bsd-wbxcazef.js +36 -0
- package/dist/getMachineId-bsd-x0942pbz.js +36 -0
- package/dist/getMachineId-darwin-5qsy4qcg.js +36 -0
- package/dist/getMachineId-darwin-6v7zsshx.js +37 -0
- package/dist/getMachineId-darwin-fcc3fjag.js +36 -0
- package/dist/getMachineId-darwin-pg84hftj.js +36 -0
- package/dist/{getMachineId-darwin-9vytrcnn.js → getMachineId-darwin-tyyevt26.js} +5 -5
- package/dist/getMachineId-darwin-wagmbf0d.js +36 -0
- package/dist/getMachineId-darwin-zvkmwr3y.js +36 -0
- package/dist/{getMachineId-linux-mkzsvyyz.js → getMachineId-linux-2ncg1epd.js} +3 -3
- package/dist/getMachineId-linux-2tmt2ptc.js +29 -0
- package/dist/getMachineId-linux-empwyp2y.js +29 -0
- package/dist/getMachineId-linux-fanqd45b.js +29 -0
- package/dist/getMachineId-linux-h6fyga0x.js +29 -0
- package/dist/getMachineId-linux-tbhgz1k9.js +29 -0
- package/dist/getMachineId-linux-zrbyw7dt.js +29 -0
- package/dist/getMachineId-unsupported-29g9dkgv.js +19 -0
- package/dist/getMachineId-unsupported-8xfq8djv.js +19 -0
- package/dist/getMachineId-unsupported-8y9cag1p.js +19 -0
- package/dist/getMachineId-unsupported-a6sjrm02.js +19 -0
- package/dist/getMachineId-unsupported-bp3w7ds0.js +19 -0
- package/dist/{getMachineId-unsupported-4cfs2n11.js → getMachineId-unsupported-sj6fk8sw.js} +3 -3
- package/dist/getMachineId-unsupported-v0p5gdxp.js +19 -0
- package/dist/getMachineId-win-hc996p0x.js +38 -0
- package/dist/{getMachineId-win-154s3qma.js → getMachineId-win-msq9ad87.js} +6 -6
- package/dist/getMachineId-win-tajyqwd6.js +38 -0
- package/dist/getMachineId-win-tzc163da.js +38 -0
- package/dist/getMachineId-win-xdaa0mgq.js +38 -0
- package/dist/getMachineId-win-xk6p98m5.js +38 -0
- package/dist/getMachineId-win-xtk658fm.js +38 -0
- package/dist/{google-generative-ai-sw77egmr.js → google-generative-ai-nzndg246.js} +1 -1
- package/dist/{google-vertex-rrw93g8h.js → google-vertex-ragh3nnw.js} +1 -1
- package/dist/grok-adapter-77httan0.js +20 -0
- package/dist/handlers-c1jp5b6h.js +39 -0
- package/dist/heartbeat-5yaj6dym.js +49 -0
- package/dist/{hook-a7eh6zty.js → hook-2jttae8s.js} +13 -14
- package/dist/hook-c99nycyh.js +21 -0
- package/dist/{http-6aw5wanc.js → http-7y9dbfrr.js} +870 -219
- package/dist/{index-kzdqn3dd.js → index-6g9rdcrj.js} +3036 -758
- package/dist/index-7dwh9kxh.js +41 -0
- package/dist/{index-ym9fgxad.js → index-8p03vx1h.js} +8 -8
- package/dist/{index-maddg9ys.js → index-cw8nxnba.js} +4330 -15375
- package/dist/{index-yq9hhhhy.js → index-dm7c6hw5.js} +28 -29
- package/dist/index-fqf82sbk.js +10584 -0
- package/dist/{index-126v2d0t.js → index-g7rthzrv.js} +11 -2923
- package/dist/{index-z2g9469g.js → index-h9xnzfhx.js} +114 -33
- package/dist/{index-42jq9yy3.js → index-jvfp0j47.js} +516 -10
- package/dist/{index-3j803vnb.js → index-q60mhcpd.js} +25094 -20637
- package/dist/index-qxcfv8vq.js +17 -0
- package/dist/{index-rz8ve510.js → index-t274qhhs.js} +6 -6
- package/dist/{index-kdmkfjt7.js → index-t4n9z755.js} +3491 -2487
- package/dist/{index-7dgxveck.js → index-tcegcysh.js} +5 -5
- package/dist/{index-whysn1wf.js → index-tn1m3q9b.js} +3 -3
- package/dist/index-wp9tarbt.js +43 -0
- package/dist/{index-xhad0n8m.js → index-xhp7yp3t.js} +1 -1
- package/dist/index-z6np2405.js +38 -0
- package/dist/{k8s-36gfn847.js → k8s-mr1r12th.js} +2 -2
- package/dist/{keepalive-zhbmztqw.js → keepalive-7eyb8y4t.js} +4 -5
- package/dist/lead-50cgn8s1.js +81 -0
- package/dist/{maintenance-rsp0591h.js → maintenance-tdrd8nwv.js} +1 -1
- package/dist/module-ES6BEMUI-6htewwha.js +1210 -0
- package/dist/{node-0as4n1ef.js → node-gbx1t3pa.js} +1 -1
- package/dist/{node-rxte5hc6.js → node-jkdd5w7m.js} +1 -1
- package/dist/{oauth-refresh-sweep-w3cqmxq7.js → oauth-refresh-sweep-f4c7g37h.js} +3 -4
- package/dist/{object-webhooks-331hay92.js → object-webhooks-p190rdxp.js} +7 -7
- package/dist/{onboard-n2w80m2n.js → onboard-56h4sks6.js} +12 -10
- package/dist/{opencode-adapter-z98127cz.js → opencode-adapter-xg3yxfr0.js} +8 -8
- package/dist/{otel-impl-xsk35tvf.js → otel-impl-kepzgm4n.js} +36360 -9179
- package/dist/{pending-2e6trkxd.js → pending-xgv316w0.js} +25 -26
- package/dist/{pi-mono-adapter-wh6yndtm.js → pi-mono-adapter-txe0syzb.js} +19 -22
- package/dist/{pricing-refresh-9355dj1t.js → pricing-refresh-041zpyhf.js} +2 -2
- package/dist/{rbac-roles-8eajw4s6.js → rbac-roles-8f3jbcaf.js} +2 -2
- package/dist/{rbac-roles-58y3m912.js → rbac-roles-cw7rrw5b.js} +3 -3
- package/dist/{render-v2-7gskkmd4.js → render-v2-2ezw4mzt.js} +10 -10
- package/dist/{resume-0drnmpja.js → resume-p14wdx8m.js} +13 -13
- package/dist/{runtime-d2tcmqte.js → runtime-he7c9g1r.js} +1 -1
- package/dist/{session-access-0ztys6bd.js → session-access-8jvq86fj.js} +5 -5
- package/dist/{session-source-backfill-cdm5s046.js → session-source-backfill-6fe3hcgb.js} +3 -3
- package/dist/{setup-pqwb9tcc.js → setup-6v0bn4r1.js} +15 -6
- package/dist/thread-buffer-8860v1ta.js +40 -0
- package/dist/{token-util-pjgekqxr.js → token-util-hnzceyn9.js} +1 -1
- package/dist/{token-pgr2w4s3.js → token-xnc02n6w.js} +21 -14
- package/dist/{tree-visibility-rwz67mje.js → tree-visibility-g1a8ff4r.js} +2 -2
- package/dist/{user-merge-jobs-mxrhamwt.js → user-merge-jobs-vjsps179.js} +3 -3
- package/dist/{virtual-modules-71y1gsmg.js → virtual-modules-mreda4fp.js} +3 -3
- package/dist/{work-objects-3k4ykt9j.js → work-objects-hfw15e35.js} +29 -33
- package/dist/{worker-follow-up-y0h64xpr.js → worker-follow-up-gbaz2ydz.js} +24 -25
- package/dist/worker-hkm8ftqp.js +81 -0
- package/dist/{x-d27jj7z7.js → x-k29vmskt.js} +2 -2
- package/openapi.json +303 -20
- package/package.json +45 -45
- package/src/apps/definition.ts +76 -24
- package/src/apps/row-store.ts +67 -0
- package/src/apps/script-types.ts +131 -21
- package/src/apps/store.ts +4 -1
- package/src/be/db/model-profiles.ts +103 -12
- package/src/be/db/script-runs.ts +33 -0
- package/src/be/db/slack-card-groups.ts +147 -0
- package/src/be/db/slack-trees.ts +26 -0
- package/src/be/db/task-idempotency.ts +63 -0
- package/src/be/db/tasks/read.ts +7 -0
- package/src/be/db/tasks/write.ts +4 -2
- package/src/be/db/workflow-idempotency.ts +6 -1
- package/src/be/db/workflows/read.ts +79 -0
- package/src/be/db.ts +65 -151
- package/src/be/improvements.ts +24 -2
- package/src/be/mcp-proxy.ts +45 -11
- package/src/be/memory/embedding-space.ts +10 -20
- package/src/be/memory/index.ts +35 -0
- package/src/be/memory/providers/openai-embedding.ts +10 -0
- package/src/be/migrations/348_task_deferred_until.sql +4 -0
- package/src/be/migrations/354_durable_objects.sql +9 -0
- package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
- package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
- package/src/be/migrations/362_favorites_app.sql +36 -0
- package/src/be/model-group-resolution.ts +134 -0
- package/src/be/model-tier-resolution.ts +120 -17
- package/src/be/model-validation.ts +9 -1
- package/src/be/repo-checked-update.ts +58 -5
- package/src/be/requester-timezone.ts +10 -0
- package/src/be/runtime-pools/routing.ts +22 -8
- package/src/be/script-connections.ts +5 -1
- package/src/be/script-credential-broker.ts +29 -2
- package/src/be/scripts/durable.ts +204 -0
- package/src/be/scripts/extract-schema.ts +36 -4
- package/src/be/scripts/run-credential.ts +1 -8
- package/src/be/scripts/typecheck.ts +32 -7
- package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
- package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
- package/src/be/swarm-config-guard.ts +104 -14
- package/src/be/users.ts +33 -12
- package/src/comb/review-batch.ts +16 -5
- package/src/commands/context-preamble.ts +237 -0
- package/src/commands/e2b.ts +14 -0
- package/src/commands/entrypoint-mcp-config.ts +231 -0
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/commands/onboard/compose-generator.ts +2 -1
- package/src/commands/onboard/env-generator.ts +16 -7
- package/src/commands/runner.ts +23 -7
- package/src/commands/setup.tsx +17 -3
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/hooks/hook.ts +8 -2
- package/src/hooks/native-tool-hooks.ts +4 -2
- package/src/http/apps.ts +82 -42
- package/src/http/comb.ts +21 -5
- package/src/http/config.ts +8 -4
- package/src/http/db-query.ts +8 -2
- package/src/http/heartbeat.ts +5 -0
- package/src/http/index.ts +12 -6
- package/src/http/kv.ts +7 -5
- package/src/http/mcp-oauth.ts +16 -0
- package/src/http/mcp-servers.ts +43 -3
- package/src/http/memory.ts +28 -1
- package/src/http/metrics.ts +11 -4
- package/src/http/onboarding.ts +12 -1
- package/src/http/operator-actor.ts +3 -8
- package/src/http/poll.ts +20 -1
- package/src/http/repos.ts +30 -12
- package/src/http/request-principal.ts +27 -1
- package/src/http/schedules.ts +59 -11
- package/src/http/script-connection-proxy.ts +3 -1
- package/src/http/script-runs.ts +21 -10
- package/src/http/scripts.ts +177 -26
- package/src/http/session-cost-recompute.ts +9 -4
- package/src/http/skills.ts +70 -0
- package/src/http/status.ts +2 -0
- package/src/http/tasks.ts +103 -15
- package/src/http/trackers/jira.ts +18 -3
- package/src/http/trackers/linear.ts +3 -0
- package/src/kv-limits.ts +2 -0
- package/src/kv-reserved-namespaces.ts +25 -2
- package/src/prompts/base-prompt.ts +10 -6
- package/src/prompts/session-templates.ts +52 -3
- package/src/prompts/session-turns.ts +30 -0
- package/src/providers/acp-targets.ts +1 -1
- package/src/providers/amp-adapter.ts +11 -9
- package/src/providers/claude-managed-adapter.ts +14 -0
- package/src/providers/claude-sdk-session.ts +14 -1
- package/src/providers/cursor-adapter.ts +1 -1
- package/src/providers/dsh-adapter.ts +1 -1
- package/src/providers/opencode-adapter.ts +3 -5
- package/src/providers/runtime-dependencies.ts +11 -8
- package/src/rbac/legacy-policy.ts +7 -0
- package/src/rbac/permissions.ts +27 -0
- package/src/realtime/browser.generated.txt +1 -1
- package/src/scheduler/schedule-task.ts +1 -0
- package/src/scheduler/scheduler.ts +36 -18
- package/src/script-workflows/executor.ts +37 -8
- package/src/script-workflows/supervisor.ts +14 -0
- package/src/scripts-runtime/ctx.ts +5 -1
- package/src/scripts-runtime/durable-object-base.ts +19 -0
- package/src/scripts-runtime/eval-harness.ts +46 -1
- package/src/scripts-runtime/executors/native.ts +13 -1
- package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
- package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
- package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
- package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
- package/src/scripts-runtime/executors/types.ts +26 -0
- package/src/scripts-runtime/extract-signature.ts +96 -1
- package/src/scripts-runtime/loader.ts +11 -5
- package/src/scripts-runtime/mcp-client.ts +1 -1
- package/src/scripts-runtime/sdk-allowlist.ts +1 -0
- package/src/scripts-runtime/swarm-config.ts +7 -0
- package/src/scripts-runtime/swarm-sdk.ts +4 -1
- package/src/scripts-runtime/types/stdlib.d.ts +19 -0
- package/src/scripts-runtime/types/swarm-extension.d.ts +3 -0
- package/src/scripts-runtime/types/swarm-sdk.d.ts +19 -0
- package/src/slack/actions.ts +24 -0
- package/src/slack/assistant.ts +8 -0
- package/src/slack/blocks.ts +35 -0
- package/src/slack/channel-activity.ts +7 -0
- package/src/slack/config.ts +4 -0
- package/src/slack/enrich.ts +46 -54
- package/src/slack/files.ts +173 -23
- package/src/slack/handlers.test.ts +17 -19
- package/src/slack/handlers.ts +15 -14
- package/src/slack/render-v2.ts +265 -19
- package/src/slack/responses.ts +62 -5
- package/src/slack/session-mirror.ts +10 -5
- package/src/slack/task-output.ts +25 -14
- package/src/slack/templates.ts +9 -0
- package/src/slack/thread-participants.ts +64 -24
- package/src/slack/watcher.ts +4 -4
- package/src/slack/work-objects.ts +1 -1
- package/src/stdio.ts +5 -0
- package/src/tasks/follow-up-gate.ts +142 -38
- package/src/tasks/worker-follow-up.ts +126 -37
- package/src/tests/agents-list-model-display.test.ts +4 -0
- package/src/tests/amp-adapter.test.ts +57 -9
- package/src/tests/apps-script-types.test.ts +63 -16
- package/src/tests/apps-sort-order.test.ts +87 -0
- package/src/tests/base-prompt.test.ts +36 -2
- package/src/tests/bedrock-model-groups.test.ts +4 -0
- package/src/tests/channel-activity.test.ts +9 -0
- package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
- package/src/tests/claude-hook-output.test.ts +2 -0
- package/src/tests/claude-managed-adapter.test.ts +15 -3
- package/src/tests/claude-sdk-stderr.test.ts +28 -0
- package/src/tests/codex-gpt6-release.test.ts +4 -0
- package/src/tests/comb-review-batch.test.ts +17 -4
- package/src/tests/comb-status.test.ts +1 -0
- package/src/tests/db-client.test.ts +11 -5
- package/src/tests/db-retention-defaults.test.ts +28 -3
- package/src/tests/db-task-read-contract.test.ts +1 -0
- package/src/tests/db-task-write-contract.test.ts +2 -2
- package/src/tests/defer-task.test.ts +23 -1
- package/src/tests/dsh-adapter.test.ts +1 -1
- package/src/tests/e2b-dispatch.test.ts +13 -1
- package/src/tests/entrypoint-mcp-config.test.ts +642 -0
- package/src/tests/entrypoint-repo-autoclone-args.test.ts +10 -0
- package/src/tests/fixtures/onboard/content.env.txt +2 -2
- package/src/tests/fixtures/onboard/dev.env.txt +2 -2
- package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
- package/src/tests/fixtures/onboard/full.env.txt +2 -2
- package/src/tests/fixtures/onboard/research.env.txt +2 -2
- package/src/tests/fixtures/onboard/solo.env.txt +2 -2
- package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
- package/src/tests/follow-up-gate-shadow.test.ts +268 -10
- package/src/tests/fx-adapter.test.ts +4 -5
- package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
- package/src/tests/hook-ping-me-order.test.ts +1 -0
- package/src/tests/hook-runtime-close.test.ts +1 -0
- package/src/tests/improvements-payload.test.ts +2 -2
- package/src/tests/linear-outbound-sync.test.ts +59 -25
- package/src/tests/model-groups-live-catalog.test.ts +4 -0
- package/src/tests/oauth-credential-bindings.test.ts +8 -3
- package/src/tests/oauth-refresh-failure.test.ts +15 -3
- package/src/tests/onboard-env.test.ts +1 -1
- package/src/tests/openai-compatible-providers.test.ts +5 -0
- package/src/tests/openapi-route-headers.test.ts +2 -1
- package/src/tests/operator-actor-keyless.test.ts +103 -0
- package/src/tests/opus-5-5-registry.test.ts +4 -0
- package/src/tests/profile-tier-alias.test.ts +9 -3
- package/src/tests/provider-runtime-dependencies.test.ts +26 -15
- package/src/tests/routing-affinity-inventory.test.ts +11 -0
- package/src/tests/runner-context-preamble.test.ts +202 -0
- package/src/tests/runner-repo-clone-args.test.ts +125 -0
- package/src/tests/scheduler-occurrence.test.ts +60 -9
- package/src/tests/script-connections-mcp.test.ts +6 -3
- package/src/tests/script-connections.test.ts +4 -0
- package/src/tests/scripts-namespaces.test.ts +3 -1
- package/src/tests/secret-scrubber.test.ts +8 -2
- package/src/tests/session-cost-recompute-unit.test.ts +39 -0
- package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
- package/src/tests/session-route-posture.test.ts +7 -1
- package/src/tests/slack-file-tools-attachments.test.ts +14 -9
- package/src/tests/slack-identity-resolution.test.ts +10 -3
- package/src/tests/slack-inline-output.test.ts +10 -8
- package/src/tests/slack-render-v2.test.ts +9 -4
- package/src/tests/slack-steering.test.ts +8 -2
- package/src/tests/slack-thread-participants.test.ts +11 -1
- package/src/tests/sonnet-5-5-registry.test.ts +4 -0
- package/src/tests/swarm-config-encryption.test.ts +5 -8
- package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
- package/src/tests/workflow-system-one-extraction.test.ts +21 -0
- package/src/tests/workflow-triggers-v2.test.ts +35 -11
- package/src/tests/workflow-wait-filter.test.ts +7 -7
- package/src/tests/worktree-reaper.test.ts +15 -4
- package/src/tools/app-patch.ts +6 -2
- package/src/tools/app-upsert.ts +8 -4
- package/src/tools/defer-task.ts +17 -77
- package/src/tools/kv/kv-get.ts +2 -0
- package/src/tools/kv/kv-list.ts +11 -5
- package/src/tools/kv/kv-set.ts +1 -3
- package/src/tools/repos/update-repo.ts +37 -19
- package/src/tools/schedules/create-schedule.ts +20 -3
- package/src/tools/schedules/patch-schedule.ts +30 -4
- package/src/tools/schedules/run-schedule-now.ts +21 -1
- package/src/tools/schedules/update-schedule.ts +30 -4
- package/src/tools/script-apis.ts +9 -4
- package/src/tools/script-common.ts +2 -2
- package/src/tools/script-run.ts +8 -0
- package/src/tools/script-upsert.ts +1 -1
- package/src/tools/send-task.ts +17 -3
- package/src/tools/slack-download-file.ts +15 -12
- package/src/tools/slack-post.ts +14 -3
- package/src/tools/slack-read.ts +3 -1
- package/src/tools/slack-reply.ts +22 -2
- package/src/tools/slack-start-thread.ts +8 -1
- package/src/tools/slack-upload-file.ts +99 -96
- package/src/tools/swarm-config/set-config.ts +3 -1
- package/src/tools/swarm-x.ts +0 -2
- package/src/tools/task-action.ts +16 -3
- package/src/tools/utils.ts +4 -1
- package/src/types.ts +18 -2
- package/src/utils/amp-models.ts +20 -4
- package/src/utils/constants.ts +20 -0
- package/src/utils/deferral-time.ts +61 -0
- package/src/utils/request-auth-context.ts +15 -16
- package/src/utils/secret-scrubber.ts +7 -5
- package/src/workflows/engine.ts +42 -19
- package/src/workflows/executors/agent-task.ts +13 -2
- package/src/workflows/executors/code-match.ts +11 -31
- package/src/workflows/executors/script.ts +13 -0
- package/src/workflows/executors/swarm-script.ts +0 -2
- package/src/workflows/executors/system-one-extraction.ts +9 -6
- package/src/workflows/executors/wait.ts +1 -1
- package/src/workflows/foreach-driver.ts +11 -13
- package/src/workflows/input.ts +24 -1
- package/src/workflows/model-validation.ts +13 -1
- package/src/workflows/node-timeout.ts +18 -0
- package/src/workflows/predicate-sandbox.ts +171 -0
- package/src/workflows/retry-poller.ts +3 -2
- package/src/workflows/triggers.ts +21 -11
- package/src/workflows/wait-filter.ts +14 -192
- package/src/x/composio.ts +10 -1
- package/templates/skills/apps/SKILL.md +4 -2
- package/templates/skills/apps/content.md +4 -2
- package/templates/skills/code-quality/content.md +4 -4
- package/templates/skills/heartbeat-runbook/content.md +1 -0
- package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
- package/templates/skills/scheduled-task-resilience/content.md +2 -0
- package/templates/skills/slack-interaction/content.md +4 -0
- package/templates/skills/swarm-docs/content.md +8 -0
- package/templates/skills/swarm-scripts/SKILL.md +44 -0
- package/templates/skills/swarm-scripts/content.md +44 -0
- package/dist/acp-adapter-tbt61zkm.js +0 -17
- package/dist/cli-5ss6qqt9.js +0 -45
- package/dist/cli-b9ygp1kz.js +0 -459
- package/dist/cli-dzzh58sy.js +0 -6996
- package/dist/cli-j9ccfveb.js +0 -1849
- package/dist/cli-kj0hyr43.js +0 -51
- package/dist/cli-m8f4379k.js +0 -173
- package/dist/cli-mna6pmfx.js +0 -1485
- package/dist/cli-r8ddn0hf.js +0 -25583
- package/dist/core-bwp98v4w.js +0 -42
- package/dist/dsh-adapter-43ygwqn7.js +0 -9
- package/dist/fx-adapter-cr2hq17y.js +0 -20
- package/dist/grok-adapter-ayddnbsc.js +0 -20
- package/dist/handlers-7ghs84x2.js +0 -41
- package/dist/heartbeat-4c022m6a.js +0 -50
- package/dist/hook-4k84x499.js +0 -22
- package/dist/index-dtt0d634.js +0 -44
- package/dist/index-hmszyqkk.js +0 -42
- package/dist/index-j6rm1rtn.js +0 -39
- package/dist/index-rwwhsmjg.js +0 -13
- package/dist/index-t56y945n.js +0 -4
- package/dist/index-vfemrwwk.js +0 -10002
- package/dist/lead-g2j4q39z.js +0 -83
- package/dist/thread-buffer-epx3san4.js +0 -42
- package/dist/worker-09gqn9xy.js +0 -83
- package/dist/{azure-openai-responses-jeaas6x0.js → azure-openai-responses-e76k86gf.js} +4 -4
- package/dist/{openai-codex-responses-70g39cgz.js → openai-codex-responses-z2h941b8.js} +4 -4
- package/dist/{openai-completions-cv3hp4h5.js → openai-completions-5bxdkeg9.js} +4 -4
- package/dist/{openai-responses-trsvnks6.js → openai-responses-dzf3e8r5.js} +4 -4
|
@@ -8,56 +8,15 @@
|
|
|
8
8
|
* deep-equal (numbers/strings/booleans/arrays/objects). Missing keys or
|
|
9
9
|
* type mismatches → no-match. ALL keys must match.
|
|
10
10
|
*
|
|
11
|
-
* 2. **String form** — JS arrow-function
|
|
12
|
-
*
|
|
13
|
-
*
|
|
11
|
+
* 2. **String form** — JS arrow-function source `(payload) => boolean`,
|
|
12
|
+
* evaluated in a QuickJS sandbox (`./predicate-sandbox`). The payload
|
|
13
|
+
* crosses as a JSON copy. Result is `!!`-coerced. Throws, Promise
|
|
14
|
+
* returns, and runs past 50ms → no-match.
|
|
14
15
|
*
|
|
15
16
|
* No filter (undefined) → matches anything.
|
|
16
|
-
*
|
|
17
|
-
* SECURITY:
|
|
18
|
-
* - The string-form sandbox shadows dangerous globals (incl. `eval`,
|
|
19
|
-
* `Function`, `AsyncFunction`) — STRICTER than `code-match` because filter
|
|
20
|
-
* strings are higher-volume and authored by less-trusted workflow authors.
|
|
21
|
-
* - Payload is `structuredClone`d before being passed to the user fn so
|
|
22
|
-
* side-effects on the cloned argument do not leak back to the bus payload.
|
|
23
|
-
* - The 50ms timeout defangs infinite loops and pathological-regex DoS.
|
|
24
17
|
*/
|
|
25
18
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
/**
|
|
29
|
-
* Globals to shadow when invoking the user filter via `new Function`.
|
|
30
|
-
*
|
|
31
|
-
* - `PARAM_SHADOW_KEYS`: passed as parameter names to `new Function` so they
|
|
32
|
-
* resolve to `undefined` at call time. `"use strict"` forbids `eval`,
|
|
33
|
-
* `arguments`, `Function`, `AsyncFunction` as parameter names — we shadow
|
|
34
|
-
* those via `var`-declared locals inside the function body instead.
|
|
35
|
-
* - `BODY_SHADOW_KEYS`: shadowed via `var X = undefined;` at the top of the
|
|
36
|
-
* body so identifier resolution finds the local before climbing to the
|
|
37
|
-
* global scope. This blocks `eval()`, `Function(...)`, and the
|
|
38
|
-
* constructor-chain escape `payload.constructor.constructor(...)` because
|
|
39
|
-
* the inner `Function` resolves to undefined.
|
|
40
|
-
*
|
|
41
|
-
* STRICTER than `src/workflows/executors/code-match.ts:19-30` because filter
|
|
42
|
-
* strings are higher-volume and authored by less-trusted workflow authors.
|
|
43
|
-
*/
|
|
44
|
-
const PARAM_SHADOW_KEYS = [
|
|
45
|
-
"require",
|
|
46
|
-
"process",
|
|
47
|
-
"Bun",
|
|
48
|
-
"globalThis",
|
|
49
|
-
"global",
|
|
50
|
-
"fetch",
|
|
51
|
-
"setTimeout",
|
|
52
|
-
"setInterval",
|
|
53
|
-
] as const;
|
|
54
|
-
|
|
55
|
-
const PARAM_SHADOW_VALUES = PARAM_SHADOW_KEYS.map(() => undefined);
|
|
56
|
-
|
|
57
|
-
// Identifier names that strict mode reserves as parameter names. Shadowed via
|
|
58
|
-
// `var X = undefined;` declarations at the top of the function body.
|
|
59
|
-
const BODY_SHADOW_KEYS = ["eval", "Function", "AsyncFunction"] as const;
|
|
60
|
-
const BODY_SHADOW_PREAMBLE = BODY_SHADOW_KEYS.map((k) => `var ${k} = undefined;`).join(" ");
|
|
19
|
+
import { checkPredicateSyntax, evaluatePredicate } from "./predicate-sandbox";
|
|
61
20
|
|
|
62
21
|
const FILTER_TIMEOUT_MS = 50;
|
|
63
22
|
|
|
@@ -120,135 +79,21 @@ function matchObjectFilter(payload: unknown, filter: Record<string, unknown>): b
|
|
|
120
79
|
// ─── String-form helpers ────────────────────────────────────
|
|
121
80
|
|
|
122
81
|
/**
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
* Note: this is a soft timeout — a tight CPU-bound loop in the user fn cannot
|
|
126
|
-
* be pre-empted by JS (single-threaded). The cap works because the timeout
|
|
127
|
-
* timer fires AFTER the synchronous fn returns or throws; if the fn never
|
|
128
|
-
* returns we still return `null` to the caller via the race below, but the
|
|
129
|
-
* fn itself keeps running on the event loop until it yields. In practice the
|
|
130
|
-
* sandbox blocks `setTimeout`/`setInterval`/async patterns, so an infinite
|
|
131
|
-
* loop will block the listener until the JIT or GC interrupts it; we accept
|
|
132
|
-
* that bounded risk per the plan's security note. The race ensures we DO NOT
|
|
133
|
-
* propagate a hung promise into the caller.
|
|
82
|
+
* Validate a string filter at executor-init time. Throws if the filter source
|
|
83
|
+
* is too long or does not parse.
|
|
134
84
|
*/
|
|
135
|
-
async function
|
|
136
|
-
return new Promise<T | null>((resolve) => {
|
|
137
|
-
let settled = false;
|
|
138
|
-
const timer = setTimeout(() => {
|
|
139
|
-
if (settled) return;
|
|
140
|
-
settled = true;
|
|
141
|
-
resolve(null);
|
|
142
|
-
}, FILTER_TIMEOUT_MS);
|
|
143
|
-
|
|
144
|
-
// Run synchronously on the next microtask so we can race the timer.
|
|
145
|
-
queueMicrotask(() => {
|
|
146
|
-
if (settled) return;
|
|
147
|
-
try {
|
|
148
|
-
const v = fn();
|
|
149
|
-
// If v is a Promise, the contract says "filters are synchronous":
|
|
150
|
-
// attach a no-op catch IMMEDIATELY (so a sync rejection from inside
|
|
151
|
-
// the user fn doesn't crash the runtime) and resolve to a sentinel
|
|
152
|
-
// that the caller treats as "no-match". We wrap in a marker object
|
|
153
|
-
// so the outer `await` can't unwrap a Thenable for us.
|
|
154
|
-
const then =
|
|
155
|
-
v !== null && typeof v === "object" ? (v as { then?: unknown }).then : undefined;
|
|
156
|
-
if (typeof then === "function") {
|
|
157
|
-
then.call(v, undefined, () => {});
|
|
158
|
-
settled = true;
|
|
159
|
-
clearTimeout(timer);
|
|
160
|
-
resolve({ __asyncRejected: true } as T);
|
|
161
|
-
return;
|
|
162
|
-
}
|
|
163
|
-
if (settled) return;
|
|
164
|
-
settled = true;
|
|
165
|
-
clearTimeout(timer);
|
|
166
|
-
resolve(v);
|
|
167
|
-
} catch {
|
|
168
|
-
if (settled) return;
|
|
169
|
-
settled = true;
|
|
170
|
-
clearTimeout(timer);
|
|
171
|
-
resolve(null);
|
|
172
|
-
}
|
|
173
|
-
});
|
|
174
|
-
});
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
const ASYNC_SENTINEL = "__asyncRejected";
|
|
178
|
-
|
|
179
|
-
function isAsyncSentinel(value: unknown): boolean {
|
|
180
|
-
return (
|
|
181
|
-
value !== null &&
|
|
182
|
-
typeof value === "object" &&
|
|
183
|
-
(value as Record<string, unknown>)[ASYNC_SENTINEL] === true
|
|
184
|
-
);
|
|
185
|
-
}
|
|
186
|
-
|
|
187
|
-
/**
|
|
188
|
-
* Compile and validate a string filter at executor-init time. Throws if the
|
|
189
|
-
* filter does not parse as `(${filter})`. Returns a callable.
|
|
190
|
-
*/
|
|
191
|
-
export function compileStringFilter(filter: string): (payload: unknown) => unknown {
|
|
85
|
+
export async function compileStringFilter(filter: string): Promise<void> {
|
|
192
86
|
// Length cap is enforced by the Zod schema (`.max(2048)`); this is a
|
|
193
87
|
// defense-in-depth check.
|
|
194
88
|
if (filter.length > 2048) {
|
|
195
89
|
throw new Error(`wait filter source exceeds 2KB cap (${filter.length} bytes)`);
|
|
196
90
|
}
|
|
197
|
-
// Compile — surfaces SyntaxError early.
|
|
198
|
-
//
|
|
199
|
-
// We do NOT use `"use strict"` here because strict-mode FORBIDS declaring
|
|
200
|
-
// `eval`, `Function`, etc. as bindings (the very thing we need to do). We
|
|
201
|
-
// use sloppy mode + var-shadowing inside an IIFE-style wrapper so the user
|
|
202
|
-
// fn body sees `eval`, `Function`, `AsyncFunction` (and the param-shadowed
|
|
203
|
-
// `process`, `require`, etc.) as `undefined`.
|
|
204
|
-
//
|
|
205
|
-
// The user's fn itself is wrapped as `(filter)(payload)`. If the user
|
|
206
|
-
// writes their own `"use strict"` directive, it applies only inside the
|
|
207
|
-
// IIFE — that's fine, because by then the shadowed names are already
|
|
208
|
-
// bound to undefined in the enclosing scope.
|
|
209
|
-
let fn: (...args: unknown[]) => unknown;
|
|
210
91
|
try {
|
|
211
|
-
|
|
212
|
-
...PARAM_SHADOW_KEYS,
|
|
213
|
-
"payload",
|
|
214
|
-
`${BODY_SHADOW_PREAMBLE} return (${filter})(payload);`,
|
|
215
|
-
) as (...args: unknown[]) => unknown;
|
|
92
|
+
await checkPredicateSyntax(filter);
|
|
216
93
|
} catch (err) {
|
|
217
94
|
const msg = err instanceof Error ? err.message : String(err);
|
|
218
95
|
throw new Error(`wait filter compile error: ${msg}`);
|
|
219
96
|
}
|
|
220
|
-
return (payload: unknown) => fn(...PARAM_SHADOW_VALUES, payload);
|
|
221
|
-
}
|
|
222
|
-
|
|
223
|
-
// ─── Prototype-stripping helper ─────────────────────────────
|
|
224
|
-
|
|
225
|
-
/**
|
|
226
|
-
* Recursively rebuild `obj` with `null` prototypes on every plain object so
|
|
227
|
-
* the user fn cannot reach the global `Function` constructor via
|
|
228
|
-
* `payload.constructor.constructor(...)`. Arrays keep `Array.prototype` so
|
|
229
|
-
* `.some()`, `.map()`, etc. still work for legitimate predicates — Array's
|
|
230
|
-
* constructor chain still leaks `Function`, but that's a known acceptable
|
|
231
|
-
* trade-off (callers needing array methods accept the residual surface).
|
|
232
|
-
*
|
|
233
|
-
* For deep safety on arrays, callers can use object form filters instead.
|
|
234
|
-
*
|
|
235
|
-
* Returns primitives and arrays unchanged in shape; rebuilds objects.
|
|
236
|
-
*/
|
|
237
|
-
function nullifyPrototypes(value: unknown): unknown {
|
|
238
|
-
if (value === null || typeof value !== "object") return value;
|
|
239
|
-
if (Array.isArray(value)) {
|
|
240
|
-
// Array methods like `.some` are useful for filter authors. Array's
|
|
241
|
-
// constructor IS still reachable via `payload.someArr.constructor`. The
|
|
242
|
-
// fix below also nullifies the per-element objects so most legitimate
|
|
243
|
-
// queries are safe; users who need stricter deep-blocking should use
|
|
244
|
-
// the object-form filter.
|
|
245
|
-
return value.map(nullifyPrototypes);
|
|
246
|
-
}
|
|
247
|
-
const out = Object.create(null) as Record<string, unknown>;
|
|
248
|
-
for (const [k, v] of Object.entries(value)) {
|
|
249
|
-
out[k] = nullifyPrototypes(v);
|
|
250
|
-
}
|
|
251
|
-
return out;
|
|
252
97
|
}
|
|
253
98
|
|
|
254
99
|
// ─── Public matcher ─────────────────────────────────────────
|
|
@@ -270,38 +115,15 @@ export async function matchesFilter(payload: unknown, filter: unknown): Promise<
|
|
|
270
115
|
|
|
271
116
|
// String form.
|
|
272
117
|
if (typeof filter === "string") {
|
|
273
|
-
|
|
118
|
+
if (filter.length > 2048) return false;
|
|
274
119
|
try {
|
|
275
|
-
|
|
120
|
+
const result = await evaluatePredicate(filter, payload, "filter", {
|
|
121
|
+
timeoutMs: FILTER_TIMEOUT_MS,
|
|
122
|
+
});
|
|
123
|
+
return result.ok && result.value;
|
|
276
124
|
} catch {
|
|
277
125
|
return false;
|
|
278
126
|
}
|
|
279
|
-
|
|
280
|
-
// Defensive copy with null-prototype: prevents (a) mutation leaking back
|
|
281
|
-
// to the bus payload, and (b) the `payload.constructor.constructor`
|
|
282
|
-
// escape from reaching the global Function constructor through the
|
|
283
|
-
// prototype chain.
|
|
284
|
-
let cloned: unknown;
|
|
285
|
-
try {
|
|
286
|
-
const cloneOnce = structuredClone(payload);
|
|
287
|
-
cloned = nullifyPrototypes(cloneOnce);
|
|
288
|
-
} catch {
|
|
289
|
-
// Some payloads (functions, symbols) cannot be structuredClone'd —
|
|
290
|
-
// fall back to the raw payload but still apply nullifyPrototypes if
|
|
291
|
-
// possible.
|
|
292
|
-
try {
|
|
293
|
-
cloned = nullifyPrototypes(payload);
|
|
294
|
-
} catch {
|
|
295
|
-
cloned = payload;
|
|
296
|
-
}
|
|
297
|
-
}
|
|
298
|
-
|
|
299
|
-
const result = await runWithTimeout(() => userFn(cloned));
|
|
300
|
-
if (result === null) return false; // timeout / throw
|
|
301
|
-
// The runWithTimeout helper substitutes a sentinel for Promise returns
|
|
302
|
-
// (filters are synchronous by contract — async predicates → no-match).
|
|
303
|
-
if (isAsyncSentinel(result)) return false;
|
|
304
|
-
return !!result;
|
|
305
127
|
}
|
|
306
128
|
|
|
307
129
|
// Anything else (array, number, etc.) → no match.
|
package/src/x/composio.ts
CHANGED
|
@@ -86,6 +86,7 @@ export function parseComposioArgs(
|
|
|
86
86
|
if ((method === "GET" || method === "HEAD") && parsed.body !== undefined) {
|
|
87
87
|
throw new Error(`${method} requests cannot include --body`);
|
|
88
88
|
}
|
|
89
|
+
buildComposioUrl(parsed.baseUrl, parsed.endpoint, []);
|
|
89
90
|
|
|
90
91
|
return parsed;
|
|
91
92
|
}
|
|
@@ -131,6 +132,8 @@ export async function executeComposioRequest(
|
|
|
131
132
|
body: args.body === undefined ? undefined : JSON.stringify(args.body),
|
|
132
133
|
headers,
|
|
133
134
|
method: args.method,
|
|
135
|
+
// A redirect would carry the key header to the new host.
|
|
136
|
+
redirect: "manual",
|
|
134
137
|
});
|
|
135
138
|
} catch (err) {
|
|
136
139
|
return {
|
|
@@ -183,9 +186,11 @@ export function composioArgsFromParts(input: {
|
|
|
183
186
|
throw new Error(`${method} requests cannot include a body`);
|
|
184
187
|
}
|
|
185
188
|
assertRelativeComposioPath(input.endpoint);
|
|
189
|
+
const baseUrl = input.baseUrl || process.env.COMPOSIO_BASE_URL || DEFAULT_COMPOSIO_BASE_URL;
|
|
190
|
+
buildComposioUrl(baseUrl, input.endpoint, []);
|
|
186
191
|
|
|
187
192
|
return {
|
|
188
|
-
baseUrl
|
|
193
|
+
baseUrl,
|
|
189
194
|
body: input.body,
|
|
190
195
|
endpoint: input.endpoint,
|
|
191
196
|
headers: input.headers ?? {},
|
|
@@ -228,6 +233,10 @@ function buildComposioUrl(
|
|
|
228
233
|
const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
|
|
229
234
|
const cleanEndpoint = endpoint.replace(/^\/+/, "");
|
|
230
235
|
const url = new URL(cleanEndpoint, normalizedBase);
|
|
236
|
+
// The key header is bound to the base URL's host: a path must not change it.
|
|
237
|
+
if (url.origin !== new URL(normalizedBase).origin) {
|
|
238
|
+
throw new Error("endpoint must be a Composio API path on the configured base URL");
|
|
239
|
+
}
|
|
231
240
|
for (const [key, value] of query) {
|
|
232
241
|
url.searchParams.append(key, value);
|
|
233
242
|
}
|
|
@@ -34,6 +34,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
|
|
|
34
34
|
|
|
35
35
|
For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
|
|
36
36
|
|
|
37
|
+
When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
|
|
38
|
+
|
|
37
39
|
`app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
|
|
38
40
|
|
|
39
41
|
### Reading an app's callable surface
|
|
@@ -179,7 +181,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
|
|
|
179
181
|
|
|
180
182
|
Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
|
|
181
183
|
|
|
182
|
-
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-
|
|
184
|
+
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
|
|
183
185
|
|
|
184
186
|
### Reusable elements
|
|
185
187
|
|
|
@@ -411,7 +413,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
|
|
|
411
413
|
|
|
412
414
|
For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
|
|
413
415
|
|
|
414
|
-
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
416
|
+
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
415
417
|
|
|
416
418
|
### Pages, routes, and page trees
|
|
417
419
|
|
|
@@ -29,6 +29,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
|
|
|
29
29
|
|
|
30
30
|
For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
|
|
31
31
|
|
|
32
|
+
When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
|
|
33
|
+
|
|
32
34
|
`app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
|
|
33
35
|
|
|
34
36
|
### Reading an app's callable surface
|
|
@@ -174,7 +176,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
|
|
|
174
176
|
|
|
175
177
|
Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
|
|
176
178
|
|
|
177
|
-
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-
|
|
179
|
+
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
|
|
178
180
|
|
|
179
181
|
### Reusable elements
|
|
180
182
|
|
|
@@ -406,7 +408,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
|
|
|
406
408
|
|
|
407
409
|
For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
|
|
408
410
|
|
|
409
|
-
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
411
|
+
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
410
412
|
|
|
411
413
|
### Pages, routes, and page trees
|
|
412
414
|
|
|
@@ -17,7 +17,7 @@ The task's `vcsProvider` field or the remote URL tells you the provider.
|
|
|
17
17
|
|
|
18
18
|
## Before you push
|
|
19
19
|
|
|
20
|
-
1. Run every command in the Repository Guidelines section "PR Checks" of your system prompt, one after the other. When no guidelines exist, run the checklist in the repo's CLAUDE.md. When neither exists, ask the lead before you push.
|
|
20
|
+
1. Run every command in the Repository Guidelines section "PR Checks" of your system prompt, one after the other. Follow each check's own scope: a check the guidelines run once before the PR opens does not rerun on later fix pushes. When no guidelines exist, run the checklist in the repo's CLAUDE.md. When neither exists, ask the lead before you push.
|
|
21
21
|
2. A failing check: fix the cause and run the check again. Push only when every check passes.
|
|
22
22
|
3. Git hooks stay on. `--no-verify` and any other bypass flag are out.
|
|
23
23
|
4. `main` and `master` are never force-pushed.
|
|
@@ -38,9 +38,9 @@ A workflow or task brief that opens a PR names this section instead of restating
|
|
|
38
38
|
|
|
39
39
|
## After you open a PR
|
|
40
40
|
|
|
41
|
-
1.
|
|
42
|
-
2.
|
|
43
|
-
3.
|
|
41
|
+
1. Put the PR URL and the head SHA in your task output.
|
|
42
|
+
2. When the Repository Guidelines or a repo skill say the deployment handles red CI, review rounds and merge-queue ejections with workflows, your task ends here. Do not wait for CI: no `gh pr checks --watch`, `gh run watch` or sleep loops. A red check or a review round comes back to you as a new task.
|
|
43
|
+
3. Otherwise, wait about 30 seconds, then read CI: `gh pr checks <number>` or `glab mr view --json pipelines`. Red CI: read the failing job, fix, push, read CI again. Repeat until green, and put the CI status in your task output.
|
|
44
44
|
|
|
45
45
|
## Merge policy
|
|
46
46
|
|
|
@@ -9,6 +9,7 @@ Lead only. The heartbeat runbook is your `heartbeatMd` profile field. The server
|
|
|
9
9
|
- After a server restart: a `boot-triage` task arrives about 90 seconds later, only when the restart cut off work or left failures, orphans or superseded tasks to check. A clean boot creates none.
|
|
10
10
|
- The system status is gathered for you. You never create a checklist or boot-triage task yourself.
|
|
11
11
|
- The runbook text is part of every checklist task prompt. Every line you keep costs tokens on every tick.
|
|
12
|
+
- A heartbeat cut off mid-run (graceful shutdown, restart) leaves a superseded row and a resume task that re-reads all live state. Checkpoint as you go: after each runbook section you finish, `store-progress` the sections done and the PR refs you verified. On a resume, read that checkpoint first and skip the sections it names.
|
|
12
13
|
|
|
13
14
|
Edit the runbook with a native Edit of its mirror `/workspace/HEARTBEAT.md`. The PostToolUse hook PUTs the file to the `heartbeatMd` field. An edit to any of the four mirrors (`SOUL.md`, `IDENTITY.md`, `TOOLS.md`, `HEARTBEAT.md`) PUTs all four, so an `update-profile` write to `heartbeatMd` is overwritten by the stale mirror the next time you edit one of them in the same session. The hook logs a refused write (for example a 400 from the tracked-item date check) to stderr only, so verify every edit by DB anchor: `SELECT instr(heartbeatMd, '<fragment of the new line>') FROM agents WHERE id = '<your agent id>'`. A 0 means the write was refused: PUT `{"heartbeatMd": <file text>}` to `$MCP_BASE_URL/api/agents/$AGENT_ID/profile` with `Authorization: Bearer $API_KEY` and `X-Agent-ID: $AGENT_ID` to read the error, fix the line, and re-check.
|
|
14
15
|
|
|
@@ -7,6 +7,8 @@ description: Guardrails for polling, scheduled jobs, and long-running external o
|
|
|
7
7
|
|
|
8
8
|
Use these rules whenever a scheduled or regular task polls or waits on a long-running operation. They prevent heartbeat collisions, lost work, duplicate delivery, and sessions that fail after holding an external job open too long.
|
|
9
9
|
|
|
10
|
+
Before you poll a pull request's CI at all, check whether you need to. When the Repository Guidelines or a repo skill say workflows handle red CI, review rounds and merge-queue ejections, end the task at push instead (`code-quality`, "After you open a PR"). The rules below cover the waits that remain.
|
|
11
|
+
|
|
10
12
|
## Rule 1 — Never use `ScheduleWakeup` with `delaySeconds >= 300`
|
|
11
13
|
|
|
12
14
|
The runtime heartbeat staleness threshold may sit near the same window as the model prompt-cache TTL. Sleeping for five minutes or longer can therefore look like a dead worker and cause the heartbeat sweep to fail the task mid-poll.
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
Use these rules whenever a scheduled or regular task polls or waits on a long-running operation. They prevent heartbeat collisions, lost work, duplicate delivery, and sessions that fail after holding an external job open too long.
|
|
4
4
|
|
|
5
|
+
Before you poll a pull request's CI at all, check whether you need to. When the Repository Guidelines or a repo skill say workflows handle red CI, review rounds and merge-queue ejections, end the task at push instead (`code-quality`, "After you open a PR"). The rules below cover the waits that remain.
|
|
6
|
+
|
|
5
7
|
## Rule 1 — Never use `ScheduleWakeup` with `delaySeconds >= 300`
|
|
6
8
|
|
|
7
9
|
The runtime heartbeat staleness threshold may sit near the same window as the model prompt-cache TTL. Sleeping for five minutes or longer can therefore look like a dead worker and cause the heartbeat sweep to fail the task mid-poll.
|
|
@@ -37,6 +37,10 @@ The task carries `slackChannelId` and `slackThreadTs` in its metadata. A follow-
|
|
|
37
37
|
|
|
38
38
|
Files attached to your task already come with download commands in the task message. Use those before `slack-download-file`. `slack-read` on your task also attaches the files in the thread and gives each one a `fetchCommand`. Don't look for Slack files under `/app/shared` or `/workspace/shared/downloads`: those paths are the API server's disk.
|
|
39
39
|
|
|
40
|
+
### Bulk history (lead)
|
|
41
|
+
|
|
42
|
+
`slack-read` returns at most 100 messages of a thread or a channel, with no cursor. A worker that needs more than that asks the lead; it never reads channel history around `slack-read`. As the lead, first call `slack-read` with the `channelId`: if it refuses the channel (permission, external or unverified), stop there. Only after it succeeds, for the full history, page the Slack Web API from a script, with the bot token through a script credential binding: `conversations.history` with the channel id, following `response_metadata.next_cursor` until it is empty. Write the collected messages to a file, not into a message or the task output.
|
|
43
|
+
|
|
40
44
|
## Message limits
|
|
41
45
|
|
|
42
46
|
- Text sent without `blocks` is split into sections under Slack's 3,000-character section limit for you. With explicit `blocks`, keep each section's text at or under 3,000 characters yourself.
|
|
@@ -71,6 +71,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
71
71
|
- [Reviewing purchase order and supplier confirmation differences with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-order-confirmation-review). Reference.
|
|
72
72
|
- [Reviewing marketplace partner payout discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-payout-exception-review). Reference.
|
|
73
73
|
- [Preparing marketplace moderation appeals for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-moderation-appeals). Reference.
|
|
74
|
+
- [Preparing a suspected marketplace fraud alert for human investigation with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-fraud-alert-investigation). Reference.
|
|
74
75
|
- [Reviewing customer billing disputes with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-billing-dispute-review). Reference.
|
|
75
76
|
- [Preparing unmatched bank transactions for finance review with AI agents](https://docs.agent-swarm.dev/docs/guides/agent-assisted-bank-reconciliation-review). Reference.
|
|
76
77
|
- [Reviewing a proposed customer pricing change with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-pricing-change-review). Reference.
|
|
@@ -87,10 +88,14 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
87
88
|
- [Coordinating a guest accessibility request between guest support and property operations with AI agents](https://docs.agent-swarm.dev/docs/guides/guest-accessibility-request-handoff). Reference.
|
|
88
89
|
- [Reviewing supplier performance across delivery, quality and service records with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-performance-review). Reference.
|
|
89
90
|
- [Reviewing a supplier ingredient specification change with AI agents](https://docs.agent-swarm.dev/docs/guides/food-supplier-ingredient-change-review). Reference.
|
|
91
|
+
- [Preparing a batch traceability packet for a mock recall with AI agents](https://docs.agent-swarm.dev/docs/guides/food-batch-traceability-exercise). Reference.
|
|
90
92
|
- [Preparing a bid or no-bid review for an incoming RFP with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-rfp-bid-qualification). Reference.
|
|
93
|
+
- [Reviewing why sales opportunities were won or lost with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-win-loss-review). Reference.
|
|
91
94
|
- [Preparing contractor credential expiry checks for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/contractor-license-expiry-review). Reference.
|
|
92
95
|
- [Coordinating a departing employee's access review across HR and IT with AI agents](https://docs.agent-swarm.dev/docs/guides/employee-offboarding-access-review). Reference.
|
|
96
|
+
- [Preparing workforce training completion evidence for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-training-completion-evidence-review). Reference.
|
|
93
97
|
- [Briefing sales and leadership on competitor changes with AI agents](https://docs.agent-swarm.dev/docs/guides/competitor-change-brief). Reference.
|
|
98
|
+
- [Preparing a business continuity tabletop exercise with AI agents](https://docs.agent-swarm.dev/docs/guides/business-continuity-tabletop-preparation). Reference.
|
|
94
99
|
- [Deployment Guide](https://docs.agent-swarm.dev/docs/guides/deployment). When: Someone wants to run Agent Swarm on their own server with Docker Compose.
|
|
95
100
|
- [One-click deploy](https://docs.agent-swarm.dev/docs/guides/one-click-deploy). When: Someone has no server yet and wants Agent Swarm running in the cloud with HTTPS.
|
|
96
101
|
- [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
|
|
@@ -101,6 +106,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
101
106
|
- [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
|
|
102
107
|
- [agent-fs Co-deployment](https://docs.agent-swarm.dev/docs/guides/agent-fs-co-deployment). When: Someone wants shared persistent files for agents on a self-hosted swarm.
|
|
103
108
|
- [Self-Hosted SSO](https://docs.agent-swarm.dev/docs/guides/self-hosted-sso). When: Someone wants their self-hosted swarm dashboard behind single sign-on.
|
|
109
|
+
- [Reviewing why actual demand differed from a forecast with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-demand-forecast-accuracy-review). Reference.
|
|
104
110
|
- [AI operations governance for small companies](https://docs.agent-swarm.dev/docs/guides/ai-operations-governance). Reference.
|
|
105
111
|
- [Repo merge policy](https://docs.agent-swarm.dev/docs/guides/repo-merge-policy). Reference.
|
|
106
112
|
- [E2B Provider Smoke Tests](https://docs.agent-swarm.dev/docs/guides/e2b-provider-smoke-tests). Reference.
|
|
@@ -111,6 +117,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
111
117
|
- [Provider Capability Matrix](https://docs.agent-swarm.dev/docs/guides/provider-capability-matrix). Reference.
|
|
112
118
|
- [Adding a Harness Provider](https://docs.agent-swarm.dev/docs/guides/harness-providers). Reference.
|
|
113
119
|
- [Steer a Running Task](https://docs.agent-swarm.dev/docs/guides/task-steering). Reference.
|
|
120
|
+
- [Connect Your AI Client with the User MCP](https://docs.agent-swarm.dev/docs/guides/user-mcp). When: Someone wants to send or check swarm tasks from ChatGPT, Claude, Codex, Cursor or another AI assistant they already use.
|
|
114
121
|
- [MCP Events on the User MCP](https://docs.agent-swarm.dev/docs/guides/mcp-events). Reference.
|
|
115
122
|
- [Claude Code Mod](https://docs.agent-swarm.dev/docs/guides/claude-code-mod). Reference.
|
|
116
123
|
- [Observability with OpenTelemetry](https://docs.agent-swarm.dev/docs/guides/observability-opentelemetry). When: Someone wants swarm traces and metrics in SigNoz or another OpenTelemetry backend.
|
|
@@ -143,6 +150,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
143
150
|
- [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
|
|
144
151
|
- [boxd runtime provider](https://docs.agent-swarm.dev/docs/guides/boxd-runtime-provider). Reference.
|
|
145
152
|
- [Coordinating delivery delay investigations between operations and support with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-delivery-delay-handoff). Reference.
|
|
153
|
+
- [Investigating a payroll discrepancy for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-payroll-discrepancy-review). Reference.
|
|
146
154
|
- [Preparing a service capacity planning brief with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-service-capacity-planning). Reference.
|
|
147
155
|
- [Preparing a property maintenance request for human triage with AI agents](https://docs.agent-swarm.dev/docs/guides/maintenance-work-order-triage). Reference.
|
|
148
156
|
- [Reviewing customer help content for conflicts with AI agents](https://docs.agent-swarm.dev/docs/guides/support-knowledge-conflict-review). Reference.
|
|
@@ -101,6 +101,7 @@ The route runs the same typecheck and scope rules as the tool.
|
|
|
101
101
|
- `ctx.stdlib`: `fetch`, `fetchJson` (retries, 30 s timeout), `grep`, `glob`, `table`, `retry`, `Redacted`.
|
|
102
102
|
- Retries: `ctx.swarm` calls retry a 429 on any call, and a 502/503/504 or network error on reads and on writes that send an idempotency key (such as `workflow_trigger` with `idempotencyKey`), within about 5 s. `ctx.stdlib.fetch` retries a 429 on any method and a 502/503/504 or network error on GET, HEAD, OPTIONS, PUT and DELETE. A POST or PATCH retries those only with an `Idempotency-Key` header: pass `retry: { idempotencyKey: true }` to send one UUID on every attempt. The key prevents a duplicate only when the server dedupes by it. `retry: false` makes one attempt. Wrap anything else, sync or async, in `ctx.stdlib.retry(fn, { retries, minDelayMs, maxDelayMs, budgetMs, retryOn })`; it rethrows the last error or returns the last result when attempts run out.
|
|
103
103
|
- `ctx.logger`: `log`, `warn`, `error`. Keep logs short.
|
|
104
|
+
- `ctx.caller`: who started this run. `{ kind: "agent", agentId }` for a direct call, `{ kind: "script", agentId }` for a call from another script. Frozen.
|
|
104
105
|
|
|
105
106
|
### Files and shell
|
|
106
107
|
|
|
@@ -126,6 +127,49 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
|
|
|
126
127
|
- Each `ctx.step.agentTask` step is a normal worker task (`taskType: "script-run-step"`). When it finishes, the lead gets the usual "Worker task completed — review needed" follow-up, even while the run is still awaiting that step. The step config has no `followUpConfig` field, so a value passed there is dropped. Let the script's own judge step be the gate and close those follow-ups with a one-line accept.
|
|
127
128
|
- When a crash supersedes an in-flight step and resumes it as a new task, the run does not follow the new task id: it can stay `failed` (for example `write EPIPE`) while the resumed task completes. Check the resumed task's output before you re-launch the run.
|
|
128
129
|
|
|
130
|
+
### Durable objects
|
|
131
|
+
|
|
132
|
+
A durable object is a named instance of a global script class. Each instance keeps its own JSON state between calls. Only one call runs on an instance at a time, so you do not need your own KV locks.
|
|
133
|
+
|
|
134
|
+
```ts
|
|
135
|
+
import { DurableObject } from "swarm-sdk";
|
|
136
|
+
|
|
137
|
+
export default class Counter extends DurableObject<{ n: number }> {
|
|
138
|
+
initialState() { return { n: 0 }; }
|
|
139
|
+
async add(args: { by: number }) { this.state.n += args.by; return this.state.n; }
|
|
140
|
+
}
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Save it with `script_upsert` in `scope: "global"`. The API refuses a DurableObject class in agent scope and in an inline `script_run`. Call one instance by id:
|
|
144
|
+
|
|
145
|
+
```ts
|
|
146
|
+
script_run({ name: "counter", object: { id: "team-a", method: "add" }, args: { by: 2 } })
|
|
147
|
+
// → result: 2, object: { id: "team-a", stateVersion: 1, destroyed: false }
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
- **Methods**: each callable method takes `(args, ctx)` and returns a JSON value. You cannot call `constructor`, `initialState`, `migrate`, `destroy`, a name that starts with `_`, a static method, a getter or an arrow-function field. The API refuses such a call before it runs any code.
|
|
151
|
+
- **First call**: an id with no state starts from `initialState()`.
|
|
152
|
+
- **State rules**:
|
|
153
|
+
- `this.state` must be JSON, at most 2 MiB.
|
|
154
|
+
- The API saves it only when the method returns without an error. A thrown error keeps the old state.
|
|
155
|
+
- The API saves `this.state` as it is when the method returns. A change made later, by work the method did not await, is lost.
|
|
156
|
+
- **Versions**: every call runs the latest saved version of the script. When the stored state comes from an older version, `migrate(state, fromVersion)` runs once before the method, if you define it.
|
|
157
|
+
- **Destroy**: `this.destroy()` deletes the state when the method returns. The next call on that id starts again from `initialState()`.
|
|
158
|
+
- **Idle expiry**: `static idleTtlSec = 3600` deletes the state after 1 hour with no call. Without it, state is kept until `destroy()`.
|
|
159
|
+
- **Read the state**: `kv_get({ namespace: "durable:<scriptId>", key: "state/<id>" })` returns `{ codeVersion, stateVersion, state }`, with secrets scrubbed. KV writes on a `durable:` namespace are refused. Change state only through a method.
|
|
160
|
+
- **Errors**:
|
|
161
|
+
- `object busy` (409): another call held the instance for 30 s (5 s for a call from a script). Retry the call later. Do not loop.
|
|
162
|
+
- `already in this call chain` (409): a method called its own instance, directly or through other scripts. Restructure the call. Do not retry.
|
|
163
|
+
- `call depth exceeds 16` (400): a chain of nested script runs is too deep.
|
|
164
|
+
|
|
165
|
+
| Cloudflare Durable Objects | Swarm durable objects |
|
|
166
|
+
|---|---|
|
|
167
|
+
| `this.ctx.storage` key-value API | One JSON `this.state` snapshot per instance |
|
|
168
|
+
| `fetch()` and RPC from a Worker | `script_run` with `object: { id, method }` |
|
|
169
|
+
| `env` bindings | `ctx` (the same `ctx` as other scripts), passed to each method |
|
|
170
|
+
| Alarms | Not available yet |
|
|
171
|
+
| Methods take any arguments | Methods take `(args, ctx)` |
|
|
172
|
+
|
|
129
173
|
## Inline script pattern
|
|
130
174
|
|
|
131
175
|
```typescript
|
|
@@ -96,6 +96,7 @@ The route runs the same typecheck and scope rules as the tool.
|
|
|
96
96
|
- `ctx.stdlib`: `fetch`, `fetchJson` (retries, 30 s timeout), `grep`, `glob`, `table`, `retry`, `Redacted`.
|
|
97
97
|
- Retries: `ctx.swarm` calls retry a 429 on any call, and a 502/503/504 or network error on reads and on writes that send an idempotency key (such as `workflow_trigger` with `idempotencyKey`), within about 5 s. `ctx.stdlib.fetch` retries a 429 on any method and a 502/503/504 or network error on GET, HEAD, OPTIONS, PUT and DELETE. A POST or PATCH retries those only with an `Idempotency-Key` header: pass `retry: { idempotencyKey: true }` to send one UUID on every attempt. The key prevents a duplicate only when the server dedupes by it. `retry: false` makes one attempt. Wrap anything else, sync or async, in `ctx.stdlib.retry(fn, { retries, minDelayMs, maxDelayMs, budgetMs, retryOn })`; it rethrows the last error or returns the last result when attempts run out.
|
|
98
98
|
- `ctx.logger`: `log`, `warn`, `error`. Keep logs short.
|
|
99
|
+
- `ctx.caller`: who started this run. `{ kind: "agent", agentId }` for a direct call, `{ kind: "script", agentId }` for a call from another script. Frozen.
|
|
99
100
|
|
|
100
101
|
### Files and shell
|
|
101
102
|
|
|
@@ -121,6 +122,49 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
|
|
|
121
122
|
- Each `ctx.step.agentTask` step is a normal worker task (`taskType: "script-run-step"`). When it finishes, the lead gets the usual "Worker task completed — review needed" follow-up, even while the run is still awaiting that step. The step config has no `followUpConfig` field, so a value passed there is dropped. Let the script's own judge step be the gate and close those follow-ups with a one-line accept.
|
|
122
123
|
- When a crash supersedes an in-flight step and resumes it as a new task, the run does not follow the new task id: it can stay `failed` (for example `write EPIPE`) while the resumed task completes. Check the resumed task's output before you re-launch the run.
|
|
123
124
|
|
|
125
|
+
### Durable objects
|
|
126
|
+
|
|
127
|
+
A durable object is a named instance of a global script class. Each instance keeps its own JSON state between calls. Only one call runs on an instance at a time, so you do not need your own KV locks.
|
|
128
|
+
|
|
129
|
+
```ts
|
|
130
|
+
import { DurableObject } from "swarm-sdk";
|
|
131
|
+
|
|
132
|
+
export default class Counter extends DurableObject<{ n: number }> {
|
|
133
|
+
initialState() { return { n: 0 }; }
|
|
134
|
+
async add(args: { by: number }) { this.state.n += args.by; return this.state.n; }
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Save it with `script_upsert` in `scope: "global"`. The API refuses a DurableObject class in agent scope and in an inline `script_run`. Call one instance by id:
|
|
139
|
+
|
|
140
|
+
```ts
|
|
141
|
+
script_run({ name: "counter", object: { id: "team-a", method: "add" }, args: { by: 2 } })
|
|
142
|
+
// → result: 2, object: { id: "team-a", stateVersion: 1, destroyed: false }
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
- **Methods**: each callable method takes `(args, ctx)` and returns a JSON value. You cannot call `constructor`, `initialState`, `migrate`, `destroy`, a name that starts with `_`, a static method, a getter or an arrow-function field. The API refuses such a call before it runs any code.
|
|
146
|
+
- **First call**: an id with no state starts from `initialState()`.
|
|
147
|
+
- **State rules**:
|
|
148
|
+
- `this.state` must be JSON, at most 2 MiB.
|
|
149
|
+
- The API saves it only when the method returns without an error. A thrown error keeps the old state.
|
|
150
|
+
- The API saves `this.state` as it is when the method returns. A change made later, by work the method did not await, is lost.
|
|
151
|
+
- **Versions**: every call runs the latest saved version of the script. When the stored state comes from an older version, `migrate(state, fromVersion)` runs once before the method, if you define it.
|
|
152
|
+
- **Destroy**: `this.destroy()` deletes the state when the method returns. The next call on that id starts again from `initialState()`.
|
|
153
|
+
- **Idle expiry**: `static idleTtlSec = 3600` deletes the state after 1 hour with no call. Without it, state is kept until `destroy()`.
|
|
154
|
+
- **Read the state**: `kv_get({ namespace: "durable:<scriptId>", key: "state/<id>" })` returns `{ codeVersion, stateVersion, state }`, with secrets scrubbed. KV writes on a `durable:` namespace are refused. Change state only through a method.
|
|
155
|
+
- **Errors**:
|
|
156
|
+
- `object busy` (409): another call held the instance for 30 s (5 s for a call from a script). Retry the call later. Do not loop.
|
|
157
|
+
- `already in this call chain` (409): a method called its own instance, directly or through other scripts. Restructure the call. Do not retry.
|
|
158
|
+
- `call depth exceeds 16` (400): a chain of nested script runs is too deep.
|
|
159
|
+
|
|
160
|
+
| Cloudflare Durable Objects | Swarm durable objects |
|
|
161
|
+
|---|---|
|
|
162
|
+
| `this.ctx.storage` key-value API | One JSON `this.state` snapshot per instance |
|
|
163
|
+
| `fetch()` and RPC from a Worker | `script_run` with `object: { id, method }` |
|
|
164
|
+
| `env` bindings | `ctx` (the same `ctx` as other scripts), passed to each method |
|
|
165
|
+
| Alarms | Not available yet |
|
|
166
|
+
| Methods take any arguments | Methods take `(args, ctx)` |
|
|
167
|
+
|
|
124
168
|
## Inline script pattern
|
|
125
169
|
|
|
126
170
|
```typescript
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
ACPAdapter2
|
|
3
|
-
} from "./cli-887vhew6.js";
|
|
4
|
-
import"./cli-0qt3epg4.js";
|
|
5
|
-
import"./cli-f7b9nyvk.js";
|
|
6
|
-
import"./cli-prz1p3ft.js";
|
|
7
|
-
import"./cli-1jq2em7b.js";
|
|
8
|
-
import"./cli-k0nebh10.js";
|
|
9
|
-
import"./cli-0h8skzss.js";
|
|
10
|
-
import"./cli-srre41gb.js";
|
|
11
|
-
import"./cli-0726awxw.js";
|
|
12
|
-
import"./cli-zntvmqmm.js";
|
|
13
|
-
import"./cli-9n6g14vs.js";
|
|
14
|
-
import"./cli-ywy8yz6t.js";
|
|
15
|
-
export {
|
|
16
|
-
ACPAdapter2 as ACPAdapter
|
|
17
|
-
};
|