@agent-native/core-corpus 0.213.1 → 0.214.0

package/corpus/README.md

@@ -32,4 +32,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core-corpus/corpu
 
 ## Generated Counts
 
-- template files: 13662
+- template files: 13667

package/corpus/templates/community/qr/package.json

@@ -11,7 +11,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@agent-native/core": "^0.213.1",
+    "@agent-native/core": "^0.214.0",
     "postgres": "^3.4.9",
     "qrcode": "^1.5.4",
     "zod": "^4.6.7"

package/corpus/templates/content/.agents/skills/document-editing/references/databases.md

@@ -88,7 +88,7 @@ stable IDs identify edits. Sparse patches preserve omitted fields, and empty
 lists explicitly clear supported settings.
 
 Ordinary setup supports stored property types, additive options, metadata edits,
-the existing text natural key, and table presentation. It refuses destructive
+the existing text natural key, table presentation, and list row layouts. It refuses destructive
 type/option changes, source-managed schema edits, and relationship/computed-field
 authoring. Source status is readable, but this surface does not define joins,
 row unions, source bindings, or write-mode changes. Discovery of a source-backed
@@ -230,6 +230,20 @@ all fields for the current view, and it includes a New property control for
 adding fields without returning to the table header. The New property picker
 supports searching property types by label or machine name.
 
+List views can save an item layout (`itemLayout`) that decides what each row
+shows: a start slot (page icon, a checkbox property, a status property, or
+nothing), the title weight, line 2 (a text, URL, or non-body Blocks property,
+clamped to 1-3 lines), and ordered property IDs for line 3 and the end of the
+row; end values move under the title on narrow screens and empty values take
+no space. Ticking a row's checkbox writes the property through
+`set-document-property` and strikes the title through without moving the row.
+A view without `itemLayout` keeps the default rows. Agents update it with an
+`update-content-database-view` `update` patch on the list view: pass
+`itemLayoutPreset` (`checklist`, `reminders`, `tracker`, `digest`, or
+`default`), sparse `itemLayout` slots (omitted slots keep their value), or
+`itemLayout: null` to restore the default rows. List views accept only name,
+icon, and these layout fields on this path.
+
 In unconstrained table views, row drag handles can reorder collection item
 pages through `move-database-item`; pass both `databaseId` and `itemId` so the
 membership target is exact, and clear search, sort, and filters before manual

package/corpus/templates/content/CHANGELOG.md

@@ -11,6 +11,10 @@ time from the command menu (Cmd+K → "What's new").
 
 ## 2026-10-19
 
+### Added
+
+- List rows can be customized: start from a preset like **Checklist**, then choose what shows before, under, and after each title
+
 ### Improved
 
 - You can comment on text in any Blocks field tab; each tab shows its open comments, and the Comments panel groups and filters them by tab
@@ -18,6 +22,7 @@ time from the command menu (Cmd+K → "What's new").
 
 ### Fixed
 
+- List views no longer run off the side of the screen on phones
 - Edits made from a block's menu or a table's row and column menus, such as deleting a table, adding a row or turning off the header row, are now saved instead of coming back after a reload
 - Starting a comment puts the cursor in the comment box, ready to type.
 - Table row and column options now appear for the row or column under the pointer, Escape selects the cell before leaving the editor, wide tables keep their add-column control on screen on phones, and a tap near a table's edge on a touch screen edits the cell there instead of adding a row or column

package/corpus/templates/content/actions/_database-view-setup.ts

@@ -8,11 +8,30 @@ import { syncPrivateViewIconReferences } from "../server/lib/private-icon-refere
 import {
   CONTENT_DATABASE_FILTER_OPERATORS,
   type ContentDatabaseFilter,
+  type ContentDatabaseItemLayout,
   type ContentDatabaseView,
   type ContentDatabaseViewConfig,
 } from "../shared/api.js";
