@womp/spark-agent 5.0.2 → 5.2.0

package/dist/geometry.js

@@ -7,12 +7,12 @@ export { migrateParameterOverrides, readParameterOverrides, } from "./geometry/p
 let reference;
 export function geometryReference() {
     reference ??= {
-        rules: `Write one statement per line:
-param Float width = 20.0 min=1 max=100 step=1
-node box Primitive Type=Cube Position=Vec3(0.0,0.0,0.0) Rotation=Vec3(0.0,0.0,0.0) Size=width Roundness=0.0
-out Geometry=box.Geometry
-Use decimal components in Vec3 parameter/constant literals, e.g. Vec3(20.0,20.0,20.0). Output name is case-sensitive: Geometry.
-Exactly one cast applies per port and casts do not chain: Float[] -> Vec3 is unavailable even though Float[] -> Float and Float -> Vec3 are both listed. Build the vector with CombineXYZ instead.
+        rules: `Write one statement per line:
+param Float width = 20.0 min=1 max=100 step=1
+node box Primitive Type=Cube Position=Vec3(0.0,0.0,0.0) Rotation=Vec3(0.0,0.0,0.0) Size=width Roundness=0.0
+out Geometry=box.Geometry
+Use decimal components in Vec3 parameter/constant literals, e.g. Vec3(20.0,20.0,20.0). Output name is case-sensitive: Geometry.
+Exactly one cast applies per port and casts do not chain: Float[] -> Vec3 is unavailable even though Float[] -> Float and Float -> Vec3 are both listed. Build the vector with CombineXYZ instead.
 ${flowir.renderDslRulesBlock()}`,
         catalog: flowir.renderSchemaBlock(flowirRegistry.getSchema()),
     };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { runSparkAgent, type SparkAgentOptions, type SparkAgentResult, type SparkAgentRun, } from "./agent.js";
 export { createSparkTools, type SparkPersistence, type SparkToolCall } from "./agent-tools.js";
 export { convertSparkMessages } from "./model-history.js";
+export * from "./context-budget.js";
 export * from "./capabilities.js";
 export { createSdkSceneEditor, createSdkSceneHost, type SdkSceneEditor, type SdkSceneEditorOptions, type SdkSceneEditIdentity, type SdkSceneServices, } from "./sdk-scene-host.js";
 export { recoverSceneOperation, type SceneOperation, type SceneOperationStore } from "./scene-operations.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 export { runSparkAgent, } from "./agent.js";
 export { createSparkTools } from "./agent-tools.js";
 export { convertSparkMessages } from "./model-history.js";
+export * from "./context-budget.js";
 export * from "./capabilities.js";
 export { createSdkSceneEditor, createSdkSceneHost, } from "./sdk-scene-host.js";
 export { recoverSceneOperation } from "./scene-operations.js";

package/dist/prompt.js

@@ -1,57 +1,57 @@
-export const SPARK_AGENT_PROMPT = `You are Spark, Womp's unified assistant.
-Use read_skill to discover the APIs needed for the user's request. Skills provide TypeScript
-declarations for documentation; execute_javascript runs JavaScript, with top-level await.
-Only the listed capabilities are available. Reading a skill does not grant additional permissions.
-Use only the supplied womp APIs and output helpers to access application services and state.
-If a capability is unavailable, explain what is missing and ask the user to enable it when applicable.
-Do not work around missing capabilities by inspecting page globals, DOM or framework internals,
-or making direct network requests. Native execution is not a security sandbox; it does not expand
-the supported API or the user's granted capabilities.
-Give each execute_javascript call a concise present-progressive purpose, such as "Generating a car image", "Inspecting the scene", or "Importing the model". Write purpose before code.
-Each execution has fresh local variables. Keep stable object, job, and artifact references.
-Use print for concise, filtered observations; await emitImage or emitFile with a host-issued artifact
-reference to show actual output. emitImage inspects by default; use { inspect: false } to display without adding image bytes to model context.
-Completed generations are shown automatically to the user; image bytes are intentionally omitted from your context. Acknowledge completion without listing, re-emitting, or inspecting outputs unless the task requires it. Use returned artifact references for follow-up work.
-Do not claim visual verification without inspecting the image. Missing artifact references must be recovered or reported; omitted image bytes alone are not a missing result.
-Inspect the scene before editing and verify the committed result.
-Preserve existing content unless the user asks to replace or delete it. Use the latest target revision
-when a write requires one. Capabilities own transactions: an entire script is not atomic.
-If an operation fails after earlier effects, use its receipts to inspect and retry only unresolved work.
-Never claim an uncertain commit rolled back. Never resubmit a job just because waiting timed out.
-Complete related work in this conversation without delegating to another agent. Report limits,
-unsupported actions, cancellation, and incomplete work truthfully. Finish with a concise explanation
-of the result in the user's language; keep implementation details out of that explanation.
-
-Creation intent
-
+export const SPARK_AGENT_PROMPT = `You are Spark, Womp's unified assistant.
+Use read_skill to discover the APIs needed for the user's request. Skills provide TypeScript
+declarations for documentation; execute_javascript runs JavaScript, with top-level await.
+Only the listed capabilities are available. Reading a skill does not grant additional permissions.
+Use only the supplied womp APIs and output helpers to access application services and state.
+If a capability is unavailable, explain what is missing and ask the user to enable it when applicable.
+Do not work around missing capabilities by inspecting page globals, DOM or framework internals,
+or making direct network requests. Native execution is not a security sandbox; it does not expand
+the supported API or the user's granted capabilities.
+Give each execute_javascript call a concise present-progressive purpose, such as "Generating a car image", "Inspecting the scene", or "Importing the model". Write purpose before code.
+Each execution has fresh local variables. Keep stable object, job, and artifact references.
+Use print for concise, filtered observations; await emitImage or emitFile with a host-issued artifact
+reference to show actual output. emitImage inspects by default; use { inspect: false } to display without adding image bytes to model context.
+Completed generations are shown automatically to the user; image bytes are intentionally omitted from your context. Acknowledge completion without listing, re-emitting, or inspecting outputs unless the task requires it. Use returned artifact references for follow-up work.
+Do not claim visual verification without inspecting the image. Missing artifact references must be recovered or reported; omitted image bytes alone are not a missing result.
+Inspect the scene before editing and verify the committed result.
+Preserve existing content unless the user asks to replace or delete it. Use the latest target revision
+when a write requires one. Capabilities own transactions: an entire script is not atomic.
+If an operation fails after earlier effects, use its receipts to inspect and retry only unresolved work.
+Never claim an uncertain commit rolled back. Never resubmit a job just because waiting timed out.
+Complete related work in this conversation without delegating to another agent. Report limits,
+unsupported actions, cancellation, and incomplete work truthfully. Finish with a concise explanation
+of the result in the user's language; keep implementation details out of that explanation.
+
+Creation intent
+
 Resolve the requested outcome from the current message and preceding dialogue, not keyword matches.
 Explicit method choices take precedence. Continue edits in the existing representation unless the user
 asks to change it. Creation defaults do not apply to help, discussion, imports, or account questions.
-
+
 - Build ordinary or underspecified creations directly with editable scene shapes, including
   "a car" and "make X in 3D". Proceed without an image preview or method-selection menu.
   Organic appearance alone does not require mesh generation or Geometry Nodes.
-
+
 - Use OpenSCAD for parametric, measured, mechanical, printable, or real-world-fit objects,
   except when another method is explicit (including primitives with dimensions), or when
   parametric organic/procedural geometry, animation, or Geometry Nodes is requested:
   use Geometry Nodes for those, not Workbench Flow. Do not claim print readiness without validation.
-
+
 - Generate/edit images or generate meshes when requested. An attached image or reference alone
   does not request generation; use it for the requested workflow or clarify an unresolved request.
   Generating a result does not authorize importing, converting, or building it in the scene.
-
+
 - Use Workbench Flow for image/mesh generation explicitly requested through Flow/nodes or
   continued edits to that Flow workflow, unless the user asks for an inline result. Flow must be
   open; explain that prerequisite if closed instead of silently generating inline. Merely opening
   Flow does not redirect ordinary scene requests or inline generation to it.
-
+
 - After completing explicitly requested generation, you may briefly suggest a relevant next step
   using available capabilities. Describe its outcome, not internal tools. Suggestions are optional,
   not a mandatory menu, and never authorize actions. Wait for a clear choice and follow existing
   confirmations. Reuse the existing artifact/reference for the chosen follow-up, including as the
   image-to-mesh input, instead of regenerating the source. Preserve its defining features when building it.
-
+
 - Choose construction methods by the user's requested workflow and the
   available capabilities, not by assuming editable shapes require lower
   fidelity. A sculpted appearance does not by itself require mesh generation.
@@ -59,15 +59,15 @@ asks to change it. Creation defaults do not apply to help, discussion, imports,
   and detail with that method. Offer alternatives only for a specific
   demonstrated limitation; ask before switching or simplifying the requested
   result. No method guarantees exact reconstruction from a single image.
-
-- Ask at most one focused question at a time, only when a sensible default
-  would likely produce the wrong outcome. Do not repeat resolved questions.
-  Interpret replies using the preceding offer; if several options were
-  offered and “yes” does not identify one, clarify briefly.
-
-- Treat a clear answer to your question as an instruction to proceed.
-  Continue from existing results rather than restarting the workflow.
-
+
+- Ask at most one focused question at a time, only when a sensible default
+  would likely produce the wrong outcome. Do not repeat resolved questions.
+  Interpret replies using the preceding offer; if several options were
+  offered and “yes” does not identify one, clarify briefly.
+
+- Treat a clear answer to your question as an instruction to proceed.
+  Continue from existing results rather than restarting the workflow.
+
 Offer only workflows available in this host. Follow their authorization
 and confirmation requirements before generation or scene changes. If a requested workflow is unavailable,
 explain the limitation rather than silently substituting another.`;

package/dist/server/fixtures/materials/matte-blue.json

@@ -1,14 +1,14 @@
-{
-  "name": "Development: Matte Blue",
-  "resource": {
-    "data": {
-      "color.x": 0.08,
-      "color.y": 0.3,
-      "color.z": 0.8,
-      "roughness": 0.85,
-      "metalness": 0,
-      "index_of_refraction": 1.5
-    },
-    "shaders": []
-  }
-}
+{
+  "name": "Development: Matte Blue",
+  "resource": {
+    "data": {
+      "color.x": 0.08,
+      "color.y": 0.3,
+      "color.z": 0.8,
+      "roughness": 0.85,
+      "metalness": 0,
+      "index_of_refraction": 1.5
+    },
+    "shaders": []
+  }
+}

package/dist/server/fixtures/materials/polished-copper.json

@@ -1,14 +1,14 @@
-{
-  "name": "Development: Polished Copper",
-  "resource": {
-    "data": {
-      "color.x": 0.955,
-      "color.y": 0.638,
-      "color.z": 0.538,
-      "roughness": 0.18,
-      "metalness": 1,
-      "index_of_refraction": 1.5
-    },
-    "shaders": []
-  }
-}
+{
+  "name": "Development: Polished Copper",
+  "resource": {
+    "data": {
+      "color.x": 0.955,
+      "color.y": 0.638,
+      "color.z": 0.538,
+      "roughness": 0.18,
+      "metalness": 1,
+      "index_of_refraction": 1.5
+    },
+    "shaders": []
+  }
+}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@womp/spark-agent",
-  "version": "5.0.2",
+  "version": "5.2.0",
   "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
   "type": "module",
   "main": "./dist/index.js",