@field/cascade 0.11.0 → 0.13.0

package/AGENTS.md

@@ -39,7 +39,7 @@ Use `cascade new <name>` to create a project and `cascade node <Name>` to scaffo
 
 Never hand-edit a `.cascade` file. Change graphs with `cascade node add|rm`, `connect`, `disconnect`, `set` and `subnet create|move|dissolve` (or `cascade edit` for a batch); they check the edit like `cascade check`, keep the diff minimal and lay new nodes out. Every command takes `--json`, and `cascade mcp` serves the same operations as MCP tools. Read `doc/CLI_REFERENCE.md` and `doc/MCP.md`.
 
-For agents working headlessly: `cascade help node <type>` prints a node's ports and description from the installed package; `cascade run <graph> --out <dir> [--out-node <id>]` saves image outputs as `<node>[.<port>].<ext>` (and `run --json` lists them in `data.images`); `cascade.assert.*` nodes fail a run with a readable message; what nodes and stages print is in the run trace under `.cascade/runs/`; `--env NAME=value` replaces a shell prefix; `cascade doctor --fix` builds the Python environment a project declares in `cascade.json` `python`; every MCP tool takes `project` to work in another directory.
+For agents working headlessly: `cascade help node <type>` prints a node's ports and description from the installed package; `cascade run <graph> --out <dir> [--out-node <id>]` saves image outputs as `<node>[.<port>].<ext>` (and `run --json` lists them in `data.images`); `cascade.assert.*` nodes fail a run with a readable message; what nodes and stages print is in the run trace under `.cascade/runs/`; `--env NAME=value` replaces a shell prefix; `cascade doctor --fix` builds the Python environment a project declares in `cascade.json` `python`; every MCP tool takes `project` to work in another directory. To have Marcus choose a variant on his phone: `cascade ladder <graph> <node> --name <name> --seeds a,b,c --cairn <Substrate vault>/<space>/_attachments/ladders/<id> --json`, post `data.cairnChoice` (a `cairn:choice` fence, at most 8 pictures) in the Cairn chat as is, and when "Picked: <label> (pick:<id>:<n>)" comes back run `cascade pick <id> <n> --project <project>` and reply with that locked image (`doc/CLI_REFERENCE.md`, "Picking a ladder variant in Cairn").
 
 `cascade build <graph.cascade> --out <new-directory>` exports a static browser
 player. Use repeatable `--asset <project-relative-file>` for inputs whose paths
@@ -138,7 +138,7 @@ Definition rules:
 - Vector props support `min`, `max`, and `step`, shared across components. Props may declare a default `expression`; an explicitly saved value overrides that default, including when it equals the numeric default.
 - WebGPU nodes declare `gpu` and use its shared device and per-node `cache`. Portable GPU nodes can run through optional Dawn in the CLI; browser-only declarations remain refused. Import constants and explicit `readTexture` (RGBA8 only) from `cascade/gpu`. Graph texture exchange remains future work. See `doc/HEADLESS_GPU.md` for bounded agent renders, diagnostics and hardware tests.
 - Treat graph wires as the primary data boundary. A node may observe only its connected inputs, its props, and declared host capabilities; it must not inspect sibling nodes or the graph to discover data.
-- Deterministic node modules may not retain module-level mutable values, access ambient state such as `globalThis`, browser storage, or `process`, run top-level effects, or import sibling node implementations. `cascade check` reports these as `architecture/*` diagnostics.
+- Deterministic node modules may not retain module-level mutable values, access ambient state such as `globalThis`, browser storage, or `process`, run top-level effects, or import sibling node implementations. `cascade check` reports these as `architecture/*` diagnostics. Pure module-level helpers are allowed: function declarations, and `const` values that cannot change (literals and arithmetic, `Math.PI`, arrow functions, arrays and objects under `as const` or `Object.freeze`). `let`, `new Map()`, a bare `[]`/`{}`, a regex or any other call is module state.
 - A cache may memoize computation from wired inputs, but it must never supply unwired data. Make cache use an explicitly labelled prop and keep cache keys derived from the complete wired input and relevant props.
 - Keep model/provider integrations in the project. Cascade core has no Google,
   Anthropic, OpenAI, or generic `ai` capability. Use normal typed outputs such
@@ -225,13 +225,16 @@ type system knows what a `vec2` is; nothing tells it that `offset_x` and
 
 ## Change workflow
 
-Use Node.js 22.13 or newer. Cascade compiles with TypeScript 6; do not move to
-the TypeScript 7 preview until it is stable and the repository gates pass.
+Use Node.js 22.13 or newer. Cascade compiles with TypeScript 6 (the
+`typescript` dependency: the CLI and server use its JS API, and svelte-check
+runs on it). The plain-tsc gates in `scripts/verify.mjs` run on TypeScript 7
+(the `typescript7` devDependency), which reports the same errors about seven
+times faster; keep code clean under both.
 
 1. Add or update a focused regression test.
 2. Make the smallest change at the owning layer.
 3. Prefer deletion or an existing utility over another wrapper.
-4. While iterating, run the focused test or `npm run verify:fast` (types for src, tests and server, the node reference, the architecture ratchets, and `vitest related` for the files you changed). Before you commit, run `npm run verify`: it builds the packages, then runs the typechecks, `check:packages`, svelte-check, the whole vitest suite, the package tests and the Studio bundle budget, stopping at the first failure. It never touches `dist/`. Run `npm run build` and `npm run build:cli` only when you need the built CLI or Studio; both replace `dist/` only on success, so a failed build leaves the previous CLI working.
+4. While iterating, run the focused test or `npm run verify:fast` (types for src, tests and server, the node reference, the architecture ratchets, and `vitest related` for the files you changed). Before you commit, run `npm run verify`: it builds the packages, then runs the typechecks, `check:packages`, svelte-check, the whole vitest suite, the package tests and the Studio bundle budget, stopping at the first failure. It never touches `dist/`. Run `npm run build` and `npm run build:cli` only when you need the built CLI or Studio; both replace `dist/` only on success, so a failed build leaves the previous CLI working. `build:cli` skips the package build when every `packages/*/dist` is newer than its sources (`-- --force` rebuilds them). For a runtime or CLI change, `npx vitest run --project node` runs the suite without the Studio component tests. `git push` runs a pre-push gate (`.githooks/pre-push`, installed by `npm install`): when the pushed commits touch code it runs `verify --push` (the fast gate, svelte-check alongside, and the tests related to the pushed files, leaving out `tests/performance/`), 10–14 s. It checks the working tree, so someone else's uncommitted edit can fail it; `git push --no-verify` skips it once, and it does not replace `npm run verify` before you commit.
 5. For package/public API changes, also test the packed tarball from an empty temporary project.
 6. When a built-in definition or a node library registry changes, regenerate the node reference with `npm run build:node-reference` and commit the result. `verify` fails on a stale one (`npm run check:node-reference`).
 7. The ratchets in `tests/architecture-*.test.ts`, `scripts/bundle-budget.mjs` and the test type-error list in `scripts/verify.mjs` only go down. When one fails, fix the code: split the file, move the shared code down a layer, break the cycle, lazy-load the new Studio code. Never add to a list or raise a number; when your change lowers one, lower the number in the same commit.

package/ARCHITECTURE.md

