unitysvc-data 0.1.5__tar.gz → 0.1.7__tar.gz

{unitysvc_data-0.1.5/src/unitysvc_data.egg-info → unitysvc_data-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unitysvc-data
-Version: 0.1.5
+Version: 0.1.7
 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.1.5 → unitysvc_data-0.1.7}/pyproject.toml

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

unitysvc_data-0.1.7/src/unitysvc_data/_manifest.json

@@ -0,0 +1,455 @@
+{
+  "aliases": {
+    "api_connectivity": "api_connectivity_v1",
+    "llm_code_example_anthropic": "llm_code_example_anthropic_v1",
+    "llm_code_example_embed_javascript": "llm_code_example_embed_javascript_v1",
+    "llm_code_example_embed_requests": "llm_code_example_embed_requests_v1",
+    "llm_code_example_embed_shell": "llm_code_example_embed_shell_v1",
+    "llm_code_example_fc_requests": "llm_code_example_fc_requests_v1",
+    "llm_code_example_guard_requests": "llm_code_example_guard_requests_v1",
+    "llm_code_example_image_requests": "llm_code_example_image_requests_v1",
+    "llm_code_example_javascript": "llm_code_example_javascript_v1",
+    "llm_code_example_openai": "llm_code_example_openai_v1",
+    "llm_code_example_openai_javascript": "llm_code_example_openai_javascript_v1",
+    "llm_code_example_requests": "llm_code_example_requests_v1",
+    "llm_code_example_rerank_requests": "llm_code_example_rerank_requests_v1",
+    "llm_code_example_shell": "llm_code_example_shell_v1",
+    "llm_code_example_streaming_openai": "llm_code_example_streaming_openai_v1",
+    "llm_code_example_streaming_openai_javascript": "llm_code_example_streaming_openai_javascript_v1",
+    "llm_code_example_transcription_requests": "llm_code_example_transcription_requests_v1",
+    "llm_code_example_tts_requests": "llm_code_example_tts_requests_v1",
+    "llm_code_example_vision_requests": "llm_code_example_vision_requests_v1",
+    "llm_description": "llm_description_v1",
+    "llm_request_template": "llm_request_template_v1",
+    "notification_description": "notification_description_v1",
+    "recommender_description": "recommender_description_v1",
+    "s3_code_example": "s3_code_example_v1",
+    "s3_connectivity": "s3_connectivity_v1",
+    "s3_description": "s3_description_v1",
+    "smtp_connectivity": "smtp_connectivity_v2",
+    "uptime_description": "uptime_description_v1"
+  },
+  "presets": {
+    "api_connectivity_v1": {
+      "category": "connectivity_test",
+      "description": "Verify HTTP endpoint is reachable and returns a healthy status",
+      "example_file": "api/connectivity/connectivity-v1.sh.j2",
+      "is_active": true,
+      "is_public": false,
+      "meta": {
+        "output_contains": "connectivity ok"
+      },
+      "mime_type": "bash",
+      "preset_name": "api_connectivity",
+      "source_readme": "api/connectivity/README.md",
+      "version": 1
+    },
+    "llm_code_example_anthropic_v1": {
+      "category": "code_example",
+      "description": "Python example: send a message to an Anthropic-API-compatible LLM using the anthropic SDK",
+      "example_file": "llm/code-example-anthropic/code-example-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "anthropic"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_anthropic",
+      "source_readme": "llm/code-example-anthropic/README.md",
+      "version": 1
+    },
+    "llm_code_example_embed_javascript_v1": {
+      "category": "code_example",
+      "description": "JavaScript example: request OpenAI-compatible embeddings via fetch",
+      "example_file": "llm/code-example-embed-javascript/code-example-embed-v1.js.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "javascript",
+      "preset_name": "llm_code_example_embed_javascript",
+      "source_readme": "llm/code-example-embed-javascript/README.md",
+      "version": 1
+    },
+    "llm_code_example_embed_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: request OpenAI-compatible embeddings for a list of inputs",
+      "example_file": "llm/code-example-embed-requests/code-example-embed-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_embed_requests",
+      "source_readme": "llm/code-example-embed-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_embed_shell_v1": {
+      "category": "code_example",
+      "description": "Shell example: request OpenAI-compatible embeddings via curl",
+      "example_file": "llm/code-example-embed-shell/code-example-embed-v1.sh.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "bash",
+      "preset_name": "llm_code_example_embed_shell",
+      "source_readme": "llm/code-example-embed-shell/README.md",
+      "version": 1
+    },
+    "llm_code_example_fc_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: chat completion with function/tool calling on an OpenAI-compatible LLM",
+      "example_file": "llm/code-example-fc-requests/code-example-fc-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_fc_requests",
+      "source_readme": "llm/code-example-fc-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_guard_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: probe a Llama-Guard-style safety classifier with a borderline prompt",
+      "example_file": "llm/code-example-guard-requests/code-example-guard-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_guard_requests",
+      "source_readme": "llm/code-example-guard-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_image_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: generate an image from a text prompt via an OpenAI-compatible images endpoint",
+      "example_file": "llm/code-example-image-requests/code-example-image-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_image_requests",
+      "source_readme": "llm/code-example-image-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_javascript_v1": {
+      "category": "code_example",
+      "description": "JavaScript example: send a chat completion request to an OpenAI-compatible LLM",
+      "example_file": "llm/code-example-javascript/code-example-v1.js.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "javascript",
+      "preset_name": "llm_code_example_javascript",
+      "source_readme": "llm/code-example-javascript/README.md",
+      "version": 1
+    },
+    "llm_code_example_openai_javascript_v1": {
+      "category": "code_example",
+      "description": "JavaScript example: send a chat completion request to an OpenAI-compatible LLM using the openai SDK",
+      "example_file": "llm/code-example-openai-javascript/code-example-v1.js.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "openai"
+        ]
+      },
+      "mime_type": "javascript",
+      "preset_name": "llm_code_example_openai_javascript",
+      "source_readme": "llm/code-example-openai-javascript/README.md",
+      "version": 1
+    },
+    "llm_code_example_openai_v1": {
+      "category": "code_example",
+      "description": "Python example: send a chat completion request to an OpenAI-compatible LLM using the openai SDK",
+      "example_file": "llm/code-example-openai/code-example-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "openai"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_openai",
+      "source_readme": "llm/code-example-openai/README.md",
+      "version": 1
+    },
+    "llm_code_example_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: send a chat completion request to an OpenAI-compatible LLM using the requests library",
+      "example_file": "llm/code-example-requests/code-example-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_requests",
+      "source_readme": "llm/code-example-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_rerank_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: rerank a candidate document set against a query",
+      "example_file": "llm/code-example-rerank-requests/code-example-rerank-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_rerank_requests",
+      "source_readme": "llm/code-example-rerank-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_shell_v1": {
+      "category": "code_example",
+      "description": "Shell example: send a chat completion request to an OpenAI-compatible LLM via curl",
+      "example_file": "llm/code-example-shell/code-example-v1.sh.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "bash",
+      "preset_name": "llm_code_example_shell",
+      "source_readme": "llm/code-example-shell/README.md",
+      "version": 1
+    },
+    "llm_code_example_streaming_openai_javascript_v1": {
+      "category": "code_example",
+      "description": "JavaScript example: stream a chat completion from an OpenAI-compatible LLM using the openai SDK",
+      "example_file": "llm/code-example-streaming-openai-javascript/code-example-v1.js.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "openai"
+        ]
+      },
+      "mime_type": "javascript",
+      "preset_name": "llm_code_example_streaming_openai_javascript",
+      "source_readme": "llm/code-example-streaming-openai-javascript/README.md",
+      "version": 1
+    },
+    "llm_code_example_streaming_openai_v1": {
+      "category": "code_example",
+      "description": "Python example: stream a chat completion from an OpenAI-compatible LLM using the openai SDK",
+      "example_file": "llm/code-example-streaming-openai/code-example-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "openai"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_streaming_openai",
+      "source_readme": "llm/code-example-streaming-openai/README.md",
+      "version": 1
+    },
+    "llm_code_example_transcription_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: transcribe a pre-recorded audio file with an OpenAI-compatible audio transcription endpoint",
+      "example_file": "llm/code-example-transcription-requests/code-example-transcription-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_transcription_requests",
+      "source_readme": "llm/code-example-transcription-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_tts_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: synthesize speech from text using an OpenAI-compatible audio/speech endpoint",
+      "example_file": "llm/code-example-tts-requests/code-example-tts-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_tts_requests",
+      "source_readme": "llm/code-example-tts-requests/README.md",
+      "version": 1
+    },
+    "llm_code_example_vision_requests_v1": {
+      "category": "code_example",
+      "description": "Python example: ask a vision-capable LLM about a publicly-hosted image",
+      "example_file": "llm/code-example-vision-requests/code-example-vision-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "requirements": [
+          "requests"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "llm_code_example_vision_requests",
+      "source_readme": "llm/code-example-vision-requests/README.md",
+      "version": 1
+    },
+    "llm_description_v1": {
+      "category": "getting_started",
+      "description": "Customer-facing overview of an OpenAI-compatible LLM gateway service",
+      "example_file": "llm/description/description-v1.md",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "markdown",
+      "preset_name": "llm_description",
+      "source_readme": "llm/description/README.md",
+      "version": 1
+    },
+    "llm_request_template_v1": {
+      "category": "request_template",
+      "description": "Minimal OpenAI-compatible chat completion request body",
+      "example_file": "llm/request-template/request-template-v1.json",
+      "is_active": true,
+      "is_public": false,
+      "meta": {},
+      "mime_type": "json",
+      "preset_name": "llm_request_template",
+      "source_readme": "llm/request-template/README.md",
+      "version": 1
+    },
+    "notification_description_v1": {
+      "category": "getting_started",
+      "description": "Customer-facing overview of a ntfy-shaped push-notification gateway service",
+      "example_file": "notification/description/description-v1.md",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "markdown",
+      "preset_name": "notification_description",
+      "source_readme": "notification/description/README.md",
+      "version": 1
+    },
+    "recommender_description_v1": {
+      "category": "getting_started",
+      "description": "Customer-facing overview of a Gorse-shaped recommender gateway service",
+      "example_file": "recommender/description/description-v1.md",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "markdown",
+      "preset_name": "recommender_description",
+      "source_readme": "recommender/description/README.md",
+      "version": 1
+    },
+    "s3_code_example_v1": {
+      "category": "code_example",
+      "description": "Python example: list objects in an S3 bucket via boto3",
+      "example_file": "s3/code-example/code-example-v1.py.j2",
+      "is_active": true,
+      "is_public": true,
+      "meta": {
+        "output_contains": "connectivity ok",
+        "requirements": [
+          "boto3"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "s3_code_example",
+      "source_readme": "s3/code-example/README.md",
+      "version": 1
+    },
+    "s3_connectivity_v1": {
+      "category": "connectivity_test",
+      "description": "Verify S3 endpoint accepts the configured credentials",
+      "example_file": "s3/connectivity/connectivity-v1.py.j2",
+      "is_active": true,
+      "is_public": false,
+      "meta": {
+        "output_contains": "connectivity ok",
+        "requirements": [
+          "boto3"
+        ]
+      },
+      "mime_type": "python",
+      "preset_name": "s3_connectivity",
+      "source_readme": "s3/connectivity/README.md",
+      "version": 1
+    },
+    "s3_description_v1": {
+      "category": "getting_started",
+      "description": "Customer-facing overview of the S3 gateway service",
+      "example_file": "s3/description/description-v1.md",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "markdown",
+      "preset_name": "s3_description",
+      "source_readme": "s3/description/README.md",
+      "version": 1
+    },
+    "smtp_connectivity_v1": {
+      "category": "connectivity_test",
+      "description": "Verify SMTP server returns a 220 greeting on connect",
+      "example_file": "smtp/connectivity/connectivity-v1.sh.j2",
+      "is_active": true,
+      "is_public": false,
+      "meta": {
+        "output_contains": "connectivity ok"
+      },
+      "mime_type": "bash",
+      "preset_name": "smtp_connectivity",
+      "source_readme": "smtp/connectivity/README.md",
+      "version": 1
+    },
+    "smtp_connectivity_v2": {
+      "category": "connectivity_test",
+      "description": "Verify SMTP server returns a 220 greeting on connect",
+      "example_file": "smtp/connectivity/connectivity-v2.sh.j2",
+      "is_active": true,
+      "is_public": false,
+      "meta": {
+        "output_contains": "connectivity ok"
+      },
+      "mime_type": "bash",
+      "preset_name": "smtp_connectivity",
+      "source_readme": "smtp/connectivity/README.md",
+      "version": 2
+    },
+    "uptime_description_v1": {
+      "category": "getting_started",
+      "description": "Customer-facing overview of an uptime-monitoring bridge service",
+      "example_file": "uptime/description/description-v1.md",
+      "is_active": true,
+      "is_public": true,
+      "meta": {},
+      "mime_type": "markdown",
+      "preset_name": "uptime_description",
+      "source_readme": "uptime/description/README.md",
+      "version": 1
+    }
+  },
+  "version": "1"
+}

