@xapp/stentor-service-generative-ai 1.83.0 → 1.89.0

package/lib/prompts/ChatSummary.d.ts

@@ -1,62 +0,0 @@
-/*! Copyright (c) 2024, XAPP AI */
-import type { ExternalLead } from "stentor-models";
-import type { CompletionPrompt, PromptGenerator, ResponseParser } from "../models";
-import type { ChatSummary } from "../models/ChatSummary";
-/**
- * A conversation line that was said by the user or system.
- */
-export interface SummaryLine {
-    /**
-     * The user that said the line.
-     */
-    user: string;
-    /**
-     * The content that was said by the user.
-     */
-    line: string;
-}
-/**
- * The properties that are required to generate a chat summary prompt.
- */
-export interface ChatSummaryPromptProps {
-    /**
-     * The lines that were said in the conversation.
-     */
-    summary: SummaryLine[];
-}
-export interface ChatSummaryFromLeadTranscriptProps {
-    /**
-     * The transcript of a found lead.
-     */
-    transcript: ExternalLead["transcript"];
-}
-export type ChatSummaryLLMOverrides = Partial<Pick<CompletionPrompt, "model" | "max_tokens" | "temperature" | "top_p" | "frequency_penalty" | "presence_penalty">>;
-/**
- * Generate a prompt that can be used in an LLM to return a summary of a chat conversation from a lead transcript.
- *
- * The expected output format from the LLM will be:
- *
- * <Full summary of the text>
- *
- * @param transcript - The summary transcript of the chat.
- * @param overrides
- * @returns
- */
-export declare const generateChatSummaryPromptFromLeadTranscript: PromptGenerator<ChatSummaryFromLeadTranscriptProps, ChatSummaryLLMOverrides, CompletionPrompt>;
-/**
- * Generates a prompt that can be used in an LLM to return a summary of a chat conversation.
- *
- * The expected output format from the LLM will be:
- *
- * <Full summary of the text>
- *
- * @param summary - The summary transcript of the chat.
- * @returns
- */
-export declare const generateChatSummaryPrompt: PromptGenerator<ChatSummaryPromptProps, ChatSummaryLLMOverrides, CompletionPrompt>;
-/**
- * Parser for the Chat Summary response.
- * @param response
- * @returns
- */
-export declare const chatSummaryResponseParse: ResponseParser<ChatSummary>;

package/lib/prompts/ChatSummary.js

@@ -1,67 +0,0 @@
-"use strict";
-/*! Copyright (c) 2024, XAPP AI */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.chatSummaryResponseParse = exports.generateChatSummaryPrompt = exports.generateChatSummaryPromptFromLeadTranscript = void 0;
-/**
- * Generate a prompt that can be used in an LLM to return a summary of a chat conversation from a lead transcript.
- *
- * The expected output format from the LLM will be:
- *
- * <Full summary of the text>
- *
- * @param transcript - The summary transcript of the chat.
- * @param overrides
- * @returns
- */
-const generateChatSummaryPromptFromLeadTranscript = ({ transcript }, overrides) => {
-    const summary = transcript.map(({ from, message }) => ({
-        user: (from === null || from === void 0 ? void 0 : from.name) || (from === null || from === void 0 ? void 0 : from.email) || (from === null || from === void 0 ? void 0 : from.phone) || (from === null || from === void 0 ? void 0 : from.id) || "Unknown",
-        line: message
-    }));
-    return (0, exports.generateChatSummaryPrompt)({ summary }, overrides);
-};
-exports.generateChatSummaryPromptFromLeadTranscript = generateChatSummaryPromptFromLeadTranscript;
-/**
- * Generates a prompt that can be used in an LLM to return a summary of a chat conversation.
- *
- * The expected output format from the LLM will be:
- *
- * <Full summary of the text>
- *
- * @param summary - The summary transcript of the chat.
- * @returns
- */
-const generateChatSummaryPrompt = ({ summary }, overrides) => {
-    return Object.assign(Object.assign({ model: "gpt-4o-mini", max_tokens: 256, frequency_penalty: 0, temperature: 1, top_p: 1, presence_penalty: 0 }, overrides), { response_format: {
-            type: "text"
-        }, type: "completions", messages: [{
-                role: "system",
-                content: "Summarize the transcript of a chat between a business's bot on a website and a person." +
-                    "Please summarize as if you are the bot in the transcript and you are taking notes for somebody that will be able to help the person with their query.  You may use first person." +
-                    "Do not call the user, \"user\" but instead use \"Someone\", \"Somebody\" or if they give their name you can use their first name however not last name." +
-                    "If the transcript contains additional identifying information from the user, such as last name, phone number, email address, or addresses then do not include theses in the summary.  If the bot provided contact information for the business, you may include it in your summary." +
-                    "The summary will be then be provided to the business owner so they are aware somebody will be in touch soon with the request they mentioned in the transcript." +
-                    "Keep the summary to one sentence around 100 words." +
-                    "An example of a good summary is:" +
-                    "\"Somebody reached out looking for a quote and I provided them with your contact information.\"" +
-                    "or" +
-                    "\"John reached out looking to schedule an appointment and I provided them with the scheduling link.\""
-            }, {
-                role: "user",
-                content: summary.map((s) => `${s.user}: ${s.line}`).join("\n")
-            }] });
-};
-exports.generateChatSummaryPrompt = generateChatSummaryPrompt;
-/**
- * Parser for the Chat Summary response.
- * @param response
- * @returns
- */
-const chatSummaryResponseParse = (response) => {
-    const summary = response.trim();
-    return {
-        summary
-    };
-};
-exports.chatSummaryResponseParse = chatSummaryResponseParse;
-//# sourceMappingURL=ChatSummary.js.map

