@lumea-labs/orchestrator 0.1.0

package/dist/swarm-run-activity.js

@@ -0,0 +1,289 @@
+"use client";
+import { useState } from "react";
+import {
+  AlertTriangle,
+  ArrowDown,
+  ArrowUp,
+  CheckCircle2,
+  ChevronDown,
+  ChevronUp,
+  ExternalLink,
+  FileText,
+  Hash,
+  Image as ImageIcon,
+  MessageSquareMore,
+  Quote,
+  RotateCcw,
+  Scale,
+  StickyNote,
+  Wrench
+} from "lucide-react";
+function buildSwarmRunActivity(run, options = {}) {
+  const events = [];
+  const startedAt = run.startedAt ?? run.finishedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  const finishedAt = run.finishedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  const tools = run.toolCalls ?? [];
+  if (tools.length > 0) {
+    const start = new Date(startedAt).getTime();
+    const end = new Date(finishedAt).getTime();
+    const span = Math.max(end - start, 1);
+    tools.forEach((tc, i) => {
+      const ts = new Date(start + Math.round(span * (i + 1) / (tools.length + 1))).toISOString();
+      events.push({
+        id: `tool:${tc.id}`,
+        ts,
+        kind: "tool_call",
+        agentName: run.agent?.name,
+        tool: {
+          id: tc.id,
+          name: tc.name,
+          state: tc.state,
+          arguments: tc.arguments,
+          result: tc.result,
+          summary: tc.summary
+        }
+      });
+    });
+  }
+  if (typeof run.retries === "number" && run.retries > 0) {
+    const start = new Date(startedAt).getTime();
+    const end = new Date(finishedAt).getTime();
+    const span = Math.max(end - start, 1);
+    for (let i = 1; i <= run.retries; i++) {
+      const ts = new Date(start + Math.round(span * i / (run.retries + 1))).toISOString();
+      events.push({
+        id: `retry:${i}`,
+        ts,
+        kind: "retry",
+        attempt: i,
+        agentName: run.agent?.name
+      });
+    }
+  }
+  if (run.output) {
+    events.push({
+      id: "output:final",
+      ts: finishedAt,
+      kind: "output",
+      text: run.output,
+      agentName: run.agent?.name
+    });
+  }
+  if (run.error) {
+    events.push({
+      id: "error:final",
+      ts: finishedAt,
+      kind: "error",
+      message: run.error,
+      agentName: run.agent?.name
+    });
+  }
+  for (const a of run.artifacts ?? []) {
+    events.push({
+      id: `artifact:${a.id}`,
+      ts: finishedAt,
+      kind: "artifact",
+      artifact: a,
+      agentName: run.agent?.name
+    });
+  }
+  if (options.extras?.length) events.push(...options.extras);
+  events.sort((a, b) => a.ts.localeCompare(b.ts));
+  return events;
+}
+function SwarmRunActivityStream({
+  events,
+  agents,
+  renderToolCall,
+  renderMarkdown,
+  renderEvent,
+  peek = 6,
+  emptyLabel = "No activity yet.",
+  className
+}) {
+  const [expanded, setExpanded] = useState(false);
+  if (events.length === 0) {
+    return /* @__PURE__ */ React.createElement(
+      "div",
+      {
+        className: [
+          "px-4 py-6 text-center font-mono text-[11px] uppercase tracking-[0.16em] text-p-ink-3",
+          className || ""
+        ].join(" ")
+      },
+      emptyLabel
+    );
+  }
+  const peekable = events.length > peek;
+  const visible = !peekable || expanded ? events : events.slice(events.length - peek);
+  const hidden = events.length - visible.length;
+  return /* @__PURE__ */ React.createElement("div", { className: className || "" }, peekable && !expanded ? /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      type: "button",
+      onClick: () => setExpanded(true),
+      className: "mb-2 inline-flex w-full items-center justify-center gap-1 rounded-md border border-dashed border-p-line bg-p-bg/40 py-1.5 font-mono text-[10.5px] font-bold uppercase tracking-[0.16em] text-p-ink-3 transition-colors cursor-pointer hover:border-p-ink-3 hover:text-p-ink"
+    },
+    /* @__PURE__ */ React.createElement(ChevronUp, { className: "size-3" }),
+    "show ",
+    hidden,
+    " earlier event",
+    hidden === 1 ? "" : "s"
+  ) : null, /* @__PURE__ */ React.createElement("ol", { className: "flex flex-col divide-y divide-p-line/60" }, visible.map((ev) => {
+    const custom = renderEvent?.(ev);
+    if (custom !== void 0) {
+      return /* @__PURE__ */ React.createElement("li", { key: ev.id, className: "py-3" }, custom);
+    }
+    return /* @__PURE__ */ React.createElement(
+      "li",
+      {
+        key: ev.id,
+        className: "grid grid-cols-[80px_24px_minmax(0,1fr)] items-start gap-3 py-3"
+      },
+      /* @__PURE__ */ React.createElement(TimeGutter, { ts: ev.ts }),
+      /* @__PURE__ */ React.createElement(KindGlyph, { kind: ev.kind }),
+      /* @__PURE__ */ React.createElement(
+        EventBody,
+        {
+          event: ev,
+          agents,
+          renderToolCall,
+          renderMarkdown
+        }
+      )
+    );
+  })), peekable && expanded ? /* @__PURE__ */ React.createElement(
+    "button",
+    {
+      type: "button",
+      onClick: () => setExpanded(false),
+      className: "mt-2 inline-flex w-full items-center justify-center gap-1 rounded-md border border-dashed border-p-line bg-p-bg/40 py-1.5 font-mono text-[10.5px] font-bold uppercase tracking-[0.16em] text-p-ink-3 transition-colors cursor-pointer hover:border-p-ink-3 hover:text-p-ink"
+    },
+    /* @__PURE__ */ React.createElement(ChevronDown, { className: "size-3" }),
+    "show less"
+  ) : null);
+}
+function TimeGutter({ ts }) {
+  const t = new Date(ts);
+  const hh = String(t.getHours()).padStart(2, "0");
+  const mm = String(t.getMinutes()).padStart(2, "0");
+  const ss = String(t.getSeconds()).padStart(2, "0");
+  return /* @__PURE__ */ React.createElement("span", { className: "pt-0.5 font-mono text-[10.5px] uppercase tracking-[0.16em] text-p-ink-3 tabular-nums" }, hh, ":", mm, ":", ss);
+}
+const KIND_TONE = {
+  phase: "text-[#2B44FF]",
+  thought: "text-p-ink-3",
+  tool_call: "text-p-ink-2",
+  ask_user: "text-p-accent",
+  user_input: "text-p-ink",
+  output: "text-p-ink",
+  artifact: "text-p-ink-2",
+  error: "text-[#E63946]",
+  retry: "text-[#D4A017]",
+  checkpoint: "text-[#8A6B0B]",
+  score: "text-p-green"
+};
+function KindGlyph({ kind }) {
+  const Icon = kind === "phase" ? RotateCcw : kind === "thought" ? Quote : kind === "tool_call" ? Wrench : kind === "ask_user" ? MessageSquareMore : kind === "user_input" ? ArrowDown : kind === "output" ? ArrowUp : kind === "artifact" ? FileText : kind === "error" ? AlertTriangle : kind === "retry" ? RotateCcw : kind === "checkpoint" ? CheckCircle2 : Scale;
+  return /* @__PURE__ */ React.createElement(
+    "span",
+    {
+      "aria-hidden": true,
+      className: [
+        "mt-1 grid size-5 place-items-center rounded-full border border-p-line bg-p-surface",
+        KIND_TONE[kind]
+      ].join(" ")
+    },
+    /* @__PURE__ */ React.createElement(Icon, { className: "size-3" })
+  );
+}
+function EventBody({
+  event,
+  agents,
+  renderToolCall,
+  renderMarkdown
+}) {
+  const agent = event.agentName ? agents?.find((a) => a.name === event.agentName) : void 0;
+  return /* @__PURE__ */ React.createElement("div", { className: "min-w-0 flex flex-col gap-1.5" }, /* @__PURE__ */ React.createElement("div", { className: "flex items-baseline gap-2" }, /* @__PURE__ */ React.createElement(
+    "span",
+    {
+      className: [
+        "font-mono text-[10px] font-bold uppercase tracking-[0.18em]",
+        KIND_TONE[event.kind]
+      ].join(" ")
+    },
+    event.kind.replace(/_/g, " ")
+  ), agent ? /* @__PURE__ */ React.createElement("span", { className: "inline-flex items-center gap-1 font-mono text-[10px] uppercase tracking-[0.14em] text-p-ink-3" }, /* @__PURE__ */ React.createElement(
+    "span",
+    {
+      "aria-hidden": true,
+      className: "grid size-3.5 shrink-0 place-items-center rounded-[3px] font-display text-[8.5px] font-bold text-white",
+      style: { background: agent.color || "#999" }
+    },
+    agent.glyph || (agent.displayName ?? agent.name).charAt(0).toUpperCase()
+  ), agent.displayName ?? agent.name) : null), /* @__PURE__ */ React.createElement(
+    EventContent,
+    {
+      event,
+      renderToolCall,
+      renderMarkdown
+    }
+  ));
+}
+function EventContent({
+  event,
+  renderToolCall,
+  renderMarkdown
+}) {
+  switch (event.kind) {
+    case "phase":
+      return /* @__PURE__ */ React.createElement("p", { className: "font-mono text-[11.5px] uppercase tracking-[0.14em] text-p-ink-2" }, "\u2192 ", event.phase);
+    case "thought":
+      return /* @__PURE__ */ React.createElement("p", { className: "font-body text-[13px] italic leading-[1.55] text-p-ink-3" }, event.text);
+    case "tool_call":
+      if (renderToolCall) return /* @__PURE__ */ React.createElement(React.Fragment, null, renderToolCall(event.tool));
+      return /* @__PURE__ */ React.createElement("div", { className: "rounded-md border border-p-line bg-p-bg px-2.5 py-1.5" }, /* @__PURE__ */ React.createElement("code", { className: "font-mono text-[11.5px] font-semibold text-p-ink" }, event.tool.name), event.tool.summary ? /* @__PURE__ */ React.createElement("span", { className: "ml-2 truncate font-mono text-[11px] text-p-ink-3" }, event.tool.summary) : null);
+    case "ask_user":
+      return /* @__PURE__ */ React.createElement("p", { className: "rounded-md border border-p-accent/40 bg-p-accent-light/40 px-3 py-2 font-body text-[13px] leading-[1.55] text-p-ink" }, event.question);
+    case "user_input":
+      return renderMarkdown ? /* @__PURE__ */ React.createElement("div", null, renderMarkdown(event.text)) : /* @__PURE__ */ React.createElement("p", { className: "font-body text-[13px] leading-[1.55] text-p-ink" }, event.text);
+    case "output":
+      return renderMarkdown ? /* @__PURE__ */ React.createElement("div", null, renderMarkdown(event.text)) : /* @__PURE__ */ React.createElement("pre", { className: "m-0 whitespace-pre-wrap break-words font-body text-[13px] leading-[1.55] text-p-ink-2" }, event.text);
+    case "artifact":
+      return /* @__PURE__ */ React.createElement(ArtifactRow, { artifact: event.artifact });
+    case "error":
+      return /* @__PURE__ */ React.createElement("pre", { className: "m-0 whitespace-pre-wrap break-words font-mono text-[11.5px] leading-relaxed text-[#E63946]" }, event.message);
+    case "retry":
+      return /* @__PURE__ */ React.createElement("p", { className: "font-mono text-[11.5px] uppercase tracking-[0.14em] text-p-ink-2" }, "attempt ", event.attempt, event.reason ? ` \xB7 ${event.reason}` : null);
+    case "checkpoint":
+      return /* @__PURE__ */ React.createElement("div", { className: "font-mono text-[11.5px] uppercase tracking-[0.14em] text-p-ink-2" }, /* @__PURE__ */ React.createElement("span", { className: "font-bold" }, event.name), /* @__PURE__ */ React.createElement("span", { className: "ml-2 text-p-ink-3" }, "\xB7 ", event.verdict), event.message ? /* @__PURE__ */ React.createElement("p", { className: "mt-1 normal-case font-body text-[13px] tracking-normal text-p-ink-3" }, event.message) : null);
+    case "score": {
+      const scale = event.scale ?? { min: 1, max: 5 };
+      return /* @__PURE__ */ React.createElement("div", { className: "flex items-baseline gap-2 font-mono text-[11.5px] uppercase tracking-[0.14em]" }, /* @__PURE__ */ React.createElement("span", { className: "text-p-ink-2" }, event.criterion), /* @__PURE__ */ React.createElement("span", { className: "font-display text-[16px] font-bold tabular-nums text-p-ink" }, event.value, /* @__PURE__ */ React.createElement("span", { className: "text-p-ink-3" }, "/", scale.max)), event.reasoning ? /* @__PURE__ */ React.createElement("span", { className: "ml-2 normal-case tracking-normal text-p-ink-3" }, event.reasoning) : null);
+    }
+  }
+}
+function ArtifactRow({
+  artifact
+}) {
+  const Icon = artifact.kind === "url" ? ExternalLink : artifact.kind === "image" ? ImageIcon : artifact.kind === "data" ? Hash : artifact.kind === "note" ? StickyNote : FileText;
+  const interactive = !!artifact.url;
+  const Wrapper = interactive ? "a" : "div";
+  return /* @__PURE__ */ React.createElement(
+    Wrapper,
+    {
+      ...interactive ? { href: artifact.url, target: "_blank", rel: "noreferrer noopener" } : {},
+      className: [
+        "flex items-center gap-2 rounded-md border border-p-line bg-p-surface px-2.5 py-1.5 no-underline",
+        interactive ? "cursor-pointer hover:bg-p-warm/40" : ""
+      ].join(" ")
+    },
+    /* @__PURE__ */ React.createElement(Icon, { className: "size-3 shrink-0 text-p-ink-3", "aria-hidden": true }),
+    /* @__PURE__ */ React.createElement("span", { className: "min-w-0 flex-1 truncate font-display text-[12.5px] font-semibold text-p-ink" }, artifact.label),
+    artifact.path ? /* @__PURE__ */ React.createElement("code", { className: "hidden truncate font-mono text-[10.5px] text-p-ink-3 sm:inline" }, artifact.path) : null
+  );
+}
+export {
+  SwarmRunActivityStream,
+  buildSwarmRunActivity
+};

