@almadar/ui 2.27.5 → 2.28.1

package/dist/components/index.cjs

@@ -33573,6 +33573,119 @@ function EventDispatcherTab({ traits: traits2, schema }) {
   ] });
 }
 EventDispatcherTab.displayName = "EventDispatcherTab";
+function ServerResponseRow({ sr }) {
+  const entityEntries = Object.entries(sr.dataEntities);
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ml-4 pl-2 border-l border-purple-700/50 py-0.5 text-[10px] font-mono", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: sr.success ? "text-green-400" : "text-red-400", children: [
+        sr.success ? "\u2713" : "\u2717",
+        " server"
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-purple-300", children: sr.orbitalName }),
+      sr.clientEffects > 0 && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "px-1 rounded bg-purple-900/50 text-purple-300", children: [
+        sr.clientEffects,
+        " clientEffect",
+        sr.clientEffects !== 1 ? "s" : ""
+      ] }),
+      sr.emittedEvents.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "px-1 rounded bg-blue-900/50 text-blue-300", children: [
+        "emit: ",
+        sr.emittedEvents.join(", ")
+      ] }),
+      sr.error && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "px-1 rounded bg-red-900/50 text-red-400 truncate max-w-[300px]", children: sr.error })
+    ] }),
+    entityEntries.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1 mt-0.5", children: entityEntries.map(([name, count]) => /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "px-1 rounded bg-gray-800 text-gray-300", children: [
+      name,
+      ": ",
+      count,
+      " row",
+      count !== 1 ? "s" : ""
+    ] }, name)) })
+  ] });
+}
+function TransitionRow({ trace }) {
+  const isServerEntry = !!trace.serverResponse && trace.traitName.startsWith("server:");
+  const hasFailedEffects = trace.effects.some((e) => e.status === "failed");
+  if (isServerEntry && trace.serverResponse) {
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "py-0.5 border-b border-gray-800 last:border-0", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-start gap-2 text-xs font-mono", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "mt-1.5 w-1.5 h-1.5 rounded-full flex-shrink-0 bg-purple-500" }),
+        /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "warning", size: "sm", className: "flex-shrink-0", children: trace.event }),
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-purple-400 flex-shrink-0", children: "server response" })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx(ServerResponseRow, { sr: trace.serverResponse })
+    ] });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "py-0.5 border-b border-gray-800 last:border-0", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-start gap-2 text-xs font-mono", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: cn(
+        "mt-1.5 w-1.5 h-1.5 rounded-full flex-shrink-0",
+        hasFailedEffects ? "bg-red-500" : "bg-green-500"
+      ) }),
+      /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "info", size: "sm", className: "flex-shrink-0", children: trace.event }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-gray-300 flex-shrink-0", children: trace.traitName }),
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-gray-400 flex-shrink-0", children: [
+        trace.from,
+        " ",
+        "\u2192",
+        " ",
+        trace.to
+      ] })
+    ] }),
+    trace.effects.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1 ml-6 mt-0.5", children: trace.effects.map((eff, i) => /* @__PURE__ */ jsxRuntime.jsxs("span", { className: cn(
+      "px-1 rounded text-[10px]",
+      eff.status === "executed" ? "bg-green-900/50 text-green-400" : eff.status === "failed" ? "bg-red-900/50 text-red-400" : "bg-yellow-900/50 text-yellow-400"
+    ), children: [
+      eff.status === "executed" ? "\u2713" : eff.status === "failed" ? "\u2717" : "-",
+      " ",
+      eff.type,
+      eff.args.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-gray-500 ml-0.5", children: JSON.stringify(eff.args).slice(0, 40) })
+    ] }, i)) }),
+    trace.serverResponse && /* @__PURE__ */ jsxRuntime.jsx(ServerResponseRow, { sr: trace.serverResponse })
+  ] });
+}
+function VerifyModePanel({
+  className,
+  failedChecks,
+  transitions,
+  traitStates,
+  serverCount,
+  localCount
+}) {
+  const scrollRef = React91__namespace.useRef(null);
+  const prevCountRef = React91__namespace.useRef(0);
+  React91__namespace.useEffect(() => {
+    if (transitions.length > prevCountRef.current && scrollRef.current) {
+      scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
+    }
+    prevCountRef.current = transitions.length;
+  }, [transitions.length]);
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: cn(
+        "runtime-debugger runtime-debugger--verify",
+        "fixed bottom-0 left-0 right-0 z-[9999] h-[35vh] flex flex-col bg-gray-900 text-white border-t-2 border-cyan-500",
+        className
+      ),
+      "data-testid": "debugger-verify",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "px-3 py-1.5 flex items-center gap-3 text-xs font-mono border-b border-gray-700 flex-shrink-0", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: failedChecks > 0 ? "danger" : "success", size: "sm", children: failedChecks > 0 ? `${failedChecks} fail` : "OK" }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-gray-400", children: [
+            localCount,
+            " local"
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-purple-400", children: [
+            serverCount,
+            " server"
+          ] }),
+          traitStates && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-cyan-400 truncate max-w-[400px]", children: traitStates })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { ref: scrollRef, className: "flex-1 overflow-y-auto", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-2 py-1", children: transitions.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-gray-500 text-xs font-mono py-2 text-center", children: "Waiting for transitions..." }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-0.5", children: transitions.map((trace) => /* @__PURE__ */ jsxRuntime.jsx(TransitionRow, { trace }, trace.id)) }) }) })
+      ]
+    }
+  );
+}
 function RuntimeDebugger({
   position = "bottom-right",
   defaultCollapsed = true,
@@ -33722,51 +33835,17 @@ function RuntimeDebugger({
   }
   if (mode === "verify") {
     const traitStates = debugData.traits.map((t) => `${t.name}:${t.currentState}`).join(" | ");
-    return /* @__PURE__ */ jsxRuntime.jsxs(
-      "div",
+    const serverEntries = verification.transitions.filter((t) => t.serverResponse);
+    const localEntries = verification.transitions.filter((t) => !t.serverResponse);
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      VerifyModePanel,
       {
-        className: cn(
-          "runtime-debugger runtime-debugger--verify",
-          "fixed bottom-0 left-0 right-0 z-[9999] h-[35vh] flex flex-col bg-gray-900 text-white border-t-2 border-cyan-500",
-          className
-        ),
-        "data-testid": "debugger-verify",
-        children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "px-3 py-1.5 flex items-center gap-3 text-xs font-mono border-b border-gray-700 flex-shrink-0", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: failedChecks > 0 ? "danger" : "success", size: "sm", children: failedChecks > 0 ? `${failedChecks} fail` : "OK" }),
-            /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-gray-400", children: [
-              verification.transitions.length,
-              " transitions"
-            ] }),
-            traitStates && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-cyan-400 truncate max-w-[400px]", children: traitStates })
-          ] }),
-          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex-1 overflow-y-auto", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-2 py-1", children: verification.transitions.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-gray-500 text-xs font-mono py-2 text-center", children: "Waiting for transitions..." }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-0.5", children: verification.transitions.map((trace) => {
-            const hasFailedEffects = trace.effects.some((e) => e.status === "failed");
-            return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-start gap-2 text-xs font-mono py-0.5 border-b border-gray-800 last:border-0", children: [
-              /* @__PURE__ */ jsxRuntime.jsx("span", { className: cn(
-                "mt-1.5 w-1.5 h-1.5 rounded-full flex-shrink-0",
-                hasFailedEffects ? "bg-red-500" : "bg-green-500"
-              ) }),
-              /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "info", size: "sm", className: "flex-shrink-0", children: trace.event }),
-              /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "text-gray-400 flex-shrink-0", children: [
-                trace.from,
-                " ",
-                "\u2192",
-                " ",
-                trace.to
-              ] }),
-              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex flex-wrap gap-1 ml-1", children: trace.effects.map((eff, i) => /* @__PURE__ */ jsxRuntime.jsxs("span", { className: cn(
-                "px-1 rounded text-[10px]",
-                eff.status === "executed" ? "bg-green-900/50 text-green-400" : eff.status === "failed" ? "bg-red-900/50 text-red-400" : "bg-yellow-900/50 text-yellow-400"
-              ), children: [
-                eff.status === "executed" ? "\u2713" : eff.status === "failed" ? "\u2717" : "-",
-                " ",
-                eff.type,
-                eff.args.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-gray-500 ml-0.5", children: JSON.stringify(eff.args).slice(0, 30) })
-              ] }, i)) })
-            ] }, trace.id);
-          }) }) }) })
-        ]
+        className,
+        failedChecks,
+        transitions: verification.transitions,
+        traitStates,
+        serverCount: serverEntries.length,
+        localCount: localEntries.length
       }
     );
   }

