@womp/spark-agent 5.6.0 → 5.7.0

package/dist/ui.d.ts

@@ -3,6 +3,7 @@ export { sparkErrorDiagnostics, sparkErrorDiagnosticsSchema, type SparkErrorDiag
 import type { InferUIMessageChunk, UIMessage } from "ai";
 import type { SceneScreenshotOptions } from "./capabilities/scene.js";
 import { z } from "zod";
+export type { SparkGoal, SparkGoalCommand } from "./goals.js";
 import type { ExecutionReceipt, SparkSkill } from "./capabilities.js";
 export { DEFAULT_MODEL_ID, getSparkModel, REASONING_EFFORT_LABELS, resolveReasoningEffort, SPARK_MODELS, } from "./models.js";
 export type { ModelProvider, ReasoningEffort, SparkModel } from "./models.js";
@@ -19,6 +20,7 @@ export type SparkArtifact = {
 };
 export type SparkMessageMetadata = {
     createdAt: string;
+    goalContinuation?: boolean;
     completedAt?: string;
     durationMs?: number;
     runId?: string;
@@ -154,14 +156,15 @@ export declare const sparkArtifactSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const sparkMessageMetadataSchema: z.ZodObject<{
     createdAt: z.ZodString;
+    goalContinuation: z.ZodOptional<z.ZodBoolean>;
     completedAt: z.ZodOptional<z.ZodString>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     runId: z.ZodOptional<z.ZodString>;
     runStatus: z.ZodOptional<z.ZodEnum<{
+        completed: "completed";
         queued: "queued";
         running: "running";
         requires_action: "requires_action";
-        completed: "completed";
         failed: "failed";
         cancelled: "cancelled";
         incomplete: "incomplete";
@@ -253,10 +256,10 @@ export declare const sparkDataPartSchemas: {
     readonly "run-status": z.ZodObject<{
         runId: z.ZodString;
         status: z.ZodEnum<{
+            completed: "completed";
             queued: "queued";
             running: "running";
             requires_action: "requires_action";
-            completed: "completed";
             failed: "failed";
             cancelled: "cancelled";
             incomplete: "incomplete";
@@ -323,4 +326,5 @@ export declare const sparkDataPartSchemas: {
         usage: z.ZodOptional<z.ZodUnknown>;
     }, z.core.$strip>;
 };
-export { parseWompifyCommand, WOMPIFY_PRESETS, wompifyPrompt, type WompifyRequest } from "./wompify.js";
+export { parseWompifyCommand, WOMPIFY_PRESETS, wompifyPrompt, wompifyContext, wompifyContextSchema, type WompifyRequest, type WompifyContext } from "./wompify.js";
+export { parseSparkGoalCommand, DEFAULT_GOAL_CREDITS } from "./goals.js";

package/dist/ui.js

@@ -43,6 +43,7 @@ export const sparkArtifactSchema = z.object({
 });
 export const sparkMessageMetadataSchema = z.object({
     createdAt: z.string().datetime(),
+    goalContinuation: z.boolean().optional(),
     completedAt: z.string().datetime().optional(),
     durationMs: z.number().nonnegative().optional(),
     runId: z.string().optional(),
@@ -79,4 +80,5 @@ export const sparkDataPartSchemas = {
         usage: z.unknown().optional(),
     }),
 };
-export { parseWompifyCommand, WOMPIFY_PRESETS, wompifyPrompt } from "./wompify.js";
+export { parseWompifyCommand, WOMPIFY_PRESETS, wompifyPrompt, wompifyContext, wompifyContextSchema } from "./wompify.js";
+export { parseSparkGoalCommand, DEFAULT_GOAL_CREDITS } from "./goals.js";

package/dist/wompify.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 export declare const WOMPIFY_PRESETS: {
     readonly simple: {
         readonly label: "Simple";
@@ -15,6 +16,16 @@ export declare const WOMPIFY_PRESETS: {
 export type WompifyRequest = {
     preset: keyof typeof WOMPIFY_PRESETS;
 };
+export declare const wompifyContextSchema: z.ZodObject<{
+    referenceNamePrefix: z.ZodString;
+    preset: z.ZodEnum<{
+        simple: "simple";
+        high: "high";
+        ultra: "ultra";
+    }>;
+}, z.core.$strip>;
+export type WompifyContext = z.infer<typeof wompifyContextSchema>;
+export declare function wompifyContext(context?: WompifyContext): string | undefined;
 export declare function wompifyPrompt(preset: WompifyRequest["preset"], referenceName: string, note?: string): string;
 export declare function parseWompifyCommand(text: string): {
     preset: WompifyRequest["preset"];

package/dist/wompify.js

@@ -1,11 +1,20 @@
+import { z } from "zod";
 export const WOMPIFY_PRESETS = {
     simple: { label: "Simple", instructions: "Prioritize the main forms, proportions, silhouettes and colors, with a compact editable construction." },
     high: { label: "High res", instructions: "Refine both the main forms and smaller characteristic shapes, checking each region from multiple views." },
     ultra: { label: "Ultra", instructions: "Target the closest practical geometric match, including subtle contours and small modeled details, with thorough close-up comparisons." },
 };
+export const wompifyContextSchema = z.object({
+    referenceNamePrefix: z.string().trim().min(1).max(200),
+    preset: z.enum(["simple", "high", "ultra"]),
+});
+export function wompifyContext(context) {
+    if (!context)
+        return undefined;
+    return `Use the mesh-wompify skill for reference name prefix ${JSON.stringify(context.referenceNamePrefix)} at tier ${WOMPIFY_PRESETS[context.preset].label}. Stop if that skill is unavailable.`;
+}
 export function wompifyPrompt(preset, referenceName, note = "") {
-    return `Wompify ${JSON.stringify(referenceName)} using the mesh-wompify skill; stop if that skill is unavailable.
-Selected tier: ${WOMPIFY_PRESETS[preset].label}.${note.trim() ? `\nUser request: ${note.trim()}` : ""}`;
+    return `Wompify ${JSON.stringify(referenceName)} at tier ${WOMPIFY_PRESETS[preset].label}.${note.trim() ? `\n${note.trim()}` : ""}`;
 }
 export function parseWompifyCommand(text) {
     const match = /^\/wompify (simple|high|ultra)(?:\n([\s\S]*))?$/u.exec(text.trim());

package/package.json

@@ -1,139 +1,140 @@
-{
-  "name": "@womp/spark-agent",
-  "version": "5.6.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.3",
-    "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.7.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",
+    "release:pack": "node scripts/npm-release.mjs pack"
+  },
+  "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.3",
+    "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"
+  }
+}

package/dist/sdk-openscad-renderer.d.ts

@@ -1,11 +0,0 @@
-import type { KakapoAPI } from "@womp/kakapo-sdk";
-import type { OpenScadBoundingBox } from "./openscad.js";
-export declare function waitForOpenScadRenderer(options: {
-    api: KakapoAPI;
-    objectId: number;
-    expectedBounds: OpenScadBoundingBox;
-    baselineBounds?: OpenScadBoundingBox;
-    signal: AbortSignal;
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-}): Promise<boolean>;

package/dist/sdk-openscad-renderer.js

@@ -1,71 +0,0 @@
-const OPENSCAD_RENDERER_WAIT_MS = 15_000;
-const OPENSCAD_RENDERER_POLL_MS = 250;
-function boundsMatch(actual, expected) {
-    const size = Math.max(expected.max.x - expected.min.x, expected.max.y - expected.min.y, expected.max.z - expected.min.z);
-    const tolerance = Math.max(size * 0.0001, 0.001);
-    return ["min", "max"].every((edge) => ["x", "y", "z"].every((axis) => Math.abs(actual[edge][axis] - expected[edge][axis]) <= tolerance));
-}
-function getBoundsBeforeDeadline(options) {
-    const remaining = options.deadline - Date.now();
-    if (remaining <= 0)
-        return Promise.resolve(undefined);
-    options.signal.throwIfAborted();
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        const finish = (action) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timeout);
-            options.signal.removeEventListener("abort", onAbort);
-            action();
-        };
-        const onAbort = () => finish(() => reject(options.signal.reason ?? new Error("The operation was aborted.")));
-        const timeout = setTimeout(() => finish(() => resolve(undefined)), remaining);
-        options.signal.addEventListener("abort", onAbort, { once: true });
-        if (options.signal.aborted) {
-            onAbort();
-            return;
-        }
-        void options.api.getNodeBoundingBox(options.objectId).then((bounds) => finish(() => resolve(bounds)), () => finish(() => resolve(undefined)));
-    });
-}
-function waitForPoll(signal, milliseconds) {
-    signal.throwIfAborted();
-    return new Promise((resolve, reject) => {
-        const onAbort = () => {
-            clearTimeout(timeout);
-            reject(signal.reason ?? new Error("The operation was aborted."));
-        };
-        const timeout = setTimeout(() => {
-            signal.removeEventListener("abort", onAbort);
-            resolve();
-        }, milliseconds);
-        signal.addEventListener("abort", onAbort, { once: true });
-        if (signal.aborted)
-            onAbort();
-    });
-}
-export async function waitForOpenScadRenderer(options) {
-    const deadline = Date.now() + (options.timeoutMs ?? OPENSCAD_RENDERER_WAIT_MS);
-    if (options.baselineBounds !== undefined &&
-        boundsMatch(options.baselineBounds, options.expectedBounds))
-        return false;
-    do {
-        const actual = await getBoundsBeforeDeadline({
-            api: options.api,
-            objectId: options.objectId,
-            signal: options.signal,
-            deadline,
-        });
-        options.signal.throwIfAborted();
-        if (Date.now() >= deadline)
-            return false;
-        if (actual !== undefined && boundsMatch(actual, options.expectedBounds))
-            return true;
-        const remaining = deadline - Date.now();
-        if (remaining <= 0)
-            return false;
-        await waitForPoll(options.signal, Math.min(options.pollIntervalMs ?? OPENSCAD_RENDERER_POLL_MS, remaining));
-    } while (true);
-}