tigrbl-kernel 0.1.0.dev15__tar.gz → 0.1.11.dev1__tar.gz

tigrbl_kernel-0.1.11.dev1/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: tigrbl-kernel
+Version: 0.1.11.dev1
+Summary: Kernel orchestration for Tigrbl runtime composition.
+License-Expression: Apache-2.0
+Keywords: tigrbl,sdk,standards,framework
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 1 - Planning
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: tigrbl-atoms
+Requires-Dist: tigrbl-core
+Requires-Dist: tigrbl-typing
+Description-Content-Type: text/markdown
+
+# tigrbl_kernel
+
+This file is a package-local distribution entry point.
+It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+
+## Canonical repository docs
+
+- `README.md`
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package identity
+
+- workspace path: `pkgs/core/tigrbl_kernel`
+- workspace class: core Python package
+- implementation layout: `tigrbl_kernel/`
+
+Long-form repository documentation is governed from `docs/`.
+

tigrbl_kernel-0.1.11.dev1/README.md

@@ -0,0 +1,23 @@
+# tigrbl_kernel
+
+This file is a package-local distribution entry point.
+It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+
+## Canonical repository docs
+
+- `README.md`
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package identity
+
+- workspace path: `pkgs/core/tigrbl_kernel`
+- workspace class: core Python package
+- implementation layout: `tigrbl_kernel/`
+
+Long-form repository documentation is governed from `docs/`.

{tigrbl_kernel-0.1.0.dev15 → tigrbl_kernel-0.1.11.dev1}/pyproject.toml

@@ -1,17 +1,17 @@
 [project]
 name = "tigrbl-kernel"
-version = "0.1.0.dev15"
+version = "0.1.11.dev1"
 description = "Kernel orchestration for Tigrbl runtime composition."
 license = "Apache-2.0"
 readme = "README.md"
 repository = "http://github.com/swarmauri/swarmauri-sdk"
-requires-python = ">=3.10,<3.13"
+requires-python = ">=3.10,<3.14"
 classifiers = [
-    "License :: OSI Approved :: Apache Software License",
     "Development Status :: 1 - Planning",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",

tigrbl_kernel-0.1.11.dev1/tigrbl_kernel/__init__.py

@@ -0,0 +1,88 @@
+from __future__ import annotations
+
+from importlib import import_module
+from typing import Any, Dict, List, Mapping
+
+try:  # pragma: no cover - additive optional integration
+    _runtime_rust = import_module("tigrbl_runtime.rust")
+    ExecutionBackend = _runtime_rust.ExecutionBackend
+    RustBackendConfig = _runtime_rust.RustBackendConfig
+except Exception:  # pragma: no cover
+    ExecutionBackend = RustBackendConfig = None
+
+from .rust_compile import (
+    build_rust_kernel,
+    build_rust_parity_snapshot,
+    normalize_rust_spec,
+)
+from .rust_plan import RustPlan
+
+_LAZY_EXPORTS = {
+    "Kernel": "core",
+    "OpView": "models",
+    "PackedKernel": "models",
+    "SchemaIn": "models",
+    "SchemaOut": "models",
+}
+
+_default_kernel = None
+
+
+def _kernel():
+    global _default_kernel
+    if _default_kernel is None:
+        kernel_cls = __getattr__("Kernel")
+        _default_kernel = kernel_cls()
+    return _default_kernel
+
+
+def __getattr__(name: str) -> Any:
+    module_name = _LAZY_EXPORTS.get(name)
+    if module_name is None:
+        raise AttributeError(name)
+    module = import_module(f"{__name__}.{module_name}")
+    value = getattr(module, name)
+    globals()[name] = value
+    return value
+
+
+def get_cached_specs(model: type) -> Mapping[str, Any]:
+    return _kernel().get_specs(model)
+
+
+def build_phase_chains(model: type, alias: str) -> Dict[str, List[Any]]:
+    return _kernel()._build_op(model, alias)
+
+
+def build_kernel_plan(app: Any):
+    return _kernel().kernel_plan(app)
+
+
+def build_packed_kernel(app: Any):
+    return _kernel().kernel_plan(app).packed
+
+
+def plan_labels(model: type, alias: str) -> list[str]:
+    return _kernel().plan_labels(model, alias)
+
+
+__all__ = [
+    "ExecutionBackend",
+    "Kernel",
+    "RustBackendConfig",
+    "RustPlan",
+    "OpView",
+    "PackedKernel",
+    "SchemaIn",
+    "SchemaOut",
+    "build_kernel_plan",
+    "build_rust_kernel",
+    "build_rust_parity_snapshot",
+    "build_packed_kernel",
+    "get_cached_specs",
+    "build_phase_chains",
+    "normalize_rust_spec",
+    "plan_labels",
+]
+
+_default_kernel = _kernel()

{tigrbl_kernel-0.1.0.dev15 → tigrbl_kernel-0.1.11.dev1}/tigrbl_kernel/_compile.py

@@ -4,6 +4,7 @@ from dataclasses import replace
 from typing import Any, Mapping
 
 from tigrbl_atoms import StepFn
+from tigrbl_core.config.constants import __JSONRPC_DEFAULT_ENDPOINT__
 
 from . import events as _ev
 from .models import KernelPlan, OpKey, OpMeta, OpView
@@ -33,6 +34,9 @@ def _compile_plan(self: Any, app: Any) -> KernelPlan:
     from tigrbl_core._spec.binding_spec import (
         HttpJsonRpcBindingSpec,
         HttpRestBindingSpec,
+        HttpStreamBindingSpec,
+        SseBindingSpec,
+        WebTransportBindingSpec,
         WsBindingSpec,
     )
 
@@ -64,7 +68,10 @@ def _compile_plan(self: Any, app: Any) -> KernelPlan:
             )
 
             for binding in getattr(sp, "bindings", ()) or ():