{unitysvc_data-0.1.5 → unitysvc_data-0.1.7}/src/unitysvc_data/examples/api/connectivity/connectivity-v1.sh.j2

@@ -3,15 +3,13 @@
 # variants). Verifies the endpoint is reachable AND serves a sensible
 # response. 404 / 5xx / DNS / timeout all count as failure.
 #
-# The harness sets the same env var names in both modes:
-#   $SERVICE_BASE_URL  — upstream URL (local) or gateway URL (online)
-#   $UNITYSVC_API_KEY  — upstream api_key if defined in upstream_access_config
-#                        (local), or the customer's gateway key (online)
-# Because the variable names are identical we don't branch on
-# local_testing for this test — the script works in both modes.
+# The base URL is rendered into the script at template-render time
+# (gateway URL for ``test_gateway`` context, upstream URL for
+# ``test_local``). The API key intentionally stays as an env-var
+# lookup — never inline a real key into rendered output.
 set -o pipefail
 
-URL="${SERVICE_BASE_URL:?SERVICE_BASE_URL is not set}"
+URL="{{ service_base_url }}"
 
 # Split the curl invocation rather than expanding an empty array under
 # `set -u` (bash 3.2 on macOS raises on "${arr[@]}" when arr is empty).

unitysvc_data-0.1.7/src/unitysvc_data/examples/llm/code-example-anthropic/README.md

