@stigmer/react 1.0.3 → 2.0.0

package/workflow/useWorkflowExecutionList.d.ts

@@ -1,4 +1,19 @@
 import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+/**
+ * Client-side execution filter criteria.
+ *
+ * Placeholder until backend proto adds `ExecutionFilterCriteria`.
+ */
+export interface ExecutionFilterCriteria {
+    readonly phases?: readonly number[];
+    readonly workflowId?: string;
+}
+/**
+ * Client-side execution sort field.
+ *
+ * Placeholder re-export matching the local type in execution-history.
+ */
+export type ExecutionSortField = "startTime" | "endTime" | "duration" | "status" | "cost" | "tokens";
 /** Options for {@link useWorkflowExecutionList}. */
 export interface UseWorkflowExecutionListOptions {
     /** Maximum executions per page. @default 20 */
@@ -10,6 +25,25 @@ export interface UseWorkflowExecutionListOptions {
      * When omitted, lists all executions across all workflows.
      */
     readonly workflowId?: string | null;
+    /**
+     * Server-side filter criteria. When set, the backend filters
+     * before returning results, reducing transfer size.
+     *
+     * @since T13 (Execution History)
+     */
+    readonly filter?: Partial<ExecutionFilterCriteria>;
+    /**
+     * Server-side sort field.
+     *
+     * @since T13 (Execution History)
+     */
+    readonly sortField?: ExecutionSortField;
+    /**
+     * When true, sorts ascending. Defaults to false (descending).
+     *
+     * @since T13 (Execution History)
+     */
+    readonly sortAscending?: boolean;
 }
 /** Return value of {@link useWorkflowExecutionList}. */
 export interface UseWorkflowExecutionListReturn {

package/workflow/useWorkflowExecutionList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkflowExecutionList.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionList.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AASxG,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAYD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,+BAA+B,GACxC,8BAA8B,CAiDhC"}
+{"version":3,"file":"useWorkflowExecutionList.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionList.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AASxG;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErG,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAYD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,+BAA+B,GACxC,8BAA8B,CA6ChC"}

package/workflow/useWorkflowExecutionList.js

@@ -33,20 +33,13 @@ export function useWorkflowExecutionList(options) {
     const workflowId = options?.workflowId ?? null;
     const fetchFn = async () => {
         if (workflowId) {
-            const resp = await stigmer.workflowExecution.listByWorkflow(create(ListWorkflowExecutionsByWorkflowRequestSchema, {
-                workflowId,
-                pageSize,
-                pageToken,
-            }));
+            const resp = await stigmer.workflowExecution.listByWorkflow(create(ListWorkflowExecutionsByWorkflowRequestSchema, { workflowId, pageSize, pageToken }));
             return {
                 executions: [...resp.entries],
                 totalPages: resp.totalPages,
             };
         }
-        const resp = await stigmer.workflowExecution.list(create(ListWorkflowExecutionsRequestSchema, {
-            pageSize,
-            pageToken,
-        }));
+        const resp = await stigmer.workflowExecution.list(create(ListWorkflowExecutionsRequestSchema, { pageSize, pageToken }));
         return {
             executions: [...resp.entries],
             totalPages: resp.totalPages,

package/workflow/useWorkflowExecutionList.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkflowExecutionList.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,mCAAmC,EACnC,6CAA6C,GAC9C,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAoChD,MAAM,YAAY,GAAsB;IACtC,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAyC;IAEzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;IAE/C,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,cAAc,CACzD,MAAM,CAAC,6CAA6C,EAAE;gBACpD,UAAU;gBACV,QAAQ;gBACR,SAAS;aACV,CAAC,CACH,CAAC;YACF,OAAO;gBACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAC/C,MAAM,CAAC,mCAAmC,EAAE;YAC1C,QAAQ;YACR,SAAS;SACV,CAAC,CACH,CAAC;QACF,OAAO;YACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,KAAK,EACL,OAAO,GACR,GAAG,QAAQ,CAAoB,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;IAEnG,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS;QACT,YAAY;QACZ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useWorkflowExecutionList.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowExecutionList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,mCAAmC,EACnC,6CAA6C,GAC9C,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAwEhD,MAAM,YAAY,GAAsB;IACtC,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAyC;IAEzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,cAAc,CACzD,MAAM,CAAC,6CAA6C,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAC3F,CAAC;YACF,OAAO;gBACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAC/C,MAAM,CAAC,mCAAmC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CACrE,CAAC;QACF,OAAO;YACL,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,KAAK,EACL,OAAO,GACR,GAAG,QAAQ,CACV,OAAO,EACP,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,EAC1C,YAAY,CACb,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS;QACT,YAAY;QACZ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/workflow/useWorkflowOverviewGraph.d.ts

@@ -0,0 +1,42 @@
+import type { Node, Edge } from "@xyflow/react";
+import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+/** Options for {@link useWorkflowOverviewGraph}. */
+export interface UseWorkflowOverviewGraphOptions {
+    /**
+     * The workflow blueprint to render. The hook serializes the spec to YAML,
+     * converts it to a graph model, applies dagre layout, and produces
+     * React Flow elements.
+     *
+     * When `null` or `undefined`, the hook returns empty arrays.
+     */
+    readonly workflow: Workflow | null | undefined;
+}
+/** Return value of {@link useWorkflowOverviewGraph}. */
+export interface UseWorkflowOverviewGraphReturn {
+    /** Positioned React Flow nodes, ready for rendering. */
+    readonly nodes: Node[];
+    /** React Flow edges connecting the nodes. */
+    readonly edges: Edge[];
+    /** Currently selected task name (null when nothing is selected). */
+    readonly selectedTaskName: string | null;
+    /** Update the selected task. Pass `null` to clear. */
+    readonly setSelectedTaskName: (name: string | null) => void;
+    /** React Flow nodes with `selected` property applied to match `selectedTaskName`. */
+    readonly nodesWithSelection: Node[];
+}
+/**
+ * Behavior hook that converts a `Workflow` blueprint into positioned
+ * React Flow elements suitable for a read-only overview graph.
+ *
+ * Pipeline: `Workflow` → YAML → `yamlToGraph` → `applyDagreLayout` → `toReactFlowElements`
+ *
+ * Manages selected-node state for the click-to-inspect popover.
+ *
+ * @example
+ * ```tsx
+ * const { nodesWithSelection, edges, selectedTaskName, setSelectedTaskName } =
+ *   useWorkflowOverviewGraph({ workflow });
+ * ```
+ */
+export declare function useWorkflowOverviewGraph(options: UseWorkflowOverviewGraphOptions): UseWorkflowOverviewGraphReturn;
+//# sourceMappingURL=useWorkflowOverviewGraph.d.ts.map

package/workflow/useWorkflowOverviewGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowOverviewGraph.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowOverviewGraph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAOtF,oDAAoD;AACpD,MAAM,WAAW,+BAA+B;IAC9C;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;CAChD;AAED,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D,qFAAqF;IACrF,QAAQ,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAuChC"}

package/workflow/useWorkflowOverviewGraph.js

@@ -0,0 +1,51 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { serializeWorkflowYaml } from "./serialize-workflow-yaml";
+import { yamlToGraph } from "./workflow-graph-conversions";
+import { toReactFlowElements } from "./workflow-graph-conversions";
+import { applyDagreLayout } from "./layout";
+/**
+ * Behavior hook that converts a `Workflow` blueprint into positioned
+ * React Flow elements suitable for a read-only overview graph.
+ *
+ * Pipeline: `Workflow` → YAML → `yamlToGraph` → `applyDagreLayout` → `toReactFlowElements`
+ *
+ * Manages selected-node state for the click-to-inspect popover.
+ *
+ * @example
+ * ```tsx
+ * const { nodesWithSelection, edges, selectedTaskName, setSelectedTaskName } =
+ *   useWorkflowOverviewGraph({ workflow });
+ * ```
+ */
+export function useWorkflowOverviewGraph(options) {
+    const { workflow } = options;
+    const [selectedTaskName, setSelectedTaskName] = useState(null);
+    const { nodes, edges } = useMemo(() => {
+        if (!workflow?.spec?.tasks?.length) {
+            return { nodes: [], edges: [] };
+        }
+        try {
+            const yaml = serializeWorkflowYaml(workflow);
+            const graph = yamlToGraph(yaml);
+            const laid = applyDagreLayout(graph);
+            return toReactFlowElements(laid);
+        }
+        catch {
+            return { nodes: [], edges: [] };
+        }
+    }, [workflow]);
+    const nodesWithSelection = useMemo(() => nodes.map((n) => ({
+        ...n,
+        selected: n.data.taskName === selectedTaskName,
+    })), [nodes, selectedTaskName]);
+    const stableSetSelected = useCallback((name) => setSelectedTaskName(name), []);
+    return {
+        nodes,
+        edges,
+        selectedTaskName,
+        setSelectedTaskName: stableSetSelected,
+        nodesWithSelection,
+    };
+}
+//# sourceMappingURL=useWorkflowOverviewGraph.js.map

package/workflow/useWorkflowOverviewGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowOverviewGraph.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowOverviewGraph.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA6B5C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAwC;IAExC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9E,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACpC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACnC,OAAO,EAAE,KAAK,EAAE,EAAY,EAAE,KAAK,EAAE,EAAY,EAAE,CAAC;QACtD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACrC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,KAAK,EAAE,EAAY,EAAE,KAAK,EAAE,EAAY,EAAE,CAAC;QACtD,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,kBAAkB,GAAG,OAAO,CAChC,GAAG,EAAE,CACH,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChB,GAAG,CAAC;QACJ,QAAQ,EAAG,CAAC,CAAC,IAA2B,CAAC,QAAQ,KAAK,gBAAgB;KACvE,CAAC,CAAC,EACL,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAC1B,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,IAAmB,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAClD,EAAE,CACH,CAAC;IAEF,OAAO;QACL,KAAK;QACL,KAAK;QACL,gBAAgB;QAChB,mBAAmB,EAAE,iBAAiB;QACtC,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/workflow/useWorkflowSave.d.ts

@@ -1,10 +1,15 @@
+/** Options for a single save invocation. */
+export interface WorkflowSaveOptions {
+    /** Optional version message describing what changed (stored as metadata.version.message). */
+    readonly versionMessage?: string;
+}
 /** Return value of {@link useWorkflowSave}. */
 export interface UseWorkflowSaveReturn {
     /**
      * Parse the YAML and call `workflow.apply()` on the server.
      * Returns `true` on success, `false` on failure (check `error`).
      */
-    readonly save: (yaml: string) => Promise<boolean>;
+    readonly save: (yaml: string, options?: WorkflowSaveOptions) => Promise<boolean>;
     /** `true` while a save request is in flight. */
     readonly isSaving: boolean;
     /** Error from the last failed save, or `null` on success. */

package/workflow/useWorkflowSave.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkflowSave.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowSave.ts"],"names":[],"mappings":"AAMA,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAuClE"}
+{"version":3,"file":"useWorkflowSave.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowSave.ts"],"names":[],"mappings":"AAMA,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA0ClE"}

package/workflow/useWorkflowSave.js

@@ -19,11 +19,14 @@ export function useWorkflowSave(org) {
     const [error, setError] = useState(null);
     const orgRef = useRef(org);
     orgRef.current = org;
-    const save = useCallback(async (yaml) => {
+    const save = useCallback(async (yaml, options) => {
         setIsSaving(true);
         setError(null);
         try {
             const input = parseWorkflowYaml(yaml, orgRef.current);
+            if (options?.versionMessage) {
+                input.versionMessage = options.versionMessage;
+            }
             await stigmer.workflow.apply(input);
             return true;
         }

package/workflow/useWorkflowSave.js.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkflowSave.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowSave.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAe9D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAErB,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,IAAY,EAAoB,EAAE;QACvC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAEtD,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CACN,IAAI,KAAK,CACP,qDAAqD;oBACnD,gEAAgE,CACnE,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,aAAa,IAAI,GAAG,IAAK,GAA+B,CAAC,WAAW,KAAK,EAAE,EAAE,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAI,GAA4B,CAAC,OAAO,IAAI,EAAE,CAAC;IACxD,OAAO,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"useWorkflowSave.js","sourceRoot":"","sources":["../../src/workflow/useWorkflowSave.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAqB9D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAErB,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,IAAY,EAAE,OAA6B,EAAoB,EAAE;QACtE,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;gBAC5B,KAAK,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAChD,CAAC;YACD,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAEtD,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CACN,IAAI,KAAK,CACP,qDAAqD;oBACnD,gEAAgE,CACnE,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,aAAa,IAAI,GAAG,IAAK,GAA+B,CAAC,WAAW,KAAK,EAAE,EAAE,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAI,GAA4B,CAAC,OAAO,IAAI,EAAE,CAAC;IACxD,OAAO,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC1E,CAAC"}

package/workflow/useWorkflowTopology.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useWorkflowTopology.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowTopology.ts"],"names":[],"mappings":"AAKA,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,KAAK,GACL,IAAI,GACJ,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,OAAO,GACP,aAAa,CAAC;AAElB,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACzC;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,yBAAyB,CAU3B"}
+{"version":3,"file":"useWorkflowTopology.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowTopology.ts"],"names":[],"mappings":"AAKA,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,KAAK,GACL,IAAI,GACJ,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,OAAO,GACP,aAAa,CAAC;AAElB,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACzC;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,yBAAyB,CAU3B"}

package/workflow/useWorkflowTopology.js

@@ -1,12 +1,7 @@
 "use client";
 import { useMemo } from "react";
 import { parse as parseYaml } from "yaml";
-const AI_KINDS = new Set(["agent_call", "llm_call", "eval"]);
-const CONTROL_FLOW_KINDS = new Set(["switch_case", "for_each", "fork", "try_catch"]);
-const INVOCATION_KINDS = new Set(["http_call", "grpc_call", "activity_call", "run_workflow"]);
-const DATA_KINDS = new Set(["set_vars", "transform"]);
-const GOVERNANCE_KINDS = new Set(["human_input", "validate"]);
-const EVENT_KINDS = new Set(["listen", "wait", "emit_event", "notification", "raise_error"]);
+import { categorizeKind } from "./kind-metadata";
 const NODE_WIDTH = 180;
 const NODE_HEIGHT = 40;
 /**
@@ -145,19 +140,4 @@ function computeTopology(yaml) {
     }
     return { nodes, edges };
 }
-function categorizeKind(kind) {
-    if (AI_KINDS.has(kind))
-        return "ai";
-    if (CONTROL_FLOW_KINDS.has(kind))
-        return "control_flow";
-    if (INVOCATION_KINDS.has(kind))
-        return "invocation";
-    if (DATA_KINDS.has(kind))
-        return "data";
-    if (GOVERNANCE_KINDS.has(kind))
-        return "governance";
-    if (EVENT_KINDS.has(kind))
-        return "event";
-    return "unspecified";
-}
 //# sourceMappingURL=useWorkflowTopology.js.map

package/workflow/useWorkflowTopology.js.map

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

package/workflow/useWorkflowVersion.d.ts

@@ -0,0 +1,36 @@
+import { type WorkflowVersionEntry } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/version_pb";
+/** Return value of {@link useWorkflowVersion}. */
+export interface UseWorkflowVersionReturn {
+    /** The resolved version entry, or `null` while loading / on error / when disabled. */
+    readonly version: WorkflowVersionEntry | null;
+    /** `true` while the fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single workflow version entry by ID and hash.
+ *
+ * Calls `stigmer.workflow.getVersion()` to retrieve the full version
+ * details for a specific content hash. Useful for inspecting a
+ * particular historical version outside the timeline listing.
+ *
+ * **Graceful degradation**: If the backend returns UNIMPLEMENTED, the
+ * hook resolves to `null` without raising an error.
+ *
+ * Pass `null` for either `workflowId` or `versionHash` to skip
+ * fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { version, isLoading } = useWorkflowVersion(workflowId, selectedHash);
+ *
+ * if (version) {
+ *   return <pre>{version.validatedYaml}</pre>;
+ * }
+ * ```
+ */
+export declare function useWorkflowVersion(workflowId: string | null, versionHash: string | null): UseWorkflowVersionReturn;
+//# sourceMappingURL=useWorkflowVersion.d.ts.map

package/workflow/useWorkflowVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowVersion.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowVersion.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2DAA2D,CAAC;AAUnE,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,wBAAwB,CAoD1B"}

package/workflow/useWorkflowVersion.js

@@ -0,0 +1,86 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { StigmerError } from "@stigmer/sdk";
+import { GetWorkflowVersionInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/version_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+const CODE_UNIMPLEMENTED = 12;
+// ---------------------------------------------------------------------------
+// Hook implementation
+// ---------------------------------------------------------------------------
+/**
+ * Data hook that fetches a single workflow version entry by ID and hash.
+ *
+ * Calls `stigmer.workflow.getVersion()` to retrieve the full version
+ * details for a specific content hash. Useful for inspecting a
+ * particular historical version outside the timeline listing.
+ *
+ * **Graceful degradation**: If the backend returns UNIMPLEMENTED, the
+ * hook resolves to `null` without raising an error.
+ *
+ * Pass `null` for either `workflowId` or `versionHash` to skip
+ * fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { version, isLoading } = useWorkflowVersion(workflowId, selectedHash);
+ *
+ * if (version) {
+ *   return <pre>{version.validatedYaml}</pre>;
+ * }
+ * ```
+ */
+export function useWorkflowVersion(workflowId, versionHash) {
+    const stigmer = useStigmer();
+    const [version, setVersion] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchIdRef = useRef(0);
+    const doFetch = useCallback(async () => {
+        if (!workflowId || !versionHash) {
+            setVersion(null);
+            setError(null);
+            return;
+        }
+        const fetchId = ++fetchIdRef.current;
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await stigmer.workflow.getVersion(create(GetWorkflowVersionInputSchema, { workflowId, versionHash }));
+            if (fetchIdRef.current !== fetchId)
+                return;
+            setVersion(result);
+        }
+        catch (err) {
+            if (fetchIdRef.current !== fetchId)
+                return;
+            if (isUnimplemented(err)) {
+                setVersion(null);
+            }
+            else {
+                setError(toError(err));
+                setVersion(null);
+            }
+        }
+        finally {
+            if (fetchIdRef.current === fetchId) {
+                setIsLoading(false);
+            }
+        }
+    }, [workflowId, versionHash, stigmer]);
+    useEffect(() => {
+        doFetch();
+    }, [doFetch]);
+    const refetch = useCallback(() => {
+        doFetch();
+    }, [doFetch]);
+    return useMemo(() => ({ version, isLoading, error, refetch }), [version, isLoading, error, refetch]);
+}
+// ---------------------------------------------------------------------------
+// Error detection
+// ---------------------------------------------------------------------------
+function isUnimplemented(err) {
+    return err instanceof StigmerError && err.connectCode === CODE_UNIMPLEMENTED;
+}
+//# sourceMappingURL=useWorkflowVersion.js.map

package/workflow/useWorkflowVersion.js.map

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

package/workflow/useWorkflowVersionDiff.d.ts

@@ -0,0 +1,33 @@
+import { type DiffLine } from "./workflow-yaml-diff";
+/** Return value of {@link useWorkflowVersionDiff}. */
+export interface UseWorkflowVersionDiffReturn {
+    /** Array of diff lines, or `null` while loading / on error / when disabled. */
+    readonly diff: readonly DiffLine[] | null;
+    /** `true` while both versions are being fetched and diffed. */
+    readonly isLoading: boolean;
+    /** Error from the fetch or diff computation, or `null` when healthy. */
+    readonly error: Error | null;
+}
+/**
+ * Data hook that computes a unified YAML diff between two workflow versions.
+ *
+ * Fetches both version entries via `stigmer.workflow.getVersion()` in
+ * parallel, extracts their `validatedYaml` fields, and runs
+ * {@link computeUnifiedDiff} to produce a line-by-line diff result.
+ *
+ * **Graceful degradation**: If the backend returns UNIMPLEMENTED for
+ * either fetch, the hook resolves to `null` without raising an error.
+ *
+ * Pass `null` for any parameter to disable fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { diff, isLoading } = useWorkflowVersionDiff(workflowId, hashA, hashB);
+ *
+ * if (diff) {
+ *   return <DiffViewer lines={diff} />;
+ * }
+ * ```
+ */
+export declare function useWorkflowVersionDiff(workflowId: string | null, hashA: string | null, hashB: string | null): UseWorkflowVersionDiffReturn;
+//# sourceMappingURL=useWorkflowVersionDiff.d.ts.map

package/workflow/useWorkflowVersionDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowVersionDiff.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowVersionDiff.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQzE,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,4BAA4B,CAwD9B"}

package/workflow/useWorkflowVersionDiff.js

@@ -0,0 +1,91 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { StigmerError } from "@stigmer/sdk";
+import { GetWorkflowVersionInputSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/version_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+import { computeUnifiedDiff } from "./workflow-yaml-diff";
+const CODE_UNIMPLEMENTED = 12;
+// ---------------------------------------------------------------------------
+// Hook implementation
+// ---------------------------------------------------------------------------
+/**
+ * Data hook that computes a unified YAML diff between two workflow versions.
+ *
+ * Fetches both version entries via `stigmer.workflow.getVersion()` in
+ * parallel, extracts their `validatedYaml` fields, and runs
+ * {@link computeUnifiedDiff} to produce a line-by-line diff result.
+ *
+ * **Graceful degradation**: If the backend returns UNIMPLEMENTED for
+ * either fetch, the hook resolves to `null` without raising an error.
+ *
+ * Pass `null` for any parameter to disable fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { diff, isLoading } = useWorkflowVersionDiff(workflowId, hashA, hashB);
+ *
+ * if (diff) {
+ *   return <DiffViewer lines={diff} />;
+ * }
+ * ```
+ */
+export function useWorkflowVersionDiff(workflowId, hashA, hashB) {
+    const stigmer = useStigmer();
+    const [diff, setDiff] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchIdRef = useRef(0);
+    const doFetch = useCallback(async () => {
+        if (!workflowId || !hashA || !hashB) {
+            setDiff(null);
+            setError(null);
+            return;
+        }
+        const fetchId = ++fetchIdRef.current;
+        setIsLoading(true);
+        setError(null);
+        try {
+            const [resultA, resultB] = await Promise.all([
+                stigmer.workflow.getVersion(create(GetWorkflowVersionInputSchema, { workflowId, versionHash: hashA })),
+                stigmer.workflow.getVersion(create(GetWorkflowVersionInputSchema, { workflowId, versionHash: hashB })),
+            ]);
+            if (fetchIdRef.current !== fetchId)
+                return;
+            const yamlA = resultA.validatedYaml ?? "";
+            const yamlB = resultB.validatedYaml ?? "";
+            const diffResult = computeUnifiedDiff(yamlA, yamlB);
+            if (fetchIdRef.current !== fetchId)
+                return;
+            setDiff(diffResult);
+        }
+        catch (err) {
+            if (fetchIdRef.current !== fetchId)
+                return;
+            if (isUnimplemented(err)) {
+                setDiff(null);
+            }
+            else {
+                setError(toError(err));
+                setDiff(null);
+            }
+        }
+        finally {
+            if (fetchIdRef.current === fetchId) {
+                setIsLoading(false);
+            }
+        }
+    }, [workflowId, hashA, hashB, stigmer]);
+    useEffect(() => {
+        doFetch();
+    }, [doFetch]);
+    return useMemo(() => ({ diff, isLoading, error }), [diff, isLoading, error]);
+}
+// ---------------------------------------------------------------------------
+// Error detection
+// ---------------------------------------------------------------------------
+function isUnimplemented(err) {
+    return err instanceof StigmerError && err.connectCode === CODE_UNIMPLEMENTED;
+}
+//# sourceMappingURL=useWorkflowVersionDiff.js.map

package/workflow/useWorkflowVersionDiff.js.map

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

package/workflow/useWorkflowVersions.d.ts

@@ -0,0 +1,44 @@
+import type { VersionEntry } from "../version-history/types";
+/** Return value of {@link useWorkflowVersions}. */
+export interface UseWorkflowVersionsReturn {
+    /** Version entries mapped to the generic timeline format (newest first). */
+    readonly versions: readonly VersionEntry[];
+    /** `true` when no versions are available (RPC unimplemented or empty response). */
+    readonly isEmpty: boolean;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request (excludes UNIMPLEMENTED), or `null`. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+    /**
+     * Look up the validated YAML for a version by its hash.
+     * Returns `null` if the version hash is not found or has no YAML content.
+     */
+    readonly getValidatedYaml: (versionHash: string) => string | null;
+}
+/**
+ * Data hook that fetches version history for a workflow.
+ *
+ * Calls the `listVersions` RPC via the SDK client and maps the response
+ * to generic {@link VersionEntry} objects for the `VersionTimeline`
+ * component.
+ *
+ * **Graceful degradation**: If the backend returns UNIMPLEMENTED (the
+ * RPC handler hasn't been deployed yet), the hook treats it as an empty
+ * response — `versions` is `[]` and `isEmpty` is `true`. No error is
+ * surfaced to the consumer.
+ *
+ * Pass `null` for `org` or `slug` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { versions, isEmpty, isLoading } = useWorkflowVersions("acme", "deploy-pipeline");
+ *
+ * if (!isEmpty) {
+ *   return <VersionTimeline entries={versions} />;
+ * }
+ * ```
+ */
+export declare function useWorkflowVersions(org: string | null, slug: string | null): UseWorkflowVersionsReturn;
+//# sourceMappingURL=useWorkflowVersions.d.ts.map

package/workflow/useWorkflowVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowVersions.d.ts","sourceRoot":"","sources":["../../src/workflow/useWorkflowVersions.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQ7D,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACnE;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,yBAAyB,CAuD3B"}