@agent-native/core 0.130.1 → 0.131.2

package/corpus/templates/slides/actions/export-pptx.ts

@@ -108,18 +108,39 @@ interface ImageElement {
   h: number;
 }
 
+export function assertServerPptxExportable(
+  html: string,
+  slideNumber: number,
+): void {
+  // Absolute positioning alone is not an editing-object contract: uploaded
+  // backgrounds are intentionally absolute but the normal-flow exporter can
+  // still include them. Only reject objects persisted by the freeform editor.
+  const hasPersistedFreeformObject =
+    /\bdata-slide-object-id\s*=/i.test(html) ||
+    /\bclass\s*=\s*["'][^"']*\bfmd-freeform-object\b/i.test(html);
+  if (!hasPersistedFreeformObject) return;
+
+  const error = new Error(
+    `Slide ${slideNumber} contains freeform positioned objects. Export this deck from the Slides editor with Export > PowerPoint so browser-rendered geometry is preserved. The server export stopped instead of silently reflowing those objects.`,
+  );
+  error.name = "UnsupportedPositionedSlideExportError";
+  throw error;
+}
+
 /**
  * Parse slide HTML and extract text/image elements with positioning.
  * We know the exact HTML structure from the slide templates.
  */
-function parseSlideHtml(
+export function parseSlideHtml(
   html: string,
   aspectRatio?: AspectRatio,
+  slideNumber = 1,
 ): {
   texts: TextElement[];
   images: ImageElement[];
   bgColor: string;
 } {
+  assertServerPptxExportable(html, slideNumber);
   const texts: TextElement[] = [];
   const images: ImageElement[] = [];
   let bgColor = "000000";
@@ -335,7 +356,7 @@ export async function fetchImageAsBase64(url: string): Promise<string | null> {
 
 export default defineAction({
   description:
-    "Export a deck as a PowerPoint (.pptx) file. Returns a download URL for the generated file.",
+    "Export a normal-flow deck as a PowerPoint (.pptx) file. Decks with freeform positioned objects must use the Slides editor's Export > PowerPoint flow so browser-rendered geometry is preserved. Returns a download URL for the generated file.",
   schema: z.object({
     deckId: z.string().describe("Deck ID to export"),
     includeNotes: z
@@ -382,7 +403,7 @@ export default defineAction({
     pptx.author = "Agent Native Slides";
     pptx.title = row.title;
 
-    for (const slide of slides) {
+    for (const [slideIndex, slide] of slides.entries()) {
       const pptxSlide = pptx.addSlide();
       const slideContent =
         slide && typeof slide === "object" && typeof slide.content === "string"
@@ -391,6 +412,7 @@ export default defineAction({
       const { texts, images, bgColor } = parseSlideHtml(
         slideContent,
         aspectRatio,
+        slideIndex + 1,
       );
 
       pptxSlide.background = { color: bgColor };

package/corpus/templates/slides/actions/generate-image-api.ts

@@ -28,13 +28,15 @@ async function urlToReferenceImage(
 
 export default defineAction({
   description:
-    "Generate an image using Gemini or OpenAI with optional reference images for style matching.",
+    "Generate an image via a connected Builder.io account, or Gemini/OpenAI, with optional reference images for style matching.",
   schema: z.object({
     prompt: z.string().optional().describe("Image description (required)"),
     model: z
       .string()
       .optional()
-      .describe("Provider: 'gemini', 'openai', or 'auto' (default: auto)"),
+      .describe(
+        "Provider: 'builder', 'gemini', 'openai', or 'auto' (default: auto, which prefers a connected Builder.io account, then gemini, then openai)",
+      ),
   }),
   run: async (args) => {
     const prompt = args.prompt;

package/corpus/templates/slides/actions/generate-slides-ai.ts

@@ -5,7 +5,7 @@ import { z } from "zod";
 
 export default defineAction({
   description:
-    "Legacy helper for the Generate Slides dialog. It returns markdown slide drafts, not the app's rendered slide HTML. Agent chat should create decks with create-deck slides: [] plus add-slide HTML instead of this action.",
+    "Legacy helper for the Generate Slides dialog that drafts a whole new deck outline (multiple slides) from a topic. It returns markdown slide drafts, not the app's rendered slide HTML. Agent chat should create decks with create-deck slides: [] plus add-slide HTML instead of this action. Do NOT use this for a request to generate one or more images/image variations for an existing slide — use generate-image-api for that; this action requires its own GEMINI_API_KEY and has no Builder-managed fallback.",
   schema: z.object({
     topic: z.string().describe("Presentation topic"),
     slideCount: z.coerce

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

@@ -0,0 +1,136 @@
+import { defineAction } from "@agent-native/core";
+import { resolveAccess } from "@agent-native/core/sharing";
+import { z } from "zod";
+
+import "../server/db/index.js"; // ensure registerShareableResource runs
+
+const MAX_CONTEXT_CHARS = 14_000;
+const MAX_PATTERNS = 6;
+const MAX_SLIDE_HTML_CHARS = 2_000;
+
+interface ReferenceSlide {
+  id?: string;
+  content?: string;
+  notes?: string;
+  layout?: string;
+}
+
+function truncate(value: string, maxChars: number): string {
+  if (value.length <= maxChars) return value;
+  return `${value.slice(0, maxChars).trimEnd()}\n[truncated]`;
+}
+
+export function pickLayoutPatterns(
+  slides: ReferenceSlide[],
+  limit = MAX_PATTERNS,
+): Array<{ layout: string; slide: ReferenceSlide }> {
+  const patterns: Array<{ layout: string; slide: ReferenceSlide }> = [];
+  const seenLayouts = new Set<string>();
+  for (const slide of slides) {
+    if (patterns.length >= limit) break;
+    const layout = slide.layout ?? "unknown";
+    if (seenLayouts.has(layout)) continue;
+    seenLayouts.add(layout);
+    patterns.push({ layout, slide });
+  }
+  return patterns;
+}
+
+export function buildReferenceDeckContext({
+  id,
+  title,
+  aspectRatio,
+  designSystemId,
+  slides,
+}: {
+  id: string;
+  title: string;
+  aspectRatio: string | null;
+  designSystemId: string | null;
+  slides: ReferenceSlide[];
+}): string {
+  const lines: string[] = [
+    "## Reference Deck — Visual Language",
+    `The user picked "${title}" (deck id: ${id}) as a style reference.`,
+    "",
+    "This is a pattern library, NOT an outline. It shows how this deck's visual language renders a kind of content — how a heading is set, how supporting text sits under it, how a split or a callout is balanced.",
+    "",
+    "How to use it:",
+    "- Plan the new deck from the user's request first. Decide the story, the slide count, and the order before you look at these patterns.",
+    "- Then, for each slide you have decided to write, reach for the pattern that fits that content. Skip patterns that fit nothing.",
+    "- Use a pattern once, many times, or not at all. Frequency and sequence come from the new content, never from the reference.",
+    "- Do not reproduce the reference deck's slide order, slide count, or section structure.",
+    "- When no pattern fits, compose a new slide from the same type scale, spacing, color, and markup conventions instead of forcing content into the nearest pattern.",
+    "- Take no wording, data, imagery, or subject matter from the reference deck.",
+    "",
+    `Aspect ratio: ${aspectRatio ?? "16:9 (default)"}`,
+    designSystemId
+      ? `Linked design system id: ${designSystemId}`
+      : "No design system linked to the reference deck.",
+  ];
+
+  const patterns = pickLayoutPatterns(slides);
+  if (patterns.length > 0) {
+    lines.push(
+      "",
+      "### Patterns",
+      "Each block below is one worked example of a layout. Match its HTML structure, class usage, and inline style conventions; replace every word of its content.",
+    );
+    for (const { layout, slide } of patterns) {
+      lines.push(
+        "",
+        `#### Pattern: ${layout}`,
+        "```html",
+        truncate(slide.content ?? "", MAX_SLIDE_HTML_CHARS),
+        "```",
+      );
+    }
+  }
+
+  lines.push(
+    "",
+    `These are samples, not the full deck. Call \`get-deck --id ${id}\` if you need to see how this deck handles a case the patterns above do not cover.`,
+  );
+
+  return truncate(lines.join("\n"), MAX_CONTEXT_CHARS);
+}
+
+export default defineAction({
+  description:
+    "Get an existing deck's visual language as a reusable pattern library so a new deck can be written in the same style. " +
+    "Returns one worked HTML example per layout as `agentContext`, deliberately without the deck's slide order — the new deck's structure comes from its own content. " +
+    "Use `get-deck` when you need a specific slide's full content instead.",
+  schema: z.object({
+    id: z.string().describe("Deck ID to use as the reference"),
+  }),
+  readOnly: true,
+  http: { method: "GET" },
+  run: async ({ id }) => {
+    const access = await resolveAccess("deck", id);
+    if (!access) {
+      throw Object.assign(new Error("Deck not found"), { statusCode: 404 });
+    }
+
+    const row = access.resource;
+    const data = JSON.parse(row.data);
+    const slides: ReferenceSlide[] = Array.isArray(data?.slides)
+      ? data.slides
+      : [];
+    const title = row.title || data?.title || "Untitled Deck";
+
+    return {
+      id: row.id,
+      title,
+      slideCount: slides.length,
+      aspectRatio: data?.aspectRatio ?? null,
+      designSystemId: row.designSystemId ?? null,
+      agentContext: buildReferenceDeckContext({
+        id: row.id,
+        title,
+        aspectRatio: data?.aspectRatio ?? null,
+        designSystemId: row.designSystemId ?? null,
+        slides,
+      }),
+    };
+  },
+});

package/corpus/templates/slides/actions/get-workspace-defaults.ts

@@ -0,0 +1,55 @@
+import { defineAction } from "@agent-native/core";
+import { resolveAccess } from "@agent-native/core/sharing";
+import { z } from "zod";
+
+import {
+  canManageWorkspaceDefaults,
+  getWorkspaceDefaults,
+} from "../server/workspace-defaults.js";
+
+/**
+ * `unavailable` is not `null`. A default the caller cannot open means an admin
+ * pointed at something private; collapsing that into "no default" hides the
+ * misconfiguration from the only people who can fix it.
+ */
+type DefaultRef =
+  | { id: string; title: string; unavailable?: false }
+  | { id: string; title: null; unavailable: true }
+  | null;
+
+export default defineAction({
+  description:
+    "Read the workspace-wide brand defaults: the default reference deck and design system new decks start from when the user has not picked their own. " +
+    "Call this before generating a deck from a bare prompt so the result is on brand.",
+  schema: z.object({}),
+  readOnly: true,
+  http: { method: "GET" },
+  run: async () => {
+    const defaults = await getWorkspaceDefaults();
+
+    let referenceDeck: DefaultRef = null;
+    if (defaults.referenceDeckId) {
+      const access = await resolveAccess("deck", defaults.referenceDeckId);
+      referenceDeck = access
+        ? { id: defaults.referenceDeckId, title: access.resource.title }
+        : { id: defaults.referenceDeckId, title: null, unavailable: true };
+    }
+
+    let designSystem: DefaultRef = null;
+    if (defaults.designSystemId) {
+      const access = await resolveAccess(
+        "design-system",
+        defaults.designSystemId,
+      );
+      designSystem = access
+        ? { id: defaults.designSystemId, title: access.resource.title }
+        : { id: defaults.designSystemId, title: null, unavailable: true };
+    }
+
+    return {
+      referenceDeck,
+      designSystem,
+      canManage: await canManageWorkspaceDefaults(),
+    };
+  },
+});

package/corpus/templates/slides/actions/image-gen-status.ts

@@ -1,5 +1,8 @@
 import { defineAction } from "@agent-native/core";
-import { resolveSecret } from "@agent-native/core/server";
+import {
+  resolveBuilderCredentials,
+  resolveSecret,
+} from "@agent-native/core/server";
 import { z } from "zod";
 
 export default defineAction({
@@ -11,6 +14,11 @@ export default defineAction({
     const { getConfiguredProviders } =
       await import("../server/handlers/image-providers/index.js");
     const configured = await getConfiguredProviders();
+    const builderCreds = await resolveBuilderCredentials();
+    const builderStatus =
+      builderCreds.privateKey && builderCreds.publicKey
+        ? "Configured"
+        : "Not connected";
     const geminiStatus = (await resolveSecret("GEMINI_API_KEY"))
       ? "Configured"
       : "Not configured";
@@ -24,6 +32,7 @@ export default defineAction({
 
     return `Image Generation Status:
 ========================
+Builder.io: ${builderStatus}
 Gemini: ${geminiStatus}
 OpenAI: ${openaiStatus}
 ${autoProvider}

package/corpus/templates/slides/actions/import-file.ts

@@ -23,6 +23,7 @@ import {
   type AspectRatio,
 } from "../shared/aspect-ratios.js";
 import { readUserUploadedFile } from "./_uploaded-files.js";
+import { withDeckLock } from "./patch-deck.js";
 
 const DEFAULT_MAX_SOURCE_CHARS = 60_000;
 
@@ -52,7 +53,7 @@ export default defineAction({
       .optional()
       .default(false)
       .describe(
-        "If true, replace deckId's slides with slides converted from the file.",
+        "If true, append slides converted from the file to the end of deckId's existing slides.",
       ),
     maxChars: z.coerce
       .number()
@@ -150,7 +151,7 @@ export default defineAction({
           (total, r) => total + r.imageSkippedCount,
           0,
         );
-        await replaceDeckSlides(deckId, title, slides, "import-file:pptx");
+        await appendDeckSlides(deckId, title, slides, "import-file:pptx");
         return {
           format: "pptx",
           title,
@@ -200,7 +201,7 @@ export default defineAction({
           layout: "content",
           notes: "",
         }));
-        await replaceDeckSlides(deckId, title, slides, "import-file:docx");
+        await appendDeckSlides(deckId, title, slides, "import-file:docx");
         return {
           format: "docx",
           title,
@@ -278,7 +279,7 @@ export default defineAction({
           layout: "content",
           notes: "",
         }));
-        await replaceDeckSlides(deckId, title, slides, "import-file:pdf");
+        await appendDeckSlides(deckId, title, slides, "import-file:pdf");
         return {
           format: "pdf",
           title,
@@ -440,13 +441,7 @@ async function importPdfPagesAsFullBleedSlides(args: {
     }),
   );
 
-  await replaceDeckSlides(
-    deckId,
-    title,
-    slides,
-    "import-file:pdf",
-    aspectRatio,
-  );
+  await appendDeckSlides(deckId, title, slides, "import-file:pdf", aspectRatio);
 
   return {
     format: "pdf",
@@ -600,7 +595,7 @@ function summarizeSections(sections: { heading: string; content: string }[]) {
   });
 }
 
-async function replaceDeckSlides(
+async function appendDeckSlides(
   deckId: string,
   title: string,
   slides: Array<{
@@ -614,35 +609,55 @@ async function replaceDeckSlides(
 ) {
   await assertAccess("deck", deckId, "editor");
 
-  const db = getDb();
-  const existing = await db
-    .select()
-    .from(schema.decks)
-    .where(eq(schema.decks.id, deckId))
-    .limit(1);
+  // Read-modify-write under the shared per-deck lock used by patch-deck /
+  // add-slide / update-slide. Without it, an import running concurrently
+  // with another import or an editor/agent slide mutation on the same deck
+  // could read stale data and clobber the other write when both save the
+  // whole decks.data blob back.
+  const now = await withDeckLock(deckId, async () => {
+    const db = getDb();
+    const existing = await db
+      .select()
+      .from(schema.decks)
+      .where(eq(schema.decks.id, deckId))
+      .limit(1);
+
+    if (!existing.length) {
+      throw new Error(`Deck ${deckId} not found`);
+    }
 
-  if (!existing.length) {
-    throw new Error(`Deck ${deckId} not found`);
-  }
+    const writeNow = new Date().toISOString();
+    const previousData = safeParseDeckData(existing[0].data);
+    const previousSlides = Array.isArray(
+      (previousData as { slides?: unknown }).slides,
+    )
+      ? ((previousData as { slides: unknown[] }).slides as typeof slides)
+      : [];
+    // Appending onto an existing deck keeps that deck's own title and canvas
+    // shape — the imported file's title/aspect ratio only apply when the deck
+    // had no slides yet, otherwise resizing the canvas mid-deck would distort
+    // every slide already on it.
+    const hadExistingSlides = previousSlides.length > 0;
+    const nextTitle = hadExistingSlides ? (existing[0].title ?? title) : title;
+    const data = {
+      ...previousData,
+      title: nextTitle,
+      slides: [...previousSlides, ...slides],
+      ...(!hadExistingSlides && aspectRatio ? { aspectRatio } : {}),
+      updatedAt: writeNow,
+    };
 
-  const now = new Date().toISOString();
-  const previousData = safeParseDeckData(existing[0].data);
-  const data = {
-    ...previousData,
-    title,
-    slides,
-    ...(aspectRatio ? { aspectRatio } : {}),
-    updatedAt: now,
-  };
+    await db
+      .update(schema.decks)
+      .set({
+        title: nextTitle,
+        data: JSON.stringify(data),
+        updatedAt: writeNow,
+      })
+      .where(eq(schema.decks.id, deckId));
 
-  await db
-    .update(schema.decks)
-    .set({
-      title,
-      data: JSON.stringify(data),
-      updatedAt: now,
-    })
-    .where(eq(schema.decks.id, deckId));
+    return writeNow;
+  });
 
   notifyClients(deckId);
   await writeAppState("refresh-signal", { ts: now, source });

package/corpus/templates/slides/actions/list-decks.ts

@@ -120,6 +120,7 @@ export default defineAction({
           slideCount: slides?.length ?? 0,
           visibility: row.visibility,
           designSystemId: row.designSystemId ?? null,
+          starred: data?.starred === true,
         };
       }
       return {
@@ -129,6 +130,7 @@ export default defineAction({
         slideCount: slides?.length ?? 0,
         visibility: row.visibility,
         designSystemId: row.designSystemId ?? null,
+        starred: data?.starred === true,
         createdAt: row.createdAt,
         updatedAt: row.updatedAt,
       };

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

@@ -126,6 +126,7 @@ const PatchDeckFieldsOp = z.object({
       aspectRatio: z.enum(ASPECT_RATIO_VALUES).optional(),
       shareToken: z.string().optional(),
       visibility: z.enum(["private", "org", "public"]).optional(),
+      starred: z.boolean().optional(),
     })
     .passthrough(),
 });
@@ -284,6 +285,7 @@ export function applyOperation(deck: any, op: Operation): void {
         deck.aspectRatio = fields.aspectRatio;
       if (fields.shareToken !== undefined) deck.shareToken = fields.shareToken;
       if (fields.visibility !== undefined) deck.visibility = fields.visibility;
+      if (fields.starred !== undefined) deck.starred = fields.starred;
       break;
     }
   }

package/corpus/templates/slides/actions/set-workspace-defaults.ts

@@ -0,0 +1,50 @@
+import { defineAction } from "@agent-native/core";
+import { assertAccess } from "@agent-native/core/sharing";
+import { z } from "zod";
+
+import {
+  assertWorkspaceVisible,
+  writeWorkspaceDefaults,
+  type WorkspaceDefaults,
+} from "../server/workspace-defaults.js";
+
+export default defineAction({
+  description:
+    "Set the workspace-wide brand defaults every new deck starts from. Workspace admins only. " +
+    "Pass a deck or design system id to set it, or null to clear it. Omitted fields are left unchanged.",
+  schema: z.object({
+    referenceDeckId: z
+      .string()
+      .nullish()
+      .describe("Deck to use as the default style reference, or null to clear"),
+    designSystemId: z
+      .string()
+      .nullish()
+      .describe("Design system to apply by default, or null to clear"),
+  }),
+  run: async (args) => {
+    const patch: Partial<WorkspaceDefaults> = {};
+
+    if (args.referenceDeckId !== undefined) {
+      if (args.referenceDeckId === null) {
+        patch.referenceDeckId = null;
+      } else {
+        await assertAccess("deck", args.referenceDeckId, "viewer");
+        await assertWorkspaceVisible("deck", args.referenceDeckId);
+        patch.referenceDeckId = args.referenceDeckId;
+      }
+    }
+
+    if (args.designSystemId !== undefined) {
+      if (args.designSystemId === null) {
+        patch.designSystemId = null;
+      } else {
+        await assertAccess("design-system", args.designSystemId, "viewer");
+        await assertWorkspaceVisible("design-system", args.designSystemId);
+        patch.designSystemId = args.designSystemId;
+      }
+    }
+
+    return writeWorkspaceDefaults(patch);
+  },
+});

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

@@ -152,6 +152,8 @@ export default defineAction({
         activeTool?: string;
         items?: Array<{
           selector?: string;
+          runtimeSelector?: string;
+          objectId?: string;
           text?: string;
           kind?: string;
           tagName?: string;
@@ -172,6 +174,10 @@ export default defineAction({
             lines.push(
               `selected ${index + 1}: ${item.kind ?? "element"} ${item.tagName ?? ""} selector=${item.selector ?? "(none)"}`,
             );
+            if (item.objectId) lines.push(`objectId: ${item.objectId}`);
+            if (item.runtimeSelector) {
+              lines.push(`runtimeSelector: ${item.runtimeSelector}`);
+            }
             if (item.text) lines.push(`text: ${item.text}`);
             if (item.imageSrc) lines.push(`imageSrc: ${item.imageSrc}`);
             if (item.style) {

package/corpus/templates/slides/app/components/comments/SlideCommentsPanel.tsx

@@ -458,7 +458,7 @@ export function SlideCommentsPanel({
   const showInput = pendingComment || addingComment;
 
   return (
-    <div className="w-72 flex-shrink-0 border-l border-border bg-background flex flex-col h-full">
+    <div className="flex h-full w-[17rem] flex-shrink-0 flex-col border-l border-border bg-background">
       {/* Header */}
       <div className="flex items-center justify-between px-4 py-3 border-b border-border flex-shrink-0">
         <span className="text-[13px] font-medium text-foreground/80">