package/dist/components/index.js

@@ -33543,6 +33543,119 @@ function EventDispatcherTab({ traits: traits2, schema }) {
   ] });
 }
 EventDispatcherTab.displayName = "EventDispatcherTab";
+function ServerResponseRow({ sr }) {
+  const entityEntries = Object.entries(sr.dataEntities);
+  return /* @__PURE__ */ jsxs("div", { className: "ml-4 pl-2 border-l border-purple-700/50 py-0.5 text-[10px] font-mono", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsxs("span", { className: sr.success ? "text-green-400" : "text-red-400", children: [
+        sr.success ? "\u2713" : "\u2717",
+        " server"
+      ] }),
+      /* @__PURE__ */ jsx("span", { className: "text-purple-300", children: sr.orbitalName }),
+      sr.clientEffects > 0 && /* @__PURE__ */ jsxs("span", { className: "px-1 rounded bg-purple-900/50 text-purple-300", children: [
+        sr.clientEffects,
+        " clientEffect",
+        sr.clientEffects !== 1 ? "s" : ""
+      ] }),
+      sr.emittedEvents.length > 0 && /* @__PURE__ */ jsxs("span", { className: "px-1 rounded bg-blue-900/50 text-blue-300", children: [
+        "emit: ",
+        sr.emittedEvents.join(", ")
+      ] }),
+      sr.error && /* @__PURE__ */ jsx("span", { className: "px-1 rounded bg-red-900/50 text-red-400 truncate max-w-[300px]", children: sr.error })
+    ] }),
+    entityEntries.length > 0 && /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1 mt-0.5", children: entityEntries.map(([name, count]) => /* @__PURE__ */ jsxs("span", { className: "px-1 rounded bg-gray-800 text-gray-300", children: [
+      name,
+      ": ",
+      count,
+      " row",
+      count !== 1 ? "s" : ""
+    ] }, name)) })
+  ] });
+}
+function TransitionRow({ trace }) {
+  const isServerEntry = !!trace.serverResponse && trace.traitName.startsWith("server:");
+  const hasFailedEffects = trace.effects.some((e) => e.status === "failed");
+  if (isServerEntry && trace.serverResponse) {
+    return /* @__PURE__ */ jsxs("div", { className: "py-0.5 border-b border-gray-800 last:border-0", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2 text-xs font-mono", children: [
+        /* @__PURE__ */ jsx("span", { className: "mt-1.5 w-1.5 h-1.5 rounded-full flex-shrink-0 bg-purple-500" }),
+        /* @__PURE__ */ jsx(Badge, { variant: "warning", size: "sm", className: "flex-shrink-0", children: trace.event }),
+        /* @__PURE__ */ jsx("span", { className: "text-purple-400 flex-shrink-0", children: "server response" })
+      ] }),
+      /* @__PURE__ */ jsx(ServerResponseRow, { sr: trace.serverResponse })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "py-0.5 border-b border-gray-800 last:border-0", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2 text-xs font-mono", children: [
+      /* @__PURE__ */ jsx("span", { className: cn(
+        "mt-1.5 w-1.5 h-1.5 rounded-full flex-shrink-0",
+        hasFailedEffects ? "bg-red-500" : "bg-green-500"
+      ) }),
+      /* @__PURE__ */ jsx(Badge, { variant: "info", size: "sm", className: "flex-shrink-0", children: trace.event }),
+      /* @__PURE__ */ jsx("span", { className: "text-gray-300 flex-shrink-0", children: trace.traitName }),
+      /* @__PURE__ */ jsxs("span", { className: "text-gray-400 flex-shrink-0", children: [
+        trace.from,
+        " ",
+        "\u2192",
+        " ",
+        trace.to
+      ] })
+    ] }),
+    trace.effects.length > 0 && /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1 ml-6 mt-0.5", children: trace.effects.map((eff, i) => /* @__PURE__ */ jsxs("span", { className: cn(
+      "px-1 rounded text-[10px]",
+      eff.status === "executed" ? "bg-green-900/50 text-green-400" : eff.status === "failed" ? "bg-red-900/50 text-red-400" : "bg-yellow-900/50 text-yellow-400"
+    ), children: [
+      eff.status === "executed" ? "\u2713" : eff.status === "failed" ? "\u2717" : "-",
+      " ",
+      eff.type,
+      eff.args.length > 0 && /* @__PURE__ */ jsx("span", { className: "text-gray-500 ml-0.5", children: JSON.stringify(eff.args).slice(0, 40) })
+    ] }, i)) }),
+    trace.serverResponse && /* @__PURE__ */ jsx(ServerResponseRow, { sr: trace.serverResponse })
+  ] });
+}
+function VerifyModePanel({
+  className,
+  failedChecks,
+  transitions,
+  traitStates,
+  serverCount,
+  localCount
+}) {
+  const scrollRef = React91.useRef(null);
+  const prevCountRef = React91.useRef(0);
+  React91.useEffect(() => {
+    if (transitions.length > prevCountRef.current && scrollRef.current) {
+      scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
+    }
+    prevCountRef.current = transitions.length;
+  }, [transitions.length]);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "runtime-debugger runtime-debugger--verify",
+        "fixed bottom-0 left-0 right-0 z-[9999] h-[35vh] flex flex-col bg-gray-900 text-white border-t-2 border-cyan-500",
+        className
+      ),
+      "data-testid": "debugger-verify",
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "px-3 py-1.5 flex items-center gap-3 text-xs font-mono border-b border-gray-700 flex-shrink-0", children: [
+          /* @__PURE__ */ jsx(Badge, { variant: failedChecks > 0 ? "danger" : "success", size: "sm", children: failedChecks > 0 ? `${failedChecks} fail` : "OK" }),
+          /* @__PURE__ */ jsxs("span", { className: "text-gray-400", children: [
+            localCount,
+            " local"
+          ] }),
+          /* @__PURE__ */ jsxs("span", { className: "text-purple-400", children: [
+            serverCount,
+            " server"
+          ] }),
+          traitStates && /* @__PURE__ */ jsx("span", { className: "text-cyan-400 truncate max-w-[400px]", children: traitStates })
+        ] }),
+        /* @__PURE__ */ jsx("div", { ref: scrollRef, className: "flex-1 overflow-y-auto", children: /* @__PURE__ */ jsx("div", { className: "px-2 py-1", children: transitions.length === 0 ? /* @__PURE__ */ jsx("div", { className: "text-gray-500 text-xs font-mono py-2 text-center", children: "Waiting for transitions..." }) : /* @__PURE__ */ jsx("div", { className: "space-y-0.5", children: transitions.map((trace) => /* @__PURE__ */ jsx(TransitionRow, { trace }, trace.id)) }) }) })
+      ]
+    }
+  );
+}
 function RuntimeDebugger({
   position = "bottom-right",
   defaultCollapsed = true,
@@ -33692,51 +33805,17 @@ function RuntimeDebugger({
   }
   if (mode === "verify") {
     const traitStates = debugData.traits.map((t) => `${t.name}:${t.currentState}`).join(" | ");
-    return /* @__PURE__ */ jsxs(
-      "div",
+    const serverEntries = verification.transitions.filter((t) => t.serverResponse);
+    const localEntries = verification.transitions.filter((t) => !t.serverResponse);
+    return /* @__PURE__ */ jsx(
+      VerifyModePanel,
       {
-        className: cn(
-          "runtime-debugger runtime-debugger--verify",
-          "fixed bottom-0 left-0 right-0 z-[9999] h-[35vh] flex flex-col bg-gray-900 text-white border-t-2 border-cyan-500",
-          className
-        ),
-        "data-testid": "debugger-verify",
-        children: [
-          /* @__PURE__ */ jsxs("div", { className: "px-3 py-1.5 flex items-center gap-3 text-xs font-mono border-b border-gray-700 flex-shrink-0", children: [
-            /* @__PURE__ */ jsx(Badge, { variant: failedChecks > 0 ? "danger" : "success", size: "sm", children: failedChecks > 0 ? `${failedChecks} fail` : "OK" }),
-            /* @__PURE__ */ jsxs("span", { className: "text-gray-400", children: [
-              verification.transitions.length,
-              " transitions"
-            ] }),
-            traitStates && /* @__PURE__ */ jsx("span", { className: "text-cyan-400 truncate max-w-[400px]", children: traitStates })
-          ] }),
-          /* @__PURE__ */ jsx("div", { className: "flex-1 overflow-y-auto", children: /* @__PURE__ */ jsx("div", { className: "px-2 py-1", children: verification.transitions.length === 0 ? /* @__PURE__ */ jsx("div", { className: "text-gray-500 text-xs font-mono py-2 text-center", children: "Waiting for transitions..." }) : /* @__PURE__ */ jsx("div", { className: "space-y-0.5", children: verification.transitions.map((trace) => {
-            const hasFailedEffects = trace.effects.some((e) => e.status === "failed");
-            return /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2 text-xs font-mono py-0.5 border-b border-gray-800 last:border-0", children: [
-              /* @__PURE__ */ jsx("span", { className: cn(
-                "mt-1.5 w-1.5 h-1.5 rounded-full flex-shrink-0",
-                hasFailedEffects ? "bg-red-500" : "bg-green-500"
-              ) }),
-              /* @__PURE__ */ jsx(Badge, { variant: "info", size: "sm", className: "flex-shrink-0", children: trace.event }),
-              /* @__PURE__ */ jsxs("span", { className: "text-gray-400 flex-shrink-0", children: [
-                trace.from,
-                " ",
-                "\u2192",
-                " ",
-                trace.to
-              ] }),
-              /* @__PURE__ */ jsx("span", { className: "flex flex-wrap gap-1 ml-1", children: trace.effects.map((eff, i) => /* @__PURE__ */ jsxs("span", { className: cn(
-                "px-1 rounded text-[10px]",
-                eff.status === "executed" ? "bg-green-900/50 text-green-400" : eff.status === "failed" ? "bg-red-900/50 text-red-400" : "bg-yellow-900/50 text-yellow-400"
-              ), children: [
-                eff.status === "executed" ? "\u2713" : eff.status === "failed" ? "\u2717" : "-",
-                " ",
-                eff.type,
-                eff.args.length > 0 && /* @__PURE__ */ jsx("span", { className: "text-gray-500 ml-0.5", children: JSON.stringify(eff.args).slice(0, 30) })
-              ] }, i)) })
-            ] }, trace.id);
-          }) }) }) })
-        ]
+        className,
+        failedChecks,
+        transitions: verification.transitions,
+        traitStates,
+        serverCount: serverEntries.length,
+        localCount: localEntries.length
       }
     );
   }

package/dist/lib/index.cjs

@@ -513,6 +513,36 @@ function getTransitions() {
 function getTransitionsForTrait(traitName) {
   return getState().transitions.filter((t) => t.traitName === traitName);
 }
+function recordServerResponse(orbitalName, event, response) {
+  const serverResponse = {
+    ...response,
+    orbitalName,
+    timestamp: Date.now()
+  };
+  const entry = {
+    id: `srv-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+    traitName: `server:${orbitalName}`,
+    from: "server",
+    to: "server",
+    event,
+    effects: [],
+    serverResponse,
+    timestamp: Date.now()
+  };
+  getState().transitions.push(entry);
+  if (getState().transitions.length > MAX_TRANSITIONS) {
+    getState().transitions.shift();
+  }
+  if (!response.success && response.error) {
+    registerCheck(
+      `server-error-${entry.id}`,
+      `Server error for ${orbitalName}:${event}`,
+      "fail",
+      response.error
+    );
+  }
+  notifyListeners5();
+}
 function updateBridgeHealth(health) {
   getState().bridgeHealth = { ...health };
   const checkId = "server-bridge";
@@ -1482,6 +1512,7 @@ exports.onDebugToggle = onDebugToggle;
 exports.parseContentSegments = parseContentSegments;
 exports.parseMarkdownWithCodeBlocks = parseMarkdownWithCodeBlocks;
 exports.recordGuardEvaluation = recordGuardEvaluation;
+exports.recordServerResponse = recordServerResponse;
 exports.recordTransition = recordTransition;
 exports.registerCheck = registerCheck;
 exports.registerTick = registerTick;

package/dist/lib/index.js

@@ -511,6 +511,36 @@ function getTransitions() {
 function getTransitionsForTrait(traitName) {
   return getState().transitions.filter((t) => t.traitName === traitName);
 }
+function recordServerResponse(orbitalName, event, response) {
+  const serverResponse = {
+    ...response,
+    orbitalName,
+    timestamp: Date.now()
+  };
+  const entry = {
+    id: `srv-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+    traitName: `server:${orbitalName}`,
+    from: "server",
+    to: "server",
+    event,
+    effects: [],
+    serverResponse,
+    timestamp: Date.now()
+  };
+  getState().transitions.push(entry);
+  if (getState().transitions.length > MAX_TRANSITIONS) {
+    getState().transitions.shift();
+  }
+  if (!response.success && response.error) {
+    registerCheck(
+      `server-error-${entry.id}`,
+      `Server error for ${orbitalName}:${event}`,
+      "fail",
+      response.error
+    );
+  }
+  notifyListeners5();
+}
 function updateBridgeHealth(health) {
   getState().bridgeHealth = { ...health };
   const checkId = "server-bridge";
@@ -1416,4 +1446,4 @@ function parseContentSegments(content) {
   return segments;
 }
 
-export { ApiError, DEFAULT_CONFIG, apiClient, bindCanvasCapture, bindEventBus, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, recordGuardEvaluation, recordTransition, registerCheck, registerTick, registerTrait, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };
+export { ApiError, DEFAULT_CONFIG, apiClient, bindCanvasCapture, bindEventBus, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };

package/dist/lib/verificationRegistry.d.ts

@@ -25,6 +25,16 @@ export interface EffectTrace {
     error?: string;
     durationMs?: number;
 }
+/** Captures what the server returned for a given event */
+export interface ServerResponseTrace {
+    orbitalName: string;
+    success: boolean;
+    clientEffects: number;
+    dataEntities: Record<string, number>;
+    emittedEvents: string[];
+    error?: string;
+    timestamp: number;
+}
 export interface TransitionTrace {
     id: string;
     traitName: string;
@@ -34,6 +44,8 @@ export interface TransitionTrace {
     guardExpression?: string;
     guardResult?: boolean;
     effects: EffectTrace[];
+    /** Server response data when event was forwarded to server bridge */
+    serverResponse?: ServerResponseTrace;
     timestamp: number;
 }
 export interface BridgeHealth {
@@ -63,6 +75,12 @@ export declare function getAllChecks(): VerificationCheck[];
 export declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
 export declare function getTransitions(): TransitionTrace[];
 export declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
+/**
+ * Record a server response as a timeline entry.
+ * Creates a synthetic transition entry with type "server-response" to show
+ * what the server returned (clientEffects, data counts, emitted events).
+ */
+export declare function recordServerResponse(orbitalName: string, event: string, response: Omit<ServerResponseTrace, "orbitalName" | "timestamp">): void;
 export declare function updateBridgeHealth(health: BridgeHealth): void;
 export declare function getBridgeHealth(): BridgeHealth | null;
 export declare function getSummary(): VerificationSummary;

package/dist/providers/index.cjs

@@ -3411,17 +3411,42 @@ function VerificationProvider({
         const pending = pendingRef.current.get(key);
         pendingRef.current.delete(key);
         const newState = payload["newState"] ?? payload["state"] ?? "unknown";
-        const effects = Array.isArray(payload["clientEffects"]) ? payload["clientEffects"].map((e) => ({
+        const clientEffectsArr = Array.isArray(payload["clientEffects"]) ? payload["clientEffects"] : [];
+        const effects = clientEffectsArr.map((e) => ({
           type: String(e["type"] ?? "unknown"),
           args: Array.isArray(e["args"]) ? e["args"] : [],
           status: "executed"
-        })) : [];
+        }));
+        const effectResults = Array.isArray(payload["effectResults"]) ? payload["effectResults"] : [];
+        for (const er of effectResults) {
+          effects.push({
+            type: String(er["type"] ?? er["effect"] ?? "server-effect"),
+            args: [er["entity"] ?? er["service"] ?? ""].filter(Boolean),
+            status: er["error"] ? "failed" : "executed",
+            error: er["error"]
+          });
+        }
+        const dataEntities = {};
+        const responseData = payload["data"];
+        if (responseData && typeof responseData === "object") {
+          for (const [entityName, records] of Object.entries(responseData)) {
+            dataEntities[entityName] = Array.isArray(records) ? records.length : 0;
+          }
+        }
         recordTransition({
           traitName: parsed.traitName,
           from: pending?.from ?? payload["currentState"] ?? newState,
           to: newState,
           event: parsed.event,
           effects,
+          serverResponse: {
+            orbitalName: parsed.traitName,
+            success: true,
+            clientEffects: clientEffectsArr.length,
+            dataEntities,
+            emittedEvents: [],
+            timestamp: Date.now()
+          },
           timestamp: Date.now()
         });
       } else if (parsed.kind === "error" && parsed.event) {
@@ -3442,6 +3467,15 @@ function VerificationProvider({
             status: "failed",
             error: errorMsg
           }],
+          serverResponse: {
+            orbitalName: parsed.traitName,
+            success: false,
+            clientEffects: 0,
+            dataEntities: {},
+            emittedEvents: [],
+            error: errorMsg,
+            timestamp: Date.now()
+          },
           timestamp: Date.now()
         });
       }

package/dist/providers/index.js

@@ -3381,17 +3381,42 @@ function VerificationProvider({
         const pending = pendingRef.current.get(key);
         pendingRef.current.delete(key);
         const newState = payload["newState"] ?? payload["state"] ?? "unknown";
-        const effects = Array.isArray(payload["clientEffects"]) ? payload["clientEffects"].map((e) => ({
+        const clientEffectsArr = Array.isArray(payload["clientEffects"]) ? payload["clientEffects"] : [];
+        const effects = clientEffectsArr.map((e) => ({
           type: String(e["type"] ?? "unknown"),
           args: Array.isArray(e["args"]) ? e["args"] : [],
           status: "executed"
-        })) : [];
+        }));
+        const effectResults = Array.isArray(payload["effectResults"]) ? payload["effectResults"] : [];
+        for (const er of effectResults) {
+          effects.push({
+            type: String(er["type"] ?? er["effect"] ?? "server-effect"),
+            args: [er["entity"] ?? er["service"] ?? ""].filter(Boolean),
+            status: er["error"] ? "failed" : "executed",
+            error: er["error"]
+          });
+        }
+        const dataEntities = {};
+        const responseData = payload["data"];
+        if (responseData && typeof responseData === "object") {
+          for (const [entityName, records] of Object.entries(responseData)) {
+            dataEntities[entityName] = Array.isArray(records) ? records.length : 0;
+          }
+        }
         recordTransition({
           traitName: parsed.traitName,
           from: pending?.from ?? payload["currentState"] ?? newState,
           to: newState,
           event: parsed.event,
           effects,
+          serverResponse: {
+            orbitalName: parsed.traitName,
+            success: true,
+            clientEffects: clientEffectsArr.length,
+            dataEntities,
+            emittedEvents: [],
+            timestamp: Date.now()
+          },
           timestamp: Date.now()
         });
       } else if (parsed.kind === "error" && parsed.event) {
@@ -3412,6 +3437,15 @@ function VerificationProvider({
             status: "failed",
             error: errorMsg
           }],
+          serverResponse: {
+            orbitalName: parsed.traitName,
+            success: false,
+            clientEffects: 0,
+            dataEntities: {},
+            emittedEvents: [],
+            error: errorMsg,
+            timestamp: Date.now()
+          },
           timestamp: Date.now()
         });
       }

package/dist/runtime/ServerBridge.d.ts

@@ -7,9 +7,21 @@ export interface ServerClientEffect {
     params?: Record<string, unknown>;
     message?: string;
 }
+/** Metadata about what the server returned, for debugger logging */
+export interface ServerResponseMeta {
+    success: boolean;
+    clientEffects: number;
+    dataEntities: Record<string, number>;
+    emittedEvents: string[];
+    error?: string;
+}
+export interface SendEventResult {
+    effects: ServerClientEffect[];
+    meta: ServerResponseMeta;
+}
 export interface ServerBridgeContextValue {
     connected: boolean;
-    sendEvent: (orbitalName: string, event: string, payload?: Record<string, unknown>) => Promise<ServerClientEffect[]>;
+    sendEvent: (orbitalName: string, event: string, payload?: Record<string, unknown>) => Promise<SendEventResult>;
 }
 /**
  * Access the server bridge. Returns a no-op stub when outside the provider.