common.control-lease@1 and common.sync-clock@1: Party's remote and timeline (0.331.0) (#340)

OP OpenVibers committed 6 days ago · 6ec3d59a68 · 66 files, +650 −93

* common.control-lease@1 and common.sync-clock@1: the remote and the timeline (0.330.0)

* Merge origin/main into feat/b3-b4-control-lease-sync-clock (0.331.0 above the mail site)

* Merge main (0.331.0 is actor.trigger@1): this release is 0.332.0; the changelog says what Chat enforces

Changes

ddiff --git a/CHANGELOG.md b/CHANGELOG.md
iindex 33093deb..2d525bdf 100644
---- a/CHANGELOG.md
++++ b/CHANGELOG.md
@@@ -1,10 +1,17 @@
  # Changelog
  
++## 0.332.0 — 2026-11-07
++
++- Add `common.control-lease@1`, the shared control lease (seven domains plan B3): the thing a lease controls, its holder (a `person`, an `ai` or `nobody`, with the holder's subject or null), when the holder got the controls, an optional absolute `expires_ms`, the subjects watching and a `seq` that increments on every holder change, expiry or take-back. A watcher-only change does not increment `seq`. The authority that owns the thing enforces the rules; Chat hosts a room's lease, names the thing `chat.room:<slug>` and accepts a control change only from the current holder, while take-back by the room's owner always wins; only the owner hands the remote to an `ai`, and a person holder who leaves keeps it for a minute.
++- Add `common.sync-clock@1`, the shared timeline (B4): the room, the media (a Media ref or an https URL; Chat accepts only a host an OpenVibe service manifest names, so Party plays OpenVibe media), the position at `at_ms`, the rate, whether it is paused, who set it and a `seq`. A player computes `position_ms + (authority now - at_ms) * rate` while it plays and `position_ms` while it is paused. Chat stamps `at_ms` and `seq` and stores the latest state in `room_sync_clocks` (the memory copy is the room's live state).
++- Valid and invalid fixtures cover a person, AI and free lease, a lease with a time limit, seq zero, a nobody with a subject, a duplicate watcher, a URL and a Media-ref clock, a clock at a rate and paused, an http URL, a bad room and a bad media object.
++
  ## 0.331.0 — 2026-11-09
  
  - Add `actor.trigger@1`: a trigger made in an Actor conversation — its `trg_…` id, owner, agent, task, kind (`schedule` or `event`), the plain-language and machine schedule (a five-field cron in the person's timezone) or Watch event pattern and filter, the next run, the last run's result (`ok`, `failed`, `needs_you`), state, why it is paused, the consecutive failure count, the Watch subscription's own state and the ten-minute undo window. Owner-only: another person's trigger is the same 404 as one that does not exist.
  - `actor.task-event@2` gains an optional `trigger` and the `trigger` step: the card as it is created, edited, paused, resumed, undone or deleted in the conversation travels with the event, so a reader renders the live card without a second fetch. Additive: an event without one stays valid, and the task record is still the source of truth.
  - Additive only: a new contract and an optional field plus one new step value; nothing that exists today changes shape.
++
  ## 0.330.0 — 2026-11-07
  
  - Add the `mail` service manifest: `openvibe.email` as the site **Email** (icon `mail`, the shared glyph font's E054), tagline "An address for every sign-up", the receive-only wording, legal profile `service`, and position 7, directly after Chat. It declares exposure `live`/`service`, port 5250, database `ov_mail`, the Stalwart mail server, `/api/health` and `/api/ready`, its shutdown and due-based recovery, an expand-only rollback, and the purge lease.
ddiff --git a/contracts/catalog.json b/contracts/catalog.json
iindex aec8217a..a92984c5 100644
---- a/contracts/catalog.json
++++ b/contracts/catalog.json
@@@ -10021,6 +10021,24 @@
        "visibility": "first-party",
        "compatibility": "backward",
        "status": "active"
++    },
++    {
++      "id": "common.control-lease",
++      "version": "1.0.0",
++      "owner": "contracts",
++      "schema": "common/control-lease.v1.json",
++      "visibility": "public",
++      "compatibility": "backward",
++      "status": "active"
++    },
++    {
++      "id": "common.sync-clock",
++      "version": "1.0.0",
++      "owner": "contracts",
++      "schema": "common/sync-clock.v1.json",
++      "visibility": "public",
++      "compatibility": "backward",
++      "status": "active"
      }
    ]
  }
ddiff --git a/contracts/common/control-lease.v1.json b/contracts/common/control-lease.v1.json
nnew file mode 100644
iindex 00000000..2e4e5e61
---- /dev/null
++++ b/contracts/common/control-lease.v1.json
@@@ -0,0 +1,77 @@
++{
++  "$schema": "https://json-schema.org/draft/2020-12/schema",
++  "$id": "https://openvibe.network/contracts/common/control-lease.v1.json",
++  "title": "ControlLease",
++  "description": "common.control-lease@1: who holds the controls of a shared thing (seven domains plan B3). The state names the thing, its holder (a person, an AI, or nobody when the controls are free), when the holder got them, an optional time limit as an absolute epoch instant, the subjects watching and a sequence number. Every control change, including an expiry or a take-back, increments seq; a change in watchers alone does not. The authority that owns the thing writes and enforces the state: it decides who may request, grant, release or take the controls, and take-back always wins. Chat hosts a room's lease on its room socket and names the thing chat.room:<slug>; the holder is the person or AI whose subject Chat would accept on a set.",
++  "type": "object",
++  "additionalProperties": false,
++  "required": ["thing", "holder", "since_ms", "watchers", "seq"],
++  "properties": {
++    "thing": {
++      "type": "string",
++      "minLength": 1,
++      "maxLength": 200,
++      "description": "The shared thing the lease controls, in the owning authority's own namespace. Chat writes chat.room:<slug>."
++    },
++    "holder": {
++      "type": "object",
++      "additionalProperties": false,
++      "required": ["kind", "subject"],
++      "description": "Who may act on the thing now. nobody means the controls are free; subject is null exactly then.",
++      "properties": {
++        "kind": {
++          "enum": ["person", "ai", "nobody"],
++          "description": "A signed-in person, an AI agent the authority can name, or nobody."
++        },
++        "subject": {
++          "type": ["string", "null"],
++          "minLength": 1,
++          "maxLength": 200,
++          "description": "The authority's subject for the holder (a Network usr_… subject for a person, an agent subject for an AI); null when the kind is nobody."
++        }
++      },
++      "allOf": [
++        {
++          "if": {
++            "properties": { "kind": { "const": "nobody" } },
++            "required": ["kind"]
++          },
++          "then": {
++            "properties": { "subject": { "const": null } }
++          }
++        },
++        {
++          "if": {
++            "properties": { "kind": { "enum": ["person", "ai"] } },
++            "required": ["kind"]
++          },
++          "then": {
++            "properties": { "subject": { "type": "string", "minLength": 1 } }
++          }
++        }
++      ]
++    },
++    "since_ms": {
++      "type": "integer",
++      "minimum": 0,
++      "description": "When the current holder got the controls, as epoch milliseconds in the authority's clock."
++    },
++    "expires_ms": {
++      "type": ["integer", "null"],
++      "minimum": 0,
++      "description": "When the holder's time runs out, as epoch milliseconds; null or absent means no time limit. At that instant the authority makes the holder nobody and increments seq."
++    },
++    "watchers": {
++      "type": "array",
++      "maxItems": 500,
++      "uniqueItems": true,
++      "items": { "type": "string", "minLength": 1, "maxLength": 200 },
++      "description": "The subjects watching the thing now, as live presence rather than a durable membership list. The authority decides who is listed; Chat lists the signed-in subjects connected to the room. A change here does not increment seq."
++    },
++    "seq": {
++      "type": "integer",
++      "minimum": 1,
++      "description": "The control version: starts at 1 for a thing's first state and increments on every holder change, expiry or take-back. A client ignores a state with a seq it has already seen."
++    }
++  }
++}
ddiff --git a/contracts/common/sync-clock.v1.json b/contracts/common/sync-clock.v1.json
nnew file mode 100644
iindex 00000000..c3781452
---- /dev/null
++++ b/contracts/common/sync-clock.v1.json
@@@ -0,0 +1,57 @@
++{
++  "$schema": "https://json-schema.org/draft/2020-12/schema",
++  "$id": "https://openvibe.network/contracts/common/sync-clock.v1.json",
++  "title": "SyncClock",
++  "description": "common.sync-clock@1: one timeline for many players (seven domains plan B4). The authority stamps at_ms and seq when it accepts a change and fans the state out; a player computes where it should be as position_ms + (authority time now - at_ms) * rate when paused is false, and exactly position_ms when paused is true. Chat hosts a room's clock on its room socket, keeps the latest state in memory and in the room_sync_clocks table, refuses a set from anyone but the current common.control-lease@1 holder, and sends the state to a member when they join the room. Clock offset is measured over the same socket with time ping/pong pairs, best of five samples, refreshed every 60 s.",
++  "type": "object",
++  "additionalProperties": false,
++  "required": ["room", "media", "position_ms", "rate", "paused", "at_ms", "set_by", "seq"],
++  "properties": {
++    "room": {
++      "type": "string",
++      "minLength": 1,
++      "maxLength": 64,
++      "pattern": "^[a-z0-9][a-z0-9-]*$",
++      "description": "The authority's room id (Chat: the room's slug)."
++    },
++    "media": {
++      "description": "What is playing: an OpenVibe media ref or an https URL. A ref names a Media object; a URL is the media file itself.",
++      "oneOf": [
++        { "$ref": "../media/media-ref.v1.json" },
++        { "type": "string", "format": "uri", "pattern": "^https://", "maxLength": 2048 }
++      ]
++    },
++    "position_ms": {
++      "type": "integer",
++      "minimum": 0,
++      "maximum": 2592000000,
++      "description": "The media position at at_ms, in milliseconds. At most 30 days."
++    },
++    "rate": {
++      "type": "number",
++      "exclusiveMinimum": 0,
++      "maximum": 16,
++      "description": "The playback rate the room is playing at (1 is normal speed)."
++    },
++    "paused": {
++      "type": "boolean",
++      "description": "When true the timeline stands still at position_ms; when false it advances at rate."
++    },
++    "at_ms": {
++      "type": "integer",
++      "minimum": 0,
++      "description": "The authority's epoch milliseconds when it accepted this state. A player subtracts this from the authority's clock now, so the value is never the player's own clock."
++    },
++    "set_by": {
++      "type": "string",
++      "minLength": 1,
++      "maxLength": 200,
++      "description": "The subject that made the change (the lease holder's subject as the authority knows it)."
++    },
++    "seq": {
++      "type": "integer",
++      "minimum": 1,
++      "description": "The timeline version: starts at 1 and increments on every accepted change. A client ignores a state with a seq it has already seen."
++    }
++  }
++}
ddiff --git a/fixtures/common.control-lease/invalid/duplicate-watcher.json b/fixtures/common.control-lease/invalid/duplicate-watcher.json
nnew file mode 100644
iindex 00000000..86e7455e
---- /dev/null
++++ b/fixtures/common.control-lease/invalid/duplicate-watcher.json
@@@ -0,0 +1,7 @@
++{
++  "thing": "chat.room:friday-film",
++  "holder": { "kind": "person", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },
++  "since_ms": 1794067200000,
++  "watchers": ["usr_01JAB2C3D4E5F6G7H8J9K0MNPS", "usr_01JAB2C3D4E5F6G7H8J9K0MNPS"],
++  "seq": 1
++}
ddiff --git a/fixtures/common.control-lease/invalid/nobody-with-subject.json b/fixtures/common.control-lease/invalid/nobody-with-subject.json
nnew file mode 100644
iindex 00000000..0186bc2a
---- /dev/null
++++ b/fixtures/common.control-lease/invalid/nobody-with-subject.json
@@@ -0,0 +1,7 @@
++{
++  "thing": "chat.room:friday-film",
++  "holder": { "kind": "nobody", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },
++  "since_ms": 1794067200000,
++  "watchers": [],
++  "seq": 1
++}
ddiff --git a/fixtures/common.control-lease/invalid/person-without-subject.json b/fixtures/common.control-lease/invalid/person-without-subject.json
nnew file mode 100644
iindex 00000000..ec35a146
---- /dev/null
++++ b/fixtures/common.control-lease/invalid/person-without-subject.json
@@@ -0,0 +1,7 @@
++{
++  "thing": "chat.room:friday-film",
++  "holder": { "kind": "person" },
++  "since_ms": 1794067200000,
++  "watchers": [],
++  "seq": 1
++}
ddiff --git a/fixtures/common.control-lease/invalid/seq-zero.json b/fixtures/common.control-lease/invalid/seq-zero.json
nnew file mode 100644
iindex 00000000..f79d1347
---- /dev/null
++++ b/fixtures/common.control-lease/invalid/seq-zero.json
@@@ -0,0 +1,7 @@
++{
++  "thing": "chat.room:friday-film",
++  "holder": { "kind": "person", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },
++  "since_ms": 1794067200000,
++  "watchers": [],
++  "seq": 0
++}
ddiff --git a/fixtures/common.control-lease/valid/ai.json b/fixtures/common.control-lease/valid/ai.json
nnew file mode 100644
iindex 00000000..f2bded5f
---- /dev/null
++++ b/fixtures/common.control-lease/valid/ai.json
@@@ -0,0 +1,8 @@
++{
++  "thing": "desk:desk-7",
++  "holder": { "kind": "ai", "subject": "ai:vibe" },
++  "since_ms": 1794067200000,
++  "expires_ms": null,
++  "watchers": [],
++  "seq": 1
++}
ddiff --git a/fixtures/common.control-lease/valid/free.json b/fixtures/common.control-lease/valid/free.json
nnew file mode 100644
iindex 00000000..ea7b8c69
---- /dev/null
++++ b/fixtures/common.control-lease/valid/free.json
@@@ -0,0 +1,7 @@
++{
++  "thing": "chat.room:friday-film",
++  "holder": { "kind": "nobody", "subject": null },
++  "since_ms": 1794067200000,
++  "watchers": ["usr_01JAB2C3D4E5F6G7H8J9K0MNPS"],
++  "seq": 5
++}
ddiff --git a/fixtures/common.control-lease/valid/person-with-limit.json b/fixtures/common.control-lease/valid/person-with-limit.json
nnew file mode 100644
iindex 00000000..74bb5d38
---- /dev/null
++++ b/fixtures/common.control-lease/valid/person-with-limit.json
@@@ -0,0 +1,11 @@
++{
++  "thing": "chat.room:friday-film",
++  "holder": { "kind": "person", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },
++  "since_ms": 1794067200000,
++  "expires_ms": 1794070800000,
++  "watchers": [
++    "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++    "usr_01JAB2C3D4E5F6G7H8J9K0MNPX"
++  ],
++  "seq": 4
++}
ddiff --git a/fixtures/common.sync-clock/invalid/bad-media.json b/fixtures/common.sync-clock/invalid/bad-media.json
nnew file mode 100644
iindex 00000000..7fc24523
---- /dev/null
++++ b/fixtures/common.sync-clock/invalid/bad-media.json
@@@ -0,0 +1,10 @@
++{
++  "room": "friday-film",
++  "media": { "url": "https://media.openvibe.network/vod/friday-film.webm" },
++  "position_ms": 0,
++  "rate": 1,
++  "paused": false,
++  "at_ms": 1794067200123,
++  "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++  "seq": 1
++}
ddiff --git a/fixtures/common.sync-clock/invalid/bad-position-and-rate.json b/fixtures/common.sync-clock/invalid/bad-position-and-rate.json
nnew file mode 100644
iindex 00000000..0976e824
---- /dev/null
++++ b/fixtures/common.sync-clock/invalid/bad-position-and-rate.json
@@@ -0,0 +1,10 @@
++{
++  "room": "friday-film",
++  "media": "https://media.openvibe.network/vod/friday-film.webm",
++  "position_ms": -1,
++  "rate": 0,
++  "paused": false,
++  "at_ms": 1794067200123,
++  "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++  "seq": 1
++}
ddiff --git a/fixtures/common.sync-clock/invalid/bad-room.json b/fixtures/common.sync-clock/invalid/bad-room.json
nnew file mode 100644
iindex 00000000..044fc201
---- /dev/null
++++ b/fixtures/common.sync-clock/invalid/bad-room.json
@@@ -0,0 +1,10 @@
++{
++  "room": "Friday Film",
++  "media": "https://media.openvibe.network/vod/friday-film.webm",
++  "position_ms": 0,
++  "rate": 1,
++  "paused": false,
++  "at_ms": 1794067200123,
++  "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++  "seq": 1
++}
ddiff --git a/fixtures/common.sync-clock/invalid/http-media.json b/fixtures/common.sync-clock/invalid/http-media.json
nnew file mode 100644
iindex 00000000..463b3806
---- /dev/null
++++ b/fixtures/common.sync-clock/invalid/http-media.json
@@@ -0,0 +1,10 @@
++{
++  "room": "friday-film",
++  "media": "http://media.openvibe.network/vod/friday-film.webm",
++  "position_ms": 0,
++  "rate": 1,
++  "paused": false,
++  "at_ms": 1794067200123,
++  "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++  "seq": 1
++}
ddiff --git a/fixtures/common.sync-clock/valid/ref-paused.json b/fixtures/common.sync-clock/valid/ref-paused.json
nnew file mode 100644
iindex 00000000..775f3bed
---- /dev/null
++++ b/fixtures/common.sync-clock/valid/ref-paused.json
@@@ -0,0 +1,13 @@
++{
++  "room": "friday-film",
++  "media": {
++    "media_id": "legacy:media:vod:4242",
++    "role": "main"
++  },
++  "position_ms": 12000,
++  "rate": 1.25,
++  "paused": true,
++  "at_ms": 1794067200123,
++  "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++  "seq": 8
++}
ddiff --git a/fixtures/common.sync-clock/valid/url-playing.json b/fixtures/common.sync-clock/valid/url-playing.json
nnew file mode 100644
iindex 00000000..8e44a29f
---- /dev/null
++++ b/fixtures/common.sync-clock/valid/url-playing.json
@@@ -0,0 +1,10 @@
++{
++  "room": "friday-film",
++  "media": "https://media.openvibe.network/vod/friday-film.webm",
++  "position_ms": 61234,
++  "rate": 1,
++  "paused": false,
++  "at_ms": 1794067200123,
++  "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
++  "seq": 7
++}
ddiff --git a/generated/json-schema/bundle.json b/generated/json-schema/bundle.json
iindex ca6b8a5c..dbf152a9 100644
---- a/generated/json-schema/bundle.json
++++ b/generated/json-schema/bundle.json
@@@ -109833,6 +109833,213 @@
            }
          }
        }
