@uipath/maestro-sdk 1.195.0 → 1.196.1

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, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugResult, InlineAgentDescriptor, OrchestratorApiConfig, StudioWebDebugConfig } from "./debug-types";
+import type { BeginSessionResponse, DebugCallbacks, DebugIncidentResponse, DebugInstanceResponse, DebugInstanceStatusResponse, DebugResult, InlineAgentDescriptor, OrchestratorApiConfig, SolutionProjectDescriptor, StudioWebDebugConfig } from "./debug-types";
 /**
  * Thrown by {@link injectInlineAgentProcessEntries} when `FpsProperties`
  * is not valid JSON and inline agents need to be injected.
@@ -27,6 +27,22 @@ export declare class FpsPropertiesInjectionError extends Error {
  *   `fpsProperties` cannot be parsed.
  */
 export declare function injectInlineAgentProcessEntries(fpsProperties: string | undefined, inlineAgents?: InlineAgentDescriptor[]): string | undefined;
+/**
+ * Append in-solution sibling-project entries (flow-as-node callees, RPA
+ * processes, …) to `FpsProperties.debug.master.processes`. The flow-as-node
+ * analogue of {@link injectInlineAgentProcessEntries}: each entry carries an
+ * `executorInfo.debugArgs` envelope so the runtime can start the child as its
+ * own debug instance when the lead flow fires `Orchestrator.StartAgenticProcess`.
+ * When no projects are supplied, the input is returned unchanged.
+ *
+ * Mirrors the `debug.master.processes` shape captured from a working Studio
+ * Web debug session. Without these entries the runtime returns 404 "the job's
+ * associated process could not be found" (170007).
+ *
+ * @throws {FpsPropertiesInjectionError} when projects are supplied and
+ *   `fpsProperties` cannot be parsed.
+ */
+export declare function injectSolutionProjectProcessEntries(fpsProperties: string | undefined, solutionProjects?: SolutionProjectDescriptor[]): string | undefined;
 /**
  * Extract the first bpmn:startEvent id from BPMN XML.
  * Falls back to "start" if no start event is found.
@@ -89,19 +105,27 @@ export interface BeginDebugSessionOptions {
     /** Inline agents to register with the debug session via FpsProperties. */
     inlineAgents?: InlineAgentDescriptor[];
     /**
-     * Pre-existing `FpsProperties` JSON string. Inline agents (when
-     * supplied) are appended into `debug.master.processes` on top of this.
+     * In-solution sibling projects (flow-as-node callees, RPA processes, …) to
+     * register in `debug.master.processes` so their `StartAgenticProcess`
+     * activity can resolve the child the same way inline agents resolve
+     * `StartInlineAgentJob`.
+     */
+    solutionProjects?: SolutionProjectDescriptor[];
+    /**
+     * Pre-existing `FpsProperties` JSON string. Inline agents and solution
+     * projects (when supplied) are appended into `debug.master.processes` on
+     * top of this.
      */
     fpsProperties?: string;
 }
 /**
  * Begin a debug session in Orchestrator.
  *
- * When `options.inlineAgents` is non-empty, each agent is encoded into
+ * `options.inlineAgents` / `options.solutionProjects` are each encoded into
  * `FpsProperties.debug.master.processes` so the runtime can resolve the
- * `Orchestrator.StartInlineAgentJob` activity that fires for each agent
- * node — without it Orchestrator returns 404 "the job's associated
- * process could not be found".
+ * `Orchestrator.StartInlineAgentJob` / `StartAgenticProcess` activity that
+ * fires for each agent / flow-as-node — without it Orchestrator returns 404
+ * "the job's associated process could not be found".
  */
 export declare function beginDebugSession(config: OrchestratorApiConfig, inputArguments?: string, options?: BeginDebugSessionOptions): Promise<BeginSessionResponse>;
 export declare const DEBUG_MODE_MAP: Record<string, number>;
@@ -184,6 +208,25 @@ export interface UploadAndDebugParams {
      * agent's `Orchestrator.StartInlineAgentJob` lookup.
      */
     inlineAgents?: InlineAgentDescriptor[];
+    /**
+     * Build the in-solution sibling-project descriptors (flow-as-node callees,
+     * …) to register in `debug.master.processes`. Invoked AFTER upload with the
+     * Studio Web-minted project ids and the uploaded solution id, so each
+     * descriptor's `projectId`/`solutionId` match the uploaded solution. The
+     * callback lives on the caller (flow-tool) because per-project type +
+     * entry point come from the on-disk solution, which maestro-sdk doesn't read.
+     */
+    buildSolutionProjects?: (uploadedProjects: Array<{
+        id: string;
+        name: string;
+    }>, solutionId: string) => Promise<SolutionProjectDescriptor[]> | SolutionProjectDescriptor[];
+    /**
+     * Solution name passed to {@link prepareForCustomDebug}. Surfaces in
+     * Studio Web's debug-solution metadata; falls back to `projectName` when
+     * omitted. Has no effect on routing — Orchestrator only cares that the
+     * resource-builder call returned the debug IDs.
+     */
+    solutionName?: string;
 }
 /**
  * Shared upload-and-debug lifecycle used by flow-tool, maestro-tool, and case-tool.

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

@@ -63,6 +63,38 @@ export interface InlineAgentDescriptor {
      */
     entryPointPath: string;
 }
