phenoml 12.3.0 → 12.5.0

package/dist/cjs/BaseClient.js

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

package/dist/cjs/api/resources/construe/types/CodeCategory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A higher-level grouping (e.g. HPO category) for an extracted code.
+ */
+export interface CodeCategory {
+    /** Identifier for the category term (e.g. an HPO URI). */
+    uri: string;
+    /** Human-readable label for the category term. */
+    label: string;
+}

package/dist/cjs/api/resources/construe/types/CodeCategory.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/types/ExtractRequestConfig.d.ts

@@ -6,6 +6,10 @@ export interface ExtractRequestConfig {
      * * paragraphs / topics / soap_note - LLM-based chunking.
      * * clinical_ner_extract - Extract clinical concepts (problems, tests,
      *   treatments) and use each as a chunk (supports citations).
+     * * fasthpocr - Extract HPO concepts directly with category
+     *   annotations (supports citations). Requires `system: HPO`;
+     *   other systems are rejected. Causes most other config options
+     *   to be ignored.
      */
     chunking_method?: ExtractRequestConfig.ChunkingMethod | undefined;
     /**
@@ -39,7 +43,7 @@ export interface ExtractRequestConfig {
     /**
      * Whether to include source text citations for each extracted code.
      * Citations show the exact text spans (with character offsets) that led to each code.
-     * Supported when chunking_method is "sentences" or "clinical_ner_extract".
+     * Supported when chunking_method is "sentences", "clinical_ner_extract", or "fasthpocr".
      */
     include_citations?: boolean | undefined;
     /**
@@ -78,6 +82,10 @@ export declare namespace ExtractRequestConfig {
      * * paragraphs / topics / soap_note - LLM-based chunking.
      * * clinical_ner_extract - Extract clinical concepts (problems, tests,
      *   treatments) and use each as a chunk (supports citations).
+     * * fasthpocr - Extract HPO concepts directly with category
+     *   annotations (supports citations). Requires `system: HPO`;
+     *   other systems are rejected. Causes most other config options
+     *   to be ignored.
      */
     const ChunkingMethod: {
         readonly None: "none";
@@ -86,6 +94,7 @@ export declare namespace ExtractRequestConfig {
         readonly Topics: "topics";
         readonly SoapNote: "soap_note";
         readonly ClinicalNerExtract: "clinical_ner_extract";
+        readonly Fasthpocr: "fasthpocr";
     };
     type ChunkingMethod = (typeof ChunkingMethod)[keyof typeof ChunkingMethod];
     /**

package/dist/cjs/api/resources/construe/types/ExtractRequestConfig.js

@@ -11,6 +11,10 @@ var ExtractRequestConfig;
      * * paragraphs / topics / soap_note - LLM-based chunking.
      * * clinical_ner_extract - Extract clinical concepts (problems, tests,
      *   treatments) and use each as a chunk (supports citations).
+     * * fasthpocr - Extract HPO concepts directly with category
+     *   annotations (supports citations). Requires `system: HPO`;
+     *   other systems are rejected. Causes most other config options
+     *   to be ignored.
      */
     ExtractRequestConfig.ChunkingMethod = {
         None: "none",
@@ -19,6 +23,7 @@ var ExtractRequestConfig;
         Topics: "topics",
         SoapNote: "soap_note",
         ClinicalNerExtract: "clinical_ner_extract",
+        Fasthpocr: "fasthpocr",
     };
     /**
      * Method for validating extracted codes:

package/dist/cjs/api/resources/construe/types/ExtractedCodeResult.d.ts

@@ -19,4 +19,9 @@ export interface ExtractedCodeResult {
      * Ancestor codes do not receive citations.
      */
     citations?: phenoml.construe.Citation[] | undefined;
+    /**
+     * Higher-level groupings the extracted code belongs to (e.g. HPO category terms).
+     * Only populated by full-extraction chunking methods such as "fasthpocr".
+     */
+    categories?: phenoml.construe.CodeCategory[] | undefined;
 }

package/dist/cjs/api/resources/construe/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./Citation.js";
+export * from "./CodeCategory.js";
 export * from "./CodeResponse.js";
 export * from "./CodeSystemDetails.js";
 export * from "./CodeSystemInfo.js";

package/dist/cjs/api/resources/construe/types/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Citation.js"), exports);
+__exportStar(require("./CodeCategory.js"), exports);
 __exportStar(require("./CodeResponse.js"), exports);
 __exportStar(require("./CodeSystemDetails.js"), exports);
 __exportStar(require("./CodeSystemInfo.js"), exports);

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

@@ -43,7 +43,7 @@ export declare class Lang2FhirClient {
      *
      * @example
      *     await client.lang2Fhir.createMulti({
-     *         text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+     *         text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
      *     })
      */
     createMulti(request: phenoml.lang2Fhir.CreateMultiRequest, requestOptions?: Lang2FhirClient.RequestOptions): core.HttpResponsePromise<phenoml.lang2Fhir.CreateMultiResponse>;

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

@@ -130,7 +130,7 @@ class Lang2FhirClient {
      *
      * @example
      *     await client.lang2Fhir.createMulti({
-     *         text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+     *         text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
      *     })
      */
     createMulti(request, requestOptions) {

package/dist/cjs/api/resources/lang2Fhir/client/requests/CreateMultiRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+ *         text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
  *     }
  */
 export interface CreateMultiRequest {
@@ -15,6 +15,8 @@ export interface CreateMultiRequest {
     implementation_guide?: string;
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
     detection_effort?: CreateMultiRequest.DetectionEffort;
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    validation_method?: CreateMultiRequest.ValidationMethod;
 }
 export declare namespace CreateMultiRequest {
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
@@ -23,4 +25,11 @@ export declare namespace CreateMultiRequest {
         readonly Deep: "deep";
     };
     type DetectionEffort = (typeof DetectionEffort)[keyof typeof DetectionEffort];
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    const ValidationMethod: {
+        readonly None: "none";
+        readonly Check: "check";
+        readonly Fix: "fix";
+    };
+    type ValidationMethod = (typeof ValidationMethod)[keyof typeof ValidationMethod];
 }

package/dist/cjs/api/resources/lang2Fhir/client/requests/CreateMultiRequest.js

@@ -9,4 +9,10 @@ var CreateMultiRequest;
         Standard: "standard",
         Deep: "deep",
     };
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    CreateMultiRequest.ValidationMethod = {
+        None: "none",
+        Check: "check",
+        Fix: "fix",
+    };
 })(CreateMultiRequest || (exports.CreateMultiRequest = CreateMultiRequest = {}));

package/dist/cjs/api/resources/lang2Fhir/client/requests/DocumentMultiRequest.d.ts

@@ -20,6 +20,8 @@ export interface DocumentMultiRequest {
     implementation_guide?: string;
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
     detection_effort?: DocumentMultiRequest.DetectionEffort;
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    validation_method?: DocumentMultiRequest.ValidationMethod;
 }
 export declare namespace DocumentMultiRequest {
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
@@ -28,4 +30,11 @@ export declare namespace DocumentMultiRequest {
         readonly Deep: "deep";
     };
     type DetectionEffort = (typeof DetectionEffort)[keyof typeof DetectionEffort];
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    const ValidationMethod: {
+        readonly None: "none";
+        readonly Check: "check";
+        readonly Fix: "fix";
+    };
+    type ValidationMethod = (typeof ValidationMethod)[keyof typeof ValidationMethod];
 }

package/dist/cjs/api/resources/lang2Fhir/client/requests/DocumentMultiRequest.js

@@ -9,4 +9,10 @@ var DocumentMultiRequest;
         Standard: "standard",
         Deep: "deep",
     };
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    DocumentMultiRequest.ValidationMethod = {
+        None: "none",
+        Check: "check",
+        Fix: "fix",
+    };
 })(DocumentMultiRequest || (exports.DocumentMultiRequest = DocumentMultiRequest = {}));

