@agent-native/core 0.131.6 → 0.131.7

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":"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"}
+{"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());

package/dist/a2a/invoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/a2a/invoke.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  discoverAgents as defaultDiscoverAgents,\n  findAgent as defaultFindAgent,\n  type DiscoveredAgent,\n} from \"../server/agent-discovery.js\";\nimport {\n  callAction as defaultCallAction,\n  callAgent as defaultCallAgent,\n} from \"./client.js\";\nimport type {\n  A2ACorrelationMetadata,\n  A2AReadOnlyActionResult,\n} from \"./types.js\";\n\nexport type AgentInvocationErrorCode =\n  | \"missing-target\"\n  | \"missing-prompt\"\n  | \"missing-action\"\n  | \"invalid-input\"\n  | \"invalid-url\"\n  | \"self-call\"\n  | \"not-found\";\n\nexport class AgentInvocationError extends Error {\n  readonly code: AgentInvocationErrorCode;\n  readonly target?: string;\n  readonly availableAgents?: DiscoveredAgent[];\n\n  constructor(\n    code: AgentInvocationErrorCode,\n    message: string,\n    options?: { target?: string; availableAgents?: DiscoveredAgent[] },\n  ) {\n    super(message);\n    this.name = \"AgentInvocationError\";\n    this.code = code;\n    this.target = options?.target;\n    this.availableAgents = options?.availableAgents;\n  }\n}\n\nexport interface ResolvedAgentInvocationTarget {\n  kind: \"discovered\" | \"url\";\n  id?: string;\n  name: string;\n  description?: string;\n  url: string;\n  color?: string;\n}\n\nexport interface AgentInvocationResult {\n  target: ResolvedAgentInvocationTarget;\n  prompt: string;\n  responseText: string;\n}\n\nexport interface AgentActionInvocationResult {\n  target: ResolvedAgentInvocationTarget;\n  action: string;\n  result: A2AReadOnlyActionResult;\n}\n\nexport interface AgentInvocationRuntime {\n  findAgent: typeof defaultFindAgent;\n  discoverAgents: typeof defaultDiscoverAgents;\n  callAgent: typeof defaultCallAgent;\n  callAction: typeof defaultCallAction;\n}\n\nexport interface ResolveAgentInvocationTargetOptions {\n  selfAppId?: string;\n  selfUrl?: string;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\nexport interface InvokeAgentOptions extends ResolveAgentInvocationTargetOptions {\n  target: string;\n  prompt: string;\n  apiKey?: string;\n  contextId?: string;\n  userEmail?: string;\n  orgDomain?: string;\n  orgSecret?: string;\n  async?: boolean;\n  timeoutMs?: number;\n  pollIntervalMs?: number;\n  includeInvocationHint?: boolean;\n  correlation?: A2ACorrelationMetadata;\n  idempotencyKey?: string;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\nexport interface InvokeAgentActionOptions extends ResolveAgentInvocationTargetOptions {\n  target: string;\n  action: string;\n  input?: Record<string, unknown>;\n  apiKey?: string;\n  userEmail?: string;\n  orgDomain?: string;\n  orgSecret?: string;\n  requestTimeoutMs?: number;\n  correlation?: A2ACorrelationMetadata;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\n/**\n * Resolve an A2A invocation target from a direct URL or from the connected app\n * registry. ID/name resolution deliberately uses the same discovery path as\n * the in-agent `call-agent` script.\n */\nexport async function resolveAgentInvocationTarget(\n  target: string,\n  options: ResolveAgentInvocationTargetOptions = {},\n): Promise<ResolvedAgentInvocationTarget> {\n  const cleanTarget = target.trim();\n  if (!cleanTarget) {\n    throw new AgentInvocationError(\n      \"missing-target\",\n      \"Error: agent target is required\",\n    );\n  }\n\n  const directUrl = parseAgentUrl(cleanTarget);\n  if (directUrl) {\n    assertNotSelfUrl(directUrl, options.selfUrl);\n    return {\n      kind: \"url\",\n      name: directUrl,\n      url: directUrl,\n    };\n  }\n\n  if (\n    options.selfAppId &&\n    normalizeAgentHandle(cleanTarget) ===\n      normalizeAgentHandle(options.selfAppId)\n  ) {\n    throw new AgentInvocationError(\n      \"self-call\",\n      formatSelfCallError(options.selfAppId),\n      { target: cleanTarget },\n    );\n  }\n\n  const findAgent = options.runtime?.findAgent ?? defaultFindAgent;\n  const discoverAgents =\n    options.runtime?.discoverAgents ?? defaultDiscoverAgents;\n  const agent = await findAgent(cleanTarget, options.selfAppId);\n  if (!agent) {\n    const availableAgents = await discoverAgents(options.selfAppId);\n    const available = availableAgents.map((a) => a.name).join(\", \");\n    throw new AgentInvocationError(\n      \"not-found\",\n      `Error: Agent \"${cleanTarget}\" not found. Available agents: ${available || \"(none)\"}`,\n      { target: cleanTarget, availableAgents },\n    );\n  }\n\n  return {\n    kind: \"discovered\",\n    id: agent.id,\n    name: agent.name,\n    description: agent.description,\n    url: agent.url,\n    color: agent.color,\n  };\n}\n\n/**\n * First-class headless A2A primitive: resolve an app/agent by id, name, or URL,\n * send a text prompt, and return the text response with target metadata.\n */\nexport async function invokeAgent(\n  options: InvokeAgentOptions,\n): Promise<AgentInvocationResult> {\n  const prompt = options.prompt;\n  if (!prompt.trim()) {\n    throw new AgentInvocationError(\n      \"missing-prompt\",\n      \"Error: prompt is required\",\n      { target: options.target },\n    );\n  }\n\n  const target = await resolveAgentInvocationTarget(options.target, {\n    selfAppId: options.selfAppId,\n    selfUrl: options.selfUrl,\n    runtime: options.runtime,\n  });\n\n  const promptToSend =\n    options.includeInvocationHint === false\n      ? prompt\n      : buildAgentInvocationPrompt(prompt, target.url);\n\n  const callAgent = options.runtime?.callAgent ?? defaultCallAgent;\n  const responseText = await callAgent(target.url, promptToSend, {\n    apiKey: options.apiKey,\n    contextId: options.contextId,\n    userEmail: options.userEmail,\n    orgDomain: options.orgDomain,\n    orgSecret: options.orgSecret,\n    async: options.async,\n    timeoutMs: options.timeoutMs,\n    pollIntervalMs: options.pollIntervalMs,\n    correlation: options.correlation,\n    idempotencyKey: options.idempotencyKey,\n  });\n\n  return {\n    target,\n    prompt: promptToSend,\n    responseText,\n  };\n}\n\n/**\n * Resolve another app and execute one explicitly exposed read-only action on\n * it. This is the fast A2A path for bounded data operations that do not need a\n * second model to plan or synthesize.\n */\nexport async function invokeAgentAction(\n  options: InvokeAgentActionOptions,\n): Promise<AgentActionInvocationResult> {\n  const action = options.action.trim();\n  if (!action) {\n    throw new AgentInvocationError(\n      \"missing-action\",\n      \"Error: action is required\",\n      { target: options.target },\n    );\n  }\n  const input = options.input ?? {};\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    throw new AgentInvocationError(\n      \"invalid-input\",\n      \"Error: action input must be an object\",\n      { target: options.target },\n    );\n  }\n\n  const target = await resolveAgentInvocationTarget(options.target, {\n    selfAppId: options.selfAppId,\n    selfUrl: options.selfUrl,\n    runtime: options.runtime,\n  });\n  const callAction = options.runtime?.callAction ?? defaultCallAction;\n  const result = await callAction(target.url, action, input, {\n    apiKey: options.apiKey,\n    userEmail: options.userEmail,\n    orgDomain: options.orgDomain,\n    orgSecret: options.orgSecret,\n    requestTimeoutMs: options.requestTimeoutMs,\n    correlation: options.correlation,\n  });\n\n  return { target, action, result };\n}\n\nexport function buildAgentInvocationPrompt(\n  prompt: string,\n  agentUrl: string,\n): string {\n  return (\n    `${prompt}\\n\\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. ` +\n    `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. ` +\n    `Use only artifact IDs and URL paths returned by successful actions - never invent slugs, IDs, or hosts.]`\n  );\n}\n\nexport function looksLikeAgentUrl(value: string): boolean {\n  return /^[a-z][a-z0-9+.-]*:\\/\\//i.test(value.trim());\n}\n\nfunction parseAgentUrl(value: string): string | null {\n  const trimmed = value.trim();\n  if (!looksLikeAgentUrl(trimmed)) return null;\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new AgentInvocationError(\n      \"invalid-url\",\n      `Error: Invalid agent URL \"${trimmed}\"`,\n      { target: trimmed },\n    );\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new AgentInvocationError(\n      \"invalid-url\",\n      \"Error: Agent URL must use http or https\",\n      { target: trimmed },\n    );\n  }\n\n  parsed.hash = \"\";\n  parsed.search = \"\";\n  return parsed.toString().replace(/\\/$/, \"\");\n}\n\nfunction assertNotSelfUrl(targetUrl: string, selfUrl: string | undefined) {\n  if (!selfUrl) return;\n  const target = canonicalAgentBaseUrl(targetUrl);\n  const self = canonicalAgentBaseUrl(selfUrl);\n  if (!target || !self || target !== self) return;\n  throw new AgentInvocationError(\n    \"self-call\",\n    \"Error: You cannot invoke this app via A2A from itself. Use the app's own registered actions/tools instead. A2A invocation is only for communicating with other separately-deployed apps.\",\n    { target: targetUrl },\n  );\n}\n\nfunction canonicalAgentBaseUrl(value: string): string | null {\n  try {\n    const parsed = new URL(value);\n    parsed.hash = \"\";\n    parsed.search = \"\";\n    let pathname = parsed.pathname.replace(/\\/+$/, \"\");\n    if (pathname.endsWith(\"/_agent-native/a2a\")) {\n      pathname = pathname.slice(0, -\"/_agent-native/a2a\".length);\n    } else if (pathname.endsWith(\"/a2a\")) {\n      pathname = pathname.slice(0, -\"/a2a\".length);\n    }\n    parsed.pathname = pathname || \"/\";\n    return parsed.toString().replace(/\\/$/, \"\");\n  } catch {\n    return null;\n  }\n}\n\nfunction normalizeAgentHandle(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  if (\n    normalized === \"image\" ||\n    normalized === \"images\" ||\n    normalized === \"asset\"\n  ) {\n    return \"assets\";\n  }\n  return normalized;\n}\n\nfunction formatSelfCallError(selfAppId: string): string {\n  return `Error: You cannot use A2A invocation to call yourself (${selfAppId}). Use your own registered actions/tools instead. A2A invocation is only for communicating with OTHER separately-deployed apps.`;\n}\n"]}
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/a2a/invoke.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  discoverAgents as defaultDiscoverAgents,\n  findAgent as defaultFindAgent,\n  type DiscoveredAgent,\n} from \"../server/agent-discovery.js\";\nimport {\n  callAction as defaultCallAction,\n  callAgent as defaultCallAgent,\n} from \"./client.js\";\nimport type {\n  A2ACorrelationMetadata,\n  A2AReadOnlyActionResult,\n} from \"./types.js\";\n\nexport type AgentInvocationErrorCode =\n  | \"missing-target\"\n  | \"missing-prompt\"\n  | \"missing-action\"\n  | \"invalid-input\"\n  | \"invalid-url\"\n  | \"self-call\"\n  | \"not-found\";\n\nexport class AgentInvocationError extends Error {\n  readonly code: AgentInvocationErrorCode;\n  readonly target?: string;\n  readonly availableAgents?: DiscoveredAgent[];\n\n  constructor(\n    code: AgentInvocationErrorCode,\n    message: string,\n    options?: { target?: string; availableAgents?: DiscoveredAgent[] },\n  ) {\n    super(message);\n    this.name = \"AgentInvocationError\";\n    this.code = code;\n    this.target = options?.target;\n    this.availableAgents = options?.availableAgents;\n  }\n}\n\nexport interface ResolvedAgentInvocationTarget {\n  kind: \"discovered\" | \"url\";\n  id?: string;\n  name: string;\n  description?: string;\n  url: string;\n  color?: string;\n}\n\nexport interface AgentInvocationResult {\n  target: ResolvedAgentInvocationTarget;\n  prompt: string;\n  responseText: string;\n}\n\nexport interface AgentActionInvocationResult {\n  target: ResolvedAgentInvocationTarget;\n  action: string;\n  result: A2AReadOnlyActionResult;\n}\n\nexport interface AgentInvocationRuntime {\n  findAgent: typeof defaultFindAgent;\n  discoverAgents: typeof defaultDiscoverAgents;\n  callAgent: typeof defaultCallAgent;\n  callAction: typeof defaultCallAction;\n}\n\nexport interface ResolveAgentInvocationTargetOptions {\n  selfAppId?: string;\n  selfUrl?: string;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\nexport interface InvokeAgentOptions extends ResolveAgentInvocationTargetOptions {\n  target: string;\n  prompt: string;\n  apiKey?: string;\n  contextId?: string;\n  userEmail?: string;\n  orgDomain?: string;\n  orgSecret?: string;\n  async?: boolean;\n  timeoutMs?: number;\n  pollIntervalMs?: number;\n  includeInvocationHint?: boolean;\n  correlation?: A2ACorrelationMetadata;\n  idempotencyKey?: string;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\nexport interface InvokeAgentActionOptions extends ResolveAgentInvocationTargetOptions {\n  target: string;\n  action: string;\n  input?: Record<string, unknown>;\n  apiKey?: string;\n  userEmail?: string;\n  orgDomain?: string;\n  orgSecret?: string;\n  requestTimeoutMs?: number;\n  correlation?: A2ACorrelationMetadata;\n  runtime?: Partial<AgentInvocationRuntime>;\n}\n\n/**\n * Resolve an A2A invocation target from a direct URL or from the connected app\n * registry. ID/name resolution deliberately uses the same discovery path as\n * the in-agent `call-agent` script.\n */\nexport async function resolveAgentInvocationTarget(\n  target: string,\n  options: ResolveAgentInvocationTargetOptions = {},\n): Promise<ResolvedAgentInvocationTarget> {\n  const cleanTarget = target.trim();\n  if (!cleanTarget) {\n    throw new AgentInvocationError(\n      \"missing-target\",\n      \"Error: agent target is required\",\n    );\n  }\n\n  const directUrl = parseAgentUrl(cleanTarget);\n  if (directUrl) {\n    assertNotSelfUrl(directUrl, options.selfUrl);\n    return {\n      kind: \"url\",\n      name: directUrl,\n      url: directUrl,\n    };\n  }\n\n  if (\n    options.selfAppId &&\n    normalizeAgentHandle(cleanTarget) ===\n      normalizeAgentHandle(options.selfAppId)\n  ) {\n    throw new AgentInvocationError(\n      \"self-call\",\n      formatSelfCallError(options.selfAppId),\n      { target: cleanTarget },\n    );\n  }\n\n  const findAgent = options.runtime?.findAgent ?? defaultFindAgent;\n  const discoverAgents =\n    options.runtime?.discoverAgents ?? defaultDiscoverAgents;\n  const agent = await findAgent(cleanTarget, options.selfAppId);\n  if (!agent) {\n    const availableAgents = await discoverAgents(options.selfAppId);\n    const available = availableAgents.map((a) => a.name).join(\", \");\n    throw new AgentInvocationError(\n      \"not-found\",\n      `Error: Agent \"${cleanTarget}\" not found. Available agents: ${available || \"(none)\"}`,\n      { target: cleanTarget, availableAgents },\n    );\n  }\n\n  return {\n    kind: \"discovered\",\n    id: agent.id,\n    name: agent.name,\n    description: agent.description,\n    url: agent.url,\n    color: agent.color,\n  };\n}\n\n/**\n * First-class headless A2A primitive: resolve an app/agent by id, name, or URL,\n * send a text prompt, and return the text response with target metadata.\n */\nexport async function invokeAgent(\n  options: InvokeAgentOptions,\n): Promise<AgentInvocationResult> {\n  const prompt = options.prompt;\n  if (!prompt.trim()) {\n    throw new AgentInvocationError(\n      \"missing-prompt\",\n      \"Error: prompt is required\",\n      { target: options.target },\n    );\n  }\n\n  const target = await resolveAgentInvocationTarget(options.target, {\n    selfAppId: options.selfAppId,\n    selfUrl: options.selfUrl,\n    runtime: options.runtime,\n  });\n\n  const promptToSend =\n    options.includeInvocationHint === false\n      ? prompt\n      : buildAgentInvocationPrompt(prompt, target.url);\n\n  const callAgent = options.runtime?.callAgent ?? defaultCallAgent;\n  const responseText = await callAgent(target.url, promptToSend, {\n    apiKey: options.apiKey,\n    contextId: options.contextId,\n    userEmail: options.userEmail,\n    orgDomain: options.orgDomain,\n    orgSecret: options.orgSecret,\n    async: options.async,\n    timeoutMs: options.timeoutMs,\n    pollIntervalMs: options.pollIntervalMs,\n    correlation: options.correlation,\n    idempotencyKey: options.idempotencyKey,\n  });\n\n  return {\n    target,\n    prompt: promptToSend,\n    responseText,\n  };\n}\n\n/**\n * Resolve another app and execute one explicitly exposed read-only action on\n * it. This is the fast A2A path for bounded data operations that do not need a\n * second model to plan or synthesize.\n */\nexport async function invokeAgentAction(\n  options: InvokeAgentActionOptions,\n): Promise<AgentActionInvocationResult> {\n  const action = options.action.trim();\n  if (!action) {\n    throw new AgentInvocationError(\n      \"missing-action\",\n      \"Error: action is required\",\n      { target: options.target },\n    );\n  }\n  const input = options.input ?? {};\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    throw new AgentInvocationError(\n      \"invalid-input\",\n      \"Error: action input must be an object\",\n      { target: options.target },\n    );\n  }\n\n  const target = await resolveAgentInvocationTarget(options.target, {\n    selfAppId: options.selfAppId,\n    selfUrl: options.selfUrl,\n    runtime: options.runtime,\n  });\n  const callAction = options.runtime?.callAction ?? defaultCallAction;\n  const result = await callAction(target.url, action, input, {\n    apiKey: options.apiKey,\n    userEmail: options.userEmail,\n    orgDomain: options.orgDomain,\n    orgSecret: options.orgSecret,\n    requestTimeoutMs: options.requestTimeoutMs,\n    correlation: options.correlation,\n  });\n\n  return { target, action, result };\n}\n\nexport function buildAgentInvocationPrompt(\n  prompt: string,\n  agentUrl: string,\n): string {\n  return (\n    `${prompt}\\n\\n` +\n    `<a2a-caller-hint>\\n` +\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. ` +\n    `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. ` +\n    `Use only artifact IDs and URL paths returned by successful actions - never invent slugs, IDs, or hosts.\\n` +\n    `</a2a-caller-hint>`\n  );\n}\n\nexport function looksLikeAgentUrl(value: string): boolean {\n  return /^[a-z][a-z0-9+.-]*:\\/\\//i.test(value.trim());\n}\n\nfunction parseAgentUrl(value: string): string | null {\n  const trimmed = value.trim();\n  if (!looksLikeAgentUrl(trimmed)) return null;\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new AgentInvocationError(\n      \"invalid-url\",\n      `Error: Invalid agent URL \"${trimmed}\"`,\n      { target: trimmed },\n    );\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new AgentInvocationError(\n      \"invalid-url\",\n      \"Error: Agent URL must use http or https\",\n      { target: trimmed },\n    );\n  }\n\n  parsed.hash = \"\";\n  parsed.search = \"\";\n  return parsed.toString().replace(/\\/$/, \"\");\n}\n\nfunction assertNotSelfUrl(targetUrl: string, selfUrl: string | undefined) {\n  if (!selfUrl) return;\n  const target = canonicalAgentBaseUrl(targetUrl);\n  const self = canonicalAgentBaseUrl(selfUrl);\n  if (!target || !self || target !== self) return;\n  throw new AgentInvocationError(\n    \"self-call\",\n    \"Error: You cannot invoke this app via A2A from itself. Use the app's own registered actions/tools instead. A2A invocation is only for communicating with other separately-deployed apps.\",\n    { target: targetUrl },\n  );\n}\n\nfunction canonicalAgentBaseUrl(value: string): string | null {\n  try {\n    const parsed = new URL(value);\n    parsed.hash = \"\";\n    parsed.search = \"\";\n    let pathname = parsed.pathname.replace(/\\/+$/, \"\");\n    if (pathname.endsWith(\"/_agent-native/a2a\")) {\n      pathname = pathname.slice(0, -\"/_agent-native/a2a\".length);\n    } else if (pathname.endsWith(\"/a2a\")) {\n      pathname = pathname.slice(0, -\"/a2a\".length);\n    }\n    parsed.pathname = pathname || \"/\";\n    return parsed.toString().replace(/\\/$/, \"\");\n  } catch {\n    return null;\n  }\n}\n\nfunction normalizeAgentHandle(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  if (\n    normalized === \"image\" ||\n    normalized === \"images\" ||\n    normalized === \"asset\"\n  ) {\n    return \"assets\";\n  }\n  return normalized;\n}\n\nfunction formatSelfCallError(selfAppId: string): string {\n  return `Error: You cannot use A2A invocation to call yourself (${selfAppId}). Use your own registered actions/tools instead. A2A invocation is only for communicating with OTHER separately-deployed apps.`;\n}\n"]}

