bead-bind-startup — agentscript-webgpu (Agentscript Webgpu)

**Bead document** from Bead: Agentscript Webgpu · [canonical source](https://redfish.acequia.io/guerin/.agents/f4ef67b7-001f-412c-ba90-f93ceba92bda/bead-bind-startup.md) · discussion: Talk: Agentscript Webgpu

**Current focus:** design the CPU→GPU translation of AgentScript's architecture, then prototype it as a taos-engine compute pass. **Do this first:** read [`2026-06-17/notes/00-agentscript-cpu-to-webgpu.md`](2026-06-17/notes/00-agentscript-cpu-to-webgpu.md). The canonical AgentScript source is **already cloned** to `Documents/sites/agentscript.org` (master @ `93d01a3`). Query it via the **agentscript-orama** skill ([`skills/agentscript-orama/`](2026-06-17/skills/agentscript-orama/SKILL.md)) rather than grepping. Next unstarted work = fix the GPU buffer schema against the real CPU semantics. **Operative docs** - Goal / motivation / session log → [`about.md`](about.md). - Architecture map + GPU design + open questions → [`2026-06-17/notes/00-agentscript-cpu-to-webgpu.md`](2026-06-17/notes/00-agentscript-cpu-to-webgpu.md). - Verbatim chat → [`2026-06-17/chats/`](2026-06-17/chats/). **Key dependencies (mount, read-only)** - **taos-engine** `c66cbd1d` — the embedding substrate + the **taos-orama** engine-query skill. Engine source clone: `c:/Users/steph/Documents/src/taos-engine`. WebGPU compute precedents to read: `src/shaders/gpu_cull.wgsl`, `src/splats/training/`, `src/shaders/geo_voxel/voxel_mesher.wgsl`. - **ants-in-taos** `b6fcda63` — the hand-written-paradigm precursor + the RenderFeature draw pattern. **Constraint:** WebGPU verification needs a real GPU via CDP (per `c66cbd1d`'s `cdp-verify-webgpu` skill) — never a headless screenshot. **Next actions (linked todo)** - [x] Clone the canonical AgentScript source → `Documents/sites/agentscript.org` (master @ `93d01a3`). - [x] Build the **agentscript-orama** query skill (sibling of taos-orama). - [x] Read the core classes (`Model`/`World`/`AgentSet`/`Turtle`/`Patches`/`Links`/`Link`); fixed the SoA buffer schema + CPU→GPU map in [`notes/01`](2026-06-17/notes/01-cpu-api-reference-and-translation-map.md). - [x] **v1 water-droplet model SHIPPED + CDP-verified** — [`water-droplets-in-taos.html`](https://redfish.acequia.io/guerin/agentscript/water-droplets-in-taos.html), gridless WebGPU droplets, Sobel-gradient downhill on Terrarium DEM (see `about.md` session log + `notes/02`). - [ ] **v1.5 — water-depth patch field** (pooling/accumulation; then D8/D-inf flow routing) — this is where patches + the `diffuse` kernel (`notes/01` §4) finally earn their place. - [ ] Instanced GPU draw for droplets (drop the per-frame readback + mesh rebuild); CodeMirror-6 polish; `save → user subdomain` (blocked on Joshua Thorp, see `notes/02` TODO). - [ ] Surface the open questions in `notes/00` §"Open questions" to Stephen. - [ ] **Child bead `agent-based-hubler-network`** (opened 2026-06-17, this bead = birth-parent) — agent-beads as turtles/links/patches with `.mjs` startup/setup/step; this bead supplies the WebGPU + CPU-JS step facets. See its `about.md`.