@phenomenalorg/mcp 0.5.2 → 0.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "type": "module",
   "description": "Phenomenal MCP bridge — connects a stdio-only MCP client to the Phenomenal MCP server over Streamable HTTP, with browser sign-in.",
   "license": "MIT",

package/skill/SKILL.md

@@ -8,7 +8,7 @@ description: Use when the user wants to manage a PTO, school or club in Phenomen
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 42 tools · 170 actions · 5 prompts · fingerprint `bb52a9d1`._
+_Tool surface: 47 tools · 170 actions · 5 prompts · fingerprint `c6ca31f7`._
 
 You are connected to Phenomenal, the platform for this PTO's site, members, events, tickets, email, forms, store and money.
 

package/skill/references/mutations.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 42 tools · 170 actions · 5 prompts · fingerprint `bb52a9d1`._
+_Tool surface: 47 tools · 170 actions · 5 prompts · fingerprint `c6ca31f7`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 

package/skill/references/schema.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 42 tools · 170 actions · 5 prompts · fingerprint `bb52a9d1`._
+_Tool surface: 47 tools · 170 actions · 5 prompts · fingerprint `c6ca31f7`._
 
 Two tools answer questions no curated tool anticipated.
 

package/skill/references/starting-doc.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 42 tools · 170 actions · 5 prompts · fingerprint `bb52a9d1`._
+_Tool surface: 47 tools · 170 actions · 5 prompts · fingerprint `c6ca31f7`._
 
 Phenomenal runs a school's PTO: its public website, its member roster, its events and tickets, its email to families, its forms, its store and its money. It exposes all of that over the Model Context Protocol, so an assistant an officer already uses can do the work with them.
 
