@desplega.ai/agent-swarm 2.13.3 → 2.13.4
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-mr4temec.js +17 -0
- package/dist/{acp-targets-k8xs4tj8.js → acp-targets-zrk9k0n7.js} +10 -10
- package/dist/{actions-pg5fxjer.js → actions-acqqj9jn.js} +236 -26
- package/dist/{agent-fs-provision-vbk3fppw.js → agent-fs-provision-zmaykqnd.js} +4 -4
- package/dist/{amp-adapter-adbhxsz9.js → amp-adapter-a7ts8tmw.js} +3 -3
- package/dist/{app-b267ggx1.js → app-tmwa442h.js} +7 -7
- package/dist/{approval-notifications-evc1a9z5.js → approval-notifications-6psaaaye.js} +8 -8
- package/dist/{assistant-wgz2ab84.js → assistant-564v6emv.js} +24 -24
- package/dist/{boot-args-schema-6tpk28j4.js → boot-args-schema-n099e0f2.js} +1 -1
- package/dist/{boot-reembed-ankp369c.js → boot-reembed-chx66qfk.js} +1 -1
- package/dist/{boot-reembed-r1zyvefv.js → boot-reembed-epvg4fp9.js} +1 -1
- package/dist/{boot-scrub-sweep-cgb6r5bd.js → boot-scrub-sweep-dhkfp0a7.js} +2 -2
- package/dist/{boot-seeds-bjceqg7b.js → boot-seeds-m74fc07r.js} +4 -4
- package/dist/{boxd-hr8rsxzq.js → boxd-451q55ys.js} +1 -1
- package/dist/{claude-adapter-knztdnff.js → claude-adapter-hw63yj3j.js} +9 -9
- package/dist/{claude-managed-adapter-qwejzqkk.js → claude-managed-adapter-z5s7fx6p.js} +3 -3
- package/dist/{claude-managed-setup-0vgz4d1j.js → claude-managed-setup-wee1762m.js} +3 -3
- package/dist/{claude-sdk-session-c3g6dv0g.js → claude-sdk-session-cktyqkpk.js} +11 -11
- package/dist/{cli-7fa6yv98.js → cli-0fgvnb0x.js} +6 -6
- package/dist/{cli-2v4xxnx2.js → cli-0h8skzss.js} +1 -1
- package/dist/{cli-hhb8kbwd.js → cli-0p76my9q.js} +29 -14
- package/dist/{cli-fp65jdp2.js → cli-1kvcsd2f.js} +219 -155
- package/dist/{cli-wtffytm8.js → cli-1vmhnncj.js} +3 -3
- package/dist/{cli-268b3dgn.js → cli-29h5239w.js} +5 -5
- package/dist/{cli-8fj8yfmk.js → cli-2vp0z049.js} +1 -1
- package/dist/{cli-bh53ppqm.js → cli-3bxrrh53.js} +4 -4
- package/dist/{cli-61fzwtjk.js → cli-3tzmh38q.js} +9 -9
- package/dist/{cli-88np9va3.js → cli-3xqad83h.js} +1 -1
- package/dist/{cli-gc715jrc.js → cli-3zrwrnz7.js} +1 -1
- package/dist/{cli-dw43pnzp.js → cli-404am6f3.js} +7 -7
- package/dist/{cli-8pnawt98.js → cli-49aq3cyn.js} +4 -4
- package/dist/{cli-fbmgpt72.js → cli-4fpa0zns.js} +3 -3
- package/dist/{cli-kwm1bek7.js → cli-4pbwg7sn.js} +2 -2
- package/dist/{cli-djwt4mtn.js → cli-4q2c8rxw.js} +9 -9
- package/dist/{cli-3mf04tkh.js → cli-4vynxtrb.js} +1 -1
- package/dist/{cli-80d5g0fa.js → cli-5ashycw3.js} +3 -3
- package/dist/{cli-61p7ty8d.js → cli-5rgm8p39.js} +3 -3
- package/dist/{cli-r6xnchva.js → cli-5rxsb3wq.js} +6 -6
- package/dist/{cli-a21cwm89.js → cli-60dwk8tx.js} +3 -3
- package/dist/{cli-v1v49t36.js → cli-7by7vp6m.js} +2 -2
- package/dist/{cli-vgh5adn9.js → cli-7g3fg4gf.js} +7 -7
- package/dist/{cli-hxj888w3.js → cli-7gbff32z.js} +2 -2
- package/dist/{cli-q8aq48v1.js → cli-8b4rpnwj.js} +1 -1
- package/dist/{cli-xc8m5cjn.js → cli-8cas2xvp.js} +3 -3
- package/dist/{cli-1606qw3n.js → cli-904wk98s.js} +797 -369
- package/dist/{cli-h3drhntp.js → cli-93n305hm.js} +2 -2
- package/dist/{cli-1wew39p0.js → cli-944w9wb4.js} +20 -16
- package/dist/{cli-je587f74.js → cli-94gx6ze9.js} +1 -1
- package/dist/{cli-hpxcfvdm.js → cli-9ah37a8a.js} +6 -6
- package/dist/{cli-rfejbpe1.js → cli-akm6y2a8.js} +1 -1
- package/dist/{cli-f8rcvf2x.js → cli-azj9t1f9.js} +37 -2
- package/dist/{cli-ef590376.js → cli-bv4vvnmg.js} +3 -3
- package/dist/{cli-ppf9ap9n.js → cli-bzcwwebm.js} +1 -1
- package/dist/{cli-sy2ge2ye.js → cli-cq4am6vg.js} +2 -2
- package/dist/{cli-gxqwm3k3.js → cli-d5pc8ep0.js} +102 -8
- package/dist/{cli-hd2a204w.js → cli-ea7nz50q.js} +12 -12
- package/dist/{cli-zkbz8m2q.js → cli-fkpnx3vf.js} +1 -1
- package/dist/{cli-ya1cj689.js → cli-fw67mnyc.js} +1 -1
- package/dist/{cli-5basv0e7.js → cli-gkv0r2hq.js} +1 -1
- package/dist/{cli-ka4tqjzd.js → cli-gse7bp3z.js} +12 -10
- package/dist/{cli-v8rpjrnx.js → cli-gtj12v95.js} +1 -1
- package/dist/{cli-g4dhd3pr.js → cli-hdhpdrka.js} +6 -23
- package/dist/{cli-dq30fq3q.js → cli-hhtbandk.js} +2 -2
- package/dist/cli-hyqksecw.js +1907 -0
- package/dist/{cli-t25rq8mg.js → cli-ja450998.js} +40 -11
- package/dist/{cli-43dsqhcp.js → cli-jbrc98qb.js} +4 -4
- package/dist/{cli-8sayvj48.js → cli-jyhbvdga.js} +3 -3
- package/dist/{cli-55fqpd9q.js → cli-jzerrzgc.js} +8 -8
- package/dist/{cli-hv3820ez.js → cli-k0nebh10.js} +1 -1
- package/dist/{cli-aytna2fm.js → cli-ka48vpev.js} +5 -5
- package/dist/{cli-d2epqm0y.js → cli-kezzteka.js} +1 -1
- package/dist/{cli-grk77aen.js → cli-kj84fqxz.js} +2 -2
- package/dist/{cli-h0ewec3d.js → cli-kr0jpw9c.js} +1 -1
- package/dist/{cli-wsnradtk.js → cli-m1sns1da.js} +2 -2
- package/dist/{cli-7kv5d674.js → cli-n1kjs58m.js} +4 -4
- package/dist/{cli-syqcny89.js → cli-nc4pbwmp.js} +9 -9
- package/dist/{cli-9gmkw6xn.js → cli-p3knvk62.js} +48 -42
- package/dist/{cli-50whymxq.js → cli-p436yrzp.js} +2 -2
- package/dist/{cli-0j4qmc80.js → cli-phdzn699.js} +7 -7
- package/dist/{cli-1gnf5c7x.js → cli-pz1dp12c.js} +1 -1
- package/dist/{cli-nbawx3s0.js → cli-pz1nq5xm.js} +6 -6
- package/dist/{cli-4dyhzhpx.js → cli-qzz6tz8s.js} +1 -1
- package/dist/{cli-ea367bdn.js → cli-rmgvwcmy.js} +22 -22
- package/dist/{cli-mgr3gatr.js → cli-rv3y60bt.js} +4 -4
- package/dist/cli-s33bzmk0.js +27 -0
- package/dist/{cli-at67kvnp.js → cli-srktrbby.js} +1 -1
- package/dist/{cli-pzsedyb0.js → cli-t0jmkcah.js} +14 -14
- package/dist/{cli-eetzmsy5.js → cli-t9pzz2eq.js} +2 -2
- package/dist/{cli-w24741sm.js → cli-tr19nyn9.js} +4 -4
- package/dist/{cli-e4gx499y.js → cli-ts5yv7dn.js} +163 -86
- package/dist/{cli-czeh7x13.js → cli-tsc3pdfd.js} +4 -4
- package/dist/{cli-y0q92v4r.js → cli-tzw1jr2t.js} +2 -2
- package/dist/{cli-tjf1bh1v.js → cli-x2cem5vy.js} +6 -4
- package/dist/{cli-vx9acp12.js → cli-ybte1fqc.js} +1 -1
- package/dist/{cli-gkjw33x5.js → cli-ysv0k1we.js} +2 -2
- package/dist/{cli-vdfngx2g.js → cli-ywy8yz6t.js} +2 -2
- package/dist/{cli-cpkxh68d.js → cli-z1vam71h.js} +2 -2
- package/dist/{cli-8m6gqnf1.js → cli-zexwhj3f.js} +3 -3
- package/dist/{cli-snwz16eg.js → cli-zhwjdhjr.js} +2 -2
- package/dist/{cli-y754psdt.js → cli-zjdhrzm0.js} +4 -4
- package/dist/cli.js +19 -19
- package/dist/{codex-adapter-493vb8cv.js → codex-adapter-2fs2c0n6.js} +8 -8
- package/dist/{codex-hook-ej8hn6z5.js → codex-hook-jxjv6dy5.js} +1 -1
- package/dist/{codex-login-ven5cz5j.js → codex-login-ktfg1cxk.js} +1 -1
- package/dist/{codex-session-runner-ps5m4z1g.js → codex-session-runner-r55tmx4c.js} +9 -9
- package/dist/{commands-shktk0b8.js → commands-0mxdy9x8.js} +3 -3
- package/dist/{controller-wn3vd217.js → controller-g3vkfhr4.js} +4 -4
- package/dist/{controllers-connect-yft057ws.js → controllers-connect-4wdmncqt.js} +25 -25
- package/dist/core-gsvj5f3z.js +42 -0
- package/dist/{cursor-adapter-8fpm4dng.js → cursor-adapter-t9qb96q2.js} +2 -2
- package/dist/{db-0ezhdhz5.js → db-487vvyv9.js} +3 -3
- package/dist/{db-84pz2w5c.js → db-76p7w3gr.js} +2 -2
- package/dist/{devin-adapter-fs90ab4v.js → devin-adapter-3bp6rape.js} +1 -1
- package/dist/{dispatcher-h2rz69f6.js → dispatcher-64rp6w67.js} +22 -22
- package/dist/{docker-1h33jvh9.js → docker-a59g3ebm.js} +2 -2
- package/dist/{dsh-adapter-g9yqv09y.js → dsh-adapter-8abzqk5c.js} +2 -2
- package/dist/{e2b-y7e5kmzf.js → e2b-3ykbe805.js} +2 -2
- package/dist/{e2b-jnk0yeva.js → e2b-dc8f6ctq.js} +2 -2
- package/dist/{easter-egg-3d-m41ad78v.js → easter-egg-3d-jrrwyf55.js} +1 -1
- package/dist/{embedding-space-yam9zwzj.js → embedding-space-001hhhpk.js} +6 -6
- package/dist/{embeddings-g2be0y8q.js → embeddings-esj19cnw.js} +1 -1
- package/dist/{event-bus-08t2b4y2.js → event-bus-7gbsr0g4.js} +1 -1
- package/dist/{execute-hhdejgzf.js → execute-301hkxqg.js} +1 -1
- package/dist/{external-channel-kjt2yzfj.js → external-channel-w10e2j05.js} +2 -2
- package/dist/fx-adapter-4sjrbdne.js +20 -0
- package/dist/grok-adapter-3a0ezfee.js +20 -0
- package/dist/handlers-ef3k11hb.js +41 -0
- package/dist/{heartbeat-2e5jdexj.js → heartbeat-tbrj7vhq.js} +25 -25
- package/dist/{hook-acg9saz7.js → hook-3am1sq68.js} +6 -6
- package/dist/{hook-34s8cmgn.js → hook-tx917rqw.js} +8 -8
- package/dist/{http-ra2zr2f8.js → http-3rmemtqy.js} +335 -1829
- package/dist/{index-mbpxhc4w.js → index-126v2d0t.js} +1 -4
- package/dist/{index-2z1z7qx6.js → index-2jw11t8s.js} +26 -26
- package/dist/{index-9q42cr54.js → index-aetfyx6p.js} +1 -1
- package/dist/index-e6bq0exk.js +42 -0
- package/dist/{index-9r4j0a60.js → index-gfnq66t1.js} +223 -25
- package/dist/index-hf2k1vge.js +39 -0
- package/dist/{index-93bw5wds.js → index-s7xtvc0f.js} +1 -1
- package/dist/index-taxmejj3.js +44 -0
- package/dist/{k8s-8326q0rq.js → k8s-36gfn847.js} +2 -2
- package/dist/{keepalive-vjnnqbkm.js → keepalive-9px3t7qj.js} +5 -5
- package/dist/lead-5vt6f174.js +83 -0
- package/dist/{maintenance-px2g599e.js → maintenance-vwqjwst6.js} +1 -1
- package/dist/{oauth-refresh-sweep-nkykf09m.js → oauth-refresh-sweep-yqry3wn4.js} +4 -4
- package/dist/{object-webhooks-gt9xnq21.js → object-webhooks-8s1wtths.js} +7 -7
- package/dist/{onboard-1f134p65.js → onboard-hb8czx0p.js} +7 -7
- package/dist/{opencode-adapter-94976yab.js → opencode-adapter-djd6m6dk.js} +8 -8
- package/dist/{otel-impl-5d4p2fqs.js → otel-impl-2ymwyczz.js} +2 -2
- package/dist/{pending-vkk0vx6n.js → pending-nxavtvx7.js} +23 -23
- package/dist/{pi-mono-adapter-cyzdv5er.js → pi-mono-adapter-d2cpmcy4.js} +12 -12
- package/dist/{pricing-refresh-jtmjwss9.js → pricing-refresh-1yz8jkqv.js} +2 -2
- package/dist/{rbac-roles-1fvmdyeb.js → rbac-roles-7s6m31xw.js} +6 -4
- package/dist/{rbac-roles-yd1fgpsn.js → rbac-roles-dbpx0x9v.js} +3 -3
- package/dist/{render-v2-kb5s3vx4.js → render-v2-7y20rjrn.js} +7 -7
- package/dist/{resume-z1vs44n5.js → resume-wz546x47.js} +10 -10
- package/dist/{runtime-gk6ct7r7.js → runtime-cb5bd9tz.js} +1 -1
- package/dist/{session-access-nz6nre4d.js → session-access-4vcft8kq.js} +5 -5
- package/dist/{session-source-backfill-wb60zjkd.js → session-source-backfill-57b50tpw.js} +3 -3
- package/dist/{setup-2x8g8j4s.js → setup-e1tevjyj.js} +1 -1
- package/dist/thread-buffer-686pa1p1.js +42 -0
- package/dist/{tree-visibility-ts3z30kw.js → tree-visibility-07wf1nct.js} +2 -2
- package/dist/{user-merge-jobs-zetg26e0.js → user-merge-jobs-n20qpv6s.js} +3 -3
- package/dist/{virtual-modules-674fka8x.js → virtual-modules-6fxmn1yv.js} +3 -3
- package/dist/{work-objects-w52yyjxm.js → work-objects-eg7y48pe.js} +25 -25
- package/dist/worker-4vp616ms.js +83 -0
- package/dist/{worker-follow-up-dyfxyjbj.js → worker-follow-up-jnvnnf2b.js} +22 -22
- package/dist/{x-asbrnafg.js → x-d27jj7z7.js} +2 -2
- package/openapi.json +475 -28
- package/package.json +2 -2
- package/src/be/db/approvals.ts +2 -0
- package/src/be/db/runtime.ts +5 -0
- package/src/be/db/script-run-sources.ts +17 -0
- package/src/be/db-retention.ts +1 -1
- package/src/be/db.ts +71 -62
- package/src/be/design-system.ts +63 -0
- package/src/be/migrations/342_script_run_sources.sql +20 -0
- package/src/be/migrations/runner.ts +8 -0
- package/src/be/migrations/script-run-sources.ts +51 -0
- package/src/be/rbac-roles.ts +2 -0
- package/src/be/scripts/typecheck.ts +4 -2
- package/src/be/seed-scripts/catalog/design-system-seed.ts +158 -0
- package/src/be/seed-scripts/index.ts +9 -0
- package/src/be/swarm-config-guard.ts +21 -1
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/heartbeat/heartbeat.ts +18 -4
- package/src/http/all-routes.ts +1 -0
- package/src/http/approval-chat-answer.ts +99 -0
- package/src/http/approval-requests.ts +280 -225
- package/src/http/design-system.ts +103 -0
- package/src/http/index.ts +10 -6
- package/src/http/pages-public.ts +25 -10
- package/src/http/pages.ts +17 -0
- package/src/http/person-responder.ts +28 -0
- package/src/integrations/chat-sdk/adapters.ts +33 -3
- package/src/integrations/chat-sdk/inbound.ts +6 -18
- package/src/integrations/chat-sdk/mentions.ts +188 -0
- package/src/integrations/chat-sdk/outbound.ts +20 -3
- package/src/integrations/chat-sdk/router.ts +8 -0
- package/src/integrations/chat-sdk/telegram-thread.ts +12 -0
- package/src/jira/adf.ts +35 -9
- package/src/kv-reserved-namespaces.ts +5 -0
- package/src/pages/page-head.ts +11 -1
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/dsh-adapter.ts +48 -13
- package/src/rbac/legacy-policy.ts +4 -0
- package/src/rbac/permissions.ts +8 -0
- package/src/scheduler/index.ts +1 -0
- package/src/scheduler/scheduler.test.ts +32 -1
- package/src/scheduler/scheduler.ts +24 -1
- package/src/script-workflows/executor.ts +6 -0
- package/src/script-workflows/supervisor.ts +2 -1
- package/src/scripts-runtime/sdk-allowlist.ts +2 -0
- package/src/scripts-runtime/swarm-sdk.ts +12 -23
- package/src/scripts-runtime/types/stdlib.d.ts +4 -1
- package/src/scripts-runtime/types/swarm-sdk.d.ts +4 -1
- package/src/server.ts +2 -0
- package/src/slack/actions.ts +3 -0
- package/src/slack/approval-actions.ts +148 -0
- package/src/slack/approval-buttons.ts +28 -0
- package/src/tests/chat-sdk-mentions.test.ts +183 -0
- package/src/tests/create-page-tool.test.ts +5 -0
- package/src/tests/dsh-adapter.test.ts +53 -1
- package/src/tests/fixtures/compiled-source-schema-boot.ts +24 -0
- package/src/tests/fixtures/secret-corpus.ts +43 -1
- package/src/tests/heartbeat-stall-thresholds.test.ts +174 -0
- package/src/tests/jira-adf.test.ts +42 -2
- package/src/tests/merge-gate-detect-changes.test.ts +208 -16
- package/src/tests/migration-342-script-run-sources.test.ts +196 -0
- package/src/tests/migration-bunfs-compat.test.ts +129 -9
- package/src/tests/rbac-e2e-helpers.test.ts +10 -4
- package/src/tests/rbac-e2e-helpers.ts +13 -4
- package/src/tests/rbac-roles.test.ts +2 -0
- package/src/tests/runtime-e2b-pools.test.ts +7 -1
- package/src/tests/schedule-target-type.test.ts +4 -1
- package/src/tests/script-connections.test.ts +2 -0
- package/src/tests/script-runs-retention.test.ts +43 -16
- package/src/tests/script-workflows-runtime-e2e.test.ts +56 -22
- package/src/tests/scripts-http.test.ts +9 -3
- package/src/tests/sdk-allowlist.test.ts +26 -13
- package/src/tests/sdk-store-progress-skipped.test.ts +12 -5
- package/src/tests/secret-rules.test.ts +34 -0
- package/src/tests/secret-scrub-gate.test.ts +7 -0
- package/src/tests/secret-scrubber.test.ts +62 -2
- package/src/tests/seed-scripts.test.ts +2 -2
- package/src/tests/system-one-hosts-ui-mirror.test.ts +1 -0
- package/src/tests/vcs-azure-devops.test.ts +10 -0
- package/src/tests/vcs-provider.test.ts +8 -0
- package/src/themes/design-system.ts +163 -0
- package/src/themes/page-theme.ts +28 -19
- package/src/tools/chat-post.ts +7 -3
- package/src/tools/create-page.ts +3 -0
- package/src/tools/design-system.ts +102 -0
- package/src/tools/mcp-servers/mcp-server-get.ts +1 -1
- package/src/tools/mcp-servers/mcp-server-list.ts +1 -1
- package/src/tools/register-chat-channel.ts +11 -2
- package/src/tools/skills/skill-get-file.ts +1 -1
- package/src/tools/skills/skill-get.ts +1 -1
- package/src/tools/skills/skill-list.ts +1 -1
- package/src/tools/skills/skill-search.ts +1 -1
- package/src/tools/utils.ts +49 -4
- package/src/tools/workflows/get-workflow-run.ts +1 -1
- package/src/tools/workflows/get-workflow.ts +1 -1
- package/src/tools/workflows/list-workflow-runs.ts +1 -1
- package/src/tools/workflows/list-workflows.ts +1 -1
- package/src/types.ts +65 -0
- package/src/utils/secret-rules.generated.ts +149 -149
- package/src/utils/secret-scrubber.ts +111 -5
- package/src/vcs/azure-devops.ts +22 -1
- package/src/vcs/index.ts +3 -1
- package/src/workflows/approval-inline.ts +122 -0
- package/src/workflows/approval-notifications.ts +7 -2
- package/src/workflows/engine.ts +6 -5
- package/src/workflows/executors/agent-task.ts +14 -0
- package/src/workflows/executors/system-one-providers.ts +23 -0
- package/templates/skills/pages/content.md +34 -8
- package/templates/skills/swarm-docs/content.md +5 -0
- package/templates/skills/workflow-iterate/content.md +1 -1
- package/dist/acp-adapter-t2q6nsqv.js +0 -17
- package/dist/cli-kh973792.js +0 -98
- package/dist/core-nheayfgm.js +0 -42
- package/dist/fx-adapter-8g7xsp8q.js +0 -20
- package/dist/grok-adapter-ztk2zkz1.js +0 -20
- package/dist/handlers-9ywssz71.js +0 -41
- package/dist/index-6mgbdtv1.js +0 -44
- package/dist/index-hqdsn2t2.js +0 -39
- package/dist/index-st231bqv.js +0 -40
- package/dist/lead-mk0xkth2.js +0 -82
- package/dist/thread-buffer-d50rqpev.js +0 -42
- package/dist/worker-662x1vse.js +0 -82
|
@@ -122,6 +122,10 @@ const ApprovalVoteSchema = z.object({
|
|
|
122
122
|
.optional()
|
|
123
123
|
.describe("The `respondedBy` the client sent. Unverified; display only."),
|
|
124
124
|
respondedAt: z.string(),
|
|
125
|
+
via: z
|
|
126
|
+
.object({ channel: z.string(), platformUserId: z.string() })
|
|
127
|
+
.optional()
|
|
128
|
+
.describe("Set when the answer came from a chat button: the channel and the platform user."),
|
|
125
129
|
});
|
|
126
130
|
|
|
127
131
|
const ApprovalProgressSchema = z
|
|
@@ -531,257 +535,308 @@ const listRoute = route({
|
|
|
531
535
|
|
|
532
536
|
// ─── Handler ─────────────────────────────────────────────────────────────────
|
|
533
537
|
|
|
534
|
-
export
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
538
|
+
export type ApprovalAnswerResult =
|
|
539
|
+
| { kind: "resolved" | "recorded"; request: ApprovalRequest }
|
|
540
|
+
| { kind: "error"; status: 400 | 403 | 404 | 409; message: string }
|
|
541
|
+
/** `authorizeConfigSet` refused and already sent its own HTTP reply. */
|
|
542
|
+
| { kind: "handled" };
|
|
543
|
+
|
|
544
|
+
export interface ApprovalAnswerInput {
|
|
545
|
+
id: string;
|
|
546
|
+
/** Who answers, from a verified identity (`approvalResponder` or `userApprovalResponder`). */
|
|
547
|
+
responder: ApprovalResponder;
|
|
548
|
+
responses: Record<string, unknown>;
|
|
549
|
+
respondedBy?: string;
|
|
550
|
+
via?: ApprovalVote["via"];
|
|
551
|
+
/** HTTP only: checks the caller may write config. Without it a config `set` answer is refused. */
|
|
552
|
+
authorizeConfigSet?: (keys: string[]) => Promise<boolean>;
|
|
553
|
+
}
|
|
550
554
|
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
555
|
+
/**
|
|
556
|
+
* Answer an approval request as an already verified responder. The respond
|
|
557
|
+
* route and the chat buttons both go through here, so every check (expiry,
|
|
558
|
+
* approver list, required answers, quorum, first-write-wins resolve) and every
|
|
559
|
+
* side effect (`approval.resolved`, the follow-up task) is the same.
|
|
560
|
+
*/
|
|
561
|
+
export async function answerApprovalRequest(
|
|
562
|
+
input: ApprovalAnswerInput,
|
|
563
|
+
): Promise<ApprovalAnswerResult> {
|
|
564
|
+
const { responder } = input;
|
|
565
|
+
|
|
566
|
+
const existing = await getApprovalRequestById(input.id);
|
|
567
|
+
if (!existing) {
|
|
568
|
+
return { kind: "error", status: 404, message: "Approval request not found" };
|
|
569
|
+
}
|
|
556
570
|
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
}
|
|
571
|
+
if (existing.status !== "pending") {
|
|
572
|
+
const reason = existing.resolutionReason ? `: ${existing.resolutionReason}` : "";
|
|
573
|
+
return {
|
|
574
|
+
kind: "error",
|
|
575
|
+
status: 409,
|
|
576
|
+
message: `Approval request already resolved with status: ${existing.status}${reason}`,
|
|
577
|
+
};
|
|
578
|
+
}
|
|
566
579
|
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
});
|
|
577
|
-
if (timedOut && !existing.workflowRunId) {
|
|
578
|
-
await createApprovalFollowUpTask(timedOut, "hitl.timeout");
|
|
579
|
-
}
|
|
580
|
+
// A late answer never resolves the request: it becomes timeout at once.
|
|
581
|
+
// A workflow run then routes on its timeout port on the next heartbeat
|
|
582
|
+
// tick through getStuckApprovalRuns, so no approval.resolved is emitted.
|
|
583
|
+
if (existing.expiresAt && new Date(existing.expiresAt) < new Date()) {
|
|
584
|
+
// The status change and the follow-up task commit together.
|
|
585
|
+
await getDbClient().transaction(async () => {
|
|
586
|
+
const timedOut = await resolveApprovalRequest(existing.id, {
|
|
587
|
+
status: "timeout",
|
|
588
|
+
resolutionReason: `Timed out: the answer arrived after the deadline ${existing.expiresAt}`,
|
|
580
589
|
});
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
590
|
+
if (timedOut && !existing.workflowRunId) {
|
|
591
|
+
await createApprovalFollowUpTask(timedOut, "hitl.timeout");
|
|
592
|
+
}
|
|
593
|
+
});
|
|
594
|
+
return {
|
|
595
|
+
kind: "error",
|
|
596
|
+
status: 409,
|
|
597
|
+
message: `Approval request expired at ${existing.expiresAt}`,
|
|
598
|
+
};
|
|
599
|
+
}
|
|
584
600
|
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
}
|
|
601
|
+
const unavailableReason = await getWorkflowApprovalUnavailableReason(existing);
|
|
602
|
+
if (unavailableReason) {
|
|
603
|
+
return { kind: "error", status: 409, message: unavailableReason };
|
|
604
|
+
}
|
|
590
605
|
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
}
|
|
606
|
+
const approvers = existing.approvers as ApproversShape;
|
|
607
|
+
if (!isListedApprover(approvers, responder)) {
|
|
608
|
+
return { kind: "error", status: 403, message: "You are not one of this request's approvers" };
|
|
609
|
+
}
|
|
596
610
|
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
611
|
+
const questions = existing.questions as ApprovalQuestion[];
|
|
612
|
+
const missingRequired = missingRequiredResponseIds(questions, input.responses);
|
|
613
|
+
if (missingRequired.length > 0) {
|
|
614
|
+
return {
|
|
615
|
+
kind: "error",
|
|
616
|
+
status: 400,
|
|
617
|
+
message: `Responses missing or invalid: ${missingRequired.join(", ")}`,
|
|
618
|
+
};
|
|
619
|
+
}
|
|
603
620
|
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
const answer = parseConfigAnswer(question, parsed.body.responses[question.id], state);
|
|
614
|
-
if (!answer.ok) {
|
|
615
|
-
jsonError(res, answer.error, 400);
|
|
616
|
-
return true;
|
|
617
|
-
}
|
|
618
|
-
configAnswers.set(question.id, { question, answer: answer.answer });
|
|
619
|
-
}
|
|
620
|
-
if (configAnswers.size > 0 && approvers.policy !== "any") {
|
|
621
|
-
jsonError(res, 'Config questions need approvers.policy "any"', 409);
|
|
622
|
-
return true;
|
|
621
|
+
// Config answers (D6) are checked here and replaced by their results (D7)
|
|
622
|
+
// before the vote exists, so no plaintext reaches any stored or sent copy.
|
|
623
|
+
const configQuestions = questions.filter(isConfigQuestion);
|
|
624
|
+
const configAnswers = new Map<string, { question: StoredConfigQuestion; answer: ConfigAnswer }>();
|
|
625
|
+
for (const question of configQuestions) {
|
|
626
|
+
const state = await readConfigState(question.config);
|
|
627
|
+
const answer = parseConfigAnswer(question, input.responses[question.id], state);
|
|
628
|
+
if (!answer.ok) {
|
|
629
|
+
return { kind: "error", status: 400, message: answer.error };
|
|
623
630
|
}
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
if (!grant.grantsAll && !grant.verbs.has("config.write.any")) {
|
|
636
|
-
jsonError(res, "Forbidden: setting a config value needs 'config.write.any'", 403);
|
|
637
|
-
return true;
|
|
638
|
-
}
|
|
639
|
-
}
|
|
631
|
+
configAnswers.set(question.id, { question, answer: answer.answer });
|
|
632
|
+
}
|
|
633
|
+
if (configAnswers.size > 0 && approvers.policy !== "any") {
|
|
634
|
+
return { kind: "error", status: 409, message: 'Config questions need approvers.policy "any"' };
|
|
635
|
+
}
|
|
636
|
+
const setKeys = [...configAnswers.values()]
|
|
637
|
+
.filter(({ answer }) => answer.action === "set")
|
|
638
|
+
.map(({ question }) => question.config.key);
|
|
639
|
+
if (setKeys.length > 0) {
|
|
640
|
+
if (!input.authorizeConfigSet) {
|
|
641
|
+
return { kind: "error", status: 409, message: "Config values are set on the dashboard" };
|
|
640
642
|
}
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
643
|
+
if (!(await input.authorizeConfigSet(setKeys))) return { kind: "handled" };
|
|
644
|
+
}
|
|
645
|
+
const safeResponses: Record<string, unknown> = { ...input.responses };
|
|
646
|
+
for (const id of configAnswers.keys()) delete safeResponses[id];
|
|
647
|
+
|
|
648
|
+
// Determine status from responses: if any approval question has approved: false → rejected
|
|
649
|
+
let status: "approved" | "rejected" = "approved";
|
|
650
|
+
for (const q of questions) {
|
|
651
|
+
if (q.type === "approval") {
|
|
652
|
+
const answer = safeResponses[q.id] as { approved?: boolean } | undefined;
|
|
653
|
+
if (answer && answer.approved === false) {
|
|
654
|
+
status = "rejected";
|
|
655
|
+
break;
|
|
653
656
|
}
|
|
654
657
|
}
|
|
658
|
+
}
|
|
655
659
|
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
}
|
|
682
|
-
responses[id] = kept;
|
|
683
|
-
} else {
|
|
684
|
-
const written = await applyConfigAnswer(question, answer.value);
|
|
685
|
-
configWrites.push({ result: written, value: answer.value });
|
|
686
|
-
responses[id] = written;
|
|
660
|
+
const responderId = responderKey(responder);
|
|
661
|
+
const respondedAt = new Date().toISOString();
|
|
662
|
+
const configWrites: { result: ConfigResult; value: string }[] = [];
|
|
663
|
+
// One write transaction (BEGIN IMMEDIATE) so concurrent answers to an
|
|
664
|
+
// `all` / `{ min: N }` request append in turn and never drop each other.
|
|
665
|
+
// Config writes share it, so a lost race writes nothing.
|
|
666
|
+
const outcome = await getDbClient()
|
|
667
|
+
.transaction(async () => {
|
|
668
|
+
const current = await getApprovalRequestById(input.id);
|
|
669
|
+
if (!current || current.status !== "pending") return { kind: "unavailable" as const };
|
|
670
|
+
const prior = current.approvals ?? [];
|
|
671
|
+
if (prior.some((v) => v.responder === responderId)) return { kind: "duplicate" as const };
|
|
672
|
+
|
|
673
|
+
// Config values are written only when the request resolves approved (D8).
|
|
674
|
+
const responses = { ...safeResponses };
|
|
675
|
+
for (const [id, { question, answer }] of configAnswers) {
|
|
676
|
+
if (status === "rejected" || answer.action === "skip") {
|
|
677
|
+
responses[id] = skippedConfigResult(question);
|
|
678
|
+
} else if (answer.action === "keep") {
|
|
679
|
+
const kept = await keptConfigResult(question);
|
|
680
|
+
if (!kept) {
|
|
681
|
+
throw new ConfigRespondAbort(
|
|
682
|
+
"conflict",
|
|
683
|
+
`config question "${id}": the key was removed before the answer was saved`,
|
|
684
|
+
);
|
|
687
685
|
}
|
|
686
|
+
responses[id] = kept;
|
|
687
|
+
} else {
|
|
688
|
+
const written = await applyConfigAnswer(question, answer.value);
|
|
689
|
+
configWrites.push({ result: written, value: answer.value });
|
|
690
|
+
responses[id] = written;
|
|
688
691
|
}
|
|
692
|
+
}
|
|
689
693
|
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
if (!resolved && configWrites.length > 0) throw new ConfigRespondAbort("unavailable");
|
|
705
|
-
return resolved
|
|
706
|
-
? { kind: "resolved" as const, request: resolved }
|
|
707
|
-
: { kind: "unavailable" as const };
|
|
708
|
-
}
|
|
709
|
-
const recorded = (await recordApprovalVotes(parsed.params.id, votes))
|
|
710
|
-
? await getApprovalRequestById(parsed.params.id)
|
|
711
|
-
: null;
|
|
712
|
-
return recorded
|
|
713
|
-
? { kind: "recorded" as const, request: recorded }
|
|
714
|
-
: { kind: "unavailable" as const };
|
|
715
|
-
})
|
|
716
|
-
.catch((error: unknown) => {
|
|
717
|
-
if (!(error instanceof ConfigRespondAbort)) throw error;
|
|
718
|
-
// Rolled back: nothing was written.
|
|
719
|
-
configWrites.length = 0;
|
|
720
|
-
return error.kind === "conflict"
|
|
721
|
-
? { kind: "conflict" as const, message: error.message }
|
|
722
|
-
: { kind: "unavailable" as const };
|
|
723
|
-
});
|
|
724
|
-
|
|
725
|
-
if (outcome.kind === "conflict") {
|
|
726
|
-
jsonError(res, outcome.message, 409);
|
|
727
|
-
return true;
|
|
728
|
-
}
|
|
729
|
-
// The transaction has committed: run what PUT /api/config runs after a write.
|
|
730
|
-
for (const { result, value } of configWrites) {
|
|
731
|
-
try {
|
|
732
|
-
await runConfigWriteSideEffects(result.scope, result.key, value);
|
|
733
|
-
} catch (err) {
|
|
734
|
-
console.error(
|
|
735
|
-
"[approval-requests] Config side effects failed:",
|
|
736
|
-
scrubSecrets(err instanceof Error ? err.message : String(err)),
|
|
694
|
+
const vote: ApprovalVote = {
|
|
695
|
+
responder: responderId,
|
|
696
|
+
approved: status === "approved",
|
|
697
|
+
responses,
|
|
698
|
+
...(input.respondedBy ? { claimedRespondedBy: input.respondedBy } : {}),
|
|
699
|
+
...(input.via ? { via: input.via } : {}),
|
|
700
|
+
respondedAt,
|
|
701
|
+
};
|
|
702
|
+
const votes = [...prior, vote];
|
|
703
|
+
if (status === "rejected" || (await approvalQuorumMet(approvers, votes))) {
|
|
704
|
+
const resolved = await resolveApprovalRequest(
|
|
705
|
+
input.id,
|
|
706
|
+
{ status, responses, approvals: votes, resolvedBy: responderId },
|
|
707
|
+
{ requireActionableWorkflow: true },
|
|
737
708
|
);
|
|
709
|
+
if (!resolved && configWrites.length > 0) throw new ConfigRespondAbort("unavailable");
|
|
710
|
+
return resolved
|
|
711
|
+
? { kind: "resolved" as const, request: resolved }
|
|
712
|
+
: { kind: "unavailable" as const };
|
|
738
713
|
}
|
|
739
|
-
|
|
714
|
+
const recorded = (await recordApprovalVotes(input.id, votes))
|
|
715
|
+
? await getApprovalRequestById(input.id)
|
|
716
|
+
: null;
|
|
717
|
+
return recorded
|
|
718
|
+
? { kind: "recorded" as const, request: recorded }
|
|
719
|
+
: { kind: "unavailable" as const };
|
|
720
|
+
})
|
|
721
|
+
.catch((error: unknown) => {
|
|
722
|
+
if (!(error instanceof ConfigRespondAbort)) throw error;
|
|
723
|
+
// Rolled back: nothing was written.
|
|
724
|
+
configWrites.length = 0;
|
|
725
|
+
return error.kind === "conflict"
|
|
726
|
+
? { kind: "conflict" as const, message: error.message }
|
|
727
|
+
: { kind: "unavailable" as const };
|
|
728
|
+
});
|
|
740
729
|
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
730
|
+
if (outcome.kind === "conflict") {
|
|
731
|
+
return { kind: "error", status: 409, message: outcome.message };
|
|
732
|
+
}
|
|
733
|
+
// The transaction has committed: run what PUT /api/config runs after a write.
|
|
734
|
+
for (const { result, value } of configWrites) {
|
|
735
|
+
try {
|
|
736
|
+
await runConfigWriteSideEffects(result.scope, result.key, value);
|
|
737
|
+
} catch (err) {
|
|
738
|
+
console.error(
|
|
739
|
+
"[approval-requests] Config side effects failed:",
|
|
740
|
+
scrubSecrets(err instanceof Error ? err.message : String(err)),
|
|
741
|
+
);
|
|
750
742
|
}
|
|
751
|
-
|
|
743
|
+
}
|
|
752
744
|
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
745
|
+
if (outcome.kind === "duplicate") {
|
|
746
|
+
return { kind: "error", status: 409, message: "You already answered this approval request" };
|
|
747
|
+
}
|
|
748
|
+
if (outcome.kind === "recorded") {
|
|
749
|
+
return { kind: "recorded", request: outcome.request };
|
|
750
|
+
}
|
|
751
|
+
const updated = outcome.kind === "resolved" ? outcome.request : null;
|
|
752
|
+
|
|
753
|
+
if (!updated) {
|
|
754
|
+
const latest = await getApprovalRequestById(input.id);
|
|
755
|
+
const unavailableAfterRace = latest ? await getWorkflowApprovalUnavailableReason(latest) : null;
|
|
756
|
+
return {
|
|
757
|
+
kind: "error",
|
|
758
|
+
status: 409,
|
|
759
|
+
message:
|
|
760
760
|
unavailableAfterRace ??
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
return true;
|
|
765
|
-
}
|
|
761
|
+
`Failed to resolve approval request (status: ${latest?.status ?? "unknown"})`,
|
|
762
|
+
};
|
|
763
|
+
}
|
|
766
764
|
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
765
|
+
// Emit for every answered request, workflow or standalone. Workflow resume
|
|
766
|
+
// ignores a payload without a run and step id, and the extension bridge
|
|
767
|
+
// (`post.approval.resolved`) needs the standalone ones.
|
|
768
|
+
workflowEventBus.emit("approval.resolved", {
|
|
769
|
+
requestId: updated.id,
|
|
770
|
+
status: updated.status,
|
|
771
|
+
responses: updated.responses,
|
|
772
|
+
workflowRunId: updated.workflowRunId ?? undefined,
|
|
773
|
+
workflowRunStepId: updated.workflowRunStepId ?? undefined,
|
|
774
|
+
sourceTaskId: updated.sourceTaskId ?? undefined,
|
|
775
|
+
});
|
|
776
|
+
|
|
777
|
+
// For standalone (non-workflow) requests, create a follow-up task
|
|
778
|
+
// so the requesting agent is notified of the human's response
|
|
779
|
+
await createApprovalFollowUpTask(updated, "hitl.follow_up");
|
|
780
|
+
|
|
781
|
+
return { kind: "resolved", request: updated };
|
|
782
|
+
}
|
|
778
783
|
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
784
|
+
/** The config write checks PUT /api/config runs, for a respond call that sets config values. */
|
|
785
|
+
async function authorizeHttpConfigSet(
|
|
786
|
+
req: IncomingMessage,
|
|
787
|
+
res: ServerResponse,
|
|
788
|
+
keys: string[],
|
|
789
|
+
): Promise<boolean> {
|
|
790
|
+
if (!(await ensureConfigAdmin(req, res, "config.write.any"))) return false;
|
|
791
|
+
for (const key of keys) {
|
|
792
|
+
if (!(await ensureHumanOnlyConfigWrite(req, res, key))) return false;
|
|
793
|
+
}
|
|
794
|
+
// Admission only checked `approval.respond`; `ensureConfigAdmin` passes
|
|
795
|
+
// every user, so check the config write grant here as PUT /api/config would.
|
|
796
|
+
const userId = authUserId(getRequestAuth(req));
|
|
797
|
+
if (userId && isRbacEnabled()) {
|
|
798
|
+
const grant = await getUserGrant(userId);
|
|
799
|
+
if (!grant.grantsAll && !grant.verbs.has("config.write.any")) {
|
|
800
|
+
jsonError(res, "Forbidden: setting a config value needs 'config.write.any'", 403);
|
|
801
|
+
return false;
|
|
802
|
+
}
|
|
803
|
+
}
|
|
804
|
+
return true;
|
|
805
|
+
}
|
|
806
|
+
|
|
807
|
+
export async function handleApprovalRequests(
|
|
808
|
+
req: IncomingMessage,
|
|
809
|
+
res: ServerResponse,
|
|
810
|
+
pathSegments: string[],
|
|
811
|
+
queryParams: URLSearchParams,
|
|
812
|
+
): Promise<boolean> {
|
|
813
|
+
// 4-segment: POST /api/approval-requests/{id}/respond
|
|
814
|
+
if (respondRoute.match(req.method, pathSegments)) {
|
|
815
|
+
const parsed = await respondRoute.parse(req, res, pathSegments, queryParams);
|
|
816
|
+
if (!parsed) return true;
|
|
782
817
|
|
|
818
|
+
const responder = await approvalResponder(req);
|
|
819
|
+
if (!responder.ok) {
|
|
820
|
+
jsonError(res, responder.message, 403);
|
|
821
|
+
return true;
|
|
822
|
+
}
|
|
823
|
+
const result = await answerApprovalRequest({
|
|
824
|
+
id: parsed.params.id,
|
|
825
|
+
responder: responder.responder,
|
|
826
|
+
responses: parsed.body.responses,
|
|
827
|
+
respondedBy: parsed.body.respondedBy,
|
|
828
|
+
authorizeConfigSet: (keys) => authorizeHttpConfigSet(req, res, keys),
|
|
829
|
+
});
|
|
830
|
+
if (result.kind === "handled") return true;
|
|
831
|
+
if (result.kind === "error") {
|
|
832
|
+
jsonError(res, result.message, result.status);
|
|
833
|
+
return true;
|
|
834
|
+
}
|
|
783
835
|
respondRoute.respond(res, 200, {
|
|
784
|
-
approvalRequest: await toApprovalRequestResponse(
|
|
836
|
+
approvalRequest: await toApprovalRequestResponse(
|
|
837
|
+
result.request,
|
|
838
|
+
result.kind === "resolved" ? { withConfigState: true } : undefined,
|
|
839
|
+
),
|
|
785
840
|
});
|
|
786
841
|
return true;
|
|
787
842
|
}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from "node:http";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { getDesignSystem, type StoredDesignSystem, saveDesignSystem } from "../be/design-system";
|
|
4
|
+
import { can } from "../rbac";
|
|
5
|
+
import { buildDesignSystem, DesignSystemError } from "../themes/design-system";
|
|
6
|
+
import { DesignSystemInputSchema, DesignSystemSchema } from "../types";
|
|
7
|
+
import { agentFirstPrincipal } from "./request-principal";
|
|
8
|
+
import { route } from "./route-def";
|
|
9
|
+
import { jsonError } from "./utils";
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* The org design system over REST (src/themes/design-system.ts). The MCP
|
|
13
|
+
* tools `design-system-get` / `design-system-set` share the same storage.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
const DesignSystemStateSchema = z.object({
|
|
17
|
+
status: z.enum(["none", "invalid", "active", "declined"]),
|
|
18
|
+
designSystem: DesignSystemSchema.nullable(),
|
|
19
|
+
invalidReason: z.string().optional(),
|
|
20
|
+
previous: DesignSystemSchema.nullable(),
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
const getDesignSystemRoute = route({
|
|
24
|
+
method: "get",
|
|
25
|
+
path: "/api/design-system",
|
|
26
|
+
pattern: ["api", "design-system"],
|
|
27
|
+
summary: "Get the org design system",
|
|
28
|
+
tags: ["Pages"],
|
|
29
|
+
responses: {
|
|
30
|
+
200: {
|
|
31
|
+
description: "The org design system and the value it replaced",
|
|
32
|
+
schema: DesignSystemStateSchema,
|
|
33
|
+
},
|
|
34
|
+
},
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
const putDesignSystemRoute = route({
|
|
38
|
+
method: "put",
|
|
39
|
+
path: "/api/design-system",
|
|
40
|
+
pattern: ["api", "design-system"],
|
|
41
|
+
summary: "Set or decline the org design system",
|
|
42
|
+
tags: ["Pages"],
|
|
43
|
+
rbac: { permission: "design-system.write" },
|
|
44
|
+
body: DesignSystemInputSchema,
|
|
45
|
+
responses: {
|
|
46
|
+
200: {
|
|
47
|
+
description: "The saved, normalized design system",
|
|
48
|
+
schema: z.object({ designSystem: DesignSystemSchema, ignoredTokens: z.array(z.string()) }),
|
|
49
|
+
},
|
|
50
|
+
400: { description: "Invalid design system" },
|
|
51
|
+
403: { description: "Permission denied" },
|
|
52
|
+
},
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
function recordOf(stored: StoredDesignSystem) {
|
|
56
|
+
return "record" in stored ? stored.record : null;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export async function handleDesignSystem(
|
|
60
|
+
req: IncomingMessage,
|
|
61
|
+
res: ServerResponse,
|
|
62
|
+
pathSegments: string[],
|
|
63
|
+
queryParams: URLSearchParams,
|
|
64
|
+
myAgentId: string | undefined,
|
|
65
|
+
): Promise<boolean> {
|
|
66
|
+
if (getDesignSystemRoute.match(req.method, pathSegments)) {
|
|
67
|
+
const parsed = await getDesignSystemRoute.parse(req, res, pathSegments, queryParams);
|
|
68
|
+
if (!parsed) return true;
|
|
69
|
+
const { current, previous } = await getDesignSystem();
|
|
70
|
+
getDesignSystemRoute.respond(res, 200, {
|
|
71
|
+
status: current.status,
|
|
72
|
+
designSystem: recordOf(current),
|
|
73
|
+
...("reason" in current ? { invalidReason: current.reason } : {}),
|
|
74
|
+
previous: recordOf(previous),
|
|
75
|
+
});
|
|
76
|
+
return true;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
if (putDesignSystemRoute.match(req.method, pathSegments)) {
|
|
80
|
+
const parsed = await putDesignSystemRoute.parse(req, res, pathSegments, queryParams);
|
|
81
|
+
if (!parsed) return true;
|
|
82
|
+
const principal = await agentFirstPrincipal(req, myAgentId);
|
|
83
|
+
const decision = can({ principal, verb: "design-system.write", source: "http" });
|
|
84
|
+
if (!decision.allow) {
|
|
85
|
+
jsonError(res, decision.reason, 403);
|
|
86
|
+
return true;
|
|
87
|
+
}
|
|
88
|
+
try {
|
|
89
|
+
const { record, ignored } = buildDesignSystem(parsed.body, {
|
|
90
|
+
userId: principal.kind === "user" ? principal.userId : null,
|
|
91
|
+
...(principal.kind === "agent" ? { agentId: principal.agentId } : {}),
|
|
92
|
+
});
|
|
93
|
+
await saveDesignSystem(record);
|
|
94
|
+
putDesignSystemRoute.respond(res, 200, { designSystem: record, ignoredTokens: ignored });
|
|
95
|
+
} catch (err) {
|
|
96
|
+
if (!(err instanceof DesignSystemError)) throw err;
|
|
97
|
+
jsonError(res, err.message, 400);
|
|
98
|
+
}
|
|
99
|
+
return true;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
return false;
|
|
103
|
+
}
|