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

package/lib/prompts/AnalyzeLead.js

@@ -1,396 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeLeadResponseParse = exports.generateAnalyzeLead = void 0;
-exports.translateTranscript = translateTranscript;
-exports.transcriptToMessages = transcriptToMessages;
-exports.parseFields = parseFields;
-exports.getHighValueLeadDescription = getHighValueLeadDescription;
-const stentor_utils_1 = require("stentor-utils");
-const extractJSON_1 = require("../utils/extractJSON");
-function getName(profile) {
-    // Sorting these based on priority.
-    return (profile === null || profile === void 0 ? void 0 : profile.name) || (profile === null || profile === void 0 ? void 0 : profile.email) || (profile === null || profile === void 0 ? void 0 : profile.phone) || "Unknown";
-}
-/**
- * Converts a transcript from an external lead in to a series of strings.
- *
- * @param transcript
- * @returns
- */
-function translateTranscript(transcript) {
-    if (!transcript || transcript.length === 0) {
-        return ["No transcript available."];
-    }
-    return transcript.map(({ from, message }) => `${getName(from)}: ${message}`);
-}
-/**
- * Turns a transcript into a series of messages for OpenAI
- *
- * @param system
- * @param transcript
- * @returns
- */
-function transcriptToMessages(system, transcript) {
-    const messages = [
-        {
-            role: "system",
-            content: system
-        }
-    ];
-    // add the messages from the transcript
-    if ((0, stentor_utils_1.existsAndNotEmpty)(transcript)) {
-        // it will either be the appId, typically for single tenant runtimes,
-        // or "bot" for multi-tenant since we don't set this environment variable in multi-tenant
-        const botId = process.env["STUDIO_APP_ID"] || "bot";
-        // the transcript is in reverse order, so we need to reverse it
-        //const reversed = transcript.slice().reverse();
-        for (const message of transcript) {
-            const role = message.from.id === botId || message.from.id === "bot" ? "assistant" : "user";
-            messages.push({
-                role,
-                content: message.message
-            });
-        }
-    }
-    return messages;
-}
-/**
- * Parses the fields from an external lead and returns a string representation of them.
- *
- * @param fields
- * @returns
- */
-function parseFields(fields) {
-    if (!fields || fields.length === 0) {
-        return "";
-    }
-    const fieldStrings = fields.map((field) => {
-        if (field.value && field.value.length > 0) {
-            return `${field.name}: ${field.value}`;
-        }
-        return `${field.name}: No value provided`;
-    });
-    return fieldStrings.join("\n");
-}
-/**
- * Generates a default High Value Lead Description if the business does not provide one.
- *
- * @param app
- * @returns
- */
-function getHighValueLeadDescription(highValueLeadDescription) {
-    return highValueLeadDescription || "No description was provided, do not return highValueLead.";
-}
-/**
- * Generates a prompt that can be used in an LLM to analyze a lead for a business.
- *
- * The expected output format from the LLM will be:
- *
- * <Contact Type>::<Urgency Type>::<High Value Lead (true/false)>::<Summary>
- *
- * @param lead - The lead to analyze with the business description and other options to customize the prompt.
- * @returns
- */
-const generateAnalyzeLead = ({ channel, businessDescription, highValueLeadDescription, transcript, fields }, overrides) => {
-    // determine max_tokens
-    // depending on if the lead is from chat or form, we provide different content.
-    // if form, we just put the gathered fields in the system message
-    // if chat, we add the chat transcript to the messages, bot is the system message and user is the chat transcript.
-    const isChat = channel === "widget" || (0, stentor_utils_1.existsAndNotEmpty)(transcript);
-    const hasBusinessDescription = !!businessDescription;
-    const hasHighValueLeadDescription = !!highValueLeadDescription;
-    let intro = `You are a knowledgeable employee of a business.`;
-    if (hasBusinessDescription) {
-        intro = `
-You are a knowledgeable employee of a business with the following description:
-
-===
-${businessDescription}
-===`;
-    }
-    const instructions = isChat
-        ? `Your job is to analyze the following chat transcript that occurred between a customer or potential customer and an AI agent representing the business.`
-        : `Your job is to analyze the information provided by the customer or potential customer in a form submission.`;
-    let highValueLeadInstruction = "A high value lead description was not provided, do not return highValueLead.";
-    if (hasHighValueLeadDescription) {
-        highValueLeadInstruction = `A high value lead is defined as:
-===
-${getHighValueLeadDescription(highValueLeadDescription)}
-===`;
-    }
-    let system = `
-${intro}
-
-${instructions}
-
-You will return you analysis as a JSON object with the following properties:
-
-- contactType
-- serviceType
-- jobType
-- urgency
-- analysis
-- summary
-- conciseSummary
-
-Provide your analysis of why you made these decisions which will be placed in the value "analysis".  Include why you made decisions for contactType, serviceType, jobType and urgency. The analysis should be concise and provide enough detail to understand your reasoning.  The analysis should not exceed 500 characters.
-
-"contactType" definitions are as follows:
-BILLING_ISSUE: Concerns about charges, refunds, pricing discrepancies, or payments (e.g., “I was billed incorrectly”, “I want a refund”).
-CANCELLATION: Asking to cancel an appointment, service, subscription, or contract.
-COMPLAINT: Dissatisfaction with the business, product, or service quality, excluding billing or scheduling issues.
-COMPLIMENT: Positive feedback about the business, staff, or product.
-CONTACT_REQUEST: A request for someone to contact the customer, without describing any service need, issue, quote request, scheduling intent, problem, or other specific purpose. Use only when the customer gives no actionable details (e.g., “please call me”). Do NOT use if the message includes a request for service, repair, installation, inspection, maintenance, scheduling, rescheduling, a quote, or reporting an issue.
-EMPLOYMENT_INQUIRY: Questions about jobs, openings, hiring, or how to apply.
-MISSED_APPOINTMENT: Reporting a no-show, missed call/visit, or confusion about appointment status or confirmation.
-QUESTION: A general question about the business, services, products, availability, or policies, without requesting service or a quote. Requires a human reply.
-QUOTE_REQUEST: Requesting a price, cost, estimate, quote, or ballpark figure for a product or service.
-RESCHEDULE_REQUEST: Asking to change, move, or adjust the date or time of an existing appointment or scheduled service.
-SERVICE_REQUEST: Requesting service, repair, installation, maintenance, inspection, booking/scheduling, or any assistance with a problem or issue. Includes any request for someone to come out, fix something, inspect something, or schedule a visit.
-SPAM: Unsolicited, irrelevant, deceptive, generic, or low-value content. Includes people offering cost estimation or takeoff services, marketing/multimedia/SEO vendors, people offering to buy the business, debt relief companies, generic copy-pasted messages, gibberish, or fake/incomplete contact info.
-TEST: A test message, placeholder text, or internal system check (e.g., “test”, “asdf”).
-OTHER: Content cannot be reasonably determined from the transcript.
-
-When multiple could apply, prefer BILLING_ISSUE, RESCHEDULE_REQUEST, CANCELLATION, or MISSED_APPOINTMENT over COMPLAINT or CONTACT_REQUEST.
-
-
-The definitions of each "serviceType" value are as follows:
-CLEANING: Cleaning work (e.g., house, windows, ducts, carpet, gutters). Note: overlaps with jobType=cleaning but here describes the type of work performed.
-CONSULTATION: Requesting advice or guidance only, not execution (e.g., legal, design, remodel planning).
-INSPECTION: Evaluation or check to assess a condition or issue (e.g., termite, mold, roof, crawlspace, safety, pre-sale).
-INSTALLATION: New install of a product or system.
-MAINTENANCE: Routine or recurring upkeep (e.g., HVAC tune-up, landscaping, gutter service).
-REFINISH: Refinishing surfaces (e.g., floors, cabinets). Can include painting, staining, or other surface treatments. Use with jobType=painting when applicable.
-REMODEL: Renovating or improving an existing structure or space. Note: overlaps with jobType=remodeling but here describes the type of work performed.
-REPAIR: Fixing an existing product or system.
-SUPPORT: Help with an issue or appointment related to the service but not the work itself (e.g., service follow-up, account help).
-TRANSPORT: Requests to move, haul, or deliver items (e.g., moving services, relocation, junk removal, large delivery).
-TREATMENT: Active service to resolve or prevent an issue (e.g., pest treatment, mold remediation, lawn spraying, rodent removal, recurring pest plans).
-OTHER: Anything not covered above. If multiple apply, pick the most specific.
-
-jobType definitions are as follows:
-appliance_repair: Appliance repair services.
-blinds: Window blinds and shades installation services.
-carpentry: Carpentry or woodworking services.
-cleaning: General cleaning services (house, carpet, duct, etc.).
-construction: General construction services.
-contractor: General contracting services (same as construction).
-drywall: Drywall installation or repair.
-electrical: Electrical work or services.
-electrician: Electrical work or services (same as electrical).
-fencing: Fence installation or repair.
-flooring: Flooring installation, refinishing, or repair (hardwood, tile, etc.).
-gutter: Gutter installation, rerouting, or cleaning.
-gutters: Gutter services (same as gutter).
-handyman: General home repair and maintenance services.
-house_cleaning: House cleaning services (same as cleaning).
-hvac: Heating, ventilation, or air conditioning services.
-junk_removal: Junk and debris removal services.
-landscaping: Landscaping or yard services.
-landscaper: Landscaping services (same as landscaping).
-legal_services: Legal services.
-masonry: Masonry, brick, stone, or tuckpointing work.
-mold_remediation: Mold inspection, removal, or remediation services.
-moving: Moving or relocation services.
-painting: Painting services.
-painter: Painting services (same as painting).
-pest_control: Pest control services (insects, termites, rodents).
-plumbing: Plumbing services.
-pressure_washing: Pressure washing and power washing services.
-remodeling: Remodeling or renovation (kitchen, bathroom, home).
-restoration: Water, fire, or damage restoration services.
-roofing: Roofing services.
-roofer: Roofing services (same as roofing).
-siding: Siding installation or repair services.
-tree_services: Tree removal, trimming, and care services.
-wildlife_control: Wildlife removal or exclusion services (e.g., raccoons, squirrels, bats).
-window_cleaning: Window cleaning services.
-window_installation: Window installation or replacement services.
-windows_doors: Window or door installation or replacement.
-other: Services that do not fit above.
-
-The definitions of each "urgency" value are as follows:
-LOW: The interaction requests a service that is not time sensitive at all and can be addressed at the business's convenience.
-MEDIUM: The interaction requests a service that is not time sensitive and can be addressed within a couple weeks.
-HIGH: The interaction requests some service that is not life threatening, but should be addressed within a few days.  It may lead to property damage or other issues if not addressed in a timely manner.
-URGENT: The interaction requests some service that is life threatening or is causing property damage. It should be addressed as soon as possible, potentially same day.  The longer the business waits to address the issue, the more damage will occur.
-NOT_SPECIFIED: The urgency of the lead could not be determined by the content of the transcript.
-
-Note about "urgency": This isn't necessarily the customer stating that the issue is urgent, but rather the nature of the issue itself.
-
-${highValueLeadInstruction}
-
-Provide a summary of the conversation which will be placed in the value "summary". The summary should not exceed 250 characters.
-
-Provide a concise 2–3 word phrase describing the main topic or service request of the lead. Use context from the business description, jobType, and serviceType if available.  Use information from the message field and leverage the user's words as much as possible. Focus on meaningful keywords related to the issue or service, not greetings or filler words. Return this in the value "conciseSummary".
-Examples:
-- Message: "we need our backflow tested" → "backflow testing"
-- Message: "scorpion and cricket issues" → "scorpion cricket issues"
-- Message: "i'm interested in filing bankruptcy" → "bankruptcy filing"
-- Message (pest control company): "this is only for small casita housing. not big main house" → "casita housing service"
-`;
-    if (!isChat && (0, stentor_utils_1.existsAndNotEmpty)(fields)) {
-        const parsedFields = parseFields(fields);
-        system += `
-The following fields were collected from the customer or potential customer in the form submission:
-${parsedFields}
-`;
-    }
-    // console.log(system);
-    const messages = transcriptToMessages(system, transcript);
-    // determine max_tokens based on the length of the system message
-    //  const systemMessageLength = JSON.stringify(system).length;
-    //  const tokens = getTokens(system);
-    // console.log("System message tokens:", tokens);
-    const max_tokens = 512;
-    return Object.assign(Object.assign({ model: "gpt-4o-mini", 
-        // model: "gpt-4.1-mini",
-        max_tokens, frequency_penalty: 0, temperature: 1, top_p: 1, presence_penalty: 0 }, overrides), { response_format: {
-            type: "json_schema",
-            json_schema: {
-                name: "analyze_lead",
-                strict: false,
-                schema: {
-                    type: "object",
-                    additionalProperties: false,
-                    required: [
-                        "contactType",
-                        "jobType",
-                        "serviceType",
-                        "urgency",
-                        "highValueLead",
-                        "conciseSummary",
-                        "summary",
-                        "analysis"
-                    ],
-                    properties: {
-                        contactType: {
-                            type: "string",
-                            enum: [
-                                "BILLING_ISSUE",
-                                "CANCELLATION",
-                                "COMPLAINT",
-                                "COMPLIMENT",
-                                "CONTACT_REQUEST",
-                                "EMPLOYMENT_INQUIRY",
-                                "MISSED_APPOINTMENT",
-                                "QUESTION",
-                                "QUOTE_REQUEST",
-                                "RESCHEDULE_REQUEST",
-                                "SERVICE_REQUEST",
-                                "SPAM",
-                                "TEST",
-                                "OTHER"
-                            ]
-                        },
-                        jobType: {
-                            type: "string",
-                            enum: [
-                                "appliance_repair",
-                                "blinds",
-                                "carpentry",
-                                "cleaning",
-                                "construction",
-                                "contractor",
-                                "drywall",
-                                "electrical",
-                                "electrician",
-                                "fencing",
-                                "flooring",
-                                "gutter",
-                                "gutters",
-                                "handyman",
-                                "house_cleaning",
-                                "hvac",
-                                "junk_removal",
-                                "landscaping",
-                                "landscaper",
-                                "legal_services",
-                                "masonry",
-                                "mold_remediation",
-                                "moving",
-                                "painting",
-                                "painter",
-                                "pest_control",
-                                "plumbing",
-                                "pressure_washing",
-                                "remodeling",
-                                "restoration",
-                                "roofing",
-                                "roofer",
-                                "siding",
-                                "tree_services",
-                                "wildlife_control",
-                                "window_cleaning",
-                                "window_installation",
-                                "windows_doors",
-                                "other"
-                            ]
-                        },
-                        serviceType: {
-                            type: "string",
-                            enum: [
-                                "CLEANING",
-                                "CONSULTATION",
-                                "INSPECTION",
-                                "INSTALLATION",
-                                "MAINTENANCE",
-                                "REFINISH",
-                                "REMODEL",
-                                "REPAIR",
-                                "SUPPORT",
-                                "TRANSPORT",
-                                "TREATMENT",
-                                "OTHER"
-                            ]
-                        },
-                        urgency: {
-                            type: "string",
-                            enum: ["LOW", "MEDIUM", "HIGH", "URGENT", "NOT_SPECIFIED"]
-                        },
-                        highValueLead: {
-                            type: "boolean"
-                        },
-                        summary: {
-                            type: "string"
-                        },
-                        conciseSummary: {
-                            type: "string"
-                        },
-                        analysis: {
-                            type: "string"
-                        }
-                    }
-                }
-            }
-        }, type: "completions", messages });
-};
-exports.generateAnalyzeLead = generateAnalyzeLead;
-const defaultLeadAnalysis = {
-    contactType: "OTHER",
-    urgency: "NOT_SPECIFIED",
-    highValueLead: false,
-    summary: "A summary could not be generated.",
-    analysis: "An analysis could not be generated."
-};
-const analyzeLeadResponseParse = (response) => {
-    try {
-        const { contactType, jobType, serviceType, urgency, highValueLead, summary, analysis, conciseSummary } = JSON.parse((0, extractJSON_1.extractJSON)(response));
-        const draftAnalysis = Object.assign(Object.assign({}, defaultLeadAnalysis), { contactType: (contactType === null || contactType === void 0 ? void 0 : contactType.toUpperCase()) || defaultLeadAnalysis.contactType, urgency: (urgency === null || urgency === void 0 ? void 0 : urgency.toUpperCase()) || defaultLeadAnalysis.urgency, highValueLead: (highValueLead === null || highValueLead === void 0 ? void 0 : highValueLead.toString().toLocaleLowerCase()) === "true" || defaultLeadAnalysis.highValueLead, summary: summary || defaultLeadAnalysis.summary, analysis: analysis || defaultLeadAnalysis.analysis });
-        if (conciseSummary) {
-            draftAnalysis.conciseSummary = conciseSummary;
-        }
-        if (jobType) {
-            draftAnalysis.jobType = jobType.toLowerCase();
-        }
-        if (serviceType) {
-            draftAnalysis.serviceType = serviceType.toUpperCase();
-        }
-        return draftAnalysis;
-    }
-    catch (e) {
-        return Object.assign({}, defaultLeadAnalysis);
-    }
-};
-exports.analyzeLeadResponseParse = analyzeLeadResponseParse;
-//# sourceMappingURL=AnalyzeLead.js.map