@@ -0,0 +1,41 @@
++++
+preset_name = "llm_code_example_anthropic"
+category = "code_example"
+mime_type = "python"
+file = "code-example.py.j2"
+description = "Python example: send a message to an Anthropic-API-compatible LLM using the anthropic SDK"
+is_active = true
+is_public = true
+meta = { requirements = ["anthropic"] }
++++
+
+# llm / code-example-anthropic — Anthropic Messages API via the `anthropic` SDK
+
+Customer-facing Python example for upstreams that speak the
+Anthropic Messages API (`/v1/messages`) — primarily Claude-family
+models. The Anthropic API is **not** OpenAI-compatible: the
+endpoint differs (`/v1/messages` vs `/v1/chat/completions`),
+`max_tokens` is required, the `system` prompt is a top-level field
+rather than a message, and the response shape is `content[].text`
+rather than `choices[].message.content`. So Anthropic-shaped
+upstreams need their own preset rather than reusing
+`llm_code_example_openai`.
+
+## Environment variables (all required)
+
+- `SERVICE_BASE_URL` — Messages endpoint, passed as the SDK's
+  `base_url`.
+- `UNITYSVC_API_KEY` — passed as the SDK's `api_key`.
+- `MODEL` — interface-specific model identifier.
+
+## Versions
+
+### v1 — initial release
+
+- `Anthropic(base_url=..., api_key=...)` then
+  `client.messages.create(...)` with `max_tokens=1024` and a
+  top-level `system` prompt.
+- HTTP errors surface as `anthropic.APIStatusError` (non-zero
+  exit), so no explicit status check is needed.
+- Reads `UNITYSVC_API_KEY`, `SERVICE_BASE_URL`, `MODEL` from the
+  environment; missing any of the three fails fast with `KeyError`.

