codereview-aia 0.1.0 → 0.1.2

package/dist/types/structuredReview.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Type definitions for the structured review output that cr-aia emits.
+ */
+/**
+ * Priority levels for code review issues
+ */
+export type IssuePriority = 'high' | 'medium' | 'low';
+/**
+ * Types of code review issues
+ */
+export type IssueType = 'bug' | 'security' | 'performance' | 'maintainability' | 'readability' | 'architecture' | 'best-practice' | 'documentation' | 'testing' | 'other';
+/**
+ * A single code review issue
+ */
+export interface ReviewIssue {
+    /**
+     * Title of the issue
+     */
+    title: string;
+    /**
+     * Priority level of the issue
+     */
+    priority: IssuePriority;
+    /**
+     * Type of issue
+     */
+    type: IssueType;
+    /**
+     * File path where the issue was found
+     */
+    filePath: string;
+    /**
+     * Line number(s) where the issue was found
+     * Can be a single line number or a range (e.g., "10-15")
+     */
+    lineNumbers?: string;
+    /**
+     * Description of the issue
+     */
+    description: string;
+    /**
+     * Code snippet showing the issue
+     */
+    codeSnippet?: string;
+    /**
+     * Suggested fix for the issue
+     */
+    suggestedFix?: string;
+    /**
+     * Impact of the issue
+     */
+    impact?: string;
+}
+/**
+ * Grade level types for overall code quality
+ */
+export type GradeLevel = 'A+' | 'A' | 'A-' | 'B+' | 'B' | 'B-' | 'C+' | 'C' | 'C-' | 'D+' | 'D' | 'D-' | 'F';
+/**
+ * Code quality assessment categories
+ */
+export interface GradeCategories {
+    /**
+     * Code functionality grade
+     */
+    functionality?: GradeLevel;
+    /**
+     * Code quality grade
+     */
+    codeQuality?: GradeLevel;
+    /**
+     * Documentation grade
+     */
+    documentation?: GradeLevel;
+    /**
+     * Testing grade
+     */
+    testing?: GradeLevel;
+    /**
+     * Maintainability grade
+     */
+    maintainability?: GradeLevel;
+    /**
+     * Security grade
+     */
+    security?: GradeLevel;
+    /**
+     * Performance grade
+     */
+    performance?: GradeLevel;
+}
+/**
+ * Structured code review output
+ */
+export interface StructuredReview {
+    /**
+     * Overall grade for the codebase
+     */
+    grade?: GradeLevel;
+    /**
+     * Detailed grade breakdown by category
+     */
+    gradeCategories?: GradeCategories;
+    /**
+     * Summary of the code review
+     */
+    summary: string;
+    /**
+     * List of issues found in the code review
+     */
+    issues: ReviewIssue[];
+    /**
+     * General recommendations that don't fit into specific issues
+     */
+    recommendations?: string[];
+    /**
+     * Positive aspects of the code
+     */
+    positiveAspects?: string[];
+}

package/dist/types/structuredReview.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for the structured review output that cr-aia emits.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=structuredReview.js.map

package/dist/types/structuredReview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredReview.js","sourceRoot":"","sources":["../../src/types/structuredReview.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/tokenAnalysis.d.ts

@@ -0,0 +1,44 @@
+/** Token analysis primitives shared across the CLI. */
+import type { FileInfo } from './review';
+export interface FileTokenAnalysis {
+    path: string;
+    relativePath: string | undefined;
+    tokenCount: number;
+    sizeInBytes: number;
+    tokensPerByte: number;
+}
+export interface TokenAnalysisResult {
+    files: FileTokenAnalysis[];
+    totalTokens: number;
+    totalSizeInBytes: number;
+    averageTokensPerByte: number;
+    fileCount: number;
+    promptOverheadTokens: number;
+    estimatedTotalTokens: number;
+    contextWindowSize: number;
+    exceedsContextWindow: boolean;
+    estimatedPassesNeeded: number;
+    chunkingRecommendation: ChunkingRecommendation;
+}
+export interface ChunkingRecommendation {
+    chunkingRecommended: boolean;
+    recommendedChunks: FileChunk[];
+    reason: string;
+}
+export interface FileChunk {
+    files: string[];
+    estimatedTokenCount: number;
+    priority: number;
+}
+export interface TokenAnalysisOptions {
+    reviewType: string;
+    modelName: string;
+    optimizeForSpeed?: boolean;
+    additionalPromptOverhead?: number;
+    contextMaintenanceFactor?: number;
+}
+export declare class TokenAnalyzer {
+    static analyzeFile(file: FileInfo, options: TokenAnalysisOptions): FileTokenAnalysis;
+    static analyzeFiles(files: FileInfo[], options: TokenAnalysisOptions): TokenAnalysisResult;
+}
+export declare function formatTokenAnalysis(analysis: TokenAnalysisResult, modelName: string, includeFiles?: boolean): string;