+import {
+  CONTENT_DATABASE_ITEM_LAYOUT_PRESET_IDS,
+  CONTENT_DATABASE_ITEM_LEADING_KINDS,
+  CONTENT_DATABASE_ITEM_TITLE_WEIGHTS,
+  MAX_ITEM_LAYOUT_META_PROPERTIES,
+  contentDatabaseItemLayoutPresets,
+  contentDatabaseItemLayoutReferenceErrors,
+  dropDeletedContentDatabaseItemLayoutReferences,
+  itemLayoutLeadingCandidates,
+  normalizeContentDatabaseItemLayout,
+  pruneContentDatabaseItemLayout,
+  savableContentDatabaseItemLayout,
+  startingContentDatabaseItemLayout,
+} from "../shared/database-item-layout.js";
 import { contentDatabaseFilterOperatorsForType } from "../shared/database-query.js";
-import type { DocumentPropertyType } from "../shared/properties.js";
+import {
+  normalizePropertyVisibility,
+  parsePropertyOptions,
+  type DocumentPropertyType,
+} from "../shared/properties.js";
 import {
   runDatabaseSetupMutation,
   setupError,
@@ -76,6 +95,77 @@ const tablePatchFields = {
   openPagesIn: z.enum(["preview", "full_page"]).optional(),
 };
 
+const itemLayoutPropertyIdSchema = z.string().trim().min(1).max(200);
+const itemLayoutLinesSchema = z.union([
+  z.literal(1),
+  z.literal(2),
+  z.literal(3),
+]);
+const itemLayoutMetaSchema = z
+  .array(itemLayoutPropertyIdSchema)
+  .max(MAX_ITEM_LAYOUT_META_PROPERTIES);
+
+export const contentDatabaseItemLayoutSchema = z
+  .object({
+    leading: z
+      .object({
+        kind: z.enum(CONTENT_DATABASE_ITEM_LEADING_KINDS),
+        propertyId: itemLayoutPropertyIdSchema.nullable(),
+      })
+      .strict(),
+    titleWeight: z.enum(CONTENT_DATABASE_ITEM_TITLE_WEIGHTS),
+    line2: z
+      .object({
+        propertyId: itemLayoutPropertyIdSchema.nullable(),
+        lines: itemLayoutLinesSchema,
+      })
+      .strict(),
+    line3: itemLayoutMetaSchema,
+    trailing: itemLayoutMetaSchema,
+  })
+  .strict();
+
+const itemLayoutPatchSchema = z
+  .object({
+    leading: z
+      .object({
+        kind: z.enum(CONTENT_DATABASE_ITEM_LEADING_KINDS),
+        propertyId: itemLayoutPropertyIdSchema.nullable().optional(),
+      })
+      .strict()
+      .optional(),
+    titleWeight: z.enum(CONTENT_DATABASE_ITEM_TITLE_WEIGHTS).optional(),
+    line2: z
+      .object({
+        propertyId: itemLayoutPropertyIdSchema.nullable().optional(),
+        lines: itemLayoutLinesSchema.optional(),
+      })
+      .strict()
+      .optional(),
+    line3: itemLayoutMetaSchema.optional(),
+    trailing: itemLayoutMetaSchema.optional(),
+  })
+  .strict()
+  .describe(
+    "List views only. Slots to change in each row; omitted slots keep their saved value. leading.kind checkbox or status uses the first property of that type unless propertyId names one. line2 shows a text, URL, or Blocks property; line3 and trailing list property IDs in order. Trailing values move under the title on narrow screens. Pass null to restore the default rows.",
+  );
+
+const listPatchFields = {
+  itemLayout: itemLayoutPatchSchema.nullable().optional(),
+  itemLayoutPreset: z
+    .enum(CONTENT_DATABASE_ITEM_LAYOUT_PRESET_IDS)
+    .optional()
+    .describe(
+      "List views only. Starts the rows from a preset before itemLayout applies: checklist (checkbox, bold title, two lines of text), reminders (checkbox, one line of text, date, person and tag under it), tracker (status dot, tag, person and date on the right), digest (page icon, bold title, three lines of text, details under it), or default.",
+    ),
+};
+
+const LIST_VIEW_PATCH_KEYS = new Set([
+  "name",
+  "icon",
+  ...Object.keys(listPatchFields),
+]);
+
 const boundedTablePatchSchema = z
   .object(tablePatchFields)
   .strict()
@@ -91,11 +181,12 @@ const boundedTablePatchSchema = z
     }
   });
 
