tigrbl-runtime 0.4.2.dev3__tar.gz → 0.4.3__tar.gz

tigrbl_runtime-0.4.3/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.

{tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-runtime
-Version: 0.4.2.dev3
+Version: 0.4.3
 Summary: Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
 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,runtime,pipeline,bridge,openapi,openrpc,schema-first
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
@@ -243,12 +244,45 @@ Description-Content-Type: text/markdown
 <p><strong>Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.</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="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%20to%203.15-3776ab" alt="Python requirement for tigrbl-runtime"/></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>
 </div>
 
+## What is tigrbl-runtime?
+
+Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
+
+## Why use tigrbl-runtime?
+
+Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
+
+## When should I install tigrbl-runtime?
+
+Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
+
+## Who is tigrbl-runtime for?
+
+Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
+
+## Where does tigrbl-runtime fit?
+
+`tigrbl-runtime` lives at `pkgs/core/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
+
+## How does tigrbl-runtime 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
@@ -259,56 +293,115 @@ uv add tigrbl-runtime
 pip install tigrbl-runtime
 ```
 
+## Surface Coverage
+
+| 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) |
+| Python import root | `tigrbl_runtime` |
+| 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-runtime` owns the runtime boundary inside the split Python workspace.
-Rust crates and optional Python extension bindings have moved to the private `tigrbl/tigrbl_rs` repository.
+`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.
 
-## Use It When
+Implementation orientation:
+- `tigrbl_runtime`: callbacks, channel/, config/, executors/, handle, protocol/, runtime/, transactions, webhooks
+- `tigrbl_runtime/rust/`: deprecated compatibility shims only; Rust execution is unavailable.
 
-Use `tigrbl-runtime` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
+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 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.
 
-## Public Surface
+## Public API and Import Surface
 
-- Package-local implementation lives under `pkgs/core/tigrbl_runtime` and is consumed as a distribution boundary rather than a single broad root re-export.
+- Import roots: `tigrbl_runtime`.
+- Public symbols: `Runtime`, `RuntimeBase`.
+- Rust-named symbols live only under `tigrbl_runtime.rust` as deprecated compatibility shims and must not be used for execution.
+- Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
+- External runtime dependencies: `numba>=0.61.2`.
 
-## Internal Layout
+## Usage Examples
 
-- Workspace path: `pkgs/core/tigrbl_runtime`.
-- Package class: `core framework package`.
-- Python requirement: `>=3.10,<3.15`.
+### Verify the installed package
 
-## Dependency Surface
+```bash
+python -m pip show tigrbl-runtime
+python - <<'PY'
+from importlib.metadata import version
+print(version("tigrbl-runtime"))
+PY
+```
 
-- Workspace package dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
-- External runtime dependencies: `numba>=0.61.2`.
-- Optional extras: none in this Python workspace.
+### Import the package boundary
+
+```python
+import importlib
+
+module = importlib.import_module("tigrbl_runtime")
+print(module.__name__)
+```
+
+### Import a public symbol
+
+```python
+from tigrbl_runtime import Runtime
+
+print(Runtime)
+```
+
+### Use with the facade when building applications
+
+```bash
+uv add tigrbl tigrbl-runtime
+python - <<'PY'
+import tigrbl
+print(tigrbl.__name__)
+PY
+```
+
+## How To Choose This Package
+
+Choose `tigrbl-runtime` 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.
 
 ## Related Packages
 
