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

package/dist/{packager-tool-1d64q5s5.js → packager-tool-b2pkwwj1.js}

@@ -1,51 +1,49 @@
 import {
-  resolveJsonInput
-} from "./packager-tool-ymma2s85.js";
-import {
-  DEBUG_MODE_MAP,
-  SIMULATION_MODE_MAP,
-  beginDebugSession,
-  createDebugInstance,
-  fetchDebugInstanceVariables,
-  getPersonalFolderKey
-} from "./packager-tool-tqjfdpda.js";
-import {
-  debugPimsGet,
-  debugPimsPatch,
-  debugPimsPost,
-  debugPimsPut
-} from "./packager-tool-frjt46rb.js";
-import {
-  getAuthContext,
-  getLoginStatusAsync
-} from "./packager-tool-kn86394c.js";
+  catchError2
+} from "./packager-tool-pxq0bwp0.js";
 import {
-  DEFAULT_PAGE_SIZE,
-  EXIT_CODES,
+  extractErrorMessage,
+  RESULTS,
+  classifiedFailure,
+  authContextFailure,
   InvalidArgumentError,
-  OutputFormatter,
+  logger,
+  EXIT_CODES,
   Pagination,
-  RESULTS,
-  extractErrorMessage,
+  OutputFormatter,
+  processContext,
+  DEFAULT_PAGE_SIZE,
   isGuid,
-  logger,
-  parseBoundedInt,
   parseLimit,
   parseOffset,
-  processContext
-} from "./packager-tool-apawc11t.js";
+  parseBoundedInt
+} from "./packager-tool-8ed52y5r.js";
 import {
-  catchError
-} from "./packager-tool-t7ahhaer.js";
+  getAuthContext2
+} from "./packager-tool-p123mtfx.js";
 import {
-  __require
-} from "./packager-tool-1yh8g550.js";
+  debugPimsGet2,
+  debugPimsPost2,
+  debugPimsPut2,
+  debugPimsPatch2
+} from "./packager-tool-508ka40b.js";
+import {
+  getPersonalFolderKey2,
+  beginDebugSession2,
+  DEBUG_MODE_MAP2,
+  SIMULATION_MODE_MAP2,
+  createDebugInstance2,
+  fetchDebugInstanceVariables2
+} from "./packager-tool-jmrhzfyj.js";
+import {
+  resolveJsonInput
+} from "./packager-tool-8ba22j6n.js";
 
 // ../maestro-sdk/src/client.ts
 function parseBackendErrorBody(body) {
   if (!body)
     return {};
-  const [parseErr, parsed] = catchError(() => JSON.parse(body));
+  const [parseErr, parsed] = catchError2(() => JSON.parse(body));
   if (parseErr || !parsed || typeof parsed !== "object")
     return {};
   const result = {};
@@ -129,7 +127,7 @@ async function pimsGet(config, path, options) {
   const text = await response.text();
   if (!text)
     return {};
-  const [parseErr, parsed] = catchError(() => JSON.parse(text));
+  const [parseErr, parsed] = catchError2(() => JSON.parse(text));
   if (parseErr)
     throw new Error(`Failed to parse API response body: ${parseErr.message}`);
   return parsed;
@@ -156,7 +154,7 @@ async function pimsRequest(config, method, path, body, options) {
   const text = await response.text();
   if (!text)
     return {};
-  const [parseErr, parsed] = catchError(() => JSON.parse(text));
+  const [parseErr, parsed] = catchError2(() => JSON.parse(text));
   if (parseErr) {
     throw new Error(`Failed to parse API response body: ${parseErr.message}`);
   }
@@ -174,7 +172,7 @@ async function pimsPatch(config, path, body, options) {
 
 // ../maestro-sdk/src/client-factory.ts
 async function createPimsConfig() {
-  const ctx = await getAuthContext({
+  const ctx = await getAuthContext2({
     ensureTokenValidityMinutes: 10,
     requireOrganizationId: true,
     requireTenantId: true
@@ -206,846 +204,261 @@ function buildQueryString(params) {
   return `?${new URLSearchParams(entries).toString()}`;
 }
 
-// ../maestro-sdk/src/registry/filter-parser.ts
-class FilterParseError extends Error {
-  code;
-  token;
-  constructor(message, code, token) {
-    super(message);
-    this.code = code;
-    this.token = token;
-    this.name = "FilterParseError";
-  }
-}
-function parseFilterString(filterString) {
-  if (!filterString || filterString.trim() === "") {
-    return { filters: [], logic: "AND" };
-  }
-  const parts = filterString.split(/,(?=[a-zA-Z_][a-zA-Z0-9_]*(?::[a-zA-Z]+)?=)/);
-  const conditions = [];
-  for (const part of parts) {
-    const condition = parseFilterCondition(part.trim());
-    conditions.push(condition);
-  }
+// ../maestro-sdk/src/with-debug-pims-call.ts
+async function createDebugPimsConfig() {
+  const auth = await getAuthContext2({
+    ensureTokenValidityMinutes: 10,
+    requireOrganizationId: true,
+    requireTenantId: true,
+    requireTenantName: true
+  });
   return {
-    filters: conditions,
-    logic: "AND"
+    baseUrl: auth.baseUrl,
+    organizationId: auth.organizationId,
+    tenantName: auth.tenantName,
+    tenantId: auth.tenantId,
+    authToken: auth.accessToken
   };
 }
-function parseFilterCondition(conditionString) {
-  const match = conditionString.match(/^([^:=]+)(?::([^=]+))?=(.+)$/);
-  if (!match) {
-    throw new FilterParseError(`Invalid filter format: '${conditionString}'. Expected 'field=value' or 'field:operator=value'.`, "INVALID_FORMAT", conditionString);
-  }
-  const [, fieldStr, operatorStr, valueStr] = match;
-  const field = normalizeField(fieldStr.trim());
-  const operator = operatorStr?.trim() || "equals";
-  const value = valueStr.trim();
-  if (!isValidField(field)) {
-    throw new FilterParseError(`Invalid filter field: '${field}'. Supported fields: category, type, tags, displayname, nodetype, description.`, "INVALID_FIELD", field);
+async function withDebugPimsCall(fn, errorMessage) {
+  const [configError, config] = await catchError2(createDebugPimsConfig());
+  if (configError) {
+    logger.warn(`${errorMessage}: ${configError.message}`);
+    OutputFormatter.error(await authContextFailure(configError));
+    processContext.exit(1);
+    return;
   }
-  if (!isValidOperator(operator)) {
-    throw new FilterParseError(`Invalid filter operator: '${operator}'. Supported operators: equals, contains, in, startsWith, endsWith.`, "INVALID_OPERATOR", operator);
+  if (!config.folderKey) {
+    const [folderError, folder] = await catchError2(getPersonalFolderKey2(config));
+    if (folderError) {
+      logger.warn(`Could not resolve personal folder: ${folderError.message}`);
+    } else {
+      config.folderKey = folder.key;
+      config.organizationUnitId = folder.id;
+    }
   }
-  return {
-    field,
-    operator,
-    value
-  };
-}
-function normalizeField(field) {
-  const fieldMap = {
-    category: "category",
-    cat: "category",
-    type: "type",
-    nodetype: "nodetype",
-    node_type: "nodetype",
-    tags: "tags",
-    tag: "tags",
-    displayname: "displayname",
-    display_name: "displayname",
-    displayName: "displayname",
-    name: "displayname",
-    label: "displayname"
-  };
-  const normalized = field.toLowerCase().replace(/[-_\s]/g, "");
-  return fieldMap[normalized] || field;
-}
-function isValidField(field) {
-  const validFields = [
-    "category",
-    "type",
-    "tags",
-    "displayname",
-    "nodetype",
-    "description"
-  ];
-  return validFields.includes(field);
-}
-function isValidOperator(operator) {
-  const validOperators = [
-    "equals",
-    "contains",
-    "in",
-    "startsWith",
-    "endsWith"
-  ];
-  return validOperators.includes(operator);
-}
-
-// ../maestro-sdk/src/registry/command.ts
-function flattenNodeForDisplay(n) {
-  return {
-    NodeType: n.nodeType,
-    Category: n.category ?? "",
-    DisplayName: n.display?.label ?? "",
-    Description: n.description ?? n.display?.description ?? "",
-    Version: n.version ?? "",
-    Tags: (n.tags ?? []).join(", ")
-  };
-}
-async function missingProcessResourceHint() {
-  const {
-    describeProjectsWithoutProcessResource,
-    findProjectsWithoutProcessResource,
-    findSolutionFromCwd
-  } = await import("./solution-discovery-6t0z143v.js");
-  const ctx = await findSolutionFromCwd();
-  if (!ctx)
-    return {};
-  return describeProjectsWithoutProcessResource(await findProjectsWithoutProcessResource(ctx), ctx.solutionDir);
-}
-async function localResultNotes(contractWarning) {
-  const hint = await missingProcessResourceHint();
-  const warnings = [hint.Warning, contractWarning].filter((w) => typeof w === "string");
-  return {
-    ...hint,
-    ...warnings.length > 0 ? { Warning: warnings.join(" ") } : {}
-  };
-}
-async function explainNodeTypeWithoutProcessResource(nodeType) {
-  const discovery = await import("./solution-discovery-6t0z143v.js");
-  const [, explanation] = await catchError(discovery.explainNodeTypeWithoutProcessResource(nodeType));
-  return explanation;
-}
-function flattenNodeWithAvailability(n, availableOnTenant) {
-  return {
-    ...flattenNodeForDisplay(n),
-    AvailableOnTenant: availableOnTenant
-  };
-}
-async function mergeWithKnownSdkNodes(tenantNodes) {
-  const { listKnownSdkNodes } = await import("./known-types-r51zxb9g.js");
-  const tenantTypes = new Set(tenantNodes.map((n) => n.nodeType?.toLowerCase()).filter((t) => typeof t === "string"));
-  const merged = tenantNodes.map((node) => ({ node, availableOnTenant: true }));
-  for (const known of listKnownSdkNodes()) {
-    const type = known.nodeType?.toLowerCase();
-    if (typeof type !== "string")
-      continue;
-    if (tenantTypes.has(type))
-      continue;
-    merged.push({ node: known, availableOnTenant: false });
+  const [error, result] = await catchError2(fn(config));
+  if (error) {
+    const msg = await extractErrorMessage(error);
+    logger.warn(`${errorMessage}: ${msg}`);
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: errorMessage,
+      Instructions: msg
+    });
+    processContext.exit(1);
+    return;
   }
-  return merged;
-}
-var ALL_NODES = -1;
-function parseListLimit(raw) {
-  return raw.trim() === String(ALL_NODES) ? ALL_NODES : parseLimit(raw);
-}
-function shownRows(count, offset) {
-  return offset === 0 ? `first ${count}` : `${count} from offset ${offset}`;
+  return result;
 }
-var registerRegistryCommand = (program, commandPrefix) => {
-  const cmd = `uip ${commandPrefix} registry`;
-  const registry = program.command("registry").description(`Browse and search the ${commandPrefix} node registry to discover available activities and connectors (OOTB + authenticated). Use 'pull' to sync, 'search' to find nodes, 'get' to inspect a node's full input/output schema.`).addHelpText("after", `
-Typical workflow:
-  0. Login for full registry (optional, OOTB nodes available without login):
-                          uip login
-  1. Sync the registry:   ${cmd} pull
-  2. Search for a node:   ${cmd} search slack
-  3. Inspect its schema:  ${cmd} get <node-type>
-  4. Extract input fields: ${cmd} get <node-type> --output-filter "Node.inputDefinition.fields"
-
-Note: Without login, only built-in (OOTB) nodes are available. Login to access the full node registry including custom connectors.
-
-In-solution discovery (--local):
-  Run from inside a solution project directory (with a .uipx file in CWD, parent, or grandparent).
-  Shows sibling projects (Agent, Process, Flow, Api) as invokable nodes.
-  cd MySolution/MyFlow && ${cmd} list --local
 
-Subcommands:
-  pull    Fetch and cache the full node registry (run once per session)
-  list    List cached nodes (default: first 20, --limit -1 for everything)
-  search  Find nodes by keyword and/or field filters  ← start here
-  get     Get full schema for a single node (with connector input/output enrichment)`);
-  const pullExamples = [
-    {
-      Description: "Sync the node registry",
-      Command: `${cmd} pull`,
-      Output: {
-        Code: "NodePullSuccess",
-        Data: {
-          NodesCount: 184,
-          FromCache: false,
-          Source: "authenticated",
-          CacheWritten: true,
-          Message: "Synced fresh nodes"
+// ../maestro-sdk/src/shared-commands/examples.ts
+var INSTANCE = "f4a1c2b3-0000-4000-8000-000000000001";
+var FOLDER = "b2c3d4e5-0000-4000-8000-000000000002";
+var PROCESS = "c3d4e5f6-0000-4000-8000-000000000003";
+var INCIDENT = "d4e5f6a7-0000-4000-8000-000000000004";
+var ELEMENT = "Task_Review";
+var SOLUTION = "e5f6a7b8-0000-4000-8000-000000000009";
+var PROJECT = "f6a7b8c9-0000-4000-8000-00000000000a";
+var operation = (verb, code, description, status) => (prefix) => ({
+  Description: description,
+  Command: `${prefix} instances ${verb} ${INSTANCE} --folder-key ${FOLDER}`,
+  Output: { Code: code, Data: { InstanceId: INSTANCE, Status: status } }
+});
+var EXAMPLES = {
+  "instances list": (prefix) => ({
+    Description: "List the faulted instances in a folder",
+    Command: `${prefix} instances list --folder-key ${FOLDER} --status Faulted --limit 2`,
+    Output: {
+      Code: "InstanceList",
+      Data: [
+        {
+          InstanceId: INSTANCE,
+          InstanceDisplayName: "Claim 1042",
+          ProcessKey: PROCESS,
+          PackageVersion: "1.0.3",
+          LatestRunStatus: "Faulted",
+          StartedTime: "2026-10-13T09:12:00Z"
         }
-      }
+      ]
     }
-  ];
-  const listExamples = [
-    {
-      Description: "List cached nodes (every row carries AvailableOnTenant; FF-gated SDK-known nodes are included)",
-      Command: `${cmd} list --limit 2`,
-      Output: {
-        Code: "NodeListSuccess",
-        Data: [
-          {
-            NodeType: "uipath.slack.connector.send-message",
-            Category: "connector",
-            DisplayName: "Send Message",
-            Description: "Post a message to a Slack channel",
-            Version: "1.0.0",
-            Tags: "slack, messaging",
-            AvailableOnTenant: true
-          },
+  }),
+  "instances get": (prefix) => ({
+    Description: "Get one instance and its latest run",
+    Command: `${prefix} instances get ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceGet",
+      Data: {
+        InstanceId: INSTANCE,
+        InstanceDisplayName: "Claim 1042",
+        ProcessKey: PROCESS,
+        PackageVersion: "1.0.3",
+        LatestRunStatus: "Running",
+        StartedTime: "2026-10-13T09:12:00Z",
+        CompletedTime: null
+      }
+    }
+  }),
+  "instances pause": operation("pause", "InstancePaused", "Pause a running instance", "Paused"),
+  "instances resume": operation("resume", "InstanceResumed", "Resume a paused instance", "Running"),
+  "instances cancel": operation("cancel", "InstanceCanceled", "Cancel an instance", "Canceling"),
+  "instances retry": operation("retry", "InstanceRetried", "Retry a faulted instance from where it failed", "Running"),
+  "instances variables": (prefix) => ({
+    Description: "Read an instance's variables",
+    Command: `${prefix} instances variables ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceVariables",
+      Data: {
+        InstanceId: INSTANCE,
+        ParentElementId: null,
+        GlobalVariables: [
           {
-            NodeType: "uipath.human-in-the-loop",
-            Category: "human-task",
-            DisplayName: "Human in the Loop",
-            Description: "Assign a task to a human and wait for completion",
-            Version: "1.0.0",
-            Tags: "human-task, hitl, human-in-the-loop, approval",
-            AvailableOnTenant: false
+            Id: "claimAmount",
+            Name: "claimAmount",
+            Type: "number",
+            Value: 1200,
+            ElementId: "root",
+            Source: "=vars.claimAmount"
           }
-        ]
+        ],
+        Elements: []
       }
     }
-  ];
-  const searchExamples = [
-    {
-      Description: "Search nodes by keyword (every row carries AvailableOnTenant; FF-gated SDK-known nodes are included)",
-      Command: `${cmd} search slack`,
-      Output: {
-        Code: "NodeSearchSuccess",
-        Data: [
+  }),
+  "instances variables-all": (prefix) => ({
+    Description: "Read the variables of every scope in an instance",
+    Command: `${prefix} instances variables-all ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceVariablesAll",
+      Data: {
+        Variables: [
           {
-            NodeType: "uipath.slack.connector.send-message",
-            Category: "connector",
-            DisplayName: "Send Message",
-            Description: "Post a message to a Slack channel",
-            Version: "1.0.0",
-            Tags: "slack, messaging",
-            AvailableOnTenant: true
+            InstanceId: INSTANCE,
+            ParentElementId: null,
+            GlobalVariables: [],
+            Elements: []
           }
         ]
       }
     }
-  ];
-  const getExamples = [
-    {
-      Description: "Get the full schema for a node",
-      Command: `${cmd} get uipath.slack.connector.send-message`,
-      Output: {
-        Code: "NodeGetSuccess",
-        Data: {
-          Node: {
-            nodeType: "uipath.slack.connector.send-message",
-            category: "connector",
-            display: { label: "Send Message" },
-            inputDefinition: {
-              fields: [{ name: "channel", required: true }]
-            }
-          }
-        }
+  }),
+  "instances global-variables": (prefix) => ({
+    Description: "Read an instance's global variables",
+    Command: `${prefix} instances global-variables ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceGlobalVariables",
+      Data: {
+        InstanceId: INSTANCE,
+        Globals: { claimAmount: 1200 },
+        Count: 1,
+        RetrievedAt: "2026-10-13T09:20:00Z"
       }
     }
-  ];
-  registry.command("pull").description(`Pull and sync node data from ${commandPrefix} registry (login first for full registry)`).option("-f, --force", "Force refresh, ignore cache").examples(pullExamples).trackedAction(processContext, async (options) => {
-    const { MANIFEST_VALIDATION_NEXT_STEP, pullNodes } = await import("./node-sync-service-76b9e4r5.js");
-    const [error, result] = await catchError(pullNodes({
-      force: options.force
-    }));
-    if (error) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error pulling nodes",
-        Instructions: error.message
-      });
-      processContext.exit(1);
-      return;
+  }),
+  "instances variables-set": (prefix) => ({
+    Description: "Patch variables on a running instance from a file",
+    Command: `${prefix} instances variables-set ${INSTANCE} --folder-key ${FOLDER} --inputs @patch.json`,
+    Output: {
+      Code: "InstanceVariablesSet",
+      Data: {}
     }
-    if (result.failures?.length) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: `The tenant manifest failed validation, so the pull returned only ${result.syncedCount} OOTB nodes; the cache was not updated`,
-        Instructions: `registry get/search keep serving the previous cache, if there is one. ${MANIFEST_VALIDATION_NEXT_STEP} The validation error is in Data.Failures.`,
-        Retry: "RetryWillNotFix",
-        Data: {
-          NodesCount: result.syncedCount,
-          Source: result.source,
-          CacheWritten: false,
-          Failures: result.failures.map((f) => ({
-            Source: f.source,
-            Reason: f.reason
-          }))
+  }),
+  "instances incidents": (prefix) => ({
+    Description: "List the incidents an instance raised",
+    Command: `${prefix} instances incidents ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceIncidents",
+      Data: [
+        {
+          IncidentId: INCIDENT,
+          InstanceId: INSTANCE,
+          ElementId: ELEMENT,
+          IncidentStatus: "Open",
+          ErrorCode: "TaskFailed",
+          ErrorMessage: "The action app returned an error"
         }
-      });
-      processContext.exit(1);
-      return;
+      ]
     }
-    const missing = result.missingSources ?? [];
-    const base = result.fromCache ? `Using cached nodes (age: ${result.ageMinutes}m)` : "Synced fresh nodes";
-    const message = missing.length ? `${base}; missing node sources: ${missing.map((m) => m.source).join(", ")}` : base;
-    const finalMessage = result.info ? `${message}. ${result.info}` : message;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "NodePullSuccess",
+  }),
+  "instances asset": (prefix) => ({
+    Description: "Get the asset an instance runs",
+    Command: `${prefix} instances asset ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: { Code: "InstanceAsset", Data: {} }
+  }),
+  "instances migrate": (prefix) => ({
+    Description: "Move an instance to a newer package version",
+    Command: `${prefix} instances migrate ${INSTANCE} 1.0.4 --folder-key ${FOLDER} --comment "Fix review step"`,
+    Output: {
+      Code: "InstanceMigrated",
+      Data: { InstanceId: INSTANCE, Status: "Running" }
+    }
+  }),
+  "instances goto": (prefix) => ({
+    Description: "Move an instance's cursor from one element to another",
+    Command: `${prefix} instances goto ${INSTANCE} '[{"sourceElementId":"${ELEMENT}","targetElementId":"Task_Approve"}]' --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceGoto",
+      Data: { InstanceId: INSTANCE, Status: "Running" }
+    }
+  }),
+  "instances cursors": (prefix) => ({
+    Description: "List the elements an instance is currently at",
+    Command: `${prefix} instances cursors ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceCursors",
+      Data: { ElementIds: [ELEMENT] }
+    }
+  }),
+  "instances messages send": (prefix) => ({
+    Description: "Send a message to the instances waiting for it",
+    Command: `${prefix} instances messages send --folder-key ${FOLDER} --inputs @message.json`,
+    Output: {
+      Code: "MessageSent",
       Data: {
-        NodesCount: result.syncedCount,
-        FromCache: result.fromCache,
-        AgeMinutes: result.ageMinutes,
-        Source: result.source,
-        CacheWritten: result.cacheWritten,
-        Message: finalMessage,
-        Info: result.info,
-        ...missing.length > 0 && {
-          MissingSources: missing.map((m) => ({
-            Source: m.source,
-            Reason: m.reason
-          }))
-        }
-      }
-    });
-  });
-  registry.command("list").description("Sample cached nodes to inspect their config structure (default: first 20). Output merges tenant nodes with the SDK-known catalog; every row carries `AvailableOnTenant` so callers can filter FF-gated rows. Use 'search' to find nodes — use --limit -1 only if you need the full list (the result can be huge and unreadable).").addHelpText("after", `
-Examples:
-  ${cmd} list
-  ${cmd} list --limit 200
-  ${cmd} list --limit -1
-
-In-solution (--local):
-  cd MySolution/MyFlow && ${cmd} list --local`).option("-l, --limit <n>", "Number of nodes to return (1-10000, default: 20, -1 for all)", parseListLimit, 20).option("--offset <number>", "Number of nodes to skip (0-1000000)", parseOffset, 0).option("--local", "Show only in-solution project nodes (requires .uipx in CWD, parent, or grandparent). Omits `AvailableOnTenant` (no tenant lookup).").examples(listExamples).trackedAction(processContext, async (options) => {
-    const {
-      getLocalSolutionSnapshot,
-      listNodes,
-      localContractWarning
-    } = await import("./node-sync-service-76b9e4r5.js");
-    const showAll = options.limit === ALL_NODES;
-    if (options.local) {
-      const [error2, snapshot] = await catchError(getLocalSolutionSnapshot());
-      if (error2) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error listing nodes",
-          Instructions: error2.message
-        });
-        processContext.exit(1);
-        return;
+        Id: "e5f6a7b8-0000-4000-8000-000000000005",
+        JobId: "f6a7b8c9-0000-4000-8000-000000000006"
       }
-      const localNodes = snapshot.manifests;
-      const totalCount2 = localNodes.length;
-      const effectiveLimit2 = showAll ? totalCount2 : options.limit;
-      const nodes = localNodes.slice(options.offset, options.offset + effectiveLimit2);
-      const truncated2 = options.offset + nodes.length < totalCount2;
-      const warning = localContractWarning(snapshot, nodes);
-      OutputFormatter.success({
-        Result: RESULTS.Success,
-        Code: "NodeListSuccess",
-        Data: nodes.map(flattenNodeForDisplay),
-        Pagination: new Pagination({
-          returned: nodes.length,
-          limit: effectiveLimit2,
-          offset: options.offset,
-          total: totalCount2
-        }),
-        ...await localResultNotes(warning)
-      });
-      if (truncated2) {
-        logger.info(`Showing ${shownRows(nodes.length, options.offset)} of ${totalCount2}. Use --limit, --offset or --limit -1 to get more, or use 'search' to filter.`);
+    }
+  }),
+  "instances element-executions": (prefix) => ({
+    Description: "List how each element of an instance ran",
+    Command: `${prefix} instances element-executions ${INSTANCE} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "InstanceElementExecutions",
+      Data: {
+        InstanceId: INSTANCE,
+        ProcessKey: PROCESS,
+        Status: "Running",
+        ElementExecutions: [
+          {
+            ElementId: ELEMENT,
+            ElementType: "UserTask",
+            Status: "Completed",
+            StartedTimeUtc: "2026-10-13T09:12:05Z"
+          }
+        ]
       }
-      return;
     }
-    const [error, tenantNodes] = await catchError(listNodes());
-    if (error) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error listing nodes",
-        Instructions: error.message
-      });
-      processContext.exit(1);
-      return;
-    }
-    const merged = await mergeWithKnownSdkNodes(tenantNodes);
-    const totalCount = merged.length;
-    const effectiveLimit = showAll ? totalCount : options.limit;
-    const slice = merged.slice(options.offset, options.offset + effectiveLimit);
-    const truncated = options.offset + slice.length < totalCount;
-    const gatedCount = merged.filter((m) => !m.availableOnTenant).length;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "NodeListSuccess",
-      Data: slice.map((m) => flattenNodeWithAvailability(m.node, m.availableOnTenant)),
-      Pagination: new Pagination({
-        returned: slice.length,
-        limit: effectiveLimit,
-        offset: options.offset,
-        total: totalCount
-      })
-    });
-    if (truncated) {
-      logger.info(`Showing ${shownRows(slice.length, options.offset)} of ${totalCount} (${gatedCount} not enabled on this tenant). Use --limit, --offset or --limit -1 to get more.`);
-    } else if (gatedCount > 0) {
-      logger.info(`${gatedCount} of ${totalCount} node type(s) are not enabled on this tenant (AvailableOnTenant=false).`);
-    }
-  });
-  registry.command("search").description("Find nodes by keyword and/or field filters").addHelpText("after", `
-Filter syntax:
-  field=value                    equality (default operator)
-  field:contains=value           field contains value
-  field:startsWith=value         field starts with value
-  field:endsWith=value           field ends with value
-  field:in=value1,value2         field matches any of the values
-  field1=v1,field2=v2            multiple conditions (AND logic)
-
-Filterable fields:
-  category / cat                 e.g. "connector", "agent"
-  type / nodetype                node type identifier
-  tags / tag                     node tags
-  displayname / name / label     human-readable display name
-
-Examples:
-  ${cmd} search slack
-  ${cmd} search --filter "category=connector"
-  ${cmd} search --filter "displayname:contains=send message"
-  ${cmd} search slack --filter "category=connector"
-  ${cmd} search --filter "tags:in=ai,automation"
-  ${cmd} search --filter "category=connector,displayname:contains=slack"
-
-Tip: pipe through --output-filter to extract just the nodeType values:
-  ${cmd} search slack --output-filter "[*].NodeType"
-
-In-solution (--local):
-  cd MySolution/MyFlow && ${cmd} search agent --local`).argument("[keyword]", "Search term matched against nodeType, category, tags, display name, and description").option("-f, --filter <filter>", "Structured field filter: field=value or field:operator=value. Comma-separated = AND. Fields: category, type, tags, displayname, description.").option("--local", "Search only in-solution project nodes (requires .uipx in CWD, parent, or grandparent). Omits `AvailableOnTenant` (no tenant lookup).").examples(searchExamples).trackedAction(processContext, async (keyword, options) => {
-    let parsedFilters;
-    if (options.filter) {
-      const [parseError, parsed] = catchError(() => parseFilterString(options.filter));
-      if (parseError) {
-        if (parseError instanceof FilterParseError) {
-          OutputFormatter.error({
-            Result: RESULTS.Failure,
-            Message: "Invalid filter syntax",
-            Instructions: `${parseError.message} Examples: category=agent, displayname:contains=http, tags:in=ai,automation.`
-          });
-          processContext.exit(1);
-          return;
-        }
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error searching nodes",
-          Instructions: parseError.message
-        });
-        processContext.exit(1);
-        return;
-      }
-      parsedFilters = parsed;
-    }
-    if (!keyword && !parsedFilters) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Search requires either a keyword or filters",
-        Instructions: "Provide a keyword or use --filter flag"
-      });
-      processContext.exit(1);
-      return;
-    }
-    const {
-      filterNodesByKeyword,
-      getLocalSolutionSnapshot,
-      localContractWarning,
-      searchNodeSummariesWithAvailability,
-      searchNodes,
-      searchNodesWithFilters
-    } = await import("./node-sync-service-76b9e4r5.js");
-    const searchLocal = () => parsedFilters ? searchNodesWithFilters(keyword, parsedFilters, {
-      local: true
-    }) : searchNodes(keyword, { local: true });
-    if (options.local) {
-      const [searchError2, snapshot] = await catchError(getLocalSolutionSnapshot());
-      if (searchError2) {
-        OutputFormatter.error({
-          Result: RESULTS.Failure,
-          Message: "Error searching nodes",
-          Instructions: searchError2.message
-        });
-        processContext.exit(1);
-        return;
-      }
-      const { searchWithFilters } = await import("./filter-engine-7ep90g7f.js");
-      const results2 = parsedFilters ? searchWithFilters(snapshot.manifests, keyword, parsedFilters) : filterNodesByKeyword(snapshot.manifests, keyword);
-      const warning2 = localContractWarning(snapshot, results2);
-      OutputFormatter.success({
-        Result: RESULTS.Success,
-        Code: "NodeSearchSuccess",
-        Data: results2.map(flattenNodeForDisplay),
-        ...await localResultNotes(warning2)
-      });
-      return;
-    }
-    const [searchError, results] = await catchError(searchNodeSummariesWithAvailability(keyword, parsedFilters));
-    if (searchError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error searching nodes",
-        Instructions: searchError.message
-      });
-      processContext.exit(1);
-      return;
-    }
-    let warning;
-    if (results.length === 0) {
-      const [, localMatches] = await catchError(searchLocal());
-      if (localMatches && localMatches.length > 0) {
-        warning = `No tenant node matches, but ${localMatches.length} node(s) from projects in this solution do. Re-run the same search with --local.`;
-      }
-    }
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "NodeSearchSuccess",
-      Data: results.map((result) => flattenNodeWithAvailability(result.node, result.availableOnTenant)),
-      ...warning ? { Warning: warning } : {}
-    });
-  });
-  registry.command("get").description("Get the full schema for a single node. For connector nodes (uipath.connector.*), the base manifest is automatically enriched with live metadata from Integration Service.").addHelpText("after", `
-IS-enriched fields (connector nodes only, fetched live from Integration Service):
-
-  Activity nodes (uipath.connector.*, not trigger):
-    inputDefinition.fields    Fields to configure. Each field has: name, displayName, type, required, and optionally reference (lookup: objectName, path, lookupValue, lookupNames, childPath; 4.0.0 activities carry scriptRef instead of objectName — resolve with 'uip is resources run script --script-ref') or enum.
-    outputResponseDefinition  Fields produced after the node runs.
-    connectorMethodInfo       HTTP details (method, path, operationId).
-    --connection-id optional — adds custom fields specific to that account.
-
-  Trigger nodes (uipath.connector.trigger.*):
-    eventParameters           Fields that configure the trigger (e.g. which folder to watch).
-    filterFields              Fields used to filter which events fire the trigger.
-    outputResponseDefinition  Fields produced by the trigger event payload.
-    eventMode                 "webhooks" or "polling".
-    login + --connection-id required — without both, no enrichment is returned.
-
-Examples:
-  ${cmd} get uipath.slack.connector.send-message
-  ${cmd} get uipath.connector.uipath-salesforce-slack.send-message --connection-id <id>
-  ${cmd} get uipath.connector.trigger.uipath-microsoft-outlook365.email-received --connection-id <id>
-
-In-solution (--local):
-  cd MySolution/MyFlow && ${cmd} get <node-type> --local`).argument("<node-type>", `Node type identifier — get it from '${cmd} search'`).option("--connection-id <id>", "Connection ID for Integration Service connector node enrichment. Required for connector trigger nodes; optional for connector activity nodes.").option("--local", "Get node from in-solution projects only (requires .uipx in CWD, parent, or grandparent)").examples(getExamples).trackedAction(processContext, async (nodeType, options) => {
-    const { getLocalNodeEnriched, getNode, getNodeEnriched } = await import("./node-sync-service-76b9e4r5.js");
-    const [error, lookedUp] = await catchError(options.local ? getLocalNodeEnriched(nodeType, options.connectionId) : getNodeEnriched(nodeType, options.connectionId, {
-      local: options.local
-    }).then((node) => ({ node, warning: undefined })));
-    if (error) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error retrieving node",
-        Instructions: error.message
-      });
-      processContext.exit(1);
-      return;
-    }
-    const result = lookedUp?.node;
-    const warning = lookedUp?.warning;
-    if (!result) {
-      const [, inSolution] = options.local ? [undefined, null] : await catchError(getNode(nodeType, { local: true }));
-      const withoutProcessResource = inSolution ? undefined : await explainNodeTypeWithoutProcessResource(nodeType);
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: withoutProcessResource?.message ?? "Node not found",
-        Instructions: withoutProcessResource?.instructions ?? (inSolution ? `'${nodeType}' is a node of a project in this solution, which only --local looks up. Run: ${cmd} get ${nodeType} --local` : `No node found with node type: ${nodeType}`),
-        ErrorCode: "not_found"
-      });
-      processContext.exit(1);
-      return;
-    }
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "NodeGetSuccess",
-      Data: {
-        Node: result
-      },
-      ...warning ? { Warning: warning } : {}
-    }, { preserveDataKeys: true });
-  });
-};
-
-// ../maestro-sdk/src/with-debug-pims-call.ts
-async function createDebugPimsConfig() {
-  const status = await getLoginStatusAsync({
-    ensureTokenValidityMinutes: 10
-  });
-  if (status.loginStatus !== "Logged in" || !status.baseUrl || !status.accessToken) {
-    throw new Error(status.hint ? `Not logged in. ${status.hint}` : "Not logged in. Run 'uip login' first.");
-  }
-  if (!status.organizationId) {
-    throw new Error("Organization ID not available. Ensure you are logged in with an organization context.");
-  }
-  if (!status.tenantId) {
-    throw new Error("Tenant ID not available. Ensure UIPATH_TENANT_ID is set.");
-  }
-  if (!status.tenantName) {
-    throw new Error("Tenant name not available. Ensure you are logged in with a tenant context.");
-  }
-  return {
-    baseUrl: status.baseUrl,
-    organizationId: status.organizationId,
-    tenantName: status.tenantName,
-    tenantId: status.tenantId,
-    authToken: status.accessToken
-  };
-}
-async function withDebugPimsCall(fn, errorMessage) {
-  const [configError, config] = await catchError(createDebugPimsConfig());
-  if (configError) {
-    logger.warn(`${errorMessage}: ${configError.message}`);
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: errorMessage,
-      Instructions: configError.message
-    });
-    processContext.exit(1);
-    return;
-  }
-  if (!config.folderKey) {
-    const [folderError, folder] = await catchError(getPersonalFolderKey(config));
-    if (folderError) {
-      logger.warn(`Could not resolve personal folder: ${folderError.message}`);
-    } else {
-      config.folderKey = folder.key;
-      config.organizationUnitId = folder.id;
-    }
-  }
-  const [error, result] = await catchError(fn(config));
-  if (error) {
-    const msg = await extractErrorMessage(error);
-    logger.warn(`${errorMessage}: ${msg}`);
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: errorMessage,
-      Instructions: msg
-    });
-    processContext.exit(1);
-    return;
-  }
-  return result;
-}
-
-// ../maestro-sdk/src/shared-commands/examples.ts
-var INSTANCE = "f4a1c2b3-0000-4000-8000-000000000001";
-var FOLDER = "b2c3d4e5-0000-4000-8000-000000000002";
-var PROCESS = "c3d4e5f6-0000-4000-8000-000000000003";
-var INCIDENT = "d4e5f6a7-0000-4000-8000-000000000004";
-var ELEMENT = "Task_Review";
-var SOLUTION = "e5f6a7b8-0000-4000-8000-000000000009";
-var PROJECT = "f6a7b8c9-0000-4000-8000-00000000000a";
-var operation = (verb, code, description, status) => (prefix) => ({
-  Description: description,
-  Command: `${prefix} instance ${verb} ${INSTANCE} --folder-key ${FOLDER}`,
-  Output: { Code: code, Data: { InstanceId: INSTANCE, Status: status } }
-});
-var EXAMPLES = {
-  "instance list": (prefix) => ({
-    Description: "List the faulted instances in a folder",
-    Command: `${prefix} instance list --folder-key ${FOLDER} --status Faulted --limit 2`,
-    Output: {
-      Code: "InstanceList",
-      Data: [
-        {
-          InstanceId: INSTANCE,
-          InstanceDisplayName: "Claim 1042",
-          ProcessKey: PROCESS,
-          PackageVersion: "1.0.3",
-          LatestRunStatus: "Faulted",
-          StartedTime: "2026-10-13T09:12:00Z"
-        }
-      ]
-    }
-  }),
-  "instance get": (prefix) => ({
-    Description: "Get one instance and its latest run",
-    Command: `${prefix} instance get ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceGet",
-      Data: {
-        InstanceId: INSTANCE,
-        InstanceDisplayName: "Claim 1042",
-        ProcessKey: PROCESS,
-        PackageVersion: "1.0.3",
-        LatestRunStatus: "Running",
-        StartedTime: "2026-10-13T09:12:00Z",
-        CompletedTime: null
-      }
-    }
-  }),
-  "instance pause": operation("pause", "InstancePaused", "Pause a running instance", "Paused"),
-  "instance resume": operation("resume", "InstanceResumed", "Resume a paused instance", "Running"),
-  "instance cancel": operation("cancel", "InstanceCanceled", "Cancel an instance", "Canceling"),
-  "instance retry": operation("retry", "InstanceRetried", "Retry a faulted instance from where it failed", "Running"),
-  "instance variables": (prefix) => ({
-    Description: "Read an instance's variables",
-    Command: `${prefix} instance variables ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceVariables",
-      Data: {
-        InstanceId: INSTANCE,
-        ParentElementId: null,
-        GlobalVariables: [
-          {
-            Id: "claimAmount",
-            Name: "claimAmount",
-            Type: "number",
-            Value: 1200,
-            ElementId: "root",
-            Source: "=vars.claimAmount"
-          }
-        ],
-        Elements: []
-      }
-    }
-  }),
-  "instance variables-all": (prefix) => ({
-    Description: "Read the variables of every scope in an instance",
-    Command: `${prefix} instance variables-all ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceVariablesAll",
-      Data: {
-        Variables: [
-          {
-            InstanceId: INSTANCE,
-            ParentElementId: null,
-            GlobalVariables: [],
-            Elements: []
-          }
-        ]
-      }
-    }
-  }),
-  "instance global-variables": (prefix) => ({
-    Description: "Read an instance's global variables",
-    Command: `${prefix} instance global-variables ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceGlobalVariables",
-      Data: {
-        InstanceId: INSTANCE,
-        Globals: { claimAmount: 1200 },
-        Count: 1,
-        RetrievedAt: "2026-10-13T09:20:00Z"
-      }
-    }
-  }),
-  "instance variables-set": (prefix) => ({
-    Description: "Patch variables on a running instance from a file",
-    Command: `${prefix} instance variables-set ${INSTANCE} --folder-key ${FOLDER} --inputs @patch.json`,
-    Output: {
-      Code: "InstanceVariablesSet",
-      Data: {}
-    }
-  }),
-  "instance incidents": (prefix) => ({
-    Description: "List the incidents an instance raised",
-    Command: `${prefix} instance incidents ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceIncidents",
-      Data: [
-        {
-          IncidentId: INCIDENT,
-          InstanceId: INSTANCE,
-          ElementId: ELEMENT,
-          IncidentStatus: "Open",
-          ErrorCode: "TaskFailed",
-          ErrorMessage: "The action app returned an error"
-        }
-      ]
-    }
-  }),
-  "instance asset": (prefix) => ({
-    Description: "Get the asset an instance runs",
-    Command: `${prefix} instance asset ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: { Code: "InstanceAsset", Data: {} }
-  }),
-  "instance migrate": (prefix) => ({
-    Description: "Move an instance to a newer package version",
-    Command: `${prefix} instance migrate ${INSTANCE} 1.0.4 --folder-key ${FOLDER} --comment "Fix review step"`,
-    Output: {
-      Code: "InstanceMigrated",
-      Data: { InstanceId: INSTANCE, Status: "Running" }
-    }
-  }),
-  "instance goto": (prefix) => ({
-    Description: "Move an instance's cursor from one element to another",
-    Command: `${prefix} instance goto ${INSTANCE} '[{"sourceElementId":"${ELEMENT}","targetElementId":"Task_Approve"}]' --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceGoto",
-      Data: { InstanceId: INSTANCE, Status: "Running" }
-    }
-  }),
-  "instance cursors": (prefix) => ({
-    Description: "List the elements an instance is currently at",
-    Command: `${prefix} instance cursors ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceCursors",
-      Data: { ElementIds: [ELEMENT] }
-    }
-  }),
-  "instance message send": (prefix) => ({
-    Description: "Send a message to the instances waiting for it",
-    Command: `${prefix} instance message send --folder-key ${FOLDER} --inputs @message.json`,
-    Output: {
-      Code: "MessageSent",
-      Data: {
-        Id: "e5f6a7b8-0000-4000-8000-000000000005",
-        JobId: "f6a7b8c9-0000-4000-8000-000000000006"
-      }
-    }
-  }),
-  "instance element-executions": (prefix) => ({
-    Description: "List how each element of an instance ran",
-    Command: `${prefix} instance element-executions ${INSTANCE} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "InstanceElementExecutions",
-      Data: {
-        InstanceId: INSTANCE,
-        ProcessKey: PROCESS,
-        Status: "Running",
-        ElementExecutions: [
-          {
-            ElementId: ELEMENT,
-            ElementType: "UserTask",
-            Status: "Completed",
-            StartedTimeUtc: "2026-10-13T09:12:05Z"
-          }
-        ]
-      }
-    }
-  }),
-  "instance element cancel": (prefix) => ({
-    Description: "Cancel one running element of an instance",
-    Command: `${prefix} instance element cancel ${INSTANCE} ${ELEMENT} --folder-key ${FOLDER}`,
-    Output: {
-      Code: "ElementCanceled",
-      Data: { InstanceId: INSTANCE, Status: "Running" }
+  }),
+  "instances elements cancel": (prefix) => ({
+    Description: "Cancel one running element of an instance",
+    Command: `${prefix} instances elements cancel ${INSTANCE} ${ELEMENT} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ElementCanceled",
+      Data: { InstanceId: INSTANCE, Status: "Running" }
     }
   }),
-  "instance element retry": (prefix) => ({
+  "instances elements retry": (prefix) => ({
     Description: "Retry one faulted element of an instance",
-    Command: `${prefix} instance element retry ${INSTANCE} ${ELEMENT} --folder-key ${FOLDER}`,
+    Command: `${prefix} instances elements retry ${INSTANCE} ${ELEMENT} --folder-key ${FOLDER}`,
     Output: {
       Code: "ElementRetried",
       Data: { InstanceId: INSTANCE, Status: "Running" }
     }
   }),
-  "incident summary": (prefix) => ({
+  "incidents summary": (prefix) => ({
     Description: "Summarize the open incidents in a folder by error",
-    Command: `${prefix} incident summary --folder-key ${FOLDER} --limit 2`,
+    Command: `${prefix} incidents summary --folder-key ${FOLDER} --limit 2`,
     Output: {
       Code: "IncidentSummary",
       Data: [
@@ -1059,9 +472,9 @@ var EXAMPLES = {
       ]
     }
   }),
-  "incident get": (prefix) => ({
+  "incidents get": (prefix) => ({
     Description: "Get one incident with its error details",
-    Command: `${prefix} incident get ${INCIDENT} --folder-key ${FOLDER}`,
+    Command: `${prefix} incidents get ${INCIDENT} --folder-key ${FOLDER}`,
     Output: {
       Code: "IncidentGet",
       Data: {
@@ -1220,9 +633,9 @@ var EXAMPLES = {
       ]
     }
   }),
-  "debug-instance create": (prefix) => ({
+  "debug-instances create": (prefix) => ({
     Description: "Start a debug run of an uploaded solution's entry point",
-    Command: `${prefix} debug-instance create --solution-id ${SOLUTION} --project-id ${PROJECT} --entry-point "/Main.bpmn#start" --debug-mode StepByStep`,
+    Command: `${prefix} debug-instances create --solution-id ${SOLUTION} --project-id ${PROJECT} --entry-point "/Main.bpmn#start" --debug-mode StepByStep`,
     Output: {
       Code: "DebugInstanceCreated",
       Data: {
@@ -1232,9 +645,9 @@ var EXAMPLES = {
       }
     }
   }),
-  "debug-instance status": (prefix) => ({
+  "debug-instances status": (prefix) => ({
     Description: "Check where a debug run is",
-    Command: `${prefix} debug-instance status ${INSTANCE}`,
+    Command: `${prefix} debug-instances status ${INSTANCE}`,
     Output: {
       Code: "DebugInstanceStatus",
       Data: {
@@ -1245,33 +658,33 @@ var EXAMPLES = {
       }
     }
   }),
-  "debug-instance breakpoints": (prefix) => ({
+  "debug-instances breakpoints": (prefix) => ({
     Description: "Replace a debug run's breakpoints from a file",
-    Command: `${prefix} debug-instance breakpoints ${INSTANCE} --inputs @breakpoints.json`,
+    Command: `${prefix} debug-instances breakpoints ${INSTANCE} --inputs @breakpoints.json`,
     Output: {
       Code: "DebugInstanceBreakpointsUpdated",
       Data: {}
     }
   }),
-  "debug-instance cancel": (prefix) => ({
+  "debug-instances cancel": (prefix) => ({
     Description: "Stop a debug run",
-    Command: `${prefix} debug-instance cancel ${INSTANCE}`,
+    Command: `${prefix} debug-instances cancel ${INSTANCE}`,
     Output: {
       Code: "DebugInstanceCanceled",
       Data: {}
     }
   }),
-  "debug-instance continue": (prefix) => ({
+  "debug-instances continue": (prefix) => ({
     Description: "Continue a paused debug run",
-    Command: `${prefix} debug-instance continue ${INSTANCE}`,
+    Command: `${prefix} debug-instances continue ${INSTANCE}`,
     Output: {
       Code: "DebugInstanceContinued",
       Data: {}
     }
   }),
-  "debug-instance incidents": (prefix) => ({
+  "debug-instances incidents": (prefix) => ({
     Description: "List the incidents a debug run raised",
-    Command: `${prefix} debug-instance incidents ${INSTANCE}`,
+    Command: `${prefix} debug-instances incidents ${INSTANCE}`,
     Output: {
       Code: "DebugInstanceIncidents",
       Data: [
@@ -1283,25 +696,25 @@ var EXAMPLES = {
       ]
     }
   }),
-  "debug-instance variables": (prefix) => ({
+  "debug-instances variables": (prefix) => ({
     Description: "Read a paused debug run's variables",
-    Command: `${prefix} debug-instance variables ${INSTANCE}`,
+    Command: `${prefix} debug-instances variables ${INSTANCE}`,
     Output: {
       Code: "DebugInstanceVariables",
       Data: { InstanceId: INSTANCE, Globals: {}, Elements: [] }
     }
   }),
-  "debug-instance variables-set": (prefix) => ({
+  "debug-instances variables-set": (prefix) => ({
     Description: "Patch a paused debug run's variables from a file",
-    Command: `${prefix} debug-instance variables-set ${INSTANCE} --inputs @patch.json`,
+    Command: `${prefix} debug-instances variables-set ${INSTANCE} --inputs @patch.json`,
     Output: {
       Code: "DebugInstanceVariablesSet",
       Data: {}
     }
   }),
-  "debug-instance variables-all": (prefix) => ({
+  "debug-instances variables-all": (prefix) => ({
     Description: "Read the variables of every scope in a debug run",
-    Command: `${prefix} debug-instance variables-all ${INSTANCE}`,
+    Command: `${prefix} debug-instances variables-all ${INSTANCE}`,
     Output: {
       Code: "DebugInstanceVariablesAll",
       Data: { Variables: [] }
@@ -1340,11 +753,11 @@ var attachSharedExamples = (group) => {
 
 // ../maestro-sdk/src/shared-commands/debug-instances.ts
 var DEBUG_API_PREFIX = "/api/v1/debug-instances";
-var VALID_DEBUG_MODES = Object.keys(DEBUG_MODE_MAP);
-var VALID_SIMULATION_MODES = Object.keys(SIMULATION_MODE_MAP);
+var VALID_DEBUG_MODES = Object.keys(DEBUG_MODE_MAP2);
+var VALID_SIMULATION_MODES = Object.keys(SIMULATION_MODE_MAP2);
 var registerSharedDebugInstanceCommands = (program, config) => {
   const { toolLabel } = config;
-  const debugInstance = program.command("debug-instance").description(`Manage ${toolLabel} debug instance operations`);
+  const debugInstance = program.command("debug-instances").alias("debug-instance").description(`Manage ${toolLabel} debug instance operations`);
   debugInstance.command("create").description(`Create a ${toolLabel} debug instance from an already-uploaded solution`).requiredOption("--solution-id <id>", "Solution ID (from a previous upload or Studio Web)").requiredOption("--project-id <id>", "Studio Web project ID within the solution").requiredOption("--entry-point <path>", 'Entry point path (e.g. "/Main.bpmn#start")').option("--process-type <type>", "Process type", "processOrchestration").option("--debug-mode <mode>", "Debug mode: Default (pause at breakpoints), StepByStep (pause at every step), SingleStep (one step only)", "Default").option("--simulation-mode <mode>", "Simulation mode: None, All (simulate all elements), Selective (simulate except opt-outs)", "None").option("-i, --inputs <json>", "Input arguments as JSON string", "{}").trackedAction(processContext, async (options) => {
     if (!VALID_DEBUG_MODES.includes(options.debugMode)) {
       OutputFormatter.error({
@@ -1364,7 +777,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
       processContext.exit(1);
       return;
     }
-    const [configError, config2] = await catchError(createDebugPimsConfig());
+    const [configError, config] = await catchError2(createDebugPimsConfig());
     if (configError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -1374,7 +787,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
       processContext.exit(1);
       return;
     }
-    const [folderError, folder] = await catchError(getPersonalFolderKey(config2));
+    const [folderError, folder] = await catchError2(getPersonalFolderKey2(config));
     if (folderError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -1384,9 +797,9 @@ var registerSharedDebugInstanceCommands = (program, config) => {
       processContext.exit(1);
       return;
     }
-    config2.folderKey = folder.key;
-    config2.organizationUnitId = folder.id;
-    const [sessionError, session] = await catchError(beginDebugSession(config2, options.inputs));
+    config.folderKey = folder.key;
+    config.organizationUnitId = folder.id;
+    const [sessionError, session] = await catchError2(beginDebugSession2(config, options.inputs));
     if (sessionError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -1396,7 +809,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
       processContext.exit(1);
       return;
     }
-    const [createError, result] = await catchError(createDebugInstance(config2, session.jobKey, options.solutionId, options.projectId, options.entryPoint, options.processType, options.debugMode, options.simulationMode));
+    const [createError, result] = await catchError2(createDebugInstance2(config, session.jobKey, options.solutionId, options.projectId, options.entryPoint, options.processType, options.debugMode, options.simulationMode));
     if (createError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -1414,11 +827,11 @@ var registerSharedDebugInstanceCommands = (program, config) => {
         runId: result.runId,
         jobKey: session.jobKey
       },
-      Instructions: "Use 'debug-instance status <instance-id>' to check the run. Use 'debug-instance incidents <instance-id>' or 'debug-instance variables <instance-id>' to inspect it."
+      Instructions: "Use 'debug-instances status <instance-id>' to check the run. Use 'debug-instances incidents <instance-id>' or 'debug-instances variables <instance-id>' to inspect it."
     });
   });
   debugInstance.command("status").description(`Get the current status of a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").trackedAction(processContext, async (instanceId) => {
-    const result = await withDebugPimsCall((cfg) => debugPimsGet(cfg, `${DEBUG_API_PREFIX}/${instanceId}/element-executions`, "get-debug-instance-status"), "Error getting debug instance status");
+    const result = await withDebugPimsCall((cfg) => debugPimsGet2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/element-executions`, "get-debug-instance-status"), "Error getting debug instance status");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1428,7 +841,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     });
   });
   debugInstance.command("breakpoints").description(`Update breakpoints for a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").option("--inputs <value>", "Breakpoints payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (instanceId, options) => {
-    const [readError, data] = await catchError(resolveJsonInput({
+    const [readError, data] = await catchError2(resolveJsonInput({
       inline: options.inputs,
       allowStdin: true
     }));
@@ -1444,7 +857,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     const body = data ?? {
       breakpoints: []
     };
-    const result = await withDebugPimsCall((cfg) => debugPimsPut(cfg, `${DEBUG_API_PREFIX}/${instanceId}/breakpoints`, body), "Error updating breakpoints");
+    const result = await withDebugPimsCall((cfg) => debugPimsPut2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/breakpoints`, body), "Error updating breakpoints");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1454,7 +867,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     });
   });
   debugInstance.command("cancel").description(`Cancel a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").trackedAction(processContext, async (instanceId) => {
-    const result = await withDebugPimsCall((cfg) => debugPimsPost(cfg, `${DEBUG_API_PREFIX}/${instanceId}/cancel`, { comment: "" }), "Error canceling debug instance");
+    const result = await withDebugPimsCall((cfg) => debugPimsPost2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/cancel`, { comment: "" }), "Error canceling debug instance");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1464,7 +877,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     });
   });
   debugInstance.command("continue").description(`Continue execution on a paused ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").option("--inputs <value>", "Continue payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (instanceId, options) => {
-    const [readError, data] = await catchError(resolveJsonInput({
+    const [readError, data] = await catchError2(resolveJsonInput({
       inline: options.inputs,
       allowStdin: true
     }));
@@ -1480,7 +893,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     const body = data ?? {
       nextStep: false
     };
-    const result = await withDebugPimsCall((cfg) => debugPimsPost(cfg, `${DEBUG_API_PREFIX}/${instanceId}/continue`, body), "Error continuing debug instance");
+    const result = await withDebugPimsCall((cfg) => debugPimsPost2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/continue`, body), "Error continuing debug instance");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1490,7 +903,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     });
   });
   debugInstance.command("incidents").description(`Get incidents for a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").trackedAction(processContext, async (instanceId) => {
-    const result = await withDebugPimsCall((cfg) => debugPimsGet(cfg, `${DEBUG_API_PREFIX}/${instanceId}/incidents`), "Error getting debug instance incidents");
+    const result = await withDebugPimsCall((cfg) => debugPimsGet2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/incidents`), "Error getting debug instance incidents");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1513,9 +926,9 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     const query = buildQueryString({
       parentElementId: options.parentElementId
     });
-    const result = await withDebugPimsCall((cfg) => expectGlobals.length > 0 ? fetchDebugInstanceVariables(cfg, instanceId, {
+    const result = await withDebugPimsCall((cfg) => expectGlobals.length > 0 ? fetchDebugInstanceVariables2(cfg, instanceId, {
       expectGlobals
-    }) : debugPimsGet(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables${query}`), "Error getting debug instance variables");
+    }) : debugPimsGet2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables${query}`), "Error getting debug instance variables");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1525,7 +938,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     });
   });
   debugInstance.command("variables-set").description(`Update variables for a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").option("--inputs <value>", "Patch variables payload as JSON string, @file path, or piped via stdin").option("--parent-element-id <id>", "Filter by parent element ID").trackedAction(processContext, async (instanceId, options) => {
-    const [readError, data] = await catchError(resolveJsonInput({
+    const [readError, data] = await catchError2(resolveJsonInput({
       inline: options.inputs,
       allowStdin: true
     }));
@@ -1551,7 +964,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     const query = buildQueryString({
       parentElementId: options.parentElementId
     });
-    const result = await withDebugPimsCall((cfg) => debugPimsPatch(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables${query}`, body), "Error updating debug instance variables");
+    const result = await withDebugPimsCall((cfg) => debugPimsPatch2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables${query}`, body), "Error updating debug instance variables");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1561,7 +974,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
     });
   });
   debugInstance.command("variables-all").description(`Get all variables including subprocesses for a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").trackedAction(processContext, async (instanceId) => {
-    const result = await withDebugPimsCall((cfg) => debugPimsGet(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables-all`), "Error getting all debug instance variables");
+    const result = await withDebugPimsCall((cfg) => debugPimsGet2(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables-all`), "Error getting all debug instance variables");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1679,7 +1092,7 @@ function resolvePimsEnvelope(error, errorMessage, hint) {
   };
 }
 async function withPimsCall(fn, errorMessage, hint) {
-  const [configError, config] = await catchError(createPimsConfig());
+  const [configError, config] = await catchError2(createPimsConfig());
   if (configError) {
     logger.warn(`${errorMessage}: ${configError.message}`);
     OutputFormatter.error({
@@ -1691,16 +1104,16 @@ async function withPimsCall(fn, errorMessage, hint) {
     processContext.exit(1);
     return;
   }
-  const [error, result] = await catchError(fn(config));
+  const [error, result] = await catchError2(fn(config));
   if (error) {
     if (isNetworkError(error)) {
-      const msg2 = await extractErrorMessage(error);
-      logger.warn(`${errorMessage}: ${msg2}`);
+      const msg = await extractErrorMessage(error);
+      logger.warn(`${errorMessage}: ${msg}`);
       OutputFormatter.error({
         Result: RESULTS.Failure,
         Code: "NetworkError",
         Message: errorMessage,
-        Instructions: msg2
+        Instructions: msg
       });
       processContext.exit(1);
       return;
@@ -1735,7 +1148,7 @@ async function withPimsCall(fn, errorMessage, hint) {
 // ../maestro-sdk/src/shared-commands/incidents.ts
 var registerSharedIncidentCommands = (program, config) => {
   const { toolLabel } = config;
-  const incident = program.command("incident").description(`Manage ${toolLabel} incidents`);
+  const incident = program.command("incidents").alias("incident").description(`Manage ${toolLabel} incidents`);
   incident.command("summary").description(`Get ${toolLabel} incident summaries across processes`).option("--folder-key <key>", "Folder key").option("-l, --limit <number>", "Number of items to return (1-10000)", parseLimit).option("--offset <number>", "Number of items to skip (0-1000000)", parseOffset, 0).option("--process-key <process-key>", "Filter by process key").option("--status <status>", "Filter by incident status").option("--severity <severity>", "Filter by incident severity").trackedAction(processContext, async (options) => {
     const query = buildQueryString({
       processKey: options.processKey,
@@ -1745,7 +1158,7 @@ var registerSharedIncidentCommands = (program, config) => {
       $skip: options.offset !== 0 ? options.offset : undefined
     });
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/incidents/summary${query}`, reqOptions), "Error listing incidents");
+    const result = await withPimsCall((config) => pimsGet(config, `/incidents/summary${query}`, reqOptions), "Error listing incidents");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1756,7 +1169,7 @@ var registerSharedIncidentCommands = (program, config) => {
   });
   incident.command("get").description(`Get a single ${toolLabel} incident by ID`).argument("<incident-id>", "Incident ID").requiredOption("-f, --folder-key <key>", "Folder key").trackedAction(processContext, async (incidentId, options) => {
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/incidents/${encodeURIComponent(incidentId)}`, reqOptions), "Error getting incident", { resource: "incident", id: incidentId });
+    const result = await withPimsCall((config) => pimsGet(config, `/incidents/${encodeURIComponent(incidentId)}`, reqOptions), "Error getting incident", { resource: "incident", id: incidentId });
     if (!result)
       return;
     OutputFormatter.success({
@@ -1861,7 +1274,7 @@ var registerSharedInstanceCommands = (program, config) => {
     listFolderKeyRequired = folderKeyRequired
   } = config;
   const withFolderKey = (cmd, required = folderKeyRequired) => required ? cmd.requiredOption("-f, --folder-key <key>", "Folder key (GUID)") : cmd.option("-f, --folder-key <key>", "Folder key (GUID)");
-  const instances = program.command("instance").description(`Manage ${toolLabel} process instances`);
+  const instances = program.command("instances").alias("instance").description(`Manage ${toolLabel} process instances`);
   const listCmd = instances.command("list").description(`List ${toolLabel} process instances. Filters are applied by the ` + "server: --status narrows by run status, --process-key by " + "process key (GUID), --package-id by package identifier, and " + "--from-date/--to-date by start time. Results page by cursor " + "— read Pagination.NextPage and pass it back via --next-page.");
   withFolderKey(listCmd, listFolderKeyRequired).option("-l, --limit <number>", `Number of items to return (1-${MAX_INSTANCE_PAGE_SIZE})`, parseInstanceLimit, DEFAULT_PAGE_SIZE).option("--offset <number>", "Not supported by the instances API — use --next-page instead").option("--next-page <cursor>", "Cursor from a previous response's Pagination.NextPage").option("--process-key <process-key>", "Filter by process key (GUID). For the dotted package " + "identifier use --package-id.").option("--package-id <id>", "Filter by package ID").option("--error-code <code>", "Filter by error code").option("--status <status>", "Filter by instance status (repeatable; OR-semantics). " + `Values: ${INSTANCE_STATUS_LIST}.`, collectStatus, []).option("--from-date <iso-8601>", "Only include instances started at or after this ISO-8601 " + "timestamp (e.g. 2026-01-01T00:00:00Z).").option("--to-date <iso-8601>", "Only include instances started at or before this ISO-8601 " + "timestamp (e.g. 2026-02-01T00:00:00Z).").trackedAction(processContext, async (options) => {
     const filters = resolveListFilters(options);
@@ -1879,7 +1292,7 @@ var registerSharedInstanceCommands = (program, config) => {
       nextPage: options.nextPage
     });
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances${query}`, reqOptions), "Error listing instances");
+    const result = await withPimsCall((config) => pimsGet(config, `/instances${query}`, reqOptions), "Error listing instances");
     if (!result)
       return;
     const instanceList = extractProcessInstances(result);
@@ -1898,7 +1311,7 @@ var registerSharedInstanceCommands = (program, config) => {
   });
   const getCmd = instances.command("get").description(`Get a ${toolLabel} process instance by ID`).argument("<instance-id>", "Process instance ID");
   withFolderKey(getCmd).trackedAction(processContext, async (instanceId, options) => {
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}`, { folderKey: options.folderKey }), "Error getting instance", { resource: "instance", id: instanceId });
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}`, { folderKey: options.folderKey }), "Error getting instance", { resource: "instance", id: instanceId });
     if (!result)
       return;
     OutputFormatter.success({
@@ -1911,7 +1324,7 @@ var registerSharedInstanceCommands = (program, config) => {
   withFolderKey(pauseCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, options) => {
     const body = { comment: options.comment || "" };
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/pause`, body, reqOptions), "Error pausing instance");
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/pause`, body, reqOptions), "Error pausing instance");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1924,7 +1337,7 @@ var registerSharedInstanceCommands = (program, config) => {
   withFolderKey(resumeCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, options) => {
     const body = { comment: options.comment || "" };
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/resume`, body, reqOptions), "Error resuming instance");
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/resume`, body, reqOptions), "Error resuming instance");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1937,7 +1350,7 @@ var registerSharedInstanceCommands = (program, config) => {
   withFolderKey(cancelCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, options) => {
     const body = { comment: options.comment || "" };
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/cancel`, body, reqOptions), "Error canceling instance");
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/cancel`, body, reqOptions), "Error canceling instance");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1952,7 +1365,7 @@ var registerSharedInstanceCommands = (program, config) => {
       parentElementId: options.parentElementId
     });
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/variables${query}`, reqOptions), "Error getting variables");
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/variables${query}`, reqOptions), "Error getting variables");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1963,7 +1376,7 @@ var registerSharedInstanceCommands = (program, config) => {
   });
   const incidentsCmd = instances.command("incidents").description(`Get incidents for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
   withFolderKey(incidentsCmd).trackedAction(processContext, async (instanceId, options) => {
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/incidents`, { folderKey: options.folderKey }), "Error getting incidents");
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/incidents`, { folderKey: options.folderKey }), "Error getting incidents");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1974,7 +1387,7 @@ var registerSharedInstanceCommands = (program, config) => {
   });
   const assetCmd = instances.command("asset").description(`Get the ${toolLabel} definition for a process instance`).argument("<instance-id>", "Process instance ID");
   withFolderKey(assetCmd).trackedAction(processContext, async (instanceId, options) => {
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/asset?type=${assetType}`, { folderKey: options.folderKey }), "Error getting asset");
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/asset?type=${assetType}`, { folderKey: options.folderKey }), "Error getting asset");
     if (!result)
       return;
     OutputFormatter.success({
@@ -1982,82 +1395,383 @@ var registerSharedInstanceCommands = (program, config) => {
       Code: "InstanceAsset",
       Data: result
     });
-  });
-  const retryCmd = instances.command("retry").description(`Retry a faulted ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
-  withFolderKey(retryCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, options) => {
-    const body = { comment: options.comment || "" };
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/retry`, body, reqOptions), "Error retrying instance");
-    if (!result)
-      return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "InstanceRetried",
-      Data: result
+  });
+  const retryCmd = instances.command("retry").description(`Retry a faulted ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
+  withFolderKey(retryCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, options) => {
+    const body = { comment: options.comment || "" };
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/retry`, body, reqOptions), "Error retrying instance");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceRetried",
+      Data: result
+    });
+  });
+  const migrateCmd = instances.command("migrate").description(`Migrate a ${toolLabel} process instance to a different package version`).argument("<instance-id>", "Process instance ID").argument("<new-version>", "Target package version");
+  withFolderKey(migrateCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, newVersion, options) => {
+    const body = {
+      newVersion,
+      comment: options.comment || ""
+    };
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/upgrade`, body, reqOptions), "Error migrating instance");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceMigrated",
+      Data: result
+    });
+  });
+  const gotoCmd = instances.command("goto").description("Move execution cursor from one element to another").argument("<instance-id>", "Process instance ID").argument("<transitions>", `JSON array of transitions, e.g. '[{"sourceElementId":"A","targetElementId":"B"}]'`);
+  withFolderKey(gotoCmd).trackedAction(processContext, async (instanceId, transitionsJson, options) => {
+    const [parseError, transitions] = catchError2(() => JSON.parse(transitionsJson));
+    const isValidShape = !parseError && Array.isArray(transitions) && transitions.every((t) => t?.sourceElementId != null && t?.targetElementId != null);
+    if (!isValidShape) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "Error applying goto",
+        Instructions: parseError ? `Invalid transitions JSON: ${parseError.message}` : 'Each transition must have "sourceElementId" and "targetElementId"'
+      });
+      processContext.exit(1);
+      return;
+    }
+    const body = { transitions };
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/goto`, body, reqOptions), "Error applying goto");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceGoto",
+      Data: result
+    });
+  });
+  const cursorsCmd = instances.command("cursors").description(`Get current execution cursor positions for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
+  withFolderKey(cursorsCmd).trackedAction(processContext, async (instanceId, options) => {
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/goto/cursors`, { folderKey: options.folderKey }), "Error getting cursors");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceCursors",
+      Data: result
+    });
+  });
+  const messageCmd = instances.command("messages").alias("message").description(`Manage ${toolLabel} instance messages`);
+  messageCmd.command("send").description(`Send a message to ${toolLabel} workflow subscriptions`).requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--inputs <value>", "Message payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (options) => {
+    const [readError, body] = await catchError2(resolveJsonInput({
+      inline: options.inputs,
+      allowStdin: true
+    }));
+    if (readError) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "Error reading message input",
+        Instructions: readError.message
+      });
+      processContext.exit(1);
+      return;
+    }
+    if (body === undefined) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "Missing message payload",
+        Instructions: "Provide --inputs <json|@file> or pipe JSON via stdin."
+      });
+      processContext.exit(1);
+      return;
+    }
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPost(config, "/instances/messages/send", body, reqOptions), "Error sending message");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "MessageSent",
+      Data: result
+    });
+  });
+  if (includeElementExecutions) {
+    const elementExeCmd = instances.command("element-executions").description(`Get element executions for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
+    withFolderKey(elementExeCmd).trackedAction(processContext, async (instanceId, options) => {
+      const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/element-executions`, { folderKey: options.folderKey }), "Error getting element executions");
+      if (!result)
+        return;
+      OutputFormatter.success({
+        Result: RESULTS.Success,
+        Code: "InstanceElementExecutions",
+        Data: result
+      });
+    });
+  }
+  const variablesSetCmd = instances.command("variables-set").description(`Update variables for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
+  withFolderKey(variablesSetCmd).option("--inputs <value>", "Patch variables payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (instanceId, options) => {
+    const [readError, data] = await catchError2(resolveJsonInput({
+      inline: options.inputs,
+      allowStdin: true
+    }));
+    if (readError) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "Error reading variables input",
+        Instructions: readError.message
+      });
+      processContext.exit(1);
+      return;
+    }
+    if (data === undefined) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "Missing variables payload",
+        Instructions: "Provide --inputs <json|@file> or pipe JSON via stdin."
+      });
+      processContext.exit(1);
+      return;
+    }
+    const body = data;
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPatch(config, `/instances/${instanceId}/variables`, body, reqOptions), "Error updating variables");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceVariablesSet",
+      Data: result
+    });
+  });
+  const variablesAllCmd = instances.command("variables-all").description(`Get all variables (including subprocesses) for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
+  withFolderKey(variablesAllCmd).trackedAction(processContext, async (instanceId, options) => {
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/variables-all`, { folderKey: options.folderKey }), "Error getting all variables");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceVariablesAll",
+      Data: result
+    });
+  });
+  const globalVarsCmd = instances.command("global-variables").description(`Get global variables for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
+  withFolderKey(globalVarsCmd).trackedAction(processContext, async (instanceId, options) => {
+    const result = await withPimsCall((config) => pimsGet(config, `/instances/${instanceId}/global-variables`, { folderKey: options.folderKey }), "Error getting global variables");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "InstanceGlobalVariables",
+      Data: result
+    });
+  });
+  const element = instances.command("elements").alias("element").description(`Manage elements within a ${toolLabel} process instance`);
+  const elementCancelCmd = element.command("cancel").description(`Cancel a specific element in a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID").argument("<element-id>", "Element ID");
+  withFolderKey(elementCancelCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, elementId, options) => {
+    const body = { comment: options.comment || "" };
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/element/${elementId}/cancel`, body, reqOptions), "Error canceling element");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "ElementCanceled",
+      Data: result
+    });
+  });
+  const elementRetryCmd = element.command("retry").description(`Retry a faulted element in a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID").argument("<element-id>", "Element ID");
+  withFolderKey(elementRetryCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, elementId, options) => {
+    const body = { comment: options.comment || "" };
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsPost(config, `/instances/${instanceId}/element/${elementId}/retry`, body, reqOptions), "Error retrying element");
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "ElementRetried",
+      Data: result
+    });
+  });
+  attachSharedExamples(instances);
+};
+
+// ../maestro-sdk/src/shared-commands/process.ts
+var SEARCHABLE_TAG = "Searchable";
+var parseBooleanFlag = (value) => {
+  if (value === "true")
+    return true;
+  if (value === "false")
+    return false;
+  throw new InvalidArgumentError(`Expected 'true' or 'false', got '${value}'.`);
+};
+var collectValue = (value, previous) => [
+  ...previous,
+  value
+];
+var parseTagList = (csv) => csv === undefined ? [] : csv.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0);
+var applyFriendlyVariableTags = (variableTags, flags) => {
+  const elements = variableTags.elements ?? {};
+  const allOutputs = Object.entries(elements).flatMap(([elementId, el]) => (el.outputs ?? []).map((output) => ({ elementId, output })));
+  const available = allOutputs.map((o) => `${o.output.name} (element ${o.elementId})`).join(", ");
+  let targets;
+  if (flags.all) {
+    if (allOutputs.length === 0) {
+      throw new Error("This process has no taggable variables.");
+    }
+    targets = allOutputs;
+  } else {
+    const seen = new Set;
+    targets = [];
+    for (const name of flags.variable ?? []) {
+      const matches = allOutputs.filter((o) => o.output.name === name && (flags.elementId === undefined || o.elementId === flags.elementId));
+      if (matches.length === 0) {
+        throw new Error(available ? `No variable matched "${name}"${flags.elementId ? ` in element ${flags.elementId}` : ""}. Available: ${available}.` : "This process has no taggable variables.");
+      }
+      if (flags.elementId === undefined && new Set(matches.map((m) => m.elementId)).size > 1) {
+        const where = matches.map((m) => m.elementId).join(", ");
+        throw new Error(`Variable "${name}" exists in multiple elements (${where}). Pass --element-id to disambiguate (one --variable at a time), or --all to tag every occurrence.`);
+      }
+      for (const m of matches) {
+        if (!seen.has(m.output)) {
+          seen.add(m.output);
+          targets.push(m);
+        }
+      }
+    }
+  }
+  const replaceTags = flags.tags !== undefined ? parseTagList(flags.tags) : undefined;
+  const addTags = parseTagList(flags.addTags);
+  const removeSet = new Set(parseTagList(flags.removeTags));
+  return targets.map(({ elementId, output }) => {
+    const next = replaceTags !== undefined ? [...new Set(replaceTags)] : [...new Set([...output.tags ?? [], ...addTags])].filter((tag) => !removeSet.has(tag));
+    output.tags = next;
+    return { elementId, name: output.name, tags: next };
+  });
+};
+var buildSettingsPath = (processKey) => `/processes/${encodeURIComponent(processKey)}/settings`;
+var validateFriendlyTagFlags = (options) => {
+  const variableCount = options.variable.length;
+  if (variableCount > 0 && options.all) {
+    return "Use either --variable or --all, not both.";
+  }
+  if (variableCount === 0 && !options.all) {
+    return "Specify the target with --variable <name> (repeatable, plus optional --element-id) or --all.";
+  }
+  if (variableCount > 1 && options.elementId !== undefined) {
+    return "--element-id only works with a single --variable; pass one --variable, or drop --element-id.";
+  }
+  const hasSearchable = options.searchable !== undefined;
+  const hasReplace = options.tags !== undefined;
+  const hasIncremental = options.addTags !== undefined || options.removeTags !== undefined;
+  if (hasSearchable && (hasReplace || hasIncremental)) {
+    return "Use --searchable <true|false>, or the low-level --tags/--add-tags/--remove-tags flags — not both.";
+  }
+  if (!hasSearchable && !hasReplace && !hasIncremental) {
+    return "Specify --searchable <true|false> to mark the variable searchable, or --tags/--add-tags/--remove-tags for other tags.";
+  }
+  if (hasReplace && hasIncremental) {
+    return "Use --tags to replace tags, or --add-tags/--remove-tags to adjust them — not both.";
+  }
+  return null;
+};
+var resolveTagFlags = (options) => {
+  if (options.searchable === undefined)
+    return options;
+  return {
+    variable: options.variable,
+    elementId: options.elementId,
+    all: options.all,
+    addTags: options.searchable ? SEARCHABLE_TAG : undefined,
+    removeTags: options.searchable ? undefined : SEARCHABLE_TAG
+  };
+};
+var setVariableTagsFromPayload = async (processKey, options) => {
+  const [fileError, variableTags] = await catchError2(resolveJsonInput({ inline: options.inputs, allowStdin: true }));
+  if (fileError) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: "Error reading variable tags input",
+      Instructions: fileError.message
+    });
+    processContext.exit(1);
+    return;
+  }
+  if (variableTags === undefined) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: "Missing variable tags payload",
+      Instructions: "Provide --inputs <json|@file>, pipe JSON via stdin, or use the --variable/--all flags."
     });
