dbl-gateway 0.9.6

DBL Gateway

dbl-gateway

When organizations deploy LLM systems, they quickly need to answer three questions: Who asked what, what was permitted, and what actually happened.

dbl-gateway is the execution boundary for the Deterministic Boundary Layer. It accepts declared intents, enforces policy decisions, and records everything as an append-only, digest-pinned event stream.

Part of the Deterministic Boundary Layer architecture.

Model

Every request passes through the same deterministic chain:

INTENT  ->  DECISION  ->  PROOF  ->  EXECUTION

INTENT records what was asked.
DECISION records what policy allowed.
PROOF records what will be sent.
EXECUTION records what happened.

Only DECISION events are normative. Execution output never feeds back into policy.

Example

Send an intent through POST /ingress/intent and read events through GET /tail?stream_id=default&since=0.

See docs/QUICKSTART.md for the full envelope example.

Zero-Config Demo

No API keys, no .env editing. See the full governance pipeline in 60 seconds:

docker compose --profile demo up --build

Open http://localhost:8010/ui/ and click Start Demo.

Or locally:

GATEWAY_DEMO_MODE=1 dbl-gateway serve

The stub provider generates synthetic responses through the full INTENT, DECISION, PROOF, EXECUTION chain.

One-Command Start

Configure .env once from ​.env.example, set one provider key or local Ollama, then start the gateway with:

docker compose up --build

Open http://localhost:8010/ui/ to watch the event chain in real time.

On Windows, use:

.\run_demo.ps1

Install

pip install dbl-gateway

Or from source:

pip install -e .

Run With Docker

cp .env.example .env
# add one provider key or configure local Ollama in .env
docker compose up --build

Supports OpenAI, Anthropic, or local Ollama. One active provider is enough to run the gateway.

.env stays local and should not be committed. Only .env.example belongs in the repository.

Run Locally

export DBL_GATEWAY_DB=./data/trail.sqlite
export DBL_GATEWAY_POLICY_MODULE=dbl_policy.allow_all
export DBL_GATEWAY_POLICY_OBJECT=policy
export OPENAI_API_KEY=sk-...

dbl-gateway serve --host 127.0.0.1 --port 8010

Observer

Open /ui to watch the event chain in real time.

The built-in observer includes the event stream, decision replay, chain verification, manual intent submission, and the integrated demo controller.

Discovery

The runtime exposes three machine-readable discovery surfaces:

• GET /capabilities
• GET /surfaces
• GET /intent-template

Together they describe what the gateway can do, which surfaces exist, and how to speak valid ingress envelopes.

Documentation

See:

• docs/ARCHITECTURE.md
• docs/QUICKSTART.md
• docs/observer.md
• docs/demo.md
• docs/discovery.md
• docs/CAPABILITIES.md
• docs/wire_contract.md
• docs/env_contract.md
• CHANGELOG.md

Status

v0.9.6. Zero-config stub demo, observer runtime with discovery surfaces, integrated demo control, manual intent, and a one-command Docker start.