@stigmer/react 0.5.0 → 1.0.0

package/workflow/index.js

@@ -0,0 +1,88 @@
+export { serializeWorkflowYaml, parseWorkflowYaml, } from "./serialize-workflow-yaml";
+export { useWorkflowYaml, } from "./useWorkflowYaml";
+export { useWorkflowSave, } from "./useWorkflowSave";
+export { TaskKindRegistryContext, } from "./TaskKindRegistryContext";
+export { useTaskKindRegistry, } from "./useTaskKindRegistry";
+export { useWorkflow, } from "./useWorkflow";
+export { useWorkflowList, } from "./useWorkflowList";
+export { useWorkflowCount, } from "./useWorkflowCount";
+export { useWorkflowInstances, } from "./useWorkflowInstances";
+export { useWorkflowExecutionList, } from "./useWorkflowExecutionList";
+// T09: Execution viewer — data hooks
+export { useWorkflowExecution, } from "./useWorkflowExecution";
+export { useWorkflowExecutionEventLog, } from "./useWorkflowExecutionEventLog";
+export { useWorkflowExecutionArtifacts, } from "./useWorkflowExecutionArtifacts";
+// T09: Execution viewer — behavior hooks
+export { useWorkflowExecutionEventStream, } from "./useWorkflowExecutionEventStream";
+export { useWorkflowExecutionActions, } from "./useWorkflowExecutionActions";
+// T10: YAML editor — behavior hooks
+export { useWorkflowValidation, } from "./useWorkflowValidation";
+export { useWorkflowTopology, } from "./useWorkflowTopology";
+// T10: YAML editor — styled components
+export { WorkflowYamlEditor, } from "./WorkflowYamlEditor";
+export { WorkflowTopologyGraph, } from "./WorkflowTopologyGraph";
+export { useWorkflowEditor, } from "./useWorkflowEditor";
+export { WorkflowEditorView, } from "./WorkflowEditorView";
+// T11: Run workflow — behavior hook
+export { useRunWorkflowFlow, } from "./useRunWorkflowFlow";
+// T11: Run workflow — styled components
+export { WorkflowRunForm, } from "./WorkflowRunForm";
+export { WorkflowRunDialog, } from "./WorkflowRunDialog";
+// T08: Workflow styled components
+export { WorkflowExecutionPhaseBadge, } from "./WorkflowExecutionPhaseBadge";
+export { WorkflowTaskList, } from "./WorkflowTaskList";
+export { WorkflowDetailView, } from "./WorkflowDetailView";
+// T09: Execution viewer — styled components
+export { WorkflowExecutionViewer, } from "./WorkflowExecutionViewer";
+export { WorkflowExecutionHeader, } from "./WorkflowExecutionHeader";
+export { WorkflowExecutionTimeline, } from "./WorkflowExecutionTimeline";
+export { WorkflowExecutionTaskPanel, } from "./WorkflowExecutionTaskPanel";
+export { WorkflowExecutionCostPanel, } from "./WorkflowExecutionCostPanel";
+export { WorkflowExecutionArtifactPanel, } from "./WorkflowExecutionArtifactPanel";
+export { WorkflowExecutionApprovalCard, } from "./WorkflowExecutionApprovalCard";
+// T14: Dashboard — data hooks
+export { useWorkflowDashboardSummary, } from "./useWorkflowDashboardSummary";
+export { usePendingApprovals, } from "./usePendingApprovals";
+// T14: Dashboard — styled components
+export { ExecutionSummaryWidget, } from "./ExecutionSummaryWidget";
+export { PendingApprovalsWidget, } from "./PendingApprovalsWidget";
+export { FailedRunsWidget, } from "./FailedRunsWidget";
+export { WorkflowDashboard, } from "./WorkflowDashboard";
+export { START_NODE_ID, END_NODE_ID } from "./workflow-graph-model";
+// T15: Visual canvas editor — conversion functions
+export { yamlToGraph, graphToYaml, graphToWorkflowInput, } from "./workflow-graph-conversions";
+// T15: Visual canvas editor — behavior hook
+export { useWorkflowCanvas, } from "./useWorkflowCanvas";
+// T15: Visual canvas editor — styled components
+export { WorkflowCanvasEditor, } from "./WorkflowCanvasEditor";
+export { WorkflowTaskPalette, TASK_KIND_DRAG_MIME, } from "./WorkflowTaskPalette";
+export { TaskPickerPopover, } from "./TaskPickerPopover";
+export { CanvasContextMenu, } from "./CanvasContextMenu";
+export { WorkflowInspectorPanel, } from "./WorkflowInspectorPanel";
+export { TaskConfigForm, } from "./TaskConfigForm";
+export { BranchConditionBuilder, } from "./BranchConditionBuilder";
+export { ApprovalFormBuilder, } from "./ApprovalFormBuilder";
+// Dashboard chart components
+export { CostByWorkflowChart, } from "./CostByWorkflowChart";
+export { ExecutionTrendChart, } from "./ExecutionTrendChart";
+// Workflow Architect — YAML extraction utility
+export { extractWorkflowYaml, } from "./extract-workflow-yaml";
+// Workflow Architect — behavior hook (replaces T16 generateWorkflowFromPrompt)
+export { useWorkflowArchitectFlow, } from "./useWorkflowArchitectFlow";
+// Workflow Architect — styled component (replaces T16 WorkflowGenerateDialog)
+export { WorkflowArchitectDialog, } from "./WorkflowArchitectDialog";
+// Workflow Architect — refine behavior hook (replaces T16 refineWorkflow)
+export { useRefineWorkflowFlow, } from "./useRefineWorkflowFlow";
+// Workflow Architect — refine styled component (replaces T16 WorkflowRefinePanel)
+export { WorkflowRefinePanel, } from "./WorkflowRefinePanel";
+// Workflow diff utility
+export { computeUnifiedDiff, } from "./workflow-yaml-diff";
+// Workflow Architect — diagnose behavior hook (replaces T16 diagnoseExecution)
+export { useDiagnoseExecutionFlow, } from "./useDiagnoseExecutionFlow";
+// Workflow Architect — diagnose styled component (replaces T16 WorkflowRepairCard)
+export { WorkflowRepairCard, } from "./WorkflowRepairCard";
+// Starter YAML template for new workflow creation
+export { STARTER_WORKFLOW_YAML } from "./starter-workflow-yaml";
+// Navigation resolution hook
+export { useResolveAgentExecutionSession, } from "./useResolveAgentExecutionSession";
+//# sourceMappingURL=index.js.map

