tigrbl-runtime 0.4.5.dev1__tar.gz → 0.4.5.dev6__tar.gz

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: tigrbl-runtime
-Version: 0.4.5.dev1
-Summary: Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
+Version: 0.4.5.dev6
+Summary: Execution bridge for compiled Tigrbl kernel plans and narrow runtime context/carrier compatibility.
 License: Apache License
                                     Version 2.0, January 2004
                                  http://www.apache.org/licenses/
@@ -205,7 +205,7 @@ License: Apache License
             limitations under the License.
 License-File: LICENSE
 License-File: NOTICE
-Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,runtime,pipeline,bridge,openapi,openrpc,schema-first
+Keywords: tigrbl,asgi,api,sqlalchemy,pydantic,runtime,pipeline,bridge,schema-first
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
 Requires-Python: >=3.10,<3.15
@@ -235,17 +235,17 @@ Project-URL: Discord, https://discord.gg/K4YTAPapjR
 Project-URL: Homepage, https://github.com/tigrbl/tigrbl
 Project-URL: Issues, https://github.com/tigrbl/tigrbl/issues
 Project-URL: Organization, https://github.com/tigrbl
-Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime
+Project-URL: Repository, https://github.com/tigrbl/tigrbl/tree/master/pkgs/50_runtime/tigrbl_runtime
 Description-Content-Type: text/markdown
 
 <div align="center">
 <h1>tigrbl-runtime</h1>
 <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
-<p><strong>Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.</strong></p>
+<p><strong>Execution bridge for compiled Tigrbl kernel plans and narrow runtime context/carrier compatibility.</strong></p>
 <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://img.shields.io/pypi/v/tigrbl-runtime?label=PyPI" alt="PyPI version for tigrbl-runtime"/></a>
 <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://static.pepy.tech/badge/tigrbl-runtime" alt="Downloads for tigrbl-runtime"/></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-runtime"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/50_runtime/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/50_runtime/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime 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-runtime"/></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-runtime"/></a>
@@ -253,7 +253,7 @@ Description-Content-Type: text/markdown
 
 ## What is tigrbl-runtime?
 
-Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
+`tigrbl-runtime` executes compiled Tigrbl kernel plans and preserves the narrow runtime context/carrier bridge needed to run those plans. Route selection, protocol fallback policy, response shaping, transport envelopes, and operation semantics are owned by kernel, atoms, and ops packages.
 
 ## Why use tigrbl-runtime?
 
@@ -269,7 +269,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-runtime fit?
 
-`tigrbl-runtime` lives at `pkgs/core/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-runtime` lives at `pkgs/50_runtime/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-runtime work?
 
@@ -291,7 +291,7 @@ pip install tigrbl-runtime
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) |
-| Repository path | [`pkgs/core/tigrbl_runtime`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime) |
+| Repository path | [`pkgs/50_runtime/tigrbl_runtime`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/50_runtime/tigrbl_runtime) |
 | Python import root | `tigrbl_runtime` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -301,17 +301,18 @@ pip install tigrbl-runtime
 
 ## What It Owns
 
-`tigrbl-runtime` 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.
+`tigrbl-runtime` owns the compiled-plan execution boundary. It should be installed when you need the narrow bridge that runs already-planned Tigrbl work without assuming the full facade is present.
 
 Implementation orientation:
-- `tigrbl_runtime`: callbacks, channel/, config/, executors/, protocol/, runtime/, transactions, webhooks
+- `tigrbl_runtime`: compiled plan execution, runtime context compatibility, and declared carrier lifecycle bridges
 
 Runtime authoring BCP:
-- Do use this package for runtime-owned routing, request execution, transport-unit execution, framing atoms, transport channels, transaction helpers, and kernel integration.
-- Do keep handler invocation, transaction progression, error handling, and transport emission aligned with compiled plans.
+- Do use this package for executing compiled kernel plans and maintaining runtime context/carrier compatibility.
+- Do keep execution aligned with compiled plans.
+- Do not add route matching semantics, protocol fallback policy, JSON-RPC/REST envelope policy, response rendering, chunk emission semantics, operation behavior, or new executor families.
 - Do not make application route handlers, FastAPI/Starlette objects, direct SQLAlchemy session calls, or ad-hoc engine construction the runtime contract.
 - Do not bypass kernel plans or lifecycle phases when adding REST, JSON-RPC, stream, SSE, WebSocket, or WebTransport behavior.
-- Avoid hiding behavior in transport wrappers that diagnostics and compiled plans cannot inspect.
+- Avoid hiding behavior in runtime wrappers that diagnostics and compiled plans cannot inspect.
 
 ## Public API and Import Surface
 
@@ -386,7 +387,7 @@ Choose `tigrbl-runtime` when the quick-answer table matches your use case. Choos
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_runtime](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime).
+- Repository: [pkgs/50_runtime/tigrbl_runtime](https://github.com/tigrbl/tigrbl/tree/master/pkgs/50_runtime/tigrbl_runtime).
 
 ## Package-local Boundary
 
@@ -397,10 +398,14 @@ This README is the package-local distribution entry point for `tigrbl-runtime`.
 - 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`.
