agentic-bus 0.1.0__tar.gz

agentic_bus-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# SQLite
+*.db
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.vscode/
+.idea/
+
+# Environment (contains secrets – never commit)
+.env
+
+# Test / coverage
+.pytest_cache/
+htmlcov/
+.coverage
+
+# OS
+.DS_Store
+Thumbs.db

agentic_bus-0.1.0/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+The **protocol** version (`LIP_PROTOCOL_VERSION`) is versioned separately
+from this package; protocol changes are called out explicitly below.
+
+## [Unreleased]
+
+### Added
+
+- **`docker compose up` runs the whole stack with no API keys**: a local
+  model (Ollama), the coordinator with the paper's four logistics agents
+  seeded and running, and the dashboard on `:3000`. Previously the only way
+  to see the bus run was a clone, two dependency installs, an LLM provider
+  key, an interactive wizard and three manual processes.
+- `[agents]`, `[mcp]` and `[all]` install extras. `crewai`/`crewai-tools`
+  (managed agents) and `langchain-mcp-adapters` (MCP bridge) were used at
+  runtime but declared nowhere, so `pip install agentic-bus` succeeded and
+  then failed with a bare `ModuleNotFoundError` the first time you used
+  either feature.
+- `GET /health` — an unauthenticated, dependency-free liveness probe for
+  container orchestrators. Reports the serving status and LIP protocol
+  version; deliberately touches no database or LLM.
+- A release workflow publishing to PyPI on a `v*` tag via Trusted Publishing
+  (no stored API token), gated on the tag matching `pyproject.toml`.
+- A CI job that builds both Docker images, validates the compose file, and
+  asserts the lazily-imported extras are importable in the image.
+- `protocol_version` on every message envelope (LIP `0.1.0`). Envelopes from
+  pre-versioning peers are read as `0.1.0`, so the change is backwards
+  compatible on the wire.
+- Generated JSON Schemas for the envelope and every payload under `schemas/`,
+  produced by `python -m app.core.protocol.export_schemas`. CI fails if they
+  drift from the Pydantic models.
+- `LICENSE` (MIT). The README and package metadata claimed MIT, but no
+  licence text was ever committed — until now the code was, strictly,
+  all rights reserved.
+- Continuous integration: ruff, the test suite on Python 3.11/3.12/3.13, the
+  protocol schema check, and the dashboard build.
+- `CONTRIBUTING.md`, `SECURITY.md`, `CHANGELOG.md`, and issue/PR templates.
+- `SECURITY.md` documents the known limitations of LLM-evaluated IBAC.
+
+### Changed
+
+- `agbus agent list` rejects an unknown `--status` instead of reporting an
+  empty result, which made a typo indistinguishable from "no agents".
+- Package metadata now describes the project as the reference implementation
+  of the **Liquid Interfaces Protocol**, with homepage, repository, spec and
+  paper URLs for PyPI.
+- Code comments that referred to "the Agentic Bus paper" now name the
+  Liquid Interfaces paper (`lip.md`) consistently.
+
+### Fixed
+
+- The source distribution no longer ships the dashboard's `node_modules`.
+  Hatchling's default sdist sweeps the project directory and honours only the
+  *root* `.gitignore`, while `node_modules` is ignored by `ui/.gitignore` —
+  so the archive was 86 MB across 25,741 files, over PyPI's 100 MB per-file
+  limit. Now 243 KB across 113 files.
+- The Swagger UI was documented at `/docs`; it is served at `/api/docs`.
+- The README logo used a relative path, which does not render on PyPI where
+  the README becomes the project description.
+- `resolve_tools` no longer aborts agent creation when an optional tool's
+  dependency chain fails to import. Only `ValueError` and `ImportError` were
+  caught, so an incompatible transitive dependency surfacing as
+  `AttributeError` took down the whole agent instead of skipping one tool.
+- The test suite is hermetic. It previously inherited the developer's `.env`
+  through `load_dotenv(find_dotenv(usecwd=True))` at import time and shared
+  the host database, so 19 tests passed locally and failed on a clean
+  checkout. Every test now gets a scrubbed environment and its own migrated
+  database (`tests/conftest.py`).
+- The install-wizard tests could hang the run indefinitely: a drifted answer
+  list fell through to the final "Start the coordinator server now?" prompt,
+  which defaults to *yes*, and booted a real coordinator. Exhausting the
+  answers now raises instead.
+- Test assertions that still expected LLM settings in `.env` now assert
+  against the database, where the wizard has been writing them.

