phenoml 17.8.0 → 17.10.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": "17.8.0",
-        "User-Agent": "phenoml/17.8.0",
+        "X-Fern-SDK-Version": "17.10.0",
+        "User-Agent": "phenoml/17.10.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/resources/codes/client/Client.d.ts

@@ -109,6 +109,38 @@ export declare class CodesClient {
      */
     extract(request: phenoml.construe.ExtractRequest, requestOptions?: CodesClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
     private __extract;
+    /**
+     * **Alpha:** phenocr is an alpha feature. The API contract — request
+     * parameters and response shape — may change as its internals evolve, and
+     * results may vary between releases. Do not depend on it for production
+     * workloads yet.
+     *
+     * Extracts medical codes from natural language clinical text using phenocr.
+     *
+     * Supported code systems: HPO, ICD-10-CM, and SNOMED_CT_US. The code
+     * system name and version are both required.
+     *
+     * @param {phenoml.construe.PhenoCrRequest} request
+     * @param {CodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     * @throws {@link phenoml.construe.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.construe.codes.phenocr({
+     *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+     *         system: {
+     *             name: "HPO",
+     *             version: "umls-2026AA"
+     *         }
+     *     })
+     */
+    phenocr(request: phenoml.construe.PhenoCrRequest, requestOptions?: CodesClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
+    private __phenocr;
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/cjs/api/resources/construe/resources/codes/client/Client.js

@@ -203,6 +203,86 @@ class CodesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/construe/extract");
         });
     }
+    /**
+     * **Alpha:** phenocr is an alpha feature. The API contract — request
+     * parameters and response shape — may change as its internals evolve, and
+     * results may vary between releases. Do not depend on it for production
+     * workloads yet.
+     *
+     * Extracts medical codes from natural language clinical text using phenocr.
+     *
+     * Supported code systems: HPO, ICD-10-CM, and SNOMED_CT_US. The code
+     * system name and version are both required.
+     *
+     * @param {phenoml.construe.PhenoCrRequest} request
+     * @param {CodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     * @throws {@link phenoml.construe.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.construe.codes.phenocr({
+     *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+     *         system: {
+     *             name: "HPO",
+     *             version: "umls-2026AA"
+     *         }
+     *     })
+     */
+    phenocr(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__phenocr(request, requestOptions));
+    }
+    __phenocr(request, 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, "construe/phenocr"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: (0, requestBody_js_1.mergeAdditionalBodyParameters)(request, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                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 400:
+                        throw new phenoml.construe.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.construe.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.construe.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new phenoml.construe.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new phenoml.construe.GatewayTimeoutError(_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", "/construe/phenocr");
+        });
+    }
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/cjs/api/resources/construe/resources/codes/client/requests/PhenoCrRequest.d.ts

@@ -0,0 +1,16 @@
+import type * as phenoml from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+ *         system: {
+ *             name: "HPO",
+ *             version: "umls-2026AA"
+ *         }
+ *     }
+ */
+export interface PhenoCrRequest {
+    /** Natural language text to extract codes from */
+    text: string;
+    system: phenoml.construe.PhenocrExtractRequestSystem;
+}

package/dist/cjs/api/resources/construe/resources/codes/client/requests/PhenoCrRequest.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/resources/codes/client/requests/index.d.ts

@@ -1,5 +1,6 @@
 export type { CodesListRequest } from "./CodesListRequest.js";
 export type { ExtractRequest } from "./ExtractRequest.js";
 export type { LookupRequest } from "./LookupRequest.js";
+export type { PhenoCrRequest } from "./PhenoCrRequest.js";
 export type { SearchSemanticRequest } from "./SearchSemanticRequest.js";
 export type { SearchTextRequest } from "./SearchTextRequest.js";

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

@@ -0,0 +1,6 @@
+export interface PhenocrExtractRequestSystem {
+    /** Code system name. Supported by phenocr: HPO, ICD-10-CM, SNOMED_CT_US. */
+    name: string;
+    /** Code system version to run against. */
+    version: string;
+}

