abstractgateway 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

abstractgateway-0.1.1.dist-info/METADATA

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: abstractgateway
+Version: 0.1.1
+Summary: AbstractGateway: deployable Run Gateway host for AbstractRuntime (commands + ledger).
+Project-URL: GitHub, https://github.com/lpalbou/abstractgateway
+Author: Laurent-Philippe Albou
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: abstractruntime>=0.4.0
+Provides-Extra: dev
+Requires-Dist: fastapi>=0.100.0; extra == 'dev'
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: uvicorn[standard]>=0.23.0; extra == 'dev'
+Provides-Extra: http
+Requires-Dist: fastapi>=0.100.0; extra == 'http'
+Requires-Dist: uvicorn[standard]>=0.23.0; extra == 'http'
+Provides-Extra: runner
+Provides-Extra: telegram
+Requires-Dist: abstractruntime[abstractcore]>=0.4.0; extra == 'telegram'
+Provides-Extra: visualflow
+Requires-Dist: abstractflow>=0.3.0; extra == 'visualflow'
+Description-Content-Type: text/markdown
+
+# AbstractGateway
+
+AbstractGateway is a **deployable Run Gateway host** for AbstractRuntime runs:
+- start durable runs
+- accept a durable command inbox
+- replay/stream a durable ledger (replay-first)
+- enforce a security baseline (token + origin allowlist + limits)
+
+This decouples the gateway service from any specific UI (AbstractFlow, AbstractCode, web/PWA thin clients).
+
+Start here: [docs/getting-started.md](docs/getting-started.md)
+
+## Quickstart (HTTP server, bundle mode)
+
+```bash
+pip install "abstractgateway[http]"
+
+export ABSTRACTGATEWAY_FLOWS_DIR="/path/to/bundles"   # *.flow dir (or a single .flow file)
+export ABSTRACTGATEWAY_DATA_DIR="$PWD/runtime/gateway"
+
+# Required by default: the server refuses to start without a token.
+export ABSTRACTGATEWAY_AUTH_TOKEN="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"
+# Browser-origin allowlist (glob patterns). Default allows localhost; customize when exposing remotely.
+export ABSTRACTGATEWAY_ALLOWED_ORIGINS="http://localhost:*,http://127.0.0.1:*"
+
+abstractgateway serve --host 127.0.0.1 --port 8080
+```
+
+OpenAPI docs (Swagger UI): `http://127.0.0.1:8080/docs`
+
+Smoke checks:
+
+```bash
+curl -sS "http://127.0.0.1:8080/api/health"
+
+curl -sS -H "Authorization: Bearer $ABSTRACTGATEWAY_AUTH_TOKEN" \
+  "http://127.0.0.1:8080/api/gateway/bundles"
+```
+
+## Client contract (replay-first)
+
+- Clients **start runs**: `POST /api/gateway/runs/start`
+- Clients **act** by submitting durable commands: `POST /api/gateway/commands`
+  - supported types: `pause|resume|cancel|emit_event|update_schedule|compact_memory`
+- Clients **render** by replaying/streaming the durable ledger:
+  - replay: `GET /api/gateway/runs/{run_id}/ledger?after=...`
+  - stream (SSE): `GET /api/gateway/runs/{run_id}/ledger/stream?after=...`
+
+See [docs/api.md](docs/api.md) for curl examples and the live OpenAPI spec (`/openapi.json`).
+
+## Install
+
+### Base (runner + stores + CLI)
+
+Requires Python `>=3.10` (see `pyproject.toml`).
+
+```bash
+pip install abstractgateway
+```
+
+### HTTP API/SSE server (FastAPI + Uvicorn)
+
+```bash
+pip install "abstractgateway[http]"
+```
+
+### Optional extras
+
+- `abstractgateway[visualflow]`: run VisualFlow JSON from a directory of `*.json` files (requires `abstractflow`)
+- `abstractgateway[telegram]`: Telegram bridge dependencies
+- `abstractgateway[dev]`: local test/dev deps
+
+### Bundle-dependent dependencies (only if your workflows need them)
+
+- LLM/tool nodes in bundle mode require AbstractRuntime’s AbstractCore integration:
+
+```bash
+pip install "abstractruntime[abstractcore]>=0.4.0"
+```
+
+For details on `ABSTRACTGATEWAY_PROVIDER`/`MODEL`, store backends, and workflow sources, see [docs/configuration.md](docs/configuration.md).
+
+## Creating a `.flow` bundle (authoring)
+
+Use AbstractFlow to pack a bundle:
+
+```bash
+abstractflow bundle pack /path/to/root.json --out /path/to/bundles/my.flow --flows-dir /path/to/flows
+```
+
+See [docs/getting-started.md](docs/getting-started.md) for running, split API/runner, and file→SQLite migration.
+
+## Docs
+
+### Project docs
+
+- Changelog: [CHANGELOG.md](CHANGELOG.md) (compat: `CHANGELOD.md`)
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Security policy (vulnerability reporting): [SECURITY.md](SECURITY.md)
+- Acknowledgments: [ACKNOWLEDGMENTS.md](ACKNOWLEDGMENTS.md) (compat: `ACKNOWLEDMENTS.md`)
+
+### Package docs
+
+- Docs index: [docs/README.md](docs/README.md)
+- Getting started: [docs/getting-started.md](docs/getting-started.md)
+- FAQ: [docs/faq.md](docs/faq.md)
+- Architecture: [docs/architecture.md](docs/architecture.md)
+- Configuration: [docs/configuration.md](docs/configuration.md)
+- API overview: [docs/api.md](docs/api.md)
+- Security: [docs/security.md](docs/security.md)
+- Operator tooling (optional): [docs/maintenance.md](docs/maintenance.md)