package/dist/cjs/api/resources/lang2Fhir/types/CreateMultiResponse.d.ts

@@ -7,6 +7,8 @@ export interface CreateMultiResponse {
     bundle?: CreateMultiResponse.Bundle | undefined;
     /** Summary of extracted resources */
     resources?: CreateMultiResponse.Resources.Item[] | undefined;
+    /** FHIR validation results. Present when validation_method is 'check' or 'fix'. Contains results from each validation pass. For 'check', there is one pass. For 'fix', there may be up to 3 passes as the system attempts auto-correction. */
+    validation?: CreateMultiResponse.Validation | undefined;
 }
 export declare namespace CreateMultiResponse {
     /**
@@ -44,4 +46,65 @@ export declare namespace CreateMultiResponse {
             description?: string | undefined;
         }
     }
+    /**
+     * FHIR validation results. Present when validation_method is 'check' or 'fix'. Contains results from each validation pass. For 'check', there is one pass. For 'fix', there may be up to 3 passes as the system attempts auto-correction.
+     */
+    interface Validation {
+        /** Results from each validation pass, in chronological order */
+        passes?: Validation.Passes.Item[] | undefined;
+        /** Whether validation errors were successfully fixed by the LLM. Always false for 'check' mode. For 'fix' mode, true if errors were resolved and the returned bundle is the corrected version. */
+        fixed?: boolean | undefined;
+        /** Total number of validation passes run (1 for check, 1-3 for fix) */
+        attempts?: number | undefined;
+        /** Human-readable summary of the validation outcome */
+        summary?: string | undefined;
+    }
+    namespace Validation {
+        type Passes = Passes.Item[];
+        namespace Passes {
+            interface Item {
+                /** Validation issues found in this pass */
+                issues?: Item.Issues.Item[] | undefined;
+                /** Validation statistics for this pass */
+                stats?: Item.Stats | undefined;
+            }
+            namespace Item {
+                type Issues = Issues.Item[];
+                namespace Issues {
+                    interface Item {
+                        /** Issue severity level */
+                        severity?: Item.Severity | undefined;
+                        /** Issue type code */
+                        code?: string | undefined;
+                        /** Human-readable description of the issue */
+                        diagnostics?: string | undefined;
+                        /** FHIRPath expression(s) pointing to the issue location */
+                        expression?: string[] | undefined;
+                        /** Validation phase that generated this issue */
+                        source?: string | undefined;
+                    }
+                    namespace Item {
+                        /** Issue severity level */
+                        const Severity: {
+                            readonly Fatal: "fatal";
+                            readonly Error: "error";
+                            readonly Warning: "warning";
+                            readonly Information: "information";
+                        };
+                        type Severity = (typeof Severity)[keyof typeof Severity];
+                    }
+                }
+                /**
+                 * Validation statistics for this pass
+                 */
+                interface Stats {
+                    resource_type?: string | undefined;
+                    profile_url?: string | undefined;
+                    is_custom_profile?: boolean | undefined;
+                    /** Validation duration in milliseconds */
+                    duration_ms?: number | undefined;
+                }
+            }
+        }
+    }
 }

