@agent-native/core 0.131.6 → 0.131.9

package/corpus/templates/clips/app/hooks/use-auto-title.ts

@@ -1,5 +1,7 @@
 import {
+  generateTabId,
   sendToAgentChat,
+  sendToAgentChatAndConfirm,
   type AgentChatMessage,
 } from "@agent-native/core/client/agent-chat";
 import { agentNativePath } from "@agent-native/core/client/api-path";
@@ -11,6 +13,8 @@ import { useRecordings, type RecordingSummary } from "./use-library";
 
 const DEFAULT_TITLE = "Untitled recording";
 const TWO_MINUTES_MS = 2 * 60 * 1000;
+export const WORKFLOW_ACTION_MAX_ATTEMPTS = 5;
+const WORKFLOW_ACTION_RETRY_DELAY_MS = 1000;
 
 /** True when `title` is blank or equal to the server-seeded default. */
 export function isDefaultTitle(title: string | null | undefined): boolean {
@@ -45,6 +49,8 @@ interface AiRequest {
   message?: string;
   includeFullVideoInAi?: boolean;
   openInChat?: boolean;
+  deliveredAt?: string;
+  deliveredTabId?: string;
 }
 
 const DISPATCHABLE_REQUESTS = new Set([
@@ -99,6 +105,36 @@ export function useAutoTitleBridge(): void {
   const dispatched = useRef<Set<string>>(new Set());
   const inflight = useRef<boolean>(false);
 
+  useEffect(() => {
+    const handleChatRunning = (event: Event) => {
+      const detail = (event as CustomEvent).detail;
+      if (
+        detail?.isRunning !== false ||
+        (detail.reason !== "stopped" && detail.reason !== "failed") ||
+        typeof detail.tabId !== "string"
+      )
+        return;
+
+      const recordingId = recordingIdFromTab(detail.tabId);
+      const requestedAt = requestedAtFromTab(detail.tabId);
+      if (!recordingId || !requestedAt) return;
+
+      void retryWorkflowAction(
+        {
+          operation: "stop",
+          recordingId,
+          requestedAt,
+          tabId: detail.tabId,
+        },
+        "reconciled",
+      );
+    };
+
+    window.addEventListener("agentNative.chatRunning", handleChatRunning);
+    return () =>
+      window.removeEventListener("agentNative.chatRunning", handleChatRunning);
+  }, []);
+
   const readyRecordings = recordings.filter((r) => r.status === "ready");
   const readyRecordingsKey = readyRecordings
     .map(
@@ -144,7 +180,6 @@ export function useAutoTitleBridge(): void {
               request.requestedAt ?? "0"
             }`;
             if (dispatched.current.has(dispatchKey)) continue;
-            dispatched.current.add(dispatchKey);
             if (
               request.kind === "generate-metadata" ||
               request.kind === "regenerate-title"
@@ -155,8 +190,67 @@ export function useAutoTitleBridge(): void {
               dispatched.current.add(`${rec.id}:fallback`);
             }
 
-            dispatchAiRequest(rec, request);
+            if (
+              request.kind === "generate-workflow" &&
+              typeof request.requestedAt === "string"
+            ) {
+              if (request.deliveredTabId) {
+                dispatched.current.add(dispatchKey);
+                void consumeWorkflowRequest({
+                  recordingId: rec.id,
+                  requestedAt: request.requestedAt,
+                  tabId: request.deliveredTabId,
+                });
+                continue;
+              }
 
+              const tabId = workflowTabId(rec.id, request.requestedAt);
+              try {
+                const result = (await callAction(
+                  "reconcile-workflow-generation" as any,
+                  {
+                    operation: "track",
+                    recordingId: rec.id,
+                    requestedAt: request.requestedAt,
+                    tabId,
+                  } as any,
+                )) as { tracked?: boolean };
+                if (result.tracked !== true) {
+                  fallbackTimer = setTimeout(() => void tick(), 1000);
+                  continue;
+                }
+              } catch {
+                fallbackTimer = setTimeout(() => void tick(), 1000);
+                continue;
+              }
+              const delivery = await sendToAgentChatAndConfirm({
+                ...buildAiRequestChatOptions(rec, request),
+                tabId,
+                chatTarget: "local",
+              });
+              if (!delivery.delivered) {
+                await retryWorkflowAction(
+                  {
+                    operation: "release",
+                    recordingId: rec.id,
+                    requestedAt: request.requestedAt,
+                    tabId,
+                  },
+                  "released",
+                );
+                fallbackTimer = setTimeout(() => void tick(), 1000);
+                continue;
+              }
+              dispatched.current.add(dispatchKey);
+              void persistAndConsumeWorkflowRequest({
+                recordingId: rec.id,
+                requestedAt: request.requestedAt,
+                tabId,
+              });
+              continue;
+            }
+            dispatchAiRequest(rec, request);
+            dispatched.current.add(dispatchKey);
             void clearRequest(rec.id);
           } else if (isAutoTitleReplaceable(rec.title, rec.titleSource)) {
             // No server-queued delegation. Only dispatch the fallback for
@@ -294,8 +388,76 @@ export function buildAiRequestChatOptions(
   };
 }
 
-function dispatchAiRequest(rec: RecordingSummary, request: AiRequest) {
-  sendToAgentChat(buildAiRequestChatOptions(rec, request));
+interface WorkflowRunRequest {
+  recordingId: string;
+  requestedAt: string;
+  tabId: string;
+}
+
+export async function retryWorkflowAction(
+  request: WorkflowRunRequest & { operation: string },
+  successKey: string,
+): Promise<boolean> {
+  for (let attempt = 0; attempt < WORKFLOW_ACTION_MAX_ATTEMPTS; attempt += 1) {
+    try {
+      const result = (await callAction(
+        "reconcile-workflow-generation" as any,
+        request as any,
+      )) as Record<string, unknown>;
+      if (result[successKey] === true) return true;
+      if (typeof result.reason === "string" && result.reason !== "stale") {
+        return false;
+      }
+    } catch {}
+
+    if (attempt === WORKFLOW_ACTION_MAX_ATTEMPTS - 1) return false;
+    await new Promise((resolve) =>
+      setTimeout(resolve, WORKFLOW_ACTION_RETRY_DELAY_MS * 2 ** attempt),
+    );
+  }
+
+  return false;
+}
+
+async function consumeWorkflowRequest(
+  request: WorkflowRunRequest,
+): Promise<boolean> {
+  return retryWorkflowAction({ ...request, operation: "consume" }, "consumed");
+}
+
+async function persistAndConsumeWorkflowRequest(
+  request: WorkflowRunRequest,
+): Promise<void> {
+  const delivered = await retryWorkflowAction(
+    { ...request, operation: "mark-delivered" },
+    "delivered",
+  );
+  if (delivered) await consumeWorkflowRequest(request);
+}
+
+function workflowTabId(recordingId: string, requestedAt: string) {
+  return `clips-workflow:${recordingId}:${encodeURIComponent(requestedAt)}:${generateTabId()}`;
+}
+
+function recordingIdFromTab(tabId: string) {
+  const match = /^clips-workflow:([^:]+):/.exec(tabId);
+  return match?.[1];
+}
+
+function requestedAtFromTab(tabId: string) {
+  const match = /^clips-workflow:[^:]+:([^:]+):/.exec(tabId);
+  return match ? decodeURIComponent(match[1]) : undefined;
+}
+
+function dispatchAiRequest(
+  rec: RecordingSummary,
+  request: AiRequest,
+  tabId?: string,
+) {
+  return sendToAgentChat({
+    ...buildAiRequestChatOptions(rec, request),
+    ...(tabId ? { tabId } : {}),
+  });
 }
 
 function parseJsonArray(raw: string | undefined): unknown[] {

package/corpus/templates/clips/app/routes/r.$recordingId.tsx

@@ -27,6 +27,7 @@ import {
   DASHBOARD_REDIRECT_VALUE,
   REF_PARAM,
 } from "@shared/share-attribution";
+import type { WorkflowKind } from "@shared/workflow";
 import {
   IconShare3,
   IconArrowLeft,
@@ -109,7 +110,6 @@ export function meta() {
 }
 
 type SidePanel = "transcript" | "comments" | "insights" | "agent" | "settings";
-type WorkflowKind = "pr" | "sop" | "ticket" | "email";
 
 const WORKFLOW_MENU_ITEMS: Array<{
   kind: WorkflowKind;

package/corpus/templates/clips/changelog/2026-07-27-stopped-agent-runs-no-longer-leave-generated-workflow-cards-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-27
+---
+
+Stopped agent runs no longer leave generated workflow cards spinning indefinitely.

package/corpus/templates/clips/changelog/2026-07-30-workflow-generation-now-stops-retrying-after-repeated-failur.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-30
+---
+
+Workflow generation now stops retrying after repeated failures instead of remaining active indefinitely.

package/corpus/templates/clips/shared/workflow.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+
+export const WORKFLOW_KINDS = ["pr", "sop", "ticket", "email"] as const;
+export const WorkflowKindSchema = z.enum(WORKFLOW_KINDS);
+export type WorkflowKind = z.infer<typeof WorkflowKindSchema>;

package/corpus/templates/plan/actions/get-visual-plan.ts

@@ -39,13 +39,13 @@ export default defineAction({
           .boolean()
           .optional()
           .describe(
-            "Include the exported MDX folder in the response. Defaults to true for agents; set false to skip the Prettier-formatted MDX export when you only need structured content or HTML.",
+            "Include the exported MDX folder in the response. Defaults to false for agent reads; set true for an explicit source-control workflow.",
           ),
         html: z
           .boolean()
           .optional()
           .describe(
-            "Include the exported HTML bundle in the response. Defaults to true for legacy plans; set false to skip when you only need structured content.",
+            "Include the exported HTML bundle in the response. Defaults to false for agent reads; set true when you explicitly need the rendered legacy artifact.",
           ),
       })
       .optional()
@@ -80,10 +80,14 @@ export default defineAction({
     // for their iframe.
     const isFrontend = ctx?.caller === "frontend";
     const isModern = Boolean(bundle.plan.content);
-    // Caller-controlled opt-out; defaults preserve existing behavior.
-    const wantMdx = args.includeMdx ?? args.include?.mdx ?? true;
-    const wantHtml = args.includeHtml ?? args.include?.html ?? true;
-    const includeStoredPlanExportFields = !isFrontend || wantHtml || wantMdx;
+    const isAgentCaller =
+      ctx?.caller === "tool" || ctx?.caller === "mcp" || ctx?.caller === "a2a";
+    // Agent reads default to the structured model only; source-control and
+    // legacy-rendered exports remain opt-in so they do not inflate the next
+    // tool turn.
+    const wantMdx = args.includeMdx ?? args.include?.mdx ?? !isAgentCaller;
+    const wantHtml = args.includeHtml ?? args.include?.html ?? !isAgentCaller;
+    const includeStoredPlanExportFields = wantHtml || wantMdx;
     return {
       ...bundle,
       planId: bundle.plan.id,

package/corpus/templates/plan/actions/patch-visual-plan-source.ts

@@ -28,6 +28,73 @@ import {
 } from "../server/plans.js";
 import type { PlanContent } from "../shared/plan-content.js";
 
+const agentPlanMdxSourcePatchesSchema = z
+  .array(
+    z.discriminatedUnion("op", [
+      z.object({
+        op: z.literal("replace-markdown-block"),
+        blockId: z.string().min(1),
+        markdown: z.string().max(16_000),
+        title: z.string().optional(),
+      }),
+      z.object({
+        op: z.literal("update-component-prop"),
+        file: z.enum(["plan.mdx", "canvas.mdx", "prototype.mdx"]),
+        componentId: z.string().min(1),
+        prop: z.string().min(1),
+        value: z.unknown(),
+      }),
+      z.object({
+        op: z.literal("update-wireframe-node"),
+        nodeId: z.string().min(1),
+        patch: z.record(z.string(), z.unknown()),
+      }),
+      z.object({
+        op: z.literal("update-annotation"),
+        annotationId: z.string().min(1),
+        patch: z.object({
+          type: z.enum(["note", "text", "callout", "arrow"]).optional(),
+          title: z.string().optional(),
+          text: z.string().max(2_000).optional(),
+          points: z
+            .array(z.object({ x: z.number(), y: z.number() }))
+            .min(1)
+            .max(12)
+            .optional(),
+          style: z
+            .object({
+              tone: z
+                .enum(["default", "accent", "warn", "ok", "muted"])
+                .optional(),
+              stroke: z.enum(["solid", "dashed"]).optional(),
+              width: z.number().min(1).max(12).optional(),
+            })
+            .optional(),
+          targetId: z.string().optional(),
+          placement: z
+            .enum([
+              "top",
+              "right",
+              "bottom",
+              "left",
+              "top-left",
+              "top-right",
+              "bottom-left",
+              "bottom-right",
+            ])
+            .optional(),
+          x: z.number().optional(),
+          y: z.number().optional(),
+        }),
+      }),
+    ]),
+  )
+  .max(80)
+  .describe(
+    "Small exported-MDX patches only. Never send replace-file or replace-artboard " +
+      "from an agent; for a live plan use update-visual-plan contentPatches instead.",
+  );
+
 type PlanSurfaceCounts = {
   blocks: number;
   canvasFrames: number;
@@ -42,6 +109,28 @@ function planSurfaceCounts(content: PlanContent | null | undefined) {
   } satisfies PlanSurfaceCounts;
 }
 
+function compactAgentWriteResult(
+  bundle: Awaited<ReturnType<typeof loadPlanBundle>>,
+  changed: Record<string, unknown>,
+) {
+  return {
+    planId: bundle.plan.id,
+    plan: {
+      id: bundle.plan.id,
+      title: bundle.plan.title,
+      brief: bundle.plan.brief,
+      kind: bundle.plan.kind,
+      status: bundle.plan.status,
+      currentFocus: bundle.plan.currentFocus,
+      updatedAt: bundle.plan.updatedAt,
+      surfaces: planSurfaceCounts(bundle.plan.content),
+    },
+    changed,
+    path: planPath(bundle.plan.id, bundle.plan.kind),
+    url: planPath(bundle.plan.id, bundle.plan.kind),
+  };
+}
+
 function stableJson(value: unknown): string {
   if (value === null) return "null";
   if (value === undefined) return "undefined";
@@ -140,7 +229,7 @@ function assertNoUnexpectedSurfaceCollapse(
 
 export default defineAction({
   description:
-    "Patch the MDX source for an Agent-Native Plan by stable semantic IDs, then normalize it back into runtime JSON. Use ONLY when working with exported MDX source files (repo check-in workflows); for live plans prefer update-visual-plan with contentPatches. Suitable for tiny source-control friendly diffs: one markdown block, one artboard, one annotation, or one wireframe node.",
+    "Patch the MDX source for an Agent-Native Plan by stable semantic IDs, then normalize it back into runtime JSON. Use ONLY when working with exported MDX source files (repo check-in workflows); for live plans prefer update-visual-plan with contentPatches. For agent calls, use only small semantic patches and never resend replace-file or replace-artboard payloads.",
   schema: z.object({
     planId: z.string().describe("Plan ID"),
     expectedUpdatedAt: z
@@ -162,6 +251,21 @@ export default defineAction({
     ),
     note: z.string().optional().describe("Short audit note for plan history."),
   }),
+  agentInputSchema: z.object({
+    planId: z.string().describe("Plan ID"),
+    expectedUpdatedAt: z
+      .string()
+      .min(1)
+      .optional()
+      .describe("Revision from the latest plan read when required."),
+    allowDestructive: z
+      .boolean()
+      .optional()
+      .default(false)
+      .describe("Allow an intentional nonempty-to-empty collapse."),
+    patches: agentPlanMdxSourcePatchesSchema,
+    note: z.string().optional().describe("Short audit note for plan history."),
+  }),
   publicAgent: {
     expose: true,
     readOnly: false,
@@ -321,6 +425,18 @@ export default defineAction({
           ),
         })
       : null;
+    if (isAgentCaller) {
+      return {
+        ...compactAgentWriteResult(updated, {
+          patchOps: args.patches.map((patch) => patch.op),
+          counts: {
+            before: beforeCounts,
+            after: afterCounts,
+          },
+        }),
+        ...(local?.written ? { localFiles: local } : {}),
+      };
+    }
     return {
       ...updated,
       planId: updated.plan.id,

package/corpus/templates/plan/actions/update-visual-plan.ts

@@ -49,8 +49,7 @@ import {
   sectionInputSchema,
 } from "../server/plans.js";
 import {
-  agentPlanContentPatchesSchema,
-  agentPlanContentSchema,
+  agentPlanIncrementalContentPatchesSchema,
   applyPlanContentPatches,
   planContentPatchesSchema,
   planContentSchema,
@@ -454,6 +453,32 @@ const CONTENT_DESCRIPTION =
 const CONTENT_PATCHES_DESCRIPTION =
   "Targeted structured content edits addressed by stable id. Prefer granular operations for live plans. The destructive replace-blocks operation requires expectedUpdatedAt from a fresh read. patch-visual-plan-source is only for exported MDX folders. Supported ops: set-metadata for title/brief; set-visual-render-mode to persist `design` (high fidelity, authored CSS, no rough.js for any viewer) or `wireframe` across canvas, linked blocks, and prototype screens; set-prototype / remove-prototype / update-prototype-screen / patch-prototype-html for live prototype surfaces; update-block / replace-block, update-rich-text, patch-wireframe-html, patch-diagram-html, update-wireframe-node, replace-wireframe-screen, update-canvas-frame, update-canvas-annotation / append-canvas-annotation, append-block / remove-block, update-custom-html. A fidelity upgrade must also replace or patch the existing screen HTML/CSS with deliberate branded design; changing render mode alone only removes the sketch treatment.";
 
+function compactAgentWriteResult(
+  bundle: Awaited<ReturnType<typeof loadPlanBundle>>,
+  changed: Record<string, unknown>,
+) {
+  return {
+    planId: bundle.plan.id,
+    plan: {
+      id: bundle.plan.id,
+      title: bundle.plan.title,
+      brief: bundle.plan.brief,
+      kind: bundle.plan.kind,
+      status: bundle.plan.status,
+      currentFocus: bundle.plan.currentFocus,
+      updatedAt: bundle.plan.updatedAt,
+      surfaces: {
+        blocks: bundle.plan.content?.blocks.length ?? 0,
+        canvasFrames: bundle.plan.content?.canvas?.frames.length ?? 0,
+        prototypeScreens: bundle.plan.content?.prototype?.screens.length ?? 0,
+      },
+    },
+    changed,
+    path: planPath(bundle.plan.id, bundle.plan.kind),
+    url: planPath(bundle.plan.id, bundle.plan.kind),
+  };
+}
+
 // Named so `agentInputSchema` below can `.extend()` it with compact
 // `content`/`contentPatches` fields instead of duplicating every other key.
 const updateVisualPlanSchema = z.object({
@@ -527,21 +552,26 @@ const updateVisualPlanSchema = z.object({
     .describe("Short label saved as the version-history snapshot label."),
 });
 
+// ADVERTISED-ONLY: agent edits to an existing plan must stay incremental. The
+// runtime schema above still accepts full replacements for the browser editor
+// and explicit callers that have intentionally chosen that workflow.
+const agentUpdateVisualPlanSchema = updateVisualPlanSchema
+  .omit({ content: true, html: true, markdown: true, sections: true })
+  .extend({
+    contentPatches: agentPlanIncrementalContentPatchesSchema
+      .optional()
+      .default([])
+      .describe(
+        "Small targeted edits only. Do not send full content or replace-blocks; " +
+          "append or patch one existing block at a time.",
+      ),
+  });
+
 export default defineAction({
   description:
-    "Update an Agent-Native Plan's structured content blocks, prototype screens, visual fidelity, sections, comments, or status. Prefer contentPatches for targeted edits. When a user asks for higher fidelity on an existing plan, update that same plan in place: use set-visual-render-mode with design and provide polished screen HTML/CSS in the same call instead of creating a duplicate plan or only toggling the viewer-local clean style. Use full content only for broad restructuring. Works on plans and recaps alike when you have editor access; with viewer access (common on PR recaps published by CI) only comment-only calls succeed — to change a recap you cannot edit, publish a replacement with create-visual-recap instead of retrying this call.",
+    "Update an Agent-Native Plan's structured content blocks, prototype screens, visual fidelity, sections, comments, or status. For an existing plan, use small contentPatches such as append-block, update-rich-text, or a text patch; do not resend the full document for an incremental edit. When a user asks for higher fidelity on an existing plan, update that same plan in place: use set-visual-render-mode with design and provide polished screen HTML/CSS in the same call instead of creating a duplicate plan or only toggling the viewer-local clean style. Use a full replacement only for an explicit broad rebuild. Works on plans and recaps alike when you have editor access; with viewer access (common on PR recaps published by CI) only comment-only calls succeed - to change a recap you cannot edit, publish a replacement with create-visual-recap instead of retrying this call.",
   schema: updateVisualPlanSchema,
-  // ADVERTISED-ONLY: same top-level shape, but `content`/`contentPatches`
-  // swap the deep per-block-type union for a compact `type`-enum stand-in.
-  // Runtime validation always runs the full schema above — see the `actions`
-  // skill.
-  agentInputSchema: updateVisualPlanSchema.extend({
-    content: agentPlanContentSchema.optional().describe(CONTENT_DESCRIPTION),
-    contentPatches: agentPlanContentPatchesSchema
-      .optional()
-      .default([])
-      .describe(CONTENT_PATCHES_DESCRIPTION),
-  }),
+  agentInputSchema: agentUpdateVisualPlanSchema,
   publicAgent: {
     expose: true,
     readOnly: false,
@@ -1173,6 +1203,18 @@ export default defineAction({
           ),
         })
       : null;
+    if (isAgentCaller) {
+      return {
+        ...compactAgentWriteResult(bundle, {
+          titleChanged: args.title !== undefined,
+          briefChanged: args.brief !== undefined,
+          statusChanged: args.status !== undefined,
+          contentPatchOps: args.contentPatches.map((patch) => patch.op),
+          commentCount: insertedCommentIds.length,
+        }),
+        ...(local?.written ? { localFiles: local } : {}),
+      };
+    }
     return {
       ...bundle,
       planId: bundle.plan.id,

package/corpus/templates/plan/app/pages/PlansPage.tsx

@@ -1602,7 +1602,7 @@ export function buildPlanAgentContext(input: {
       : [
           "Fast iteration workflow:",
           "1. Call get-visual-plan with this plan ID to read structured content, exported HTML, sections, comments, and activity.",
-          '2. Prefer update-visual-plan contentPatches for targeted edits. Examples: update-rich-text for copy, patch-prototype-html / update-prototype-screen for live prototype states, update-wireframe-node for one kit-tree node, update-canvas-frame for frame layout, append-canvas-annotation / update-canvas-annotation for canvas markup, append-block/remove-block for document changes, or replace-block for a single block. When the user asks for higher fidelity, polished mockups, production-like UI, real design, or anything "not sketchy," update this same plan in place: rewrite the relevant screen HTML/CSS and include set-visual-render-mode with renderMode design. Do not create a second plan, put CSS in style tags, or treat the viewer-local Clean toggle as a fidelity upgrade. Use full content only for broad restructuring. Use html only when preserving or importing a legacy standalone HTML artifact.',
+          '2. Prefer small update-visual-plan contentPatches for every edit to an existing plan. Examples: append-block for new tasks, update-rich-text for a bounded copy change, patch-prototype-html / update-prototype-screen for live prototype states, update-wireframe-node for one kit-tree node, update-canvas-frame for frame layout, append-canvas-annotation / update-canvas-annotation for canvas markup, or remove-block for one block. Never resend the full plan, use replace-blocks, or use patch-visual-plan-source replace-file for an incremental change - those payloads can be truncated before the tool receives them. When the user asks for higher fidelity, polished mockups, production-like UI, real design, or anything "not sketchy," update this same plan in place: rewrite the relevant screen HTML/CSS and include set-visual-render-mode with renderMode design. Do not create a second plan, put CSS in style tags, or treat the viewer-local Clean toggle as a fidelity upgrade. Use a full replacement only for an explicit broad rebuild. Use html only when preserving or importing a legacy standalone HTML artifact.',
           "3. Preserve the user's existing annotation comments and intent unless the user asks to remove or resolve them.",
           "4. Match the requested fidelity: ordinary UI planning can use sketch diagrams and wireframes; high-fidelity requests need the persisted Design surface with deliberate branded HTML/CSS and stable data-design-id targets.",
           "5. After applying feedback, keep the plan scannable, editable, and serious instead of turning it into a marketing page.",

package/corpus/templates/plan/changelog/2026-07-30-plan-agents-recover-with-targeted-writes.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-30
+---
+
+Plan agents now recover interrupted edits with small targeted writes.

package/corpus/templates/plan/shared/plan-content.ts

@@ -2944,6 +2944,41 @@ export const agentPlanContentPatchesSchema = z
       "replace-block / replace-blocks / append-block.",
   );
 
+/**
+ * Model-facing patch vocabulary for edits to an existing hosted plan. Full
+ * block/content replacement remains valid at runtime for the browser editor
+ * and explicit callers, but advertising it to an agent makes it too easy to
+ * resend the whole document and hit the provider's streamed-JSON limit.
+ */
+const AGENT_INCREMENTAL_PATCH_EXCLUDED_OPS = new Set([
+  "set-prototype",
+  "replace-block",
+  "replace-blocks",
+  "replace-wireframe-screen",
+]);
+
+const agentIncrementalPlanContentPatchOptions =
+  agentPlanContentPatchOptions.filter((option) => {
+    const op = (option.shape as { op: { value: string } }).op.value;
+    return !AGENT_INCREMENTAL_PATCH_EXCLUDED_OPS.has(op);
+  });
+
+export const agentPlanIncrementalContentPatchesSchema = z
+  .array(
+    z.discriminatedUnion(
+      "op",
+      agentIncrementalPlanContentPatchOptions as unknown as Parameters<
+        typeof z.discriminatedUnion
+      >[1],
+    ),
+  )
+  .max(80)
+  .describe(
+    "Small targeted edits to an existing plan. Prefer append-block, update-rich-text, " +
+      "patch-wireframe-html, patch-prototype-html, or update-block. Do not " +
+      "resend the full plan; use get-visual-plan for context and keep each call incremental.",
+  );
+
 export function applyPlanContentPatches(
   content: PlanContent,
   patches: PlanContentPatch[],

package/corpus/templates/slides/actions/create-deck.ts

@@ -75,7 +75,7 @@ const SlideSchema = z.object({
 
 // Accept either a parsed array (HTTP/agent) or a JSON string (CLI)
 const SlidesSchema = z.preprocess(
-  (v) => (typeof v === "string" ? JSON.parse(v) : v),
+  (v) => (v === undefined ? [] : typeof v === "string" ? JSON.parse(v) : v),
   z.array(SlideSchema),
 );
 

package/corpus/templates/slides/changelog/2026-07-30-new-decks-now-start-with-an-empty-slide-list-when-no-slides-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-30
+---
+
+New decks now start with an empty slide list when no slides are provided

package/dist/a2a/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/a2a/invoke.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,qBAAqB,EACvC,SAAS,IAAI,gBAAgB,EAC7B,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,UAAU,IAAI,iBAAiB,EAC/B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,WAAW,GACX,WAAW,CAAC;AAEhB,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IAE7C,YACE,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,EAOnE;CACF;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,6BAA6B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,6BAA6B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,cAAc,EAAE,OAAO,qBAAqB,CAAC;IAC7C,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,UAAU,EAAE,OAAO,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,mCAAmC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAmB,SAAQ,mCAAmC;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAyB,SAAQ,mCAAmC;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,6BAA6B,CAAC,CAqDxC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAwChC;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAkCtC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/a2a/invoke.ts"],"names":[],"mappings":"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"}

package/dist/a2a/invoke.js

@@ -121,9 +121,11 @@ export async function invokeAgentAction(options) {
 }
 export function buildAgentInvocationPrompt(prompt, agentUrl) {
     return (`${prompt}\n\n` +
-        `[Note: this request comes from another app via A2A. The caller cannot see your local UI, resource list, or navigation - only the literal text you put in your reply. ` +
+        `<a2a-caller-hint>\n` +
+        `This request comes from another app via A2A. The caller cannot see your local UI, resource list, or navigation - only the literal text you put in your reply. ` +
         `If you create or reference a deck/document/design/dashboard/resource, include its FULLY-QUALIFIED URL (e.g. ${agentUrl.replace(/\/$/, "")}/<path>/<id>) in your reply, not a relative path. ` +
-        `Use only artifact IDs and URL paths returned by successful actions - never invent slugs, IDs, or hosts.]`);
+        `Use only artifact IDs and URL paths returned by successful actions - never invent slugs, IDs, or hosts.\n` +
+        `</a2a-caller-hint>`);
 }
 export function looksLikeAgentUrl(value) {
     return /^[a-z][a-z0-9+.-]*:\/\//i.test(value.trim());