+/**
+ * Describes an in-solution sibling project (a flow-as-node callee, RPA
+ * process, …) that the debug session must register so the lead flow can start
+ * it as a child. Studio Web encodes one entry per solution project into
+ * `FpsProperties.debug.master.processes`; the runtime resolves
+ * `Orchestrator.StartAgenticProcess` against that session-scoped registry by
+ * NAME (no deployed Orchestrator release is involved).
+ *
+ * This is the flow-as-node analogue of {@link InlineAgentDescriptor}: the
+ * difference is the `executorInfo` payload — a flow callee carries a
+ * `debugArgs` envelope ({@link entryPoint}, {@link solutionId}, debug mode)
+ * instead of an agent entry point. Without these entries the runtime returns
+ * 404 "the job's associated process could not be found" (170007).
+ */
+export interface SolutionProjectDescriptor {
+    /** Project name — the key the runtime resolves `StartAgenticProcess` by. */
+    name: string;
+    /** Studio Web-minted project id from the solution upload result. */
+    projectId: string;
+    /** Wire project type stamped on the entry (e.g. `Flow`). */
+    projectType: string;
+    /**
+     * Per-project entry point: `<bpmn-file>#<start-node>` relative to the
+     * package content root — NO leading slash and NO `content/` prefix
+     * (matches what Studio Web sends).
+     */
+    entryPoint: string;
+    /** Uploaded solution id — carried into `executorInfo.debugArgs.solutionId`. */
+    solutionId: string;
+    /** PIMS debug mode for the child (Default = 1). Defaults to 1. */
+    debugMode?: number;
+}
 export interface ElementExecution {
     elementId: string;
     elementType?: string;

package/dist/src/index.d.ts

@@ -5,14 +5,14 @@ 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, 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 { beginDebugSession, createDebugInstance, extractStartEventId, FpsPropertiesInjectionError, fetchDebugInstanceIncidents, getFolderInfoById, getPersonalFolderInfo, getPersonalFolderKey, injectInlineAgentProcessEntries, injectSolutionProjectProcessEntries, 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, SolutionProjectDescriptor, 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";
 export type { BpmnExtensionType, DiscoveredConnector, DiscoveredProcess, MaestroRegistry, RegistryMetadata, } from "./manifest/types";
 export { buildQueryString } from "./query-string";
 export type { CompactField, ConnectorInfo, ConnectorMethodInfo, ContextEntry, FieldReference, FilterCondition, FilterField, FilterOperator, ISField, ISFieldMethod, ISMetadata, ISMetadataParam, ParsedFilters, SyncMetadata, TriggerField, TriggerFieldEvent, TriggerObjectMetadata, } from "./registry/index.js";
-export { buildActivityEssentialConfiguration, buildInputMetadata, buildManagedHttpEssentialConfiguration, buildTriggerEssentialConfiguration, enrichConnectorNode, extractActivityFilterFields, extractMultipartParameters, extractTriggerEventParameters, extractTriggerFilterFields, FilterParseError, fetchConnectionInfo, fetchConnectorMetadata, fetchConnectorTriggerMetadata, filterNodes, getConnectorConfiguration, getConnectorInfo, getNode, getNodeEnriched, hashContent, 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";
+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";
 export { getEnrichedActivityMetadata, getExtensionType, getRegistry, pullRegistry, searchRegistry, } from "./registry/registry-service";
 export { CACHE_EXPIRATION_MS, loadRegistry, loadRegistryMetadata, saveRegistry, } from "./registry/storage";
 export type { DebugInstanceCommandsConfig } from "./shared-commands/debug-instances";

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

@@ -1,11 +1,10 @@
-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 { 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 { 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";
 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

@@ -35,13 +35,6 @@ export interface SyncMetadata {
  * @returns Absolute path to the nodes directory
  */
 export declare function resolveNodeStorageDir(): Promise<string>;
-/**
- * Generate SHA-256 hash of content for change detection
- *
- * @param content - String content to hash
- * @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[];

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

@@ -30,13 +30,6 @@ interface PullRemoteNodesResult {
  * @returns Result with sync count and cache status
  */
 export declare function pullNodes(options?: PullNodesOptions): Promise<PullNodesResult>;
-/**
- * Pull remote nodes from the manifest API
- * Only pulls if user is logged in
- * Fetches all nodes (OOTB + remote) from the manifest
- *
- * @returns Array of all nodes from manifest
- */
 export declare function pullRemoteNodes(): Promise<PullRemoteNodesResult>;
 /**
  * List cached nodes, falling back to live OOTB nodes if no cache exists.

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

@@ -10,10 +10,6 @@
 import type { MaestroRegistry, RegistryMetadata } from "../manifest/types.js";
 /** Cache is considered fresh for 30 minutes. */
 export declare const CACHE_EXPIRATION_MS: number;
-/**
- * Generate a SHA-256 hex hash of the given string content.
- */
-export declare function hashContent(content: string): Promise<string>;
 /**
  * Save the full registry to disk and update the companion metadata file.
  */

package/dist/src/shared-utils.d.ts

@@ -1,6 +1,6 @@
+export { readStdin } from "@uipath/common";
 export declare const VALID_PROJECT_NAME_REGEX: RegExp;
 export declare const VALID_PACKAGE_NAME_REGEX: RegExp;
-export declare function readStdin(): Promise<string | null>;
 export interface TraceEvent {
     timestamp: string;
     status: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/maestro-sdk",
   "license": "MIT",
-  "version": "1.195.0",
+  "version": "1.196.1",
   "description": "SDK for the UiPath Maestro (PIMS) API — process instance management.",
   "repository": {
     "type": "git",
@@ -42,5 +42,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "65fabb84552758b2710d8ca68470e70a9b1d19bc"
+  "gitHead": "acdb9272c7407276898d24463cae9e377ccb1bf1"
 }

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

@@ -1,7 +0,0 @@
-/** flow-core feature-flag constants — each gates a node category in ManifestClient. */
-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;