aigpu 0.3.1

package/dist/visibility.d.ts

@@ -0,0 +1,118 @@
+import type { Device } from "@aigpu/core";
+import { FRAME_PASS_ATTACHMENT, type FramePassAttachContext, type FramePassAttachResult } from "./frame-protocols.ts";
+import type { Gpu } from "./kernel.ts";
+import { type QueryHostOptions } from "./query-ring.ts";
+export interface VisibilityOptions {
+    /** Query slots. Max 4096 (WebGPU fixed limit). Default 64. */
+    readonly capacity?: number;
+}
+/** Latched result state of a visibility query: `"hidden"` only after a completed query confirmed zero passing samples. */
+export type VisibilityState = "visible" | "hidden" | "unknown";
+/**
+ * Occlusion query results for visibility culling, created by `visibility(gpu)`.
+ * Core WebGPU — no device feature required. Pass the instance as
+ * `FramePassOptions.visibility`, wrap proxy draws in `pass.occlusion(handle, body)`,
+ * and condition real draws on `handle.hidden`.
+ */
+export interface Visibility {
+    /** Stable handle, created once outside the loop. Duplicate label → AIGPU-VIS-LABEL-DUPLICATE. */
+    query(label: string): VisibilityQuery;
+    /** Camera cut / teleport: all results become "unknown". */
+    reset(): void;
+    dispose(): void;
+}
+export interface VisibilityQuery {
+    readonly label: string;
+    /** true ONLY when a completed query confirmed zero passing samples (and no reset since). "unknown" and "visible" are false: the safe default is to draw. Stable for the duration of a frame. */
+    readonly hidden: boolean;
+    readonly state: "visible" | "hidden" | "unknown";
+    /** Frames since the last applied result; Infinity if none yet. */
+    readonly age: number;
+    reset(): void;
+    dispose(): void;
+}
+/** @internal */
+export declare function createVisibility(device: Device, options?: VisibilityOptions, frameCounter?: () => number, host?: QueryHostOptions): Visibility;
+/**
+ * Occlusion query results for visibility culling. Core WebGPU — no device feature required. Pass the
+ * instance as `FramePassOptions.visibility`, wrap proxy draws in `pass.occlusion(handle, body)` and
+ * condition the real draw on `handle.hidden`.
+ *
+ * `VisibilityQuery.age` counts frames through the kernel's frame state, which is created on demand:
+ * a program that never opens a frame keeps reading age `Infinity` instead of paying for the clock.
+ * The instance goes down with `gpu.dispose()` (resource phase) or earlier with `visibility.dispose()`.
+ */
+export declare function visibility(gpu: Gpu, options?: VisibilityOptions): Visibility;
+declare class InternalVisibilityQuery implements VisibilityQuery {
+    #private;
+    readonly label: string;
+    readonly owner: InternalVisibility;
+    constructor(label: string, owner: InternalVisibility);
+    get hidden(): boolean;
+    get state(): VisibilityState;
+    get age(): number;
+    reset(): void;
+    dispose(): void;
+    /** @internal */
+    get disposed(): boolean;
+    /** @internal Generation captured at slot allocation; results only apply when it still matches. */
+    get generation(): number;
+    /** @internal Called from the ring's apply closure, async between frames — the only state write besides reset(). */
+    applyResult(value: bigint, generation: number, frame: number): void;
+}
+/**
+ * Ring-1 occlusion query facade. Owns label→handle bookkeeping, contiguous
+ * per-frame slot allocation (slot order = allocation order, reset each frame),
+ * and result latching into handles; the query set + resolve/readback plumbing
+ * lives in the shared query ring. Capacity is a declared contract — the query
+ * set is bound to pass descriptors mid-frame, so it never grows.
+ *
+ * @internal
+ */
+export declare class InternalVisibility {
+    #private;
+    readonly capacity: number;
+    constructor(device: Device, options: VisibilityOptions, frameCounter: () => number, host?: QueryHostOptions);
+    query(label: string): VisibilityQuery;
+    reset(): void;
+    dispose(): void;
+    /** @internal */
+    get disposed(): boolean;
+    /** @internal */
+    currentFrame(): number;
+    /**
+     * @internal Label-reuse rule: a disposed handle's label is freed immediately. This is safe
+     * because in-flight readbacks resolve results through handle *object references* captured
+     * per frame — never by label lookup — and a disposed handle's applyResult is a no-op, so a
+     * new same-label handle can never observe the old handle's stale results.
+     */
+    releaseLabel(query: InternalVisibilityQuery): void;
+    /** @internal Pass descriptor's occlusionQuerySet: one "occlusion"-type set owned by the shared ring. */
+    get querySet(): GPUQuerySet;
+    /**
+     * Frame pass attachment: validates that the pass can host occlusion queries at all, joins the
+     * frame's bookkeeping and hands back the query source `FramePass.occlusion()` allocates from.
+     *
+     * The depth check lives here, not in the frame: without depth testing an occlusion query passes
+     * for anything rasterized, so it always reports "visible" — useless for culling, and only this
+     * attachment knows that rule.
+     */
+    [FRAME_PASS_ATTACHMENT](ctx: FramePassAttachContext): FramePassAttachResult;
+    /** @internal Frame.pass hook: validates the gpu match and (re)starts per-frame slot allocation. */
+    attachFrame(frame: unknown, frameDevice: Device): void;
+    /** @internal FramePass.occlusion hook: validates the handle and allocates this frame's next contiguous slot. */
+    beginQuery(query: VisibilityQuery, frame: unknown): number;
+    /** @internal Frame.submit hook, before encoder.finish(): appends this frame's single resolve to the frame encoder. */
+    finalizeFrame(frame: unknown, encoder: GPUCommandEncoder): void;
+    /** @internal Frame.submit hook, after queue.submit succeeds: starts the non-blocking readback. */
+    frameSubmitted(frame: unknown): void;
+    /**
+     * @internal Frame abandon hook (a failed pass, a failed finish/submit, or Frame.cancel()): the
+     * frame ends without ever reaching the queue. Drops the pending encoded state so no readback can
+     * decode stale staging bytes as a phantom "hidden", and releases the retain this frame took when
+     * it opened a visibility pass — the counterpart of frameSubmitted() for frames that never submit.
+     */
+    frameAbandoned(frame: unknown): void;
+}
+export {};
+//# sourceMappingURL=visibility.d.ts.map

