@agent-native/core 0.106.3 → 0.107.1

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

@@ -0,0 +1,265 @@
+import { createHash } from "node:crypto";
+
+import { putPrivateBlob } from "@agent-native/core/private-blob";
+import { accessFilter, resolveAccess } from "@agent-native/core/sharing";
+import {
+  renderSafeNativeHtmlPreviews,
+  serializePrivateBlobHandle,
+  type NativeResourceCaptureAdapter,
+} from "@agent-native/creative-context/server";
+import { and, inArray } from "drizzle-orm";
+import { nanoid } from "nanoid";
+
+import { getDb, schema } from "../db/index.js";
+import { buildDesignSnapshot } from "./design-snapshot.js";
+
+function previewText(value: string, limit = 280) {
+  return value
+    .replace(/<[^>]+>/g, " ")
+    .replace(/\s+/g, " ")
+    .trim()
+    .slice(0, limit);
+}
+
+async function captureDesignPreviewMedia(input: {
+  designId: string;
+  ownerEmail: string;
+  files: Array<{
+    id: string;
+    filename: string;
+    fileType: string;
+    content: string;
+  }>;
+}) {
+  const previewFiles = input.files
+    .filter((file) => file.fileType === "html")
+    .slice(0, 12);
+  const rendered = await renderSafeNativeHtmlPreviews(
+    previewFiles.map((file) => ({
+      id: file.id,
+      html: file.content,
+      width: 1_280,
+      height: 800,
+    })),
+  );
+  const media = new Map<
+    string,
+    {
+      kind: "image";
+      mimeType: "image/png";
+      accessMode: "private";
+      storageKey: string;
+      altText: string;
+      contentHash: string;
+      width: number;
+      height: number;
+      metadata: { role: "design-preview"; fileId: string };
+    }
+  >();
+  await Promise.all(
+    rendered.map(async (preview) => {
+      const contentHash = createHash("sha256")
+        .update(preview.data)
+        .digest("hex");
+      const handle = await putPrivateBlob({
+        data: preview.data,
+        filename: `${input.designId}-${preview.id}.preview.png`,
+        mimeType: "image/png",
+        ownerEmail: input.ownerEmail,
+        key: `creative-context/design/${input.designId}/previews/${contentHash}.png`,
+        metadata: {
+          appId: "design",
+          resourceType: "design-preview",
+          resourceId: input.designId,
+          contentHash,
+        },
+      }).catch(() => null);
+      if (!handle) return;
+      const file = previewFiles.find(
+        (candidate) => candidate.id === preview.id,
+      );
+      media.set(preview.id, {
+        kind: "image",
+        mimeType: "image/png",
+        accessMode: "private",
+        storageKey: serializePrivateBlobHandle(handle),
+        altText: file?.filename ?? "Design preview",
+        contentHash,
+        width: preview.width,
+        height: preview.height,
+        metadata: { role: "design-preview", fileId: preview.id },
+      });
+    }),
+  );
+  return media;
+}
+
+export const nativeDesignCreativeContextAdapter: NativeResourceCaptureAdapter =
+  {
+    appId: "design",
+    resourceType: "design",
+    async listResourceVersions(resourceIds) {
+      if (!resourceIds.length) return [];
+      return getDb()
+        .select({
+          resourceId: schema.designs.id,
+          sourceModifiedAt: schema.designs.updatedAt,
+        })
+        .from(schema.designs)
+        .where(
+          and(
+            inArray(schema.designs.id, [...resourceIds]),
+            accessFilter(schema.designs, schema.designShares),
+          ),
+        );
+    },
+    async capture(reference) {
+      const access = await resolveAccess("design", reference.resourceId);
+      if (!access) throw new Error("Design not found");
+      const design = access.resource as typeof schema.designs.$inferSelect;
+      if (
+        reference.expectedUpdatedAt &&
+        reference.expectedUpdatedAt !== design.updatedAt
+      )
+        throw new Error(
+          "Design changed before it could be submitted to Context.",
+        );
+      const snapshot = await buildDesignSnapshot(design.id, design.data);
+      const payload = JSON.stringify({
+        designId: design.id,
+        designData: design.data,
+        files: snapshot.files,
+        tweaks: snapshot.tweaks,
+        appliedTweaks: snapshot.appliedTweaks,
+        resolvedCssVars: snapshot.resolvedCssVars,
+      });
+      const contentHash = createHash("sha256").update(payload).digest("hex");
+      const versionId = nanoid();
+      await getDb().insert(schema.designVersions).values({
+        id: versionId,
+        designId: design.id,
+        label: "Creative Context submission",
+        snapshot: payload,
+        createdAt: new Date().toISOString(),
+      });
+      const handle = await putPrivateBlob({
+        data: Buffer.from(payload),
+        filename: `${design.id}.design.json`,
+        mimeType: "application/json",
+        ownerEmail: design.ownerEmail,
+        key: `creative-context/design/${design.id}/${contentHash}.json`,
+        metadata: {
+          appId: "design",
+          resourceType: "design",
+          resourceId: design.id,
+          contentHash,
+        },
+      });
+      if (!handle)
+        throw new Error(
+          "Private blob storage is required to submit a design to Context.",
+        );
+      const previewMedia = await captureDesignPreviewMedia({
+        designId: design.id,
+        ownerEmail: design.ownerEmail,
+        files: snapshot.files,
+      });
+      const sourceModifiedAt = design.updatedAt ?? undefined;
+      return {
+        artifactKey: `design:design:${design.id}`,
+        source: {
+          name: "Design",
+          kind: "native-app",
+          externalRef: design.id,
+          access: {
+            visibility: design.visibility ?? "private",
+            canManage: access.role === "owner" || access.role === "admin",
+          },
+        },
+        items: [
+          {
+            externalId: `native:design:design:${design.id}`,
+            kind: "design-project",
+            title: design.title,
+            canonicalUrl: `/design/${design.id}`,
+            mimeType: "application/json",
+            content: snapshot.files
+              .map(
+                (file) =>
+                  `${file.filename}\n${file.content.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ")}`,
+              )
+              .join("\n")
+              .slice(0, 40_000),
+            summary: `${snapshot.files.length} saved design files captured as an immutable version.`,
+            contentHash,
+            sourceModifiedAt,
+            sourceVersion: versionId,
+            metadata: {
+              preview: {
+                type: "design",
+                fileCount: snapshot.files.length,
+                frames: snapshot.files.slice(0, 24).map((file) => ({
+                  title: file.filename.slice(0, 160),
+                  fileType: file.fileType.slice(0, 80),
+                  excerpt: previewText(file.content),
+                })),
+              },
+            },
+            media: [...previewMedia.values()],
+            edges: snapshot.files.map((file) => ({
+              relation: "contains",
+              toExternalId: `native:design:design:${design.id}:frame:${file.id}`,
+            })),
+          },
+          ...snapshot.files.map((file) => {
+            const content = file.content
+              .replace(/<[^>]+>/g, " ")
+              .replace(/\s+/g, " ")
+              .trim();
+            return {
+              externalId: `native:design:design:${design.id}:frame:${file.id}`,
+              kind: "design-frame",
+              title: file.filename,
+              canonicalUrl: `/design/${design.id}`,
+              mimeType: "text/html",
+              content,
+              summary: content.slice(0, 500),
+              contentHash: createHash("sha256")
+                .update(file.content)
+                .digest("hex"),
+              sourceModifiedAt,
+              sourceVersion: versionId,
+              metadata: {
+                preview: {
+                  type: "design-frame",
+                  title: file.filename.slice(0, 160),
+                  fileType: file.fileType.slice(0, 80),
+                  excerpt: previewText(file.content),
+                },
+              },
+              media: previewMedia.has(file.id)
+                ? [previewMedia.get(file.id)!]
+                : undefined,
+            };
+          }),
+        ],
+        privateMetadata: {
+          nativeResource: {
+            appId: "design",
+            resourceType: "design",
+            resourceId: design.id,
+            expectedUpdatedAt: reference.expectedUpdatedAt,
+          },
+          clone: {
+            handle,
+            appId: "design",
+            resourceType: "design",
+            resourceId: design.id,
+            contentHash,
+            sourceVersion: versionId,
+            updatedAt: design.updatedAt,
+          },
+        },
+      };
+    },
+  };

