phenoml 1.0.1 → 2.0.0

package/dist/cjs/api/resources/construe/errors/ServiceUnavailableError.js

@@ -0,0 +1,50 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceUnavailableError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class ServiceUnavailableError extends errors.phenomlError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ServiceUnavailableError",
+            statusCode: 503,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, ServiceUnavailableError.prototype);
+    }
+}
+exports.ServiceUnavailableError = ServiceUnavailableError;

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

@@ -2,4 +2,7 @@ export * from "./BadRequestError.js";
 export * from "./ConflictError.js";
 export * from "./FailedDependencyError.js";
 export * from "./InternalServerError.js";
+export * from "./NotFoundError.js";
+export * from "./NotImplementedError.js";
+export * from "./ServiceUnavailableError.js";
 export * from "./UnauthorizedError.js";

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

@@ -18,4 +18,7 @@ __exportStar(require("./BadRequestError.js"), exports);
 __exportStar(require("./ConflictError.js"), exports);
 __exportStar(require("./FailedDependencyError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
+__exportStar(require("./NotFoundError.js"), exports);
+__exportStar(require("./NotImplementedError.js"), exports);
+__exportStar(require("./ServiceUnavailableError.js"), exports);
 __exportStar(require("./UnauthorizedError.js"), exports);

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

@@ -0,0 +1,8 @@
+export interface CodeResponse {
+    /** The code identifier */
+    code: string;
+    /** Short description of the code */
+    description: string;
+    /** Extended definition of the code (if available) */
+    definition?: string;
+}

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

@@ -0,0 +1,10 @@
+export interface CodeSystemDetails {
+    /** Code system name */
+    name: string;
+    /** Code system version */
+    version: string;
+    /** Total number of codes in the system */
+    code_count: number;
+    /** Whether this is a built-in system (vs custom uploaded) */
+    builtin: boolean;
+}

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

@@ -0,0 +1,6 @@
+export interface CodeSystemInfo {
+    /** Code system name */
+    name: string;
+    /** Code system version */
+    version: string;
+}

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

@@ -0,0 +1,10 @@
+import type * as phenoml from "../../../index.js";
+export interface GetCodeResponse {
+    system: phenoml.construe.CodeSystemInfo;
+    /** The code identifier */
+    code: string;
+    /** Short description of the code */
+    description: string;
+    /** Extended definition of the code (if available) */
+    definition?: string;
+}

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

@@ -0,0 +1,4 @@
+import type * as phenoml from "../../../index.js";
+export interface ListCodeSystemsResponse {
+    systems: phenoml.construe.CodeSystemDetails[];
+}

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

@@ -0,0 +1,9 @@
+import type * as phenoml from "../../../index.js";
+export interface ListCodesResponse {
+    system: phenoml.construe.CodeSystemInfo;
+    codes: phenoml.construe.CodeResponse[];
+    /** Cursor for fetching the next page (null if no more results) */
+    next_cursor?: string;
+    /** Whether there are more results available */
+    has_more: boolean;
+}

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

@@ -0,0 +1,6 @@
+import type * as phenoml from "../../../index.js";
+export interface SemanticSearchResponse {
+    system: phenoml.construe.CodeSystemInfo;
+    /** Codes ordered by semantic similarity (most similar first) */
+    results: phenoml.construe.SemanticSearchResult[];
+}

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

@@ -0,0 +1,4 @@
+export interface SemanticSearchResult {
+    code: string;
+    description: string;
+}

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

@@ -0,0 +1,8 @@
+import type * as phenoml from "../../../index.js";
+export interface TextSearchResponse {
+    system: phenoml.construe.CodeSystemInfo;
+    /** Codes matching the search query */
+    results: phenoml.construe.TextSearchResult[];
+    /** Total number of matching results (may exceed results array due to pagination) */
+    found: number;
+}

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

@@ -0,0 +1,4 @@
+export interface TextSearchResult {
+    code: string;
+    description: string;
+}

package/dist/cjs/api/resources/construe/types/TextSearchResult.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

@@ -1,5 +1,15 @@
+export * from "./CodeResponse.js";
+export * from "./CodeSystemDetails.js";
+export * from "./CodeSystemInfo.js";
 export * from "./ConstrueUploadCodeSystemResponse.js";
 export * from "./ExtractCodesResult.js";
 export * from "./ExtractedCodeResult.js";
 export * from "./ExtractRequestConfig.js";
 export * from "./ExtractRequestSystem.js";
+export * from "./GetCodeResponse.js";
+export * from "./ListCodeSystemsResponse.js";
+export * from "./ListCodesResponse.js";
+export * from "./SemanticSearchResponse.js";
+export * from "./SemanticSearchResult.js";
+export * from "./TextSearchResponse.js";
+export * from "./TextSearchResult.js";

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

@@ -14,8 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CodeResponse.js"), exports);
+__exportStar(require("./CodeSystemDetails.js"), exports);
+__exportStar(require("./CodeSystemInfo.js"), exports);
 __exportStar(require("./ConstrueUploadCodeSystemResponse.js"), exports);
 __exportStar(require("./ExtractCodesResult.js"), exports);
 __exportStar(require("./ExtractedCodeResult.js"), exports);
 __exportStar(require("./ExtractRequestConfig.js"), exports);
 __exportStar(require("./ExtractRequestSystem.js"), exports);
+__exportStar(require("./GetCodeResponse.js"), exports);
+__exportStar(require("./ListCodeSystemsResponse.js"), exports);
+__exportStar(require("./ListCodesResponse.js"), exports);
+__exportStar(require("./SemanticSearchResponse.js"), exports);
+__exportStar(require("./SemanticSearchResult.js"), exports);
+__exportStar(require("./TextSearchResponse.js"), exports);
+__exportStar(require("./TextSearchResult.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.1";
+export declare const SDK_VERSION = "2.0.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 = "1.0.1";
+exports.SDK_VERSION = "2.0.0";

package/dist/esm/Client.mjs

@@ -16,8 +16,8 @@ export class phenomlClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "phenoml",
-                "X-Fern-SDK-Version": "1.0.1",
-                "User-Agent": "phenoml/1.0.1",
+                "X-Fern-SDK-Version": "2.0.0",
+                "User-Agent": "phenoml/2.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/esm/api/resources/agent/resources/prompts/client/Client.d.mts

@@ -24,8 +24,7 @@ export declare class Prompts {
      * @example
      *     await client.agent.prompts.create({
      *         name: "Medical Assistant System Prompt",
-     *         content: "You are a helpful medical assistant specialized in FHIR data processing...",
-     *         is_active: true
+     *         content: "You are a helpful medical assistant specialized in FHIR data processing..."
      *     })
      */
     create(request: phenoml.agent.AgentPromptsCreateRequest, requestOptions?: Prompts.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentPromptsResponse>;
@@ -79,7 +78,7 @@ export declare class Prompts {
     update(id: string, request?: phenoml.agent.AgentPromptsUpdateRequest, requestOptions?: Prompts.RequestOptions): core.HttpResponsePromise<phenoml.agent.AgentPromptsResponse>;
     private __update;
     /**
-     * Soft deletes a prompt by setting is_active to false
+     * Deletes a prompt
      *
      * @param {string} id - Prompt ID
      * @param {Prompts.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/agent/resources/prompts/client/Client.mjs

@@ -31,8 +31,7 @@ export class Prompts {
      * @example
      *     await client.agent.prompts.create({
      *         name: "Medical Assistant System Prompt",
-     *         content: "You are a helpful medical assistant specialized in FHIR data processing...",
-     *         is_active: true
+     *         content: "You are a helpful medical assistant specialized in FHIR data processing..."
      *     })
      */
     create(request, requestOptions) {
@@ -300,7 +299,7 @@ export class Prompts {
         });
     }
     /**
-     * Soft deletes a prompt by setting is_active to false
+     * Deletes a prompt
      *
      * @param {string} id - Prompt ID
      * @param {Prompts.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/agent/resources/prompts/client/requests/AgentPromptsCreateRequest.d.mts

@@ -2,8 +2,7 @@
  * @example
  *     {
  *         name: "Medical Assistant System Prompt",
- *         content: "You are a helpful medical assistant specialized in FHIR data processing...",
- *         is_active: true
+ *         content: "You are a helpful medical assistant specialized in FHIR data processing..."
  *     }
  */
 export interface AgentPromptsCreateRequest {
@@ -15,8 +14,6 @@ export interface AgentPromptsCreateRequest {
     content: string;
     /** Whether this is a default prompt */
     is_default?: boolean;
-    /** Whether the prompt is active */
-    is_active: boolean;
     /** Tags for categorizing the prompt */
     tags?: string[];
 }

package/dist/esm/api/resources/agent/resources/prompts/client/requests/AgentPromptsUpdateRequest.d.mts

@@ -11,8 +11,6 @@ export interface AgentPromptsUpdateRequest {
     content?: string;
     /** Whether this is a default prompt */
     is_default?: boolean;
-    /** Whether the prompt is active */
-    is_active?: boolean;
     /** Tags for categorizing the prompt */
     tags?: string[];
 }

package/dist/esm/api/resources/agent/types/AgentTemplate.d.mts

@@ -9,8 +9,6 @@ export interface AgentTemplate {
     prompts?: string[];
     /** Array of MCP server tool IDs used by this agent */
     tools?: string[];
-    /** Whether the agent is active */
-    is_active?: boolean;
     /** Tags for categorizing the agent */
     tags?: string[];
     /** FHIR provider ID(s) - must be valid UUIDs from existing FHIR providers */

package/dist/esm/api/resources/agent/types/PromptTemplate.d.mts

@@ -9,8 +9,6 @@ export interface PromptTemplate {
     content?: string;
     /** Whether this is a default prompt */
     is_default?: boolean;
-    /** Whether the prompt is active */
-    is_active?: boolean;
     /** Tags for categorizing the prompt */
     tags?: string[];
 }

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

@@ -52,5 +52,134 @@ export declare class Construe {
      */
     extractCodes(request: phenoml.construe.ExtractRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
     private __extractCodes;
+    /**
+     * Returns metadata about all available code systems including built-in and custom systems.
+     *
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.listAvailableCodeSystems()
+     */
+    listAvailableCodeSystems(requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ListCodeSystemsResponse>;
+    private __listAvailableCodeSystems;
+    /**
+     * Returns a paginated list of all codes in the specified code system.
+     *
+     * @param {string} codesystem - Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")
+     * @param {phenoml.construe.GetConstrueCodesCodesystemRequest} request
+     * @param {Construe.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}
+     *
+     * @example
+     *     await client.construe.listCodesInACodeSystem("ICD-10-CM", {
+     *         version: "2025",
+     *         cursor: "cursor",
+     *         limit: 1
+     *     })
+     */
+    listCodesInACodeSystem(codesystem: string, request?: phenoml.construe.GetConstrueCodesCodesystemRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ListCodesResponse>;
+    private __listCodesInACodeSystem;
+    /**
+     * Returns details for a specific code within a code system.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {string} codeId - The code identifier
+     * @param {phenoml.construe.GetConstrueCodesCodesystemCodeIdRequest} request
+     * @param {Construe.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}
+     *
+     * @example
+     *     await client.construe.getASpecificCode("ICD-10-CM", "E11.65", {
+     *         version: "version"
+     *     })
+     */
+    getASpecificCode(codesystem: string, codeId: string, request?: phenoml.construe.GetConstrueCodesCodesystemCodeIdRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.GetCodeResponse>;
+    private __getASpecificCode;
+    /**
+     * Performs semantic similarity search using vector embeddings.
+     *
+     * **When to use**: Best for natural language queries where you want to find conceptually
+     * related codes, even when different terminology is used. The search understands meaning,
+     * not just keywords.
+     *
+     * **Examples**:
+     * - Query "trouble breathing at night" finds codes like "Sleep apnea", "Orthopnea",
+     *   "Nocturnal dyspnea" — semantically related but no exact keyword matches
+     * - Query "heart problems" finds "Myocardial infarction", "Cardiac arrest", "Arrhythmia"
+     *
+     * **Trade-offs**: Slower than text search (requires embedding generation), but finds
+     * conceptually similar results that keyword search would miss.
+     *
+     * See also: `/search/text` for faster keyword-based lookup with typo tolerance.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesCodesystemSearchSemanticRequest} request
+     * @param {Construe.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}
+     *
+     * @example
+     *     await client.construe.semanticSearchEmbeddingBased("ICD-10-CM", {
+     *         text: "patient has trouble breathing at night and wakes up gasping",
+     *         version: "version",
+     *         limit: 1
+     *     })
+     */
+    semanticSearchEmbeddingBased(codesystem: string, request: phenoml.construe.GetConstrueCodesCodesystemSearchSemanticRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.SemanticSearchResponse>;
+    private __semanticSearchEmbeddingBased;
+    /**
+     * Performs fast full-text search over code IDs and descriptions.
+     *
+     * **When to use**: Best for autocomplete UIs, code lookup, or when users know part of
+     * the code ID or specific keywords. Fast response times suitable for typeahead interfaces.
+     *
+     * **Features**:
+     * - Substring matching on code IDs (e.g., "11.65" finds "E11.65")
+     * - Typo tolerance on descriptions (not on code IDs)
+     * - Fast response times (~10-50ms)
+     *
+     * **Examples**:
+     * - Query "E11" finds all codes starting with E11 (diabetes codes)
+     * - Query "diabtes" (typo) still finds "diabetes" codes
+     *
+     * **Trade-offs**: Faster than semantic search, but only matches keywords/substrings.
+     * Won't find conceptually related codes with different terminology.
+     *
+     * See also: `/search/semantic` for finding conceptually similar codes.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesCodesystemSearchTextRequest} request
+     * @param {Construe.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.NotImplementedError}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.construe.textSearchKeywordBased("ICD-10-CM", {
+     *         q: "E11.65",
+     *         version: "version",
+     *         limit: 1
+     *     })
+     */
+    textSearchKeywordBased(codesystem: string, request: phenoml.construe.GetConstrueCodesCodesystemSearchTextRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.TextSearchResponse>;
+    private __textSearchKeywordBased;
     protected _getAuthorizationHeader(): Promise<string>;
 }