package/workflow/index.js.map

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

package/workflow/serialize-workflow-yaml.d.ts

@@ -0,0 +1,39 @@
+import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import type { WorkflowInput } from "@stigmer/sdk";
+/**
+ * Serializes a proto `Workflow` into the canonical Stigmer YAML format.
+ *
+ * The output uses snake_case field names and is round-trip compatible
+ * with {@link parseWorkflowYaml}. Only emits `apiVersion`, `kind`,
+ * `metadata`, and `spec` — the `status` field is system-managed.
+ *
+ * @param workflow - The proto `Workflow` resource to serialize.
+ * @returns A YAML string suitable for editing and re-applying.
+ *
+ * @example
+ * ```ts
+ * const yaml = serializeWorkflowYaml(workflow);
+ * // Edit yaml...
+ * const input = parseWorkflowYaml(yaml, "acme");
+ * await stigmer.workflow.apply(input);
+ * ```
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export declare function serializeWorkflowYaml(workflow: Workflow): string;
+/**
+ * Parses a Stigmer Workflow YAML string into a `WorkflowInput` suitable
+ * for `stigmer.workflow.apply()`.
+ *
+ * Handles snake_case → camelCase conversion for all nested structures
+ * including tasks, env declarations, budget, and flow control.
+ *
+ * @param content - Raw YAML content string.
+ * @param org - Target organization slug. Overrides `metadata.org` in the YAML.
+ * @returns A `WorkflowInput` ready for the SDK apply/update call.
+ * @throws {Error} When the YAML is malformed or missing required fields.
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export declare function parseWorkflowYaml(content: string, org: string): WorkflowInput;
+//# sourceMappingURL=serialize-workflow-yaml.d.ts.map

package/workflow/serialize-workflow-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-workflow-yaml.d.ts","sourceRoot":"","sources":["../../src/workflow/serialize-workflow-yaml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAStF,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,cAAc,CAAC;AAOtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAShE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,aAAa,CA6Bf"}

package/workflow/serialize-workflow-yaml.js

@@ -0,0 +1,413 @@
+import { stringify as stringifyYaml, parse as parseYaml } from "yaml";
+import { WorkflowTaskKind, BudgetExceededPolicy } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+// ---------------------------------------------------------------------------
+// Proto → YAML (serialize)
+// ---------------------------------------------------------------------------
+/**
+ * Serializes a proto `Workflow` into the canonical Stigmer YAML format.
+ *
+ * The output uses snake_case field names and is round-trip compatible
+ * with {@link parseWorkflowYaml}. Only emits `apiVersion`, `kind`,
+ * `metadata`, and `spec` — the `status` field is system-managed.
+ *
+ * @param workflow - The proto `Workflow` resource to serialize.
+ * @returns A YAML string suitable for editing and re-applying.
+ *
+ * @example
+ * ```ts
+ * const yaml = serializeWorkflowYaml(workflow);
+ * // Edit yaml...
+ * const input = parseWorkflowYaml(yaml, "acme");
+ * await stigmer.workflow.apply(input);
+ * ```
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export function serializeWorkflowYaml(workflow) {
+    const doc = {
+        apiVersion: workflow.apiVersion || "agentic.stigmer.ai/v1",
+        kind: workflow.kind || "Workflow",
+        metadata: buildMetadata(workflow),
+        spec: buildWorkflowSpec(workflow.spec),
+    };
+    return stringifyYaml(doc, { lineWidth: 0, blockQuote: "literal" });
+}
+// ---------------------------------------------------------------------------
+// YAML → WorkflowInput (parse)
+// ---------------------------------------------------------------------------
+/**
+ * Parses a Stigmer Workflow YAML string into a `WorkflowInput` suitable
+ * for `stigmer.workflow.apply()`.
+ *
+ * Handles snake_case → camelCase conversion for all nested structures
+ * including tasks, env declarations, budget, and flow control.
+ *
+ * @param content - Raw YAML content string.
+ * @param org - Target organization slug. Overrides `metadata.org` in the YAML.
+ * @returns A `WorkflowInput` ready for the SDK apply/update call.
+ * @throws {Error} When the YAML is malformed or missing required fields.
+ *
+ * @since T10 (YAML Editor with Graph Preview)
+ */
+export function parseWorkflowYaml(content, org) {
+    const raw = parseYamlSafe(content);
+    validateWorkflowStructure(raw);
+    const metadata = raw.metadata;
+    const spec = raw.spec;
+    const name = requireString(metadata, "name", "metadata.name");
+    const slug = optString(metadata, "slug");
+    const labels = optStringRecord(metadata, "labels");
+    const document = extractDocument(spec);
+    const tasks = extractTasks(spec);
+    const env = extractEnv(spec);
+    const budget = extractBudget(spec);
+    const description = optString(spec, "description");
+    return {
+        name,
+        org,
+        ...(slug !== undefined && { slug }),
+        ...(labels !== undefined && { labels }),
+        ...(description !== undefined && { description }),
+        document,
+        tasks,
+        ...(env !== undefined && { env }),
+        ...(budget !== undefined && { budget }),
+    };
+}
+// ---------------------------------------------------------------------------
+// Serialize helpers: proto → plain object
+// ---------------------------------------------------------------------------
+function buildMetadata(workflow) {
+    const m = workflow.metadata;
+    if (!m)
+        return {};
+    const result = { name: m.name };
+    if (m.org)
+        result.org = m.org;
+    if (m.slug && m.slug !== m.name)
+        result.slug = m.slug;
+    if (m.labels && Object.keys(m.labels).length > 0) {
+        result.labels = { ...m.labels };
+    }
+    return result;
+}
+function buildWorkflowSpec(spec) {
+    if (!spec)
+        return {};
+    const result = {};
+    if (spec.description)
+        result.description = spec.description;
+    if (spec.document)
+        result.document = buildDocument(spec.document);
+    if (spec.tasks.length > 0) {
+        result.tasks = spec.tasks.map(buildTask);
+    }
+    if (spec.env && Object.keys(spec.env).length > 0) {
+        result.env = buildEnvMap(spec.env);
+    }
+    if (spec.budget && hasBudgetValues(spec.budget)) {
+        result.budget = buildBudget(spec.budget);
+    }
+    return result;
+}
+function buildDocument(doc) {
+    const result = {};
+    if (doc.dsl)
+        result.dsl = doc.dsl;
+    if (doc.namespace)
+        result.namespace = doc.namespace;
+    if (doc.name)
+        result.name = doc.name;
+    if (doc.version)
+        result.version = doc.version;
+    if (doc.description)
+        result.description = doc.description;
+    return result;
+}
+function buildTask(task) {
+    const result = {
+        name: task.name,
+        kind: taskKindToString(task.kind),
+    };
+    if (task.taskConfig && Object.keys(task.taskConfig).length > 0) {
+        result.task_config = structToPlain(task.taskConfig);
+    }
+    if (task.export?.as) {
+        result.export = { as: task.export.as };
+    }
+    if (task.flow?.then) {
+        result.flow = { then: task.flow.then };
+    }
+    return result;
+}
+function buildEnvMap(env) {
+    const result = {};
+    for (const [key, decl] of Object.entries(env)) {
+        const entry = {};
+        if (decl.isSecret)
+            entry.is_secret = true;
+        if (decl.description)
+            entry.description = decl.description;
+        if (decl.optional)
+            entry.optional = true;
+        result[key] = entry;
+    }
+    return result;
+}
+function buildBudget(budget) {
+    const result = {};
+    const costMicros = Number(budget.maxCostMicros);
+    const totalTokens = Number(budget.maxTotalTokens);
+    if (costMicros > 0)
+        result.max_cost_micros = costMicros;
+    if (totalTokens > 0)
+        result.max_total_tokens = totalTokens;
+    if (budget.maxDurationSeconds > 0) {
+        result.max_duration_seconds = budget.maxDurationSeconds;
+    }
+    if (budget.onExceeded !== BudgetExceededPolicy.budget_exceeded_policy_unspecified) {
+        result.on_exceeded = budgetPolicyToString(budget.onExceeded);
+    }
+    return result;
+}
+function hasBudgetValues(budget) {
+    return (Number(budget.maxCostMicros) > 0 ||
+        Number(budget.maxTotalTokens) > 0 ||
+        budget.maxDurationSeconds > 0);
+}
+// ---------------------------------------------------------------------------
+// Parse helpers: plain object → WorkflowInput
+// ---------------------------------------------------------------------------
+function parseYamlSafe(content) {
+    let parsed;
+    try {
+        parsed = parseYaml(content);
+    }
+    catch {
+        throw new Error("Failed to parse content as YAML.");
+    }
+    if (!isObj(parsed)) {
+        throw new Error("YAML must be a mapping document, not a scalar or list.");
+    }
+    return parsed;
+}
+function validateWorkflowStructure(doc) {
+    const kind = doc.kind;
+    if (typeof kind === "string" && kind !== "Workflow") {
+        throw new Error(`Expected resource kind "Workflow", got "${kind}".`);
+    }
+    if (!isObj(doc.metadata)) {
+        throw new Error("Workflow YAML is missing required field: metadata.");
+    }
+    if (!isObj(doc.spec)) {
+        throw new Error("Workflow YAML is missing required field: spec.");
+    }
+}
+function extractDocument(spec) {
+    const raw = spec.document;
+    if (!isObj(raw)) {
+        throw new Error("Workflow YAML is missing required field: spec.document.");
+    }
+    return {
+        dsl: optString(raw, "dsl") ?? "1.0.0",
+        namespace: requireString(raw, "namespace", "spec.document.namespace"),
+        name: requireString(raw, "name", "spec.document.name"),
+        version: requireString(raw, "version", "spec.document.version"),
+        ...(raw.description && typeof raw.description === "string"
+            ? { description: raw.description }
+            : {}),
+    };
+}
+function extractTasks(spec) {
+    const raw = spec.tasks;
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw new Error("Workflow YAML is missing required field: spec.tasks (must be a non-empty list).");
+    }
+    return raw.filter(isObj).map((entry, idx) => {
+        const name = entry.name;
+        if (typeof name !== "string" || name.length === 0) {
+            throw new Error(`Workflow YAML: task at index ${idx} is missing required field: name.`);
+        }
+        const kindStr = entry.kind;
+        if (typeof kindStr !== "string" || kindStr.length === 0) {
+            throw new Error(`Workflow YAML: task "${name}" is missing required field: kind.`);
+        }
+        const kindEnum = stringToTaskKind(kindStr);
+        if (kindEnum === undefined) {
+            throw new Error(`Workflow YAML: task "${name}" has unknown kind "${kindStr}".`);
+        }
+        const taskConfig = (entry.task_config ?? entry.taskConfig);
+        if (!isObj(taskConfig)) {
+            throw new Error(`Workflow YAML: task "${name}" is missing required field: task_config.`);
+        }
+        const exportBlock = entry.export ?? entry.export;
+        const flowBlock = entry.flow;
+        const result = {
+            name,
+            kind: kindEnum,
+            taskConfig: taskConfig,
+        };
+        if (isObj(exportBlock)) {
+            const asVal = exportBlock.as;
+            if (typeof asVal === "string" && asVal.length > 0) {
+                result.export = { as: asVal };
+            }
+        }
+        if (isObj(flowBlock)) {
+            const thenVal = flowBlock.then;
+            if (typeof thenVal === "string" && thenVal.length > 0) {
+                result.flow = { then: thenVal };
+            }
+        }
+        return result;
+    });
+}
+function extractEnv(spec) {
+    const raw = spec.env;
+    if (!isObj(raw))
+        return undefined;
+    const result = {};
+    let hasEntries = false;
+    for (const [key, val] of Object.entries(raw)) {
+        if (!isObj(val))
+            continue;
+        const isSecret = val.is_secret ?? val.isSecret;
+        const description = val.description;
+        const optional = val.optional;
+        result[key] = {
+            ...(typeof isSecret === "boolean" && { isSecret }),
+            ...(typeof description === "string" && { description }),
+            ...(typeof optional === "boolean" && { optional }),
+        };
+        hasEntries = true;
+    }
+    return hasEntries ? result : undefined;
+}
+function extractBudget(spec) {
+    const raw = spec.budget;
+    if (!isObj(raw))
+        return undefined;
+    const maxCostMicros = toBigIntSafe(raw.max_cost_micros ?? raw.maxCostMicros);
+    const maxTotalTokens = toBigIntSafe(raw.max_total_tokens ?? raw.maxTotalTokens);
+    const maxDurationSeconds = toNumberSafe(raw.max_duration_seconds ?? raw.maxDurationSeconds);
+    const onExceededStr = raw.on_exceeded ?? raw.onExceeded;
+    const onExceeded = typeof onExceededStr === "string"
+        ? stringToBudgetPolicy(onExceededStr)
+        : undefined;
+    const hasValues = (maxCostMicros !== undefined && maxCostMicros > BigInt(0)) ||
+        (maxTotalTokens !== undefined && maxTotalTokens > BigInt(0)) ||
+        (maxDurationSeconds !== undefined && maxDurationSeconds > 0);
+    if (!hasValues)
+        return undefined;
+    return {
+        ...(maxCostMicros !== undefined && { maxCostMicros }),
+        ...(maxTotalTokens !== undefined && { maxTotalTokens }),
+        ...(maxDurationSeconds !== undefined && { maxDurationSeconds }),
+        ...(onExceeded !== undefined && { onExceeded }),
+    };
+}
+// ---------------------------------------------------------------------------
+// Enum ↔ string conversion
+// ---------------------------------------------------------------------------
+const TASK_KIND_STRINGS = new Map(Object.entries(WorkflowTaskKind)
+    .filter((entry) => typeof entry[1] === "number" &&
+    entry[1] !== WorkflowTaskKind.workflow_task_kind_unspecified)
+    .map(([name, value]) => [value, name]));
+const STRING_TO_TASK_KIND = new Map(Array.from(TASK_KIND_STRINGS.entries()).map(([value, name]) => [name, value]));
+function taskKindToString(kind) {
+    return TASK_KIND_STRINGS.get(kind) ?? `unknown_${kind}`;
+}
+function stringToTaskKind(str) {
+    return STRING_TO_TASK_KIND.get(str);
+}
+const BUDGET_POLICY_STRINGS = new Map([
+    [BudgetExceededPolicy.budget_exceeded_terminate, "budget_exceeded_terminate"],
+    [
+        BudgetExceededPolicy.budget_exceeded_human_review,
+        "budget_exceeded_human_review",
+    ],
+    [BudgetExceededPolicy.budget_exceeded_warn, "budget_exceeded_warn"],
+]);
+const STRING_TO_BUDGET_POLICY = new Map(Array.from(BUDGET_POLICY_STRINGS.entries()).map(([v, n]) => [n, v]));
+function budgetPolicyToString(policy) {
+    return BUDGET_POLICY_STRINGS.get(policy) ?? "budget_exceeded_policy_unspecified";
+}
+function stringToBudgetPolicy(str) {
+    return STRING_TO_BUDGET_POLICY.get(str);
+}
+// ---------------------------------------------------------------------------
+// Struct / primitive helpers
+// ---------------------------------------------------------------------------
+/**
+ * Converts a protobuf Struct (or JsonObject) to a plain JS object,
+ * handling BigInt → number conversion for YAML serialization.
+ */
+function structToPlain(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (typeof obj === "bigint")
+        return Number(obj);
+    if (typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj)) {
+        return obj.map(structToPlain);
+    }
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+        result[k] = structToPlain(v);
+    }
+    return result;
+}
+function isObj(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireString(obj, key, displayPath) {
+    const val = obj[key];
+    if (typeof val !== "string" || val.length === 0) {
+        throw new Error(`Workflow YAML is missing required field: ${displayPath}.`);
+    }
+    return val;
+}
+function optString(obj, key) {
+    const val = obj[key];
+    return typeof val === "string" && val.length > 0 ? val : undefined;
+}
+function optStringRecord(obj, key) {
+    const val = obj[key];
+    if (!isObj(val))
+        return undefined;
+    const result = {};
+    let hasEntries = false;
+    for (const [k, v] of Object.entries(val)) {
+        if (typeof v === "string") {
+            result[k] = v;
+            hasEntries = true;
+        }
+    }
+    return hasEntries ? result : undefined;
+}
+function toBigIntSafe(val) {
+    if (typeof val === "bigint")
+        return val;
+    if (typeof val === "number" && Number.isFinite(val))
+        return BigInt(Math.round(val));
+    if (typeof val === "string") {
+        try {
+            return BigInt(val);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function toNumberSafe(val) {
+    if (typeof val === "number" && Number.isFinite(val))
+        return val;
+    if (typeof val === "string") {
+        const n = Number(val);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=serialize-workflow-yaml.js.map

package/workflow/serialize-workflow-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-workflow-yaml.js","sourceRoot":"","sources":["../../src/workflow/serialize-workflow-yaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAQtE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wDAAwD,CAAC;AAWhH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAkB;IACtD,MAAM,GAAG,GAA4B;QACnC,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,uBAAuB;QAC1D,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,UAAU;QACjC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;QACjC,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC;KACvC,CAAC;IAEF,OAAO,aAAa,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,GAAW;IAEX,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAmC,CAAC;IACzD,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;IAEjD,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAEnD,OAAO;QACL,IAAI;QACJ,GAAG;QACH,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;QACnC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;QACjD,QAAQ;QACR,KAAK;QACL,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;QACjC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,SAAS,aAAa,CAAC,QAAkB;IACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,IAAI,CAAC,CAAC,GAAG;QAAE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IAC9B,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACtD,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CACxB,IAA8B;IAE9B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,IAAI,IAAI,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5D,IAAI,IAAI,CAAC,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,GAAqB;IAC1C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,IAAI,GAAG,CAAC,GAAG;QAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAClC,IAAI,GAAG,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IACpD,IAAI,GAAG,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACrC,IAAI,GAAG,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC9C,IAAI,GAAG,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAE1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,IAAkB;IACnC,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;KAClC,CAAC;IAEF,IAAI,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAClB,GAAsC;IAEtC,MAAM,MAAM,GAA4C,EAAE,CAAC;IAE3D,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1C,IAAI,IAAI,CAAC,WAAW;YAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3D,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,MAAsB;IACzC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAElD,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,CAAC,eAAe,GAAG,UAAU,CAAC;IACxD,IAAI,WAAW,GAAG,CAAC;QAAE,MAAM,CAAC,gBAAgB,GAAG,WAAW,CAAC;IAC3D,IAAI,MAAM,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,oBAAoB,GAAG,MAAM,CAAC,kBAAkB,CAAC;IAC1D,CAAC;IACD,IACE,MAAM,CAAC,UAAU,KAAK,oBAAoB,CAAC,kCAAkC,EAC7E,CAAC;QACD,MAAM,CAAC,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,MAAsB;IAC7C,OAAO,CACL,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC;QACjC,MAAM,CAAC,kBAAkB,GAAG,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,yBAAyB,CAAC,GAA4B;IAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,IAAI,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,IAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO;QACrC,SAAS,EAAE,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,yBAAyB,CAAC;QACrE,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,oBAAoB,CAAC;QACtD,OAAO,EAAE,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,uBAAuB,CAAC;QAC/D,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;YACxD,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;YAClC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,IAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAqB,EAAE;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,gCAAgC,GAAG,mCAAmC,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,oCAAoC,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,uBAAuB,OAAO,IAAI,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GACd,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,CAA2B,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,2CAA2C,CACxE,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAE7B,MAAM,MAAM,GAAsB;YAChC,IAAI;YACJ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,UAAwB;SACrC,CAAC;QAEF,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAI,WAAuC,CAAC,EAAE,CAAC;YAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAmC,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrB,MAAM,OAAO,GAAI,SAAqC,CAAC,IAAI,CAAC;YAC5D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrD,MAAsC,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACnE,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CACjB,IAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,MAAM,GAAsC,EAAE,CAAC;IACrD,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,SAAS;QAE1B,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC;QAC/C,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAE9B,MAAM,CAAC,GAAG,CAAC,GAAG;YACZ,GAAG,CAAC,OAAO,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;YAClD,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,EAAE,WAAW,EAAE,CAAC;YACvD,GAAG,CAAC,OAAO,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;SACnD,CAAC;QACF,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CACpB,IAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,aAAa,GACjB,YAAY,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,cAAc,GAClB,YAAY,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,kBAAkB,GAAG,YAAY,CACrC,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,kBAAkB,CACnD,CAAC;IACF,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU,CAAC;IACxD,MAAM,UAAU,GACd,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,oBAAoB,CAAC,aAAa,CAAC;QACrC,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,SAAS,GACb,CAAC,aAAa,KAAK,SAAS,IAAI,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,cAAc,KAAK,SAAS,IAAI,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;IAE/D,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,OAAO;QACL,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,CAAC;QACrD,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,CAAC;QACvD,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAC/D,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,iBAAiB,GAA0C,IAAI,GAAG,CACtE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;KAC7B,MAAM,CACL,CAAC,KAAK,EAAuC,EAAE,CAC7C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;IAC5B,KAAK,CAAC,CAAC,CAAC,KAAK,gBAAgB,CAAC,8BAA8B,CAC/D;KACA,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CACzC,CAAC;AAEF,MAAM,mBAAmB,GAA0C,IAAI,GAAG,CACxE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAC9E,CAAC;AAEF,SAAS,gBAAgB,CAAC,IAAsB;IAC9C,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,qBAAqB,GACzB,IAAI,GAAG,CAAC;IACN,CAAC,oBAAoB,CAAC,yBAAyB,EAAE,2BAA2B,CAAC;IAC7E;QACE,oBAAoB,CAAC,4BAA4B;QACjD,8BAA8B;KAC/B;IACD,CAAC,oBAAoB,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;CACpE,CAAC,CAAC;AAEL,MAAM,uBAAuB,GAC3B,IAAI,GAAG,CACL,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACpE,CAAC;AAEJ,SAAS,oBAAoB,CAAC,MAA4B;IACxD,OAAO,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,oCAAoC,CAAC;AACnF,CAAC;AAED,SAAS,oBAAoB,CAC3B,GAAW;IAEX,OAAO,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAExC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CACpB,GAA4B,EAC5B,GAAW,EACX,WAAmB;IAEnB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,4CAA4C,WAAW,GAAG,CAC3D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAChB,GAA4B,EAC5B,GAAW;IAEX,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CACtB,GAA4B,EAC5B,GAAW;IAEX,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACd,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/workflow/starter-workflow-yaml.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Minimal valid workflow YAML used as the starting point when creating
+ * a new workflow from the visual editor or code editor.
+ *
+ * Uses the full envelope format (`apiVersion` / `kind` / `metadata` / `spec`)
+ * so `yamlToGraph()` can parse it in visual mode without errors.
+ *
+ * Includes a single `agent_call` task so the user sees a meaningful
+ * canvas node immediately rather than an empty graph.
+ */
+export declare const STARTER_WORKFLOW_YAML = "apiVersion: agentic.stigmer.ai/v1\nkind: Workflow\nmetadata:\n  name: my-workflow\nspec:\n  description: A new workflow\n  document:\n    dsl: \"1.0.0\"\n    namespace: default\n    name: my-workflow\n    version: \"0.1.0\"\n  tasks:\n    - name: step_1\n      kind: agent_call\n      task_config:\n        agent_ref: \"org/agent-slug\"\n      flow:\n        then: end\n";
+//# sourceMappingURL=starter-workflow-yaml.d.ts.map

package/workflow/starter-workflow-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-workflow-yaml.d.ts","sourceRoot":"","sources":["../../src/workflow/starter-workflow-yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,uXAkBjC,CAAC"}

package/workflow/starter-workflow-yaml.js

@@ -0,0 +1,30 @@
+/**
+ * Minimal valid workflow YAML used as the starting point when creating
+ * a new workflow from the visual editor or code editor.
+ *
+ * Uses the full envelope format (`apiVersion` / `kind` / `metadata` / `spec`)
+ * so `yamlToGraph()` can parse it in visual mode without errors.
+ *
+ * Includes a single `agent_call` task so the user sees a meaningful
+ * canvas node immediately rather than an empty graph.
+ */
+export const STARTER_WORKFLOW_YAML = `apiVersion: agentic.stigmer.ai/v1
+kind: Workflow
+metadata:
+  name: my-workflow
+spec:
+  description: A new workflow
+  document:
+    dsl: "1.0.0"
+    namespace: default
+    name: my-workflow
+    version: "0.1.0"
+  tasks:
+    - name: step_1
+      kind: agent_call
+      task_config:
+        agent_ref: "org/agent-slug"
+      flow:
+        then: end
+`;
+//# sourceMappingURL=starter-workflow-yaml.js.map

package/workflow/starter-workflow-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-workflow-yaml.js","sourceRoot":"","sources":["../../src/workflow/starter-workflow-yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;CAkBpC,CAAC"}