@odigos/ui-kit 0.0.252 → 0.0.254

package/lib/containers.js

@@ -1,11 +1,11 @@
-import{jsx as e,jsxs as t,Fragment as r}from"react/jsx-runtime";import{useState as i,useRef as n,useCallback as a,useEffect as o}from"react";import{MarkerType as s,useNodesState as c,useEdgesState as l}from"@xyflow/react";import{b as d,D as p,E as u,i as g,j as m,k as h,S as y,l as f,T as v,m as x,n as S,a as b,o as N,p as k,q as w}from"./chunks/ui-components-Dc15jc-B.js";import{UserIcon as K,ImageErrorIcon as T,ChevronDownIcon as M,ChevronRightIcon as I}from"./icons.js";import C,{useTheme as E}from"styled-components";import $ from"elkjs/lib/elk.bundled.js";import{c as z,d as G}from"./chunks/use-odigos-api-qSWLSy9S.js";import{F as V}from"./chunks/flow-CAOY59Tu.js";import"zustand";import"javascript-time-ago";import"javascript-time-ago/locale/en";import"prism-react-renderer";import"./chunks/vendor-BFqT13Me.js";import"zustand/middleware";import"react-error-boundary";import"react-dom";import"virtua";import"@apollo/client";import"@apollo/client/link/error";import"@apollo/client/link/context";import"@apollo/client/utilities";import"@xyflow/react/dist/style.css";const j=e=>`${u.Source}-${e}-${d.MapItem}`,A=(e,t,r)=>{const i=e.isVirtual,n=r?[K]:i?[g(e)]:t?m(t):[T],{priorotizedStatus:a}=i?{priorotizedStatus:void 0}:h(t?.conditions||[]);return{id:e.graphKey,title:e.serviceName,icons:n,isVirtual:i,status:a,aggService:e}},D=e=>!(!e||"user"!==e.serviceName||e.id.namespace||e.id.name||e.id.kind),R=({theme:e,nodes:t,aggregatedServiceMap:r})=>{const i=[],n=new Map(t.map(e=>[e.id,e]));for(const t of r){const r=j(t.graphKey),a=n.get(r);if(!a)continue;const o=a.data?.status===y.Error;for(const a of t.connections){const c=j(a.targetGraphKey);n.has(c)&&i.push({id:`${r}-to-${c}`,type:"smoothstep",source:r,target:c,data:{sourceGraphKey:t.graphKey,targetGraphKey:a.targetGraphKey},markerEnd:{type:s.ArrowClosed},style:{stroke:o?e?.colors.dark_red:e?.colors.border}})}}return i},_=new $,O=`${u.Source}-user-${d.MapItem}`,q={"elk.algorithm":"layered","elk.direction":"RIGHT","elk.layered.spacing.nodeNodeBetweenLayers":"150","elk.spacing.nodeNode":"120","elk.layered.nodePlacement.strategy":"NETWORK_SIMPLEX","elk.layered.spacing.edgeEdgeBetweenLayers":"30","elk.layered.spacing.edgeNodeBetweenLayers":"40"},B=e=>{const t=e.lastIndexOf("|");return-1===t?{graphKey:e,detail:""}:{graphKey:e.substring(0,t),detail:e.substring(t+1)}},F=C.div`
+import{jsx as e,jsxs as t,Fragment as r}from"react/jsx-runtime";import{useState as i,useRef as n,useCallback as a,useEffect as o}from"react";import{MarkerType as s,useNodesState as c,useEdgesState as l}from"@xyflow/react";import{b as d,D as p,E as u,i as g,j as m,k as h,S as y,l as f,T as v,m as x,n as S,a as N,o as b,p as k,q as w}from"./chunks/ui-components-D_eeOuIL.js";import{UserIcon as K,ImageErrorIcon as M,ChevronDownIcon as T,ChevronRightIcon as $}from"./icons.js";import I,{useTheme as z}from"styled-components";import C from"elkjs/lib/elk.bundled.js";import{d as E}from"./chunks/use-odigos-api-W15RTo5l.js";import{F as G}from"./chunks/flow-Bu1VbeQt.js";import"zustand";import"javascript-time-ago";import"javascript-time-ago/locale/en";import"prism-react-renderer";import"./chunks/vendor-BFqT13Me.js";import"zustand/middleware";import"react-error-boundary";import"react-dom";import"virtua";import"@apollo/client";import"@apollo/client/link/error";import"@apollo/client/link/context";import"@apollo/client/utilities";import"@xyflow/react/dist/style.css";const V=e=>`${u.Source}-${e}-${d.MapItem}`,j=(e,t,r)=>{const i=e.isVirtual,n=r?[K]:i?[g(e)]:t?m(t):[M],{priorotizedStatus:a}=i?{priorotizedStatus:void 0}:h(t?.conditions||[]);return{id:e.graphKey,title:e.serviceName,icons:n,isVirtual:i,status:a,aggService:e}},A=e=>!(!e||"user"!==e.serviceName||e.id.namespace||e.id.name||e.id.kind),D=({theme:e,nodes:t,aggregatedServiceMap:r})=>{const i=[],n=new Map(t.map(e=>[e.id,e]));for(const t of r){const r=V(t.graphKey),a=n.get(r);if(!a)continue;const o=a.data?.status===y.Error;for(const a of t.connections){const c=V(a.targetGraphKey);n.has(c)&&i.push({id:`${r}-to-${c}`,type:"smoothstep",source:r,target:c,data:{sourceGraphKey:t.graphKey,targetGraphKey:a.targetGraphKey},markerEnd:{type:s.ArrowClosed},style:{stroke:o?e?.colors.dark_red:e?.colors.border}})}}return i},R=new C,O=`${u.Source}-user-${d.MapItem}`,q={"elk.algorithm":"layered","elk.direction":"RIGHT","elk.layered.spacing.nodeNodeBetweenLayers":"150","elk.spacing.nodeNode":"120","elk.layered.nodePlacement.strategy":"NETWORK_SIMPLEX","elk.layered.spacing.edgeEdgeBetweenLayers":"30","elk.layered.spacing.edgeNodeBetweenLayers":"40"},_=e=>{const t=e.lastIndexOf("|");return-1===t?{graphKey:e,detail:""}:{graphKey:e.substring(0,t),detail:e.substring(t+1)}},B=I.div`
   padding: 8px 0;
-`,L=C.div`
+`,F=I.div`
   display: flex;
   gap: 12px;
   align-items: center;
   padding: 4px 0 4px 16px;
-`,P=C.button`
+`,L=I.button`
   display: flex;
   align-items: center;
   gap: 4px;