package/lib/prompts/AnalyzeLead.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnalyzeLead.js","sourceRoot":"","sources":["../../src/prompts/AnalyzeLead.ts"],"names":[],"mappings":";;;AAiCA,kDAMC;AASD,oDA8BC;AAOD,kCAaC;AAQD,kEAEC;AA1GD,iDAAkD;AAGlD,sDAAmD;AAiBnD,SAAS,OAAO,CAAC,OAA+C;IAC5D,mCAAmC;IACnC,OAAO,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,MAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,CAAA,KAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,CAAA,IAAI,SAAS,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,UAAsC;IACtE,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAChC,MAAc,EACd,UAAqB;IAErB,MAAM,QAAQ,GAAiE;QAC3E;YACI,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,MAAM;SAClB;KACJ,CAAC;IAEF,uCAAuC;IACvC,IAAI,IAAA,iCAAiB,EAAC,UAAU,CAAC,EAAE,CAAC;QAChC,qEAAqE;QACrE,yFAAyF;QACzF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;QACpD,+DAA+D;QAC/D,gDAAgD;QAChD,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,GACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;YAElF,QAAQ,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,OAAO,CAAC,OAAO;aAC3B,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AACD;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,MAA8B;IACtD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACtC,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,IAAI,qBAAqB,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,wBAA4C;IACpF,OAAO,wBAAwB,IAAI,2DAA2D,CAAC;AACnG,CAAC;AAMD;;;;;;;;;GASG;AACI,MAAM,mBAAmB,GAAkF,CAC9G,EAAE,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,EAAE,EAC9E,SAAS,EACO,EAAE;IAClB,uBAAuB;IAEvB,+EAA+E;IAC/E,iEAAiE;IACjE,kHAAkH;IAElH,MAAM,MAAM,GAAG,OAAO,KAAK,QAAQ,IAAI,IAAA,iCAAiB,EAAC,UAAU,CAAC,CAAC;IAErE,MAAM,sBAAsB,GAAG,CAAC,CAAC,mBAAmB,CAAC;IACrD,MAAM,2BAA2B,GAAG,CAAC,CAAC,wBAAwB,CAAC;IAE/D,IAAI,KAAK,GAAG,iDAAiD,CAAC;IAE9D,IAAI,sBAAsB,EAAE,CAAC;QACzB,KAAK,GAAG;;;;EAId,mBAAmB;IACjB,CAAC;IACD,CAAC;IAED,MAAM,YAAY,GAAG,MAAM;QACvB,CAAC,CAAC,wJAAwJ;QAC1J,CAAC,CAAC,6GAA6G,CAAC;IAEpH,IAAI,wBAAwB,GAAG,8EAA8E,CAAC;IAC9G,IAAI,2BAA2B,EAAE,CAAC;QAC9B,wBAAwB,GAAG;;EAEjC,2BAA2B,CAAC,wBAAwB,CAAC;IACnD,CAAC;IACD,CAAC;IAED,IAAI,MAAM,GAAG;EACf,KAAK;;EAEL,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiGZ,wBAAwB;;;;;;;;;;CAUzB,CAAC;IAEE,IAAI,CAAC,MAAM,IAAI,IAAA,iCAAiB,EAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,IAAI;;EAEhB,YAAY;CACb,CAAC;IACE,CAAC;IAED,uBAAuB;IAEvB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE1D,iEAAiE;IACjE,8DAA8D;IAC9D,qCAAqC;IACrC,iDAAiD;IAEjD,MAAM,UAAU,GAAG,GAAG,CAAC;IAEvB,qCACI,KAAK,EAAE,aAAa;QACpB,yBAAyB;QACzB,UAAU,EACV,iBAAiB,EAAE,CAAC,EACpB,WAAW,EAAE,CAAC,EACd,KAAK,EAAE,CAAC,EACR,gBAAgB,EAAE,CAAC,IAChB,SAAS,KACZ,eAAe,EAAE;YACb,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE;gBACT,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,KAAK;oBAC3B,QAAQ,EAAE;wBACN,aAAa;wBACb,SAAS;wBACT,aAAa;wBACb,SAAS;wBACT,eAAe;wBACf,gBAAgB;wBAChB,SAAS;wBACT,UAAU;qBACb;oBACD,UAAU,EAAE;wBACR,WAAW,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE;gCACF,eAAe;gCACf,cAAc;gCACd,WAAW;gCACX,YAAY;gCACZ,iBAAiB;gCACjB,oBAAoB;gCACpB,oBAAoB;gCACpB,UAAU;gCACV,eAAe;gCACf,oBAAoB;gCACpB,iBAAiB;gCACjB,MAAM;gCACN,MAAM;gCACN,OAAO;6BACV;yBACJ;wBACD,OAAO,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE;gCACF,kBAAkB;gCAClB,QAAQ;gCACR,WAAW;gCACX,UAAU;gCACV,cAAc;gCACd,YAAY;gCACZ,SAAS;gCACT,YAAY;gCACZ,aAAa;gCACb,SAAS;gCACT,UAAU;gCACV,QAAQ;gCACR,SAAS;gCACT,UAAU;gCACV,gBAAgB;gCAChB,MAAM;gCACN,cAAc;gCACd,aAAa;gCACb,YAAY;gCACZ,gBAAgB;gCAChB,SAAS;gCACT,kBAAkB;gCAClB,QAAQ;gCACR,UAAU;gCACV,SAAS;gCACT,cAAc;gCACd,UAAU;gCACV,kBAAkB;gCAClB,YAAY;gCACZ,aAAa;gCACb,SAAS;gCACT,QAAQ;gCACR,QAAQ;gCACR,eAAe;gCACf,kBAAkB;gCAClB,iBAAiB;gCACjB,qBAAqB;gCACrB,eAAe;gCACf,OAAO;6BACV;yBACJ;wBACD,WAAW,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE;gCACF,UAAU;gCACV,cAAc;gCACd,YAAY;gCACZ,cAAc;gCACd,aAAa;gCACb,UAAU;gCACV,SAAS;gCACT,QAAQ;gCACR,SAAS;gCACT,WAAW;gCACX,WAAW;gCACX,OAAO;6BACV;yBACJ;wBACD,OAAO,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC;yBAC7D;wBACD,aAAa,EAAE;4BACX,IAAI,EAAE,SAAS;yBAClB;wBACD,OAAO,EAAE;4BACL,IAAI,EAAE,QAAQ;yBACjB;wBACD,cAAc,EAAE;4BACZ,IAAI,EAAE,QAAQ;yBACjB;wBACD,QAAQ,EAAE;4BACN,IAAI,EAAE,QAAQ;yBACjB;qBACJ;iBACJ;aACJ;SACJ,EACD,IAAI,EAAE,aAAa,EACnB,QAAQ,IACV;AACN,CAAC,CAAC;AA5SW,QAAA,mBAAmB,uBA4S9B;AAEF,MAAM,mBAAmB,GAAiB;IACtC,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,KAAK;IACpB,OAAO,EAAE,mCAAmC;IAC5C,QAAQ,EAAE,qCAAqC;CAClD,CAAC;AAEK,MAAM,wBAAwB,GAAiC,CAAC,QAAQ,EAAgB,EAAE;IAC7F,IAAI,CAAC;QACD,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,GAClG,IAAI,CAAC,KAAK,CAAC,IAAA,yBAAW,EAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,MAAM,aAAa,mCACZ,mBAAmB,KACtB,WAAW,EAAE,CAAC,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,EAAkC,KAAI,mBAAmB,CAAC,WAAW,EAC3G,OAAO,EAAE,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,EAA8B,KAAI,mBAAmB,CAAC,OAAO,EAC3F,aAAa,EACT,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,QAAQ,GAAG,iBAAiB,EAAE,MAAK,MAAM,IAAI,mBAAmB,CAAC,aAAa,EACjG,OAAO,EAAE,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAC/C,QAAQ,EAAE,QAAQ,IAAI,mBAAmB,CAAC,QAAQ,GACrD,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACjB,aAAa,CAAC,cAAc,GAAG,cAAc,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACV,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC,WAAW,EAA6B,CAAC;QAC7E,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YACd,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW,EAAiC,CAAC;QACzF,CAAC;QAED,OAAO,aAAa,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,yBAAY,mBAAmB,EAAG;IACtC,CAAC;AACL,CAAC,CAAC;AA9BW,QAAA,wBAAwB,4BA8BnC"}

