@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.
Files changed (72) hide show
  1. package/CHANGELOG.md +107 -0
  2. package/CLAUDE.md +8 -8
  3. package/README.md +362 -141
  4. package/dist/ApiClient/WebSocketClient/events.d.ts +2 -0
  5. package/dist/Chat/ChatTools.d.ts +5 -49
  6. package/dist/Chat/ChatTools.js +286 -88
  7. package/dist/Chat/ChatTools.js.map +1 -1
  8. package/dist/Chat/index.d.ts +8 -4
  9. package/dist/Chat/index.js +62 -7
  10. package/dist/Chat/index.js.map +1 -1
  11. package/dist/Chat/modelRouting.d.ts +99 -0
  12. package/dist/Chat/modelRouting.js +432 -0
  13. package/dist/Chat/modelRouting.js.map +1 -0
  14. package/dist/Chat/sogniHostedTools.generated.json +507 -0
  15. package/dist/Chat/tools.d.ts +9 -55
  16. package/dist/Chat/tools.js +72 -228
  17. package/dist/Chat/tools.js.map +1 -1
  18. package/dist/Chat/types.d.ts +47 -2
  19. package/dist/CreativeWorkflows/index.d.ts +23 -0
  20. package/dist/CreativeWorkflows/index.js +274 -0
  21. package/dist/CreativeWorkflows/index.js.map +1 -0
  22. package/dist/CreativeWorkflows/types.d.ts +106 -0
  23. package/dist/CreativeWorkflows/types.js +3 -0
  24. package/dist/CreativeWorkflows/types.js.map +1 -0
  25. package/dist/Projects/Job.js +2 -1
  26. package/dist/Projects/Job.js.map +1 -1
  27. package/dist/Projects/Project.js +4 -0
  28. package/dist/Projects/Project.js.map +1 -1
  29. package/dist/Projects/createJobRequestMessage.js +132 -7
  30. package/dist/Projects/createJobRequestMessage.js.map +1 -1
  31. package/dist/Projects/index.d.ts +10 -1
  32. package/dist/Projects/index.js +134 -20
  33. package/dist/Projects/index.js.map +1 -1
  34. package/dist/Projects/types/ControlNetParams.d.ts +2 -2
  35. package/dist/Projects/types/ModelOptions.d.ts +3 -3
  36. package/dist/Projects/types/ModelOptions.js +12 -5
  37. package/dist/Projects/types/ModelOptions.js.map +1 -1
  38. package/dist/Projects/types/ModelTiersRaw.d.ts +7 -7
  39. package/dist/Projects/types/index.d.ts +65 -12
  40. package/dist/Projects/types/index.js.map +1 -1
  41. package/dist/Projects/utils/index.d.ts +21 -6
  42. package/dist/Projects/utils/index.js +55 -22
  43. package/dist/Projects/utils/index.js.map +1 -1
  44. package/dist/index.d.ts +6 -3
  45. package/dist/index.js +6 -1
  46. package/dist/index.js.map +1 -1
  47. package/dist/lib/mediaValidation.d.ts +16 -0
  48. package/dist/lib/mediaValidation.js +280 -0
  49. package/dist/lib/mediaValidation.js.map +1 -0
  50. package/llms-full.txt +388 -150
  51. package/llms.txt +214 -95
  52. package/package.json +5 -3
  53. package/src/ApiClient/WebSocketClient/events.ts +2 -0
  54. package/src/Chat/ChatTools.ts +369 -95
  55. package/src/Chat/index.ts +96 -7
  56. package/src/Chat/modelRouting.ts +555 -0
  57. package/src/Chat/sogniHostedTools.generated.json +507 -0
  58. package/src/Chat/tools.ts +98 -245
  59. package/src/Chat/types.ts +49 -2
  60. package/src/CreativeWorkflows/index.ts +290 -0
  61. package/src/CreativeWorkflows/types.ts +134 -0
  62. package/src/Projects/Job.ts +1 -1
  63. package/src/Projects/Project.ts +4 -0
  64. package/src/Projects/createJobRequestMessage.ts +145 -9
  65. package/src/Projects/index.ts +121 -21
  66. package/src/Projects/types/ControlNetParams.ts +2 -2
  67. package/src/Projects/types/ModelOptions.ts +15 -8
  68. package/src/Projects/types/ModelTiersRaw.ts +7 -7
  69. package/src/Projects/types/index.ts +65 -11
  70. package/src/Projects/utils/index.ts +57 -22
  71. package/src/index.ts +42 -0
  72. 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, LTX-2.3, and future models)
104
+ ### Standard Behavior (LTX-2.3 and future models)
105
105
 
106
- **LTX-2 / LTX-2.3 Models (`ltx2-*`, `ltx23-*`)** represent the standard behavior going forward. **LTX-2.3 (22B)** is the recommended video model family:
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 only) | `referenceVideo` + `controlNet` |
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 / LTX-2.3) | `referenceImage` + `referenceAudio` |
215
- | Audio-to-Video | `*_a2v*` (LTX-2 / LTX-2.3) | `referenceAudio` |
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