@odigos/ui-kit 0.0.249 → 0.0.251

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 n,useRef as i,useCallback as a,useEffect as o}from"react";import{MarkerType as s,useNodesState as c,useEdgesState as d}from"@xyflow/react";import{N as l,D as p,E as u,g,d as h,e as m,S as y,f,h as v,i as x,F as S,j as N,k as b,l as K,m as w,n as k}from"./chunks/ui-components-DODwSdKu.js";import{UserIcon as T,ImageErrorIcon as M,ChevronDownIcon as $,ChevronRightIcon as C}from"./icons.js";import I,{useTheme as z}from"styled-components";import{E}from"./chunks/vendor-Be0cOokr.js";import{Flow as G}from"./snippets.js";import"zustand";import"javascript-time-ago";import"prism-react-renderer";import"react-error-boundary";import"react-dom";import"virtua";const V=e=>`${u.Source}-${e}-${l.MapItem}`,D=(e,t,r)=>{const n=e.isVirtual,i=r?[T]:n?[g(e)]:t?h(t):[M],{priorotizedStatus:a}=n?{priorotizedStatus:void 0}:m(t?.conditions||[]);return{id:e.graphKey,title:e.serviceName,icons:i,isVirtual:n,status:a,aggService:e}},R=e=>!(!e||"user"!==e.serviceName||e.id.namespace||e.id.name||e.id.kind),A=({theme:e,nodes:t,aggregatedServiceMap:r})=>{const n=[],i=new Map(t.map(e=>[e.id,e]));for(const t of r){const r=V(t.graphKey),a=i.get(r);if(!a)continue;const o=a.data?.status===y.Error;for(const a of t.connections){const c=V(a.targetGraphKey);i.has(c)&&n.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 n},j=e=>{const t=e.lastIndexOf("|");return-1===t?{graphKey:e,detail:""}:{graphKey:e.substring(0,t),detail:e.substring(t+1)}},O=new E,_=`${u.Source}-user-${l.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=I.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 b,o as N,p as k,q as w}from"./chunks/ui-components-BKrLf2tx.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-CDHW7ekQ.js";import{F as V}from"./chunks/flow-CQi_KYfs.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`
   padding: 8px 0;
-`,F=I.div`
+`,L=C.div`
   display: flex;
   gap: 12px;
   align-items: center;
   padding: 4px 0 4px 16px;
-`,L=I.button`
+`,P=C.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=I.div`
+`,W=C.div`
   padding: 4px 0 8px;
-`,P=({conn:r,onToggle:n,isExpanded:i})=>{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:n,children:[e(i?$:C,{size:12}),i?"hide attributes":`${r.details.length} attribute${r.details.length>1?"s":""}`]})]})})},U=({conn:t})=>{const n=z();return e(r,{children:t.details.map(t=>e(F,{children:e(v,{size:12,color:n.text.secondary,style:{flex:1},children:t.value})},t.value))})},H=({connections:i,isVirtual:a,attributes:o})=>{const[s,c]=n(new Set),d=z();if(a){const n=Object.entries(o||{});return t(r,{children:[e(v,{size:12,color:d.text.info,children:"This service is not instrumented. It was detected from client-side spans of services that communicate with it."}),n.length>0&&t(r,{children:[e(W,{style:{paddingTop:16},children:e(v,{size:11,color:d.text.info,children:"Attributes"})}),n.map(([r,n])=>t(F,{children:[e(v,{size:12,color:d.text.secondary,children:r}),e(v,{size:12,children:n})]},r))]})]})}return i.length?t(r,{children:[e(W,{children:e(v,{size:11,color:d.text.info,children:"Connected services"})}),i.map(r=>t("div",{children:[e(P,{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:d.text.info,children:"No outgoing connections"})},X=({conn:n})=>{const i=z();return n?e(r,{children:n.details.length>0?t(r,{children:[e(W,{children:e(v,{size:11,color:i.text.info,children:"Attribute breakdown"})}),n.details.map(t=>e(F,{children:e(v,{size:12,style:{flex:1},children:t.value})},t.value))]}):e(v,{size:12,color:i.text.info,style:{padding:"8px 0"},children:"No attribute breakdown"})}):e(v,{size:12,color:i.text.info,children:"No data for this connection"})},J=({drawerState:t,aggregatedData:r,onClose:n})=>{if(!t)return null;const i=new Map(r.map(e=>[e.graphKey,e]));let a="",o="",s=null;if("node"===t.type){const r=i.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=i.get(t.sourceKey),n=r?.connections.find(e=>e.targetGraphKey===t.targetKey);a=`${r?.serviceName||t.sourceKey} → ${n?.targetServiceName||t.targetKey}`,o="Connection details",s=e(X,{conn:n})}return e(f,{isOpen:!0,width:"420px",position:"right",header:{title:a,subTitle:o,onClose:n},children:s})},Q=I.div`
+`,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`
   width: 100%;
   flex: 1;
   align-self: stretch;
   min-height: 0;
   height: 100%;
   position: relative;
-`,Y={id:{namespace:"",name:"",kind:""},serviceName:"user",markedForInstrumentation:{markedForInstrumentation:!0}},Z=`${u.Source}-`,ee=`-${l.MapItem}`,te=.15,re=({serviceMap:r,onRefresh:s})=>{const g=z(),h=N(e=>e.sources),[m,y,f]=c([]),[v,x,S]=d([]),[K,w]=n(0),[k,T]=n(null),M=i([]);M.current=m;const $=i(g);$.current=g;const C=i([]),I=i([]),E=a(()=>w(e=>e+1),[]),{activeNodeId:B,setActiveNodeType:F,setActiveNodeId:L}=b();o(()=>{if(!B)return;const e=(t=B).startsWith(Z)&&t.endsWith(ee)?t.slice(Z.length,-ee.length):null;var t;e&&T({type:"node",graphKey:e})},[B]);const W=a((e,t)=>{const{sourceGraphKey:r,targetGraphKey:n}=t.data||{};r&&n&&(F(null),L(null),T({type:"edge",sourceKey:r,targetKey:n}))},[F,L]),P=a(()=>{T(null),F(null),L(null)},[F,L]),U=a((e,t)=>{const r=t.id;x(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:te},labelStyle:{...e.labelStyle,opacity:te},labelBgStyle:{...e.labelBgStyle,opacity:te}}))},[x]),H=a(()=>{x(I.current)},[x]);return o(()=>{let e=!1;const t=(e=>{const t=new Map,r=new Set,n=(e,r,n=!1)=>{let i=t.get(e);return i||(i={serviceName:r,isVirtual:n,attributes:{},connectionMap:new Map},t.set(e,i)),i},i=(e,t)=>{if(t)for(const{key:r,value:n}of t)r in e||(e[r]=n)};for(const t of e){const{graphKey:e}=j(t.nodeId),a=n(e,t.serviceName);a.isVirtual=!1;for(const e of t.services){const{graphKey:t,detail:o}=j(e?.nodeId??"");e.isVirtual&&(r.add(t),i(n(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[i,a]of e)t.has(i)||n(i,a.targetServiceName,r.has(i));const o=[];for(const[e,{serviceName:r,isVirtual:n,attributes:i,connectionMap:a}]of t){const t=[...a.values()];t.sort((e,t)=>e.targetGraphKey.localeCompare(t.targetGraphKey)),o.push({graphKey:e,serviceName:r,isVirtual:n,connections:t,attributes:i})}return o.sort((e,t)=>e.graphKey.localeCompare(t.graphKey)),o})(r);C.current=t;const n=(({sources:e,aggregatedServiceMap:t})=>{const r=[],n={x:0,y:0};if(t.length&&e.length)for(const i of t){const t=V(i.graphKey),a=e.find(e=>i.serviceName===e.serviceName||i.serviceName===e.id.name);r.push({id:t,type:l.MapItem,position:n,data:D(i,a,R(a)),measured:{width:80,height:80}})}else r.push({id:`${u.Source}-${l.NoData}`,type:l.NoData,position:n,data:{subTitle:p.ARE_SERVICES_INSTRUMENTED_AND_PRODUCING_TRAFFIC}});return r})({aggregatedServiceMap:t,sources:[Y].concat(h)});if(1===n.length&&n[0].id===`${u.Source}-${l.NoData}`)return y(n),x([]),void(I.current=[]);const i=new Set(M.current.map(e=>e.id)),a=new Set(n.map(e=>e.id)),o=n.some(e=>!i.has(e.id)),s=M.current.some(e=>!a.has(e.id));if(!(o||s)){const e=new Map(M.current.map(e=>[e.id,e.position]));y(n.map(t=>({...t,position:e.get(t.id)??t.position})));const r=A({theme:$.current,nodes:n,aggregatedServiceMap:t});return I.current=r,void x(r)}return(async(e,t,r={})=>{const n={id:"root",layoutOptions:{...q,...r},children:e.map(e=>({id:e.id,width:80,height:80,...e.id===_?{layoutOptions:{"elk.layered.layering.layerConstraint":"FIRST","elk.alignment":"CENTER"}}:{}})),edges:t.map(e=>({id:e.id,sources:[e.source],targets:[e.target]}))},i=await O.layout(n),a=new Map;return i.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}})(n,A({theme:$.current,nodes:n,aggregatedServiceMap:t})).then(({nodes:t})=>{if(e)return;y(t);const r=A({theme:$.current,nodes:t,aggregatedServiceMap:C.current});I.current=r,x(r),E()}),()=>{e=!0}},[r,h]),o(()=>{if(!M.current.length)return;const e=A({theme:g,nodes:M.current,aggregatedServiceMap:C.current});I.current=e,x(e)},[g]),t(Q,{children:[e(G,{nodes:m,edges:v,onNodesChange:f,onEdgesChange:S,onEdgeClick:W,onNodeMouseEnter:U,onNodeMouseLeave:H,onRefresh:s,fitViewTrigger:K,zoomOnScroll:!0}),e(J,{drawerState:k,aggregatedData:C.current,onClose:P})]})},ne=I.div`
+`,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`
   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;
-`,ie=()=>{const{notifications:t,markAsDismissed:r,markAsSeen:n}=K(),{onClickNotification:i}=w(),a=t.filter(({dismissed:e})=>!e);return e(ne,{children:a.map(({id:t,type:o,title:s,message:c,crdType:d,target:l},p)=>{const u=c||s;if(!u)return null;const g=a.length-p;return e(k,{status:o,message:u,action:d&&l?{label:"go to details",onClick:()=>i({id:t,crdType:d,target:l},{dismissToast:!0})}:void 0,onClose:({asSeen:e})=>(({id:e,asSeen:t})=>{r(e),t&&n(e)})({id:t,asSeen:e}),zIndex:g},`toast-${t}`)})})};export{re as ServiceMap,ie as ToastList};
+`,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};

package/lib/contexts/index.d.ts

@@ -1,6 +1,7 @@
 export * from './action-form-context';
 export * from './data-stream-form-context';
 export * from './destination-form-context';
+export * from './odigos-api';
 export * from './odigos-context';
 export * from './rule-form-context';
 export * from './sampling-rules-form-context';

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

@@ -0,0 +1,38 @@
+/**
+ * Capability derivation: a single source of truth for "is this UI affordance
+ * available?" replacing the scattered `!isVm && fn ? ... : undefined` checks
+ * the ticket called out.
+ *
+ * Capabilities are computed from:
+ *   1. `ctx.platformType` — VM platforms gate out cluster-only features.
+ *   2. `ctx.tier` — community vs enterprise.
+ *   3. Operation presence — if the host adapter doesn't supply
+ *      `CREATE_ACTION`, the capability is `false`.
+ *
+ * Containers should consume capabilities, not platform identity.
+ */
+import type { OdigosApiOperations, OperationContext } from './types';
+export interface Capabilities {
+    canBulkPersistSources: boolean;
+    canFetchSnapshots: boolean;
+    canRecoverFromRollback: boolean;
+    canRestartWorkloads: boolean;
+    canFetchPeerSources: boolean;
+    canFetchSourceLibraries: boolean;
+    canFetchK8sManifest: boolean;
+    canCreateDestination: boolean;
+    canTestConnection: boolean;
+    canFetchDestinationCategories: boolean;
+    canFetchPotentialDestinations: boolean;
+    canCreateAction: boolean;
+    canCreateInstrumentationRule: boolean;
+    canApplyEffectiveConfig: boolean;
+    canFetchEffectiveConfig: boolean;
+    canFetchConfigYamls: boolean;
+    canFetchProfiling: boolean;
+    canFetchCollectorInfo: boolean;
+    canManageSamplingRules: boolean;
+    isEnterprise: boolean;
+    isVm: boolean;
+}
+export declare const deriveCapabilities: (operations: OdigosApiOperations, ctx: OperationContext) => Capabilities;

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

@@ -0,0 +1,22 @@
+/**
+ * Apollo client factory used by the OdigosApiProvider.
+ *
+ * Encodes the union of the two host apps' Apollo setups (odigos webapp +
+ * central-ui), gating each concern on a flag in `ApolloConfig`. Hosts
+ * supply their own auth header / CSRF header / error redirect callbacks
+ * and (if needed) their own WS link, while the kit owns the link
+ * composition, cache, and default fetch policies.
+ */
+import type { ApolloConfig } from './types';
+import { ApolloClient } from '@apollo/client';
+/**
+ * Construct an ApolloClient for the supplied host config.
+ *
+ * The link chain is:
+ *   1. authLink: injects auth + CSRF headers from host callbacks.
+ *   2. errorLink: routes auth failures to `onAuthError`.
+ *   3. additionalLinks (host-supplied) prepended.
+ *   4. HttpLink terminates.
+ *   5. Optional WS link is split-routed for subscription operations.
+ */
+export declare const makeApolloClient: (config: ApolloConfig) => ApolloClient<unknown>;

package/lib/contexts/odigos-api/connections-scope.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `<OdigosApiConnectionsScope connectionIds={…}>` — overrides the
+ * current operation context's `connectionIds` for all `useOdigosApi()`
+ * calls inside. Used by central-ui's `<CentralConnections>` to wrap bulk
+ * drawers (`<AddSourceDrawer>`, `<AddDestinationDrawer>`,
+ * `<AddActionDrawer>`, `<AddRuleDrawer>`, `<EditConfigDrawer>`).
+ *
+ * The host adapter reads `ctx.connectionIds` inside its operation
+ * `transformVariables` to route mutations across the selected clusters
+ * (typically via REMOTE_MULTI_FETCH).
+ */
+import { type FC, type PropsWithChildren } from 'react';
+interface ConnectionsScopeProps extends PropsWithChildren {
+    /** Connection ids to scope all operations to. */
+    connectionIds: string[];
+}
+export declare const OdigosApiConnectionsScope: FC<ConnectionsScopeProps>;
+export {};

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

@@ -0,0 +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.
+ */
+import type { OperationContext, OdigosApiOperations } from '../types';
+import { type Action, type ActionFormData } from '@/types';
+export interface ActionsApi {
+    items: Action[];
+    loading: boolean;
+    fetchAll: () => Promise<void>;
+    create: (input: ActionFormData) => Promise<void>;
+    update: (id: string, input: ActionFormData) => Promise<void>;
+    /**
+     * Delete an action. Both `id` and `actionType` are required by the
+     * wire mutation; the type is what the server uses to look up which
+     * action CRD to delete.
+     */
+    remove: (id: string, actionType: string) => Promise<void>;
+}
+export declare const useActionsApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
+    subscribe?: boolean;
+}) => ActionsApi;

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

