@womp/spark-agent 7.0.0 → 9.0.0

package/dist/sdk-scene-host.js

@@ -10,7 +10,7 @@ function assertSceneSaved(operation) {
     if (operation.save?.status === "unknown" || operation.save?.status === "requested")
         throw new Error("The scene edit was applied, but its save outcome is unknown. Inspect persistence before continuing; do not repeat the edit.");
 }
-/** Carries this invocation's outcome without requiring a persistent journal. */
+/** A failed edit's outcome, for callers that settle per-edit state such as repair budgets. */
 export class SceneOperationError extends Error {
     operation;
     constructor(operation, cause) {
@@ -74,7 +74,6 @@ export function createSdkSceneDraft(api, scene, services) {
 export function createSdkSceneEditor(options) {
     const ordinals = new WeakMap();
     return {
-        getOperation: (operationId) => options.operations?.getSceneOperation(options.targetKey, operationId) ?? Promise.resolve(undefined),
         withConnection: (context, action) => options.withConnection(context, async (api, settle, active = context) => {
             active.signal.throwIfAborted();
             return action(api, settle);
@@ -131,7 +130,6 @@ export function createSdkSceneEditor(options) {
                             result: operation.result,
                             save: operation.save,
                             error: operation.error,
-                            ...(options.operations ? { synchronized } : {}),
                         }),
                     });
                 };
@@ -142,7 +140,6 @@ export function createSdkSceneEditor(options) {
                     try {
                         result = await executeSceneOperation({
                             api,
-                            store: options.operations,
                             onOutcome: operation => { outcome = operation; },
                             saveToRenderer: options.saveToRenderer,
                             operation: {
@@ -168,10 +165,9 @@ export function createSdkSceneEditor(options) {
                     catch (error) {
                         // Receipt persistence must not replace the original SDK/tool error.
                         try {
-                            const operation = outcome ?? await options.operations?.getSceneOperation(options.targetKey, id);
-                            if (operation) {
-                                synchronized = operation.status === "rolled_back";
-                                await record(operation);
+                            if (outcome) {
+                                synchronized = outcome.status === "rolled_back";
+                                await record(outcome);
                             }
                         }
                         catch {
@@ -180,12 +176,6 @@ export function createSdkSceneEditor(options) {
                         throw error;
                     }
                     saveSettled = !result.operation.changed || !["unknown", "requested"].includes(result.operation.save?.status ?? "");
-                    // A duplicate returns its journaled result; retain its original receipt
-                    // and let explicit recovery handle any earlier synchronization failure.
-                    if (result.reused) {
-                        assertSceneSaved(result.operation);
-                        return result;
-                    }
                     synchronized = !result.operation.changed || !options.onCommitted;
                     await record(result.operation);
                     if (!synchronized) {
@@ -216,7 +206,7 @@ export function createSdkSceneEditor(options) {
                     return result;
                 }
                 catch (error) {
-                    if (!options.operations && outcome)
+                    if (outcome)
                         throw new SceneOperationError(outcome, error);
                     throw error;
                 }

package/dist/server/sqlite-store.d.ts

@@ -2,11 +2,10 @@ import type { SparkGoal } from "../goals.js";
 import type { ExecutionScreenshot } from "../types.js";
 import type { SparkArtifact, StoredSparkChunk } from "../ui.js";
 import type { SparkArtifactStore, StoredSparkArtifact } from "./artifacts.js";
-import type { SceneOperation, SceneOperationStore } from "../scene-operations.js";
 import { type RepairStateStore } from "../repair-state.js";
 import type { SparkAgentStore, SparkConversation, SparkConversationSummary, SparkRun, SparkRunSettings } from "./types.js";
 /** Local development storage. Execution ownership belongs to the host service. */
-export declare class SqliteSparkStore implements SparkAgentStore, SparkArtifactStore, SceneOperationStore {
+export declare class SqliteSparkStore implements SparkAgentStore, SparkArtifactStore {
     private readonly artifactBaseUrl;
     private readonly database;
     private ownershipToken;
@@ -15,9 +14,6 @@ export declare class SqliteSparkStore implements SparkAgentStore, SparkArtifactS
     close(): void;
     claimExecutionOwnership(): void;
     listInterruptedRuns(): Promise<SparkRun[]>;
-    getSceneOperation(targetKey: string, id: string): Promise<SceneOperation | undefined>;
-    createSceneOperation(operation: SceneOperation): Promise<boolean>;
-    saveSceneOperation(operation: SceneOperation): Promise<SceneOperation>;
     createConversation(value: SparkConversation): Promise<void>;
     getConversation(id: string): Promise<SparkConversation | undefined>;
     listConversations(ownerId: string): Promise<SparkConversationSummary[]>;

package/dist/server/sqlite-store.js

@@ -2,7 +2,6 @@ import { mkdirSync } from "node:fs";
 import { dirname } from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import { emptyRepairState, } from "../repair-state.js";
-const completedSceneOperationLimit = 128;
 /** Local development storage. Execution ownership belongs to the host service. */
 export class SqliteSparkStore {
     artifactBaseUrl;
@@ -13,7 +12,7 @@ export class SqliteSparkStore {
         mkdirSync(dirname(path), { recursive: true });
         this.database = new DatabaseSync(path);
         const version = this.database.prepare("PRAGMA user_version").get()?.user_version;
-        if (version !== 0 && version !== 1 && version !== 2 && version !== 3 && version !== 4) {
+        if (version !== 0 && version !== 1 && version !== 2 && version !== 3 && version !== 4 && version !== 5) {
             this.database.close();
             throw new Error(`Unsupported Spark database version: ${version}`);
         }
@@ -39,14 +38,11 @@ export class SqliteSparkStore {
       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)
-      );
+      DROP TABLE IF EXISTS scene_operations;
       CREATE TABLE IF NOT EXISTS repair_states (
         target_key TEXT PRIMARY KEY, revision INTEGER NOT NULL, data TEXT NOT NULL
       );
-      PRAGMA user_version = 4;
+      PRAGMA user_version = 5;
     `);
     }
     repairStateStore(targetKey) {
@@ -111,39 +107,6 @@ export class SqliteSparkStore {
             throw new Error("Claim execution ownership before recovering runs");
         return this.database.prepare("SELECT data FROM runs WHERE json_extract(data, '$.status') IN ('queued', 'running')").all().map((row) => JSON.parse(String(row.data)));
     }
-    async getSceneOperation(targetKey, id) {
-        const row = this.database.prepare("SELECT data FROM scene_operations WHERE target_key = ? AND id = ?").get(targetKey, id);
-        return row ? JSON.parse(String(row.data)) : undefined;
-    }
-    async createSceneOperation(operation) {
-        const result = this.database.prepare("INSERT OR IGNORE INTO scene_operations VALUES (?, ?, ?, ?)").run(operation.targetKey, operation.id, operation.revision, JSON.stringify(operation));
-        return result.changes === 1;
-    }
-    async saveSceneOperation(operation) {
-        const next = { ...operation, revision: operation.revision + 1 };
-        this.database.exec("BEGIN IMMEDIATE");
-        try {
-            const result = this.database.prepare("UPDATE scene_operations SET revision = ?, data = ? WHERE target_key = ? AND id = ? AND revision = ?").run(next.revision, JSON.stringify(next), operation.targetKey, operation.id, operation.revision);
-            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 ?
-          )
-        `).run(next.targetKey, completedSceneOperationLimit);
-            }
-            this.database.exec("COMMIT");
-            return next;
-        }
-        catch (error) {
-            this.database.exec("ROLLBACK");
-            throw error;
-        }
-    }
     async createConversation(value) {
         this.database.prepare("INSERT INTO conversations VALUES (?, ?, ?, ?)")
             .run(value.id, value.ownerId, value.updatedAt, JSON.stringify(value));

package/dist/server/standalone.js

@@ -102,7 +102,6 @@ export async function createStandaloneSparkAgentApp(options) {
                 const targetKey = `${context.ownerId}:${sceneIdentity}`;
                 const editorOptions = {
                     targetKey,
-                    operations: store,
                     saveToRenderer: true,
                     withConnection: (invocation, action) => sceneAccess.run(invocation.signal, async (signal, beginSettlement) => {
                         if (!api.isConnected)

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

@@ -1,4 +1,4 @@
-import type { FontFamily, KakapoAPI, KakapoNode, NodeKind, SceneEdit, Vec2, Vec3 } from "@womp/kakapo-sdk";
+import type { BoundingBox, FontFamily, KakapoAPI, KakapoNode, NodeKind, SceneEdit, Vec2, Vec3 } from "@womp/kakapo-sdk";
 import { type SceneHdr } from "./scene-environment.js";
 import { type MirrorAxis } from "./coordinates.js";
 export declare const NodeType: {
@@ -81,6 +81,14 @@ export type WompSceneApiContext = {
 };
 export type WompSceneApi = ReturnType<typeof createWompSceneApi>;
 export declare function sceneNodeType(kind: NodeKind): number;
+export declare function convertAABB(box: BoundingBox, unitMultiplier: number): AABB;
+export type SceneNodeReader = {
+    requireNode(id: number): KakapoNode;
+    getNode(id: number): KakapoNode;
+};
+export declare function sceneNodePosition(reader: SceneNodeReader, rootId: number, unitMultiplier: number, id: number): Vec3;
+export declare function sceneNodeRotation(reader: SceneNodeReader, id: number): Vec3;
+export declare function sceneNodeSize(reader: SceneNodeReader, rootId: number, unitMultiplier: number, id: number): Vec3;
 /** Align local +Z toward target. Both points are in the same parent-local coordinates. */
 declare function lookAt(origin: Vec3, target: Vec3): Vec3;
 /** XYZ degrees aligning the selected positive local axis to a parent-local direction. */

package/dist/womp-scene-api.js

@@ -133,7 +133,7 @@ function normalizePrimitiveSize(primitive, size) {
 function scale(value, amount) {
     return { x: value.x * amount, y: value.y * amount, z: value.z * amount };
 }
-function convertAABB(box, unitMultiplier) {
+export function convertAABB(box, unitMultiplier) {
     return {
         min: {
             x: fromEnginePosition({ x: 0, y: 0, z: box.max.z }, unitMultiplier).x,
@@ -147,6 +147,41 @@ function convertAABB(box, unitMultiplier) {
         },
     };
 }
+function sceneAncestorScale(reader, rootId, id, includeSelf = false) {
+    let total = 1;
+    let current = includeSelf
+        ? reader.requireNode(id)
+        : reader.getNode(reader.requireNode(id).parentId ?? rootId);
+    const visited = new Set();
+    while (current.id !== rootId && !visited.has(current.id)) {
+        visited.add(current.id);
+        if (current.kind === "union")
+            total *= current.transform.scale.x;
+        const parentId = current.parentId;
+        if (parentId === null || parentId === rootId)
+            break;
+        current = reader.getNode(parentId);
+    }
+    return total;
+}
+export function sceneNodePosition(reader, rootId, unitMultiplier, id) {
+    return fromEnginePosition(scale(reader.requireNode(id).transform.position, sceneAncestorScale(reader, rootId, id)), unitMultiplier);
+}
+export function sceneNodeRotation(reader, id) {
+    return convertRotationBasis(reader.requireNode(id).transform.rotation);
+}
+export function sceneNodeSize(reader, rootId, unitMultiplier, id) {
+    const node = reader.requireNode(id);
+    const parentScale = sceneAncestorScale(reader, rootId, id);
+    if (node.kind === "group")
+        return { x: 1, y: 1, z: 1 };
+    if (node.kind === "union") {
+        const size = node.transform.scale.x * parentScale;
+        return { x: size, y: size, z: size };
+    }
+    const size = fromEngineDimensions(scale(node.transform.scale, parentScale), unitMultiplier);
+    return node.kind === "primitive" ? normalizePrimitiveSize(node.primitive, size) : size;
+}
 /** Align local +Z toward target. Both points are in the same parent-local coordinates. */
 function lookAt(origin, target) {
     if (![origin.x, origin.y, origin.z, target.x, target.y, target.z].every(Number.isFinite)) {
@@ -209,25 +244,10 @@ export function createWompSceneApi(context) {
             throw new Error("Curve V1 and V2 transforms are read-only");
         return node;
     };
-    const ancestorScale = (id, includeSelf = false) => {
-        let total = 1;
-        let current = includeSelf
-            ? requireNode(id)
-            : scene.getNode(requireNode(id).parentId ?? context.rootId);
-        const visited = new Set();
-        while (current.id !== context.rootId && !visited.has(current.id)) {
-            visited.add(current.id);
-            if (current.kind === "union")
-                total *= current.transform.scale.x;
-            const parentId = current.parentId;
-            if (parentId === null || parentId === context.rootId)
-                break;
-            current = scene.getNode(parentId);
-        }
-        return total;
-    };
-    const nodePosition = (id) => fromEnginePosition(scale(requireNode(id).transform.position, ancestorScale(id)), unitMultiplier);
-    const nodeRotation = (id) => convertRotationBasis(requireNode(id).transform.rotation);
+    const reader = { requireNode, getNode: (id) => scene.getNode(id) };
+    const ancestorScale = (id, includeSelf = false) => sceneAncestorScale(reader, context.rootId, id, includeSelf);
+    const nodePosition = (id) => sceneNodePosition(reader, context.rootId, unitMultiplier, id);
+    const nodeRotation = (id) => sceneNodeRotation(reader, id);
     const hasCsgBaseBefore = (parentId, nodeId, index) => {
         const siblings = scene.getNodeChildren(parentId).filter(({ id }) => id !== nodeId);
         const targetIndex = index ?? siblings.length;
@@ -237,18 +257,7 @@ export function createWompSceneApi(context) {
             sibling.kind === "group" ||
             ("operation" in sibling && sibling.operation === "union"));
     };
-    const nodeSize = (id) => {
-        const node = requireNode(id);
-        const parentScale = ancestorScale(id);
-        if (node.kind === "group")
-            return { x: 1, y: 1, z: 1 };
-        if (node.kind === "union") {
-            const size = node.transform.scale.x * parentScale;
-            return { x: size, y: size, z: size };
-        }
-        const size = fromEngineDimensions(scale(node.transform.scale, parentScale), unitMultiplier);
-        return node.kind === "primitive" ? normalizePrimitiveSize(node.primitive, size) : size;
-    };
+    const nodeSize = (id) => sceneNodeSize(reader, context.rootId, unitMultiplier, id);
     const update = (id, changes) => {
         context.call("updateNode", [id, changes], () => scene.updateNode(id, changes));
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@womp/spark-agent",
-  "version": "7.0.0",
+  "version": "9.0.0",
   "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
   "type": "module",
   "main": "./dist/index.js",
@@ -113,7 +113,7 @@
     "@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/flowir": "0.5.0",
     "@womp/kakapo-sdk": "0.8.0",
     "ai": "7.0.95",
     "eventsource-parser": "^3.0.6",