lexrpc 2.1__tar.gz → 2.2__tar.gz

{lexrpc-2.1 → lexrpc-2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lexrpc
-Version: 2.1
+Version: 2.2
 Summary: Python implementation of AT Protocol's XRPC + Lexicon
 Author-email: Ryan Barrett <lexrpc@ryanb.org>
 Project-URL: Homepage, https://github.com/snarfed/lexrpc
@@ -12,20 +12,25 @@ Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 Classifier: Development Status :: 3 - Alpha
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.7
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: dag-cbor
+Requires-Dist: dag-cbor>=0.3
 Requires-Dist: dag-json>=0.3
-Requires-Dist: grapheme
-Requires-Dist: iterators
-Requires-Dist: libipld<4.0.0
+Requires-Dist: grapheme>=0.6.0
+Requires-Dist: iterators>=0.2.0
+Requires-Dist: libipld<4.0.0,>=3.0.0
 Requires-Dist: multiformats>=0.3.1.post4
 Requires-Dist: requests>=2.0
-Requires-Dist: simple-websocket
+Requires-Dist: simple-websocket>=0.10.0
 Provides-Extra: flask
 Requires-Dist: Flask>=2.0; extra == "flask"
-Requires-Dist: flask-sock; extra == "flask"
+Requires-Dist: flask-sock>=0.6.0; extra == "flask"
+Requires-Dist: werkzeug>=2.0; extra == "flask"
+Requires-Dist: wsproto>=1.0; extra == "flask"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=3.0.0; extra == "docs"
 Dynamic: license-file
 
 lexrpc [![Circle CI](https://circleci.com/gh/snarfed/lexrpc.svg?style=svg)](https://circleci.com/gh/snarfed/lexrpc) [![Coverage Status](https://coveralls.io/repos/github/snarfed/lexrpc/badge.svg?branch=main)](https://coveralls.io/github/snarfed/lexrpc?branch=master)
@@ -176,25 +181,26 @@ Here's how to package, test, and ship a new release.
     ```
 1. Run the unit tests.
     ```sh
-    source local/bin/activate.csh
+    source .venv/bin/activate.csh
     python -m unittest discover
     ```
 1. Bump the version number in `pyproject.toml` and `docs/conf.py`. `git grep` the old version number to make sure it only appears in the changelog. Change the current changelog entry in `README.md` for this new version from _unreleased_ to the current date.
 1. Build the docs. If you added any new modules, add them to the appropriate file(s) in `docs/source/`. Then run `./docs/build.sh`. Check that the generated HTML looks fine by opening `docs/_build/html/index.html` and looking around.
-1. `git commit -am 'release vX.Y'`
+1. ```sh
+   setenv ver X.Y
+   git commit -am "release v$ver"
+   ```
 1. Upload to [test.pypi.org](https://test.pypi.org/) for testing.
     ```sh
-    python -m build
-    setenv ver X.Y
-    twine upload -r pypitest dist/lexrpc-$ver*
+    uv build
+    twine upload -r pypitest dist/lexrpc-$ver.tar.gz dist/lexrpc-$ver-py3-none-any.whl
     ```
 1. Install from test.pypi.org.
     ```sh
     cd /tmp
-    python -m venv local
-    source local/bin/activate.csh
+    python -m venv .venv
+    source .venv/bin/activate.csh
     pip uninstall lexrpc # make sure we force pip to use the uploaded version
-    pip install --upgrade pip
     pip install -i https://test.pypi.org/simple --extra-index-url https://pypi.org/simple lexrpc==$ver
     ```
 1. Smoke test that the code trivially loads and runs.
@@ -248,6 +254,24 @@ Here's how to package, test, and ship a new release.
 
 ## Changelog
 
+### 2.2 - 2026-06-29
+
+* Schema validation:
+  * Fix crash (`KeyError`) when validating a `blob` value inside an open union; now raises `ValidationError` for invalid blob refs.
+* `client`:
+  * For websocket event streams, close the websocket connection when a non-`ConnectionClosed` exception is raised.
+  * Use the lexicon method's `input.encoding` as the `Content-Type` request header.
+  * `Client.__init__`: new `requests_session` kwarg, an optional :class:`requests.Session` to use for HTTP requests.
+* `server`:
+  * `Server.call`: unknown parameters not in the lexicon are now silently ignored instead of raising `ValidationError`. [Background.](https://github.com/bluesky-social/atproto/discussions/5094)
+* `flask_server`:
+  * Close websocket connections with reason 1011 for unknown/not implemented endpoint NSIDs.
+* Update bundled lexicons:
+  * Bluesky PBC's (`app.bsky.*` etc) at [cf4843c](https://github.com/bluesky-social/atproto/commit/cf4843c339396e98fc0191b5c7ccf8db2e48da5b)
+  * [`site.standard.*`](https://standard.site/) at [549453e](https://tangled.org/standard.site/lexicons/commit/549453e37a4e15e8318f5b7655b230d0925b9e02)
+  * [`lexicon.community.*`](https://lexicon.community/) at [91c50cb](https://github.com/lexicon-community/lexicon/commit/91c50cbd84a9da8014332a6e37812c276889c8ac)
+
+
 ### 2.1 - 2026-02-06
 
 * Bundle new lexicons:

lexrpc-2.1/lexrpc.egg-info/PKG-INFO → lexrpc-2.2/README.md

@@ -1,33 +1,3 @@
-Metadata-Version: 2.4
-Name: lexrpc
-Version: 2.1
-Summary: Python implementation of AT Protocol's XRPC + Lexicon
-Author-email: Ryan Barrett <lexrpc@ryanb.org>
-Project-URL: Homepage, https://github.com/snarfed/lexrpc
-Project-URL: Documentation, https://lexrpc.readthedocs.io/
-Keywords: XRPC,Lexicon,AT Protocol,ATP
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: Public Domain
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: Developers
-Classifier: Development Status :: 3 - Alpha
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: dag-cbor
-Requires-Dist: dag-json>=0.3
-Requires-Dist: grapheme
-Requires-Dist: iterators
-Requires-Dist: libipld<4.0.0
-Requires-Dist: multiformats>=0.3.1.post4
-Requires-Dist: requests>=2.0
-Requires-Dist: simple-websocket
-Provides-Extra: flask
-Requires-Dist: Flask>=2.0; extra == "flask"
-Requires-Dist: flask-sock; extra == "flask"
-Dynamic: license-file
-
 lexrpc [![Circle CI](https://circleci.com/gh/snarfed/lexrpc.svg?style=svg)](https://circleci.com/gh/snarfed/lexrpc) [![Coverage Status](https://coveralls.io/repos/github/snarfed/lexrpc/badge.svg?branch=main)](https://coveralls.io/github/snarfed/lexrpc?branch=master)
 ===
 
@@ -176,25 +146,26 @@ Here's how to package, test, and ship a new release.
     ```
 1. Run the unit tests.
     ```sh
-    source local/bin/activate.csh
+    source .venv/bin/activate.csh
     python -m unittest discover
     ```
 1. Bump the version number in `pyproject.toml` and `docs/conf.py`. `git grep` the old version number to make sure it only appears in the changelog. Change the current changelog entry in `README.md` for this new version from _unreleased_ to the current date.
 1. Build the docs. If you added any new modules, add them to the appropriate file(s) in `docs/source/`. Then run `./docs/build.sh`. Check that the generated HTML looks fine by opening `docs/_build/html/index.html` and looking around.
-1. `git commit -am 'release vX.Y'`
+1. ```sh
+   setenv ver X.Y
+   git commit -am "release v$ver"
+   ```
 1. Upload to [test.pypi.org](https://test.pypi.org/) for testing.
     ```sh
-    python -m build
-    setenv ver X.Y
-    twine upload -r pypitest dist/lexrpc-$ver*
+    uv build
+    twine upload -r pypitest dist/lexrpc-$ver.tar.gz dist/lexrpc-$ver-py3-none-any.whl
     ```
 1. Install from test.pypi.org.
     ```sh
     cd /tmp
-    python -m venv local
-    source local/bin/activate.csh
+    python -m venv .venv
+    source .venv/bin/activate.csh
     pip uninstall lexrpc # make sure we force pip to use the uploaded version
-    pip install --upgrade pip
     pip install -i https://test.pypi.org/simple --extra-index-url https://pypi.org/simple lexrpc==$ver
     ```
 1. Smoke test that the code trivially loads and runs.
@@ -248,6 +219,24 @@ Here's how to package, test, and ship a new release.
 
 ## Changelog
 
+### 2.2 - 2026-06-29
+
+* Schema validation:
+  * Fix crash (`KeyError`) when validating a `blob` value inside an open union; now raises `ValidationError` for invalid blob refs.
+* `client`:
+  * For websocket event streams, close the websocket connection when a non-`ConnectionClosed` exception is raised.
+  * Use the lexicon method's `input.encoding` as the `Content-Type` request header.
+  * `Client.__init__`: new `requests_session` kwarg, an optional :class:`requests.Session` to use for HTTP requests.
+* `server`:
+  * `Server.call`: unknown parameters not in the lexicon are now silently ignored instead of raising `ValidationError`. [Background.](https://github.com/bluesky-social/atproto/discussions/5094)
+* `flask_server`:
+  * Close websocket connections with reason 1011 for unknown/not implemented endpoint NSIDs.
+* Update bundled lexicons:
+  * Bluesky PBC's (`app.bsky.*` etc) at [cf4843c](https://github.com/bluesky-social/atproto/commit/cf4843c339396e98fc0191b5c7ccf8db2e48da5b)
+  * [`site.standard.*`](https://standard.site/) at [549453e](https://tangled.org/standard.site/lexicons/commit/549453e37a4e15e8318f5b7655b230d0925b9e02)
+  * [`lexicon.community.*`](https://lexicon.community/) at [91c50cb](https://github.com/lexicon-community/lexicon/commit/91c50cbd84a9da8014332a6e37812c276889c8ac)
+
+
 ### 2.1 - 2026-02-06
 
 * Bundle new lexicons:

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/base.py

@@ -6,7 +6,7 @@ import json
 import logging
 import re
 import string
-from urllib.parse import urlencode, urljoin, urlparse
+from urllib.parse import urlencode, urlparse
 
 import grapheme
 from multiformats import CID
@@ -55,7 +55,7 @@ BLOB_DEF = {
         'required': ['ref', 'mimeType', 'size'],
         'properties': {
             'ref': {
-                'type': 'ref',
+                'type': 'cid-link',
             },
             'mimeType': {
                 'type': 'string',
@@ -293,7 +293,10 @@ class Base():
 
         def get_schema(lex_name):
             """Returns (fully qualified lexicon name, lexicon) tuple."""
-            schema_name = urljoin(lexicon, lex_name)
+            if lex_name.startswith('#'):
+                schema_name = lexicon.split('#')[0] + lex_name
+            else:
+                schema_name = lex_name
             schema = self._get_def(schema_name)
             if schema.get('type') == 'record':
                 schema = schema.get('record')
@@ -379,10 +382,11 @@ class Base():
 
         if type_ == 'union':
             if isinstance(val, dict):
-                inner_type = val.get('$type')
-                if not inner_type and name != 'message':
-                    # event stream subscription messages (payloads) don't require
-                    # $type, it's in the header
+                if not (inner_type := val.get('$type')):
+                    if name == 'message':
+                        # event stream subscription messages (payloads) don't
+                        # require $type, it's in the header
+                        return
                     fail('missing $type')
             elif isinstance(val, str):
                 inner_type = val
@@ -390,7 +394,7 @@ class Base():
                 fail("is invalid")
 
             if schema.get('closed'):
-                refs = [urljoin(lexicon, ref) for ref in schema['refs']]
+                refs = [get_schema(ref)[0] for ref in schema['refs']]
                 if inner_type not in refs:
                     fail(f"{inner_type} isn't one of {refs}")
 

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/client.py

@@ -70,12 +70,14 @@ class Client(Base):
       address (str): base URL of XRPC server, eg ``https://bsky.social/``
       session (dict): ``createSession`` response with ``accessJwt``,
         `refreshJwt``, ``handle``, and ``did``
-      requests_kwargs (dict): passed to :func:`requests.get`/:func:`requests.post`
+      requests_kwargs (dict): passed to :func:`requests.Session.get` /
+        :func:`requests.Session.post`
+      requests_session (requests.Session): HTTP session to use for requests
     """
 
     def __init__(self, address=None, access_token=None, refresh_token=None,
                  session_callback=None, lexicons=None, validate=True, truncate=False,
-                 **requests_kwargs):
+                 requests_session=None, **requests_kwargs):
         """Constructor.
 
         Args:
@@ -96,9 +98,12 @@ class Client(Base):
             and output bodies
           truncate (bool): whether to truncate string values that are longer
             than their ``maxGraphemes`` or ``maxLength`` in their lexicon
-          requests_kwargs: passed to :func:`requests.get`/:func:`requests.post`, eg
-            ``auth`` (:class:`requests.auth.AuthBase`), ``headers`` (dict),
-            ``timeout`` (int, seconds), etc.
+          requests_session (requests.Session): optional HTTP session to use for
+            requests. Defaults to a new :class:`requests.Session`.
+          requests_kwargs: passed to :func:`requests.Session.get` /
+            :func:`requests.Session.post`, eg ``auth``
+            (:class:`requests.auth.AuthBase`), ``headers`` (dict), ``timeout``
+            (int seconds), etc.
 
         Raises:
           ValidationError: if any lexicon schema is invalid
@@ -115,6 +120,7 @@ class Client(Base):
             self.address = DEFAULT_PDS
         # logger.debug(f'Using server at {address}')
 
+        self.requests_session = requests_session or requests.Session()
         self.requests_kwargs = copy.copy(requests_kwargs)
         headers = self.requests_kwargs.setdefault('headers', {})
         for name, val in DEFAULT_HEADERS.items():
@@ -169,13 +175,15 @@ class Client(Base):
         params = self.validate(nsid, 'parameters', params)
         params_str = self.encode_params(params)
 
-        type = self._get_def(nsid)['type']
+        lexicon = self._get_def(nsid)
+        type = lexicon['type']
         if type == 'subscription':
             input = self.validate(nsid, 'input', input)
 
         requests_kwargs = copy.copy(self.requests_kwargs)
+        content_type = lexicon.get('input', {}).get('encoding', 'application/json')
         headers = {
-            'Content-Type': 'application/json',
+            'Content-Type': content_type,
             **requests_kwargs.pop('headers'),
             **headers,
         }
@@ -196,7 +204,8 @@ class Client(Base):
             return self._subscribe(url, nsid, decode=decode)
 
         # query or procedure
-        fn = requests.get if type == 'query' else requests.post
+        fn = (self.requests_session.get if type == 'query'
+              else self.requests_session.post)
 
         # buffer binary inputs in memory. ideally we'd stream instead, but if we
         # have to refresh our token below, we need to seek the stream back to the
@@ -204,7 +213,7 @@ class Client(Base):
         if isinstance(input, IOBase) or hasattr(input, 'read'):
             input = input.read()
 
-        logger.debug(f'requests.{getattr(fn, "__name__", fn)} {url} {params_str} {self.loggable(input)} {headers} {requests_kwargs}')
+        logger.debug(f'requests.{"get" if type == "query" else "post"} {url} {params_str} {self.loggable(input)} {headers} {requests_kwargs}')
 
         if auth := requests_kwargs.get('auth'):
             orig_token = getattr(auth, 'token', None)
@@ -276,7 +285,7 @@ class Client(Base):
           ValidationError: if ``decode`` is True and an output payload doesn't
             validate gainst the subscription method's lexicon
         """
-        ws = simple_websocket.Client(url, headers={
+        ws = simple_websocket.Client.connect(url, headers={
             **DEFAULT_HEADERS,
             **self.requests_kwargs.get('headers', {}),
         })
@@ -292,3 +301,6 @@ class Client(Base):
                     yield msg
         except simple_websocket.ConnectionClosed as cc:
             logger.debug(cc)
+        finally:
+            if ws.connected:
+                ws.close()

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/flask_server.py

@@ -168,7 +168,7 @@ def subscription(xrpc_server, nsid, limit_ips=False):
                 continue
 
             header, payload = result
-            # TODO: validate header, payload?
+            # payload was validated in Server.call; header has no schema
 
             # log
             seq = payload.get('seq')
@@ -218,6 +218,11 @@ def subscription(xrpc_server, nsid, limit_ips=False):
 
         try:
             handle(ws)
+        except NotImplementedError as e:
+            msg = str(e)
+            logger.info(msg)
+            # WebSocket closure code 1011 is for "unexpected conditions"
+            ws.close(reason=1011, message=msg)
         finally:
             # ideally I'd use Flask's after_this_request instead, but it doesn't
             # guarantee that it'll run if the request raises an uncaught

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/lexicons/app/bsky/actor/defs.json

@@ -160,6 +160,10 @@
         "allowIncoming": {
           "type": "string",
           "knownValues": ["all", "none", "following"]
+        },
+        "allowGroupInvites": {
+          "type": "string",
+          "knownValues": ["all", "none", "following"]
         }
       }
     },
@@ -265,6 +269,15 @@
           "description": "The user who issued this verification.",
           "format": "did"
         },
+        "issuerDisplayName": {
+          "type": "string",
+          "description": "The display name of the issuer."
+        },
+        "issuerHandle": {
+          "type": "string",
+          "description": "The handle of the issuer.",
+          "format": "handle"
+        },
         "uri": {
           "type": "string",
           "description": "The AT-URI of the verification record.",
@@ -685,6 +698,10 @@
           "description": "An optional embed associated with the status.",
           "refs": ["app.bsky.embed.external#view"]
         },
+        "labels": {
+          "type": "array",
+          "items": { "type": "ref", "ref": "com.atproto.label.defs#label" }
+        },
         "expiresAt": {
           "type": "string",
           "description": "The date when this status will expire. The application might choose to no longer return the status after expiration.",

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/lexicons/app/bsky/actor/getSuggestions.json

@@ -33,6 +33,10 @@
             },
             "recId": {
               "type": "integer",
+              "description": "DEPRECATED: use recIdStr instead."
+            },
+            "recIdStr": {
+              "type": "string",
               "description": "Snowflake for this recommendation, use when submitting recommendation events."
             }
           }

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/lexicons/app/bsky/authViewAll.json

@@ -14,6 +14,7 @@
           "resource": "rpc",
           "inheritAud": true,
           "lxm": [
+            "app.bsky.actor.getPreferences",
             "app.bsky.actor.getProfile",
             "app.bsky.actor.getProfiles",
             "app.bsky.actor.getSuggestions",

{lexrpc-2.1 → lexrpc-2.2}/lexrpc/lexicons/app/bsky/draft/defs.json

@@ -81,9 +81,9 @@
       "properties": {
         "text": {
           "type": "string",
-          "maxLength": 3000,
-          "maxGraphemes": 300,
-          "description": "The primary post content."
+          "maxLength": 10000,
+          "maxGraphemes": 1000,
+          "description": "The primary post content. It has a higher limit than post contents to allow storing a larger text that can later be refined into smaller posts."
         },
         "labels": {
           "type": "union",
@@ -95,6 +95,10 @@
           "items": { "type": "ref", "ref": "#draftEmbedImage" },
           "maxLength": 4
         },
+        "embedGallery": {
+          "type": "ref",
+          "ref": "#draftEmbedGallery"
+        },
         "embedVideos": {
           "type": "array",
           "items": { "type": "ref", "ref": "#draftEmbedVideo" },
@@ -167,6 +171,22 @@
       }
     },
 
+    "draftEmbedGallery": {
+      "type": "object",
+      "required": ["items"],
+      "properties": {
+        "items": {
+          "type": "ref",
+          "ref": "#draftEmbedGalleryItems"
+        }
+      }
+    },
+    "draftEmbedGalleryItems": {
+      "type": "array",
+      "items": { "type": "union", "refs": ["#draftEmbedImage"] },
+      "maxLength": 20,
+      "description": "The schema-level maxLength of 20 is a future-proof ceiling. Clients should currently enforce a soft limit of 10 items in authoring UIs."
+    },
     "draftEmbedImage": {
       "type": "object",
       "required": ["localRef"],

lexrpc-2.2/lexrpc/lexicons/app/bsky/embed/external.json

@@ -0,0 +1,149 @@
+{
+  "lexicon": 1,
+  "id": "app.bsky.embed.external",
+  "defs": {
+    "main": {
+      "type": "object",
+      "description": "A representation of some externally linked content (eg, a URL and 'card'), embedded in a Bluesky record (eg, a post).",
+      "required": ["external"],
+      "properties": {
+        "external": {
+          "type": "ref",
+          "ref": "#external"
+        }
+      }
+    },
+    "external": {
+      "type": "object",
+      "required": ["uri", "title", "description"],
+      "properties": {
+        "uri": { "type": "string", "format": "uri" },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "thumb": {
+          "type": "blob",
+          "accept": ["image/*"],
+          "maxSize": 1000000
+        },
+        "associatedRefs": {
+          "type": "array",
+          "items": {
+            "type": "ref",
+            "ref": "com.atproto.repo.strongRef"
+          },
+          "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view."
+        }
+      }
+    },
+    "view": {
+      "type": "object",
+      "required": ["external"],
+      "properties": {
+        "external": {
+          "type": "ref",
+          "ref": "#viewExternal"
+        }
+      }
+    },
+    "viewExternal": {
+      "type": "object",
+      "required": ["uri", "title", "description"],
+      "properties": {
+        "uri": { "type": "string", "format": "uri" },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "thumb": { "type": "string", "format": "uri" },
+        "createdAt": {
+          "type": "string",
+          "format": "datetime",
+          "description": "When the external content was created, if available. Example: a publication date, for an article."
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "datetime",
+          "description": "When the external content was updated, if available."
+        },
+        "readingTime": {
+          "type": "integer",
+          "description": "Estimated reading time in minutes, if applicable and available."
+        },
+        "labels": {
+          "type": "array",
+          "items": { "type": "ref", "ref": "com.atproto.label.defs#label" }
+        },
+        "source": { "type": "ref", "ref": "#viewExternalSource" },
+        "associatedRefs": {
+          "type": "array",
+          "items": {
+            "type": "ref",
+            "ref": "com.atproto.repo.strongRef"
+          },
+          "description": "StrongRefs (uri+cid) of the Atmosphere records that backed this view."
+        },
+        "associatedProfiles": {
+          "type": "array",
+          "items": {
+            "type": "ref",
+            "ref": "app.bsky.actor.defs#profileViewBasic"
+          },
+          "description": "Profiles of the owners of the Atmosphere records that backed this view."
+        }
+      }
+    },
+    "viewExternalSource": {
+      "type": "object",
+      "description": "The source of an external embed, such as a standard.site publication.",
+      "required": ["uri", "title"],
+      "properties": {
+        "uri": {
+          "type": "string",
+          "format": "uri",
+          "description": "URI of the source, if available. Example: the https:// URL of a site.standard.publication record."
+        },
+        "icon": {
+          "type": "string",
+          "format": "uri",
+          "description": "Fully-qualified URL where an icon representing the source can be fetched. For example, CDN location provided by the App View."
+        },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "theme": {
+          "type": "ref",
+          "ref": "#viewExternalSourceTheme"
+        }
+      }
+    },
+    "viewExternalSourceTheme": {
+      "type": "object",
+      "description": "The theme colors of an external source, such as a site.standard.publication. These colors may be used when rendering an embed from that source.",
+      "properties": {
+        "backgroundRGB": {
+          "type": "ref",
+          "ref": "#colorRGB"
+        },
+        "foregroundRGB": {
+          "type": "ref",
+          "ref": "#colorRGB"
+        },
+        "accentRGB": {
+          "type": "ref",
+          "ref": "#colorRGB"
+        },
+        "accentForegroundRGB": {
+          "type": "ref",
+          "ref": "#colorRGB"
+        }
+      }
+    },
+    "colorRGB": {
+      "type": "object",
+      "description": "RGB color definition, inspired by site.standard.theme.color#rgb",
+      "required": ["r", "g", "b"],
+      "properties": {
+        "r": { "type": "integer", "minimum": 0, "maximum": 255 },
+        "g": { "type": "integer", "minimum": 0, "maximum": 255 },
+        "b": { "type": "integer", "minimum": 0, "maximum": 255 }
+      }
+    }
+  }
+}