@desplega.ai/agent-swarm 2.9.0 → 2.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/acp-adapter-g909b5hw.js +16 -0
- package/dist/{acp-targets-swxq55dr.js → acp-targets-ny75x1qy.js} +7 -7
- package/dist/{actions-pb678g3e.js → actions-b9qgrmeq.js} +81 -21
- package/dist/{agent-fs-provision-dmhnc38q.js → agent-fs-provision-b5dhdsbd.js} +4 -4
- package/dist/{amp-adapter-3pa66q27.js → amp-adapter-vtax2c9s.js} +2 -2
- package/dist/{anthropic-messages-x2cp5fvf.js → anthropic-messages-r5xf5hqw.js} +10 -10
- package/dist/{app-17d12ev4.js → app-g2z15hax.js} +6 -3
- package/dist/{approval-notifications-h7vd9pmg.js → approval-notifications-yt13wp8r.js} +8 -5
- package/dist/{assistant-t7k39ree.js → assistant-2cgfxsgk.js} +23 -21
- package/dist/{boot-args-schema-0gqmkfbe.js → boot-args-schema-3gwy0f60.js} +1 -1
- package/dist/{boot-reembed-n6anc01d.js → boot-reembed-92g7s5zp.js} +1 -1
- package/dist/{boot-reembed-f064w382.js → boot-reembed-mywmyp4s.js} +1 -1
- package/dist/{boot-scrub-sweep-ejd5dnrz.js → boot-scrub-sweep-7dkdzqxx.js} +3 -3
- package/dist/{boot-seeds-f99fjs5q.js → boot-seeds-ce7rvgq1.js} +4 -4
- package/dist/{claude-adapter-gvznwxgc.js → claude-adapter-3m4q7735.js} +7 -7
- package/dist/{claude-managed-adapter-pbrbvc64.js → claude-managed-adapter-t8nfgcgz.js} +2 -2
- package/dist/{claude-managed-setup-kdxttvc3.js → claude-managed-setup-c217draw.js} +3 -3
- package/dist/{claude-sdk-session-0t2teq6n.js → claude-sdk-session-7fbqm51z.js} +7 -7
- package/dist/{cli-9a2rtd77.js → cli-1jykg0py.js} +6 -4
- package/dist/{cli-5ntc4we6.js → cli-2czxfnvj.js} +235 -2003
- package/dist/{cli-dd37e0cm.js → cli-2dq9yv8p.js} +1 -1
- package/dist/{cli-c07v0qfa.js → cli-2xs8tsf7.js} +69 -66
- package/dist/{cli-7fx9jyfs.js → cli-2yjj3e31.js} +64 -10
- package/dist/{cli-4ghh072d.js → cli-32djehja.js} +36 -36
- package/dist/{cli-cw7mc1je.js → cli-3j873zxq.js} +3 -3
- package/dist/cli-43ms35q9.js +270 -0
- package/dist/cli-47hz21se.js +25584 -0
- package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
- package/dist/{cli-5gygrr67.js → cli-67mwzr35.js} +1 -1
- package/dist/{cli-5kcmxwxv.js → cli-6945ywhr.js} +1 -1
- package/dist/{cli-812paz57.js → cli-6ehs4mta.js} +18 -2
- package/dist/{cli-95930z69.js → cli-6ym4jhzp.js} +2 -2
- package/dist/{cli-zg3z63x3.js → cli-7mv4h3sn.js} +1 -1
- package/dist/{cli-eg437b5p.js → cli-7sf9sb0w.js} +2 -1
- package/dist/{cli-nr46j5pw.js → cli-8zh9nrew.js} +1 -1
- package/dist/{cli-wr1h0k28.js → cli-9w8712tq.js} +617 -278
- package/dist/{cli-ssvdrk4y.js → cli-b6px1k1q.js} +1 -1
- package/dist/{cli-7831nhaw.js → cli-b91nz213.js} +3 -3
- package/dist/{cli-7cgf614g.js → cli-bg63qmsx.js} +2 -2
- package/dist/{cli-me4maa4j.js → cli-bkjdknnp.js} +9 -5
- package/dist/{cli-rts1qvb4.js → cli-bnqncekd.js} +2 -2
- package/dist/{cli-25nstr34.js → cli-br0924pw.js} +1 -1
- package/dist/{cli-ymct0ycy.js → cli-ctx0b85j.js} +5222 -4978
- package/dist/{cli-kqh27v2y.js → cli-dgs10ttj.js} +1 -1
- package/dist/{cli-kmvcm34h.js → cli-f3jyzq4g.js} +2 -2
- package/dist/cli-f8x9drqr.js +84 -0
- package/dist/{cli-8axx8vnw.js → cli-f9gz2vyj.js} +5 -5
- package/dist/{cli-vvgaz8t6.js → cli-fh97xn30.js} +2 -2
- package/dist/{cli-8x8y70av.js → cli-fkef327x.js} +2 -2
- package/dist/{cli-js8zrfyg.js → cli-gfy38pvt.js} +2 -2
- package/dist/{cli-kaa4bd7x.js → cli-h9yqfzx9.js} +7 -6
- package/dist/{cli-svc803vq.js → cli-j7svy295.js} +11 -11
- package/dist/{cli-nhq5js1b.js → cli-jaw5v1sy.js} +3 -3
- package/dist/{cli-w7dxb2fj.js → cli-jkw6ptfw.js} +6 -6
- package/dist/{cli-1tvdx9t5.js → cli-jm0hvmz2.js} +1 -1
- package/dist/{cli-e9973bf0.js → cli-jwampxxq.js} +2 -2
- package/dist/{cli-dx439zpg.js → cli-kpgcm7xy.js} +13 -1
- package/dist/{cli-pz1c00aa.js → cli-kxx4k2jw.js} +2 -2
- package/dist/{cli-aa8s22gn.js → cli-m7c2380k.js} +191 -182
- package/dist/{cli-2kg31ted.js → cli-m7zvgt57.js} +11 -11
- package/dist/{cli-57pvhnyt.js → cli-mhapr559.js} +1 -1
- package/dist/{cli-gddgcnav.js → cli-mjw0yf82.js} +1 -1
- package/dist/{cli-h474mvp5.js → cli-mkwkwq81.js} +7 -4
- package/dist/{cli-jd3kxppb.js → cli-mw620q3n.js} +1 -1
- package/dist/{cli-spzkdgtg.js → cli-n3qe7tyr.js} +172 -168
- package/dist/{cli-3zxdz9r7.js → cli-nafvvsp8.js} +3 -3
- package/dist/{cli-fnh4b12r.js → cli-nbt14he0.js} +6 -6
- package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
- package/dist/{cli-faf46gdq.js → cli-p4kckx1z.js} +10 -10
- package/dist/{cli-k7pt28ad.js → cli-pb2ay3sh.js} +2 -2
- package/dist/{cli-pn1v1pb0.js → cli-psffsanb.js} +3 -2
- package/dist/{cli-2tnbc3gw.js → cli-pyjn0qhk.js} +2257 -61
- package/dist/{cli-fgphc007.js → cli-rq5rpv6k.js} +1 -1
- package/dist/{cli-vw5x18yj.js → cli-sn650d7x.js} +9 -9
- package/dist/{cli-mc1fx4xd.js → cli-td9tb872.js} +10 -10
- package/dist/{cli-6dp0jkfj.js → cli-tvc4jag9.js} +3 -3
- package/dist/{cli-a9hfzg2r.js → cli-ty3gha1p.js} +6 -6
- package/dist/{cli-pwsax0vp.js → cli-v57d7fmm.js} +1 -1
- package/dist/{cli-nmcpzbty.js → cli-vt89089n.js} +4 -4
- package/dist/{cli-sn4pc4qx.js → cli-vyff45ve.js} +2 -2
- package/dist/{cli-m1fbz2wj.js → cli-w4n323t3.js} +175 -16
- package/dist/{cli-g3zzby8t.js → cli-wn13hhdt.js} +5 -5
- package/dist/{cli-q8cfh1t9.js → cli-xag7btpe.js} +1 -1
- package/dist/{cli-c5cspahx.js → cli-y2ewxhth.js} +38 -13
- package/dist/{cli-k09cxm6m.js → cli-ysvspf5e.js} +2 -2
- package/dist/{cli-eepnpee7.js → cli-zh0e5x7p.js} +4 -4
- package/dist/{cli-bk9v1xrv.js → cli-zr6qy15y.js} +11 -11
- package/dist/cli.js +21 -20
- package/dist/{codex-adapter-44yq2fkn.js → codex-adapter-n656pvb8.js} +6 -6
- package/dist/{codex-hook-h1zb7cfk.js → codex-hook-59atdwd8.js} +1 -1
- package/dist/{codex-login-cdyrr5y1.js → codex-login-a239g1ah.js} +1 -1
- package/dist/{codex-session-runner-zbh26gbw.js → codex-session-runner-p0fbv5y9.js} +6 -6
- package/dist/{commands-54f02v5b.js → commands-gwea8z5p.js} +3 -3
- package/dist/{controller-9gpwcdek.js → controller-t67c3grh.js} +6 -3
- package/dist/{controllers-connect-61re6k1n.js → controllers-connect-ks155r0h.js} +22 -20
- package/dist/{cursor-adapter-7e4g81vd.js → cursor-adapter-ygwrtmkv.js} +1 -1
- package/dist/{db-dg2gc7fd.js → db-kpmx06s9.js} +8 -2
- package/dist/{db-wnh0qjy1.js → db-rb2xqdb1.js} +3 -3
- package/dist/{dispatcher-jrm24r43.js → dispatcher-31sm0ej2.js} +20 -18
- package/dist/{docker-9aq30pp2.js → docker-09tkkg0n.js} +42 -3
- package/dist/{dsh-adapter-1yqk267c.js → dsh-adapter-qyxh0w31.js} +1 -1
- package/dist/{easter-egg-3d-r4h9cs9m.js → easter-egg-3d-00wjscn6.js} +1 -1
- package/dist/{embedding-space-bafjr5f7.js → embedding-space-qhw4g68n.js} +6 -6
- package/dist/{embeddings-7xmgqe0e.js → embeddings-zdv9ke6x.js} +1 -1
- package/dist/{execute-d6jg5ns0.js → execute-zna8wwr7.js} +1 -1
- package/dist/{external-channel-frq1xvq2.js → external-channel-1ac6t56s.js} +2 -2
- package/dist/fx-adapter-sk7n0fzc.js +19 -0
- package/dist/{google-generative-ai-hh7strj3.js → google-generative-ai-maq6c9bf.js} +1 -1
- package/dist/{google-vertex-fy5bw2pm.js → google-vertex-2jgsw2nb.js} +1 -1
- package/dist/grok-adapter-sjbcm5ew.js +19 -0
- package/dist/handlers-yzy0c87x.js +35 -0
- package/dist/{heartbeat-6bpa611t.js → heartbeat-2f6z4kdx.js} +23 -21
- package/dist/{hook-w12k146y.js → hook-8y0gvtp1.js} +6 -6
- package/dist/{hook-hvm5nf46.js → hook-w1skzaqc.js} +5 -5
- package/dist/{http-43tthdvs.js → http-wghxvpef.js} +714 -145
- package/dist/{index-1f0vypbg.js → index-0h6qd4p1.js} +34 -24
- package/dist/index-25pvya7q.js +40 -0
- package/dist/index-2t4859r5.js +35 -0
- package/dist/{index-4b1q8kan.js → index-4k7m5dgj.js} +629 -354
- package/dist/index-620y7jzq.js +15 -0
- package/dist/{index-cret47a5.js → index-8p0j4h4j.js} +506 -43
- package/dist/{index-mhq4sh5w.js → index-8zn8nxn5.js} +1 -1
- package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
- package/dist/{index-ftywhyr0.js → index-9zkchs9t.js} +221 -65
- package/dist/{index-bs7gw5fd.js → index-b5wgnm78.js} +44 -44
- package/dist/index-cxca2t8y.js +36 -0
- package/dist/{index-585gyczt.js → index-pe3d8jfy.js} +3 -3
- package/dist/{index-tx9mc2ap.js → index-rv89fvzf.js} +24 -22
- package/dist/{index-fn054vsf.js → index-s71ez27v.js} +1 -1
- package/dist/{keepalive-rk0j0jvh.js → keepalive-sh02349h.js} +3 -3
- package/dist/lead-gk4h5eg7.js +74 -0
- package/dist/{maintenance-g6z6kaxw.js → maintenance-yj0dcjja.js} +1 -1
- package/dist/{node-jftbyawr.js → node-dqm4xgxw.js} +1 -1
- package/dist/{oauth-refresh-sweep-2k3g2q4w.js → oauth-refresh-sweep-d9xedk66.js} +2 -2
- package/dist/{onboard-6fdbvh3v.js → onboard-dpgjn03r.js} +2 -2
- package/dist/{opencode-adapter-fdbsvts7.js → opencode-adapter-2d31cpjc.js} +6 -6
- package/dist/{otel-impl-rvwtc09q.js → otel-impl-1skarpfq.js} +1 -1
- package/dist/{pending-sqkrb836.js → pending-bfmxtx0g.js} +21 -19
- package/dist/{pi-mono-adapter-asqayqcg.js → pi-mono-adapter-gvppnasy.js} +40 -13
- package/dist/{pricing-refresh-f5tkgmw2.js → pricing-refresh-c6b325mk.js} +2 -2
- package/dist/{rbac-roles-06s555fa.js → rbac-roles-h80qbdbs.js} +3 -3
- package/dist/{rbac-roles-szxsg8t1.js → rbac-roles-zfcx68tx.js} +2 -2
- package/dist/{render-v2-103p266q.js → render-v2-nx20t3rb.js} +6 -3
- package/dist/{resume-v7kjewt9.js → resume-5ep8agan.js} +10 -7
- package/dist/{runtime-f1gmk0b7.js → runtime-r3pj4mce.js} +1 -1
- package/dist/{session-access-6shev8ts.js → session-access-n7p3m15b.js} +4 -4
- package/dist/{session-source-backfill-bd7spzjd.js → session-source-backfill-v8mt0zwn.js} +3 -3
- package/dist/{setup-kmxmztdb.js → setup-z1psaqhe.js} +1 -1
- package/dist/thread-buffer-a1re2r9r.js +38 -0
- package/dist/{virtual-modules-57eje5wy.js → virtual-modules-rrbjdpxn.js} +3 -3
- package/dist/{work-objects-zr47ygmf.js → work-objects-4aghh73z.js} +29 -23
- package/dist/worker-3dyyb8ev.js +74 -0
- package/dist/{worker-follow-up-grrr3fda.js → worker-follow-up-166zmex1.js} +20 -18
- package/openapi.json +1387 -13
- package/package.json +7 -6
- package/src/apps/catalog.generated.json +43 -3
- package/src/apps/page-validator.ts +27 -0
- package/src/be/db/model-profiles.ts +4 -1
- package/src/be/db/session-costs.ts +219 -0
- package/src/be/db/session-log-reasoning.ts +36 -0
- package/src/be/db/tasks/read.ts +7 -3
- package/src/be/db/tasks/write.ts +33 -1
- package/src/be/db.ts +200 -304
- package/src/be/key-window-usage.ts +385 -0
- package/src/be/migrations/303_task_ui_specs.sql +28 -0
- package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
- package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
- package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
- package/src/be/runtime-pools/db.ts +3 -0
- package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
- package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
- package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
- package/src/be/seed-skills/index.ts +3 -0
- package/src/be/swarm-config-guard.ts +24 -1
- package/src/be/task-ui-spec.ts +158 -0
- package/src/commands/controller.ts +3 -0
- package/src/commands/credential-outcome-report.ts +13 -3
- package/src/commands/rate-limit-outcome.ts +6 -0
- package/src/commands/runner.ts +34 -53
- package/src/extensions/catalog.generated.json +3 -3
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/http/api-keys.ts +258 -30
- package/src/http/session-data.ts +74 -23
- package/src/http/sessions.ts +6 -2
- package/src/http/tasks.ts +105 -5
- package/src/integrations/chat-sdk/relay.ts +87 -0
- package/src/jira/outbound.ts +5 -3
- package/src/linear/outbound.ts +5 -1
- package/src/prompts/base-prompt.ts +8 -0
- package/src/prompts/session-templates.ts +19 -2
- package/src/providers/acp-targets.ts +1 -1
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/claude-adapter.ts +27 -4
- package/src/providers/claude-flag-settings.ts +39 -1
- package/src/providers/codex-adapter.ts +85 -3
- package/src/providers/codex-app-server.ts +9 -5
- package/src/providers/codex-oauth/auth-json.ts +1 -0
- package/src/providers/pi-mono-adapter.ts +35 -2
- package/src/providers/pricing-sources.md +32 -0
- package/src/providers/types.ts +11 -0
- package/src/runtime-providers/docker.ts +65 -1
- package/src/scheduler/deferred-task-waits.ts +18 -5
- package/src/scripts-runtime/types/swarm-extension.d.ts +8 -8
- package/src/slack/actions.ts +56 -0
- package/src/slack/app.ts +22 -15
- package/src/slack/inbound-files.ts +2 -0
- package/src/slack/render-v2.ts +107 -23
- package/src/slack/responses.ts +3 -2
- package/src/slack/work-objects.ts +4 -1
- package/src/tasks/errors.ts +5 -0
- package/src/tests/acp-adapter.test.ts +4 -6
- package/src/tests/api-key-tracking.test.ts +0 -72
- package/src/tests/api-keys-status-model-limits.test.ts +93 -1
- package/src/tests/api-keys-validation.test.ts +42 -0
- package/src/tests/approval-card-resolution.test.ts +7 -1
- package/src/tests/approval-requests-notifications.test.ts +11 -1
- package/src/tests/apps-catalog-page-frame.test.ts +49 -0
- package/src/tests/apps-session-thread.test.ts +79 -0
- package/src/tests/base-prompt.test.ts +111 -5
- package/src/tests/chat-sdk-relay.test.ts +149 -1
- package/src/tests/claude-adapter-binary.test.ts +67 -6
- package/src/tests/claude-flag-settings.test.ts +29 -0
- package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
- package/src/tests/codex-adapter.test.ts +340 -2
- package/src/tests/codex-app-server.test.ts +16 -0
- package/src/tests/codex-oauth.test.ts +3 -1
- package/src/tests/codex-rate-limits.test.ts +384 -0
- package/src/tests/credential-outcome-report.test.ts +20 -0
- package/src/tests/db-task-read-contract.test.ts +3 -0
- package/src/tests/db-task-write-contract.test.ts +4 -0
- package/src/tests/deferred-task-wake.test.ts +63 -1
- package/src/tests/docker-isolation-config-guard.test.ts +29 -0
- package/src/tests/docs-index-footprint.test.js +11 -3
- package/src/tests/e2e-visuals-comment.test.ts +82 -0
- package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
- package/src/tests/extensions-example-sql-admin-only.test.ts +7 -4
- package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
- package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
- package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
- package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
- package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
- package/src/tests/gitleaks-download-retry.test.ts +85 -0
- package/src/tests/human-thread-routing.test.ts +187 -0
- package/src/tests/jira-outbound-sync.test.ts +33 -1
- package/src/tests/key-window-usage.test.ts +831 -0
- package/src/tests/linear-outbound-sync.test.ts +30 -1
- package/src/tests/pi-mono-adapter.test.ts +79 -0
- package/src/tests/preload-env.test.ts +2 -0
- package/src/tests/preload.ts +3 -1
- package/src/tests/prompt-template-session.test.ts +4 -3
- package/src/tests/provider-quota-persistence.test.ts +362 -0
- package/src/tests/rate-limit-event.test.ts +22 -0
- package/src/tests/reasoning-events.test.ts +164 -0
- package/src/tests/routing-affinity-inventory.test.ts +22 -0
- package/src/tests/runtime-providers-docker.test.ts +91 -0
- package/src/tests/script-connections.test.ts +5 -0
- package/src/tests/secret-canary-sweep.test.ts +41 -5
- package/src/tests/seed-scripts.test.ts +23 -0
- package/src/tests/session-cost-attribution.test.ts +748 -0
- package/src/tests/session-costs.test.ts +14 -15
- package/src/tests/session-logs.test.ts +83 -0
- package/src/tests/sessions-detail-batch.test.ts +7 -0
- package/src/tests/slack-render-v2.test.ts +357 -0
- package/src/tests/slack-start-reload-race.test.ts +67 -0
- package/src/tests/subscription-plans.test.ts +20 -1
- package/src/tests/task-ui-action-route.test.ts +191 -0
- package/src/tests/task-ui-actions.test.ts +195 -0
- package/src/tests/task-ui-spec-fallback.test.ts +65 -0
- package/src/tests/task-ui-spec.test.ts +368 -0
- package/src/tests/workflow-agent-task-retry.test.ts +34 -1
- package/src/tools/defer-task.ts +1 -1
- package/src/tools/store-progress.ts +69 -3
- package/src/types.ts +7 -2
- package/src/ui-spec/actions.ts +86 -0
- package/src/ui-spec/fallback.ts +19 -0
- package/src/ui-spec/slack.ts +17 -0
- package/src/ui-spec/validate.ts +169 -0
- package/src/utils/codex-rate-limits.ts +159 -0
- package/src/utils/credentials.ts +2 -0
- package/src/utils/error-tracker.ts +19 -0
- package/src/utils/provider-account-telemetry.ts +331 -0
- package/src/utils/reasoning-events.ts +107 -0
- package/src/utils/subscription-plans.ts +11 -59
- package/src/utils/task-ui-spec.ts +67 -0
- package/src/workflows/task-step-routing.ts +8 -3
- package/templates/extensions/sql-admin-only/README.md +2 -1
- package/templates/extensions/sql-admin-only/hooks.ts +7 -3
- package/templates/extensions/sql-admin-only/manifest.json +1 -1
- package/templates/skills/apps/SKILL.md +32 -5
- package/templates/skills/apps/content.md +32 -5
- package/templates/skills/ui-spec/config.json +14 -0
- package/templates/skills/ui-spec/content.md +127 -0
- package/dist/acp-adapter-jqn86aam.js +0 -16
- package/dist/cli-srtkr1h2.js +0 -12078
- package/dist/fx-adapter-0zrkfbkd.js +0 -19
- package/dist/grok-adapter-3db1c538.js +0 -19
- package/dist/handlers-k22n8mnn.js +0 -33
- package/dist/index-8xcyd3mc.js +0 -33
- package/dist/index-9sy2bh6n.js +0 -38
- package/dist/index-b24j7t2m.js +0 -12797
- package/dist/index-wjd56k1v.js +0 -34
- package/dist/lead-atxf3q6e.js +0 -72
- package/dist/thread-buffer-4yz236d0.js +0 -36
- package/dist/worker-p4hbtcy3.js +0 -72
- package/dist/{cli-j49yqpvh.js → cli-7evph51z.js} +3 -3
|
@@ -9,7 +9,7 @@ const SQL_TOOLS = new Set(["db-query"]);
|
|
|
9
9
|
const manifest = {
|
|
10
10
|
name: "sql-admin-only",
|
|
11
11
|
description: "Blocks db-query tool calls on tasks created by a non-admin user",
|
|
12
|
-
version: "1.
|
|
12
|
+
version: "1.1.0",
|
|
13
13
|
runtime: "api",
|
|
14
14
|
assets: { hooks: "hooks.ts" },
|
|
15
15
|
config,
|
|
@@ -64,7 +64,7 @@ const extension: SwarmExtension<typeof manifest> = (api) => {
|
|
|
64
64
|
const taskId = event.requestInfo?.sourceTaskId;
|
|
65
65
|
if (!taskId) return;
|
|
66
66
|
|
|
67
|
-
// Creator lookup.
|
|
67
|
+
// Creator lookup. A failed lookup blocks this SQL call only (fail closed).
|
|
68
68
|
let creator: string;
|
|
69
69
|
let role: string;
|
|
70
70
|
try {
|
|
@@ -74,7 +74,11 @@ const extension: SwarmExtension<typeof manifest> = (api) => {
|
|
|
74
74
|
)) as Envelope;
|
|
75
75
|
if (q?.success === false) throw new Error("db-query lookup returned success=false");
|
|
76
76
|
const row = (q?.data?.rows ?? q?.rows ?? [])[0];
|
|
77
|
-
|
|
77
|
+
// A successful lookup with no row: the id is not a task. The runner sends a
|
|
78
|
+
// random correlation id for sessions with no task (pool or channel-message
|
|
79
|
+
// triggers, src/commands/runner.ts effectiveTaskId). No task means no creator:
|
|
80
|
+
// allow, the same as a missing header. Errors and timeouts above still block.
|
|
81
|
+
if (!row) return;
|
|
78
82
|
creator = String(cell(row, 0, "requestedByUserId") ?? "");
|
|
79
83
|
role = String(cell(row, 1, "role") ?? "");
|
|
80
84
|
} catch (err) {
|
|
@@ -555,7 +555,7 @@ Tones: Badge, Metric and Progress `tone` take `neutral`, `success`, `active`, `e
|
|
|
555
555
|
| `Text` | `content` | `tone: "default" or "muted"`. |
|
|
556
556
|
| `Markdown` | `content` | Rendered Markdown for help, instructions, and rich prose; no children. A link to a GitHub PR, issue, commit or repo, a dashboard task, agent, session or app, or an agent-fs file renders as a chip (icon plus short label), like agent output in a session; `[text](url)` keeps its text. |
|
|
557
557
|
| `SearchInput` | `id` | `placeholder`, `label`, `shortcut` (one key, usually `"/"`: shows a keycap and focuses the field); writes debounced text to `/ui/<id>/value`; no children. |
|
|
558
|
-
| `Select` | `id`, `options` | `options` are strings or `{ value, label?, icon?, hint? }`; `placeholder`, `label`, `clearable`, `searchable` (type to filter; on by default past 8 options), `searchPlaceholder`, `multiple`, `defaultValue` (seeds `/ui/<id>/value` once, before any interaction; a one-entry array with `multiple
|
|
558
|
+
| `Select` | `id`, `options` | `options` are strings or `{ value, label?, icon?, hint? }`; `placeholder`, `label`, `clearable`, `searchable` (type to filter; on by default past 8 options), `searchPlaceholder`, `multiple`, `defaultValue` (seeds `/ui/<id>/value` once, before any interaction; a one-entry array with `multiple`; a value bound to a query that is still loading seeds when it arrives, unless the viewer already picked); writes a string or null to `/ui/<id>/value`, or with `multiple` a string array (empty = nothing picked); no children. |
|
|
559
559
|
| `NumberInput` | `id` | `label`, `placeholder`, `min`, `max`; a text field with a decimal keyboard that writes the parsed number to `/ui/<id>/value` on every change (no debounce), or null when the field is empty; non-numeric text (a bare `-` mid-edit, letters) leaves the stored value untouched; `min`/`max` clamp the stored value and the visible text snaps to it when the field loses focus; no children. |
|
|
560
560
|
| `Chips` | `id`, `options` | Toggle chips for quick filters. `options` are strings or `{ value, label?, icon? }`; `multiple`; `label` (group name for screen readers). Writes a string or null to `/ui/<id>/value`, or a string array with `multiple`; pressing the selected chip clears it. |
|
|
561
561
|
| `Button` | `label` | `variant: "default", "secondary", "outline", "ghost", "destructive", or "destructive-outline"` (use `destructive-outline` for standalone deletes); `disabled` (constant or bound boolean); `busyWith: "<actionName>"` swaps the label for a spinner while that custom action's `/actions/<name>/status` is `"running"` (presses are ignored), then shows a check and `successLabel` for about 1.5s when it turns `"ok"`; `icon`, `iconPosition: "start" or "end"`; `size: "sm", "default", or "lg"`; `shortcut` (one key, shown as a keycap, presses the button); `hint` (tooltip); dispatch with element-level `on.press`. |
|
|
@@ -589,6 +589,7 @@ Tones: Badge, Metric and Progress `tone` take `neutral`, `success`, `active`, `e
|
|
|
589
589
|
| `SchemaForm` | `id`, `schema` | `value`, `baseDoc`, `nodeKey`, `onChange`, `fill`; form generated from a JSON schema's `properties`, mirrored to `/ui/<id>/value`; see below. |
|
|
590
590
|
| `Approval` | `requestId` | `showResolved` (default true), `compact`, `onResolved`; one approval request answered in place by the viewer; see below. |
|
|
591
591
|
| `SessionThread` | `id`, `sessionKey` | `scope`, `placeholder`, `onDispatch`, `fill`; the dashboard's session conversation (the "Session about this page" panel) for one session per viewer and key, with a composer that steers or chains tasks; the draft is mirrored to `/ui/<id>/value`; see below. |
|
|
592
|
+
| `PageFrame` | `pageId` | `device` (`desktop` default, or `mobile`: a 390 px wide frame), `height` (default `640px`), `fill`; a live, clickable swarm Page that reloads when the page changes; see below. |
|
|
592
593
|
|
|
593
594
|
Table details:
|
|
594
595
|
|
|
@@ -714,7 +715,7 @@ SessionThread details — a chat on an app page, one session per viewer and `ses
|
|
|
714
715
|
- Each `app.action` step of `onDispatch` is sent with the session (`{ key, scope }`) and with `followUp: false` unless the step sets `followUp` itself, so the Lead adds no review task to the chain and each message stays one task. A Lead review that is in the chain anyway (a steer the server promoted to a task) is never steered or chained under.
|
|
715
716
|
- "New session" (shown once a session exists) starts over: the next message creates a new root, and the thread shows only sessions created after the current one. Nothing is deleted; older sessions stay in the dashboard's Sessions list.
|
|
716
717
|
- While the session loads, the composer is disabled with a loading notice. A session whose chain cannot be found blocks sending. After a send, the composer stays busy until the new task shows up, for at most 30 seconds.
|
|
717
|
-
- Without `fill` the thread is 420 px tall; `fill: true` fills a `fill`-aware parent. Inside an element instance, `id` is namespaced per instance, so two instances keep separate drafts.
|
|
718
|
+
- Without `fill` the thread is 420 px tall; `fill: true` fills a `fill`-aware parent, and keeps at least 420 px on a phone, where a `Split` or `Grid` stacks its panes. Inside an element instance, `id` is namespaced per instance, so two instances keep separate drafts.
|
|
718
719
|
|
|
719
720
|
```json
|
|
720
721
|
{ "type": "SessionThread", "props": {
|
|
@@ -725,6 +726,22 @@ SessionThread details — a chat on an app page, one session per viewer and `ses
|
|
|
725
726
|
} }
|
|
726
727
|
```
|
|
727
728
|
|
|
729
|
+
PageFrame details — a live swarm Page inside the app, for a preview pane next to a `SessionThread`:
|
|
730
|
+
|
|
731
|
+
- It renders the body `/pages/<pageId>` shows: an HTML page in a sandboxed iframe (scripts, forms and popups; never top navigation), a JSON page inline. The viewer can click and scroll it.
|
|
732
|
+
- It checks the page every 3 s and reloads by itself when the page's `updatedAt` moves: a new version, a restore, a theme switch. A reload resets scroll and any state inside the page.
|
|
733
|
+
- `pageId` is a page id (32 hex characters), usually bound: `{ "$state": "/queries/project/data/0/pageId" }`. A literal slug is rejected; an empty id shows "No page selected".
|
|
734
|
+
- The viewer needs read access to the page: an authed page launches a page session for them, a password page asks for its password.
|
|
735
|
+
- `device: "mobile"` centers a 390 px wide frame, so the page's own media queries see a phone. A JSON page follows the dashboard viewport instead. Switch devices with two `PageFrame`s in `Tabs`, or bind `device` to a `Select`.
|
|
736
|
+
|
|
737
|
+
```json
|
|
738
|
+
{ "type": "PageFrame", "props": {
|
|
739
|
+
"pageId": { "$state": "/queries/project/data/0/pageId" },
|
|
740
|
+
"device": { "$state": "/ui/device/value" },
|
|
741
|
+
"fill": true
|
|
742
|
+
} }
|
|
743
|
+
```
|
|
744
|
+
|
|
728
745
|
Form details:
|
|
729
746
|
|
|
730
747
|
- `fields[]`: `{ name, label?, kind?, options?: string[], placeholder?, required? }`; `kind` is `string`, `text`, `number`, `boolean`, `date`, `enum`, or `file`, and enum fields need `options`.
|
|
@@ -854,16 +871,26 @@ Only inside action-chain `params` (`on.<event>`, `Table.rowActions[].actions`, `
|
|
|
854
871
|
| `{ "$form": "title" }` | One current Form value. |
|
|
855
872
|
| `{ "$form": "" }` | All current Form values. |
|
|
856
873
|
| `{ "$state": "/queries/allIdeas/data" }` | Current value at a valid app state path, including action state such as `/actions/refreshIssues/status`. |
|
|
857
|
-
| `{ "$chain": "leafTaskId" }` | One chain-scope value, published by the component that runs the chain: a task chain (`SessionThread`) carries `leafTaskId` and `newTaskId`; `Approval.onResolved` carries `status`, `responses` and `resolvedBy
|
|
874
|
+
| `{ "$chain": "leafTaskId" }` | One chain-scope value, published by the component that runs the chain: a task chain (`SessionThread`) carries `leafTaskId` and `newTaskId`; `Approval.onResolved` carries `status`, `responses` and `resolvedBy`; `Form.onSubmit` carries `createdRowId` (the row its newest `app.mutate` create step made). The component publishes every key, `null` when it has no value yet; a `null` key resolves to nothing and its param is dropped (a `parentTaskId` bound to a `null` `leafTaskId` creates a root task). Where no chain scope is published (Table), or the key is not one the scope carries (a typo), the sentinel is left in place and the action fails instead of silently dropping the parent. An empty string is not "no parent": a `$state` slot meaning "no parent yet" must hold `null`. |
|
|
858
875
|
| `{ "$chain": "" }` | The whole chain scope. |
|
|
859
876
|
|
|
860
877
|
Each sentinel object must contain exactly the single key shown.
|
|
861
878
|
|
|
862
879
|
An action-chain step is `{ "action": "<type>", "params": {...} }`. Available action types:
|
|
863
880
|
|
|
864
|
-
- `app.mutate`: `{ model, op, rowId?, values?, formId? }`, where `op` is `"create"`, `"update"`, or `"delete"`. `update`/`delete` require `rowId` (usually `{ "$row": "id" }`, or `{ "$state": "/route/params/<param>" }` in a Drawer footer); literal `values` keys must be model columns. Successful mutation refetches all queries on that model.
|
|
881
|
+
- `app.mutate`: `{ model, op, rowId?, values?, formId? }`, where `op` is `"create"`, `"update"`, or `"delete"`. `update`/`delete` require `rowId` (usually `{ "$row": "id" }`, or `{ "$state": "/route/params/<param>" }` in a Drawer footer); literal `values` keys must be model columns. Successful mutation refetches all queries on that model. In a `Form.onSubmit` chain, steps after a `create` read the new row's id as `{ "$chain": "createdRowId" }`, e.g. to navigate to the new row (not `$state`: the renderer resolves a chain's `$state` reads when the form renders, before the row exists).
|
|
865
882
|
- `app.refresh`: `{ query? }`; omit `query` to refetch all, or name a declared query.
|
|
866
|
-
- `app.action`: `{ name, input?, parentTaskId?, followUp? }`; `name` must be declared in definition `actions`. For a task-kind row action, pass whole-row context with `input: { issue: { "$row": "" } }`. `parentTaskId` chains the created task under an existing one for task-kind actions (typically `{ "$chain": "leafTaskId" }`; a literal or `$state` task id also works); a script or sync action rejects it with 400. `followUp: false` creates the task with no Lead follow-up (the review task the Lead adds when a worker task finishes); script and sync actions ignore it. A task an action creates is attributed to the viewer's identity. `session: { key, scope }`
|
|
883
|
+
- `app.action`: `{ name, input?, parentTaskId?, followUp? }`; `name` must be declared in definition `actions`. For a task-kind row action, pass whole-row context with `input: { issue: { "$row": "" } }`. `parentTaskId` chains the created task under an existing one for task-kind actions (typically `{ "$chain": "leafTaskId" }`; a literal or `$state` task id also works); a script or sync action rejects it with 400. `followUp: false` creates the task with no Lead follow-up (the review task the Lead adds when a worker task finishes); script and sync actions ignore it. A task an action creates is attributed to the viewer's identity. `session: { key, scope? }` keys a task-kind action's task into the viewer's `SessionThread` session for that key; the server builds the key, never the page. SessionThread sets it on its own `onDispatch` steps (replacing any value there). Any other chain can set it to start a session: `key` is a literal plain token (validated like `sessionKey`) or a binding; a key that does not resolve to a token fails the step instead of creating a task outside the session, `scope: "shared"` is rejected, and a session step defaults to `followUp: false`. Example, a create form that sends the idea as the chat's first message:
|
|
884
|
+
|
|
885
|
+
```json
|
|
886
|
+
"onSubmit": [
|
|
887
|
+
{ "action": "app.mutate", "params": { "model": "project", "op": "create", "values": { "name": { "$form": "name" } } } },
|
|
888
|
+
{ "action": "app.action", "params": { "name": "build", "input": { "message": { "$form": "idea" } }, "session": { "key": { "$chain": "createdRowId" } } } },
|
|
889
|
+
{ "action": "app.navigate", "params": { "page": "studio", "params": { "projectId": { "$chain": "createdRowId" } } } }
|
|
890
|
+
]
|
|
891
|
+
```
|
|
892
|
+
|
|
893
|
+
The `studio` page's `SessionThread` with `"sessionKey": { "$state": "/route/params/projectId" }` then shows the idea as its first message and the running task, with no second send.
|
|
867
894
|
- `app.navigate`: `{ page, params? }`; `page` must be declared, supplied keys must be params of the target page, and every required target param must be supplied. `params` replace the current route params wholesale and may contain action sentinels. Navigation pushes history, so browser Back returns to the previous page/params; only `mode` is preserved automatically.
|
|
868
895
|
- `ui.toast`: `{ message, description?, tone?, undo? }`, where `tone` is `"success"`, `"error"`, `"info"` (default), or `"warning"`. `undo: { label?, actions }` adds an Undo button (default label `Undo`) that runs `actions` as a chain; its steps are validated like any chain. Put it after the step it confirms, e.g. a row delete followed by `{ "action": "ui.toast", "params": { "message": "Order deleted", "undo": { "actions": [{ "action": "app.mutate", "params": { "model": "order", "op": "create", "values": { "title": { "$row": "title" } } } }] } } }`. Undo params resolve `$state` when Undo is pressed; `$row` / `$form` resolve when the toast is shown.
|
|
869
896
|
- `swarm.sdk`: `{ sdk, args? }`; invokes a catalog-supported Swarm browser SDK method with the viewer's bearer.
|
|
@@ -550,7 +550,7 @@ Tones: Badge, Metric and Progress `tone` take `neutral`, `success`, `active`, `e
|
|
|
550
550
|
| `Text` | `content` | `tone: "default" or "muted"`. |
|
|
551
551
|
| `Markdown` | `content` | Rendered Markdown for help, instructions, and rich prose; no children. A link to a GitHub PR, issue, commit or repo, a dashboard task, agent, session or app, or an agent-fs file renders as a chip (icon plus short label), like agent output in a session; `[text](url)` keeps its text. |
|
|
552
552
|
| `SearchInput` | `id` | `placeholder`, `label`, `shortcut` (one key, usually `"/"`: shows a keycap and focuses the field); writes debounced text to `/ui/<id>/value`; no children. |
|
|
553
|
-
| `Select` | `id`, `options` | `options` are strings or `{ value, label?, icon?, hint? }`; `placeholder`, `label`, `clearable`, `searchable` (type to filter; on by default past 8 options), `searchPlaceholder`, `multiple`, `defaultValue` (seeds `/ui/<id>/value` once, before any interaction; a one-entry array with `multiple
|
|
553
|
+
| `Select` | `id`, `options` | `options` are strings or `{ value, label?, icon?, hint? }`; `placeholder`, `label`, `clearable`, `searchable` (type to filter; on by default past 8 options), `searchPlaceholder`, `multiple`, `defaultValue` (seeds `/ui/<id>/value` once, before any interaction; a one-entry array with `multiple`; a value bound to a query that is still loading seeds when it arrives, unless the viewer already picked); writes a string or null to `/ui/<id>/value`, or with `multiple` a string array (empty = nothing picked); no children. |
|
|
554
554
|
| `NumberInput` | `id` | `label`, `placeholder`, `min`, `max`; a text field with a decimal keyboard that writes the parsed number to `/ui/<id>/value` on every change (no debounce), or null when the field is empty; non-numeric text (a bare `-` mid-edit, letters) leaves the stored value untouched; `min`/`max` clamp the stored value and the visible text snaps to it when the field loses focus; no children. |
|
|
555
555
|
| `Chips` | `id`, `options` | Toggle chips for quick filters. `options` are strings or `{ value, label?, icon? }`; `multiple`; `label` (group name for screen readers). Writes a string or null to `/ui/<id>/value`, or a string array with `multiple`; pressing the selected chip clears it. |
|
|
556
556
|
| `Button` | `label` | `variant: "default", "secondary", "outline", "ghost", "destructive", or "destructive-outline"` (use `destructive-outline` for standalone deletes); `disabled` (constant or bound boolean); `busyWith: "<actionName>"` swaps the label for a spinner while that custom action's `/actions/<name>/status` is `"running"` (presses are ignored), then shows a check and `successLabel` for about 1.5s when it turns `"ok"`; `icon`, `iconPosition: "start" or "end"`; `size: "sm", "default", or "lg"`; `shortcut` (one key, shown as a keycap, presses the button); `hint` (tooltip); dispatch with element-level `on.press`. |
|
|
@@ -584,6 +584,7 @@ Tones: Badge, Metric and Progress `tone` take `neutral`, `success`, `active`, `e
|
|
|
584
584
|
| `SchemaForm` | `id`, `schema` | `value`, `baseDoc`, `nodeKey`, `onChange`, `fill`; form generated from a JSON schema's `properties`, mirrored to `/ui/<id>/value`; see below. |
|
|
585
585
|
| `Approval` | `requestId` | `showResolved` (default true), `compact`, `onResolved`; one approval request answered in place by the viewer; see below. |
|
|
586
586
|
| `SessionThread` | `id`, `sessionKey` | `scope`, `placeholder`, `onDispatch`, `fill`; the dashboard's session conversation (the "Session about this page" panel) for one session per viewer and key, with a composer that steers or chains tasks; the draft is mirrored to `/ui/<id>/value`; see below. |
|
|
587
|
+
| `PageFrame` | `pageId` | `device` (`desktop` default, or `mobile`: a 390 px wide frame), `height` (default `640px`), `fill`; a live, clickable swarm Page that reloads when the page changes; see below. |
|
|
587
588
|
|
|
588
589
|
Table details:
|
|
589
590
|
|
|
@@ -709,7 +710,7 @@ SessionThread details — a chat on an app page, one session per viewer and `ses
|
|
|
709
710
|
- Each `app.action` step of `onDispatch` is sent with the session (`{ key, scope }`) and with `followUp: false` unless the step sets `followUp` itself, so the Lead adds no review task to the chain and each message stays one task. A Lead review that is in the chain anyway (a steer the server promoted to a task) is never steered or chained under.
|
|
710
711
|
- "New session" (shown once a session exists) starts over: the next message creates a new root, and the thread shows only sessions created after the current one. Nothing is deleted; older sessions stay in the dashboard's Sessions list.
|
|
711
712
|
- While the session loads, the composer is disabled with a loading notice. A session whose chain cannot be found blocks sending. After a send, the composer stays busy until the new task shows up, for at most 30 seconds.
|
|
712
|
-
- Without `fill` the thread is 420 px tall; `fill: true` fills a `fill`-aware parent. Inside an element instance, `id` is namespaced per instance, so two instances keep separate drafts.
|
|
713
|
+
- Without `fill` the thread is 420 px tall; `fill: true` fills a `fill`-aware parent, and keeps at least 420 px on a phone, where a `Split` or `Grid` stacks its panes. Inside an element instance, `id` is namespaced per instance, so two instances keep separate drafts.
|
|
713
714
|
|
|
714
715
|
```json
|
|
715
716
|
{ "type": "SessionThread", "props": {
|
|
@@ -720,6 +721,22 @@ SessionThread details — a chat on an app page, one session per viewer and `ses
|
|
|
720
721
|
} }
|
|
721
722
|
```
|
|
722
723
|
|
|
724
|
+
PageFrame details — a live swarm Page inside the app, for a preview pane next to a `SessionThread`:
|
|
725
|
+
|
|
726
|
+
- It renders the body `/pages/<pageId>` shows: an HTML page in a sandboxed iframe (scripts, forms and popups; never top navigation), a JSON page inline. The viewer can click and scroll it.
|
|
727
|
+
- It checks the page every 3 s and reloads by itself when the page's `updatedAt` moves: a new version, a restore, a theme switch. A reload resets scroll and any state inside the page.
|
|
728
|
+
- `pageId` is a page id (32 hex characters), usually bound: `{ "$state": "/queries/project/data/0/pageId" }`. A literal slug is rejected; an empty id shows "No page selected".
|
|
729
|
+
- The viewer needs read access to the page: an authed page launches a page session for them, a password page asks for its password.
|
|
730
|
+
- `device: "mobile"` centers a 390 px wide frame, so the page's own media queries see a phone. A JSON page follows the dashboard viewport instead. Switch devices with two `PageFrame`s in `Tabs`, or bind `device` to a `Select`.
|
|
731
|
+
|
|
732
|
+
```json
|
|
733
|
+
{ "type": "PageFrame", "props": {
|
|
734
|
+
"pageId": { "$state": "/queries/project/data/0/pageId" },
|
|
735
|
+
"device": { "$state": "/ui/device/value" },
|
|
736
|
+
"fill": true
|
|
737
|
+
} }
|
|
738
|
+
```
|
|
739
|
+
|
|
723
740
|
Form details:
|
|
724
741
|
|
|
725
742
|
- `fields[]`: `{ name, label?, kind?, options?: string[], placeholder?, required? }`; `kind` is `string`, `text`, `number`, `boolean`, `date`, `enum`, or `file`, and enum fields need `options`.
|
|
@@ -849,16 +866,26 @@ Only inside action-chain `params` (`on.<event>`, `Table.rowActions[].actions`, `
|
|
|
849
866
|
| `{ "$form": "title" }` | One current Form value. |
|
|
850
867
|
| `{ "$form": "" }` | All current Form values. |
|
|
851
868
|
| `{ "$state": "/queries/allIdeas/data" }` | Current value at a valid app state path, including action state such as `/actions/refreshIssues/status`. |
|
|
852
|
-
| `{ "$chain": "leafTaskId" }` | One chain-scope value, published by the component that runs the chain: a task chain (`SessionThread`) carries `leafTaskId` and `newTaskId`; `Approval.onResolved` carries `status`, `responses` and `resolvedBy
|
|
869
|
+
| `{ "$chain": "leafTaskId" }` | One chain-scope value, published by the component that runs the chain: a task chain (`SessionThread`) carries `leafTaskId` and `newTaskId`; `Approval.onResolved` carries `status`, `responses` and `resolvedBy`; `Form.onSubmit` carries `createdRowId` (the row its newest `app.mutate` create step made). The component publishes every key, `null` when it has no value yet; a `null` key resolves to nothing and its param is dropped (a `parentTaskId` bound to a `null` `leafTaskId` creates a root task). Where no chain scope is published (Table), or the key is not one the scope carries (a typo), the sentinel is left in place and the action fails instead of silently dropping the parent. An empty string is not "no parent": a `$state` slot meaning "no parent yet" must hold `null`. |
|
|
853
870
|
| `{ "$chain": "" }` | The whole chain scope. |
|
|
854
871
|
|
|
855
872
|
Each sentinel object must contain exactly the single key shown.
|
|
856
873
|
|
|
857
874
|
An action-chain step is `{ "action": "<type>", "params": {...} }`. Available action types:
|
|
858
875
|
|
|
859
|
-
- `app.mutate`: `{ model, op, rowId?, values?, formId? }`, where `op` is `"create"`, `"update"`, or `"delete"`. `update`/`delete` require `rowId` (usually `{ "$row": "id" }`, or `{ "$state": "/route/params/<param>" }` in a Drawer footer); literal `values` keys must be model columns. Successful mutation refetches all queries on that model.
|
|
876
|
+
- `app.mutate`: `{ model, op, rowId?, values?, formId? }`, where `op` is `"create"`, `"update"`, or `"delete"`. `update`/`delete` require `rowId` (usually `{ "$row": "id" }`, or `{ "$state": "/route/params/<param>" }` in a Drawer footer); literal `values` keys must be model columns. Successful mutation refetches all queries on that model. In a `Form.onSubmit` chain, steps after a `create` read the new row's id as `{ "$chain": "createdRowId" }`, e.g. to navigate to the new row (not `$state`: the renderer resolves a chain's `$state` reads when the form renders, before the row exists).
|
|
860
877
|
- `app.refresh`: `{ query? }`; omit `query` to refetch all, or name a declared query.
|
|
861
|
-
- `app.action`: `{ name, input?, parentTaskId?, followUp? }`; `name` must be declared in definition `actions`. For a task-kind row action, pass whole-row context with `input: { issue: { "$row": "" } }`. `parentTaskId` chains the created task under an existing one for task-kind actions (typically `{ "$chain": "leafTaskId" }`; a literal or `$state` task id also works); a script or sync action rejects it with 400. `followUp: false` creates the task with no Lead follow-up (the review task the Lead adds when a worker task finishes); script and sync actions ignore it. A task an action creates is attributed to the viewer's identity. `session: { key, scope }`
|
|
878
|
+
- `app.action`: `{ name, input?, parentTaskId?, followUp? }`; `name` must be declared in definition `actions`. For a task-kind row action, pass whole-row context with `input: { issue: { "$row": "" } }`. `parentTaskId` chains the created task under an existing one for task-kind actions (typically `{ "$chain": "leafTaskId" }`; a literal or `$state` task id also works); a script or sync action rejects it with 400. `followUp: false` creates the task with no Lead follow-up (the review task the Lead adds when a worker task finishes); script and sync actions ignore it. A task an action creates is attributed to the viewer's identity. `session: { key, scope? }` keys a task-kind action's task into the viewer's `SessionThread` session for that key; the server builds the key, never the page. SessionThread sets it on its own `onDispatch` steps (replacing any value there). Any other chain can set it to start a session: `key` is a literal plain token (validated like `sessionKey`) or a binding; a key that does not resolve to a token fails the step instead of creating a task outside the session, `scope: "shared"` is rejected, and a session step defaults to `followUp: false`. Example, a create form that sends the idea as the chat's first message:
|
|
879
|
+
|
|
880
|
+
```json
|
|
881
|
+
"onSubmit": [
|
|
882
|
+
{ "action": "app.mutate", "params": { "model": "project", "op": "create", "values": { "name": { "$form": "name" } } } },
|
|
883
|
+
{ "action": "app.action", "params": { "name": "build", "input": { "message": { "$form": "idea" } }, "session": { "key": { "$chain": "createdRowId" } } } },
|
|
884
|
+
{ "action": "app.navigate", "params": { "page": "studio", "params": { "projectId": { "$chain": "createdRowId" } } } }
|
|
885
|
+
]
|
|
886
|
+
```
|
|
887
|
+
|
|
888
|
+
The `studio` page's `SessionThread` with `"sessionKey": { "$state": "/route/params/projectId" }` then shows the idea as its first message and the running task, with no second send.
|
|
862
889
|
- `app.navigate`: `{ page, params? }`; `page` must be declared, supplied keys must be params of the target page, and every required target param must be supplied. `params` replace the current route params wholesale and may contain action sentinels. Navigation pushes history, so browser Back returns to the previous page/params; only `mode` is preserved automatically.
|
|
863
890
|
- `ui.toast`: `{ message, description?, tone?, undo? }`, where `tone` is `"success"`, `"error"`, `"info"` (default), or `"warning"`. `undo: { label?, actions }` adds an Undo button (default label `Undo`) that runs `actions` as a chain; its steps are validated like any chain. Put it after the step it confirms, e.g. a row delete followed by `{ "action": "ui.toast", "params": { "message": "Order deleted", "undo": { "actions": [{ "action": "app.mutate", "params": { "model": "order", "op": "create", "values": { "title": { "$row": "title" } } } }] } } }`. Undo params resolve `$state` when Undo is pressed; `$row` / `$form` resolve when the toast is shown.
|
|
864
891
|
- `swarm.sdk`: `{ sdk, args? }`; invokes a catalog-supported Swarm browser SDK method with the viewer's bearer.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"kind": "skill",
|
|
3
|
+
"name": "ui-spec",
|
|
4
|
+
"displayName": "UI spec cards",
|
|
5
|
+
"slug": "ui-spec",
|
|
6
|
+
"title": "UI spec cards",
|
|
7
|
+
"description": "Attach a rich card to a task result with the `store-progress` input `uiSpec`: a json-render spec for the chat catalog that renders in the Slack outcome card, the session view and Chat SDK channels. Covers the 12 components and their props, when to make a card and when not to, the caps and their Slack reasons, the https rule, buttons, the lead rule for worker specs, and 2 complete examples.",
|
|
8
|
+
"version": "1.0.0",
|
|
9
|
+
"category": "skills",
|
|
10
|
+
"placeholders": [],
|
|
11
|
+
"runAllSeedersCandidate": true,
|
|
12
|
+
"systemDefault": true,
|
|
13
|
+
"tags": ["ui-spec", "json-render", "cards", "slack", "visuals"]
|
|
14
|
+
}
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# UI spec cards
|
|
2
|
+
|
|
3
|
+
A task result can carry a rich card next to the prose answer. You attach it with the `store-progress` input `uiSpec` when you complete the task. The card renders in the Slack outcome card, in the session view, on the task page and in Chat SDK channels. Surfaces that show only text (Linear, Jira, the legacy Slack card, Slack Work Objects) get the card's fallback text.
|
|
4
|
+
|
|
5
|
+
The card is on only when the operator sets `UI_SPEC_ENABLED=true`. When the "Rich cards" section is in your system prompt, the flag is on.
|
|
6
|
+
|
|
7
|
+
## When to make a card
|
|
8
|
+
|
|
9
|
+
Make a card in 2 cases:
|
|
10
|
+
|
|
11
|
+
- The requester asks for a visual, a chart, a table, a dashboard or a summary card.
|
|
12
|
+
- The result holds numbers that compare, a series over time, shares of a whole, or records with the same fields.
|
|
13
|
+
|
|
14
|
+
Do not make a card for:
|
|
15
|
+
|
|
16
|
+
- a one-line answer;
|
|
17
|
+
- a yes or no;
|
|
18
|
+
- a status reply;
|
|
19
|
+
- a delegation;
|
|
20
|
+
- a result that is prose only.
|
|
21
|
+
|
|
22
|
+
## `output` stays the prose answer
|
|
23
|
+
|
|
24
|
+
`output` stays the complete answer in prose. The card adds to it and never replaces it. A reader who sees only the text must get the full answer.
|
|
25
|
+
|
|
26
|
+
## The shape of `uiSpec`
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"spec": { "root": "<element id>", "elements": { "<element id>": { "type": "...", "props": {}, "children": [] } } },
|
|
31
|
+
"actions": { "<action id>": { "kind": "follow_up", "prompt": "..." } }
|
|
32
|
+
}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
- `spec.root` names the root element. The root must be a `Card`.
|
|
36
|
+
- `spec.elements` is a flat map. Each element has `type`, `props` and `children` (a list of element ids). Give `children: []` to a leaf.
|
|
37
|
+
- `actions` is optional. It is for `Button` only (see "Buttons").
|
|
38
|
+
|
|
39
|
+
## The 12 components
|
|
40
|
+
|
|
41
|
+
| Component | Props | Children |
|
|
42
|
+
|---|---|---|
|
|
43
|
+
| `Card` | `title`, `subtitle`, `imageUrl` (all optional) | Any. The root of every spec. `title` renders as the header. |
|
|
44
|
+
| `Section` | none | Groups related elements. |
|
|
45
|
+
| `Text` | `content` (markdown, required), `style`: `plain`, `bold` or `muted` | none. Use `muted` for footnotes and the source line. |
|
|
46
|
+
| `Fields` | none | `Field` elements only. A grid of label and value pairs. |
|
|
47
|
+
| `Field` | `label`, `value` (string or number) | none. Good for KPIs. |
|
|
48
|
+
| `Table` | `headers` (string list), `rows` (list of lists of strings or numbers), `align` (`left`, `center`, `right` per column), `caption` | none. Every row has one cell per header. Right-align numeric columns. |
|
|
49
|
+
| `Chart` | `title` (required), `chart` | none. See below. |
|
|
50
|
+
| `Divider` | none | none. A separator between groups. |
|
|
51
|
+
| `Image` | `url` (https), `alt` (required) | none. |
|
|
52
|
+
| `Actions` | none | `Button` and `LinkButton` elements. A row of buttons. |
|
|
53
|
+
| `Button` | `id`, `label`, `style`: `primary`, `danger` or `default`, `value` | none. Needs `UI_SPEC_ACTIONS_ENABLED`. |
|
|
54
|
+
| `LinkButton` | `label`, `url` (https) | none. Opens the URL. |
|
|
55
|
+
|
|
56
|
+
`Chart.chart` has one of 2 forms:
|
|
57
|
+
|
|
58
|
+
- Pie, for shares of a whole: `{ "type": "pie", "segments": [{ "label": "Enterprise", "value": 52 }] }`. Each `value` is positive.
|
|
59
|
+
- Series, for values over categories: `{ "type": "bar" | "line" | "area", "categories": ["Jan", "Feb"], "series": [{ "name": "Revenue", "values": [1.02, 1.08] }], "xLabel": "...", "yLabel": "..." }`. Each series has one value per category. `xLabel` and `yLabel` are optional.
|
|
60
|
+
|
|
61
|
+
Chart titles stay at 50 characters or fewer. Chart labels stay at 20 characters or fewer.
|
|
62
|
+
|
|
63
|
+
## Caps
|
|
64
|
+
|
|
65
|
+
The engine checks every spec when you store it. It refuses a spec that breaks a cap and tells you which one. Fix the spec and call `store-progress` again.
|
|
66
|
+
|
|
67
|
+
| Cap | Reason |
|
|
68
|
+
|---|---|
|
|
69
|
+
| At most 2 charts | Slack renders a chart as a native `data_visualization` block, and Slack allows 2 of them per message. A 3rd number series goes in `Fields` or in the table. |
|
|
70
|
+
| At most 1 table, of at most 100 rows and 20 columns | Slack renders 1 native table (`data_table`) per message. Above 100 rows or 20 columns, the Slack adapter falls back to ASCII text. |
|
|
71
|
+
| A Slack table shows 5 rows per page | The native Slack table pages 5 rows at a time, with a pager. You cannot change the page size. Put the most important rows first. |
|
|
72
|
+
| 32 KiB | The JSON of `spec` is at most 32,768 bytes. |
|
|
73
|
+
| 45 Slack blocks, 25 elements in one `Actions` row | Slack Block Kit limits for one message. |
|
|
74
|
+
| https URLs only | `LinkButton.url`, `Image.url` and `Card.imageUrl` must start with `https:`. The engine refuses `http:`, `javascript:`, `data:` and `file:` URLs. |
|
|
75
|
+
|
|
76
|
+
## Buttons
|
|
77
|
+
|
|
78
|
+
A `Button` needs `UI_SPEC_ACTIONS_ENABLED=true`. When that flag is off, the engine refuses a spec with a `Button`. Use `LinkButton` instead.
|
|
79
|
+
|
|
80
|
+
When the flag is on, each `Button.props.id` matches `^[a-z][a-z0-9_]{0,39}$` and names a key of `uiSpec.actions`. Each action is `{ "kind": "follow_up", "prompt": "<at most 4000 characters>" }`.
|
|
81
|
+
|
|
82
|
+
## Which card a Slack thread shows
|
|
83
|
+
|
|
84
|
+
A Slack card shows only the spec of its own task.
|
|
85
|
+
|
|
86
|
+
- A worker's spec shows on the worker's own task (session view, task page). It does not show on the lead's Slack ask card.
|
|
87
|
+
- Lead rule: when a worker returns a spec that the requester must see, send that spec again in your own `uiSpec` when you complete the Slack ask.
|
|
88
|
+
|
|
89
|
+
## Example: a small card
|
|
90
|
+
|
|
91
|
+
A KPI, a table and a link button.
|
|
92
|
+
|
|
93
|
+
```json
|
|
94
|
+
{"spec":{"root":"c","elements":{
|
|
95
|
+
"c":{"type":"Card","props":{"title":"Weekly deploys"},"children":["f","t","a"]},
|
|
96
|
+
"f":{"type":"Fields","props":{},"children":["k"]},
|
|
97
|
+
"k":{"type":"Field","props":{"label":"Deploys","value":"1,284"},"children":[]},
|
|
98
|
+
"t":{"type":"Table","props":{"headers":["Service","Deploys"],"rows":[["api",812],["ui",472]]},"children":[]},
|
|
99
|
+
"a":{"type":"Actions","props":{},"children":["l"]},
|
|
100
|
+
"l":{"type":"LinkButton","props":{"label":"Open dashboard","url":"https://example.com/deploys"},"children":[]}}}}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Example: a dashboard card
|
|
104
|
+
|
|
105
|
+
KPIs, 2 charts, a table and 2 rows of link buttons. The 3rd share ("Revenue by plan") is a bold `Text`, not a 3rd chart, because of the 2-chart cap.
|
|
106
|
+
|
|
107
|
+
```json
|
|
108
|
+
{"spec":{"root":"c","elements":{
|
|
109
|
+
"c":{"type":"Card","props":{"title":"Q3 revenue at a glance"},"children":["a1","f","ch1","ch2","t1","tb","a2","src"]},
|
|
110
|
+
"a1":{"type":"Actions","props":{},"children":["view"]},
|
|
111
|
+
"view":{"type":"LinkButton","props":{"label":"View report","url":"https://example.com/q3"},"children":[]},
|
|
112
|
+
"f":{"type":"Fields","props":{},"children":["f1","f2","f3","f4","f5","f6"]},
|
|
113
|
+
"f1":{"type":"Field","props":{"label":"Revenue","value":"$4.2M (+18%)"},"children":[]},
|
|
114
|
+
"f2":{"type":"Field","props":{"label":"New customers","value":"64"},"children":[]},
|
|
115
|
+
"f3":{"type":"Field","props":{"label":"ARR","value":"$16.8M (+12%)"},"children":[]},
|
|
116
|
+
"f4":{"type":"Field","props":{"label":"Avg deal","value":"$65.6K"},"children":[]},
|
|
117
|
+
"f5":{"type":"Field","props":{"label":"Net retention","value":"118%"},"children":[]},
|
|
118
|
+
"f6":{"type":"Field","props":{"label":"Win rate","value":"31%"},"children":[]},
|
|
119
|
+
"ch1":{"type":"Chart","props":{"title":"Monthly revenue (2026, USD M)","chart":{"type":"line","categories":["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep"],"series":[{"name":"Revenue","values":[1.02,1.08,1.15,1.2,1.26,1.31,1.38,1.45,1.52]}]}},"children":[]},
|
|
120
|
+
"ch2":{"type":"Chart","props":{"title":"Revenue by region (Q3, USD M)","chart":{"type":"bar","categories":["NA","EMEA","APAC","LATAM"],"series":[{"name":"Revenue","values":[1.7,1.3,0.8,0.4]}]}},"children":[]},
|
|
121
|
+
"t1":{"type":"Text","props":{"content":"Revenue by plan: Enterprise 52%, Team 31%, Self-serve 17%","style":"bold"},"children":[]},
|
|
122
|
+
"tb":{"type":"Table","props":{"headers":["Account","Region","Revenue","QoQ"],"rows":[["Halcyon Labs","NA","$412K","+22%"],["Brightline","EMEA","$356K","+31%"],["Kestrel Health","EMEA","$298K","+27%"],["Meridian Freight","APAC","$241K","+9%"]],"align":["left","left","right","right"],"caption":"Top accounts this quarter"},"children":[]},
|
|
123
|
+
"a2":{"type":"Actions","props":{},"children":["open","csv"]},
|
|
124
|
+
"open":{"type":"LinkButton","props":{"label":"Open dashboard","url":"https://example.com/dashboard"},"children":[]},
|
|
125
|
+
"csv":{"type":"LinkButton","props":{"label":"Export CSV","url":"https://example.com/q3.csv"},"children":[]},
|
|
126
|
+
"src":{"type":"Text","props":{"content":"Source: billing warehouse · Updated 2:41 PM","style":"muted"},"children":[]}}}}
|
|
127
|
+
```
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
ACPAdapter2
|
|
3
|
-
} from "./cli-pz1c00aa.js";
|
|
4
|
-
import"./cli-6dp0jkfj.js";
|
|
5
|
-
import"./cli-eepnpee7.js";
|
|
6
|
-
import"./cli-cw7mc1je.js";
|
|
7
|
-
import"./cli-8x8y70av.js";
|
|
8
|
-
import"./cli-x40a0w9j.js";
|
|
9
|
-
import"./cli-kmvcm34h.js";
|
|
10
|
-
import"./cli-0726awxw.js";
|
|
11
|
-
import"./cli-zg3z63x3.js";
|
|
12
|
-
import"./cli-js8zrfyg.js";
|
|
13
|
-
import"./cli-5gpqgs8b.js";
|
|
14
|
-
export {
|
|
15
|
-
ACPAdapter2 as ACPAdapter
|
|
16
|
-
};
|