-- [`tigrbl`](https://pypi.org/project/tigrbl/)
 - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
 - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/)
 - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
 - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
 - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl`](https://pypi.org/project/tigrbl/)
+
+## Documentation Links
+
+- [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)
 
-## Canonical Repository Docs
+## Support
 
-- `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`
+- 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).
 
 ## Package-local Boundary
 
-This file is a package-local distribution entry point.
-Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
+This README is the package-local distribution entry point for `tigrbl-runtime`. 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.
 
 ## License
 
-Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
+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_runtime-0.4.3/README.md

@@ -0,0 +1,166 @@
+<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>
+<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="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>
+</div>
+
+## What is tigrbl-runtime?
+
+Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
+
+## Why use tigrbl-runtime?
+
+Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
+
+## When should I install tigrbl-runtime?
+
+Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
+
+## Who is tigrbl-runtime for?
+
+Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
+
+## Where does tigrbl-runtime fit?
+
+`tigrbl-runtime` lives at `pkgs/core/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
+
+## How does tigrbl-runtime 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-runtime
+```
+
+```bash
+pip install tigrbl-runtime
+```
+
+## Surface Coverage
+
+| 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) |
+| Python import root | `tigrbl_runtime` |
+| 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-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.
+
+Implementation orientation:
+- `tigrbl_runtime`: callbacks, channel/, config/, executors/, handle, protocol/, runtime/, transactions, webhooks
+- `tigrbl_runtime/rust/`: deprecated compatibility shims only; Rust execution is unavailable.
+
+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 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.
+
+## Public API and Import Surface
+
+- Import roots: `tigrbl_runtime`.
+- Public symbols: `Runtime`, `RuntimeBase`.
+- Rust-named symbols live only under `tigrbl_runtime.rust` as deprecated compatibility shims and must not be used for execution.
+- Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
+- External runtime dependencies: `numba>=0.61.2`.
+
+## Usage Examples
+
+### Verify the installed package
+
+```bash
+python -m pip show tigrbl-runtime
+python - <<'PY'
+from importlib.metadata import version
+print(version("tigrbl-runtime"))
+PY
+```
+
+### Import the package boundary
+
+```python
+import importlib
+
+module = importlib.import_module("tigrbl_runtime")
+print(module.__name__)
+```
+
+### Import a public symbol
+
+```python
+from tigrbl_runtime import Runtime
+
+print(Runtime)
+```
+
+### Use with the facade when building applications
+
+```bash
+uv add tigrbl tigrbl-runtime
+python - <<'PY'
+import tigrbl
+print(tigrbl.__name__)
+PY
+```
+
+## How To Choose This Package
+
+Choose `tigrbl-runtime` 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.
+
+## Related Packages
+
+- [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
+- [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/)
+- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
+- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
+- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
+- [`tigrbl`](https://pypi.org/project/tigrbl/)
+
+## Documentation Links
+
+- [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)
+
+## Support
+
+- 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).
+
+## Package-local Boundary
+
+This README is the package-local distribution entry point for `tigrbl-runtime`. 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.
+
+## 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).

{tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl-runtime"
-version = "0.4.2.dev3"
+version = "0.4.3"
 description = "Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch."
 readme = "README.md"
 license = { file = "LICENSE" }

tigrbl_runtime-0.4.3/tigrbl_runtime/__init__.py

@@ -0,0 +1,25 @@
+"""Public exports for ``tigrbl_runtime`` with lazy loading."""
+
+from __future__ import annotations
+
+from importlib import import_module
+from typing import Any
+
+_LAZY_EXPORTS = {
+    "Runtime": "runtime",
+    "RuntimeBase": "runtime",
+}
+
+__all__ = [
+    *_LAZY_EXPORTS,
+]
+
+
+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

tigrbl_runtime-0.4.2.dev3/tigrbl_runtime/webhooks.py → tigrbl_runtime-0.4.3/tigrbl_runtime/callbacks.py

@@ -7,7 +7,7 @@ from collections.abc import Callable, Mapping
 from typing import Any
 
 
-def compile_webhook_delivery_plan(
+def compile_callback_delivery_plan(
     *,
     event: str,
     endpoint: str,
@@ -19,11 +19,11 @@ def compile_webhook_delivery_plan(
         "endpoint": endpoint,
         "signing": {"algorithm": "hmac-sha256", "secret_ref": signing_secret_ref},
         "retry": dict(retry or {"max_attempts": 1}),
-        "completion_subevent": "webhook.delivery.emit_complete",
+        "completion_subevent": "callback.delivery.emit_complete",
     }
 
 
-def build_webhook_payload(
+def build_callback_payload(
     *, event: str, data: Mapping[str, Any], idempotency_key: str
 ) -> dict[str, object]:
     return {
@@ -33,13 +33,13 @@ def build_webhook_payload(
     }
 
 
-def sign_webhook_payload(payload: Mapping[str, Any], *, secret: str) -> dict[str, object]:
+def sign_callback_payload(payload: Mapping[str, Any], *, secret: str) -> dict[str, object]:
     canonical = json.dumps(payload, sort_keys=True, separators=(",", ":")).encode("utf-8")
     digest = hmac.new(secret.encode("utf-8"), canonical, hashlib.sha256).hexdigest()
     return {"payload": dict(payload), "signature": f"sha256={digest}"}
 
 
-def deliver_webhook(
+def deliver_callback(
     payload: Mapping[str, Any],
     *,
     send: Callable[[Mapping[str, Any]], Mapping[str, Any]],
@@ -54,7 +54,7 @@ def deliver_webhook(
     for attempt in range(1, max_attempts + 1):
         attempts = attempt
         if trace and attempt == 1:
-            trace("webhook.delivery.emit")
+            trace("callback.delivery.emit")
         try:
             response = send(payload)
         except Exception as exc:
@@ -65,7 +65,7 @@ def deliver_webhook(
                 "attempts": attempts,
                 "completed": False,
                 "error_ctx": {
-                    "subevent": "webhook.delivery.emit",
+                    "subevent": "callback.delivery.emit",
                     "message": str(exc),
                 },
             }
@@ -73,7 +73,7 @@ def deliver_webhook(
         status_code = int(response.get("status_code", 0))
         if 200 <= status_code < 300:
             if trace:
-                trace("webhook.delivery.emit_complete")
+                trace("callback.delivery.emit_complete")
             return {
                 "status": "delivered",
                 "attempts": attempts,
@@ -109,8 +109,8 @@ def _is_transient(status_code: int) -> bool:
 
 
 __all__ = [
-    "build_webhook_payload",
-    "compile_webhook_delivery_plan",
-    "deliver_webhook",
-    "sign_webhook_payload",
+    "build_callback_payload",
+    "compile_callback_delivery_plan",
+    "deliver_callback",
+    "sign_callback_payload",
 ]

tigrbl_runtime-0.4.3/tigrbl_runtime/channel/_asgi_completion.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from typing import Any
+
+from tigrbl_atoms.atoms.transport.asgi_channel import (
+    complete_channel_state as _complete_channel_state,
+)
+from tigrbl_typing.channel import OpChannel
+
+from ._asgi_scope import build_asgi_channel
+from ._asgi_send import send_transport_via_channel
+from .websocket import RuntimeWebSocket
+
+
+def channel_senders():
+    from tigrbl_atoms.atoms.egress.asgi_send import _send_json
+
+    return _send_json, send_transport_via_channel
+
+
+async def complete_channel(env: Any, ctx: Any) -> None:
+    channel = ctx.get("channel")
+    if channel is None:
+        channel = build_asgi_channel(env)
+        ctx["channel"] = channel
+    if isinstance(getattr(channel, "state", None), dict):
+        _complete_channel_state(channel.state)
+    ctx["transport_completed"] = True
+    ctx["current_phase"] = "POST_EMIT"
+
+
+def websocket_adapter(channel: OpChannel) -> RuntimeWebSocket:
+    return RuntimeWebSocket(channel)

tigrbl_runtime-0.4.3/tigrbl_runtime/channel/_asgi_context.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Mapping
+
+from tigrbl_kernel.channel_taxonomy import normalize_exchange
+from tigrbl_typing.channel import OpChannel
+
+from ._asgi_jsonrpc import _resolve_jsonrpc_endpoint
+from ._asgi_receive import _receive_session_message
+from ._asgi_scope import _scheme, build_asgi_channel
+from ._asgi_webtransport import (
+    _receive_webtransport_session_messages,
+    _webtransport_scope_state,
+)
+
+
+async def prepare_channel_context(env: Any, ctx: Any) -> OpChannel:
+    temp = ctx.get("temp")
+    if not isinstance(temp, dict):
+        ctx["temp"] = {}
+        temp = ctx["temp"]
+
+    route = temp.setdefault("route", {})
+    exchange = str(
+        route.get("exchange")
+        or getattr(ctx, "tigrbl_exchange", None)
+        or "request_response"
+    )
+    exchange = normalize_exchange(exchange)
+    protocol = str(route.get("protocol") or _scheme(getattr(env, "scope", {}) or {}))
+    framing = route.get("framing")
+    channel = build_asgi_channel(
+        env,
+        exchange=exchange,
+        protocol=protocol or None,
+        framing=str(framing) if isinstance(framing, str) else None,
+    )
+    ctx["channel"] = channel
+    ctx["path"] = channel.path
+    ctx["method"] = channel.method or channel.protocol.upper()
+
+    dispatch = temp.setdefault("dispatch", {})
+    if isinstance(dispatch, dict):
+        dispatch.setdefault("channel_protocol", channel.protocol)
+        dispatch.setdefault("channel_selector", channel.selector)
+        dispatch.setdefault("path_params", dict(channel.path_params))
+        endpoint = _resolve_jsonrpc_endpoint(ctx, channel)
+        if endpoint:
+            dispatch.setdefault("endpoint", endpoint)
+
+    scope = getattr(env, "scope", {}) or {}
+    scope_type = str(scope.get("type") or "http")
+    if scope_type == "webtransport":
+        await _receive_webtransport_session_messages(env, channel, ctx)
+        wt_state = _webtransport_scope_state(env)
+        trace = wt_state.get("trace")
+        if isinstance(trace, list):
+            ctx["webtransport_trace"] = trace
+            channel.state["webtransport_trace"] = trace
+        hook_trace = wt_state.get("hook_trace")
+        if isinstance(hook_trace, list):
+            ctx["webtransport_hook_trace"] = hook_trace
+            channel.state["webtransport_hook_trace"] = hook_trace
+        route.setdefault("protocol", dispatch.get("binding_protocol"))
+        route.setdefault("selector", channel.path)
+        route.setdefault("path_params", dict(channel.path_params))
+        route.setdefault("endpoint", dispatch.get("endpoint"))
+    elif scope_type == "websocket":
+        await _receive_session_message(
+            env,
+            channel,
+            ctx,
+            connect_type="websocket.connect",
+            receive_type="websocket.receive",
+            disconnect_type="websocket.disconnect",
+            eager_payload_after_connect=False,
+        )
+        message = ctx.get("channel_message")
+        if isinstance(message, Mapping) and message.get("text") is not None:
+            try:
+                parsed = json.loads(str(message.get("text")))
+            except Exception:
+                parsed = None
+            if isinstance(parsed, Mapping) and parsed.get("jsonrpc") == "2.0":
+                dispatch["binding_protocol"] = (
+                    "wss.jsonrpc" if channel.protocol == "wss" else "ws.jsonrpc"
+                )
+                dispatch["rpc"] = dict(parsed)
+                dispatch["rpc_method"] = parsed.get("method")
+        route.setdefault("protocol", dispatch.get("binding_protocol"))
+        route.setdefault("selector", channel.path)
+        route.setdefault("path_params", dict(channel.path_params))
+        route.setdefault("endpoint", dispatch.get("endpoint"))
+
+    return channel

tigrbl_runtime-0.4.3/tigrbl_runtime/channel/_asgi_jsonrpc.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from typing import Any, Mapping
+
+from tigrbl_core.config.constants import __JSONRPC_DEFAULT_ENDPOINT_MAPPINGS__
+from tigrbl_typing.channel import OpChannel
+
+
+def _normalize_path(path: str) -> str:
+    return path.rstrip("/") or "/"
+
+
+def _resolve_jsonrpc_endpoint(ctx: Any, channel: OpChannel) -> str | None:
+    if channel.kind != "http" or str(channel.method or "").upper() != "POST":
+        return None
+
+    path = _normalize_path(channel.path)
+    route = {}
+    temp = ctx.get("temp")
+    if isinstance(temp, dict):
+        route = temp.setdefault("route", {})
+    if isinstance(route, Mapping):
+        endpoint = route.get("endpoint")
+        if isinstance(endpoint, str) and endpoint:
+            return endpoint
+
+    for owner_key in ("router", "app"):
+        owner = ctx.get(owner_key)
+        mounts = getattr(owner, "_jsonrpc_endpoint_mounts", None)
+        if isinstance(mounts, Mapping):
+            endpoint = mounts.get(path) or mounts.get(channel.path)
+            if isinstance(endpoint, str) and endpoint:
+                return endpoint
+
+    for endpoint, mapped_path in __JSONRPC_DEFAULT_ENDPOINT_MAPPINGS__.items():
+        if path == _normalize_path(mapped_path):
+            return endpoint
+    return None