@awell-health/awell-extensions 2.0.151 → 2.0.153

package/dist/extensions/elation/actions/index.d.ts

@@ -50,13 +50,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "status" | "firstName" | "lastName" | "email" | "dob" | "mobilePhone" | "preferredLanguage" | "sex" | "genderIdentity" | "middleName" | "notes" | "pronouns" | "ssn" | "race" | "ethnicity" | "primaryPhysicianId" | "caregiverPracticeId" | "mainPhone" | "actualName" | "legalGenderMarker" | "sexualOrientation" | "previousFirstName" | "previousLastName" | "preferredServiceLocationId" | "patientObject">;
     createPatient: import("@awell-health/extensions-core").Action<{
         firstName: {
@@ -243,13 +236,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "patientId">;
     updatePatient: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -434,13 +420,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, never>;
     createAppointment: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -545,13 +524,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "appointmentId">;
     getAppointment: import("@awell-health/extensions-core").Action<{
         appointmentId: {
@@ -604,13 +576,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "practiceId" | "status" | "patientId" | "duration" | "reason" | "description" | "physicianId" | "appointment" | "scheduledDate" | "serviceLocationId" | "telehealthDetails">;
     findAppointments: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -696,13 +661,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "appointments" | "appointment_exists">;
     getPharmacy: import("@awell-health/extensions-core").Action<{
         ncpdpId: {
@@ -755,13 +713,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, string>;
     getPhysician: import("@awell-health/extensions-core").Action<{
         physicianId: {
@@ -814,13 +765,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "caregiverPracticeId" | "physicianFirstName" | "physicianLastName" | "physicianCredentials" | "physicianEmail" | "physicianNPI" | "physicianUserId">;
     findPhysician: import("@awell-health/extensions-core").Action<{
         firstName: {
@@ -887,13 +831,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "physicianId" | "caregiverPracticeId" | "physicianFirstName" | "physicianLastName" | "physicianCredentials" | "physicianEmail" | "physicianNPI" | "physicianUserId">;
     createNonVisitNote: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -974,13 +911,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "nonVisitNoteId" | "nonVisitNoteBulletId">;
     updateNonVisitNote: import("@awell-health/extensions-core").Action<{
         nonVisitNoteId: {
@@ -1103,13 +1033,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, string>;
     getNonVisitNote: import("@awell-health/extensions-core").Action<{
         nonVisitNoteId: {
@@ -1162,13 +1085,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "practiceId" | "patientId" | "text" | "authorId" | "tags" | "documentDate" | "chartDate">;
     deleteNonVisitNote: import("@awell-health/extensions-core").Action<{
         nonVisitNoteId: {
@@ -1221,13 +1137,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, string>;
     createVisitNote: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -1341,13 +1250,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "visitNoteId">;
     addVitals: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -1596,13 +1498,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "vitalsId">;
     addHistory: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -1675,13 +1570,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, string>;
     addAllergy: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -1762,13 +1650,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "allergyId">;
     postLetter: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -1863,13 +1744,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "letterId">;
     createLabOrder: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -1971,13 +1845,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "labOrderId" | "printableLabOrderView">;
     createMessageThread: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -2079,13 +1946,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "messageThreadId">;
     getLetter: import("@awell-health/extensions-core").Action<{
         letterId: {
@@ -2138,13 +1998,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "body" | "signedBy">;
     createReferralOrder: import("@awell-health/extensions-core").Action<{
         patient: {
@@ -2245,13 +2098,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "id">;
     createCareGap: import("@awell-health/extensions-core").Action<{
         quality_program: {
@@ -2352,13 +2198,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "id">;
     closeCareGap: import("@awell-health/extensions-core").Action<{
         quality_program: {
@@ -2418,13 +2257,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, never>;
     updatePatientTags: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -2484,13 +2316,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "updatedTags">;
     getReferralOrder: import("@awell-health/extensions-core").Action<{
         referralOrderId: {
@@ -2543,13 +2368,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "patientId" | "practice" | "letterId" | "consultantName" | "diagnosisCodes" | "diagnosisLabels">;
     findFutureAppointment: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -2609,13 +2427,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "appointment" | "explanation" | "appointmentExists">;
     findAppointmentsByPrompt: import("@awell-health/extensions-core").Action<{
         patientId: {
@@ -2675,13 +2486,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, "appointments" | "explanation" | "appointmentCountsByStatus">;
     signNonVisitNote: import("@awell-health/extensions-core").Action<{
         nonVisitNoteId: {
@@ -2741,13 +2545,6 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, never>;
     updateReferralOrderResolution: import("@awell-health/extensions-core").Action<{
         referralOrderId: {
@@ -2811,12 +2608,5 @@ export declare const actions: {
             description: string;
             required: false;
         };
-        openAiApiKey: {
-            key: string;
-            label: string;
-            obfuscated: true;
-            required: false;
-            description: string;
-        };
     }, never>;
 };

package/dist/extensions/elation/actions/updatePatientTags/config/types.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { StructuredOutputParser } from '@langchain/core/output_parsers';
+export declare const SingleTagSchema: z.ZodString;
+export declare const TagsSchema: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+export declare const TagsOutputSchema: z.ZodObject<{
+    updatedTags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    explanation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    updatedTags: string[];
+    explanation: string;
+}, {
+    updatedTags: string[];
+    explanation: string;
+}>;
+export declare const parser: StructuredOutputParser<z.ZodObject<{
+    updatedTags: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    explanation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    updatedTags: string[];
+    explanation: string;
+}, {
+    updatedTags: string[];
+    explanation: string;
+}>>;
+export type TagsOutput = z.infer<typeof TagsOutputSchema>;
+export interface TagsFromAI {
+    validatedTags: string[];
+    explanation: string;
+}

package/dist/extensions/elation/actions/updatePatientTags/config/types.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parser = exports.TagsOutputSchema = exports.TagsSchema = exports.SingleTagSchema = void 0;
+const zod_1 = require("zod");
+const output_parsers_1 = require("@langchain/core/output_parsers");
+exports.SingleTagSchema = zod_1.z.string().max(100).describe('A single tag');
+exports.TagsSchema = zod_1.z
+    .array(exports.SingleTagSchema)
+    .max(10)
+    .refine((items) => new Set(items).size === items.length, {
+    message: 'All items must be unique, no duplicate values allowed',
+})
+    .describe('The updated array of tags');
+exports.TagsOutputSchema = zod_1.z.object({
+    updatedTags: exports.TagsSchema,
+    explanation: zod_1.z
+        .string()
+        .describe('A readable explanation of the changes made to the tags and why'),
+});
+exports.parser = output_parsers_1.StructuredOutputParser.fromZodSchema(exports.TagsOutputSchema);
+//# sourceMappingURL=types.js.map

package/dist/extensions/elation/actions/updatePatientTags/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../extensions/elation/actions/updatePatientTags/config/types.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,mEAAuE;AAE1D,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;AAE9D,QAAA,UAAU,GAAG,OAAC;KACxB,KAAK,CAAC,uBAAe,CAAC;KACtB,GAAG,CAAC,EAAE,CAAC;KACP,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,uDAAuD;CACjE,CAAC;KACD,QAAQ,CAAC,2BAA2B,CAAC,CAAA;AAE3B,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,kBAAU;IACvB,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,QAAQ,CAAC,gEAAgE,CAAC;CAChF,CAAC,CAAA;AAEW,QAAA,MAAM,GAAG,uCAAsB,CAAC,aAAa,CAAC,wBAAgB,CAAC,CAAA"}

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/getTagsFromLLM.d.ts

@@ -0,0 +1,13 @@
+import { type ChatOpenAI } from '@langchain/openai';
+import { type AIActionMetadata } from '../../../../../../src/lib/llm/openai/types';
+import { type TagsFromAI } from './parser';
+import type { BaseCallbackHandler } from "@langchain/core/callbacks/base";
+interface GetTagsFromLLMProps {
+    model: ChatOpenAI;
+    existingTags: string[];
+    prompt: string;
+    metadata: AIActionMetadata;
+    callbacks?: BaseCallbackHandler[];
+}
+export declare const getTagsFromLLM: (props: GetTagsFromLLMProps) => Promise<TagsFromAI>;
+export {};

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/getTagsFromLLM.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTagsFromLLM = void 0;
+const prompt_1 = require("./prompt");
+const parser_1 = require("./parser");
+const getTagsFromLLM = async (props) => {
+    const { model, existingTags, prompt, metadata, callbacks } = props;
+    try {
+        const chain = model.pipe(parser_1.parser);
+        const formattedPrompt = await prompt_1.systemPrompt.format({
+            existingTags: JSON.stringify(existingTags),
+            prompt
+        });
+        const result = await chain.invoke(formattedPrompt, {
+            metadata,
+            runName: 'ElationUpdatePatientTags',
+            callbacks
+        });
+        return {
+            validatedTags: result.updatedTags,
+            explanation: result.explanation
+        };
+    }
+    catch (error) {
+        throw new Error('Failed to update patient tags.');
+    }
+};
+exports.getTagsFromLLM = getTagsFromLLM;
+//# sourceMappingURL=getTagsFromLLM.js.map

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/getTagsFromLLM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTagsFromLLM.js","sourceRoot":"","sources":["../../../../../../../extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/getTagsFromLLM.ts"],"names":[],"mappings":";;;AAEA,qCAAuC;AACvC,qCAAkD;AAW3C,MAAM,cAAc,GAAG,KAAK,EAAE,KAA0B,EAAuB,EAAE;IACtF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAElE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,eAAM,CAAC,CAAA;QAChC,MAAM,eAAe,GAAG,MAAM,qBAAY,CAAC,MAAM,CAAC;YAChD,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;YAC1C,MAAM;SACP,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAC/B,eAAe,EACf;YACE,QAAQ;YACR,OAAO,EAAE,0BAA0B;YACnC,SAAS;SACV,CACF,CAAA;QAED,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,WAAW;YACjC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACnD,CAAC;AACH,CAAC,CAAA;AAzBY,QAAA,cAAc,kBAyB1B"}

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/parser.d.ts

@@ -0,0 +1,13 @@
+import { StructuredOutputParser } from '@langchain/core/output_parsers';
+import { type TagsFromAI } from '../../config/types';
+export declare const parser: StructuredOutputParser<import("zod").ZodObject<{
+    updatedTags: import("zod").ZodEffects<import("zod").ZodArray<import("zod").ZodString, "many">, string[], string[]>;
+    explanation: import("zod").ZodString;
+}, "strip", import("zod").ZodTypeAny, {
+    updatedTags: string[];
+    explanation: string;
+}, {
+    updatedTags: string[];
+    explanation: string;
+}>>;
+export type { TagsFromAI };

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/parser.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parser = void 0;
+const output_parsers_1 = require("@langchain/core/output_parsers");
+const types_1 = require("../../config/types");
+exports.parser = output_parsers_1.StructuredOutputParser.fromZodSchema(types_1.TagsOutputSchema);
+//# sourceMappingURL=parser.js.map

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../../../extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/parser.ts"],"names":[],"mappings":";;;AAAA,mEAAuE;AACvE,8CAAsE;AAEzD,QAAA,MAAM,GAAG,uCAAsB,CAAC,aAAa,CAAC,wBAAgB,CAAC,CAAA"}

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/prompt.d.ts

@@ -0,0 +1,2 @@
+import { ChatPromptTemplate } from '@langchain/core/prompts';
+export declare const systemPrompt: ChatPromptTemplate<import("@langchain/core/prompts").ParamsFromFString<"\nYou are a clinical data manager. You will receive a list (array) of patient tags for a single patient and instructions about which tags to add, update, or remove. These tags are used to assign particular attributes to patients which can help with patient care, like grouping of patients, categorizing patients for reporting, or identifying patients for care.\n        \n      Important instructions:\n      - The maximum number of tags is 10.\n      - The max length of a single tag is 100 characters.\n      - Ensure tags are unique.\n\n\n  Input array: {existingTags}\n  Instruction: {prompt}\n\n\nOutput a JSON object with two keys:\n1. updatedTags: The updated array of tags. If the input array is empty, the output should be an empty array.\n2. explanation: A readable explanation of the changes made to the tags and why\n">, any>;

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/prompt.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemPrompt = void 0;
+const prompts_1 = require("@langchain/core/prompts");
+exports.systemPrompt = prompts_1.ChatPromptTemplate.fromTemplate(`
+You are a clinical data manager. You will receive a list (array) of patient tags for a single patient and instructions about which tags to add, update, or remove. These tags are used to assign particular attributes to patients which can help with patient care, like grouping of patients, categorizing patients for reporting, or identifying patients for care.
+        
+      Important instructions:
+      - The maximum number of tags is 10.
+      - The max length of a single tag is 100 characters.
+      - Ensure tags are unique.
+
+
+  Input array: {existingTags}
+  Instruction: {prompt}
+
+
+Output a JSON object with two keys:
+1. updatedTags: The updated array of tags. If the input array is empty, the output should be an empty array.
+2. explanation: A readable explanation of the changes made to the tags and why
+`);
+//# sourceMappingURL=prompt.js.map

package/dist/extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../../../../extensions/elation/actions/updatePatientTags/lib/getTagsFromLLM/prompt.ts"],"names":[],"mappings":";;;AAAA,qDAA4D;AAE/C,QAAA,YAAY,GAAG,4BAAkB,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;;CAgB3D,CAAC,CAAA"}

package/dist/extensions/elation/actions/updatePatientTags/updatePatientTags.d.ts

@@ -1,4 +1,12 @@
 import { type Action } from '@awell-health/extensions-core';
 import { type settings } from '../../settings';
 import { fields, dataPoints } from './config';
+/**
+ * Awell Action: Update Patient Tags
+ *
+ * Takes existing tags and instructions, uses LLM to:
+ * 1. Generate updated list of tags
+ * 2. Provide explanation for changes
+ * 3. Update tags in Elation
+ */
 export declare const updatePatientTags: Action<typeof fields, typeof settings, keyof typeof dataPoints>;