rapier-embed 1.1.99 → 1.1.102

package/README.md

@@ -27,11 +27,11 @@ or `https://rapier.website/embed/<version>/<file>` (permanent).
 - Editor saves are revision-checked: a conflict keeps the person's source in the editor.
 - `<rapier-editor>` is a form field whose value is the exact saved Markdown, pictures and line endings included.
 - With `agent: true`, your app's agent works beside the person or while they are away. Rapier shows what changed;
-  `comparison.present` lets the agent display a diff deliberately. Currentness, source scope and authenticated
+  `show {target:"comparison"}` lets the agent display a diff deliberately. Currentness, source scope and authenticated
   document access remain enforced.
 
 ```sh
-npm install rapier-embed@1.1.99
+npm install rapier-embed@1.1.102
 ```
 
 Or copy the package's `embed.mjs` and `contract.mjs` into one directory of your app; no runtime CDN is needed.
@@ -44,10 +44,10 @@ Rapier is a phone-first Markdown editor for notes, diagrams, drawing and waterco
 as one HTML file on Android, Web and Windows.
 Collaborate over MCP and WebMCP, use optional encrypted sync to your own Cloudflare account, or embed the
 editor and lightweight reader (about 190 kB gzipped). The agent edits live; the person sees its presence and
-changes, taps a change to see the before and undoes anything. Use `comparison.present` to show a diff deliberately.
+changes, taps a change to see the before and undoes anything. Use `show {target:"comparison"}` to show a diff deliberately.
 
