@sogni-ai/sogni-protocol 1.0.0-alpha.28 → 1.0.0-alpha.29

package/manifests/generation-tools.json

@@ -163,7 +163,7 @@
             },
             "expandPrompt": {
               "type": "boolean",
-              "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+              "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
             },
             "skipPromptProcessing": {
               "type": "boolean",
@@ -189,7 +189,7 @@
                 "3:4",
                 "9:16"
               ],
-              "description": "Wan 3 only. Output ratio. Use \"adaptive\" to inherit source/context shape; extension requires adaptive. Omit for automatic behavior."
+              "description": "Wan 3 only. Output ratio. Use \"adaptive\" to let the provider choose from the source or context; omit to use the provider default."
             },
             "watermark": {
               "type": "boolean",
@@ -825,7 +825,7 @@
             },
             "expandPrompt": {
               "type": "boolean",
-              "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+              "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
             },
             "videoSourceIndex": {
               "type": "number",
@@ -918,7 +918,7 @@
                 "edit",
                 "extend"
               ],
-              "description": "Wan 3 only. Use \"edit\" to transform the source or \"extend\" to continue it. Extension automatically uses ratio=\"adaptive\" and the prompt should explicitly describe continuation intent."
+              "description": "Wan 3 only. Use \"edit\" to transform the source or \"extend\" to continue it. For extension, explicitly describe the intended continuation."
             },
             "ratio": {
               "type": "string",
@@ -930,7 +930,7 @@
                 "3:4",
                 "9:16"
               ],
-              "description": "Wan 3 only. Extension requires \"adaptive\"; edit defaults to adaptive."
+              "description": "Wan 3 only. Output ratio. Use \"adaptive\" to let the provider choose from the source; omit to use the provider default."
             },
             "referenceFileUrl": {
               "type": "string",
@@ -1143,7 +1143,7 @@
             },
             "expandPrompt": {
               "type": "boolean",
-              "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+              "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
             },
             "negativePrompt": {
               "type": "string",

package/manifests/openai-tools.json

@@ -125,7 +125,7 @@
             },
             "expandPrompt": {
               "type": "boolean",
-              "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+              "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
             },
             "skipPromptProcessing": {
               "type": "boolean",
@@ -151,7 +151,7 @@
                 "3:4",
                 "9:16"
               ],
-              "description": "Wan 3 only. Output ratio. Use \"adaptive\" to inherit source/context shape; extension requires adaptive. Omit for automatic behavior."
+              "description": "Wan 3 only. Output ratio. Use \"adaptive\" to let the provider choose from the source or context; omit to use the provider default."
             },
             "watermark": {
               "type": "boolean",
@@ -769,7 +769,7 @@
             },
             "expandPrompt": {
               "type": "boolean",
-              "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+              "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
             },
             "videoSourceIndex": {
               "type": "number",
@@ -862,7 +862,7 @@
                 "edit",
                 "extend"
               ],
-              "description": "Wan 3 only. Use \"edit\" to transform the source or \"extend\" to continue it. Extension automatically uses ratio=\"adaptive\" and the prompt should explicitly describe continuation intent."
+              "description": "Wan 3 only. Use \"edit\" to transform the source or \"extend\" to continue it. For extension, explicitly describe the intended continuation."
             },
             "ratio": {
               "type": "string",
@@ -874,7 +874,7 @@
                 "3:4",
                 "9:16"
               ],
-              "description": "Wan 3 only. Extension requires \"adaptive\"; edit defaults to adaptive."
+              "description": "Wan 3 only. Output ratio. Use \"adaptive\" to let the provider choose from the source; omit to use the provider default."
             },
             "referenceFileUrl": {
               "type": "string",
@@ -1087,7 +1087,7 @@
             },
             "expandPrompt": {
               "type": "boolean",
-              "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+              "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
             },
             "negativePrompt": {
               "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sogni-ai/sogni-protocol",
-  "version": "1.0.0-alpha.28",
+  "version": "1.0.0-alpha.29",
   "description": "Language-neutral protocol artifacts for the Sogni ecosystem: tool schemas, prompts, OpenAI tool manifests, and enums. Consumed by every Sogni SDK (TypeScript, Swift, and future Python/Kotlin/Rust SDKs) so contracts stay in lockstep across languages.",
   "keywords": [
     "sogni",

package/schemas/tools/generate_video.schema.json

@@ -13,7 +13,7 @@
     },
     "expandPrompt": {
       "type": "boolean",
-      "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+      "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
     },
     "skipPromptProcessing": {
       "type": "boolean",
@@ -39,7 +39,7 @@
         "3:4",
         "9:16"
       ],
-      "description": "Wan 3 only. Output ratio. Use \"adaptive\" to inherit source/context shape; extension requires adaptive. Omit for automatic behavior."
+      "description": "Wan 3 only. Output ratio. Use \"adaptive\" to let the provider choose from the source or context; omit to use the provider default."
     },
     "watermark": {
       "type": "boolean",

package/schemas/tools/sound_to_video.schema.json

@@ -13,7 +13,7 @@
     },
     "expandPrompt": {
       "type": "boolean",
-      "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+      "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
     },
     "negativePrompt": {
       "type": "string",

package/schemas/tools/video_to_video.schema.json

@@ -13,7 +13,7 @@
     },
     "expandPrompt": {
       "type": "boolean",
-      "description": "Seedance and Wan 3 only. Whether to expand the prompt before dispatch. Defaults to true. For Wan 3, a successful Sogni expansion disables Alibaba prompt_extend to prevent a second rewrite; false disables both expansion layers so exact prompts remain exact."
+      "description": "Seedance and Wan 3 only. Whether to run Sogni's exact-model prompt shaper before dispatch. Defaults to true. Set false when the supplied prompt is already model-ready and must remain exact."
     },
     "videoSourceIndex": {
       "type": "number",
@@ -106,7 +106,7 @@
         "edit",
         "extend"
       ],
-      "description": "Wan 3 only. Use \"edit\" to transform the source or \"extend\" to continue it. Extension automatically uses ratio=\"adaptive\" and the prompt should explicitly describe continuation intent."
+      "description": "Wan 3 only. Use \"edit\" to transform the source or \"extend\" to continue it. For extension, explicitly describe the intended continuation."
     },
     "ratio": {
       "type": "string",
@@ -118,7 +118,7 @@
         "3:4",
         "9:16"
       ],
-      "description": "Wan 3 only. Extension requires \"adaptive\"; edit defaults to adaptive."
+      "description": "Wan 3 only. Output ratio. Use \"adaptive\" to let the provider choose from the source; omit to use the provider default."
     },
     "referenceFileUrl": {
       "type": "string",

package/version.json

@@ -1,4 +1,4 @@
 {
-  "protocolVersion": "3.1.0",
+  "protocolVersion": "3.1.1",
   "description": "Sogni protocol artifact version. SDKs may refuse to operate against a protocolVersion they were not built for. Bump the major when removing or renaming any schema / enum / manifest field; bump the minor when adding new optional fields or new tools; bump the patch for description / prose changes only."
 }