@agent-native/core 0.106.3 → 0.107.1

package/corpus/templates/content/server/lib/native-creative-context.ts

@@ -0,0 +1,191 @@
+import { createHash, randomUUID } from "node:crypto";
+
+import { putPrivateBlob } from "@agent-native/core/private-blob";
+import { accessFilter, resolveAccess } from "@agent-native/core/sharing";
+import type { NativeResourceCaptureAdapter } from "@agent-native/creative-context/server";
+import { and, inArray } from "drizzle-orm";
+
+import { flushOpenDocumentEditorToSql } from "../../actions/_document-flush.js";
+import { getDb, schema } from "../db/index.js";
+
+interface DocumentPreviewBlock {
+  kind: "heading" | "paragraph" | "bullet" | "quote" | "code";
+  text: string;
+  level?: number;
+}
+
+function documentPreview(markdown: string) {
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const headings = lines
+    .filter((line) => /^#{1,6}\s+/.test(line))
+    .map((line) =>
+      line
+        .replace(/^#{1,6}\s+/, "")
+        .trim()
+        .slice(0, 160),
+    )
+    .filter(Boolean)
+    .slice(0, 8);
+  const excerpt = lines
+    .filter((line) => !/^\s*(?:```|#{1,6}\s+)/.test(line))
+    .join(" ")
+    .replace(/\s+/g, " ")
+    .trim()
+    .slice(0, 1_500);
+  let inCode = false;
+  const blocks = lines
+    .slice(0, 240)
+    .flatMap<DocumentPreviewBlock>((rawLine) => {
+      const line = rawLine.trim();
+      if (/^```/.test(line)) {
+        inCode = !inCode;
+        return [];
+      }
+      if (!line) return [];
+      if (inCode) {
+        return [{ kind: "code" as const, text: rawLine.slice(0, 600) }];
+      }
+      const heading = /^(#{1,6})\s+(.+)$/.exec(line);
+      if (heading) {
+        return [
+          {
+            kind: "heading" as const,
+            text: (heading[2] ?? "").slice(0, 300),
+            level: heading[1]?.length ?? 1,
+          },
+        ];
+      }
+      const bullet = /^(?:[-*+] |\d+[.)] )(.+)$/.exec(line);
+      if (bullet) {
+        return [
+          { kind: "bullet" as const, text: (bullet[1] ?? "").slice(0, 600) },
+        ];
+      }
+      if (line.startsWith(">")) {
+        return [
+          { kind: "quote" as const, text: line.slice(1).trim().slice(0, 600) },
+        ];
+      }
+      return [{ kind: "paragraph" as const, text: line.slice(0, 600) }];
+    });
+  return {
+    type: "document" as const,
+    headings,
+    excerpt,
+    blocks: blocks.slice(0, 40),
+  };
+}
+
+export const nativeDocumentCreativeContextAdapter: NativeResourceCaptureAdapter =
+  {
+    appId: "content",
+    resourceType: "document",
+    async listResourceVersions(resourceIds) {
+      if (!resourceIds.length) return [];
+      return getDb()
+        .select({
+          resourceId: schema.documents.id,
+          sourceModifiedAt: schema.documents.updatedAt,
+        })
+        .from(schema.documents)
+        .where(
+          and(
+            inArray(schema.documents.id, [...resourceIds]),
+            accessFilter(schema.documents, schema.documentShares),
+          ),
+        );
+    },
+    async capture(reference) {
+      const access = await resolveAccess("document", reference.resourceId);
+      if (!access) throw new Error("Document not found");
+      const initial = access.resource as typeof schema.documents.$inferSelect;
+      if (
+        reference.expectedUpdatedAt &&
+        reference.expectedUpdatedAt !== initial.updatedAt
+      )
+        throw new Error(
+          "Document changed before it could be submitted to Context.",
+        );
+      await flushOpenDocumentEditorToSql({
+        documentId: initial.id,
+        ownerEmail: initial.ownerEmail ?? null,
+      });
+      const refreshed = await resolveAccess("document", initial.id);
+      if (!refreshed) throw new Error("Document not found");
+      const document =
+        refreshed.resource as typeof schema.documents.$inferSelect;
+      const contentHash = createHash("sha256")
+        .update(document.content)
+        .digest("hex");
+      const versionId = randomUUID();
+      await getDb().insert(schema.documentVersions).values({
+        id: versionId,
+        ownerEmail: document.ownerEmail,
+        documentId: document.id,
+        title: document.title,
+        content: document.content,
+        createdAt: new Date().toISOString(),
+      });
+      const handle = await putPrivateBlob({
+        data: Buffer.from(document.content),
+        filename: `${document.id}.md`,
+        mimeType: "text/markdown",
+        ownerEmail: document.ownerEmail,
+        key: `creative-context/content/${document.id}/${contentHash}.md`,
+        metadata: {
+          appId: "content",
+          resourceType: "document",
+          resourceId: document.id,
+          contentHash,
+        },
+      });
+      if (!handle)
+        throw new Error(
+          "Private blob storage is required to submit a document to Context.",
+        );
+      return {
+        artifactKey: `content:document:${document.id}`,
+        source: {
+          name: "Content",
+          kind: "native-app",
+          externalRef: document.id,
+          access: {
+            visibility: document.visibility ?? "private",
+            canManage: refreshed.role === "owner" || refreshed.role === "admin",
+          },
+        },
+        items: [
+          {
+            externalId: `native:content:document:${document.id}`,
+            kind: "document",
+            title: document.title,
+            canonicalUrl: `/page/${document.id}`,
+            mimeType: "text/markdown",
+            content: document.content.slice(0, 40_000),
+            summary: document.description ?? "Immutable Markdown document.",
+            contentHash,
+            sourceModifiedAt: document.updatedAt,
+            sourceVersion: versionId,
+            metadata: { preview: documentPreview(document.content) },
+          },
+        ],
+        privateMetadata: {
+          nativeResource: {
+            appId: "content",
+            resourceType: "document",
+            resourceId: document.id,
+            expectedUpdatedAt: reference.expectedUpdatedAt,
+          },
+          clone: {
+            handle,
+            appId: "content",
+            resourceType: "document",
+            resourceId: document.id,
+            contentHash,
+            sourceVersion: versionId,
+            updatedAt: document.updatedAt,
+          },
+        },
+      };
+    },
+  };

package/corpus/templates/content/server/plugins/creative-context.ts

@@ -1,7 +1,12 @@
 import { registerOnboardingStep } from "@agent-native/core/onboarding";
-import { setupCreativeContext } from "@agent-native/creative-context/server";
+import {
+  registerNativeResourceCaptureAdapter,
+  setupCreativeContext,
+} from "@agent-native/creative-context/server";
 import { listContextSources } from "@agent-native/creative-context/store";
 
+import { nativeDocumentCreativeContextAdapter } from "../lib/native-creative-context.js";
+
 registerOnboardingStep({
   id: "creative-context-library",
   order: 18,
@@ -28,4 +33,6 @@ registerOnboardingStep({
   },
 });
 
+registerNativeResourceCaptureAdapter(nativeDocumentCreativeContextAdapter);
+
 export default setupCreativeContext({ appId: "content" });

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

@@ -35,9 +35,11 @@ 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.
+2. Read the `creative-context` application-state record. If `pinnedPackId` is
+   set, replay that immutable pack. Otherwise honor `selectedContextId`; when it
+   is unset, let retrieval use Default plus at most one app-bound or
+   semantically matching specialty context. `currentPackId` is the receipt from
+   the latest materialized generation, not a replacement for context selection.
 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
@@ -60,6 +62,7 @@ The single state key is `creative-context`:
 ```json
 {
   "contextMode": "auto",
+  "selectedContextId": null,
   "currentPackId": null,
   "pinnedPackId": null
 }
@@ -114,3 +117,8 @@ If `nativeCode.content` is `null` and `oversized` is true, use the named
 `get-context-item`, but the inline content is only the validated manifest shell.
 Never concatenate a truncated fragment or use delimited `version.content` as
 HTML.
+
+For an app-created Design snapshot, use
+`clone-creative-context-design-native` instead. That typed action resolves the
+exact approved private file/Yjs payload and duplicates it through Design's
+native path. Generic context actions must never receive or return that payload.

package/corpus/templates/design/AGENTS.md

@@ -178,6 +178,11 @@ patterns live in `.agents/skills/`.
   `.agents/skills/creative-context/SKILL.md`: explicit request and current
   design first, then a pinned/current pack, then narrow library search. Respect
   `creative-context.contextMode: "off"` without silently restoring a pack.
+- To submit a design to a governed Creative Context, use the Context tab or
+  `manage-context-membership`; it captures one immutable live design snapshot.
+  Reuse only a returned opaque native clone reference through the Design clone action.
+  Use `operation="submit-latest"` with a Library membership id when its native
+  update status reports `update-available`.
 - For reusable design-system setup from Figma, connected code/GitHub, local
   code/design files, or optional `design.md`, use Builder-backed DSI indexing
   through `index-design-system-with-builder` or the Design System Setup `.fig`

package/corpus/templates/design/actions/clone-creative-context-design-native.ts

@@ -0,0 +1,111 @@
+import { createHash } from "node:crypto";
+
+import { defineAction } from "@agent-native/core";
+import {
+  readPrivateBlob,
+  type PrivateBlobHandle,
+} from "@agent-native/core/private-blob";
+import { resolveNativeContextCloneReference } from "@agent-native/creative-context/server";
+import { z } from "zod";
+
+import { mutateDesignData } from "../server/lib/design-data-mutation.js";
+import { saveImportedDesignFiles } from "../server/lib/import-design-files.js";
+import createDesign from "./create-design.js";
+
+const payloadSchema = z.object({
+  designId: z.string(),
+  designData: z.string(),
+  files: z.array(
+    z.object({
+      filename: z.string(),
+      fileType: z.enum(["html", "css", "jsx", "asset"]),
+      content: z.string(),
+    }),
+  ),
+  tweaks: z.unknown().optional(),
+  appliedTweaks: z.unknown().optional(),
+  resolvedCssVars: z.unknown().optional(),
+});
+
+export default defineAction({
+  description:
+    "Clone an exact governed Design snapshot into a new editable Design project without exposing the source payload.",
+  schema: z.object({
+    contextId: z.string(),
+    artifactKey: z.string(),
+    resourceId: z.string(),
+    expectedUpdatedAt: z.string().optional(),
+    title: z.string().optional(),
+  }),
+  publicAgent: { expose: true, readOnly: false, requiresAuth: true },
+  run: async (args) => {
+    const reference = await resolveNativeContextCloneReference({
+      appId: "design",
+      resourceType: "design",
+      resourceId: args.resourceId,
+      expectedUpdatedAt: args.expectedUpdatedAt,
+      contextId: args.contextId,
+      artifactKey: args.artifactKey,
+    });
+    const raw = await readPrivateBlob(
+      reference.cloneHandle as PrivateBlobHandle,
+    );
+    const body = Buffer.from(raw.data).toString("utf8");
+    const hash = createHash("sha256").update(body).digest("hex");
+    if (
+      raw.metadata?.appId !== "design" ||
+      raw.metadata?.resourceType !== "design" ||
+      raw.metadata?.resourceId !== args.resourceId ||
+      raw.metadata?.contentHash !== hash
+    )
+      throw new Error(
+        "Governed design clone payload failed integrity verification.",
+      );
+    const payload = payloadSchema.parse(JSON.parse(body));
+    const created = await createDesign.run({
+      title: args.title?.trim() || "Context design",
+      projectType: "prototype",
+    });
+    const saved = await saveImportedDesignFiles({
+      designId: created.id,
+      sourceType: "creative-context-native-clone",
+      preserveExactContent: true,
+      files: payload.files.map((file) => ({
+        ...file,
+        source: {
+          creativeContextItemVersionId: reference.publishedItemVersionId,
+        },
+      })),
+    });
+    if (saved.files.length !== payload.files.length)
+      throw new Error("Design clone did not persist every saved file.");
+    const capturedData = z
+      .record(z.string(), z.unknown())
+      .parse(JSON.parse(payload.designData));
+    const {
+      canvasFrames: _capturedFrames,
+      screenMetadata: _capturedMetadata,
+      ...capturedState
+    } = capturedData;
+    await mutateDesignData({
+      designId: created.id,
+      mutate: (current) => ({
+        ...capturedState,
+        canvasFrames: current.canvasFrames,
+        screenMetadata: current.screenMetadata,
+      }),
+      isApplied: (persisted) =>
+        Object.entries(capturedState).every(
+          ([key, value]) =>
+            JSON.stringify(persisted[key]) === JSON.stringify(value),
+        ),
+    });
+    return {
+      designId: saved.designId,
+      title: created.title,
+      fileCount: saved.files.length,
+      urlPath: saved.urlPath,
+      clonedExactVersion: reference.publishedItemVersionId,
+    };
+  },
+});

package/corpus/templates/design/actions/provider-api-request.ts

@@ -204,6 +204,7 @@ export default defineAction({
       ),
   }),
   http: false,
+  toolCallable: false,
   needsApproval: requiresProviderApiApproval,
   run: async (args) => {
     if (args.stageAs) {

package/corpus/templates/design/app/pages/Index.tsx

@@ -8,6 +8,7 @@ import {
   injectSessionReplayIframeBootstrap,
   SESSION_REPLAY_IFRAME_ATTRIBUTE,
 } from "@agent-native/core/client";
+import { CreativeContextShareSheet } from "@agent-native/creative-context/client";
 import {
   useSetHeaderActions,
   useSetPageTitle,
@@ -109,6 +110,7 @@ export default function Index() {
   );
   const [renameId, setRenameId] = useState<string | null>(null);
   const [renameDraft, setRenameDraft] = useState("");
+  const [contextDesigns, setContextDesigns] = useState<Design[]>([]);
 
   const anchorElRef = useRef<HTMLElement | null>(null);
   const anchorRef = useRef<HTMLElement | null>(null);
@@ -809,6 +811,21 @@ export default function Index() {
                     </TooltipTrigger>
                     <TooltipContent>{t("home.clearSelection")}</TooltipContent>
                   </Tooltip>
+                  <Button
+                    variant="outline"
+                    size="sm"
+                    onClick={() =>
+                      setContextDesigns(
+                        designs.filter((design) =>
+                          selectedDesignIds.has(design.id),
+                        ),
+                      )
+                    }
+                    className="cursor-pointer"
+                  >
+                    <IconPlus className="w-3.5 h-3.5" />
+                    {t("creativeContext.addToContext" /* i18n-key-ignore */)}
+                  </Button>
                   <Button
                     variant="destructive"
                     size="sm"
@@ -936,6 +953,18 @@ export default function Index() {
                             <IconCopy className="w-3.5 h-3.5 me-2" />
                             {t("home.duplicate")}
                           </DropdownMenuItem>
+                          <DropdownMenuItem
+                            onSelect={(event) => {
+                              event.preventDefault();
+                              setContextDesigns([design]);
+                            }}
+                            className="cursor-pointer"
+                          >
+                            <IconPlus className="w-3.5 h-3.5 me-2" />
+                            {t(
+                              "creativeContext.addToContext" /* i18n-key-ignore */,
+                            )}
+                          </DropdownMenuItem>
                           <DropdownMenuItem
                             onClick={() => setDeleteId(design.id)}
                             className="text-red-400 focus:text-red-400 cursor-pointer"
@@ -954,6 +983,21 @@ export default function Index() {
         )}
       </main>
 
+      <CreativeContextShareSheet
+        open={contextDesigns.length > 0}
+        onOpenChange={(open) => {
+          if (!open) setContextDesigns([]);
+        }}
+        resources={contextDesigns.map((design) => ({
+          appId: "design",
+          resourceType: "design",
+          resourceId: design.id,
+          title: design.title,
+          updatedAt: design.updatedAt ?? design.createdAt,
+          preview: { kind: "document", label: "Design" },
+        }))}
+      />
+
       <PromptPopover
         open={showNewPrompt}
         onOpenChange={handleNewPromptOpenChange}

package/corpus/templates/design/app/pages/design-editor/types.ts

@@ -52,6 +52,7 @@ export type DesignAccessRole = "owner" | "admin" | "editor" | "viewer";
 export interface DesignData {
   id: string;
   title: string;
+  updatedAt: string;
   description?: string;
   projectType: string;
   designSystemId?: string | null;

package/corpus/templates/design/changelog/2026-07-17-library-now-flags-published-designs-with-newer-versions-and-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Library now flags published designs with newer versions and lets you submit the update in place.

package/corpus/templates/design/changelog/2026-07-17-resources-can-be-added-to-creative-context-from-their-action.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Resources can be added to Creative Context from their action menus.

package/corpus/templates/design/changelog/2026-07-17-you-can-add-exact-approved-artifact-versions-to-governed-cre.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+You can add exact, approved artifact versions to governed Creative Contexts for safe reuse.