unitysvc-data 0.2.12__tar.gz → 0.2.14__tar.gz

{unitysvc_data-0.2.12/src/unitysvc_data.egg-info → unitysvc_data-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unitysvc-data
-Version: 0.2.12
+Version: 0.2.14
 Summary: Standard examples and presets for UnitySVC data packages
 Author-email: Bo Peng <bo.peng@unitysvc.com>
 Maintainer-email: Bo Peng <bo.peng@unitysvc.com>

{unitysvc_data-0.2.12 → unitysvc_data-0.2.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "unitysvc-data"
-version = "0.2.12"
+version = "0.2.14"
 description = "Standard examples and presets for UnitySVC data packages"
 readme = "README.md"
 authors = [{ name = "Bo Peng", email = "bo.peng@unitysvc.com" }]

{unitysvc_data-0.2.12 → unitysvc_data-0.2.14}/src/unitysvc_data/_manifest.json

@@ -99,7 +99,7 @@
     "llm_connectivity_tts": "llm_connectivity_tts_v1",
     "llm_connectivity_tts_dashscope": "llm_connectivity_tts_dashscope_v1",
     "llm_description": "llm_description_v2",
-    "llm_request_template": "llm_request_template_v3",
+    "llm_request_template": "llm_request_template_v4",
     "llm_request_template_embed": "llm_request_template_embed_v1",
     "llm_request_template_image_generate": "llm_request_template_image_generate_v1",
     "llm_request_template_image_text_to_text": "llm_request_template_image_text_to_text_v1",
@@ -134,6 +134,7 @@
     "msg_to_channel_code_example_py_flock": "msg_to_channel_code_example_py_flock_v1",
     "msg_to_channel_code_example_py_form_webhook": "msg_to_channel_code_example_py_form_webhook_v1",
     "msg_to_channel_code_example_py_freemobile": "msg_to_channel_code_example_py_freemobile_v1",
+    "msg_to_channel_code_example_py_googlechat": "msg_to_channel_code_example_py_googlechat_v1",
     "msg_to_channel_code_example_py_gotify": "msg_to_channel_code_example_py_gotify_v1",
     "msg_to_channel_code_example_py_groupme_msg": "msg_to_channel_code_example_py_groupme_msg_v1",
     "msg_to_channel_code_example_py_homeassistant": "msg_to_channel_code_example_py_homeassistant_v1",
@@ -228,6 +229,7 @@
     "msg_to_channel_code_example_sh_flock": "msg_to_channel_code_example_sh_flock_v1",
     "msg_to_channel_code_example_sh_form_webhook": "msg_to_channel_code_example_sh_form_webhook_v1",
     "msg_to_channel_code_example_sh_freemobile": "msg_to_channel_code_example_sh_freemobile_v1",
+    "msg_to_channel_code_example_sh_googlechat": "msg_to_channel_code_example_sh_googlechat_v1",
     "msg_to_channel_code_example_sh_gotify": "msg_to_channel_code_example_sh_gotify_v1",
     "msg_to_channel_code_example_sh_groupme_msg": "msg_to_channel_code_example_sh_groupme_msg_v1",
     "msg_to_channel_code_example_sh_homeassistant": "msg_to_channel_code_example_sh_homeassistant_v1",
@@ -322,6 +324,7 @@
     "msg_to_channel_connectivity_flock": "msg_to_channel_connectivity_flock_v1",
     "msg_to_channel_connectivity_form_webhook": "msg_to_channel_connectivity_form_webhook_v1",
     "msg_to_channel_connectivity_freemobile": "msg_to_channel_connectivity_freemobile_v1",
+    "msg_to_channel_connectivity_googlechat": "msg_to_channel_connectivity_googlechat_v1",
     "msg_to_channel_connectivity_gotify": "msg_to_channel_connectivity_gotify_v1",
     "msg_to_channel_connectivity_groupme_msg": "msg_to_channel_connectivity_groupme_msg_v1",
     "msg_to_channel_connectivity_homeassistant": "msg_to_channel_connectivity_homeassistant_v1",
@@ -3783,7 +3786,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template_embed",
       "source_readme": "llm/request-template-embed/README.md",
       "version": 1
@@ -3799,7 +3804,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template_image_generate",
       "source_readme": "llm/request-template-image-generate/README.md",
       "version": 1
@@ -3815,7 +3822,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template_image_text_to_text",
       "source_readme": "llm/request-template-image-text-to-text/README.md",
       "version": 1
@@ -3831,7 +3840,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template_moderate",
       "source_readme": "llm/request-template-moderate/README.md",
       "version": 1
@@ -3847,7 +3858,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template_rerank",
       "source_readme": "llm/request-template-rerank/README.md",
       "version": 1
@@ -3879,7 +3892,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template_text_to_speech",
       "source_readme": "llm/request-template-text-to-speech/README.md",
       "version": 1
@@ -3895,7 +3910,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template",
       "source_readme": "llm/request-template/README.md",
       "version": 1
@@ -3911,7 +3928,9 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template",
       "source_readme": "llm/request-template/README.md",
       "version": 2
@@ -3927,11 +3946,31 @@
       "is_public": true,
       "meta": {},
       "mime_type": "json",
-      "parameters": {},
+      "parameters": {
+        "version_prefix": "/v1"
+      },
       "preset_name": "llm_request_template",
       "source_readme": "llm/request-template/README.md",
       "version": 3
     },
+    "llm_request_template_v4": {
+      "applies_to": {
+        "capability": "chat"
+      },
+      "category": "request_template",
+      "description": "Minimal chat request body for each request format",
+      "example_file": "llm/request-template/request-template-v4.json",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "json",
+      "parameters": {
+        "version_prefix": "/v1"
+      },
+      "preset_name": "llm_request_template",
+      "source_readme": "llm/request-template/README.md",
+      "version": 4
+    },
     "llm_request_template_video_generate_v1": {
       "applies_to": {
         "capability": "video-generate"
@@ -4550,6 +4589,31 @@
       "source_readme": "msg-to-channel/code-example-py/README.md",
       "version": 1
     },
+    "msg_to_channel_code_example_py_googlechat_v1": {
+      "applies_to": {},
+      "category": "code_example",
+      "description": "Python (httpx) code example for gateway-transformer notification services",
+      "example_file": "msg-to-channel/code-example-py/code-example-googlechat-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "min_expected_metrics": {
+          "bytes_out": 1
+        },
+        "requirements": [
+          "httpx"
+        ]
+      },
+      "mime_type": "python",
+      "parameters": {
+        "channel": "gateway",
+        "local_url": "",
+        "native_body": "{}"
+      },
+      "preset_name": "msg_to_channel_code_example_py_googlechat",
+      "source_readme": "msg-to-channel/code-example-py/README.md",
+      "version": 1
+    },
     "msg_to_channel_code_example_py_gotify_v1": {
       "applies_to": {},
       "category": "code_example",
@@ -6837,6 +6901,28 @@
       "source_readme": "msg-to-channel/code-example-sh/README.md",
       "version": 1
     },
