@sogni-ai/sogni-client 5.50.1 → 5.51.1

package/AGENTS.md

@@ -72,7 +72,7 @@ Public chat and workflow media rules:
 
 ## Overview
 
-This is the **Sogni SDK for JavaScript/Node.js** - a TypeScript client library for the Sogni Supernet, a DePIN protocol for creative AI inference. The SDK supports image generation (Stable Diffusion, Flux, Z-Image / Z-Image Turbo, Krea 2 Turbo, Krea 2 Identity Edit, Chroma v.46 Flash / v.48 Detail / Chroma1-HD, Qwen image-edit models, GPT Image 2, plus community fine-tunes such as Dark Beast Z-Image Turbo v9, Dark Beast KREA 2, Dark Beast Krea 2 Identity Edit, and One Obsession v22), video generation (WAN 2.2, Wan 3, LTX-2.3, Seedance 2.0, HappyHorse 1.1, MiniMax H3, and MiniMax H3 Turbo), promptless video upscaling (FlashVSR v1.1), audio generation (ACE-Step 1.5), LLM chat with tool calling, hosted creative tools, durable creative workflows, replay records, and multimodal vision chat (Qwen3.6 35B VLM, default `qwen3.6-35b-a3b-gguf-iq4xs`). The model catalog is discovered dynamically at runtime (`sogni.projects.getAvailableModels()`); model ids listed here are illustrative.
+This is the **Sogni SDK for JavaScript/Node.js** - a TypeScript client library for the Sogni Supernet, a DePIN protocol for creative AI inference. The SDK supports image generation (Stable Diffusion, Flux, Z-Image / Z-Image Turbo, Krea 2 Turbo, Krea 2 Identity Edit, Chroma v.46 Flash / v.48 Detail / Chroma1-HD, Qwen image-edit models, GPT Image 2 and 2.5, plus community fine-tunes such as Dark Beast Z-Image Turbo v9, Dark Beast KREA 2, Dark Beast Krea 2 Identity Edit, and One Obsession v22), video generation (WAN 2.2, Wan 3, LTX-2.3, Seedance 2.0 and 2.5, HappyHorse 1.1, MiniMax H3, and MiniMax H3 Turbo), promptless video upscaling (FlashVSR v1.1), audio generation (ACE-Step 1.5), LLM chat with tool calling, hosted creative tools, durable creative workflows, replay records, and multimodal vision chat (Qwen3.6 35B VLM, default `qwen3.6-35b-a3b-gguf-iq4xs`). The model catalog is discovered dynamically at runtime (`sogni.projects.getAvailableModels()`); model ids listed here are illustrative.
 
 Choosing an image-edit model: pick by what the edit has to preserve, not by step count or quality tier. When a person or character must stay recognisable through the edit — style transfer, makeover, clothing or person swap, face swap, new pose or expression, character sheet — use Krea 2 Identity Edit (`krea2_identity_edit_v1_2`, or `dark_beast_krea2_identity_edit_v1_2` uncensored) with 1-2 context images. For general-purpose editing — photo transforms, in-image text, multi-person changes, combining up to 3 references — use a Qwen image-edit model. A higher-step general-purpose editor does not beat the identity model at a likeness task; it reinterprets the subject instead of preserving it. See `llms.txt` for parameters.
 
@@ -128,7 +128,7 @@ Generated artifacts:
 - `chat: ChatApi` - Unified chat namespace:
   - `chat.completions.create` - Socket-native synchronous chat
   - `chat.hosted.create` - Hosted synchronous chat via `/v1/chat/completions`
