@clemrig/factory 0.1.0 → 0.2.1

package/dist/ui/static/timeline.js

@@ -1,180 +0,0 @@
-// @ts-check
-/**
- * The dashboard's pure logic: a run's events grouped into one block per stage
- * execution, and the formats of durations and costs. Served as is to the browser.
- */
-
-/** @typedef {import("../../engine/types.js").RunEvent} RunEvent */
-/** @typedef {import("../../engine/types.js").AgentActivity} AgentActivity */
-/** @typedef {import("../../engine/metrics.js").TokenCounts} TokenCounts */
-/** @typedef {import("../../engine/metrics.js").AgentUsage} AgentUsage */
-
-/**
- * @typedef {object} Call
- * @property {string} [runtime]
- * @property {string} [model]
- * @property {string} [session]
- * @property {"running" | "completed" | "failed"} status
- * @property {AgentUsage} [usage] As the runtime announced it at the end of the call.
- * @property {"call" | "session"} [scope] Whether `usage` is the call's own or its session's total.
- */
-
-/**
- * @typedef {object} Tool
- * @property {string} id
- * @property {string} name
- * @property {"running" | "completed" | "failed"} status
- * @property {number} [durationMs]
- */
-
-/**
- * @typedef {object} Block
- * @property {string} stage
- * @property {string} kind
- * @property {"running" | "passed" | "failed" | "completed"} status
- * @property {string} startedAt
- * @property {number | null} durationMs
- * @property {{ verdict: string; reason: string; destination: string | null }} [decision]
- * @property {{ key: string; count: number; max: number }} [retry]
- * @property {string} [detail]
- * @property {Call} [call]
- * @property {Tool[]} tools
- * @property {TokenCounts | null} tokens The call's responses so far.
- * @property {boolean} provisional Whether `tokens` includes figures replaced at the end of the call.
- * @property {string[]} warnings
- * @property {{ at: string; message: string }[]} journal
- */
-
-/**
- * @param {string} stage
- * @param {string} kind
- * @param {string} at
- * @returns {Block}
- */
-const block = (stage, kind, at) => ({
-  stage,
-  kind,
-  status: "running",
-  startedAt: at,
-  durationMs: null,
-  tools: [],
-  tokens: null,
-  provisional: false,
-  warnings: [],
-  journal: [],
-});
-
-/**
- * @param {Block} target
- * @param {AgentActivity} activity
- */
-function apply(target, activity) {
-  switch (activity.kind) {
-    case "call":
-      if (activity.status === "started") {
-        const { runtime, model, session } = activity;
-        target.call = { runtime, model, session, status: "running" };
-      } else
-        target.call = {
-          ...target.call,
-          runtime: activity.runtime,
-          status: activity.status,
-          usage: activity.usage,
-          scope: activity.scope,
-        };
-      break;
-    case "tool": {
-      const tool = target.tools.find(({ id }) => id === activity.id);
-      const update =
-        activity.status === "started"
-          ? { id: activity.id, name: activity.name, status: "running" }
-          : {
-              id: activity.id,
-              name: activity.name,
-              status: activity.status,
-              durationMs: activity.durationMs,
-            };
-      if (tool) Object.assign(tool, update);
-      else target.tools.push(/** @type {Tool} */ (update));
-      break;
-    }
-    case "response": {
-      const sum = target.tokens ?? {
-        input: 0,
-        output: 0,
-        cacheRead: 0,
-        cacheWrite: 0,
-      };
-      for (const field of /** @type {const} */ ([
-        "input",
-        "output",
-        "cacheRead",
-        "cacheWrite",
-      ]))
-        sum[field] += activity.tokens[field];
-      target.tokens = sum;
-      target.provisional ||= activity.provisional;
-      break;
-    }
-    case "warning":
-      target.warnings.push(activity.message);
-  }
-}
-
-/**
- * One block per stage execution, in order: a stage's journal, agent activity
- * and decision go to its latest block.
- * @param {RunEvent[]} events
- * @returns {Block[]}
- */
-export function timeline(events) {
-  /** @type {Block[]} */
-  const blocks = [];
-  const latest = (/** @type {string} */ stage) =>
-    blocks.findLast((candidate) => candidate.stage === stage);
-  for (const event of events) {
-    if (event.type === "stage" && event.status === "started") {
-      blocks.push(block(event.stage, event.kind, event.at));
-      continue;
-    }
-    let target = latest(event.stage);
-    if (!target || (event.type === "stage" && target.status !== "running")) {
-      // A stage reported without a start, such as one failed by an interruption.
-      target = block(event.stage, event.kind, event.at);
-      blocks.push(target);
-    }
-    if (event.type === "stage") {
-      target.status = event.status === "started" ? "running" : event.status;
-      target.durationMs = Date.parse(event.at) - Date.parse(target.startedAt);
-      if (event.decision) target.decision = event.decision;
-      if (event.retry) target.retry = event.retry;
-      if (event.detail) target.detail = event.detail;
-    } else if (event.type === "log")
-      target.journal.push({ at: event.at, message: event.message });
-    else apply(target, event.activity);
-  }
-  return blocks;
-}
-
-/**
- * @param {number | null} ms
- * @returns {string}
- */
-export function duration(ms) {
-  if (ms === null) return "—";
-  const seconds = Math.floor(ms / 1000);
-  const hours = Math.floor(seconds / 3600);
-  const minutes = Math.floor((seconds % 3600) / 60);
-  return `${hours ? `${hours} h ` : ""}${minutes} min ${seconds % 60} s`;
-}
-
-/**
- * An estimated cost as the runtimes announced it; unknown without any measure.
- * @param {number | null} usd
- * @param {boolean} partial Some agent call announced no usage.
- * @returns {string}
- */
-export function cost(usd, partial) {
-  const value = usd === null ? "—" : `${usd.toFixed(4)} USD`;
-  return partial ? `${value} (partial)` : value;
-}