@overcrow/mcp 0.0.0 → 0.1.0

package/dist/content/docs/en/publishing.md

@@ -0,0 +1,162 @@
+# Publishing and review
+
+Widgets reach PlayerVox OverCrow users through the signed widget catalog:
+OverCrow installs only what that catalog lists. This page goes from a
+widget's source directory to a listed version. Neither a pull request nor a
+merge publishes anything: publication is a separate step of the maintainers,
+outside CI.
+
+## The submission
+
+A submission is a widget source directory under `widgets/<dir>/` of the
+[public repository](https://github.com/Valhallab/playervox-overcrow-releases),
+in a pull request to its `candidate` branch:
+
+```text
+widgets/<dir>/
+  manifest.json   view.ocml   style.ocss?   logic.ts | logic.js
+  locales/en.json + locales/fr.json?   assets/**?   LICENSE
+  listing.json    (marketplace text, never packaged)
+```
+
+You submit sources, not a package: the catalog always ships the package
+rebuilt from the reviewed sources.
+
+Package IDs under `com.playervox` are reserved for widgets published by
+PlayerVox. Use a reverse-DNS ID under a domain you control, and keep it:
+the ID is the widget's identity in the catalog.
+
+## The listing
+
+`listing.json` holds what the marketplace shows:
+
+<!-- source: docs/content/examples/weather/listing.json -->
+```json
+{
+  "author": "Example Studio",
+  "spdxLicense": "MIT",
+  "sourceUrl": "https://github.com/example/weather-widget",
+  "defaultLocale": "en",
+  "localizations": [
+    { "locale": "en", "name": "Weather", "description": "The temperature of a city, refreshed every 30 minutes." },
+    { "locale": "fr", "name": "Météo", "description": "La température d’une ville, actualisée toutes les 30 minutes." }
+  ]
+}
+```
+
+<!-- generated:listing-fields -->
+| Field | Type | Required | Meaning |
+| --- | --- | --- | --- |
+| `author` | text ≤ 128 bytes | yes | Plain text, trimmed, without `<` or `>`. |
+| `spdxLicense` | text ≤ 64 bytes | yes | SPDX expression characters `[A-Za-z0-9.+-]`. |
+| `sourceUrl` | text ≤ 2 KiB | yes | Canonical HTTPS URL of the reviewed source, without port, query or fragment. |
+| `defaultLocale` | `locale` | yes | One of the localizations. |
+| `localizations` | list of `Localization` ≤ 16 | yes | `{ locale, name, description }` with distinct `xx` or `xx-YY` locales; name ≤ 128 bytes, description ≤ 512 bytes. |
+<!-- /generated:listing-fields -->
+
+- `author`, names and descriptions are plain, trimmed text without `<` or
+  `>`; locales are `xx` or `xx-YY`, one of them `defaultLocale`.
+- `spdxLicense` is an SPDX expression; the package's `LICENSE` holds its
+  text. PlayerVox widgets use MIT. The policy for third-party licenses is
+  not decided yet: a valid expression is reviewed, not approved by the
+  metadata ([licensing](../../../LICENSING.md)).
+- `sourceUrl` is a canonical HTTPS URL of the reviewed source, without
+  port, query or fragment.
+- `preview` (optional) names a PNG packaged under `assets/`, at most
+  256 KiB, for example `"preview": "assets/preview.png"`. The Control
+  Center and the marketplace show it whole in a 4:3 box, centred on the
+  colour `#1e242e`, at 1.5 pixels per screen point at most: render the
+  widget at 150 % (`"scale": 1500` in a scenario) and give the image a 4:3
+  shape, and it appears at its real size, never cropped or enlarged.
+
+## Admission: run it yourself
+
+```sh
+overcrow-widget admit widgets/<dir>
+overcrow-widget admit widgets/<dir> --package dist/<id>-<version>.ocpkg
+overcrow-widget admit widgets/<dir> --format json
+```
+
+`admit` is exactly the static admission of the marketplace. It never runs
+your code or `tsc`:
+
+1. it builds the directory as `package` does: every source, style, logic
+   and package check, then OverCrow's own package reader;
+2. with `--package`, your archive's compiled view must be byte for byte
+   what `view.ocml` compiles to;
+3. it checks the schema bounds, the reserved IDs, `listing.json`, the
+   preview and, for PlayerVox widgets, the MIT license;
+4. it lists the authority the widget requests for the reviewer: sensitive
+   capabilities, every network route, clipboard writes, storage and game
+   events.
+
+The command ends with status 1 when the submission would be refused. Its
+codes are listed with the [`admit` command](cli.md#admit).
+
+On a pull request, the admission tool is built from the reviewed base
+branch, never from your revision, and it reads your files as data: your
+JavaScript, TypeScript, build commands, tests and scripts are never
+executed there. A pull request may not change the tools of the admission
+themselves.
+
+## Review
+
+A maintainer reads the admission report and the source, then merges into
+`candidate`. Reviewers check:
+
+- **Identity.** A new ID under a domain the author controls. A new version
+  for any change: published versions are immutable, and a version lower
+  than a listed one is refused.
+- **Reproducibility.** The package is rebuilt from the reviewed sources.
+- **Authority.** Every capability, above all the sensitive ones; every
+  network route, which must serve the widget's stated purpose; clipboard
+  writes, storage and game events. See
+  [services and permissions](services.md).
+- **Listing.** Exact, plain text in every locale; a canonical source URL; a
+  preview that shows the widget.
+- **License.** `LICENSE` matches `spdxLicense`, and every bundled asset,
+  font or third-party code keeps its notice.
+
+On the merge, the exact revision is admitted again and a receipt binds the
+admitted package to the reviewed commit. Accepting a submission signs and
+publishes nothing.
+
+## The catalog
+
+The maintainers prepare the next catalog from admitted revisions and sign it
+outside CI with the catalog key, whose public half is in
+[`keys/`](../../../keys/). The catalog:
+
+- lists each version with the SHA-256 and the size of its package; a
+  published version never changes, and a change is a new version;
+- carries a strictly increasing sequence number and expires after at most
+  90 days: OverCrow refuses an older sequence and an expired catalog;
+- tags PlayerVox reference widgets `built-in` (only `com.playervox.*` IDs):
+  they are installed on a new profile with their declared permissions
+  granted, except for an update that asks for more.
+
+OverCrow verifies the signature, the package digest, its ledger and its
+compiled view before installing, and again each time it starts the widget.
+See [the package](package.md#how-overcrow-checks-a-package).
+
+## Updates
+
+A new version of your widget is a new submission with a higher `version`:
+a published version is never replaced. An update whose manifest asks for
+more than the installed version (a network rule, a game event, a
+capability, storage or the clipboard) needs the user's approval in the
+Control Center before it runs.
+
+## Version statuses
+
+Each listed version has a status:
+
+| Status | Meaning |
+| --- | --- |
+| `verified` | Installable. |
+| `security-suspended` | Suspected of compromise; not installed or updated to, and an installed copy is stopped. Reversible in a later catalog. |
+| `revoked` | Permanent: never installed again, and an installed copy is stopped. |
+
+Omitting a version from a catalog never changes its status. A catalog
+signature never bypasses package validation, the user's consent or the
+sandbox.

package/dist/content/docs/en/reference.md

@@ -0,0 +1,55 @@
+# Reference
+
+The reference of PlayerVox OverCrow widgets lists every element, style
+property, service and SDK function of widget API v1. This page says where
+each answer is. The pages of "Write a widget" explain how the parts work
+together; the pages below are the ones to keep open while you write.
+
+| Question | Page |
+| --- | --- |
+| What goes in `manifest.json`? | [The manifest](manifest.md) |
+| Which elements, attributes and events can a view use? | [Elements and attributes](elements.md) |
+| Which style properties and values are accepted? | [Style properties and tokens](style-properties.md) |
+| Which design tokens and icons exist? | [Design tokens](style-properties.md#design-tokens), [icons](style-properties.md#icons) |
+| Which functions does `@overcrow/sdk` export? | [SDK reference](sdk.md) |
+| How do I format times, dates and numbers? | [Time, dates and numbers](sdk.md#time-dates-and-numbers) |
+| What does each permission and capability allow? | [Services and permissions](services.md) |
+| What are the parameters and the result of a service? | [Service reference](service-reference.md), [result shapes](result-shapes.md) |
+| What does an error code mean? | [Errors](services.md#errors) |
+| Which fields does a write intent take? | [The intents](forms.md#the-intents) |
+| What are the limits (sizes, counts, budgets)? | [Limits](limits.md) |
+| What does each command and diagnostic of the CLI do? | [The command-line tool](cli.md) |
+| How is a test scenario written? | [Testing a widget](testing.md#scenarios) |
+| What is inside a `.ocpkg`? | [The package](package.md) |
+
+## How the reference stays exact
+
+- The tables of elements, attributes, style properties, tokens, services,
+  result shapes and limits are **generated from the widget schema**, the
+  same tables that OverCrow and the command-line tool compile into their
+  validators. A check fails when a page differs from the schema, in English
+  or in French.
+- The **SDK types** are generated from the same schema, so a wrong element,
+  icon, capability or service parameter is a TypeScript error in your
+  logic.
+- The **SDK reference** is checked by the SDK's tests: every export of
+  `@overcrow/sdk` is listed there.
+- Every **code example** of these pages is an excerpt of a project that the
+  command-line tool checks, packages and admits on each change: a template,
+  a reference widget or one of the two examples.
+
+## Versions
+
+These pages describe widget API v1 (`"apiVersion": 1` in the manifest) and
+`@overcrow/sdk` 1.0.
+
+## Specifications for implementers
+
+Three specifications, in the public repository, are written for those who
+implement a host or another tool rather than a widget: the complete
+[generated schema reference](../../widget-schema-v1.md), which also covers
+the protocol between OverCrow and the widget's process and the catalog's
+payloads; the
+[wire protocol of the development channel](../../dev-channel.md); and the
+[archive and catalog format](../../widget-package-v1.md). A widget author
+does not need them.

package/dist/content/docs/en/result-shapes.md

@@ -0,0 +1,332 @@
+# Result shapes
+
+What the services of PlayerVox OverCrow answer: the shape of each result
+and of each subscription update. The SDK exports a TypeScript type of the
+same name for each shape, so the logic never describes them by hand.
+
+<!-- source: widgets/stopwatch/logic.ts -->
+```ts
+declare module "@overcrow/sdk" {
+  interface WidgetState {
+    /** The latest state, or `null` while it is unknown. */
+    stopwatch: Stopwatch | null;
+    /** The buttons take input only in Interactive mode. */
+    interactive: boolean;
+  }
+}
+```
+
+The Stopwatch widget keeps the latest `Stopwatch` value in its state, and
+the view reads its members:
+
+<!-- source: widgets/stopwatch/view.ocml -->
+```xml
+      <elapsed class="value" base={state.stopwatch.elapsedMs} at={state.stopwatch.at} running={state.stopwatch.running} format="hh:mm:ss.cc"/>
+```
+
+## How to read a shape
+
+- A shape is an exact record: every member is present, and a member
+  without a value is `null`, never absent.
+- "text or `null`" means that the member may be `null`: test it before you
+  show it.
+- An integer is below 2^53, so it is exact in JavaScript. Times are in
+  milliseconds: "Unix milliseconds" count from 1970 in UTC, as `Date.now()`
+  does.
+- A member that goes with `offsetMinutes` is a timestamp to format with
+  that UTC offset; see
+  [time, dates and numbers](logic.md#time-dates-and-numbers).
+- An `asset:` handle is an image that OverCrow holds for the widget: bind
+  it to the `src` of an `image` or an `avatar`, or draw it on a canvas. It
+  is not a URL and cannot be read as bytes.
+- A subscription whose shape is "… or `null`" delivers `null` when there is
+  nothing to show: no active game, no media player.
+
+Which service gives which shape is in the
+[service reference](service-reference.md).
+
+## Shapes
+
+<!-- generated:result-shapes -->
+### `HttpResponse`
+
+Answer of `http.fetch`. `{ status, contentType }` or `{ status, asset }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `status` | integer | HTTP status. |
+| `contentType` | text or `null` | Response media type; the SDK adds the decoded body, `body`. |
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `status` | integer | HTTP status. |
+| `asset` | `asset:` handle | The decoded image (`as: "image"`). |
+
+### `GameEvent`
+
+One game event. `{ event, at }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `event` | text | A declared game event. |
+| `at` | integer | Host monotonic clock in ms. |
+
+### `Session`
+
+Duration of the active game session. `{ elapsedMs, at }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `elapsedMs` | integer | Time since the game process started. |
+| `at` | integer | Host monotonic clock in ms at which `elapsedMs` was measured. |
+
+### `Telemetry`
+
+Resource use of the active game. `{ cpu, ram, cpuTemperature, gpuTemperature, sources }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `cpu` | number or `null` | The game's share of the whole machine in %, from 0 to 100. |
+| `ram` | integer or `null` | Resident bytes of the game. |
+| `cpuTemperature` | number or `null` | °C. |
+| `gpuTemperature` | number or `null` | °C. |
+| `sources` | `{ cpuTemperature, gpuTemperature }` | Sensors the host has. |
+| `sources.cpuTemperature` | boolean | The host has a CPU sensor. |
+| `sources.gpuTemperature` | boolean | The host has a GPU sensor. |
+
+### `Fps`
+
+Frame rate of the active game. `{ fps, stale, status }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `fps` | integer or `null` | Frames per second. |
+| `stale` | boolean | No sample for 3 s. |
+| `status` | `ready` \| `waiting` \| `unsupported` \| `permission_denied` \| `ambiguous` \| `events_lost` \| `unavailable` | Measurement state. |
+
+### `Stopwatch`
+
+The manual stopwatch. `{ running, elapsedMs, at, shortcuts }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `running` | boolean | It is counting. |
+| `elapsedMs` | integer | Elapsed time at `at`. |
+| `at` | integer | Host monotonic clock in ms at which `elapsedMs` was measured. |
+| `shortcuts` | `{ toggle, reset, bound }` | Stopwatch shortcuts. |
+| `shortcuts.toggle` | text | Host-formatted key chord. |
+| `shortcuts.reset` | text | Host-formatted key chord. |
+| `shortcuts.bound` | boolean | The shortcuts are active. |
+
+### `Media`
+
+The current media player. `{ player, title, artists, playing, canPrevious, canPlayPause, canNext, cover }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `player` | text | Opaque ID of the current player. |
+| `title` | text or `null` | Track title. |
+| `artists` | list of text | Artists. |
+| `playing` | boolean | Playing. |
+| `canPrevious` | boolean | The player supports previous. |
+| `canPlayPause` | boolean | The player supports play/pause. |
+| `canNext` | boolean | The player supports next. |
+| `cover` | `asset:` handle or `null` | Cover art, at most 512 px. |
+
+### `NoteItem`
+
+One checklist item. `{ id, text, checked }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `id` | text or `null` | Item ID. |
+| `text` | text | Text. |
+| `checked` | boolean | Checked. |
+
+### `Note`
+
+One note. `{ id, title, body, items }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `id` | text or `null` | Note ID. |
+| `title` | text | Title. |
+| `body` | text | Body text. |
+| `items` | list of [`NoteItem`](#noteitem) | Checklist. |
+
+### `Notes`
+
+The user's notes document. `{ active, notes }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `active` | text or `null` | ID of the active note. |
+| `notes` | list of [`Note`](#note) | Notes. |
+
+### `CreatedNote`
+
+Answer of `notes.create`. `{ note }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `note` | [`Note`](#note) | The new note. |
+
+### `Score`
+
+PlayerVox score of the active game. `{ state, name, score, grade, ratingsCount, criteria }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `state` | `idle` \| `unsupported` \| `loading` \| `ready` \| `no_ratings` \| `not_found` \| `unavailable` | Score state: `idle` without an active game, `unsupported` for a game without a Steam app ID, `loading` until the game's first answer (never the previous game's score), `ready` and `no_ratings` with the score, `not_found` for a game PlayerVox cannot match, `unavailable` while the host retries. Every state but `ready` and `no_ratings` has a `null` name and score, grade `--`, no ratings and `null` criteria. |
+| `name` | text or `null` | Game name. |
+| `score` | number or `null` | 0–100. |
+| `grade` | `S+` \| `S` \| `A` \| `B` \| `C` \| `D` \| `F` \| `--` | Grade of the score. |
+| `ratingsCount` | integer | Number of ratings. |
+| `criteria` | `{ gameplay, art, tech }` | Criteria scores. |
+| `criteria.gameplay` | number or `null` | 0–100. |
+| `criteria.art` | number or `null` | 0–100. |
+| `criteria.tech` | number or `null` | 0–100. |
+
+### `Rating`
+
+The user's PlayerVox rating of the active game. `{ gameplay, art, tech, review, publishedAt, offsetMinutes }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `gameplay` | integer | 0–100. |
+| `art` | integer | 0–100. |
+| `tech` | integer | 0–100. |
+| `review` | text or `null` | Review text. |
+| `publishedAt` | integer or `null` | Unix milliseconds. |
+| `offsetMinutes` | integer or `null` | UTC offset in minutes to show the timestamp with. |
+
+### `RatingState`
+
+The user's own rating of the active game, with its state. `{ state, name, offline, rating }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `state` | `idle` \| `unsupported` \| `loading` \| `ready` \| `unavailable` | Rating state: `idle` without an active game, `unsupported` for a game without a Steam app ID, `loading` until the first answer for this game and account (never the previous game's rating), `ready` with the rating, `unavailable` while the host retries a failed read. Every state but `ready` has a `null` name and rating. |
+| `name` | text or `null` | Game name on PlayerVox. |
+| `offline` | boolean | PlayerVox is unreachable: the rating is the last one read, and `playervox.rating.publish` answers `not_connected`. |
+| `rating` | [`Rating`](#rating) or `null` | The user's rating; `null` before the first one. |
+
+### `Review`
+
+One player review. `{ id, author, grade, score, text, original, hidden, publishedAt, offsetMinutes }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `id` | text | Review ID. |
+| `author` | text | Author name. |
+| `grade` | `S+` \| `S` \| `A` \| `B` \| `C` \| `D` \| `F` \| `--` | Grade. |
+| `score` | integer | 0–100. |
+| `text` | text or `null` | Text, translated when a translation exists. |
+| `original` | text or `null` | Untranslated text when `text` is a translation; `null` otherwise. |
+| `hidden` | boolean | Hidden by the community: show the text only once the user asks for it. |
+| `publishedAt` | integer | Unix milliseconds. |
+| `offsetMinutes` | integer | UTC offset in minutes to show the timestamp with. |
+
+### `ReviewsState`
+
+The player reviews of the active game: what to read, not the reviews. `{ state, revision, offline }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `state` | `idle` \| `unsupported` \| `ready` | `idle` without an active game, `unsupported` for a game without a Steam app ID, `ready` when `playervox.reviews.page` reads the game's reviews. |
+| `revision` | integer | Changes whenever the reviews to read change: another game, another PlayerVox account, or reviews changed on PlayerVox. |
+| `offline` | boolean | PlayerVox is unreachable: `playervox.reviews.page` answers `not_connected`. |
+
+### `ReviewsPage`
+
+A page of player reviews. `{ gameName, items, page, totalPages, count }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `gameName` | text | Game name on PlayerVox. |
+| `items` | list of [`Review`](#review) | Reviews. |
+| `page` | integer | Page number. |
+| `totalPages` | integer | Number of pages. |
+| `count` | integer | Number of reviews. |
+
+### `JournalSession`
+
+One journal session. `{ id, startedAt, offsetMinutes, durationMs, source }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `id` | text | Session ID. |
+| `startedAt` | integer | Unix milliseconds. |
+| `offsetMinutes` | integer | UTC offset in minutes to show the timestamp with. |
+| `durationMs` | integer | Duration. |
+| `source` | `local` \| `cloud` | Where the session is stored. |
+
+### `JournalState`
+
+The journal of the active game. `{ revision, notice }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `revision` | integer | Changes whenever the merged journal of the active game changes. |
+| `notice` | `offline` \| `storage_unavailable` \| `full` \| `expired` \| `busy` \| `unavailable` or `null` | Journal condition to show above the sessions: `offline` sync is offline (local sessions remain), `storage_unavailable` the local journal cannot be read, `full` the local journal is full, `expired` the PlayerVox sign-in expired, `busy` PlayerVox asks to retry later, `unavailable` any other failure; `null` when none. |
+
+### `JournalPage`
+
+A page of the game journal. `{ gameName, items, page, next, previous }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `gameName` | text | Active game; empty when the host has no name. |
+| `items` | list of [`JournalSession`](#journalsession) | Sessions, newest first. |
+| `page` | integer | Page number, from 1. |
+| `next` | text or `null` | Cursor of the next page. |
+| `previous` | text or `null` | Cursor of the previous page. |
+
+### `ChatFragment`
+
+A text run or an emote of a chat message. `{ text }` or `{ emote, alt }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `text` | text | Text run. |
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `emote` | `asset:` handle | Emote image. |
+| `alt` | text | Emote name. |
+
+### `ChatMessage`
+
+One chat message. `{ id, author, color, badges, fragments, reply, deleted, receivedAt }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `id` | text | Message ID. |
+| `author` | text | Author name. |
+| `color` | text or `null` | Author colour `#rrggbb`. |
+| `badges` | list of `asset:` handle | Badge images. |
+| `fragments` | list of [`ChatFragment`](#chatfragment) | Content runs. |
+| `reply` | `{ author, text }` or `null` | The message replied to. |
+| `reply.author` | text | Author replied to. |
+| `reply.text` | text | Text replied to. |
+| `deleted` | boolean | Deleted by a moderator. |
+| `receivedAt` | integer | When the host received the message, in Unix milliseconds of the host's clock: compare it with `Date.now()` to age a message (the fade of Passive mode), also after a `reset`. |
+
+### `TwitchChat`
+
+Twitch chat state. `{ account, channel, joinState, failure, favorites, canSend, generation, reset, messages, removed, skipped }`
+
+| Member | Shape | Meaning |
+| --- | --- | --- |
+| `account` | `signed_out` \| `pending` \| `connected` \| `expired` | Twitch account state; sign-in is drawn by the host. |
+| `channel` | text or `null` | Joined channel login. |
+| `joinState` | `idle` \| `connecting` \| `joined` \| `reconnecting` \| `failed` | Channel connection state. |
+| `failure` | `channel_unavailable` \| `connection` \| `provider` \| `limit` or `null` | Why `joinState` is `failed`, as a fixed category: the channel does not exist or refuses the account, the connection failed, Twitch answered something unexpected, or another widget holds the host's one chat connection (`limit`). `null` in every other state. An account failure is not here: the host draws it. |
+| `favorites` | list of text | Favorite channels. |
+| `canSend` | boolean | A message can be sent now. |
+| `generation` | integer | Changes with the channel or account. |
+| `reset` | boolean | `messages` replaces the whole list. |
+| `messages` | list of [`ChatMessage`](#chatmessage) | Messages, oldest first: the whole list with `reset`; otherwise the new messages, to append, and the changed ones, which replace the message of the same `id` in place. |
+| `removed` | list of text | IDs of removed messages. |
+| `skipped` | integer | New messages the host left out since the previous update, because the chat is faster than it delivers; 0 with `reset`. A removal is never left out. |
+<!-- /generated:result-shapes -->