movie-agent 1.0.0 → 1.1.1

package/dist/format.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TMDB_IMAGE_BASE_URL = void 0;
 exports.buildDescription = buildDescription;
+exports.buildPosterUrl = buildPosterUrl;
 exports.toRecommendation = toRecommendation;
 exports.formatResponse = formatResponse;
 /**
@@ -40,9 +42,26 @@ function buildDescription(overview) {
     // If we can't find a good sentence boundary, add ellipsis
     return truncated + '...';
 }
+/**
+ * TMDb image base URL for constructing poster URLs
+ * @see https://developer.themoviedb.org/docs/image-basics
+ */
+exports.TMDB_IMAGE_BASE_URL = 'https://image.tmdb.org/t/p/';
+/**
+ * Builds a full poster URL from a TMDb poster_path
+ * @param posterPath - The poster_path from TMDb API (e.g., "/abc123.jpg")
+ * @param size - Image size (default: 'w500')
+ * @returns Full URL to the poster image, or null if no poster available
+ */
+function buildPosterUrl(posterPath, size = 'w500') {
+    if (!posterPath) {
+        return null;
+    }
+    return `${exports.TMDB_IMAGE_BASE_URL}${size}${posterPath}`;
+}
 /**
  * Formats a movie with streaming providers into a MovieRecommendation
- * @param movie - TMDb movie object with id, title, release_date, runtime, overview, genres
+ * @param movie - TMDb movie object with id, title, release_date, runtime, overview, genres, poster_path
  * @param providers - Streaming provider information
  * @param reason - Why this movie was recommended
  * @returns Formatted MovieRecommendation
@@ -51,6 +70,7 @@ function toRecommendation(movie, providers, reason) {
     const releaseYear = new Date(movie.release_date).getFullYear();
     const description = buildDescription(movie.overview);
     const genres = movie.genres.map(g => g.name);
+    const posterUrl = buildPosterUrl(movie.poster_path);
     return {
         title: movie.title,
         releaseYear,
@@ -59,6 +79,7 @@ function toRecommendation(movie, providers, reason) {
         genres,
         streamingPlatforms: providers,
         matchReason: reason,
+        posterUrl,
     };
 }
 /**

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";;AAYA,4CAuCC;AASD,4CAyBC;AAQD,wCAqBC;AA3GD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,kDAAkD;IAClD,6BAA6B;IAC7B,gDAAgD;IAChD,8BAA8B;IAE9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,QAAQ,GAAG,GAAG,CAAC;IAErB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAErD,6DAA6D;IAC7D,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IAE5E,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,kDAAkD;QAClD,MAAM,iBAAiB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAE1D,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YAC5B,OAAO,iBAAiB,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,OAAO,SAAS,GAAG,KAAK,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,KAOC,EACD,SAA8B,EAC9B,MAAc;IAEd,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW;QACX,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW;QACX,MAAM;QACN,kBAAkB,EAAE,SAAS;QAC7B,WAAW,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,eAAsC,EACtC,QAAqE;IAErE,8BAA8B;IAC9B,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,qCAAqC,eAAe,CAAC,MAAM,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,eAAe;QACf,QAAQ,EAAE;YACR,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC1C,YAAY,EAAE,eAAe,CAAC,MAAM;YACpC,eAAe,EAAE,QAAQ,CAAC,eAAe;SAC1C;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";;;AAYA,4CAuCC;AAcD,wCAQC;AASD,4CA4BC;AAQD,wCAqBC;AApID;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,kDAAkD;IAClD,6BAA6B;IAC7B,gDAAgD;IAChD,8BAA8B;IAE9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,QAAQ,GAAG,GAAG,CAAC;IAErB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAErD,6DAA6D;IAC7D,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IAE5E,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,kDAAkD;QAClD,MAAM,iBAAiB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAE1D,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YAC5B,OAAO,iBAAiB,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,OAAO,SAAS,GAAG,KAAK,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACU,QAAA,mBAAmB,GAAG,6BAA6B,CAAC;AAEjE;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,UAAqC,EACrC,OAAe,MAAM;IAErB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,2BAAmB,GAAG,IAAI,GAAG,UAAU,EAAE,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,KAQC,EACD,SAA8B,EAC9B,MAAc;IAEd,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW;QACX,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW;QACX,MAAM;QACN,kBAAkB,EAAE,SAAS;QAC7B,WAAW,EAAE,MAAM;QACnB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,eAAsC,EACtC,QAAqE;IAErE,8BAA8B;IAC9B,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,qCAAqC,eAAe,CAAC,MAAM,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAkB;QAC9B,eAAe;QACf,QAAQ,EAAE;YACR,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC1C,YAAY,EAAE,eAAe,CAAC,MAAM;YACpC,eAAe,EAAE,QAAQ,CAAC,eAAe;SAC1C;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -2,5 +2,7 @@ export { MovieAgent } from './agent';
 export { MovieAgentFactory, MovieAgentConfig } from './factory';
 export { UserInput, AgentResponse, MovieRecommendation, StreamingPlatform, ErrorResponse, } from './types';
 export { default as TmdbApiClient } from './tmdbApi';
+export { LLMService, getLLMService } from './llm';
+export { buildPosterUrl, TMDB_IMAGE_BASE_URL } from './format';
 export { MovieAgentFactory as default } from './factory';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,iBAAiB,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG/D,OAAO,EAAE,iBAAiB,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.TmdbApiClient = exports.MovieAgentFactory = exports.MovieAgent = void 0;
+exports.default = exports.TMDB_IMAGE_BASE_URL = exports.buildPosterUrl = exports.getLLMService = exports.LLMService = exports.TmdbApiClient = exports.MovieAgentFactory = exports.MovieAgent = void 0;
 // Export the main MovieAgent class
 var agent_1 = require("./agent");
 Object.defineProperty(exports, "MovieAgent", { enumerable: true, get: function () { return agent_1.MovieAgent; } });
@@ -14,6 +14,14 @@ Object.defineProperty(exports, "MovieAgentFactory", { enumerable: true, get: fun
 // Export TMDb API client for advanced use cases
 var tmdbApi_1 = require("./tmdbApi");
 Object.defineProperty(exports, "TmdbApiClient", { enumerable: true, get: function () { return __importDefault(tmdbApi_1).default; } });
+// Export LLM service for advanced use cases
+var llm_1 = require("./llm");
+Object.defineProperty(exports, "LLMService", { enumerable: true, get: function () { return llm_1.LLMService; } });
+Object.defineProperty(exports, "getLLMService", { enumerable: true, get: function () { return llm_1.getLLMService; } });
+// Export poster URL utilities
+var format_1 = require("./format");
+Object.defineProperty(exports, "buildPosterUrl", { enumerable: true, get: function () { return format_1.buildPosterUrl; } });
+Object.defineProperty(exports, "TMDB_IMAGE_BASE_URL", { enumerable: true, get: function () { return format_1.TMDB_IMAGE_BASE_URL; } });
 // Default export is the factory for convenience
 var factory_2 = require("./factory");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return factory_2.MovieAgentFactory; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8DAA8D;;;;;;AAE9D,mCAAmC;AACnC,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AAEnB,4CAA4C;AAC5C,qCAAgE;AAAvD,4GAAA,iBAAiB,OAAA;AAW1B,gDAAgD;AAChD,qCAAqD;AAA5C,yHAAA,OAAO,OAAiB;AAEjC,gDAAgD;AAChD,qCAAyD;AAAhD,kGAAA,iBAAiB,OAAW"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8DAA8D;;;;;;AAE9D,mCAAmC;AACnC,iCAAqC;AAA5B,mGAAA,UAAU,OAAA;AAEnB,4CAA4C;AAC5C,qCAAgE;AAAvD,4GAAA,iBAAiB,OAAA;AAW1B,gDAAgD;AAChD,qCAAqD;AAA5C,yHAAA,OAAO,OAAiB;AAEjC,4CAA4C;AAC5C,6BAAkD;AAAzC,iGAAA,UAAU,OAAA;AAAE,oGAAA,aAAa,OAAA;AAElC,8BAA8B;AAC9B,mCAA+D;AAAtD,wGAAA,cAAc,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAE5C,gDAAgD;AAChD,qCAAyD;AAAhD,kGAAA,iBAAiB,OAAW"}

package/dist/llm.d.ts

@@ -0,0 +1,33 @@
+import { AgentResponse } from './types';
+/**
+ * LLM service for generating formatted movie recommendation output
+ */
+export declare class LLMService {
+    private model;
+    private chain;
+    constructor(apiKey?: string, provider?: 'gemini' | 'azure', azureConfig?: {
+        endpoint?: string;
+        deployment?: string;
+    });
+    /**
+     * Format movie recommendations using LLM (non-streaming)
+     * @param response - Agent response with recommendations
+     * @param userInput - Original user input for context
+     * @returns Formatted markdown string
+     */
+    formatRecommendations(response: AgentResponse, userInput: any): Promise<string>;
+    /**
+     * Format movie recommendations using LLM with streaming
+     * @param response - Agent response with recommendations
+     * @param userInput - Original user input for context
+     * @param onChunk - Callback function called for each chunk of streamed content
+     * @returns Promise that resolves when streaming is complete
+     */
+    formatRecommendationsStream(response: AgentResponse, userInput: any, onChunk: (chunk: string) => void): Promise<void>;
+    /**
+     * Fallback formatting if LLM fails
+     */
+    private fallbackFormat;
+}
+export declare function getLLMService(provider?: 'gemini' | 'azure'): LLMService;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIxC;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,KAAK,CAAM;gBAGjB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,EAC7B,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAuEH;;;;;OAKG;IACG,qBAAqB,CACzB,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,GAAG,GACb,OAAO,CAAC,MAAM,CAAC;IA0DlB;;;;;;OAMG;IACG,2BAA2B,CAC/B,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,IAAI,CAAC;IAqEhB;;OAEG;IACH,OAAO,CAAC,cAAc;CAqBvB;AAOD,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAKvE"}

