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

package/dist/{packager-tool-h7cjs093.js → packager-tool-2z0r1f32.js}

@@ -1,23 +1,24 @@
 import {
   resolveJsonInput
-} from "./packager-tool-py93409h.js";
+} from "./packager-tool-ymma2s85.js";
 import {
   DEBUG_MODE_MAP,
   SIMULATION_MODE_MAP,
   beginDebugSession,
   createDebugInstance,
+  fetchDebugInstanceVariables,
   getPersonalFolderKey
-} from "./packager-tool-peawy22c.js";
+} from "./packager-tool-tqjfdpda.js";
 import {
   debugPimsGet,
   debugPimsPatch,
   debugPimsPost,
   debugPimsPut
-} from "./packager-tool-3dc9gz35.js";
+} from "./packager-tool-frjt46rb.js";
 import {
   getAuthContext,
   getLoginStatusAsync
-} from "./packager-tool-6h69pd2a.js";
+} from "./packager-tool-kn86394c.js";
 import {
   DEFAULT_PAGE_SIZE,
   EXIT_CODES,
@@ -25,7 +26,6 @@ import {
   OutputFormatter,
   Pagination,
   RESULTS,
-  catchError,
   extractErrorMessage,
   isGuid,
   logger,
@@ -33,7 +33,10 @@ import {
   parseLimit,
   parseOffset,
   processContext
-} from "./packager-tool-02f63a08.js";
+} from "./packager-tool-apawc11t.js";
+import {
+  catchError
+} from "./packager-tool-t7ahhaer.js";
 import {
   __require
 } from "./packager-tool-1yh8g550.js";
@@ -301,6 +304,30 @@ function flattenNodeForDisplay(n) {
     Tags: (n.tags ?? []).join(", ")
   };
 }
+async function missingProcessResourceHint() {
+  const {
+    describeProjectsWithoutProcessResource,
+    findProjectsWithoutProcessResource,
+    findSolutionFromCwd
+  } = await import("./solution-discovery-vqravtkh.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-vqravtkh.js");
+  const [, explanation] = await catchError(discovery.explainNodeTypeWithoutProcessResource(nodeType));
+  return explanation;
+}
 function flattenNodeWithAvailability(n, availableOnTenant) {
   return {
     ...flattenNodeForDisplay(n),
@@ -308,7 +335,7 @@ function flattenNodeWithAvailability(n, availableOnTenant) {
   };
 }
 async function mergeWithKnownSdkNodes(tenantNodes) {
-  const { listKnownSdkNodes } = await import("./known-types-q6fcyq2e.js");
+  const { listKnownSdkNodes } = await import("./known-types-3025scz1.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()) {
@@ -321,6 +348,13 @@ async function mergeWithKnownSdkNodes(tenantNodes) {
   }
   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", `
@@ -429,7 +463,7 @@ Subcommands:
     }
   ];
   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 { pullNodes } = await import("./node-sync-service-ccwgtyte.js");
+    const { MANIFEST_VALIDATION_NEXT_STEP, pullNodes } = await import("./node-sync-service-yvyf7chw.js");
     const [error, result] = await catchError(pullNodes({
       force: options.force
     }));
@@ -442,7 +476,28 @@ Subcommands:
       processContext.exit(1);
       return;
     }
-    const message = result.fromCache ? `Using cached nodes (age: ${result.ageMinutes}m)` : "Synced fresh nodes";
+    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
+          }))
+        }
+      });
+      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,
@@ -454,7 +509,13 @@ Subcommands:
         Source: result.source,
         CacheWritten: result.cacheWritten,
         Message: finalMessage,
-        Info: result.info
+        Info: result.info,
+        ...missing.length > 0 && {
+          MissingSources: missing.map((m) => ({
+            Source: m.source,
+            Reason: m.reason
+          }))
+        }
       }
     });
   });
@@ -465,18 +526,48 @@ Examples:
   ${cmd} list --limit -1
 
 In-solution (--local):
-  cd MySolution/MyFlow && ${cmd} list --local`).option("-l, --limit <n>", "Number of nodes to return (default: 20, -1 for all)", (v) => Number.parseInt(v, 10), 20).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) => {
-    if (Number.isNaN(options.limit) || options.limit < 1 && options.limit !== -1) {
-      OutputFormatter.error({
-        Result: RESULTS.Failure,
-        Message: "Invalid --limit value",
-        Instructions: "Provide a positive integer (e.g. --limit 100) or -1 for all nodes"
+  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-yvyf7chw.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;
+      }
+      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)
       });
-      processContext.exit(1);
+      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.`);
+      }
       return;
     }
