@granular-software/sdk 0.4.21 → 0.4.23

package/dist/index.js

@@ -4707,7 +4707,9 @@ var Session = class {
       }
     }
     if (!revision) {
-      throw new Error("No domain revision available. Register live effects or ensure the build schema is activated.");
+      throw new Error(
+        "No domain revision available. Register live effects or ensure the build schema is activated."
+      );
     }
     const result = await this.client.call("job.submit", {
       domainRevision: revision,
@@ -4743,7 +4745,11 @@ var Session = class {
     const prompt = this.promptCache.get(promptId);
     const resolvedAnswer = resolvePromptAnswer(prompt, answer);
     this.promptCache.delete(promptId);
-    await this.client.call("prompt.answer", { promptId, answer: resolvedAnswer, value: resolvedAnswer });
+    await this.client.call("prompt.answer", {
+      promptId,
+      answer: resolvedAnswer,
+      value: resolvedAnswer
+    });
   }
   /**
    * Get the current list of available effects.
@@ -4775,7 +4781,8 @@ var Session = class {
       for (const tool of cat.tools) {
         if (!tool?.name) continue;
         const existing = toolMap.get(tool.name);
-        if (existing?.publishedAt && cat.publishedAt && existing.publishedAt > cat.publishedAt) continue;
+        if (existing?.publishedAt && cat.publishedAt && existing.publishedAt > cat.publishedAt)
+          continue;
         const isLocal = clientId === this.clientId;
         const ready = isLocal ? this.effects.has(tool.name) || this.toolHandlers.has(tool.name) || this.instanceTools.has(tool.name) : true;
         toolMap.set(tool.name, {
@@ -4813,7 +4820,10 @@ var Session = class {
     return () => {
       const listeners = this.eventListeners.get("effects:changed");
       if (listeners) {
-        this.eventListeners.set("effects:changed", listeners.filter((h) => h !== handler));
+        this.eventListeners.set(
+          "effects:changed",
+          listeners.filter((h) => h !== handler)
+        );
       }
     };
   }
@@ -4829,7 +4839,10 @@ var Session = class {
     return () => {
       const listeners = this.eventListeners.get("tools:changed");
       if (listeners) {
-        this.eventListeners.set("tools:changed", listeners.filter((h) => h !== handler));
+        this.eventListeners.set(
+          "tools:changed",
+          listeners.filter((h) => h !== handler)
+        );
       }
     };
   }
@@ -4837,11 +4850,16 @@ var Session = class {
    * Get the current domain state and available tools
    */
   async getDomain() {
-    const summary = await this.client.call("domain.getSummary", {});
+    const summary = await this.client.call(
+      "domain.getSummary",
+      {}
+    );
     if (summary.activeDomainRevision) {
       this.currentDomainRevision = summary.activeDomainRevision;
     } else {
-      this.currentDomainRevision = this.extractDomainRevisionFromDoc(this.client.doc);
+      this.currentDomainRevision = this.extractDomainRevisionFromDoc(
+        this.client.doc
+      );
     }
     return summary;
   }
@@ -5016,20 +5034,31 @@ import { ${allImports} } from "./sandbox-tools";
   off(event, handler) {
     const handlers = this.eventListeners.get(event);
     if (handlers) {
-      this.eventListeners.set(event, handlers.filter((h) => h !== handler));
+      this.eventListeners.set(
+        event,
+        handlers.filter((h) => h !== handler)
+      );
     }
   }
   // --- Internal ---
   setupToolInvokeHandler() {
     this.client.registerRpcHandler("tool.invoke", async (params) => {
       const { callId, toolName, input } = params;
-      this.emit("effect:invoke", { callId, effectKey: toolName, toolName, input });
+      this.emit("effect:invoke", {
+        callId,
+        effectKey: toolName,
+        toolName,
+        input
+      });
       this.emit("tool:invoke", { callId, toolName, input });
       const handler = this.toolHandlers.get(toolName);
       if (!handler) {
         await this.client.call("tool.result", {
           callId,
-          error: { code: "TOOL_NOT_FOUND", message: `Tool handler not found: ${toolName}` }
+          error: {
+            code: "TOOL_NOT_FOUND",
+            message: `Tool handler not found: ${toolName}`
+          }
         });
         return;
       }
@@ -5038,7 +5067,11 @@ import { ${allImports} } from "./sandbox-tools";
         const invocationContext = this.buildLegacyEffectContext();
         if (this.instanceTools.has(toolName) && input && typeof input === "object" && "_objectId" in input) {
           const { _objectId, ...restParams } = input;
-          result = await handler(_objectId, restParams, invocationContext);
+          result = await handler(
+            _objectId,
+            restParams,
+            invocationContext
+          );
         } else {
           result = await handler(input, invocationContext);
         }
@@ -5050,7 +5083,11 @@ import { ${allImports} } from "./sandbox-tools";
         });
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        this.emit("effect:result", { callId, effectKey: toolName, error: errorMessage });
+        this.emit("effect:result", {
+          callId,
+          effectKey: toolName,
+          error: errorMessage
+        });
         this.emit("tool:result", { callId, error: errorMessage });
         await this.client.call("tool.result", {
           callId,
@@ -5060,7 +5097,10 @@ import { ${allImports} } from "./sandbox-tools";
     });
   }
   setupEventHandlers() {
-    this.client.on("open", (payload) => this.emit("open", payload || {}));
+    this.client.on(
+      "open",
+      (payload) => this.emit("open", payload || {})
+    );
     this.client.on("sync", (doc) => {
       this.currentDomainRevision = this.extractDomainRevisionFromDoc(doc);
       this.emit("sync", doc);
@@ -5074,8 +5114,14 @@ import { ${allImports} } from "./sandbox-tools";
     };
     this.client.on("prompt", emitPrompt);
     this.client.on("prompt.request", emitPrompt);
-    this.client.on("disconnect", (payload) => this.emit("disconnect", payload || {}));
-    this.client.on("reconnect_error", (payload) => this.emit("reconnect_error", payload || {}));
+    this.client.on(
+      "disconnect",
+      (payload) => this.emit("disconnect", payload || {})
+    );
+    this.client.on(
+      "reconnect_error",
+      (payload) => this.emit("reconnect_error", payload || {})
+    );
     this.client.on("job.status", (data) => {
       this.emit("job:status", data);
     });
@@ -5191,7 +5237,10 @@ function sanitizeFeedbackValue(value, depth = 0, seen = /* @__PURE__ */ new Weak
       return "[Circular]";
     }
     seen.add(value);
-    const entries = Object.entries(value).slice(0, MAX_FEEDBACK_OBJECT_KEYS);
+    const entries = Object.entries(value).slice(
+      0,
+      MAX_FEEDBACK_OBJECT_KEYS
+    );
     const sanitized = {};
     for (const [key, entryValue] of entries) {
       sanitized[key] = sanitizeFeedbackValue(entryValue, depth + 1, seen);
@@ -5242,12 +5291,18 @@ var JobImplementation = class {
       if (progressData.execId === id || progressData.jobId === id) {
         if (progressData.stdout) {
           this.markStarted();
-          this.metadata.stdout = [...this.metadata.stdout, truncateFeedbackString(progressData.stdout)].slice(-100);
+          this.metadata.stdout = [
+            ...this.metadata.stdout,
+            truncateFeedbackString(progressData.stdout)
+          ].slice(-100);
           this.emit("stdout", progressData.stdout);
         }
         if (progressData.stderr) {
           this.markStarted();
-          this.metadata.stderr = [...this.metadata.stderr, truncateFeedbackString(progressData.stderr)].slice(-100);
+          this.metadata.stderr = [
+            ...this.metadata.stderr,
+            truncateFeedbackString(progressData.stderr)
+          ].slice(-100);
           this.emit("stderr", progressData.stderr);
         }
       }
@@ -5269,12 +5324,18 @@ var JobImplementation = class {
     });
     this.client.on(`job.${id}.stdout`, (line) => {
       this.markStarted();
-      this.metadata.stdout = [...this.metadata.stdout, truncateFeedbackString(String(line))].slice(-100);
+      this.metadata.stdout = [
+        ...this.metadata.stdout,
+        truncateFeedbackString(String(line))
+      ].slice(-100);
       this.emit("stdout", line);
     });
     this.client.on(`job.${id}.stderr`, (line) => {
       this.markStarted();
-      this.metadata.stderr = [...this.metadata.stderr, truncateFeedbackString(String(line))].slice(-100);
+      this.metadata.stderr = [
+        ...this.metadata.stderr,
+        truncateFeedbackString(String(line))
+      ].slice(-100);
       this.emit("stderr", line);
     });
     this.client.on(`job.${id}.result`, (result) => {
@@ -5306,7 +5367,11 @@ var JobImplementation = class {
     this.client.on("job.failed", (data) => {
       const jobData = data;
       if (jobData.jobId === id) {
-        this.finalize("failed", void 0, jobData.error || new Error("Job failed"));
+        this.finalize(
+          "failed",
+          void 0,
+          jobData.error || new Error("Job failed")
+        );
         this.emit("status", this.status);
       }
     });
@@ -5319,7 +5384,12 @@ var JobImplementation = class {
           input: sanitizeFeedbackValue(d.input),
           startedAt: d.timestamp || Date.now()
         });
-        this.emit("toolCallStart", { callId: d.callId, toolName: d.toolName, input: d.input, timestamp: d.timestamp });
+        this.emit("toolCallStart", {
+          callId: d.callId,
+          toolName: d.toolName,
+          input: d.input,
+          timestamp: d.timestamp
+        });
       }
     });
     this.client.on("tool.call.end", (data) => {
@@ -5334,7 +5404,25 @@ var JobImplementation = class {
           completedAt,
           durationMs: typeof d.durationMs === "number" ? d.durationMs : void 0
         });
-        this.emit("toolCallEnd", { callId: d.callId, toolName: d.toolName, result: d.result, error: d.error, durationMs: d.durationMs, timestamp: d.timestamp });
+        this.emit("toolCallEnd", {
+          callId: d.callId,
+          toolName: d.toolName,
+          result: d.result,
+          error: d.error,
+          durationMs: d.durationMs,
+          timestamp: d.timestamp
+        });
+      }
+    });
+    this.client.on("job.agent_message", (data) => {
+      const d = data;
+      if (d.jobId === id) {
+        this.emit("agentMessage", {
+          messageId: d.messageId,
+          reply: typeof d.reply === "string" ? d.reply : "",
+          show: d.show,
+          timestamp: d.timestamp || Date.now()
+        });
       }
     });
   }
@@ -5404,7 +5492,9 @@ var JobImplementation = class {
   }
   upsertToolCall(next) {
     const callId = next.callId || `tool-call-${Date.now()}`;
-    const existingIndex = this.metadata.toolCalls.findIndex((entry) => entry.callId === callId);
+    const existingIndex = this.metadata.toolCalls.findIndex(
+      (entry) => entry.callId === callId
+    );
     const existing = existingIndex >= 0 ? this.metadata.toolCalls[existingIndex] : void 0;
     const merged = {
       ...existing,
@@ -13369,7 +13459,8 @@ function uniqueStrings(values, maxCount) {
 }
 function formatScalar(value) {
   if (typeof value === "string") return JSON.stringify(value);
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (typeof value === "number" || typeof value === "boolean")
+    return String(value);
   if (value === null) return "null";
   return "unknown";
 }
@@ -13377,7 +13468,9 @@ function describeHeapEntry(entry, previewFieldLimit = 3) {
   const headline = entry.label || entry.id || entry.path || "Unknown";
   const pathLabel = entry.path && entry.path !== headline ? ` <${entry.path}>` : "";
   const classLabel = entry.className || "unknown";
-  const preview = asArray(entry.fields).filter((field) => field?.name && field.name !== "_realId" && field.name !== "real_id").slice(0, previewFieldLimit).map((field) => `${field.name}=${formatScalar(field.value)}`).join(", ");
+  const preview = asArray(entry.fields).filter(
+    (field) => field?.name && field.name !== "_realId" && field.name !== "real_id"
+  ).slice(0, previewFieldLimit).map((field) => `${field.name}=${formatScalar(field.value)}`).join(", ");
   return preview ? `${headline}${pathLabel} [${classLabel}] ${preview}` : `${headline}${pathLabel} [${classLabel}]`;
 }
 function hashString(value) {
@@ -13393,7 +13486,9 @@ function hasSubstantiveAwaitAfterPrompt(code, marker) {
   const startIndex = code.indexOf(marker);
   if (startIndex === -1) return true;
   const segment = code.slice(startIndex + marker.length);
-  const callMatches = segment.matchAll(/await\s+([A-Za-z0-9_$.]+)\.([A-Za-z0-9_]+)\s*\(/g);
+  const callMatches = segment.matchAll(
+    /await\s+([A-Za-z0-9_$.]+)\.([A-Za-z0-9_]+)\s*\(/g
+  );
   for (const match of callMatches) {
     const receiver = match[1] || "";
     const method = match[2] || "";
@@ -13425,9 +13520,16 @@ function reviewGeneratedJobCode(code) {
     /approved\./i
   ];
   if (normalized.includes("await loop.confirm(")) {
-    const postConfirm = normalized.slice(normalized.indexOf("await loop.confirm("));
-    const hasPlaceholder = placeholderPatterns.some((pattern) => pattern.test(postConfirm));
-    const hasSubstantiveAwait = hasSubstantiveAwaitAfterPrompt(normalized, "await loop.confirm(");
+    const postConfirm = normalized.slice(
+      normalized.indexOf("await loop.confirm(")
+    );
+    const hasPlaceholder = placeholderPatterns.some(
+      (pattern) => pattern.test(postConfirm)
+    );
+    const hasSubstantiveAwait = hasSubstantiveAwaitAfterPrompt(
+      normalized,
+      "await loop.confirm("
+    );
     if (!hasSubstantiveAwait || hasPlaceholder) {
       issues.push({
         code: "placeholder_after_confirm",
@@ -13437,9 +13539,16 @@ function reviewGeneratedJobCode(code) {
     }
   }
   if (normalized.includes("await loop.ask_user(")) {
-    const postPrompt = normalized.slice(normalized.indexOf("await loop.ask_user("));
-    const hasPlaceholder = placeholderPatterns.some((pattern) => pattern.test(postPrompt));
-    const hasSubstantiveAwait = hasSubstantiveAwaitAfterPrompt(normalized, "await loop.ask_user(");
+    const postPrompt = normalized.slice(
+      normalized.indexOf("await loop.ask_user(")
+    );
+    const hasPlaceholder = placeholderPatterns.some(
+      (pattern) => pattern.test(postPrompt)
+    );
+    const hasSubstantiveAwait = hasSubstantiveAwaitAfterPrompt(
+      normalized,
+      "await loop.ask_user("
+    );
     if (hasPlaceholder && !hasSubstantiveAwait) {
       issues.push({
         code: "placeholder_after_ask_user",
@@ -13520,7 +13629,9 @@ function getLatestClosure(liveDoc) {
     if (!record) continue;
     closures.push({ ...record, closureId });
   }
-  closures.sort((left, right) => (Number(right.createdAt) || 0) - (Number(left.createdAt) || 0));
+  closures.sort(
+    (left, right) => (Number(right.createdAt) || 0) - (Number(left.createdAt) || 0)
+  );
   return closures[0] || null;
 }
 function getWorkflowBoundary(liveDoc, options) {
@@ -13558,7 +13669,9 @@ function getJobRecords(liveDoc) {
     if (!record) continue;
     jobs.push({ ...record, jobId });
   }
-  jobs.sort((left, right) => getJobTimestamp(right) - getJobTimestamp(left));
+  jobs.sort(
+    (left, right) => getJobTimestamp(right) - getJobTimestamp(left)
+  );
   return jobs;
 }
 function getPromptRecordsFromJobs(liveDoc) {
@@ -13566,7 +13679,9 @@ function getPromptRecordsFromJobs(liveDoc) {
 }
 function projectWorkflowFocus(liveDoc, pendingPrompts = [], options) {
   const boundary = getWorkflowBoundary(liveDoc, options);
-  const jobs = getJobRecords(liveDoc).filter((job) => getJobTimestamp(job) >= boundary.timestamp).slice(0, 6).reverse();
+  const jobs = getJobRecords(liveDoc).filter(
+    (job) => getJobTimestamp(job) >= boundary.timestamp
+  ).slice(0, 6).reverse();
   const actionSummaryLines = [];
   const variableNames = [];
   const listNames = [];
@@ -13618,7 +13733,9 @@ function projectWorkflowFocus(liveDoc, pendingPrompts = [], options) {
       return updatedAt >= boundary.timestamp;
     }
     return status !== "completed" && status !== "canceled" ? true : updatedAt >= boundary.timestamp;
-  }).sort((left, right) => (Number(right.updatedAt) || Number(right.createdAt) || 0) - (Number(left.updatedAt) || Number(left.createdAt) || 0));
+  }).sort(
+    (left, right) => (Number(right.updatedAt) || Number(right.createdAt) || 0) - (Number(left.updatedAt) || Number(left.createdAt) || 0)
+  );
   for (const task of tasks.slice(0, 4)) {
     if (typeof task.taskId === "string") {
       activeTaskIds.push(task.taskId);
@@ -13630,7 +13747,9 @@ function projectWorkflowFocus(liveDoc, pendingPrompts = [], options) {
       return updatedAt >= boundary.timestamp;
     }
     return decision.status === "open" || updatedAt >= boundary.timestamp;
-  }).sort((left, right) => (Number(right.updatedAt) || Number(right.createdAt) || 0) - (Number(left.updatedAt) || Number(left.createdAt) || 0));
+  }).sort(
+    (left, right) => (Number(right.updatedAt) || Number(right.createdAt) || 0) - (Number(left.updatedAt) || Number(left.createdAt) || 0)
+  );
   for (const decision of decisions.slice(0, 3)) {
     if (typeof decision.decisionId === "string" && decision.status === "open") {
       openDecisionIds.push(decision.decisionId);
@@ -13709,11 +13828,15 @@ function projectWorkflowSummary(liveDoc, pendingPrompts = [], options) {
   const lines = [];
   lines.push("Workflow Boundary:");
   if (focus.boundaryReason === "request_start") {
-    lines.push("- Start from work recorded after the current user request began.");
+    lines.push(
+      "- Start from work recorded after the current user request began."
+    );
   } else if (focus.boundaryReason === "last_closed_loop" && focus.latestClosureId) {
     lines.push(`- Start from work recorded after ${focus.latestClosureId}.`);
   } else {
-    lines.push("- No prior closed loop recorded; use the latest user request as the boundary.");
+    lines.push(
+      "- No prior closed loop recorded; use the latest user request as the boundary."
+    );
   }
   lines.push("", "Recent Actions:");
   if (focus.recentActionSummary.length === 0) {
@@ -13782,12 +13905,17 @@ function projectLoopSummary(liveDoc, pendingPrompts = [], options) {
       return updatedAt >= boundary.timestamp;
     }
     return status !== "completed" && status !== "canceled" ? true : updatedAt >= boundary.timestamp;
-  }).sort((left, right) => (Number(right.updatedAt) || 0) - (Number(left.updatedAt) || 0));
+  }).sort(
+    (left, right) => (Number(right.updatedAt) || 0) - (Number(left.updatedAt) || 0)
+  );
   const activeTasks = tasks.filter((task) => {
     const status = typeof task.status === "string" ? task.status : "pending";
     return status !== "completed" && status !== "canceled";
   });
-  const visibleTasks = (activeTasks.length > 0 ? activeTasks : tasks).slice(0, 5);
+  const visibleTasks = (activeTasks.length > 0 ? activeTasks : tasks).slice(
+    0,
+    5
+  );
   const hiddenTaskCount = Math.max(0, activeTasks.length - visibleTasks.length);
   lines.push("Tasks:");
   if (visibleTasks.length === 0) {
@@ -13811,8 +13939,12 @@ function projectLoopSummary(liveDoc, pendingPrompts = [], options) {
       return updatedAt >= boundary.timestamp;
     }
     return decision.status === "open" || updatedAt >= boundary.timestamp;
-  }).sort((left, right) => (Number(right.updatedAt) || Number(right.createdAt) || 0) - (Number(left.updatedAt) || Number(left.createdAt) || 0));
-  const openDecisions = decisions.filter((decision) => decision.status === "open");
+  }).sort(
+    (left, right) => (Number(right.updatedAt) || Number(right.createdAt) || 0) - (Number(left.updatedAt) || Number(left.createdAt) || 0)
+  );
+  const openDecisions = decisions.filter(
+    (decision) => decision.status === "open"
+  );
   const visibleDecisions = (openDecisions.length > 0 ? openDecisions : decisions.slice(0, 1)).slice(0, 3);
   lines.push("", "Recent Decisions:");
   if (visibleDecisions.length === 0) {
@@ -13831,7 +13963,9 @@ function projectLoopSummary(liveDoc, pendingPrompts = [], options) {
           const candidateLabel = typeof record.label === "string" && record.label.trim() ? record.label.trim() : candidateId;
           return candidateLabel === candidateId ? candidateId : `${candidateLabel} (${candidateId})`;
         }).filter((value) => Boolean(value)).join(", ");
-        lines.push(`- [open] ${title} (${decisionId})${candidatePreview ? ` \u2014 candidates: ${candidatePreview}` : ""}`);
+        lines.push(
+          `- [open] ${title} (${decisionId})${candidatePreview ? ` \u2014 candidates: ${candidatePreview}` : ""}`
+        );
       } else {
         const selected = asRecord2(decision.selected);
         const label = typeof selected?.label === "string" ? selected.label : typeof selected?.id === "string" ? selected.id : "unknown";
@@ -13846,13 +13980,17 @@ function projectLoopSummary(liveDoc, pendingPrompts = [], options) {
       title: prompt.title,
       message: prompt.message
     })),
-    ...Object.values(asRecord2(asRecord2(liveDoc?.jobs)?.byId) || {}).flatMap((job) => Object.values(asRecord2(asRecord2(job)?.prompts) || {})).map((prompt) => asRecord2(prompt)).filter((prompt) => Boolean(prompt && prompt.status === "open"))
+    ...Object.values(asRecord2(asRecord2(liveDoc?.jobs)?.byId) || {}).flatMap((job) => Object.values(asRecord2(asRecord2(job)?.prompts) || {})).map((prompt) => asRecord2(prompt)).filter(
+      (prompt) => Boolean(prompt && prompt.status === "open")
+    )
   ];
   const visiblePrompts = boundary.reason === "request_start" ? openPrompts.filter((prompt) => {
     const promptRecord = asRecord2(prompt);
     const openedAt = Number(promptRecord?.openedAt) || 0;
     const promptId = typeof promptRecord?.id === "string" ? promptRecord.id : typeof prompt.id === "string" ? prompt.id : null;
-    return openedAt >= boundary.timestamp || (promptId ? pendingPrompts.some((pendingPrompt) => pendingPrompt.id === promptId) : false);
+    return openedAt >= boundary.timestamp || (promptId ? pendingPrompts.some(
+      (pendingPrompt) => pendingPrompt.id === promptId
+    ) : false);
   }) : openPrompts;
   lines.push("", "Open Prompts:");
   if (visiblePrompts.length === 0) {
@@ -13883,9 +14021,15 @@ function projectHeapSummary(heap, options) {
   const entriesByPath = asRecord2(heapRecord.entriesByPath) || {};
   const listsByName = asRecord2(heapRecord.listsByName) || {};
   const variablesByName = asRecord2(heapRecord.variablesByName) || {};
-  const focusedVariableNames = new Set(uniqueStrings(options?.focus?.variableNames || []));
-  const focusedListNames = new Set(uniqueStrings(options?.focus?.listNames || []));
-  const focusedEntryPaths = new Set(uniqueStrings(options?.focus?.entryPaths || []));
+  const focusedVariableNames = new Set(
+    uniqueStrings(options?.focus?.variableNames || [])
+  );
+  const focusedListNames = new Set(
+    uniqueStrings(options?.focus?.listNames || [])
+  );
+  const focusedEntryPaths = new Set(
+    uniqueStrings(options?.focus?.entryPaths || [])
+  );
   const hasFocus = focusedVariableNames.size > 0 || focusedListNames.size > 0 || focusedEntryPaths.size > 0;
   const suppressRecentFallback = Boolean(options?.focus) && !hasFocus;
   const maxVariables = options?.maxVariables ?? (hasFocus ? 4 : 6);
@@ -13897,20 +14041,26 @@ function projectHeapSummary(heap, options) {
     return rightFocused - leftFocused || (right.updatedAt || 0) - (left.updatedAt || 0);
   }).filter((variable, index) => {
     if (index < maxVariables) return true;
-    return Boolean(variable.name && focusedVariableNames.has(variable.name));
+    return Boolean(
+      variable.name && focusedVariableNames.has(variable.name)
+    );
   }).slice(0, maxVariables);
   const referencedPaths = /* @__PURE__ */ new Set();
   for (const variable of variables) {
     if (variable.entryPath) referencedPaths.add(variable.entryPath);
     if (variable.listName) {
-      const list = asRecord2(listsByName[variable.listName]);
+      const list = asRecord2(
+        listsByName[variable.listName]
+      );
       for (const path of list?.paths || []) referencedPaths.add(path);
     }
   }
   for (const path of focusedEntryPaths) {
     referencedPaths.add(path);
   }
-  const visibleLists = Object.values(listsByName).map((value) => asRecord2(value)).filter((value) => Boolean(value)).filter((list) => variables.some((variable) => variable.listName === list.name) || Boolean(list.name && focusedListNames.has(list.name))).sort((left, right) => (right.updatedAt || 0) - (left.updatedAt || 0)).slice(0, maxLists);
+  const visibleLists = Object.values(listsByName).map((value) => asRecord2(value)).filter((value) => Boolean(value)).filter(
+    (list) => variables.some((variable) => variable.listName === list.name) || Boolean(list.name && focusedListNames.has(list.name))
+  ).sort((left, right) => (right.updatedAt || 0) - (left.updatedAt || 0)).slice(0, maxLists);
   const visibleEntries = Object.values(entriesByPath).map((value) => asRecord2(value)).filter((value) => Boolean(value)).filter((entry) => entry.path && referencedPaths.has(entry.path)).sort((left, right) => (right.updatedAt || 0) - (left.updatedAt || 0)).slice(0, maxEntries);
   const lines = [];
   lines.push("Variables:");
@@ -13919,16 +14069,24 @@ function projectHeapSummary(heap, options) {
   } else {
     for (const variable of variables) {
       if (variable.kind === "scalar") {
-        lines.push(`- ${variable.name}: scalar = ${formatScalar(variable.value)}`);
+        lines.push(
+          `- ${variable.name}: scalar = ${formatScalar(variable.value)}`
+        );
         continue;
       }
       if (variable.kind === "entry") {
-        const entry = variable.entryPath ? asRecord2(entriesByPath[variable.entryPath]) : null;
-        lines.push(`- ${variable.name}: entry<${variable.className || entry?.className || "unknown"}> -> ${entry ? describeHeapEntry(entry) : variable.entryPath || "missing"}`);
+        const entry = variable.entryPath ? asRecord2(
+          entriesByPath[variable.entryPath]
+        ) : null;
+        lines.push(
+          `- ${variable.name}: entry<${variable.className || entry?.className || "unknown"}> -> ${entry ? describeHeapEntry(entry) : variable.entryPath || "missing"}`
+        );
         continue;
       }
       const list = variable.listName ? asRecord2(listsByName[variable.listName]) : null;
-      lines.push(`- ${variable.name}: list<${variable.className || list?.className || "unknown"}> -> ${(list?.paths || []).length} item(s)`);
+      lines.push(
+        `- ${variable.name}: list<${variable.className || list?.className || "unknown"}> -> ${(list?.paths || []).length} item(s)`
+      );
     }
   }
   lines.push("", "Named Lists:");
@@ -13936,7 +14094,9 @@ function projectHeapSummary(heap, options) {
     lines.push("- none");
   } else {
     for (const list of visibleLists) {
-      lines.push(`- ${list.name}: ${list.className || "unknown"}[${(list.paths || []).length}]`);
+      lines.push(
+        `- ${list.name}: ${list.className || "unknown"}[${(list.paths || []).length}]`
+      );
     }
   }
   lines.push("", "Active Entries:");
@@ -13950,11 +14110,19 @@ function projectHeapSummary(heap, options) {
   return lines.join("\n");
 }
 function createHarnessVerifierSnapshot(input) {
-  const workflowFocus = projectWorkflowFocus(input.liveDoc, [], input.projectionOptions);
-  const heapDigest = hashString(projectHeapSummary(asRecord2(input.liveDoc?.heap), {
-    focus: workflowFocus
-  })) || "00000000";
-  const loopDigest = hashString(projectWorkflowSummary(input.liveDoc, [], input.projectionOptions)) || "00000000";
+  const workflowFocus = projectWorkflowFocus(
+    input.liveDoc,
+    [],
+    input.projectionOptions
+  );
+  const heapDigest = hashString(
+    projectHeapSummary(asRecord2(input.liveDoc?.heap), {
+      focus: workflowFocus
+    })
+  ) || "00000000";
+  const loopDigest = hashString(
+    projectWorkflowSummary(input.liveDoc, [], input.projectionOptions)
+  ) || "00000000";
   return {
     codeDigest: hashString(input.finalCode?.trim()),
     resultDigest: hashString(input.resultPreview?.trim()),
@@ -14084,8 +14252,12 @@ function buildGranularAgentToolBlock(tools) {
     return "No live effects are available in this session yet.";
   }
   const globalTools = normalizedTools.filter((tool) => !tool.className);
-  const staticTools = normalizedTools.filter((tool) => Boolean(tool.className && tool.static));
-  const instanceTools = normalizedTools.filter((tool) => Boolean(tool.className && !tool.static));
+  const staticTools = normalizedTools.filter(
+    (tool) => Boolean(tool.className && tool.static)
+  );
+  const instanceTools = normalizedTools.filter(
+    (tool) => Boolean(tool.className && !tool.static)
+  );
   const lines = [
     "Treat this block as the planning map. Use DOMAIN TYPES below for exact signatures."
   ];
@@ -14300,7 +14472,10 @@ ${loopBlock}
 - Avoid \`as any\` and other broad casts when the DOMAIN TYPES block already tells you the correct class or list type.
 - Prefer manipulating heap-backed instances and typed lists instead of returning raw JSON blobs or object IDs unless the user explicitly asks for them.
 - If the user expects an answer after the job runs, the final \`return\` value must be either a short natural-language string or an object with a top-level \`reply\` string.
+- You may call \`agent_message(...)\` multiple times in one job to post several assistant messages while the job is still running.
 - Prefer \`agent_message({ reply, show })\` when you want to leave a user-facing answer and optionally show heap-backed records in the UI.
+- \`agent_message(...)\` also accepts \`content\`, \`message\`, or \`text\` instead of \`reply\`.
+- \`agent_message({ show })\` may receive explicit refs or sandbox instances and arrays of sandbox instances. The runtime will convert those into UI references.
 - When it helps the UI show specific heap-backed results, you may instead return:
   \`{ reply: string, show: { entryPaths?: string[], listNames?: string[], variableNames?: string[] } }\`
 - If you create or load objects the user should see, save them in the heap and return references to them through \`show\` instead of serializing full objects.