package/corpus/templates/design/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 { nativeDesignCreativeContextAdapter } from "../lib/native-creative-context.js";
+
 registerOnboardingStep({
   id: "creative-context-library",
   order: 18,
@@ -28,4 +33,6 @@ registerOnboardingStep({
   },
 });
 
+registerNativeResourceCaptureAdapter(nativeDesignCreativeContextAdapter);
+
 export default setupCreativeContext({ appId: "design" });

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

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

package/corpus/templates/dispatch/app/hooks/use-navigation-state.ts

@@ -1,6 +1,7 @@
 import {
   appBasePath,
   appPath,
+  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
   useAgentRouteState,
 } from "@agent-native/core/client";
@@ -54,7 +55,9 @@ export function useNavigationState(extensions?: DispatchExtensionConfig) {
         routerPath(location.pathname) === "/chat" &&
         pathnameFromPath(path) !== "/chat"
       ) {
-        markAgentChatHomeHandoff("dispatch");
+        if (isAgentChatHomeHandoffActive("dispatch")) {
+          markAgentChatHomeHandoff("dispatch");
+        }
       }
     },
   });

package/corpus/templates/dispatch/changelog/2026-07-17-the-agent-chat-sidebar-stays-closed-until-you-open-it-or-sta.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+The agent chat sidebar stays closed until you open it or start a chat handoff.

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

