@reverse-craft/smart-fs 1.0.6 → 2.0.0

package/dist/tools/ToolDefinition.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * Tool definition interface for MCP tools.
+ * Each tool has a name, description, schema (Zod raw shape), and async handler.
+ */
+export interface ToolDefinition<TSchema extends z.ZodRawShape = z.ZodRawShape> {
+    /** Unique tool name (e.g., 'read_code_smart') */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+    /** Zod schema object defining input parameters */
+    schema: TSchema;
+    /** Async handler function that processes the tool request */
+    handler: (params: z.infer<z.ZodObject<TSchema>>) => Promise<string>;
+}
+/**
+ * Helper function to create a type-safe tool definition.
+ * Validates the tool definition structure at compile time.
+ *
+ * @param definition - The tool definition object
+ * @returns The same definition with proper typing
+ */
+export declare function defineTool<TSchema extends z.ZodRawShape>(definition: ToolDefinition<TSchema>): ToolDefinition<TSchema>;
+//# sourceMappingURL=ToolDefinition.d.ts.map

package/dist/tools/ToolDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolDefinition.d.ts","sourceRoot":"","sources":["../../src/tools/ToolDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IAC3E,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,EACtD,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,GAClC,cAAc,CAAC,OAAO,CAAC,CAEzB"}

package/dist/tools/aiFindJsvmpDispatcher.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Formatted code result interface
+ */
+export interface FormattedCode {
+    content: string;
+    totalLines: number;
+    startLine: number;
+    endLine: number;
+}
+/**
+ * Detection type for JSVMP patterns
+ */
+export type DetectionType = "If-Else Dispatcher" | "Switch Dispatcher" | "Instruction Array" | "Stack Operation";
+/**
+ * Confidence level for detection results
+ */
+export type ConfidenceLevel = "ultra_high" | "high" | "medium" | "low";
+/**
+ * A detected region in the code
+ */
+export interface DetectionRegion {
+    start: number;
+    end: number;
+    type: DetectionType;
+    confidence: ConfidenceLevel;
+    description: string;
+}
+/**
+ * Complete detection result from LLM analysis
+ */
+export interface DetectionResult {
+    summary: string;
+    regions: DetectionRegion[];
+}
+/**
+ * 格式化代码为 LLM 分析格式
+ * 格式: "LineNo SourceLoc Code"
+ *
+ * 处理流程：
+ * 1. 调用 ensureBeautified 美化代码
+ * 2. 调用 truncateCodeHighPerf 截断长字符串
+ * 3. 使用 SourceMapConsumer 获取原始坐标
+ * 4. 格式化为 "LineNo SourceLoc Code" 格式
+ *
+ * @param filePath - Path to the JavaScript file
+ * @param startLine - Start line number (1-based)
+ * @param endLine - End line number (1-based)
+ * @param charLimit - Character limit for string truncation (default 300)
+ * @returns FormattedCode object with formatted content and metadata
+ */
+export declare function formatCodeForAnalysis(filePath: string, startLine: number, endLine: number, charLimit?: number): Promise<FormattedCode>;
+/**
+ * Parse and validate LLM detection result from JSON string
+ *
+ * Validates:
+ * - JSON is parseable
+ * - Required fields exist: summary, regions
+ * - Each region has required fields: start, end, type, confidence, description
+ * - Enum values are valid
+ *
+ * @param jsonString - JSON string from LLM response
+ * @returns Parsed and validated DetectionResult
+ * @throws Error if JSON is invalid or structure doesn't match expected format
+ */
+export declare function parseDetectionResult(jsonString: string): DetectionResult;
+/**
+ * Input schema for ai_find_jsvmp_dispatcher tool
+ */
+export declare const AiFindJsvmpDispatcherInputSchema: any;
+/**
+ * ai_find_jsvmp_dispatcher tool definition
+ *
+ * AI-powered tool that analyzes JavaScript code to find JSVMP (JavaScript Virtual Machine Protection)
+ * dispatcher patterns using LLM-based analysis. Requires OPENAI_API_KEY environment variable.
+ *
+ * Requirements: 5.1, 5.2, 1.2, 5.3
+ */
+export declare const aiFindJsvmpDispatcher: import("./ToolDefinition.js").ToolDefinition<any>;
+//# sourceMappingURL=aiFindJsvmpDispatcher.d.ts.map

