@ethisyscore/plugin-ui 1.76.0 → 1.78.0

package/dist/components/connectors/index.d.cts

@@ -40,6 +40,93 @@ interface MappingCompletenessItem {
 interface MappingCompletenessResult {
     operations: MappingCompletenessItem[];
 }
+/**
+ * Type discriminator for a canonical field. Mirrors the backend `CanonicalFieldKind` enum.
+ *
+ * Wire format is the enum member name (e.g. `"String"`, `"StringArray"`); the editor renders the
+ * value verbatim as the field-kind chip, so an unrecognised kind degrades to a label rather than
+ * a blank.
+ */
+type ConnectorCanonicalFieldKind = "String" | "Integer" | "Boolean" | "DateTime" | "Object" | "StringArray";
+/**
+ * A single canonical field on an operation's request or response schema. Carried on the mapping row
+ * so the editor can render an input per field without a separate schema fetch.
+ */
+interface ConnectorCanonicalField {
+    name: string;
+    kind: ConnectorCanonicalFieldKind;
+    isRequired: boolean;
+}
+/**
+ * Arguments the editor hands to the consumer-supplied `onTestMapping` callback. The consumer builds
+ * the full service request from these plus its own `connectorId` / `operationKey` / `toolName` — the
+ * editor owns no network call.
+ */
+interface TestToolMappingRequest {
+    /** Sample values the operator typed — one entry per canonical request field. */
+    sampleArgs: Record<string, unknown>;
+    /** Current unsaved request-field map (empty inputs stripped; `null` if all blank). */
+    requestFieldMap: Record<string, string> | null;
+    /** Current unsaved response-field paths (empty inputs stripped; `null` if all blank). */
+    responseFieldPaths: Record<string, string> | null;
+    /**
+     * Current unsaved static request parameters (blank-key rows dropped; `null` if none). Optional and
+     * backward-compatible: it lets the dry-run exercise the DRAFT static params — a consolidated
+     * tool's `method` discriminator, say — that the operator typed but has not saved yet. A consumer
+     * whose test endpoint does not accept static fields simply ignores it.
+     */
+    staticRequestFields?: Record<string, string> | null;
+}
+/**
+ * Result of extracting one canonical response field from the tool's raw response. Mirrors the
+ * backend `ExtractedFieldResult` DTO.
+ */
+interface TestToolMappingExtractedField {
+    canonicalField: string;
+    /** Extracted value, or `null` when the path matched nothing. */
+    value: string | null;
+    /** `true` when the JSON path resolved to a node in the response. */
+    present: boolean;
+    /**
+     * `true` when the extracted value looks like Base64 content (long string, charset
+     * `[A-Za-z0-9+/=]`, no whitespace). The editor shows a "prefix with base64:" hint so the operator
+     * adjusts the JSON path rather than concluding the mapping is broken.
+     */
+    looksBase64: boolean;
+}
+/** Result the consumer's `onTestMapping` callback resolves with, after the dry-run. */
+interface TestToolMappingResult {
+    success: boolean;
+    /** Error message when `success` is false. */
+    error: string | null;
+    /**
+     * Raw JSON string of the tool's response, shown in a collapsible so the operator can find the
+     * right JSON path.
+     */
+    rawResponseJson: string | null;
+    /** Per-field extraction result. */
+    extractedFields: TestToolMappingExtractedField[];
+}
+/**
+ * Result the consumer's `onSuggestTranslation` callback resolves with. When `success` is true, the
+ * editor merges the two dictionaries over its current inputs so the operator can review the
+ * AI proposal before saving.
+ */
+interface ConnectorMappingSuggestionResult {
+    success: boolean;
+    /** Error message when `success` is false. `null` when `success` is true. */
+    error: string | null;
+    /**
+     * Proposed canonical-request → tool-field-name rewrite. Empty object `{}` when the model found no
+     * request-side rewrites to apply.
+     */
+    requestFieldMap: Record<string, string>;
+    /**
+     * Proposed canonical-response → JSON-path rewrite (e.g. `{ "content": "base64:$.content" }`).
+     * Empty object `{}` when the model found no response-side rewrites.
+     */
+    responseFieldPaths: Record<string, string>;
+}
 
 interface MappingCompletenessBannerProps {
     /**
@@ -97,6 +184,116 @@ interface MappingCompletenessBannerProps {
  */
 declare function MappingCompletenessBanner({ operations, onSuggestWithAi, onOpenMappingEditor, suggestingOperationKey, disableSuggest, }: MappingCompletenessBannerProps): react.JSX.Element | null;
 
+interface ConnectorMappingTranslationEditorProps {
+    open: boolean;
+    /**
+     * Human-readable operation label for the dialog title (e.g. "Get File").
+     *
+     * Optional because it is derived from a looked-up operation that may not be found: every caller
+     * passes `string | undefined`. The contract claimed required while reality was optional, so this
+     * states the truth rather than changing any runtime value.
+     */
+    operationLabel?: string;
+    /**
+     * Tool name the mapping currently points at — shown in the dialog header for context.
+     *
+     * Optional and nullable because the editor opens for an operation that may not be mapped yet:
+     * every caller passes `string | null | undefined`.
+     */
+    toolName?: string | null;
+    /**
+     * Canonical request fields the editor renders one input per.
+     *
+     * Optional and nullable: an operation may declare no canonical schema, and the editor already
+     * gates on their presence. See the coalescing note in the component body — this is not cosmetic.
+     */
+    canonicalRequestFields?: ConnectorCanonicalField[] | null;
+    /** Canonical response fields the editor renders one JSON-path input per. Same nullability. */
+    canonicalResponseFields?: ConnectorCanonicalField[] | null;
+    /** Currently-persisted request-field translation, or `null` if the operator hasn't supplied one. */
+    requestFieldMap: Record<string, string> | null;
+    /** Currently-persisted response-field translation, or `null` if the operator hasn't supplied one. */
+    responseFieldPaths: Record<string, string> | null;
+    /**
+     * Currently-persisted static request parameters (tool field name → constant literal value), or
+     * `null` if the operator hasn't supplied any. Seeds the "Static request parameters" rows.
+     */
+    staticRequestFields: Record<string, string> | null;
+    /**
+     * Called with the operator's translation dictionaries when they click Save. Empty inputs are
+     * stripped before this fires; if every input on a side was blank, that side is delivered as `null`
+     * rather than `{}` so the consumer can pass it straight through and the BE writes a NULL column
+     * (which the resolver treats as "no operator override" and falls back to the connector's
+     * vendor-default translation). A populated dictionary means "rewrite these fields explicitly"; the
+     * BE persists it verbatim and the resolver applies it on top of vendor defaults.
+     *
+     * `staticRequestFields` carries the constant tool-request parameters (e.g. `{ method: "get" }`);
+     * same null-vs-populated semantics — `null` when every static row was left blank.
+     */
+    onSave: (requestFieldMap: Record<string, string> | null, responseFieldPaths: Record<string, string> | null, staticRequestFields: Record<string, string> | null) => void;
+    onCancel: () => void;
+    /**
+     * Optional. When provided, the editor renders a Test section below the field tables and a "Test
+     * mapping" button inside it. The consumer supplies this callback so the editor never owns a
+     * network call. Invoked with the sample args and the current (unsaved) field maps — stripped to
+     * `null` when every input is blank, matching `onSave`.
+     */
+    onTestMapping?: (request: TestToolMappingRequest) => Promise<TestToolMappingResult>;
+    /**
+     * Optional. When provided, the editor renders an "Auto-configure" button in the Test section. The
+     * consumer invokes the AI suggestion endpoint with the sample inputs the Test section collects,
+     * then returns the suggested field maps so the editor can populate the request / response inputs.
+     * The operator reviews and clicks Save.
+     *
+     * @param sampleArgs - Sample values the operator typed, one entry per canonical request field.
+     * @returns The suggestion result (success/error + proposed maps).
+     */
+    onSuggestTranslation?: (sampleArgs: Record<string, unknown>) => Promise<ConnectorMappingSuggestionResult>;
+}
+/**
+ * Per-mapping translation editor — surfaced when the operator picks a tool whose schema doesn't
+ * match the operation's canonical request/response field names. Renders two stacked tables
+ * (request / response): left column shows the canonical field's name + kind chip + required
+ * indicator; right column captures the operator-supplied tool field name (request side) or JSON
+ * path (response side).
+ *
+ * <p><b>Identity semantics.</b> An empty input on a field means "identity — pass the canonical name
+ * through unchanged". On Save the editor strips empty values; if every input on a side was blank,
+ * that side is delivered to `onSave` as <code>null</code> (not <code>{}</code>) so the BE writes a
+ * NULL column. The resolver then treats the NULL as "no operator override" and falls back to the
+ * connector's vendor-default translation; a populated dictionary means "rewrite these fields
+ * explicitly" and applies on top of the vendor default.</p>
+ *
+ * <p><b>State seeding.</b> The consumer page mounts/unmounts this dialog every time the editor opens
+ * (the `open` prop is always `true` in practice — the parent gates rendering via conditional mount),
+ * so local state initialises lazily from the props on each mount. This avoids the "setState in
+ * useEffect" pattern the eslint react-hooks ruleset blocks, AND keeps the operator's in-flight edits
+ * sovereign once the dialog is open — a concurrent refresh of the mapping row doesn't clobber what
+ * they're typing.</p>
+ *
+ * <p><b>Promoted, not designed here.</b> This file existed FOUR times — the host's gogo-ui adapter
+ * plus `self-healing`, `tech` and `timesheets` — and the copies had already drifted. Three
+ * differences were adjudicated on the way in, and each is a reason the duplication was expensive:</p>
+ *
+ * <ol>
+ *   <li><b>The Test button is gated on `onTestMapping`.</b> The enclosing block is gated on
+ *       <code>(onTestMapping || onSuggestTranslation)</code>, so without the inner guard a consumer
+ *       supplying only <code>onSuggestTranslation</code> rendered a "Test mapping" button whose
+ *       handler returns immediately — a DEAD CONTROL. `self-healing` shipped that; `tech` and
+ *       `timesheets` had fixed it. Nothing noticed, because there was no single source to notice
+ *       it against.</li>
+ *   <li><b>Backgrounds come from the theme (`action.hover`), never a hardcoded
+ *       <code>rgba()</code>.</b> A literal <code>rgba(0,0,0,0.03)</code> is invisible in dark mode
+ *       and is what `coreconnect/no-hardcoded-colors` exists to stop.</li>
+ *   <li><b>No emoji in chip labels.</b> The chips already carry an icon and a semantic colour, so
+ *       the emoji was a third, untranslatable, screen-reader-hostile encoding of the same state.</li>
+ * </ol>
+ *
+ * <p>The null tolerance below came from the HOST copy, which was the most hardened of the four.
+ * `coreconnect/no-local-mapping-editor` stops a fifth being written.</p>
+ */
+declare function ConnectorMappingTranslationEditorView({ open, operationLabel, toolName, canonicalRequestFields: canonicalRequestFieldsProp, canonicalResponseFields: canonicalResponseFieldsProp, requestFieldMap, responseFieldPaths, staticRequestFields, onSave, onCancel, onTestMapping, onSuggestTranslation, }: ConnectorMappingTranslationEditorProps): react.JSX.Element;
+
 /**
  * Every operation with a gap, required or optional. Use it to decide whether to mount a banner at
  * all, without duplicating the predicate.
@@ -174,4 +371,4 @@ declare function connectorMappingsQueryKey(connectorId: string | undefined, modu
  */
 declare function connectorMappingCompletenessQueryKey(connectorId: string | undefined, moduleKey: string): readonly ["connector-mappings", string | undefined, string, "completeness"];
 
-export { MappingCompletenessBanner, type MappingCompletenessBannerProps, type MappingCompletenessItem, type MappingCompletenessResult, type MappingReadiness, connectorMappingCompletenessQueryKey, connectorMappingsQueryKey, selectIncompleteOperations, selectMappingReadiness, selectOptionalIncompleteOperations, selectRequiredIncompleteOperations };
+export { type ConnectorCanonicalField, type ConnectorCanonicalFieldKind, type ConnectorMappingSuggestionResult, type ConnectorMappingTranslationEditorProps, ConnectorMappingTranslationEditorView, MappingCompletenessBanner, type MappingCompletenessBannerProps, type MappingCompletenessItem, type MappingCompletenessResult, type MappingReadiness, type TestToolMappingExtractedField, type TestToolMappingRequest, type TestToolMappingResult, connectorMappingCompletenessQueryKey, connectorMappingsQueryKey, selectIncompleteOperations, selectMappingReadiness, selectOptionalIncompleteOperations, selectRequiredIncompleteOperations };

package/dist/components/connectors/index.d.ts

@@ -40,6 +40,93 @@ interface MappingCompletenessItem {
 interface MappingCompletenessResult {
     operations: MappingCompletenessItem[];
 }
+/**
+ * Type discriminator for a canonical field. Mirrors the backend `CanonicalFieldKind` enum.
+ *
+ * Wire format is the enum member name (e.g. `"String"`, `"StringArray"`); the editor renders the
+ * value verbatim as the field-kind chip, so an unrecognised kind degrades to a label rather than
+ * a blank.
+ */
+type ConnectorCanonicalFieldKind = "String" | "Integer" | "Boolean" | "DateTime" | "Object" | "StringArray";
+/**
+ * A single canonical field on an operation's request or response schema. Carried on the mapping row
+ * so the editor can render an input per field without a separate schema fetch.
+ */
+interface ConnectorCanonicalField {
+    name: string;
+    kind: ConnectorCanonicalFieldKind;
+    isRequired: boolean;
+}
+/**
+ * Arguments the editor hands to the consumer-supplied `onTestMapping` callback. The consumer builds
+ * the full service request from these plus its own `connectorId` / `operationKey` / `toolName` — the
+ * editor owns no network call.
+ */
+interface TestToolMappingRequest {
+    /** Sample values the operator typed — one entry per canonical request field. */
+    sampleArgs: Record<string, unknown>;
+    /** Current unsaved request-field map (empty inputs stripped; `null` if all blank). */
+    requestFieldMap: Record<string, string> | null;
+    /** Current unsaved response-field paths (empty inputs stripped; `null` if all blank). */
+    responseFieldPaths: Record<string, string> | null;
+    /**
+     * Current unsaved static request parameters (blank-key rows dropped; `null` if none). Optional and
+     * backward-compatible: it lets the dry-run exercise the DRAFT static params — a consolidated
+     * tool's `method` discriminator, say — that the operator typed but has not saved yet. A consumer
+     * whose test endpoint does not accept static fields simply ignores it.
+     */
+    staticRequestFields?: Record<string, string> | null;
+}
+/**
+ * Result of extracting one canonical response field from the tool's raw response. Mirrors the
+ * backend `ExtractedFieldResult` DTO.
+ */
+interface TestToolMappingExtractedField {
+    canonicalField: string;
+    /** Extracted value, or `null` when the path matched nothing. */
+    value: string | null;
+    /** `true` when the JSON path resolved to a node in the response. */
+    present: boolean;
+    /**
+     * `true` when the extracted value looks like Base64 content (long string, charset
+     * `[A-Za-z0-9+/=]`, no whitespace). The editor shows a "prefix with base64:" hint so the operator
+     * adjusts the JSON path rather than concluding the mapping is broken.
+     */
+    looksBase64: boolean;
+}
+/** Result the consumer's `onTestMapping` callback resolves with, after the dry-run. */
+interface TestToolMappingResult {
+    success: boolean;
+    /** Error message when `success` is false. */
+    error: string | null;
+    /**
+     * Raw JSON string of the tool's response, shown in a collapsible so the operator can find the
+     * right JSON path.
+     */
+    rawResponseJson: string | null;
+    /** Per-field extraction result. */
+    extractedFields: TestToolMappingExtractedField[];
+}
+/**
+ * Result the consumer's `onSuggestTranslation` callback resolves with. When `success` is true, the
+ * editor merges the two dictionaries over its current inputs so the operator can review the
+ * AI proposal before saving.
+ */
+interface ConnectorMappingSuggestionResult {
+    success: boolean;
+    /** Error message when `success` is false. `null` when `success` is true. */
+    error: string | null;
+    /**
+     * Proposed canonical-request → tool-field-name rewrite. Empty object `{}` when the model found no
+     * request-side rewrites to apply.
+     */
+    requestFieldMap: Record<string, string>;
+    /**
+     * Proposed canonical-response → JSON-path rewrite (e.g. `{ "content": "base64:$.content" }`).
+     * Empty object `{}` when the model found no response-side rewrites.
+     */
+    responseFieldPaths: Record<string, string>;
+}
 
 interface MappingCompletenessBannerProps {
     /**
@@ -97,6 +184,116 @@ interface MappingCompletenessBannerProps {
  */
 declare function MappingCompletenessBanner({ operations, onSuggestWithAi, onOpenMappingEditor, suggestingOperationKey, disableSuggest, }: MappingCompletenessBannerProps): react.JSX.Element | null;
 
+interface ConnectorMappingTranslationEditorProps {
+    open: boolean;
+    /**
+     * Human-readable operation label for the dialog title (e.g. "Get File").
+     *
+     * Optional because it is derived from a looked-up operation that may not be found: every caller
+     * passes `string | undefined`. The contract claimed required while reality was optional, so this
+     * states the truth rather than changing any runtime value.
+     */
+    operationLabel?: string;
+    /**
+     * Tool name the mapping currently points at — shown in the dialog header for context.
+     *
+     * Optional and nullable because the editor opens for an operation that may not be mapped yet:
+     * every caller passes `string | null | undefined`.
+     */
+    toolName?: string | null;
+    /**
+     * Canonical request fields the editor renders one input per.
+     *
+     * Optional and nullable: an operation may declare no canonical schema, and the editor already
+     * gates on their presence. See the coalescing note in the component body — this is not cosmetic.
+     */
+    canonicalRequestFields?: ConnectorCanonicalField[] | null;
+    /** Canonical response fields the editor renders one JSON-path input per. Same nullability. */
+    canonicalResponseFields?: ConnectorCanonicalField[] | null;
+    /** Currently-persisted request-field translation, or `null` if the operator hasn't supplied one. */
+    requestFieldMap: Record<string, string> | null;
+    /** Currently-persisted response-field translation, or `null` if the operator hasn't supplied one. */
+    responseFieldPaths: Record<string, string> | null;
+    /**
+     * Currently-persisted static request parameters (tool field name → constant literal value), or
+     * `null` if the operator hasn't supplied any. Seeds the "Static request parameters" rows.
+     */
+    staticRequestFields: Record<string, string> | null;
+    /**
+     * Called with the operator's translation dictionaries when they click Save. Empty inputs are
+     * stripped before this fires; if every input on a side was blank, that side is delivered as `null`
+     * rather than `{}` so the consumer can pass it straight through and the BE writes a NULL column
+     * (which the resolver treats as "no operator override" and falls back to the connector's
+     * vendor-default translation). A populated dictionary means "rewrite these fields explicitly"; the
+     * BE persists it verbatim and the resolver applies it on top of vendor defaults.
+     *
+     * `staticRequestFields` carries the constant tool-request parameters (e.g. `{ method: "get" }`);
+     * same null-vs-populated semantics — `null` when every static row was left blank.
+     */
+    onSave: (requestFieldMap: Record<string, string> | null, responseFieldPaths: Record<string, string> | null, staticRequestFields: Record<string, string> | null) => void;
+    onCancel: () => void;
+    /**
+     * Optional. When provided, the editor renders a Test section below the field tables and a "Test
+     * mapping" button inside it. The consumer supplies this callback so the editor never owns a
+     * network call. Invoked with the sample args and the current (unsaved) field maps — stripped to
+     * `null` when every input is blank, matching `onSave`.
+     */
+    onTestMapping?: (request: TestToolMappingRequest) => Promise<TestToolMappingResult>;
+    /**
+     * Optional. When provided, the editor renders an "Auto-configure" button in the Test section. The
+     * consumer invokes the AI suggestion endpoint with the sample inputs the Test section collects,
+     * then returns the suggested field maps so the editor can populate the request / response inputs.
+     * The operator reviews and clicks Save.
+     *
+     * @param sampleArgs - Sample values the operator typed, one entry per canonical request field.
+     * @returns The suggestion result (success/error + proposed maps).
+     */
+    onSuggestTranslation?: (sampleArgs: Record<string, unknown>) => Promise<ConnectorMappingSuggestionResult>;
+}
+/**
+ * Per-mapping translation editor — surfaced when the operator picks a tool whose schema doesn't
+ * match the operation's canonical request/response field names. Renders two stacked tables
+ * (request / response): left column shows the canonical field's name + kind chip + required
+ * indicator; right column captures the operator-supplied tool field name (request side) or JSON
+ * path (response side).
+ *
+ * <p><b>Identity semantics.</b> An empty input on a field means "identity — pass the canonical name
+ * through unchanged". On Save the editor strips empty values; if every input on a side was blank,
+ * that side is delivered to `onSave` as <code>null</code> (not <code>{}</code>) so the BE writes a
+ * NULL column. The resolver then treats the NULL as "no operator override" and falls back to the
+ * connector's vendor-default translation; a populated dictionary means "rewrite these fields
+ * explicitly" and applies on top of the vendor default.</p>
+ *
+ * <p><b>State seeding.</b> The consumer page mounts/unmounts this dialog every time the editor opens
+ * (the `open` prop is always `true` in practice — the parent gates rendering via conditional mount),
+ * so local state initialises lazily from the props on each mount. This avoids the "setState in
+ * useEffect" pattern the eslint react-hooks ruleset blocks, AND keeps the operator's in-flight edits
+ * sovereign once the dialog is open — a concurrent refresh of the mapping row doesn't clobber what
+ * they're typing.</p>
+ *
+ * <p><b>Promoted, not designed here.</b> This file existed FOUR times — the host's gogo-ui adapter
+ * plus `self-healing`, `tech` and `timesheets` — and the copies had already drifted. Three
+ * differences were adjudicated on the way in, and each is a reason the duplication was expensive:</p>
+ *
+ * <ol>
+ *   <li><b>The Test button is gated on `onTestMapping`.</b> The enclosing block is gated on
+ *       <code>(onTestMapping || onSuggestTranslation)</code>, so without the inner guard a consumer
+ *       supplying only <code>onSuggestTranslation</code> rendered a "Test mapping" button whose
+ *       handler returns immediately — a DEAD CONTROL. `self-healing` shipped that; `tech` and
+ *       `timesheets` had fixed it. Nothing noticed, because there was no single source to notice
+ *       it against.</li>
+ *   <li><b>Backgrounds come from the theme (`action.hover`), never a hardcoded
+ *       <code>rgba()</code>.</b> A literal <code>rgba(0,0,0,0.03)</code> is invisible in dark mode
+ *       and is what `coreconnect/no-hardcoded-colors` exists to stop.</li>
+ *   <li><b>No emoji in chip labels.</b> The chips already carry an icon and a semantic colour, so
+ *       the emoji was a third, untranslatable, screen-reader-hostile encoding of the same state.</li>
+ * </ol>
+ *
+ * <p>The null tolerance below came from the HOST copy, which was the most hardened of the four.
+ * `coreconnect/no-local-mapping-editor` stops a fifth being written.</p>
+ */
+declare function ConnectorMappingTranslationEditorView({ open, operationLabel, toolName, canonicalRequestFields: canonicalRequestFieldsProp, canonicalResponseFields: canonicalResponseFieldsProp, requestFieldMap, responseFieldPaths, staticRequestFields, onSave, onCancel, onTestMapping, onSuggestTranslation, }: ConnectorMappingTranslationEditorProps): react.JSX.Element;
+
 /**
  * Every operation with a gap, required or optional. Use it to decide whether to mount a banner at
  * all, without duplicating the predicate.
@@ -174,4 +371,4 @@ declare function connectorMappingsQueryKey(connectorId: string | undefined, modu
  */
 declare function connectorMappingCompletenessQueryKey(connectorId: string | undefined, moduleKey: string): readonly ["connector-mappings", string | undefined, string, "completeness"];
 
-export { MappingCompletenessBanner, type MappingCompletenessBannerProps, type MappingCompletenessItem, type MappingCompletenessResult, type MappingReadiness, connectorMappingCompletenessQueryKey, connectorMappingsQueryKey, selectIncompleteOperations, selectMappingReadiness, selectOptionalIncompleteOperations, selectRequiredIncompleteOperations };
+export { type ConnectorCanonicalField, type ConnectorCanonicalFieldKind, type ConnectorMappingSuggestionResult, type ConnectorMappingTranslationEditorProps, ConnectorMappingTranslationEditorView, MappingCompletenessBanner, type MappingCompletenessBannerProps, type MappingCompletenessItem, type MappingCompletenessResult, type MappingReadiness, type TestToolMappingExtractedField, type TestToolMappingRequest, type TestToolMappingResult, connectorMappingCompletenessQueryKey, connectorMappingsQueryKey, selectIncompleteOperations, selectMappingReadiness, selectOptionalIncompleteOperations, selectRequiredIncompleteOperations };