@@ -0,0 +1,25 @@
+import type { OperationContext, OdigosApiOperations } from '../types';
+import type { ExtendedPodInfo, GatewayInfo, NodeCollectoInfo, PodInfo } from '@/types';
+export interface CollectorsApi {
+    getGatewayInfo?: () => Promise<{
+        data?: GatewayInfo;
+        error?: string;
+    }>;
+    getGatewayPods?: () => Promise<{
+        data?: PodInfo[];
+        error?: string;
+    }>;
+    getNodeCollectorInfo?: () => Promise<{
+        data?: NodeCollectoInfo;
+        error?: string;
+    }>;
+    getNodeCollectorPods?: () => Promise<{
+        data?: PodInfo[];
+        error?: string;
+    }>;
+    getExtendedPodInfo?: (namespace: string, name: string) => Promise<{
+        data?: ExtendedPodInfo;
+        error?: string;
+    }>;
+}
+export declare const useCollectorsApi: (operations: OdigosApiOperations, ctx: OperationContext) => CollectorsApi;

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

@@ -0,0 +1,24 @@
+import type { OperationContext, OdigosApiOperations } from '../types';
+import { type ConfigYaml, type EffectiveConfig, type EffectiveConfigInput, type LocalUiConfigInput } from '@/types';
+export interface ConfigApi {
+    getEffectiveConfig: (id?: string) => Promise<{
+        data?: EffectiveConfig;
+        error?: string;
+    }>;
+    applyConfigurations?: (formData: Partial<EffectiveConfigInput>, connectionIds: string[]) => Promise<{
+        error?: string;
+    } | undefined>;
+    getConfigYamls?: () => Promise<{
+        data?: {
+            configYamls: ConfigYaml[];
+        };
+        error?: string;
+    }>;
+    updateLocalUiConfig?: (input: LocalUiConfigInput) => Promise<{
+        error?: string;
+    } | undefined>;
+    resetLocalUiConfigToDefaults?: () => Promise<{
+        error?: string;
+    } | undefined>;
+}
+export declare const useConfigApi: (operations: OdigosApiOperations, ctx: OperationContext) => ConfigApi;

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