package/dist/tools/aiFindJsvmpDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiFindJsvmpDispatcher.d.ts","sourceRoot":"","sources":["../../src/tools/aiFindJsvmpDispatcher.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAsBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,aAAa,CAAC,CA6CxB;AAoCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAkFxE;AAsCD;;GAEG;AACH,eAAO,MAAM,gCAAgC,KAK3C,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,mDA6ChC,CAAC"}

package/dist/tools/applyCustomTransform.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Schema for apply_custom_transform tool input validation
+ */
+export declare const ApplyCustomTransformInputSchema: any;
+/**
+ * apply_custom_transform tool definition
+ * Apply a custom Babel transformation to deobfuscate JavaScript code.
+ */
+export declare const applyCustomTransform: import("./ToolDefinition.js").ToolDefinition<{
+    target_file: any;
+    script_path: any;
+    output_suffix: any;
+}>;
+//# sourceMappingURL=applyCustomTransform.d.ts.map

package/dist/tools/applyCustomTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyCustomTransform.d.ts","sourceRoot":"","sources":["../../src/tools/applyCustomTransform.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,+BAA+B,KAI1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;EA+B/B,CAAC"}

package/dist/tools/findUsageSmart.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Schema for find_usage_smart tool input validation
+ */
+export declare const FindUsageSmartInputSchema: any;
+/**
+ * find_usage_smart tool definition
+ * Find all definitions and references of a variable/function using AST scope analysis.
+ */
+export declare const findUsageSmart: import("./ToolDefinition.js").ToolDefinition<{
+    file_path: any;
+    identifier: any;
+    line: any;
+    char_limit: any;
+    max_line_chars: any;
+}>;
+//# sourceMappingURL=findUsageSmart.d.ts.map

