@typeroll/mcp-server 0.45.41 → 0.45.43

package/AGENTS.md

@@ -315,7 +315,7 @@ maps to one HTTP endpoint; the actual logic runs in the customer's portal
   everything you write through `?version=<branch-id>` lives on the
   branch until you `merge_branch` it back to main. Branches default
   `robots_blocked: true` so a half-finished redesign can't be indexed,
-  and deploys land at a stable `{branch}.{project}.pages.dev` URL. That
+  and deploys land at a stable address (`deploy_url` on the version). That
   branch deploy renders the site's full inherited brand (settings, fonts,
   favicon, header/footer — everything not overridden on the branch), so
   it's a faithful preview of what merging to main will look like, not just
@@ -404,7 +404,7 @@ maps to one HTTP endpoint; the actual logic runs in the customer's portal
   direct PATCH attempts and points at the mode endpoint.
   **Before `trigger_deploy`: commit.** Deploys build saved content only —
   an uncommitted draft silently stays behind.
-- **Deploys / `{branch}.{project}.pages.dev` are the STATIC BUILD**, refreshed
+- **Deploys / the branch `deploy_url` are the STATIC BUILD**, refreshed
   only by `trigger_deploy`. Reach for them when you want the real compiled
   output: publishing, a stakeholder link to the built site, or a faithful
   pre-merge check. The branch alias is permanent across re-deploys; the
@@ -984,7 +984,9 @@ design as perfect/approved off a glance or a partial pass.
 
 Preview shows DB state (drafts included). Live (`get_site → urls.production`)
 shows the most recent deploy. Branch deploys live at
-`get_version → deploy_url` (`{branch}.{project}.pages.dev`).
+`read_version → deploy_url`. The publishing setup decides that host (under a
+Hosting Group, a `v-…` host under the group's site address base); never
+construct it or guess a `pages.dev` alias.
 
 ## Branches
 
@@ -1000,7 +1002,7 @@ the live site until you `merge_branch`.
 
 Branches default `robots_blocked: true`. While iterating, preview the branch
 with a reused `get_preview_link` (DB-live, no build). Deploys to a branch land
-at a stable URL (`{branch}.{project}.pages.dev`) — that's the compiled static
+at a stable URL (`deploy_url` on the version) — that's the compiled static
 build, for sharing the finished result / stakeholder review, not per-edit
 preview.
 
@@ -1029,9 +1031,11 @@ 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`, `convert_page_to_blocks` (preview only), `convert_prose_block` (preview, then `accept`) |
 | **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` |

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), `convert_page_to_blocks`, `convert_prose_block`.
 - **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
@@ -226,8 +232,8 @@ the full reference + concrete operation recipes.
   `verify_migration_urls` (successful rows omitted unless requested), plus
   `repair_migration_plain_text` for dry-run-first cleanup of legacy WordPress
   entities and markup in allowlisted plain-text fields.
-- **Branches** — create, read, delete, merge. Branch deploys get their
-  own URL at `{branch}.{project}.pages.dev`.
+- **Branches** — create, read, delete, merge. A deployed branch gets its own
+  stable address, reported as `deploy_url` by `list_versions` / `read_version`.
 - **Deploy** — trigger (with `dry_run` to build without publishing), list, get
   status. A finished job reports `cost`: what the build consumed in server
   time, broken down per phase. Estimates from a rate card, not billing records.
@@ -240,6 +246,9 @@ the full reference + concrete operation recipes.
   on the write call; inspect/discard with `read_working_copy` /
   `discard_working_copy`. Status changes and structural operations apply
   immediately.
+- **History** — `list_page_revisions`, `read_page_revision` and
+  `restore_page_revision` (to a draft, or saved with `save: true`) undo page
+  changes from earlier saves.
 
 ## Direct REST API access