+    processContext.exit(1);
+    return;
+  }
+  const reqOptions = { folderKey: options.folderKey };
+  const currentSettings = await withPimsCall((config) => pimsGet(config, buildSettingsPath(processKey), reqOptions), "Error reading current process settings");
+  if (!currentSettings)
+    return;
+  const merged = { ...currentSettings, variableTags };
+  const result = await withPimsCall((config) => pimsPut(config, buildSettingsPath(processKey), merged, reqOptions), "Error updating variable tags");
+  if (!result)
+    return;
+  OutputFormatter.success({
+    Result: RESULTS.Success,
+    Code: "ProcessVariableTagsSet",
+    Data: result
   });
-  const migrateCmd = instances.command("migrate").description(`Migrate a ${toolLabel} process instance to a different package version`).argument("<instance-id>", "Process instance ID").argument("<new-version>", "Target package version");
-  withFolderKey(migrateCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, newVersion, options) => {
-    const body = {
-      newVersion,
-      comment: options.comment || ""
-    };
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/upgrade`, body, reqOptions), "Error migrating instance");
-    if (!result)
-      return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "InstanceMigrated",
-      Data: result
+};
+var setVariableTagsFromFlags = async (processKey, options) => {
+  const reqOptions = { folderKey: options.folderKey };
+  const currentSettings = await withPimsCall((config) => pimsGet(config, buildSettingsPath(processKey), reqOptions), "Error reading current process settings");
+  if (!currentSettings)
+    return;
+  const variableTags = currentSettings.variableTags ?? {
+    elements: {},
+    sourcePackageVersion: "",
+    lastUpdateTimeUtc: ""
+  };
+  const [mutateError, updated] = catchError2(() => applyFriendlyVariableTags(variableTags, resolveTagFlags(options)));
+  if (mutateError) {
+    OutputFormatter.error({
+      Result: RESULTS.Failure,
+      Message: "Error updating variable tags",
+      Instructions: mutateError.message
     });
+    processContext.exit(1);
+    return;
+  }
+  const merged = { ...currentSettings, variableTags };
+  const result = await withPimsCall((config) => pimsPut(config, buildSettingsPath(processKey), merged, reqOptions), "Error updating variable tags");
+  if (!result)
+    return;
+  OutputFormatter.success({
+    Result: RESULTS.Success,
+    Code: "ProcessVariableTagsSet",
+    Data: { updated, variableTags }
   });
-  const gotoCmd = instances.command("goto").description("Move execution cursor from one element to another").argument("<instance-id>", "Process instance ID").argument("<transitions>", `JSON array of transitions, e.g. '[{"sourceElementId":"A","targetElementId":"B"}]'`);
-  withFolderKey(gotoCmd).trackedAction(processContext, async (instanceId, transitionsJson, options) => {
-    const [parseError, transitions] = catchError(() => JSON.parse(transitionsJson));
-    const isValidShape = !parseError && Array.isArray(transitions) && transitions.every((t) => t?.sourceElementId != null && t?.targetElementId != null);
-    if (!isValidShape) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error applying goto",
-        Instructions: parseError ? `Invalid transitions JSON: ${parseError.message}` : 'Each transition must have "sourceElementId" and "targetElementId"'
-      });
-      processContext.exit(1);
-      return;
-    }
-    const body = { transitions };
+};
+var registerSharedProcessCommands = (processCmd, config) => {
+  const { toolLabel } = config;
+  const settingsCmd = processCmd.command("settings").description(`Manage ${toolLabel} process settings`);
+  settingsCmd.command("get").description(`Get settings for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").trackedAction(processContext, async (processKey, options) => {
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/goto`, body, reqOptions), "Error applying goto");
-    if (!result)
-      return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "InstanceGoto",
-      Data: result
-    });
-  });
-  const cursorsCmd = instances.command("cursors").description(`Get current execution cursor positions for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
-  withFolderKey(cursorsCmd).trackedAction(processContext, async (instanceId, options) => {
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/goto/cursors`, { folderKey: options.folderKey }), "Error getting cursors");
+    const result = await withPimsCall((config) => pimsGet(config, `/processes/${encodeURIComponent(processKey)}/settings`, reqOptions), "Error getting process settings", { resource: "process", id: processKey });
     if (!result)
       return;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "InstanceCursors",
+      Code: "ProcessSettingsGet",
       Data: result
     });
   });
-  const messageCmd = instances.command("message").description(`Manage ${toolLabel} instance messages`);
-  messageCmd.command("send").description(`Send a message to ${toolLabel} workflow subscriptions`).requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--inputs <value>", "Message payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (options) => {
-    const [readError, body] = await catchError(resolveJsonInput({
+  settingsCmd.command("set").description(`Update settings for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--inputs <value>", "Settings payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (processKey, options) => {
+    const [fileError, body] = await catchError2(resolveJsonInput({
       inline: options.inputs,
       allowStdin: true
     }));
-    if (readError) {
+    if (fileError) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
-        Message: "Error reading message input",
-        Instructions: readError.message
+        Message: "Error reading settings input",
+        Instructions: fileError.message
       });
       processContext.exit(1);
       return;
@@ -2065,447 +1779,706 @@ var registerSharedInstanceCommands = (program, config) => {
     if (body === undefined) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
-        Message: "Missing message payload",
+        Message: "Missing settings payload",
         Instructions: "Provide --inputs <json|@file> or pipe JSON via stdin."
       });
       processContext.exit(1);
       return;
     }
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, "/instances/messages/send", body, reqOptions), "Error sending message");
+    const result = await withPimsCall((config) => pimsPut(config, `/processes/${encodeURIComponent(processKey)}/settings`, body, reqOptions), "Error updating process settings");
     if (!result)
       return;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "MessageSent",