package/dist/types/tokenAnalysis.js

@@ -0,0 +1,4 @@
+"use strict";
+/** Token analysis primitives shared across the CLI. */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tokenAnalysis.js.map

package/dist/types/tokenAnalysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenAnalysis.js","sourceRoot":"","sources":["../../src/types/tokenAnalysis.ts"],"names":[],"mappings":";AAAA,uDAAuD"}

package/dist/utils/FileReader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview File reading utilities.
+ *
+ * This module provides utilities for reading files and directories,
+ * with error handling and logging.
+ */
+import type { FileInfo } from '../types/review';
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Promise resolving to the file content
+ * @throws Error if the file cannot be read
+ */
+export declare function readFile(filePath: string): Promise<string>;
+/**
+ * Read a file and return its content with file info
+ * @param filePath Path to the file
+ * @returns Promise resolving to a FileInfo object
+ */
+export declare function readFileWithInfo(filePath: string): Promise<FileInfo>;
+/**
+ * Read multiple files and return their contents with file info
+ * @param filePaths Array of file paths
+ * @returns Promise resolving to an array of FileInfo objects
+ */
+export declare function readFilesWithInfo(filePaths: string[]): Promise<FileInfo[]>;
+/**
+ * Read all files in a directory recursively
+ * @param dirPath Path to the directory
+ * @param filter Optional filter function to exclude certain files
+ * @returns Promise resolving to an array of file paths
+ */
+export declare function readFilesInDirectory(dirPath: string, filter?: (filePath: string) => boolean): Promise<string[]>;