@@ -0,0 +1,26 @@
+/**
+ * `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.
+ */
+import { type DataStream } from '@/types';
+import type { OperationContext, OdigosApiOperations } from '../types';
+export interface DataStreamsApi {
+    /** All data streams. Sourced from `useApiQuery('GET_DATA_STREAMS')`. */
+    items: DataStream[];
+    loading: boolean;
+    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;

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

@@ -0,0 +1,33 @@
+import type { WorkloadId } from '@/types';
+import type { DescribeOdigosData, DescribeSourceData, DiagnoseResult, OperationContext, OdigosApiOperations, DiagnoseVars } from '../types';
+export interface DescribeApi {
+    fetchDescribeOdigos?: () => Promise<{
+        data?: DescribeOdigosData;
+        error?: string;
+    }>;
+    fetchDescribeSource?: (id: WorkloadId) => Promise<{
+        data?: DescribeSourceData;
+        error?: string;
+    }>;
+    /**
+     * Diagnose download is a 2-step flow, both owned by the kit:
+     *
+     *   1. `GET_DIAGNOSE` — server-side bundle build that the SSE listener turns into per-stage progress notifications.
+     *      Resolves with the diagnostic stats (file count, byte size).
+     *   2. REST GET to `<apollo-origin>/diagnose/download` — the kit re-uses the host's `apolloConfig` (origin from `httpUrl`, `credentials`, `authHeader`, `csrfHeader`) to fetch the prepared archive, then triggers a browser download via a hidden `<a download>` element.
+     *      The host doesn't have to wire anything; if `GET_DIAGNOSE` is mapped, the file download just works.
+     *
+     * Step 2 is skipped on dry runs and when `stats.fileCount === 0` (nothing to bundle).
+     * Step 2 errors are logged but not surfaced — step 1 has already succeeded by then so a step-2 failure shouldn't roll back progress or fire a confusing toast.
+     *
+     * The wire mutation is `diagnose(input: DiagnoseInput!, dryRun: Boolean)`, so consumers pass the bare `DiagnoseInput` and the hook wraps it under `{ input }` before dispatching.
+     * `dryRun` defaults to false.
+     */
+    downloadDiagnose?: (payload: DiagnoseVars['input'], options?: {
+        dryRun?: boolean;
+    }) => Promise<{
+        data?: DiagnoseResult;
+        error?: string;
+    }>;
+}
+export declare const useDescribeApi: (operations: OdigosApiOperations, ctx: OperationContext) => DescribeApi;

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

@@ -0,0 +1,50 @@
+/**
+ * `useDestinationsApi` — destinations CRUD.
+ *
+ * Reads (`destinations`, `loading`) flow through the kit's declarative
+ * `useApiQuery('GET_DESTINATIONS')` so every consumer (overview
+ * column, drawers, form context) stays in sync via Apollo's cache
+ * broadcast. Mutations call `runMutation` and then `await fetchAll()`
+ * to refresh the cached list — the broadcast updates every subscriber
+ * in one go.
+ */
+import type { OperationContext, OdigosApiOperations } from '../types';
+import { type Destination, type DestinationFormData, type TestConnectionResponse, type GetDestinationCategoriesResult, type GetPotentialDestinationsResult } from '@/types';
+export interface DestinationsApi {
+    items: Destination[];
+    loading: boolean;
+    fetchAll: () => Promise<void>;
+    /**
+     * 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.
+     */
+    categoriesResult: GetDestinationCategoriesResult | undefined;
+    /** True while the categories request is in flight (only when subscribed). */
+    categoriesLoading: boolean;
+    /**
+     * 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.
+     */
+    potentialResult: GetPotentialDestinationsResult | undefined;
+    /** True while the potential-destinations request is in flight (only when subscribed). */
+    potentialLoading: boolean;
+    /**
+     * Test the destination connection. The host adapter's
+     * `TEST_DESTINATION_CONNECTION` operation should set `transformResult` to
+     * unwrap `data?.testDestinationConnection` so the consumer gets a
+     * `TestConnectionResponse` directly.
+     */
+    testConnection: (formData: DestinationFormData) => Promise<TestConnectionResponse | undefined>;
+    create: (destination: DestinationFormData) => Promise<void>;
+    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;

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

@@ -0,0 +1,35 @@
+/**
+ * `useInstrumentationRulesApi` — instrumentation rules CRUD.
+ *
+ * Reads (`rules`, `loading`) flow through the kit's declarative
+ * `useApiQuery('GET_INSTRUMENTATION_RULES')` so every consumer stays
+ * in sync via Apollo's cache broadcast. Mutations call `runMutation`
+ * and then `await fetchAll()` to refresh the cached list.
+ *
+ * Wire-shape note: the GraphQL `InstrumentationRule` schema uses
+ * `sourcesScopes` (a row-per-criterion array), while the kit's
+ * `InstrumentationRule` model uses `sourceScopes` (a tri-list spec
+ * shape, matching sampling rules' naming). This hook owns the
+ * conversion in BOTH directions so consumer code only ever sees the
+ * spec shape:
+ *   - Reads run through `adaptInstrumentationRuleFromWire` (folds the
+ *     row array back into `{ sources, namespaces, languages }`).
+ *   - Mutation inputs run through `adaptInstrumentationRuleInputForWire`
+ *     (unfolds the spec back into rows + renames the field).
+ *
+ * Both adapters return the same wire shape, so the conversion lives
+ * here rather than per-adapter.
+ */
+import type { OperationContext, OdigosApiOperations } from '../types';
+import { type InstrumentationRule, type InstrumentationRuleFormData } from '@/types';
+export interface InstrumentationRulesApi {
+    items: InstrumentationRule[];
+    loading: boolean;
+    fetchAll: () => Promise<void>;
+    create: (input: InstrumentationRuleFormData) => Promise<void>;
+    update: (id: string, input: InstrumentationRuleFormData) => Promise<void>;
+    remove: (id: string) => Promise<void>;
+}
+export declare const useInstrumentationRulesApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
+    subscribe?: boolean;
+}) => InstrumentationRulesApi;

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

