@stigmer/react 1.0.3 → 2.0.0

package/workflow/templates/__tests__/workflow-template-gallery.test.js

@@ -0,0 +1,119 @@
+import { describe, it, expect } from "vitest";
+import { WORKFLOW_TEMPLATES } from "../../../resource-creation/templates/workflow-templates";
+import { deriveTemplateMeta } from "../derive-template-metadata";
+describe("WORKFLOW_TEMPLATES", () => {
+    it("has 8 templates", () => {
+        expect(WORKFLOW_TEMPLATES).toHaveLength(8);
+    });
+    it("every template has a unique id", () => {
+        const ids = WORKFLOW_TEMPLATES.map((t) => t.id);
+        expect(new Set(ids).size).toBe(ids.length);
+    });
+    it("every template has required fields", () => {
+        for (const template of WORKFLOW_TEMPLATES) {
+            expect(template.id).toBeTruthy();
+            expect(template.name).toBeTruthy();
+            expect(template.description).toBeTruthy();
+            expect(template.category).toBeTruthy();
+            expect(template.data.yaml).toBeTruthy();
+        }
+    });
+    it("every template YAML parses to non-zero task count", () => {
+        for (const template of WORKFLOW_TEMPLATES) {
+            const meta = deriveTemplateMeta(template.data.yaml ?? "");
+            expect(meta.taskCount).toBeGreaterThan(0);
+        }
+    });
+    it("every template has at least one detected pattern", () => {
+        for (const template of WORKFLOW_TEMPLATES) {
+            const meta = deriveTemplateMeta(template.data.yaml ?? "");
+            expect(meta.patterns.length).toBeGreaterThan(0);
+        }
+    });
+    it("templates cover expected categories", () => {
+        const categories = new Set(WORKFLOW_TEMPLATES.map((t) => t.category));
+        expect(categories.has("data-analysis")).toBe(true);
+        expect(categories.has("customer-support")).toBe(true);
+        expect(categories.has("content")).toBe(true);
+        expect(categories.has("integration")).toBe(true);
+    });
+    it("templates collectively cover key task kinds", () => {
+        const allKinds = new Set();
+        for (const template of WORKFLOW_TEMPLATES) {
+            const meta = deriveTemplateMeta(template.data.yaml ?? "");
+            for (const kind of meta.taskKinds)
+                allKinds.add(kind);
+        }
+        expect(allKinds.has("llm_call")).toBe(true);
+        expect(allKinds.has("agent_call")).toBe(true);
+        expect(allKinds.has("http_call")).toBe(true);
+        expect(allKinds.has("switch_case")).toBe(true);
+        expect(allKinds.has("fork")).toBe(true);
+        expect(allKinds.has("for_each")).toBe(true);
+        expect(allKinds.has("try_catch")).toBe(true);
+        expect(allKinds.has("transform")).toBe(true);
+        expect(allKinds.has("human_input")).toBe(true);
+        expect(allKinds.has("set_vars")).toBe(true);
+    });
+    it("templates collectively cover key patterns", () => {
+        const allPatterns = new Set();
+        for (const template of WORKFLOW_TEMPLATES) {
+            const meta = deriveTemplateMeta(template.data.yaml ?? "");
+            for (const p of meta.patterns)
+                allPatterns.add(p);
+        }
+        expect(allPatterns.has("parallel")).toBe(true);
+        expect(allPatterns.has("branching")).toBe(true);
+        expect(allPatterns.has("hitl")).toBe(true);
+        expect(allPatterns.has("loop")).toBe(true);
+        expect(allPatterns.has("error-handling")).toBe(true);
+        expect(allPatterns.has("batch")).toBe(true);
+        expect(allPatterns.has("ai-pipeline")).toBe(true);
+        expect(allPatterns.has("http-integration")).toBe(true);
+    });
+});
+describe("individual template metadata", () => {
+    it("research-and-summarize has parallel and hitl patterns", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "research-and-summarize");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("parallel");
+        expect(meta.patterns).toContain("hitl");
+        expect(meta.taskCount).toBe(5);
+    });
+    it("support-ticket-triage has branching and hitl patterns", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "support-ticket-triage");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("branching");
+        expect(meta.patterns).toContain("hitl");
+        expect(meta.taskCount).toBe(6);
+    });
+    it("content-review-pipeline has loop and hitl patterns", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "content-review-pipeline");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("loop");
+        expect(meta.patterns).toContain("hitl");
+    });
+    it("batch-data-enrichment has batch and http-integration patterns", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "batch-data-enrichment");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("batch");
+        expect(meta.patterns).toContain("http-integration");
+    });
+    it("multi-agent-pipeline has ai-pipeline pattern", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "multi-agent-pipeline");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("ai-pipeline");
+    });
+    it("error-resilient-integration has error-handling pattern", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "error-resilient-integration");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("error-handling");
+    });
+    it("webhook-event-processor has branching and http-integration", () => {
+        const template = WORKFLOW_TEMPLATES.find((t) => t.id === "webhook-event-processor");
+        const meta = deriveTemplateMeta(template.data.yaml ?? "");
+        expect(meta.patterns).toContain("branching");
+        expect(meta.patterns).toContain("http-integration");
+    });
+});
+//# sourceMappingURL=workflow-template-gallery.test.js.map

