@awell-health/awell-extensions 2.0.197 → 2.0.198

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

@@ -0,0 +1,12 @@
+import { type Action } from '@awell-health/extensions-core';
+import { type settings } from '../../settings';
+import { fields, dataPoints } from './config';
+/**
+ * Awell Action: Check Patient Tags
+ *
+ * Takes existing tags and instructions, uses LLM to:
+ * 1. Verify if tags match the given instruction
+ * 2. Provide explanation for the verification result
+ * 3. Return boolean result indicating if tags exist as specified
+ */
+export declare const checkPatientTags: Action<typeof fields, typeof settings, keyof typeof dataPoints>;

package/dist/extensions/elation/actions/checkPatientTags/checkPatientTags.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkPatientTags = void 0;
+const extensions_core_1 = require("@awell-health/extensions-core");
+const addEventLog_1 = require("../../../../src/lib/awell/addEventLog");
+const client_1 = require("../../client");
+const config_1 = require("./config");
+const checkTagsWithLLM_1 = require("./lib/checkTagsWithLLM/checkTagsWithLLM");
+const createOpenAIModel_1 = require("../../../../src/lib/llm/openai/createOpenAIModel");
+const constants_1 = require("../../../../src/lib/llm/openai/constants");
+/**
+ * Awell Action: Check Patient Tags
+ *
+ * Takes existing tags and instructions, uses LLM to:
+ * 1. Verify if tags match the given instruction
+ * 2. Provide explanation for the verification result
+ * 3. Return boolean result indicating if tags exist as specified
+ */
+exports.checkPatientTags = {
+    key: 'checkPatientTags',
+    category: extensions_core_1.Category.EHR_INTEGRATIONS,
+    title: '✨ Check Patient Tags',
+    description: 'Verify if patient tags in Elation match the given instruction.',
+    fields: config_1.fields,
+    previewable: false,
+    dataPoints: config_1.dataPoints,
+    onEvent: async ({ payload, onComplete, onError, helpers }) => {
+        // 1. Validate input and initialize API client
+        const { instructions, patientId } = config_1.FieldsValidationSchema.parse(payload.fields);
+        const api = (0, client_1.makeAPIClient)(payload.settings);
+        // 2. Get existing tags
+        const { tags } = await api.getPatient(patientId);
+        const existingTags = tags !== null && tags !== void 0 ? tags : [];
+        // 3. Initialize OpenAI model with metadata and callbacks
+        const { model, metadata, callbacks } = await (0, createOpenAIModel_1.createOpenAIModel)({
+            settings: {}, // we use built-in API key for OpenAI
+            helpers,
+            payload,
+            modelType: constants_1.OPENAI_MODELS.GPT4o,
+        });
+        // 4. Check tags against instruction
+        const { tagsFound, explanation } = await (0, checkTagsWithLLM_1.checkTagsWithLLM)({
+            model,
+            existingTags,
+            instructions,
+            metadata,
+            callbacks,
+        });
+        // 5. Complete action with results
+        await onComplete({
+            data_points: {
+                tagsFound: tagsFound ? 'true' : 'false',
+                explanation,
+            },
+            events: [
+                (0, addEventLog_1.addActivityEventLog)({
+                    message: `Patient tags: ${(existingTags === null || existingTags === void 0 ? void 0 : existingTags.length) > 0 ? existingTags === null || existingTags === void 0 ? void 0 : existingTags.join(', ') : 'No tags'}\nInstruction: ${instructions}\nResult: ${tagsFound ? 'true' : 'false'}\nExplanation: ${explanation}`,
+                }),
+            ],
+        });
+    },
+};
+//# sourceMappingURL=checkPatientTags.js.map

package/dist/extensions/elation/actions/checkPatientTags/checkPatientTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPatientTags.js","sourceRoot":"","sources":["../../../../../extensions/elation/actions/checkPatientTags/checkPatientTags.ts"],"names":[],"mappings":";;;AAAA,mEAAqE;AACrE,uEAA2E;AAE3E,yCAA4C;AAC5C,qCAAqE;AACrE,8EAA0E;AAC1E,wFAAoF;AACpF,wEAAwE;AAExE;;;;;;;GAOG;AACU,QAAA,gBAAgB,GAIzB;IACF,GAAG,EAAE,kBAAkB;IACvB,QAAQ,EAAE,0BAAQ,CAAC,gBAAgB;IACnC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,gEAAgE;IAC7E,MAAM,EAAN,eAAM;IACN,WAAW,EAAE,KAAK;IAClB,UAAU,EAAV,mBAAU;IACV,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAiB,EAAE;QAC1E,8CAA8C;QAC9C,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,+BAAsB,CAAC,KAAK,CAC9D,OAAO,CAAC,MAAM,CACf,CAAA;QACD,MAAM,GAAG,GAAG,IAAA,sBAAa,EAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3C,uBAAuB;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QAChD,MAAM,YAAY,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,CAAA;QAE/B,yDAAyD;QACzD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,qCAAiB,EAAC;YAC7D,QAAQ,EAAE,EAAE,EAAE,qCAAqC;YACnD,OAAO;YACP,OAAO;YACP,SAAS,EAAE,yBAAa,CAAC,KAAK;SAC/B,CAAC,CAAA;QAEF,oCAAoC;QACpC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,mCAAgB,EAAC;YACxD,KAAK;YACL,YAAY;YACZ,YAAY;YACZ,QAAQ;YACR,SAAS;SACV,CAAC,CAAA;QAEF,kCAAkC;QAClC,MAAM,UAAU,CAAC;YACf,WAAW,EAAE;gBACX,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;gBACvC,WAAW;aACZ;YACD,MAAM,EAAE;gBACN,IAAA,iCAAmB,EAAC;oBAClB,OAAO,EAAE,iBAAiB,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,MAAM,IAAG,CAAC,CAAC,CAAC,CAAC,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,kBAAkB,YAAY,aAAa,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,kBAAkB,WAAW,EAAE;iBAChM,CAAC;aACH;SACF,CAAC,CAAA;IACJ,CAAC;CACF,CAAA"}

package/dist/extensions/elation/actions/checkPatientTags/config/dataPoints.d.ts

@@ -0,0 +1,10 @@
+export declare const dataPoints: {
+    tagsFound: {
+        key: string;
+        valueType: "boolean";
+    };
+    explanation: {
+        key: string;
+        valueType: "string";
+    };
+};

package/dist/extensions/elation/actions/checkPatientTags/config/dataPoints.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataPoints = void 0;
+exports.dataPoints = {
+    tagsFound: {
+        key: 'tagsFound',
+        valueType: 'boolean',
+    },
+    explanation: {
+        key: 'explanation',
+        valueType: 'string',
+    }
+};
+//# sourceMappingURL=dataPoints.js.map

