@agent-native/core 0.106.2 → 0.107.0

package/corpus/templates/content/actions/clone-creative-context-document.ts

@@ -0,0 +1,61 @@
+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 createDocument from "./create-document.js";
+
+export default defineAction({
+  description:
+    "Clone one exact governed Markdown document without returning its private source payload.",
+  schema: z.object({
+    contextId: z.string(),
+    artifactKey: z.string(),
+    resourceId: z.string(),
+    expectedUpdatedAt: z.string().optional(),
+    title: z.string().optional(),
+    parentId: z.string().optional(),
+  }),
+  publicAgent: { expose: true, readOnly: false, requiresAuth: true },
+  run: async (args) => {
+    const reference = await resolveNativeContextCloneReference({
+      appId: "content",
+      resourceType: "document",
+      resourceId: args.resourceId,
+      expectedUpdatedAt: args.expectedUpdatedAt,
+      contextId: args.contextId,
+      artifactKey: args.artifactKey,
+    });
+    const raw = await readPrivateBlob(
+      reference.cloneHandle as PrivateBlobHandle,
+    );
+    const content = Buffer.from(raw.data).toString("utf8");
+    const hash = createHash("sha256").update(content).digest("hex");
+    if (
+      raw.metadata?.appId !== "content" ||
+      raw.metadata?.resourceType !== "document" ||
+      raw.metadata?.resourceId !== args.resourceId ||
+      raw.metadata?.contentHash !== hash
+    )
+      throw new Error(
+        "Governed document clone payload failed integrity verification.",
+      );
+    const result = await createDocument.run({
+      title: args.title?.trim() || "Context document",
+      content,
+      ...(args.parentId ? { parentId: args.parentId } : {}),
+    });
+    if (!result?.id) throw new Error("Document clone did not persist.");
+    return {
+      id: result.id,
+      title: result.title,
+      urlPath: result.urlPath,
+      clonedExactVersion: reference.publishedItemVersionId,
+    };
+  },
+});

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

@@ -202,6 +202,7 @@ export default defineAction({
       ),
   }),
   http: false,
