@finsys/core 4.8.0 → 4.9.0

package/dist/index.d.cts

@@ -1534,8 +1534,18 @@ interface AdapterManifest {
      *     records the adapter runs itself; the manifest exists purely as
      *     the declaration plane (produces, cardinality,
      *     fieldAuthorizations) for data the host was already producing.
+     *   - `external-assertion` — SYS-3036 (ownership moved here from a
+     *     host-local extension): declaration-only adapter that is executed
+     *     entirely OUTSIDE the host. An externally-orchestrated process
+     *     completes its own ceremony/extraction and PUSHES the result to
+     *     the host's assertion-ingest surface. No code is loaded and
+     *     neither fetch() nor extract() ever runs — the same
+     *     declaration-only shape as `form-intake`/`manual-override`/
+     *     `extraction-pipeline`, but data arrives via an external push
+     *     rather than the host's own pipeline, form submission, or a
+     *     dynamic-imported/declarative extract() call.
      */
-    readonly implementation: DeclarativeImplementation | TypescriptImplementation | FormIntakeImplementation | ManualOverrideImplementation | ExtractionPipelineImplementation;
+    readonly implementation: DeclarativeImplementation | TypescriptImplementation | FormIntakeImplementation | ManualOverrideImplementation | ExtractionPipelineImplementation | ExternalAssertionImplementation;
     /**
      * SYS-2502: explicit instance cardinality.
      *
@@ -1671,6 +1681,17 @@ interface AdapterManifest {
      * never silent data drift. Clients (form-spec and eval-model
      * editors) read these sets through the registry-metadata surface to
      * offer the labels without hardcoding any vendor's vocabulary.
+     *
+     * Matching is EXACT-STRING — case and whitespace variations from a
+     * declared label are treated as distinct (and therefore out-of-set),
+     * deliberately. `uniqueItems` at the schema layer is likewise
+     * exact-match, so e.g. `["High", "high"]` is a legal (if unusual)
+     * two-label set; nothing here folds case or reconciles near-miss
+     * spelling. Silently normalizing would band-aid over a vendor-side
+     * inconsistency instead of surfacing it — a vendor emitting `"high"`
+     * when its manifest declares `"High"` is a vendor bug that should be
+     * refused loudly, not coerced into matching. Vendors own their exact
+     * label byte-for-byte; hosts never guess at reconciliation.
      */
     readonly enumValues?: Readonly<Record<CanonicalFieldName, ReadonlyArray<string>>>;
     /**
@@ -1789,6 +1810,64 @@ interface ManualOverrideImplementation {
 interface ExtractionPipelineImplementation {
     readonly type: "extraction-pipeline";
 }
+/**
+ * SYS-3036: declaration-only implementation for adapters that are
+ * executed entirely OUTSIDE the host application. An externally-
+ * orchestrated process (a partner-run ceremony, an out-of-band
+ * verification flow, etc.) completes its own extraction and PUSHES the
+ * result to the host's assertion-ingest surface, rather than the host
+ * pulling it via `fetch()`/`extract()` or a form submission. No code,
+ * no fetch(), no extract(); like `manual-override` and
+ * `extraction-pipeline`, the discriminator alone carries the meaning —
+ * the shape is intentionally empty beyond `type`.
+ *
+ * Ownership note: this type + its schema branch were previously a
+ * host-local extension (a runtime clone of the compiled schema with one
+ * extra `oneOf` branch bolted on) because core hadn't yet published the
+ * concept. Publishing it here means every host validates the SAME
+ * schema — no more per-host schema patches for this discriminator.
+ */
+interface ExternalAssertionImplementation {
+    readonly type: "external-assertion";
+}
+/**
+ * SYS-3036: how a registered adapter participates at execution time,
+ * derived purely from `implementation.type`. Published here (rather than
+ * re-derived per host) so every host classifies manifests identically:
+ *
+ *   - `Runnable` — the host loads (declarative) or dynamic-imports
+ *     (typescript) a `SourceAdapter`; the host's run loop executes it.
+ *   - `DeclarationOnly` — the manifest is pure declaration plane
+ *     (`form-intake`, `manual-override`, `extraction-pipeline`). No code
+ *     exists to load; the entry is registered so `list()`-style
+ *     consumers (field-authorization gating, provenance rendering,
+ *     diagnostics) see the manifest, and every execution path skips it.
+ *   - `ExternallyAsserted` — the manifest declares
+ *     `implementation.type: "external-assertion"`. Same "no code, host
+ *     never calls fetch()/extract()" shape as `DeclarationOnly`, but data
+ *     arrives via an external push rather than the host's own
+ *     extraction pipeline or form intake. Hosts that used to fork on
+ *     this case separately can safely fold it into the same "not
+ *     Runnable" branch that already skips `DeclarationOnly` entries.
+ *
+ * String values mirror the discriminators they classify so a logged
+ * `executionMode` reads naturally alongside `implementation.type`.
+ */
+declare enum AdapterExecutionMode {
+    Runnable = "runnable",
+    DeclarationOnly = "declaration-only",
+    ExternallyAsserted = "externally-asserted"
+}
+/**
+ * SYS-3036: classify a manifest's `implementation.type` into its
+ * `AdapterExecutionMode`. Exhaustive over every discriminator this
+ * version of `@finsys/core` publishes — the switch has an explicit case
+ * per type and THROWS on anything else (Ajv should already have refused
+ * an unrecognized discriminator at validation time, but a schema/host
+ * version skew must surface as a loud refusal here too, never as a
+ * silently-guessed mode; no fallback branch assigns one).
+ */
+declare function executionModeOf(manifest: Pick<AdapterManifest, "implementation">): AdapterExecutionMode;
 interface FieldMapEntry {
     /**
      * JSONPath expression into the raw payload. E.g.
@@ -1816,4 +1895,4 @@ interface FieldMapEntry {
     readonly transform?: "identity" | "pct_to_ratio01" | "to_boolean" | "to_integer";
 }
 
-export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type PeriodDeclaration, type PeriodValues, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoriesAttestingFact, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, factOf, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };
+export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, AdapterExecutionMode, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExternalAssertionImplementation, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type PeriodDeclaration, type PeriodValues, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoriesAttestingFact, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, executionModeOf, extractTimePeriods, factOf, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };

package/dist/index.d.ts

@@ -1534,8 +1534,18 @@ interface AdapterManifest {
      *     records the adapter runs itself; the manifest exists purely as
      *     the declaration plane (produces, cardinality,
      *     fieldAuthorizations) for data the host was already producing.
+     *   - `external-assertion` — SYS-3036 (ownership moved here from a
+     *     host-local extension): declaration-only adapter that is executed
+     *     entirely OUTSIDE the host. An externally-orchestrated process
+     *     completes its own ceremony/extraction and PUSHES the result to
+     *     the host's assertion-ingest surface. No code is loaded and
+     *     neither fetch() nor extract() ever runs — the same
+     *     declaration-only shape as `form-intake`/`manual-override`/
+     *     `extraction-pipeline`, but data arrives via an external push
+     *     rather than the host's own pipeline, form submission, or a
+     *     dynamic-imported/declarative extract() call.
      */
-    readonly implementation: DeclarativeImplementation | TypescriptImplementation | FormIntakeImplementation | ManualOverrideImplementation | ExtractionPipelineImplementation;
+    readonly implementation: DeclarativeImplementation | TypescriptImplementation | FormIntakeImplementation | ManualOverrideImplementation | ExtractionPipelineImplementation | ExternalAssertionImplementation;
     /**
      * SYS-2502: explicit instance cardinality.
      *
@@ -1671,6 +1681,17 @@ interface AdapterManifest {
      * never silent data drift. Clients (form-spec and eval-model
      * editors) read these sets through the registry-metadata surface to
      * offer the labels without hardcoding any vendor's vocabulary.
+     *
+     * Matching is EXACT-STRING — case and whitespace variations from a
+     * declared label are treated as distinct (and therefore out-of-set),
+     * deliberately. `uniqueItems` at the schema layer is likewise
+     * exact-match, so e.g. `["High", "high"]` is a legal (if unusual)
+     * two-label set; nothing here folds case or reconciles near-miss
+     * spelling. Silently normalizing would band-aid over a vendor-side
+     * inconsistency instead of surfacing it — a vendor emitting `"high"`
+     * when its manifest declares `"High"` is a vendor bug that should be
+     * refused loudly, not coerced into matching. Vendors own their exact
+     * label byte-for-byte; hosts never guess at reconciliation.
      */
     readonly enumValues?: Readonly<Record<CanonicalFieldName, ReadonlyArray<string>>>;
     /**
@@ -1789,6 +1810,64 @@ interface ManualOverrideImplementation {
 interface ExtractionPipelineImplementation {
     readonly type: "extraction-pipeline";
 }
+/**
+ * SYS-3036: declaration-only implementation for adapters that are
+ * executed entirely OUTSIDE the host application. An externally-
+ * orchestrated process (a partner-run ceremony, an out-of-band
+ * verification flow, etc.) completes its own extraction and PUSHES the
+ * result to the host's assertion-ingest surface, rather than the host
+ * pulling it via `fetch()`/`extract()` or a form submission. No code,
+ * no fetch(), no extract(); like `manual-override` and
+ * `extraction-pipeline`, the discriminator alone carries the meaning —
+ * the shape is intentionally empty beyond `type`.
+ *
+ * Ownership note: this type + its schema branch were previously a
+ * host-local extension (a runtime clone of the compiled schema with one
+ * extra `oneOf` branch bolted on) because core hadn't yet published the
+ * concept. Publishing it here means every host validates the SAME
+ * schema — no more per-host schema patches for this discriminator.
+ */
+interface ExternalAssertionImplementation {
+    readonly type: "external-assertion";
+}
+/**
+ * SYS-3036: how a registered adapter participates at execution time,
+ * derived purely from `implementation.type`. Published here (rather than
+ * re-derived per host) so every host classifies manifests identically:
+ *
+ *   - `Runnable` — the host loads (declarative) or dynamic-imports
+ *     (typescript) a `SourceAdapter`; the host's run loop executes it.
+ *   - `DeclarationOnly` — the manifest is pure declaration plane
+ *     (`form-intake`, `manual-override`, `extraction-pipeline`). No code
+ *     exists to load; the entry is registered so `list()`-style
+ *     consumers (field-authorization gating, provenance rendering,
+ *     diagnostics) see the manifest, and every execution path skips it.
+ *   - `ExternallyAsserted` — the manifest declares
+ *     `implementation.type: "external-assertion"`. Same "no code, host
+ *     never calls fetch()/extract()" shape as `DeclarationOnly`, but data
+ *     arrives via an external push rather than the host's own
+ *     extraction pipeline or form intake. Hosts that used to fork on
+ *     this case separately can safely fold it into the same "not
+ *     Runnable" branch that already skips `DeclarationOnly` entries.
+ *
+ * String values mirror the discriminators they classify so a logged
+ * `executionMode` reads naturally alongside `implementation.type`.
+ */
+declare enum AdapterExecutionMode {
+    Runnable = "runnable",
+    DeclarationOnly = "declaration-only",
+    ExternallyAsserted = "externally-asserted"
+}
+/**
+ * SYS-3036: classify a manifest's `implementation.type` into its
+ * `AdapterExecutionMode`. Exhaustive over every discriminator this
+ * version of `@finsys/core` publishes — the switch has an explicit case
+ * per type and THROWS on anything else (Ajv should already have refused
+ * an unrecognized discriminator at validation time, but a schema/host
+ * version skew must surface as a loud refusal here too, never as a
+ * silently-guessed mode; no fallback branch assigns one).
+ */
+declare function executionModeOf(manifest: Pick<AdapterManifest, "implementation">): AdapterExecutionMode;
 interface FieldMapEntry {
     /**
      * JSONPath expression into the raw payload. E.g.
@@ -1816,4 +1895,4 @@ interface FieldMapEntry {
     readonly transform?: "identity" | "pct_to_ratio01" | "to_boolean" | "to_integer";
 }
 
-export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type PeriodDeclaration, type PeriodValues, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoriesAttestingFact, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, extractTimePeriods, factOf, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };
+export { ADAPTER_CATEGORY_IDS, ALL_AGGREGATION_OPS, type AdapterCategory, AdapterError, type AdapterErrorReason, AdapterExecutionMode, type AdapterExtraction, type AdapterManifest, type AggregationOp, type ApplicantIdentity, BASE_FIELD_SPECS, BasicFormField, type CanonicalFieldName, type CanonicalFieldSpec, type CanonicalFieldValue, type CanonicalFieldValues, type Category, type CategorySchema, type CategorySpec, type Choice, DEFAULT_VALIDATOR_DEFINITIONS, type DeclarativeImplementation, type DocExtractionResult, DocExtractionStatus, type DocumentFileMetadata, type DocumentRow, type DocumentRowCapabilities, type DocumentTypeGroup, type DropdownOption, type EditorValidator, type ExternalAssertionImplementation, type ExtractionFileType, type ExtractionJobRecord, ExtractionJobStatus, type ExtractionPipelineImplementation, type ExtractionStatusResult, FIELD_TYPE_DEFINITIONS, type FieldAuthorization, type FieldData, type FieldGroup, type FieldMapEntry, type FieldReference, FieldType, type FileFieldTableData, type FileFieldTableItem, FileFieldTableType, FileFormField, FormField, FormFieldCategory, type FormFieldInputType, type FormFieldType, type FormFieldTypeDefinitions, FormFieldValidator, type FormIntakeFieldMapEntry, type FormIntakeImplementation, FormSpec, type FormValidatorDefinitions, IHS_FAILURE_STATUSES, IHS_FIELD_ORIGINS, IHS_TERMINAL_STATUSES, IHS_VALID_STATUSES, type IhsDetailCategory, type IhsFieldDetail, type IhsFieldOrigin, type IhsFieldProvenance, IhsStatus, IhsValueFormat, type InstanceRow, type InstanceValue, type ManualOverrideImplementation, type PageConfig, type PeriodDeclaration, type PeriodValues, type RHFSchemaOutput, type RHFStep, type RawPayload, type ResolvedField, Role, type SourceAdapter, type SurveyElementJSON, type SurveyJSON, type SurveyPageJSON, type TaggedFieldData, type TimePeriodUnit, type TypescriptImplementation, type UnifiedFormConfig, type Validator, type WireFormat, allCategories, applyAggregation, applyDynamicTitles, assertAdapterCategory, assertDocumentType, buildDocumentRows, buildFileFieldTables, buildFileFieldTablesFromInstances, categoriesAttestingFact, categoryFieldsOf, categoryForField, categorySchemaOf, evaluateExpression, executionModeOf, extractTimePeriods, factOf, formatDocumentSize, formatDocumentType, formatDocumentUploaded, generateRHFSchema, generateSurveyJson, getBaseCategories, getBaseFieldNames, getBaseFieldSpecMap, getBaseFieldSpecs, getCategoryName, getDisplayName, getDisplayNames, getDocDisplayNames, getDocumentTypeGroups, getExtractableDocTypes, getGroupDisplayNames, getPastMonthLabel, getPastYearLabel, getReuploadableDocTypes, getStepDefaultValues, getStepSchema, groupColumnsByInstance, groupColumnsByTimePeriod, groupDetailsByCategory, groupFieldsByCategory, groupFieldsByPattern, isAdapterCategory, isDocumentType, isFailureIhsStatus, isTerminalIhsStatus, isValidIhsFieldOrigin, isValidIhsStatus, parseFileField, processIhsDetails, resolveExtractionStatus, resolvePageFields, validateFormConfig, validateFormSpec, validatePagesConfig };

package/dist/index.js

@@ -11941,10 +11941,37 @@ function assertAdapterCategory(id) {
   }
   return id;
 }
+
+// src/adapter-manifest.ts
+var AdapterExecutionMode = /* @__PURE__ */ ((AdapterExecutionMode2) => {
+  AdapterExecutionMode2["Runnable"] = "runnable";
+  AdapterExecutionMode2["DeclarationOnly"] = "declaration-only";
+  AdapterExecutionMode2["ExternallyAsserted"] = "externally-asserted";
+  return AdapterExecutionMode2;
+})(AdapterExecutionMode || {});
+function executionModeOf(manifest) {
+  const implementationType = manifest.implementation.type;
+  switch (implementationType) {
+    case "declarative":
+    case "typescript":
+      return "runnable" /* Runnable */;
+    case "form-intake":
+    case "manual-override":
+    case "extraction-pipeline":
+      return "declaration-only" /* DeclarationOnly */;
+    case "external-assertion":
+      return "externally-asserted" /* ExternallyAsserted */;
+    default: {
+      const unhandled = implementationType;
+      throw new Error(`unknown adapter implementation type: ${String(unhandled)}`);
+    }
+  }
+}
 export {
   ADAPTER_CATEGORY_IDS,
   ALL_AGGREGATION_OPS,
   AdapterError,
+  AdapterExecutionMode,
   BASE_FIELD_SPECS,
   BasicFormField,
   DEFAULT_VALIDATOR_DEFINITIONS,
@@ -11978,6 +12005,7 @@ export {
   categoryForField,
   categorySchemaOf,
   evaluateExpression,
+  executionModeOf,
   extractTimePeriods,
   factOf,
   formatDocumentSize,