Metadata-Version: 2.4
Name: urirun-connector-urivision-runtime
Version: 0.1.0
Summary: Native runtime:// URI surface over urivision's CapabilityRegistry (catalog / explain / guarded call) for ifuri and urirun
Author: Tom Sapletta
License: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: urirun>=0.4.14
Requires-Dist: urivision>=0.1.0

# urirun-connector-urivision-runtime

Native `runtime://` URI surface over [urivision](https://github.com/if-uri/urivision)'s
`CapabilityRegistry` — the URI-addressed **contract map** of the perception/action stack
(`ui://`, `input://`, `view://`, `browser://`, `vision://`, `guard://` …).

urivision's registry is deliberately mock-backed: it owns the *contracts* (schemas,
preconditions, safety tags), while real execution lives in urirun connectors
(kvm / vql / vdisplay). This connector serves the missing piece to the mesh — the
**catalog** — without duplicating any implementation.

## Routes

| Route | What it does |
| --- | --- |
| `runtime://{node}/capabilities/query/list` | Full capability catalog. `format`: `json`, `markdown`, `prompt` (LLM cards), `tools` (OpenAI-style). |
| `runtime://{node}/capability/query/explain` | Resolve one URI → matching capability, captures, expected payload schema. |
| `runtime://{node}/capability/command/call` | Dispatch through the registry. **Dry-run by default** (validate + show what would run); `execute=true` invokes the mock-backed handler. |

## Install

```bash
pip install -e .
# serve it (installed connectors are NOT auto-served):
urirun node serve --name host --allow 'runtime://**'
```

Part of the ifURI solution · Author: Tom Sapletta · Apache-2.0