abstractgateway-0.1.1.dist-info/RECORD

@@ -0,0 +1,40 @@
+abstractgateway/__init__.py,sha256=m_biwVVD5XLm4Xt8Emo1DZWHjNOJEGL7fjTsrYWgLcA,280
+abstractgateway/__main__.py,sha256=KQwnQ9WuHUzz-sQ6nZ89HfqUkDXMP0qCRPzAX128PHs,98
+abstractgateway/app.py,sha256=s9mgAxFpGhR2FayYjwUJ2csJV0N5CzWT7o0eIhpnYns,1629
+abstractgateway/cli.py,sha256=nW8mzUBi2ZL-T2_Nfvg9ATLQYupO0Zn8ITaGxFG9D54,25767
+abstractgateway/config.py,sha256=0LuMxf58gB6W6gbQYRGf_-E8UlBrtCLz1H6NRRvJgzg,3627
+abstractgateway/embeddings_config.py,sha256=wuQIx5z_a-YDx_7zxOcnqdg-0CnFw6S9VTyXiRhvXqk,1653
+abstractgateway/host_metrics.py,sha256=SAmBreolwgFbeLakx0QAaQJUCv6Z6nXEEhhwJ43vxcY,8567
+abstractgateway/migrate.py,sha256=gnCCCJGoO8o9V4jFnBylFTpX9w7CxMkhkgCS_NRPgGE,5600
+abstractgateway/runner.py,sha256=fhJmvvzqFoIc2wY3F4mMx3hzv5fdBaYvTCzJznmThzU,45863
+abstractgateway/service.py,sha256=ueRmDcyMSbfEEE7hKUb-GzHVXYTi3AdTHDF7NCDXLUQ,14007
+abstractgateway/stores.py,sha256=c_YgQxQsPZzytYQunLHELLuWzmINgvdIT3-h27ldPoE,3084
+abstractgateway/workflow_deprecations.py,sha256=wP4SaTJNVc5ATCyPSFLTiS8z8Y9nSJChYNdBPXZVb0k,7950
+abstractgateway/hosts/__init__.py,sha256=RiIODYtCPUYeVPDKmVhqKLVwxw3D_NWdw4gnetVKdhA,170
+abstractgateway/hosts/bundle_host.py,sha256=PU3gI-tnyFfwRVM1ZCLL8Kt0ZV4Jv-Me40x3VNHeDe0,47496
+abstractgateway/hosts/visualflow_host.py,sha256=Mgoa30lHY0uuT5Qcrx6CHh-FXzKNW2zXryc3Ll6yT_Y,8742
+abstractgateway/integrations/__init__.py,sha256=TKL8tZmwMPX-hfjPbdpQG8axDNolbX2zPfD1bs5qv3I,59
+abstractgateway/integrations/email_bridge.py,sha256=FacYfEUPkZpDuX_lQGfnQK25Q4jvEvLa3aVc2xFLv0Y,30602
+abstractgateway/integrations/telegram_bridge.py,sha256=8E958kJMuRYne6DGXFVkOsGb0scZzQ-rbShqwPOzeJw,21341
+abstractgateway/maintenance/__init__.py,sha256=AdJnwhZ8zwo_SUFyWXF0jw7clhwkh6WopUBUxFk-zrk,121
+abstractgateway/maintenance/action_tokens.py,sha256=DoI3b_Ngpypxc24FkXIZVkOP9KWVDHYcq5yaWf-5cO4,3163
+abstractgateway/maintenance/backlog_exec_runner.py,sha256=wPdjN-UB2SOGsCTe5jhECUJXynMSe5Zu2OW6pvb2neU,58185
+abstractgateway/maintenance/backlog_parser.py,sha256=weFuADQSI-frrxKNokICePpd2lzqlq0j15mW8fyiDNY,5734
+abstractgateway/maintenance/draft_generator.py,sha256=g0TXIB8ybUWFz-TZ2qmNsqtbm1NHZE2poiPL3-6jSFA,16658
+abstractgateway/maintenance/llm_assist.py,sha256=O0Q473ADSAq1lR-JfYQxbCCUC6VckOkOT3-suLxSN0o,6944
+abstractgateway/maintenance/notifier.py,sha256=1TTJudiYM05msPSzmPn6pXTOzLCprtU2sEqnkKAR4S0,3813
+abstractgateway/maintenance/process_manager.py,sha256=_hi-DmQGU2xdd27QeHD81PbDMB8O4YvS-G2uWCjJPPE,41659
+abstractgateway/maintenance/report_models.py,sha256=gAHsuJCjRGrlKcLYRpr5zPMCz9dM0agZ2LGrJy91LOk,2338
+abstractgateway/maintenance/report_parser.py,sha256=7DOqb9F0D_ONr8QkJj83uEky5h4aKdVO1Zgl3f228K0,7063
+abstractgateway/maintenance/text_similarity.py,sha256=mD29VexyY3QYK5LthCw3t3EmJcebUQ_myfxnu4kAjtA,2703
+abstractgateway/maintenance/triage.py,sha256=CQedaRwD5gJ88-zUHa21OlwAoNJptQrY8yttsn3GDAo,20588
+abstractgateway/maintenance/triage_queue.py,sha256=CdZJpEWReODlvMzwQRiPO1KmnkNC1xTIUGNek-y7mgA,5035
+abstractgateway/routes/__init__.py,sha256=gIj0jBKaEbGK5Xf20Fd2WAvvKEJn5n4314sC1p7pTUo,138
+abstractgateway/routes/gateway.py,sha256=P9etfWLYhojqrbg-N_7QDw-C1L628-tAFdVKdX9SV40,448408
+abstractgateway/routes/triage.py,sha256=sU1vlxBQPSZBsgEtQJOgYclfYniaM--AoaeBqA9pIAs,4585
+abstractgateway/security/__init__.py,sha256=2pKIec_kuQ53_UAl0uij3u_1MInQOVDY_MF7ERr4Rgw,211
+abstractgateway/security/gateway_security.py,sha256=FaUkI4TwKg-C-cxgFR_29_Cp4iEzyPF_kAZnIePlO9s,30676
+abstractgateway-0.1.1.dist-info/METADATA,sha256=Qg3eGxj9WSLM7nLoc7_0_MFM2uvyqe3ByMXh994cHaI,4705
+abstractgateway-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+abstractgateway-0.1.1.dist-info/entry_points.txt,sha256=eDg0b1pu1ZLoFC8ZId_AlHn5rgaakmshL4vvI_FeAB4,61
+abstractgateway-0.1.1.dist-info/RECORD,,