-    const { listNodes } = await import("./node-sync-service-ccwgtyte.js");
-    const [error, tenantNodes] = await catchError(listNodes({ local: options.local }));
+    const [error, tenantNodes] = await catchError(listNodes());
     if (error) {
       OutputFormatter.error({
         Result: RESULTS.Failure,
@@ -486,35 +577,25 @@ In-solution (--local):
       processContext.exit(1);
       return;
     }
-    const showAll = options.limit === -1;
-    if (options.local) {
-      const totalCount2 = tenantNodes.length;
-      const effectiveLimit2 = showAll ? totalCount2 : options.limit;
-      const nodes = tenantNodes.slice(0, effectiveLimit2);
-      const truncated2 = nodes.length < totalCount2;
-      OutputFormatter.success({
-        Result: RESULTS.Success,
-        Code: "NodeListSuccess",
-        Data: nodes.map(flattenNodeForDisplay)
-      });
-      if (truncated2) {
-        logger.info(`Showing first ${nodes.length} of ${totalCount2}. Use --limit or --limit -1 to get more, or use 'search' to filter.`);
-      }
-      return;
-    }
     const merged = await mergeWithKnownSdkNodes(tenantNodes);
     const totalCount = merged.length;
     const effectiveLimit = showAll ? totalCount : options.limit;
-    const slice = merged.slice(0, effectiveLimit);
-    const truncated = slice.length < totalCount;
+    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))
+      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 first ${slice.length} of ${totalCount} (${gatedCount} not enabled on this tenant). Use --limit or --limit -1 to get more.`);
+      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).`);
     }
@@ -580,15 +661,18 @@ In-solution (--local):
       return;
     }
     const {
+      filterNodesByKeyword,
+      getLocalSolutionSnapshot,
+      localContractWarning,
       searchNodeSummariesWithAvailability,
       searchNodes,
       searchNodesWithFilters
-    } = await import("./node-sync-service-ccwgtyte.js");
+    } = await import("./node-sync-service-yvyf7chw.js");
     const searchLocal = () => parsedFilters ? searchNodesWithFilters(keyword, parsedFilters, {
       local: true
     }) : searchNodes(keyword, { local: true });
     if (options.local) {
-      const [searchError2, results2] = await catchError(searchLocal());
+      const [searchError2, snapshot] = await catchError(getLocalSolutionSnapshot());
       if (searchError2) {
         OutputFormatter.error({
           Result: RESULTS.Failure,
@@ -598,10 +682,14 @@ In-solution (--local):
         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)
+        Data: results2.map(flattenNodeForDisplay),
+        ...await localResultNotes(warning2)
       });
       return;
     }
@@ -652,10 +740,10 @@ Examples:
 
 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 { getNode, getNodeEnriched } = await import("./node-sync-service-ccwgtyte.js");
