@womp/spark-agent 5.12.0 → 5.12.1

package/README.md

@@ -348,7 +348,8 @@ Prompt caching is enabled for every listed model: Claude Opus 5 and Fable 5 use
 automatic 5-minute caching, and GPT-6 Astra uses implicit caching with a 30-minute TTL.
 The providers manage the cache as message history grows across tool steps; no local
 response cache is used. Cache hits require matching prefixes, sufficient prompt length,
-and an unexpired entry. Cache writes can cost more than uncached input, while subsequent
+and an unexpired entry. Goal state stays out of the system prompt: objectives,
+goal rules and evaluator feedback arrive in appended goal messages. Cache writes can cost more than uncached input, while subsequent
 cache reads are cheaper. The UI displays actual reported reads/writes, not assumed savings.
 See [Claude caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
 and [OpenAI caching](https://developers.openai.com/api/docs/guides/prompt-caching).

package/dist/agent.js

@@ -124,6 +124,8 @@ export function runSparkAgent(options) {
                     controller,
                     write: (chunk) => writer.write(chunk),
                 });
+                // Must stay identical across the turns of a conversation: any change misses the
+                // provider's prompt cache for everything after it. Changing state belongs in messages.
                 const readSystem = () => [
                     options.instructions ?? SPARK_AGENT_PROMPT,
                     options.context,

package/dist/server/executor.js

@@ -23,7 +23,7 @@ export function createSparkRunExecutor(options) {
                 runId: context.runId,
                 messageId: context.assistantMessageId,
                 signal: context.signal,
-                context: [host.context, context.goal ? `Active goal: ${JSON.stringify(context.goal.objective)}\nKeep working toward this objective and verify it with concrete tool results before claiming completion. Do not ask whether to continue. If you need user input or access, explain exactly what is missing. Latest evaluation: ${context.goal.lastReason ?? "Not evaluated yet."}` : undefined].filter(Boolean).join("\n\n"),
+                context: host.context,
             });
             return { stream: run.stream, result: run.result.finally(() => host.dispose()) };
         }

package/dist/server/service.js

@@ -76,12 +76,20 @@ function normalizeUserMessage(message) {
         },
     };
 }
-/** Budget accounting stays in the host; the worker receives the task and progress. */
+const GOAL_WORK_RULES = "Keep working toward this objective and verify it with concrete tool results before claiming completion. Do not ask whether to continue. If you need user input or access, explain exactly what is missing.";
+/**
+ * Budget accounting stays in the host; the worker receives the task and progress.
+ * Goal state travels in these appended messages, not the system prompt, so each
+ * turn reuses the provider's cached prefix.
+ */
 function goalContinuationText(goal) {
-    return `Continue working toward the goal: ${goal.objective}\nProgress check: ${goal.lastReason}`
+    return `Continue working toward the goal: ${goal.objective}\n${GOAL_WORK_RULES}\nProgress check: ${goal.lastReason}`
         + (wompifyContextSchema.safeParse(goal.settings.wompify).success
             ? "\nKeep refining the existing reconstruction at the same detail level. Compare it with the reference and improve the remaining shape and color discrepancies." : "");
 }
+function goalStartText(goal, action) {
+    return `${action === "set" ? "Goal" : "Resume the goal"}: ${goal.objective}\n${GOAL_WORK_RULES}`;
+}
 export class SparkAgentService {
     store;
     executeRun;
@@ -222,7 +230,7 @@ export class SparkAgentService {
             } : { ...current, settings: runSettings, status: "active", updatedAt: now(),
                 idleTurns: 0, };
             const inputMessage = normalizeUserMessage(message ?? {
-                id: crypto.randomUUID(), role: "user", parts: [{ type: "text", text: command.action === "set" ? goal.objective : `Resume the goal: ${goal.objective}` }],
+                id: crypto.randomUUID(), role: "user", parts: [{ type: "text", text: goalStartText(goal, command.action) }],
             });
             await validateUIMessages({ messages: [inputMessage], metadataSchema: sparkMessageMetadataSchema, dataSchemas: sparkDataPartSchemas });
             await this.store.saveConversationGoal(conversationId, goal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@womp/spark-agent",
-  "version": "5.12.0",
+  "version": "5.12.1",
   "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
   "type": "module",
   "main": "./dist/index.js",