phenoml 17.3.0 → 17.5.0

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "phenoml",
-        "X-Fern-SDK-Version": "17.3.0",
-        "User-Agent": "phenoml/17.3.0",
+        "X-Fern-SDK-Version": "17.5.0",
+        "User-Agent": "phenoml/17.5.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/fhir2Omop/client/Client.d.ts

@@ -22,12 +22,15 @@ export declare class Fhir2OmopClient {
      * into a row), `vocab_version` (the OMOP vocabulary release codes were
      * resolved against), and a small `summary` of the resolution outcomes.
      *
-     * A `concept_id` of `0` means "no matching standard concept" (OMOP
-     * semantics) and is reported, not omitted — a coding with no match is
-     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * A `concept_id` of `0` is reported, not omitted (OMOP "no matching
+     * concept" semantics): it covers both a coding with no standard match
+     * (`UNMAPPED`) and an unverified suggestion for a text-only resource
+     * (`UNCHECKED`). Only the primary clinical coding is resolved, so
      * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
-     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
+     * always `0`; the one populated non-resolved concept is measurement
+     * `operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)
+     * rather than the resolver. Each `*_source_value` carries the verbatim FHIR
+     * coding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,

package/dist/cjs/api/resources/fhir2Omop/client/Client.js

@@ -67,12 +67,15 @@ class Fhir2OmopClient {
      * into a row), `vocab_version` (the OMOP vocabulary release codes were
      * resolved against), and a small `summary` of the resolution outcomes.
      *
-     * A `concept_id` of `0` means "no matching standard concept" (OMOP
-     * semantics) and is reported, not omitted — a coding with no match is
-     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * A `concept_id` of `0` is reported, not omitted (OMOP "no matching
+     * concept" semantics): it covers both a coding with no standard match
+     * (`UNMAPPED`) and an unverified suggestion for a text-only resource
+     * (`UNCHECKED`). Only the primary clinical coding is resolved, so
      * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
-     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
+     * always `0`; the one populated non-resolved concept is measurement
+     * `operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)
+     * rather than the resolver. Each `*_source_value` carries the verbatim FHIR
+     * coding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,

package/dist/cjs/api/resources/fhir2Omop/types/ConditionOccurrenceRow.d.ts