@@ -51,8 +51,6 @@ export function Layout({ children }: LayoutProps) {
     if (!formId) return null;
     return { type: "form" as const, id: formId };
   }, [location.pathname]);
-  const sidebarScope = chatHomeHandoffActive ? null : formScope;
-
   if (BARE_ROUTES.has(location.pathname)) {
     return <>{children}</>;
   }
@@ -89,7 +87,7 @@ export function Layout({ children }: LayoutProps) {
           <AgentSidebar
             position="right"
             agentPageHref="/agent"
-            defaultOpen
+            defaultOpen={false}
             chatViewTransition
             storageKey="forms"
             browserTabId={TAB_ID}
@@ -101,7 +99,7 @@ export function Layout({ children }: LayoutProps) {
               t("agent.suggestionSubmissions"),
               t("agent.suggestionExport"),
             ]}
-            scope={sidebarScope}
+            scope={formScope}
           >
             <div className="flex h-full flex-1 flex-col overflow-hidden">
               {showHeader ? <Header /> : null}

package/corpus/templates/forms/app/components/ui/popover.tsx

@@ -1 +1,25 @@
-export * from "@agent-native/toolkit/ui/popover";
+import {
+  Popover,
+  PopoverAnchor,
+  PopoverContent as ToolkitPopoverContent,
+  PopoverTrigger,
+} from "@agent-native/toolkit/ui/popover";
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const PopoverContent = React.forwardRef<
+  React.ElementRef<typeof ToolkitPopoverContent>,
+  React.ComponentPropsWithoutRef<typeof ToolkitPopoverContent>
+>(({ className, collisionPadding = 16, ...props }, ref) => (
+  <ToolkitPopoverContent
+    ref={ref}
+    collisionPadding={collisionPadding}
+    className={cn("max-w-[calc(100vw-2rem)]", className)}
+    {...props}
+  />
+));
+
+PopoverContent.displayName = ToolkitPopoverContent.displayName;
+
+export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger };

package/corpus/templates/forms/app/hooks/use-navigation-state.ts

@@ -1,5 +1,6 @@
 import {
   appBasePath,
+  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
   useAgentRouteState,
 } from "@agent-native/core/client";