package/dist/cjs/api/resources/lang2Fhir/types/CreateMultiResponse.js

@@ -1,3 +1,29 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateMultiResponse = void 0;
+var CreateMultiResponse;
+(function (CreateMultiResponse) {
+    let Validation;
+    (function (Validation) {
+        let Passes;
+        (function (Passes) {
+            let Item;
+            (function (Item_1) {
+                let Issues;
+                (function (Issues) {
+                    let Item;
+                    (function (Item) {
+                        /** Issue severity level */
+                        Item.Severity = {
+                            Fatal: "fatal",
+                            Error: "error",
+                            Warning: "warning",
+                            Information: "information",
+                        };
+                    })(Item = Issues.Item || (Issues.Item = {}));
+                })(Issues = Item_1.Issues || (Item_1.Issues = {}));
+            })(Item = Passes.Item || (Passes.Item = {}));
+        })(Passes = Validation.Passes || (Validation.Passes = {}));
+    })(Validation = CreateMultiResponse.Validation || (CreateMultiResponse.Validation = {}));
+})(CreateMultiResponse || (exports.CreateMultiResponse = CreateMultiResponse = {}));

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "12.3.0";
+export declare const SDK_VERSION = "12.5.0";

package/dist/cjs/version.js

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

package/dist/esm/BaseClient.mjs

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

package/dist/esm/api/resources/construe/types/CodeCategory.d.mts

@@ -0,0 +1,9 @@
+/**
+ * A higher-level grouping (e.g. HPO category) for an extracted code.
+ */
+export interface CodeCategory {
+    /** Identifier for the category term (e.g. an HPO URI). */
+    uri: string;
+    /** Human-readable label for the category term. */
+    label: string;
+}

package/dist/esm/api/resources/construe/types/CodeCategory.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/construe/types/ExtractRequestConfig.d.mts

