stewai 0.1.0__tar.gz

stewai-0.1.0/.gitignore

@@ -0,0 +1,132 @@
+###############################################################################
+#  StewAI — Monorepo .gitignore                                               #
+#  Covers: Python (backend), Node (frontend), JetBrains IDE, macOS, CI, etc.  #
+###############################################################################
+
+###############################################################################
+#  1 · OS / Editor junk                                                       #
+###############################################################################
+.DS_Store
+Thumbs.db
+# JetBrains / VS Code
+.idea/
+!.idea/code-style.xml          # keep shared code-style only
+.idea/vcs.xml                  # VCS metadata – tracked only when useful
+*.iml
+.vscode/
+# Swap / temp files
+*.swp
+*~
+*.tmp
+*.xml                          # generic user-level IDE configs
+.history                       # VS Code local history
+.quarantine                    # macOS file attribute after downloads
+
+###############################################################################
+#  2 · Python / Poetry                                                        #
+###############################################################################
+__pycache__/
+*.py[cod]
+*.pyo
+.env
+.venv/
+venv/
+dist/
+build/
+.eggs/
+*.egg-info/
+pip-wheel-metadata/
+.tox/
+.mypy_cache/
+.pytest_cache/
+.pyre/
+.dmypy.json
+pytestdebug.log
+coverage.*
+coverage.xml
+htmlcov/
+*.cover
+
+###############################################################################
+#  3 · Node / Frontend                                                        #
+###############################################################################
+node_modules/
+.cache/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-lock.yaml
++.pnp.*                # Yarn Berry Plug-and-Play loader files  
+
+# ─ Yarn Berry / PnP rules ───────────────────────────────────────────────────
+.yarn/cache/**
+.yarn/**
+!.yarn/patches/**
+!.yarn/plugins/**
+!.yarn/releases/**
+!.yarn/sdks/**
+!**/yarn.lock
+
+###############################################################################
+#  4 · Production / dev-build artefacts                                       #
+###############################################################################
+/build/
+dist/
+out/
+.next/
+.svelte-kit/
+vite-cache/
+storybook-static/
+coverage/                      # JS code-coverage directory
+
+###############################################################################
+#  5 · Docker / Kubernetes                                                    #
+###############################################################################
+*.tar
+*.log
+docker-compose.override.yml    # local overrides (any depth)
+**/docker-compose.override.yml
+.secrets/                      # doppler / sops decrypted files
+#
+# ─ Helm values with live secrets ────────────────────────────────────────────
+# Every real environment gets its *own* values-prod.yaml, values-staging.yaml,
+# etc.  They are **never** committed – only the redacted template is tracked.
+stewai-chart/values*.yaml
+!stewai-chart/values-template.yaml
+backend/.env*                  # runtime-specific env files
+*.envrc                        # direnv definitions
+.direnv/                       # direnv virtual envs
+
+###############################################################################
+#  6 · Misc tooling artefacts                                                 #
+###############################################################################
+*.sqlite3
+*.db
+*.ipynb_checkpoints/*
+*.ipynb
+*.npy
+*.parquet
+*.csv
+
+###############################################################################
+#  7 · macOS & sync service artefacts                                         #
+###############################################################################
+*.zip
+*.tgz
+*.tar.gz
+*.gz
+._*                             # macOS “resource fork”
+
+###############################################################################
+#  8 · End-of-file guard                                                     #
+###############################################################################
+# Add new rules above this line – keep the file alphabetised within sections.
+/backend/.coverage
+/.coverage
+/frontend/test-results/.last-run.json
+/frontend/test-results/after-login.png
+/frontend/test-results/before-login.png
+/backend/apps/runner/tests/.coverage
+/backend/.env.bak
+stewai_dump.pgsql
+stewai_dump_20251210_160158.pgsql

stewai-0.1.0/LICENSE.md

@@ -0,0 +1,27 @@
+StewAI Commercial License
+Version 0.0.0 – June 2025
+Copyright © 2025 Christian Mueller. All rights reserved.
+
+1. Grant of License
+   You are granted a non-exclusive, non-transferable, revocable license to
+   (a) view and modify the source code in this repository,
+   (b) run the Software for your internal evaluation or development purposes only.
+
+2. Restrictions
+   • No distribution, sublicensing, or SaaS offering of the Software or
+   Derivative Works is permitted without a separate commercial agreement.
+   • You may not remove or alter any proprietary notices.
+   • Reverse engineering of any binary distribution is prohibited unless
+   required by law.
+
+3. Termination
+   This License terminates automatically if you breach any term. Upon
+   termination you must destroy all copies and cease all use.
+
+4. DISCLAIMER
+   THE SOFTWARE IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND. THE AUTHOR
+   DISCLAIMS ALL LIABILITY FOR DAMAGES, DIRECT OR INDIRECT, ARISING FROM USE
+   OF THE SOFTWARE.
+
+For a production or redistribution license, contact:
+Christian Mueller · christian.mueller@camueller.org

stewai-0.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: stewai
+Version: 0.1.0
+Summary: Official StewAI Python SDK
+Author-email: StewAI <dev@stewai.com>
+License: StewAI Commercial License
+        Version 0.0.0 – June 2025
+        Copyright © 2025 Christian Mueller. All rights reserved.
+        
+        1. Grant of License
+           You are granted a non-exclusive, non-transferable, revocable license to
+           (a) view and modify the source code in this repository,
+           (b) run the Software for your internal evaluation or development purposes only.
+        
+        2. Restrictions
+           • No distribution, sublicensing, or SaaS offering of the Software or
+           Derivative Works is permitted without a separate commercial agreement.
+           • You may not remove or alter any proprietary notices.
+           • Reverse engineering of any binary distribution is prohibited unless
+           required by law.
+        
+        3. Termination
+           This License terminates automatically if you breach any term. Upon
+           termination you must destroy all copies and cease all use.
+        
+        4. DISCLAIMER
+           THE SOFTWARE IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND. THE AUTHOR
+           DISCLAIMS ALL LIABILITY FOR DAMAGES, DIRECT OR INDIRECT, ARISING FROM USE
+           OF THE SOFTWARE.
+        
+        For a production or redistribution license, contact:
+        Christian Mueller · christian.mueller@camueller.org
+License-File: LICENSE.md
+Keywords: api,sdk,stewai
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0,>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# stewai (Python SDK)
+
+Base URL (only): `https://api.stewai.com/v1`
+
+## Install
+
+```bash
+pip install stewai
+```
+
+## Get an API key
+
+1. Log in to `stewai.com`
+2. Go to `Settings → API keys`
+3. Create a key and copy it once (`sk-live-...`)
+
+## Usage
+
+```python
+from stewai import Stew
+
+client = Stew(api_key="sk-live-...")
+
+# Use the Input step “API input id” shown in the editor as the inputs key
+run = client.runs.create(
+    recipe_id="01K....",
+    inputs={"USERQUESTION": "What should I focus on this week?"},
+)
+
+run = client.runs.wait(run["id"], timeout=300)
+steps = client.runs.steps(run["id"])
+```

stewai-0.1.0/README.md

@@ -0,0 +1,32 @@
+# stewai (Python SDK)
+
+Base URL (only): `https://api.stewai.com/v1`
+
+## Install
+
+```bash
+pip install stewai
+```
+
+## Get an API key
+
+1. Log in to `stewai.com`
+2. Go to `Settings → API keys`
+3. Create a key and copy it once (`sk-live-...`)
+
+## Usage
+
+```python
+from stewai import Stew
+
+client = Stew(api_key="sk-live-...")
+
+# Use the Input step “API input id” shown in the editor as the inputs key
+run = client.runs.create(
+    recipe_id="01K....",
+    inputs={"USERQUESTION": "What should I focus on this week?"},
+)
+
+run = client.runs.wait(run["id"], timeout=300)
+steps = client.runs.steps(run["id"])
+```

stewai-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "stewai"
+version = "0.1.0"
+description = "Official StewAI Python SDK"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { file = "LICENSE.md" }
+authors = [{ name = "StewAI", email = "dev@stewai.com" }]
+keywords = ["stewai", "sdk", "api"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "License :: Other/Proprietary License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.27,<1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8,<9",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/stewai"]
+
+[tool.hatch.build]
+include = [
+  "src/stewai/**",
+  "README.md",
+  "LICENSE.md",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

stewai-0.1.0/src/stewai/__init__.py

@@ -0,0 +1,10 @@
+from importlib.metadata import PackageNotFoundError, version
+
+from .client import Stew
+
+try:
+    __version__ = version("stewai")
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "0.0.0"
+
+__all__ = ["Stew", "__version__"]

stewai-0.1.0/src/stewai/client.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import httpx
+
+from .resources.runs import RunsResource
+
+DEFAULT_BASE_URL = "https://api.stewai.com/v1"
+
+
+class Stew:
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 60.0,
+        transport: httpx.BaseTransport | None = None,
+    ) -> None:
+        base_url = base_url.rstrip("/") + "/"
+        self._client = httpx.Client(
+            base_url=base_url,
+            timeout=timeout,
+            transport=transport,
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "User-Agent": "stewai-python/0.1.0",
+            },
+        )
+        self.runs = RunsResource(self._client)
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "Stew":
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> None:
+        self.close()

stewai-0.1.0/src/stewai/errors.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+class StewError(Exception):
+    pass
+
+
+@dataclass
+class ApiError(StewError):
+    status_code: int
+    body: Any = None
+    message: str = "API request failed"
+
+
+class AuthenticationError(ApiError):
+    pass
+
+
+class RateLimitError(ApiError):
+    retry_after: Optional[str] = None

stewai-0.1.0/src/stewai/py.typed

@@ -0,0 +1 @@
+

stewai-0.1.0/src/stewai/resources/__init__.py

@@ -0,0 +1 @@
+

stewai-0.1.0/src/stewai/resources/runs.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+import time
+
+import httpx
+
+from ..errors import ApiError, AuthenticationError, RateLimitError
+
+
+class RunsResource:
+    def __init__(self, client: httpx.Client) -> None:
+        self._client = client
+
+    def create(self, recipe_id: str, inputs: Optional[Dict[str, str]] = None) -> Dict[str, Any]:
+        return self._json(self._client.post("runs/", json={"recipe_id": recipe_id, "inputs": inputs or {}}))
+
+    def get(self, run_id: str) -> Dict[str, Any]:
+        return self._json(self._client.get(f"runs/{run_id}/"))
+
+    def steps(self, run_id: str) -> Dict[str, Any]:
+        return self._json(self._client.get(f"runs/{run_id}/steps/"))
+
+    def wait(self, run_id: str, *, timeout: float = 300.0, poll_interval: float = 1.0) -> Dict[str, Any]:
+        deadline = time.time() + timeout
+        while True:
+            run = self.get(run_id)
+            status = run.get("status")
+            if status in {"done", "failed", "abandoned"}:
+                return run
+            if time.time() > deadline:
+                raise ApiError(status_code=408, body=run, message="Timed out waiting for run")
+            time.sleep(poll_interval)
+
+    def _json(self, res: httpx.Response) -> Dict[str, Any]:
+        if res.status_code in (401, 403):
+            raise AuthenticationError(status_code=res.status_code, body=_safe_json(res), message="Unauthorized")
+        if res.status_code == 429:
+            err = RateLimitError(status_code=429, body=_safe_json(res), message="Rate limited")
+            err.retry_after = res.headers.get("Retry-After")
+            raise err
+        if res.status_code < 200 or res.status_code >= 300:
+            raise ApiError(status_code=res.status_code, body=_safe_json(res))
+        data = _safe_json(res)
+        return data if isinstance(data, dict) else {"data": data}
+
+
+def _safe_json(res: httpx.Response) -> Any:
+    try:
+        return res.json()
+    except Exception:
+        return res.text