+      Code: "ProcessSettingsSet",
       Data: result
     });
   });
-  if (includeElementExecutions) {
-    const elementExeCmd = instances.command("element-executions").description(`Get element executions for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
-    withFolderKey(elementExeCmd).trackedAction(processContext, async (instanceId, options) => {
-      const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/element-executions`, { folderKey: options.folderKey }), "Error getting element executions");
-      if (!result)
-        return;
-      OutputFormatter.success({
-        Result: RESULTS.Success,
-        Code: "InstanceElementExecutions",
-        Data: result
-      });
+  const variableTagsCmd = processCmd.command("variable-tags").description(`Manage ${toolLabel} process variable tags`);
+  variableTagsCmd.command("get").description(`Get variable tags for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").trackedAction(processContext, async (processKey, options) => {
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsGet(config, `/processes/${encodeURIComponent(processKey)}/settings`, reqOptions), "Error getting variable tags", { resource: "process", id: processKey });
+    if (!result)
+      return;
+    OutputFormatter.success({
+      Result: RESULTS.Success,
+      Code: "ProcessVariableTagsGet",
+      Data: result.variableTags ?? {}
     });
-  }
-  const variablesSetCmd = instances.command("variables-set").description(`Update variables for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
-  withFolderKey(variablesSetCmd).option("--inputs <value>", "Patch variables payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (instanceId, options) => {
-    const [readError, data] = await catchError(resolveJsonInput({
-      inline: options.inputs,
-      allowStdin: true
-    }));
-    if (readError) {
+  });
+  variableTagsCmd.command("set").description(`Update variable tags for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--variable <name>", "Name of a variable (output) to tag. Repeatable — pass it multiple times to tag several variables in one call.", collectValue, []).option("--element-id <id>", "Element that owns the variable (disambiguates when the same name appears in multiple elements). Only valid with a single --variable.").option("--all", "Apply the change to every taggable variable").option("--searchable <boolean>", "Mark the variable searchable for instance filtering ('true' or 'false')", parseBooleanFlag).option("--tags <list>", "Advanced: comma-separated tags to set, replacing the variable's current tags (empty value clears them)").option("--add-tags <list>", "Comma-separated tags to add to the variable's current tags").option("--remove-tags <list>", "Comma-separated tags to remove from the variable's current tags").option("--inputs <value>", "Full variable tags payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (processKey, options) => {
+    const friendlyRequested = options.variable.length > 0 || options.elementId !== undefined || options.all === true || options.searchable !== undefined || options.tags !== undefined || options.addTags !== undefined || options.removeTags !== undefined;
+    if (options.inputs !== undefined && friendlyRequested) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
-        Message: "Error reading variables input",
-        Instructions: readError.message
+        Message: "Error updating variable tags",
+        Instructions: "Provide either --inputs (full JSON payload) or the --searchable/--variable/--all flags, not both."
       });
       processContext.exit(1);
       return;
     }
-    if (data === undefined) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Missing variables payload",
-        Instructions: "Provide --inputs <json|@file> or pipe JSON via stdin."
-      });
-      processContext.exit(1);
+    if (friendlyRequested) {
+      const validationError = validateFriendlyTagFlags(options);
+      if (validationError) {
+        OutputFormatter.error({
+          Result: RESULTS.Failure,
+          Message: "Error updating variable tags",
+          Instructions: validationError
+        });
+        processContext.exit(1);
+        return;
+      }
+      await setVariableTagsFromFlags(processKey, options);
       return;
     }
-    const body = data;
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPatch(config2, `/instances/${instanceId}/variables`, body, reqOptions), "Error updating variables");
-    if (!result)
-      return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "InstanceVariablesSet",
-      Data: result
-    });
+    await setVariableTagsFromPayload(processKey, options);
   });
-  const variablesAllCmd = instances.command("variables-all").description(`Get all variables (including subprocesses) for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
-  withFolderKey(variablesAllCmd).trackedAction(processContext, async (instanceId, options) => {
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/variables-all`, { folderKey: options.folderKey }), "Error getting all variables");
+  attachSharedExamples(settingsCmd);
+  attachSharedExamples(variableTagsCmd);
+};
+
+// ../maestro-sdk/src/shared-commands/processes.ts
+async function findProcessSummary(config, processKey, folderKey, processType) {
+  const page = await pimsGet(config, `/processes/summary${buildQueryString({ processType, processKey })}`, { folderKey });
+  const summaries = Array.isArray(page?.processes) ? page.processes : [];
+  return summaries.find((summary) => summary.processKey === processKey) ?? null;
+}
+var registerSharedProcessesCommands = (program, config) => {
+  const { toolLabel, processType } = config;
+  const incidentsQuery = buildQueryString({ processType });
+  const processes = program.command("processes").description(`Manage ${toolLabel} process summaries`);
+  processes.command("list").description(`List all ${toolLabel} process summaries`).option("--folder-key <key>", "Folder key").option("-l, --limit <number>", "Number of items to return (1-10000)", parseLimit).option("--offset <number>", "Number of items to skip (0-1000000)", parseOffset, 0).option("--status <status>", "Filter by process status").trackedAction(processContext, async (options) => {
+    const query = buildQueryString({
+      processType,
+      status: options.status,
+      $top: options.limit,
+      $skip: options.offset !== 0 ? options.offset : undefined
+    });
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsGet(config, `/processes/summary${query}`, reqOptions), "Error listing processes");
     if (!result)
       return;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "InstanceVariablesAll",
+      Code: "ProcessList",
       Data: result
     });
   });
-  const globalVarsCmd = instances.command("global-variables").description(`Get global variables for a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID");
-  withFolderKey(globalVarsCmd).trackedAction(processContext, async (instanceId, options) => {
-    const result = await withPimsCall((config2) => pimsGet(config2, `/instances/${instanceId}/global-variables`, { folderKey: options.folderKey }), "Error getting global variables");
+  processes.command("incidents").description(`Get incidents for a specific ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("--folder-key <key>", "Folder key").trackedAction(processContext, async (processKey, options) => {
+    const reqOptions = { folderKey: options.folderKey };
+    const result = await withPimsCall((config) => pimsGet(config, `/incidents/process/${encodeURIComponent(processKey)}${incidentsQuery}`, reqOptions), "Error getting process incidents", { resource: "process", id: processKey });
     if (!result)
       return;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "InstanceGlobalVariables",
+      Code: "ProcessIncidents",
       Data: result
     });
   });
-  const element = instances.command("element").description(`Manage elements within a ${toolLabel} process instance`);
-  const elementCancelCmd = element.command("cancel").description(`Cancel a specific element in a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID").argument("<element-id>", "Element ID");
-  withFolderKey(elementCancelCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, elementId, options) => {
-    const body = { comment: options.comment || "" };
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/element/${elementId}/cancel`, body, reqOptions), "Error canceling element");
+  processes.command("diagnose").description(`Correlate ${toolLabel} process summary, incidents, and error codes`).argument("<process-key>", "Process definition key").requiredOption("--folder-key <key>", "Folder key").trackedAction(processContext, async (processKey, options) => {
+    const result = await withPimsCall(async (config) => {
+      const summary = await findProcessSummary(config, processKey, options.folderKey, processType);
+      const incidents = await pimsGet(config, `/incidents/process/${encodeURIComponent(processKey)}${incidentsQuery}`, { folderKey: options.folderKey });
+      const errorCodes = await pimsGet(config, `/incidents/process/${encodeURIComponent(processKey)}/error-codes`, { folderKey: options.folderKey });
+      return {
+        summary,
+        incidents,
+        errorCodes: errorCodes.errorCodes || []
+      };
+    }, "Error diagnosing process");
     if (!result)
       return;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ElementCanceled",
-      Data: result
+      Code: "ProcessDiagnostics",
+      Data: {
+        ProcessKey: processKey,
+        FolderKey: options.folderKey,
+        Summary: result.summary,
+        FaultedCount: result.summary?.faultedCount ?? null,
+        RunningCount: result.summary?.runningCount ?? null,
+        Incidents: result.incidents,
+        IncidentCount: result.incidents.length,
+        ErrorCodes: result.errorCodes,
+        ErrorCodeCount: result.errorCodes.length
+      }
     });
   });
-  const elementRetryCmd = element.command("retry").description(`Retry a faulted element in a ${toolLabel} process instance`).argument("<instance-id>", "Process instance ID").argument("<element-id>", "Element ID");
-  withFolderKey(elementRetryCmd).option("--comment <text>", "Optional comment for the operation").trackedAction(processContext, async (instanceId, elementId, options) => {
-    const body = { comment: options.comment || "" };
+  processes.command("error-codes").description(`Get unique error codes for a specific ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("--folder-key <key>", "Folder key").trackedAction(processContext, async (processKey, options) => {
     const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPost(config2, `/instances/${instanceId}/element/${elementId}/retry`, body, reqOptions), "Error retrying element");
+    const result = await withPimsCall((config) => pimsGet(config, `/incidents/process/${encodeURIComponent(processKey)}/error-codes`, reqOptions), "Error getting process error codes", { resource: "process", id: processKey });
     if (!result)
       return;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ElementRetried",
-      Data: result
+      Code: "ProcessIncidentErrorCodes",
+      Data: result.errorCodes || []
     });
   });
-  attachSharedExamples(instances);
+  attachSharedExamples(processes);
 };
 
-// ../maestro-sdk/src/shared-commands/process.ts
-var SEARCHABLE_TAG = "Searchable";
-var parseBooleanFlag = (value) => {
-  if (value === "true")
-    return true;
-  if (value === "false")
-    return false;
-  throw new InvalidArgumentError(`Expected 'true' or 'false', got '${value}'.`);
-};
-var collectValue = (value, previous) => [
-  ...previous,
-  value
-];
-var parseTagList = (csv) => csv === undefined ? [] : csv.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0);
-var applyFriendlyVariableTags = (variableTags, flags) => {
-  const elements = variableTags.elements ?? {};
-  const allOutputs = Object.entries(elements).flatMap(([elementId, el]) => (el.outputs ?? []).map((output) => ({ elementId, output })));
-  const available = allOutputs.map((o) => `${o.output.name} (element ${o.elementId})`).join(", ");
-  let targets;
-  if (flags.all) {
-    if (allOutputs.length === 0) {
-      throw new Error("This process has no taggable variables.");
+// ../maestro-sdk/src/registry/filter-parser.ts
+class FilterParseError extends Error {
+  code;
+  token;
+  constructor(message, code, token) {
+    super(message);
+    this.code = code;
+    this.token = token;
+    this.name = "FilterParseError";
+  }
+}
+function parseFilterString(filterString) {
+  if (!filterString || filterString.trim() === "") {
+    return { filters: [], logic: "AND" };
+  }
+  const parts = filterString.split(/,(?=[a-zA-Z_][a-zA-Z0-9_]*(?::[a-zA-Z]+)?=)/);
+  const conditions = [];
+  for (const part of parts) {
+    const condition = parseFilterCondition(part.trim());
+    conditions.push(condition);
+  }
+  return {
+    filters: conditions,
+    logic: "AND"
+  };
+}
+function parseFilterCondition(conditionString) {
+  const match = conditionString.match(/^([^:=]+)(?::([^=]+))?=(.+)$/);
+  if (!match) {
+    throw new FilterParseError(`Invalid filter format: '${conditionString}'. Expected 'field=value' or 'field:operator=value'.`, "INVALID_FORMAT", conditionString);
+  }
+  const [, fieldStr, operatorStr, valueStr] = match;
+  const field = normalizeField(fieldStr.trim());
+  const operator = operatorStr?.trim() || "equals";
+  const value = valueStr.trim();
+  if (!isValidField(field)) {
+    throw new FilterParseError(`Invalid filter field: '${field}'. Supported fields: category, type, tags, displayname, nodetype, description.`, "INVALID_FIELD", field);
+  }
+  if (!isValidOperator(operator)) {
+    throw new FilterParseError(`Invalid filter operator: '${operator}'. Supported operators: equals, contains, in, startsWith, endsWith.`, "INVALID_OPERATOR", operator);
+  }
+  return {
+    field,
+    operator,
+    value
+  };
+}
+function normalizeField(field) {
+  const fieldMap = {
+    category: "category",
+    cat: "category",
+    type: "type",
+    nodetype: "nodetype",
+    node_type: "nodetype",
+    tags: "tags",
+    tag: "tags",
+    displayname: "displayname",
+    display_name: "displayname",
+    displayName: "displayname",
+    name: "displayname",
+    label: "displayname"
+  };
+  const normalized = field.toLowerCase().replace(/[-_\s]/g, "");
+  return fieldMap[normalized] || field;
+}
+function isValidField(field) {
+  const validFields = [
+    "category",
+    "type",
+    "tags",
+    "displayname",
+    "nodetype",
+    "description"
+  ];
+  return validFields.includes(field);
+}
+function isValidOperator(operator) {
+  const validOperators = [
+    "equals",
+    "contains",
+    "in",
+    "startsWith",
+    "endsWith"
+  ];
+  return validOperators.includes(operator);
+}
+
+// ../maestro-sdk/src/registry/command.ts
+function flattenNodeForDisplay(n) {
+  return {
+    NodeType: n.nodeType,
+    Category: n.category ?? "",
+    DisplayName: n.display?.label ?? "",
+    Description: n.description ?? n.display?.description ?? "",
+    Version: n.version ?? "",
+    Tags: (n.tags ?? []).join(", ")
+  };
+}
+async function missingProcessResourceHint() {
+  const {
+    describeProjectsWithoutProcessResource,
+    findProjectsWithoutProcessResource,
+    findSolutionFromCwd
+  } = await import("./solution-discovery-vn4q32bf.js");
+  const ctx = await findSolutionFromCwd();
+  if (!ctx)
+    return {};
+  return describeProjectsWithoutProcessResource(await findProjectsWithoutProcessResource(ctx), ctx.solutionDir);
+}
+async function localResultNotes(contractWarning) {
+  const hint = await missingProcessResourceHint();
+  const warnings = [hint.Warning, contractWarning].filter((w) => typeof w === "string");
+  return {
+    ...hint,
+    ...warnings.length > 0 ? { Warning: warnings.join(" ") } : {}
+  };
+}
+async function explainNodeTypeWithoutProcessResource(nodeType) {
+  const discovery = await import("./solution-discovery-vn4q32bf.js");
+  const [, explanation] = await catchError2(discovery.explainNodeTypeWithoutProcessResource(nodeType));
+  return explanation;
+}
+function flattenNodeWithAvailability(n, availableOnTenant) {
+  return {
+    ...flattenNodeForDisplay(n),
+    AvailableOnTenant: availableOnTenant
+  };
+}
+async function mergeWithKnownSdkNodes(tenantNodes) {
+  const { listKnownSdkNodes } = await import("./known-types-v9sxcq1c.js");
+  const tenantTypes = new Set(tenantNodes.map((n) => n.nodeType?.toLowerCase()).filter((t) => typeof t === "string"));
+  const merged = tenantNodes.map((node) => ({ node, availableOnTenant: true }));
+  for (const known of listKnownSdkNodes()) {
+    const type = known.nodeType?.toLowerCase();
+    if (typeof type !== "string")
+      continue;
+    if (tenantTypes.has(type))
+      continue;
+    merged.push({ node: known, availableOnTenant: false });
+  }
+  return merged;
+}
+var ALL_NODES = -1;
+function parseListLimit(raw) {
+  return raw.trim() === String(ALL_NODES) ? ALL_NODES : parseLimit(raw);
+}
+function shownRows(count, offset) {
+  return offset === 0 ? `first ${count}` : `${count} from offset ${offset}`;
+}
+var registerRegistryCommand = (program, commandPrefix) => {
+  const cmd = `uip ${commandPrefix} registry`;
+  const registry = program.command("registry").description(`Browse and search the ${commandPrefix} node registry to discover available activities and connectors (OOTB + authenticated). Use 'pull' to sync, 'search' to find nodes, 'get' to inspect a node's full input/output schema.`).addHelpText("after", `
+Typical workflow:
+  0. Login for full registry (optional, OOTB nodes available without login):
+                          uip login
+  1. Sync the registry:   ${cmd} pull
+  2. Search for a node:   ${cmd} search slack
+  3. Inspect its schema:  ${cmd} get <node-type>
+  4. Extract input fields: ${cmd} get <node-type> --output-filter "Node.inputDefinition.fields"
+
+Note: Without login, only built-in (OOTB) nodes are available. Login to access the full node registry including custom connectors.
+
+In-solution discovery (--local):
+  Run from inside a solution project directory (with a .uipx file in CWD, parent, or grandparent).
+  Shows sibling projects (Agent, Process, Flow, Api) as invokable nodes.
+  cd MySolution/MyFlow && ${cmd} list --local
+
+Subcommands:
+  pull    Fetch and cache the full node registry (run once per session)
+  list    List cached nodes (default: first 20, --limit -1 for everything)
+  search  Find nodes by keyword and/or field filters  ← start here
+  get     Get full schema for a single node (with connector input/output enrichment)`);
+  const pullExamples = [
+    {
+      Description: "Sync the node registry",
+      Command: `${cmd} pull`,
+      Output: {
+        Code: "NodePullSuccess",
+        Data: {
+          NodesCount: 184,
+          FromCache: false,
+          Source: "authenticated",
+          CacheWritten: true,
+          Message: "Synced fresh nodes"
+        }
+      }
     }
-    targets = allOutputs;
-  } else {
-    const seen = new Set;
-    targets = [];
-    for (const name of flags.variable ?? []) {
-      const matches = allOutputs.filter((o) => o.output.name === name && (flags.elementId === undefined || o.elementId === flags.elementId));
-      if (matches.length === 0) {
-        throw new Error(available ? `No variable matched "${name}"${flags.elementId ? ` in element ${flags.elementId}` : ""}. Available: ${available}.` : "This process has no taggable variables.");
+  ];
+  const listExamples = [
+    {
+      Description: "List cached nodes (every row carries AvailableOnTenant; FF-gated SDK-known nodes are included)",
+      Command: `${cmd} list --limit 2`,
+      Output: {
+        Code: "NodeListSuccess",
+        Data: [
+          {
+            NodeType: "uipath.slack.connector.send-message",
+            Category: "connector",
+            DisplayName: "Send Message",
+            Description: "Post a message to a Slack channel",
+            Version: "1.0.0",
+            Tags: "slack, messaging",
+            AvailableOnTenant: true
+          },
+          {
+            NodeType: "uipath.human-in-the-loop",
+            Category: "human-task",
+            DisplayName: "Human in the Loop",
+            Description: "Assign a task to a human and wait for completion",
+            Version: "1.0.0",
+            Tags: "human-task, hitl, human-in-the-loop, approval",
+            AvailableOnTenant: false
+          }
+        ]
       }
-      if (flags.elementId === undefined && new Set(matches.map((m) => m.elementId)).size > 1) {
-        const where = matches.map((m) => m.elementId).join(", ");
-        throw new Error(`Variable "${name}" exists in multiple elements (${where}). Pass --element-id to disambiguate (one --variable at a time), or --all to tag every occurrence.`);
+    }
+  ];
+  const searchExamples = [
+    {
+      Description: "Search nodes by keyword (every row carries AvailableOnTenant; FF-gated SDK-known nodes are included)",
+      Command: `${cmd} search slack`,
+      Output: {
+        Code: "NodeSearchSuccess",
+        Data: [
+          {
+            NodeType: "uipath.slack.connector.send-message",
+            Category: "connector",
+            DisplayName: "Send Message",
+            Description: "Post a message to a Slack channel",
+            Version: "1.0.0",
+            Tags: "slack, messaging",
+            AvailableOnTenant: true
+          }
+        ]
       }
-      for (const m of matches) {
-        if (!seen.has(m.output)) {
-          seen.add(m.output);
-          targets.push(m);
+    }
+  ];
+  const getExamples = [
+    {
+      Description: "Get the full schema for a node",
+      Command: `${cmd} get uipath.slack.connector.send-message`,
+      Output: {
+        Code: "NodeGetSuccess",
+        Data: {
+          Node: {
+            nodeType: "uipath.slack.connector.send-message",
+            category: "connector",
+            display: { label: "Send Message" },
+            inputDefinition: {
+              fields: [{ name: "channel", required: true }]
+            }
+          }
         }
       }
     }
-  }
-  const replaceTags = flags.tags !== undefined ? parseTagList(flags.tags) : undefined;
-  const addTags = parseTagList(flags.addTags);
-  const removeSet = new Set(parseTagList(flags.removeTags));
-  return targets.map(({ elementId, output }) => {
-    const next = replaceTags !== undefined ? [...new Set(replaceTags)] : [...new Set([...output.tags ?? [], ...addTags])].filter((tag) => !removeSet.has(tag));
-    output.tags = next;
-    return { elementId, name: output.name, tags: next };
-  });
-};
-var buildSettingsPath = (processKey) => `/processes/${encodeURIComponent(processKey)}/settings`;
-var validateFriendlyTagFlags = (options) => {
-  const variableCount = options.variable.length;
-  if (variableCount > 0 && options.all) {
-    return "Use either --variable or --all, not both.";
-  }
-  if (variableCount === 0 && !options.all) {
-    return "Specify the target with --variable <name> (repeatable, plus optional --element-id) or --all.";
-  }
-  if (variableCount > 1 && options.elementId !== undefined) {
-    return "--element-id only works with a single --variable; pass one --variable, or drop --element-id.";
-  }
-  const hasSearchable = options.searchable !== undefined;
-  const hasReplace = options.tags !== undefined;
-  const hasIncremental = options.addTags !== undefined || options.removeTags !== undefined;
-  if (hasSearchable && (hasReplace || hasIncremental)) {
-    return "Use --searchable <true|false>, or the low-level --tags/--add-tags/--remove-tags flags — not both.";
-  }
-  if (!hasSearchable && !hasReplace && !hasIncremental) {
-    return "Specify --searchable <true|false> to mark the variable searchable, or --tags/--add-tags/--remove-tags for other tags.";
-  }
-  if (hasReplace && hasIncremental) {
-    return "Use --tags to replace tags, or --add-tags/--remove-tags to adjust them — not both.";
-  }
-  return null;
-};
-var resolveTagFlags = (options) => {
-  if (options.searchable === undefined)
-    return options;
-  return {
-    variable: options.variable,
-    elementId: options.elementId,
-    all: options.all,
-    addTags: options.searchable ? SEARCHABLE_TAG : undefined,
-    removeTags: options.searchable ? undefined : SEARCHABLE_TAG
-  };
-};
-var setVariableTagsFromPayload = async (processKey, options) => {
-  const [fileError, variableTags] = await catchError(resolveJsonInput({ inline: options.inputs, allowStdin: true }));
-  if (fileError) {
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: "Error reading variable tags input",
-      Instructions: fileError.message
-    });
-    processContext.exit(1);
-    return;
-  }
-  if (variableTags === undefined) {
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: "Missing variable tags payload",
-      Instructions: "Provide --inputs <json|@file>, pipe JSON via stdin, or use the --variable/--all flags."
-    });
-    processContext.exit(1);
-    return;
-  }
-  const reqOptions = { folderKey: options.folderKey };
-  const currentSettings = await withPimsCall((config) => pimsGet(config, buildSettingsPath(processKey), reqOptions), "Error reading current process settings");
-  if (!currentSettings)
-    return;
-  const merged = { ...currentSettings, variableTags };
-  const result = await withPimsCall((config) => pimsPut(config, buildSettingsPath(processKey), merged, reqOptions), "Error updating variable tags");
-  if (!result)
-    return;
-  OutputFormatter.success({
-    Result: RESULTS.Success,
-    Code: "ProcessVariableTagsSet",
-    Data: result
-  });
-};
-var setVariableTagsFromFlags = async (processKey, options) => {
-  const reqOptions = { folderKey: options.folderKey };
-  const currentSettings = await withPimsCall((config) => pimsGet(config, buildSettingsPath(processKey), reqOptions), "Error reading current process settings");
-  if (!currentSettings)
-    return;
-  const variableTags = currentSettings.variableTags ?? {
-    elements: {},
-    sourcePackageVersion: "",
-    lastUpdateTimeUtc: ""
-  };
-  const [mutateError, updated] = catchError(() => applyFriendlyVariableTags(variableTags, resolveTagFlags(options)));
-  if (mutateError) {
-    OutputFormatter.error({
-      Result: RESULTS.Failure,
-      Message: "Error updating variable tags",
-      Instructions: mutateError.message
-    });
-    processContext.exit(1);
-    return;
-  }
-  const merged = { ...currentSettings, variableTags };
-  const result = await withPimsCall((config) => pimsPut(config, buildSettingsPath(processKey), merged, reqOptions), "Error updating variable tags");
-  if (!result)
-    return;
-  OutputFormatter.success({
-    Result: RESULTS.Success,
-    Code: "ProcessVariableTagsSet",
-    Data: { updated, variableTags }
-  });
-};
-var registerSharedProcessCommands = (processCmd, config) => {
-  const { toolLabel } = config;
-  const settingsCmd = processCmd.command("settings").description(`Manage ${toolLabel} process settings`);
-  settingsCmd.command("get").description(`Get settings for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").trackedAction(processContext, async (processKey, options) => {
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/processes/${encodeURIComponent(processKey)}/settings`, reqOptions), "Error getting process settings", { resource: "process", id: processKey });
-    if (!result)
+  ];
+  registry.command("pull").description(`Pull and sync node data from ${commandPrefix} registry (login first for full registry)`).option("-f, --force", "Force refresh, ignore cache").examples(pullExamples).trackedAction(processContext, async (options) => {
+    const { MANIFEST_VALIDATION_NEXT_STEP, pullNodes } = await import("./node-sync-service-68vq10je.js");
+    const [error, result] = await catchError2(pullNodes({
+      force: options.force
+    }));
+    if (error) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "Error pulling nodes",
+        Instructions: error.message
+      });
+      processContext.exit(1);
+      return;
+    }
+    if (result.failures?.length) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: `The tenant manifest failed validation, so the pull returned only ${result.syncedCount} OOTB nodes; the cache was not updated`,
+        Instructions: `registry get/search keep serving this tenant's previous cache, if there is one, until it is 30 minutes old. ${MANIFEST_VALIDATION_NEXT_STEP} The validation error is in Data.Failures.`,
+        Retry: "RetryWillNotFix",
+        Data: {
+          NodesCount: result.syncedCount,
+          Source: result.source,
+          CacheWritten: false,
+          Failures: result.failures.map((f) => ({
+            Source: f.source,
+            Reason: f.reason
+          }))
+        }
+      });
+      processContext.exit(1);
       return;
+    }
+    const missing = result.missingSources ?? [];
+    const base = result.fromCache ? `Using cached nodes (age: ${result.ageMinutes}m)` : "Synced fresh nodes";
+    const message = missing.length ? `${base}; missing node sources: ${missing.map((m) => m.source).join(", ")}` : base;
+    const finalMessage = result.info ? `${message}. ${result.info}` : message;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ProcessSettingsGet",
-      Data: result
+      Code: "NodePullSuccess",
+      Data: {
+        NodesCount: result.syncedCount,
+        FromCache: result.fromCache,
+        AgeMinutes: result.ageMinutes,
+        Source: result.source,
+        CacheWritten: result.cacheWritten,
+        Message: finalMessage,
+        Info: result.info,
+        ...missing.length > 0 && {
+          MissingSources: missing.map((m) => ({
+            Source: m.source,
+            Reason: m.reason
+          }))
+        }
+      }
     });
   });