+  toolCallable: false,
   run: async (args) => {
     if (args.stageAs) {
       const ctx = getCredentialContext();

package/corpus/templates/content/app/components/editor/DocumentToolbar.tsx

@@ -7,6 +7,7 @@ import {
   type CollabUser,
 } from "@agent-native/core/client";
 import { ShareButton } from "@agent-native/core/client";
+import { CreativeContextShareTab } from "@agent-native/creative-context/client";
 import type { DocumentSourceInfo } from "@shared/api";
 import {
   IconArrowBarDown,
@@ -711,6 +712,26 @@ export function DocumentToolbar({
                   onCheckedChange: handleHideFromSearchChange,
                 }}
                 variant="compact"
+                shareTabs={{
+                  tabs: [
+                    {
+                      value: "context",
+                      label: "Context",
+                      content: (
+                        <CreativeContextShareTab
+                          resource={{
+                            appId: "content",
+                            resourceType: "document",
+                            resourceId: documentId,
+                            title: documentTitle || "Untitled",
+                            updatedAt: documentUpdatedAt ?? undefined,
+                            preview: { kind: "document", label: "Document" },
+                          }}
+                        />
+                      ),
+                    },
+                  ],
+                }}
               />
 
               <VersionHistoryPanel

package/corpus/templates/content/app/components/sidebar/DocumentTreeItem.tsx

@@ -1,4 +1,5 @@
 import { useT } from "@agent-native/core/client";
+import { CreativeContextShareSheet } from "@agent-native/creative-context/client";
 import {
   SortableContext,
   useSortable,
@@ -114,6 +115,7 @@ export function DocumentTreeItem({
   const hasMenuActions = canEdit || canManage;
   const canCreateChild = canEdit && !isLocalFileNode;
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [contextSheetOpen, setContextSheetOpen] = useState(false);
   const indent = depth * 12 + 12;
   const rowWidth =
     sidebarWidth === undefined ? undefined : Math.max(0, sidebarWidth - 8);
@@ -250,6 +252,18 @@ export function DocumentTreeItem({
                   </DropdownMenuItem>
                 )}
                 {canEdit && canManage && <DropdownMenuSeparator />}
+                {canEdit && !isLocalFileNode && (
+                  <DropdownMenuItem
+                    onSelect={(event) => {
+                      event.preventDefault();
+                      event.stopPropagation();
+                      setContextSheetOpen(true);
+                    }}
+                  >
+                    <IconPlus size={14} className="me-2" />
+                    {t("creativeContext.addToContext" /* i18n-key-ignore */)}
+                  </DropdownMenuItem>
+                )}
                 {canManage && (
                   <DropdownMenuItem
                     className="text-destructive"
@@ -310,6 +324,21 @@ export function DocumentTreeItem({
         </div>
       </div>
 
+      <CreativeContextShareSheet
+        open={contextSheetOpen}
+        onOpenChange={setContextSheetOpen}
+        resource={{
+          appId: "content",
+          resourceType: "document",
+          resourceId: node.id,
+          title: node.title || "Untitled",
+          updatedAt: node.updatedAt,
+          visibility: node.visibility,
+          preview: { kind: "document", label: "Document" },
+        }}
+        canManage={canManage}
+      />
+
       {hasChildren && expanded && (
         <SortableContext
           items={node.children.map((child) => child.id)}

package/corpus/templates/content/changelog/2026-07-17-library-now-flags-published-documents-with-newer-versions-an.md

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

package/corpus/templates/content/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/content/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.

package/corpus/templates/content/parity/matrix.md

@@ -20,7 +20,7 @@ This generated matrix tracks whether high-value Content UI operations use the sa
 | sharing.document-discoverability-and-export        | sharing     | Share, hide from search, export, and reveal documents                                          | action-backed         | `export-document`, `reveal-local-source-file`, `set-document-discoverability`, `share-local-file-document`                                                                                                                                                                                                                                                                                                  | `app/components/editor/DocumentToolbar.tsx`, `app/hooks/use-documents.ts`                                                                                                                 | Search discoverability, shareable copies, exports, and OS reveal requests are managed through Content actions.                                                                                                         | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/_local-file-documents.test.ts`                                                                                                                                                                                 | `local-file-source-truth`        | -                              |
 | sharing.os-reveal-local-source                     | sharing     | Reveal a local source file in the system file manager                                          | host-only             | `reveal-local-source-file`                                                                                                                                                                                                                                                                                                                                                                                  | `app/components/editor/DocumentToolbar.tsx`, `actions/reveal-local-source-file.ts`                                                                                                        | -                                                                                                                                                                                                                      | OS reveal depends on trusted local host capabilities and should not spend agent tool surface or imply portable hosted behavior.                                                                                                            | -                | P2             | seeded        | -                                                                                                                                                                                                                       | -                                | Local folder exception/docs PR |
 | sidebar.chrome-state                               | sidebar     | Collapse sections and resize the sidebar                                                       | client-only-ephemeral | -                                                                                                                                                                                                                                                                                                                                                                                                           | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/layout/Layout.tsx`                                                                                                          | -                                                                                                                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P2             | none          | -                                                                                                                                                                                                                       | -                                | -                              |
-| sidebar.document-tree-crud                         | sidebar     | Create, delete, move, favorite, list, search, and open pages                                   | action-backed         | `create-document`, `delete-document`, `get-document`, `list-documents`, `move-document`, `search-documents`, `update-document`                                                                                                                                                                                                                                                                              | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/sidebar/DocumentTreeItem.tsx`, `app/hooks/use-documents.ts`                                                                 | Document tree rows and document metadata are created, updated, deleted, moved, searched, or read.                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                                                                                | `document-search-edit`           | -                              |
+| sidebar.document-tree-crud                         | sidebar     | Create, delete, move, favorite, list, search, and open pages                                   | action-backed         | `create-document`, `clone-creative-context-document`, `delete-document`, `get-document`, `list-documents`, `move-document`, `search-documents`, `update-document`                                                                                                                                                                                                                                           | `app/components/sidebar/DocumentSidebar.tsx`, `app/components/sidebar/DocumentTreeItem.tsx`, `app/hooks/use-documents.ts`                                                                 | Document tree rows and document metadata are created, updated, deleted, moved, searched, or read.                                                                                                                      | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/content-database-lifecycle.db.test.ts`, `actions/_local-file-documents.test.ts`                                                                                                                                | `document-search-edit`           | -                              |
 | sidebar.navigation-and-screen-context              | sidebar     | Navigate between documents and expose current screen context                                   | action-equivalent     | `navigate`, `view-screen`                                                                                                                                                                                                                                                                                                                                                                                   | `app/components/sidebar/DocumentSidebar.tsx`, `actions/navigate.ts`, `actions/view-screen.ts`                                                                                             | Application navigation state is updated or read so the agent can reason about the user's current page/view.                                                                                                            | Human navigation is router-local, while agent navigation/screen inspection uses application-state actions to produce the same workspace orientation effect.                                                                                | -                | P1             | seeded        | -                                                                                                                                                                                                                       | -                                | -                              |
 | source-sync.builder-body-hydration-worker          | source-sync | Process queued Builder CMS body hydration work                                                 | action-backed         | `process-builder-body-hydration`                                                                                                                                                                                                                                                                                                                                                                            | `app/components/editor/DocumentEditor.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/hooks/use-content-database.ts`                                                        | Queued Builder body hydration entries are processed into readable Content document/database body state.                                                                                                                | This action is intentionally hidden from the model with agentTool: false because it is an internal bounded queue worker; agents should use source refresh, review, and execution actions rather than manually driving hydration internals. | -                | P0             | covered       | `actions/_database-source-utils.test.ts`                                                                                                                                                                                | -                                | -                              |
 | source-sync.builder-cms-review-and-write-gates     | source-sync | Review, stage, validate, cancel, and execute Builder CMS source writes                         | action-backed         | `cancel-prepared-builder-source-update`, `execute-builder-source-batch`, `execute-builder-source-execution`, `prepare-builder-source-execution`, `prepare-builder-source-review`, `preview-builder-source-review`, `review-content-database-source-change-set`, `set-content-database-source-write-mode`, `stage-builder-source-bulk-update`, `stage-builder-revision`, `validate-builder-source-execution` | `app/components/editor/DocumentDatabase.tsx`, `app/components/editor/database/DatabaseView.tsx`, `app/components/editor/database-sources/BuilderSourceReviewDialog.tsx`                   | Builder source write mode, staged reviews, pre-dispatch cancellations, validation records, and bounded execution records are created through guarded actions.                                                          | -                                                                                                                                                                                                                                          | -                | P0             | covered       | `actions/builder-source-review-gates.db.test.ts`, `actions/cancel-prepared-builder-source-update.db.test.ts`, `actions/execute-builder-source-execution.test.ts`, `actions/stage-builder-source-bulk-update.db.test.ts` | `builder-source-review-readonly` | -                              |

package/corpus/templates/content/parity/matrix.ts

@@ -17,6 +17,7 @@ export const parityMatrix: ParityRow[] = [
     status: "action-backed",
     actions: [
       "create-document",
+      "clone-creative-context-document",
       "delete-document",
       "get-document",
       "list-documents",

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) {