@@ -6,6 +6,10 @@ export interface ExtractRequestConfig {
      * * paragraphs / topics / soap_note - LLM-based chunking.
      * * clinical_ner_extract - Extract clinical concepts (problems, tests,
      *   treatments) and use each as a chunk (supports citations).
+     * * fasthpocr - Extract HPO concepts directly with category
+     *   annotations (supports citations). Requires `system: HPO`;
+     *   other systems are rejected. Causes most other config options
+     *   to be ignored.
      */
     chunking_method?: ExtractRequestConfig.ChunkingMethod | undefined;
     /**
@@ -39,7 +43,7 @@ export interface ExtractRequestConfig {
     /**
      * Whether to include source text citations for each extracted code.
      * Citations show the exact text spans (with character offsets) that led to each code.
-     * Supported when chunking_method is "sentences" or "clinical_ner_extract".
+     * Supported when chunking_method is "sentences", "clinical_ner_extract", or "fasthpocr".
      */
     include_citations?: boolean | undefined;
     /**
@@ -78,6 +82,10 @@ export declare namespace ExtractRequestConfig {
      * * paragraphs / topics / soap_note - LLM-based chunking.
      * * clinical_ner_extract - Extract clinical concepts (problems, tests,
      *   treatments) and use each as a chunk (supports citations).
+     * * fasthpocr - Extract HPO concepts directly with category
+     *   annotations (supports citations). Requires `system: HPO`;
+     *   other systems are rejected. Causes most other config options
+     *   to be ignored.
      */
     const ChunkingMethod: {
         readonly None: "none";
@@ -86,6 +94,7 @@ export declare namespace ExtractRequestConfig {
         readonly Topics: "topics";
         readonly SoapNote: "soap_note";
         readonly ClinicalNerExtract: "clinical_ner_extract";
+        readonly Fasthpocr: "fasthpocr";
     };
     type ChunkingMethod = (typeof ChunkingMethod)[keyof typeof ChunkingMethod];
     /**

package/dist/esm/api/resources/construe/types/ExtractRequestConfig.mjs

@@ -8,6 +8,10 @@ export var ExtractRequestConfig;
      * * paragraphs / topics / soap_note - LLM-based chunking.
      * * clinical_ner_extract - Extract clinical concepts (problems, tests,
      *   treatments) and use each as a chunk (supports citations).
+     * * fasthpocr - Extract HPO concepts directly with category
+     *   annotations (supports citations). Requires `system: HPO`;
+     *   other systems are rejected. Causes most other config options
+     *   to be ignored.
      */
     ExtractRequestConfig.ChunkingMethod = {
         None: "none",
@@ -16,6 +20,7 @@ export var ExtractRequestConfig;
         Topics: "topics",
         SoapNote: "soap_note",
         ClinicalNerExtract: "clinical_ner_extract",
+        Fasthpocr: "fasthpocr",
     };
     /**
      * Method for validating extracted codes:

package/dist/esm/api/resources/construe/types/ExtractedCodeResult.d.mts

@@ -19,4 +19,9 @@ export interface ExtractedCodeResult {
      * Ancestor codes do not receive citations.
      */
     citations?: phenoml.construe.Citation[] | undefined;
+    /**
+     * Higher-level groupings the extracted code belongs to (e.g. HPO category terms).
+     * Only populated by full-extraction chunking methods such as "fasthpocr".
+     */
+    categories?: phenoml.construe.CodeCategory[] | undefined;
 }

package/dist/esm/api/resources/construe/types/index.d.mts

@@ -1,4 +1,5 @@
 export * from "./Citation.mjs";
+export * from "./CodeCategory.mjs";
 export * from "./CodeResponse.mjs";
 export * from "./CodeSystemDetails.mjs";
 export * from "./CodeSystemInfo.mjs";

package/dist/esm/api/resources/construe/types/index.mjs

@@ -1,4 +1,5 @@
 export * from "./Citation.mjs";
+export * from "./CodeCategory.mjs";
 export * from "./CodeResponse.mjs";
 export * from "./CodeSystemDetails.mjs";
 export * from "./CodeSystemInfo.mjs";

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

@@ -43,7 +43,7 @@ export declare class Lang2FhirClient {
      *
      * @example
      *     await client.lang2Fhir.createMulti({
-     *         text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+     *         text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
      *     })
      */
     createMulti(request: phenoml.lang2Fhir.CreateMultiRequest, requestOptions?: Lang2FhirClient.RequestOptions): core.HttpResponsePromise<phenoml.lang2Fhir.CreateMultiResponse>;

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

@@ -94,7 +94,7 @@ export class Lang2FhirClient {
      *
      * @example
      *     await client.lang2Fhir.createMulti({
-     *         text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+     *         text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
      *     })
      */
     createMulti(request, requestOptions) {

package/dist/esm/api/resources/lang2Fhir/client/requests/CreateMultiRequest.d.mts

@@ -1,7 +1,7 @@
 /**
  * @example
  *     {
- *         text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+ *         text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
  *     }
  */
 export interface CreateMultiRequest {
@@ -15,6 +15,8 @@ export interface CreateMultiRequest {
     implementation_guide?: string;
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
     detection_effort?: CreateMultiRequest.DetectionEffort;
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    validation_method?: CreateMultiRequest.ValidationMethod;
 }
 export declare namespace CreateMultiRequest {
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
@@ -23,4 +25,11 @@ export declare namespace CreateMultiRequest {
         readonly Deep: "deep";
     };
     type DetectionEffort = (typeof DetectionEffort)[keyof typeof DetectionEffort];
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    const ValidationMethod: {
+        readonly None: "none";
+        readonly Check: "check";
+        readonly Fix: "fix";
+    };
+    type ValidationMethod = (typeof ValidationMethod)[keyof typeof ValidationMethod];
 }

package/dist/esm/api/resources/lang2Fhir/client/requests/CreateMultiRequest.mjs

@@ -6,4 +6,10 @@ export var CreateMultiRequest;
         Standard: "standard",
         Deep: "deep",
     };
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    CreateMultiRequest.ValidationMethod = {
+        None: "none",
+        Check: "check",
+        Fix: "fix",
+    };
 })(CreateMultiRequest || (CreateMultiRequest = {}));

package/dist/esm/api/resources/lang2Fhir/client/requests/DocumentMultiRequest.d.mts

@@ -20,6 +20,8 @@ export interface DocumentMultiRequest {
     implementation_guide?: string;
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
     detection_effort?: DocumentMultiRequest.DetectionEffort;
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    validation_method?: DocumentMultiRequest.ValidationMethod;
 }
 export declare namespace DocumentMultiRequest {
     /** Detection effort. 'standard' runs detection once, 'deep' runs detection multiple times for higher recall. */
@@ -28,4 +30,11 @@ export declare namespace DocumentMultiRequest {
         readonly Deep: "deep";
     };
     type DetectionEffort = (typeof DetectionEffort)[keyof typeof DetectionEffort];
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    const ValidationMethod: {
+        readonly None: "none";
+        readonly Check: "check";
+        readonly Fix: "fix";
+    };
+    type ValidationMethod = (typeof ValidationMethod)[keyof typeof ValidationMethod];
 }

package/dist/esm/api/resources/lang2Fhir/client/requests/DocumentMultiRequest.mjs

@@ -6,4 +6,10 @@ export var DocumentMultiRequest;
         Standard: "standard",
         Deep: "deep",
     };
+    /** FHIR validation method to apply to the generated bundle. 'none' skips validation (default). 'check' runs the bundle through a FHIR structure validator and includes the results in the response. 'fix' runs validation and attempts to auto-correct errors using an LLM (up to 3 validation passes). The response includes results from each pass. Warning: 'fix' can significantly increase latency due to multiple LLM and validation round-trips. */
+    DocumentMultiRequest.ValidationMethod = {
+        None: "none",
+        Check: "check",
+        Fix: "fix",
+    };
 })(DocumentMultiRequest || (DocumentMultiRequest = {}));

