@uipath/maestro-builder-sdk 6.0.0 → 6.1.0

package/dist/api-index.md

@@ -0,0 +1,400 @@
+<!-- GENERATED from the TypeScript declarations in UiPath/flow-builder-sdk
+     (typescript/sdk, scripts/gen-api-index.mjs). Do not edit this file.
+     Change the doc comment on the declaration upstream; that repo regenerates
+     it with `npm run generate:api` and fails its build when it is stale. -->
+
+# Maestro Builder SDK — API index
+
+Every exported symbol of the three authoring entry points, and the exact lines
+of the `.d.ts` that declares it.
+
+**Read the declaration, not a description of it.** The `.d.ts` is what the
+compiler checks your source against, and it carries the `@remarks` and
+`@example` bodies the reference pages leave out. The span below is the whole
+declaration including its doc comment, so one read is the complete answer.
+
+Paths are relative to the installed package root:
+
+```
+node_modules/@uipath/maestro-builder-sdk/dist/core/actions.d.ts    lines 539-610
+```
+
+Open the file at that line. No search, no `grep`, nothing shell-specific —
+which also means this works on Windows, where the command the reference pages
+used to suggest does not.
+
+The spans are generated by the same build that emits the `dist/` they point
+into, so they match the package they ship beside. They are NOT stable across
+versions — a line moves whenever the declaration above it changes — so an index
+and a `dist/` from different releases will not line up. If a span looks wrong,
+that is the thing to check first.
+
+## `@uipath/maestro-builder-sdk`
+
+210 symbol(s). Import from `@uipath/maestro-builder-sdk`.
+
+| Symbol | Kind | Declaration | Area | Summary |
+| --- | --- | --- | --- | --- |
+| `ActionSpec` | type | `dist/core/actions.d.ts` 2105-2200 | Supporting types |  |
+| `agent` | function | `dist/core/actions.d.ts` 2805-2859 | Actions | Invoke an AGENT resource — either one published to Orchestrator or a sibling agent project registered in the same… |
+| `AgentFlavour` | type | `dist/core/actions.d.ts` 1140-1144 | Supporting types | Which KIND of agent project was published behind a `uipath.core.agent.<key>` resource. |
+| `AgentGuardrail` | type | `dist/core/actions.d.ts` 1368 | Supporting types |  |
+| `agenticProcess` | function | `dist/core/actions.d.ts` 2759-2804 | Actions | Invoke a deployed AGENTIC PROCESS — a Maestro process orchestration published to Orchestrator: a BPMN process that… |
+| `AgenticProcessCompletion` | type | `dist/core/actions.d.ts` 1099-1137 | Supporting types | Whether an Agentic Process step waits for the process's result. |
+| `AgenticProcessInputs` | type | `dist/core/actions.d.ts` 1138-1139 | Option shapes | What `agenticProcess()` takes: the shared fields plus the completion policy. |
+| `AgenticProcessInputsBase` | interface | `dist/core/actions.d.ts` 1064-1098 | Option shapes | 5 field(s) |
+| `AgentInputs` | interface | `dist/core/actions.d.ts` 1146-1240 | Option shapes | 8 field(s) |
+| `AgentLocation` | type | `dist/core/actions.d.ts` 1145 | Supporting types |  |
+| `AgentMemoryRef` | interface | `dist/core/actions.d.ts` 1716-1740 | Supporting types | An episodic memory the agent learns from across runs, wired to the agent's own `memory` handle. |
+| `Aggregation` | interface | `dist/core/actions.d.ts` 246-252 | Supporting types | 3 field(s) |
+| `AggregationOperation` | type | `dist/core/actions.d.ts` 245 | Supporting types |  |
+| `apiWorkflow` | function | `dist/core/actions.d.ts` 2573-2607 | Actions | Invoke a deployed API workflow — a coded workflow published to Orchestrator, run as a serverless job rather than by a… |
+| `ApiWorkflowInputs` | interface | `dist/core/actions.d.ts` 997-1028 | Option shapes | 5 field(s) |
+| `AppRef` | interface | `dist/core/actions.d.ts` 493-538 | Supporting types | A deployed Action App that supplies a human task's form — the `'action-app'` variant's subject. |
+| `ArmBuilder` | class | `dist/flow-sdk.d.ts` 1092-1115 | Builders | The sub-builder an ARM callback receives — a `StepList` that can also name itself with `.label(...)`. |
+| `AskedField` | interface | `dist/core/actions.d.ts` 341-351 | Supporting types | A value the reviewer FILLS IN: read downstream with `out('<step>', '<id>')`. |
+| `batchTransform` | function | `dist/core/actions.d.ts` 2376-2410 | Actions | Add AI-generated columns to a CSV — the platform's **Batch transform** node, `uipath.pattern.batch-transform` (service… |
+| `BatchTransformInputs` | interface | `dist/core/actions.d.ts` 824-839 | Option shapes | 4 field(s) |
+| `BindingContribution` | interface | `dist/core/node-classes.d.ts` 76-97 | Supporting types | A resource binding a contribution hoists to the flow's top-level `bindings` array — the shape the `.flow` format… |
+| `BuiltEntryPoint` | interface | `dist/flow-sdk.d.ts` 621-633 | Supporting types | One additional flow root, built by `.entryPoint()`. |
+| `BuiltFlow` | interface | `dist/flow-sdk.d.ts` 634-669 | Supporting types | 15 field(s) |
+| `BuiltinToolName` | type | `dist/core/actions.d.ts` 1608-1609 | Supporting types | The three platform-shipped built-in tools (fixed registry types). |
+| `BuiltinToolRef` | interface | `dist/core/actions.d.ts` 1741-1761 | Supporting types | A platform built-in tool. |
+| `BuiltInValidatorGuardrail` | interface | `dist/core/actions.d.ts` 1326-1367 | Supporting types | A platform-shipped validator, configured by parameters. |
+| `CaseValue` | type | `dist/flow-sdk.d.ts` 287-288 | Supporting types | A value a `.switch` case compares the discriminant against. |
+| `ChildFlow` | type | `dist/flow-sdk.d.ts` 43-46 | Supporting types | Anything `subflow()` accepts as the child: a builder, or an already-built flow. |
+| `ClientSideToolRef` | interface | `dist/core/actions.d.ts` 1670-1685 | Supporting types | A CLIENT-side tool: the agent asks the CALLING application to run it and hand the answer back… |
+| `connector` | function | `dist/core/actions.d.ts` 3035-3058 | Actions | Declare an Integration Service connector action — the typed form, where a generated descriptor supplies the nodeType and… |
+| `connector` | function | `dist/core/actions.d.ts` 3059-3075 | Actions | Stringly form, for a connector with no prepared module — `connector('uipath-salesforce-slack',… |
+| `ConnectorDescriptor` | type | `dist/core/connectors.d.ts` 89-97 | Generated descriptors | A generated, typed connector descriptor: ConnectorMeta branded with phantom input/output types. |
+| `ConnectorLookupValue` | type | `dist/core/connectors.d.ts` 50-59 | Generated descriptors | ConnectorValue for a field that also accepts an unresolved lookup. |
+| `ConnectorMeta` | interface | `dist/core/connectors.d.ts` 60-88 | Generated descriptors | Runtime metadata a generated descriptor carries. |
+| `ConnectorOpts` | interface | `dist/core/actions.d.ts` 177-217 | Option shapes | 4 field(s) |
+| `ConnectorToolRef` | interface | `dist/core/actions.d.ts` 1762-1780 | Supporting types | An Integration Service connector operation as a tool — e.g. |
+| `ConnectorValue` | type | `dist/core/connectors.d.ts` 26-49 | Generated descriptors | What a generated `Inputs` property accepts: the value, or an expression. |
+| `ContextIndexRef` | interface | `dist/core/actions.d.ts` 1913-1947 | Supporting types | One Context Grounding index an inline agent is grounded on. |
+| `ContributionContext` | interface | `dist/core/node-classes.d.ts` 64-75 | Supporting types | What the serializer tells a contributor before asking for its contribution. |
+| `ContributionDiagnostic` | interface | `dist/core/node-classes.d.ts` 1-29 | Supporting types | Definition-backed node base classes — the public extension surface. |
+| `conversationalAgent` | function | `dist/core/actions.d.ts` 2734-2758 | Actions | A CONVERSATIONAL agent (`uipath.agent.conversational`) — it answers one turn of a live chat, reading the transcript… |
+| `ConversationalAgentInputs` | interface | `dist/core/actions.d.ts` 672-709 | Option shapes | 10 field(s) |
+| `ConversationalAgentSettings` | interface | `dist/core/actions.d.ts` 648-671 | Supporting types | How a conversational agent gets its turn — the node's own `conversationalAgentSettings` sub-object. |
+| `conversationContext` | function | `dist/core/actions.d.ts` 2669-2683 | Actions | READ a conversation's transcript so far without waiting (`uipath.conversational.get-conversation-context`) — the shape a… |
+| `ConversationContextInputs` | interface | `dist/core/actions.d.ts` 640-647 | Option shapes | 2 field(s) |
+| `conversationTrigger` | function | `dist/flow-sdk.d.ts` 235-261 | Flow construction | Start the flow when a new CONVERSATION is created (`core.trigger.conversation`) — the entry point for a chat-driven… |
+| `createOutgoingCall` | function | `dist/core/actions.d.ts` 2684-2700 | Actions | Place an outgoing phone call (`uipath.conversational.voice.create-outgoing-call`) and get back the `callContext` every… |
+| `CreateOutgoingCallInputs` | interface | `dist/core/actions.d.ts` 710-718 | Option shapes | 2 field(s) |
+| `CustomGuardrail` | interface | `dist/core/actions.d.ts` 1313-1325 | Supporting types | A rule-based guardrail you author in place. |
+| `DataFabricFilter` | interface | `dist/core/actions.d.ts` 2019-2029 | Supporting types | One filter row on a Data Fabric read — rows AND together unless `or` is set. |
+| `dataFabricRead` | function | `dist/core/actions.d.ts` 2931-2971 | Actions | Read ONE entity record from Data Fabric (`core.datafabric.read`). |
+| `DataFabricReadInputs` | interface | `dist/core/actions.d.ts` 2030-2037 | Option shapes | 3 field(s) |
+| `dataFabricUpdate` | function | `dist/core/actions.d.ts` 2972-2988 | Actions | Update an entity record in Data Fabric (`core.datafabric.update`). |
+| `DataFabricUpdateInputs` | interface | `dist/core/actions.d.ts` 2038-2059 | Option shapes | 4 field(s) |
+| `DEFAULT_TRIGGER_ID` | const | `dist/core/expr.d.ts` 36-37 | Expressions and types | The manual trigger node's default id. |
+| `DefinitionReference` | type | `dist/core/node-classes.d.ts` 30-63 | Supporting types | An exact reference to the node definition a contribution compiles against. |
+| `delay` | function | `dist/core/actions.d.ts` 2466-2487 | Actions | Declare a delay — a step that pauses the flow for a fixed length of time and then carries on. |
+| `DELAY_PRESETS` | const | `dist/core/actions.d.ts` 932-939 | Actions | The twelve durations the designer's dropdown offers. |
+| `DelayInputs` | type | `dist/core/actions.d.ts` 940-961 | Option shapes |  |
+| `descriptor` | function | `dist/core/connectors.d.ts` 98-110 | Generated descriptors | Brand a descriptor literal with its input/output types (zero runtime cost). |
+| `documentClassify` | function | `dist/core/actions.d.ts` 2911-2919 | Actions | Classify a document into a document type (`uipath.document.classify`). |
+| `DocumentClassifyInputs` | interface | `dist/core/actions.d.ts` 2060-2069 | Option shapes | 4 field(s) |
+| `DocValidationInputs` | interface | `dist/core/actions.d.ts` 431-454 | Option shapes | The Document Validation task's subject — `variant: 'document-validation'` only. |
+| `DoWhileOptions` | interface | `dist/flow-sdk.d.ts` 408-417 | Option shapes | Do-while options. |
+| `dynamicExtract` | function | `dist/core/actions.d.ts` 2920-2930 | Actions | Extract fields from a document with an INLINE schema — Dynamic Extract (`uipath.ixp.extract-document-builder`), the… |
+| `DynamicExtractInputs` | interface | `dist/core/actions.d.ts` 2070-2104 | Option shapes | 5 field(s) |
+| `EdgeRoute` | interface | `dist/flow-sdk.d.ts` 545-559 | Supporting types | One edge's route: user-dragged bends and/or the auto-router's waypoints. |
+| `endCall` | function | `dist/core/actions.d.ts` 2701-2708 | Actions | Hang up (`uipath.conversational.voice.end-call`). |
+| `EndCallInputs` | interface | `dist/core/actions.d.ts` 719-726 | Option shapes | 1 field(s) |
+| `entryInput` | function | `dist/core/expr.d.ts` 56-66 | Expressions and types | Reference an ENTRY POINT's scoped input: `entryInput('nightly', 'batchDate')` reads `$vars.nightly.output.batchDate` —… |
+| `err` | function | `dist/core/expr.d.ts` 148-235 | Expressions and types | Reference a FAILED step's error → `$vars.<step>.error[.<field>]`. |
+| `ErrorEnvelopeField` | type | `dist/core/expr.d.ts` 137-147 | Supporting types | The fields a failure envelope carries. |
+| `EscalationRef` | interface | `dist/core/actions.d.ts` 1858-1912 | Supporting types | One escalation an inline agent may raise — an Action Center app task a human completes (the `coded-action-app` variant,… |
+| `EventFilter` | type | `dist/core/actions.d.ts` 3076-3117 | Supporting types | One filter condition on the event payload. |
+| `EventSubscription` | interface | `dist/core/actions.d.ts` 3163-3201 | Option shapes | What a connector event subscribes to. |
+| `Expr` | class | `dist/core/expr.d.ts` 11-21 | Supporting types | A Flow expression. |
+| `FieldMapping` | interface | `dist/core/actions.d.ts` 237-244 | Supporting types | 3 field(s) |
+| `FilterCondition` | type | `dist/core/actions.d.ts` 220-221 | Supporting types | Comparison a filter rule applies to a field. |
+| `FilterMatch` | type | `dist/core/actions.d.ts` 218-219 | Supporting types | How a filter combines its rules: every rule must match, or any one. |
+| `FilterRule` | interface | `dist/core/actions.d.ts` 222-234 | Supporting types | 3 field(s) |
+| `flow` | function | `dist/flow-sdk.d.ts` 1347-1362 | Flow construction | Start building a flow with the given id. |
+| `FlowAction` | class | `dist/core/node-classes.d.ts` 158-164 | Supporting types | A node placed as a step — pass an instance to `.step(name, …)`. |
+| `FlowActionSpec` | type | `dist/flow-sdk.d.ts` 41-42 | Supporting types | What `.step()` accepts here: the shared actions plus this SDK's subflow. |
+| `FlowBuilder` | class | `dist/flow-sdk.d.ts` 1116-1346 | Builders | 13 member(s) |
+| `FlowLayout` | interface | `dist/flow-sdk.d.ts` 607-620 | Supporting types | Designer layout for a flow, keyed by AUTHOR-level ids: node entries by step name (plus the trigger id and `end`), edge… |
+| `FlowNode` | class | `dist/core/node-classes.d.ts` 122-157 | Supporting types | The abstract root of every definition-backed node the builder can place. |
+| `FlowResource` | class | `dist/core/node-classes.d.ts` 172-179 | Supporting types | A node attached to another semantic node — an inline agent's tool, context, memory, or escalation. |
+| `FlowTrigger` | class | `dist/core/node-classes.d.ts` 165-171 | Supporting types | A node that starts the flow — pass an instance to `.trigger(…)`. |
+| `FormField` | type | `dist/core/actions.d.ts` 370 | Supporting types |  |
+| `FormFieldType` | type | `dist/core/actions.d.ts` 319-324 | Supporting types | A form field's type. |
+| `formTrigger` | function | `dist/flow-sdk.d.ts` 206-234 | Flow construction | Start the flow from a FORM a person fills in (`core.trigger.form`) — the platform renders one field per flow input and… |
+| `GuardrailAction` | type | `dist/core/actions.d.ts` 1302-1312 | Supporting types | What happens when a guardrail trips. |
+| `GuardrailFieldReference` | interface | `dist/core/actions.d.ts` 1269-1274 | Supporting types | A field the rule or filter action points at. |
+| `GuardrailFieldSelector` | type | `dist/core/actions.d.ts` 1275-1281 | Supporting types | All fields, or a named few. |
+| `GuardrailRule` | type | `dist/core/actions.d.ts` 1282-1301 | Supporting types | One condition of a custom guardrail. |
+| `GuardrailScope` | type | `dist/core/actions.d.ts` 1261-1262 | Supporting types | Where a guardrail applies: the whole agent, its LLM calls, or its tools. |
+| `GuardrailSelector` | interface | `dist/core/actions.d.ts` 1263-1268 | Supporting types | Which artifacts inside the scope the guardrail watches. |
+| `hitl` | function | `dist/core/actions.d.ts` 2283-2334 | Actions | Declare a human task — a step that pauses for a person to read some values, fill others in, and press one of the outcome… |
+| `HitlAssigneeType` | type | `dist/core/actions.d.ts` 377-384 | Supporting types | How the task is assigned, the platform's own vocabulary (canvas `HITL_ASSIGNEE_TYPE`): `'user'` a single user, `'group'`… |
+| `HitlChannel` | type | `dist/core/actions.d.ts` 371-376 | Supporting types | Where the task is delivered. |
+| `HitlConnection` | interface | `dist/core/actions.d.ts` 385-393 | Supporting types | A per-channel Integration Service connection (Slack / Teams delivery). |
+| `HitlInputs` | interface | `dist/core/actions.d.ts` 539-610 | Option shapes | 11 field(s) |
+| `HitlRecipient` | interface | `dist/core/actions.d.ts` 394-430 | Supporting types | Who gets the task and over which channels. |
+| `HitlVariant` | type | `dist/core/actions.d.ts` 467-492 | Supporting types | WHICH human-task node type to emit. |
+| `http` | function | `dist/core/actions.d.ts` 2221-2228 | Actions | Declare an HTTP request action, explicitly choosing standalone or managed. |
+| `HttpBranch` | interface | `dist/core/actions.d.ts` 14-29 | Supporting types | One conditional response branch on an HTTP node — a designer-visible side exit. |
+| `HttpInputs` | type | `dist/core/actions.d.ts` 121-138 | Option shapes |  |
+| `HttpInputsBase` | interface | `dist/core/actions.d.ts` 30-120 | Option shapes | 11 field(s) |
+| `HttpRequestToolRef` | interface | `dist/core/actions.d.ts` 1686-1715 | Supporting types | The built-in HTTP-request tool (`uipath.agent.resource.tool.builtin.httprequest`): the agent performs an HTTP call. |
+| `inlineAgent` | function | `dist/core/actions.d.ts` 2860-2910 | Actions | Declare an INLINE AUTONOMOUS AGENT — an agent defined inside this flow's own project rather than published to… |
+| `InlineAgentFieldType` | type | `dist/core/actions.d.ts` 1241-1242 | Supporting types | A JSON-schema-ish type for one field of an inline agent's input/output schema. |
+| `InlineAgentInputs` | interface | `dist/core/actions.d.ts` 1369-1607 | Option shapes | 16 field(s) |
+| `InOutField` | interface | `dist/core/actions.d.ts` 352-369 | Supporting types | A value the reviewer READS **and can correct**: pre-filled from the flow, editable on the form, and the (possibly… |
+| `input` | function | `dist/core/expr.d.ts` 38-55 | Expressions and types | Reference a flow input by name → `$vars.<triggerId>.output.<name>`. |
+| `isLookupToken` | function | `dist/core/lookups.d.ts` 53-54 | Generated descriptors | True when `v` is an unresolved LookupToken. |
+| `ixpExtract` | function | `dist/core/actions.d.ts` 2411-2465 | Actions | Extract fields from a document with a published IxP project — the platform's **Extract** node (`uipath.ixp.*`, service… |
+| `IxpExtractInputs` | interface | `dist/core/actions.d.ts` 857-931 | Option shapes | 9 field(s) |
+| `IxpToolRef` | interface | `dist/core/actions.d.ts` 1819-1857 | Supporting types | A published IxP (Intelligent eXtraction Platform) project as a tool — the agent decides when to extract a document and… |
+| `js` | function | `dist/core/expr.d.ts` 236-247 | Expressions and types | Build a raw JS *expression* (a condition or computation). |
+| `lit` | function | `dist/core/expr.d.ts` 22-28 | Expressions and types | A constant value baked directly into a node input. |
+| `lookup` | function | `dist/core/lookups.d.ts` 95-102 | Generated descriptors | Begin resolving a lookup field on a generated descriptor. |
+| `lookup` | function | `dist/core/lookups.d.ts` 103-122 | Generated descriptors | Begin resolving a lookup field addressed by connector key and action. |
+| `lookup` | function | `dist/core/lookups.d.ts` 123-137 | Generated descriptors | Begin resolving a `where` parameter on a trigger descriptor that carries a lookup table. |
+| `lookup` | function | `dist/core/lookups.d.ts` 138-159 | Generated descriptors | Begin resolving a `where` parameter on a connector-EVENT descriptor. |
+| `LookupBuilder` | type | `dist/core/lookups.d.ts` 64-71 | Generated descriptors | What `lookup(...)` returns: the generic form plus any generated aliases. |
+| `lookupKey` | function | `dist/core/lookups.d.ts` 55-63 | Generated descriptors | The identity of one resolution, as `prepare` records it and `compile` reads it. |
+| `LookupResolution` | interface | `dist/core/lookups.d.ts` 160-169 | Generated descriptors | One recorded resolution, as `connectors-local/resolutions.json` stores it. |
+| `LookupResolutions` | type | `dist/core/lookups.d.ts` 170-171 | Generated descriptors | Every recorded resolution, keyed by lookupKey. |
+| `LookupSpec` | interface | `dist/core/lookups.d.ts` 11-36 | Generated descriptors | One lookup field's retrieval contract, generated from `reference`. |
+| `lookupSpecOf` | function | `dist/core/lookups.d.ts` 199-206 | Generated descriptors | The LookupSpec for one field, or `undefined` when it earns no helper. |
+| `LookupStrategy` | type | `dist/core/lookups.d.ts` 1-10 | Generated descriptors | How `prepare` should retrieve the collection, chosen from the metadata. |
+| `LookupToken` | interface | `dist/core/lookups.d.ts` 37-52 | Generated descriptors | An unresolved lookup: what `.byEmail(…)` returns. |
+| `LoopOptions` | interface | `dist/flow-sdk.d.ts` 386-407 | Option shapes | Loop-specific options. |
+| `manual` | function | `dist/flow-sdk.d.ts` 130-139 | Flow construction | The manual trigger, explicitly. |
+| `McpToolRef` | interface | `dist/core/actions.d.ts` 1620-1648 | Supporting types | An MCP server the agent may call tools on. |
+| `mock` | function | `dist/core/actions.d.ts` 2488-2527 | Actions | Declare a PLACEHOLDER step — "a real node goes here later". |
+| `NodeContribution` | interface | `dist/core/node-classes.d.ts` 98-121 | Supporting types | One validated construct, returned by FlowNode.contribute. |
+| `NodeLayout` | interface | `dist/flow-sdk.d.ts` 530-544 | Supporting types | One node's designer layout: canvas position, and optionally size and collapsed state. |
+| `NodeOptions` | interface | `dist/flow-sdk.d.ts` 308-353 | Option shapes | Options shared by every builder method that creates a definition-backed node: `version` selects the exact node… |
+| `onEvent` | function | `dist/flow-sdk.d.ts` 140-177 | Flow construction | Start the flow when a connector event fires — e.g. |
+| `onEvent` | function | `dist/flow-sdk.d.ts` 178-185 | Flow construction | Stringly form, for an event with no prepared module. |
+| `out` | function | `dist/core/expr.d.ts` 67-89 | Expressions and types | Reference an upstream step's output → `$vars.<step>.output[.<path>]`. |
+| `Outcome` | type | `dist/core/actions.d.ts` 455-466 | Supporting types | One completion button. |
+| `OutputColumn` | interface | `dist/core/actions.d.ts` 817-823 | Supporting types | One column Batch Transform appends to the CSV. |
+| `PortArm` | interface | `dist/flow-sdk.d.ts` 295-307 | Supporting types | One arm of a built `.stepSwitch` — the same shape as SwitchArm, but `value` names an exit the ACTION declares (a… |
+| `ProcessToolKind` | type | `dist/core/actions.d.ts` 1781-1794 | Supporting types | The tool kinds that wrap a DEPLOYED tenant resource. |
+| `ProcessToolRef` | interface | `dist/core/actions.d.ts` 1795-1818 | Supporting types | A deployed tenant resource the agent may invoke. |
+| `publishedFunction` | function | `dist/core/actions.d.ts` 2608-2632 | Actions | Invoke a published Orchestrator **Function** — a deployed unit of code run as one step (`uipath.core.function.<key>`,… |
+| `PublishedFunctionInputs` | interface | `dist/core/actions.d.ts` 1029-1063 | Option shapes | A published Orchestrator **Function** — a small, single-purpose unit of code deployed as its own resource and invoked as… |
+| `queueItem` | function | `dist/core/actions.d.ts` 2989-3034 | Actions | Declare an Orchestrator QUEUE ITEM step. |
+| `QueueItemInputs` | interface | `dist/core/actions.d.ts` 1950-2018 | Option shapes | 10 field(s) |
+| `QueuePriority` | type | `dist/core/actions.d.ts` 1948-1949 | Supporting types | The three priorities an Orchestrator queue item can carry. |
+| `ran` | function | `dist/core/expr.d.ts` 90-136 | Expressions and types | Did this step run? |
+| `rawNode` | function | `dist/core/node-classes.d.ts` 180-234 | Supporting types | Place a node this SDK has no factory for, carrying its definition verbatim (`uipath.exotic.thing@2.1` and the manifest… |
+| `RawReference` | type | `dist/core/lookups.d.ts` 190-198 | Supporting types |  |
+| `refuseLookupToken` | function | `dist/core/lookups.d.ts` 207-226 | Generated descriptors | Refuse a lookup token where the family cannot resolve one. |
+| `RemoteA2aToolRef` | interface | `dist/core/actions.d.ts` 1649-1669 | Supporting types | A remote A2A (agent-to-agent) endpoint the agent may delegate to. |
+| `resolvedValue` | function | `dist/core/lookups.d.ts` 172-179 | Generated descriptors | The recorded id for a token, or `undefined`. |
+| `ReturnFieldType` | type | `dist/core/actions.d.ts` 1243-1260 | Supporting types | A JSON-schema-ish type for one field of a step's declared `returns`. |
+| `ReturnOptions` | interface | `dist/flow-sdk.d.ts` 354-385 | Option shapes | `.return(...)`-specific options. |
+| `rpaWorkflow` | function | `dist/core/actions.d.ts` 2528-2572 | Actions | Invoke a deployed RPA (robotic process automation) workflow — a classic UI-automation process, published to… |
+| `RpaWorkflowInputs` | interface | `dist/core/actions.d.ts` 962-996 | Option shapes | 5 field(s) |
+| `SCHEDULE_PRESETS` | const | `dist/flow-sdk.d.ts` 77-84 | Flow construction | The eight intervals the designer offers in its Frequency dropdown. |
+| `scheduled` | function | `dist/flow-sdk.d.ts` 186-205 | Flow construction | Start the flow on a recurring schedule instead of on demand. |
+| `ScheduledInputs` | interface | `dist/flow-sdk.d.ts` 98-110 | Option shapes | 1 field(s) |
+| `ScheduleEvery` | type | `dist/flow-sdk.d.ts` 86-97 | Supporting types | How often a scheduled flow runs, as an ISO-8601 repeating interval: `R/` followed by a duration. |
+| `SchedulePreset` | type | `dist/flow-sdk.d.ts` 85 | Supporting types |  |
+| `script` | function | `dist/core/actions.d.ts` 2229-2236 | Actions | Declare an inline script action. |
+| `ScriptInputs` | interface | `dist/core/actions.d.ts` 139-176 | Option shapes | 2 field(s) |
+| `ScriptReturns` | type | `dist/core/script-return.d.ts` 33-38 | Supporting types | What an author may write for `script({ returns })`: the type outright, or — for an object return — the FIELDS, which is… |
+| `ScriptReturnType` | type | `dist/core/script-return.d.ts` 31-32 | Supporting types | The vocabulary a script's output can be declared as. |
+| `sendMessage` | function | `dist/core/actions.d.ts` 2633-2651 | Actions | Post an assistant message into a live conversation (`uipath.conversational.send-message`). |
+| `SendMessageInputs` | interface | `dist/core/actions.d.ts` 611-630 | Option shapes | 4 field(s) |
+| `ShownField` | interface | `dist/core/actions.d.ts` 325-340 | Supporting types | A value the reviewer READS: shown on the form, filled in from the flow. |
+| `Step` | type | `dist/flow-sdk.d.ts` 418-529 | Supporting types |  |
+| `StepList` | class | `dist/flow-sdk.d.ts` 670-1091 | Builders | Collects a sequence of steps. |
+| `STICKY_NOTE_COLORS` | const | `dist/flow-sdk.d.ts` 560-565 | Flow construction | The designer's sticky-note palette. |
+| `StickyNote` | interface | `dist/flow-sdk.d.ts` 572-606 | Supporting types | A canvas sticky note — free text pinned to the diagram, for the humans reading it. |
+| `StickyNoteColor` | type | `dist/flow-sdk.d.ts` 566-571 | Supporting types | A sticky note's swatch. |
+| `subflow` | function | `dist/flow-sdk.d.ts` 1363-1402 | Flow construction | Run another flow as one step, and read back what it returns. |
+| `SubflowSpec` | interface | `dist/flow-sdk.d.ts` 33-40 | Supporting types | A step that runs a child flow. |
+| `summarize` | function | `dist/core/actions.d.ts` 2335-2375 | Actions | Summarize a document with citations — the platform's **Summarize** node. |
+| `SummarizeInputs` | interface | `dist/core/actions.d.ts` 784-816 | Option shapes | 3 field(s) |
+| `SwitchArm` | interface | `dist/flow-sdk.d.ts` 289-294 | Supporting types | One arm of a built `.switch` (the serializer's view: body already collected). |
+| `tmpl` | function | `dist/core/expr.d.ts` 248-258 | Expressions and types | Build a JS *string template* (for URLs, messages, etc.). |
+| `ToolRef` | type | `dist/core/actions.d.ts` 1610-1619 | Supporting types | One tool on an inline agent — a discriminated union over the kinds the tenant's registry actually serves… |
+| `transform` | function | `dist/core/actions.d.ts` 2237-2282 | Actions | Declare a Transform action — a chain of declarative operations over a collection. |
+| `Transformation` | type | `dist/core/actions.d.ts` 235-236 | Supporting types | What a map does to a field's value. |
+| `TransformInputs` | interface | `dist/core/actions.d.ts` 294-318 | Option shapes | 3 field(s) |
+| `TransformOperation` | type | `dist/core/actions.d.ts` 253-270 | Supporting types | One link in the chain. |
+| `TransformVariant` | type | `dist/core/actions.d.ts` 271-287 | Supporting types | Which Transform node type to emit. |
+| `triggerDescriptor` | function | `dist/core/connectors.d.ts` 139-151 | Generated descriptors | Brand a trigger descriptor literal with its where/output types. |
+| `TriggerDescriptor` | type | `dist/core/connectors.d.ts` 130-138 | Generated descriptors | A generated, typed connector-trigger descriptor: TriggerMeta branded with phantom `where`/output types. |
+| `TriggerMeta` | interface | `dist/core/connectors.d.ts` 120-129 | Generated descriptors | Runtime metadata a generated trigger descriptor carries. |
+| `TriggerOptions` | interface | `dist/core/actions.d.ts` 3118-3162 | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
+| `TriggerSpec` | type | `dist/flow-sdk.d.ts` 111-129 | Supporting types | What starts the flow. |
+| `TypeDesc` | type | `dist/core/expr.d.ts` 323 | Supporting types |  |
+| `types` | const | `dist/core/expr.d.ts` 307-322 | Expressions and types | Variable type descriptors (map to Flow variable `type` values). |
+| `unresolvedLookupMessage` | function | `dist/core/lookups.d.ts` 180-189 | Generated descriptors | The message for a lookup nothing has resolved — the command that fixes it. |
+| `v` | function | `dist/core/expr.d.ts` 29-35 | Expressions and types | Reference a flow-level variable or input by name → `$vars.<name>`. |
+| `VarDecl` | interface | `dist/flow-sdk.d.ts` 47-57 | Supporting types | 6 field(s) |
+| `VarSpec` | interface | `dist/flow-sdk.d.ts` 58-76 | Supporting types | The rich spelling of a variable declaration: pass it instead of a bare `types.*` descriptor wherever `.input()` /… |
+| `voiceAgent` | function | `dist/core/actions.d.ts` 2709-2733 | Actions | Put a VOICE agent on a live call (`uipath.agent.voice`) — it speaks and listens for one turn, then the flow continues. |
+| `VoiceAgentInputs` | interface | `dist/core/actions.d.ts` 750-783 | Option shapes | 6 field(s) |
+| `VoiceSettings` | interface | `dist/core/actions.d.ts` 727-749 | Supporting types | The audio settings a voice agent speaks with. |
+| `voiceTrigger` | function | `dist/flow-sdk.d.ts` 262-286 | Flow construction | Start the flow when a phone call comes IN (`core.trigger.voice`). |
+| `waitForEvent` | function | `dist/core/actions.d.ts` 3211-3245 | Actions | Wait mid-flow until a connector event fires, then continue with its payload — the typed form, where a generated trigger… |
+| `waitForEvent` | function | `dist/core/actions.d.ts` 3246-3253 | Actions | Stringly form, for an event with no prepared module. |
+| `waitForMessage` | function | `dist/core/actions.d.ts` 2652-2668 | Actions | PAUSE until the person sends their next message (`uipath.conversational.wait-for-message`) — a catch event, like… |
+| `WaitForMessageInputs` | interface | `dist/core/actions.d.ts` 631-639 | Option shapes | 2 field(s) |
+
+## `@uipath/maestro-builder-sdk/case`
+
+78 symbol(s). Import from `@uipath/maestro-builder-sdk/case`.
+
+| Symbol | Kind | Declaration | Area | Summary |
+| --- | --- | --- | --- | --- |
+| `ActionField` | interface | `dist/case/case-sdk.d.ts` 420-450 | Supporting types | One field of an Action Center task's form. |
+| `ActionSpecData` | interface | `dist/case/case-sdk.d.ts` 451-466 | Supporting types | 7 field(s) |
+| `BuiltCase` | interface | `dist/case/case-sdk.d.ts` 623-648 | Supporting types | 15 field(s) |
+| `BuiltCaseExitCondition` | interface | `dist/case/case-sdk.d.ts` 352-356 | Supporting types | 3 field(s) |
+| `BuiltEntryCondition` | interface | `dist/case/case-sdk.d.ts` 294-298 | Supporting types | 3 field(s) |
+| `BuiltEscalation` | interface | `dist/case/case-sdk.d.ts` 140-142 | Supporting types | A built escalation (the notification an SLA fires). |
+| `BuiltExitCondition` | interface | `dist/case/case-sdk.d.ts` 319-347 | Supporting types | 6 field(s) |
+| `BuiltSla` | interface | `dist/case/case-sdk.d.ts` 186-194 | Supporting types | A built SLA rule (`slaRules[]` entry). |
+| `BuiltStage` | interface | `dist/case/case-sdk.d.ts` 522-531 | Supporting types | 8 field(s) |
+| `BuiltTask` | interface | `dist/case/case-sdk.d.ts` 500-521 | Supporting types | 15 field(s) |
+| `BuiltTaskEntryCondition` | interface | `dist/case/case-sdk.d.ts` 348-351 | Supporting types | 2 field(s) |
+| `BuiltTrigger` | interface | `dist/case/case-sdk.d.ts` 196-207 | Supporting types | 6 field(s) |
+| `CaseAppConfig` | interface | `dist/case/case-sdk.d.ts` 583-589 | Supporting types | Typed configuration for the generated Case App. |
+| `CaseAppDetailValue` | type | `dist/case/case-sdk.d.ts` 572-573 | Supporting types | A value displayed in one Case App section. |
+| `CaseAppSection` | interface | `dist/case/case-sdk.d.ts` 574-582 | Supporting types | One summary section in the generated Case App. |
+| `CaseBuilder` | class | `dist/case/case-sdk.d.ts` 1032-1275 | Builders | 17 member(s) |
+| `CaseLayout` | interface | `dist/case/case-sdk.d.ts` 611-622 | Supporting types | Optional Case designer layout, keyed by author-level stage and trigger names. |
+| `CaseNodeLayout` | interface | `dist/case/case-sdk.d.ts` 590-610 | Supporting types | Designer-only fields the shipped Case transformer moves into `layout.nodes[id]`. |
+| `casePlan` | function | `dist/case/case-sdk.d.ts` 1276-1282 | Case authoring | Start building a case plan with the given id. |
+| `CaseRule` | interface | `dist/case/case-sdk.d.ts` 78-81 | Supporting types | A single DNF rule. |
+| `CaseRuleGrid` | type | `dist/case/case-sdk.d.ts` 113-114 | Supporting types | One rule, one AND-group, or a complete OR-of-AND condition grid. |
+| `CaseRuleInput` | type | `dist/case/case-sdk.d.ts` 111-112 | Supporting types | A concrete rule or a pure expression gate resolved by its receiving slot. |
+| `CaseRuleType` | type | `dist/case/case-sdk.d.ts` 27 | Supporting types |  |
+| `CaseTriggerKind` | type | `dist/case/case-sdk.d.ts` 195 | Supporting types |  |
+| `CaseVarDecl` | interface | `dist/case/case-sdk.d.ts` 557-571 | Supporting types | 6 field(s) |
+| `ConnectorDescriptor` | type | `dist/core/connectors.d.ts` 89-97 | Supporting types | A generated, typed connector descriptor: ConnectorMeta branded with phantom input/output types. |
+| `ConnectorMeta` | interface | `dist/core/connectors.d.ts` 60-88 | Supporting types | Runtime metadata a generated descriptor carries. |
+| `ConnectorOpts` | interface | `dist/core/actions.d.ts` 177-217 | Option shapes | 4 field(s) |
+| `ConnectorSpecData` | type | `dist/case/case-sdk.d.ts` 376-388 | Supporting types | An Integration Service connector task — the connector variant of the shared `ActionSpec`. |
+| `EntryOpts` | interface | `dist/case/case-sdk.d.ts` 649-661 | Option shapes | Options common to a stage/task entry condition. |
+| `escalation` | function | `dist/case/case-sdk.d.ts` 143-149 | Case authoring | Declare an escalation. |
+| `EscalationOpts` | interface | `dist/case/case-sdk.d.ts` 127-139 | Option shapes | 4 field(s) |
+| `EscalationRecipient` | interface | `dist/case/case-sdk.d.ts` 119-126 | Supporting types | Who an escalation notifies. |
+| `EscalationTrigger` | type | `dist/case/case-sdk.d.ts` 117-118 | Supporting types | When an escalation fires: as the deadline approaches (`at-risk`) or once it passes (`sla-breached`). |
+| `EventFilter` | type | `dist/core/actions.d.ts` 3076-3117 | Supporting types | One filter condition on the event payload. |
+| `EventSubscription` | interface | `dist/core/actions.d.ts` 3163-3201 | Option shapes | What a connector event subscribes to. |
+| `eventTrigger` | function | `dist/case/case-sdk.d.ts` 276-286 | Case authoring | An Integration Service **event** trigger — an external event (a new row, an email, a webhook) starts the case. |
+| `eventTrigger` | function | `dist/case/case-sdk.d.ts` 287-293 | Case authoring | An Integration Service event trigger in placeholder or stringly-resolved form. |
+| `EventTriggerOpts` | interface | `dist/case/case-sdk.d.ts` 239-263 | Option shapes | 4 field(s) |
+| `ExitOpts` | interface | `dist/case/case-sdk.d.ts` 662-698 | Option shapes | Options for `stage.exitWhen(rules, opts)` — one call per outcome. |
+| `ExternalExecutionMode` | type | `dist/case/case-sdk.d.ts` 389-390 | Supporting types | Whether an external Integration Service task blocks for its result or waits for a callback. |
+| `ExternalTaskOptions` | interface | `dist/case/case-sdk.d.ts` 391-401 | Option shapes | Required wiring and typed inputs for an external agent/workflow invocation. |
+| `ExternalTaskSpecData` | interface | `dist/case/case-sdk.d.ts` 402-408 | Supporting types | Normalized descriptor and execution mode stored on a built external task. |
+| `jsonSchema` | function | `dist/case/case-sdk.d.ts` 541-556 | Case authoring | Declare a structured (object/array) variable type. |
+| `JsonSchemaType` | interface | `dist/case/case-sdk.d.ts` 532-540 | Supporting types | A structured (object/array) variable type + its JSON-schema `body`, as returned by jsonSchema. |
+| `LookupSpec` | interface | `dist/core/lookups.d.ts` 11-36 | Supporting types | One lookup field's retrieval contract, generated from `reference`. |
+| `LookupStrategy` | type | `dist/core/lookups.d.ts` 1-10 | Supporting types | How `prepare` should retrieve the collection, chosen from the metadata. |
+| `LookupToken` | interface | `dist/core/lookups.d.ts` 37-52 | Supporting types | An unresolved lookup: what `.byEmail(…)` returns. |
+| `manualTrigger` | function | `dist/case/case-sdk.d.ts` 225-231 | Case authoring | A manual (user-initiated) case trigger. |
+| `ManualTriggerOpts` | interface | `dist/case/case-sdk.d.ts` 208-211 | Option shapes | 2 field(s) |
+| `RecipientType` | type | `dist/case/case-sdk.d.ts` 413-419 | Supporting types | Action-task recipient type. |
+| `ResolvedEventTriggerOpts` | interface | `dist/case/case-sdk.d.ts` 264-275 | Option shapes | Options for the typed `eventTrigger(Descriptor, options)` form. |
+| `rule` | function | `dist/case/case-sdk.d.ts` 82-91 | Case authoring | Declare a condition rule. |
+| `RuleOpts` | interface | `dist/case/case-sdk.d.ts` 28-77 | Option shapes | 6 field(s) |
+| `SelectNextStageSpec` | interface | `dist/case/case-sdk.d.ts` 300-318 | Supporting types | Data Fabric entity used by the Case runtime to deliver a person's next-stage selection. |
+| `SlaOpts` | interface | `dist/case/case-sdk.d.ts` 166-185 | Option shapes | 5 field(s) |
+| `SlaUnit` | type | `dist/case/case-sdk.d.ts` 115-116 | Supporting types | SLA deadline unit. |
+| `StageBuilder` | class | `dist/case/case-sdk.d.ts` 960-1031 | Builders | 6 member(s) |
+| `StageExitType` | type | `dist/case/case-sdk.d.ts` 299 | Supporting types |  |
+| `TaskBuilder` | class | `dist/case/case-sdk.d.ts` 699-959 | Builders | 23 member(s) |
+| `TaskInputBinding` | interface | `dist/case/case-sdk.d.ts` 481-488 | Supporting types | A task input binding: a resource input parameter set to a literal or a `=`-expression. |
+| `TaskKind` | type | `dist/case/case-sdk.d.ts` 357 | Supporting types |  |
+| `TaskOutputBinding` | interface | `dist/case/case-sdk.d.ts` 489-499 | Supporting types | A task output extraction: bind a field of the task's result (`source`) into a case variable (`var`) that later… |
+| `TaskRef` | interface | `dist/case/case-sdk.d.ts` 409-412 | Supporting types | 2 field(s) |
+| `TimerSpecData` | type | `dist/case/case-sdk.d.ts` 467-480 | Supporting types | Exactly one product-supported timer value. |
+| `timerTrigger` | function | `dist/case/case-sdk.d.ts` 232-238 | Case authoring | A timer (scheduled) case trigger. |
+| `TimerTriggerOpts` | interface | `dist/case/case-sdk.d.ts` 212-224 | Option shapes | 3 field(s) |
+| `toGroup` | function | `dist/case/case-sdk.d.ts` 158-165 | Case authoring | An escalation recipient that is a user group. |
+| `toUser` | function | `dist/case/case-sdk.d.ts` 150-157 | Case authoring | An escalation recipient that is a single user. |
+| `TriggerDescriptor` | type | `dist/core/connectors.d.ts` 130-138 | Supporting types | A generated, typed connector-trigger descriptor: TriggerMeta branded with phantom `where`/output types. |
+| `TriggerMeta` | interface | `dist/core/connectors.d.ts` 120-129 | Supporting types | Runtime metadata a generated trigger descriptor carries. |
+| `TriggerOptions` | interface | `dist/core/actions.d.ts` 3118-3162 | Option shapes | The typed `onEvent`/`waitForEvent` options — everything an EventSubscription carries except `connector`/`event`, which… |
+| `TypeDesc` | type | `dist/core/expr.d.ts` 323 | Supporting types |  |
+| `UnresolvedReferenceTaskKind` | type | `dist/case/case-sdk.d.ts` 358-359 | Supporting types | Published-resource task kinds that the Case schema permits as unresolved skeletons. |
+| `WaitConnectorPlaceholderSpec` | interface | `dist/case/case-sdk.d.ts` 360-370 | Supporting types | A `wait-for-connector` subscription: suspend on an Integration Service event. |
+| `WaitConnectorSpec` | type | `dist/case/case-sdk.d.ts` 371-375 | Supporting types | A placeholder connector/operation pair, or a library-resolved event subscription using the same symbolic shape as Flow… |
+| `when` | function | `dist/case/case-sdk.d.ts` 104-110 | Case authoring | Gate a condition slot only on case data without naming its default event. |
+| `WhenExpression` | interface | `dist/case/case-sdk.d.ts` 92-103 | Supporting types | A pure expression gate. |
+
+## `@uipath/maestro-builder-sdk/bpmn`
+
+61 symbol(s). Import from `@uipath/maestro-builder-sdk/bpmn`.
+
+| Symbol | Kind | Declaration | Area | Summary |
+| --- | --- | --- | --- | --- |
+| `ActivityNodeFields` | interface | `dist/bpmn/bpmn-sdk.d.ts` 301-316 | Supporting types | The fields every activity arm of BpmnNode carries — the built form of ActivityOpts. |
+| `ActivityNodeOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1140-1206 | Option shapes | Options for `.activity()` — the generic registry-backed node. |
+| `ActivityOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 700-733 | Option shapes | What every ACTIVITY accepts, on top of its own options — a script task, a variable task, a connector task, a… |
+| `BindingDecl` | interface | `dist/bpmn/bpmn-sdk.d.ts` 354-377 | Supporting types | A declared external identifier the process needs supplied at deploy time — a connection id, a folder key, a process… |
+| `BindingOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 834-862 | Option shapes | Options for `.binding()`. |
+| `BindingsRegistry` | class | `dist/bpmn/bpmn-sdk.d.ts` 1256-1280 | Supporting types | Collects `uipath:binding` declarations, de-duped by id. |
+| `BoundaryOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 625-649 | Option shapes | Options for `.boundaryEvent()`: the activity it attaches to, whether it interrupts that activity, and the event… |
+| `bpmn` | function | `dist/bpmn/bpmn-sdk.d.ts` 2238-2257 | BPMN authoring | Start building a BPMN process with the given id. |
+| `BpmnBuilder` | class | `dist/bpmn/bpmn-sdk.d.ts` 2037-2162 | Builders | The top-level process builder `bpmn()` returns — every graph method of the shared scope (events, gateways, tasks,… |
+| `BpmnConnectorOpts` | type | `dist/bpmn/bpmn-sdk.d.ts` 1955-1979 | Option shapes | `.connector()` options: the shared connector options, plus the BPMN-only display `name` and output-variable override. |
+| `BpmnFlow` | interface | `dist/bpmn/bpmn-sdk.d.ts` 317-329 | Supporting types | One sequence flow in the built graph — the edge from `source` to `target` (`bpmn:sequenceFlow`). |
+| `BpmnNode` | type | `dist/bpmn/bpmn-sdk.d.ts` 85-251 | Supporting types | One node in the built graph — a discriminated union with one arm per BPMN element kind, which the serializer walks into… |
+| `BpmnVarDecl` | interface | `dist/bpmn/bpmn-sdk.d.ts` 335-353 | Supporting types | A declared variable in the built graph (`uipath:input` / `uipath:inputOutput` / `uipath:output`, by `direction`). |
+| `BuiltBpmn` | interface | `dist/bpmn/bpmn-sdk.d.ts` 394-419 | Supporting types | The built in-memory process graph `.build()` returns — the IR `serialize()` walks into `.bpmn` XML. |
+| `CatchOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 602-615 | Option shapes | Options for `.intermediateCatchEvent()`. |
+| `ConnectorDescriptor` | type | `dist/core/connectors.d.ts` 89-97 | Supporting types | A generated, typed connector descriptor: ConnectorMeta branded with phantom input/output types. |
+| `ConnectorEventOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1076-1120 | Option shapes | Shared options for the two connector-event methods. |
+| `ConnectorMeta` | interface | `dist/core/connectors.d.ts` 60-88 | Supporting types | Runtime metadata a generated descriptor carries. |
+| `ConnectorOpts` | interface | `dist/core/actions.d.ts` 177-217 | Option shapes | 4 field(s) |
+| `DefinitionsRegistry` | class | `dist/bpmn/bpmn-sdk.d.ts` 1281-1304 | Supporting types | Collects definitions-level message/error declarations, de-duped by name. |
+| `EndOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 577-601 | Option shapes | Options for `.endEvent()`. |
+| `ErrorDecl` | interface | `dist/bpmn/bpmn-sdk.d.ts` 385-393 | Supporting types | A definitions-level `bpmn:error` declaration, referenced by error events. |
+| `ErrorLike` | type | `dist/bpmn/bpmn-sdk.d.ts` 39-50 | Supporting types | What an author passes for an error definition. |
+| `ErrorMappingRow` | interface | `dist/bpmn/bpmn-sdk.d.ts` 252-300 | Supporting types | One row of `uipath:errorMapping` — how an activity classifies one kind of failure. |
+| `errorSchema` | const | `dist/bpmn/bpmn-sdk.d.ts` 2163-2204 | BPMN authoring | The `Error` variable's shape — the platform's own error envelope. |
+| `errorSchemaWithResponse` | const | `dist/bpmn/bpmn-sdk.d.ts` 2205-2237 | BPMN authoring | The same envelope plus `response` — what a node whose failure carries a payload writes, and what the same source calls… |
+| `EventDef` | type | `dist/bpmn/bpmn-sdk.d.ts` 51-69 | Supporting types | The resolved event definition attached to an event node. |
+| `EventKind` | type | `dist/bpmn/bpmn-sdk.d.ts` 72-73 | Supporting types | The four non-boundary event element kinds a BpmnNode can be. |
+| `ExtensionPayload` | interface | `dist/bpmn/bpmn-sdk.d.ts` 459-495 | Supporting types | An extension payload carried by an element the payload does not describe. |
+| `ExternalTaskOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1121-1139 | Option shapes | Options for `.externalAgent()` / `.externalWorkflow()`. |
+| `FlowOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1222-1230 | Option shapes | Options for `.sequenceFlow()`. |
+| `GatewayKind` | type | `dist/bpmn/bpmn-sdk.d.ts` 70-71 | Supporting types | The four gateway element kinds a BpmnNode can be. |
+| `GatewayOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 650-656 | Option shapes | Options for `.exclusiveGateway()` / `.inclusiveGateway()`. |
+| `HttpOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 863-900 | Option shapes | Options for `.http()` — an `Intsvc.UnifiedHttpRequest` node. |
+| `HumanTaskOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 985-1031 | Option shapes | Options for `.humanTask()` — an `Actions.HITL` action-app task. |
+| `LookupSpec` | interface | `dist/core/lookups.d.ts` 11-36 | Supporting types | One lookup field's retrieval contract, generated from `reference`. |
+| `LookupStrategy` | type | `dist/core/lookups.d.ts` 1-10 | Supporting types | How `prepare` should retrieve the collection, chosen from the metadata. |
+| `LoopSpec` | interface | `dist/bpmn/bpmn-sdk.d.ts` 74-84 | Supporting types | Multi-instance loop over a collection (`uipath:loopCharacteristics`). |
+| `MessageDecl` | interface | `dist/bpmn/bpmn-sdk.d.ts` 378-384 | Supporting types | A definitions-level `bpmn:message` declaration, referenced by message events. |
+| `OrchestratorAsyncOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 938-945 | Option shapes | Options for the two agentic/case call activities, which come in sync and async forms. |
+| `OrchestratorOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 901-937 | Option shapes | What every Orchestrator invocation needs: which process, in which folder, with what input. |
+| `PlainTaskElement` | type | `dist/bpmn/bpmn-sdk.d.ts` 1207-1214 | Supporting types | The BPMN task elements that are legal with NO `uipath:*` payload. |
+| `PlainTaskOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1215-1221 | Option shapes | Options for `.plainTask()`. |
+| `ProcessMetadata` | interface | `dist/bpmn/bpmn-sdk.d.ts` 420-458 | Supporting types | Process-level metadata — the `uipath:*` children of the process's own `extensionElements` that describe the DOCUMENT… |
+| `QueueItemOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 946-984 | Option shapes | Options for `.queueItem()`. |
+| `ReceiveMessageOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1032-1075 | Option shapes | Options for `.receiveMessage()` — `Maestro.ReceiveMessageEvent`. |
+| `RetrySpec` | interface | `dist/bpmn/bpmn-sdk.d.ts` 657-699 | Supporting types | Retry an activity that fails (`uipath:retry`). |
+| `ScopeBuilder` | class | `dist/bpmn/bpmn-sdk.d.ts` 1305-1954 | Builders | The set of node/flow/variable methods common to the process root and every sub-process. |
+| `ScriptTaskOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 734-803 | Option shapes | Options for `.scriptTask()` — the Jint JavaScript body and its input/output mappings. |
+| `StartOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 496-576 | Option shapes | Options for `.startEvent()`. |
+| `SubProcessBuilder` | class | `dist/bpmn/bpmn-sdk.d.ts` 2032-2036 | Builders | A sub-process body: the same graph methods, plus an internal node builder. |
+| `SubProcessOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 819-833 | Option shapes | Options for `.subProcess()`. |
+| `TaskOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 804-818 | Option shapes | Options for `.task()` — a display name and the variable assignments the task makes. |
+| `ThrowOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 616-624 | Option shapes | Options for `.intermediateThrowEvent()` — a `message` to throw, or none. |
+| `TimerLike` | type | `dist/bpmn/bpmn-sdk.d.ts` 37-38 | Supporting types | A timer as an ISO-8601 duration string (shorthand for `{ duration }`) or a full spec. |
+| `TimerSpec` | interface | `dist/bpmn/bpmn-sdk.d.ts` 28-36 | Supporting types | ISO-8601 timer specification (one of duration / date / cycle). |
+| `TypedContextRow` | interface | `dist/bpmn/typed-node.d.ts` 141-172 | Supporting types | One `uipath:context` input row, spelled out. |
+| `TypeDesc` | type | `dist/core/expr.d.ts` 323 | Supporting types |  |
+| `TypedOutputRow` | interface | `dist/bpmn/typed-node.d.ts` 173-197 | Supporting types | 8 field(s) |
+| `VarDirection` | type | `dist/bpmn/bpmn-sdk.d.ts` 330-334 | Supporting types | How a variable is exposed: `'input'` (read-only entry input), `'output'` (a return value), or `'inputOutput'` (a mutable… |
+| `VarOpts` | interface | `dist/bpmn/bpmn-sdk.d.ts` 1231-1255 | Option shapes | Options for `.var()` / `.input()` / `.output()`. |

package/dist/generators/_connections.py

@@ -30,6 +30,8 @@ __all__ = [
     "ConnectionError_",
     "byoa_connections",
     "byoa_listing",
+    "candidate_connections",
+    "candidate_listing",
     "discover_connection",
     "lookup_connection",
     "merge_bindings",
@@ -130,6 +132,48 @@ def discover_connection(connector_key: str, name: str | None = None) -> dict:
     return rows[0]
 
 
+def candidate_connections(connector_key: str, name: str | None = None) -> list[dict]:
+    """Every enabled connection for `connector_key`, own folder FIRST.
+
+    `discover_connection` answers "which one" and stops at the first non-empty
+    scope, which is right for picking a connection and wrong for retrying one:
+    when the own-folder listing holds exactly one, the tenant-wide connections
+    are never even looked at. So a lookup that exhausts the personal-workspace
+    connection reports a bad VALUE while the record sits in another folder's
+    connection (flow-builder-sdk#744, measured on two Jira connections where
+    only the second carried project `TS`).
+
+    Ordering is the same preference `discover_connection` encodes — the caller's
+    own folder is the likeliest and is tried first — but nothing is dropped.
+    Deduplicated by `Id`, because the tenant-wide listing repeats the own-folder
+    rows.
+
+    This does NOT decide anything, and in particular does not raise on several
+    matches: choosing among them is the caller's job, and the only honest way to
+    choose is evidence (a lookup that resolves on exactly one). That keeps this
+    module's rule intact — ambiguity is never resolved by guessing.
+    """
+    ordered: list[dict] = []
+    seen: set[str] = set()
+    for all_folders in (False, True):
+        for row in _matching(_list(all_folders=all_folders), connector_key, name):
+            identifier = str(row.get("Id", ""))
+            if identifier and identifier in seen:
+                continue
+            seen.add(identifier)
+            ordered.append(row)
+    return ordered
+
+
+def candidate_listing(rows: list[dict], indent: str = "    ") -> str:
+    """The candidates, one pasteable `--connection-id` line each."""
+    return "\n".join(
+        f"{indent}{row.get('Name')}  --connection-id {row.get('Id')}"
+        f"  (folder: {row.get('Folder')})"
+        for row in rows
+    )
+
+
 def _enabled_listing(rows: list[dict], connector_key: str) -> str:
     """The enabled connections for `connector_key`, one per line, pasteable."""
     enabled = _matching(rows, connector_key, None)

package/dist/generators/_resolve.py

@@ -25,6 +25,7 @@ import subprocess
 import sys
 
 __all__ = [
+    "LookupExhausted",
     "ResolutionError",
     "parse_resolve_flag",
     "resolve_one",
@@ -55,6 +56,36 @@ class ResolutionError(Exception):
     """A lookup that could not be resolved, with the reason a human needs."""
 
 
+class LookupExhausted(ResolutionError):
+    """The collection was read to the end on THIS connection and had no match.
+
+    Split out from its parent because the two failures want opposite responses
+    and the caller cannot tell them apart from a message. A transport or
+    permission failure says nothing about whether the value exists — retrying it
+    on another connection would hide a broken call behind a confident "no
+    connection has it". An exhaustive miss is positive evidence about this
+    connection specifically, and is the signal `prepare` uses to demote it and
+    try the next candidate (flow-builder-sdk#744).
+
+    `capped` flips that: a scan stopped at the record cap did NOT reach the end,
+    so it is not evidence of absence and must not demote anything.
+
+    The attributes carry the counts so a caller can report per-candidate results
+    without re-parsing the sentence.
+    """
+
+    def __init__(self, message: str, *, field: str, collection: str, by: str,
+                 value: str, scanned: int, pages: int, capped: bool) -> None:
+        super().__init__(message)
+        self.field = field
+        self.collection = collection
+        self.by = by
+        self.value = value
+        self.scanned = scanned
+        self.pages = pages
+        self.capped = capped
+
+
 def parse_resolve_flag(raw: str) -> tuple[str, str, str]:
     """`channel:profile.email=dustin@example.com` -> (field, by, value).
 
@@ -261,13 +292,28 @@ def resolve_one(
         query = f"{query}&nextPage={token}" if query else f"nextPage={token}"
 
     capped = scanned >= MAX_SCANNED or pages > PAGE_GUARD
-    raise ResolutionError(
+    # This states the FACT and stops; `prepare` owns the remedy, because
+    # `prepare` is what knows the other candidate connections.
+    #
+    # It deliberately carries NO "check the value" and NO `uip is resources`
+    # pointer. The old text led with both: it named only the value as suspect
+    # when the connection is equally suspect, and then sent the reader to a
+    # tenant crawl the skill explicitly rules out ("Tenant discovery is not a
+    # phase of either loop", references/CLI-LOOP.md). An agent followed that
+    # advice into exactly what it had been told not to do — 50 of 94 Bash calls
+    # hand-crawling Integration Service, 41 of them paging this collection, and
+    # the run hit its ceiling without producing a flow (flow-builder-sdk#744).
+    #
+    # The listing command is still offered, once, by the caller's terminal
+    # report — where every connection has been tried and seeing what IS there
+    # is finally the next step rather than a detour.
+    raise LookupExhausted(
         f"{field}: no record in {collection!r} has {by}={value!r} "
         f"(scanned {scanned} record(s) across {pages + 1} page(s)"
         + (f"; STOPPED AT THE {MAX_SCANNED}-record cap, so the value may be "
-           f"further in" if capped else "")
-        + ").\n"
-        f"Check the value, or list the collection to see what is there:\n"
-        f"  uip is resources run list {connector_key} {collection} "
-        f"--connection-id {connection_id}"
+           f"further in" if capped
+           else "; collection exhausted")
+        + f") on connection {connection_id}.",
+        field=field, collection=collection, by=by, value=value,
+        scanned=scanned, pages=pages + 1, capped=capped,
     )

package/dist/generators/prepare_connector.py

@@ -382,6 +382,12 @@ def main() -> None:
     # step that removes 4-7 tool calls per task: listing connections, filtering
     # them, and then hunting Orchestrator for a folder key that was on the
     # connection record all along.
+    # Whether the CALLER chose the connection, recorded before discovery
+    # overwrites `connection_id` with its own answer. An explicit choice is never
+    # second-guessed: the retry in `_write_resolutions` is for a connection this
+    # command picked, not for one the author named (flow-builder-sdk#744).
+    args._connection_pinned = bool(args.connection_id or args.connection)
+
     if not args.connection_id:
         try:
             found = _connections.discover_connection(args.key, args.connection)
@@ -1125,6 +1131,14 @@ def _write_resolutions(args, node_type: str) -> None:
                 args.key, specs[field], field, by, value,
                 args.connection_id, resolved_values,
             )
+        except _resolve.LookupExhausted as error:
+            # The collection was read to the END on this connection and the
+            # value is not in it. That is evidence about the CONNECTION, not
+            # only about the value — so before failing, try the other enabled
+            # connections for this connector. A transport failure is the
+            # sibling exception below and is never retried: retrying it would
+            # dress a broken call up as "no connection has it".
+            _retry_or_exit(args, node_type, specs, ordered, error)
         except _resolve.ResolutionError as error:
             sys.exit(f"prepare-connector: {error}")
         resolved_values[field] = got
@@ -1143,6 +1157,164 @@ def _write_resolutions(args, node_type: str) -> None:
     print(f"  wrote {len(existing)} resolution(s) to {path}")
 
 
+def _candidate_label(row: dict) -> str:
+    """`name (folder)` for a per-candidate report line."""
+    return f"{row.get('Name')} ({row.get('Folder')})"
+
+
+def _probe_candidate(args, specs, ordered, connection_id: str):
+    """Resolve every requested lookup against one connection.
+
+    Returns `None` when all of them resolve, or the first reason they did not:
+    `("exhausted", <LookupExhausted>)` or `("error", <ResolutionError>)`. The
+    two are kept apart all the way up, because only the first is evidence about
+    the connection.
+    """
+    resolved: dict[str, str] = {}
+    for field, by, value in ordered:
+        try:
+            resolved[field] = _resolve.resolve_one(
+                args.key, specs[field], field, by, value, connection_id, resolved,
+            )
+        except _resolve.LookupExhausted as error:
+            return ("exhausted", error)
+        except _resolve.ResolutionError as error:
+            return ("error", error)
+    return None
+
+
+def _retry_or_exit(args, node_type: str, specs, ordered, first) -> None:
+    """Try the other candidate connections, or exit explaining what was tried.
+
+    NEVER RETURNS. Either it re-execs this command pinned to a connection that
+    resolves everything, or it exits with a report.
+    """
+    if args._connection_pinned:
+        # An explicit --connection-id / --connection is the author's decision and
+        # is not overridden. The alternatives are still named, because the whole
+        # cost of this bug was not knowing they existed.
+        others = [
+            row for row in _connections.candidate_connections(args.key)
+            if str(row.get("Id")) != str(args.connection_id)
+        ]
+        extra = ""
+        if others:
+            extra = (
+                f"\n{len(others)} other enabled {args.key} connection"
+                f"{'s' if len(others) > 1 else ''} exist"
+                f"{'' if len(others) > 1 else 's'}:\n"
+                f"{_connections.candidate_listing(others)}\n"
+                "Re-run against one of those, or check the value. This run kept the "
+                "connection you named."
+            )
+        sys.exit(f"prepare-connector: {first}{extra}")
+
+    try:
+        candidates = _connections.candidate_connections(args.key, args.connection)
+    except _connections.ConnectionError_ as error:
+        # The listing itself failed; report the original lookup failure, which is
+        # the thing the author asked about.
+        sys.exit(f"prepare-connector: {first}\n(could not list other connections: {error})")
+
+    others = [row for row in candidates
+              if str(row.get("Id")) != str(args.connection_id)]
+    if not others:
+        sys.exit(
+            f"prepare-connector: {first}\n"
+            f"This is the only enabled {args.key} connection on the tenant, so the "
+            "value is what to check."
+        )
+
+    print(f"  {first.field}: not on this connection; trying "
+          f"{len(others)} other {args.key} connection(s)")
+    winners: list[dict] = []
+    report: list[str] = []
+    for row in others:
+        outcome = _probe_candidate(args, specs, ordered, str(row.get("Id")))
+        if outcome is None:
+            winners.append(row)
+            report.append(f"    {_candidate_label(row)}  resolves all "
+                          f"{len(ordered)} lookup(s)")
+            continue
+        kind, error = outcome
+        if kind == "exhausted":
+            report.append(
+                f"    {_candidate_label(row)}  {error.field}: "
+                f"{error.scanned} record(s) scanned, no match")
+        else:
+            report.append(f"    {_candidate_label(row)}  {error}")
+
+    if len(winners) == 1:
+        chosen = winners[0]
+        # Undo the bindings this run wrote for the connection that cannot serve
+        # the lookups, then start over pinned to the one that can. Re-running
+        # rather than switching in place is deliberate: the overlay and its
+        # lookup specs are described THROUGH a connection
+        # (`_lookup_specs_from_overlay`), so adopting a different connection
+        # after the describe would leave the overlay describing one connection
+        # while bindings.json names another.
+        _restore_bindings(args)
+        print(f"  connection: {_candidate_label(chosen)} resolves "
+              f"{first.field}; re-running against it "
+              f"(--connection-id {chosen.get('Id')})")
+        argv = [sys.executable, *sys.argv,
+                "--connection-id", str(chosen.get("Id"))]
+        # The ledger keys a resolution by [nodeType, field, by, value] and NOT by
+        # connection, so an id recorded against the connection just abandoned
+        # would be reused as "already resolved". Force the re-run to resolve
+        # against the connection it actually pins.
+        if not args.refresh_lookups:
+            argv.append("--refresh-lookups")
+        sys.stdout.flush()
+        try:
+            os.execv(sys.executable, argv)
+        except OSError as error:
+            # `execv` does not return on success, so reaching here means the
+            # re-run could not start. Hand back the command rather than a
+            # traceback: the author is one paste from the answer.
+            pinned = " ".join(argv[2:])
+            sys.exit(
+                f"prepare-connector: {first}\n"
+                f"{_candidate_label(chosen)} resolves it, but this command could "
+                f"not re-run itself ({error}). Run:\n  prepare {pinned}"
+            )
+        # Unreachable in production — execv replaced the process. Kept so the
+        # function can never fall through to the report below, which would
+        # contradict the line just printed.
+        raise SystemExit(0)
+
+    if len(winners) > 1:
+        sys.exit(
+            f"prepare-connector: {len(winners)} {args.key} connections resolve "
+            f"every requested lookup, and they are not interchangeable — the ids "
+            f"they return differ per connection. Pick the one you mean:\n"
+            f"{_connections.candidate_listing(winners)}"
+        )
+
+    # Nothing resolved anywhere. Report every candidate and what it held, the
+    # one connection first, so the reader can see the value really is absent
+    # rather than guess which connection was asked.
+    original = next(
+        (row for row in candidates
+         if str(row.get("Id")) == str(args.connection_id)),
+        {"Name": args.connection_id, "Folder": "?"},
+    )
+    lines = [f"    {_candidate_label(original)}  {first.field}: "
+             f"{first.scanned} record(s) scanned, no match", *report]
+    # HERE is where the collection listing finally belongs: every connection has
+    # been tried, so seeing what the collection actually holds is the next step
+    # rather than the detour it is while a retry is still available.
+    sys.exit(
+        f"prepare-connector: no {args.key} connection could resolve "
+        f"{first.field}: {first.by}={first.value!r}\n"
+        + "\n".join(lines) + "\n"
+        "Every candidate was read to the end, so the value is what to check now. "
+        f"To see what {first.collection!r} holds:\n"
+        f"  uip is resources run list {args.key} {first.collection} "
+        f"--connection-id {args.connection_id}"
+    )
+
+
 def _lookup_specs_from_overlay(
     out_dir: str, node_type: str, object_name: str | None = None,
 ) -> dict:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/maestro-builder-sdk",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "description": "Build UiPath Flow, Case, and BPMN artifacts by writing TypeScript.",
   "license": "MIT",
   "homepage": "https://docs.uipath.com/maestro",
@@ -64,9 +64,9 @@
     "node": ">=22.6"
   },
   "scripts": {
-    "build": "tsc && tsc -p cli/tsconfig.json && cp src/core-definitions.json dist/core-definitions.json && cp src/ixp-definition.json dist/ixp-definition.json && cp src/bpmn/uipath-moddle.v1.json dist/bpmn/uipath-moddle.v1.json && cp src/bpmn/registry-types.json dist/bpmn/registry-types.json && node scripts/copy-registry-generators.mjs && node scripts/extract-api-model.mjs --check && node scripts/gen-api-reference.mjs --check && node scripts/api-doc-coverage.mjs --check && node scripts/check-api-docs.mjs",
+    "build": "tsc && tsc -p cli/tsconfig.json && cp skill/references/api-index.md dist/api-index.md && cp src/core-definitions.json dist/core-definitions.json && cp src/ixp-definition.json dist/ixp-definition.json && cp src/bpmn/uipath-moddle.v1.json dist/bpmn/uipath-moddle.v1.json && cp src/bpmn/registry-types.json dist/bpmn/registry-types.json && node scripts/copy-registry-generators.mjs && node scripts/extract-api-model.mjs --check && node scripts/gen-api-reference.mjs --check && node scripts/gen-api-index.mjs --check && node scripts/api-doc-coverage.mjs --check && node scripts/check-api-docs.mjs",
     "check:package": "node scripts/check-package-contents.mjs",
-    "generate:api": "node scripts/extract-api-model.mjs && node scripts/gen-api-reference.mjs",
+    "generate:api": "node scripts/extract-api-model.mjs && node scripts/gen-api-reference.mjs && node scripts/gen-api-index.mjs",
     "docs:check": "node scripts/check-api-docs.mjs",
     "coverage:flow": "node scripts/audit-flow-coverage.mjs",
     "coverage:case": "node scripts/audit-case-coverage.mjs",
@@ -87,5 +87,5 @@
     "@types/node": "^22.7.0",
     "esbuild": "^0.28.1"
   },
-  "gitref": "8c327b39940d34432128dd713c731027bb00fbde"
+  "gitref": "e83d0f29f4df2228bcd751abf688e40daae0523d"
 }