Start, stop and pause flows, and show what their nodes print

Flows can now be taken off the engine and put back. Stopped state lives in a runtime.json beside the flow, not in the flow document: the canvas autosaves that document, so a stopped flow would otherwise start itself again on the next edit. A stopped flow gets no subscriptions, schedules or webhooks, its nodes are skipped by the scheduler, and running it answers 409. Pausing holds a flow's nodes while its values keep arriving, so the canvas still shows what is coming in. Node code is user code and print is how it says things, so stdout is teed through a contextvar sink active only during a node execution — one event per execution, capped, so a chatty node cannot outrun the stream. A node that fails sends its traceback the same way, trimmed to the author's own frames. The dock gains a logs panel and a pause control; the dashboard replaces its placeholder with what is running, stopped or failing; the edge inspector can send the last message again. Single-stepping is deferred and noted: the scheduler keeps no progress between calls, so a step button would re-run the same node rather than advance. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-15 23:35:08 +02:00
parent 606ab3c423
commit 7344eac262
29 changed files with 1410 additions and 48 deletions
@@ -0,0 +1,120 @@
+import { Terminal } from "lucide-react"
+import { useEffect, useRef } from "react"
+
+import { Button } from "@/components/ui/button"
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover"
+import { ScrollArea } from "@/components/ui/scroll-area"
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/ui/tooltip"
+import { cn } from "@/lib/utils"
+import { liveStore, useLiveLogs } from "./liveStore"
+
+function shortTime(ts: number): string {
+  return new Date(ts * 1000).toLocaleTimeString(undefined, {
+    hour12: false,
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+  })
+}
+
+/** Drop the flow prefix: every line in here belongs to the open flow. */
+function nodeLabel(nodeId: string, flow: string): string {
+  return nodeId.startsWith(`${flow}.`) ? nodeId.slice(flow.length + 1) : nodeId
+}
+
+/**
+ * What the nodes of this flow printed, and the tracebacks of the ones that
+ * failed — the detail the one-line error bubble on a node has no room for.
+ */
+export function LogsPanel({ flow }: { flow: string }) {
+  const lines = useLiveLogs().filter((line) => line.flow === flow)
+  const bottom = useRef<HTMLLIElement | null>(null)
+
+  // Follow the tail, which is where a running flow puts what just happened.
+  // biome-ignore lint/correctness/useExhaustiveDependencies: a new line is what scrolls.
+  useEffect(() => {
+    bottom.current?.scrollIntoView({ block: "end" })
+  }, [lines.length])
+
+  return (
+    <Popover>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <PopoverTrigger asChild>
+            <Button
+              variant="ghost"
+              size="icon"
+              className="size-11 text-muted-foreground md:size-8"
+              aria-label="Logs"
+              data-testid="flow-logs"
+            >
+              <Terminal />
+            </Button>
+          </PopoverTrigger>
+        </TooltipTrigger>
+        <TooltipContent>What this flow printed</TooltipContent>
+      </Tooltip>
+
+      <PopoverContent align="center" className="w-[28rem] p-0">
+        <div className="flex items-center justify-between border-b border-border px-3 py-2">
+          <p className="text-xs font-medium uppercase tracking-[0.5px] text-muted-foreground">
+            Logs
+          </p>
+          <Button
+            variant="ghost"
+            size="sm"
+            className="h-6 px-2 text-xs text-muted-foreground"
+            onClick={() => liveStore.clearLogs()}
+            disabled={lines.length === 0}
+          >
+            Clear
+          </Button>
+        </div>
+
+        {lines.length === 0 ? (
+          <p className="px-3 py-6 text-center text-sm text-muted-foreground">
+            Nothing yet. Anything a node prints shows up here.
+          </p>
+        ) : (
+          <ScrollArea className="h-72">
+            <ul className="grid gap-1.5 p-3 font-mono text-xs">
+              {lines.map((line, index) => (
+                <li
+                  // Lines are append-only and repeat freely, so position is the
+                  // only stable identity they have.
+                  key={`${line.ts}-${line.node}-${index}`}
+                  className="grid grid-cols-[auto_1fr] gap-2"
+                >
+                  <span className="text-muted-foreground">
+                    {shortTime(line.ts)}{" "}
+                    <span className="text-foreground/70">
+                      {nodeLabel(line.node, flow)}
+                    </span>
+                  </span>
+                  <span
+                    className={cn(
+                      "whitespace-pre-wrap break-words",
+                      line.level === "error" && "text-destructive",
+                    )}
+                  >
+                    {line.text.replace(/\n+$/, "")}
+                    {line.truncated ? "\n… truncated" : ""}
+                  </span>
+                </li>
+              ))}
+              <li ref={bottom} aria-hidden />
+            </ul>
+          </ScrollArea>
+        )}
+      </PopoverContent>
+    </Popover>
+  )
+}