@@ -0,0 +1,14 @@
+import type { OperationContext, OdigosApiOperations, GetK8sManifestVars, GetK8sManifestData } from '../types';
+export interface K8sManifestApi {
+    /**
+     * Fetch the YAML manifest for a k8s resource. Returns the bare YAML
+     * string — adapters whose wire shape is `{ k8sActualManifest } | { manifest }`
+     * MUST flatten via `Operation.transformResult` (or `wrapRemote`'s
+     * `extract` callback). Returns `undefined` data on error.
+     */
+    fetch: (input: GetK8sManifestVars) => Promise<{
+        data?: GetK8sManifestData;
+        error?: string;
+    }>;
+}
+export declare const useK8sManifestApi: (operations: OdigosApiOperations, ctx: OperationContext) => K8sManifestApi;

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

@@ -0,0 +1,13 @@
+import type { Metrics } from '@/types';
+import type { OperationContext, OdigosApiOperations } from '../types';
+interface MetricsEnvelope {
+    getOverviewMetrics?: Metrics;
+}
+export interface MetricsApi {
+    fetch: () => Promise<{
+        data?: MetricsEnvelope;
+        error?: string;
+    }>;
+}
+export declare const useMetricsApi: (operations: OdigosApiOperations, ctx: OperationContext) => MetricsApi;
+export {};

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

