apex-ai-sdk 0.1.0__tar.gz

apex_ai_sdk-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.pyc
+.mypy_cache/
+dist/
+*.egg-info/

apex_ai_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: apex-ai-sdk
+Version: 0.1.0
+Summary: Python client for the Apex AI Platform API.
+Project-URL: Repository, https://github.com/punarduttrajput/Apex
+License-Expression: Apache-2.0
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# apex-ai-sdk
+
+A Python client for the [Apex AI Platform](../../README.md) HTTP API,
+hand-written from the actual `apex-server` routes (see
+[`docs/09-api/openapi.yaml`](../../docs/09-api/openapi.yaml) for the full
+contract) — the same source [`sdks/typescript`](../typescript) was generated
+from, so the two clients cover identical ground.
+
+Zero runtime dependencies: the HTTP layer is built on `urllib` from the
+standard library rather than `requests`/`httpx`, so there's nothing to
+install to use it.
+
+## Install
+
+Not yet published; consume from the repo directly (path dependency, or copy
+`apex_sdk/` into your project) until it ships to PyPI.
+
+## Usage
+
+```python
+from apex_sdk import ApexClient
+
+client = ApexClient(
+    "http://127.0.0.1:8080",
+    tenant="acme",       # optional, defaults to the server's "default" tenant
+    principal="alice",   # optional
+)
+
+result = client.agents.run({"manifest": my_agent_yaml, "input": {"message": "Hi"}})
+print(result["output"]["message"])
+
+# Streaming:
+for frame in client.agents.stream({"manifest": my_agent_yaml, "input": {}}):
+    if frame["type"] == "delta":
+        print(frame["text"], end="")
+    if frame["type"] == "result":
+        print("\ndone:", frame["output"]["message"])
+```
+
+Every resource is namespaced on the client: `client.agents`, `client.workflows`,
+`client.memory`, `client.plugins`, `client.marketplace`, `client.secrets`,
+`client.organizations`, `client.projects`, `client.webhooks`, `client.audit`,
+`client.tools`.
+
+Errors are raised as `ApexApiError` (`.status`, `.code`, `.request_id`, `.body`)
+mapping the server's `{error: {...}}` envelope.
+
+Pagination: every list method returns a `Page` dict (`data`/`has_more`/
+`next_cursor`/`total_estimate`); `paginate_all` drains every page:
+
+```python
+from apex_sdk import paginate_all
+
+for agent_id in paginate_all(client.agents.list, limit=25):
+    ...
+```
+
+## Development
+
+No package manager is required to run this SDK — it's stdlib-only. To run
+the tests:
+
+```bash
+cargo run -p apex-cli -- dev --addr 127.0.0.1:8080 &
+python3 -m unittest discover -s tests -v
+```
+
+Tests are integration tests against a real, locally running server (skip
+cleanly, not failing, if `APEX_TEST_BASE_URL` — default
+`http://127.0.0.1:8080` — is unreachable), plus a handful of unit tests for
+the retry/backoff logic against a fake opener (no socket).
+
+One test (`test_projects_create_with_stale_if_match_is_rejected`) exercises
+organization/project creation, which — unlike agents/workflows/memory — has no
+anonymous-default-tenant back-compat bypass; it needs a real `org.admin` role.
+Start the server with `APEX_PLATFORM_ADMINS=sdk-test-admin` for that test to
+run instead of skip.
+
+## Known gaps (v0.1 of this SDK)
+
+- Synchronous only — no `asyncio` client.
+- No `redocly`-style contract test wired against `openapi.yaml` (the
+  TypeScript SDK's `npm test` runs one; this package has no npm-equivalent
+  tool available in this environment to wire the same check to).
+- Not published to PyPI yet.

apex_ai_sdk-0.1.0/README.md

@@ -0,0 +1,85 @@
+# apex-ai-sdk
+
+A Python client for the [Apex AI Platform](../../README.md) HTTP API,
+hand-written from the actual `apex-server` routes (see
+[`docs/09-api/openapi.yaml`](../../docs/09-api/openapi.yaml) for the full
+contract) — the same source [`sdks/typescript`](../typescript) was generated
+from, so the two clients cover identical ground.
+
+Zero runtime dependencies: the HTTP layer is built on `urllib` from the
+standard library rather than `requests`/`httpx`, so there's nothing to
+install to use it.
+
+## Install
+
+Not yet published; consume from the repo directly (path dependency, or copy
+`apex_sdk/` into your project) until it ships to PyPI.
+
+## Usage
+
+```python
+from apex_sdk import ApexClient
+
+client = ApexClient(
+    "http://127.0.0.1:8080",
+    tenant="acme",       # optional, defaults to the server's "default" tenant
+    principal="alice",   # optional
+)
+
+result = client.agents.run({"manifest": my_agent_yaml, "input": {"message": "Hi"}})
+print(result["output"]["message"])
+
+# Streaming:
+for frame in client.agents.stream({"manifest": my_agent_yaml, "input": {}}):
+    if frame["type"] == "delta":
+        print(frame["text"], end="")
+    if frame["type"] == "result":
+        print("\ndone:", frame["output"]["message"])
+```
+
+Every resource is namespaced on the client: `client.agents`, `client.workflows`,
+`client.memory`, `client.plugins`, `client.marketplace`, `client.secrets`,
+`client.organizations`, `client.projects`, `client.webhooks`, `client.audit`,
+`client.tools`.
+
+Errors are raised as `ApexApiError` (`.status`, `.code`, `.request_id`, `.body`)
+mapping the server's `{error: {...}}` envelope.
+
+Pagination: every list method returns a `Page` dict (`data`/`has_more`/
+`next_cursor`/`total_estimate`); `paginate_all` drains every page:
+
+```python
+from apex_sdk import paginate_all
+
+for agent_id in paginate_all(client.agents.list, limit=25):
+    ...
+```
+
+## Development
+
+No package manager is required to run this SDK — it's stdlib-only. To run
+the tests:
+
+```bash
+cargo run -p apex-cli -- dev --addr 127.0.0.1:8080 &
+python3 -m unittest discover -s tests -v
+```
+
+Tests are integration tests against a real, locally running server (skip
+cleanly, not failing, if `APEX_TEST_BASE_URL` — default
+`http://127.0.0.1:8080` — is unreachable), plus a handful of unit tests for
+the retry/backoff logic against a fake opener (no socket).
+
+One test (`test_projects_create_with_stale_if_match_is_rejected`) exercises
+organization/project creation, which — unlike agents/workflows/memory — has no
+anonymous-default-tenant back-compat bypass; it needs a real `org.admin` role.
+Start the server with `APEX_PLATFORM_ADMINS=sdk-test-admin` for that test to
+run instead of skip.
+
+## Known gaps (v0.1 of this SDK)
+
+- Synchronous only — no `asyncio` client.
+- No `redocly`-style contract test wired against `openapi.yaml` (the
+  TypeScript SDK's `npm test` runs one; this package has no npm-equivalent
+  tool available in this environment to wire the same check to).
+- Not published to PyPI yet.

apex_ai_sdk-0.1.0/apex_sdk/__init__.py

@@ -0,0 +1,13 @@
+from .client import ApexClient
+from .errors import ApexApiError
+from .http import RetryOptions
+from .pagination import paginate_all
+from .sse import SseFrame
+
+__all__ = [
+    "ApexClient",
+    "ApexApiError",
+    "RetryOptions",
+    "paginate_all",
+    "SseFrame",
+]