@womp/spark-agent 3.0.0 → 3.0.2

package/dist/agent-tools.js

@@ -82,7 +82,7 @@ export function createSparkTools(options) {
                     },
                 };
                 const logs = [];
-                const receipts = [];
+                const receipts = new Map();
                 const artifacts = [];
                 const pending = new Set();
                 let outputBytes = 0;
@@ -117,7 +117,7 @@ export function createSparkTools(options) {
                         }
                     }),
                     recordReceipt: (receipt) => {
-                        receipts.push(receipt);
+                        receipts.set(receipt.id, structuredClone(receipt));
                         options.write({
                             type: "data-execution-receipt",
                             id: receipt.id,
@@ -169,7 +169,7 @@ export function createSparkTools(options) {
                         purpose: input.purpose,
                         value: jsonValue(value),
                         logs,
-                        receipts,
+                        receipts: [...receipts.values()],
                         artifacts,
                     };
                 }
@@ -182,7 +182,7 @@ export function createSparkTools(options) {
                         purpose: input.purpose,
                         value: null,
                         logs,
-                        receipts,
+                        receipts: [...receipts.values()],
                         artifacts,
                         error: errorMessage(error),
                     };

package/dist/agent.js

@@ -144,6 +144,7 @@ export function runSparkAgent(options) {
                                 toolNames: step.toolCalls.map(({ toolName }) => toolName),
                                 responseTimeMs: step.performance.responseTimeMs,
                                 cost: calculateStepCost(options.modelId, step.usage),
+                                usage: step.usage,
                             },
                         });
                         if (options.persistence?.saveMessage !== undefined) {

package/dist/capabilities/health.js

@@ -7,7 +7,7 @@ export function createSceneHealthCapability(host) {
                 name: "scene-health",
                 version: "1",
                 description: "Required before scene checks or procedural edits: engine limits, empty Areas, fresh geometry feedback, and bounded repairs.",
-                instructions: `Before checking or editing a model, call womp.health.read([]) for current scene health. A health read is a snapshot and does not prove that the latest edit finished evaluating. Inspect scene edit receipts before claiming success.
+                instructions: `Before checking or editing a model, call womp.health.read([]) for current scene health. A health read is a snapshot and does not prove that the latest edit finished evaluating. Inspect scene edit receipts before claiming success.
 For confirmed primitive or depth overflow, repair the same target while preserving design, dimensions, active parameter overrides, and unrelated objects. At most two geometry repairs are allowed per target in one logical run. Unverified feedback must not trigger blind regeneration or a claim that the model passed. Empty Areas may be pending, intentionally empty, mesh-only, or failed. Overflow flags take precedence over possibly stale counts. max_total_depth is a scene hierarchy limit, not measured Boolean depth.`,
                 declarations: WOMP_HEALTH_DECLARATIONS,
                 examples: ["print(await womp.health.read([]));"],

package/dist/capabilities/operations.js

@@ -79,34 +79,34 @@ export function createOperationsCapability(host) {
                 name: "generation",
                 version: "5",
                 description: "Generate or edit images and meshes, inspect jobs, and wait for their outputs.",
-                instructions: `Read operations.catalog() for the currently available models and selected defaults.
-Use generation for inline chat results. If the user is working in their Flow graph and flow-graphs is available,
-add the generation to that graph instead unless they request an inline result. When they want repeated variations,
-offer a reusable Flow workflow if available; accepting that offer means editing the graph, not submitting another inline job.
-Use generate() for image/mesh generation, image editing, upscaling, or background removal. Model IDs must
-come from the catalog and support the requested operation. An unavailable or restricted explicit choice
-is an error; do not silently substitute another model. Omit model IDs to use the user's defaults.
-For text-to-mesh, imageParams configures the image step and params configures the mesh step. For
-image-to-mesh, an optional prompt requests an image-editing step first. Advanced params are JSON
-values passed to the existing service; use documented options and do not invent provider settings.
-Author the full text-to-mesh image prompt yourself, preserving the user's requested subject and details.
-For a standalone object, describe a clear three-quarter view with a plain background and even lighting
-unless the user requests otherwise. Do not rely on another model to expand or rewrite this prompt.
-Inputs are image references returned by the available assets API or a previous completed operation.
-Do not fabricate references, replace a missing input with another image, or pass arbitrary URLs.
-Assign a short, distinct key to each intended job. Reuse that key when checking the same submission;
-never choose a new key merely to retry a timeout or unknown outcome. A key cannot identify two
-different requests. Host receipts and saved message IDs record submitted effects.
-generate() waits for cost confirmation and then for completion, failure, or cancellation.
-Use exactly one generation per execute_javascript call and print its result. Put follow-up work in
-another call. Do not poll, start background work, use Promise.all, or report success before completion.
-The host waits without consuming model steps. Pause ends the local wait, not an accepted backend job.
-Refresh recovery reconnects the same job. It never resumes the interrupted JavaScript stack.
-Inspect a recovered result and continue remaining work in a new call; do not repeat generation.
-Use list() to discover existing jobs. Follow nextFrom even when a page has no jobs.
-An uncertain submission requires inspection, never a replacement request.
-Only returned outputs exist. Emit images/files to inspect or show them; generating a mesh does not
-import it into the scene. Use the assets skill for importing. Stopping the agent ends its wait and
+                instructions: `Read operations.catalog() for the currently available models and selected defaults.
+Use generation for inline chat results. If the user is working in their Flow graph and flow-graphs is available,
+add the generation to that graph instead unless they request an inline result. When they want repeated variations,
+offer a reusable Flow workflow if available; accepting that offer means editing the graph, not submitting another inline job.
+Use generate() for image/mesh generation, image editing, upscaling, or background removal. Model IDs must
+come from the catalog and support the requested operation. An unavailable or restricted explicit choice
+is an error; do not silently substitute another model. Omit model IDs to use the user's defaults.
+For text-to-mesh, imageParams configures the image step and params configures the mesh step. For
+image-to-mesh, an optional prompt requests an image-editing step first. Advanced params are JSON
+values passed to the existing service; use documented options and do not invent provider settings.
+Author the full text-to-mesh image prompt yourself, preserving the user's requested subject and details.
+For a standalone object, describe a clear three-quarter view with a plain background and even lighting
+unless the user requests otherwise. Do not rely on another model to expand or rewrite this prompt.
+Inputs are image references returned by the available assets API or a previous completed operation.
+Do not fabricate references, replace a missing input with another image, or pass arbitrary URLs.
+Assign a short, distinct key to each intended job. Reuse that key when checking the same submission;
+never choose a new key merely to retry a timeout or unknown outcome. A key cannot identify two
+different requests. Host receipts and saved message IDs record submitted effects.
+generate() waits for cost confirmation and then for completion, failure, or cancellation.
+Use exactly one generation per execute_javascript call and print its result. Put follow-up work in
+another call. Do not poll, start background work, use Promise.all, or report success before completion.
+The host waits without consuming model steps. Pause ends the local wait, not an accepted backend job.
+Refresh recovery reconnects the same job. It never resumes the interrupted JavaScript stack.
+Inspect a recovered result and continue remaining work in a new call; do not repeat generation.
+Use list() to discover existing jobs. Follow nextFrom even when a page has no jobs.
+An uncertain submission requires inspection, never a replacement request.
+Only returned outputs exist. Emit images/files to inspect or show them; generating a mesh does not
+import it into the scene. Use the assets skill for importing. Stopping the agent ends its wait and
 prevents further submissions; it does not claim to cancel a job already accepted by the service.`,
                 declarations: WOMP_OPERATIONS_DECLARATIONS,
                 examples: [

package/dist/capabilities/scene.js

@@ -11,34 +11,34 @@ export function createSceneCapability(host) {
                 name: "scene-editing",
                 version: "5",
                 description: "Inspect the open scene and edit its objects, materials, curves, and environment.",
-                instructions: `Read the scene first and keep its revision and object IDs. Call scene.edit(callback, expectedRevision)
-for one coherent undoable change. The callback receives a draft; all node/material/curve functions and enums
-are properties of that draft. The draft expires when the callback ends. Await asynchronous methods.
-Do not start unrelated operations from inside an edit. A stale revision requires reading again.
-Preserve the existing scene unless asked to remove or replace content. Use semantic object names and reuse
-known IDs when editing rather than creating duplicates. Distances follow the current project's units
-(read().unitMultiplier is 1 for millimetres, 0.1 for centimetres, approximately 0.0393701 for inches).
-Convert a dimension in millimetres to project units by multiplying it by read().unitMultiplier.
-Area size is a dimensionless scale; Group size stays fixed at one. Light size has x/y dimensions.
-Blend and mirror goop use millimetres regardless of project units. V1/V2 curve transforms are read-only;
-edit their points instead. Handles and closure are available only on V3 Bezier curves.
-Rotations use degrees and colors use RGB values from 0 to 255. Use the exposed enums instead of guessing values.
-For visible geometry color, create or clone a material, call materialSetColor, and assign it with nodeSetMaterialId.
-nodeSetColor writes the node color field (used by lights); it does not replace a geometry object's material color.
-Do not recolor a shared material unless every object using it should change. Create and assign the material in the same edit as the geometry.
-Create primitives, curves, and text inside Areas/Unions. Respect tree order for subtraction and intersection.
-Use groups for organization and unions for blended masses. Build silhouette and proportions before detail.
-For organic joins, overlap primitives and use appropriate blend; keep crisp accessories separate.
-Check font, HDR, and material catalogs before selecting names. A host can explicitly report a catalog as
-unavailable. Selecting an HDR resets its intensity; apply a custom intensity after selecting it.
-For library materials, use listSuperMaterials(), then await materialImport(name) inside scene.edit and assign the returned numeric ID with nodeSetMaterialId or curvePointSetMaterialId. Await the import before returning from the edit; a failed import rolls back the draft.
-Filter large read results with JavaScript and print only useful details. Never dump the entire scene by default.
-After a major edit, capture a screenshot outside the transaction and emitImage its reference. To inspect a
-new object, frame its owning Area with screenshot({ targetId: areaId, view: 'isometric' }); omit these options
-to preserve the current camera view. Do not change a locked camera without the user's instruction. Verify silhouette,
-connections, openings, proportions, and materials before claiming completion. Renderer bounds and resize calls
-must finish before subsequent writes. Inside scene.edit, complete renderer-backed bounds reads before the first
-draft mutation; the SDK rejects them once the draft is dirty. Inspect committed results when renderer state has not caught up.
+                instructions: `Read the scene first and keep its revision and object IDs. Call scene.edit(callback, expectedRevision)
+for one coherent undoable change. The callback receives a draft; all node/material/curve functions and enums
+are properties of that draft. The draft expires when the callback ends. Await asynchronous methods.
+Do not start unrelated operations from inside an edit. A stale revision requires reading again.
+Preserve the existing scene unless asked to remove or replace content. Use semantic object names and reuse
+known IDs when editing rather than creating duplicates. Distances follow the current project's units
+(read().unitMultiplier is 1 for millimetres, 0.1 for centimetres, approximately 0.0393701 for inches).
+Convert a dimension in millimetres to project units by multiplying it by read().unitMultiplier.
+Area size is a dimensionless scale; Group size stays fixed at one. Light size has x/y dimensions.
+Blend and mirror goop use millimetres regardless of project units. V1/V2 curve transforms are read-only;
+edit their points instead. Handles and closure are available only on V3 Bezier curves.
+Rotations use degrees and colors use RGB values from 0 to 255. Use the exposed enums instead of guessing values.
+For visible geometry color, create or clone a material, call materialSetColor, and assign it with nodeSetMaterialId.
+nodeSetColor writes the node color field (used by lights); it does not replace a geometry object's material color.
+Do not recolor a shared material unless every object using it should change. Create and assign the material in the same edit as the geometry.
+Create primitives, curves, and text inside Areas/Unions. Respect tree order for subtraction and intersection.
+Use groups for organization and unions for blended masses. Build silhouette and proportions before detail.
+For organic joins, overlap primitives and use appropriate blend; keep crisp accessories separate.
+Check font, HDR, and material catalogs before selecting names. A host can explicitly report a catalog as
+unavailable. Selecting an HDR resets its intensity; apply a custom intensity after selecting it.
+For library materials, use listSuperMaterials(), then await materialImport(name) inside scene.edit and assign the returned numeric ID with nodeSetMaterialId or curvePointSetMaterialId. Await the import before returning from the edit; a failed import rolls back the draft.
+Filter large read results with JavaScript and print only useful details. Never dump the entire scene by default.
+After a major edit, capture a screenshot outside the transaction and emitImage its reference. To inspect a
+new object, frame its owning Area with screenshot({ targetId: areaId, view: 'isometric' }); omit these options
+to preserve the current camera view. Do not change a locked camera without the user's instruction. Verify silhouette,
+connections, openings, proportions, and materials before claiming completion. Renderer bounds and resize calls
+must finish before subsequent writes. Inside scene.edit, complete renderer-backed bounds reads before the first
+draft mutation; the SDK rejects them once the draft is dirty. Inspect committed results when renderer state has not caught up.
 A failed script can retain earlier committed effects. Use receipts and inspect unknown outcomes before retrying.`,
                 declarations: WOMP_SCENE_DECLARATIONS,
                 examples: [