package/dist/llm.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMService = void 0;
+exports.getLLMService = getLLMService;
+// src/llm.ts
+const google_genai_1 = require("@langchain/google-genai");
+const openai_1 = require("@langchain/openai");
+const prompts_1 = require("@langchain/core/prompts");
+const output_parsers_1 = require("@langchain/core/output_parsers");
+const config_1 = __importDefault(require("./config"));
+const sanitize_1 = require("./sanitize");
+/**
+ * LLM service for generating formatted movie recommendation output
+ */
+class LLMService {
+    constructor(apiKey, provider, azureConfig) {
+        const llmProvider = provider || config_1.default.LLM_PROVIDER;
+        if (llmProvider === 'azure') {
+            // Azure OpenAI Configuration
+            const azureApiKey = apiKey || config_1.default.AZURE_OPENAI_API_KEY;
+            const azureEndpoint = azureConfig?.endpoint || config_1.default.AZURE_OPENAI_ENDPOINT;
+            const azureDeployment = azureConfig?.deployment || config_1.default.AZURE_OPENAI_DEPLOYMENT;
+            if (!azureApiKey || !azureEndpoint || !azureDeployment) {
+                throw new Error('AZURE_OPENAI_API_KEY, AZURE_OPENAI_ENDPOINT, and AZURE_OPENAI_DEPLOYMENT are required for Azure OpenAI');
+            }
+            this.model = new openai_1.AzureChatOpenAI({
+                azureOpenAIApiKey: azureApiKey,
+                azureOpenAIApiInstanceName: azureEndpoint
+                    .replace(/^https?:\/\//, '')
+                    .replace(/\.openai\.azure\.com\/?$/, ''),
+                azureOpenAIApiDeploymentName: azureDeployment,
+                azureOpenAIApiVersion: '2024-08-01-preview',
+                temperature: 0.7,
+            });
+        }
+        else {
+            // Gemini Configuration (default)
+            const geminiApiKey = apiKey || config_1.default.GEMINI_API_KEY;
+            if (!geminiApiKey) {
+                throw new Error('GEMINI_API_KEY is required for LLM service');
+            }
+            this.model = new google_genai_1.ChatGoogleGenerativeAI({
+                apiKey: geminiApiKey,
+                model: 'gemini-2.5-flash',
+                temperature: 0.7,
+            });
+        }
+        // Create the prompt template
+        const promptTemplate = prompts_1.PromptTemplate.fromTemplate(`
+You are a friendly movie recommendation assistant. Format the following movie recommendations in an engaging, readable way.
+
+User Input: {userInput}
+
+Movie Recommendations:
+{recommendations}
+
+Instructions:
+- Create a warm, conversational introduction
+- For each movie, include:
+  * Title, year, and runtime
+  * Genres
+  * A compelling description
+  * Available streaming platforms with emoji 📺
+  * A brief explanation of why it matches the user's preferences (✨ Why:)
+- Use markdown formatting (bold, lists, etc.)
+- Add visual separators between movies
+- Keep it concise but engaging
+- Use emojis to make it more visually appealing
+
+Generate the formatted output:
+`);
+        // Create the chain: prompt -> model -> output parser
+        this.chain = promptTemplate.pipe(this.model).pipe(new output_parsers_1.StringOutputParser());
+    }
+    /**
+     * Format movie recommendations using LLM (non-streaming)
+     * @param response - Agent response with recommendations
+     * @param userInput - Original user input for context
+     * @returns Formatted markdown string
+     */
+    async formatRecommendations(response, userInput) {
+        // Prepare the recommendations data
+        const recommendationsText = response.recommendations
+            .map((movie, index) => {
+            const platforms = movie.streamingPlatforms
+                .filter(p => p.available)
+                .map(p => p.name)
+                .join(', ');
+            return `
+${index + 1}. ${movie.title} (${movie.releaseYear})
+   - Runtime: ${movie.runtime} minutes
+   - Genres: ${movie.genres.join(', ')}
+   - Description: ${movie.description}
+   - Available on: ${platforms || 'No streaming availability'}
+   - Match reason: ${movie.matchReason}
+`;
+        })
+            .join('\n');
+        // Sanitize and format user input to prevent prompt injection
+        const sanitizedInput = (0, sanitize_1.sanitizeForLLMPrompt)(userInput);
+        // Log potential injection attempts for security monitoring
+        if ((0, sanitize_1.detectPromptInjection)(userInput)) {
+            console.warn('⚠️ Potential prompt injection detected in user input. Input has been sanitized.');
+        }
+        const userInputText = JSON.stringify(sanitizedInput, null, 2);
+        // Generate formatted output using LLM with timeout
+        try {
+            const timeoutMs = 15000; // 15 second timeout
+            const startTime = Date.now();
+            const formattedOutput = await Promise.race([
+                this.chain.invoke({
+                    userInput: userInputText,
+                    recommendations: recommendationsText,
+                }),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('LLM request timeout')), timeoutMs)),
+            ]);
+            const elapsedTime = ((Date.now() - startTime) / 1000).toFixed(2);
+            console.log(`✓ LLM formatting completed in ${elapsedTime}s\n`);
+            return formattedOutput;
+        }
+        catch (error) {
+            console.error('LLM formatting error:', error);
+            // Fallback to basic formatting if LLM fails
+            return this.fallbackFormat(response);
+        }
+    }
+    /**
+     * Format movie recommendations using LLM with streaming
+     * @param response - Agent response with recommendations
+     * @param userInput - Original user input for context
+     * @param onChunk - Callback function called for each chunk of streamed content
+     * @returns Promise that resolves when streaming is complete
+     */
+    async formatRecommendationsStream(response, userInput, onChunk) {
+        // Prepare the recommendations data
+        const recommendationsText = response.recommendations
+            .map((movie, index) => {
+            const platforms = movie.streamingPlatforms
+                .filter(p => p.available)
+                .map(p => p.name)
+                .join(', ');
+            return `
+${index + 1}. ${movie.title} (${movie.releaseYear})
+   - Runtime: ${movie.runtime} minutes
+   - Genres: ${movie.genres.join(', ')}
+   - Description: ${movie.description}
+   - Available on: ${platforms || 'No streaming availability'}
+   - Match reason: ${movie.matchReason}
+`;
+        })
+            .join('\n');
+        // Sanitize and format user input to prevent prompt injection
+        const sanitizedInput = (0, sanitize_1.sanitizeForLLMPrompt)(userInput);
+        // Log potential injection attempts for security monitoring
+        if ((0, sanitize_1.detectPromptInjection)(userInput)) {
+            console.warn('⚠️ Potential prompt injection detected in user input. Input has been sanitized.');
+        }
+        const userInputText = JSON.stringify(sanitizedInput, null, 2);
+        try {
+            const timeoutMs = 15000; // 15 second timeout
+            const startTime = Date.now();
+            // Create a promise that will handle the streaming
+            const streamPromise = (async () => {
+                const stream = await this.chain.stream({
+                    userInput: userInputText,
+                    recommendations: recommendationsText,
+                });
+                for await (const chunk of stream) {
+                    onChunk(chunk);
+                }
+            })();
+            // Race between streaming and timeout
+            await Promise.race([
+                streamPromise,
+                new Promise((_, reject) => setTimeout(() => reject(new Error('LLM streaming timeout')), timeoutMs)),
+            ]);
+            const elapsedTime = ((Date.now() - startTime) / 1000).toFixed(2);
+            console.log(`\n✓ LLM streaming completed in ${elapsedTime}s\n`);
+        }
+        catch (error) {
+            console.error('\nLLM streaming error:', error);
+            // Fallback to basic formatting if LLM fails
+            const fallback = this.fallbackFormat(response);
+            onChunk(fallback);
+        }
+    }
+    /**
+     * Fallback formatting if LLM fails
+     */
+    fallbackFormat(response) {
+        let output = '\n🎬 Movie Recommendations\n\n';
+        response.recommendations.forEach((movie, index) => {
+            output += `${index + 1}. **${movie.title}** (${movie.releaseYear}) • ${movie.runtime} min\n`;
+            output += `   Genres: ${movie.genres.join(', ')}\n\n`;
+            output += `   ${movie.description}\n\n`;
+            const platforms = movie.streamingPlatforms
+                .filter(p => p.available)
+                .map(p => p.name);
+            if (platforms.length > 0) {
+                output += `   📺 Available on: ${platforms.join(', ')}\n`;
+            }
+            output += `   ✨ Why: ${movie.matchReason}\n\n`;
+        });
+        return output;
+    }
+}
+exports.LLMService = LLMService;
+/**
+ * Create and export a singleton instance
+ */
+let llmServiceInstance = null;
+function getLLMService(provider) {
+    if (!llmServiceInstance) {
+        llmServiceInstance = new LLMService(undefined, provider);
+    }
+    return llmServiceInstance;
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

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

package/dist/providers.d.ts

@@ -1,4 +1,12 @@
-import TmdbApiClient from './tmdbApi';
+import TmdbApiClient, { WatchProvidersResponse } from './tmdbApi';
+/**
+ * Extracts and normalizes platform names from a WatchProvidersResponse.
+ * This is used when watch providers are fetched via append_to_response.
+ * @param providersData WatchProvidersResponse data (can be from append_to_response)
+ * @param region Region code (default: "CA")
+ * @returns Array of normalized platform names
+ */
+export declare function extractPlatformsFromProviders(providersData: WatchProvidersResponse | undefined, region?: string): string[];
 /**
  * Fetch and normalize Canadian watch providers for a movie.
  * @param movieId TMDb movie ID

package/dist/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,MAAM,WAAW,CAAC;AAmBtC;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,SAAO,EACb,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwCnB"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AACA,OAAO,aAAa,EAAE,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAmBlE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,sBAAsB,GAAG,SAAS,EACjD,MAAM,SAAO,GACZ,MAAM,EAAE,CAoBV;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,SAAO,EACb,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwCnB"}

package/dist/providers.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPlatformsFromProviders = extractPlatformsFromProviders;
 exports.getCanadianProviders = getCanadianProviders;
 // src/providers.ts
 const tmdbApi_1 = __importDefault(require("./tmdbApi"));
@@ -22,6 +23,32 @@ const PLATFORM_MAP = {
     fuboTV: 'fuboTV',
     // Add more mappings as needed
 };
+/**
+ * Extracts and normalizes platform names from a WatchProvidersResponse.
+ * This is used when watch providers are fetched via append_to_response.
+ * @param providersData WatchProvidersResponse data (can be from append_to_response)
+ * @param region Region code (default: "CA")
+ * @returns Array of normalized platform names
+ */
+function extractPlatformsFromProviders(providersData, region = 'CA') {
+    if (!providersData ||
+        !providersData.results ||
+        !providersData.results[region]) {
+        return [];
+    }
+    const regionData = providersData.results[region];
+    // Only consider 'flatrate' (subscription) providers
+    const flatrate = regionData.flatrate || [];
+    if (!Array.isArray(flatrate) || flatrate.length === 0) {
+        return [];
+    }
+    // Map provider names to allowed platforms
+    const platforms = flatrate
+        .map((p) => PLATFORM_MAP[p.provider_name])
+        .filter(Boolean);
+    // Remove duplicates
+    return Array.from(new Set(platforms));
+}
 /**
  * Fetch and normalize Canadian watch providers for a movie.
  * @param movieId TMDb movie ID

package/dist/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":";;;;;AA2BA,oDA4CC;AAvED,mBAAmB;AACnB,wDAAsC;AACtC,mCAA8D;AAC9D,sDAA8B;AAE9B,iDAAiD;AACjD,MAAM,YAAY,GAA2B;IAC3C,OAAO,EAAE,SAAS;IAClB,oBAAoB,EAAE,aAAa;IACnC,aAAa,EAAE,SAAS;IACxB,KAAK,EAAE,OAAO;IACd,eAAe,EAAE,WAAW;IAC5B,gBAAgB,EAAE,YAAY;IAC9B,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,8BAA8B;CAC/B,CAAC;AAEF;;;;;;GAMG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAwB,EACxB,MAAM,GAAG,IAAI,EACb,MAAsB;IAEtB,IAAI,CAAC;QACH,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAA,gBAAQ,EAAC,gBAAM,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAA,iCAAyB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAW,QAAQ,CAAC,CAAC;QAEnD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,8BAA8B;QAC9B,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,iBAAa,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,iDAAiD;YACjD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,oDAAoD;QACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,0CAA0C;QAC1C,MAAM,SAAS,GAAG,QAAQ;aACvB,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;aAC9C,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,oBAAoB;QACpB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAE9C,iBAAiB;QACjB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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"}

package/dist/rateLimiter.d.ts

@@ -0,0 +1,59 @@
+import pLimit from 'p-limit';
+/**
+ * Configuration for rate limiting
+ */
+export interface RateLimiterConfig {
+    /** Maximum concurrent requests (default: 10) */
+    concurrency: number;
+    /** Maximum retry attempts for rate limit errors (default: 3) */
+    maxRetries: number;
+    /** Base delay in milliseconds for exponential backoff (default: 1000) */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds for exponential backoff (default: 30000) */
+    maxDelayMs: number;
+}
+/**
+ * Default rate limiter configuration
+ * TMDb allows 40 requests per 10 seconds, so we limit to 10 concurrent requests
+ * to stay well under the limit
+ */
+export declare const DEFAULT_RATE_LIMITER_CONFIG: RateLimiterConfig;
+/**
+ * Rate limiter instance type
+ */
+export type RateLimiter = ReturnType<typeof pLimit>;
+/**
+ * Creates a rate limiter with the specified concurrency
+ * @param concurrency - Maximum number of concurrent operations
+ * @returns A rate limiter function
+ */
+export declare function createRateLimiter(concurrency?: number): RateLimiter;
+/**
+ * Calculates exponential backoff delay with jitter
+ * @param attempt - Current retry attempt (0-based)
+ * @param baseDelayMs - Base delay in milliseconds
+ * @param maxDelayMs - Maximum delay cap in milliseconds
+ * @returns Delay in milliseconds
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelayMs?: number, maxDelayMs?: number): number;
+/**
+ * Delays execution for the specified duration
+ * @param ms - Delay in milliseconds
+ * @returns Promise that resolves after the delay
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Checks if an error is a rate limit error (HTTP 429)
+ * @param error - The error to check
+ * @returns True if the error is a rate limit error
+ */
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Executes an async function with exponential backoff retry on rate limit errors
+ * @param fn - The async function to execute
+ * @param config - Rate limiter configuration
+ * @returns Promise resolving to the function result
+ * @throws The last error if all retries are exhausted
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RateLimiterConfig>): Promise<T>;
+//# sourceMappingURL=rateLimiter.d.ts.map