package/dist/extensions/elation/actions/checkPatientTags/config/dataPoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataPoints.js","sourceRoot":"","sources":["../../../../../../extensions/elation/actions/checkPatientTags/config/dataPoints.ts"],"names":[],"mappings":";;;AAEa,QAAA,UAAU,GAAG;IACxB,SAAS,EAAE;QACT,GAAG,EAAE,WAAW;QAChB,SAAS,EAAE,SAAS;KACrB;IACD,WAAW,EAAE;QACX,GAAG,EAAE,aAAa;QAClB,SAAS,EAAE,QAAQ;KACpB;CAC4C,CAAA"}

package/dist/extensions/elation/actions/checkPatientTags/config/fields.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { FieldType } from '@awell-health/extensions-core';
+export declare const fields: {
+    patientId: {
+        id: string;
+        label: string;
+        type: FieldType.NUMERIC;
+        required: true;
+        description: string;
+    };
+    instructions: {
+        id: string;
+        label: string;
+        type: FieldType.TEXT;
+        required: true;
+        description: string;
+    };
+};
+export declare const FieldsValidationSchema: z.ZodObject<{
+    patientId: z.ZodNumber;
+    instructions: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    patientId: number;
+    instructions: string;
+}, {
+    patientId: number;
+    instructions: string;
+}>;

package/dist/extensions/elation/actions/checkPatientTags/config/fields.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldsValidationSchema = exports.fields = void 0;
+const zod_1 = require("zod");
+const extensions_core_1 = require("@awell-health/extensions-core");
+exports.fields = {
+    patientId: {
+        id: 'patientId',
+        label: 'Elation patient ID',
+        type: extensions_core_1.FieldType.NUMERIC,
+        required: true,
+        description: '',
+    },
+    instructions: {
+        id: 'instructions',
+        label: 'Instructions for checking tags',
+        type: extensions_core_1.FieldType.TEXT,
+        required: true,
+        description: 'Provide clear instructions for checking presence of absence of tags. For example: "Check if the patient has the tag \'Eligible\'" or "Make sure the patient has tag \'A\' but does not have tag \'B\'"'
+    },
+};
+exports.FieldsValidationSchema = zod_1.z.object({
+    patientId: extensions_core_1.NumericIdSchema,
+    instructions: zod_1.z.string().min(1),
+});
+//# sourceMappingURL=fields.js.map

package/dist/extensions/elation/actions/checkPatientTags/config/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../../../extensions/elation/actions/checkPatientTags/config/fields.ts"],"names":[],"mappings":";;;AAAA,6BAAwC;AACxC,mEAIsC;AAEzB,QAAA,MAAM,GAAG;IACpB,SAAS,EAAE;QACT,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,2BAAS,CAAC,OAAO;QACvB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,EAAE;KAChB;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,gCAAgC;QACvC,IAAI,EAAE,2BAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,wMAAwM;KACtN;CAC8B,CAAA;AAEpB,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,iCAAe;IAC1B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACkB,CAAC,CAAA"}

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

@@ -0,0 +1,2 @@
+export { dataPoints } from './dataPoints';
+export { fields, FieldsValidationSchema } from './fields';