package/workflow/templates/__tests__/workflow-template-gallery.test.js.map

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

package/workflow/templates/derive-template-metadata.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowTemplateMeta } from "./types";
+/**
+ * Derive display metadata from a workflow template's YAML string.
+ *
+ * This is a pure function with no React or SDK dependencies — it parses
+ * the YAML, walks the task list, and returns counts, kinds, and detected
+ * structural patterns. Used by the gallery card and preview dialog.
+ *
+ * If the YAML fails to parse, returns a safe zero-value result so the
+ * gallery card still renders (graceful degradation).
+ */
+export declare function deriveTemplateMeta(yaml: string): WorkflowTemplateMeta;
+//# sourceMappingURL=derive-template-metadata.d.ts.map

package/workflow/templates/derive-template-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-template-metadata.d.ts","sourceRoot":"","sources":["../../../src/workflow/templates/derive-template-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,SAAS,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAiCrE"}

package/workflow/templates/derive-template-metadata.js

@@ -0,0 +1,134 @@
+import { parse as parseYaml } from "yaml";
+/**
+ * Derive display metadata from a workflow template's YAML string.
+ *
+ * This is a pure function with no React or SDK dependencies — it parses
+ * the YAML, walks the task list, and returns counts, kinds, and detected
+ * structural patterns. Used by the gallery card and preview dialog.
+ *
+ * If the YAML fails to parse, returns a safe zero-value result so the
+ * gallery card still renders (graceful degradation).
+ */
+export function deriveTemplateMeta(yaml) {
+    try {
+        const doc = parseYaml(yaml);
+        const spec = doc?.spec;
+        if (!spec)
+            return EMPTY_META;
+        const tasks = Array.isArray(spec.tasks) ? spec.tasks : [];
+        const taskKinds = new Set();
+        for (const task of tasks) {
+            if (typeof task.kind === "string") {
+                taskKinds.add(task.kind);
+            }
+            collectNestedKinds(task, taskKinds);
+        }
+        const envMap = spec.env;
+        const envVarCount = envMap && typeof envMap === "object" ? Object.keys(envMap).length : 0;
+        const hasBudget = spec.budget != null && typeof spec.budget === "object";
+        const patterns = detectPatterns(tasks, taskKinds);
+        return {
+            taskCount: tasks.length,
+            taskKinds: [...taskKinds].sort(),
+            patterns,
+            envVarCount,
+            hasBudget,
+        };
+    }
+    catch {
+        return EMPTY_META;
+    }
+}
+const EMPTY_META = {
+    taskCount: 0,
+    taskKinds: [],
+    patterns: [],
+    envVarCount: 0,
+    hasBudget: false,
+};
+/**
+ * Collect task kinds from nested structures (fork branches,
+ * try_catch do/catch blocks, for_each do lists).
+ */
+function collectNestedKinds(task, kinds) {
+    const config = task.task_config;
+    if (!config)
+        return;
+    // fork branches
+    const branches = config.branches;
+    if (Array.isArray(branches)) {
+        for (const branch of branches) {
+            const doTasks = branch?.do;
+            if (Array.isArray(doTasks)) {
+                for (const nested of doTasks) {
+                    if (typeof nested?.kind === "string")
+                        kinds.add(nested.kind);
+                    collectNestedKinds(nested, kinds);
+                }
+            }
+        }
+    }
+    // try_catch: do / catch
+    const tryDo = config.do;
+    if (Array.isArray(tryDo)) {
+        for (const nested of tryDo) {
+            if (typeof nested?.kind === "string")
+                kinds.add(nested.kind);
+            collectNestedKinds(nested, kinds);
+        }
+    }
+    const catchBlocks = config.catch;
+    if (Array.isArray(catchBlocks)) {
+        for (const block of catchBlocks) {
+            const catchDo = block?.do;
+            if (Array.isArray(catchDo)) {
+                for (const nested of catchDo) {
+                    if (typeof nested?.kind === "string")
+                        kinds.add(nested.kind);
+                    collectNestedKinds(nested, kinds);
+                }
+            }
+        }
+    }
+    // for_each: do
+    const forDo = config.do;
+    if (Array.isArray(forDo) && task.kind === "for_each") {
+        for (const nested of forDo) {
+            if (typeof nested?.kind === "string")
+                kinds.add(nested.kind);
+            collectNestedKinds(nested, kinds);
+        }
+    }
+}
+function detectPatterns(tasks, kinds) {
+    const patterns = [];
+    if (kinds.has("fork"))
+        patterns.push("parallel");
+    if (kinds.has("switch_case"))
+        patterns.push("branching");
+    if (kinds.has("human_input"))
+        patterns.push("hitl");
+    if (kinds.has("for_each"))
+        patterns.push("batch");
+    if (kinds.has("try_catch"))
+        patterns.push("error-handling");
+    if (kinds.has("http_call") || kinds.has("grpc_call")) {
+        patterns.push("http-integration");
+    }
+    const aiKinds = ["agent_call", "llm_call", "eval"];
+    const aiCount = aiKinds.filter((k) => kinds.has(k)).length;
+    if (aiCount >= 2 || (kinds.has("agent_call") && tasks.filter((t) => t.kind === "agent_call").length >= 2)) {
+        patterns.push("ai-pipeline");
+    }
+    // Detect loops: any task's flow.then references an earlier task
+    const taskNames = tasks.map((t) => t.name).filter(Boolean);
+    for (let i = 0; i < tasks.length; i++) {
+        const thenTarget = tasks[i]?.flow?.then;
+        if (thenTarget && taskNames.indexOf(thenTarget) < i) {
+            patterns.push("loop");
+            break;
+        }
+    }
+    return patterns;
+}
+//# sourceMappingURL=derive-template-metadata.js.map

