npm - @ryanfw/prompt-orchestration-pipeline - Versions diffs - 0.6.0 → 0.8.0 - Mend

@ryanfw/prompt-orchestration-pipeline 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (62) hide show

package/README.md +1 -2
package/package.json +1 -2
package/src/api/validators/json.js +39 -0
package/src/components/DAGGrid.jsx +392 -303
package/src/components/JobCard.jsx +13 -11
package/src/components/JobDetail.jsx +41 -71
package/src/components/JobTable.jsx +32 -22
package/src/components/Layout.jsx +0 -21
package/src/components/LiveText.jsx +47 -0
package/src/components/TaskDetailSidebar.jsx +216 -0
package/src/components/TimerText.jsx +82 -0
package/src/components/ui/RestartJobModal.jsx +140 -0
package/src/components/ui/toast.jsx +138 -0
package/src/config/models.js +322 -0
package/src/config/statuses.js +119 -0
package/src/core/config.js +2 -164
package/src/core/file-io.js +1 -1
package/src/core/module-loader.js +54 -40
package/src/core/pipeline-runner.js +52 -26
package/src/core/status-writer.js +147 -3
package/src/core/symlink-bridge.js +55 -0
package/src/core/symlink-utils.js +94 -0
package/src/core/task-runner.js +267 -443
package/src/llm/index.js +167 -52
package/src/pages/Code.jsx +57 -3
package/src/pages/PipelineDetail.jsx +92 -22
package/src/pages/PromptPipelineDashboard.jsx +15 -36
package/src/providers/anthropic.js +83 -69
package/src/providers/base.js +52 -0
package/src/providers/deepseek.js +17 -34
package/src/providers/gemini.js +226 -0
package/src/providers/openai.js +36 -106
package/src/providers/zhipu.js +136 -0
package/src/ui/client/adapters/job-adapter.js +16 -26
package/src/ui/client/api.js +134 -0
package/src/ui/client/hooks/useJobDetailWithUpdates.js +65 -178
package/src/ui/client/index.css +9 -0
package/src/ui/client/index.html +1 -0
package/src/ui/client/main.jsx +18 -15
package/src/ui/client/time-store.js +161 -0
package/src/ui/config-bridge.js +15 -24
package/src/ui/config-bridge.node.js +15 -24
package/src/ui/dist/assets/{index-WgJUlSmE.js → index-DqkbzXZ1.js} +1408 -771
package/src/ui/dist/assets/style-DBF9NQGk.css +62 -0
package/src/ui/dist/index.html +3 -2
package/src/ui/public/favicon.svg +12 -0
package/src/ui/server.js +231 -38
package/src/ui/transformers/status-transformer.js +18 -31
package/src/ui/watcher.js +5 -1
package/src/utils/dag.js +8 -4
package/src/utils/duration.js +13 -19
package/src/utils/formatters.js +27 -0
package/src/utils/geometry-equality.js +83 -0
package/src/utils/pipelines.js +5 -1
package/src/utils/time-utils.js +40 -0
package/src/utils/token-cost-calculator.js +4 -7
package/src/utils/ui.jsx +14 -16
package/src/components/ui/select.jsx +0 -27
package/src/lib/utils.js +0 -6
package/src/ui/client/hooks/useTicker.js +0 -26
package/src/ui/config-bridge.browser.js +0 -149
package/src/ui/dist/assets/style-x0V-5m8e.css +0 -62

package/src/ui/dist/index.html CHANGED Viewed

@@ -10,8 +10,9 @@
       rel="stylesheet"
     />
     <title>Prompt Pipeline Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-WgJUlSmE.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/style-x0V-5m8e.css">
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <script type="module" crossorigin src="/assets/index-DqkbzXZ1.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/style-DBF9NQGk.css">
   </head>
   <body>
     <div id="root"></div>