package/lib/prompts/ChatSummary.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChatSummary.js","sourceRoot":"","sources":["../../src/prompts/ChatSummary.ts"],"names":[],"mappings":";AAAA,kCAAkC;;;AAwClC;;;;;;;;;;GAUG;AACI,MAAM,2CAA2C,GAAmG,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAoB,EAAE;IACvM,MAAM,OAAO,GAAkB,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,EAAE,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAAA,KAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAAA,KAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,EAAE,CAAA,IAAI,SAAS;QACvE,IAAI,EAAE,OAAO;KAChB,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAA,iCAAyB,EAAC,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC,CAAA;AAPY,QAAA,2CAA2C,+CAOvD;AAED;;;;;;;;;GASG;AACI,MAAM,yBAAyB,GAAuF,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAoB,EAAE;IACtK,qCACI,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,GAAG,EACf,iBAAiB,EAAE,CAAC,EACpB,WAAW,EAAE,CAAC,EACd,KAAK,EAAE,CAAC,EACR,gBAAgB,EAAE,CAAC,IAChB,SAAS,KACZ,eAAe,EAAE;YACb,IAAI,EAAE,MAAM;SACf,EACD,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,wFAAwF;oBAC7F,kLAAkL;oBAClL,yJAAyJ;oBACzJ,qRAAqR;oBACrR,gKAAgK;oBAChK,oDAAoD;oBACpD,kCAAkC;oBAClC,iGAAiG;oBACjG,IAAI;oBACJ,uGAAuG;aAC9G,EAAE;gBACC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aACjE,CAAC,IACL;AACL,CAAC,CAAA;AA9BY,QAAA,yBAAyB,6BA8BrC;AAED;;;;GAIG;AACI,MAAM,wBAAwB,GAAgC,CAAC,QAAQ,EAAE,EAAE;IAC9E,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO;QACH,OAAO;KACV,CAAC;AACN,CAAC,CAAA;AALY,QAAA,wBAAwB,4BAKpC"}

package/lib/prompts/index.d.ts

@@ -1,4 +0,0 @@
-/*! Copyright (c) 2024, XAPP AI */
-export * from "./AnalyzeEmail";
-export * from "./AnalyzeLead";
-export * from "./ChatSummary";

package/lib/prompts/index.js

@@ -1,21 +0,0 @@
-"use strict";
-/*! Copyright (c) 2024, XAPP AI */
-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 __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("./AnalyzeEmail"), exports);
-__exportStar(require("./AnalyzeLead"), exports);
-__exportStar(require("./ChatSummary"), exports);
-//# sourceMappingURL=index.js.map

package/lib/prompts/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";AAAA,kCAAkC;;;;;;;;;;;;;;;;AAElC,iDAA+B;AAC/B,gDAA8B;AAC9B,gDAA8B"}

package/lib/utils/extractJSON.d.ts

@@ -1,10 +0,0 @@
-/*! Copyright (c) 2026, XAPP AI */
-/**
- * Extracts a JSON string from an LLM response that may be wrapped in markdown
- * code fences (e.g., ```json ... ```). Falls back to the raw response if no
- * fences are found.
- *
- * This is necessary because Claude (Bedrock/Anthropic API) does not support
- * `response_format: json_schema` and may wrap JSON output in markdown fences.
- */
-export declare function extractJSON(response: string): string;

package/lib/utils/extractJSON.js

@@ -1,17 +0,0 @@
-"use strict";
-/*! Copyright (c) 2026, XAPP AI */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractJSON = extractJSON;
-/**
- * Extracts a JSON string from an LLM response that may be wrapped in markdown
- * code fences (e.g., ```json ... ```). Falls back to the raw response if no
- * fences are found.
- *
- * This is necessary because Claude (Bedrock/Anthropic API) does not support
- * `response_format: json_schema` and may wrap JSON output in markdown fences.
- */
-function extractJSON(response) {
-    const match = response.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
-    return match ? match[1].trim() : response;
-}
-//# sourceMappingURL=extractJSON.js.map

