@agent-native/core 0.102.2 → 0.103.0

package/corpus/templates/content/actions/sync-manifest-local-folder-source.ts

@@ -0,0 +1,123 @@
+import { defineAction } from "@agent-native/core";
+import {
+  getLocalArtifactApp,
+  listConfiguredLocalArtifactFiles,
+  readConfiguredLocalArtifactFile,
+  type LocalArtifactOptions,
+} from "@agent-native/core/local-artifacts";
+import { z } from "zod";
+
+import { parseContentSourceFile } from "../shared/content-source.js";
+import connectLocalFolderSource from "./connect-local-folder-source.js";
+import syncLocalFolderSource from "./sync-local-folder-source.js";
+
+const CONTENT_LOCAL_DEFAULTS: LocalArtifactOptions["defaults"] = {
+  roots: [],
+  components: "components",
+  hide: ["**/_*.md", "**/_*.mdx"],
+};
+
+function localOptions(): LocalArtifactOptions {
+  return { appId: "content", defaults: CONTENT_LOCAL_DEFAULTS };
+}
+
+export default defineAction({
+  description:
+    "Bootstrap a manifest-declared local-folder source through the trusted local server bridge into normal SQL-backed Content.",
+  schema: z.object({
+    connectionId: z.string().min(1).max(300),
+    file: z.string().optional(),
+    spaceId: z.string().optional(),
+    dryRun: z.boolean().optional().default(false),
+  }),
+  run: async ({ connectionId, file, spaceId, dryRun }) => {
+    const options = localOptions();
+    const app = await getLocalArtifactApp(options);
+    const root = app.roots.find(
+      (candidate) =>
+        candidate.source?.type === "local-folder" &&
+        candidate.source.connectionId === connectionId,
+    );
+    if (!root) {
+      throw new Error(
+        `Local folder connection "${connectionId}" is not declared in agent-native.json`,
+      );
+    }
+    const source = root.source;
+    if (!source || source.type !== "local-folder") {
+      throw new Error(`Local folder connection "${connectionId}" is invalid`);
+    }
+    const metadata = (await listConfiguredLocalArtifactFiles(options)).filter(
+      (candidate) => candidate.rootPath === root.path,
+    );
+    const files: Record<string, string> = {};
+    for (const candidate of metadata) {
+      const loaded = await readConfiguredLocalArtifactFile({
+        ...options,
+        path: candidate.path,
+      });
+      if (loaded) files[candidate.path] = loaded.content;
+    }
+    if (file && !Object.prototype.hasOwnProperty.call(files, file)) {
+      throw new Error(`Local file "${file}" is not in the configured folder`);
+    }
+    const connection = await connectLocalFolderSource.run({
+      connectionId,
+      label: root.name,
+      spaceId,
+      createSourceBackedSpace: !spaceId,
+      truthPolicy: source.truthPolicy ?? "source_primary",
+      dryRun,
+    });
+    if (!connection.connected || !connection.sourceId) {
+      const parsed = Object.entries(files).map(([path, content]) =>
+        parseContentSourceFile(path, content),
+      );
+      const valid = parsed.filter((candidate) => !candidate.errors?.length);
+      return {
+        sourceId: null,
+        spaceId: null,
+        filesDatabaseId: null,
+        truthPolicy: source.truthPolicy ?? "source_primary",
+        dryRun: true,
+        filesSeen: parsed.length,
+        created: valid.map((candidate) => ({
+          id: candidate.id ?? "",
+          path: candidate.path,
+          title: candidate.title,
+        })),
+        updated: [],
+        unchanged: [],
+        conflicts: [],
+        outbound: [],
+        skipped: parsed.flatMap((candidate) =>
+          candidate.errors?.length
+            ? [{ path: candidate.path, reason: candidate.errors.join(" ") }]
+            : [],
+        ),
+        errors: parsed.flatMap((candidate) =>
+          candidate.errors?.length
+            ? [{ path: candidate.path, reason: candidate.errors.join(" ") }]
+            : [],
+        ),
+        idByPath: Object.fromEntries(
+          valid.map((candidate) => [candidate.path, candidate.id ?? ""]),
+        ),
+        connectionId,
+        requestedFile: file ?? null,
+        requestedDocumentId: null,
+      };
+    }
+    const result = await syncLocalFolderSource.run({
+      sourceId: connection.sourceId,
+      files,
+      dryRun,
+    });
+    return {
+      ...result,
+      connectionId,
+      requestedFile: file ?? null,
+      requestedDocumentId: file ? (result.idByPath[file] ?? null) : null,
+    };
+  },
+});