package/dist/cjs/api/resources/construe/types/PhenocrExtractRequestSystem.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/index.d.ts

@@ -14,6 +14,7 @@ export * from "./GetCodeResponse.js";
 export * from "./GetCodeSystemDetailResponse.js";
 export * from "./ListCodeSystemsResponse.js";
 export * from "./ListCodesResponse.js";
+export * from "./PhenocrExtractRequestSystem.js";
 export * from "./SemanticSearchResponse.js";
 export * from "./SemanticSearchResult.js";
 export * from "./TextSearchResponse.js";

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

@@ -30,6 +30,7 @@ __exportStar(require("./GetCodeResponse.js"), exports);
 __exportStar(require("./GetCodeSystemDetailResponse.js"), exports);
 __exportStar(require("./ListCodeSystemsResponse.js"), exports);
 __exportStar(require("./ListCodesResponse.js"), exports);
+__exportStar(require("./PhenocrExtractRequestSystem.js"), exports);
 __exportStar(require("./SemanticSearchResponse.js"), exports);
 __exportStar(require("./SemanticSearchResult.js"), exports);
 __exportStar(require("./TextSearchResponse.js"), exports);

package/dist/cjs/core/runtime/index.d.ts

@@ -1 +1 @@
-export { RUNTIME } from "./runtime.js";
+export { getUserAgent, RUNTIME } from "./runtime.js";

package/dist/cjs/core/runtime/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RUNTIME = void 0;
+exports.RUNTIME = exports.getUserAgent = void 0;
 var runtime_js_1 = require("./runtime.js");
+Object.defineProperty(exports, "getUserAgent", { enumerable: true, get: function () { return runtime_js_1.getUserAgent; } });
 Object.defineProperty(exports, "RUNTIME", { enumerable: true, get: function () { return runtime_js_1.RUNTIME; } });

package/dist/cjs/core/runtime/runtime.d.ts

@@ -6,4 +6,23 @@ export interface Runtime {
     type: "browser" | "web-worker" | "deno" | "bun" | "node" | "react-native" | "unknown" | "workerd" | "edge-runtime";
     version?: string;
     parsedVersion?: number;
+    /**
+     * The operating system the SDK is running on, when it can be determined
+     * (e.g. "linux", "darwin", "win32" on server runtimes). Undefined in
+     * environments where the OS is not observable (e.g. browsers).
+     */
+    os?: string;
+    /**
+     * The CPU architecture the SDK is running on, when it can be determined
+     * (e.g. "x64", "arm64" on server runtimes). Undefined in environments where
+     * the architecture is not observable (e.g. browsers).
+     */
+    arch?: string;
 }
+/**
+ * Builds a structured User-Agent string of the form
+ *   `{sdkName}/{sdkVersion} ({os}; {arch}) {runtime}/{runtimeVersion}`
+ * where the platform group and runtime segment are omitted gracefully when the
+ * underlying values cannot be determined (e.g. in a browser).
+ */
+export declare function getUserAgent(sdkName: string, sdkVersion: string): string;

package/dist/cjs/core/runtime/runtime.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RUNTIME = void 0;
+exports.getUserAgent = getUserAgent;
 /**
  * A constant that indicates which environment and version the SDK is running in.
  */
 exports.RUNTIME = evaluateRuntime();
 function evaluateRuntime() {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     /**
      * A constant that indicates whether the environment the code is running is a Web Browser.
      */
@@ -59,6 +60,8 @@ function evaluateRuntime() {
         return {
             type: "deno",
             version: Deno.version.deno,
+            os: (_e = Deno.build) === null || _e === void 0 ? void 0 : _e.os,
+            arch: (_f = Deno.build) === null || _f === void 0 ? void 0 : _f.arch,
         };
     }
     /**
@@ -69,6 +72,8 @@ function evaluateRuntime() {
         return {
             type: "bun",
             version: Bun.version,
+            os: typeof process !== "undefined" ? process.platform : undefined,
+            arch: typeof process !== "undefined" ? process.arch : undefined,
         };
     }
     /**
@@ -90,15 +95,55 @@ function evaluateRuntime() {
      * Edge Runtime warns about Node.js APIs even when they are guarded).
      */
     const _process = typeof process !== "undefined" ? process : undefined;
-    const isNode = typeof _process !== "undefined" && typeof ((_e = _process.versions) === null || _e === void 0 ? void 0 : _e.node) === "string";
+    const isNode = typeof _process !== "undefined" && typeof ((_g = _process.versions) === null || _g === void 0 ? void 0 : _g.node) === "string";
     if (isNode) {
         return {
             type: "node",
             version: _process.versions.node,
             parsedVersion: Number(_process.versions.node.split(".")[0]),
+            os: _process.platform,
+            arch: _process.arch,
         };
     }
     return {
         type: "unknown",
     };
 }
