@agent-native/core 0.177.1-nightly-20260908183718 → 0.177.1

package/README.md

@@ -76,14 +76,20 @@ See Agent-Native in action:
 
 https://github.com/user-attachments/assets/ef51644b-6506-46d8-8083-0af7b7e5b65c
 
+<br />
+
 ## Open-source agents
 
 Start from one of these agents or use it as an example for your own.
 
+<br />
+
 <table>
 <tr>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Clips**
 
 <a href="https://agent-native.com/apps/clips/">
@@ -95,9 +101,13 @@ Start from one of these agents or use it as an example for your own.
 
 Record and understand meetings, screens, and voice notes.
 
+<br />
+
 </td>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Design**
 
 <a href="https://agent-native.com/apps/design/">
@@ -109,9 +119,13 @@ Record and understand meetings, screens, and voice notes.
 
 Generate and refine interactive designs.
 
+<br />
+
 </td>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Slides**
 
 <a href="https://agent-native.com/apps/slides/">
@@ -123,11 +137,15 @@ Generate and refine interactive designs.
 
 Create and edit on-brand presentations.
 
+<br />
+
 </td>
 </tr>
 <tr>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Analytics**
 
 <a href="https://agent-native.com/apps/analytics/">
@@ -139,9 +157,13 @@ Create and edit on-brand presentations.
 
 Ask questions of your data and build dashboards.
 
+<br />
+
 </td>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Calendar**
 
 <a href="https://agent-native.com/apps/calendar/">
@@ -153,9 +175,13 @@ Ask questions of your data and build dashboards.
 
 Find time, schedule events, and manage bookings.
 
+<br />
+
 </td>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Mail**
 
 <a href="https://agent-native.com/apps/mail/">
@@ -167,11 +193,15 @@ Find time, schedule events, and manage bookings.
 
 Prioritize email, draft replies, and follow up.
 
+<br />
+
 </td>
 </tr>
 <tr>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Assets**
 
 <a href="https://agent-native.com/apps/assets/">
@@ -183,9 +213,13 @@ Prioritize email, draft replies, and follow up.
 
 Create and organize on-brand media.
 
+<br />
+
 </td>
 <td width="33%" align="center" valign="top">
 
+<br />
+
 **Content**
 
 <a href="https://agent-native.com/apps/content/">
@@ -197,8 +231,27 @@ Create and organize on-brand media.
 
 Draft, organize, and publish content.
 
+<br />
+
+</td>
+<td width="33%" align="center" valign="top">
+
+<br />
+
+**Plans**
+
+<a href="https://agent-native.com/apps/plan/">
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2Fe89439e917044fc9ac9663737e35bf1f?format=webp&width=800">
+<img src="https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F98427229c8c84c30afee56172503c294?format=webp&width=800" alt="Plans app screenshot" width="100%">
+</picture>
+</a>
+
+Create and review visual plans with diagrams, wireframes, and prototypes.
+
+<br />
+
 </td>
-<td width="33%"></td>
 </tr>
 </table>
 

package/corpus/templates/design/app/pages/DesignEditor.tsx