@@ -97,13 +97,19 @@ Custom HTML supports local <style> blocks in a leaf {id,type:"html",props:{html:
 
 CSS v1: element/class/ID compounds and comma lists; descendant and child (>) combinators; :hover, :focus, :focus-visible. No global/universal/attribute/sibling selectors, functional pseudos or pseudo-elements. Media queries are a single (min-width:Npx)/(max-width:Npx), N=240–2560, or (prefers-reduced-motion:reduce/no-preference). Existing approved inline typography, spacing, color, borders, table and flex/grid display rules also work in sheets. Linear gradients accept an optional -360–360deg angle; radial gradients an optional circle/ellipse. Both need 2–8 approved opaque named or 3/6-digit hex colors with optional ordered 0–100% stops. Background-position uses two 0–100% values; background-size uses two 100–400% values.
 
-Named local @keyframes animate transform/background-position only. Transform supports up to three distinct single-argument functions: translateX/Y ±16px, rotate ±5deg, scale 0.95–1.05. One animation per rule: shorthand or name/duration/delay/timing-function/iteration-count/direction/fill-mode longhands. Duration 0.2–30s, delay 0–5s, iterations 1–10 or infinite (at least 2s per cycle), linear/ease/ease-in/ease-out/ease-in-out, normal/reverse/alternate/alternate-reverse, none/forwards/backwards/both. Animation names are case-sensitive and must be defined in the same sheet. Transition shorthand supports transform or background-position, 0.1–2s and one of those easings. The site provides Pause/Resume and enforces reduced motion automatically; content stays readable.
+Contained web layout accepts grid-template-columns/rows with 1–8 positive px/em/rem/%/vw/vh/fr tracks; fr is 0.01–16. Use the existing media-query grammar to replace unequal desktop tracks such as 1.2fr 1fr with 1fr on small screens. Grid column/row starts and ends use positive lines 1–9 or end spans 1–8; the grid-column/grid-row shorthand requires start / end or start / span N and cannot address beyond line 9 in one declaration list. Separately matching rules can combine start 9 and span 8 so one explicit placement reaches end line 17 across at most 16 tracks; that reach is not a universal implicit-grid size cap, and the compiler does not pretend to evaluate the browser's whole selector cascade. Siblings may share the same bounded cell for a contained overlay; source DOM order decides paint. Position, inset and z-index remain unavailable. align-self/justify-self accept start/end/center/stretch. flex-grow/flex-shrink accept 0–8; flex-basis accepts auto or a positive approved dimension. aspect-ratio accepts one positive number or a positive N / N pair from 0.01–100; object-position requires two 0–100% coordinates. Pair dimensions with object-fit:cover for a stable crop. repeat(), minmax(), named tracks/areas, subgrid and computed sizing remain unavailable. These layout declarations are web-only; email keeps readable source order and omits them.
+
+HTML sections use the default contained variant unless the author explicitly chooses variant:"canvas" (shown as Edge to edge). Canvas removes the trusted section envelope's horizontal and vertical inset from the HTML payload only; a title, intro, actions or footnote stays in its trusted rail, and an absent field creates no empty rail. A nested canvas fills only its trusted parent, never the viewport, so do not imitate it with negative margins, 100vw, positioning or another breakout. Email retains the canvas value as content data but emits readable source order with no canvas geometry.
+
+The proven representative native-video canvas pattern uses a trusted inverse hero frame and an admitted Look with 1128px border-box content maxima, 24px desktop and 16px mobile horizontal padding, existing flex centering, and finite px/em text maxima. Headings inherit trusted design fonts. Do not add calc(), ch, var(), font-family or an author-font grant. Keep default sections and optional action rails compatible, and preserve approved copy, links, alt text and media exactly.
+
+Named local @keyframes animate transform/background-position only. Transform supports up to three distinct single-argument functions: translateX/Y ±16px, rotate ±5deg, scale 0.95–1.05. One animation per rule: shorthand or name/duration/delay/timing-function/iteration-count/direction/fill-mode longhands. Duration 0.2–30s, delay 0–5s, iterations 1–10 or infinite (at least 2s per cycle), linear/ease/ease-in/ease-out/ease-in-out, normal/reverse/alternate/alternate-reverse, none/forwards/backwards/both. Animation names are case-sensitive and must be defined in the same sheet. Transition shorthand supports transform or background-position, 0.1–2s and one of those easings. An admitted animation receives the site's Pause/Resume control and reduced-motion enforcement; static and transition-only styles do not receive that control. Content stays readable.
 
 Block-local canonical stylesheet limits: 16,384 characters, 2,048 AST nodes, 64 ordinary rules, 32 declarations per rule, 8 selector arms and 8 compounds per arm, 8 keyframes with 2–16 stops and at most 4 motion declarations per stop. A Look's separate ceiling is 16,384 UTF-8 bytes. One media nesting layer. An unsupported or malformed HTML-island sheet is omitted as a whole while readable HTML remains; invalid Look CSS instead refuses preview/save and is never silently discarded as a valid Look save. No URLs/imports/font loading, custom properties, positioning, opacity, hiding, flashing, resource fetches or !important. Existing HTML/media URL and proposal provenance policies still apply. Web rendering retains scoped interactive/motion behavior. Email resolves static selector specificity, order, inline precedence and inheritance, then emits safe inline styles with solid gradient fallback; hover/media/motion effects are omitted. Email preview uses the actual email producer.
 
 Background-position keyframes use exactly two endpoints, from/0% and to/100%, over at least 2s; transform-only entrances may be shorter. The 16,384-character cap applies to canonical serialized CSS. Input/runtime transport allows 2MiB for encoded scope expansion; rescoping restores the same canonical budget. Email matching is capped at 200,000 memoized states per fragment; exhaustion preserves readable content and original inline styles without a partial cascade.
 
-CSS policy revision: html-scoped-css-v1.1.
+CSS policy revision: html-scoped-css-v1.2.
 
 Font-family accepts an ordered comma list of at most 8 entries from serif, sans-serif, monospace, system-ui, arial, georgia, verdana only; no quoted/unknown fonts or font loading. Solid background accepts approved opaque named or 3/6-digit hex colors and canonicalizes to background-color, with last-declaration source order; it is a color alias, not general background layer/reset syntax. Example declarations: font-family:Georgia,serif;background:#ffffff;font-size:1rem. Font-size must be at least 12px, 1em/1rem or 100%; 0.95rem is rejected. Unsupported declarations reject the entire stylesheet, so inspect saved HTML rather than assuming generic validation means every style survived.
 

package/skill/references/tools.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 42 tools · 170 actions · 5 prompts · fingerprint `bb52a9d1`._
+_Tool surface: 47 tools · 170 actions · 5 prompts · fingerprint `c6ca31f7`._
 
 Every tool the Phenomenal MCP server offers, in the order a client lists them. `list_my_orgs` is first because every other tool needs an organization id from it.
 
@@ -116,7 +116,7 @@ Read the complete authorized page content, Looks appearance, revisions, actions
 
 ### `preview_page_changes`
 
-Validate complete page content and a Look together without writing. DRAFT previews edits; PUBLISH previews the exact stored draft.
+Validate complete page content, pending reusable-copy receipts and a Look together without writing. DRAFT previews edits; PUBLISH accepts no edits or pending copies and previews the exact stored draft.
 
 **Hints:** read-only, idempotent. **Confirm:** not required.
 
@@ -128,11 +128,12 @@ Validate complete page content and a Look together without writing. DRAFT previe
 - `expectedThemeRevision` (string, required) — Copy exactly from get_page_authoring_state; never infer or synthesize it.
 - `content` (object)
 - `lookChange` (any)
+- `pendingCopies` (array) — Exact pendingCopy receipt(s) from prepare_reusable_content_copy. cancelledRootIds may contain only deliberately removed inserted roots.
 - `effect` (string (DRAFT | PUBLISH)) — DRAFT by default. PUBLISH accepts no edits and previews stored state.
 
 ### `save_page_changes`
 
-Save one previously previewed complete page-and-Look DRAFT atomically. It remains private and never publishes or retries.
+Save one previously previewed complete page-and-Look DRAFT with the identical pending reusable-copy receipts atomically. It remains private and never publishes or retries.
 
 **Hints:** writes. **Confirm:** not required.
 
@@ -144,8 +145,82 @@ Save one previously previewed complete page-and-Look DRAFT atomically. It remain
 - `expectedThemeRevision` (string, required) — Copy exactly from get_page_authoring_state; never infer or synthesize it.
 - `content` (object)
 - `lookChange` (any)
+- `pendingCopies` (array) — Exact pendingCopy receipt(s) from prepare_reusable_content_copy. cancelledRootIds may contain only deliberately removed inserted roots.
 - `previewDigest` (string, required) — Copy exactly from the matching VALID DRAFT preview.
 
+### `list_reusable_content`
+
+List compact reusable-content summaries this actor may read, including exact revision, policy and distinct read/use/revise/administer facts. Use get_reusable_content for blocks and grants.
+
+**Hints:** read-only, idempotent. **Confirm:** not required.
+
+**Arguments**
+
+- `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `limit` (integer)
+- `cursor` (string) — The prior page’s last returned content id.
+
+### `get_reusable_content`
+
+Read one authorized reusable composition and exact revision with complete blocks, grants and permission facts. An unavailable id reveals no metadata.
+
+**Hints:** read-only, idempotent. **Confirm:** not required.
+
+**Arguments**
+
+- `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `contentId` (string, required)
+- `revisionId` (string) — Optional exact immutable revision id.
+
+### `save_reusable_content_new`
+
+Save a new private reusable-content identity from complete canonical blocks. It does not publish or insert content anywhere.
+
+**Hints:** writes, idempotent. **Confirm:** not required.
+
+**Arguments**
+
+- `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `ownerGroupId` (any)
+- `name` (string, required)
+- `description` (string)
+- `blocks` (array, required) — The complete canonical Phenomenal block array, including every locale and child.
+- `initialUseAudience` (string, required) — public, members, or group:<uuid>.
+- `idempotencyKey` (string, required) — A caller-stable key for this exact input.
+
+### `save_reusable_content_revision`
+
+Append one immutable complete-block revision under exact revision and policy compare-and-swap values. Existing revisions remain unchanged.
+
+**Hints:** writes, idempotent. **Confirm:** not required.
+
+**Arguments**
+
+- `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `contentId` (string, required)
+- `expectedRevisionId` (string, required)
+- `expectedPolicyVersion` (integer, required)
+- `blocks` (array, required) — The complete canonical Phenomenal block array, including every locale and child.
+- `idempotencyKey` (string, required) — A caller-stable key for this exact input.
+
+### `prepare_reusable_content_copy`
+
+Read source and destination state first, then create actor-bound 30-minute staging against the complete unsaved candidate and exact destination token. Inspect the returned complete blocks, source snapshot, fresh IDs and expiresAt. For a page, DRAFT preview and explicitly save with the identical pendingCopy, then read back canonical state; event and broadcast saves are also explicit and never publish or send. Copies are independent: source edits or revocation do not rewrite committed destinations, and restricted media keeps its policy. If latest was omitted, retry with the returned explicit source revision.
+
+**Hints:** writes, idempotent. **Confirm:** not required.
+
+**Arguments**
+
+- `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `contentId` (string, required)
+- `revisionId` (string) — Optional exact source revision. Reuse the returned source.revisionId on retry.
+- `destination` (object, required)
+- `expectedDestinationToken` (string, required)
+- `destinationAudience` (string, required) — public, members, or group:<uuid>.
+- `candidateBlocks` (array, required) — The complete canonical Phenomenal block array, including every locale and child.
+- `insertionIndex` (integer, required)
+- `idempotencyKey` (string, required) — A caller-stable key for this exact prepare.
+
 ### `draft_page`
 
 Draft content for a Phenomenal page from a plain-language instruction and return the blocks. It SAVES NOTHING — show the result to the person, then save it with update_page_draft. This counts against the organization's AI budget, exactly as drafting from the admin app does.
@@ -194,13 +269,14 @@ Take a page off the live Phenomenal site. The draft is kept, but every link anyo
 
 ### `list_events`
 
-The events on a Phenomenal organization's calendar, soonest first, with whether each one is published.
+List compact event summaries on a Phenomenal organization's calendar, soonest first. Pass eventId alone to read one complete authorized event including pageBlocks.
 
 **Hints:** read-only, idempotent. **Confirm:** not required.
 
 **Arguments**
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `eventId` (string) — Read one complete authorized event. Cannot be combined with from or to.
 - `from` (string) — Only events starting on or after this date (YYYY-MM-DD).
 - `to` (string) — Only events starting on or before this date (YYYY-MM-DD).
 
@@ -222,7 +298,7 @@ Create an event in Phenomenal. It starts UNPUBLISHED — nobody outside the orga
 
 ### `update_event`
 
-Change an event in Phenomenal — its title, time, place or description. Only the fields you pass are changed. If the event is already published, the site changes at once.
+Change an event in Phenomenal — its title, time, place or description. Only the fields you pass are changed. A prepared copy requires complete pageBlocks, the exact revision and pendingCopies together. If the event is already published, the site changes at once.
 
 **Hints:** writes, idempotent. **Confirm:** not required.
 
@@ -235,6 +311,9 @@ Change an event in Phenomenal — its title, time, place or description. Only th
 - `endsAt` (string) — A new end, ISO 8601.
 - `location` (string) — A new location.
 - `description` (string) — A new description.
+- `pageBlocks` (array) — The complete prepared event-page candidate. Live data bindings are not supported here.
+- `expectedRevision` (string) — Exact revision read from list_events and used for preparation.
+- `pendingCopies` (array) — Exact pendingCopy receipt(s) from prepare_reusable_content_copy. cancelledRootIds may contain only deliberately removed inserted roots.
 
 ### `set_event_published`
 
@@ -273,28 +352,33 @@ Who is in one Phenomenal group, with each person's relation to it (member, stewa
 
 ### `list_broadcasts`
 
-The email broadcasts of a Phenomenal organization — drafts and sent ones — with how many people each reached.
+List compact broadcast summaries for a Phenomenal organization. Pass broadcastId to read one complete authorized draft including localized subject and body.
 
 **Hints:** read-only, idempotent. **Confirm:** not required.
 
 **Arguments**
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+- `broadcastId` (string) — Read one complete authorized broadcast by id.
 - `status` (string) — Only broadcasts in this state, e.g. "draft" or "sent".
 
 ### `draft_broadcast`
 
-Write an email broadcast draft for a Phenomenal organization and choose who it would go to. SENDS NOTHING — it creates a draft and tells you how many people it would reach.
+Create an email broadcast draft, or explicitly save complete prepared bodyBlocks into an existing draft with its exact revision and pendingCopies. SENDS NOTHING in either mode.
 
 **Hints:** writes. **Confirm:** not required.
 
 **Arguments**
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
-- `subject` (string, required) — The subject line families will see.
-- `body` (string, required) — The message, in Markdown. Write it the way a parent would want to read it — short, warm, and clear about dates and what to do.
-- `audience` (object) — Who it goes to. Leave it out entirely to address every member of the organization.
+- `broadcastId` (string) — Existing draft id. Omit to create a new markdown draft.
+- `subject` (string) — The subject line families will see.
+- `body` (string) — The message, in Markdown. Write it the way a parent would want to read it — short, warm, and clear about dates and what to do.
+- `audience` (object) — Who it goes to. Omission selects every member for a new draft, but preserves the stored audience when saving an existing draft.
 - `replyTo` (string) — Where replies go. Optional — the organization's contact address is used otherwise.
+- `bodyBlocks` (array) — Complete prepared block-body candidate for existing-draft mode only.
+- `expectedRevision` (string) — Exact revision used to prepare this existing broadcast draft.
+- `pendingCopies` (array) — Exact pendingCopy receipt(s) from prepare_reusable_content_copy. cancelledRootIds may contain only deliberately removed inserted roots.
 
 ### `send_broadcast_test`