+- Local certification guard: `pkgs/97_tests/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.
 
 ## License
 
 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).
 
+## Lowering integration
+
+`lowering_services` lazily exposes canonical kernel operation-view compilation and WebSocket JSON-RPC session construction to concrete integration code. It preserves the kernel function objects and keeps kernel imports out of concrete authoring modules.
+

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/README.md

@@ -1,11 +1,11 @@
 <div align="center">
 <h1>tigrbl-runtime</h1>
 <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
-<p><strong>Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.</strong></p>
+<p><strong>Execution bridge for compiled Tigrbl kernel plans and narrow runtime context/carrier compatibility.</strong></p>
 <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://img.shields.io/pypi/v/tigrbl-runtime?label=PyPI" alt="PyPI version for tigrbl-runtime"/></a>
 <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://static.pepy.tech/badge/tigrbl-runtime" alt="Downloads for tigrbl-runtime"/></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-runtime"/></a>
-<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime README"/></a>
+<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/50_runtime/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/50_runtime/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime 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-runtime"/></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-runtime"/></a>
@@ -13,7 +13,7 @@
 
 ## What is tigrbl-runtime?
 
-Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
+`tigrbl-runtime` executes compiled Tigrbl kernel plans and preserves the narrow runtime context/carrier bridge needed to run those plans. Route selection, protocol fallback policy, response shaping, transport envelopes, and operation semantics are owned by kernel, atoms, and ops packages.
 
 ## Why use tigrbl-runtime?
 
@@ -29,7 +29,7 @@ Framework maintainers, extension authors, and advanced users composing Tigrbl fr
 
 ## Where does tigrbl-runtime fit?
 
-`tigrbl-runtime` lives at `pkgs/core/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
+`tigrbl-runtime` lives at `pkgs/50_runtime/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
 
 ## How does tigrbl-runtime work?
 
@@ -51,7 +51,7 @@ pip install tigrbl-runtime
 | Surface | Value |
 |---|---|
 | PyPI package | [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) |
-| Repository path | [`pkgs/core/tigrbl_runtime`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime) |
+| Repository path | [`pkgs/50_runtime/tigrbl_runtime`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/50_runtime/tigrbl_runtime) |
 | Python import root | `tigrbl_runtime` |
 | Console scripts | none declared |
 | Entry points | none declared |
@@ -61,17 +61,18 @@ pip install tigrbl-runtime
 
 ## What It Owns
 
-`tigrbl-runtime` 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.
+`tigrbl-runtime` owns the compiled-plan execution boundary. It should be installed when you need the narrow bridge that runs already-planned Tigrbl work without assuming the full facade is present.
 
 Implementation orientation:
-- `tigrbl_runtime`: callbacks, channel/, config/, executors/, protocol/, runtime/, transactions, webhooks
+- `tigrbl_runtime`: compiled plan execution, runtime context compatibility, and declared carrier lifecycle bridges
 
 Runtime authoring BCP:
-- Do use this package for runtime-owned routing, request execution, transport-unit execution, framing atoms, transport channels, transaction helpers, and kernel integration.
-- Do keep handler invocation, transaction progression, error handling, and transport emission aligned with compiled plans.
+- Do use this package for executing compiled kernel plans and maintaining runtime context/carrier compatibility.
+- Do keep execution aligned with compiled plans.
+- Do not add route matching semantics, protocol fallback policy, JSON-RPC/REST envelope policy, response rendering, chunk emission semantics, operation behavior, or new executor families.
 - Do not make application route handlers, FastAPI/Starlette objects, direct SQLAlchemy session calls, or ad-hoc engine construction the runtime contract.
 - Do not bypass kernel plans or lifecycle phases when adding REST, JSON-RPC, stream, SSE, WebSocket, or WebTransport behavior.
-- Avoid hiding behavior in transport wrappers that diagnostics and compiled plans cannot inspect.
+- Avoid hiding behavior in runtime wrappers that diagnostics and compiled plans cannot inspect.
 
 ## Public API and Import Surface
 
@@ -146,7 +147,7 @@ Choose `tigrbl-runtime` when the quick-answer table matches your use case. Choos
 
 - Community: [Discord](https://discord.gg/K4YTAPapjR).
 - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
-- Repository: [pkgs/core/tigrbl_runtime](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime).
+- Repository: [pkgs/50_runtime/tigrbl_runtime](https://github.com/tigrbl/tigrbl/tree/master/pkgs/50_runtime/tigrbl_runtime).
 
 ## Package-local Boundary
 
@@ -157,9 +158,13 @@ This README is the package-local distribution entry point for `tigrbl-runtime`.
 - 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`.