-                if isinstance(binding, HttpRestBindingSpec):
+                if isinstance(
+                    binding,
+                    (HttpRestBindingSpec, HttpStreamBindingSpec, SseBindingSpec),
+                ):
                     bucket = route_data.setdefault(
                         binding.proto, {"exact": {}, "templated": []}
                     )
@@ -94,14 +101,29 @@ def _compile_plan(self: Any, app: Any) -> KernelPlan:
                                 )
 
                 elif isinstance(binding, HttpJsonRpcBindingSpec):
-                    opkey_to_meta[
-                        OpKey(proto=binding.proto, selector=binding.rpc_method)
-                    ] = meta_index
-                    route_data.setdefault(binding.proto, {})[binding.rpc_method] = (
+                    endpoint = str(
+                        getattr(binding, "endpoint", __JSONRPC_DEFAULT_ENDPOINT__)
+                        or __JSONRPC_DEFAULT_ENDPOINT__
+                    )
+                    selector = f"{endpoint}:{binding.rpc_method}"
+                    opkey_to_meta[OpKey(proto=binding.proto, selector=selector)] = (
                         meta_index
                     )
-
-                elif isinstance(binding, WsBindingSpec):
+                    proto_bucket = route_data.setdefault(
+                        binding.proto, {"endpoints": {}}
+                    )
+                    endpoint_bucket = proto_bucket.setdefault("endpoints", {}).setdefault(
+                        endpoint, {}
+                    )
+                    proto_bucket[binding.rpc_method] = meta_index
+                    endpoint_bucket[binding.rpc_method] = {
+                        "meta_index": meta_index,
+                        "selector": selector,
+                        "rpc_method": binding.rpc_method,
+                        "endpoint": endpoint,
+                    }
+
+                elif isinstance(binding, (WsBindingSpec, WebTransportBindingSpec)):
                     bucket = route_data.setdefault(
                         binding.proto, {"exact": {}, "templated": []}
                     )
@@ -119,7 +141,9 @@ def _compile_plan(self: Any, app: Any) -> KernelPlan:
                                 "names": names,
                                 "meta_index": meta_index,
                                 "selector": selector,
-                                "subprotocols": tuple(binding.subprotocols or ()),
+                                "subprotocols": tuple(
+                                    getattr(binding, "subprotocols", ()) or ()
+                                ),
                             }
                         )
                     else:

