@stigmer/react 0.5.1 → 1.0.0

package/workflow/workflow-graph-conversions.d.ts

@@ -0,0 +1,70 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import type { JsonObject } from "@bufbuild/protobuf";
+import type { Node, Edge } from "@xyflow/react";
+import type { WorkflowInput } from "@stigmer/sdk";
+import type { TopologyNodeCategory } from "./useWorkflowTopology";
+import type { WorkflowGraphModel } from "./workflow-graph-model";
+export declare const CANVAS_TASK_NODE_TYPE: "canvasTask";
+export declare const CANVAS_TRANSITION_EDGE_TYPE: "canvasTransition";
+export declare function categorizeKind(kind: string): TopologyNodeCategory;
+export declare function taskKindToString(kind: WorkflowTaskKind): string;
+export declare function stringToTaskKind(str: string): WorkflowTaskKind;
+/**
+ * Parses a Stigmer Workflow YAML string into an editable graph model.
+ *
+ * Builds nodes from `spec.tasks` with full configuration data, and infers
+ * edges from sequential ordering, explicit `flow.then`, `switch_case`
+ * branches, `human_input` outcomes, and fallback task references.
+ *
+ * @throws {Error} When the YAML is fundamentally unparseable or lacks required structure.
+ *
+ * @since T15 (Visual Canvas Editor)
+ */
+export declare function yamlToGraph(yaml: string): WorkflowGraphModel;
+/**
+ * Serializes a graph model back to canonical Stigmer Workflow YAML.
+ *
+ * Uses topological sort to determine task ordering. Sequential transitions
+ * (task N → task N+1 in sorted order) are implicit and omitted from YAML.
+ * Non-sequential transitions emit explicit `flow.then` directives.
+ *
+ * @since T15 (Visual Canvas Editor)
+ */
+export declare function graphToYaml(graph: WorkflowGraphModel): string;
+/**
+ * Converts a graph model into a `WorkflowInput` suitable for
+ * `stigmer.workflow.apply()`.
+ *
+ * This will be the primary save path in Batch 3 when `useWorkflowSave`
+ * is extended to accept `WorkflowInput` directly.
+ *
+ * @since T15 (Visual Canvas Editor)
+ */
+export declare function graphToWorkflowInput(graph: WorkflowGraphModel, org: string): WorkflowInput;
+/** Data payload attached to canvas task nodes. */
+export interface CanvasTaskNodeData extends Record<string, unknown> {
+    taskName: string;
+    kind: WorkflowTaskKind;
+    kindString: string;
+    category: TopologyNodeCategory;
+    config: JsonObject;
+    exportAs?: string;
+    isSentinel: boolean;
+    errorCount?: number;
+}
+/** Data payload attached to canvas transition edges. */
+export interface CanvasTransitionEdgeData extends Record<string, unknown> {
+    label?: string;
+}
+/**
+ * Converts a `WorkflowGraphModel` into React Flow node and edge arrays
+ * with the custom type identifiers used by `CanvasTaskNode` and
+ * `CanvasTransitionEdge`.
+ *
+ * @since T15 (Visual Canvas Editor)
+ */
+export declare function toReactFlowElements(graph: WorkflowGraphModel): {
+    nodes: Node[];
+    edges: Edge[];
+};
+//# sourceMappingURL=workflow-graph-conversions.d.ts.map

package/workflow/workflow-graph-conversions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph-conversions.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-graph-conversions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAwB,MAAM,wDAAwD,CAAC;AAChH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EACV,kBAAkB,EAMnB,MAAM,wBAAwB,CAAC;AAQhC,eAAO,MAAM,qBAAqB,EAAG,YAAqB,CAAC;AAC3D,eAAO,MAAM,2BAA2B,EAAG,kBAA2B,CAAC;AAavE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAQjE;AAoBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAE9D;AAyBD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAsK5D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA6E7D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,MAAM,GACV,aAAa,CA+Df;AAMD,kDAAkD;AAClD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wDAAwD;AACxD,MAAM,WAAW,wBAAyB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG;IAC9D,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAmCA"}