package/dist/swarm-run-card.d.ts

@@ -0,0 +1,22 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { SwarmRun, SwarmLabels } from './types.js';
+
+interface SwarmRunCardProps {
+    run: SwarmRun;
+    /** Live clock — pass `state.now` from `useSwarm()` so the elapsed
+     *  counter ticks. When omitted, falls back to `Date.now()` per render. */
+    now?: number;
+    /** Consumer-rendered avatar — overrides the glyph chip. */
+    renderAvatar?: (agent: SwarmRun["agent"]) => ReactNode;
+    /** Trailing slot for tool-call chips, log streams, custom adornments. */
+    bodySlot?: ReactNode;
+    onCancel?: (id: string) => void;
+    onRetry?: (id: string) => void;
+    onOpen?: (id: string) => void;
+    labels?: Partial<SwarmLabels>;
+    className?: string;
+}
+declare function SwarmRunCard({ run, now, renderAvatar, bodySlot, onCancel, onRetry, onOpen, labels, className, }: SwarmRunCardProps): react.JSX.Element;
+
+export { SwarmRunCard, type SwarmRunCardProps };

package/dist/swarm-run-card.js

@@ -0,0 +1,91 @@
+"use client";
+import { RotateCcw, Square } from "lucide-react";
+import { defaultSwarmLabels } from "./types";
+import { elapsedSeconds } from "./lib/format";
+import { SwarmStatusPill } from "./swarm-status-pill";
+import { SwarmAgentBadge } from "./swarm-agent-badge";
+function SwarmRunCard({
+  run,
+  now,
+  renderAvatar,
+  bodySlot,
+  onCancel,
+  onRetry,
+  onOpen,
+  labels,
+  className
+}) {
+  const L = { ...defaultSwarmLabels, ...labels };
+  const clock = now ?? Date.now();
+  const elapsed = elapsedSeconds(run.startedAt, run.finishedAt, clock);
+  const isLive = run.status === "running" || run.status === "pending";
+  const showCancel = onCancel && (run.status === "running" || run.status === "pending");
+  const showRetry = onRetry && (run.status === "failed" || run.status === "cancelled");
+  return /* @__PURE__ */ React.createElement(
+    "article",
+    {
+      className: [
+        "group relative flex flex-col gap-2 rounded-xl border bg-p-surface p-3 transition-shadow",
+        run.status === "running" ? "border-p-accent/40 shadow-[0_0_0_4px_rgba(226,115,61,0.05)]" : run.status === "failed" ? "border-[#E63946]/40" : "border-p-line",
+        onOpen ? "cursor-pointer hover:shadow-[0_8px_24px_-16px_rgba(0,0,0,0.18)]" : "",
+        className || ""
+      ].join(" "),
+      onClick: onOpen ? () => onOpen(run.id) : void 0
+    },
+    /* @__PURE__ */ React.createElement("header", { className: "flex items-start gap-2" }, /* @__PURE__ */ React.createElement(
+      SwarmAgentBadge,
+      {
+        agent: run.agent,
+        avatar: renderAvatar?.(run.agent),
+        size: "md",
+        showName: true
+      }
+    ), /* @__PURE__ */ React.createElement("span", { className: "ml-auto" }), /* @__PURE__ */ React.createElement(
+      SwarmStatusPill,
+      {
+        status: run.status,
+        label: L[run.status],
+        size: "sm"
+      }
+    )),
+    /* @__PURE__ */ React.createElement("p", { className: "line-clamp-2 font-body text-[13px] leading-snug text-p-ink-2" }, run.title),
+    run.progress !== void 0 && isLive ? /* @__PURE__ */ React.createElement("div", { className: "h-1 w-full overflow-hidden rounded-full bg-p-warm" }, /* @__PURE__ */ React.createElement(
+      "div",
+      {
+        className: "h-full rounded-full bg-p-accent transition-[width] duration-500 ease-out",
+        style: { width: `${Math.max(0, Math.min(100, run.progress * 100))}%` }
+      }
+    )) : null,
+    run.lastLog ? /* @__PURE__ */ React.createElement("div", { className: "rounded-md bg-p-bg px-2 py-1 font-mono text-[11px] leading-snug text-p-ink-3 truncate" }, run.lastLog) : null,
+    run.error ? /* @__PURE__ */ React.createElement("div", { className: "rounded-md border border-[#E63946]/30 bg-[#FEF2F2] px-2 py-1 font-mono text-[11px] leading-snug text-[#E63946]" }, run.error) : null,
+    bodySlot,
+    /* @__PURE__ */ React.createElement("footer", { className: "mt-1 flex items-center gap-2 font-mono text-[10px] uppercase tracking-[0.14em] text-p-ink-3" }, /* @__PURE__ */ React.createElement("span", { className: "tabular-nums" }, run.startedAt ? isLive ? L.startedAgo(elapsed) : L.duration(elapsed) : "\u2014"), run.background ? /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("span", { className: "text-p-line" }, "\xB7"), /* @__PURE__ */ React.createElement("span", null, L.backgroundGroup)) : null, /* @__PURE__ */ React.createElement("span", { className: "ml-auto inline-flex items-center gap-1.5" }, showCancel ? /* @__PURE__ */ React.createElement(
+      "button",
+      {
+        type: "button",
+        onClick: (e) => {
+          e.stopPropagation();
+          onCancel(run.id);
+        },
+        className: "inline-flex items-center gap-1 rounded-md px-1.5 py-0.5 text-p-ink-3 transition-colors cursor-pointer hover:bg-p-warm hover:text-[#E63946]"
+      },
+      /* @__PURE__ */ React.createElement(Square, { className: "size-2.5" }),
+      L.cancel
+    ) : null, showRetry ? /* @__PURE__ */ React.createElement(
+      "button",
+      {
+        type: "button",
+        onClick: (e) => {
+          e.stopPropagation();
+          onRetry(run.id);
+        },
+        className: "inline-flex items-center gap-1 rounded-md px-1.5 py-0.5 text-p-ink-3 transition-colors cursor-pointer hover:bg-p-warm hover:text-p-ink"
+      },
+      /* @__PURE__ */ React.createElement(RotateCcw, { className: "size-2.5" }),
+      L.retry
+    ) : null))
+  );
+}
+export {
+  SwarmRunCard
+};

