@clinia/context-engine-js 0.5.0-rc.0

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

@@ -0,0 +1,1706 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get service info
+         * @description Returns the service name and the build identity of the running process. Use it to confirm which build a deployment is serving.
+         */
+        get: operations["get-service-info"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List patients
+         * @description Returns all patients currently loaded in the registry. An empty array is returned if no patients have been ingested yet.
+         */
+        get: operations["list-patients"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get patient
+         * @description Returns demographic metadata and pipeline stats for a patient identified by its registry key.
+         */
+        get: operations["get-patient"];
+        /**
+         * Upsert patient
+         * @description Creates the patient entry if it does not yet exist, or returns the existing record unchanged. Fully idempotent — safe to call before or after the first ingest.
+         */
+        put: operations["upsert-patient"];
+        post?: never;
+        /**
+         * Delete patient
+         * @description Removes a patient and all associated entities, events, and relationships from the registry. Irreversible.
+         */
+        delete: operations["delete-patient"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/resolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get resolution report
+         * @description Returns the fact-resolution report for a patient: a paginated list of persisted facts of every fact type with their provenance traces, source contributions, field-level conflict resolutions, and merge confidence scores. Summary counts always cover the full graph, not just the returned page.
+         */
+        get: operations["get-resolution"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/reconciliation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get reconciliation summary
+         * @description Returns the post-pipeline reconciliation summary including entity merge stats and inferred relationships. Defaults to Markdown; pass `?format=json` for structured data.
+         */
+        get: operations["get-reconciliation"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest/fhir": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        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.
+         */
+        post: operations["ingest-fhir"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest/cda": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        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.
+         */
+        post: operations["ingest-cda"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest/document": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        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.
+         */
+        post: operations["ingest-document"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        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.
+         */
+        post: operations["ingest-batch"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get ingest status
+         * @description Returns whether the patient graph is ready to query, per-source extraction stats, aggregate load stats, and extraction warnings that did not halt ingestion. Poll this endpoint after a fire-and-forget ingest call.
+         */
+        get: operations["get-ingest-status"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest/executions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List ingest executions
+         * @description Returns a cursor-paginated list of ingest executions for a patient, ordered by start time descending. Each item includes status, source type, delta counts, and error code if failed.
+         */
+        get: operations["list-executions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/ingest/executions/{executionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get ingest execution
+         * @description Returns full detail for a single ingest execution: stage-level timings, per-entity-type and per-source delta breakdowns, entity merge count, extraction warnings, and error detail if failed.
+         */
+        get: operations["get-execution"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create session
+         * @description Opens a new query session scoped to a patient. Sessions track interaction context across multiple MCP tool calls within a single agent run.
+         */
+        post: operations["create-session"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/sessions/{sessionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get session
+         * @description Returns metadata for a session.
+         */
+        get: operations["get-session"];
+        /**
+         * Upsert a session
+         * @description Idempotently opens a session under a caller-provided id: creates it if new, or returns the existing session unchanged. Sessions track interaction context across multiple MCP tool calls within a single agent run.
+         */
+        put: operations["upsert-session"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/sessions/{sessionId}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Append session messages
+         * @description Appends user/assistant messages to an open session's transcript, in order. The session stays open. Tool-call turns are recorded separately by the MCP layer and are not accepted here.
+         */
+        post: operations["append-messages"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/sessions/{sessionId}/memories": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List session memories
+         * @description Returns the memories extracted from this session, paginated. Sorted by `createdAt` descending (newest first) by default.
+         */
+        get: operations["list-session-memories"];
+        put?: never;
+        /**
+         * Generate session memories
+         * @description Extracts memories from messages appended since the last run and infers memory↔fact relationships. The session stays active and can keep receiving messages. Append-only: it never re-extracts messages already covered by a prior run, so re-running it only adds memories for what's new, but it does not deduplicate against memories from a previous run. Call it intentionally rather than on every turn.
+         */
+        post: operations["generate-memories"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/sessions/ingest": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ingest a session transcript
+         * @description Replays a complete chat transcript as one session: creates the session, appends every message in order, then generates memories from it synchronously, so the response returns only after the patient's memories reflect the conversation. Messages can still be appended to the session. Intended for batch/replay use, not interactive sessions.
+         */
+        post: operations["ingest-session"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/vfs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Browse VFS
+         * @description Lists the contents of a VFS path. Returns directory children with name, type, and preview, or file content when the path resolves to a file. Paths are relative to the patient root (e.g. `/conditions/active`); the patient is identified by the `patientId` route param. Defaults to the root when `path` is omitted.
+         */
+        get: operations["browse-vfs"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/patients/{patientId}/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read VFS path
+         * @description Returns the content of a VFS file at the given path. Three output formats are supported: `narrative` (full Markdown, default), `compact` (condensed Markdown), and `structured` (machine-readable JSON). Use `token_budget` to cap approximate output length in tokens.
+         */
+        get: operations["read-vfs"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** @description Identity of the running service: its name and the build it came from. Reports what this process resolved at startup, which for edge builds is more specific than any released version. */
+        ServiceInfo: {
+            /** @description Display name of the service. */
+            name: string;
+            /** @description Build identity of the running process. */
+            version: {
+                /** @description Product version of the running build. Injected as `VERSION` at image build time; falls back to the server package version outside a built image. */
+                number: string;
+                /** @description Full 40-character git commit the build came from, or `unknown`. An `unknown` value means the build did not come from CI — do not read the version alone as proof of provenance. */
+                buildSha: string;
+                /** @description ISO 8601 timestamp of when the image was built, or `unknown`. */
+                buildDate: string;
+            };
+        };
+        /** @description List of patients. */
+        PatientList: {
+            /** @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;
+            /** @description Whether the patient graph has finished processing and is ready to query. */
+            ready: boolean;
+            /** @description Aggregate counts for the patient graph. Null if ingestion has not completed. */
+            stats: {
+                /** @description Total number of resolved clinical entities in the graph. */
+                entities: number;
+                /** @description Total number of clinical events in the graph. */
+                events: number;
+                /** @description Total number of typed relationship edges in the graph. */
+                relationships: number;
+            } | 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. */
+            id: string;
+            /** @description Patient display name extracted from the ingested record. */
+            name: string;
+            /** @description Patient date of birth in ISO 8601 format (YYYY-MM-DD), if present in the source. */
+            birthDate?: string;
+            /** @description Administrative gender extracted from the ingested record. */
+            gender?: string;
+            /** @description Aggregate counts for the patient graph after the most recent ingest. */
+            stats: {
+                /** @description Total number of resolved clinical entities in the graph. */
+                entities: number;
+                /** @description Total number of clinical events in the graph. */
+                events: number;
+                /** @description Total number of typed relationship edges in the graph. */
+                relationships: number;
+                /** @description Number of extraction warnings raised during the most recent ingest run. */
+                warnings: number;
+                /** @description Wall-clock time in milliseconds for the most recent graph load. */
+                loadMs: number;
+            };
+        };
+        /** @description Standard error envelope returned on all non-2xx responses. */
+        ApiError: {
+            /** @description HTTP status code. */
+            code: number;
+            /**
+             * @description Machine-readable error classification.
+             * @enum {string}
+             */
+            type: "ALREADY_EXISTS" | "FAILED_PRECONDITION" | "INTERNAL" | "INVALID_ARGUMENT" | "NOT_FOUND" | "OUT_OF_RANGE" | "UNIMPLEMENTED" | "UNAUTHENTICATED" | "PERMISSION_DENIED" | "CONTENT_TOO_LARGE" | "UNSUPPORTED_MEDIA_TYPE";
+            /** @description Human-readable error detail. */
+            message: string;
+        };
+        /** @description Patient. */
+        Patient: {
+            /** @description Id of the patient. */
+            id: string;
+            /** @description ISO 8601 timestamp when the patient was first registered. */
+            createdAt: string;
+            /** @description ISO 8601 timestamp when the patient record was last updated. */
+            updatedAt: string;
+        };
+        /** @description Full fact-resolution report for a patient: every persisted fact with its complete provenance trace and field-level conflict resolutions. */
+        ResolutionReport: {
+            /** @description Aggregate resolution stats. Null if resolution has not run. */
+            summary: {
+                /** @description Total number of facts in the graph after resolution. */
+                totalFacts: number;
+                /** @description Total number of clinical events in the graph. */
+                totalEvents: number;
+                /** @description Number of facts carrying more than one contributing source after resolution. */
+                mergedFacts: number;
+                /** @description Number of resolution warnings raised. */
+                warningCount: number;
+                /** @description Wall-clock time in milliseconds for the resolution pass. */
+                loadMs: number;
+            } | null;
+            /** @description Pagination metadata for the `facts` array. Null if resolution has not run. */
+            meta: {
+                /** @description Total number of facts across all pages. */
+                total: number;
+                /** @description Zero-indexed page returned in `facts`. */
+                page: number;
+                /** @description Page size used for this response. */
+                perPage: number;
+            } | null;
+            /** @description The requested page of persisted facts — every fact type, single- or multi-source — with provenance and conflict resolution details. Ordered by fact type (alphabetical), then display. */
+            facts: {
+                /** @description Stable fact ID assigned by the resolution engine. */
+                id: string;
+                /** @description Fact type (e.g., "condition", "medication", "immunization"). */
+                type: string;
+                /** @description Human-readable display name for the fact. */
+                display: string;
+                /** @description Complete provenance trace for this fact. Resolution always persists one; a null value indicates a server-side bug and is logged as an error. */
+                provenance: {
+                    /** @description Resolution layer that produced this fact (e.g., deterministic-code, nlp-normalization, llm-adjudication, novel-entity). */
+                    resolvedBy: string;
+                    /** @description Resolution confidence score between 0 and 1. */
+                    confidence: number;
+                    /** @description Human-readable explanation of why sources were merged or kept separate. */
+                    reasoning: string;
+                    /** @description Contributing source records folded into this fact. */
+                    sources: {
+                        /** @description Reference to the contributing source record (e.g., "Condition/abc"). */
+                        origin: string;
+                        /** @description Format of the contributing source (e.g., "fhir", "cda"). */
+                        type: string;
+                        /** @description Reliability weight assigned to this source, between 0 and 1. */
+                        reliability: number;
+                    }[];
+                    /** @description Field-level conflicts detected across sources, with the winning value and resolution strategy. */
+                    conflicts: {
+                        /** @description Name of the conflicting field. */
+                        field: string;
+                        /** @description All candidate values from contributing sources. */
+                        values: {
+                            /** @description Candidate field value. */
+                            value: string;
+                            /** @description Label of the source that contributed this value. */
+                            source: string;
+                            /** @description ISO 8601 timestamp when this value was recorded at the source, if known. */
+                            date: string | null;
+                        }[];
+                        /** @description The value selected as authoritative after conflict resolution. */
+                        winner: string;
+                        /** @description Conflict resolution strategy applied (e.g., most-recent, highest-reliability, llm). */
+                        strategy: string;
+                        /** @description Human-readable explanation of why the winning value was selected. */
+                        explanation: string;
+                    }[];
+                } | null;
+            }[];
+            /** @description Extraction warnings raised during the resolution pass. */
+            warnings: {
+                /** @description Label of the ingest source that produced the warning. */
+                source: string;
+                /** @description Identifier of the resource or record that triggered the warning. */
+                id: string;
+                /** @description Human-readable warning message. */
+                message: string;
+                /** @description Warning severity level (info, warn, or error). */
+                severity: string;
+            }[];
+            /** @description Top-level error message if resolution failed entirely. */
+            error?: string;
+        };
+        /** @description Post-pipeline reconciliation summary including merge stats and inferred relationships. */
+        ReconciliationData: {
+            /** @description Display name of the patient this reconciliation summary belongs to. */
+            patientName: string;
+            /** @description Aggregate counts from the reconciliation pass. */
+            stats: {
+                /** @description Number of raw entities before resolution. */
+                inputEntities: number;
+                /** @description Number of entities after resolution (input minus merged duplicates). */
+                resolvedEntities: number;
+                /** @description Number of merge groups where two or more source records were collapsed into one entity. */
+                mergedGroups: number;
+                /** @description Number of relationships extracted directly from source records. */
+                explicitRelationships: number;
+                /** @description Number of relationships inferred by the pipeline from clinical knowledge. */
+                inferredRelationships: number;
+            };
+            /** @description Entities where two or more source records were merged by resolution. */
+            mergedEntities: {
+                /** @description Display name of the merged entity. */
+                display: string;
+                /** @description Clinical entity type (e.g., Condition, Medication, Observation). */
+                type: string;
+                /** @description Number of source records that were merged into this entity. */
+                sourceCount: number;
+                /** @description Resolution strategy that produced the merge. */
+                resolvedBy: string;
+                /** @description Merge confidence score between 0 and 1. */
+                confidence: number;
+                /** @description Human-readable explanation of why these records were merged. */
+                reasoning: string;
+            }[];
+            /** @description Relationships inferred by the pipeline that were not explicit in any source record. */
+            inferredRelationships: {
+                /** @description Display name of the source entity in the relationship. */
+                fromDisplay: string;
+                /** @description Display name of the target entity in the relationship. */
+                toDisplay: string;
+                /** @description Relationship type (e.g., has_complication, prescribed_for, monitors). */
+                type: string;
+                /** @description Inference confidence score between 0 and 1. */
+                confidence: number;
+                /** @description Human-readable explanation of why this relationship was inferred. */
+                reasoning: string;
+            }[];
+        };
+        /** @description Response returned immediately on ingest submission, containing the execution ID and current status. */
+        IngestExecutionEnvelope: {
+            /** @description Unique identifier for this ingest execution. Use with the executions endpoints to poll status or retrieve detail. */
+            executionId: string;
+            status: components["schemas"]["IngestExecutionStatus"];
+            sourceLabel: components["schemas"]["IngestSourceLabel"];
+            /** @description Graph changes produced by this execution. Null if the execution has not yet completed. */
+            deltas: {
+                /** @description Number of new clinical entities added to the graph. */
+                entitiesAdded: number;
+                /** @description Number of new clinical events added to the graph. */
+                eventsAdded: number;
+                /** @description Number of new relationship edges added to the graph. */
+                relsAdded: number;
+            } | null;
+            /** @description Number of extraction warnings raised during this execution. */
+            warningsCount: number;
+            /** @description Error detail if the execution failed. Null on success. */
+            error: {
+                /** @description Machine-readable error code. */
+                code: string;
+                /** @description Human-readable error message. */
+                message: string;
+            } | null;
+            /** @description Human-readable reason the execution was skipped (e.g., duplicate payload). Null if not skipped. */
+            skippedReason: string | null;
+            patient: components["schemas"]["PatientRef"];
+            /** @description Hypermedia links for follow-up requests. */
+            links: {
+                /** @description URL to retrieve this execution's detail. */
+                self: string;
+                /** @description URL to retrieve the patient record. */
+                patient: string;
+            };
+        };
+        /**
+         * @description Current execution status.
+         * @enum {string}
+         */
+        IngestExecutionStatus: "pending" | "running" | "succeeded" | "failed" | "skipped";
+        /**
+         * @description Ingest source type that was submitted.
+         * @enum {string}
+         */
+        IngestSourceLabel: "fhir" | "cda" | "document" | "batch";
+        /** @description Patient reference resolved from the ingested record. */
+        PatientRef: {
+            /** @description Internal patient ID extracted from the ingested record. Used in VFS paths. */
+            id: string;
+            /** @description Patient display name extracted from the ingested record. */
+            name: string;
+        } | null;
+        /** @description Registration payload for an unstructured document. */
+        IngestDocumentBody: {
+            /**
+             * @description File name of the document, including extension. Used as the source label in the ingest status and execution history.
+             * @example discharge-summary.pdf
+             */
+            name: string;
+            /**
+             * @description MIME type of the document (e.g., application/pdf, text/plain). Used to determine how the document is stored and referenced.
+             * @example application/pdf
+             */
+            mimeType?: string;
+        };
+        /** @description Mixed batch of FHIR bundles, CDA documents, and unstructured document registrations to process in a single ingest request. */
+        IngestBatchBody: {
+            /** @description FHIR R4 Bundles or single resources */
+            fhir?: {
+                [key: string]: unknown;
+            }[];
+            /** @description CDA/C-CDA XML document strings */
+            cda?: string[];
+            /** @description Unstructured documents to register in this batch. Each entry is an IngestDocumentBody with name and MIME type. */
+            documents?: components["schemas"]["IngestDocumentBody"][];
+        };
+        /** @description Aggregate ingest status for a patient, including graph readiness, per-source extraction stats, load metrics, and patient reference. */
+        IngestStatusResponse: {
+            /** @description Whether the patient graph has finished all ingest processing and is ready to query. */
+            ready: boolean;
+            /** @description Per-source breakdown of extraction stats, one entry per distinct ingest source. */
+            sources: {
+                /** @description Human-readable source label (e.g., "FHIR Bundle", "Summary_20230907.xml"). */
+                label: string;
+                stats: components["schemas"]["IngestStats"];
+            }[];
+            patient: components["schemas"]["PatientRef"] & unknown;
+            /** @description Aggregate extraction counts from the most recent graph load. Null if no graph load has completed. */
+            loadStats: {
+                /** @description Total number of clinical entities extracted across all sources. */
+                entitiesExtracted: number;
+                /** @description Total number of clinical events extracted across all sources. */
+                eventsExtracted: number;
+                /** @description Total number of relationship edges extracted across all sources. */
+                relationshipsExtracted: number;
+            } | null;
+            /** @description Wall-clock time in milliseconds for the most recent graph load. */
+            loadMs: number;
+        };
+        /** @description Extraction counts for this source. */
+        IngestStats: {
+            /** @description Number of top-level items (resources or records) scanned in the source. */
+            itemsScanned: number;
+        };
+        /** @description Cursor-paginated list of ingest executions for a patient. */
+        IngestExecutionList: {
+            /** @description Ordered list of execution summaries, newest first. */
+            executions: components["schemas"]["IngestExecutionListItem"][];
+            /** @description Opaque cursor to pass as `cursor` in the next request to retrieve the following page. Null when no further pages remain. */
+            nextCursor: number | null;
+        };
+        /** @description Summary of a single ingest execution as returned in the execution list. */
+        IngestExecutionListItem: {
+            /** @description Unique identifier for this execution. */
+            id: string;
+            sourceLabel: components["schemas"]["IngestSourceLabel"] & unknown;
+            status: components["schemas"]["IngestExecutionStatus"] & unknown;
+            /** @description Unix timestamp (milliseconds) when the execution started. */
+            startedAt: number;
+            /** @description Unix timestamp (milliseconds) when the execution reached a terminal status. Null if still in progress. */
+            finishedAt: number | null;
+            /** @description SHA-256 hash of the submitted payload. Used for duplicate detection. Null if hashing is not supported for this source type. */
+            payloadHash: string | null;
+            /** @description Aggregate graph changes produced by this execution. */
+            deltasSummary: {
+                /** @description Number of new clinical entities added to the graph. */
+                entitiesAdded: number;
+                /** @description Number of new clinical events added to the graph. */
+                eventsAdded: number;
+                /** @description Number of new relationship edges added to the graph. */
+                relsAdded: number;
+            };
+            /** @description Number of LLM inference calls consumed by this execution. */
+            llmCallsUsed: number;
+            /** @description Machine-readable error code if the execution failed. Null on success. */
+            errorCode: string | null;
+            /** @description Human-readable reason the execution was skipped. Null if not skipped. */
+            skippedReason: string | null;
+        };
+        /** @description Full detail for a single ingest execution, including stage timings, per-type and per-source delta breakdowns, warnings, and error detail. */
+        IngestExecutionDetail: {
+            execution: components["schemas"]["IngestExecutionListItem"] & unknown;
+            /** @description Wall-clock duration in milliseconds for each named pipeline stage (e.g., parse, extract, resolve, load). */
+            stageTimings: {
+                [key: string]: number;
+            };
+            /** @description Full graph delta breakdown for this execution, split by entity type and by source. */
+            deltasFull: {
+                /** @description Count of entities added, keyed by clinical entity type (e.g., Condition, Medication). */
+                byEntityType: {
+                    [key: string]: number;
+                };
+                /** @description Delta counts keyed by source label, showing how much each individual source contributed. */
+                bySource: {
+                    [key: string]: {
+                        /** @description Number of new clinical entities added to the graph. */
+                        entitiesAdded: number;
+                        /** @description Number of new clinical events added to the graph. */
+                        eventsAdded: number;
+                        /** @description Number of new relationship edges added to the graph. */
+                        relsAdded: number;
+                    };
+                };
+                /** @description Number of entity pairs that were merged by resolution during this execution. */
+                entitiesMerged: number;
+            };
+            /** @description Extraction warnings raised during this execution that did not halt processing. */
+            warnings: {
+                /** @description Label of the ingest source that produced the warning. */
+                source: string;
+                /** @description Identifier of the resource or record that triggered the warning. */
+                id?: string;
+                /** @description Human-readable warning message. */
+                message: string;
+                /**
+                 * @description Warning severity level.
+                 * @enum {string}
+                 */
+                severity: "info" | "warn" | "error";
+            }[];
+            /** @description Structured error detail if the execution failed. Null on success. */
+            errorDetail: {
+                /** @description Machine-readable error code. */
+                code: string;
+                /** @description Human-readable error message. */
+                message: string;
+                /** @description Extended diagnostic detail, if available. */
+                detail?: string;
+            } | null;
+        };
+        /** @description A session opened or confirmed by the upsert-session endpoint. */
+        Session: {
+            /** @description Unique identifier for this session. */
+            sessionId: string;
+            /** @description Unique identifier for the patient this session is scoped to. */
+            patientId: string;
+            /** @description ISO 8601 timestamp when the session was created. */
+            createdAt: string;
+        };
+        /** @description Messages to append to an open session. */
+        AppendMessagesBody: {
+            /** @description Messages to append to the session, in chronological order. */
+            messages: {
+                /**
+                 * @description Author of the message.
+                 * @enum {string}
+                 */
+                role: "user" | "assistant";
+                /** @description Message text. */
+                content: string;
+            }[];
+        };
+        /** @description A page of memories extracted from a session. */
+        SessionMemoryList: {
+            /** @description The requested page of items. */
+            data: components["schemas"]["SessionMemory"][];
+            /** @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 memory extracted from a chat session's transcript. */
+        SessionMemory: {
+            /** @description Stable unique identifier for this memory. */
+            id: string;
+            /**
+             * @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 Id of the chat session that produced this memory. */
+            sessionId: string;
+            /** @description ISO 8601 timestamp when this memory was recorded. */
+            createdAt: string;
+        };
+        /** @description A complete chat transcript to ingest as a single closed session. */
+        IngestSessionBody: {
+            /** @description Full transcript to replay, in chronological order. */
+            messages: {
+                /**
+                 * @description Author of the message.
+                 * @enum {string}
+                 */
+                role: "user" | "assistant";
+                /** @description Message text. */
+                content: string;
+            }[];
+        };
+        /** @description Result of a VFS browse operation. Contains directory children when the path resolves to a directory, or file content metadata when it resolves to a file. */
+        BrowseResult: {
+            /** @description VFS path of the browsed node, relative to the patient root. */
+            path: string;
+            /**
+             * @description Whether the browsed node is a directory or a file.
+             * @enum {string}
+             */
+            type: "directory" | "file";
+            /** @description Immediate children of this directory. Present when type is `directory`, absent when type is `file`. */
+            children?: {
+                /** @description Name of the child node (filename or directory name). */
+                name: string;
+                /**
+                 * @description Whether this child is a directory or a file.
+                 * @enum {string}
+                 */
+                type: "directory" | "file";
+                /** @description Short content preview for file nodes. Absent for directories. */
+                preview?: string;
+            }[];
+            /** @description Full content of the file node. Present when type is `file`, absent for directories. */
+            content?: string;
+        };
+        /** @description Content returned from a VFS read operation. */
+        ReadResponse: {
+            /** @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"];
+                };
+            };
+        };
+    };
+    "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: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Patient metadata and stats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PatientDetail"];
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "upsert-patient": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Patient created or confirmed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Patient"];
+                };
+            };
+        };
+    };
+    "delete-patient": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Patient deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Patient not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "get-resolution": {
+        parameters: {
+            query?: {
+                /** @description Zero-indexed page of facts to return. Defaults to 0. */
+                page?: number | null;
+                /** @description Number of facts per page. Defaults to 100; maximum is 1000. */
+                perPage?: number;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Entity resolution report */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ResolutionReport"];
+                };
+            };
+            /** @description Patient not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "get-reconciliation": {
+        parameters: {
+            query?: {
+                /** @description Response format. `json` returns a structured ReconciliationData object; `markdown` (default) returns a human-readable plain-text report. */
+                format?: "json" | "markdown";
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Reconciliation summary. Returns JSON when ?format=json, Markdown (text/plain) otherwise. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReconciliationData"];
+                    "text/plain": string;
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "ingest-fhir": {
+        parameters: {
+            query?: {
+                /** @description Block up to this many ms for the execution to reach terminal status. 0 or omitted = return immediately with current status. */
+                wait?: number | null;
+            };
+            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": {
+                    [key: string]: unknown;
+                };
+            };
+        };
+        responses: {
+            /** @description Ingest execution accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestExecutionEnvelope"];
+                };
+            };
+            /** @description Failed to parse FHIR resource */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "ingest-cda": {
+        parameters: {
+            query?: {
+                /** @description Block up to this many ms for the execution to reach terminal status. 0 or omitted = return immediately with current status. */
+                wait?: number | null;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        /** @description CDA/C-CDA XML document to ingest. Must be a non-empty XML string. */
+        requestBody: {
+            content: {
+                "text/plain": string;
+            };
+        };
+        responses: {
+            /** @description Ingest execution accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestExecutionEnvelope"];
+                };
+            };
+            /** @description Empty request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+            /** @description Failed to parse CDA document */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "ingest-document": {
+        parameters: {
+            query?: {
+                /** @description Block up to this many ms for the execution to reach terminal status. 0 or omitted = return immediately with current status. */
+                wait?: number | null;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        /** @description Document registration payload containing the file name and optional MIME type. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["IngestDocumentBody"];
+            };
+        };
+        responses: {
+            /** @description Document ingest execution accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestExecutionEnvelope"];
+                };
+            };
+        };
+    };
+    "ingest-batch": {
+        parameters: {
+            query?: {
+                /** @description Block up to this many ms for the execution to reach terminal status. 0 or omitted = return immediately with current status. */
+                wait?: number | null;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        /** @description Batch payload containing any combination of FHIR bundles, CDA documents, and document registrations. At least one of `fhir`, `cda`, or `documents` must be non-empty. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["IngestBatchBody"];
+            };
+        };
+        responses: {
+            /** @description Batch ingest execution accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestExecutionEnvelope"];
+                };
+            };
+            /** @description No valid input provided */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "get-ingest-status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current ingest status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestStatusResponse"];
+                };
+            };
+        };
+    };
+    "list-executions": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of executions to return per page. Defaults to 50; maximum is 200. */
+                limit?: number;
+                /** @description Pagination cursor returned as `nextCursor` from the previous page. Omit to start from the most recent execution. */
+                cursor?: number | null;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated execution history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestExecutionList"];
+                };
+            };
+        };
+    };
+    "get-execution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Unique execution ID returned in the IngestExecutionEnvelope or execution list. */
+                executionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Execution detail with stage timings, full deltas, and warnings */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestExecutionDetail"];
+                };
+            };
+            /** @description Execution not found (or already retention-pruned) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "create-session": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Session"];
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "get-session": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Unique session ID returned when the session was created. */
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session info */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Session"];
+                };
+            };
+            /** @description Session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "upsert-session": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Unique session ID returned when the session was created. */
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session confirmed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Session"];
+                };
+            };
+            /** @description Session created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Session"];
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "append-messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Unique session ID returned when the session was created. */
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AppendMessagesBody"];
+            };
+        };
+        responses: {
+            /** @description Messages appended */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Always `true` when the messages were appended. */
+                        ok: boolean;
+                        /** @description Number of messages appended. */
+                        messageCount: number;
+                    };
+                };
+            };
+            /** @description Patient or session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "list-session-memories": {
+        parameters: {
+            query?: {
+                /** @description Zero-indexed page of memories to return. Defaults to 0. */
+                page?: number | null;
+                /** @description Number of memories per page. Defaults to 100; maximum is 1000. */
+                perPage?: number;
+                /** @description Field to sort by. One of: createdAt. Defaults to `createdAt`. */
+                sort?: "createdAt";
+                /** @description Sort direction. Defaults to `desc`. */
+                order?: "asc" | "desc";
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Unique session ID returned when the session was created. */
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session memories */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SessionMemoryList"];
+                };
+            };
+            /** @description Patient or session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "generate-memories": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+                /** @description Unique session ID returned when the session was created. */
+                sessionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Memories generated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Always `true` when generation succeeded. */
+                        ok: boolean;
+                    };
+                };
+            };
+            /** @description Patient or session not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "ingest-session": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["IngestSessionBody"];
+            };
+        };
+        responses: {
+            /** @description Session ingested and closed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Always `true` when the session was ingested successfully. */
+                        ok: boolean;
+                        /** @description ID of the session that was created and closed. */
+                        sessionId: string;
+                        /** @description Number of messages appended to the session. */
+                        messageCount: number;
+                    };
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "browse-vfs": {
+        parameters: {
+            query?: {
+                /** @description VFS path to browse, relative to the patient root (e.g. `/conditions/active`). Defaults to the root when omitted. */
+                path?: string;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description VFS browse result */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BrowseResult"];
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+    "read-vfs": {
+        parameters: {
+            query?: {
+                /** @description VFS path of the file to read, relative to the patient root (e.g. `/conditions/active`). Defaults to the root when omitted. */
+                path?: string;
+                /** @description Output format. `narrative` (default) returns full Markdown; `compact` returns condensed Markdown; `structured` returns machine-readable JSON. */
+                format?: "narrative" | "structured" | "compact";
+                /** @description Approximate token budget for the response */
+                token_budget?: number;
+            };
+            header?: never;
+            path: {
+                /** @description ID of the patient */
+                patientId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description VFS path content */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ReadResponse"];
+                };
+            };
+            /** @description Patient not found or no data ingested */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiError"];
+                };
+            };
+        };
+    };
+}