devops-bot-sdk 1.0.0__tar.gz → 1.1.0__tar.gz

{devops_bot_sdk-1.0.0 → devops_bot_sdk-1.1.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: devops-bot-sdk
-Version: 1.0.0
+Version: 1.1.0
 Summary: DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app
 Author: noumanaziz2128
-License: Proprietary
+License-Expression: LicenseRef-Proprietary
 Project-URL: Homepage, https://agentos.io
-Project-URL: Repository, https://github.com/consultancy-outfit/devops-bot-ai
+Project-URL: Repository, https://github.com/consultancy-outfit/DevOpsBot-SDK
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: httpx>=0.27
@@ -24,32 +24,33 @@ Requires-Dist: psutil>=5.9; extra == "all"
 Thin Python client for the AgentOS desktop app (Electron). Wraps the backend
 `/api/v1/*` endpoints. No orchestration logic — agents run server-side.
 
+**Private package** — install from the GitHub repository (requires access).
+
 ## Requirements
 
 - Python 3.11+
-- AgentOS backend running (default: `http://localhost:8000`)
-- An API token from the AgentOS web app (Settings → API Tokens)
+- An API token from the AgentOS platform
 
 ## Installation
 
 ### Basic (chat + pipeline + webhooks)
 ```bash
-pip install agentos-sdk
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk"
 ```
 
 ### With screenshot collector
 ```bash
-pip install "agentos-sdk[screenshot]"
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[screenshot]"
 ```
 
 ### With process collector
 ```bash
-pip install "agentos-sdk[process]"
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[process]"
 ```
 
 ### Everything
 ```bash
-pip install "agentos-sdk[all]"
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[all]"
 ```
 
 ### From source (development)

{devops_bot_sdk-1.0.0 → devops_bot_sdk-1.1.0}/README.md

@@ -3,32 +3,33 @@
 Thin Python client for the AgentOS desktop app (Electron). Wraps the backend
 `/api/v1/*` endpoints. No orchestration logic — agents run server-side.
 
+**Private package** — install from the GitHub repository (requires access).
+
 ## Requirements
 
 - Python 3.11+
-- AgentOS backend running (default: `http://localhost:8000`)
-- An API token from the AgentOS web app (Settings → API Tokens)
+- An API token from the AgentOS platform
 
 ## Installation
 
 ### Basic (chat + pipeline + webhooks)
 ```bash
-pip install agentos-sdk
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk"
 ```
 
 ### With screenshot collector
 ```bash
-pip install "agentos-sdk[screenshot]"
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[screenshot]"
 ```
 
 ### With process collector
 ```bash
-pip install "agentos-sdk[process]"
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[process]"
 ```
 
 ### Everything
 ```bash
-pip install "agentos-sdk[all]"
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[all]"
 ```
 
 ### From source (development)

devops_bot_sdk-1.1.0/devops_bot_sdk.egg-info/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: devops-bot-sdk
+Version: 1.1.0
+Summary: DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app
+Author: noumanaziz2128
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://agentos.io
+Project-URL: Repository, https://github.com/consultancy-outfit/DevOpsBot-SDK
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: cryptography>=42
+Provides-Extra: screenshot
+Requires-Dist: Pillow>=10.0; extra == "screenshot"
+Provides-Extra: process
+Requires-Dist: psutil>=5.9; extra == "process"
+Provides-Extra: all
+Requires-Dist: Pillow>=10.0; extra == "all"
+Requires-Dist: psutil>=5.9; extra == "all"
+
+# AgentOS SDK
+
+Thin Python client for the AgentOS desktop app (Electron). Wraps the backend
+`/api/v1/*` endpoints. No orchestration logic — agents run server-side.
+
+**Private package** — install from the GitHub repository (requires access).
+
+## Requirements
+
+- Python 3.11+
+- An API token from the AgentOS platform
+
+## Installation
+
+### Basic (chat + pipeline + webhooks)
+```bash
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk"
+```
+
+### With screenshot collector
+```bash
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[screenshot]"
+```
+
+### With process collector
+```bash
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[process]"
+```
+
+### Everything
+```bash
+pip install "git+https://github.com/consultancy-outfit/devops-bot-ai.git#subdirectory=sdk[all]"
+```
+
+### From source (development)
+```bash
+# From the repo root
+pip install -e sdk/          # installs sdk/ as editable package
+# OR
+pip install -e "sdk/[all]"   # with all optional extras
+```
+
+## Setup
+
+```bash
+agentos configure
+# Backend URL [http://localhost:8000]: https://your-backend.example.com
+# Paste your token (format: aeos_<64-char-hex>): aeos_...
+# ✓ Configuration saved to ~/.agentos/config.toml
+```
+
+Replace a token:
+```bash
+agentos configure --rotate
+```
+
+## Quick start
+
+```python
+import asyncio
+from sdk import BackendClient
+
+async def main():
+    client = BackendClient.from_config()   # reads ~/.agentos/config.toml
+
+    # Bootstrap — load your persona + active model
+    profile = await client.bootstrap()
+    print(f"Logged in as tier={profile.tier}")
+
+    # Chat (SSE stream)
+    async for envelope in client.chat("my-thread", "What tasks are open?"):
+        if envelope.type == "delta":
+            print(envelope.data["text"], end="", flush=True)
+        elif envelope.type == "done":
+            break
+
+asyncio.run(main())
+```
+
+## Run as Electron sidecar
+
+```bash
+python -m sdk.ipc.electron_bridge
+```
+
+Wire protocol (newline-delimited JSON on stdin/stdout):
+
+```
+# Electron → Python (stdin)
+{"channel": "chat:send", "payload": {"thread_id": "t1", "message": "Hello"}}
+
+# Python → Electron (stdout)
+{"type": "delta",    "thread_id": "t1", "data": {"text": "Hi there"}}
+{"type": "done",     "thread_id": "t1", "data": {"text": "Hi there", "usage": {...}}}
+```
+
+## Available channels
+
+| Channel | Payload | What it does |
+|---|---|---|
+| `chat:send` | `{thread_id, message, role_slug?, model_id?}` | Stream chat response |
+| `orchestrator:run` | `{task_input, intent?, task_id?}` | Start pipeline + poll status |
+| `collectors:upload` | `{type, token, paths?, project}` | Upload local data |
+| `auth:oauth_start` | `{service}` | Get OAuth URL (browser opens it) |
+| `auth:oauth_complete` | `{service, code}` | Signal OAuth done |
+| `onboarding:step` | `{step, input}` | Onboarding step |
+
+## Collectors
+
+All collector data is sent through `BackendClient.submit_webhook` — no other egress.
+
+```python
+from sdk.collectors import files, screenshot, process
+
+# Upload a file
+payload = files.build_webhook_payload(token, ["./notes.md"], project="my-project")
+await client.submit_webhook("local_files", payload)
+
+# Screenshot
+payload = screenshot.build_webhook_payload(token, project="my-project")
+await client.submit_webhook("local_screenshot", payload)
+
+# Process snapshot
+payload = process.build_webhook_payload(token, project="my-project")
+await client.submit_webhook("local_process", payload)
+```
+
+## Size limits
+
+| Collector | Limit |
+|---|---|
+| Single file | 50 MB |
+| File batch | 200 MB |
+| Screenshot | 10 MB (auto-recompressed) |
+
+## Error handling
+
+```python
+from sdk import BackendUnreachable, BackendAuthFailed, BackendVersionTooOld, TokenNotConfigured
+
+try:
+    client = BackendClient.from_config()
+    await client.ping()
+except TokenNotConfigured:
+    print("Run: agentos configure")
+except BackendAuthFailed:
+    print("Token expired — run: agentos configure --rotate")
+except BackendVersionTooOld as e:
+    print(f"Upgrade required: {e}")
+except BackendUnreachable as e:
+    print(f"Backend down: {e}")
+```
+
+## Versioning
+
+The SDK is versioned independently from the backend. Every request carries
+`X-SDK-Version: 1.0.0`. The backend may return HTTP 426 if the SDK is too
+old to safely communicate — upgrade with `pip install --upgrade agentos-sdk`.

devops_bot_sdk-1.1.0/devops_bot_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,27 @@
+README.md
+pyproject.toml
+devops_bot_sdk.egg-info/PKG-INFO
+devops_bot_sdk.egg-info/SOURCES.txt
+devops_bot_sdk.egg-info/dependency_links.txt
+devops_bot_sdk.egg-info/entry_points.txt
+devops_bot_sdk.egg-info/requires.txt
+devops_bot_sdk.egg-info/top_level.txt
+sdk/__init__.py
+sdk/client.py
+sdk/config.py
+sdk/exceptions.py
+sdk/py.typed
+sdk/sse.py
+sdk/test.py
+sdk/collectors/__init__.py
+sdk/collectors/files.py
+sdk/collectors/process.py
+sdk/collectors/screenshot.py
+sdk/ipc/__init__.py
+sdk/ipc/electron_bridge.py
+sdk/ipc/handlers.py
+sdk/models/__init__.py
+sdk/models/envelope.py
+sdk/models/requests.py
+sdk/models/responses.py
+sdk/models/snapshots.py

devops_bot_sdk-1.1.0/devops_bot_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

devops_bot_sdk-1.1.0/devops_bot_sdk.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentos = sdk.config:configure_cli

devops_bot_sdk-1.1.0/devops_bot_sdk.egg-info/requires.txt

@@ -0,0 +1,13 @@
+httpx>=0.27
+pydantic>=2.0
+cryptography>=42
+
+[all]
+Pillow>=10.0
+psutil>=5.9
+
+[process]
+psutil>=5.9
+
+[screenshot]
+Pillow>=10.0

devops_bot_sdk-1.1.0/devops_bot_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+sdk

{devops_bot_sdk-1.0.0 → devops_bot_sdk-1.1.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devops-bot-sdk"
-version = "1.0.0"
+version = "1.1.0"
 description = "DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app"
 readme = "README.md"
-license = { text = "Proprietary" }
+license = "LicenseRef-Proprietary"
 requires-python = ">=3.11"
 authors = [{ name = "noumanaziz2128" }]
 
@@ -36,11 +36,11 @@ agentos = "sdk.config:configure_cli"   # `agentos configure [--rotate]`
 
 [project.urls]
 Homepage   = "https://agentos.io"
-Repository = "https://github.com/consultancy-outfit/devops-bot-ai"
+Repository = "https://github.com/consultancy-outfit/DevOpsBot-SDK"
 
 [tool.setuptools.packages.find]
-where = [".."]            # look one level up from sdk/pyproject.toml
-include = ["sdk*"]        # only package the sdk/ tree
+where = ["."]
+include = ["sdk*"]
 
 [tool.setuptools.package-data]
 sdk = ["py.typed"]

devops_bot_sdk-1.1.0/sdk/__init__.py

@@ -0,0 +1,54 @@
+"""AgentOS Desktop SDK — thin HTTPS/SSE client for the Electron app.
+
+Version: 1.0.0
+
+Public surface:
+  BackendClient.from_config()        — create client from ~/.agentos/config.toml
+  BackendClient.chat(...)            — stream chat response
+  BackendClient.orchestrator_run(...)— start pipeline, stream status envelopes
+  BackendClient.submit_webhook(...)  — ONLY egress for local collector data
+  BackendClient.oauth_flow_start(...)— get OAuth URL (browser opens it)
+  BackendClient.bootstrap()          — load user profile + persona + model
+  BackendClient.list_tasks(...)      — list open Jira tasks
+  BackendClient.insights(...)        — read insight metrics
+  BackendClient.insight_search(...)  — RBAC-filtered RAG search
+
+Collectors (payload producers — submit via BackendClient.submit_webhook):
+  collectors.files.build_webhook_payload(token, paths, project)
+  collectors.screenshot.build_webhook_payload(token, project)
+  collectors.process.build_webhook_payload(token, project)
+
+IPC entry point (Electron main process):
+  python -m sdk.ipc.electron_bridge   (stdio newline-delimited JSON)
+
+Rules:
+  - NO imports from modules.*, shared.*, routes.*, config.*
+  - stdlib + httpx + pydantic only
+  - Envelope shape: {type, thread_id, data} — matches backend exactly
+  - Unknown envelope types: silently dropped (forward-compat)
+  - All data egress through submit_webhook only
+"""
+
+__version__ = "1.0.0"
+__author__  = "AgentOS"
+
+from sdk.client import BackendClient
+from sdk.exceptions import (
+    BackendAuthFailed,
+    BackendUnreachable,
+    BackendVersionTooOld,
+    CollectorError,
+    TokenNotConfigured,
+)
+from sdk.models.envelope import Envelope
+
+__all__ = [
+    "__version__",
+    "BackendClient",
+    "Envelope",
+    "BackendAuthFailed",
+    "BackendUnreachable",
+    "BackendVersionTooOld",
+    "CollectorError",
+    "TokenNotConfigured",
+]