openvibers/openvibe.contracts Commits

0.379.0: Wiki rich articles — blocks, image suggestions and the writer (#393)

OP OpenVibers committed 4 days ago · 5e8c3adaf4 · 68 files, +4203 −113

* 0.378.0: Wiki rich article contracts (blocks, image suggestions, the writer)

* Merge origin/main into w1/contracts-wiki-blocks and bump 0.378.0

* Merge origin/main and bump to 0.379.0 (0.378.0 is the Link rename)

* Merge wiki rich article contracts for 0.379.0

Changes

ddiff --git a/CHANGELOG.md b/CHANGELOG.md
iindex 2495bca4..6347e2c0 100644
---- a/CHANGELOG.md
++++ b/CHANGELOG.md
@@@ -1,8 +1,12 @@
# Changelog
++## 0.379.0 — 2026-11-09
++
++- Wiki's rich articles: the page write request and the page read result carry `blocks` (`publishing.block@1`) next to the Markdown, and `wiki.images-suggest-request@1`/`-result@1` and `wiki.article-draft-request@1`/`-result@1` describe the image suggestions (`wiki.article.images`) and the `content.wiki` draft revision that waits for a person.
++
## 0.378.0 — 2026-11-09
--- Connect's manifest and a relay fixture say OpenVibe Link, not Node (the old-name sweep)
++- OpenVibe.Connect and the relay profile describe the Link, not the Node.
## 0.377.0 — 2026-11-09
ddiff --git a/README.md b/README.md
iindex 48fe298d..fa40903e 100644
---- a/README.md
++++ b/README.md
@@@ -2,7 +2,7 @@
> Machine-readable contracts for the whole OpenVibe network.
--**Status:** alpha (first released in Wave 1; the release is package.json's `version`, tagged). At v0.356.0: 1138 schemas in `contracts/catalog.json`, 61 service manifests, 494 capability manifests, 13 namespace manifests and the staff capability map. Service repositories run `openvibe-contracts-check` and the pin-drift check in CI, and deployed services verify service and app tokens with `serviceAuth` in production. Consumers pin release tags (each repository's `STATUS.json` names its pin). `node scripts/docs-currency.js <root>` checks every checkout's README and `STATUS.json` against its code: the pins and versions they name, a library's consumer list, the deployed flag against the manifest, README links, and the paths and migrations they name. `node scripts/estate.js` generates `docs/ESTATE.md` and `manifests/repositories/` from the estate checkouts, and `--check` fails on drift (plan T1 step 3).
++**Status:** alpha (first released in Wave 1; the release is package.json's `version`, tagged). At v0.379.0: 1188 schemas in `contracts/catalog.json`, 65 service manifests, 511 capability manifests, 13 namespace manifests and the staff capability map. Service repositories run `openvibe-contracts-check` and the pin-drift check in CI, and deployed services verify service and app tokens with `serviceAuth` in production. Consumers pin release tags (each repository's `STATUS.json` names its pin). `node scripts/docs-currency.js <root>` checks every checkout's README and `STATUS.json` against its code: the pins and versions they name, a library's consumer list, the deployed flag against the manifest, README links, and the paths and migrations they name. `node scripts/estate.js` generates `docs/ESTATE.md` and `manifests/repositories/` from the estate checkouts, and `--check` fails on drift (plan T1 step 3).
**Plan:** OpenVibe Development Roadmap, Wave 1 (implementation plan rev 3, §3.1 and §18.11).
**License:** AGPL-3.0 (same as every OpenVibe service).
ddiff --git a/contracts/catalog.json b/contracts/catalog.json
iindex c83fdcfa..6be07c35 100644
---- a/contracts/catalog.json
++++ b/contracts/catalog.json
@@@ -1082,6 +1082,42 @@
"compatibility": "backward",
"status": "active"
},
++ {
++ "id": "wiki.images-suggest-request",
++ "version": "1.0.0",
++ "owner": "wiki",
++ "schema": "wiki/images-suggest-request.v1.json",
++ "visibility": "first-party",
++ "compatibility": "backward",
++ "status": "active"
++ },
++ {
++ "id": "wiki.images-suggest-result",
++ "version": "1.0.0",
++ "owner": "wiki",
++ "schema": "wiki/images-suggest-result.v1.json",
++ "visibility": "first-party",
++ "compatibility": "backward",
++ "status": "active"
++ },
++ {
++ "id": "wiki.article-draft-request",
++ "version": "1.0.0",
++ "owner": "wiki",
++ "schema": "wiki/article-draft-request.v1.json",
++ "visibility": "first-party",
++ "compatibility": "backward",
++ "status": "active"
++ },
++ {
++ "id": "wiki.article-draft-result",
++ "version": "1.0.0",
++ "owner": "wiki",
++ "schema": "wiki/article-draft-result.v1.json",
++ "visibility": "first-party",
++ "compatibility": "backward",
++ "status": "active"
++ },
{
"id": "wiki.page",
"version": "1.0.0",
ddiff --git a/contracts/wiki/article-draft-request.v1.json b/contracts/wiki/article-draft-request.v1.json
nnew file mode 100644
iindex 00000000..8d1e03a8
---- /dev/null
++++ b/contracts/wiki/article-draft-request.v1.json
@@@ -0,0 +1,22 @@
++{
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/article-draft-request.v1.json",
++ "title": "WikiArticleDraftRequest",
++ "description": "wiki.article-draft-request@1: the body of the wiki writer on OpenVibe.Wiki (an editor of the space). POST /api/v1/pages/:id/draft runs OpenVibe.AI's content.wiki workflow — research with web search plus the sources the article already cites, a citation on every sentence, and an infobox from structured facts — and files the result as a pending wiki proposal. It never publishes: a person approves it in the review queue.",
++ "type": "object",
++ "additionalProperties": false,
++ "properties": {
++ "instruction": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 4000,
++ "description": "What the editor wants written or improved."
++ },
++ "choice": {
++ "$ref": "../ai/choice.v1.json",
++ "description": "The model for the writer, from the same chip as every AI run."
++ }
++ }
++}
ddiff --git a/contracts/wiki/article-draft-result.v1.json b/contracts/wiki/article-draft-result.v1.json
nnew file mode 100644
iindex 00000000..d5a78bdb
---- /dev/null
++++ b/contracts/wiki/article-draft-result.v1.json
@@@ -0,0 +1,121 @@
++{
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/article-draft-result.v1.json",
++ "title": "WikiArticleDraftResult",
++ "description": "wiki.article-draft-result@1: what the wiki writer answers. The draft revision is pending review — status is always 'pending' — with the workflow and run that wrote it, the model that answered, and the sources its sentences cited. Nothing here is published.",
++ "type": "object",
++ "additionalProperties": false,
++ "required": [
++ "proposal",
++ "revision"
++ ],
++ "properties": {
++ "proposal": {
++ "type": "object",
++ "required": [
++ "id",
++ "page_id",
++ "status"
++ ],
++ "properties": {
++ "id": {
++ "type": "string"
++ },
++ "page_id": {
++ "type": "string"
++ },
++ "space_id": {
++ "type": "string"
++ },
++ "revision": {
++ "type": "integer",
++ "minimum": 1
++ },
++ "base_revision": {
++ "type": "integer",
++ "minimum": 0
++ },
++ "workflow_id": {
++ "type": "string"
++ },
++ "run_id": {
++ "type": "string"
++ },
++ "status": {
++ "const": "pending"
++ },
++ "proposed_by": {
++ "type": "string"
++ }
++ }
++ },
++ "revision": {
++ "$ref": "revision.v1.json"
++ },
++ "run_id": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "model": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "provider": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "sources": {
++ "type": "array",
++ "maxItems": 50,
++ "items": {
++ "type": "object",
++ "required": [
++ "url"
++ ],
++ "properties": {
++ "url": {
++ "type": "string",
++ "maxLength": 2048
++ },
++ "title": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 500
++ },
++ "author": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "retrieved_at": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 40
++ },
++ "license": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ }
++ }
++ }
++ }
++ }
++}
ddiff --git a/contracts/wiki/images-suggest-request.v1.json b/contracts/wiki/images-suggest-request.v1.json
nnew file mode 100644
iindex 00000000..247e5c3c
---- /dev/null
++++ b/contracts/wiki/images-suggest-request.v1.json
@@@ -0,0 +1,40 @@
++{
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/images-suggest-request.v1.json",
++ "title": "WikiImagesSuggestRequest",
++ "description": "wiki.images-suggest-request@1: the body of wiki.images.suggest on OpenVibe.Wiki (an editor of the space). POST /api/v1/pages/:id/images/suggest asks the wiki.article.images task for the article's lead picture and figures: Wikimedia Commons and Openverse first, keeping the licence and the author; then OpenVibe.Pics and the page's own Media; an AI illustration only when nothing real exists, never of a real person. Every field is optional; the path names the article.",
++ "type": "object",
++ "additionalProperties": false,
++ "properties": {
++ "query": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 300,
++ "description": "What to look for; defaults to the article's title and summary."
++ },
++ "section": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200,
++ "description": "A section heading the pictures should illustrate; omitted, the lead picture is suggested first."
++ },
++ "count": {
++ "type": "integer",
++ "minimum": 1,
++ "maximum": 12,
++ "description": "At most this many suggestions (default 8)."
++ },
++ "allow_ai": {
++ "type": "boolean",
++ "description": "Whether an illustration may be drawn when no real picture exists (default true; never for an article about a real person)."
++ },
++ "choice": {
++ "$ref": "../ai/choice.v1.json",
++ "description": "The search engine (search/commons, search/openverse, …) for the wiki.article.images task; the owner's or person's choice answers when omitted."
++ }
++ }
++}
ddiff --git a/contracts/wiki/images-suggest-result.v1.json b/contracts/wiki/images-suggest-result.v1.json
nnew file mode 100644
iindex 00000000..4f36f001
---- /dev/null
++++ b/contracts/wiki/images-suggest-result.v1.json
@@@ -0,0 +1,182 @@
++{
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/images-suggest-result.v1.json",
++ "title": "WikiImagesSuggestResult",
++ "description": "wiki.images-suggest-result@1: what wiki.images.suggest answers. Each suggestion says where a picture came from and keeps its licence and author (Commons and Openverse), the OpenVibe.Pics page and its uploader, the page's own Media object, or — only when nothing real exists and the subject is not a real person — an AI illustration labelled 'Illustration made with <model>'. A suggestion is a candidate, not an attachment: the editor chooses one, the file goes to Media, and only then does it become a page attachment.",
++ "type": "object",
++ "additionalProperties": false,
++ "required": [
++ "article_id",
++ "task",
++ "suggestions"
++ ],
++ "properties": {
++ "article_id": {
++ "type": "string",
++ "pattern": "^pg_[0-9A-HJKMNP-TV-Z]{26}$"
++ },
++ "task": {
++ "const": "wiki.article.images",
++ "description": "The AI task that found the pictures."
++ },
++ "query": {
++ "type": "string",
++ "maxLength": 300
++ },
++ "subject_is_person": {
++ "type": "boolean",
++ "description": "True when the article is about a real person: no AI illustration is suggested."
++ },
++ "run_id": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "note": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 300,
++ "description": "Why nothing more was suggested (no licensed picture found, the AI is not configured, the subject is a person)."
++ },
++ "suggestions": {
++ "type": "array",
++ "maxItems": 12,
++ "items": {
++ "type": "object",
++ "additionalProperties": false,
++ "required": [
++ "provider",
++ "role"
++ ],
++ "properties": {
++ "provider": {
++ "enum": [
++ "commons",
++ "openverse",
++ "pics",
++ "media",
++ "ai"
++ ]
++ },
++ "role": {
++ "enum": [
++ "lead",
++ "figure"
++ ]
++ },
++ "media_id": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "pattern": "^med_[0-9A-HJKMNP-TV-Z]{26}$",
++ "description": "Set for provider media, or once a chosen suggestion is in Media."
++ },
++ "url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 2048,
++ "description": "The picture file to fetch (https) or to show when Media already serves it."
++ },
++ "page_url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 2048,
++ "description": "The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object)."
++ },
++ "title": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 300
++ },
++ "author": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200,
++ "description": "The author or uploader, kept for the credit line."
++ },
++ "license": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "license_url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 2048
++ },
++ "width": {
++ "type": [
++ "integer",
++ "null"
++ ],
++ "minimum": 1
++ },
++ "height": {
++ "type": [
++ "integer",
++ "null"
++ ],
++ "minimum": 1
++ },
++ "alt": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 400
++ },
++ "caption": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 400
++ },
++ "credit": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 400,
++ "description": "The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image."
++ },
++ "ai": {
++ "type": "boolean"
++ },
++ "model": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "data_url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 8000000,
++ "description": "An AI illustration's bytes as a data: URL when the provider returned no hosted URL."
++ }
++ }
++ }
++ }
++ }
++}
ddiff --git a/contracts/wiki/page-read-result.v1.json b/contracts/wiki/page-read-result.v1.json
iindex a2d6d026..3ea9f29e 100644
---- a/contracts/wiki/page-read-result.v1.json
++++ b/contracts/wiki/page-read-result.v1.json
@@@ -2,7 +2,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/wiki/page-read-result.v1.json",
"title": "WikiPageReadResult",
-- "description": "wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread }; GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.",
++ "description": "wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] \u2192 { page, revision, citations, infobox, attachments, links, indexability, discussion_thread, blocks } (blocks is the revision's body as a publishing.block@1 tree, next to the Markdown in revision.body); GET \u2026/revisions?before=&limit= \u2192 { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET \u2026/revisions/:n \u2192 { revision, citations, infobox, blocks }; GET \u2026/diff?from=&to=&mode= \u2192 { diff }; GET \u2026/revisions/:n/citations \u2192 { citations }; GET /api/v1/proposals/:id \u2192 { proposal }.",
"anyOf": [
{
"type": "object",
@@@ -66,7 +66,10 @@
}
}
},
-- "discussion_thread": {}
++ "discussion_thread": {},
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
++ }
}
},
{
@@@ -99,7 +102,10 @@
"$ref": "citation.v1.json"
}
},
-- "infobox": {}
++ "infobox": {},
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
++ }
}
},
{
ddiff --git a/contracts/wiki/page-write-request.v1.json b/contracts/wiki/page-write-request.v1.json
iindex fe931578..e42a46bd 100644
---- a/contracts/wiki/page-write-request.v1.json
++++ b/contracts/wiki/page-write-request.v1.json
@@@ -2,7 +2,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/wiki/page-write-request.v1.json",
"title": "WikiPageWriteRequest",
-- "description": "wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000). POST /api/v1/pages/:id/revisions: { expected_revision, body?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.",
++ "description": "wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body?, blocks?, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000; blocks is a publishing.block@1 tree and the API writes it back as the Markdown the revision keeps, so body and blocks are alternatives). POST /api/v1/pages/:id/revisions: { expected_revision, body?, blocks?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.",
"anyOf": [
{
"type": "object",
@@@ -116,6 +116,9 @@
"string",
"null"
]
++ },
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
}
}
},
@@@ -223,6 +226,9 @@
"string",
"null"
]
++ },
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
}
}
},
ddiff --git a/fixtures/wiki.article-draft-request/invalid/instruction-not-text.json b/fixtures/wiki.article-draft-request/invalid/instruction-not-text.json
nnew file mode 100644
iindex 00000000..84ac9aff
---- /dev/null
++++ b/fixtures/wiki.article-draft-request/invalid/instruction-not-text.json
@@@ -0,0 +1 @@
++{ "instruction": 5 }
ddiff --git a/fixtures/wiki.article-draft-request/valid/expand.json b/fixtures/wiki.article-draft-request/valid/expand.json
nnew file mode 100644
iindex 00000000..977d0d63
---- /dev/null
++++ b/fixtures/wiki.article-draft-request/valid/expand.json
@@@ -0,0 +1 @@
++{ "instruction": "Expand the setup section and keep every sentence sourced.", "choice": { "model": "openvibe/auto", "source": "openvibe" } }
ddiff --git a/fixtures/wiki.article-draft-result/invalid/published.json b/fixtures/wiki.article-draft-result/invalid/published.json
nnew file mode 100644
iindex 00000000..cdd3f09e
---- /dev/null
++++ b/fixtures/wiki.article-draft-result/invalid/published.json
@@@ -0,0 +1,4 @@
++{
++ "proposal": { "id": "prp_1", "page_id": "pg_1", "status": "published" },
++ "revision": { "number": 1, "id": "rev_1", "kind": "edit", "title": "X", "author": "svc:wiki", "created_at": "2026-11-09T10:00:00.000Z" }
++}
ddiff --git a/fixtures/wiki.article-draft-result/valid/pending.json b/fixtures/wiki.article-draft-result/valid/pending.json
nnew file mode 100644
iindex 00000000..66dc232b
---- /dev/null
++++ b/fixtures/wiki.article-draft-result/valid/pending.json
@@@ -0,0 +1,31 @@
++{
++ "proposal": {
++ "id": "prp_01JAB2C3D4E5F6G7H8J9K0MNPQ",
++ "page_id": "pg_01JAB2C3D4E5F6G7H8J9K0MNPQ",
++ "space_id": "spc_01JAB2C3D4E5F6G7H8J9K0MNPQ",
++ "revision": 4,
++ "base_revision": 3,
++ "workflow_id": "content.wiki",
++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPS",
++ "status": "pending",
++ "proposed_by": "svc:wiki"
++ },
++ "revision": {
++ "number": 4,
++ "id": "rev_01JAB2C3D4E5F6G7H8J9K0MNPR",
++ "kind": "edit",
++ "parent_number": 3,
++ "title": "Restreaming",
++ "summary": "Sending one stream to several platforms, with its sources.",
++ "infobox": [],
++ "body": "Restreaming sends one encoder feed to several platforms. It keeps the chat in one place.",
++ "authorship": { "mode": "ai", "workflow": { "id": "content.wiki", "runId": "run_01JAB2C3D4E5F6G7H8J9K0MNPS" } },
++ "author": "svc:wiki",
++ "message": "AI proposal",
++ "created_at": "2026-11-09T10:00:00.000Z"
++ },
++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPS",
++ "model": "openvibe/auto",
++ "provider": "openvibe",
++ "sources": [ { "url": "https://docs.example.com/rtmp", "title": "RTMP spec", "author": null, "retrieved_at": "2026-11-09T09:00:00.000Z", "license": null } ]
++}
ddiff --git a/fixtures/wiki.images-suggest-request/invalid/too-many.json b/fixtures/wiki.images-suggest-request/invalid/too-many.json
nnew file mode 100644
iindex 00000000..6bcf9fb8
---- /dev/null
++++ b/fixtures/wiki.images-suggest-request/invalid/too-many.json
@@@ -0,0 +1 @@
++{ "count": 99 }
ddiff --git a/fixtures/wiki.images-suggest-request/valid/commons.json b/fixtures/wiki.images-suggest-request/valid/commons.json
nnew file mode 100644
iindex 00000000..d49f8172
---- /dev/null
++++ b/fixtures/wiki.images-suggest-request/valid/commons.json
@@@ -0,0 +1 @@
++{ "query": "OpenVibe Link machine", "section": "Setup", "count": 6, "allow_ai": false, "choice": { "model": "search/commons", "source": "openvibe" } }
ddiff --git a/fixtures/wiki.images-suggest-result/invalid/no-provider.json b/fixtures/wiki.images-suggest-result/invalid/no-provider.json
nnew file mode 100644
iindex 00000000..4f3a52d6
---- /dev/null
++++ b/fixtures/wiki.images-suggest-result/invalid/no-provider.json
@@@ -0,0 +1,5 @@
++{
++ "article_id": "pg_01JAB2C3D4E5F6G7H8J9K0MNPQ",
++ "task": "wiki.article.images",
++ "suggestions": [ { "role": "lead" } ]
++}
ddiff --git a/fixtures/wiki.images-suggest-result/valid/mixed.json b/fixtures/wiki.images-suggest-result/valid/mixed.json
nnew file mode 100644
iindex 00000000..e8188889
---- /dev/null
++++ b/fixtures/wiki.images-suggest-result/valid/mixed.json
@@@ -0,0 +1,45 @@
++{
++ "article_id": "pg_01JAB2C3D4E5F6G7H8J9K0MNPQ",
++ "task": "wiki.article.images",
++ "query": "OpenVibe Link machine",
++ "subject_is_person": false,
++ "run_id": "run_01JAB2C3D4E5F6G7H8J9K0MNPS",
++ "note": null,
++ "suggestions": [
++ {
++ "provider": "commons",
++ "role": "lead",
++ "media_id": null,
++ "url": "https://upload.wikimedia.org/wikipedia/commons/8/8a/OpenVibe_Link.jpg",
++ "page_url": "https://commons.wikimedia.org/wiki/File:OpenVibe_Link.jpg",
++ "title": "OpenVibe Link running on a laptop",
++ "author": "Ada Example",
++ "license": "CC BY-SA 4.0",
++ "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
++ "width": 1280,
++ "height": 800,
++ "alt": "The OpenVibe Link window on a laptop",
++ "caption": "OpenVibe Link running on a laptop",
++ "credit": "Picture: Ada Example, CC BY-SA 4.0",
++ "ai": false
++ },
++ {
++ "provider": "ai",
++ "role": "figure",
++ "media_id": null,
++ "url": null,
++ "title": "A diagram of the relay",
++ "author": null,
++ "license": null,
++ "license_url": null,
++ "width": 1024,
++ "height": 1024,
++ "alt": "An illustration of a relay between two machines",
++ "caption": "An illustration of the relay",
++ "credit": "Illustration made with anthropic/claude-opus-5-5",
++ "ai": true,
++ "model": "anthropic/claude-opus-5-5",
++ "data_url": "data:image/png;base64,iVBORw0KGgo="
++ }
++ ]
++}
ddiff --git a/generated/json-schema/bundle.json b/generated/json-schema/bundle.json
iindex a03d4211..f59919bc 100644
---- a/generated/json-schema/bundle.json
++++ b/generated/json-schema/bundle.json
@@@ -11861,7 +11861,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/wiki/page-read-result.v1.json",
"title": "WikiPageReadResult",
-- "description": "wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread }; GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.",
++ "description": "wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread, blocks } (blocks is the revision's body as a publishing.block@1 tree, next to the Markdown in revision.body); GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox, blocks }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.",
"anyOf": [
{
"type": "object",
@@@ -11925,7 +11925,10 @@
}
}
},
-- "discussion_thread": {}
++ "discussion_thread": {},
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
++ }
}
},
{
@@@ -11958,7 +11961,10 @@
"$ref": "citation.v1.json"
}
},
-- "infobox": {}
++ "infobox": {},
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
++ }
}
},
{
@@@ -12043,7 +12049,7 @@
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://openvibe.network/contracts/wiki/page-write-request.v1.json",
"title": "WikiPageWriteRequest",
-- "description": "wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000). POST /api/v1/pages/:id/revisions: { expected_revision, body?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.",
++ "description": "wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body?, blocks?, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000; blocks is a publishing.block@1 tree and the API writes it back as the Markdown the revision keeps, so body and blocks are alternatives). POST /api/v1/pages/:id/revisions: { expected_revision, body?, blocks?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.",
"anyOf": [
{
"type": "object",
@@@ -12157,6 +12163,9 @@
"string",
"null"
]
++ },
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
}
}
},
@@@ -12264,6 +12273,9 @@
"string",
"null"
]
++ },
++ "blocks": {
++ "$ref": "../publishing/block.v1.json"
}
}
},
@@@ -12607,6 +12619,391 @@
]
}
},
++ "wiki.images-suggest-request": {
++ "version": "1.0.0",
++ "owner": "wiki",
++ "status": "active",
++ "schema": {
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/images-suggest-request.v1.json",
++ "title": "WikiImagesSuggestRequest",
++ "description": "wiki.images-suggest-request@1: the body of wiki.images.suggest on OpenVibe.Wiki (an editor of the space). POST /api/v1/pages/:id/images/suggest asks the wiki.article.images task for the article's lead picture and figures: Wikimedia Commons and Openverse first, keeping the licence and the author; then OpenVibe.Pics and the page's own Media; an AI illustration only when nothing real exists, never of a real person. Every field is optional; the path names the article.",
++ "type": "object",
++ "additionalProperties": false,
++ "properties": {
++ "query": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 300,
++ "description": "What to look for; defaults to the article's title and summary."
++ },
++ "section": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200,
++ "description": "A section heading the pictures should illustrate; omitted, the lead picture is suggested first."
++ },
++ "count": {
++ "type": "integer",
++ "minimum": 1,
++ "maximum": 12,
++ "description": "At most this many suggestions (default 8)."
++ },
++ "allow_ai": {
++ "type": "boolean",
++ "description": "Whether an illustration may be drawn when no real picture exists (default true; never for an article about a real person)."
++ },
++ "choice": {
++ "$ref": "../ai/choice.v1.json",
++ "description": "The search engine (search/commons, search/openverse, …) for the wiki.article.images task; the owner's or person's choice answers when omitted."
++ }
++ }
++ }
++ },
++ "wiki.images-suggest-result": {
++ "version": "1.0.0",
++ "owner": "wiki",
++ "status": "active",
++ "schema": {
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/images-suggest-result.v1.json",
++ "title": "WikiImagesSuggestResult",
++ "description": "wiki.images-suggest-result@1: what wiki.images.suggest answers. Each suggestion says where a picture came from and keeps its licence and author (Commons and Openverse), the OpenVibe.Pics page and its uploader, the page's own Media object, or — only when nothing real exists and the subject is not a real person — an AI illustration labelled 'Illustration made with <model>'. A suggestion is a candidate, not an attachment: the editor chooses one, the file goes to Media, and only then does it become a page attachment.",
++ "type": "object",
++ "additionalProperties": false,
++ "required": [
++ "article_id",
++ "task",
++ "suggestions"
++ ],
++ "properties": {
++ "article_id": {
++ "type": "string",
++ "pattern": "^pg_[0-9A-HJKMNP-TV-Z]{26}$"
++ },
++ "task": {
++ "const": "wiki.article.images",
++ "description": "The AI task that found the pictures."
++ },
++ "query": {
++ "type": "string",
++ "maxLength": 300
++ },
++ "subject_is_person": {
++ "type": "boolean",
++ "description": "True when the article is about a real person: no AI illustration is suggested."
++ },
++ "run_id": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "note": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 300,
++ "description": "Why nothing more was suggested (no licensed picture found, the AI is not configured, the subject is a person)."
++ },
++ "suggestions": {
++ "type": "array",
++ "maxItems": 12,
++ "items": {
++ "type": "object",
++ "additionalProperties": false,
++ "required": [
++ "provider",
++ "role"
++ ],
++ "properties": {
++ "provider": {
++ "enum": [
++ "commons",
++ "openverse",
++ "pics",
++ "media",
++ "ai"
++ ]
++ },
++ "role": {
++ "enum": [
++ "lead",
++ "figure"
++ ]
++ },
++ "media_id": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "pattern": "^med_[0-9A-HJKMNP-TV-Z]{26}$",
++ "description": "Set for provider media, or once a chosen suggestion is in Media."
++ },
++ "url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 2048,
++ "description": "The picture file to fetch (https) or to show when Media already serves it."
++ },
++ "page_url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 2048,
++ "description": "The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object)."
++ },
++ "title": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 300
++ },
++ "author": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200,
++ "description": "The author or uploader, kept for the credit line."
++ },
++ "license": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "license_url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 2048
++ },
++ "width": {
++ "type": [
++ "integer",
++ "null"
++ ],
++ "minimum": 1
++ },
++ "height": {
++ "type": [
++ "integer",
++ "null"
++ ],
++ "minimum": 1
++ },
++ "alt": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 400
++ },
++ "caption": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 400
++ },
++ "credit": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 400,
++ "description": "The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image."
++ },
++ "ai": {
++ "type": "boolean"
++ },
++ "model": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "data_url": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 8000000,
++ "description": "An AI illustration's bytes as a data: URL when the provider returned no hosted URL."
++ }
++ }
++ }
++ }
++ }
++ }
++ },
++ "wiki.article-draft-request": {
++ "version": "1.0.0",
++ "owner": "wiki",
++ "status": "active",
++ "schema": {
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/article-draft-request.v1.json",
++ "title": "WikiArticleDraftRequest",
++ "description": "wiki.article-draft-request@1: the body of the wiki writer on OpenVibe.Wiki (an editor of the space). POST /api/v1/pages/:id/draft runs OpenVibe.AI's content.wiki workflow — research with web search plus the sources the article already cites, a citation on every sentence, and an infobox from structured facts — and files the result as a pending wiki proposal. It never publishes: a person approves it in the review queue.",
++ "type": "object",
++ "additionalProperties": false,
++ "properties": {
++ "instruction": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 4000,
++ "description": "What the editor wants written or improved."
++ },
++ "choice": {
++ "$ref": "../ai/choice.v1.json",
++ "description": "The model for the writer, from the same chip as every AI run."
++ }
++ }
++ }
++ },
++ "wiki.article-draft-result": {
++ "version": "1.0.0",
++ "owner": "wiki",
++ "status": "active",
++ "schema": {
++ "$schema": "https://json-schema.org/draft/2020-12/schema",
++ "$id": "https://openvibe.network/contracts/wiki/article-draft-result.v1.json",
++ "title": "WikiArticleDraftResult",
++ "description": "wiki.article-draft-result@1: what the wiki writer answers. The draft revision is pending review — status is always 'pending' — with the workflow and run that wrote it, the model that answered, and the sources its sentences cited. Nothing here is published.",
++ "type": "object",
++ "additionalProperties": false,
++ "required": [
++ "proposal",
++ "revision"
++ ],
++ "properties": {
++ "proposal": {
++ "type": "object",
++ "required": [
++ "id",
++ "page_id",
++ "status"
++ ],
++ "properties": {
++ "id": {
++ "type": "string"
++ },
++ "page_id": {
++ "type": "string"
++ },
++ "space_id": {
++ "type": "string"
++ },
++ "revision": {
++ "type": "integer",
++ "minimum": 1
++ },
++ "base_revision": {
++ "type": "integer",
++ "minimum": 0
++ },
++ "workflow_id": {
++ "type": "string"
++ },
++ "run_id": {
++ "type": "string"
++ },
++ "status": {
++ "const": "pending"
++ },
++ "proposed_by": {
++ "type": "string"
++ }
++ }
++ },
++ "revision": {
++ "$ref": "revision.v1.json"
++ },
++ "run_id": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "model": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "provider": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "sources": {
++ "type": "array",
++ "maxItems": 50,
++ "items": {
++ "type": "object",
++ "required": [
++ "url"
++ ],
++ "properties": {
++ "url": {
++ "type": "string",
++ "maxLength": 2048
++ },
++ "title": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 500
++ },
++ "author": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ },
++ "retrieved_at": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 40
++ },
++ "license": {
++ "type": [
++ "string",
++ "null"
++ ],
++ "maxLength": 200
++ }
++ }
++ }
++ }
++ }
++ }
++ },
"wiki.page": {
"version": "1.0.0",
"owner": "wiki",
ddiff --git a/generated/openapi/actor.json b/generated/openapi/actor.json
iindex c85f7598..308e7844 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.378.0",
-- "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Actor as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 b13c62ff..d9f9901a 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.378.0",
-- "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.AI as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 a9016cb2..7d4bae10 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.378.0",
-- "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Bench as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 46691e0a..a8cd12ed 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.378.0",
-- "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Billing as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 04fa6fa1..5c49dc23 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.378.0",
-- "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Blog as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 2b051428..c22b95f5 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.378.0",
-- "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Bot as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 89dbd070..3fb6df30 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.378.0",
-- "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Chat as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 7179a5e6..01620d83 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.378.0",
-- "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Codes as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 ca93837b..f3ab53eb 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.378.0",
-- "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Community as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 68c58409..631633dc 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.378.0",
-- "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe Connect as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 b4342275..7e1c2a1b 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.378.0",
-- "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Coupons as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 f9ec101e..0d2179da 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.378.0",
-- "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Deals as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 3e24a51f..55841a31 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.378.0",
-- "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Design as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 243a4b77..f1c7ab77 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.378.0",
-- "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Domains as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 b710327b..ff765a12 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.378.0",
-- "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Events as the OpenVibe contracts describe them (openvibe-contracts 0.379.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/exchange.json b/generated/openapi/exchange.json
iindex 65a2de7d..c4829ff1 100644
---- a/generated/openapi/exchange.json
++++ b/generated/openapi/exchange.json
@@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"title": "OpenVibe.Exchange API",
-- "version": "0.378.0",
-- "description": "Routes of OpenVibe.Exchange as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Exchange as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 aa489a26..ced71af3 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.378.0",
-- "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Food as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 2bb11368..c1cf3cdf 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.378.0",
-- "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Games as the OpenVibe contracts describe them (openvibe-contracts 0.379.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/git.json b/generated/openapi/git.json
iindex 40a9b87f..386a3f30 100644
---- a/generated/openapi/git.json
++++ b/generated/openapi/git.json
@@@ -3,8 +3,8 @@
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"info": {
"title": "OpenVibe.Git API",
-- "version": "0.378.0",
-- "description": "Routes of OpenVibe.Git as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Git as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 be8a1143..b01debbf 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.378.0",
-- "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Host as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 ce9d36cd..13e77325 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.378.0",
-- "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Inventory as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 23134f43..26e74073 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.378.0",
-- "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Live as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 ba519a84..d327d6ad 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.378.0",
-- "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Mail as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 6cdceb10..13bd69d1 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.378.0",
-- "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.MediaHub as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 a5693b3d..5f9e3965 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.378.0",
-- "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Media as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 2cea0d1e..bb0caa8c 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.378.0",
-- "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Network as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 cdea1807..fc77e3a7 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.378.0",
-- "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.News as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 11b47cb2..9faaa59c 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.378.0",
-- "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenRestream as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 830a22a6..2d8f2a90 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.378.0",
-- "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Play as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 f375dc6a..7526ae42 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.378.0",
-- "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Quest as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 42510f59..2c6f37cf 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.378.0",
-- "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Report as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 121e45ca..0a6c94f9 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.378.0",
-- "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Reviews as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 91574be5..b46b1cde 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.378.0",
-- "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Run as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 244d769f..ed809ded 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.378.0",
-- "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Search as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 29bb0122..07791207 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.378.0",
-- "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Services as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 592a326b..ce1bb4db 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.378.0",
-- "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Sources as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 228af9e8..83b19c99 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.378.0",
-- "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Space as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 4a60edf0..d5620316 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.378.0",
-- "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Tips as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 d850d0fc..a51c0188 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.378.0",
-- "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Today as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 16b88d7a..f73d1339 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.378.0",
-- "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Tools as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 b83d2c3a..8206d02e 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.378.0",
-- "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Trade as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 343e9e76..e36e5f56 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.378.0",
-- "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.VIP as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 73de08d5..f04183e1 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.378.0",
-- "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Vision as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 3c49e722..6c77f5cd 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.378.0",
-- "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Watch as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 97e3f562..322967e0 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.378.0",
-- "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Wiki as the OpenVibe contracts describe them (openvibe-contracts 0.379.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"
@@@ -1673,6 +1673,172 @@
}
}
},
++ "publishing.block.v1": {
++ "title": "PublishingBlock",
++ "description": "publishing.block@1: one rich content block, as openvibe-publishing/blocks parses a body. A body is Markdown plus blocks: the Markdown stays the source of truth (revisions diff it) and a block is a fenced directive (:::name{attr=\"value\"} ... :::). The parsed tree is plain JSON, so a product's API hands it out next to the Markdown. Every block has a plain-HTML form and renders server-side; images are Media object ids, never a URL a product invented. Blocks nest: a section holds its prose and its own blocks. The schema checks the first two levels of the tree strictly (a block and the block inside it); deeper levels are objects, because a body nests as deep as its author wrote it.",
++ "type": "object",
++ "required": [
++ "type"
++ ],
++ "properties": {
++ "type": {
++ "enum": [
++ "root",
++ "text",
++ "hero",
++ "section",
++ "figure",
++ "compare",
++ "gallery",
++ "clip",
++ "pic",
++ "video",
++ "embed",
++ "callout",
++ "stat",
++ "patchnotes",
++ "infobox",
++ "timeline",
++ "quote"
++ ],
++ "description": "root is the whole body; text is a run of Markdown; the rest are the blocks."
++ },
++ "attrs": {
++ "type": "object",
++ "description": "The attributes of the directive. Which ones a block takes is its own: hero (art, kicker, date), section (id, by, react), figure (src, alt, caption, credit, width, height), compare (before, after, caption), gallery (items, caption), clip (id), pic (id), video (id), embed (url), callout (tone, title), stat (value, label), patchnotes (from, to), infobox (title), timeline (title), quote (by). Unknown attributes are ignored.",
++ "additionalProperties": {
++ "type": [
++ "string",
++ "boolean",
++ "number",
++ "null"
++ ]
++ }
++ },
++ "value": {
++ "type": "string",
++ "maxLength": 200000,
++ "description": "A text node: Markdown, the words between the blocks."
++ },
++ "children": {
++ "type": "array",
++ "description": "The blocks and the prose inside this one. A section holds its prose and its own blocks.",
++ "items": {
++ "$ref": "#/components/schemas/publishing.block.v1/$defs/block"
++ }
++ }
++ },
++ "$defs": {
++ "block": {
++ "type": "object",
++ "required": [
++ "type"
++ ],
++ "properties": {
++ "type": {
++ "enum": [
++ "root",
++ "text",
++ "hero",
++ "section",
++ "figure",
++ "compare",
++ "gallery",
++ "clip",
++ "pic",
++ "video",
++ "embed",
++ "callout",
++ "stat",
++ "patchnotes",
++ "infobox",
++ "timeline",
++ "quote"
++ ],
++ "description": "root is the whole body; text is a run of Markdown; the rest are the blocks."
++ },
++ "attrs": {
++ "type": "object",
++ "description": "The attributes of the directive. Which ones a block takes is its own: hero (art, kicker, date), section (id, by, react), figure (src, alt, caption, credit, width, height), compare (before, after, caption), gallery (items, caption), clip (id), pic (id), video (id), embed (url), callout (tone, title), stat (value, label), patchnotes (from, to), infobox (title), timeline (title), quote (by). Unknown attributes are ignored.",
++ "additionalProperties": {
++ "type": [
++ "string",
++ "boolean",
++ "number",
++ "null"
++ ]
++ }
++ },
++ "value": {
++ "type": "string",
++ "maxLength": 200000,
++ "description": "A text node: Markdown, the words between the blocks."
++ },
++ "children": {
++ "type": "array",
++ "description": "The blocks and the prose inside this one. A section holds its prose and its own blocks.",
++ "items": {
++ "$ref": "#/components/schemas/publishing.block.v1/$defs/nested"
++ }
++ }
++ }
++ },
++ "nested": {
++ "type": "object",
++ "required": [
++ "type"
++ ],
++ "properties": {
++ "type": {
++ "enum": [
++ "root",
++ "text",
++ "hero",
++ "section",
++ "figure",
++ "compare",
++ "gallery",
++ "clip",
++ "pic",
++ "video",
++ "embed",
++ "callout",
++ "stat",
++ "patchnotes",
++ "infobox",
++ "timeline",
++ "quote"
++ ],
++ "description": "root is the whole body; text is a run of Markdown; the rest are the blocks."
++ },
++ "attrs": {
++ "type": "object",
++ "description": "The attributes of the directive. Which ones a block takes is its own: hero (art, kicker, date), section (id, by, react), figure (src, alt, caption, credit, width, height), compare (before, after, caption), gallery (items, caption), clip (id), pic (id), video (id), embed (url), callout (tone, title), stat (value, label), patchnotes (from, to), infobox (title), timeline (title), quote (by). Unknown attributes are ignored.",
++ "additionalProperties": {
++ "type": [
++ "string",
++ "boolean",
++ "number",
++ "null"
++ ]
++ }
++ },
++ "value": {
++ "type": "string",
++ "maxLength": 200000,
++ "description": "A text node: Markdown, the words between the blocks."
++ },
++ "children": {
++ "type": "array",
++ "description": "The blocks and the prose one level deeper.",
++ "items": {
++ "type": "object"
++ }
++ }
++ }
++ }
++ }
++ },
"wiki.citation-attach-request.v1": {
"title": "WikiCitationAttachRequest",
"description": "wiki.citation-attach-request@1: the body of POST /api/v1/pages/:id/revisions/:n/citations on OpenVibe.Wiki (wiki.citation.attach, editors): sources for the newest revision while it is unpublished (a published revision's sources are fixed: 409 citation.revision_published; an older one is 409 citation.not_head). A URL citation needs retrieved_at; a Sources item id brings its own URL, title and retrieval time.",
@@@ -1832,7 +1998,7 @@
},
"wiki.page-read-result.v1": {
"title": "WikiPageReadResult",
-- "description": "wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread }; GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.",
++ "description": "wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread, blocks } (blocks is the revision's body as a publishing.block@1 tree, next to the Markdown in revision.body); GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox, blocks }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.",
"anyOf": [
{
"type": "object",
@@@ -1896,7 +2062,10 @@
}
}
},
-- "discussion_thread": {}
++ "discussion_thread": {},
++ "blocks": {
++ "$ref": "#/components/schemas/publishing.block.v1"
++ }
}
},
{
@@@ -1929,7 +2098,10 @@
"$ref": "#/components/schemas/wiki.citation.v1"
}
},
-- "infobox": {}
++ "infobox": {},
++ "blocks": {
++ "$ref": "#/components/schemas/publishing.block.v1"
++ }
}
},
{
@@@ -2007,7 +2179,7 @@
},
"wiki.page-write-request.v1": {
"title": "WikiPageWriteRequest",
-- "description": "wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000). POST /api/v1/pages/:id/revisions: { expected_revision, body?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.",
++ "description": "wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body?, blocks?, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000; blocks is a publishing.block@1 tree and the API writes it back as the Markdown the revision keeps, so body and blocks are alternatives). POST /api/v1/pages/:id/revisions: { expected_revision, body?, blocks?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.",
"anyOf": [
{
"type": "object",
@@@ -2121,6 +2293,9 @@
"string",
"null"
]
++ },
++ "blocks": {
++ "$ref": "#/components/schemas/publishing.block.v1"
}
}
},
@@@ -2228,6 +2403,9 @@
"string",
"null"
]
++ },
++ "blocks": {
++ "$ref": "#/components/schemas/publishing.block.v1"
}
}
},
ddiff --git a/generated/openapi/work.json b/generated/openapi/work.json
iindex 91f752b4..f3492a11 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.378.0",
-- "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Work as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 72c644fd..14be45e6 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.378.0",
-- "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.378.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.379.0",
++ "description": "Routes of OpenVibe.Zone as the OpenVibe contracts describe them (openvibe-contracts 0.379.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 d258878a..4de3492c 100644
---- a/generated/typescript/index.d.ts
++++ b/generated/typescript/index.d.ts
@@@ -157457,7 +157457,7 @@ export interface WikiCitation {
/** [email protected] (owner: wiki) */
/**
-- * wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread }; GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.
++ * wiki.page-read-result@1: answers of wiki.page.read on OpenVibe.Wiki (pages the caller may read; others are 404). GET /api/v1/pages/:id[?revision=] → { page, revision, citations, infobox, attachments, links, indexability, discussion_thread, blocks } (blocks is the revision's body as a publishing.block@1 tree, next to the Markdown in revision.body); GET …/revisions?before=&limit= → { revisions } (without bodies; each says whether it is published, its citation count and any AI proposal); GET …/revisions/:n → { revision, citations, infobox, blocks }; GET …/diff?from=&to=&mode= → { diff }; GET …/revisions/:n/citations → { citations }; GET /api/v1/proposals/:id → { proposal }.
*/
export type WikiPageReadResult =
| {
@@@ -157476,6 +157476,7 @@ export type WikiPageReadResult =
reasons?: string[];
};
discussion_thread?: unknown;
++ blocks?: PublishingBlock;
}
| {
revisions: WikiRevision[];
@@@ -157484,6 +157485,7 @@ export type WikiPageReadResult =
revision: WikiRevision;
citations: WikiCitation[];
infobox?: unknown;
++ blocks?: PublishingBlock;
}
| {
diff: {};
@@@ -157506,7 +157508,7 @@ export type WikiPageReadResult =
/** [email protected] (owner: wiki) */
/**
-- * wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000). POST /api/v1/pages/:id/revisions: { expected_revision, body?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.
++ * wiki.page-write-request@1: bodies of wiki.page.create on OpenVibe.Wiki (editors of the space; a service acts for the person in X-OV-Subject). POST /api/v1/spaces/:space/pages: { title, body?, blocks?, summary?, infobox?, parent_id?, visibility?, citations?, message? } (title at most 200 characters, summary 300, body Markdown up to 200000; blocks is a publishing.block@1 tree and the API writes it back as the Markdown the revision keeps, so body and blocks are alternatives). POST /api/v1/pages/:id/revisions: { expected_revision, body?, blocks?, title?, summary?, infobox?, citations?, keep_citations?, message? } (expected_revision is the head you edited; a stale one is 412). PATCH /api/v1/pages/:id: { slug?, parent_id?, visibility?, noindex? } (visibility and noindex by an owner). POST /api/v1/pages/:id/media: { media_id, alt?, caption? } (a Media object the person can read, not private, ready). POST /api/v1/spaces/:space/import: { pages, publish?, on_existing?, source?, original_author?, ai_assisted? } (an owner; all or nothing; unknown keys refused). DELETE /api/v1/pages/:id and POST /api/v1/pages/:id/media/verify take no body.
*/
export type WikiPageWriteRequest =
| {
@@@ -157542,6 +157544,7 @@ export type WikiPageWriteRequest =
anchor?: string | null;
}[];
message?: string | null;
++ blocks?: PublishingBlock;
}
| {
expected_revision: number;
@@@ -157581,6 +157584,7 @@ export type WikiPageWriteRequest =
[k: string]: unknown | undefined;
};
message?: string | null;
++ blocks?: PublishingBlock;
}
| {
slug?: string;
@@@ -157715,6 +157719,3011 @@ export type WikiPageWriteResult =
}[];
};
++/** [email protected] (owner: wiki) */
++/**
++ * wiki.images-suggest-request@1: the body of wiki.images.suggest on OpenVibe.Wiki (an editor of the space). POST /api/v1/pages/:id/images/suggest asks the wiki.article.images task for the article's lead picture and figures: Wikimedia Commons and Openverse first, keeping the licence and the author; then OpenVibe.Pics and the page's own Media; an AI illustration only when nothing real exists, never of a real person. Every field is optional; the path names the article.
++ */
++export interface WikiImagesSuggestRequest {
++ /**
++ * What to look for; defaults to the article's title and summary.
++ */
++ query?: string | null;
++ /**
++ * A section heading the pictures should illustrate; omitted, the lead picture is suggested first.
++ */
++ section?: string | null;
++ /**
++ * At most this many suggestions (default 8).
++ */
++ count?: number;
++ /**
++ * Whether an illustration may be drawn when no real picture exists (default true; never for an article about a real person).
++ */
++ allow_ai?: boolean;
++ choice?: AiChoiceV1;
++}
++
++/** [email protected] (owner: wiki) */
++/**
++ * wiki.images-suggest-result@1: what wiki.images.suggest answers. Each suggestion says where a picture came from and keeps its licence and author (Commons and Openverse), the OpenVibe.Pics page and its uploader, the page's own Media object, or — only when nothing real exists and the subject is not a real person — an AI illustration labelled 'Illustration made with <model>'. A suggestion is a candidate, not an attachment: the editor chooses one, the file goes to Media, and only then does it become a page attachment.
++ */
++export interface WikiImagesSuggestResult {
++ article_id: string;
++ /**
++ * The AI task that found the pictures.
++ */
++ task: "wiki.article.images";
++ query?: string;
++ /**
++ * True when the article is about a real person: no AI illustration is suggested.
++ */
++ subject_is_person?: boolean;
++ run_id?: string | null;
++ /**
++ * Why nothing more was suggested (no licensed picture found, the AI is not configured, the subject is a person).
++ */
++ note?: string | null;
++ /**
++ * @maxItems 12
++ */
++ suggestions:
++ | []
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ]
++ | [
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ },
++ {
++ provider: "commons" | "openverse" | "pics" | "media" | "ai";
++ role: "lead" | "figure";
++ /**
++ * Set for provider media, or once a chosen suggestion is in Media.
++ */
++ media_id?: string | null;
++ /**
++ * The picture file to fetch (https) or to show when Media already serves it.
++ */
++ url?: string | null;
++ /**
++ * The picture's page at its source (Commons' file page, Openverse's result, the Pics picture, the Media object).
++ */
++ page_url?: string | null;
++ title?: string | null;
++ /**
++ * The author or uploader, kept for the credit line.
++ */
++ author?: string | null;
++ license?: string | null;
++ license_url?: string | null;
++ width?: number | null;
++ height?: number | null;
++ alt?: string | null;
++ caption?: string | null;
++ /**
++ * The line a figure shows: author, licence, or 'Illustration made with <model>' for an AI image.
++ */
++ credit?: string | null;
++ ai?: boolean;
++ model?: string | null;
++ /**
++ * An AI illustration's bytes as a data: URL when the provider returned no hosted URL.
++ */
++ data_url?: string | null;
++ }
++ ];
++}
++
++/** [email protected] (owner: wiki) */
++/**
++ * wiki.article-draft-request@1: the body of the wiki writer on OpenVibe.Wiki (an editor of the space). POST /api/v1/pages/:id/draft runs OpenVibe.AI's content.wiki workflow — research with web search plus the sources the article already cites, a citation on every sentence, and an infobox from structured facts — and files the result as a pending wiki proposal. It never publishes: a person approves it in the review queue.
++ */
++export interface WikiArticleDraftRequest {
++ /**
++ * What the editor wants written or improved.
++ */
++ instruction?: string | null;
++ choice?: AiChoiceV1;
++}
++
++/** [email protected] (owner: wiki) */
++/**
++ * wiki.article-draft-result@1: what the wiki writer answers. The draft revision is pending review — status is always 'pending' — with the workflow and run that wrote it, the model that answered, and the sources its sentences cited. Nothing here is published.
++ */
++export interface WikiArticleDraftResult {
++ proposal: {
++ id: string;
++ page_id: string;
++ space_id?: string;
++ revision?: number;
++ base_revision?: number;
++ workflow_id?: string;
++ run_id?: string;
++ status: "pending";
++ proposed_by?: string;
++ };
++ revision: WikiRevision;
++ run_id?: string | null;
++ model?: string | null;
++ provider?: string | null;
++ /**
++ * @maxItems 50
++ */
++ sources?: {
++ url: string;
++ title?: string | null;
++ author?: string | null;
++ retrieved_at?: string | null;
++ license?: string | null;
++ }[];
++}
++
/** [email protected] (owner: wiki) */
/**
* wiki.page@1: one wiki page as OpenVibe.Wiki's API shows it (server/http/api.js serializePage); in a space's page tree each page also lists its children.
ddiff --git a/package-lock.json b/package-lock.json
iindex a7135c84..b04420af 100644
---- a/package-lock.json
++++ b/package-lock.json
@@@ -1,12 +1,12 @@
{
"name": "openvibe-contracts",
-- "version": "0.378.0",
++ "version": "0.379.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "openvibe-contracts",
-- "version": "0.378.0",
++ "version": "0.379.0",
"license": "AGPL-3.0-only",
"dependencies": {
"ajv": "^8.17.1",
ddiff --git a/package.json b/package.json
iindex b622292e..4a4c0930 100644
---- a/package.json
++++ b/package.json
@@@ -1,6 +1,6 @@
{
"name": "openvibe-contracts",
-- "version": "0.378.0",
++ "version": "0.379.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",