cloudsway-agent 1.0.0__tar.gz

cloudsway_agent-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentsWay
+
+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.

cloudsway_agent-1.0.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: cloudsway-agent
+Version: 1.0.0
+Summary: Production Python SDK for the Managed Agent API
+Author: AgentsWay
+License: MIT
+Project-URL: Homepage, https://github.com/scalebox-dev/agent-api/tree/dev-core/sdk/python
+Project-URL: Repository, https://github.com/scalebox-dev/agent-api
+Project-URL: Issues, https://github.com/scalebox-dev/agent-api/issues
+Project-URL: Changelog, https://github.com/scalebox-dev/agent-api/blob/dev-core/sdk/python/CHANGELOG.md
+Keywords: cloudsway-agent,cloudsway,agentsway,llm,agent,responses-api
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24
+Provides-Extra: dev
+Requires-Dist: httpx>=0.24; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Dynamic: license-file
+
+# Python SDK
+
+Production Python SDK for the Managed Agent API.
+
+## Install
+
+```bash
+pip install cloudsway-agent
+```
+
+For local development from this repository:
+
+```bash
+cd sdk/python
+pip install -e .
+```
+
+## Quick start
+
+```python
+from agent_api import AgentAPI
+
+client = AgentAPI(
+    api_key="sk-...",
+    base_url="https://api.agentsway.dev",
+)
+
+response = client.responses.create(
+    preset="pro-search",
+    input="What changed in AI this week?",
+)
+print(response["output_text"])
+client.close()
+```
+
+Environment variables `AGENT_API_KEY` and `AGENT_API_BASE_URL` are used by default.
+The default base URL is `https://api.agentsway.dev` when neither argument nor env is set.
+`AsyncAgentAPI` is available for async integrations.
+
+## Package layout
+
+```
+src/agent_api/
+  client.py            # synchronous AgentAPI
+  async_client.py      # AsyncAgentAPI
+  errors.py            # typed exceptions
+  pagination.py          # cursor pagination
+  streaming.py           # SSE parser
+  _http.py               # retries, timeouts, User-Agent
+  resources/             # responses, models, presets, tools
+  types/                 # TypedDict contracts
+```
+
+## Resources
+
+| Resource | Methods |
+|----------|---------|
+| `client.responses` / `client.agent` | `create`, `list`, `list_page`, `list_iterator`, `retrieve`, `cancel`, `list_children`, `list_events` |
+| `client.models` | `list` |
+| `client.presets` | `list` |
+| `client.tools` | `list` |
+
+## Production features
+
+- **Retries:** exponential backoff for network failures, 429, and 5xx (default 2 retries).
+- **Timeouts:** 10 minute default; 1 hour for streaming (override with `timeout` / `stream_timeout`).
+- **Typed errors:** `AuthenticationError`, `RateLimitError`, `NotFoundError`, etc.
+- **Pagination:** `list_page()` and `list_iterator()` for cursor-based history.
+
+```python
+for item in client.responses.list_iterator(limit=20):
+    print(item["id"], item["status"])
+```
+
+## Streaming
+
+```python
+for event in client.responses.create(
+    preset="fast-search",
+    input="Summarize today's AI news.",
+    stream=True,
+):
+    if event["type"] == "response.output_text.delta":
+        print(event.get("delta", ""), end="")
+```
+
+## Client options
+
+```python
+client = AgentAPI(
+    api_key="sk-...",
+    base_url="https://api.agentsway.dev",
+    timeout=600.0,
+    stream_timeout=3600.0,
+    max_retries=2,
+)
+```
+
+## Tests
+
+```bash
+PYTHONPATH=src python -m unittest discover -s tests -p 'test_agent_api.py' -v
+AGENT_API_INTEGRATION=1 AGENT_API_KEY=sk-... AGENT_API_BASE_URL=https://api.agentsway.dev \
+  PYTHONPATH=src python -m unittest tests.test_integration -v
+```
+
+## Scope
+
+The SDK covers the public agent/Responses API and discovery endpoints. Console
+auth, workspace administration, and internal audit records are intentionally
+out of scope.

cloudsway_agent-1.0.0/README.md

