execweave 0.8.3__tar.gz → 0.8.4__tar.gz

{execweave-0.8.3 → execweave-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: execweave
-Version: 0.8.3
+Version: 0.8.4
 Summary: Turn AI-agent runtime behavior into a local interactive execution graph.
 Project-URL: Homepage, https://github.com/Irish-kw/ExecWeave
 Project-URL: Repository, https://github.com/Irish-kw/ExecWeave
@@ -83,7 +83,7 @@ ExecWeave is a source-available, local-first observability project that turns AI
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-This README documents **v0.8.3**.
+This README documents **v0.8.4**.
 
 ## Why ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/README.de.md

@@ -30,7 +30,7 @@ ExecWeave ist ein source-available, local-first Observability-Projekt, das Aktiv
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-Dieses README dokumentiert **v0.8.3**.
+Dieses README dokumentiert **v0.8.4**.
 
 ## Warum ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/README.fr.md

@@ -30,7 +30,7 @@ ExecWeave est un projet d’observabilité source-available et local-first qui t
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-Ce README décrit **v0.8.3**.
+Ce README décrit **v0.8.4**.
 
 ## Pourquoi ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/README.ja.md

@@ -30,7 +30,7 @@ ExecWeave は source-available / local-first の observability プロジェク
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-この README は **v0.8.3** を説明します。
+この README は **v0.8.4** を説明します。
 
 ## ExecWeave を使う理由
 

{execweave-0.8.3 → execweave-0.8.4}/README.ko.md

@@ -30,7 +30,7 @@ ExecWeave는 source-available, local-first observability 프로젝트입니다.
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-이 README는 **v0.8.3**을 설명합니다.
+이 README는 **v0.8.4**을 설명합니다.
 
 ## 왜 ExecWeave인가
 

{execweave-0.8.3 → execweave-0.8.4}/README.md

@@ -30,7 +30,7 @@ ExecWeave is a source-available, local-first observability project that turns AI
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-This README documents **v0.8.3**.
+This README documents **v0.8.4**.
 
 ## Why ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/README.ru.md

@@ -30,7 +30,7 @@ ExecWeave — source-available, local-first проект наблюдаемос
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-Этот README описывает **v0.8.3**.
+Этот README описывает **v0.8.4**.
 
 ## Почему ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/README.zh-CN.md

@@ -30,7 +30,7 @@ ExecWeave 是一个 source-available、local-first 的可观测性项目，把 A
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-本 README 对应 **v0.8.3**。
+本 README 对应 **v0.8.4**。
 
 ## 为什么是 ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/README.zh-TW.md

@@ -30,7 +30,7 @@ ExecWeave 是一個 source-available、local-first 的可觀測性專案，會
   <img src="docs/assets/codex.gif" alt="ExecWeave animated live demo" width="100%">
 </p>
 
-本 README 對應 **v0.8.3**。
+本 README 對應 **v0.8.4**。
 
 ## 為什麼是 ExecWeave
 

{execweave-0.8.3 → execweave-0.8.4}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "execweave"
-# ExecWeave v0.8.3 release metadata
-version = "0.8.3"
+# ExecWeave v0.8.4 release metadata
+version = "0.8.4"
 description = "Turn AI-agent runtime behavior into a local interactive execution graph."
 readme = "README.md"
 requires-python = ">=3.10"

{execweave-0.8.3 → execweave-0.8.4}/src/execweave/__init__.py

@@ -1,3 +1,3 @@
 """ExecWeave runtime graph package."""
 
-__version__ = "0.8.3"
+__version__ = "0.8.4"

{execweave-0.8.3 → execweave-0.8.4}/src/execweave/antigravity_full_fidelity.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from typing import Any
 
 from . import antigravity_full_fidelity_collaboration_base as _base
+from .agent_topology import EVIDENCE_VALIDATED_CHILD_TRANSCRIPT, subagent_topology
 from .antigravity_subagent_linkage import validated_subagent_links
 from .content_evidence import content_observation_event
 from .content_store import FullFidelityContentStore
@@ -51,18 +52,23 @@ def _assignment_event(
             "identity_semantics": "provider_invoke_subagent_spec_index",
         },
     )
