@womp/spark-agent 5.6.1 → 5.7.1

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/goals.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import type { SparkRunSettings } from "./server/types.js";
+export declare const MAX_GOAL_LENGTH = 4000;
+export type SparkGoal = {
+    id: string;
+    objective: string;
+    status: "active" | "paused" | "completed" | "blocked" | "budget_limited";
+    settings: SparkRunSettings;
+    createdAt: string;
+    updatedAt: string;
+    turns: number;
+    tokensUsed: number;
+    maxTurns?: number;
+    idleTurns?: number;
+    tokenBudget?: number;
+    creditBudget?: number;
+    budget?: {
+        limit: number;
+        spent: number;
+    };
+    lastReason?: string;
+    /** The latest run allowed to evaluate or continue this goal. */
+    runId?: string;
+};
+export declare const sparkGoalCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"set">;
+    objective: z.ZodString;
+    tokenBudget: z.ZodOptional<z.ZodNumber>;
+    creditBudget: z.ZodOptional<z.ZodNumber>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodEnum<{
+        status: "status";
+        pause: "pause";
+        resume: "resume";
+        clear: "clear";
+    }>;
+}, z.core.$strip>], "action">;
+export type SparkGoalCommand = z.infer<typeof sparkGoalCommandSchema>;
+export declare function goalTokenCount(usage: unknown): number;
+export declare const DEFAULT_GOAL_CREDITS = 50000;
+/** Only the explicit slash command starts a goal; prose inside an ordinary message does not. */
+export declare function parseSparkGoalCommand(text: string): SparkGoalCommand | undefined;

package/dist/goals.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export const MAX_GOAL_LENGTH = 4_000;
+export const sparkGoalCommandSchema = z.discriminatedUnion("action", [
+    z.object({
+        action: z.literal("set"),
+        objective: z.string().trim().min(1).max(MAX_GOAL_LENGTH),
+        tokenBudget: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+        creditBudget: z.number().int().positive().max(1_000_000_000).optional(),
+        maxTurns: z.number().int().min(1).max(100).optional(),
+    }),
+    z.object({ action: z.enum(["status", "pause", "resume", "clear"]) }),
+]);
+export function goalTokenCount(usage) {
+    if (!usage || typeof usage !== "object")
+        return 0;
+    const value = usage;
+    const total = value.totalTokens ?? ((value.inputTokens ?? 0) + (value.outputTokens ?? 0));
+    return Number.isSafeInteger(total) && total >= 0 ? total : 0;
+}
+export const DEFAULT_GOAL_CREDITS = 50_000;
+/** Only the explicit slash command starts a goal; prose inside an ordinary message does not. */
+export function parseSparkGoalCommand(text) {
+    const match = /^\/goal(?:\s+([\s\S]*))?$/i.exec(text.trim());
+    if (!match)
+        return undefined;
+    let objective = (match[1] ?? "").trim();
+    if (["status", "pause", "resume", "clear"].includes(objective.toLowerCase()))
+        return { action: objective.toLowerCase() };
+    objective = objective.replace(/^["Ҭ]([\s\S]*)["Ӭ]$/, "$1").trim();
+    const cap = /(?:[,;]?[\s]+)?cap\s+at\s+(\S+)\s+credits[.!]?$/i.exec(objective);
+    if (cap && !/^(?:\d+|\d{1,3}(?:,\d{3})+|\d{1,3}(?:\.\d{3})+)$/.test(cap[1]))
+        throw new Error("Use a whole number of credits, for example cap at 1000 credits.");
+    const creditBudget = cap ? Number(cap[1].replace(/[.,]/g, "")) : DEFAULT_GOAL_CREDITS;
+    if (cap)
+        objective = objective.slice(0, cap.index).trim().replace(/^["Ҭ]([\s\S]*)["Ӭ]$/, "$1").trim();
+    return sparkGoalCommandSchema.parse({ action: "set", objective, creditBudget });
+}