@@ -19,7 +19,6 @@ import { writeClipboardText } from "@agent-native/core/client/clipboard";
 import {
   useCollaborativeDoc,
   isReconcileLeadClient,
-  dedupeCollabUsersByEmail,
   emailToColor,
   emailToName,
   usePresence,
@@ -67,6 +66,7 @@ import {
 } from "@agent-native/creative-context/client";
 import {
   LiveCursorOverlay,
+  PresenceBar,
   RemoteSelectionRings,
   RecentEditHighlights,
 } from "@agent-native/toolkit/collab-ui";
@@ -225,8 +225,6 @@ import {
 import { nextTextDecorationLineValue } from "@/components/design/edit-panel/typography-helpers";
 import { AgentNativeMenuMark } from "@/components/design/editor/AgentNativeMenuMark";
 import { DesignBottomToolbar } from "@/components/design/editor/DesignBottomToolbar";
-import type { DesignCollaborator } from "@/components/design/editor/DesignCollaborators";
-import { DesignCollaboratorsMenu } from "@/components/design/editor/DesignCollaborators";
 import {
   DesignWorkspaceRail,
   INITIAL_GENERATION_DISABLED_LEFT_PANELS,
@@ -5276,7 +5274,7 @@ function DesignEditor() {
   );
 
   // Collaborative editing for the active file
-  const { ydoc, awareness, isSynced, activeUsers, agentActive } =
+  const { ydoc, awareness, isSynced, activeUsers, agentPresent, agentActive } =
     useCollaborativeDoc({
       docId:
         isSignedIn && canEditDesign && viewMode === "single"
@@ -6245,29 +6243,6 @@ function DesignEditor() {
     [followingEmail, stopFollowing],
   );
 
-  const designCollaborators = useMemo<DesignCollaborator[]>(() => {
-    const currentEmail = currentUser?.email.trim().toLowerCase() ?? null;
-    const humans = dedupeCollabUsersByEmail([
-      ...(currentUser ? [currentUser] : []),
-      ...activeUsers,
-    ]).filter((user) => user.email.trim().toLowerCase() !== "agent@system");
-    const otherHumans = humans.filter(
-      (user) => user.email.trim().toLowerCase() !== currentEmail,
-    );
-    const collaborators = otherHumans.map((user) => ({ user }));
-
-    if (!currentUser) return collaborators;
-
-    return [
-      {
-        user: currentUser,
-        image: session?.image,
-        isCurrent: true,
-      },
-      ...collaborators,
-    ];
-  }, [activeUsers, currentUser, session?.image]);
-
   // Resolve the content to render: prefer collab content only after the
   // per-file reconcile state has reset for the current active file. Otherwise a
   // file switch can render one frame with the previous file's Yjs text.
@@ -19492,11 +19467,19 @@ function DesignEditor() {
         {minimalUi ? minimalRightSidebarToggle : null}
         <div className="flex min-w-0 flex-1 items-center gap-[var(--design-baseline-half)]">
           {hostEmbeddedEditor ? null : (
-            <DesignCollaboratorsMenu
-              collaborators={designCollaborators}
+            <PresenceBar
+              activeUsers={[
+                ...(currentUser ? [currentUser] : []),
+                ...(activeUsers ?? []),
+              ]}
+              agentPresent={agentPresent}
+              agentActive={agentActive}
+              currentUserEmail={currentUser?.email}
+              showCurrentUser
               followingEmail={followingEmail}
-              label={t("designEditor.collaborators")}
               onAvatarClick={handleAvatarClick}
+              disableAgentClick
+              className="shrink-0"
             />
           )}
         </div>

package/corpus/templates/slides/AGENTS.md

@@ -44,7 +44,7 @@ Read the relevant skill before deeper work:
   configuration and fake placeholders in examples.
 - For external integrations, inspect the workspace/provider connection catalog first.
 - Use actions (table above) for every deck/slide write; never write rows
-  directly. Read the schema if a parameter is unclear.
+  directly. Read the schema when unclear.
 - Use `view-screen` before editing when the active deck, selected slide, or
   current layout is unclear.
 - Preserve deck structure and visual consistency. Prefer focused slide edits over
@@ -70,14 +70,14 @@ Read the relevant skill before deeper work:
 - For per-click reveals, follow `slide-editing`'s click-to-reveal rules.
 - For images, use `generate-image-api` with provenance; show results as
   `![alt](url)`.
-- For focused selected-text edits follow the `update-slide` / `get-deck` /
-  `patch-deck` contract in `slide-editing` (one literal replacement,
-  `expectedMatches: 1`, `baseContentHash` from `view-screen`); the same rule
-  reaches external callers through this app's `mcp.instructions`.
+- For focused edits, prefer `view-screen`'s exact `selectedText` with `find`,
+  `expectedMatches: 1`, and `baseContentHash`; without it, use `objectId` with
+  `replace` and the same hash, else exact `find` and `expectedMatches: 1` (see
+  `slide-editing` and `mcp.instructions`).
 - For data requests, follow `analytics-data-for-decks`; delegate via Analytics
   over A2A, never write SQL or call providers directly.
-- When the user names no reference deck or design system, call
-  `get-workspace-defaults` first (see `create-deck`).
+- Without a reference deck or design system, call `get-workspace-defaults`
+  first (see `create-deck`).
 - Before generation, follow `creative-context` for source order, `contextMode`,
   and governed-context submission via `manage-context-membership`.
 ## Persistence Model

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

@@ -170,7 +170,7 @@ function sourceEditabilityForDeck(
 export default defineAction({
   title: "Read Slides deck",
   description:
-    "Read a Slides deck or one slide. Pass the deck ID as `id` or `deckId` (either name works) and pass slideId for a targeted read; that returns only the slide's full HTML and contentHash. The result includes linked `designSystem.agentContext` when the deck has a readable design system; treat it as authoritative before authoring or restyling. If view-screen supplies an exact selectedText browser range and slide ID, do not call this without slideId for a focused text edit: call update-slide directly with one literal edits replacement and expectedMatches=1. An element text preview is not an exact range and needs a targeted read before text mutation. Use compact=true for a lightweight targeted check, or compact=false and format=true when markup or layout requires source inspection. For source-preserving work, sourceEditability states whether structural edits are blocked and names the patch-deck rewriteSource conversion path; the compact result also includes sourceCoverage. Do not claim completion until sourceCoverage.complete is true and its expectedSlideIds and actualSlideIds match in order. User-visible slide numbers are 1-based and match the UI. Use slideId for edits. Returns deckStyle (backgrounds, text and accent colors, fonts, heading sizes across slides, with deviating slides named) and representativeSlideId; before a structural or layout change, read that slide with slideId and compact='false' and mirror its structure and values.",
+    "Read a Slides deck or one slide. Pass the deck ID as `id` or `deckId` (either name works) and pass slideId for a targeted read; that returns only the slide's full HTML and contentHash. The result includes linked `designSystem.agentContext` when the deck has a readable design system; treat it as authoritative before authoring or restyling. If view-screen supplies an exact selectedText browser range and slide ID, do not call this without slideId for a focused text edit: call update-slide directly with one literal edits replacement and expectedMatches=1. If view-screen supplies a stable objectId for a selected element, call update-slide directly with that objectId to replace only the element's inner content. An element preview without objectId or an edit that changes markup needs a targeted read before text mutation. Use compact=true for a lightweight targeted check, or compact=false and format=true when markup or layout requires source inspection. For source-preserving work, sourceEditability states whether structural edits are blocked and names the patch-deck rewriteSource conversion path; the compact result also includes sourceCoverage. Do not claim completion until sourceCoverage.complete is true and its expectedSlideIds and actualSlideIds match in order. User-visible slide numbers are 1-based and match the UI. Use slideId for edits. Returns deckStyle (backgrounds, text and accent colors, fonts, heading sizes across slides, with deviating slides named) and representativeSlideId; before a structural or layout change, read that slide with slideId and compact='false' and mirror its structure and values.",
   timeoutMs: 60_000,
   schema: z.object({
     id: z

package/corpus/templates/slides/actions/update-slide.ts

@@ -288,7 +288,7 @@ function assertStyleOnlyEdit(
 export default defineAction({
   title: "Edit one Slides slide",
   description:
-    "Edit exactly one Slides slide. For a focused edit or translation of current or selected text, use one literal replace item in edits with the exact text and expectedMatches=1; when view-screen already supplies the target, do not fetch the full deck, use fullContent, or wait for layout-fit. For a style request, get-deck's designSystem and deckStyle (also printed by view-screen) are authoritative; for anything beyond colors (spacing, element order, sizes) first read the representativeSlideId with a targeted get-deck and mirror its structure. Introduce colors or fonts the deck does not already use only when the user asks for them. Use targeted get-deck with slideId only if the selection text is missing, truncated, ambiguous, the literal match fails, or the edit changes markup or layout; then use ordered edits and an optional baseContentHash. Use exactly one input mode: edits, legacy find/replace, or fullContent. Mixed modes are rejected and write nothing. Prefer edits over fullContent so unrelated markup is not regenerated. For style-only requests, set styleOnly=true and use edits that change only the requested CSS declarations and preserve text and layout properties; the action rejects text or markup changes and fullContent in that mode. Never use unresolved placeholder markers as stand-ins for preserved content. Content edits clear existing click-reveal metadata; style-only CSS edits preserve it because the HTML structure remains stable. Use patch-deck with the complete animations list when a content edit intentionally changes both content and reveals. Source-imported slides preserve their original images and factual copy by default. The action returns immediately after persistence; layoutFit.status=pending means the open editor will measure the new content asynchronously, and get-layout-overflows can check the returned contentHash plus layoutFitRevision later.",
+    "Edit exactly one Slides slide. For a focused edit or translation of current or selected text, use one literal replace item in edits with the exact text and expectedMatches=1; when view-screen supplies an objectId for a selected element, use that objectId instead of find to replace only that element's inner content. The top-level objectId and replace fields are also supported as a compact alternative to edits. When view-screen already supplies the target, do not fetch the full deck, use fullContent, or wait for layout-fit. For a style request, get-deck's designSystem and deckStyle (also printed by view-screen) are authoritative; for anything beyond colors (spacing, element order, sizes) first read the representativeSlideId with a targeted get-deck and mirror its structure. Introduce colors or fonts the deck does not already use only when the user asks for them. Use targeted get-deck with slideId only if the selection text is missing, truncated, ambiguous, the literal match fails, or the edit changes markup or layout; then use ordered edits and an optional baseContentHash. Use exactly one input mode: edits, legacy find/replace or objectId/replace, or fullContent. Mixed modes are rejected and write nothing. Prefer edits over fullContent so unrelated markup is not regenerated. For style-only requests, set styleOnly=true and use edits that change only the requested CSS declarations and preserve text and layout properties; the action rejects text or markup changes and fullContent in that mode. Never use unresolved placeholder markers as stand-ins for preserved content. Content edits clear existing click-reveal metadata; style-only CSS edits preserve it because the HTML structure remains stable. Use patch-deck with the complete animations list when a content edit intentionally changes both content and reveals. Source-imported slides preserve their original images and factual copy by default. The action returns immediately after persistence; layoutFit.status=pending means the open editor will measure the new content asynchronously, and get-layout-overflows can check the returned contentHash plus layoutFitRevision later.",
   schema: z.object({
     deckId: z.string().describe("Deck ID"),
     slideId: z.string().describe("Slide ID"),
@@ -296,10 +296,19 @@ export default defineAction({
       .string()
       .optional()
       .describe("Text to find (for surgical search-replace edit)"),
+    objectId: z
+      .string()
+      .min(1)
+      .optional()
+      .describe(
+        "Stable data-slide-object-id for replacing the selected element's inner content",
+      ),
     replace: z
       .string()
       .optional()
-      .describe("Replacement text (default: empty string)"),
+      .describe(
+        "Replacement text; pass an empty string explicitly to clear it",
+      ),
     fullContent: z
       .string()
       .optional()
@@ -307,15 +316,46 @@ export default defineAction({
     edits: z
       .array(
         z.union([
-          z.object({
-            op: z.literal("replace").optional(),
-            find: z.string(),
-            replace: z.string(),
-            all: z.boolean().optional(),
-            occurrence: z.number().int().positive().optional(),
-            expectedMatches: z.number().int().nonnegative().optional(),
-            required: z.boolean().optional(),
-          }),
+          z
+            .object({
+              op: z.literal("replace").optional(),
+              find: z.string().optional(),
+              objectId: z.string().min(1).optional(),
+              replace: z.string(),
+              all: z.boolean().optional(),
+              occurrence: z.number().int().positive().optional(),
+              expectedMatches: z.number().int().nonnegative().optional(),
+              required: z.boolean().optional(),
+            })
+            .superRefine((edit, context) => {
+              if ((edit.find !== undefined) === (edit.objectId !== undefined)) {
+                context.addIssue({
+                  code: "custom",
+                  message:
+                    "A replace edit requires exactly one of find or objectId",
+                });
+              }
+              if (
+                edit.objectId !== undefined &&
+                (edit.all !== undefined || edit.occurrence !== undefined)
+              ) {
+                context.addIssue({
+                  code: "custom",
+                  message:
+                    "objectId replacement does not support all or occurrence",
+                });
+              }
+              if (
+                edit.objectId !== undefined &&
+                edit.expectedMatches !== undefined &&
+                edit.expectedMatches !== 1
+              ) {
+                context.addIssue({
+                  code: "custom",
+                  message: "objectId replacement expectedMatches must be 1",
+                });
+              }
+            }),
           z.object({
             op: z.enum(["insert-before", "insert-after"]),
             marker: z.string(),
@@ -347,7 +387,7 @@ export default defineAction({
       .min(1)
       .optional()
       .describe(
-        "Ordered atomic edits against the current HTML. For one selected or current text replacement, use one literal replace with the exact text and expectedMatches=1. Each edit must match unless required=false.",
+        "Ordered atomic edits against the current HTML. For one exact text replacement, use find and expectedMatches=1; for a selected element without exact selectedText, use its objectId to replace only the element's inner content. Each edit must match unless required=false.",
       ),
     styleOnly: z
       .boolean()
@@ -401,6 +441,7 @@ export default defineAction({
       deckId,
       slideId,
       find,
+      objectId,
       replace,
       fullContent,
       edits,
@@ -412,29 +453,50 @@ export default defineAction({
       contextModeOverride,
       reuseLabels,
     } = args;
-    const hasLegacyMode = find !== undefined || replace !== undefined;
+    const hasLegacyMode =
+      find !== undefined || objectId !== undefined || replace !== undefined;
     const inputModeCount =
       Number(Boolean(edits)) +
       Number(hasLegacyMode) +
       Number(fullContent !== undefined);
     if (inputModeCount === 0) {
-      fail("One of --edits, --find, or --fullContent is required", {
-        errorCode: "slide_edit_mode_required",
-      });
+      fail(
+        "One of --edits, --find/--replace, --objectId/--replace, or --fullContent is required",
+        {
+          errorCode: "slide_edit_mode_required",
+        },
+      );
     }
     if (inputModeCount > 1) {
       fail(
-        "Use exactly one input mode: --edits, --find/--replace, or --fullContent; do not combine modes",
+        "Use exactly one input mode: --edits, --find/--replace, --objectId/--replace, or --fullContent; do not combine modes",
         { errorCode: "slide_edit_modes_conflict" },
       );
     }
     if (styleOnly && !edits) {
       fail(
-        "Style-only slide edits require --edits and cannot use --fullContent or legacy find/replace",
+        "Style-only slide edits require --edits and cannot use --fullContent or legacy find/replace/objectId",
         { errorCode: "style_only_slide_edits_required" },
       );
     }
-    if (replace !== undefined && find === undefined) {
+    if (objectId !== undefined && find !== undefined) {
+      fail("Use either --find or --objectId for a legacy text edit, not both", {
+        errorCode: "slide_find_object_id_conflict",
+      });
+    }
+    if (objectId !== undefined && replace === undefined) {
+      fail(
+        "Legacy --objectId requires --replace; pass an empty string explicitly to clear the element",
+        { errorCode: "slide_object_id_replace_required" },
+      );
+    }
+    if (find !== undefined && replace === undefined) {
+      fail(
+        "Legacy --find requires --replace; pass an empty string explicitly to clear the match",
+        { errorCode: "slide_find_replace_required" },
+      );
+    }
+    if (replace !== undefined && find === undefined && objectId === undefined) {
       fail("Legacy --replace requires --find", {
         errorCode: "slide_replace_requires_find",
       });
@@ -568,6 +630,21 @@ export default defineAction({
         applied = patched.changed;
         editResults = patched.applied;
         if (!applied) slide.content = previousContent;
+      } else if (objectId !== undefined) {
+        const sourceContent = format
+          ? await formatSlideHtml(previousContent)
+          : previousContent;
+        const patched = await applySlideContentEdits(
+          sourceContent,
+          [{ objectId, replace: replace! }],
+          format,
+        );
+        const nextContent = normalizeSlidePadding(patched.content);
+        validateNextContent(nextContent);
+        slide.content = nextContent;
+        applied = patched.changed;
+        editResults = patched.applied;
+        if (!applied) slide.content = previousContent;
       } else if (find !== undefined) {
         const idx = previousContent.indexOf(find);
         if (idx === -1) {
@@ -817,7 +894,7 @@ export default defineAction({
     });
 
     console.log(
-      `update-slide: deck=${deckId} slide=${slideId} ${edits ? `edits=${edits.length}` : find !== undefined ? `find="${find.slice(0, 40)}"` : "fullContent"} applied=${applied}`,
+      `update-slide: deck=${deckId} slide=${slideId} ${edits ? `edits=${edits.length}` : objectId !== undefined ? `objectId="${objectId}"` : find !== undefined ? `find="${find.slice(0, 40)}"` : "fullContent"} applied=${applied}`,
     );
 
     const base = {

package/corpus/templates/slides/actions/view-screen.ts

@@ -96,7 +96,7 @@ function getCurrentSlideFitMeasurement(
 export default defineAction({
   title: "Inspect current Slides screen",
   description:
-    "Inspect the current Slides editor context when the active deck, slide, or selection is unknown. Returns the current deck and slide IDs, slide previews, current slide HTML, and matching visual selection metadata (or the deck list on the home page). For a short exact selectedText browser-range edit, use this result directly with one update-slide literal replacement and expectedMatches=1; do not load the full deck for that path.",
+    "Inspect the current Slides editor context when the active deck, slide, or selection is unknown. Returns the current deck and slide IDs, slide previews, current slide HTML, and matching visual selection metadata (or the deck list on the home page). For a short exact selectedText browser-range edit, use this result directly with one update-slide literal replacement and expectedMatches=1. When a selected element has an objectId but no exact selectedText, use that objectId with one update-slide replace edit to change only its inner content; do not load the full deck for either focused path.",
   schema: z.object({}),
   http: false,
   run: async (_args) => {
@@ -304,14 +304,26 @@ export default defineAction({
               ? `   (matches currentSlideId)`
               : `   (differs from currentSlideId ${currentSlide?.id ?? "(none)"} — use selectionSlideId, the slide this selection was made on)`),
         );
+        if (selectionSlide.id !== currentSlide?.id) {
+          lines.push(
+            `selectionSlideContentHash: ${hashSlideContent(String(selectionSlide.content ?? ""))}   ← use as baseContentHash with selectionSlideId`,
+          );
+        }
         lines.push(`mode: ${selection.mode ?? "unknown"}`);
         lines.push(`activeTool: ${selection.activeTool ?? "select"}`);
         if (Array.isArray(selection.items) && selection.items.length > 0) {
           for (const [index, item] of selection.items.entries()) {
+            const isImageSelection =
+              item.kind === "image" || item.tagName?.toLowerCase() === "img";
             lines.push(
               `selected ${index + 1}: ${item.kind ?? "element"} ${item.tagName ?? ""} selector=${item.selector ?? "(none)"}`,
             );
-            if (item.objectId) lines.push(`objectId: ${item.objectId}`);
+            if (item.objectId && !isImageSelection) {
+              lines.push(`objectId: ${item.objectId}`);
+              lines.push(
+                "objectIdStatus: stable selected-element target; use it with one update-slide replace edit when selectedText is unavailable",
+              );
+            }
             if (item.runtimeSelector) {
               lines.push(`runtimeSelector: ${item.runtimeSelector}`);
             }
@@ -321,15 +333,21 @@ export default defineAction({
                 "selectedTextStatus: exact browser range; use verbatim as edits.find with expectedMatches: 1",
               );
             }
-            if (item.text) {
+            if (isImageSelection) {
+              lines.push(
+                "imageStatus: image selection has no editable text content; use the targeted image/markup workflow",
+              );
+            } else if (item.text) {
               lines.push(`text: ${item.text}`);
               if (!item.selectedText) {
                 lines.push(
-                  item.textTruncated === true
-                    ? `textStatus: element preview may be truncated; use get-deck with slideId=${selectionSlide.id} before editing`
-                    : item.textTruncated === false
-                      ? `textStatus: element text is complete but is not an exact browser-range selection; use get-deck with slideId=${selectionSlide.id} before editing`
-                      : `textStatus: element preview status unknown; use get-deck with slideId=${selectionSlide.id} before editing`,
+                  item.objectId
+                    ? "textStatus: element preview is not an exact browser-range selection; use objectId with update-slide for an element-only replacement"
+                    : item.textTruncated === true
+                      ? `textStatus: element preview may be truncated; use get-deck with slideId=${selectionSlide.id} before editing`
+                      : item.textTruncated === false
+                        ? `textStatus: element text is complete but is not an exact browser-range selection; use get-deck with slideId=${selectionSlide.id} before editing`
+                        : `textStatus: element preview status unknown; use get-deck with slideId=${selectionSlide.id} before editing`,
                 );
               } else {
                 lines.push(

package/corpus/templates/slides/server/lib/slide-content-patch.ts

@@ -10,7 +10,8 @@ import {
 export type SlideContentEdit =
   | {
       op?: "replace";
-      find: string;
+      find?: string;
+      objectId?: string;
       replace: string;
       all?: boolean;
       occurrence?: number;
@@ -167,6 +168,25 @@ function applyLiteralReplace(
   content: string,
   edit: Extract<SlideContentEdit, { op?: "replace" }>,
 ): { content: string; summary: string } {
+  if (edit.objectId !== undefined) {
+    if (edit.find !== undefined) {
+      throw new SlideContentEditError(
+        "A replace edit must use either find or objectId, not both",
+      );
+    }
+    if (edit.all !== undefined || edit.occurrence !== undefined) {
+      throw new SlideContentEditError(
+        "objectId replacement does not support all or occurrence",
+      );
+    }
+    if (edit.expectedMatches !== undefined && edit.expectedMatches !== 1) {
+      throw new SlideContentEditError(
+        `objectId replacement expected 1 match(es), found ${edit.expectedMatches}`,
+      );
+    }
+    return applyObjectReplace(content, edit.objectId, edit.replace);
+  }
+
   if (!edit.find) {
     throw new SlideContentEditError("Patch find/marker text cannot be empty");
   }
@@ -201,6 +221,270 @@ function applyLiteralReplace(
   return { content: result.content, summary };
 }
 
+const RAW_TEXT_TAG_NAMES = new Set(["script", "style", "textarea", "title"]);
+const VOID_TAG_NAMES = new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr",
+]);
+
+function applyObjectReplace(
+  content: string,
+  objectId: string,
+  replacement: string,
+): { content: string; summary: string } {
+  const targets = findObjectTargets(content, objectId);
+  if (targets.length === 0) {
+    throw new SlideContentEditError(
+      `objectId "${objectId}" found no matching slide object`,
+    );
+  }
+  if (targets.length > 1) {
+    throw new SlideContentEditError(
+      `objectId "${objectId}" matched ${targets.length} slide objects; object IDs must be unique`,
+    );
+  }
+
+  const target = targets[0]!;
+  if (target.isVoid) {
+    throw new SlideContentEditError(
+      `objectId "${objectId}" targets <${target.tagName}>, which has no editable text content`,
+    );
+  }
+  return {
+    content:
+      content.slice(0, target.innerStart) +
+      replacement +
+      content.slice(target.innerEnd),
+    summary: "replace:object",
+  };
+}
+
+function findObjectTargets(
+  html: string,
+  objectId: string,
+): Array<{
+  innerStart: number;
+  innerEnd: number;
+  tagName: string;
+  isVoid: boolean;
+}> {
+  const targets: Array<{
+    innerStart: number;
+    innerEnd: number;
+    tagName: string;
+    isVoid: boolean;
+  }> = [];
+  let cursor = 0;
+
+  while (cursor < html.length) {
+    const tagStart = html.indexOf("<", cursor);
+    if (tagStart === -1) break;
+    if (html.startsWith("<!--", tagStart)) {
+      const commentEnd = html.indexOf("-->", tagStart + 4);
+      cursor = commentEnd === -1 ? html.length : commentEnd + 3;
+      continue;
+    }
+
+    const nameStart = tagStart + 1;
+    const tagName = tagNameAt(html, nameStart);
+    if (!tagName) {
+      cursor = tagStart + 1;
+      continue;
+    }
+    const tagEnd = tagEndIndex(html, nameStart + tagName.length);
+    if (tagEnd === -1) {
+      throw new SlideContentEditError(
+        `objectId "${objectId}" cannot be resolved because the slide HTML has an unclosed tag`,
+      );
+    }
+    const openingTag = html.slice(tagStart, tagEnd + 1);
+    if (hasObjectId(openingTag, objectId)) {
+      const isVoid = isVoidTag(tagName);
+      if (isVoid) {
+        targets.push({
+          innerStart: tagEnd + 1,
+          innerEnd: tagEnd + 1,
+          tagName,
+          isVoid,
+        });
+      } else {
+        const closing = findMatchingCloseTag(html, tagName, tagEnd + 1);
+        if (!closing) {
+          throw new SlideContentEditError(
+            `objectId "${objectId}" targets <${tagName}> without a closing tag`,
+          );
+        }
+        targets.push({
+          innerStart: tagEnd + 1,
+          innerEnd: closing.start,
+          tagName,
+          isVoid,
+        });
+      }
+    }
+
+    if (RAW_TEXT_TAG_NAMES.has(tagName) && !isVoidTag(tagName)) {
+      const rawClose = rawTextCloseIndex(html, tagName, tagEnd + 1);
+      cursor = rawClose === -1 ? html.length : rawClose + tagName.length + 3;
+    } else {
+      cursor = tagEnd + 1;
+    }
+  }
+
+  return targets;
+}
+
+function hasObjectId(tag: string, objectId: string): boolean {
+  const tagName = /^<[A-Za-z][\w:-]*/.exec(tag)?.[0];
+  if (!tagName) return false;
+
+  let cursor = tagName.length;
+  while (cursor < tag.length) {
+    while (/\s/.test(tag[cursor] ?? "")) cursor += 1;
+    if (tag[cursor] === "/" || tag[cursor] === ">") break;
+
+    const attributeStart = cursor;
+    while (cursor < tag.length && !/[\s=>/]/.test(tag[cursor] ?? "")) {
+      cursor += 1;
+    }
+    const attributeName = tag.slice(attributeStart, cursor).toLowerCase();
+    while (/\s/.test(tag[cursor] ?? "")) cursor += 1;
+    if (tag[cursor] !== "=") {
+      while (cursor < tag.length && !/[\s>]/.test(tag[cursor] ?? "")) {
+        cursor += 1;
+      }
+      continue;
+    }
+
+    cursor += 1;
+    while (/\s/.test(tag[cursor] ?? "")) cursor += 1;
+    const quote =
+      tag[cursor] === '"' || tag[cursor] === "'" ? tag[cursor] : null;
+    if (quote) cursor += 1;
+    const valueStart = cursor;
+    if (quote) {
+      while (cursor < tag.length && tag[cursor] !== quote) cursor += 1;
+    } else {
+      while (cursor < tag.length && !/[\s>]/.test(tag[cursor] ?? "")) {
+        cursor += 1;
+      }
+    }
+    const value = tag.slice(valueStart, cursor);
+    if (quote && tag[cursor] === quote) cursor += 1;
+    if (attributeName === "data-slide-object-id" && value === objectId) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+function findMatchingCloseTag(
+  html: string,
+  tagName: string,
+  start: number,
+): { start: number; end: number } | null {
+  if (RAW_TEXT_TAG_NAMES.has(tagName)) {
+    const rawClose = rawTextCloseIndex(html, tagName, start);
+    return rawClose === -1
+      ? null
+      : { start: rawClose, end: rawClose + tagName.length + 3 };
+  }
+
+  let depth = 1;
+  let cursor = start;
+  while (cursor < html.length) {
+    const tagStart = html.indexOf("<", cursor);
+    if (tagStart === -1) break;
+    if (html.startsWith("<!--", tagStart)) {
+      const commentEnd = html.indexOf("-->", tagStart + 4);
+      cursor = commentEnd === -1 ? html.length : commentEnd + 3;
+      continue;
+    }
+
+    const closing = html[tagStart + 1] === "/";
+    const nameStart = tagStart + (closing ? 2 : 1);
+    const nestedTagName = tagNameAt(html, nameStart);
+    if (!nestedTagName) {
+      cursor = tagStart + 1;
+      continue;
+    }
+    const tagEnd = tagEndIndex(html, nameStart + nestedTagName.length);
+    if (tagEnd === -1) return null;
+
+    if (closing && nestedTagName === tagName) {
+      depth -= 1;
+      if (depth === 0) {
+        return { start: tagStart, end: tagEnd + 1 };
+      }
+    } else if (
+      !closing &&
+      nestedTagName === tagName &&
+      !isVoidTag(nestedTagName)
+    ) {
+      depth += 1;
+    }
+
+    if (!closing && RAW_TEXT_TAG_NAMES.has(nestedTagName)) {
+      const rawClose = rawTextCloseIndex(html, nestedTagName, tagEnd + 1);
+      cursor =
+        rawClose === -1 ? html.length : rawClose + nestedTagName.length + 3;
+    } else {
+      cursor = tagEnd + 1;
+    }
+  }
+
+  return null;
+}
+
+function isVoidTag(tagName: string): boolean {
+  return VOID_TAG_NAMES.has(tagName);
+}
+
+function tagEndIndex(html: string, start: number): number {
+  let quote: '"' | "'" | null = null;
+  for (let index = start; index < html.length; index += 1) {
+    const character = html[index];
+    if (quote) {
+      if (character === quote) quote = null;
+      continue;
+    }
+    if (character === '"' || character === "'") {
+      quote = character;
+      continue;
+    }
+    if (character === ">") return index;
+  }
+  return -1;
+}
+
+function tagNameAt(html: string, start: number): string | null {
+  const match = /^[A-Za-z][\w:-]*/.exec(html.slice(start));
+  return match?.[0]?.toLowerCase() ?? null;
+}
+
+function rawTextCloseIndex(
+  html: string,
+  tagName: string,
+  start: number,
+): number {
+  const pattern = new RegExp(`<\\/${tagName}\\s*>`, "gi");
+  pattern.lastIndex = start;
+  return pattern.exec(html)?.index ?? -1;
+}
+
 function applyInsert(
   content: string,
   edit: Extract<SlideContentEdit, { op: "insert-before" | "insert-after" }>,

package/corpus/templates/slides/server/plugins/agent-chat.ts

@@ -153,7 +153,8 @@ export default createAgentChatPlugin({
   mcp: {
     connectorCatalog: EXTERNAL_CONNECTOR_TOOL_NAMES,
     instructions:
-      'Design system: every deck read (get-deck, view-screen, get-workspace-defaults, get-deck-reference-context) returns `designSystem` — a bounded summary with scope "summary" and a `next` line — and get-deck also returns `deckStyle` plus `representativeSlideId`. Before the first slide you author in a deck, call get-design-system { id } once for the full tokens, assets, docs, and custom instructions (create-deck already returns it in full); reuse it for every later slide instead of re-reading it. Apply designSystem.agentContext and deckStyle before authoring or restyling. If designSystem.status is "unavailable", follow its message; never invent a generic style. For a new deck, pass the exact title as `designSystem` or a designSystemId; omit both to get the caller\'s personal default, then the workspace default. When view-screen returns an exact selectedText range, edit immediately with one update-slide literal edits replacement and expectedMatches=1, passing currentSlideContentHash as baseContentHash; do not load the full deck for that path. Use targeted get-deck with slideId only for ambiguous, truncated, or structural text. Use patch-deck for slide deletion, reordering, deck-wide, or multi-slide changes, and delete-deck to remove a deck. Read back the same slide after writing; a delegated ask_app response is unverified until that readback confirms it.',
+      "Cross-slide selection rule: when view-screen returns selectionSlideId different from currentSlideId, use selectionSlideId and selectionSlideContentHash for the update; never pair a selectionSlideId with currentSlideContentHash. " +
+      'Design system: every deck read (get-deck, view-screen, get-workspace-defaults, get-deck-reference-context) returns `designSystem` — a bounded summary with scope "summary" and a `next` line — and get-deck also returns `deckStyle` plus `representativeSlideId`. Before the first slide you author in a deck, call get-design-system { id } once for the full tokens, assets, docs, and custom instructions (create-deck already returns it in full); reuse it for every later slide instead of re-reading it. Apply designSystem.agentContext and deckStyle before authoring or restyling. If designSystem.status is "unavailable", follow its message; never invent a generic style. For a new deck, pass the exact title as `designSystem` or a designSystemId; omit both to get the caller\'s personal default, then the workspace default. When view-screen returns an exact selectedText range, edit immediately with one update-slide literal edits replacement and expectedMatches=1, passing currentSlideContentHash as baseContentHash when available; when it returns a stable objectId without exact selectedText, use one update-slide replace edit with that objectId and the same hash when available instead of fetching the full deck. Use targeted get-deck with slideId only for ambiguous, truncated, or structural text. Use patch-deck for slide deletion, reordering, deck-wide, or multi-slide changes, and delete-deck to remove a deck. Read back the same slide after writing; a delegated ask_app response is unverified until that readback confirms it.',
   },
   externalAgents: { writes: "allowlisted" },
   durableBackgroundRuns: true,
@@ -196,15 +197,20 @@ When a request includes a public URL as source material, fetch it with web-reque
 When the user asks to improve, beautify, restyle, or make an uploaded/existing deck on-brand, treat it as an in-place source-preserving edit unless the user explicitly asks to rewrite the story or change slide count. First call view-screen when the active deck is unclear, then get-deck with compact=true for deck orientation. If you need slide markup, call get-deck with compact=false explicitly and only when the edit requires the full HTML. If get-deck.sourceImport exists, preserve its slide count, order, IDs, factual copy, notes, images, charts, tables, diagrams, freeform objects, and source aspect ratio. The ordered source manifest is sourceImport.slideIds. For a deck-wide restyle, use one patch-deck call with requireAllSourceSlides=true and one patch-slide operation with fields.content for every source slide ID; the action rejects partial coverage. Do not split a full-deck restyle into arbitrary batches or use one-by-one update-slide calls - reserve update-slide for targeted one-slide edits. After the patch succeeds, verify with get-deck using compact=true so the verification does not retransmit every slide's HTML. Completion requires sourceCoverage.complete=true with expectedSlideIds and actualSlideIds matching in order. Do not claim a partial or initial pass. Do not use add-slide, delete, reorder, or replace source imagery with generic cards for this workflow. If sourceImport.fidelity is partial or imagesSkipped is nonzero, stop and report the exact fidelity warning instead of claiming a reliable improvement.
 For a focused text edit or translation of the current selection, treat the
 selection as the target. If view-screen or the request context provides
-deckId, currentSlideId, and exact selectedText from a browser range, call
-update-slide immediately with one literal edits replace using that exact text
-and expectedMatches=1;
-pass currentSlideContentHash as baseContentHash when available. Do not call
+deckId, a selectionSlideId when present, and exact selectedText from a browser
+range, call update-slide immediately with one literal edits replace using that
+exact text and expectedMatches=1; use selectionSlideId as slideId when it is
+present. Pass selectionSlideContentHash as baseContentHash when the selection
+slide differs from currentSlideId; otherwise pass currentSlideContentHash when
+available. Never pair a selectionSlideId with the current slide's hash. Do not call
 get-deck without slideId, enumerate the deck, or request full HTML for this
 path. If no exact selectedText range is available, the value is an element
-preview or truncated, the literal match fails, or the request changes markup
-or layout, call get-deck
-with slideId only. First classify the remaining request scope. For a
+preview or truncated, call update-slide with the supplied objectId and the
+selectionSlideId when present, passing selectionSlideContentHash when it differs
+from currentSlideId or currentSlideContentHash otherwise. When the literal
+match fails or the request changes markup or layout, call get-deck with slideId
+only. First classify the
+remaining request scope. For a
 styling-only request, set styleOnly=true, change only the requested CSS
 declarations on the identified elements, and preserve text, element order,
 padding, margin, gap, font-size, line-height, dimensions, positioning, and

package/dist/automation/index.d.ts

@@ -186,8 +186,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
+    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
-    error?: undefined;
 }>;

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/notifications/routes.d.ts

@@ -13,13 +13,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;

package/dist/observability/routes.d.ts

@@ -43,21 +43,21 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
 } | {
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
-    ok?: undefined;
     error?: undefined;
     id?: undefined;
+    ok?: undefined;
 } | {
     summary?: undefined;
     spans?: undefined;
     id: string;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     summary?: undefined;
     spans?: undefined;
     error: any;
-    ok?: undefined;
     id?: undefined;
+    ok?: undefined;
 } | {
     summary?: undefined;
     spans?: undefined;

package/dist/server/agent-engine-api-key-route.d.ts

@@ -34,10 +34,10 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};

package/docs/content/getting-started.mdx

@@ -7,6 +7,11 @@ description: "Create an agent with a chat UI and call the same action from the a
 
 <GettingStartedPaths />
 
+Agent-Native is an open-source TypeScript framework for building autonomous
+agents with intuitive UIs. You define each capability once as an
+[action](/docs/actions-overview)—a typed function the agent uses as a tool and
+the UI calls from code.
+
 In this guide, you'll create an agent with a chat UI and call its included
 `hello` action from the agent and the UI.
 

package/docs/content/what-is-agent-native.mdx

@@ -1,6 +1,6 @@
 ---
 title: "What is Agent-Native?"
-description: "What Agent-Native is, how its shared action architecture works, and when to build an app this way."
+description: "What Agent-Native is, why agents need UIs, how its shared action architecture works, and when to use it."
 ---
 
 # What is Agent-Native?
@@ -81,7 +81,7 @@ the same work.
 
 ### [Getting Started](/docs/getting-started)
 
-Create an app and call the same action from the agent and UI.
+Create an agent with a UI and call the same action from the agent and UI.
 
 ### [Key Concepts](/docs/key-concepts)
 
@@ -90,11 +90,11 @@ together.
 
 ### [Agent Surfaces](/docs/agent-surfaces)
 
-See how the same model supports apps led by a UI, chat, automation, or another
-agent.
+See how agents work through a UI, chat, automation, or another agent.
 
 ### [Templates](/docs/cloneable-saas)
 
-Start from a complete SaaS product instead of building up from Chat.
+Start from a complete open-source agent with a UI instead of starting from
+scratch.
 
 </Cards>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.177.1-nightly-20260908183718",
+  "version": "0.177.1",
   "description": "The agentic application framework for building autonomous agents with intuitive UIs",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -439,8 +439,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.32",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.26",
-    "@agent-native/toolkit": "^0.19.4"
+    "@agent-native/recap-cli": "0.5.27",
+    "@agent-native/toolkit": "^0.19.5"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",