package/workflow/templates/derive-template-metadata.js.map

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

package/workflow/templates/index.d.ts

@@ -0,0 +1,10 @@
+export type { WorkflowTemplateData, WorkflowTemplateCategory, WorkflowTemplateMeta, WorkflowPattern, WorkflowTemplate, } from "./types";
+export { PATTERN_LABELS, WORKFLOW_CATEGORY_LABELS } from "./types";
+export { deriveTemplateMeta } from "./derive-template-metadata";
+export { WorkflowTemplateCard } from "./WorkflowTemplateCard";
+export type { WorkflowTemplateCardProps } from "./WorkflowTemplateCard";
+export { WorkflowTemplatePreview } from "./WorkflowTemplatePreview";
+export type { WorkflowTemplatePreviewProps } from "./WorkflowTemplatePreview";
+export { WorkflowTemplateGallery } from "./WorkflowTemplateGallery";
+export type { WorkflowTemplateGalleryProps } from "./WorkflowTemplateGallery";
+//# sourceMappingURL=index.d.ts.map

package/workflow/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/templates/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAGnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC"}

package/workflow/templates/index.js

@@ -0,0 +1,8 @@
+export { PATTERN_LABELS, WORKFLOW_CATEGORY_LABELS } from "./types";
+// Pure derivation
+export { deriveTemplateMeta } from "./derive-template-metadata";
+// Gallery components (added in Phase 2)
+export { WorkflowTemplateCard } from "./WorkflowTemplateCard";
+export { WorkflowTemplatePreview } from "./WorkflowTemplatePreview";
+export { WorkflowTemplateGallery } from "./WorkflowTemplateGallery";
+//# sourceMappingURL=index.js.map

package/workflow/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/templates/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEnE,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,wCAAwC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/workflow/templates/types.d.ts