-    const [error, result] = await catchError(getNodeEnriched(nodeType, options.connectionId, {
+    const { getLocalNodeEnriched, getNode, getNodeEnriched } = await import("./node-sync-service-yvyf7chw.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,
@@ -665,12 +753,15 @@ In-solution (--local):
       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: "Node not found",
-        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}`,
+        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);
@@ -681,7 +772,8 @@ In-solution (--local):
       Code: "NodeGetSuccess",
       Data: {
         Node: result
-      }
+      },
+      ...warning ? { Warning: warning } : {}
     }, { preserveDataKeys: true });
   });
 };
@@ -747,6 +839,505 @@ async function withDebugPimsCall(fn, errorMessage) {
   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" }
+    }
+  }),
+  "instance element retry": (prefix) => ({
+    Description: "Retry one faulted element of an instance",
+    Command: `${prefix} instance element retry ${INSTANCE} ${ELEMENT} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ElementRetried",
+      Data: { InstanceId: INSTANCE, Status: "Running" }
+    }
+  }),
+  "incident summary": (prefix) => ({
+    Description: "Summarize the open incidents in a folder by error",
+    Command: `${prefix} incident summary --folder-key ${FOLDER} --limit 2`,
+    Output: {
+      Code: "IncidentSummary",
+      Data: [
+        {
+          ProcessKey: PROCESS,
+          ErrorCode: "TaskFailed",
+          ErrorMessage: "The action app returned an error",
+          Count: 3,
+          FirstTimeUtc: "2026-10-12T15:02:00Z"
+        }
+      ]
+    }
+  }),
+  "incident get": (prefix) => ({
+    Description: "Get one incident with its error details",
+    Command: `${prefix} incident get ${INCIDENT} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "IncidentGet",
+      Data: {
+        IncidentId: INCIDENT,
+        InstanceId: INSTANCE,
+        ProcessKey: PROCESS,
+        IncidentStatus: "Open",
+        ElementId: ELEMENT,
+        ErrorCode: "TaskFailed",
+        ErrorMessage: "The action app returned an error",
+        ErrorTime: "2026-10-12T15:02:00Z"
+      }
+    }
+  }),
+  "process settings get": (prefix) => ({
+    Description: "Read a process's settings",
+    Command: `${prefix} process settings get ${PROCESS} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ProcessSettingsGet",
+      Data: {
+        VariableTags: {
+          Elements: {},
+          SourcePackageVersion: "1.0.3",
+          LastUpdateTimeUtc: "2026-10-12T15:00:00Z"
+        }
+      }
+    }
+  }),
+  "process settings set": (prefix) => ({
+    Description: "Replace a process's settings from a file",
+    Command: `${prefix} process settings set ${PROCESS} --folder-key ${FOLDER} --inputs @settings.json`,
+    Output: {
+      Code: "ProcessSettingsSet",
+      Data: {}
+    }
+  }),
+  "process variable-tags get": (prefix) => ({
+    Description: "Read which variables are tagged for instance search",
+    Command: `${prefix} process variable-tags get ${PROCESS} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ProcessVariableTagsGet",
+      Data: {
+        Elements: {},
+        SourcePackageVersion: "1.0.3",
+        LastUpdateTimeUtc: "2026-10-12T15:00:00Z"
+      }
+    }
+  }),
+  "process variable-tags set": (prefix) => ({
+    Description: "Make a variable searchable when filtering instances",
+    Command: `${prefix} process variable-tags set ${PROCESS} --folder-key ${FOLDER} --variable claimAmount --searchable true`,
+    Output: {
+      Code: "ProcessVariableTagsSet",
+      Data: {
+        Updated: [
+          {
+            ElementId: ELEMENT,
+            Name: "claimAmount",
+            Tags: ["Searchable"]
+          }
+        ],
+        VariableTags: {
+          Elements: {
+            [ELEMENT]: {
+              Outputs: [
+                {
+                  Name: "claimAmount",
+                  Tags: ["Searchable"],
+                  ExtractPath: "claimAmount",
+                  Label: "Claim amount",
+                  ExtractedValueType: "number"
+                }
+              ]
+            }
+          },
+          SourcePackageVersion: "1.0.3",
+          LastUpdateTimeUtc: "2026-10-12T15:00:00Z"
+        }
+      }
+    }
+  }),
+  "processes list": (prefix) => ({
+    Description: "List processes with their running and faulted counts",
+    Command: `${prefix} processes list --folder-key ${FOLDER} --limit 2`,
+    Output: {
+      Code: "ProcessList",
+      Data: {
+        Processes: [
+          { ProcessKey: PROCESS, RunningCount: 4, FaultedCount: 1 }
+        ]
+      }
+    }
+  }),
+  "processes incidents": (prefix) => ({
+    Description: "List a process's incidents",
+    Command: `${prefix} processes incidents ${PROCESS} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ProcessIncidents",
+      Data: [
+        {
+          IncidentId: INCIDENT,
+          InstanceId: INSTANCE,
+          ProcessKey: PROCESS,
+          ElementId: ELEMENT,
+          IncidentStatus: "Open",
+          ErrorCode: "TaskFailed",
+          ErrorMessage: "The action app returned an error"
+        }
+      ]
+    }
+  }),
+  "processes diagnose": (prefix) => ({
+    Description: "Diagnose why a process's instances fault",
+    Command: `${prefix} processes diagnose ${PROCESS} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ProcessDiagnostics",
+      Data: {
+        ProcessKey: PROCESS,
+        FolderKey: FOLDER,
+        Summary: {
+          ProcessKey: PROCESS,
+          RunningCount: 4,
+          FaultedCount: 1
+        },
+        FaultedCount: 1,
+        RunningCount: 4,
+        Incidents: [
+          {
+            IncidentId: INCIDENT,
+            InstanceId: INSTANCE,
+            ElementId: ELEMENT,
+            ErrorCode: "TaskFailed"
+          }
+        ],
+        IncidentCount: 1,
+        ErrorCodes: [
+          {
+            ErrorCode: "TaskFailed",
+            ErrorMessage: "The action app returned an error"
+          }
+        ],
+        ErrorCodeCount: 1
+      }
+    }
+  }),
+  "processes error-codes": (prefix) => ({
+    Description: "List the error codes a process's incidents carry",
+    Command: `${prefix} processes error-codes ${PROCESS} --folder-key ${FOLDER}`,
+    Output: {
+      Code: "ProcessIncidentErrorCodes",
+      Data: [
+        {
+          ErrorCode: "TaskFailed",
+          ErrorMessage: "The action app returned an error"
+        }
+      ]
+    }
+  }),
+  "debug-instance 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`,
+    Output: {
+      Code: "DebugInstanceCreated",
+      Data: {
+        InstanceId: INSTANCE,
+        RunId: "a7b8c9d0-0000-4000-8000-000000000007",
+        JobKey: "b8c9d0e1-0000-4000-8000-000000000008"
+      }
+    }
+  }),
+  "debug-instance status": (prefix) => ({
+    Description: "Check where a debug run is",
+    Command: `${prefix} debug-instance status ${INSTANCE}`,
+    Output: {
+      Code: "DebugInstanceStatus",
+      Data: {
+        InstanceId: INSTANCE,
+        Status: "Paused",
+        StartedTimeUtc: "2026-10-13T09:12:00Z",
+        CompletedTimeUtc: null
+      }
+    }
+  }),
+  "debug-instance breakpoints": (prefix) => ({
+    Description: "Replace a debug run's breakpoints from a file",
+    Command: `${prefix} debug-instance breakpoints ${INSTANCE} --inputs @breakpoints.json`,
+    Output: {
+      Code: "DebugInstanceBreakpointsUpdated",
+      Data: {}
+    }
+  }),
+  "debug-instance cancel": (prefix) => ({
+    Description: "Stop a debug run",
+    Command: `${prefix} debug-instance cancel ${INSTANCE}`,
+    Output: {
+      Code: "DebugInstanceCanceled",
+      Data: {}
+    }
+  }),
+  "debug-instance continue": (prefix) => ({
+    Description: "Continue a paused debug run",
+    Command: `${prefix} debug-instance continue ${INSTANCE}`,
+    Output: {
+      Code: "DebugInstanceContinued",
+      Data: {}
+    }
+  }),
+  "debug-instance incidents": (prefix) => ({
+    Description: "List the incidents a debug run raised",
+    Command: `${prefix} debug-instance incidents ${INSTANCE}`,
+    Output: {
+      Code: "DebugInstanceIncidents",
+      Data: [
+        {
+          IncidentId: INCIDENT,
+          ElementId: ELEMENT,
+          ErrorCode: "TaskFailed"
+        }
+      ]
+    }
+  }),
+  "debug-instance variables": (prefix) => ({
+    Description: "Read a paused debug run's variables",
+    Command: `${prefix} debug-instance variables ${INSTANCE}`,
+    Output: {
+      Code: "DebugInstanceVariables",
+      Data: { InstanceId: INSTANCE, Globals: {}, Elements: [] }
+    }
+  }),
+  "debug-instance variables-set": (prefix) => ({
+    Description: "Patch a paused debug run's variables from a file",
+    Command: `${prefix} debug-instance variables-set ${INSTANCE} --inputs @patch.json`,
+    Output: {
+      Code: "DebugInstanceVariablesSet",
+      Data: {}
+    }
+  }),
+  "debug-instance variables-all": (prefix) => ({
+    Description: "Read the variables of every scope in a debug run",
+    Command: `${prefix} debug-instance variables-all ${INSTANCE}`,
+    Output: {
+      Code: "DebugInstanceVariablesAll",
+      Data: { Variables: [] }
+    }
+  })
+};
+var pathOf = (command) => {
+  const names = [];
+  for (let at = command;at !== null; at = at.parent) {
+    if (at.parent === null)
+      break;
+    names.unshift(at.name());
+  }
+  return ["uip", ...names];
+};
+var attachSharedExamples = (group) => {
+  const visit = (command) => {
+    if (command.commands.length > 0) {
+      for (const child of command.commands)
+        visit(child);
+      return;
+    }
+    const path = pathOf(command);
+    for (let words = 3;words >= 2; words -= 1) {
+      const key = path.slice(-words).join(" ");
+      const example = EXAMPLES[key];
+      if (example === undefined)
+        continue;
+      const prefix = path.slice(0, path.length - words).join(" ");
+      command.examples([example(prefix)]);
+      return;
+    }
+  };
+  visit(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);
@@ -908,11 +1499,23 @@ var registerSharedDebugInstanceCommands = (program, config) => {
       Data: result ?? []
     });
   });