package/corpus/templates/content/actions/update-content-database-view.ts

@@ -66,7 +66,16 @@ const viewSchema = z.object({
   id: z.string(),
   name: z.string(),
   type: z
-    .enum(["table", "board", "list", "gallery", "calendar", "timeline", "form"])
+    .enum([
+      "table",
+      "board",
+      "list",
+      "gallery",
+      "calendar",
+      "timeline",
+      "form",
+      "sidebar",
+    ])
     .default("table"),
   sorts: z.array(sortSchema).default([]),
   filters: z.array(filterSchema).default([]),

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

@@ -14,11 +14,6 @@ import type { DocumentUpdateResponse } from "../shared/api.js";
 import { BUILDER_CMS_BODY_CONTENT_KEY } from "./_builder-cms-source-adapter.js";
 import { reconcileInlineDatabasesForDocument } from "./_content-database-lifecycle.js";
 import { serializeDocumentSource } from "./_document-source.js";
-import {
-  isLocalDocumentId,
-  isContentLocalFileMode,
-  updateLocalFileDocument,
-} from "./_local-file-documents.js";
 
 // Not (yet) part of the shared API surface — kept local to avoid touching
 // shared/api.ts, which another workstream owns concurrently. Structural
@@ -198,16 +193,6 @@ export default defineAction({
     const isAgentCaller =
       ctx?.caller === "tool" || ctx?.caller === "mcp" || ctx?.caller === "a2a";
 
-    if ((await isContentLocalFileMode()) && isLocalDocumentId(id)) {
-      const doc = await updateLocalFileDocument(id, args);
-      await writeAppState("refresh-signal", { ts: Date.now() });
-      return {
-        ...doc,
-        urlPath: `/page/${doc.id}`,
-        softDeletedDatabaseIds: [],
-      };
-    }
-
     const access = await assertAccess("document", id, "editor");
     const existing = access.resource;
     const ownerEmail = existing.ownerEmail as string;

package/corpus/templates/content/actions/view-screen.ts

@@ -37,14 +37,6 @@ import {
   getDocumentContextPath,
   serializeDatabaseMembership,
 } from "./_database-utils.js";
-import { serializeDocumentSource } from "./_document-source.js";
-import {
-  getLocalFileDocument,
-  getLocalDocumentContextPath,
-  isContentLocalFileMode,
-  isLocalDocumentId,
-  localContentViewScreenSummary,
-} from "./_local-file-documents.js";
 import {
   listPropertiesForDocument,
   serializeDatabase,
@@ -659,53 +651,13 @@ export default defineAction({
   run: async () => {
     const navigation = await readAppStateForCurrentTab("navigation");
     const localFilesState = await readAppState("local-files");
+    const contentSpaceState = await readAppState("content-space");
 
     const screen: Record<string, unknown> = {};
     if (navigation) screen.navigation = navigation;
+    if (contentSpaceState) screen.contentSpace = contentSpaceState;
 
     const nav = navigation as NavigationState | null;
-    if (await isContentLocalFileMode()) {
-      screen.localFiles = {
-        ...(await localContentViewScreenSummary()),
-        actions: [
-          "list-documents",
-          "get-document",
-          "create-document",
-          "update-document",
-          "delete-document",
-          "share-local-file-document",
-        ],
-      };
-      if (nav?.documentId && isLocalDocumentId(nav.documentId)) {
-        screen.document = {
-          ...(await getLocalFileDocument(nav.documentId)),
-          contextPath: await getLocalDocumentContextPath(nav.documentId),
-        };
-      } else if (nav?.documentId) {
-        const access = await resolveAccess("document", nav.documentId);
-        if (access) {
-          const doc = access.resource;
-          screen.document = {
-            id: doc.id,
-            parentId: doc.parentId,
-            title: doc.title,
-            content: doc.content,
-            description: doc.description,
-            icon: doc.icon,
-            position: doc.position,
-            isFavorite: parseDocumentFavorite(doc.isFavorite),
-            hideFromSearch: parseDocumentHideFromSearch(doc.hideFromSearch),
-            visibility: doc.visibility,
-            source: serializeDocumentSource(doc),
-            createdAt: doc.createdAt,
-            updatedAt: doc.updatedAt,
-            contextPath: await getDocumentContextPath(doc),
-          };
-        }
-      }
-      return screen;
-    }
-
     const db = getDb();
 
     if (nav?.view === "local-files") {

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

@@ -10,6 +10,8 @@ import {
   IconH2,
   IconH3,
   IconH4,
+  IconH5,
+  IconH6,
   IconList,
   IconListNumbers,
   IconSquareCheck,
@@ -77,7 +79,7 @@ interface EquationDraft {
   position: EditorMenuPosition;
 }
 
-interface CommandItem {
+export interface CommandItem {
   title: string;
   description: string;
   searchText?: string;
@@ -114,11 +116,81 @@ function waitForEditorUpdateFrame() {
   });
 }
 
-interface CommandTemplate extends Omit<CommandItem, "title" | "description"> {
+export interface CommandTemplate extends Omit<
+  CommandItem,
+  "title" | "description"
+> {
   titleKey: string;
   descriptionKey: string;
 }
 
+export const CONTENT_HEADING_LEVELS = [1, 2, 3, 4, 5, 6] as const;
+
+const headingCommandMetadata = [
+  {
+    level: 1,
+    titleKey: "editor.heading1",
+    descriptionKey: "editor.slash.heading1Description",
+    shortcut: "#",
+    icon: IconH1,
+  },
+  {
+    level: 2,
+    titleKey: "editor.heading2",
+    descriptionKey: "editor.slash.heading2Description",
+    shortcut: "##",
+    icon: IconH2,
+  },
+  {
+    level: 3,
+    titleKey: "editor.heading3",
+    descriptionKey: "editor.slash.heading3Description",
+    shortcut: "###",
+    icon: IconH3,
+  },
+  {
+    level: 4,
+    titleKey: "editor.heading4",
+    descriptionKey: "editor.slash.heading4Description",
+    shortcut: "####",
+    icon: IconH4,
+  },
+  {
+    level: 5,
+    titleKey: "editor.heading5",
+    descriptionKey: "editor.slash.heading5Description",
+    shortcut: "#####",
+    icon: IconH5,
+  },
+  {
+    level: 6,
+    titleKey: "editor.heading6",
+    descriptionKey: "editor.slash.heading6Description",
+    shortcut: "######",
+    icon: IconH6,
+  },
+] as const satisfies ReadonlyArray<{
+  level: (typeof CONTENT_HEADING_LEVELS)[number];
+  titleKey: string;
+  descriptionKey: string;
+  shortcut: string;
+  icon: React.ElementType;
+}>;
+
+export function buildHeadingCommands(
+  behavior: "toggle" | "set",
+): CommandTemplate[] {
+  return headingCommandMetadata.map((heading) => ({
+    ...heading,
+    action: (editor) => {
+      const chain = editor.chain().focus();
+      return behavior === "toggle"
+        ? chain.toggleHeading({ level: heading.level }).run()
+        : chain.setHeading({ level: heading.level }).run();
+    },
+  }));
+}
+
 export function setPlainTextBlock(editor: Editor) {
   const chain = editor.chain().focus();
   if (typeof (chain as any).setParagraph === "function") {
@@ -239,38 +311,7 @@ const commands: CommandTemplate[] = [
     icon: IconTypography,
     action: setPlainTextBlock,
   },
-  {
-    titleKey: "editor.heading1",
-    descriptionKey: "editor.slash.heading1Description",
-    shortcut: "#",
-    icon: IconH1,
-    action: (editor) =>
-      editor.chain().focus().toggleHeading({ level: 1 }).run(),
-  },
-  {
-    titleKey: "editor.heading2",
-    descriptionKey: "editor.slash.heading2Description",
-    shortcut: "##",
-    icon: IconH2,
-    action: (editor) =>
-      editor.chain().focus().toggleHeading({ level: 2 }).run(),
-  },
-  {
-    titleKey: "editor.heading3",
-    descriptionKey: "editor.slash.heading3Description",
-    shortcut: "###",
-    icon: IconH3,
-    action: (editor) =>
-      editor.chain().focus().toggleHeading({ level: 3 }).run(),
-  },
-  {
-    titleKey: "editor.heading4",
-    descriptionKey: "editor.slash.heading4Description",
-    shortcut: "####",
-    icon: IconH4,
-    action: (editor) =>
-      editor.chain().focus().toggleHeading({ level: 4 }).run(),
-  },
+  ...buildHeadingCommands("toggle"),
   {
     titleKey: "editor.slash.bulletedList",
     descriptionKey: "editor.slash.bulletedListDescription",
@@ -367,34 +408,7 @@ const turnIntoCommands: CommandTemplate[] = [
     icon: IconTypography,
     action: setPlainTextBlock,
   },
-  {
-    titleKey: "editor.heading1",
-    descriptionKey: "editor.slash.heading1Description",
-    shortcut: "#",
-    icon: IconH1,
-    action: (editor) => editor.chain().focus().setHeading({ level: 1 }).run(),
-  },
-  {
-    titleKey: "editor.heading2",
-    descriptionKey: "editor.slash.heading2Description",
-    shortcut: "##",
-    icon: IconH2,
-    action: (editor) => editor.chain().focus().setHeading({ level: 2 }).run(),
-  },
-  {
-    titleKey: "editor.heading3",
-    descriptionKey: "editor.slash.heading3Description",
-    shortcut: "###",
-    icon: IconH3,
-    action: (editor) => editor.chain().focus().setHeading({ level: 3 }).run(),
-  },
-  {
-    titleKey: "editor.heading4",
-    descriptionKey: "editor.slash.heading4Description",
-    shortcut: "####",
-    icon: IconH4,
-    action: (editor) => editor.chain().focus().setHeading({ level: 4 }).run(),
-  },
+  ...buildHeadingCommands("set"),
   {
     titleKey: "editor.slash.bulletedList",
     descriptionKey: "editor.slash.bulletedListDescription",

package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx

@@ -116,6 +116,7 @@ import {
   IconGripVertical,
   IconLayoutKanban,
   IconLayoutGrid,
+  IconLayoutSidebar,
   IconList,
   IconLock,
   IconMinus,
@@ -248,6 +249,7 @@ import { VisualEditor } from "../VisualEditor";
 import { DatabaseFormView } from "./FormView";
 import { DatabaseGalleryView } from "./GalleryView";
 import { DatabaseListView } from "./ListView";
+import { DatabaseSidebarView } from "./sidebar";
 import { DatabaseTimelineView } from "./TimelineView";
 
 export interface DatabaseViewProps {
@@ -307,6 +309,7 @@ const DATABASE_VIEW_TYPES: ContentDatabaseViewType[] = [
   "timeline",
   "calendar",
   "form",
+  "sidebar",
 ];
 const DATABASE_OPEN_PAGES_IN: ContentDatabaseOpenPagesIn[] = [
   "preview",
@@ -2010,6 +2013,27 @@ function DatabaseTable({
     orderedProperties,
     visibleItems,
   ]);
+  const sidebarGroups = useMemo(
+    () =>
+      databaseVisibleGroups(
+        databaseViewItemGroups(
+          visibleItems,
+          orderedProperties,
+          activeView.groupByPropertyId,
+        ),
+        activeView.hideEmptyGroups === true,
+      ),
+    [
+      activeView.groupByPropertyId,
+      activeView.hideEmptyGroups,
+      orderedProperties,
+      visibleItems,
+    ],
+  );
+  const sidebarIsGrouped = useMemo(
+    () => !!databaseViewGroupingProperty(activeView, orderedProperties),
+    [activeView, orderedProperties],
+  );
 
   useEffect(() => {
     if (!data?.database.id) return;
@@ -2433,6 +2457,22 @@ function DatabaseTable({
           onDeletedPreviewItem={handleDeletedPreviewItem}
           onOpenPage={openItemPage}
         />
+      ) : activeView.type === "sidebar" ? (
+        <DatabaseSidebarView
+          key={activeView.id}
+          groups={sidebarGroups}
+          grouped={sidebarIsGrouped}
+          isLoading={isDatabaseViewLoading}
+          hasActiveConstraints={hasResultConstraints}
+          openPagesIn={activeView.openPagesIn ?? "preview"}
+          loadingLabel={dbText("loadingList")}
+          noMatchesLabel={dbText("noRowsMatchThisView")}
+          clearLabel={dbText("clearSearchAndFilters")}
+          navigationLabel={dbText("databasePagePreview")}
+          untitledLabel={dbText("untitled")}
+          onClearResultConstraints={clearSearchAndFilters}
+          onPreview={previewItemPage}
+        />
       ) : activeView.type === "list" ? (
         <DatabaseListView
           properties={tableProperties}
@@ -7625,20 +7665,19 @@ function DatabaseSettingsSourcePanel({
         source={secondary}
         canEdit={canEdit}
         pending={sourceActionPending}
-        onAddDetails={() =>
-          secondary
-            ? onNavPush({
-                kind: "keyConfirm",
-                candidate: {
-                  sourceType: secondary.sourceType,
-                  sourceName: secondary.sourceName,
-                  sourceTable: secondary.sourceTable,
-                  displayName: secondary.sourceName,
-                  existingSourceId: secondary.id,
-                },
-              })
-            : undefined
-        }
+        onAddDetails={() => {
+          if (!secondary || secondary.sourceType === "local-folder") return;
+          onNavPush({
+            kind: "keyConfirm",
+            candidate: {
+              sourceType: secondary.sourceType,
+              sourceName: secondary.sourceName,
+              sourceTable: secondary.sourceTable,
+              displayName: secondary.sourceName,
+              existingSourceId: secondary.id,
+            },
+          });
+        }}
         onAddItems={async () => {
           if (!secondary) return;
           await onChangeSourceRole(secondary.id, "items");
@@ -8151,12 +8190,17 @@ function DatabaseSettingsSourcePanel({
 
         <SourceRoleCard
           source={selectedSource}
-          canAddDetails={sources.some(
-            (item) => item.id !== selectedSource.id && !sourceAddsDetails(item),
-          )}
+          canAddDetails={
+            selectedSource.sourceType !== "local-folder" &&
+            sources.some(
+              (item) =>
+                item.id !== selectedSource.id && !sourceAddsDetails(item),
+            )
+          }
           canEdit={canEdit}
           pending={selectedSourceRoleControlPending}
-          onAddDetails={() =>
+          onAddDetails={() => {
+            if (selectedSource.sourceType === "local-folder") return;
             onNavPush({
               kind: "keyConfirm",
               candidate: {
@@ -8166,8 +8210,8 @@ function DatabaseSettingsSourcePanel({
                 displayName: selectedSource.sourceName,
                 existingSourceId: selectedSource.id,
               },
-            })
-          }
+            });
+          }}
           onAddItems={async () => {
             await onChangeSourceRole(selectedSource.id, "items");
             onNavReplace([]);
@@ -12988,7 +13032,8 @@ function normalizeClientDatabaseView(
     value.type === "gallery" ||
     value.type === "calendar" ||
     value.type === "timeline" ||
-    value.type === "form"
+    value.type === "form" ||
+    value.type === "sidebar"
       ? value.type
       : "table";
   return createDatabaseView(
@@ -13524,6 +13569,7 @@ function databaseViewIcon(type: ContentDatabaseViewType) {
   if (type === "calendar") return IconCalendar;
   if (type === "timeline") return IconTimeline;
   if (type === "form") return IconForms;
+  if (type === "sidebar") return IconLayoutSidebar;
   return IconTable;
 }
 
@@ -13534,6 +13580,7 @@ function databaseViewDefaultName(type: ContentDatabaseViewType) {
   if (type === "calendar") return "Calendar";
   if (type === "timeline") return "Timeline";
   if (type === "form") return "Form";
+  if (type === "sidebar") return "Sidebar";
   return "Table";
 }
 
@@ -13584,7 +13631,8 @@ export function databaseViewGroupingProperty(
   if (
     view.type !== "table" &&
     view.type !== "list" &&
-    view.type !== "gallery"
+    view.type !== "gallery" &&
+    view.type !== "sidebar"
   ) {
     return null;
   }

package/corpus/templates/content/app/components/editor/database/grouping.ts

@@ -73,7 +73,8 @@ export function databaseViewGroupingProperty(
   if (
     view.type !== "table" &&
     view.type !== "list" &&
-    view.type !== "gallery"
+    view.type !== "gallery" &&
+    view.type !== "sidebar"
   ) {
     return null;
   }

package/corpus/templates/content/app/components/editor/database/settings.tsx

@@ -768,20 +768,19 @@ function DatabaseSettingsSourcePanel({
         source={secondary}
         canEdit={canEdit}
         pending={sourceActionPending}
-        onAddDetails={() =>
-          secondary
-            ? onNavPush({
-                kind: "keyConfirm",
-                candidate: {
-                  sourceType: secondary.sourceType,
-                  sourceName: secondary.sourceName,
-                  sourceTable: secondary.sourceTable,
-                  displayName: secondary.sourceName,
-                  existingSourceId: secondary.id,
-                },
-              })
-            : undefined
-        }
+        onAddDetails={() => {
+          if (!secondary || secondary.sourceType === "local-folder") return;
+          onNavPush({
+            kind: "keyConfirm",
+            candidate: {
+              sourceType: secondary.sourceType,
+              sourceName: secondary.sourceName,
+              sourceTable: secondary.sourceTable,
+              displayName: secondary.sourceName,
+              existingSourceId: secondary.id,
+            },
+          });
+        }}
         onAddItems={async () => {
           if (!secondary) return;
           await onChangeSourceRole(secondary.id, "items");
@@ -1142,12 +1141,16 @@ function DatabaseSettingsSourcePanel({
 
         <SourceRoleCard
           source={source}
-          canAddDetails={sources.some(
-            (item) => item.id !== source.id && !sourceAddsDetails(item),
-          )}
+          canAddDetails={
+            source.sourceType !== "local-folder" &&
+            sources.some(
+              (item) => item.id !== source.id && !sourceAddsDetails(item),
+            )
+          }
           canEdit={canEdit}
           pending={sourceActionPending}
-          onAddDetails={() =>
+          onAddDetails={() => {
+            if (source.sourceType === "local-folder") return;
             onNavPush({
               kind: "keyConfirm",
               candidate: {
@@ -1157,8 +1160,8 @@ function DatabaseSettingsSourcePanel({
                 displayName: source.sourceName,
                 existingSourceId: source.id,
               },
-            })
-          }
+            });
+          }}
           onAddItems={async () => {
             await onChangeSourceRole(source.id, "items");
             onNavReplace([]);

package/corpus/templates/content/app/components/editor/database/shared.tsx

@@ -18,6 +18,7 @@ import {
   IconFilter,
   IconLayoutGrid,
   IconLayoutKanban,
+  IconLayoutSidebar,
   IconList,
   IconMinus,
   IconSearch,
@@ -71,6 +72,7 @@ export function databaseViewIcon(type: ContentDatabaseViewType) {
   if (type === "calendar") return IconCalendar;
   if (type === "timeline") return IconTimeline;
   if (type === "form") return IconForms;
+  if (type === "sidebar") return IconLayoutSidebar;
   return IconTable;
 }