@@ -0,0 +1,54 @@
+import type { ResourceTemplate, TemplateCategory } from "../../resource-creation/templates/types";
+/**
+ * Workflow-specific template categories for the gallery filter tabs.
+ *
+ * These extend the shared `TemplateCategory` type with workflow-specific
+ * use-case domains. The gallery renders them as filterable tabs alongside
+ * the generic categories.
+ */
+export type WorkflowTemplateCategory = TemplateCategory;
+/**
+ * Human-readable labels for workflow template categories.
+ */
+export declare const WORKFLOW_CATEGORY_LABELS: Record<WorkflowTemplateCategory, string>;
+/**
+ * The data payload carried by a workflow template.
+ *
+ * Unlike agent templates (which carry form fields for a wizard),
+ * workflow templates carry the full YAML string. Selecting a template
+ * opens the editor with this YAML as `initialYaml`.
+ */
+export interface WorkflowTemplateData {
+    /** Full workflow YAML including apiVersion/kind/metadata/spec envelope. */
+    readonly yaml: string;
+}
+/**
+ * A structural workflow pattern detected in a template's YAML.
+ *
+ * Pattern badges help users visually identify what a template
+ * demonstrates without reading the full YAML.
+ */
+export type WorkflowPattern = "parallel" | "branching" | "hitl" | "loop" | "error-handling" | "batch" | "ai-pipeline" | "http-integration";
+/** Human-readable labels for pattern badges. */
+export declare const PATTERN_LABELS: Record<WorkflowPattern, string>;
+/**
+ * Metadata derived from a workflow template's YAML content.
+ *
+ * Computed once at render time by `deriveTemplateMeta()` and displayed
+ * on template cards and preview dialogs.
+ */
+export interface WorkflowTemplateMeta {
+    /** Number of top-level tasks (excludes nested tasks inside fork/try_catch/for_each). */
+    readonly taskCount: number;
+    /** Unique task kind strings used in the template. */
+    readonly taskKinds: readonly string[];
+    /** Structural patterns detected in the template. */
+    readonly patterns: readonly WorkflowPattern[];
+    /** Number of environment variable declarations. */
+    readonly envVarCount: number;
+    /** Whether the template declares a budget. */
+    readonly hasBudget: boolean;
+}
+/** Workflow template = generic ResourceTemplate with workflow-specific data. */
+export type WorkflowTemplate = ResourceTemplate<WorkflowTemplateData>;
+//# sourceMappingURL=types.d.ts.map

package/workflow/templates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflow/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAElG;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAS3E,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,WAAW,GACX,MAAM,GACN,MAAM,GACN,gBAAgB,GAChB,OAAO,GACP,aAAa,GACb,kBAAkB,CAAC;AAEvB,gDAAgD;AAChD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAS1D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAC"}

package/workflow/templates/types.js

@@ -0,0 +1,24 @@
+/**
+ * Human-readable labels for workflow template categories.
+ */
+export const WORKFLOW_CATEGORY_LABELS = {
+    "customer-support": "Customer Support",
+    "code-review": "Code Review",
+    "data-analysis": "Data Analysis",
+    devops: "DevOps",
+    content: "Content",
+    integration: "Integration",
+    general: "General",
+};
+/** Human-readable labels for pattern badges. */
+export const PATTERN_LABELS = {
+    parallel: "Parallel",
+    branching: "Branching",
+    hitl: "Human-in-the-Loop",
+    loop: "Loop",
+    "error-handling": "Error Handling",
+    batch: "Batch Processing",
+    "ai-pipeline": "AI Pipeline",
+    "http-integration": "HTTP Integration",
+};
+//# sourceMappingURL=types.js.map

package/workflow/templates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/workflow/templates/types.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC;IACE,kBAAkB,EAAE,kBAAkB;IACtC,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,eAAe;IAChC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;CACnB,CAAC;AA8BJ,gDAAgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAAoC;IAC7D,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,MAAM;IACZ,gBAAgB,EAAE,gBAAgB;IAClC,KAAK,EAAE,kBAAkB;IACzB,aAAa,EAAE,aAAa;IAC5B,kBAAkB,EAAE,kBAAkB;CACvC,CAAC"}