package/dist/agent/action-continuation-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-continuation-guidance.d.ts","sourceRoot":"","sources":["../../src/agent/action-continuation-guidance.ts"],"names":[],"mappings":"AAKA,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAyB1E;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtE"}
+{"version":3,"file":"action-continuation-guidance.d.ts","sourceRoot":"","sources":["../../src/agent/action-continuation-guidance.ts"],"names":[],"mappings":"AAKA,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0B1E;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtE"}

package/dist/agent/action-continuation-guidance.js

@@ -21,8 +21,9 @@ export function incrementalActionGuidance(tool) {
         case "create-prototype-plan":
             return "create the plan with its core sections or first screen, then expand it with `update-visual-plan`/`patch-visual-plan-source` follow-up edits";
         case "update-visual-plan":
+            return "apply one or a few small `update-visual-plan` `contentPatches` such as `append-block`, `update-rich-text`, or a text patch; do not resend the full plan or switch to a source-control workflow";
         case "patch-visual-plan-source":
-            return "apply smaller, targeted `patch-visual-plan-source` edits rather than rewriting the whole plan in one call";
+            return "apply small targeted `patch-visual-plan-source` MDX AST edits; do not use `replace-file`, and do not use this source action for a live plan edit";
         case "update-dashboard":
             return "save a small dashboard first, then add panels one at a time with `update-dashboard` incremental `ops` edits instead of authoring the whole config in one call";
         default:

package/dist/agent/action-continuation-guidance.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-continuation-guidance.js","sourceRoot":"","sources":["../../src/agent/action-continuation-guidance.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,yBAAyB;AACzB,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,gHAAgH,CAAC;QAC1H,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,6aAA6a,CAAC;QACvb,KAAK,aAAa;YAChB,OAAO,8jBAA8jB,CAAC;QACxkB,KAAK,yBAAyB;YAC5B,OAAO,ubAAub,CAAC;QACjc,KAAK,oBAAoB,CAAC;QAC1B,KAAK,gBAAgB,CAAC;QACtB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,uBAAuB;YAC1B,OAAO,6IAA6I,CAAC;QACvJ,KAAK,oBAAoB,CAAC;QAC1B,KAAK,0BAA0B;YAC7B,OAAO,2GAA2G,CAAC;QACrH,KAAK,kBAAkB;YACrB,OAAO,+JAA+J,CAAC;QACzK;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,IAAY;IAC5D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,QAAQ;QACb,CAAC,CAAC,0DAA0D,IAAI,wHAAwH,QAAQ,GAAG;QACnM,CAAC,CAAC,0DAA0D,IAAI,yMAAyM,CAAC;AAC9Q,CAAC","sourcesContent":["// Concrete \"ship a compact first version, then refine incrementally\" guidance\n// keyed by the large-payload action the model was cut off while preparing.\n// A run cut off before the tool starts tends to reassemble the same oversized\n// payload on every continuation; pointing the model at the incremental path is\n// what breaks that loop.\nexport function incrementalActionGuidance(tool: string): string | undefined {\n  switch (tool) {\n    case \"create-extension\":\n    case \"update-extension\":\n      return \"create a compact working v1 with `create-extension`, then use focused `update-extension` edits for refinements\";\n    case \"generate-design\":\n    case \"update-design\":\n      return 'if an existing design file or snapshot is already in history, especially after a Design variant pick, stop retrying `generate-design`: call `get-design-snapshot` for the selected file, then call `edit-design` once on that same `fileId` (`mode: \"replace-file\"` for a compact full-file replacement, or search/replace for smaller edits). Use `generate-design` only for a brand-new compact first file when no target file exists yet';\n    case \"edit-design\":\n      return 'retry with a smaller `edit-design` payload against the already-snapshotted file. If this is a selected Design variant expansion, reuse the existing `fileId` and snapshot in history; do not call `list-files`, `delete-file`, or `get-design-snapshot` again just to recover. Save one compact complete first version with `mode: \"replace-file\"` and `replacementContent`, or use a handful of exact search/replace edits when that is smaller. Avoid another huge full-file rewrite; upgrade the highest-value visible sections first, save once, and summarize any remaining refinements';\n    case \"present-design-variants\":\n      return 'call `present-design-variants` with concise labels, descriptions, accent colors, and feature bullets; omit large `content` HTML when needed so the action can render compact representative screens. After the user picks a direction, delete unchosen screens, snapshot the selected `fileId`, and refine that same file with `edit-design` (`mode: \"replace-file\"` for placeholder expansion). Do not call `generate-design` after the variant pick';\n    case \"create-visual-plan\":\n    case \"create-ui-plan\":\n    case \"create-plan-design\":\n    case \"create-prototype-plan\":\n      return \"create the plan with its core sections or first screen, then expand it with `update-visual-plan`/`patch-visual-plan-source` follow-up edits\";\n    case \"update-visual-plan\":\n    case \"patch-visual-plan-source\":\n      return \"apply smaller, targeted `patch-visual-plan-source` edits rather than rewriting the whole plan in one call\";\n    case \"update-dashboard\":\n      return \"save a small dashboard first, then add panels one at a time with `update-dashboard` incremental `ops` edits instead of authoring the whole config in one call\";\n    default:\n      return undefined;\n  }\n}\n\nexport function actionPreparationContinuationNote(tool: string): string {\n  const guidance = incrementalActionGuidance(tool);\n  return guidance\n    ? `\\n\\nThe previous run was cut off while preparing the \\`${tool}\\` action input before the action could finish. Avoid spending another whole run assembling one large tool payload - ${guidance}.`\n    : `\\n\\nThe previous run was cut off while preparing the \\`${tool}\\` action input before the action could finish. Avoid re-assembling one large tool payload: produce a compact first result you can finish in a single run, then refine it with smaller follow-up edits.`;\n}\n"]}
+{"version":3,"file":"action-continuation-guidance.js","sourceRoot":"","sources":["../../src/agent/action-continuation-guidance.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,yBAAyB;AACzB,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,gHAAgH,CAAC;QAC1H,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,6aAA6a,CAAC;QACvb,KAAK,aAAa;YAChB,OAAO,8jBAA8jB,CAAC;QACxkB,KAAK,yBAAyB;YAC5B,OAAO,ubAAub,CAAC;QACjc,KAAK,oBAAoB,CAAC;QAC1B,KAAK,gBAAgB,CAAC;QACtB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,uBAAuB;YAC1B,OAAO,6IAA6I,CAAC;QACvJ,KAAK,oBAAoB;YACvB,OAAO,gMAAgM,CAAC;QAC1M,KAAK,0BAA0B;YAC7B,OAAO,kJAAkJ,CAAC;QAC5J,KAAK,kBAAkB;YACrB,OAAO,+JAA+J,CAAC;QACzK;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,IAAY;IAC5D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,QAAQ;QACb,CAAC,CAAC,0DAA0D,IAAI,wHAAwH,QAAQ,GAAG;QACnM,CAAC,CAAC,0DAA0D,IAAI,yMAAyM,CAAC;AAC9Q,CAAC","sourcesContent":["// Concrete \"ship a compact first version, then refine incrementally\" guidance\n// keyed by the large-payload action the model was cut off while preparing.\n// A run cut off before the tool starts tends to reassemble the same oversized\n// payload on every continuation; pointing the model at the incremental path is\n// what breaks that loop.\nexport function incrementalActionGuidance(tool: string): string | undefined {\n  switch (tool) {\n    case \"create-extension\":\n    case \"update-extension\":\n      return \"create a compact working v1 with `create-extension`, then use focused `update-extension` edits for refinements\";\n    case \"generate-design\":\n    case \"update-design\":\n      return 'if an existing design file or snapshot is already in history, especially after a Design variant pick, stop retrying `generate-design`: call `get-design-snapshot` for the selected file, then call `edit-design` once on that same `fileId` (`mode: \"replace-file\"` for a compact full-file replacement, or search/replace for smaller edits). Use `generate-design` only for a brand-new compact first file when no target file exists yet';\n    case \"edit-design\":\n      return 'retry with a smaller `edit-design` payload against the already-snapshotted file. If this is a selected Design variant expansion, reuse the existing `fileId` and snapshot in history; do not call `list-files`, `delete-file`, or `get-design-snapshot` again just to recover. Save one compact complete first version with `mode: \"replace-file\"` and `replacementContent`, or use a handful of exact search/replace edits when that is smaller. Avoid another huge full-file rewrite; upgrade the highest-value visible sections first, save once, and summarize any remaining refinements';\n    case \"present-design-variants\":\n      return 'call `present-design-variants` with concise labels, descriptions, accent colors, and feature bullets; omit large `content` HTML when needed so the action can render compact representative screens. After the user picks a direction, delete unchosen screens, snapshot the selected `fileId`, and refine that same file with `edit-design` (`mode: \"replace-file\"` for placeholder expansion). Do not call `generate-design` after the variant pick';\n    case \"create-visual-plan\":\n    case \"create-ui-plan\":\n    case \"create-plan-design\":\n    case \"create-prototype-plan\":\n      return \"create the plan with its core sections or first screen, then expand it with `update-visual-plan`/`patch-visual-plan-source` follow-up edits\";\n    case \"update-visual-plan\":\n      return \"apply one or a few small `update-visual-plan` `contentPatches` such as `append-block`, `update-rich-text`, or a text patch; do not resend the full plan or switch to a source-control workflow\";\n    case \"patch-visual-plan-source\":\n      return \"apply small targeted `patch-visual-plan-source` MDX AST edits; do not use `replace-file`, and do not use this source action for a live plan edit\";\n    case \"update-dashboard\":\n      return \"save a small dashboard first, then add panels one at a time with `update-dashboard` incremental `ops` edits instead of authoring the whole config in one call\";\n    default:\n      return undefined;\n  }\n}\n\nexport function actionPreparationContinuationNote(tool: string): string {\n  const guidance = incrementalActionGuidance(tool);\n  return guidance\n    ? `\\n\\nThe previous run was cut off while preparing the \\`${tool}\\` action input before the action could finish. Avoid spending another whole run assembling one large tool payload - ${guidance}.`\n    : `\\n\\nThe previous run was cut off while preparing the \\`${tool}\\` action input before the action could finish. Avoid re-assembling one large tool payload: produce a compact first result you can finish in a single run, then refine it with smaller follow-up edits.`;\n}\n"]}

package/dist/agent/engine/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/registry.ts"],"names":[],"mappings":"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"}

package/dist/agent/engine/registry.js

@@ -459,6 +459,41 @@ async function resolveUsableProviderSecret(key) {
     const authFailure = await getProviderCredentialAuthFailure({ key, value });
     return authFailure ? null : value;
 }
+/**
+ * Return true only when the supplied key can be positively identified as a
+ * usable credential for a different registered provider.
+ *
+ * `ResolveEngineConfig.apiKey` is public and may be an opaque caller-provided
+ * key, so automatic selection must not silently replace it merely because a
+ * stored credential also exists. Delegated/internal callers, however,
+ * historically pass the current "active" provider key before the registry
+ * selects an app-default engine. Exact in-memory comparison lets us correct
+ * that proven mismatch without guessing from provider-specific key prefixes
+ * or exposing either value.
+ */
+async function apiKeyBelongsToDifferentProvider(apiKey, selectedEntry) {
+    const selectedEnvVars = new Set(selectedEntry.requiredEnvVars);
+    const checkedEnvVars = new Set();
+    for (const entry of _registry.values()) {
+        if (entry === selectedEntry || entry.name === "builder")
+            continue;
+        for (const key of entry.requiredEnvVars) {
+            if (selectedEnvVars.has(key) || checkedEnvVars.has(key))
+                continue;
+            checkedEnvVars.add(key);
+            try {
+                if ((await resolveUsableProviderSecret(key)) === apiKey)
+                    return true;
+            }
+            catch {
+                // An unrelated provider store failure is not proof that the explicit
+                // key belongs elsewhere. Preserve the caller's key and let the
+                // selected provider's own preflight report any relevant failure.
+            }
+        }
+    }
+    return false;
+}
 async function engineCreateConfigForEntry(entry, apiKey, extra, preferResolvedCredential = false) {
     const safeExtra = { ...(extra ?? {}) };
     let matchingApiKey = apiKey;
@@ -466,27 +501,39 @@ async function engineCreateConfigForEntry(entry, apiKey, extra, preferResolvedCr
     // Callers historically passed one untagged "active" key before the registry
     // chose an engine, which could hand an Anthropic key to an app-default
     // OpenAI engine (or vice versa). Explicit engineOption branches retain their
-    // paired key; automatic branches opt into matching the chosen provider here.
+    // paired key. Automatic branches replace only a key proven to belong to a
+    // different configured provider; opaque caller-supplied keys keep the public
+    // `ResolveEngineConfig.apiKey` contract.
     if (preferResolvedCredential &&
         entry.name !== "builder" &&
         entry.requiredEnvVars.length > 0) {
-        let foundMatchingCredential = false;
+        let resolvedMatchingCredential;
+        let matchingCredentialUsesDeployFallback = false;
         for (const key of entry.requiredEnvVars) {
             const resolved = (await resolveUsableProviderSecret(key)) ?? undefined;
             if (!resolved)
                 continue;
-            foundMatchingCredential = true;
-            const deployFallback = canUseDeployCredentialFallbackForRequest(key) &&
-                readDeployCredentialEnv(key) === resolved;
+            resolvedMatchingCredential = resolved;
+            matchingCredentialUsesDeployFallback =
+                canUseDeployCredentialFallbackForRequest(key) &&
+                    readDeployCredentialEnv(key) === resolved;
+            break;
+        }
+        const suppliedKeyMatchesSelected = matchingApiKey !== undefined &&
+            matchingApiKey === resolvedMatchingCredential;
+        const suppliedKeyBelongsElsewhere = matchingApiKey !== undefined &&
+            !suppliedKeyMatchesSelected &&
+            (await apiKeyBelongsToDifferentProvider(matchingApiKey, entry));
+        if (matchingApiKey === undefined || suppliedKeyBelongsElsewhere) {
             // Keep deploy-only credentials implicit so provider SDKs retain their
             // established env-fallback behavior. Scoped credentials must be passed
-            // explicitly, and replace an unrelated preselected provider key.
-            if (matchingApiKey || !deployFallback)
-                matchingApiKey = resolved;
-            break;
+            // explicitly. A proven different-provider key is replaced or cleared;
+            // an opaque caller-supplied key is preserved by the branch above.
+            matchingApiKey =
+                resolvedMatchingCredential && !matchingCredentialUsesDeployFallback
+                    ? resolvedMatchingCredential
+                    : undefined;
         }
-        if (!foundMatchingCredential)
-            matchingApiKey = undefined;
     }
     if (entry.name === "ai-sdk:openai") {
         if (typeof safeExtra.baseURL === "string" && safeExtra.baseUrl == null) {
@@ -703,7 +750,7 @@ export async function resolveEngine(config) {
     if (!anthropicEntry) {
         throw new Error("[agent-engine] Default Anthropic engine is not registered. Did builtin.ts fail to load?");
     }
-    return anthropicEntry.create(await engineCreateConfigForEntry(anthropicEntry, apiKey));
+    return anthropicEntry.create(await engineCreateConfigForEntry(anthropicEntry, apiKey, undefined, true));
 }
 /**
  * Read the user-selected model for an engine from the `agent-engine` setting.