@womp/spark-agent 5.2.2 → 5.3.0

package/dist/server/sqlite-store.js

@@ -17,36 +17,36 @@ export class SqliteSparkStore {
             this.database.close();
             throw new Error(`Unsupported Spark database version: ${version}`);
         }
-        this.database.exec(`
-      PRAGMA busy_timeout = 5000;
-      PRAGMA journal_mode = WAL;
-      PRAGMA synchronous = FULL;
-      PRAGMA foreign_keys = ON;
-      CREATE TABLE IF NOT EXISTS conversations (
-        id TEXT PRIMARY KEY, owner_id TEXT NOT NULL, updated_at TEXT NOT NULL, data TEXT NOT NULL
-      );
-      CREATE INDEX IF NOT EXISTS conversation_owner ON conversations(owner_id, updated_at);
-      CREATE TABLE IF NOT EXISTS runs (
-        id TEXT PRIMARY KEY, conversation_id TEXT NOT NULL, data TEXT NOT NULL
-      );
-      CREATE TABLE IF NOT EXISTS chunks (
-        run_id TEXT NOT NULL REFERENCES runs(id), sequence INTEGER NOT NULL, data TEXT NOT NULL,
-        PRIMARY KEY (run_id, sequence)
-      );
-      CREATE TABLE IF NOT EXISTS artifacts (
-        id TEXT PRIMARY KEY, owner_id TEXT NOT NULL, metadata TEXT NOT NULL, bytes BLOB NOT NULL
-      );
-      CREATE TABLE IF NOT EXISTS execution_owner (
-        singleton INTEGER PRIMARY KEY CHECK (singleton = 1), pid INTEGER NOT NULL, token TEXT NOT NULL
-      );
-      CREATE TABLE IF NOT EXISTS scene_operations (
-        target_key TEXT NOT NULL, id TEXT NOT NULL, revision INTEGER NOT NULL, data TEXT NOT NULL,
-        PRIMARY KEY (target_key, id)
-      );
-      CREATE TABLE IF NOT EXISTS repair_states (
-        target_key TEXT PRIMARY KEY, revision INTEGER NOT NULL, data TEXT NOT NULL
-      );
-      PRAGMA user_version = 4;
+        this.database.exec(`
+      PRAGMA busy_timeout = 5000;
+      PRAGMA journal_mode = WAL;
+      PRAGMA synchronous = FULL;
+      PRAGMA foreign_keys = ON;
+      CREATE TABLE IF NOT EXISTS conversations (
+        id TEXT PRIMARY KEY, owner_id TEXT NOT NULL, updated_at TEXT NOT NULL, data TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS conversation_owner ON conversations(owner_id, updated_at);
+      CREATE TABLE IF NOT EXISTS runs (
+        id TEXT PRIMARY KEY, conversation_id TEXT NOT NULL, data TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS chunks (
+        run_id TEXT NOT NULL REFERENCES runs(id), sequence INTEGER NOT NULL, data TEXT NOT NULL,
+        PRIMARY KEY (run_id, sequence)
+      );
+      CREATE TABLE IF NOT EXISTS artifacts (
+        id TEXT PRIMARY KEY, owner_id TEXT NOT NULL, metadata TEXT NOT NULL, bytes BLOB NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS execution_owner (
+        singleton INTEGER PRIMARY KEY CHECK (singleton = 1), pid INTEGER NOT NULL, token TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS scene_operations (
+        target_key TEXT NOT NULL, id TEXT NOT NULL, revision INTEGER NOT NULL, data TEXT NOT NULL,
+        PRIMARY KEY (target_key, id)
+      );
+      CREATE TABLE IF NOT EXISTS repair_states (
+        target_key TEXT PRIMARY KEY, revision INTEGER NOT NULL, data TEXT NOT NULL
+      );
+      PRAGMA user_version = 4;
     `);
     }
     repairStateStore(targetKey) {
@@ -127,13 +127,13 @@ export class SqliteSparkStore {
             if (result.changes !== 1)
                 throw new Error("Scene operation changed concurrently or is missing");
             if (next.status === "committed" || next.status === "rolled_back") {
-                this.database.prepare(`
-          DELETE FROM scene_operations WHERE rowid IN (
-            SELECT rowid FROM scene_operations
-            WHERE target_key = ? AND json_extract(data, '$.status') IN ('committed', 'rolled_back')
-            ORDER BY COALESCE(json_extract(data, '$.completedAt'), '') DESC
-            LIMIT -1 OFFSET ?
-          )
+                this.database.prepare(`
+          DELETE FROM scene_operations WHERE rowid IN (
+            SELECT rowid FROM scene_operations
+            WHERE target_key = ? AND json_extract(data, '$.status') IN ('committed', 'rolled_back')
+            ORDER BY COALESCE(json_extract(data, '$.completedAt'), '') DESC
+            LIMIT -1 OFFSET ?
+          )
         `).run(next.targetKey, completedSceneOperationLimit);
             }
             this.database.exec("COMMIT");

package/dist/server/standalone.js

@@ -5,10 +5,11 @@ import express from "express";
 import { getSparkModel, SPARK_MODELS } from "../models.js";
 import { KakapoAPI, KakapoRpcError, KakapoSceneCommitError } from "@womp/kakapo-sdk";
 import { captureSdkSceneScreenshot } from "../sdk-scene-screenshot.js";
-import { composeCapabilities, createAccountCapability, createGeometryCapability, createOpenScadCapability, createSceneCapability, } from "../capabilities.js";
+import { composeCapabilities, createAccountCapability, createGeometryCapability, createMaterialsCapability, createOpenScadCapability, createSceneCapability, } from "../capabilities.js";
 import { loadDemoSceneMaterials } from "./demo-scene-materials.js";
 import { createDemoAccountHost } from "./demo-account.js";
 import { createSdkSceneEditor, createSdkSceneHost, } from "../sdk-scene-host.js";
+import { createSdkMaterialsHost } from "../sdk-materials-host.js";
 import { createSdkGeometryHost } from "../sdk-geometry-host.js";
 import { createSdkOpenScadHost } from "../sdk-openscad-host.js";
 import { createSdkSceneHealthHost } from "../sdk-scene-health-host.js";
@@ -114,6 +115,10 @@ export async function createStandaloneSparkAgentApp(options) {
                 });
                 const capabilityBindings = {
                     scene: createSceneCapability(sceneHost),
+                    materials: createMaterialsCapability(createSdkMaterialsHost({
+                        editor,
+                        assertAvailable: editorOptions.assertEditable,
+                    }), sceneHost),
                     geometry: createGeometryCapability(createSdkGeometryHost({
                         editor,
                         repairs,

package/dist/ui.d.ts

@@ -116,16 +116,24 @@ export type SparkUITools = {
     read_skill: {
         input: {
             name: string;
+            names?: never;
+        } | {
+            names: string[];
+            name?: never;
         };
-        output: ({
-            ok: true;
-        } & SparkSkill) | {
-            ok: false;
-            error: string;
-            available: string[];
+        output: SkillReadResult | {
+            ok: boolean;
+            skills: SkillReadResult[];
         };
     };
 };
+export type SkillReadResult = ({
+    ok: true;
+} & SparkSkill) | {
+    ok: false;
+    error: string;
+    available: string[];
+};
 export type SparkUIMessage = UIMessage<SparkMessageMetadata, SparkDataParts, SparkUITools>;
 export type SparkUIMessageChunk = InferUIMessageChunk<SparkUIMessage>;
 export type StoredSparkChunk = {
@@ -168,12 +176,24 @@ export declare const sparkMessageMetadataSchema: z.ZodObject<{
             code: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodNumber>;
             requestId: z.ZodOptional<z.ZodString>;
+            eventType: z.ZodOptional<z.ZodString>;
+            issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                expected: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
             cause: z.ZodOptional<z.ZodObject<{
                 message: z.ZodString;
                 name: z.ZodOptional<z.ZodString>;
                 code: z.ZodOptional<z.ZodString>;
                 status: z.ZodOptional<z.ZodNumber>;
                 requestId: z.ZodOptional<z.ZodString>;
+                eventType: z.ZodOptional<z.ZodString>;
+                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    code: z.ZodString;
+                    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    expected: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         message: z.ZodString;
@@ -181,6 +201,12 @@ export declare const sparkMessageMetadataSchema: z.ZodObject<{
         code: z.ZodOptional<z.ZodString>;
         status: z.ZodOptional<z.ZodNumber>;
         requestId: z.ZodOptional<z.ZodString>;
+        eventType: z.ZodOptional<z.ZodString>;
+        issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            expected: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const sparkDataPartSchemas: {
@@ -243,12 +269,24 @@ export declare const sparkDataPartSchemas: {
                 code: z.ZodOptional<z.ZodString>;
                 status: z.ZodOptional<z.ZodNumber>;
                 requestId: z.ZodOptional<z.ZodString>;
+                eventType: z.ZodOptional<z.ZodString>;
+                issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    code: z.ZodString;
+                    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                    expected: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
                 cause: z.ZodOptional<z.ZodObject<{
                     message: z.ZodString;
                     name: z.ZodOptional<z.ZodString>;
                     code: z.ZodOptional<z.ZodString>;
                     status: z.ZodOptional<z.ZodNumber>;
                     requestId: z.ZodOptional<z.ZodString>;
+                    eventType: z.ZodOptional<z.ZodString>;
+                    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        code: z.ZodString;
+                        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                        expected: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
             message: z.ZodString;
@@ -256,6 +294,12 @@ export declare const sparkDataPartSchemas: {
             code: z.ZodOptional<z.ZodString>;
             status: z.ZodOptional<z.ZodNumber>;
             requestId: z.ZodOptional<z.ZodString>;
+            eventType: z.ZodOptional<z.ZodString>;
+            issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                expected: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
         label: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;

package/package.json

@@ -1,139 +1,139 @@
-{
-  "name": "@womp/spark-agent",
-  "version": "5.2.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.7.2",
-    "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": "5.3.0",
+  "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.7.2",
+    "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"
+  }
+}