package/dist/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../src/visibility.ts"],"names":[],"mappings":"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"}

package/dist/visibility.js

@@ -0,0 +1,290 @@
+import { queryDuplicateError, visibilityCapacityError, visibilityCapacityLimitError, visibilityDisposedError, visibilityInvalidError, visibilityLabelDuplicateError, visibilityNoDepthError } from "./errors.js";
+import { FRAME_PASS_ATTACHMENT } from "./frame-protocols.js";
+import { frameState } from "./frame-state.js";
+import { liveKernel, ownQueryFeature } from "./live-kernel.js";
+import { createQueryRing } from "./query-ring.js";
+/** WebGPU createQuerySet: "descriptor.count must be ≤ 4096" — a fixed constant, not a device limit. */
+const MAX_QUERIES = 4096;
+const DEFAULT_CAPACITY = 64;
+/** @internal */
+export function createVisibility(device, options = {}, frameCounter = () => 0, host = {}) {
+    return new InternalVisibility(device, options, frameCounter, host);
+}
+/**
+ * Occlusion query results for visibility culling. Core WebGPU — no device feature required. Pass the
+ * instance as `FramePassOptions.visibility`, wrap proxy draws in `pass.occlusion(handle, body)` and
+ * condition the real draw on `handle.hidden`.
+ *
+ * `VisibilityQuery.age` counts frames through the kernel's frame state, which is created on demand:
+ * a program that never opens a frame keeps reading age `Infinity` instead of paying for the clock.
+ * The instance goes down with `gpu.dispose()` (resource phase) or earlier with `visibility.dispose()`.
+ */
+export function visibility(gpu, options = {}) {
+    const kernel = liveKernel(gpu, "visibility");
+    return ownQueryFeature(kernel, (host) => new InternalVisibility(kernel.device, options, () => frameState(kernel).frameCount, host));
+}
+class InternalVisibilityQuery {
+    label;
+    owner;
+    #state = "unknown";
+    /** clock(gpu).frameCount stamped when the last result applied; age = frameCount - stamp. */
+    #resultFrame;
+    /** Reset generation: results captured before a reset() carry a stale generation and are discarded at apply. */
+    #generation = 0;
+    #disposed = false;
+    constructor(label, owner) {
+        this.label = label;
+        this.owner = owner;
+    }
+    get hidden() { return this.#state === "hidden"; }
+    get state() { return this.#state; }
+    get age() { return this.#resultFrame === undefined ? Infinity : this.owner.currentFrame() - this.#resultFrame; }
+    reset() {
+        if (this.#disposed)
+            throw visibilityDisposedError("query handle", "VisibilityQuery.reset");
+        this.#state = "unknown";
+        this.#resultFrame = undefined;
+        // In-flight readbacks from pre-reset frames captured the previous generation; apply discards them.
+        this.#generation += 1;
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#state = "unknown";
+        this.#resultFrame = undefined;
+        this.owner.releaseLabel(this);
+    }
+    /** @internal */
+    get disposed() { return this.#disposed; }
+    /** @internal Generation captured at slot allocation; results only apply when it still matches. */
+    get generation() { return this.#generation; }
+    /** @internal Called from the ring's apply closure, async between frames — the only state write besides reset(). */
+    applyResult(value, generation, frame) {
+        if (this.#disposed || generation !== this.#generation)
+            return;
+        // WebGPU occlusion semantics are zero vs non-zero ONLY: "a value of 0 indicates that no samples passed;
+        // any other value is unspecified". Never expose the value as a count.
+        this.#state = value !== 0n ? "visible" : "hidden";
+        this.#resultFrame = frame;
+    }
+}
+/**
+ * Ring-1 occlusion query facade. Owns label→handle bookkeeping, contiguous
+ * per-frame slot allocation (slot order = allocation order, reset each frame),
+ * and result latching into handles; the query set + resolve/readback plumbing
+ * lives in the shared query ring. Capacity is a declared contract — the query
+ * set is bound to pass descriptors mid-frame, so it never grows.
+ *
+ * @internal
+ */
+export class InternalVisibility {
+    #device;
+    #frameCounter;
+    #host;
+    #ring;
+    capacity;
+    /** Live (not disposed) handles by label. */
+    #queries = new Map();
+    #frame;
+    #frameEntries = [];
+    #frameUsed = new Set();
+    #encodedEntries;
+    /**
+     * One retain per open frame whose pass descriptors reference the ring's query set, keyed by frame
+     * identity. Released only when that frame reports back — submitted, failed or abandoned — because
+     * nothing else proves the frame's encoder is done with the query set: age does not (a Frame held
+     * for many frames can still be submitted), so a Frame the caller drops without submit() keeps its
+     * retain until gpu.dispose() or device loss, like a native encoder that never finishes.
+     */
+    #frameRetains = new Map();
+    #disposed = false;
+    constructor(device, options, frameCounter, host = {}) {
+        const capacity = options.capacity ?? DEFAULT_CAPACITY;
+        if (typeof capacity !== "number" || !Number.isInteger(capacity) || capacity < 1 || capacity > MAX_QUERIES) {
+            throw visibilityCapacityLimitError(capacity, MAX_QUERIES);
+        }
+        this.#device = device;
+        this.#frameCounter = frameCounter;
+        this.#host = host;
+        this.capacity = capacity;
+        this.#ring = createQueryRing(device, { type: "occlusion", capacity, label: "aigpu.visibility", trackSettled: host.trackSettled, errorSink: host.errorSink });
+    }
+    query(label) {
+        this.#assertUsable("Visibility.query");
+        if (typeof label !== "string" || label.length === 0) {
+            throw visibilityInvalidError(`query label received ${previewLabel(label)}; expected a non-empty string.`, `Label each queried object, e.g. vis.query("statue").`, "Visibility.query");
+        }
+        if (this.#queries.has(label))
+            throw visibilityLabelDuplicateError(label);
+        const query = new InternalVisibilityQuery(label, this);
+        this.#queries.set(label, query);
+        return query;
+    }
+    reset() {
+        this.#assertUsable("Visibility.reset");
+        for (const query of this.#queries.values())
+            query.reset();
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#queries.clear();
+        this.#frameEntries = [];
+        this.#frameUsed.clear();
+        this.#encodedEntries = undefined;
+        // The ring defers its destruction while the current frame still references the query set from a
+        // pass descriptor (released at frameSubmitted or at the next frame boundary).
+        this.#ring.dispose();
+        this.#host.onDispose?.();
+    }
+    /** @internal */
+    get disposed() { return this.#disposed; }
+    /** @internal */
+    currentFrame() { return this.#frameCounter(); }
+    /**
+     * @internal Label-reuse rule: a disposed handle's label is freed immediately. This is safe
+     * because in-flight readbacks resolve results through handle *object references* captured
+     * per frame — never by label lookup — and a disposed handle's applyResult is a no-op, so a
+     * new same-label handle can never observe the old handle's stale results.
+     */
+    releaseLabel(query) {
+        if (this.#queries.get(query.label) === query)
+            this.#queries.delete(query.label);
+    }
+    /** @internal Pass descriptor's occlusionQuerySet: one "occlusion"-type set owned by the shared ring. */
+    get querySet() { return this.#ring.querySet; }
+    /**
+     * Frame pass attachment: validates that the pass can host occlusion queries at all, joins the
+     * frame's bookkeeping and hands back the query source `FramePass.occlusion()` allocates from.
+     *
+     * The depth check lives here, not in the frame: without depth testing an occlusion query passes
+     * for anything rasterized, so it always reports "visible" — useless for culling, and only this
+     * attachment knows that rule.
+     */
+    [FRAME_PASS_ATTACHMENT](ctx) {
+        if (!ctx.target.depth)
+            throw visibilityNoDepthError();
+        this.attachFrame(ctx.frame, ctx.device);
+        return {
+            owner: this,
+            occlusion: { querySet: this.querySet, beginQuery: (query, frame) => this.beginQuery(query, frame) },
+        };
+    }
+    /** @internal Frame.pass hook: validates the gpu match and (re)starts per-frame slot allocation. */
+    attachFrame(frame, frameDevice) {
+        this.#assertUsable("Frame.pass");
+        if (frameDevice !== this.#device) {
+            throw visibilityInvalidError("the visibility instance belongs to a different gpu; occlusion queries cannot cross devices.", "Create one visibility(gpu) per gpu and use it only with that gpu's frames.", "Frame.pass");
+        }
+        if (frame !== this.#frame)
+            this.#beginFrame(frame);
+        // The pass descriptor's occlusionQuerySet references the ring's query set for the rest of the frame:
+        // keep the ring alive even if dispose() lands mid-frame. The retain is per frame, so a second
+        // frame opened while this one is still unsubmitted cannot release it — both keep the set alive
+        // until each of them is submitted or abandoned.
+        this.#retainRing(frame);
+    }
+    /** @internal FramePass.occlusion hook: validates the handle and allocates this frame's next contiguous slot. */
+    beginQuery(query, frame) {
+        this.#assertUsable("FramePass.occlusion");
+        if (!(query instanceof InternalVisibilityQuery)) {
+            throw visibilityInvalidError(`occlusion() received ${previewLabel(query)}; expected a VisibilityQuery from vis.query(label).`, `Create const q = vis.query("label") once from the pass's visibility instance, then p.occlusion(q, body).`, "FramePass.occlusion");
+        }
+        if (query.owner !== this) {
+            throw visibilityInvalidError(`query '${query.label}' belongs to a different visibility instance than the one this pass was opened with.`, "Use handles from the same visibility(gpu) instance passed as the pass's visibility option.", "FramePass.occlusion");
+        }
+        if (query.disposed)
+            throw visibilityDisposedError("query handle", "FramePass.occlusion");
+        if (frame !== this.#frame) {
+            throw visibilityInvalidError("the pass is not part of the current frame; occlusion() must run inside the frame that opened the pass.", "Encode occlusion scopes inside the pass callback of the current frame(gpu).", "FramePass.occlusion");
+        }
+        // Duplicate use is forbidden across passes too: cross-pass reuse of a query index silently
+        // overwrites the earlier result in native WebGPU, so aigpu rejects it up front.
+        if (this.#frameUsed.has(query))
+            throw queryDuplicateError(query.label);
+        const index = this.#frameEntries.length;
+        if (index >= this.capacity)
+            throw visibilityCapacityError(this.capacity);
+        this.#frameUsed.add(query);
+        this.#frameEntries.push({ query, generation: query.generation });
+        return index;
+    }
+    /** @internal Frame.submit hook, before encoder.finish(): appends this frame's single resolve to the frame encoder. */
+    finalizeFrame(frame, encoder) {
+        this.#encodedEntries = undefined;
+        if (this.#disposed || frame !== this.#frame || this.#frameEntries.length === 0)
+            return;
+        if (this.#ring.encodeResolve(encoder, this.#frameEntries.length))
+            this.#encodedEntries = [...this.#frameEntries];
+    }
+    /** @internal Frame.submit hook, after queue.submit succeeds: starts the non-blocking readback. */
+    frameSubmitted(frame) {
+        // Release *this* frame's retain first: the command buffer is submitted (or the frame was
+        // abandoned), so nothing it encoded references the query set anymore, and a dispose() that
+        // landed mid-frame can now destroy the ring. Runs before the identity check so a frame that is
+        // no longer the current one — another frame was opened meanwhile — still releases.
+        this.#releaseRing(frame);
+        // Results stay identity-scoped: only the current frame's encoded resolve is read back.
+        if (frame !== this.#frame)
+            return;
+        if (this.#disposed)
+            return;
+        const entries = this.#encodedEntries;
+        this.#encodedEntries = undefined;
+        if (!entries || entries.length === 0)
+            return;
+        this.#ring.onSubmitted((values) => {
+            // Latch contract: handle state only changes here (async, between frames) and via reset(),
+            // so reads during a frame callback are stable. The ring already applies readbacks in order.
+            if (this.#disposed)
+                return;
+            const frameStamp = this.#frameCounter();
+            for (let index = 0; index < entries.length; index++) {
+                const entry = entries[index];
+                const value = values[index];
+                // hidden must be *confirmed* zero: a missing value never downgrades to "hidden".
+                if (value !== undefined)
+                    entry.query.applyResult(value, entry.generation, frameStamp);
+            }
+        });
+    }
+    /**
+     * @internal Frame abandon hook (a failed pass, a failed finish/submit, or Frame.cancel()): the
+     * frame ends without ever reaching the queue. Drops the pending encoded state so no readback can
+     * decode stale staging bytes as a phantom "hidden", and releases the retain this frame took when
+     * it opened a visibility pass — the counterpart of frameSubmitted() for frames that never submit.
+     */
+    frameAbandoned(frame) {
+        if (frame === this.#frame)
+            this.#encodedEntries = undefined;
+        this.#releaseRing(frame);
+    }
+    #beginFrame(frame) {
+        this.#frame = frame;
+        this.#frameEntries = [];
+        this.#frameUsed.clear();
+    }
+    #retainRing(frame) {
+        if (this.#frameRetains.has(frame))
+            return;
+        this.#frameRetains.set(frame, this.#ring);
+        this.#ring.retain();
+    }
+    #releaseRing(frame) {
+        const ring = this.#frameRetains.get(frame);
+        if (!ring)
+            return;
+        this.#frameRetains.delete(frame);
+        ring.release();
+    }
+    #assertUsable(where) {
+        if (this.#disposed)
+            throw visibilityDisposedError("visibility", where);
+    }
+}
+function previewLabel(value) {
+    return typeof value === "string" ? `'${value}'` : String(value);
+}
+//# sourceMappingURL=visibility.js.map

package/dist/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../src/visibility.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,131 @@
+{
+  "name": "aigpu",
+  "version": "0.3.1",
+  "description": "GPU animations for AI agents: a small, explicit WebGPU and WGSL runtime.",
+  "keywords": [
+    "webgpu",
+    "graphics",
+    "rendering",
+    "aigpu",
+    "ai",
+    "agents",
+    "animation"
+  ],
+  "homepage": "https://github.com/hautlys/AIGpu",
+  "bugs": {
+    "url": "https://github.com/hautlys/AIGpu/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hautlys/AIGpu.git",
+    "directory": "packages/aigpu-api"
+  },
+  "license": "MIT",
+  "author": "Matias Gonzalez <matiasngf@hotmail.com>",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./mock": {
+      "types": "./dist/mock.d.ts",
+      "import": "./dist/mock.js",
+      "default": "./dist/mock.js"
+    },
+    "./scene": {
+      "types": "./dist/scene.d.ts",
+      "import": "./dist/scene.js",
+      "default": "./dist/scene.js"
+    },
+    "./client": {
+      "types": "./client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js",
+      "default": "./dist/core.js"
+    },
+    "./dom": {
+      "types": "./dist/dom.d.ts",
+      "import": "./dist/dom.js",
+      "default": "./dist/dom.js"
+    },
+    "./tools": {
+      "types": "./dist/agent-tools.d.ts",
+      "import": "./dist/agent-tools.js",
+      "default": "./dist/agent-tools.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "client.d.ts",
+    "bin",
+    "dist",
+    "!dist/tsconfig.tsbuildinfo",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.0.0",
+    "@webgpu/types": "^0.1.69",
+    "pixelmatch": "^7.2.0",
+    "pngjs": "^7.0.0",
+    "wgpu-matrix": "^3.4.2",
+    "zod": "^4.4.3",
+    "@aigpu/wgsl-std": "0.3.1",
+    "@aigpu/wgsl": "0.3.1",
+    "@aigpu/adapter-node": "0.3.1",
+    "@aigpu/core": "0.3.1",
+    "@aigpu/adapter-mock": "0.3.1"
+  },
+  "aigpuExportBundleBudgetNote": "Gzip ceilings use 512-byte granularity: each budget is the next 512-byte multiple strictly above the measured size. Regenerate with `pnpm bundle-check --update`. aigpuBundleAudience/aigpuExportBundleAudiences select the gate: \"client\" entries ship to browsers and fail on any byte over budget; \"tooling\" entries (loaders, Node runtime, CLI, package tarballs) only warn until growth passes aigpuBundleBudgetGrowthThreshold (default 5%). Tarballs measure published dist bytes with sourcemap sourcesContent stripped and *.docs.md excluded.",
+  "aigpuExportBundleAudiences": {
+    ".": "client",
+    "./node": "tooling",
+    "./mock": "tooling",
+    "./scene": "client",
+    "./client": "client",
+    "./core": "client",
+    "./dom": "client",
+    "./tools": "client"
+  },
+  "aigpuExportBundleBudgetsGzipBytes": {
+    ".": 40960,
+    "./node": 40960,
+    "./mock": 40960,
+    "./scene": 12800,
+    "./client": 512,
+    "./core": 3584,
+    "./dom": 28160,
+    "./tools": 5120
+  },
+  "bin": {
+    "aigpu": "./bin/aigpu.js"
+  },
+  "aigpuExperienceBundleBudgetsGzipBytes": {
+    "init-only": 1024,
+    "effect-only": 25600,
+    "triangle-low-level": 28672,
+    "draw-recipe-box": 30208,
+    "full-root": 41472
+  },
+  "aigpuSceneBundleBudgetNote": "The scene barrel retains all recipe builders after the geometry redesign; direct primitive imports retain only their selected mesh, as the experience fixtures assert.",
+  "scripts": {
+    "build": "tsc -b && node scripts/copy-cli.mjs",
+    "test": "cd ../.. && vitest run packages/aigpu-api"
+  }
+}