@@ -80,8 +80,9 @@ Studio-only project extensions use the type-only `cascade/studio/panel` contract
 The packed root tarball contains compiled contracts, runtime, declarations, and a self-contained CLI. It must install and type-resolve from an empty project without workspace links or development dependencies. Additional packages require a concrete independent publication/versioning need.
 
 The repository requires Node.js 22.13 or newer and builds with TypeScript 6,
-Vite 8, and the Svelte Vite plugin 7. TypeScript 7 remains deferred while it is
-a preview rather than a stable compiler target.
+Vite 8, and the Svelte Vite plugin 7. TypeScript 7 runs the plain-tsc gates in
+`scripts/verify.mjs` only; the build, the CLI's node compiler and svelte-check
+stay on 6, which has the JS API they use.
 
 Model providers are deliberately outside Cascade. Projects own provider SDKs,
 credentials, model selection, retries, and result normalization, using the same
@@ -121,9 +122,9 @@ Callbacks and destruction hooks run after a valid structural commit. They are no
 
 ## Execution
 
-Data runs follow graph dependencies. Explicit triggers use a FIFO queue, authored fan-out order, monotonic per-run sequence IDs, and cycle rejection. A triggered node receives cooked data ancestors before delivery.
+Data runs follow graph dependencies; with `concurrency` > 1 (headless runs with a stage worker pool) independent nodes cook at once, still starting in topological order so events and traces keep one order. Explicit triggers use a FIFO queue, authored fan-out order, monotonic per-run sequence IDs, and cycle rejection. A triggered node receives cooked data ancestors before delivery.
 
