@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
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
// Pure time formatting for deferral cards, shared by `defer-task` and the
|
|
2
|
+
// channel renderers. Kept apart from the tool so Slack rendering does not load
|
|
3
|
+
// the tool's module graph.
|
|
4
|
+
|
|
5
|
+
export function isValidTimezone(zone: unknown): zone is string {
|
|
6
|
+
if (typeof zone !== "string" || !zone) return false;
|
|
7
|
+
try {
|
|
8
|
+
new Intl.DateTimeFormat("en-US", { timeZone: zone });
|
|
9
|
+
return true;
|
|
10
|
+
} catch {
|
|
11
|
+
return false;
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/** Date/time parts of `date` as rendered in IANA zone `tz`. */
|
|
16
|
+
function partsInTz(date: Date, tz: string) {
|
|
17
|
+
const fmt = new Intl.DateTimeFormat("en-US", {
|
|
18
|
+
timeZone: tz,
|
|
19
|
+
year: "numeric",
|
|
20
|
+
month: "2-digit",
|
|
21
|
+
day: "2-digit",
|
|
22
|
+
hour: "2-digit",
|
|
23
|
+
minute: "2-digit",
|
|
24
|
+
timeZoneName: "short",
|
|
25
|
+
hourCycle: "h23",
|
|
26
|
+
});
|
|
27
|
+
const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
|
|
28
|
+
return {
|
|
29
|
+
year: parts.year!,
|
|
30
|
+
month: parts.month!,
|
|
31
|
+
day: parts.day!,
|
|
32
|
+
hour: parts.hour!,
|
|
33
|
+
minute: parts.minute!,
|
|
34
|
+
abbreviation: parts.timeZoneName!,
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* "today"/"tomorrow" or "MM-dd" plus "HH:MM", both computed in `tz`.
|
|
40
|
+
* Falls back to UTC (parts still computed correctly) if `tz` is not a valid
|
|
41
|
+
* IANA zone — the caller decides whether to label the fallback.
|
|
42
|
+
*/
|
|
43
|
+
export function formatDeferralDateTime(
|
|
44
|
+
target: Date,
|
|
45
|
+
now: Date,
|
|
46
|
+
tz: string,
|
|
47
|
+
labelZone = false,
|
|
48
|
+
): { date: string; time: string } {
|
|
49
|
+
const zone = isValidTimezone(tz) ? tz : "UTC";
|
|
50
|
+
const t = partsInTz(target, zone);
|
|
51
|
+
// Minute precision: this string is read by a human deciding whether to wait,
|
|
52
|
+
// and the wake-up is scheduler-polled anyway, so seconds were false precision.
|
|
53
|
+
const time = `${t.hour}:${t.minute}${labelZone ? ` ${t.abbreviation}` : ""}`;
|
|
54
|
+
const n = partsInTz(now, zone);
|
|
55
|
+
if (t.year === n.year && t.month === n.month && t.day === n.day) return { date: "today", time };
|
|
56
|
+
const tm = partsInTz(new Date(now.getTime() + 86_400_000), zone);
|
|
57
|
+
if (t.year === tm.year && t.month === tm.month && t.day === tm.day) {
|
|
58
|
+
return { date: "tomorrow", time };
|
|
59
|
+
}
|
|
60
|
+
return { date: `${t.month}-${t.day}`, time };
|
|
61
|
+
}
|
|
@@ -38,6 +38,12 @@ export interface RateLimitWindowInfo {
|
|
|
38
38
|
|
|
39
39
|
export type RateLimitWindowTelemetry = Record<string, RateLimitWindowInfo>;
|
|
40
40
|
|
|
41
|
+
/**
|
|
42
|
+
* Name of the `custom` provider event that carries a session's merged window
|
|
43
|
+
* snapshot after each `rate_limit_event`. The runner streams it to the API.
|
|
44
|
+
*/
|
|
45
|
+
export const RATE_LIMIT_WINDOWS_EVENT = "rate_limit_windows";
|
|
46
|
+
|
|
41
47
|
/**
|
|
42
48
|
* A key that hit its provider spend limit (OpenRouter key limit or credits).
|
|
43
49
|
* `resetsAt` is null when the provider names no reset: the key stays benched
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lowest-score-first key ranking, with a 10-point band. Pure: shared by `GET /api/keys/available`
|
|
3
|
+
* (which computes the scores from stored windows) and the worker picker
|
|
4
|
+
* (`selectCredential`). It only orders admissible keys; it never excludes one.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { type ModelFamily, windowForModelFamily } from "./model-rate-limit-windows";
|
|
8
|
+
|
|
9
|
+
/** Key-wide windows that count as a key's usage. Model-scoped weekly windows do not. */
|
|
10
|
+
export const KEY_USAGE_WINDOWS = ["five_hour", "seven_day"] as const;
|
|
11
|
+
|
|
12
|
+
type UsageWindow = { utilization?: number; resetsAt?: number; durationMins?: number };
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* How the worker ranks admissible pool keys (`CREDENTIAL_SELECTION_STRATEGY`).
|
|
16
|
+
* `pace`: most under even use first (`keyPaceFromWindows`). `usage`: lowest
|
|
17
|
+
* utilization first (`keyUsageFromWindows`).
|
|
18
|
+
*/
|
|
19
|
+
export const CREDENTIAL_SELECTION_STRATEGIES = ["pace", "usage"] as const;
|
|
20
|
+
export type CredentialSelectionStrategy = (typeof CREDENTIAL_SELECTION_STRATEGIES)[number];
|
|
21
|
+
|
|
22
|
+
/** Parses the setting. Anything but `pace` is `usage`, the default until `pace` has soaked. */
|
|
23
|
+
export function credentialSelectionStrategy(
|
|
24
|
+
value: string | undefined,
|
|
25
|
+
): CredentialSelectionStrategy {
|
|
26
|
+
return value?.trim().toLowerCase() === "pace" ? "pace" : "usage";
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* A key's current usage, as a utilization fraction (0..1, can exceed 1): the
|
|
31
|
+
* max over its non-expired `five_hour` and `seven_day` windows. A window past
|
|
32
|
+
* `resetsAt` (epoch seconds) counts as 0. No observation counts as 0, so a
|
|
33
|
+
* fresh key ranks first.
|
|
34
|
+
*/
|
|
35
|
+
export function keyUsageFromWindows(
|
|
36
|
+
windows: Record<string, UsageWindow> | null | undefined,
|
|
37
|
+
nowMs: number,
|
|
38
|
+
): number {
|
|
39
|
+
let usage = 0;
|
|
40
|
+
for (const name of KEY_USAGE_WINDOWS) {
|
|
41
|
+
const window = windows?.[name];
|
|
42
|
+
if (!window || typeof window.utilization !== "number" || !Number.isFinite(window.utilization))
|
|
43
|
+
continue;
|
|
44
|
+
if (typeof window.resetsAt === "number" && window.resetsAt * 1000 <= nowMs) continue;
|
|
45
|
+
usage = Math.max(usage, window.utilization);
|
|
46
|
+
}
|
|
47
|
+
return usage;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* A key's pace delta, as a fraction: used minus the share of the window that
|
|
52
|
+
* has passed (the even-use point), taken as the max over the key's live
|
|
53
|
+
* `five_hour` and `seven_day` windows plus the weekly window of `modelFamily`
|
|
54
|
+
* (Fable, Opus, Sonnet) when given. Negative means quota that will go unused
|
|
55
|
+
* by the reset; the lowest delta ranks first, so a key over pace on any of
|
|
56
|
+
* those windows ranks behind one under pace on all of them. A window with no
|
|
57
|
+
* utilization, no reset or a passed reset is skipped. Undefined when none
|
|
58
|
+
* is left: the caller counts it as 0 (on pace), never as a reading.
|
|
59
|
+
*/
|
|
60
|
+
export function keyPaceFromWindows(
|
|
61
|
+
windows: Record<string, UsageWindow> | null | undefined,
|
|
62
|
+
nowMs: number,
|
|
63
|
+
modelFamily?: ModelFamily,
|
|
64
|
+
): number | undefined {
|
|
65
|
+
const modelWindow = modelFamily ? windowForModelFamily(modelFamily) : undefined;
|
|
66
|
+
let pace: number | undefined;
|
|
67
|
+
for (const name of [...KEY_USAGE_WINDOWS, ...(modelWindow ? [modelWindow] : [])]) {
|
|
68
|
+
const window = windows?.[name];
|
|
69
|
+
if (!window || typeof window.utilization !== "number" || !Number.isFinite(window.utilization))
|
|
70
|
+
continue;
|
|
71
|
+
if (typeof window.resetsAt !== "number" || window.resetsAt * 1000 <= nowMs) continue;
|
|
72
|
+
const durationMs = (window.durationMins ?? (name === "five_hour" ? 300 : 10080)) * 60_000;
|
|
73
|
+
const elapsed = Math.min(1, Math.max(0, 1 - (window.resetsAt * 1000 - nowMs) / durationMs));
|
|
74
|
+
pace = Math.max(pace ?? Number.NEGATIVE_INFINITY, window.utilization - elapsed);
|
|
75
|
+
}
|
|
76
|
+
return pace;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Width of the low-score band, as a utilization fraction. Every admissible key
|
|
81
|
+
* within this distance of the lowest score (usage or pace delta) is an equal candidate.
|
|
82
|
+
*/
|
|
83
|
+
export const KEY_USAGE_BAND = 0.1;
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Picks the key for a draw among `indices`:
|
|
87
|
+
* 1. the keys whose score (usage or pace delta) is within `band` of the lowest;
|
|
88
|
+
* 2. among them, the keys with the fewest running sessions (`sessionsByIndex`);
|
|
89
|
+
* 3. ties at random.
|
|
90
|
+
*
|
|
91
|
+
* A plain minimum would send every concurrent draw to one key until the next
|
|
92
|
+
* usage report lands. The session count moves at session start, so a burst
|
|
93
|
+
* spreads within seconds; the band still covers draws that land before the
|
|
94
|
+
* session-start report. An index with no usage or session entry counts as 0.
|
|
95
|
+
*/
|
|
96
|
+
export function pickLowestUsage(
|
|
97
|
+
indices: readonly number[],
|
|
98
|
+
usageByIndex: readonly (number | null | undefined)[] | undefined,
|
|
99
|
+
sessionsByIndex?: readonly (number | null | undefined)[],
|
|
100
|
+
random: () => number = Math.random,
|
|
101
|
+
band: number = KEY_USAGE_BAND,
|
|
102
|
+
): number | undefined {
|
|
103
|
+
if (indices.length === 0) return undefined;
|
|
104
|
+
const entryAt = (values: typeof usageByIndex, i: number) => {
|
|
105
|
+
const value = values?.[i];
|
|
106
|
+
return typeof value === "number" && Number.isFinite(value) ? value : 0;
|
|
107
|
+
};
|
|
108
|
+
const lowest = Math.min(...indices.map((i) => entryAt(usageByIndex, i)));
|
|
109
|
+
// The epsilon keeps a key exactly `band` above the lowest inside the band.
|
|
110
|
+
const inBand = indices.filter((i) => entryAt(usageByIndex, i) <= lowest + band + 1e-9);
|
|
111
|
+
const fewest = Math.min(...inBand.map((i) => entryAt(sessionsByIndex, i)));
|
|
112
|
+
const best = inBand.filter((i) => entryAt(sessionsByIndex, i) === fewest);
|
|
113
|
+
return best[Math.floor(random() * best.length)];
|
|
114
|
+
}
|
|
@@ -2,6 +2,14 @@ import { AsyncLocalStorage } from "node:async_hooks";
|
|
|
2
2
|
import type { IncomingMessage } from "node:http";
|
|
3
3
|
import type { User } from "../types";
|
|
4
4
|
|
|
5
|
+
/** Provenance carried by a script run's credential. */
|
|
6
|
+
export type ScriptRunProvenance = {
|
|
7
|
+
sourceStepId?: string;
|
|
8
|
+
sourceScriptRunId?: string;
|
|
9
|
+
objectChain?: string[];
|
|
10
|
+
depth?: number;
|
|
11
|
+
};
|
|
12
|
+
|
|
5
13
|
export type HttpRequestAuth = (
|
|
6
14
|
| { kind: "operator"; fingerprint: string }
|
|
7
15
|
/**
|
|
@@ -14,7 +22,7 @@ export type HttpRequestAuth = (
|
|
|
14
22
|
| { kind: "guest" }
|
|
15
23
|
| { kind: "controller"; controllerId: string; tokenId: string; expiresAt: string }
|
|
16
24
|
/** Session token bound to an ACP task, a worker runtime, or only its agent (aseph_ prefix). */
|
|
17
|
-
| {
|
|
25
|
+
| ({
|
|
18
26
|
kind: "agent";
|
|
19
27
|
tokenKind: "task" | "runtime" | "agent";
|
|
20
28
|
agentId: string;
|
|
@@ -22,14 +30,7 @@ export type HttpRequestAuth = (
|
|
|
22
30
|
runtimeId: string | null;
|
|
23
31
|
tokenId: string;
|
|
24
32
|
expiresAt: string;
|
|
25
|
-
|
|
26
|
-
* Set on a script run's per-run token (`mintScriptRunToken`): the
|
|
27
|
-
* swarm-script workflow step that started the run, and the run's own
|
|
28
|
-
* `script_runs` row. Rows the request creates are stamped with them.
|
|
29
|
-
*/
|
|
30
|
-
sourceStepId?: string | null;
|
|
31
|
-
sourceScriptRunId?: string | null;
|
|
32
|
-
}
|
|
33
|
+
} & ScriptRunProvenance)
|
|
33
34
|
) & {
|
|
34
35
|
/** Verified page context for agent-scoped operations. This does not identify the viewer. */
|
|
35
36
|
page?: { id: string; executionAgentId: string };
|
|
@@ -104,19 +105,17 @@ export function getCurrentRequestUserId(): string | undefined {
|
|
|
104
105
|
return authUserId(getCurrentRequestAuth());
|
|
105
106
|
}
|
|
106
107
|
|
|
107
|
-
/** Where the current request's script run came from, when it presents a script-run token. */
|
|
108
|
-
export type RunProvenance = { sourceStepId: string | null; sourceScriptRunId: string | null };
|
|
109
|
-
|
|
110
108
|
/**
|
|
111
109
|
* Provenance of the current request: set only when it authenticated with a
|
|
112
110
|
* script run's per-run token that recorded a step or a script run. Async work
|
|
113
111
|
* started inside the request inherits it (the workflow engine continuing a run
|
|
114
112
|
* it triggered), so callers stamp only rows a script can create directly.
|
|
115
113
|
*/
|
|
116
|
-
export function getCurrentRunProvenance():
|
|
114
|
+
export function getCurrentRunProvenance(): ScriptRunProvenance | null {
|
|
117
115
|
const auth = getCurrentRequestAuth();
|
|
118
116
|
if (auth?.kind !== "agent") return null;
|
|
119
|
-
const sourceStepId = auth
|
|
120
|
-
|
|
121
|
-
|
|
117
|
+
const { sourceStepId, sourceScriptRunId, objectChain, depth } = auth;
|
|
118
|
+
return sourceStepId || sourceScriptRunId || objectChain !== undefined || depth
|
|
119
|
+
? { sourceStepId, sourceScriptRunId, objectChain, depth }
|
|
120
|
+
: null;
|
|
122
121
|
}
|
|
@@ -61,7 +61,7 @@ import { GITLEAKS_RULES } from "./secret-rules.generated";
|
|
|
61
61
|
* LangSmith, CircleCI, Google `AQ.`, HubSpot, New Relic and Sentry DSN
|
|
62
62
|
* shapes; pass 4 redacts a PEM private key cut off before its END line.
|
|
63
63
|
*/
|
|
64
|
-
export const SCRUBBER_RULES_VERSION =
|
|
64
|
+
export const SCRUBBER_RULES_VERSION = 16;
|
|
65
65
|
|
|
66
66
|
/** Env-var names that are always considered secrets, even without suffix hints. */
|
|
67
67
|
const SENSITIVE_KEY_EXACT = new Set<string>([
|
package/src/workflows/engine.ts
CHANGED
|
@@ -57,7 +57,7 @@ import {
|
|
|
57
57
|
import { getSecretInputKeys, redactSecretsForStorage, resolveInputs } from "./input";
|
|
58
58
|
import { validateJsonSchema } from "./json-schema-validator";
|
|
59
59
|
import { getMaxWorkflowStepsPerRun } from "./limits";
|
|
60
|
-
import {
|
|
60
|
+
import { runWithNodeDeadline } from "./node-timeout";
|
|
61
61
|
import { findWorkflowReadinessProblems, formatReadinessRunError } from "./readiness";
|
|
62
62
|
import {
|
|
63
63
|
hasOwedSuccessors,
|
|
@@ -1127,18 +1127,13 @@ async function runClaimedStep(
|
|
|
1127
1127
|
inputCtx: interpolationCtx,
|
|
1128
1128
|
};
|
|
1129
1129
|
|
|
1130
|
-
const deadline = startStepDeadline(resolveNodeTimeoutMs(node));
|
|
1131
|
-
|
|
1132
1130
|
let result: Awaited<ReturnType<typeof executor.run>>;
|
|
1133
1131
|
try {
|
|
1134
|
-
result = await
|
|
1135
|
-
|
|
1136
|
-
|
|
1137
|
-
|
|
1138
|
-
|
|
1139
|
-
}),
|
|
1140
|
-
deadline.expired,
|
|
1141
|
-
]).finally(deadline.clear);
|
|
1132
|
+
result = await runWithNodeDeadline(node, executor, {
|
|
1133
|
+
config: interpolatedConfig,
|
|
1134
|
+
context: executionCtx,
|
|
1135
|
+
meta,
|
|
1136
|
+
});
|
|
1142
1137
|
} catch (err) {
|
|
1143
1138
|
const errorMsg = err instanceof Error ? err.message : String(err);
|
|
1144
1139
|
|
|
@@ -18,7 +18,6 @@ import {
|
|
|
18
18
|
MIN_SCRIPT_WALL_CLOCK_MS,
|
|
19
19
|
} from "../../scripts-runtime/executors/types";
|
|
20
20
|
import type { ExecutorMeta } from "../../types";
|
|
21
|
-
import { getMcpBaseUrl } from "../../utils/constants";
|
|
22
21
|
import { findInterpolationTokens } from "../../utils/template";
|
|
23
22
|
import { BaseExecutor, type ExecutorResult } from "./base";
|
|
24
23
|
|
|
@@ -136,7 +135,6 @@ export class SwarmScriptExecutor extends BaseExecutor<
|
|
|
136
135
|
fsMode: "none",
|
|
137
136
|
executor: resolved.script.executor,
|
|
138
137
|
agentId: agentId ?? "workflow",
|
|
139
|
-
mcpBaseUrl: getMcpBaseUrl(),
|
|
140
138
|
egressSecrets: credentials.egressSecrets,
|
|
141
139
|
failedBindings: credentials.failedBindings,
|
|
142
140
|
userConfig: credentials.userConfig,
|
|
@@ -47,7 +47,7 @@ import {
|
|
|
47
47
|
settleForeachChild,
|
|
48
48
|
} from "./foreach-join";
|
|
49
49
|
import { getSecretInputKeys } from "./input";
|
|
50
|
-
import {
|
|
50
|
+
import { runWithNodeDeadline } from "./node-timeout";
|
|
51
51
|
import { rebuildNodeExecutionInput } from "./step-input";
|
|
52
52
|
import { claimAndOweWalk, type SuccessorWalkDebt } from "./successor-routing";
|
|
53
53
|
|
|
@@ -521,21 +521,15 @@ async function startChild(input: {
|
|
|
521
521
|
}
|
|
522
522
|
|
|
523
523
|
const executor = registry.get(bodyType);
|
|
524
|
-
const deadline = startStepDeadline(resolveNodeTimeoutMs({ type: bodyType, config }));
|
|
525
524
|
let result: Awaited<ReturnType<typeof executor.run>>;
|
|
526
525
|
try {
|
|
527
|
-
result = await
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
}),
|
|
533
|
-
deadline.expired,
|
|
534
|
-
]);
|
|
526
|
+
result = await runWithNodeDeadline({ type: bodyType, config }, executor, {
|
|
527
|
+
config,
|
|
528
|
+
context: { ...ctx, ...bodyCtx },
|
|
529
|
+
meta: { ...meta, stepId: child.id, nodeId: child.nodeId },
|
|
530
|
+
});
|
|
535
531
|
} catch (err) {
|
|
536
532
|
return { status: "failed", error: err instanceof Error ? err.message : String(err) };
|
|
537
|
-
} finally {
|
|
538
|
-
deadline.clear();
|
|
539
533
|
}
|
|
540
534
|
|
|
541
535
|
if (result.status === "failed") {
|
package/src/workflows/input.ts
CHANGED
|
@@ -23,16 +23,39 @@ export async function resolveInputs(
|
|
|
23
23
|
return resolved;
|
|
24
24
|
}
|
|
25
25
|
|
|
26
|
+
/**
|
|
27
|
+
* The `${ENV_VAR}` names a workflow may read, from `WORKFLOW_INPUT_ENV_ALLOWLIST`
|
|
28
|
+
* (comma-separated, blanks ignored). Null means the variable is unset and imposes no
|
|
29
|
+
* restriction. An explicitly empty list allows no names. Read on every call, so a config
|
|
30
|
+
* reload applies at once.
|
|
31
|
+
*/
|
|
32
|
+
export function workflowInputEnvAllowlist(): Set<string> | null {
|
|
33
|
+
const raw = process.env.WORKFLOW_INPUT_ENV_ALLOWLIST;
|
|
34
|
+
if (raw === undefined) return null;
|
|
35
|
+
const names = raw
|
|
36
|
+
.split(",")
|
|
37
|
+
.map((name) => name.trim())
|
|
38
|
+
.filter((name) => name.length > 0);
|
|
39
|
+
return new Set(names);
|
|
40
|
+
}
|
|
41
|
+
|
|
26
42
|
/**
|
|
27
43
|
* Resolve a single input value, supporting `${ENV_VAR}` and `secret.NAME`
|
|
28
44
|
* references. A plain string is returned unchanged. Throws if a referenced
|
|
29
|
-
* env var or swarm secret cannot be found
|
|
45
|
+
* env var or swarm secret cannot be found, or if `WORKFLOW_INPUT_ENV_ALLOWLIST`
|
|
46
|
+
* is set and does not list the env var. This is the only place `${ENV_VAR}` is
|
|
47
|
+
* resolved: workflow input (`resolveInputs`) and webhook HMAC secrets both come here.
|
|
30
48
|
*/
|
|
31
49
|
export async function resolveInputValue(value: string): Promise<string> {
|
|
32
50
|
// Env var reference: ${MY_VAR}
|
|
33
51
|
const envMatch = /^\$\{(.+)\}$/.exec(value);
|
|
34
52
|
if (envMatch?.[1]) {
|
|
35
53
|
const envName = envMatch[1];
|
|
54
|
+
const allowed = workflowInputEnvAllowlist();
|
|
55
|
+
// Checked before the read, so a name outside the list never touches process.env.
|
|
56
|
+
if (allowed && !allowed.has(envName)) {
|
|
57
|
+
throw new Error(`Environment variable "${envName}" is not in WORKFLOW_INPUT_ENV_ALLOWLIST`);
|
|
58
|
+
}
|
|
36
59
|
const envValue = process.env[envName];
|
|
37
60
|
if (envValue === undefined) {
|
|
38
61
|
throw new Error(`Environment variable "${envName}" is not set`);
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { WorkflowNode } from "../types";
|
|
2
|
+
import type { BaseExecutor, ExecutorInput } from "./executors/base";
|
|
2
3
|
|
|
3
4
|
/** Watchdog budget for a node that configures none. */
|
|
4
5
|
export const DEFAULT_NODE_TIMEOUT_MS = 30_000;
|
|
@@ -49,3 +50,20 @@ export function startStepDeadline(timeoutMs: number): StepDeadline {
|
|
|
49
50
|
});
|
|
50
51
|
return { signal: controller.signal, expired, clear: () => clearTimeout(timer) };
|
|
51
52
|
}
|
|
53
|
+
|
|
54
|
+
/** Give each executor invocation its own deadline, including retries. */
|
|
55
|
+
export async function runWithNodeDeadline(
|
|
56
|
+
node: Pick<WorkflowNode, "type" | "config">,
|
|
57
|
+
executor: BaseExecutor,
|
|
58
|
+
input: ExecutorInput,
|
|
59
|
+
) {
|
|
60
|
+
const deadline = startStepDeadline(resolveNodeTimeoutMs(node));
|
|
61
|
+
try {
|
|
62
|
+
return await Promise.race([
|
|
63
|
+
executor.run({ ...input, meta: { ...input.meta, signal: deadline.signal } }),
|
|
64
|
+
deadline.expired,
|
|
65
|
+
]);
|
|
66
|
+
} finally {
|
|
67
|
+
deadline.clear();
|
|
68
|
+
}
|
|
69
|
+
}
|
package/src/workflows/resume.ts
CHANGED
|
@@ -764,7 +764,10 @@ export async function cancelWorkflowRunRows(
|
|
|
764
764
|
const withDependents =
|
|
765
765
|
openTaskIds.length > 0 ? await getTaskIdsWithDependents() : new Set<string>();
|
|
766
766
|
for (const taskId of openTaskIds) {
|
|
767
|
-
await cancelTask(taskId, cancelReason, {
|
|
767
|
+
await cancelTask(taskId, cancelReason, {
|
|
768
|
+
cascadeDependents: withDependents.has(taskId),
|
|
769
|
+
statusKind: "workflow",
|
|
770
|
+
});
|
|
768
771
|
}
|
|
769
772
|
await cancelOpenWorkflowTreeSteps(runIds, cancelReason, now);
|
|
770
773
|
await disarmWorkflowTreeRetries(runIds, now);
|
|
@@ -871,7 +874,7 @@ export async function cancelWorkflowRunStep(
|
|
|
871
874
|
}
|
|
872
875
|
|
|
873
876
|
const task = await getTaskByWorkflowRunStepId(stepId);
|
|
874
|
-
if (task) await cancelTask(task.id, reason);
|
|
877
|
+
if (task) await cancelTask(task.id, reason, { statusKind: "workflow" });
|
|
875
878
|
await updateWorkflowRunStep(stepId, {
|
|
876
879
|
status: "cancelled",
|
|
877
880
|
error: reason,
|
|
@@ -25,6 +25,7 @@ import type { AsyncExecutorResult } from "./executors/base";
|
|
|
25
25
|
import type { ExecutorRegistry } from "./executors/registry";
|
|
26
26
|
import { FOREACH_ITEMS_WAIT_FOR, parkAndDriveForeach, runForeachDrive } from "./foreach-driver";
|
|
27
27
|
import { resolveForeachParent } from "./foreach-join";
|
|
28
|
+
import { runWithNodeDeadline } from "./node-timeout";
|
|
28
29
|
import { rebuildNodeExecutionInput } from "./step-input";
|
|
29
30
|
import { hasOwedSuccessors } from "./successor-routing";
|
|
30
31
|
import { runStepValidation, validateOutputSchema } from "./validation";
|
|
@@ -124,7 +125,7 @@ export function startRetryPoller(registry: ExecutorRegistry, intervalMs = 5000):
|
|
|
124
125
|
};
|
|
125
126
|
|
|
126
127
|
try {
|
|
127
|
-
const result = await executor
|
|
128
|
+
const result = await runWithNodeDeadline(node, executor, {
|
|
128
129
|
config: interpolatedConfig,
|
|
129
130
|
context: ctx,
|
|
130
131
|
meta,
|
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
import crypto from "node:crypto";
|
|
2
|
-
import {
|
|
2
|
+
import {
|
|
3
|
+
getWorkflow,
|
|
4
|
+
getWorkflowsByEventName,
|
|
5
|
+
getWorkflowsByScheduleId,
|
|
6
|
+
listWorkflows,
|
|
7
|
+
} from "../be/db";
|
|
3
8
|
import type { ScheduledTask, TriggerConfig } from "../types";
|
|
9
|
+
import { scrubSecrets } from "../utils/secret-scrubber";
|
|
4
10
|
import { startWorkflowExecution } from "./engine";
|
|
5
11
|
import type { ExecutorRegistry } from "./executors/registry";
|
|
6
12
|
import { resolveInputValue } from "./input";
|
|
@@ -300,25 +306,29 @@ export async function logOpenWebhookTriggers(): Promise<void> {
|
|
|
300
306
|
|
|
301
307
|
/**
|
|
302
308
|
* Start every enabled workflow subscribed to a named in-process event.
|
|
303
|
-
* Returns the workflow run IDs in workflow-list order.
|
|
309
|
+
* Returns the workflow run IDs in workflow-list order. A failed subscriber
|
|
310
|
+
* start is logged without preventing delivery to the remaining subscribers.
|
|
304
311
|
*/
|
|
305
312
|
export async function handleEventTrigger(
|
|
306
313
|
eventName: string,
|
|
307
314
|
payload: unknown,
|
|
308
315
|
registry: ExecutorRegistry,
|
|
309
316
|
): Promise<string[]> {
|
|
310
|
-
const workflows =
|
|
311
|
-
workflow.triggers.some(
|
|
312
|
-
(trigger) => trigger.type === "event" && trigger.eventName === eventName,
|
|
313
|
-
),
|
|
314
|
-
);
|
|
317
|
+
const workflows = await getWorkflowsByEventName(eventName);
|
|
315
318
|
|
|
316
319
|
const runIds: string[] = [];
|
|
317
320
|
for (const workflow of workflows) {
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
321
|
+
try {
|
|
322
|
+
const runId = await startWorkflowExecution(workflow, payload, registry, {
|
|
323
|
+
triggerType: "event",
|
|
324
|
+
});
|
|
325
|
+
runIds.push(runId);
|
|
326
|
+
} catch (err) {
|
|
327
|
+
console.error(
|
|
328
|
+
`[workflows] Failed to start workflow ${workflow.id} for ${eventName} event trigger:`,
|
|
329
|
+
scrubSecrets(err instanceof Error ? err.message : String(err)),
|
|
330
|
+
);
|
|
331
|
+
}
|
|
322
332
|
}
|
|
323
333
|
return runIds;
|
|
324
334
|
}
|
package/src/x/composio.ts
CHANGED
|
@@ -86,6 +86,7 @@ export function parseComposioArgs(
|
|
|
86
86
|
if ((method === "GET" || method === "HEAD") && parsed.body !== undefined) {
|
|
87
87
|
throw new Error(`${method} requests cannot include --body`);
|
|
88
88
|
}
|
|
89
|
+
buildComposioUrl(parsed.baseUrl, parsed.endpoint, []);
|
|
89
90
|
|
|
90
91
|
return parsed;
|
|
91
92
|
}
|
|
@@ -131,6 +132,8 @@ export async function executeComposioRequest(
|
|
|
131
132
|
body: args.body === undefined ? undefined : JSON.stringify(args.body),
|
|
132
133
|
headers,
|
|
133
134
|
method: args.method,
|
|
135
|
+
// A redirect would carry the key header to the new host.
|
|
136
|
+
redirect: "manual",
|
|
134
137
|
});
|
|
135
138
|
} catch (err) {
|
|
136
139
|
return {
|
|
@@ -183,9 +186,11 @@ export function composioArgsFromParts(input: {
|
|
|
183
186
|
throw new Error(`${method} requests cannot include a body`);
|
|
184
187
|
}
|
|
185
188
|
assertRelativeComposioPath(input.endpoint);
|
|
189
|
+
const baseUrl = input.baseUrl || process.env.COMPOSIO_BASE_URL || DEFAULT_COMPOSIO_BASE_URL;
|
|
190
|
+
buildComposioUrl(baseUrl, input.endpoint, []);
|
|
186
191
|
|
|
187
192
|
return {
|
|
188
|
-
baseUrl
|
|
193
|
+
baseUrl,
|
|
189
194
|
body: input.body,
|
|
190
195
|
endpoint: input.endpoint,
|
|
191
196
|
headers: input.headers ?? {},
|
|
@@ -228,6 +233,10 @@ function buildComposioUrl(
|
|
|
228
233
|
const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
|
|
229
234
|
const cleanEndpoint = endpoint.replace(/^\/+/, "");
|
|
230
235
|
const url = new URL(cleanEndpoint, normalizedBase);
|
|
236
|
+
// The key header is bound to the base URL's host: a path must not change it.
|
|
237
|
+
if (url.origin !== new URL(normalizedBase).origin) {
|
|
238
|
+
throw new Error("endpoint must be a Composio API path on the configured base URL");
|
|
239
|
+
}
|
|
231
240
|
for (const [key, value] of query) {
|
|
232
241
|
url.searchParams.append(key, value);
|
|
233
242
|
}
|
|
@@ -7,6 +7,8 @@ description: Build and iterate on schema-backed Swarm Apps with live models, nam
|
|
|
7
7
|
|
|
8
8
|
Swarm Apps are persistent, agent-authored internal applications: a schema-backed row store, named queries, custom script/task actions, and a validated json-render interface served at `/apps/<id>`. Use an app when people need to view and change live records; use `create_page` for a static snapshot.
|
|
9
9
|
|
|
10
|
+
**When to use a sheet or board instead:** a tracker or grid people keep editing, with no queries or actions, is a sheet. A plan, diagram or map to think through is a board. Both are editable agent-fs files; see the `boards-and-sheets` skill. To show one inside an app, use the `ObjectEmbed` component (section "Embed a sheet or board").
|
|
11
|
+
|
|
10
12
|
> **Capability gate**: app tools are available when the server's `CAPABILITIES` includes `pages` (for example `CAPABILITIES=core,task-pool,pages`). There is no separate `apps` capability. If these tools are absent from your MCP list, this is why.
|
|
11
13
|
|
|
12
14
|
## Tools and iteration loop
|
|
@@ -32,6 +34,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
|
|
|
32
34
|
|
|
33
35
|
For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
|
|
34
36
|
|
|
37
|
+
When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
|
|
38
|
+
|
|
35
39
|
`app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
|
|
36
40
|
|
|
37
41
|
### Reading an app's callable surface
|
|
@@ -177,7 +181,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
|
|
|
177
181
|
|
|
178
182
|
Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
|
|
179
183
|
|
|
180
|
-
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-
|
|
184
|
+
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
|
|
181
185
|
|
|
182
186
|
### Reusable elements
|
|
183
187
|
|
|
@@ -409,7 +413,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
|
|
|
409
413
|
|
|
410
414
|
For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
|
|
411
415
|
|
|
412
|
-
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
416
|
+
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
413
417
|
|
|
414
418
|
### Pages, routes, and page trees
|
|
415
419
|
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
Swarm Apps are persistent, agent-authored internal applications: a schema-backed row store, named queries, custom script/task actions, and a validated json-render interface served at `/apps/<id>`. Use an app when people need to view and change live records; use `create_page` for a static snapshot.
|
|
4
4
|
|
|
5
|
+
**When to use a sheet or board instead:** a tracker or grid people keep editing, with no queries or actions, is a sheet. A plan, diagram or map to think through is a board. Both are editable agent-fs files; see the `boards-and-sheets` skill. To show one inside an app, use the `ObjectEmbed` component (section "Embed a sheet or board").
|
|
6
|
+
|
|
5
7
|
> **Capability gate**: app tools are available when the server's `CAPABILITIES` includes `pages` (for example `CAPABILITIES=core,task-pool,pages`). There is no separate `apps` capability. If these tools are absent from your MCP list, this is why.
|
|
6
8
|
|
|
7
9
|
## Tools and iteration loop
|
|
@@ -27,6 +29,8 @@ Swarm Apps are persistent, agent-authored internal applications: a schema-backed
|
|
|
27
29
|
|
|
28
30
|
For every edit: `app-get` -> modify the smallest coherent subtree -> `app-patch` -> if rejected, fix every returned `issues[]` entry (`path` + `message`) and retry. Validation happens before storage, so a rejected update leaves the saved app unchanged. Do not guess at the current definition or use `app-upsert` with a partial definition.
|
|
29
31
|
|
|
32
|
+
When refreshing row data, write only the diff: read the current rows with `app-rows-list`, then `app-row-patch` the changed rows, `app-rows-create` the new ones, and `app-row-delete` the removed ones. Do not delete every row and recreate it, or recreate the model: a large rewrite can be interrupted partway and leave the app half-populated.
|
|
33
|
+
|
|
30
34
|
`app-patch` can also change `name`; omit `description` to preserve it or pass `description: null` to clear it.
|
|
31
35
|
|
|
32
36
|
### Reading an app's callable surface
|
|
@@ -172,7 +176,7 @@ When a schema patch reports stale page/query bindings, repair them in that same
|
|
|
172
176
|
|
|
173
177
|
Optional top-level `layout: "sidebar"` turns on the app shell (see Pages, routes, and page trees). Without it every page renders on the plain canvas, exactly as before.
|
|
174
178
|
|
|
175
|
-
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-
|
|
179
|
+
Model, reusable-element, element-prop, query, action, column, page, and page-param names start with a lowercase letter, contain only letters, numbers, or underscores, and are at most 40 characters. A definition has 0-50 models, at most 100 actions, and at most 20 reusable elements; each declared model has 1-200 columns. Operators can change the model, column and action caps per swarm (`APPS_MAX_MODELS`, `APPS_MAX_COLUMNS_PER_MODEL`, `APPS_MAX_ACTIONS`, 1-1000 each); the save error names the current cap. Zero-model apps are valid for pure UI utilities as long as their pages and reusable elements validate.
|
|
176
180
|
|
|
177
181
|
### Reusable elements
|
|
178
182
|
|
|
@@ -404,7 +408,7 @@ Use a task action named Tackle when a person should hand one issue row to the sw
|
|
|
404
408
|
|
|
405
409
|
For direct MCP calls, `app-query` accepts `{ appId, query, params? }` and returns rows from that declared named query; every supplied param must be referenced by a `$param` filter in that query. Use it when an agent needs to read app state without scraping the UI.
|
|
406
410
|
|
|
407
|
-
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
411
|
+
Saved scripts use the generated SDK name `ctx.swarm.app_query({ appId, query, params? })`. Use `app_query` in scripts or workflows that turn current app rows into reports, digests, or follow-up work. Saved scripts also get generated per-app types automatically: each app contributes an `App_<Name>` namespace with one row interface per model (enum columns as literal unions) and a typed `app_query` overload per named query, all visible via `script-query-types`. A script is typechecked against only the apps it names (literal app id or `App_<Name>`). Types are budgeted at 1 MiB per app and 4 MiB for all the apps one script names. An app past a budget loses its types (calls still work, untyped): `app-upsert` and `app-patch` warn when the app is over the per-app budget, and `script-upsert` warns for each untyped app the script names. Scripts can create, list, get, patch, and delete rows with the seven row tools. Actions remain REST/MCP-only and have no script SDK method.
|
|
408
412
|
|
|
409
413
|
### Pages, routes, and page trees
|
|
410
414
|
|