@agent-native/core 0.103.0 → 0.104.0

package/corpus/templates/assets/actions/generate-image.ts

@@ -9,6 +9,13 @@ import {
   getRequestOrgId,
 } from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";
+import {
+  delimitUntrustedReference,
+  getGenerationCreativeContext,
+  recordGenerationCreativeContext,
+  resolveGenerationCreativeContext,
+} from "@agent-native/creative-context/server";
+import type { CreativeContextReuseLabel } from "@agent-native/creative-context/types";
 import { eq, inArray } from "drizzle-orm";
 import { nanoid } from "nanoid";
 import { z } from "zod";
@@ -179,6 +186,18 @@ export default defineAction({
       .describe(
         "Set by A2A callers (e.g. 'slides', 'design'). Audit log filters on this.",
       ),
+    creativeContextRequestId: z
+      .string()
+      .optional()
+      .describe(
+        "Internal immutable creative-context request ID supplied by the Assets picker.",
+      ),
+    contextModeOverride: z
+      .literal("off")
+      .optional()
+      .describe(
+        "Disable Creative Context for this image generation only without changing the saved preference.",
+      ),
     activateSessionAsset: z.coerce
       .boolean()
       .default(true)
@@ -211,6 +230,165 @@ export default defineAction({
     const session = args.sessionId
       ? await requireGenerationSessionInLibrary(args.sessionId, args.libraryId)
       : null;
+    const contextOff = args.contextModeOverride === "off";
+    const lineageAssetId = args.sourceAssetId ?? args.subjectAssetId;
+    const [lineageAsset] = lineageAssetId
+      ? await db
+          .select({
+            id: schema.assets.id,
+            libraryId: schema.assets.libraryId,
+          })
+          .from(schema.assets)
+          .where(eq(schema.assets.id, lineageAssetId))
+          .limit(1)
+      : [null];
+    if (
+      lineageAssetId &&
+      (!lineageAsset || lineageAsset.libraryId !== args.libraryId)
+    ) {
+      throw new Error("Source asset must belong to this asset library.");
+    }
+    const sessionCreativeContext =
+      session && !contextOff
+        ? await getGenerationCreativeContext(
+            {
+              appId: "assets",
+              artifactType: "generation-session",
+              artifactId: session.id,
+            },
+            {
+              artifactAccess: {
+                resourceType: "asset-library",
+                resourceId: args.libraryId,
+              },
+            },
+          )
+        : null;
+    const pickerCreativeContext =
+      args.creativeContextRequestId && !contextOff
+        ? await getGenerationCreativeContext({
+            appId: "assets",
+            artifactType: "generation-request",
+            artifactId: args.creativeContextRequestId,
+          })
+        : null;
+    const lineageCreativeContext =
+      lineageAsset && !contextOff
+        ? await getGenerationCreativeContext(
+            {
+              appId: "assets",
+              artifactType: "asset",
+              artifactId: lineageAsset.id,
+            },
+            {
+              artifactAccess: {
+                resourceType: "asset-library",
+                resourceId: args.libraryId,
+              },
+            },
+          )
+        : null;
+    if (
+      args.creativeContextRequestId &&
+      !contextOff &&
+      !pickerCreativeContext
+    ) {
+      throw new Error(
+        "The creative-context picker request is missing or inaccessible. Reopen the picker to preserve its generation context.",
+      );
+    }
+    if (session && !contextOff && !sessionCreativeContext) {
+      throw new Error(
+        "The generation session has no immutable creative-context snapshot. Create a new session before generating more images.",
+      );
+    }
+    if (
+      sessionCreativeContext &&
+      pickerCreativeContext &&
+      sessionCreativeContext.contextPackId !==
+        pickerCreativeContext.contextPackId
+    ) {
+      throw new Error(
+        "The picker and generation session use different creative-context snapshots.",
+      );
+    }
+    const immutableContexts = [
+      sessionCreativeContext,
+      pickerCreativeContext,
+      lineageCreativeContext,
+    ].filter((value) => value !== null);
+    if (
+      immutableContexts.some(
+        (value) => value.contextPackId !== immutableContexts[0]?.contextPackId,
+      )
+    ) {
+      throw new Error(
+        "The generation session, picker, and source asset use different creative-context snapshots.",
+      );
+    }
+    const storedCreativeContext =
+      sessionCreativeContext ??
+      pickerCreativeContext ??
+      lineageCreativeContext ??
+      null;
+    const creativeContext = contextOff
+      ? await resolveGenerationCreativeContext({
+          role: "assets",
+          contextModeOverride: "off",
+        })
+      : storedCreativeContext?.contextPackId
+        ? await resolveGenerationCreativeContext({
+            role: "assets",
+            contextPackId: storedCreativeContext.contextPackId,
+            contextPackSource: "inherited",
+          })
+        : storedCreativeContext
+          ? {
+              contextMode: storedCreativeContext.contextMode,
+              contextPackId: null,
+              reuseLabels: [],
+              results: [],
+            }
+          : await resolveGenerationCreativeContext({
+              query: args.prompt,
+              role: "assets",
+            });
+    const creativeContextText = creativeContext.results
+      .map((result) => `${result.kind}: ${result.title}\n${result.excerpt}`)
+      .join("\n\n")
+      .split("<<<UNTRUSTED_REFERENCE>>>")
+      .join("")
+      .split("<<<END_UNTRUSTED_REFERENCE>>>")
+      .join("")
+      .trim();
+    const creativeContextInstructions = creativeContextText
+      ? delimitUntrustedReference(creativeContextText)
+      : "";
+    const creativeContextReuseLabels =
+      creativeContext.reuseLabels as CreativeContextReuseLabel[];
+    const creativeContextProvenance = {
+      contextMode: creativeContext.contextMode,
+      contextPackId: creativeContext.contextPackId,
+      reuseLabels: creativeContextReuseLabels,
+    };
+    const elementProvenanceFor = (elementId: string) =>
+      creativeContextProvenance.reuseLabels.length
+        ? creativeContextProvenance.reuseLabels.map((label) => ({
+            elementId: label.elementId ?? elementId,
+            influence: label.influence ?? ("reference-conditioned" as const),
+            ...(label.itemId ? { itemId: label.itemId } : {}),
+            ...(label.itemVersionId
+              ? { itemVersionId: label.itemVersionId }
+              : {}),
+            label: label.label,
+          }))
+        : [
+            {
+              elementId,
+              influence: "generated" as const,
+              label: "Net-new image",
+            },
+          ];
     if (
       session?.presetId &&
       args.presetId &&
@@ -516,7 +694,11 @@ export default defineAction({
     const compiledPrompt = compilePrompt({
       libraryTitle: library.title,
       styleBrief,
-      customInstructions: [library.customInstructions, presetInstructions]
+      customInstructions: [
+        library.customInstructions,
+        presetInstructions,
+        creativeContextInstructions,
+      ]
         .filter((item) => item?.trim())
         .join("\n\n"),
       prompt: promptForRun,
@@ -618,6 +800,7 @@ export default defineAction({
       sessionId: session?.id,
       referenceSelection,
       settingsUsed,
+      creativeContext: creativeContextProvenance,
     };
     await db.insert(schema.assetGenerationRuns).values({
       id: runId,
@@ -640,6 +823,21 @@ export default defineAction({
       metadata: stringifyJson(baseMetadata),
       createdAt: now,
     });
+    await recordGenerationCreativeContext(
+      {
+        appId: "assets",
+        artifactType: "generation-run",
+        artifactId: runId,
+        ...creativeContextProvenance,
+        elementProvenance: elementProvenanceFor(runId),
+      },
+      {
+        artifactAccess: {
+          resourceType: "asset-library",
+          resourceId: args.libraryId,
+        },
+      },
+    );
 
     await upsertVariantSlot({
       runId,
@@ -740,6 +938,7 @@ export default defineAction({
               provider: generated.provider,
               providerGenerationId: generated.providerGenerationId,
               creditsCharged: generated.creditsCharged,
+              creativeContext: creativeContextProvenance,
             }),
           })
           .where(eq(schema.assetGenerationRuns.id, runId));
@@ -748,6 +947,7 @@ export default defineAction({
           dismissed: true,
           artifactType: "image",
           Artifacts: [],
+          ...creativeContextProvenance,
         };
       }
       const asset = await withToolActivity(
@@ -792,10 +992,26 @@ export default defineAction({
               sourceUrl: generated.sourceUrl,
               providerGenerationId: generated.providerGenerationId,
               creditsCharged: generated.creditsCharged,
+              creativeContext: creativeContextProvenance,
             },
             category,
           }),
       );
+      await recordGenerationCreativeContext(
+        {
+          appId: "assets",
+          artifactType: "asset",
+          artifactId: asset.id,
+          ...creativeContextProvenance,
+          elementProvenance: elementProvenanceFor(asset.id),
+        },
+        {
+          artifactAccess: {
+            resourceType: "asset-library",
+            resourceId: args.libraryId,
+          },
+        },
+      );
       if (session) {
         const itemCreatedAt = nowIso();
         await db.insert(schema.assetGenerationSessionItems).values({
@@ -841,6 +1057,7 @@ export default defineAction({
             provider: generated.provider,
             providerGenerationId: generated.providerGenerationId,
             creditsCharged: generated.creditsCharged,
+            creativeContext: creativeContextProvenance,
           }),
         })
         .where(eq(schema.assetGenerationRuns.id, runId));
@@ -868,6 +1085,7 @@ export default defineAction({
         Artifacts: [
           `Image: ${serialized.url} (ID: ${asset.id}, Run: ${runId})`,
         ],
+        ...creativeContextProvenance,
       };
     } catch (err) {
       const message =

package/corpus/templates/assets/actions/open-asset-picker.ts

@@ -80,6 +80,12 @@ const schema = z.object({
     .string()
     .optional()
     .describe("Calling app id, for audit grouping, e.g. design."),
+  creativeContextRequestId: z
+    .string()
+    .optional()
+    .describe(
+      "Internal immutable creative-context request ID. Preserve this value when the picker starts generation.",
+    ),
   layout: layoutSchema
     .default("default")
     .describe(
@@ -140,6 +146,12 @@ function pickerPath(args: Partial<OpenAssetPickerArgs>): string {
   }
   if (args.includeLogo) params.set("includeLogo", "1");
   if (args.callerAppId?.trim()) params.set("callerAppId", args.callerAppId);
+  if (args.creativeContextRequestId?.trim()) {
+    params.set(
+      "creativeContextRequestId",
+      args.creativeContextRequestId.trim(),
+    );
+  }
   if (args.layout === "vertical") params.set("layout", "vertical");
   for (const runId of args.candidateRunIds ?? []) {
     if (runId.trim()) params.append("candidateRunIds", runId.trim());
@@ -215,6 +227,7 @@ const action = defineAction({
         prompt: args.prompt ?? null,
         aspectRatio: args.aspectRatio ?? null,
         presetId: args.presetId ?? null,
+        creativeContextRequestId: args.creativeContextRequestId ?? null,
         layout: args.layout,
         _writeId: `open-asset-picker-${Date.now()}-${Math.random()
           .toString(36)
@@ -252,6 +265,7 @@ const action = defineAction({
       styleStrength: args.styleStrength,
       includeLogo: args.includeLogo,
       callerAppId: args.callerAppId ?? null,
+      creativeContextRequestId: args.creativeContextRequestId ?? null,
       candidateRunIds: args.candidateRunIds ?? [],
       autoGenerate: args.autoGenerate,
     };

package/corpus/templates/assets/actions/refine-image.ts

@@ -28,6 +28,7 @@ export default defineAction({
       .describe(
         "Set by A2A callers (e.g. 'slides', 'design') so audit logs can filter by app.",
       ),
+    contextModeOverride: z.literal("off").optional(),
   }),
   parallelSafe: true,
   run: async ({
@@ -41,6 +42,7 @@ export default defineAction({
     slotId,
     source,
     callerAppId,
+    contextModeOverride,
   }) => {
     const asset = await getAssetOrThrow(assetId);
     if (sessionId) {
@@ -71,6 +73,7 @@ export default defineAction({
       slotId,
       source,
       callerAppId,
+      contextModeOverride,
     });
   },
 });

package/corpus/templates/assets/actions/restyle-image.ts

@@ -35,6 +35,7 @@ export default defineAction({
       .describe(
         "Set by A2A callers (e.g. 'slides', 'design') so audit logs can filter by app.",
       ),
+    contextModeOverride: z.literal("off").optional(),
   }),
   parallelSafe: true,
   run: async (args) => {
@@ -60,6 +61,7 @@ export default defineAction({
       slotId: args.slotId,
       source: args.source,
       callerAppId: args.callerAppId,
+      contextModeOverride: args.contextModeOverride,
     });
   },
 });

package/corpus/templates/assets/agent-native.app-skill.json

@@ -34,6 +34,10 @@
     }
   ],
   "skills": [
+    {
+      "path": ".agents/skills/creative-context",
+      "visibility": "internal"
+    },
     {
       "path": ".agents/skills/asset-generation",
       "visibility": "both",

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

@@ -13,6 +13,7 @@ import {
   EMBED_MODE_QUERY_PARAM,
   EMBED_TOKEN_QUERY_PARAM,
 } from "@agent-native/core/shared";
+import { CreativeContextComposerChip } from "@agent-native/creative-context/client";
 import { HeaderActionsProvider } from "@agent-native/toolkit/app-shell";
 import { IconMenu2 } from "@tabler/icons-react";
 import { useState, useEffect } from "react";
@@ -170,6 +171,7 @@ export function Layout({ children }: LayoutProps) {
           <GenerationResults threadId={threadId} />
         )}
         imageModelMenu={imageModelMenu}
+        composerSlot={<CreativeContextComposerChip />}
       >
         {appFrame}
       </AgentSidebar>

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

@@ -1,4 +1,7 @@
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
+
 const messages = {
+  creativeContext: creativeContextMessagesByLocale["zh-TW"],
   root: {
     commandActions: "操作",
     commandSearch: "搜尋",

package/corpus/templates/assets/app/i18n-data.ts

@@ -1,4 +1,5 @@
 import type { LocaleCode } from "@agent-native/core/client";
+import { creativeContextMessagesByLocale } from "@agent-native/creative-context/messages";
 
 import zhTW from "./i18n/zh-TW";
 
@@ -594,6 +595,7 @@ const auditEnUS = {
 } satisfies Record<string, string>;
 
 const enUS = {
+  creativeContext: creativeContextMessagesByLocale["en-US"],
   root: {
     commandActions: "Actions",
     commandSearch: "Search",
@@ -613,10 +615,10 @@ const enUS = {
     collapseSidebar: "Collapse sidebar",
   },
   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",
     title: "Settings",
     description: "Asset generation, storage, and brand kit access.",
     connections: "Connections",
@@ -3654,13 +3656,27 @@ function mergeMessages(overrides: PartialMessages): Messages {
     },
     brandKits: { ...enUS.brandKits, ...overrides.brandKits },
     library: { ...enUS.library, ...overrides.library },
+    creativeContext: {
+      ...enUS.creativeContext,
+      ...overrides.creativeContext,
+    },
   };
 }
 
+function mergeLocalizedMessages(
+  locale: Exclude<LocaleCode, "en-US">,
+  overrides: PartialMessages,
+): Messages {
+  return mergeMessages({
+    ...overrides,
+    creativeContext: creativeContextMessagesByLocale[locale],
+  });
+}
+
 export const messagesByLocale = {
   "en-US": enUS,
-  "zh-TW": mergeMessages(zhTW),
-  "zh-CN": mergeMessages({
+  "zh-TW": mergeLocalizedMessages("zh-TW", zhTW),
+  "zh-CN": mergeLocalizedMessages("zh-CN", {
     library: {
       allLibraries: "所有库",
       noDrafts: "暂无草稿。",
@@ -4492,7 +4508,7 @@ export const messagesByLocale = {
       yourBrandKits: "您的品牌套件",
     },
   }),
-  "es-ES": mergeMessages({
+  "es-ES": mergeLocalizedMessages("es-ES", {
     library: {
       allLibraries: "Todas las bibliotecas",
       noDrafts: "Aún no hay borradores.",
@@ -4962,7 +4978,7 @@ export const messagesByLocale = {
       daysAgo: "hace {{count}} d",
     },
   }),
-  "fr-FR": mergeMessages({
+  "fr-FR": mergeLocalizedMessages("fr-FR", {
     library: {
       allLibraries: "Toutes les bibliothèques",
       noDrafts: "Aucun brouillon pour l'instant.",
@@ -5410,7 +5426,7 @@ export const messagesByLocale = {
       daysAgo: "il y a {{count}} j",
     },
   }),
-  "de-DE": mergeMessages({
+  "de-DE": mergeLocalizedMessages("de-DE", {
     library: {
       allLibraries: "Alle Bibliotheken",
       noDrafts: "Noch keine Entwürfe.",
@@ -5766,7 +5782,7 @@ export const messagesByLocale = {
     },
     brandKits: brandKitsDeDE,
   }),
-  "ja-JP": mergeMessages({
+  "ja-JP": mergeLocalizedMessages("ja-JP", {
     library: {
       allLibraries: "すべてのライブラリ",
       noDrafts: "下書きはまだありません。",
@@ -6112,7 +6128,7 @@ export const messagesByLocale = {
     },
     brandKits: brandKitsJaJP,
   }),
-  "ko-KR": mergeMessages({
+  "ko-KR": mergeLocalizedMessages("ko-KR", {
     library: {
       allLibraries: "모든 라이브러리",
       noDrafts: "아직 초안이 없습니다.",
@@ -6457,7 +6473,7 @@ export const messagesByLocale = {
     },
     brandKits: brandKitsKoKR,
   }),
-  "pt-BR": mergeMessages({
+  "pt-BR": mergeLocalizedMessages("pt-BR", {
     library: {
       allLibraries: "Todas as bibliotecas",
       noDrafts: "Ainda não há rascunhos.",
@@ -6904,7 +6920,7 @@ export const messagesByLocale = {
       daysAgo: "há {{count}} d",
     },
   }),
-  "hi-IN": mergeMessages({
+  "hi-IN": mergeLocalizedMessages("hi-IN", {
     library: {
       allLibraries: "सभी लाइब्रेरी",
       noDrafts: "अभी तक कोई ड्राफ़्ट नहीं।",
@@ -7247,7 +7263,7 @@ export const messagesByLocale = {
     },
     brandKits: brandKitsHiIN,
   }),
-  "ar-SA": mergeMessages({
+  "ar-SA": mergeLocalizedMessages("ar-SA", {
     library: {
       allLibraries: "جميع المكتبات",
       noDrafts: "لا توجد مسودات بعد.",

package/corpus/templates/assets/app/routes/agent.tsx

@@ -1,5 +1,11 @@
 import { AgentTabsPage } from "@agent-native/core/client";
+import { createCreativeContextAgentTab } from "@agent-native/creative-context/client";
 
 export default function AgentRoute() {
-  return <AgentTabsPage appName="Assets" />;
+  return (
+    <AgentTabsPage
+      appName="Assets"
+      extraTabFactories={[createCreativeContextAgentTab]}
+    />
+  );
 }

package/corpus/templates/assets/app/routes/library.tsx

@@ -206,6 +206,7 @@ type HostConfig = {
   styleStrength?: StyleStrength;
   includeLogo?: boolean;
   callerAppId?: string;
+  creativeContextRequestId?: string;
   layout?: PickerLayout;
   autoGenerate?: boolean;
   candidateRunIds?: string[];
@@ -363,6 +364,10 @@ function normalizeHostConfig(value: unknown): HostConfig {
     includeLogo: normalizeBoolean(record.includeLogo),
     callerAppId:
       typeof record.callerAppId === "string" ? record.callerAppId : undefined,
+    creativeContextRequestId:
+      typeof record.creativeContextRequestId === "string"
+        ? record.creativeContextRequestId
+        : undefined,
     layout: normalizePickerLayout(record.layout),
     candidateRunIds: normalizeCandidateRunIds(record.candidateRunIds),
   };
@@ -2216,6 +2221,8 @@ export function AssetPickerSurface() {
       styleStrength: normalizeStyleStrength(params.get("styleStrength")),
       includeLogo: normalizeBoolean(params.get("includeLogo")),
       callerAppId: params.get("callerAppId") ?? undefined,
+      creativeContextRequestId:
+        params.get("creativeContextRequestId") ?? undefined,
       layout: normalizePickerLayout(params.get("layout")),
       candidateRunIds: normalizeCandidateRunIds(
         params.getAll("candidateRunIds").length > 0
@@ -2760,6 +2767,7 @@ export function AssetPickerSurface() {
       includeLogo: hostConfig.includeLogo,
       source: "ui",
       callerAppId: hostConfig.callerAppId,
+      creativeContextRequestId: hostConfig.creativeContextRequestId,
     } as any);
   }, [
     count,
@@ -2768,6 +2776,7 @@ export function AssetPickerSurface() {
     effectiveAspectRatio,
     generateBatch,
     hostConfig.callerAppId,
+    hostConfig.creativeContextRequestId,
     hostConfig.includeLogo,
     hostConfig.styleStrength,
     hostConfig.tier,

package/corpus/templates/assets/app/routes/settings.tsx

@@ -16,6 +16,7 @@ import {
   type OnboardingStepStatus,
 } from "@agent-native/core/client/onboarding";
 import { TeamPage } from "@agent-native/core/client/org";
+import { CreativeContextSettingsLink } from "@agent-native/creative-context/client";
 import {
   IconAlertCircle,
   IconCheck,
@@ -112,6 +113,8 @@ export default function SettingsPage() {
         generalSearchEntries={generalSearchEntries}
         general={
           <div className="mx-auto w-full max-w-2xl space-y-6">
+            <CreativeContextSettingsLink />
+
             <div>
               <h2 className="text-lg font-semibold tracking-tight">
                 {t("settings.connections")}

package/corpus/templates/assets/changelog/2026-07-16-creative-context-library.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-16
+---
+
+The Agent workspace now includes a creative-context Library while the existing Assets media Library stays unchanged.

package/corpus/templates/assets/package.json

@@ -14,6 +14,7 @@
   },
   "dependencies": {
     "@agent-native/core": "workspace:*",
+    "@agent-native/creative-context": "workspace:*",
     "@agent-native/toolkit": "workspace:*",
     "@aws-sdk/client-s3": "^3.1044.0",
     "@aws-sdk/s3-request-presigner": "^3.1044.0",

package/corpus/templates/assets/server/lib/image-processing.ts

@@ -1,4 +1,5 @@
 import sharp from "sharp";
+export { extractDominantColors } from "@agent-native/core/ingestion";
 
 import type {
   AspectRatio,
@@ -44,28 +45,6 @@ export async function makeThumbnail(buffer: Buffer): Promise<{
   };
 }
 
-export async function extractDominantColors(buffer: Buffer): Promise<string[]> {
-  const { data } = await sharp(buffer, { failOn: "none" })
-    .resize(64, 64, { fit: "inside" })
-    .removeAlpha()
-    .raw()
-    .toBuffer({ resolveWithObject: true });
-  const buckets = new Map<string, number>();
-  for (let i = 0; i < data.length; i += 3) {
-    const r = Math.round(data[i] / 32) * 32;
-    const g = Math.round(data[i + 1] / 32) * 32;
-    const b = Math.round(data[i + 2] / 32) * 32;
-    const key = [r, g, b]
-      .map((v) => Math.max(0, Math.min(255, v)).toString(16).padStart(2, "0"))
-      .join("");
-    buckets.set(key, (buckets.get(key) ?? 0) + 1);
-  }
-  return [...buckets.entries()]
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, 6)
-    .map(([hex]) => `#${hex.toUpperCase()}`);
-}
-
 export async function compositeLogo(input: {
   image: Buffer;
   logo: Buffer;