package/lib/prompts/AnalyzeWebsite.d.ts

@@ -1,10 +0,0 @@
-/*! Copyright (c) 2025, XAPP AI */
-import { CompletionPrompt, PromptGenerator, ResponseParser } from "../models";
-import { WebsiteAnalysis } from "../models/WebsiteAnalysis";
-export interface AnalyzeWebsiteProps {
-    markdown: string;
-    url: string;
-}
-export type AnalyzeWebsiteLLMOverrides = Partial<Pick<CompletionPrompt, "model" | "max_tokens" | "temperature" | "top_p" | "frequency_penalty" | "presence_penalty">>;
-export declare const generateAnalyzeWebsite: PromptGenerator<AnalyzeWebsiteProps, AnalyzeWebsiteLLMOverrides, CompletionPrompt>;
-export declare const parseAnalyzeWebsiteResponse: ResponseParser<WebsiteAnalysis>;

package/lib/prompts/AnalyzeWebsite.js

@@ -1,176 +0,0 @@
-"use strict";
-/*! Copyright (c) 2025, XAPP AI */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAnalyzeWebsiteResponse = exports.generateAnalyzeWebsite = void 0;
-const stentor_utils_1 = require("stentor-utils");
-const arachne_utils_1 = require("@xapp/arachne-utils");
-const generateAnalyzeWebsite = ({ markdown, url }, overrides) => {
-    const content = `
-Your task is to analyze the contents of a website (provided in markdown below) found at ${url} and provide information about the organization from what is on the website.  You will only provide information available through the website content about the services they provide, contact information and a description of the business.
-
-===========
-${markdown}
-===========
-
-Please print out in JSON format on one line information about the website above with the following keys:
-
-"parked_domain" - Boolean, true if the website is a parked domain such as for sale, coming soon, no longer active by the host, used for type-in traffic monetization.  This is false if the website is for an actual organization or business.
-"organization_name" - The name of the organization for the website.
-"email" - An array of emails for the organization. If available, include what they are used for such as "sales" or "info", if unknown then leave it blank.  Use an object with keys: email and purpose.
-"phone_numbers" - An array of phone numbers for the organization.  If available, include what they are used for such as "main phone", "customer support" or "sales", if unknown then leave it blank.  The numbers must appear in the provided website content.  Use an object with keys: number and purpose.
-"addresses" - An array of address objects for the organization.  Partial address objects are acceptable.  The keys for the address object are as follows:
-    "formatted" - The full formatted address, similar to what Google Autocomplete API provides.
-    "streetAddress" - The street address with street number and name, quadrant, etc.
-    "locality" - City, Town or Locality.  This is typically from the "city" of "city", "state"
-    "region" - Typically the state or province
-    "postalCode" - The postal or zip code
-    "country" - The country
-"services" - An array of the possible top five unique most common services the organization provides, they should be concise and no more than a few words.  These will include but not limited to: "hvac", "plumbing", "electrical", "roofing",
-"calls_to_action" - An array of the top five unique calls to action found on the site and their fully formed URL if they have one.  Good examples of calls to actions are "Request Demo", "Get Started", "Free Quote", "Schedule Consultation", "Sign Up".  Bad examples are "Learn More" or "Follow us on Facebook".  Use an object with keys: url & callToAction in the array.  For the url please combine it properly with the website's URL.
-"description" - A description of what the organization does, include the name of the organization, their services, their location, phone number, email.  Keep it concise and to a few sentences and around 480 characters.
-"industry_category" - A description of which industry category the business is in.  Only pick from one of the following and use the value in quotes:
-    "business-coaching" - Business provides coaching services for other business
-    "consulting" - Business provides consulting services
-    "financial-services" - Business provides wealth & asset management services
-    "home-services-cleaning" - Provide janitorial and cleaning services
-    "home-services-contractors" - Electricians, plumbers, roofers, and other technicians and contractors
-    "home-services-outdoor" - Lawn care, gardeners and other outside residential services
-    "pest-control" - Pest control services
-    "insurance" - Insurance agents and brokers,
-    "legal-services" - Lawyers, legal services, tax attorneys
-    "life-coaching" - Life coaching services
-    "real-estate" - Real estate agents and brokers
-    "technology-services" - IT consultants and software services
-    "travel" - Travel agents
-    "property-management" - Property management services
-`.trim();
-    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: "json_schema",
-            json_schema: {
-                name: "analyze_website",
-                strict: true,
-                schema: {
-                    type: "object",
-                    properties: {
-                        parked_domain: { type: "boolean" },
-                        organization_name: { type: "string" },
-                        email: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: {
-                                    email: { type: "string" },
-                                    purpose: { type: "string", nullable: true }
-                                },
-                                required: ["email"]
-                            }
-                        },
-                        phone_numbers: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: {
-                                    number: { type: "string" },
-                                    purpose: { type: "string", nullable: true }
-                                },
-                                required: ["number"]
-                            }
-                        },
-                        addresses: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: {
-                                    formatted: { type: "string", nullable: true },
-                                    streetAddress: { type: "string", nullable: true },
-                                    locality: { type: "string", nullable: true },
-                                    region: { type: "string", nullable: true },
-                                    postalCode: { type: "string", nullable: true },
-                                    country: { type: "string", nullable: true }
-                                }
-                            }
-                        },
-                        services: { type: "array", items: { type: "string" } },
-                        calls_to_action: {
-                            type: "array",
-                            items: {
-                                type: "object",
-                                properties: { url: { type: "string" }, callToAction: { type: "string" } }
-                            }
-                        },
-                        description: { type: "string" },
-                        industry_category: { type: "string" }
-                    },
-                    required: [
-                        "parked_domain",
-                        "organization_name",
-                        "email",
-                        "phone_numbers",
-                        "addresses",
-                        "services",
-                        "calls_to_action",
-                        "description",
-                        "industry_category"
-                    ]
-                }
-            }
-        }, type: "completions", messages: [
-            {
-                role: "system",
-                content
-            }
-        ] });
-};
-exports.generateAnalyzeWebsite = generateAnalyzeWebsite;
-const parseAnalyzeWebsiteResponse = (response) => {
-    const DEFAULT_ANALYSIS = {
-        parked_domain: false,
-        organization_name: "",
-        email: [],
-        phone_numbers: [],
-        addresses: [],
-        services: [],
-        calls_to_action: [],
-        description: "",
-        industry_category: "contact-capture"
-    };
-    try {
-        const { parked_domain, organization_name, description, industry_category, phone_numbers, email, addresses, services, calls_to_action } = JSON.parse(response);
-        const analysis = Object.assign(Object.assign({}, DEFAULT_ANALYSIS), { parked_domain,
-            organization_name,
-            description });
-        if (industry_category) {
-            analysis.industry_category = industry_category;
-        }
-        if ((0, stentor_utils_1.existsAndNotEmpty)(addresses)) {
-            analysis.addresses = addresses;
-        }
-        // filter out hallucinated phone numbers
-        if ((0, stentor_utils_1.existsAndNotEmpty)(phone_numbers)) {
-            // clean for hallucinations
-            // numbers like 123-45678 or numbers like 555-
-            const mostLikelyRealPhoneNumbers = phone_numbers
-                .filter((number) => !!number.number)
-                .filter((number) => !(0, arachne_utils_1.isHallucinatedPhoneNumber)(number.number));
-            analysis.phone_numbers = mostLikelyRealPhoneNumbers;
-        }
-        // filter out hallucinated emails
-        if ((0, stentor_utils_1.existsAndNotEmpty)(email)) {
-            const filteredEmails = email.filter((e) => !!e.email).filter((e) => !(0, arachne_utils_1.isHallucinatedEmail)(e.email));
-            analysis.email = filteredEmails;
-        }
-        if ((0, stentor_utils_1.existsAndNotEmpty)(services)) {
-            analysis.services = services;
-        }
-        if ((0, stentor_utils_1.existsAndNotEmpty)(calls_to_action)) {
-            analysis.calls_to_action = calls_to_action;
-        }
-        return analysis;
-    }
-    catch (error) {
-        console.error("Error parsing analyze website response:", error);
-        return DEFAULT_ANALYSIS;
-    }
-};
-exports.parseAnalyzeWebsiteResponse = parseAnalyzeWebsiteResponse;
-//# sourceMappingURL=AnalyzeWebsite.js.map

package/lib/prompts/AnalyzeWebsite.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AnalyzeWebsite.js","sourceRoot":"","sources":["../../src/prompts/AnalyzeWebsite.ts"],"names":[],"mappings":"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"}