package/dist/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../src/rateLimiter.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,SAAS,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAKzC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,GAAE,MAAgD,GAC5D,WAAW,CAEb;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAgD,EAC7D,UAAU,GAAE,MAA+C,GAC1D,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOxD;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACtC,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/dist/rateLimiter.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RATE_LIMITER_CONFIG = void 0;
+exports.createRateLimiter = createRateLimiter;
+exports.calculateBackoffDelay = calculateBackoffDelay;
+exports.delay = delay;
+exports.isRateLimitError = isRateLimitError;
+exports.withRetry = withRetry;
+// src/rateLimiter.ts
+const p_limit_1 = __importDefault(require("p-limit"));
+/**
+ * Default rate limiter configuration
+ * TMDb allows 40 requests per 10 seconds, so we limit to 10 concurrent requests
+ * to stay well under the limit
+ */
+exports.DEFAULT_RATE_LIMITER_CONFIG = {
+    concurrency: 10,
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+};
+/**
+ * Creates a rate limiter with the specified concurrency
+ * @param concurrency - Maximum number of concurrent operations
+ * @returns A rate limiter function
+ */
+function createRateLimiter(concurrency = exports.DEFAULT_RATE_LIMITER_CONFIG.concurrency) {
+    return (0, p_limit_1.default)(concurrency);
+}
+/**
+ * Calculates exponential backoff delay with jitter
+ * @param attempt - Current retry attempt (0-based)
+ * @param baseDelayMs - Base delay in milliseconds
+ * @param maxDelayMs - Maximum delay cap in milliseconds
+ * @returns Delay in milliseconds
+ */
+function calculateBackoffDelay(attempt, baseDelayMs = exports.DEFAULT_RATE_LIMITER_CONFIG.baseDelayMs, maxDelayMs = exports.DEFAULT_RATE_LIMITER_CONFIG.maxDelayMs) {
+    // Exponential backoff: baseDelay * 2^attempt
+    const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+    // Add jitter (0-25% of the delay) to avoid thundering herd
+    const jitter = exponentialDelay * Math.random() * 0.25;
+    // Cap at maxDelayMs
+    return Math.min(exponentialDelay + jitter, maxDelayMs);
+}
+/**
+ * Delays execution for the specified duration
+ * @param ms - Delay in milliseconds
+ * @returns Promise that resolves after the delay
+ */
+function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Checks if an error is a rate limit error (HTTP 429)
+ * @param error - The error to check
+ * @returns True if the error is a rate limit error
+ */
+function isRateLimitError(error) {
+    if (error instanceof Error) {
+        return (error.message.includes('429') || error.message.includes('rate limit'));
+    }
+    return false;
+}
+/**
+ * Executes an async function with exponential backoff retry on rate limit errors
+ * @param fn - The async function to execute
+ * @param config - Rate limiter configuration
+ * @returns Promise resolving to the function result
+ * @throws The last error if all retries are exhausted
+ */
+async function withRetry(fn, config = {}) {
+    const { maxRetries, baseDelayMs, maxDelayMs } = {
+        ...exports.DEFAULT_RATE_LIMITER_CONFIG,
+        ...config,
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Only retry on rate limit errors
+            if (!isRateLimitError(error)) {
+                throw error;
+            }
+            // Don't delay after the last attempt
+            if (attempt < maxRetries) {
+                const delayMs = calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs);
+                await delay(delayMs);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=rateLimiter.js.map

package/dist/rateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../src/rateLimiter.ts"],"names":[],"mappings":";;;;;;AAuCA,8CAIC;AASD,sDAWC;AAOD,sBAEC;AAOD,4CAOC;AASD,8BA+BC;AA9HD,qBAAqB;AACrB,sDAA6B;AAgB7B;;;;GAIG;AACU,QAAA,2BAA2B,GAAsB;IAC5D,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK;CAClB,CAAC;AAOF;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,cAAsB,mCAA2B,CAAC,WAAW;IAE7D,OAAO,IAAA,iBAAM,EAAC,WAAW,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,OAAe,EACf,cAAsB,mCAA2B,CAAC,WAAW,EAC7D,aAAqB,mCAA2B,CAAC,UAAU;IAE3D,6CAA6C;IAC7C,MAAM,gBAAgB,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,2DAA2D;IAC3D,MAAM,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IACvD,oBAAoB;IACpB,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,SAAqC,EAAE;IAEvC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG;QAC9C,GAAG,mCAA2B;QAC9B,GAAG,MAAM;KACV,CAAC;IAEF,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAElB,kCAAkC;YAClC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,qCAAqC;YACrC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;gBACxE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/sanitize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Sanitizes user input to prevent prompt injection attacks
+ * This is specifically for content that will be passed to LLM prompts
+ *
+ * @param input - Raw user input object
+ * @returns Sanitized version safe for LLM prompts
+ */
+export declare function sanitizeForLLMPrompt(input: any): any;
+/**
+ * Sanitizes a string to remove potential prompt injection attacks
+ *
+ * @param str - Input string to sanitize
+ * @returns Sanitized string
+ */
+export declare function sanitizeString(str: string): string;
+/**
+ * Detects if input contains potential prompt injection attempts
+ * This is for logging/monitoring purposes
+ *
+ * @param input - Input to check
+ * @returns True if potential injection detected
+ */
+export declare function detectPromptInjection(input: any): boolean;
+//# sourceMappingURL=sanitize.d.ts.map