reactifact 0.14.0__tar.gz → 0.14.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.14.0
+Version: 0.14.2
 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.2}/pyproject.toml

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

{reactifact-0.14.0 → reactifact-0.14.2}/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.2}/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.2}/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.2}/reactifact/tracing/templates/sessions.html

@@ -4,22 +4,22 @@
 <meta charset="utf-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1"/>
 <title>reactifact sessions</title>
-<link rel="stylesheet" href="/traces/assets/app.css"/>
+<link rel="stylesheet" href="__BASE__/traces/assets/app.css"/>
 <script>(function(){try{var s=localStorage.getItem('reactifact-theme');var d=s?s==='dark':window.matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.classList.toggle('dark',d);}catch(e){document.documentElement.classList.add('dark');}})();</script>
 </head>
 <body>
 <div class="app" id="app">
   <aside class="sidebar">
-    <a class="brand" href="/traces">
+    <a class="brand" href="__BASE__/traces">
       <svg width="22" height="22" viewBox="0 0 24 24" fill="none" aria-hidden="true"><circle cx="5" cy="12" r="2.6" fill="currentColor"/><circle cx="19" cy="5" r="2.6" fill="currentColor"/><circle cx="19" cy="19" r="2.6" fill="currentColor"/><path d="M7.4 11 16.6 6M7.4 13l9.2 5" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
       <span class="name">reactifact <em>traces</em></span>
     </a>
     <nav class="nav">
-      <a class="nav-item" href="/traces">
+      <a class="nav-item" href="__BASE__/traces">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="5" cy="12" r="2.2"/><circle cx="19" cy="5" r="2.2"/><circle cx="19" cy="19" r="2.2"/><path d="M7.2 11 16.8 6M7.2 13l9.6 5"/></svg>
         <span class="nav-label">Traces</span>
       </a>
-      <a class="nav-item active" href="/sessions">
+      <a class="nav-item active" href="__BASE__/sessions">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16v11H8l-4 4z"/></svg>
         <span class="nav-label">Sessions</span>
       </a>
