@uipath/maestro-builder-sdk 6.57.0 → 6.58.1

package/dist/core/lookups.js

@@ -28,6 +28,7 @@
  * make the surface worse rather than more complete.
  */
 import { prepareCommand, resolveFlagArg } from './cli-spelling.js';
+import { CompileRefusal } from './compile-refusal.js';
 /** True when `v` is an unresolved {@link LookupToken}. */
 export function isLookupToken(v) {
     return (typeof v === 'object' && v !== null &&
@@ -100,7 +101,7 @@ function makeBuilder(nodeType, field, spec, generic) {
             // at `prepare` time. The alternative is spending the network call to be
             // told the field does not exist, which is the expensive way to learn it.
             if (spec && !spec.by.includes(name)) {
-                throw new Error(`lookup(${nodeType}, '${field}'): cannot search by "${name}". ` +
+                throw new CompileRefusal('LOOKUP_UNKNOWN_MATCH_KEY', `lookup(${nodeType}, '${field}'): cannot search by "${name}". ` +
                     `This collection is searchable by ${spec.by.map((b) => `"${b}"`).join(', ')}.`);
             }
             return token(name, value);
@@ -116,7 +117,7 @@ function makeBuilder(nodeType, field, spec, generic) {
         get(target, prop, receiver) {
             if (typeof prop === 'string' && !(prop in target) && ALIAS_SHAPE.test(prop)) {
                 return () => {
-                    throw new Error(missingAliasMessage(nodeType, field, prop, spec, generic));
+                    throw new CompileRefusal('LOOKUP_UNKNOWN_ALIAS', missingAliasMessage(nodeType, field, prop, spec, generic));
                 };
             }
             return Reflect.get(target, prop, receiver);
@@ -126,7 +127,7 @@ function makeBuilder(nodeType, field, spec, generic) {
 export function lookup(a, b, c) {
     if (typeof a === 'string') {
         if (typeof c !== 'string') {
-            throw new Error("lookup(key, action, field) needs all three arguments; " +
+            throw new CompileRefusal('LOOKUP_ARGS', "lookup(key, action, field) needs all three arguments; " +
                 "did you mean lookup(descriptor, field)?");
         }
         return makeBuilder(`uipath.connector.${a}.${b}`, c, undefined, { key: a, action: b });
@@ -148,7 +149,7 @@ export function lookup(a, b, c) {
         // Naming the fields that DO have one matters: the commonest cause of this
         // is a field whose `reference` is degenerate, where the right answer is a
         // plain string and not a different helper call.
-        throw new Error(`lookup(${bearing.nodeType}, '${b}'): no lookup is generated for that field. ` +
+        throw new CompileRefusal('LOOKUP_UNKNOWN_FIELD', `lookup(${bearing.nodeType}, '${b}'): no lookup is generated for that field. ` +
             (known.length
                 ? `Fields with a lookup: ${known.map((k) => `"${k}"`).join(', ')}.`
                 : 'This operation has no lookup fields — author the value as a plain string.'));
@@ -317,7 +318,7 @@ export function resolveEventWhere(where, resolutions, site) {
         }
         const resolved = resolvedEventValue(value, resolutions);
         if (resolved === undefined)
-            throw new Error(`${site}: \`where.${key}\` ` + unresolvedLookupMessage(value));
+            throw new CompileRefusal('LOOKUP_UNRESOLVED', `${site}: \`where.${key}\` ` + unresolvedLookupMessage(value));
         out[key] = resolved;
     }
     return out;

package/dist/core/nodes/registry.js

@@ -1,5 +1,6 @@
 import { asVersioned } from './versioned.js';
 import { ownEntry } from '../own-entry.js';
+import { CompileRefusal } from '../compile-refusal.js';
 /** Whether a prefix entry owns `typeName`: under its prefix, and accepted by its narrowing, if it has one. */
 function owns(p, typeName) {
     return typeName.startsWith(p.prefix) && (p.matches?.(typeName) ?? true);
@@ -44,11 +45,11 @@ export class NodeTypeRegistry {
         if (this.#extensions.includes(family))
             return;
         if (family.package === undefined) {
-            throw new Error(`cannot register node family "${family.id}": a family registered at run time must name its package (NodeFamily.package).`);
+            throw new CompileRefusal('NODE_FAMILY_REGISTRATION', `cannot register node family "${family.id}": a family registered at run time must name its package (NodeFamily.package).`);
         }
         const { index, problems } = this.#build([...this.#builtIn, ...this.#extensions, family]);
         if (problems.length > 0) {
-            throw new Error(`cannot register node family "${family.id}" from ${family.package.name}:\n`
+            throw new CompileRefusal('NODE_FAMILY_REGISTRATION', `cannot register node family "${family.id}" from ${family.package.name}:\n`
                 + problems.map((p) => `  - ${p}`).join('\n'));
         }
         this.#extensions = [...this.#extensions, family];

package/dist/core/nodes/versioned.js

@@ -1,4 +1,5 @@
 import { ownEntry } from '../own-entry.js';
+import { CompileRefusal } from '../compile-refusal.js';
 /** True for a {@link VersionedNodeType}; a plain {@link NodeType} carries `version` instead. */
 export function isVersioned(t) {
     return 'versions' in t;
@@ -44,7 +45,7 @@ export function resolveVersion(t, spec, requested, where) {
             throw new Error(`internal SDK error: ${t.typeName}'s select() chose ${version} for ${where}, but the type registers only `
                 + `${known}. This is a bug in the node type, not in the flow; please report it.`);
         }
-        throw new Error(`${where} requests ${t.typeName}@${version}, but this SDK registers only ${known}. `
+        throw new CompileRefusal('NODE_VERSION_UNREGISTERED', `${where} requests ${t.typeName}@${version}, but this SDK registers only ${known}. `
             + 'Versions are exact — omit { version } to use the default, or request one listed here.');
     }
     return impl;
@@ -88,7 +89,7 @@ export function resolveVersionCarried(t, spec, requested, where, carried) {
             ? '. Versions are exact — omit { version } to use the default, or request one listed here.'
             : '. Versions are exact — omit { version } to use the default, request one listed here, or carry '
                 + "that version's definition (the .flow file's definitions[] entry) with .definitions([...]).";
-        throw new Error(`${where} requests ${t.typeName}@${requested}, but this SDK registers only ${registered}`
+        throw new CompileRefusal('NODE_VERSION_UNREGISTERED', `${where} requests ${t.typeName}@${requested}, but this SDK registers only ${registered}`
             + (carriedVersions.length > 0 ? ` and the flow carries only ${carriedVersions.join(', ')}` : '')
             + remedy);
     }

package/dist/core/process-resource-sort-order.js

@@ -39,6 +39,6 @@ export const DYNAMIC_NODE_SORT_OFFSET = 500;
 export function resourceNodeSortOrder(category) {
     const base = ownEntry(PROCESS_RESOURCE_CATEGORY_SORT_ORDERS, category);
     if (base === undefined)
-        throw new Error(`no sortOrder for process-resource category '${category}'`);
+        throw new Error(`internal SDK error: no sortOrder for process-resource category '${category}'`);
     return base + DYNAMIC_NODE_SORT_OFFSET;
 }

package/dist/core/read-text.d.ts

@@ -1,31 +1,3 @@
-/**
- * core/read-text — how the connector library reads its files.
- *
- * `Library` and `loadLibrary` read every library and overlay file through a
- * `ReadText`, so a host without a disk can serve them: Studio Web keeps the library
- * zip in memory and answers each read from it. A read is synchronous because QuickJS
- * cannot wait on one while it compiles.
- *
- * `Library` keeps what a host reader returns for library files (the index and the
- * ledgers) for as long as the reader lives, because a library build does not change:
- * pass a new reader for a new build. Overlay files are read afresh each time, because
- * `prepare` rewrites them.
- *
- * The default reads the disk. A host without one, which runs the SDK's CLI and so
- * cannot pass a reader in, hands one over before the run:
- * `globalThis[Symbol.for('uipath.maestro-builder-sdk.readText')] = read`, with
- * `$FLOW_SDK_LIBRARY_JSON` naming the folder it serves. That reader then answers every
- * default read, library and overlay alike, and its index is kept like any host reader's.
- * The default overlay folder is still looked up on the host's `fs`; pass
- * `--connectors-local` for an overlay only the reader serves. `node:fs` comes from
- * `process.getBuiltinModule`, not an `import`, so the library loads no `node:` builtin
- * (FB015 exempts this fallback), and `process` is read through `globalThis`, as in
- * `core/typescript-module.ts`.
- *
- * The tenant calls (`registry prepare`'s `uip` runs) have a sibling slot,
- * `globalThis[Symbol.for('uipath.maestro-builder-sdk.uip')]`, documented on
- * `defaultUipClient` in `registry/uip/client.ts`.
- */
 /** The file's text, or `undefined` when there is none. */
 export type ReadText = (path: string) => string | undefined;
 /** The reader a default read uses: the host's, when one is in the slot, else the disk. */

package/dist/core/read-text.js

@@ -26,6 +26,7 @@
  * `globalThis[Symbol.for('uipath.maestro-builder-sdk.uip')]`, documented on
  * `defaultUipClient` in `registry/uip/client.ts`.
  */
+import { CompileRefusal } from './compile-refusal.js';
 const HOST_READ_TEXT = Symbol.for('uipath.maestro-builder-sdk.readText');
 /** The reader a default read uses: the host's, when one is in the slot, else the disk. */
 export function defaultReadText() {
@@ -34,7 +35,7 @@ export function defaultReadText() {
 export function readTextFromDisk(path) {
     const getBuiltinModule = globalThis.process?.getBuiltinModule;
     if (getBuiltinModule === undefined) {
-        throw new Error(`cannot read ${path}: outside Node, pass a readText function to the connector library`
+        throw new CompileRefusal('READ_TEXT_UNAVAILABLE', `cannot read ${path}: outside Node, pass a readText function to the connector library`
             + ` or set globalThis[Symbol.for('uipath.maestro-builder-sdk.readText')]`);
     }
     const fs = getBuiltinModule('node:fs');
@@ -48,7 +49,7 @@ export function libraryPath(dir, rel) {
 export function readJson(read, path) {
     const text = read(path);
     if (text === undefined)
-        throw new Error(`no such file: ${path}`);
+        throw new CompileRefusal('FILE_NOT_FOUND', `no such file: ${path}`);
     return JSON.parse(text);
 }
 /** One reader's cache. Two readers can serve different files at the same path. */

package/dist/core/refusals.d.ts

@@ -0,0 +1,465 @@
+/** What a code means for `check` and `compile`. */
+export type RefusalClass = 'lint' | 'lowering' | 'draft';
+/** Every code the Flow compile path emits → its class. Sorted by code. */
+export declare const REFUSALS: {
+    readonly AGENTIC_EMPTY_RETURNS: "lint";
+    readonly AGENTIC_KEY_NOT_KEY: "lint";
+    readonly AGENTIC_LOCAL_FORM_UNVERIFIED: "lint";
+    readonly AGENTIC_LOCAL_HAS_FOLDER: "lint";
+    readonly AGENTIC_LOCAL_NO_PROJECT_ID: "lint";
+    readonly AGENTIC_LOCAL_PROJECT_ID_NOT_GUID: "lint";
+    readonly AGENTIC_NAME_IS_PATH: "lint";
+    readonly AGENTIC_NO_FOLDER: "lint";
+    readonly AGENTIC_NO_KEY: "lint";
+    readonly AGENTIC_NO_NAME: "lint";
+    readonly AGENTIC_READ_NOT_OUTPUT: "lint";
+    readonly AGENTIC_READ_UNKNOWN_FIELD: "lint";
+    readonly AGENTIC_READ_WITHOUT_RETURNS: "lint";
+    readonly AGENTIC_RESERVED_INPUT: "lint";
+    readonly AGENT_CONTEXT_NO_FOLDER_PATH: "lint";
+    readonly AGENT_CONTEXT_NO_ID: "lowering";
+    readonly AGENT_CONTEXT_QUERY_NOT_EXPRESSION: "lint";
+    readonly AGENT_EMPTY_INPUT_FLOOR: "lint";
+    readonly AGENT_EMPTY_RETURNS: "lint";
+    readonly AGENT_KEY_NOT_GUID: "lint";
+    readonly AGENT_LOCAL_NO_PROJECT_ID: "lint";
+    readonly AGENT_LOCAL_PROJECT_ID_NOT_GUID: "lint";
+    readonly AGENT_MEMORY_NOT_AUTHORABLE: "lint";
+    readonly AGENT_MEMORY_VERSION_NO_HANDLE: "lowering";
+    readonly AGENT_NAME_IS_PATH: "lint";
+    readonly AGENT_NO_FOLDER: "lint";
+    readonly AGENT_NO_KEY: "lint";
+    readonly AGENT_NO_NAME: "lint";
+    readonly AGENT_READ_NOT_OUTPUT: "lint";
+    readonly AGENT_READ_UNKNOWN_FIELD: "lint";
+    readonly AGENT_READ_WITHOUT_RETURNS: "lint";
+    readonly AGENT_READ_WRONG_CASE: "lint";
+    readonly APIWF_EMPTY_RETURNS: "lint";
+    readonly APIWF_KEY_NOT_KEY: "lint";
+    readonly APIWF_NAME_IS_PATH: "lint";
+    readonly APIWF_NO_FOLDER: "lint";
+    readonly APIWF_NO_KEY: "lint";
+    readonly APIWF_NO_NAME: "lint";
+    readonly APIWF_READ_NOT_OUTPUT: "lint";
+    readonly APIWF_READ_UNKNOWN_FIELD: "lint";
+    readonly APIWF_READ_WITHOUT_RETURNS: "lint";
+    readonly ARM_SCOPED_OUTPUT_READ: "lint";
+    readonly BINDING_MISSING: "draft";
+    readonly BINDING_PLACEHOLDER_UNRESOLVED: "draft";
+    readonly BINDING_SELF_NAME: "draft";
+    readonly BINDING_UNDECLARED: "draft";
+    readonly BRANCH_CONST_COND: "lint";
+    readonly BREAK_OUTSIDE_LOOP: "lowering";
+    readonly CALL_NO_NUMBER: "lint";
+    readonly CALL_NUMBER_NOT_E164: "lint";
+    readonly CARRIED_DEFINITION_CONFLICT: "lowering";
+    readonly CARRIED_DEFINITION_INVALID: "lowering";
+    readonly CEQL_UNPARSEABLE: "lowering";
+    readonly CONNECTION_CONNECTOR_CONFLICT: "draft";
+    readonly CONNECTION_STUB: "lint";
+    readonly CONNECTOR_IMPORT_NOT_A_FILE: "lowering";
+    readonly CONNECTOR_INPUT: "lowering";
+    readonly CONNECTOR_INPUT_MISSING: "draft";
+    readonly CONNECTOR_LIBRARY_ENTRY_UNREADABLE: "lowering";
+    readonly CONNECTOR_NODE_TYPE_INVALID: "lowering";
+    readonly CONNECTOR_NOT_IN_LIBRARY: "lowering";
+    readonly CONNECTOR_NO_FLOW_DEFINITION: "lowering";
+    readonly CONNECTOR_OBJECT_NOT_GENERIC: "lowering";
+    readonly CONNECTOR_OBJECT_REQUIRED: "draft";
+    readonly CONNECTOR_RESOLVE_FAILED: "lowering";
+    readonly CONTINUE_OUTSIDE_LOOP: "lowering";
+    readonly CONTRIBUTION_BINDING_UNRESOLVED: "draft";
+    readonly CONTRIBUTION_INVALID: "lowering";
+    readonly CONVERSATION_NO_ID: "lint";
+    readonly CONVERSATION_RANGE: "lint";
+    readonly CONV_AGENT_CUSTOM_NO_ID: "lint";
+    readonly CONV_AGENT_NO_MODEL: "lint";
+    readonly CONV_AGENT_NO_PROMPT: "lint";
+    readonly CONV_AGENT_NO_TURN: "lint";
+    readonly CONV_AGENT_SETTINGS_MODE: "lint";
+    readonly CUSTOM_FIELDS_UNPREPARED: "lint";
+    readonly DATAFABRIC_DELETE_HAS_NO_OUTPUT: "lint";
+    readonly DATAFABRIC_EMPTY_SET: "lint";
+    readonly DATAFABRIC_EMPTY_VALUES: "lint";
+    readonly DATAFABRIC_FILTER_BLANK_VALUE: "lint";
+    readonly DATAFABRIC_FOLDER_NO_RESOURCE_KEY: "lint";
+    readonly DATAFABRIC_FROMREAD_MULTIPLE: "lint";
+    readonly DATAFABRIC_FROMREAD_UNKNOWN: "lint";
+    readonly DATAFABRIC_IN_REQUIRES_MULTIPLE: "lint";
+    readonly DATAFABRIC_LIMIT_RANGE: "lint";
+    readonly DATAFABRIC_NO_ENTITY: "lint";
+    readonly DATAFABRIC_QUERY_OPTS_WITHOUT_MULTIPLE: "lint";
+    readonly DATAFABRIC_RECORD_REF: "lowering";
+    readonly DATAFABRIC_RESOURCE_KEY_NO_FOLDER: "lint";
+    readonly DATAFABRIC_RESULT_MODE_VERSION: "lowering";
+    readonly DATAFABRIC_SYSTEM_COLUMN: "lint";
+    readonly DECLARATION_SHAPE: "lowering";
+    readonly DECLARATION_TYPE_UNKNOWN: "lowering";
+    readonly DECOMPILE_NOT_A_NUMBER: "lowering";
+    readonly DECOMPILE_VARIABLES_SHAPE: "lowering";
+    readonly DELAY_CALENDAR: "lint";
+    readonly DELAY_DURATION_XOR_UNTIL: "lowering";
+    readonly DELAY_HAS_NO_OUTPUT: "lint";
+    readonly DELAY_NOT_ISO: "lint";
+    readonly DELAY_NO_DURATION: "lint";
+    readonly DELAY_UNTIL_NOT_ISO: "lint";
+    readonly DELAY_ZERO: "lint";
+    readonly DOCVAL_NO_EXTRACTION: "lint";
+    readonly DOCVAL_RENDER_UNKNOWN: "lint";
+    readonly DOCVAL_TAXONOMY_REQUIRED: "lint";
+    readonly DOC_NO_FILEREF: "lint";
+    readonly DOWHILE_CONST_COND: "lint";
+    readonly DOWHILE_LIMIT: "lint";
+    readonly DUP_CASE: "lint";
+    readonly DUP_END_NAME: "lowering";
+    readonly DUP_STEP: "lowering";
+    readonly EMPTY_ARM: "lint";
+    readonly EMPTY_LOOP: "lint";
+    readonly ENTRY_POINT_DUP_ID: "lowering";
+    readonly ENTRY_POINT_INPUT_COLLISION: "lint";
+    readonly ENTRY_POINT_NO_SHARED_BODY: "lowering";
+    readonly ERROR_ENVELOPE_VIA_OUTPUT: "lint";
+    readonly ERROR_FIELD_UNDECLARED: "lint";
+    readonly ERROR_READ_OUTSIDE_HANDLER: "lowering";
+    readonly ERROR_READ_VIA_OUT: "lint";
+    readonly EVENT_BYOA_UNVERIFIED: "lowering";
+    readonly EVENT_FILTERS_NOT_ARRAY: "lint";
+    readonly EVENT_FILTER_BACKSLASH: "lowering";
+    readonly EVENT_FILTER_BAD_VALUE: "lowering";
+    readonly EVENT_FILTER_MANY_OPERATORS: "lowering";
+    readonly EVENT_FILTER_NO_FIELD: "lowering";
+    readonly EVENT_FILTER_NO_VALUE: "lowering";
+    readonly EVENT_FILTER_UNKNOWN_FIELD: "lint";
+    readonly EVENT_GENERIC_NO_OBJECT: "lowering";
+    readonly EVENT_NO_CONNECTOR: "lint";
+    readonly EVENT_NO_EVENT: "lint";
+    readonly EVENT_NO_SCOPE: "lint";
+    readonly EVENT_NO_SUBSCRIPTION: "lint";
+    readonly EVENT_OBJECT_NOT_GENERIC: "lint";
+    readonly EVENT_SCOPE_NOT_TAKEN: "lint";
+    readonly EVENT_UNKNOWN: "lowering";
+    readonly EVENT_UNPREPARED: "lint";
+    readonly EXPR_SYNTAX: "lowering";
+    readonly EXPR_UNDECLARED_REF: "lowering";
+    readonly EXTRACT_SCHEMA_SHAPE: "lint";
+    readonly FILE_NOT_FOUND: "lowering";
+    readonly FIRE_AND_FORGET_READ: "lint";
+    readonly FIRE_AND_FORGET_RETURNS: "lowering";
+    readonly FLOW_EXPORT_NOT_BUILT: "lowering";
+    readonly FLOW_NO_DEFAULT_EXPORT: "lowering";
+    readonly FLOW_SOURCE_NOT_FOUND: "lowering";
+    readonly FORM_TRIGGER_NO_INPUTS: "lint";
+    readonly FUNCTION_EMPTY_RETURNS: "lint";
+    readonly FUNCTION_KEY_NOT_KEY: "lint";
+    readonly FUNCTION_NAME_IS_PATH: "lint";
+    readonly FUNCTION_NO_FOLDER: "lint";
+    readonly FUNCTION_NO_KEY: "lint";
+    readonly FUNCTION_NO_NAME: "lint";
+    readonly FUNCTION_READ_NOT_OUTPUT: "lint";
+    readonly FUNCTION_READ_UNKNOWN_FIELD: "lint";
+    readonly FUNCTION_READ_WITHOUT_RETURNS: "lint";
+    readonly GUARDRAIL_ACTION_UNKNOWN: "lint";
+    readonly GUARDRAIL_DUP_ID: "lint";
+    readonly GUARDRAIL_INCOMPLETE: "lint";
+    readonly GUARDRAIL_NO_RULES: "lint";
+    readonly GUARDRAIL_NO_SCOPE: "lint";
+    readonly GUARDRAIL_NO_VALIDATOR: "lint";
+    readonly GUARDRAIL_TYPE_UNKNOWN: "lint";
+    readonly HITL_APP_INCOMPLETE: "lint";
+    readonly HITL_APP_MISSING: "lint";
+    readonly HITL_APP_WITHOUT_VARIANT: "lint";
+    readonly HITL_APP_WITH_FIELDS: "lint";
+    readonly HITL_CHANNEL_UNKNOWN: "lint";
+    readonly HITL_COMPLETED_PORT_GONE: "lowering";
+    readonly HITL_DOCUMENT_WITHOUT_VARIANT: "lint";
+    readonly HITL_DOCVAL_NO_DOCUMENT: "lint";
+    readonly HITL_DOCVAL_WITH_FIELDS: "lint";
+    readonly HITL_DUP_FIELD: "lint";
+    readonly HITL_DUP_OUTCOME: "lint";
+    readonly HITL_DUP_OUTCOME_ID: "lint";
+    readonly HITL_END_OUTCOME_IN_PARALLEL: "lowering";
+    readonly HITL_EXPOSE_ERROR_VERSION: "lowering";
+    readonly HITL_FAN_OUT_INTO_JOIN: "lowering";
+    readonly HITL_FIELD_DIRECTION: "lint";
+    readonly HITL_FIELD_NO_ID: "lint";
+    readonly HITL_FIELD_NO_VALUE: "lint";
+    readonly HITL_FIELD_OPTIONS: "lint";
+    readonly HITL_FIELD_OPTIONS_IGNORED: "lint";
+    readonly HITL_FIELD_RESERVED_ID: "lint";
+    readonly HITL_FIELD_SETTING_INVALID: "lint";
+    readonly HITL_FIELD_TYPE_UNKNOWN: "lint";
+    readonly HITL_FIELD_VALUE_NOT_PATH: "lint";
+    readonly HITL_FIELD_VALUE_NOT_REF: "lint";
+    readonly HITL_FIELD_VARIABLE: "lint";
+    readonly HITL_LEGACY_COMPLETED: "lint";
+    readonly HITL_LEGACY_COMPLETED_CONFLICT: "lowering";
+    readonly HITL_LEGACY_COMPLETED_NO_EFFECT: "lint";
+    readonly HITL_LEGACY_COMPLETED_VERSION: "lowering";
+    readonly HITL_NO_FIELDS: "lint";
+    readonly HITL_NO_OUTCOMES: "lint";
+    readonly HITL_OUTCOMES_UNREACHABLE: "lint";
+    readonly HITL_OUTCOME_ACTION: "lint";
+    readonly HITL_OUTCOME_BAD_ID: "lint";
+    readonly HITL_OUTCOME_NO_NAME: "lint";
+    readonly HITL_OUTCOME_PORTS_OFF: "lowering";
+    readonly HITL_OUTCOME_PORTS_VARIANT: "lowering";
+    readonly HITL_OUTCOME_PORT_MISPLACED: "lint";
+    readonly HITL_OUTCOME_PORT_UNKNOWN: "lowering";
+    readonly HITL_OUTCOME_UNROUTED: "lint";
+    readonly HITL_PORT_ALREADY_WIRED: "lowering";
+    readonly HITL_READ_NOT_OUTPUT: "lint";
+    readonly HITL_READ_STATUS: "lint";
+    readonly HITL_READ_UNKNOWN_FIELD: "lint";
+    readonly HITL_RECIPIENT_TYPE: "lint";
+    readonly HITL_RECIPIENT_VALUE: "lint";
+    readonly HITL_UNREACHABLE_AFTER: "lint";
+    readonly HITL_VARIANT_UNKNOWN: "lint";
+    readonly HTTP_BINDING_REQUIRES_MANAGED: "lowering";
+    readonly HTTP_BRANCH_CONST: "lint";
+    readonly HTTP_BRANCH_DUP: "lint";
+    readonly HTTP_BRANCH_NAME: "lint";
+    readonly HTTP_BRANCH_UNKNOWN: "lint";
+    readonly HTTP_MANAGED_BINDING_INCOMPLETE: "lowering";
+    readonly HTTP_MANAGED_REQUIRED: "lowering";
+    readonly HTTP_ONERROR_V1: "lint";
+    readonly HTTP_READ_NOT_OUTPUT: "lint";
+    readonly HTTP_READ_UNKNOWN_FIELD: "lint";
+    readonly HTTP_READ_WITHOUT_RETURNS: "lint";
+    readonly HTTP_RETRY_COUNT_HIGH: "lint";
+    readonly HTTP_RETRY_COUNT_INVALID: "lint";
+    readonly HTTP_TARGET_CONNECTOR_EMPTY: "lowering";
+    readonly HTTP_TARGET_CONNECTOR_REQUIRES_BINDING: "lowering";
+    readonly HTTP_TIMEOUT_NOT_DURATION: "lint";
+    readonly HTTP_V1_RETIRED: "lint";
+    readonly INLINE_AGENT_COMPOSITE_INPUT: "lint";
+    readonly INLINE_AGENT_EMPTY_RETURNS: "lint";
+    readonly INLINE_AGENT_ESCALATION_APP_KEY_NOT_GUID: "lint";
+    readonly INLINE_AGENT_ESCALATION_APP_WITH_FIELDS: "lint";
+    readonly INLINE_AGENT_ESCALATION_FIELD_OPTIONS: "lint";
+    readonly INLINE_AGENT_ESCALATION_FIELD_OPTIONS_IGNORED: "lint";
+    readonly INLINE_AGENT_ESCALATION_FIELD_SETTING_INVALID: "lint";
+    readonly INLINE_AGENT_ESCALATION_FIELD_TYPE_UNKNOWN: "lint";
+    readonly INLINE_AGENT_ESCALATION_NO_APP: "lint";
+    readonly INLINE_AGENT_ESCALATION_NO_FIELDS: "lint";
+    readonly INLINE_AGENT_ESCALATION_NO_NAME: "lint";
+    readonly INLINE_AGENT_ESCALATION_QUICKFORM_WITH_APP: "lint";
+    readonly INLINE_AGENT_ESCALATION_VARIANT: "lint";
+    readonly INLINE_AGENT_INPUT_NAME_AMBIGUOUS: "lint";
+    readonly INLINE_AGENT_MEMORY_ID_NOT_GUID: "lint";
+    readonly INLINE_AGENT_MEMORY_INCOMPLETE: "lint";
+    readonly INLINE_AGENT_NO_MODEL: "lint";
+    readonly INLINE_AGENT_NO_SYSTEM_PROMPT: "lint";
+    readonly INLINE_AGENT_NO_USER_PROMPT: "lint";
+    readonly INLINE_AGENT_PROMPT_JSON_TEXT: "lint";
+    readonly INLINE_AGENT_READ_NOT_OUTPUT: "lint";
+    readonly INLINE_AGENT_READ_UNKNOWN_FIELD: "lint";
+    readonly INLINE_AGENT_RESOURCE_NODE_ID: "lowering";
+    readonly INLINE_AGENT_RESOURCE_SOURCE_DUP: "lowering";
+    readonly INLINE_AGENT_RESOURCE_SOURCE_NOT_GUID: "lint";
+    readonly INLINE_AGENT_SCAFFOLD_MODEL: "lint";
+    readonly INLINE_AGENT_SOURCE_NOT_GUID: "lint";
+    readonly INLINE_AGENT_TOOL_A2A_INCOMPLETE: "lint";
+    readonly INLINE_AGENT_TOOL_CLIENTSIDE_NO_NAME: "lint";
+    readonly INLINE_AGENT_TOOL_CONNECTOR_NO_CONNECTION: "lint";
+    readonly INLINE_AGENT_TOOL_HTTP_METHOD: "lint";
+    readonly INLINE_AGENT_TOOL_IXP_NO_NAME: "lint";
+    readonly INLINE_AGENT_TOOL_IXP_PROJECT_NOT_GUID: "lint";
+    readonly INLINE_AGENT_TOOL_KEY_NOT_GUID: "lint";
+    readonly INLINE_AGENT_TOOL_MCP_INCOMPLETE: "lint";
+    readonly INLINE_AGENT_TOOL_NO_OPERATION: "lint";
+    readonly INLINE_AGENT_TOOL_NO_RESOURCE_ID: "lint";
+    readonly INLINE_AGENT_TOOL_UNKNOWN_BUILTIN: "lowering";
+    readonly INLINE_AGENT_TOOL_UNKNOWN_KIND: "lowering";
+    readonly INLINE_AGENT_UNDECLARED_PLACEHOLDER: "lint";
+    readonly INLINE_AGENT_UNREFERENCED_INPUT: "lint";
+    readonly INPUT_READ_WITHOUT_TRIGGER: "lint";
+    readonly IXP_FORBIDDEN_INPUT: "lint";
+    readonly IXP_NO_FILE: "lint";
+    readonly IXP_NO_FOLDER: "lint";
+    readonly IXP_NO_MODEL_NAME: "lint";
+    readonly IXP_NO_NAME: "lint";
+    readonly IXP_NO_PROJECT: "lowering";
+    readonly IXP_PROJECT_NOT_NODE_TYPE: "lowering";
+    readonly IXP_PROJECT_TAIL_UNPARSEABLE: "lowering";
+    readonly JSON_REF_CIRCULAR: "lowering";
+    readonly JSON_REF_NOT_JSON: "lowering";
+    readonly JSON_REF_PATH_INVALID: "lowering";
+    readonly JSON_REF_TOO_DEEP: "lowering";
+    readonly JSON_REF_UNREADABLE: "lowering";
+    readonly JS_ESCAPE_COOKED: "lint";
+    readonly JS_ESCAPE_INVALID: "lint";
+    readonly LAYOUT_EDGE_AMBIGUOUS: "lowering";
+    readonly LAYOUT_EDGE_KEY_FORM: "lowering";
+    readonly LAYOUT_UNKNOWN_KEY: "lowering";
+    readonly LIBRARY_NOT_FOUND: "lowering";
+    readonly LIBRARY_REQUIRED: "lowering";
+    readonly LIST_OUTPUT_WRAPPER: "lint";
+    readonly LOOKUP_ARGS: "lowering";
+    readonly LOOKUP_LITERAL_ID: "lint";
+    readonly LOOKUP_MISPLACED: "lowering";
+    readonly LOOKUP_RUNTIME_VALUE: "lint";
+    readonly LOOKUP_UNKNOWN_ALIAS: "lowering";
+    readonly LOOKUP_UNKNOWN_FIELD: "lowering";
+    readonly LOOKUP_UNKNOWN_MATCH_KEY: "lowering";
+    readonly LOOKUP_UNRESOLVED: "lowering";
+    readonly LOOP_EXIT_IN_PARALLEL_ARM: "lint";
+    readonly LOOP_EXIT_UNREACHABLE_AFTER: "lint";
+    readonly LOOP_PARALLEL_LEGACY: "lint";
+    readonly LOOP_VERSION_UNSUPPORTED: "lowering";
+    readonly MOCK_HAS_NO_OUTPUT: "lint";
+    readonly NODE_FAMILY_REGISTRATION: "lowering";
+    readonly NODE_VERSION_UNREGISTERED: "lowering";
+    readonly NO_ID: "lint";
+    readonly NO_RETURN: "lint";
+    readonly OBJECT_UNPREPARED: "lint";
+    readonly ONERROR_NO_ERROR_PORT: "lowering";
+    readonly OUTPUT_BACKING_COLLISION: "lowering";
+    readonly OUTPUT_TYPE_MISMATCH: "lint";
+    readonly OUTPUT_VAR_MISMATCH: "lowering";
+    readonly PACKAGE_NODES_NOT_PLATFORM: "lint";
+    readonly PARALLEL_ARM_RETURNS: "lint";
+    readonly PARALLEL_EMPTY_ARM: "lint";
+    readonly PARALLEL_FORK_ALTERNATIVES: "lowering";
+    readonly PARALLEL_HAS_NO_OUTPUT: "lint";
+    readonly PARALLEL_REF_JOIN: "lint";
+    readonly PARALLEL_TOO_FEW_ARMS: "lint";
+    readonly PORT_ALREADY_ROUTED: "lowering";
+    readonly PORT_EMPTY_PATH: "lowering";
+    readonly PORT_NO_SOURCE_STEP: "lowering";
+    readonly QUEUE_BAD_DATE: "lint";
+    readonly QUEUE_BAD_PRIORITY: "lint";
+    readonly QUEUE_ITEM_EXPR_UNSUPPORTED: "lowering";
+    readonly QUEUE_ITEM_FIELD_NOT_PRIMITIVE: "lint";
+    readonly QUEUE_ITEM_NOT_OBJECT: "lint";
+    readonly QUEUE_KEY_NOT_GUID: "lint";
+    readonly QUEUE_NO_FOLDER: "lint";
+    readonly QUEUE_NO_ITEM: "lint";
+    readonly QUEUE_NO_KEY: "lint";
+    readonly QUEUE_NO_NAME: "lint";
+    readonly QUEUE_READ_NOT_OUTPUT: "lint";
+    readonly QUEUE_READ_UNKNOWN_FIELD: "lint";
+    readonly QUEUE_READ_WITHOUT_RETURNS: "lint";
+    readonly QUEUE_RETURNS_WITHOUT_WAIT: "lint";
+    readonly RAW_NODE_CONNECTOR: "lowering";
+    readonly RAW_NODE_TYPED_FAMILY: "lint";
+    readonly RAW_NODE_UNKNOWN_INPUT: "lowering";
+    readonly RAW_NODE_VERSION_MISMATCH: "lowering";
+    readonly READ_TEXT_UNAVAILABLE: "lowering";
+    readonly REF_INTO_LOOP: "lint";
+    readonly REF_INTO_PARALLEL_ARM: "lint";
+    readonly REF_INTO_PORT_LIST: "lint";
+    readonly REF_OUT_OF_LOOP: "lint";
+    readonly REF_OUT_OF_PARALLEL_ARM: "lint";
+    readonly REF_TARGET_NOT_NAME: "lowering";
+    readonly REF_TO_OWN_LOOP: "lint";
+    readonly REF_UNKNOWN_TARGET: "lowering";
+    readonly REF_UNREACHABLE_AFTER: "lint";
+    readonly RETURN_UPDATES_SAME_VAR: "lowering";
+    readonly RPA_KEY_NOT_KEY: "lint";
+    readonly RPA_LOCAL_HAS_FOLDER: "lint";
+    readonly RPA_LOCAL_NO_PROJECT_ID: "lint";
+    readonly RPA_LOCAL_PROJECT_ID_NOT_GUID: "lint";
+    readonly RPA_NAME_IS_PATH: "lint";
+    readonly RPA_NO_FOLDER: "lint";
+    readonly RPA_NO_KEY: "lint";
+    readonly RPA_NO_NAME: "lint";
+    readonly RPA_READ_NOT_OUTPUT: "lint";
+    readonly RPA_READ_UNKNOWN_FIELD: "lint";
+    readonly RPA_READ_WITHOUT_RETURNS: "lint";
+    readonly SCHEDULE_CRON_VERSION: "lowering";
+    readonly SCHEDULE_NEVER_FIRES: "lint";
+    readonly SCHEDULE_NOT_ISO: "lint";
+    readonly SCHEDULE_NO_INTERVAL: "lint";
+    readonly SCHEMA_VERSION_ABOVE_FLOOR: "lint";
+    readonly SCHEMA_VERSION_BELOW_FLOOR: "lint";
+    readonly SCHEMA_VERSION_ON_SUBFLOW: "lint";
+    readonly SCHEMA_VERSION_UNSUPPORTED: "lowering";
+    readonly SCRIPT_EMPTY_RETURNS: "lint";
+    readonly SCRIPT_FUNCTION_SCOPE: "lowering";
+    readonly SCRIPT_FUNCTION_UNLOWERABLE: "lowering";
+    readonly SCRIPT_RETURNS_UNKNOWN_TYPE: "lint";
+    readonly SDK_RESOLVE_HOOK_MISSING: "lowering";
+    readonly SEND_MESSAGE_NO_CONTENT: "lint";
+    readonly SEND_MESSAGE_NO_EXCHANGE: "lint";
+    readonly SHARED_INPUT_IN_SUBFLOW: "lowering";
+    readonly SHARED_INPUT_NAME_INVALID: "lowering";
+    readonly SHARED_INPUT_NOT_INPUT: "lowering";
+    readonly SHARED_INPUT_ROOT_MISSING: "lint";
+    readonly SHARED_INPUT_SAME_ROOT: "lowering";
+    readonly SHARED_INPUT_TARGET_IS_INPUT: "lowering";
+    readonly SHARED_INPUT_TYPE_MISMATCH: "lowering";
+    readonly SINGLE_CONVERSATION_TRIGGER: "lint";
+    readonly STEP_ID_COLLISION: "lowering";
+    readonly STEP_NOT_ACTION: "lowering";
+    readonly STEP_READ_WITHOUT_OUTPUT: "lint";
+    readonly STEP_SWITCH_ARM_LABEL: "lowering";
+    readonly STEP_SWITCH_EXIT_DUP: "lint";
+    readonly STEP_SWITCH_EXIT_UNKNOWN: "lowering";
+    readonly STEP_SWITCH_EXIT_UNROUTED: "lint";
+    readonly STEP_SWITCH_NO_ARMS: "lowering";
+    readonly STEP_SWITCH_NO_EXITS: "lowering";
+    readonly STICKY_NOTE_DUP_ID: "lowering";
+    readonly STICKY_NOTE_ID_TAKEN: "lowering";
+    readonly STICKY_NOTE_NO_CONTENT: "lowering";
+    readonly STICKY_NOTE_POSITION: "lowering";
+    readonly STICKY_NOTE_SIZE: "lowering";
+    readonly SUBFLOW_CHILD_TRIGGER: "lint";
+    readonly SUBFLOW_CYCLE: "lint";
+    readonly SUBFLOW_HAS_NO_OUTPUT: "lint";
+    readonly SUBFLOW_MISSING_INPUT: "lint";
+    readonly SUBFLOW_NO_CHILD: "lint";
+    readonly SUBFLOW_OUTPUT_NEVER_RETURNED: "lint";
+    readonly SUBFLOW_OUTPUT_NO_FIELD: "lint";
+    readonly SUBFLOW_UNKNOWN_INPUT: "lint";
+    readonly SUBFLOW_UNKNOWN_OUTPUT: "lint";
+    readonly SWITCH_CASE_FORM: "lint";
+    readonly SWITCH_CASE_ID: "lint";
+    readonly SWITCH_CASE_TYPE_MISMATCH: "lint";
+    readonly SWITCH_CONST_ON: "lint";
+    readonly SWITCH_CONST_WHEN: "lint";
+    readonly SWITCH_HAS_NO_OUTPUT: "lint";
+    readonly SWITCH_NO_CASES: "lint";
+    readonly SWITCH_ON_UNUSED: "lint";
+    readonly TEMPLATED_EXITS_ONLY: "lowering";
+    readonly TERMINATE_HAS_NO_OUTPUT: "lint";
+    readonly TERMINATE_NOT_ARM_HEAD: "lint";
+    readonly TERMINATE_UNREACHABLE_AFTER: "lint";
+    readonly TRANSFORM_AGG_NO_ALIAS: "lint";
+    readonly TRANSFORM_AGG_NO_FIELD: "lint";
+    readonly TRANSFORM_BAD_VOCAB: "lint";
+    readonly TRANSFORM_COLLECTION_LITERAL: "lint";
+    readonly TRANSFORM_COLLECTION_NOT_PATH: "lint";
+    readonly TRANSFORM_COLLECTION_NOT_REF: "lint";
+    readonly TRANSFORM_COLLECTION_SCALAR: "lint";
+    readonly TRANSFORM_CONTAINS_ARRAY_VALUE: "lint";
+    readonly TRANSFORM_EMPTY_FILTER: "lint";
+    readonly TRANSFORM_EMPTY_MAP: "lint";
+    readonly TRANSFORM_FILTER_NO_FIELD: "lint";
+    readonly TRANSFORM_FILTER_VALUE_EXPR: "lint";
+    readonly TRANSFORM_MAP_NO_FIELD: "lint";
+    readonly TRANSFORM_NO_COLLECTION: "lint";
+    readonly TRANSFORM_NO_GROUP_FIELD: "lint";
+    readonly TRANSFORM_NO_OPERATIONS: "lint";
+    readonly TRANSFORM_UNKNOWN_OP: "lint";
+    readonly TRANSFORM_VARIANT_ONE_OP: "lint";
+    readonly TRANSFORM_VARIANT_OP_MISMATCH: "lint";
+    readonly TRANSFORM_VARIANT_UNKNOWN: "lowering";
+    readonly TRIGGER_INPUTS_IGNORED: "lint";
+    readonly TRIGGER_UNKNOWN_KIND: "lowering";
+    readonly TYPESCRIPT_UNAVAILABLE: "lowering";
+    readonly UNKNOWN_LOOP_FIELD: "lint";
+    readonly UNKNOWN_REF: "lint";
+    readonly UPDATES_NOT_SUPPORTED: "lowering";
+    readonly UPDATE_INPUT_READONLY: "lint";
+    readonly UPDATE_UNKNOWN_VAR: "lint";
+    readonly VARIABLE_NAME_COLLISION: "lowering";
+    readonly VARS_BRACKET_READ: "lint";
+    readonly VOICE_AGENT_ITERATIONS: "lint";
+    readonly VOICE_AGENT_NO_PROMPT: "lint";
+    readonly VOICE_CALL_CONTEXT_NOT_OBJECT: "lint";
+    readonly VOICE_MODEL_UNKNOWN: "lint";
+    readonly VOICE_NO_CALL_CONTEXT: "lint";
+    readonly VOICE_PERSONA_UNKNOWN: "lint";
+};
+/** The class of `code`, or `undefined` for a code the table does not list. */
+export declare function refusalClass(code: string): RefusalClass | undefined;