@@ -19,16 +19,16 @@ import{jsx as e,jsxs as t,Fragment as r}from"react/jsx-runtime";import{useState
   &:hover {
     text-decoration: underline;
   }
-`,W=C.div`
+`,P=I.div`
   padding: 4px 0 8px;
-`,U=({conn:r,onToggle:i,isExpanded:n})=>{const a=r.details.length>0;return e(F,{children:t(S,{$justifyContent:"space-between",$alignItems:"center",children:[e(v,{size:14,weight:500,children:r.targetServiceName}),a&&t(P,{onClick:i,children:[e(n?M:I,{size:12}),n?"hide attributes":`${r.details.length} attribute${r.details.length>1?"s":""}`]})]})})},H=({conn:t})=>{const i=E();return e(r,{children:t.details.map(t=>e(L,{children:e(v,{size:12,color:i.text.secondary,style:{flex:1},children:t.value})},t.value))})},X=({connections:n,isVirtual:a,attributes:o})=>{const[s,c]=i(new Set),l=E();if(a){const i=Object.entries(o||{});return t(r,{children:[e(v,{size:12,color:l.text.info,children:"This service is not instrumented. It was detected from client-side spans of services that communicate with it."}),i.length>0&&t(r,{children:[e(W,{style:{paddingTop:16},children:e(v,{size:11,color:l.text.info,children:"Attributes"})}),i.map(([r,i])=>t(L,{children:[e(v,{size:12,color:l.text.secondary,children:r}),e(v,{size:12,children:i})]},r))]})]})}return n.length?t(r,{children:[e(W,{children:e(v,{size:11,color:l.text.info,children:"Connected services"})}),n.map(r=>t("div",{children:[e(U,{conn:r,isExpanded:s.has(r.targetGraphKey),onToggle:()=>{return e=r.targetGraphKey,void c(t=>{const r=new Set(t);return r.has(e)?r.delete(e):r.add(e),r});var e}}),s.has(r.targetGraphKey)&&e(H,{conn:r}),e(x,{})]},r.targetGraphKey))]}):e(v,{size:12,color:l.text.info,children:"No outgoing connections"})},J=({conn:i})=>{const n=E();return i?e(r,{children:i.details.length>0?t(r,{children:[e(W,{children:e(v,{size:11,color:n.text.info,children:"Attribute breakdown"})}),i.details.map(t=>e(L,{children:e(v,{size:12,style:{flex:1},children:t.value})},t.value))]}):e(v,{size:12,color:n.text.info,style:{padding:"8px 0"},children:"No attribute breakdown"})}):e(v,{size:12,color:n.text.info,children:"No data for this connection"})},Q=({drawerState:t,aggregatedData:r,onClose:i})=>{if(!t)return null;const n=new Map(r.map(e=>[e.graphKey,e]));let a="",o="",s=null;if("node"===t.type){const r=n.get(t.graphKey);a=r?.serviceName||t.graphKey,o=r?.isVirtual?"Virtual service (uninstrumented)":"Outgoing connections",s=e(X,{connections:r?.connections||[],isVirtual:r?.isVirtual,attributes:r?.attributes})}else{const r=n.get(t.sourceKey),i=r?.connections.find(e=>e.targetGraphKey===t.targetKey);a=`${r?.serviceName||t.sourceKey} → ${i?.targetServiceName||t.targetKey}`,o="Connection details",s=e(J,{conn:i})}return e(f,{isOpen:!0,width:"420px",position:"right",header:{title:a,subTitle:o,onClose:i},children:s})},Y=["sources"],Z=[],ee=C.div`
+`,W=({conn:r,onToggle:i,isExpanded:n})=>{const a=r.details.length>0;return e(B,{children:t(S,{$justifyContent:"space-between",$alignItems:"center",children:[e(v,{size:14,weight:500,children:r.targetServiceName}),a&&t(L,{onClick:i,children:[e(n?T:$,{size:12}),n?"hide attributes":`${r.details.length} attribute${r.details.length>1?"s":""}`]})]})})},U=({conn:t})=>{const i=z();return e(r,{children:t.details.map((t,r)=>e(F,{children:e(v,{size:12,color:i.text.secondary,style:{flex:1},children:t.value})},`detail-${r}-${t.value}`))})},H=({connections:n,isVirtual:a,attributes:o})=>{const[s,c]=i(new Set),l=z();if(a){const i=Object.entries(o||{});return t(r,{children:[e(v,{size:12,color:l.text.info,children:"This service is not instrumented. It was detected from client-side spans of services that communicate with it."}),i.length>0&&t(r,{children:[e(P,{style:{paddingTop:16},children:e(v,{size:11,color:l.text.info,children:"Attributes"})}),i.map(([r,i])=>t(F,{children:[e(v,{size:12,color:l.text.secondary,children:r}),e(v,{size:12,children:i})]},r))]})]})}return n.length?t(r,{children:[e(P,{children:e(v,{size:11,color:l.text.info,children:"Connected services"})}),n.map(r=>t("div",{children:[e(W,{conn:r,isExpanded:s.has(r.targetGraphKey),onToggle:()=>{return e=r.targetGraphKey,void c(t=>{const r=new Set(t);return r.has(e)?r.delete(e):r.add(e),r});var e}}),s.has(r.targetGraphKey)&&e(U,{conn:r}),e(x,{})]},r.targetGraphKey))]}):e(v,{size:12,color:l.text.info,children:"No outgoing connections"})},X=({conn:i})=>{const n=z();return i?e(r,{children:i.details.length>0?t(r,{children:[e(P,{children:e(v,{size:11,color:n.text.info,children:"Attribute breakdown"})}),i.details.map((t,r)=>e(F,{children:e(v,{size:12,style:{flex:1},children:t.value})},`detail-${r}-${t.value}`))]}):e(v,{size:12,color:n.text.info,style:{padding:"8px 0"},children:"No attribute breakdown"})}):e(v,{size:12,color:n.text.info,children:"No data for this connection"})},J=({drawerState:t,aggregatedData:r,onClose:i})=>{if(!t)return null;const n=new Map(r.map(e=>[e.graphKey,e]));let a="",o="",s=null;if("node"===t.type){const r=n.get(t.graphKey);a=r?.serviceName||t.graphKey,o=r?.isVirtual?"Virtual service (uninstrumented)":"Outgoing connections",s=e(H,{connections:r?.connections||[],isVirtual:r?.isVirtual,attributes:r?.attributes})}else{const r=n.get(t.sourceKey),i=r?.connections.find(e=>e.targetGraphKey===t.targetKey);a=`${r?.serviceName||t.sourceKey} → ${i?.targetServiceName||t.targetKey}`,o="Connection details",s=e(X,{conn:i})}return e(f,{isOpen:!0,width:"420px",position:"right",header:{title:a,subTitle:o,onClose:i},children:s})},Q=[],Y=I.div`
   width: 100%;
   flex: 1;
   align-self: stretch;
   min-height: 0;
   height: 100%;
   position: relative;
-`,te={id:{namespace:"",name:"",kind:""},serviceName:"user",markedForInstrumentation:{markedForInstrumentation:!0}},re=`${u.Source}-`,ie=`-${d.MapItem}`,ne=.15,ae=({serviceMap:r,pollIntervalMs:s=5e3})=>{const g=E(),{data:m,refetch:h}=z("GET_SERVICE_MAP",void 0,{skip:!!r,pollInterval:s,fetchPolicy:"cache-and-network"}),{sourcesApi:y}=G({subscribe:Y}),f=y.items,v=r??(m?.serviceMap??Z),x=r?void 0:()=>{h()},[S,N,k]=c([]),[w,K,T]=l([]),[M,I]=i(0),[C,$]=i(null),F=n([]);F.current=S;const L=n(g);L.current=g;const P=n([]),W=n([]),U=a(()=>I(e=>e+1),[]),{activeNodeId:H,setActiveNodeType:X,setActiveNodeId:J}=b();o(()=>{if(!H)return;const e=(t=H).startsWith(re)&&t.endsWith(ie)?t.slice(re.length,-ie.length):null;var t;e&&$({type:"node",graphKey:e})},[H]);const ae=a((e,t)=>{const{sourceGraphKey:r,targetGraphKey:i}=t.data||{};r&&i&&(X(null),J(null),$({type:"edge",sourceKey:r,targetKey:i}))},[X,J]),oe=a(()=>{$(null),X(null),J(null)},[X,J]),se=a((e,t)=>{const r=t.id;K(e=>e.map(e=>e.source===r||e.target===r?{...e,animated:!0,style:{...e.style,strokeWidth:2.5},labelStyle:{...e.labelStyle,opacity:1},labelBgStyle:{...e.labelBgStyle,opacity:1}}:{...e,style:{...e.style,opacity:ne},labelStyle:{...e.labelStyle,opacity:ne},labelBgStyle:{...e.labelBgStyle,opacity:ne}}))},[K]),ce=a(()=>{K(W.current)},[K]);return o(()=>{let e=!1;const t=(e=>{const t=new Map,r=new Set,i=(e,r,i=!1)=>{let n=t.get(e);return n||(n={serviceName:r,isVirtual:i,attributes:{},connectionMap:new Map},t.set(e,n)),n},n=(e,t)=>{if(t)for(const{key:r,value:i}of t)r in e||(e[r]=i)};for(const t of e){const{graphKey:e}=B(t.nodeId),a=i(e,t.serviceName);a.isVirtual=!1;for(const e of t.services){const{graphKey:t,detail:o}=B(e?.nodeId??"");e.isVirtual&&(r.add(t),n(i(t,e.serviceName,!0).attributes,e.nodeAttributes));let s=a.connectionMap.get(t);if(s||(s={targetGraphKey:t,targetServiceName:e.serviceName,totalRequests:0,lastDateTime:e.dateTime,details:[]},a.connectionMap.set(t,s)),s.totalRequests+=e.requests,e.dateTime>s.lastDateTime&&(s.lastDateTime=e.dateTime),o){const t=s.details.find(e=>e.value===o);t?(t.requests+=e.requests,e.dateTime>t.dateTime&&(t.dateTime=e.dateTime)):s.details.push({value:o,requests:e.requests,dateTime:e.dateTime})}}}const a=[...t.entries()];for(const[,{connectionMap:e}]of a)for(const[n,a]of e)t.has(n)||i(n,a.targetServiceName,r.has(n));const o=[];for(const[e,{serviceName:r,isVirtual:i,attributes:n,connectionMap:a}]of t){const t=[...a.values()];t.sort((e,t)=>e.targetGraphKey.localeCompare(t.targetGraphKey)),o.push({graphKey:e,serviceName:r,isVirtual:i,connections:t,attributes:n})}return o.sort((e,t)=>e.graphKey.localeCompare(t.graphKey)),o})(v);P.current=t;const r=(({sources:e,aggregatedServiceMap:t})=>{const r=[],i={x:0,y:0};if(t.length&&e.length)for(const n of t){const t=j(n.graphKey),a=e.find(e=>n.serviceName===e.serviceName||n.serviceName===e.id.name);r.push({id:t,type:d.MapItem,position:i,data:A(n,a,D(a)),measured:{width:80,height:80}})}else r.push({id:`${u.Source}-${d.NoData}`,type:d.NoData,position:i,data:{subTitle:p.ARE_SERVICES_INSTRUMENTED_AND_PRODUCING_TRAFFIC}});return r})({aggregatedServiceMap:t,sources:[te].concat(f)});if(1===r.length&&r[0].id===`${u.Source}-${d.NoData}`)return N(r),K([]),void(W.current=[]);const i=new Set(F.current.map(e=>e.id)),n=new Set(r.map(e=>e.id)),a=r.some(e=>!i.has(e.id)),o=F.current.some(e=>!n.has(e.id));if(!(a||o)){const e=new Map(F.current.map(e=>[e.id,e.position]));N(r.map(t=>({...t,position:e.get(t.id)??t.position})));const i=R({theme:L.current,nodes:r,aggregatedServiceMap:t});return W.current=i,void K(i)}return(async(e,t,r={})=>{const i={id:"root",layoutOptions:{...q,...r},children:e.map(e=>({id:e.id,width:80,height:80,...e.id===O?{layoutOptions:{"elk.layered.layering.layerConstraint":"FIRST","elk.alignment":"CENTER"}}:{}})),edges:t.map(e=>({id:e.id,sources:[e.source],targets:[e.target]}))},n=await _.layout(i),a=new Map;return n.children?.forEach(e=>{a.set(e.id,{x:e.x??0,y:e.y??0})}),{nodes:e.map(e=>({...e,position:a.get(e.id)??e.position})),edges:t}})(r,R({theme:L.current,nodes:r,aggregatedServiceMap:t})).then(({nodes:t})=>{if(e)return;N(t);const r=R({theme:L.current,nodes:t,aggregatedServiceMap:P.current});W.current=r,K(r),U()}),()=>{e=!0}},[v,f]),o(()=>{if(!F.current.length)return;const e=R({theme:g,nodes:F.current,aggregatedServiceMap:P.current});W.current=e,K(e)},[g]),t(ee,{children:[e(V,{nodes:S,edges:w,onNodesChange:k,onEdgesChange:T,onEdgeClick:ae,onNodeMouseEnter:se,onNodeMouseLeave:ce,onRefresh:x,fitViewTrigger:M,zoomOnScroll:!0}),e(Q,{drawerState:C,aggregatedData:P.current,onClose:oe})]})},oe=C.div`
+`,Z={id:{namespace:"",name:"",kind:""},serviceName:"user",markedForInstrumentation:{markedForInstrumentation:!0}},ee=`${u.Source}-`,te=`-${d.MapItem}`,re=.15,ie=({serviceMap:r,pollIntervalMs:s=5e3})=>{const g=z(),{serviceMapApi:m,sourcesApi:h}=E(),y=h.useSources().items,{data:f,refetch:v}=m.useServiceMap({skip:!!r,pollInterval:s,fetchPolicy:"cache-and-network"}),x=r??(f?.serviceMap??Q),S=r?void 0:()=>{v()},[b,k,w]=c([]),[K,M,T]=l([]),[$,I]=i(0),[C,B]=i(null),F=n([]);F.current=b;const L=n(g);L.current=g;const P=n([]),W=n([]),U=a(()=>I(e=>e+1),[]),{activeNodeId:H,setActiveNodeType:X,setActiveNodeId:ie}=N();o(()=>{if(!H)return;const e=(t=H).startsWith(ee)&&t.endsWith(te)?t.slice(ee.length,-te.length):null;var t;e&&B({type:"node",graphKey:e})},[H]);const ne=a((e,t)=>{const{sourceGraphKey:r,targetGraphKey:i}=t.data||{};r&&i&&(X(null),ie(null),B({type:"edge",sourceKey:r,targetKey:i}))},[X,ie]),ae=a(()=>{B(null),X(null),ie(null)},[X,ie]),oe=a((e,t)=>{const r=t.id;M(e=>e.map(e=>e.source===r||e.target===r?{...e,animated:!0,style:{...e.style,strokeWidth:2.5},labelStyle:{...e.labelStyle,opacity:1},labelBgStyle:{...e.labelBgStyle,opacity:1}}:{...e,style:{...e.style,opacity:re},labelStyle:{...e.labelStyle,opacity:re},labelBgStyle:{...e.labelBgStyle,opacity:re}}))},[M]),se=a(()=>{M(W.current)},[M]);return o(()=>{let e=!1;const t=(e=>{const t=new Map,r=new Set,i=(e,r,i=!1)=>{let n=t.get(e);return n||(n={serviceName:r,isVirtual:i,attributes:{},connectionMap:new Map},t.set(e,n)),n},n=(e,t)=>{if(t)for(const{key:r,value:i}of t)r in e||(e[r]=i)};for(const t of e){const{graphKey:e}=_(t.nodeId),a=i(e,t.serviceName);a.isVirtual=!1;for(const e of t.services){const{graphKey:t,detail:o}=_(e?.nodeId??"");e.isVirtual&&(r.add(t),n(i(t,e.serviceName,!0).attributes,e.nodeAttributes));let s=a.connectionMap.get(t);if(s||(s={targetGraphKey:t,targetServiceName:e.serviceName,totalRequests:0,lastDateTime:e.dateTime,details:[]},a.connectionMap.set(t,s)),s.totalRequests+=e.requests,e.dateTime>s.lastDateTime&&(s.lastDateTime=e.dateTime),o){const t=s.details.find(e=>e.value===o);t?(t.requests+=e.requests,e.dateTime>t.dateTime&&(t.dateTime=e.dateTime)):s.details.push({value:o,requests:e.requests,dateTime:e.dateTime})}}}const a=[...t.entries()];for(const[,{connectionMap:e}]of a)for(const[n,a]of e)t.has(n)||i(n,a.targetServiceName,r.has(n));const o=[];for(const[e,{serviceName:r,isVirtual:i,attributes:n,connectionMap:a}]of t){const t=[...a.values()];t.sort((e,t)=>e.targetGraphKey.localeCompare(t.targetGraphKey)),o.push({graphKey:e,serviceName:r,isVirtual:i,connections:t,attributes:n})}return o.sort((e,t)=>e.graphKey.localeCompare(t.graphKey)),o})(x);P.current=t;const r=(({sources:e,aggregatedServiceMap:t})=>{const r=[],i={x:0,y:0};if(t.length&&e.length)for(const n of t){const t=V(n.graphKey),a=e.find(e=>n.serviceName===e.serviceName||n.serviceName===e.id.name);r.push({id:t,type:d.MapItem,position:i,data:j(n,a,A(a)),measured:{width:80,height:80}})}else r.push({id:`${u.Source}-${d.NoData}`,type:d.NoData,position:i,data:{subTitle:p.ARE_SERVICES_INSTRUMENTED_AND_PRODUCING_TRAFFIC}});return r})({aggregatedServiceMap:t,sources:[Z].concat(y)});if(1===r.length&&r[0].id===`${u.Source}-${d.NoData}`)return k(r),M([]),void(W.current=[]);const i=new Set(F.current.map(e=>e.id)),n=new Set(r.map(e=>e.id)),a=r.some(e=>!i.has(e.id)),o=F.current.some(e=>!n.has(e.id));if(!(a||o)){const e=new Map(F.current.map(e=>[e.id,e.position]));k(r.map(t=>({...t,position:e.get(t.id)??t.position})));const i=D({theme:L.current,nodes:r,aggregatedServiceMap:t});return W.current=i,void M(i)}return(async(e,t,r={})=>{const i={id:"root",layoutOptions:{...q,...r},children:e.map(e=>({id:e.id,width:80,height:80,...e.id===O?{layoutOptions:{"elk.layered.layering.layerConstraint":"FIRST","elk.alignment":"CENTER"}}:{}})),edges:t.map(e=>({id:e.id,sources:[e.source],targets:[e.target]}))},n=await R.layout(i),a=new Map;return n.children?.forEach(e=>{a.set(e.id,{x:e.x??0,y:e.y??0})}),{nodes:e.map(e=>({...e,position:a.get(e.id)??e.position})),edges:t}})(r,D({theme:L.current,nodes:r,aggregatedServiceMap:t})).then(({nodes:t})=>{if(e)return;k(t);const r=D({theme:L.current,nodes:t,aggregatedServiceMap:P.current});W.current=r,M(r),U()}),()=>{e=!0}},[x,y]),o(()=>{if(!F.current.length)return;const e=D({theme:g,nodes:F.current,aggregatedServiceMap:P.current});W.current=e,M(e)},[g]),t(Y,{children:[e(G,{nodes:b,edges:K,onNodesChange:w,onEdgesChange:T,onEdgeClick:ne,onNodeMouseEnter:oe,onNodeMouseLeave:se,onRefresh:S,fitViewTrigger:$,zoomOnScroll:!0}),e(J,{drawerState:C,aggregatedData:P.current,onClose:ae})]})},ne=I.div`
   position: fixed;
   bottom: 12px;
   left: 12px;
@@ -37,4 +37,4 @@ import{jsx as e,jsxs as t,Fragment as r}from"react/jsx-runtime";import{useState
   flex-direction: column-reverse;
   gap: 6px;
   max-width: 600px;
-`,se=()=>{const{notifications:t,markAsDismissed:r,markAsSeen:i}=N(),{onClickNotification:n}=k(),a=t.filter(({dismissed:e})=>!e);return e(oe,{children:a.map(({id:t,type:o,title:s,message:c,crdType:l,target:d},p)=>{const u=c||s;if(!u)return null;const g=a.length-p;return e(w,{status:o,message:u,action:l&&d?{label:"go to details",onClick:()=>n({id:t,crdType:l,target:d},{dismissToast:!0})}:void 0,onClose:({asSeen:e})=>(({id:e,asSeen:t})=>{r(e),t&&i(e)})({id:t,asSeen:e}),zIndex:g},`toast-${t}`)})})};export{ae as ServiceMap,se as ToastList};
+`,ae=()=>{const{notifications:t,markAsDismissed:r,markAsSeen:i}=b(),{onClickNotification:n}=k(),a=t.filter(({dismissed:e})=>!e);return e(ne,{children:a.map(({id:t,type:o,title:s,message:c,crdType:l,target:d},p)=>{const u=c||s;if(!u)return null;const g=a.length-p;return e(w,{status:o,message:u,action:l&&d?{label:"go to details",onClick:()=>n({id:t,crdType:l,target:d},{dismissToast:!0})}:void 0,onClose:({asSeen:e})=>(({id:e,asSeen:t})=>{r(e),t&&i(e)})({id:t,asSeen:e}),zIndex:g},`toast-${t}`)})})};export{ie as ServiceMap,ae as ToastList};

package/lib/contexts/odigos-api/hooks/use-actions-api.d.ts

@@ -1,16 +1,26 @@
 /**
  * `useActionsApi` — actions CRUD.
  *
- * Reads (`actions`, `loading`) flow through the kit's declarative
- * `useApiQuery('GET_ACTIONS')` so every consumer stays in sync via
- * Apollo's cache broadcast. Mutations call `runMutation` and then
- * `await fetchAll()` to refresh the cached list.
+ * Reactive reads are exposed via the `useActions()` sub-hook, which owns a
+ * `useApiQuery('GET_ACTIONS')` so every consumer stays in sync via Apollo's
+ * cache broadcast. Calling the sub-hook IS the subscription — containers that
+ * only mutate never call it and never fire the list query. Mutations call
+ * `runMutation` and then `await fetchAll()` to refresh the cached list.
  */
 import type { OperationContext, OdigosApiOperations } from '../types';
 import { type Action, type ActionFormData } from '@/types';
-export interface ActionsApi {
+export interface UseActionsResult {
     items: Action[];
     loading: boolean;
+    refetch: () => Promise<void>;
+}
+export interface ActionsApi {
+    /**
+     * Subscribe to the actions list. Owns a `useApiQuery('GET_ACTIONS')` — call
+     * at the top level of a container (it's a hook). Returns the reactive
+     * `{ items, loading, refetch }`.
+     */
+    useActions: () => UseActionsResult;
     fetchAll: () => Promise<void>;
     create: (input: ActionFormData) => Promise<void>;
     update: (id: string, input: ActionFormData) => Promise<void>;
@@ -21,6 +31,4 @@ export interface ActionsApi {
      */
     remove: (id: string, actionType: string) => Promise<void>;
 }
-export declare const useActionsApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
-    subscribe?: boolean;
-}) => ActionsApi;
+export declare const useActionsApi: (operations: OdigosApiOperations, ctx: OperationContext) => ActionsApi;

package/lib/contexts/odigos-api/hooks/use-collectors-api.d.ts

@@ -1,6 +1,17 @@
-import type { OperationContext, OdigosApiOperations } from '../types';
 import type { ExtendedPodInfo, GatewayInfo, NodeCollectoInfo, PodInfo } from '@/types';
+import type { OperationContext, OdigosApiOperations, GetCollectorPodInfoVars } from '../types';
+import { type UseApiQueryOptions, type UseApiQueryResult } from '../use-api-query';
 export interface CollectorsApi {
+    /** Subscribe to the gateway deployment info. */
+    useGatewayInfo: (options?: UseApiQueryOptions<GatewayInfo>) => UseApiQueryResult<GatewayInfo>;
+    /** Subscribe to the gateway collector pods. */
+    useGatewayPods: (options?: UseApiQueryOptions<PodInfo[]>) => UseApiQueryResult<PodInfo[]>;
+    /** Subscribe to the node-collector daemonset info. */
+    useNodeCollectorInfo: (options?: UseApiQueryOptions<NodeCollectoInfo>) => UseApiQueryResult<NodeCollectoInfo>;
+    /** Subscribe to the node-collector pods. */
+    useNodeCollectorPods: (options?: UseApiQueryOptions<PodInfo[]>) => UseApiQueryResult<PodInfo[]>;
+    /** Subscribe to a single collector pod's extended info. Pass `skip` when there's no selected pod. */
+    usePodInfo: (vars?: GetCollectorPodInfoVars, options?: UseApiQueryOptions<ExtendedPodInfo>) => UseApiQueryResult<ExtendedPodInfo>;
     getGatewayInfo?: () => Promise<{
         data?: GatewayInfo;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-config-api.d.ts

@@ -1,6 +1,15 @@
-import type { OperationContext, OdigosApiOperations } from '../types';
+import { type UseApiQueryOptions, type UseApiQueryResult } from '../use-api-query';
+import type { OperationContext, OdigosApiOperations, GetConfigYamlsData, GetEffectiveConfigVars } from '../types';
 import { type ConfigYaml, type EffectiveConfig, type EffectiveConfigInput, type LocalUiConfigInput } from '@/types';
 export interface ConfigApi {
+    /**
+     * Subscribe to the effective config. Owns a `useApiQuery('GET_EFFECTIVE_CONFIG')`.
+     * Pass `{ id }` to scope to a single connection (central-ui) and `skip` to
+     * gate the request. Call at the top level of a container.
+     */
+    useEffectiveConfig: (vars?: GetEffectiveConfigVars, options?: UseApiQueryOptions<EffectiveConfig>) => UseApiQueryResult<EffectiveConfig>;
+    /** Subscribe to the config YAML field schemas. Owns a `useApiQuery('GET_CONFIG_YAMLS')`. */
+    useConfigYamls: (options?: UseApiQueryOptions<GetConfigYamlsData>) => UseApiQueryResult<GetConfigYamlsData>;
     getEffectiveConfig: (id?: string) => Promise<{
         data?: EffectiveConfig;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-data-streams-api.d.ts

@@ -1,26 +1,32 @@
 /**
  * `useDataStreamsApi` — data-streams CRUD.
  *
- * Reads (`items`, `loading`) flow through the kit's declarative
- * `useApiQuery('GET_DATA_STREAMS')` so the list auto-fetches once any
- * consumer of `useOdigosApi()` mounts. The hook also bridges the
- * fetched list into `useDataStreamStore.dataStreams` so legacy
- * consumers that read `useDataStreamStore` directly stay in sync —
- * we keep the Zustand store as the canonical "selected stream"
- * carrier (UI state) but the underlying list comes from the same
- * Apollo cache as every other entity.
+ * Reactive reads (`items`, `loading`) flow through the `useDataStreams()`
+ * sub-hook, which owns a `useApiQuery('GET_DATA_STREAMS')`. Calling the
+ * sub-hook IS the subscription. The sub-hook also bridges the fetched list
+ * into `useDataStreamStore.dataStreams` so legacy consumers that read
+ * `useDataStreamStore` directly stay in sync — we keep the Zustand store as
+ * the canonical "selected stream" carrier (UI state) but the underlying list
+ * comes from the same Apollo cache as every other entity.
  */
 import { type DataStream } from '@/types';
 import type { OperationContext, OdigosApiOperations } from '../types';
-export interface DataStreamsApi {
-    /** All data streams. Sourced from `useApiQuery('GET_DATA_STREAMS')`. */
+export interface UseDataStreamsResult {
     items: DataStream[];
     loading: boolean;
+    refetch: () => Promise<void>;
+}
+export interface DataStreamsApi {
+    /**
+     * Subscribe to the data-streams list. Owns a `useApiQuery('GET_DATA_STREAMS')`
+     * — call at the top level of a container. Returns the reactive
+     * `{ items, loading, refetch }` and, as a side effect, bridges the fetched
+     * list into `useDataStreamStore.dataStreams` for legacy store consumers.
+     */
+    useDataStreams: () => UseDataStreamsResult;
     fetchAll: () => Promise<void>;
     create?: (stream: DataStream) => Promise<void>;
     update: (name: string, stream: DataStream) => Promise<void>;
     remove: (name: string) => Promise<void>;
 }
-export declare const useDataStreamsApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
-    subscribe?: boolean;
-}) => DataStreamsApi;
+export declare const useDataStreamsApi: (operations: OdigosApiOperations, ctx: OperationContext) => DataStreamsApi;

package/lib/contexts/odigos-api/hooks/use-destinations-api.d.ts

@@ -10,28 +10,41 @@
  */
 import type { OperationContext, OdigosApiOperations } from '../types';
 import { type Destination, type DestinationFormData, type TestConnectionResponse, type GetDestinationCategoriesResult, type GetPotentialDestinationsResult } from '@/types';
-export interface DestinationsApi {
+export interface UseDestinationsResult {
     items: Destination[];
     loading: boolean;
-    fetchAll: () => Promise<void>;
+    refetch: () => Promise<void>;
+}
+export interface UseDestinationCategoriesResult {
+    /** Destination category definitions (the YAML field schemas grouped by "self hosted" / "managed"). `undefined` until resolved. */
+    data: GetDestinationCategoriesResult | undefined;
+    loading: boolean;
+}
+export interface UsePotentialDestinationsResult {
+    /** Auto-detected destinations from a cluster scan. `undefined` until resolved. */
+    data: GetPotentialDestinationsResult | undefined;
+    loading: boolean;
+}
+export interface DestinationsApi {
     /**
-     * Destination category definitions (the YAML field schemas grouped by
-     * "self hosted" / "managed"). Reactive: flows through
-     * `useApiQuery('GET_DESTINATION_CATEGORIES')` and is gated on the
-     * `subscribeCategories` opt-in (see `useOdigosApi({ subscribe: ['destinationCategories'] })`).
-     * `undefined` until the consumer subscribes and the request resolves.
+     * Subscribe to the configured-destinations list. Owns a
+     * `useApiQuery('GET_DESTINATIONS')` — call at the top level of a container.
+     * Returns the reactive `{ items, loading, refetch }`.
      */
-    categoriesResult: GetDestinationCategoriesResult | undefined;
-    /** True while the categories request is in flight (only when subscribed). */
-    categoriesLoading: boolean;
+    useDestinations: () => UseDestinationsResult;
     /**
-     * Auto-detected destinations from a cluster scan. Reactive: flows through
-     * `useApiQuery('GET_POTENTIAL_DESTINATIONS')` and is gated on the
-     * `subscribePotential` opt-in. `undefined` until subscribed + resolved.
+     * Subscribe to the destination category definitions. Owns a
+     * `useApiQuery('GET_DESTINATION_CATEGORIES')` — call at the top level of a
+     * container. Returns `{ data, loading }`.
      */
-    potentialResult: GetPotentialDestinationsResult | undefined;
-    /** True while the potential-destinations request is in flight (only when subscribed). */
-    potentialLoading: boolean;
+    useDestinationCategories: () => UseDestinationCategoriesResult;
+    /**
+     * Subscribe to the auto-detected (potential) destinations from a cluster scan.
+     * Owns a `useApiQuery('GET_POTENTIAL_DESTINATIONS')` — call at the top level of
+     * a container. Returns `{ data, loading }`.
+     */
+    usePotentialDestinations: () => UsePotentialDestinationsResult;
+    fetchAll: () => Promise<void>;
     /**
      * Test the destination connection. The host adapter's
      * `TEST_DESTINATION_CONNECTION` operation should set `transformResult` to
@@ -43,8 +56,4 @@ export interface DestinationsApi {
     update: (id: string, destination: DestinationFormData) => Promise<void>;
     remove: (id: string) => Promise<void>;
 }
-export declare const useDestinationsApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
-    subscribe?: boolean;
-    subscribeCategories?: boolean;
-    subscribePotential?: boolean;
-}) => DestinationsApi;
+export declare const useDestinationsApi: (operations: OdigosApiOperations, ctx: OperationContext) => DestinationsApi;

package/lib/contexts/odigos-api/hooks/use-instrumentation-rules-api.d.ts

@@ -22,14 +22,22 @@
  */
 import type { OperationContext, OdigosApiOperations } from '../types';
 import { type InstrumentationRule, type InstrumentationRuleFormData, type InstrumentationRuleType } from '@/types';
-export interface InstrumentationRulesApi {
+export interface UseInstrumentationRulesResult {
     items: InstrumentationRule[];
     loading: boolean;
+    refetch: () => Promise<void>;
+}
+export interface InstrumentationRulesApi {
+    /**
+     * Subscribe to the instrumentation-rules list. Owns a
+     * `useApiQuery('GET_INSTRUMENTATION_RULES')` — call at the top level of a
+     * container. Returns the reactive `{ items, loading, refetch }` (each rule
+     * already folded back into the kit's `sourceScopes` spec shape).
+     */
+    useRules: () => UseInstrumentationRulesResult;
     fetchAll: () => Promise<void>;
     create: (input: InstrumentationRuleFormData, ruleType?: InstrumentationRuleType) => Promise<void>;
     update: (id: string, input: InstrumentationRuleFormData, ruleType?: InstrumentationRuleType) => Promise<void>;
     remove: (id: string, ruleType?: InstrumentationRuleType) => Promise<void>;
 }
-export declare const useInstrumentationRulesApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
-    subscribe?: boolean;
-}) => InstrumentationRulesApi;
+export declare const useInstrumentationRulesApi: (operations: OdigosApiOperations, ctx: OperationContext) => InstrumentationRulesApi;

package/lib/contexts/odigos-api/hooks/use-metrics-api.d.ts

@@ -1,9 +1,15 @@
-import type { Metrics } from '@/types';
-import type { OperationContext, OdigosApiOperations } from '../types';
+import type { OperationContext, OdigosApiOperations, GetMetricsData } from '../types';
+import { type UseApiQueryOptions, type UseApiQueryResult } from '../use-api-query';
 interface MetricsEnvelope {
-    getOverviewMetrics?: Metrics;
+    getOverviewMetrics?: GetMetricsData['getOverviewMetrics'];
 }
 export interface MetricsApi {
+    /**
+     * Subscribe to the overview metrics. Owns a `useApiQuery('GET_METRICS')`;
+     * callers typically pass a `pollInterval` and a `skip` gate. Call at the
+     * top level of a container.
+     */
+    useMetrics: (options?: UseApiQueryOptions<GetMetricsData>) => UseApiQueryResult<GetMetricsData>;
     fetch: () => Promise<{
         data?: MetricsEnvelope;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-namespace-api.d.ts

@@ -13,9 +13,21 @@ import type { NamespaceInstrumentInput } from '../internal/source-payloads';
 interface NamespacesEnvelope {
     namespaces?: Namespace[];
 }
-export interface NamespaceApi {
+export interface UseNamespacesResult {
     items: Namespace[];
     loading: boolean;
+    refetch: () => Promise<{
+        data?: NamespacesEnvelope;
+        error?: string;
+    }>;
+}
+export interface NamespaceApi {
+    /**
+     * Subscribe to the namespaces (with workloads) list. Owns a
+     * `useApiQuery('GET_NAMESPACES_WITH_WORKLOADS')` — call at the top level of a
+     * container. Returns the reactive `{ items, loading, refetch }`.
+     */
+    useNamespaces: () => UseNamespacesResult;
     fetchAll: () => Promise<{
         data?: NamespacesEnvelope;
         error?: string;
@@ -24,7 +36,5 @@ export interface NamespaceApi {
         error?: string;
     } | void>;
 }
-export declare const useNamespaceApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
-    subscribe?: boolean;
-}) => NamespaceApi;
+export declare const useNamespaceApi: (operations: OdigosApiOperations, ctx: OperationContext) => NamespaceApi;
 export {};

package/lib/contexts/odigos-api/hooks/use-profiling-api.d.ts

@@ -1,6 +1,11 @@
 import type { OperationContext, OdigosApiOperations } from '../types';
+import { type UseApiQueryOptions, type UseApiQueryResult } from '../use-api-query';
 import type { EnableProfilingResult, ProfilingSlots, SourceProfilingResult, WorkloadId } from '@/types';
 export interface ProfilingApi {
+    /** Subscribe to the profiling slots metadata. Typically polled while the Profiling tab is open. */
+    useSlots: (options?: UseApiQueryOptions<ProfilingSlots>) => UseApiQueryResult<ProfilingSlots>;
+    /** Subscribe to a single source's CPU profile. Typically polled while live; pass `skip` to pause. */
+    useSourceProfiling: (vars?: WorkloadId, options?: UseApiQueryOptions<SourceProfilingResult>) => UseApiQueryResult<SourceProfilingResult>;
     fetchSlots?: () => Promise<{
         data?: ProfilingSlots;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-sampling-api.d.ts

@@ -1,6 +1,23 @@
-import { type CostReductionRuleInput, type HighlyRelevantOperationRuleInput, type NoisyOperationRuleInput } from '@/types';
+import { type CostReductionRuleInput, type HighlyRelevantOperationRuleInput, type NoisyOperationRuleInput, type SamplingRules, type SamplingRulesK8sHealthConfig } from '@/types';
 import type { GetSamplingRulesData, OperationContext, OdigosApiOperations, SamplingK8sHealthConfigVars, SamplingRuleCreateVars } from '../types';
+export interface UseSamplingRulesResult {
+    /** Sampling rule groups. Empty array until the request resolves. */
+    items: SamplingRules[];
+    /** The cluster-wide k8s health-probes sampling config (auto noisy rule). `null` until resolved. */
+    k8sHealthProbesConfig: SamplingRulesK8sHealthConfig | null;
+    /** True while the initial `GET_SAMPLING_RULES` request is in flight. */
+    loading: boolean;
+    /** Re-execute the `GET_SAMPLING_RULES` query and broadcast the result via Apollo's cache. */
+    refetch: () => Promise<void>;
+}
 export interface SamplingApi {
+    /**
+     * Subscribe to the sampling rules. Owns a `useApiQuery('GET_SAMPLING_RULES')`
+     * — call at the top level of a container. Returns the reactive
+     * `{ items, k8sHealthProbesConfig, loading, refetch }`. Both the flat
+     * (`samplingRules`) and `computePlatform`-nested wire shapes are accepted.
+     */
+    useSamplingRules: () => UseSamplingRulesResult;
     fetchAll?: () => Promise<{
         data?: GetSamplingRulesData;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-service-map-api.d.ts

@@ -1,9 +1,16 @@
-import type { OperationContext, OdigosApiOperations } from '../types';
 import type { AggregatedServiceMap, ServiceMapSources } from '@/types';
+import type { OperationContext, OdigosApiOperations, GetServiceMapData } from '../types';
+import { type UseApiQueryOptions, type UseApiQueryResult } from '../use-api-query';
 interface ServiceMapEnvelope {
     serviceMap?: AggregatedServiceMap | ServiceMapSources;
 }
 export interface ServiceMapApi {
+    /**
+     * Subscribe to the service map. Owns a `useApiQuery('GET_SERVICE_MAP')`;
+     * callers typically pass a `pollInterval` and a `skip` gate. Call at the
+     * top level of a container.
+     */
+    useServiceMap: (options?: UseApiQueryOptions<GetServiceMapData>) => UseApiQueryResult<GetServiceMapData>;
     fetch?: () => Promise<{
         data?: ServiceMapEnvelope;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-snapshots-api.d.ts

@@ -1,6 +1,30 @@
+/**
+ * `useSnapshotsApi` — central-ui's cross-cluster snapshot reads.
+ *
+ * Reactive `data` / `loading` flow through the `useSnapshots()` sub-hook, which
+ * owns a `useApiQuery('GET_ALL_CLUSTER_SNAPSHOTS')`. The hook honors the
+ * operation's `canRun(ctx)` guard INTERNALLY: when the host blocks the op for
+ * the active context (e.g. central-ui can't snapshot a < v1.20 proxy) the query
+ * is skipped and `data` stays `undefined` — consumers treat that as the signal
+ * to fall back to the per-proxy `namespacesApi` path. Imperative
+ * `getAllClusterSnapshots` / `getClusterSnapshot` remain for fire-and-forget reads.
+ */
 import type { AllClusterSnapshots, ClusterSnapshot } from '@/types';
 import type { OperationContext, OdigosApiOperations } from '../types';
+export interface UseSnapshotsResult {
+    /** All-cluster snapshot for the active context (undefined while loading, skipped, or blocked by the op's guard). */
+    data?: AllClusterSnapshots;
+    loading: boolean;
+    /** True when the host adapter doesn't expose `GET_ALL_CLUSTER_SNAPSHOTS` at all. */
+    unsupported: boolean;
+}
 export interface SnapshotsApi {
+    /**
+     * Subscribe to the cross-cluster snapshot. Owns a
+     * `useApiQuery('GET_ALL_CLUSTER_SNAPSHOTS')` — call at the top level of a
+     * container. Returns the reactive `{ data, loading, unsupported }`.
+     */
+    useSnapshots: () => UseSnapshotsResult;
     getAllClusterSnapshots?: () => Promise<{
         data?: AllClusterSnapshots;
         error?: string;

package/lib/contexts/odigos-api/hooks/use-sources-api.d.ts

@@ -24,8 +24,9 @@
  * cluster events arrive; the cache write broadcasts to every active
  * `useApiQuery('GET_WORKLOADS')` subscriber.
  */
+import { type UseApiQueryOptions, type UseApiQueryResult } from '../use-api-query';
+import type { GetSourceLibrariesData, GetPeerSourcesVars, OperationContext, OdigosApiOperations } from '../types';
 import { type PeerSources, type SourceFormData, type Workload, type WorkloadId } from '@/types';
-import type { GetSourceLibrariesData, OperationContext, OdigosApiOperations } from '../types';
 import { type NamespaceSelectionFormData, type SourceSelectionFormData } from '@/store';
 export interface PersistSourceInput {
     [clusterId: string]: {
@@ -36,12 +37,22 @@ export interface PersistSourceInput {
         currentStreamName: string;
     }[];
 }
-export interface SourcesApi {
-    /** All workloads marked for instrumentation. Sourced from the active `useApiQuery('GET_WORKLOADS')` subscription. */
+export interface UseSourcesResult {
+    /** All workloads marked for instrumentation. */
     items: Workload[];
     /** True while the initial `GET_WORKLOADS` request is in flight. */
     loading: boolean;
     /** Trigger a fresh `GET_WORKLOADS` round-trip and broadcast the result via Apollo's cache. */
+    refetch: () => Promise<void>;
+}
+export interface SourcesApi {
+    /**
+     * Subscribe to the workloads list. Owns a `useApiQuery('GET_WORKLOADS')` —
+     * call at the top level of a container. Returns the reactive
+     * `{ items, loading, refetch }`.
+     */
+    useSources: () => UseSourcesResult;
+    /** Trigger a fresh `GET_WORKLOADS` round-trip and broadcast the result via Apollo's cache. */
     fetchAll: () => Promise<void>;
     /** Fetch specific workloads by SSE-target strings. The result is merged into Apollo's cache via the slot's normalization. */
     fetchByTargets: (targets: string[], options?: {
@@ -59,6 +70,15 @@ export interface SourcesApi {
         };
         error?: string;
     }>;
+    /**
+     * Subscribe to a service's peer sources (inbound/outbound). Owns a
+     * `useApiQuery('GET_PEER_SOURCES')`; call at the top level of a container.
+     */
+    usePeerSources: (vars?: GetPeerSourcesVars, options?: UseApiQueryOptions<{
+        peerSources?: PeerSources;
+    }>) => UseApiQueryResult<{
+        peerSources?: PeerSources;
+    }>;
     /** Persist the legacy form-shape payload (used by `AddSourceDrawer` / `Onboarding`). */
     persist: (selectAppsList: SourceSelectionFormData, futureSelectAppsList: NamespaceSelectionFormData) => Promise<void>;
     /** Persist the V2 multi-cluster payload shape (used by `CentralConnections` / standalone overview's bulk persist). */
@@ -70,6 +90,4 @@ export interface SourcesApi {
     restartPod: (namespace: string, name: string) => Promise<void>;
     recoverFromRollback: (sourceId: WorkloadId) => Promise<void>;
 }
-export declare const useSourcesApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
-    subscribe?: boolean;
-}) => SourcesApi;
+export declare const useSourcesApi: (operations: OdigosApiOperations, ctx: OperationContext) => SourcesApi;

package/lib/contexts/odigos-api/hooks/use-tokens-api.d.ts

@@ -1,10 +1,17 @@
 import { type TokenPayload } from '@/types';
 import type { OperationContext, OdigosApiOperations } from '../types';
+export interface UseTokensResult {
+    items: TokenPayload[];
+    loading: boolean;
+    refetch: () => Promise<void>;
+}
 export interface TokensApi {
-    fetchTokens?: () => Promise<{
-        data?: TokenPayload[];
-        error?: string;
-    }>;
+    /**
+     * Subscribe to the API tokens list. Owns a `useApiQuery('GET_TOKENS')` —
+     * call at the top level of a container. Returns the reactive
+     * `{ items, loading, refetch }`.
+     */
+    useTokens: () => UseTokensResult;
     updateToken?: (token: string) => Promise<{
         error?: string;
     } | undefined>;

package/lib/contexts/odigos-api/index.d.ts

@@ -12,11 +12,12 @@
  */
 export { OdigosApiProvider } from './provider';
 export { OdigosApiConnectionsScope } from './connections-scope';
+export { useOdigosApi, type UseOdigosApiReturn } from './use-odigos-api';
+export { useApiQuery, useApiLazyQuery, useApiMutation } from './use-api-query';
 export { useApiForConnections, type ApiForConnections } from './use-api-for-connections';
-export { useOdigosApi, type SubscribableDomain, type UseOdigosApiReturn } from './use-odigos-api';
-export { useApiQuery, useApiLazyQuery, useApiMutation, type UseApiQueryOptions, type UseApiQueryResult, type UseApiLazyQueryResult, type UseApiMutationOptions, type UseApiMutationResult, type UseApiMutationTuple, } from './use-api-query';
+export type { UseApiQueryOptions, UseApiQueryResult, UseApiLazyQueryResult, UseApiMutationOptions, UseApiMutationResult, UseApiMutationTuple } from './use-api-query';
 export { pickByPlatform, versionedDocument, vmDialectMap, type VersionedDocumentMap } from './platform-helpers';
-export type { ApolloConfig, CreateActionResult, CreateActionVars, CreateCostReductionRuleResult, CreateDataStreamResult, CreateDataStreamVars, CreateDestinationResult, CreateDestinationVars, CreateHighlyRelevantOperationRuleResult, CreateInstrumentationRuleResult, CreateInstrumentationRuleVars, CreateNoisyOperationRuleResult, DeleteActionResult, DeleteActionVars, DeleteCostReductionRuleResult, DeleteDataStreamResult, DeleteDataStreamVars, DeleteDestinationResult, DeleteDestinationVars, DeleteHighlyRelevantOperationRuleResult, DeleteInstrumentationRuleResult, DeleteInstrumentationRuleVars, DeleteNoisyOperationRuleResult, DescribeOdigosData, DescribeSourceData, DestinationWireInput, DiagnoseResult, DiagnoseVars, GetActionsData, GetAllClusterSnapshotsData, GetClusterSnapshotData, GetClusterSnapshotVars, GetCollectorPodInfoData, GetCollectorPodInfoVars, GetConfigYamlsData, GetDataStreamsData, GetDestinationsData, GetEffectiveConfigVars, GetGatewayInfoData, GetGatewayPodsData, GetInstrumentationRulesData, GetK8sManifestData, GetK8sManifestVars, GetMetricsData, GetNamespaceVars, GetNamespacesWithWorkloadsData, GetNodeCollectorInfoData, GetNodeCollectorPodsData, GetPeerSourcesVars, GetProfilingSlotsData, GetSamplingRulesData, GetServiceMapData, GetSourceConditionsData, GetSourceLibrariesData, GetSourceLibrariesVars, GetSourceProfilingData, GetTokensData, GetWorkloadsByIdsData, GetWorkloadsByIdsVars, GetWorkloadsData, GetWorkloadsVars, MultiFetchGroup, MultiFetchResponse, MultiFetchResult, OdigosApiOperations, OdigosApiProviderProps, Operation, OperationContext, PersistNamespacesResult, PersistNamespacesVars, PersistSourcesResult, PersistSourcesVars, RecoverFromRollbackVars, ResetLocalUiConfigResult, RestartPodVars, RestartWorkloadsVars, SamplingK8sHealthConfigInput, SamplingK8sHealthConfigVars, SamplingRuleCreateVars, SamplingRuleDeleteVars, SamplingRuleUpdateVars, SourceConditionEntry, TestDestinationConnectionVars, UpdateActionResult, UpdateActionVars, UpdateCostReductionRuleResult, UpdateDataStreamResult, UpdateDataStreamVars, UpdateDestinationData, UpdateDestinationVars, UpdateHighlyRelevantOperationRuleResult, UpdateInstrumentationRuleResult, UpdateInstrumentationRuleVars, UpdateLocalUiConfigResult, UpdateLocalUiConfigVars, UpdateLocalUiSamplingConfigResult, UpdateLocalUiSamplingConfigVars, UpdateNoisyOperationRuleResult, UpdateRemoteConfigResult, UpdateRemoteConfigVars, UpdateSourceVars, UpdateTokenResult, UpdateTokenVars, } from './types';
+export type { ApolloConfig, CreateActionResult, CreateActionVars, CreateCostReductionRuleResult, CreateDataStreamResult, CreateDataStreamVars, CreateDestinationResult, CreateDestinationVars, CreateHighlyRelevantOperationRuleResult, CreateInstrumentationRuleResult, CreateInstrumentationRuleVars, CreateNoisyOperationRuleResult, DeleteActionResult, DeleteActionVars, DeleteCostReductionRuleResult, DeleteDataStreamResult, DeleteDataStreamVars, DeleteDestinationResult, DeleteDestinationVars, DeleteHighlyRelevantOperationRuleResult, DeleteInstrumentationRuleResult, DeleteInstrumentationRuleVars, DeleteNoisyOperationRuleResult, DescribeOdigosData, DescribeSourceData, DestinationWireInput, DiagnoseResult, DiagnoseVars, GetActionsData, GetAllClusterSnapshotsData, GetClusterSnapshotData, GetClusterSnapshotVars, GetCollectorPodInfoData, GetCollectorPodInfoVars, GetConfigYamlsData, GetDataStreamsData, GetDestinationsData, GetEffectiveConfigVars, GetGatewayInfoData, GetGatewayPodsData, GetInstrumentationRulesData, GetK8sManifestData, GetK8sManifestVars, GetMetricsData, GetNamespacesWithWorkloadsData, GetNodeCollectorInfoData, GetNodeCollectorPodsData, GetPeerSourcesVars, GetProfilingSlotsData, GetSamplingRulesData, GetServiceMapData, GetSourceLibrariesData, GetSourceLibrariesVars, GetSourceProfilingData, GetTokensData, GetWorkloadsByIdsData, GetWorkloadsByIdsVars, GetWorkloadsData, GetWorkloadsVars, MultiFetchGroup, MultiFetchResponse, MultiFetchResult, OdigosApiOperations, OdigosApiProviderProps, Operation, OperationContext, PersistNamespacesResult, PersistNamespacesVars, PersistSourcesResult, PersistSourcesVars, RecoverFromRollbackVars, ResetLocalUiConfigResult, RestartPodVars, RestartWorkloadsVars, SamplingK8sHealthConfigInput, SamplingK8sHealthConfigVars, SamplingRuleCreateVars, SamplingRuleDeleteVars, SamplingRuleUpdateVars, TestDestinationConnectionVars, UpdateActionResult, UpdateActionVars, UpdateCostReductionRuleResult, UpdateDataStreamResult, UpdateDataStreamVars, UpdateDestinationData, UpdateDestinationVars, UpdateHighlyRelevantOperationRuleResult, UpdateInstrumentationRuleResult, UpdateInstrumentationRuleVars, UpdateLocalUiConfigResult, UpdateLocalUiConfigVars, UpdateLocalUiSamplingConfigResult, UpdateLocalUiSamplingConfigVars, UpdateNoisyOperationRuleResult, UpdateRemoteConfigResult, UpdateRemoteConfigVars, UpdateSourceVars, UpdateTokenResult, UpdateTokenVars, } from './types';
 export type { Capabilities } from './capabilities';
 export type { ConfigApi } from './hooks/use-config-api';
 export type { TokensApi } from './hooks/use-tokens-api';

package/lib/contexts/odigos-api/platform-helpers.d.ts

@@ -52,8 +52,10 @@ export type VersionedDocumentMap = {
  *   1. Pick the platform branch matching `ctx.platformType`.
  *   2. Sort that branch's versions descending (numeric-aware via
  *      `trimVersion`).
- *   3. Return the highest version that's `<= ctx.version`. This "floor
- *      to the matching bucket" rule keeps older proxies/agents from
+ *   3. Return the highest version that's `<= ctx.schemaVersion ?? ctx.version`.
+ *      VM proxies report a GraphQL schema version distinct from their agent
+ *      binary version, so we floor by the schema version when present. This
+ *      "floor to the matching bucket" rule keeps older proxies/agents from
  *      receiving documents whose schemas they don't understand yet.
  *   4. If no bucket fits (or the platform is missing), return undefined
  *      → the runner short-circuits with "Operation not supported in