@clinia/context-engine-js 0.5.0-rc.2 → 0.6.0-rc.0

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

@@ -122,7 +122,10 @@ export interface paths {
         put?: never;
         /**
          * Ingest FHIR R4
-         * @description Submits a FHIR R4 Bundle or single resource for ingestion. Returns an `IngestExecutionEnvelope` immediately with status `pending` or `running`. Pass `?wait=<ms>` (max 30 000) to block until the execution reaches a terminal status. Multiple ingest calls for the same registry key accumulate sources; entity resolution re-runs after each call.
+         * @deprecated
+         * @description **Deprecated — use `POST /v1/patients/{patientId}/ingestions/fhir/r4` instead**, or `…/fhir/r5` for R5 payloads, which this endpoint parses as R4. The replacement returns an ingestion receipt you poll, accounts for resources it could not use, and does not block. This endpoint is unchanged and will be removed in a future release.
+         *
+         *     Submits a FHIR R4 Bundle or single resource for ingestion. Returns an `IngestExecutionEnvelope` immediately with status `pending` or `running`. Pass `?wait=<ms>` (max 30 000) to block until the execution reaches a terminal status. Multiple ingest calls for the same registry key accumulate sources; entity resolution re-runs after each call.
          */
         post: operations["ingest-fhir"];
         delete?: never;
@@ -142,7 +145,10 @@ export interface paths {
         put?: never;
         /**
          * Ingest CDA
-         * @description Submits a CDA/C-CDA XML document for ingestion. Body must be `text/plain`. Returns an `IngestExecutionEnvelope` immediately; use `?wait=<ms>` to block until terminal status.
+         * @deprecated
+         * @description **Deprecated — use `POST /v1/patients/{patientId}/ingestions/cda/r2` instead.** The replacement takes several documents in one call, returns an ingestion receipt you poll, and accounts for the sections it could not use. This endpoint is unchanged and will be removed in a future release.
+         *
+         *     Submits a CDA/C-CDA XML document for ingestion. Body must be `text/plain`. Returns an `IngestExecutionEnvelope` immediately; use `?wait=<ms>` to block until terminal status.
          */
         post: operations["ingest-cda"];
         delete?: never;
@@ -162,7 +168,10 @@ export interface paths {
         put?: never;
         /**
          * Register unstructured document
-         * @description Registers an unstructured document by name and MIME type. Used for documents that cannot be parsed as FHIR or CDA (e.g., PDFs). The document is tracked as an ingest source but does not contribute extracted clinical entities.
+         * @deprecated
+         * @description **Deprecated, and not replaced yet.** It registers a name and a MIME type and extracts nothing, so it contributes no clinical content; unstructured document ingest returns as a file upload once that work lands. This endpoint is unchanged and will be removed in a future release.
+         *
+         *     Registers an unstructured document by name and MIME type. Used for documents that cannot be parsed as FHIR or CDA (e.g., PDFs). The document is tracked as an ingest source but does not contribute extracted clinical entities.
          */
         post: operations["ingest-document"];
         delete?: never;
@@ -182,7 +191,10 @@ export interface paths {
         put?: never;
         /**
          * Batch ingest
-         * @description Submits FHIR bundles, CDA documents, and unstructured document registrations in a single request. Each source type is processed independently; the graph is rebuilt once after all sources are loaded.
+         * @deprecated
+         * @description **Deprecated, and not replaced.** Post to the per-format endpoints instead — `POST /v1/patients/{patientId}/ingestions/fhir/r4` (or `/r5`) and `.../ingestions/cda/r2`, each of which accepts several items in one call. Mixing formats in one request forces a single label onto the receipt, so it cannot record what actually arrived. This endpoint is unchanged and will be removed in a future release.
+         *
+         *     Submits FHIR bundles, CDA documents, and unstructured document registrations in a single request. Each source type is processed independently; the graph is rebuilt once after all sources are loaded.
          */
         post: operations["ingest-batch"];
         delete?: never;
@@ -251,6 +263,108 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/patients/{patientId}/ingestions/fhir/r4": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ingest FHIR R4
+         * @description Submits a FHIR R4 Bundle or a single resource. The response is a receipt: extraction continues after it is returned, so poll the ingestion to follow it. The version is part of the path because a Bundle does not state which FHIR release it is written against.
+         */
+        post: operations["ingest-fhir-r4"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingestions/fhir/r5": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ingest FHIR R5
+         * @description Submits a FHIR R5 Bundle or a single resource. The response is a receipt: ingestion continues after it is returned, so poll the ingestion to follow it. The version is part of the path because a Bundle does not state which FHIR release it is written against.
+         */
+        post: operations["ingest-fhir-r5"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingestions/cda/r2": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ingest CDA R2
+         * @description Submits CDA R2 documents as XML. Post one document as the request body with `Content-Type: application/cda+xml`, or several as `multipart/form-data` with one `documents` part per document.
+         *
+         *     The response is a receipt: ingestion continues after it is returned, so poll the ingestion to follow it. `intake` comes back index-aligned with the documents you sent, so it stays clear which document held what — and if any document cannot be parsed the whole request is rejected and nothing is stored.
+         */
+        post: operations["ingest-cda-r2"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingestions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List ingestions
+         * @description This patient's submissions, newest arrival last. `status` is derived per submission from the work it started, so filtering on it is also how to ask what is outstanding: `?status=pending,processing` returns everything still to settle, and its `meta.total` is the count — zero means this patient's data has settled.
+         */
+        get: operations["list-ingestions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingestions/{ingestionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an ingestion
+         * @description One submission and where its work stands. `status` is derived from the work the submission started, so this is the handle to poll after submitting — it stays valid for the life of that work.
+         */
+        get: operations["get-ingestion"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/patients/{patientId}/sessions": {
         parameters: {
             query?: never;
@@ -399,6 +513,106 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/patients/{patientId}/graph/nodes/{type}/items/{nodeId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get node
+         * @description Returns a single node from the patient context graph by id
+         */
+        get: operations["get-node"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/graph/nodes/{type}/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List nodes
+         * @description Returns a paginated list of nodes of one type from the patient context graph
+         */
+        get: operations["list-nodes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/graph/nodes/{type}/query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Query nodes
+         * @description Returns a paginated, filtered, and sorted page of nodes of one type from the patient context graph — the structured counterpart to `list-nodes`, for conditions that don't fit query-string params. Only `fact` is supported today; broader per-type querying is future work.
+         */
+        post: operations["query-nodes"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/graph/edges/{type}/items/{edgeId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get edge
+         * @description Returns a single edge from the patient context graph by id
+         */
+        get: operations["get-edge"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/graph/edges/{type}/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List edges
+         * @description Returns a paginated list of edges of one type from the patient context graph
+         */
+        get: operations["list-edges"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -519,7 +733,7 @@ export interface components {
                 display: string;
                 /** @description Complete provenance trace for this fact. */
                 provenance: {
-                    /** @description Resolution layer that produced this fact (e.g., deterministic-code, nlp-normalization, llm-adjudication, novel-entity). */
+                    /** @description Id of the stop rule that settled this fact's most recent merge decision (e.g., deterministic-code-exact, nlp-normalization-match, llm-adjudication), or novel-entity if no pair was ever compared. */
                     resolvedBy: string;
                     /** @description Resolution confidence score between 0 and 1. */
                     confidence: number;
@@ -595,7 +809,7 @@ export interface components {
                 type: string;
                 /** @description Number of source records that were merged into this entity. */
                 sourceCount: number;
-                /** @description Resolution strategy that produced the merge. */
+                /** @description Id of the stop rule that settled the merge, or novel-entity if none was compared. */
                 resolvedBy: string;
                 /** @description Merge confidence score between 0 and 1. */
                 confidence: number;
@@ -806,6 +1020,110 @@ export interface components {
                 detail?: string;
             } | null;
         };
+        /** @description One submission, whatever the item count — the receipt for a single request, and the only handle to keep. A receipt whose `staged` counts are all zero created no work, and `intake` says which of the two reasons it was: entries reading `ignored` mean nothing in the payload could be used, anything else means the content was already stored by an earlier submission — in which case `status` covers the work holding it, and can be `failed`. */
+        Ingestion: {
+            /** @description Stable unique identifier for this submission. */
+            ingestionId: string;
+            source: components["schemas"]["IngestionSource"];
+            /** @description Media type as received. */
+            mimeType: string;
+            /** @description ISO 8601 timestamp when the submission was accepted. */
+            receivedAt: string;
+            status: components["schemas"]["IngestionStatus"];
+            staged: components["schemas"]["IngestionStaged"];
+            intake?: components["schemas"]["IngestionIntake"];
+            /** @description ISO 8601 timestamp when all of this submission's work settled. Null until then. */
+            completedAt: string | null;
+            /** @description Why this submission did not land. Null unless `status` is `failed` or `partial`. */
+            failure: {
+                /** @description Machine-readable classification. */
+                code: string;
+                /** @description Human-readable detail. */
+                message: string;
+            } | null;
+        };
+        /**
+         * @description Version-qualified entry family. `batch/legacy` and `document/legacy` are historical only — no current route writes them.
+         * @enum {string}
+         */
+        IngestionSource: "fhir/r4" | "fhir/r5" | "cda/r2" | "session/v1" | "batch/legacy" | "document/legacy";
+        /**
+         * @description Where this submission stands, across all its work.
+         * @enum {string}
+         */
+        IngestionStatus: "pending" | "processing" | "succeeded" | "partial" | "failed";
+        /** @description What this submission staged, per entity kind. Fixed at accept and never recomputed. */
+        IngestionStaged: {
+            /** @description Clinical facts staged. */
+            facts: number;
+            /** @description Clinical events staged. */
+            events: number;
+            /** @description Prose passages staged. */
+            narratives: number;
+        };
+        /** @description What the submission held. Absent when it was not recorded. */
+        IngestionIntake: {
+            /**
+             * @description The sub-unit of this item: resources in a bundle, sections in a document, messages in a transcript.
+             * @enum {string}
+             */
+            unit: "resource" | "section" | "message";
+            /** @description Items of `unit` this one carried. */
+            received: number;
+            /** @description Grouped by kind and outcome. */
+            entries: {
+                /**
+                 * @description A FHIR `resourceType`, a CDA section code — your own token, echoed back.
+                 * @example ServiceRequest
+                 */
+                kind: string;
+                /**
+                 * @description Section title, where the kind alone does not read as one.
+                 * @example Results
+                 */
+                label?: string;
+                /** @description How many items of this kind and outcome. */
+                count: number;
+                outcome: components["schemas"]["IngestionItemOutcome"];
+                reason?: components["schemas"]["IngestionIgnoreReason"];
+            }[];
+        }[];
+        /**
+         * @description structured: clinical detail was read from it. text_only: kept, but as prose — no structured detail was read. ignored: not used at all.
+         * @enum {string}
+         */
+        IngestionItemOutcome: "structured" | "text_only" | "ignored";
+        /**
+         * @description Present only when `outcome` is `ignored`.
+         * @enum {string}
+         */
+        IngestionIgnoreReason: "unsupported" | "unusable" | "empty";
+        /** @description A FHIR Bundle or a single FHIR resource. */
+        IngestFhirBody: {
+            /**
+             * @description The FHIR resource type — `Bundle` for a collection, otherwise the resource's.
+             * @example Bundle
+             */
+            resourceType: string;
+            /** @description A Bundle's entries. Absent when the body is a single resource. */
+            entry?: unknown[];
+        } & {
+            [key: string]: unknown;
+        };
+        /** @description A page of submissions for this patient. */
+        IngestionList: {
+            /** @description The requested page of items. */
+            data: components["schemas"]["Ingestion"][];
+            /** @description Pagination metadata for the returned page. */
+            meta: {
+                /** @description Total number of items across all pages. */
+                total: number;
+                /** @description Zero-indexed page returned in `data`. */
+                page: number;
+                /** @description Page size used for this response. */
+                perPage: number;
+            };
+        };
         /** @description A session opened or confirmed by the upsert-session endpoint. */
         Session: {
             /** @description Unique identifier for this session. */
@@ -900,57 +1218,235 @@ export interface components {
             /** @description Rendered content of the VFS file in the requested format (narrative Markdown, compact Markdown, or structured JSON string). */
             content: string;
         };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
-export interface operations {
-    "get-service-info": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Service name and build identity */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ServiceInfo"];
-                };
+        /** @description A node in the patient context graph. */
+        Node: {
+            /** @enum {string} */
+            type: "extracted_fact";
+            /** @description Unique identifier for this node. */
+            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 an `extracted_fact` node. */
+            payload: {
+                [key: string]: unknown;
             };
-        };
-    };
-    "list-patients": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description List all registered patients */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["PatientList"];
-                };
+        } | {
+            /** @enum {string} */
+            type: "fact";
+            /** @description Unique identifier for this node. */
+            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 a `fact` node. */
+            payload: {
+                [key: string]: unknown;
             };
-        };
-    };
-    "get-patient": {
-        parameters: {
+        } | {
+            /** @enum {string} */
+            type: "extracted_narrative";
+            /** @description Unique identifier for this node. */
+            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 an `extracted_narrative` node. */
+            payload: {
+                [key: string]: unknown;
+            };
+        } | {
+            /** @enum {string} */
+            type: "narrative_passage";
+            /** @description Unique identifier for this node. */
+            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 a `narrative_passage` node. */
+            payload: {
+                [key: string]: unknown;
+            };
+        } | {
+            /** @enum {string} */
+            type: "narrative";
+            /** @description Unique identifier for this node. */
+            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 a `narrative` node. */
+            payload: {
+                [key: string]: unknown;
+            };
+        } | {
+            /** @enum {string} */
+            type: "learned_memory";
+            /** @description Unique identifier for this node. */
+            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 a `learned_memory` node. */
+            payload: {
+                [key: string]: unknown;
+            };
+        } | {
+            /** @enum {string} */
+            type: "extracted_clinical_event";
+            /** @description Unique identifier for this node. */
+            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 an `extracted_clinical_event` node. */
+            payload: {
+                [key: string]: unknown;
+            };
+        };
+        /** @description A page of nodes of one type from the patient context graph. */
+        NodeList: {
+            /** @description The requested page of items. */
+            data: components["schemas"]["Node"][];
+            /** @description Pagination metadata for the returned page. */
+            meta: {
+                /** @description Total number of items across all pages. */
+                total: number;
+                /** @description Zero-indexed page returned in `data`. */
+                page: number;
+                /** @description Page size used for this response. */
+                perPage: number;
+            };
+        };
+        /** @description An edge in the patient context graph. */
+        Edge: {
+            /** @enum {string} */
+            type: "resolution_decision";
+            /** @description Unique identifier for this edge. */
+            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 a `resolution_decision` edge. */
+            payload: {
+                [key: string]: unknown;
+            };
+        } | {
+            /** @enum {string} */
+            type: "resolves_to";
+            /** @description Unique identifier for this edge. */
+            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 a `resolves_to` edge. */
+            payload: {
+                [key: string]: unknown;
+            };
+        } | {
+            /** @enum {string} */
+            type: "chunked_into";
+            /** @description Unique identifier for this edge. */
+            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 a `chunked_into` edge. */
+            payload: {
+                [key: string]: unknown;
+            };
+        };
+        /** @description The node this edge originates from. */
+        NodeRef: {
+            /** @description Id of the referenced node. */
+            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. */
+            data: components["schemas"]["Edge"][];
+            /** @description Pagination metadata for the returned page. */
+            meta: {
+                /** @description Total number of items across all pages. */
+                total: number;
+                /** @description Zero-indexed page returned in `data`. */
+                page: number;
+                /** @description Page size used for this response. */
+                perPage: number;
+            };
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "get-service-info": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Service name and build identity */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ServiceInfo"];
+                };
+            };
+        };
+    };
+    "list-patients": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List all registered patients */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PatientList"];
+                };
+            };
+        };
+    };
+    "get-patient": {
+        parameters: {
             query?: never;
             header?: never;
             path: {
@@ -1354,6 +1850,242 @@ export interface operations {
             };
         };
     };
+    "ingest-fhir-r4": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        /** @description FHIR R4 Bundle or single resource to ingest. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["IngestFhirBody"];
+            };
+        };
+        responses: {
+            /** @description Submission accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Ingestion"];
+                };
+            };
+            /** @description Body is not a FHIR resource */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Patient not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Resource could not be processed */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "ingest-fhir-r5": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        /** @description FHIR R5 Bundle or single resource to ingest. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["IngestFhirBody"];
+            };
+        };
+        responses: {
+            /** @description Submission accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Ingestion"];
+                };
+            };
+            /** @description Body is not a FHIR resource */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Patient not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Resource could not be processed */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "ingest-cda-r2": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        /** @description One CDA document, or several as multipart parts. */
+        requestBody: {
+            content: {
+                "application/cda+xml": string;
+                "multipart/form-data": {
+                    documents?: string[];
+                };
+            };
+        };
+        responses: {
+            /** @description Submission accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Ingestion"];
+                };
+            };
+            /** @description A document is missing or is not a CDA document */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Patient not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Document could not be processed */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "list-ingestions": {
+        parameters: {
+            query?: {
+                /** @description Zero-indexed page of submissions to return. Defaults to 0. */
+                page?: number | null;
+                /** @description Number of submissions per page. Defaults to 100; maximum is 1000. */
+                perPage?: number;
+                /** @description Field to sort by. One of: receivedAt. Defaults to `receivedAt`. */
+                sort?: "receivedAt";
+                /** @description Sort direction. Defaults to `desc`. */
+                order?: "asc" | "desc";
+                /** @description Only return submissions in these states. Repeat the parameter or separate with commas. */
+                status?: (components["schemas"]["IngestionStatus"] & unknown)[];
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of submissions */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestionList"];
+                };
+            };
+        };
+    };
+    "get-ingestion": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Id of the submission, as returned when it was accepted. */
+                ingestionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The submission */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Ingestion"];
+                };
+            };
+            /** @description Ingestion not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
     "create-session": {
         parameters: {
             query?: never;
@@ -1703,4 +2435,275 @@ export interface operations {
             };
         };
     };
+    "get-node": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Type of node to operate on. */
+                type: "extracted_fact" | "fact" | "extracted_narrative" | "narrative_passage" | "narrative" | "learned_memory" | "extracted_clinical_event";
+                /** @description Id of the node to retrieve. */
+                nodeId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The node. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Node"];
+                };
+            };
+            /** @description `nodeId` is not a node of the given `type`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description No node with this id exists for the patient. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "list-nodes": {
+        parameters: {
+            query?: {
+                /** @description Zero-indexed page of nodes to return. Defaults to 0. */
+                page?: number | null;
+                /** @description Number of nodes per page. Defaults to 100; maximum is 1000. */
+                perPage?: number;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Type of node to operate on. */
+                type: "extracted_fact" | "fact" | "extracted_narrative" | "narrative_passage" | "narrative" | "learned_memory" | "extracted_clinical_event";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of nodes. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NodeList"];
+                };
+            };
+            /** @description Patient not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "query-nodes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Type of node to operate on. */
+                type: "extracted_fact" | "fact" | "extracted_narrative" | "narrative_passage" | "narrative" | "learned_memory" | "extracted_clinical_event";
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Zero-indexed page of facts to return. Defaults to 0.
+                     * @default 0
+                     */
+                    page?: number | null;
+                    /**
+                     * @description Number of facts per page. Defaults to 100; maximum is 1000.
+                     * @default 100
+                     */
+                    perPage?: number;
+                    /**
+                     * @description Field to sort by. One of: effectiveStart. Defaults to `effectiveStart`.
+                     * @default effectiveStart
+                     * @enum {string}
+                     */
+                    sort?: "effectiveStart";
+                    /**
+                     * @description Sort direction. Defaults to `desc`.
+                     * @default desc
+                     * @enum {string}
+                     */
+                    order?: "asc" | "desc";
+                    /** @description Conditions to filter on, ANDed together. Omitted or empty matches every fact. */
+                    filter?: {
+                        /** @description Restrict to this fact id. */
+                        id?: {
+                            /** @description Matches exactly this value. */
+                            eq: string;
+                        } | {
+                            /** @description Matches any of these values. At most 500. */
+                            any: string[];
+                        };
+                        /** @description Restrict to this fact type. */
+                        type?: {
+                            /**
+                             * @description Matches exactly this value.
+                             * @enum {string}
+                             */
+                            eq: "condition" | "medication" | "allergy" | "family_history" | "social_history" | "immunization" | "device" | "demographic" | "insurance" | "directive";
+                        } | {
+                            /** @description Matches any of these values. At most 500. */
+                            any: ("condition" | "medication" | "allergy" | "family_history" | "social_history" | "immunization" | "device" | "demographic" | "insurance" | "directive")[];
+                        };
+                    };
+                };
+            };
+        };
+        responses: {
+            /** @description A page of nodes. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NodeList"];
+                };
+            };
+            /** @description `body` does not match the given `type`'s filter/sort schema. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Patient not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Querying nodes of the given `type` is not yet supported. */
+            501: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "get-edge": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Type of edge to operate on. */
+                type: "resolution_decision" | "resolves_to" | "chunked_into";
+                /** @description Id of the edge to retrieve. */
+                edgeId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The edge. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Edge"];
+                };
+            };
+            /** @description `edgeId` is not an edge of the given `type`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description No edge with this id exists for the patient. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "list-edges": {
+        parameters: {
+            query?: {
+                /** @description Zero-indexed page of edges to return. Defaults to 0. */
+                page?: number | null;
+                /** @description Number of edges per page. Defaults to 100; maximum is 1000. */
+                perPage?: number;
+                /** @description Restrict results to edges touching the given node id(s) (same `{type}_{id}` format). One id returns every edge touching that node, in either direction. Two ids (repeat the param, e.g. `?touching=a&touching=b`) return only the edge(s) connecting exactly that pair. */
+                touching?: string | string[];
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Type of edge to operate on. */
+                type: "resolution_decision" | "resolves_to" | "chunked_into";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of edges. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EdgeList"];
+                };
+            };
+            /** @description Patient not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
 }