@agent-native/core 0.103.1 → 0.105.0

package/corpus/templates/clips/server/plugins/db.ts

@@ -104,7 +104,7 @@ const migrations = runMigrations(
       slug TEXT NOT NULL,
       brand_color TEXT NOT NULL DEFAULT '#18181B',
       brand_logo_url TEXT,
-      default_visibility TEXT NOT NULL DEFAULT 'private',
+      default_visibility TEXT NOT NULL DEFAULT 'public',
       created_at TEXT NOT NULL DEFAULT (datetime('now')),
       updated_at TEXT NOT NULL DEFAULT (datetime('now')),
       owner_email TEXT NOT NULL DEFAULT 'local@localhost',
@@ -348,7 +348,7 @@ const migrations = runMigrations(
       organization_id TEXT PRIMARY KEY,
       brand_color TEXT NOT NULL DEFAULT '#18181B',
       brand_logo_url TEXT,
-      default_visibility TEXT NOT NULL DEFAULT 'private',
+      default_visibility TEXT NOT NULL DEFAULT 'public',
       created_at TEXT NOT NULL DEFAULT (datetime('now')),
       updated_at TEXT NOT NULL DEFAULT (datetime('now'))
     )`,

package/corpus/templates/clips/server/routes/api/auth/google-calendar.get.ts

@@ -44,7 +44,7 @@ export default defineEventHandler(async (event: H3Event) => {
     return {
       error: "missing_credentials",
       message:
-        "Google Calendar OAuth is not configured. Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in your environment, or paste them in the agent settings.",
+        "Google Calendar OAuth is not configured. Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in your environment, or paste them in the agent workspace.",
     };
   }
 

package/corpus/templates/clips/server/routes/api/public-recording.get.ts

@@ -19,6 +19,7 @@ import {
   signShortLivedToken,
   verifyScopedAgentAccessToken,
 } from "@agent-native/core/server";
+import { resolveAccess } from "@agent-native/core/sharing";
 import { asc, eq } from "drizzle-orm";
 import {
   defineEventHandler,
@@ -45,7 +46,6 @@ import { resolvePlayerVideoUrl } from "../../lib/player-video-url.js";
 import {
   getOrganizationRoleForEmail,
   parseSpaceIds,
-  sameOwnerEmail,
 } from "../../lib/recordings.js";
 import { verifySharePassword } from "../../lib/share-password.js";
 
@@ -211,9 +211,6 @@ export default defineEventHandler(async (event) => {
   }
 
   const session = await getSession(event).catch(() => null);
-  const viewerIsOwner = Boolean(
-    session?.email && sameOwnerEmail(session.email, rec.ownerEmail),
-  );
   const tokenAllowsAgentAccess = suppliedAgentAccessToken
     ? verifyScopedAgentAccessToken(suppliedAgentAccessToken, {
         resourceKind: CLIP_AGENT_ACCESS_TOKEN_PREFIX,
@@ -221,6 +218,18 @@ export default defineEventHandler(async (event) => {
       }).ok
     : false;
 
+  // Share links are public-shell routes, so this endpoint cannot rely on the
+  // authenticated player action to authorize private recordings. Resolve the
+  // same registered access policy here so explicit user/org grants work before
+  // the client redirects to the direct player route.
+  const viewerAccess = session?.email
+    ? await resolveAccess("recording", rec.id, {
+        userEmail: session.email,
+        orgId: session.orgId,
+      })
+    : null;
+  const viewerIsOwner = viewerAccess?.role === "owner";
+
   let viewerIsOrgMember = false;
   if (session?.email && rec.visibility === "org" && rec.organizationId) {
     try {
@@ -238,7 +247,7 @@ export default defineEventHandler(async (event) => {
 
   if (
     rec.visibility !== "public" &&
-    !viewerIsOwner &&
+    !viewerAccess &&
     !viewerIsOrgMember &&
     !tokenAllowsAgentAccess
   ) {

package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/chunk.post.ts

@@ -196,6 +196,9 @@ export default defineEventHandler(async (event: H3Event) => {
         status: schema.recordings.status,
         failureReason: schema.recordings.failureReason,
         ownerEmail: schema.recordings.ownerEmail,
+        videoUrl: schema.recordings.videoUrl,
+        videoSizeBytes: schema.recordings.videoSizeBytes,
+        durationMs: schema.recordings.durationMs,
       })
       .from(schema.recordings)
       .where(
@@ -255,7 +258,18 @@ export default defineEventHandler(async (event: H3Event) => {
     // Already finalized — retried final chunk after session was deleted. Skip
     // buffered path writes so recording-upload-* state stays correct.
     if (existing.status === "ready") {
-      return { ok: true, finalized: true };
+      const readyState = await readAppState(
+        `recording-upload-${recordingId}`,
+      ).catch(() => null);
+      return {
+        ok: true,
+        finalized: true,
+        status: "ready" as const,
+        videoUrl: existing.videoUrl,
+        videoSizeBytes: existing.videoSizeBytes,
+        durationMs: existing.durationMs,
+        sourceSizeBytes: stateNumber(readyState, "sourceSizeBytes"),
+      };
     }
 
     // Store chunks in application_state, assemble on finalize.
@@ -569,6 +583,7 @@ export default defineEventHandler(async (event: H3Event) => {
             id: schema.recordings.id,
             status: schema.recordings.status,
             videoUrl: schema.recordings.videoUrl,
+            videoSizeBytes: schema.recordings.videoSizeBytes,
             durationMs: schema.recordings.durationMs,
             width: schema.recordings.width,
             height: schema.recordings.height,
@@ -590,12 +605,26 @@ export default defineEventHandler(async (event: H3Event) => {
               error: err instanceof Error ? err.message : String(err),
             },
           );
+          const priorReadyStateRaw = await readAppState(
+            `recording-upload-${recordingId}`,
+          ).catch(() => null);
+          const priorReadyState =
+            priorReadyStateRaw && typeof priorReadyStateRaw === "object"
+              ? (priorReadyStateRaw as Record<string, unknown>)
+              : {};
+          const sourceSizeBytes =
+            stateNumber(priorReadyState, "sourceSizeBytes") ??
+            stateNumber(priorReadyState, "bytesReceived");
           try {
             await writeAppState(`recording-upload-${recordingId}`, {
+              ...priorReadyState,
               recordingId,
               status: "ready",
               progress: 100,
               videoUrl: committed.videoUrl,
+              videoSizeBytes: committed.videoSizeBytes,
+              sourceSizeBytes,
+              durationMs: committed.durationMs,
               finishedAt: new Date().toISOString(),
             });
           } catch (stateErr) {
@@ -612,6 +641,8 @@ export default defineEventHandler(async (event: H3Event) => {
             id: committed.id,
             status: "ready",
             videoUrl: committed.videoUrl,
+            videoSizeBytes: committed.videoSizeBytes,
+            sourceSizeBytes,
             durationMs: committed.durationMs,
             width: committed.width,
             height: committed.height,
@@ -709,6 +740,7 @@ async function handleResumableChunk(
 
   const raw = await readRawBody(event, false);
   const bytes: Uint8Array = raw ?? new Uint8Array(0);
+  let finalizedSourceSizeBytes = session.bytesUploaded;
 
   if (!isFinal && bytes.byteLength === 0) {
     throw createError({ statusCode: 400, message: "Empty chunk body" });
@@ -806,6 +838,7 @@ async function handleResumableChunk(
         bytesUploaded: start + bytes.byteLength,
         lastCommittedIndex: index,
       });
+      finalizedSourceSizeBytes = start + bytes.byteLength;
 
       if (!isFinal) {
         return { ok: true, finalized: false, index, bytes: bytes.byteLength };
@@ -838,6 +871,7 @@ async function handleResumableChunk(
         id: schema.recordings.id,
         status: schema.recordings.status,
         videoUrl: schema.recordings.videoUrl,
+        videoSizeBytes: schema.recordings.videoSizeBytes,
         durationMs: schema.recordings.durationMs,
         width: schema.recordings.width,
         height: schema.recordings.height,
@@ -856,11 +890,25 @@ async function handleResumableChunk(
         `[resumable-chunk-${recordingId}] finalize reported an error after committing a ready recording; returning committed success.`,
         { error: err instanceof Error ? err.message : String(err) },
       );
+      const priorReadyStateRaw = await readAppState(
+        `recording-upload-${recordingId}`,
+      ).catch(() => null);
+      const priorReadyState =
+        priorReadyStateRaw && typeof priorReadyStateRaw === "object"
+          ? (priorReadyStateRaw as Record<string, unknown>)
+          : {};
+      const sourceSizeBytes =
+        stateNumber(priorReadyState, "sourceSizeBytes") ??
+        finalizedSourceSizeBytes;
       await writeAppState(`recording-upload-${recordingId}`, {
+        ...priorReadyState,
         recordingId,
         status: "ready",
         progress: 100,
         videoUrl: committed.videoUrl,
+        videoSizeBytes: committed.videoSizeBytes,
+        sourceSizeBytes,
+        durationMs: committed.durationMs,
         finishedAt: new Date().toISOString(),
       }).catch((stateErr) =>
         console.warn(
@@ -875,6 +923,8 @@ async function handleResumableChunk(
         id: committed.id,
         status: "ready",
         videoUrl: committed.videoUrl,
+        videoSizeBytes: committed.videoSizeBytes,
+        sourceSizeBytes,
         durationMs: committed.durationMs,
         width: committed.width,
         height: committed.height,

package/corpus/templates/clips/server/routes/api/video/[recordingId].get.ts

@@ -64,7 +64,6 @@ import {
   loomEmbedUrlForRecording,
 } from "../../../../shared/loom.js";
 import { getDb, schema } from "../../../db/index.js";
-import { builderCompressedMediaUrl } from "../../../lib/builder-media-compression.js";
 import { getOrganizationRoleForEmail } from "../../../lib/recordings.js";
 import { verifySharePassword } from "../../../lib/share-password.js";
 
@@ -89,8 +88,6 @@ const PROXIED_HEADER_NAMES = [
 const PROVIDER_MEDIA_FETCH_TIMEOUT_MS = 30_000;
 const PROTECTED_MEDIA_ACCESS_TTL_SECONDS = 6 * 60 * 60;
 const PROTECTED_MEDIA_COOKIE_PREFIX = "clips_media_";
-const COMPRESSED_BUILDER_MEDIA_MISS_TTL_MS = 5_000;
-const compressedBuilderMediaMisses = new Map<string, number>();
 
 function appPath(path: string): string {
   if (!path.startsWith("/")) return path;
@@ -150,42 +147,6 @@ function isRecursiveVideoRouteUrl(value: string, recordingId: string): boolean {
   }
 }
 
-function shouldSkipCompressedBuilderMediaProbe(
-  compressedSourceUrl: string,
-): boolean {
-  const expiresAt = compressedBuilderMediaMisses.get(compressedSourceUrl);
-  if (!expiresAt) return false;
-  if (expiresAt <= Date.now()) {
-    compressedBuilderMediaMisses.delete(compressedSourceUrl);
-    return false;
-  }
-  return true;
-}
-
-function rememberCompressedBuilderMediaMiss(compressedSourceUrl: string): void {
-  if (compressedBuilderMediaMisses.size > 1_000) {
-    for (const [url, expiresAt] of compressedBuilderMediaMisses) {
-      if (expiresAt <= Date.now()) compressedBuilderMediaMisses.delete(url);
-    }
-  }
-  compressedBuilderMediaMisses.set(
-    compressedSourceUrl,
-    Date.now() + COMPRESSED_BUILDER_MEDIA_MISS_TTL_MS,
-  );
-}
-
-function shouldFallbackToOriginalMedia(
-  upstream: Response | { error: string; status: number },
-): boolean {
-  return upstream.status >= 500 || [403, 404, 416].includes(upstream.status);
-}
-
-function shouldRememberCompressedBuilderMediaMiss(
-  upstream: Response | { error: string; status: number },
-): boolean {
-  return upstream.status >= 500 || [403, 404].includes(upstream.status);
-}
-
 async function fetchProviderMedia(
   sourceUrl: string,
   rangeHeader: string | undefined,
@@ -492,31 +453,7 @@ export default defineEventHandler(async (event: H3Event) => {
 
         let upstream: Response | { error: string; status: number };
         try {
-          const compressedSourceUrl = builderCompressedMediaUrl(sourceUrl);
-          if (
-            compressedSourceUrl &&
-            !shouldSkipCompressedBuilderMediaProbe(compressedSourceUrl)
-          ) {
-            try {
-              upstream = await fetchProviderMedia(
-                compressedSourceUrl,
-                rangeHeader,
-              );
-            } catch (err) {
-              upstream = {
-                status: statusCodeForProviderFetchError(err),
-                error: messageForProviderFetchError(err),
-              };
-            }
-            if (shouldRememberCompressedBuilderMediaMiss(upstream)) {
-              rememberCompressedBuilderMediaMiss(compressedSourceUrl);
-            }
-            if (shouldFallbackToOriginalMedia(upstream)) {
-              upstream = await fetchProviderMedia(sourceUrl, rangeHeader);
-            }
-          } else {
-            upstream = await fetchProviderMedia(sourceUrl, rangeHeader);
-          }
+          upstream = await fetchProviderMedia(sourceUrl, rangeHeader);
         } catch (err) {
           setResponseStatus(event, statusCodeForProviderFetchError(err));
           return { error: messageForProviderFetchError(err) };

package/corpus/templates/clips/shared/media-worker-contract.ts

@@ -18,13 +18,21 @@ export interface MediaWorkerJob {
   callback: { url: string };
 }
 
-export interface MediaWorkerCallback {
-  jobId: string;
-  status: "done" | "failed";
-  outputUrl?: string;
-  error?: string;
-  durationMs?: number;
-}
+export type MediaWorkerCallback =
+  | {
+      jobId: string;
+      status: "done";
+      outputUrl?: string;
+      error?: string;
+      durationMs: number;
+    }
+  | {
+      jobId: string;
+      status: "failed";
+      outputUrl?: string;
+      error?: string;
+      durationMs?: number;
+    };
 
 export interface MediaWorkerSignatureHeaders {
   [MEDIA_WORKER_TIMESTAMP_HEADER]: string;
@@ -125,22 +133,31 @@ export function parseMediaWorkerCallback(
     return null;
   }
   if (body.error !== undefined && typeof body.error !== "string") return null;
+  const durationMs =
+    typeof body.durationMs === "number" && Number.isFinite(body.durationMs)
+      ? Math.round(body.durationMs)
+      : undefined;
+  if (body.status === "done") {
+    if (durationMs === undefined || durationMs <= 0) return null;
+    return {
+      jobId: body.jobId,
+      status: "done",
+      outputUrl: body.outputUrl,
+      error: body.error,
+      durationMs,
+    };
+  }
   if (
     body.durationMs !== undefined &&
-    (typeof body.durationMs !== "number" ||
-      !Number.isFinite(body.durationMs) ||
-      body.durationMs < 0)
+    (durationMs === undefined || durationMs < 0)
   ) {
     return null;
   }
   return {
     jobId: body.jobId,
-    status: body.status,
+    status: "failed",
     outputUrl: body.outputUrl,
     error: body.error,
-    durationMs:
-      typeof body.durationMs === "number"
-        ? Math.round(body.durationMs)
-        : undefined,
+    durationMs,
   };
 }

package/corpus/templates/content/.agents/skills/content/SKILL.md

@@ -21,6 +21,12 @@ actions, and local folders that sync into the same database model.
 
 ## Choose The Path
 
+- Before drafting or materially rewriting, read the `creative-context` skill.
+  Retrieve voice, terminology, audience guidance, and factual evidence as
+  separate roles; respect opt-out and pinned packs. Apply the exact reuse
+  ladder: approved native template/asset unchanged, compose approved pieces,
+  lightly adapt a real example, generate from narrow references, then net-new
+  only when the relevant corpus is empty.
 - Use Content actions when the Content MCP/action tools are available:
   `list-documents`, `search-documents`, `get-document`, `pull-document`,
   `create-document`, `edit-document`, `update-document`, `delete-document`,
@@ -41,6 +47,16 @@ actions, and local folders that sync into the same database model.
   `.md`/`.mdx` files directly, preserve frontmatter and MDX imports, and tell
   the user the Content action surface was not available.
 
+Retrieval is separate from drafting. Exact source item versions may support
+claims; voice examples alone may not. Persist the immutable `contextPackId` and
+reuse labels with document generation provenance so later edits can explain
+what influenced the copy.
+
+For `create-document`, pass the pre-drafting search result's `contextPackId`
+and exact `reuseLabels`. Do not let the final write action search after the
+document body has already been authored; post-hoc search is not provenance.
+Omit both only when the Library is empty or creative context is explicitly Off.
+
 ## Action Examples
 
 Prefer JSON input for action calls:

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

@@ -0,0 +1,85 @@
+---
+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.
+
+## Content reuse
+
+Search voice, terminology, audience, and factual evidence as separate intents.
+Use voice/style examples to guide phrasing, but only exact evidence item
+versions may support factual claims. Preserve the returned `contextPackId`
+and short reuse labels with the document generation provenance. A published
+brand profile can guide tone automatically; it never overrides the user's
+current brief, and it must not turn an unsupported prior claim into a fact.

package/corpus/templates/content/.agents/skills/notion-integration/SKILL.md

@@ -9,6 +9,14 @@ description: >-
 
 The content app can sync documents bidirectionally with Notion. Documents can be linked to Notion pages, pulled from Notion, or pushed to Notion.
 
+Notion sync is not creative-context retrieval. When drafting new copy from a
+synced page, read the `creative-context` skill first and retrieve voice,
+terminology, audience guidance, and factual evidence as separate roles. Apply
+its exact reuse ladder, respect opt-out/pinned packs, and use app-local Notion
+content as the fallback when the shared corpus has no relevant evidence. Keep
+the resulting immutable `contextPackId` and reuse labels with document
+generation provenance; never infer them from a later Notion sync snapshot.
+
 ## Scripts
 
 ### connect-notion-status

package/corpus/templates/content/AGENTS.md

@@ -38,6 +38,12 @@ Detailed document editing, Notion, storage, and UI rules live in
 
 ## Application State
 
+- Before generation, follow the creative-context reuse ladder in
+  `.agents/skills/creative-context/SKILL.md`: explicit request and current
+  document first, then a pinned/current pack, then narrow library search.
+  Respect `creative-context.contextMode: "off"` without silently restoring a
+  pack.
+
 - `navigation` exposes document, selected block, comment, media, and Notion view
   context.
 - `navigate` moves the UI to documents, comments, media, and settings surfaces.
@@ -45,6 +51,9 @@ Detailed document editing, Notion, storage, and UI rules live in
 
 ## Skills
 
+- `creative-context` for cross-app source reuse, pinned packs, provenance, and
+  context opt-out.
+
 Read the relevant skill before deeper work:
 
 - `document-editing` for structured document updates.

package/corpus/templates/content/actions/create-document.ts

@@ -6,6 +6,10 @@ import {
   getRequestOrgId,
 } from "@agent-native/core/server/request-context";
 import { assertAccess, type ShareRole } from "@agent-native/core/sharing";
+import {
+  recordGenerationCreativeContext,
+  validateGenerationCreativeContext,
+} from "@agent-native/creative-context/server";
 import { and, eq, sql } from "drizzle-orm";
 import { z } from "zod";
 
@@ -28,6 +32,34 @@ function nanoid(size = 12): string {
   return id;
 }
 
+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) => {
+    const influence = label.influence ?? "reference-conditioned";
+    if (Boolean(label.itemId) !== Boolean(label.itemVersionId)) {
+      context.addIssue({
+        code: "custom",
+        message: "itemId and itemVersionId must be provided together",
+      });
+    }
+    if (influence !== "generated" && !label.itemId) {
+      context.addIssue({
+        code: "custom",
+        message: "Only generated labels may omit context item ids",
+      });
+    }
+  });
+
 export default defineAction({
   description: "Create a new document.",
   schema: z.object({
@@ -49,6 +81,21 @@ export default defineAction({
       ),
     parentId: z.string().nullish().describe("Parent document ID for nesting"),
     icon: z.string().optional().describe("Emoji icon"),
+    contextPackId: z
+      .string()
+      .optional()
+      .describe("Immutable pack returned by pre-generation context search"),
+    contextModeOverride: z
+      .literal("off")
+      .optional()
+      .describe(
+        "Disable Creative Context for this document generation only without changing the saved preference.",
+      ),
+    reuseLabels: z
+      .array(reuseLabelSchema)
+      .optional()
+      .default([])
+      .describe("Exact context item versions used to draft this document"),
   }),
   mcpApp: {
     compactCatalog: true,
@@ -62,6 +109,43 @@ export default defineAction({
     }),
   },
   run: async (args) => {
+    const hasCreativeContextInput = Boolean(
+      args.contextPackId ||
+      args.contextModeOverride ||
+      args.reuseLabels.length > 0,
+    );
+    const validatedCreativeContext = hasCreativeContextInput
+      ? await validateGenerationCreativeContext({
+          contextPackId: args.contextPackId,
+          contextModeOverride: args.contextModeOverride,
+          reuseLabels: args.reuseLabels,
+        })
+      : null;
+    const creativeContextProvenance = validatedCreativeContext
+      ? {
+          contextMode: validatedCreativeContext.contextMode,
+          contextPackId: validatedCreativeContext.contextPackId,
+          reuseLabels: validatedCreativeContext.reuseLabels,
+        }
+      : null;
+    const elementProvenanceFor = (documentId: string) =>
+      creativeContextProvenance?.reuseLabels.length
+        ? creativeContextProvenance.reuseLabels.map((label) => ({
+            elementId: label.elementId ?? documentId,
+            influence: label.influence ?? ("reference-conditioned" as const),
+            ...(label.itemId ? { itemId: label.itemId } : {}),
+            ...(label.itemVersionId
+              ? { itemVersionId: label.itemVersionId }
+              : {}),
+            label: label.label,
+          }))
+        : [
+            {
+              elementId: documentId,
+              influence: "generated" as const,
+              label: "Net-new document",
+            },
+          ];
     const title = args.title;
 
     let content = args.content || "";
@@ -208,6 +292,15 @@ export default defineAction({
       );
 
     await writeAppState("refresh-signal", { ts: Date.now() });
+    if (creativeContextProvenance) {
+      await recordGenerationCreativeContext({
+        appId: "content",
+        artifactType: "document",
+        artifactId: doc.id,
+        ...creativeContextProvenance,
+        elementProvenance: elementProvenanceFor(doc.id),
+      });
+    }
 
     return {
       id: doc.id,
@@ -231,6 +324,7 @@ export default defineAction({
       canManage: inheritedRole === "owner" || inheritedRole === "admin",
       createdAt: doc.createdAt,
       updatedAt: doc.updatedAt,
+      ...(creativeContextProvenance ?? {}),
     };
   },
   link: ({ result }) => {