agentic_bus-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to Agentic Bus
+
+Agentic Bus is the reference implementation of the **Liquid Interfaces
+Protocol (LIP)**. Protocol changes belong in the
+[specification repository](https://github.com/draiven-io/liquid-interfaces);
+runtime behaviour, the SDK, the dashboard and the CLI belong here.
+
+## Getting set up
+
+```bash
+pip install -e ".[dev]"
+```
+
+```bash
+pytest -q
+```
+
+The suite is **hermetic**: it ignores your `.env`, needs no API keys, and
+never touches the network. If a test needs configuration, it provides its
+own — see `tests/conftest.py`. A test that only passes on your machine is a
+bug in the test.
+
+Lint before pushing:
+
+```bash
+ruff check .
+```
+
+## Protocol changes
+
+The wire format is defined by the Pydantic models in
+`app/core/protocol/envelope.py`, and the JSON Schemas under `schemas/` are
+**generated from them**:
+
+```bash
+python -m app.core.protocol.export_schemas
+```
+
+CI fails if the committed schemas drift from the models, so regenerate and
+commit them in the same change. Anything that alters the wire format also
+needs:
+
+- a bump to `LIP_PROTOCOL_VERSION` (patch for editorial, minor for
+  backwards-compatible additions, major for anything that breaks an existing
+  implementation);
+- a matching RFC in the specification repository.
+
+Adding an optional field is a minor bump. Renaming or removing one, changing
+a type, or adding a required field is a major bump — no exceptions, because
+implementations in other languages have no way to discover the change
+otherwise.
+
+## Pull requests
+
+- Branch from `main`; keep one logical change per PR.
+- Every behavioural change needs a test that fails without it.
+- Update `CHANGELOG.md` under `## [Unreleased]`.
+- CI must be green: lint, tests on Python 3.11/3.12/3.13, schema check, UI build.
+
+## Reporting bugs
+
+Open an issue using the bug template. A reproduction — the intent text, the
+registered agents, and the session transcript — is worth more than a
+description, because most coordination failures depend on what the model
+returned during negotiation.
+
+For anything security-related, do **not** open an issue. See
+[SECURITY.md](SECURITY.md).
+
+## Code style
+
+Match the surrounding code. The codebase favours explicit docstrings that
+explain *why* a component exists and cite the relevant section of the paper
+(`lip.md`) where one applies. Keep that convention: this is a reference
+implementation, and the code is read as documentation of the protocol.

agentic_bus-0.1.0/Dockerfile

@@ -0,0 +1,65 @@
+# Agentic Bus coordinator — WebSocket bus (8765) + Admin REST API (8766).
+#
+# Built with the [agents] extra so the coordinator can run the CrewAI-backed
+# managed agents it auto-starts on boot, and [mcp] so MCP servers registered
+# through the dashboard can be bridged onto the bus.
+
+FROM python:3.12-slim AS builder
+
+# Building crewai's dependency tree needs a compiler for a few sdists.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /build
+
+# Install into an isolated prefix that the runtime stage copies wholesale,
+# leaving the toolchain behind.
+ENV PIP_NO_CACHE_DIR=1 PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# LICENSE is required at build time: pyproject.toml declares
+# `license = { file = "LICENSE" }`, and hatchling reads it to fill in the
+# package metadata.
+COPY pyproject.toml README.md LICENSE ./
+COPY app ./app
+
+RUN pip install --prefix=/install ".[agents,mcp]"
+
+
+FROM python:3.12-slim AS runtime
+
+LABEL org.opencontainers.image.title="Agentic Bus" \
+      org.opencontainers.image.description="Reference implementation of the Liquid Interfaces Protocol" \
+      org.opencontainers.image.source="https://github.com/draiven-io/agentic-bus" \
+      org.opencontainers.image.licenses="MIT"
+
+# curl is used by the compose healthcheck.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends curl \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /install /usr/local
+
+# The database lives on a volume; the app writes nothing else at runtime.
+RUN useradd --create-home --uid 10001 agbus \
+    && mkdir -p /data \
+    && chown agbus:agbus /data
+
+WORKDIR /app
+COPY --chown=agbus:agbus app ./app
+COPY --chown=agbus:agbus docker/coordinator-entrypoint.sh /usr/local/bin/coordinator-entrypoint.sh
+RUN chmod +x /usr/local/bin/coordinator-entrypoint.sh
+
+USER agbus
+
+ENV AGBUS_HOST=0.0.0.0 \
+    AGBUS_PORT=8765 \
+    AGBUS_API_PORT=8766 \
+    AGBUS_DATABASE_URL=sqlite:////data/agbus.db \
+    PYTHONUNBUFFERED=1
+
+# 8765 = LIP WebSocket transport, 8766 = admin REST API.
+EXPOSE 8765 8766
+
+ENTRYPOINT ["coordinator-entrypoint.sh"]
+CMD ["agbus", "serve"]

agentic_bus-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Dhiogo José Correa de Sá, Carlos Pereira Lopes Filho,
+Carlos Eduardo Schmiedel, and the Agentic Bus contributors
+
+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.