@desplega.ai/agent-swarm 2.12.0 → 2.13.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-xtj40wd8.js +17 -0
- package/dist/{acp-targets-311gcyvw.js → acp-targets-n7vm5atw.js} +10 -9
- package/dist/{actions-c4chgxp6.js → actions-hq6wp9xv.js} +28 -27
- package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-y0qc1rdd.js} +4 -4
- package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-1qqs6h91.js} +3 -3
- package/dist/{app-hn5fftf5.js → app-7m4z44rv.js} +10 -8
- package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-8sr41gjx.js} +11 -10
- package/dist/{assistant-cpjgpjvp.js → assistant-hkczwfv6.js} +29 -28
- package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-8025snev.js} +1 -1
- package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-15m87nr1.js} +5 -2
- package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-4bbpxjh1.js} +1 -1
- package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-eajr97e9.js} +2 -2
- package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-9cwy39jx.js} +4 -4
- package/dist/{boxd-68n75y1s.js → boxd-hr8rsxzq.js} +1 -1
- package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-g61wa4rt.js} +9 -8
- package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-znkk0prm.js} +4 -4
- package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-f1wndkr2.js} +7 -7
- package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-687xzf21.js} +20763 -19380
- package/dist/{cli-ya3kf4gs.js → cli-04103ryh.js} +1 -1
- package/dist/{cli-55tc8cj4.js → cli-0a336ze7.js} +5 -5
- package/dist/{cli-q8tc22bj.js → cli-0fx95c06.js} +5 -5
- package/dist/{cli-mq2fbgva.js → cli-0m77n7ej.js} +3 -3
- package/dist/{cli-7yn42w6m.js → cli-0xwb7zpt.js} +2 -2
- package/dist/{cli-mcymtvwn.js → cli-13t0smbk.js} +1000 -28
- package/dist/{cli-c7j31hq9.js → cli-1b5axkt1.js} +4 -4
- package/dist/{cli-yegz2g06.js → cli-1carhg8g.js} +4 -4
- package/dist/{cli-j5gtytvg.js → cli-1dr5at77.js} +15 -12
- package/dist/cli-2v4xxnx2.js +148 -0
- package/dist/{cli-sv2r3bw8.js → cli-32xndx6b.js} +7 -7
- package/dist/{cli-h70a2mxy.js → cli-3m8vqehw.js} +53 -13
- package/dist/{cli-ercwc8xn.js → cli-3mf04tkh.js} +1 -1
- package/dist/{cli-52nfye5j.js → cli-3zyme1wt.js} +24 -16
- package/dist/{cli-s6zk31gr.js → cli-43dsqhcp.js} +4 -4
- package/dist/{cli-b93d81yg.js → cli-4h90xaet.js} +2 -2
- package/dist/{cli-5tg94mdw.js → cli-4mj5g29m.js} +9 -12
- package/dist/{cli-47hz21se.js → cli-4tbvndmm.js} +4 -5
- package/dist/{cli-r0mz92by.js → cli-50whymxq.js} +2 -2
- package/dist/{cli-js10kdk7.js → cli-5basv0e7.js} +19 -5
- package/dist/{cli-krbcr00p.js → cli-5v6b2am8.js} +59 -5
- package/dist/{cli-en6dmkxd.js → cli-6r1dwegd.js} +3 -3
- package/dist/{cli-9qe5y107.js → cli-7ewre3dm.js} +15 -6
- package/dist/{cli-n3qe7tyr.js → cli-84xtgbn6.js} +35 -2
- package/dist/{cli-xm34qj8m.js → cli-8cmjkbvj.js} +2 -2
- package/dist/{cli-2m6yaq6b.js → cli-8fj8yfmk.js} +1 -1
- package/dist/{cli-nja15knq.js → cli-8rbkw18r.js} +3 -3
- package/dist/{cli-x05p2d05.js → cli-9tevdxyf.js} +1 -1
- package/dist/{cli-hhc47ack.js → cli-9xx36trj.js} +4 -4
- package/dist/{cli-39qm0rtm.js → cli-a8ts6x1n.js} +29 -150
- package/dist/{cli-bp6k9acz.js → cli-aebswqmz.js} +18 -18
- package/dist/{cli-ex1y88j3.js → cli-at67kvnp.js} +1 -1
- package/dist/{cli-q2dywc8h.js → cli-bjmq14k9.js} +4 -4
- package/dist/{cli-v9ya390t.js → cli-byxsctca.js} +12 -12
- package/dist/{cli-bz97ff9n.js → cli-c0tyzt73.js} +152 -12
- package/dist/{cli-fyaq4zdv.js → cli-c8kqmzzf.js} +9 -9
- package/dist/{cli-t75xngj1.js → cli-cd9acnvd.js} +12 -12
- package/dist/{cli-eqq0hwvx.js → cli-cmgdptmx.js} +3 -3
- package/dist/{cli-r14ac1y0.js → cli-cn6fpa1p.js} +1 -1
- package/dist/{cli-0k1a0sde.js → cli-cp0m07wb.js} +10 -10
- package/dist/{cli-3p288654.js → cli-cpkxh68d.js} +2 -2
- package/dist/{cli-fxd1mwtr.js → cli-cqxwjb93.js} +2 -2
- package/dist/{cli-8hp56wat.js → cli-d2epqm0y.js} +1 -1
- package/dist/{cli-73q4g5nx.js → cli-dd57p1gd.js} +21 -21
- package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
- package/dist/{cli-wvjqaqcp.js → cli-fn8aj7gb.js} +1330 -249
- package/dist/{cli-bpje8n65.js → cli-fp65jdp2.js} +31 -6
- package/dist/{cli-0pp1yjg2.js → cli-gedf48yw.js} +11 -11
- package/dist/{cli-m5qtmrbc.js → cli-gq6qhmrr.js} +2 -2
- package/dist/{cli-5x03v6en.js → cli-grcc2h2g.js} +8 -8
- package/dist/{cli-01tvvtad.js → cli-h03j6je3.js} +4 -4
- package/dist/{cli-mbwmqb5w.js → cli-h0ewec3d.js} +1 -1
- package/dist/{cli-12vek61e.js → cli-h9bejmkf.js} +535 -146
- package/dist/{cli-gfy6hbd9.js → cli-hs3mqswp.js} +18 -11
- package/dist/{cli-tdk7jtka.js → cli-hv3820ez.js} +1 -1
- package/dist/{cli-pqfecppn.js → cli-je587f74.js} +1 -1
- package/dist/{cli-cjqyse9q.js → cli-jhtvt7gn.js} +3 -3
- package/dist/{cli-dkvtfgn4.js → cli-mmw2sjaf.js} +76 -17
- package/dist/{cli-2z2c4k6q.js → cli-mwxez0pz.js} +22 -0
- package/dist/{cli-yfpc6qy9.js → cli-nk8swfpx.js} +47 -16
- package/dist/{cli-eq4kew31.js → cli-p7g7wd9n.js} +26 -13
- package/dist/{cli-bhgrhedp.js → cli-q8aq48v1.js} +1 -1
- package/dist/{cli-dd2k2mcd.js → cli-qn79645p.js} +1 -1
- package/dist/{cli-ma9ys8rt.js → cli-qx1dwrr5.js} +7 -4
- package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
- package/dist/{cli-agjbj5x0.js → cli-s6fhqbz1.js} +38 -20
- package/dist/{cli-kwr5qv5g.js → cli-sfajkbd7.js} +2 -2
- package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
- package/dist/{cli-e8n0hdzd.js → cli-snypfjgj.js} +1 -1
- package/dist/{cli-n8f0fs3c.js → cli-t25rq8mg.js} +11 -11
- package/dist/{cli-72yms3ey.js → cli-t90k0phh.js} +201 -21
- package/dist/{cli-xf4z5bdn.js → cli-tzzas8rb.js} +4 -4
- package/dist/{cli-rtmqzat7.js → cli-vdfngx2g.js} +2 -2
- package/dist/{cli-9w8712tq.js → cli-vr4eyq6p.js} +43 -14
- package/dist/{cli-z4f346g5.js → cli-vx9acp12.js} +1 -1
- package/dist/{cli-2amwhyv2.js → cli-w24f3j49.js} +13 -11
- package/dist/cli-w41bvvms.js +148 -0
- package/dist/{cli-04zc3f7b.js → cli-w6c6dj91.js} +1 -1
- package/dist/{cli-fy4gb74g.js → cli-x5yb8zc8.js} +2 -2
- package/dist/{cli-2tw284hj.js → cli-xhkek467.js} +3 -3
- package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
- package/dist/{cli-hbvgzjq4.js → cli-y6qqbpwc.js} +3 -3
- package/dist/{cli-7wy8gbwb.js → cli-ya1cj689.js} +1 -1
- package/dist/{cli-1htmtqc2.js → cli-yeh3g1q6.js} +620 -95
- package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
- package/dist/{cli-k5jx8jya.js → cli-z6m6xzxt.js} +2 -2
- package/dist/{cli-pe3yxedk.js → cli-zaate0rd.js} +3 -3
- package/dist/{cli-n85m2wkq.js → cli-zkbz8m2q.js} +3 -2
- package/dist/{cli-e3ahxq5y.js → cli-zvpkrgsc.js} +6 -6
- package/dist/cli.js +30 -28
- package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-ysfg6ty3.js} +8 -8
- package/dist/{codex-hook-aqtj17yr.js → codex-hook-c0nvm30r.js} +73 -2
- package/dist/{codex-login-1ven7yje.js → codex-login-ven5cz5j.js} +1 -1
- package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-823scr6g.js} +9 -9
- package/dist/{commands-tsv2vx5b.js → commands-5rbm07fz.js} +3 -3
- package/dist/{controller-ye4sdwsy.js → controller-wn3vd217.js} +4 -4
- package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-34jzhfft.js} +29 -28
- package/dist/core-kdehq26g.js +42 -0
- package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-w1681kp1.js} +2 -2
- package/dist/{db-g111qn9j.js → db-6bkgbfwk.js} +3 -3
- package/dist/{db-3r1fyr2n.js → db-hcj16x7z.js} +4 -2
- package/dist/{devin-adapter-t8d86q9x.js → devin-adapter-fs90ab4v.js} +1 -1
- package/dist/{dispatcher-4q8s0mx8.js → dispatcher-jgjqrfzv.js} +28 -25
- package/dist/{docker-1b41eysj.js → docker-1h33jvh9.js} +2 -2
- package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-g9yqv09y.js} +2 -2
- package/dist/{e2b-xm60c8ad.js → e2b-jnk0yeva.js} +2 -2
- package/dist/{e2b-ew8c5j5v.js → e2b-y7e5kmzf.js} +2 -2
- package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-w17nsny6.js} +1 -1
- package/dist/{embedding-space-kcdn52vz.js → embedding-space-v06fwy7b.js} +6 -6
- package/dist/{embeddings-jnzcd91a.js → embeddings-g50dxea4.js} +1 -1
- package/dist/{event-bus-v4ywhc2p.js → event-bus-08t2b4y2.js} +1 -1
- package/dist/{execute-74amghty.js → execute-1n36haw1.js} +1 -1
- package/dist/{external-channel-v9zgxnxz.js → external-channel-43tv8pg6.js} +2 -2
- package/dist/fx-adapter-bvh05t4a.js +20 -0
- package/dist/grok-adapter-my5j8mdf.js +20 -0
- package/dist/handlers-wyymeeqh.js +41 -0
- package/dist/heartbeat-sf3nk937.js +50 -0
- package/dist/{hook-p5reemds.js → hook-dqph1e05.js} +77 -18
- package/dist/{hook-k1h73zd7.js → hook-m1m9dm6w.js} +6 -5
- package/dist/{http-ms1z5xxy.js → http-w0th1cz9.js} +888 -226
- package/dist/index-22khdtby.js +44 -0
- package/dist/{index-76zzxtzf.js → index-c0e8en64.js} +1 -1
- package/dist/{index-620y7jzq.js → index-e8pz8qdg.js} +3 -3
- package/dist/{index-8p0j4h4j.js → index-ez823q84.js} +94 -89
- package/dist/{index-fbkqhvvj.js → index-ffba0z8q.js} +217 -165
- package/dist/{index-gjn6qfgn.js → index-gkpfgpg7.js} +1 -1
- package/dist/{index-4k7m5dgj.js → index-k8ajc0g0.js} +143 -103
- package/dist/index-np0582ac.js +40 -0
- package/dist/{index-kn63q1gr.js → index-pb03vans.js} +33 -32
- package/dist/index-vgkrj1jt.js +39 -0
- package/dist/{index-pe3d8jfy.js → index-whysn1wf.js} +1 -1
- package/dist/{index-0h6qd4p1.js → index-y4vd4mhn.js} +3 -4
- package/dist/{k8s-fy8hbhkg.js → k8s-8326q0rq.js} +2 -2
- package/dist/{keepalive-031js8jz.js → keepalive-2v06q2e8.js} +5 -4
- package/dist/lead-55z813ng.js +79 -0
- package/dist/{maintenance-sq9v3qx9.js → maintenance-vx7vjhhy.js} +1 -1
- package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-g06k4bza.js} +4 -3
- package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-3dzdq4fm.js} +7 -7
- package/dist/{onboard-p25yhh7t.js → onboard-232pazny.js} +4 -4
- package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-t0paqbh8.js} +8 -7
- package/dist/{otel-impl-ff1gf20m.js → otel-impl-kmpkyp4y.js} +2 -2
- package/dist/{pending-hxj5yatb.js → pending-x0z3vx1x.js} +27 -26
- package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-7pmypn6d.js} +93 -22
- package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-ytjmtyd7.js} +2 -2
- package/dist/{rbac-roles-84aw10nz.js → rbac-roles-fgm5mxr2.js} +3 -3
- package/dist/{rbac-roles-hz74vckp.js → rbac-roles-xyaxekh3.js} +7 -4
- package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
- package/dist/{render-v2-nrdkg9gf.js → render-v2-ws972g4r.js} +12 -8
- package/dist/{resume-s6ey36rh.js → resume-m6mjzhkp.js} +13 -12
- package/dist/{runtime-x0b4pyam.js → runtime-zzpc0c8a.js} +1 -1
- package/dist/{session-access-xv49tk14.js → session-access-vp35xs91.js} +5 -4
- package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-p73e8zbe.js} +3 -3
- package/dist/{setup-mj0krk1p.js → setup-r4kd7rxg.js} +1 -1
- package/dist/thread-buffer-cm2nzq6t.js +42 -0
- package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-07h2tbs2.js} +2 -2
- package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-96vg9rpe.js} +3 -3
- package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-vgn3f2x4.js} +3 -3
- package/dist/{work-objects-pydhzast.js → work-objects-74hbcx3e.js} +31 -29
- package/dist/worker-5pn2vzx6.js +79 -0
- package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-ezavwn5d.js} +26 -25
- package/dist/{x-3dtaf2r9.js → x-asbrnafg.js} +2 -2
- package/dist/xlsx-9acfmxr1.js +31534 -0
- package/openapi.json +2816 -1464
- package/package.json +13 -11
- package/src/agentmail/handlers.ts +26 -19
- package/src/apps/catalog.generated.json +757 -0
- package/src/apps/definition.ts +24 -7
- package/src/apps/page-validator.ts +225 -3
- package/src/apps/row-store.ts +37 -14
- package/src/azure-devops/handlers.ts +2 -0
- package/src/be/audit-user.ts +46 -6
- package/src/be/db/kv-windows.ts +22 -0
- package/src/be/db/session-moves.ts +3 -3
- package/src/be/db/session-tree.ts +52 -5
- package/src/be/db/skill-audit.ts +17 -0
- package/src/be/db/tasks/write.ts +18 -3
- package/src/be/db.ts +152 -33
- package/src/be/extensions/assets.ts +11 -7
- package/src/be/mcp-proxy.ts +5 -4
- package/src/be/memory/demotion-evidence.ts +2 -2
- package/src/be/memory/providers/sqlite-store.ts +151 -18
- package/src/be/memory/search-read-worker.ts +60 -0
- package/src/be/memory/search-reader.ts +223 -0
- package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
- package/src/be/migrations/338_audit_agent_columns.sql +30 -0
- package/src/be/migrations/339_deferred_event_waits.sql +26 -0
- package/src/be/migrations/340_api_key_spend_cap.sql +5 -0
- package/src/be/model-tier-resolution.ts +18 -1
- package/src/be/multi-runtime.ts +17 -0
- package/src/be/primitives/object-embed.ts +250 -0
- package/src/be/primitives/objects.ts +29 -9
- package/src/be/primitives/sheets/service.ts +138 -6
- package/src/be/primitives/sheets/xlsx.ts +367 -0
- package/src/be/rbac-roles.ts +3 -0
- package/src/be/repo-checked-update.ts +4 -4
- package/src/be/repo-merge-policy.ts +26 -9
- package/src/be/schedules/validate.ts +26 -0
- package/src/be/scripts/boot-reembed.ts +6 -0
- package/src/be/scripts/db.ts +17 -5
- package/src/be/scripts/embeddings.ts +6 -0
- package/src/be/scripts/typecheck.ts +43 -2
- package/src/be/seed/schedules-seeder.ts +9 -1
- package/src/be/seed/workflows-seeder.ts +9 -1
- package/src/be/seed-scripts/index.ts +2 -0
- package/src/be/seed-skills/index.ts +12 -0
- package/src/be/swarm-config-guard.ts +5 -0
- package/src/be/unmapped-identities.ts +95 -1
- package/src/bitbucket/handlers.ts +2 -0
- package/src/commands/credential-outcome-report.ts +5 -2
- package/src/commands/onboard/agent-fs-version.ts +1 -1
- package/src/commands/provider-credentials.ts +19 -0
- package/src/commands/provider-error-class.ts +4 -1
- package/src/commands/rate-limit-outcome.ts +48 -3
- package/src/commands/runner.ts +113 -55
- package/src/commands/worktree-reaper.ts +600 -0
- package/src/event-waits/github.ts +43 -0
- package/src/event-waits/index.ts +29 -0
- package/src/event-waits/types.ts +51 -0
- package/src/extensions/contract-types.generated.ts +1 -1
- package/src/extensions/dispatcher.ts +9 -0
- package/src/fs/agent-fs-provider.ts +4 -1
- package/src/github/handlers.ts +3 -1
- package/src/github/pull-request-state.ts +34 -0
- package/src/gitlab/handlers.ts +12 -7
- package/src/hooks/codex-hook.ts +99 -1
- package/src/hooks/hook.ts +85 -11
- package/src/hooks/native-tool-hooks.ts +245 -0
- package/src/http/agents.ts +4 -0
- package/src/http/all-routes.ts +1 -0
- package/src/http/api-keys.ts +27 -3
- package/src/http/assets.ts +4 -3
- package/src/http/comb.ts +2 -2
- package/src/http/favorite-owner.ts +2 -2
- package/src/http/favorites.ts +3 -2
- package/src/http/fs.ts +13 -4
- package/src/http/index.ts +2 -0
- package/src/http/mcp-bridge.ts +4 -0
- package/src/http/objects.ts +265 -0
- package/src/http/pages-public.ts +40 -4
- package/src/http/pages.ts +3 -3
- package/src/http/poll.ts +43 -12
- package/src/http/pool-keys.ts +21 -2
- package/src/http/repos.ts +7 -6
- package/src/http/schedules.ts +38 -9
- package/src/http/script-connections.ts +14 -6
- package/src/http/script-runs.ts +12 -3
- package/src/http/scripts.ts +9 -0
- package/src/http/sessions.ts +30 -12
- package/src/http/skills.ts +17 -0
- package/src/http/task-requester.ts +2 -2
- package/src/http/tasks.ts +18 -12
- package/src/http/tool-hooks.ts +24 -2
- package/src/http/trackers/authorize-gate.ts +2 -2
- package/src/http/users.ts +136 -1
- package/src/http/workflow-events.ts +13 -0
- package/src/http/workflows.ts +21 -11
- package/src/linear/sync.ts +3 -1
- package/src/mcp-client/http-client.ts +3 -1
- package/src/oauth/identity-capture.ts +6 -1
- package/src/oauth/mcp-wrapper.ts +10 -3
- package/src/oauth/wrapper.ts +15 -3
- package/src/prompts/base-prompt.ts +35 -13
- package/src/prompts/session-templates.ts +26 -0
- package/src/providers/acp-targets.ts +2 -2
- package/src/providers/amp-adapter.ts +1 -1
- package/src/providers/dsh-adapter.ts +1 -1
- package/src/providers/opencode-adapter.ts +1 -0
- package/src/providers/opencode-swarm-plugin.ts +50 -1
- package/src/providers/pi-mono-adapter.ts +143 -11
- package/src/providers/pi-mono-extension.ts +69 -0
- package/src/providers/runtime-dependencies.ts +1 -1
- package/src/rbac/legacy-policy.ts +5 -0
- package/src/rbac/permissions.ts +16 -1
- package/src/scheduler/deferred-task-waits.ts +170 -13
- package/src/scripts-runtime/executors/types.ts +5 -0
- package/src/scripts-runtime/loader.ts +8 -0
- package/src/scripts-runtime/mcp-client.ts +4 -0
- package/src/scripts-runtime/sdk-allowlist.ts +14 -1
- package/src/scripts-runtime/swarm-config.ts +8 -0
- package/src/scripts-runtime/swarm-sdk.ts +4 -0
- package/src/scripts-runtime/types/stdlib.d.ts +47 -4
- package/src/scripts-runtime/types/swarm-extension.d.ts +8 -7
- package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
- package/src/server.ts +4 -0
- package/src/slack/enrich.ts +94 -31
- package/src/slack/handlers.test.ts +55 -2
- package/src/slack/handlers.ts +38 -3
- package/src/slack/render-v2.ts +19 -0
- package/src/slack/session-mirror.ts +208 -0
- package/src/slack/thread-participants.ts +0 -5
- package/src/slack/watcher.ts +3 -0
- package/src/slack/work-objects.test.ts +2 -1
- package/src/slack/work-objects.ts +7 -2
- package/src/tests/agentmail-filters.test.ts +4 -3
- package/src/tests/agents-list-model-display.test.ts +23 -0
- package/src/tests/apps-spike2.test.ts +35 -0
- package/src/tests/audit-agent-person.test.ts +825 -0
- package/src/tests/audit-updated-by.test.ts +19 -12
- package/src/tests/base-prompt.test.ts +1 -0
- package/src/tests/claude-hook-output.test.ts +107 -2
- package/src/tests/claude-managed-setup.test.ts +1 -1
- package/src/tests/codex-adapter.test.ts +6 -6
- package/src/tests/codex-gpt6-release.test.ts +4 -4
- package/src/tests/db-task-read-contract.test.ts +1 -0
- package/src/tests/db-task-write-contract.test.ts +1 -0
- package/src/tests/deploy-guard.test.ts +24 -0
- package/src/tests/dsh-adapter.test.ts +1 -1
- package/src/tests/ensure-token.test.ts +2 -2
- package/src/tests/entrypoint-repo-autoclone-args.test.ts +202 -0
- package/src/tests/extensions-catalog.test.ts +33 -25
- package/src/tests/fake-dns.ts +47 -0
- package/src/tests/fixtures/base-prompt-baseline.json +12 -12
- package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
- package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
- package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
- package/src/tests/kv-storage.test.ts +3 -0
- package/src/tests/latest-model-report.test.ts +138 -0
- package/src/tests/mcp-oauth-dcr-reuse.test.ts +5 -2
- package/src/tests/mcp-oauth-ensure-token.test.ts +3 -2
- package/src/tests/mcp-oauth-manual-client.test.ts +6 -1
- package/src/tests/mcp-oauth-wrapper.test.ts +20 -4
- package/src/tests/mcp-outbound-fetch-guard.test.ts +169 -0
- package/src/tests/mcp-server-ssrf.test.ts +2 -0
- package/src/tests/memory-search-reader.test.ts +258 -0
- package/src/tests/memory-search-stall.test.ts +202 -20
- package/src/tests/model-control.test.ts +4 -4
- package/src/tests/model-tier-resolution.test.ts +2 -2
- package/src/tests/multi-runtime-registration.test.ts +8 -2
- package/src/tests/native-tool-hooks.test.ts +188 -0
- package/src/tests/oauth-connection-fetch-guard.test.ts +162 -0
- package/src/tests/oauth-token-endpoint-fetch-guard.test.ts +121 -0
- package/src/tests/oauth-wrapper.test.ts +1 -2
- package/src/tests/opencode-swarm-plugin.test.ts +6 -1
- package/src/tests/pages-head-v2.test.ts +2 -1
- package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
- package/src/tests/poll-probe-readonly.test.ts +108 -0
- package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
- package/src/tests/prompt-template-session.test.ts +3 -2
- package/src/tests/rbac-roles.test.ts +3 -0
- package/src/tests/script-connections-http.test.ts +8 -3
- package/src/tests/script-connections.test.ts +6 -0
- package/src/tests/seed-model-profiles.test.ts +1 -1
- package/src/tests/sessions-tree.test.ts +10 -2
- package/src/tests/slack-thread-participants.test.ts +77 -4
- package/src/tests/spend-cap-credentials.test.ts +34 -0
- package/src/tests/spend-cap-outcome.test.ts +67 -0
- package/src/tests/subscription-first.test.ts +119 -0
- package/src/tests/tool-registrar-no-input.test.ts +1 -0
- package/src/tests/worktree-reaper.test.ts +424 -0
- package/src/tools/defer-task.ts +154 -12
- package/src/tools/get-task-details.ts +247 -5
- package/src/tools/objects.ts +10 -5
- package/src/tools/repos/update-repo.ts +6 -6
- package/src/tools/schedules/create-schedule.ts +1 -0
- package/src/tools/schedules/list-schedules.ts +3 -0
- package/src/tools/schedules/patch-schedule.ts +38 -4
- package/src/tools/schedules/update-schedule.ts +40 -5
- package/src/tools/sheets.ts +66 -0
- package/src/tools/skills/skill-create.ts +6 -0
- package/src/tools/skills/skill-install-remote.ts +6 -0
- package/src/tools/skills/skill-sync-remote.ts +9 -0
- package/src/tools/skills/skill-update.ts +9 -1
- package/src/tools/tool-config.ts +3 -1
- package/src/tools/utils.ts +15 -0
- package/src/tools/workflows/create-workflow.ts +9 -4
- package/src/tools/workflows/patch-workflow-node.ts +1 -1
- package/src/tools/workflows/patch-workflow.ts +5 -2
- package/src/tools/workflows/update-workflow.ts +13 -7
- package/src/types.ts +96 -12
- package/src/utils/credentials.ts +36 -1
- package/src/utils/egress-guard.ts +40 -10
- package/src/utils/error-tracker.ts +17 -0
- package/src/workflows/input.ts +12 -5
- package/src/workflows/patch-definition.ts +13 -5
- package/src/workflows/triggers.ts +11 -6
- package/src/workflows/version.ts +7 -1
- package/templates/skills/apps/SKILL.md +191 -2
- package/templates/skills/apps/content.md +191 -2
- package/templates/skills/boards-and-sheets/config.json +14 -0
- package/templates/skills/boards-and-sheets/content.md +174 -0
- package/templates/skills/pages/content.md +11 -0
- package/templates/skills/swarm-docs/content.md +11 -0
- package/templates/skills/swarm-scripts/SKILL.md +1 -0
- package/templates/skills/swarm-scripts/content.md +1 -0
- package/templates/workflows/ralph-loop/content.md +6 -6
- package/dist/acp-adapter-11m13kx4.js +0 -16
- package/dist/cli-pr0eze3x.js +0 -149
- package/dist/core-dxcy02sc.js +0 -41
- package/dist/fx-adapter-0ar6pqm3.js +0 -19
- package/dist/grok-adapter-t6m74fb1.js +0 -19
- package/dist/handlers-9kwcrc4k.js +0 -38
- package/dist/heartbeat-p8pk1msj.js +0 -49
- package/dist/index-23cdfzr6.js +0 -39
- package/dist/index-g7kkjs5b.js +0 -38
- package/dist/index-stk36pa5.js +0 -43
- package/dist/lead-mfggjtfk.js +0 -77
- package/dist/thread-buffer-temgaqsy.js +0 -41
- package/dist/worker-efcemc22.js +0 -77
- /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
|
@@ -38,9 +38,10 @@ export async function patchWorkflowDefinition(options: {
|
|
|
38
38
|
snapshotOptional?: boolean;
|
|
39
39
|
updates?: Omit<Parameters<typeof updateWorkflow>[1], "definition">;
|
|
40
40
|
/**
|
|
41
|
-
* False when the caller lacks `config.read.secrets`. A workflow whose
|
|
42
|
-
*
|
|
43
|
-
* patch, since a node edit decides
|
|
41
|
+
* False when the caller lacks `config.read.secrets`. A workflow whose input
|
|
42
|
+
* holds `${ENV_VAR}` / `secret.NAME` references, stored or rendered from its
|
|
43
|
+
* (new) params, then refuses the patch, since a node or params edit decides
|
|
44
|
+
* where those resolved values go.
|
|
44
45
|
*/
|
|
45
46
|
serverRefInputAllowed?: boolean;
|
|
46
47
|
}): Promise<PatchWorkflowDefinitionResult> {
|
|
@@ -50,7 +51,7 @@ export async function patchWorkflowDefinition(options: {
|
|
|
50
51
|
if (!existing) return { ok: false, reason: "not_found" };
|
|
51
52
|
|
|
52
53
|
if (options.serverRefInputAllowed === false) {
|
|
53
|
-
const refKeys = serverRefInputKeys(existing.input);
|
|
54
|
+
const refKeys = serverRefInputKeys(existing.input, updates?.params ?? existing.params);
|
|
54
55
|
if (refKeys.length > 0) {
|
|
55
56
|
return { ok: false, reason: "forbidden", errors: [serverRefInputDeniedMessage(refKeys)] };
|
|
56
57
|
}
|
|
@@ -85,7 +86,14 @@ export async function patchWorkflowDefinition(options: {
|
|
|
85
86
|
version = (await snapshotWorkflow(id, snapshotAgentId)).version;
|
|
86
87
|
}
|
|
87
88
|
|
|
88
|
-
|
|
89
|
+
// Every caller is a user-intent write: record the pair for this write
|
|
90
|
+
// (person null = unknown), never a previous writer's person.
|
|
91
|
+
const workflow = await updateWorkflow(id, {
|
|
92
|
+
...updates,
|
|
93
|
+
definition: patchResult.definition,
|
|
94
|
+
updatedBy: updates?.updatedBy ?? null,
|
|
95
|
+
updatedByAgentId: snapshotAgentId ?? null,
|
|
96
|
+
});
|
|
89
97
|
if (!workflow) return { ok: false, reason: "not_found" };
|
|
90
98
|
|
|
91
99
|
return { ok: true, workflow, version, definition: patchResult.definition };
|
|
@@ -136,6 +136,9 @@ export async function verifyWebhookRequest(
|
|
|
136
136
|
case "hmac-sha256":
|
|
137
137
|
isValid = verifyHmacSignature(secret, rawBody, signature);
|
|
138
138
|
break;
|
|
139
|
+
case "hmac-sha1":
|
|
140
|
+
isValid = verifyHmacSignature(secret, rawBody, signature, "sha1");
|
|
141
|
+
break;
|
|
139
142
|
case "timestamped-hmac-sha256":
|
|
140
143
|
isValid = verifyTimestampedHmacSignature(secret, rawBody, signature, {
|
|
141
144
|
timestampKey: verification.timestampKey,
|
|
@@ -354,21 +357,23 @@ export async function handleScheduleTrigger(
|
|
|
354
357
|
}
|
|
355
358
|
|
|
356
359
|
/**
|
|
357
|
-
* Verify HMAC-
|
|
358
|
-
* Supports both
|
|
360
|
+
* Verify an HMAC signature (SHA-256 by default, SHA-1 for senders such as Vercel).
|
|
361
|
+
* Supports both `<algorithm>=<hex>` format and raw hex.
|
|
359
362
|
*/
|
|
360
363
|
export function verifyHmacSignature(
|
|
361
364
|
secret: string,
|
|
362
365
|
body: string,
|
|
363
366
|
providedSignature: string,
|
|
367
|
+
algorithm: "sha256" | "sha1" = "sha256",
|
|
364
368
|
): boolean {
|
|
365
|
-
const hmac = crypto.createHmac(
|
|
369
|
+
const hmac = crypto.createHmac(algorithm, secret);
|
|
366
370
|
hmac.update(body);
|
|
367
371
|
const expectedHex = hmac.digest("hex");
|
|
368
372
|
|
|
369
|
-
// Support "sha256=<hex>" format (GitHub-style)
|
|
370
|
-
const
|
|
371
|
-
|
|
373
|
+
// Support "sha256=<hex>" / "sha1=<hex>" format (GitHub-style)
|
|
374
|
+
const prefix = `${algorithm}=`;
|
|
375
|
+
const normalizedProvided = providedSignature.startsWith(prefix)
|
|
376
|
+
? providedSignature.slice(prefix.length)
|
|
372
377
|
: providedSignature;
|
|
373
378
|
|
|
374
379
|
// Constant-time comparison
|
package/src/workflows/version.ts
CHANGED
|
@@ -95,7 +95,13 @@ export async function snapshotAndUpdateWorkflow(
|
|
|
95
95
|
} else {
|
|
96
96
|
version = await snapshotWorkflow(workflowId, opts.changedByAgentId);
|
|
97
97
|
}
|
|
98
|
-
|
|
98
|
+
// Every caller is a user-intent write: record the pair for this write
|
|
99
|
+
// (person null = unknown), never a previous writer's person.
|
|
100
|
+
const workflow = await updateWorkflow(workflowId, {
|
|
101
|
+
...updates,
|
|
102
|
+
updatedBy: updates.updatedBy ?? null,
|
|
103
|
+
updatedByAgentId: opts.changedByAgentId ?? null,
|
|
104
|
+
});
|
|
99
105
|
return { workflow, version };
|
|
100
106
|
});
|
|
101
107
|
}
|
|
@@ -531,9 +531,9 @@ The sidebar lists pages in definition order and marks the current one. Below 768
|
|
|
531
531
|
|
|
532
532
|
Param `kind` is `string` by default, or `number` / `boolean`; `required` defaults to false. The names `mode`, `apiUrl`, `apiKey`, `email`, and `name` are reserved. `/apps/<id>` renders `defaultPage`; `/apps/<id>/p/<page>?issueId=42` is the shareable deep link for another page. Browser navigation is client-side, so app state and polled data stay warm across page changes.
|
|
533
533
|
|
|
534
|
-
Within each page, `root` names one entry in its non-empty `elements` map. Elements are a flat, single-parent tree: ids are map keys, `children` contains ids (not nested elements), all elements must be reachable from `root`, and cycles, missing children, or shared children are invalid. Element and Form/UI ids are page-local. Element keys are `type`, `props`, `children`, `on`, `visible`, `repeat`, and `watch`; only components with a `default` child slot accept `children` (Stack, Grid, Split, Tabs, Accordion, Container, Card, Section, Drawer, and
|
|
534
|
+
Within each page, `root` names one entry in its non-empty `elements` map. Elements are a flat, single-parent tree: ids are map keys, `children` contains ids (not nested elements), all elements must be reachable from `root`, and cycles, missing children, or shared children are invalid. Element and Form/UI ids are page-local. Element keys are `type`, `props`, `children`, `on`, `visible`, `repeat`, and `watch`; only components with a `default` child slot accept `children` (Stack, Grid, Split, Tabs, Accordion, Container, Card, Section, Drawer, Dialog, and Svg). `watch` maps state paths to an action step or chain. A page may also declare `state`: page-local values read and written at `/local/<name>` (see Low-level primitives).
|
|
535
535
|
|
|
536
|
-
## Component catalog (all
|
|
536
|
+
## Component catalog (all 52)
|
|
537
537
|
|
|
538
538
|
Props reject unknown keys. A `{"$state":"..."}` binding may replace a literal prop value at any depth.
|
|
539
539
|
|
|
@@ -590,6 +590,13 @@ Tones: Badge, Metric and Progress `tone` take `neutral`, `success`, `active`, `e
|
|
|
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
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. |
|
|
593
|
+
| `Input` | none | Low-level text field: `value` (bind two-way with `$bindState` / `$bindItem`), `id` (the `ui.focus` target), `label`, `placeholder`, `type: "text"` or `"password"`, `inputMode`, `autoComplete: "off"` or `"one-time-code"`, `maxLength`, `size: "default"` or `"cell"` (square one-character box), `selectOnFocus`, `disabled`; chains `onInput`, `onPaste`, `onKeyDown:<Key>`; see Low-level primitives. |
|
|
594
|
+
| `Svg` | `width`, `height` on the outer Svg | Vector drawing in `width` x `height` user units, scaled to its container; `label` (accessible name). Children: `Rect`, `Line`, `Path`, `Circle`, `SvgText`, or a nested `Svg` (a group offset by `x`/`y`, the place for `repeat`). |
|
|
595
|
+
| `Rect` | `x`, `y`, `width`, `height` | `rx`, `fill`, `stroke`, `strokeWidth`, `opacity`, `title` (tooltip); only inside an Svg. |
|
|
596
|
+
| `Line` | `x1`, `y1`, `x2`, `y2` | `stroke`, `strokeWidth`, `opacity`, `dashed`; only inside an Svg. |
|
|
597
|
+
| `Path` | `d` | `fill`, `stroke`, `strokeWidth`, `opacity`; `d` holds path commands and numbers only; only inside an Svg. |
|
|
598
|
+
| `Circle` | `cx`, `cy`, `r` | `fill`, `stroke`, `strokeWidth`, `opacity`, `title`; only inside an Svg. |
|
|
599
|
+
| `SvgText` | `x`, `y`, `text` | `anchor: "start", "middle", "end"`, `size`, `weight: "normal"` or `"bold"`, `fill`; only inside an Svg. |
|
|
593
600
|
|
|
594
601
|
Table details:
|
|
595
602
|
|
|
@@ -858,6 +865,7 @@ Valid `$state` roots are:
|
|
|
858
865
|
- `/actions/<declaredAction>/...`
|
|
859
866
|
- `/route/page` for the active page name
|
|
860
867
|
- `/route/params/<declaredParam>` for a param declared on the current page
|
|
868
|
+
- `/local/<name>/...`, where the current page declares `<name>` in its `state`
|
|
861
869
|
|
|
862
870
|
`/route` is mirrored as `{ page, params }`. Only declared params appear. Values are coerced by their declared kind: `number` becomes a number when possible; boolean strings `true`/`1` become true; failed number coercion remains the raw string.
|
|
863
871
|
|
|
@@ -898,6 +906,178 @@ The `studio` page's `SessionThread` with `"sessionKey": { "$state": "/route/para
|
|
|
898
906
|
|
|
899
907
|
A failed step halts its chain: when `app.action`, `app.mutate`, `swarm.sdk` or `swarm.call` fails (a thrown error, a script action that returns `ok: false`, a non-2xx `swarm.call`), the steps after it do not run and the error shows as an error toast. A step's `onError` (`{ set }` or `{ action }`) runs first, and the chain still halts. So a `ui.toast` after a write is a real success message. A `Form`'s failed `app.mutate` shows inline under the fields instead of a toast. A task-backed `app.action` succeeds once the task is created; the task's own failure shows in the page banner and does not halt the chain. A Table bulk action reads each step's own outcome, as before.
|
|
900
908
|
|
|
909
|
+
## Low-level primitives
|
|
910
|
+
|
|
911
|
+
Compose custom widgets (a code input, a timeline, a Gantt chart) from page-local state, a bindable `Input`, three `ui.*` steps, expressions, and `Svg` shapes. No custom component needed.
|
|
912
|
+
|
|
913
|
+
**Page state.** `pages.<page>.state` maps names to initial JSON values. The page reads them at `{ "$state": "/local/<name>/..." }` and only this root is writable. Each page has its own `/local`, even when two pages declare the same name. The values are seeded on first render and survive navigation; patching `pages.<page>.state.<name>` replaces that entry. Reusable elements cannot read or write `/local`.
|
|
914
|
+
|
|
915
|
+
**Input.** `value: { "$bindState": "/local/<name>/..." }` binds two-way; inside a `repeat` over a `/local` list, `{ "$bindItem": "" }` binds the item itself (`"field"` binds a field of it). `$bindState` and `$bindItem` are valid only on `Input.value`. Event chains are props, run by the Input:
|
|
916
|
+
|
|
917
|
+
- `onInput`: after every edit; `{ "$chain": "value" }` is the new text.
|
|
918
|
+
- `onPaste`: instead of the browser paste; `{ "$chain": "text" }` is the clipboard text.
|
|
919
|
+
- `onKeyDown:<Key>`: instead of that key's default. Keys: `Backspace`, `Delete`, `Enter`, `Escape`, `Tab`, `ArrowLeft`, `ArrowRight`, `ArrowUp`, `ArrowDown`, `Home`, `End`.
|
|
920
|
+
|
|
921
|
+
`$state` reads inside these chains resolve at render time. To read the newest value, use `$chain`, or put the chain in a `watch`. A state write inside a `watch` chain re-runs the watch and cancels the steps after it, so make `ui.set` the last step there.
|
|
922
|
+
|
|
923
|
+
**Steps.**
|
|
924
|
+
|
|
925
|
+
- `ui.set`: `{ path, value }` writes `value` to a `/local/...` path. A literal path must name declared state; `path` may be an expression, e.g. `{ "$join": [["/local/otp", { "$index": true }], "/"] }`.
|
|
926
|
+
- `ui.focus`: `{ id, index? }` focuses the `Input` with that literal `id` on this page. Inside a `repeat`, `index` picks the item. A missing target is a no-op.
|
|
927
|
+
- `ui.when`: `{ value, eq? }` continues the chain only when `value` equals `eq` (or is truthy without `eq`); otherwise the rest of the chain is skipped quietly.
|
|
928
|
+
|
|
929
|
+
**Expressions.** An object with one operator key and an operand array, valid in any prop or action param. Operands are literals or bindings (`$state`, `$item`, `$index`, `$chain`, another expression):
|
|
930
|
+
|
|
931
|
+
| Operator | Operands | Result |
|
|
932
|
+
|---|---|---|
|
|
933
|
+
| `$add`, `$mul`, `$min`, `$max` | 1 or more numbers | sum, product, minimum, maximum |
|
|
934
|
+
| `$sub`, `$div` | exactly 2 numbers | difference, quotient |
|
|
935
|
+
| `$split` | text, separator (default `""`), optional limit | array of strings |
|
|
936
|
+
| `$join` | array, separator (default `""`) | text |
|
|
937
|
+
| `$length` | 1 value | length of a text or array (`0` for null) |
|
|
938
|
+
|
|
939
|
+
A non-numeric operand, or a division by zero, yields no value and the attribute is left out.
|
|
940
|
+
|
|
941
|
+
**Svg.** `Svg` draws in `width` x `height` user units. Shape attributes (`x`, `y`, `width`, `height`, `x1`..`y2`, `cx`, `cy`, `r`, `d`) accept expressions, so a bar is `x = 100 + (start - min) * scale`. A nested `Svg` is a group: put `repeat` on it to draw its shapes once per item. Colors are palette tokens (`chart-1`..`chart-5`, `primary`, `success`, `warning`, `error`, `info`, `muted`, `foreground`, `background`, `border`, `none`). The validator rejects unknown attributes, raw colors, a `Path.d` with anything but path commands and numbers, shapes outside an Svg, and non-shape Svg children.
|
|
942
|
+
|
|
943
|
+
### Example: 6-cell code input
|
|
944
|
+
|
|
945
|
+
Typing advances to the next cell, Backspace clears the cell and moves back, pasting a 6-character code fills every cell, and the `watch` submits once all 6 are filled. Replace the `ui.toast` step with an `app.action` to verify the code server-side.
|
|
946
|
+
|
|
947
|
+
```json
|
|
948
|
+
{
|
|
949
|
+
"models": {},
|
|
950
|
+
"defaultPage": "verify",
|
|
951
|
+
"pages": {
|
|
952
|
+
"verify": {
|
|
953
|
+
"title": "Verify",
|
|
954
|
+
"state": { "otp": ["", "", "", "", "", ""], "code": "" },
|
|
955
|
+
"root": "root",
|
|
956
|
+
"elements": {
|
|
957
|
+
"root": {
|
|
958
|
+
"type": "Stack",
|
|
959
|
+
"props": { "gap": "md", "padding": "md" },
|
|
960
|
+
"children": ["heading", "cells", "submitted"],
|
|
961
|
+
"watch": {
|
|
962
|
+
"/local/otp": [
|
|
963
|
+
{ "action": "ui.when", "params": { "value": { "$length": [{ "$join": [{ "$state": "/local/otp" }, ""] }] }, "eq": 6 } },
|
|
964
|
+
{ "action": "ui.toast", "params": { "message": "Code submitted", "tone": "success" } },
|
|
965
|
+
{ "action": "ui.set", "params": { "path": "/local/code", "value": { "$join": [{ "$state": "/local/otp" }, ""] } } }
|
|
966
|
+
]
|
|
967
|
+
}
|
|
968
|
+
},
|
|
969
|
+
"heading": { "type": "Heading", "props": { "text": "Enter the 6-digit code", "level": "h2" } },
|
|
970
|
+
"cells": {
|
|
971
|
+
"type": "Stack",
|
|
972
|
+
"props": { "direction": "row", "gap": "sm" },
|
|
973
|
+
"repeat": { "statePath": "/local/otp" },
|
|
974
|
+
"children": ["cell"]
|
|
975
|
+
},
|
|
976
|
+
"cell": {
|
|
977
|
+
"type": "Input",
|
|
978
|
+
"props": {
|
|
979
|
+
"id": "otp",
|
|
980
|
+
"value": { "$bindItem": "" },
|
|
981
|
+
"size": "cell",
|
|
982
|
+
"maxLength": 1,
|
|
983
|
+
"inputMode": "numeric",
|
|
984
|
+
"autoComplete": "one-time-code",
|
|
985
|
+
"selectOnFocus": true,
|
|
986
|
+
"onInput": [
|
|
987
|
+
{ "action": "ui.when", "params": { "value": { "$length": [{ "$chain": "value" }] }, "eq": 1 } },
|
|
988
|
+
{ "action": "ui.focus", "params": { "id": "otp", "index": { "$min": [{ "$add": [{ "$index": true }, 1] }, 5] } } }
|
|
989
|
+
],
|
|
990
|
+
"onKeyDown:Backspace": [
|
|
991
|
+
{ "action": "ui.set", "params": { "path": { "$join": [["/local/otp", { "$index": true }], "/"] }, "value": "" } },
|
|
992
|
+
{ "action": "ui.focus", "params": { "id": "otp", "index": { "$max": [{ "$sub": [{ "$index": true }, 1] }, 0] } } }
|
|
993
|
+
],
|
|
994
|
+
"onPaste": [
|
|
995
|
+
{ "action": "ui.when", "params": { "value": { "$length": [{ "$chain": "text" }] }, "eq": 6 } },
|
|
996
|
+
{ "action": "ui.set", "params": { "path": "/local/otp", "value": { "$split": [{ "$chain": "text" }, ""] } } },
|
|
997
|
+
{ "action": "ui.focus", "params": { "id": "otp", "index": 5 } }
|
|
998
|
+
]
|
|
999
|
+
}
|
|
1000
|
+
},
|
|
1001
|
+
"submitted": {
|
|
1002
|
+
"type": "Text",
|
|
1003
|
+
"props": { "content": { "$state": "/local/code" }, "tone": "muted" },
|
|
1004
|
+
"visible": { "$state": "/local/code" }
|
|
1005
|
+
}
|
|
1006
|
+
}
|
|
1007
|
+
}
|
|
1008
|
+
}
|
|
1009
|
+
}
|
|
1010
|
+
```
|
|
1011
|
+
|
|
1012
|
+
### Example: Gantt timeline
|
|
1013
|
+
|
|
1014
|
+
Each task is a bar at `x = 100 + (start - min) * scale`, `width = days * scale`, one row per item of a repeated list; the dashed line marks day 12. Bind `repeat.statePath` to `/queries/<q>/data` to draw rows from a query instead.
|
|
1015
|
+
|
|
1016
|
+
```json
|
|
1017
|
+
{
|
|
1018
|
+
"models": {},
|
|
1019
|
+
"defaultPage": "plan",
|
|
1020
|
+
"pages": {
|
|
1021
|
+
"plan": {
|
|
1022
|
+
"title": "Plan",
|
|
1023
|
+
"state": {
|
|
1024
|
+
"axis": { "min": 3, "scale": 24 },
|
|
1025
|
+
"tasks": [
|
|
1026
|
+
{ "name": "Research", "start": 3, "days": 4 },
|
|
1027
|
+
{ "name": "Design", "start": 6, "days": 5 },
|
|
1028
|
+
{ "name": "Build", "start": 10, "days": 8 },
|
|
1029
|
+
{ "name": "QA", "start": 16, "days": 4 },
|
|
1030
|
+
{ "name": "Launch", "start": 20, "days": 2 }
|
|
1031
|
+
]
|
|
1032
|
+
},
|
|
1033
|
+
"root": "card",
|
|
1034
|
+
"elements": {
|
|
1035
|
+
"card": { "type": "Card", "props": { "title": "Launch plan", "description": "Days 3-22" }, "children": ["chart"] },
|
|
1036
|
+
"chart": {
|
|
1037
|
+
"type": "Svg",
|
|
1038
|
+
"props": { "width": 640, "height": 200, "label": "Gantt chart of the launch plan" },
|
|
1039
|
+
"children": ["axis", "today", "rows"]
|
|
1040
|
+
},
|
|
1041
|
+
"axis": { "type": "Line", "props": { "x1": 100, "y1": 190, "x2": 632, "y2": 190, "stroke": "border" } },
|
|
1042
|
+
"today": {
|
|
1043
|
+
"type": "Line",
|
|
1044
|
+
"props": {
|
|
1045
|
+
"x1": { "$add": [100, { "$mul": [{ "$sub": [12, { "$state": "/local/axis/min" }] }, { "$state": "/local/axis/scale" }] }] },
|
|
1046
|
+
"y1": 8,
|
|
1047
|
+
"x2": { "$add": [100, { "$mul": [{ "$sub": [12, { "$state": "/local/axis/min" }] }, { "$state": "/local/axis/scale" }] }] },
|
|
1048
|
+
"y2": 190,
|
|
1049
|
+
"stroke": "error",
|
|
1050
|
+
"dashed": true
|
|
1051
|
+
}
|
|
1052
|
+
},
|
|
1053
|
+
"rows": { "type": "Svg", "props": {}, "repeat": { "statePath": "/local/tasks" }, "children": ["label", "bar"] },
|
|
1054
|
+
"label": {
|
|
1055
|
+
"type": "SvgText",
|
|
1056
|
+
"props": {
|
|
1057
|
+
"x": 0,
|
|
1058
|
+
"y": { "$add": [26, { "$mul": [{ "$index": true }, 34] }] },
|
|
1059
|
+
"text": { "$item": "name" },
|
|
1060
|
+
"size": 13
|
|
1061
|
+
}
|
|
1062
|
+
},
|
|
1063
|
+
"bar": {
|
|
1064
|
+
"type": "Rect",
|
|
1065
|
+
"props": {
|
|
1066
|
+
"x": { "$add": [100, { "$mul": [{ "$sub": [{ "$item": "start" }, { "$state": "/local/axis/min" }] }, { "$state": "/local/axis/scale" }] }] },
|
|
1067
|
+
"y": { "$add": [14, { "$mul": [{ "$index": true }, 34] }] },
|
|
1068
|
+
"width": { "$mul": [{ "$item": "days" }, { "$state": "/local/axis/scale" }] },
|
|
1069
|
+
"height": 24,
|
|
1070
|
+
"rx": 4,
|
|
1071
|
+
"fill": "chart-2",
|
|
1072
|
+
"title": { "$item": "name" }
|
|
1073
|
+
}
|
|
1074
|
+
}
|
|
1075
|
+
}
|
|
1076
|
+
}
|
|
1077
|
+
}
|
|
1078
|
+
}
|
|
1079
|
+
```
|
|
1080
|
+
|
|
901
1081
|
## Patch semantics
|
|
902
1082
|
|
|
903
1083
|
`app-patch.definition` is RFC 7396 JSON Merge Patch applied to the stored definition:
|
|
@@ -1024,6 +1204,15 @@ Create this with `app-upsert`:
|
|
|
1024
1204
|
|
|
1025
1205
|
The tool returns `{ appId, url: "/apps/<id>" }`. Open that URL to verify the live UI, then continue with the read-patch-validate loop above.
|
|
1026
1206
|
|
|
1207
|
+
## Embed a sheet or board
|
|
1208
|
+
|
|
1209
|
+
`{ "type": "ObjectEmbed", "props": { "objectId": "<object id>" } }` shows a live, editable sheet or board (see the `boards-and-sheets` skill). Optional props: `height` (160-1200), `readOnly`, and for sheets `tab` and `range`. To show the same object on an HTML page instead, use the page snippet, where `${APP_URL}` is the dashboard origin:
|
|
1210
|
+
|
|
1211
|
+
```html
|
|
1212
|
+
<script type="module" src="${APP_URL}/embed/v1/swarm-object.js"></script>
|
|
1213
|
+
<swarm-object object-id="<object id>"></swarm-object>
|
|
1214
|
+
```
|
|
1215
|
+
|
|
1027
1216
|
## View and screenshot a live app
|
|
1028
1217
|
|
|
1029
1218
|
- An app renders at `<dashboard>/apps/<id>`. Two view modes are set by query string: `?mode=full` (full-viewport overlay with a slim header) and `?mode=chromeless` (only the rendered page, the embed surface). `app.navigate` keeps only `?mode`.
|
|
@@ -526,9 +526,9 @@ The sidebar lists pages in definition order and marks the current one. Below 768
|
|
|
526
526
|
|
|
527
527
|
Param `kind` is `string` by default, or `number` / `boolean`; `required` defaults to false. The names `mode`, `apiUrl`, `apiKey`, `email`, and `name` are reserved. `/apps/<id>` renders `defaultPage`; `/apps/<id>/p/<page>?issueId=42` is the shareable deep link for another page. Browser navigation is client-side, so app state and polled data stay warm across page changes.
|
|
528
528
|
|
|
529
|
-
Within each page, `root` names one entry in its non-empty `elements` map. Elements are a flat, single-parent tree: ids are map keys, `children` contains ids (not nested elements), all elements must be reachable from `root`, and cycles, missing children, or shared children are invalid. Element and Form/UI ids are page-local. Element keys are `type`, `props`, `children`, `on`, `visible`, `repeat`, and `watch`; only components with a `default` child slot accept `children` (Stack, Grid, Split, Tabs, Accordion, Container, Card, Section, Drawer, and
|
|
529
|
+
Within each page, `root` names one entry in its non-empty `elements` map. Elements are a flat, single-parent tree: ids are map keys, `children` contains ids (not nested elements), all elements must be reachable from `root`, and cycles, missing children, or shared children are invalid. Element and Form/UI ids are page-local. Element keys are `type`, `props`, `children`, `on`, `visible`, `repeat`, and `watch`; only components with a `default` child slot accept `children` (Stack, Grid, Split, Tabs, Accordion, Container, Card, Section, Drawer, Dialog, and Svg). `watch` maps state paths to an action step or chain. A page may also declare `state`: page-local values read and written at `/local/<name>` (see Low-level primitives).
|
|
530
530
|
|
|
531
|
-
## Component catalog (all
|
|
531
|
+
## Component catalog (all 52)
|
|
532
532
|
|
|
533
533
|
Props reject unknown keys. A `{"$state":"..."}` binding may replace a literal prop value at any depth.
|
|
534
534
|
|
|
@@ -585,6 +585,13 @@ Tones: Badge, Metric and Progress `tone` take `neutral`, `success`, `active`, `e
|
|
|
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
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. |
|
|
588
|
+
| `Input` | none | Low-level text field: `value` (bind two-way with `$bindState` / `$bindItem`), `id` (the `ui.focus` target), `label`, `placeholder`, `type: "text"` or `"password"`, `inputMode`, `autoComplete: "off"` or `"one-time-code"`, `maxLength`, `size: "default"` or `"cell"` (square one-character box), `selectOnFocus`, `disabled`; chains `onInput`, `onPaste`, `onKeyDown:<Key>`; see Low-level primitives. |
|
|
589
|
+
| `Svg` | `width`, `height` on the outer Svg | Vector drawing in `width` x `height` user units, scaled to its container; `label` (accessible name). Children: `Rect`, `Line`, `Path`, `Circle`, `SvgText`, or a nested `Svg` (a group offset by `x`/`y`, the place for `repeat`). |
|
|
590
|
+
| `Rect` | `x`, `y`, `width`, `height` | `rx`, `fill`, `stroke`, `strokeWidth`, `opacity`, `title` (tooltip); only inside an Svg. |
|
|
591
|
+
| `Line` | `x1`, `y1`, `x2`, `y2` | `stroke`, `strokeWidth`, `opacity`, `dashed`; only inside an Svg. |
|
|
592
|
+
| `Path` | `d` | `fill`, `stroke`, `strokeWidth`, `opacity`; `d` holds path commands and numbers only; only inside an Svg. |
|
|
593
|
+
| `Circle` | `cx`, `cy`, `r` | `fill`, `stroke`, `strokeWidth`, `opacity`, `title`; only inside an Svg. |
|
|
594
|
+
| `SvgText` | `x`, `y`, `text` | `anchor: "start", "middle", "end"`, `size`, `weight: "normal"` or `"bold"`, `fill`; only inside an Svg. |
|
|
588
595
|
|
|
589
596
|
Table details:
|
|
590
597
|
|
|
@@ -853,6 +860,7 @@ Valid `$state` roots are:
|
|
|
853
860
|
- `/actions/<declaredAction>/...`
|
|
854
861
|
- `/route/page` for the active page name
|
|
855
862
|
- `/route/params/<declaredParam>` for a param declared on the current page
|
|
863
|
+
- `/local/<name>/...`, where the current page declares `<name>` in its `state`
|
|
856
864
|
|
|
857
865
|
`/route` is mirrored as `{ page, params }`. Only declared params appear. Values are coerced by their declared kind: `number` becomes a number when possible; boolean strings `true`/`1` become true; failed number coercion remains the raw string.
|
|
858
866
|
|
|
@@ -893,6 +901,178 @@ The `studio` page's `SessionThread` with `"sessionKey": { "$state": "/route/para
|
|
|
893
901
|
|
|
894
902
|
A failed step halts its chain: when `app.action`, `app.mutate`, `swarm.sdk` or `swarm.call` fails (a thrown error, a script action that returns `ok: false`, a non-2xx `swarm.call`), the steps after it do not run and the error shows as an error toast. A step's `onError` (`{ set }` or `{ action }`) runs first, and the chain still halts. So a `ui.toast` after a write is a real success message. A `Form`'s failed `app.mutate` shows inline under the fields instead of a toast. A task-backed `app.action` succeeds once the task is created; the task's own failure shows in the page banner and does not halt the chain. A Table bulk action reads each step's own outcome, as before.
|
|
895
903
|
|
|
904
|
+
## Low-level primitives
|
|
905
|
+
|
|
906
|
+
Compose custom widgets (a code input, a timeline, a Gantt chart) from page-local state, a bindable `Input`, three `ui.*` steps, expressions, and `Svg` shapes. No custom component needed.
|
|
907
|
+
|
|
908
|
+
**Page state.** `pages.<page>.state` maps names to initial JSON values. The page reads them at `{ "$state": "/local/<name>/..." }` and only this root is writable. Each page has its own `/local`, even when two pages declare the same name. The values are seeded on first render and survive navigation; patching `pages.<page>.state.<name>` replaces that entry. Reusable elements cannot read or write `/local`.
|
|
909
|
+
|
|
910
|
+
**Input.** `value: { "$bindState": "/local/<name>/..." }` binds two-way; inside a `repeat` over a `/local` list, `{ "$bindItem": "" }` binds the item itself (`"field"` binds a field of it). `$bindState` and `$bindItem` are valid only on `Input.value`. Event chains are props, run by the Input:
|
|
911
|
+
|
|
912
|
+
- `onInput`: after every edit; `{ "$chain": "value" }` is the new text.
|
|
913
|
+
- `onPaste`: instead of the browser paste; `{ "$chain": "text" }` is the clipboard text.
|
|
914
|
+
- `onKeyDown:<Key>`: instead of that key's default. Keys: `Backspace`, `Delete`, `Enter`, `Escape`, `Tab`, `ArrowLeft`, `ArrowRight`, `ArrowUp`, `ArrowDown`, `Home`, `End`.
|
|
915
|
+
|
|
916
|
+
`$state` reads inside these chains resolve at render time. To read the newest value, use `$chain`, or put the chain in a `watch`. A state write inside a `watch` chain re-runs the watch and cancels the steps after it, so make `ui.set` the last step there.
|
|
917
|
+
|
|
918
|
+
**Steps.**
|
|
919
|
+
|
|
920
|
+
- `ui.set`: `{ path, value }` writes `value` to a `/local/...` path. A literal path must name declared state; `path` may be an expression, e.g. `{ "$join": [["/local/otp", { "$index": true }], "/"] }`.
|
|
921
|
+
- `ui.focus`: `{ id, index? }` focuses the `Input` with that literal `id` on this page. Inside a `repeat`, `index` picks the item. A missing target is a no-op.
|
|
922
|
+
- `ui.when`: `{ value, eq? }` continues the chain only when `value` equals `eq` (or is truthy without `eq`); otherwise the rest of the chain is skipped quietly.
|
|
923
|
+
|
|
924
|
+
**Expressions.** An object with one operator key and an operand array, valid in any prop or action param. Operands are literals or bindings (`$state`, `$item`, `$index`, `$chain`, another expression):
|
|
925
|
+
|
|
926
|
+
| Operator | Operands | Result |
|
|
927
|
+
|---|---|---|
|
|
928
|
+
| `$add`, `$mul`, `$min`, `$max` | 1 or more numbers | sum, product, minimum, maximum |
|
|
929
|
+
| `$sub`, `$div` | exactly 2 numbers | difference, quotient |
|
|
930
|
+
| `$split` | text, separator (default `""`), optional limit | array of strings |
|
|
931
|
+
| `$join` | array, separator (default `""`) | text |
|
|
932
|
+
| `$length` | 1 value | length of a text or array (`0` for null) |
|
|
933
|
+
|
|
934
|
+
A non-numeric operand, or a division by zero, yields no value and the attribute is left out.
|
|
935
|
+
|
|
936
|
+
**Svg.** `Svg` draws in `width` x `height` user units. Shape attributes (`x`, `y`, `width`, `height`, `x1`..`y2`, `cx`, `cy`, `r`, `d`) accept expressions, so a bar is `x = 100 + (start - min) * scale`. A nested `Svg` is a group: put `repeat` on it to draw its shapes once per item. Colors are palette tokens (`chart-1`..`chart-5`, `primary`, `success`, `warning`, `error`, `info`, `muted`, `foreground`, `background`, `border`, `none`). The validator rejects unknown attributes, raw colors, a `Path.d` with anything but path commands and numbers, shapes outside an Svg, and non-shape Svg children.
|
|
937
|
+
|
|
938
|
+
### Example: 6-cell code input
|
|
939
|
+
|
|
940
|
+
Typing advances to the next cell, Backspace clears the cell and moves back, pasting a 6-character code fills every cell, and the `watch` submits once all 6 are filled. Replace the `ui.toast` step with an `app.action` to verify the code server-side.
|
|
941
|
+
|
|
942
|
+
```json
|
|
943
|
+
{
|
|
944
|
+
"models": {},
|
|
945
|
+
"defaultPage": "verify",
|
|
946
|
+
"pages": {
|
|
947
|
+
"verify": {
|
|
948
|
+
"title": "Verify",
|
|
949
|
+
"state": { "otp": ["", "", "", "", "", ""], "code": "" },
|
|
950
|
+
"root": "root",
|
|
951
|
+
"elements": {
|
|
952
|
+
"root": {
|
|
953
|
+
"type": "Stack",
|
|
954
|
+
"props": { "gap": "md", "padding": "md" },
|
|
955
|
+
"children": ["heading", "cells", "submitted"],
|
|
956
|
+
"watch": {
|
|
957
|
+
"/local/otp": [
|
|
958
|
+
{ "action": "ui.when", "params": { "value": { "$length": [{ "$join": [{ "$state": "/local/otp" }, ""] }] }, "eq": 6 } },
|
|
959
|
+
{ "action": "ui.toast", "params": { "message": "Code submitted", "tone": "success" } },
|
|
960
|
+
{ "action": "ui.set", "params": { "path": "/local/code", "value": { "$join": [{ "$state": "/local/otp" }, ""] } } }
|
|
961
|
+
]
|
|
962
|
+
}
|
|
963
|
+
},
|
|
964
|
+
"heading": { "type": "Heading", "props": { "text": "Enter the 6-digit code", "level": "h2" } },
|
|
965
|
+
"cells": {
|
|
966
|
+
"type": "Stack",
|
|
967
|
+
"props": { "direction": "row", "gap": "sm" },
|
|
968
|
+
"repeat": { "statePath": "/local/otp" },
|
|
969
|
+
"children": ["cell"]
|
|
970
|
+
},
|
|
971
|
+
"cell": {
|
|
972
|
+
"type": "Input",
|
|
973
|
+
"props": {
|
|
974
|
+
"id": "otp",
|
|
975
|
+
"value": { "$bindItem": "" },
|
|
976
|
+
"size": "cell",
|
|
977
|
+
"maxLength": 1,
|
|
978
|
+
"inputMode": "numeric",
|
|
979
|
+
"autoComplete": "one-time-code",
|
|
980
|
+
"selectOnFocus": true,
|
|
981
|
+
"onInput": [
|
|
982
|
+
{ "action": "ui.when", "params": { "value": { "$length": [{ "$chain": "value" }] }, "eq": 1 } },
|
|
983
|
+
{ "action": "ui.focus", "params": { "id": "otp", "index": { "$min": [{ "$add": [{ "$index": true }, 1] }, 5] } } }
|
|
984
|
+
],
|
|
985
|
+
"onKeyDown:Backspace": [
|
|
986
|
+
{ "action": "ui.set", "params": { "path": { "$join": [["/local/otp", { "$index": true }], "/"] }, "value": "" } },
|
|
987
|
+
{ "action": "ui.focus", "params": { "id": "otp", "index": { "$max": [{ "$sub": [{ "$index": true }, 1] }, 0] } } }
|
|
988
|
+
],
|
|
989
|
+
"onPaste": [
|
|
990
|
+
{ "action": "ui.when", "params": { "value": { "$length": [{ "$chain": "text" }] }, "eq": 6 } },
|
|
991
|
+
{ "action": "ui.set", "params": { "path": "/local/otp", "value": { "$split": [{ "$chain": "text" }, ""] } } },
|
|
992
|
+
{ "action": "ui.focus", "params": { "id": "otp", "index": 5 } }
|
|
993
|
+
]
|
|
994
|
+
}
|
|
995
|
+
},
|
|
996
|
+
"submitted": {
|
|
997
|
+
"type": "Text",
|
|
998
|
+
"props": { "content": { "$state": "/local/code" }, "tone": "muted" },
|
|
999
|
+
"visible": { "$state": "/local/code" }
|
|
1000
|
+
}
|
|
1001
|
+
}
|
|
1002
|
+
}
|
|
1003
|
+
}
|
|
1004
|
+
}
|
|
1005
|
+
```
|
|
1006
|
+
|
|
1007
|
+
### Example: Gantt timeline
|
|
1008
|
+
|
|
1009
|
+
Each task is a bar at `x = 100 + (start - min) * scale`, `width = days * scale`, one row per item of a repeated list; the dashed line marks day 12. Bind `repeat.statePath` to `/queries/<q>/data` to draw rows from a query instead.
|
|
1010
|
+
|
|
1011
|
+
```json
|
|
1012
|
+
{
|
|
1013
|
+
"models": {},
|
|
1014
|
+
"defaultPage": "plan",
|
|
1015
|
+
"pages": {
|
|
1016
|
+
"plan": {
|
|
1017
|
+
"title": "Plan",
|
|
1018
|
+
"state": {
|
|
1019
|
+
"axis": { "min": 3, "scale": 24 },
|
|
1020
|
+
"tasks": [
|
|
1021
|
+
{ "name": "Research", "start": 3, "days": 4 },
|
|
1022
|
+
{ "name": "Design", "start": 6, "days": 5 },
|
|
1023
|
+
{ "name": "Build", "start": 10, "days": 8 },
|
|
1024
|
+
{ "name": "QA", "start": 16, "days": 4 },
|
|
1025
|
+
{ "name": "Launch", "start": 20, "days": 2 }
|
|
1026
|
+
]
|
|
1027
|
+
},
|
|
1028
|
+
"root": "card",
|
|
1029
|
+
"elements": {
|
|
1030
|
+
"card": { "type": "Card", "props": { "title": "Launch plan", "description": "Days 3-22" }, "children": ["chart"] },
|
|
1031
|
+
"chart": {
|
|
1032
|
+
"type": "Svg",
|
|
1033
|
+
"props": { "width": 640, "height": 200, "label": "Gantt chart of the launch plan" },
|
|
1034
|
+
"children": ["axis", "today", "rows"]
|
|
1035
|
+
},
|
|
1036
|
+
"axis": { "type": "Line", "props": { "x1": 100, "y1": 190, "x2": 632, "y2": 190, "stroke": "border" } },
|
|
1037
|
+
"today": {
|
|
1038
|
+
"type": "Line",
|
|
1039
|
+
"props": {
|
|
1040
|
+
"x1": { "$add": [100, { "$mul": [{ "$sub": [12, { "$state": "/local/axis/min" }] }, { "$state": "/local/axis/scale" }] }] },
|
|
1041
|
+
"y1": 8,
|
|
1042
|
+
"x2": { "$add": [100, { "$mul": [{ "$sub": [12, { "$state": "/local/axis/min" }] }, { "$state": "/local/axis/scale" }] }] },
|
|
1043
|
+
"y2": 190,
|
|
1044
|
+
"stroke": "error",
|
|
1045
|
+
"dashed": true
|
|
1046
|
+
}
|
|
1047
|
+
},
|
|
1048
|
+
"rows": { "type": "Svg", "props": {}, "repeat": { "statePath": "/local/tasks" }, "children": ["label", "bar"] },
|
|
1049
|
+
"label": {
|
|
1050
|
+
"type": "SvgText",
|
|
1051
|
+
"props": {
|
|
1052
|
+
"x": 0,
|
|
1053
|
+
"y": { "$add": [26, { "$mul": [{ "$index": true }, 34] }] },
|
|
1054
|
+
"text": { "$item": "name" },
|
|
1055
|
+
"size": 13
|
|
1056
|
+
}
|
|
1057
|
+
},
|
|
1058
|
+
"bar": {
|
|
1059
|
+
"type": "Rect",
|
|
1060
|
+
"props": {
|
|
1061
|
+
"x": { "$add": [100, { "$mul": [{ "$sub": [{ "$item": "start" }, { "$state": "/local/axis/min" }] }, { "$state": "/local/axis/scale" }] }] },
|
|
1062
|
+
"y": { "$add": [14, { "$mul": [{ "$index": true }, 34] }] },
|
|
1063
|
+
"width": { "$mul": [{ "$item": "days" }, { "$state": "/local/axis/scale" }] },
|
|
1064
|
+
"height": 24,
|
|
1065
|
+
"rx": 4,
|
|
1066
|
+
"fill": "chart-2",
|
|
1067
|
+
"title": { "$item": "name" }
|
|
1068
|
+
}
|
|
1069
|
+
}
|
|
1070
|
+
}
|
|
1071
|
+
}
|
|
1072
|
+
}
|
|
1073
|
+
}
|
|
1074
|
+
```
|
|
1075
|
+
|
|
896
1076
|
## Patch semantics
|
|
897
1077
|
|
|
898
1078
|
`app-patch.definition` is RFC 7396 JSON Merge Patch applied to the stored definition:
|
|
@@ -1019,6 +1199,15 @@ Create this with `app-upsert`:
|
|
|
1019
1199
|
|
|
1020
1200
|
The tool returns `{ appId, url: "/apps/<id>" }`. Open that URL to verify the live UI, then continue with the read-patch-validate loop above.
|
|
1021
1201
|
|
|
1202
|
+
## Embed a sheet or board
|
|
1203
|
+
|
|
1204
|
+
`{ "type": "ObjectEmbed", "props": { "objectId": "<object id>" } }` shows a live, editable sheet or board (see the `boards-and-sheets` skill). Optional props: `height` (160-1200), `readOnly`, and for sheets `tab` and `range`. To show the same object on an HTML page instead, use the page snippet, where `${APP_URL}` is the dashboard origin:
|
|
1205
|
+
|
|
1206
|
+
```html
|
|
1207
|
+
<script type="module" src="${APP_URL}/embed/v1/swarm-object.js"></script>
|
|
1208
|
+
<swarm-object object-id="<object id>"></swarm-object>
|
|
1209
|
+
```
|
|
1210
|
+
|
|
1022
1211
|
## View and screenshot a live app
|
|
1023
1212
|
|
|
1024
1213
|
- An app renders at `<dashboard>/apps/<id>`. Two view modes are set by query string: `?mode=full` (full-viewport overlay with a slim header) and `?mode=chromeless` (only the rendered page, the embed surface). `app.navigate` keeps only `?mode`.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"kind": "skill",
|
|
3
|
+
"name": "boards-and-sheets",
|
|
4
|
+
"displayName": "Boards and sheets",
|
|
5
|
+
"slug": "boards-and-sheets",
|
|
6
|
+
"title": "Boards and sheets",
|
|
7
|
+
"description": "Make spreadsheets with live formulas (`ctx.sheets`) and Excalidraw diagrams (`ctx.boards`) as files on your agent-fs drive, from a script. Covers when to pick a sheet, a board or a Markdown table, how to call them, where to put files, value and range rules, limits, xlsx import and export, and how to hand the link over without announcing the feature.",
|
|
8
|
+
"version": "1.0.0",
|
|
9
|
+
"category": "skills",
|
|
10
|
+
"placeholders": [],
|
|
11
|
+
"runAllSeedersCandidate": true,
|
|
12
|
+
"systemDefault": true,
|
|
13
|
+
"tags": ["sheets", "boards", "spreadsheets", "excalidraw", "agent-fs"]
|
|
14
|
+
}
|