-const updateTablePatchSchema = z
+const updateViewPatchSchema = z
   .object({
     name: z.string().trim().min(1).max(500).optional(),
     icon: iconValueSchema.nullable().optional(),
     ...tablePatchFields,
+    ...listPatchFields,
   })
   .strict()
   .refine(
@@ -125,7 +216,7 @@ export const updateContentDatabaseViewAgentSchema = z.discriminatedUnion(
         expectedConfigurationRevision: z.string().min(1),
         operation: z.literal("update"),
         viewId: z.string().trim().min(1).max(200),
-        patch: updateTablePatchSchema,
+        patch: updateViewPatchSchema,
       })
       .strict(),
   ],
@@ -147,7 +238,7 @@ function uniqueReferences(values: readonly string[], field: string) {
 
 function validateTablePatch(
   patch:
-    | z.infer<typeof updateTablePatchSchema>
+    | z.infer<typeof updateViewPatchSchema>
     | z.infer<typeof boundedTablePatchSchema>,
   definitions: readonly (typeof schema.documentPropertyDefinitions.$inferSelect)[],
 ) {
@@ -228,6 +319,174 @@ function validateTablePatch(
   }
 }
 
+type PropertyDefinitionRow =
+  typeof schema.documentPropertyDefinitions.$inferSelect;
+
+function itemLayoutProperties(definitions: readonly PropertyDefinitionRow[]) {
+  return definitions.map((definition) => ({
+    definition: {
+      id: definition.id,
+      type: definition.type as DocumentPropertyType,
+      options: parsePropertyOptions(definition.optionsJson),
+      visibility: normalizePropertyVisibility(definition.visibility),
+    },
+  }));
+}
+
+/**
+ * Checks the layout a full-view save carries against the view's saved one:
+ * new slot references the rows can't show are dropped, saved ones stay.
+ */
+export function withSavableItemLayout<
+  T extends { itemLayout?: unknown; hiddenPropertyIds?: unknown },
+>(
+  view: T,
+  savedLayout: unknown,
+  definitions: readonly PropertyDefinitionRow[],
+): T {
+  const layout = normalizeContentDatabaseItemLayout(view.itemLayout);
+  return layout
+    ? {
+        ...view,
+        itemLayout: savableContentDatabaseItemLayout(
+          layout,
+          normalizeContentDatabaseItemLayout(savedLayout),
+          itemLayoutProperties(definitions),
+          Array.isArray(view.hiddenPropertyIds) ? view.hiddenPropertyIds : [],
+        ),
+      }
+    : view;
+}
+
+/**
+ * A view's properties in the order its UI lists them, so presets and slot
+ * defaults pick the same first checkbox, status or text field the UI does.
+ */
+function viewOrderedDefinitions(
+  view: ContentDatabaseView,
+  definitions: readonly PropertyDefinitionRow[],
+) {
+  const order = view.propertyOrderIds ?? [];
+  const rank = (id: string) => {
+    const index = order.indexOf(id);
+    return index < 0 ? order.length : index;
+  };
+  return [...definitions].sort(
+    (a, b) => rank(a.id) - rank(b.id) || a.position - b.position,
+  );
+}
+
+/**
+ * The default rows' properties as the view's settings define them: those not
+ * hidden, in its order. The rows also leave out a "hide when empty" property
+ * that none of the loaded rows fills; the server doesn't see which rows the
+ * view loads, so it keeps those, and their blank values take no space.
+ */
+function defaultListRowProperties(
+  view: ContentDatabaseView,
+  definitions: readonly PropertyDefinitionRow[],
+) {
+  const hidden = new Set(view.hiddenPropertyIds ?? []);
+  return itemLayoutProperties(
+    viewOrderedDefinitions(view, definitions).filter(
+      (definition) =>
+        definition.visibility !== "always_hide" && !hidden.has(definition.id),
+    ),
+  );
+}
+
+/**
+ * Applies an agent's item layout patch to a list view. Returns undefined
+ * when the patch leaves the layout alone and null to restore default rows.
+ */
+function nextListItemLayout(
+  patch: z.infer<typeof updateViewPatchSchema>,
+  view: ContentDatabaseView,
+  definitions: readonly PropertyDefinitionRow[],
+): ContentDatabaseItemLayout | null | undefined {
+  const { itemLayout, itemLayoutPreset } = patch;
+  if (itemLayout === undefined && itemLayoutPreset === undefined) {
+    return undefined;
+  }
+  if (itemLayout === null && itemLayoutPreset !== undefined) {
+    setupError(
+      "INVALID_VIEW_REFERENCE",
+      "Pass itemLayoutPreset or itemLayout: null, not both.",
+      400,
+    );
+  }
+  if (itemLayout === null) return null;
+  const allProperties = itemLayoutProperties(
+    viewOrderedDefinitions(view, definitions),
+  );
+  // Properties hidden in this view can't be put in a slot, as in the UI.
+  const hidden = new Set(view.hiddenPropertyIds ?? []);
+  const properties = allProperties.filter(
+    (property) => !hidden.has(property.definition.id),
+  );
+  let base = view.itemLayout ?? null;
+  if (itemLayoutPreset !== undefined) {
+    const preset = contentDatabaseItemLayoutPresets(properties).find(
+      (candidate) => candidate.id === itemLayoutPreset,
+    )!;
+    if (preset.missingPropertyType) {
+      setupError(
+        "INVALID_VIEW_REFERENCE",
+        `The ${preset.id} preset needs a ${preset.missingPropertyType} property.`,
+        400,
+      );
+    }
+    base = preset.layout;
+  }
+  if (!itemLayout) {
+    return (
+      base &&
+      dropDeletedContentDatabaseItemLayoutReferences(base, allProperties)
+    );
+  }
+  base ??= startingContentDatabaseItemLayout(
+    defaultListRowProperties(view, definitions),
+  );
+  for (const slot of ["line3", "trailing"] as const) {
+    const ids = itemLayout[slot];
+    if (ids) uniqueReferences(ids, slot);
+  }
+  const leading = itemLayout.leading && {
+    kind: itemLayout.leading.kind,
+    propertyId:
+      itemLayout.leading.propertyId ??
+      itemLayoutLeadingCandidates(properties, itemLayout.leading.kind)[0]
+        ?.definition.id ??
+      null,
+  };
+  const withPatch = (from: ContentDatabaseItemLayout) =>
+    normalizeContentDatabaseItemLayout({
+      leading: leading ?? from.leading,
+      titleWeight: itemLayout.titleWeight ?? from.titleWeight,
+      line2: {
+        propertyId:
+          itemLayout.line2?.propertyId !== undefined
+            ? itemLayout.line2.propertyId
+            : from.line2.propertyId,
+        lines: itemLayout.line2?.lines ?? from.line2.lines,
+      },
+      line3: itemLayout.line3 ?? from.line3,
+      trailing: itemLayout.trailing ?? from.trailing,
+    })!;
+  // Only the slots this patch names are checked. Saved slots that name a
+  // hidden property keep it for when it's shown again, and saved slots that
+  // name a deleted one drop it; neither fails an unrelated edit.
+  const [error] = contentDatabaseItemLayoutReferenceErrors(
+    withPatch(pruneContentDatabaseItemLayout(base, properties)),
+    properties,
+  );
+  if (error) setupError("INVALID_VIEW_REFERENCE", error, 400);
+  return dropDeletedContentDatabaseItemLayoutReferences(
+    withPatch(base),
+    allProperties,
+  );
+}
+
 function parseRawConfig(value: string | null) {
   if (!value) return {} as Record<string, unknown>;
   try {
@@ -373,14 +632,43 @@ export async function runUpdateContentDatabaseView(
             404,
           );
         }
-        if (existing.type !== "table") {
+        const patchKeys = Object.keys(input.patch);
+        let patch: Record<string, unknown> = input.patch;
+        if (existing.type === "list") {
+          const unsupported = patchKeys.find(
+            (key) => !LIST_VIEW_PATCH_KEYS.has(key),
+          );
+          if (unsupported) {
+            setupError(
+              "UNSUPPORTED_SCHEMA_CHANGE",
+              `List views accept only name, icon, itemLayout, and itemLayoutPreset here, not ${unsupported}.`,
+              400,
+            );
+          }
+          const { itemLayoutPreset: _preset, ...rest } = input.patch;
+          const itemLayout = nextListItemLayout(
+            input.patch,
+            existing,
+            context.definitions,
+          );
+          patch = itemLayout === undefined ? rest : { ...rest, itemLayout };
+        } else if (existing.type === "table") {
+          const listKey = patchKeys.find((key) => key in listPatchFields);
+          if (listKey) {
+            setupError(
+              "UNSUPPORTED_SCHEMA_CHANGE",
+              `${listKey} applies only to list views.`,
+              400,
+            );
+          }
+          validateTablePatch(input.patch, context.definitions);
+        } else {
           setupError(
             "UNSUPPORTED_SCHEMA_CHANGE",
-            "Ordinary database setup can update only table views.",
+            "Ordinary database setup can update only table and list views.",
             400,
           );
         }
-        validateTablePatch(input.patch, context.definitions);
         viewId = existing.id;
         const index = rawViews.findIndex(
           (view) =>
@@ -398,7 +686,7 @@ export async function runUpdateContentDatabaseView(
         nextViews = [...rawViews];
         nextViews[index] = {
           ...(rawViews[index] as Record<string, unknown>),
-          ...input.patch,
+          ...patch,
         };
       }
 
@@ -480,9 +768,15 @@ export async function runReplaceContentDatabaseViews(input: {
             typeof candidate === "object" &&
             (candidate as { id?: unknown }).id === view.id,
         );
-        return saved && typeof saved === "object"
-          ? { ...(saved as Record<string, unknown>), ...view }
-          : view;
+        const savedView =
+          saved && typeof saved === "object"
+            ? (saved as Record<string, unknown>)
+            : null;
+        return withSavableItemLayout(
+          savedView ? { ...savedView, ...view } : view,
+          savedView?.itemLayout,
+          context.definitions,
+        );
       });
       const nextRaw: Record<string, unknown> = {
         ...rawConfig,

package/corpus/templates/content/actions/_property-utils.ts

@@ -30,6 +30,7 @@ import type {
   DocumentProperty,
 } from "../shared/api.js";
 import { blocksFieldId } from "../shared/blocks-field-identity.js";
+import { contentDatabaseItemLayoutField } from "../shared/database-item-layout.js";
 import {
   DEFAULT_BLOCKS_FIELD_NAME,
   defaultPropertyOptions,
@@ -398,6 +399,7 @@ function defaultDatabaseView(
     rowDensity: normalizeDatabaseRowDensity(values.rowDensity),
     openPagesIn: normalizeDatabaseOpenPagesIn(values.openPagesIn),
     formQuestions: normalizeDatabaseFormQuestions(values.formQuestions),
+    ...contentDatabaseItemLayoutField(values.itemLayout),
   };
 }
 
@@ -460,6 +462,7 @@ function normalizeDatabaseView(value: unknown): ContentDatabaseView | null {
     rowDensity: normalizeDatabaseRowDensity(view.rowDensity),
     openPagesIn: normalizeDatabaseOpenPagesIn(view.openPagesIn),
     formQuestions: normalizeDatabaseFormQuestions(view.formQuestions),
+    ...contentDatabaseItemLayoutField(view.itemLayout),
   };
 }
 

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

@@ -10,6 +10,7 @@ import { z } from "zod";
 import { getDb, schema } from "../server/db/index.js";
 import { syncPrivateViewIconReferences } from "../server/lib/private-icon-references.js";
 import { CONTENT_DATABASE_FILTER_OPERATORS } from "../shared/api.js";
+import { withSavedContentDatabaseItemLayout } from "../shared/database-item-layout.js";
 import { withSavedTableColumnPresentation } from "../shared/database-table-columns.js";
 import { lockContentDatabaseMutation } from "./_content-database-mutation-lock.js";
 import {
@@ -19,9 +20,11 @@ import {
 } from "./_database-setup-mutation.js";
 import { getContentDatabaseResponse } from "./_database-utils.js";
 import {
+  contentDatabaseItemLayoutSchema,
   runReplaceContentDatabaseViews,
   runUpdateContentDatabaseView,
   updateContentDatabaseViewAgentSchema,
+  withSavableItemLayout,
 } from "./_database-view-setup.js";
 import {
   parseDatabaseViewConfig,
@@ -114,6 +117,7 @@ const viewSchema = z
       .default("default"),
     openPagesIn: z.enum(["preview", "full_page"]).default("preview"),
     formQuestions: z.array(formQuestionSchema).default([]),
+    itemLayout: contentDatabaseItemLayoutSchema.nullable().optional(),
   })
   .strict();
 
@@ -143,7 +147,7 @@ const guardedViewReplacementSchema = setupGuardSchema
 
 export default defineAction({
   description:
-    "Create one named ordinary table view or sparsely update one exact saved table view using stable property IDs, fresh schema and configuration revisions, and an idempotency key.",
+    "Create one named ordinary table view, or sparsely update one exact saved table view or a list view's name, icon, and row layout (itemLayout, itemLayoutPreset), using stable property IDs, fresh schema and configuration revisions, and an idempotency key.",
   mcpTool: true,
   mcpApp: { structuredContent: true },
   agentInputSchema: updateContentDatabaseViewAgentSchema,
@@ -213,10 +217,22 @@ export default defineAction({
       const currentViewConfig = parseDatabaseViewConfig(
         lockedDatabase.viewConfigJson,
       );
+      const definitions = await tx
+        .select()
+        .from(schema.documentPropertyDefinitions)
+        .where(eq(schema.documentPropertyDefinitions.databaseId, databaseId));
       const nextViewConfig = {
         ...viewConfig,
         views: viewConfig.views?.map((view) =>
-          withSavedTableColumnPresentation(view, currentViewConfig.views),
+          withSavableItemLayout(
+            withSavedContentDatabaseItemLayout(
+              withSavedTableColumnPresentation(view, currentViewConfig.views),
+              currentViewConfig.views,
+            ),
+            currentViewConfig.views.find((saved) => saved.id === view.id)
+              ?.itemLayout,
+            definitions,
+          ),
         ),
       };
       const nextViewConfigJson = serializeDatabaseViewConfig(nextViewConfig);

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

@@ -24,6 +24,7 @@ import type {
   ContentDatabaseViewType,
   DocumentProperty,
 } from "../shared/api.js";
+import { normalizeContentDatabaseItemLayout } from "../shared/database-item-layout.js";
 import {
   databaseColumnWraps,
   databaseFrozenColumnIds,
@@ -782,6 +783,17 @@ export function databaseCurrentViewSnapshot(
       "preview",
     formQuestions:
       arrayValue(nav.databaseFormQuestions) ?? activeView?.formQuestions ?? [],
+    ...(viewType === "list"
+      ? {
+          // An explicit null is a reset to default rows that may not be saved yet.
+          itemLayout:
+            nav.databaseItemLayout === null
+              ? null
+              : (normalizeContentDatabaseItemLayout(nav.databaseItemLayout) ??
+                activeView?.itemLayout ??
+                null),
+        }
+      : {}),
     visibleItemCount:
       numberValue(nav.databaseVisibleItemCount) ??
       response.pagination?.returnedItems ??