[ilay-decart]

Description

The example page (packages/sdk/index.html, which pnpm dev:example serves) gets an API endpoint dropdown and a slot for server-side models, both filled from the environment so the page never hardcodes hosts:

• VITE_REALTIME_BASE_URLS: a JSON array of {label, url, note?}. It shows the dropdown above the Realtime Base URL field.
  • Picking a preset fills the field, which stays editable.
  • Typing a URL selects the matching preset, or "Custom".
  • The note shows under the dropdown, for example which API key that endpoint needs.
• VITE_EXTRA_REALTIME_MODELS: comma-separated model names this SDK build does not list. They appear under "This deployment" and connect like "Custom model", by name.
• Without either variable the page is unchanged: no dropdown, no extra model group.

Two fixes to the base URL field:

• A bare host (api.example.com) is read as wss://api.example.com. Before, it failed with Invalid base URL before any request.
• Picking an endpoint re-mints an ephemeral/JWT credential through it, as a model change already does. A credential minted through one endpoint fails on another.

Hosts come from the environment because a deployment that serves this page (Decart's staging) rewrites production hostnames in the checkout at build time and fails the build if any remain.

Testing

Ran vite dev locally, with and without the variables, and drove the page with Playwright against production endpoints:

• Without the variables: the dropdown is hidden and there is no extra model group.
• With them:
  • presets and notes render;
  • choosing "Custom" keeps the field;
  • a typed bare host selects its preset;
  • an unknown URL selects "Custom".
• Real sessions with the base URL typed as a bare host: an extra (server-side) model and lucy-2.6 both reached "Generating" with 1280×720 output.
• Ephemeral mode: switching endpoints minted through each selected endpoint in turn, and the session connected with the last credential.
• pnpm lint and pnpm format:check are clean.

---

Note

Low Risk
Demo-page-only UI and env-driven configuration; no SDK library API changes and default behavior is unchanged when env vars are unset.

Overview
The SDK demo page (packages/sdk/index.html) can now be configured at build time for non-production deployments without hardcoding hosts.

When VITE_REALTIME_BASE_URLS is set, an API endpoint dropdown appears (hidden otherwise). It lists JSON presets (label, url, optional note), syncs with the existing Realtime Base URL field, and re-mints ephemeral/JWT credentials when the endpoint changes. When VITE_EXTRA_REALTIME_MODELS is set, those names show under a “This deployment” model group and connect like custom models (by name, not via models.realtime()).

Base URL handling is centralized in readRealtimeBaseUrl(): bare hosts get wss:// so the SDK no longer fails on “Invalid base URL,” and connect/mint/files paths use that helper instead of raw input trimming.

^{Reviewed by Cursor Bugbot for commit 661378b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@decartai/sdk@231

commit: 661378b

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 661378b. Configure here.}

[cursor]

Extra models inherit leftover dimensions

Low Severity

Deployment extra models reuse buildCustomModel, so they take width and height from the hidden custom-model fields. After a custom-model attempt, those leftover values apply silently to the extra model and the user cannot see or change them.

Additional Locations (1)

• packages/sdk/index.html#L764-L773

 

^{Reviewed by Cursor Bugbot for commit 661378b. Configure here.}