movie-agent 1.0.0

package/dist/agent.d.ts

@@ -0,0 +1,89 @@
+import { UserInput, AgentResponse, ErrorResponse } from './types';
+import TmdbApiClient from './tmdbApi';
+/**
+ * MovieAgent orchestrates the full recommendation pipeline
+ */
+export declare class MovieAgent {
+    private tmdbClient;
+    private logger;
+    /**
+     * Creates a new MovieAgent instance
+     * @param tmdbClient - Optional TMDb API client for testing
+     * @param logger - Optional logger function for debugging
+     */
+    constructor(tmdbClient?: TmdbApiClient, logger?: (message: string) => void);
+    /**
+     * Gets movie recommendations based on user input
+     * @param input - User input with mood, platforms, genres, runtime, and year preferences
+     * @returns Promise resolving to structured agent response with 3-5 recommendations or error response
+     */
+    getRecommendations(input: UserInput): Promise<AgentResponse | ErrorResponse>;
+    /**
+     * Creates a structured error response
+     * @param errorType - The type of error
+     * @param message - Human-readable error message
+     * @param details - Optional details for debugging
+     * @returns ErrorResponse object
+     */
+    private createErrorResponse;
+    /**
+     * Handles errors and converts them to structured error responses
+     * @param error - The error to handle
+     * @returns ErrorResponse object
+     */
+    private handleError;
+    /**
+     * Validates user input
+     * @param input - User input to validate
+     * @throws Error if validation fails
+     */
+    private validateInput;
+    /**
+     * Resolves genres from mood or explicit genre input
+     * @param input - User input
+     * @returns Array of genre names
+     */
+    private resolveGenres;
+    /**
+     * Discovers candidate movies from TMDb
+     * @param input - User input
+     * @param genres - Resolved genres
+     * @returns Array of movie summaries
+     */
+    private discoverCandidates;
+    /**
+     * Fetches watch providers for each candidate movie
+     * @param candidates - Array of movie details
+     * @returns Array of movies with platform information
+     */
+    private fetchWatchProviders;
+    /**
+     * Applies user-specified filters to movies
+     * @param movies - Movies with provider information
+     * @param input - User input
+     * @returns Filtered movies
+     */
+    private applyFilters;
+    /**
+     * Ranks movies and selects top 3-5
+     * @param movies - Filtered movies
+     * @param input - User input
+     * @returns Top 3-5 movies
+     */
+    private rankAndSelect;
+    /**
+     * Formats movies into recommendations
+     * @param movies - Selected movies
+     * @param input - User input
+     * @returns Array of formatted recommendations
+     */
+    private formatRecommendations;
+    /**
+     * Generates a match reason for a movie
+     * @param movie - Movie to explain
+     * @param input - User input
+     * @returns Match reason string
+     */
+    private generateMatchReason;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,aAAa,EAGb,aAAa,EACd,MAAM,SAAS,CAAC;AASjB,OAAO,aAA+B,MAAM,WAAW,CAAC;AAaxD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;;OAIG;gBACS,UAAU,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAM1E;;;;OAIG;IACG,kBAAkB,CACtB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;IAgEzC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAmEnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAqBrB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAerB;;;;;OAKG;YACW,kBAAkB;IA0ChC;;;;OAIG;YACW,mBAAmB;IAgCjC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAoCrB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;CAuC5B"}

package/dist/agent.js

@@ -0,0 +1,365 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MovieAgent = void 0;
+const validate_1 = require("./validate");
+const mood_1 = require("./mood");
+const discover_1 = require("./discover");
+const tmdbApi_1 = __importDefault(require("./tmdbApi"));
+const providers_1 = require("./providers");
+const filters_1 = require("./filters");
+const ranking_1 = require("./ranking");
+const format_1 = require("./format");
+/**
+ * MovieAgent orchestrates the full recommendation pipeline
+ */
+class MovieAgent {
+    /**
+     * Creates a new MovieAgent instance
+     * @param tmdbClient - Optional TMDb API client for testing
+     * @param logger - Optional logger function for debugging
+     */
+    constructor(tmdbClient, logger) {
+        this.tmdbClient = tmdbClient ?? new tmdbApi_1.default();
+        this.logger =
+            logger ?? ((message) => console.log(`[MovieAgent] ${message}`));
+    }
+    /**
+     * Gets movie recommendations based on user input
+     * @param input - User input with mood, platforms, genres, runtime, and year preferences
+     * @returns Promise resolving to structured agent response with 3-5 recommendations or error response
+     */
+    async getRecommendations(input) {
+        try {
+            this.logger('Starting recommendation pipeline');
+            // Step 1: Validate input
+            this.logger('Step 1: Validating input');
+            this.validateInput(input);
+            // Step 2: Resolve genres from mood or explicit input
+            this.logger('Step 2: Resolving genres');
+            const genres = this.resolveGenres(input);
+            this.logger(`Resolved genres: ${genres.join(', ')}`);
+            // Step 3: Discover candidate movies via TMDb
+            this.logger('Step 3: Discovering candidate movies');
+            const candidates = await this.discoverCandidates(input, genres);
+            this.logger(`Found ${candidates.length} candidate movies`);
+            if (candidates.length === 0) {
+                return this.createErrorResponse('NO_RESULTS', 'No movies found matching the criteria');
+            }
+            // Step 4: Fetch watch providers for each candidate (region CA)
+            this.logger('Step 4: Fetching watch providers');
+            const moviesWithProviders = await this.fetchWatchProviders(candidates);
+            this.logger(`Fetched providers for ${moviesWithProviders.length} movies`);
+            // Step 5: Apply filters (platforms, runtime, year)
+            this.logger('Step 5: Applying filters');
+            const filtered = this.applyFilters(moviesWithProviders, input);
+            this.logger(`${filtered.length} movies passed filters`);
+            if (filtered.length === 0) {
+                return this.createErrorResponse('NO_RESULTS', 'No movies match the specified filters (platforms, runtime, year)');
+            }
+            // Step 6: Rank and select top 3-5 movies
+            this.logger('Step 6: Ranking and selecting top movies');
+            const topMovies = this.rankAndSelect(filtered, input);
+            this.logger(`Selected ${topMovies.length} top movies`);
+            // Step 7: Format structured output with metadata
+            this.logger('Step 7: Formatting output');
+            const recommendations = this.formatRecommendations(topMovies, input);
+            const response = (0, format_1.formatResponse)(recommendations, {
+                inputParameters: input,
+            });
+            this.logger('Pipeline completed successfully');
+            return response;
+        }
+        catch (error) {
+            this.logger(`Error in recommendation pipeline: ${error instanceof Error ? error.message : String(error)}`);
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Creates a structured error response
+     * @param errorType - The type of error
+     * @param message - Human-readable error message
+     * @param details - Optional details for debugging
+     * @returns ErrorResponse object
+     */
+    createErrorResponse(errorType, message, details) {
+        return {
+            error: true,
+            errorType,
+            message,
+            timestamp: new Date().toISOString(),
+            details,
+        };
+    }
+    /**
+     * Handles errors and converts them to structured error responses
+     * @param error - The error to handle
+     * @returns ErrorResponse object
+     */
+    handleError(error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Check for invalid API key errors
+        if (errorMessage.includes('401') ||
+            errorMessage.includes('Invalid API key') ||
+            errorMessage.includes('authentication')) {
+            return this.createErrorResponse('INVALID_API_KEY', 'Invalid or missing TMDB API key', errorMessage);
+        }
+        // Check for rate limit errors
+        if (errorMessage.includes('429') ||
+            errorMessage.includes('rate limit') ||
+            errorMessage.includes('Too Many Requests')) {
+            return this.createErrorResponse('RATE_LIMIT_EXCEEDED', 'TMDB API rate limit exceeded. Please try again later.', errorMessage);
+        }
+        // Check for MCP/network errors
+        if (errorMessage.includes('Network error') ||
+            errorMessage.includes('ECONNREFUSED') ||
+            errorMessage.includes('ENOTFOUND') ||
+            errorMessage.includes('timeout')) {
+            return this.createErrorResponse('MCP_UNAVAILABLE', 'Unable to connect to TMDB API service', errorMessage);
+        }
+        // Check for validation errors - be more comprehensive
+        if (errorMessage.includes('Invalid') ||
+            errorMessage.includes('must be') ||
+            errorMessage.includes('cannot be greater than') ||
+            errorMessage.includes('Year range invalid') ||
+            errorMessage.includes('runtime') ||
+            errorMessage.includes('year')) {
+            return this.createErrorResponse('VALIDATION_ERROR', errorMessage, errorMessage);
+        }
+        // Default to unknown error
+        return this.createErrorResponse('UNKNOWN_ERROR', 'An unexpected error occurred while processing your request', errorMessage);
+    }
+    /**
+     * Validates user input
+     * @param input - User input to validate
+     * @throws Error if validation fails
+     */
+    validateInput(input) {
+        // Validate platforms if provided
+        if (input.platforms && input.platforms.length > 0) {
+            (0, validate_1.validatePlatforms)(input.platforms);
+        }
+        // Validate runtime constraints if provided
+        if (input.runtime) {
+            (0, validate_1.validateRuntime)(input.runtime);
+        }
+        // Validate release year if provided
+        if (input.releaseYear !== undefined) {
+            if (typeof input.releaseYear === 'number') {
+                (0, validate_1.validateYear)(input.releaseYear);
+            }
+            else {
+                (0, validate_1.validateYearRange)(input.releaseYear);
+            }
+        }
+    }
+    /**
+     * Resolves genres from mood or explicit genre input
+     * @param input - User input
+     * @returns Array of genre names
+     */
+    resolveGenres(input) {
+        // Prioritize explicit genres
+        if (input.genre) {
+            return Array.isArray(input.genre) ? input.genre : [input.genre];
+        }
+        // Fall back to mood-based genres
+        if (input.mood) {
+            return (0, mood_1.moodToGenres)(input.mood);
+        }
+        // No genre preference
+        return [];
+    }
+    /**
+     * Discovers candidate movies from TMDb
+     * @param input - User input
+     * @param genres - Resolved genres
+     * @returns Array of movie summaries
+     */
+    async discoverCandidates(input, genres) {
+        // Build discover input
+        const discoverInput = {
+            genres: genres.length > 0 ? genres : undefined,
+            mood: input.mood,
+        };
+        // Add year constraints if provided
+        if (input.releaseYear !== undefined) {
+            if (typeof input.releaseYear === 'number') {
+                discoverInput.year = input.releaseYear;
+            }
+            else {
+                discoverInput.yearMin = input.releaseYear.from;
+                discoverInput.yearMax = input.releaseYear.to;
+            }
+        }
+        // Add runtime constraints if provided
+        if (input.runtime) {
+            discoverInput.runtimeMin = input.runtime.min;
+            discoverInput.runtimeMax = input.runtime.max;
+        }
+        // Discover movies
+        const response = await (0, discover_1.discoverMovies)(discoverInput, this.tmdbClient);
+        // Fetch detailed information for top candidates
+        // Limit to top 20 to avoid excessive API calls
+        const topCandidates = response.results.slice(0, 20);
+        // Fetch details for each movie
+        const detailsPromises = topCandidates.map(movie => this.tmdbClient.getMovieDetails(movie.id));
+        const details = await Promise.all(detailsPromises);
+        return details;
+    }
+    /**
+     * Fetches watch providers for each candidate movie
+     * @param candidates - Array of movie details
+     * @returns Array of movies with platform information
+     */
+    async fetchWatchProviders(candidates) {
+        const moviesWithProviders = [];
+        // Fetch providers for each movie
+        for (const movie of candidates) {
+            try {
+                const platforms = await (0, providers_1.getCanadianProviders)(movie.id, 'CA', this.tmdbClient);
+                // Only include movies with at least one provider
+                if (platforms.length > 0) {
+                    moviesWithProviders.push({
+                        ...movie,
+                        platforms,
+                    });
+                }
+            }
+            catch (error) {
+                // Log error but continue with other movies
+                this.logger(`Failed to fetch providers for movie ${movie.id}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return moviesWithProviders;
+    }
+    /**
+     * Applies user-specified filters to movies
+     * @param movies - Movies with provider information
+     * @param input - User input
+     * @returns Filtered movies
+     */
+    applyFilters(movies, input) {
+        const filterOptions = {};
+        // Add platform filter if specified
+        if (input.platforms && input.platforms.length > 0) {
+            filterOptions.platforms = input.platforms;
+        }
+        // Add runtime filter if specified
+        if (input.runtime) {
+            filterOptions.runtime = input.runtime;
+        }
+        // Add year filter if specified
+        if (input.releaseYear !== undefined) {
+            if (typeof input.releaseYear === 'number') {
+                filterOptions.year = input.releaseYear;
+            }
+            else {
+                filterOptions.year = {
+                    from: input.releaseYear.from,
+                    to: input.releaseYear.to,
+                };
+            }
+        }
+        return (0, filters_1.applyFilters)(movies, filterOptions);
+    }
+    /**
+     * Ranks movies and selects top 3-5
+     * @param movies - Filtered movies
+     * @param input - User input
+     * @returns Top 3-5 movies
+     */
+    rankAndSelect(movies, input) {
+        // Build ranking input
+        const rankingInput = {
+            mood: input.mood,
+            genres: input.genre
+                ? Array.isArray(input.genre)
+                    ? input.genre
+                    : [input.genre]
+                : undefined,
+            platforms: input.platforms,
+            runtime: input.runtime,
+        };
+        // Add year preferences for ranking
+        if (input.releaseYear !== undefined) {
+            if (typeof input.releaseYear === 'number') {
+                rankingInput.year = { preferred: input.releaseYear };
+            }
+            else {
+                rankingInput.year = {
+                    from: input.releaseYear.from,
+                    to: input.releaseYear.to,
+                };
+            }
+        }
+        // Rank movies
+        const ranked = (0, ranking_1.rankMovies)(movies, rankingInput);
+        // Select top 3-5 movies
+        const count = Math.min(5, Math.max(3, ranked.length));
+        return ranked.slice(0, count);
+    }
+    /**
+     * Formats movies into recommendations
+     * @param movies - Selected movies
+     * @param input - User input
+     * @returns Array of formatted recommendations
+     */
+    formatRecommendations(movies, input) {
+        return movies.map(movie => {
+            // Build streaming platform information
+            const streamingPlatforms = movie.platforms.map(name => ({
+                name,
+                type: 'subscription',
+                available: true,
+            }));
+            // Generate match reason based on input
+            const reason = this.generateMatchReason(movie, input);
+            // Format as recommendation
+            return (0, format_1.toRecommendation)({
+                id: movie.id,
+                title: movie.title,
+                release_date: movie.release_date || '',
+                runtime: movie.runtime || 0,
+                overview: movie.overview || '',
+                genres: movie.genres || [],
+            }, streamingPlatforms, reason);
+        });
+    }
+    /**
+     * Generates a match reason for a movie
+     * @param movie - Movie to explain
+     * @param input - User input
+     * @returns Match reason string
+     */
+    generateMatchReason(movie, input) {
+        const reasons = [];
+        // Genre match
+        const movieGenres = movie.genres?.map(g => g.name) || [];
+        const userGenres = this.resolveGenres(input);
+        const matchedGenres = movieGenres.filter(g => userGenres.includes(g));
+        if (matchedGenres.length > 0) {
+            reasons.push(`matches your ${input.mood ? `${input.mood} mood` : 'genre preferences'} (${matchedGenres.join(', ')})`);
+        }
+        // Platform availability
+        if (input.platforms && input.platforms.length > 0) {
+            const matchedPlatforms = movie.platforms.filter(p => input.platforms.includes(p));
+            if (matchedPlatforms.length > 0) {
+                reasons.push(`available on ${matchedPlatforms.join(', ')}`);
+            }
+        }
+        // Popularity
+        if (movie.popularity && movie.popularity > 50) {
+            reasons.push('highly rated');
+        }
+        // Default reason if none match
+        if (reasons.length === 0) {
+            reasons.push('recommended based on your preferences');
+        }
+        return reasons.join(', ');
+    }
+}
+exports.MovieAgent = MovieAgent;
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Simple in-memory cache with TTL support
+ */
+export declare class Cache {
+    private store;
+    private defaultTtl;
+    /**
+     * Creates a new cache instance
+     * @param defaultTtl Default time-to-live in seconds
+     */
+    constructor(defaultTtl?: number);
+    /**
+     * Sets a value in the cache
+     * @param key Cache key
+     * @param value Value to cache
+     * @param ttl Time-to-live in seconds (optional, uses default if not provided)
+     */
+    set<T>(key: string, value: T, ttl?: number): void;
+    /**
+     * Gets a value from the cache
+     * @param key Cache key
+     * @returns Cached value or undefined if not found or expired
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Checks if a key exists and is not expired
+     * @param key Cache key
+     * @returns true if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Deletes a key from the cache
+     * @param key Cache key
+     * @returns true if key existed and was deleted
+     */
+    delete(key: string): boolean;
+    /**
+     * Clears all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Gets the number of entries in the cache (including expired ones)
+     * @returns Number of entries
+     */
+    size(): number;
+    /**
+     * Removes all expired entries from the cache
+     * @returns Number of entries removed
+     */
+    prune(): number;
+}
+/**
+ * Gets the global cache instance
+ * @param ttl Default TTL for the cache (only used on first call)
+ * @returns Global cache instance
+ */
+export declare function getCache(ttl?: number): Cache;
+/**
+ * Resets the global cache instance (useful for testing)
+ */
+export declare function resetCache(): void;
+/**
+ * Generates a cache key for discover parameters
+ * @param params Discover parameters object
+ * @returns Cache key string
+ */
+export declare function generateDiscoverCacheKey(params: Record<string, any>): string;
+/**
+ * Generates a cache key for watch providers
+ * @param movieId Movie ID
+ * @param region Region code
+ * @returns Cache key string
+ */
+export declare function generateProvidersCacheKey(movieId: number | string, region: string): string;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,UAAU,GAAE,MAAa;IAKrC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAMjD;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAgBlC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,KAAK,IAAI,MAAM;CAahB;AAKD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAK5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,MAAM,GACb,MAAM,CAER"}