@uipath/maestro-sdk 1.1.0 → 1.196.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bpmn-validation/project-validator.js +29 -2
- package/dist/index.js +40294 -26827
- package/dist/manifest/bpmn-spec.js +4 -0
- package/dist/src/debug-service.d.ts +78 -7
- package/dist/src/debug-types.d.ts +33 -0
- package/dist/src/index.d.ts +3 -3
- package/dist/src/registry/filter-engine.d.ts +3 -3
- package/dist/src/registry/index.d.ts +1 -2
- package/dist/src/registry/node-storage.d.ts +31 -10
- package/dist/src/registry/node-sync-service.d.ts +6 -7
- package/dist/src/registry/solution-discovery.d.ts +12 -0
- package/dist/src/registry/storage.d.ts +0 -4
- package/dist/src/shared-utils.d.ts +1 -1
- package/package.json +41 -51
- package/dist/src/flags/manifest-flags.d.ts +0 -6
|
@@ -2969,10 +2969,14 @@ var STATIC_UIPATH_EXTENSION_TAG_NAMES = [
|
|
|
2969
2969
|
"caseManagement",
|
|
2970
2970
|
"context",
|
|
2971
2971
|
"entryPointId",
|
|
2972
|
+
"error",
|
|
2973
|
+
"errorDefinition",
|
|
2974
|
+
"errorMapping",
|
|
2972
2975
|
"input",
|
|
2973
2976
|
"inputOutput",
|
|
2974
2977
|
"inputSchema",
|
|
2975
2978
|
"intsvcActivityConfig",
|
|
2979
|
+
"isTransactionRoot",
|
|
2976
2980
|
"loopCharacteristics",
|
|
2977
2981
|
"migrationVersion",
|
|
2978
2982
|
"output",
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
* Provides common methods used by flow-tool, case-tool, and maestro-tool.
|
|
4
4
|
*/
|
|
5
5
|
import type { IFileSystem } from "@uipath/filesystem";
|
|
6
|
-
import type { BeginSessionResponse, DebugCallbacks, DebugInstanceResponse, DebugInstanceStatusResponse, DebugResult, InlineAgentDescriptor, OrchestratorApiConfig, StudioWebDebugConfig } from "./debug-types";
|
|
6
|
+
import type { BeginSessionResponse, DebugCallbacks, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugResult, InlineAgentDescriptor, OrchestratorApiConfig, SolutionProjectDescriptor, StudioWebDebugConfig } from "./debug-types";
|
|
7
7
|
/**
|
|
8
8
|
* Thrown by {@link injectInlineAgentProcessEntries} when `FpsProperties`
|
|
9
9
|
* is not valid JSON and inline agents need to be injected.
|
|
@@ -27,6 +27,22 @@ export declare class FpsPropertiesInjectionError extends Error {
|
|
|
27
27
|
* `fpsProperties` cannot be parsed.
|
|
28
28
|
*/
|
|
29
29
|
export declare function injectInlineAgentProcessEntries(fpsProperties: string | undefined, inlineAgents?: InlineAgentDescriptor[]): string | undefined;
|
|
30
|
+
/**
|
|
31
|
+
* Append in-solution sibling-project entries (flow-as-node callees, RPA
|
|
32
|
+
* processes, …) to `FpsProperties.debug.master.processes`. The flow-as-node
|
|
33
|
+
* analogue of {@link injectInlineAgentProcessEntries}: each entry carries an
|
|
34
|
+
* `executorInfo.debugArgs` envelope so the runtime can start the child as its
|
|
35
|
+
* own debug instance when the lead flow fires `Orchestrator.StartAgenticProcess`.
|
|
36
|
+
* When no projects are supplied, the input is returned unchanged.
|
|
37
|
+
*
|
|
38
|
+
* Mirrors the `debug.master.processes` shape captured from a working Studio
|
|
39
|
+
* Web debug session. Without these entries the runtime returns 404 "the job's
|
|
40
|
+
* associated process could not be found" (170007).
|
|
41
|
+
*
|
|
42
|
+
* @throws {FpsPropertiesInjectionError} when projects are supplied and
|
|
43
|
+
* `fpsProperties` cannot be parsed.
|
|
44
|
+
*/
|
|
45
|
+
export declare function injectSolutionProjectProcessEntries(fpsProperties: string | undefined, solutionProjects?: SolutionProjectDescriptor[]): string | undefined;
|
|
30
46
|
/**
|
|
31
47
|
* Extract the first bpmn:startEvent id from BPMN XML.
|
|
32
48
|
* Falls back to "start" if no start event is found.
|
|
@@ -89,19 +105,27 @@ export interface BeginDebugSessionOptions {
|
|
|
89
105
|
/** Inline agents to register with the debug session via FpsProperties. */
|
|
90
106
|
inlineAgents?: InlineAgentDescriptor[];
|
|
91
107
|
/**
|
|
92
|
-
*
|
|
93
|
-
*
|
|
108
|
+
* In-solution sibling projects (flow-as-node callees, RPA processes, …) to
|
|
109
|
+
* register in `debug.master.processes` so their `StartAgenticProcess`
|
|
110
|
+
* activity can resolve the child the same way inline agents resolve
|
|
111
|
+
* `StartInlineAgentJob`.
|
|
112
|
+
*/
|
|
113
|
+
solutionProjects?: SolutionProjectDescriptor[];
|
|
114
|
+
/**
|
|
115
|
+
* Pre-existing `FpsProperties` JSON string. Inline agents and solution
|
|
116
|
+
* projects (when supplied) are appended into `debug.master.processes` on
|
|
117
|
+
* top of this.
|
|
94
118
|
*/
|
|
95
119
|
fpsProperties?: string;
|
|
96
120
|
}
|
|
97
121
|
/**
|
|
98
122
|
* Begin a debug session in Orchestrator.
|
|
99
123
|
*
|
|
100
|
-
*
|
|
124
|
+
* `options.inlineAgents` / `options.solutionProjects` are each encoded into
|
|
101
125
|
* `FpsProperties.debug.master.processes` so the runtime can resolve the
|
|
102
|
-
* `Orchestrator.StartInlineAgentJob` activity that
|
|
103
|
-
* node — without it Orchestrator returns 404
|
|
104
|
-
* process could not be found".
|
|
126
|
+
* `Orchestrator.StartInlineAgentJob` / `StartAgenticProcess` activity that
|
|
127
|
+
* fires for each agent / flow-as-node — without it Orchestrator returns 404
|
|
128
|
+
* "the job's associated process could not be found".
|
|
105
129
|
*/
|
|
106
130
|
export declare function beginDebugSession(config: OrchestratorApiConfig, inputArguments?: string, options?: BeginDebugSessionOptions): Promise<BeginSessionResponse>;
|
|
107
131
|
export declare const DEBUG_MODE_MAP: Record<string, number>;
|
|
@@ -117,6 +141,34 @@ export declare function createDebugInstance(config: OrchestratorApiConfig, jobKe
|
|
|
117
141
|
* Poll PIMS debug instance element-executions until terminal status.
|
|
118
142
|
*/
|
|
119
143
|
export declare function pollDebugInstanceStatus(config: OrchestratorApiConfig, instanceId: string, callbacks?: DebugCallbacks, pollInterval?: number, maxPolls?: number, jobKey?: string): Promise<DebugInstanceStatusResponse>;
|
|
144
|
+
/**
|
|
145
|
+
* Fetch the incident list PIMS recorded against a finished debug instance.
|
|
146
|
+
*
|
|
147
|
+
* Mirrors the `uip <product> debug-instance incidents <id>` command but exposes
|
|
148
|
+
* the raw array so the debug lifecycle can inline it onto {@link DebugResult}.
|
|
149
|
+
* Returns an empty array if the backend reports no incidents.
|
|
150
|
+
*/
|
|
151
|
+
export declare function fetchDebugInstanceIncidents(config: OrchestratorApiConfig, instanceId: string): Promise<DebugIncidentResponse[]>;
|
|
152
|
+
/**
|
|
153
|
+
* True when a poll-loop terminal status should pull incidents inline so the
|
|
154
|
+
* caller can surface them without a follow-up command.
|
|
155
|
+
*/
|
|
156
|
+
export declare function isFaultedDebugStatus(status: string): boolean;
|
|
157
|
+
/**
|
|
158
|
+
* True when a terminal debug status means the run succeeded. Callers should use
|
|
159
|
+
* this (rather than hand-comparing against "Completed"/"Successful") so the
|
|
160
|
+
* success / fault partition stays defined in exactly one place.
|
|
161
|
+
*/
|
|
162
|
+
export declare function isSuccessfulDebugStatus(status: string): boolean;
|
|
163
|
+
/**
|
|
164
|
+
* Best-effort incident lookup for a finished debug run. Returns the incident
|
|
165
|
+
* array only when the run reached a terminal-fault status AND PIMS recorded at
|
|
166
|
+
* least one incident; returns `undefined` otherwise.
|
|
167
|
+
*
|
|
168
|
+
* A fetch failure (404 / permission glitch) is logged and swallowed so it can
|
|
169
|
+
* never mask the original debug result — the incident detail is informational.
|
|
170
|
+
*/
|
|
171
|
+
export declare function resolveFaultIncidents(config: OrchestratorApiConfig, instanceId: string, status: string): Promise<DebugIncidentResponse[] | undefined>;
|
|
120
172
|
/**
|
|
121
173
|
* Parameters for the shared upload-and-debug lifecycle.
|
|
122
174
|
* Callers are responsible for building the .uis package and resolving
|
|
@@ -156,6 +208,25 @@ export interface UploadAndDebugParams {
|
|
|
156
208
|
* agent's `Orchestrator.StartInlineAgentJob` lookup.
|
|
157
209
|
*/
|
|
158
210
|
inlineAgents?: InlineAgentDescriptor[];
|
|
211
|
+
/**
|
|
212
|
+
* Build the in-solution sibling-project descriptors (flow-as-node callees,
|
|
213
|
+
* …) to register in `debug.master.processes`. Invoked AFTER upload with the
|
|
214
|
+
* Studio Web-minted project ids and the uploaded solution id, so each
|
|
215
|
+
* descriptor's `projectId`/`solutionId` match the uploaded solution. The
|
|
216
|
+
* callback lives on the caller (flow-tool) because per-project type +
|
|
217
|
+
* entry point come from the on-disk solution, which maestro-sdk doesn't read.
|
|
218
|
+
*/
|
|
219
|
+
buildSolutionProjects?: (uploadedProjects: Array<{
|
|
220
|
+
id: string;
|
|
221
|
+
name: string;
|
|
222
|
+
}>, solutionId: string) => Promise<SolutionProjectDescriptor[]> | SolutionProjectDescriptor[];
|
|
223
|
+
/**
|
|
224
|
+
* Solution name passed to {@link prepareForCustomDebug}. Surfaces in
|
|
225
|
+
* Studio Web's debug-solution metadata; falls back to `projectName` when
|
|
226
|
+
* omitted. Has no effect on routing — Orchestrator only cares that the
|
|
227
|
+
* resource-builder call returned the debug IDs.
|
|
228
|
+
*/
|
|
229
|
+
solutionName?: string;
|
|
159
230
|
}
|
|
160
231
|
/**
|
|
161
232
|
* Shared upload-and-debug lifecycle used by flow-tool, maestro-tool, and case-tool.
|
|
@@ -63,6 +63,38 @@ export interface InlineAgentDescriptor {
|
|
|
63
63
|
*/
|
|
64
64
|
entryPointPath: string;
|
|
65
65
|
}
|
|
66
|
+
/**
|
|
67
|
+
* Describes an in-solution sibling project (a flow-as-node callee, RPA
|
|
68
|
+
* process, …) that the debug session must register so the lead flow can start
|
|
69
|
+
* it as a child. Studio Web encodes one entry per solution project into
|
|
70
|
+
* `FpsProperties.debug.master.processes`; the runtime resolves
|
|
71
|
+
* `Orchestrator.StartAgenticProcess` against that session-scoped registry by
|
|
72
|
+
* NAME (no deployed Orchestrator release is involved).
|
|
73
|
+
*
|
|
74
|
+
* This is the flow-as-node analogue of {@link InlineAgentDescriptor}: the
|
|
75
|
+
* difference is the `executorInfo` payload — a flow callee carries a
|
|
76
|
+
* `debugArgs` envelope ({@link entryPoint}, {@link solutionId}, debug mode)
|
|
77
|
+
* instead of an agent entry point. Without these entries the runtime returns
|
|
78
|
+
* 404 "the job's associated process could not be found" (170007).
|
|
79
|
+
*/
|
|
80
|
+
export interface SolutionProjectDescriptor {
|
|
81
|
+
/** Project name — the key the runtime resolves `StartAgenticProcess` by. */
|
|
82
|
+
name: string;
|
|
83
|
+
/** Studio Web-minted project id from the solution upload result. */
|
|
84
|
+
projectId: string;
|
|
85
|
+
/** Wire project type stamped on the entry (e.g. `Flow`). */
|
|
86
|
+
projectType: string;
|
|
87
|
+
/**
|
|
88
|
+
* Per-project entry point: `<bpmn-file>#<start-node>` relative to the
|
|
89
|
+
* package content root — NO leading slash and NO `content/` prefix
|
|
90
|
+
* (matches what Studio Web sends).
|
|
91
|
+
*/
|
|
92
|
+
entryPoint: string;
|
|
93
|
+
/** Uploaded solution id — carried into `executorInfo.debugArgs.solutionId`. */
|
|
94
|
+
solutionId: string;
|
|
95
|
+
/** PIMS debug mode for the child (Default = 1). Defaults to 1. */
|
|
96
|
+
debugMode?: number;
|
|
97
|
+
}
|
|
66
98
|
export interface ElementExecution {
|
|
67
99
|
elementId: string;
|
|
68
100
|
elementType?: string;
|
|
@@ -81,6 +113,7 @@ export interface DebugResult {
|
|
|
81
113
|
solutionId?: string;
|
|
82
114
|
studioWebUrl?: string;
|
|
83
115
|
variables?: DebugVariablesResponse;
|
|
116
|
+
incidents?: DebugIncidentResponse[];
|
|
84
117
|
}
|
|
85
118
|
export interface DebugVariablesResponse {
|
|
86
119
|
instanceId: string;
|
package/dist/src/index.d.ts
CHANGED
|
@@ -5,14 +5,14 @@ export { createPimsConfig } from "./client-factory";
|
|
|
5
5
|
export type { DebugApiService, MaestroHttpErrorDetails, } from "./debug-http-client";
|
|
6
6
|
export { debugPimsGet, debugPimsPatch, debugPimsPost, debugPimsPut, MaestroHttpError, orchestratorGet, orchestratorPost, parseBackendErrorBody, studioWebDelete, studioWebPost, } from "./debug-http-client";
|
|
7
7
|
export type { BeginDebugSessionOptions, PersonalFolderInfo, PrepareForCustomDebugParams, PrepareForCustomDebugResponse, UploadAndDebugParams, } from "./debug-service";
|
|
8
|
-
export { beginDebugSession, createDebugInstance, extractStartEventId, FpsPropertiesInjectionError, getFolderInfoById, getPersonalFolderInfo, getPersonalFolderKey, injectInlineAgentProcessEntries, patchConnectionOverwrites, pollDebugInstanceStatus, prepareForCustomDebug, uploadAndDebugSolution, } from "./debug-service";
|
|
9
|
-
export type { BeginSessionResponse, BreakpointUpdateRequest, ContinueOnBreakpointRequest, DebugCallbacks, DebugGetAllVariablesResponse, DebugGetVariablesResponse, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugInstanceStatusResult, DebugResult, DebugVariablesResponse, ElementExecution, InlineAgentDescriptor, OrchestratorApiConfig, PatchVariablesRequest, StudioWebDebugConfig, } from "./debug-types";
|
|
8
|
+
export { beginDebugSession, createDebugInstance, extractStartEventId, FpsPropertiesInjectionError, fetchDebugInstanceIncidents, getFolderInfoById, getPersonalFolderInfo, getPersonalFolderKey, injectInlineAgentProcessEntries, injectSolutionProjectProcessEntries, isFaultedDebugStatus, isSuccessfulDebugStatus, patchConnectionOverwrites, pollDebugInstanceStatus, prepareForCustomDebug, resolveFaultIncidents, uploadAndDebugSolution, } from "./debug-service";
|
|
9
|
+
export type { BeginSessionResponse, BreakpointUpdateRequest, ContinueOnBreakpointRequest, DebugCallbacks, DebugGetAllVariablesResponse, DebugGetVariablesResponse, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugInstanceStatusResult, DebugResult, DebugVariablesResponse, ElementExecution, InlineAgentDescriptor, OrchestratorApiConfig, PatchVariablesRequest, SolutionProjectDescriptor, StudioWebDebugConfig, } from "./debug-types";
|
|
10
10
|
export { parseJsonInputOrFile, readJsonFile, resolveJsonInput, } from "./json-input";
|
|
11
11
|
export { BPMN_SPEC, SUPPORTED_UIPATH_EXTENSION_TAG_NAMES, SUPPORTED_UIPATH_EXTENSION_TAGS, } from "./manifest/bpmn-spec";
|
|
12
12
|
export type { BpmnExtensionType, DiscoveredConnector, DiscoveredProcess, MaestroRegistry, RegistryMetadata, } from "./manifest/types";
|
|
13
13
|
export { buildQueryString } from "./query-string";
|
|
14
14
|
export type { CompactField, ConnectorInfo, ConnectorMethodInfo, ContextEntry, FieldReference, FilterCondition, FilterField, FilterOperator, ISField, ISFieldMethod, ISMetadata, ISMetadataParam, ParsedFilters, SyncMetadata, TriggerField, TriggerFieldEvent, TriggerObjectMetadata, } from "./registry/index.js";
|
|
15
|
-
export { buildActivityEssentialConfiguration, buildInputMetadata, buildManagedHttpEssentialConfiguration, buildTriggerEssentialConfiguration, enrichConnectorNode, extractActivityFilterFields, extractMultipartParameters, extractTriggerEventParameters, extractTriggerFilterFields, FilterParseError, fetchConnectionInfo, fetchConnectorMetadata, fetchConnectorTriggerMetadata, filterNodes, getConnectorConfiguration, getConnectorInfo, getNode, getNodeEnriched,
|
|
15
|
+
export { buildActivityEssentialConfiguration, buildInputMetadata, buildManagedHttpEssentialConfiguration, buildTriggerEssentialConfiguration, enrichConnectorNode, extractActivityFilterFields, extractMultipartParameters, extractTriggerEventParameters, extractTriggerFilterFields, FilterParseError, fetchConnectionInfo, fetchConnectorMetadata, fetchConnectorTriggerMetadata, filterNodes, getConnectorConfiguration, getConnectorInfo, getNode, getNodeEnriched, inlineMultipartFileValues, isConnectorNode, isConnectorTriggerNode, isKnownSdkNodeType, listKnownSdkNodes, listNodes, loadIndexMetadata, loadNodeIndex, MANAGED_HTTP_CONNECTOR_KEY, parseFilterString, pullNodes, pullRemoteNodes, registerRegistryCommand, resolveNodeStorageDir, saveIndexMetadata, saveNodeIndex, searchNodes, searchNodesWithFilters, searchWithFilters, } from "./registry/index.js";
|
|
16
16
|
export { getEnrichedActivityMetadata, getExtensionType, getRegistry, pullRegistry, searchRegistry, } from "./registry/registry-service";
|
|
17
17
|
export { CACHE_EXPIRATION_MS, loadRegistry, loadRegistryMetadata, saveRegistry, } from "./registry/storage";
|
|
18
18
|
export type { DebugInstanceCommandsConfig } from "./shared-commands/debug-instances";
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { SearchableNode } from "./node-storage.js";
|
|
2
2
|
import type { ParsedFilters } from "./types";
|
|
3
3
|
/**
|
|
4
4
|
* Filter nodes based on provided filter conditions
|
|
5
5
|
*/
|
|
6
|
-
export declare function filterNodes(nodes:
|
|
6
|
+
export declare function filterNodes<T extends SearchableNode>(nodes: T[], parsedFilters: ParsedFilters): T[];
|
|
7
7
|
/**
|
|
8
8
|
* Advanced search with filters and keyword
|
|
9
9
|
* Combines filter conditions with keyword search
|
|
10
10
|
*/
|
|
11
|
-
export declare function searchWithFilters(nodes:
|
|
11
|
+
export declare function searchWithFilters<T extends SearchableNode>(nodes: T[], keyword?: string, filters?: ParsedFilters): T[];
|
|
@@ -1,11 +1,10 @@
|
|
|
1
|
-
export { buildFeatureFlagResolver, FLAG_CONNECTOR_NODES, FLAG_EXTRACT_DOCUMENT, FLAG_HITL, } from "../flags/manifest-flags.js";
|
|
2
1
|
export { registerRegistryCommand } from "./command.js";
|
|
3
2
|
export { filterNodes, searchWithFilters, } from "./filter-engine.js";
|
|
4
3
|
export { FilterParseError, parseFilterString } from "./filter-parser.js";
|
|
5
4
|
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";
|
|
6
5
|
export type { CompactField, ConnectorInfo, ConnectorMethodInfo, ContextEntry, FieldReference, ISField, ISFieldMethod, ISMetadata, ISMetadataParam, TriggerField, TriggerFieldEvent, TriggerObjectMetadata, } from "./integration-service-metadata.types";
|
|
7
6
|
export { isKnownSdkNodeType, listKnownSdkNodes } from "./known-types.js";
|
|
8
|
-
export {
|
|
7
|
+
export { areDerivedArtifactsCurrent, buildEssentialsIndex, buildSearchIndex, CACHE_FORMAT_VERSION, type DerivedArtifact, isEssentialNodeType, loadIndexMetadata, loadNodeIndex, loadValidEssentialsIndex, loadValidSearchIndex, type NodeSearchSummary, rederiveNodeIndexArtifacts, resolveNodeStorageDir, type SearchableNode, type SyncMetadata, saveIndexMetadata, saveNodeIndex, } from "./node-storage.js";
|
|
9
8
|
export { getNode, getNodeEnriched, listNodes, pullNodes, pullRemoteNodes, searchNodes, searchNodesWithFilters, } from "./node-sync-service.js";
|
|
10
9
|
export type { SolutionContext } from "./solution-discovery.js";
|
|
11
10
|
export { buildInSolutionNodeManifests, findSolutionFromCwd, readProjectEntryPointIO, } from "./solution-discovery.js";
|
|
@@ -1,4 +1,24 @@
|
|
|
1
1
|
import type { NodeManifest } from "@uipath/flow-core";
|
|
2
|
+
export declare const CACHE_FORMAT_VERSION = 1;
|
|
3
|
+
export interface SearchableNode {
|
|
4
|
+
nodeType?: string;
|
|
5
|
+
category?: string;
|
|
6
|
+
tags?: string[];
|
|
7
|
+
version?: string;
|
|
8
|
+
description?: string;
|
|
9
|
+
display?: {
|
|
10
|
+
label?: string;
|
|
11
|
+
description?: string;
|
|
12
|
+
};
|
|
13
|
+
[key: string]: unknown;
|
|
14
|
+
}
|
|
15
|
+
export type NodeSearchSummary = SearchableNode;
|
|
16
|
+
export interface DerivedArtifact<T> {
|
|
17
|
+
cacheVersion: number;
|
|
18
|
+
sourceHash: string;
|
|
19
|
+
generatedAt: number;
|
|
20
|
+
nodes: T[];
|
|
21
|
+
}
|
|
2
22
|
/**
|
|
3
23
|
* Metadata about a node source sync operation
|
|
4
24
|
*/
|
|
@@ -6,6 +26,7 @@ export interface SyncMetadata {
|
|
|
6
26
|
lastSync: number;
|
|
7
27
|
nodeCount: number;
|
|
8
28
|
hash: string;
|
|
29
|
+
cacheVersion?: number;
|
|
9
30
|
}
|
|
10
31
|
/**
|
|
11
32
|
* Resolve the absolute path to the nodes storage directory.
|
|
@@ -14,17 +35,13 @@ export interface SyncMetadata {
|
|
|
14
35
|
* @returns Absolute path to the nodes directory
|
|
15
36
|
*/
|
|
16
37
|
export declare function resolveNodeStorageDir(): Promise<string>;
|
|
38
|
+
export declare function buildSearchIndex(nodes: NodeManifest[]): NodeSearchSummary[];
|
|
39
|
+
export declare function isEssentialNodeType(nodeType: string | undefined): boolean;
|
|
40
|
+
export declare function buildEssentialsIndex(nodes: NodeManifest[]): NodeManifest[];
|
|
17
41
|
/**
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* @returns Hex string of the hash
|
|
22
|
-
*/
|
|
23
|
-
export declare function hashContent(content: string): Promise<string>;
|
|
24
|
-
/**
|
|
25
|
-
* Save nodes directly to the index file
|
|
26
|
-
* Bypasses the source aggregation and saves nodes directly
|
|
27
|
-
* Also updates the index metadata
|
|
42
|
+
* Save nodes directly to the index file.
|
|
43
|
+
* Bypasses the source aggregation and saves nodes directly.
|
|
44
|
+
* Also updates the index metadata and derived read-path artifacts.
|
|
28
45
|
*
|
|
29
46
|
* @param nodes - Array of nodes to save
|
|
30
47
|
* @returns Number of nodes saved
|
|
@@ -49,3 +66,7 @@ export declare function saveIndexMetadata(metadata: SyncMetadata): Promise<void>
|
|
|
49
66
|
* @returns Metadata if exists, null otherwise
|
|
50
67
|
*/
|
|
51
68
|
export declare function loadIndexMetadata(): Promise<SyncMetadata | null>;
|
|
69
|
+
export declare function loadValidSearchIndex(): Promise<NodeSearchSummary[] | null>;
|
|
70
|
+
export declare function loadValidEssentialsIndex(): Promise<NodeManifest[] | null>;
|
|
71
|
+
export declare function areDerivedArtifactsCurrent(): Promise<boolean>;
|
|
72
|
+
export declare function rederiveNodeIndexArtifacts(): Promise<number>;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { NodeManifest } from "@uipath/flow-core";
|
|
2
|
+
import { type NodeSearchSummary } from "./node-storage.js";
|
|
2
3
|
import type { ParsedFilters } from "./types";
|
|
3
4
|
interface PullNodesOptions {
|
|
4
5
|
force?: boolean;
|
|
@@ -29,13 +30,6 @@ interface PullRemoteNodesResult {
|
|
|
29
30
|
* @returns Result with sync count and cache status
|
|
30
31
|
*/
|
|
31
32
|
export declare function pullNodes(options?: PullNodesOptions): Promise<PullNodesResult>;
|
|
32
|
-
/**
|
|
33
|
-
* Pull remote nodes from the manifest API
|
|
34
|
-
* Only pulls if user is logged in
|
|
35
|
-
* Fetches all nodes (OOTB + remote) from the manifest
|
|
36
|
-
*
|
|
37
|
-
* @returns Array of all nodes from manifest
|
|
38
|
-
*/
|
|
39
33
|
export declare function pullRemoteNodes(): Promise<PullRemoteNodesResult>;
|
|
40
34
|
/**
|
|
41
35
|
* List cached nodes, falling back to live OOTB nodes if no cache exists.
|
|
@@ -45,6 +39,11 @@ export declare function pullRemoteNodes(): Promise<PullRemoteNodesResult>;
|
|
|
45
39
|
export declare function listNodes(options?: {
|
|
46
40
|
local?: boolean;
|
|
47
41
|
}): Promise<NodeManifest[]>;
|
|
42
|
+
interface SearchSummaryWithAvailability {
|
|
43
|
+
node: NodeSearchSummary;
|
|
44
|
+
availableOnTenant: boolean;
|
|
45
|
+
}
|
|
46
|
+
export declare function searchNodeSummariesWithAvailability(keyword?: string, filters?: ParsedFilters): Promise<SearchSummaryWithAvailability[]>;
|
|
48
47
|
/**
|
|
49
48
|
* Search for nodes by keyword
|
|
50
49
|
* Searches across nodeType, category, tags, and display.label
|
|
@@ -20,6 +20,18 @@ export declare function findSolutionFromCwd(): Promise<SolutionContext | null>;
|
|
|
20
20
|
/**
|
|
21
21
|
* Read entry-points.json from a project directory.
|
|
22
22
|
* Tries flat layout first, then content/ subdirectory.
|
|
23
|
+
*
|
|
24
|
+
* Falls back to extracting `variables.globals` from the project's `.flow`
|
|
25
|
+
* file whenever no usable `entry-points.json` is found in either candidate
|
|
26
|
+
* location — that is, when the file is missing, unreadable, contains
|
|
27
|
+
* invalid JSON, or carries an empty `entryPoints` array. `flow init` and
|
|
28
|
+
* `flow variable add` do not emit `entry-points.json` — the packager
|
|
29
|
+
* generates it into a temp staging dir at pack time — so without this
|
|
30
|
+
* fallback the in-solution registry would always report empty
|
|
31
|
+
* inputDefinition/outputDefinition for unpacked source flow projects. The
|
|
32
|
+
* broader trigger (not strictly ENOENT) is intentional: a corrupted or
|
|
33
|
+
* stale `entry-points.json` should still let the `.flow` source recover
|
|
34
|
+
* the typed contract.
|
|
23
35
|
*/
|
|
24
36
|
export declare function readProjectEntryPointIO(projectDir: string): Promise<ProjectEntryPointIO>;
|
|
25
37
|
/**
|
|
@@ -10,10 +10,6 @@
|
|
|
10
10
|
import type { MaestroRegistry, RegistryMetadata } from "../manifest/types.js";
|
|
11
11
|
/** Cache is considered fresh for 30 minutes. */
|
|
12
12
|
export declare const CACHE_EXPIRATION_MS: number;
|
|
13
|
-
/**
|
|
14
|
-
* Generate a SHA-256 hex hash of the given string content.
|
|
15
|
-
*/
|
|
16
|
-
export declare function hashContent(content: string): Promise<string>;
|
|
17
13
|
/**
|
|
18
14
|
* Save the full registry to disk and update the companion metadata file.
|
|
19
15
|
*/
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
+
export { readStdin } from "@uipath/common";
|
|
1
2
|
export declare const VALID_PROJECT_NAME_REGEX: RegExp;
|
|
2
3
|
export declare const VALID_PACKAGE_NAME_REGEX: RegExp;
|
|
3
|
-
export declare function readStdin(): Promise<string | null>;
|
|
4
4
|
export interface TraceEvent {
|
|
5
5
|
timestamp: string;
|
|
6
6
|
status: string;
|
package/package.json
CHANGED
|
@@ -1,56 +1,46 @@
|
|
|
1
1
|
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
2
|
+
"name": "@uipath/maestro-sdk",
|
|
3
|
+
"license": "MIT",
|
|
4
|
+
"version": "1.196.0",
|
|
5
|
+
"description": "SDK for the UiPath Maestro (PIMS) API — process instance management.",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "https://github.com/UiPath/cli.git",
|
|
9
|
+
"directory": "packages/maestro-sdk"
|
|
10
|
+
},
|
|
11
|
+
"publishConfig": {
|
|
12
|
+
"registry": "https://registry.npmjs.org/"
|
|
13
|
+
},
|
|
14
|
+
"keywords": [
|
|
15
|
+
"uipath",
|
|
16
|
+
"maestro",
|
|
17
|
+
"pims",
|
|
18
|
+
"sdk"
|
|
19
|
+
],
|
|
20
|
+
"type": "module",
|
|
21
|
+
"main": "./dist/index.js",
|
|
22
|
+
"types": "./dist/src/index.d.ts",
|
|
23
|
+
"exports": {
|
|
24
|
+
".": {
|
|
25
|
+
"types": "./dist/src/index.d.ts",
|
|
26
|
+
"default": "./dist/index.js"
|
|
9
27
|
},
|
|
10
|
-
"
|
|
11
|
-
|
|
28
|
+
"./manifest/bpmn-spec": {
|
|
29
|
+
"types": "./dist/src/manifest/bpmn-spec.d.ts",
|
|
30
|
+
"import": "./dist/manifest/bpmn-spec.js",
|
|
31
|
+
"default": "./dist/manifest/bpmn-spec.js"
|
|
12
32
|
},
|
|
13
|
-
"
|
|
14
|
-
|
|
15
|
-
"maestro",
|
|
16
|
-
"pims",
|
|
17
|
-
"sdk"
|
|
18
|
-
],
|
|
19
|
-
"type": "module",
|
|
20
|
-
"main": "./dist/index.js",
|
|
21
|
-
"types": "./dist/src/index.d.ts",
|
|
22
|
-
"exports": {
|
|
23
|
-
".": {
|
|
24
|
-
"types": "./dist/src/index.d.ts",
|
|
25
|
-
"default": "./dist/index.js"
|
|
26
|
-
},
|
|
27
|
-
"./manifest/bpmn-spec": {
|
|
28
|
-
"types": "./dist/src/manifest/bpmn-spec.d.ts",
|
|
29
|
-
"import": "./dist/manifest/bpmn-spec.js",
|
|
30
|
-
"default": "./dist/manifest/bpmn-spec.js"
|
|
31
|
-
},
|
|
32
|
-
"./manifest/types": {
|
|
33
|
-
"types": "./dist/src/manifest/types.d.ts"
|
|
34
|
-
},
|
|
35
|
-
"./bpmn-validation": {
|
|
36
|
-
"types": "./dist/src/bpmn-validation/project-validator.d.ts",
|
|
37
|
-
"import": "./dist/bpmn-validation/project-validator.js",
|
|
38
|
-
"default": "./dist/bpmn-validation/project-validator.js"
|
|
39
|
-
}
|
|
33
|
+
"./manifest/types": {
|
|
34
|
+
"types": "./dist/src/manifest/types.d.ts"
|
|
40
35
|
},
|
|
41
|
-
"
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
"@types/node": "^25.5.2",
|
|
52
|
-
"commander": "^14.0.3",
|
|
53
|
-
"typescript": "^6.0.2"
|
|
54
|
-
},
|
|
55
|
-
"gitHead": "06e8c8f566df4b87da4a008635483c62f64f33f0"
|
|
36
|
+
"./bpmn-validation": {
|
|
37
|
+
"types": "./dist/src/bpmn-validation/project-validator.d.ts",
|
|
38
|
+
"import": "./dist/bpmn-validation/project-validator.js",
|
|
39
|
+
"default": "./dist/bpmn-validation/project-validator.js"
|
|
40
|
+
}
|
|
41
|
+
},
|
|
42
|
+
"files": [
|
|
43
|
+
"dist"
|
|
44
|
+
],
|
|
45
|
+
"gitHead": "94d71f9c52214980a1f0ae62b3f5372095788553"
|
|
56
46
|
}
|
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
/** flow-core feature-flag constants — each gates a node category in ManifestClient. */
|
|
2
|
-
export declare const FLAG_CONNECTOR_NODES = "canvas.mfe.dap-component";
|
|
3
|
-
export declare const FLAG_EXTRACT_DOCUMENT = "canvas.nodes.extract-document";
|
|
4
|
-
export declare const FLAG_HITL = "canvas.nodes.hitl";
|
|
5
|
-
/** Returns a `getFeatureFlag` callback that enables the given flags. */
|
|
6
|
-
export declare function buildFeatureFlagResolver(flags: readonly string[]): (flag: string) => boolean;
|