uricontrol 0.1.16__tar.gz

uricontrol-0.1.16/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 uricore 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.

uricontrol-0.1.16/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: uricontrol
+Version: 0.1.16
+Summary: Thin URI-native control-plane core for software, services and devices.
+Author: uricontrol contributors
+Author-email: Tom Sapletta <tom@sapletta.com>
+License-Expression: Apache-2.0
+Keywords: uri,control-plane,cqrs,event-sourcing,devices,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: uriguard>=0.1.0
+Provides-Extra: mesh
+Requires-Dist: uriresolver>=0.1.0; extra == "mesh"
+Requires-Dist: uritransport>=0.1.0; extra == "mesh"
+Provides-Extra: mqtt
+Requires-Dist: uriresolver>=0.1.0; extra == "mqtt"
+Requires-Dist: uritransport[mqtt]>=0.1.0; extra == "mqtt"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+Requires-Dist: goal>=2.1.0; python_version >= "3.12" and extra == "dev"
+Requires-Dist: costs>=0.1.20; extra == "dev"
+Requires-Dist: pfix>=0.1.60; extra == "dev"
+Dynamic: license-file
+
+# uricontrol
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.16-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.76-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-17.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $0.7622 (29 commits)
+- 👤 **Human dev:** ~$1710 (17.1h @ $100/h, 30min dedup)
+
+Generated on 2026-10-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+`uricontrol` is a small URI-native control-plane core. It provides a thin deterministic layer over software, services, devices and operating-system capabilities.
+
+The Python distribution is named **`uricontrol`** (renamed from `uricore` — that PyPI name is squatted by an unrelated project), while the runtime module is **`uri_control`**:
+
+```python
+from uri_control import CapabilityRegistry, UriControlRuntime, JsonlEventStore
+```
+
+**URI intent routing** (resolve targets, HTTP/MQTT delegate, wire envelopes) lives in the sibling package **[`uriresolver`](https://github.com/tellmesh/uriresolver)** (`uri_resolver`). `uri_control.resolver`, `.transport`, and `.envelope` are compatibility shims over `uri_resolver`.
+
+The repository also contains placeholder SDK folders for Node/TypeScript, Go and PHP. Those SDKs intentionally remain thin: the source of truth is the URI, the manifest, and the protobuf-style command/event envelope.
+
+## Edge runtime (`uri_control.edge`)
+
+Edge HTTP server, flow runner, and pack composition — formerly the separate **``uri_control.edge``** package (removed 2026-06):
+
+```python
+from uri_control.edge.runtime import Runtime, run_flow
+from uri_control.edge.compose import build_runtime
+from uri_control.edge.http import serve
+```
+
+Used by edge CLIs (`urirdpedge`, `urikvmedge`, …) and orchestrated by **[urisys](https://github.com/tellmesh/urisys)**.
+
+`Runtime.call` resolves the URI via **[`uriresolver`](https://github.com/tellmesh/uriresolver)**
+(`resolve_uri` → optional transport delegation), then — for local execution —
+enforces resolver-declared policy (`uri_resolver.policy.check_operation_limits` /
+`check_shell_policy`) **before** loading the handler, and emits a `*.policy_denied`
+event on violation. Supported handler schemes: `python://`, `http(s)://`, `node://`,
+`urisys://flow/<id>` (built-in process flow runner) and `runtime://resolver/<op>`
+(resolver-bound placeholder: mock under dry-run/`environment: mock`, else a clear
+`no_runtime_binding` error).
+
+## Architecture
+
+```text
+URI
+  ↓
+Capability manifest
+  ↓
+Policy decision
+  ↓
+Command / Query dispatch
+  ↓
+Handler in Python / Node / Go / PHP / any runtime
+  ↓
+Append-only event log
+  ↓
+Projection / status / result
+```
+
+Core rules:
+
+1. URI does not execute.
+2. URI identifies a resource, operation or intent.
+3. Manifest declares capabilities, handlers and policy.
+4. Handler performs the technical work.
+5. Event store records facts.
+6. Projection builds read models from events.
+
+## Repository layout
+
+```text
+uricore/
+  core/
+    python/
+      uri_control/
+        parser.py
+        registry.py
+        dispatcher.py
+        event_store.py
+        projection.py
+        policy.py
+    node/uri-control/
+    go/uricontrol/
+    php/UriControl/
+  contracts/
+    proto/uricore/v1/envelope.proto
+  examples/
+    packs/browser_mock/
+    packs/systemd_mock/
+    call_browser_mock.py
+    call_systemd_mock.py
+  tests/
+```
+
+## Install locally
+
+```bash
+cd uricore
+python -m pip install -e .
+```
+
+For tests:
+
+```bash
+python -m pip install -e .[dev]
+python -m pytest
+```
+
+## CLI examples
+
+Explain a URI against a manifest:
+
+```bash
+uricore explain browser://default/page/open \
+  --manifest examples/packs/browser_mock/manifest.yaml
+```
+
+Call a command:
+
+```bash
+uricore call browser://default/page/open \
+  --manifest examples/packs/browser_mock/manifest.yaml \
+  --payload '{"url":"https://example.com","wait_until_loaded":true}' \
+  --approve \
+  --events output/events.jsonl
+```
+
+Query a projection from JSONL events:
+
+```bash
+uricore projection latest --events output/events.jsonl
+```
+
+## Minimal Python usage
+
+```python
+from uri_control import CapabilityRegistry, JsonlEventStore, UriControlRuntime
+
+registry = CapabilityRegistry.from_manifest_files([
+    "examples/packs/browser_mock/manifest.yaml"
+])
+
+runtime = UriControlRuntime(
+    registry=registry,
+    event_store=JsonlEventStore("output/events.jsonl"),
+)
+
+result = runtime.call(
+    "browser://default/page/open",
+    payload={"url": "https://example.com"},
+    context={"approved": True, "environment": "mock"},
+)
+
+print(result.ok, result.result)
+```
+
+## Manifest example
+
+```yaml
+id: browser-mock-pack
+version: 1
+scheme: browser
+
+uri_patterns:
+  - pattern: browser://{session}/page/open
+    kind: command
+    operation: open_page
+    command_type: browser.v1.OpenPageCommand
+    success_event_type: browser.v1.PageOpenedEvent
+    side_effects: true
+    approval: required
+
+handlers:
+  python:
+    open_page: python://examples.packs.browser_mock.handlers:open_page
+```
+
+## Relationship to `urisys`
+
+`uricore` should stay small and deterministic. A future `urisys` project can reuse it and add:
+
+- concrete device/software packs,
+- HTTP or gRPC gateway,
+- dashboard,
+- scheduler,
+- LLM planner,
+- policy UI,
+- multi-language runners.
+
+`uricore` should not contain those heavier orchestration concerns.
+
+
+## Ekosystem TellMesh
+
+Orchestrator: **[urisys](https://github.com/tellmesh/urisys)** · Mapa: **[MESH.md](https://github.com/tellmesh/urisys/blob/main/docs/MESH.md)** · Model: **[ECOSYSTEM.md](https://github.com/tellmesh/urisys/blob/main/docs/ECOSYSTEM.md)**
+
+| Pole | Wartość |
+|------|---------|
+| **Warstwa** | Control plane + edge runtime |
+| **Moduł** | `uri_control`, `uri_control.edge` |
+| **Zależności** | `uriguard` |
+| **Rola** | CapabilityRegistry, policy, handlers, `Runtime`, `compose`, `http.serve` |
+| **Uwaga** | Zastępuje legacy PyPI `uricore` i `urisysedge` (usunięty 2026-06) |
+
+Runtime edge: **`uri_control.edge`** w pakiecie **`uricontrol`** (legacy PyPI `uricore` / `urisysedge` usunięty 2026-06).
+Resolver intencji: **`uriresolver`** (`uri_resolver`) + transport w **`uritransport`**; policy gate: **`uriguard`** (`uri_guard`).
+
+<!-- end-ecosystem -->
+
+## License
+
+Licensed under Apache-2.0.

uricontrol-0.1.16/README.md

@@ -0,0 +1,219 @@
+# uricontrol
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.16-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$0.76-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-17.1h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $0.7622 (29 commits)
+- 👤 **Human dev:** ~$1710 (17.1h @ $100/h, 30min dedup)
+
+Generated on 2026-10-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+`uricontrol` is a small URI-native control-plane core. It provides a thin deterministic layer over software, services, devices and operating-system capabilities.
+
+The Python distribution is named **`uricontrol`** (renamed from `uricore` — that PyPI name is squatted by an unrelated project), while the runtime module is **`uri_control`**:
+
+```python
+from uri_control import CapabilityRegistry, UriControlRuntime, JsonlEventStore
+```
+
+**URI intent routing** (resolve targets, HTTP/MQTT delegate, wire envelopes) lives in the sibling package **[`uriresolver`](https://github.com/tellmesh/uriresolver)** (`uri_resolver`). `uri_control.resolver`, `.transport`, and `.envelope` are compatibility shims over `uri_resolver`.
+
+The repository also contains placeholder SDK folders for Node/TypeScript, Go and PHP. Those SDKs intentionally remain thin: the source of truth is the URI, the manifest, and the protobuf-style command/event envelope.
+
+## Edge runtime (`uri_control.edge`)
+
+Edge HTTP server, flow runner, and pack composition — formerly the separate **``uri_control.edge``** package (removed 2026-06):
+
+```python
+from uri_control.edge.runtime import Runtime, run_flow
+from uri_control.edge.compose import build_runtime
+from uri_control.edge.http import serve
+```
+
+Used by edge CLIs (`urirdpedge`, `urikvmedge`, …) and orchestrated by **[urisys](https://github.com/tellmesh/urisys)**.
+
+`Runtime.call` resolves the URI via **[`uriresolver`](https://github.com/tellmesh/uriresolver)**
+(`resolve_uri` → optional transport delegation), then — for local execution —
+enforces resolver-declared policy (`uri_resolver.policy.check_operation_limits` /
+`check_shell_policy`) **before** loading the handler, and emits a `*.policy_denied`
+event on violation. Supported handler schemes: `python://`, `http(s)://`, `node://`,
+`urisys://flow/<id>` (built-in process flow runner) and `runtime://resolver/<op>`
+(resolver-bound placeholder: mock under dry-run/`environment: mock`, else a clear
+`no_runtime_binding` error).
+
+## Architecture
+
+```text
+URI
+  ↓
+Capability manifest
+  ↓
+Policy decision
+  ↓
+Command / Query dispatch
+  ↓
+Handler in Python / Node / Go / PHP / any runtime
+  ↓
+Append-only event log
+  ↓
+Projection / status / result
+```
+
+Core rules:
+
+1. URI does not execute.
+2. URI identifies a resource, operation or intent.
+3. Manifest declares capabilities, handlers and policy.
+4. Handler performs the technical work.
+5. Event store records facts.
+6. Projection builds read models from events.
+
+## Repository layout
+
+```text
+uricore/
+  core/
+    python/
+      uri_control/
+        parser.py
+        registry.py
+        dispatcher.py
+        event_store.py
+        projection.py
+        policy.py
+    node/uri-control/
+    go/uricontrol/
+    php/UriControl/
+  contracts/
+    proto/uricore/v1/envelope.proto
+  examples/
+    packs/browser_mock/
+    packs/systemd_mock/
+    call_browser_mock.py
+    call_systemd_mock.py
+  tests/
+```
+
+## Install locally
+
+```bash
+cd uricore
+python -m pip install -e .
+```
+
+For tests:
+
+```bash
+python -m pip install -e .[dev]
+python -m pytest
+```
+
+## CLI examples
+
+Explain a URI against a manifest:
+
+```bash
+uricore explain browser://default/page/open \
+  --manifest examples/packs/browser_mock/manifest.yaml
+```
+
+Call a command:
+
+```bash
+uricore call browser://default/page/open \
+  --manifest examples/packs/browser_mock/manifest.yaml \
+  --payload '{"url":"https://example.com","wait_until_loaded":true}' \
+  --approve \
+  --events output/events.jsonl
+```
+
+Query a projection from JSONL events:
+
+```bash
+uricore projection latest --events output/events.jsonl
+```
+
+## Minimal Python usage
+
+```python
+from uri_control import CapabilityRegistry, JsonlEventStore, UriControlRuntime
+
+registry = CapabilityRegistry.from_manifest_files([
+    "examples/packs/browser_mock/manifest.yaml"
+])
+
+runtime = UriControlRuntime(
+    registry=registry,
+    event_store=JsonlEventStore("output/events.jsonl"),
+)
+
+result = runtime.call(
+    "browser://default/page/open",
+    payload={"url": "https://example.com"},
+    context={"approved": True, "environment": "mock"},
+)
+
+print(result.ok, result.result)
+```
+
+## Manifest example
+
+```yaml
+id: browser-mock-pack
+version: 1
+scheme: browser
+
+uri_patterns:
+  - pattern: browser://{session}/page/open
+    kind: command
+    operation: open_page
+    command_type: browser.v1.OpenPageCommand
+    success_event_type: browser.v1.PageOpenedEvent
+    side_effects: true
+    approval: required
+
+handlers:
+  python:
+    open_page: python://examples.packs.browser_mock.handlers:open_page
+```
+
+## Relationship to `urisys`
+
+`uricore` should stay small and deterministic. A future `urisys` project can reuse it and add:
+
+- concrete device/software packs,
+- HTTP or gRPC gateway,
+- dashboard,
+- scheduler,
+- LLM planner,
+- policy UI,
+- multi-language runners.
+
+`uricore` should not contain those heavier orchestration concerns.
+
+
+## Ekosystem TellMesh
+
+Orchestrator: **[urisys](https://github.com/tellmesh/urisys)** · Mapa: **[MESH.md](https://github.com/tellmesh/urisys/blob/main/docs/MESH.md)** · Model: **[ECOSYSTEM.md](https://github.com/tellmesh/urisys/blob/main/docs/ECOSYSTEM.md)**
+
+| Pole | Wartość |
+|------|---------|
+| **Warstwa** | Control plane + edge runtime |
+| **Moduł** | `uri_control`, `uri_control.edge` |
+| **Zależności** | `uriguard` |
+| **Rola** | CapabilityRegistry, policy, handlers, `Runtime`, `compose`, `http.serve` |
+| **Uwaga** | Zastępuje legacy PyPI `uricore` i `urisysedge` (usunięty 2026-06) |
+
+Runtime edge: **`uri_control.edge`** w pakiecie **`uricontrol`** (legacy PyPI `uricore` / `urisysedge` usunięty 2026-06).
+Resolver intencji: **`uriresolver`** (`uri_resolver`) + transport w **`uritransport`**; policy gate: **`uriguard`** (`uri_guard`).
+
+<!-- end-ecosystem -->
+
+## License
+
+Licensed under Apache-2.0.

uricontrol-0.1.16/core/python/uri_control/__init__.py

@@ -0,0 +1,42 @@
+"""uricore Python runtime module.
+
+The Python distribution is named ``uricore``. The importable runtime module is
+``uri_control`` to keep the API descriptive and language-neutral.
+"""
+
+from . import edge  # noqa: F401  (migrated from urisysedge)
+from .dispatcher import UriControlRuntime
+from .event_store import EventStore, InMemoryEventStore, JsonlEventStore
+from .handlers import load_handler, load_python_handler, make_remote_handler
+from .models import (
+    CapabilityManifest,
+    DispatchResult,
+    EventEnvelope,
+    ParsedUri,
+    PolicyDecision,
+    Route,
+)
+from .parser import parse_uri
+from .policy import PolicyEngine
+from .projection import ProjectionBuilder
+from .registry import CapabilityRegistry
+
+__all__ = [
+    "CapabilityManifest",
+    "CapabilityRegistry",
+    "DispatchResult",
+    "EventEnvelope",
+    "EventStore",
+    "InMemoryEventStore",
+    "JsonlEventStore",
+    "load_handler",
+    "load_python_handler",
+    "make_remote_handler",
+    "ParsedUri",
+    "PolicyDecision",
+    "PolicyEngine",
+    "ProjectionBuilder",
+    "Route",
+    "UriControlRuntime",
+    "parse_uri",
+]

uricontrol-0.1.16/core/python/uri_control/cli.py

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+from .dispatcher import UriControlRuntime
+from .event_store import JsonlEventStore
+from .projection import ProjectionBuilder
+from .registry import CapabilityRegistry
+
+
+def _load_payload(value: str | None) -> dict[str, Any]:
+    if not value:
+        return {}
+    candidate = Path(value)
+    if candidate.exists():
+        return json.loads(candidate.read_text(encoding="utf-8"))
+    return json.loads(value)
+
+
+def _registry_from_args(args: argparse.Namespace) -> CapabilityRegistry:
+    if not args.manifest:
+        raise SystemExit("At least one --manifest path is required.")
+    return CapabilityRegistry.from_manifest_files(args.manifest)
+
+
+def cmd_explain(args: argparse.Namespace) -> int:
+    registry = _registry_from_args(args)
+    print(json.dumps(registry.explain(args.uri), ensure_ascii=False, indent=2))
+    return 0
+
+
+def cmd_call(args: argparse.Namespace) -> int:
+    registry = _registry_from_args(args)
+    store = JsonlEventStore(args.events)
+    runtime = UriControlRuntime(registry=registry, event_store=store)
+    result = runtime.call(
+        args.uri,
+        payload=_load_payload(args.payload),
+        context={"approved": args.approve, "environment": args.environment},
+    )
+    print(json.dumps(result.to_dict(), ensure_ascii=False, indent=2))
+    return 0 if result.ok else 2
+
+
+def cmd_list(args: argparse.Namespace) -> int:
+    registry = _registry_from_args(args)
+    data = [
+        {
+            "manifest_id": route.manifest_id,
+            "scheme": route.scheme,
+            "pattern": route.pattern,
+            "kind": route.kind,
+            "operation": route.operation,
+            "side_effects": route.side_effects,
+            "approval": route.approval,
+        }
+        for route in registry.routes
+    ]
+    print(json.dumps(data, ensure_ascii=False, indent=2))
+    return 0
+
+
+def cmd_projection_latest(args: argparse.Namespace) -> int:
+    store = JsonlEventStore(args.events)
+    builder = ProjectionBuilder(store)
+    print(json.dumps(builder.latest_by_source_uri(), ensure_ascii=False, indent=2))
+    return 0
+
+
+def cmd_projection_status(args: argparse.Namespace) -> int:
+    store = JsonlEventStore(args.events)
+    builder = ProjectionBuilder(store)
+    print(json.dumps(builder.status_by_source_uri(), ensure_ascii=False, indent=2))
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="uricontrol")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    explain = sub.add_parser("explain", help="Explain how a URI matches a manifest route.")
+    explain.add_argument("uri")
+    explain.add_argument("--manifest", action="append", required=True)
+    explain.set_defaults(func=cmd_explain)
+
+    call = sub.add_parser("call", help="Call a URI through policy, handler and event store.")
+    call.add_argument("uri")
+    call.add_argument("--manifest", action="append", required=True)
+    call.add_argument("--payload", default="{}", help="JSON string or path to JSON file.")
+    call.add_argument("--events", default="output/events.jsonl")
+    call.add_argument("--environment", default="local")
+    call.add_argument("--approve", action="store_true")
+    call.set_defaults(func=cmd_call)
+
+    list_cmd = sub.add_parser("list", help="List capability routes from manifests.")
+    list_cmd.add_argument("--manifest", action="append", required=True)
+    list_cmd.set_defaults(func=cmd_list)
+
+    projection = sub.add_parser("projection", help="Build projections from events.")
+    projection_sub = projection.add_subparsers(dest="projection_command", required=True)
+
+    latest = projection_sub.add_parser("latest", help="Latest event by source URI.")
+    latest.add_argument("--events", default="output/events.jsonl")
+    latest.set_defaults(func=cmd_projection_latest)
+
+    status = projection_sub.add_parser("status", help="Status projection by source URI.")
+    status.add_argument("--events", default="output/events.jsonl")
+    status.set_defaults(func=cmd_projection_status)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return int(args.func(args))
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())