@uipath/flow-tool 1.204.0-preview.254 → 1.205.0-preview.256

package/dist/{flow-eval-service-kbbq3wwq.js → flow-eval-service-9j46ta9k.js}

@@ -1,49 +1,56 @@
 import {
-  FlowEvalPathResolver,
-  findEvalSet,
-  findEvaluator,
-  getLinkedEvaluators,
-  removeEvaluatorRefFromSet
-} from "./packager-tool-1ca047de.js";
+  FlowEvalPathResolver
+} from "./packager-tool-sqpesv2e.js";
 import {
   FlowAgentNodeSchemaReader,
   findFlowNode,
-  formatTriggerIdsHint,
   isDocumentEvalNode,
   isNodeEvalTarget,
-  listTriggerNodeIds,
   readNodeTargetId
-} from "./packager-tool-m6abv2vy.js";
+} from "./packager-tool-fjqpf1y6.js";
+import {
+  formatTriggerIdsHint,
+  listTriggerNodeIds
+} from "./packager-tool-z0yxfhdj.js";
+import"./packager-tool-10vc8pq4.js";
+import"./packager-tool-4kr6g0zw.js";
+import"./packager-tool-cqtsj6yh.js";
 import {
-  FlowEvalFileStore
-} from "./packager-tool-pz5nqg0s.js";
+  findMatchingDefinition
+} from "./packager-tool-hxyjn885.js";
 import {
-  buildDefaultCriteria,
-  buildEvaluatorConfig,
+  EvalFileStore,
+  EvalFiles,
+  EvaluationCrud,
+  EvaluatorCrud,
   evaluatorTypeAliases,
-  findMatchingDefinition,
+  findEvalSet,
   isRecord,
   resolveEvalApiConfig,
-  resolveEvaluatorType,
   slugify
-} from "./packager-tool-t3ysatjd.js";
-import"./packager-tool-w5a1hhyj.js";
-import"./packager-tool-4fhedj18.js";
-import"./packager-tool-m8xtf5ej.js";
-import"./packager-tool-0d375dbz.js";
-import"./packager-tool-h9tzz0qd.js";
-import"./packager-tool-hhy1gr2k.js";
-import"./packager-tool-stq8800d.js";
+} from "./packager-tool-xk78j7dz.js";
+import"./packager-tool-kmv2p8z4.js";
+import"./packager-tool-8g5931fz.js";
+import {
+  createFlowRefResolver,
+  resolveWorkflowRefs
+} from "./packager-tool-thnkpqwc.js";
+import"./packager-tool-961vsbsc.js";
+import"./packager-tool-jgfzfqjm.js";
+import"./packager-tool-qcqb9hf8.js";
+import"./packager-tool-wze74wyk.js";
+import"./packager-tool-pacrqxv2.js";
 import"./packager-tool-nkrmjr3a.js";
-import"./packager-tool-tyg399d6.js";
 import"./packager-tool-rs6jm14d.js";
 import"./packager-tool-hk1gxnth.js";
-import"./packager-tool-7q6z6npd.js";
+import"./packager-tool-mgcz986r.js";
+import"./packager-tool-xj0agqpk.js";
+import"./packager-tool-pcvhcn2k.js";
 import"./packager-tool-sc961w0q.js";
 import"./packager-tool-eq46jxm5.js";
 import"./packager-tool-868re2t3.js";
 import"./packager-tool-gbgfwx8f.js";
-import"./packager-tool-d88rqwk8.js";
+import"./packager-tool-6z1hsm2h.js";
 import"./packager-tool-jysvpt8p.js";
 import"./packager-tool-bhqx9kez.js";
 import"./packager-tool-p79yh9ww.js";
@@ -51,12 +58,13 @@ import"./packager-tool-pxqras8k.js";
 import"./packager-tool-z83pga0z.js";
 import"./packager-tool-6ejqwbw9.js";
 import"./packager-tool-mcaf4ewf.js";