+/**
+ * Display names for the language runtimes whose version is meaningful to encode
+ * in a User-Agent. Environments where a version string is not useful (e.g.
+ * browsers, where `version` is the full navigator UA) are intentionally mapped
+ * to `undefined` so they are omitted from the User-Agent.
+ */
+const RUNTIME_DISPLAY_NAMES = {
+    node: "Node",
+    deno: "Deno",
+    bun: "Bun",
+    browser: undefined,
+    "web-worker": undefined,
+    "react-native": undefined,
+    workerd: undefined,
+    "edge-runtime": undefined,
+    unknown: undefined,
+};
+/**
+ * Builds a structured User-Agent string of the form
+ *   `{sdkName}/{sdkVersion} ({os}; {arch}) {runtime}/{runtimeVersion}`
+ * where the platform group and runtime segment are omitted gracefully when the
+ * underlying values cannot be determined (e.g. in a browser).
+ */
+function getUserAgent(sdkName, sdkVersion) {
+    let userAgent = `${sdkName}/${sdkVersion}`;
+    const platform = [exports.RUNTIME.os, exports.RUNTIME.arch].filter((part) => part != null && part.length > 0);
+    if (platform.length > 0) {
+        userAgent += ` (${platform.join("; ")})`;
+    }
+    const runtimeName = RUNTIME_DISPLAY_NAMES[exports.RUNTIME.type];
+    if (runtimeName != null) {
+        userAgent += ` ${runtimeName}`;
+        if (exports.RUNTIME.version != null && exports.RUNTIME.version.length > 0) {
+            userAgent += `/${exports.RUNTIME.version}`;
+        }
+    }
+    return userAgent;
+}

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "17.8.0";
+export declare const SDK_VERSION = "17.10.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 = "17.8.0";
+exports.SDK_VERSION = "17.10.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": "17.8.0",
-        "User-Agent": "phenoml/17.8.0",
+        "X-Fern-SDK-Version": "17.10.0",
+        "User-Agent": "phenoml/17.10.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/resources/codes/client/Client.d.mts

@@ -109,6 +109,38 @@ export declare class CodesClient {
      */
     extract(request: phenoml.construe.ExtractRequest, requestOptions?: CodesClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
     private __extract;
+    /**
+     * **Alpha:** phenocr is an alpha feature. The API contract — request
+     * parameters and response shape — may change as its internals evolve, and
+     * results may vary between releases. Do not depend on it for production
+     * workloads yet.
+     *
+     * Extracts medical codes from natural language clinical text using phenocr.
+     *
+     * Supported code systems: HPO, ICD-10-CM, and SNOMED_CT_US. The code
+     * system name and version are both required.
+     *
+     * @param {phenoml.construe.PhenoCrRequest} request
+     * @param {CodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     * @throws {@link phenoml.construe.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.construe.codes.phenocr({
+     *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+     *         system: {
+     *             name: "HPO",
+     *             version: "umls-2026AA"
+     *         }
+     *     })
+     */
+    phenocr(request: phenoml.construe.PhenoCrRequest, requestOptions?: CodesClient.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
+    private __phenocr;
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/esm/api/resources/construe/resources/codes/client/Client.mjs

@@ -167,6 +167,86 @@ export class CodesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/construe/extract");
         });
     }