package/workflow/topologyFromTasks.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowTask } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/spec_pb";
+import type { UseWorkflowTopologyReturn } from "./useWorkflowTopology";
+/**
+ * Builds a DAG topology directly from proto `WorkflowTask[]`.
+ *
+ * Mirrors the logic in {@link useWorkflowTopology} but operates on
+ * typed proto objects instead of parsed YAML, eliminating the need
+ * for a round-trip through YAML serialization and re-parsing.
+ *
+ * Handles sequential flow, explicit `flow.then` directives, and
+ * `switch_case` branching edges.
+ */
+export declare function topologyFromTasks(tasks: readonly WorkflowTask[]): UseWorkflowTopologyReturn;
+//# sourceMappingURL=topologyFromTasks.d.ts.map

package/workflow/topologyFromTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologyFromTasks.d.ts","sourceRoot":"","sources":["../../src/workflow/topologyFromTasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wDAAwD,CAAC;AAC3F,OAAO,KAAK,EAGV,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAQ/B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,yBAAyB,CAoG3B"}

package/workflow/topologyFromTasks.js

@@ -0,0 +1,111 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { categorizeKind } from "./kind-metadata";
+const NODE_WIDTH = 180;
+const NODE_HEIGHT = 40;
+const EMPTY = { nodes: [], edges: [] };
+/**
+ * Builds a DAG topology directly from proto `WorkflowTask[]`.
+ *
+ * Mirrors the logic in {@link useWorkflowTopology} but operates on
+ * typed proto objects instead of parsed YAML, eliminating the need
+ * for a round-trip through YAML serialization and re-parsing.
+ *
+ * Handles sequential flow, explicit `flow.then` directives, and
+ * `switch_case` branching edges.
+ */
+export function topologyFromTasks(tasks) {
+    if (tasks.length === 0)
+        return EMPTY;
+    const nodes = [];
+    const edges = [];
+    const taskNameSet = new Set(tasks.map((t) => t.name));
+    nodes.push({
+        id: "__start__",
+        label: "Start",
+        kind: "start",
+        category: "start",
+        x: 0,
+        y: 0,
+        width: NODE_WIDTH,
+        height: NODE_HEIGHT,
+    });
+    for (const task of tasks) {
+        const kindStr = kindToString(task.kind);
+        nodes.push({
+            id: task.name,
+            label: task.name,
+            kind: kindStr,
+            category: categorizeKind(kindStr),
+            x: 0,
+            y: 0,
+            width: NODE_WIDTH,
+            height: NODE_HEIGHT,
+        });
+    }
+    edges.push({ source: "__start__", target: tasks[0].name });
+    const tasksWithEndFlow = new Set();
+    for (let i = 0; i < tasks.length; i++) {
+        const task = tasks[i];
+        const thenTarget = task.flow?.then;
+        if (thenTarget === "end") {
+            tasksWithEndFlow.add(task.name);
+            continue;
+        }
+        if (thenTarget && taskNameSet.has(thenTarget)) {
+            edges.push({ source: task.name, target: thenTarget });
+            continue;
+        }
+        if (task.kind === WorkflowTaskKind.switch_case && task.taskConfig) {
+            const cases = task.taskConfig.cases;
+            if (Array.isArray(cases)) {
+                let hasDefault = false;
+                for (const c of cases) {
+                    if (c && typeof c === "object") {
+                        const caseObj = c;
+                        const caseThen = caseObj.then;
+                        if (caseThen && taskNameSet.has(caseThen)) {
+                            edges.push({
+                                source: task.name,
+                                target: caseThen,
+                                label: caseObj.name || undefined,
+                            });
+                            if (!caseObj.when)
+                                hasDefault = true;
+                        }
+                    }
+                }
+                if (!hasDefault && i < tasks.length - 1) {
+                    edges.push({ source: task.name, target: tasks[i + 1].name });
+                }
+                continue;
+            }
+        }
+        if (i < tasks.length - 1) {
+            edges.push({ source: task.name, target: tasks[i + 1].name });
+        }
+        else {
+            tasksWithEndFlow.add(task.name);
+        }
+    }
+    if (tasksWithEndFlow.size > 0) {
+        nodes.push({
+            id: "__end__",
+            label: "End",
+            kind: "end",
+            category: "end",
+            x: 0,
+            y: 0,
+            width: NODE_WIDTH,
+            height: NODE_HEIGHT,
+        });
+        for (const name of tasksWithEndFlow) {
+            edges.push({ source: name, target: "__end__" });
+        }
+    }
+    return { nodes, edges };
+}
+function kindToString(kind) {
+    const entry = Object.entries(WorkflowTaskKind).find(([, v]) => v === kind && typeof v === "number");
+    return entry?.[0] ?? "unspecified";
+}
+//# sourceMappingURL=topologyFromTasks.js.map