-  settingsCmd.command("set").description(`Update settings for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--inputs <value>", "Settings payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (processKey, options) => {
-    const [fileError, body] = await catchError(resolveJsonInput({
-      inline: options.inputs,
-      allowStdin: true
-    }));
-    if (fileError) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Error reading settings input",
-        Instructions: fileError.message
+  registry.command("list").description("Sample cached nodes to inspect their config structure (default: first 20). Output merges tenant nodes with the SDK-known catalog; every row carries `AvailableOnTenant` so callers can filter FF-gated rows. Use 'search' to find nodes — use --limit -1 only if you need the full list (the result can be huge and unreadable).").addHelpText("after", `
+Examples:
+  ${cmd} list
+  ${cmd} list --limit 200
+  ${cmd} list --limit -1
+
+In-solution (--local):
+  cd MySolution/MyFlow && ${cmd} list --local`).option("-l, --limit <n>", "Number of nodes to return (1-10000, default: 20, -1 for all)", parseListLimit, 20).option("--offset <number>", "Number of nodes to skip (0-1000000)", parseOffset, 0).option("--local", "Show only in-solution project nodes (requires .uipx in CWD, parent, or grandparent). Omits `AvailableOnTenant` (no tenant lookup).").examples(listExamples).trackedAction(processContext, async (options) => {
+    const {
+      getLocalSolutionSnapshot,
+      listNodes,
+      localContractWarning
+    } = await import("./node-sync-service-68vq10je.js");
+    const showAll = options.limit === ALL_NODES;
+    if (options.local) {
+      const [error, snapshot] = await catchError2(getLocalSolutionSnapshot());
+      if (error) {
+        OutputFormatter.error({
+          Result: RESULTS.Failure,
+          Message: "Error listing nodes",
+          Instructions: error.message
+        });
+        processContext.exit(1);
+        return;
+      }
+      const localNodes = snapshot.manifests;
+      const totalCount = localNodes.length;
+      const effectiveLimit = showAll ? totalCount : options.limit;
+      const nodes = localNodes.slice(options.offset, options.offset + effectiveLimit);
+      const truncated = options.offset + nodes.length < totalCount;
+      const warning = localContractWarning(snapshot, nodes);
+      OutputFormatter.success({
+        Result: RESULTS.Success,
+        Code: "NodeListSuccess",
+        Data: nodes.map(flattenNodeForDisplay),
+        Pagination: new Pagination({
+          returned: nodes.length,
+          limit: effectiveLimit,
+          offset: options.offset,
+          total: totalCount
+        }),
+        ...await localResultNotes(warning)
       });
-      processContext.exit(1);
+      if (truncated) {
+        logger.info(`Showing ${shownRows(nodes.length, options.offset)} of ${totalCount}. Use --limit, --offset or --limit -1 to get more, or use 'search' to filter.`);
+      }
       return;
     }
-    if (body === undefined) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Missing settings payload",
-        Instructions: "Provide --inputs <json|@file> or pipe JSON via stdin."
-      });
+    const [error, tenantNodes] = await catchError2(listNodes());
+    if (error) {
+      OutputFormatter.error(await classifiedFailure("Error listing nodes", error));
       processContext.exit(1);
       return;
     }
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsPut(config2, `/processes/${encodeURIComponent(processKey)}/settings`, body, reqOptions), "Error updating process settings");
-    if (!result)
-      return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "ProcessSettingsSet",
-      Data: result
-    });
-  });
-  const variableTagsCmd = processCmd.command("variable-tags").description(`Manage ${toolLabel} process variable tags`);
-  variableTagsCmd.command("get").description(`Get variable tags for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").trackedAction(processContext, async (processKey, options) => {
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/processes/${encodeURIComponent(processKey)}/settings`, reqOptions), "Error getting variable tags", { resource: "process", id: processKey });
-    if (!result)
-      return;
+    const merged = await mergeWithKnownSdkNodes(tenantNodes);
+    const totalCount = merged.length;
+    const effectiveLimit = showAll ? totalCount : options.limit;
+    const slice = merged.slice(options.offset, options.offset + effectiveLimit);
+    const truncated = options.offset + slice.length < totalCount;
+    const gatedCount = merged.filter((m) => !m.availableOnTenant).length;
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ProcessVariableTagsGet",
-      Data: result.variableTags ?? {}
+      Code: "NodeListSuccess",
+      Data: slice.map((m) => flattenNodeWithAvailability(m.node, m.availableOnTenant)),
+      Pagination: new Pagination({
+        returned: slice.length,
+        limit: effectiveLimit,
+        offset: options.offset,
+        total: totalCount
+      })
     });
+    if (truncated) {
+      logger.info(`Showing ${shownRows(slice.length, options.offset)} of ${totalCount} (${gatedCount} not enabled on this tenant). Use --limit, --offset or --limit -1 to get more.`);
+    } else if (gatedCount > 0) {
+      logger.info(`${gatedCount} of ${totalCount} node type(s) are not enabled on this tenant (AvailableOnTenant=false).`);
+    }
   });
-  variableTagsCmd.command("set").description(`Update variable tags for a ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("-f, --folder-key <key>", "Folder key (GUID)").option("--variable <name>", "Name of a variable (output) to tag. Repeatable — pass it multiple times to tag several variables in one call.", collectValue, []).option("--element-id <id>", "Element that owns the variable (disambiguates when the same name appears in multiple elements). Only valid with a single --variable.").option("--all", "Apply the change to every taggable variable").option("--searchable <boolean>", "Mark the variable searchable for instance filtering ('true' or 'false')", parseBooleanFlag).option("--tags <list>", "Advanced: comma-separated tags to set, replacing the variable's current tags (empty value clears them)").option("--add-tags <list>", "Comma-separated tags to add to the variable's current tags").option("--remove-tags <list>", "Comma-separated tags to remove from the variable's current tags").option("--inputs <value>", "Full variable tags payload as JSON string, @file path, or piped via stdin").trackedAction(processContext, async (processKey, options) => {
-    const friendlyRequested = options.variable.length > 0 || options.elementId !== undefined || options.all === true || options.searchable !== undefined || options.tags !== undefined || options.addTags !== undefined || options.removeTags !== undefined;
-    if (options.inputs !== undefined && friendlyRequested) {
+  registry.command("search").description("Find nodes by keyword and/or field filters").addHelpText("after", `
+Filter syntax:
+  field=value                    equality (default operator)
+  field:contains=value           field contains value
+  field:startsWith=value         field starts with value
+  field:endsWith=value           field ends with value
+  field:in=value1,value2         field matches any of the values
+  field1=v1,field2=v2            multiple conditions (AND logic)
+
+Filterable fields:
+  category / cat                 e.g. "connector", "agent"
+  type / nodetype                node type identifier
+  tags / tag                     node tags
+  displayname / name / label     human-readable display name
+
+Examples:
+  ${cmd} search slack
+  ${cmd} search --filter "category=connector"
+  ${cmd} search --filter "displayname:contains=send message"
+  ${cmd} search slack --filter "category=connector"
+  ${cmd} search --filter "tags:in=ai,automation"
+  ${cmd} search --filter "category=connector,displayname:contains=slack"
+
+Tip: pipe through --output-filter to extract just the nodeType values:
+  ${cmd} search slack --output-filter "[*].NodeType"
+
+In-solution (--local):
+  cd MySolution/MyFlow && ${cmd} search agent --local`).argument("[keyword]", "Search term matched against nodeType, category, tags, display name, and description").option("-f, --filter <filter>", "Structured field filter: field=value or field:operator=value. Comma-separated = AND. Fields: category, type, tags, displayname, description.").option("--local", "Search only in-solution project nodes (requires .uipx in CWD, parent, or grandparent). Omits `AvailableOnTenant` (no tenant lookup).").examples(searchExamples).trackedAction(processContext, async (keyword, options) => {
+    let parsedFilters;
+    if (options.filter) {
+      const [parseError, parsed] = catchError2(() => parseFilterString(options.filter));
+      if (parseError) {
+        if (parseError instanceof FilterParseError) {
+          OutputFormatter.error({
+            Result: RESULTS.Failure,
+            Message: "Invalid filter syntax",
+            Instructions: `${parseError.message} Examples: category=agent, displayname:contains=http, tags:in=ai,automation.`
+          });
+          processContext.exit(1);
+          return;
+        }
+        OutputFormatter.error({
+          Result: RESULTS.Failure,
+          Message: "Error searching nodes",
+          Instructions: parseError.message
+        });
+        processContext.exit(1);
+        return;
+      }
+      parsedFilters = parsed;
+    }
+    if (!keyword && !parsedFilters) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
-        Message: "Error updating variable tags",
-        Instructions: "Provide either --inputs (full JSON payload) or the --searchable/--variable/--all flags, not both."
+        Message: "Search requires either a keyword or filters",
+        Instructions: "Provide a keyword or use --filter flag"
       });
       processContext.exit(1);
       return;
     }
-    if (friendlyRequested) {
-      const validationError = validateFriendlyTagFlags(options);
-      if (validationError) {
+    const {
+      filterNodesByKeyword,
+      getLocalSolutionSnapshot,
+      localContractWarning,
+      searchNodeSummariesWithAvailability,
+      searchNodes,
+      searchNodesWithFilters
+    } = await import("./node-sync-service-68vq10je.js");
+    const searchLocal = () => parsedFilters ? searchNodesWithFilters(keyword, parsedFilters, {
+      local: true
+    }) : searchNodes(keyword, { local: true });
+    if (options.local) {
+      const [searchError, snapshot] = await catchError2(getLocalSolutionSnapshot());
+      if (searchError) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
-          Message: "Error updating variable tags",
-          Instructions: validationError
+          Message: "Error searching nodes",
+          Instructions: searchError.message
         });
         processContext.exit(1);
         return;
       }
-      await setVariableTagsFromFlags(processKey, options);
+      const { searchWithFilters } = await import("./filter-engine-dh9s90gb.js");
+      const results = parsedFilters ? searchWithFilters(snapshot.manifests, keyword, parsedFilters) : filterNodesByKeyword(snapshot.manifests, keyword);
+      const warning = localContractWarning(snapshot, results);
+      OutputFormatter.success({
+        Result: RESULTS.Success,
+        Code: "NodeSearchSuccess",
+        Data: results.map(flattenNodeForDisplay),
+        ...await localResultNotes(warning)
+      });
       return;
     }
-    await setVariableTagsFromPayload(processKey, options);
-  });
-  attachSharedExamples(settingsCmd);
-  attachSharedExamples(variableTagsCmd);
-};
-
-// ../maestro-sdk/src/shared-commands/processes.ts
-async function findProcessSummary(config, processKey, folderKey, processType) {
-  const page = await pimsGet(config, `/processes/summary${buildQueryString({ processType, processKey })}`, { folderKey });
-  const summaries = Array.isArray(page?.processes) ? page.processes : [];
-  return summaries.find((summary) => summary.processKey === processKey) ?? null;
-}
-var registerSharedProcessesCommands = (program, config) => {
-  const { toolLabel, processType } = config;
-  const incidentsQuery = buildQueryString({ processType });
-  const processes = program.command("processes").description(`Manage ${toolLabel} process summaries`);
-  processes.command("list").description(`List all ${toolLabel} process summaries`).option("--folder-key <key>", "Folder key").option("-l, --limit <number>", "Number of items to return (1-10000)", parseLimit).option("--offset <number>", "Number of items to skip (0-1000000)", parseOffset, 0).option("--status <status>", "Filter by process status").trackedAction(processContext, async (options) => {
-    const query = buildQueryString({
-      processType,
-      status: options.status,
-      $top: options.limit,
-      $skip: options.offset !== 0 ? options.offset : undefined
-    });
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/processes/summary${query}`, reqOptions), "Error listing processes");
-    if (!result)
+    const [searchError, results] = await catchError2(searchNodeSummariesWithAvailability(keyword, parsedFilters));
+    if (searchError) {
+      OutputFormatter.error(await classifiedFailure("Error searching nodes", searchError));
+      processContext.exit(1);
       return;
+    }
+    let warning;
+    if (results.length === 0) {
+      const [, localMatches] = await catchError2(searchLocal());
+      if (localMatches && localMatches.length > 0) {
+        warning = `No tenant node matches, but ${localMatches.length} node(s) from projects in this solution do. Re-run the same search with --local.`;
+      }
+    }
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ProcessList",
-      Data: result
+      Code: "NodeSearchSuccess",
+      Data: results.map((result) => flattenNodeWithAvailability(result.node, result.availableOnTenant)),
+      ...warning ? { Warning: warning } : {}
     });
   });
-  processes.command("incidents").description(`Get incidents for a specific ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("--folder-key <key>", "Folder key").trackedAction(processContext, async (processKey, options) => {
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/incidents/process/${encodeURIComponent(processKey)}${incidentsQuery}`, reqOptions), "Error getting process incidents", { resource: "process", id: processKey });
-    if (!result)
+  registry.command("get").description("Get the full schema for a single node. For connector nodes (uipath.connector.*), the base manifest is automatically enriched with live metadata from Integration Service.").addHelpText("after", `
+IS-enriched fields (connector nodes only, fetched live from Integration Service):
+
+  Activity nodes (uipath.connector.*, not trigger):
+    inputDefinition.fields    Fields to configure. Each field has: name, displayName, type, required, and optionally reference (lookup: objectName, path, lookupValue, lookupNames, childPath; 4.0.0 activities carry scriptRef instead of objectName — resolve with 'uip is resources run script --script-ref') or enum.
+    outputResponseDefinition  Fields produced after the node runs.
+    connectorMethodInfo       HTTP details (method, path, operationId).
+    --connection-id optional — adds custom fields specific to that account.
+
+  Trigger nodes (uipath.connector.trigger.*):
+    eventParameters           Fields that configure the trigger (e.g. which folder to watch).
+    filterFields              Fields used to filter which events fire the trigger.
+    outputResponseDefinition  Fields produced by the trigger event payload.
+    eventMode                 "webhooks" or "polling".
+    login + --connection-id required — without both, no enrichment is returned.
+
+Examples:
+  ${cmd} get uipath.slack.connector.send-message
+  ${cmd} get uipath.connector.uipath-salesforce-slack.send-message --connection-id <id>
+  ${cmd} get uipath.connector.trigger.uipath-microsoft-outlook365.email-received --connection-id <id>
+
+In-solution (--local):
+  cd MySolution/MyFlow && ${cmd} get <node-type> --local`).argument("<node-type>", `Node type identifier — get it from '${cmd} search'`).option("--connection-id <id>", "Connection ID for Integration Service connector node enrichment. Required for connector trigger nodes; optional for connector activity nodes.").option("--local", "Get node from in-solution projects only (requires .uipx in CWD, parent, or grandparent)").examples(getExamples).trackedAction(processContext, async (nodeType, options) => {
+    const { getLocalNodeEnriched, getNode, getNodeEnriched } = await import("./node-sync-service-68vq10je.js");
+    const [error, lookedUp] = await catchError2(options.local ? getLocalNodeEnriched(nodeType, options.connectionId) : getNodeEnriched(nodeType, options.connectionId, {
+      local: options.local
+    }).then((node) => ({ node, warning: undefined })));
+    if (error) {
+      OutputFormatter.error(await classifiedFailure("Error retrieving node", error));
+      processContext.exit(1);
       return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "ProcessIncidents",
-      Data: result
-    });
-  });
-  processes.command("diagnose").description(`Correlate ${toolLabel} process summary, incidents, and error codes`).argument("<process-key>", "Process definition key").requiredOption("--folder-key <key>", "Folder key").trackedAction(processContext, async (processKey, options) => {
-    const result = await withPimsCall(async (config2) => {
-      const summary = await findProcessSummary(config2, processKey, options.folderKey, processType);
-      const incidents = await pimsGet(config2, `/incidents/process/${encodeURIComponent(processKey)}${incidentsQuery}`, { folderKey: options.folderKey });
-      const errorCodes = await pimsGet(config2, `/incidents/process/${encodeURIComponent(processKey)}/error-codes`, { folderKey: options.folderKey });
-      return {
-        summary,
-        incidents,
-        errorCodes: errorCodes.errorCodes || []
-      };
-    }, "Error diagnosing process");
-    if (!result)
+    }
+    const result = lookedUp?.node;
+    const warning = lookedUp?.warning;
+    if (!result) {
+      const [, inSolution] = options.local ? [undefined, null] : await catchError2(getNode(nodeType, { local: true }));
+      const withoutProcessResource = inSolution ? undefined : await explainNodeTypeWithoutProcessResource(nodeType);
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: withoutProcessResource?.message ?? "Node not found",
+        Instructions: withoutProcessResource?.instructions ?? (inSolution ? `'${nodeType}' is a node of a project in this solution, which only --local looks up. Run: ${cmd} get ${nodeType} --local` : `No node found with node type: ${nodeType}`),
+        ErrorCode: "not_found"
+      });
+      processContext.exit(1);
       return;
+    }
     OutputFormatter.success({
       Result: RESULTS.Success,
-      Code: "ProcessDiagnostics",
+      Code: "NodeGetSuccess",
       Data: {
-        ProcessKey: processKey,
-        FolderKey: options.folderKey,
-        Summary: result.summary,
-        FaultedCount: result.summary?.faultedCount ?? null,
-        RunningCount: result.summary?.runningCount ?? null,
-        Incidents: result.incidents,
-        IncidentCount: result.incidents.length,
-        ErrorCodes: result.errorCodes,
-        ErrorCodeCount: result.errorCodes.length
-      }
-    });
-  });
-  processes.command("error-codes").description(`Get unique error codes for a specific ${toolLabel} process`).argument("<process-key>", "Process definition key").requiredOption("--folder-key <key>", "Folder key").trackedAction(processContext, async (processKey, options) => {
-    const reqOptions = { folderKey: options.folderKey };
-    const result = await withPimsCall((config2) => pimsGet(config2, `/incidents/process/${encodeURIComponent(processKey)}/error-codes`, reqOptions), "Error getting process error codes", { resource: "process", id: processKey });
-    if (!result)
-      return;
-    OutputFormatter.success({
-      Result: RESULTS.Success,
-      Code: "ProcessIncidentErrorCodes",
-      Data: result.errorCodes || []
-    });
+        Node: result
+      },
+      ...warning ? { Warning: warning } : {}
+    }, { preserveDataKeys: true });
   });
-  attachSharedExamples(processes);
 };
 
 export { registerRegistryCommand, registerSharedDebugInstanceCommands, registerSharedIncidentCommands, registerSharedInstanceCommands, registerSharedProcessCommands, registerSharedProcessesCommands };
 
-//# debugId=7138755E22A0856964756E2164756E21
+//# debugId=2A3CACF7B45A0E8E64756E2164756E21