package/dist/esm/api/resources/lang2Fhir/types/CreateMultiResponse.d.mts

@@ -7,6 +7,8 @@ export interface CreateMultiResponse {
     bundle?: CreateMultiResponse.Bundle | undefined;
     /** Summary of extracted resources */
     resources?: CreateMultiResponse.Resources.Item[] | undefined;
+    /** FHIR validation results. Present when validation_method is 'check' or 'fix'. Contains results from each validation pass. For 'check', there is one pass. For 'fix', there may be up to 3 passes as the system attempts auto-correction. */
+    validation?: CreateMultiResponse.Validation | undefined;
 }
 export declare namespace CreateMultiResponse {
     /**
@@ -44,4 +46,65 @@ export declare namespace CreateMultiResponse {
             description?: string | undefined;
         }
     }
+    /**
+     * FHIR validation results. Present when validation_method is 'check' or 'fix'. Contains results from each validation pass. For 'check', there is one pass. For 'fix', there may be up to 3 passes as the system attempts auto-correction.
+     */
+    interface Validation {
+        /** Results from each validation pass, in chronological order */
+        passes?: Validation.Passes.Item[] | undefined;
+        /** Whether validation errors were successfully fixed by the LLM. Always false for 'check' mode. For 'fix' mode, true if errors were resolved and the returned bundle is the corrected version. */
+        fixed?: boolean | undefined;
+        /** Total number of validation passes run (1 for check, 1-3 for fix) */
+        attempts?: number | undefined;
+        /** Human-readable summary of the validation outcome */
+        summary?: string | undefined;
+    }
+    namespace Validation {
+        type Passes = Passes.Item[];
+        namespace Passes {
+            interface Item {
+                /** Validation issues found in this pass */
+                issues?: Item.Issues.Item[] | undefined;
+                /** Validation statistics for this pass */
+                stats?: Item.Stats | undefined;
+            }
+            namespace Item {
+                type Issues = Issues.Item[];
+                namespace Issues {
+                    interface Item {
+                        /** Issue severity level */
+                        severity?: Item.Severity | undefined;
+                        /** Issue type code */
+                        code?: string | undefined;
+                        /** Human-readable description of the issue */
+                        diagnostics?: string | undefined;
+                        /** FHIRPath expression(s) pointing to the issue location */
+                        expression?: string[] | undefined;
+                        /** Validation phase that generated this issue */
+                        source?: string | undefined;
+                    }
+                    namespace Item {
+                        /** Issue severity level */
+                        const Severity: {
+                            readonly Fatal: "fatal";
+                            readonly Error: "error";
+                            readonly Warning: "warning";
+                            readonly Information: "information";
+                        };
+                        type Severity = (typeof Severity)[keyof typeof Severity];
+                    }
+                }
+                /**
+                 * Validation statistics for this pass
+                 */
+                interface Stats {
+                    resource_type?: string | undefined;
+                    profile_url?: string | undefined;
+                    is_custom_profile?: boolean | undefined;
+                    /** Validation duration in milliseconds */
+                    duration_ms?: number | undefined;
+                }
+            }
+        }
+    }
 }