package/dist/extensions/elation/actions/checkPatientTags/config/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldsValidationSchema = exports.fields = exports.dataPoints = void 0;
+var dataPoints_1 = require("./dataPoints");
+Object.defineProperty(exports, "dataPoints", { enumerable: true, get: function () { return dataPoints_1.dataPoints; } });
+var fields_1 = require("./fields");
+Object.defineProperty(exports, "fields", { enumerable: true, get: function () { return fields_1.fields; } });
+Object.defineProperty(exports, "FieldsValidationSchema", { enumerable: true, get: function () { return fields_1.FieldsValidationSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/extensions/elation/actions/checkPatientTags/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../extensions/elation/actions/checkPatientTags/config/index.ts"],"names":[],"mappings":";;;AAAA,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AACnB,mCAAyD;AAAhD,gGAAA,MAAM,OAAA;AAAE,gHAAA,sBAAsB,OAAA"}

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

@@ -0,0 +1 @@
+export { checkPatientTags } from './checkPatientTags';

package/dist/extensions/elation/actions/checkPatientTags/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkPatientTags = void 0;
+var checkPatientTags_1 = require("./checkPatientTags");
+Object.defineProperty(exports, "checkPatientTags", { enumerable: true, get: function () { return checkPatientTags_1.checkPatientTags; } });
+//# sourceMappingURL=index.js.map

package/dist/extensions/elation/actions/checkPatientTags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../extensions/elation/actions/checkPatientTags/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA"}

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/checkTagsWithLLM.d.ts

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

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/checkTagsWithLLM.js

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

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/checkTagsWithLLM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkTagsWithLLM.js","sourceRoot":"","sources":["../../../../../../../extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/checkTagsWithLLM.ts"],"names":[],"mappings":";;;AAGA,qCAAuC;AACvC,qCAAuD;AAUhD,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAA4B,EAA4B,EAAE;IAC/F,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAExE,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,YAAY;SACb,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAC/B,eAAe,EACf;YACE,QAAQ;YACR,OAAO,EAAE,yBAAyB;YAClC,SAAS;SACV,CACF,CAAA;QAED,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;AACH,CAAC,CAAA;AAzBY,QAAA,gBAAgB,oBAyB5B"}

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/parser.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { StructuredOutputParser } from 'langchain/output_parsers';
+export declare const CheckTagsOutputSchema: z.ZodObject<{
+    tagsFound: z.ZodBoolean;
+    explanation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    explanation: string;
+    tagsFound: boolean;
+}, {
+    explanation: string;
+    tagsFound: boolean;
+}>;
+export type CheckTagsOutput = z.infer<typeof CheckTagsOutputSchema>;
+export declare const parser: StructuredOutputParser<z.ZodObject<{
+    tagsFound: z.ZodBoolean;
+    explanation: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    explanation: string;
+    tagsFound: boolean;
+}, {
+    explanation: string;
+    tagsFound: boolean;
+}>>;

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/parser.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parser = exports.CheckTagsOutputSchema = void 0;
+const zod_1 = require("zod");
+const output_parsers_1 = require("langchain/output_parsers");
+exports.CheckTagsOutputSchema = zod_1.z.object({
+    tagsFound: zod_1.z.boolean(),
+    explanation: zod_1.z.string(),
+});
+exports.parser = output_parsers_1.StructuredOutputParser.fromZodSchema(exports.CheckTagsOutputSchema);
+//# sourceMappingURL=parser.js.map

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../../../extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/parser.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,6DAAiE;AAEpD,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE;IACtB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAA;AAIW,QAAA,MAAM,GAAG,uCAAsB,CAAC,aAAa,CAAC,6BAAqB,CAAC,CAAA"}

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/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 expert** verifying patient tags against a given instruction.\nAnalyze the provided patient tags to determine if the instruction's conditions are satisfied.\n\n### Input\n- **Existing Patient Tags**: May be empty if no tags are assigned.\n- **Instruction**: Describes which tag(s) to check. It can:\n  - Involve a single tag (e.g., \"Check if 'Eligible' is present\").\n  - Require multiple tags (e.g., \"Ensure 'A' is present and 'B' is absent\").\n  - Specify conditional logic (e.g., \"If 'C' is present, then 'D' must also be present\").\n\n### Rules\n1. **Base conclusions solely on the provided tags** and instructions given.\n2. **Double-check your logic** to avoid false positives or negatives. This is critical.\n\n### Output\nReturn a valid JSON object with:\n1. **tagsFound** (true or false):\n   - true if the instruction's condition is met.\n   - false otherwise.\n2. **explanation**: A concise, 2 sentence max reason stating which tags were checked and why the result was determined.\n\nExisting Tags: {existingTags}\nInstruction: {instructions}\n">, any>;

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/prompt.js

@@ -0,0 +1,30 @@
+"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 expert** verifying patient tags against a given instruction.
+Analyze the provided patient tags to determine if the instruction's conditions are satisfied.
+
+### Input
+- **Existing Patient Tags**: May be empty if no tags are assigned.
+- **Instruction**: Describes which tag(s) to check. It can:
+  - Involve a single tag (e.g., "Check if 'Eligible' is present").
+  - Require multiple tags (e.g., "Ensure 'A' is present and 'B' is absent").
+  - Specify conditional logic (e.g., "If 'C' is present, then 'D' must also be present").
+
+### Rules
+1. **Base conclusions solely on the provided tags** and instructions given.
+2. **Double-check your logic** to avoid false positives or negatives. This is critical.
+
+### Output
+Return a valid JSON object with:
+1. **tagsFound** (true or false):
+   - true if the instruction's condition is met.
+   - false otherwise.
+2. **explanation**: A concise, 2 sentence max reason stating which tags were checked and why the result was determined.
+
+Existing Tags: {existingTags}
+Instruction: {instructions}
+`);
+//# sourceMappingURL=prompt.js.map

package/dist/extensions/elation/actions/checkPatientTags/lib/checkTagsWithLLM/prompt.js.map

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

package/dist/extensions/elation/actions/checkPatientTags/lib/evaluateCheckTags.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/extensions/elation/actions/checkPatientTags/lib/evaluateCheckTags.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * LangSmith Evaluation Script for checkPatientTags
+ *
+ * Evaluates the checkPatientTags function by:
+ * - Running test cases from LangSmith dataset
+ * - Comparing generated tag checks against expected results
+ * - Generating evaluation reports
+ *
+ * Requirements:
+ * - Set environment variables in .env:
+ *   - OPENAI_API_KEY
+ *   - LANGSMITH_API_KEY
+ *   - LANGSMITH_TRACING=true
+ *   - LANGSMITH_PROJECT=ai-actions-local
+ *
+ * Usage:
+ *  * yarn ts-node extensions/elation/actions/checkPatientTags/lib/evaluateCheckTags.ts
+ *
+ * Results can be viewed in LangSmith dashboard:
+ * https://smith.langchain.com/o/3fffae83-70ff-4574-81ba-aaaedf0b4dc5/datasets/2b3df5fd-6266-43f2-a701-6e5d9981eacc/compare?selectedSessions=2bcc6e49-4087-4051-99f1-6a5d6fce7ac2
+ *
+ *  * ⚠️ **Note:** This script does NOT run in CI/CD. It is meant for **manual evaluation** before merging PRs (for now)
+ */
+const langsmith_1 = require("langsmith");
+const evaluation_1 = require("langsmith/evaluation");
+const createOpenAIModel_1 = require("../../../../../src/lib/llm/openai/createOpenAIModel");
+const checkTagsWithLLM_1 = require("./checkTagsWithLLM/checkTagsWithLLM");
+const constants_1 = require("../../../../../src/lib/llm/openai/constants");
+const lodash_1 = require("lodash");
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+const langsmith = new langsmith_1.Client({
+    apiKey: process.env.LANGSMITH_API_KEY,
+    apiUrl: process.env.LANGSMITH_ENDPOINT,
+});
+// Define the dataset name
+const datasetName = 'ai-actions-check-patient-tags-elation';
+// Fetch the 'test' split examples from the dataset
+const fetchTestExamples = async () => {
+    try {
+        const testExamples = langsmith.listExamples({
+            datasetName,
+            splits: ['test'],
+        });
+        const examples = [];
+        for await (const example of testExamples) {
+            if (!(0, lodash_1.isNil)(example.inputs) && !(0, lodash_1.isNil)(example.outputs)) {
+                // Explicit null check
+                examples.push(example);
+            }
+        }
+        return examples;
+    }
+    catch (error) {
+        console.error('❌ Error fetching test examples:', error);
+        throw error;
+    }
+};
+// Custom evaluator to compare generated tag check results with expected results
+const tagCheckEvaluator = async ({ outputs, referenceOutputs, }) => {
+    console.log('Evaluator received:', { outputs, referenceOutputs }); // Debug log
+    const generatedResult = outputs === null || outputs === void 0 ? void 0 : outputs.tagsFound;
+    const expectedResult = referenceOutputs === null || referenceOutputs === void 0 ? void 0 : referenceOutputs.expected_output;
+    // console.log('Comparing results:', { generatedResult, expectedResult }); // Debug log
+    return {
+        key: 'tag_check_match',
+        score: generatedResult === expectedResult ? 1 : 0
+    };
+};
+// Wrapper function to adapt checkTagsWithLLM for evaluation
+const checkTagsWithLLMWrapper = async (input) => {
+    const payload = {
+        activity: {
+            id: 'test-activity-id',
+        },
+        pathway: {
+            tenant_id: 'test-tenant',
+            definition_id: 'test-definition',
+            id: 'test-pathway',
+            org_slug: 'test-org',
+            org_id: 'test-org-id',
+        },
+        fields: {
+            instructions: input.instruction,
+            patientId: 'test-patient',
+        },
+        settings: {
+            openAiApiKey: process.env.OPENAI_API_KEY,
+        },
+    };
+    const helpers = {
+        getOpenAIConfig: () => {
+            const apiKey = process.env.OPENAI_API_KEY;
+            if ((0, lodash_1.isNil)(apiKey) || apiKey.trim() === '') {
+                throw new Error('OPENAI_API_KEY is required but not set');
+            }
+            return { apiKey };
+        },
+    };
+    const { model, metadata, callbacks } = await (0, createOpenAIModel_1.createOpenAIModel)({
+        settings: payload.settings,
+        helpers,
+        payload,
+        modelType: constants_1.OPENAI_MODELS.GPT4o,
+    });
+    return await (0, checkTagsWithLLM_1.checkTagsWithLLM)({
+        model,
+        existingTags: input.input_patient_tags,
+        instructions: input.instruction,
+        metadata,
+        callbacks,
+    });
+};
+// Main function to run the evaluation and print results
+const runEvaluation = async () => {
+    var _a, _b;
+    try {
+        console.log('📡 Fetching test dataset from LangSmith...');
+        const testExamples = await fetchTestExamples();
+        console.log(`✅ Loaded ${testExamples.length} test examples\n`);
+        console.log('🚀 Running evaluation...\n');
+        const results = await (0, evaluation_1.evaluate)(checkTagsWithLLMWrapper, {
+            data: testExamples,
+            evaluators: [tagCheckEvaluator],
+            experimentPrefix: 'CheckTagsWithLLM Evaluation',
+            maxConcurrency: 16,
+        });
+        const resultsArray = Array.isArray(results) ? results : [results];
+        const experimentId = (_b = (_a = resultsArray[0]) === null || _a === void 0 ? void 0 : _a.run) === null || _b === void 0 ? void 0 : _b.run_id;
+        if (!(0, lodash_1.isNil)(experimentId) && experimentId.trim() !== '') {
+            console.log('\n✨ Evaluation Complete!');
+            console.log('View detailed results in LangSmith:');
+            console.log(`https://smith.langchain.com/runs/${experimentId}`);
+        }
+    }
+    catch (error) {
+        console.error('❌ Error during evaluation:', error);
+        throw error;
+    }
+};
+// Execute the evaluation
+void runEvaluation();
+//# sourceMappingURL=evaluateCheckTags.js.map