@@ -6,6 +6,7 @@ export interface ConditionOccurrenceRow {
     condition_start_datetime?: string | undefined;
     condition_end_date?: string | undefined;
     condition_type_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     condition_source_value?: string | undefined;
     condition_source_concept_id?: number | undefined;
     condition_status_source_value?: string | undefined;

package/dist/cjs/api/resources/fhir2Omop/types/DrugExposureRow.d.ts

@@ -8,6 +8,7 @@ export interface DrugExposureRow {
     drug_type_concept_id?: number | undefined;
     stop_reason?: string | undefined;
     sig?: string | undefined;
+    visit_occurrence_id?: number | undefined;
     drug_source_value?: string | undefined;
     drug_source_concept_id?: number | undefined;
 }

package/dist/cjs/api/resources/fhir2Omop/types/MappingEntry.d.ts

@@ -16,12 +16,10 @@ export interface MappingEntry {
     source_name?: string | undefined;
     target_vocabulary?: string | undefined;
     /**
-     * The standard concept's code, when present. Populated only for an
-     * `UNCHECKED` suggestion (where the API normalized a text-only resource
-     * to a suggested code); omitted for codings resolved through concept
-     * resolution (`ALREADY_STANDARD` / `MAPPED` / `UNMAPPED`), which are
-     * identified by `target_vocabulary`, `target_name`, and the row's
-     * `*_concept_id` rather than by code.
+     * The standard concept's own code: the source code itself for an
+     * ALREADY_STANDARD row, the standard concept's code for a MAPPED row,
+     * or the suggested code for an UNCHECKED row. Omitted for UNMAPPED
+     * rows.
      */
     target_code?: string | undefined;
     target_name?: string | undefined;

package/dist/cjs/api/resources/fhir2Omop/types/MeasurementRow.d.ts

@@ -6,10 +6,13 @@ export interface MeasurementRow {
     measurement_datetime?: string | undefined;
     measurement_type_concept_id?: number | undefined;
     value_as_number?: number | undefined;
+    /** OMOP "Meas Value Operator" standard concept qualifying value_as_number (<, <=, >, >=), parsed from a numeric-string value or a FHIR valueQuantity.comparator. 0 when no operator (a bare number). */
+    operator_concept_id?: number | undefined;
     value_as_concept_id?: number | undefined;
     unit_concept_id?: number | undefined;
     range_low?: number | undefined;
     range_high?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     measurement_source_value?: string | undefined;
     measurement_source_concept_id?: number | undefined;
     unit_source_value?: string | undefined;

package/dist/cjs/api/resources/fhir2Omop/types/ObservationRow.d.ts

@@ -9,6 +9,7 @@ export interface ObservationRow {
     value_as_string?: string | undefined;
     value_as_concept_id?: number | undefined;
     unit_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     observation_source_value?: string | undefined;
     observation_source_concept_id?: number | undefined;
     unit_source_value?: string | undefined;

package/dist/cjs/api/resources/fhir2Omop/types/ProcedureOccurrenceRow.d.ts

@@ -5,6 +5,7 @@ export interface ProcedureOccurrenceRow {
     procedure_date?: string | undefined;
     procedure_datetime?: string | undefined;
     procedure_type_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     procedure_source_value?: string | undefined;
     procedure_source_concept_id?: number | undefined;
 }

package/dist/cjs/api/resources/fhir2Omop/types/Summary.d.ts

@@ -1,14 +1,16 @@
 /**
  * The request's data-quality headline: how the coded concepts split across
  * resolution outcomes, and the share that was not already in a target
- * standard vocabulary.
+ * standard vocabulary. Each coded resource is counted once (per resolved
+ * concept), even when it carried several codings — unlike `mappings`, which
+ * has one entry per coding.
  */
 export interface Summary {
-    /** Codings already a standard OMOP concept. */
+    /** Coded concepts already a standard OMOP concept (ALREADY_STANDARD). */
     codes_already_standard?: number | undefined;
-    /** Codings mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
+    /** Coded concepts mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
     codes_normalized?: number | undefined;
-    /** Codings with no standard concept found. */
+    /** Coded concepts with no standard concept found (UNMAPPED). */
     codes_unmapped?: number | undefined;
     /** Share of coded concepts not already standard ((normalized + unmapped) / total). */
     off_vocab_rate?: number | undefined;

package/dist/cjs/api/resources/fhirProvider/types/Provider.d.ts

@@ -5,6 +5,7 @@
  * It is used on shared instances.
  */
 export declare const Provider: {
+    readonly Aidbox: "aidbox";
     readonly Athenahealth: "athenahealth";
     readonly Canvas: "canvas";
     readonly Cerner: "cerner";

package/dist/cjs/api/resources/fhirProvider/types/Provider.js

@@ -9,6 +9,7 @@ exports.Provider = void 0;
  * It is used on shared instances.
  */
 exports.Provider = {
+    Aidbox: "aidbox",
     Athenahealth: "athenahealth",
     Canvas: "canvas",
     Cerner: "cerner",

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "17.3.0";
+export declare const SDK_VERSION = "17.5.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "17.3.0";
+exports.SDK_VERSION = "17.5.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "phenoml",
-        "X-Fern-SDK-Version": "17.3.0",
-        "User-Agent": "phenoml/17.3.0",
+        "X-Fern-SDK-Version": "17.5.0",
+        "User-Agent": "phenoml/17.5.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/fhir2Omop/client/Client.d.mts

@@ -22,12 +22,15 @@ export declare class Fhir2OmopClient {
      * into a row), `vocab_version` (the OMOP vocabulary release codes were
      * resolved against), and a small `summary` of the resolution outcomes.
      *
-     * A `concept_id` of `0` means "no matching standard concept" (OMOP
-     * semantics) and is reported, not omitted — a coding with no match is
-     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * A `concept_id` of `0` is reported, not omitted (OMOP "no matching
+     * concept" semantics): it covers both a coding with no standard match
+     * (`UNMAPPED`) and an unverified suggestion for a text-only resource
+     * (`UNCHECKED`). Only the primary clinical coding is resolved, so
      * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
-     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
+     * always `0`; the one populated non-resolved concept is measurement
+     * `operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)
+     * rather than the resolver. Each `*_source_value` carries the verbatim FHIR
+     * coding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,

package/dist/esm/api/resources/fhir2Omop/client/Client.mjs

@@ -31,12 +31,15 @@ export class Fhir2OmopClient {
      * into a row), `vocab_version` (the OMOP vocabulary release codes were
      * resolved against), and a small `summary` of the resolution outcomes.
      *
-     * A `concept_id` of `0` means "no matching standard concept" (OMOP
-     * semantics) and is reported, not omitted — a coding with no match is
-     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * A `concept_id` of `0` is reported, not omitted (OMOP "no matching
+     * concept" semantics): it covers both a coding with no standard match
+     * (`UNMAPPED`) and an unverified suggestion for a text-only resource
+     * (`UNCHECKED`). Only the primary clinical coding is resolved, so
      * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
-     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
+     * always `0`; the one populated non-resolved concept is measurement
+     * `operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)
+     * rather than the resolver. Each `*_source_value` carries the verbatim FHIR
+     * coding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,

package/dist/esm/api/resources/fhir2Omop/types/ConditionOccurrenceRow.d.mts

@@ -6,6 +6,7 @@ export interface ConditionOccurrenceRow {
     condition_start_datetime?: string | undefined;
     condition_end_date?: string | undefined;
     condition_type_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     condition_source_value?: string | undefined;
     condition_source_concept_id?: number | undefined;
     condition_status_source_value?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/DrugExposureRow.d.mts

@@ -8,6 +8,7 @@ export interface DrugExposureRow {
     drug_type_concept_id?: number | undefined;
     stop_reason?: string | undefined;
     sig?: string | undefined;
+    visit_occurrence_id?: number | undefined;
     drug_source_value?: string | undefined;
     drug_source_concept_id?: number | undefined;
 }

package/dist/esm/api/resources/fhir2Omop/types/MappingEntry.d.mts

@@ -16,12 +16,10 @@ export interface MappingEntry {
     source_name?: string | undefined;
     target_vocabulary?: string | undefined;
     /**
-     * The standard concept's code, when present. Populated only for an
-     * `UNCHECKED` suggestion (where the API normalized a text-only resource
-     * to a suggested code); omitted for codings resolved through concept
-     * resolution (`ALREADY_STANDARD` / `MAPPED` / `UNMAPPED`), which are
-     * identified by `target_vocabulary`, `target_name`, and the row's
-     * `*_concept_id` rather than by code.
+     * The standard concept's own code: the source code itself for an
+     * ALREADY_STANDARD row, the standard concept's code for a MAPPED row,
+     * or the suggested code for an UNCHECKED row. Omitted for UNMAPPED
+     * rows.
      */
     target_code?: string | undefined;
     target_name?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/MeasurementRow.d.mts

@@ -6,10 +6,13 @@ export interface MeasurementRow {
     measurement_datetime?: string | undefined;
     measurement_type_concept_id?: number | undefined;
     value_as_number?: number | undefined;
+    /** OMOP "Meas Value Operator" standard concept qualifying value_as_number (<, <=, >, >=), parsed from a numeric-string value or a FHIR valueQuantity.comparator. 0 when no operator (a bare number). */
+    operator_concept_id?: number | undefined;
     value_as_concept_id?: number | undefined;
     unit_concept_id?: number | undefined;
     range_low?: number | undefined;
     range_high?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     measurement_source_value?: string | undefined;
     measurement_source_concept_id?: number | undefined;
     unit_source_value?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/ObservationRow.d.mts

@@ -9,6 +9,7 @@ export interface ObservationRow {
     value_as_string?: string | undefined;
     value_as_concept_id?: number | undefined;
     unit_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     observation_source_value?: string | undefined;
     observation_source_concept_id?: number | undefined;
     unit_source_value?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/ProcedureOccurrenceRow.d.mts

@@ -5,6 +5,7 @@ export interface ProcedureOccurrenceRow {
     procedure_date?: string | undefined;
     procedure_datetime?: string | undefined;
     procedure_type_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     procedure_source_value?: string | undefined;
     procedure_source_concept_id?: number | undefined;
 }

package/dist/esm/api/resources/fhir2Omop/types/Summary.d.mts

@@ -1,14 +1,16 @@
 /**
  * The request's data-quality headline: how the coded concepts split across
  * resolution outcomes, and the share that was not already in a target
- * standard vocabulary.
+ * standard vocabulary. Each coded resource is counted once (per resolved
+ * concept), even when it carried several codings — unlike `mappings`, which
+ * has one entry per coding.
  */
 export interface Summary {
-    /** Codings already a standard OMOP concept. */
+    /** Coded concepts already a standard OMOP concept (ALREADY_STANDARD). */
     codes_already_standard?: number | undefined;
-    /** Codings mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
+    /** Coded concepts mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
     codes_normalized?: number | undefined;
-    /** Codings with no standard concept found. */
+    /** Coded concepts with no standard concept found (UNMAPPED). */
     codes_unmapped?: number | undefined;
     /** Share of coded concepts not already standard ((normalized + unmapped) / total). */
     off_vocab_rate?: number | undefined;

package/dist/esm/api/resources/fhirProvider/types/Provider.d.mts

@@ -5,6 +5,7 @@
  * It is used on shared instances.
  */
 export declare const Provider: {
+    readonly Aidbox: "aidbox";
     readonly Athenahealth: "athenahealth";
     readonly Canvas: "canvas";
     readonly Cerner: "cerner";

package/dist/esm/api/resources/fhirProvider/types/Provider.mjs

@@ -6,6 +6,7 @@
  * It is used on shared instances.
  */
 export const Provider = {
+    Aidbox: "aidbox",
     Athenahealth: "athenahealth",
     Canvas: "canvas",
     Cerner: "cerner",

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "17.3.0";
+export declare const SDK_VERSION = "17.5.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "17.3.0";
+export const SDK_VERSION = "17.5.0";

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Phenoml API",
-    "version": "5084e3096e5bd89bf2e86ea44d96e3407f6f5c6b"
+    "version": "64f369254225bd6c2d4c58d87f59165d7e8e8dc9"
   },
   "x-services": [
     {
@@ -3021,7 +3021,7 @@
       "post": {
         "operationId": "fhir2omop_create",
         "summary": "Map FHIR resources to OMOP CDM v5.4",
-        "description": "Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows\n(person, visit_occurrence, condition_occurrence, drug_exposure,\nprocedure_occurrence, measurement, observation).\n\nEach resource's primary clinical coding is resolved to a standard OMOP\n`concept_id`. Alongside the OMOP rows grouped by table (`tables`), the\nresponse carries `mappings` (how each source coding resolved, linked back\nto the row it produced), `dropped` (resources that could not be shaped\ninto a row), `vocab_version` (the OMOP vocabulary release codes were\nresolved against), and a small `summary` of the resolution outcomes.\n\nA `concept_id` of `0` means \"no matching standard concept\" (OMOP\nsemantics) and is reported, not omitted \u2014 a coding with no match is\n`UNMAPPED`. Only the primary clinical coding is resolved;\n`gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are\nalways `0`. Each `*_source_value` carries the verbatim FHIR coding\n(`system#code`), and `*_type_concept_id` is set to `32817` (EHR).\n\nMedication codes are resolved whether they appear inline\n(`medicationCodeableConcept`) or via a `medicationReference` to a contained,\nrelative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.\nResources that cannot be shaped into a row \u2014 a medication with no usable\ncode, resolvable reference, or display, or any clinical resource whose\nsubject/patient reference cannot be tied to a person \u2014 are reported under\n`dropped` rather than emitted as blank rows. The\nbundle must contain at least one Patient resource.\n",
+        "description": "Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows\n(person, visit_occurrence, condition_occurrence, drug_exposure,\nprocedure_occurrence, measurement, observation).\n\nEach resource's primary clinical coding is resolved to a standard OMOP\n`concept_id`. Alongside the OMOP rows grouped by table (`tables`), the\nresponse carries `mappings` (how each source coding resolved, linked back\nto the row it produced), `dropped` (resources that could not be shaped\ninto a row), `vocab_version` (the OMOP vocabulary release codes were\nresolved against), and a small `summary` of the resolution outcomes.\n\nA `concept_id` of `0` is reported, not omitted (OMOP \"no matching\nconcept\" semantics): it covers both a coding with no standard match\n(`UNMAPPED`) and an unverified suggestion for a text-only resource\n(`UNCHECKED`). Only the primary clinical coding is resolved, so\n`gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are\nalways `0`; the one populated non-resolved concept is measurement\n`operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)\nrather than the resolver. Each `*_source_value` carries the verbatim FHIR\ncoding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).\n\nMedication codes are resolved whether they appear inline\n(`medicationCodeableConcept`) or via a `medicationReference` to a contained,\nrelative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.\nResources that cannot be shaped into a row \u2014 a medication with no usable\ncode, resolvable reference, or display, or any clinical resource whose\nsubject/patient reference cannot be tied to a person \u2014 are reported under\n`dropped` rather than emitted as blank rows. The\nbundle must contain at least one Patient resource.\n",
         "requestBody": {
           "required": true,
           "content": {
@@ -3113,7 +3113,7 @@
                 "examples": {
                   "mapping_result": {
                     "summary": "Mapping result",
-                    "description": "The example bundle mapped to OMOP. Both source codes are already\nstandard, so each clinical row carries its own OMOP `concept_id`\nwith `ALREADY_STANDARD` status. `target_code` is omitted for a\nresolved concept \u2014 it is identified by `target_vocabulary` and\n`target_name` (and the row's `*_concept_id`). Illustrative\n`concept_id` values.\n",
+                    "description": "The example bundle mapped to OMOP. Both source codes are already\nstandard, so each clinical row carries its own OMOP `concept_id`\nwith `ALREADY_STANDARD` status and a `target_code` equal to the\nsource code. Illustrative `concept_id` values.\n",
                     "value": {
                       "success": true,
                       "message": "FHIR resources mapped to OMOP CDM v5.4",
@@ -3167,6 +3167,7 @@
                           "source_code": "44054006",
                           "source_name": "Type 2 diabetes mellitus",
                           "target_vocabulary": "SNOMED",
+                          "target_code": "44054006",
                           "target_name": "Type 2 diabetes mellitus",
                           "mapping_status": "ALREADY_STANDARD"
                         },
@@ -3179,6 +3180,7 @@
                           "source_code": "860975",
                           "source_name": "metformin hydrochloride 500 MG",
                           "target_vocabulary": "RXNORM",
+                          "target_code": "860975",
                           "target_name": "metformin hydrochloride 500 MG",
                           "mapping_status": "ALREADY_STANDARD"
                         }
@@ -8738,6 +8740,10 @@
             "type": "integer",
             "format": "int64"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "condition_source_value": {
             "type": "string"
           },
@@ -8784,6 +8790,10 @@
           "sig": {
             "type": "string"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "drug_source_value": {
             "type": "string"
           },
@@ -8818,6 +8828,10 @@
             "type": "integer",
             "format": "int64"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "procedure_source_value": {
             "type": "string"
           },
@@ -8856,6 +8870,11 @@
             "type": "number",
             "format": "double"
           },
+          "operator_concept_id": {
+            "type": "integer",
+            "format": "int64",
+            "description": "OMOP \"Meas Value Operator\" standard concept qualifying value_as_number (<, <=, >, >=), parsed from a numeric-string value or a FHIR valueQuantity.comparator. 0 when no operator (a bare number)."
+          },
           "value_as_concept_id": {
             "type": "integer",
             "format": "int64"
@@ -8872,6 +8891,10 @@
             "type": "number",
             "format": "double"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "measurement_source_value": {
             "type": "string"
           },
@@ -8927,6 +8950,10 @@
             "type": "integer",
             "format": "int64"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "observation_source_value": {
             "type": "string"
           },
@@ -8974,7 +9001,7 @@
           },
           "target_code": {
             "type": "string",
-            "description": "The standard concept's code, when present. Populated only for an\n`UNCHECKED` suggestion (where the API normalized a text-only resource\nto a suggested code); omitted for codings resolved through concept\nresolution (`ALREADY_STANDARD` / `MAPPED` / `UNMAPPED`), which are\nidentified by `target_vocabulary`, `target_name`, and the row's\n`*_concept_id` rather than by code.\n"
+            "description": "The standard concept's own code: the source code itself for an\nALREADY_STANDARD row, the standard concept's code for a MAPPED row,\nor the suggested code for an UNCHECKED row. Omitted for UNMAPPED\nrows.\n"
           },
           "target_name": {
             "type": "string"
@@ -8990,19 +9017,19 @@
       },
       "fhir2omop_Summary": {
         "type": "object",
-        "description": "The request's data-quality headline: how the coded concepts split across\nresolution outcomes, and the share that was not already in a target\nstandard vocabulary.\n",
+        "description": "The request's data-quality headline: how the coded concepts split across\nresolution outcomes, and the share that was not already in a target\nstandard vocabulary. Each coded resource is counted once (per resolved\nconcept), even when it carried several codings \u2014 unlike `mappings`, which\nhas one entry per coding.\n",
         "properties": {
           "codes_already_standard": {
             "type": "integer",
-            "description": "Codings already a standard OMOP concept."
+            "description": "Coded concepts already a standard OMOP concept (ALREADY_STANDARD)."
           },
           "codes_normalized": {
             "type": "integer",
-            "description": "Codings mapped or suggested to a standard concept (MAPPED or UNCHECKED)."
+            "description": "Coded concepts mapped or suggested to a standard concept (MAPPED or UNCHECKED)."
           },
           "codes_unmapped": {
             "type": "integer",
-            "description": "Codings with no standard concept found."
+            "description": "Coded concepts with no standard concept found (UNMAPPED)."
           },
           "off_vocab_rate": {
             "type": "number",
@@ -9296,6 +9323,7 @@
         "type": "string",
         "description": "Type of FHIR server provider.\n\nThe \"sandbox\" provider type is managed internally and cannot be created via API.\nIt is used on shared instances.\n",
         "enum": [
+          "aidbox",
           "athenahealth",
           "canvas",
           "cerner",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "phenoml",
-    "version": "17.3.0",
+    "version": "17.5.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -2684,12 +2684,15 @@ to the row it produced), `dropped` (resources that could not be shaped
 into a row), `vocab_version` (the OMOP vocabulary release codes were
 resolved against), and a small `summary` of the resolution outcomes.
 
-A `concept_id` of `0` means "no matching standard concept" (OMOP
-semantics) and is reported, not omitted — a coding with no match is
-`UNMAPPED`. Only the primary clinical coding is resolved;
+A `concept_id` of `0` is reported, not omitted (OMOP "no matching
+concept" semantics): it covers both a coding with no standard match
+(`UNMAPPED`) and an unverified suggestion for a text-only resource
+(`UNCHECKED`). Only the primary clinical coding is resolved, so
 `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
-always `0`. Each `*_source_value` carries the verbatim FHIR coding
-(`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
+always `0`; the one populated non-resolved concept is measurement
+`operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)
+rather than the resolver. Each `*_source_value` carries the verbatim FHIR
+coding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
 
 Medication codes are resolved whether they appear inline
 (`medicationCodeableConcept`) or via a `medicationReference` to a contained,