+    /**
+     * **Alpha:** phenocr is an alpha feature. The API contract — request
+     * parameters and response shape — may change as its internals evolve, and
+     * results may vary between releases. Do not depend on it for production
+     * workloads yet.
+     *
+     * Extracts medical codes from natural language clinical text using phenocr.
+     *
+     * Supported code systems: HPO, ICD-10-CM, and SNOMED_CT_US. The code
+     * system name and version are both required.
+     *
+     * @param {phenoml.construe.PhenoCrRequest} request
+     * @param {CodesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     * @throws {@link phenoml.construe.GatewayTimeoutError}
+     *
+     * @example
+     *     await client.construe.codes.phenocr({
+     *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+     *         system: {
+     *             name: "HPO",
+     *             version: "umls-2026AA"
+     *         }
+     *     })
+     */
+    phenocr(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__phenocr(request, requestOptions));
+    }
+    __phenocr(request, 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 = 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, "construe/phenocr"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(request, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                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 400:
+                        throw new phenoml.construe.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.construe.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.construe.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new phenoml.construe.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    case 504:
+                        throw new phenoml.construe.GatewayTimeoutError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.phenomlError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/construe/phenocr");
+        });
+    }
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/esm/api/resources/construe/resources/codes/client/requests/PhenoCrRequest.d.mts

@@ -0,0 +1,16 @@
+import type * as phenoml from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+ *         system: {
+ *             name: "HPO",
+ *             version: "umls-2026AA"
+ *         }
+ *     }
+ */
+export interface PhenoCrRequest {
+    /** Natural language text to extract codes from */
+    text: string;
+    system: phenoml.construe.PhenocrExtractRequestSystem;
+}

package/dist/esm/api/resources/construe/resources/codes/client/requests/PhenoCrRequest.mjs

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

package/dist/esm/api/resources/construe/resources/codes/client/requests/index.d.mts

@@ -1,5 +1,6 @@
 export type { CodesListRequest } from "./CodesListRequest.mjs";
 export type { ExtractRequest } from "./ExtractRequest.mjs";
 export type { LookupRequest } from "./LookupRequest.mjs";
+export type { PhenoCrRequest } from "./PhenoCrRequest.mjs";
 export type { SearchSemanticRequest } from "./SearchSemanticRequest.mjs";
 export type { SearchTextRequest } from "./SearchTextRequest.mjs";

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

@@ -0,0 +1,6 @@
+export interface PhenocrExtractRequestSystem {
+    /** Code system name. Supported by phenocr: HPO, ICD-10-CM, SNOMED_CT_US. */
+    name: string;
+    /** Code system version to run against. */
+    version: string;
+}

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

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

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

@@ -14,6 +14,7 @@ export * from "./GetCodeResponse.mjs";
 export * from "./GetCodeSystemDetailResponse.mjs";
 export * from "./ListCodeSystemsResponse.mjs";
 export * from "./ListCodesResponse.mjs";
+export * from "./PhenocrExtractRequestSystem.mjs";
 export * from "./SemanticSearchResponse.mjs";
 export * from "./SemanticSearchResult.mjs";
 export * from "./TextSearchResponse.mjs";

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

@@ -14,6 +14,7 @@ export * from "./GetCodeResponse.mjs";
 export * from "./GetCodeSystemDetailResponse.mjs";
 export * from "./ListCodeSystemsResponse.mjs";
 export * from "./ListCodesResponse.mjs";
+export * from "./PhenocrExtractRequestSystem.mjs";
 export * from "./SemanticSearchResponse.mjs";
 export * from "./SemanticSearchResult.mjs";
 export * from "./TextSearchResponse.mjs";

package/dist/esm/core/runtime/index.d.mts

@@ -1 +1 @@
-export { RUNTIME } from "./runtime.mjs";
+export { getUserAgent, RUNTIME } from "./runtime.mjs";

package/dist/esm/core/runtime/index.mjs

@@ -1 +1 @@
-export { RUNTIME } from "./runtime.mjs";
+export { getUserAgent, RUNTIME } from "./runtime.mjs";

package/dist/esm/core/runtime/runtime.d.mts