@@ -0,0 +1,111 @@
+# Python SDK
+
+Production Python SDK for the Managed Agent API.
+
+## Install
+
+```bash
+pip install cloudsway-agent
+```
+
+For local development from this repository:
+
+```bash
+cd sdk/python
+pip install -e .
+```
+
+## Quick start
+
+```python
+from agent_api import AgentAPI
+
+client = AgentAPI(
+    api_key="sk-...",
+    base_url="https://api.agentsway.dev",
+)
+
+response = client.responses.create(
+    preset="pro-search",
+    input="What changed in AI this week?",
+)
+print(response["output_text"])
+client.close()
+```
+
+Environment variables `AGENT_API_KEY` and `AGENT_API_BASE_URL` are used by default.
+The default base URL is `https://api.agentsway.dev` when neither argument nor env is set.
+`AsyncAgentAPI` is available for async integrations.
+
+## Package layout
+
+```
+src/agent_api/
+  client.py            # synchronous AgentAPI
+  async_client.py      # AsyncAgentAPI
+  errors.py            # typed exceptions
+  pagination.py          # cursor pagination
+  streaming.py           # SSE parser
+  _http.py               # retries, timeouts, User-Agent
+  resources/             # responses, models, presets, tools
+  types/                 # TypedDict contracts
+```
+
+## Resources
+
+| Resource | Methods |
+|----------|---------|
+| `client.responses` / `client.agent` | `create`, `list`, `list_page`, `list_iterator`, `retrieve`, `cancel`, `list_children`, `list_events` |
+| `client.models` | `list` |
+| `client.presets` | `list` |
+| `client.tools` | `list` |
+
+## Production features
+
+- **Retries:** exponential backoff for network failures, 429, and 5xx (default 2 retries).
+- **Timeouts:** 10 minute default; 1 hour for streaming (override with `timeout` / `stream_timeout`).
+- **Typed errors:** `AuthenticationError`, `RateLimitError`, `NotFoundError`, etc.
+- **Pagination:** `list_page()` and `list_iterator()` for cursor-based history.
+
+```python
+for item in client.responses.list_iterator(limit=20):
+    print(item["id"], item["status"])
+```
+
+## Streaming
+
+```python
+for event in client.responses.create(
+    preset="fast-search",
+    input="Summarize today's AI news.",
+    stream=True,
+):
+    if event["type"] == "response.output_text.delta":
+        print(event.get("delta", ""), end="")
+```
+
+## Client options
+
+```python
+client = AgentAPI(
+    api_key="sk-...",
+    base_url="https://api.agentsway.dev",
+    timeout=600.0,
+    stream_timeout=3600.0,
+    max_retries=2,
+)
+```
+
+## Tests
+
+```bash
+PYTHONPATH=src python -m unittest discover -s tests -p 'test_agent_api.py' -v
+AGENT_API_INTEGRATION=1 AGENT_API_KEY=sk-... AGENT_API_BASE_URL=https://api.agentsway.dev \
+  PYTHONPATH=src python -m unittest tests.test_integration -v
+```
+
+## Scope
+
+The SDK covers the public agent/Responses API and discovery endpoints. Console
+auth, workspace administration, and internal audit records are intentionally
+out of scope.

cloudsway_agent-1.0.0/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "cloudsway-agent"
+version = "1.0.0"
+description = "Production Python SDK for the Managed Agent API"
+requires-python = ">=3.10"
+dependencies = ["httpx>=0.24"]
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "AgentsWay" }]
+keywords = ["cloudsway-agent", "cloudsway", "agentsway", "llm", "agent", "responses-api"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/scalebox-dev/agent-api/tree/dev-core/sdk/python"
+Repository = "https://github.com/scalebox-dev/agent-api"
+Issues = "https://github.com/scalebox-dev/agent-api/issues"
+Changelog = "https://github.com/scalebox-dev/agent-api/blob/dev-core/sdk/python/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = ["httpx>=0.24", "build>=1.0"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+agent_api = ["py.typed"]

cloudsway_agent-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cloudsway_agent-1.0.0/src/agent_api/__init__.py

@@ -0,0 +1,68 @@
+"""Production Python SDK for the Managed Agent API."""
+
+from agent_api._version import (
+    DEFAULT_MAX_RETRIES,
+    DEFAULT_STREAM_TIMEOUT,
+    DEFAULT_TIMEOUT,
+    USER_AGENT,
+    __version__,
+)
+from agent_api.async_client import AsyncAgentAPI
+from agent_api.client import AgentAPI
+from agent_api.errors import (
+    APIConnectionError,
+    APIError,
+    APIStatusError,
+    AuthenticationError,
+    BadRequestError,
+    InternalServerError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+    is_retryable_status,
+    parse_response_error,
+)
+from agent_api.local_functions import (
+    function_call_output_input,
+    pending_function_calls,
+    run_local_function_handlers,
+)
+from agent_api.pagination import AsyncPage, Page, PageResult
+from agent_api.types import *
+
+__all__ = [
+    "AgentAPI",
+    "AsyncAgentAPI",
+    "APIError",
+    "APIConnectionError",
+    "APIStatusError",
+    "AuthenticationError",
+    "BadRequestError",
+    "InternalServerError",
+    "NotFoundError",
+    "PermissionDeniedError",
+    "RateLimitError",
+    "Page",
+    "AsyncPage",
+    "PageResult",
+    "AgentCapabilityPreference",
+    "AgentResponse",
+    "Model",
+    "ModelCapabilities",
+    "Preset",
+    "PublicTool",
+    "ResponseCreateParams",
+    "ResponseStreamEvent",
+    "ResponseStatus",
+    "ToolInvocationResult",
+    "DEFAULT_MAX_RETRIES",
+    "DEFAULT_STREAM_TIMEOUT",
+    "DEFAULT_TIMEOUT",
+    "USER_AGENT",
+    "is_retryable_status",
+    "parse_response_error",
+    "function_call_output_input",
+    "pending_function_calls",
+    "run_local_function_handlers",
+    "__version__",
+]