@@ -97,7 +97,7 @@ async function load(){
   const p=new URLSearchParams({limit:state.limit,offset:state.offset});
   if(state.q)p.set('q',state.q);
   try{
-    const res=await fetch('/api/sessions?'+p);
+    const res=await fetch('__BASE__/api/sessions?'+p);
     if(!res.ok)throw new Error('HTTP '+res.status);
     const data=await res.json();
     state.items=data.items||[];state.total=data.total||0;render();
@@ -133,7 +133,7 @@ function updatePager(){
 }
 document.getElementById('rows').addEventListener('click',(e)=>{
   const row=e.target.closest('tr.row');if(!row)return;
-  window.location.href='/traces?session_id='+encodeURIComponent(row.dataset.id);
+  window.location.href='__BASE__/traces?session_id='+encodeURIComponent(row.dataset.id);
 });
 document.getElementById('f-q').addEventListener('input',debounce((e)=>{state.q=e.target.value.trim();state.offset=0;load();}));
 document.getElementById('prev').addEventListener('click',()=>{state.offset=Math.max(0,state.offset-state.limit);load();});

{reactifact-0.14.0 → reactifact-0.14.2}/reactifact/tracing/templates/ui.html

@@ -4,22 +4,22 @@
 <meta charset="utf-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1"/>
 <title>reactifact traces</title>
-<link rel="stylesheet" href="/traces/assets/app.css"/>
+<link rel="stylesheet" href="__BASE__/traces/assets/app.css"/>
 <script>(function(){try{var s=localStorage.getItem('reactifact-theme');var d=s?s==='dark':window.matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.classList.toggle('dark',d);}catch(e){document.documentElement.classList.add('dark');}})();</script>
 </head>
 <body>
 <div class="app" id="app">
   <aside class="sidebar">
-    <a class="brand" href="/traces">
+    <a class="brand" href="__BASE__/traces">
       <svg width="22" height="22" viewBox="0 0 24 24" fill="none" aria-hidden="true"><circle cx="5" cy="12" r="2.6" fill="currentColor"/><circle cx="19" cy="5" r="2.6" fill="currentColor"/><circle cx="19" cy="19" r="2.6" fill="currentColor"/><path d="M7.4 11 16.6 6M7.4 13l9.2 5" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
       <span class="name">reactifact <em>traces</em></span>
     </a>
     <nav class="nav">
-      <a class="nav-item active" href="/traces">
+      <a class="nav-item active" href="__BASE__/traces">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="5" cy="12" r="2.2"/><circle cx="19" cy="5" r="2.2"/><circle cx="19" cy="19" r="2.2"/><path d="M7.2 11 16.8 6M7.2 13l9.6 5"/></svg>
         <span class="nav-label">Traces</span>
       </a>
-      <a class="nav-item" href="/sessions">
+      <a class="nav-item" href="__BASE__/sessions">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16v11H8l-4 4z"/></svg>
         <span class="nav-label">Sessions</span>
       </a>
@@ -188,7 +188,7 @@ function loadColumnPref(){try{const raw=localStorage.getItem(COLS_KEY);VISIBLE_C
 function saveColumnPref(){try{localStorage.setItem(COLS_KEY,JSON.stringify(VISIBLE_COLS||[]));}catch(_){}}
 function visibleColumns(){const all=state.columns.map(c=>c.label);if(VISIBLE_COLS===null)return all;return all.filter(l=>VISIBLE_COLS.includes(l));}
 async function loadColumns(){
-  try{const r=await fetch('/api/columns');state.columns=(await r.json()).items||[];}
+  try{const r=await fetch('__BASE__/api/columns');state.columns=(await r.json()).items||[];}
   catch(_){state.columns=[];}
   render();
 }
@@ -287,7 +287,7 @@ function filters(){
 }
 
 async function loadFacets(){
-  try{const r=await fetch('/api/tags');const d=await r.json();state.facets=d.items||[];}
+  try{const r=await fetch('__BASE__/api/tags');const d=await r.json();state.facets=d.items||[];}
   catch(_){state.facets=[];}
   renderFacets();
 }
@@ -308,7 +308,7 @@ function renderFacets(){
 async function load(){
   const q=filters();q.set('limit',state.limit);q.set('offset',state.offset);
   try{
-    const res=await fetch('/api/traces?'+q);
+    const res=await fetch('__BASE__/api/traces?'+q);
     if(!res.ok)throw new Error('HTTP '+res.status);
     const data=await res.json();
     state.runs=data.items||[];state.total=data.total||0;state.stats=data.stats||null;
@@ -454,7 +454,7 @@ document.getElementById('view-del').addEventListener('click',()=>{
   const sel=document.getElementById('views');if(sel.value==='')return;
   const views=getViews();views.splice(Number(sel.value),1);setViews(views);renderViews();toast('View deleted');
 });
-document.getElementById('export').addEventListener('click',()=>{const q=filters();q.set('limit',500);window.location.href='/api/traces/export?'+q;});
+document.getElementById('export').addEventListener('click',()=>{const q=filters();q.set('limit',500);window.location.href='__BASE__/api/traces/export?'+q;});
 document.getElementById('live').addEventListener('click',(e)=>{
   state.live=!state.live;e.currentTarget.classList.toggle('on',state.live);
   if(state.live){timer=setInterval(()=>{if(!document.hidden)load();},3000);}else{clearInterval(timer);}
@@ -462,7 +462,7 @@ document.getElementById('live').addEventListener('click',(e)=>{
 document.getElementById('runs').addEventListener('click',(e)=>{
   if(e.target.closest('.rowcheck'))return;
   const row=e.target.closest('tr.row');if(!row)return;
-  window.location.href='/traces/'+row.dataset.id;
+  window.location.href='__BASE__/traces/'+row.dataset.id;
 });
 document.getElementById('runs').addEventListener('change',(e)=>{
   const c=e.target.closest('.rowcheck');if(!c)return;
@@ -476,13 +476,13 @@ document.getElementById('bulk-clear').addEventListener('click',()=>{state.select
 document.getElementById('bulk-apply').addEventListener('click',async()=>{
   const tag=document.getElementById('bulk-tag').value.trim();if(!tag)return;
   const note=document.getElementById('bulk-note').value;
-  await fetch('/api/traces/tags',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({run_ids:Array.from(state.selected),tag:tag,note:note})});
+  await fetch('__BASE__/api/traces/tags',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({run_ids:Array.from(state.selected),tag:tag,note:note})});
   document.getElementById('bulk-tag').value='';document.getElementById('bulk-note').value='';
   state.selected.clear();toast('Tagged');await refresh();
 });
 document.getElementById('bulk-remove').addEventListener('click',async()=>{
   const tag=document.getElementById('bulk-remove-sel').value;if(!tag)return;
-  await fetch('/api/traces/tags/remove',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({run_ids:Array.from(state.selected),tag:tag})});
+  await fetch('__BASE__/api/traces/tags/remove',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({run_ids:Array.from(state.selected),tag:tag})});
   state.selected.clear();toast('Tag removed');await refresh();
 });
 
@@ -507,18 +507,18 @@ document.getElementById('tagrows').addEventListener('click',async(e)=>{
   if(e.target.closest('.row-save')){
     const name=row.querySelector('.row-name').value.trim();
     const color=row.querySelector('.row-color').value;
-    await fetch('/api/tags/'+encodeURIComponent(old),{method:'PATCH',headers:{'Content-Type':'application/json'},body:JSON.stringify({new_name:name,color:color})});
+    await fetch('__BASE__/api/tags/'+encodeURIComponent(old),{method:'PATCH',headers:{'Content-Type':'application/json'},body:JSON.stringify({new_name:name,color:color})});
     await refresh();renderTagRows();toast('Tag updated');
   }else if(e.target.closest('.row-del')){
     if(!confirm('Delete tag "'+old+'" from every run?'))return;
-    await fetch('/api/tags/'+encodeURIComponent(old),{method:'DELETE'});
+    await fetch('__BASE__/api/tags/'+encodeURIComponent(old),{method:'DELETE'});
     await refresh();renderTagRows();toast('Tag deleted');
   }
 });
 document.getElementById('new-tag-add').addEventListener('click',async()=>{
   const name=document.getElementById('new-tag-name').value.trim();if(!name)return;
   const color=document.getElementById('new-tag-color').value;
-  await fetch('/api/tags',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({name:name,color:color})});
+  await fetch('__BASE__/api/tags',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({name:name,color:color})});
   document.getElementById('new-tag-name').value='';await refresh();renderTagRows();toast('Tag added');
 });
 

{reactifact-0.14.0 → reactifact-0.14.2}/reactifact/tracing/templates/ui_run.html

@@ -4,22 +4,22 @@
 <meta charset="utf-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1"/>
 <title>reactifact trace</title>
-<link rel="stylesheet" href="/traces/assets/app.css"/>
+<link rel="stylesheet" href="__BASE__/traces/assets/app.css"/>
 <script>(function(){try{var s=localStorage.getItem('reactifact-theme');var d=s?s==='dark':window.matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.classList.toggle('dark',d);}catch(e){document.documentElement.classList.add('dark');}})();</script>
 </head>
 <body>
 <div class="app" id="app">
   <aside class="sidebar">
-    <a class="brand" href="/traces">
+    <a class="brand" href="__BASE__/traces">
       <svg width="22" height="22" viewBox="0 0 24 24" fill="none" aria-hidden="true"><circle cx="5" cy="12" r="2.6" fill="currentColor"/><circle cx="19" cy="5" r="2.6" fill="currentColor"/><circle cx="19" cy="19" r="2.6" fill="currentColor"/><path d="M7.4 11 16.6 6M7.4 13l9.2 5" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
       <span class="name">reactifact <em>traces</em></span>
     </a>
     <nav class="nav">
-      <a class="nav-item active" href="/traces">
+      <a class="nav-item active" href="__BASE__/traces">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="5" cy="12" r="2.2"/><circle cx="19" cy="5" r="2.2"/><circle cx="19" cy="19" r="2.2"/><path d="M7.2 11 16.8 6M7.2 13l9.6 5"/></svg>
         <span class="nav-label">Traces</span>
       </a>
-      <a class="nav-item" href="/sessions">
+      <a class="nav-item" href="__BASE__/sessions">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16v11H8l-4 4z"/></svg>
         <span class="nav-label">Sessions</span>
       </a>
@@ -42,7 +42,7 @@
       <button class="icon-btn" id="menu-btn" aria-label="open navigation">
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M3 6h18M3 12h18M3 18h18"/></svg>
       </button>
-      <div class="crumb"><a href="/traces">traces</a><span class="sep">/</span><b id="cid">#…</b><span id="head"></span></div>
+      <div class="crumb"><a href="__BASE__/traces">traces</a><span class="sep">/</span><b id="cid">#…</b><span id="head"></span></div>
       <div class="spacer"></div>
       <button class="btn sm" id="copy-link"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10 13a5 5 0 0 0 7.1 0l3-3a5 5 0 0 0-7.1-7.1L11 4.9"/><path d="M14 11a5 5 0 0 0-7.1 0l-3 3A5 5 0 0 0 11 21.1l1.9-1.9"/></svg><span data-label>link</span></button>
       <button class="btn sm" id="copy-json"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="12" height="12" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg><span data-label>json</span></button>
@@ -104,7 +104,7 @@ function toast(msg){let t=document.getElementById('toast');if(!t){t=document.cre
 
 async function load(){
   try{
-    const res=await fetch('/api/traces/'+RUN_ID);
+    const res=await fetch('__BASE__/api/traces/'+RUN_ID);
     if(res.status===404){document.getElementById('cid').textContent='#'+RUN_ID+' — not found';return;}
     if(!res.ok)throw new Error('HTTP '+res.status);
     render(await res.json());
@@ -122,7 +122,7 @@ function hex(c){return /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(
 let VOCAB=[];
 let CURRENT=[];
 async function loadVocab(){
-  try{const r=await fetch('/api/tags');const d=await r.json();VOCAB=(d.items||[]).map(x=>x.name);}
+  try{const r=await fetch('__BASE__/api/tags');const d=await r.json();VOCAB=(d.items||[]).map(x=>x.name);}
   catch(_){VOCAB=[];}
   const dl=document.getElementById('taglist');
   if(dl)dl.innerHTML=VOCAB.map(n=>'<option value="'+escapeHtml(n)+'">').join('');
@@ -152,18 +152,18 @@ function renderAnnot(list){
   document.getElementById('annot-note').addEventListener('keydown',(e)=>{if(e.key==='Enter'){e.preventDefault();addTag();}});
 }
 async function reloadTrace(){
-  const res=await fetch('/api/traces/'+RUN_ID);
+  const res=await fetch('__BASE__/api/traces/'+RUN_ID);
   if(res.ok)renderAnnot((await res.json()).annotations||[]);
   await loadVocab();
 }
 async function addTag(){
   const tag=document.getElementById('annot-tag').value.trim();if(!tag)return;
   const note=document.getElementById('annot-note').value;
-  await fetch('/api/traces/'+RUN_ID+'/tags',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({tag:tag,note:note})});
+  await fetch('__BASE__/api/traces/'+RUN_ID+'/tags',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({tag:tag,note:note})});
   toast('Tag added');await reloadTrace();
 }
 async function removeTag(tag){
-  await fetch('/api/traces/'+RUN_ID+'/tags/'+encodeURIComponent(tag),{method:'DELETE'});
+  await fetch('__BASE__/api/traces/'+RUN_ID+'/tags/'+encodeURIComponent(tag),{method:'DELETE'});
   toast('Tag removed');await reloadTrace();
 }
 

{reactifact-0.14.0 → reactifact-0.14.2}/reactifact/tracing/web.py

@@ -33,11 +33,41 @@ from .columns import TraceColumn
 from .store import TraceStoreProtocol
 
 if TYPE_CHECKING:
-    from fastapi import APIRouter
+    from fastapi import APIRouter, Request
 
 _TEMPLATES = Path(__file__).parent / "templates"
 
 
+def _mount_base(request: Request, logical_path: str) -> str:
+    """Path prefix this router is mounted under — ``include_router(prefix=…)``
+    and/or the ASGI ``root_path`` — so templates can emit prefix-aware
+    absolute URLs (``/*`` links and ``fetch`` paths) instead of assuming the
+    service sits at the origin root.
+
+    The prefix is everything before the *last* occurrence of this route's first
+    logical segment (``/traces`` / ``/sessions``) in the request path. The last
+    occurrence — not the first — because the mount prefix may itself contain
+    that segment (``prefix="/api/traces"`` → ``/api/traces/traces``), while the
+    route's own segment is always the one nearest the path parameters.
+    """
+    root_path = request.scope.get("root_path", "") or ""
+    marker = "/" + logical_path.strip("/").split("/")[0]
+    index = request.url.path.rfind(marker)
+    return root_path + (request.url.path[:index] if index > 0 else "")
+
+
+def _render_page(
+    request: Request, filename: str, logical_path: str, **replacements: str
+) -> str:
+    """Read a UI template and fill ``__BASE__`` (mount prefix) plus any
+    caller placeholders (e.g. ``__RUN_ID__``)."""
+    text = (_TEMPLATES / filename).read_text(encoding="utf-8")
+    text = text.replace("__BASE__", _mount_base(request, logical_path))
+    for key, value in replacements.items():
+        text = text.replace(key, value)
+    return text
+
+
 class TagAssign(BaseModel):
     tag: str = Field(min_length=1, max_length=64)
     note: str = ""
@@ -93,8 +123,13 @@ def create_trace_router(
 
     require_extra("tracing.web.create_trace_router", "fastapi", "web")
 
-    from fastapi import APIRouter, Depends, HTTPException, Query
+    from fastapi import APIRouter, Depends, HTTPException, Query, Request
     from fastapi.responses import HTMLResponse, JSONResponse, Response
+
+    # `from __future__ import annotations` keeps every hint a string, resolved
+    # against this module's globals at decoration time; fastapi is imported
+    # lazily here, so publish the names the page handlers annotate with.
+    globals()["Request"] = Request
     from fastapi.security import HTTPBasic, HTTPBasicCredentials
 
     dependencies = []
@@ -286,26 +321,27 @@ def create_trace_router(
         )
 
     @router.get("/traces", response_class=HTMLResponse)
-    async def traces_list_page() -> str:
-        return (_TEMPLATES / "ui.html").read_text(encoding="utf-8")
+    async def traces_list_page(request: Request) -> str:
+        return _render_page(request, "ui.html", "/traces")
 
     @router.get("/sessions", response_class=HTMLResponse)
-    async def sessions_list_page() -> str:
-        return (_TEMPLATES / "sessions.html").read_text(encoding="utf-8")
+    async def sessions_list_page(request: Request) -> str:
+        return _render_page(request, "sessions.html", "/sessions")
 
     @router.get("/traces/{trace_id}", response_class=HTMLResponse)
-    async def traces_run_page(trace_id: str) -> str:
+    async def traces_run_page(request: Request, trace_id: str) -> str:
         from ..viz import trace_provenance_to_mermaid, trace_to_mermaid
 
         trace = await store.get(trace_id)
         mermaid = trace_to_mermaid(trace) if trace is not None else ""
         provenance = trace_provenance_to_mermaid(trace) if trace is not None else ""
-        return (
-            (_TEMPLATES / "ui_run.html")
-            .read_text(encoding="utf-8")
-            .replace("__RUN_ID__", json.dumps(trace_id))
-            .replace("__MERMAID__", json.dumps(mermaid))
-            .replace("__MERMAID_GRAPH__", json.dumps(provenance))
+        return _render_page(
+            request,
+            "ui_run.html",
+            "/traces/{trace_id}",
+            __RUN_ID__=json.dumps(trace_id),
+            __MERMAID__=json.dumps(mermaid),
+            __MERMAID_GRAPH__=json.dumps(provenance),
         )
 
     return router

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.14.0
+Version: 0.14.2
 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.2}/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.2/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"

{reactifact-0.14.0 → reactifact-0.14.2}/tests/test_tracing.py

@@ -1,5 +1,6 @@
 import asyncio
 import json
+import re
 
 from pydantic import BaseModel
 from reactifact import Agent, Consume, Context, Patch, Runtime, RuntimeResources
@@ -868,3 +869,86 @@ def test_recording_llm_prompt_hash_defaults_empty():
     llm = RecordingLLM(FakeLLM("x"), on_call=recorded.append, agent_of=lambda: "a")
     asyncio.run(llm.complete(LLMRequest(messages=[Message.user("hi")])))
     assert recorded[0].prompt_hash == ""
+
+
+def test_trace_pages_are_prefix_aware(tmp_path):
+    from fastapi import FastAPI
+    from fastapi.testclient import TestClient
+    from reactifact.tracing.web import create_trace_router
+
+    store = TraceStore(str(tmp_path / "prefix.db"))
+    run(store.export(RunTrace(id="r1", session_id="s", outcome="completed")))
+    app = FastAPI()
+    app.include_router(create_trace_router(store), prefix="/ai")
+    client = TestClient(app)
+
+    listing = client.get("/ai/traces")
+    assert listing.status_code == 200
+    html = listing.text
+    assert "__BASE__" not in html
+    assert 'href="/ai/traces/assets/app.css"' in html
+    assert 'href="/ai/traces"' in html
+    assert 'href="/ai/sessions"' in html
+    assert "'/ai/api/traces" in html
+    assert "'/ai/api/columns" in html
+    assert "'/ai/traces/'" in html
+
+    sessions = client.get("/ai/sessions").text
+    assert "__BASE__" not in sessions
+    assert "'/ai/api/sessions" in sessions
+    assert 'href="/ai/traces"' in sessions
+
+    run_page = client.get("/ai/traces/r1").text
+    assert "__BASE__" not in run_page
+    assert "'/ai/api/traces/" in run_page
+    assert 'href="/ai/traces/assets/app.css"' in run_page
+
+
+def test_trace_pages_without_prefix_keep_root_paths(tmp_path):
+    from fastapi import FastAPI
+    from fastapi.testclient import TestClient
+    from reactifact.tracing.web import create_trace_router
+
+    store = TraceStore(str(tmp_path / "root.db"))
+    app = FastAPI()
+    app.include_router(create_trace_router(store))
+    client = TestClient(app)
+    html = client.get("/traces").text
+    assert "__BASE__" not in html
+    assert 'href="/traces/assets/app.css"' in html
+    assert "'/api/traces" in html
+
+
+def test_trace_pages_honor_asgi_root_path(tmp_path):
+    from fastapi import FastAPI
+    from fastapi.testclient import TestClient
+    from reactifact.tracing.web import create_trace_router
+
+    store = TraceStore(str(tmp_path / "rootpath.db"))
+    app = FastAPI(root_path="/ai")
+    app.include_router(create_trace_router(store))
+    client = TestClient(app)
+    html = client.get("/traces").text
+    assert "__BASE__" not in html
+    assert 'href="/ai/traces/assets/app.css"' in html
+    assert "'/ai/api/traces" in html
+
+
+def test_trace_pages_stay_prefixed_when_prefix_contains_a_route_segment(tmp_path):
+    """A mount prefix that itself contains ``/traces`` (or ``/sessions``) must
+    not confuse the base: every absolute ref stays inside the prefix."""
+    from fastapi import FastAPI
+    from fastapi.testclient import TestClient
+    from reactifact.tracing.web import create_trace_router
+
+    store = TraceStore(str(tmp_path / "tricky.db"))
+    run(store.export(RunTrace(id="r1", session_id="s", outcome="completed")))
+    for prefix in ("/api/traces", "/traces-app", "/sessions", "/traces"):
+        app = FastAPI()
+        app.include_router(create_trace_router(store), prefix=prefix)
+        client = TestClient(app)
+        for logical in ("/traces", "/sessions", "/traces/r1"):
+            html = client.get(prefix + logical).text
+            assert "__BASE__" not in html
+            refs = re.findall(r'(?:href="|fetch\(\')(/[^"\'?]*)', html)
+            assert all(u.startswith(prefix) for u in refs), (prefix, logical, refs[:5])