package/dist/tools/findUsageSmart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findUsageSmart.d.ts","sourceRoot":"","sources":["../../src/tools/findUsageSmart.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,yBAAyB,KAQpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;EA0DzB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tool aggregation module
+ * Collects all tool definitions and exports them as a unified array.
+ */
+import { ApplyCustomTransformInputSchema } from './applyCustomTransform.js';
+import { SearchCodeSmartInputSchema } from './searchCodeSmart.js';
+import { FindUsageSmartInputSchema } from './findUsageSmart.js';
+/**
+ * Array of all available MCP tool definitions.
+ * To add a new tool:
+ * 1. Create a new tool module in src/tools/
+ * 2. Import it here
+ * 3. Add it to this array
+ */
+export declare const tools: readonly [import("./ToolDefinition.js").ToolDefinition<{
+    file_path: any;
+    start_line: any;
+    end_line: any;
+    char_limit: any;
+    max_line_chars: any;
+    save_local: any;
+}>, import("./ToolDefinition.js").ToolDefinition<{
+    target_file: any;
+    script_path: any;
+    output_suffix: any;
+}>, import("./ToolDefinition.js").ToolDefinition<{
+    file_path: any;
+    query: any;
+    context_lines: any;
+    case_sensitive: any;
+    char_limit: any;
+    max_line_chars: any;
+    is_regex: any;
+}>, import("./ToolDefinition.js").ToolDefinition<{
+    file_path: any;
+    identifier: any;
+    line: any;
+    char_limit: any;
+    max_line_chars: any;
+}>, import("./ToolDefinition.js").ToolDefinition<any>];
+export { ToolDefinition, defineTool } from './ToolDefinition.js';
+export { ApplyCustomTransformInputSchema, SearchCodeSmartInputSchema, FindUsageSmartInputSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAwB,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAmB,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAkB,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGhF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;sDAMR,CAAC;AAGX,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/tools/readCodeSmart.d.ts

@@ -0,0 +1,13 @@
+/**
+ * read_code_smart tool definition
+ * Read and beautify minified/obfuscated JavaScript code with source map coordinates.
+ */
+export declare const readCodeSmart: import("./ToolDefinition.js").ToolDefinition<{
+    file_path: any;
+    start_line: any;
+    end_line: any;
+    char_limit: any;
+    max_line_chars: any;
+    save_local: any;
+}>;
+//# sourceMappingURL=readCodeSmart.d.ts.map

package/dist/tools/readCodeSmart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readCodeSmart.d.ts","sourceRoot":"","sources":["../../src/tools/readCodeSmart.ts"],"names":[],"mappings":"AA0CA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;EAyFxB,CAAC"}

package/dist/tools/searchCodeSmart.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Schema for search_code_smart tool input validation
+ */
+export declare const SearchCodeSmartInputSchema: any;
+/**
+ * search_code_smart tool definition
+ * Search for text or regex patterns in beautified JavaScript code.
+ */
+export declare const searchCodeSmart: import("./ToolDefinition.js").ToolDefinition<{
+    file_path: any;
+    query: any;
+    context_lines: any;
+    case_sensitive: any;
+    char_limit: any;
+    max_line_chars: any;
+    is_regex: any;
+}>;
+//# sourceMappingURL=searchCodeSmart.d.ts.map

package/dist/tools/searchCodeSmart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCodeSmart.d.ts","sourceRoot":"","sources":["../../src/tools/searchCodeSmart.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,0BAA0B,KAQrC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;EA0C1B,CAAC"}

package/dist/transformer.d.ts

@@ -0,0 +1,119 @@
+import { type SourceMap } from './beautifier.js';
+/**
+ * Transform options interface
+ */
+export interface TransformOptions {
+    /** Path to the user's Babel plugin script */
+    scriptPath: string;
+    /** Output file suffix (default "_deob") */
+    outputSuffix?: string;
+}
+/**
+ * Transform result interface
+ */
+export interface TransformResult {
+    /** Transformed code */
+    code: string;
+    /** Cascaded Source Map */
+    map: SourceMap;
+    /** Output file path */
+    outputPath: string;
+    /** Source Map file path */
+    mapPath: string;
+}
+/**
+ * Output paths interface
+ */
+export interface OutputPaths {
+    /** Output JS file path */
+    outputPath: string;
+    /** Source Map file path */
+    mapPath: string;
+}
+/**
+ * Clean basename by removing .beautified and _deob* suffixes
+ *
+ * Examples:
+ * - main.js -> main
+ * - main.beautified.js -> main
+ * - main_deob.js -> main
+ * - main.beautified_deob.js -> main
+ * - main_deob_v2.js -> main
+ *
+ * @param filename - Original filename (with or without path)
+ * @returns Cleaned basename without extension
+ */
+export declare function cleanBasename(filename: string): string;
+/**
+ * Calculate output paths for transformed file
+ *
+ * @param targetFile - Path to the target file
+ * @param outputSuffix - Suffix for output file (default "_deob")
+ * @returns Output paths for JS and map files
+ */
+export declare function getOutputPaths(targetFile: string, outputSuffix?: string): OutputPaths;
+/**
+ * Babel plugin function type
+ * A Babel plugin is a function that receives babel API and returns a visitor object
+ */
+export type BabelPluginFunction = (babel: {
+    types: typeof import('@babel/types');
+}) => {
+    visitor: Record<string, unknown>;
+};
+/**
+ * Load a Babel plugin script from the given path
+ *
+ * Features:
+ * - Resolves to absolute path
+ * - Clears require cache for hot-reloading
+ * - Validates plugin format
+ *
+ * @param scriptPath - Path to the Babel plugin script
+ * @returns The loaded Babel plugin function
+ * @throws Error if script not found or invalid format
+ */
+export declare function loadBabelPlugin(scriptPath: string): Promise<BabelPluginFunction>;
+/**
+ * Babel transform result interface
+ */
+interface BabelTransformResult {
+    /** Transformed code */
+    code: string;
+    /** Generated source map (cascaded) */
+    map: SourceMap;
+}
+/**
+ * Run Babel transform with source map cascade
+ *
+ * Configuration:
+ * - inputSourceMap: Enables cascade from beautified -> original
+ * - sourceMaps: true to generate output source map
+ * - retainLines: false for best readability
+ * - compact: false for readable output
+ * - minified: false for readable output
+ *
+ * @param code - Input code (beautified)
+ * @param inputSourceMap - Source map from beautifier (beautified -> original)
+ * @param plugin - Babel plugin function
+ * @param filename - Original filename for source map
+ * @returns Transformed code and cascaded source map
+ */
+export declare function runBabelTransform(code: string, inputSourceMap: SourceMap, plugin: BabelPluginFunction, filename: string): BabelTransformResult;
+/**
+ * Apply custom Babel transform to a JavaScript file
+ *
+ * Process:
+ * 1. Load and validate the Babel plugin script
+ * 2. Get beautified code and source map from target file
+ * 3. Run Babel transform with source map cascade
+ * 4. Write output file and source map
+ * 5. Append sourceMappingURL comment
+ *
+ * @param targetFile - Path to the JavaScript file to transform
+ * @param options - Transform options (scriptPath, outputSuffix)
+ * @returns Transform result with output paths
+ */
+export declare function applyCustomTransform(targetFile: string, options: TransformOptions): Promise<TransformResult>;
+export {};
+//# sourceMappingURL=transformer.d.ts.map

package/dist/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../src/transformer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,GAAE,MAAgB,GAAG,WAAW,CAS9F;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,cAAc,cAAc,CAAC,CAAA;CAAE,KAAK;IACrF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmCtF;AAGD;;GAEG;AACH,UAAU,oBAAoB;IAC5B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,GAAG,EAAE,SAAS,CAAC;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,SAAS,EACzB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAqCtB;AAGD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA6D1B"}

package/dist/truncator.d.ts

@@ -0,0 +1,69 @@
+import { type SupportedLanguage } from './languageDetector.js';
+/**
+ * Options for truncation operations
+ */
+export interface TruncateOptions {
+    /** Override auto-detected language */
+    language?: SupportedLanguage;
+    /** Character limit for string truncation (default: 200) */
+    charLimit?: number;
+    /** Maximum characters per line (default: 500) */
+    maxLineChars?: number;
+    /** Preview length for truncated content (default: 50) */
+    previewLength?: number;
+}
+/**
+ * Result of truncation operation
+ */
+export interface TruncateResult {
+    /** Truncated code */
+    code: string;
+    /** Whether fallback mode was used */
+    usedFallback: boolean;
+}
+/**
+ * Legacy function name for backward compatibility
+ * @deprecated Use truncateCode instead
+ */
+export declare function truncateCodeHighPerf(sourceCode: string, limit?: number, previewLength?: number): string;
+/**
+ * Fallback truncation for unsupported languages
+ * Only truncates lines exceeding the character limit, no AST parsing
+ * Preserves the original line count (Requirement 3.3)
+ *
+ * @param code - Source code to process
+ * @param maxLineChars - Maximum characters per line (default: 500)
+ * @param previewLength - Length of start/end preview portions (default: 50)
+ * @returns Truncated code with preserved line count
+ */
+export declare function truncateFallback(code: string, maxLineChars?: number, previewLength?: number): string;
+/**
+ * Truncate code based on language type
+ * - For JS/TS: Use AST-based truncation for string literals + line truncation
+ * - For other languages: Use line-based truncation only (fallback mode)
+ *
+ * @param code - Source code to process
+ * @param options - Truncation options including language, limits, etc.
+ * @returns TruncateResult with truncated code and fallback indicator
+ */
+export declare function truncateCode(code: string, options?: TruncateOptions): TruncateResult;
+/**
+ * Truncate code from a file path, auto-detecting language
+ *
+ * @param filePath - Path to the file (used for language detection)
+ * @param code - Source code to process
+ * @param options - Truncation options (language override, limits, etc.)
+ * @returns TruncateResult with truncated code and fallback indicator
+ */
+export declare function truncateCodeFromFile(filePath: string, code: string, options?: Omit<TruncateOptions, 'language'> & {
+    language?: SupportedLanguage;
+}): TruncateResult;
+/**
+ * Truncate lines that exceed the maximum character limit
+ * @param code - Source code to process
+ * @param maxLineChars - Maximum characters per line (default 500)
+ * @param previewRatio - Ratio of line to show at start/end (default 0.2)
+ * @returns Code with truncated long lines
+ */
+export declare function truncateLongLines(code: string, maxLineChars?: number, previewRatio?: number): string;
+//# sourceMappingURL=truncator.d.ts.map

package/dist/truncator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncator.d.ts","sourceRoot":"","sources":["../src/truncator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmC,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAmChG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AA8ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,EAAE,aAAa,GAAE,MAAW,GAAG,MAAM,CAEhH;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,MAAY,EAC1B,aAAa,GAAE,MAAW,GACzB,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAyChB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAC7E,cAAc,CAQhB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,MAAY,EAC1B,YAAY,GAAE,MAAY,GACzB,MAAM,CAsBR"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Public types for smart-fs library
+ * @module types
+ */
+import type { SupportedLanguage } from './languageDetector.js';
+import type { SourceMap } from './beautifier.js';
+/**
+ * Options for processing files with smart-fs
+ */
+export interface ProcessingOptions {
+    /** Override auto-detected language */
+    language?: SupportedLanguage;
+    /** Character limit for string truncation (default: 300) */
+    charLimit?: number;
+    /** Maximum characters per line (default: 500) */
+    maxLineChars?: number;
+    /** Preview length for truncated content (default: 50) */
+    previewLength?: number;
+    /** Save beautified file locally */
+    saveLocal?: boolean;
+}
+/**
+ * Result of processing a file
+ */
+export interface ProcessingResult {
+    /** Processed code */
+    code: string;
+    /** Source map (null for unsupported languages) */
+    sourceMap: SourceMap | null;
+    /** Detected or specified language */
+    language: SupportedLanguage;
+    /** Whether fallback mode was used */
+    usedFallback: boolean;
+    /** Local file path if saved */
+    localPath?: string;
+    /** Error message if any */
+    error?: string;
+}
+/**
+ * Options for smartRead function
+ */
+export interface SmartReadOptions extends ProcessingOptions {
+    /** Starting line number (1-based, inclusive) */
+    startLine?: number;
+    /** Ending line number (1-based, inclusive) */
+    endLine?: number;
+}
+/**
+ * Error codes for smart-fs operations
+ */
+export type ErrorCode = 'FILE_NOT_FOUND' | 'PARSE_ERROR' | 'PERMISSION_DENIED' | 'INVALID_OPTIONS';
+/**
+ * Error result structure
+ */
+export interface ErrorResult {
+    success: false;
+    error: string;
+    code: ErrorCode;
+    details?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,aAAa,GACb,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/package.json

@@ -1,30 +1,32 @@
 {
   "name": "@reverse-craft/smart-fs",
-  "version": "1.0.6",
-  "description": "MCP server for AI-assisted JavaScript reverse engineering - beautifies minified code and truncates long strings to prevent context overflow",
+  "version": "2.0.0",
+  "description": "Core file processing library for code beautification, truncation, and analysis - supports multiple languages with AST-based and fallback processing",
   "type": "module",
-  "main": "dist/server.js",
-  "bin": {
-    "smart-fs": "./dist/server.js"
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
   },
   "scripts": {
     "build": "node build.js",
     "build:types": "tsc --emitDeclarationOnly",
-    "start": "node dist/server.js",
     "test": "vitest --run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
-    "mcp",
-    "model-context-protocol",
     "javascript",
-    "reverse-engineering",
-    "deobfuscation",
+    "typescript",
+    "code-processing",
     "beautifier",
+    "truncation",
     "source-map",
-    "ai",
-    "llm",
-    "context-window"
+    "ast",
+    "multi-language",
+    "file-processing"
   ],
   "license": "MIT",
   "repository": {
@@ -49,14 +51,12 @@
     "@babel/parser": "^7.28.5",
     "@babel/traverse": "^7.28.5",
     "@babel/types": "^7.28.5",
-    "@modelcontextprotocol/sdk": "^1.25.1",
     "esbuild": "^0.27.2",
     "estree-walker": "^3.0.3",
     "fs-extra": "^11.3.3",
     "magic-string": "^0.30.21",
     "meriyah": "^7.0.0",
-    "source-map-js": "^1.2.1",
-    "zod": "^4.2.1"
+    "source-map-js": "^1.2.1"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",