api-operator 0.9.0__py3-none-any.whl

api_operator-0.9.0.dist-info/METADATA

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: api-operator
+Version: 0.9.0
+Summary: Standalone AI API Operator with pluggable adapters for multi-project APIs
+Project-URL: Homepage, https://github.com/mohammedelkarsh/api-operator
+Project-URL: Repository, https://github.com/mohammedelkarsh/api-operator
+Project-URL: Issues, https://github.com/mohammedelkarsh/api-operator/issues
+Project-URL: Changelog, https://github.com/mohammedelkarsh/api-operator/blob/main/CHANGELOG.md
+Author: Mohammed Elkarsh
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,llm,multi-tenant,openapi,saas,tools,yaml
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.111.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic-settings>=2.3.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.30.0
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.2.0; extra == 'dev'
+Provides-Extra: llm
+Requires-Dist: openai>=1.35.0; extra == 'llm'
+Description-Content-Type: text/markdown
+
+# API Operator
+
+[![Tests](https://github.com/mohammedelkarsh/api-operator/actions/workflows/tests.yml/badge.svg)](https://github.com/mohammedelkarsh/api-operator/actions/workflows/tests.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+
+Standalone **AI operator runtime** with pluggable adapters. Talk to your HTTP APIs instead of clicking through admin panels.
+
+Works with Laravel, Go, connectivity platforms, or any backend with a REST API.
+
+## Install
+
+```bash
+git clone https://github.com/mohammedelkarsh/api-operator.git
+cd api-operator
+pip install -e ".[dev]"
+```
+
+Optional OpenAI planner:
+
+```bash
+pip install -e ".[dev,llm]"
+```
+
+## Quick start
+
+```bash
+api-operator demo
+api-operator tools --adapter mock
+```
+
+## What ships in the core package
+
+| In core | In your projects |
+|---------|------------------|
+| Agent runtime (plan, guard, execute) | `adapter.yaml` per API |
+| `mock` adapter (demo + tests) | OpenAPI specs |
+| `yaml` adapter | API tokens in `.env` |
+| CLI + HTTP server | Optional custom adapters |
+
+## Build an adapter without Python
+
+### Scaffold template
+
+```bash
+api-operator scaffold-adapter my-api --output examples
+```
+
+### Generate from OpenAPI
+
+```bash
+api-operator generate-from-openapi openapi.yaml \
+  --output adapter.yaml \
+  --base-url http://api.example.test \
+  --path-prefix /api
+```
+
+### Laravel Tenant Kit example
+
+See [`examples/tenant-kit-adapter/`](examples/tenant-kit-adapter/) — pairs with [laravel-tenant-kit](https://github.com/mohammedelkarsh/laravel-tenant-kit).
+
+```bash
+export TENANT_KIT_API_TOKEN="your-sanctum-token"
+api-operator chat \
+  --adapter yaml \
+  --config examples/tenant-kit-adapter/adapter.yaml \
+  --base-url http://laravel-tenant-kit.test
+```
+
+## adapter.yaml (minimal)
+
+```yaml
+name: my_project
+description: My API adapter
+base_url: http://api.example.test
+
+auth:
+  type: bearer
+  env_token: MY_PROJECT_API_TOKEN
+
+tools:
+  - name: list_items
+    description: List items
+    method: GET
+    path: /api/items
+
+  - name: create_item
+    description: Create item
+    method: POST
+    path: /api/items
+    dangerous: true
+    parameters:
+      title:
+        type: string
+        required: true
+    body:
+      title: "{title}"
+```
+
+Tenant subdomain APIs:
+
+```yaml
+  - name: invite_member
+    method: POST
+    path: /api/team/invitations
+    host: tenant
+    tenant_param: subdomain
+    parameters:
+      subdomain: { type: string, required: true }
+      email: { type: string, required: true }
+```
+
+## HTTP server
+
+```bash
+api-operator serve --port 8100
+```
+
+```json
+POST /v1/chat
+{
+  "adapter": "yaml",
+  "config_path": "examples/tenant-kit-adapter/adapter.yaml",
+  "adapter_config": { "token": "YOUR_TOKEN" },
+  "message": "list workspaces",
+  "abilities": ["workspaces:read"]
+}
+```
+
+## Integration test (Tenant Kit)
+
+With [Tenant Kit](https://github.com/mohammedelkarsh/laravel-tenant-kit) running:
+
+```bash
+python scripts/integration_tenant_kit.py
+# Docker on port 8080:
+python scripts/integration_tenant_kit.py --base-url http://laravel-tenant-kit.test:8080
+```
+
+Optional pytest marker (requires env vars):
+
+```bash
+export TENANT_KIT_BASE_URL=http://laravel-tenant-kit.test
+export TENANT_KIT_API_TOKEN=your-token
+pytest -m integration -q
+```
+
+## Tests
+
+```bash
+pytest -q
+```
+
+## Configuration
+
+Copy `.env.example` to `.env` for local defaults (`api_operator_PLANNER`, port, etc.).
+
+## Architecture
+
+```
+api-operator (core)          your projects
+├── agent runtime               ├── adapter.yaml
+├── mock + yaml adapters        ├── openapi.yaml
+└── scaffold / generate CLI     └── HTTP APIs (Laravel, Go, …)
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

api_operator-0.9.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+api_operator/__init__.py,sha256=kOxjBzrJ014jMfqYgyI3dFwF2l_80kWgslmvySa8ABE,334
+api_operator/factory.py,sha256=wjupDEpx4Ax3yjsSXSRg5ZjruboLzbH-WkhNRtJt5UE,786
+api_operator/adapters/__init__.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+api_operator/adapters/base.py,sha256=njGgFXwQMFQIkky9MPO1ixso78V2mZRU-uAPe8SZ9jQ,542
+api_operator/adapters/mock.py,sha256=OZJ1qvLiWFnX8BJe_9QfD_8_aj475vypxO2EV7e2Xz8,5160
+api_operator/adapters/openapi_generator.py,sha256=IIWSUnL2O9b5pqRIdjIpIWA0qU3IDDe8MJLYzRJcVG4,7262
+api_operator/adapters/registry.py,sha256=5t80kY8KDS16VRyvq08y60Vk3x6ymibeW12NdJ3B0PI,2238
+api_operator/adapters/yaml_adapter.py,sha256=b1fLPyrfrH3AhJCLAcoPEFMOo7XRFWnpEf4APQYHaDo,6312
+api_operator/adapters/yaml_spec.py,sha256=A1gdsoIkO_jHdmaATv0sSvfr3PnEwkXWLOF9jwzdSLY,5144
+api_operator/core/agent.py,sha256=RdKv-8ngDP5PH5iwfc45CwFDXHR8y2D9sIT1QW8-430,6080
+api_operator/core/config.py,sha256=_rnub_E7huSJEwb6Cjurx5vNYQIhTpgiAKxl9dvrY_k,528
+api_operator/core/executor.py,sha256=JqmLqXYVhh89igZCAb0Px1bjb8_iIBToe7Xd-rujxmA,1362
+api_operator/core/guardrails.py,sha256=Nnb2MPu0D-u29lSmcjFSOfFm-Fu0rpkgXrmf_V_OmlA,1756
+api_operator/core/memory.py,sha256=R1A4X9MyrW4YVxUI-K5zUkqOt6xKAH0qljAOhrd-Dmo,1506
+api_operator/core/planner.py,sha256=7-NJo0Ks4RePVlctv1G4J2VNor5KpumnH1X-GoY0aKc,6941
+api_operator/core/planner_openai.py,sha256=ump4XuQGGEUOHT4ariNvuadMpAs-XcRJFBdppkWFDBc,2411
+api_operator/rag/indexer.py,sha256=D1CK7tHdCadkOFEClgkWkJP7CqUT_uYbqMH4pZj92fQ,1433
+api_operator/server/app.py,sha256=TzGQgco6SrLGyBTyNe1AD9Nr6XjrpWoGOq9nk9Po-O8,3764
+api_operator/server/cli.py,sha256=40q64nbceaNj4Je368C6TEN2_L-dlGDwXjXLZXXUqiI,7653
+api_operator/tools/base.py,sha256=qJTEkZonofVVOcHgM_2hPLMHdFkfDlEooJQ3P6LCPcQ,2107
+api_operator/tools/schema.py,sha256=YXoa-DmFPflF5cTVv200vS-Mn3PToIC2RxlPngW5Qhs,844
+api_operator-0.9.0.dist-info/METADATA,sha256=hfh0yoJOlJIT7jN2ruE80I19z9ZyUGWXzlrggS_CCl4,5355
+api_operator-0.9.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+api_operator-0.9.0.dist-info/entry_points.txt,sha256=868Ezyt8zvCkYMUCb_NihUu3Oz1WibHyHvZC02S_NYE,61
+api_operator-0.9.0.dist-info/licenses/LICENSE,sha256=w3qzltsYO93CVULAaT7knAycDWsb3vLv_TnK7XnsAm8,1094
+api_operator-0.9.0.dist-info/RECORD,,

api_operator-0.9.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

api_operator-0.9.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+api-operator = api_operator.server.cli:app

api_operator-0.9.0.dist-info/licenses/LICENSE

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