@sogni-ai/sogni-protocol 1.0.0-alpha.20 → 1.0.0-alpha.22

package/enums/tool-names.json

@@ -24,6 +24,7 @@
     "restore_photo",
     "sound_to_video",
     "stitch_video",
+    "upscale_image",
     "video_to_video"
   ],
   "app": [
@@ -74,6 +75,7 @@
     "set_content_filter",
     "sound_to_video",
     "stitch_video",
+    "upscale_image",
     "validate_asset_references",
     "video_to_video"
   ],

package/manifests/generation-tools.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-08-14.1",
+  "version": "2026-08-14.2",
   "source": "sogni-creative-agent/src/tools/definitions/*/definition.ts",
   "schemaRefs": {
     "generate_image": "../schemas/tools/generate_image.schema.json",
@@ -8,6 +8,7 @@
     "edit_image": "../schemas/tools/edit_image.schema.json",
     "apply_style": "../schemas/tools/apply_style.schema.json",
     "restore_photo": "../schemas/tools/restore_photo.schema.json",
+    "upscale_image": "../schemas/tools/upscale_image.schema.json",
     "refine_result": "../schemas/tools/refine_result.schema.json",
     "animate_photo": "../schemas/tools/animate_photo.schema.json",
     "change_angle": "../schemas/tools/change_angle.schema.json",
@@ -464,6 +465,38 @@
         }
       }
     },
+    {
+      "type": "function",
+      "function": {
+        "name": "upscale_image",
+        "description": "Enlarge an existing image with NVIDIA RTX Video Super Resolution while preserving its content, identity, composition, and colors. This is deterministic reconstruction, not a generative edit: it takes no prompt and must not be used for restoration, sharpening requests that imply repainting, object changes, style changes, or creative enhancement. Use it when the user asks to upscale, enlarge, increase resolution, prepare for print, or produce a 2K/4K/6K/8K/16K copy without changing the image.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "sourceImageIndex": {
+              "type": "number",
+              "description": "Source image to upscale. Non-negative values select a prior generated result by 0-based index. Negative values select uploads: -1 is the first uploaded image, -2 the second, and so on. If omitted, use the latest generated image, falling back to the first upload."
+            },
+            "scale": {
+              "type": "number",
+              "enum": [
+                2,
+                3,
+                4
+              ],
+              "description": "Edge scale multiplier. Use 2 by default. Ignored when targetLongestEdge is supplied. If that scale would leave either aligned output edge below 512px, the tool reports the minimum valid target instead of stretching the image."
+            },
+            "targetLongestEdge": {
+              "type": "number",
+              "minimum": 512,
+              "maximum": 15360,
+              "description": "Optional requested pixel length for the output longest edge, from 512 through 15360. Use 3840 for 4K UHD, 7680 for 8K, or 15360 for the 16K maximum. The other edge is calculated automatically so the source aspect ratio is preserved; both 8px-aligned output edges must be at least 512px."
+            }
+          },
+          "required": []
+        }
+      }
+    },
     {
       "type": "function",
       "function": {

package/manifests/openai-tools.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-08-14.1",
+  "version": "2026-08-14.2",
   "source": "@sogni-ai/sogni-protocol hosted creative-tools surface (generation + composition)",
   "generatedAt": null,
   "tools": [
@@ -445,6 +445,38 @@
         }
       }
     },
+    {
+      "type": "function",
+      "function": {
+        "name": "upscale_image",
+        "description": "Enlarge an existing image with NVIDIA RTX Video Super Resolution while preserving its content, identity, composition, and colors. This is deterministic reconstruction, not a generative edit: it takes no prompt and must not be used for restoration, sharpening requests that imply repainting, object changes, style changes, or creative enhancement. Use it when the user asks to upscale, enlarge, increase resolution, prepare for print, or produce a 2K/4K/6K/8K/16K copy without changing the image.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "sourceImageIndex": {
+              "type": "number",
+              "description": "Source image to upscale. Non-negative values select a prior generated result by 0-based index. Negative values select uploads: -1 is the first uploaded image, -2 the second, and so on. If omitted, use the latest generated image, falling back to the first upload."
+            },
+            "scale": {
+              "type": "number",
+              "enum": [
+                2,
+                3,
+                4
+              ],
+              "description": "Edge scale multiplier. Use 2 by default. Ignored when targetLongestEdge is supplied. If that scale would leave either aligned output edge below 512px, the tool reports the minimum valid target instead of stretching the image."
+            },
+            "targetLongestEdge": {
+              "type": "number",
+              "minimum": 512,
+              "maximum": 15360,
+              "description": "Optional requested pixel length for the output longest edge, from 512 through 15360. Use 3840 for 4K UHD, 7680 for 8K, or 15360 for the 16K maximum. The other edge is calculated automatically so the source aspect ratio is preserved; both 8px-aligned output edges must be at least 512px."
+            }
+          },
+          "required": []
+        }
+      }
+    },
     {
       "type": "function",
       "function": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sogni-ai/sogni-protocol",
-  "version": "1.0.0-alpha.20",
+  "version": "1.0.0-alpha.22",
   "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/upscale_image.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.sogni.ai/creative-agent/2026-07-18.1/tools/upscale_image.schema.json",
+  "title": "upscale_image arguments",
+  "schemaVersion": "2026-07-18.1",
+  "description": "Enlarge an existing image with NVIDIA RTX Video Super Resolution while preserving its content, identity, composition, and colors. This is deterministic reconstruction, not a generative edit: it takes no prompt and must not be used for restoration, sharpening requests that imply repainting, object changes, style changes, or creative enhancement. Use it when the user asks to upscale, enlarge, increase resolution, prepare for print, or produce a 2K/4K/6K/8K/16K copy without changing the image.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sourceImageIndex": {
+      "type": "number",
+      "description": "Source image to upscale. Non-negative values select a prior generated result by 0-based index. Negative values select uploads: -1 is the first uploaded image, -2 the second, and so on. If omitted, use the latest generated image, falling back to the first upload."
+    },
+    "scale": {
+      "type": "number",
+      "enum": [
+        2,
+        3,
+        4
+      ],
+      "description": "Edge scale multiplier. Use 2 by default. Ignored when targetLongestEdge is supplied. If that scale would leave either aligned output edge below 512px, the tool reports the minimum valid target instead of stretching the image."
+    },
+    "targetLongestEdge": {
+      "type": "number",
+      "minimum": 512,
+      "maximum": 15360,
+      "description": "Optional requested pixel length for the output longest edge, from 512 through 15360. Use 3840 for 4K UHD, 7680 for 8K, or 15360 for the 16K maximum. The other edge is calculated automatically so the source aspect ratio is preserved; both 8px-aligned output edges must be at least 512px."
+    }
+  },
+  "required": []
+}

package/schemas/workflows/durable-workflow-run.schema.json

@@ -38,6 +38,7 @@
               "edit_image",
               "apply_style",
               "restore_photo",
+              "upscale_image",
               "refine_result",
               "animate_photo",
               "change_angle",

package/version.json

@@ -1,4 +1,4 @@
 {
-  "protocolVersion": "1.12.0",
+  "protocolVersion": "1.14.0",
   "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."
 }