@uipath/maestro-sdk 1.1.0 → 1.195.0

package/dist/manifest/bpmn-spec.js

@@ -2969,10 +2969,14 @@ var STATIC_UIPATH_EXTENSION_TAG_NAMES = [
   "caseManagement",
   "context",
   "entryPointId",
+  "error",
+  "errorDefinition",
+  "errorMapping",
   "input",
   "inputOutput",
   "inputSchema",
   "intsvcActivityConfig",
+  "isTransactionRoot",
   "loopCharacteristics",
   "migrationVersion",
   "output",

package/dist/src/debug-service.d.ts

@@ -3,7 +3,7 @@
  * Provides common methods used by flow-tool, case-tool, and maestro-tool.
  */
 import type { IFileSystem } from "@uipath/filesystem";
-import type { BeginSessionResponse, DebugCallbacks, DebugInstanceResponse, DebugInstanceStatusResponse, DebugResult, InlineAgentDescriptor, OrchestratorApiConfig, StudioWebDebugConfig } from "./debug-types";
+import type { BeginSessionResponse, DebugCallbacks, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugResult, InlineAgentDescriptor, OrchestratorApiConfig, StudioWebDebugConfig } from "./debug-types";
 /**
  * Thrown by {@link injectInlineAgentProcessEntries} when `FpsProperties`
  * is not valid JSON and inline agents need to be injected.
@@ -117,6 +117,34 @@ export declare function createDebugInstance(config: OrchestratorApiConfig, jobKe
  * Poll PIMS debug instance element-executions until terminal status.
  */
 export declare function pollDebugInstanceStatus(config: OrchestratorApiConfig, instanceId: string, callbacks?: DebugCallbacks, pollInterval?: number, maxPolls?: number, jobKey?: string): Promise<DebugInstanceStatusResponse>;
+/**
+ * Fetch the incident list PIMS recorded against a finished debug instance.
+ *
+ * Mirrors the `uip <product> debug-instance incidents <id>` command but exposes
+ * the raw array so the debug lifecycle can inline it onto {@link DebugResult}.
+ * Returns an empty array if the backend reports no incidents.
+ */
+export declare function fetchDebugInstanceIncidents(config: OrchestratorApiConfig, instanceId: string): Promise<DebugIncidentResponse[]>;
+/**
+ * True when a poll-loop terminal status should pull incidents inline so the
+ * caller can surface them without a follow-up command.
+ */
+export declare function isFaultedDebugStatus(status: string): boolean;
+/**
+ * True when a terminal debug status means the run succeeded. Callers should use
+ * this (rather than hand-comparing against "Completed"/"Successful") so the
+ * success / fault partition stays defined in exactly one place.
+ */
+export declare function isSuccessfulDebugStatus(status: string): boolean;
+/**
+ * Best-effort incident lookup for a finished debug run. Returns the incident
+ * array only when the run reached a terminal-fault status AND PIMS recorded at
+ * least one incident; returns `undefined` otherwise.
+ *
+ * A fetch failure (404 / permission glitch) is logged and swallowed so it can
+ * never mask the original debug result — the incident detail is informational.
+ */
+export declare function resolveFaultIncidents(config: OrchestratorApiConfig, instanceId: string, status: string): Promise<DebugIncidentResponse[] | undefined>;
 /**
  * Parameters for the shared upload-and-debug lifecycle.
  * Callers are responsible for building the .uis package and resolving

package/dist/src/debug-types.d.ts

@@ -81,6 +81,7 @@ export interface DebugResult {
     solutionId?: string;
     studioWebUrl?: string;
     variables?: DebugVariablesResponse;
+    incidents?: DebugIncidentResponse[];
 }
 export interface DebugVariablesResponse {
     instanceId: string;

package/dist/src/flags/manifest-flags.d.ts

@@ -2,5 +2,6 @@
 export declare const FLAG_CONNECTOR_NODES = "canvas.mfe.dap-component";
 export declare const FLAG_EXTRACT_DOCUMENT = "canvas.nodes.extract-document";
 export declare const FLAG_HITL = "canvas.nodes.hitl";
+export declare const FLAG_LOOP_CONTAINER = "canvas.nodes.loop-container";
 /** Returns a `getFeatureFlag` callback that enables the given flags. */
 export declare function buildFeatureFlagResolver(flags: readonly string[]): (flag: string) => boolean;

package/dist/src/index.d.ts

@@ -5,7 +5,7 @@ export { createPimsConfig } from "./client-factory";
 export type { DebugApiService, MaestroHttpErrorDetails, } from "./debug-http-client";
 export { debugPimsGet, debugPimsPatch, debugPimsPost, debugPimsPut, MaestroHttpError, orchestratorGet, orchestratorPost, parseBackendErrorBody, studioWebDelete, studioWebPost, } from "./debug-http-client";
 export type { BeginDebugSessionOptions, PersonalFolderInfo, PrepareForCustomDebugParams, PrepareForCustomDebugResponse, UploadAndDebugParams, } from "./debug-service";
-export { beginDebugSession, createDebugInstance, extractStartEventId, FpsPropertiesInjectionError, getFolderInfoById, getPersonalFolderInfo, getPersonalFolderKey, injectInlineAgentProcessEntries, patchConnectionOverwrites, pollDebugInstanceStatus, prepareForCustomDebug, uploadAndDebugSolution, } from "./debug-service";
+export { beginDebugSession, createDebugInstance, extractStartEventId, FpsPropertiesInjectionError, fetchDebugInstanceIncidents, getFolderInfoById, getPersonalFolderInfo, getPersonalFolderKey, injectInlineAgentProcessEntries, isFaultedDebugStatus, isSuccessfulDebugStatus, patchConnectionOverwrites, pollDebugInstanceStatus, prepareForCustomDebug, resolveFaultIncidents, uploadAndDebugSolution, } from "./debug-service";
 export type { BeginSessionResponse, BreakpointUpdateRequest, ContinueOnBreakpointRequest, DebugCallbacks, DebugGetAllVariablesResponse, DebugGetVariablesResponse, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugInstanceStatusResult, DebugResult, DebugVariablesResponse, ElementExecution, InlineAgentDescriptor, OrchestratorApiConfig, PatchVariablesRequest, StudioWebDebugConfig, } from "./debug-types";
 export { parseJsonInputOrFile, readJsonFile, resolveJsonInput, } from "./json-input";
 export { BPMN_SPEC, SUPPORTED_UIPATH_EXTENSION_TAG_NAMES, SUPPORTED_UIPATH_EXTENSION_TAGS, } from "./manifest/bpmn-spec";

package/dist/src/registry/filter-engine.d.ts

@@ -1,11 +1,11 @@
-import type { NodeManifest } from "@uipath/flow-core";
+import type { SearchableNode } from "./node-storage.js";
 import type { ParsedFilters } from "./types";
 /**
  * Filter nodes based on provided filter conditions
  */
-export declare function filterNodes(nodes: NodeManifest[], parsedFilters: ParsedFilters): NodeManifest[];
+export declare function filterNodes<T extends SearchableNode>(nodes: T[], parsedFilters: ParsedFilters): T[];
 /**
  * Advanced search with filters and keyword
  * Combines filter conditions with keyword search
  */
-export declare function searchWithFilters(nodes: NodeManifest[], keyword?: string, filters?: ParsedFilters): NodeManifest[];
+export declare function searchWithFilters<T extends SearchableNode>(nodes: T[], keyword?: string, filters?: ParsedFilters): T[];

package/dist/src/registry/index.d.ts

@@ -1,11 +1,11 @@
-export { buildFeatureFlagResolver, FLAG_CONNECTOR_NODES, FLAG_EXTRACT_DOCUMENT, FLAG_HITL, } from "../flags/manifest-flags.js";
+export { buildFeatureFlagResolver, FLAG_CONNECTOR_NODES, FLAG_EXTRACT_DOCUMENT, FLAG_HITL, FLAG_LOOP_CONTAINER, } from "../flags/manifest-flags.js";
 export { registerRegistryCommand } from "./command.js";
 export { filterNodes, searchWithFilters, } from "./filter-engine.js";
 export { FilterParseError, parseFilterString } from "./filter-parser.js";
 export { buildActivityEssentialConfiguration, buildInputMetadata, buildManagedHttpEssentialConfiguration, buildTriggerEssentialConfiguration, enrichConnectorNode, extractActivityFilterFields, extractMultipartParameters, extractTriggerEventParameters, extractTriggerFilterFields, fetchConnectionInfo, fetchConnectorMetadata, fetchConnectorTriggerMetadata, getConnectorConfiguration, getConnectorInfo, inlineMultipartFileValues, isConnectorNode, isConnectorTriggerNode, MANAGED_HTTP_CONNECTOR_KEY, } from "./integration-service-fetcher.js";
 export type { CompactField, ConnectorInfo, ConnectorMethodInfo, ContextEntry, FieldReference, ISField, ISFieldMethod, ISMetadata, ISMetadataParam, TriggerField, TriggerFieldEvent, TriggerObjectMetadata, } from "./integration-service-metadata.types";
 export { isKnownSdkNodeType, listKnownSdkNodes } from "./known-types.js";
-export { hashContent, loadIndexMetadata, loadNodeIndex, resolveNodeStorageDir, type SyncMetadata, saveIndexMetadata, saveNodeIndex, } from "./node-storage.js";
+export { areDerivedArtifactsCurrent, buildEssentialsIndex, buildSearchIndex, CACHE_FORMAT_VERSION, type DerivedArtifact, hashContent, isEssentialNodeType, loadIndexMetadata, loadNodeIndex, loadValidEssentialsIndex, loadValidSearchIndex, type NodeSearchSummary, rederiveNodeIndexArtifacts, resolveNodeStorageDir, type SearchableNode, type SyncMetadata, saveIndexMetadata, saveNodeIndex, } from "./node-storage.js";
 export { getNode, getNodeEnriched, listNodes, pullNodes, pullRemoteNodes, searchNodes, searchNodesWithFilters, } from "./node-sync-service.js";
 export type { SolutionContext } from "./solution-discovery.js";
 export { buildInSolutionNodeManifests, findSolutionFromCwd, readProjectEntryPointIO, } from "./solution-discovery.js";

package/dist/src/registry/node-storage.d.ts

@@ -1,4 +1,24 @@
 import type { NodeManifest } from "@uipath/flow-core";
+export declare const CACHE_FORMAT_VERSION = 1;
+export interface SearchableNode {
+    nodeType?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    description?: string;
+    display?: {
+        label?: string;
+        description?: string;
+    };
+    [key: string]: unknown;
+}
+export type NodeSearchSummary = SearchableNode;
+export interface DerivedArtifact<T> {
+    cacheVersion: number;
+    sourceHash: string;
+    generatedAt: number;
+    nodes: T[];
+}
 /**
  * Metadata about a node source sync operation
  */
@@ -6,6 +26,7 @@ export interface SyncMetadata {
     lastSync: number;
     nodeCount: number;
     hash: string;
+    cacheVersion?: number;
 }
 /**
  * Resolve the absolute path to the nodes storage directory.
@@ -21,10 +42,13 @@ export declare function resolveNodeStorageDir(): Promise<string>;
  * @returns Hex string of the hash
  */
 export declare function hashContent(content: string): Promise<string>;
+export declare function buildSearchIndex(nodes: NodeManifest[]): NodeSearchSummary[];
+export declare function isEssentialNodeType(nodeType: string | undefined): boolean;
+export declare function buildEssentialsIndex(nodes: NodeManifest[]): NodeManifest[];
 /**
- * Save nodes directly to the index file
- * Bypasses the source aggregation and saves nodes directly
- * Also updates the index metadata
+ * Save nodes directly to the index file.
+ * Bypasses the source aggregation and saves nodes directly.
+ * Also updates the index metadata and derived read-path artifacts.
  *
  * @param nodes - Array of nodes to save
  * @returns Number of nodes saved
@@ -49,3 +73,7 @@ export declare function saveIndexMetadata(metadata: SyncMetadata): Promise<void>
  * @returns Metadata if exists, null otherwise
  */
 export declare function loadIndexMetadata(): Promise<SyncMetadata | null>;
+export declare function loadValidSearchIndex(): Promise<NodeSearchSummary[] | null>;
+export declare function loadValidEssentialsIndex(): Promise<NodeManifest[] | null>;
+export declare function areDerivedArtifactsCurrent(): Promise<boolean>;
+export declare function rederiveNodeIndexArtifacts(): Promise<number>;

package/dist/src/registry/node-sync-service.d.ts

@@ -1,4 +1,5 @@
 import type { NodeManifest } from "@uipath/flow-core";
+import { type NodeSearchSummary } from "./node-storage.js";
 import type { ParsedFilters } from "./types";
 interface PullNodesOptions {
     force?: boolean;
@@ -45,6 +46,11 @@ export declare function pullRemoteNodes(): Promise<PullRemoteNodesResult>;
 export declare function listNodes(options?: {
     local?: boolean;
 }): Promise<NodeManifest[]>;
+interface SearchSummaryWithAvailability {
+    node: NodeSearchSummary;
+    availableOnTenant: boolean;
+}
+export declare function searchNodeSummariesWithAvailability(keyword?: string, filters?: ParsedFilters): Promise<SearchSummaryWithAvailability[]>;
 /**
  * Search for nodes by keyword
  * Searches across nodeType, category, tags, and display.label

package/dist/src/registry/solution-discovery.d.ts

@@ -20,6 +20,18 @@ export declare function findSolutionFromCwd(): Promise<SolutionContext | null>;
 /**
  * Read entry-points.json from a project directory.
  * Tries flat layout first, then content/ subdirectory.
+ *
+ * Falls back to extracting `variables.globals` from the project's `.flow`
+ * file whenever no usable `entry-points.json` is found in either candidate
+ * location — that is, when the file is missing, unreadable, contains
+ * invalid JSON, or carries an empty `entryPoints` array. `flow init` and
+ * `flow variable add` do not emit `entry-points.json` — the packager
+ * generates it into a temp staging dir at pack time — so without this
+ * fallback the in-solution registry would always report empty
+ * inputDefinition/outputDefinition for unpacked source flow projects. The
+ * broader trigger (not strictly ENOENT) is intentional: a corrupted or
+ * stale `entry-points.json` should still let the `.flow` source recover
+ * the typed contract.
  */
 export declare function readProjectEntryPointIO(projectDir: string): Promise<ProjectEntryPointIO>;
 /**

package/package.json

@@ -1,56 +1,46 @@
 {
-    "name": "@uipath/maestro-sdk",
-    "version": "1.1.0",
-    "description": "SDK for the UiPath Maestro (PIMS) API — process instance management.",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/UiPath/cli.git",
-        "directory": "packages/maestro-sdk"
+  "name": "@uipath/maestro-sdk",
+  "license": "MIT",
+  "version": "1.195.0",
+  "description": "SDK for the UiPath Maestro (PIMS) API — process instance management.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UiPath/cli.git",
+    "directory": "packages/maestro-sdk"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "uipath",
+    "maestro",
+    "pims",
+    "sdk"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/index.js"
     },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/"
+    "./manifest/bpmn-spec": {
+      "types": "./dist/src/manifest/bpmn-spec.d.ts",
+      "import": "./dist/manifest/bpmn-spec.js",
+      "default": "./dist/manifest/bpmn-spec.js"
     },
-    "keywords": [
-        "uipath",
-        "maestro",
-        "pims",
-        "sdk"
-    ],
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/src/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/src/index.d.ts",
-            "default": "./dist/index.js"
-        },
-        "./manifest/bpmn-spec": {
-            "types": "./dist/src/manifest/bpmn-spec.d.ts",
-            "import": "./dist/manifest/bpmn-spec.js",
-            "default": "./dist/manifest/bpmn-spec.js"
-        },
-        "./manifest/types": {
-            "types": "./dist/src/manifest/types.d.ts"
-        },
-        "./bpmn-validation": {
-            "types": "./dist/src/bpmn-validation/project-validator.d.ts",
-            "import": "./dist/bpmn-validation/project-validator.js",
-            "default": "./dist/bpmn-validation/project-validator.js"
-        }
+    "./manifest/types": {
+      "types": "./dist/src/manifest/types.d.ts"
     },
-    "files": [
-        "dist"
-    ],
-    "devDependencies": {
-        "@uipath/auth": "1.1.0",
-        "@uipath/common": "1.1.0",
-        "@uipath/filesystem": "1.1.0",
-        "@uipath/flow-core": "^0.2.205",
-        "@uipath/integrationservice-sdk": "1.1.0",
-        "@uipath/orchestrator-sdk": "1.1.0",
-        "@types/node": "^25.5.2",
-        "commander": "^14.0.3",
-        "typescript": "^6.0.2"
-    },
-    "gitHead": "06e8c8f566df4b87da4a008635483c62f64f33f0"
+    "./bpmn-validation": {
+      "types": "./dist/src/bpmn-validation/project-validator.d.ts",
+      "import": "./dist/bpmn-validation/project-validator.js",
+      "default": "./dist/bpmn-validation/project-validator.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "gitHead": "65fabb84552758b2710d8ca68470e70a9b1d19bc"
 }