package/dist/swarm-run-detail.d.ts

@@ -0,0 +1,45 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { SwarmRun, SwarmToolCall, SwarmArtifact, SwarmEvaluation, SwarmLabels } from './types.js';
+
+type SwarmRunDetailVariant = "tabs" | "flat";
+interface SwarmRunDetailProps {
+    run: SwarmRun;
+    now?: number;
+    /** `"tabs"` (default) — output / artifacts / tools in a tab strip.
+     *  `"flat"`  — every block stacked vertically, scroll-driven, in the
+     *  shape of an editorial task report. */
+    variant?: SwarmRunDetailVariant;
+    renderAvatar?: (agent: SwarmRun["agent"]) => ReactNode;
+    /** Slot for rendering tool-call rows. Receives the run's tool
+     *  calls; consumer wires `<ToolCallChip>` from `@lumea-labs/chat`. */
+    renderToolCalls?: (toolCalls: SwarmToolCall[]) => ReactNode;
+    /** Render the artifacts list. Falls back to a built-in ledger that
+     *  groups by kind. */
+    renderArtifacts?: (artifacts: SwarmArtifact[]) => ReactNode;
+    /** Render the evaluation block (LLM-as-a-judge / G-Eval). Receives
+     *  the run's `evaluation` overlay; consumer wires `<JudgeScoreRadar>`
+     *  / `<JudgeVerdictHero>` from `@lumea-labs/judge` (or any custom
+     *  view). When omitted but `run.evaluation` is present, a compact
+     *  built-in summary is shown. */
+    renderEvaluation?: (evaluation: SwarmEvaluation) => ReactNode;
+    /** Render Markdown for the goal and output blocks. When omitted, the
+     *  text is rendered as a `<pre>` (plain). The orchestrator package
+     *  doesn't ship its own Markdown renderer — wire {@link
+     *  https://github.com/vercel/streamdown streamdown} or any equivalent
+     *  on the consumer side. */
+    renderMarkdown?: (text: string) => ReactNode;
+    /** Hide the tools tab (in `tabs` variant) and the tools section (in
+     *  `flat` variant). Use this when the surface already shows tool
+     *  calls inline in an activity stream — having them duplicated as a
+     *  tab is noisy. Default `false`. */
+    hideTools?: boolean;
+    onClose?: () => void;
+    onCancel?: (id: string) => void;
+    onRetry?: (id: string) => void;
+    labels?: Partial<SwarmLabels>;
+    className?: string;
+}
+declare function SwarmRunDetail({ run, now, variant, renderAvatar, renderToolCalls, renderArtifacts, renderEvaluation, renderMarkdown, hideTools, onClose, onCancel, onRetry, labels, className, }: SwarmRunDetailProps): react.JSX.Element;
+
+export { SwarmRunDetail, type SwarmRunDetailProps, type SwarmRunDetailVariant };