@desplega.ai/agent-swarm 2.10.0 → 2.11.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-weaaxey3.js +16 -0
- package/dist/{acp-targets-arrwv4f0.js → acp-targets-5wyy2b9m.js} +9 -9
- package/dist/{actions-y0d2n1c2.js → actions-4nxq386s.js} +24 -23
- package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-v6enh76w.js} +4 -4
- package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-ze3x22qn.js} +3 -3
- package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
- package/dist/{app-wb7w45dq.js → app-kyqt8ehw.js} +7 -6
- package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-a0db0esw.js} +7 -6
- package/dist/{assistant-gf60454p.js → assistant-9g5jzq25.js} +26 -25
- package/dist/{azure-openai-responses-b3y7fz36.js → azure-openai-responses-jeaas6x0.js} +10 -10
- package/dist/{boot-args-schema-qxmd59sr.js → boot-args-schema-d7fme4q1.js} +1 -1
- package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-6wpazmpw.js} +1 -1
- package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-jrwxeye2.js} +1 -1
- package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-52h7yntp.js} +2 -2
- package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-kb3dxjex.js} +4 -4
- package/dist/{boxd-wn235q80.js → boxd-jrrmkv3w.js} +2 -2
- package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-0c0y8fqp.js} +8 -8
- package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-w2es07qq.js} +4 -4
- package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-9ssb7ct4.js} +4 -4
- package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-p6t0gyse.js} +10941 -10412
- package/dist/{cli-p0n7b5rz.js → cli-075ccjh6.js} +344 -130
- package/dist/{cli-3caf7pmg.js → cli-0bgj4rh5.js} +3 -3
- package/dist/{cli-7r162fxe.js → cli-14xdms9a.js} +23 -17
- package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
- package/dist/{cli-y4ccxtz5.js → cli-1h4njv9y.js} +144 -6
- package/dist/{cli-6ym4jhzp.js → cli-27fat7st.js} +7 -7
- package/dist/{cli-k3q2va86.js → cli-2aacfdcn.js} +5 -5
- package/dist/{cli-vq2eg24x.js → cli-2gvdvsxj.js} +3 -3
- package/dist/{cli-sb4426be.js → cli-2jtfm8kh.js} +5 -5
- package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
- package/dist/{cli-6237rnyr.js → cli-3bpr3wks.js} +1 -1
- package/dist/{cli-5qhfv9rw.js → cli-453497a0.js} +44 -17
- package/dist/{cli-2rnd5j3t.js → cli-4aswccje.js} +2 -2
- package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
- package/dist/{cli-p0c3vtch.js → cli-4g323fjh.js} +772 -515
- package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
- package/dist/{cli-fcfbct2j.js → cli-4kzp7r0q.js} +5 -5
- package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
- package/dist/{cli-zeh2mhkg.js → cli-5ptj757f.js} +1 -1
- package/dist/{cli-539h29es.js → cli-6a3j25xd.js} +224 -189
- package/dist/{cli-hnamkvnc.js → cli-6c9ve77f.js} +2 -2
- package/dist/{cli-3et6fmfe.js → cli-6n7y5ypy.js} +1 -1
- package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
- package/dist/{cli-zk7v5s89.js → cli-6tvh1fwq.js} +3 -3
- package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
- package/dist/{cli-5a6pqy45.js → cli-7e8sxqv5.js} +1 -1
- package/dist/{cli-6037prsx.js → cli-892y3vfp.js} +13 -13
- package/dist/cli-8mfdbdhe.js +43 -0
- package/dist/{cli-s1zqk1aj.js → cli-8zmpwe79.js} +15 -9
- package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
- package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
- package/dist/{cli-7mv4h3sn.js → cli-9g12h1aq.js} +2 -2
- package/dist/{cli-aw83sr40.js → cli-9knhkkgr.js} +3 -3
- package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
- package/dist/{cli-qj39vrc6.js → cli-9yjhshah.js} +1 -1
- package/dist/{cli-6cwr32fe.js → cli-a02habn6.js} +422 -140
- package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
- package/dist/{cli-3f8zbtqa.js → cli-a6q6x15h.js} +9 -8
- package/dist/{cli-j6te8keb.js → cli-atm0hkes.js} +8 -8
- package/dist/{cli-9fjr27ez.js → cli-b82a13ga.js} +13 -13
- package/dist/{cli-7zm3b3f5.js → cli-bf0t77nf.js} +1 -1
- package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
- package/dist/{cli-mk7c5ac4.js → cli-bq97k63w.js} +2 -2
- package/dist/{cli-vfqvrd82.js → cli-cstggwq7.js} +2 -2
- package/dist/{cli-md50mj0r.js → cli-czvvnfr9.js} +3 -3
- package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
- package/dist/{cli-fq2rr3jb.js → cli-djt6wmrc.js} +6 -6
- package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
- package/dist/{cli-z0m452jr.js → cli-f7dhm7hh.js} +1 -1
- package/dist/{cli-mys27d03.js → cli-f8yhybxr.js} +3 -3
- package/dist/{cli-5gpqgs8b.js → cli-fwjwkw66.js} +2 -2
- package/dist/{cli-gabsjg8x.js → cli-g56fxddf.js} +1 -1
- package/dist/{cli-y8p78ekx.js → cli-h2qtafm4.js} +18 -18
- package/dist/{cli-psffsanb.js → cli-ha4ek2nb.js} +6 -1
- package/dist/{cli-th1dkc2v.js → cli-hnh8erra.js} +2 -2
- package/dist/{cli-w16kwbzw.js → cli-htymm48w.js} +1 -1
- package/dist/{cli-124ntmf0.js → cli-j2r1apqm.js} +138 -59
- package/dist/{cli-43ms35q9.js → cli-k3c13za2.js} +3 -3
- package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
- package/dist/{cli-v8z0yga9.js → cli-k4r5sfaj.js} +4 -4
- package/dist/{cli-91pkxres.js → cli-kbm659dk.js} +2 -2
- package/dist/{cli-q5srsxq2.js → cli-m00c47q6.js} +110 -27
- package/dist/{cli-3aaeb78m.js → cli-mhrr4d5b.js} +95 -10
- package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
- package/dist/{cli-qrta34nb.js → cli-n6ygvrrm.js} +4 -4
- package/dist/{cli-k5yewqgd.js → cli-nbakg5xh.js} +3 -3
- package/dist/{cli-nstkanmx.js → cli-nc39ym5q.js} +8 -8
- package/dist/{cli-01k6wpr9.js → cli-p1a4khta.js} +7 -7
- package/dist/{cli-t9ga4qmb.js → cli-p8zqbbt1.js} +40 -33
- package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
- package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
- package/dist/{cli-kbtzfrxj.js → cli-q71g5q39.js} +3 -3
- package/dist/{cli-vs9vdpy0.js → cli-qncx2r0s.js} +1 -1
- package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
- package/dist/{cli-x40a0w9j.js → cli-r813c7rb.js} +1 -1
- package/dist/{cli-kpgcm7xy.js → cli-ramn8jae.js} +1 -1
- package/dist/{cli-cc93xzes.js → cli-raqw9fw9.js} +28 -17
- package/dist/cli-rhsc2zyx.js +68 -0
- package/dist/{cli-8st34zhr.js → cli-rpmw4fsv.js} +57 -19
- package/dist/{cli-had1p04a.js → cli-rwgwen5v.js} +4 -4
- package/dist/{cli-tr27kwyg.js → cli-rytq7dm2.js} +261 -6
- package/dist/{cli-s1khw52h.js → cli-s9twe4x0.js} +66 -17
- package/dist/{cli-2v2zdm0a.js → cli-t2s7j5cy.js} +2 -2
- package/dist/{cli-nv4xsvmk.js → cli-tb4j757d.js} +7 -7
- package/dist/{cli-q2d3e1k1.js → cli-thd3005a.js} +1 -1
- package/dist/cli-tsfkcd4v.js +30 -0
- package/dist/{cli-jrbq4djp.js → cli-v3zcnr8g.js} +1 -1
- package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
- package/dist/{cli-qx4f057j.js → cli-vy3fn0mz.js} +4 -4
- package/dist/{cli-7sf9sb0w.js → cli-w5dar1bk.js} +1 -1
- package/dist/{cli-w1q68d8x.js → cli-wz4e5am2.js} +9 -9
- package/dist/{cli-m9cvf7vs.js → cli-xqbqwpxr.js} +14 -14
- package/dist/{cli-2spnz7ye.js → cli-ynph3b70.js} +11137 -8332
- package/dist/{cli-43evxwj4.js → cli-yvzxbztc.js} +9 -4
- package/dist/{cli-vsw91x06.js → cli-yzxqwcvq.js} +3 -6
- package/dist/{cli-wafmk3fn.js → cli-zb1hff00.js} +12 -12
- package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
- package/dist/{cli-wwp1bd3n.js → cli-zhn4r1rz.js} +519 -75
- package/dist/{cli-tvgqesec.js → cli-zqq57pgx.js} +4 -4
- package/dist/cli.js +28 -27
- package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
- package/dist/{codex-adapter-exfdbj73.js → codex-adapter-ssahg4h4.js} +8 -8
- package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
- package/dist/{codex-login-a239g1ah.js → codex-login-9c7aggxe.js} +1 -1
- package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-xn63q3h7.js} +9 -9
- package/dist/{commands-d8g349v4.js → commands-ctey7tr5.js} +3 -3
- package/dist/{controller-mwgdmb8y.js → controller-rqhbppg9.js} +4 -4
- package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-w3qbpbt1.js} +22 -21
- package/dist/{core-sxy4epp2.js → core-df1n049h.js} +19 -18
- package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-r819hf1a.js} +2 -2
- package/dist/{db-wcw0b2j8.js → db-2ah39cyx.js} +2 -2
- package/dist/{db-qpganbeb.js → db-p5drc1d1.js} +3 -3
- package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-bc6g0x29.js} +1 -1
- package/dist/{dispatcher-8d8s49yz.js → dispatcher-x6w14pde.js} +19 -18
- package/dist/{docker-09tkkg0n.js → docker-6c4reetq.js} +51 -14
- package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-h8qn14n4.js} +2 -2
- package/dist/{e2b-sm28k0k3.js → e2b-jg7kyyef.js} +6 -6
- package/dist/{e2b-3v1e745x.js → e2b-z4ec0qve.js} +3 -3
- package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-1y6r9gxy.js} +1 -1
- package/dist/{embedding-space-e48xchqa.js → embedding-space-z6ptw3jk.js} +6 -6
- package/dist/{embeddings-tgq2afbq.js → embeddings-0sxb1d2h.js} +1 -1
- package/dist/{event-bus-xr83x566.js → event-bus-swr88jg5.js} +1 -1
- package/dist/{execute-8rhwrk7f.js → execute-6m1ex8ce.js} +8 -4
- package/dist/{external-channel-8bt3j2pm.js → external-channel-ezer7pk0.js} +2 -2
- package/dist/fx-adapter-zwmps9re.js +19 -0
- package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
- package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
- package/dist/grok-adapter-q0avf919.js +19 -0
- package/dist/handlers-g5jq0e4q.js +36 -0
- package/dist/{heartbeat-x0056ra5.js → heartbeat-6c4fr49t.js} +22 -21
- package/dist/{hook-mrd2ayxv.js → hook-02rt5tvq.js} +8 -8
- package/dist/{hook-a7vmn2st.js → hook-t1c5avbv.js} +5 -5
- package/dist/{http-ym9c5svp.js → http-qa3h32a1.js} +2049 -148
- package/dist/index-1f6m47mq.js +37 -0
- package/dist/index-1p1mpqda.js +36 -0
- package/dist/{index-p46tvwtx.js → index-akbgsdhh.js} +25 -24
- package/dist/{index-ny60jcat.js → index-e42j998x.js} +16 -13
- package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
- package/dist/{index-01ns1pkw.js → index-kqv9ebfj.js} +1 -1
- package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
- package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
- package/dist/{index-x6azjwm8.js → index-qpjk2hxk.js} +1 -1
- package/dist/index-tnkd410q.js +41 -0
- package/dist/{k8s-m56sw868.js → k8s-7jrh5va2.js} +73 -14
- package/dist/{keepalive-7yxg8z4c.js → keepalive-jmf6pn8c.js} +4 -4
- package/dist/lead-m5e7xt93.js +75 -0
- package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
- package/dist/{maintenance-6tefxmk1.js → maintenance-g7v15tj1.js} +1 -1
- package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
- package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
- package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-ywgf8tbr.js} +3 -3
- package/dist/{onboard-fja65z08.js → onboard-m3fedypq.js} +3 -3
- package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
- package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
- package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
- package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
- package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-19ktcbb9.js} +7 -7
- package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
- package/dist/{otel-impl-7zhnt6gj.js → otel-impl-3ehm1hgc.js} +2 -2
- package/dist/{pending-h01yzpx4.js → pending-fwj2fatd.js} +20 -19
- package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
- package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-xdeesvc4.js} +18 -17
- package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-4j8dzvxg.js} +2 -2
- package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-8msjr07m.js} +3 -3
- package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-n7t2acv8.js} +2 -2
- package/dist/{render-v2-1rgspxzf.js → render-v2-j7qggj8h.js} +7 -6
- package/dist/{resume-tqy61x24.js → resume-hj1mn65y.js} +9 -8
- package/dist/{runtime-exkxyx5f.js → runtime-z31mdsgv.js} +2 -2
- package/dist/{session-access-3act7vt4.js → session-access-w38fh09a.js} +4 -4
- package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-ax6qxv20.js} +3 -3
- package/dist/{setup-ry1vfdef.js → setup-dsqmpfcr.js} +1 -1
- package/dist/thread-buffer-nf55vwx3.js +39 -0
- package/dist/tree-visibility-6vqmnr71.js +24 -0
- package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
- package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-mvheb3ed.js} +3 -3
- package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-w2qk2wew.js} +32 -10
- package/dist/{work-objects-z2e5tv03.js → work-objects-4ahy5es5.js} +22 -21
- package/dist/worker-ews1nyhw.js +75 -0
- package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-1gs4aw7y.js} +19 -18
- package/dist/{x-wg164ss9.js → x-3wr8c5sh.js} +2 -2
- package/openapi.json +995 -49
- package/package.json +9 -8
- package/src/be/db/request-composition.ts +190 -0
- package/src/be/db/runtime.ts +15 -0
- package/src/be/db/slack-trees.ts +220 -10
- package/src/be/db/tasks/human-free.ts +3 -2
- package/src/be/db/workflow-run-retention.ts +101 -0
- package/src/be/db-client.ts +23 -1
- package/src/be/db-retention-defaults.ts +46 -0
- package/src/be/db-retention.ts +55 -6
- package/src/be/mcp-events/catalog.ts +108 -0
- package/src/be/mcp-events/dispatcher.ts +202 -0
- package/src/be/mcp-events/protocol.ts +296 -0
- package/src/be/mcp-events/store.ts +231 -0
- package/src/be/mcp-events/webhook.ts +226 -0
- package/src/be/memory/providers/sqlite-store.ts +110 -24
- package/src/be/memory/review-recall-filter.ts +22 -0
- package/src/be/memory/search-candidates.ts +5 -7
- package/src/be/memory/types.ts +5 -0
- package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
- package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
- package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
- package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
- package/src/be/migrations/329_workflow_run_retention.sql +9 -0
- package/src/be/migrations/330_request_composition.sql +22 -0
- package/src/be/model-profile-check.ts +1 -1
- package/src/be/multi-runtime.ts +32 -4
- package/src/be/runtime-pools/controllers.ts +18 -3
- package/src/be/runtime-pools/db.ts +15 -4
- package/src/be/runtime-pools/supervisor.ts +42 -2
- package/src/be/swarm-config-guard.ts +10 -2
- package/src/commands/context-preamble.ts +11 -4
- package/src/commands/credential-outcome-report.ts +33 -9
- package/src/commands/e2b-stack-wizard.tsx +12 -6
- package/src/commands/runner.ts +116 -12
- package/src/extensions/catalog.generated.json +1 -1
- package/src/github/app.ts +59 -14
- package/src/http/all-routes.ts +2 -0
- package/src/http/config.ts +2 -1
- package/src/http/core.ts +2 -0
- package/src/http/github-token.ts +66 -0
- package/src/http/index.ts +21 -0
- package/src/http/mcp-user.ts +11 -8
- package/src/http/mcp.ts +58 -42
- package/src/http/prompt-templates.ts +1 -0
- package/src/http/request-composition.ts +310 -0
- package/src/http/tasks.ts +6 -1
- package/src/http/tool-schema-estimate.ts +95 -0
- package/src/http/workflows.ts +29 -11
- package/src/integrations/chat-sdk/inbound.ts +2 -2
- package/src/prompts/base-prompt.ts +133 -7
- package/src/prompts/resolver.ts +41 -2
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/opencode-adapter.ts +72 -1
- package/src/providers/opencode-swarm-plugin.ts +22 -3
- package/src/providers/pi-mono-adapter.ts +1 -0
- package/src/providers/pi-mono-extension.ts +71 -0
- package/src/providers/pricing-sources.md +4 -0
- package/src/providers/request-composition-hook.ts +312 -0
- package/src/providers/types.ts +5 -0
- package/src/runtime-providers/controller-protocol.ts +7 -0
- package/src/runtime-providers/docker.ts +80 -12
- package/src/runtime-providers/k8s.ts +111 -6
- package/src/runtime-providers/types.ts +17 -0
- package/src/scheduler/scheduler.ts +1 -1
- package/src/server-user.ts +16 -1
- package/src/slack/ack.ts +10 -5
- package/src/slack/actions.ts +3 -3
- package/src/slack/app.ts +2 -0
- package/src/slack/assistant.ts +4 -4
- package/src/slack/blocks.ts +3 -3
- package/src/slack/handlers.ts +3 -3
- package/src/slack/reaction-shortcode.ts +23 -2
- package/src/slack/render-v2.ts +297 -200
- package/src/slack/responses.ts +7 -5
- package/src/slack/thread-buffer.ts +3 -3
- package/src/slack/tree-visibility.ts +64 -0
- package/src/tasks/worker-follow-up.ts +127 -17
- package/src/tests/azure-devops-outbound.test.ts +47 -14
- package/src/tests/base-prompt.test.ts +149 -1
- package/src/tests/check-playwright-version.test.ts +33 -0
- package/src/tests/context-preamble-budget.test.ts +65 -0
- package/src/tests/credential-outcome-report.test.ts +81 -1
- package/src/tests/db-client.test.ts +22 -0
- package/src/tests/db-retention-defaults.test.ts +244 -0
- package/src/tests/db-retention.test.ts +2 -1
- package/src/tests/db-runtime.test.ts +2 -1
- package/src/tests/deploy-release-dispatch.test.ts +332 -0
- package/src/tests/e2b-stack-wizard.test.tsx +156 -0
- package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
- package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
- package/src/tests/env-flag.test.ts +4 -2
- package/src/tests/event-loop-lag.test.ts +12 -18
- package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
- package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
- package/src/tests/fixtures/base-prompt-baseline.json +18 -0
- package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
- package/src/tests/github-installation-token-route.test.ts +199 -0
- package/src/tests/mcp-user-events.test.ts +708 -0
- package/src/tests/memory-key-paths.test.ts +4 -1
- package/src/tests/memory-search-stall.test.ts +421 -0
- package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
- package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
- package/src/tests/model-profile-fallbacks.test.ts +236 -2
- package/src/tests/opencode-adapter.test.ts +86 -0
- package/src/tests/pi-mono-extension.test.ts +168 -0
- package/src/tests/preload-env.test.ts +61 -1
- package/src/tests/preload.ts +22 -0
- package/src/tests/prompt-template-resolver.test.ts +85 -0
- package/src/tests/reload-config.test.ts +45 -0
- package/src/tests/request-composition.test.ts +447 -0
- package/src/tests/runner-max-concurrent.test.ts +86 -0
- package/src/tests/runtime-pools-db.test.ts +80 -0
- package/src/tests/runtime-provider-registration.test.ts +8 -0
- package/src/tests/runtime-providers-docker.test.ts +192 -1
- package/src/tests/runtime-providers-k8s.test.ts +127 -0
- package/src/tests/runtime-remote-controller.test.ts +64 -1
- package/src/tests/runtime-supervisor.test.ts +101 -0
- package/src/tests/script-connections.test.ts +8 -0
- package/src/tests/slack-blocks.test.ts +18 -0
- package/src/tests/slack-empty-icon-config.test.ts +113 -0
- package/src/tests/slack-reaction-config.test.ts +38 -2
- package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
- package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
- package/src/tests/slack-render-v2.test.ts +683 -11
- package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
- package/src/tests/task-session-prompts.test.ts +37 -0
- package/src/tests/user-delete-perf.test.ts +36 -9
- package/src/tests/webhook-filter.test.ts +327 -0
- package/src/tests/workflow-async-v2.test.ts +19 -16
- package/src/tests/workflow-definition-telemetry.test.ts +15 -5
- package/src/tests/workflow-e2e.test.ts +1 -9
- package/src/tests/workflow-finalization-races.test.ts +553 -0
- package/src/tests/workflow-foreach.test.ts +2 -0
- package/src/tests/workflow-hitl-routing.test.ts +26 -20
- package/src/tests/workflow-http-v2.test.ts +105 -2
- package/src/tests/workflow-idempotency.test.ts +41 -0
- package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
- package/src/tests/workflow-parallel-park.test.ts +297 -0
- package/src/tests/workflow-retry-v2.test.ts +57 -21
- package/src/tests/workflow-retry-validation.test.ts +13 -13
- package/src/tests/workflow-runs-retention.test.ts +533 -0
- package/src/tests/workflow-script-principal.test.ts +7 -2
- package/src/tests/workflow-tla-races.test.ts +7 -2
- package/src/tests/workflow-triggers-v2.test.ts +201 -0
- package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
- package/src/tests/workflow-wait-event.test.ts +28 -2
- package/src/tests/workflow-wait-poller.test.ts +94 -0
- package/src/tests/workflow-wait-time.test.ts +7 -3
- package/src/tests/workflow-wait.test.ts +26 -0
- package/src/tests/workflow-wait.ts +44 -0
- package/src/tools/workflows/create-workflow.ts +7 -3
- package/src/tools/workflows/update-workflow.ts +7 -3
- package/src/types.ts +200 -2
- package/src/utils/credentials.ts +7 -0
- package/src/workflows/checkpoint.ts +18 -0
- package/src/workflows/engine.ts +38 -10
- package/src/workflows/foreach-driver.ts +42 -4
- package/src/workflows/recovery.ts +6 -1
- package/src/workflows/resume.ts +11 -3
- package/src/workflows/retry-poller.ts +17 -4
- package/src/workflows/successor-routing.ts +108 -0
- package/src/workflows/task-step-routing.ts +5 -2
- package/src/workflows/triggers.ts +21 -36
- package/src/workflows/wait-poller.ts +6 -2
- package/src/workflows/webhook-filter.ts +203 -0
- package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
- package/templates/skills/swarm-docs/content.md +2 -0
- package/dist/acp-adapter-bht22g3k.js +0 -16
- package/dist/fx-adapter-adtdb3jb.js +0 -19
- package/dist/grok-adapter-accnn9km.js +0 -19
- package/dist/handlers-1x77561e.js +0 -35
- package/dist/index-48qzcqzj.js +0 -35
- package/dist/index-rkvaambe.js +0 -36
- package/dist/index-xj1mq27m.js +0 -40
- package/dist/lead-enzn86bz.js +0 -74
- package/dist/thread-buffer-3x93yexa.js +0 -38
- package/dist/worker-zfcv2wbf.js +0 -74
package/src/be/db-client.ts
CHANGED
|
@@ -118,6 +118,14 @@ export interface DbClient extends DbExecutor {
|
|
|
118
118
|
* rejection is contained and logged, never an unhandled rejection.
|
|
119
119
|
*/
|
|
120
120
|
afterCommit(fn: () => void | Promise<void>): void;
|
|
121
|
+
/**
|
|
122
|
+
* Run `fn` synchronously if the currently-open outermost transaction rolls
|
|
123
|
+
* back, including a COMMIT that fails; dropped on commit. With no
|
|
124
|
+
* transaction open it does nothing. For undoing process-local state taken
|
|
125
|
+
* inside the transaction. A hook registered inside a savepoint that rolls
|
|
126
|
+
* back runs only if the outer transaction rolls back too.
|
|
127
|
+
*/
|
|
128
|
+
afterRollback(fn: () => void): void;
|
|
121
129
|
}
|
|
122
130
|
|
|
123
131
|
const LOCK_WATCHDOG_MS = 30_000;
|
|
@@ -166,6 +174,8 @@ type TxContext = {
|
|
|
166
174
|
closed: boolean;
|
|
167
175
|
/** Hooks to run after COMMIT; dropped on ROLLBACK. */
|
|
168
176
|
afterCommit: (() => void | Promise<void>)[];
|
|
177
|
+
/** Hooks to run after ROLLBACK; dropped on COMMIT. */
|
|
178
|
+
afterRollback: (() => void)[];
|
|
169
179
|
};
|
|
170
180
|
|
|
171
181
|
const txContext = new AsyncLocalStorage<TxContext>();
|
|
@@ -496,7 +506,7 @@ class BunSqliteClient implements DbClient {
|
|
|
496
506
|
deadlineAt?: number,
|
|
497
507
|
): Promise<{ ok: true; value: T } | { ok: false; busyBegin: unknown }> {
|
|
498
508
|
const release = await this.lock.acquire();
|
|
499
|
-
const ctx: TxContext = { closed: false, afterCommit: [] };
|
|
509
|
+
const ctx: TxContext = { closed: false, afterCommit: [], afterRollback: [] };
|
|
500
510
|
let began = false;
|
|
501
511
|
try {
|
|
502
512
|
const db = this.getDatabase();
|
|
@@ -544,6 +554,13 @@ class BunSqliteClient implements DbClient {
|
|
|
544
554
|
} catch {
|
|
545
555
|
// Connection-level failure while rolling back; surface the original error.
|
|
546
556
|
}
|
|
557
|
+
for (const hook of ctx.afterRollback) {
|
|
558
|
+
try {
|
|
559
|
+
hook();
|
|
560
|
+
} catch (hookErr) {
|
|
561
|
+
console.error("[db-client] afterRollback hook threw:", hookErr);
|
|
562
|
+
}
|
|
563
|
+
}
|
|
547
564
|
}
|
|
548
565
|
throw err;
|
|
549
566
|
} finally {
|
|
@@ -562,6 +579,11 @@ class BunSqliteClient implements DbClient {
|
|
|
562
579
|
this.scheduleHook(fn);
|
|
563
580
|
}
|
|
564
581
|
|
|
582
|
+
afterRollback(fn: () => void): void {
|
|
583
|
+
const ctx = txContext.getStore();
|
|
584
|
+
if (ctx && !ctx.closed) ctx.afterRollback.push(fn);
|
|
585
|
+
}
|
|
586
|
+
|
|
565
587
|
private scheduleHook(fn: () => void | Promise<void>): void {
|
|
566
588
|
// Queueing behind the FIFO lock keeps hooks ordered after already-queued
|
|
567
589
|
// operations. The hook runs outside the lock so its own client calls
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { getDbClient, getSwarmConfigs, upsertSwarmConfig } from "./db";
|
|
2
|
+
import { wasDbCreatedThisBoot } from "./db/runtime";
|
|
3
|
+
import { DB_RETENTION_TABLES } from "./db-retention";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* New-install seed: store each table's `newInstallDefault` as a global
|
|
7
|
+
* swarm_config row, so retention is on from the first boot and the operator
|
|
8
|
+
* sees and edits the values like any other stored setting.
|
|
9
|
+
*
|
|
10
|
+
* Only the boot that creates the database writes rows. An upgraded install
|
|
11
|
+
* keeps retention exactly as it was, and a row the operator deletes is never
|
|
12
|
+
* written again. A key present in the deployment env, even empty, is left to the env
|
|
13
|
+
* (a stored row would override it), and so is a key that already has a row.
|
|
14
|
+
*
|
|
15
|
+
* Call before `loadGlobalConfigsIntoEnv`, while `process.env` still holds the
|
|
16
|
+
* deployment values and so that the load injects the new rows.
|
|
17
|
+
*/
|
|
18
|
+
export async function seedDbRetentionDefaults(
|
|
19
|
+
isNewInstall: boolean = wasDbCreatedThisBoot(),
|
|
20
|
+
): Promise<string[]> {
|
|
21
|
+
if (!isNewInstall) return [];
|
|
22
|
+
const seeded: string[] = [];
|
|
23
|
+
// One transaction: a failure must not leave a partial set that no later boot completes.
|
|
24
|
+
await getDbClient().transaction(async () => {
|
|
25
|
+
for (const table of DB_RETENTION_TABLES) {
|
|
26
|
+
// Presence, not truthiness: an empty or blank env value is the operator's
|
|
27
|
+
// explicit "off" and must not be replaced by a deleting default.
|
|
28
|
+
if (!("newInstallDefault" in table) || process.env[table.envKey] !== undefined) continue;
|
|
29
|
+
const existing = await getSwarmConfigs({ scope: "global", key: table.envKey });
|
|
30
|
+
if (existing.length > 0) continue;
|
|
31
|
+
await upsertSwarmConfig({
|
|
32
|
+
scope: "global",
|
|
33
|
+
key: table.envKey,
|
|
34
|
+
value: String(table.newInstallDefault),
|
|
35
|
+
description: `New-install default: ${table.table} retention. Rows past it are permanently deleted. Delete this entry to turn the sweep off.`,
|
|
36
|
+
});
|
|
37
|
+
seeded.push(`${table.envKey}=${table.newInstallDefault}`);
|
|
38
|
+
}
|
|
39
|
+
});
|
|
40
|
+
if (seeded.length > 0) {
|
|
41
|
+
console.log(
|
|
42
|
+
`[startup] New database: stored default retention (${seeded.join(", ")}). Rows past these limits are permanently deleted; change or delete each key in Settings → Configuration.`,
|
|
43
|
+
);
|
|
44
|
+
}
|
|
45
|
+
return seeded;
|
|
46
|
+
}
|
package/src/be/db-retention.ts
CHANGED
|
@@ -5,6 +5,11 @@ import { TERMINAL_SCRIPT_RUN_STATUSES } from "../types";
|
|
|
5
5
|
import { isEnvFlagEnabled } from "../utils/env-flag";
|
|
6
6
|
import { scrubSecrets } from "../utils/secret-scrubber";
|
|
7
7
|
import { getDbClient } from "./db";
|
|
8
|
+
import {
|
|
9
|
+
deleteWorkflowRunRetentionBatch,
|
|
10
|
+
workflowRunRetentionStatements,
|
|
11
|
+
} from "./db/workflow-run-retention";
|
|
12
|
+
import { DbTransactionDeadlineError } from "./db-client";
|
|
8
13
|
import { DB_RETENTION_TUNING_BOUNDS, MAX_DB_RETENTION_DAYS } from "./swarm-config-guard";
|
|
9
14
|
|
|
10
15
|
const DAY_MS = 24 * 60 * 60 * 1000;
|
|
@@ -22,7 +27,7 @@ const YIELD_MS = 25;
|
|
|
22
27
|
* from operator configuration: a retention policy must never target a table
|
|
23
28
|
* that code review has not explicitly approved as safe to delete from.
|
|
24
29
|
*
|
|
25
|
-
*
|
|
30
|
+
* Three policies exist:
|
|
26
31
|
* - `age`: the env value is a number of days; rows whose `timeColumn` is older
|
|
27
32
|
* than that horizon are deleted. Optional narrowing: `terminalStatuses`
|
|
28
33
|
* deletes only rows whose `statusColumn` is in that list, `keepWhenSet`
|
|
@@ -32,6 +37,8 @@ const YIELD_MS = 25;
|
|
|
32
37
|
* - `keepLatest`: the env value is a count; within each `partitionBy` group,
|
|
33
38
|
* only the newest `rankBy` rows are kept. The newest row of a group is
|
|
34
39
|
* never deleted, because the smallest accepted count is 1.
|
|
40
|
+
* - `workflowRuns`: days since completion, with parent/child protection and
|
|
41
|
+
* transactional dependency cleanup in db/workflow-run-retention.ts.
|
|
35
42
|
*/
|
|
36
43
|
export const DB_RETENTION_TABLES = [
|
|
37
44
|
{
|
|
@@ -39,6 +46,7 @@ export const DB_RETENTION_TABLES = [
|
|
|
39
46
|
policy: "age",
|
|
40
47
|
timeColumn: "createdAt",
|
|
41
48
|
envKey: "SESSION_LOG_RETENTION_DAYS",
|
|
49
|
+
newInstallDefault: 30,
|
|
42
50
|
metricsKey: "sessionLogs",
|
|
43
51
|
},
|
|
44
52
|
{
|
|
@@ -46,6 +54,7 @@ export const DB_RETENTION_TABLES = [
|
|
|
46
54
|
policy: "age",
|
|
47
55
|
timeColumn: "createdAt",
|
|
48
56
|
envKey: "AGENT_LOG_RETENTION_DAYS",
|
|
57
|
+
newInstallDefault: 90,
|
|
49
58
|
metricsKey: "agentLog",
|
|
50
59
|
},
|
|
51
60
|
{
|
|
@@ -53,6 +62,7 @@ export const DB_RETENTION_TABLES = [
|
|
|
53
62
|
policy: "age",
|
|
54
63
|
timeColumn: "createdAt",
|
|
55
64
|
envKey: "EVENTS_RETENTION_DAYS",
|
|
65
|
+
newInstallDefault: 90,
|
|
56
66
|
metricsKey: "events",
|
|
57
67
|
},
|
|
58
68
|
{
|
|
@@ -66,6 +76,7 @@ export const DB_RETENTION_TABLES = [
|
|
|
66
76
|
partitionBy: "agentId, field",
|
|
67
77
|
rankBy: "version",
|
|
68
78
|
envKey: "CONTEXT_VERSIONS_KEEP_LATEST",
|
|
79
|
+
newInstallDefault: 100,
|
|
69
80
|
metricsKey: "contextVersions",
|
|
70
81
|
initialBatchSize: 50,
|
|
71
82
|
maxBatchSize: 100,
|
|
@@ -89,16 +100,29 @@ export const DB_RETENTION_TABLES = [
|
|
|
89
100
|
terminalStatuses: TERMINAL_SCRIPT_RUN_STATUSES,
|
|
90
101
|
keepWhenSet: "idempotencyKey",
|
|
91
102
|
envKey: "SCRIPT_RUNS_RETENTION_DAYS",
|
|
103
|
+
newInstallDefault: 30,
|
|
92
104
|
metricsKey: "scriptRuns",
|
|
93
105
|
initialBatchSize: 100,
|
|
94
106
|
maxBatchSize: 500,
|
|
95
107
|
},
|
|
108
|
+
{
|
|
109
|
+
table: "workflow_runs",
|
|
110
|
+
policy: "workflowRuns",
|
|
111
|
+
envKey: "WORKFLOW_RUNS_RETENTION_DAYS",
|
|
112
|
+
metricsKey: "workflowRuns",
|
|
113
|
+
initialBatchSize: 10,
|
|
114
|
+
minBatchSize: 1,
|
|
115
|
+
maxBatchSize: 100,
|
|
116
|
+
},
|
|
96
117
|
] as const satisfies ReadonlyArray<
|
|
97
118
|
{
|
|
98
119
|
table: string;
|
|
99
120
|
envKey: string;
|
|
121
|
+
/** Stored once as a global config row when the database is created; see db-retention-defaults.ts. */
|
|
122
|
+
newInstallDefault?: number;
|
|
100
123
|
metricsKey: string;
|
|
101
124
|
initialBatchSize?: number;
|
|
125
|
+
minBatchSize?: number;
|
|
102
126
|
maxBatchSize?: number;
|
|
103
127
|
} & (
|
|
104
128
|
| {
|
|
@@ -110,6 +134,7 @@ export const DB_RETENTION_TABLES = [
|
|
|
110
134
|
keepWhenSet?: string;
|
|
111
135
|
}
|
|
112
136
|
| { policy: "keepLatest"; partitionBy: string; rankBy: string }
|
|
137
|
+
| { policy: "workflowRuns" }
|
|
113
138
|
)
|
|
114
139
|
>;
|
|
115
140
|
|
|
@@ -348,6 +373,10 @@ type SweepStatements = {
|
|
|
348
373
|
};
|
|
349
374
|
|
|
350
375
|
export function sweepStatements(table: RetentionTable, value: number, now: Date): SweepStatements {
|
|
376
|
+
if (table.policy === "workflowRuns") {
|
|
377
|
+
const iso = new Date(now.getTime() - value * DAY_MS).toISOString();
|
|
378
|
+
return workflowRunRetentionStatements(`${iso.slice(0, 10)} ${iso.slice(11, 19)}`);
|
|
379
|
+
}
|
|
351
380
|
if (table.policy === "keepLatest") {
|
|
352
381
|
// ROW_NUMBER over the (partition, rank DESC) index: rank 1 is the newest
|
|
353
382
|
// row of its group. The DELETE removes the deepest history first, so an
|
|
@@ -429,13 +458,31 @@ async function sweepTable(
|
|
|
429
458
|
let slowestStatementMs = 0;
|
|
430
459
|
let size = batchSizeByTable[table.metricsKey] ?? initialBatchSize(table);
|
|
431
460
|
const ceiling = maxBatchSize(table);
|
|
461
|
+
const floor = "minBatchSize" in table ? table.minBatchSize : MIN_BATCH_SIZE;
|
|
432
462
|
|
|
433
463
|
try {
|
|
434
464
|
while (!signal.aborted && Date.now() < deadline) {
|
|
435
465
|
const limitUsed = size;
|
|
436
|
-
//
|
|
437
|
-
// batch
|
|
438
|
-
|
|
466
|
+
// Release the write lock between batches. Workflow runs need a single
|
|
467
|
+
// transaction per batch to unlink tasks and reclaim their definitions.
|
|
468
|
+
let result: { changes: number; executionMs: number };
|
|
469
|
+
try {
|
|
470
|
+
result =
|
|
471
|
+
table.policy === "workflowRuns"
|
|
472
|
+
? await deleteWorkflowRunRetentionBatch(
|
|
473
|
+
String(statements.params[0]),
|
|
474
|
+
limitUsed,
|
|
475
|
+
deadline,
|
|
476
|
+
)
|
|
477
|
+
: await client.runTimed(statements.deleteSql, [...statements.params, limitUsed]);
|
|
478
|
+
} catch (err) {
|
|
479
|
+
if (table.policy !== "workflowRuns" || !(err instanceof DbTransactionDeadlineError))
|
|
480
|
+
throw err;
|
|
481
|
+
// The entire batch rolled back. Retry smaller on the next pass/tick;
|
|
482
|
+
// reaching the budget is not a database failure.
|
|
483
|
+
size = Math.max(floor, Math.floor(size / 2));
|
|
484
|
+
break;
|
|
485
|
+
}
|
|
439
486
|
// Execution time only. Wall time around the call also covers waiting for
|
|
440
487
|
// the client's FIFO lock and its BUSY backoff sleeps, neither of which
|
|
441
488
|
// this statement spent in the driver: charging those to the stall metric
|
|
@@ -448,7 +495,7 @@ async function sweepTable(
|
|
|
448
495
|
batches += 1;
|
|
449
496
|
|
|
450
497
|
if (elapsed > maxStatementMs) {
|
|
451
|
-
size = Math.max(
|
|
498
|
+
size = Math.max(floor, Math.floor(size / 2));
|
|
452
499
|
} else if (elapsed < maxStatementMs / 5) {
|
|
453
500
|
size = Math.min(ceiling, size * 2);
|
|
454
501
|
}
|
|
@@ -458,7 +505,9 @@ async function sweepTable(
|
|
|
458
505
|
// pass. It does NOT prove the table is drained: each DELETE autocommits,
|
|
459
506
|
// so another process can commit an already-expired row before the count
|
|
460
507
|
// below runs. Loop control only — `drained` comes from that count.
|
|
461
|
-
|
|
508
|
+
// Removing a tree root exposes its expired children to the next batch.
|
|
509
|
+
if (result.changes === 0 || (table.policy !== "workflowRuns" && result.changes < limitUsed))
|
|
510
|
+
break;
|
|
462
511
|
if (signal.aborted || Date.now() >= deadline) break;
|
|
463
512
|
await yieldTick();
|
|
464
513
|
}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP Events offered on the user MCP. v1: webhook delivery of task.completed
|
|
3
|
+
* and task.failed for tasks the subscribing user requested.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { parseEnvFlag } from "@/utils/env-flag";
|
|
7
|
+
|
|
8
|
+
/** SEP-3415 extension identifier. */
|
|
9
|
+
export const EVENTS_EXTENSION_ID = "io.modelcontextprotocol/events";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Kill switch, default on. Off: no capability advertised and every `events/*`
|
|
13
|
+
* request gets -32601 Method not found. Read per session, so a config change
|
|
14
|
+
* applies to new sessions without a restart.
|
|
15
|
+
*/
|
|
16
|
+
export function isMcpUserEventsEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
|
|
17
|
+
return parseEnvFlag(env.MCP_USER_EVENTS_ENABLED, true);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* SEP-3415 error codes (draft, "provisional until accepted"). OpenAI's
|
|
22
|
+
* ChatGPT page still cites -32015 for CallbackEndpointError, from an earlier
|
|
23
|
+
* revision of the design sketch that used -32011..-32015.
|
|
24
|
+
*/
|
|
25
|
+
export const EventsErrorCode = {
|
|
26
|
+
InvalidParams: -32602,
|
|
27
|
+
NotFound: -32023,
|
|
28
|
+
Forbidden: -32024,
|
|
29
|
+
ResourceExhausted: -32025,
|
|
30
|
+
Unsupported: -32026,
|
|
31
|
+
CallbackEndpointError: -32027,
|
|
32
|
+
} as const;
|
|
33
|
+
|
|
34
|
+
export type TaskEventName = "task.completed" | "task.failed";
|
|
35
|
+
|
|
36
|
+
const ARGUMENTS_SCHEMA = {
|
|
37
|
+
type: "object",
|
|
38
|
+
properties: {
|
|
39
|
+
taskId: {
|
|
40
|
+
type: "string",
|
|
41
|
+
description:
|
|
42
|
+
"Only this task and the tasks created under it. Omit to receive every task you requested.",
|
|
43
|
+
},
|
|
44
|
+
},
|
|
45
|
+
additionalProperties: false,
|
|
46
|
+
} as const;
|
|
47
|
+
|
|
48
|
+
const BASE_PAYLOAD_PROPERTIES = {
|
|
49
|
+
taskId: { type: "string" },
|
|
50
|
+
parentTaskId: { type: ["string", "null"] },
|
|
51
|
+
status: { type: "string" },
|
|
52
|
+
task: { type: "string", description: "The task description, truncated." },
|
|
53
|
+
url: { type: "string", description: "Dashboard link to the task." },
|
|
54
|
+
} as const;
|
|
55
|
+
|
|
56
|
+
export const EVENT_DESCRIPTORS = [
|
|
57
|
+
{
|
|
58
|
+
name: "task.completed",
|
|
59
|
+
description:
|
|
60
|
+
"Fires when a task you requested completes. Read the full result with get-task-details.",
|
|
61
|
+
delivery: ["webhook"],
|
|
62
|
+
inputSchema: ARGUMENTS_SCHEMA,
|
|
63
|
+
payloadSchema: {
|
|
64
|
+
type: "object",
|
|
65
|
+
properties: {
|
|
66
|
+
...BASE_PAYLOAD_PROPERTIES,
|
|
67
|
+
output: { type: "string", description: "The task output, truncated." },
|
|
68
|
+
truncated: { type: "boolean" },
|
|
69
|
+
},
|
|
70
|
+
required: ["taskId", "status", "url"],
|
|
71
|
+
},
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
name: "task.failed",
|
|
75
|
+
description: "Fires when a task you requested fails. Read the details with get-task-details.",
|
|
76
|
+
delivery: ["webhook"],
|
|
77
|
+
inputSchema: ARGUMENTS_SCHEMA,
|
|
78
|
+
payloadSchema: {
|
|
79
|
+
type: "object",
|
|
80
|
+
properties: {
|
|
81
|
+
...BASE_PAYLOAD_PROPERTIES,
|
|
82
|
+
failureReason: { type: "string", description: "Why the task failed, truncated." },
|
|
83
|
+
truncated: { type: "boolean" },
|
|
84
|
+
},
|
|
85
|
+
required: ["taskId", "status", "url"],
|
|
86
|
+
},
|
|
87
|
+
},
|
|
88
|
+
] as const;
|
|
89
|
+
|
|
90
|
+
export function isTaskEventName(name: unknown): name is TaskEventName {
|
|
91
|
+
return name === "task.completed" || name === "task.failed";
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export type TaskEventArguments = { taskId?: string };
|
|
95
|
+
|
|
96
|
+
/** Validates `arguments` against ARGUMENTS_SCHEMA. Returns null when invalid. */
|
|
97
|
+
export function parseTaskEventArguments(raw: unknown): TaskEventArguments | null {
|
|
98
|
+
if (raw === undefined || raw === null) return {};
|
|
99
|
+
if (typeof raw !== "object" || Array.isArray(raw)) return null;
|
|
100
|
+
const entries = Object.entries(raw as Record<string, unknown>);
|
|
101
|
+
const out: TaskEventArguments = {};
|
|
102
|
+
for (const [key, value] of entries) {
|
|
103
|
+
if (key !== "taskId") return null;
|
|
104
|
+
if (typeof value !== "string" || value.length === 0 || value.length > 200) return null;
|
|
105
|
+
out.taskId = value;
|
|
106
|
+
}
|
|
107
|
+
return out;
|
|
108
|
+
}
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Delivers task.completed / task.failed to matching MCP Events webhook
|
|
3
|
+
* subscriptions. Listens on the in-process workflow event bus, which emits
|
|
4
|
+
* post-commit, so a rolled-back completion never reaches a client.
|
|
5
|
+
*
|
|
6
|
+
* Retries are in-process and bounded (5 attempts over about 14 minutes). There
|
|
7
|
+
* is no durable outbox: an event emitted while the API restarts, or whose
|
|
8
|
+
* retries run past a restart, is lost. get-task-details stays the source of
|
|
9
|
+
* truth.
|
|
10
|
+
*
|
|
11
|
+
* shortcut: no durable outbox, upgrade when a client needs at-least-once delivery.
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import { createHash } from "node:crypto";
|
|
15
|
+
import { getDbClient, getTaskById, getUserById } from "@/be/db";
|
|
16
|
+
import { isLiveUserToken } from "@/be/users";
|
|
17
|
+
import { getAppUrl } from "@/utils/constants";
|
|
18
|
+
import { scrubSecrets } from "@/utils/secret-scrubber";
|
|
19
|
+
import { workflowEventBus } from "@/workflows/event-bus";
|
|
20
|
+
import { isMcpUserEventsEnabled, parseTaskEventArguments, type TaskEventName } from "./catalog";
|
|
21
|
+
import {
|
|
22
|
+
getSubscription,
|
|
23
|
+
listLiveSubscriptions,
|
|
24
|
+
recordDeliveryOutcome,
|
|
25
|
+
type SubscriptionRow,
|
|
26
|
+
unsealSecret,
|
|
27
|
+
} from "./store";
|
|
28
|
+
import { MAX_DELIVERY_BODY_BYTES, parseWebhookSecret, postSignedWebhook } from "./webhook";
|
|
29
|
+
|
|
30
|
+
/** Delays before attempts 2..5. Sum ≈ 14 min, inside SEP-3415's 10-15 min guidance. */
|
|
31
|
+
const DEFAULT_RETRY_DELAYS_MS = [10_000, 60_000, 240_000, 540_000];
|
|
32
|
+
const MAX_OUTPUT_CHARS = 16_000;
|
|
33
|
+
const MAX_TASK_CHARS = 2_000;
|
|
34
|
+
const MAX_ANCESTOR_HOPS = 32;
|
|
35
|
+
|
|
36
|
+
let retryDelaysMs = DEFAULT_RETRY_DELAYS_MS;
|
|
37
|
+
const pendingTimers = new Set<ReturnType<typeof setTimeout>>();
|
|
38
|
+
let listening = false;
|
|
39
|
+
|
|
40
|
+
/** Tests only: shorten the retry schedule. */
|
|
41
|
+
export function __setRetryDelaysForTests(delays: number[] | null): void {
|
|
42
|
+
retryDelaysMs = delays ?? DEFAULT_RETRY_DELAYS_MS;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function truncate(text: string, max: number): { text: string; truncated: boolean } {
|
|
46
|
+
return text.length > max
|
|
47
|
+
? { text: text.slice(0, max), truncated: true }
|
|
48
|
+
: { text, truncated: false };
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** True when `taskId` is `filterTaskId` or one of its descendants. */
|
|
52
|
+
async function isUnderTask(taskId: string, filterTaskId: string): Promise<boolean> {
|
|
53
|
+
let current: string | null = taskId;
|
|
54
|
+
for (let hop = 0; current && hop <= MAX_ANCESTOR_HOPS; hop++) {
|
|
55
|
+
if (current === filterTaskId) return true;
|
|
56
|
+
const row: { parentTaskId: string | null } | null = await getDbClient().get<{
|
|
57
|
+
parentTaskId: string | null;
|
|
58
|
+
}>("SELECT parentTaskId FROM agent_tasks WHERE id = ?", [current]);
|
|
59
|
+
current = row?.parentTaskId ?? null;
|
|
60
|
+
}
|
|
61
|
+
return false;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function signingSecrets(row: SubscriptionRow, nowIso: string): Buffer[] {
|
|
65
|
+
const secrets = [unsealSecret(row.secretSealed)];
|
|
66
|
+
if (row.previousSecretSealed && row.previousSecretUntil && row.previousSecretUntil > nowIso) {
|
|
67
|
+
secrets.push(unsealSecret(row.previousSecretSealed));
|
|
68
|
+
}
|
|
69
|
+
return secrets.map(parseWebhookSecret).filter((s): s is Buffer => s !== null);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** One attempt; schedules the next on a retryable failure. */
|
|
73
|
+
async function attemptDelivery(
|
|
74
|
+
subscriptionId: string,
|
|
75
|
+
eventId: string,
|
|
76
|
+
body: string,
|
|
77
|
+
attempt: number,
|
|
78
|
+
): Promise<void> {
|
|
79
|
+
const nowIso = new Date().toISOString();
|
|
80
|
+
// Re-read each attempt: an unsubscribe or expiry mid-retry stops delivery.
|
|
81
|
+
const row = await getSubscription(subscriptionId);
|
|
82
|
+
if (!row || row.expiresAt <= nowIso) return;
|
|
83
|
+
// A revoked connection token stops its subscriptions' deliveries at once.
|
|
84
|
+
if (!(await isLiveUserToken(row.tokenId, row.userId))) return;
|
|
85
|
+
const result = await postSignedWebhook({
|
|
86
|
+
url: row.url,
|
|
87
|
+
subscriptionId: row.id,
|
|
88
|
+
// ChatGPT and the design sketch set webhook-id to the eventId. Ours is
|
|
89
|
+
// already unique per (subscription, event), so it is a per-message id.
|
|
90
|
+
webhookId: eventId,
|
|
91
|
+
secrets: signingSecrets(row, nowIso),
|
|
92
|
+
body,
|
|
93
|
+
});
|
|
94
|
+
const atIso = new Date().toISOString();
|
|
95
|
+
if (result.ok) {
|
|
96
|
+
await recordDeliveryOutcome(row.id, { ok: true, atIso });
|
|
97
|
+
return;
|
|
98
|
+
}
|
|
99
|
+
// 410: the receiver declined this event. 413: too large. Neither is retried.
|
|
100
|
+
if (result.status === 410 || result.status === 413) return;
|
|
101
|
+
await recordDeliveryOutcome(row.id, { ok: false, category: result.category, atIso });
|
|
102
|
+
const delay = retryDelaysMs[attempt];
|
|
103
|
+
if (delay === undefined) return;
|
|
104
|
+
const timer = setTimeout(() => {
|
|
105
|
+
pendingTimers.delete(timer);
|
|
106
|
+
void attemptDelivery(subscriptionId, eventId, body, attempt + 1).catch(logError);
|
|
107
|
+
}, delay);
|
|
108
|
+
timer.unref?.();
|
|
109
|
+
pendingTimers.add(timer);
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
function logError(err: unknown): void {
|
|
113
|
+
console.error(
|
|
114
|
+
"[mcp-events] delivery failed:",
|
|
115
|
+
scrubSecrets(err instanceof Error ? err.message : String(err)),
|
|
116
|
+
);
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
type TaskEventPayload = { taskId?: unknown; output?: unknown; failureReason?: unknown };
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Finds the live subscriptions an event matches and starts one delivery per
|
|
123
|
+
* subscription. Resolves once every first attempt has finished.
|
|
124
|
+
*/
|
|
125
|
+
export async function dispatchTaskEvent(name: TaskEventName, payload: unknown): Promise<void> {
|
|
126
|
+
if (!isMcpUserEventsEnabled()) return;
|
|
127
|
+
const { taskId, output, failureReason } = (payload ?? {}) as TaskEventPayload;
|
|
128
|
+
if (typeof taskId !== "string") return;
|
|
129
|
+
const task = await getTaskById(taskId);
|
|
130
|
+
if (!task?.requestedByUserId) return;
|
|
131
|
+
const user = await getUserById(task.requestedByUserId);
|
|
132
|
+
// A deactivated user's subscriptions stay silent until they lapse.
|
|
133
|
+
if (!user || user.status !== "active") return;
|
|
134
|
+
|
|
135
|
+
const now = new Date();
|
|
136
|
+
const subscriptions = await listLiveSubscriptions(user.id, name, now.toISOString());
|
|
137
|
+
if (subscriptions.length === 0) return;
|
|
138
|
+
|
|
139
|
+
const rawDetail = name === "task.completed" ? output : failureReason;
|
|
140
|
+
const detailText = scrubSecrets(typeof rawDetail === "string" ? rawDetail : "");
|
|
141
|
+
const detail = truncate(detailText, MAX_OUTPUT_CHARS);
|
|
142
|
+
const description = truncate(scrubSecrets(task.task ?? ""), MAX_TASK_CHARS);
|
|
143
|
+
const data: Record<string, unknown> = {
|
|
144
|
+
taskId: task.id,
|
|
145
|
+
parentTaskId: task.parentTaskId ?? null,
|
|
146
|
+
status: name === "task.completed" ? "completed" : "failed",
|
|
147
|
+
task: description.text,
|
|
148
|
+
url: `${getAppUrl()}/tasks/${encodeURIComponent(task.id)}`,
|
|
149
|
+
[name === "task.completed" ? "output" : "failureReason"]: detail.text,
|
|
150
|
+
truncated: detail.truncated || description.truncated,
|
|
151
|
+
};
|
|
152
|
+
const timestamp = task.finishedAt ?? now.toISOString();
|
|
153
|
+
|
|
154
|
+
const attempts: Promise<void>[] = [];
|
|
155
|
+
for (const subscription of subscriptions) {
|
|
156
|
+
const args = parseTaskEventArguments(JSON.parse(subscription.argumentsJson));
|
|
157
|
+
if (!args) continue;
|
|
158
|
+
if (args.taskId && !(await isUnderTask(task.id, args.taskId))) continue;
|
|
159
|
+
const eventId = `evt_${createHash("sha256")
|
|
160
|
+
.update(`${subscription.id}\n${name}\n${task.id}`)
|
|
161
|
+
.digest("hex")
|
|
162
|
+
.slice(0, 32)}`;
|
|
163
|
+
let body = JSON.stringify({ eventId, name, timestamp, data, cursor: null });
|
|
164
|
+
if (Buffer.byteLength(body, "utf8") > MAX_DELIVERY_BODY_BYTES) {
|
|
165
|
+
body = JSON.stringify({
|
|
166
|
+
eventId,
|
|
167
|
+
name,
|
|
168
|
+
timestamp,
|
|
169
|
+
data: { ...data, output: undefined, failureReason: undefined, truncated: true },
|
|
170
|
+
cursor: null,
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
attempts.push(attemptDelivery(subscription.id, eventId, body, 0).catch(logError));
|
|
174
|
+
}
|
|
175
|
+
await Promise.all(attempts);
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
const onCompleted = (payload: unknown) => {
|
|
179
|
+
void dispatchTaskEvent("task.completed", payload).catch(logError);
|
|
180
|
+
};
|
|
181
|
+
const onFailed = (payload: unknown) => {
|
|
182
|
+
void dispatchTaskEvent("task.failed", payload).catch(logError);
|
|
183
|
+
};
|
|
184
|
+
|
|
185
|
+
/** Subscribes the dispatcher to task lifecycle events. Idempotent, API server only. */
|
|
186
|
+
export function initMcpEventsDispatcher(): void {
|
|
187
|
+
if (listening) return;
|
|
188
|
+
listening = true;
|
|
189
|
+
workflowEventBus.on("task.completed", onCompleted);
|
|
190
|
+
workflowEventBus.on("task.failed", onFailed);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** Unsubscribes and cancels pending retries (tests, shutdown). */
|
|
194
|
+
export function stopMcpEventsDispatcher(): void {
|
|
195
|
+
if (listening) {
|
|
196
|
+
workflowEventBus.off("task.completed", onCompleted);
|
|
197
|
+
workflowEventBus.off("task.failed", onFailed);
|
|
198
|
+
listening = false;
|
|
199
|
+
}
|
|
200
|
+
for (const timer of pendingTimers) clearTimeout(timer);
|
|
201
|
+
pendingTimers.clear();
|
|
202
|
+
}
|