package/dist/utils/FileReader.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * @fileoverview File reading utilities.
+ *
+ * This module provides utilities for reading files and directories,
+ * with error handling and logging.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFile = readFile;
+exports.readFileWithInfo = readFileWithInfo;
+exports.readFilesWithInfo = readFilesWithInfo;
+exports.readFilesInDirectory = readFilesInDirectory;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = __importDefault(require("./logger"));
+/**
+ * Read a file and return its content
+ * @param filePath Path to the file
+ * @returns Promise resolving to the file content
+ * @throws Error if the file cannot be read
+ */
+async function readFile(filePath) {
+    try {
+        return await promises_1.default.readFile(filePath, 'utf-8');
+    }
+    catch (error) {
+        logger_1.default.error(`Error reading file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Read a file and return its content with file info
+ * @param filePath Path to the file
+ * @returns Promise resolving to a FileInfo object
+ */
+async function readFileWithInfo(filePath) {
+    try {
+        const content = await promises_1.default.readFile(filePath, 'utf-8');
+        const extension = node_path_1.default.extname(filePath).slice(1);
+        return {
+            path: filePath,
+            content,
+            extension,
+        };
+    }
+    catch (error) {
+        logger_1.default.error(`Error reading file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Read multiple files and return their contents with file info
+ * @param filePaths Array of file paths
+ * @returns Promise resolving to an array of FileInfo objects
+ */
+async function readFilesWithInfo(filePaths) {
+    const fileInfoPromises = filePaths.map((filePath) => readFileWithInfo(filePath));
+    return Promise.all(fileInfoPromises);
+}
+/**
+ * Read all files in a directory recursively
+ * @param dirPath Path to the directory
+ * @param filter Optional filter function to exclude certain files
+ * @returns Promise resolving to an array of file paths
+ */
+async function readFilesInDirectory(dirPath, filter) {
+    const result = [];
+    async function processDirectory(currentPath) {
+        const entries = await promises_1.default.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = node_path_1.default.join(currentPath, entry.name);
+            if (entry.isDirectory()) {
+                await processDirectory(entryPath);
+            }
+            else if (entry.isFile()) {
+                if (!filter || filter(entryPath)) {
+                    result.push(entryPath);
+                }
+            }
+        }
+    }
+    await processDirectory(dirPath);
+    return result;
+}
+//# sourceMappingURL=FileReader.js.map

package/dist/utils/FileReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileReader.js","sourceRoot":"","sources":["../../src/utils/FileReader.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAaH,4BASC;AAOD,4CAgBC;AAOD,8CAGC;AAQD,oDAwBC;AArFD,gEAAkC;AAClC,0DAA6B;AAE7B,sDAA8B;AAE9B;;;;;GAKG;AACI,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,sBAAsB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAElD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO;YACP,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,sBAAsB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,iBAAiB,CAAC,SAAmB;IACzD,MAAM,gBAAgB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,MAAsC;IAEtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,UAAU,gBAAgB,CAAC,WAAmB;QACjD,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAErD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;oBACjC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/FileWriter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview File writing utilities.
+ *
+ * This module provides utilities for writing files and creating directories,
+ * with error handling and logging.
+ */
+/**
+ * Create a directory if it doesn't exist
+ * @param dirPath Path to the directory
+ * @returns Promise resolving when the directory is created or already exists
+ */
+export declare function ensureDirectoryExists(dirPath: string): Promise<void>;
+/**
+ * Write content to a file, creating the directory if needed
+ * @param filePath Path to the file
+ * @param content Content to write
+ * @returns Promise resolving when the file is written
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+/**
+ * Append content to a file, creating the file if it doesn't exist
+ * @param filePath Path to the file
+ * @param content Content to append
+ * @returns Promise resolving when the content is appended
+ */
+export declare function appendFile(filePath: string, content: string): Promise<void>;

package/dist/utils/FileWriter.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @fileoverview File writing utilities.
+ *
+ * This module provides utilities for writing files and creating directories,
+ * with error handling and logging.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectoryExists = ensureDirectoryExists;
+exports.writeFile = writeFile;
+exports.appendFile = appendFile;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = __importDefault(require("./logger"));
+const pathValidator_1 = require("./pathValidator");
+/**
+ * Create a directory if it doesn't exist
+ * @param dirPath Path to the directory
+ * @returns Promise resolving when the directory is created or already exists
+ */
+async function ensureDirectoryExists(dirPath) {
+    try {
+        if (!(0, pathValidator_1.pathExists)(dirPath)) {
+            await promises_1.default.mkdir(dirPath, { recursive: true });
+            logger_1.default.debug(`Created directory: ${dirPath}`);
+        }
+    }
+    catch (error) {
+        logger_1.default.error(`Error creating directory ${dirPath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Write content to a file, creating the directory if needed
+ * @param filePath Path to the file
+ * @param content Content to write
+ * @returns Promise resolving when the file is written
+ */
+async function writeFile(filePath, content) {
+    try {
+        // Ensure the directory exists
+        const dirPath = node_path_1.default.dirname(filePath);
+        await ensureDirectoryExists(dirPath);
+        // Write the file
+        await promises_1.default.writeFile(filePath, content);
+        logger_1.default.debug(`Wrote file: ${filePath}`);
+    }
+    catch (error) {
+        logger_1.default.error(`Error writing file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Append content to a file, creating the file if it doesn't exist
+ * @param filePath Path to the file
+ * @param content Content to append
+ * @returns Promise resolving when the content is appended
+ */
+async function appendFile(filePath, content) {
+    try {
+        // Ensure the directory exists
+        const dirPath = node_path_1.default.dirname(filePath);
+        await ensureDirectoryExists(dirPath);
+        // Append to the file
+        await promises_1.default.appendFile(filePath, content);
+        logger_1.default.debug(`Appended to file: ${filePath}`);
+    }
+    catch (error) {
+        logger_1.default.error(`Error appending to file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=FileWriter.js.map

package/dist/utils/FileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileWriter.js","sourceRoot":"","sources":["../../src/utils/FileWriter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAYH,sDAYC;AAQD,8BAeC;AAQD,gCAeC;AApED,gEAAkC;AAClC,0DAA6B;AAC7B,sDAA8B;AAC9B,mDAA6C;AAE7C;;;;GAIG;AACI,KAAK,UAAU,qBAAqB,CAAC,OAAe;IACzD,IAAI,CAAC;QACH,IAAI,CAAC,IAAA,0BAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,kBAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,gBAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,4BAA4B,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC/D,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAErC,iBAAiB;QACjB,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,gBAAM,CAAC,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,sBAAsB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAChE,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAErC,qBAAqB;QACrB,MAAM,kBAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvC,gBAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CACV,2BAA2B,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/PathGenerator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Path generation utilities.
+ *
+ * This module provides utilities for generating file and directory paths,
+ * including versioned output paths for review results.
+ */
+/**
+ * Generate a versioned output path for a file
+ * @param baseDir Base directory for the output
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @param modelName Name of the model used for the review
+ * @param targetName Name of the target file or directory
+ * @returns Promise resolving to the generated path
+ */
+export declare function generateVersionedOutputPath(baseDir: string, prefix: string, extension: string, modelName: string, targetName: string): Promise<string>;
+/**
+ * Generate an output path for a file with a unique name
+ * @param baseDir Base directory for the output
+ * @param filename Desired filename
+ * @returns Promise resolving to the generated path
+ */
+export declare function generateUniqueOutputPath(baseDir: string, filename: string): Promise<string>;
+/**
+ * Generate a temporary file path
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @returns Generated temporary file path
+ */
+export declare function generateTempFilePath(prefix: string, extension: string): string;

package/dist/utils/PathGenerator.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @fileoverview Path generation utilities.
+ *
+ * This module provides utilities for generating file and directory paths,
+ * including versioned output paths for review results.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateVersionedOutputPath = generateVersionedOutputPath;
+exports.generateUniqueOutputPath = generateUniqueOutputPath;
+exports.generateTempFilePath = generateTempFilePath;
+const node_path_1 = __importDefault(require("node:path"));
+const FileWriter_1 = require("./FileWriter");
+const pathValidator_1 = require("./pathValidator");
+/**
+ * Generate a versioned output path for a file
+ * @param baseDir Base directory for the output
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @param modelName Name of the model used for the review
+ * @param targetName Name of the target file or directory
+ * @returns Promise resolving to the generated path
+ */
+async function generateVersionedOutputPath(baseDir, prefix, extension, modelName, targetName) {
+    // Ensure the output directory exists
+    await (0, FileWriter_1.ensureDirectoryExists)(baseDir);
+    // Generate a timestamp for the filename
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    // Clean up the model name for use in a filename
+    const cleanModelName = modelName.replace(/[^a-zA-Z0-9-]/g, '-');
+    // Clean up the target name for use in a filename
+    let cleanTargetName = targetName.replace(/[^a-zA-Z0-9-]/g, '-');
+    // Handle special cases for target names
+    if (targetName === '.' || cleanTargetName === '-' || cleanTargetName === '') {
+        cleanTargetName = 'current-dir';
+    }
+    // Remove any sequential dashes
+    cleanTargetName = cleanTargetName.replace(/-+/g, '-').replace(/^-|-$/g, '');
+    // Generate the filename
+    const filename = `${prefix}-${cleanTargetName}-${cleanModelName}-${timestamp}${extension}`;
+    // Return the full path
+    return node_path_1.default.join(baseDir, filename);
+}
+/**
+ * Generate an output path for a file with a unique name
+ * @param baseDir Base directory for the output
+ * @param filename Desired filename
+ * @returns Promise resolving to the generated path
+ */
+async function generateUniqueOutputPath(baseDir, filename) {
+    // Ensure the output directory exists
+    await (0, FileWriter_1.ensureDirectoryExists)(baseDir);
+    // Generate the initial path
+    let outputPath = node_path_1.default.join(baseDir, filename);
+    // If the file already exists, add a number to the filename
+    if (await (0, pathValidator_1.pathExists)(outputPath)) {
+        const extension = node_path_1.default.extname(filename);
+        const nameWithoutExtension = node_path_1.default.basename(filename, extension);
+        let counter = 1;
+        // Try different numbers until we find an available filename
+        while (await (0, pathValidator_1.pathExists)(outputPath)) {
+            outputPath = node_path_1.default.join(baseDir, `${nameWithoutExtension}-${counter}${extension}`);
+            counter++;
+        }
+    }
+    return outputPath;
+}
+/**
+ * Generate a temporary file path
+ * @param prefix Prefix for the filename
+ * @param extension File extension (including the dot)
+ * @returns Generated temporary file path
+ */
+function generateTempFilePath(prefix, extension) {
+    const timestamp = Date.now();
+    const randomPart = Math.floor(Math.random() * 10000);
+    return node_path_1.default.join(process.env.TEMP || process.env.TMP || '/tmp', `${prefix}-${timestamp}-${randomPart}${extension}`);
+}
+//# sourceMappingURL=PathGenerator.js.map

package/dist/utils/PathGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathGenerator.js","sourceRoot":"","sources":["../../src/utils/PathGenerator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAeH,kEAgCC;AAQD,4DAqBC;AAQD,oDAOC;AAzFD,0DAA6B;AAC7B,6CAAqD;AACrD,mDAA6C;AAE7C;;;;;;;;GAQG;AACI,KAAK,UAAU,2BAA2B,CAC/C,OAAe,EACf,MAAc,EACd,SAAiB,EACjB,SAAiB,EACjB,UAAkB;IAElB,qCAAqC;IACrC,MAAM,IAAA,kCAAqB,EAAC,OAAO,CAAC,CAAC;IAErC,wCAAwC;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEjE,gDAAgD;IAChD,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAEhE,iDAAiD;IACjD,IAAI,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAEhE,wCAAwC;IACxC,IAAI,UAAU,KAAK,GAAG,IAAI,eAAe,KAAK,GAAG,IAAI,eAAe,KAAK,EAAE,EAAE,CAAC;QAC5E,eAAe,GAAG,aAAa,CAAC;IAClC,CAAC;IAED,+BAA+B;IAC/B,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE5E,wBAAwB;IACxB,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,eAAe,IAAI,cAAc,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;IAE3F,uBAAuB;IACvB,OAAO,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,wBAAwB,CAAC,OAAe,EAAE,QAAgB;IAC9E,qCAAqC;IACrC,MAAM,IAAA,kCAAqB,EAAC,OAAO,CAAC,CAAC;IAErC,4BAA4B;IAC5B,IAAI,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE9C,2DAA2D;IAC3D,IAAI,MAAM,IAAA,0BAAU,EAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,oBAAoB,GAAG,mBAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,4DAA4D;QAC5D,OAAO,MAAM,IAAA,0BAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YACpC,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,oBAAoB,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC;YAClF,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,MAAc,EAAE,SAAiB;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACrD,OAAO,mBAAI,CAAC,IAAI,CACd,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,EAC7C,GAAG,MAAM,IAAI,SAAS,IAAI,UAAU,GAAG,SAAS,EAAE,CACnD,CAAC;AACJ,CAAC"}

package/dist/utils/api/apiUtils.d.ts

@@ -0,0 +1,3 @@
+export declare function hasApiKey(provider: string): boolean;
+export declare function getApiKeyType(): 'OpenRouter' | null;
+export declare function getApiKeyTypeLowerCase(): 'openrouter' | 'none';

package/dist/utils/api/apiUtils.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasApiKey = hasApiKey;
+exports.getApiKeyType = getApiKeyType;
+exports.getApiKeyTypeLowerCase = getApiKeyTypeLowerCase;
+const logger_1 = __importDefault(require("../logger"));
+function hasApiKey(provider) {
+    return provider.toLowerCase() === 'openrouter';
+}
+function getApiKeyType() {
+    logger_1.default.debug('getApiKeyType: defaulting to OpenRouter proxy');
+    return 'OpenRouter';
+}
+function getApiKeyTypeLowerCase() {
+    return 'openrouter';
+}
+//# sourceMappingURL=apiUtils.js.map

package/dist/utils/api/apiUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiUtils.js","sourceRoot":"","sources":["../../../src/utils/api/apiUtils.ts"],"names":[],"mappings":";;;;;AAEA,8BAEC;AAED,sCAGC;AAED,wDAEC;AAbD,uDAA+B;AAE/B,SAAgB,SAAS,CAAC,QAAgB;IACxC,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC;AACjD,CAAC;AAED,SAAgB,aAAa;IAC3B,gBAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAgB,sBAAsB;IACpC,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/api/index.d.ts

@@ -0,0 +1 @@
+export * from './apiUtils';

package/dist/utils/api/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./apiUtils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B"}