@clipwright/sdk 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -10,6 +10,55 @@ on the client side. Entries marked *Server-side* changed the API itself: every
 client version sees them from the day the API was deployed, not from the package
 release they are listed under.
 
+Entries marked *Dashboard:* changed the web app (the dashboard or a public page of the site)
+and no package. This file is also the public changelog at /changelog, so they are listed here:
+a customer reading it should not miss what appeared in the product. Like *Server-side* entries,
+they are live from the day the web app was deployed, not from the package release they are
+listed under.
+
+## [0.15.0] - 2026-09-14
+
+### Changed
+
+- *Server-side:* in `GET /v1/voices`, a catalog voice carries `preview_url` and
+  `preview_expires_at` once its sample is recorded: a short clip of that voice on
+  `eleven_v3`, in the voice's own language. The link is signed by us and
+  expires like a preset's. A voice without a recorded sample for its current
+  model and sample text still has neither field, and the list never links to
+  the vendor. The sample texts outside English and Russian are machine
+  translations that no native speaker has checked. (clipwright#164)
+- *Server-side:* without `voice` or `voice_id`, the voice follows the actor's
+  gender: a woman from `actor_id` speaks `sarah`, a man speaks `george`. The
+  default actor still speaks `george`, and an explicit voice always wins.
+  (clipwright#183)
+- *Server-side:* a request with `image` and no voice gets a warning that the
+  male `george` voice is used, naming `voice` and `actor_gender` as the fix.
+  `GET /v1/runs/{id}` derives it from the stored input, so runs started before
+  this change show it too. A request with `actor_gender` next to `voice` or
+  `voice_id` gets a warning that the hint changed nothing. (clipwright#183)
+- *Server-side:* the contract version moved to `2026-09-14`. (clipwright#183)
+- *Dashboard:* `/actors` says that an actor without a chosen voice speaks the
+  default voice of their gender. (clipwright#183)
+
+### Added
+
+- `actor_gender` (`female` or `male`) in the `make_ugc` input: next to `image`
+  it picks the default voice of that gender. It is refused with `actor_id` and
+  without `image`, and the remote fetch killswitch turns it off together with
+  `image`. The REST API accepts it from the day the API is deployed; the MCP
+  tool schema, the SDK types and the CLI flag `--actor-gender` arrive with this
+  release. (clipwright#183)
+
+- *Dashboard:* `/actors` shows the actor library as a gallery: every published portrait with
+  its `actor_id` to copy, next to gender, approximate age, description and version. A person
+  can pick a face without calling `GET /v1/actors` first. (clipwright#148)
+- *Dashboard:* `/videos` lists the finished videos of the account. Each one is a still frame
+  taken from the delivered file, with the length of the clip and the day it finished, and a
+  tile with a frame plays the video. Runs that are still going or that failed stay on the
+  Balance page. (clipwright#138)
+- *Dashboard:* `/changelog` renders this file as a public page, so the release notes are
+  readable without installing a package. (clipwright#102)
+
 ## [0.14.0] - 2026-09-13
 
 ### Changed

package/README.md

@@ -16,6 +16,17 @@ carries an idempotency key derived from the input and from this installation's
 id, so a retried request returns the original run instead of paying twice. Pass
 `idempotencyKey` explicitly when you deliberately want a fresh run.
 
+`listVoices({ language, gender, age, use_case, model })` returns the voices for
+`voice`, each filter optional. It is free. A voice with a sample carries a
+`preview_url` that expires in an hour. Pass a voice's `name` as `voice`;
+`language` is a filter only, since any voice speaks any supported language.
+
+Without `voice` or `voice_id`, the voice follows the actor's gender: `sarah` for
+a woman, `george` for a man. `actor_id` brings its catalog gender; with `image`,
+pass `actor_gender` (`"female"` or `"male"`). An `image` without `actor_gender`
+gets `george` and a warning. `actor_gender` next to `actor_id` or without
+`image` is refused before any charge.
+
 Requires `CLIPWRIGHT_CLIENT_ID`, or a writable `~/.clipwright/` for the SDK to
 create one on first use. It fails loudly rather than generating a throwaway id,
 because a per-process id would disable duplicate protection without saying so.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipwright/sdk",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "TypeScript client for the Clipwright UGC video API",
   "license": "MIT",
   "author": "Dimantika Sp. z o.o.",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@clipwright/core": "0.14.0"
+    "@clipwright/core": "0.15.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1"