-  debugInstance.command("variables").description(`Get variables for a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").option("--parent-element-id <id>", "Filter variables by parent element ID").trackedAction(processContext, async (instanceId, options) => {
+  debugInstance.command("variables").description(`Get variables for a ${toolLabel} debug instance`).argument("<instance-id>", "Debug instance ID").option("--parent-element-id <id>", "Filter variables by parent element ID").option("--expected-outputs <ids...>", "Output variable ids the record must define; retried until it does, failed if it never does").trackedAction(processContext, async (instanceId, options) => {
+    const expectGlobals = options.expectedOutputs ?? [];
+    if (expectGlobals.length > 0 && options.parentElementId !== undefined) {
+      OutputFormatter.error({
+        Result: RESULTS.Failure,
+        Message: "--expected-outputs cannot be combined with --parent-element-id",
+        Instructions: "Drop --parent-element-id: --expected-outputs checks the instance's root variables record."
+      });
+      processContext.exit(1);
+      return;
+    }
     const query = buildQueryString({
       parentElementId: options.parentElementId
     });
-    const result = await withDebugPimsCall((cfg) => debugPimsGet(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables${query}`), "Error getting debug instance variables");
+    const result = await withDebugPimsCall((cfg) => expectGlobals.length > 0 ? fetchDebugInstanceVariables(cfg, instanceId, {
+      expectGlobals
+    }) : debugPimsGet(cfg, `${DEBUG_API_PREFIX}/${instanceId}/variables${query}`), "Error getting debug instance variables");
     if (!result)
       return;
     OutputFormatter.success({
@@ -967,6 +1570,7 @@ var registerSharedDebugInstanceCommands = (program, config) => {
       Data: result
     });
   });
