@agent-native/core 0.103.0 → 0.104.0

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

@@ -12,6 +12,14 @@
  */
 import { defineAction } from "@agent-native/core";
 import { assertAccess } from "@agent-native/core/sharing";
+import {
+  getGenerationCreativeContext,
+  mergeCreativeContextReuseLabels,
+  recordGenerationCreativeContext,
+  replaceCreativeContextElementProvenance,
+  validateGenerationCreativeContext,
+} from "@agent-native/creative-context/server";
+import type { CreativeContextReuseLabel } from "@agent-native/creative-context/types";
 import { eq } from "drizzle-orm";
 import { z } from "zod";
 
@@ -131,6 +139,42 @@ export const OperationSchema = z.discriminatedUnion("op", [
 
 export type Operation = z.infer<typeof OperationSchema>;
 
+const CreativeContextReuseLabelSchema = z.object({
+  itemId: z.string().min(1).optional(),
+  itemVersionId: z.string().min(1).optional(),
+  kind: z.string().min(1),
+  label: z.string().min(1),
+  dataRole: z.literal("untrusted-reference").default("untrusted-reference"),
+  elementId: z.string().min(1).optional(),
+  influence: z
+    .enum(["reused", "adapted", "reference-conditioned", "generated"])
+    .optional(),
+});
+
+function storedCreativeContext(value: unknown): {
+  contextMode: "off" | "auto" | "pinned";
+  contextPackId: string | null;
+  reuseLabels: CreativeContextReuseLabel[];
+} | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value as Record<string, unknown>;
+  if (
+    record.contextMode !== "off" &&
+    record.contextMode !== "auto" &&
+    record.contextMode !== "pinned"
+  ) {
+    return null;
+  }
+  return {
+    contextMode: record.contextMode,
+    contextPackId:
+      typeof record.contextPackId === "string" ? record.contextPackId : null,
+    reuseLabels: Array.isArray(record.reuseLabels)
+      ? (record.reuseLabels as CreativeContextReuseLabel[])
+      : [],
+  };
+}
+
 // ---------------------------------------------------------------------------
 // Core merge logic (exported for unit tests)
 // ---------------------------------------------------------------------------
@@ -259,8 +303,21 @@ export default defineAction({
       .array(OperationSchema)
       .min(1)
       .describe("Ordered list of granular operations to apply"),
+    creativeContext: z
+      .object({
+        contextPackId: z.string().optional(),
+        contextModeOverride: z.literal("off").optional(),
+        reuseLabels: z
+          .array(CreativeContextReuseLabelSchema)
+          .optional()
+          .default([]),
+      })
+      .optional()
+      .describe(
+        "Optional exact Creative Context provenance for context-backed slide patch operations.",
+      ),
   }),
-  run: async ({ deckId, operations }) => {
+  run: async ({ deckId, operations, creativeContext }) => {
     await assertAccess("deck", deckId, "editor");
 
     return withDeckLock(deckId, async () => {
@@ -275,6 +332,7 @@ export default defineAction({
 
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       const deck: any = JSON.parse(row.data);
+      const existingContext = storedCreativeContext(deck.creativeContext);
 
       for (const op of operations) {
         applyOperation(deck, op);
@@ -301,15 +359,147 @@ export default defineAction({
         ? (dsOp.fields.designSystemId ?? null)
         : row.designSystemId;
 
-      await db
-        .update(schema.decks)
-        .set({
-          title: sqlTitle,
-          data: JSON.stringify(deck),
-          designSystemId: sqlDesignSystemId,
-          updatedAt: now,
-        })
-        .where(eq(schema.decks.id, deckId));
+      let generationRecord:
+        | {
+            contextMode: "off" | "auto" | "pinned";
+            contextPackId: string | null;
+            reuseLabels: CreativeContextReuseLabel[];
+            elementProvenance: Array<{
+              elementId: string;
+              influence:
+                | "reused"
+                | "adapted"
+                | "reference-conditioned"
+                | "generated";
+              itemId?: string;
+              itemVersionId?: string;
+              label?: string;
+            }>;
+          }
+        | undefined;
+      if (creativeContext) {
+        const affectedSlideIds = [
+          ...new Set(
+            operations.flatMap((operation) =>
+              operation.op === "patch-slide" || operation.op === "add-slide"
+                ? [operation.slideId]
+                : [],
+            ),
+          ),
+        ];
+        if (!affectedSlideIds.length) {
+          throw new Error(
+            "Creative Context provenance requires a patch-slide or add-slide operation",
+          );
+        }
+        if (
+          existingContext &&
+          creativeContext.contextPackId !== undefined &&
+          creativeContext.contextPackId !== existingContext.contextPackId
+        ) {
+          throw new Error(
+            "The deck patch must use the deck's existing creative-context pack",
+          );
+        }
+        const effectivePackId =
+          creativeContext.contextPackId ?? existingContext?.contextPackId;
+        const requestedLabels = affectedSlideIds.flatMap((slideId) => {
+          const labels = creativeContext.reuseLabels.filter(
+            (label) => !label.elementId || label.elementId === slideId,
+          );
+          return labels.length
+            ? labels.map((label) => ({ ...label, elementId: slideId }))
+            : [
+                {
+                  kind: "slide",
+                  label: "Net-new deck patch",
+                  dataRole: "untrusted-reference" as const,
+                  elementId: slideId,
+                  influence: "generated" as const,
+                },
+              ];
+        });
+        const validated = await validateGenerationCreativeContext({
+          contextPackId: effectivePackId,
+          contextPackSource:
+            creativeContext.contextPackId === undefined
+              ? "inherited"
+              : "explicit",
+          contextModeOverride: creativeContext.contextModeOverride,
+          reuseLabels: requestedLabels,
+          reuseLabelsSource: creativeContext.reuseLabels.length
+            ? "explicit"
+            : "inherited",
+        });
+        const contextMode =
+          validated.contextMode === "off"
+            ? "off"
+            : (existingContext?.contextMode ?? validated.contextMode);
+        const previous =
+          contextMode === "off"
+            ? null
+            : await getGenerationCreativeContext({
+                appId: "slides",
+                artifactType: "deck",
+                artifactId: deckId,
+              });
+        const nextElementProvenance = validated.reuseLabels.map((label) => ({
+          elementId: label.elementId!,
+          influence: label.influence ?? ("reference-conditioned" as const),
+          ...(label.itemId ? { itemId: label.itemId } : {}),
+          ...(label.itemVersionId
+            ? { itemVersionId: label.itemVersionId }
+            : {}),
+          label: label.label,
+        }));
+        const mergedReuseLabels = mergeCreativeContextReuseLabels(
+          existingContext?.reuseLabels ?? [],
+          validated.reuseLabels,
+        );
+        generationRecord = {
+          contextMode,
+          contextPackId: validated.contextPackId,
+          reuseLabels:
+            contextMode === "off" ? validated.reuseLabels : mergedReuseLabels,
+          elementProvenance:
+            contextMode === "off"
+              ? nextElementProvenance
+              : replaceCreativeContextElementProvenance(
+                  previous?.elementProvenance ?? [],
+                  nextElementProvenance,
+                ),
+        };
+        if (!(contextMode === "off" && existingContext)) {
+          deck.creativeContext = {
+            contextMode,
+            contextPackId: validated.contextPackId,
+            reuseLabels: mergedReuseLabels,
+          };
+        }
+      }
+
+      await db.transaction(async (tx: any) => {
+        await tx
+          .update(schema.decks)
+          .set({
+            title: sqlTitle,
+            data: JSON.stringify(deck),
+            designSystemId: sqlDesignSystemId,
+            updatedAt: now,
+          })
+          .where(eq(schema.decks.id, deckId));
+        if (generationRecord) {
+          await recordGenerationCreativeContext(
+            {
+              appId: "slides",
+              artifactType: "deck",
+              artifactId: deckId,
+              ...generationRecord,
+            },
+            { db: tx },
+          );
+        }
+      });
 
       notifyClients(deckId);
 

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

@@ -1,6 +1,14 @@
 import { defineAction } from "@agent-native/core";
 import { buildDeepLink } from "@agent-native/core/server";
 import { assertAccess } from "@agent-native/core/sharing";
+import {
+  getGenerationCreativeContext,
+  mergeCreativeContextReuseLabels,
+  recordGenerationCreativeContext,
+  replaceCreativeContextElementProvenance,
+  validateGenerationCreativeContext,
+} from "@agent-native/creative-context/server";
+import type { CreativeContextReuseLabel } from "@agent-native/creative-context/types";
 import { eq } from "drizzle-orm";
 import { z } from "zod";
 
@@ -23,6 +31,60 @@ function deckDeepLink(deckId: string): string {
   });
 }
 
+const reuseLabelSchema = z
+  .object({
+    itemId: z.string().min(1).optional(),
+    itemVersionId: z.string().min(1).optional(),
+    kind: z.string().min(1),
+    label: z.string().min(1),
+    dataRole: z.literal("untrusted-reference").default("untrusted-reference"),
+    elementId: z.string().min(1).optional(),
+    influence: z
+      .enum(["reused", "adapted", "reference-conditioned", "generated"])
+      .optional(),
+  })
+  .superRefine((label, context) => {
+    if (Boolean(label.itemId) !== Boolean(label.itemVersionId)) {
+      context.addIssue({
+        code: "custom",
+        message: "itemId and itemVersionId must be provided together",
+      });
+    }
+    if (
+      (label.influence ?? "reference-conditioned") !== "generated" &&
+      !label.itemId
+    ) {
+      context.addIssue({
+        code: "custom",
+        message: "Only generated labels may omit context item ids",
+      });
+    }
+  });
+
+function storedCreativeContext(value: unknown): {
+  contextMode: "off" | "auto" | "pinned";
+  contextPackId: string | null;
+  reuseLabels: CreativeContextReuseLabel[];
+} | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value as Record<string, unknown>;
+  if (
+    record.contextMode !== "off" &&
+    record.contextMode !== "auto" &&
+    record.contextMode !== "pinned"
+  ) {
+    return null;
+  }
+  return {
+    contextMode: record.contextMode,
+    contextPackId:
+      typeof record.contextPackId === "string" ? record.contextPackId : null,
+    reuseLabels: Array.isArray(record.reuseLabels)
+      ? (record.reuseLabels as CreativeContextReuseLabel[])
+      : [],
+  };
+}
+
 export default defineAction({
   description:
     "Surgically edit a slide's content using search-replace or full replacement. " +
@@ -42,10 +104,36 @@ export default defineAction({
       .string()
       .optional()
       .describe("Full HTML to replace entire slide content"),
+    contextPackId: z
+      .string()
+      .optional()
+      .describe(
+        "Exact pack used for this edit; omit to inherit the deck pack.",
+      ),
+    contextModeOverride: z
+      .literal("off")
+      .optional()
+      .describe(
+        "Disable Creative Context for this edit only without changing the saved preference or deck pack.",
+      ),
+    reuseLabels: z
+      .array(reuseLabelSchema)
+      .optional()
+      .default([])
+      .describe("Exact context item versions that influenced this slide edit."),
   }),
   http: false,
   run: async (args) => {
-    const { deckId, slideId, find, replace, fullContent } = args;
+    const {
+      deckId,
+      slideId,
+      find,
+      replace,
+      fullContent,
+      contextPackId,
+      contextModeOverride,
+      reuseLabels,
+    } = args;
     if (!find && !fullContent) {
       throw new Error("Either --find or --fullContent is required");
     }
@@ -83,17 +171,17 @@ export default defineAction({
         throw new Error(`Deck ${deckId} not found`);
       }
 
-      await createDeckVersionSnapshot(
-        {
-          id: row.id,
-          title: row.title ?? "Untitled",
-          data: row.data ?? "",
-          ownerEmail: row.ownerEmail ?? "",
-        },
-        { label: "Before slide edit" },
-      );
-
       const deck = JSON.parse(row.data);
+      const existingContext = storedCreativeContext(deck.creativeContext);
+      if (
+        existingContext &&
+        contextPackId !== undefined &&
+        contextPackId !== existingContext.contextPackId
+      ) {
+        throw new Error(
+          "The slide edit must use the deck's existing creative-context pack",
+        );
+      }
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       const slideIndex = Array.isArray(deck.slides)
         ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -139,12 +227,110 @@ export default defineAction({
       // an open editor uses to tell an intentional external edit apart from a
       // stale poll echo — only a newer timestamp is reconciled into the view.
       if (applied) {
+        const effectivePackId = contextPackId ?? existingContext?.contextPackId;
+        const requestedLabels: CreativeContextReuseLabel[] = reuseLabels.length
+          ? reuseLabels
+          : [
+              {
+                kind: "slide",
+                label: "Net-new slide edit",
+                dataRole: "untrusted-reference",
+                elementId: slideId,
+                influence: "generated",
+              },
+            ];
+        const validated = await validateGenerationCreativeContext({
+          contextPackId: effectivePackId,
+          contextPackSource:
+            contextPackId === undefined ? "inherited" : "explicit",
+          contextModeOverride,
+          reuseLabels: requestedLabels,
+          reuseLabelsSource: reuseLabels.length ? "explicit" : "inherited",
+        });
+        const contextMode =
+          validated.contextMode === "off"
+            ? "off"
+            : (existingContext?.contextMode ?? validated.contextMode);
+        const slideReuseLabels = validated.reuseLabels.map((label) => ({
+          ...label,
+          elementId: slideId,
+        }));
+        const mergedReuseLabels = mergeCreativeContextReuseLabels(
+          existingContext?.reuseLabels ?? [],
+          slideReuseLabels,
+        );
+        const previous =
+          contextMode === "off"
+            ? null
+            : await getGenerationCreativeContext({
+                appId: "slides",
+                artifactType: "deck",
+                artifactId: deckId,
+              });
+        const editedElementProvenance = slideReuseLabels.map((label) => ({
+          elementId: slideId,
+          influence: label.influence ?? ("reference-conditioned" as const),
+          ...(label.itemId ? { itemId: label.itemId } : {}),
+          ...(label.itemVersionId
+            ? { itemVersionId: label.itemVersionId }
+            : {}),
+          label: label.label,
+        }));
+        const elementProvenance =
+          contextMode === "off"
+            ? editedElementProvenance
+            : replaceCreativeContextElementProvenance(
+                previous?.elementProvenance ?? [],
+                editedElementProvenance,
+              );
+        slide.creativeContextReuseLabels = slideReuseLabels;
+        deck.creativeContext =
+          contextMode === "off" && existingContext
+            ? existingContext
+            : {
+                contextMode,
+                contextPackId: validated.contextPackId,
+                reuseLabels: mergedReuseLabels,
+              };
+        await createDeckVersionSnapshot(
+          {
+            id: row.id,
+            title: row.title ?? "Untitled",
+            data: row.data ?? "",
+            ownerEmail: row.ownerEmail ?? "",
+          },
+          { label: "Before slide edit" },
+        );
         const now = new Date().toISOString();
         deck.updatedAt = now;
-        await db
-          .update(schema.decks)
-          .set({ data: JSON.stringify(deck), updatedAt: now })
-          .where(eq(schema.decks.id, deckId));
+        await db.transaction(async (tx: any) => {
+          await tx
+            .update(schema.decks)
+            .set({ data: JSON.stringify(deck), updatedAt: now })
+            .where(eq(schema.decks.id, deckId));
+          await recordGenerationCreativeContext(
+            {
+              appId: "slides",
+              artifactType: "deck",
+              artifactId: deckId,
+              contextMode,
+              contextPackId: validated.contextPackId,
+              reuseLabels:
+                contextMode === "off" ? slideReuseLabels : mergedReuseLabels,
+              elementProvenance,
+            },
+            { db: tx },
+          );
+        });
+        return {
+          applied,
+          notFound,
+          slide,
+          slideIndex,
+          contextMode,
+          contextPackId: validated.contextPackId,
+          reuseLabels: slideReuseLabels,
+        };
       }
 
       return { applied, notFound, slide, slideIndex };
@@ -190,6 +376,13 @@ export default defineAction({
       slideId,
       applied,
       deepLink: deckDeepLink(deckId),
+      ...(rmw.contextMode
+        ? {
+            contextMode: rmw.contextMode,
+            contextPackId: rmw.contextPackId,
+            reuseLabels: rmw.reuseLabels,
+          }
+        : {}),
     };
 
     if (fit.status === "overflows") {

package/corpus/templates/slides/app/components/layout/Layout.tsx

@@ -1,5 +1,6 @@
 import { AgentSidebar, useT } from "@agent-native/core/client";
 import { InvitationBanner } from "@agent-native/core/client/org";
+import { CreativeContextComposerChip } from "@agent-native/creative-context/client";
 import { HeaderActionsProvider } from "@agent-native/toolkit/app-shell";
 import { IconMenu2 } from "@tabler/icons-react";
 import { useEffect, useMemo, useState } from "react";
@@ -78,6 +79,7 @@ export function Layout({ children }: LayoutProps) {
         scope={deckScope}
         browserTabId={TAB_ID}
         agentPageHref="/agent"
+        composerSlot={<CreativeContextComposerChip />}
       >
         <div className="agent-layout-shell flex h-screen w-full overflow-hidden bg-background text-foreground">
           {sidebarOpen && (

package/corpus/templates/slides/app/components/visual-editor/CanvasCommentPins.tsx

@@ -142,6 +142,17 @@ export function CanvasCommentPins({
   const [pins, setPins] = useState<CanvasPin[]>([]);
   const [activePinId, setActivePinId] = useState<string | null>(null);
   const containerRef = useRef<HTMLElement | null>(null);
+  const removalTimersRef = useRef<Set<ReturnType<typeof setTimeout>>>(
+    new Set(),
+  );
+
+  useEffect(
+    () => () => {
+      for (const timer of removalTimersRef.current) clearTimeout(timer);
+      removalTimersRef.current.clear();
+    },
+    [],
+  );
 
   // Reset pins when the context (slide) changes — they're scoped to one view.
   useEffect(() => {
@@ -273,7 +284,11 @@ export function CanvasCommentPins({
     updatePin(pin.id, { submitted: true });
     // Keep the acknowledgement visible just long enough to register, without
     // making a routine submit feel delayed.
-    setTimeout(() => removePin(pin.id), 220);
+    const timer = setTimeout(() => {
+      removalTimersRef.current.delete(timer);
+      removePin(pin.id);
+    }, 220);
+    removalTimersRef.current.add(timer);
   };
 
   if (!active && pins.length === 0) return null;

package/corpus/templates/slides/app/i18n/ar-SA.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["ar-SA"],
   root: {
     commandPresentations: "العروض التقديمية",
     searchDecks: "البحث في العروض",

package/corpus/templates/slides/app/i18n/de-DE.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["de-DE"],
   root: {
     commandPresentations: "Präsentationen",
     searchDecks: "Decks suchen",

package/corpus/templates/slides/app/i18n/en-US.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["en-US"],
   root: {
     commandPresentations: "Presentations",
     searchDecks: "Search decks",
@@ -34,10 +37,10 @@ const messages = {
       "Manage team members, organization access, and shared workspace preferences.",
     openTeamSettings: "Open team settings",
     openResourceSettings: "Open resource settings",
-    agentTitle: "Agent settings",
+    agentTitle: "Agent workspace",
     agentDescription:
-      "Open the agent sidebar settings for model, API keys, automations, voice, and other agent controls.",
-    openAgentSettings: "Open agent settings",
+      "Open the agent workspace for model, API keys, automations, voice, and other agent controls.",
+    openAgentSettings: "Open agent workspace",
   },
   agent: {
     emptyState: "Ask me anything about your presentations",

package/corpus/templates/slides/app/i18n/es-ES.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["es-ES"],
   root: {
     commandPresentations: "Presentaciones",
     searchDecks: "Buscar decks",

package/corpus/templates/slides/app/i18n/fr-FR.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["fr-FR"],
   root: {
     commandPresentations: "Présentations",
     searchDecks: "Rechercher des decks",

package/corpus/templates/slides/app/i18n/hi-IN.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["hi-IN"],
   root: {
     commandPresentations: "प्रेज़ेंटेशन",
     searchDecks: "डेक खोजें",

package/corpus/templates/slides/app/i18n/ja-JP.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["ja-JP"],
   root: {
     commandPresentations: "プレゼンテーション",
     searchDecks: "デッキを検索",

package/corpus/templates/slides/app/i18n/ko-KR.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["ko-KR"],
   root: {
     commandPresentations: "프레젠테이션",
     searchDecks: "덱 검색",

package/corpus/templates/slides/app/i18n/pt-BR.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["pt-BR"],
   root: {
     commandPresentations: "Apresentações",
     searchDecks: "Buscar decks",

package/corpus/templates/slides/app/i18n/zh-CN.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["zh-CN"],
   root: {
     commandPresentations: "演示文稿",
     searchDecks: "搜索幻灯片",

package/corpus/templates/slides/app/i18n/zh-TW.ts

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["zh-TW"],
   root: {
     commandPresentations: "簡報",
     searchDecks: "搜尋幻燈片",