aigpu 0.3.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Vercel, Inc. (original vgpu portions)
+Copyright (c) 2026 AIGpu contributors (fork and modifications)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# aigpu
+
+AIGpu is an MIT-licensed TypeScript runtime for **GPU animations for AI agents**. It provides a small WebGPU API, typed WGSL modules, a deterministic mock, and an explicit bridge from orchestration state to pixels. It does not call a model, require an API key, or depend on a hosted control plane.
+
+## Install
+
+```sh
+pnpm add aigpu
+pnpm add -D @webgpu/types
+```
+
+## Agent animation
+
+```ts
+import { agentAnimation, clock, frameLoop, init, surface } from "aigpu";
+
+const gpu = await init();
+const output = surface(gpu, document.querySelector("canvas")!);
+const animation = agentAnimation(gpu, {
+  label: "researcher",
+  initial: { status: "thinking", progress: 0.1 },
+});
+const time = clock(gpu);
+
+frameLoop(gpu, (frame) => {
+  animation.tick(time.time);
+  frame.pass(output, animation.effect);
+});
+
+// Connect this to your own local model, queue, WebSocket, or event bus.
+animation.set({ status: "working", progress: 0.72, activity: 0.9 });
+```
+
+The built-in states are `idle`, `thinking`, `working`, `waiting`, `success`, and `error`. `progress` and `activity` are normalized to `[0, 1]`; colors are RGBA tuples. `animation.state` is a defensive snapshot, `reset()` restores the initial state, and `tick()` accepts an external clock for deterministic renders.
+
+## Framework-agnostic mounting
+
+Use `mountAgentCanvas()` or `mountAgentCanvasSelector()` for plain HTML/JavaScript. Optional lifecycle adapters are published separately as `@aigpu/react`, `@aigpu/vue`, and `@aigpu/svelte`; each delegates to the same `ready`/`set`/`resize`/`destroy` controller without adding a framework dependency to this package.
+
+For multi-agent state, import `createAgentStore`, `createAgentRegistry`, `recordAgentEvents`, and `replayAgentEvents` from `aigpu/tools`. These utilities are UI-, GPU-, transport-, and provider-agnostic.
+
+## Core runtime
+
+```ts
+import { draw, frame, init, target } from "aigpu/node";
+
+const gpu = await init();
+const output = target(gpu, { size: [256, 256], format: "rgba8unorm" });
+const triangle = draw(gpu, { shader: triangleShader });
+frame(gpu, (current) => current.pass(output, triangle));
+const pixels = await output.read();
+gpu.dispose();
+```
+
+The same API runs in the browser, headless Node through open Dawn bindings, and `aigpu/mock` for deterministic tests.
+
+## WGSL and tooling
+
+WGSL modules are plain text modules with typed imports and exports. Use `@aigpu/wgsl/loader-vite` or `@aigpu/wgsl/loader-webpack` with an open-source bundler, or use `@aigpu/wgsl/runtime` directly from Node. The bundled `@aigpu/cli` provides offline docs, shader checks, local example search/copy, diagnostics, and MCP stdio.
+
+```sh
+npx aigpu docs cat agentAnimation
+npx aigpu examples search "webgpu"
+npx aigpu examples pull agent-cockpit --out ./agent-cockpit
+npx aigpu check ./agent.wgsl --require-validation
+npx aigpu mcp
+```
+
+For the full reference, run `npx aigpu docs find <query>`. The catalog is read from the checkout's `examples/` directory or `AIGPU_EXAMPLES_DIR`; no network request is made.
+
+## Development
+
+```sh
+pnpm install
+pnpm build
+pnpm typecheck
+pnpm test:fast
+pnpm check:skill-drift
+```
+
+See the repository [CONTRIBUTING.md](https://github.com/hautlys/AIGpu/blob/main/CONTRIBUTING.md) for the local workflow.
+
+## License and provenance
+
+AIGpu is distributed under the MIT license. The repository preserves the original upstream copyright notice for the portions inherited from `vgpu` and identifies the fork changes in `NOTICE.md`.

package/bin/aigpu.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+
+const cliUrl = new URL("../dist/cli/bin/aigpu.js", import.meta.url);
+
+if (!existsSync(cliUrl)) {
+  process.stderr.write("aigpu CLI is not built. Run `pnpm build` before using it from a workspace checkout.\n");
+  process.exit(1);
+}
+
+const { runCli } = await import(cliUrl.href);
+const result = await Promise.resolve(runCli(process.argv.slice(2)));
+if (result.stdout) process.stdout.write(result.stdout);
+if (result.stderr) process.stderr.write(result.stderr);
+process.exitCode = result.code;

package/client.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="@webgpu/types" />
+
+declare module "aigpu/client" {
+  export interface AIGPUClientEnvironment {
+    readonly gpu?: GPU;
+  }
+
+  export { wgslVitePlugin } from "@aigpu/wgsl/loader-vite";
+  export type { ViteLoadResult, WgslVitePluginOptions } from "@aigpu/wgsl/loader-vite";
+}
+
+declare module "*.wgsl" {
+  const source: { readonly version: 1; readonly wgsl: string };
+  export default source;
+}

package/dist/agent-tools.d.ts

@@ -0,0 +1,61 @@
+import type { AgentAnimationPatch, AgentAnimationState, AgentStatus } from "./agent.ts";
+export type AgentEventType = "state" | "reset" | "progress" | "status";
+export interface AgentEvent {
+    readonly agentId?: string;
+    readonly type: AgentEventType;
+    readonly patch?: AgentAnimationPatch;
+    readonly at?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface AgentStoreSnapshot {
+    readonly revision: number;
+    readonly state: AgentAnimationPatch;
+}
+export type AgentStoreListener = (snapshot: AgentStoreSnapshot, event: AgentEvent) => void;
+export interface AgentStore {
+    readonly snapshot: AgentStoreSnapshot;
+    set(patch: AgentAnimationPatch, metadata?: Readonly<Record<string, unknown>>): this;
+    dispatch(event: AgentEvent): this;
+    reset(metadata?: Readonly<Record<string, unknown>>): this;
+    subscribe(listener: AgentStoreListener): () => void;
+    toJSON(): string;
+}
+/** Pure state bridge for any UI, transport, store, worker, or agent orchestrator. */
+export declare function createAgentStore(initial?: AgentAnimationPatch): AgentStore;
+export interface AgentRegistrySnapshot {
+    readonly revision: number;
+    readonly agents: Readonly<Record<string, AgentStoreSnapshot>>;
+}
+export interface AgentRegistry {
+    readonly snapshot: AgentRegistrySnapshot;
+    readonly ids: readonly string[];
+    ensure(id: string, initial?: AgentAnimationPatch): AgentStore;
+    get(id: string): AgentStore | undefined;
+    remove(id: string): boolean;
+    subscribe(listener: (snapshot: AgentRegistrySnapshot, event: AgentEvent) => void): () => void;
+}
+/** Multi-agent state registry with stable IDs and one subscription for dashboards. */
+export declare function createAgentRegistry(): AgentRegistry;
+export interface AgentEventRecorder {
+    readonly events: readonly AgentEvent[];
+    stop(): void;
+    clear(): void;
+    toJSON(pretty?: boolean): string;
+}
+/** Records a source of serializable agent events; works with any subscribe/unsubscribe contract. */
+export declare function recordAgentEvents(subscribe: (listener: (event: AgentEvent) => void) => () => void, options?: {
+    readonly now?: () => number;
+}): AgentEventRecorder;
+export interface AgentReplay {
+    play(): void;
+    pause(): void;
+    stop(): void;
+}
+/** Replays events using an injected scheduler, making timelines testable and UI-independent. */
+export declare function replayAgentEvents(events: readonly AgentEvent[], deliver: (event: AgentEvent) => void, options?: {
+    readonly speed?: number;
+    readonly setTimeout?: (cb: () => void, delay: number) => unknown;
+    readonly clearTimeout?: (handle: unknown) => void;
+}): AgentReplay;
+export type { AgentAnimationState, AgentStatus };
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/agent-tools.d.ts.map

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

package/dist/agent-tools.js

@@ -0,0 +1,107 @@
+/** Pure state bridge for any UI, transport, store, worker, or agent orchestrator. */
+export function createAgentStore(initial = {}) {
+    let state = freezePatch(initial);
+    let revision = 0;
+    const listeners = new Set();
+    const notify = (event) => {
+        const snapshot = { revision, state: freezePatch(state) };
+        for (const listener of [...listeners])
+            listener(snapshot, event);
+    };
+    const apply = (patch, event) => {
+        state = freezePatch({ ...state, ...patch, colors: patch.colors ? { ...(state.colors ?? {}), ...patch.colors } : state.colors });
+        revision += 1;
+        notify(event);
+    };
+    return {
+        get snapshot() { return { revision, state: freezePatch(state) }; },
+        set(patch, metadata) { apply(patch, { type: "state", patch, metadata }); return this; },
+        dispatch(event) {
+            if (event.type === "reset") {
+                state = freezePatch(initial);
+                revision += 1;
+                notify(event);
+            }
+            else if (event.patch)
+                apply(event.patch, event);
+            return this;
+        },
+        reset(metadata) { return this.dispatch({ type: "reset", metadata }); },
+        subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },
+        toJSON() { return JSON.stringify({ revision, state }); },
+    };
+}
+/** Multi-agent state registry with stable IDs and one subscription for dashboards. */
+export function createAgentRegistry() {
+    const stores = new Map();
+    const listeners = new Set();
+    let revision = 0;
+    const snapshot = () => ({ revision, agents: Object.fromEntries([...stores].map(([id, store]) => [id, store.snapshot])) });
+    const emit = (event) => { revision += 1; for (const listener of [...listeners])
+        listener(snapshot(), event); };
+    return {
+        get snapshot() { return snapshot(); },
+        get ids() { return [...stores.keys()]; },
+        ensure(id, initial = {}) {
+            if (!validId(id))
+                throw new TypeError("Agent IDs must be non-empty strings without control characters");
+            const existing = stores.get(id);
+            if (existing)
+                return existing;
+            const store = createAgentStore(initial);
+            store.subscribe((_next, event) => emit({ ...event, agentId: id }));
+            stores.set(id, store);
+            emit({ type: "state", agentId: id, patch: initial });
+            return store;
+        },
+        get: (id) => stores.get(id),
+        remove(id) { const removed = stores.delete(id); if (removed)
+            emit({ type: "reset", agentId: id }); return removed; },
+        subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },
+    };
+}
+/** Records a source of serializable agent events; works with any subscribe/unsubscribe contract. */
+export function recordAgentEvents(subscribe, options = {}) {
+    const events = [];
+    const now = options.now ?? (() => Date.now());
+    const unsubscribe = subscribe((event) => { events.push({ ...event, at: event.at ?? now() }); });
+    return { events, stop() { unsubscribe(); }, clear() { events.length = 0; }, toJSON(pretty = false) { return JSON.stringify(events, null, pretty ? 2 : 0); } };
+}
+/** Replays events using an injected scheduler, making timelines testable and UI-independent. */
+export function replayAgentEvents(events, deliver, options = {}) {
+    const speed = options.speed ?? 1;
+    if (!(speed > 0) || !Number.isFinite(speed))
+        throw new TypeError("replay speed must be a finite number greater than zero");
+    const schedule = options.setTimeout ?? ((cb, delay) => globalThis.setTimeout(cb, delay));
+    const cancel = options.clearTimeout ?? ((handle) => globalThis.clearTimeout(handle));
+    let index = 0;
+    let handle;
+    let playing = false;
+    const next = () => {
+        if (!playing || index >= events.length) {
+            playing = false;
+            return;
+        }
+        const event = events[index++];
+        deliver(event);
+        const current = event.at ?? 0;
+        const following = events[index]?.at ?? current;
+        handle = schedule(next, Math.max(0, (following - current) / speed));
+    };
+    return {
+        play() { if (!playing) {
+            playing = true;
+            next();
+        } },
+        pause() { playing = false; if (handle !== undefined)
+            cancel(handle); handle = undefined; },
+        stop() { playing = false; if (handle !== undefined)
+            cancel(handle); handle = undefined; index = 0; },
+    };
+}
+function validId(id) { return typeof id === "string" && id.trim().length > 0 && !/[\u0000-\u001F\u007F]/u.test(id); }
+function freezePatch(patch) {
+    const colors = patch.colors ? Object.freeze({ ...patch.colors }) : patch.colors;
+    return Object.freeze({ ...patch, ...(colors ? { colors } : {}) });
+}
+//# sourceMappingURL=agent-tools.js.map