@@ -131,7 +132,11 @@ export function useNavigationState() {
     navigateOptions: { flushSync: true, replace: true },
     onNavigate: (_command, path) => {
       void prewarmFormsRoutePath(path);
-      if (location.pathname === "/ask" && path !== "/ask") {
+      if (
+        location.pathname === "/ask" &&
+        path !== "/ask" &&
+        isAgentChatHomeHandoffActive("forms")
+      ) {
         markAgentChatHomeHandoff("forms");
       }
     },

package/corpus/templates/forms/app/pages/FormBuilderPage.tsx

@@ -359,10 +359,19 @@ export function FormBuilderPage() {
             <Skeleton className="h-8 w-20 rounded-md" />
           </div>
         </div>
-        {/* Body: builder + properties */}
-        <div className="flex flex-1 overflow-hidden">
-          <div className="flex-1 overflow-auto p-4 sm:p-6">
-            <div className="max-w-2xl mx-auto space-y-4">
+        {/* Tabs */}
+        <div className="border-b border-border px-2 sm:px-4 py-2 shrink-0 overflow-hidden">
+          <div className="flex w-max items-center gap-1 rounded-lg bg-muted/40 p-1">
+            <Skeleton className="h-8 w-12 rounded-md" />
+            <Skeleton className="h-8 w-16 rounded-md" />
+            <Skeleton className="h-8 w-16 rounded-md" />
+            <Skeleton className="h-8 w-24 rounded-md" />
+          </div>
+        </div>
+        {/* Body: builder */}
+        <div className="flex flex-1 overflow-hidden relative">
+          <div className="flex-1 overflow-auto bg-muted/30">
+            <div className="max-w-2xl mx-auto py-4 sm:py-8 px-3 sm:px-4 space-y-4">
               <Skeleton className="h-8 w-2/3" />
               <Skeleton className="h-4 w-1/2" />
               <div className="space-y-3 pt-4">
@@ -378,12 +387,6 @@ export function FormBuilderPage() {
               </div>
             </div>
           </div>
-          <div className="hidden lg:block w-72 border-s border-border p-4 space-y-4">
-            <Skeleton className="h-4 w-32" />
-            <Skeleton className="h-9 w-full" />
-            <Skeleton className="h-9 w-full" />
-            <Skeleton className="h-9 w-full" />
-          </div>
         </div>
       </div>
     );

package/corpus/templates/forms/app/root.tsx

@@ -8,6 +8,7 @@ import {
   useCommandMenuShortcut,
   getThemeInitScript,
   configureTracking,
+  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
   navigateWithAgentChatViewTransition,
   setClientAppState,
@@ -199,7 +200,11 @@ function OpenLinkInterceptor() {
       if (!path) return;
 
       event.preventDefault();
-      if (location.pathname === "/ask" && path !== "/ask") {
+      if (
+        location.pathname === "/ask" &&
+        path !== "/ask" &&
+        isAgentChatHomeHandoffActive("forms")
+      ) {
         markAgentChatHomeHandoff("forms");
       }
       navigateWithAgentChatViewTransition(navigate, path);

package/corpus/templates/forms/changelog/2026-07-17-form-builder-popovers-stay-within-the-viewport.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+Form builder popovers stay within the viewport

package/corpus/templates/forms/changelog/2026-07-17-form-editor-loading-matches-current-sidebar-free-layout.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+Form editor loading now matches the current sidebar-free layout.

package/corpus/templates/forms/changelog/2026-07-17-the-agent-chat-sidebar-stays-closed-until-you-open-it-or-sta.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+The agent chat sidebar stays closed until you open it or start a chat handoff.

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

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

package/corpus/templates/mail/app/components/layout/AppLayout.tsx

@@ -196,7 +196,7 @@ export function AppLayout({ children }: AppLayoutProps) {
   return (
     <AgentSidebar
       position="right"
-      defaultOpen={!isMobile}
+      defaultOpen={false}
       agentPageHref="/agent"
       emptyStateText={t("agent.emptyState")}
       suggestions={[

package/corpus/templates/mail/changelog/2026-07-17-the-agent-chat-sidebar-stays-closed-until-you-open-it-or-sta.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+The agent chat sidebar stays closed until you open it or start a chat handoff.

package/corpus/templates/plan/app/components/layout/Sidebar.tsx

@@ -3,6 +3,7 @@ import {
   DevDatabaseLink,
   FeedbackButton,
   appPath,
+  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
   navigateWithAgentChatViewTransition,
   PromptComposer,
@@ -442,13 +443,17 @@ function PlansSidebarSection({ collapsed }: { collapsed: boolean }) {
       signInForPlanCreate();
       return;
     }
-    markAgentChatHomeHandoff("plans");
+    if (location.pathname === "/" && isAgentChatHomeHandoffActive("plans")) {
+      markAgentChatHomeHandoff("plans");
+    }
     navigateWithAgentChatViewTransition(navigate, "/plans?create=1");
   };
 
   const openPlanPath = (event: MouseEvent<HTMLAnchorElement>, path: string) => {
     event.preventDefault();
-    markAgentChatHomeHandoff("plans");
+    if (location.pathname === "/" && isAgentChatHomeHandoffActive("plans")) {
+      markAgentChatHomeHandoff("plans");
+    }
     navigateWithAgentChatViewTransition(navigate, path);
   };
 
@@ -738,7 +743,13 @@ export function Sidebar({
             <Link
               to={item.href}
               onClick={() => {
-                if (item.href !== "/") markAgentChatHomeHandoff("plans");
+                if (
+                  item.href !== "/" &&
+                  location.pathname === "/" &&
+                  isAgentChatHomeHandoffActive("plans")
+                ) {
+                  markAgentChatHomeHandoff("plans");
+                }
               }}
               className={cn(
                 "flex items-center gap-3 rounded-lg px-3 py-2 text-sm transition-colors",

package/corpus/templates/plan/app/hooks/use-navigation-state.ts

@@ -1,6 +1,7 @@
 import {
   agentNativePath,
   appBasePath,
+  isAgentChatHomeHandoffActive,
   markAgentChatHomeHandoff,
 } from "@agent-native/core/client";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
@@ -108,7 +109,13 @@ export function useNavigationState() {
     deleteCommand();
     const path = planNavigateCommandPath(cmd);
     void prewarmPlanRoutePath(path);
-    if (path !== "/") markAgentChatHomeHandoff("plans");
+    if (
+      location.pathname === "/" &&
+      path !== "/" &&
+      isAgentChatHomeHandoffActive("plans")
+    ) {
+      markAgentChatHomeHandoff("plans");
+    }
     const commitNavigation = () =>
       navigate(path, { replace: true, flushSync: true });
     if (

package/corpus/templates/plan/app/root.tsx

@@ -6,7 +6,6 @@ import {
   createAgentNativeQueryClient,
   getLocaleInitScript,
   getThemeInitScript,
-  markAgentChatHomeHandoff,
   navigateWithAgentChatViewTransition,
   useCommandMenuShortcut,
   useT,
@@ -153,7 +152,6 @@ function AppContent() {
   useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
   const go = useCallback(
     (path: string) => {
-      if (path !== "/") markAgentChatHomeHandoff("plans");
       navigateWithAgentChatViewTransition(navigate, path);
       setCmdkOpen(false);
     },

package/corpus/templates/plan/changelog/2026-07-17-the-agent-chat-sidebar-stays-closed-until-you-open-it-or-sta.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+The agent chat sidebar stays closed until you open it or start a chat handoff.

package/corpus/templates/slides/.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
 }
@@ -120,3 +123,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 deck snapshot, use `clone-creative-context-deck` instead.
+That typed action resolves the exact approved private deck payload and runs it
+through Slides' normal deck creation and sanitization path. Generic context
+actions must never receive or return that payload.

package/corpus/templates/slides/AGENTS.md

@@ -44,6 +44,11 @@ Detailed deck, slide-editing, image, design-system, and export workflows live in
   `.agents/skills/creative-context/SKILL.md`: explicit request and current deck
   first, then a pinned/current pack, then narrow library search. Respect
   `creative-context.contextMode: "off"` without silently restoring a pack.
+- To submit a deck to a governed Creative Context, use the Context tab or
+  `manage-context-membership`; it captures one immutable deck version. Reuse
+  only a returned opaque native clone reference through the Slides clone action.
+  Use `operation="submit-latest"` with a Library membership id when its native
+  update status reports `update-available`.
 
 ## Persistence Model