abstractgateway-0.1.0.dist-info/METADATA

@@ -1,101 +0,0 @@
-Metadata-Version: 2.4
-Name: abstractgateway
-Version: 0.1.0
-Summary: AbstractGateway: deployable Run Gateway host for AbstractRuntime (commands + ledger).
-Project-URL: GitHub, https://github.com/lpalbou/abstractgateway
-Author: Laurent-Philippe Albou
-License: MIT
-Requires-Python: >=3.10
-Requires-Dist: abstractruntime>=0.4.0
-Requires-Dist: fastapi>=0.100.0
-Requires-Dist: uvicorn[standard]>=0.23.0
-Provides-Extra: dev
-Requires-Dist: httpx>=0.27.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Provides-Extra: visualflow
-Requires-Dist: abstractflow>=0.3.0; extra == 'visualflow'
-Description-Content-Type: text/markdown
-
-# AbstractGateway
-
-AbstractGateway is the **deployable Run Gateway host** for AbstractRuntime runs:
-- durable command inbox
-- ledger replay/stream
-- security baseline (token + origin + limits)
-
-This decouples the gateway service from any specific UI (AbstractFlow, AbstractCode, web/PWA thin clients).
-
-## What it does (contract)
-- Clients **act** by submitting durable commands: `start`, `resume`, `pause`, `cancel`, `emit_event`
-- Clients **render** by replaying/streaming the durable ledger (cursor-based, replay-first)
-
-Endpoints:
-- `POST /api/gateway/runs/start`
-- `GET /api/gateway/runs/{run_id}`
-- `GET /api/gateway/runs/{run_id}/ledger`
-- `GET /api/gateway/runs/{run_id}/ledger/stream` (SSE)
-- `POST /api/gateway/commands`
-
-## Install
-
-### Default (bundle mode)
-
-```bash
-pip install abstractgateway
-```
-
-Bundle mode executes **WorkflowBundles** (`.flow`) via **WorkflowArtifacts** without importing `abstractflow`.
-
-### Optional (compatibility): VisualFlow JSON
-
-```bash
-pip install "abstractgateway[visualflow]"
-```
-
-This mode depends on the **AbstractFlow compiler library** (`abstractflow`) to interpret VisualFlow JSON (it does **not** require the AbstractFlow web UI/app).
-
-## Run
-
-```bash
-export ABSTRACTGATEWAY_DATA_DIR="./runtime"
-export ABSTRACTGATEWAY_FLOWS_DIR="/path/to/bundles-or-flow"
-
-# Security (recommended)
-export ABSTRACTGATEWAY_AUTH_TOKEN="your-token"
-export ABSTRACTGATEWAY_ALLOWED_ORIGINS="*"
-
-abstractgateway serve --host 127.0.0.1 --port 8080
-```
-
-Notes:
-- `ABSTRACTGATEWAY_WORKFLOW_SOURCE` defaults to `bundle`. Valid values:
-  - `bundle` (default): `ABSTRACTGATEWAY_FLOWS_DIR` points to a directory containing `*.flow` bundles (or a single `.flow` file)
-  - `visualflow` (compat): `ABSTRACTGATEWAY_FLOWS_DIR` points to a directory containing `*.json` VisualFlow files
-- For production, run behind HTTPS (reverse proxy) and set exact allowed origins.
-
-## Creating a `.flow` bundle (authoring)
-
-Use AbstractFlow to pack a bundle:
-
-```bash
-abstractflow bundle pack /path/to/root.json --out /path/to/bundles/my.flow --flows-dir /path/to/flows
-```
-
-## Starting a run (bundle mode)
-
-The stable way is to pass `bundle_id` + `flow_id`:
-
-```bash
-curl -sS -X POST "http://localhost:8080/api/gateway/runs/start" \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer your-token" \
-  -d '{"bundle_id":"my-bundle","flow_id":"ac-echo","input_data":{}}'
-```
-
-For backwards-compatible clients, you can also pass a namespaced id as `flow_id` (`"my-bundle:ac-echo"`).
-
-## Docs
-- Architecture: `docs/architecture.md` (framework) and `abstractgateway/docs/architecture.md` (this package)
-- Deployment: `docs/guide/deployment.md`
-
-

