phenoml 13.1.0 → 15.0.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": "13.1.0",
-        "User-Agent": "phenoml/13.1.0",
+        "X-Fern-SDK-Version": "15.0.0",
+        "User-Agent": "phenoml/15.0.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/agent/client/Client.d.ts

@@ -26,9 +26,11 @@ export declare class AgentClient {
      *
      * @example
      *     await client.agent.create({
-     *         name: "name",
-     *         prompts: ["prompt_123", "prompt_456"],
-     *         provider: "provider"
+     *         name: "Medical Assistant",
+     *         description: "An AI assistant for medical information processing",
+     *         prompts: ["prompt_123"],
+     *         tags: ["medical", "fhir"],
+     *         provider: "7002b0b4-8d09-445a-bf65-0fafdaf26c35"
      *     })
      */
     create(request: phenoml.agent.AgentCreateRequest, requestOptions?: AgentClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentResponse>;
@@ -81,9 +83,11 @@ export declare class AgentClient {
      *
      * @example
      *     await client.agent.update("id", {
-     *         name: "name",
-     *         prompts: ["prompt_123", "prompt_456"],
-     *         provider: "provider"
+     *         name: "Medical Assistant",
+     *         description: "Updated description for the medical assistant",
+     *         prompts: ["prompt_123"],
+     *         tags: ["medical", "fhir", "updated"],
+     *         provider: "7002b0b4-8d09-445a-bf65-0fafdaf26c35"
      *     })
      */
     update(id: string, request: phenoml.agent.AgentCreateRequest, requestOptions?: AgentClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentResponse>;
@@ -120,15 +124,12 @@ export declare class AgentClient {
      * @example
      *     await client.agent.patch("id", [{
      *             op: "replace",
-     *             path: "/name",
-     *             value: "Updated Agent Name"
+     *             path: "/description",
+     *             value: "patched description"
      *         }, {
      *             op: "add",
      *             path: "/tags/-",
-     *             value: "new-tag"
-     *         }, {
-     *             op: "remove",
-     *             path: "/description"
+     *             value: "updated"
      *         }])
      */
     patch(id: string, request: phenoml.agent.JsonPatch, requestOptions?: AgentClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentResponse>;
@@ -149,8 +150,19 @@ export declare class AgentClient {
      *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
      *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         message: "What is the patient's current condition?",
+     *         session_id: "session-abc123",
      *         agent_id: "agent-123"
      *     })
+     *
+     * @example
+     *     await client.agent.chat({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
+     *         message: "Create a patient record for Jane Doe, 32F, diagnosed with iron deficiency anemia. Prescribe ferrous sulfate 325mg daily.",
+     *         session_id: "session-def456",
+     *         agent_id: "agent-123",
+     *         enhanced_reasoning: true
+     *     })
      */
     chat(request: phenoml.agent.AgentChatRequest, requestOptions?: AgentClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentChatResponse>;
     private __chat;

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

@@ -84,9 +84,11 @@ class AgentClient {
      *
      * @example
      *     await client.agent.create({
-     *         name: "name",
-     *         prompts: ["prompt_123", "prompt_456"],
-     *         provider: "provider"
+     *         name: "Medical Assistant",
+     *         description: "An AI assistant for medical information processing",
+     *         prompts: ["prompt_123"],
+     *         tags: ["medical", "fhir"],
+     *         provider: "7002b0b4-8d09-445a-bf65-0fafdaf26c35"
      *     })
      */
     create(request, requestOptions) {
@@ -271,9 +273,11 @@ class AgentClient {
      *
      * @example
      *     await client.agent.update("id", {
-     *         name: "name",
-     *         prompts: ["prompt_123", "prompt_456"],
-     *         provider: "provider"
+     *         name: "Medical Assistant",
+     *         description: "Updated description for the medical assistant",
+     *         prompts: ["prompt_123"],
+     *         tags: ["medical", "fhir", "updated"],
+     *         provider: "7002b0b4-8d09-445a-bf65-0fafdaf26c35"
      *     })
      */
     update(id, request, requestOptions) {
@@ -397,15 +401,12 @@ class AgentClient {
      * @example
      *     await client.agent.patch("id", [{
      *             op: "replace",
-     *             path: "/name",
-     *             value: "Updated Agent Name"
+     *             path: "/description",
+     *             value: "patched description"
      *         }, {
      *             op: "add",
      *             path: "/tags/-",
-     *             value: "new-tag"
-     *         }, {
-     *             op: "remove",
-     *             path: "/description"
+     *             value: "updated"
      *         }])
      */
     patch(id, request, requestOptions) {
@@ -472,8 +473,19 @@ class AgentClient {
      *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
      *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
      *         message: "What is the patient's current condition?",
+     *         session_id: "session-abc123",
      *         agent_id: "agent-123"
      *     })
+     *
+     * @example
+     *     await client.agent.chat({
+     *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+     *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
+     *         message: "Create a patient record for Jane Doe, 32F, diagnosed with iron deficiency anemia. Prescribe ferrous sulfate 325mg daily.",
+     *         session_id: "session-def456",
+     *         agent_id: "agent-123",
+     *         enhanced_reasoning: true
+     *     })
      */
     chat(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__chat(request, requestOptions));

package/dist/cjs/api/resources/agent/client/requests/AgentChatRequest.d.ts

@@ -4,8 +4,19 @@
  *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
  *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         message: "What is the patient's current condition?",
+ *         session_id: "session-abc123",
  *         agent_id: "agent-123"
  *     }
+ *
+ * @example
+ *     {
+ *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
+ *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
+ *         message: "Create a patient record for Jane Doe, 32F, diagnosed with iron deficiency anemia. Prescribe ferrous sulfate 325mg daily.",
+ *         session_id: "session-def456",
+ *         agent_id: "agent-123",
+ *         enhanced_reasoning: true
+ *     }
  */
 export interface AgentChatRequest {
     /**
@@ -26,6 +37,6 @@ export interface AgentChatRequest {
     session_id?: string;
     /** The ID of the agent to chat with */
     agent_id: string;
-    /** Enable enhanced reasoning capabilities, will increase latency but will also improve response quality and reliability. */
+    /** Enable enhanced reasoning capabilities. Increases latency but improves response quality and reliability. */
     enhanced_reasoning?: boolean;
 }

package/dist/cjs/api/resources/agent/client/requests/AgentStreamChatRequest.d.ts

@@ -4,6 +4,7 @@
  *         "X-Phenoml-On-Behalf-Of": "Patient/550e8400-e29b-41d4-a716-446655440000",
  *         "X-Phenoml-Fhir-Provider": "550e8400-e29b-41d4-a716-446655440000:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c...",
  *         message: "What is the patient's current condition?",
+ *         session_id: "session-abc123",
  *         agent_id: "agent-123"
  *     }
  */
@@ -26,6 +27,6 @@ export interface AgentStreamChatRequest {
     session_id?: string;
     /** The ID of the agent to chat with */
     agent_id: string;
-    /** Enable enhanced reasoning capabilities, will increase latency but will also improve response quality and reliability. */
+    /** Enable enhanced reasoning capabilities. Increases latency but improves response quality and reliability. */
     enhanced_reasoning?: boolean;
 }

package/dist/cjs/api/resources/agent/resources/prompts/client/Client.d.ts

@@ -24,7 +24,10 @@ export declare class PromptsClient {
      * @example
      *     await client.agent.prompts.create({
      *         name: "Medical Assistant System Prompt",
-     *         content: "You are a helpful medical assistant specialized in FHIR data processing..."
+     *         description: "System prompt for medical assistant agent",
+     *         content: "You are a helpful medical assistant specialized in FHIR data processing.",
+     *         is_default: false,
+     *         tags: ["medical", "system"]
      *     })
      */
     create(request: phenoml.agent.AgentPromptsCreateRequest, requestOptions?: PromptsClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentPromptsResponse>;
@@ -73,7 +76,13 @@ export declare class PromptsClient {
      * @throws {@link phenoml.agent.InternalServerError}
      *
      * @example
-     *     await client.agent.prompts.update("id")
+     *     await client.agent.prompts.update("id", {
+     *         name: "Medical Assistant System Prompt",
+     *         description: "Updated system prompt",
+     *         content: "You are a helpful medical assistant. Always cite ICD-10 codes when discussing diagnoses.",
+     *         is_default: false,
+     *         tags: ["medical", "system", "updated"]
+     *     })
      */
     update(id: string, request?: phenoml.agent.AgentPromptsUpdateRequest, requestOptions?: PromptsClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentPromptsResponse>;
     private __update;
@@ -109,31 +118,10 @@ export declare class PromptsClient {
      * @example
      *     await client.agent.prompts.patch("id", [{
      *             op: "replace",
-     *             path: "/name",
-     *             value: "Updated Agent Name"
-     *         }, {
-     *             op: "add",
-     *             path: "/tags/-",
-     *             value: "new-tag"
-     *         }, {
-     *             op: "remove",
-     *             path: "/description"
+     *             path: "/content",
+     *             value: "Updated prompt content."
      *         }])
      */
     patch(id: string, request: phenoml.agent.JsonPatch, requestOptions?: PromptsClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentPromptsResponse>;
     private __patch;
-    /**
-     * Loads default agent prompts for the authenticated user
-     *
-     * @param {PromptsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.agent.UnauthorizedError}
-     * @throws {@link phenoml.agent.ForbiddenError}
-     * @throws {@link phenoml.agent.InternalServerError}
-     *
-     * @example
-     *     await client.agent.prompts.loadDefaults()
-     */
-    loadDefaults(requestOptions?: PromptsClient.RequestOptions): core.HttpResponsePromise<phenoml.agent.SuccessResponse>;
-    private __loadDefaults;
 }

package/dist/cjs/api/resources/agent/resources/prompts/client/Client.js

@@ -69,7 +69,10 @@ class PromptsClient {
      * @example
      *     await client.agent.prompts.create({
      *         name: "Medical Assistant System Prompt",
-     *         content: "You are a helpful medical assistant specialized in FHIR data processing..."
+     *         description: "System prompt for medical assistant agent",
+     *         content: "You are a helpful medical assistant specialized in FHIR data processing.",
+     *         is_default: false,
+     *         tags: ["medical", "system"]
      *     })
      */
     create(request, requestOptions) {
@@ -242,7 +245,13 @@ class PromptsClient {
      * @throws {@link phenoml.agent.InternalServerError}
      *
      * @example
-     *     await client.agent.prompts.update("id")
+     *     await client.agent.prompts.update("id", {
+     *         name: "Medical Assistant System Prompt",
+     *         description: "Updated system prompt",
+     *         content: "You are a helpful medical assistant. Always cite ICD-10 codes when discussing diagnoses.",
+     *         is_default: false,
+     *         tags: ["medical", "system", "updated"]
+     *     })
      */
     update(id, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__update(id, request, requestOptions));
@@ -365,15 +374,8 @@ class PromptsClient {
      * @example
      *     await client.agent.prompts.patch("id", [{
      *             op: "replace",
-     *             path: "/name",
-     *             value: "Updated Agent Name"
-     *         }, {
-     *             op: "add",
-     *             path: "/tags/-",
-     *             value: "new-tag"
-     *         }, {
-     *             op: "remove",
-     *             path: "/description"
+     *             path: "/content",
+     *             value: "Updated prompt content."
      *         }])
      */
     patch(id, request, requestOptions) {
@@ -424,58 +426,5 @@ class PromptsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/agent/prompts/{id}");
         });
     }
-    /**
-     * Loads default agent prompts for the authenticated user
-     *
-     * @param {PromptsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.agent.UnauthorizedError}
-     * @throws {@link phenoml.agent.ForbiddenError}
-     * @throws {@link phenoml.agent.InternalServerError}
-     *
-     * @example
-     *     await client.agent.prompts.loadDefaults()
-     */
-    loadDefaults(requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__loadDefaults(requestOptions));
-    }
-    __loadDefaults(requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "agent/prompts/load-defaults"),
-                method: "POST",
-                headers: _headers,
-                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
-                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 401:
-                        throw new phenoml.agent.UnauthorizedError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new phenoml.agent.ForbiddenError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new phenoml.agent.InternalServerError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.phenomlError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/agent/prompts/load-defaults");
-        });
-    }
 }
 exports.PromptsClient = PromptsClient;

package/dist/cjs/api/resources/agent/resources/prompts/client/requests/AgentPromptsCreateRequest.d.ts

@@ -2,7 +2,10 @@
  * @example
  *     {
  *         name: "Medical Assistant System Prompt",
- *         content: "You are a helpful medical assistant specialized in FHIR data processing..."
+ *         description: "System prompt for medical assistant agent",
+ *         content: "You are a helpful medical assistant specialized in FHIR data processing.",
+ *         is_default: false,
+ *         tags: ["medical", "system"]
  *     }
  */
 export interface AgentPromptsCreateRequest {

package/dist/cjs/api/resources/agent/resources/prompts/client/requests/AgentPromptsUpdateRequest.d.ts

@@ -1,6 +1,12 @@
 /**
  * @example
- *     {}
+ *     {
+ *         name: "Medical Assistant System Prompt",
+ *         description: "Updated system prompt",
+ *         content: "You are a helpful medical assistant. Always cite ICD-10 codes when discussing diagnoses.",
+ *         is_default: false,
+ *         tags: ["medical", "system", "updated"]
+ *     }
  */
 export interface AgentPromptsUpdateRequest {
     /** Prompt name */

package/dist/cjs/api/resources/authtoken/resources/auth/client/Client.d.ts

@@ -24,7 +24,10 @@ export declare class AuthClient {
      * @throws {@link phenoml.authtoken.InternalServerError}
      *
      * @example
-     *     await client.authtoken.auth.getToken()
+     *     await client.authtoken.auth.getToken({
+     *         client_id: "your_client_id",
+     *         client_secret: "your_client_secret"
+     *     })
      */
     getToken(request?: phenoml.authtoken.ClientCredentialsRequest, requestOptions?: AuthClient.RequestOptions): core.HttpResponsePromise<phenoml.authtoken.TokenResponse>;
     private __getToken;

package/dist/cjs/api/resources/authtoken/resources/auth/client/Client.js

@@ -69,7 +69,10 @@ class AuthClient {
      * @throws {@link phenoml.authtoken.InternalServerError}
      *
      * @example
-     *     await client.authtoken.auth.getToken()
+     *     await client.authtoken.auth.getToken({
+     *         client_id: "your_client_id",
+     *         client_secret: "your_client_secret"
+     *     })
      */
     getToken(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getToken(request, requestOptions));

package/dist/cjs/api/resources/authtoken/resources/auth/client/requests/ClientCredentialsRequest.d.ts

@@ -1,6 +1,9 @@
 /**
  * @example
- *     {}
+ *     {
+ *         client_id: "your_client_id",
+ *         client_secret: "your_client_secret"
+ *     }
  */
 export interface ClientCredentialsRequest {
     /** Must be "client_credentials" if provided */

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

@@ -30,7 +30,24 @@ export declare class ConstrueClient {
      *     await client.construe.uploadCodeSystem({
      *         name: "CUSTOM_CODES",
      *         version: "1.0",
-     *         format: "csv"
+     *         format: "json",
+     *         codes: [{
+     *                 code: "X001",
+     *                 description: "Example custom code 1"
+     *             }, {
+     *                 code: "X002",
+     *                 description: "Example custom code 2"
+     *             }]
+     *     })
+     *
+     * @example
+     *     await client.construe.uploadCodeSystem({
+     *         name: "CUSTOM_CODES",
+     *         version: "1.0",
+     *         format: "csv",
+     *         file: "Y29kZSxkZXNjcmlwdGlvbgpYMDAxLEV4YW1wbGUgY3VzdG9tIGNvZGUgMQo=",
+     *         code_col: "code",
+     *         desc_col: "description"
      *     })
      */
     uploadCodeSystem(request: phenoml.construe.UploadRequest, requestOptions?: ConstrueClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.ConstrueUploadCodeSystemResponse>;
@@ -52,7 +69,66 @@ export declare class ConstrueClient {
      *
      * @example
      *     await client.construe.extractCodes({
-     *         text: "Patient is a 14-year-old female, previously healthy, who is here for evaluation of abnormal renal ultrasound with atrophic right kidney"
+     *         text: "Patient is a 14-year-old female, previously healthy, who is here for evaluation of abnormal renal ultrasound with atrophic right kidney.",
+     *         system: {
+     *             name: "ICD-10-CM",
+     *             version: "2025"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.construe.extractCodes({
+     *         text: "45-year-old male presents with chest pain radiating to left arm, shortness of breath, and diaphoresis. ECG shows ST elevation in leads II, III, and aVF.",
+     *         system: {
+     *             name: "SNOMED_CT_US_LITE",
+     *             version: "20240901"
+     *         },
+     *         config: {
+     *             chunking_method: "sentences",
+     *             validation_method: "simple",
+     *             include_rationale: true,
+     *             include_citations: true
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.construe.extractCodes({
+     *         text: "Start Metformin 500mg twice daily for type 2 diabetes. Continue Lisinopril 10mg daily for hypertension. Add Atorvastatin 20mg at bedtime.",
+     *         system: {
+     *             name: "RXNORM",
+     *             version: "11042024"
+     *         },
+     *         config: {
+     *             validation_method: "medication_search",
+     *             include_rationale: true
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.construe.extractCodes({
+     *         text: "Patient diagnosed with Type 2 diabetes mellitus with diabetic chronic kidney disease, stage 3.",
+     *         system: {
+     *             name: "ICD-10-CM",
+     *             version: "2025"
+     *         },
+     *         config: {
+     *             validation_method: "simple",
+     *             include_ancestors: true
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.construe.extractCodes({
+     *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+     *         system: {
+     *             name: "HPO",
+     *             version: "2025"
+     *         },
+     *         config: {
+     *             chunking_method: "fasthpocr",
+     *             validation_method: "none",
+     *             include_rationale: false
+     *         }
      *     })
      */
     extractCodes(request: phenoml.construe.ExtractRequest, requestOptions?: ConstrueClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
@@ -163,7 +239,8 @@ export declare class ConstrueClient {
      * Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.
      *
      * @param {string} codesystem - Code system name
-     * @param {string} codeID - The code identifier
+     * @param {string} codeID - The code identifier. ICD-10-CM codes are stored without their
+     *                          cosmetic dot (use "E1165", not "E11.65").
      * @param {phenoml.construe.GetConstrueCodesCodesystemCodeIdRequest} request
      * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -173,7 +250,7 @@ export declare class ConstrueClient {
      * @throws {@link phenoml.construe.InternalServerError}
      *
      * @example
-     *     await client.construe.getASpecificCode("ICD-10-CM", "E11.65", {
+     *     await client.construe.getASpecificCode("ICD-10-CM", "E1165", {
      *         version: "version"
      *     })
      */
@@ -234,21 +311,28 @@ export declare class ConstrueClient {
      *     await client.construe.submitFeedbackOnExtractionResults({
      *         text: "Patient has type 2 diabetes with hyperglycemia",
      *         received_result: {
-     *             system: {},
+     *             system: {
+     *                 name: "ICD-10-CM",
+     *                 version: "2025"
+     *             },
      *             codes: [{
-     *                     code: "195967001",
-     *                     description: "Asthma",
+     *                     code: "E11.9",
+     *                     description: "Type 2 diabetes mellitus without complications",
      *                     valid: true
      *                 }]
      *         },
      *         expected_result: {
-     *             system: {},
+     *             system: {
+     *                 name: "ICD-10-CM",
+     *                 version: "2025"
+     *             },
      *             codes: [{
-     *                     code: "195967001",
-     *                     description: "Asthma",
+     *                     code: "E11.65",
+     *                     description: "Type 2 diabetes mellitus with hyperglycemia",
      *                     valid: true
      *                 }]
-     *         }
+     *         },
+     *         detail: "Expected code E11.65 because the text mentions hyperglycemia"
      *     })
      */
     submitFeedbackOnExtractionResults(request: phenoml.construe.FeedbackRequest, requestOptions?: ConstrueClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.FeedbackResponse>;