agentglow 0.1.0

package/dist/chunks/spread-CWdeDFd9.js

@@ -0,0 +1,35 @@
+import { h as f, w as c } from "./ClusterBall-CPsd6JvJ.js";
+const _ = (e) => e === "graph_scout" || e === "records_scout" || e === "data_scout", g = (e, t) => f(e, t) - 0.5, w = (e) => e === 0 ? 0 : e % 2 ? (e + 1) / 2 : -e / 2, u = /* @__PURE__ */ new Map();
+function l(e, t) {
+  var n;
+  let s = u.get(t);
+  s || u.set(t, s = /* @__PURE__ */ new Map());
+  const o = s.get(e.id);
+  if (o !== void 0) return o;
+  for (const r of s.keys()) c.instances.has(r) || s.delete(r);
+  let a = 0;
+  for (let r = !0; r; ) {
+    r = !1;
+    for (const [i, d] of s)
+      if (d === a && ((n = c.instances.get(i)) == null ? void 0 : n.run) === e.run) {
+        r = !0, a++;
+        break;
+      }
+  }
+  return s.set(e.id, a), a;
+}
+const p = {
+  planner: "planner",
+  researcher: "researcher",
+  writer: "writer",
+  graph_scout: "sub",
+  records_scout: "sub",
+  data_scout: "sub"
+}, b = (e) => l(e, p[e.type]);
+export {
+  w as a,
+  _ as i,
+  g as j,
+  b as r,
+  l as s
+};

package/dist/index.js

@@ -0,0 +1,8 @@
+"use client";
+import "./style.css";
+import { A as E, T as s, a as T } from "./chunks/index-55W5crSg.js";
+export {
+  E as AgentScene,
+  s as THEMES,
+  T as THEME_INFO
+};

package/dist/style.css

