reactifact 0.14.2__tar.gz → 0.15.0__tar.gz

{reactifact-0.14.2/reactifact.egg-info → reactifact-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.14.2
+Version: 0.15.0
 Summary: Reactive, artifact-driven agent runtime: agents transform versioned, typed, provenance-aware artifacts inside an evolving context
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/bzdvdn/reactifact
@@ -55,7 +55,7 @@ Dynamic: license-file
 [![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://github.com/bzdvdn/reactifact)
 [![PyPI version](https://img.shields.io/pypi/v/reactifact)](https://pypi.org/project/reactifact/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/bzdvdn/reactifact)
+[![Ask DeepWiki](docs/img/deepwiki.svg)](https://deepwiki.com/bzdvdn/reactifact)
 [![Docs](https://img.shields.io/badge/docs-bzdvdn.github.io%2Freactifact-blue)](https://bzdvdn.github.io/reactifact/)
 
 > **Is:** a Python library (3 core deps) · single-process · typed, versioned artifacts with provenance · deterministic replay · runs offline, no API key

{reactifact-0.14.2 → reactifact-0.15.0}/README.md

@@ -9,7 +9,7 @@
 [![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://github.com/bzdvdn/reactifact)
 [![PyPI version](https://img.shields.io/pypi/v/reactifact)](https://pypi.org/project/reactifact/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/bzdvdn/reactifact)
+[![Ask DeepWiki](docs/img/deepwiki.svg)](https://deepwiki.com/bzdvdn/reactifact)
 [![Docs](https://img.shields.io/badge/docs-bzdvdn.github.io%2Freactifact-blue)](https://bzdvdn.github.io/reactifact/)
 
 > **Is:** a Python library (3 core deps) · single-process · typed, versioned artifacts with provenance · deterministic replay · runs offline, no API key

{reactifact-0.14.2 → reactifact-0.15.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reactifact"
-version = "0.14.2"
+version = "0.15.0"
 description = "Reactive, artifact-driven agent runtime: agents transform versioned, typed, provenance-aware artifacts inside an evolving context"
 readme = "README.md"
 requires-python = ">=3.11"

{reactifact-0.14.2 → reactifact-0.15.0}/reactifact/__init__.py

@@ -51,7 +51,7 @@ from .tools import FunctionTool, Tool, ToolOutput, tool
 from .triggers import Trigger
 from .types import register as register_type
 
-__version__ = "0.14.2"
+__version__ = "0.15.0"
 
 __all__ = [
     "Agent",

{reactifact-0.14.2 → reactifact-0.15.0}/reactifact/web.py

@@ -41,7 +41,7 @@ from ._extras import require_extra
 from .chat import ChatAssistant, ChatEvent, ChatEventKind
 
 if TYPE_CHECKING:
-    from fastapi import APIRouter
+    from fastapi import APIRouter, Request
     from fastapi.responses import JSONResponse, StreamingResponse
 
 
@@ -83,6 +83,7 @@ def create_chat_router(
     forward_kinds: Sequence[str] | None = None,
     payload_shaper: Callable[[ChatEvent], Mapping[str, Any]] | None = None,
     done_event: str | None = None,
+    request_factory: Callable[[Request], Mapping[str, Any]] | None = None,
 ) -> APIRouter:
     """Builds the chat router on top of a `ChatAssistant`.
 
@@ -100,6 +101,10 @@ def create_chat_router(
     - `payload_shaper(event) -> mapping` — reshape a frame's payload.
     - `done_event` — emit one extra terminal frame (e.g. `"done"`) when the
       stream ends.
+    - `request_factory(request) -> mapping` — build the per-turn `request=`
+      mapping (the same one `ChatAssistant.stream` takes) from the incoming
+      FastAPI `Request`, e.g. the authenticated user for ACL/identity-aware
+      runs. Without it the turn runs with `request=None`.
 
     Defaults reproduce the canonical contract exactly, so existing clients are
     unaffected. The event schema (`ChatEvent`) and the effective names are
@@ -108,9 +113,15 @@ def create_chat_router(
     # Readable error when the `web` extra is missing — then a regular
     # (mypy-visible) import for the real types.
     require_extra("web.create_chat_router", "fastapi", "web")
-    from fastapi import APIRouter
+    from fastapi import APIRouter, Request
     from fastapi.responses import JSONResponse, StreamingResponse
 
+    # `Request` is only referenced from the endpoint's *string* annotation
+    # (`from __future__ import annotations`); FastAPI resolves those against
+    # the module globals, and fastapi may be absent at import time — so publish
+    # it lazily here, right before the endpoint that uses it is defined.
+    globals().setdefault("Request", Request)
+
     names: dict[str, str] = {k: v for k, v in DEFAULT_EVENT_NAMES.items()}
     names.update(event_names or {})
     forward = set(forward_kinds) if forward_kinds is not None else None
@@ -140,9 +151,13 @@ def create_chat_router(
             }
         },
     )
-    async def chat_stream(req: ChatMessage) -> StreamingResponse:
+    async def chat_stream(req: ChatMessage, request: Request) -> StreamingResponse:
+        turn_request = request_factory(request) if request_factory else None
+
         async def stream() -> AsyncIterator[str]:
-            async for event in assistant.stream(req.message, req.session_id):
+            async for event in assistant.stream(
+                req.message, req.session_id, request=turn_request
+            ):
                 if forward is not None and event.kind not in forward:
                     continue
                 yield sse(names.get(event.kind, event.kind), dict(shaper(event)))

{reactifact-0.14.2 → reactifact-0.15.0/reactifact.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.14.2
+Version: 0.15.0
 Summary: Reactive, artifact-driven agent runtime: agents transform versioned, typed, provenance-aware artifacts inside an evolving context
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/bzdvdn/reactifact
@@ -55,7 +55,7 @@ Dynamic: license-file
 [![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://github.com/bzdvdn/reactifact)
 [![PyPI version](https://img.shields.io/pypi/v/reactifact)](https://pypi.org/project/reactifact/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/bzdvdn/reactifact)
+[![Ask DeepWiki](docs/img/deepwiki.svg)](https://deepwiki.com/bzdvdn/reactifact)
 [![Docs](https://img.shields.io/badge/docs-bzdvdn.github.io%2Freactifact-blue)](https://bzdvdn.github.io/reactifact/)
 
 > **Is:** a Python library (3 core deps) · single-process · typed, versioned artifacts with provenance · deterministic replay · runs offline, no API key

{reactifact-0.14.2 → reactifact-0.15.0}/tests/test_chat_web.py

@@ -157,6 +157,78 @@ def test_web_router_openapi_publishes_event_schema(tmp_path):
     assert "content" in responses["200"]["description"]
 
 
+def test_web_router_request_factory_forwards_per_turn_context(tmp_path):
+    """`request_factory` maps the FastAPI `Request` into the turn's `request=`."""
+    seen: dict[str, object] = {}
+
+    async def capture(call):
+        seen["user"] = call.request.get("user")
+        call.effects.create(A(text="answer"))
+        return None
+
+    prod = produce(A)(capture)
+    agent = create_agent("cap", consumes=[Consume(Q)], produces=[prod])
+    store = SessionStore(FileKVBackend(os.path.join(tmp_path, "sess")))
+    assistant = ChatAssistant(
+        store=store,
+        agents=[agent],
+        user_message=Q,
+        reply=lambda ctx, msg_id: {"reply": "ok", "waiting": False},
+        max_concurrency=1,
+    )
+
+    app = FastAPI()
+    app.include_router(
+        create_chat_router(
+            assistant,
+            request_factory=lambda request: {"user": request.headers.get("x-user", "")},
+        )
+    )
+    client = TestClient(app)
+
+    with client.stream(
+        "POST",
+        "/api/chat/stream",
+        json={"message": "hi", "session_id": "s1"},
+        headers={"X-User": "alice"},
+    ) as response:
+        "".join(response.iter_text())
+
+    assert seen["user"] == "alice"
+
+
+def test_web_router_without_request_factory_has_no_request(tmp_path):
+    """Default stays `request=None`: no behavior change for existing callers."""
+    seen: dict[str, object] = {}
+
+    async def capture(call):
+        seen["request"] = dict(call.request)
+        call.effects.create(A(text="answer"))
+        return None
+
+    prod = produce(A)(capture)
+    agent = create_agent("cap", consumes=[Consume(Q)], produces=[prod])
+    store = SessionStore(FileKVBackend(os.path.join(tmp_path, "sess")))
+    assistant = ChatAssistant(
+        store=store,
+        agents=[agent],
+        user_message=Q,
+        reply=lambda ctx, msg_id: {"reply": "ok", "waiting": False},
+        max_concurrency=1,
+    )
+
+    app = FastAPI()
+    app.include_router(create_chat_router(assistant))
+    client = TestClient(app)
+
+    with client.stream(
+        "POST", "/api/chat/stream", json={"message": "hi", "session_id": "s1"}
+    ) as response:
+        "".join(response.iter_text())
+
+    assert seen["request"] == {}
+
+
 def test_disconnect_cancels_the_running_turn(tmp_path):
     """A dropped SSE client must cancel in-flight work, not leave it burning.