phaseo 2.0.4__tar.gz → 2.0.6__tar.gz

phaseo-2.0.6/.gitignore

@@ -0,0 +1,4 @@
+dist/
+*.egg-info/
+__pycache__/
+.pytest_cache/

phaseo-2.0.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel Butler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

phaseo-2.0.6/NOTICE

@@ -0,0 +1,7 @@
+Phaseo - Official SDK for JavaScript and TypeScript
+Copyright (c) 2025 Daniel Butler
+
+Licensed under the MIT Licence.
+See the LICENSE file in this directory for details.
+
+This product includes software developed by Phaseo (https://phaseo.app).

phaseo-2.0.6/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: phaseo
+Version: 2.0.6
+Summary: Phaseo Gateway SDK for Python.
+Project-URL: Homepage, https://phaseo.app
+Project-URL: Documentation, https://phaseo.app
+Project-URL: Repository, https://github.com/phaseoteam/Phaseo
+Project-URL: Issues, https://github.com/phaseoteam/Phaseo/issues
+Author-email: Phaseo <danielbutler500@gmail.com>
+License: MIT
+License-File: LICENSE
+License-File: NOTICE
+Keywords: ai,gateway,llm,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0.0,>=0.27.2
+Requires-Dist: pydantic<3.0,>=2.6
+Requires-Dist: python-dateutil<3.0,>=2.9
+Requires-Dist: typing-extensions>=4.8.0
+Description-Content-Type: text/markdown
+
+# Phaseo Python SDK
+
+Official Python SDK for Phaseo Gateway.
+
+## Installation
+
+```bash
+pip install phaseo
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+from phaseo import Phaseo
+
+client = Phaseo()  # Uses PHASEO_API_KEY from environment
+
+response = client.responses.create(
+    {
+        "model": "google/gemma-3-27b:free",
+        "input": "Reply with: Python SDK works",
+    }
+)
+
+print(response.get("output_text"))
+```
+
+## Streaming example
+
+```python
+from phaseo import Phaseo
+
+client = Phaseo()
+
+response = ""
+for chunk in client.stream_chat(
+    {
+        "model": "google/gemma-3-27b:free",
+        "messages": [{"role": "user", "content": "Stream hi"}],
+    }
+):
+    if chunk.get("text"):
+        response += chunk["text"]
+        print(chunk["text"], end="", flush=True)
+
+    if chunk.get("reasoning_tokens"):
+        print("\nReasoning tokens:", chunk["reasoning_tokens"])
+```
+
+## Common methods
+
+- `client.responses.create(...)`
+- `client.chat.completions.create(...)`
+- `client.messages.create(...)`
+- `client.stream_chat(...)`, `client.stream_responses(...)`, and `client.stream_message(...)` for parsed streaming chunks with `text`, `usage`, and `reasoning_tokens`
+- `client.models.list(...)`
+- `client.list_organisations(...)` for paginated `/organisations` discovery
+- `client.list_pricing_models(...)` for `/pricing/models` catalogue pricing discovery
+- `client.calculate_pricing(...)` for `/pricing/calculate` usage estimation
+- `client.list_providers(...)`, `client.get_credits(...)`, `client.get_activity(...)`, and `client.get_analytics(...)` for provider discovery and management-key usage surfaces
+- `client.list_api_keys(...)` for management-key `/keys` discovery
+- `client.create_api_key(...)`, `client.update_api_key(key_id, ...)`, and `client.delete_api_key(key_id)` for management-key API-key lifecycle changes
+- `client.get_api_key(key_id)` for management-key `/keys/{id}` lookup
+- `client.list_workspaces(...)`, `client.get_workspace(workspace_id)`, `client.create_workspace(...)`, `client.update_workspace(workspace_id, ...)`, and `client.delete_workspace(workspace_id)` for management-key workspace lifecycle management
+- `client.get_current_api_key()`
+- `client.get_health()`
+- `client.models.get_deprecation_info(model_id)`
+- `client.models.validate(model_id)`
+- `client.batches.list_models()` for batch-capable models and supported batch parameter metadata
+
+Model discovery supports the public `/models` filters, including `provider`, `provider_status`, `provider_routing_status`, `model_routing_status`, `capability_status`, `provider_availability_status`, `provider_availability_reason`, `status`, `organisation`, `endpoints`, `input_types`, `output_types`, `params`, `availability`, `limit`, and `offset`.
+
+Use `provider_availability_reason` with `availability="all"` when you want rollout-state entries such as `preview_only`, `provider_not_ready`, `gated`, `access_limited`, `region_limited`, `project_limited`, `paused`, or `soft_blocked`. Use `capability_status` with `availability="all"` when you want non-routable endpoint mappings such as `coming_soon` or `internal_testing`.
+
+```python
+models = client.get_models({
+    "provider": ["anthropic"],
+    "provider_status": ["beta", "not_ready"],
+    "provider_availability_reason": ["preview_only", "provider_not_ready"],
+    "capability_status": ["coming_soon", "internal_testing"],
+    "availability": "all",
+})
+```
+
+## Async job websocket helpers
+
+Batch and video operations can expose a websocket lifecycle stream at `/v1/async/{kind}/{id}/ws`.
+Create responses include the job id, polling URL, optional websocket URL, and sanitized webhook delivery state.
+
+```python
+import os
+
+batch = client.batches.create({
+    "endpoint": "/v1/responses",
+    "input_file_id": "file_123",
+    "completion_window": "24h",
+    "webhook": {
+        "url": "https://example.com/phaseo/webhooks",
+        "secret": os.environ["PHASEO_WEBHOOK_SECRET"],
+        "events": ["batch.progress", "batch.completed", "batch.failed"],
+    },
+})
+
+video = client.videos.create({
+    "model": "google/veo-3",
+    "prompt": "orbital reveal",
+    "webhook": {
+        "url": "https://example.com/phaseo/webhooks",
+        "secret": os.environ["PHASEO_WEBHOOK_SECRET"],
+        "events": ["video.progress", "video.completed", "video.failed"],
+    },
+})
+```
+
+```python
+batch_socket_url = client.batches.websocket_url("batch_123", interval_ms=1500)
+
+video_socket_url = client.videos.websocket_url(
+    "video_123",
+    close_on_terminal=True,
+)
+
+generic_socket_url = client.get_async_job_websocket_url("video", "video_123")
+```
+
+## Free and paid models
+
+- Models with `:free` in the model ID can be called with zero deposited credits.
+- Paid models require available wallet balance.
+
+## Model lifecycle warnings
+
+```python
+from phaseo import Phaseo
+
+client = Phaseo(
+    enable_deprecation_warnings=True,
+    warnings_as_errors=False,
+    logger=lambda level, message, meta: print(level, message, meta),
+)
+```
+
+## Environment variables
+
+- `PHASEO_API_KEY` (required unless passed in code)
+- `PHASEO_BASE_URL` (optional, defaults to `https://api.phaseo.app/v1`)
+
+## Devtools
+
+```python
+from phaseo import Phaseo, create_phaseo_devtools
+
+client = Phaseo(
+    devtools=create_phaseo_devtools(
+        directory=".phaseo-devtools",
+        capture_headers=False,
+    )
+)
+```
+
+## Regeneration and local checks
+
+- Regenerate generated client: `pnpm openapi:gen:py`
+- Run tests: `pnpm test:sdk-py`
+- Smoke checks:
+  - `pnpm --filter @phaseo/py-sdk run smoke:chat`
+  - `pnpm --filter @phaseo/py-sdk run smoke:responses`

phaseo-2.0.6/README.md

@@ -0,0 +1,169 @@
+# Phaseo Python SDK
+
+Official Python SDK for Phaseo Gateway.
+
+## Installation
+
+```bash
+pip install phaseo
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+```python
+from phaseo import Phaseo
+
+client = Phaseo()  # Uses PHASEO_API_KEY from environment
+
+response = client.responses.create(
+    {
+        "model": "google/gemma-3-27b:free",
+        "input": "Reply with: Python SDK works",
+    }
+)
+
+print(response.get("output_text"))
+```
+
+## Streaming example
+
+```python
+from phaseo import Phaseo
+
+client = Phaseo()
+
+response = ""
+for chunk in client.stream_chat(
+    {
+        "model": "google/gemma-3-27b:free",
+        "messages": [{"role": "user", "content": "Stream hi"}],
+    }
+):
+    if chunk.get("text"):
+        response += chunk["text"]
+        print(chunk["text"], end="", flush=True)
+
+    if chunk.get("reasoning_tokens"):
+        print("\nReasoning tokens:", chunk["reasoning_tokens"])
+```
+
+## Common methods
+
+- `client.responses.create(...)`
+- `client.chat.completions.create(...)`
+- `client.messages.create(...)`
+- `client.stream_chat(...)`, `client.stream_responses(...)`, and `client.stream_message(...)` for parsed streaming chunks with `text`, `usage`, and `reasoning_tokens`
+- `client.models.list(...)`
+- `client.list_organisations(...)` for paginated `/organisations` discovery
+- `client.list_pricing_models(...)` for `/pricing/models` catalogue pricing discovery
+- `client.calculate_pricing(...)` for `/pricing/calculate` usage estimation
+- `client.list_providers(...)`, `client.get_credits(...)`, `client.get_activity(...)`, and `client.get_analytics(...)` for provider discovery and management-key usage surfaces
+- `client.list_api_keys(...)` for management-key `/keys` discovery
+- `client.create_api_key(...)`, `client.update_api_key(key_id, ...)`, and `client.delete_api_key(key_id)` for management-key API-key lifecycle changes
+- `client.get_api_key(key_id)` for management-key `/keys/{id}` lookup
+- `client.list_workspaces(...)`, `client.get_workspace(workspace_id)`, `client.create_workspace(...)`, `client.update_workspace(workspace_id, ...)`, and `client.delete_workspace(workspace_id)` for management-key workspace lifecycle management
+- `client.get_current_api_key()`
+- `client.get_health()`
+- `client.models.get_deprecation_info(model_id)`
+- `client.models.validate(model_id)`
+- `client.batches.list_models()` for batch-capable models and supported batch parameter metadata
+
+Model discovery supports the public `/models` filters, including `provider`, `provider_status`, `provider_routing_status`, `model_routing_status`, `capability_status`, `provider_availability_status`, `provider_availability_reason`, `status`, `organisation`, `endpoints`, `input_types`, `output_types`, `params`, `availability`, `limit`, and `offset`.
+
+Use `provider_availability_reason` with `availability="all"` when you want rollout-state entries such as `preview_only`, `provider_not_ready`, `gated`, `access_limited`, `region_limited`, `project_limited`, `paused`, or `soft_blocked`. Use `capability_status` with `availability="all"` when you want non-routable endpoint mappings such as `coming_soon` or `internal_testing`.
+
+```python
+models = client.get_models({
+    "provider": ["anthropic"],
+    "provider_status": ["beta", "not_ready"],
+    "provider_availability_reason": ["preview_only", "provider_not_ready"],
+    "capability_status": ["coming_soon", "internal_testing"],
+    "availability": "all",
+})
+```
+
+## Async job websocket helpers
+
+Batch and video operations can expose a websocket lifecycle stream at `/v1/async/{kind}/{id}/ws`.
+Create responses include the job id, polling URL, optional websocket URL, and sanitized webhook delivery state.
+
+```python
+import os
+
+batch = client.batches.create({
+    "endpoint": "/v1/responses",
+    "input_file_id": "file_123",
+    "completion_window": "24h",
+    "webhook": {
+        "url": "https://example.com/phaseo/webhooks",
+        "secret": os.environ["PHASEO_WEBHOOK_SECRET"],
+        "events": ["batch.progress", "batch.completed", "batch.failed"],
+    },
+})
+
+video = client.videos.create({
+    "model": "google/veo-3",
+    "prompt": "orbital reveal",
+    "webhook": {
+        "url": "https://example.com/phaseo/webhooks",
+        "secret": os.environ["PHASEO_WEBHOOK_SECRET"],
+        "events": ["video.progress", "video.completed", "video.failed"],
+    },
+})
+```
+
+```python
+batch_socket_url = client.batches.websocket_url("batch_123", interval_ms=1500)
+
+video_socket_url = client.videos.websocket_url(
+    "video_123",
+    close_on_terminal=True,
+)
+
+generic_socket_url = client.get_async_job_websocket_url("video", "video_123")
+```
+
+## Free and paid models
+
+- Models with `:free` in the model ID can be called with zero deposited credits.
+- Paid models require available wallet balance.
+
+## Model lifecycle warnings
+
+```python
+from phaseo import Phaseo
+
+client = Phaseo(
+    enable_deprecation_warnings=True,
+    warnings_as_errors=False,
+    logger=lambda level, message, meta: print(level, message, meta),
+)
+```
+
+## Environment variables
+
+- `PHASEO_API_KEY` (required unless passed in code)
+- `PHASEO_BASE_URL` (optional, defaults to `https://api.phaseo.app/v1`)
+
+## Devtools
+
+```python
+from phaseo import Phaseo, create_phaseo_devtools
+
+client = Phaseo(
+    devtools=create_phaseo_devtools(
+        directory=".phaseo-devtools",
+        capture_headers=False,
+    )
+)
+```
+
+## Regeneration and local checks
+
+- Regenerate generated client: `pnpm openapi:gen:py`
+- Run tests: `pnpm test:sdk-py`
+- Smoke checks:
+  - `pnpm --filter @phaseo/py-sdk run smoke:chat`
+  - `pnpm --filter @phaseo/py-sdk run smoke:responses`

phaseo-2.0.6/SKILL.md

@@ -0,0 +1,8 @@
+# Phaseo Python SDK (`phaseo`)
+
+- Use `from phaseo import Phaseo`.
+- Read credentials from `PHASEO_API_KEY`.
+- Prefer `generate_response` for new text and multimodal integrations.
+- Use preset slugs when your application has shared prompt, routing, or parameter defaults.
+- Store async video job ids and poll status until terminal.
+- Log request ids and model ids when debugging gateway behavior.

phaseo-2.0.6/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "phaseo"
+version = "2.0.6"
+description = "Phaseo Gateway SDK for Python."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Phaseo", email = "danielbutler500@gmail.com" }]
+keywords = ["ai", "sdk", "llm", "gateway"]
+classifiers = [
+	"Development Status :: 5 - Production/Stable",
+	"Programming Language :: Python :: 3",
+	"Programming Language :: Python :: 3 :: Only",
+	"License :: OSI Approved :: MIT License",
+	"Operating System :: OS Independent",
+	"Typing :: Typed",
+]
+dependencies = [
+	"httpx>=0.27.2,<1.0.0",
+	"typing-extensions>=4.8.0",
+	"pydantic>=2.6,<3.0",
+	"python-dateutil>=2.9,<3.0",
+]
+
+[project.urls]
+Homepage = "https://phaseo.app"
+Documentation = "https://phaseo.app"
+Repository = "https://github.com/phaseoteam/Phaseo"
+Issues = "https://github.com/phaseoteam/Phaseo/issues"
+
+[tool.hatch.build.targets.sdist]
+include = [
+	"src/phaseo",
+	"src/phaseo_devtools",
+	"src/gen",
+	"SKILL.md",
+	"README.md",
+	"LICENSE",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = [
+	"src/phaseo",
+	"src/phaseo_devtools",
+	"src/gen",
+]
+
+[tool.hatch.build.targets.wheel.force-include]
+"SKILL.md" = "phaseo/SKILL.md"
+
+[tool.hatch.version]
+path = "src/phaseo/__init__.py"
+

phaseo-2.0.6/src/gen/.gen-manifest.json

@@ -0,0 +1,8 @@
+{
+  "files": [
+    "__init__.py",
+    "client.py",
+    "models.py",
+    "operations.py"
+  ]
+}

phaseo-2.0.6/src/gen/__init__.py

@@ -0,0 +1,9 @@
+from .client import Client
+from .operations import *
+from .models import *
+
+__all__ = [
+	"Client",
+	*operations___all__,
+	*models___all__,
+]

phaseo-2.0.6/src/gen/client.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import json
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Optional
+
+
+class Client:
+	def __init__(self, base_url: str, headers: Optional[Dict[str, str]] = None):
+		self._base_url = base_url.rstrip('/')
+		self._headers = headers or {}
+
+	def request(
+		self,
+		method: str,
+		path: str,
+		query: Optional[Dict[str, Any]] = None,
+		headers: Optional[Dict[str, str]] = None,
+		body: Optional[Any] = None,
+	) -> Any:
+		url = f"{self._base_url}{path}"
+		if query:
+			url += "?" + urllib.parse.urlencode(query, doseq=True)
+		payload = None
+		request_headers = {"Accept": "application/json", **self._headers, **(headers or {})}
+		if body is not None:
+			payload = json.dumps(body).encode("utf-8")
+			request_headers["Content-Type"] = "application/json"
+		req = urllib.request.Request(url, data=payload, headers=request_headers, method=method.upper())
+		with urllib.request.urlopen(req) as resp:
+			raw = resp.read().decode("utf-8")
+			if not raw:
+				return None
+			try:
+				return json.loads(raw)
+			except json.JSONDecodeError:
+				return raw