+  attachSharedExamples(debugInstance);
 };
 
 // ../maestro-sdk/src/with-pims-call.ts
@@ -1161,6 +1765,7 @@ var registerSharedIncidentCommands = (program, config) => {
       Data: result
     });
   });
+  attachSharedExamples(incident);
 };
 
 // ../maestro-sdk/src/instance-status.ts
@@ -1573,6 +2178,7 @@ var registerSharedInstanceCommands = (program, config) => {
       Data: result
     });
   });
+  attachSharedExamples(instances);
 };
 
 // ../maestro-sdk/src/shared-commands/process.ts
@@ -1815,14 +2421,19 @@ var registerSharedProcessCommands = (processCmd, config) => {
     }
     await setVariableTagsFromPayload(processKey, options);
   });
+  attachSharedExamples(settingsCmd);
+  attachSharedExamples(variableTagsCmd);
 };
 
 // ../maestro-sdk/src/shared-commands/processes.ts
-function findProcessSummary(summaries, processKey) {
+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({
@@ -1843,7 +2454,7 @@ var registerSharedProcessesCommands = (program, config) => {
   });
   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)}`, reqOptions), "Error getting process incidents", { resource: "process", id: processKey });
+    const result = await withPimsCall((config2) => pimsGet(config2, `/incidents/process/${encodeURIComponent(processKey)}${incidentsQuery}`, reqOptions), "Error getting process incidents", { resource: "process", id: processKey });
     if (!result)
       return;
     OutputFormatter.success({
@@ -1854,12 +2465,11 @@ var registerSharedProcessesCommands = (program, config) => {
   });
   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 query = processType ? buildQueryString({ processType }) : "";
-      const summaries = await pimsGet(config2, `/processes/summary${query}`);
-      const incidents = await pimsGet(config2, `/incidents/process/${encodeURIComponent(processKey)}`, { folderKey: options.folderKey });
+      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: findProcessSummary(summaries, processKey),
+        summary,
         incidents,
         errorCodes: errorCodes.errorCodes || []
       };
@@ -1893,8 +2503,9 @@ var registerSharedProcessesCommands = (program, config) => {
       Data: result.errorCodes || []
     });
   });
+  attachSharedExamples(processes);
 };
 
 export { registerRegistryCommand, registerSharedDebugInstanceCommands, registerSharedIncidentCommands, registerSharedInstanceCommands, registerSharedProcessCommands, registerSharedProcessesCommands };
 
-//# debugId=E909433D77340EC664756E2164756E21
+//# debugId=7138755E22A0856964756E2164756E21