tigrbl-kernel 0.4.1.dev6__py3-none-any.whl → 0.4.2.dev4__py3-none-any.whl

tigrbl_kernel/_build.py

@@ -597,6 +597,11 @@ def _program_has_exact_http_like_no_input_binding(
 
 
 def _step_has_route_binding(step: StepFn) -> bool:
+    for candidate in (step, getattr(step, "__tigrbl_direct_run", None)):
+        endpoint = getattr(candidate, "__tigrbl_websocket_endpoint__", None)
+        path = getattr(candidate, "__tigrbl_websocket_path__", None)
+        if callable(endpoint) and isinstance(path, str) and path:
+            return True
     closure = getattr(step, "__closure__", None)
     if not closure:
         return False

tigrbl_kernel/contract_classification.py

@@ -0,0 +1,186 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from tigrbl_core._spec.binding_spec import normalize_exchange
+
+
+CONTRACT_CHANNELS: tuple[str, ...] = ("receive", "send")
+CONTRACT_SCOPE_TYPES: tuple[str, ...] = ("http", "websocket", "webtransport")
+CONTRACT_DIRECTIONS: tuple[str, ...] = (
+    "client_to_server",
+    "server_to_client",
+    "app_to_server",
+    "server_to_app",
+    "system",
+)
+CONTRACT_FAMILIES: tuple[str, ...] = (
+    "request",
+    "session",
+    "message",
+    "stream",
+    "datagram",
+)
+
+CONTRACT_BINDING_ALIASES: dict[str, tuple[str, ...]] = {
+    "rest": ("http.rest", "https.rest"),
+    "jsonrpc": ("http.jsonrpc", "https.jsonrpc"),
+    "http.stream": ("http.stream", "https.stream"),
+    "sse": ("http.sse", "https.sse"),
+    "websocket": ("ws", "wss"),
+    "webtransport": ("webtransport",),
+}
+
+CONTRACT_EXCHANGE_ALIASES: dict[str, str] = {
+    "unary": "request_response",
+    "duplex": "bidirectional_stream",
+    "client_stream": "client_stream",
+    "server_stream": "server_stream",
+    "fire_and_forget": "fire_and_forget",
+}
+
+CANONICAL_CONTRACT_EVENTS: tuple[str, ...] = (
+    "http.request",
+    "http.disconnect",
+    "http.response.start",
+    "http.response.body",
+    "http.response.pathsend",
+    "websocket.connect",
+    "websocket.receive",
+    "websocket.disconnect",
+    "websocket.accept",
+    "websocket.send",
+    "websocket.close",
+    "webtransport.connect",
+    "webtransport.accept",
+    "webtransport.stream.receive",
+    "webtransport.stream.send",
+    "webtransport.stream.close",
+    "webtransport.stream.reset",
+    "webtransport.stream.stop_sending",
+    "webtransport.datagram.receive",
+    "webtransport.datagram.send",
+    "webtransport.disconnect",
+    "webtransport.close",
+    "transport.emit.complete",
+    "transport.emit.failed",
+)
+
+_EVENT_SCOPE_PREFIXES: dict[str, str] = {
+    "http.": "http",
+    "websocket.": "websocket",
+    "webtransport.": "webtransport",
+    "transport.emit.": "webtransport",
+}
+
+
+@dataclass(frozen=True, slots=True)
+class ContractClassificationProjection:
+    event: str
+    channel: str
+    scope_type: str
+    binding: str
+    local_binding_kinds: tuple[str, ...]
+    family: str
+    contract_exchange: str
+    local_exchange: str
+    direction: str
+    allowed_framings: tuple[str, ...]
+    required_payload_fields: tuple[str, ...]
+
+
+def project_contract_classification(row: dict[str, Any]) -> ContractClassificationProjection:
+    if "subsurface" in row:
+        raise ValueError("contract classifications must not use subsurface")
+
+    event = _required_str(row, "event")
+    channel = _required_str(row, "channel")
+    scope_type = _required_str(row, "scope_type")
+    binding = _required_str(row, "binding")
+    family = _required_str(row, "family")
+    exchange = _required_str(row, "exchange")
+    direction = _required_str(row, "direction")
+
+    if event not in CANONICAL_CONTRACT_EVENTS:
+        raise ValueError(f"unsupported contract event {event!r}")
+    if channel not in CONTRACT_CHANNELS:
+        raise ValueError(f"unsupported contract channel {channel!r}")
+    if scope_type not in CONTRACT_SCOPE_TYPES:
+        raise ValueError(f"unsupported contract scope_type {scope_type!r}")
+    if not _event_matches_scope(event=event, scope_type=scope_type):
+        raise ValueError(f"contract event {event!r} does not match scope_type {scope_type!r}")
+    if family not in CONTRACT_FAMILIES:
+        raise ValueError(f"unsupported contract family {family!r}")
+    if direction not in CONTRACT_DIRECTIONS:
+        raise ValueError(f"unsupported contract direction {direction!r}")
+    if binding not in CONTRACT_BINDING_ALIASES:
+        raise ValueError(f"unsupported contract binding {binding!r}")
+    if scope_type == "webtransport" and family == "message":
+        raise ValueError("WebTransport message is not a native transport family")
+
+    try:
+        local_exchange = normalize_exchange(CONTRACT_EXCHANGE_ALIASES[exchange])
+    except KeyError as exc:
+        raise ValueError(f"unsupported contract exchange {exchange!r}") from exc
+
+    return ContractClassificationProjection(
+        event=event,
+        channel=channel,
+        scope_type=scope_type,
+        binding=binding,
+        local_binding_kinds=CONTRACT_BINDING_ALIASES[binding],
+        family=family,
+        contract_exchange=exchange,
+        local_exchange=local_exchange,
+        direction=direction,
+        allowed_framings=_string_tuple(row.get("allowed_framings", ())),
+        required_payload_fields=_string_tuple(row.get("required_payload_fields", ())),
+    )
+
+
+def is_supported_contract_classification(row: dict[str, Any]) -> bool:
+    try:
+        project_contract_classification(row)
+    except ValueError:
+        return False
+    return True
+
+
+def _required_str(row: dict[str, Any], key: str) -> str:
+    value = row.get(key)
+    if not isinstance(value, str) or not value:
+        raise ValueError(f"contract classification requires string {key!r}")
+    return value
+
+
+def _string_tuple(value: Any) -> tuple[str, ...]:
+    if value is None:
+        return ()
+    if not isinstance(value, (list, tuple)):
+        raise ValueError("contract classification list fields must be sequences")
+    result = tuple(str(item) for item in value)
+    if any(not item for item in result):
+        raise ValueError("contract classification list fields must not contain blanks")
+    return result
+
+
+def _event_matches_scope(*, event: str, scope_type: str) -> bool:
+    for prefix, expected_scope_type in _EVENT_SCOPE_PREFIXES.items():
+        if event.startswith(prefix):
+            return scope_type == expected_scope_type
+    return False
+
+
+__all__ = [
+    "CANONICAL_CONTRACT_EVENTS",
+    "CONTRACT_BINDING_ALIASES",
+    "CONTRACT_CHANNELS",
+    "CONTRACT_DIRECTIONS",
+    "CONTRACT_EXCHANGE_ALIASES",
+    "CONTRACT_FAMILIES",
+    "CONTRACT_SCOPE_TYPES",
+    "ContractClassificationProjection",
+    "is_supported_contract_classification",
+    "project_contract_classification",
+]

tigrbl_kernel/protocol_bindings.py

@@ -3,26 +3,43 @@ from __future__ import annotations
 from collections.abc import Mapping
 from typing import Any
 
+from tigrbl_core._spec.binding_spec import (
+    validate_app_framing_for_binding,
+    validate_binding_profile_exchange,
+    validate_webtransport_inner_framing,
+    validate_webtransport_lane_exchange,
+    webtransport_lane_for_profile,
+    webtransport_runtime_family,
+)
+
 
 def _unsupported(message: str) -> ValueError:
     return ValueError(f"binding protocol unsupported before runtime: {message}")
 
 
 def compile_binding_protocol_plan(op_id: str, binding: Mapping[str, Any]) -> dict[str, object]:
-    kind = binding.get("kind")
+    kind = binding.get("kind") or binding.get("proto")
     if not kind:
         raise ValueError(
             "BindingSpec binding source is required; transport guessing is ambiguous"
         )
 
     kind = str(kind)
+    profile = binding.get("profile")
+    if kind in {"http", "https"} and profile:
+        kind = f"{kind}.{profile}"
+    elif kind == "websocket":
+        kind = str(binding.get("proto") or "ws")
     framing = binding.get("framing")
     rows: tuple[dict[str, str], ...]
 
-    if kind == "http.rest":
-        if framing not in (None, "json"):
-            raise _unsupported("http.rest only supports json framing")
-        family = "response"
+    if kind in {"http.rest", "https.rest"}:
+        validate_binding_profile_exchange(
+            binding_kind=kind,
+            exchange=str(binding.get("exchange") or "request_response"),
+        )
+        validate_app_framing_for_binding(binding_kind=kind, framing=str(framing or "json"))
+        family = "request"
         framing = "json"
         anchors = (
             "ingress.receive",
@@ -31,13 +48,18 @@ def compile_binding_protocol_plan(op_id: str, binding: Mapping[str, Any]) -> dic
             "transport.emit_complete",
         )
         rows = (
-            {"family": "response", "subevent": "request.received"},
-            {"family": "response", "subevent": "response.emit"},
+            {"family": "request", "subevent": "request.received"},
+            {"family": "request", "subevent": "response.emit"},
         )
-    elif kind == "http.jsonrpc":
+    elif kind in {"http.jsonrpc", "https.jsonrpc"}:
         if not binding.get("rpc_method"):
             raise _unsupported("http.jsonrpc requires rpc_method")
-        family = "response"
+        validate_binding_profile_exchange(
+            binding_kind=kind,
+            exchange=str(binding.get("exchange") or "request_response"),
+        )
+        validate_app_framing_for_binding(binding_kind=kind, framing=str(framing or "jsonrpc"))
+        family = "request"
         framing = "jsonrpc"
         anchors = (
             "framing.decode",
@@ -46,18 +68,28 @@ def compile_binding_protocol_plan(op_id: str, binding: Mapping[str, Any]) -> dic
             "framing.encode",
         )
         rows = (
-            {"family": "response", "subevent": "request.received"},
-            {"family": "response", "subevent": "response.emit"},
+            {"family": "request", "subevent": "request.received"},
+            {"family": "request", "subevent": "response.emit"},
         )
-    elif kind == "http.stream":
+    elif kind in {"http.stream", "https.stream"}:
+        validate_binding_profile_exchange(
+            binding_kind=kind,
+            exchange=str(binding.get("exchange") or "server_stream"),
+        )
+        validate_app_framing_for_binding(binding_kind=kind, framing=str(framing or "stream"))
         family = "stream"
-        framing = "stream"
+        framing = str(framing or "stream")
         anchors = ("handler.invoke", "transport.emit", "transport.emit_complete")
         rows = (
             {"family": "stream", "subevent": "stream.chunk"},
             {"family": "stream", "subevent": "stream.close"},
         )
-    elif kind == "http.sse":
+    elif kind in {"http.sse", "https.sse"}:
+        validate_binding_profile_exchange(
+            binding_kind=kind,
+            exchange=str(binding.get("exchange") or "server_stream"),
+        )
+        validate_app_framing_for_binding(binding_kind=kind, framing=str(framing or "sse"))
         family = "stream"
         framing = "sse"
         anchors = (
@@ -67,15 +99,25 @@ def compile_binding_protocol_plan(op_id: str, binding: Mapping[str, Any]) -> dic
             "transport.emit_complete",
         )
         rows = (
-            {"family": "event_stream", "subevent": "message.encoded"},
-            {"family": "event_stream", "subevent": "message.emit"},
+            {"family": "stream", "subevent": "message.encoded"},
+            {"family": "stream", "subevent": "message.emit"},
             {"family": "stream", "subevent": "stream.close"},
         )
-    elif kind in {"ws", "websocket"}:
+    elif kind in {"ws", "wss", "websocket"}:
         if binding.get("methods"):
             raise _unsupported("websocket bindings do not accept HTTP methods")
         family = "message"
         framing = str(framing or "text")
+        subprotocols = tuple(str(item).lower() for item in binding.get("subprotocols", ()))
+        validate_binding_profile_exchange(
+            binding_kind="wss" if kind == "wss" else "ws",
+            exchange=str(binding.get("exchange") or "bidirectional_stream"),
+        )
+        validate_app_framing_for_binding(
+            binding_kind="wss" if kind == "wss" else "ws",
+            framing=framing,
+            subprotocols=subprotocols,
+        )
         anchors = (
             "transport.accept",
             "framing.decode",
@@ -91,32 +133,120 @@ def compile_binding_protocol_plan(op_id: str, binding: Mapping[str, Any]) -> dic
     elif kind == "webtransport":
         if binding.get("exchange") == "request_response":
             raise _unsupported("webtransport request_response exchange")
-        family = "session"
-        framing = "webtransport"
-        anchors = (
-            "transport.accept",
-            "dispatch.subevent.derive",
-            "handler.invoke",
-            "transport.close",
+        validate_app_framing_for_binding(binding_kind=kind, framing=str(framing or "webtransport"))
+        if framing and str(framing) != "webtransport":
+            raise _unsupported("webtransport outer framing must remain webtransport")
+        lane = webtransport_lane_for_profile(
+            binding.get("lane") or binding.get("profile") or "webtransport"
         )
-        rows = (
-            {"family": "session", "subevent": "session.open"},
-            {"family": "session", "subevent": "session.close"},
+        validate_webtransport_lane_exchange(
+            lane=lane,
+            exchange=str(binding.get("exchange") or {
+                "session": "bidirectional_stream",
+                "bidi_stream": "bidirectional_stream",
+                "unidi_client_stream": "client_stream",
+                "unidi_server_stream": "server_stream",
+                "datagram": "bidirectional_stream",
+            }[lane]),
+        )
+        inner_framing = validate_webtransport_inner_framing(
+            lane=lane,
+            inner_framing=binding.get("inner_framing"),
         )
+        family = webtransport_runtime_family(lane)
+        framing = "webtransport"
+        if lane == "session":
+            anchors = (
+                "transport.accept",
+                "dispatch.subevent.derive",
+                "handler.invoke",
+                "transport.close",
+            )
+            rows = (
+                {"family": "session", "subevent": "session.open"},
+                {"family": "session", "subevent": "session.close"},
+            )
+        elif lane == "bidi_stream":
+            anchors = (
+                "transport.accept",
+                "transport.receive",
+                "framing.decode",
+                "dispatch.subevent.derive",
+                "handler.invoke",
+                "framing.encode",
+                "transport.emit",
+                "transport.close",
+            )
+            rows = (
+                {"family": "stream", "subevent": "stream.open"},
+                {"family": "stream", "subevent": "stream.chunk.received"},
+                {"family": "stream", "subevent": "stream.chunk.emit"},
+                {"family": "stream", "subevent": "stream.close"},
+            )
+        elif lane == "unidi_client_stream":
+            anchors = (
+                "transport.accept",
+                "transport.receive",
+                "framing.decode",
+                "dispatch.subevent.derive",
+                "handler.invoke",
+                "transport.close",
+            )
+            rows = (
+                {"family": "stream", "subevent": "stream.open"},
+                {"family": "stream", "subevent": "stream.chunk.received"},
+                {"family": "stream", "subevent": "stream.close"},
+            )
+        elif lane == "unidi_server_stream":
+            anchors = (
+                "transport.accept",
+                "handler.invoke",
+                "framing.encode",
+                "transport.emit",
+                "transport.close",
+            )
+            rows = (
+                {"family": "stream", "subevent": "stream.open"},
+                {"family": "stream", "subevent": "stream.chunk.emit"},
+                {"family": "stream", "subevent": "stream.emit_complete"},
+                {"family": "stream", "subevent": "stream.close"},
+            )
+        elif lane == "datagram":
+            anchors = (
+                "transport.accept",
+                "transport.receive",
+                "framing.decode",
+                "dispatch.subevent.derive",
+                "handler.invoke",
+                "framing.encode",
+                "transport.emit",
+            )
+            rows = (
+                {"family": "datagram", "subevent": "datagram.received"},
+                {"family": "datagram", "subevent": "datagram.emit"},
+                {"family": "datagram", "subevent": "datagram.emit_complete"},
+            )
+        else:  # pragma: no cover - guarded by webtransport_lane_for_profile
+            raise _unsupported(f"webtransport lane {lane}")
     else:
         raise _unsupported(kind)
 
+    event_key_inputs = {
+        "family": family,
+        "binding": kind,
+        "framing": framing,
+    }
+    if kind == "webtransport":
+        event_key_inputs["lane"] = lane
+        event_key_inputs["inner_framing"] = inner_framing
+
     return {
         "op_id": op_id,
         "binding_kind": kind,
         "family": family,
         "framing": framing,
         "atom_anchors": anchors,
-        "event_key_inputs": {
-            "family": family,
-            "binding": kind,
-            "framing": framing,
-        },
+        "event_key_inputs": event_key_inputs,
         "capability_requirements": {
             "required_mask": _required_mask(kind=kind, family=family, framing=str(framing)),
         },

tigrbl_kernel/subevent_taxonomy.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 
 _FAMILIES = {
     "request": ("request.received", "request.body.received"),
-    "response": ("response.emit", "response.emit_complete"),
     "session": ("session.open", "session.ready", "session.close"),
     "message": ("message.received", "message.decoded", "message.emit", "message.emit_complete"),
     "stream": ("stream.open", "stream.chunk.received", "stream.chunk.emit", "stream.close"),
@@ -11,19 +10,29 @@ _FAMILIES = {
 }
 
 _BINDING_FAMILY = {
-    "http.rest": "response",
-    "http.jsonrpc": "response",
+    "http.rest": "request",
+    "https.rest": "request",
+    "http.jsonrpc": "request",
+    "https.jsonrpc": "request",
     "http.stream": "stream",
+    "https.stream": "stream",
     "http.sse": "stream",
+    "https.sse": "stream",
     "ws": "message",
+    "wss": "message",
     "websocket": "message",
+    "webtransport": "session",
+    "webtransport.session": "session",
+    "webtransport.bidi_stream": "stream",
+    "webtransport.unidi_client_stream": "stream",
+    "webtransport.unidi_server_stream": "stream",
     "webtransport.datagram": "datagram",
 }
 
 _ALIASES = {
     "receive": {"message": "message.received", "request": "request.received"},
-    "emit": {"response": "response.emit", "message": "message.emit", "datagram": "datagram.emit"},
-    "complete": {"response": "response.emit_complete", "message": "message.emit_complete", "datagram": "datagram.emit_complete"},
+    "emit": {"message": "message.emit", "stream": "stream.chunk.emit", "datagram": "datagram.emit"},
+    "complete": {"message": "message.emit_complete", "stream": "stream.close", "datagram": "datagram.emit_complete"},
 }
 
 

tigrbl_kernel/webtransport_events.py

@@ -1,6 +1,9 @@
 from __future__ import annotations
 
 from collections.abc import Sequence
+from typing import Any
+
+from tigrbl_core._spec.binding_spec import validate_webtransport_inner_framing
 
 
 def _event(subevent: str, atom: str, family: str) -> dict[str, str]:
@@ -23,6 +26,26 @@ def compile_webtransport_events(surface: str) -> list[dict[str, str]]:
             _event("stream.emit_complete", "transport.emit", "stream"),
             _event("stream.close", "transport.close", "stream"),
         ]
+    if surface == "bidi_stream":
+        return [
+            _event("stream.open", "transport.accept", "stream"),
+            _event("stream.chunk.received", "transport.receive", "stream"),
+            _event("stream.chunk.emit", "transport.emit", "stream"),
+            _event("stream.close", "transport.close", "stream"),
+        ]
+    if surface == "unidi_client_stream":
+        return [
+            _event("stream.open", "transport.accept", "stream"),
+            _event("stream.chunk.received", "transport.receive", "stream"),
+            _event("stream.close", "transport.close", "stream"),
+        ]
+    if surface == "unidi_server_stream":
+        return [
+            _event("stream.open", "transport.accept", "stream"),
+            _event("stream.chunk.emit", "transport.emit", "stream"),
+            _event("stream.emit_complete", "transport.emit", "stream"),
+            _event("stream.close", "transport.close", "stream"),
+        ]
     if surface == "datagram":
         return [
             _event("datagram.received", "transport.receive", "datagram"),
@@ -31,10 +54,12 @@ def compile_webtransport_events(surface: str) -> list[dict[str, str]]:
         ]
     if surface == "app_frame":
         return [
-            _event("app_frame.decode", "framing.decode", "message"),
-            _event("app_frame.emit", "transport.emit", "message"),
-            _event("app_frame.encode", "framing.encode", "message"),
+            _event("app_frame.decode", "framing.decode", "stream"),
+            _event("app_frame.emit", "transport.emit", "stream"),
+            _event("app_frame.encode", "framing.encode", "stream"),
         ]
+    if surface == "message":
+        raise ValueError("WebTransport does not expose message as a native surface")
     raise ValueError(f"unsupported WebTransport surface: {surface}")
 
 
@@ -48,4 +73,152 @@ def compile_webtransport_chain(*, include_stream: bool = True, include_datagram:
     return {"binding": "webtransport", "subevents": tuple(subevents)}
 
 
-__all__ = ["compile_webtransport_chain", "compile_webtransport_events"]
+def compile_webtransport_native_lanes() -> dict[str, tuple[str, ...]]:
+    return {
+        "session": tuple(event["subevent"] for event in compile_webtransport_events("session")),
+        "bidi_stream": tuple(event["subevent"] for event in compile_webtransport_events("bidi_stream")),
+        "unidi_client_stream": tuple(
+            event["subevent"] for event in compile_webtransport_events("unidi_client_stream")
+        ),
+        "unidi_server_stream": tuple(
+            event["subevent"] for event in compile_webtransport_events("unidi_server_stream")
+        ),
+        "datagram": tuple(event["subevent"] for event in compile_webtransport_events("datagram")),
+    }
+
+
+_STREAM_EVENTS = {
+    "webtransport.stream.receive",
+    "webtransport.stream.send",
+    "webtransport.stream.close",
+    "webtransport.stream.reset",
+    "webtransport.stream.stop_sending",
+}
+_DATAGRAM_EVENTS = {
+    "webtransport.datagram.receive",
+    "webtransport.datagram.send",
+}
+_SESSION_EVENTS = {
+    "webtransport.connect",
+    "webtransport.accept",
+    "webtransport.disconnect",
+    "webtransport.close",
+}
+_STREAM_DIRECTIONS = {
+    "bidi": "bidi_stream",
+    "client_to_server": "unidi_client_stream",
+    "server_to_client": "unidi_server_stream",
+}
+
+
+def validate_webtransport_event_payload(
+    *,
+    event: str,
+    channel: str,
+    payload: dict[str, Any],
+) -> dict[str, object]:
+    if not isinstance(payload, dict):
+        raise ValueError("WebTransport event payload must be a mapping")
+    if channel not in {"receive", "send"}:
+        raise ValueError("WebTransport event channel must be receive or send")
+    if event in _SESSION_EVENTS:
+        return _validate_session_payload(event=event, channel=channel, payload=payload)
+    if event in _STREAM_EVENTS:
+        return _validate_stream_payload(event=event, channel=channel, payload=payload)
+    if event in _DATAGRAM_EVENTS:
+        return _validate_datagram_payload(event=event, channel=channel, payload=payload)
+    if event.startswith("webtransport.message"):
+        raise ValueError("WebTransport message is not a native transport lane")
+    raise ValueError(f"unsupported WebTransport event {event!r}")
+
+
+def _validate_session_payload(
+    *,
+    event: str,
+    channel: str,
+    payload: dict[str, Any],
+) -> dict[str, object]:
+    expected_channel = "receive" if event in {"webtransport.connect", "webtransport.disconnect"} else "send"
+    if channel != expected_channel:
+        raise ValueError(f"{event} is only valid on {expected_channel}")
+    _forbid(payload, "stream_id", "stream_direction", "datagram_id", "framing")
+    return {"family": "session", "lane": "session", "exchange": "request_response"}
+
+
+def _validate_stream_payload(
+    *,
+    event: str,
+    channel: str,
+    payload: dict[str, Any],
+) -> dict[str, object]:
+    expected_channel = "receive" if event == "webtransport.stream.receive" else "send"
+    if channel != expected_channel:
+        raise ValueError(f"{event} is only valid on {expected_channel}")
+    _require(payload, "stream_id")
+    _forbid(payload, "datagram_id")
+    direction = payload.get("stream_direction")
+    if event in {
+        "webtransport.stream.receive",
+        "webtransport.stream.send",
+    }:
+        if not isinstance(direction, str) or direction not in _STREAM_DIRECTIONS:
+            raise ValueError("WebTransport stream payload requires valid stream_direction")
+    else:
+        direction = str(direction) if direction in _STREAM_DIRECTIONS else "bidi"
+    lane = _STREAM_DIRECTIONS[str(direction)]
+    if channel == "receive" and lane == "unidi_server_stream":
+        raise ValueError("server_to_client unidirectional streams cannot be receive events")
+    if channel == "send" and lane == "unidi_client_stream":
+        raise ValueError("client_to_server unidirectional streams cannot be send events")
+    validate_webtransport_inner_framing(
+        lane=lane,
+        inner_framing=payload.get("framing"),
+    )
+    return {
+        "family": "stream",
+        "lane": lane,
+        "exchange": {
+            "bidi_stream": "bidirectional_stream",
+            "unidi_client_stream": "client_stream",
+            "unidi_server_stream": "server_stream",
+        }[lane],
+    }
+
+
+def _validate_datagram_payload(
+    *,
+    event: str,
+    channel: str,
+    payload: dict[str, Any],
+) -> dict[str, object]:
+    expected_channel = "receive" if event == "webtransport.datagram.receive" else "send"
+    if channel != expected_channel:
+        raise ValueError(f"{event} is only valid on {expected_channel}")
+    _require(payload, "datagram_id")
+    _forbid(payload, "stream_id", "stream_direction")
+    validate_webtransport_inner_framing(
+        lane="datagram",
+        inner_framing=payload.get("framing"),
+    )
+    return {"family": "datagram", "lane": "datagram", "exchange": "bidirectional_stream"}
+
+
+def _require(payload: dict[str, Any], field: str) -> None:
+    value = payload.get(field)
+    if value is None or value == "":
+        raise ValueError(f"WebTransport payload requires {field}")
+
+
+def _forbid(payload: dict[str, Any], *fields: str) -> None:
+    present = [field for field in fields if field in payload and payload[field] is not None]
+    if present:
+        joined = ", ".join(present)
+        raise ValueError(f"WebTransport payload field not valid for event: {joined}")
+
+
+__all__ = [
+    "compile_webtransport_chain",
+    "compile_webtransport_events",
+    "compile_webtransport_native_lanes",
+    "validate_webtransport_event_payload",
+]

{tigrbl_kernel-0.4.1.dev6.dist-info → tigrbl_kernel-0.4.2.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-kernel
-Version: 0.4.1.dev6
+Version: 0.4.2.dev4
 Summary: Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
 License: Apache License
                                     Version 2.0, January 2004
@@ -204,6 +204,7 @@ License: Apache License
             See the License for the specific language governing permissions and
             limitations under the License.
 License-File: LICENSE
+License-File: NOTICE
 Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,kernel,orchestration,dispatch,openapi,openrpc,schema-first
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
@@ -234,129 +235,161 @@ Project-URL: Organization, https://github.com/tigrbl
 Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel
 Description-Content-Type: text/markdown
 
-![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
-
-<p align="center">
-    <a href="https://pepy.tech/project/tigrbl-kernel">
-        <img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Pepy downloads for tigrbl-kernel"/></a>
-    <a href="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel/">
-        <img src="https://hits.sh/github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel.svg" alt="Repository views for tigrbl-kernel"/></a>
-    <a href="https://pypi.org/project/tigrbl-kernel/">
-        <img src="https://img.shields.io/badge/python-3.10--3.14-blue" alt="Python 3.10 through 3.14"/></a>
-    <a href="https://pypi.org/project/tigrbl-kernel/">
-        <img src="https://img.shields.io/pypi/l/tigrbl-kernel" alt="PyPI license metadata for tigrbl-kernel"/></a>
-    <a href="https://pypi.org/project/tigrbl-kernel/">
-        <img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=tigrbl-kernel&color=green" alt="PyPI version for tigrbl-kernel"/></a>
-</p>
-
----
-
-<h1 align="center">Tigrbl kernel</h1>
-
-**Install and inspect `tigrbl-kernel`: [download `tigrbl-kernel` from PyPI](https://pypi.org/project/tigrbl-kernel/) or [open the package source](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel).**
-
-tigrbl-kernel is a kernel orchestration package for kernel orchestration for composing Tigrbl runtime plans, bindings, and operation dispatch.
-
-`tigrbl-kernel` is part of the Tigrbl package graph. It documents package-resident classes, concepts, extension points, and execution responsibilities while cross-linking to the facade, core specs, canonical mapping, runtime phases, concrete objects, operation packages, engine plugins, OpenAPI/OpenRPC documentation surfaces, and PyPI distributions that complete the system.
-
-## Package ownership
-
-- `tigrbl-kernel` documents the concepts implemented in `pkgs/core/tigrbl_kernel` and links to the Tigrbl packages that provide neighboring authoring, canon, runtime, operation, and engine behavior.
-- Use this README as the package-local explanation for the objects that live here; use governed docs for release state, certification, and evidence.
-
-## Package ecosystem cross-links
-
-Every Tigrbl Python package links to its sibling distributions on PyPI so package indexes, search engines, answer engines, dependency scanners, and human readers can move through the installable package graph without falling back to source-tree paths.
-
-Core packages:
-- [`tigrbl`](https://pypi.org/project/tigrbl/) - Schema-first ASGI API framework for REST, JSON-RPC, OpenAPI, OpenRPC, SQLAlchemy models, typed validation, lifecycle hooks, and engine plugins.
-- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/) - Runtime atom utilities for Tigrbl planning, dispatch, transport ingress, egress, and high-throughput ASGI execution pipelines.
-- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/) - Abstract base interfaces for Tigrbl APIs, engines, providers, sessions, transports, and reusable runtime components.
-- [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) - Canonical mapping, routing, symbol resolution, and naming utilities for Tigrbl framework packages and generated API surfaces.
-- [`tigrbl_client`](https://pypi.org/project/tigrbl_client/) - Typed Python client helpers for calling Tigrbl REST, JSON-RPC, OpenAPI, and generated schema-first API surfaces.
-- [`tigrbl-concrete`](https://pypi.org/project/tigrbl-concrete/) - Concrete Tigrbl implementations for reusable framework behavior, sessions, routes, responses, and base abstraction adapters.
-- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/) - Core Tigrbl framework specifications, decorators, schemas, hooks, operations, and primitives for schema-first APIs.
-- [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) (this package) - Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
-- [`tigrbl-ops-olap`](https://pypi.org/project/tigrbl-ops-olap/) - Analytical OLAP operation boundaries for Tigrbl workloads, query-oriented APIs, and engine integrations.
-- [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/) - Transactional OLTP operation handlers for Tigrbl CRUD, bulk, REST, JSON-RPC, and database-backed workloads.
-- [`tigrbl-ops-realtime`](https://pypi.org/project/tigrbl-ops-realtime/) - Realtime, streaming, datagram, websocket, and event operation handlers for Tigrbl ASGI runtimes.
-- [`tigrbl-orm`](https://pypi.org/project/tigrbl-orm/) - SQLAlchemy ORM tables, mixins, columns, model helpers, and persistence primitives for Tigrbl applications.
-- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) - Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
-- [`tigrbl_spec`](https://pypi.org/project/tigrbl_spec/) - Shared Tigrbl interfaces, protocol definitions, compatibility targets, and specification artifacts for framework integration.
-- [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) - Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
-- [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/) - Typing protocols, aliases, generics, and shared type helpers for Tigrbl framework packages and extensions.
-
-Engine packages:
-- [`tigrbl_engine_bigquery`](https://pypi.org/project/tigrbl_engine_bigquery/) - BigQuery engine plugin for Google BigQuery warehouse sessions, analytics workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_clickhouse`](https://pypi.org/project/tigrbl_engine_clickhouse/) - ClickHouse engine plugin for analytical database sessions, warehouse workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_csv`](https://pypi.org/project/tigrbl_engine_csv/) - CSV engine plugin for file-backed tables, pandas DataFrames, and lightweight Tigrbl data workflows.
-- [`tigrbl_engine_dataframe`](https://pypi.org/project/tigrbl_engine_dataframe/) - DataFrame engine plugin for transactional pandas sessions and in-process Tigrbl analytics workloads.
-- [`tigrbl_engine_duckdb`](https://pypi.org/project/tigrbl_engine_duckdb/) - DuckDB engine plugin for embedded analytical database sessions, OLAP workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_inmemcache`](https://pypi.org/project/tigrbl_engine_inmemcache/) - In-memory cache engine plugin for process-local TTL, LRU, and fast Tigrbl cache workflows.
-- [`tigrbl_engine_inmemory`](https://pypi.org/project/tigrbl_engine_inmemory/) - In-memory database engine plugin for process-local transactional storage, copy-on-write snapshots, and Tigrbl testing.
-- [`tigrbl_engine_membloom`](https://pypi.org/project/tigrbl_engine_membloom/) - In-memory Bloom filter engine plugin for membership checks, rotating TTL windows, and Tigrbl API workflows.
-- [`tigrbl_engine_memdedupe`](https://pypi.org/project/tigrbl_engine_memdedupe/) - In-memory dedupe engine plugin for idempotency tracking, duplicate suppression, and Tigrbl workflow coordination.
-- [`tigrbl_engine_memkv`](https://pypi.org/project/tigrbl_engine_memkv/) - In-memory key-value engine plugin for process-local KV storage, cache workflows, and lightweight Tigrbl services.
-- [`tigrbl_engine_memlru`](https://pypi.org/project/tigrbl_engine_memlru/) - In-memory LRU engine plugin for least-recently-used cache behavior and process-local Tigrbl data workflows.
-- [`tigrbl_engine_mempubsub`](https://pypi.org/project/tigrbl_engine_mempubsub/) - In-memory pub/sub engine plugin for process-local publish-subscribe channels, events, and Tigrbl realtime workflows.
-- [`tigrbl_engine_memqueue`](https://pypi.org/project/tigrbl_engine_memqueue/) - In-memory queue engine plugin for process-local tasks, message workflows, and Tigrbl runtime coordination.
-- [`tigrbl_engine_memrate`](https://pypi.org/project/tigrbl_engine_memrate/) - In-memory rate-limit engine plugin for API quotas, counters, windows, and Tigrbl governance workflows.
-- [`tigrbl_engine_numpy`](https://pypi.org/project/tigrbl_engine_numpy/) - NumPy engine plugin for array-to-table helpers, analytical workflows, and Tigrbl data integration.
-- [`tigrbl_engine_pandas`](https://pypi.org/project/tigrbl_engine_pandas/) - Pandas engine plugin for transactional DataFrame sessions, tabular workflows, and Tigrbl data integration.
-- [`tigrbl_engine_pgsqli_wal`](https://pypi.org/project/tigrbl_engine_pgsqli_wal/) - PostgreSQL and SQLite WAL engine plugin for transactional Tigrbl workflows and database-backed engine registration.
-- [`tigrbl_engine_postgres`](https://pypi.org/project/tigrbl_engine_postgres/) - PostgreSQL engine plugin for SQLAlchemy sessions, async database workflows, and Tigrbl application persistence.
-- [`tigrbl_engine_pyspark`](https://pypi.org/project/tigrbl_engine_pyspark/) - PySpark engine plugin for distributed DataFrame integration, analytics workloads, and Tigrbl data workflows.
-- [`tigrbl_engine_redis`](https://pypi.org/project/tigrbl_engine_redis/) - Redis engine plugin for cache, data structures, and Tigrbl engine workflows backed by Redis.
-- [`tigrbl_engine_rediscachethrough`](https://pypi.org/project/tigrbl_engine_rediscachethrough/) - Redis cache-through engine plugin for Redis, PostgreSQL, and Tigrbl data-access acceleration workflows.
-- [`tigrbl_engine_snowflake`](https://pypi.org/project/tigrbl_engine_snowflake/) - Snowflake engine plugin for warehouse sessions, analytical workloads, and Tigrbl engine registration.
-- [`tigrbl_engine_sqlite`](https://pypi.org/project/tigrbl_engine_sqlite/) - SQLite engine plugin for SQLAlchemy sessions, local transactional storage, and Tigrbl application persistence.
-- [`tigrbl_engine_xlsx`](https://pypi.org/project/tigrbl_engine_xlsx/) - XLSX engine plugin for Excel workbook-backed tables, worksheet data access, and Tigrbl tabular workflows.
-
-Application packages:
-- [`tigrbl_acme_ca`](https://pypi.org/project/tigrbl_acme_ca/) - ACME v2 certificate authority app for Tigrbl tables, certificate automation, TLS workflows, and API surfaces.
-- [`tigrbl_spiffe`](https://pypi.org/project/tigrbl_spiffe/) - SPIFFE and SPIRE identity app for Tigrbl with workload identity tables, UDS transport, and HTTP API surfaces.
-
-Source-tree links remain available from each package identity section; this ecosystem section is intentionally PyPI-first for package discovery and installation routing.
+<div align="center">
+<h1>tigrbl-kernel</h1>
+<img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
+<p><strong>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
+<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
+<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></a>
+<a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-kernel"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel README"/></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
+<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-kernel"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-kernel"/></a>
+</div>
+
+## What is tigrbl-kernel?
+
+Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
+
+## Why use tigrbl-kernel?
+
+Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
+
+## When should I install tigrbl-kernel?
+
+Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
+
+## Who is tigrbl-kernel for?
+
+Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
+
+## Where does tigrbl-kernel fit?
+
+`tigrbl-kernel` lives at `pkgs/core/tigrbl_kernel` and serves a focused layer in the split Tigrbl framework.
+
+## How does tigrbl-kernel work?
+
+It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
+
+## Certification Status
+
+- Package status: governed package in the `tigrbl/tigrbl` workspace.
+- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
+- Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
+- Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
+- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
 
 ## Install
 
+```bash
+uv add tigrbl-kernel
+```
+
 ```bash
 pip install tigrbl-kernel
 ```
 
-## Package discovery
+## Surface Coverage
+
+| Surface | Value |
+|---|---|
+| PyPI package | [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) |
+| Repository path | [`pkgs/core/tigrbl_kernel`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel) |
+| Python import root | `tigrbl_kernel` |
+| Console scripts | none declared |
+| Entry points | none declared |
+| Optional extras | none declared |
+| Legal files | `LICENSE`, `NOTICE` |
+| Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
+
+## What It Owns
+
+`tigrbl-kernel` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
+
+Implementation orientation:
+- `tigrbl_kernel`: _build, _compile, atoms, cache, callbacks, contract_classification, core, eventkey, eventkey_hooks, events, helpers, hook_types
+
+## Public API and Import Surface
+
+- Import roots: `tigrbl_kernel`.
+- Public symbols: `BatchOpPlan`, `ExecutionBackend`, `Kernel`, `OpView`, `PackedKernel`, `RustBackendConfig`, `RustPlan`, `SchemaIn`, `SchemaOut`, `build_kernel_plan`, `build_packed_kernel`, `build_packed_kernel_measurement_view`.
+- Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
+- External runtime dependencies: none declared.
+
+## Usage Examples
+
+### Verify the installed package
+
+```bash
+python -m pip show tigrbl-kernel
+python - <<'PY'
+from importlib.metadata import version
+print(version("tigrbl-kernel"))
+PY
+```
+
+### Import the package boundary
+
+```python
+import importlib
+
+module = importlib.import_module("tigrbl_kernel")
+print(module.__name__)
+```
+
+### Import a public symbol
+
+```python
+from tigrbl_kernel import BatchOpPlan
+
+print(BatchOpPlan)
+```
+
+### Use with the facade when building applications
+
+```bash
+uv add tigrbl tigrbl-kernel
+python - <<'PY'
+import tigrbl
+print(tigrbl.__name__)
+PY
+```
+
+## How To Choose This Package
+
+Choose `tigrbl-kernel` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
 
-`tigrbl-kernel` is described for package indexes, search engines, answer engines, and AI coding tools as: Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
+## Related Packages
 
-Use `tigrbl-kernel` when you need Tigrbl's schema-first ASGI package graph for REST APIs, JSON-RPC APIs, OpenAPI documentation, OpenRPC documentation, SQLAlchemy-backed models, Pydantic validation, typed operation specs, runtime dispatch, and installable engine or application extensions.
+- [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
+- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
+- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl`](https://pypi.org/project/tigrbl/)
+- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
+- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
 
-Discovery terms: tigrbl, ASGI, schema-first API framework, REST API, JSON-RPC API, OpenAPI documentation, OpenRPC documentation, SQLAlchemy models, Pydantic validation, typed validation, operation dispatch, engine plugins, api, json-rpc, rest, sqlalchemy, pydantic, kernel, orchestration, dispatch, openapi, openrpc, schema-first.
+## Documentation Links
 
-## Package-local entry point
+- [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
+- [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
+- [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
+- [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
+- [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
+- [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
+- [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
 
-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.
+## Support
 
-## Canonical repository docs
+- Community: [Discord](https://discord.gg/K4YTAPapjR).
+- Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
+- Repository: [pkgs/core/tigrbl_kernel](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel).
 
-- `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-local Boundary
 
-## Package identity
+This README is the package-local distribution entry point for `tigrbl-kernel`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
 
-- canonical repository: `https://github.com/tigrbl/tigrbl`
-- organization: `https://github.com/tigrbl`
-- social: `https://discord.gg/K4YTAPapjR`
-- package path: `https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel`
-- workspace path: `pkgs/core/tigrbl_kernel`
-- workspace class: core Python package
-- implementation layout: `tigrbl_kernel/`
+## License
 
-Long-form repository documentation is governed from `docs/`.
+Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
 

{tigrbl_kernel-0.4.1.dev6.dist-info → tigrbl_kernel-0.4.2.dev4.dist-info}/RECORD

@@ -1,9 +1,10 @@
 tigrbl_kernel/__init__.py,sha256=9hH7UWbqXuR5F0o0doSOjwLiy6KCHB6qZr5sS_O6Kr0,2813
-tigrbl_kernel/_build.py,sha256=QDzkFIknjj2J7wdq1EZ3D3lg3OO2IzYaa84Dc78mPW0,50060
+tigrbl_kernel/_build.py,sha256=xLaLHsVWSeY3mefyCEnGYEGzHlyMU_1SGgyr7T6hUeY,50369
 tigrbl_kernel/_compile.py,sha256=hQ3UscZ_zrCodWZfTe7mZ7I3MBMJzIxqF1SZLycRL9A,7771
 tigrbl_kernel/atoms.py,sha256=ZNGj2PBUMu1BvPjNYlz4_vu4vhx4gD20C7zNE_GKfe8,12253
 tigrbl_kernel/cache.py,sha256=NxuqvH03xYwcQoY86ie1hmtDeA36XdiLmNyx2ImLQ6k,2596
 tigrbl_kernel/callbacks.py,sha256=r_ZI19nbAoDM-uf-FMUmWWAF9WaEKJK3Fpg-58ui8a4,772
+tigrbl_kernel/contract_classification.py,sha256=5ZbhtJr88VtIPAtPWD5eL4BKKQU734kZeMEvEqh9cvU,6009
 tigrbl_kernel/core.py,sha256=3lR3VrlHOFiP-POLluEpBKWeGDdaqX8tJYHQ0eRluP0,6667
 tigrbl_kernel/eventkey.py,sha256=aTwzBkAjeC-kaEUItL1Mcfcq_Ur1fUbZDY6XxKdwWdg,1980
 tigrbl_kernel/eventkey_hooks.py,sha256=Cbkev0GXgSH27dlFoVeaKC7XuQ9yJq4bI1Mlc3qB4Qs,2480
@@ -20,7 +21,7 @@ tigrbl_kernel/opchannel_capabilities.py,sha256=5zM9-1fc-W8BXyXF4VVWrIsmdwCH5xLra
 tigrbl_kernel/opview_compiler.py,sha256=DbZ3E0GYl_JEgExELjaNE7v2W4hl9LqvAB-CE5TwP7o,5370
 tigrbl_kernel/ordering.py,sha256=92elylml2LPDYiSnjj4QHNM3OR9utxN3Al9g-UJsyJ0,13542
 tigrbl_kernel/payload.py,sha256=eyHo-cAUXLWQQ9-xZVOl_rjFudA-djMZji9hoK-v9IE,2167
-tigrbl_kernel/protocol_bindings.py,sha256=A95wOqq4xrtJsZrM2TGhbDGJ2aLs23WVUmPq4V-x7iM,4381
+tigrbl_kernel/protocol_bindings.py,sha256=u3XcmqyX3MJqyUUkUgKSBEMvM8hXCwwP_eT-n_GqfEQ,9985
 tigrbl_kernel/protocol_chains/__init__.py,sha256=iSnOw5R4ahGypm59bQgPpsBwFXbPcnKPozjSfc9N6GQ,151
 tigrbl_kernel/protocol_chains/http_stream.py,sha256=5dY86DBJzcGcmrvOuDJo8M0cjLdeSmNAa_fo9zHuBdE,1123
 tigrbl_kernel/protocol_chains/http_unary.py,sha256=7EABv0bUAJ5UI3TWP-S-8LtgwZJLj5pw-ZnZ_8qiD4g,1776
@@ -37,15 +38,16 @@ tigrbl_kernel/rust_plan.py,sha256=p4A46oOVtqamGJS_x_RGsGJo6IN81LKa1_KmGstyxoM,34
 tigrbl_kernel/rust_spec.py,sha256=ICfIenmocRucLunvSvS91L0vli6YSMBGWnWSGN-9ppE,14668
 tigrbl_kernel/segment_fusion.py,sha256=zbPNGd1eFJGFZHJxrfanaNMyrJjJw1aPRsl_jJfN4sM,1607
 tigrbl_kernel/subevent_handlers.py,sha256=4j4780QjQiqY4qpRsyxrPh_znRK3SkLAFDN_x6eidwU,1779
-tigrbl_kernel/subevent_taxonomy.py,sha256=6lhJV6lxEoYuUMT4Ysmv_9kHSRaE9P32GTP2Cxc5Yt8,1995
+tigrbl_kernel/subevent_taxonomy.py,sha256=67RJ7ZkfJMLfa7evzVfTlFqtdWSnhp65zwA4qhNwSG8,2274
 tigrbl_kernel/trace.py,sha256=dWILtq9seOj-WwCx__Pk_VZAbFIN1tqTbs0gIndYkU8,9816
 tigrbl_kernel/transaction_units.py,sha256=_NeQHycjjDoLG1kmD74o10wDQpdA5qjs-Sd_fxPb0_E,863
 tigrbl_kernel/transport_atoms.py,sha256=enfNCMuLgLMKi8zraMm-QOk7ys5d9kcP-WPr0-wK6KE,2136
 tigrbl_kernel/transport_events.py,sha256=qogvEAAPPX_Y6V5evGuqvFCpIePYK4ryLmCDT9JHkFM,3777
 tigrbl_kernel/types.py,sha256=BM_uPtF17MSI-q2ya93BWheAlPxOu-NaflwmxuicutA,2198
 tigrbl_kernel/utils.py,sha256=iCcm0flQfAi4w4cbVEaq6yiPR-kAoXx2owiRpbBf-0o,6953
-tigrbl_kernel/webtransport_events.py,sha256=cGBZAyy2PuYDV9H2nuM2bulJ3cojz6SEqL5cJK8mhTg,2267
-tigrbl_kernel-0.4.1.dev6.dist-info/METADATA,sha256=iPQyb71FrRoGpjKmCFaAiljeOC28uz9_mBwHEZegbPQ,27163
-tigrbl_kernel-0.4.1.dev6.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
-tigrbl_kernel-0.4.1.dev6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-tigrbl_kernel-0.4.1.dev6.dist-info/RECORD,,
+tigrbl_kernel/webtransport_events.py,sha256=MqWpnB4QvCbGgV8Sk-247EugbsXrfmDeY5YzLv84URo,8858
+tigrbl_kernel-0.4.2.dev4.dist-info/METADATA,sha256=F2HrzGzOLA71P21WZmWg3oKEiaM1UNZ4ea8GLLxdSd8,22464
+tigrbl_kernel-0.4.2.dev4.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+tigrbl_kernel-0.4.2.dev4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+tigrbl_kernel-0.4.2.dev4.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
+tigrbl_kernel-0.4.2.dev4.dist-info/RECORD,,

{tigrbl_kernel-0.4.1.dev6.dist-info → tigrbl_kernel-0.4.2.dev4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.4.0
+Generator: poetry-core 2.4.1
 Root-Is-Purelib: true
 Tag: py3-none-any

tigrbl_kernel-0.4.2.dev4.dist-info/licenses/NOTICE

@@ -0,0 +1,7 @@
+Tigrbl
+Copyright 2026 Swarmauri
+
+This product includes software developed by Swarmauri.
+
+Tigrbl is licensed under the Apache License, Version 2.0.
+See the LICENSE file distributed with this work for the full license text.