+import"./packager-tool-apawc11t.js";
 import {
   catchError
-} from "./packager-tool-02f63a08.js";
+} from "./packager-tool-t7ahhaer.js";
 import {
   getFileSystem
-} from "./packager-tool-3h2ktz6q.js";
+} from "./packager-tool-myhbp761.js";
 import"./packager-tool-4mna26cc.js";
 import"./packager-tool-c23zrhj8.js";
 import {
@@ -72,7 +80,7 @@ class FlowEvalOutputSchema {
     this.pathResolver = pathResolver;
   }
   async read(projectPath) {
-    const root = await this.pathResolver.resolveFlowProjectPath(projectPath);
+    const root = await this.pathResolver.resolveProjectPath(projectPath);
     const [flowError, flowFilePath] = await catchError(this.pathResolver.findFlowFile(root));
     if (flowError || !flowFilePath) {
       return { flowFound: false, outputs: new Map };
@@ -118,40 +126,135 @@ class FlowNodeOutputSchemaReader {
     this.pathResolver = pathResolver;
   }
   async read(projectPath, componentId) {
-    const root = await this.pathResolver.resolveFlowProjectPath(projectPath);
+    const root = await this.pathResolver.resolveProjectPath(projectPath);
     const [flowError, flowFilePath] = await catchError(this.pathResolver.findFlowFile(root));
     if (flowError || !flowFilePath) {
       return { schema: undefined, nodeFound: false };
     }
-    const flowContent = String(await this.fs.readFile(flowFilePath, "utf-8"));
-    return this.extract(flowContent, componentId);
+    const flow = await readResolvedFlow(this.fs, flowFilePath);
+    return this.extract(flow, componentId);
+  }
+  extract(flow, componentId) {
+    return extractNodeOutputSchema(flow, componentId, false);
+  }
+}
+async function readResolvedFlow(fs, flowFilePath) {
+  let parsed;
+  try {
+    parsed = JSON.parse(String(await fs.readFile(flowFilePath, "utf-8")));
+  } catch (error) {
+    throw new Error(`Could not parse ${flowFilePath}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  if (!isRecord(parsed)) {
+    throw new Error(`Could not parse ${flowFilePath}: not a JSON object.`);
+  }
+  const missing = [];
+  const resolver = createFlowRefResolver(fs, {
+    warn: (message) => missing.push(message)
+  });
+  const [refError, result] = await catchError(resolveWorkflowRefs(parsed, resolver, flowFilePath));
+  if (refError || missing.length > 0 || !result || !isRecord(result.resolved)) {
+    const reason = refError ? refError.message : missing.length > 0 ? missing.join("; ") : "the resolved flow is not a JSON object";
+    throw new Error(`Could not resolve the $ref chunks of ${flowFilePath}: ${reason}`);
+  }
+  return result.resolved;
+}
+
+class FlowComponentLocator {
+  fs;
+  pathResolver;
+  constructor(fs, pathResolver) {
+    this.fs = fs;
+    this.pathResolver = pathResolver;
+  }
+  async find(projectPath, componentId) {
+    const none = { flowRead: false, found: false, suggestions: [] };
+    const root = await this.pathResolver.resolveProjectPath(projectPath);
+    const [flowError, flowFilePath] = await catchError(this.pathResolver.findFlowFile(root));
+    if (flowError || !flowFilePath)
+      return none;
+    const flow = await readResolvedFlow(this.fs, flowFilePath);
+    const scopes = scopesOfNode(flow, componentId);
+    if (scopes.length > 1) {
+      throw new Error(`Component "${componentId}" names a node in more than one scope of ${flowFilePath} (${scopes.join(", ")}). Node ids must be unique across the flow, top level and subflows.`);
+    }
+    if (scopes.length === 1) {
+      return { flowRead: true, found: true, suggestions: [] };
+    }
+    const nodes = allNodes(flow);
+    return {
+      flowRead: true,
+      found: false,
+      suggestions: suggestComponentIds(nodes, componentId)
+    };
   }
-  extract(flowContent, componentId) {
-    return extractNodeOutputSchema(flowContent, componentId, false);
+}
+function scopesOfNode(flow, componentId) {
+  const scopes = [];
+  const scan = (list, scope) => {
+    if (!Array.isArray(list))
+      return;
+    for (const n of list) {
+      if (isRecord(n) && n.id === componentId)
+        scopes.push(scope);
+    }
+  };
+  scan(flow.nodes, "nodes");
+  if (isRecord(flow.subflows)) {
+    for (const [key, sub] of Object.entries(flow.subflows)) {
+      if (isRecord(sub))
+        scan(sub.nodes, `subflows.${key}.nodes`);
+    }
   }
+  return scopes;
+}
+function allNodes(flow) {
+  const out = [];
+  const push = (list) => {
+    if (!Array.isArray(list))
+      return;
+    for (const n of list)
+      if (isRecord(n))
+        out.push(n);
+  };
+  push(flow.nodes);
+  if (isRecord(flow.subflows)) {
+    for (const sub of Object.values(flow.subflows)) {
+      if (isRecord(sub))
+        push(sub.nodes);
+    }
+  }
+  return out;
+}
+function squash(id) {
+  return id.replace(/[^A-Za-z0-9]/g, "").toLowerCase();
+}
+function suggestComponentIds(nodes, componentId) {
+  const want = squash(componentId);
+  const hits = [];
+  for (const n of nodes) {
+    if (typeof n.id !== "string")
+      continue;
+    const display = isRecord(n.display) ? n.display : undefined;
+    const label = typeof display?.label === "string" ? display.label : "";
+    if (label === componentId || want !== "" && (squash(n.id) === want || squash(label) === want)) {
+      hits.push(n.id);
+    }
+  }
+  return [...new Set(hits)];
 }
 
 class SimulateFlowOutputSchemaReader extends FlowNodeOutputSchemaReader {
-  extract(flowContent, componentId) {
-    const result = extractNodeOutputSchema(flowContent, componentId, true);
+  extract(flow, componentId) {
+    const result = extractNodeOutputSchema(flow, componentId, true);
     if (!result.nodeFound || result.schema === undefined) {
       return result;
     }
     return { ...result, schema: cleanOutputSchema(result.schema) };
   }
 }
-function extractNodeOutputSchema(flowContent, componentId, wrapAllOutputs) {
-  let parsed;
-  try {
-    parsed = JSON.parse(flowContent);
-  } catch {
-    return { schema: undefined, nodeFound: false };
-  }
-  if (!isRecord(parsed)) {
-    return { schema: undefined, nodeFound: false };
-  }
-  const nodes = Array.isArray(parsed.nodes) ? parsed.nodes : [];
-  const node = nodes.find((n) => isRecord(n) && n.id === componentId);
+function extractNodeOutputSchema(flow, componentId, wrapAllOutputs) {
+  const node = allNodes(flow).find((n) => n.id === componentId);
   if (!node) {
     return { schema: undefined, nodeFound: false };
   }
@@ -284,7 +387,7 @@ class ChildSimulationSchemaReader {
     this.pathResolver = pathResolver;
   }
   async read(projectPath, parentComponentId, childComponentId) {
-    const root = await this.pathResolver.resolveFlowProjectPath(projectPath);
+    const root = await this.pathResolver.resolveProjectPath(projectPath);
     const [flowError, flowFilePath] = await catchError(this.pathResolver.findFlowFile(root));
     if (flowError || !flowFilePath) {
       return {
@@ -381,7 +484,7 @@ class ChildSimulationSchemaReader {
         errorDetail: authError.message
       };
     }
-    const { FlowEvalRunApi } = await import("./flow-eval-run-api-byx3cacw.js");
+    const { FlowEvalRunApi } = await import("./flow-eval-run-api-xdygjzfv.js");
     const api = new FlowEvalRunApi;
     const [fetchError, components] = await catchError(api.getSimulatableComponents(config, processKey, processVersion));
     if (fetchError || !components) {
@@ -615,119 +718,6 @@ function findToolSchemaInResources(resources, childComponentId) {
   }
   return;
 }
-
-// src/services/flow-eval-files.ts
-import { randomUUID } from "node:crypto";
-var EVAL_FILES_DIR = "eval-files";
-var TOKEN_LENGTH = 12;
-var EVALUATION_BINARY_PREFIX = "BINARY_FILE:";
-var EVALUATION_BINARY_DELIMITER = `
----BASE64---
-`;
-var TEXT_EXTENSIONS = new Set([
-  ".json",
-  ".csv",
-  ".tsv",
-  ".txt",
-  ".md",
-  ".log",
-  ".xml",
-  ".html",
-  ".htm",
-  ".yaml",
-  ".yml"
-]);
-var MIME_BY_EXT = {
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".png": "image/png",
-  ".gif": "image/gif",
-  ".bmp": "image/bmp",
-  ".webp": "image/webp",
-  ".tif": "image/tiff",
-  ".tiff": "image/tiff",
-  ".svg": "image/svg+xml",
-  ".pdf": "application/pdf",
-  ".doc": "application/msword",
-  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-  ".xls": "application/vnd.ms-excel",
-  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-  ".ppt": "application/vnd.ms-powerpoint",
-  ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-  ".csv": "text/csv",
-  ".tsv": "text/tab-separated-values",
-  ".json": "application/json",
-  ".txt": "text/plain",
-  ".md": "text/markdown",
-  ".log": "text/plain",
-  ".xml": "application/xml",
-  ".html": "text/html",
-  ".htm": "text/html",
-  ".yaml": "application/yaml",
-  ".yml": "application/yaml"
-};
-
-class FlowEvalFiles {
-  fs;
-  pathResolver;
-  constructor(fs, pathResolver) {
-    this.fs = fs;
-    this.pathResolver = pathResolver;
-  }
-  async materialize(projectPath, sourcePath) {
-    const projectRoot = await this.pathResolver.resolveFlowProjectPath(projectPath);
-    const sourceAbsolute = this.fs.path.resolve(sourcePath);
-    if (!await this.fs.exists(sourceAbsolute)) {
-      throw new Error(`Input file not found: ${sourcePath}`);
-    }
-    const content = await this.fs.readFile(sourceAbsolute);
-    if (content === null) {
-      throw new Error(`Could not read input file: ${sourcePath}`);
-    }
-    const fullName = this.fs.path.basename(sourceAbsolute);
-    const evalRoot = await this.pathResolver.resolveEvalRoot(projectPath, true);
-    const dir = this.fs.path.join(evalRoot, EVAL_FILES_DIR);
-    await this.fs.mkdir(dir);
-    const targetName = await this.resolveTargetName(dir, fullName);
-    const targetPath = this.fs.path.join(dir, targetName);
-    const mimeType = mimeFromExt(extOf(fullName));
-    if (TEXT_EXTENSIONS.has(extOf(fullName))) {
-      await this.fs.writeFile(targetPath, content);
-    } else {
-      await this.fs.writeFile(targetPath, encodeBinaryEnvelope(content, mimeType));
-    }
-    const relative = this.fs.path.relative(projectRoot, targetPath).replaceAll("\\", "/");
-    return {
-      ID: `/${relative}`,
-      FullName: fullName,
-      MimeType: mimeType
-    };
-  }
-  async resolveTargetName(dir, fullName) {
-    if (!await this.fs.exists(this.fs.path.join(dir, fullName))) {
-      return fullName;
-    }
-    const ext = extOf(fullName);
-    const stem = ext ? fullName.slice(0, -ext.length) : fullName;
-    const token = randomUUID().replaceAll("-", "").slice(0, TOKEN_LENGTH);
-    return `${stem}_${token}${ext}`;
-  }
-}
-function encodeBinaryEnvelope(content, mimeType) {
-  const base64Content = Buffer.from(content).toString("base64");
-  return `${EVALUATION_BINARY_PREFIX}${mimeType}:${content.byteLength}${EVALUATION_BINARY_DELIMITER}${base64Content}`;
-}
-function extOf(name) {
-  const dot = name.lastIndexOf(".");
-  if (dot <= 0) {
-    return "";
-  }
-  return name.slice(dot).toLowerCase();
-}
-function mimeFromExt(ext) {
-  return MIME_BY_EXT[ext] ?? "application/octet-stream";
-}
-
 // src/services/flow-eval-input-schema.ts
 class FlowEvalInputSchema {
   fs;
@@ -737,7 +727,7 @@ class FlowEvalInputSchema {
     this.pathResolver = pathResolver;
   }
   async read(projectPath) {
-    const root = await this.pathResolver.resolveFlowProjectPath(projectPath);
+    const root = await this.pathResolver.resolveProjectPath(projectPath);
     const [flowError, flowFilePath] = await catchError(this.pathResolver.findFlowFile(root));
     if (flowError || !flowFilePath) {
       return {
@@ -821,7 +811,7 @@ class FlowEvalSetCrud {
     return this.store.readJsonFiles(this.fs.path.join(root, "eval-sets"));
   }
   async add(projectPath, options) {
-    const resolvedProjectPath = await this.pathResolver.resolveFlowProjectPath(projectPath);
+    const resolvedProjectPath = await this.pathResolver.resolveProjectPath(projectPath);
     const root = await this.pathResolver.resolveEvalRoot(projectPath, true);
     const id = crypto.randomUUID();
     const fileName = `evaluation-set-${slugify(options.name)}-${id.slice(0, 8)}.json`;
@@ -901,251 +891,6 @@ class FlowEvalSetCrud {
     return true;
   }
 }
-
-// src/services/flow-evaluation-crud.ts
-class FlowEvaluationCrud {
-  fs;
-  store;
-  pathResolver;
-  constructor(fs, store, pathResolver) {
-    this.fs = fs;
-    this.store = store;
-    this.pathResolver = pathResolver;
-  }
-  async add(projectPath, setIdOrName, options) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, true);
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const evaluators = getLinkedEvaluators(await this.listEvaluators(root), evalSet);
-    const now = new Date().toISOString();
-    const evaluation = {
-      id: crypto.randomUUID(),
-      name: options.name,
-      inputs: options.inputs,
-      expectedOutput: options.expectedOutput,
-      evaluationCriterias: options.criteria ?? buildDefaultCriteria(evaluators, options.expectedOutput, options.searchText),
-      createdAt: now,
-      updatedAt: now
-    };
-    evalSet.evaluations.push(evaluation);
-    evalSet.updatedAt = now;
-    await this.writeEvalSet(root, evalSet);
-    return evaluation;
-  }
-  async list(projectPath, setIdOrName) {
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    return evalSet.evaluations;
-  }
-  async addSimulation(projectPath, setIdOrName, evaluationIdOrName, simulation) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, true);
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const evaluation = evalSet.evaluations.find((e) => e.id === evaluationIdOrName || e.name === evaluationIdOrName);
-    if (!evaluation) {
-      throw new Error(`Data point "${evaluationIdOrName}" not found`);
-    }
-    if (!evaluation.simulations) {
-      evaluation.simulations = [];
-    }
-    const existing = evaluation.simulations.findIndex((s) => s.componentId === simulation.componentId);
-    const now = new Date().toISOString();
-    if (existing !== -1) {
-      evaluation.simulations[existing] = simulation;
-    } else {
-      evaluation.simulations.push(simulation);
-    }
-    evaluation.updatedAt = now;
-    evalSet.updatedAt = now;
-    await this.writeEvalSet(root, evalSet);
-    return simulation;
-  }
-  async listSimulations(projectPath, setIdOrName, evaluationIdOrName) {
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const evaluation = evalSet.evaluations.find((e) => e.id === evaluationIdOrName || e.name === evaluationIdOrName);
-    if (!evaluation) {
-      throw new Error(`Data point "${evaluationIdOrName}" not found`);
-    }
-    return evaluation.simulations ?? [];
-  }
-  async addChildSimulation(projectPath, setIdOrName, evaluationIdOrName, parentComponentId, childSimulation) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, true);
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const evaluation = evalSet.evaluations.find((e) => e.id === evaluationIdOrName || e.name === evaluationIdOrName);
-    if (!evaluation) {
-      throw new Error(`Data point "${evaluationIdOrName}" not found`);
-    }
-    if (!evaluation.simulations) {
-      evaluation.simulations = [];
-    }
-    let parent = evaluation.simulations.find((s) => s.componentId === parentComponentId);
-    if (!parent) {
-      parent = {
-        componentId: parentComponentId,
-        componentType: "agent",
-        simulationStrategy: "Llm",
-        childSimulations: []
-      };
-      evaluation.simulations.push(parent);
-    }
-    if (!parent.childSimulations) {
-      parent.childSimulations = [];
-    }
-    const existing = parent.childSimulations.findIndex((s) => s.componentId === childSimulation.componentId);
-    const now = new Date().toISOString();
-    if (existing !== -1) {
-      parent.childSimulations[existing] = childSimulation;
-    } else {
-      parent.childSimulations.push(childSimulation);
-    }
-    evaluation.updatedAt = now;
-    evalSet.updatedAt = now;
-    await this.writeEvalSet(root, evalSet);
-    return childSimulation;
-  }
-  listChildSimulations(evaluation, parentComponentId) {
-    const parent = (evaluation.simulations ?? []).find((s) => s.componentId === parentComponentId);
-    if (!parent) {
-      throw new Error(`Simulation for component "${parentComponentId}" not found`);
-    }
-    return parent.childSimulations ?? [];
-  }
-  async removeChildSimulation(projectPath, setIdOrName, evaluationIdOrName, parentComponentId, childComponentId) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, false);
-    if (!root) {
-      return false;
-    }
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const evaluation = evalSet.evaluations.find((e) => e.id === evaluationIdOrName || e.name === evaluationIdOrName);
-    if (!evaluation) {
-      throw new Error(`Data point "${evaluationIdOrName}" not found`);
-    }
-    const parent = (evaluation.simulations ?? []).find((s) => s.componentId === parentComponentId);
-    if (!parent) {
-      throw new Error(`Simulation for component "${parentComponentId}" not found`);
-    }
-    const index = (parent.childSimulations ?? []).findIndex((s) => s.componentId === childComponentId);
-    if (index === -1) {
-      return false;
-    }
-    parent.childSimulations?.splice(index, 1);
-    evalSet.updatedAt = new Date().toISOString();
-    await this.writeEvalSet(root, evalSet);
-    return true;
-  }
-  async removeSimulation(projectPath, setIdOrName, evaluationIdOrName, componentId) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, false);
-    if (!root) {
-      return false;
-    }
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const evaluation = evalSet.evaluations.find((e) => e.id === evaluationIdOrName || e.name === evaluationIdOrName);
-    if (!evaluation) {
-      throw new Error(`Data point "${evaluationIdOrName}" not found`);
-    }
-    const index = (evaluation.simulations ?? []).findIndex((s) => s.componentId === componentId);
-    if (index === -1) {
-      return false;
-    }
-    evaluation.simulations?.splice(index, 1);
-    evalSet.updatedAt = new Date().toISOString();
-    await this.writeEvalSet(root, evalSet);
-    return true;
-  }
-  async remove(projectPath, setIdOrName, evaluationIdOrName) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, false);
-    if (!root) {
-      return false;
-    }
-    const evalSet = await this.requireEvalSet(projectPath, setIdOrName);
-    const index = evalSet.evaluations.findIndex((evaluation) => evaluation.id === evaluationIdOrName || evaluation.name === evaluationIdOrName);
-    if (index === -1) {
-      return false;
-    }
-    evalSet.evaluations.splice(index, 1);
-    evalSet.updatedAt = new Date().toISOString();
-    await this.writeEvalSet(root, evalSet);
-    return true;
-  }
-  async requireEvalSet(projectPath, idOrName) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, false);
-    const evalSet = root ? findEvalSet(await this.listEvalSets(root), idOrName) : null;
-    if (!evalSet) {
-      throw new Error(`Evaluation set "${idOrName}" not found`);
-    }
-    return evalSet;
-  }
-  async listEvalSets(root) {
-    return this.store.readJsonFiles(this.fs.path.join(root, "eval-sets"));
-  }
-  async listEvaluators(root) {
-    return this.store.readJsonFiles(this.fs.path.join(root, "evaluators"));
-  }
-  async writeEvalSet(root, evalSet) {
-    await this.store.writeJsonFile(this.fs.path.join(root, "eval-sets", evalSet.fileName ?? `${evalSet.id}.json`), evalSet);
-  }
-}
-
-// src/services/flow-evaluator-crud.ts
-class FlowEvaluatorCrud {
-  fs;
-  store;
-  pathResolver;
-  constructor(fs, store, pathResolver) {
-    this.fs = fs;
-    this.store = store;
-    this.pathResolver = pathResolver;
-  }
-  async list(projectPath) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, false);
-    if (!root) {
-      return [];
-    }
-    return this.store.readJsonFiles(this.fs.path.join(root, "evaluators"));
-  }
-  async add(projectPath, options) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, true);
-    const typeId = resolveEvaluatorType(options.type);
-    const id = `${slugify(options.name)}-${crypto.randomUUID().slice(0, 8)}`;
-    const now = new Date().toISOString();
-    const fileName = `${id}.json`;
-    const evaluator = {
-      version: "1.0",
-      id,
-      name: options.name,
-      description: options.description ?? `${options.name} evaluator`,
-      evaluatorTypeId: typeId,
-      evaluatorConfig: buildEvaluatorConfig(typeId, options),
-      fileName,
-      createdAt: now,
-      updatedAt: now
-    };
-    await this.store.writeJsonFile(this.fs.path.join(root, "evaluators", fileName), evaluator);
-    return evaluator;
-  }
-  async remove(projectPath, idOrName) {
-    const root = await this.pathResolver.resolveEvalRoot(projectPath, false);
-    if (!root) {
-      return false;
-    }
-    const evaluator = findEvaluator(await this.list(projectPath), idOrName);
-    if (!evaluator?.fileName) {
-      return false;
-    }
-    await this.store.remove(this.fs.path.join(root, "evaluators", evaluator.fileName));
-    await this.removeEvaluatorRefs(root, evaluator);
-    return true;
-  }
-  async removeEvaluatorRefs(root, evaluator) {
-    const sets = await this.store.readJsonFiles(this.fs.path.join(root, "eval-sets"));
-    for (const set of sets) {
-      if (removeEvaluatorRefFromSet(set, evaluator) && set.fileName) {
-        await this.writeEvalSet(root, set);
-      }
-    }
-  }
-  async writeEvalSet(root, evalSet) {
-    await this.store.writeJsonFile(this.fs.path.join(root, "eval-sets", evalSet.fileName ?? `${evalSet.id}.json`), evalSet);
-  }
-}
-
 // src/services/flow-eval-service.ts
 class FlowEvalService {
   fs;
@@ -1156,19 +901,21 @@ class FlowEvalService {
   inputSchema;
   outputSchema;
   nodeOutputSchema;
+  componentLocator;
   agentNodeSchema;
   childSimulationSchema;
   constructor(fs = getFileSystem()) {
     this.fs = fs;
-    const store = new FlowEvalFileStore(fs);
+    const store = new EvalFileStore(fs);
     const pathResolver = new FlowEvalPathResolver(fs);
-    this.evaluators = new FlowEvaluatorCrud(fs, store, pathResolver);
+    this.evaluators = new EvaluatorCrud(fs, store, pathResolver);
     this.evalSets = new FlowEvalSetCrud(fs, store, pathResolver);
-    this.evaluations = new FlowEvaluationCrud(fs, store, pathResolver);
-    this.files = new FlowEvalFiles(fs, pathResolver);
+    this.evaluations = new EvaluationCrud(fs, store, pathResolver);
+    this.files = new EvalFiles(fs, pathResolver);
     this.inputSchema = new FlowEvalInputSchema(fs, pathResolver);
     this.outputSchema = new FlowEvalOutputSchema(fs, pathResolver);
     this.nodeOutputSchema = new SimulateFlowOutputSchemaReader(fs, pathResolver);
+    this.componentLocator = new FlowComponentLocator(fs, pathResolver);
     this.agentNodeSchema = new FlowAgentNodeSchemaReader(fs, pathResolver);
     this.childSimulationSchema = new ChildSimulationSchemaReader(fs, pathResolver);
   }
@@ -1294,6 +1041,11 @@ class FlowEvalService {
     return this.evaluations.remove(projectPath, setIdOrName, evaluationIdOrName);
   }
   async addSimulation(projectPath, setIdOrName, evaluationIdOrName, simulation) {
+    const located = await this.componentLocator.find(projectPath, simulation.componentId);
+    if (located.flowRead && !located.found) {
+      const hint = located.suggestions.length ? ` Did you mean ${located.suggestions.map((id) => `"${id}"`).join(" or ")}? A simulation targets the node's id, not its label.` : " Use a node id from the .flow (nodes[].id or subflows.<id>.nodes[].id).";
+      throw new Error(`Component "${simulation.componentId}" not found in the flow.${hint}`);
+    }
     if (simulation.simulationStrategy === "Llm" && simulation.outputSchema === undefined) {
       const resolved = await this.nodeOutputSchema.read(projectPath, simulation.componentId);
       if (!resolved.nodeFound) {
@@ -1380,4 +1132,4 @@ export {
   FlowEvalService
 };
 
-//# debugId=17D9E936942A681864756E2164756E21
+//# debugId=0488B8F22516EBE964756E2164756E21