package/dist/agent-tools.js.map

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

package/dist/agent.d.ts

@@ -0,0 +1,56 @@
+import { type Effect } from "./effect.ts";
+import type { Gpu } from "./kernel.ts";
+/** Visual states understood by the built-in agent animation shader. */
+export type AgentStatus = "idle" | "thinking" | "working" | "waiting" | "success" | "error";
+export type AgentColor = readonly [number, number, number, number];
+export interface AgentColors {
+    readonly accent: AgentColor;
+    readonly secondary: AgentColor;
+    readonly background: AgentColor;
+}
+export interface AgentAnimationState {
+    readonly status: AgentStatus;
+    readonly progress: number;
+    readonly activity: number;
+    readonly phase: number;
+    readonly speed: number;
+    readonly colors: AgentColors;
+}
+export interface AgentAnimationPatch {
+    readonly status?: AgentStatus;
+    /** Normalized task completion from 0 to 1. */
+    readonly progress?: number;
+    /** Normalized live activity from 0 to 1. */
+    readonly activity?: number;
+    /** Extra phase offset in radians. */
+    readonly phase?: number;
+    /** Pulse speed multiplier. */
+    readonly speed?: number;
+    readonly colors?: Partial<AgentColors>;
+}
+export interface AgentAnimationOptions {
+    readonly label?: string;
+    readonly initial?: AgentAnimationPatch;
+    readonly colors?: Partial<AgentColors>;
+}
+export interface AgentAnimation {
+    /** The fullscreen Effect to pass to frame.pass(). */
+    readonly effect: Effect;
+    /** A defensive snapshot of the current state. */
+    readonly state: AgentAnimationState;
+    /** Apply only the state fields that changed. */
+    set(patch: AgentAnimationPatch): this;
+    /** Feed the shader clock from aigpu's clock, an XR loop, or another ticker. */
+    tick(timeSeconds: number): this;
+    /** Return to the state supplied at construction time. */
+    reset(): this;
+}
+/**
+ * Fullscreen GPU animation for an AI agent. AIGpu does not own the agent or call a model:
+ * set() is the only bridge from orchestration state to the shader.
+ */
+export declare function agentAnimation(gpu: Gpu, options?: AgentAnimationOptions): AgentAnimation;
+/** Stable numeric mapping used by custom shaders that consume the same status vocabulary. */
+export declare function agentStatusIndex(status: AgentStatus): number;
+export declare const AGENT_ANIMATION_SHADER = "\nstruct AgentParams {\n  time: f32,\n  progress: f32,\n  activity: f32,\n  status: f32,\n  phase: f32,\n  speed: f32,\n  pad: vec2f,\n  accent: vec4f,\n  secondary: vec4f,\n  background: vec4f,\n}\n\n@group(0) @binding(0) var<uniform> params: AgentParams;\n\nconst TAU: f32 = 6.28318530718;\n\n@fragment\nfn main(@location(0) uv: vec2f) -> @location(0) vec4f {\n  let p = uv - vec2f(0.5);\n  let distance = length(p);\n  let angle = atan2(p.y, p.x);\n  let normalizedAngle = fract(angle / TAU + 1.0);\n  let statusPulse = 0.65 + 0.35 * sin(params.time * params.speed + params.phase);\n  let activity = max(params.activity, 0.08);\n  let radius = 0.205 + activity * 0.035;\n  let core = 1.0 - smoothstep(radius - 0.025, radius, distance);\n  let ringDistance = abs(distance - radius - 0.055 - statusPulse * 0.018);\n  let ring = 1.0 - smoothstep(0.012, 0.035, ringDistance);\n  let progressArc = select(0.0, 1.0, normalizedAngle <= params.progress);\n  let arcDistance = abs(distance - radius - 0.055);\n  let arc = progressArc * (1.0 - smoothstep(0.012, 0.03, arcDistance));\n  let haloDistance = abs(distance - radius - 0.11 - statusPulse * 0.025);\n  let halo = (1.0 - smoothstep(0.01, 0.08, haloDistance)) * (0.25 + activity * 0.35);\n  let grain = fract(sin(dot(uv + params.phase, vec2f(12.9898, 78.233))) * 43758.5453);\n  let glow = core * (0.75 + statusPulse * 0.25) + ring * 0.45 + halo * 0.3;\n  let mixed = params.secondary.rgb * (0.45 + halo) + params.background.rgb * (1.0 - halo) + params.accent.rgb * glow;\n  let progressColor = mix(mixed, params.accent.rgb, arc);\n  let grainAmount = (grain - 0.5) * 0.012;\n  return vec4f(max(progressColor + vec3f(grainAmount), vec3f(0.0)), 1.0);\n}\n";
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5F,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,gDAAgD;IAChD,GAAG,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,+EAA+E;IAC/E,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yDAAyD;IACzD,KAAK,IAAI,IAAI,CAAC;CACf;AA4CD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA8C5F;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG5D;AA2HD,eAAO,MAAM,sBAAsB,6qDA0ClC,CAAC"}