@@ -0,0 +1,30 @@
+/**
+ * `useNamespaceApi` — namespaces (with workloads) read + persist.
+ *
+ * Reads (`namespaces`, `loading`) flow through the kit's declarative
+ * `useApiQuery('GET_NAMESPACES_WITH_WORKLOADS')`. Apollo dedupes
+ * concurrent consumers and shares the cached list, so the
+ * `<AddSourceDrawer>` and `<DiagnoseTab>` (and any other consumer)
+ * see the same data once any of them has triggered the fetch.
+ */
+import { type Namespace } from '@/types';
+import type { OperationContext, OdigosApiOperations } from '../types';
+import type { NamespaceInstrumentInput } from '../internal/source-payloads';
+interface NamespacesEnvelope {
+    namespaces?: Namespace[];
+}
+export interface NamespaceApi {
+    items: Namespace[];
+    loading: boolean;
+    fetchAll: () => Promise<{
+        data?: NamespacesEnvelope;
+        error?: string;
+    }>;
+    persist: (payload: NamespaceInstrumentInput) => Promise<{
+        error?: string;
+    } | void>;
+}
+export declare const useNamespaceApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
+    subscribe?: boolean;
+}) => NamespaceApi;
+export {};

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

@@ -0,0 +1,17 @@
+import type { OperationContext, OdigosApiOperations } from '../types';
+import type { EnableProfilingResult, ProfilingSlots, SourceProfilingResult, WorkloadId } from '@/types';
+export interface ProfilingApi {
+    fetchSlots?: () => Promise<{
+        data?: ProfilingSlots;
+        error?: string;
+    }>;
+    fetchSourceProfiling?: (sourceId: WorkloadId) => Promise<{
+        data?: SourceProfilingResult;
+        error?: string;
+    }>;
+    enableProfiling?: (sourceId: WorkloadId) => Promise<{
+        data?: EnableProfilingResult;
+        error?: string;
+    }>;
+}
+export declare const useProfilingApi: (operations: OdigosApiOperations, ctx: OperationContext) => ProfilingApi;

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

