@womp/spark-agent 4.1.2 → 4.2.1

package/dist/womp-scene-api.d.ts

@@ -34,7 +34,8 @@ export declare const LightTypeValue: {
     readonly Sphere: 1;
     readonly Distant: 2;
 };
-type Color3 = {
+/** A color in the engine's 0-255 domain per channel, not 0-1. */
+type Color255 = {
     r: number;
     g: number;
     b: number;
@@ -154,8 +155,8 @@ export declare function createWompSceneApi(context: WompSceneApiContext): {
     nodeSetBlend: (id: number, blend: number) => void;
     nodeGetRound: (id: number) => number;
     nodeSetRound: (id: number, round: number) => void;
-    nodeGetColor: (id: number) => Color3;
-    nodeSetColor: (id: number, color: Color3 | Vec3) => void;
+    nodeGetColor: (id: number) => Color255;
+    nodeSetColor: (id: number, rgb255: Color255 | Vec3) => void;
     nodeGetMaterialId: (id: number) => number | null;
     nodeSetMaterialId: (id: number, materialId: number) => void;
     nodeGetResolution: (id: number) => number;
@@ -225,12 +226,12 @@ export declare function createWompSceneApi(context: WompSceneApiContext): {
     materialSetName: (id: number, name: string) => void;
     materialGetTier: (id: number) => number;
     materialSetTier: (id: number, tier: number) => void;
-    materialGetColor: (id: number) => Color3;
-    materialSetColor: (id: number, color: Color3) => void;
-    materialGetSecondaryColor: (id: number) => Color3;
-    materialSetSecondaryColor: (id: number, color: Color3) => void;
-    materialGetSubsurfaceColor: (id: number) => Color3;
-    materialSetSubsurfaceColor: (id: number, color: Color3) => void;
+    materialGetColor: (id: number) => Color255;
+    materialSetColor: (id: number, rgb255: Color255) => void;
+    materialGetSecondaryColor: (id: number) => Color255;
+    materialSetSecondaryColor: (id: number, rgb255: Color255) => void;
+    materialGetSubsurfaceColor: (id: number) => Color255;
+    materialSetSubsurfaceColor: (id: number, rgb255: Color255) => void;
     materialGetRoughness: (id: number) => number;
     materialSetRoughness: (id: number, value: number) => void;
     materialGetMetalness: (id: number) => number;
@@ -285,7 +286,7 @@ export declare function createWompSceneApi(context: WompSceneApiContext): {
     setHdrName: (name: string) => void;
     setHdrMultiplier: (multiplier: number) => void;
     setHdrOrientation: (orientation: Vec2) => void;
-    setBackgroundColor: (color: {
+    setBackgroundColor: (rgb255: {
         r: number;
         g: number;
         b: number;

package/dist/womp-scene-api.js

@@ -1,6 +1,7 @@
 import { xyzRotationFromMatrix, MAX_BLEND_RADIUS_MM, MAX_MIRROR_BLEND_RADIUS_MM } from "@womp/kakapo-sdk";
 import { metadataObject, readMaterialMetadata, removeMaterialMetadata, shiftCurvePointMetadata, writeMaterialMetadata, } from "./scene-metadata.js";
 import { createSceneEnvironment } from "./scene-environment.js";
+import { assertColor255 } from "./color.js";
 import { convertRotationBasis, sceneUnitMultiplier, fromEngineDimensions, fromEngineMirrorRotation, fromEnginePosition, toEngineDimensions, toEngineMirrorRotation, toEnginePosition, } from "./coordinates.js";
 export const NodeType = {
     Primitive: 0,
@@ -100,13 +101,14 @@ function color255(value) {
         b: Math.round(value.z * 255),
     };
 }
+/** 0-255 per channel, refusing a 0-1 color rather than rounding it to black (./color.ts). */
 function color1(value) {
     const input = value;
-    return {
-        x: clamp(finite(input.r ?? input.x, "color.r"), 0, 255) / 255,
-        y: clamp(finite(input.g ?? input.y, "color.g"), 0, 255) / 255,
-        z: clamp(finite(input.b ?? input.z, "color.b"), 0, 255) / 255,
-    };
+    const r = finite(input.r ?? input.x, "color.r");
+    const g = finite(input.g ?? input.y, "color.g");
+    const b = finite(input.b ?? input.z, "color.b");
+    assertColor255([r, g, b]);
+    return { x: clamp(r, 0, 255) / 255, y: clamp(g, 0, 255) / 255, z: clamp(b, 0, 255) / 255 };
 }
 function runtimeEnum(values) {
     const names = {};
@@ -677,7 +679,7 @@ export function createWompSceneApi(context) {
             const node = requireNode(id);
             return color255(node.kind === "primitive" || node.kind === "light" ? node.color : { x: 0, y: 0, z: 0 });
         },
-        nodeSetColor: (id, color) => update(id, { color: color1(color) }),
+        nodeSetColor: (id, rgb255) => update(id, { color: color1(rgb255) }),
         nodeGetMaterialId: (id) => {
             const node = requireNode(id);
             return "materialId" in node ? node.materialId : null;
@@ -919,11 +921,11 @@ export function createWompSceneApi(context) {
             writeMaterialMetadata(scene, id, { tier: value });
         },
         materialGetColor: (id) => color255(material(id).data.color),
-        materialSetColor: (id, color) => writeMaterial(id, { color: color1(color) }),
+        materialSetColor: (id, rgb255) => writeMaterial(id, { color: color1(rgb255) }),
         materialGetSecondaryColor: (id) => color255(material(id).data.secondaryColor),
-        materialSetSecondaryColor: (id, color) => writeMaterial(id, { secondaryColor: color1(color) }),
+        materialSetSecondaryColor: (id, rgb255) => writeMaterial(id, { secondaryColor: color1(rgb255) }),
         materialGetSubsurfaceColor: (id) => color255(material(id).data.subsurface),
-        materialSetSubsurfaceColor: (id, color) => writeMaterial(id, { subsurface: color1(color) }),
+        materialSetSubsurfaceColor: (id, rgb255) => writeMaterial(id, { subsurface: color1(rgb255) }),
         materialGetRoughness: (id) => material(id).data.roughness,
         materialSetRoughness: (id, value) => writeMaterial(id, { roughness: clamp(finite(value, "roughness"), 0, 1) }),
         materialGetMetalness: (id) => material(id).data.metalness,

package/package.json

@@ -1,139 +1,139 @@
-{
-  "name": "@womp/spark-agent",
-  "version": "4.1.2",
-  "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "spark-agent": "dist/cli.js",
-    "simple-bench": "dist/simple-bench-cli.js",
-    "agent-run": "dist/agent-run-cli.js"
-  },
-  "exports": {
-    "./browser": {
-      "types": "./dist/browser.d.ts",
-      "import": "./dist/browser.js",
-      "default": "./dist/browser.js"
-    },
-    "./capabilities": {
-      "types": "./dist/capabilities.d.ts",
-      "import": "./dist/capabilities.js",
-      "default": "./dist/capabilities.js"
-    },
-    "./kakapo": {
-      "types": "./dist/kakapo.d.ts",
-      "import": "./dist/kakapo.js",
-      "default": "./dist/kakapo.js"
-    },
-    "./geometry": {
-      "types": "./dist/geometry.d.ts",
-      "import": "./dist/geometry.js",
-      "default": "./dist/geometry.js"
-    },
-    "./openscad": {
-      "types": "./dist/openscad.d.ts",
-      "import": "./dist/openscad.js",
-      "default": "./dist/openscad.js"
-    },
-    "./quickjs": {
-      "types": "./dist/quickjs-executor.d.ts",
-      "import": "./dist/quickjs-executor.js",
-      "default": "./dist/quickjs-executor.js"
-    },
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    },
-    "./ui": {
-      "types": "./dist/ui.d.ts",
-      "import": "./dist/ui.js",
-      "default": "./dist/ui.js"
-    },
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.js",
-      "default": "./dist/client.js"
-    },
-    "./server": {
-      "types": "./dist/server/index.d.ts",
-      "import": "./dist/server/index.js",
-      "default": "./dist/server/index.js"
-    },
-    "./express": {
-      "types": "./dist/server/express.d.ts",
-      "import": "./dist/server/express.js",
-      "default": "./dist/server/express.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "dist/server/fixtures/**/*.json",
-    "dist/geometry/schemas/**/*.json",
-    "README.md"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=22.13"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wompxyz/spark-agent.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "scripts": {
-    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "yarn clean && node scripts/generate-skill-declarations.mjs && tsc -p tsconfig.json && node scripts/copy-fixtures.mjs",
-    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p web/tsconfig.json",
-    "lint": "yarn typecheck",
-    "dev": "yarn build && concurrently --kill-others \"yarn dev:server\" \"yarn dev:web\"",
-    "dev:server": "tsx src/cli.ts",
-    "simple-bench": "tsx src/simple-bench-cli.ts",
-    "agent-run": "tsx src/agent-run-cli.ts",
-    "dev:demo-account": "yarn build && concurrently --kill-others \"yarn dev:server --profile demo-account\" \"yarn dev:web\"",
-    "dev:web": "vite --config web/vite.config.ts",
-    "start": "node dist/cli.js",
-    "web:build": "yarn build && tsc --noEmit -p web/tsconfig.json && vite build --config web/vite.config.ts",
-    "test": "yarn build && tsx --tsconfig tsconfig.json --test test/**/*.test.ts && node --input-type=module -e \"await Promise.all([import('@womp/spark-agent'), import('@womp/spark-agent/ui'), import('@womp/spark-agent/client'), import('@womp/spark-agent/server'), import('@womp/spark-agent/express'), import('@womp/spark-agent/kakapo'), import('@womp/spark-agent/geometry'), import('@womp/spark-agent/openscad')])\"",
-    "test:live": "tsx --tsconfig tsconfig.json test/womp-scene-api.live.ts",
-    "prepack": "yarn build"
-  },
-  "dependencies": {
-    "@ai-sdk/anthropic": "4.0.50",
-    "@ai-sdk/google": "4.0.69",
-    "@ai-sdk/openai": "4.0.63",
-    "@jitl/quickjs-wasmfile-release-sync": "0.32.0",
-    "@womp/flowir": "0.3.0",
-    "@womp/kakapo-sdk": "0.4.0",
-    "ai": "7.0.95",
-    "eventsource-parser": "^3.0.6",
-    "express": "^5.2.1",
-    "lodash": "4.18.1",
-    "quickjs-emscripten-core": "0.32.0",
-    "zod": "4.5.4"
-  },
-  "devDependencies": {
-    "@ai-sdk/react": "^4.0.77",
-    "@types/express": "^5.0.5",
-    "@types/lodash": "4.17.24",
-    "@types/node": "^24.0.0",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.4",
-    "concurrently": "^9.2.1",
-    "lucide-react": "^1.26.0",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
-    "react-markdown": "^10.1.0",
-    "remark-gfm": "^4.0.1",
-    "tsx": "^4.23.1",
-    "typescript": "^5.9.3",
-    "vite": "^8.1.5"
-  }
-}
+{
+  "name": "@womp/spark-agent",
+  "version": "4.2.1",
+  "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "spark-agent": "dist/cli.js",
+    "simple-bench": "dist/simple-bench-cli.js",
+    "agent-run": "dist/agent-run-cli.js"
+  },
+  "exports": {
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
+    "./capabilities": {
+      "types": "./dist/capabilities.d.ts",
+      "import": "./dist/capabilities.js",
+      "default": "./dist/capabilities.js"
+    },
+    "./kakapo": {
+      "types": "./dist/kakapo.d.ts",
+      "import": "./dist/kakapo.js",
+      "default": "./dist/kakapo.js"
+    },
+    "./geometry": {
+      "types": "./dist/geometry.d.ts",
+      "import": "./dist/geometry.js",
+      "default": "./dist/geometry.js"
+    },
+    "./openscad": {
+      "types": "./dist/openscad.d.ts",
+      "import": "./dist/openscad.js",
+      "default": "./dist/openscad.js"
+    },
+    "./quickjs": {
+      "types": "./dist/quickjs-executor.d.ts",
+      "import": "./dist/quickjs-executor.js",
+      "default": "./dist/quickjs-executor.js"
+    },
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js",
+      "default": "./dist/ui.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./express": {
+      "types": "./dist/server/express.d.ts",
+      "import": "./dist/server/express.js",
+      "default": "./dist/server/express.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/server/fixtures/**/*.json",
+    "dist/geometry/schemas/**/*.json",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.13"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wompxyz/spark-agent.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "yarn clean && node scripts/generate-skill-declarations.mjs && tsc -p tsconfig.json && node scripts/copy-fixtures.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p web/tsconfig.json",
+    "lint": "yarn typecheck",
+    "dev": "yarn build && concurrently --kill-others \"yarn dev:server\" \"yarn dev:web\"",
+    "dev:server": "tsx src/cli.ts",
+    "simple-bench": "tsx src/simple-bench-cli.ts",
+    "agent-run": "tsx src/agent-run-cli.ts",
+    "dev:demo-account": "yarn build && concurrently --kill-others \"yarn dev:server --profile demo-account\" \"yarn dev:web\"",
+    "dev:web": "vite --config web/vite.config.ts",
+    "start": "node dist/cli.js",
+    "web:build": "yarn build && tsc --noEmit -p web/tsconfig.json && vite build --config web/vite.config.ts",
+    "test": "yarn build && tsx --tsconfig tsconfig.json --test test/**/*.test.ts && node --input-type=module -e \"await Promise.all([import('@womp/spark-agent'), import('@womp/spark-agent/ui'), import('@womp/spark-agent/client'), import('@womp/spark-agent/server'), import('@womp/spark-agent/express'), import('@womp/spark-agent/kakapo'), import('@womp/spark-agent/geometry'), import('@womp/spark-agent/openscad')])\"",
+    "test:live": "tsx --tsconfig tsconfig.json test/womp-scene-api.live.ts",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "4.0.50",
+    "@ai-sdk/google": "4.0.69",
+    "@ai-sdk/openai": "4.0.63",
+    "@jitl/quickjs-wasmfile-release-sync": "0.32.0",
+    "@womp/flowir": "0.3.0",
+    "@womp/kakapo-sdk": "0.4.0",
+    "ai": "7.0.95",
+    "eventsource-parser": "^3.0.6",
+    "express": "^5.2.1",
+    "lodash": "4.18.1",
+    "quickjs-emscripten-core": "0.32.0",
+    "zod": "4.5.4"
+  },
+  "devDependencies": {
+    "@ai-sdk/react": "^4.0.77",
+    "@types/express": "^5.0.5",
+    "@types/lodash": "4.17.24",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.4",
+    "concurrently": "^9.2.1",
+    "lucide-react": "^1.26.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
+    "tsx": "^4.23.1",
+    "typescript": "^5.9.3",
+    "vite": "^8.1.5"
+  }
+}