++    },
++    "common.control-lease": {
++      "version": "1.0.0",
++      "owner": "contracts",
++      "status": "active",
++      "schema": {
++        "$schema": "https://json-schema.org/draft/2020-12/schema",
++        "$id": "https://openvibe.network/contracts/common/control-lease.v1.json",
++        "title": "ControlLease",
++        "description": "common.control-lease@1: who holds the controls of a shared thing (seven domains plan B3). The state names the thing, its holder (a person, an AI, or nobody when the controls are free), when the holder got them, an optional time limit as an absolute epoch instant, the subjects watching and a sequence number. Every control change, including an expiry or a take-back, increments seq; a change in watchers alone does not. The authority that owns the thing writes and enforces the state: it decides who may request, grant, release or take the controls, and take-back always wins. Chat hosts a room's lease on its room socket and names the thing chat.room:<slug>; the holder is the person or AI whose subject Chat would accept on a set.",
++        "type": "object",
++        "additionalProperties": false,
++        "required": [
++          "thing",
++          "holder",
++          "since_ms",
++          "watchers",
++          "seq"
++        ],
++        "properties": {
++          "thing": {
++            "type": "string",
++            "minLength": 1,
++            "maxLength": 200,
++            "description": "The shared thing the lease controls, in the owning authority's own namespace. Chat writes chat.room:<slug>."
++          },
++          "holder": {
++            "type": "object",
++            "additionalProperties": false,
++            "required": [
++              "kind",
++              "subject"
++            ],
++            "description": "Who may act on the thing now. nobody means the controls are free; subject is null exactly then.",
++            "properties": {
++              "kind": {
++                "enum": [
++                  "person",
++                  "ai",
++                  "nobody"
++                ],
++                "description": "A signed-in person, an AI agent the authority can name, or nobody."
++              },
++              "subject": {
++                "type": [
++                  "string",
++                  "null"
++                ],
++                "minLength": 1,
++                "maxLength": 200,
++                "description": "The authority's subject for the holder (a Network usr_… subject for a person, an agent subject for an AI); null when the kind is nobody."
++              }
++            },
++            "allOf": [
++              {
++                "if": {
++                  "properties": {
++                    "kind": {
++                      "const": "nobody"
++                    }
++                  },
++                  "required": [
++                    "kind"
++                  ]
++                },
++                "then": {
++                  "properties": {
++                    "subject": {
++                      "const": null
++                    }
++                  }
++                }
++              },
++              {
++                "if": {
++                  "properties": {
++                    "kind": {
++                      "enum": [
++                        "person",
++                        "ai"
++                      ]
++                    }
++                  },
++                  "required": [
++                    "kind"
++                  ]
++                },
++                "then": {
++                  "properties": {
++                    "subject": {
++                      "type": "string",
++                      "minLength": 1
++                    }
++                  }
++                }
++              }
++            ]
++          },
++          "since_ms": {
++            "type": "integer",
++            "minimum": 0,
++            "description": "When the current holder got the controls, as epoch milliseconds in the authority's clock."
++          },
++          "expires_ms": {
++            "type": [
++              "integer",
++              "null"
++            ],
++            "minimum": 0,
++            "description": "When the holder's time runs out, as epoch milliseconds; null or absent means no time limit. At that instant the authority makes the holder nobody and increments seq."
++          },
++          "watchers": {
++            "type": "array",
++            "maxItems": 500,
++            "uniqueItems": true,
++            "items": {
++              "type": "string",
++              "minLength": 1,
++              "maxLength": 200
++            },
++            "description": "The subjects watching the thing now, as live presence rather than a durable membership list. The authority decides who is listed; Chat lists the signed-in subjects connected to the room. A change here does not increment seq."
++          },
++          "seq": {
++            "type": "integer",
++            "minimum": 1,
++            "description": "The control version: starts at 1 for a thing's first state and increments on every holder change, expiry or take-back. A client ignores a state with a seq it has already seen."
++          }
++        }
++      }
++    },
++    "common.sync-clock": {
++      "version": "1.0.0",
++      "owner": "contracts",
++      "status": "active",
++      "schema": {
++        "$schema": "https://json-schema.org/draft/2020-12/schema",
++        "$id": "https://openvibe.network/contracts/common/sync-clock.v1.json",
++        "title": "SyncClock",
++        "description": "common.sync-clock@1: one timeline for many players (seven domains plan B4). The authority stamps at_ms and seq when it accepts a change and fans the state out; a player computes where it should be as position_ms + (authority time now - at_ms) * rate when paused is false, and exactly position_ms when paused is true. Chat hosts a room's clock on its room socket, keeps the latest state in memory and in the room_sync_clocks table, refuses a set from anyone but the current common.control-lease@1 holder, and sends the state to a member when they join the room. Clock offset is measured over the same socket with time ping/pong pairs, best of five samples, refreshed every 60 s.",
++        "type": "object",
++        "additionalProperties": false,
++        "required": [
++          "room",
++          "media",
++          "position_ms",
++          "rate",
++          "paused",
++          "at_ms",
++          "set_by",
++          "seq"
++        ],
++        "properties": {
++          "room": {
++            "type": "string",
++            "minLength": 1,
++            "maxLength": 64,
++            "pattern": "^[a-z0-9][a-z0-9-]*$",
++            "description": "The authority's room id (Chat: the room's slug)."
++          },
++          "media": {
++            "description": "What is playing: an OpenVibe media ref or an https URL. A ref names a Media object; a URL is the media file itself.",
++            "oneOf": [
++              {
++                "$ref": "../media/media-ref.v1.json"
++              },
++              {
++                "type": "string",
++                "format": "uri",
++                "pattern": "^https://",
++                "maxLength": 2048
++              }
++            ]
++          },
++          "position_ms": {
++            "type": "integer",
++            "minimum": 0,
++            "maximum": 2592000000,
++            "description": "The media position at at_ms, in milliseconds. At most 30 days."
++          },
++          "rate": {
++            "type": "number",
++            "exclusiveMinimum": 0,
++            "maximum": 16,
++            "description": "The playback rate the room is playing at (1 is normal speed)."
++          },
++          "paused": {
++            "type": "boolean",
++            "description": "When true the timeline stands still at position_ms; when false it advances at rate."
++          },
++          "at_ms": {
++            "type": "integer",
++            "minimum": 0,
++            "description": "The authority's epoch milliseconds when it accepted this state. A player subtracts this from the authority's clock now, so the value is never the player's own clock."
++          },
++          "set_by": {
++            "type": "string",
++            "minLength": 1,
++            "maxLength": 200,
++            "description": "The subject that made the change (the lease holder's subject as the authority knows it)."
++          },
++          "seq": {
++            "type": "integer",
++            "minimum": 1,
++            "description": "The timeline version: starts at 1 and increments on every accepted change. A client ignores a state with a seq it has already seen."
++          }
++        }
++      }
      }
    }
  }