-Execution failures resolve to a failed `RunResult`; API misuse and invalid preflight reject. Cancellation propagates through capability calls. Inspection and output values are immutable snapshots; browser-only live resources remain host-owned handles.
+Execution failures resolve to a failed `RunResult`; API misuse and invalid preflight reject. Cancellation propagates through capability calls. Inspection and output values are immutable; browser-only live resources remain host-owned handles. A value a node hands to `set()` is adopted, not copied: under the default `values: "freeze"` it is checked and deep-frozen where it stands, and every later read (`getOutputs`, `inspect`, `node:output`, the next node's input) is that same value. Headless runs (`cascade run`) use `values: "trust"`, which checks the top-level type and freezes shallowly without walking the contents. Caller-supplied values (`setInput`, presets, definitions) are still copied.
 
 ### Geometry, simulation and feedback
 

package/CHANGELOG.md

@@ -4,6 +4,251 @@ Notable changes to Cascade. Newest first.
 
 ## Unreleased
 
+## 0.13.0 — 2026-11-09
+
+### Added
+
+- **Browser player without chrome.** `mount(…, { chrome: false })`, or
+  `player.html?chrome=0` in a plain iframe, shows the output alone on a
+  transparent page: no dark frame, Play button or frame field. See
+  `doc/WEB_PLAYER.md`.
+- **Read-only roots outside the project.** `"reads": ["../other/data"]` in
+  `cascade.json` lets file reads (`files`, `cascade/io`, Studio media) resolve
+  into another folder by `..` or a symlink; writes there are still refused,
+  and any other path out of the project still is. See "Reading another
+  project's data" in `doc/PROJECT_AUTHORING.md`.
+- **Named exports and a keyed cache for nodes.** `"writes": ["renders"]` in
+  `cascade.json` lets the `files` capability write stably named files into a
+  declared project folder beside `.cascade-cache/`. `files.cache.get(key)` /
+  `files.cache.put(key, data)` (contract `KeyedCache`) keep entries under
+  `.cascade-cache/keyed/<key>`, found again by key on the next run, where
+  `cascade/io` names carry a content hash. `files.write` is now atomic, and
+  normalises before its folder test, so `.cascade-cache/../x` is refused.
+- **Node files may hold immutable module-level constants.** Helper functions
+  were already allowed; `architecture/module-state` now also passes `const`s
+  that cannot change (`const TAU = Math.PI * 2`, `[...] as const`,
+  `Object.freeze({...})`, arrow-function helpers). `let`, `new Map()`, a bare
+  array or object, a regex and other calls are still refused.
+
+### Fixed
+
+- **The browser player re-cooks only what changed.** `setProp`, `setInput`
+  and each frame now cook the changed node and what lies downstream of it;
+  an unchanged upstream node keeps its outputs (`reuse: "strict"`), so a
+  paint prop no longer re-runs a slow data node above it.
+- **`cascade render --workers` accepts a piece animated on twos.** Two frames
+  whose node saved the same drawing land on one content-named cache file
+  (`.cascade-cache/<node>.<hash>.png`); that is the same bytes, not a
+  clobber, so the fixed-path probe no longer refuses it.
+
+### Changed
+
+- **`FileCapability` has a required `cache: KeyedCache` member.** A custom
+  host that implements the `files` capability itself must now provide
+  `cache.get(key)` and `cache.put(key, data)`; it no longer type-checks
+  without them. Studio and the headless host already do.
+
+### Known gaps
+
+- **Ramp's stop editor and Image's file picker are not in Studio yet.** The
+  definition-v1 port of the image nodes left them out. Graphs that already
+  set them render unchanged.
+
+## 0.12.0 — 2026-11-09
+
+### Added
+
+- **GPU nodes get the whole GPU, and can say what they need.** Studio and
+  the headless host now ask for every limit the adapter allows instead of
+  WebGPU's defaults: on an M3 Max, 4 GiB per storage binding instead of
+  128 MiB, 1,024 workgroup invocations instead of 256, 32 KiB workgroup
+  storage instead of 16, 10 storage buffers per stage instead of 8. A node
+  may declare `gpuLimits` (`{ maxStorageBufferBindingSize: 512 * 2 ** 20 }`);
+  on a GPU below it the node fails before cooking, naming the limit and what
+  the GPU gives. An adapter that refuses its own ceiling still gets a device
+  with the defaults.
+- **Scrub number in the Inspector.** Every number field and each vector
+  component drags anywhere on the field (at `scrub.ts`'s rates, Shift ×10,
+  Cmd ÷10), with a tick ruler that slides under the pointer and stops at a
+  declared min/max while that edge lights; hover shows the ruler and ‹ ›
+  steppers; a click without a drag opens typing, and plain arithmetic
+  (`320/2`, `10+5`) commits the number it works out to, not an expression. A
+  sideways touch drag scrubs and a vertical one still scrolls. Middle-drag,
+  label-drag and Alt-drag are unchanged. Vector fields are now text, so they
+  take the same sums and arrow-key steps.
+- **Scrub number on every node's vector parameters.** The vector components
+  most nodes render through (CoreValue: `vec2`/`vec3`/`vec2i`… params and
+  ports) are the same scrub field: drag anywhere, click to type `10+5`, ‹ ›
+  and arrow-key steps, the ruler stopping at a declared range with the edge
+  lit. A bounded component keeps its range hairline. Read-only values stay
+  plain. Middle-, Alt- and label-drag and the Σ expression path are unchanged.
+- **`cascade check` warns on nodes that have grown into a pipeline.**
+  `shape/long-execute` when `execute` passes 150 lines; `shape/mixed-jobs`
+  when one module loads, generates, colours, draws and exports (four of the
+  five, or loading and exporting together), judged from the calls it makes.
+  Advice only: the check still passes, `--strict` included, and `validate`
+  and `run` stay quiet. Points at "Design the graph" in
+  `doc/PROJECT_AUTHORING.md`.
+- **Ladder variants as a Cairn choice card.** `cascade ladder … --cairn
+  <vault dir>` (MCP `ladder` `cairn`) copies each variant to
+  `<dir>/<id>-<nn>.png` in the Substrate vault and prints a `cairn:choice`
+  fence (`--json`: `data.cairnChoice`): one option per variant, labelled with
+  what it changed (`seed 42`, `hue=0.3`), its image relative to the vault
+  (nearest `.obsidian` or `.git`, or `--vault`), and the value
+  `pick:<id>:<n>`. Marcus taps a picture on his phone; the agent gets
+  "Picked: … (pick:<id>:<n>)", runs `cascade pick <id> <n>` and replies with
+  the locked image. At most 8 variants, refused before cooking. The loop is in
+  AGENTS.md, `doc/CLI_REFERENCE.md` and the `cascade new` template.
+- **`cascade share`: output reaches people as a link.** `cascade share
+  <graph | site-directory> [--name <slug>]` exports the editor (or takes a
+  static directory with an `index.html`) into a scratch directory, with the
+  export allowlist and leak scan, deploys it to the Vercel project
+  `cascade-<slug>` and prints the production URL (`data.url` with `--json`).
+  Each share is recorded in the project's `shares.json`. Public unless
+  `--protected`. Also the MCP tool `share`. The deploy step is a `Deployer`
+  (`deployVercel` in `editorExport.ts`), which tests stub; `cascade export
+  --deploy vercel` uses the same one and now checks the production alias
+  Vercel reports rather than assuming `<project>.vercel.app`.
+
+### Changed
+
+- **`git push` runs a pre-push gate.** `npm install` points the checkout's
+  hooks at `.githooks/`; a push whose commits touch code runs
+  `verify --push`: types, node reference, architecture, svelte-check in
+  parallel, and the tests related to the pushed files, without the
+  load-sensitive `tests/performance/` timings. 10.8 s for a Studio change,
+  10–14 s for a `Graph.ts` change on a loaded machine. A push of docs alone
+  skips it; `--no-verify` skips it once.
+- **The test suite runs in about 13 s, down from 18 s.** Studio imported
+  Lucide through its `@lucide/svelte` barrel, which loads every icon: 4.8 s
+  of module loading in each component test file and on every dev-server
+  cold start. Icons are now imported one by one
+  (`@lucide/svelte/icons/<name>`), and an architecture test fails if the
+  barrel comes back. The Studio bundle stays inside its budget.
+- **Independent nodes cook at once in a headless run.** A project with a
+  warm stage worker gets a small pool of them (2–4, sized from cores and
+  memory; `exec.stages.workers` or `CASCADE_STAGE_WORKERS` sets it, a
+  `cascade render` worker keeps one), and the run cooks that many nodes at
+  once, a node only after everything it reads. Nodes still start in
+  topological order, so the run trace's order is the same every run, and a
+  stage call or log line goes to the node that made it. cloud-plots
+  `morph.cascade`, cold (Python cache missed), frames 101–107: 873 → 271 ms a
+  frame with 4 workers, the four renders overlapping; the first frame, which
+  starts the workers, 6.3 → 5.1 s. Runtime option `concurrency` (default 1);
+  feedback, trigger-wired and GPU nodes still cook alone.
+- **The runtime stops copying values.** A value a node hands to `set()` is
+  checked and deep-frozen where it stands (`values: "freeze"`, the default)
+  instead of being cloned, and every later read (the `node:output` event,
+  `getOutputs`, a run's result, `inspect()`, the next node's input) is that
+  same value rather than another copy. `cascade run` uses `values: "trust"`:
+  the top-level type is checked and the value frozen shallowly, its contents
+  are not walked. `run --frames` works out which ports to save once per run
+  instead of calling `inspect()` every frame. A 1M-point plain array through
+  three nodes: 1,335 → 8 ms a frame under `trust` (105 ms under `freeze`),
+  `inspect()` 427 → 0 ms. A node that mutates a plain array or object after
+  handing it to `set()` now throws; it used to change nothing.
+- **The image library is definition-v1 and runs everywhere.** Color,
+  Checkers, Noise, Ramp, Text, File (`cascade.image.Image`), Blur, Normal Map,
+  Resize, Transform and Composite were Studio classes over `ImageNodeBase`;
+  they are portable built-ins in `packages/runtime` with the same module ids,
+  ports and props, so saved graphs load unchanged and now also run under
+  `cascade run`/`render`, MCP, exported editors and the web player. Images pass
+  between them through the in-memory image contract; in Studio they stay in
+  the page (`.cascade-studio/…` paths the Viewer draws from memory) rather than
+  becoming files. 53 golden fixtures captured on the class nodes render pixel
+  for pixel the same on the runtime and in Studio. A colour saved as
+  `{ r, g, b, a }` reads as the four-component colour on load
+  (`Color.upgrade`). Noise no longer fetches simplex-noise from esm.sh (4.0.3
+  is vendored). Text takes a project font file in `font` and falls back to
+  sans-serif when it is missing. The Ramp's stops edit as JSON in the
+  Parameters section rather than with the ramp widget, and File's path is a
+  text field. A dynamic node that read an `ImageBuffer` from these ports now
+  gets an `ImageRef`.
+- **Contact Sheet and the assertions are in Studio.** `cascade.image.ContactSheet`
+  is in the Image library's Composite category and `cascade.assert.*` has its
+  own Assert library. The assertions are portable now (Not Blank takes kept
+  pixels or decodes with `DecompressionStream`), so they live in the runtime's
+  built-in list and `src/cli/assertNodes.ts` and the headless-only list are
+  gone. Their bodies load lazily: Studio's first-paint JS went down, 969,706 →
+  964,958 B, with the class library and `ImageBuffer` gone; the budget is
+  lowered to match.
+- **Studio paints the viewed node first.** After the Viewer's node cooks,
+  nothing outside its upstream starts until the Viewer has shown the new
+  picture (image loaded, then a frame; at most 300 ms), and while a slider
+  is held or a number field scrubs, only the viewed node's upstream cooks:
+  the rest waits for release. field-logo hue slider, input to painted:
+  440 → 141 ms median; a held drag no longer runs watercolor (~300 ms long
+  task) at all until release. Studio only (`src/editor/stores/viewedFirstCook.ts`);
+  the CLI and the scheduler are unchanged.
+- **Smaller Studio first paint.** The Agent, Definition, Node Info and
+  Timeline panels load when their panel is created, and marked + DOMPurify
+  load with the Agent panel or the first text annotation (which shows plain
+  text for that moment). First-paint JS 1,135,042 → 968,597 B (gzip 325 →
+  273 KB), CSS 239,446 → 223,490 B. `scripts/bundle-budget.mjs` now counts
+  the chunks the entry modulepreloads too, and its budgets are lowered to the
+  new size plus 25 KB of JS and 10 KB of CSS headroom.
+- **Faster dev loop.** `npm run build:cli` skips the package build when
+  every `packages/*/dist` is newer than its sources (3.5 → 2.0 s; `--force`
+  rebuilds). Vitest runs two projects, `node` and `studio` (the Svelte
+  plugin only where components are tested): `vitest run --project node` is
+  1,767 tests in ~10 s against ~18 s for the whole suite, which `verify`
+  still runs in full; `verify --fast` uses the node project when nothing
+  Studio-side changed. The plain-tsc gates in `verify` run on TypeScript 7
+  (`typescript7` devDependency), same errors per file, src + tests 3.0 →
+  0.4 s; the build, the CLI's node compiler and svelte-check stay on
+  TypeScript 6.
+- **Intermediate images encode six times faster headlessly.** `saveImage`
+  (`cascade/io`) and `writeImage` (`cascade/image`) hand a canvas to the
+  headless host as pixels, and it writes a lossless PNG at zlib level 1
+  through sharp instead of Skia's default encoder: 157 → 26 ms per 1024²
+  image. field-logo renders at 887 ms a frame instead of 1,791, with
+  pixel-identical outputs. The CLI now bundles `cascade/io` from its own
+  install, as it already did `cascade/image`, so a sketch pinned to an older
+  package gets it too. New optional `IoBridge.keep` and
+  `AssetCapability.keepImage`; Studio and the browser player are unchanged.
+- **Images pass between nodes in memory under `cascade run`/`render`.** The
+  headless host holds an intermediate's pixels (`ImagePixels` in contracts:
+  RGBA8, sRGB, unpremultiplied), names its file by their hash and writes the
+  level-1 PNG behind the run; `readImage`/`loadBitmap` get those pixels back
+  with no read and no decode (`AssetCapability.imagePixels`,
+  `IoBridge.pixels`). Every file reader still finds a whole file: Python stage
+  calls, `assets.read`, server nodes, the end of a run, freeze/lock/ladder all
+  wait for the write behind. Saved outputs are encoded from the pixels at
+  full compression (zlib 6, adaptive filtering), not copied from the
+  intermediate. field-logo 887 → 834 ms a frame (1,791 before round 2),
+  outputs pixel-identical; what remains is the nodes' own pixel loops. The
+  contract is in `doc/PROJECT_AUTHORING.md`, "How an image travels between
+  nodes".
+- **`cascade render` workers start Python during the probe frames.** Each
+  worker process starts the project's warm Python worker as it boots
+  (`installProjectStages(…, { prewarm: true })`, `PythonWorker.warm()`), so
+  the interpreter start and imports overlap the first two serial frames
+  instead of following them. A project whose worker takes 3 s to import
+  renders 24 frames on 4 workers in 4.0 s instead of 7.0. A worker whose
+  interpreter cannot start now fails the call that needs it instead of
+  crashing the process. `run --frames` over 30 frames prints one line naming
+  `cascade render` for the same range.
+- **Run traces time the frame and the save.** Each run in
+  `.cascade/runs/*.json` has `ms` (the cook), `frameMs` (to outputs on disk)
+  and `saveMs` (the difference), so a slow save shows without a profiler
+  (field-logo now: 747 ms cook, 82 ms save a frame).
+
+### Fixed
+
+- **`run --frames … --mp4` with an absolute `--out`.** ffmpeg was handed the
+  project root joined to the absolute sequence path and found no files; the
+  sequence is now resolved, not joined.
+- **`cascade doctor` fails a project whose stages cannot import numpy.** With
+  no `python` environment declared, a stage source importing numpy and an
+  interpreter without it is a `stage imports` failure naming the file and the
+  fix. cloud-wall and cloud-volumes passed doctor and could not render.
+
+### Known gaps
+
+- **Ramp's stop editor and Image's file picker are not in Studio yet.** The
+  definition-v1 port of the image nodes left them out. Graphs that already
+  set them render unchanged.
+
 ## 0.11.0 — 2026-11-07
 
 ### Added

