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

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "1.85.1",
+    "version": "1.89.0",
     "description": "Generative AI Service",
     "types": "lib/index",
     "main": "lib/index",
@@ -46,5 +46,5 @@
         "test": "mocha --recursive -r ts-node/register \"./src/**/*.test.ts\"",
         "ftest": "mocha --recursive -r ts-node/register \"./src/**/*.ftest.ts\""
     },
-    "gitHead": "f8d9f2ad89e064b707c80a15f6c8c173b9bb6843"
+    "gitHead": "9ca70c64befe97bf993832bf3648a2e4ce77e6c9"
 }

package/lib/AWSBedrockService.d.ts

@@ -1,67 +0,0 @@
-/*! Copyright (c) 2024, XAPP AI */
-import type { LLMService, LLMServiceResponse, Prompt, CompletionPrompt } from "./models";
-export interface AWSBedrockServiceProps {
-    /**
-     * The AWS region to use for Bedrock
-     * @default "us-east-1"
-     */
-    region?: string;
-    /**
-     * AWS credentials configuration
-     */
-    credentials?: {
-        accessKeyId: string;
-        secretAccessKey: string;
-        sessionToken?: string;
-    };
-    /**
-     * The Bedrock model ID or inference profile to use.
-     * Newer models require inference profiles (prefixed with region, e.g., "us.").
-     * @default "us.anthropic.claude-haiku-4-5-20251001-v1:0"
-     */
-    modelId?: string;
-}
-/**
- * AWS Bedrock service for Anthropic Claude models
- *
- * This service implements the LLMService interface for AWS Bedrock,
- * providing access to Anthropic Claude models hosted on Bedrock.
- *
- * @example
- * ```typescript
- * const service = new AWSBedrockService({
- *   region: "us-east-1",
- *   modelId: "anthropic.claude-3-5-sonnet-20241022-v2:0"
- * });
- * ```
- */
-export declare class AWSBedrockService implements LLMService {
-    private readonly client;
-    private readonly modelId;
-    private static readonly textDecoder;
-    constructor(props: AWSBedrockServiceProps);
-    /**
-     * Generate a response from the LLM based on the provided prompt
-     *
-     * @param prompt - The prompt to send to the LLM
-     * @param options - Optional configuration (Note: timeout is not supported for Bedrock and will be ignored with a warning)
-     * @returns The LLM service response
-     * @throws {InvalidPromptTypeError} If the prompt type is not supported
-     */
-    generate(prompt: Prompt, options?: {
-        timeout?: number;
-    }): Promise<LLMServiceResponse>;
-    /**
-     * Generate completions using AWS Bedrock Claude models
-     *
-     * Note: The following CompletionPrompt parameters are not supported by Claude on Bedrock
-     * and will be ignored: frequency_penalty, presence_penalty, response_format
-     *
-     * System messages are extracted from the messages array and concatenated with double
-     * newlines to form a single system prompt, as Claude's API only accepts one system field.
-     *
-     * @param prompt - The completion prompt
-     * @returns The LLM service response
-     */
-    completions(prompt: CompletionPrompt): Promise<LLMServiceResponse>;
-}

package/lib/AWSBedrockService.js

