@agent-native/core 0.103.0 → 0.104.0

package/corpus/templates/analytics/server/lib/first-party-metric-catalog.ts

@@ -197,7 +197,7 @@ export const FIRST_PARTY_DASHBOARD_FILTERS: FirstPartyDashboardFilter[] = [
     id: "emailFilter",
     type: "select",
     label: "Email filter",
-    default: "all",
+    default: "exclude_builder",
     options: [
       { value: "all", label: "All users" },
       { value: "exclude_builder", label: "Exclude @builder.io" },
@@ -223,6 +223,8 @@ const RETENTION_OVER_TIME_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_S
 const ONE_DAY_RETENTION_BY_TEMPLATE_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${TEMPLATE_EXPR} AS template, ${EVENT_DATE_SQL} AS event_date, user_id FROM analytics_events WHERE ${SIGNED_IN_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER} AND ${KNOWN_PRODUCT_ACTIVITY_TEMPLATE_FILTER}), ranked_first_seen AS (SELECT user_key, template, event_date AS cohort_date, ROW_NUMBER() OVER (PARTITION BY user_key ORDER BY event_date, template) AS rn FROM base), first_seen AS (SELECT user_key, template, cohort_date FROM ranked_first_seen WHERE rn = 1), cohorts AS (SELECT user_key, template, cohort_date FROM first_seen WHERE cohort_date <= ${daysAgoSql(7)} AND ${dashboardTimeRangeFilter("cohort_date")}), cohort_sizes AS (SELECT template, COUNT(DISTINCT user_key) AS users FROM cohorts GROUP BY template), retained AS (SELECT c.template, COUNT(DISTINCT c.user_key) AS retained FROM cohorts c JOIN base b ON b.user_key = c.user_key AND b.event_date > c.cohort_date AND b.event_date <= to_char(c.cohort_date::date + INTERVAL '7 days', 'YYYY-MM-DD') GROUP BY c.template) SELECT cs.template, COALESCE(r.retained, 0) AS retained_users, cs.users AS cohort_users, COALESCE(r.retained::float / NULLIF(cs.users, 0), 0) AS rate FROM cohort_sizes cs LEFT JOIN retained r ON r.template = cs.template WHERE cs.users >= ${PER_TEMPLATE_RETENTION_MIN_COHORT_SIZE} ORDER BY rate DESC, cs.users DESC, cs.template`;
 const SEVEN_DAY_RETENTION_BY_TEMPLATE_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${TEMPLATE_EXPR} AS template, ${EVENT_DATE_SQL} AS event_date, user_id FROM analytics_events WHERE ${SIGNED_IN_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER} AND ${KNOWN_PRODUCT_ACTIVITY_TEMPLATE_FILTER}), ranked_first_seen AS (SELECT user_key, template, event_date AS cohort_date, ROW_NUMBER() OVER (PARTITION BY user_key ORDER BY event_date, template) AS rn FROM base), first_seen AS (SELECT user_key, template, cohort_date FROM ranked_first_seen WHERE rn = 1), cohorts AS (SELECT user_key, template, cohort_date FROM first_seen WHERE cohort_date <= ${daysAgoSql(14)} AND ${dashboardTimeRangeFilter("cohort_date")}), cohort_sizes AS (SELECT template, COUNT(DISTINCT user_key) AS users FROM cohorts GROUP BY template), retained AS (SELECT c.template, COUNT(DISTINCT c.user_key) AS retained FROM cohorts c JOIN base b ON b.user_key = c.user_key AND b.event_date >= to_char(c.cohort_date::date + INTERVAL '7 days', 'YYYY-MM-DD') AND b.event_date <= to_char(c.cohort_date::date + INTERVAL '14 days', 'YYYY-MM-DD') GROUP BY c.template) SELECT cs.template, COALESCE(r.retained, 0) AS retained_users, cs.users AS cohort_users, COALESCE(r.retained::float / NULLIF(cs.users, 0), 0) AS rate FROM cohort_sizes cs LEFT JOIN retained r ON r.template = cs.template WHERE cs.users >= ${PER_TEMPLATE_RETENTION_MIN_COHORT_SIZE} ORDER BY rate DESC, cs.users DESC, cs.template`;
 const SIGNUPS_BY_TEMPLATE_SQL = `SELECT ${TEMPLATE_EXPR} AS template, COUNT(*) AS count FROM analytics_events WHERE event_name = 'signup' AND ${DASHBOARD_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER} GROUP BY ${TEMPLATE_EXPR} ORDER BY count DESC`;
+const RECURRING_USERS_BY_TEMPLATE_SQL = `WITH all_users AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${EVENT_DATE_SQL}, user_id, ${TEMPLATE_EXPR} AS template FROM analytics_events WHERE ${SIGNED_IN_PRODUCT_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), first_seen AS (SELECT user_key, MIN(event_date) AS first_date FROM all_users GROUP BY user_key) SELECT a.event_date AS date, a.template AS template, COUNT(DISTINCT a.user_key) AS users FROM all_users a JOIN first_seen f ON f.user_key = a.user_key WHERE a.event_date <> f.first_date AND a.template <> 'unknown' AND ${dashboardTimeRangeFilter("a.event_date")} GROUP BY 1, 2 ORDER BY date, template`;
+const RECURRING_USERS_BY_TEMPLATE_WEEKLY_SQL = `WITH all_users AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${EVENT_DATE_SQL}, user_id, ${TEMPLATE_EXPR} AS template FROM analytics_events WHERE ${SIGNED_IN_PRODUCT_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), first_seen AS (SELECT user_key, MIN(event_date) AS first_date FROM all_users GROUP BY user_key) SELECT to_char(date_trunc('week', a.event_date::date), 'YYYY-MM-DD') AS date, a.template AS template, COUNT(DISTINCT a.user_key) AS users FROM all_users a JOIN first_seen f ON f.user_key = a.user_key WHERE a.event_date <> f.first_date AND a.template <> 'unknown' AND ${dashboardTimeRangeFilter("a.event_date")} GROUP BY 1, 2 ORDER BY date, template`;
 const DAU_BY_TEMPLATE_SQL = `SELECT ${EVENT_DATE_SQL} AS date, ${TEMPLATE_EXPR} AS template, COUNT(DISTINCT ${SIGNED_IN_ACTIVITY_KEY_SQL}) AS visitors FROM analytics_events WHERE ${SIGNED_IN_ACTIVITY_FILTER} AND ${DASHBOARD_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER} AND ${KNOWN_PRODUCT_ACTIVITY_TEMPLATE_FILTER} GROUP BY ${EVENT_DATE_SQL}, ${TEMPLATE_EXPR} ORDER BY date, template`;
 const WAU_BY_TEMPLATE_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS visitor_key, ${TEMPLATE_EXPR} AS template, ${EVENT_DATE_SQL} AS event_date, user_id FROM analytics_events WHERE ${SIGNED_IN_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER} AND ${KNOWN_PRODUCT_ACTIVITY_TEMPLATE_FILTER} AND ${DASHBOARD_WAU_BASE_RANGE_FILTER}), days AS (SELECT DISTINCT event_date AS date FROM base WHERE ${DASHBOARD_EVENT_DATE_RANGE_FILTER}) SELECT d.date, b.template, COUNT(DISTINCT b.visitor_key) AS visitors FROM days d JOIN base b ON b.event_date >= to_char(d.date::date - INTERVAL '6 days', 'YYYY-MM-DD') AND b.event_date <= d.date GROUP BY d.date, b.template ORDER BY d.date, b.template`;
 
@@ -664,6 +666,50 @@ const ENTRIES: FirstPartyMetric[] = [
         "Signed-in browser identities with non-docs app session activity on at least two days in the selected time range.",
     },
   },
+  {
+    key: "recurring-users-by-template",
+    title: "Recurring Signed-In Users by Template",
+    chartType: "area",
+    source: "first-party",
+    width: 2,
+    windowed: false,
+    buildSql: fixed(RECURRING_USERS_BY_TEMPLATE_SQL),
+    config: {
+      xKey: "date",
+      yKey: "users",
+      yFormatter: "number",
+      pivot: {
+        xKey: "date",
+        seriesKey: "template",
+        valueKey: "users",
+      },
+      stacked: true,
+      description:
+        "Daily signed-in visitors who are NOT on their all-time first active day (Recurring only), stacked by inferred template/app used that day. Docs traffic and unknown template are excluded.",
+    },
+  },
+  {
+    key: "recurring-users-by-template-bar",
+    title: "Recurring Signed-In Users by Template (Bar)",
+    chartType: "bar",
+    source: "first-party",
+    width: 1,
+    windowed: false,
+    buildSql: fixed(RECURRING_USERS_BY_TEMPLATE_WEEKLY_SQL),
+    config: {
+      xKey: "date",
+      yKey: "users",
+      yFormatter: "number",
+      pivot: {
+        xKey: "date",
+        seriesKey: "template",
+        valueKey: "users",
+      },
+      stacked: true,
+      description:
+        "Weekly distinct signed-in visitors who are NOT on their all-time first active day (Recurring only), stacked by inferred template/app used that week. Weeks start Monday; docs traffic and unknown template are excluded.",
+    },
+  },
   {
     key: "retention-over-time",
     title: "7d Rolling Signed-In Return Rate",

package/corpus/templates/analytics/server/lib/session-replay.ts

@@ -48,6 +48,12 @@ export interface ReplayScope {
   orgId: string | null;
 }
 
+export interface SessionReplayLinkResolution {
+  recordingId: string;
+  offsetMs: number;
+  path: string;
+}
+
 function rangeStartIso(range: ReplayRange): string | null {
   if (range === "all") return null;
   const hours =
@@ -1683,6 +1689,68 @@ export async function getSessionReplaySummary(
   return rowToSessionRecordingSummary(access.resource, access.role);
 }
 
+export async function resolveSessionReplayLink(
+  input: {
+    sessionId: string;
+    clientRecordingId: string;
+    at?: string | null;
+  },
+  scope: SessionReplayScope,
+): Promise<SessionReplayLinkResolution | null> {
+  const db = getDb() as any;
+  const [row] = await db
+    .select({
+      id: schema.sessionRecordings.id,
+      startedAt: schema.sessionRecordings.startedAt,
+      endedAt: schema.sessionRecordings.endedAt,
+      durationMs: schema.sessionRecordings.durationMs,
+      ownerEmail: schema.sessionRecordings.ownerEmail,
+      orgId: schema.sessionRecordings.orgId,
+      visibility: schema.sessionRecordings.visibility,
+      chunkCount: schema.sessionRecordings.chunkCount,
+      eventCount: schema.sessionRecordings.eventCount,
+      userId: schema.sessionRecordings.userId,
+      userKey: schema.sessionRecordings.userKey,
+    })
+    .from(schema.sessionRecordings)
+    .where(
+      and(
+        eq(schema.sessionRecordings.sessionId, input.sessionId),
+        eq(schema.sessionRecordings.clientRecordingId, input.clientRecordingId),
+        eq(schema.sessionRecordings.ownerEmail, scope.userEmail),
+        scope.orgId
+          ? eq(schema.sessionRecordings.orgId, scope.orgId)
+          : isNull(schema.sessionRecordings.orgId),
+      ),
+    )
+    .limit(1);
+
+  if (!row || !isVisibleSessionRecording(row)) return null;
+
+  const startedAtMs = Date.parse(row.startedAt);
+  if (!Number.isFinite(startedAtMs)) return null;
+  const requestedAtMs = input.at ? Date.parse(input.at) : Date.now();
+  const safeRequestedAtMs = Number.isFinite(requestedAtMs)
+    ? requestedAtMs
+    : startedAtMs;
+  const inferredDurationMs = row.endedAt
+    ? Math.max(0, Date.parse(row.endedAt) - startedAtMs)
+    : 0;
+  const durationMs =
+    typeof row.durationMs === "number" && Number.isFinite(row.durationMs)
+      ? Math.max(0, row.durationMs)
+      : inferredDurationMs;
+  const offsetMs = Math.max(
+    0,
+    Math.min(Math.max(0, safeRequestedAtMs - startedAtMs), durationMs),
+  );
+  return {
+    recordingId: row.id,
+    offsetMs,
+    path: `/sessions/${encodeURIComponent(row.id)}?atMs=${Math.round(offsetMs)}`,
+  };
+}
+
 export async function getSessionReplayTokenizedSummary(
   recordingId: string,
   viewerEmail: string,

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

@@ -704,6 +704,7 @@ export default createAgentChatPlugin({
       analyticsSourceGuidanceOpening() +
       "DASHBOARD CREATION RULE — You may create dashboards, analyses, SQL panels, or other resources only when the user explicitly asks you to (e.g. 'build me a dashboard for...', 'create a new analysis', 'add a chart for...'). Never create any resource proactively during research, trend analysis, or answering questions. If you think a dashboard would be useful, suggest it and wait for explicit confirmation before creating anything. Never add new items to the sidebar or modify existing dashboards without an explicit user directive. " +
       "DASHBOARD MUTATION RULE — For dashboard edits, default to `mutate-dashboard` with the typed `dashboard.*` script API so the main payload is a string and avoids native-array serialization traps. It can move panels by id, edit titles/SQL/config, insert, duplicate, remove, and patch dashboard fields in one atomic save. The script API is constrained: no variables/imports/loops/functions, only JSON-compatible arguments on documented dashboard methods. Do not count shifting `/panels/<index>` positions for ordinary dashboard edits unless the user specifically asks for low-level JSON-pointer operations. " +
+      "EXTENSION DATA-REPAIR RULE — When fixing data in an existing extension-backed dashboard or migrated surface such as Risk Meeting, inspect the current dashboard and extension first, then use `update-extension` `patches`/`edits` that change only the data-loading seam. Preserve the existing layout, CSS, copy, and interactions; never reconstruct the full HTML body for a data-only fix. Full-body replacement is blocked unless `allowFullReplacement=true`, which is reserved for an explicit visual rewrite or a complete replacement body supplied by the user. If a focused edit fails, change the target instead of retrying identical arguments. " +
       'FIRST-PARTY DASHBOARD TIME RULE — AI-generated `source: "first-party"` panels are dashboard-time-bound by default: set `config.timeScope` to `dashboard` and include a matching dashboard time predicate. `{{timeRange}}` requires a matching `filters` entry with `id: "timeRange"` and `type: "select"`; `{{<id>Start}}`/`{{<id>End}}` require a matching `type: "date-range"` filter with that id. Allowed `timeScope` values are `dashboard`, `fixed-window`, `cohort-history`, and `all-time`; use `all-time` only when the user requests full available history and put all-time, lifetime, or historical in the title or description. Server validation rejects unbound first-party SQL. ' +
       "DASHBOARD READ RULE — `get-sql-dashboard` is compact by default: use its `panels` summaries plus `layout.panelOrder`, `layout.firstPanelIds`, and `layout.groups[].rows[].rowNumber/panelIds` for orientation and verification. Pass `includeConfig: true` only when you truly need full panel SQL/config. " +
       'DASHBOARD REORDER RULE — For simple chart/section moves, use `mutate-dashboard` code such as `dashboard.panels(["panel-a","panel-b"]).moveToTop();`. For visible placement requests like "second row" or "next to return rates", use row-aware placement such as `dashboard.insertPanel({...}).nextTo("retention-over-time")`, `.atRow(2)`, or `dashboard.panel("panel-a").moveNextTo("panel-b")`; these keep panels in the intended rendered row and expand/rebalance that row when needed. Never count shifting `/panels/<index>` positions for ordinary \'move this chart\' requests. Use `get-sql-dashboard.layout.groups[].rows` as proof of visible row placement, not only flat `panelOrder`. ' +

package/corpus/templates/analytics/server/routes/sessions/lookup.get.ts

@@ -0,0 +1,47 @@
+import {
+  defineEventHandler,
+  getQuery,
+  sendRedirect,
+  setResponseStatus,
+} from "h3";
+
+import { runApiHandlerWithContext } from "../../lib/credentials";
+import { resolveSessionReplayLink } from "../../lib/session-replay.js";
+
+function queryString(value: unknown): string | null {
+  if (typeof value === "string" && value.trim()) return value.trim();
+  if (Array.isArray(value) && typeof value[0] === "string" && value[0].trim()) {
+    return value[0].trim();
+  }
+  return null;
+}
+
+export default defineEventHandler(async (event) => {
+  return runApiHandlerWithContext(event, async (ctx) => {
+    const query = getQuery(event);
+    const sessionId = queryString(query.sessionId);
+    const clientRecordingId = queryString(
+      query.clientRecordingId ?? query.replayId,
+    );
+    if (!sessionId || !clientRecordingId) {
+      setResponseStatus(event, 400);
+      return {
+        error: "sessionId and replayId are required",
+      };
+    }
+
+    const resolution = await resolveSessionReplayLink(
+      {
+        sessionId,
+        clientRecordingId,
+        at: queryString(query.at),
+      },
+      { userEmail: ctx.userEmail, orgId: ctx.orgId ?? null },
+    );
+    if (!resolution) {
+      setResponseStatus(event, 404);
+      return { error: "Session recording not found" };
+    }
+    return sendRedirect(event, resolution.path, 302);
+  });
+});

package/corpus/templates/assets/.agents/skills/asset-generation/SKILL.md

@@ -53,36 +53,43 @@ or generated image/video assets that another app can reference by ID and URL.
 
 ## Image Workflows
 
-1. For human-in-the-loop generation, call `generate-asset` first and preserve
+1. Read the `creative-context` skill and retrieve visual references separately
+   from factual evidence. Respect `contextMode: "off"`, pinned packs, and the
+   exact reuse ladder before generation: approved native asset unchanged,
+   compose approved pieces, lightly adapt a real example, condition generation
+   on narrow references, then net-new only when the relevant corpus is empty.
+2. For human-in-the-loop generation, call `generate-asset` first and preserve
    the returned picker/candidate metadata. For unattended generation, pick or
    match the library with `list-libraries` or `match-library`.
    If the user wants a default look rather than a brand library, call
    `list-library-presets` and then `create-library-from-preset`; the resulting
    library is editable and reusable like any other library.
-2. For one asset, call `generate-image`; for multiple independent slots, call
+3. For one asset, call `generate-image`; for multiple independent slots, call
    `generate-image-batch` with stable `slotId` values.
-3. Image generation actions are synchronous. After `generate-image` or
+4. Image generation actions are synchronous. After `generate-image` or
    `generate-image-batch` returns, use its returned `images` / asset fields
    directly; do not call `get-generation-run`, `refresh-generation-run`, or
    regenerate just to verify image runs.
-4. For preset-backed work, pass a mentioned or selected `presetId`; for handoff
+5. For preset-backed work, pass a mentioned or selected `presetId`; for handoff
    work, pass `sessionId`.
-5. Let the server choose a small deterministic reference set unless the user
+6. Let the server choose a small deterministic reference set unless the user
    named exact assets. Canonical style anchors come from
    `assetLibraries.settings.canonicalStyleAssetIds` and
    `assets.metadata.isStyleAnchor`.
-6. Pass `tier: "fast"` for exploration, `tier: "best"` for final/high-value
+7. Pass `tier: "fast"` for exploration, `tier: "best"` for final/high-value
    output, or `tier: "auto"` when there is no clear preference.
    - Model/ratio compatibility: Gemini image models accept any `aspectRatio`, but
      `gpt-image-2` supports only `1:1`, `2:3`, and `3:2`. When the user needs
      another ratio (16:9, 9:16, 4:5, 21:9, …), pick a Gemini model rather than
      `gpt-image-2` — an unsupported pairing is rejected upstream. Source of truth
      is `supportedAspectRatiosForModel` / `MODEL_ASPECT_RATIOS` in `shared/api.ts`.
-7. Preserve returned `assetId`, `runId`, `previewUrl`, and `downloadUrl`.
-8. Use `refine-image` for feedback on an existing asset, `edit-image` for
+8. Preserve returned `assetId`, `runId`, `previewUrl`, and `downloadUrl`.
+   Preserve the immutable `contextPackId` and reuse labels on both generation
+   run and output-asset metadata; rendered pixels are not provenance.
+9. Use `refine-image` for feedback on an existing asset, `edit-image` for
    targeted changes, and `restyle-image` with `subjectAssetId` and
    `styleStrength` for subject-preserving brand restyles.
-9. If a designer will take over, call `create-generation-session` or
+10. If a designer will take over, call `create-generation-session` or
    `update-generation-session`, then `prepare-generation-session-continuation`
    when they want a chat preloaded with the session context.
 

package/corpus/templates/assets/.agents/skills/creative-context/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: creative-context
+description: >-
+  Reuse creative context across generation while respecting explicit context
+  choices, pinned packs, provenance, and opt-out state.
+scope: app
+metadata:
+  internal: true
+---
+
+# Creative Context
+
+Use the shared creative-context library to reuse verified source material
+without turning prior work into an invisible global prompt.
+
+## Reuse ladder
+
+Apply the first viable option in this exact order:
+
+1. Reuse an approved native asset, component, or template unchanged.
+2. Compose approved native pieces without flattening or recreating them.
+3. Duplicate and lightly adapt a real approved example.
+4. Generate new work conditioned on narrowly retrieved references.
+5. Generate net-new work only when the relevant corpus is empty.
+
+Do not skip directly to imitation or net-new generation when an approved native
+primitive already fits.
+
+## Retrieval procedure
+
+Retrieve context in this order, stopping as soon as the current request is
+sufficiently grounded. Keep factual evidence, visual/style references,
+voice/terminology, and structural/layout examples in separate queries so one
+role cannot silently stand in for another:
+
+1. Follow the user's explicit instructions and the object currently selected in
+   the app.
+2. Read the `creative-context` application-state record. If
+   `pinnedPackId` is set, prefer that immutable pack. Otherwise use
+   `currentPackId` when it records context already selected for this session.
+3. Call `search-creative-context` with a narrow query for exact facts, visual
+   language, audience guidance, prior decisions, or reusable references.
+4. Call `get-context-item` only for the specific search result versions
+   needed for the work. Preserve source and version provenance.
+5. Fall back to app-local design systems, assets, documents, and current-user
+   instructions when the shared library has no relevant evidence.
+
+Do not load the whole library or paste large source dumps into a prompt.
+Context packs are generation snapshots; do not silently rewrite a historical
+pack after it has been used.
+
+For an inbound Creative Context machine-protocol A2A request, call
+`creative-context-a2a` exactly once with its opaque `requestToken`, then return
+the action's `responseToken` verbatim. Never decode or broaden the request.
+
+## Context opt-out
+
+The single state key is `creative-context`:
+
+```json
+{
+  "contextMode": "auto",
+  "currentPackId": null,
+  "pinnedPackId": null
+}
+```
+
+When `contextMode` is `off`, do not search, select, or apply saved creative
+context for subsequent generations. Do not restore a previous pack
+automatically. Historical output may keep its original pack provenance. A
+one-turn instruction such as "ignore the library for this version" wins for
+that turn, but does not change the saved preference unless the user asks.
+
+When the user corrects reused context, call `record-context-feedback` against
+the exact item/version and signal whether it was unhelpful, incorrect, or
+outdated. Never invent a source or silently overwrite source history.
+
+## Assets reuse
+
+Search visual references separately from factual evidence. When a retrieved
+image should directly guide generation, import its stable media URL with
+`import-asset-from-url` as a reference asset in the selected brand kit, then
+pass that asset id through the normal `referenceAssetIds` path. Do not pass a
+context-item URL directly to an image provider. Keep the returned
+`contextPackId` and reuse labels in generation-run and output-asset metadata
+alongside the normal reference selection provenance.

package/corpus/templates/assets/AGENTS.md

@@ -40,6 +40,13 @@ Detailed library, generation, image, embed, and engine rules live in
 
 ## Application State
 
+- Before generation, follow the creative-context reuse ladder in
+  `.agents/skills/creative-context/SKILL.md`: explicit request and current
+  asset/kit first, then a pinned/current pack, then narrow library search.
+  Respect `creative-context.contextMode: "off"` without silently restoring a
+  pack. This shared Agent-page Library does not replace Assets' existing
+  `/library` media workflow.
+
 - `navigation` exposes library, asset, generation, picker, embed, and selection
   context. Human Library state uses
   `{ view: "library", selection: "all" | libraryId, tab, scope, folderId, search }`.
@@ -110,6 +117,9 @@ prompt, aspectRatio }`.
 
 ## Skills
 