package/dist/extensions/elation/actions/checkPatientTags/lib/evaluateCheckTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateCheckTags.js","sourceRoot":"","sources":["../../../../../../extensions/elation/actions/checkPatientTags/lib/evaluateCheckTags.ts"],"names":[],"mappings":";;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,yCAAgD;AAChD,qDAA+C;AAC/C,2FAAuF;AACvF,0EAAsE;AACtE,2EAA2E;AAC3E,mCAA8B;AAE9B,oDAA2B;AAC3B,gBAAM,CAAC,MAAM,EAAE,CAAA;AAEf,MAAM,SAAS,GAAG,IAAI,kBAAM,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;IACrC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;CACvC,CAAC,CAAA;AAEF,0BAA0B;AAC1B,MAAM,WAAW,GAAG,uCAAuC,CAAA;AAkB3D,mDAAmD;AACnD,MAAM,iBAAiB,GAAG,KAAK,IAAwB,EAAE;IACvD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;YAC1C,WAAW;YACX,MAAM,EAAE,CAAC,MAAM,CAAC;SACjB,CAAC,CAAA;QACF,MAAM,QAAQ,GAAc,EAAE,CAAA;QAC9B,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACzC,IAAI,CAAC,IAAA,cAAK,EAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAA,cAAK,EAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtD,sBAAsB;gBACtB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAA;QACvD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,gFAAgF;AAChF,MAAM,iBAAiB,GAAG,KAAK,EAAE,EAC/B,OAAO,EACP,gBAAgB,GACD,EAA4B,EAAE;IAC7C,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAA,CAAC,YAAY;IAE9E,MAAM,eAAe,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAoB,CAAA;IACrD,MAAM,cAAc,GAAG,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,eAA0B,CAAA;IAEnE,uFAAuF;IAEvF,OAAO;QACL,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,eAAe,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAClD,CAAA;AACH,CAAC,CAAA;AAED,4DAA4D;AAC5D,MAAM,uBAAuB,GAAG,KAAK,EACnC,KAAqB,EACiC,EAAE;IACxD,MAAM,OAAO,GAAG;QACd,QAAQ,EAAE;YACR,EAAE,EAAE,kBAAkB;SACvB;QACD,OAAO,EAAE;YACP,SAAS,EAAE,aAAa;YACxB,aAAa,EAAE,iBAAiB;YAChC,EAAE,EAAE,cAAc;YAClB,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,aAAa;SACtB;QACD,MAAM,EAAE;YACN,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,SAAS,EAAE,cAAc;SAC1B;QACD,QAAQ,EAAE;YACR,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;SACzC;KACF,CAAA;IAED,MAAM,OAAO,GAAG;QACd,eAAe,EAAE,GAAG,EAAE;YACpB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;YACzC,IAAI,IAAA,cAAK,EAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;YAC3D,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,CAAA;QACnB,CAAC;KACF,CAAA;IAED,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,qCAAiB,EAAC;QAC7D,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO;QACP,OAAO;QACP,SAAS,EAAE,yBAAa,CAAC,KAAK;KAC/B,CAAC,CAAA;IAEF,OAAO,MAAM,IAAA,mCAAgB,EAAC;QAC5B,KAAK;QACL,YAAY,EAAE,KAAK,CAAC,kBAAkB;QACtC,YAAY,EAAE,KAAK,CAAC,WAAW;QAC/B,QAAQ;QACR,SAAS;KACV,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,wDAAwD;AACxD,MAAM,aAAa,GAAG,KAAK,IAAmB,EAAE;;IAC9C,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAA;QACzD,MAAM,YAAY,GAAG,MAAM,iBAAiB,EAAE,CAAA;QAC9C,OAAO,CAAC,GAAG,CAAC,YAAY,YAAY,CAAC,MAAM,kBAAkB,CAAC,CAAA;QAE9D,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;QACzC,MAAM,OAAO,GAAG,MAAM,IAAA,qBAAQ,EAAC,uBAAuB,EAAE;YACtD,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,CAAC,iBAAiB,CAAC;YAC/B,gBAAgB,EAAE,6BAA6B;YAC/C,cAAc,EAAE,EAAE;SACnB,CAAC,CAAA;QAEF,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACjE,MAAM,YAAY,GAAG,MAAA,MAAA,YAAY,CAAC,CAAC,CAAC,0CAAE,GAAG,0CAAE,MAAgB,CAAA;QAE3D,IAAI,CAAC,IAAA,cAAK,EAAC,YAAY,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAA;YACvC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAA;YAClD,OAAO,CAAC,GAAG,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAA;QAClD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,yBAAyB;AACzB,KAAK,aAAa,EAAE,CAAA"}

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

@@ -2572,6 +2572,72 @@ export declare const actions: {
             required: false;
         };
     }, "updatedTags" | "explanation">;
