@uipath/flow-tool 1.205.0-preview.276 → 1.206.0-preview.279

package/dist/{packager-tool-p8gab24q.js → packager-tool-8qypzm9v.js}

@@ -1,75 +1,49 @@
 import {
-  resolveMaestroRegistry
-} from "./packager-tool-dxgrhfq5.js";
+  getFileSystem
+} from "./packager-tool-vgrswa8p.js";
 import {
-  Option,
-  OutputFormatter,
+  catchError2
+} from "./packager-tool-pxq0bwp0.js";
+import {
+  carriedErrorCode,
   RESULTS,
-  addDeprecatedOptionAlias,
+  Option,
   getOutputSink,
   pascalCaseDataKeys,
-  processContext
-} from "./packager-tool-apawc11t.js";
+  OutputFormatter,
+  tokenizeTail,
+  processContext,
+  namedOrLegacy,
+  legacySecondArg,
+  usageError,
+  addDeprecatedOptionAlias
+} from "./packager-tool-8ed52y5r.js";
 import {
-  getFileSystem
-} from "./packager-tool-myhbp761.js";
-
-// ../builder-sdk/src/argv.ts
-function addValue(argv, flag, value) {
-  if (typeof value === "string") {
-    argv.push(flag, value);
-  }
-}
+  resolveMaestroRegistry
+} from "./packager-tool-64r7e4ek.js";
 
-// ../builder-sdk/src/delegate.ts
+// ../builder-sdk/src/node-runner.ts
 import { spawn as spawn2 } from "node:child_process";
 import { createRequire } from "node:module";
 import { StringDecoder } from "node:string_decoder";
 
