@womp/spark-agent 6.5.0 → 8.0.0

package/dist/geometry/schemas/flowir-dialect.json

@@ -4,10 +4,7 @@
     "Float",
     "Bool",
     "Vec3",
-    "Geometry",
-    "Int[]",
-    "Float[]",
-    "Vec3[]"
+    "Geometry"
   ],
   "enums": [
     {
@@ -117,6 +114,16 @@
       "to": "Vec3[]",
       "desc": "wrap: v -> [v]"
     },
+    {
+      "from": "Float",
+      "to": "Float[]",
+      "desc": "wrap: x -> [x]"
+    },
+    {
+      "from": "Int",
+      "to": "Float[]",
+      "desc": "promote then wrap: x -> [x]"
+    },
     {
       "from": "Float[]",
       "to": "Vec3[]",
@@ -127,6 +134,11 @@
       "to": "Float[]",
       "desc": "extract X: [Vec3(a,b,c)] -> [a]"
     },
+    {
+      "from": "Float[]",
+      "to": "Vec3",
+      "desc": "take first element, then splat"
+    },
     {
       "from": "Vec3[]",
       "to": "Vec3",
@@ -158,6 +170,16 @@
       "desc": "promote each"
     }
   ],
+  "param": [
+    "Int",
+    "Float",
+    "Vec3"
+  ],
+  "const": [
+    "Int",
+    "Float",
+    "Vec3"
+  ],
   "nodes": [
     {
       "name": "Primitive",
@@ -165,17 +187,17 @@
       "inputs": [
         {
           "name": "Type",
-          "type": "PrimitiveType",
-          "enum": "PrimitiveType"
+          "type": "PrimitiveType"
         },
         {
           "name": "Position",
           "type": "Vec3",
-          "desc": "center in world space"
+          "desc": "center in world space; y is up"
         },
         {
           "name": "Rotation",
-          "type": "Vec3"
+          "type": "Vec3",
+          "desc": "degrees about X, Y and Z"
         },
         {
           "name": "Size",
@@ -224,18 +246,22 @@
         },
         {
           "name": "Positions",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "Rotations",
           "type": "Vec3[]",
-          "lift": "len1"
+          "desc": [
+            "Left out, every instance keeps its original rotation.",
+            "Degrees about X, Y and Z; a Float or Float[] splats onto all three axes, so use CombineXYZ to turn about one axis."
+          ],
+          "optional": true
         },
         {
           "name": "Scales",
           "type": "Vec3[]",
-          "lift": "len1"
+          "desc": "Left out, every instance keeps its original size.",
+          "optional": true
         }
       ],
       "outputs": [
@@ -244,10 +270,9 @@
           "type": "Geometry"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
-        "defaults: Scales=Vec3(1,1,1).",
-        "Emit one instance per index."
+      "desc": [
+        "One copy per element of the longest of Positions, Rotations and Scales, and at least one; past the end of an input, its first value is used.",
+        "Copy i is the input geometry scaled by Scales[i], rotated by Rotations[i] about the origin, then moved by Positions[i]; the input's own position stays inside each copy, so build the input at the origin."
       ]
     },
     {
@@ -257,7 +282,6 @@
         {
           "name": "Operation",
           "type": "BooleanOp",
-          "enum": "BooleanOp",
           "desc": "Subtract removes B from A; A is the body that survives and B is the cutter. Operations apply in graph order, so Subtract also removes B from geometry unioned into A earlier."
         },
         {
@@ -299,18 +323,15 @@
       "inputs": [
         {
           "name": "X",
-          "type": "Float[]",
-          "lift": "len1"
+          "type": "Float[]"
         },
         {
           "name": "Y",
-          "type": "Float[]",
-          "lift": "len1"
+          "type": "Float[]"
         },
         {
           "name": "Z",
-          "type": "Float[]",
-          "lift": "len1"
+          "type": "Float[]"
         }
       ],
       "outputs": [
@@ -319,8 +340,10 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing."
+      "desc": [
+        "Builds Vec3 values from Float or Float[] components.",
+        "Arrays combine element by element: the result is as long as the longest input, and a shorter input repeats its first value.",
+        "It pairs X[i], Y[i] and Z[i]: arrays of n values give n vectors, never every combination."
       ]
     },
     {
@@ -329,8 +352,7 @@
       "inputs": [
         {
           "name": "XYZ",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -354,18 +376,15 @@
       "inputs": [
         {
           "name": "Operation",
-          "type": "GeoNodeMathOp",
-          "enum": "GeoNodeMathOp"
+          "type": "GeoNodeMathOp"
         },
         {
           "name": "A",
-          "type": "Float[]",
-          "lift": "len1"
+          "type": "Float[]"
         },
         {
           "name": "B",
-          "type": "Float[]",
-          "lift": "len1"
+          "type": "Float[]"
         }
       ],
       "outputs": [
@@ -374,8 +393,8 @@
           "type": "Float[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
+      "desc": [
+        "Arrays combine element by element: the result is as long as the longest input, and a shorter input repeats its first value.",
         "Unary ops read A and ignore B.",
         "Trig ops take radians.",
         "For DotProduct or CrossProduct, use MathVec3."
@@ -387,18 +406,15 @@
       "inputs": [
         {
           "name": "Operation",
-          "type": "GeoNodeMathOp",
-          "enum": "GeoNodeMathOp"
+          "type": "GeoNodeMathOp"
         },
         {
           "name": "A",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "B",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -407,8 +423,8 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
+      "desc": [
+        "Arrays combine element by element: the result is as long as the longest input, and a shorter input repeats its first value.",
         "Unary ops read A and ignore B.",
         "Trig ops take radians."
       ]
@@ -428,9 +444,8 @@
           "type": "Float[]"
         }
       ],
-      "semantics": [
-        "Output length = max(Count,0).",
-        "Values[i] = float(i) for i in [0,n)."
+      "desc": [
+        "Values[i] = float(i) for i in [0,Count); Count is 0 or more."
       ]
     },
     {
@@ -439,13 +454,11 @@
       "inputs": [
         {
           "name": "Rotations",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "Vectors",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -454,9 +467,8 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
-        "defaults: Vectors=Vec3(0,0,1).",
+      "desc": [
+        "Arrays combine element by element: the result is as long as the longest input, and a shorter input repeats its first value.",
         "Aligns local +Z to each Vector via shortest-arc rotation."
       ]
     },
@@ -470,18 +482,19 @@
         },
         {
           "name": "Positions",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "Rotations",
           "type": "Vec3[]",
-          "lift": "len1"
+          "desc": "Left out, every primitive keeps its rotation.",
+          "optional": true
         },
         {
           "name": "Scales",
           "type": "Vec3[]",
-          "lift": "len1"
+          "desc": "Left out, every primitive keeps its size.",
+          "optional": true
         }
       ],
       "outputs": [
@@ -490,9 +503,8 @@
           "type": "Geometry"
         }
       ],
-      "semantics": [
-        "per-primitive with repeat-first indexing.",
-        "defaults: Scales=Vec3(1,1,1).",
+      "desc": [
+        "Element i applies to primitive i; past the end of an input, its first value is used.",
         "Does NOT duplicate geometry (use InstancePrimitive to duplicate)."
       ]
     },
@@ -516,7 +528,7 @@
           "type": "Geometry"
         }
       ],
-      "semantics": [
+      "desc": [
         "Assigns Material to every primitive in Geometry; geometry passes through unchanged.",
         "Material=<id> takes an existing scene material ID, never a color, name, or hex.",
         "Material=0 selects the scene default material.",
@@ -555,7 +567,7 @@
           "type": "Geometry"
         }
       ],
-      "semantics": [
+      "desc": [
         "Outputs geometry at slot Index (0=A, 1=B, 2=C, 3=D).",
         "Returns empty geometry if Index is out of range [0,3]."
       ]
@@ -570,8 +582,7 @@
         },
         {
           "name": "Type",
-          "type": "LatticeType",
-          "enum": "LatticeType"
+          "type": "LatticeType"
         },
         {
           "name": "Position",
@@ -585,8 +596,8 @@
         },
         {
           "name": "Scale",
-          "type": "Float",
-          "desc": "uniform cell size"
+          "type": "Vec3",
+          "desc": "uniform cell size; a Float splats to all three components"
         },
         {
           "name": "Thickness",
@@ -605,7 +616,7 @@
           "type": "Geometry"
         }
       ],
-      "semantics": [
+      "desc": [
         "Fills geometry with a lattice infill pattern."
       ]
     },
@@ -641,7 +652,7 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Scatters random points inside the SDF volume."
       ]
     },
@@ -656,7 +667,7 @@
         {
           "name": "Spacing",
           "type": "Vec3",
-          "desc": "min 1.0 per component"
+          "desc": "each component above 0 counts as at least 1.0; a component of 0 gives no points"
         },
         {
           "name": "AABBMin",
@@ -673,7 +684,7 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Places grid-spaced points inside the SDF volume.",
         "Only points inside the volume are output."
       ]
@@ -688,7 +699,8 @@
         },
         {
           "name": "Density",
-          "type": "Float"
+          "type": "Int",
+          "desc": "a whole number, 1 or more; higher gives more points, and values below 1 give no points"
         },
         {
           "name": "Seed",
@@ -705,7 +717,7 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Scatters random points on the surface of Geometry."
       ]
     },
@@ -737,7 +749,7 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Centered at origin.",
         "Total points = VerticesX*VerticesY*VerticesZ.",
         "Evenly spaced within [-Size/2, +Size/2]."
@@ -749,8 +761,7 @@
       "inputs": [
         {
           "name": "Mode",
-          "type": "GeoNodeRemapRangeOp",
-          "enum": "GeoNodeRemapRangeOp"
+          "type": "GeoNodeRemapRangeOp"
         },
         {
           "name": "Clamp",
@@ -759,28 +770,23 @@
         },
         {
           "name": "Value",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "FromMin",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "FromMax",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "ToMin",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "ToMax",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -789,9 +795,8 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
-        "defaults: Value=1, FromMax=1, ToMax=1.",
+      "desc": [
+        "The result has one element per Value element; past the end of a bound, its first value is used.",
         "Per-component: output = (Value-FromMin)/(FromMax-FromMin)*(ToMax-ToMin)+ToMin."
       ]
     },
@@ -801,18 +806,15 @@
       "inputs": [
         {
           "name": "Value",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "Min",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "Max",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -821,9 +823,8 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
-        "defaults: Value=1, Max=1.",
+      "desc": [
+        "The result has one element per Value element; past the end of a bound, its first value is used.",
         "Per-component: output[i] = clamp(Value[i], Min[i], Max[i])."
       ]
     },
@@ -833,18 +834,15 @@
       "inputs": [
         {
           "name": "A",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "B",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         },
         {
           "name": "Factor",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -853,9 +851,8 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
-        "zip-by-max with repeat-first indexing.",
-        "defaults: Factor=Vec3(1,1,1).",
+      "desc": [
+        "The result is as long as the longer of A and B; past the end of an input, its first value is used, and Factor does not lengthen it.",
         "Per-component: output = A + (B-A)*Factor."
       ]
     },
@@ -866,8 +863,7 @@
         {
           "name": "Domain",
           "type": "Float[]",
-          "lift": "len1",
-          "desc": "determines output length, min 1, values ignored"
+          "desc": "sets the output length: one value per element, at least one"
         },
         {
           "name": "Min",
@@ -888,7 +884,7 @@
           "type": "Float[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Generates one random float per Domain element in [Min,Max]."
       ]
     },
@@ -899,8 +895,7 @@
         {
           "name": "Domain",
           "type": "Vec3[]",
-          "lift": "len1",
-          "desc": "determines output length, min 1, values ignored"
+          "desc": "sets the output length: one value per element, at least one"
         },
         {
           "name": "Min",
@@ -921,7 +916,7 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Generates one random Vec3 per Domain element.",
         "Each component independently sampled in [Min.xyz, Max.xyz]."
       ]
@@ -953,7 +948,7 @@
           "type": "Vec3"
         }
       ],
-      "semantics": [
+      "desc": [
         "Tight axis-aligned bounding box of Geometry's SDF volume.",
         "Center=(Min+Max)/2, Size=Max-Min."
       ]
@@ -993,7 +988,7 @@
           "type": "Int[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Returns integer indices [0, 1, ..., len(Domain)-1].",
         "Output length equals Domain length."
       ]
@@ -1004,8 +999,7 @@
       "inputs": [
         {
           "name": "Angles",
-          "type": "Vec3[]",
-          "lift": "len1"
+          "type": "Vec3[]"
         }
       ],
       "outputs": [
@@ -1014,10 +1008,16 @@
           "type": "Vec3[]"
         }
       ],
