urml-llm-bridge 0.1.0__tar.gz

urml_llm_bridge-0.1.0/.gitignore

@@ -0,0 +1,104 @@
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual envs
+.venv/
+venv/
+env/
+ENV/
+.python-version
+
+# Test / coverage / mypy / pyright
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+.mypy_cache/
+.dmypy.json
+.pyre/
+.pyright/
+htmlcov/
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.tox/
+
+# --- Node / web tooling (kept out of core repo; here for safety) ---
+node_modules/
+.pnp.*
+.yarn/cache/
+.yarn/unplugged/
+.yarn/build-state.yml
+.yarn/install-state.gz
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# --- C++ / Rust build artifacts (in case reference runtimes land here in early Phase 1) ---
+target/
+*.o
+*.obj
+*.a
+*.lib
+*.dll
+*.dylib
+*.exe
+*.pdb
+cmake-build-*/
+CMakeCache.txt
+CMakeFiles/
+CMakeScripts/
+Testing/
+cmake_install.cmake
+install_manifest.txt
+compile_commands.json
+
+# --- ROS 2 build dirs ---
+build/
+install/
+log/
+
+# --- Editor and OS junk ---
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# --- Local-only artifacts ---
+.env
+.env.*
+*.log
+*.tmp
+.local/
+.scratch/
+
+# --- Outreach campaign artifacts (operational, not part of the open standard) ---
+# Target lists, message drafts, tracking data, and the launch-approval record
+# stay local. They are private to the maintainer; committing them would
+# telegraph the campaign before launch and could embarrass listed projects.
+outreach/