package/src/ui/public/favicon.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="32"
+  height="32"
+  viewBox="0 0 1200 1200"
+>
+  <path
+    fill="#009966"
+    d="M406.13 988.31c-17.297 75.047-84.562 131.11-164.86 131.11-93.375 0-169.18-75.797-169.18-169.18s75.797-169.18 169.18-169.18 169.18 75.797 169.18 169.18v1.266h447.74v-167.9H671.63c-14.859 0-29.062-5.906-39.562-16.406s-16.406-24.703-16.406-39.562v-37.312h-317.16c-10.312 0-18.656-8.344-18.656-18.656V355.78h-147.94c-14.859 0-29.062-5.906-39.562-16.406s-16.406-24.75-16.406-39.562v-111.94c0-14.859 5.906-29.109 16.406-39.562 10.5-10.5 24.75-16.406 39.562-16.406h391.78c14.859 0 29.062 5.906 39.562 16.406s16.406 24.75 16.406 39.562v37.312h202.4c9.281-84.609 81.094-150.52 168.14-150.52 93.375 0 169.18 75.797 169.18 169.18s-75.797 169.18-169.18 169.18c-87.047 0-158.86-65.906-168.14-150.52h-202.4v37.312c0 14.859-5.906 29.062-16.406 39.562s-24.75 16.406-39.562 16.406h-206.53v297.24h298.5v-37.312c0-14.859 5.906-29.062 16.406-39.562s24.703-16.406 39.562-16.406h392.63c14.859 0 29.062 5.906 39.562 16.406s16.406 24.703 16.406 39.562v111.94c0 14.859-5.906 29.062-16.406 39.562s-24.75 16.406-39.562 16.406h-168.74v186.56c0 10.312-8.344 18.656-18.656 18.656h-466.4c-1.5 0-2.906-.187-4.312-.516zM225.19 262.45h18.656c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656H225.19c-10.312 0-18.656 8.344-18.656 18.656s8.344 18.656 18.656 18.656zm186.56 0h18.656c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656H411.75c-10.312 0-18.656 8.344-18.656 18.656s8.344 18.656 18.656 18.656zm-93.281 0h18.656c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656h-18.656c-10.312 0-18.656 8.344-18.656 18.656s8.344 18.656 18.656 18.656zm616.18 0h85.5c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656h-85.5l29.062-22.594c8.109-6.328 9.609-18.047 3.281-26.156s-18.047-9.609-26.156-3.281l-71.953 55.969a18.61 18.61 0 0 0 0 29.438l71.953 55.969c8.109 6.328 19.875 4.875 26.156-3.281 6.328-8.109 4.875-19.875-3.281-26.203l-29.062-22.594zm-779.95 696.66l50.391 50.391c7.266 7.313 19.078 7.313 26.391 0l100.73-100.73c7.266-7.266 7.266-19.078 0-26.391-7.266-7.266-19.078-7.266-26.391 0l-87.562 87.562-37.172-37.172c-7.266-7.266-19.078-7.266-26.391 0-7.266 7.266-7.266 19.078 0 26.391zm797.21-268.78h18.656c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656h-18.656c-10.312 0-18.656 8.344-18.656 18.656s8.344 18.656 18.656 18.656zm-186.56 0h18.656c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656h-18.656c-10.312 0-18.656 8.344-18.656 18.656s8.344 18.656 18.656 18.656zm93.281 0h18.656c10.312 0 18.656-8.344 18.656-18.656s-8.344-18.656-18.656-18.656H858.63c-10.312 0-18.656 8.344-18.656 18.656s8.344 18.656 18.656 18.656z"
+    fill-rule="evenodd"
+  />
+</svg>

package/src/ui/server.js CHANGED Viewed

@@ -12,6 +12,8 @@ import * as state from "./state.js";
 // Import orchestrator-related functions only in non-test mode
 let submitJobWithValidation;
 import { sseRegistry } from "./sse.js";
