@stigmer/react 1.0.3 → 2.0.0

package/workflow/execution-comparison/__tests__/derive-execution-comparison.test.js

@@ -0,0 +1,263 @@
+import { describe, it, expect } from "vitest";
+import { ExecutionPhase, WorkflowTaskStatus, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { deriveExecutionComparison } from "../derive-execution-comparison";
+function makeTask(overrides) {
+    return {
+        taskId: "",
+        taskName: "",
+        taskType: 0,
+        status: WorkflowTaskStatus.WORKFLOW_TASK_STATUS_UNSPECIFIED,
+        startedAt: "",
+        completedAt: "",
+        error: "",
+        artifactIds: [],
+        costMicros: BigInt(0),
+        inputTokens: BigInt(0),
+        outputTokens: BigInt(0),
+        $typeName: "ai.stigmer.agentic.workflowexecution.v1.WorkflowTask",
+        $unknown: undefined,
+        ...overrides,
+    };
+}
+function makeExecution(overrides) {
+    return {
+        apiVersion: "agentic.stigmer.ai/v1",
+        kind: "WorkflowExecution",
+        metadata: {
+            id: overrides.id ?? "exec-1",
+            name: overrides.id ?? "exec-1",
+            slug: overrides.id ?? "exec-1",
+            $typeName: "ai.stigmer.commons.v1.ApiResourceMetadata",
+        },
+        spec: {
+            $typeName: "ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionSpec",
+        },
+        status: {
+            phase: overrides.phase ?? ExecutionPhase.EXECUTION_COMPLETED,
+            tasks: overrides.tasks ?? [],
+            startedAt: overrides.startedAt ?? "2026-05-24T10:00:00Z",
+            completedAt: overrides.completedAt ?? "2026-05-24T10:01:00Z",
+            totalCostMicros: BigInt(overrides.totalCostMicros ?? 0),
+            totalInputTokens: BigInt(overrides.totalInputTokens ?? 0),
+            totalOutputTokens: BigInt(overrides.totalOutputTokens ?? 0),
+            error: overrides.error ?? "",
+            $typeName: "ai.stigmer.agentic.workflowexecution.v1.WorkflowExecutionStatus",
+        },
+        $typeName: "ai.stigmer.agentic.workflowexecution.v1.WorkflowExecution",
+        $unknown: undefined,
+    };
+}
+describe("deriveExecutionComparison", () => {
+    it("returns zero deltas for identical successful runs", () => {
+        const tasks = [
+            makeTask({
+                taskName: "step_a",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:00Z",
+                completedAt: "2026-05-24T10:00:30Z",
+                costMicros: BigInt(500),
+                inputTokens: BigInt(100),
+                outputTokens: BigInt(200),
+            }),
+            makeTask({
+                taskName: "step_b",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:30Z",
+                completedAt: "2026-05-24T10:01:00Z",
+                costMicros: BigInt(300),
+            }),
+        ];
+        const base = makeExecution({ id: "exec-base", tasks, totalCostMicros: 800 });
+        const compare = makeExecution({ id: "exec-compare", tasks, totalCostMicros: 800 });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.durationDeltaMs).toBe(0);
+        expect(result.costDeltaMicros).toBe(BigInt(0));
+        expect(result.tokensDelta).toBe(BigInt(0));
+        expect(result.divergencePoint).toBeNull();
+        expect(result.tasks).toHaveLength(2);
+        expect(result.tasksOnlyInBase).toHaveLength(0);
+        expect(result.tasksOnlyInCompare).toHaveLength(0);
+        for (const task of result.tasks) {
+            expect(task.statusChanged).toBe(false);
+            expect(task.durationDeltaMs).toBe(0);
+        }
+    });
+    it("identifies divergence point when a task fails in base but succeeds in compare", () => {
+        const baseTasks = [
+            makeTask({
+                taskName: "fetch_data",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:00Z",
+                completedAt: "2026-05-24T10:00:10Z",
+            }),
+            makeTask({
+                taskName: "process_data",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_FAILED,
+                startedAt: "2026-05-24T10:00:10Z",
+                completedAt: "2026-05-24T10:00:15Z",
+                error: "NullPointerException at line 42",
+            }),
+            makeTask({
+                taskName: "send_result",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_STATUS_UNSPECIFIED,
+            }),
+        ];
+        const compareTasks = [
+            makeTask({
+                taskName: "fetch_data",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:00Z",
+                completedAt: "2026-05-24T10:00:10Z",
+            }),
+            makeTask({
+                taskName: "process_data",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:10Z",
+                completedAt: "2026-05-24T10:00:20Z",
+            }),
+            makeTask({
+                taskName: "send_result",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:20Z",
+                completedAt: "2026-05-24T10:00:25Z",
+            }),
+        ];
+        const base = makeExecution({
+            id: "failed-run",
+            phase: ExecutionPhase.EXECUTION_FAILED,
+            tasks: baseTasks,
+            completedAt: "2026-05-24T10:00:15Z",
+        });
+        const compare = makeExecution({
+            id: "successful-run",
+            tasks: compareTasks,
+            completedAt: "2026-05-24T10:00:25Z",
+        });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.divergencePoint).toBe("process_data");
+        expect(result.tasks[0].statusChanged).toBe(false);
+        expect(result.tasks[1].statusChanged).toBe(true);
+        expect(result.tasks[1].baseError).toBe("NullPointerException at line 42");
+        expect(result.tasks[1].compareError).toBeNull();
+    });
+    it("handles workflow version drift with unmatched tasks", () => {
+        const baseTasks = [
+            makeTask({ taskName: "old_step", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+            makeTask({ taskName: "shared_step", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+        ];
+        const compareTasks = [
+            makeTask({ taskName: "shared_step", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+            makeTask({ taskName: "new_step", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+        ];
+        const base = makeExecution({ id: "v1-run", tasks: baseTasks });
+        const compare = makeExecution({ id: "v2-run", tasks: compareTasks });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.tasksOnlyInBase).toEqual(["old_step"]);
+        expect(result.tasksOnlyInCompare).toEqual(["new_step"]);
+        expect(result.tasks).toHaveLength(1);
+        expect(result.tasks[0].taskName).toBe("shared_step");
+    });
+    it("computes duration and cost deltas correctly", () => {
+        const baseTasks = [
+            makeTask({
+                taskName: "slow_task",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:00Z",
+                completedAt: "2026-05-24T10:00:45Z",
+                costMicros: BigInt(1200),
+                inputTokens: BigInt(500),
+                outputTokens: BigInt(800),
+            }),
+        ];
+        const compareTasks = [
+            makeTask({
+                taskName: "slow_task",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:00Z",
+                completedAt: "2026-05-24T10:00:20Z",
+                costMicros: BigInt(600),
+                inputTokens: BigInt(300),
+                outputTokens: BigInt(400),
+            }),
+        ];
+        const base = makeExecution({
+            id: "slow",
+            tasks: baseTasks,
+            totalCostMicros: 1200,
+            totalInputTokens: 500,
+            totalOutputTokens: 800,
+            completedAt: "2026-05-24T10:00:45Z",
+        });
+        const compare = makeExecution({
+            id: "fast",
+            tasks: compareTasks,
+            totalCostMicros: 600,
+            totalInputTokens: 300,
+            totalOutputTokens: 400,
+            completedAt: "2026-05-24T10:00:20Z",
+        });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.tasks[0].durationDeltaMs).toBe(25000);
+        expect(result.tasks[0].baseCostMicros).toBe(BigInt(1200));
+        expect(result.tasks[0].compareCostMicros).toBe(BigInt(600));
+        expect(result.tasks[0].baseTokens).toBe(BigInt(1300));
+        expect(result.tasks[0].compareTokens).toBe(BigInt(700));
+        expect(result.durationDeltaMs).toBe(25000);
+        expect(result.costDeltaMicros).toBe(BigInt(600));
+        expect(result.tokensDelta).toBe(BigInt(600));
+    });
+    it("handles null durations gracefully", () => {
+        const baseTasks = [
+            makeTask({
+                taskName: "incomplete",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_IN_PROGRESS,
+                startedAt: "2026-05-24T10:00:00Z",
+            }),
+        ];
+        const compareTasks = [
+            makeTask({
+                taskName: "incomplete",
+                status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED,
+                startedAt: "2026-05-24T10:00:00Z",
+                completedAt: "2026-05-24T10:00:30Z",
+            }),
+        ];
+        const base = makeExecution({
+            id: "in-progress",
+            phase: ExecutionPhase.EXECUTION_IN_PROGRESS,
+            tasks: baseTasks,
+            completedAt: "",
+        });
+        const compare = makeExecution({ id: "done", tasks: compareTasks });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.tasks[0].baseDurationMs).toBeNull();
+        expect(result.tasks[0].compareDurationMs).toBe(30000);
+        expect(result.tasks[0].durationDeltaMs).toBeNull();
+    });
+    it("handles empty task lists", () => {
+        const base = makeExecution({ id: "empty-1", tasks: [] });
+        const compare = makeExecution({ id: "empty-2", tasks: [] });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.tasks).toHaveLength(0);
+        expect(result.tasksOnlyInBase).toHaveLength(0);
+        expect(result.tasksOnlyInCompare).toHaveLength(0);
+        expect(result.divergencePoint).toBeNull();
+    });
+    it("preserves execution order from base run", () => {
+        const baseTasks = [
+            makeTask({ taskName: "first", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+            makeTask({ taskName: "second", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+            makeTask({ taskName: "third", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+        ];
+        const compareTasks = [
+            makeTask({ taskName: "third", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+            makeTask({ taskName: "first", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+            makeTask({ taskName: "second", status: WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED }),
+        ];
+        const base = makeExecution({ id: "ordered", tasks: baseTasks });
+        const compare = makeExecution({ id: "reordered", tasks: compareTasks });
+        const result = deriveExecutionComparison(base, compare);
+        expect(result.tasks.map((t) => t.taskName)).toEqual(["first", "second", "third"]);
+    });
+});
+//# sourceMappingURL=derive-execution-comparison.test.js.map

package/workflow/execution-comparison/__tests__/derive-execution-comparison.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-execution-comparison.test.js","sourceRoot":"","sources":["../../../../src/workflow/execution-comparison/__tests__/derive-execution-comparison.test.ts"],"names":[],"mappings":"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"}

package/workflow/execution-comparison/derive-execution-comparison.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { ExecutionComparison } from "./types";
+/**
+ * Derives a structural comparison between two workflow executions.
+ *
+ * Pure function with zero side effects. Aligns tasks by `taskName`
+ * (stable within the same workflow version) and computes deltas for
+ * duration, cost, tokens, and status across all matched tasks.
+ *
+ * When workflow definitions differ between runs, unmatched tasks are
+ * reported in `tasksOnlyInBase` and `tasksOnlyInCompare`.
+ */
+export declare function deriveExecutionComparison(base: WorkflowExecution, compare: WorkflowExecution): ExecutionComparison;
+//# sourceMappingURL=derive-execution-comparison.d.ts.map

package/workflow/execution-comparison/derive-execution-comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-execution-comparison.d.ts","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/derive-execution-comparison.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AAIxG,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAiCnE;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,iBAAiB,GACzB,mBAAmB,CA+FrB"}

package/workflow/execution-comparison/derive-execution-comparison.js

@@ -0,0 +1,120 @@
+import { WorkflowTaskStatus } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { deriveExecutionRow } from "../execution-history/derive-execution-row";
+const BIGINT_ZERO = BigInt(0);
+function parseIsoMs(iso) {
+    if (!iso)
+        return null;
+    const t = new Date(iso).getTime();
+    return Number.isNaN(t) ? null : t;
+}
+function taskDurationMs(task) {
+    const start = parseIsoMs(task.startedAt);
+    const end = parseIsoMs(task.completedAt);
+    if (start == null || end == null)
+        return null;
+    return end - start;
+}
+function taskKindLabel(task) {
+    return task.taskType != null ? String(task.taskType) : "";
+}
+function indexTasksByName(tasks) {
+    const map = new Map();
+    for (const t of tasks) {
+        if (t.taskName) {
+            map.set(t.taskName, t);
+        }
+    }
+    return map;
+}
+/**
+ * Derives a structural comparison between two workflow executions.
+ *
+ * Pure function with zero side effects. Aligns tasks by `taskName`
+ * (stable within the same workflow version) and computes deltas for
+ * duration, cost, tokens, and status across all matched tasks.
+ *
+ * When workflow definitions differ between runs, unmatched tasks are
+ * reported in `tasksOnlyInBase` and `tasksOnlyInCompare`.
+ */
+export function deriveExecutionComparison(base, compare) {
+    const baseRow = deriveExecutionRow(base);
+    const compareRow = deriveExecutionRow(compare);
+    const baseTasks = base.status?.tasks ?? [];
+    const compareTasks = compare.status?.tasks ?? [];
+    const baseByName = indexTasksByName(baseTasks);
+    const compareByName = indexTasksByName(compareTasks);
+    const allNames = new Set();
+    baseByName.forEach((_v, name) => allNames.add(name));
+    compareByName.forEach((_v, name) => allNames.add(name));
+    const tasks = [];
+    const tasksOnlyInBase = [];
+    const tasksOnlyInCompare = [];
+    let divergencePoint = null;
+    const orderedNames = Array.from(allNames).sort((a, b) => {
+        const aIdx = baseTasks.findIndex((t) => t.taskName === a);
+        const bIdx = baseTasks.findIndex((t) => t.taskName === b);
+        const aOrder = aIdx >= 0 ? aIdx : compareTasks.findIndex((t) => t.taskName === a);
+        const bOrder = bIdx >= 0 ? bIdx : compareTasks.findIndex((t) => t.taskName === b);
+        return aOrder - bOrder;
+    });
+    for (const name of orderedNames) {
+        const baseTask = baseByName.get(name);
+        const compareTask = compareByName.get(name);
+        if (baseTask && !compareTask) {
+            tasksOnlyInBase.push(name);
+            continue;
+        }
+        if (!baseTask && compareTask) {
+            tasksOnlyInCompare.push(name);
+            continue;
+        }
+        if (!baseTask || !compareTask)
+            continue;
+        const baseStatus = baseTask.status ?? WorkflowTaskStatus.WORKFLOW_TASK_STATUS_UNSPECIFIED;
+        const compareStatus = compareTask.status ?? WorkflowTaskStatus.WORKFLOW_TASK_STATUS_UNSPECIFIED;
+        const statusChanged = baseStatus !== compareStatus;
+        const baseDurationMs = taskDurationMs(baseTask);
+        const compareDurationMs = taskDurationMs(compareTask);
+        const durationDeltaMs = baseDurationMs != null && compareDurationMs != null
+            ? baseDurationMs - compareDurationMs
+            : null;
+        const baseCostMicros = BigInt(baseTask.costMicros ?? 0);
+        const compareCostMicros = BigInt(compareTask.costMicros ?? 0);
+        const baseTokens = BigInt(baseTask.inputTokens ?? 0) + BigInt(baseTask.outputTokens ?? 0);
+        const compareTokens = BigInt(compareTask.inputTokens ?? 0) + BigInt(compareTask.outputTokens ?? 0);
+        if (statusChanged && divergencePoint === null) {
+            divergencePoint = name;
+        }
+        tasks.push({
+            taskName: name,
+            taskKind: taskKindLabel(baseTask),
+            baseStatus,
+            compareStatus,
+            statusChanged,
+            baseDurationMs,
+            compareDurationMs,
+            durationDeltaMs,
+            baseCostMicros,
+            compareCostMicros,
+            baseTokens,
+            compareTokens,
+            baseError: baseTask.error || null,
+            compareError: compareTask.error || null,
+        });
+    }
+    const durationDeltaMs = baseRow.durationMs != null && compareRow.durationMs != null
+        ? baseRow.durationMs - compareRow.durationMs
+        : null;
+    return {
+        baseRow,
+        compareRow,
+        durationDeltaMs,
+        costDeltaMicros: baseRow.costMicros - compareRow.costMicros,
+        tokensDelta: baseRow.totalTokens - compareRow.totalTokens,
+        tasks,
+        tasksOnlyInBase,
+        tasksOnlyInCompare,
+        divergencePoint,
+    };
+}
+//# sourceMappingURL=derive-execution-comparison.js.map

package/workflow/execution-comparison/derive-execution-comparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-execution-comparison.js","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/derive-execution-comparison.ts"],"names":[],"mappings":"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"}

package/workflow/execution-comparison/index.d.ts

@@ -0,0 +1,8 @@
+export type { TaskComparison, ExecutionComparison } from "./types";
+export { deriveExecutionComparison } from "./derive-execution-comparison";
+export { useExecutionComparison, type UseExecutionComparisonOptions, type UseExecutionComparisonReturn, } from "./useExecutionComparison";
+export { ExecutionComparisonPicker, type ExecutionComparisonPickerProps, } from "./ExecutionComparisonPicker";
+export { ComparisonSummaryCards, type ComparisonSummaryCardsProps, } from "./ComparisonSummaryCards";
+export { TaskComparisonTable, type TaskComparisonTableProps, } from "./TaskComparisonTable";
+export { ExecutionComparisonView, type ExecutionComparisonViewProps, } from "./ExecutionComparisonView";
+//# sourceMappingURL=index.d.ts.map

package/workflow/execution-comparison/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,yBAAyB,EACzB,KAAK,8BAA8B,GACpC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,GAClC,MAAM,2BAA2B,CAAC"}

package/workflow/execution-comparison/index.js

@@ -0,0 +1,7 @@
+export { deriveExecutionComparison } from "./derive-execution-comparison";
+export { useExecutionComparison, } from "./useExecutionComparison";
+export { ExecutionComparisonPicker, } from "./ExecutionComparisonPicker";
+export { ComparisonSummaryCards, } from "./ComparisonSummaryCards";
+export { TaskComparisonTable, } from "./TaskComparisonTable";
+export { ExecutionComparisonView, } from "./ExecutionComparisonView";
+//# sourceMappingURL=index.js.map

package/workflow/execution-comparison/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EACL,sBAAsB,GAGvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,yBAAyB,GAE1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,GAExB,MAAM,2BAA2B,CAAC"}

package/workflow/execution-comparison/types.d.ts

@@ -0,0 +1,56 @@
+import type { WorkflowTaskStatus } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import type { ExecutionRow } from "../execution-history/derive-execution-row";
+/**
+ * Per-task comparison entry aligning the same task across two executions.
+ *
+ * Tasks are matched by `taskName` (stable across runs of the same workflow
+ * version). When the workflow definition changed between runs, unmatched
+ * tasks appear in {@link ExecutionComparison.tasksOnlyInBase} or
+ * {@link ExecutionComparison.tasksOnlyInCompare}.
+ */
+export interface TaskComparison {
+    readonly taskName: string;
+    readonly taskKind: string;
+    readonly baseStatus: WorkflowTaskStatus;
+    readonly compareStatus: WorkflowTaskStatus;
+    readonly statusChanged: boolean;
+    readonly baseDurationMs: number | null;
+    readonly compareDurationMs: number | null;
+    /** Positive = base was slower, negative = compare was slower. */
+    readonly durationDeltaMs: number | null;
+    readonly baseCostMicros: bigint;
+    readonly compareCostMicros: bigint;
+    readonly baseTokens: bigint;
+    readonly compareTokens: bigint;
+    readonly baseError: string | null;
+    readonly compareError: string | null;
+}
+/**
+ * Complete comparison result between two workflow executions.
+ *
+ * Produced by {@link deriveExecutionComparison} — a pure function with
+ * zero side effects that aligns tasks by name and computes deltas for
+ * all numeric dimensions.
+ */
+export interface ExecutionComparison {
+    readonly baseRow: ExecutionRow;
+    readonly compareRow: ExecutionRow;
+    /** Positive = base was slower. `null` when either duration is unavailable. */
+    readonly durationDeltaMs: number | null;
+    /** Positive = base cost more. */
+    readonly costDeltaMicros: bigint;
+    /** Positive = base used more tokens. */
+    readonly tokensDelta: bigint;
+    /** Per-task aligned comparison entries (matched by task_name). */
+    readonly tasks: readonly TaskComparison[];
+    /** Task names present in base but absent in compare (workflow version drift). */
+    readonly tasksOnlyInBase: readonly string[];
+    /** Task names present in compare but absent in base (workflow version drift). */
+    readonly tasksOnlyInCompare: readonly string[];
+    /**
+     * Name of the first task (in execution order) where status diverges
+     * between the two runs. `null` when all matched tasks have identical statuses.
+     */
+    readonly divergencePoint: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/workflow/execution-comparison/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,iCAAiC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,iFAAiF;IACjF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC"}

package/workflow/execution-comparison/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/workflow/execution-comparison/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/types.ts"],"names":[],"mappings":""}

package/workflow/execution-comparison/useExecutionComparison.d.ts

@@ -0,0 +1,43 @@
+import type { ExecutionComparison } from "./types";
+/** Options for {@link useExecutionComparison}. */
+export interface UseExecutionComparisonOptions {
+    /** The "baseline" execution ID (typically the run being viewed). */
+    readonly baseId: string | null;
+    /** The "compare" execution ID (typically a recent successful run). */
+    readonly compareId: string | null;
+}
+/** Return value of {@link useExecutionComparison}. */
+export interface UseExecutionComparisonReturn {
+    /** Derived comparison result, or `null` while loading or on error. */
+    readonly comparison: ExecutionComparison | null;
+    /** `true` while either execution is being fetched. */
+    readonly isLoading: boolean;
+    /** First error from either fetch, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Re-fetch both executions. */
+    readonly refetch: () => void;
+}
+/**
+ * Behavior hook that fetches two workflow executions and derives
+ * a structural comparison between them.
+ *
+ * Pass `null` for either ID to skip that fetch (e.g., while the
+ * user is selecting a comparison target). The comparison result
+ * is only produced when both executions are loaded.
+ *
+ * Returns referentially stable objects when inputs haven't changed
+ * (DD-010 compliance).
+ *
+ * @example
+ * ```tsx
+ * const { comparison, isLoading } = useExecutionComparison({
+ *   baseId: "wfx_failed_123",
+ *   compareId: "wfx_success_456",
+ * });
+ * if (comparison) {
+ *   console.log(comparison.divergencePoint);
+ * }
+ * ```
+ */
+export declare function useExecutionComparison({ baseId, compareId, }: UseExecutionComparisonOptions): UseExecutionComparisonReturn;
+//# sourceMappingURL=useExecutionComparison.d.ts.map

package/workflow/execution-comparison/useExecutionComparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExecutionComparison.d.ts","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/useExecutionComparison.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,kDAAkD;AAClD,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,SAAS,GACV,EAAE,6BAA6B,GAAG,4BAA4B,CAkC9D"}

package/workflow/execution-comparison/useExecutionComparison.js

@@ -0,0 +1,46 @@
+"use client";
+import { useMemo } from "react";
+import { useWorkflowExecution } from "../useWorkflowExecution";
+import { deriveExecutionComparison } from "./derive-execution-comparison";
+/**
+ * Behavior hook that fetches two workflow executions and derives
+ * a structural comparison between them.
+ *
+ * Pass `null` for either ID to skip that fetch (e.g., while the
+ * user is selecting a comparison target). The comparison result
+ * is only produced when both executions are loaded.
+ *
+ * Returns referentially stable objects when inputs haven't changed
+ * (DD-010 compliance).
+ *
+ * @example
+ * ```tsx
+ * const { comparison, isLoading } = useExecutionComparison({
+ *   baseId: "wfx_failed_123",
+ *   compareId: "wfx_success_456",
+ * });
+ * if (comparison) {
+ *   console.log(comparison.divergencePoint);
+ * }
+ * ```
+ */
+export function useExecutionComparison({ baseId, compareId, }) {
+    const { execution: baseExecution, isLoading: baseLoading, error: baseError, refetch: baseRefetch, } = useWorkflowExecution(baseId);
+    const { execution: compareExecution, isLoading: compareLoading, error: compareError, refetch: compareRefetch, } = useWorkflowExecution(compareId);
+    const comparison = useMemo(() => {
+        if (!baseExecution || !compareExecution)
+            return null;
+        return deriveExecutionComparison(baseExecution, compareExecution);
+    }, [baseExecution, compareExecution]);
+    const refetch = useMemo(() => () => {
+        baseRefetch();
+        compareRefetch();
+    }, [baseRefetch, compareRefetch]);
+    return {
+        comparison,
+        isLoading: baseLoading || compareLoading,
+        error: baseError ?? compareError ?? null,
+        refetch,
+    };
+}
+//# sourceMappingURL=useExecutionComparison.js.map

package/workflow/execution-comparison/useExecutionComparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExecutionComparison.js","sourceRoot":"","sources":["../../../src/workflow/execution-comparison/useExecutionComparison.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAuB1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,SAAS,GACqB;IAC9B,MAAM,EACJ,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACrB,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAEjC,MAAM,EACJ,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,cAAc,EACzB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,GACxB,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,IAAI,CAAC,aAAa,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,yBAAyB,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;IACpE,CAAC,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,CAAC;IACnB,CAAC,EACD,CAAC,WAAW,EAAE,cAAc,CAAC,CAC9B,CAAC;IAEF,OAAO;QACL,UAAU;QACV,SAAS,EAAE,WAAW,IAAI,cAAc;QACxC,KAAK,EAAE,SAAS,IAAI,YAAY,IAAI,IAAI;QACxC,OAAO;KACR,CAAC;AACJ,CAAC"}