urml_llm_bridge-0.1.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: urml-llm-bridge
+Version: 0.1.0
+Summary: Provider-agnostic glue between natural language and validated URML programs.
+Project-URL: Homepage, https://github.com/URML-MARS/URML
+Project-URL: Repository, https://github.com/URML-MARS/URML
+Project-URL: Issues, https://github.com/URML-MARS/URML/issues
+Author: URML Maintainers
+License: Apache-2.0
+Keywords: llm,robotics,specification,urml
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: pydantic<3,>=2.6
+Requires-Dist: pyyaml<7,>=6.0
+Requires-Dist: urml-validator>=0.1.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.34; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: anthropic>=0.34; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: openai>=1.40; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Provides-Extra: llama-cpp
+Requires-Dist: httpx>=0.27; extra == 'llama-cpp'
+Provides-Extra: ollama
+Requires-Dist: httpx>=0.27; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.40; extra == 'openai'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://urml.dev"><img src="https://urml.dev/favicon.svg" alt="URML" width="72" height="72"></a>
+</p>
+
+<p align="center">
+  A small, opinionated, human-readable language for describing robot intent.
+</p>
+
+<p align="center">
+  <a href="https://urml.dev"><b>urml.dev</b></a>
+</p>
+
+---
+
+# LLM Bridge
+
+**Status:** `0.1.0`, aligned with the other four packages. Shipped: the provider-agnostic `Bridge` + bounded validator-feedback revision loop, real Anthropic / OpenAI adapters (lazy-imported) + the hermetic `EchoProvider`, the `urml translate` / `urml emit-prompt` CLI, and profile-scoped few-shot libraries (home / industrial / drone). The normative contract is [`spec/layer-4-nl-grammar/v0.1.0.md`](../../spec/layer-4-nl-grammar/); a hermetic end-to-end walkthrough is [`docs/demos/bridge-roundtrip.md`](../../docs/demos/bridge-roundtrip.md).
+
+## What this is
+
+The **provider-agnostic glue** between natural-language input and a validated URML program. The LLM bridge:
+
+1. Takes a natural-language request from a user (or another system).
+2. Prompts a configured LLM with the [Layer-4 prompt contract](../../spec/layer-4-nl-grammar/), the connected robot's [Layer-1 capability manifest](../../spec/layer-1-hal/), and the active safety envelope.
+3. Receives the LLM's emission (a URML program).
+4. Calls the [validator](../validator/) to statically verify the emission.
+5. On rejection, surfaces the structured error back to the LLM and requests a revision. Repeats up to a configured bound.
+6. On acceptance, hands the validated program to the runtime for execution.
+7. When the request needs a capability the manifest does not declare, the model emits a `report(status: failure)` naming what is missing rather than fabricating capability. (An *interactive* clarifying-question protocol is **not** in v0.1 — see [`spec/layer-4-nl-grammar/v0.1.0.md`](../../spec/layer-4-nl-grammar/) §5.)
+
+## Provider neutrality is non-negotiable
+
+URML's value as a standard depends on Layer 4 being **provider-neutral**. The LLM bridge must support, as first-class citizens:
+
+- **Anthropic** (Claude family).
+- **OpenAI** (GPT family).
+- **Open-weights models** (Llama, Mistral, Qwen, and their successors), via local serving (vLLM, llama.cpp, Ollama) or hosted inference providers.
+- **On-device models** for offline-capable deployments.
+
+Adding a new provider must be a small adapter in `providers/`, not a structural change to the bridge. If a provider's particular feature would let URML produce better URML, the bridge surfaces the feature behind a profile-neutral abstraction — never by privileging that provider.
+
+Vendor lock-in here is explicitly prohibited by [`CLAUDE.md`](../../CLAUDE.md) §What Claude Should Never Do.
+
+## What the bridge does NOT do
+
+- It does **not** include or embed any specific LLM provider's API client as a hard dependency. Provider clients are optional and pluggable.
+- It does **not** require cloud connectivity. A deployment using a local open-weights model runs offline end to end.
+- It does **not** persist user inputs, model outputs, or any other data without explicit, opt-in, documented purpose. Trust is the most valuable asset of this project; the bridge will not be the place it leaks.
+- It does **not** execute URML. That is the runtime's job.
+- It does **not** make safety decisions. The validator is the safety boundary; the bridge only relays.
+
+## Architecture (planned)
+
+```
+                ┌────────────────────────┐
+   user / NL    │   LLM Bridge           │   validated URML
+   ─────────────▶  • build prompt        ├──────────────────▶  runtime
+                │  • call provider       │
+                │  • validate emission   │
+                │  • revise loop         │
+                └──┬──────────────────▲──┘
+                   │                  │
+                   ▼                  │
+              providers/           validator
+              (anthropic.py,       (separate
+               openai.py,           process)
+               local_vllm.py,
+               on_device.py)
+```
+
+The bridge is small. The intelligence lives in the LLM (which is configured, not built here) and in the validator (which is a separate process). The bridge orchestrates.
+
+## Language
+
+- **Python**. `mypy --strict`. Public API fully type-annotated.
+
+## API (sketch)
+
+```python
+from urml.llm_bridge import Bridge
+
+bridge = Bridge(
+    provider="anthropic",          # or "openai", "vllm", "ollama", ...
+    spec_versions={...},
+    manifest=manifest,
+    envelope=envelope,
+    profiles=("home",),
+    max_revisions=3,
+)
+
+result = bridge.translate("Bring me the red mug from the kitchen.")
+
+if result.accepted:
+    runtime.execute(result.program)
+else:
+    # After max_revisions, structured errors surface to the caller.
+    show_user(result.user_message, result.errors)
+```
+
+## Conformance contract
+
+The bridge has its own conformance bar: for the published few-shot example library, the bridge produces accepted URML at or above a stated success rate (per-provider, declared in the bridge's release notes). The conformance suite includes these end-to-end fixtures.
+
+## Core Commitment
+
+The LLM bridge — the *bridge logic and the prompt contract*, not any specific provider's API — is part of the [Core Commitment](../../CORE_COMMITMENT.md). It will always be Apache 2.0 and provider-agnostic.
+
+## Quickstart (current pre-alpha — hermetic, no provider needed)
+
+```bash
+cd reference/llm-bridge
+python -m venv .venv && . .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e ../validator           # bridge depends on validator
+pip install -e ".[dev]"
+pytest
+```
+
+Use it in code with the bundled `EchoProvider` (for tests / hermetic CI):
+
+```python
+import json
+from urml_llm_bridge import Bridge, EchoProvider
+
+red_mug_program = {  # the URML the LLM is expected to emit
+    "profile": "home",
+    "behavior": {"type": "sequence", "steps": [...]},
+}
+
+provider = EchoProvider(scripted=[json.dumps(red_mug_program)])
+bridge = Bridge(provider=provider, manifest=manifest, envelope=envelope, profiles=("home",))
+result = bridge.translate("Bring me the red mug from the kitchen.")
+
+if result.accepted:
+    runtime.execute(result.program)
+```
+
+The revision loop runs automatically when the validator rejects the LLM's emission: the bridge feeds the structured errors back to the LLM and asks for a corrected version, up to `max_revisions` times (default 3).
+
+### Using a real provider
+
+Install the extra for the provider you want — the bridge package itself has no SDK dependencies:
+
+```bash
+pip install urml-llm-bridge[anthropic]    # adds the `anthropic` SDK
+pip install urml-llm-bridge[openai]       # adds the `openai` SDK
+```
+
+Then:
+
+```python
+from urml_llm_bridge import Bridge
+from urml_llm_bridge.providers.anthropic import AnthropicProvider
+
+provider = AnthropicProvider(model="claude-sonnet-4-6")  # reads ANTHROPIC_API_KEY env var
+bridge = Bridge(provider=provider, manifest=manifest, envelope=envelope, profiles=("home",))
+result = bridge.translate("Bring me the red mug from the kitchen.")
+```
+
+Or OpenAI:
+
+```python
+from urml_llm_bridge.providers.openai import OpenAIProvider
+
+provider = OpenAIProvider(model="gpt-4o")  # reads OPENAI_API_KEY env var
+```
+
+Both adapters surface their native structured-output mechanism — Anthropic via tool use (with the URML schema as the `emit_urml` tool's `input_schema`), OpenAI via `response_format={"type": "json_object"}` with the schema conveyed in the system prompt. Either way, conformance to the schema is validated downstream by `urml_validator.validate()` as part of the bridge's revision loop.
+
+## What's not in this pre-alpha (lands next)
+
+- **CLI integration** — `urml translate` subcommand on top of `urml-validator`'s CLI.
+- **Profile-specific few-shot libraries** (drone scenarios, industrial scenarios).
+- **Multilingual few-shot variants** (Hebrew, Spanish, Japanese, Mandarin).
+- **Conversation memory** for follow-up requests within a session.
+- **OpenAI strict JSON-schema mode** — needs schema preprocessing to satisfy the strict-mode constraints (every property required, no `oneOf`, etc.). The current adapter uses `json_object` mode plus the schema in the system prompt for portability.
+
+## Related documents
+
+- [`/spec/layer-4-nl-grammar/`](../../spec/layer-4-nl-grammar/) — the prompt contract this bridge implements.
+- [`/reference/validator/`](../validator/) — the safety boundary this bridge feeds.
+- [`/examples/`](../../examples/) — the paired natural-language / URML scenarios used as fixtures.
+- [`CLAUDE.md`](../../CLAUDE.md) §What Claude Should Never Do — the provider-neutrality requirement, in writing.

urml_llm_bridge-0.1.0/README.md

@@ -0,0 +1,182 @@
+<p align="center">
+  <a href="https://urml.dev"><img src="https://urml.dev/favicon.svg" alt="URML" width="72" height="72"></a>
+</p>
+
+<p align="center">
+  A small, opinionated, human-readable language for describing robot intent.
+</p>
+
+<p align="center">
+  <a href="https://urml.dev"><b>urml.dev</b></a>
+</p>
+
+---
+
+# LLM Bridge
+
+**Status:** `0.1.0`, aligned with the other four packages. Shipped: the provider-agnostic `Bridge` + bounded validator-feedback revision loop, real Anthropic / OpenAI adapters (lazy-imported) + the hermetic `EchoProvider`, the `urml translate` / `urml emit-prompt` CLI, and profile-scoped few-shot libraries (home / industrial / drone). The normative contract is [`spec/layer-4-nl-grammar/v0.1.0.md`](../../spec/layer-4-nl-grammar/); a hermetic end-to-end walkthrough is [`docs/demos/bridge-roundtrip.md`](../../docs/demos/bridge-roundtrip.md).
+
+## What this is
+
+The **provider-agnostic glue** between natural-language input and a validated URML program. The LLM bridge:
+
+1. Takes a natural-language request from a user (or another system).
+2. Prompts a configured LLM with the [Layer-4 prompt contract](../../spec/layer-4-nl-grammar/), the connected robot's [Layer-1 capability manifest](../../spec/layer-1-hal/), and the active safety envelope.
+3. Receives the LLM's emission (a URML program).
+4. Calls the [validator](../validator/) to statically verify the emission.
+5. On rejection, surfaces the structured error back to the LLM and requests a revision. Repeats up to a configured bound.
+6. On acceptance, hands the validated program to the runtime for execution.
+7. When the request needs a capability the manifest does not declare, the model emits a `report(status: failure)` naming what is missing rather than fabricating capability. (An *interactive* clarifying-question protocol is **not** in v0.1 — see [`spec/layer-4-nl-grammar/v0.1.0.md`](../../spec/layer-4-nl-grammar/) §5.)
+
+## Provider neutrality is non-negotiable
+
+URML's value as a standard depends on Layer 4 being **provider-neutral**. The LLM bridge must support, as first-class citizens:
+
+- **Anthropic** (Claude family).
+- **OpenAI** (GPT family).
+- **Open-weights models** (Llama, Mistral, Qwen, and their successors), via local serving (vLLM, llama.cpp, Ollama) or hosted inference providers.
+- **On-device models** for offline-capable deployments.
+
+Adding a new provider must be a small adapter in `providers/`, not a structural change to the bridge. If a provider's particular feature would let URML produce better URML, the bridge surfaces the feature behind a profile-neutral abstraction — never by privileging that provider.
+
+Vendor lock-in here is explicitly prohibited by [`CLAUDE.md`](../../CLAUDE.md) §What Claude Should Never Do.
+
+## What the bridge does NOT do
+
+- It does **not** include or embed any specific LLM provider's API client as a hard dependency. Provider clients are optional and pluggable.
+- It does **not** require cloud connectivity. A deployment using a local open-weights model runs offline end to end.
+- It does **not** persist user inputs, model outputs, or any other data without explicit, opt-in, documented purpose. Trust is the most valuable asset of this project; the bridge will not be the place it leaks.
+- It does **not** execute URML. That is the runtime's job.
+- It does **not** make safety decisions. The validator is the safety boundary; the bridge only relays.
+
+## Architecture (planned)
+
+```
+                ┌────────────────────────┐
+   user / NL    │   LLM Bridge           │   validated URML
+   ─────────────▶  • build prompt        ├──────────────────▶  runtime
+                │  • call provider       │
+                │  • validate emission   │
+                │  • revise loop         │
+                └──┬──────────────────▲──┘
+                   │                  │
+                   ▼                  │
+              providers/           validator
+              (anthropic.py,       (separate
+               openai.py,           process)
+               local_vllm.py,
+               on_device.py)
+```
+
+The bridge is small. The intelligence lives in the LLM (which is configured, not built here) and in the validator (which is a separate process). The bridge orchestrates.
+
+## Language
+
+- **Python**. `mypy --strict`. Public API fully type-annotated.
+
+## API (sketch)
+
+```python
+from urml.llm_bridge import Bridge
+
+bridge = Bridge(
+    provider="anthropic",          # or "openai", "vllm", "ollama", ...
+    spec_versions={...},
+    manifest=manifest,
+    envelope=envelope,
+    profiles=("home",),
+    max_revisions=3,
+)
+
+result = bridge.translate("Bring me the red mug from the kitchen.")
+
+if result.accepted:
+    runtime.execute(result.program)
+else:
+    # After max_revisions, structured errors surface to the caller.
+    show_user(result.user_message, result.errors)
+```
+
+## Conformance contract
+
+The bridge has its own conformance bar: for the published few-shot example library, the bridge produces accepted URML at or above a stated success rate (per-provider, declared in the bridge's release notes). The conformance suite includes these end-to-end fixtures.
+
+## Core Commitment
+
+The LLM bridge — the *bridge logic and the prompt contract*, not any specific provider's API — is part of the [Core Commitment](../../CORE_COMMITMENT.md). It will always be Apache 2.0 and provider-agnostic.
+
+## Quickstart (current pre-alpha — hermetic, no provider needed)
+
+```bash
+cd reference/llm-bridge
+python -m venv .venv && . .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e ../validator           # bridge depends on validator
+pip install -e ".[dev]"
+pytest
+```
+
+Use it in code with the bundled `EchoProvider` (for tests / hermetic CI):
+
+```python
+import json
+from urml_llm_bridge import Bridge, EchoProvider
+
+red_mug_program = {  # the URML the LLM is expected to emit
+    "profile": "home",
+    "behavior": {"type": "sequence", "steps": [...]},
+}
+
+provider = EchoProvider(scripted=[json.dumps(red_mug_program)])
+bridge = Bridge(provider=provider, manifest=manifest, envelope=envelope, profiles=("home",))
+result = bridge.translate("Bring me the red mug from the kitchen.")
+
+if result.accepted:
+    runtime.execute(result.program)
+```
+
+The revision loop runs automatically when the validator rejects the LLM's emission: the bridge feeds the structured errors back to the LLM and asks for a corrected version, up to `max_revisions` times (default 3).
+
+### Using a real provider
+
+Install the extra for the provider you want — the bridge package itself has no SDK dependencies:
+
+```bash
+pip install urml-llm-bridge[anthropic]    # adds the `anthropic` SDK
+pip install urml-llm-bridge[openai]       # adds the `openai` SDK
+```
+
+Then:
+
+```python
+from urml_llm_bridge import Bridge
+from urml_llm_bridge.providers.anthropic import AnthropicProvider
+
+provider = AnthropicProvider(model="claude-sonnet-4-6")  # reads ANTHROPIC_API_KEY env var
+bridge = Bridge(provider=provider, manifest=manifest, envelope=envelope, profiles=("home",))
+result = bridge.translate("Bring me the red mug from the kitchen.")
+```
+
+Or OpenAI:
+
+```python
+from urml_llm_bridge.providers.openai import OpenAIProvider
+
+provider = OpenAIProvider(model="gpt-4o")  # reads OPENAI_API_KEY env var
+```
+
+Both adapters surface their native structured-output mechanism — Anthropic via tool use (with the URML schema as the `emit_urml` tool's `input_schema`), OpenAI via `response_format={"type": "json_object"}` with the schema conveyed in the system prompt. Either way, conformance to the schema is validated downstream by `urml_validator.validate()` as part of the bridge's revision loop.
+
+## What's not in this pre-alpha (lands next)
+
+- **CLI integration** — `urml translate` subcommand on top of `urml-validator`'s CLI.
+- **Profile-specific few-shot libraries** (drone scenarios, industrial scenarios).
+- **Multilingual few-shot variants** (Hebrew, Spanish, Japanese, Mandarin).
+- **Conversation memory** for follow-up requests within a session.
+- **OpenAI strict JSON-schema mode** — needs schema preprocessing to satisfy the strict-mode constraints (every property required, no `oneOf`, etc.). The current adapter uses `json_object` mode plus the schema in the system prompt for portability.
+
+## Related documents
+
+- [`/spec/layer-4-nl-grammar/`](../../spec/layer-4-nl-grammar/) — the prompt contract this bridge implements.
+- [`/reference/validator/`](../validator/) — the safety boundary this bridge feeds.
+- [`/examples/`](../../examples/) — the paired natural-language / URML scenarios used as fixtures.
+- [`CLAUDE.md`](../../CLAUDE.md) §What Claude Should Never Do — the provider-neutrality requirement, in writing.

urml_llm_bridge-0.1.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "urml-llm-bridge"
+version = "0.1.0"
+description = "Provider-agnostic glue between natural language and validated URML programs."
+readme = "README.md"
+license = { text = "Apache-2.0" }
+requires-python = ">=3.11"
+authors = [{ name = "URML Maintainers" }]
+keywords = ["robotics", "urml", "llm", "specification"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+  "pydantic>=2.6,<3",
+  "PyYAML>=6.0,<7",
+  "urml-validator>=0.1.0",
+]
+
+[project.optional-dependencies]
+# Provider adapters are opt-in. Install the ones you need.
+anthropic = ["anthropic>=0.34"]
+openai = ["openai>=1.40"]
+# On-device adapters (RFC-0021) talk HTTP to a local inference server.
+# Both depend on httpx and require a separately-running server (llama-server
+# or ollama serve); neither bundles model weights.
+llama_cpp = ["httpx>=0.27"]
+ollama = ["httpx>=0.27"]
+dev = [
+  "pytest>=8",
+  "pytest-cov>=5",
+  "ruff>=0.5",
+  "mypy>=1.10",
+  "types-PyYAML>=6.0",
+  # Provider SDKs included in dev so mypy can type-check the adapters
+  # and the test suite can exercise them with mocked clients. End users
+  # install just the extras they need (e.g., pip install urml-llm-bridge[anthropic]).
+  "anthropic>=0.34",
+  "openai>=1.40",
+  "httpx>=0.27",
+]
+
+[project.urls]
+Homepage = "https://github.com/URML-MARS/URML"
+Repository = "https://github.com/URML-MARS/URML"
+Issues = "https://github.com/URML-MARS/URML/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/urml_llm_bridge"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "N", "ANN", "RUF"]
+ignore = ["ANN401"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["ANN"]
+
+[tool.mypy]
+strict = true
+python_version = "3.11"
+plugins = ["pydantic.mypy"]
+mypy_path = "src"
+packages = ["urml_llm_bridge"]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+addopts = ["-q", "--strict-markers"]

urml_llm_bridge-0.1.0/src/urml_llm_bridge/__init__.py

@@ -0,0 +1,56 @@
+"""urml_llm_bridge — provider-agnostic glue from natural language to validated URML.
+
+Public API:
+
+  Bridge(provider, manifest, envelope=None, profiles=(), max_revisions=3)
+    .translate(user_request: str) -> TranslateResult
+
+  EchoProvider(responses: dict[str, str])
+    A hermetic provider for testing, with no network.
+
+Bring your own provider by implementing LLMProvider.complete(). Real
+adapters for Anthropic and OpenAI live under `urml_llm_bridge.providers`
+and are imported lazily so the bridge has no hard dependency on either
+SDK.
+"""
+
+from __future__ import annotations
+
+from urml_llm_bridge._version import __version__
+from urml_llm_bridge.bridge import Bridge, TranslateResult
+from urml_llm_bridge.errors import (
+    BridgeError,
+    BridgePolicyViolation,
+    BridgeRevisionExhausted,
+    ProviderError,
+)
+from urml_llm_bridge.few_shot import (
+    FewShot,
+    default_few_shots,
+    drone_few_shots,
+    few_shots_for,
+    home_few_shots,
+    industrial_few_shots,
+)
+from urml_llm_bridge.prompt import build_system_prompt
+from urml_llm_bridge.providers.base import LLMProvider
+from urml_llm_bridge.providers.echo import EchoProvider
+
+__all__ = [
+    "Bridge",
+    "BridgeError",
+    "BridgePolicyViolation",
+    "BridgeRevisionExhausted",
+    "EchoProvider",
+    "FewShot",
+    "LLMProvider",
+    "ProviderError",
+    "TranslateResult",
+    "__version__",
+    "build_system_prompt",
+    "default_few_shots",
+    "drone_few_shots",
+    "few_shots_for",
+    "home_few_shots",
+    "industrial_few_shots",
+]

urml_llm_bridge-0.1.0/src/urml_llm_bridge/_version.py

@@ -0,0 +1,5 @@
+"""Single source of truth for the bridge's `__version__`."""
+
+from __future__ import annotations
+
+__version__: str = "0.1.0"