@@ -6,4 +6,23 @@ export interface Runtime {
     type: "browser" | "web-worker" | "deno" | "bun" | "node" | "react-native" | "unknown" | "workerd" | "edge-runtime";
     version?: string;
     parsedVersion?: number;
+    /**
+     * The operating system the SDK is running on, when it can be determined
+     * (e.g. "linux", "darwin", "win32" on server runtimes). Undefined in
+     * environments where the OS is not observable (e.g. browsers).
+     */
+    os?: string;
+    /**
+     * The CPU architecture the SDK is running on, when it can be determined
+     * (e.g. "x64", "arm64" on server runtimes). Undefined in environments where
+     * the architecture is not observable (e.g. browsers).
+     */
+    arch?: string;
 }
+/**
+ * Builds a structured User-Agent string of the form
+ *   `{sdkName}/{sdkVersion} ({os}; {arch}) {runtime}/{runtimeVersion}`
+ * where the platform group and runtime segment are omitted gracefully when the
+ * underlying values cannot be determined (e.g. in a browser).
+ */
+export declare function getUserAgent(sdkName: string, sdkVersion: string): string;

package/dist/esm/core/runtime/runtime.mjs

@@ -3,7 +3,7 @@
  */
 export const RUNTIME = evaluateRuntime();
 function evaluateRuntime() {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     /**
      * A constant that indicates whether the environment the code is running is a Web Browser.
      */
@@ -56,6 +56,8 @@ function evaluateRuntime() {
         return {
             type: "deno",
             version: Deno.version.deno,
+            os: (_e = Deno.build) === null || _e === void 0 ? void 0 : _e.os,
+            arch: (_f = Deno.build) === null || _f === void 0 ? void 0 : _f.arch,
         };
     }
     /**
@@ -66,6 +68,8 @@ function evaluateRuntime() {
         return {
             type: "bun",
             version: Bun.version,
+            os: typeof process !== "undefined" ? process.platform : undefined,
+            arch: typeof process !== "undefined" ? process.arch : undefined,
         };
     }
     /**
@@ -87,15 +91,55 @@ function evaluateRuntime() {
      * Edge Runtime warns about Node.js APIs even when they are guarded).
      */
     const _process = typeof process !== "undefined" ? process : undefined;
-    const isNode = typeof _process !== "undefined" && typeof ((_e = _process.versions) === null || _e === void 0 ? void 0 : _e.node) === "string";
+    const isNode = typeof _process !== "undefined" && typeof ((_g = _process.versions) === null || _g === void 0 ? void 0 : _g.node) === "string";
     if (isNode) {
         return {
             type: "node",
             version: _process.versions.node,
             parsedVersion: Number(_process.versions.node.split(".")[0]),
+            os: _process.platform,
+            arch: _process.arch,
         };
     }
     return {
         type: "unknown",
     };
 }
+/**
+ * Display names for the language runtimes whose version is meaningful to encode
+ * in a User-Agent. Environments where a version string is not useful (e.g.
+ * browsers, where `version` is the full navigator UA) are intentionally mapped
+ * to `undefined` so they are omitted from the User-Agent.
+ */
+const RUNTIME_DISPLAY_NAMES = {
+    node: "Node",
+    deno: "Deno",
+    bun: "Bun",
+    browser: undefined,
+    "web-worker": undefined,
+    "react-native": undefined,
+    workerd: undefined,
+    "edge-runtime": undefined,
+    unknown: undefined,
+};
+/**
+ * Builds a structured User-Agent string of the form
+ *   `{sdkName}/{sdkVersion} ({os}; {arch}) {runtime}/{runtimeVersion}`
+ * where the platform group and runtime segment are omitted gracefully when the
+ * underlying values cannot be determined (e.g. in a browser).
+ */
+export function getUserAgent(sdkName, sdkVersion) {
+    let userAgent = `${sdkName}/${sdkVersion}`;
+    const platform = [RUNTIME.os, RUNTIME.arch].filter((part) => part != null && part.length > 0);
+    if (platform.length > 0) {
+        userAgent += ` (${platform.join("; ")})`;
+    }
+    const runtimeName = RUNTIME_DISPLAY_NAMES[RUNTIME.type];
+    if (runtimeName != null) {
+        userAgent += ` ${runtimeName}`;
+        if (RUNTIME.version != null && RUNTIME.version.length > 0) {
+            userAgent += `/${RUNTIME.version}`;
+        }
+    }
+    return userAgent;
+}

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "17.8.0";
+export declare const SDK_VERSION = "17.10.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "17.8.0";
+export const SDK_VERSION = "17.10.0";

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Phenoml API",
-    "version": "0f5e6fc5cd6ac889d00d6733e3b710e4fb90e90e"
+    "version": "4303ef3d3e7bb2159a5d8301937194e8bb681125"
   },
   "x-services": [
     {
@@ -2033,6 +2033,75 @@
         "x-service": "construe"
       }
     },