+    child_label = role or type_name or "Antigravity subagent"
     child = _entity(
         "agent",
         f"agent:antigravity:conversation:{child_id}",
-        name=role or type_name or "Antigravity subagent",
+        name=child_label,
         attributes={
             "provider": "antigravity",
             "conversation_id": child_id,
-            "agent_path": f"/root/{child_id}",
-            "agent_type": role or type_name or "Antigravity subagent",
+            "agent_type": child_label,
+            "agent_nickname": role or type_name,
             "identity_semantics": "provider_transcript_result_conversation_id",
             "execution_observed": False,
             "lifecycle_authority": "child_provider_hooks",
+            **subagent_topology(
+                evidence=EVIDENCE_VALIDATED_CHILD_TRANSCRIPT,
+                parent_scope_id=conversation_id,
+            ),
         },
     )
     return {

{execweave-0.8.3 → execweave-0.8.4}/src/execweave/dashboard_shell.py

@@ -9,39 +9,17 @@ from .viewer_dashboard_clean import fold_budget_bootstrap, inject_live_dashboard
 from .viewer_dashboard_focus import inject_live_dashboard_focus
 from .viewer_live_layout import inject_live_dashboard_layout
 
-_AGENT_PANEL_TOPOLOGY_OLD = (
-    "const path=nodePath(node),preview=recordFor(node)?.conversation_preview||{},"
-    "messages=Array.isArray(preview.messages)?preview.messages:[];\n"
-    "  const isRoot=path==='/root'||attrs(node).agent_role==='root'||"
-    "attrs(node).root_agent_path==='/root';"
-)
-_AGENT_PANEL_TOPOLOGY_NEW = (
-    "const preview=recordFor(node)?.conversation_preview||{},"
-    "previewPath=String(preview.agent_path||'').trim();\n"
-    "  const path=previewPath||nodePath(node),"
-    "messages=Array.isArray(preview.messages)?preview.messages:[];\n"
-    "  const isRoot=preview.is_root===true||path==='/root'||"
-    "attrs(node).agent_role==='root'||attrs(node).root_agent_path==='/root';"
-)
-
 
 def _align_agent_panel_topology(html: str) -> str:
-    """Render conversation topology without upgrading graph provenance.
+    """Keep the agent panel's identity/topology authority intact.
 
-    A transcript can conservatively resolve to the observed run root because no
-    positive parent evidence exists. That derived presentation fact belongs to the
-    conversation preview; copying it back onto the graph would incorrectly turn it
-    into provider evidence. The panel therefore consumes the preview's resolved path
-    and root flag when choosing its round renderer while leaving graph attributes
-    untouched.
+    The panel owns the provider-neutral rule: exact conversation identity selects
+    content, while only explicit/root-provenance evidence selects the root renderer.
+    Rewriting that code here used to promote every derived ``/root`` preview back into
+    a canonical root and reintroduced cross-conversation aggregation. The shared shell
+    therefore no longer carries a second topology policy.
     """
-    if _AGENT_PANEL_TOPOLOGY_OLD not in html:
-        raise RuntimeError("agent panel topology seam changed")
-    return html.replace(
-        _AGENT_PANEL_TOPOLOGY_OLD,
-        _AGENT_PANEL_TOPOLOGY_NEW,
-        1,
-    )
+    return html
 
 
 def _build_dashboard_html() -> str:

{execweave-0.8.3 → execweave-0.8.4}/src/execweave/viewer_agent_panel.py

@@ -29,16 +29,23 @@ if(!details||!detailsEmpty)return;
 let entries=Array.isArray(window.__execweaveStaticConversations)?window.__execweaveStaticConversations:[];
 let selectedNode=null,refreshing=false,selectedConversationSignature='';
 const foldStateByAgent=new Map();
+const ROOT_NODE_IDS=new Set(['agent:Claude Code','agent:OpenAI Codex','agent:Codex','agent:Cursor','agent:OpenCode','agent:Gemini CLI','agent:Antigravity']);
 const ENCRYPTED_NOTICE='Observed — plaintext not exposed by provider.';
 const attrs=node=>node&&typeof node.attributes==='object'&&node.attributes?node.attributes:{};
 const nodePath=node=>String(attrs(node).agent_path||attrs(node).child_agent_path||attrs(node).root_agent_path||node?.name||'').trim();
-const agentKey=node=>nodePath(node)||String(node?.id||'');
+const agentKey=node=>String(node?.id||'')||nodePath(node);
 const messageText=message=>typeof message?.text==='string'?message.text.trim():'';
 const isEncrypted=message=>String(message?.content_state||'')==='provider_encrypted';
 const isObserved=message=>!!message&&(isEncrypted(message)||!!messageText(message));
 const displayText=message=>isEncrypted(message)?ENCRYPTED_NOTICE:messageText(message);
 const isInjected=message=>String(message?.content_role||'')==='shared_injected_context';
 const own=(message,path)=>!message?.sender||String(message.sender)===path;
+const previewHasRootAuthority=preview=>!!preview&&preview.is_root===true&&String(preview.topology_state||'')!=='derived'&&String(preview.topology_evidence||'')!=='no_parent_evidence_observed';
+const previewUsesRootRenderer=preview=>!!preview&&preview.is_root===true&&String(preview.agent_path||'')==='/root';
+const nodeHasChildAuthority=node=>!!String(attrs(node).parent_agent_path||'').trim();
+const legacyRootSignal=(node,path)=>path==='/root'||attrs(node).agent_role==='root'||attrs(node).root_agent_path==='/root';
+const nodeHasRootAuthority=node=>!nodeHasChildAuthority(node)&&(legacyRootSignal(node,nodePath(node))||ROOT_NODE_IDS.has(String(node?.id||'')));
+const entryHasRootAuthority=entry=>ROOT_NODE_IDS.has(String(entry?.source_id||''))||previewHasRootAuthority(entry?.conversation_preview);
 function messageKey(message){return JSON.stringify([message?.timestamp??null,message?.ordinal??null,message?.sender??null,message?.recipient??null,message?.kind??null,message?.phase??null,message?.content_state??null,message?.content_role??null,messageText(message)])}
 function messageOrder(message,index){const stamp=String(message?.timestamp||''),ordinal=Number.isInteger(message?.ordinal)?message.ordinal:Number.MAX_SAFE_INTEGER;return{message,index,stamp,ordinal}}
 function aggregate(matches){
@@ -52,11 +59,30 @@ function aggregate(matches){
   return{...base,conversation_preview:{...preview,messages:ordered.map(item=>item.message)}};
 }
 function recordFor(node){
-  const path=nodePath(node),nodeId=String(node?.id||'');
-  return aggregate(entries.filter(entry=>String(entry?.source_id||'')===nodeId||String(entry?.conversation_preview?.agent_path||'')===path));
+  const nodeId=String(node?.id||'');
+  const exact=nodeId?entries.filter(entry=>String(entry?.source_id||'')===nodeId):[];
+  if(exact.length)return aggregate(exact);
+  const path=nodePath(node);if(!path)return null;
+  return aggregate(entries.filter(entry=>{
+    const preview=entry?.conversation_preview;
+    if(!preview||!(String(entry?.conversation_preview?.agent_path||'')===path))return false;
+    if(String(preview.topology_state||'')==='derived')return false;
+    if(path==='/root'&&!entryHasRootAuthority(entry))return false;
+    return true;
+  }));
+}
+function canonicalRootRecord(){
+  const roots=entries.filter(entryHasRootAuthority);
+  const sourceIds=[...new Set(roots.map(entry=>String(entry?.source_id||'')).filter(Boolean))];
+  if(sourceIds.length!==1)return null;
+  return aggregate(roots.filter(entry=>String(entry?.source_id||'')===sourceIds[0]));
 }
 function recordForPath(path){
-  return aggregate(entries.filter(entry=>String(entry?.conversation_preview?.agent_path||'')===String(path)));
+  if(String(path)==='/root')return canonicalRootRecord();
+  return aggregate(entries.filter(entry=>{
+    const preview=entry?.conversation_preview;
+    return !!preview&&String(entry?.conversation_preview?.agent_path||'')===String(path)&&String(preview.topology_state||'')!=='derived';
+  }));
 }
 function conversationSignature(node){
   if(!node||String(node.type||'')!=='agent')return '';
@@ -81,13 +107,14 @@ function summarise(text){const line=String(text||'').split('\n').map(part=>part.
 // The root's rounds are the boundaries: a round opens on a user message and runs until
 // the next one. A subagent's round is attributed to the root round whose interval
 // contains its assignment, so the two panels fold on the same moment and can be read
-// side by side.
+// side by side. Root boundaries come from one exact root identity, never every record
+// whose presentation path happens to be /root.
 function rootPrompts(messages,path){return messages.filter(message=>isObserved(message)&&!isInjected(message)&&(String(message?.kind||'')==='user_message'||String(message?.sender||'')==='user')&&(!message?.recipient||String(message.recipient)===path))}
-function runRounds(){
-  // Every record the root owns, not the first one found: an agent is archived many
-  // times and the earliest archives carry nothing.
-  const messages=recordForPath('/root')?.conversation_preview?.messages||[];
-  return rootPrompts(messages,'/root').map(message=>({key:messageKey(message),start:stampOf(message),label:summarise(messageText(message))}));
+function runRounds(rootRecord=null){
+  const record=rootRecord||recordForPath('/root'),preview=record?.conversation_preview||{};
+  const messages=Array.isArray(preview.messages)?preview.messages:[];
+  const path=String(preview.agent_path||'/root');
+  return rootPrompts(messages,path).map(message=>({key:messageKey(message),start:stampOf(message),label:summarise(messageText(message))}));
 }
 function roundOf(stamp,rounds){let found=null;for(const round of rounds){if(round.start&&stamp&&round.start<=stamp)found=round}return found||rounds[0]||null}
 function sameDayRun(rounds){const days=new Set(rounds.map(round=>String(round.start||'').slice(0,10)).filter(Boolean));return days.size<=1}
@@ -315,14 +342,14 @@ function render(node){
   if(!node)return false;
   if(String(node.type||'')!=='agent')return renderNode(node);
   selectedNode=node;selectedConversationSignature=conversationSignature(node);detailsEmpty.hidden=true;details.replaceChildren();
-  const path=nodePath(node),preview=recordFor(node)?.conversation_preview||{},messages=Array.isArray(preview.messages)?preview.messages:[];
-  const isRoot=path==='/root'||attrs(node).agent_role==='root'||attrs(node).root_agent_path==='/root';
+  const record=recordFor(node),preview=record?.conversation_preview||{},path=String(preview.agent_path||nodePath(node)||'').trim(),messages=Array.isArray(preview.messages)?preview.messages:[];
+  const isRoot=nodeHasRootAuthority(node)||previewUsesRootRenderer(preview);
   const rounds=isRoot?rootRounds(messages,path||'/root'):childRounds(messages,path);
   const tools=toolCallsFor(String(node.id||''));
   const appendTools=()=>{if(tools)details.appendChild(card('Tools',tools))};
   if(rounds.length<2){details.appendChild(roundView(rounds[0]||{cards:isRoot?[['Prompt',''],['Final response','']]:[['Task',''],['Thinking',''],['Response','']]}));appendTools();return true}
-  // A subagent borrows the moment and the wording of the root round it belongs to, so
-  // the folds on both panels name the same thing.
+  // A subagent borrows the moment and the wording of the unique canonical root round
+  // it belongs to. If root identity is ambiguous, the child keeps its own timestamp.
   const runs=isRoot?rounds:runRounds();
   const sameDay=sameDayRun(runs.length?runs:rounds);
   const naming=round=>isRoot?round:(roundOf(round.start,runs)||{start:round.start,label:''});

{execweave-0.8.3 → execweave-0.8.4}/src/execweave/viewer_dashboard_focus.py

@@ -12,19 +12,25 @@ execweaveDashboardGraph=function(data){
     const attrs=node.attributes||{};
     let name=node.name;
     if(node.type==='agent'){
-      // Topology attributes are namespaced apart: a subagent carries
-      // child_agent_path and a root carries root_agent_path. Reading agent_path
-      // alone finds nothing and falls through to an id fragment.
+      const provider=String(attrs.provider||'').toLowerCase();
       const agentPath=String(attrs.agent_path||attrs.child_agent_path||attrs.root_agent_path||'').trim();
       const agentId=String(attrs.agent_id||attrs.subagent_id||'');
+      const conversationId=String(attrs.conversation_id||'').trim();
       const nickname=String(attrs.agent_nickname||'').trim();
-      if(agentPath)name=agentPath;
-      else if(providerRootIds.has(String(node.id||'')))name='/root';
-      else if(['default','agent','subagent'].includes(String(node.name||'').toLowerCase())){
+      const nativeLabel=String(nickname||attrs.agent_type||attrs.subagent_type||attrs.native_agent_name||'').trim();
+      const explicitChild=!!String(attrs.parent_agent_path||'').trim();
+      const explicitRoot=!explicitChild&&(attrs.agent_role==='root'||String(attrs.root_agent_path||'')==='/root'||providerRootIds.has(String(node.id||'')));
+      if(explicitRoot)name='/root';
+      else if(provider==='antigravity'&&nativeLabel&&!['default','agent','subagent','antigravity subagent'].includes(nativeLabel.toLowerCase()))name=nativeLabel;
+      else if(agentPath)name=agentPath;
+      else if(provider==='antigravity'&&conversationId)name=`conversation · ${conversationId.slice(0,8)}`;
+      else if(['default','agent','subagent','antigravity conversation'].includes(String(node.name||'').toLowerCase())){
         // Never label by a timestamp-ordered id prefix: siblings spawned in the
         // same millisecond share it and render as the same node.
         if(nickname)name=`subagent · ${nickname}`;
+        else if(nativeLabel)name=`subagent · ${nativeLabel}`;
         else if(agentId)name=`subagent · ${agentId.slice(0,13)}`;
+        else name=`agent · ${String(node.id||'').split(':').at(-1).slice(0,13)}`;
       }
     }
     const occurrenceCount=Number(attrs.viewer_occurrence_count||0);