@clinia/context-engine-js 0.7.0-rc.3 → 0.7.0-rc.5

package/dist/generated/context-engine.d.ts

@@ -691,13 +691,7 @@ export interface components {
             data: {
                 /** @description Caller-assigned identifier used in all REST API routes. */
                 registryKey: string;
-                /** @description Demographic data extracted from the ingested record. Null if no patient resource was found during ingestion. */
-                patient: {
-                    /** @description Internal patient ID extracted from the ingested record (e.g., FHIR Patient.id). Used in VFS paths. */
-                    id: string;
-                    /** @description Patient display name extracted from the ingested record. */
-                    name: string;
-                } | null;
+                patient: components["schemas"]["PatientDemographics"];
             }[];
             /** @description Pagination metadata for the returned page. */
             meta: {
@@ -709,6 +703,13 @@ export interface components {
                 perPage: number;
             };
         };
+        /** @description Demographic data extracted from the ingested record. Null if no patient resource was found during ingestion. */
+        PatientDemographics: {
+            /** @description Internal patient ID extracted from the ingested record (e.g., FHIR Patient.id). Used in VFS paths. */
+            id: string;
+            /** @description Patient display name extracted from the ingested record. */
+            name: string;
+        } | null;
         /** @description Demographic metadata and pipeline stats for a single patient. */
         PatientDetail: {
             /** @description Internal patient ID extracted from the ingested record. Used in VFS paths. */
@@ -1086,8 +1087,13 @@ export interface components {
             content: string;
         };
         /** @description A node in the patient context graph. */
-        Node: {
-            /** @enum {string} */
+        Node: components["schemas"]["ExtractedFactNode"] | components["schemas"]["FactNode"] | components["schemas"]["ExtractedNarrativeNode"] | components["schemas"]["NarrativePassageNode"] | components["schemas"]["NarrativeNode"] | components["schemas"]["LearnedMemoryNode"] | components["schemas"]["ExtractedClinicalEventNode"];
+        /** @description An `extracted_fact` node in the patient context graph. */
+        ExtractedFactNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "extracted_fact";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -1095,7 +1101,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `extracted_fact` node. */
+            /** @description Type-specific attributes of an `extracted_fact` node. */
             payload: {
                 /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
                 display: string;
@@ -1557,8 +1563,13 @@ export interface components {
                 /** @description The ingestion request that introduced this row. */
                 ingestionId: string;
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description A `fact` node in the patient context graph. */
+        FactNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "fact";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -1566,7 +1577,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `fact` node. */
+            /** @description Type-specific attributes of a `fact` node. */
             payload: {
                 /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
                 display: string;
@@ -1908,8 +1919,33 @@ export interface components {
                 }[];
                 fieldVerdicts: components["schemas"]["FactConflicts"];
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description One verdict per field decided across the members, keyed by the field it settled. A field every member agreed on still carries a verdict, with an empty `conflict`. */
+        FactConflicts: {
+            [key: string]: {
+                picked: components["schemas"]["ScoredFactMember"];
+                /** @description Members that carried the same value as the picked one. */
+                agreed: components["schemas"]["ScoredFactMember"][];
+                /** @description Members that carried a different value. */
+                conflict: (components["schemas"]["ScoredFactMember"] & {
+                    /** @description The value this member lost the field with — null when it carried nothing. Untyped: its type is the field's own. */
+                    value?: unknown;
+                })[];
+            };
+        };
+        /** @description One member of a fact's cluster, as a field's verdict names it. */
+        ScoredFactMember: {
+            /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
+            extractedFactId: string;
+            /** @description Score this member was ranked with when the field was decided. */
+            score: number;
+        };
+        /** @description An `extracted_narrative` node in the patient context graph. */
+        ExtractedNarrativeNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "extracted_narrative";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -1917,7 +1953,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `extracted_narrative` node. */
+            /** @description Type-specific attributes of an `extracted_narrative` node. */
             payload: {
                 /** @description Deterministic human-readable label from the source, or null when the source provides none. */
                 summary: string | null;
@@ -1948,8 +1984,13 @@ export interface components {
                 /** @description The ingestion request that introduced this row. */
                 ingestionId: string;
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description A `narrative_passage` node in the patient context graph. */
+        NarrativePassageNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "narrative_passage";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -1957,7 +1998,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `narrative_passage` node. */
+            /** @description Type-specific attributes of a `narrative_passage` node. */
             payload: {
                 /** @description Id of the `extracted_narrative` node this passage was rendered from (`en_...`). */
                 extractedNarrativeId: string;
@@ -1970,8 +2011,13 @@ export interface components {
                 /** @description End offset (exclusive) within its extracted narrative's rendered content. */
                 offsetEnd: number;
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description A `narrative` node in the patient context graph. */
+        NarrativeNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "narrative";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -1979,7 +2025,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `narrative` node. */
+            /** @description Type-specific attributes of a `narrative` node. */
             payload: {
                 /** @description Latest defined member clinical time, or null when no member carries one. */
                 effectiveAt: string | null;
@@ -2017,8 +2063,13 @@ export interface components {
                 /** @description Clinical-event types this narrative plausibly concerns. */
                 boundEventTypes: ("encounter" | "observation" | "procedure" | "medication_event")[];
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description A `learned_memory` node in the patient context graph. */
+        LearnedMemoryNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "learned_memory";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -2026,7 +2077,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `learned_memory` node. */
+            /** @description Type-specific attributes of a `learned_memory` node. */
             payload: {
                 /**
                  * @description The memory taxonomy — symptom | adherence | concern | preference.
@@ -2038,8 +2089,13 @@ export interface components {
                 /** @description Provenance: the id of the session that produced this memory. */
                 sessionId: string;
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description An `extracted_clinical_event` node in the patient context graph. */
+        ExtractedClinicalEventNode: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "extracted_clinical_event";
             /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
             id: string;
@@ -2047,7 +2103,7 @@ export interface components {
             createdAt: string;
             /** @description ISO 8601 timestamp when this node was last updated. */
             updatedAt: string;
-            /** @description Type-specific attributes of the `extracted_clinical_event` node. */
+            /** @description Type-specific attributes of an `extracted_clinical_event` node. */
             payload: {
                 /** @enum {string} */
                 type: "encounter";
@@ -2259,26 +2315,6 @@ export interface components {
                 };
             };
         };
-        /** @description One verdict per field decided across the members, keyed by the field it settled. A field every member agreed on still carries a verdict, with an empty `conflict`. */
-        FactConflicts: {
-            [key: string]: {
-                picked: components["schemas"]["ScoredFactMember"];
-                /** @description Members that carried the same value as the picked one. */
-                agreed: components["schemas"]["ScoredFactMember"][];
-                /** @description Members that carried a different value. */
-                conflict: (components["schemas"]["ScoredFactMember"] & {
-                    /** @description The value this member lost the field with — null when it carried nothing. Untyped: its type is the field's own. */
-                    value?: unknown;
-                })[];
-            };
-        };
-        /** @description One member of a fact's cluster, as a field's verdict names it. */
-        ScoredFactMember: {
-            /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-            extractedFactId: string;
-            /** @description Score this member was ranked with when the field was decided. */
-            score: number;
-        };
         /** @description A page of nodes of one type from the patient context graph. */
         NodeList: {
             /** @description The requested page of items. */
@@ -2294,8 +2330,13 @@ export interface components {
             };
         };
         /** @description An edge in the patient context graph. */
-        Edge: {
-            /** @enum {string} */
+        Edge: components["schemas"]["ResolutionDecisionEdge"] | components["schemas"]["ResolvesToEdge"] | components["schemas"]["ChunkedIntoEdge"] | components["schemas"]["RelationshipEdge"];
+        /** @description A `resolution_decision` edge in the patient context graph. */
+        ResolutionDecisionEdge: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "resolution_decision";
             /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
             id: string;
@@ -2305,7 +2346,7 @@ export interface components {
             updatedAt: string;
             from: components["schemas"]["NodeRef"];
             to: components["schemas"]["NodeRef"] & unknown;
-            /** @description Type-specific attributes of the `resolution_decision` edge. */
+            /** @description Type-specific attributes of a `resolution_decision` edge. */
             payload: {
                 /**
                  * @description The decided outcome. `continue` is a control-flow signal for stop rules and is never recorded here.
@@ -2364,6 +2405,99 @@ export interface components {
                     codeA: string;
                     /** @description The code from entity B. */
                     codeB: string;
+                } | {
+                    /** @enum {string} */
+                    layer: "concept-identity";
+                    a: {
+                        /** @description The best candidate's base-ingredient concept ids — more than one for a combination product. */
+                        conceptIds: string[];
+                        /** @description The best candidate's salt/ester-grain concept ids. Empty when the match carries no precise grain. */
+                        preciseConceptIds: string[];
+                        /**
+                         * @description The cascade rung that grounded this side.
+                         * @enum {string}
+                         */
+                        rung: "code" | "crosswalk" | "exact-name" | "normalized-name";
+                        score: number;
+                        compositionId: string;
+                    };
+                    b: {
+                        /** @description The best candidate's base-ingredient concept ids — more than one for a combination product. */
+                        conceptIds: string[];
+                        /** @description The best candidate's salt/ester-grain concept ids. Empty when the match carries no precise grain. */
+                        preciseConceptIds: string[];
+                        /**
+                         * @description The cascade rung that grounded this side.
+                         * @enum {string}
+                         */
+                        rung: "code" | "crosswalk" | "exact-name" | "normalized-name";
+                        score: number;
+                        compositionId: string;
+                    };
+                    /** @enum {string} */
+                    kind: "concept-identity-match";
+                } | {
+                    /** @enum {string} */
+                    layer: "concept-identity";
+                    a: {
+                        /** @description The best candidate's base-ingredient concept ids — more than one for a combination product. */
+                        conceptIds: string[];
+                        /** @description The best candidate's salt/ester-grain concept ids. Empty when the match carries no precise grain. */
+                        preciseConceptIds: string[];
+                        /**
+                         * @description The cascade rung that grounded this side.
+                         * @enum {string}
+                         */
+                        rung: "code" | "crosswalk" | "exact-name" | "normalized-name";
+                        score: number;
+                        compositionId: string;
+                    };
+                    b: {
+                        /** @description The best candidate's base-ingredient concept ids — more than one for a combination product. */
+                        conceptIds: string[];
+                        /** @description The best candidate's salt/ester-grain concept ids. Empty when the match carries no precise grain. */
+                        preciseConceptIds: string[];
+                        /**
+                         * @description The cascade rung that grounded this side.
+                         * @enum {string}
+                         */
+                        rung: "code" | "crosswalk" | "exact-name" | "normalized-name";
+                        score: number;
+                        compositionId: string;
+                    };
+                    /** @enum {string} */
+                    kind: "concept-identity-partial-match";
+                } | {
+                    /** @enum {string} */
+                    layer: "concept-identity";
+                    a: {
+                        /** @description The best candidate's base-ingredient concept ids — more than one for a combination product. */
+                        conceptIds: string[];
+                        /** @description The best candidate's salt/ester-grain concept ids. Empty when the match carries no precise grain. */
+                        preciseConceptIds: string[];
+                        /**
+                         * @description The cascade rung that grounded this side.
+                         * @enum {string}
+                         */
+                        rung: "code" | "crosswalk" | "exact-name" | "normalized-name";
+                        score: number;
+                        compositionId: string;
+                    };
+                    b: {
+                        /** @description The best candidate's base-ingredient concept ids — more than one for a combination product. */
+                        conceptIds: string[];
+                        /** @description The best candidate's salt/ester-grain concept ids. Empty when the match carries no precise grain. */
+                        preciseConceptIds: string[];
+                        /**
+                         * @description The cascade rung that grounded this side.
+                         * @enum {string}
+                         */
+                        rung: "code" | "crosswalk" | "exact-name" | "normalized-name";
+                        score: number;
+                        compositionId: string;
+                    };
+                    /** @enum {string} */
+                    kind: "concept-identity-mismatch";
                 } | {
                     /** @enum {string} */
                     kind: "field-similarity";
@@ -2481,8 +2615,23 @@ export interface components {
                     reasoning: string;
                 })[];
             };
-        } | {
-            /** @enum {string} */
+        };
+        /** @description The node this edge originates from. */
+        NodeRef: {
+            /** @description Id of the referenced node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
+            id: string;
+            /**
+             * @description Node type of the referenced node.
+             * @enum {string}
+             */
+            type: "extracted_fact" | "fact" | "extracted_narrative" | "narrative_passage" | "narrative" | "learned_memory" | "extracted_clinical_event";
+        };
+        /** @description A `resolves_to` edge in the patient context graph. */
+        ResolvesToEdge: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "resolves_to";
             /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
             id: string;
@@ -2492,10 +2641,15 @@ export interface components {
             updatedAt: string;
             from: components["schemas"]["NodeRef"];
             to: components["schemas"]["NodeRef"] & unknown;
-            /** @description Type-specific attributes of the `resolves_to` edge. */
+            /** @description Type-specific attributes of a `resolves_to` edge. */
             payload: Record<string, never>;
-        } | {
-            /** @enum {string} */
+        };
+        /** @description A `chunked_into` edge in the patient context graph. */
+        ChunkedIntoEdge: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "chunked_into";
             /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
             id: string;
@@ -2505,10 +2659,15 @@ export interface components {
             updatedAt: string;
             from: components["schemas"]["NodeRef"];
             to: components["schemas"]["NodeRef"] & unknown;
-            /** @description Type-specific attributes of the `chunked_into` edge. */
+            /** @description Type-specific attributes of a `chunked_into` edge. */
             payload: Record<string, never>;
-        } | {
-            /** @enum {string} */
+        };
+        /** @description A `relationship` edge in the patient context graph. */
+        RelationshipEdge: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
             type: "relationship";
             /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
             id: string;
@@ -2518,7 +2677,7 @@ export interface components {
             updatedAt: string;
             from: components["schemas"]["NodeRef"];
             to: components["schemas"]["NodeRef"] & unknown;
-            /** @description Type-specific attributes of the `relationship` edge. */
+            /** @description Type-specific attributes of a `relationship` edge. */
             payload: {
                 type: string;
                 attributes?: {
@@ -2530,16 +2689,6 @@ export interface components {
                 reasoning?: string;
             };
         };
-        /** @description The node this edge originates from. */
-        NodeRef: {
-            /** @description Id of the referenced node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-            id: string;
-            /**
-             * @description Node type of the referenced node.
-             * @enum {string}
-             */
-            type: "extracted_fact" | "fact" | "extracted_narrative" | "narrative_passage" | "narrative" | "learned_memory" | "extracted_clinical_event";
-        };
         /** @description A page of edges of one type from the patient context graph. */
         EdgeList: {
             /** @description The requested page of items. */
@@ -2557,478 +2706,7 @@ export interface components {
         /** @description A page of `extracted_fact` nodes from the patient context graph. */
         ExtractedFactNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "extracted_fact";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `extracted_fact` node. */
-                payload: {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "condition";
-                    /**
-                     * @description Clinical status of the condition. active = currently present; resolved = no longer present; inactive = present but not actively managed.
-                     * @enum {string}
-                     */
-                    status: "active" | "resolved" | "inactive" | "unknown";
-                    /** @description ISO date when the condition first started, from Condition.onsetPeriod.start or onsetDateTime. */
-                    onsetDate?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "medication";
-                    /**
-                     * @description Current regimen status. active = currently taking; on-hold = temporarily paused; completed = full course finished as planned; discontinued = stopped early or cancelled; unknown = indeterminate.
-                     * @enum {string}
-                     */
-                    status: "active" | "on-hold" | "completed" | "discontinued" | "unknown";
-                    /** @description Free-text dosage instructions from MedicationStatement.dosage[].additionalInstruction[].text, e.g. 'Take 1 tablet by mouth daily for hypertension.' */
-                    dosageInstructions?: string;
-                    /** @description Route of administration from dosage[].route, e.g. 'Oral', 'IV', 'Topical'. */
-                    route?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "allergy";
-                    /**
-                     * @description Clinical status of the allergy record. active = allergy is current; inactive = no longer considered relevant; entered-in-error = recorded by mistake.
-                     * @enum {string}
-                     */
-                    status: "active" | "inactive" | "entered-in-error";
-                    /**
-                     * @description Worst-case potential harm from exposure. high = life-threatening (e.g. anaphylaxis); low = non-life-threatening (e.g. rash).
-                     * @enum {string}
-                     */
-                    criticality?: "low" | "high" | "unable-to-assess";
-                    /** @description Substance category from AllergyIntolerance.category, e.g. ['medication'], ['food', 'environment']. */
-                    category?: string[];
-                    /** @description Observed reaction manifestations as display strings from reaction[].manifestation, e.g. ['Swelling', 'Anaphylaxis']. */
-                    reactions?: string[];
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "family_history";
-                    /** @description Relationship of the relative to the patient from FamilyMemberHistory.relationship.text, e.g. 'Brother', 'Father', 'Maternal grandmother'. */
-                    relationship: string;
-                    /**
-                     * @description Biological sex of the relative from FamilyMemberHistory.sex.
-                     * @enum {string}
-                     */
-                    sex?: "male" | "female" | "other" | "unknown";
-                    /** @description Health conditions recorded for this relative from FamilyMemberHistory.condition[]. */
-                    conditions: {
-                        /** @description Condition name for this relative, e.g. 'Multiple sclerosis'. */
-                        display: string;
-                    }[];
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "social_history";
-                    /** @description Observation topic from Observation.code.text, e.g. 'Tobacco use and exposure', 'Alcohol use'. */
-                    category?: string;
-                    /** @description Current state as a string from Observation.valueString or valueCodeableConcept.text, e.g. 'Smokeless tobacco non-user', 'Current every day smoker'. */
-                    value?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "immunization";
-                    /**
-                     * @description Administration status from Immunization.status. HG provides individual shot records — each administered vaccine is its own Fact, not a rolled-up series status.
-                     * @enum {string}
-                     */
-                    status: "completed" | "not-done";
-                    /** @description ISO date when the vaccine was administered, from Immunization.occurrenceDateTime. */
-                    occurrenceDate?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "device";
-                    /**
-                     * @description Whether the device is currently in use. active = currently implanted or in active use; inactive = removed or no longer used; unknown = not reported by the source.
-                     * @enum {string}
-                     */
-                    status: "active" | "inactive" | "entered-in-error" | "unknown";
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "demographic";
-                    /** @description Patient date of birth in ISO format (YYYY-MM-DD), from Patient.birthDate. */
-                    birthDate?: string;
-                    /** @description Administrative sex from Patient.gender, e.g. 'male', 'female'. */
-                    sex?: string;
-                    /** @description Flattened address string from Patient.address, e.g. 'Laporte, CO'. Kept as a single string since HG provides it pre-formatted. */
-                    address?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "insurance";
-                    /**
-                     * @description Coverage status from Coverage.status.
-                     * @enum {string}
-                     */
-                    status: "active" | "cancelled" | "draft" | "entered-in-error";
-                    /** @description Payer name from Coverage.payor[].display, e.g. 'MEDICARE', 'BCBS'. */
-                    planName?: string;
-                    /** @description Member identifier from Coverage.identifier[].value. */
-                    memberId?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "directive";
-                    /**
-                     * @description Whether this directive is currently in effect. active = legally binding; void = revoked or superseded.
-                     * @enum {string}
-                     */
-                    status: "active" | "void" | "entered-in-error";
-                    /** @description Directive content extracted from the source document (e.g. living will, POLST). HG delivers these as PDFs rather than structured Consent resources. */
-                    notes?: string;
-                    /** @description Where this fact was extracted from. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                };
-            }[];
+            data: components["schemas"]["ExtractedFactNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3042,358 +2720,7 @@ export interface components {
         /** @description A page of `fact` nodes from the patient context graph. */
         FactNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "fact";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `fact` node. */
-                payload: {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "condition";
-                    /**
-                     * @description Clinical status of the condition. active = currently present; resolved = no longer present; inactive = present but not actively managed.
-                     * @enum {string}
-                     */
-                    status: "active" | "resolved" | "inactive" | "unknown";
-                    /** @description ISO date when the condition first started, from Condition.onsetPeriod.start or onsetDateTime. */
-                    onsetDate?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "medication";
-                    /**
-                     * @description Current regimen status. active = currently taking; on-hold = temporarily paused; completed = full course finished as planned; discontinued = stopped early or cancelled; unknown = indeterminate.
-                     * @enum {string}
-                     */
-                    status: "active" | "on-hold" | "completed" | "discontinued" | "unknown";
-                    /** @description Free-text dosage instructions from MedicationStatement.dosage[].additionalInstruction[].text, e.g. 'Take 1 tablet by mouth daily for hypertension.' */
-                    dosageInstructions?: string;
-                    /** @description Route of administration from dosage[].route, e.g. 'Oral', 'IV', 'Topical'. */
-                    route?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "allergy";
-                    /**
-                     * @description Clinical status of the allergy record. active = allergy is current; inactive = no longer considered relevant; entered-in-error = recorded by mistake.
-                     * @enum {string}
-                     */
-                    status: "active" | "inactive" | "entered-in-error";
-                    /**
-                     * @description Worst-case potential harm from exposure. high = life-threatening (e.g. anaphylaxis); low = non-life-threatening (e.g. rash).
-                     * @enum {string}
-                     */
-                    criticality?: "low" | "high" | "unable-to-assess";
-                    /** @description Substance category from AllergyIntolerance.category, e.g. ['medication'], ['food', 'environment']. */
-                    category?: string[];
-                    /** @description Observed reaction manifestations as display strings from reaction[].manifestation, e.g. ['Swelling', 'Anaphylaxis']. */
-                    reactions?: string[];
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "family_history";
-                    /** @description Relationship of the relative to the patient from FamilyMemberHistory.relationship.text, e.g. 'Brother', 'Father', 'Maternal grandmother'. */
-                    relationship: string;
-                    /**
-                     * @description Biological sex of the relative from FamilyMemberHistory.sex.
-                     * @enum {string}
-                     */
-                    sex?: "male" | "female" | "other" | "unknown";
-                    /** @description Health conditions recorded for this relative from FamilyMemberHistory.condition[]. */
-                    conditions: {
-                        /** @description Condition name for this relative, e.g. 'Multiple sclerosis'. */
-                        display: string;
-                    }[];
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "social_history";
-                    /** @description Observation topic from Observation.code.text, e.g. 'Tobacco use and exposure', 'Alcohol use'. */
-                    category?: string;
-                    /** @description Current state as a string from Observation.valueString or valueCodeableConcept.text, e.g. 'Smokeless tobacco non-user', 'Current every day smoker'. */
-                    value?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "immunization";
-                    /**
-                     * @description Administration status from Immunization.status. HG provides individual shot records — each administered vaccine is its own Fact, not a rolled-up series status.
-                     * @enum {string}
-                     */
-                    status: "completed" | "not-done";
-                    /** @description ISO date when the vaccine was administered, from Immunization.occurrenceDateTime. */
-                    occurrenceDate?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "device";
-                    /**
-                     * @description Whether the device is currently in use. active = currently implanted or in active use; inactive = removed or no longer used; unknown = not reported by the source.
-                     * @enum {string}
-                     */
-                    status: "active" | "inactive" | "entered-in-error" | "unknown";
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "demographic";
-                    /** @description Patient date of birth in ISO format (YYYY-MM-DD), from Patient.birthDate. */
-                    birthDate?: string;
-                    /** @description Administrative sex from Patient.gender, e.g. 'male', 'female'. */
-                    sex?: string;
-                    /** @description Flattened address string from Patient.address, e.g. 'Laporte, CO'. Kept as a single string since HG provides it pre-formatted. */
-                    address?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "insurance";
-                    /**
-                     * @description Coverage status from Coverage.status.
-                     * @enum {string}
-                     */
-                    status: "active" | "cancelled" | "draft" | "entered-in-error";
-                    /** @description Payer name from Coverage.payor[].display, e.g. 'MEDICARE', 'BCBS'. */
-                    planName?: string;
-                    /** @description Member identifier from Coverage.identifier[].value. */
-                    memberId?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                } | {
-                    /** @description Human-readable label — condition name, drug name, vaccine name, etc. */
-                    display: string;
-                    /** @description Clinical codes for this fact (SNOMED, ICD-10, RxNorm, CVX…). More than one when multiple coding systems apply. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description ISO date when this fact was recorded or last updated in the source system. */
-                    date?: string;
-                    /** @description Temporal bounds of the fact's validity. */
-                    effectivePeriod?: {
-                        /** @description ISO date when this fact became active. */
-                        start?: string;
-                        /** @description ISO date when this fact ended or was resolved. */
-                        end?: string;
-                    };
-                    /** @enum {string} */
-                    type: "directive";
-                    /**
-                     * @description Whether this directive is currently in effect. active = legally binding; void = revoked or superseded.
-                     * @enum {string}
-                     */
-                    status: "active" | "void" | "entered-in-error";
-                    /** @description Directive content extracted from the source document (e.g. living will, POLST). HG delivers these as PDFs rather than structured Consent resources. */
-                    notes?: string;
-                    /** @description Every extracted fact this fact was projected from. */
-                    members: {
-                        /** @description Id of the `extracted_fact` node this member traces to (`ef_...`). */
-                        extractedFactId: string;
-                    }[];
-                    fieldVerdicts: components["schemas"]["FactConflicts"];
-                };
-            }[];
+            data: components["schemas"]["FactNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3407,47 +2734,7 @@ export interface components {
         /** @description A page of `extracted_narrative` nodes from the patient context graph. */
         ExtractedNarrativeNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "extracted_narrative";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `extracted_narrative` node. */
-                payload: {
-                    /** @description Deterministic human-readable label from the source, or null when the source provides none. */
-                    summary: string | null;
-                    /** @description ISO 8601 clinical effective time, or null when the source carries none. */
-                    effectiveAt: string | null;
-                    /** @description Provenance of the originating document, end-to-end. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                    /** @description The decoded text of this source unit. */
-                    content: string;
-                    /** @description Deterministically extracted source fields (e.g. DocumentReference.status). */
-                    metadata: {
-                        [key: string]: unknown;
-                    };
-                    /** @description The ingestion request that introduced this row. */
-                    ingestionId: string;
-                };
-            }[];
+            data: components["schemas"]["ExtractedNarrativeNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3461,29 +2748,7 @@ export interface components {
         /** @description A page of `narrative_passage` nodes from the patient context graph. */
         NarrativePassageNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "narrative_passage";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `narrative_passage` node. */
-                payload: {
-                    /** @description Id of the `extracted_narrative` node this passage was rendered from (`en_...`). */
-                    extractedNarrativeId: string;
-                    /** @description Rendered narrative text of the source section. */
-                    content: string;
-                    /** @description Title of the source section, or null when the source has none. */
-                    sectionTitle: string | null;
-                    /** @description Start offset of this passage within its extracted narrative's rendered content. */
-                    offsetStart: number;
-                    /** @description End offset (exclusive) within its extracted narrative's rendered content. */
-                    offsetEnd: number;
-                };
-            }[];
+            data: components["schemas"]["NarrativePassageNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3497,54 +2762,7 @@ export interface components {
         /** @description A page of `narrative` nodes from the patient context graph. */
         NarrativeNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "narrative";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `narrative` node. */
-                payload: {
-                    /** @description Latest defined member clinical time, or null when no member carries one. */
-                    effectiveAt: string | null;
-                    /** @description Model asked to write `title` and `summary`. */
-                    modelSource: {
-                        /** @description Model provider identifier. */
-                        provider: string;
-                        /** @description Exact provider model identifier. */
-                        model: string;
-                        /** @description Provider model version when it is distinct from the model identifier. */
-                        version?: string;
-                    };
-                    /** @description The member narrative passages this narrative projects. */
-                    members: {
-                        /** @description Id of the member `narrative_passage` node (`np_...`). */
-                        narrativePassageId: string;
-                    }[];
-                    /** @description Short LLM-written heading, or null when summarization produced nothing. */
-                    title: string | null;
-                    /** @description LLM-written account of the member passages, or null when summarization produced nothing. */
-                    summary: string | null;
-                    /** @description Representative verbatim span from one member passage, or null when none was selected. */
-                    quote: {
-                        /** @description Id of the member `narrative_passage` node the quote was taken from (`np_...`). */
-                        narrativePassageId: string;
-                        /** @description Exact substring of that passage's rendered content. */
-                        text: string;
-                        /** @description Start of the quote within the passage's own content. */
-                        offsetStart: number;
-                        /** @description End offset (exclusive) within the passage's own content. */
-                        offsetEnd: number;
-                    } | null;
-                    /** @description Fact types this narrative plausibly concerns. */
-                    boundFactTypes: ("condition" | "medication" | "allergy" | "family_history" | "social_history" | "immunization" | "device" | "demographic" | "insurance" | "directive")[];
-                    /** @description Clinical-event types this narrative plausibly concerns. */
-                    boundEventTypes: ("encounter" | "observation" | "procedure" | "medication_event")[];
-                };
-            }[];
+            data: components["schemas"]["NarrativeNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3558,28 +2776,7 @@ export interface components {
         /** @description A page of `learned_memory` nodes from the patient context graph. */
         LearnedMemoryNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "learned_memory";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `learned_memory` node. */
-                payload: {
-                    /**
-                     * @description The memory taxonomy — symptom | adherence | concern | preference.
-                     * @enum {string}
-                     */
-                    type: "symptom" | "adherence" | "concern" | "preference";
-                    /** @description The statement as expressed by or on behalf of the patient. */
-                    content: string;
-                    /** @description Provenance: the id of the session that produced this memory. */
-                    sessionId: string;
-                };
-            }[];
+            data: components["schemas"]["LearnedMemoryNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3593,227 +2790,7 @@ export interface components {
         /** @description A page of `extracted_clinical_event` nodes from the patient context graph. */
         ExtractedClinicalEventNodeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "extracted_clinical_event";
-                /** @description Unique identifier for this node, as a prefixed node id (`{type}_{id}`, e.g. `ef_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this node was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this node was last updated. */
-                updatedAt: string;
-                /** @description Type-specific attributes of the `extracted_clinical_event` node. */
-                payload: {
-                    /** @enum {string} */
-                    type: "encounter";
-                    /** @description Temporal bounds of the event, for one that spans time rather than happening at an instant. */
-                    effectivePeriod?: {
-                        /** @description ISO date when the event's span began. */
-                        start?: string;
-                        /** @description ISO date when it ended. */
-                        end?: string;
-                    };
-                    /** @description One-line description for display and timeline. */
-                    summary: string;
-                    /** @description Provenance: the ingestion request that introduced this event. Absent for a row written outside a run, which is every row predating the run model. */
-                    ingestionId?: string;
-                    /**
-                     * @description Encounter class. Maps from FHIR V3 ActEncounterCode: IMP/ACUTE/NONAC/SS → inpatient, AMB/OBSENC → outpatient, EMER → emergency, VR → virtual, HH/FLD → home.
-                     * @enum {string}
-                     */
-                    kind: "inpatient" | "outpatient" | "emergency" | "virtual" | "home" | "unknown";
-                    /** @description Clinical codes for why the encounter occurred. */
-                    reasonCodes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description Display name of the encounter location. */
-                    location?: string;
-                    /** @description Where the patient went after discharge. */
-                    dischargeDisposition?: string;
-                    /** @description ISO 8601 timestamp when this clinical event occurred. */
-                    timestamp: string;
-                    /** @description Where this event was extracted from. Events are single-source — not merged across sources. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                } | {
-                    /** @enum {string} */
-                    type: "observation";
-                    /** @description Temporal bounds of the event, for one that spans time rather than happening at an instant. */
-                    effectivePeriod?: {
-                        /** @description ISO date when the event's span began. */
-                        start?: string;
-                        /** @description ISO date when it ended. */
-                        end?: string;
-                    };
-                    /** @description One-line description for display and timeline. */
-                    summary: string;
-                    /** @description Provenance: the ingestion request that introduced this event. Absent for a row written outside a run, which is every row predating the run model. */
-                    ingestionId?: string;
-                    /**
-                     * @description Observation sub-domain. Maps from FHIR Observation.category and CDA section LOINC codes: 30954-2 → laboratory/imaging, 8716-3 → vital-signs, Functional Status / Mental Status sections → functional-status.
-                     * @enum {string}
-                     */
-                    kind?: "laboratory" | "vital-signs" | "imaging" | "survey" | "functional-status" | "social-history" | "activity" | "other";
-                    /** @description Codes for the observation or panel, in whatever systems the source used — LOINC where it has one, e.g. '2947-0' (Sodium), but also CPT, a local analyte id, or a translation set. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description Bare panel/measurement name without the value, e.g. 'Hemoglobin A1c'. Stable across different values for the same LOINC — used to slug trend panels so the time series groups correctly. Distinct from `summary`, which embeds the value for timeline display. */
-                    displayName?: string;
-                    /** @description Display representation of the result value, e.g. '8.9 %', 'Positive', '138 mmol/L'. */
-                    value?: string;
-                    /** @description UCUM unit from valueQuantity.unit, e.g. 'mmol/L', 'mm[Hg]'. */
-                    unit?: string;
-                    /**
-                     * @description Clinical interpretation of the value relative to the reference range. Maps from Observation.interpretation.
-                     * @enum {string}
-                     */
-                    interpretation?: "critical-high" | "critical-low" | "high" | "low" | "normal" | "absent" | "unknown";
-                    /** @description Reference range as a display string, e.g. '3.5–5.5 mmol/L'. */
-                    referenceRange?: string;
-                    /**
-                     * @description Result status from Observation.status or DiagnosticReport.status.
-                     * @enum {string}
-                     */
-                    status: "final" | "preliminary" | "amended" | "corrected" | "cancelled" | "unknown";
-                    /** @description ISO 8601 timestamp when this clinical event occurred. */
-                    timestamp: string;
-                    /** @description Where this event was extracted from. Events are single-source — not merged across sources. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                } | {
-                    /** @enum {string} */
-                    type: "procedure";
-                    /** @description Temporal bounds of the event, for one that spans time rather than happening at an instant. */
-                    effectivePeriod?: {
-                        /** @description ISO date when the event's span began. */
-                        start?: string;
-                        /** @description ISO date when it ended. */
-                        end?: string;
-                    };
-                    /** @description One-line description for display and timeline. */
-                    summary: string;
-                    /** @description Provenance: the ingestion request that introduced this event. Absent for a row written outside a run, which is every row predating the run model. */
-                    ingestionId?: string;
-                    /** @description Procedure codes from CPT, SNOMED-CT, or ICD PCS. */
-                    codes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /** @description Anatomical site of the procedure, from bodySite[0].text. */
-                    bodySite?: string;
-                    /** @description Outcome text, from Procedure.outcome.text. */
-                    outcome?: string;
-                    /**
-                     * @description Procedure status. not-done covers CDA 'Procedure Refused'; aborted covers CDA 'Procedure Unsuccessful'.
-                     * @enum {string}
-                     */
-                    status: "completed" | "not-done" | "aborted" | "in-progress" | "stopped" | "unknown";
-                    /** @description ISO 8601 timestamp when this clinical event occurred. */
-                    timestamp: string;
-                    /** @description Where this event was extracted from. Events are single-source — not merged across sources. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                } | {
-                    /** @enum {string} */
-                    type: "medication_event";
-                    /** @description Temporal bounds of the event, for one that spans time rather than happening at an instant. */
-                    effectivePeriod?: {
-                        /** @description ISO date when the event's span began. */
-                        start?: string;
-                        /** @description ISO date when it ended. */
-                        end?: string;
-                    };
-                    /** @description One-line description for display and timeline. */
-                    summary: string;
-                    /** @description Provenance: the ingestion request that introduced this event. Absent for a row written outside a run, which is every row predating the run model. */
-                    ingestionId?: string;
-                    /** @description Medication name as it appears in the source, e.g. 'Lisinopril 10 mg tablet'. */
-                    medicationDisplay: string;
-                    /** @description RxNorm or NDC codes for the medication. */
-                    medicationCodes?: {
-                        system: string;
-                        code: string;
-                        display?: string;
-                    }[];
-                    /**
-                     * @description Lifecycle step this event represents.
-                     *             prescribed = MedicationRequest / CDA order written;
-                     *             dispensed = MedicationDispense / pharmacy filled;
-                     *             administered = MedicationAdministration / CDA single administration;
-                     *             stopped = discontinued / CDA withdrawn;
-                     *             refused = patient refused / CDA Medication Refused.
-                     * @enum {string}
-                     */
-                    kind: "prescribed" | "dispensed" | "administered" | "completed" | "stopped" | "on-hold" | "refused" | "unknown";
-                    /** @description Dosage instructions as a display string, e.g. '10 mg daily'. Includes CDA free-text SIG. */
-                    dose?: string;
-                    /** @description Route of administration, e.g. 'oral', 'IV'. */
-                    route?: string;
-                    /** @description ISO 8601 timestamp when this clinical event occurred. */
-                    timestamp: string;
-                    /** @description Where this event was extracted from. Events are single-source — not merged across sources. */
-                    source: {
-                        /**
-                         * @description Format of the source record.
-                         * @enum {string}
-                         */
-                        type: "fhir" | "cda" | "document" | "patient-reported";
-                        /** @description System or process that produced the source record. */
-                        origin: string;
-                        /** @description Reference to the source record (e.g. "Condition/abc"). */
-                        ref: string;
-                        /** @description ISO 8601 timestamp when the source record was last updated at its origin, or null when unknown. */
-                        recordedAt: string | null;
-                        /** @description ISO 8601 timestamp when this record was ingested. */
-                        ingestedAt: string;
-                    };
-                };
-            }[];
+            data: components["schemas"]["ExtractedClinicalEventNode"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -3827,194 +2804,7 @@ export interface components {
         /** @description A page of `resolution_decision` edges from the patient context graph. */
         ResolutionDecisionEdgeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "resolution_decision";
-                /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this edge was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this edge was last updated. */
-                updatedAt: string;
-                from: components["schemas"]["NodeRef"];
-                to: components["schemas"]["NodeRef"] & unknown;
-                /** @description Type-specific attributes of the `resolution_decision` edge. */
-                payload: {
-                    /**
-                     * @description The decided outcome. `continue` is a control-flow signal for stop rules and is never recorded here.
-                     * @enum {string}
-                     */
-                    verdict: "merge" | "reject";
-                    /**
-                     * @description The quality signal carried by the verdict (confirmed | probable | uncertain) — authoritative, and the only quality measure now that confidence floats are dropped. Both merges and rejects carry one.
-                     * @enum {string}
-                     */
-                    resolution: "uncertain" | "probable" | "confirmed";
-                    /** @description Id of the stop rule that fired, e.g. 'corroborated-hierarchical-merge'. This is the audit's 'why'. */
-                    ruleId: string;
-                    /** @description The full accumulated evidence the rule evaluated, in the order the layers ran. */
-                    evidence: ({
-                        /** @enum {string} */
-                        kind: "source-ref";
-                        /** @enum {string} */
-                        layer: "source-ref-equality";
-                    } | {
-                        /** @enum {string} */
-                        kind: "exact-code-match";
-                        /** @enum {string} */
-                        layer: "deterministic-code";
-                        /** @description The code system the match was made in: its canonical URI when recognized, the source spelling otherwise. */
-                        system: string;
-                        /** @description Whether the code system was one the vocabulary layer recognizes at decision time. */
-                        systemRecognized: boolean;
-                        /** @description The code that both entities share in the given code system. */
-                        code: string;
-                    } | {
-                        /** @enum {string} */
-                        kind: "hierarchical-code-match";
-                        /** @enum {string} */
-                        layer: "deterministic-code";
-                        /** @description The code system the match was made in: its canonical URI when recognized, the source spelling otherwise. */
-                        system: string;
-                        /** @description Whether the code system was one the vocabulary layer recognizes at decision time. */
-                        systemRecognized: boolean;
-                        /** @description The code from entity A. */
-                        codeA: string;
-                        /** @description The code from entity B. */
-                        codeB: string;
-                        /** @description The ancestor code that links the two entities' codes hierarchically. */
-                        ancestorCode: string;
-                    } | {
-                        /** @enum {string} */
-                        kind: "code-mismatch";
-                        /** @enum {string} */
-                        layer: "deterministic-code";
-                        /** @description The code system the match was made in: its canonical URI when recognized, the source spelling otherwise. */
-                        system: string;
-                        /** @description Whether the code system was one the vocabulary layer recognizes at decision time. */
-                        systemRecognized: boolean;
-                        /** @description The code from entity A. */
-                        codeA: string;
-                        /** @description The code from entity B. */
-                        codeB: string;
-                    } | {
-                        /** @enum {string} */
-                        kind: "field-similarity";
-                        /** @enum {string} */
-                        layer: "nlp-normalization";
-                        /** @description The field for which the text similarity was computed. */
-                        field: string;
-                        /** @description The similarity score for the normalized values. */
-                        similarity: number;
-                        /** @description Entity A's raw normalized value for this field. */
-                        aValue: string | null;
-                        /** @description Entity B's raw normalized value for this field. */
-                        bValue: string | null;
-                    } | {
-                        /** @enum {string} */
-                        kind: "semantic-similarity";
-                        /** @enum {string} */
-                        layer: "embedding-similarity";
-                        measurement: {
-                            /** @enum {string} */
-                            algorithm: "cosine";
-                            similarity: number;
-                        };
-                    } | {
-                        /** @enum {string} */
-                        kind: "narrative-semantic-similarity";
-                        /** @enum {string} */
-                        layer: "embedding-similarity";
-                        /** @description One-based rank within the passage's top-k candidates. */
-                        candidateRank: number;
-                        measurement: {
-                            /** @enum {string} */
-                            algorithm: "cosine";
-                            similarity: number;
-                            thresholds: {
-                                rejectAtOrBelow: number;
-                                mergeAtOrAbove: number;
-                            };
-                        };
-                        modelSource: {
-                            /** @description Model provider identifier. */
-                            provider: string;
-                            /** @description Exact provider model identifier. */
-                            model: string;
-                            /** @description Provider model version when it is distinct from the model identifier. */
-                            version?: string;
-                        };
-                    } | ({
-                        /** @enum {string} */
-                        kind: "llm";
-                        /** @enum {string} */
-                        layer: "llm-adjudication";
-                        /** @description The LLM adjudicator's confidence in its match judgment. */
-                        confidence: number;
-                        /** @description The LLM adjudicator's reasoning for its judgment. */
-                        reasoning: string;
-                        /** @enum {boolean} */
-                        match: false;
-                    } | ({
-                        /** @enum {string} */
-                        kind: "llm";
-                        /** @enum {string} */
-                        layer: "llm-adjudication";
-                        /** @description The LLM adjudicator's confidence in its match judgment. */
-                        confidence: number;
-                        /** @description The LLM adjudicator's reasoning for its judgment. */
-                        reasoning: string;
-                        /** @enum {boolean} */
-                        match: true;
-                        /**
-                         * @description The entity the LLM adjudicator judged to be canonical, verbatim.
-                         * @enum {string}
-                         */
-                        canonical: "a" | "b";
-                    } | {
-                        /** @enum {string} */
-                        kind: "llm";
-                        /** @enum {string} */
-                        layer: "llm-adjudication";
-                        /** @description The LLM adjudicator's confidence in its match judgment. */
-                        confidence: number;
-                        /** @description The LLM adjudicator's reasoning for its judgment. */
-                        reasoning: string;
-                        /** @enum {boolean} */
-                        match: true;
-                        /** @enum {string} */
-                        canonical: "merged";
-                        /** @description Per-field conflicts the LLM adjudicator found and resolved while merging. */
-                        conflicts: {
-                            /** @description The field for which the LLM adjudicator found a conflict. */
-                            field: string;
-                            /** @description The value from entity A for this field. */
-                            sourceAValue?: unknown;
-                            /** @description The value from entity B for this field. */
-                            sourceBValue?: unknown;
-                            /** @description The resolution for this field. */
-                            resolution?: unknown;
-                            /** @description The strategy the LLM adjudicator used to resolve this field. */
-                            strategy: string;
-                        }[];
-                    })) | {
-                        /** @enum {string} */
-                        kind: "narrative-llm";
-                        /** @enum {string} */
-                        layer: "llm-adjudication";
-                        modelSource: {
-                            /** @description Model provider identifier. */
-                            provider: string;
-                            /** @description Exact provider model identifier. */
-                            model: string;
-                            /** @description Provider model version when it is distinct from the model identifier. */
-                            version?: string;
-                        };
-                        /** @description Human-readable reasoning returned for the pair. */
-                        reasoning: string;
-                    })[];
-                };
-            }[];
+            data: components["schemas"]["ResolutionDecisionEdge"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -4028,20 +2818,7 @@ export interface components {
         /** @description A page of `resolves_to` edges from the patient context graph. */
         ResolvesToEdgeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "resolves_to";
-                /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this edge was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this edge was last updated. */
-                updatedAt: string;
-                from: components["schemas"]["NodeRef"];
-                to: components["schemas"]["NodeRef"] & unknown;
-                /** @description Type-specific attributes of the `resolves_to` edge. */
-                payload: Record<string, never>;
-            }[];
+            data: components["schemas"]["ResolvesToEdge"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -4055,20 +2832,7 @@ export interface components {
         /** @description A page of `chunked_into` edges from the patient context graph. */
         ChunkedIntoEdgeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "chunked_into";
-                /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this edge was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this edge was last updated. */
-                updatedAt: string;
-                from: components["schemas"]["NodeRef"];
-                to: components["schemas"]["NodeRef"] & unknown;
-                /** @description Type-specific attributes of the `chunked_into` edge. */
-                payload: Record<string, never>;
-            }[];
+            data: components["schemas"]["ChunkedIntoEdge"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */
@@ -4082,29 +2846,7 @@ export interface components {
         /** @description A page of `relationship` edges from the patient context graph. */
         RelationshipEdgeList: {
             /** @description The requested page of items. */
-            data: {
-                /** @enum {string} */
-                type: "relationship";
-                /** @description Unique identifier for this edge, as a prefixed edge id (`{type}_{id}`, e.g. `rd_...`). */
-                id: string;
-                /** @description ISO 8601 timestamp when this edge was first created. */
-                createdAt: string;
-                /** @description ISO 8601 timestamp when this edge was last updated. */
-                updatedAt: string;
-                from: components["schemas"]["NodeRef"];
-                to: components["schemas"]["NodeRef"] & unknown;
-                /** @description Type-specific attributes of the `relationship` edge. */
-                payload: {
-                    type: string;
-                    attributes?: {
-                        [key: string]: unknown;
-                    };
-                    /** @enum {string} */
-                    source?: "explicit_reference" | "knowledge_base" | "temporal_inference" | "llm_inferred" | "narrative_verification";
-                    confidence?: number;
-                    reasoning?: string;
-                };
-            }[];
+            data: components["schemas"]["RelationshipEdge"][];
             /** @description Pagination metadata for the returned page. */
             meta: {
                 /** @description Total number of items across all pages. */