@agent-native/core 0.80.4 → 0.80.6

package/corpus/templates/clips/app/components/capture-install-options.tsx

@@ -1,4 +1,4 @@
-import { useT } from "@agent-native/core/client";
+import { appPath, useT } from "@agent-native/core/client";
 import {
   IconBrandApple,
   IconBrandChrome,
@@ -8,7 +8,6 @@ import {
   IconExternalLink,
 } from "@tabler/icons-react";
 import { type ReactNode } from "react";
-import { Link } from "react-router";
 
 import { Button, type ButtonProps } from "@/components/ui/button";
 import {
@@ -91,8 +90,8 @@ function InstallOptionsContent({ desktopHref = "/download" }) {
         </div>
       )}
 
-      <Link
-        to={desktopHref}
+      <a
+        href={appPath(desktopHref)}
         className="flex items-start gap-3 rounded-md border border-border p-3 text-start transition hover:bg-accent"
       >
         <DesktopIcon className="mt-0.5 h-4 w-4 shrink-0 text-primary" />
@@ -104,7 +103,7 @@ function InstallOptionsContent({ desktopHref = "/download" }) {
             {t("captureInstall.desktopDescription")}
           </span>
         </span>
-      </Link>
+      </a>
     </div>
   );
 }
@@ -120,7 +119,7 @@ export function CaptureInstallButton({
   if (!clipsChromeExtensionEnabled) {
     return (
       <Button asChild className={className} {...buttonProps}>
-        <Link to={desktopHref}>{children}</Link>
+        <a href={appPath(desktopHref)}>{children}</a>
       </Button>
     );
   }
@@ -149,9 +148,9 @@ export function CaptureInstallInlineLink({
 }: CaptureInstallInlineLinkProps) {
   if (!clipsChromeExtensionEnabled) {
     return (
-      <Link to={desktopHref} className={className}>
+      <a href={appPath(desktopHref)} className={className}>
         {children}
-      </Link>
+      </a>
     );
   }
 

package/corpus/templates/clips/app/components/recorder/recorder-engine.ts

@@ -194,7 +194,7 @@ const SCREEN_CAPTURE_MAX_HEIGHT = 1080;
 // client-side (ffmpeg.wasm re-encode is disabled — see COMPRESSION_ENABLED in
 // `@/lib/compress`) and the upload provider streams large files directly, so we
 // capture at a crisp 1080p bitrate instead of a tight budget. 1.2 Mbps left
-// dense UI (fine text, Figma, code) visibly fuzzy; 8 Mbps keeps it sharp.
+// dense UI (fine text and code) visibly fuzzy; 8 Mbps keeps it sharp.
 // Dial down here if file sizes become a concern for a deployment.
 const RECORDING_VIDEO_BITRATE_BPS = 8_000_000;
 const RECORDING_AUDIO_BITRATE_BPS = 128_000;

package/corpus/templates/content/AGENTS.md

@@ -87,50 +87,51 @@ cd templates/content && pnpm action <name> [args]
 
 ### Document Operations
 
-| Action                                      | Args                                                                                                                                     | Purpose                                                                                                                                 |
-| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| `list-documents`                            | `[--format json]`                                                                                                                        | List document metadata/tree; no full bodies                                                                                             |
-| `export-content-source`                     | `[--format json]`                                                                                                                        | Export editable docs as `content/*.mdx` source files                                                                                    |
-| `import-content-source`                     | `--files <json> [--dryRun true\|false]`                                                                                                  | Import `.md`/`.mdx` source files into editable docs                                                                                     |
-| `list-builder-docs`                         | `[--model docs-content\|blog-article] [--limit <n>]`                                                                                     | List Builder docs/blog entries available for `.builder.mdx` pull                                                                        |
-| `pull-builder-doc`                          | `--model <model> --entryId <builder-entry-id> [--dryRun true\|false]`                                                                    | Pull one Builder entry into Content and return `.builder.mdx` plus `content/builder/.raw` sidecar files                                 |
-| `check-builder-doc`                         | `--files <json> [--path <file.builder.mdx>]` or `--documentId <id>`                                                                      | Validate Builder MDX round-trip, sidecar hashes, and remote conflict status before push                                                 |
-| `push-builder-doc`                          | `--files <json> [--path <file.builder.mdx>] [--dryRun true\|false]`                                                                      | Guarded Builder autosave PATCH for the safe Builder test model; never publishes                                                         |
-| `navigate`                                  | `--path <path>` or `--documentId <id>` or `--databaseId <id>`                                                                            | Open a route, document page, or database page in the UI                                                                                 |
-| `search-documents`                          | `--query <text> [--format json]`                                                                                                         | Search by title/content and return snippets                                                                                             |
-| `get-document`                              | `--id <id> [--format json]`                                                                                                              | Get a single document with content                                                                                                      |
-| `pull-document`                             | `--id <id> [--format markdown\|text]`                                                                                                    | Collab-aware "ingest the final" read                                                                                                    |
-| `create-document`                           | `--title <text> [--content] [--parentId] [--icon]`                                                                                       | Create a new document                                                                                                                   |
-| `edit-document`                             | `--id <id> --find <text> --replace <text>`                                                                                               | Surgical text edit (preferred for modifications)                                                                                        |
-| `edit-document`                             | `--id <id> --edits <json>`                                                                                                               | Batch surgical text edits                                                                                                               |
-| `update-document`                           | `--id <id> [--title] [--content] [--icon]`                                                                                               | Full rewrite of document fields                                                                                                         |
-| `share-local-file-document`                 | `--id <local-file-document-id>`                                                                                                          | Create or refresh a DB-backed shareable copy of a local file document                                                                   |
-| `list-local-component-files`                |                                                                                                                                          | List registered local MDX component source files                                                                                        |
-| `write-local-component-file`                | `--workspaceId <id> --path <relative-component-path> --content <source>`                                                                 | Create or update a file in a registered local `components/` folder                                                                      |
-| `create-content-database`                   | `[--documentId <id>] [--parentId <id>] [--title <text>]`                                                                                 | Create a database page or convert an existing page into a database                                                                      |
-| `get-content-database`                      | `--databaseId <id>` or `--documentId <id>`                                                                                               | Get a database table with property schema and item pages                                                                                |
-| `get-content-database-source`               | `--databaseId <id>` or `--documentId <id>`                                                                                               | Inspect local/no-source or source-backed status, mappings, row identity, freshness, and change sets                                     |
-| `attach-content-database-source`            | `--databaseId <id>` or `--documentId <id> [--sourceType mock\|builder-cms] [--sourceName] [--sourceTable]`                               | Attach a source binding; Builder CMS live writes are disabled by default                                                                |
-| `refresh-content-database-source`           | `--databaseId <id>` or `--documentId <id>`                                                                                               | Refresh the read-only source status envelope; Builder CMS reads live entries only when configured                                       |
-| `set-content-database-source-write-mode`    | `--databaseId <id>` or `--documentId <id> --liveWritesEnabled true\|false [--allowedWriteModes <json>]`                                  | Enable/disable per-source Builder live writes; enabling is allowed only for `agent-native-blog-article-test` with explicit modes        |
-| `stage-builder-revision`                    | `--databaseId <id>` or `--documentId <id>`                                                                                               | Stage pending local Builder CMS changes as a local-only save-revision record; never calls Builder                                       |
-| `review-content-database-source-change-set` | `--databaseId <id>` or `--documentId <id> --changeSetId <id> --decision approve\|reject [--note]`                                        | Approve or reject a local source change-set review record without provider writes                                                       |
-| `prepare-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--pushModeConfirmation autosave\|draft\|publish]`                          | Prepare a dry-run Builder execution gate with request semantics/idempotency key; never calls Builder                                    |
-| `validate-builder-source-execution`         | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>]`                                                   | Validate/replay a prepared Builder execution gate locally as a dry run; never calls Builder                                             |
-| `execute-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>] [--pushModeConfirmation autosave\|draft\|publish]` | Execute a guarded live Builder write only when approved, validated, enabled, idempotent, and targeting `agent-native-blog-article-test` |
-| `add-database-item`                         | `--databaseId <id> [--title <text>] [--propertyValues <json>]`                                                                           | Add a page row to a database, optionally seeding property values                                                                        |
-| `duplicate-database-item`                   | `--itemId <id>` or `--documentId <id> [--title <text>]`                                                                                  | Duplicate a database row page and its stored property values                                                                            |
-| `move-database-item`                        | `--itemId <id>` or `--documentId <id> --position <number>`                                                                               | Move a database row page to a new zero-based table position                                                                             |
-| `update-content-database-view`              | `--databaseId <id> --viewConfig <json>`                                                                                                  | Persist database views, sorts, filters, hidden properties, and view settings                                                            |
-| `list-document-properties`                  | `--documentId <id> [--format json]`                                                                                                      | List Notion-style property definitions and values for a document                                                                        |
-| `configure-document-property`               | `--documentId <id> [--id <propertyId>] --name <name> --type <type> [--visibility always_show\|hide_when_empty\|always_hide]`             | Create or update a property definition                                                                                                  |
-| `duplicate-document-property`               | `--documentId <id> --propertyId <propertyId>`                                                                                            | Duplicate a property definition and its stored values                                                                                   |
-| `delete-document-property`                  | `--documentId <id> --propertyId <propertyId>`                                                                                            | Delete a property definition and its stored values                                                                                      |
-| `set-document-property`                     | `--documentId <id> --propertyId <propertyId> --value <json>`                                                                             | Set a document property value (for a `blocks` field, the value is its markdown content)                                                 |
-| `reorder-document-property`                 | `--documentId <id> --propertyId <propertyId> --targetPropertyId <id> [--position before\|after]`                                         | Reorder a property definition within its database (used to reorder Blocks fields on the page)                                           |
-| `set-document-discoverability`              | `--id <id> --hideFromSearch true\|false [--includeChildren true\|false]`                                                                 | Hide/show an org-accessible document in Organization/search while keeping link access                                                   |
-| `move-document`                             | `--id <id> [--parentId] [--position]`                                                                                                    | Move or reorder a document in the page tree                                                                                             |
-| `delete-document`                           | `--id <id>`                                                                                                                              | Delete with recursive children                                                                                                          |
+| Action                                      | Args                                                                                                                                                           | Purpose                                                                                                                                 |
+| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `list-documents`                            | `[--format json]`                                                                                                                                              | List document metadata/tree; no full bodies                                                                                             |
+| `export-content-source`                     | `[--format json]`                                                                                                                                              | Export editable docs as `content/*.mdx` source files                                                                                    |
+| `import-content-source`                     | `--files <json> [--dryRun true\|false]`                                                                                                                        | Import `.md`/`.mdx` source files into editable docs                                                                                     |
+| `list-builder-docs`                         | `[--model docs-content\|blog-article] [--limit <n>]`                                                                                                           | List Builder docs/blog entries available for `.builder.mdx` pull                                                                        |
+| `pull-builder-doc`                          | `--model <model> --entryId <builder-entry-id> [--dryRun true\|false]`                                                                                          | Pull one Builder entry into Content and return `.builder.mdx` plus `content/builder/.raw` sidecar files                                 |
+| `check-builder-doc`                         | `--files <json> [--path <file.builder.mdx>]` or `--documentId <id>`                                                                                            | Validate Builder MDX round-trip, sidecar hashes, and remote conflict status before push                                                 |
+| `push-builder-doc`                          | `--files <json> [--path <file.builder.mdx>] [--dryRun true\|false]`                                                                                            | Guarded Builder autosave PATCH for the safe Builder test model; never publishes                                                         |
+| `navigate`                                  | `--path <path>` or `--documentId <id>` or `--databaseId <id>`                                                                                                  | Open a route, document page, or database page in the UI                                                                                 |
+| `search-documents`                          | `--query <text> [--format json]`                                                                                                                               | Search by title/content and return snippets                                                                                             |
+| `get-document`                              | `--id <id> [--format json]`                                                                                                                                    | Get a single document with content                                                                                                      |
+| `pull-document`                             | `--id <id> [--format markdown\|text]`                                                                                                                          | Collab-aware "ingest the final" read                                                                                                    |
+| `create-document`                           | `--title <text> [--content] [--parentId] [--icon]`                                                                                                             | Create a new document                                                                                                                   |
+| `edit-document`                             | `--id <id> --find <text> --replace <text>`                                                                                                                     | Surgical text edit (preferred for modifications)                                                                                        |
+| `edit-document`                             | `--id <id> --edits <json>`                                                                                                                                     | Batch surgical text edits                                                                                                               |
+| `update-document`                           | `--id <id> [--title] [--content] [--icon]`                                                                                                                     | Full rewrite of document fields                                                                                                         |
+| `share-local-file-document`                 | `--id <local-file-document-id>`                                                                                                                                | Create or refresh a DB-backed shareable copy of a local file document                                                                   |
+| `list-local-component-files`                |                                                                                                                                                                | List registered local MDX component source files                                                                                        |
+| `write-local-component-file`                | `--workspaceId <id> --path <relative-component-path> --content <source>`                                                                                       | Create or update a file in a registered local `components/` folder                                                                      |
+| `create-content-database`                   | `[--documentId <id>] [--parentId <id>] [--title <text>]`                                                                                                       | Create a database page or convert an existing page into a database                                                                      |
+| `get-content-database`                      | `--databaseId <id>` or `--documentId <id>`                                                                                                                     | Get a database table with property schema and item pages                                                                                |
+| `get-content-database-source`               | `--databaseId <id>` or `--documentId <id>`                                                                                                                     | Inspect local/no-source or source-backed status, mappings, row identity, freshness, and change sets                                     |
+| `attach-content-database-source`            | `--databaseId <id>` or `--documentId <id> [--sourceType mock\|builder-cms] [--sourceName] [--sourceTable] [--relationshipMode items\|details] [--join <json>]` | Attach a source binding; use `items` to add more rows and `details` to match a source onto existing rows                                |
+| `change-content-database-source-role`       | `--databaseId <id>` or `--documentId <id> --sourceId <id> --relationshipMode items\|details [--join <json>]`                                                   | Change an attached source between adding rows and adding matched detail columns without removing the source                             |
+| `refresh-content-database-source`           | `--databaseId <id>` or `--documentId <id>`                                                                                                                     | Refresh the read-only source status envelope; Builder CMS reads live entries only when configured                                       |
+| `set-content-database-source-write-mode`    | `--databaseId <id>` or `--documentId <id> --liveWritesEnabled true\|false [--allowedWriteModes <json>]`                                                        | Enable/disable per-source Builder live writes; enabling is allowed only for `agent-native-blog-article-test` with explicit modes        |
+| `stage-builder-revision`                    | `--databaseId <id>` or `--documentId <id>`                                                                                                                     | Stage pending local Builder CMS changes as a local-only save-revision record; never calls Builder                                       |
+| `review-content-database-source-change-set` | `--databaseId <id>` or `--documentId <id> --changeSetId <id> --decision approve\|reject [--note]`                                                              | Approve or reject a local source change-set review record without provider writes                                                       |
+| `prepare-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--pushModeConfirmation autosave\|draft\|publish]`                                                | Prepare a dry-run Builder execution gate with request semantics/idempotency key; never calls Builder                                    |
+| `validate-builder-source-execution`         | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>]`                                                                         | Validate/replay a prepared Builder execution gate locally as a dry run; never calls Builder                                             |
+| `execute-builder-source-execution`          | `--databaseId <id>` or `--documentId <id> --changeSetId <id> [--idempotencyKey <key>] [--pushModeConfirmation autosave\|draft\|publish]`                       | Execute a guarded live Builder write only when approved, validated, enabled, idempotent, and targeting `agent-native-blog-article-test` |
+| `add-database-item`                         | `--databaseId <id> [--title <text>] [--propertyValues <json>]`                                                                                                 | Add a page row to a database, optionally seeding property values                                                                        |
+| `duplicate-database-item`                   | `--itemId <id>` or `--documentId <id> [--title <text>]`                                                                                                        | Duplicate a database row page and its stored property values                                                                            |
+| `move-database-item`                        | `--itemId <id>` or `--documentId <id> --position <number>`                                                                                                     | Move a database row page to a new zero-based table position                                                                             |
+| `update-content-database-view`              | `--databaseId <id> --viewConfig <json>`                                                                                                                        | Persist database views, sorts, filters, hidden properties, and view settings                                                            |
+| `list-document-properties`                  | `--documentId <id> [--format json]`                                                                                                                            | List Notion-style property definitions and values for a document                                                                        |
+| `configure-document-property`               | `--documentId <id> [--id <propertyId>] --name <name> --type <type> [--visibility always_show\|hide_when_empty\|always_hide]`                                   | Create or update a property definition                                                                                                  |
+| `duplicate-document-property`               | `--documentId <id> --propertyId <propertyId>`                                                                                                                  | Duplicate a property definition and its stored values                                                                                   |
+| `delete-document-property`                  | `--documentId <id> --propertyId <propertyId>`                                                                                                                  | Delete a property definition and its stored values                                                                                      |
+| `set-document-property`                     | `--documentId <id> --propertyId <propertyId> --value <json>`                                                                                                   | Set a document property value (for a `blocks` field, the value is its markdown content)                                                 |
+| `reorder-document-property`                 | `--documentId <id> --propertyId <propertyId> --targetPropertyId <id> [--position before\|after]`                                                               | Reorder a property definition within its database (used to reorder Blocks fields on the page)                                           |
+| `set-document-discoverability`              | `--id <id> --hideFromSearch true\|false [--includeChildren true\|false]`                                                                                       | Hide/show an org-accessible document in Organization/search while keeping link access                                                   |
+| `move-document`                             | `--id <id> [--parentId] [--position]`                                                                                                                          | Move or reorder a document in the page tree                                                                                             |
+| `delete-document`                           | `--id <id>`                                                                                                                                                    | Delete with recursive children                                                                                                          |
 
 Database views follow Notion-style tab labels. When creating or duplicating
 views in `viewConfig`, use unique default names (`Table 2`, `SEO copy 2`, etc.)
@@ -195,6 +196,18 @@ Content has two file workflows:
   `select` fields; selecting the component in the editor shows a corner edit
   button that rewrites the MDX props. JSX expression props are preserved in
   source but shown as an unsupported preview.
+- **Reusable MDX references:** local-file MDX can embed another local document
+  with `<ContentReference sourcePath="./shared/example.mdx" />`. The editor
+  resolves `sourcePath` relative to the current file, previews the referenced
+  MDX read-only in place, and preserves the original tag in source. Use this for
+  reusable docs fragments instead of copy/pasting shared content.
+- **Builder Symbols:** Builder MDX pulls preserve Symbol blocks as
+  `<BuilderSymbol ... />`. When Builder returns enriched symbol content, the
+  pull also writes a referenced `.builder.mdx` file under
+  `content/builder/symbols/` and sets the Symbol block's `source` attribute.
+  Edit reusable symbol content in that emitted source file; do not retarget
+  `entry`, `model`, or `source` in the parent MDX unless a dedicated Builder
+  retargeting workflow is added.
 - **Picked folders and components:** browser-picked folders can be the
   source of truth for `.md`/`.mdx` files, but the browser does not expose an
   absolute path that Vite can compile. Component previews from a picked

package/corpus/templates/content/README.md

@@ -28,3 +28,19 @@ Open http://localhost:8080 and create your first page.
 ## Data
 
 Documents are stored in the app's SQL database. Local development defaults to SQLite at `data/app.db`; deployed apps should set `DATABASE_URL` to a persistent SQL database. The agent should use content actions for normal document operations and reserve `db-query` / `db-exec` for inspection or maintenance.
+
+## Enable Builder live writes
+
+Connect Builder through the existing Builder Connect flow, the same connection used by the AI assistant. Once connected, Content resolves the key automatically for the user, or for org owners/admins through the org connection. There is no separate key entry. In local development, `BUILDER_PRIVATE_KEY` and `BUILDER_PUBLIC_KEY` in `.env.local` also work; see `DEVELOPING.md` for local env opt-in details.
+
+Live writes are only allowed for the safe write model `agent-native-blog-article-test` (`BUILDER_CMS_SAFE_WRITE_MODEL`). Other Builder models stay read-only by design.
+
+Write access is an intentional per-source choice from the source panel selector. Sources start at `read_only`, can move to `stage_only` to push approved changes as Builder autosave revisions, and can move to `publish_updates` for state-preserving live writes. Autosave staging stays quiet; update-in-place and publish writes trigger Builder webhooks so downstream rebuilds can run.
+
+In `publish_updates`, Content PATCHes the Builder entry in place and preserves its current publication state: published entries stay published and drafts stay draft. Content never sends a `published` field, so a normal content push cannot publish or unpublish. Builder merges the field changes and preserves the entry envelope, including scheduling and targeting.
+
+Publication transitions are explicit per-row choices in the review/diff, only when the source enables **Allow publish/unpublish per item**. Publishing a draft or unpublishing a published entry is never a bulk default, and unpublish requires confirmation because it takes live content down. New Builder entries are created as drafts.
+
+**Push all approved (N)** runs approved rows in a concurrency-capped batch. It continues after individual errors, reports per-item `succeeded`, `blocked`, or `failed` status, and can be resumed because already-succeeded items are skipped.
+
+Before each write, Content reads the target's current state from Builder. A write blocks if the entry changed or was deleted since the diff, or if a requested publish/unpublish transition no longer matches the real Builder state. Body diffs remain non-executable for now; they are planned for a later slice.

package/corpus/templates/content/actions/_builder-cms-read-client.ts

@@ -19,6 +19,13 @@ export interface BuilderCmsReadResult {
   message: string | null;
 }
 
+export interface BuilderCmsEntryLiveState {
+  exists: boolean;
+  published: "published" | "draft" | string | null;
+  lastUpdated: number | string | null;
+  id: string | null;
+}
+
 type FetchLike = typeof fetch;
 
 type BuilderMcpContentPart = {
@@ -52,6 +59,80 @@ function entryArrayFromResponse(value: unknown) {
   return Array.isArray(record.results) ? record.results : [];
 }
 
+function stringFromUnknown(value: unknown) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+
+function stringOrNumberFromUnknown(value: unknown) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  return stringFromUnknown(value);
+}
+
+function liveStateFromBuilderEntry(value: unknown): BuilderCmsEntryLiveState {
+  if (Array.isArray(value)) {
+    return value.length > 0
+      ? liveStateFromBuilderEntry(value[0])
+      : {
+          exists: false,
+          published: null,
+          lastUpdated: null,
+          id: null,
+        };
+  }
+  if (!value || typeof value !== "object") {
+    return {
+      exists: false,
+      published: null,
+      lastUpdated: null,
+      id: null,
+    };
+  }
+
+  const record = value as Record<string, unknown>;
+  if (Array.isArray(record.results)) {
+    return liveStateFromBuilderEntry(record.results);
+  }
+  if (Object.keys(record).length === 0) {
+    return {
+      exists: false,
+      published: null,
+      lastUpdated: null,
+      id: null,
+    };
+  }
+
+  const data =
+    record.data &&
+    typeof record.data === "object" &&
+    !Array.isArray(record.data)
+      ? (record.data as Record<string, unknown>)
+      : {};
+  const id =
+    stringFromUnknown(record.id) ??
+    stringFromUnknown(record["@id"]) ??
+    stringFromUnknown(record.uuid);
+  if (!id) {
+    return {
+      exists: false,
+      published: null,
+      lastUpdated: null,
+      id: null,
+    };
+  }
+
+  return {
+    exists: true,
+    published:
+      stringFromUnknown(record.published) ?? stringFromUnknown(data.published),
+    lastUpdated:
+      stringOrNumberFromUnknown(record.lastUpdated) ??
+      stringOrNumberFromUnknown(record.updatedDate) ??
+      stringOrNumberFromUnknown(record.updatedAt) ??
+      stringOrNumberFromUnknown(data.updatedAt),
+    id,
+  };
+}
+
 function readLimit(limit: number | undefined) {
   if (typeof limit === "number" && Number.isFinite(limit) && limit > 0) {
     return Math.min(Math.floor(limit), BUILDER_CMS_MAX_READ_LIMIT);
@@ -506,6 +587,50 @@ async function readBuilderCmsContentEntriesViaContentApi(args: {
   };
 }
 
+export async function readBuilderCmsEntryLiveState(args: {
+  model: string;
+  entryId: string;
+  fetchImpl?: FetchLike;
+}): Promise<BuilderCmsEntryLiveState> {
+  const publicKey = await resolveBuilderCredential("BUILDER_PUBLIC_KEY");
+  if (!publicKey) {
+    throw new Error(
+      "Builder CMS live entry read skipped because BUILDER_PUBLIC_KEY is not configured.",
+    );
+  }
+
+  const url = new URL(
+    `/api/v3/content/${encodeURIComponent(args.model)}/${encodeURIComponent(
+      args.entryId,
+    )}`,
+    builderContentApiHost(),
+  );
+  url.searchParams.set("apiKey", publicKey);
+  url.searchParams.set("includeUnpublished", "true");
+  url.searchParams.set("cachebust", String(Date.now()));
+
+  const response = await fetchBuilderContentPage({
+    fetchImpl: args.fetchImpl ?? fetch,
+    url,
+  });
+  if (response.status === 404) {
+    return {
+      exists: false,
+      published: null,
+      lastUpdated: null,
+      id: null,
+    };
+  }
+  if (!response.ok) {
+    throw new Error(
+      `Builder CMS live entry read failed with HTTP ${response.status}.`,
+    );
+  }
+
+  const json = (await response.json()) as unknown;
+  return liveStateFromBuilderEntry(json);
+}
+
 export async function listBuilderCmsModels(
   args: {
     fetchImpl?: FetchLike;

package/corpus/templates/content/actions/_builder-cms-source-adapter.ts

@@ -164,11 +164,13 @@ export function builderCmsSourceMetadata(sourceTable: string) {
     primaryKey: "id",
     titleField: "data.title",
     naturalKeyField: "/blog/[slug]",
-    pushMode: "autosave" as const,
-    pushModeLabel: "Save revision / autosave",
+    pushMode: "none" as const,
+    pushModeLabel: "No writes",
     pushModeDescription:
-      "Local-only Builder revision staging. No Builder API write runs in this slice.",
-    allowedWriteModes: ["autosave"],
+      "Read-only Builder source. Choose a write tier before any Builder API write can run.",
+    writeMode: "read_only" as const,
+    allowPublicationTransitions: false,
+    allowedWriteModes: [],
     allowDraftWrites: false,
     allowPublishWrites: false,
     notes:
@@ -196,6 +198,22 @@ function stringFromRecord(
   return null;
 }
 
+function timestampStringFromRecord(
+  value: Record<string, unknown>,
+  keys: string[],
+): string | null {
+  for (const key of keys) {
+    const candidate = value[key];
+    if (typeof candidate === "number" && Number.isFinite(candidate)) {
+      return String(candidate);
+    }
+    if (typeof candidate === "string" && candidate.trim()) {
+      return candidate.trim();
+    }
+  }
+  return null;
+}
+
 function pickStringField(
   obj: Record<string, unknown>,
   keys: string[],
@@ -317,8 +335,12 @@ export function normalizeBuilderCmsApiEntry(
     stringFromRecord(data, ["url", "urlPath", "path"]) ??
     (slug ? `/blog/${slug.replace(/^\/+/, "")}` : `/blog/${id}`);
   const updatedAt =
-    stringFromRecord(record, ["lastUpdated", "updatedDate", "updatedAt"]) ??
-    stringFromRecord(data, ["updatedAt"]) ??
+    timestampStringFromRecord(record, [
+      "lastUpdated",
+      "updatedDate",
+      "updatedAt",
+    ]) ??
+    timestampStringFromRecord(data, ["updatedAt"]) ??
     new Date().toISOString();
 
   return {