-1. **Work together live.** Connect to `https://mcp.rapier.website/mcp`, then call `rapier.open` to share one document with the person.
-2. **Deliver an offline editor.** Run `npx rapier-html@1.1.99 notes.md` to put the document and editor in one HTML file ([rapier-html](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-html)).
+1. **Work together live.** Connect to `https://mcp.rapier.website/mcp`, then call `open` to share one document with the person.
+2. **Deliver an offline editor.** Run `npx rapier-html@1.1.102 notes.md` to put the document and editor in one HTML file ([rapier-html](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-html)).
 3. **Embed in your app.** Install [rapier-embed](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-embed); mount the editor or reader, with your app's agent over WebMCP in the editor.
 4. **Keep portable Markdown.** Use [rapier-markdown-kit](https://github.com/jackskip22/rapier-plugins/tree/main/npm/rapier-markdown-kit) for pictures, editable SVG drawings and layout in one `.md` file. Respect [Will/1](https://github.com/jackskip22/will) `keep`, `append` and `edit` regions.
 5. **Encode JPEG XL.** Install [rapier-jxl](https://github.com/jackskip22/rapier-jxl) to encode pixels, photographs and existing JPEGs in JavaScript.
@@ -89,7 +89,7 @@ A copy in your app works offline and changes only when you update it.
 1. Download the build you frame into a static directory, for example
    `https://rapier.website/embed/<version>/rapier-reader.html` to `public/vendor/rapier/`.
 2. Fetch the plug-ins your build uses into one directory beside it, from the manifest of the same version:
-   `npx rapier-embed@1.1.99 plugins public/vendor/rapier/plugins --build reader`.
+   `npx rapier-embed@1.1.102 plugins public/vendor/rapier/plugins --build reader`.
 3. Mount with `src` and `plugins` pointing at your copies. Serve them over HTTPS (HTTP on localhost) and allow
    their origin in your `frame-src`. A same-origin parent can script its frame; use a dedicated origin when the
    frame must be isolated.
@@ -105,7 +105,7 @@ length and SHA-384 before it runs it, and keeps on the device. A file that fails
 | --- | --- | --- | --- |
 | `flowchart` | Mermaid flowcharts and graphs, drawn natively | 0.26 MB | The reader; built into the editors |
 | `math` | TeX maths, `$...$` and `$$...$$` | 11.9 MB | All three |
-| `diagrams` | Every other Mermaid diagram: sequence, class, state, ER, Gantt, pie and more | 7.4 MB | All three |
+| `diagrams` | Mermaid and ZenUML diagrams, drawn by Rapier | 0.29 MB | All three |
 | `pdf` | Opens a PDF as a Markdown document: its text layer, or each page as a picture | 6.4 MB (197 files) | All three |
 | `docx` | Opens a Word document (`.docx`) as a Markdown document | 0.25 MB | The reader; built into the editors |
 | `ocr` | Finds text in pictures, so search reaches words inside them | 21.5 MB | All three |
@@ -123,7 +123,7 @@ The directory must be on the page's own origin, because the page's Content Secur
 throws a `TypeError` for a directory on another origin, and a page opened with one shows each plug-in as failed, with the
 reason, without making a request. To keep the plug-ins on a CDN, serve the page from the same origin.
 
-`npx rapier-embed@1.1.99 plugins <directory>` fetches every file the manifest lists, checks it, and writes it. It
+`npx rapier-embed@1.1.102 plugins <directory>` fetches every file the manifest lists, checks it, and writes it. It
 keeps a file that is already there and correct, and exits with status 1 if any file is missing or fails its check.
 `--build reader`, `--build document` or `--build full` keeps the files that build uses, `--only name,name` fetches some
 plug-ins, `--check` verifies a directory without fetching, `--from <address>` fetches from your own mirror, and
@@ -149,7 +149,7 @@ done
 ```
 
 **Without `plugins`.** `rapier-document.html` and `rapier.html` look for the `math` and `diagrams` files beside the page,
-at the file names the manifest lists (the diagrams' ZenUML file under `plugins/`), before their pinned address. The
+at the file names the manifest lists, before their pinned addresses. The
 PDF reader, text in pictures and letter sets come from their pinned addresses.
 
 ## Style the reader
@@ -276,7 +276,7 @@ written over personal preferences. Features are a subset of `draw`, `paint`, `no
 `find`; absent means everything that build has, empty means none. The document build carries no Draw, Paint or
 Notes. This release carries only English; another valid BCP 47 tag falls back to `en`. Unknown features and
 malformed fields are named refusals, not ignored options. Limits are positive integer byte counts, clamped to
-25 MiB of UTF-8 document text and 16 MiB of encoded picture bytes. Accent preset names are `Teal`, `Blue`,
+64 MiB of UTF-8 document text and 16 MiB of encoded picture bytes. Accent preset names are `Teal`, `Blue`,
 `Amber`, `Green`, `Red`, `Purple`, `Pink` and `Gray`; the person's later choice takes precedence.
 
 `assets` is independently optional: it grants pictures, not document readback, opening, agents or changes.
@@ -360,19 +360,18 @@ submission; they are not durable server saves.
 
 ## Work with your app's agent
 
-With `agent: true`, the frame registers Rapier's document tools through WebMCP for your page's origin; the
+With `agent: true`, the frame registers Rapier's six tools through WebMCP for your page's origin; the
 browser needs WebMCP and the `tools` permission, which mount grants the frame. There is no arbitrary `invoke`
-postMessage. The tools are the hosted door's (see the [agent guide](https://rapier.website/agents)):
-`document.observe`, `document.read`, `document.edit`,
-`document.draw` for diagrams, `document.undo` and the rest. Painting needs `rapier.html`, and
-`editor.open_file` is unavailable in an embedded editor. Reads require a target kind or cursor alone; native
-drawing calls require a create/edit target, and Undo requires an act/turn target.
-`editor.set_view({view})` separately requests formatted, source or Notes cards.
-
-`editor.set_preferences` takes `{preference, value}` for one supported device preference and reports the
-previous value. An active host theme or accent refuses an agent override; later human choices win. Copying,
-read aloud and built-in plugin requests return actual device receipts, including platform restrictions or
-required gestures. Word and PDF exports use `document.export`. Physical read-only resources stay read-only.
+postMessage. The tools are `open`, `read`, `edit`, `undo`, `show` and `export`, as on the hosted door
+(see the [agent guide](https://rapier.website/agents)). Read exact text and its revision; edit unique text
+at that revision. Native drawing and painting are fenced text; painting needs the full `rapier.html`.
+`show {target:"file"}` asks the person to choose a file, subject to the embed grant and native gesture.
+`show {target:"view",view}` requests formatted, source or Notes cards.
+
+`show {target:"preferences",preference,value}` changes one supported device preference and reports the
+previous value. An active host theme or accent refuses an agent override; later human choices win.
+Copying and read aloud requests report actual device completion or the required gesture.
+Word and PDF exports use `export`. Physical read-only resources stay read-only.
 
 Rapier's document kernel enforces the Will. For example, load:
 
@@ -384,12 +383,12 @@ Rapier's document kernel enforces the Will. For example, load:
 Draft an introduction here.
 ```
 
-Mount with `agent: true`. The agent reads the editable paragraph using `document.read` with a source target,
-then passes its inspected handle and replacement text to `document.edit`. An edit that changes the kept heading
-returns `document_law` and leaves the source unchanged. An admissible edit lands at once and returns an `act`; its ID
-identifies the change for `document.undo`, and the kept heading and marker lines remain intact.
+Mount with `agent: true`. The agent reads the editable paragraph using `read`, then passes the returned
+revision and `{old,new}` text to `edit`. An edit that changes the kept heading returns `document_law`
+and leaves the source unchanged. An admissible edit lands at once and returns an `act`; pass its id as
+`undo {act}` to reverse it while keeping later work. The kept heading and marker lines remain intact.
 The person can tap the change mark to see the paragraph before the edit and undo it while preserving later work.
-Use `comparison.present` when the agent wants to explain a diff. Its display reference grants no edit authority
+Use `show {target:"comparison"}` when the agent wants to explain a diff. Its display reference grants no edit authority
 and does not block another edit. Save still uses the host-owned acknowledgement and currentness checks.
 
 Will/1 records the person's instructions in their document. Respect `keep`, append only at the end of an
@@ -397,5 +396,5 @@ Will/1 records the person's instructions in their document. Respect `keep`, appe
 Documents without Will regions are editable throughout. Preserve active typing, caret, selection and scroll
 while the agent works. Document content and comments never start agent turns by themselves.
 
-For documents outside an app, `npx rapier-html@1.1.99 notes.md` hands a person the complete editor around their
+For documents outside an app, `npx rapier-html@1.1.102 notes.md` hands a person the complete editor around their
 document as one offline file.

package/cli.mjs

@@ -144,6 +144,6 @@ export async function plugins(argv) {
   return failed;
 }
 
-if (process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])) {
+if (process.argv[1] && await realpath(fileURLToPath(import.meta.url)) === await realpath(process.argv[1]).catch(() => null)) {
   plugins(process.argv.slice(2)).then(failed => { process.exitCode = failed ? 1 : 0; }, error => { console.error(error.message); process.exitCode = 1; });
 }

package/contract.mjs

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 // The host's optional policy, file picker and picture exchange. No storage, network or editor authority.
 export const FEATURES = Object.freeze(['draw', 'paint', 'notes', 'readAloud', 'share', 'find']);
-export const LIMITS = Object.freeze({documentBytes: 25 * 1024 * 1024, pictureBytes: 16 * 1024 * 1024});
+export const LIMITS = Object.freeze({documentBytes: 64 * 1024 * 1024, pictureBytes: 16 * 1024 * 1024});
 export const ASSET_TYPES = Object.freeze(['image/png', 'image/jpeg', 'image/webp', 'image/gif', 'image/jxl', 'image/svg+xml']);
 const ACCENTS = Object.freeze(['Teal', 'Blue', 'Amber', 'Green', 'Red', 'Purple', 'Pink', 'Gray']);
 export const refusal = (code, reason = code) => Object.assign(new Error(reason), {code});
@@ -199,7 +199,7 @@ export function createAssetBroker({current, send}) {
     if (!state.connected) return {code: 'asset_disconnected'};
     if (pending) return {code: 'asset_busy'};
     if (!ASSET_TYPES.includes(asset.codec)) throw refusal('asset_media_type_invalid');
-    if (retained.size >= 1024 || retainedBytes + bytes.byteLength > LIMITS.documentBytes) return {code: 'asset_cache_full'};
+    if (retained.size >= 1024 || retainedBytes + bytes.byteLength > 25 * 1024 * 1024) return {code: 'asset_cache_full'};
     // Keep our own bytes: postMessage clones them, never transfers/detaches the kept picture.
     const kept = {...asset, bytes: bytes.slice()};
     let resolve;

package/embed.mjs

@@ -4,7 +4,7 @@
 const {FEATURES, LIMITS, ASSET_TYPES, refusal, normalizeSettings, snapshotSettings, pickDeviceFile, createFilePicker, assetURL, assetBytes, bytesHash, externalImage, createAssetBroker} = (() => {
 // The host's optional policy, file picker and picture exchange. No storage, network or editor authority.
 const FEATURES = Object.freeze(['draw', 'paint', 'notes', 'readAloud', 'share', 'find']);
-const LIMITS = Object.freeze({documentBytes: 25 * 1024 * 1024, pictureBytes: 16 * 1024 * 1024});
+const LIMITS = Object.freeze({documentBytes: 64 * 1024 * 1024, pictureBytes: 16 * 1024 * 1024});
 const ASSET_TYPES = Object.freeze(['image/png', 'image/jpeg', 'image/webp', 'image/gif', 'image/jxl', 'image/svg+xml']);
 const ACCENTS = Object.freeze(['Teal', 'Blue', 'Amber', 'Green', 'Red', 'Purple', 'Pink', 'Gray']);
 const refusal = (code, reason = code) => Object.assign(new Error(reason), {code});
@@ -202,7 +202,7 @@ function createAssetBroker({current, send}) {
     if (!state.connected) return {code: 'asset_disconnected'};
     if (pending) return {code: 'asset_busy'};
     if (!ASSET_TYPES.includes(asset.codec)) throw refusal('asset_media_type_invalid');
-    if (retained.size >= 1024 || retainedBytes + bytes.byteLength > LIMITS.documentBytes) return {code: 'asset_cache_full'};
+    if (retained.size >= 1024 || retainedBytes + bytes.byteLength > 25 * 1024 * 1024) return {code: 'asset_cache_full'};
     // Keep our own bytes: postMessage clones them, never transfers/detaches the kept picture.
     const kept = {...asset, bytes: bytes.slice()};
     let resolve;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapier-embed",
-  "version": "1.1.99",
+  "version": "1.1.102",
   "description": "Embed the Rapier Markdown editor or its lightweight reader (about 190 kB) in your web app. Runs offline from your own copy, saves to your storage, and takes your CSS and fonts. Your app's AI agent edits directly over WebMCP under the Will. MIT, no dependencies.",
   "keywords": [
     "markdown",

package/rapier-plugins.json

@@ -1,6 +1,6 @@
 {
   "schema": 1,
-  "release": "1.1.99",
+  "release": "1.1.102",
   "directory": "Put every file in one directory, keeping each file's folder, and give the page its address with `plugins`. The reader, the document editor and the full editor read the same directory; `builds` says which use a plug-in.",
   "plugins": [
     {
@@ -11,11 +11,11 @@
       ],
       "files": [
         {
-          "file": "rapier-flowchart-1.1.99.js",
-          "bytes": 274686,
-          "sha384": "1e129175747dc29b93b1075d2e98ce3c5cb2acb1de29427929c6d8b56fc2a30716d819e6eb6e33c55aedf3d8ab0a9c9a",
-          "sri": "HhKRdXR9wpuTsQddLpjOPFyyrLHeKUJ5KcbYtW/CowcW2Bnm624zxVrt89irCpya",
-          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/flowchart/rapier-flowchart-1.1.99.js"
+          "file": "rapier-flowchart-1.1.102.js",
+          "bytes": 292737,
+          "sha384": "15d581733ac4cc6ab19b3bda4942333d29ac5ae4b563b70c9503b745d2661ca66fa73371e5073b8c98f393be691f81d1",
+          "sri": "FdWBczrEzGqxmzvaSUIzPSmsWuS1Y7cMlQO3RdJmHKZvpzNx5Qc7jJjzk75pH4HR",
+          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/flowchart/rapier-flowchart-1.1.102.js"
         }
       ]
     },
@@ -27,11 +27,11 @@
       ],
       "files": [
         {
-          "file": "rapier-docx-1.1.99.js",
-          "bytes": 253377,
-          "sha384": "99dcf68f05f280b05f25302c2f0ef70c4534332d121c65ac19022b56ad142a2e2d5c2f5ea8664b14e2e73c1e747da64d",
-          "sri": "mdz2jwXygLBfJTAsLw73DEU0My0SHGWsGQIrVq0UKi4tXC9eqGZLFOLnPB50faZN",
-          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/docx/rapier-docx-1.1.99.js"
+          "file": "rapier-docx-1.1.102.js",
+          "bytes": 578033,
+          "sha384": "1d6295d9ae3089e84f60dd71e08eac9e16e3d8ceaa5cd4ca2576366ee68d13eaf0d219e1c1979d51f0613720fafe8e64",
+          "sri": "HWKV2a4wiehPYN1x4I6snhbj2M6qXNTKJXY2buaNE+rw0hnhwZedUfBhNyD6/o5k",
+          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/docx/rapier-docx-1.1.102.js"
         }
       ]
     },
@@ -45,17 +45,17 @@
       ],
       "files": [
         {
-          "file": "rapier-math-1.0.0.js",
-          "bytes": 806260,
-          "sha384": "9ef49db2e23773655bf9b8a8dd8fedc4b8d76ca45b8ce2f969887333a3cb6baedcdf014e5d9857b19086c2cef8daf901",
-          "sri": "nvSdsuI3c2Vb+bio3Y/txLjXbKRbjOL5aYhzM6PLa67c3wFOXZhXsZCGws742vkB",
-          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/math/rapier-math-1.0.0.js"
+          "file": "rapier-math-1.0.1.js",
+          "bytes": 803451,
+          "sha384": "d64767ea6a21c776b93008b0a91598fbaa2f8941d485e1df63554cb318c3b14ae7ef0a1369aec548aa388ee62db8d685",
+          "sri": "1kdn6mohx3a5MAiwqRWY+6oviUHUheHfY1VMsxjDsUrn7woTaa7FSKo4juYtuNaF",
+          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/math/rapier-math-1.0.1.js"
         }
       ]
     },
     {
       "name": "diagrams",
-      "adds": "Draws every other Mermaid diagram: sequence, class, state, ER, Gantt, pie and more.",
+      "adds": "Draws Mermaid diagrams with Rapier: sequence, class, state, ER, Gantt, pie and more.",
       "builds": [
         "reader",
         "document",
@@ -63,18 +63,11 @@
       ],
       "files": [
         {
-          "file": "mermaid.min.js",
-          "bytes": 5493176,
-          "sha384": "11b0698ceeeb951e9ea9911c1bb19a3e9ca4f47f56accc8f597e1ddcabcf625b60b7c67c974cfa479e81d6a3f8d29478",
-          "sri": "EbBpjO7rlR6eqZEcG7GaPpyk9H9WrMyPWX4d3KvPYltgt8Z8l0z6R56B1qP40pR4",
-          "url": "https://cdn.jsdelivr.net/npm/mermaid@12.1.0/dist/mermaid.min.js"
-        },
-        {
-          "file": "rapier-zenuml-4.5.0-1.js",
-          "bytes": 1890966,
-          "sha384": "3159ff3abd672074c3bf2f38952489007d85c7563b006a1a31f77b856ee2dcb25eeccfdd6aef150c59c5f10f97d2a3a5",
-          "sri": "MVn/Or1nIHTDvy84lSSJAH2Fx1Y7AGoaMfd7hW7i3LJe7M/dau8VDFnF8Q+X0qOl",
-          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier@main/site/plugins/rapier-zenuml-4.5.0-1.js"
+          "file": "rapier-diagrams-1.1.102.js",
+          "bytes": 294857,
+          "sha384": "7e64077953899d7d60c1aa958a19c8fc51523fc866f8187f74b416435ef2bd4009a05f6d15dd9dea6639b59db8f6df2e",
+          "sri": "fmQHeVOJnX1gwaqVihnI/FFSP8hm+Bh/dLQWQ17yvUAJoF9tFd2d6mY5tZ249t8u",
+          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/diagrams/rapier-diagrams-1.1.102.js"
         }
       ]
     },
@@ -88,11 +81,11 @@
       ],
       "files": [
         {
-          "file": "rapier-pdf-1.1.99.js",
-          "bytes": 22770,
-          "sha384": "c72a941815bb4ad56633ac45c29c2b87db3a431115606b9f0f673070a23ed812c326393db79297eb0118b1e5e10e87d3",
-          "sri": "xyqUGBW7StVmM6xFwpwrh9s6QxEVYGufD2cwcKI+2BLDJjk9t5KX6wEYseXhDofT",
-          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/pdf/rapier-pdf-1.1.99.js",
+          "file": "rapier-pdf-1.1.102.js",
+          "bytes": 28665,
+          "sha384": "88ab886108233b36a8750e8da1bf18a0977f95d33222114a15b3c70d7127af6a17f3e8dea4aa500a91300df68fa3fd72",
+          "sri": "iKuIYQgjOzaodQ6Nob8YoJd/ldMyIhFKFbPHDXEnr2oX8+jepKpQCpEwDfaPo/1y",
+          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier-plugins@main/pdf/rapier-pdf-1.1.102.js",
           "builds": [
             "reader"
           ]
@@ -1561,11 +1554,11 @@
       ],
       "files": [
         {
-          "file": "rapier-font-subset-1.js",
-          "bytes": 1215411,
-          "sha384": "682b9aa9186c6e09232b5127764de403ee6bb37c1052fefd27f2d6c2496a8a96ce7f553d2747860540d95fce4ac3b23c",
-          "sri": "aCuaqRhsbgkjK1Endk3kA+5rs3wQUv79J/LWwklqipbOf1U9J0eGBUDZX85Kw7I8",
-          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier@main/site/plugins/rapier-font-subset-1.js"
+          "file": "rapier-font-subset-2.js",
+          "bytes": 1214356,
+          "sha384": "ab8987037faedcddd8b7ccf5c22b0211742a58da395211d9d275044a277c046359cfa06d57c75252554ebf29dd7344e3",
+          "sri": "q4mHA3+u3N3Yt8z1wisCEXQqWNo5UhHZ0nUESid8BGNZz6BtV8dSUlVOvyndc0Tj",
+          "url": "https://cdn.jsdelivr.net/gh/jackskip22/rapier@main/site/plugins/rapier-font-subset-2.js"
         }
       ]
     },