package/workflow/topologyFromTasks.js.map

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

package/workflow/useActiveTaskName.d.ts

@@ -0,0 +1,35 @@
+import type { DerivedTaskState } from "../internal/store/workflow-execution-event-store";
+/**
+ * Active task status returned by {@link useActiveTaskName}.
+ *
+ * `null` when no task is actively running or awaiting action.
+ */
+export interface ActiveTaskInfo {
+    /** The task name that is currently active. */
+    readonly taskName: string;
+    /** The specific status: "running" or "waiting_approval". */
+    readonly status: "running" | "waiting_approval";
+    /** Duration in milliseconds (from DerivedTaskState). */
+    readonly durationMs: number;
+    /** Agent slug if this is an agent_call task. */
+    readonly agentSlug: string;
+    /** Current tool name if agent is using a tool. */
+    readonly currentToolName: string;
+    /** Number of concurrently running tasks (>1 for fork branches). */
+    readonly concurrentCount: number;
+}
+/**
+ * Pure derivation hook that selects the currently active task from the
+ * task states map. Returns referentially stable output (string comparison,
+ * not array/object reference) to avoid downstream re-renders.
+ *
+ * "Active" means either `running` or `waiting_approval` — both represent
+ * states where the execution is at a specific task and the user cares
+ * about its identity.
+ *
+ * When multiple tasks are running simultaneously (fork branches), returns
+ * the first one found with a `concurrentCount` indicating parallelism.
+ * The indicator UI can use this to show "N tasks running in parallel".
+ */
+export declare function useActiveTaskName(taskStates: ReadonlyMap<string, DerivedTaskState>): ActiveTaskInfo | null;
+//# sourceMappingURL=useActiveTaskName.d.ts.map

package/workflow/useActiveTaskName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveTaskName.d.ts","sourceRoot":"","sources":["../../src/workflow/useActiveTaskName.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAC;IAChD,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAChD,cAAc,GAAG,IAAI,CAuCvB"}

package/workflow/useActiveTaskName.js

@@ -0,0 +1,52 @@
+"use client";
+import { useMemo } from "react";
+/**
+ * Pure derivation hook that selects the currently active task from the
+ * task states map. Returns referentially stable output (string comparison,
+ * not array/object reference) to avoid downstream re-renders.
+ *
+ * "Active" means either `running` or `waiting_approval` — both represent
+ * states where the execution is at a specific task and the user cares
+ * about its identity.
+ *
+ * When multiple tasks are running simultaneously (fork branches), returns
+ * the first one found with a `concurrentCount` indicating parallelism.
+ * The indicator UI can use this to show "N tasks running in parallel".
+ */
+export function useActiveTaskName(taskStates) {
+    return useMemo(() => {
+        let firstRunning = null;
+        let runningCount = 0;
+        for (const [name, state] of taskStates) {
+            if (state.status === "waiting_approval") {
+                // Waiting approval takes priority — it's an actionable state
+                return {
+                    taskName: name,
+                    status: "waiting_approval",
+                    durationMs: state.durationMs,
+                    agentSlug: state.agentSlug,
+                    currentToolName: state.currentToolName,
+                    concurrentCount: 1,
+                };
+            }
+            if (state.status === "running") {
+                runningCount++;
+                if (!firstRunning) {
+                    firstRunning = {
+                        taskName: name,
+                        status: "running",
+                        durationMs: state.durationMs,
+                        agentSlug: state.agentSlug,
+                        currentToolName: state.currentToolName,
+                        concurrentCount: 1,
+                    };
+                }
+            }
+        }
+        if (firstRunning && runningCount > 1) {
+            return { ...firstRunning, concurrentCount: runningCount };
+        }
+        return firstRunning;
+    }, [taskStates]);
+}
+//# sourceMappingURL=useActiveTaskName.js.map