@@ -0,0 +1,39 @@
+import { type CostReductionRuleInput, type HighlyRelevantOperationRuleInput, type NoisyOperationRuleInput } from '@/types';
+import type { GetSamplingRulesData, OperationContext, OdigosApiOperations, SamplingK8sHealthConfigVars, SamplingRuleCreateVars } from '../types';
+export interface SamplingApi {
+    fetchAll?: () => Promise<{
+        data?: GetSamplingRulesData;
+        error?: string;
+    }>;
+    createNoisy?: (vars: SamplingRuleCreateVars<NoisyOperationRuleInput>) => Promise<{
+        error?: string;
+    } | undefined>;
+    updateNoisy?: (ruleId: string, vars: SamplingRuleCreateVars<NoisyOperationRuleInput>) => Promise<{
+        error?: string;
+    } | undefined>;
+    deleteNoisy?: (ruleId: string, samplingId: string) => Promise<{
+        error?: string;
+    } | undefined>;
+    createHighlyRelevant?: (vars: SamplingRuleCreateVars<HighlyRelevantOperationRuleInput>) => Promise<{
+        error?: string;
+    } | undefined>;
+    updateHighlyRelevant?: (ruleId: string, vars: SamplingRuleCreateVars<HighlyRelevantOperationRuleInput>) => Promise<{
+        error?: string;
+    } | undefined>;
+    deleteHighlyRelevant?: (ruleId: string, samplingId: string) => Promise<{
+        error?: string;
+    } | undefined>;
+    createCostReduction?: (vars: SamplingRuleCreateVars<CostReductionRuleInput>) => Promise<{
+        error?: string;
+    } | undefined>;
+    updateCostReduction?: (ruleId: string, vars: SamplingRuleCreateVars<CostReductionRuleInput>) => Promise<{
+        error?: string;
+    } | undefined>;
+    deleteCostReduction?: (ruleId: string, samplingId: string) => Promise<{
+        error?: string;
+    } | undefined>;
+    updateK8sHealthProbesConfig?: (input: SamplingK8sHealthConfigVars) => Promise<{
+        error?: string;
+    } | undefined>;
+}
+export declare const useSamplingApi: (operations: OdigosApiOperations, ctx: OperationContext) => SamplingApi;

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