+    "/construe/phenocr": {
+      "post": {
+        "tags": [
+          "Construe / Codes"
+        ],
+        "operationId": "construe_phenocr",
+        "summary": "[Alpha] Extract medical codes with phenocr",
+        "description": "**Alpha:** phenocr is an alpha feature. The API contract \u2014 request\nparameters and response shape \u2014 may change as its internals evolve, and\nresults may vary between releases. Do not depend on it for production\nworkloads yet.\n\nExtracts medical codes from natural language clinical text using phenocr.\n\nSupported code systems: HPO, ICD-10-CM, and SNOMED_CT_US. The code\nsystem name and version are both required.\n",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/construe_PhenoCRRequest"
+              },
+              "examples": {
+                "hpo_phenotype_extraction": {
+                  "summary": "HPO Phenotype Extraction",
+                  "description": "Extract HPO phenotype terms from a clinical note.",
+                  "value": {
+                    "text": "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+                    "system": {
+                      "name": "HPO",
+                      "version": "umls-2026AA"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successfully extracted codes",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/construe_ExtractCodesResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "404": {
+            "description": "Code system not found"
+          },
+          "500": {
+            "description": "Server error"
+          },
+          "503": {
+            "description": "Service temporarily unavailable"
+          },
+          "504": {
+            "description": "Request timed out"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "x-service": "construe"
+      }
+    },
     "/construe/codes/systems": {
       "get": {
         "tags": [
@@ -8468,6 +8537,42 @@
           }
         }
       },
+      "construe_PhenoCRRequest": {
+        "type": "object",
+        "required": [
+          "text",
+          "system"
+        ],
+        "properties": {
+          "text": {
+            "type": "string",
+            "description": "Natural language text to extract codes from",
+            "example": "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia."
+          },
+          "system": {
+            "$ref": "#/components/schemas/construe_PhenocrExtractRequestSystem"
+          }
+        }
+      },
+      "construe_PhenocrExtractRequestSystem": {
+        "type": "object",
+        "required": [
+          "name",
+          "version"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Code system name. Supported by phenocr: HPO, ICD-10-CM, SNOMED_CT_US.\n",
+            "example": "HPO"
+          },
+          "version": {
+            "type": "string",
+            "description": "Code system version to run against.",
+            "example": "umls-2026AA"
+          }
+        }
+      },
       "construe_ExtractRequestSystem": {
         "type": "object",
         "properties": {

package/package.json

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

package/reference.md

@@ -1683,6 +1683,83 @@ await client.construe.codes.extract({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.construe.codes.<a href="/src/api/resources/construe/resources/codes/client/Client.ts">phenocr</a>({ ...params }) -> phenoml.ExtractCodesResult</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**Alpha:** phenocr is an alpha feature. The API contract — request
+parameters and response shape — may change as its internals evolve, and
+results may vary between releases. Do not depend on it for production
+workloads yet.
+
+Extracts medical codes from natural language clinical text using phenocr.
+
+Supported code systems: HPO, ICD-10-CM, and SNOMED_CT_US. The code
+system name and version are both required.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.construe.codes.phenocr({
+    text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
+    system: {
+        name: "HPO",
+        version: "umls-2026AA"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `phenoml.construe.PhenoCrRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CodesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>