-  - `chat.runs.{create, get, cancel, streamEvents}` - Durable hosted chat runs via `/v1/chat/runs` with SSE replay
+  - `chat.runs.{create, get, cancel, confirmCost, streamEvents}` - Durable hosted chat runs via `/v1/chat/runs` with SSE replay; `confirmCost` echoes `waiting.details.costApprovalPreview` as `acceptedCostPreview`
   - `chat.tools` - Tool helpers (build, parse, validate)
 - `workflows: CreativeWorkflowsApi` - Durable explicit creative workflows via `/v1/creative-agent/workflows`
   - `workflows.{start, list, get, events, streamEvents, resume, reseed, cancel}`

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [5.51.1](https://github.com/Sogni-AI/sogni-client/compare/v5.51.0...v5.51.1) (2026-09-16)
+
+
+### Bug Fixes
+
+* **chat:** send the accepted cost preview when confirming a chat run ([548fa9e](https://github.com/Sogni-AI/sogni-client/commit/548fa9e64b91e8d4c01bb7fe405bf0ea6d6a6e51))
+
+# [5.51.0](https://github.com/Sogni-AI/sogni-client/compare/v5.50.1...v5.51.0) (2026-09-16)
+
+
+### Features
+
+* **projects:** expose personal LoRAs and hosted media tools ([201d0e0](https://github.com/Sogni-AI/sogni-client/commit/201d0e051b10a50d523094cfe169a204b9105452))
+
 ## [5.50.1](https://github.com/Sogni-AI/sogni-client/compare/v5.50.0...v5.50.1) (2026-09-15)
 
 

package/README.md

@@ -896,6 +896,36 @@ export interface ControlNetParams {
 }
 ```
 
+
+### Personal LoRA library
+
+Use the same account/API key as Sogni Web. Importing and generating require an active Unlimited subscription; listing and removing owned entries remain available after expiry. The server checks ownership, readiness, content-filter requirements, compatible models, and quotas on every request.
+
+```typescript
+const library = await sogni.projects.personalLoras.list();
+// Choose modelId from library.models; obtain the user's permission to use the file.
+const imported = await sogni.projects.personalLoras.import({
+  url: 'https://huggingface.co/author/repository/resolve/main/style.safetensors',
+  name: 'My style',
+  modelId: 'krea2_turbo_fp8_scaled',
+  rightsConfirmed: true,
+});
+const current = await sogni.projects.personalLoras.get(imported.id);
+// Importing is asynchronous. Poll get() until ready, rejected, or revoked;
+// queued, validating, and review are not usable yet. Surface reason/failureCode.
+const { loras } = await sogni.projects.availableLoras({
+  modelId: 'krea2_turbo_fp8_scaled', includePersonal: true,
+});
+// Pass a ready row.loraId in project.loras and row.ui.default in loraStrengths.
+// Respect its modelIds, requirements, and ui.nsfw content-filter requirement.
+// Removal is explicit:
+// await sogni.projects.personalLoras.remove(imported.id);
+```
+
+`personalLoras.catalog({modelId})` returns ready private catalog rows. `getLora('personal-…')` also reads the authenticated catalog. Personal catalog responses are never placed in the shared public cache. `forceRefresh` controls the public catalog; personal entries are always fetched again. Standard and non-audio FastH3 Two-Stage modes expose their compatible adapters through `modelIds`; audio-guided H3 modes do not support LoRAs.
+
+Hosted tools include `SogniTools.imageTo3d`, `SogniTools.removeBackground`, and `SogniTools.segmentImage`. Use `image_to_3d` with a front image and optional named `leftViewImageIndex`, `backViewImageIndex`, and `rightViewImageIndex`; its result has `mediaType: 'model'` and is a binary GLB. `generate_speech` supports `creativity` (0.1–2), `outputFormat` (`wav`, `mp3`, `flac`), and `seed`, alongside studio voices, reference-audio cloning, and voice design.
+
 ## Video Generation (WAN 2.2, Wan 3, LTX-2.3, Seedance & Happy Horse)
 
 The Sogni SDK supports advanced video generation workflows powered by **Wan 2.2 14B FP8** models. These models are available on the `fast` network and support various video generation workflows.
@@ -940,7 +970,7 @@ Example model IDs:
 - `ltx23-22b-fp8_v2v_distilled` (LTX-2.3 Video-to-Video ControlNet, fast)
 - `seedance-2-0` (Seedance 2.0 multimodal video, external API, 4K capable)
 - `seedance-2-0-mini` (Seedance 2.0 Mini multimodal video, external API, 720p cap)
-- `seedance-2-5` (Seedance 2.5 multimodal video, external API, 480p/720p only, 4-30s, first+last frame)
+- `seedance-2-5` (Seedance 2.5 multimodal video, external API, 480p/720p/1080p, 4-30s, first+last frame)
 - `happyhorse-1.1-t2v` (Happy Horse 1.1 Text-to-Video, external API, image-only references)
 - `happyhorse-1.1-i2v` (Happy Horse 1.1 Image-to-Video, external API, one first-frame image)
 - `happyhorse-1.1-r2v` (Happy Horse 1.1 Reference-to-Video, external API, 1-9 reference images)
@@ -1318,6 +1348,37 @@ node examples/workflow_seedance_2_5_r2v.mjs "Edit @Video1" --task-type edit --vi
 node examples/workflow_seedance_2_5_r2v.mjs "Extend @Video1" --task-type extend --video https://cdn.example.com/source.mp4 --duration 8 --creative-agent --dry-run
 ```
 
+### Durable Chat Runs and Cost Approval
+
+`sogni.chat.runs` (`create`, `get`, `cancel`, `confirmCost`, `streamEvents`) wraps `/v1/chat/runs`, where the server drives the LLM and tool loop and the client can disconnect and reattach through SSE replay.
+
+A run can pause before paid tool calls with `status: 'waiting_for_user'` and `waiting.reason: 'cost_approval_required'`. The pause carries the paused `toolCallId` and a `costApprovalPreview` (`totalEstimatedCapacityUnits`, `tokenType`, `validityUntil`, and an optional `perToolBreakdown`) in `run.waiting.details`, and in `event.payload.details` on the `run_waiting_for_user` event. Show that preview to the user, then pass it back unchanged as `acceptedCostPreview`:
+
+```javascript
+const run = await sogni.chat.runs.get(runId);
+const details = run.waiting?.details;
+
+if (run.waiting?.reason === 'cost_approval_required' && details?.toolCallId) {
+  const preview = details.costApprovalPreview;
+  // askUserToApprove is your UI: show the preview and wait for the answer.
+  const approved = preview ? await askUserToApprove(preview) : false;
+
+  if (approved) {
+    await sogni.chat.runs.confirmCost(runId, {
+      toolCallId: details.toolCallId,
+      decision: 'confirm',
+      acceptedCostPreview: preview,
+      idempotencyKey: `confirm-${details.toolCallId}`
+    });
+  } else {
+    // Declining needs no preview.
+    await sogni.chat.runs.confirmCost(runId, { toolCallId: details.toolCallId, decision: 'cancel' });
+  }
+}
+```
+
+The server rejects a confirm without `acceptedCostPreview` (HTTP 400), and one whose preview has expired or no longer matches (HTTP 409); read the run again and ask the user to approve the new preview. The SDK never fills in the preview for you. `idempotencyKey` is sent as the `Idempotency-Key` header, so reuse it for duplicate submissions of the same decision. A pause without `costApprovalPreview`, such as one caused by running out of credits, cannot be confirmed; cancel it instead.
+
 ### Durable Creative Workflows (server-side)
 
 Long-running multi-step creative workflows can be persisted on the server and observed independently of the chat completion that started them. The SDK exposes these authenticated endpoints through `sogni.workflows`:
@@ -1532,7 +1593,7 @@ The workflow examples showcase a few powerful open-source frontier models suppor
 | `wan_v2.2-14b-fp8_t2v_lightx2v`       | **Wan 2.2 T2V** - Text-to-video                          | Generate videos from text prompts                                                                            |
 | `seedance-2-0`                        | **Seedance 2.0** - 4K external API multimodal video      | Full Seedance 2.0 24fps video generation with optional image, video, and audio context                       |
 | `seedance-2-0-mini`                   | **Seedance 2.0 Mini** - 720p external API video          | Fastest, lower-cost 24fps Seedance video generation                                                          |
-| `seedance-2-5`                        | **Seedance 2.5** - 480p/720p external API video          | Newest Seedance: 4-30s single-call clips, first+last frame conditioning, 30 image / 10 video / 10 audio refs |
+| `seedance-2-5`                        | **Seedance 2.5** - up to 1080p external API video         | Newest Seedance: 4-30s single-call clips, first+last frame conditioning, 30 image / 10 video / 10 audio refs |
 | `dark_beast_z_image_turbo_v9_bf16`    | **Dark Beast Z-Image Turbo v9** - Community (uncensored) | Uncensored, fast Z-Image fine-tune (2K output needs a 24GB+ VRAM worker)                                     |
 | `dark_beast_krea2_fp8`                | **Dark Beast KREA 2** - Community (uncensored)           | Uncensored Krea 2 fine-tune (2K output needs a 24GB+ VRAM worker)                                            |
 | `dark_beast_krea2_identity_edit_v1_2` | **Dark Beast Krea 2 Identity Edit** - Community          | Uncensored identity-preserving Krea 2 edit LoRA with 1-2 reference images                                    |