abstractgateway-0.1.0.dist-info/RECORD

@@ -1,18 +0,0 @@
-abstractgateway/__init__.py,sha256=JiTSUsov4YukN0mAmjzaQoSI5JDmwSrhf6KP0qVl2fY,281
-abstractgateway/app.py,sha256=m6xQbTNnScc1XHtvnBCJiFCHt1AOun5v-7mrypSV5es,1541
-abstractgateway/cli.py,sha256=q8uVDOqMyTxaCzsFvtFFHVAn0P4JtDabI0kCDuEDFvI,941
-abstractgateway/config.py,sha256=V7HthrkWjR1XQaanGBW2npHiF2_lCZ7IqonisxAguw8,3150
-abstractgateway/runner.py,sha256=3itMuGQvR3iJ5ITbxbaa2vhbYjGleGqKUNaq7AGqfFE,17080
-abstractgateway/service.py,sha256=HfpNgmtXM9Q8LQnl0Ag1G99g79MqFbOPzmv4ondqJWE,4992
-abstractgateway/stores.py,sha256=7Wlq5Zvmy5LWOGT5GBXfK9Se9MZu7IM6XUoqOXTpF-Q,1010
-abstractgateway/hosts/__init__.py,sha256=RiIODYtCPUYeVPDKmVhqKLVwxw3D_NWdw4gnetVKdhA,170
-abstractgateway/hosts/bundle_host.py,sha256=Ji3rR_DlhmJ2tqpQfCNpqKIVzjfNtnFZj3BCaUbLWwU,25380
-abstractgateway/hosts/visualflow_host.py,sha256=xq90TYV1Ac4cSlXXwjvJZ4W1G2f6IzglTiWKntnq6Co,7554
-abstractgateway/routes/__init__.py,sha256=qkxhZHLypa0-NlczRKA3wUmHsRXIx93HroBRc6g7BAo,78
-abstractgateway/routes/gateway.py,sha256=ANTEuS6n-AaMBuBPFlZJ_kkpfbMN4uzyizso2P5p784,14747
-abstractgateway/security/__init__.py,sha256=2pKIec_kuQ53_UAl0uij3u_1MInQOVDY_MF7ERr4Rgw,211
-abstractgateway/security/gateway_security.py,sha256=1uhJ99i4Ifh24waqhNDO7euWnUZHmVOBMLIQxPoL2OE,18270
-abstractgateway-0.1.0.dist-info/METADATA,sha256=lwOX7FB1yFLCfS1xMrO1RljdtuVA3UtH1Siu7SjQfN4,3293
-abstractgateway-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-abstractgateway-0.1.0.dist-info/entry_points.txt,sha256=eDg0b1pu1ZLoFC8ZId_AlHn5rgaakmshL4vvI_FeAB4,61
-abstractgateway-0.1.0.dist-info/RECORD,,