@@ -0,0 +1 @@
+.scene-root{position:fixed;top:0;right:0;bottom:0;left:0;background:#03050b;color:#e8edf5;font-family:Public Sans,system-ui,sans-serif;overflow:hidden}.scene-root canvas{display:block}.hud{position:absolute;z-index:10;background:#0a0e1a8c;border:1px solid rgba(148,163,255,.16);border-radius:14px;backdrop-filter:blur(14px) saturate(1.3);-webkit-backdrop-filter:blur(14px) saturate(1.3);box-shadow:0 8px 32px #00000059,inset 0 1px #ffffff0a}.hud-top{top:16px;left:16px;padding:12px 16px;max-width:min(560px,calc(100vw - 32px))}.hud-title{display:flex;align-items:center;gap:10px;font-weight:700;font-size:17px;letter-spacing:-.01em}.hud-sub{margin-top:3px;font-size:12px;color:#94a3b8}.hud-dot{width:9px;height:9px;border-radius:50%;background:#22c55e;box-shadow:0 0 10px #22c55e;animation:hud-ping 1.6s ease-out infinite}@keyframes hud-ping{0%{box-shadow:0 0 #22c55eb3}to{box-shadow:0 0 0 10px #22c55e00}}.hud-badge{font-size:10px;font-weight:600;text-transform:uppercase;letter-spacing:.08em;padding:2px 7px;border-radius:999px;background:#94a3b829;color:#cbd5e1}.hud-nav{display:flex;flex-wrap:wrap;gap:4px;margin-top:10px}.hud-nav a{font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:#94a3b8;text-decoration:none;padding:3px 8px;border-radius:999px;border:1px solid transparent}.hud-nav a:hover{color:#e2e8f0;border-color:#94a3ff40}.hud-nav a[aria-current=page]{color:#03050b;background:linear-gradient(135deg,#818cf8,#22d3ee)}.hud-counts{right:16px;bottom:16px;padding:12px 14px;display:grid;grid-template-columns:repeat(7,auto);gap:4px 16px;font-size:10px;color:#94a3b8;text-transform:uppercase;letter-spacing:.06em}.hud-counts b{display:block;font-size:20px;color:#f1f5f9;letter-spacing:-.02em;text-transform:none;font-variant-numeric:tabular-nums}.hud-legend{display:none;top:16px;right:16px;padding:8px 12px;display:grid;gap:4px;font-size:13px}.hud-legend div{display:flex;align-items:center;gap:8px}.hud-legend i{width:10px;height:10px;border-radius:50%;background:var(--c);box-shadow:0 0 10px var(--c)}.hud-legend em{margin-left:auto;padding-left:12px;font-style:normal;font-variant-numeric:tabular-nums;color:var(--c);font-weight:700}.hud-ticker{left:16px;bottom:16px;width:min(560px,calc(100vw - 32px));padding:10px 12px;display:grid;gap:4px;font-size:12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.hud-tick{display:flex;gap:8px;align-items:baseline;white-space:nowrap;overflow:hidden;color:#cbd5e1}.hud-tick i{flex:0 0 7px;height:7px;border-radius:50%;background:var(--c);box-shadow:0 0 8px var(--c)}.hud-tick span{overflow:hidden;text-overflow:ellipsis}.hud-card{top:210px;right:16px;width:min(380px,calc(100vw - 32px));max-height:46vh;overflow:auto;padding:14px 16px}.hud-card h3{margin:0 0 4px;font-size:13px;text-transform:uppercase;letter-spacing:.06em;color:var(--c);display:flex;align-items:center;gap:8px}.hud-card h3 i{width:10px;height:10px;border-radius:50%;background:var(--c);box-shadow:0 0 10px var(--c)}.hud-card ul{margin:8px 0 0;padding-left:16px;display:grid;gap:4px;font-size:12px;color:#cbd5e1;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.hud-muted{margin:0;color:#94a3b8;font-size:12px}.hud-close{all:unset;position:absolute;top:8px;right:12px;cursor:pointer;font-size:18px;color:#94a3b8}.scene-label{font-size:12px;font-weight:600;color:#f8fafc;padding:2px 8px;border-radius:999px;white-space:nowrap;background:#03050b8c;border:1px solid color-mix(in srgb,var(--c, #818cf8) 55%,transparent);text-shadow:0 0 10px var(--c, #818cf8);pointer-events:none}.scene-label{scale:.78;max-width:240px;overflow:hidden;text-overflow:ellipsis;border-width:.5px;text-shadow:0 0 6px color-mix(in srgb,var(--c, #818cf8) 70%,transparent);background:#03050b6b}@media(max-width:760px){.hud-counts{grid-template-columns:repeat(3,auto);bottom:auto;top:150px}.hud-legend{display:none}}.hud-agents{top:16px;right:16px;width:min(360px,calc(100vw - 32px));max-height:calc(100vh - 140px);display:flex;flex-direction:column;padding:10px 12px;font-size:13px}.hud-agents.is-collapsed{max-height:none}.ap-head{display:flex;align-items:center;gap:8px}.ap-head strong{font-size:13px;text-transform:uppercase;letter-spacing:.08em;color:#a5b4fc}.ap-count{color:#64748b;font-size:12px;font-variant-numeric:tabular-nums}.ap-link{all:unset;cursor:pointer;margin-left:auto;font-size:12px;color:#93c5fd}.ap-toggle{all:unset;cursor:pointer;margin-left:auto;width:20px;text-align:center;color:#94a3b8;font-size:16px}.ap-link+.ap-toggle{margin-left:8px}.ap-search{margin-top:8px;width:100%;box-sizing:border-box;background:#03050b99;border:1px solid rgba(148,163,255,.2);border-radius:8px;color:inherit;font:inherit;font-size:12px;padding:6px 9px;outline:none}.ap-search:focus{border-color:#818cf8}.ap-chips{display:flex;flex-wrap:wrap;gap:4px;margin-top:8px}.ap-chips button{all:unset;cursor:pointer;display:flex;align-items:center;gap:5px;font-size:11px;padding:3px 7px;border-radius:999px;border:1px solid rgba(148,163,255,.15);color:#cbd5e1}.ap-chips button.on{border-color:var(--c);background:color-mix(in srgb,var(--c) 18%,transparent);color:#f8fafc}.ap-chips i{width:8px;height:8px;border-radius:50%;background:var(--c);box-shadow:0 0 8px var(--c)}.ap-chips em{font-style:normal;color:var(--c);font-weight:700;font-variant-numeric:tabular-nums}.ap-row-filters{display:flex;gap:6px;margin-top:8px;align-items:center}.ap-seg{display:flex;border:1px solid rgba(148,163,255,.15);border-radius:8px;overflow:hidden}.ap-seg button{all:unset;cursor:pointer;font-size:11px;padding:3px 7px;color:#94a3b8;text-transform:capitalize}.ap-seg button.on{background:#818cf840;color:#f1f5f9}.ap-row-filters select{flex:1;min-width:0;background:#03050b99;color:#cbd5e1;border:1px solid rgba(148,163,255,.15);border-radius:8px;font:inherit;font-size:11px;padding:3px 6px}.ap-list{list-style:none;margin:8px -4px 0;padding:0;overflow-y:auto;min-height:0;flex:1}.ap-list li button{all:unset;box-sizing:border-box;width:100%;cursor:pointer;display:flex;align-items:center;gap:8px;padding:6px;border-radius:8px}.ap-list li button:hover{background:#94a3ff1a}.ap-list li button.is-done{opacity:.55}.ap-list i{flex:0 0 9px;height:9px;border-radius:50%;background:var(--c);box-shadow:0 0 8px var(--c)}.ap-list i[data-status=thinking]{animation:ap-pulse .9s ease-in-out infinite}.ap-list i[data-status=waiting]{opacity:.5}.ap-list i[data-status=done]{background:transparent;border:1.5px solid var(--c);box-shadow:none}@keyframes ap-pulse{50%{transform:scale(1.5)}}.ap-name{flex:1;min-width:0;display:flex;flex-direction:column;font-size:12px;color:#e2e8f0}.ap-name small{color:#64748b;font-size:11px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.ap-meta{text-align:right;font-size:11px;color:#94a3b8;font-variant-numeric:tabular-nums;display:flex;flex-direction:column}.ap-meta b{color:var(--c);font-weight:600;text-transform:lowercase}.ap-more{padding:6px;color:#64748b;font-size:11px}.ap-detail{overflow-y:auto;min-height:0;margin-top:8px}.ap-detail h3{margin:0;display:flex;align-items:center;gap:8px;font-size:15px;color:var(--c)}.ap-detail h3 i{width:11px;height:11px;border-radius:50%;background:var(--c);box-shadow:0 0 10px var(--c)}.ap-detail h3 small{color:#64748b;font-size:11px;font-weight:500}.ap-status{margin-top:3px;font-size:12px;color:#cbd5e1}.ap-status[data-status=thinking]{color:#fde68a}.ap-stats{display:grid;grid-template-columns:repeat(5,1fr);gap:4px;margin:10px 0 4px}.ap-stats div{background:#03050b73;border-radius:8px;padding:6px;text-align:center}.ap-stats dt{font-size:9px;text-transform:uppercase;letter-spacing:.06em;color:#64748b}.ap-stats dd{margin:2px 0 0;font-size:15px;font-weight:700;color:#f1f5f9;font-variant-numeric:tabular-nums}.ap-detail section{margin-top:10px}.ap-detail h4{margin:0 0 4px;font-size:10px;text-transform:uppercase;letter-spacing:.08em;color:#64748b}.ap-detail p{margin:0;font-size:12px;color:#cbd5e1}.ap-steps{display:flex;gap:4px;margin-top:4px}.ap-steps span{font-size:10px;text-transform:uppercase;letter-spacing:.06em;padding:2px 7px;border-radius:999px;border:1px solid #334155;color:#64748b}.ap-steps span[data-status=running]{border-color:#fbbf24;color:#fde68a}.ap-steps span[data-status=done]{border-color:#22c55e;color:#86efac}.ap-chip-link{all:unset;cursor:pointer;display:block;font-size:12px;color:#e2e8f0;padding:3px 6px;border-left:2px solid var(--c);margin:2px 0;border-radius:0 6px 6px 0}.ap-chip-link:hover{background:#94a3ff1a}.ap-wait{color:#fbbf24!important;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.ap-nodes{line-height:1.5}.ap-events{margin:0;padding-left:14px;display:grid;gap:3px;font-size:11px;color:#cbd5e1;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.hud-badge--live{background:#22c55e2e;color:#86efac}.hud-run{display:flex;gap:6px;margin-top:8px;align-items:center;flex-wrap:wrap}.hud-run input{flex:1;min-width:160px;background:#03050b99;border:1px solid rgba(148,163,255,.2);border-radius:999px;color:inherit;font:inherit;font-size:12px;padding:6px 11px;outline:none}.hud-run button{border:0;border-radius:999px;padding:6px 13px;font:inherit;font-size:12px;font-weight:600;background:linear-gradient(135deg,#818cf8,#22d3ee);color:#03050b;cursor:pointer}.hud-run button:disabled{opacity:.5}.hud-run span{font-size:11px;color:#86efac}.agentglow-embed{position:relative;overflow:hidden;width:100%;height:100%;min-height:320px;isolation:isolate}.agentglow-embed .scene-root{position:absolute;top:0;right:0;bottom:0;left:0}.agentglow-embed .hud-top{max-width:min(560px,calc(100% - 32px))}.agentglow-embed .hud-ticker{width:min(560px,calc(100% - 32px))}.agentglow-embed .hud-agents{width:min(360px,calc(100% - 32px));max-height:calc(100% - 140px)}.lod-cluster-label{all:unset;box-sizing:border-box;display:grid;gap:1px;text-align:center;cursor:pointer;pointer-events:auto;font-size:12px;font-weight:600;color:#f8fafc;padding:4px 11px 5px;border-radius:12px;white-space:nowrap;background:#03050b9e;border:1px solid color-mix(in srgb,var(--c, #818cf8) 60%,transparent);text-shadow:0 0 10px var(--c, #818cf8);box-shadow:0 0 18px color-mix(in srgb,var(--c, #818cf8) 22%,transparent);transition:border-color .2s,background .2s}.lod-cluster-label:hover{background:color-mix(in srgb,var(--c, #818cf8) 22%,rgba(3,5,11,.7));border-color:var(--c, #818cf8)}.lod-cluster-label b{font-weight:700;letter-spacing:-.01em}.lod-cluster-label small{font-size:10px;font-weight:500;color:#94a3b8;text-shadow:none;font-variant-numeric:tabular-nums}.hud-lod{left:50%;transform:translate(-50%);top:16px;padding:6px 8px 6px 14px;display:flex;align-items:center;gap:10px;font-size:12px;color:#cbd5e1;white-space:nowrap}.hud-lod b{color:#f1f5f9;font-variant-numeric:tabular-nums}.hud-lod i{width:7px;height:7px;border-radius:50%;background:#a5b4fc;box-shadow:0 0 8px #a5b4fc}.hud-lod button{all:unset;cursor:pointer;font-size:11px;padding:3px 9px;border-radius:999px;border:1px solid rgba(148,163,255,.25);color:#c7d2fe}.hud-lod button:hover{background:#818cf833;color:#f8fafc}@media(max-width:1100px){.hud-lod{top:auto;bottom:96px}}.scene-label.subway-station{font-size:10px;font-weight:500;padding:1px 6px;letter-spacing:.08em;text-transform:uppercase;color:#cbd5e1;opacity:.85}.scene-label.subway-airport{font-size:11px}.scene-label.subway-run{display:flex;flex-direction:column;align-items:flex-start;gap:3px;padding:4px 9px;border-radius:10px;font-size:11px}.subway-steps{display:flex;gap:4px}.subway-steps b{font-size:9px;font-weight:600;text-transform:uppercase;letter-spacing:.06em;padding:0 5px;border-radius:999px;color:#94a3b8;border:1px solid #334155;text-shadow:none}.subway-steps b[data-st=running]{color:#fde68a;border-color:#fbbf24;box-shadow:0 0 8px #fbbf2499}.subway-steps b[data-st=done]{color:#bbf7d0;border-color:#22c55e}.subway-steps b[data-st=failed]{color:#fecaca;border-color:#ef4444}.scene-label.subway-flare{font-size:10px;transition:opacity .2s}.city-root{background:#05040d}.city-district{display:grid;gap:4px;padding:5px 10px 6px;border-radius:10px;transition:opacity .4s}.city-district-top{display:flex;align-items:baseline;gap:8px}.city-district-top b{font-size:12px;color:#f8fafc}.city-count{font-size:10px;font-weight:500;color:#a5b4fc;text-shadow:none}.city-steps{display:flex;gap:4px}.city-chip{--sc: #3b4256;font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.08em;padding:1px 7px;border-radius:999px;color:var(--sc);border:1px solid color-mix(in srgb,var(--sc) 70%,transparent);text-shadow:none}.city-chip[data-st=running]{color:#03050b;background:var(--sc);box-shadow:0 0 10px var(--sc)}.city-chip[data-st=done]{color:var(--sc);background:color-mix(in srgb,var(--sc) 18%,transparent)}.city-chip[data-st=queued]{color:#64748b;border-color:#334155}.city-chip+.city-chip:before{content:""}.city-tower-label{font-size:13px}.city-mcp-label{font-size:11px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}.city-tower-label{font-size:15px;font-weight:800;letter-spacing:.06em;padding:3px 12px}.city-node-label{font-size:10px;transition:opacity .2s}.flow-run{display:flex;flex-direction:column;align-items:center;gap:4px;pointer-events:none}.flow-run .scene-label{font-size:11px;max-width:220px;overflow:hidden;text-overflow:ellipsis}.flow-steps{display:flex;gap:3px;font:600 9px/1 ui-monospace,SFMono-Regular,Menlo,monospace;text-transform:uppercase;letter-spacing:.06em}.flow-steps span{padding:2px 5px;border-radius:999px;color:#64748b;background:#03050b8c;border:1px solid rgba(100,116,139,.35)}.flow-steps span[data-s=running]{color:#03050b;background:var(--c);border-color:var(--c);box-shadow:0 0 12px var(--c)}.flow-steps span[data-s=done]{color:var(--c);border-color:color-mix(in srgb,var(--c) 60%,transparent)}.flow-steps span[data-s=failed]{color:#fecaca;background:#7f1d1d}.flow-step{font:600 9px/1 ui-monospace,SFMono-Regular,Menlo,monospace;text-transform:uppercase;letter-spacing:.08em;color:color-mix(in srgb,var(--c) 70%,white);text-shadow:0 0 8px var(--c);opacity:.55;pointer-events:none;white-space:nowrap;transition:opacity .3s}.flow-step[data-s=running]{opacity:1}.flow-hint{font-size:10px;padding:1px 7px;opacity:.9}.flow-label-core{font-size:11px;letter-spacing:.04em}.ap-root{background:radial-gradient(ellipse at 45% 50%,#03140e,#010604 60%,#000302)}.ap-root,.ap-tag,.ap-airport,.ap-gate,.ap-strip,.ap-wp,.ap-bearing{--mono: ui-monospace, "SF Mono", "JetBrains Mono", Menlo, monospace}.ap-bearing{font:600 9px/1 var(--mono);color:#2fae6e;letter-spacing:.08em;opacity:.85;text-shadow:0 0 6px rgba(70,255,154,.5)}.ap-tag{position:relative;width:0;height:0;pointer-events:none;transition:none}.ap-leader{position:absolute;left:6px;top:-22px;overflow:visible}.ap-leader line{stroke:color-mix(in srgb,var(--c) 45%,#46ff9a);stroke-width:1;opacity:.7}.ap-tag-box{position:absolute;left:28px;top:-38px;display:grid;gap:1px;padding:2px 6px 2px 5px;border-left:2px solid var(--c);background:#010c089e;white-space:nowrap}.ap-call{font:700 10px/1.15 var(--mono);letter-spacing:.06em;color:#d9ffe9;text-shadow:0 0 8px color-mix(in srgb,var(--c) 70%,transparent)}.ap-data{font:500 9px/1.15 var(--mono);letter-spacing:.05em;color:#57d897}.ap-tag-big .ap-call{font-size:12px}.ap-tag-big .ap-data{font-size:10px}.ap-airport{width:max-content;display:flex;align-items:center;gap:6px;white-space:nowrap;font:600 10px/1 var(--mono);color:#c8f7de;letter-spacing:.04em;padding:3px 7px;border:1px solid color-mix(in srgb,var(--c) 55%,transparent);background:#010a07b3;text-shadow:0 0 8px color-mix(in srgb,var(--c) 60%,transparent)}.ap-airport-code{font-weight:800;color:var(--c);letter-spacing:.1em}.ap-gate{white-space:nowrap;font:500 9px/1 var(--mono);color:#a6e9c6;letter-spacing:.03em;padding:2px 5px;background:#010a078c;border-bottom:1px solid color-mix(in srgb,var(--c) 50%,transparent)}.ap-gate.ap-hot{color:#fff;font-weight:700;border-bottom-color:var(--c);box-shadow:0 0 10px color-mix(in srgb,var(--c) 50%,transparent)}.ap-strip{width:max-content;display:grid;gap:2px;text-align:left;padding:4px 9px 4px 8px;border-left:3px solid var(--c);background:#010c08b8;outline:1px solid rgba(70,255,154,.14);max-width:260px}.ap-strip-topic{font:600 11px/1.25 Public Sans,system-ui,sans-serif;color:#e8fff1;white-space:normal}.ap-strip-sub{font:500 9px/1.2 var(--mono);color:#5fbf8d;letter-spacing:.05em;white-space:nowrap}.ap-wp{white-space:nowrap;font:600 9px/1 var(--mono);letter-spacing:.05em;color:#e9fffb;padding:2px 5px;border:1px solid color-mix(in srgb,var(--c, #38e8ff) 60%,transparent);background:#010a0aa6;text-shadow:0 0 8px var(--c, #38e8ff)}.ap-tag-left .ap-leader{left:-28px;transform:scaleX(-1)}.ap-tag-left .ap-tag-box{left:auto;right:28px;text-align:right;border-left:0;border-right:2px solid var(--c);padding:2px 5px 2px 6px}

package/dist/types/AgentScene.d.ts

@@ -0,0 +1,17 @@
+/** <AgentScene/>: one AgentGlow theme, sized to its container, fed by an agentglow server (or the simulator). */
+import { type CSSProperties } from "react";
+import { type Theme } from "./themes";
+export type AgentSceneProps = {
+    /** Visual theme. Default "neural". */
+    theme?: Theme;
+    /** agentglow server base URL, e.g. "http://localhost:8100". Default "" (same origin). */
+    source?: string;
+    /** Show the HUD (counts, event ticker, agent panel). Default true. */
+    hud?: boolean;
+    /** Use the built-in simulator instead of a server. Default false (auto-fallback if the server is unreachable). */
+    sim?: boolean;
+    style?: CSSProperties;
+    className?: string;
+};
+export declare function AgentScene({ theme, source, hud, sim, style, className }: AgentSceneProps): import("react").JSX.Element;
+export default AgentScene;

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { AgentScene, type AgentSceneProps } from "./AgentScene";
+export { THEMES, THEME_INFO, type Theme } from "./themes";
+export type { WorldEvent } from "./world";

package/dist/types/themes.d.ts

@@ -0,0 +1,12 @@
+/** The AgentGlow themes (scene modules live in src/scenes/<theme>/index.tsx). */
+import type { ComponentType } from "react";
+export declare const THEMES: readonly ["orbit", "neural", "subway", "city", "ocean", "circuit", "tunnel", "flow", "hive", "forest", "constellation", "factory", "airport", "mycelium", "atom"];
+export type Theme = (typeof THEMES)[number];
+export declare const THEME_INFO: Record<Theme, {
+    name: string;
+    tagline: string;
+}>;
+/** Lazy loaders, one chunk per theme (static strings so every bundler can split them). */
+export declare const THEME_LOADERS: Record<Theme, () => Promise<{
+    default: ComponentType;
+}>>;

package/dist/types/world.d.ts

@@ -0,0 +1,301 @@
+export type AgentType = "planner" | "researcher" | "graph_scout" | "records_scout" | "data_scout" | "writer";
+export type StepName = "plan" | "research" | "write";
+export type InstanceStatus = "spawning" | "thinking" | "waiting" | "done" | "failed";
+export type WorldEvent = {
+    type: "run";
+    run_id: string;
+    status: "started" | "completed" | "failed";
+    topic: string;
+    workflow: string;
+    ts: number;
+} | {
+    type: "step";
+    run_id: string;
+    step: StepName;
+    status: "running" | "done" | "failed";
+    ts: number;
+} | {
+    type: "spawn";
+    run_id: string;
+    id: string;
+    agent: string;
+    parent_id: string | null;
+    subagent?: boolean;
+    ts: number;
+} | {
+    type: "exit";
+    run_id: string;
+    id: string;
+    status: "done" | "failed";
+    ts: number;
+} | {
+    type: "agent";
+    run_id: string;
+    id: string;
+    status: "thinking" | "waiting";
+    ts: number;
+} | {
+    type: "llm";
+    run_id: string;
+    id: string;
+    tokens_in: number;
+    tokens_out: number;
+    latency_ms: number;
+    ts: number;
+} | {
+    type: "message";
+    run_id: string;
+    from_id: string;
+    to_id: string;
+    text: string;
+    ts: number;
+} | {
+    type: "tool";
+    run_id: string;
+    id: string;
+    tool: string;
+    args_preview: string;
+    ts: number;
+} | {
+    type: "graph";
+    run_id: string;
+    id: string;
+    op: "read" | "write";
+    nodes: string[];
+    ts: number;
+} | {
+    type: "final";
+    run_id: string;
+    text: string;
+    ts: number;
+} | {
+    type: "mcp_register";
+    run_id?: string;
+    server: string;
+    resources: {
+        name: string;
+        kind: ResourceKind;
+    }[];
+    ts: number;
+} | {
+    type: "mcp";
+    run_id: string;
+    id: string;
+    server: string;
+    tool: string;
+    phase: "call" | "result";
+    latency_ms?: number;
+    ts: number;
+    resource?: string;
+    resource_kind?: ResourceKind;
+};
+/** What sits behind an MCP server (the server is a node; its backends are nodes too). */
+export type ResourceKind = "db" | "warehouse" | "spark" | "api" | "storage" | "queue";
+export declare const AGENT_TYPES: {
+    type: AgentType;
+    label: string;
+    color: string;
+}[];
+export declare const TYPE_COLOR: Record<AgentType, string>;
+export declare const TYPE_LABEL: Record<AgentType, string>;
+export declare const STEPS: StepName[];
+export declare const RUN_COLORS: string[];
+export declare const KIND_COLOR: Record<string, string>;
+export type Instance = {
+    id: string;
+    run: string;
+    type: AgentType;
+    /** real agent name from the trace (e.g. "researcher", "web_scout", "report_writer") */
+    name: string;
+    parent: string | null;
+    status: InstanceStatus;
+    /** spawned by a parent agent via the deepagents `task` tool (vs a top-level workflow-step agent) */
+    subagent: boolean;
+    bornAt: number;
+    exitAt: number;
+    pulse: number;
+    pulseAt: number;
+    tokens: number;
+    index: number;
+    recent: WorldEvent[];
+    llmCalls: number;
+    toolCalls: number;
+    mcpCalls: number;
+    nodes: Set<string>;
+};
+export type Run = {
+    id: string;
+    topic: string;
+    workflow: string;
+    color: string;
+    slot: number;
+    status: "started" | "completed" | "failed";
+    steps: Record<StepName, "queued" | "running" | "done" | "failed">;
+    /** true once a step event arrives (e.g. Hatchet); plain agent runs have no steps */
+    hasSteps: boolean;
+    startedAt: number;
+    endedAt: number;
+    handoffAt: number;
+    handoffFrom: StepName;
+    handoffTo: StepName;
+    final: string;
+};
+export type Comet = {
+    id: number;
+    run: string;
+    from: string;
+    to: string;
+    start: number;
+    dur: number;
+    text: string;
+};
+/** External MCP servers agents call (persistent "satellites"; registered on first use). */
+export type McpResource = {
+    name: string;
+    kind: ResourceKind;
+    activeAt: number;
+    inflight: number;
+    calls: number;
+};
+export type McpServer = {
+    name: string;
+    color: string;
+    slot: number;
+    activeAt: number;
+    calls: number;
+    inflight: number;
+    resources: Map<string, McpResource>;
+};
+/** One MCP request/response: a packet flying instance → server ("call") or server → instance ("result"). */
+export type McpCall = {
+    id: number;
+    run: string;
+    instance: string;
+    server: string;
+    tool: string;
+    resource?: string;
+    phase: "call" | "result";
+    start: number;
+    dur: number;
+};
+/** An MCP call that has been sent but not answered yet: draw a live tether instance ↔ server while it waits. */
+export type McpPending = {
+    key: string;
+    run: string;
+    instance: string;
+    server: string;
+    tool: string;
+    resource?: string;
+    since: number;
+};
+export declare const MCP_COLORS: Record<string, string>;
+export type Flare = {
+    id: number;
+    run: string;
+    instance: string;
+    node: string;
+    op: "read" | "write";
+    start: number;
+};
+/** How long finished instances/runs stay visible while fading out (ms). */
+export declare const FADE_MS = 2500;
+export declare const RUN_LINGER_MS = 6000;
+/** Exit-fade length hook: lod.ts shortens it when the scene is crowded. Use `lingerMs(i)` instead of FADE_MS. */
+export declare const linger: {
+    fadeMs: (_i: Instance) => number;
+};
+/** How long this exited instance stays visible while fading out (ms). */
+export declare const lingerMs: (i: Instance) => number;
+export declare const world: {
+    runs: Map<string, Run>;
+    instances: Map<string, Instance>;
+    comets: Comet[];
+    flares: Flare[];
+    mcpServers: Map<string, McpServer>;
+    mcpCalls: McpCall[];
+    /** in-flight MCP calls keyed `${instance}|${server}|${tool}`; resolvedAt kept briefly for a "snap back" effect */
+    mcpPending: Map<string, McpPending>;
+    mcpResolved: (McpPending & {
+        resolvedAt: number;
+    })[];
+    ticker: WorldEvent[];
+    stats: {
+        runs: number;
+        spawned: number;
+        llmCalls: number;
+        tokens: number;
+        toolCalls: number;
+        graphReads: number;
+        graphWrites: number;
+        mcpCalls: number;
+    };
+    lastFinal: string;
+    simulated: boolean;
+    mode: "connecting" | "sim" | "live";
+    /** label for the graph/memory structure: names the DB only when the server provides a real graph */
+    graphLabel: string;
+    focus: string | null;
+    focusAt: number;
+    /** exited instances kept for the agent panel after their shape fades (newest last, capped) */
+    archive: Map<string, Instance>;
+    /** instance selected in the agent panel or by clicking a shape */
+    selected: string | null;
+};
+/** Subscribe a React component to world changes (HUD / DOM). Scenes should read `world` in useFrame instead. */
+export declare function useWorld(): {
+    runs: Map<string, Run>;
+    instances: Map<string, Instance>;
+    comets: Comet[];
+    flares: Flare[];
+    mcpServers: Map<string, McpServer>;
+    mcpCalls: McpCall[];
+    /** in-flight MCP calls keyed `${instance}|${server}|${tool}`; resolvedAt kept briefly for a "snap back" effect */
+    mcpPending: Map<string, McpPending>;
+    mcpResolved: (McpPending & {
+        resolvedAt: number;
+    })[];
+    ticker: WorldEvent[];
+    stats: {
+        runs: number;
+        spawned: number;
+        llmCalls: number;
+        tokens: number;
+        toolCalls: number;
+        graphReads: number;
+        graphWrites: number;
+        mcpCalls: number;
+    };
+    lastFinal: string;
+    simulated: boolean;
+    mode: "connecting" | "sim" | "live";
+    /** label for the graph/memory structure: names the DB only when the server provides a real graph */
+    graphLabel: string;
+    focus: string | null;
+    focusAt: number;
+    /** exited instances kept for the agent panel after their shape fades (newest last, capped) */
+    archive: Map<string, Instance>;
+    /** instance selected in the agent panel or by clicking a shape */
+    selected: string | null;
+};
+/** Stable pseudo-random 0..1 from a string (same id → same value, different ids → different values). */
+export declare const hash01: (id: string, salt?: number) => number;
+export declare function apply(ev: WorldEvent): void;
+export declare function tick(now?: number): void;
+/** 0..1 visibility for an instance: grows in on spawn, fades out after exit. */
+export declare function presence(i: Instance, now?: number): number;
+/** Current pulse energy (decays after each LLM/tool event). */
+export declare function energy(i: Instance, now?: number): number;
+/** Seconds an MCP call has been waiting (for tether intensity / color: amber → red past ~2s). */
+export declare function waitSeconds(p: McpPending, now?: number): number;
+/** Map any real agent name onto a visual role the scenes know (layout + color). */
+export declare function roleOf(name: string, subagent: boolean): AgentType;
+/** Visual size multiplier by role: parent agents read bigger, their subagents smaller. */
+export declare function roleScale(i: Instance): number;
+/** Look up a live or archived (exited) instance. */
+export declare function getInstance(id: string | null | undefined): Instance | undefined;
+/** Select an agent (panel list click or 3D click); null clears. */
+export declare function selectInstance(id: string | null): void;
+export declare function setSimulated(v: boolean): void;
+/** Name the graph structure (e.g. when the server serves a real FalkorDB sample). */
+export declare function setGraphLabel(label: string): void;
+export declare function setMode(m: "sim" | "live"): void;

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "agentglow",
+  "version": "0.1.0",
+  "description": "Live 3D views of agent systems (LangGraph, deepagents, any OpenTelemetry-instrumented agents) as a React component.",
+  "keywords": [
+    "opentelemetry",
+    "agents",
+    "3d",
+    "three.js",
+    "langgraph",
+    "deepagents",
+    "react",
+    "observability",
+    "react-three-fiber"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nideesh1/agentglow.git",
+    "directory": "frontend"
+  },
+  "homepage": "https://github.com/Nideesh1/agentglow#readme",
+  "bugs": {
+    "url": "https://github.com/Nideesh1/agentglow/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": [
+    "**/*.css",
+    "./dist/index.js"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run build:lib && npm run build:app",
+    "build:app": "tsc --noEmit && vite build",
+    "build:lib": "vite build -c vite.lib.config.ts && tsc -p tsconfig.lib.json && node scripts/postbuild-lib.mjs",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build:lib"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "dependencies": {
+    "@react-three/drei": "^10.7.9",
+    "@react-three/fiber": "^9.8.1",
+    "@react-three/postprocessing": "^3.1.3",
+    "postprocessing": "^6.39.5",
+    "three": "^0.186.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.4",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
+}