package/dist/esm/api/resources/lang2Fhir/types/CreateMultiResponse.mjs

@@ -1,2 +1,26 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+export var CreateMultiResponse;
+(function (CreateMultiResponse) {
+    let Validation;
+    (function (Validation) {
+        let Passes;
+        (function (Passes) {
+            let Item;
+            (function (Item_1) {
+                let Issues;
+                (function (Issues) {
+                    let Item;
+                    (function (Item) {
+                        /** Issue severity level */
+                        Item.Severity = {
+                            Fatal: "fatal",
+                            Error: "error",
+                            Warning: "warning",
+                            Information: "information",
+                        };
+                    })(Item = Issues.Item || (Issues.Item = {}));
+                })(Issues = Item_1.Issues || (Item_1.Issues = {}));
+            })(Item = Passes.Item || (Passes.Item = {}));
+        })(Passes = Validation.Passes || (Validation.Passes = {}));
+    })(Validation = CreateMultiResponse.Validation || (CreateMultiResponse.Validation = {}));
+})(CreateMultiResponse || (CreateMultiResponse = {}));

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "12.3.0";
+export declare const SDK_VERSION = "12.5.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "12.3.0";
+export const SDK_VERSION = "12.5.0";

package/package.json

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

package/reference.md

@@ -3256,7 +3256,7 @@ Resources are linked with proper references (e.g., Conditions reference the Pati
 
 ```typescript
 await client.lang2Fhir.createMulti({
-    text: "John Smith, 45-year-old male, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
+    text: "John Smith, male born on 1980-03-12, diagnosed with Type 2 Diabetes. Prescribed Metformin 500mg twice daily."
 });
 
 ```