+- `creative-context` for cross-app source reuse, pinned packs, provenance, and
+  context opt-out.
+
 Read the relevant skill before deeper work:
 
 - `library-management`, `asset-generation`, `image-generation`, and

package/corpus/templates/assets/actions/create-generation-session.ts

@@ -1,6 +1,11 @@
 import { defineAction } from "@agent-native/core";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";
+import {
+  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";
@@ -23,8 +28,26 @@ export default defineAction({
     runIds: z.array(z.string()).optional(),
     feedback: z.string().optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
+    contextModeOverride: z
+      .literal("off")
+      .optional()
+      .describe(
+        "Disable Creative Context for this generation session only without changing the saved preference.",
+      ),
   }),
   run: async (args) => {
+    const creativeContext = await resolveGenerationCreativeContext({
+      query: [args.title, args.brief].filter(Boolean).join("\n"),
+      role: "assets",
+      contextModeOverride: args.contextModeOverride,
+    });
+    const reuseLabels =
+      creativeContext.reuseLabels as CreativeContextReuseLabel[];
+    const creativeContextProvenance = {
+      contextMode: creativeContext.contextMode,
+      contextPackId: creativeContext.contextPackId,
+      reuseLabels,
+    };
     await assertAccess("asset-library", args.libraryId, "editor");
     const db = getDb();
     if (args.collectionId) {
@@ -104,6 +127,7 @@ export default defineAction({
       feedbackSummary: args.feedback ?? "",
       metadata: stringifyJson({
         ...(args.metadata ?? {}),
+        creativeContext: creativeContextProvenance,
         feedbackHistory: args.feedback
           ? [{ at: now, feedback: args.feedback }]
           : [],
@@ -140,6 +164,40 @@ export default defineAction({
       });
       sortOrder += 10;
     }
-    return serializeGenerationSession(session);
+    await recordGenerationCreativeContext(
+      {
+        appId: "assets",
+        artifactType: "generation-session",
+        artifactId: session.id,
+        ...creativeContextProvenance,
+        elementProvenance: reuseLabels.length
+          ? reuseLabels.map((label) => ({
+              elementId: session.id,
+              influence: label.influence ?? ("reference-conditioned" as const),
+              ...(label.itemId ? { itemId: label.itemId } : {}),
+              ...(label.itemVersionId
+                ? { itemVersionId: label.itemVersionId }
+                : {}),
+              label: label.label,
+            }))
+          : [
+              {
+                elementId: session.id,
+                influence: "generated",
+                label: "Asset generation session",
+              },
+            ],
+      },
+      {
+        artifactAccess: {
+          resourceType: "asset-library",
+          resourceId: args.libraryId,
+        },
+      },
+    );
+    return {
+      ...serializeGenerationSession(session),
+      ...creativeContextProvenance,
+    };
   },
 });

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

@@ -21,6 +21,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) => {
@@ -42,6 +43,7 @@ export default defineAction({
       slotId: args.slotId,
       source: args.source,
       callerAppId: args.callerAppId,
+      contextModeOverride: args.contextModeOverride,
     });
   },
 });

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

