runapi-core 0.1.6__tar.gz → 0.2.1__tar.gz

{runapi_core-0.1.6 → runapi_core-0.2.1}/PKG-INFO

@@ -1,12 +1,16 @@
 Metadata-Version: 2.4
 Name: runapi-core
-Version: 0.1.6
-Summary: Core module for the RunAPI Python SDK
-Project-URL: Homepage, https://runapi.ai
-Project-URL: Documentation, https://runapi.ai/docs#sdk
+Version: 0.2.1
+Summary: RunAPI core SDK for JavaScript, Python, Ruby, Go, Java, and PHP
+Project-URL: Homepage, https://runapi.ai/models
+Project-URL: Documentation, https://runapi.ai/docs#runapi-sdks
+Project-URL: Source, https://github.com/runapi-ai/core-sdk
+Project-URL: Issues, https://github.com/runapi-ai/core-sdk/issues
+Project-URL: Changelog, https://github.com/runapi-ai/core-sdk/blob/main/CHANGELOG.md
+Project-URL: Release Notes, https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.2.1
 Author-email: RunAPI <contact@runapi.ai>
 License-Expression: Apache-2.0
-Keywords: ai,api,runapi,sdk
+Keywords: api,core,golang,gradle,java,maven,pypi,python,ruby,runapi,runapi-ai,sdk,typescript
 Requires-Python: >=3.9
 Requires-Dist: httpx>=0.27
 Description-Content-Type: text/markdown

runapi_core-0.2.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runapi-core"
+dynamic = ["version"]
+description = "RunAPI core SDK for JavaScript, Python, Ruby, Go, Java, and PHP"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
+keywords = ["runapi", "runapi-ai", "core", "api", "sdk", "typescript", "python", "ruby", "golang", "java", "pypi", "maven", "gradle"]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://runapi.ai/models"
+Documentation = "https://runapi.ai/docs#runapi-sdks"
+Source = "https://github.com/runapi-ai/core-sdk"
+Issues = "https://github.com/runapi-ai/core-sdk/issues"
+Changelog = "https://github.com/runapi-ai/core-sdk/blob/main/CHANGELOG.md"
+"Release Notes" = "https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.2.1"
+
+[tool.hatch.version]
+path = "src/runapi/core/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runapi"]
+
+[tool.uv]
+package = true
+
+[dependency-groups]
+dev = ["pytest>=8", "httpx>=0.27"]
+
+[tool.runapi]
+slug = "core"

{runapi_core-0.1.6 → runapi_core-0.2.1}/src/runapi/core/contract_gen.py

@@ -38,6 +38,13 @@ CONTRACT = {
             "text-to-speech-turbo-v2.5": {}
         }
     },
