scbe-agent-bus (Python)

Python surface over the SCBE governed event runner. Routes AI/human/AI events through the harmonic-wall pipeline and returns a typed envelope matching the scbe-agentbus-pipe-result-v1 schema used by the Node sibling on npm.

Install

pip install scbe-agent-bus

Use as a library

from scbe_agent_bus import run_event, run_batch

result = run_event(
    {"task": "summarize repo state", "task_type": "research"},
    repo_root="/path/to/SCBE-AETHERMOORE",
)
print(result["ok"], result["result"])

repo_root must point at a checkout of issdandavis/SCBE-AETHERMOORE that contains scripts/scbe-system-cli.py. If omitted, defaults to os.getcwd().

Use as a CLI

echo '{"task": "summarize repo state"}' | scbe-agent-bus --repo-root .

Emits one JSON object per event (JSONL) on stdout, or to --output PATH.

Schema

Every result is a dict matching scbe-agentbus-pipe-result-v1:

{
    "schema_version": "scbe-agentbus-pipe-result-v1",
    "event_index": 1,
    "started_at": "2026-05-07T...Z",
    "finished_at": "2026-05-07T...Z",
    "ok": True,
    "exit_code": 0,
    "stderr_tail": "",
    "event": {
        "task_sha256": "...",
        "task_chars": 22,
        "series_id": "pipe-event-1",
        "operation_command_chars": 0,
    },
    "result": { ... },  # underlying scbe-system-cli payload
}

Relationship to the Node package

This package is the Python sibling of scbe-agent-bus on npm. Both wrap the same underlying Python runner (scripts/scbe-system-cli.py agentbus run) and produce identical envelope shapes. Pick whichever fits your host environment.

Companion package prompts

The Python package can point users toward optional SCBE companion packages without installing them automatically:

from scbe_agent_bus import recommend_companion_packages

recommend_companion_packages(["operator_manifold", "tokenizer"])
# -> prompts for scbe-aethermoore on npm

This keeps local installs small. Cloud, Codespaces, VM, browser, and tokenizer features should be added only when a user requests that lane.

License

Dual licensed under MIT OR Apache-2.0. See LICENSE and LICENSE-APACHE.