+    "msg_to_channel_code_example_sh_googlechat_v1": {
+      "applies_to": {},
+      "category": "code_example",
+      "description": "cURL code example for gateway-transformer notification services",
+      "example_file": "msg-to-channel/code-example-sh/code-example-googlechat-v1.sh.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "min_expected_metrics": {
+          "bytes_out": 1
+        }
+      },
+      "mime_type": "bash",
+      "parameters": {
+        "channel": "gateway",
+        "local_url": "",
+        "native_body": "{}"
+      },
+      "preset_name": "msg_to_channel_code_example_sh_googlechat",
+      "source_readme": "msg-to-channel/code-example-sh/README.md",
+      "version": 1
+    },
     "msg_to_channel_code_example_sh_gotify_v1": {
       "applies_to": {},
       "category": "code_example",
@@ -8905,6 +8991,28 @@
       "source_readme": "msg-to-channel/connectivity/README.md",
       "version": 1
     },
+    "msg_to_channel_connectivity_googlechat_v1": {
+      "applies_to": {},
+      "category": "connectivity_test",
+      "description": "Connectivity test for gateway-transformer notification services",
+      "example_file": "msg-to-channel/connectivity/connectivity-googlechat-v1.sh.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "min_expected_metrics": {
+          "bytes_out": 1
+        }
+      },
+      "mime_type": "bash",
+      "parameters": {
+        "channel": "gateway",
+        "local_url": "",
+        "native_body": "{}"
+      },
+      "preset_name": "msg_to_channel_connectivity_googlechat",
+      "source_readme": "msg-to-channel/connectivity/README.md",
+      "version": 1
+    },
     "msg_to_channel_connectivity_gotify_v1": {
       "applies_to": {},
       "category": "connectivity_test",

{unitysvc_data-0.2.12 → unitysvc_data-0.2.14}/src/unitysvc_data/examples/llm/request-template/README.md

@@ -7,6 +7,7 @@ description = "Minimal chat request body for each request format"
 is_active = true
 is_public = true
 applies_to = { capability = "chat" }
+parameters = { version_prefix = "/v1" }
 +++
 
 # llm / request-template — minimal chat payload, per request format
@@ -14,11 +15,13 @@ applies_to = { capability = "chat" }
 The default request body the Test Request playground offers for a chat
 service. One document covers one capability — this one is `chat`, as its
 `applies_to` says — and from v3 it is a **list of entries**, each naming the
-request format it is written in:
+request format it is written in and, from v4, the path it is sent to:
 
 ```json
-[ { "format": "openai",    "body": { "max_tokens": 100, "messages": [ … ] } },
-  { "format": "anthropic", "body": { "max_tokens": 100, "system": "…", "messages": [ … ] } } ]
+[ { "format": "openai", "path_suffix": "/v1/chat/completions",
+    "body": { "max_tokens": 100, "messages": [ … ] } },
+  { "format": "anthropic", "path_suffix": "/v1/messages",
+    "body": { "max_tokens": 100, "system": "…", "messages": [ … ] } } ]
 ```
 
 The playground picks the document by the service's capability and then the first
@@ -45,19 +48,68 @@ a service that declares it sees the playground's empty state. The claim is check
 against the examples (`tests/test_request_templates.py`), so it will say so when it
 stops being true.
 
-## Body (v3)
+## Body (v4)
 
-| `format`           | Wire shape                                     |
-|--------------------|------------------------------------------------|
-| `openai`           | OpenAI Chat Completions                        |
-| `anthropic`        | Anthropic Messages (`system` is top-level)     |
-| `cohere`           | Cohere v2 Chat (native `/v2/chat`)             |
-| `dashscope`        | DashScope native (`input.messages` + `parameters`) |
-| `bedrock_converse` | Bedrock Converse (content blocks, `inferenceConfig`) |
+| `format`           | Wire shape                                           | `path_suffix`                            |
+|--------------------|------------------------------------------------------|------------------------------------------|
+| `openai`           | OpenAI Chat Completions                              | `${__version_prefix__}/chat/completions` |
+| `anthropic`        | Anthropic Messages (`system` is top-level)           | `/v1/messages`                           |
+| `cohere`           | Cohere v2 Chat                                       | none (SDK owns the path)                 |
+| `dashscope`        | DashScope native (`input.messages` + `parameters`)   | none (bare base URL)                     |
+| `bedrock_converse` | Bedrock Converse (content blocks, `inferenceConfig`) | none (known limitation)                  |
 
 Every entry says the same thing: system prompt "You are a helpful
 assistant.", user prompt "Say hello in one sentence.", at most 100 tokens.
 
+## Path
+
+Each `path_suffix` is what a code example for that entry's format posts to,
+relative to the service's base URL. It is read off the example, and the examples
+for a format agree among themselves (the OpenAI entry's requests, shell and
+JavaScript variants all say `/chat/completions` after the prefix), rather than
+written from an API's documentation. `tests/test_request_templates.py` re-derives
+every one.
+
+`${__version_prefix__}` is the parameter the OpenAI-shaped examples use for the
+one segment a seller's upstream may move: `/v1` by default, `/compatibility/v1`
+for Cohere's compatibility surface, `/v2` for crofai, nothing for the platform's
+own facades. This family declares it with the example's default, so a listing that
+sets `params.version_prefix` for its examples gets the matching path here, and one
+that sets nothing gets `/v1`. A listing that differs in any other way can replace
+the document by title (a sibling key beside `$llm_example_collection`).
+
+`/v1/messages` carries no prefix, and that is the point rather than an omission.
+The path is a function of the capability and the format the *customer* speaks, and a
+translated format shows it: `llm_code_example_anthropic_to_openai_requests` calls
+the OpenAI upstream at `${__version_prefix__}/chat/completions` only under
+`local_testing`, while a customer calls the gateway at the literal `/v1/messages`
+and the gateway translates, whatever the upstream's layout. Only a request the
+gateway proxies without translating, an OpenAI-format one to an OpenAI-compatible
+upstream, continues into the seller's own path, which is why that one segment is a
+parameter.
+
+Three entries have no `path_suffix`, for three different reasons:
+
+- **`dashscope` posts to the bare service URL.** Every client variant of its example
+  posts to the service URL itself, so there is nothing to append and the key is
+  omitted. The page treats a missing or blank `path_suffix` as absent and appends
+  nothing, which is exactly that; writing `""` would add nothing, and `"/"` would
+  append a trailing slash, a different request.
+- **`cohere`'s example hands the base URL to the SDK**, which appends the path
+  itself, so no example states it, and the playground's own format registry already
+  carries the native Cohere chat path. The entry needs no key of its own.
+- **Known limitation: `bedrock_converse`.** Its path carries the model id, and the
+  right value varies by service inside this one entry: a native-runtime interface
+  already carries `/model/<modelId>` in its URL, so a literal `/converse` would do,
+  while a shared provider path builds `<service URL>-runtime/model/<modelId>/converse`
+  (the example has both branches). A `path_suffix` is one string per capability and
+  format, so it cannot say "it depends on the service", and the page merges `model`
+  into the body rather than substituting inside the path. That is a gap in the
+  contract (unitysvc/unitysvc#2514, noted on #2516), not an oversight and not
+  something a template can work around, so no substitution syntax is invented here.
+  The Hugging Face entries in the `embed` and `video-generate` families are the same
+  limitation.
+
 ## What's intentionally missing
 
 - **No `model` field.** The gateway's routing config or the listing's
@@ -95,7 +147,27 @@ assistant.", user prompt "Say hello in one sentence.", at most 100 tokens.
 
 ## Versions
 
-### v3 — an entry list
+### v4 — a path for each entry
+
+- Entries gained `path_suffix`: `openai` and `anthropic` have one, read off their
+  examples; `cohere`, `dashscope` and `bedrock_converse` do not, each for the reason
+  under Path. The bodies, the formats and their order are v3's, and a test pins that.
+- **A new version, not an amendment of v3.** CONTRIBUTING's "one exception" needs
+  the old behaviour to be gone, and chat's is not: the playground falls back to the
+  format's own default path for a chat request, so a template without paths works on
+  every service whose OpenAI surface is at `/v1`. v3 stays exactly as published, with
+  no paths, for a listing that pins it. (The eight sibling families were amended in
+  place instead: a template for a non-chat capability without a path cannot be sent,
+  so their v1 had nothing working to pin to.)
+- The front-matter gained `parameters = { version_prefix = "/v1" }`. It is shared by
+  every version of the family, but v1 to v3 contain no placeholder, so their content
+  is byte-identical; only the record's `file_path` now points at a per-process copy,
+  as for any preset that declares parameters.
+- `llm_request_template` resolves to v4. Needs nothing of the page: it ignores keys
+  it does not read, so data and page can ship in either order, and a page that reads
+  `path_suffix` falls back to today's behaviour for an entry that has none.
+
+### v3 — an entry list (superseded by v4)
 
 - A list of `{"format", "body"}` entries instead of a dict keyed by format. The
   bodies are v2's, key for key and in the same order; only the packaging moved.
@@ -105,8 +177,9 @@ assistant.", user prompt "Say hello in one sentence.", at most 100 tokens.
   matches, so a repeated format would be silently unreachable — which
   `tools/build.py` now refuses.
 - The title, `applies_to` and preset name are unchanged, so this is the same
-  document on every published service: `llm_request_template` resolves to v3 and
-  re-uploading a catalog replaces the body in place.
+  document on every published service: `llm_request_template` resolved to v3 in
+  0.2.12 (it resolves to v4 from 0.2.13) and re-uploading a catalog replaces the body
+  in place.
 - Needs a playground that reads entry lists (unitysvc/unitysvc#2515). That page
   reads both shapes, so data and page can ship in either order **only because
   of that** — an older page shows a list as the raw request body.
@@ -126,8 +199,9 @@ assistant.", user prompt "Say hello in one sentence.", at most 100 tokens.
   An older one shows the whole map as the body.
 - **Retired, not removed.** Versions are append-only, so the file stays and
   `llm_request_template_v2` still resolves for a listing that pins it; none of
-  the `unitysvc-services-*` repos does. The version-less alias moved to v3, which
-  is all that `llm_example_collection` ever resolves, so nothing generated serves v2.
+  the `unitysvc-services-*` repos does. The version-less alias has moved on (v3,
+  now v4), which is all that `llm_example_collection` ever resolves, so nothing
+  generated serves v2.
 
 ### v1 — initial release
 

unitysvc_data-0.2.14/src/unitysvc_data/examples/llm/request-template/request-template-v4.json

@@ -0,0 +1,93 @@
+[
+  {
+    "format": "openai",
+    "path_suffix": "${__version_prefix__}/chat/completions",
+    "body": {
+      "max_tokens": 100,
+      "messages": [
+        {
+          "role": "system",
+          "content": "You are a helpful assistant."
+        },
+        {
+          "role": "user",
+          "content": "Say hello in one sentence."
+        }
+      ]
+    }
+  },
+  {
+    "format": "anthropic",
+    "path_suffix": "/v1/messages",
+    "body": {
+      "max_tokens": 100,
+      "system": "You are a helpful assistant.",
+      "messages": [
+        {
+          "role": "user",
+          "content": "Say hello in one sentence."
+        }
+      ]
+    }
+  },
+  {
+    "format": "cohere",
+    "body": {
+      "max_tokens": 100,
+      "messages": [
+        {
+          "role": "system",
+          "content": "You are a helpful assistant."
+        },
+        {
+          "role": "user",
+          "content": "Say hello in one sentence."
+        }
+      ]
+    }
+  },
+  {
+    "format": "dashscope",
+    "body": {
+      "input": {
+        "messages": [
+          {
+            "role": "system",
+            "content": "You are a helpful assistant."
+          },
+          {
+            "role": "user",
+            "content": "Say hello in one sentence."
+          }
+        ]
+      },
+      "parameters": {
+        "max_tokens": 100,
+        "result_format": "message"
+      }
+    }
+  },
+  {
+    "format": "bedrock_converse",
+    "body": {
+      "system": [
+        {
+          "text": "You are a helpful assistant."
+        }
+      ],
+      "messages": [
+        {
+          "role": "user",
+          "content": [
+            {
+              "text": "Say hello in one sentence."
+            }
+          ]
+        }
+      ],
+      "inferenceConfig": {
+        "maxTokens": 100
+      }
+    }
+  }
+]

unitysvc_data-0.2.14/src/unitysvc_data/examples/llm/request-template-embed/README.md

@@ -0,0 +1,103 @@
++++
+preset_name = "llm_request_template_embed"
+category = "request_template"
+mime_type = "json"
+file = "request-template-embed.json"
+description = "Minimal embeddings request body for each request format"
+is_active = true
+is_public = true
+applies_to = { capability = "embed" }
+parameters = { version_prefix = "/v1" }
++++
+
+# llm / request-template-embed — minimal embeddings payload, per request format
+
+The default request body the Test Request playground offers for services that
+declare the `embed` capability (embeddings). One document covers one capability,
+which its `applies_to` names, and holds one entry per request format, each naming
+the format it is written in. The playground picks the document by the service's
+capability and then the first entry whose `format` is the one the customer chose
+(unitysvc/unitysvc#2514). A service whose format has no entry is shown an explicit
+empty state, never another capability's request. The rules every template shares
+are in [CONTRIBUTING](../../../../../CONTRIBUTING.md#request-templates); the chat
+template this follows is `../request-template/`.
+
+## Body (v1)
+
+| `format` | Wire shape | `path_suffix` | Derived from |
+|----------|------------|---------------|--------------|
+| `openai` | OpenAI Embeddings | `${__version_prefix__}/embeddings` | `llm_code_example_embed_requests` |
+| `cohere` | Cohere native embed, image input | `${__version_prefix__}/embed` | `llm_code_example_embed_image_requests` |
+| `dashscope` | DashScope native text embedding | none (bare base URL) | `llm_code_example_embed_dashscope_requests` |
+| `huggingface` | Hugging Face inference API (`/models/<model>`), sentence similarity | none (known limitation) | `llm_code_example_sentencetransformers_requests` |
+
+Each body is the request its code example sends, reduced to what is needed to send
+it: the example's own values, minus the `model` the playground merges in and minus
+any templated or optional parameter.
+
+- `openai` embeds two short sentences.
+- `cohere` embeds an **image**: the only Cohere embed example sends
+  `input_type = "image"`, so that is the body, with the same inlined
+  `../test-image.jpg` the vision template carries. A Cohere text-embedding body has
+  no code example and is not offered.
+- `dashscope` embeds one text.
+- `huggingface` is the `/models/<model>` surface's sentence-similarity request
+  (`source_sentence` scored against `sentences`), which is what the example for
+  that dialect sends and what the corpus files under `embed`.
+
+## Path
+
+Each `path_suffix` is what that entry's code example posts to, relative to the
+service's base URL. It is read off the example, and all three of its client
+variants (requests, shell, JavaScript) say the same, rather than written from an
+API's documentation, so it is as verified as the body is.
+
+`${__version_prefix__}` is the parameter the OpenAI-shaped examples use for the
+one segment a seller's upstream may move: `/v1` by default, `/compatibility/v1`
+for Cohere's compatibility surface, `/v2` for crofai, nothing for the platform's
+own facades. This family declares it with the example's default, so a listing that
+sets `params.version_prefix` for its examples gets the matching path here, and one
+that sets nothing gets `/v1`. A listing that differs in any other way can replace
+the document by title (a sibling key beside `$llm_example_collection`).
+
+**No `path_suffix` on `dashscope`:** its example posts to the service URL itself,
+so there is nothing to append and the key is omitted. The page treats a missing or
+blank `path_suffix` as absent and appends nothing, which is exactly that; writing
+`""` would add nothing, and `"/"` would append a trailing slash, a different
+request.
+
+**Known limitation: no `path_suffix` on `huggingface`.** The path carries the
+service's own model name (`/models/<model>`), so the right value differs by
+service, and a `path_suffix` is one string per capability and format: it cannot
+say "it depends on the service". The page merges `model` into the body and does
+not substitute inside `path_suffix`. That is a gap in the contract
+(unitysvc/unitysvc#2514, noted on #2516), not an oversight and not something a
+template can work around, so no substitution syntax is invented here. The
+playground appends nothing, as it did before the key existed.
+
+## What's intentionally missing
+
+- **No `model` field.** The playground merges the service's routing key into the
+  body it sends. The Hugging Face entry takes the model in the path instead
+  (`/models/<model>`).
+
+## Title
+
+`Default request body (embeddings)`: the capability's registry label, so it sits
+beside chat's `Default request body` on a service that declares both.
+
+## Versions
+
+### v1 — initial release
+
+- Four entries — `openai`, `cohere`, `dashscope`, `huggingface` — each the request
+  its code example sends.
+
+**Amended in 0.2.13**: entries gained `path_suffix` (see Path above). The
+playground appends nothing for an entry without one, which sends an OpenAI-shaped
+body to the service's base URL and fails; bodies, formats and their order are
+unchanged. The front-matter also gained `parameters = { version_prefix = "/v1" }`.
+Amended in place rather than published as a v2 because, under CONTRIBUTING's "one
+exception", the entries that gained a path could not be sent without it, so there
+is no working behaviour to pin to, and the version-less alias carries all the
+traffic: this family was released hours earlier and nothing pins it.

{unitysvc_data-0.2.12 → unitysvc_data-0.2.14}/src/unitysvc_data/examples/llm/request-template-embed/request-template-embed-v1.json

@@ -1,6 +1,7 @@
 [
   {
     "format": "openai",
+    "path_suffix": "${__version_prefix__}/embeddings",
     "body": {
       "input": [
         "Embed this sentence.",
@@ -10,6 +11,7 @@
   },
   {
     "format": "cohere",
+    "path_suffix": "${__version_prefix__}/embed",
     "body": {
       "input_type": "image",
       "embedding_types": [