reactifact 0.14.1__tar.gz → 0.15.0__tar.gz

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

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

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

{reactifact-0.14.1 → reactifact-0.15.0}/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.1 → reactifact-0.15.0}/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.1 → reactifact-0.15.0}/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.1 → reactifact-0.15.0}/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.1 → 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.1 → reactifact-0.15.0/reactifact.egg-info}/PKG-INFO

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

{reactifact-0.14.1 → reactifact-0.15.0}/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])