+import { resetJobToCleanSlate } from "../core/status-writer.js";
+import { spawn } from "node:child_process";
 import {
   getPendingSeedPath,
   resolvePipelinePaths,
@@ -29,6 +31,22 @@ const __dirname = path.dirname(__filename);
 // Vite dev server instance (populated in development mode)
 let viteServer = null;
+// In-memory restart guard to prevent duplicate concurrent restarts per job
+const restartingJobs = new Set();
+// Helper functions for restart guard
+function isRestartInProgress(jobId) {
+  return restartingJobs.has(jobId);
+}
+function beginRestart(jobId) {
+  restartingJobs.add(jobId);
+}
+function endRestart(jobId) {
+  restartingJobs.delete(jobId);
+}
 // Configuration
 const PORT = process.env.PORT || 4000;
 const WATCHED_PATHS = (
@@ -1412,49 +1430,206 @@ function createServer() {
     // Route: GET /api/llm/functions
     if (pathname === "/api/llm/functions" && req.method === "GET") {
       try {
-        const { getConfig } = await import("../core/config.js");
-        const config = getConfig();
-        // Helper to convert model alias to camelCase function name
-        const toCamelCase = (alias) => {
-          const [provider, ...modelParts] = alias.split(":");
-          const model = modelParts.join("-");
-          const camelModel = model.replace(/-([a-z0-9])/g, (match, char) =>
-            char.toUpperCase()
-          );
-          return camelModel;
-        };
+        const { PROVIDER_FUNCTIONS } = await import("../config/models.js");
-        // Filter for deepseek, openai only (no gemini provider exists)
-        const targetProviders = ["deepseek", "openai"];
-        const functions = {};
+        sendJson(res, 200, PROVIDER_FUNCTIONS);
+      } catch (error) {
+        console.error("Error handling /api/llm/functions:", error);
+        sendJson(res, 500, {
+          ok: false,
+          error: "internal_error",
+          message: "Failed to get LLM functions",
+        });
+      }
+      return;
+    }
-        for (const [alias, modelConfig] of Object.entries(config.llm.models)) {
-          const { provider } = modelConfig;
-          if (!targetProviders.includes(provider)) continue;
+    // Route: POST /api/jobs/:jobId/restart
+    if (
+      pathname.startsWith("/api/jobs/") &&
+      pathname.endsWith("/restart") &&
+      req.method === "POST"
+    ) {
+      const pathMatch = pathname.match(/^\/api\/jobs\/([^\/]+)\/restart$/);
+      if (!pathMatch) {
+        sendJson(res, 400, {
+          ok: false,
+          error: "bad_request",
+          message: "Invalid path format",
+        });
+        return;
+      }
+      const [, jobId] = pathMatch;
+      const dataDir = process.env.PO_ROOT || DATA_DIR;
+      try {
+        // Validate jobId
+        if (!jobId || typeof jobId !== "string" || jobId.trim() === "") {
+          sendJson(res, 400, {
+            ok: false,
+            error: "bad_request",
+            message: "jobId is required",
+          });
+          return;
+        }
+        // Resolve job lifecycle
+        const lifecycle = await resolveJobLifecycle(dataDir, jobId);
+        if (!lifecycle) {
+          sendJson(res, 404, {
+            ok: false,
+            code: "job_not_found",
+            message: "Job not found",
+          });
+          return;
+        }
-          if (!functions[provider]) {
-            functions[provider] = [];
+        // Only support current lifecycle for MVP
+        if (lifecycle !== "current") {
+          sendJson(res, 409, {
+            ok: false,
+            code: "unsupported_lifecycle",
+            message:
+              "Job restart is only supported for jobs in 'current' lifecycle",
+          });
+          return;
+        }
+        // Check if job is already running
+        const jobDir = getJobDirectoryPath(dataDir, jobId, "current");
+        const statusPath = path.join(jobDir, "tasks-status.json");
+        let snapshot;
+        try {
+          const content = await fs.promises.readFile(statusPath, "utf8");
+          snapshot = JSON.parse(content);
+        } catch (error) {
+          if (error.code === "ENOENT") {
+            sendJson(res, 404, {
+              ok: false,
+              code: "job_not_found",
+              message: "Job status file not found",
+            });
+            return;
           }
+          throw error;
+        }
+        // Guard against running jobs
+        if (snapshot.state === "running") {
+          sendJson(res, 409, {
+            ok: false,
+            code: "job_running",
+            message: "Job is currently running",
+          });
+          return;
+        }
-          const functionName = toCamelCase(alias);
-          functions[provider].push({
-            alias,
-            functionName,
-            fullPath: `llm.${provider}.${functionName}`,
-            model: modelConfig.model,
+        // Guard against concurrent restarts
+        if (isRestartInProgress(jobId)) {
+          sendJson(res, 409, {
+            ok: false,
+            code: "job_running",
+            message: "Job restart is already in progress",
           });
+          return;
         }
-        sendJson(res, 200, functions);
+        // Begin restart guard
+        beginRestart(jobId);
+        try {
+          // Parse optional fromTask from request body for targeted restart
+          let body = {};
+          try {
+            const rawBody = await readRawBody(req);
+            body = JSON.parse(rawBody.toString("utf8"));
+          } catch (error) {
+            sendJson(res, 400, {
+              ok: false,
+              error: "bad_request",
+              message: "Invalid JSON in request body",
+            });
+            return;
+          }
+          const { fromTask } = body;
+          // Reset job: clean-slate or partial from a specific task
+          const { resetJobFromTask } = await import("../core/status-writer.js");
+          if (fromTask) {
+            await resetJobFromTask(jobDir, fromTask, { clearTokenUsage: true });
+          } else {
+            await resetJobToCleanSlate(jobDir, { clearTokenUsage: true });
+          }
+          // Spawn detached pipeline-runner process
+          const runnerPath = path.join(__dirname, "../core/pipeline-runner.js");
+          const base = process.env.PO_ROOT || DATA_DIR;
+          const env = {
+            ...process.env,
+            PO_ROOT: base,
+            PO_DATA_DIR: path.join(base, "pipeline-data"),
+            PO_PENDING_DIR: path.join(base, "pipeline-data", "pending"),
+            PO_CURRENT_DIR: path.join(base, "pipeline-data", "current"),
+            PO_COMPLETE_DIR: path.join(base, "pipeline-data", "complete"),
+            ...(fromTask && { PO_START_FROM_TASK: fromTask }),
+          };
+          const child = spawn(process.execPath, [runnerPath, jobId], {
+            env,
+            stdio: "ignore",
+            detached: true,
+          });
+          // Unref the child process so it runs in the background
+          child.unref();
+          // Send success response
+          sendJson(res, 202, {
+            ok: true,
+            jobId,
+            mode: "clean-slate",
+            spawned: true,
+          });
+          console.log(
+            `Job ${jobId} restarted successfully, detached runner PID: ${child.pid}`
+          );
+        } finally {
+          // Always end restart guard
+          endRestart(jobId);
+        }
       } catch (error) {
-        console.error("Error handling /api/llm/functions:", error);
-        sendJson(res, 500, {
-          ok: false,
-          error: "internal_error",
-          message: "Failed to get LLM functions",
-        });
+        console.error(`Error handling POST /api/jobs/${jobId}/restart:`, error);
+        // Clean up restart guard on error
+        if (isRestartInProgress(jobId)) {
+          endRestart(jobId);
+        }
+        if (error.code === "ENOENT") {
+          sendJson(res, 404, {
+            ok: false,
+            code: "job_not_found",
+            message: "Job directory not found",
+          });
+        } else if (error.code === "spawn failed") {
+          sendJson(res, 500, {
+            ok: false,
+            code: "spawn_failed",
+            message: error.message || "Failed to spawn pipeline runner",
+          });
+        } else {
+          sendJson(res, 500, {
+            ok: false,
+            code: "internal_error",
+            message: "Internal server error",
+          });
+        }
       }
       return;
     }
@@ -1490,6 +1665,25 @@ function createServer() {
       return;
     }
+    // Route: GET /favicon.svg
+    if (pathname === "/favicon.svg" && req.method === "GET") {
+      const faviconPath = path.join(__dirname, "public", "favicon.svg");
+      try {
+        const content = await fs.promises.readFile(faviconPath, "utf8");
+        res.writeHead(200, {
+          "Content-Type": "image/svg+xml",
+          "Cache-Control": "public, max-age=3600", // Cache for 1 hour
+        });
+        res.end(content);
+      } catch (error) {
+        console.error("Error serving favicon:", error);
+        res.writeHead(404);
+        res.end("Favicon not found");
+      }
+      return;
+    }
     // Unknown API endpoint fallback (keep API responses in JSON)
     if (pathname.startsWith("/api/")) {
       res.writeHead(200, { "Content-Type": "application/json" });
@@ -1678,11 +1872,6 @@ async function startServer({ dataDir, port: customPort }) {
     const { initPATHS } = await import("./config-bridge.node.js");
     initPATHS(dataDir);
-    // Set the data directory environment variable
-    if (dataDir) {
-      process.env.PO_ROOT = dataDir;
-    }
     // Require PO_ROOT for non-test runs
     if (!process.env.PO_ROOT) {
       if (process.env.NODE_ENV !== "test") {
@@ -1853,6 +2042,10 @@ export {
   initializeWatcher,
   state,
   resolveJobLifecycle,
+  restartingJobs,
+  isRestartInProgress,
+  beginRestart,
+  endRestart,
 };
 // Start server if run directly

package/src/ui/transformers/status-transformer.js CHANGED Viewed

@@ -4,24 +4,12 @@ import {
   calculateJobCosts,
   formatCostDataForAPI,
 } from "../../utils/token-cost-calculator.js";
-const VALID_TASK_STATES = new Set(["pending", "running", "done", "failed"]);
-/**
- * Determine job-level status from tasks mapping.
- */
-export function determineJobStatus(tasks = {}) {
-  if (!tasks || typeof tasks !== "object") return "pending";
-  const names = Object.keys(tasks);
-  if (names.length === 0) return "pending";
-  const states = names.map((n) => tasks[n]?.state);
-  if (states.includes("failed")) return "failed";
-  if (states.includes("running")) return "running";
-  if (states.every((s) => s === "done")) return "complete";
-  return "pending";
-}
+import {
+  VALID_TASK_STATES,
+  normalizeTaskState,
+  deriveJobStatusFromTasks,
+  TaskState,
+} from "../../config/statuses.js";
 /**
  * Compute job status object { status, progress } and emit warnings for unknown states.
@@ -50,14 +38,14 @@ export function computeJobStatus(tasksInput, existingProgress = null) {
     const t = tasksInput[name];
     const state = t && typeof t === "object" ? t.state : undefined;
-    if (state == null || !VALID_TASK_STATES.has(state)) {
-      if (state != null && !VALID_TASK_STATES.has(state)) {
-        unknownStatesFound.add(state);
-      }
-      normalized[name] = { state: "pending" };
-    } else {
-      normalized[name] = { state };
+    const normalizedState = normalizeTaskState(state);
+    // Track unknown states for warning
+    if (state != null && state !== normalizedState) {
+      unknownStatesFound.add(state);
     }
+    normalized[name] = { state: normalizedState };
   }
   // Warn for unknown states
@@ -65,7 +53,7 @@ export function computeJobStatus(tasksInput, existingProgress = null) {
     console.warn(`Unknown task state "${s}"`);
   }
-  const status = determineJobStatus(normalized);
+  const status = deriveJobStatusFromTasks(Object.values(normalized));
   // Use existing progress if provided, otherwise default to 0
   // Progress is pre-calculated in task-statuses.json, not computed from task states
   const progress = existingProgress !== null ? existingProgress : 0;
@@ -103,12 +91,11 @@ export function transformTasks(rawTasks) {
     const rawState =
       raw && typeof raw === "object" && "state" in raw ? raw.state : undefined;
-    let finalState = "pending";
-    if (rawState != null && VALID_TASK_STATES.has(rawState)) {
-      finalState = rawState;
-    } else if (rawState != null && !VALID_TASK_STATES.has(rawState)) {
+    const finalState = normalizeTaskState(rawState);
+    // Warn for invalid states (different from normalized)
+    if (rawState != null && rawState !== finalState) {
       console.warn(`Invalid task state "${rawState}"`);
-      finalState = "pending";
     }
     const task = {

package/src/ui/watcher.js CHANGED Viewed

@@ -37,7 +37,11 @@ export function start(paths, onChange, options = {}) {
   // Initialize chokidar watcher
   const watcher = chokidar.watch(paths, {
-    ignored: /(^|[\/\\])(\.git|node_modules|dist)([\/\\]|$)/,
+    ignored: [
+      /(^|[\/\\])(\.git|node_modules|dist)([\/\\]|$)/,
+      /pipeline-data\/[^/]+\/[^/]+\/tasks\/[^/]+\/_task_root([\/\\]|$)/,
+    ],
+    followSymlinks: false,
     persistent: true,
     ignoreInitial: true,
   });

package/src/utils/dag.js CHANGED Viewed

@@ -1,3 +1,5 @@
+import { TaskState } from "../config/statuses.js";
 function normalizeJobTasks(tasks) {
   if (!tasks) return {};
@@ -53,7 +55,7 @@ export function computeDagItems(job, pipeline) {
     const jobTask = jobTasks[taskId];
     return {
       id: taskId,
-      status: jobTask ? jobTask.state : "pending",
+      status: jobTask ? jobTask.state : TaskState.PENDING,
       source: "pipeline",
       stage: computeTaskStage(job, taskId),
     };
@@ -82,18 +84,20 @@ export function computeActiveIndex(items) {
   // Find first running task
   const firstRunningIndex = items.findIndex(
-    (item) => item.status === "running"
+    (item) => item.status === TaskState.RUNNING
   );
   if (firstRunningIndex !== -1) return firstRunningIndex;
   // Find first failed task
-  const firstFailedIndex = items.findIndex((item) => item.status === "failed");
+  const firstFailedIndex = items.findIndex(
+    (item) => item.status === TaskState.FAILED
+  );
   if (firstFailedIndex !== -1) return firstFailedIndex;
   // Find last completed task
   let lastDoneIndex = -1;
   items.forEach((item, index) => {
-    if (item.status === "done") lastDoneIndex = index;
+    if (item.status === TaskState.DONE) lastDoneIndex = index;
   });
   if (lastDoneIndex !== -1) return lastDoneIndex;

package/src/utils/duration.js CHANGED Viewed

@@ -1,6 +1,7 @@
 /**
  * Duration policy utilities for consistent time display across components
  */
+import { TaskState, normalizeTaskState } from "../config/statuses.js";
 /**
  * Normalizes task state names to canonical values
@@ -8,21 +9,15 @@
  * @returns {string} Normalized state
  */
 export function normalizeState(state) {
-  switch (state) {
-    case "done":
-      return "completed";
-    case "failed":
-    case "error":
-      return "error";
-    case "pending":
-    case "running":
-    case "current":
-    case "completed":
-    case "rejected":
-      return state;
-    default:
-      return state; // Pass through unknown states
+  // Use centralized normalization, then map to duration-specific canonical forms
+  const canonicalState = normalizeTaskState(state);
+  // Duration utilities use "completed" instead of "done" for legacy compatibility
+  if (canonicalState === TaskState.DONE) {
+    return "completed";
   }
+  return canonicalState;
 }
 /**
@@ -36,18 +31,17 @@ export function taskDisplayDurationMs(task, now = Date.now()) {
   const normalizedState = normalizeState(state);
   switch (normalizedState) {
-    case "pending":
+    case TaskState.PENDING:
       return 0;
-    case "running":
-    case "current":
+    case TaskState.RUNNING:
       if (!startedAt) {
         return 0;
       }
       const startTime = Date.parse(startedAt);
       return Math.max(0, now - startTime);
-    case "completed":
+    case "completed": // Duration utilities still use "completed" for legacy compatibility
       // Prefer executionTimeMs or executionTime if available, even without startedAt
       const execTime =
         executionTimeMs != null ? executionTimeMs : executionTime;
@@ -63,7 +57,7 @@ export function taskDisplayDurationMs(task, now = Date.now()) {
       const endTime = endedAt ? Date.parse(endedAt) : now;
       return Math.max(0, endTime - completedStartTime);
-    case "rejected":
+    case TaskState.FAILED:
       return 0;
     default:

package/src/utils/formatters.js ADDED Viewed

@@ -0,0 +1,27 @@
+/**
+ * Format currency with 4 decimal places, trimming trailing zeros
+ * @param {number} x - The number to format
+ * @returns {string} Formatted currency string
+ */
+export function formatCurrency4(x) {
+  if (typeof x !== "number" || x === 0) return "$0.0000";
+  const formatted = x.toFixed(4);
+  // Trim trailing zeros and unnecessary decimal point
+  return `$${formatted.replace(/\.?0+$/, "")}`;
+}
+/**
+ * Format tokens in compact notation (k, M suffixes)
+ * @param {number} n - The number of tokens to format
+ * @returns {string} Formatted tokens string
+ */
+export function formatTokensCompact(n) {
+  if (typeof n !== "number" || n === 0) return "0 tok";
+  if (n >= 1000000) {
+    return `${(n / 1000000).toFixed(1).replace(/\.0$/, "")}M tokens`;
+  } else if (n >= 1000) {
+    return `${(n / 1000).toFixed(1).replace(/\.0$/, "")}k tokens`;
+  }
+  return `${n} tokens`;
+}

package/src/utils/geometry-equality.js ADDED Viewed

@@ -0,0 +1,83 @@
+/**
+ * Compare two geometry snapshots for layout-relevant changes using tolerance.
+ * @param {Object} prev - Previous geometry snapshot
+ * @param {Object} next - New geometry snapshot
+ * @param {number} epsilon - Tolerance in pixels for floating-point differences (default: 0.5)
+ * @returns {boolean} true if geometries are effectively equal for rendering purposes
+ */
+export function areGeometriesEqual(prev, next, epsilon = 0.5) {
+  // Strict equality shortcut
+  if (prev === next) return true;
+  if (!prev || !next) return false;
+  // Compare top-level scalars
+  if (prev.itemsLength !== next.itemsLength) return false;
+  if (prev.effectiveCols !== next.effectiveCols) return false;
+  // Compare overlay box numeric fields only (DOMRect may have non-numeric props)
+  if (!areOverlayBoxesEqual(prev.overlayBox, next.overlayBox, epsilon)) {
+    return false;
+  }
+  // Compare boxes array length and each box's layout-relevant fields
+  const prevBoxes = prev.boxes;
+  const nextBoxes = next.boxes;
+  if (prevBoxes.length !== nextBoxes.length) return false;
+  for (let i = 0; i < prevBoxes.length; i++) {
+    if (!areBoxesEqual(prevBoxes[i], nextBoxes[i], epsilon)) {
+      return false;
+    }
+  }
+  return true;
+}
+/**
+ * Compare overlay box numeric fields with tolerance.
+ * @param {DOMRect|Object} a
+ * @param {DOMRect|Object} b
+ * @param {number} epsilon
+ * @returns {boolean}
+ */
+function areOverlayBoxesEqual(a, b, epsilon) {
+  return (
+    areNumbersClose(a.left, b.left, epsilon) &&
+    areNumbersClose(a.top, b.top, epsilon) &&
+    areNumbersClose(a.width, b.width, epsilon) &&
+    areNumbersClose(a.height, b.height, epsilon) &&
+    areNumbersClose(a.right, b.right, epsilon) &&
+    areNumbersClose(a.bottom, b.bottom, epsilon)
+  );
+}
+/**
+ * Compare individual card box layout fields with tolerance.
+ * @param {Object} a - box object with left/top/width/height/right/bottom/headerMidY
+ * @param {Object} b - box object with same shape
+ * @param {number} epsilon
+ * @returns {boolean}
+ */
+function areBoxesEqual(a, b, epsilon) {
+  if (!a || !b) return a === b;
+  return (
+    areNumbersClose(a.left, b.left, epsilon) &&
+    areNumbersClose(a.top, b.top, epsilon) &&
+    areNumbersClose(a.width, b.width, epsilon) &&
+    areNumbersClose(a.height, b.height, epsilon) &&
+    areNumbersClose(a.right, b.right, epsilon) &&
+    areNumbersClose(a.bottom, b.bottom, epsilon) &&
+    areNumbersClose(a.headerMidY, b.headerMidY, epsilon)
+  );
+}
+/**
+ * Numeric comparison with tolerance.
+ * @param {number} a
+ * @param {number} b
+ * @param {number} epsilon
+ * @returns {boolean}
+ */
+function areNumbersClose(a, b, epsilon) {
+  return Math.abs(a - b) <= epsilon;
+}

package/src/utils/pipelines.js CHANGED Viewed

@@ -33,8 +33,12 @@ export function derivePipelineMetadata(source = {}) {
       ? pipelineSlugFromSource
       : null);
+  // Also return string pipeline value directly if it's a string
+  const stringPipeline =
+    typeof pipelineValue === "string" ? pipelineValue : null;
   return {
-    pipeline,
+    pipeline: pipeline || stringPipeline,
     pipelineSlug:
       typeof pipelineSlugFromSource === "string"
         ? pipelineSlugFromSource