@@ -1,5 +1,11 @@
 import { defineAction, embedApp } from "@agent-native/core";
 import type { ActionRunContext } from "@agent-native/core/action";
+import {
+  recordGenerationCreativeContext,
+  resolveGenerationCreativeContext,
+} from "@agent-native/creative-context/server";
+import type { CreativeContextReuseLabel } from "@agent-native/creative-context/types";
+import { nanoid } from "nanoid";
 import { z } from "zod";
 
 import {
@@ -57,6 +63,12 @@ const schema = z.object({
     .string()
     .optional()
     .describe("Calling app id, for audit grouping, e.g. design."),
+  contextModeOverride: z
+    .literal("off")
+    .optional()
+    .describe(
+      "Disable Creative Context for this picker generation only without changing the saved preference.",
+    ),
 });
 
 type ActionWithToolParameters = {
@@ -122,6 +134,42 @@ const action = defineAction({
     };
   },
   run: async (args, context?: ActionRunContext) => {
+    const creativeContext = await resolveGenerationCreativeContext({
+      query: args.prompt,
+      role: "assets",
+      contextModeOverride: args.contextModeOverride,
+    });
+    const reuseLabels =
+      creativeContext.reuseLabels as CreativeContextReuseLabel[];
+    const creativeContextProvenance = {
+      contextMode: creativeContext.contextMode,
+      contextPackId: creativeContext.contextPackId,
+      reuseLabels,
+    };
+    const creativeContextRequestId = nanoid();
+    await recordGenerationCreativeContext({
+      appId: "assets",
+      artifactType: "generation-request",
+      artifactId: creativeContextRequestId,
+      ...creativeContextProvenance,
+      elementProvenance: reuseLabels.length
+        ? reuseLabels.map((label) => ({
+            elementId: creativeContextRequestId,
+            influence: label.influence ?? ("reference-conditioned" as const),
+            ...(label.itemId ? { itemId: label.itemId } : {}),
+            ...(label.itemVersionId
+              ? { itemVersionId: label.itemVersionId }
+              : {}),
+            label: label.label,
+          }))
+        : [
+            {
+              elementId: creativeContextRequestId,
+              influence: "generated",
+              label: "Asset generation request",
+            },
+          ],
+    });
     if (args.mediaType === "video") {
       const picker = (await openAssetPicker.run(
         {
@@ -131,6 +179,7 @@ const action = defineAction({
           libraryHint: args.libraryHint,
           count: args.count,
           callerAppId: args.callerAppId,
+          creativeContextRequestId,
         },
         context,
       )) as Record<string, unknown>;
@@ -139,6 +188,7 @@ const action = defineAction({
         generated: false,
         message:
           "Assets video picker is ready. Generate or select the video in the picker, then choose the asset to send it back.",
+        ...creativeContextProvenance,
       };
     }
 
@@ -156,6 +206,7 @@ const action = defineAction({
         styleStrength: args.styleStrength,
         includeLogo: args.includeLogo,
         callerAppId: args.callerAppId,
+        creativeContextRequestId,
       },
       context,
     )) as Record<string, unknown>;
@@ -166,6 +217,7 @@ const action = defineAction({
       generationMode: "picker-auto-generate",
       message:
         "Assets picker is ready and will start image generation inside the picker. If this org has no libraries yet, the picker will create a starter library first. Ask the user to pick one candidate; preserve the chosen assetId, runId, and URLs exactly.",
+      ...creativeContextProvenance,
     };
   },
 });

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

@@ -1,6 +1,11 @@
 import { defineAction } from "@agent-native/core";
 import type { ActionRunContext } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
+import {
+  recordGenerationCreativeContext,
+  resolveGenerationCreativeContext,
+} from "@agent-native/creative-context/server";
+import type { CreativeContextReuseLabel } from "@agent-native/creative-context/types";
 import { eq } from "drizzle-orm";
 import { nanoid } from "nanoid";
 import pLimit from "p-limit";
@@ -117,6 +122,18 @@ export default defineAction({
       .describe(
         "Set by A2A callers (e.g. 'slides', 'design') so audit logs can filter by app.",
       ),
+    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 batch only without changing the saved preference.",
+      ),
   }),
   parallelSafe: true,
   timeoutMs: IMAGE_GENERATION_TOOL_TIMEOUT_MS,
@@ -135,6 +152,42 @@ export default defineAction({
     if (base.sessionId) {
       await requireGenerationSessionInLibrary(base.sessionId, base.libraryId);
     }
+    const creativeContextRequestId =
+      base.creativeContextRequestId ?? (base.sessionId ? undefined : nanoid());
+    if (!base.creativeContextRequestId && creativeContextRequestId) {
+      const creativeContext = await resolveGenerationCreativeContext({
+        query: slots.map((slot) => slot.prompt).join("\n"),
+        role: "assets",
+        contextModeOverride: base.contextModeOverride,
+      });
+      const reuseLabels =
+        creativeContext.reuseLabels as CreativeContextReuseLabel[];
+      await recordGenerationCreativeContext({
+        appId: "assets",
+        artifactType: "generation-request",
+        artifactId: creativeContextRequestId,
+        contextMode: creativeContext.contextMode,
+        contextPackId: creativeContext.contextPackId,
+        reuseLabels,
+        elementProvenance: reuseLabels.length
+          ? reuseLabels.map((label) => ({
+              elementId: creativeContextRequestId,
+              influence: label.influence ?? ("reference-conditioned" as const),
+              ...(label.itemId ? { itemId: label.itemId } : {}),
+              ...(label.itemVersionId
+                ? { itemVersionId: label.itemVersionId }
+                : {}),
+              label: label.label,
+            }))
+          : [
+              {
+                elementId: creativeContextRequestId,
+                influence: "generated",
+                label: "Image batch request",
+              },
+            ],
+      });
+    }
     const variantBatchId = nanoid();
     await Promise.all(
       slots.map((slot, index) =>
@@ -185,6 +238,8 @@ export default defineAction({
               subjectAssetId: slot.subjectAssetId,
               source: base.source,
               callerAppId: base.callerAppId,
+              creativeContextRequestId,
+              contextModeOverride: base.contextModeOverride,
               activateSessionAsset: false,
             },
             context,