@sogni-ai/sogni-client 4.1.1 → 4.2.0-alpha.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +107 -0
- package/CLAUDE.md +8 -8
- package/README.md +362 -141
- package/dist/ApiClient/WebSocketClient/events.d.ts +2 -0
- package/dist/Chat/ChatTools.d.ts +5 -49
- package/dist/Chat/ChatTools.js +286 -88
- package/dist/Chat/ChatTools.js.map +1 -1
- package/dist/Chat/index.d.ts +8 -4
- package/dist/Chat/index.js +62 -7
- package/dist/Chat/index.js.map +1 -1
- package/dist/Chat/modelRouting.d.ts +99 -0
- package/dist/Chat/modelRouting.js +432 -0
- package/dist/Chat/modelRouting.js.map +1 -0
- package/dist/Chat/sogniHostedTools.generated.json +507 -0
- package/dist/Chat/tools.d.ts +9 -55
- package/dist/Chat/tools.js +72 -228
- package/dist/Chat/tools.js.map +1 -1
- package/dist/Chat/types.d.ts +47 -2
- package/dist/CreativeWorkflows/index.d.ts +23 -0
- package/dist/CreativeWorkflows/index.js +274 -0
- package/dist/CreativeWorkflows/index.js.map +1 -0
- package/dist/CreativeWorkflows/types.d.ts +106 -0
- package/dist/CreativeWorkflows/types.js +3 -0
- package/dist/CreativeWorkflows/types.js.map +1 -0
- package/dist/Projects/Job.js +2 -1
- package/dist/Projects/Job.js.map +1 -1
- package/dist/Projects/Project.js +4 -0
- package/dist/Projects/Project.js.map +1 -1
- package/dist/Projects/createJobRequestMessage.js +132 -7
- package/dist/Projects/createJobRequestMessage.js.map +1 -1
- package/dist/Projects/index.d.ts +10 -1
- package/dist/Projects/index.js +134 -20
- package/dist/Projects/index.js.map +1 -1
- package/dist/Projects/types/ControlNetParams.d.ts +2 -2
- package/dist/Projects/types/ModelOptions.d.ts +3 -3
- package/dist/Projects/types/ModelOptions.js +12 -5
- package/dist/Projects/types/ModelOptions.js.map +1 -1
- package/dist/Projects/types/ModelTiersRaw.d.ts +7 -7
- package/dist/Projects/types/index.d.ts +65 -12
- package/dist/Projects/types/index.js.map +1 -1
- package/dist/Projects/utils/index.d.ts +21 -6
- package/dist/Projects/utils/index.js +55 -22
- package/dist/Projects/utils/index.js.map +1 -1
- package/dist/index.d.ts +6 -3
- package/dist/index.js +6 -1
- package/dist/index.js.map +1 -1
- package/dist/lib/mediaValidation.d.ts +16 -0
- package/dist/lib/mediaValidation.js +280 -0
- package/dist/lib/mediaValidation.js.map +1 -0
- package/llms-full.txt +388 -150
- package/llms.txt +214 -95
- package/package.json +5 -3
- package/src/ApiClient/WebSocketClient/events.ts +2 -0
- package/src/Chat/ChatTools.ts +369 -95
- package/src/Chat/index.ts +96 -7
- package/src/Chat/modelRouting.ts +555 -0
- package/src/Chat/sogniHostedTools.generated.json +507 -0
- package/src/Chat/tools.ts +98 -245
- package/src/Chat/types.ts +49 -2
- package/src/CreativeWorkflows/index.ts +290 -0
- package/src/CreativeWorkflows/types.ts +134 -0
- package/src/Projects/Job.ts +1 -1
- package/src/Projects/Project.ts +4 -0
- package/src/Projects/createJobRequestMessage.ts +145 -9
- package/src/Projects/index.ts +121 -21
- package/src/Projects/types/ControlNetParams.ts +2 -2
- package/src/Projects/types/ModelOptions.ts +15 -8
- package/src/Projects/types/ModelTiersRaw.ts +7 -7
- package/src/Projects/types/index.ts +65 -11
- package/src/Projects/utils/index.ts +57 -22
- package/src/index.ts +42 -0
- package/src/lib/mediaValidation.ts +367 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,110 @@
|
|
|
1
|
+
# [4.2.0-alpha.10](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.9...v4.2.0-alpha.10) (2026-05-01)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Features
|
|
5
|
+
|
|
6
|
+
* **seedance:** add guided partner video workflow ([36b8880](https://github.com/Sogni-AI/sogni-client/commit/36b8880f6fd33e3cfc7eeb0a828a2f3663c57996))
|
|
7
|
+
|
|
8
|
+
# [4.2.0-alpha.9](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.8...v4.2.0-alpha.9) (2026-04-30)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Bug Fixes
|
|
12
|
+
|
|
13
|
+
* **seedance:** omit negative prompt in example workflow ([07a0973](https://github.com/Sogni-AI/sogni-client/commit/07a0973dfebd44b082ebc3b6883fd21b1761d576))
|
|
14
|
+
|
|
15
|
+
# [4.2.0-alpha.8](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.7...v4.2.0-alpha.8) (2026-04-30)
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
### Bug Fixes
|
|
19
|
+
|
|
20
|
+
* **projects:** share negative prompt params ([9545e95](https://github.com/Sogni-AI/sogni-client/commit/9545e956ccedecff499d00e8ad02b8c877aacf11))
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
### Features
|
|
24
|
+
|
|
25
|
+
* **seedance:** support multimodal context references ([4f1a0ec](https://github.com/Sogni-AI/sogni-client/commit/4f1a0ecfbb958bfc8f5d4e2e43f79fee718314dc))
|
|
26
|
+
|
|
27
|
+
# [4.2.0-alpha.7](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.6...v4.2.0-alpha.7) (2026-04-30)
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
### Bug Fixes
|
|
31
|
+
|
|
32
|
+
* align Seedance video tool handling ([337af3a](https://github.com/Sogni-AI/sogni-client/commit/337af3ad0aaf9e0ddc15d6f01c4f235691806e71))
|
|
33
|
+
|
|
34
|
+
# [4.2.0-alpha.6](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.5...v4.2.0-alpha.6) (2026-04-30)
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
### Features
|
|
38
|
+
|
|
39
|
+
* centralize chat model routing ([51a0841](https://github.com/Sogni-AI/sogni-client/commit/51a084119966fa2239512fdad1e2b549b83bd098))
|
|
40
|
+
* **chat:** align hosted tool routing helpers ([bf57eca](https://github.com/Sogni-AI/sogni-client/commit/bf57eca06e255429dd43a4e2614006be774967f3))
|
|
41
|
+
* **chat:** expose server-side Sogni tool controls ([7218ee7](https://github.com/Sogni-AI/sogni-client/commit/7218ee7f7cd11b85e2f3c7c1dd42fc68c89734bf))
|
|
42
|
+
* generate hosted chat tool definitions ([2e56f57](https://github.com/Sogni-AI/sogni-client/commit/2e56f57a9f1acb72ce6c2d4744edaa291fc19582))
|
|
43
|
+
|
|
44
|
+
# [4.2.0-alpha.5](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.4...v4.2.0-alpha.5) (2026-04-22)
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
### Bug Fixes
|
|
48
|
+
|
|
49
|
+
* validate inline media inputs for tools and vision requests ([c4bd7c1](https://github.com/Sogni-AI/sogni-client/commit/c4bd7c15cd530896065cf5ed41cd280b5db63938))
|
|
50
|
+
|
|
51
|
+
# [4.2.0-alpha.4](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.3...v4.2.0-alpha.4) (2026-04-22)
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
### Features
|
|
55
|
+
|
|
56
|
+
* expand chat sogni media tools ([fb0d6c7](https://github.com/Sogni-AI/sogni-client/commit/fb0d6c77e4b73fbbe57d8b64b4a37bb610eb8c68))
|
|
57
|
+
|
|
58
|
+
# [4.2.0-alpha.3](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.2...v4.2.0-alpha.3) (2026-04-20)
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
### Bug Fixes
|
|
62
|
+
|
|
63
|
+
* use thinkingComplexDefault in LLMModelInfo cost estimates ([162011f](https://github.com/Sogni-AI/sogni-client/commit/162011f698b56229629cea8d09fad1b3e313294f))
|
|
64
|
+
|
|
65
|
+
# [4.2.0-alpha.2](https://github.com/Sogni-AI/sogni-client/compare/v4.2.0-alpha.1...v4.2.0-alpha.2) (2026-04-20)
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
### Features
|
|
69
|
+
|
|
70
|
+
* update qwen3.6 chat presets and examples ([96b3e23](https://github.com/Sogni-AI/sogni-client/commit/96b3e23169780874ca8273305e2fd4171d0d8dd3))
|
|
71
|
+
|
|
72
|
+
# [4.2.0-alpha.1](https://github.com/Sogni-AI/sogni-client/compare/v4.1.1...v4.2.0-alpha.1) (2026-04-06)
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
### Bug Fixes
|
|
76
|
+
|
|
77
|
+
* allow up to 20s duration for Wan Animate Move/Replace models (321 frames) ([23897fa](https://github.com/Sogni-AI/sogni-client/commit/23897fa3eeacc997548390d4a41569a424ba1485))
|
|
78
|
+
* update LTX-2.3 dev defaults to match tuned workflow parameters ([7ca69ab](https://github.com/Sogni-AI/sogni-client/commit/7ca69ab828bf821cf19438687d0eecd090a7e54c))
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
### Features
|
|
82
|
+
|
|
83
|
+
* add ID-LoRA speaker identity transfer support (referenceAudioIdentity) ([4969cce](https://github.com/Sogni-AI/sogni-client/commit/4969cce72c46d7527a8d66ff251adc1e9d022013))
|
|
84
|
+
* add top_k parameter and server-provided sampling defaults for thinking modes ([ad4ac85](https://github.com/Sogni-AI/sogni-client/commit/ad4ac85e75fad0c7d18af976fe03d4d90c6c5f3d))
|
|
85
|
+
|
|
86
|
+
# [4.1.0-alpha.8](https://github.com/Sogni-AI/sogni-client/compare/v4.1.0-alpha.7...v4.1.0-alpha.8) (2026-03-29)
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
### Features
|
|
90
|
+
|
|
91
|
+
* add ID-LoRA speaker identity transfer support (referenceAudioIdentity) ([4969cce](https://github.com/Sogni-AI/sogni-client/commit/4969cce72c46d7527a8d66ff251adc1e9d022013))
|
|
92
|
+
|
|
93
|
+
# [4.1.0-alpha.7](https://github.com/Sogni-AI/sogni-client/compare/v4.1.0-alpha.6...v4.1.0-alpha.7) (2026-03-24)
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
### Features
|
|
97
|
+
|
|
98
|
+
* add top_k parameter and server-provided sampling defaults for thinking modes ([ad4ac85](https://github.com/Sogni-AI/sogni-client/commit/ad4ac85e75fad0c7d18af976fe03d4d90c6c5f3d))
|
|
99
|
+
|
|
100
|
+
# [4.1.0-alpha.6](https://github.com/Sogni-AI/sogni-client/compare/v4.1.0-alpha.5...v4.1.0-alpha.6) (2026-03-23)
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
### Bug Fixes
|
|
104
|
+
|
|
105
|
+
* allow up to 20s duration for Wan Animate Move/Replace models (321 frames) ([23897fa](https://github.com/Sogni-AI/sogni-client/commit/23897fa3eeacc997548390d4a41569a424ba1485))
|
|
106
|
+
* update LTX-2.3 dev defaults to match tuned workflow parameters ([7ca69ab](https://github.com/Sogni-AI/sogni-client/commit/7ca69ab828bf821cf19438687d0eecd090a7e54c))
|
|
107
|
+
|
|
1
108
|
## [4.1.1](https://github.com/Sogni-AI/sogni-client/compare/v4.1.0...v4.1.1) (2026-03-25)
|
|
2
109
|
|
|
3
110
|
|
package/CLAUDE.md
CHANGED
|
@@ -11,11 +11,11 @@ For AI coding assistants working with this SDK, the following resources are avai
|
|
|
11
11
|
- **`dist/index.d.ts`** - TypeScript type definitions (after build)
|
|
12
12
|
- **API Docs**: https://sdk-docs.sogni.ai
|
|
13
13
|
|
|
14
|
-
When helping users with Sogni SDK tasks, consult `llms-full.txt` for complete parameter references, especially for video generation where WAN 2.2 and LTX-2 models have different behaviors.
|
|
14
|
+
When helping users with Sogni SDK tasks, consult `llms-full.txt` for complete parameter references, especially for video generation where WAN 2.2 and LTX-2.3 models have different behaviors.
|
|
15
15
|
|
|
16
16
|
## Overview
|
|
17
17
|
|
|
18
|
-
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, etc.), video generation (WAN 2.2 and LTX-2 models), audio generation (ACE-Step 1.5), LLM chat with tool calling, and multimodal vision chat (Qwen3.5 VLM) via WebSocket communication.
|
|
18
|
+
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, etc.), video generation (WAN 2.2 and LTX-2.3 models), audio generation (ACE-Step 1.5), LLM chat with tool calling, and multimodal vision chat (Qwen3.5 VLM) via WebSocket communication.
|
|
19
19
|
|
|
20
20
|
## Build & Development Commands
|
|
21
21
|
|
|
@@ -101,9 +101,9 @@ src/
|
|
|
101
101
|
|
|
102
102
|
The SDK supports two families of video models with **fundamentally different FPS and frame count behavior**.
|
|
103
103
|
|
|
104
|
-
### Standard Behavior (LTX-2
|
|
104
|
+
### Standard Behavior (LTX-2.3 and future models)
|
|
105
105
|
|
|
106
|
-
**LTX-2
|
|
106
|
+
**LTX-2.3 Models (`ltx2-*`, `ltx23-*`)** represent the standard behavior going forward. **LTX-2.3 (22B)** is the recommended video model family:
|
|
107
107
|
- **Generate at the actual specified FPS** (1-60 fps range)
|
|
108
108
|
- No post-render interpolation - fps directly affects generation
|
|
109
109
|
- **Frame calculation**: `duration * fps + 1`
|
|
@@ -146,7 +146,7 @@ This repository uses **conventional commits** for semantic versioning of the npm
|
|
|
146
146
|
**Examples:**
|
|
147
147
|
```
|
|
148
148
|
feat: Add support for new video model
|
|
149
|
-
fix: Correct frame calculation for LTX-2 models
|
|
149
|
+
fix: Correct frame calculation for LTX-2.3 models
|
|
150
150
|
chore: Update example scripts for video generation
|
|
151
151
|
```
|
|
152
152
|
|
|
@@ -209,10 +209,10 @@ const urls = await project.waitForCompletion();
|
|
|
209
209
|
|----------|---------------|-----------------|
|
|
210
210
|
| Text-to-Video | `*_t2v*` | None |
|
|
211
211
|
| Image-to-Video | `*_i2v*` | `referenceImage` (and/or `referenceImageEnd`) |
|
|
212
|
-
| Video-to-Video | `*_v2v*` (LTX-2
|
|
212
|
+
| Video-to-Video | `*_v2v*` (LTX-2.3) | `referenceVideo` + `controlNet` |
|
|
213
213
|
| Sound-to-Video | `*_s2v*` (WAN only) | `referenceImage` + `referenceAudio` |
|
|
214
|
-
| Image+Audio-to-Video | `*_ia2v*` (LTX-2
|
|
215
|
-
| Audio-to-Video | `*_a2v*` (LTX-2
|
|
214
|
+
| Image+Audio-to-Video | `*_ia2v*` (LTX-2.3) | `referenceImage` + `referenceAudio` |
|
|
215
|
+
| Audio-to-Video | `*_a2v*` (LTX-2.3) | `referenceAudio` |
|
|
216
216
|
| Animate-Move | `*_animate-move*` | `referenceImage` + `referenceVideo` |
|
|
217
217
|
| Animate-Replace | `*_animate-replace*` | `referenceImage` + `referenceVideo` |
|
|
218
218
|
|