+    "fish-audio/text-to-speech": {
+        "models": ["s1", "s2-pro"],
+        "fields_by_model": {
+            "s1": {},
+            "s2-pro": {}
+        }
+    },
     "flux-2/remix-image": {
         "models": ["flux-2-flex-remix-image", "flux-2-pro-remix-image"],
         "fields_by_model": {
@@ -114,8 +121,16 @@ CONTRACT = {
         }
     },
     "gemini-omni/text-to-video": {
-        "models": ["gemini-omni-text-to-video"],
+        "models": ["gemini-omni-flash-preview", "gemini-omni-text-to-video"],
         "fields_by_model": {
+            "gemini-omni-flash-preview": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16"]
+                },
+                "output_resolution": {
+                    "enum": ["720p"]
+                }
+            },
             "gemini-omni-text-to-video": {
                 "aspect_ratio": {
                     "enum": ["16:9", "9:16"]
@@ -129,6 +144,13 @@ CONTRACT = {
             }
         }
     },
+    "gemini-tts/text-to-speech": {
+        "models": ["gemini-2.5-pro-tts", "gemini-3.1-flash-tts"],
+        "fields_by_model": {
+            "gemini-2.5-pro-tts": {},
+            "gemini-3.1-flash-tts": {}
+        }
+    },
     "gpt-4o-image/text-to-image": {
         "models": ["gpt-4o-image"],
         "fields_by_model": {
@@ -665,6 +687,12 @@ CONTRACT = {
             }
         }
     },
+    "midjourney/shorten-prompt": {
+        "models": [],
+        "fields_by_model": {
+            "_": {}
+        }
+    },
     "midjourney/text-to-image": {
         "models": ["midjourney-v8.1"],
         "fields_by_model": {
@@ -751,6 +779,23 @@ CONTRACT = {
             "omnihuman-1.5-subject-detection": {}
         }
     },
+    "openai-tts/text-to-speech": {
+        "models": ["tts-1", "tts-1-hd"],
+        "fields_by_model": {
+            "tts-1": {},
+            "tts-1-hd": {}
+        }
+    },
+    "producer/text-to-music": {
+        "models": ["fuzz-2.0"],
+        "fields_by_model": {
+            "fuzz-2.0": {
+                "vocal_mode": {
+                    "enum": ["exact_lyrics", "instrumental"]
+                }
+            }
+        }
+    },
     "qwen-2/edit-image": {
         "models": ["qwen-2-edit-image"],
         "fields_by_model": {
@@ -906,7 +951,7 @@ CONTRACT = {
         }
     },
     "seedream/edit-image": {
-        "models": ["seedream-4.5-edit", "seedream-5-lite-edit", "seedream-v4-edit"],
+        "models": ["seedream-4.5-edit", "seedream-5-lite-edit", "seedream-5-pro-edit", "seedream-v4-edit"],
         "fields_by_model": {
             "seedream-4.5-edit": {
                 "aspect_ratio": {
@@ -920,6 +965,20 @@ CONTRACT = {
                 "aspect_ratio": {
                     "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
                 },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_quality": {
+                    "enum": ["basic", "high"]
+                }
+            },
+            "seedream-5-pro-edit": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
                 "output_quality": {
                     "enum": ["basic", "high"]
                 }
@@ -938,7 +997,7 @@ CONTRACT = {
         }
     },
     "seedream/text-to-image": {
-        "models": ["seedream-4.5-text-to-image", "seedream-5-lite-text-to-image", "seedream-v4-text-to-image"],
+        "models": ["seedream-4.5-text-to-image", "seedream-5-lite-text-to-image", "seedream-5-pro-text-to-image", "seedream-v4-text-to-image"],
         "fields_by_model": {
             "seedream-4.5-text-to-image": {
                 "aspect_ratio": {
@@ -952,6 +1011,20 @@ CONTRACT = {
                 "aspect_ratio": {
                     "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
                 },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_quality": {
+                    "enum": ["basic", "high"]
+                }
+            },
+            "seedream-5-pro-text-to-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
                 "output_quality": {
                     "enum": ["basic", "high"]
                 }
@@ -1294,7 +1367,14 @@ CONTRACT = {
     "suno/separate-audio-stems": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "stem_name": {
+                    "enum": ["Lead Vocal", "Drum Kit", "Kick", "Snare", "Risers", "Bass", "Backing Vocals", "Piano", "Electric Guitar", "Percussion", "String Section", "Synth", "Acoustic Guitar", "Sound Effects", "Synth Pad", "Synth Bass", "Guitar", "Brass Section", "Organ", "Electronic Drum Kit", "Lead Electric Guitar", "Synth Keys", "Rhythm Electric Guitar", "Electric Piano", "Upright Bass", "Keyboards", "Distorted Electric Guitar", "Synth Strings", "Synth Lead", "Woodwinds", "Rhythm Acoustic Guitar", "Flute", "Harp", "Tambourine", "Trumpet", "Arpeggiator", "Accordion", "Fiddle", "Pedal Steel Guitar", "Synth Voice", "Violin", "Digital Piano", "Synth Brass", "Mandolin", "Choir", "Banjo", "Bells", "Clarinet", "Tenor Saxophone", "Trombone", "Shaker", "French Horn", "Glockenspiel", "Electric Bass", "Cello", "Timpani", "Harmonica", "Marimba", "Vibraphone", "Lap Steel Guitar", "Saxophone", "Orchestra", "Horns", "Cymbals", "Hand Clap", "Oboe", "Celesta", "Congas", "Drone", "Alto Saxophone", "Double Bass", "Ukulele", "Harpsichord", "Baritone Saxophone", "Xylophone", "Tuba", "Bass Guitar", "Whistle", "Lead Guitar", "Rhodes", "808", "Bongos", "Bassoon", "Cowbell", "Viola", "Sitar", "Steel Drums", "Piccolo", "Theremin", "Bagpipes", "Hi-Hat", "Music Box", "Melodica", "Tabla", "Koto", "Djembe", "Taiko", "Didgeridoo"]
+                },
+                "type": {
+                    "enum": ["separate_vocal", "split_stem", "split_stem_advanced"]
+                }
+            }
         }
     },
     "suno/text-to-music": {

{runapi_core-0.1.6 → runapi_core-0.2.1}/src/runapi/core/errors.py

@@ -28,6 +28,7 @@ class Error(Exception):
         self,
         message: Optional[str] = None,
         *,
+        code: Optional[str] = None,
         status: Optional[int] = None,
         request_id: Optional[str] = None,
         details: Any = None,
@@ -35,6 +36,7 @@ class Error(Exception):
     ) -> None:
         super().__init__(message)
         self.message = message
+        self.code = code
         self.status = status
         self.request_id = request_id
         self.details = details
@@ -53,6 +55,7 @@ class Error(Exception):
         data = {
             "error": type(self).__name__,
             "message": self.message,
+            "code": self.code,
             "status": self.status,
             "request_id": self.request_id,
             "details": self.details,
@@ -64,6 +67,7 @@ class AuthenticationError(Error):
     """API key is missing or invalid (HTTP 401)."""
 
     def __init__(self, message: str = "Unauthorized", *, status: int = 401, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "authentication")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -78,6 +82,7 @@ class RateLimitError(Error):
         retry_after: Optional[float] = None,
         **kwargs: Any,
     ) -> None:
+        kwargs.setdefault("code", "rate_limit")
         super().__init__(message, status=status, **kwargs)
         self.retry_after = retry_after
 
@@ -86,6 +91,7 @@ class InsufficientCreditsError(Error):
     """Account has insufficient credits (HTTP 402)."""
 
     def __init__(self, message: str = "Insufficient credits", *, status: int = 402, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "insufficient_credits")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -93,6 +99,7 @@ class NotFoundError(Error):
     """Requested resource does not exist (HTTP 404)."""
 
     def __init__(self, message: str = "Not found", *, status: int = 404, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "not_found")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -100,6 +107,7 @@ class ValidationError(Error):
     """Request validation failed (HTTP 400 / 422), or a client-side check failed."""
 
     def __init__(self, message: str = "Validation failed", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "validation")
         super().__init__(message, **kwargs)
 
 
@@ -107,6 +115,7 @@ class ServiceUnavailableError(Error):
     """Service is temporarily unavailable (HTTP 503)."""
 
     def __init__(self, message: str = "Service unavailable", *, status: Optional[int] = None, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "service_unavailable")
         super().__init__(message, status=503 if status is None else status, **kwargs)
 
 
@@ -114,6 +123,7 @@ class ConflictError(Error):
     """Request conflicts with the current resource state (HTTP 409)."""
 
     def __init__(self, message: str = "Conflict", *, status: int = 409, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "conflict")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -121,6 +131,7 @@ class ServerError(Error):
     """Server encountered an internal error (HTTP 5xx)."""
 
     def __init__(self, message: str = "Server error", *, status: Optional[int] = None, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "server")
         super().__init__(message, status=500 if status is None else status, **kwargs)
 
 
@@ -128,6 +139,7 @@ class NetworkError(Error):
     """Network connection failed or the request could not be sent."""
 
     def __init__(self, message: str = "Network error", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "network")
         super().__init__(message, **kwargs)
 
 
@@ -135,6 +147,7 @@ class TimeoutError(Error):  # noqa: A001 - intentional SDK error name, parallels
     """HTTP request exceeded the configured timeout."""
 
     def __init__(self, message: str = "Request timed out", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "timeout")
         super().__init__(message, **kwargs)
 
 
@@ -142,6 +155,7 @@ class TaskTimeoutError(Error):
     """Polling for task completion exceeded the maximum wait time."""
 
     def __init__(self, message: str = "Task polling timed out", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "task_timeout")
         super().__init__(message, **kwargs)
 
 
@@ -149,6 +163,7 @@ class TaskFailedError(Error):
     """Async task failed during processing."""
 
     def __init__(self, message: str = "Task failed", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "task_failed")
         super().__init__(message, **kwargs)
 
 
@@ -198,6 +213,7 @@ def error_from_response(response: "Any") -> Error:
     error_class = STATUS_MAP.get(status, Error)
 
     kwargs: Dict[str, Any] = {
+        "code": _extract_code(parsed_body),
         "status": status,
         "request_id": request_id,
         "details": parsed_body,
@@ -209,6 +225,16 @@ def error_from_response(response: "Any") -> Error:
     return error_class(message, **kwargs)
 
 
+def _extract_code(body: Any) -> Optional[str]:
+    if not isinstance(body, dict):
+        return None
+    error = body.get("error")
+    if not isinstance(error, dict):
+        return None
+    code = error.get("code")
+    return code if isinstance(code, str) and code else None
+
+
 def _parse_body(body: Optional[str]) -> Any:
     if not body:
         return None

{runapi_core-0.1.6 → runapi_core-0.2.1}/src/runapi/core/resource.py

@@ -79,13 +79,16 @@ class Resource:
             self._validate_schema_field(params, field, rules)
 
     def _validate_schema_field(self, params: Dict[str, Any], field: str, rules: Dict[str, Any]) -> None:
+        value = params.get(field)
+        if value is not None and ("min_items" in rules or "max_items" in rules):
+            self._validate_item_count(field, value, rules)
+
         present = self._field_present(params, field)
         if rules.get("required") and not present:
             raise ValidationError(f"{field} is required")
         if not present:
             return
 
-        value = params[field]
         enum = rules.get("enum")
         if enum is not None and not self._enum_allowed(enum, value):
             raise ValidationError(f"{field} must be one of: {', '.join(str(option) for option in enum)}")
@@ -96,6 +99,24 @@ class Resource:
         if "min" in rules or "max" in rules:
             self._validate_range(field, value, rules)
 
+    def _validate_item_count(self, field: str, value: Any, rules: Dict[str, Any]) -> None:
+        if not isinstance(value, (list, tuple)):
+            raise ValidationError(f"{field} must be an array")
+
+        minimum = rules.get("min_items")
+        maximum = rules.get("max_items")
+        if (minimum is None or len(value) >= minimum) and (maximum is None or len(value) <= maximum):
+            return
+        raise ValidationError(self._item_count_message(field, minimum, maximum))
+
+    @staticmethod
+    def _item_count_message(field: str, minimum: Any, maximum: Any) -> str:
+        if minimum is not None and maximum is not None:
+            return f"{field} must contain between {minimum} and {maximum} items"
+        if minimum is not None:
+            return f"{field} must contain at least {minimum} items"
+        return f"{field} must contain at most {maximum} items"
+
     @staticmethod
     def _validate_integer(field: str, value: Any, rules: Dict[str, Any]) -> None:
         # Mirrors GatewayEntry#validate_schema_integer!: a type: integer field

runapi_core-0.2.1/src/runapi/core/version.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"

{runapi_core-0.1.6 → runapi_core-0.2.1}/tests/test_errors.py

@@ -70,6 +70,36 @@ def test_extracts_message_from_nested_error():
     assert error.message == "Nested message"
 
 
+def test_preserves_explicit_http_error_code_and_leaves_missing_code_none():
+    explicit = errors.error_from_response(
+        response(409, body='{"error":{"code":"source_task_not_ready","message":"wait"}}')
+    )
+    missing = errors.error_from_response(response(409, body='{"error":{"message":"wait"}}'))
+
+    assert explicit.code == "source_task_not_ready"
+    assert missing.code is None
+
+
+def test_continuation_errors_preserve_codes_and_status_classification():
+    cases = [
+        (400, "invalid_resource_id", errors.ValidationError),
+        (409, "request_conflict", errors.ConflictError),
+        (409, "source_task_not_ready", errors.ConflictError),
+        (422, "source_task_unusable", errors.ValidationError),
+        (422, "continuation_not_supported", errors.ValidationError),
+        (429, "rate_limited", errors.RateLimitError),
+        (503, "continuation_unavailable", errors.ServiceUnavailableError),
+    ]
+
+    for status, code, error_class in cases:
+        error = errors.error_from_response(
+            response(status, body=f'{{"error":{{"code":"{code}","message":"failed"}}}}')
+        )
+        assert isinstance(error, error_class)
+        assert error.status == status
+        assert error.code == code
+
+
 def test_extracts_message_from_errors_array():
     error = errors.error_from_response(response(400, body='{"errors":["First error"]}'))
     assert error.message == "First error"
@@ -99,6 +129,7 @@ def test_to_dict_is_compact():
     assert error.to_dict() == {
         "error": "AuthenticationError",
         "message": "Bad key",
+        "code": "authentication",
         "status": 401,
         "request_id": "req-1",
     }

{runapi_core-0.1.6 → runapi_core-0.2.1}/tests/test_resource.py

@@ -135,6 +135,30 @@ def test_validate_integer_rejects_bool_and_whole_float():
     assert _run_validate({"model": "m", "tolerance": 5}) == ""
 
 
+def test_validate_array_item_count_constraints():
+    schema = {
+        "models": ["m"],
+        "fields_by_model": {
+            "m": {
+                "reference_image_urls": {"min_items": 1, "max_items": 3},
+            }
+        },
+    }
+    resource = SampleResource(FakeHttp())
+
+    with pytest.raises(ValidationError, match="^reference_image_urls must be an array$"):
+        resource._validate_contract(schema, {"model": "m", "reference_image_urls": "image.png"})
+    with pytest.raises(ValidationError, match="^reference_image_urls must contain between 1 and 3 items$"):
+        resource._validate_contract(schema, {"model": "m", "reference_image_urls": []})
+    with pytest.raises(ValidationError, match="^reference_image_urls must contain between 1 and 3 items$"):
+        resource._validate_contract(schema, {"model": "m", "reference_image_urls": ["a", "b", "c", "d"]})
+    with pytest.raises(ValidationError, match="^reference_image_urls must contain between 1 and 3 items$"):
+        resource._validate_contract(schema, {"model": "m", "reference_image_urls": ("a", "b", "c", "d")})
+
+    resource._validate_contract(schema, {"model": "m", "reference_image_urls": ["a", "b", "c"]})
+    resource._validate_contract(schema, {"model": "m", "reference_image_urls": ("a", "b", "c")})
+
+
 def test_validate_contract_runs_rules_before_field_requirements():
     schema = {
         "models": ["m"],

runapi_core-0.1.6/pyproject.toml

@@ -1,33 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "runapi-core"
-dynamic = ["version"]
-description = "Core module for the RunAPI Python SDK"
-readme = "README.md"
-requires-python = ">=3.9"
-license = "Apache-2.0"
-authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
-keywords = ["runapi", "ai", "sdk", "api"]
-dependencies = ["httpx>=0.27"]
-
-[project.urls]
-Homepage = "https://runapi.ai"
-Documentation = "https://runapi.ai/docs#sdk"
-
-[tool.hatch.version]
-path = "src/runapi/core/version.py"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/runapi"]
-
-[tool.uv]
-package = true
-
-[dependency-groups]
-dev = ["pytest>=8", "httpx>=0.27"]
-
-[tool.runapi]
-slug = "core"

runapi_core-0.1.6/src/runapi/core/version.py

@@ -1 +0,0 @@
-__version__ = "0.1.6"