unitysvc_data-0.1.7/src/unitysvc_data/examples/llm/code-example-anthropic/code-example-v1.py.j2

@@ -0,0 +1,18 @@
+import os
+
+from anthropic import Anthropic
+
+client = Anthropic(
+    base_url="{{ service_base_url }}",
+    api_key=os.environ["UNITYSVC_API_KEY"],
+)
+
+response = client.messages.create(
+    model="{{ routing_key.model }}",
+    max_tokens=1024,
+    system="You are a helpful assistant.",
+    messages=[
+        {"role": "user", "content": "Say this is a test"},
+    ],
+)
+print(response.content[0].text)

unitysvc_data-0.1.7/src/unitysvc_data/examples/llm/code-example-embed-javascript/README.md

@@ -0,0 +1,34 @@
++++
+preset_name = "llm_code_example_embed_javascript"
+category = "code_example"
+mime_type = "javascript"
+file = "code-example-embed.js.j2"
+description = "JavaScript example: request OpenAI-compatible embeddings via fetch"
+is_active = true
+is_public = true
++++
+
+# llm / code-example-embed-javascript — embeddings via `fetch`
+
+Customer-facing Node.js example for OpenAI-compatible embedding
+endpoints. Uses the built-in `fetch` API (Node 18+).
+
+## Environment variables (all required)
+
+- `SERVICE_BASE_URL` — embeddings endpoint.
+- `UNITYSVC_API_KEY` — bearer token.
+- `MODEL` — interface-specific model identifier. The script does not
+  fall back to `offering.name` because the model id is a routing
+  key and can differ between the gateway and the upstream — the
+  caller must supply the correct one for the access interface.
+
+## Versions
+
+### v1 — initial release
+
+- `fetch` POST with `model` + two-element `input` array.
+- A small loop checks the three required env vars before the request
+  and exits 1 on any missing one.
+- Prints the dimensionality and first three components of each
+  returned vector.
+- Plain JavaScript (no `.j2` suffix) — no Jinja2 expansion.