{tigrbl_kernel-0.1.0.dev15 → tigrbl_kernel-0.1.11.dev1}/tigrbl_kernel/core.py

@@ -24,6 +24,7 @@ from .cache import _SpecsOnceCache, _WeakMaybeDict
 from .models import KernelPlan, OpView
 from .opview_compiler import compile_opview_from_specs
 from .types import DEFAULT_PHASE_ORDER as _DEFAULT_PHASE_ORDER
+from .rust_compile import build_rust_kernel as _build_rust_kernel
 from .utils import (
     _opspecs,
     _table_iter,
@@ -43,16 +44,17 @@ class Kernel:
             cls._instance = super().__new__(cls)
         return cls._instance
 
-    def __init__(self, atoms: Optional[Sequence[_DiscoveredAtom]] = None):
+    def __init__(self, atoms: Optional[Sequence[_DiscoveredAtom]] = None, backend: str = "python"):
         if atoms is None and getattr(self, "_singleton_initialized", False):
-            self._reset(atoms)
+            self._reset(atoms, backend=backend)
             return
-        self._reset(atoms)
+        self._reset(atoms, backend=backend)
         if atoms is None:
             self._singleton_initialized = True
 
-    def _reset(self, atoms: Optional[Sequence[_DiscoveredAtom]] = None) -> None:
+    def _reset(self, atoms: Optional[Sequence[_DiscoveredAtom]] = None, backend: str = "python") -> None:
         self._atoms_cache = list(atoms) if atoms else None
+        self.backend = backend
         self._specs_cache = _SpecsOnceCache()
         self._opviews = _WeakMaybeDict()
         self._phase_chains = _WeakMaybeDict()
@@ -153,6 +155,9 @@ class Kernel:
             return payload
         return {}
 
+    def compile_rust_plan(self, app: Any):
+        return _build_rust_kernel(app)
+
     def invalidate_kernelz_payload(self, app: Optional[Any] = None) -> None:
         with self._lock:
             if app is None:

{tigrbl_kernel-0.1.0.dev15 → tigrbl_kernel-0.1.11.dev1}/tigrbl_kernel/opview_compiler.py

@@ -5,6 +5,23 @@ from typing import Any, Dict, Mapping
 from .models import OpView, SchemaIn, SchemaOut
 
 
+def _storage_requires_input(storage: Any, alias: str) -> bool:
+    if storage is None or alias == "update":
+        return False
+    if bool(getattr(storage, "primary_key", False)):
+        if alias in {"replace", "delete"}:
+            return True
+        auto = getattr(storage, "autoincrement", False)
+        if auto not in (False, None) or getattr(storage, "identity", None) is not None:
+            return False
+    has_default = (
+        getattr(storage, "default", None) is not None
+        or getattr(storage, "server_default", None) is not None
+        or callable(getattr(storage, "default_factory", None))
+    )
+    return not bool(getattr(storage, "nullable", True)) and not has_default
+
+
 def compile_opview_from_specs(specs: Mapping[str, Any], sp: Any) -> OpView:
     """Build a basic OpView from collected specs when no app/model is present."""
     alias = getattr(sp, "alias", "")
@@ -38,7 +55,10 @@ def compile_opview_from_specs(specs: Mapping[str, Any], sp: Any) -> OpView:
                 meta["header_required_in"] = bool(
                     getattr(io, "header_required_in", False)
                 )
-            required = bool(fs and alias in getattr(fs, "required_in", ()))
+            required = bool(
+                (fs and alias in getattr(fs, "required_in", ()))
+                or _storage_requires_input(storage, alias)
+            )
             meta["required"] = required
             base_nullable = (
                 True if storage is None else getattr(storage, "nullable", True)

tigrbl_kernel-0.1.11.dev1/tigrbl_kernel/rust_compile.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+from importlib import import_module
+from typing import Any
+
+from .rust_plan import RustPlan
+
+
+def _runtime_rust_helpers():
+    rust = import_module("tigrbl_runtime.rust")
+    codec = import_module("tigrbl_runtime.rust.codec")
+    return (
+        rust.compile_app,
+        rust.rust_parity_snapshot,
+        rust.normalize_spec,
+        codec.build_rust_app_spec,
+    )
+
+
+def build_rust_kernel(app: Any) -> RustPlan:
+    compile_app, rust_parity_snapshot, normalize_spec, build_rust_app_spec = (
+        _runtime_rust_helpers()
+    )
+    payload = build_rust_app_spec(app)
+    normalized = normalize_spec(payload)
+    compiled = compile_app(payload)
+    return RustPlan(
+        description=f"compiled rust KernelPlan for {compiled.get('app_name', payload['name'])}",
+        compiled_plan=compiled,
+        backend="rust",
+        normalized_spec=normalized,
+        parity_snapshot=rust_parity_snapshot(payload),
+        claimable=False,
+    )
+
+
+def normalize_rust_spec(app: Any) -> str:
+    _, _, normalize_spec, build_rust_app_spec = _runtime_rust_helpers()
+    return normalize_spec(build_rust_app_spec(app))
+
+
+def build_rust_parity_snapshot(app: Any) -> dict[str, object]:
+    _, rust_parity_snapshot, _, build_rust_app_spec = _runtime_rust_helpers()
+    return rust_parity_snapshot(build_rust_app_spec(app))

tigrbl_kernel-0.1.11.dev1/tigrbl_kernel/rust_plan.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+
+@dataclass(slots=True)
+class RustPlan:
+    description: str
+    compiled_plan: dict[str, Any] | None = None
+    backend: str = "rust"
+    normalized_spec: str | None = None
+    parity_snapshot: dict[str, Any] | None = None
+    claimable: bool = False

{tigrbl_kernel-0.1.0.dev15 → tigrbl_kernel-0.1.11.dev1}/tigrbl_kernel/types.py

@@ -28,6 +28,18 @@ EFFECT_BY_ATOM_NAME = {
     "sys.handler_bulk_replace": EFFECT_DB_WRITE,
     "sys.handler_bulk_merge": EFFECT_DB_WRITE,
     "sys.handler_bulk_delete": EFFECT_DB_WRITE,
+    "sys.handler_count": EFFECT_DB_READ,
+    "sys.handler_exists": EFFECT_DB_READ,
+    "sys.handler_aggregate": EFFECT_DB_READ,
+    "sys.handler_group_by": EFFECT_DB_READ,
+    "sys.handler_publish": EFFECT_WIRE,
+    "sys.handler_subscribe": EFFECT_WIRE,
+    "sys.handler_tail": EFFECT_WIRE,
+    "sys.handler_upload": EFFECT_WIRE,
+    "sys.handler_download": EFFECT_WIRE,
+    "sys.handler_append_chunk": EFFECT_WIRE,
+    "sys.handler_send_datagram": EFFECT_WIRE,
+    "sys.handler_checkpoint": EFFECT_WIRE,
     "egress.to_transport_response": EFFECT_WIRE,
     "egress.asgi_send": EFFECT_WIRE,
 }

{tigrbl_kernel-0.1.0.dev15 → tigrbl_kernel-0.1.11.dev1}/tigrbl_kernel/utils.py

@@ -161,8 +161,8 @@ def _route_payload_template() -> dict[str, Any]:
     return {
         "http.rest": {"exact": {}, "templated": []},
         "https.rest": {"exact": {}, "templated": []},
-        "http.jsonrpc": {},
-        "https.jsonrpc": {},
+        "http.jsonrpc": {"endpoints": {}},
+        "https.jsonrpc": {"endpoints": {}},
         "ws": {"exact": {}, "templated": []},
         "wss": {"exact": {}, "templated": []},
     }

tigrbl_kernel-0.1.0.dev15/PKG-INFO

@@ -1,52 +0,0 @@
-Metadata-Version: 2.4
-Name: tigrbl-kernel
-Version: 0.1.0.dev15
-Summary: Kernel orchestration for Tigrbl runtime composition.
-License-Expression: Apache-2.0
-Keywords: tigrbl,sdk,standards,framework
-Author: Jacob Stewart
-Author-email: jacob@swarmauri.com
-Requires-Python: >=3.10,<3.13
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Development Status :: 1 - Planning
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Dist: tigrbl-atoms
-Requires-Dist: tigrbl-core
-Requires-Dist: tigrbl-typing
-Description-Content-Type: text/markdown
-
-![Tigrbl branding](https://github.com/swarmauri/swarmauri-sdk/blob/a170683ecda8ca1c4f912c966d4499649ffb8224/assets/tigrbl.brand.theme.svg)
-
-# tigrbl-kernel
-
-![PyPI - Downloads](https://img.shields.io/pypi/dm/tigrbl-kernel.svg) ![Hits](https://hits.sh/github.com/swarmauri/swarmauri-sdk.svg) ![Python Versions](https://img.shields.io/pypi/pyversions/tigrbl-kernel.svg) ![License](https://img.shields.io/pypi/l/tigrbl-kernel.svg) ![Version](https://img.shields.io/pypi/v/tigrbl-kernel.svg)
-
-## Features
-
-- Modular package in the Tigrbl namespace.
-- Supports Python 3.10 through 3.12.
-- Distributed as part of the swarmauri-sdk workspace.
-
-## Installation
-
-### uv
-
-```bash
-uv add tigrbl-kernel
-```
-
-### pip
-
-```bash
-pip install tigrbl-kernel
-```
-
-## Usage
-
-Import from the shared package-specific module namespaces after installation in your environment.
-

tigrbl_kernel-0.1.0.dev15/README.md

@@ -1,29 +0,0 @@
-![Tigrbl branding](https://github.com/swarmauri/swarmauri-sdk/blob/a170683ecda8ca1c4f912c966d4499649ffb8224/assets/tigrbl.brand.theme.svg)
-
-# tigrbl-kernel
-
-![PyPI - Downloads](https://img.shields.io/pypi/dm/tigrbl-kernel.svg) ![Hits](https://hits.sh/github.com/swarmauri/swarmauri-sdk.svg) ![Python Versions](https://img.shields.io/pypi/pyversions/tigrbl-kernel.svg) ![License](https://img.shields.io/pypi/l/tigrbl-kernel.svg) ![Version](https://img.shields.io/pypi/v/tigrbl-kernel.svg)
-
-## Features
-
-- Modular package in the Tigrbl namespace.
-- Supports Python 3.10 through 3.12.
-- Distributed as part of the swarmauri-sdk workspace.
-
-## Installation
-
-### uv
-
-```bash
-uv add tigrbl-kernel
-```
-
-### pip
-
-```bash
-pip install tigrbl-kernel
-```
-
-## Usage
-
-Import from the shared package-specific module namespaces after installation in your environment.

tigrbl_kernel-0.1.0.dev15/tigrbl_kernel/__init__.py

@@ -1,44 +0,0 @@
-from __future__ import annotations
-
-from typing import Any, Dict, List, Mapping
-
-from tigrbl_atoms import StepFn
-from .core import Kernel
-from .models import OpView, PackedKernel, SchemaIn, SchemaOut
-
-_default_kernel = Kernel()
-
-
-def get_cached_specs(model: type) -> Mapping[str, Any]:
-    return _default_kernel.get_specs(model)
-
-
-def build_phase_chains(model: type, alias: str) -> Dict[str, List[StepFn]]:
-    return _default_kernel._build_op(model, alias)
-
-
-def build_kernel_plan(app: Any):
-    return _default_kernel.kernel_plan(app)
-
-
-def build_packed_kernel(app: Any) -> PackedKernel | None:
-    return _default_kernel.kernel_plan(app).packed
-
-
-def plan_labels(model: type, alias: str) -> list[str]:
-    return _default_kernel.plan_labels(model, alias)
-
-
-__all__ = [
-    "Kernel",
-    "OpView",
-    "PackedKernel",
-    "SchemaIn",
-    "SchemaOut",
-    "build_kernel_plan",
-    "build_packed_kernel",
-    "get_cached_specs",
-    "_default_kernel",
-    "build_phase_chains",
-    "plan_labels",
-]