+    checkPatientTags: import("@awell-health/extensions-core").Action<{
+        patientId: {
+            id: string;
+            label: string;
+            type: import("@awell-health/extensions-core").FieldType.NUMERIC;
+            required: true;
+            description: string;
+        };
+        instructions: {
+            id: string;
+            label: string;
+            type: import("@awell-health/extensions-core").FieldType.TEXT;
+            required: true;
+            description: string;
+        };
+    }, {
+        base_url: {
+            key: string;
+            label: string;
+            obfuscated: false;
+            description: string;
+            required: true;
+        };
+        auth_url: {
+            key: string;
+            label: string;
+            obfuscated: false;
+            description: string;
+            required: true;
+        };
+        client_id: {
+            key: string;
+            label: string;
+            obfuscated: false;
+            description: string;
+            required: true;
+        };
+        client_secret: {
+            key: string;
+            label: string;
+            obfuscated: true;
+            description: string;
+            required: true;
+        };
+        username: {
+            key: string;
+            label: string;
+            obfuscated: false;
+            description: string;
+            required: false;
+        };
+        password: {
+            key: string;
+            label: string;
+            obfuscated: true;
+            description: string;
+            required: false;
+        };
+        rateLimitDuration: {
+            key: string;
+            label: string;
+            obfuscated: false;
+            description: string;
+            required: false;
+        };
+    }, "explanation" | "tagsFound">;
     getReferralOrder: import("@awell-health/extensions-core").Action<{
         referralOrderId: {
             id: string;

package/dist/extensions/elation/actions/index.js

@@ -27,6 +27,7 @@ const createReferralOrder_1 = require("./createReferralOrder");
 const createCareGap_1 = require("./createCareGap");
 const closeCareGap_1 = require("./closeCareGap");
 const updatePatientTags_1 = require("./updatePatientTags");
+const checkPatientTags_1 = require("./checkPatientTags");
 const getReferralOrder_1 = require("./getReferralOrder");
 const findFutureAppointment_1 = require("./findFutureAppointment");
 const findAppointmentsWithAI_1 = require("./findAppointmentsWithAI");
@@ -60,6 +61,7 @@ exports.actions = {
     createCareGap: createCareGap_1.createCareGap,
     closeCareGap: closeCareGap_1.closeCareGap,
     updatePatientTags: updatePatientTags_1.updatePatientTags,
+    checkPatientTags: checkPatientTags_1.checkPatientTags,
     getReferralOrder: getReferralOrder_1.getReferralOrder,
     findFutureAppointment: findFutureAppointment_1.findFutureAppointment,
     findAppointmentsWithAI: findAppointmentsWithAI_1.findAppointmentsWithAI,

package/dist/extensions/elation/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../extensions/elation/actions/index.ts"],"names":[],"mappings":";;;AAAA,wDAAoD;AACpD,mDAA+C;AAC/C,mDAA+C;AAC/C,2DAAuD;AACvD,qDAAiD;AACjD,+CAA2C;AAC3C,yDAAqD;AACrD,mDAA+C;AAC/C,6DAAyD;AACzD,6DAAyD;AACzD,uDAAmD;AACnD,6DAAyD;AACzD,iDAA6C;AAC7C,6CAAyC;AACzC,qDAAiD;AACjD,+DAA2D;AAC3D,6DAAyD;AACzD,wDAAoD;AACpD,wDAAoD;AACpD,uEAAmE;AACnE,qDAAiD;AACjD,2CAAuC;AACvC,+DAA2D;AAC3D,mDAA+C;AAC/C,iDAA6C;AAC7C,2DAAuD;AACvD,yDAAqD;AACrD,mEAA+D;AAC/D,qEAAiE;AACjE,0EAAsE;AACtE,mFAA+E;AAC/E,gFAA4E;AAC/D,QAAA,OAAO,GAAG;IACrB,UAAU,EAAV,uBAAU;IACV,aAAa,EAAb,6BAAa;IACb,aAAa,EAAb,6BAAa;IACb,iBAAiB,EAAjB,qCAAiB;IACjB,cAAc,EAAd,+BAAc;IACd,gBAAgB,EAAhB,mCAAgB;IAChB,WAAW,EAAX,yBAAW;IACX,YAAY,EAAZ,2BAAY;IACZ,aAAa,EAAb,6BAAa;IACb,kBAAkB,EAAlB,uCAAkB;IAClB,kBAAkB,EAAlB,uCAAkB;IAClB,eAAe,EAAf,iCAAe;IACf,kBAAkB,EAAlB,uCAAkB;IAClB,eAAe,EAAf,iCAAe;IACf,SAAS,EAAT,qBAAS;IACT,UAAU,EAAV,uBAAU;IACV,UAAU,EAAV,uBAAU;IACV,UAAU,EAAV,uBAAU;IACV,cAAc,EAAd,+BAAc;IACd,mBAAmB,EAAnB,yCAAmB;IACnB,kBAAkB,EAAlB,uCAAkB;IAClB,SAAS,EAAT,qBAAS;IACT,mBAAmB,EAAnB,yCAAmB;IACnB,aAAa,EAAb,6BAAa;IACb,YAAY,EAAZ,2BAAY;IACZ,iBAAiB,EAAjB,qCAAiB;IACjB,gBAAgB,EAAhB,mCAAgB;IAChB,qBAAqB,EAArB,6CAAqB;IACrB,sBAAsB,EAAtB,+CAAsB;IACtB,gBAAgB,EAAhB,mCAAgB;IAChB,6BAA6B,EAA7B,6DAA6B;IAC7B,kBAAkB,EAAlB,uCAAkB;CACnB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../extensions/elation/actions/index.ts"],"names":[],"mappings":";;;AAAA,wDAAoD;AACpD,mDAA+C;AAC/C,mDAA+C;AAC/C,2DAAuD;AACvD,qDAAiD;AACjD,+CAA2C;AAC3C,yDAAqD;AACrD,mDAA+C;AAC/C,6DAAyD;AACzD,6DAAyD;AACzD,uDAAmD;AACnD,6DAAyD;AACzD,iDAA6C;AAC7C,6CAAyC;AACzC,qDAAiD;AACjD,+DAA2D;AAC3D,6DAAyD;AACzD,wDAAoD;AACpD,wDAAoD;AACpD,uEAAmE;AACnE,qDAAiD;AACjD,2CAAuC;AACvC,+DAA2D;AAC3D,mDAA+C;AAC/C,iDAA6C;AAC7C,2DAAuD;AACvD,yDAAqD;AACrD,yDAAqD;AACrD,mEAA+D;AAC/D,qEAAiE;AACjE,0EAAsE;AACtE,mFAA+E;AAC/E,gFAA4E;AAE/D,QAAA,OAAO,GAAG;IACrB,UAAU,EAAV,uBAAU;IACV,aAAa,EAAb,6BAAa;IACb,aAAa,EAAb,6BAAa;IACb,iBAAiB,EAAjB,qCAAiB;IACjB,cAAc,EAAd,+BAAc;IACd,gBAAgB,EAAhB,mCAAgB;IAChB,WAAW,EAAX,yBAAW;IACX,YAAY,EAAZ,2BAAY;IACZ,aAAa,EAAb,6BAAa;IACb,kBAAkB,EAAlB,uCAAkB;IAClB,kBAAkB,EAAlB,uCAAkB;IAClB,eAAe,EAAf,iCAAe;IACf,kBAAkB,EAAlB,uCAAkB;IAClB,eAAe,EAAf,iCAAe;IACf,SAAS,EAAT,qBAAS;IACT,UAAU,EAAV,uBAAU;IACV,UAAU,EAAV,uBAAU;IACV,UAAU,EAAV,uBAAU;IACV,cAAc,EAAd,+BAAc;IACd,mBAAmB,EAAnB,yCAAmB;IACnB,kBAAkB,EAAlB,uCAAkB;IAClB,SAAS,EAAT,qBAAS;IACT,mBAAmB,EAAnB,yCAAmB;IACnB,aAAa,EAAb,6BAAa;IACb,YAAY,EAAZ,2BAAY;IACZ,iBAAiB,EAAjB,qCAAiB;IACjB,gBAAgB,EAAhB,mCAAgB;IAChB,gBAAgB,EAAhB,mCAAgB;IAChB,qBAAqB,EAArB,6CAAqB;IACrB,sBAAsB,EAAtB,+CAAsB;IACtB,gBAAgB,EAAhB,mCAAgB;IAChB,6BAA6B,EAA7B,6DAA6B;IAC7B,kBAAkB,EAAlB,uCAAkB;CACnB,CAAA"}

package/dist/extensions/markdown.json

@@ -60,7 +60,7 @@
     "changelog": "# Dropbox Sign changelog"
   },
   "elation": {
-    "readme": "---\ntitle: Elation\ndescription: Elation is a cloud-based health record system designed for healthcare providers, clinics, and medical practices.\n---\n# Elation\n\nElation is a cloud-based health record system designed for healthcare providers, clinics, and medical practices. It offers a range of features including patient scheduling, charting, e-prescribing, billing, and telemedicine. Overall, Elation is designed to streamline the workflow of medical practices, improve patient care, and increase efficiency.\n\n## Setup\n\n### Webhooks\n\nThe integration of webhooks with Elation presents unique challenges and considerations:\n\n- **Non-Discriminative Triggers**: Elation does not differentiate between the creation or update of a resource. Both actions will set off webhook with action `saved`, which might not provide enough discriminative information for some use cases.\n- **Programmatic Setup**: Elation webhooks can only be configured programmatically, as there's no dedicated user interface in Elation to set up webhooks. View [this demo video](https://youtu.be/v8u6E8MEI8E) for a step-by-step guide on how to set up your webhooks in Elation.\n- **Limitation on user-triggered actions**: Elation has a concept called \"Preventing echo\". This means that that any action carried out by the user affiliated with the API credentials that created the subscription doesn't trigger a webhook. You can read more about this behaviour [here](https://docs.elationhealth.com/reference/webhooks). If you are not receiving any webhooks from Elation after setting up your subscription, then this is the reason. A feasible workaround to the above limitation is creating a dedicated user not meant for human interactions but serves the sole purpose of facilitating M2M communication.\n\nIf you need help setting up your webhooks in Elation, reach out! We are happy to help you.\n\n### Extension settings\n\nIn order to use this extension you will need to provide the extension with the following settings:\n\n- Base URL / endpoint URL of the API\n- Authorization URL\n- Client ID for OAuth2 Password authentication\n- Client Secret for OAuth2 Password authentication\n- API Username for OAuth2 Password authentication\n- API Password for OAuth2 Password authentication\n\nNot sure where you can find all of this information? Click [here](https://docs.elationhealth.com/reference/introduction) to have a look at Elation's Developer documentation.\n\n## Actions\n\nThe following actions are supported with Elation today:\n\n### Create Patient\n\nThis action creates a patient in Elation.\n\n**When creating a patient, you will have to specifiy the primary physician and caregiver practice ID:**\n- Primary physician ID: you can retrieve this ID by using the [Find Physicians](https://docs.elationhealth.com/reference/find-physicians) API call, or by using the `Find Physician` action\n- Caregiver Practice ID: similar to the primary physician ID, you can find this ID by using the same API call or action\n\n### Get Patient\n\nUsing a patient identifier, retrieve a patient object from Elation. \n\nNote that when retrieve the mobile phone number, we are tranforming the number to an international format. We apply a heuristic and assume all mobile numbers in Elation are in US national format so we prepend the number with the +1 country code. Having the number in international format unlocks more powerful functionality like sending text messages with 3rd party services like Twilio and MessageBird.\n\n### Update Patient\n\nUpdate a patient in Elation using any fields available in create patient. We use Elation's `PATCH` method to apply partial modifications to a the patient resource (i.e. update only what is needed).\n\n### Create Appointment\n\nEasily create a patient appointment in Elation.\n\nCreating an appointment requires a few strings to be well-formulated:\n- `Scheduled date` must be a datetime string (ISO-8601). For example, January 1, 2023 at noon, Pacific Time (-8 hours) would be shown as such: `2023-01-01T12:00:00.000-08:00`\n- `Reason` must not be free text. This value comes from the following list of appointment types (`Follow-Up`, `Office Visit`, `Physical Exam`, etc.):\n![Appointment types](./assets/elation-appointment-reason.png?raw=true \"Elation Appointment Types\")\n- `Patient` is the patient ID.\n- `Physician` is the physician ID (see `Find Physician`)\n- `Practice` is the practice ID (again, see `Find Physician`)\n\nYou can also include a duration (default to 15 minutes, or whatever has been set in your EHR)\n\n### Get Appointment\n\nRetrieve appointment details using an appointment ID. \n\n### Create Non-Visit Note\n\nThe non-visit note is a special kind of note that, as the name suggests, is not associated with a visit. These notes, in their simplest form, provide a chronological account of information about the patient.\n\n**Additional documentation for some of the action fields:**\n1. Category: The default category is \"Problem\" but you can choose any of \"Past\", \"Family\", \"Social\", \"Instr\", \"PE\", \"ROS\", \"Med\", \"Data\", \"Assessment\", \"Test\", \"Tx\", \"Narrative\", \"Followup\", \"Reason\", \"Plan\", \"Objective\", \"Hpi\", \"Allergies\", \"Habits\", \"Assessplan\", \"Consultant\", \"Attending\", \"Dateprocedure\", \"Surgical\", \"Orders\", \"Referenced\", \"Procedure\".\n2. Chart and document date automatically get set to the current date, i.e. the date when the action is orchestrated.\n\n### Delete Non-Visit Note\n\nDeletes the non-visit note identified by an ID.\n\n### Get Non-Visit Note\n\nRetrieve the details of a non-visit note identified by an ID.\n### Get physician\n\nUsing a physician identifier, retrieve a physician object from Elation.\n\n### Find physicians\n\nSearch a physician based on a set of parameters. The ID of the physician matching the search parameters will be returned. To retrieve the details of the physician, you can use the the \"Get physician\" action.\n\nNote that this action can only support finding one physician so if your search criteria match multiple physicians the action will throw an error.\n\n### ✨ Find Future Appointment\n\nTries to find a **single future appointment** for a patient based on a prompt in natural language. These are the steps executed by the action:\n\n1. All future appointments with status `Scheduled` or `Confirmed` for the patient are retrieved from Elation.\n2. Based on the provided prompt, an LLM tries to find a single appointment from the list of future appointments that matches the prompt.\n3. If multiple appointments exist that match the instructions, only the first one is returned.\n\nIf a matching appointment is found, the action returns the full appointment resource and an explanation of why the LLM chose this appointment.\n\n### ✨ Find Appointments\n\nTries to find **all appointments** for a patient based on a prompt in natural language. These are the steps executed by the action:\n\n1. All appointments, independent their date or status, for the patient are retrieved from Elation.\n2. Based on the provided prompt, an LLM tries to find all appointments from the list appointments that matches the prompt.\n\nThe action returns the full appointment resources of all appointments matching the prompt and an explanation of why the LLM chose these appointments. Additionally, the action returns a count of appointments by status.\n\nExample data points output below.\n\nAppointments (note: only displaying a partial appointment resource)```json\n[\n  {\n    \"id\": 456,\n    \"scheduled_date\": \"2023-07-12T20:44:22Z\",\n    \"status\": {\n      \"status\": \"Scheduled\",\n    },\n  },\n  {\n    \"id\": 456,\n    \"scheduled_date\": \"2023-08-12T20:44:22Z\",\n    \"status\": {\n      \"status\": \"Confirmed\",\n    },\n  }\n]```\n\nAppointment counts by status\n```json\n{\n  \"Scheduled\": 1,\n  \"Confirmed\": 1,\n}\n```\n\n### ✨ Update Patient Tags\n\nUses AI to manage patient tags in Elation based on natural language instructions. The action executes the following steps:\n\n1. Retrieves existing patient tags from Elation\n2. Uses an LLM to interpret natural language instructions and determine required tag changes\n3. Updates patient tags in Elation according to the interpreted changes\n\nThe action returns:\n- Complete list of updated tags after changes\n- Detailed explanation of what changes were made and why\n\n**Important Notes:**\n- When adding new tags, specify them in single quotes (e.g., 'Diabetes', 'High-Risk'). Tags must exist in your Elation database\n- Due to Elation API limitations, clearing all tags is implemented by setting a single space tag (' '). This is the recommended workaround from Elation's team\n\n### ✨ Cancel appointments\n\nGiven a prompt, this action retrieves a patient's upcoming appointments matching the prompt and cancels them.\n",
+    "readme": "---\ntitle: Elation\ndescription: Elation is a cloud-based health record system designed for healthcare providers, clinics, and medical practices.\n---\n# Elation\n\nElation is a cloud-based health record system designed for healthcare providers, clinics, and medical practices. It offers a range of features including patient scheduling, charting, e-prescribing, billing, and telemedicine. Overall, Elation is designed to streamline the workflow of medical practices, improve patient care, and increase efficiency.\n\n## Setup\n\n### Webhooks\n\nThe integration of webhooks with Elation presents unique challenges and considerations:\n\n- **Non-Discriminative Triggers**: Elation does not differentiate between the creation or update of a resource. Both actions will set off webhook with action `saved`, which might not provide enough discriminative information for some use cases.\n- **Programmatic Setup**: Elation webhooks can only be configured programmatically, as there's no dedicated user interface in Elation to set up webhooks. View [this demo video](https://youtu.be/v8u6E8MEI8E) for a step-by-step guide on how to set up your webhooks in Elation.\n- **Limitation on user-triggered actions**: Elation has a concept called \"Preventing echo\". This means that that any action carried out by the user affiliated with the API credentials that created the subscription doesn't trigger a webhook. You can read more about this behaviour [here](https://docs.elationhealth.com/reference/webhooks). If you are not receiving any webhooks from Elation after setting up your subscription, then this is the reason. A feasible workaround to the above limitation is creating a dedicated user not meant for human interactions but serves the sole purpose of facilitating M2M communication.\n\nIf you need help setting up your webhooks in Elation, reach out! We are happy to help you.\n\n### Extension settings\n\nIn order to use this extension you will need to provide the extension with the following settings:\n\n- Base URL / endpoint URL of the API\n- Authorization URL\n- Client ID for OAuth2 Password authentication\n- Client Secret for OAuth2 Password authentication\n- API Username for OAuth2 Password authentication\n- API Password for OAuth2 Password authentication\n\nNot sure where you can find all of this information? Click [here](https://docs.elationhealth.com/reference/introduction) to have a look at Elation's Developer documentation.\n\n## Actions\n\nThe following actions are supported with Elation today:\n\n### Create Patient\n\nThis action creates a patient in Elation.\n\n**When creating a patient, you will have to specifiy the primary physician and caregiver practice ID:**\n- Primary physician ID: you can retrieve this ID by using the [Find Physicians](https://docs.elationhealth.com/reference/find-physicians) API call, or by using the `Find Physician` action\n- Caregiver Practice ID: similar to the primary physician ID, you can find this ID by using the same API call or action\n\n### Get Patient\n\nUsing a patient identifier, retrieve a patient object from Elation. \n\nNote that when retrieve the mobile phone number, we are tranforming the number to an international format. We apply a heuristic and assume all mobile numbers in Elation are in US national format so we prepend the number with the +1 country code. Having the number in international format unlocks more powerful functionality like sending text messages with 3rd party services like Twilio and MessageBird.\n\n### Update Patient\n\nUpdate a patient in Elation using any fields available in create patient. We use Elation's `PATCH` method to apply partial modifications to a the patient resource (i.e. update only what is needed).\n\n### Create Appointment\n\nEasily create a patient appointment in Elation.\n\nCreating an appointment requires a few strings to be well-formulated:\n- `Scheduled date` must be a datetime string (ISO-8601). For example, January 1, 2023 at noon, Pacific Time (-8 hours) would be shown as such: `2023-01-01T12:00:00.000-08:00`\n- `Reason` must not be free text. This value comes from the following list of appointment types (`Follow-Up`, `Office Visit`, `Physical Exam`, etc.):\n![Appointment types](./assets/elation-appointment-reason.png?raw=true \"Elation Appointment Types\")\n- `Patient` is the patient ID.\n- `Physician` is the physician ID (see `Find Physician`)\n- `Practice` is the practice ID (again, see `Find Physician`)\n\nYou can also include a duration (default to 15 minutes, or whatever has been set in your EHR)\n\n### Get Appointment\n\nRetrieve appointment details using an appointment ID. \n\n### Create Non-Visit Note\n\nThe non-visit note is a special kind of note that, as the name suggests, is not associated with a visit. These notes, in their simplest form, provide a chronological account of information about the patient.\n\n**Additional documentation for some of the action fields:**\n1. Category: The default category is \"Problem\" but you can choose any of \"Past\", \"Family\", \"Social\", \"Instr\", \"PE\", \"ROS\", \"Med\", \"Data\", \"Assessment\", \"Test\", \"Tx\", \"Narrative\", \"Followup\", \"Reason\", \"Plan\", \"Objective\", \"Hpi\", \"Allergies\", \"Habits\", \"Assessplan\", \"Consultant\", \"Attending\", \"Dateprocedure\", \"Surgical\", \"Orders\", \"Referenced\", \"Procedure\".\n2. Chart and document date automatically get set to the current date, i.e. the date when the action is orchestrated.\n\n### Delete Non-Visit Note\n\nDeletes the non-visit note identified by an ID.\n\n### Get Non-Visit Note\n\nRetrieve the details of a non-visit note identified by an ID.\n### Get physician\n\nUsing a physician identifier, retrieve a physician object from Elation.\n\n### Find physicians\n\nSearch a physician based on a set of parameters. The ID of the physician matching the search parameters will be returned. To retrieve the details of the physician, you can use the the \"Get physician\" action.\n\nNote that this action can only support finding one physician so if your search criteria match multiple physicians the action will throw an error.\n\n### ✨ Find Future Appointment\n\nTries to find a **single future appointment** for a patient based on a prompt in natural language. These are the steps executed by the action:\n\n1. All future appointments with status `Scheduled` or `Confirmed` for the patient are retrieved from Elation.\n2. Based on the provided prompt, an LLM tries to find a single appointment from the list of future appointments that matches the prompt.\n3. If multiple appointments exist that match the instructions, only the first one is returned.\n\nIf a matching appointment is found, the action returns the full appointment resource and an explanation of why the LLM chose this appointment.\n\n### ✨ Find Appointments\n\nTries to find **all appointments** for a patient based on a prompt in natural language. These are the steps executed by the action:\n\n1. All appointments, independent their date or status, for the patient are retrieved from Elation.\n2. Based on the provided prompt, an LLM tries to find all appointments from the list appointments that matches the prompt.\n\nThe action returns the full appointment resources of all appointments matching the prompt and an explanation of why the LLM chose these appointments. Additionally, the action returns a count of appointments by status.\n\nExample data points output below.\n\nAppointments (note: only displaying a partial appointment resource)```json\n[\n  {\n    \"id\": 456,\n    \"scheduled_date\": \"2023-07-12T20:44:22Z\",\n    \"status\": {\n      \"status\": \"Scheduled\",\n    },\n  },\n  {\n    \"id\": 456,\n    \"scheduled_date\": \"2023-08-12T20:44:22Z\",\n    \"status\": {\n      \"status\": \"Confirmed\",\n    },\n  }\n]```\n\nAppointment counts by status\n```json\n{\n  \"Scheduled\": 1,\n  \"Confirmed\": 1,\n}\n```\n\n### ✨ Update Patient Tags\n\nUses AI to manage patient tags in Elation based on natural language instructions. The action executes the following steps:\n\n1. Retrieves existing patient tags from Elation\n2. Uses an LLM to interpret natural language instructions and determine required tag changes\n3. Updates patient tags in Elation according to the interpreted changes\n\nThe action returns:\n- Complete list of updated tags after changes\n- Detailed explanation of what changes were made and why\n\n**Important Notes:**\n- When adding new tags, specify them in single quotes (e.g., 'Diabetes', 'High-Risk'). Tags must exist in your Elation database\n- Due to Elation API limitations, clearing all tags is implemented by setting a single space tag (' '). This is the recommended workaround from Elation's team\n\n### ✨ Check Patient Tags\n\nUses AI to check if a patient's tags match given instructions in natural language. The action executes the following steps:\n\n1. Retrieves existing patient tags from Elation\n2. Uses an LLM to interpret natural language instructions and check if the patient's tags match the requirements\n3. Returns a boolean result and explanation of the check\n\nThe action returns:\n- `tagsFound`: Boolean indicating if the patient's tags match the instructions\n- `explanation`: Detailed explanation of why the tags match or don't match the instructions\n\n\n**Important Notes:**\n- When specifying exact tag matches, use double quotes (e.g., \"Diabetes\", \"High-Risk\"). Tags must exist in your Elation database\n- The LLM can understand complex logical conditions like \"either/or\", \"both\", \"not\", \"any of\", \"none of\"\n\n### ✨ Cancel appointments\n\nGiven a prompt, this action retrieves a patient's upcoming appointments matching the prompt and cancels them.\n",
     "changelog": "# Elation Changelog\n\n## January 30, 2024\n\n- New actions\n  - Post letter: Using patient and practice identifier, post a new letter to either Provider, Patient or associate it with an existing Referral.\n\n## October 3, 2023\n\n- The README is now more concise with less unneeded detail. A section on the particularities of Elation subscriptions (webhooks) was added.\n- Misc. updates to labels, descriptions, action fields order\n- Action updates\n  - Create Non-Visit Note:\n    - Simplify the action by removing some optional action fields (we can always expand later)\n    - `document_date` and `chart_date` are now automatically set to the date of today so that the corresponding action fields could be removed\n  - Create patient\n    - `dob` is now a `date` field type (was a string)\n    - You can pass a mobile phone number and email when creating a patient\n  - Find physician\n    - Only returns the physician ID instead of all the details of the physician. To retrieve the details one can use the new `Get physician` action\n  - Update patient\n    - `dob` is now a `date` field type (was a string)\n    - We are now using `PATCH` instead of `PUT` which allows for a partial update, i.e. only update the fields that are needed.\n- New actions\n  - Get physician: Using a physician identifier, retrieve a physician object from Elation.\n- Removed actions\n  - Update Non-Visit Note\n- Webhooks\n  - Fix the type of `patientId` in `patientCreatedOrUpdated` webhook\n  - Added `appointmentCreatedOrUpdated` webhook\n\n## September 4, 2023\n\n- rename `onCreatePatient` webhook to `patientCreatedOrUpdated`\n- filter non `saved` actions for this webhook\n\n## August 21, 2023\n\n- make non-visit note text a large input (`StringType.TEXT`)\n\n## May 23, 2024\n\n- add patient_status.status to patient object in getPatient action\n- add status to updatePatient action\n"
   },
   "epic": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awell-health/awell-extensions",
-  "version": "2.0.197",
+  "version": "2.0.198",
   "packageManager": "yarn@4.5.3",
   "main": "dist/src/index.js",
   "repository": {