reactifact 0.14.0__tar.gz → 0.14.1__tar.gz

{reactifact-0.14.0/reactifact.egg-info → reactifact-0.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.14.0
+Version: 0.14.1
 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

{reactifact-0.14.0 → reactifact-0.14.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reactifact"
-version = "0.14.0"
+version = "0.14.1"
 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.0 → reactifact-0.14.1}/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.0"
+__version__ = "0.14.1"
 
 __all__ = [
     "Agent",

{reactifact-0.14.0 → reactifact-0.14.1}/reactifact/chat.py

@@ -38,7 +38,7 @@ from .consume import Consume
 from .context import Context
 from .events import Event
 from .resources import RuntimeResources
-from .runtime import Runtime
+from .runtime import Dispatcher, DispatchErrorHandler, Runtime
 from .session import Session, SessionStore
 
 logger = logging.getLogger("reactifact.chat")
@@ -306,6 +306,13 @@ class ChatAssistant:
     multi-stage pipeline routinely produces several generations per turn (see
     `Runtime.__init__`'s own docstring for the trade-off).
 
+    `dispatcher=` (and `on_dispatch_error=`) also passes straight through to
+    `Runtime`: give an agent that uses `effects.act(...)` a way to actually send
+    its outbound side effects from a chat turn, with the same once-per-stable-id
+    delivery `Runtime(dispatcher=...)` provides. Without it, a chat turn that
+    records a `PendingAction` leaves it `pending` (the runtime warns) for someone
+    to drain later.
+
     `resources=`/`create_message=` may optionally take the current turn's
     `session_id` — `resources=lambda session_id: build_resources(session_id)`
     (e.g. to attach an authenticated user looked up from the session) and
@@ -349,6 +356,8 @@ class ChatAssistant:
         on_agent_error: Callable[[Agent, Event, BaseException], None] | None = None,
         session_save_policy: Literal["per_commit", "per_turn"] = "per_commit",
         memory: ChatMemory | None = None,
+        dispatcher: Dispatcher | None = None,
+        on_dispatch_error: DispatchErrorHandler | None = None,
     ):
         self.store = store
         self._agents = agents
@@ -368,6 +377,8 @@ class ChatAssistant:
             session_save_policy
         )
         self._memory = memory
+        self._dispatcher = dispatcher
+        self._on_dispatch_error = on_dispatch_error
         # Serializes concurrent turns on the *same* session_id (a double
         # submit, a client retry): without this, two overlapping stream()
         # calls both load the same starting state and the later save() wins,
@@ -453,6 +464,8 @@ class ChatAssistant:
             isolate_errors=self._isolate_errors,
             on_agent_error=self._on_agent_error,
             session_save_policy=self._session_save_policy,
+            dispatcher=self._dispatcher,
+            on_dispatch_error=self._on_dispatch_error,
         )
 
     async def stream(

{reactifact-0.14.0 → reactifact-0.14.1}/reactifact/quick/chat.py

@@ -15,6 +15,7 @@ from ..checkpoints import FileKVBackend, InMemoryKVBackend
 from ..context import Context
 from ..providers import LLMProvider, from_env
 from ..resources import RuntimeResources
+from ..runtime import Dispatcher, DispatchErrorHandler
 from ..session import SessionStore
 from .models import Question
 
@@ -54,6 +55,8 @@ def chat_agent(
     resources: RuntimeResources | Callable[..., RuntimeResources] | None = None,
     budget: Budget | None = None,
     tracer: Any = None,
+    dispatcher: Dispatcher | None = None,
+    on_dispatch_error: DispatchErrorHandler | None = None,
 ) -> ChatAssistant:
     """A configured `ChatAssistant` — sessions, turns, history, out of the box.
 
@@ -79,6 +82,8 @@ def chat_agent(
         resources=resources,
         budget=budget,
         tracer=tracer,
+        dispatcher=dispatcher,
+        on_dispatch_error=on_dispatch_error,
     )
 
 

{reactifact-0.14.0 → reactifact-0.14.1}/reactifact/runtime.py

@@ -38,6 +38,8 @@ AgentResult = tuple[Patch | None, Agent, Event, list[Read], float, BaseException
 #: the intent is committed; the app performs the real I/O and returns (or
 #: raises). Must be idempotent on `idempotency_key` (§42).
 Dispatcher = Callable[[Context, Artifact[PendingAction]], Awaitable[None]]
+#: Called when the dispatcher raises (the action is already marked `failed`).
+DispatchErrorHandler = Callable[[Artifact[PendingAction], BaseException], None]
 
 
 @dataclass
@@ -93,9 +95,7 @@ class Runtime:
         on_agent_error: Callable[[Agent, Event, BaseException], None] | None = None,
         session_save_policy: Literal["per_commit", "per_turn"] = "per_commit",
         dispatcher: Dispatcher | None = None,
-        on_dispatch_error: (
-            Callable[[Artifact[PendingAction], BaseException], None] | None
-        ) = None,
+        on_dispatch_error: DispatchErrorHandler | None = None,
     ):
         self.context = context
         self.agents = agents or []

{reactifact-0.14.0 → reactifact-0.14.1/reactifact.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.14.0
+Version: 0.14.1
 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

{reactifact-0.14.0 → reactifact-0.14.1}/reactifact.egg-info/SOURCES.txt

@@ -192,6 +192,7 @@ tests/test_cache.py
 tests/test_canonical_ports.py
 tests/test_chat_example.py
 tests/test_chat_memory.py
+tests/test_chat_outbox.py
 tests/test_chat_web.py
 tests/test_checkpoint.py
 tests/test_checkpoints_concurrency.py

reactifact-0.14.1/tests/test_chat_outbox.py

@@ -0,0 +1,70 @@
+"""`ChatAssistant(dispatcher=...)` — outbound side effects from a chat turn."""
+
+from __future__ import annotations
+
+import asyncio
+
+from pydantic import BaseModel
+from reactifact import PendingAction
+from reactifact.agents import create_agent
+from reactifact.chat import ChatAssistant
+from reactifact.checkpoints import InMemoryKVBackend
+from reactifact.consume import Consume
+from reactifact.context import Context
+from reactifact.produce import Produce, ProduceCall
+from reactifact.session import SessionStore
+
+
+class _Msg(BaseModel):
+    text: str
+
+
+class _Reply(BaseModel):
+    text: str
+
+
+class _Notifier(Produce[_Reply]):
+    artifact_type = _Reply
+    also_creates = (PendingAction,)
+
+    async def produce(self, call: ProduceCall) -> None:
+        msg = call.trigger
+        if msg is None:
+            return
+        call.effects.act(
+            "notify", key=f"notify:{msg.data.text}", payload={"text": msg.data.text}
+        )
+        call.effects.create(_Reply(text=f"noted: {msg.data.text}"), id="reply:1")
+
+
+def _reply(ctx: Context, _message_id: str) -> dict[str, str]:
+    replies = ctx.list_artifacts(_Reply)
+    return {"reply": replies[-1].data.text if replies else ""}
+
+
+def test_chat_assistant_runs_the_outbox_dispatcher():
+    sent: list[str] = []
+
+    async def dispatcher(context: Context, action) -> None:
+        sent.append(action.data.idempotency_key)
+
+    store = SessionStore(InMemoryKVBackend())
+    assistant = ChatAssistant(
+        store=store,
+        agents=[
+            create_agent("notify", consumes=[Consume(_Msg)], produces=[_Notifier()])
+        ],
+        user_message=_Msg,
+        reply=_reply,
+        dispatcher=dispatcher,
+    )
+
+    result = asyncio.run(assistant.invoke("hi", session_id="s1"))
+
+    assert result["reply"] == "noted: hi"
+    assert sent == ["notify:hi"]
+
+    session = asyncio.run(store.open("s1"))
+    action = session.context.get("action:notify:hi")
+    assert action is not None
+    assert action.data.status == "dispatched"