+- Local certification guard: `pkgs/97_tests/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.
 
 ## License
 
 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).
+
+## Lowering integration
+
+`lowering_services` lazily exposes canonical kernel operation-view compilation and WebSocket JSON-RPC session construction to concrete integration code. It preserves the kernel function objects and keeps kernel imports out of concrete authoring modules.

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/pyproject.toml

@@ -1,22 +1,18 @@
 [project]
 name = "tigrbl-runtime"
-version = "0.4.5.dev1"
-description = "Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch."
+version = "0.4.5.dev6"
+description = "Execution bridge for compiled Tigrbl kernel plans and narrow runtime context/carrier compatibility."
 readme = "README.md"
 license = { file = "LICENSE" }
 keywords = [
     "tigrbl",
     "asgi",
     "api",
-    "json-rpc",
-    "rest",
     "sqlalchemy",
     "pydantic",
     "runtime",
     "pipeline",
     "bridge",
-    "openapi",
-    "openrpc",
     "schema-first",
 ]
 classifiers = [
@@ -53,7 +49,7 @@ dependencies = [
 Organization = "https://github.com/tigrbl"
 Discord = "https://discord.gg/K4YTAPapjR"
 Homepage = "https://github.com/tigrbl/tigrbl"
-Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime"
+Repository = "https://github.com/tigrbl/tigrbl/tree/master/pkgs/50_runtime/tigrbl_runtime"
 Issues = "https://github.com/tigrbl/tigrbl/issues"
 
 [tool.uv.sources]
@@ -77,4 +73,5 @@ dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
     "ruff>=0.9",
+    "tomli>=2.0; python_version < '3.11'",
 ]

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/tigrbl_runtime/channel/_asgi_jsonrpc.py

@@ -36,3 +36,14 @@ def _resolve_jsonrpc_endpoint(ctx: Any, channel: OpChannel) -> str | None:
         if path == _normalize_path(mapped_path):
             return endpoint
     return None
+
+
+_NO_ERROR_DATA = object()
+
+
+def _jsonrpc_error_payload(code: int, message: str, request_id: Any, *, data: Any = _NO_ERROR_DATA) -> dict[str, Any]:
+    """Construct the existing compatibility error envelope without choosing policy."""
+    error: dict[str, Any] = {"code": code, "message": message}
+    if data is not _NO_ERROR_DATA:
+        error["data"] = data
+    return {"jsonrpc": "2.0", "error": error, "id": request_id}

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/tigrbl_runtime/channel/_asgi_send.py

@@ -19,6 +19,52 @@ from ._asgi_webtransport import (
 )
 
 
+def _webtransport_event_projection(ctx: Any) -> Mapping[str, Any]:
+    projection = ctx.get("channel_event_projection")
+    if isinstance(projection, Mapping):
+        return projection
+    channel = ctx.get("channel")
+    state = getattr(channel, "state", None) if channel is not None else None
+    if isinstance(state, dict):
+        projection = state.get("event_projection")
+        if isinstance(projection, Mapping):
+            return projection
+    return {}
+
+
+def _is_receive_only_webtransport_stream(ctx: Any) -> bool:
+    projection = _webtransport_event_projection(ctx)
+    if (
+        projection.get("lane") == "unidi_client_stream"
+        or projection.get("exchange") == "client_stream"
+    ):
+        return True
+    message = ctx.get("channel_message")
+    return bool(
+        isinstance(message, Mapping)
+        and message.get("type") == "webtransport.stream.receive"
+        and message.get("stream_direction") == "client_to_server"
+    )
+
+
+def _validate_receive_only_webtransport_output(payload: Any) -> None:
+    if payload is None:
+        return
+    if not isinstance(payload, Mapping) or not any(
+        key in payload
+        for key in ("bidirectional_streams", "unidirectional_streams", "datagrams")
+    ):
+        raise ValueError(
+            "cannot automatically reply on a client_to_server WebTransport stream; "
+            "return None or emit an explicit server_to_client stream or datagram"
+        )
+    if payload.get("bidirectional_streams"):
+        raise ValueError(
+            "bidirectional_streams output is invalid for a client_to_server "
+            "WebTransport stream; use unidirectional_streams or datagrams"
+        )
+
+
 async def _send_session_payload(
     env: Any,
     payload: Any,
@@ -87,11 +133,15 @@ async def _send_webtransport_payload(env: Any, ctx: Any, payload: Any) -> None:
         for key in ("bidirectional_streams", "unidirectional_streams", "datagrams")
     )
     if structured_payload:
-        if not queue and message_type in {
-            "webtransport.stream.receive",
-            "webtransport.datagram.receive",
-        }:
-            queue = [message]
+        if (
+            message_type
+            in {
+                "webtransport.stream.receive",
+                "webtransport.datagram.receive",
+            }
+            and message not in queue
+        ):
+            queue.append(message)
         if not queue:
             raise ValueError(
                 "structured WebTransport payloads require inbound stream.receive or datagram.receive events"
@@ -125,6 +175,12 @@ async def _send_webtransport_payload(env: Any, ctx: Any, payload: Any) -> None:
             )
     if payload is not None:
         base = {**message, "session_id": session_id}
+        temp = getattr(ctx, "temp", None)
+        dispatch = temp.get("dispatch") if isinstance(temp, Mapping) else None
+        if isinstance(dispatch, Mapping):
+            request = dispatch.get("rpc") or dispatch.get("rpc_envelope")
+            if isinstance(request, Mapping) and request.get("id") is not None:
+                base["jsonrpc_request_id"] = request.get("id")
         if structured_payload:
             for event in _webtransport_structured_payload_events(
                 session_id=session_id,
@@ -151,6 +207,14 @@ async def _send_webtransport_payload(env: Any, ctx: Any, payload: Any) -> None:
                 )
                 await _run_webtransport_hooks(env, ctx, direction="send", message=event)
                 await send(event)
+            if isinstance(state, dict):
+                raw_queue = state.get("receive_queue")
+                consumed = min(len(queue), len(raw_queue or ()))
+                if isinstance(raw_queue, deque):
+                    for _ in range(consumed):
+                        raw_queue.popleft()
+                elif isinstance(raw_queue, list):
+                    del raw_queue[:consumed]
         else:
             event = _webtransport_payload_event(base=base, payload=payload)
             if isinstance(session, WebTransportSessionState):
@@ -222,6 +286,16 @@ async def send_transport_via_channel(env: Any, ctx: Any) -> None:
         if payload is None:
             payload = getattr(ctx, "result", None)
         if scope_type == "webtransport":
+            if _is_receive_only_webtransport_stream(ctx):
+                _validate_receive_only_webtransport_output(payload)
+                if payload is None:
+                    if isinstance(state, dict):
+                        state["egress_disposition"] = "suppressed_receive_only"
+                        state["emitted"] = False
+                    if isinstance(egress, dict):
+                        egress["response_suppressed"] = True
+                        egress["suppression_reason"] = "receive_only_stream"
+                    return
             await _send_webtransport_payload(env, ctx, payload)
         else:
             await _send_session_payload(

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/tigrbl_runtime/channel/_asgi_webtransport.py

@@ -15,9 +15,12 @@ from tigrbl_kernel.channel_taxonomy import (
     webtransport_event_metadata as _webtransport_event_metadata,
 )
 from tigrbl_kernel.webtransport_events import validate_webtransport_event_payload
+from tigrbl_kernel.webtransport_session_plan import WebTransportSessionPlan
 from tigrbl_atoms.runtime_channel import WebTransportSessionState
 from tigrbl_typing.channel import OpChannel
 
+MAX_EAGER_DRAIN_EVENTS = 16
+
 
 def _webtransport_scope_state(env: Any) -> dict[str, Any]:
     scope = getattr(env, "scope", {}) or {}
@@ -242,6 +245,20 @@ async def _receive_webtransport_session_messages(
     queue: deque[Mapping[str, Any]] = deque()
     session: WebTransportSessionState | None = None
 
+    session_plan = shared_state.get("session_plan")
+    if not isinstance(session_plan, WebTransportSessionPlan):
+        session_plan = WebTransportSessionPlan()
+        shared_state["session_plan"] = session_plan
+
+    async def _receive_record_or_event() -> Mapping[str, Any]:
+        if session_plan.has_pending():
+            return session_plan.pop_pending()
+        while True:
+            raw = _enrich_webtransport_message(env, await receive())
+            session_plan.project_receive(raw)
+            if session_plan.has_pending():
+                return session_plan.pop_pending()
+
     def _ensure_session(message: Mapping[str, Any]) -> WebTransportSessionState | None:
         nonlocal session
         session_id = message.get("session_id") or _webtransport_scope_session_id(env)
@@ -292,6 +309,8 @@ async def _receive_webtransport_session_messages(
                 channel="receive",
                 payload={**message, "session_id": state.get("session_id")},
             )
+            state["event_projection"] = dict(projection)
+            ctx["channel_event_projection"] = dict(projection)
             if current_session is not None:
                 current_session.apply_event(
                     event=message_type,
@@ -334,18 +353,26 @@ async def _receive_webtransport_session_messages(
             return
         ctx["channel_message"] = message
 
-    message = await receive()
+    message = await _receive_record_or_event()
     await _record_payload_message(message)
     if message.get("type") == "webtransport.connect":
         if "channel_message" not in ctx:
-            message = await receive()
+            message = await _receive_record_or_event()
             await _record_payload_message(message)
 
-    while shared_state.get("eager_drain") is True and not state.get("disconnected"):
+    drained_events = 0
+    while (
+        shared_state.get("eager_drain") is True
+        and not state.get("disconnected")
+        and drained_events < MAX_EAGER_DRAIN_EVENTS
+    ):
         try:
-            message = await asyncio.wait_for(receive(), timeout=0.001)
+            message = await asyncio.wait_for(
+                _receive_record_or_event(), timeout=0.001
+            )
         except TimeoutError:
             break
         await _record_payload_message(message)
+        drained_events += 1
 
     state["receive_queue"] = queue

{tigrbl_runtime-0.4.5.dev1 → tigrbl_runtime-0.4.5.dev6}/tigrbl_runtime/executors/ctx/context.py

@@ -16,11 +16,7 @@ from typing import (
     runtime_checkable,
 )
 
-try:
-    from sqlalchemy.ext.asyncio import AsyncSession
-    from sqlalchemy.orm import Session
-except Exception:  # pragma: no cover - optional ORM dependency for runtime typing
-    AsyncSession = Session = Any  # type: ignore[assignment]
+AsyncSession = Session = Any  # type: ignore[assignment]
 
 from tigrbl_atoms.types import BaseCtx
 from tigrbl_base._base import AttrDict