-// ../builder-sdk/src/npm-global-root.ts
-import { spawn } from "node:child_process";
-var NPM_ROOT_TIMEOUT_MS = 5000;
-var npmRootLookup;
-function npmGlobalRoot() {
-  const prefix = npmConfigPrefix(process.env);
-  if (prefix.trim() !== "") {
-    return Promise.resolve(process.platform === "win32" ? getFileSystem().path.join(prefix, "node_modules") : getFileSystem().path.join(prefix, "lib", "node_modules"));
-  }
-  npmRootLookup ??= runNpmRootGlobal();
-  return npmRootLookup;
+// ../builder-sdk/src/runner.ts
+var RUNNER_KEY = Symbol.for("@uipath/builder-sdk/flow-sdk-runner");
+var RUNNER_OPTIONS_KEY = Symbol.for("@uipath/builder-sdk/flow-sdk-runner-options");
+var IN_PROCESS_UIP_KEY = Symbol.for("@uipath/builder-sdk/in-process-uip");
+function inProcessUip() {
+  return globalThis[IN_PROCESS_UIP_KEY];
 }
-function runNpmRootGlobal() {
-  return new Promise((resolve) => {
-    const stdio = ["ignore", "pipe", "ignore"];
-    const onWindows = { shell: true, stdio, windowsHide: true };
-    const proc = process.platform === "win32" ? spawn("npm root -g", [], onWindows) : spawn("npm", ["root", "-g"], { stdio });
-    let stdout = "";
-    proc.stdout?.on("data", (d) => {
-      stdout += d.toString();
-    });
-    const timer = setTimeout(() => {
-      proc.kill("SIGTERM");
-      resolve(null);
-    }, NPM_ROOT_TIMEOUT_MS);
-    proc.on("error", () => {
-      clearTimeout(timer);
-      resolve(null);
-    });
-    proc.on("close", (code) => {
-      clearTimeout(timer);
-      const root = stdout.trim();
-      resolve(code === 0 && root && !root.includes("***") ? root : null);
-    });
-  });
+function registerFlowSdkRunner(runner, options = {}) {
+  const slot = globalThis;
+  slot[RUNNER_KEY] = runner;
+  slot[RUNNER_OPTIONS_KEY] = options;
 }
-function npmConfigPrefix(env) {
-  let prefix = "";
-  for (const [key, value] of Object.entries(env)) {
-    if (key.toLowerCase() === "npm_config_prefix" && value !== undefined) {
-      prefix = value;
-    }
-  }
-  return prefix;
+function flowSdkRunner() {
+  return globalThis[RUNNER_KEY];
+}
+function flowSdkRunnerOptions() {
+  return globalThis[RUNNER_OPTIONS_KEY] ?? {};
 }
 
 // ../builder-sdk/src/delegate.ts
@@ -79,6 +53,7 @@ var FLOW_SDK_PACKAGE = {
 };
 var BPMN_CONNECTOR_OPTIONS_VERSION = "6.15.0";
 var FLOW_MERGE_STRICT_VERSION = "6.20.0";
+var FLOW_DECOMPILE_SCRIPTS_VERSION = "6.57.0";
 var CASE_CONNECTOR_OPTIONS_VERSION = "6.18.1";
 function commandLabel(family, verb) {
   return `uip maestro ${family} ${verb}`;
@@ -106,6 +81,10 @@ function versionMeetsFloor(version, floor) {
   }
   return !installed[3] || minimum[3];
 }
+function belowFloorMessage(label, version) {
+  const { name, minimumVersion } = FLOW_SDK_PACKAGE;
+  return `${label}: found ${name} ${version || "with no valid version"}; need >= ${minimumVersion}.`;
+}
 var FLOW_SDK_INVOKED_AS = "uip maestro";
 function resultCode(family, verb) {
   return [family, verb].map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
@@ -138,7 +117,250 @@ function failureReason(out, err) {
 `).filter((line) => line.trim() !== "");
   return lines.at(-1)?.trim() ?? out.trim();
 }
-function spawnSdk(cliPath, args, cwd) {
+function outcomeResult(outcome, label, found) {
+  if (outcome.kind === "spawn-error") {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: RESULTS.Failure,
+      message: `${label}: ${outcome.message}`,
+      instructions: outcome.instructions ?? (found === "host" ? `This host could not start ${FLOW_SDK_PACKAGE.name}. Report it to the host; retrying will fail the same way.` : "Check that node is on PATH, then retry.")
+    };
+  }
+  const { exitCode, signal, out, err } = outcome;
+  if (exitCode === 0) {
+    return { ok: true, data: stdoutAsData(out) };
+  }
+  if (exitCode !== null) {
+    const detail = failureReason(out, err) || `SDK exited with code ${exitCode}`;
+    return {
+      ok: false,
+      exitCode,
+      result: RESULTS.Failure,
+      message: `${label}: ${detail}`,
+      instructions: err ? "Fix what the builder SDK reported (on stderr, and in Message), then retry." : "Fix what the builder SDK reported (see Message), then retry.",
+      ...out.trim() ? { data: stdoutAsData(out) } : {}
+    };
+  }
+  return {
+    ok: false,
+    exitCode: 1,
+    result: RESULTS.Failure,
+    message: `${label}: SDK process ended with signal ${signal ?? "unknown"}.`,
+    instructions: "Retry the command."
+  };
+}
+function upgradeInstructions(found) {
+  if (found === "host") {
+    return `This host ships its own ${FLOW_SDK_PACKAGE.name}; it has to be updated there.`;
+  }
+  return found === "workspace" ? `npm install --save-dev ${FLOW_SDK_PACKAGE.name}@latest` : `npm install -g ${FLOW_SDK_PACKAGE.name}@latest`;
+}
+var LIBRARY_VERBS = new Set([
+  "flow compile",
+  "flow check",
+  "registry search",
+  "registry describe",
+  "registry pull"
+]);
+function pullAnswer(sha256, libraryJson) {
+  const sink = getOutputSink();
+  sink.writeErr(`registry pull: connector library ${sha256.slice(0, 12)}… is ready.
+`);
+  sink.writeErr(`registry pull: write connector steps as connector('<key>', '<action>', …); typed ./connectors/<key>.ts modules do not exist here.
+`);
+  return { ok: true, data: { sha256, library: libraryJson } };
+}
+async function runFlowSdk2({
+  family,
+  commandVerb,
+  sdkVerb = commandVerb,
+  argv,
+  passthrough = [],
+  cwd,
+  requiresSdkVersion
+}) {
+  const workspace = cwd ?? getFileSystem().env.cwd();
+  const label = commandLabel(family, commandVerb);
+  const runner = flowSdkRunner();
+  if (!runner) {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: RESULTS.ConfigError,
+      message: `${label}: this host has no way to run ${FLOW_SDK_PACKAGE.name}.`,
+      instructions: "Run the command with the uip CLI on a machine with Node.js."
+    };
+  }
+  const [locateError, resolution] = await catchError2(() => runner.locate(workspace, label));
+  if (locateError) {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: RESULTS.ConfigError,
+      message: `${label}: could not locate ${FLOW_SDK_PACKAGE.name}: ${locateError.message}`,
+      instructions: `Check this host's ${FLOW_SDK_PACKAGE.name}, then retry.`
+    };
+  }
+  if (!resolution.ok) {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: RESULTS.ConfigError,
+      message: resolution.message,
+      instructions: resolution.instructions
+    };
+  }
+  if (!versionMeetsFloor(resolution.version, FLOW_SDK_PACKAGE.minimumVersion)) {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: RESULTS.ConfigError,
+      message: belowFloorMessage(label, resolution.version),
+      instructions: upgradeInstructions(resolution.found)
+    };
+  }
+  if (requiresSdkVersion && !versionMeetsFloor(resolution.version, requiresSdkVersion.version)) {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: RESULTS.ConfigError,
+      message: `${label}: ${requiresSdkVersion.because} needs ${FLOW_SDK_PACKAGE.name} >= ${requiresSdkVersion.version}; found ${resolution.version}.`,
+      instructions: upgradeInstructions(resolution.found)
+    };
+  }
+  let library;
+  const libraryJson = getFileSystem().env.getenv("FLOW_SDK_LIBRARY_JSON");
+  const { INHERITED_AUTH_PROFILE_ENV, getActiveAuthProfile } = await import("./index-f5kq7265.js");
+  const env = {
+    FLOW_SDK_INVOKED_AS,
+    [INHERITED_AUTH_PROFILE_ENV]: getActiveAuthProfile() ?? "",
+    ...libraryJson ? { FLOW_SDK_LIBRARY_JSON: libraryJson } : {}
+  };
+  if (resolution.found === "host" && !libraryJson && LIBRARY_VERBS.has(`${family} ${sdkVerb}`)) {
+    const connectorLibrary = await import("./connector-library-1yw5r47w.js");
+    const [error, loaded] = await catchError2(connectorLibrary.sessionConnectorLibrary(flowSdkRunnerOptions().libraryUrl));
+    if (error) {
+      return {
+        ok: false,
+        exitCode: 1,
+        result: RESULTS.Failure,
+        errorCode: carriedErrorCode(error) ?? "network_error",
+        message: `${label}: could not get the connector library: ${error.message}`,
+        instructions: "Check that this host can reach the connector library download, then retry."
+      };
+    }
+    if (family === "registry" && sdkVerb === "pull") {
+      return pullAnswer(loaded.sha256, connectorLibrary.LIBRARY_JSON);
+    }
+    library = connectorLibrary.libraryMount(loaded);
+    env.FLOW_SDK_LIBRARY_JSON = connectorLibrary.LIBRARY_JSON;
+  }
+  const runUipInProcess = inProcessUip();
+  const prepare = resolution.found === "host" && family === "registry" && sdkVerb === "prepare" && runUipInProcess ? (await import("./prepare-uip-ad7mfs8t.js")).prepareUip(runUipInProcess) : undefined;
+  const sdkArgv = [...argv, "--json", ...passthrough];
+  const sink = getOutputSink();
+  const [runError, outcome] = await catchError2(() => runner.run(resolution, {
+    args: [family, sdkVerb, ...sdkArgv],
+    cwd: workspace,
+    env,
+    ...library ? { library } : {},
+    ...prepare ? { uip: prepare.uip } : {},
+    writeErr: (text) => sink.writeErr(text)
+  }));
+  prepare?.close();
+  await prepare?.settled();
+  return outcomeResult(runError ? { kind: "spawn-error", message: runError.message } : outcome, label, resolution.found);
+}
+async function delegateToMaestroBuilderSdk(request) {
+  const result = await runFlowSdk2(request);
+  if (result.ok) {
+    let data = result.data;
+    const afterSuccess = request.afterSuccess;
+    if (afterSuccess) {
+      const [stepError, step] = await catchError2(() => afterSuccess(result.data));
+      const outcome = stepError ? {
+        ok: false,
+        message: stepError.message,
+        instructions: "The artifact was written; re-run the command once the cause is fixed."
+      } : step;
+      if (!outcome.ok) {
+        OutputFormatter.error({
+          Result: RESULTS.Failure,
+          Message: outcome.message,
+          Instructions: outcome.instructions,
+          ...result.data ? { Data: pascalCaseDataKeys(result.data) } : {}
+        });
+        return 1;
+      }
+      if (outcome.data && data && !Array.isArray(data))
+        data = { ...data, ...outcome.data };
+    }
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: resultCode(request.family, request.commandVerb),
+      Data: data
+    });
+    return 0;
+  }
+  OutputFormatter.error({
+    Result: result.result,
+    ...result.errorCode ? { ErrorCode: result.errorCode } : {},
+    Message: result.message,
+    Instructions: result.instructions,
+    ...result.data ? { Data: pascalCaseDataKeys(result.data) } : {}
+  });
+  return result.exitCode;
+}
+
+// ../builder-sdk/src/npm-global-root.ts
+import { spawn } from "node:child_process";
+var NPM_ROOT_TIMEOUT_MS = 5000;
+var npmRootLookup;
+function npmGlobalRoot() {
+  const prefix = npmConfigPrefix(process.env);
+  if (prefix.trim() !== "") {
+    return Promise.resolve(process.platform === "win32" ? getFileSystem().path.join(prefix, "node_modules") : getFileSystem().path.join(prefix, "lib", "node_modules"));
+  }
+  npmRootLookup ??= runNpmRootGlobal();
+  return npmRootLookup;
+}
+function runNpmRootGlobal() {
+  return new Promise((resolve) => {
+    const stdio = ["ignore", "pipe", "ignore"];
+    const onWindows = { shell: true, stdio, windowsHide: true };
+    const proc = process.platform === "win32" ? spawn("npm root -g", [], onWindows) : spawn("npm", ["root", "-g"], { stdio });
+    let stdout = "";
+    proc.stdout?.on("data", (d) => {
+      stdout += d.toString();
+    });
+    const timer = setTimeout(() => {
+      proc.kill("SIGTERM");
+      resolve(null);
+    }, NPM_ROOT_TIMEOUT_MS);
+    proc.on("error", () => {
+      clearTimeout(timer);
+      resolve(null);
+    });
+    proc.on("close", (code) => {
+      clearTimeout(timer);
+      const root = stdout.trim();
+      resolve(code === 0 && root && !root.includes("***") ? root : null);
+    });
+  });
+}
+function npmConfigPrefix(env) {
+  let prefix = "";
+  for (const [key, value] of Object.entries(env)) {
+    if (key.toLowerCase() === "npm_config_prefix" && value !== undefined) {
+      prefix = value;
+    }
+  }
+  return prefix;
+}
+
+// ../builder-sdk/src/node-runner.ts
+function spawnSdk(cliPath, { args, cwd, env, writeErr }) {
   return new Promise((settle) => {
     let settled = false;
     const resolve = (outcome) => {
@@ -149,10 +371,7 @@ function spawnSdk(cliPath, args, cwd) {
     };
     const child = spawn2("node", [cliPath, ...args], {
       cwd,
-      env: {
-        ...process.env,
-        FLOW_SDK_INVOKED_AS
-      },
+      env: { ...process.env, ...env },
       stdio: ["inherit", "pipe", "pipe"]
     });
     const stdout = [];
@@ -160,7 +379,7 @@ function spawnSdk(cliPath, args, cwd) {
     const decoderErr = new StringDecoder("utf8");
     const writeLive = (text) => {
       if (text)
-        getOutputSink().writeErr(text);
+        writeErr(text);
     };
     child.stdout?.on("data", (chunk) => {
       stdout.push(chunk);
@@ -186,43 +405,6 @@ function spawnSdk(cliPath, args, cwd) {
     });
   });
 }
-async function runChild(cliPath, args, cwd, label) {
-  const outcome = await spawnSdk(cliPath, args, cwd);
-  if (outcome.kind === "spawn-error") {
-    return {
-      ok: false,
-      exitCode: 1,
-      result: RESULTS.Failure,
-      message: `${label}: ${outcome.message}`,
-      instructions: "Check that node is on PATH, then retry."
-    };
-  }
-  const { exitCode, signal, out, err } = outcome;
-  if (exitCode === 0) {
-    return { ok: true, data: stdoutAsData(out) };
-  }
-  if (exitCode !== null) {
-    const detail = failureReason(out, err) || `SDK exited with code ${exitCode}`;
-    return {
-      ok: false,
-      exitCode,
-      result: RESULTS.Failure,
-      message: `${label}: ${detail}`,
-      instructions: err ? "Fix what the builder SDK reported (on stderr, and in Message), then retry." : "Fix what the builder SDK reported (see Message), then retry.",
-      ...out.trim() ? { data: stdoutAsData(out) } : {}
-    };
-  }
-  return {
-    ok: false,
-    exitCode: 1,
-    result: RESULTS.Failure,
-    message: `${label}: SDK process ended with signal ${signal ?? "unknown"}.`,
-    instructions: "Retry the command."
-  };
-}
-function upgradeInstructions(found) {
-  return found === "workspace" ? `npm install --save-dev ${FLOW_SDK_PACKAGE.name}@latest` : `npm install -g ${FLOW_SDK_PACKAGE.name}@latest`;
-}
 function resolveLocalPackageJson(workspace) {
   const require2 = createRequire(import.meta.url);
   try {
@@ -241,7 +423,7 @@ async function resolveGlobalPackageJson() {
   const candidate = fs.path.join(root, ...FLOW_SDK_PACKAGE.name.split("/"), "package.json");
   return await fs.exists(candidate) ? candidate : null;
 }
-async function resolveFlowSdk(workspace, label) {
+async function resolveFlowSdk2(workspace, label) {
   const fs = getFileSystem();
   const { name, minimumVersion } = FLOW_SDK_PACKAGE;
   const localPath = resolveLocalPackageJson(workspace);
@@ -272,7 +454,7 @@ async function resolveFlowSdk(workspace, label) {
   if (!versionMeetsFloor(version, minimumVersion)) {
     return {
       ok: false,
-      message: `${label}: found ${name} ${version || "with no valid version"}; need >= ${minimumVersion}.`,
+      message: belowFloorMessage(label, version),
       instructions: upgradeInstructions(found)
     };
   }
@@ -283,57 +465,88 @@ async function resolveFlowSdk(workspace, label) {
     found: found === "workspace" ? "workspace" : "global"
   };
 }
-async function runFlowSdk({
-  family,
-  commandVerb,
-  sdkVerb = commandVerb,
-  argv,
-  cwd,
-  requiresSdkVersion
-}) {
-  const fs = getFileSystem();
-  const workspace = cwd ?? fs.env.cwd();
-  const label = commandLabel(family, commandVerb);
-  const resolution = await resolveFlowSdk(workspace, label);
-  if (!resolution.ok) {
-    return {
-      ok: false,
-      exitCode: 1,
-      result: RESULTS.ConfigError,
-      message: resolution.message,
-      instructions: resolution.instructions
-    };
+var nodeFlowSdkRunner = {
+  locate: resolveFlowSdk2,
+  run: async (sdk, request) => {
+    if (sdk.packageDir === undefined) {
+      return {
+        kind: "spawn-error",
+        message: "the SDK location has no package directory"
+      };
+    }
+    const cliPath = getFileSystem().path.join(sdk.packageDir, "dist", "cli", "index.js");
+    return await spawnSdk(cliPath, request);
   }
-  if (requiresSdkVersion && !versionMeetsFloor(resolution.version, requiresSdkVersion.version)) {
-    return {
-      ok: false,
-      exitCode: 1,
-      result: RESULTS.ConfigError,
-      message: `${label}: ${requiresSdkVersion.because} needs ${FLOW_SDK_PACKAGE.name} >= ${requiresSdkVersion.version}; found ${resolution.version}.`,
-      instructions: upgradeInstructions(resolution.found)
-    };
+};
+
+// ../builder-sdk/src/argv.ts
+function addValue(argv, flag, value) {
+  if (typeof value === "string") {
+    argv.push(flag, value);
   }
-  const cliPath = fs.path.join(resolution.packageDir, "dist", "cli", "index.js");
-  const sdkArgv = argv.includes("--json") ? [...argv] : [...argv, "--json"];
-  return await runChild(cliPath, [family, sdkVerb, ...sdkArgv], workspace, label);
 }
-async function delegateToFlowSdk(request) {
-  const result = await runFlowSdk(request);
-  if (result.ok) {
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: resultCode(request.family, request.commandVerb),
-      Data: result.data
-    });
-    return 0;
+var tails = new WeakMap;
+function passThroughToSdk(command, {
+  extraOperands = "refuse"
+} = {}) {
+  const positionals = command.registeredArguments;
+  if (positionals.length !== 1 || positionals[0]?.variadic) {
+    throw new Error(`passThroughToSdk needs exactly one non-variadic positional; '${command.name()}' has ${positionals.length}`);
   }
-  OutputFormatter.error({
-    Result: result.result,
-    Message: result.message,
-    Instructions: result.instructions,
-    ...result.data ? { Data: pascalCaseDataKeys(result.data) } : {}
+  command.parent?.enablePositionalOptions();
+  command.passThroughOptions().allowExcessArguments(true);
+  command.hook("preAction", (thisCommand) => {
+    const [positional] = thisCommand.args;
+    if (positional !== undefined && positional.length > 1 && positional.startsWith("-")) {
+      thisCommand.error(`error: '${positional}' would reach the SDK as an option. Write it as './${positional}'.`, { code: "commander.invalidArgument" });
+    }
+    liftDeclaredOptions(thisCommand);
+    const { operands } = sdkTail(thisCommand);
+    if (extraOperands === "refuse" && operands.length > 0) {
+      thisCommand.error(`error: too many arguments for '${thisCommand.name()}'. Expected 1 argument but got ${1 + operands.length}.`, { code: "commander.excessArguments" });
+    }
   });
-  return result.exitCode;
+  return command;
+}
+function liftDeclaredOptions(cmd) {
+  const [positional, ...tail] = cmd.args;
+  if (positional === undefined)
+    return;
+  const { tokens, firstUnknown, sentinel } = tokenizeTail(cmd, tail);
+  const cut = Math.min(firstUnknown === -1 ? tail.length : firstUnknown, sentinel === -1 ? tail.length : sentinel);
+  const late = tokens.find((token) => token.kind === "option" && token.index > cut);
+  if (late?.kind === "option") {
+    const flag = late.option.long ?? late.option.short;
+    cmd.error(`error: write ${flag} before any SDK flag ('${tail[firstUnknown]}'). An SDK flag whose value starts with '-' is written --flag=value.`, { code: "commander.invalidArgument" });
+  }
+  cmd.passThroughOptions(false);
+  let parsed;
+  try {
+    parsed = cmd.parseOptions(tail.slice(0, cut));
+  } finally {
+    cmd.passThroughOptions(true);
+  }
+  const lifted = {
+    operands: parsed.operands,
+    forwarded: [...parsed.unknown, ...tail.slice(cut)]
+  };
+  tails.set(cmd, lifted);
+  cmd.args = [positional, ...lifted.operands, ...lifted.forwarded];
+}
+function sdkTail(cmd) {
+  return tails.get(cmd) ?? { operands: [], forwarded: cmd.args.slice(1) };
+}
+function delegateArgv(cmd, parsed) {
+  const { operands, forwarded } = sdkTail(cmd);
+  const positional = cmd.args[0];
+  return {
+    argv: [
+      ...positional === undefined ? [] : [positional],
+      ...operands,
+      ...parsed
+    ],
+    ...forwarded.length > 0 ? { passthrough: [...forwarded] } : {}
+  };
 }
 
 // ../builder-sdk/src/examples.ts
@@ -384,32 +597,35 @@ var CONNECTOR_GATES = {
     because: "the connector library on case check"
   }
 };
-var registerCheckCommand = (program, family) => {
+var registerCheckCommand2 = (program, family) => {
   const command = program.command("check <input>").description("Check a source file for authoring errors before compiling it.").option("--source", "Check authored TypeScript");
   command.option("--library <dir>", "Connector library directory (defaults to $FLOW_SDK_LIBRARY_JSON, else the pulled library)").option("--connectors-local <dir>", "Connection-resolved connector overlay (default: ./connectors-local)");
   if (family === "bpmn") {
     command.option("--graph", "Also print the resolved wiring: every element with the flows leaving it, implied edges marked ~>");
   }
   const example = CHECK_EXAMPLES[family];
-  command.examples(sdkCliExample(family, "check", `Check a ${family} source file before compiling it`, `uip maestro ${family} check ${example.input} --source`, CHECK_RESULT)).trackedAction(processContext, async (input, options) => {
-    const argv = [input];
+  command.examples(sdkCliExample(family, "check", `Check a ${family} source file before compiling it`, `uip maestro ${family} check ${example.input} --source`, CHECK_RESULT)).trackedAction(processContext, async (_input, options, cmd) => {
+    const parsed = [];
     if (options.source)
-      argv.push("--source");
-    addValue(argv, "--library", await resolveLibraryOption(options.library));
-    addValue(argv, "--connectors-local", options.connectorsLocal);
+      parsed.push("--source");
+    addValue(parsed, "--library", await resolveLibraryOption(options.library));
+    addValue(parsed, "--connectors-local", options.connectorsLocal);
     if (options.graph)
-      argv.push("--graph");
+      parsed.push("--graph");
+    const { argv, passthrough } = delegateArgv(cmd, parsed);
     const gate = CONNECTOR_GATES[family];
     const gated = gate !== undefined && (options.connectorsLocal !== undefined || await connectorLibraryInPlay(options.library));
-    const code = await delegateToFlowSdk({
+    const code = await delegateToMaestroBuilderSdk({
       family,
       commandVerb: "check",
       argv,
+      ...passthrough ? { passthrough } : {},
       ...gated ? { requiresSdkVersion: gate } : {}
     });
     if (code !== 0)
       processContext.exit(code);
   });
+  passThroughToSdk(command);
 };
 // ../builder-sdk/src/commands/compile.ts
 var COMPILE_EXAMPLES = {
@@ -437,25 +653,28 @@ var COMPILE_EXAMPLES = {
     result: { Path: "/work/Approval.bpmn", Elements: 4 }
   }
 };
-var registerCompileCommand = (program, family) => {
+var registerCompileCommand2 = (program, family, hooks = {}) => {
   const command = program.command("compile <source>").description(`Compile authored TypeScript to a ${family} artifact.`).option("-o, --output-file <file>", "Output artifact path").option("--library <dir>", "Connector library directory (defaults to the pulled registry)").option("--bindings <file>", "bindings.json path").option("--connectors-local <dir>", "Connection-resolved connector overlay (default: ./connectors-local)");
   addDeprecatedOptionAlias(command, "--output <file>", "--output-file");
   if (family === "flow") {
     command.option("--no-check", "Skip the source-level check");
   }
   const example = COMPILE_EXAMPLES[family];
-  command.examples(sdkCliExample(family, "compile", `Compile a ${family} source file to an artifact`, `uip maestro ${family} compile ${example.source} --output-file ${example.output}`, example.result)).trackedAction(processContext, async (source, options) => {
-    const argv = [source];
-    addValue(argv, "-o", options.outputFile);
-    addValue(argv, "--library", await resolveLibraryOption(options.library));
-    addValue(argv, "--bindings", options.bindings);
-    addValue(argv, "--connectors-local", options.connectorsLocal);
+  command.examples(sdkCliExample(family, "compile", `Compile a ${family} source file to an artifact`, `uip maestro ${family} compile ${example.source} --output-file ${example.output}`, example.result)).trackedAction(processContext, async (_source, options, cmd) => {
+    const parsed = [];
+    addValue(parsed, "-o", options.outputFile);
+    addValue(parsed, "--library", await resolveLibraryOption(options.library));
+    addValue(parsed, "--bindings", options.bindings);
+    addValue(parsed, "--connectors-local", options.connectorsLocal);
     if (options.check === false)
-      argv.push("--no-check");
-    const code = await delegateToFlowSdk({
+      parsed.push("--no-check");
+    const { argv, passthrough } = delegateArgv(cmd, parsed);
+    const code = await delegateToMaestroBuilderSdk({
       family,
       commandVerb: "compile",
       argv,
+      ...passthrough ? { passthrough } : {},
+      ...hooks.afterSuccess ? { afterSuccess: hooks.afterSuccess } : {},
       ...family === "bpmn" && options.connectorsLocal !== undefined ? {
         requiresSdkVersion: {
           version: BPMN_CONNECTOR_OPTIONS_VERSION,
@@ -466,6 +685,7 @@ var registerCompileCommand = (program, family) => {
     if (code !== 0)
       processContext.exit(code);
   });
+  passThroughToSdk(command);
 };
 // ../builder-sdk/src/commands/decompile.ts
 var DECOMPILE_EXAMPLES = {
@@ -498,11 +718,12 @@ var ARTIFACT = {
   case: { artifact: "caseplan.json", source: ".case.ts" },
   bpmn: { artifact: ".bpmn", source: ".bpmn.ts" }
 };
-var registerDecompileCommand = (program, family) => {
+var registerDecompileCommand2 = (program, family) => {
   const command = program.command("decompile <input>").description(`Convert a ${ARTIFACT[family].artifact} artifact to authored TypeScript.`).option("-o, --output-file <file>", `Output ${ARTIFACT[family].source} path`).option("--import <specifier>", "SDK import specifier in generated source");
   addDeprecatedOptionAlias(command, "--output <file>", "--output-file");
   if (family === "flow") {
     command.option("--strict", "Fail on unsupported constructs");
+    command.addOption(new Option("--scripts <form>", "function (the default) or string: how script steps are printed").choices(["function", "string"]));
   } else if (family === "case") {
     command.option("--library <dir>", "Connector library directory (defaults to the pulled registry)").option("--best-effort", "Emit a marked repair scaffold for unsupported constructs");
   } else {
@@ -512,55 +733,39 @@ var registerDecompileCommand = (program, family) => {
     command.option("--no-pipeline", "Do not emit a brownfield pipeline helper");
   }
   const example = DECOMPILE_EXAMPLES[family];
-  command.examples(sdkCliExample(family, "decompile", `Convert a ${family} artifact back to authored TypeScript`, `uip maestro ${family} decompile ${example.input} --output-file ${example.output}${example.extra ?? ""}`, example.result)).trackedAction(processContext, async (input, options) => {
-    const argv = [input];
-    addValue(argv, "-o", options.outputFile);
-    addValue(argv, "--import", options.import);
+  command.examples(sdkCliExample(family, "decompile", `Convert a ${family} artifact back to authored TypeScript`, `uip maestro ${family} decompile ${example.input} --output-file ${example.output}${example.extra ?? ""}`, example.result)).trackedAction(processContext, async (_input, options, cmd) => {
+    const parsed = [];
+    addValue(parsed, "-o", options.outputFile);
+    addValue(parsed, "--import", options.import);
     if (family === "case") {
-      addValue(argv, "--library", await resolveLibraryOption(options.library));
+      addValue(parsed, "--library", await resolveLibraryOption(options.library));
     }
     if (options.strict)
-      argv.push("--strict");
+      parsed.push("--strict");
     if (options.bestEffort)
-      argv.push("--best-effort");
+      parsed.push("--best-effort");
     if (options.pipeline === false)
-      argv.push("--no-pipeline");
-    addValue(argv, "--style", options.style);
-    const code = await delegateToFlowSdk({
+      parsed.push("--no-pipeline");
+    addValue(parsed, "--style", options.style);
+    addValue(parsed, "--scripts", options.scripts);
+    const { argv, passthrough } = delegateArgv(cmd, parsed);
+    const code = await delegateToMaestroBuilderSdk({
       family,
       commandVerb: "decompile",
-      argv
+      argv,
+      ...passthrough ? { passthrough } : {},
+      ...options.scripts ? {
+        requiresSdkVersion: {
+          version: FLOW_DECOMPILE_SCRIPTS_VERSION,
+          because: "--scripts on flow decompile"
+        }
+      } : {}
     });
     if (code !== 0)
       processContext.exit(code);
   });
+  passThroughToSdk(command);
 };
-// ../builder-sdk/src/named-second.ts
-function namedOrLegacy(spec) {
-  if (spec.named !== undefined && spec.legacy !== undefined) {
-    usageError(`pass ${spec.flag} or a second argument, not both`, spec.usage);
-  }
-  if (spec.named === "") {
-    usageError(`option '${spec.flag}' argument missing`, spec.usage);
-  }
-  if (spec.named !== undefined)
-    return spec.named;
-  if (spec.legacy === undefined) {
-    usageError(`required option '${spec.flag}' not specified`, spec.usage);
-  }
-  getOutputSink().writeErr(`[WARN] The two-argument form is deprecated. Use \`${spec.usage}\` instead.
-`);
-  return spec.legacy;
-}
-function usageError(message, usage) {
-  throw Object.assign(new Error(message), {
-    result: RESULTS.ValidationError,
-    errorCode: "invalid_argument",
-    retry: "RetryWillNotFix",
-    instructions: `Usage: ${usage}`
-  });
-}
-
 // ../builder-sdk/src/commands/merge.ts
 var MERGE_EXAMPLES = {
   flow: {
@@ -584,7 +789,7 @@ var MERGE_EXAMPLES = {
     }
   }
 };
-var registerMergeCommand = (program, family) => {
+var registerMergeCommand2 = (program, family) => {
   const command = program.command("merge <edited>").description(`Merge an edited ${family} with its original artifact.`).option("--original <file>", "Original artifact to merge into (required)").option("-o, --output-file <file>", "Merged output path").allowExcessArguments(true);
   addDeprecatedOptionAlias(command, "--output <file>", "--output-file");
   if (family !== "case") {
@@ -596,10 +801,11 @@ var registerMergeCommand = (program, family) => {
   const example = MERGE_EXAMPLES[family];
   command.examples(sdkCliExample(family, "merge", example.description, example.command, example.result)).trackedAction(processContext, async (first, options, cmd) => {
     const usage = `uip maestro ${family} merge <edited> --original <file>`;
-    if (cmd.args.length > 2) {
-      usageError(`unexpected argument '${cmd.args[2]}'`, usage);
+    const { operands, forwarded } = sdkTail(cmd);
+    if (options.original === undefined && operands.length === 0 && forwarded.some((token) => !token.startsWith("-"))) {
+      usageError("required option '--original' not specified. If a path follows an SDK flag, write both paths before the flag, or use --original", usage);
     }
-    const legacyEdited = cmd.args[1];
+    const legacyEdited = legacySecondArg([first, ...operands], usage);
     const original = namedOrLegacy({
       named: options.original,
       legacy: legacyEdited === undefined ? undefined : first,
@@ -612,10 +818,11 @@ var registerMergeCommand = (program, family) => {
     addValue(tail, "--baseline", options.baseline);
     if (options.strict)
       tail.push("--strict");
-    const code = await delegateToFlowSdk({
+    const code = await delegateToMaestroBuilderSdk({
       family,
       commandVerb: "merge",
       argv: [edited, "--original", original, ...tail],
+      ...forwarded.length > 0 ? { passthrough: [...forwarded] } : {},
       ...options.strict ? {
         requiresSdkVersion: {
           version: FLOW_MERGE_STRICT_VERSION,
@@ -626,199 +833,12 @@ var registerMergeCommand = (program, family) => {
     if (code !== 0)
       processContext.exit(code);
   });
+  passThroughToSdk(command, { extraOperands: "allow" });
 };
-// ../builder-sdk/src/commands/registry.ts
-function collect(value, previous) {
-  return [...previous, value];
-}
-async function delegate(commandVerb, argv) {
-  const code = await delegateToFlowSdk({
-    family: "registry",
-    commandVerb,
-    argv
-  });
-  if (code !== 0)
-    processContext.exit(code);
-}
-var registerPull = (registry) => {
-  registry.command("pull").description("Download the connector library into the shared cache and generate the descriptors this project imports.").option("--connectors <dir>", "TypeScript descriptor output (default: ./connectors)").option("--connector <key>", "only generate this connector (repeatable; default: whatever the project references)", collect, []).option("--library <dir>", "extract here instead of the shared cache").option("--library-md <dir>", "generate Markdown here instead").option("--url <url>", "archive URL to pull from").option("--archive <zip>", "use a zip already on disk").option("--force", "re-download and regenerate").option("--import <specifier>", "module specifier for descriptors").option("--triggers <path>", "registry-triggers.json for triggers").option("--python <executable>", "Python interpreter for the generators").option("--cache <dir>", "where downloaded archives are kept").option("--root <prefix>", "only extract archive entries under this prefix").option("--extractor <path>", "extract_library.py to run instead of the packaged copy").option("--generator <path>", "materialize_registry.py to run instead of the packaged copy").examples(sdkCliExample("registry", "pull", "Pull the library and generate the Slack descriptor", "uip maestro registry pull --connector uipath-salesforce-slack", {
-    Sha256: "f2ae49be22ec…",
-    Library: "~/.uipath/cache/flow-sdk/library/f2ae49be22ec…/library-json",
-    LibraryMarkdown: "~/.uipath/cache/flow-sdk/library/f2ae49be22ec…/library-md",
-    MadeCurrent: true,
-    Connectors: "/work/connectors",
-    Generated: ["uipath-salesforce-slack"]
-  })).trackedAction(processContext, async (options) => {
-    const argv = [];
-    addValue(argv, "--connectors", options.connectors);
-    for (const key of options.connector ?? []) {
-      argv.push("--connector", key);
-    }
-    addValue(argv, "--library", options.library);
-    addValue(argv, "--library-md", options.libraryMd);
-    addValue(argv, "--url", options.url);
-    addValue(argv, "--archive", options.archive);
-    if (options.force)
-      argv.push("--force");
-    addValue(argv, "--import", options.import);
-    addValue(argv, "--triggers", options.triggers);
-    addValue(argv, "--python", options.python);
-    addValue(argv, "--cache", options.cache);
-    addValue(argv, "--root", options.root);
-    addValue(argv, "--extractor", options.extractor);
-    addValue(argv, "--generator", options.generator);
-    await delegate("pull", argv);
-  });
-};
-var registerSearch = (registry) => {
-  registry.command("search [query...]").description("Find connector operations in the cached library.").passThroughOptions().allowExcessArguments(true).option("--library <dir>", "library-json directory (default: the cache)").option("--library-md <dir>", "markdown tree").option("--connector <key>", "restrict to one connector key").option("--limit <n>", "maximum results").examples(sdkCliExample("registry", "search", "Find the Slack channel-message operation", "uip maestro registry search slack send message --limit 5", { Total: 2, Operations: ["…"] })).trackedAction(processContext, async (_query, options, cmd) => {
-    const argv = [...cmd.args];
-    addValue(argv, "--library", options.library);
-    addValue(argv, "--library-md", options.libraryMd);
-    addValue(argv, "--connector", options.connector);
-    addValue(argv, "--limit", options.limit);
-    await delegate("search", argv);
-  });
-};
-var registerPath = (registry) => {
-  registry.command("path").description("Print where the cached connector library is.").option("--library-json", "print only the library-json directory").option("--library-md", "print only the markdown directory").option("--root", "print only the cache root").option("--sha", "print only the checksum current points at").examples(sdkCliExample("registry", "path", "Print the Markdown library directory, bare, for $(…) capture", "uip maestro registry path --library-md --output plain", {
-    LibraryMarkdown: "~/.uipath/cache/flow-sdk/library/current/library-md"
-  })).trackedAction(processContext, async (options) => {
-    const argv = [];
-    if (options.libraryJson)
-      argv.push("--library-json");
-    if (options.libraryMd)
-      argv.push("--library-md");
-    if (options.root)
-      argv.push("--root");
-    if (options.sha)
-      argv.push("--sha");
-    await delegate("path", argv);
-  });
-};
-function strayPositional(cmd, tail) {
-  for (let index = 0;index < tail.length; index++) {
-    const token = tail[index];
-    if (!token.startsWith("-"))
-      return token;
-    if (token.includes("="))
-      continue;
-    const option = cmd.options.find((candidate) => candidate.long === token || candidate.short === token);
-    if (option === undefined)
-      return;
-    if (option.required || option.optional)
-      index++;
-  }
-  return;
-}
-var PREPARE_USAGE = "uip maestro registry prepare <connector-key> --action <name>";
-var registerPrepare = (registry) => {
-  registry.command("prepare <connector-key>").description("Resolve one operation's schema against a live connection into ./connectors-local, and record the connection in bindings.json.").passThroughOptions().allowExcessArguments(true).option("--action <name>", "operation to resolve, e.g. insert-record (required)", (value, previous) => [
-    ...previous ?? [],
-    value
-  ]).option("--connection-id <id>", "connection to read the schema through (default: discovered)").option("--connection <name>", "pick the connection by name when several match").option("--connection-folder <folder>", "pick the connection in the folder the flow runs in (name or key) when several match").option("--bindings <file>", "bindings file to update (default: ./bindings.json)").option("--bind-connection <name>", "symbolic connection name (default: the connector suffix)").option("--bind-folder <name>", "symbolic folder name (default: shared)").option("--no-bindings", "discover the connection but leave bindings.json alone").option("--object <name>", "one connection-discovered object").option("--all-objects", "every connection-discovered object").option("-f, --field <name=value>", "parent field that selects the schema (repeatable)", collect, []).option("--out <dir>", "overlay directory (default: ./connectors-local)").option("--connector-version <version>", "connector version to resolve against").option("--import <specifier>", "module specifier for descriptors").option("--resolve <field:by=value>", "resolve a lookup field to the id the connector wants (repeatable)", collect, []).option("--refresh-lookups", "re-resolve lookups already recorded in resolutions.json").option("--json-only", "write the JSON overlay without TypeScript").option("--python <executable>", "Python interpreter for the generator").option("--generator <path>", "prepare_connector.py to run instead of the packaged copy").examples([
-    ...sdkCliExample("registry", "prepare", "Resolve a Salesforce custom object the shipped library cannot know", "uip maestro registry prepare uipath-salesforce-sfdc --action insert-record --object Company__c", {
-      Connector: "uipath-salesforce-sfdc",
-      Action: "insert-record",
-      Overlay: "/work/connectors-local"
-    }),
-    ...sdkCliExample("registry", "prepare", "Resolve Slack lookup fields to ids and pick one of several connections", "uip maestro registry prepare uipath-salesforce-slack --action send-message-to-channel --connection is-sandboxes --resolve channel:name=general --resolve send_as:name=user", {
-      Connector: "uipath-salesforce-slack",
-      Action: "send-message-to-channel",
-      Overlay: "/work/connectors-local"
-    })
-  ]).trackedAction(processContext, async (connectorKey, options, cmd) => {
-    const tail = cmd.args.slice(1);
-    const before = options.action ?? [];
-    if (before.length > 1) {
-      usageError("pass --action once", PREPARE_USAGE);
-    }
-    let named = before[0];
-    const at = tail.findIndex((token) => token === "--action" || token.startsWith("--action="));
-    if (at >= 0) {
-      const token = tail[at];
-      const inline = token.startsWith("--action=");
-      const value = inline ? token.slice("--action=".length) : tail[at + 1];
-      if (!value || value.startsWith("-")) {
-        usageError("option '--action <name>' argument missing", PREPARE_USAGE);
-      }
-      if (named !== undefined) {
-        usageError("pass --action once", PREPARE_USAGE);
-      }
-      named = value;
-      tail.splice(at, inline ? 1 : 2);
-      if (tail.some((token2) => token2 === "--action" || token2.startsWith("--action="))) {
-        usageError("pass --action once", PREPARE_USAGE);
-      }
-    }
-    const legacy = tail[0] !== undefined && !tail[0].startsWith("-") ? tail.shift() : undefined;
-    const extra = strayPositional(cmd, tail);
-    if (extra !== undefined) {
-      usageError(`unexpected argument '${extra}'`, PREPARE_USAGE);
-    }
-    const action = namedOrLegacy({
-      named,
-      legacy,
-      flag: "--action",
-      usage: PREPARE_USAGE
-    });
-    const argv = tail;
-    addValue(argv, "--connection-id", options.connectionId);
-    addValue(argv, "--connection", options.connection);
-    addValue(argv, "--connection-folder", options.connectionFolder);
-    addValue(argv, "--bindings", options.bindings);
-    addValue(argv, "--bind-connection", options.bindConnection);
-    addValue(argv, "--bind-folder", options.bindFolder);
-    if (options.bindings === false)
-      argv.push("--no-bindings");
-    addValue(argv, "--object", options.object);
-    if (options.allObjects)
-      argv.push("--all-objects");
-    for (const field of options.field ?? []) {
-      argv.push("-f", field);
-    }
-    addValue(argv, "--out", options.out);
-    addValue(argv, "--connector-version", options.connectorVersion);
-    addValue(argv, "--import", options.import);
-    for (const one of options.resolve ?? []) {
-      argv.push("--resolve", one);
-    }
-    if (options.refreshLookups)
-      argv.push("--refresh-lookups");
-    if (options.jsonOnly)
-      argv.push("--json-only");
-    addValue(argv, "--python", options.python);
-    addValue(argv, "--generator", options.generator);
-    await delegate("prepare", [
-      connectorKey,
-      "--action",
-      action,
-      ...argv
-    ]);
-  });
-};
-var registerRegistryCommands = (program) => {
-  const registry = program.command("registry").description("Acquire, locate, search and prepare the connector library shared by Flow, Case, and BPMN.").enablePositionalOptions();
-  registerPull(registry);
-  registerSearch(registry);
-  registerPath(registry);
-  registerPrepare(registry);
-};
-// ../builder-sdk/src/commands/tidy.ts
-var registerTidyCommand = (program) => {
-  const command = program.command("tidy <input>").description("Add diagram layout to a compiled .bpmn artifact.").option("-o, --output-file <file>", "Output .bpmn path").examples(sdkCliExample("bpmn", "tidy", "Add diagram layout and write the result to a separate BPMN artifact", "uip maestro bpmn tidy Approval.bpmn --output-file Approval.tidied.bpmn", { Path: "/work/Approval.tidied.bpmn", Shapes: 4 })).trackedAction(processContext, async (input, options) => {
-    const argv = [input];
-    addValue(argv, "-o", options.outputFile);
-    const code = await delegateToFlowSdk({
-      family: "bpmn",
-      commandVerb: "tidy",
-      argv
-    });
-    if (code !== 0)
-      processContext.exit(code);
-  });
-  addDeprecatedOptionAlias(command, "--output <file>", "--output-file");
-};
-export { resolveFlowSdk, runFlowSdk, registerCheckCommand, registerCompileCommand, registerDecompileCommand, registerMergeCommand, registerRegistryCommands, registerTidyCommand };
+// ../builder-sdk/src/index.ts
+if (!flowSdkRunner())
+  registerFlowSdkRunner(nodeFlowSdkRunner);
+
+export { runFlowSdk2, resolveFlowSdk2, registerCheckCommand2, registerCompileCommand2, registerDecompileCommand2, registerMergeCommand2 };
 
-//# debugId=EA56BCC61AE9CBE364756E2164756E21
+//# debugId=CEF8A126BBE7C83664756E2164756E21