-      "semantics": [
+      "desc": [
         "Per-element: takes Angles[i].x as angle in radians.",
         "Output[i] = Vec3(sin(a), 0, cos(a))."
       ]
     }
+  ],
+  "outputs": [
+    {
+      "name": "Geometry",
+      "type": "Geometry"
+    }
   ]
 }

package/dist/geometry/writeParamData.js

@@ -1,4 +1,4 @@
-import { buildIncomingMap, resolveParamTypeIds, titleToAstName, } from "./common.js";
+import { buildIncomingMap, paramName, resolveParamTypeIds, } from "./common.js";
 /**
  * Build a map from IR param name → value-node backend ID by inspecting
  * a graph for value nodes connected to GroupInputParam nodes.
@@ -17,10 +17,10 @@ export function buildParamMap(graph, graphExt, gipTypeId, valueTypeIds) {
         });
         if (!gipEdge)
             continue;
-        const extName = graphExt.nodes?.[gipEdge.fromBid]?.name;
-        if (!extName)
+        const name = paramName(graphExt, bid, gipEdge.fromBid);
+        if (!name)
             continue;
-        paramMap.set(titleToAstName(extName), bid);
+        paramMap.set(name, bid);
     }
     return paramMap;
 }

package/dist/geometry.d.ts

@@ -1,10 +1,7 @@
 export { backendRegistry, compileGeometry, flowirRegistry, migrateGraphExt, readEditableGeometry, } from "./geometry/compiler.js";
-export { createGeoNodesRegistry, loadGeoNodesDialect, } from "./geometry/index.js";
+export { createGeoNodesRegistry } from "./geometry/index.js";
 export type { GeometryGraph, GraphData } from "./geometry/graph.js";
 export { graphDataSchema, geometryGraphSchema, graphExtSchema, } from "./geometry/graph.js";
 export { migrateParameterOverrides, readParameterOverrides, } from "./geometry/parameters.js";
 export type { BackendNodeSchema, BackendPort, BackendValue, GraphExt, } from "./geometry/backendRegistry.js";
-export declare function geometryReference(): {
-    rules: string;
-    catalog: string;
-};
+export declare function geometryReference(): string;

package/dist/geometry.js

@@ -1,20 +1,16 @@
 import * as flowir from "@womp/flowir";
 import { flowirRegistry } from "./geometry/compiler.js";
 export { backendRegistry, compileGeometry, flowirRegistry, migrateGraphExt, readEditableGeometry, } from "./geometry/compiler.js";
-export { createGeoNodesRegistry, loadGeoNodesDialect, } from "./geometry/index.js";
+export { createGeoNodesRegistry } from "./geometry/index.js";
 export { graphDataSchema, geometryGraphSchema, graphExtSchema, } from "./geometry/graph.js";
 export { migrateParameterOverrides, readParameterOverrides, } from "./geometry/parameters.js";
 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.
-${flowir.renderDslRulesBlock()}`,
-        catalog: flowir.renderSchemaBlock(flowirRegistry.getSchema()),
-    };
+    reference ??= `${flowir.renderPrompt(flowirRegistry)}
+
+An example program:
+param Float diameter = 14.0 min=2 max=60 step=0.5
+node gem Primitive Type=Octahedron Position=Vec3(0.0,0.0,0.0) Rotation=Vec3(0.0,45.0,0.0) Size=diameter Roundness=0.1
+out Geometry=gem.Geometry`;
     return reference;
 }

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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 type { SparkCompactionLimits } from "./compaction.js";
-export * from "./context-budget.js";
+export { applyCompaction, latestCompaction, type SparkCompactionLimits } from "./compaction.js";
+export * from "./context-window.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";