@@ -1,133 +0,0 @@
-"use strict";
-/*! Copyright (c) 2024, XAPP AI */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AWSBedrockService = void 0;
-const client_bedrock_runtime_1 = require("@aws-sdk/client-bedrock-runtime");
-const models_1 = require("./models");
-const BEDROCK_API_VERSION = "bedrock-2023-05-31";
-/**
- * AWS Bedrock service for Anthropic Claude models
- *
- * This service implements the LLMService interface for AWS Bedrock,
- * providing access to Anthropic Claude models hosted on Bedrock.
- *
- * @example
- * ```typescript
- * const service = new AWSBedrockService({
- *   region: "us-east-1",
- *   modelId: "anthropic.claude-3-5-sonnet-20241022-v2:0"
- * });
- * ```
- */
-class AWSBedrockService {
-    constructor(props) {
-        this.client = new client_bedrock_runtime_1.BedrockRuntimeClient({
-            region: props.region || "us-east-1",
-            credentials: props.credentials,
-        });
-        this.modelId = props.modelId || "us.anthropic.claude-haiku-4-5-20251001-v1:0";
-    }
-    /**
-     * Generate a response from the LLM based on the provided prompt
-     *
-     * @param prompt - The prompt to send to the LLM
-     * @param options - Optional configuration (Note: timeout is not supported for Bedrock and will be ignored with a warning)
-     * @returns The LLM service response
-     * @throws {InvalidPromptTypeError} If the prompt type is not supported
-     */
-    generate(prompt, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if ((options === null || options === void 0 ? void 0 : options.timeout) !== undefined) {
-                console.warn("AWSBedrockService: timeout option is not supported and will be ignored");
-            }
-            const { type } = prompt;
-            if (type === "completions") {
-                return this.completions(prompt);
-            }
-            throw new models_1.InvalidPromptTypeError(type);
-        });
-    }
-    /**
-     * Generate completions using AWS Bedrock Claude models
-     *
-     * Note: The following CompletionPrompt parameters are not supported by Claude on Bedrock
-     * and will be ignored: frequency_penalty, presence_penalty, response_format
-     *
-     * System messages are extracted from the messages array and concatenated with double
-     * newlines to form a single system prompt, as Claude's API only accepts one system field.
-     *
-     * @param prompt - The completion prompt
-     * @returns The LLM service response
-     */
-    completions(prompt) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // Extract and combine all system messages into a single prompt.
-            // Multiple system messages are joined with double newlines.
-            const systemMessages = prompt.messages
-                .filter((msg) => msg.role === "system")
-                .map((msg) => msg.content);
-            const systemPrompt = systemMessages.length > 0 ? systemMessages.join("\n\n") : undefined;
-            // Convert OpenAI-style messages to Claude format, excluding system messages
-            const messages = prompt.messages
-                .filter((msg) => msg.role !== "system")
-                .map((msg) => ({
-                role: msg.role,
-                content: msg.content,
-            }));
-            // Build the request payload for Claude
-            // Note: frequency_penalty, presence_penalty, and response_format are not supported by Bedrock
-            const requestBody = {
-                anthropic_version: BEDROCK_API_VERSION,
-                messages: messages,
-                max_tokens: prompt.max_tokens || 1024,
-            };
-            // Claude models do not allow both temperature and top_p simultaneously
-            if (prompt.temperature !== undefined) {
-                requestBody.temperature = prompt.temperature;
-            }
-            else if (prompt.top_p !== undefined) {
-                requestBody.top_p = prompt.top_p;
-            }
-            if (systemPrompt) {
-                requestBody.system = systemPrompt;
-            }
-            const input = {
-                modelId: this.modelId,
-                contentType: "application/json",
-                accept: "application/json",
-                body: JSON.stringify(requestBody),
-            };
-            const command = new client_bedrock_runtime_1.InvokeModelCommand(input);
-            const response = yield this.client.send(command);
-            // Parse the response
-            let responseBody;
-            try {
-                responseBody = JSON.parse(AWSBedrockService.textDecoder.decode(response.body));
-            }
-            catch (error) {
-                throw new Error(`Failed to parse Bedrock response: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            // Check for error responses
-            if (responseBody.error || responseBody.message) {
-                throw new Error(`Bedrock API error: ${responseBody.message || responseBody.error}`);
-            }
-            // Extract content from Claude's response format
-            if (!responseBody.content || !Array.isArray(responseBody.content) || responseBody.content.length === 0) {
-                throw new Error(`Unexpected Bedrock response format: ${JSON.stringify(responseBody)}`);
-            }
-            return { text: responseBody.content[0].text };
-        });
-    }
-}
-exports.AWSBedrockService = AWSBedrockService;
-AWSBedrockService.textDecoder = new TextDecoder();
-//# sourceMappingURL=AWSBedrockService.js.map

package/lib/AWSBedrockService.js.map

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

package/lib/ClaudeService.d.ts

@@ -1,77 +0,0 @@
-/*! Copyright (c) 2024, XAPP AI */
-import type { APIKeyGetter, LLMService, LLMServiceResponse, Prompt, CompletionPrompt } from "./models";
-import type { HTTPService } from "./http/HTTPService";
-export declare const DEFAULT_CLAUDE_API_URL = "https://api.anthropic.com";
-export declare const DEFAULT_CLAUDE_MODEL = "claude-3-5-haiku-20241022";
-export declare const ANTHROPIC_API_VERSION = "2023-06-01";
-export interface ClaudeServiceProps {
-    /**
-     * Returns the API key to use for the Anthropic Claude service authorization
-     */
-    keyGetter: APIKeyGetter;
-    /**
-     * The HTTP service to use for making requests
-     *
-     * Defaults to a Node.js HTTP service if not provided.
-     */
-    httpService?: Pick<HTTPService, "post">;
-    /**
-     * The base URL for the Claude API
-     * @default "https://api.anthropic.com"
-     */
-    apiUrl?: string;
-    /**
-     * The model to use for completions
-     * @default "claude-3-5-haiku-20241022"
-     */
-    model?: string;
-}
-/**
- * Claude service for direct Anthropic API calls.
- *
- * This service implements the LLMService interface for the Anthropic Claude API,
- * providing direct access to Claude models without going through AWS Bedrock.
- *
- * @example
- * ```typescript
- * const service = new ClaudeService({
- *   keyGetter: () => process.env.ANTHROPIC_API_KEY || "",
- *   model: "claude-3-5-haiku-20241022"
- * });
- * ```
- */
-export declare class ClaudeService implements LLMService {
-    private readonly keyGetter;
-    private readonly apiUrl;
-    private readonly httpService;
-    private readonly model;
-    constructor(props: ClaudeServiceProps);
-    /**
-     * Generate a response from the LLM based on the provided prompt
-     *
-     * @param prompt - The prompt to send to the LLM
-     * @param options - Optional configuration including timeout
-     * @returns The LLM service response
-     * @throws {InvalidPromptTypeError} If the prompt type is not supported
-     */
-    generate(prompt: Prompt, options?: {
-        timeout?: number;
-    }): Promise<LLMServiceResponse>;
-    /**
-     * Generate completions using the Anthropic Claude API
-     *
-     * Note: The following CompletionPrompt parameters are not supported by Claude
-     * and will be ignored: frequency_penalty, presence_penalty, response_format
-     *
-     * System messages are extracted from the messages array and concatenated with double
-     * newlines to form a single system prompt, as Claude's API only accepts one system field.
-     *
-     * @param prompt - The completion prompt
-     * @param options - Optional configuration including timeout
-     * @returns The LLM service response
-     */
-    completions(prompt: CompletionPrompt, options?: {
-        timeout?: number;
-    }): Promise<LLMServiceResponse>;
-    private post;
-}

package/lib/ClaudeService.js

@@ -1,142 +0,0 @@
-"use strict";
-/*! Copyright (c) 2024, XAPP AI */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClaudeService = exports.ANTHROPIC_API_VERSION = exports.DEFAULT_CLAUDE_MODEL = exports.DEFAULT_CLAUDE_API_URL = void 0;
-const models_1 = require("./models");
-const http_1 = require("./http");
-exports.DEFAULT_CLAUDE_API_URL = "https://api.anthropic.com";
-exports.DEFAULT_CLAUDE_MODEL = "claude-3-5-haiku-20241022";
-exports.ANTHROPIC_API_VERSION = "2023-06-01";
-/**
- * Claude service for direct Anthropic API calls.
- *
- * This service implements the LLMService interface for the Anthropic Claude API,
- * providing direct access to Claude models without going through AWS Bedrock.
- *
- * @example
- * ```typescript
- * const service = new ClaudeService({
- *   keyGetter: () => process.env.ANTHROPIC_API_KEY || "",
- *   model: "claude-3-5-haiku-20241022"
- * });
- * ```
- */
-class ClaudeService {
-    constructor(props) {
-        this.keyGetter = props.keyGetter;
-        this.apiUrl = props.apiUrl || exports.DEFAULT_CLAUDE_API_URL;
-        this.httpService = props.httpService || new http_1.NodeHttpService();
-        this.model = props.model || exports.DEFAULT_CLAUDE_MODEL;
-    }
-    /**
-     * Generate a response from the LLM based on the provided prompt
-     *
-     * @param prompt - The prompt to send to the LLM
-     * @param options - Optional configuration including timeout
-     * @returns The LLM service response
-     * @throws {InvalidPromptTypeError} If the prompt type is not supported
-     */
-    generate(prompt, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const { type } = prompt;
-            if (type === "completions") {
-                return this.completions(prompt, options);
-            }
-            throw new models_1.InvalidPromptTypeError(type);
-        });
-    }
-    /**
-     * Generate completions using the Anthropic Claude API
-     *
-     * Note: The following CompletionPrompt parameters are not supported by Claude
-     * and will be ignored: frequency_penalty, presence_penalty, response_format
-     *
-     * System messages are extracted from the messages array and concatenated with double
-     * newlines to form a single system prompt, as Claude's API only accepts one system field.
-     *
-     * @param prompt - The completion prompt
-     * @param options - Optional configuration including timeout
-     * @returns The LLM service response
-     */
-    completions(prompt, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // Extract and combine all system messages into a single prompt.
-            // Multiple system messages are joined with double newlines.
-            const systemMessages = prompt.messages
-                .filter((msg) => msg.role === "system")
-                .map((msg) => msg.content);
-            const systemPrompt = systemMessages.length > 0 ? systemMessages.join("\n\n") : undefined;
-            // Convert messages to Claude format, excluding system messages
-            const messages = prompt.messages
-                .filter((msg) => msg.role !== "system")
-                .map((msg) => ({
-                role: msg.role,
-                content: msg.content
-            }));
-            // Build the request payload for Claude
-            // Note: frequency_penalty, presence_penalty, and response_format are not supported
-            const requestBody = {
-                model: this.model,
-                messages: messages,
-                max_tokens: prompt.max_tokens || 1024,
-                temperature: prompt.temperature,
-                top_p: prompt.top_p
-            };
-            if (systemPrompt) {
-                requestBody.system = systemPrompt;
-            }
-            const response = yield this.post({
-                path: "v1/messages",
-                body: requestBody
-            }, options);
-            // Parse the response
-            let responseBody;
-            try {
-                responseBody = JSON.parse(response.body);
-            }
-            catch (error) {
-                throw new Error(`Failed to parse Claude response: ${error instanceof Error ? error.message : String(error)}`);
-            }
-            // Check for error responses
-            if (responseBody.error) {
-                throw new Error(`Claude API error: ${responseBody.error.message}`);
-            }
-            // Extract content from Claude's response format
-            if (!responseBody.content || !Array.isArray(responseBody.content) || responseBody.content.length === 0) {
-                throw new Error(`Unexpected Claude response format: ${JSON.stringify(responseBody)}`);
-            }
-            const textContent = responseBody.content.find((c) => c.type === "text");
-            if (!textContent) {
-                throw new Error(`No text content in Claude response: ${JSON.stringify(responseBody)}`);
-            }
-            return { text: textContent.text };
-        });
-    }
-    post(props, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const apiKey = yield this.keyGetter();
-            const response = yield this.httpService.post({
-                url: `${this.apiUrl}/${props.path}`,
-                body: props.body,
-                headers: {
-                    "x-api-key": apiKey,
-                    "anthropic-version": exports.ANTHROPIC_API_VERSION,
-                    "content-type": "application/json"
-                },
-                timeout: options === null || options === void 0 ? void 0 : options.timeout
-            });
-            return response;
-        });
-    }
-}
-exports.ClaudeService = ClaudeService;
-//# sourceMappingURL=ClaudeService.js.map

package/lib/ClaudeService.js.map

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

package/lib/FallbackLLMService.d.ts

@@ -1,46 +0,0 @@
-/*! Copyright (c) 2024, XAPP AI */
-import type { LLMService, LLMServiceResponse, Prompt } from "./models";
-export interface FallbackLLMServiceProps {
-    /**
-     * The primary LLM service to use
-     */
-    primary: LLMService;
-    /**
-     * The fallback LLM service to use when the primary is rate limited
-     */
-    fallback: LLMService;
-    /**
-     * Optional callback when fallback is triggered
-     */
-    onFallback?: (error: Error) => void;
-}
-/**
- * An LLM service that wraps a primary service with a fallback service.
- * When the primary service returns a rate limit error, the fallback service is used.
- *
- * @example
- * ```typescript
- * const service = new FallbackLLMService({
- *   primary: new AWSBedrockService({ region: "us-east-1" }),
- *   fallback: new OpenAIService({ keyGetter: () => process.env.OPENAI_API_KEY }),
- *   onFallback: (error) => console.warn("Falling back due to:", error.message)
- * });
- * ```
- */
-export declare class FallbackLLMService implements LLMService {
-    private readonly primary;
-    private readonly fallback;
-    private readonly onFallback?;
-    constructor(props: FallbackLLMServiceProps);
-    /**
-     * Generate a response from the primary LLM service, falling back to the
-     * secondary service if the primary returns a rate limit error.
-     *
-     * @param prompt - The prompt to send to the LLM
-     * @param options - Optional configuration including timeout
-     * @returns The LLM service response
-     */
-    generate(prompt: Prompt, options?: {
-        timeout?: number;
-    }): Promise<LLMServiceResponse>;
-}

package/lib/FallbackLLMService.js

@@ -1,83 +0,0 @@
-"use strict";
-/*! Copyright (c) 2024, XAPP AI */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FallbackLLMService = void 0;
-/**
- * Error patterns that indicate rate limiting and should trigger fallback
- */
-const RATE_LIMIT_PATTERNS = [
-    /rate limit/i,
-    /throttl/i,
-    /too many requests/i,
-    /429/,
-    /ThrottlingException/i,
-    /ServiceQuotaExceededException/i,
-    /ProvisionedThroughputExceededException/i
-];
-/**
- * Check if an error is a rate limit error
- */
-function isRateLimitError(error) {
-    if (error instanceof Error) {
-        return RATE_LIMIT_PATTERNS.some((pattern) => pattern.test(error.message));
-    }
-    if (typeof error === "string") {
-        return RATE_LIMIT_PATTERNS.some((pattern) => pattern.test(error));
-    }
-    return false;
-}
-/**
- * An LLM service that wraps a primary service with a fallback service.
- * When the primary service returns a rate limit error, the fallback service is used.
- *
- * @example
- * ```typescript
- * const service = new FallbackLLMService({
- *   primary: new AWSBedrockService({ region: "us-east-1" }),
- *   fallback: new OpenAIService({ keyGetter: () => process.env.OPENAI_API_KEY }),
- *   onFallback: (error) => console.warn("Falling back due to:", error.message)
- * });
- * ```
- */
-class FallbackLLMService {
-    constructor(props) {
-        this.primary = props.primary;
-        this.fallback = props.fallback;
-        this.onFallback = props.onFallback;
-    }
-    /**
-     * Generate a response from the primary LLM service, falling back to the
-     * secondary service if the primary returns a rate limit error.
-     *
-     * @param prompt - The prompt to send to the LLM
-     * @param options - Optional configuration including timeout
-     * @returns The LLM service response
-     */
-    generate(prompt, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                return yield this.primary.generate(prompt, options);
-            }
-            catch (error) {
-                if (isRateLimitError(error)) {
-                    if (this.onFallback && error instanceof Error) {
-                        this.onFallback(error);
-                    }
-                    return this.fallback.generate(prompt, options);
-                }
-                throw error;
-            }
-        });
-    }
-}
-exports.FallbackLLMService = FallbackLLMService;
-//# sourceMappingURL=FallbackLLMService.js.map

package/lib/FallbackLLMService.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FallbackLLMService.js","sourceRoot":"","sources":["../src/FallbackLLMService.ts"],"names":[],"mappings":";AAAA,kCAAkC;;;;;;;;;;;;AAIlC;;GAEG;AACH,MAAM,mBAAmB,GAAG;IACxB,aAAa;IACb,UAAU;IACV,oBAAoB;IACpB,KAAK;IACL,sBAAsB;IACtB,gCAAgC;IAChC,yCAAyC;CAC5C,CAAC;AAEF;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAiBD;;;;;;;;;;;;GAYG;AACH,MAAa,kBAAkB;IAK3B,YAAY,KAA8B;QACtC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACG,QAAQ,CAAC,MAAc,EAAE,OAA8B;;YACzD,IAAI,CAAC;gBACD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,IAAI,IAAI,CAAC,UAAU,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;wBAC5C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBAC3B,CAAC;oBACD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACnD,CAAC;gBACD,MAAM,KAAK,CAAC;YAChB,CAAC;QACL,CAAC;KAAA;CACJ;AAhCD,gDAgCC"}

package/lib/GenerativeAIService.d.ts

@@ -1,40 +0,0 @@
-/*! Copyright (c) 2026, XAPP AI */
-import type { ExternalLead } from "stentor-models";
-import type { AnalyzeLeadOptions, AnalyzeWebsiteData, IGenerativeAIService, LeadAnalysis, LLMService, LLMServiceResponse, Prompt } from "./models";
-import type { EmailAnalysisInput, EmailLeadAnalysis } from "./models/EmailAnalysis";
-import type { ChatSummary } from "./models/ChatSummary";
-import { WebsiteAnalysis } from "./models/WebsiteAnalysis";
-export declare class GenerativeAIService implements IGenerativeAIService {
-    private readonly llmService;
-    constructor(llmService: LLMService);
-    /**
-     * Executes a custom prompt that the user is responsible for creating and parsing.
-     *
-     * @param prompt
-     */
-    customPrompt(prompt: Prompt): Promise<LLMServiceResponse>;
-    /**
-     * Can take in an external lead and help summarize and classify.
-     *
-     * @param lead
-     */
-    analyzeLead(lead: ExternalLead, options?: AnalyzeLeadOptions): Promise<LeadAnalysis>;
-    /**
-     * Analyze an inbound email (or email thread) to classify and extract lead information.
-     *
-     * Combines lead classification (contactType, serviceType, jobType, urgency) with
-     * structured contact extraction in a single LLM call. Handles direct customer emails,
-     * FSM/CRM lead notification emails, and multi-email threads.
-     *
-     * @param email - The email content and optional thread history to analyze.
-     * @param options - Optional business context and LLM call options.
-     */
-    analyzeEmail(email: EmailAnalysisInput, options?: AnalyzeLeadOptions): Promise<EmailLeadAnalysis>;
-    /**
-     * Summarize a chat transcript
-     * @param transcript
-     * @returns Returns the summarized chat of a lead transcript
-     */
-    summarizeChatFromTranscript(transcript: ExternalLead["transcript"]): Promise<ChatSummary>;
-    analyzeWebsite(markdown: string, data: AnalyzeWebsiteData): Promise<WebsiteAnalysis>;
-}