package/dist/agent.js

@@ -0,0 +1,243 @@
+import { effect } from "./effect.js";
+const STATUS_INDEX = {
+    idle: 0,
+    thinking: 1,
+    working: 2,
+    waiting: 3,
+    success: 4,
+    error: 5,
+};
+const PALETTES = {
+    idle: {
+        accent: [0.36, 0.53, 0.9, 1],
+        secondary: [0.1, 0.16, 0.34, 1],
+        background: [0.008, 0.014, 0.04, 1],
+    },
+    thinking: {
+        accent: [0.55, 0.7, 1, 1],
+        secondary: [0.18, 0.25, 0.62, 1],
+        background: [0.012, 0.018, 0.075, 1],
+    },
+    working: {
+        accent: [0.35, 0.95, 1, 1],
+        secondary: [0.06, 0.38, 0.65, 1],
+        background: [0.005, 0.028, 0.06, 1],
+    },
+    waiting: {
+        accent: [1, 0.72, 0.28, 1],
+        secondary: [0.65, 0.23, 0.06, 1],
+        background: [0.055, 0.022, 0.006, 1],
+    },
+    success: {
+        accent: [0.3, 1, 0.55, 1],
+        secondary: [0.04, 0.42, 0.2, 1],
+        background: [0.004, 0.035, 0.018, 1],
+    },
+    error: {
+        accent: [1, 0.32, 0.4, 1],
+        secondary: [0.58, 0.06, 0.12, 1],
+        background: [0.055, 0.006, 0.014, 1],
+    },
+};
+/**
+ * Fullscreen GPU animation for an AI agent. AIGpu does not own the agent or call a model:
+ * set() is the only bridge from orchestration state to the shader.
+ */
+export function agentAnimation(gpu, options = {}) {
+    const initial = normalizePatch(options.initial ?? {});
+    const initialColors = mergeColors(PALETTES[initial.status], options.colors, initial.colors);
+    const state = {
+        status: initial.status,
+        progress: initial.progress,
+        activity: initial.activity,
+        phase: initial.phase,
+        speed: initial.speed,
+        colors: initialColors,
+        time: 0,
+    };
+    const initialSnapshot = snapshot(state);
+    const visual = effect(gpu, AGENT_ANIMATION_SHADER, {
+        label: options.label ?? "agent-animation",
+        set: uniforms(state),
+    });
+    return {
+        effect: visual,
+        get state() { return snapshot(state); },
+        set(patch) {
+            applyPatch(state, patch);
+            visual.set(uniforms(state));
+            return this;
+        },
+        tick(timeSeconds) {
+            if (typeof timeSeconds !== "number" || !Number.isFinite(timeSeconds)) {
+                throw new TypeError("agentAnimation.tick() expects a finite number of seconds");
+            }
+            state.time = Math.max(0, timeSeconds);
+            visual.set({ params: { time: state.time } });
+            return this;
+        },
+        reset() {
+            state.status = initialSnapshot.status;
+            state.progress = initialSnapshot.progress;
+            state.activity = initialSnapshot.activity;
+            state.phase = initialSnapshot.phase;
+            state.speed = initialSnapshot.speed;
+            state.colors = cloneColors(initialSnapshot.colors);
+            state.time = 0;
+            visual.set(uniforms(state));
+            return this;
+        },
+    };
+}
+/** Stable numeric mapping used by custom shaders that consume the same status vocabulary. */
+export function agentStatusIndex(status) {
+    if (!Object.hasOwn(STATUS_INDEX, status))
+        throw new TypeError(`Unknown agent status: ${String(status)}`);
+    return STATUS_INDEX[status];
+}
+const DEFAULT_STATE = {
+    status: "idle",
+    progress: 0,
+    activity: 0,
+    phase: 0,
+    speed: 1,
+    colors: PALETTES.idle,
+};
+function normalizePatch(patch) {
+    const status = patch.status ?? DEFAULT_STATE.status;
+    agentStatusIndex(status);
+    return {
+        status,
+        progress: normalized(patch.progress ?? DEFAULT_STATE.progress, "progress"),
+        activity: normalized(patch.activity ?? DEFAULT_STATE.activity, "activity"),
+        phase: finite(patch.phase ?? DEFAULT_STATE.phase, "phase"),
+        speed: nonNegative(patch.speed ?? DEFAULT_STATE.speed, "speed"),
+        colors: patch.colors,
+    };
+}
+function applyPatch(state, patch) {
+    const normalizedPatch = normalizePatch({
+        status: patch.status ?? state.status,
+        progress: patch.progress ?? state.progress,
+        activity: patch.activity ?? state.activity,
+        phase: patch.phase ?? state.phase,
+        speed: patch.speed ?? state.speed,
+        colors: patch.colors,
+    });
+    const statusChanged = normalizedPatch.status !== state.status;
+    state.status = normalizedPatch.status;
+    state.progress = normalizedPatch.progress;
+    state.activity = normalizedPatch.activity;
+    state.phase = normalizedPatch.phase;
+    state.speed = normalizedPatch.speed;
+    state.colors = mergeColors(statusChanged ? PALETTES[state.status] : state.colors, patch.colors, undefined);
+}
+function uniforms(state) {
+    return {
+        params: {
+            time: state.time,
+            progress: state.progress,
+            activity: state.activity,
+            status: agentStatusIndex(state.status),
+            phase: state.phase,
+            speed: state.speed,
+            pad: [0, 0],
+            accent: state.colors.accent,
+            secondary: state.colors.secondary,
+            background: state.colors.background,
+        },
+    };
+}
+function snapshot(state) {
+    return {
+        status: state.status,
+        progress: state.progress,
+        activity: state.activity,
+        phase: state.phase,
+        speed: state.speed,
+        colors: cloneColors(state.colors),
+    };
+}
+function mergeColors(base, ...patches) {
+    const result = { accent: base.accent, secondary: base.secondary, background: base.background };
+    for (const patch of patches) {
+        if (!patch)
+            continue;
+        for (const key of ["accent", "secondary", "background"]) {
+            if (patch[key] !== undefined)
+                result[key] = color(patch[key], `colors.${key}`);
+        }
+    }
+    return result;
+}
+function cloneColors(colors) {
+    return {
+        accent: [...colors.accent],
+        secondary: [...colors.secondary],
+        background: [...colors.background],
+    };
+}
+function color(value, name) {
+    if ((value.length !== 3 && value.length !== 4) || value.some((channel) => typeof channel !== "number" || !Number.isFinite(channel) || channel < 0 || channel > 1)) {
+        throw new TypeError(`${name} must contain 3 or 4 finite numbers in the [0, 1] range`);
+    }
+    return [value[0], value[1], value[2], value[3] ?? 1];
+}
+function normalized(value, name) {
+    return clamp(finite(value, name), 0, 1);
+}
+function nonNegative(value, name) {
+    return Math.max(0, finite(value, name));
+}
+function finite(value, name) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        throw new TypeError(`${name} must be a finite number`);
+    return value;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+export const AGENT_ANIMATION_SHADER = /* wgsl */ `
+struct AgentParams {
+  time: f32,
+  progress: f32,
+  activity: f32,
+  status: f32,
+  phase: f32,
+  speed: f32,
+  pad: vec2f,
+  accent: vec4f,
+  secondary: vec4f,
+  background: vec4f,
+}
+
+@group(0) @binding(0) var<uniform> params: AgentParams;
+
+const TAU: f32 = 6.28318530718;
+
+@fragment
+fn main(@location(0) uv: vec2f) -> @location(0) vec4f {
+  let p = uv - vec2f(0.5);
+  let distance = length(p);
+  let angle = atan2(p.y, p.x);
+  let normalizedAngle = fract(angle / TAU + 1.0);
+  let statusPulse = 0.65 + 0.35 * sin(params.time * params.speed + params.phase);
+  let activity = max(params.activity, 0.08);
+  let radius = 0.205 + activity * 0.035;
+  let core = 1.0 - smoothstep(radius - 0.025, radius, distance);
+  let ringDistance = abs(distance - radius - 0.055 - statusPulse * 0.018);
+  let ring = 1.0 - smoothstep(0.012, 0.035, ringDistance);
+  let progressArc = select(0.0, 1.0, normalizedAngle <= params.progress);
+  let arcDistance = abs(distance - radius - 0.055);
+  let arc = progressArc * (1.0 - smoothstep(0.012, 0.03, arcDistance));
+  let haloDistance = abs(distance - radius - 0.11 - statusPulse * 0.025);
+  let halo = (1.0 - smoothstep(0.01, 0.08, haloDistance)) * (0.25 + activity * 0.35);
+  let grain = fract(sin(dot(uv + params.phase, vec2f(12.9898, 78.233))) * 43758.5453);
+  let glow = core * (0.75 + statusPulse * 0.25) + ring * 0.45 + halo * 0.3;
+  let mixed = params.secondary.rgb * (0.45 + halo) + params.background.rgb * (1.0 - halo) + params.accent.rgb * glow;
+  let progressColor = mix(mixed, params.accent.rgb, arc);
+  let grainAmount = (grain - 0.5) * 0.012;
+  return vec4f(max(progressColor + vec3f(grainAmount), vec3f(0.0)), 1.0);
+}
+`;
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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