@desplega.ai/agent-swarm 2.13.4 → 2.14.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-99n6z9ky.js +17 -0
- package/dist/{acp-targets-zrk9k0n7.js → acp-targets-23exz4z4.js} +10 -10
- package/dist/{actions-acqqj9jn.js → actions-zcr25x27.js} +61 -40
- package/dist/{agent-fs-provision-zmaykqnd.js → agent-fs-provision-7fa9e12e.js} +4 -4
- package/dist/{amp-adapter-a7ts8tmw.js → amp-adapter-s7ytmv6b.js} +3 -3
- package/dist/{anthropic-messages-88b7s3n9.js → anthropic-messages-vdd1zmha.js} +10 -10
- package/dist/{app-tmwa442h.js → app-5d3sz1hy.js} +7 -7
- package/dist/{approval-notifications-6psaaaye.js → approval-notifications-7qgkzkzx.js} +8 -8
- package/dist/{assistant-564v6emv.js → assistant-p2yvhc3j.js} +37 -32
- package/dist/{boot-args-schema-n099e0f2.js → boot-args-schema-ry6cb0p7.js} +1 -1
- package/dist/{boot-reembed-epvg4fp9.js → boot-reembed-2hkm3vz2.js} +1 -1
- package/dist/{boot-reembed-chx66qfk.js → boot-reembed-c9643ms3.js} +1 -1
- package/dist/{boot-scrub-sweep-dhkfp0a7.js → boot-scrub-sweep-3ycxr51t.js} +2 -2
- package/dist/{boot-seeds-m74fc07r.js → boot-seeds-2hzvvzg0.js} +4 -4
- package/dist/{boxd-451q55ys.js → boxd-9py3x0jb.js} +2 -2
- package/dist/{claude-adapter-hw63yj3j.js → claude-adapter-dnkww93e.js} +9 -9
- package/dist/{claude-managed-adapter-z5s7fx6p.js → claude-managed-adapter-yk0cr5x6.js} +4 -4
- package/dist/{claude-managed-setup-wee1762m.js → claude-managed-setup-4byxpp47.js} +5 -5
- package/dist/{claude-sdk-session-cktyqkpk.js → claude-sdk-session-4wf3dbvs.js} +13163 -12195
- package/dist/{cli-5rxsb3wq.js → cli-096aftq6.js} +12 -7
- package/dist/{cli-5rgm8p39.js → cli-0e914dp9.js} +3 -3
- package/dist/{cli-bzcwwebm.js → cli-0h6m6z5g.js} +1 -1
- package/dist/{cli-cah298e5.js → cli-0k7ppk9k.js} +231 -124
- package/dist/{cli-ja450998.js → cli-1nfabrt4.js} +8 -8
- package/dist/{cli-jzerrzgc.js → cli-2414h5r9.js} +8 -8
- package/dist/{cli-b768ek79.js → cli-24wervhz.js} +38 -0
- package/dist/{cli-93n305hm.js → cli-2ayk9gn8.js} +2 -2
- package/dist/{cli-kr0jpw9c.js → cli-2ckwgs7q.js} +1 -1
- package/dist/{cli-d5pc8ep0.js → cli-2savn6mm.js} +11 -100
- package/dist/{cli-jbrc98qb.js → cli-2zjxake1.js} +4 -4
- package/dist/{cli-4q2c8rxw.js → cli-37p61fcg.js} +15 -9
- package/dist/{cli-2vp0z049.js → cli-39t9d248.js} +1 -1
- package/dist/{cli-sa02jsqt.js → cli-3mhdmcd4.js} +1 -1
- package/dist/{cli-x2cem5vy.js → cli-3wsabyt0.js} +2 -2
- package/dist/{cli-dqgnbnxs.js → cli-466jjrwe.js} +16 -2
- package/dist/{cli-zhwjdhjr.js → cli-6ajyhxh7.js} +2 -2
- package/dist/{cli-3bxrrh53.js → cli-6yy4fepf.js} +4 -4
- package/dist/{cli-hhtbandk.js → cli-73rmgm45.js} +2 -2
- package/dist/{cli-8b4rpnwj.js → cli-7ca8hczj.js} +1 -1
- package/dist/{cli-0h8skzss.js → cli-7g5qj2ca.js} +4 -3
- package/dist/{cli-m1sns1da.js → cli-7w1fs01q.js} +2 -2
- package/dist/{cli-xwsm6xkr.js → cli-84wxwt3z.js} +1 -1
- package/dist/{cli-qzz6tz8s.js → cli-84xn7bgz.js} +1 -1
- package/dist/{cli-49aq3cyn.js → cli-879txsac.js} +5 -5
- package/dist/{cli-bv4vvnmg.js → cli-8vbxjzk0.js} +3 -3
- package/dist/{cli-7by7vp6m.js → cli-91amj3md.js} +3 -3
- package/dist/{cli-60dwk8tx.js → cli-930zbczq.js} +3 -3
- package/dist/{cli-7g3fg4gf.js → cli-9fwznq4p.js} +10 -10
- package/dist/{cli-4pbwg7sn.js → cli-9j1t3kf6.js} +2 -2
- package/dist/{cli-tzw1jr2t.js → cli-9j47sgzy.js} +2 -2
- package/dist/{cli-0fgvnb0x.js → cli-ad00h1st.js} +7 -7
- package/dist/{cli-kj84fqxz.js → cli-adzmmcvf.js} +19 -7
- package/dist/{cli-3tzmh38q.js → cli-ayxxkk3p.js} +68 -25
- package/dist/{cli-4vynxtrb.js → cli-bqfx72e6.js} +10 -3
- package/dist/{cli-8cas2xvp.js → cli-cbg0j1yt.js} +2716 -2643
- package/dist/{cli-fw67mnyc.js → cli-cg1q8ymp.js} +1 -1
- package/dist/{cli-he5nxaa8.js → cli-dw9rtjm3.js} +1 -1
- package/dist/{cli-jg5txpm6.js → cli-dy754erz.js} +83 -1
- package/dist/{cli-tsc3pdfd.js → cli-edxfzgah.js} +4 -4
- package/dist/{cli-hyqksecw.js → cli-ejnhs815.js} +15 -15
- package/dist/{cli-k0nebh10.js → cli-enavhq6r.js} +1 -1
- package/dist/{cli-ea7nz50q.js → cli-f2rwt43y.js} +14 -14
- package/dist/{cli-zjdhrzm0.js → cli-f9g96z28.js} +8 -8
- package/dist/{cli-rmgvwcmy.js → cli-fww016hh.js} +534 -70
- package/dist/{cli-rv3y60bt.js → cli-g6a696c0.js} +4 -4
- package/dist/{cli-z1vam71h.js → cli-gc6b94tj.js} +2 -2
- package/dist/{cli-p436yrzp.js → cli-gcyws2bp.js} +2 -2
- package/dist/{cli-srktrbby.js → cli-hzhv7yac.js} +1 -1
- package/dist/{cli-0p76my9q.js → cli-jcnc5ret.js} +44 -32
- package/dist/{cli-tr19nyn9.js → cli-jgq9xptq.js} +7 -7
- package/dist/{cli-pz1dp12c.js → cli-jwnac23b.js} +1 -1
- package/dist/{cli-904wk98s.js → cli-kc7vd07m.js} +917 -350
- package/dist/{cli-t0jmkcah.js → cli-kg63yp1r.js} +14 -14
- package/dist/{cli-ts5yv7dn.js → cli-krk8y8c7.js} +835 -157
- package/dist/{cli-jyhbvdga.js → cli-m0ea8ggd.js} +8 -10
- package/dist/{cli-944w9wb4.js → cli-md4tn21h.js} +20 -15
- package/dist/{cli-zexwhj3f.js → cli-mv8ft7b0.js} +10 -9
- package/dist/{cli-phdzn699.js → cli-mw1tmn3x.js} +217 -27
- package/dist/{cli-5ashycw3.js → cli-njvpngc6.js} +3 -3
- package/dist/{cli-9ah37a8a.js → cli-phe2vcw5.js} +10 -7
- package/dist/{cli-eds5xnsz.js → cli-phmy14hb.js} +2 -2
- package/dist/{cli-n1kjs58m.js → cli-pq0kv31y.js} +5 -5
- package/dist/{cli-pz1nq5xm.js → cli-q457ga28.js} +6 -6
- package/dist/{cli-s33bzmk0.js → cli-q5n3deaf.js} +1 -1
- package/dist/{cli-4fpa0zns.js → cli-qkbevqer.js} +3 -3
- package/dist/{cli-29h5239w.js → cli-qrwjk4xy.js} +5 -5
- package/dist/{cli-kezzteka.js → cli-r04ve9xw.js} +1 -1
- package/dist/{cli-3xqad83h.js → cli-r495stwd.js} +2 -2
- package/dist/{cli-1kvcsd2f.js → cli-r9d2tya0.js} +71 -3
- package/dist/{cli-ybte1fqc.js → cli-rp1n2xpd.js} +1 -1
- package/dist/{cli-fkpnx3vf.js → cli-rs1rzwp4.js} +3 -2
- package/dist/{cli-h9d3sdnc.js → cli-rzbsh6bw.js} +1 -1
- package/dist/{cli-94gx6ze9.js → cli-s4pccby1.js} +1 -1
- package/dist/{cli-cq4am6vg.js → cli-shyhb4t5.js} +10 -10
- package/dist/{cli-gtj12v95.js → cli-srq69pn1.js} +1 -1
- package/dist/{cli-azj9t1f9.js → cli-tc165vrb.js} +48 -5
- package/dist/{cli-gse7bp3z.js → cli-v4z5v3jd.js} +300 -81
- package/dist/{cli-p3knvk62.js → cli-vxmmttmt.js} +132 -53
- package/dist/{cli-404am6f3.js → cli-w4bvtxet.js} +7 -7
- package/dist/{cli-gkv0r2hq.js → cli-wd7b5hgc.js} +71 -9
- package/dist/{cli-akm6y2a8.js → cli-wvbaq052.js} +1 -1
- package/dist/{cli-ywy8yz6t.js → cli-wvgg7r4j.js} +2 -2
- package/dist/{cli-ka48vpev.js → cli-wym6rxgt.js} +165 -6
- package/dist/{cli-nc4pbwmp.js → cli-yd7e590v.js} +12 -12
- package/dist/{cli-3zrwrnz7.js → cli-yjb3cddd.js} +1 -1
- package/dist/{cli-7gbff32z.js → cli-z8t4485r.js} +2 -2
- package/dist/{cli-hdhpdrka.js → cli-ze1ndjs4.js} +4 -6
- package/dist/{cli-50wa8k4h.js → cli-zy9bb22b.js} +1 -2
- package/dist/cli.js +28 -28
- package/dist/{codex-adapter-2fs2c0n6.js → codex-adapter-eq61radw.js} +8 -8
- package/dist/{codex-hook-jxjv6dy5.js → codex-hook-8nmepvz6.js} +3 -3
- package/dist/{codex-login-ktfg1cxk.js → codex-login-vbd9707w.js} +1 -1
- package/dist/{codex-session-runner-r55tmx4c.js → codex-session-runner-rfx355h4.js} +9 -9
- package/dist/{commands-0mxdy9x8.js → commands-d1z0sx62.js} +3 -3
- package/dist/{controller-g3vkfhr4.js → controller-9hz6d8x3.js} +4 -4
- package/dist/{controllers-connect-4wdmncqt.js → controllers-connect-tz07d2xr.js} +24 -25
- package/dist/core-dynsv289.js +41 -0
- package/dist/{cursor-adapter-t9qb96q2.js → cursor-adapter-ef22ze3j.js} +2 -2
- package/dist/{db-487vvyv9.js → db-gd81d68c.js} +3 -3
- package/dist/{db-76p7w3gr.js → db-vrckks6q.js} +4 -2
- package/dist/{devin-adapter-3bp6rape.js → devin-adapter-kdt6a2bh.js} +1 -1
- package/dist/{dispatcher-64rp6w67.js → dispatcher-76as8w2t.js} +21 -22
- package/dist/{docker-a59g3ebm.js → docker-51ta7jsh.js} +2 -2
- package/dist/dsh-adapter-ypfvcdyz.js +11 -0
- package/dist/{e2b-dc8f6ctq.js → e2b-05kn3kpq.js} +16 -5
- package/dist/{e2b-3ykbe805.js → e2b-dm9r8hpy.js} +3 -3
- package/dist/{easter-egg-3d-jrrwyf55.js → easter-egg-3d-sg21j15g.js} +1 -1
- package/dist/{embedding-space-001hhhpk.js → embedding-space-zsdw37bb.js} +13 -23
- package/dist/{embeddings-esj19cnw.js → embeddings-p4e3e1m6.js} +1 -1
- package/dist/{event-bus-7gbsr0g4.js → event-bus-tvf2grf4.js} +1 -1
- package/dist/{execute-301hkxqg.js → execute-nztd0af0.js} +1 -1
- package/dist/{external-channel-w10e2j05.js → external-channel-717yzn4d.js} +2 -2
- package/dist/fx-adapter-9k0hptnz.js +20 -0
- package/dist/grok-adapter-skdj2pce.js +20 -0
- package/dist/handlers-5btjqkz6.js +39 -0
- package/dist/{heartbeat-tbrj7vhq.js → heartbeat-vfb1gy84.js} +24 -25
- package/dist/{hook-tx917rqw.js → hook-ctz0xmp3.js} +11 -11
- package/dist/{hook-3am1sq68.js → hook-eh52p7yd.js} +6 -6
- package/dist/{http-3rmemtqy.js → http-zregegrx.js} +902 -198
- package/dist/{index-s7xtvc0f.js → index-5kx15d19.js} +1 -1
- package/dist/index-7w8p6em0.js +41 -0
- package/dist/index-evay0xyk.js +17 -0
- package/dist/{index-2jw11t8s.js → index-fdym6ryb.js} +25 -26
- package/dist/{index-3j803vnb.js → index-mtnbhe12.js} +20533 -19786
- package/dist/index-vz4semsx.js +38 -0
- package/dist/{index-gfnq66t1.js → index-x9qf8dg7.js} +294 -29
- package/dist/index-y3s0xp2v.js +43 -0
- package/dist/{k8s-36gfn847.js → k8s-ejkk0aw7.js} +2 -2
- package/dist/{keepalive-9px3t7qj.js → keepalive-zdqay870.js} +4 -5
- package/dist/lead-6cscw8a5.js +82 -0
- package/dist/{maintenance-vwqjwst6.js → maintenance-t5ndg11m.js} +1 -1
- package/dist/{node-2wfcey7d.js → node-0as4n1ef.js} +3 -3
- package/dist/{node-zd6shky9.js → node-dhxbt01p.js} +3 -3
- package/dist/{node-z67yjre7.js → node-jkdd5w7m.js} +290 -70
- package/dist/{node-hjn5n1yp.js → node-t0ct2zpw.js} +3 -5
- package/dist/{oauth-refresh-sweep-yqry3wn4.js → oauth-refresh-sweep-y9zyd7t6.js} +3 -4
- package/dist/{object-webhooks-8s1wtths.js → object-webhooks-mkca91s0.js} +7 -7
- package/dist/{onboard-hb8czx0p.js → onboard-ss995244.js} +11 -9
- package/dist/{opencode-adapter-djd6m6dk.js → opencode-adapter-mwpz0278.js} +8 -8
- package/dist/{otel-impl-2ymwyczz.js → otel-impl-6n6vva3x.js} +2 -2
- package/dist/{pending-nxavtvx7.js → pending-2sxh1t6j.js} +22 -23
- package/dist/{pi-mono-adapter-d2cpmcy4.js → pi-mono-adapter-sfb7zy43.js} +13 -13
- package/dist/{pricing-refresh-1yz8jkqv.js → pricing-refresh-h79bg4cf.js} +2 -2
- package/dist/{rbac-roles-7s6m31xw.js → rbac-roles-ckq0czp4.js} +2 -2
- package/dist/{rbac-roles-dbpx0x9v.js → rbac-roles-jg2e260w.js} +3 -3
- package/dist/{render-v2-7y20rjrn.js → render-v2-ymbshmn0.js} +7 -7
- package/dist/{resume-wz546x47.js → resume-jdhnt4jk.js} +10 -10
- package/dist/{runtime-cb5bd9tz.js → runtime-y28jhhnf.js} +1 -1
- package/dist/{session-access-4vcft8kq.js → session-access-k4ta5hvp.js} +5 -5
- package/dist/{session-source-backfill-57b50tpw.js → session-source-backfill-528j4s8j.js} +3 -3
- package/dist/{setup-e1tevjyj.js → setup-d6pj82fr.js} +15 -6
- package/dist/thread-buffer-9w6x5zec.js +40 -0
- package/dist/{tree-visibility-07wf1nct.js → tree-visibility-kjxv3nxk.js} +2 -2
- package/dist/{user-merge-jobs-n20qpv6s.js → user-merge-jobs-rabbncf6.js} +3 -3
- package/dist/{virtual-modules-6fxmn1yv.js → virtual-modules-22k51txd.js} +3 -3
- package/dist/{work-objects-eg7y48pe.js → work-objects-xtjbar3r.js} +26 -30
- package/dist/{worker-follow-up-jnvnnf2b.js → worker-follow-up-fg48vk6d.js} +21 -22
- package/dist/worker-g4aj93dt.js +82 -0
- package/dist/{x-d27jj7z7.js → x-vfsqypht.js} +2 -2
- package/openapi.json +633 -25
- package/package.json +10 -10
- 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/apps/sync.ts +20 -5
- package/src/azure-devops/boards-sync.ts +1 -1
- 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 +38 -1
- package/src/be/db/task-idempotency.ts +63 -0
- package/src/be/db/tasks/read.ts +27 -1
- package/src/be/db/tasks/write.ts +51 -14
- package/src/be/db/users/avatar.ts +12 -0
- package/src/be/db/workflow-idempotency.ts +6 -1
- package/src/be/db/workflows/read.ts +79 -0
- package/src/be/db.ts +129 -152
- 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/344_user_avatar.sql +4 -0
- package/src/be/migrations/345_task_status_kind.sql +6 -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/primitives/object-embed.ts +2 -2
- package/src/be/primitives/objects.ts +2 -2
- package/src/be/repo-checked-update.ts +58 -5
- package/src/be/requester-timezone.ts +10 -0
- package/src/be/runtime-pools/supervisor.ts +1 -0
- 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 +29 -4
- package/src/be/scripts/run-credential.ts +1 -8
- package/src/be/scripts/typecheck.ts +33 -8
- 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 +91 -7
- package/src/be/users.ts +33 -12
- package/src/bitbucket/handlers.ts +1 -1
- package/src/comb/review-batch.ts +16 -5
- package/src/commands/context-preamble.ts +237 -0
- package/src/commands/credential-outcome-report.ts +96 -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 +72 -10
- package/src/commands/setup.tsx +17 -3
- package/src/event-waits/github.ts +39 -6
- package/src/event-waits/index.ts +4 -2
- package/src/event-waits/types.ts +10 -3
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/github/app.ts +177 -13
- package/src/github/handlers.ts +7 -2
- package/src/github/pull-request-state.ts +100 -11
- package/src/gitlab/handlers.ts +2 -2
- package/src/heartbeat/heartbeat.ts +6 -1
- package/src/hooks/hook.ts +8 -2
- package/src/hooks/native-tool-hooks.ts +4 -2
- package/src/http/api-keys.ts +26 -0
- package/src/http/apps.ts +82 -42
- package/src/http/asset-key-write.ts +45 -0
- package/src/http/assets.ts +4 -3
- package/src/http/comb.ts +21 -5
- package/src/http/config.ts +8 -4
- package/src/http/github-token.ts +27 -6
- 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/pages.ts +4 -10
- package/src/http/repos.ts +27 -11
- package/src/http/request-principal.ts +27 -1
- package/src/http/schedules.ts +42 -14
- 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/sessions.ts +7 -2
- package/src/http/skills.ts +70 -0
- package/src/http/status.ts +2 -0
- package/src/http/tasks.ts +115 -19
- package/src/http/trackers/jira.ts +18 -3
- package/src/http/trackers/linear.ts +3 -0
- package/src/http/users.ts +5 -0
- package/src/http/webhooks.ts +19 -1
- package/src/http/workflows.ts +5 -10
- package/src/integrations/chat-sdk/commands.ts +3 -1
- package/src/jira/sync.ts +1 -1
- package/src/kv-limits.ts +2 -0
- package/src/kv-reserved-namespaces.ts +25 -2
- package/src/linear/sync.ts +5 -3
- package/src/prompts/session-templates.ts +50 -0
- package/src/prompts/session-turns.ts +30 -0
- package/src/providers/acp-targets.ts +2 -2
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/claude-adapter.ts +5 -0
- package/src/providers/claude-managed-adapter.ts +14 -0
- package/src/providers/claude-sdk-session.ts +19 -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/scheduler/deferred-task-waits.ts +74 -13
- 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 +12 -2
- package/src/scripts-runtime/types/stdlib.d.ts +27 -1
- package/src/scripts-runtime/types/swarm-extension.d.ts +20 -2
- package/src/scripts-runtime/types/swarm-sdk.d.ts +27 -1
- package/src/slack/actions.ts +25 -1
- 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/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 +403 -17
- package/src/slack/responses.ts +61 -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/tests/agents-list-model-display.test.ts +4 -0
- package/src/tests/api-drain-worker-e2e.test.ts +0 -2
- package/src/tests/approval-auto-cancellation-migration.test.ts +8 -19
- package/src/tests/approval-card-resolution.test.ts +2 -17
- package/src/tests/approval-requests-notifications.test.ts +41 -27
- package/src/tests/approval-requests.test.ts +137 -369
- package/src/tests/apps-script-types.test.ts +63 -16
- package/src/tests/apps-sort-order.test.ts +87 -0
- package/src/tests/apps-sync-engine.test.ts +5 -3
- package/src/tests/apps-table-filters-migration.test.ts +44 -25
- package/src/tests/bedrock-model-groups.test.ts +4 -0
- package/src/tests/bitbucket-handlers.test.ts +2 -0
- package/src/tests/channel-activity.test.ts +9 -0
- package/src/tests/chat-sdk-commands.test.ts +1 -0
- package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
- package/src/tests/claude-adapter.test.ts +35 -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-adapter.test.ts +3 -92
- package/src/tests/codex-gpt6-release.test.ts +4 -9
- package/src/tests/codex-oauth-credential-info.test.ts +35 -18
- package/src/tests/codex-oauth.test.ts +0 -6
- package/src/tests/codex-pool.test.ts +5 -214
- package/src/tests/codex-rate-limit-parse.test.ts +0 -7
- package/src/tests/codex-swarm-events.test.ts +11 -54
- package/src/tests/comb-review-batch.test.ts +17 -4
- package/src/tests/comb-status.test.ts +1 -0
- package/src/tests/db-client-busy-retry.test.ts +49 -16
- package/src/tests/db-client.test.ts +11 -5
- 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 +24 -1
- package/src/tests/dsh-adapter.test.ts +1 -1
- package/src/tests/e2b-dispatch.test.ts +13 -1
- package/src/tests/e2e-shards.test.ts +9 -9
- package/src/tests/enabled-tools.test.ts +0 -2
- package/src/tests/entrypoint-mcp-config.test.ts +642 -0
- package/src/tests/fixtures/base-prompt-baseline.json +6 -6
- 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/fx-adapter.test.ts +4 -5
- package/src/tests/github-app-worker-auth-helper.test.ts +147 -1
- package/src/tests/gitlab-handlers.test.ts +2 -0
- package/src/tests/heartbeat-jev-gate.test.ts +9 -241
- package/src/tests/heartbeat-reroute-decision.test.ts +2 -0
- package/src/tests/heartbeat-supersede-resume.test.ts +2 -0
- package/src/tests/heartbeat.test.ts +1 -0
- 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/key-usage-selection.test.ts +302 -0
- package/src/tests/memory-e2e.test.ts +34 -103
- package/src/tests/memory-key-paths.test.ts +5 -0
- package/src/tests/memory-rater-llm.test.ts +33 -149
- package/src/tests/memory-store.test.ts +24 -125
- package/src/tests/memory.test.ts +31 -100
- package/src/tests/merge-gate-detect-changes.test.ts +108 -2
- 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/opus-5-5-registry.test.ts +4 -0
- package/src/tests/otel-service-name.test.ts +0 -9
- package/src/tests/otel-session-cost-metrics.test.ts +1 -38
- package/src/tests/pool-session-logs.test.ts +8 -42
- package/src/tests/pre-push-affected-tests.test.ts +106 -0
- package/src/tests/prompt-template-session.test.ts +3 -0
- package/src/tests/provider-runtime-dependencies.test.ts +26 -15
- package/src/tests/routing-affinity-inventory.test.ts +11 -0
- package/src/tests/runner-api-drain.test.ts +2 -17
- package/src/tests/runner-context-preamble.test.ts +202 -0
- package/src/tests/runner-repo-clone-args.test.ts +116 -0
- package/src/tests/runner-terminal-window-report.test.ts +132 -0
- package/src/tests/runtime-supervisor-failures.test.ts +1 -0
- package/src/tests/sandboxed-process.test.ts +26 -21
- package/src/tests/schedule-http-triage-tools.test.ts +12 -9
- package/src/tests/scheduled-tasks.test.ts +14 -51
- 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/script-executor-conformance.test.ts +4 -48
- package/src/tests/script-executor-quickjs-pool.test.ts +9 -7
- package/src/tests/script-native-startup.test.ts +21 -25
- package/src/tests/scripts-namespaces.test.ts +3 -1
- package/src/tests/secret-rules.test.ts +4 -2
- 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-logs.test.ts +1 -260
- 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 +14 -152
- 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/task-cascade-fail.test.ts +1 -0
- package/src/tests/task-supersede-resume.test.ts +1 -0
- package/src/tests/test-proc.ts +5 -2
- package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
- package/src/tests/window-stream-reporter.test.ts +122 -0
- package/src/tests/workflow-agent-task-retry.test.ts +1 -3
- package/src/tests/workflow-cascade-cancel.test.ts +1 -0
- package/src/tests/workflow-retry-v2.test.ts +34 -43
- package/src/tests/workflow-retry-validation.test.ts +8 -48
- package/src/tests/workflow-triggers-v2.test.ts +35 -11
- package/src/tests/worktree-reaper.test.ts +2 -2
- package/src/tools/app-patch.ts +6 -2
- package/src/tools/app-upsert.ts +8 -4
- package/src/tools/cancel-task.ts +2 -2
- package/src/tools/defer-task.ts +24 -79
- package/src/tools/get-task-details.ts +8 -4
- package/src/tools/get-tasks.ts +13 -2
- 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/manage-user.ts +9 -0
- package/src/tools/repos/update-repo.ts +37 -19
- package/src/tools/schedules/run-schedule-now.ts +21 -1
- 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/slack-download-file.ts +15 -12
- package/src/tools/slack-post.ts +7 -1
- package/src/tools/slack-read.ts +3 -1
- package/src/tools/slack-reply.ts +16 -0
- package/src/tools/slack-start-thread.ts +8 -1
- package/src/tools/slack-upload-file.ts +99 -96
- package/src/tools/store-progress.ts +5 -3
- package/src/tools/swarm-config/set-config.ts +3 -1
- package/src/tools/swarm-x.ts +0 -2
- package/src/tools/utils.ts +3 -0
- package/src/types.ts +101 -2
- package/src/utils/constants.ts +32 -0
- package/src/utils/credentials.ts +42 -5
- package/src/utils/deferral-time.ts +61 -0
- package/src/utils/error-tracker.ts +6 -0
- package/src/utils/key-usage.ts +114 -0
- package/src/utils/request-auth-context.ts +15 -16
- package/src/utils/sandboxed-process.ts +1 -0
- package/src/utils/secret-scrubber.ts +1 -1
- package/src/workflows/engine.ts +6 -11
- package/src/workflows/executors/swarm-script.ts +0 -2
- package/src/workflows/foreach-driver.ts +6 -12
- package/src/workflows/input.ts +24 -1
- package/src/workflows/node-timeout.ts +18 -0
- package/src/workflows/resume.ts +5 -2
- package/src/workflows/retry-poller.ts +2 -1
- package/src/workflows/triggers.ts +21 -11
- package/src/x/composio.ts +10 -1
- package/templates/skills/apps/SKILL.md +6 -2
- package/templates/skills/apps/content.md +6 -2
- package/templates/skills/boards-and-sheets/content.md +4 -2
- package/templates/skills/code-quality/content.md +4 -4
- package/templates/skills/pages/content.md +7 -0
- package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
- package/templates/skills/scheduled-task-resilience/content.md +2 -0
- package/templates/skills/swarm-docs/content.md +8 -0
- package/templates/skills/swarm-scripts/SKILL.md +45 -0
- package/templates/skills/swarm-scripts/content.md +45 -0
- package/dist/acp-adapter-mr4temec.js +0 -17
- package/dist/cli-1vmhnncj.js +0 -173
- package/dist/cli-kj0hyr43.js +0 -51
- package/dist/cli-ysv0k1we.js +0 -459
- package/dist/core-gsvj5f3z.js +0 -42
- package/dist/dsh-adapter-8abzqk5c.js +0 -9
- package/dist/fx-adapter-4sjrbdne.js +0 -20
- package/dist/grok-adapter-3a0ezfee.js +0 -20
- package/dist/handlers-ef3k11hb.js +0 -41
- package/dist/index-aetfyx6p.js +0 -13
- package/dist/index-e6bq0exk.js +0 -42
- package/dist/index-hf2k1vge.js +0 -39
- package/dist/index-taxmejj3.js +0 -44
- package/dist/lead-5vt6f174.js +0 -83
- package/dist/thread-buffer-686pa1p1.js +0 -42
- package/dist/worker-4vp616ms.js +0 -83
- package/src/tests/apps-table-selection-migration.test.ts +0 -95
- package/src/tests/extensions-example-heartbeat-remediate.test.ts +0 -69
- package/src/tests/extensions-example-rewrite-and-suppress.test.ts +0 -70
|
@@ -10,6 +10,8 @@ Sheets are spreadsheets with live formulas. Boards are Excalidraw diagrams. Both
|
|
|
10
10
|
| A diagram or plan someone will move around (flow, architecture, rollout, mind map) | a board (`ctx.boards`) |
|
|
11
11
|
| A static table the reader only reads once | a Markdown table in your reply or report |
|
|
12
12
|
| A person asked for an Excel file, or sent one | a sheet, plus `importXlsx` / `exportXlsx` |
|
|
13
|
+
| A designed report or snapshot to share by URL | a page (the `pages` skill); embed the sheet or board in it |
|
|
14
|
+
| Records with queries, filters or action buttons | an app (the `apps` skill); embed the sheet or board in it |
|
|
13
15
|
|
|
14
16
|
## How to call
|
|
15
17
|
|
|
@@ -20,7 +22,7 @@ The `sheet-*` and `board-*` MCP tools are off in the agent tool list. Call them
|
|
|
20
22
|
- Identify a file by `id` (from `create` or `list`) or by `path`.
|
|
21
23
|
- Writes check the file version and re-apply on a concurrent edit (other cells or elements merge; the same cell or element is last writer wins). After 4 conflicting attempts the call throws "retry".
|
|
22
24
|
- `create` and `importXlsx` are create-only: they refuse when the path exists. Read or update the existing file instead.
|
|
23
|
-
- Every returned `object` carries `link`, the
|
|
25
|
+
- Every returned `object` carries `link`, the dashboard link to the file, where it opens as the editable board or sheet (the agent-fs live app when no dashboard is configured). Hand that link to the person.
|
|
24
26
|
|
|
25
27
|
## Where to put files
|
|
26
28
|
|
|
@@ -160,7 +162,7 @@ export default async function (args, ctx) {
|
|
|
160
162
|
|
|
161
163
|
## Embed in an app or a page
|
|
162
164
|
|
|
163
|
-
An app shows a live, editable sheet or board with `{ "type": "ObjectEmbed", "props": { "objectId": "<object id>" } }`. A page shows it with this snippet, where `${APP_URL}` is the dashboard origin:
|
|
165
|
+
An app (the `apps` skill) shows a live, editable sheet or board with `{ "type": "ObjectEmbed", "props": { "objectId": "<object id>" } }`. A page (the `pages` skill) shows it with this snippet, where `${APP_URL}` is the dashboard origin:
|
|
164
166
|
|
|
165
167
|
```html
|
|
166
168
|
<script type="module" src="${APP_URL}/embed/v1/swarm-object.js"></script>
|
|
@@ -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
|
|
|
@@ -27,6 +27,13 @@ every page should use.
|
|
|
27
27
|
Rule of thumb: if the content is a snapshot (you can write the full HTML/JSON
|
|
28
28
|
in a single call), use pages. If it needs stored data and actions, use apps.
|
|
29
29
|
|
|
30
|
+
### When to use a sheet or board instead
|
|
31
|
+
|
|
32
|
+
A tracker or grid people keep editing (budget, comparison, status list) is a
|
|
33
|
+
sheet. A plan, diagram or map to think through is a board. Both are editable
|
|
34
|
+
agent-fs files; see the `boards-and-sheets` skill. To show one inside a page,
|
|
35
|
+
embed it with `<swarm-object>` (section below).
|
|
36
|
+
|
|
30
37
|
Do **not** use pages for:
|
|
31
38
|
|
|
32
39
|
- In-flight progress notes: use `store-progress.progress`
|
|
@@ -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.
|
|
@@ -49,6 +49,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
49
49
|
- [Open Oncall](https://docs.agent-swarm.dev/docs/playbooks/open-oncall). When: Someone wants alerts from PagerDuty, Datadog, Sentry or a webhook investigated and fixed, with a person approving each fix. Not when: A one-off question about a single incident.
|
|
50
50
|
- [PR Review](https://docs.agent-swarm.dev/docs/playbooks/pr-review). When: Someone wants every pull request reviewed automatically before a person looks at it.
|
|
51
51
|
- [Software Factory](https://docs.agent-swarm.dev/docs/playbooks/software-factory). When: Someone wants labeled issues to become reviewed draft pull requests without a person driving each step.
|
|
52
|
+
- [Goals](https://docs.agent-swarm.dev/docs/playbooks/goals). When: Someone wants the swarm to keep working toward a measurable target until a check passes, or to hold a metric and reopen work when it regresses.
|
|
52
53
|
- [Linear Delivery Loop](https://docs.agent-swarm.dev/docs/playbooks/linear-delivery-loop). When: Someone wants agents to take Linear issues through implementation, CI and review to merged pull requests, with a person approving each one. Template: `community/linear-delivery-loop`.
|
|
53
54
|
- [Slack Reply Gate](https://docs.agent-swarm.dev/docs/playbooks/slack-reply-gate). When: Someone wants Lead to stop answering or waking on Slack thread banter, reactions, or messages meant for other people. Not when: Someone wants to route Slack messages to a specific agent or channel, which is a pre.slack.route extension.
|
|
54
55
|
- [Small-Company Workflows](https://docs.agent-swarm.dev/docs/playbooks/small-company-workflows). When: Someone at a small company asks which recurring cross-team workflows they could run with agents, with people approving the decisions. Not when: Someone wants a documented production playbook for one job, which is the linked playbook itself.
|
|
@@ -70,6 +71,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
70
71
|
- [Reviewing purchase order and supplier confirmation differences with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-order-confirmation-review). Reference.
|
|
71
72
|
- [Reviewing marketplace partner payout discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-payout-exception-review). Reference.
|
|
72
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.
|
|
73
75
|
- [Reviewing customer billing disputes with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-billing-dispute-review). Reference.
|
|
74
76
|
- [Preparing unmatched bank transactions for finance review with AI agents](https://docs.agent-swarm.dev/docs/guides/agent-assisted-bank-reconciliation-review). Reference.
|
|
75
77
|
- [Reviewing a proposed customer pricing change with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-pricing-change-review). Reference.
|
|
@@ -86,10 +88,14 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
86
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.
|
|
87
89
|
- [Reviewing supplier performance across delivery, quality and service records with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-performance-review). Reference.
|
|
88
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.
|
|
89
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.
|
|
90
94
|
- [Preparing contractor credential expiry checks for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/contractor-license-expiry-review). Reference.
|
|
91
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.
|
|
92
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.
|
|
93
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.
|
|
94
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.
|
|
95
101
|
- [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
|
|
@@ -100,6 +106,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
100
106
|
- [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
|
|
101
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.
|
|
102
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.
|
|
103
110
|
- [AI operations governance for small companies](https://docs.agent-swarm.dev/docs/guides/ai-operations-governance). Reference.
|
|
104
111
|
- [Repo merge policy](https://docs.agent-swarm.dev/docs/guides/repo-merge-policy). Reference.
|
|
105
112
|
- [E2B Provider Smoke Tests](https://docs.agent-swarm.dev/docs/guides/e2b-provider-smoke-tests). Reference.
|
|
@@ -142,6 +149,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
|
|
|
142
149
|
- [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
|
|
143
150
|
- [boxd runtime provider](https://docs.agent-swarm.dev/docs/guides/boxd-runtime-provider). Reference.
|
|
144
151
|
- [Coordinating delivery delay investigations between operations and support with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-delivery-delay-handoff). Reference.
|
|
152
|
+
- [Investigating a payroll discrepancy for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-payroll-discrepancy-review). Reference.
|
|
145
153
|
- [Preparing a service capacity planning brief with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-service-capacity-planning). Reference.
|
|
146
154
|
- [Preparing a property maintenance request for human triage with AI agents](https://docs.agent-swarm.dev/docs/guides/maintenance-work-order-triage). Reference.
|
|
147
155
|
- [Reviewing customer help content for conflicts with AI agents](https://docs.agent-swarm.dev/docs/guides/support-knowledge-conflict-review). Reference.
|
|
@@ -70,6 +70,7 @@ export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptCont
|
|
|
70
70
|
- Both `zod` and `zod/mini` imports work. Use `import * as z from "zod/mini"` for smaller QuickJS bundles. Mini uses functional forms: `z.optional(z.string())`, `z._default(z.number(), 10)`, and `z.string().check(z.minLength(1))`; its schemas still have `.parse()` and `.safeParse()`.
|
|
71
71
|
- Inline source through `script-run` runs without a typecheck. `script-upsert` typechecks before it saves. Import `ScriptContext` from `"swarm-sdk"` in inline code too, so promotion to a named script works. A worker's `script-upsert` saves at agent scope; a global-scope upsert is rejected unless you are the lead. To share a script, send the lead its name and `contentHash` to promote.
|
|
72
72
|
- SDK methods return `Promise<unknown>`. Responses are usually wrapped: read `res?.data ?? res`. Exception: `app_query` with a literal `appId` and `query` returns rows typed from the app's columns.
|
|
73
|
+
- To fail a run, throw an `Error` whose message starts with a stable reason code (for example `JOB_FAILED: ...`) and carries a JSON payload. A returned `{ ok: false }` still ends the run as `completed`, so a schedule never surfaces the failure; never return `ok: false` when the run must fail.
|
|
73
74
|
- When a script returns an array, return a scalar count beside it (for example `{ count, rows }`). A bounded or elided reply can show an empty array as a clean zero; the count is the only reliable signal that rows existed.
|
|
74
75
|
- `agentId` is propagated through the `X-Agent-ID` header, so SDK calls run as you. `taskId` is not ambient: pass it in `args` when the script calls `task_storeProgress`.
|
|
75
76
|
- A script invoked from a workflow node may run under a workflow identity. The node may also supply arguments the script needs: when you run that script directly, pass the same arguments the node maps. A script without a strict `argsSchema` then fails deeper in, often as a not-found or resource error instead of a validation error.
|
|
@@ -100,6 +101,7 @@ The route runs the same typecheck and scope rules as the tool.
|
|
|
100
101
|
- `ctx.stdlib`: `fetch`, `fetchJson` (retries, 30 s timeout), `grep`, `glob`, `table`, `retry`, `Redacted`.
|
|
101
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.
|
|
102
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.
|
|
103
105
|
|
|
104
106
|
### Files and shell
|
|
105
107
|
|
|
@@ -125,6 +127,49 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
|
|
|
125
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.
|
|
126
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.
|
|
127
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
|
+
|
|
128
173
|
## Inline script pattern
|
|
129
174
|
|
|
130
175
|
```typescript
|
|
@@ -65,6 +65,7 @@ export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptCont
|
|
|
65
65
|
- Both `zod` and `zod/mini` imports work. Use `import * as z from "zod/mini"` for smaller QuickJS bundles. Mini uses functional forms: `z.optional(z.string())`, `z._default(z.number(), 10)`, and `z.string().check(z.minLength(1))`; its schemas still have `.parse()` and `.safeParse()`.
|
|
66
66
|
- Inline source through `script-run` runs without a typecheck. `script-upsert` typechecks before it saves. Import `ScriptContext` from `"swarm-sdk"` in inline code too, so promotion to a named script works. A worker's `script-upsert` saves at agent scope; a global-scope upsert is rejected unless you are the lead. To share a script, send the lead its name and `contentHash` to promote.
|
|
67
67
|
- SDK methods return `Promise<unknown>`. Responses are usually wrapped: read `res?.data ?? res`. Exception: `app_query` with a literal `appId` and `query` returns rows typed from the app's columns.
|
|
68
|
+
- To fail a run, throw an `Error` whose message starts with a stable reason code (for example `JOB_FAILED: ...`) and carries a JSON payload. A returned `{ ok: false }` still ends the run as `completed`, so a schedule never surfaces the failure; never return `ok: false` when the run must fail.
|
|
68
69
|
- When a script returns an array, return a scalar count beside it (for example `{ count, rows }`). A bounded or elided reply can show an empty array as a clean zero; the count is the only reliable signal that rows existed.
|
|
69
70
|
- `agentId` is propagated through the `X-Agent-ID` header, so SDK calls run as you. `taskId` is not ambient: pass it in `args` when the script calls `task_storeProgress`.
|
|
70
71
|
- A script invoked from a workflow node may run under a workflow identity. The node may also supply arguments the script needs: when you run that script directly, pass the same arguments the node maps. A script without a strict `argsSchema` then fails deeper in, often as a not-found or resource error instead of a validation error.
|
|
@@ -95,6 +96,7 @@ The route runs the same typecheck and scope rules as the tool.
|
|
|
95
96
|
- `ctx.stdlib`: `fetch`, `fetchJson` (retries, 30 s timeout), `grep`, `glob`, `table`, `retry`, `Redacted`.
|
|
96
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.
|
|
97
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.
|
|
98
100
|
|
|
99
101
|
### Files and shell
|
|
100
102
|
|
|
@@ -120,6 +122,49 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
|
|
|
120
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.
|
|
121
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.
|
|
122
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
|
+
|
|
123
168
|
## Inline script pattern
|
|
124
169
|
|
|
125
170
|
```typescript
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
ACPAdapter2
|
|
3
|
-
} from "./cli-8cas2xvp.js";
|
|
4
|
-
import"./cli-0fgvnb0x.js";
|
|
5
|
-
import"./cli-nc4pbwmp.js";
|
|
6
|
-
import"./cli-n1kjs58m.js";
|
|
7
|
-
import"./cli-zexwhj3f.js";
|
|
8
|
-
import"./cli-k0nebh10.js";
|
|
9
|
-
import"./cli-0h8skzss.js";
|
|
10
|
-
import"./cli-m1sns1da.js";
|
|
11
|
-
import"./cli-0726awxw.js";
|
|
12
|
-
import"./cli-3xqad83h.js";
|
|
13
|
-
import"./cli-bv4vvnmg.js";
|
|
14
|
-
import"./cli-ywy8yz6t.js";
|
|
15
|
-
export {
|
|
16
|
-
ACPAdapter2 as ACPAdapter
|
|
17
|
-
};
|
package/dist/cli-1vmhnncj.js
DELETED
|
@@ -1,173 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
getKv2,
|
|
3
|
-
upsertKv2,
|
|
4
|
-
init_db4
|
|
5
|
-
} from "./cli-ts5yv7dn.js";
|
|
6
|
-
import {
|
|
7
|
-
resolveIdentity,
|
|
8
|
-
init_identity,
|
|
9
|
-
recordUnmappedIdentity,
|
|
10
|
-
init_unmapped_identities
|
|
11
|
-
} from "./cli-904wk98s.js";
|
|
12
|
-
import {
|
|
13
|
-
findUserByExternalId,
|
|
14
|
-
findUserByEmail,
|
|
15
|
-
findOrCreateUserByEmail,
|
|
16
|
-
linkIdentity,
|
|
17
|
-
init_users
|
|
18
|
-
} from "./cli-kj84fqxz.js";
|
|
19
|
-
import {
|
|
20
|
-
__esm
|
|
21
|
-
} from "./cli-242037k3.js";
|
|
22
|
-
|
|
23
|
-
// src/slack/enrich.ts
|
|
24
|
-
async function enrichSlackUserEmail(client, slackUserId) {
|
|
25
|
-
const cached = await getKv2(ENRICHMENT_NAMESPACE, slackUserId);
|
|
26
|
-
if (cached !== null) {
|
|
27
|
-
const payload = cached.value;
|
|
28
|
-
if (payload?.email) {
|
|
29
|
-
return payload.email;
|
|
30
|
-
}
|
|
31
|
-
}
|
|
32
|
-
let email = null;
|
|
33
|
-
let name = null;
|
|
34
|
-
try {
|
|
35
|
-
const result = await client.users.info({ user: slackUserId });
|
|
36
|
-
email = result.user?.profile?.email ?? null;
|
|
37
|
-
name = result.user?.profile?.real_name ?? result.user?.real_name ?? null;
|
|
38
|
-
} catch (error) {
|
|
39
|
-
console.error(`[Slack] enrichSlackUserEmail failed for ${slackUserId}:`, error);
|
|
40
|
-
return null;
|
|
41
|
-
}
|
|
42
|
-
if (!email) {
|
|
43
|
-
return null;
|
|
44
|
-
}
|
|
45
|
-
await upsertKv2({
|
|
46
|
-
namespace: ENRICHMENT_NAMESPACE,
|
|
47
|
-
key: slackUserId,
|
|
48
|
-
value: {
|
|
49
|
-
email,
|
|
50
|
-
name,
|
|
51
|
-
fetchedAt: new Date().toISOString()
|
|
52
|
-
},
|
|
53
|
-
valueType: "json",
|
|
54
|
-
expiresAt: Date.now() + ENRICHMENT_TTL_MS
|
|
55
|
-
});
|
|
56
|
-
return email;
|
|
57
|
-
}
|
|
58
|
-
function getCompanyEmailDomains() {
|
|
59
|
-
const raw = process.env.COMPANY_EMAIL_DOMAINS?.trim() ? process.env.COMPANY_EMAIL_DOMAINS : process.env.SLACK_ALLOWED_EMAIL_DOMAINS;
|
|
60
|
-
return (raw ?? "").split(",").map((domain) => domain.trim().toLowerCase()).filter(Boolean);
|
|
61
|
-
}
|
|
62
|
-
function isCompanyEmail(email, domains) {
|
|
63
|
-
const domain = email.split("@").pop()?.toLowerCase();
|
|
64
|
-
return !!domain && domains.includes(domain);
|
|
65
|
-
}
|
|
66
|
-
async function resolveSlackParticipant(client, slackUserId, eventContext) {
|
|
67
|
-
const domains = getCompanyEmailDomains();
|
|
68
|
-
const sameTeam = eventContext.userTeam ? await isOurSlackTeam(client, eventContext.userTeam, slackUserId) : undefined;
|
|
69
|
-
const foreignTeam = sameTeam === false;
|
|
70
|
-
let user = await findUserByExternalId("slack", slackUserId);
|
|
71
|
-
const email = user?.email || await enrichSlackUserEmail(client, slackUserId);
|
|
72
|
-
const linkable = !eventContext.userTeam || sameTeam === true;
|
|
73
|
-
if (!user && email && linkable) {
|
|
74
|
-
if (isCompanyEmail(email, domains)) {
|
|
75
|
-
const cached = await getKv2(ENRICHMENT_NAMESPACE, slackUserId);
|
|
76
|
-
const name = cached?.value?.name ?? undefined;
|
|
77
|
-
user = (await findOrCreateUserByEmail(email, { name, role: "member" }, SLACK_WEBHOOK_ACTOR)).user;
|
|
78
|
-
} else {
|
|
79
|
-
user = await findUserByEmail(email);
|
|
80
|
-
}
|
|
81
|
-
if (user) {
|
|
82
|
-
try {
|
|
83
|
-
await linkIdentity(user.id, "slack", slackUserId, SLACK_WEBHOOK_ACTOR);
|
|
84
|
-
} catch (error) {
|
|
85
|
-
console.warn(`[Slack] linkIdentity('slack', ${slackUserId}) failed — likely a concurrent enroll`, error);
|
|
86
|
-
}
|
|
87
|
-
user = await findUserByExternalId("slack", slackUserId) ?? user;
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
if (!user && !email) {
|
|
91
|
-
await recordUnmappedIdentity("slack", slackUserId, eventContext);
|
|
92
|
-
}
|
|
93
|
-
const audience = user?.metadata?.audience;
|
|
94
|
-
const trust = audience === "internal" || audience === "external" ? audience : foreignTeam ? "external" : eventContext.userTeam && sameTeam === undefined ? "unknown" : domains.length === 0 ? user ? "internal" : email ? "external" : "unknown" : !email ? "unknown" : isCompanyEmail(email, domains) ? "internal" : "external";
|
|
95
|
-
return { userId: user?.id, trust };
|
|
96
|
-
}
|
|
97
|
-
async function resolveSlackUserId(client, slackUserId, eventContext) {
|
|
98
|
-
return (await resolveSlackParticipant(client, slackUserId, eventContext)).userId;
|
|
99
|
-
}
|
|
100
|
-
async function getOurSlackTeam(client) {
|
|
101
|
-
if (cachedTeam)
|
|
102
|
-
return cachedTeam;
|
|
103
|
-
try {
|
|
104
|
-
const result = await client.auth.test();
|
|
105
|
-
const teamId = result.team_id || undefined;
|
|
106
|
-
const enterpriseId = result.enterprise_id || undefined;
|
|
107
|
-
const orgInstall = result.is_enterprise_install === true || !!enterpriseId && (!teamId || teamId === enterpriseId);
|
|
108
|
-
if (teamId || enterpriseId)
|
|
109
|
-
cachedTeam = { teamId, enterpriseId, orgInstall };
|
|
110
|
-
} catch (error) {
|
|
111
|
-
console.error("[Slack] auth.test failed while reading the team id:", error);
|
|
112
|
-
}
|
|
113
|
-
return cachedTeam;
|
|
114
|
-
}
|
|
115
|
-
async function getSlackUserTeam(client, slackUserId) {
|
|
116
|
-
try {
|
|
117
|
-
const { user } = await client.users.info({ user: slackUserId });
|
|
118
|
-
if (!user)
|
|
119
|
-
return;
|
|
120
|
-
return {
|
|
121
|
-
teamId: user.team_id || undefined,
|
|
122
|
-
enterpriseId: user.enterprise_user?.enterprise_id || undefined
|
|
123
|
-
};
|
|
124
|
-
} catch (error) {
|
|
125
|
-
console.error(`[Slack] users.info failed while reading the team of ${slackUserId}:`, error);
|
|
126
|
-
return;
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
async function isOurSlackTeam(client, userTeam, slackUserId) {
|
|
130
|
-
const ours = await getOurSlackTeam(client);
|
|
131
|
-
if (!ours)
|
|
132
|
-
return;
|
|
133
|
-
if (userTeam === ours.teamId)
|
|
134
|
-
return true;
|
|
135
|
-
if (!ours.orgInstall)
|
|
136
|
-
return false;
|
|
137
|
-
const sender = await getSlackUserTeam(client, slackUserId);
|
|
138
|
-
return !!sender?.enterpriseId && sender.enterpriseId === ours.enterpriseId;
|
|
139
|
-
}
|
|
140
|
-
async function rewriteSlackMentions(text, botUserId, trust) {
|
|
141
|
-
const userIds = new Set;
|
|
142
|
-
for (const match of text.matchAll(/<@([A-Z0-9]+)>/g)) {
|
|
143
|
-
const userId = match[1];
|
|
144
|
-
if (userId && userId !== botUserId)
|
|
145
|
-
userIds.add(userId);
|
|
146
|
-
}
|
|
147
|
-
const resolutions = new Map;
|
|
148
|
-
await Promise.all([...userIds].map(async (userId) => {
|
|
149
|
-
resolutions.set(userId, await resolveIdentity("slack", userId));
|
|
150
|
-
}));
|
|
151
|
-
return text.replace(/<@([A-Z0-9]+)>/g, (_match, userId) => {
|
|
152
|
-
if (userId === botUserId)
|
|
153
|
-
return `<@${userId}> (that's you)`;
|
|
154
|
-
const resolution = resolutions.get(userId);
|
|
155
|
-
const level = trust?.get(userId);
|
|
156
|
-
const untrusted = level === "external" || level === "unknown" ? level : undefined;
|
|
157
|
-
if (resolution?.status === "resolved") {
|
|
158
|
-
return untrusted ? `<@${userId}|${resolution.name}> (${untrusted}, untrusted)` : `<@${userId}|${resolution.name}>`;
|
|
159
|
-
}
|
|
160
|
-
return untrusted ? `<@${userId}> (unknown user, untrusted)` : `<@${userId}> (unknown user)`;
|
|
161
|
-
});
|
|
162
|
-
}
|
|
163
|
-
var ENRICHMENT_NAMESPACE = "integration:user-enrichment:slack", ENRICHMENT_TTL_MS, SLACK_WEBHOOK_ACTOR, cachedTeam;
|
|
164
|
-
var init_enrich = __esm(() => {
|
|
165
|
-
init_db4();
|
|
166
|
-
init_identity();
|
|
167
|
-
init_unmapped_identities();
|
|
168
|
-
init_users();
|
|
169
|
-
ENRICHMENT_TTL_MS = 24 * 60 * 60 * 1000;
|
|
170
|
-
SLACK_WEBHOOK_ACTOR = { kind: "system", id: "webhook:slack" };
|
|
171
|
-
});
|
|
172
|
-
|
|
173
|
-
export { enrichSlackUserEmail, resolveSlackParticipant, resolveSlackUserId, getSlackUserTeam, isOurSlackTeam, rewriteSlackMentions, init_enrich };
|
package/dist/cli-kj0hyr43.js
DELETED
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
__esm
|
|
3
|
-
} from "./cli-242037k3.js";
|
|
4
|
-
|
|
5
|
-
// src/slack/event-dedup.ts
|
|
6
|
-
function createCache(ttlMs) {
|
|
7
|
-
return {
|
|
8
|
-
ttlMs,
|
|
9
|
-
entries: new Map,
|
|
10
|
-
cleanupTimer: null
|
|
11
|
-
};
|
|
12
|
-
}
|
|
13
|
-
function cleanup(cache, now) {
|
|
14
|
-
for (const [key, expiresAt] of cache.entries) {
|
|
15
|
-
if (expiresAt <= now) {
|
|
16
|
-
cache.entries.delete(key);
|
|
17
|
-
}
|
|
18
|
-
}
|
|
19
|
-
}
|
|
20
|
-
function ensureCleanupTimer(cache) {
|
|
21
|
-
if (cache.cleanupTimer)
|
|
22
|
-
return;
|
|
23
|
-
cache.cleanupTimer = setInterval(() => {
|
|
24
|
-
cleanup(cache, Date.now());
|
|
25
|
-
}, CLEANUP_INTERVAL_MS);
|
|
26
|
-
if (typeof cache.cleanupTimer === "object" && cache.cleanupTimer && "unref" in cache.cleanupTimer) {
|
|
27
|
-
cache.cleanupTimer.unref();
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
function checkAndInsert(cache, eventId, now) {
|
|
31
|
-
ensureCleanupTimer(cache);
|
|
32
|
-
const existing = cache.entries.get(eventId);
|
|
33
|
-
if (existing !== undefined && existing > now) {
|
|
34
|
-
return true;
|
|
35
|
-
}
|
|
36
|
-
cache.entries.set(eventId, now + cache.ttlMs);
|
|
37
|
-
return false;
|
|
38
|
-
}
|
|
39
|
-
function wasEventSeen(eventId) {
|
|
40
|
-
if (!eventId)
|
|
41
|
-
return false;
|
|
42
|
-
return checkAndInsert(defaultCache, eventId, Date.now());
|
|
43
|
-
}
|
|
44
|
-
var EVENT_DEDUP_TTL_MS, DEFAULT_TTL_MS, CLEANUP_INTERVAL_MS = 60000, defaultCache;
|
|
45
|
-
var init_event_dedup = __esm(() => {
|
|
46
|
-
EVENT_DEDUP_TTL_MS = 25 * 60 * 60 * 1000;
|
|
47
|
-
DEFAULT_TTL_MS = EVENT_DEDUP_TTL_MS;
|
|
48
|
-
defaultCache = createCache(DEFAULT_TTL_MS);
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
export { wasEventSeen, init_event_dedup };
|