@@ -0,0 +1,13 @@
+import type { OperationContext, OdigosApiOperations } from '../types';
+import type { AggregatedServiceMap, ServiceMapSources } from '@/types';
+interface ServiceMapEnvelope {
+    serviceMap?: AggregatedServiceMap | ServiceMapSources;
+}
+export interface ServiceMapApi {
+    fetch?: () => Promise<{
+        data?: ServiceMapEnvelope;
+        error?: string;
+    }>;
+}
+export declare const useServiceMapApi: (operations: OdigosApiOperations, ctx: OperationContext) => ServiceMapApi;
+export {};

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

@@ -0,0 +1,13 @@
+import type { AllClusterSnapshots, ClusterSnapshot } from '@/types';
+import type { OperationContext, OdigosApiOperations } from '../types';
+export interface SnapshotsApi {
+    getAllClusterSnapshots?: () => Promise<{
+        data?: AllClusterSnapshots;
+        error?: string;
+    }>;
+    getClusterSnapshot?: (clusterId: string) => Promise<{
+        data?: ClusterSnapshot;
+        error?: string;
+    }>;
+}
+export declare const useSnapshotsApi: (operations: OdigosApiOperations, ctx: OperationContext) => SnapshotsApi;

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

@@ -0,0 +1,75 @@
+/**
+ * `useSourcesApi` — sources/workloads CRUD.
+ *
+ * Reads (`sources`, `loading`) flow through the kit's declarative
+ * `useApiQuery('GET_WORKLOADS')` so multiple consumers automatically
+ * share Apollo's normalized cache and stay in sync via cache
+ * broadcasts. Mutations (`persist` / `persistV2` / `update`) call
+ * `runMutation` and then return — they do NOT refetch the list. The
+ * cluster SSE stream is the source of truth for post-mutation state:
+ * host SSE handlers call `fetchByTargets` / `fetchAll`, whose cache
+ * write broadcasts to every subscriber (overview columns, drawers,
+ * service-map, etc.) in one go.
+ *
+ * Optimistic in-memory updates that this hook used to perform via
+ * the deleted `useEntityStore` (`addEntities` / `removeEntities` /
+ * `setEntitiesLoading`) are no longer needed: the explicit refetch
+ * after each mutation produces the same visible end-state with a
+ * sub-second latency, and the kit no longer needs to know how each
+ * host adapter shapes its `GET_WORKLOADS` response envelope to write
+ * back through Apollo's cache.
+ *
+ * SSE-driven invalidation flows through the same `fetchAll` /
+ * `fetchByTargets` entry points: host SSE handlers call them when
+ * cluster events arrive; the cache write broadcasts to every active
+ * `useApiQuery('GET_WORKLOADS')` subscriber.
+ */
+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]: {
+        namespace: string;
+        name?: string;
+        kind?: string;
+        selected: boolean;
+        currentStreamName: string;
+    }[];
+}
+export interface SourcesApi {
+    /** All workloads marked for instrumentation. Sourced from the active `useApiQuery('GET_WORKLOADS')` subscription. */
+    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. */
+    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?: {
+        slim?: boolean;
+    }) => Promise<void>;
+    /** Fetch a single workload by id, returning the freshest copy from Apollo's cache once the round-trip completes. */
+    fetchById: (id: WorkloadId) => Promise<Workload | undefined>;
+    fetchLibraries: (id: WorkloadId) => Promise<{
+        data?: GetSourceLibrariesData;
+        error?: string;
+    }>;
+    fetchPeerSources: (serviceName: string) => Promise<{
+        data?: {
+            peerSources?: PeerSources;
+        };
+        error?: string;
+    }>;
+    /** 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). */
+    persistV2: (input: PersistSourceInput) => Promise<{
+        error?: string;
+    } | undefined>;
+    update: (sourceId: WorkloadId, payload: SourceFormData) => Promise<void>;
+    restartWorkloads: (sourceIds: WorkloadId[]) => Promise<void>;
+    restartPod: (namespace: string, name: string) => Promise<void>;
+    recoverFromRollback: (sourceId: WorkloadId) => Promise<void>;
+}
+export declare const useSourcesApi: (operations: OdigosApiOperations, ctx: OperationContext, options?: {
+    subscribe?: boolean;
+}) => SourcesApi;