package/README.md

@@ -36,7 +36,7 @@ cascade .                          # reopen it later
 cascade run index.cascade --frames 1 --json   # render headlessly
 ```
 
-The npm package is at 0.11.0 and includes every command below. 0.11 adds `cascade/image`, `ladder`/`pick`, `run --out`, assertion nodes, `help node` and `doctor`; see the [changelog](CHANGELOG.md).
+The npm package is at 0.13.0 and includes every command below. 0.13 adds the chrome-free player, read-only roots and named writes in `cascade.json`, a keyed node cache and module-level constants in node files; see the [changelog](CHANGELOG.md).
 
 ## New in 0.9: shareable editors
 

package/dist/assets/AgentPanel-1JugFjE4.css

@@ -0,0 +1 @@
+.console.svelte-1cqop5k{background:var(--surface-panel);width:100%;height:100%;color:var(--text-primary);flex-direction:column;min-height:0;font-family:SF Mono,Monaco,Cascadia Code,Consolas,monospace;font-size:12px;display:flex}.console.drop-active.svelte-1cqop5k{outline:1px solid var(--accent);outline-offset:-1px}.bar.svelte-1cqop5k{border-bottom:1px solid var(--border-divider);background:var(--surface-panel-alt);align-items:center;gap:6px;padding:4px 6px;display:flex}.bar.svelte-1cqop5k select:where(.svelte-1cqop5k),.bar.svelte-1cqop5k button:where(.svelte-1cqop5k),.send.svelte-1cqop5k{background:var(--surface-control);color:var(--text-primary);border:1px solid var(--border);font:inherit;cursor:pointer;border-radius:4px;padding:2px 6px}.send.svelte-1cqop5k{flex:none;width:30px;height:30px;padding:0;font-size:15px;line-height:1}.bar.svelte-1cqop5k button.icon:where(.svelte-1cqop5k){width:22px;height:22px;padding:0;font-size:12px;line-height:1}.bar.svelte-1cqop5k button.stop:where(.svelte-1cqop5k){color:var(--accent)}.zoom.svelte-1cqop5k{color:var(--text-secondary);font:inherit;cursor:pointer;background:0 0;border:none;padding:0 4px}.zoom.svelte-1cqop5k:hover{color:var(--text-primary)}.bar.svelte-1cqop5k button:where(.svelte-1cqop5k):hover,.send.svelte-1cqop5k:hover:not(:disabled){background:var(--surface-control-hover)}.send.svelte-1cqop5k:disabled{color:var(--text-disabled);cursor:default}.sketch.svelte-1cqop5k{color:var(--text-tertiary);text-overflow:ellipsis;white-space:nowrap;max-width:40%;overflow:hidden}.spacer.svelte-1cqop5k{flex:1}.notice.svelte-1cqop5k{background:var(--banner-warn-bg);color:var(--banner-warn-text);border-bottom:1px solid var(--banner-warn-border);padding:6px 8px;line-height:1.5}.notice.svelte-1cqop5k code:where(.svelte-1cqop5k){color:var(--text-code);white-space:pre-wrap;margin-top:4px;display:block}.transcript.svelte-1cqop5k{min-height:0;font-size:calc(12px * var(--agent-zoom,1));flex-direction:column;flex:1;gap:4px;padding:6px 8px;line-height:1.45;display:flex;overflow:auto}.hint.svelte-1cqop5k{color:var(--text-faint);line-height:1.6}.entry.svelte-1cqop5k{white-space:pre-wrap;word-break:break-word;line-height:1.5}.entry.you.svelte-1cqop5k{color:var(--accent)}.entry.agent.svelte-1cqop5k{color:var(--text-primary)}.entry.result.svelte-1cqop5k{color:var(--text-bright)}.entry.tool.svelte-1cqop5k{color:var(--text-tertiary)}.entry.system.svelte-1cqop5k{color:var(--text-faint)}.entry.detail.svelte-1cqop5k{color:var(--text-faint);font-size:.9em}.entry.error.svelte-1cqop5k{color:var(--status-error)}.detail-toggle.svelte-1cqop5k{border:1px solid var(--border-faint);color:var(--text-faint);font:inherit;cursor:pointer;background:0 0;border-radius:3px;align-self:flex-start;margin-top:.25rem;padding:.1rem .4rem;font-size:.85em}.detail-toggle.svelte-1cqop5k:hover{color:var(--text-secondary);border-color:var(--border-divider)}.composer.svelte-1cqop5k{border-top:1px solid var(--border-divider);background:var(--surface-panel-alt);flex-direction:column;gap:8px;padding:10px;display:flex}.composer-context.svelte-1cqop5k,.composer-row.svelte-1cqop5k{align-items:center;gap:8px;display:flex}.composer-context.svelte-1cqop5k button:where(.svelte-1cqop5k){border:1px solid var(--border);background:var(--surface-control);color:var(--text-secondary);font:inherit;cursor:pointer;border-radius:4px;padding:3px 7px}.composer-context.svelte-1cqop5k button.active:where(.svelte-1cqop5k){border-color:var(--accent);color:var(--text-primary);background:var(--accent-tint)}.composer-context.svelte-1cqop5k button:where(.svelte-1cqop5k):disabled{color:var(--text-disabled);cursor:default}.composer-context.svelte-1cqop5k span:where(.svelte-1cqop5k){min-width:0;color:var(--text-tertiary);text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.composer-row.svelte-1cqop5k{align-items:flex-end}.composer.svelte-1cqop5k textarea:where(.svelte-1cqop5k){resize:none;background:var(--surface-input);max-height:50%;color:var(--text-primary);border:1px solid var(--border);font-family:inherit;font-size:calc(12px * var(--agent-zoom,1));border-radius:4px;flex:1;padding:8px 10px;line-height:1.45;overflow-y:auto}.composer.svelte-1cqop5k textarea:where(.svelte-1cqop5k):focus{outline:1px solid var(--accent);outline-offset:-1px}.entry.markdown.svelte-1cqop5k{white-space:normal}.entry.markdown.svelte-1cqop5k>:first-child{margin-top:0}.entry.markdown.svelte-1cqop5k>:last-child{margin-bottom:0}.entry.markdown.svelte-1cqop5k p{margin:0 0 .6em}.entry.markdown.svelte-1cqop5k h1,.entry.markdown.svelte-1cqop5k h2,.entry.markdown.svelte-1cqop5k h3,.entry.markdown.svelte-1cqop5k h4,.entry.markdown.svelte-1cqop5k h5,.entry.markdown.svelte-1cqop5k h6{color:var(--text-bright);margin:.9em 0 .35em;font-weight:600;line-height:1.3}.entry.markdown.svelte-1cqop5k h1{font-size:1.3em}.entry.markdown.svelte-1cqop5k h2{font-size:1.18em}.entry.markdown.svelte-1cqop5k h3{font-size:1.08em}.entry.markdown.svelte-1cqop5k h4,.entry.markdown.svelte-1cqop5k h5,.entry.markdown.svelte-1cqop5k h6{font-size:1em}.entry.markdown.svelte-1cqop5k ul,.entry.markdown.svelte-1cqop5k ol{margin:0 0 .6em;padding-left:1.4em}.entry.markdown.svelte-1cqop5k li{margin:.15em 0}.entry.markdown.svelte-1cqop5k li>p{margin:0}.entry.markdown.svelte-1cqop5k strong{color:var(--text-bright);font-weight:600}.entry.markdown.svelte-1cqop5k blockquote{border-left:2px solid var(--border-divider);color:var(--text-tertiary);margin:0 0 .6em;padding-left:.8em}.entry.markdown.svelte-1cqop5k hr{border:0;border-top:1px solid var(--border-faint);margin:.8em 0}.entry.markdown.svelte-1cqop5k a{color:var(--accent)}.entry.markdown.svelte-1cqop5k code{background:var(--surface-raised);color:var(--text-code);border-radius:3px;padding:.1em .3em;font-size:.92em}.entry.markdown.svelte-1cqop5k pre{background:var(--surface-raised);border:1px solid var(--border-faint);white-space:pre;border-radius:4px;margin:0 0 .6em;padding:.5em .6em;overflow-x:auto}.entry.markdown.svelte-1cqop5k pre code{white-space:pre;background:0 0;border-radius:0;padding:0}.entry.markdown.svelte-1cqop5k table{border-collapse:collapse;max-width:100%;margin:0 0 .6em;display:block;overflow-x:auto}.entry.markdown.svelte-1cqop5k th,.entry.markdown.svelte-1cqop5k td{border:1px solid var(--border-faint);text-align:left;vertical-align:top;white-space:nowrap;word-break:normal;padding:.25em .5em}.entry.markdown.svelte-1cqop5k th{background:var(--surface-raised);color:var(--text-bright);font-weight:600}.entry.markdown.svelte-1cqop5k img{max-width:100%}

package/dist/assets/AgentPanel-BDL5MddA.js

@@ -0,0 +1,5 @@
+import{$ as e,D as t,Dt as n,F as r,G as i,I as a,L as o,O as s,Ot as ee,Q as c,T as te,U as l,V as u,W as ne,X as d,Z as re,_t as ie,at as ae,ct as f,dt as p,et as m,ft as oe,gt as se,it as h,jt as g,l as ce,lt as _,n as le,nt as v,ot as y,p as ue,pt as b,q as de,r as fe,rt as pe,st as me,v as he,vt as ge,w as _e,x as ve,yt as ye,z as x}from"./legacy-CTEeXeqF.js";import{_ as be,dt as xe,g as Se,h as Ce,m as we,o as S,p as Te,v as Ee,y as De}from"./index-BWnrmIB9.js";import{renderMarkdown as Oe}from"./renderMarkdown-ork0Oir7.js";var C=class extends Error{constructor(e,t=null,n=null){super(e),this.hint=t,this.code=n,this.name=`AgentUnavailableError`}},w=null,T=null;function ke(){return w?Promise.resolve(w):(T??=Ae().finally(()=>{T=null}),T)}async function Ae(){let e=await fetch(`/api/agent/capability`);if(e.status===404)throw new C(`The agent console is disabled on this server. It is available only on a loopback server or one started with an explicit trusted host.`);if(!e.ok)throw new C(`Could not start an agent session (${e.status})`);let{capability:t}=await e.json();if(typeof t!=`string`||!t)throw new C(`Server issued no agent capability`);return w=t,t}async function E(e,t){let n=e=>({...t.headers??{},"X-Cascade-Agent-Capability":e}),r=await fetch(e,{...t,headers:n(await ke())});return r.status===403&&(w=null,r=await fetch(e,{...t,headers:n(await ke())})),r}async function je(e){let t=await E(`/api/agent/status${e?`?sketch=${encodeURIComponent(e)}`:``}`,{method:`GET`});if(!t.ok)throw new C(`Could not read agent status (${t.status})`);let n=await t.json();return{root:String(n?.root??``),agents:Array.isArray(n?.agents)?n.agents:[],sessions:Array.isArray(n?.sessions)?n.sessions:[]}}var D=2e3,O=3e4;function Me(e){let t=!1,n=null,r=null,i=D,a=e.sketch?`?sketch=${encodeURIComponent(e.sketch)}`:``,o=typeof document<`u`,s=()=>!o||document.visibilityState!==`hidden`,ee=()=>{t||r||!s()||(r=setTimeout(()=>{r=null,c()},i),i=Math.min(i*2,O))};async function c(){if(t||n||!s())return;let r=new AbortController;n=r;try{let n=await E(`/api/agent/watch${a}`,{method:`GET`,signal:r.signal});if(n.status===404){t=!0;return}if(!n.ok)throw Error(`agent watch ${n.status}`);i=D,await k(n,t=>{t?.type===`status`&&Array.isArray(t.sessions)&&e.onSessions(t.sessions)})}catch(e){if(e instanceof C){t=!0;return}if(e?.name===`AbortError`)return}finally{n===r&&(n=null)}ee()}let te=()=>{s()?(i=D,c()):(n?.abort(),n=null,r&&clearTimeout(r),r=null)};return o&&document.addEventListener(`visibilitychange`,te),c(),()=>{t=!0,n?.abort(),n=null,r&&clearTimeout(r),o&&document.removeEventListener(`visibilitychange`,te)}}async function k(e,t){if(!e.body)return;let n=e.body.getReader(),r=new TextDecoder,i=``,a=e=>{if(e.trim())try{t(JSON.parse(e))}catch{}};for(;;){let{value:e,done:t}=await n.read();if(t)break;i+=r.decode(e,{stream:!0});let o=i.split(`
+`);i=o.pop()??``;for(let e of o)a(e)}a(i)}async function Ne(e,t){let n=await E(`/api/agent/cancel`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({agent:e,sketch:t})});return n.ok?(await n.json().catch(()=>null))?.cancelled===!0:!1}async function Pe(e,t){await E(`/api/agent/reset`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({agent:e,sketch:t})})}async function Fe(e){let t=await E(`/api/agent/attach`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({agent:e.agent,sketch:e.sketch,since:e.since??0}),signal:e.signal});if(!t.ok){let e=await t.json().catch(()=>null);throw new C(String(e?.error??`Could not reconnect to the agent (${t.status})`))}await A(t,e.onEvent)}async function Ie(e){let t=await E(`/api/agent/prompt`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({agent:e.agent,sketch:e.sketch,prompt:e.prompt}),signal:e.signal});if(!t.ok){let e=await t.json().catch(()=>null);throw new C(String(e?.error??`Agent request failed (${t.status})`),e?.hint??null,e?.code??null)}await A(t,e.onEvent)}async function A(e,t){if(!e.body)throw new C(`Agent produced no stream`);let n=e.body.getReader(),r=new TextDecoder,i=``;for(;;){let{value:e,done:a}=await n.read();if(a)break;i+=r.decode(e,{stream:!0});let o=i.split(`
+`);i=o.pop()??``;for(let e of o)Le(e,t)}Le(i,t)}function Le(e,t){if(e.trim())try{t(JSON.parse(e))}catch{t({type:`stderr`,text:e})}}function Re(e){let t=e.trim();if(!t)return null;if(!t.startsWith(`{`))return{kind:`raw`,text:t};let n;try{n=JSON.parse(t)}catch{return{kind:`raw`,text:t}}if(n?.type===`system`)return null;if(n?.type===`assistant`&&Array.isArray(n?.message?.content)){let e=[];for(let t of n.message.content)t?.type===`text`&&typeof t.text==`string`&&t.text.trim()?e.push(t.text.trim()):t?.type===`tool_use`&&e.push(`· ${t.name??`tool`}${ze(t.input)}`);let t=e.join(`
+`);return t?{kind:e.every(e=>e.startsWith(`· `))?`tool`:`text`,text:t}:null}if(n?.type===`user`)return null;if(n?.type===`result`){let e=typeof n.result==`string`&&n.result.trim()?n.result.trim():null;return e?{kind:`result`,text:e}:null}if(n?.type===`item.completed`||n?.type===`item.started`){let e=n?.item;if(e?.type===`agent_message`&&typeof e.text==`string`&&e.text.trim())return n.type===`item.completed`?{kind:`text`,text:e.text.trim()}:null;if(e?.type===`command_execution`){if(n.type===`item.started`&&typeof e.command==`string`&&e.command.trim())return{kind:`tool`,text:`· Command ${e.command.trim()}`};if(n.type===`item.completed`){let t=typeof e.aggregated_output==`string`?e.aggregated_output.trim():``,n=typeof e.status==`string`?e.status:`completed`,r=`· Command ${(typeof e.command==`string`?e.command.trim():``)||n}`;return{kind:t?`result`:`tool`,text:t?`${r}\n${t}`:r}}}if(e?.type===`file_change`){let t=(Array.isArray(e.changes)?e.changes:[]).map(e=>e?.path).filter(e=>typeof e==`string`&&!!e);return{kind:`tool`,text:`· File change${t.length?` ${t.join(`, `)}`:``}`}}}return n?.type===`thread.started`||n?.type===`turn.started`||n?.type===`turn.completed`?null:typeof n?.type==`string`?{kind:`detail`,text:t}:{kind:`raw`,text:t}}function ze(e){if(!e||typeof e!=`object`)return``;let t=e,n=t.file_path??t.path??t.pattern??t.command;return typeof n==`string`&&n?` ${n}`:``}var Be=i(`<option> </option>`),Ve=i(`<span class="sketch svelte-1cqop5k" title="Open the sketch through the cascade CLI">no project file</span>`),He=i(`<button type="button" class="zoom svelte-1cqop5k" title="Text size — click to reset (⌘0)"> </button>`),Ue=i(`<button type="button" class="icon svelte-1cqop5k" title="Copy the whole transcript, including hidden stream events" aria-label="Copy transcript"> </button>`),We=i(`<button type="button" class="icon stop svelte-1cqop5k" title="Stop the agent" aria-label="Stop the agent">■</button>`),Ge=i(`<button type="button" title="Forget the conversation for this sketch" class="svelte-1cqop5k">Reset</button>`),Ke=i(`<div class="notice svelte-1cqop5k"> </div>`),qe=i(`<code class="svelte-1cqop5k"> </code>`),Je=i(`<div class="notice svelte-1cqop5k"><div> </div> <!></div>`),Ye=i(`<div class="hint svelte-1cqop5k"><!></div>`),Xe=i(`<div></div>`),Ze=i(`<div> </div>`),Qe=i(`<button class="detail-toggle svelte-1cqop5k"> </button>`),$e=i(`<span class="svelte-1cqop5k"> </span>`),et=i(`<div data-panel-scope="agent" role="group" aria-label="Agent console"><div class="bar svelte-1cqop5k"><select aria-label="Agent" class="svelte-1cqop5k"></select> <!> <span class="spacer svelte-1cqop5k"></span> <!> <!> <!></div> <!> <div class="transcript svelte-1cqop5k"><!> <!> <!></div> <div class="composer svelte-1cqop5k"><div class="composer-context svelte-1cqop5k"><button type="button">Use selected node</button> <!></div> <div class="composer-row svelte-1cqop5k"><textarea rows="2" spellcheck="false" placeholder="Prompt the sketch" class="svelte-1cqop5k"></textarea> <button type="button" class="send svelte-1cqop5k" title="Send (⌘↵)" aria-label="Send prompt">↑</button></div></div></div>`);function tt(i,w){ee(w,!1);let T=()=>ye(xe,`$sharedContextStore`,ke),[ke,Ae]=ge(),E=p(),D=p(),O=p(),k=p(),A=p(),Le=p(),ze=new Set([`agent`,`result`]),tt=[`claude`,`codex`],j=p(`claude`),M=p(``),N=p([]),P=p(!1),F=p(!1),I=p([]),nt=p(``),L=p(null),rt=p(!1),R=null,z=null,it=null,at=null,B=p(!1),V=p(null),H=p(null),U=p(!1),W=p(null),G=p(!1);fe(()=>Ee.subscribe(t=>{t.length!==0&&(b(M,be(c(M),Se())),e().then(()=>{_t(),c(H)?.focus()}))}));let ot=`cascade.agentPanel.zoom`,K=[.75,.85,1,1.15,1.3,1.5,1.75,2],q=p(st());function st(){try{let e=Number(localStorage.getItem(ot));return K.includes(e)?e:1}catch{return 1}}function ct(e){b(q,e);try{localStorage.setItem(ot,String(e))}catch{}}function lt(e){let t=K.indexOf(c(q)),n=t===-1?K.indexOf(1):t,r=Math.min(K.length-1,Math.max(0,n+e));r!==n&&ct(K[r])}function ut(e){if(e.altKey)return;let t=e.metaKey||e.ctrlKey;if(!c(W)||!we(`agent`))return;let n=e.target instanceof HTMLTextAreaElement||e.target instanceof HTMLInputElement;!t&&n||(e.key===`0`?(e.preventDefault(),ct(1)):e.key===`+`||e.key===`=`?(e.preventDefault(),lt(1)):(e.key===`-`||e.key===`_`)&&(e.preventDefault(),lt(-1)))}let J=p(S()?.file()??null),dt=[];fe(()=>{ht(c(J));let e=Me({onSessions:e=>{dt=e,gt()}}),t=setInterval(()=>{let e=S()?.file()??null;e===c(J)?!c(F)&&at!==c(j)?ht(e):gt():(b(J,e),ht(e))},1e3);return()=>{clearInterval(t),e()}}),ft();async function ft(){try{let e=await je(c(J)??void 0);if(b(I,e.agents),b(nt,e.root),!c(I).find(e=>e.alias===c(j)&&e.configured&&e.resolved)){let e=c(I).find(e=>e.configured&&e.resolved);e&&b(j,e.alias)}}catch(e){b(L,e instanceof Error?e.message:String(e))}finally{b(rt,!0)}}function pt(e){if(e.type===`attached`)b(B,e.running),e.running||mt(),e.dropped>0&&Y(`system`,`${e.dropped} earlier ${e.dropped===1?`line`:`lines`} were dropped from the server's buffer.`),e.running?Y(`system`,`Reconnected to the ${e.agent} session running for ${e.sketch}.`):e.replayed>0&&Y(`system`,`Showing the last ${e.agent} run for ${e.sketch}. Nothing is running now.`);else if(e.type===`started`)b(B,!0),Y(`system`,`${e.agent} ${e.resumed?`resumed`:`started`} for ${e.sketch}`);else if(e.type===`stdout`){let t=Re(e.text);t&&Y(t.kind===`raw`?`system`:t.kind===`text`?`agent`:t.kind,t.text)}else e.type===`stderr`?Y(`error`,e.text.trimEnd()):e.type===`exit`?(b(B,!1),mt(),e.cancelled?Y(`system`,`Stopped.`):e.timedOut?Y(`error`,`The agent was still running after 15 minutes and was stopped.`):e.code!==0&&Y(`error`,`${c(j)} exited with code ${e.code}.`)):e.type===`error`&&(b(B,!1),mt(),Y(`error`,e.message))}function mt(){dt=dt.map(e=>e.sketch===c(J)&&e.agent===c(j)?{...e,running:!1}:e)}async function ht(e){if(z?.abort(),z=null,it=e,at=c(j),b(B,!1),c(F)||(b(N,[]),!e))return;let t=new AbortController;z=t;try{await Fe({agent:c(j),sketch:e,onEvent:t=>{it===e&&pt(t)},signal:t.signal})}catch(e){e?.name!==`AbortError`&&Y(`error`,e instanceof Error?e.message:String(e))}finally{z===t&&(z=null),b(B,!1)}}async function gt(){c(F)||c(B)||z||!c(J)||c(L)||dt.find(e=>e.sketch===c(J)&&e.agent===c(j)&&e.running)&&await ht(c(J))}function Y(e,t){t.trim()&&(b(N,[...c(N),{kind:e,text:t}]),vt())}function _t(){if(!c(H))return;oe(H,c(H).style.height=`auto`);let e=Math.max(120,Math.round((c(V)?.clientHeight??400)/2));oe(H,c(H).style.height=`${Math.min(c(H).scrollHeight,e)}px`)}async function vt(){await e(),c(V)&&oe(V,c(V).scrollTop=c(V).scrollHeight)}async function yt(){let e=S();if(!e)return Y(`error`,`Studio has not registered the open document, so it cannot be saved before the prompt runs. Nothing was sent.`),null;let t=e.file();if(!t)return Y(`error`,"This graph is not a project file, so the agent has nothing to edit. Open the sketch through the `cascade` CLI, or save it into the project first."),null;if(e.isDirty()){if(!await e.save())return Y(`error`,`Could not save ${t}, so the prompt was not sent — the agent would have rewritten the file underneath your unsaved changes.`),null;Y(`system`,`Saved ${t} before handing the prompt over.`)}return t}async function bt(){let t=c(M).trim();if(!t||c(F))return;let n=await yt();if(!n)return;let r=c(G)?De(T()):null,i=Ce(n,t,r);z?.abort(),z=null,Y(`you`,t),b(M,``),e().then(_t),b(F,!0),R=new AbortController;try{await Ie({agent:c(j),sketch:n,prompt:i,signal:R.signal,onEvent:pt})}catch(e){e instanceof C?(Y(`error`,e.message),e.hint&&Y(`system`,e.hint)):e?.name===`AbortError`?Y(`system`,`Stopped.`):Y(`error`,e instanceof Error?e.message:String(e))}finally{b(F,!1),R=null,b(B,!1)}}async function xt(){let e=c(J)??S()?.file()??null;e&&await Ne(c(j),e),R?.abort(),z?.abort()}async function St(){let e=S()?.file();z?.abort(),z=null,e&&await Pe(c(j),e),b(N,[]),b(B,!1),Y(`system`,`New ${c(j)} session for ${e??`this sketch`}.`)}function Ct(e){e.key===`Enter`&&(e.metaKey||e.ctrlKey||!e.shiftKey)&&(e.preventDefault(),bt())}function wt(e){let t=e.dataTransfer?.getData(`text/plain`);b(U,!1),t&&(e.preventDefault(),e.stopPropagation(),At(t.trim()))}function Tt(e){let t=Array.from(e.dataTransfer?.types??[]);!t.includes(`text/plain`)||t.includes(`Files`)||(e.preventDefault(),e.stopPropagation(),e.dataTransfer&&(e.dataTransfer.dropEffect=`copy`),b(U,!0))}function Et(e){if(!c(W)){b(U,!1);return}let t=c(W).getBoundingClientRect();e.clientX>=t.left&&e.clientX<=t.right&&e.clientY>=t.top&&e.clientY<=t.bottom||b(U,!1)}let Dt=p(!1),Ot;async function kt(){let e=c(N).map(e=>e.text).join(`
+`);if(await Te(e)){b(Dt,!0),clearTimeout(Ot),Ot=setTimeout(()=>b(Dt,!1),1200);return}Y(`error`,`Could not reach the clipboard. Select the transcript and copy it by hand.`)}function At(t){if(!t)return;let n=c(H)?.selectionStart??c(M).length,r=c(M).slice(0,n),i=c(M).slice(n),a=r&&!/\s$/.test(r)?` `:``;b(M,`${r}${a}${t}${i}`),e().then(()=>{c(H)?.focus();let e=(r+a+t).length;c(H)?.setSelectionRange(e,e)})}le(()=>{R?.abort(),z?.abort(),clearTimeout(Ot)}),v(()=>T(),()=>{b(E,T()?.selectedNode??null)}),v(()=>c(E),()=>{c(E)||b(G,!1)}),v(()=>(c(I),c(j)),()=>{b(D,c(I).find(e=>e.alias===c(j))??null)}),v(()=>(c(F),c(B)),()=>{b(O,c(F)||c(B))}),v(()=>(c(rt),c(D)),()=>{b(k,!c(rt)||!!(c(D)?.configured&&c(D)?.resolved))}),v(()=>c(N),()=>{b(A,c(N).filter(e=>e.kind===`detail`).length)}),v(()=>(c(P),c(N)),()=>{b(Le,c(P)?c(N):c(N).filter(e=>e.kind!==`detail`))}),pe(),ce();var X=et();d(`keydown`,ae,ut),d(`dragend`,ae,()=>b(U,!1));let jt;var Mt=y(X),Z=y(Mt);a(Z,5,()=>tt,o,(e,t)=>{var n=Be(),r=f(n,!0),i={};h(()=>{u(r,c(t)),i!==(i=c(t))&&(n.value=(n.__value=i)??``)}),l(e,n)}),g(Z),te(Z);var Nt=_(Z,2),Pt=e=>{var t=Ve();l(e,t)};x(Nt,e=>{c(J)||e(Pt)});var Ft=_(Nt,4),It=e=>{var t=He(),n=f(t);h(e=>u(n,`${e??``}%`),[()=>(c(q),m(()=>Math.round(c(q)*100)))]),d(`click`,t,()=>ct(1)),l(e,t)};x(Ft,e=>{c(q)!==1&&e(It)});var Lt=_(Ft,2),Rt=e=>{var t=Ue(),n=f(t,!0);h(()=>u(n,c(Dt)?`✓`:`⧉`)),d(`click`,t,kt),l(e,t)};x(Lt,e=>{c(N),m(()=>c(N).length>0)&&e(Rt)});var zt=_(Lt,2),Bt=e=>{var t=We();d(`click`,t,xt),l(e,t)},Vt=e=>{var t=Ge();d(`click`,t,St),l(e,t)};x(zt,e=>{c(O)?e(Bt):e(Vt,-1)}),g(Mt);var Ht=_(Mt,2),Ut=e=>{var t=Ke(),n=f(t,!0);h(()=>u(n,c(L))),l(e,t)},Wt=e=>{var t=Je(),n=y(t),r=f(n,!0),i=_(n,2),a=e=>{var t=qe(),n=f(t);h(()=>u(n,`"commands": { "${c(j)??``}": "<path>" }`)),l(e,t)};x(i,e=>{c(nt),c(D),m(()=>c(nt)&&!c(D)?.configured)&&e(a)}),g(t),h(()=>u(r,(c(D),c(j),m(()=>c(D)?.hint??`Command "${c(j)}" is not allowed.`)))),l(e,t)};x(Ht,e=>{c(L)?e(Ut):c(rt)&&!c(k)&&e(Wt,1)});var Gt=_(Ht,2),Kt=y(Gt),qt=e=>{var t=Ye(),n=y(t),r=e=>{var t=de(`No project file is open, so there is nothing for an agent to edit.`);l(e,t)},i=e=>{var t=de(`Say what the sketch should become. Drag in a node or a parameter for its exact path.`);l(e,t)};x(n,e=>{c(J)?e(i,-1):e(r)}),g(t),l(e,t)};x(Kt,e=>{c(N),m(()=>c(N).length===0)&&e(qt)});var Jt=_(Kt,2);a(Jt,1,()=>c(Le),o,(e,t)=>{var n=ne(),i=me(n),a=e=>{var n=Xe();r(n,()=>(re(Oe),c(t),m(()=>Oe(c(t).text))),!0),g(n),h(()=>s(n,1,`entry ${c(t),m(()=>c(t).kind)??``} markdown`,`svelte-1cqop5k`)),l(e,n)},o=se(()=>(c(t),m(()=>ze.has(c(t).kind)))),ee=e=>{var n=Ze(),r=f(n,!0);h(()=>{s(n,1,`entry ${c(t),m(()=>c(t).kind)??``}`,`svelte-1cqop5k`),u(r,(c(t),m(()=>c(t).text)))}),l(e,n)};x(i,e=>{c(o)?e(a):e(ee,-1)}),l(e,n)});var Yt=_(Jt,2),Xt=e=>{var t=Qe(),n=f(t);h(()=>u(n,`${c(P)?`Hide`:`Show`} ${c(A)??``} stream ${c(A)===1?`event`:`events`}`)),d(`click`,t,()=>b(P,!c(P))),l(e,t)};x(Yt,e=>{c(A)>0&&e(Xt)}),g(Gt),ue(Gt,e=>b(V,e),()=>c(V));var Zt=_(Gt,2),Qt=y(Zt),Q=y(Qt);let $t;var en=_(Q,2),tn=e=>{var t=$e(),n=f(t,!0);h(()=>u(n,(c(E),m(()=>c(E).id)))),l(e,t)};x(en,e=>{c(G)&&c(E)&&e(tn)}),g(Qt);var nn=_(Qt,2),$=y(nn);ie($),ue($,e=>b(H,e),()=>c(H));var rn=_($,2);g(nn),g(Zt),g(X),ue(X,e=>b(W,e),()=>c(W)),h(e=>{jt=s(X,1,`console svelte-1cqop5k`,null,jt,{"drop-active":c(U)}),t(X,`--agent-zoom: ${c(q)??``}`),Z.disabled=c(O),ve(Q,`aria-pressed`,c(G)),Q.disabled=!c(E)||c(O),$t=s(Q,1,`svelte-1cqop5k`,null,$t,{active:c(G)}),$.disabled=c(O),rn.disabled=e},[()=>(c(O),c(M),c(k),m(()=>c(O)||!c(M).trim()||!c(k)))]),_e(Z,()=>c(j),e=>b(j,e)),d(`click`,Q,()=>b(G,!c(G))),he($,()=>c(M),e=>b(M,e)),d(`keydown`,$,Ct),d(`input`,$,_t),d(`click`,rn,bt),d(`dragover`,X,Tt),d(`dragleave`,X,Et),d(`drop`,X,wt),l(i,X),n(),Ae()}export{tt as default};