taskwire 0.1.2__tar.gz → 0.2.0__tar.gz

{taskwire-0.1.2 → taskwire-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: taskwire
-Version: 0.1.2
+Version: 0.2.0
 Summary: Progress reporting and awaitable dialogs for long-running server-side operations.
 Project-URL: Homepage, https://github.com/velis74/taskwire
 Project-URL: Repository, https://github.com/velis74/taskwire
@@ -38,12 +38,12 @@ Requires-Dist: ruff; extra == 'dev'
 Provides-Extra: fastapi
 Requires-Dist: fastapi>=0.100; extra == 'fastapi'
 Provides-Extra: muxws
-Requires-Dist: dynamicforms-fastapi-viewsets[muxws]>=0.5.4; extra == 'muxws'
-Requires-Dist: muxws>=0.3.1; extra == 'muxws'
+Requires-Dist: dynamicforms-fastapi-viewsets[muxws]>=0.9.0; extra == 'muxws'
+Requires-Dist: muxws>=0.4.1; extra == 'muxws'
 Provides-Extra: redis
 Requires-Dist: redis>=5.0; extra == 'redis'
 Provides-Extra: viewsets
-Requires-Dist: dynamicforms-fastapi-viewsets>=0.5.4; extra == 'viewsets'
+Requires-Dist: dynamicforms-fastapi-viewsets>=0.9.0; extra == 'viewsets'
 Description-Content-Type: text/markdown
 
 # <img src="taskwire-icon.svg" alt="" width="40" height="40" style="vertical-align: middle"> taskwire
@@ -73,7 +73,7 @@ current state, and asking for it is always enough.
 
 The layering is the shape of the source tree:
 
-```
+```text
              protocol            documents, envelopes, the six kinds, the state
                  │               machines, validation.  Knows of no transport.
      ┌───────────┼───────────┐

{taskwire-0.1.2 → taskwire-0.2.0}/README.md

@@ -25,7 +25,7 @@ current state, and asking for it is always enough.
 
 The layering is the shape of the source tree:
 
-```
+```text
              protocol            documents, envelopes, the six kinds, the state
                  │               machines, validation.  Knows of no transport.
      ┌───────────┼───────────┐

{taskwire-0.1.2 → taskwire-0.2.0}/pyproject.toml

@@ -30,12 +30,14 @@ dependencies = []   # DELIBERATE: core has no runtime dependency of any kind (TW
 redis = ["redis>=5.0"]
 celery = ["celery>=5.3", "nest_asyncio>=1.6"]
 fastapi = ["fastapi>=0.100"]
-# >=0.5.4: set_celery_dispatch_hook there takes the call's kwargs (0.5.2 called it with none), which
-# is the signature register_taskwire_celery_viewset's hook expects (TW-CELERY-007).
-viewsets = ["dynamicforms-fastapi-viewsets>=0.5.4"]
+# >=0.9.0: the execution hook, the Idempotency-Key helpers and a muxws command that runs to the end
+# of its action when its stream ends early (TW-CALL-*).
+viewsets = ["dynamicforms-fastapi-viewsets>=0.9.0"]
 # The socket carries the six request/response calls as viewset commands (TW-REST-004), so the muxws
-# extra needs the viewset layer's muxws half as well as muxws itself.
-muxws = ["muxws>=0.3.1", "dynamicforms-fastapi-viewsets[muxws]>=0.5.4"]
+# extra needs the viewset layer's muxws half as well as muxws itself. >=0.4.1: `Peer.close()` sends
+# every queued frame before closing the socket, so the `goaway` of `goaway_if_stale` (TW-WS-007)
+# reaches the client.
+muxws = ["muxws>=0.4.1", "dynamicforms-fastapi-viewsets[muxws]>=0.9.0"]
 demo = ["uvicorn>=0.27"]
 dev = ["coverage", "pytest", "pytest-asyncio", "pytest-cov", "hypothesis", "httpx", "ruff"]
 

{taskwire-0.1.2 → taskwire-0.2.0}/taskwire/__init__.py

@@ -12,9 +12,10 @@ outside. Nothing in the core imports a framework, a driver or a UI library (TW-C
 
 from __future__ import annotations
 
-__version__ = "0.1.2"
+__version__ = "0.2.0"
 
 from .ambient import ask, current_reporter, progress
+from .calls import Call, call_token, execute_call, hand_off, receive_call
 from .conformance import run_conformance
 from .decorators import (
     declared_result_kind,
@@ -73,6 +74,8 @@ from .transport import LocalTransport, NullTransport, TaskwireTransport
 __all__ = [
     "Aggregate",
     "Button",
+    "Call",
+    "call_token",
     "Client",
     "Commit",
     "DialogAnswer",
@@ -126,6 +129,9 @@ __all__ = [
     "new_token",
     "TOKEN_HEADER",
     "operation",
+    "receive_call",
+    "execute_call",
+    "hand_off",
     "reset_configuration",
     "run_conformance",
     "settings",

taskwire-0.2.0/taskwire/calls.py

@@ -0,0 +1,429 @@
+"""One call - an HTTP request, a command on a stream, a queued job - tracked as an operation (TW-CALL-*).
+
+The caller names the operation: `X-Taskwire-Token` when it sends one, otherwise the key of its
+`Idempotency-Key` header when that key is a UUID (`call_token`). Three places see a tracked call, and
+each has one primitive:
+
+- **where it is received**, `receive_call()`: writes `queued`, and `failed` when the call ends before
+  anything executed it;
+- **where it executes**, `execute_call()`: `operation()` around the work, with the ambient reporter
+  bound;
+- **where the work is handed to another process**, `hand_off()`: the values that cross the boundary,
+  and the terminal write left to the process that receives them.
+
+The adapters do nothing but read a framework's request into a `Call` and place these primitives:
+`taskwire.contrib.asgi.track_calls`, `taskwire.contrib.wsgi.track_calls` and
+`taskwire.contrib.viewsets.TaskwireMiddleware`. Both context managers have an asynchronous and a
+synchronous form, as `operation()` has (TW-API-002).
+
+```python
+async with receive_call(call, dispatch_errors=(BrokerDown,)):
+    async with execute_call(call) as reporter:
+        ...                                  # `taskwire.progress` reports into `call.token`
+```
+"""
+
+from __future__ import annotations
+
+import asyncio
+import contextlib
+import contextvars
+import logging
+
+from collections.abc import Iterable, Iterator, Mapping
+from dataclasses import dataclass
+from typing import Any
+
+from .headers import TOKEN_HEADER
+from .models import Error, ProgressState, Text
+from .reporter import mark_failed, mark_queued, operation, OperationScope, Reporter
+from .rest import _is_uuid
+from .settings import configured
+from .store import key as make_key
+
+logger = logging.getLogger("taskwire.calls")
+
+IDEMPOTENCY_KEY_HEADER = "Idempotency-Key"
+"""The header whose key names a call that carries no `X-Taskwire-Token` (TW-CALL-001)."""
+
+SAFE_METHODS = frozenset({"GET", "HEAD", "OPTIONS"})
+"""Methods whose `Idempotency-Key` does not make a call tracked (TW-CALL-002)."""
+
+NOT_EXECUTED = "not_executed"
+"""A tracked call ended before anything executed it. `retryable: false` (TW-CALL-005)."""
+
+DISPATCH_FAILED = "dispatch_failed"
+"""The work could not be handed to the process that executes it. `retryable: true` (TW-CALL-005,
+TW-CELERY-004)."""
+
+DIALOG_TIMEOUT = "dialog_timeout"
+"""An execution limit ended the work while it held an open question. `retryable: true` (TW-DLG-006)."""
+
+HTTP_STATUS = "http_status"
+"""The call was answered with an error status and no exception (TW-CALL-006)."""
+
+
+def status_error(status: int) -> Error | None:
+    """The error of a call answered with HTTP `status`, or None below 400 (TW-CALL-006).
+
+    `http_status` with `params={"status": status}`, `retryable: true` for 502, 503 and 504.
+    """
+    if status < 400:
+        return None
+    return Error(
+        code=HTTP_STATUS,
+        message=Text(key="taskwire.http_status", params={"status": status}, text=f"HTTP {status}"),
+        retryable=status in (502, 503, 504),
+    )
+
+
+class _Unsuccessful(Exception):  # noqa: N818 - never raised; the exit's stand-in for a recorded failure
+    pass
+
+
+def _header_pairs(headers: Mapping[str, str] | Iterable[tuple[str, str]]) -> Iterable[tuple[str, str]]:
+    if isinstance(headers, Mapping):
+        multi = getattr(headers, "multi_items", None)
+        return multi() if callable(multi) else headers.items()
+    return headers
+
+
+def _sf_string(value: str) -> str | None:
+    """The content of a Structured Field string (RFC 8941 §3.3.3), or None for anything else."""
+    value = value.strip(" ")
+    if len(value) < 2 or value[0] != '"' or value[-1] != '"':
+        return None
+    content: list[str] = []
+    escaped = False
+    for char in value[1:-1]:
+        if escaped:
+            if char not in '"\\':
+                return None
+            content.append(char)
+            escaped = False
+        elif char == "\\":
+            escaped = True
+        elif char == '"' or not " " <= char <= "~":
+            return None
+        else:
+            content.append(char)
+    return None if escaped else "".join(content)
+
+
+def call_token(headers: Mapping[str, str] | Iterable[tuple[str, str]], method: str | None = None) -> str | None:
+    """The token a call is tracked under, or None for an untracked call (TW-CALL-001, TW-CALL-002).
+
+    `headers` is a mapping or a sequence of `(name, value)` pairs; names compare case-insensitively.
+    `X-Taskwire-Token` is the token when present. Otherwise the token is the key of a single
+    `Idempotency-Key` header holding a Structured Field string whose content is a UUID, for any
+    `method` outside `SAFE_METHODS`. A missing, repeated or malformed `Idempotency-Key` leaves the call
+    untracked and is never an error.
+    """
+    token_name, key_name = TOKEN_HEADER.lower(), IDEMPOTENCY_KEY_HEADER.lower()
+    keys: list[str] = []
+    for name, value in _header_pairs(headers):
+        lowered = name.lower()
+        if lowered == token_name and value:
+            return value
+        if lowered == key_name:
+            keys.append(value)
+    if (method is not None and method.upper() in SAFE_METHODS) or len(keys) != 1:
+        return None
+    key = _sf_string(keys[0])
+    return key if key is not None and _is_uuid(key) else None
+
+
+@dataclass(frozen=True)
+class Call:
+    """A tracked call: its token, the namespace `session_resolver` produced for it, and the two fields
+    the `queued` write fixes (TW-PROG-006)."""
+
+    token: str
+    session: str
+    connection: str | None = None
+    """`X-Taskwire-Connection` of the call; the operation's `origin_connection`."""
+    result_kind: str | None = None
+    """None makes the operation private (TW-PRIV-001)."""
+
+    def carried(self) -> dict[str, str]:
+        """The values that cross a process boundary: `token` and `session`, as plain strings
+        (TW-CELERY-003). The keyword arguments `taskwire_task` takes."""
+        return {"token": self.token, "session": self.session}
+
+    @classmethod
+    def from_carried(cls, carried: Mapping[str, Any]) -> Call | None:
+        """The call `carried()` produced, or None when either value is missing or not a non-empty
+        string. The namespace is not resolved again (TW-AMB-008)."""
+        token, session = carried.get("token"), carried.get("session")
+        if not isinstance(token, str) or not token or not isinstance(session, str) or not session:
+            return None
+        return cls(token=token, session=session)
+
+
+_receipt: contextvars.ContextVar[CallReceipt | None] = contextvars.ContextVar("taskwire_call_receipt", default=None)
+_execution: contextvars.ContextVar[CallExecution | None] = contextvars.ContextVar(
+    "taskwire_call_execution", default=None
+)
+
+
+def _run(coroutine: Any) -> Any:
+    """Run `coroutine` to completion on a loop of its own, for the synchronous forms."""
+    loop = asyncio.new_event_loop()
+    try:
+        return loop.run_until_complete(coroutine)
+    finally:
+        loop.close()
+
+
+class CallReceipt:
+    """What `receive_call()` returns: an async and a sync context manager yielding the `Call`."""
+
+    def __init__(
+        self,
+        call: Call | None,
+        dispatch_errors: tuple[type[BaseException], ...],
+        pending_errors: tuple[type[BaseException], ...],
+    ) -> None:
+        self.call = call
+        self._dispatch_errors = dispatch_errors
+        self._pending_errors = pending_errors
+        self._marker: contextvars.Token | None = None
+        self.started = False
+        """True once `execute_call()` was entered for this call in this context."""
+
+    def _active(self) -> bool:
+        if self.call is None:
+            return False
+        outer = _receipt.get()
+        return outer is None or outer.call is None or outer.call.token != self.call.token
+
+    async def _open(self) -> None:
+        call = self.call
+        store = configured.store
+        if call is None or store is None:
+            return
+        try:
+            k = make_key(call.session, call.token)
+            existing = await store.snapshot(k)
+            if existing is not None and existing.progress.is_terminal:
+                await store.drop(k)
+            await mark_queued(
+                call.token, session=call.session, connection=call.connection, result_kind=call.result_kind
+            )
+        except Exception:  # noqa: BLE001 - reporting is an accelerator; the call runs
+            logger.warning("taskwire: no queued write for %s; the call runs", call.token, exc_info=True)
+
+    async def _close(self, exc: BaseException | None) -> None:
+        call = self.call
+        store = configured.store
+        if call is None or store is None or self.started:
+            return
+        if exc is not None and isinstance(exc, self._pending_errors):
+            return
+        try:
+            snapshot = await store.snapshot(make_key(call.session, call.token))
+            if snapshot is None or ProgressState(snapshot.progress.state) is not ProgressState.QUEUED:
+                return
+            if exc is not None and isinstance(exc, self._dispatch_errors):
+                error = Error(code=DISPATCH_FAILED, message=Text(key="taskwire.dispatch_failed"), retryable=True)
+            else:
+                error = Error(code=NOT_EXECUTED, message=Text(key="taskwire.not_executed"), retryable=False)
+            await mark_failed(call.token, session=call.session, error=error)
+        except Exception:  # noqa: BLE001 - reporting never replaces the call's own outcome
+            logger.warning("taskwire: could not end the unexecuted operation %s", call.token, exc_info=True)
+
+    async def __aenter__(self) -> Call | None:
+        if self._active():
+            await self._open()
+            self._marker = _receipt.set(self)
+        return self.call
+
+    async def __aexit__(self, exc_type: Any, exc: Any, tb: Any) -> bool:
+        if self._marker is not None:
+            _receipt.reset(self._marker)
+            self._marker = None
+            await self._close(exc)
+        return False
+
+    def __enter__(self) -> Call | None:
+        if self._active():
+            _run(self._open())
+            self._marker = _receipt.set(self)
+        return self.call
+
+    def __exit__(self, exc_type: Any, exc: Any, tb: Any) -> bool:
+        if self._marker is not None:
+            _receipt.reset(self._marker)
+            self._marker = None
+            _run(self._close(exc))
+        return False
+
+
+def receive_call(
+    call: Call | None,
+    *,
+    dispatch_errors: tuple[type[BaseException], ...] = (),
+    pending_errors: tuple[type[BaseException], ...] = (),
+) -> CallReceipt:
+    """Where a call is received: `queued` on entry, and `failed` for a call nothing executed (TW-CALL-003,
+    TW-CALL-005).
+
+    Entry drops a terminal document under the token, since the call executes anew, and writes `queued`
+    with `call.result_kind` and `call.connection`; an existing non-terminal document is left as it is.
+    Exit writes `failed` when the operation is still `queued` and `execute_call()` was not entered for
+    the call in this context: `dispatch_failed` (`retryable: true`) when the exception leaving the block
+    is one of `dispatch_errors`, nothing when it is one of `pending_errors` (the work may still execute
+    elsewhere, and `active_ttl` expires the document otherwise), and `not_executed` (`retryable: false`)
+    in every other case, a clean exit included.
+
+    `call=None` and a store-less configuration make it a no-op, and so does a block nested in one
+    already receiving the same token. A store failure is logged and never raised.
+    """
+    return CallReceipt(call, dispatch_errors, pending_errors)
+
+
+class CallExecution:
+    """What `execute_call()` returns: an async and a sync context manager yielding the `Reporter`, or
+    None for an untracked or nested execution."""
+
+    def __init__(self, call: Call | None, timeout_errors: tuple[type[BaseException], ...]) -> None:
+        self.call = call
+        self._timeout_errors = timeout_errors
+        self._scope: OperationScope | None = None
+        self._reporter: Reporter | None = None
+        self._marker: contextvars.Token | None = None
+        self._failure: Error | None = None
+
+    def fail(self, error: Error) -> None:
+        """End the operation `failed` with `error` when the block exits without an exception: for a
+        framework that answers a failed call instead of raising (TW-CALL-006)."""
+        self._failure = error
+
+    def _begin(self) -> OperationScope | None:
+        call = self.call
+        if call is None or _execution.get() is not None:
+            return None
+        receipt = _receipt.get()
+        if receipt is not None and receipt.call is not None and receipt.call.token == call.token:
+            receipt.started = True
+        return operation(call.token, session=call.session, connection=call.connection, result_kind=call.result_kind)
+
+    def _entered(self, scope: OperationScope, reporter: Reporter) -> Reporter:
+        self._scope, self._reporter = scope, reporter
+        self._marker = _execution.set(self)
+        return reporter
+
+    def _ending(self, exc: BaseException | None) -> OperationScope | None:
+        scope, reporter = self._scope, self._reporter
+        if scope is None or reporter is None:
+            return None
+        _execution.reset(self._marker)
+        self._scope = self._reporter = self._marker = None
+        if exc is not None and isinstance(exc, self._timeout_errors) and reporter.asking:
+            reporter.name_error(
+                DIALOG_TIMEOUT,
+                Text(key="taskwire.dialog_timeout"),
+                True,  # noqa: FBT003 - positional to match `name_error(code, message, retryable)`
+            )
+        return scope
+
+    def _failed_entry(self) -> None:
+        logger.warning("taskwire: no operation for %s; the call runs unreported", self.call.token, exc_info=True)
+
+    def _failed_exit(self) -> None:
+        logger.warning("taskwire: the terminal write failed for %s", self.call.token, exc_info=True)
+
+    async def __aenter__(self) -> Reporter | None:
+        scope = self._begin()
+        if scope is None:
+            return None
+        try:
+            reporter = await scope.__aenter__()
+        except Exception:  # noqa: BLE001 - an unreachable store is not a reason to refuse the work
+            self._failed_entry()
+            return None
+        return self._entered(scope, reporter)
+
+    def _outcome(self, exc_type: Any, exc: Any, tb: Any) -> tuple[Any, Any, Any]:
+        failure, self._failure = self._failure, None
+        if exc is not None or failure is None or self._reporter is None:
+            return exc_type, exc, tb
+        self._reporter.name_error(failure.code, failure.message, failure.retryable)
+        return _Unsuccessful, _Unsuccessful(), None
+
+    async def __aexit__(self, exc_type: Any, exc: Any, tb: Any) -> bool:
+        outcome = self._outcome(exc_type, exc, tb)
+        scope = self._ending(exc)
+        if scope is not None:
+            try:
+                await scope.__aexit__(*outcome)
+            except Exception:  # noqa: BLE001 - logged, never in place of the call's own outcome
+                self._failed_exit()
+        return False
+
+    def __enter__(self) -> Reporter | None:
+        scope = self._begin()
+        if scope is None:
+            return None
+        try:
+            reporter = scope.__enter__()
+        except Exception:  # noqa: BLE001 - an unreachable store is not a reason to refuse the work
+            self._failed_entry()
+            return None
+        return self._entered(scope, reporter)
+
+    def __exit__(self, exc_type: Any, exc: Any, tb: Any) -> bool:
+        outcome = self._outcome(exc_type, exc, tb)
+        scope = self._ending(exc)
+        if scope is not None:
+            try:
+                scope.__exit__(*outcome)
+            except Exception:  # noqa: BLE001 - logged, never in place of the call's own outcome
+                self._failed_exit()
+        return False
+
+
+def execute_call(call: Call | None, *, timeout_errors: tuple[type[BaseException], ...] = ()) -> CallExecution:
+    """Where a call executes: `operation()` around the work (TW-CALL-004).
+
+    Enters `operation(call.token, session=..., connection=..., result_kind=...)`, which flips `queued`
+    to `running`, binds the ambient reporter and writes exactly one terminal state on exit (TW-API-001),
+    and marks the call started for the `receive_call()` block around it. When an exception in
+    `timeout_errors` ends the block while the operation holds an open question, the terminal error is
+    `dialog_timeout` with `retryable: true` (TW-DLG-006).
+
+    Yields None, and reports nothing, for `call=None` and inside another `execute_call()` block: work
+    the executing call does on its own behalf belongs to its operation. A store failure on entry leaves
+    the work to run unreported; a failure of the terminal write is logged.
+    """
+    return CallExecution(call, timeout_errors)
+
+
+@contextlib.contextmanager
+def hand_off() -> Iterator[dict[str, str]]:
+    """Hand the executing call's operation to another process (TW-CALL-007).
+
+    Yields `Call.carried()` of the call `execute_call()` is executing in this context, `{}` outside
+    one. A block that exits cleanly leaves the terminal write to the receiving process: the
+    `execute_call()` exit writes no state. An exception leaving the block names `dispatch_failed`
+    (`retryable: true`) as the operation's error, and the `execute_call()` exit writes it.
+
+    ```python
+    with hand_off() as carried:
+        import_rows.delay(rows=rows, **carried)     # a `taskwire_task` continues the operation
+    ```
+    """
+    execution = _execution.get()
+    if execution is None or execution._scope is None or execution._reporter is None:
+        yield {}
+        return
+    try:
+        yield execution.call.carried()
+    except BaseException:
+        execution._reporter.name_error(
+            DISPATCH_FAILED,
+            Text(key="taskwire.dispatch_failed"),
+            True,  # noqa: FBT003 - positional to match `name_error(code, message, retryable)`
+        )
+        raise
+    execution._scope.hand_off()

{taskwire-0.1.2 → taskwire-0.2.0}/taskwire/contrib/asgi.py

@@ -3,6 +3,8 @@
 This is the proof that TW-REST-001 is real rather than aspirational: `taskwire.rest` is reachable
 over HTTP with nothing installed but Python. It is also the smallest complete example of what an
 adapter has to do - build a `Client`, call a handler, serialise the result.
+
+`track_calls` is the call-tracking adapter for any ASGI application (TW-CALL-104).
 """
 
 from __future__ import annotations
@@ -12,6 +14,7 @@ import json
 from collections.abc import Callable
 from typing import Any
 
+from ..calls import Call, call_token, execute_call, receive_call, status_error
 from ..delivery import Client
 from ..headers import CONNECTION_HEADER_BYTES as CONNECTION_HEADER
 from ..rest import collect_result, dismiss_result, get_operations, get_snapshot, reply_to_dialog, request_cancel
@@ -89,3 +92,74 @@ def app(prefix: str | None = None) -> Callable[..., Any]:
         await send({"type": "http.response.body", "body": body})
 
     return application
+
+
+def _under(path: str, mount: str) -> bool:
+    root = mount.rstrip("/")
+    return path == root or path.startswith(root + "/")
+
+
+def track_calls(
+    app: Callable[..., Any],
+    *,
+    exclude_prefix: str | None = None,
+    session_resolver: Callable[[dict[str, Any]], str | None] | None = None,
+    result_kind: Callable[[dict[str, Any]], str | None] | None = None,
+) -> Callable[..., Any]:
+    """ASGI middleware tracking every HTTP request of `app` that carries a token (TW-CALL-104).
+
+    ```python
+    app = track_calls(app)
+    ```
+
+    A request is tracked when `taskwire.calls.call_token()` finds a token in its headers and the
+    namespace resolver returns one: `session_resolver`, else the configured one, called with the ASGI
+    scope. The request runs inside `receive_call()` and `execute_call()`, so the application reports
+    through `taskwire.progress` and hands work to another process with `taskwire.calls.hand_off()`.
+    A response status of 400 or more ends the operation `failed` with `http_status`. `result_kind`,
+    called with the scope, fixes the operation's result kind; without it the operation is private.
+    Requests under `exclude_prefix` (default: `settings.rest_prefix`, taskwire's own endpoints) and
+    every other scope type pass through untouched.
+    """
+    mount = exclude_prefix if exclude_prefix is not None else settings.rest_prefix
+
+    def _call(scope: dict[str, Any]) -> Call | None:
+        if scope.get("type") != "http" or _under(scope.get("path", ""), mount):
+            return None
+        headers = [(name.decode("latin-1"), value.decode("latin-1")) for name, value in scope.get("headers") or ()]
+        token = call_token(headers, scope.get("method"))
+        resolver = session_resolver if session_resolver is not None else configured.session_resolver
+        if token is None or resolver is None:
+            return None
+        session = resolver(scope)
+        if session is None:
+            return None
+        return Call(
+            token=token,
+            session=session,
+            connection=_header(scope, CONNECTION_HEADER),
+            result_kind=result_kind(scope) if result_kind is not None else None,
+        )
+
+    async def middleware(scope: dict[str, Any], receive: Any, send: Any) -> None:
+        call = _call(scope)
+        if call is None:
+            await app(scope, receive, send)
+            return
+
+        status: list[int] = []
+
+        async def observed(message: dict[str, Any]) -> None:
+            if message.get("type") == "http.response.start":
+                status.append(int(message["status"]))
+            await send(message)
+
+        async with receive_call(call):
+            execution = execute_call(call)
+            async with execution:
+                await app(scope, receive, observed)
+                error = status_error(status[0]) if status else None
+                if error is not None:
+                    execution.fail(error)
+
+    return middleware