package/lib/utils/extractJSON.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"extractJSON.js","sourceRoot":"","sources":["../../src/utils/extractJSON.ts"],"names":[],"mappings":";AAAA,kCAAkC;;AAUlC,kCAGC;AAXD;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,QAAgB;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9C,CAAC"}

package/lib/utils/standardizeTerms.d.ts

@@ -1,15 +0,0 @@
-/*! Copyright (c) 2024, XAPP AI */
-/**
- * Standardizes common terms and acronyms in text while preserving the overall phrasing.
- * Automatically converts input to lowercase before processing and returns lowercased standardized terms.
- *
- * @param input - The text or array of texts to standardize (will be converted to lowercase)
- * @returns The lowercased text(s) with standardized terms
- *
- * @example
- * standardizeTerms("A/C Repair Needed") // "hvac repair needed"
- * standardizeTerms(["HVAC Maintenance", "ELEC Work"]) // ["hvac maintenance", "electrical work"]
- * standardizeTerms("Elec work w/ permits") // "electrical work with permits"
- */
-export declare function standardizeTerms(input: string): string;
-export declare function standardizeTerms(input: string[]): string[];

package/lib/utils/standardizeTerms.js

@@ -1,53 +0,0 @@
-"use strict";
-/*! Copyright (c) 2024, XAPP AI */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.standardizeTerms = standardizeTerms;
-const TERM_STANDARDIZATIONS = {
-    // HVAC/Air Conditioning
-    "a/c": "hvac",
-    "air conditioning": "hvac",
-    "air conditioner": "hvac",
-    "hvac": "hvac",
-    "heating": "hvac",
-    "cooling": "hvac",
-    // Plumbing
-    "h2o": "water",
-    "hot water heater": "water heater",
-    "hwh": "water heater",
-    // Electrical
-    "elec": "electrical",
-    "electric": "electrical",
-    // General
-    "w/": "with",
-    "w/o": "without",
-    "&": "and"
-};
-function standardizeTerms(input) {
-    if (Array.isArray(input)) {
-        return input.map(text => standardizeTerms(text));
-    }
-    if (!input)
-        return input;
-    // Convert to lowercase first
-    let standardized = input.toLowerCase();
-    // Apply each standardization using word boundaries to avoid partial matches
-    for (const [variant, standard] of Object.entries(TERM_STANDARDIZATIONS)) {
-        // Escape special regex characters, including forward slash
-        const escapedVariant = variant.replace(/[.*+?^${}()|[\]\\\/]/g, '\\$&');
-        // For variants that contain non-word characters (like & or /), we need different boundary matching
-        const hasNonWordChars = /[^\w\s]/.test(variant);
-        let regex;
-        if (hasNonWordChars) {
-            // Use space boundaries or start/end of string for non-word character variants
-            regex = new RegExp(`(^|\\s)${escapedVariant}(\\s|$)`, 'g');
-            standardized = standardized.replace(regex, `$1${standard}$2`);
-        }
-        else {
-            // Use word boundaries for normal word variants
-            regex = new RegExp(`\\b${escapedVariant}\\b`, 'g');
-            standardized = standardized.replace(regex, standard);
-        }
-    }
-    return standardized;
-}
-//# sourceMappingURL=standardizeTerms.js.map

package/lib/utils/standardizeTerms.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"standardizeTerms.js","sourceRoot":"","sources":["../../src/utils/standardizeTerms.ts"],"names":[],"mappings":";AAAA,kCAAkC;;AAwClC,4CA+BC;AArED,MAAM,qBAAqB,GAA2B;IAClD,wBAAwB;IACxB,KAAK,EAAE,MAAM;IACb,kBAAkB,EAAE,MAAM;IAC1B,iBAAiB,EAAE,MAAM;IACzB,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;IAEjB,WAAW;IACX,KAAK,EAAE,OAAO;IACd,kBAAkB,EAAE,cAAc;IAClC,KAAK,EAAE,cAAc;IAErB,aAAa;IACb,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,YAAY;IAExB,UAAU;IACV,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,KAAK;CACb,CAAC;AAgBF,SAAgB,gBAAgB,CAAC,KAAwB;IACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,6BAA6B;IAC7B,IAAI,YAAY,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,4EAA4E;IAC5E,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACtE,2DAA2D;QAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;QAExE,mGAAmG;QACnG,MAAM,eAAe,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,KAAa,CAAC;QAClB,IAAI,eAAe,EAAE,CAAC;YAClB,8EAA8E;YAC9E,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,cAAc,SAAS,EAAE,GAAG,CAAC,CAAC;YAC3D,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,+CAA+C;YAC/C,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,cAAc,KAAK,EAAE,GAAG,CAAC,CAAC;YACnD,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED,OAAO,YAAY,CAAC;AACxB,CAAC"}