ddiff --git a/generated/openapi/actor.json b/generated/openapi/actor.json
iindex 7bf14530..eb1b01de 100644
---- a/generated/openapi/actor.json
++++ b/generated/openapi/actor.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Actor API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/ai.json b/generated/openapi/ai.json
iindex 9b1836fe..22d95358 100644
---- a/generated/openapi/ai.json
++++ b/generated/openapi/ai.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.AI API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/bench.json b/generated/openapi/bench.json
iindex ca34bdef..46a0fa20 100644
---- a/generated/openapi/bench.json
++++ b/generated/openapi/bench.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Bench API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/billing.json b/generated/openapi/billing.json
iindex 79964398..6f8cd80a 100644
---- a/generated/openapi/billing.json
++++ b/generated/openapi/billing.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Billing API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/blog.json b/generated/openapi/blog.json
iindex b2335b67..5b42bd10 100644
---- a/generated/openapi/blog.json
++++ b/generated/openapi/blog.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Blog API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/bot.json b/generated/openapi/bot.json
iindex 11476e2c..1d8853a6 100644
---- a/generated/openapi/bot.json
++++ b/generated/openapi/bot.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Bot API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/chat.json b/generated/openapi/chat.json
iindex 76ffe8ca..cbe5f0c1 100644
---- a/generated/openapi/chat.json
++++ b/generated/openapi/chat.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Chat API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/codes.json b/generated/openapi/codes.json
iindex 97b47d88..a8ae03d6 100644
---- a/generated/openapi/codes.json
++++ b/generated/openapi/codes.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Codes API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/community.json b/generated/openapi/community.json
iindex 468bbfb8..78c3c364 100644
---- a/generated/openapi/community.json
++++ b/generated/openapi/community.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Community API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/connect.json b/generated/openapi/connect.json
iindex 9ccc068d..4a9255b9 100644
---- a/generated/openapi/connect.json
++++ b/generated/openapi/connect.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe Connect API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/coupons.json b/generated/openapi/coupons.json
iindex 845dc7a8..19aaf461 100644
---- a/generated/openapi/coupons.json
++++ b/generated/openapi/coupons.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Coupons API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/deals.json b/generated/openapi/deals.json
iindex fdccbe22..2f86d2ca 100644
---- a/generated/openapi/deals.json
++++ b/generated/openapi/deals.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Deals API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/design.json b/generated/openapi/design.json
iindex a8d96b3e..dd8a5889 100644
---- a/generated/openapi/design.json
++++ b/generated/openapi/design.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Design API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/domains.json b/generated/openapi/domains.json
iindex d74169a5..e97fc4d2 100644
---- a/generated/openapi/domains.json
++++ b/generated/openapi/domains.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Domains API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/events.json b/generated/openapi/events.json
iindex 69a16567..da4546ba 100644
---- a/generated/openapi/events.json
++++ b/generated/openapi/events.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Events API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/food.json b/generated/openapi/food.json
iindex 5d3a1909..d4b8784c 100644
---- a/generated/openapi/food.json
++++ b/generated/openapi/food.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Food API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/games.json b/generated/openapi/games.json
iindex acb42feb..cae23588 100644
---- a/generated/openapi/games.json
++++ b/generated/openapi/games.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Games API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/host.json b/generated/openapi/host.json
iindex 8d67f6d1..e9c3af8c 100644
---- a/generated/openapi/host.json
++++ b/generated/openapi/host.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Host API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/inventory.json b/generated/openapi/inventory.json
iindex dcd07364..e653a922 100644
---- a/generated/openapi/inventory.json
++++ b/generated/openapi/inventory.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Inventory API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/live.json b/generated/openapi/live.json
iindex 7ce4b7fd..890e9159 100644
---- a/generated/openapi/live.json
++++ b/generated/openapi/live.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Live API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/mail.json b/generated/openapi/mail.json
iindex 2f3708f4..f0f5b0e1 100644
---- a/generated/openapi/mail.json
++++ b/generated/openapi/mail.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Mail API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/media-hub.json b/generated/openapi/media-hub.json
iindex 5059730f..9208cd28 100644
---- a/generated/openapi/media-hub.json
++++ b/generated/openapi/media-hub.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.MediaHub API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/media.json b/generated/openapi/media.json
iindex 38a5a09f..7472113f 100644
---- a/generated/openapi/media.json
++++ b/generated/openapi/media.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Media API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/network.json b/generated/openapi/network.json
iindex b8af63f5..cf82946b 100644
---- a/generated/openapi/network.json
++++ b/generated/openapi/network.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Network API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/news.json b/generated/openapi/news.json
iindex d11e4cd8..a650308e 100644
---- a/generated/openapi/news.json
++++ b/generated/openapi/news.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.News API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/openre.json b/generated/openapi/openre.json
iindex 2d3ee17e..f5cd792a 100644
---- a/generated/openapi/openre.json
++++ b/generated/openapi/openre.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenRestream API",
--  "version": "0.331.0",
--  "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/play.json b/generated/openapi/play.json
iindex dc51d321..5dca8df0 100644
---- a/generated/openapi/play.json
++++ b/generated/openapi/play.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Play API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/quest.json b/generated/openapi/quest.json
iindex a8f58e65..9eb36fd3 100644
---- a/generated/openapi/quest.json
++++ b/generated/openapi/quest.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Quest API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/report.json b/generated/openapi/report.json
iindex 7a4a1146..5e09da29 100644
---- a/generated/openapi/report.json
++++ b/generated/openapi/report.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Report API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/reviews.json b/generated/openapi/reviews.json
iindex 5e238e30..9d8ccdd7 100644
---- a/generated/openapi/reviews.json
++++ b/generated/openapi/reviews.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Reviews API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/run.json b/generated/openapi/run.json
iindex fb2af44d..5c5a0e8b 100644
---- a/generated/openapi/run.json
++++ b/generated/openapi/run.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Run API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/search.json b/generated/openapi/search.json
iindex bfa87fa3..71b161eb 100644
---- a/generated/openapi/search.json
++++ b/generated/openapi/search.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Search API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/services.json b/generated/openapi/services.json
iindex 991611e9..589ccb38 100644
---- a/generated/openapi/services.json
++++ b/generated/openapi/services.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Services API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/sources.json b/generated/openapi/sources.json
iindex 4734dd8c..53db7a7c 100644
---- a/generated/openapi/sources.json
++++ b/generated/openapi/sources.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Sources API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/space.json b/generated/openapi/space.json
iindex 0bb4928f..2f099037 100644
---- a/generated/openapi/space.json
++++ b/generated/openapi/space.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Space API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/tips.json b/generated/openapi/tips.json
iindex 1ee28408..e1dd0dc4 100644
---- a/generated/openapi/tips.json
++++ b/generated/openapi/tips.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Tips API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/today.json b/generated/openapi/today.json
iindex a8d72200..8a041704 100644
---- a/generated/openapi/today.json
++++ b/generated/openapi/today.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Today API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/tools.json b/generated/openapi/tools.json
iindex 630f6028..20fb1235 100644
---- a/generated/openapi/tools.json
++++ b/generated/openapi/tools.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Tools API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/trade.json b/generated/openapi/trade.json
iindex 66a6ab6a..a4164cde 100644
---- a/generated/openapi/trade.json
++++ b/generated/openapi/trade.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Trade API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/vip.json b/generated/openapi/vip.json
iindex 7e64de3b..da3dcfd5 100644
---- a/generated/openapi/vip.json
++++ b/generated/openapi/vip.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.VIP API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/vision.json b/generated/openapi/vision.json
iindex a0a631e6..589ed4fd 100644
---- a/generated/openapi/vision.json
++++ b/generated/openapi/vision.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Vision API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/watch.json b/generated/openapi/watch.json
iindex 97655130..2c5b52ec 100644
---- a/generated/openapi/watch.json
++++ b/generated/openapi/watch.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Watch API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/wiki.json b/generated/openapi/wiki.json
iindex c2903ab6..634f94af 100644
---- a/generated/openapi/wiki.json
++++ b/generated/openapi/wiki.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Wiki API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/work.json b/generated/openapi/work.json
iindex 3feab921..f9cccb4d 100644
---- a/generated/openapi/work.json
++++ b/generated/openapi/work.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Work API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/openapi/zone.json b/generated/openapi/zone.json
iindex 3951dad5..63e61ff7 100644
---- a/generated/openapi/zone.json
++++ b/generated/openapi/zone.json
@@@ -3,8 +3,8 @@
   "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
   "info": {
    "title": "OpenVibe.Zone API",
--  "version": "0.331.0",
--  "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
++  "version": "0.332.0",
++  "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",
    "license": {
     "name": "MIT",
     "identifier": "MIT"
ddiff --git a/generated/typescript/index.d.ts b/generated/typescript/index.d.ts
iindex 7b3606de..1c78545b 100644
---- a/generated/typescript/index.d.ts
++++ b/generated/typescript/index.d.ts
@@@ -302073,3 +302073,77 @@ export interface MailMessageSummary {
     */
    received_at: string | null;
  }
++
++/** [email protected] (owner: contracts) */
++/**
++ * common.control-lease@1: who holds the controls of a shared thing (seven domains plan B3). The state names the thing, its holder (a person, an AI, or nobody when the controls are free), when the holder got them, an optional time limit as an absolute epoch instant, the subjects watching and a sequence number. Every control change, including an expiry or a take-back, increments seq; a change in watchers alone does not. The authority that owns the thing writes and enforces the state: it decides who may request, grant, release or take the controls, and take-back always wins. Chat hosts a room's lease on its room socket and names the thing chat.room:<slug>; the holder is the person or AI whose subject Chat would accept on a set.
++ */
++export interface ControlLease {
++  /**
++   * The shared thing the lease controls, in the owning authority's own namespace. Chat writes chat.room:<slug>.
++   */
++  thing: string;
++  /**
++   * Who may act on the thing now. nobody means the controls are free; subject is null exactly then.
++   */
++  holder: {
++    [k: string]: unknown | undefined;
++  };
++  /**
++   * When the current holder got the controls, as epoch milliseconds in the authority's clock.
++   */
++  since_ms: number;
++  /**
++   * When the holder's time runs out, as epoch milliseconds; null or absent means no time limit. At that instant the authority makes the holder nobody and increments seq.
++   */
++  expires_ms?: number | null;
++  /**
++   * The subjects watching the thing now, as live presence rather than a durable membership list. The authority decides who is listed; Chat lists the signed-in subjects connected to the room. A change here does not increment seq.
++   *
++   * @maxItems 500
++   */
++  watchers: string[];
++  /**
++   * The control version: starts at 1 for a thing's first state and increments on every holder change, expiry or take-back. A client ignores a state with a seq it has already seen.
++   */
++  seq: number;
++}
++
++/** [email protected] (owner: contracts) */
++/**
++ * common.sync-clock@1: one timeline for many players (seven domains plan B4). The authority stamps at_ms and seq when it accepts a change and fans the state out; a player computes where it should be as position_ms + (authority time now - at_ms) * rate when paused is false, and exactly position_ms when paused is true. Chat hosts a room's clock on its room socket, keeps the latest state in memory and in the room_sync_clocks table, refuses a set from anyone but the current common.control-lease@1 holder, and sends the state to a member when they join the room. Clock offset is measured over the same socket with time ping/pong pairs, best of five samples, refreshed every 60 s.
++ */
++export interface SyncClock {
++  /**
++   * The authority's room id (Chat: the room's slug).
++   */
++  room: string;
++  /**
++   * What is playing: an OpenVibe media ref or an https URL. A ref names a Media object; a URL is the media file itself.
++   */
++  media: MediaRef | string;
++  /**
++   * The media position at at_ms, in milliseconds. At most 30 days.
++   */
++  position_ms: number;
++  /**
++   * The playback rate the room is playing at (1 is normal speed).
++   */
++  rate: number;
++  /**
++   * When true the timeline stands still at position_ms; when false it advances at rate.
++   */
++  paused: boolean;
++  /**
++   * The authority's epoch milliseconds when it accepted this state. A player subtracts this from the authority's clock now, so the value is never the player's own clock.
++   */
++  at_ms: number;
++  /**
++   * The subject that made the change (the lease holder's subject as the authority knows it).
++   */
++  set_by: string;
++  /**
++   * The timeline version: starts at 1 and increments on every accepted change. A client ignores a state with a seq it has already seen.
++   */
++  seq: number;
++}
ddiff --git a/package-lock.json b/package-lock.json
iindex 5674ecbd..fa3780ad 100644
---- a/package-lock.json
++++ b/package-lock.json
@@@ -1,12 +1,12 @@
  {
    "name": "openvibe-contracts",
--  "version": "0.331.0",
++  "version": "0.332.0",
    "lockfileVersion": 3,
    "requires": true,
    "packages": {
      "": {
        "name": "openvibe-contracts",
--      "version": "0.331.0",
++      "version": "0.332.0",
        "license": "AGPL-3.0-only",
        "dependencies": {
          "ajv": "^8.17.1",
ddiff --git a/package.json b/package.json
iindex e419e10b..ce29f962 100644
---- a/package.json
++++ b/package.json
@@@ -1,6 +1,6 @@
  {
    "name": "openvibe-contracts",
--  "version": "0.331.0",
++  "version": "0.332.0",
    "description": "Machine-readable contracts for the OpenVibe network: schemas, manifests, ids, error envelope, capability checks.",
    "main": "index.js",
    "types": "generated/typescript/index.d.ts",

diff --git a/CHANGELOG.md b/CHANGELOG.md

index 33093deb..2d525bdf 100644

--- a/CHANGELOG.md

+++ b/CHANGELOG.md

@@ -1,10 +1,17 @@

# Changelog

+## 0.332.0 — 2026-11-07

+- Add `common.control-lease@1`, the shared control lease (seven domains plan B3): the thing a lease controls, its holder (a `person`, an `ai` or `nobody`, with the holder's subject or null), when the holder got the controls, an optional absolute `expires_ms`, the subjects watching and a `seq` that increments on every holder change, expiry or take-back. A watcher-only change does not increment `seq`. The authority that owns the thing enforces the rules; Chat hosts a room's lease, names the thing `chat.room:<slug>` and accepts a control change only from the current holder, while take-back by the room's owner always wins; only the owner hands the remote to an `ai`, and a person holder who leaves keeps it for a minute.

+- Add `common.sync-clock@1`, the shared timeline (B4): the room, the media (a Media ref or an https URL; Chat accepts only a host an OpenVibe service manifest names, so Party plays OpenVibe media), the position at `at_ms`, the rate, whether it is paused, who set it and a `seq`. A player computes `position_ms + (authority now - at_ms) * rate` while it plays and `position_ms` while it is paused. Chat stamps `at_ms` and `seq` and stores the latest state in `room_sync_clocks` (the memory copy is the room's live state).

+- Valid and invalid fixtures cover a person, AI and free lease, a lease with a time limit, seq zero, a nobody with a subject, a duplicate watcher, a URL and a Media-ref clock, a clock at a rate and paused, an http URL, a bad room and a bad media object.

## 0.331.0 — 2026-11-09

- Add `actor.trigger@1`: a trigger made in an Actor conversation — its `trg_…` id, owner, agent, task, kind (`schedule` or `event`), the plain-language and machine schedule (a five-field cron in the person's timezone) or Watch event pattern and filter, the next run, the last run's result (`ok`, `failed`, `needs_you`), state, why it is paused, the consecutive failure count, the Watch subscription's own state and the ten-minute undo window. Owner-only: another person's trigger is the same 404 as one that does not exist.

- `actor.task-event@2` gains an optional `trigger` and the `trigger` step: the card as it is created, edited, paused, resumed, undone or deleted in the conversation travels with the event, so a reader renders the live card without a second fetch. Additive: an event without one stays valid, and the task record is still the source of truth.

- Additive only: a new contract and an optional field plus one new step value; nothing that exists today changes shape.

## 0.330.0 — 2026-11-07

- Add the `mail` service manifest: `openvibe.email` as the site **Email** (icon `mail`, the shared glyph font's E054), tagline "An address for every sign-up", the receive-only wording, legal profile `service`, and position 7, directly after Chat. It declares exposure `live`/`service`, port 5250, database `ov_mail`, the Stalwart mail server, `/api/health` and `/api/ready`, its shutdown and due-based recovery, an expand-only rollback, and the purge lease.

diff --git a/contracts/catalog.json b/contracts/catalog.json

index aec8217a..a92984c5 100644

--- a/contracts/catalog.json

+++ b/contracts/catalog.json

@@ -10021,6 +10021,24 @@

"visibility": "first-party",

"compatibility": "backward",

"status": "active"

+ },

+ {

+ "id": "common.control-lease",

+ "version": "1.0.0",

+ "owner": "contracts",

+ "schema": "common/control-lease.v1.json",

+ "visibility": "public",

+ "compatibility": "backward",

+ "status": "active"

+ },

+ {

+ "id": "common.sync-clock",

+ "version": "1.0.0",

+ "owner": "contracts",

+ "schema": "common/sync-clock.v1.json",

+ "visibility": "public",

+ "compatibility": "backward",

+ "status": "active"

}

]

}

diff --git a/contracts/common/control-lease.v1.json b/contracts/common/control-lease.v1.json

new file mode 100644

index 00000000..2e4e5e61

--- /dev/null

+++ b/contracts/common/control-lease.v1.json

@@ -0,0 +1,77 @@

+ "$schema": "https://json-schema.org/draft/2020-12/schema",

+ "$id": "https://openvibe.network/contracts/common/control-lease.v1.json",

+ "title": "ControlLease",

+ "description": "common.control-lease@1: who holds the controls of a shared thing (seven domains plan B3). The state names the thing, its holder (a person, an AI, or nobody when the controls are free), when the holder got them, an optional time limit as an absolute epoch instant, the subjects watching and a sequence number. Every control change, including an expiry or a take-back, increments seq; a change in watchers alone does not. The authority that owns the thing writes and enforces the state: it decides who may request, grant, release or take the controls, and take-back always wins. Chat hosts a room's lease on its room socket and names the thing chat.room:<slug>; the holder is the person or AI whose subject Chat would accept on a set.",

+ "type": "object",

+ "additionalProperties": false,

+ "required": ["thing", "holder", "since_ms", "watchers", "seq"],

+ "properties": {

+ "thing": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 200,

+ "description": "The shared thing the lease controls, in the owning authority's own namespace. Chat writes chat.room:<slug>."

+ },

+ "holder": {

+ "type": "object",

+ "additionalProperties": false,

+ "required": ["kind", "subject"],

+ "description": "Who may act on the thing now. nobody means the controls are free; subject is null exactly then.",

+ "properties": {

+ "kind": {

+ "enum": ["person", "ai", "nobody"],

+ "description": "A signed-in person, an AI agent the authority can name, or nobody."

+ },

+ "subject": {

+ "type": ["string", "null"],

+ "minLength": 1,

+ "maxLength": 200,

+ "description": "The authority's subject for the holder (a Network usr_… subject for a person, an agent subject for an AI); null when the kind is nobody."

+ }

+ },

+ "allOf": [

+ {

+ "if": {

+ "properties": { "kind": { "const": "nobody" } },

+ "required": ["kind"]

+ },

+ "then": {

+ "properties": { "subject": { "const": null } }

+ }

+ },

+ {

+ "if": {

+ "properties": { "kind": { "enum": ["person", "ai"] } },

+ "required": ["kind"]

+ },

+ "then": {

+ "properties": { "subject": { "type": "string", "minLength": 1 } }

+ }

+ ]

+ },

+ "since_ms": {

+ "type": "integer",

+ "minimum": 0,

+ "description": "When the current holder got the controls, as epoch milliseconds in the authority's clock."

+ },

+ "expires_ms": {

+ "type": ["integer", "null"],

+ "minimum": 0,

+ "description": "When the holder's time runs out, as epoch milliseconds; null or absent means no time limit. At that instant the authority makes the holder nobody and increments seq."

+ },

+ "watchers": {

+ "type": "array",

+ "maxItems": 500,

+ "uniqueItems": true,

+ "items": { "type": "string", "minLength": 1, "maxLength": 200 },

+ "description": "The subjects watching the thing now, as live presence rather than a durable membership list. The authority decides who is listed; Chat lists the signed-in subjects connected to the room. A change here does not increment seq."

+ },

+ "seq": {

+ "type": "integer",

+ "minimum": 1,

+ "description": "The control version: starts at 1 for a thing's first state and increments on every holder change, expiry or take-back. A client ignores a state with a seq it has already seen."

+ }

diff --git a/contracts/common/sync-clock.v1.json b/contracts/common/sync-clock.v1.json

new file mode 100644

index 00000000..c3781452

--- /dev/null

+++ b/contracts/common/sync-clock.v1.json

@@ -0,0 +1,57 @@

+ "$schema": "https://json-schema.org/draft/2020-12/schema",

+ "$id": "https://openvibe.network/contracts/common/sync-clock.v1.json",

+ "title": "SyncClock",

+ "description": "common.sync-clock@1: one timeline for many players (seven domains plan B4). The authority stamps at_ms and seq when it accepts a change and fans the state out; a player computes where it should be as position_ms + (authority time now - at_ms) * rate when paused is false, and exactly position_ms when paused is true. Chat hosts a room's clock on its room socket, keeps the latest state in memory and in the room_sync_clocks table, refuses a set from anyone but the current common.control-lease@1 holder, and sends the state to a member when they join the room. Clock offset is measured over the same socket with time ping/pong pairs, best of five samples, refreshed every 60 s.",

+ "type": "object",

+ "additionalProperties": false,

+ "required": ["room", "media", "position_ms", "rate", "paused", "at_ms", "set_by", "seq"],

+ "properties": {

+ "room": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 64,

+ "pattern": "^[a-z0-9][a-z0-9-]*$",

+ "description": "The authority's room id (Chat: the room's slug)."

+ },

+ "media": {

+ "description": "What is playing: an OpenVibe media ref or an https URL. A ref names a Media object; a URL is the media file itself.",

+ "oneOf": [

+ { "$ref": "../media/media-ref.v1.json" },

+ { "type": "string", "format": "uri", "pattern": "^https://", "maxLength": 2048 }

+ ]

+ },

+ "position_ms": {

+ "type": "integer",

+ "minimum": 0,

+ "maximum": 2592000000,

+ "description": "The media position at at_ms, in milliseconds. At most 30 days."

+ },

+ "rate": {

+ "type": "number",

+ "exclusiveMinimum": 0,

+ "maximum": 16,

+ "description": "The playback rate the room is playing at (1 is normal speed)."

+ },

+ "paused": {

+ "type": "boolean",

+ "description": "When true the timeline stands still at position_ms; when false it advances at rate."

+ },

+ "at_ms": {

+ "type": "integer",

+ "minimum": 0,

+ "description": "The authority's epoch milliseconds when it accepted this state. A player subtracts this from the authority's clock now, so the value is never the player's own clock."

+ },

+ "set_by": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 200,

+ "description": "The subject that made the change (the lease holder's subject as the authority knows it)."

+ },

+ "seq": {

+ "type": "integer",

+ "minimum": 1,

+ "description": "The timeline version: starts at 1 and increments on every accepted change. A client ignores a state with a seq it has already seen."

+ }

diff --git a/fixtures/common.control-lease/invalid/duplicate-watcher.json b/fixtures/common.control-lease/invalid/duplicate-watcher.json

new file mode 100644

index 00000000..86e7455e

--- /dev/null

+++ b/fixtures/common.control-lease/invalid/duplicate-watcher.json

@@ -0,0 +1,7 @@

+ "thing": "chat.room:friday-film",

+ "holder": { "kind": "person", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },

+ "since_ms": 1794067200000,

+ "watchers": ["usr_01JAB2C3D4E5F6G7H8J9K0MNPS", "usr_01JAB2C3D4E5F6G7H8J9K0MNPS"],

+ "seq": 1

diff --git a/fixtures/common.control-lease/invalid/nobody-with-subject.json b/fixtures/common.control-lease/invalid/nobody-with-subject.json

new file mode 100644

index 00000000..0186bc2a

--- /dev/null

+++ b/fixtures/common.control-lease/invalid/nobody-with-subject.json

@@ -0,0 +1,7 @@

+ "thing": "chat.room:friday-film",

+ "holder": { "kind": "nobody", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },

+ "since_ms": 1794067200000,

+ "watchers": [],

+ "seq": 1

diff --git a/fixtures/common.control-lease/invalid/person-without-subject.json b/fixtures/common.control-lease/invalid/person-without-subject.json

new file mode 100644

index 00000000..ec35a146

--- /dev/null

+++ b/fixtures/common.control-lease/invalid/person-without-subject.json

@@ -0,0 +1,7 @@

+ "thing": "chat.room:friday-film",

+ "holder": { "kind": "person" },

+ "since_ms": 1794067200000,

+ "watchers": [],

+ "seq": 1

diff --git a/fixtures/common.control-lease/invalid/seq-zero.json b/fixtures/common.control-lease/invalid/seq-zero.json

new file mode 100644

index 00000000..f79d1347

--- /dev/null

+++ b/fixtures/common.control-lease/invalid/seq-zero.json

@@ -0,0 +1,7 @@

+ "thing": "chat.room:friday-film",

+ "holder": { "kind": "person", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },

+ "since_ms": 1794067200000,

+ "watchers": [],

+ "seq": 0

diff --git a/fixtures/common.control-lease/valid/ai.json b/fixtures/common.control-lease/valid/ai.json

new file mode 100644

index 00000000..f2bded5f

--- /dev/null

+++ b/fixtures/common.control-lease/valid/ai.json

@@ -0,0 +1,8 @@

+ "thing": "desk:desk-7",

+ "holder": { "kind": "ai", "subject": "ai:vibe" },

+ "since_ms": 1794067200000,

+ "expires_ms": null,

+ "watchers": [],

+ "seq": 1

diff --git a/fixtures/common.control-lease/valid/free.json b/fixtures/common.control-lease/valid/free.json

new file mode 100644

index 00000000..ea7b8c69

--- /dev/null

+++ b/fixtures/common.control-lease/valid/free.json

@@ -0,0 +1,7 @@

+ "thing": "chat.room:friday-film",

+ "holder": { "kind": "nobody", "subject": null },

+ "since_ms": 1794067200000,

+ "watchers": ["usr_01JAB2C3D4E5F6G7H8J9K0MNPS"],

+ "seq": 5

diff --git a/fixtures/common.control-lease/valid/person-with-limit.json b/fixtures/common.control-lease/valid/person-with-limit.json

new file mode 100644

index 00000000..74bb5d38

--- /dev/null

+++ b/fixtures/common.control-lease/valid/person-with-limit.json

@@ -0,0 +1,11 @@

+ "thing": "chat.room:friday-film",

+ "holder": { "kind": "person", "subject": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS" },

+ "since_ms": 1794067200000,

+ "expires_ms": 1794070800000,

+ "watchers": [

+ "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "usr_01JAB2C3D4E5F6G7H8J9K0MNPX"

+ ],

+ "seq": 4

diff --git a/fixtures/common.sync-clock/invalid/bad-media.json b/fixtures/common.sync-clock/invalid/bad-media.json

new file mode 100644

index 00000000..7fc24523

--- /dev/null

+++ b/fixtures/common.sync-clock/invalid/bad-media.json

@@ -0,0 +1,10 @@

+ "room": "friday-film",

+ "media": { "url": "https://media.openvibe.network/vod/friday-film.webm" },

+ "position_ms": 0,

+ "rate": 1,

+ "paused": false,

+ "at_ms": 1794067200123,

+ "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "seq": 1

diff --git a/fixtures/common.sync-clock/invalid/bad-position-and-rate.json b/fixtures/common.sync-clock/invalid/bad-position-and-rate.json

new file mode 100644

index 00000000..0976e824

--- /dev/null

+++ b/fixtures/common.sync-clock/invalid/bad-position-and-rate.json

@@ -0,0 +1,10 @@

+ "room": "friday-film",

+ "media": "https://media.openvibe.network/vod/friday-film.webm",

+ "position_ms": -1,

+ "rate": 0,

+ "paused": false,

+ "at_ms": 1794067200123,

+ "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "seq": 1

diff --git a/fixtures/common.sync-clock/invalid/bad-room.json b/fixtures/common.sync-clock/invalid/bad-room.json

new file mode 100644

index 00000000..044fc201

--- /dev/null

+++ b/fixtures/common.sync-clock/invalid/bad-room.json

@@ -0,0 +1,10 @@

+ "room": "Friday Film",

+ "media": "https://media.openvibe.network/vod/friday-film.webm",

+ "position_ms": 0,

+ "rate": 1,

+ "paused": false,

+ "at_ms": 1794067200123,

+ "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "seq": 1

diff --git a/fixtures/common.sync-clock/invalid/http-media.json b/fixtures/common.sync-clock/invalid/http-media.json

new file mode 100644

index 00000000..463b3806

--- /dev/null

+++ b/fixtures/common.sync-clock/invalid/http-media.json

@@ -0,0 +1,10 @@

+ "room": "friday-film",

+ "media": "http://media.openvibe.network/vod/friday-film.webm",

+ "position_ms": 0,

+ "rate": 1,

+ "paused": false,

+ "at_ms": 1794067200123,

+ "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "seq": 1

diff --git a/fixtures/common.sync-clock/valid/ref-paused.json b/fixtures/common.sync-clock/valid/ref-paused.json

new file mode 100644

index 00000000..775f3bed

--- /dev/null

+++ b/fixtures/common.sync-clock/valid/ref-paused.json

@@ -0,0 +1,13 @@

+ "room": "friday-film",

+ "media": {

+ "media_id": "legacy:media:vod:4242",

+ "role": "main"

+ },

+ "position_ms": 12000,

+ "rate": 1.25,

+ "paused": true,

+ "at_ms": 1794067200123,

+ "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "seq": 8

diff --git a/fixtures/common.sync-clock/valid/url-playing.json b/fixtures/common.sync-clock/valid/url-playing.json

new file mode 100644

index 00000000..8e44a29f

--- /dev/null

+++ b/fixtures/common.sync-clock/valid/url-playing.json

@@ -0,0 +1,10 @@

+ "room": "friday-film",

+ "media": "https://media.openvibe.network/vod/friday-film.webm",

+ "position_ms": 61234,

+ "rate": 1,

+ "paused": false,

+ "at_ms": 1794067200123,

+ "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",

+ "seq": 7

diff --git a/generated/json-schema/bundle.json b/generated/json-schema/bundle.json

index ca6b8a5c..dbf152a9 100644

--- a/generated/json-schema/bundle.json

+++ b/generated/json-schema/bundle.json

@@ -109833,6 +109833,213 @@

}

+ },

+ "common.control-lease": {

+ "version": "1.0.0",

+ "owner": "contracts",

+ "status": "active",

+ "schema": {

+ "$schema": "https://json-schema.org/draft/2020-12/schema",

+ "$id": "https://openvibe.network/contracts/common/control-lease.v1.json",

+ "title": "ControlLease",

+ "type": "object",

+ "additionalProperties": false,

+ "required": [

+ "thing",

+ "holder",

+ "since_ms",

+ "watchers",

+ "seq"

+ ],

+ "properties": {

+ "thing": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 200,

+ "description": "The shared thing the lease controls, in the owning authority's own namespace. Chat writes chat.room:<slug>."

+ },

+ "holder": {

+ "type": "object",

+ "additionalProperties": false,

+ "required": [

+ "kind",

+ "subject"

+ ],

+ "description": "Who may act on the thing now. nobody means the controls are free; subject is null exactly then.",

+ "properties": {

+ "kind": {

+ "enum": [

+ "person",

+ "ai",

+ "nobody"

+ ],

+ "description": "A signed-in person, an AI agent the authority can name, or nobody."

+ },

+ "subject": {

+ "type": [

+ "string",

+ "null"

+ ],

+ "minLength": 1,

+ "maxLength": 200,

+ "description": "The authority's subject for the holder (a Network usr_… subject for a person, an agent subject for an AI); null when the kind is nobody."

+ }

+ },

+ "allOf": [

+ {

+ "if": {

+ "properties": {

+ "kind": {

+ "const": "nobody"

+ }

+ },

+ "required": [

+ "kind"

+ ]

+ },

+ "then": {

+ "properties": {

+ "subject": {

+ "const": null

+ }

+ },

+ {

+ "if": {

+ "properties": {

+ "kind": {

+ "enum": [

+ "person",

+ "ai"

+ ]

+ }

+ },

+ "required": [

+ "kind"

+ ]

+ },

+ "then": {

+ "properties": {

+ "subject": {

+ "type": "string",

+ "minLength": 1

+ }

+ ]

+ },

+ "since_ms": {

+ "type": "integer",

+ "minimum": 0,

+ "description": "When the current holder got the controls, as epoch milliseconds in the authority's clock."

+ },

+ "expires_ms": {

+ "type": [

+ "integer",

+ "null"

+ ],

+ "minimum": 0,

+ "description": "When the holder's time runs out, as epoch milliseconds; null or absent means no time limit. At that instant the authority makes the holder nobody and increments seq."

+ },

+ "watchers": {

+ "type": "array",

+ "maxItems": 500,

+ "uniqueItems": true,

+ "items": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 200

+ },

+ "seq": {

+ "type": "integer",

+ "minimum": 1,

+ "description": "The control version: starts at 1 for a thing's first state and increments on every holder change, expiry or take-back. A client ignores a state with a seq it has already seen."

+ }

+ },

+ "common.sync-clock": {

+ "version": "1.0.0",

+ "owner": "contracts",

+ "status": "active",

+ "schema": {

+ "$schema": "https://json-schema.org/draft/2020-12/schema",

+ "$id": "https://openvibe.network/contracts/common/sync-clock.v1.json",

+ "title": "SyncClock",

+ "type": "object",

+ "additionalProperties": false,

+ "required": [

+ "room",

+ "media",

+ "position_ms",

+ "rate",

+ "paused",

+ "at_ms",

+ "set_by",

+ "seq"

+ ],

+ "properties": {

+ "room": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 64,

+ "pattern": "^[a-z0-9][a-z0-9-]*$",

+ "description": "The authority's room id (Chat: the room's slug)."

+ },

+ "media": {

+ "description": "What is playing: an OpenVibe media ref or an https URL. A ref names a Media object; a URL is the media file itself.",

+ "oneOf": [

+ {

+ "$ref": "../media/media-ref.v1.json"

+ },

+ {

+ "type": "string",

+ "format": "uri",

+ "pattern": "^https://",

+ "maxLength": 2048

+ }

+ ]

+ },

+ "position_ms": {

+ "type": "integer",

+ "minimum": 0,

+ "maximum": 2592000000,

+ "description": "The media position at at_ms, in milliseconds. At most 30 days."

+ },

+ "rate": {

+ "type": "number",

+ "exclusiveMinimum": 0,

+ "maximum": 16,

+ "description": "The playback rate the room is playing at (1 is normal speed)."

+ },

+ "paused": {

+ "type": "boolean",

+ "description": "When true the timeline stands still at position_ms; when false it advances at rate."

+ },

+ "at_ms": {

+ "type": "integer",

+ "minimum": 0,

+ "description": "The authority's epoch milliseconds when it accepted this state. A player subtracts this from the authority's clock now, so the value is never the player's own clock."

+ },

+ "set_by": {

+ "type": "string",

+ "minLength": 1,

+ "maxLength": 200,

+ "description": "The subject that made the change (the lease holder's subject as the authority knows it)."

+ },

+ "seq": {

+ "type": "integer",

+ "minimum": 1,

+ "description": "The timeline version: starts at 1 and increments on every accepted change. A client ignores a state with a seq it has already seen."

+ }

}

diff --git a/generated/openapi/actor.json b/generated/openapi/actor.json

index 7bf14530..eb1b01de 100644

--- a/generated/openapi/actor.json

+++ b/generated/openapi/actor.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Actor API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/ai.json b/generated/openapi/ai.json

index 9b1836fe..22d95358 100644

--- a/generated/openapi/ai.json

+++ b/generated/openapi/ai.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.AI API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/bench.json b/generated/openapi/bench.json

index ca34bdef..46a0fa20 100644

--- a/generated/openapi/bench.json

+++ b/generated/openapi/bench.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Bench API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/billing.json b/generated/openapi/billing.json

index 79964398..6f8cd80a 100644

--- a/generated/openapi/billing.json

+++ b/generated/openapi/billing.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Billing API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/blog.json b/generated/openapi/blog.json

index b2335b67..5b42bd10 100644

--- a/generated/openapi/blog.json

+++ b/generated/openapi/blog.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Blog API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/bot.json b/generated/openapi/bot.json

index 11476e2c..1d8853a6 100644

--- a/generated/openapi/bot.json

+++ b/generated/openapi/bot.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Bot API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/chat.json b/generated/openapi/chat.json

index 76ffe8ca..cbe5f0c1 100644

--- a/generated/openapi/chat.json

+++ b/generated/openapi/chat.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Chat API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/codes.json b/generated/openapi/codes.json

index 97b47d88..a8ae03d6 100644

--- a/generated/openapi/codes.json

+++ b/generated/openapi/codes.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Codes API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/community.json b/generated/openapi/community.json

index 468bbfb8..78c3c364 100644

--- a/generated/openapi/community.json

+++ b/generated/openapi/community.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Community API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/connect.json b/generated/openapi/connect.json

index 9ccc068d..4a9255b9 100644

--- a/generated/openapi/connect.json

+++ b/generated/openapi/connect.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe Connect API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/coupons.json b/generated/openapi/coupons.json

index 845dc7a8..19aaf461 100644

--- a/generated/openapi/coupons.json

+++ b/generated/openapi/coupons.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Coupons API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/deals.json b/generated/openapi/deals.json

index fdccbe22..2f86d2ca 100644

--- a/generated/openapi/deals.json

+++ b/generated/openapi/deals.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Deals API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/design.json b/generated/openapi/design.json

index a8d96b3e..dd8a5889 100644

--- a/generated/openapi/design.json

+++ b/generated/openapi/design.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Design API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/domains.json b/generated/openapi/domains.json

index d74169a5..e97fc4d2 100644

--- a/generated/openapi/domains.json

+++ b/generated/openapi/domains.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Domains API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/events.json b/generated/openapi/events.json

index 69a16567..da4546ba 100644

--- a/generated/openapi/events.json

+++ b/generated/openapi/events.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Events API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/food.json b/generated/openapi/food.json

index 5d3a1909..d4b8784c 100644

--- a/generated/openapi/food.json

+++ b/generated/openapi/food.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Food API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/games.json b/generated/openapi/games.json

index acb42feb..cae23588 100644

--- a/generated/openapi/games.json

+++ b/generated/openapi/games.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Games API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/host.json b/generated/openapi/host.json

index 8d67f6d1..e9c3af8c 100644

--- a/generated/openapi/host.json

+++ b/generated/openapi/host.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Host API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/inventory.json b/generated/openapi/inventory.json

index dcd07364..e653a922 100644

--- a/generated/openapi/inventory.json

+++ b/generated/openapi/inventory.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Inventory API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/live.json b/generated/openapi/live.json

index 7ce4b7fd..890e9159 100644

--- a/generated/openapi/live.json

+++ b/generated/openapi/live.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Live API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/mail.json b/generated/openapi/mail.json

index 2f3708f4..f0f5b0e1 100644

--- a/generated/openapi/mail.json

+++ b/generated/openapi/mail.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Mail API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/media-hub.json b/generated/openapi/media-hub.json

index 5059730f..9208cd28 100644

--- a/generated/openapi/media-hub.json

+++ b/generated/openapi/media-hub.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.MediaHub API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/media.json b/generated/openapi/media.json

index 38a5a09f..7472113f 100644

--- a/generated/openapi/media.json

+++ b/generated/openapi/media.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Media API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/network.json b/generated/openapi/network.json

index b8af63f5..cf82946b 100644

--- a/generated/openapi/network.json

+++ b/generated/openapi/network.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Network API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/news.json b/generated/openapi/news.json

index d11e4cd8..a650308e 100644

--- a/generated/openapi/news.json

+++ b/generated/openapi/news.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.News API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/openre.json b/generated/openapi/openre.json

index 2d3ee17e..f5cd792a 100644

--- a/generated/openapi/openre.json

+++ b/generated/openapi/openre.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenRestream API",

- "version": "0.331.0",

- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/play.json b/generated/openapi/play.json

index dc51d321..5dca8df0 100644

--- a/generated/openapi/play.json

+++ b/generated/openapi/play.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Play API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/quest.json b/generated/openapi/quest.json

index a8f58e65..9eb36fd3 100644

--- a/generated/openapi/quest.json

+++ b/generated/openapi/quest.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Quest API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/report.json b/generated/openapi/report.json

index 7a4a1146..5e09da29 100644

--- a/generated/openapi/report.json

+++ b/generated/openapi/report.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Report API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/reviews.json b/generated/openapi/reviews.json

index 5e238e30..9d8ccdd7 100644

--- a/generated/openapi/reviews.json

+++ b/generated/openapi/reviews.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Reviews API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/run.json b/generated/openapi/run.json

index fb2af44d..5c5a0e8b 100644

--- a/generated/openapi/run.json

+++ b/generated/openapi/run.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Run API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/search.json b/generated/openapi/search.json

index bfa87fa3..71b161eb 100644

--- a/generated/openapi/search.json

+++ b/generated/openapi/search.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Search API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/services.json b/generated/openapi/services.json

index 991611e9..589ccb38 100644

--- a/generated/openapi/services.json

+++ b/generated/openapi/services.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Services API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/sources.json b/generated/openapi/sources.json

index 4734dd8c..53db7a7c 100644

--- a/generated/openapi/sources.json

+++ b/generated/openapi/sources.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Sources API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/space.json b/generated/openapi/space.json

index 0bb4928f..2f099037 100644

--- a/generated/openapi/space.json

+++ b/generated/openapi/space.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Space API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/tips.json b/generated/openapi/tips.json

index 1ee28408..e1dd0dc4 100644

--- a/generated/openapi/tips.json

+++ b/generated/openapi/tips.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Tips API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/today.json b/generated/openapi/today.json

index a8d72200..8a041704 100644

--- a/generated/openapi/today.json

+++ b/generated/openapi/today.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Today API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/tools.json b/generated/openapi/tools.json

index 630f6028..20fb1235 100644

--- a/generated/openapi/tools.json

+++ b/generated/openapi/tools.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Tools API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/trade.json b/generated/openapi/trade.json

index 66a6ab6a..a4164cde 100644

--- a/generated/openapi/trade.json

+++ b/generated/openapi/trade.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Trade API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/vip.json b/generated/openapi/vip.json

index 7e64de3b..da3dcfd5 100644

--- a/generated/openapi/vip.json

+++ b/generated/openapi/vip.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.VIP API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/vision.json b/generated/openapi/vision.json

index a0a631e6..589ed4fd 100644

--- a/generated/openapi/vision.json

+++ b/generated/openapi/vision.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Vision API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/watch.json b/generated/openapi/watch.json

index 97655130..2c5b52ec 100644

--- a/generated/openapi/watch.json

+++ b/generated/openapi/watch.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Watch API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/wiki.json b/generated/openapi/wiki.json

index c2903ab6..634f94af 100644

--- a/generated/openapi/wiki.json

+++ b/generated/openapi/wiki.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Wiki API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/work.json b/generated/openapi/work.json

index 3feab921..f9cccb4d 100644

--- a/generated/openapi/work.json

+++ b/generated/openapi/work.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Work API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/openapi/zone.json b/generated/openapi/zone.json

index 3951dad5..63e61ff7 100644

--- a/generated/openapi/zone.json

+++ b/generated/openapi/zone.json

@@ -3,8 +3,8 @@

"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",

"info": {

"title": "OpenVibe.Zone API",

- "version": "0.331.0",

- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.331.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

+ "version": "0.332.0",

+ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.332.0): each operation lists the capabilities it performs; a token for the service's audience must carry one of them unless the route is open. Generated by openvibe-contracts lib/openapi.js; do not edit.",

"license": {

"name": "MIT",

"identifier": "MIT"

diff --git a/generated/typescript/index.d.ts b/generated/typescript/index.d.ts

index 7b3606de..1c78545b 100644

--- a/generated/typescript/index.d.ts

+++ b/generated/typescript/index.d.ts

@@ -302073,3 +302073,77 @@ export interface MailMessageSummary {

received_at: string | null;

}

+/** [email protected] (owner: contracts) */

+/**

+ * common.control-lease@1: who holds the controls of a shared thing (seven domains plan B3). The state names the thing, its holder (a person, an AI, or nobody when the controls are free), when the holder got them, an optional time limit as an absolute epoch instant, the subjects watching and a sequence number. Every control change, including an expiry or a take-back, increments seq; a change in watchers alone does not. The authority that owns the thing writes and enforces the state: it decides who may request, grant, release or take the controls, and take-back always wins. Chat hosts a room's lease on its room socket and names the thing chat.room:<slug>; the holder is the person or AI whose subject Chat would accept on a set.

+ */

+export interface ControlLease {

+ /**

+ * The shared thing the lease controls, in the owning authority's own namespace. Chat writes chat.room:<slug>.

+ */

+ thing: string;

+ /**

+ * Who may act on the thing now. nobody means the controls are free; subject is null exactly then.

+ */

+ holder: {

+ [k: string]: unknown | undefined;

+ };

+ /**

+ * When the current holder got the controls, as epoch milliseconds in the authority's clock.

+ */

+ since_ms: number;

+ /**

+ * When the holder's time runs out, as epoch milliseconds; null or absent means no time limit. At that instant the authority makes the holder nobody and increments seq.

+ */

+ expires_ms?: number | null;

+ /**

+ * The subjects watching the thing now, as live presence rather than a durable membership list. The authority decides who is listed; Chat lists the signed-in subjects connected to the room. A change here does not increment seq.

+ *

+ * @maxItems 500

+ */

+ watchers: string[];

+ /**

+ * The control version: starts at 1 for a thing's first state and increments on every holder change, expiry or take-back. A client ignores a state with a seq it has already seen.

+ */

+ seq: number;

+/** [email protected] (owner: contracts) */

+/**

+ * common.sync-clock@1: one timeline for many players (seven domains plan B4). The authority stamps at_ms and seq when it accepts a change and fans the state out; a player computes where it should be as position_ms + (authority time now - at_ms) * rate when paused is false, and exactly position_ms when paused is true. Chat hosts a room's clock on its room socket, keeps the latest state in memory and in the room_sync_clocks table, refuses a set from anyone but the current common.control-lease@1 holder, and sends the state to a member when they join the room. Clock offset is measured over the same socket with time ping/pong pairs, best of five samples, refreshed every 60 s.

+ */

+export interface SyncClock {

+ /**

+ * The authority's room id (Chat: the room's slug).

+ */

+ room: string;

+ /**

+ * What is playing: an OpenVibe media ref or an https URL. A ref names a Media object; a URL is the media file itself.

+ */

+ media: MediaRef | string;

+ /**

+ * The media position at at_ms, in milliseconds. At most 30 days.

+ */

+ position_ms: number;

+ /**

+ * The playback rate the room is playing at (1 is normal speed).

+ */

+ rate: number;

+ /**

+ * When true the timeline stands still at position_ms; when false it advances at rate.

+ */

+ paused: boolean;

+ /**

+ * The authority's epoch milliseconds when it accepted this state. A player subtracts this from the authority's clock now, so the value is never the player's own clock.

+ */

+ at_ms: number;

+ /**

+ * The subject that made the change (the lease holder's subject as the authority knows it).

+ */

+ set_by: string;

+ /**

+ * The timeline version: starts at 1 and increments on every accepted change. A client ignores a state with a seq it has already seen.

+ */

+ seq: number;

diff --git a/package-lock.json b/package-lock.json

index 5674ecbd..fa3780ad 100644

--- a/package-lock.json

+++ b/package-lock.json

@@ -1,12 +1,12 @@

{

"name": "openvibe-contracts",

- "version": "0.331.0",

+ "version": "0.332.0",

"lockfileVersion": 3,

"requires": true,

"packages": {

"": {

"name": "openvibe-contracts",

- "version": "0.331.0",

+ "version": "0.332.0",

"license": "AGPL-3.0-only",

"dependencies": {

"ajv": "^8.17.1",

diff --git a/package.json b/package.json

index e419e10b..ce29f962 100644

--- a/package.json

+++ b/package.json

@@ -1,6 +1,6 @@

{

"name": "openvibe-contracts",

- "version": "0.331.0",

+ "version": "0.332.0",

"description": "Machine-readable contracts for the OpenVibe network: schemas, manifests, ids, error envelope, capability checks.",

"main": "index.js",

"types": "generated/typescript/index.d.ts",