@typeroll/mcp-server 0.45.42 → 0.45.44

package/AGENTS.md

@@ -247,11 +247,15 @@ maps to one HTTP endpoint; the actual logic runs in the customer's portal
       API key may write are excluded by default: a gap you can't close is
       noise.
     - **Per-field write authority.** A content type field can declare
-      `writable_by` (`portal | owner | agent | app | import`). A write you're
-      not permitted, or one that would overwrite a higher-precedence writer
-      (a human correction, the listed business's own edit), comes back as
-      **409 with the losing field names** — never a silent no-op. Treat that
-      as "already handled" and record it; retrying will lose again.
+      `writable_by` (`portal | owner | agent | app | import`); your API key may
+      write every field open to `portal` or `agent`. A write you're not
+      permitted, or one that would replace the listed business's own edit
+      without a reason, comes back as
+      **409 with the losing field names** — never a silent no-op. Your writes
+      carry the same authority as an editor in the portal: you may replace a
+      value someone set in the portal, as they may replace yours. Only a value
+      the listed business set itself needs `override_reason`; send one only
+      when the user asked for the change.
     - **Item references.** `page_ref` / `page_ref_list` fields point at items
       in another content type (`ref_content_type`). The reverse direction is
       computed at render time — don't try to maintain backlinks yourself.
@@ -599,14 +603,9 @@ set_page_mode page_id=about to=blocks
 set_page_mode page_id=about to=html
 ```
 
-`convert_page_to_blocks` previews a heuristic conversion and lists
-`unconverted` text, classes, and markup. It does not write, and
-`set_page_mode` does not apply that preview. A person accepts the
-preview in the page editor. The heuristic recognises `<h1-4>` →
-heading, `<img>` → image, `<a.btn>` → button, `grid-cols-2` →
-two-column, `<section>` / hero divs → section. Link-wrapped card text
-and author classes are reported as unconverted rather than discarded
-silently.
+Typeroll does not convert HTML into blocks. `set_page_mode to=blocks`
+keeps the HTML as a revision and starts an empty block tree; build the
+content with blocks.
 
 ### "Build a directory or migrate a content family"
 
@@ -1031,16 +1030,18 @@ preview.
 | **Insights** | `get_site_insights` — traffic, AI-assistant referrals, and first-party conversion events over 7/30/90 days. Read-only. Traffic is powered by Cloudflare Web Analytics; conversion rows come from validated Analytics attribution `click_event` targets and can be present even when the traffic provider is unavailable. |
 | **Pages — reads** | `list_pages`, `read_page`, `batch_read_pages` |
 | **Pages — writes** | `create_page`, `update_page`, `replace_page`, `batch_update_pages`, `delete_page`, `clone_page` |
-| **Pages — blocks** | `get_page_blocks`, `add_block`, `update_block`, `move_block`, `remove_block`, `set_page_mode`, `convert_page_to_blocks` |
+| **Pages — blocks** | `get_page_blocks`, `add_block`, `update_block`, `move_block`, `remove_block`, `duplicate_block`, `set_block_responsive`, `set_page_mode` (never converts HTML into blocks) |
 | **Pages — meta** | `get_page_preview` |
-| **Global blocks (partials)** | `list_partials` (summary by default), `read_partial`, `create_free_block`, `update_partial`, `replace_partial`, `set_partial_mode`, `delete_partial`, `find_pages_using_block`, `list_blocks_with_usage` |
+| **Global blocks (partials)** | `list_partials` (summary by default), `read_partial`, `create_free_block` (`blocks` or `html_content`), `update_partial`, `replace_partial`, `set_partial_mode`, `delete_partial`, `find_pages_using_block`, `make_block_global`, `detach_global_block`. Block pages reference a global block with `core/global_block` (`global_block_id`); HTML pages use `<x-include>`. |
+| **Block templates** | `list_block_templates`, `read_block_template`, `save_block_template` (from `blocks` or `from: { page_id, block_id }`), `update_block_template`, `delete_block_template`, `insert_block_template` (copies with new ids). Per site, not per branch. |
+| **Styles** | `list_styles`, `create_style`, `update_style`, `delete_style`, `apply_standard_styles`. Blocks pick a style with `style_id` (heading parts: `eyebrow_style_id`, `subtitle_style_id`). Contrast below WCAG AA is refused. |
 | **Block types** | `list_block_types`, `read_block_type`, `find_pages_using_block_type`, `export_block_types`, `import_block_types` |
 | **Content types** | `list_content_types`, `read_content_type`, `create_content_type`, `update_content_type`, `delete_content_type`, `change_page_content_type`, `page_completeness` |
 | **Page templates** | `list_page_templates`, `read_page_template`, `create_page_template`, `update_page_template`, `delete_page_template` |
 | **Media** | `list_media`, `read_media`, `create_upload_url`, `upload_media_from_url`, `upload_media_inline`, `update_media`, `delete_media`, `finalize_media`, `finalize_all_media`, `generate_image_variants`, `suggest_alt_text_context` |
 | **Redirects** | `list_redirects`, `create_redirect`, `delete_redirect`. `from_path` may be a PATTERN: a trailing `*` (with `:splat` in the target) or `:name` for one segment — one rule retires a whole family of dead URLs (`/category/*` → `/blogg/:splat`). Mid-path splats and query strings are refused, as is any rule that would hide a live page. |
 | **Migration inventory + launch gate** | `get_migration_readiness` (preflight — CALL FIRST), `list_migration_urls`, `add_migration_urls`, `update_migration_url`, `update_migration_urls`, `delete_migration_url`, `import_sitemap`, `import_gsc_performance`, `repair_migration_plain_text`, `verify_migration_urls`, `record_migration_seo_acceptance`, `get_migration_launch_report`. Sitemap indexes are recursive. GSC supports direct Search Console access or CSV and aggregates fragment variants. Plain-text repair is allowlisted and dry-run-first. A complete unfiltered URL check and reviewed SEO evidence are bound to the latest hosted deploy; the launch report fails closed when either is stale or incomplete. |
-| **Forms** | `list_forms`, `read_form`, `create_form`, `update_form`, `delete_form`, `list_form_submissions`, `delete_form_submission` (removes one submission — e.g. cleaning up a test entry; `delete_form` with `delete_submissions` is the bulk path). **Steps (form/* block trees) are the ONLY stored model**: pass `steps` for funnels, or `fields` for simple forms — the server converts a flat field list to a single static step. Place with a `core/form` block on block-mode pages or `<x-form id="…" />` in HTML mode. Both expand server-side to the same complete signed shell and initial state. Email/webhook actions are admin-only in the portal and excluded from agent reads/writes. |
+| **Forms** | `list_forms`, `read_form`, `create_form`, `update_form`, `delete_form`, `list_form_submissions`, `delete_form_submission` (removes one submission — e.g. cleaning up a test entry; `delete_form` with `delete_submissions` is the bulk path). **Steps (form/* block trees) are the ONLY stored model**: pass `steps` for funnels, or `fields` for simple forms — the server converts a flat field list to a single static step. Place with a `core/form` block on block-mode pages or `<x-form id="…" />` in HTML mode. Both expand server-side to the same complete signed shell and initial state. `read_form` shows the form's actions (email notifications, webhooks; secrets masked) and `create_form`/`update_form` set them with `actions`, with admin permission as in the portal. |
 | **Settings** | `update_site_settings` (whitelist, including `sitewide_noindex` and shallow-merged native `cookie_consent`), `check_site_indexing` (live fallback/production headers, meta robots, and robots.txt diagnostics) |
 | **Core modules** | `list_apps`, `read_app`, `update_app` (legacy API name; admin; schema-driven config, masked secrets, redeploy when `affects_build` is true) |
 | **Extension installations** | `list_extension_installations`, `read_extension_installation`, `update_extension_installation_config` (admin; schema-driven config, masked secrets preserved, production deploy queued by default) |

package/README.md

@@ -154,15 +154,21 @@ the full reference + concrete operation recipes.
   `read_site_settings`, `update_site_settings`.
 - **Pages** — list, read, batch-read, create, update (PATCH), replace
   (PUT), batch-update, delete, clone, get-preview, `set_page_mode`
-  (flip between blocks/html), `convert_page_to_blocks`.
+  (flip between blocks/html; HTML is never converted into blocks).
 - **Blocks (instances)** — `get_page_blocks`, `add_block`,
   `update_block`, `move_block`, `remove_block`, `duplicate_block`,
   `set_block_responsive`. All take a `target` (page, partial, page
   template), so one tool family edits
   every block container.
 - **Global blocks (partials)** — list (summary mode by default), read,
-  create free block, update, replace, delete, `set_partial_mode`,
-  find-pages-using-block. New header/footer work should use the native
+  create free block (blocks or HTML), update, replace, delete,
+  `set_partial_mode`, find-pages-using-block, `make_block_global`,
+  `detach_global_block`. Block pages reference one with `core/global_block`.
+- **Block templates** — `list_block_templates`, `read_block_template`,
+  `save_block_template`, `update_block_template`, `delete_block_template`,
+  `insert_block_template` (inserts an independent copy).
+- **Styles** — `list_styles`, `create_style`, `update_style`,
+  `delete_style`, `apply_standard_styles`. New header/footer work should use the native
   `template/site_logo` + `core/navigation` recipe in `tr-header-footer`.
 - **Block types** — list, read, create, update, delete,
   find-pages-using-block-type, plus `.tcblocks` export/import. Custom
@@ -200,8 +206,9 @@ the full reference + concrete operation recipes.
 - **Forms** — list, read, create, update, delete, list submissions.
   Place forms with `core/form` blocks or an HTML-mode `<x-form id="…" />`
   reference; preview/build expands both server-side to the same complete,
-  signed form shell. Admins configure email and allowlisted, signed webhooks
-  in the portal; action configuration stays off agent surfaces.
+  signed form shell. With an admin key, `read_form` returns the form's email
+  notifications and allowlisted, signed webhooks (`actions`, secrets masked)
+  and `create_form`/`update_form` set them, as the portal's Forms editor does.
 - **Extension installations** — list/read installed Extensions and update
   manifest-defined installation config through the API key with
   `update_extension_installation_config`; omitted and masked secrets are