unitysvc_data-0.1.7/src/unitysvc_data/examples/llm/code-example-embed-javascript/code-example-embed-v1.js.j2

@@ -0,0 +1,23 @@
+async function main() {
+  const response = await fetch("{{ service_base_url }}/embeddings", {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${process.env.UNITYSVC_API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      model: "{{ routing_key.model }}",
+      input: ["Embed this sentence.", "As well as this one."],
+    }),
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+  }
+  const { data } = await response.json();
+  console.log(`got ${data.length} embeddings of dimension ${data[0].embedding.length}`);
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

unitysvc_data-0.1.7/src/unitysvc_data/examples/llm/code-example-embed-requests/README.md

@@ -0,0 +1,45 @@
++++
+preset_name = "llm_code_example_embed_requests"
+category = "code_example"
+mime_type = "python"
+file = "code-example-embed.py.j2"
+description = "Python example: request OpenAI-compatible embeddings for a list of inputs"
+is_active = true
+is_public = true
+meta = { requirements = ["requests"] }
++++
+
+# llm / code-example-embed-requests — embeddings via `requests`
+
+Customer-facing Python example for OpenAI-compatible embedding
+endpoints (`/v1/embeddings`-shaped) routed through the UnitySVC LLM
+gateway.
+
+## Environment variables (all required)
+
+- `SERVICE_BASE_URL` — embeddings endpoint (gateway URL or upstream
+  URL in local-testing mode). The gateway sets this to its own
+  `/v1/embeddings` route.
+- `UNITYSVC_API_KEY` — bearer token.
+- `MODEL` — interface-specific model identifier. The script does not
+  fall back to `offering.name` because the model id is a routing
+  key and can differ between the gateway and the upstream — the
+  caller must supply the correct one for the access interface.
+
+## Conventions
+
+- Posts a list of two short strings as `input` and prints the
+  dimensionality + the first three components of each returned vector
+  so the script verifies the response shape without dumping a wall of
+  floats.
+- Uses the OpenAI-compatible response shape: `data[].embedding` is a
+  flat list of floats.
+
+## Versions
+
+### v1 — initial release
+
+- `requests.post` against `SERVICE_BASE_URL` with `model` + `input`.
+- Reads `UNITYSVC_API_KEY`, `SERVICE_BASE_URL`, `MODEL` from env;
+  missing any of the three fails fast with `KeyError`.
+- Plain Python (no `.j2` suffix) — no Jinja2 expansion.